// Plan2Code Web Console - the few messages this page sends the desktop app that frames it, and which links it must open another way there; defines only. // // Each one is a named request with no free text in it, so the app decides what // it does: a page can ask for "continue" to be typed, never for anything else. /** True inside a frame: the desktop app's window, the only place that frames this page. */ export function framed() { return Boolean(window.parent) && window.parent !== window; } /** * True for a link that leaves the console for the web: http or https on * another origin. Inside the app those open through /open-link, since the * app's window opens no new ones; the console's own files stay put. */ export function linkLeavesPage(href, origin) { let url; try { url = new URL(href, origin); } catch { return false; } return (url.protocol === "http:" || url.protocol === "https:") && url.origin !== origin; } /** * Call `handler(data)` for each `{ plan2code: kind, ... }` message the frame's * parent sends, and for nothing from anywhere else (another frame, the page * itself). The app's only answer today is `taskbar-state`. */ export function onAppMessage(kind, handler) { window.addEventListener("message", (event) => { if (!framed() || event.source !== window.parent) return; const data = event.data; if (data && typeof data === "object" && data.plan2code === kind) handler(data); }); } /** * Ask the app for what its bar's New Session button does, confirm and all. * `command`, when there is one, goes on the clipboard first so it can be * pasted into the new terminal; a refused copy loses nothing, the page still * shows it. */ export async function startNewSession(command = "") { if (command) { try { await navigator.clipboard.writeText(command); } catch { /* the command stays on the page to copy by hand */ } } tellApp("new-session"); } /** Post `message` to the frame's parent, as `{ plan2code: kind, ...extra }`; nothing outside a frame. */ export function tellApp(kind, extra = {}) { if (!framed()) return; try { window.parent.postMessage({ ...extra, plan2code: kind }, "*"); } catch { /* no parent to tell */ } }