@dimina-kit/devtools 0.3.2-dev.20260525152421 → 0.3.2-dev.20260610082053

package/dist/preload/windows/host-toolbar.cjs

@@ -0,0 +1,161 @@
+"use strict";
+
+// src/preload/runtime/host-toolbar-advertiser.ts
+var import_electron = require("electron");
+
+// ../view-anchor/src/measure-loop.ts
+function createMeasureLoop(cfg) {
+  const { produce, same, sink } = cfg;
+  let rafId = null;
+  let active = false;
+  let disposed = false;
+  let last = null;
+  const cancel = () => {
+    if (rafId !== null) {
+      cancelAnimationFrame(rafId);
+      rafId = null;
+    }
+  };
+  return {
+    schedule() {
+      if (disposed || !active || rafId !== null) return;
+      rafId = requestAnimationFrame(() => {
+        rafId = null;
+        if (disposed || !active) return;
+        const value = produce();
+        if (value === null) return;
+        if (last !== null && same(value, last)) return;
+        last = value;
+        sink(value);
+      });
+    },
+    emitNow(value) {
+      if (disposed) return;
+      last = value;
+      sink(value);
+    },
+    setActive(on) {
+      active = on;
+    },
+    cancel,
+    dispose() {
+      if (disposed) return;
+      disposed = true;
+      cancel();
+    }
+  };
+}
+
+// ../view-anchor/src/size-advertiser.ts
+function createSizeAdvertiser(target, opts) {
+  const axis = opts.axis;
+  let publish = opts.publish;
+  let observer = null;
+  let disposed = false;
+  let latest = null;
+  const produce = () => {
+    if (!latest) return null;
+    const raw = axis === "block" ? latest.blockSize : latest.inlineSize;
+    if (!Number.isFinite(raw)) return null;
+    return { axis, extent: Math.max(0, Math.round(raw)) };
+  };
+  const loop = createMeasureLoop({
+    produce,
+    same: (a, b) => a.extent === b.extent,
+    // axis is constant
+    sink: (size) => publish(size)
+  });
+  const onResize = (entries) => {
+    const entry = entries[entries.length - 1];
+    if (entry) {
+      latest = entry.borderBoxSize?.[0] ?? entry.contentBoxSize?.[0] ?? latest;
+    }
+    loop.schedule();
+  };
+  const doc = target.ownerDocument;
+  if (target === doc.body || target === doc.documentElement) {
+    console.warn(
+      `[view-anchor] size-advertiser: <${target === doc.body ? "body" : "html"}>'s ${axis} size is the host-given view size, not the content size \u2014 the advertiser will never shrink to content. Measure a shrink-to-fit wrapper. See bidirectional-design.md \xA74.`
+    );
+  }
+  loop.setActive(true);
+  observer = new ResizeObserver(onResize);
+  observer.observe(target);
+  return {
+    update(nextPublish) {
+      if (disposed) return;
+      publish = nextPublish;
+      const cur = produce();
+      if (cur) loop.emitNow(cur);
+    },
+    dispose() {
+      if (disposed) return;
+      disposed = true;
+      loop.cancel();
+      if (observer) {
+        observer.disconnect();
+        observer = null;
+      }
+      loop.dispose();
+    }
+  };
+}
+
+// src/shared/ipc-channels.ts
+var ViewChannel = {
+  /** Update the simulator DevTools view's bounds (or hide if w/h = 0). */
+  SimulatorDevtoolsBounds: "view:simulator:devtools-bounds",
+  /**
+   * Host-controllable toolbar WebContentsView (sits ABOVE the devtools built-in
+   * header). Forward anchor: the main renderer reports the toolbar placeholder's
+   * bounds (or w/h=0 to hide). invoke.
+   */
+  HostToolbarBounds: "view:host-toolbar:bounds",
+  /**
+   * Reverse size-advertiser: the host-toolbar WCV's OWN renderer advertises its
+   * intrinsic content height so main reserves exactly that much. Payload
+   * `{ axis: 'block', extent }`. fire-and-forget (send), NOT invoke.
+   */
+  HostToolbarAdvertiseHeight: "view:host-toolbar:advertise-height",
+  /**
+   * main → main-window renderer: push the reserved host-toolbar height so the
+   * renderer placeholder div resizes (closing the dynamic-height loop).
+   */
+  HostToolbarHeightChanged: "view:host-toolbar:height-changed"
+};
+
+// src/preload/runtime/host-toolbar-advertiser.ts
+function installHostToolbarAdvertiser() {
+  const root = document.querySelector("[data-host-toolbar-root]");
+  if (!root) {
+    console.warn(
+      "[host-toolbar-advertiser] no `[data-host-toolbar-root]` element found \u2014 not advertising a height. The toolbar content must wrap itself in a shrink-to-fit `[data-host-toolbar-root]` element so its block size is the content height, not the host-given view size."
+    );
+    return () => {
+    };
+  }
+  const advertiser = createSizeAdvertiser(root, {
+    axis: "block",
+    publish: (size) => {
+      import_electron.ipcRenderer.send(ViewChannel.HostToolbarAdvertiseHeight, size);
+    }
+  });
+  return () => advertiser.dispose();
+}
+function installHostToolbarAdvertiserWhenReady() {
+  if (document.readyState === "loading") {
+    document.addEventListener(
+      "DOMContentLoaded",
+      () => {
+        installHostToolbarAdvertiser();
+      },
+      { once: true }
+    );
+  } else {
+    installHostToolbarAdvertiser();
+  }
+}
+
+// src/preload/windows/host-toolbar.ts
+installHostToolbarAdvertiserWhenReady();
+//# sourceMappingURL=host-toolbar.cjs.map

package/dist/preload/windows/host-toolbar.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/preload/runtime/host-toolbar-advertiser.ts", "../../../../view-anchor/src/measure-loop.ts", "../../../../view-anchor/src/size-advertiser.ts", "../../../src/shared/ipc-channels.ts", "../../../src/preload/windows/host-toolbar.ts"],
+  "sourcesContent": ["/**\n * Reverse size-advertiser preload for the host-controllable toolbar\n * WebContentsView. Runs in that WCV's OWN renderer (the toolbar content's\n * preload), measures the toolbar's intrinsic block (height) extent and sends it\n * to the main process. Main pushes the value back to the main-window renderer as\n * `HostToolbarHeightChanged`, which resizes the toolbar placeholder, re-measures\n * the forward anchor, and re-overlays this WCV \u2014 closing the dynamic-height loop\n * (see `@dimina-kit/view-anchor` `createSizeAdvertiser`).\n */\n\nimport { ipcRenderer } from 'electron'\nimport { createSizeAdvertiser } from '@dimina-kit/view-anchor'\nimport { ViewChannel } from '../../shared/ipc-channels.js'\n\n/**\n * Attach the advertiser to the toolbar content's shrink-to-fit root\n * (`[data-host-toolbar-root]`). That element MUST be shrink-to-fit on the block\n * axis \u2014 its height must reflect the content, not the host-applied view height,\n * or the cross-process loop never converges (`createSizeAdvertiser`'s footgun).\n * If the element is missing we warn and no-op rather than measure `<body>`,\n * whose block size IS the view size and would advertise nonsense.\n *\n * Returns a disposer that tears the advertiser down.\n */\nexport function installHostToolbarAdvertiser(): () => void {\n  const root = document.querySelector<HTMLElement>('[data-host-toolbar-root]')\n  if (!root) {\n    console.warn(\n      '[host-toolbar-advertiser] no `[data-host-toolbar-root]` element found \u2014 ' +\n        'not advertising a height. The toolbar content must wrap itself in a ' +\n        'shrink-to-fit `[data-host-toolbar-root]` element so its block size is ' +\n        'the content height, not the host-given view size.',\n    )\n    return () => {}\n  }\n\n  const advertiser = createSizeAdvertiser(root, {\n    axis: 'block',\n    publish: (size) => {\n      ipcRenderer.send(ViewChannel.HostToolbarAdvertiseHeight, size)\n    },\n  })\n\n  return () => advertiser.dispose()\n}\n\n/**\n * Install once the DOM is ready (the root element must exist before we query).\n * Self-gating: if the document is already past `loading`, install synchronously;\n * otherwise wait for `DOMContentLoaded`.\n */\nexport function installHostToolbarAdvertiserWhenReady(): void {\n  if (document.readyState === 'loading') {\n    document.addEventListener(\n      'DOMContentLoaded',\n      () => {\n        installHostToolbarAdvertiser()\n      },\n      { once: true },\n    )\n  } else {\n    installHostToolbarAdvertiser()\n  }\n}\n", "/**\n * Internal \u2014 the RAF-coalesced measure/dedupe/dispose engine behind the REVERSE\n * primitive `createSizeAdvertiser`.\n *\n * The forward `createViewAnchor` deliberately does NOT use this: it publishes\n * SYNCHRONOUSLY (a native overlay's `setBounds` already lands a cross-process\n * frame late, and a RAF stacked a second frame of visible trailing). The\n * reverse direction is different \u2014 it is a cross-process FEEDBACK loop\n * (advertise \u2192 host resizes the view \u2192 content re-measures \u2192 re-advertise), so\n * the RAF's one-publish-per-frame coalescing is a useful damper. The two\n * directions thus have different optimal emit timing; this engine serves only\n * the reverse.\n *\n * NOT exported from the package: it is pure mechanism with no knowledge of\n * direction, the DOM, `ResizeObserver`, or the structure of the value `T` it\n * carries. The wrapping primitive injects `produce` / `same` / `sink` and\n * drives the lifecycle.\n *\n *   - `schedule()`  \u2014 coalesce a burst of triggers into ONE RAF; the frame\n *     body re-`produce()`s, dedupes against the last emit (`same`), and `sink`s.\n *     Bails if inactive or disposed (stale-RAF safe).\n *   - `emitNow(v)`  \u2014 explicit synchronous emit (create / update path). Always\n *     fires, bypassing the dedupe check, and refreshes the dedupe baseline.\n *   - `setActive`   \u2014 gate the observer stream; a queued frame bails on `!active`.\n *   - `cancel`      \u2014 drop any in-flight RAF.\n *   - `dispose`     \u2014 cancel + go inert; after dispose nothing emits again.\n */\nexport interface MeasureLoop<T> {\n  schedule(): void\n  emitNow(value: T): void\n  setActive(on: boolean): void\n  cancel(): void\n  dispose(): void\n}\n\nexport function createMeasureLoop<T>(cfg: {\n  /** Produce the value to emit in the RAF body. Return `null` to decline the\n   *  frame entirely (no dedupe, no sink, baseline untouched) \u2014 e.g. a\n   *  non-finite or unavailable measurement. */\n  produce: () => T | null\n  same: (a: T, b: T) => boolean\n  sink: (value: T) => void\n}): MeasureLoop<T> {\n  const { produce, same, sink } = cfg\n  let rafId: number | null = null\n  let active = false\n  let disposed = false\n  let last: T | null = null\n\n  const cancel = (): void => {\n    if (rafId !== null) {\n      cancelAnimationFrame(rafId)\n      rafId = null\n    }\n  }\n\n  return {\n    schedule(): void {\n      if (disposed || !active || rafId !== null) return\n      rafId = requestAnimationFrame(() => {\n        rafId = null\n        if (disposed || !active) return\n        const value = produce()\n        if (value === null) return // producer declined this frame\n        // last-value dedupe: a frame whose produced value equals the last one\n        // we emitted costs nothing (no IPC / setBounds).\n        if (last !== null && same(value, last)) return\n        last = value\n        sink(value)\n      })\n    },\n    emitNow(value: T): void {\n      if (disposed) return\n      last = value\n      sink(value)\n    },\n    setActive(on: boolean): void {\n      active = on\n    },\n    cancel,\n    dispose(): void {\n      if (disposed) return\n      disposed = true\n      cancel()\n    },\n  }\n}\n", "import type {\n  AdvertisedSize,\n  SizeAdvertiserOptions,\n  SizeAdvertiserHandle,\n} from './types.js'\nimport { createMeasureLoop } from './measure-loop.js'\n\n/**\n * Reverse of `createViewAnchor`: runs in a downstream WebContentsView's own\n * renderer, measures the content's own size on ONE owned axis (from the\n * `ResizeObserver` border-box \u2014 no `getBoundingClientRect`, no forced reflow),\n * and advertises it via the injected `publish`. Shares the forward primitive's\n * measure/coalesce/dedupe/dispose engine (`createMeasureLoop`).\n *\n * The extent is `Math.round`ed and clamped to `>= 0`; non-finite measurements\n * drop the frame.\n *\n * FOOTGUN \u2014 `target` must be shrink-to-fit on the owned axis: its owned-axis\n * size must NOT be driven by the host-applied view size, or the cross-process\n * loop (advertise \u2192 host resizes view \u2192 remeasure) never converges (it\n * oscillates or stays \"stable but wrong\"). Measuring `<body>`/`<html>` is the\n * classic mistake \u2014 their size *is* the view size. See\n * `docs/bidirectional-design.md` \u00A74/\u00A75.\n */\nexport function createSizeAdvertiser(\n  target: HTMLElement,\n  opts: SizeAdvertiserOptions,\n): SizeAdvertiserHandle {\n  const axis = opts.axis // immutable for the advertiser's life\n  let publish = opts.publish\n  let observer: ResizeObserver | null = null\n  let disposed = false\n  // Latest border-box, stashed by the RO callback and read by `produce` in the\n  // RAF body (keep the entry out of the shared, DOM-agnostic loop).\n  let latest: ResizeObserverSize | null = null\n\n  const produce = (): AdvertisedSize | null => {\n    if (!latest) return null\n    const raw = axis === 'block' ? latest.blockSize : latest.inlineSize\n    if (!Number.isFinite(raw)) return null\n    return { axis, extent: Math.max(0, Math.round(raw)) }\n  }\n\n  const loop = createMeasureLoop<AdvertisedSize>({\n    produce,\n    same: (a, b) => a.extent === b.extent, // axis is constant\n    sink: (size) => publish(size),\n  })\n\n  const onResize: ResizeObserverCallback = (entries) => {\n    const entry = entries[entries.length - 1]\n    if (entry) {\n      latest = entry.borderBoxSize?.[0] ?? entry.contentBoxSize?.[0] ?? latest\n    }\n    loop.schedule()\n  }\n\n  // One cheap, once-per-advertiser guard for the textbook feedback-loop footgun.\n  const doc = target.ownerDocument\n  if (target === doc.body || target === doc.documentElement) {\n    console.warn(\n      `[view-anchor] size-advertiser: <${target === doc.body ? 'body' : 'html'}>'s ` +\n        `${axis} size is the host-given view size, not the content size \u2014 the ` +\n        `advertiser will never shrink to content. Measure a shrink-to-fit wrapper. ` +\n        `See bidirectional-design.md \u00A74.`,\n    )\n  }\n\n  loop.setActive(true)\n  observer = new ResizeObserver(onResize)\n  observer.observe(target)\n\n  return {\n    update(nextPublish: (size: AdvertisedSize) => void): void {\n      if (disposed) return\n      publish = nextPublish\n      // Re-advertise the current size to the new sink immediately (mirrors the\n      // forward anchor's re-publish on update) so the new channel is not left\n      // sizeless until the next ResizeObserver tick.\n      const cur = produce()\n      if (cur) loop.emitNow(cur)\n    },\n    dispose(): void {\n      if (disposed) return\n      disposed = true\n      loop.cancel()\n      if (observer) {\n        observer.disconnect()\n        observer = null\n      }\n      loop.dispose()\n    },\n  }\n}\n", "/**\n * Centralised IPC channel name constants for dimina-devtools.\n *\n * Every raw channel string used across main, renderer, preload and e2e code\n * should reference one of these constants so that renaming a channel only\n * requires a single edit.\n */\n\n// \u2500\u2500 Simulator (preload \u2192 host / renderer \u2194 main) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport const SimulatorChannel = {\n  // Ask main to create the simulator as a top-level WebContentsView (so nested\n  // render-host <webview>s can attach). Native-host is the sole runtime.\n  AttachNative: 'simulator:attach-native',\n  // Renderer reports the device-bezel inner-screen rect (CSS px from content\n  // top-left) + zoom so main can overlay the simulator WCV on it.\n  SetNativeBounds: 'simulator:set-native-bounds',\n  // Renderer pushes the selected device's LOGICAL metrics (screen size,\n  // pixelRatio, statusBarHeight, \u2026) when the device dropdown changes. Main\n  // maps it to a HostEnvSnapshot and live-updates the running service-host\n  // window \u2014 the authoritative `wx.getSystemInfoSync()` source \u2014 so the\n  // mini-app sees the selected device without a relaunch.\n  SetDeviceInfo: 'simulator:set-device-info',\n  Detach: 'simulator:detach',\n  Resize: 'simulator:resize',\n  SetVisible: 'simulator:setVisible',\n  Console: 'simulator:console',\n  // Main \u2192 renderer push of the visible top-of-stack page route whenever the\n  // mini-app navigates (navigateTo / switchTab / back). Payload: the page path\n  // string (same bare format as `getCurrentPagePath`), or '' when unknown.\n  CurrentPage: 'simulator:current-page',\n} as const\n\n/** iPhone bezel cutout family driving the device-shell notch visual. */\nexport type NotchType = 'none' | 'notch' | 'dynamic-island'\n\n/** Per-device safe-area insets in CSS px (portrait). */\nexport interface SafeAreaInsets {\n  top: number\n  right: number\n  bottom: number\n  left: number\n}\n\n/**\n * Logical device metrics pushed by the renderer device dropdown under\n * native-host (`SimulatorChannel.SetDeviceInfo`). Mirrors a row of the renderer\n * `DEVICES` table; main maps it onto a `HostEnvSnapshot` for the service-host\n * window so `wx.getSystemInfoSync()` reflects the selected device, relays it to\n * the simulator WCV (DeviceShell: bezel size + status bar + notch), and drives\n * the CSS `env(safe-area-inset-*)` override on render-host guests.\n */\nexport interface NativeDeviceInfo {\n  brand: string\n  model: string\n  system: string\n  platform: string\n  pixelRatio: number\n  screenWidth: number\n  screenHeight: number\n  statusBarHeight: number\n  safeAreaBottom: number\n  notchType: NotchType\n  safeAreaInsets: SafeAreaInsets\n}\n\n// \u2500\u2500 Service host (main \u2192 hidden service-host window) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport const ServiceHostChannel = {\n  /**\n   * NATIVE-HOST ONLY. Live-update the service-host window's host-env snapshot\n   * (device metrics) so subsequent `wx.getSystemInfoSync()` reflects a device\n   * change without a relaunch. The service-host preload mutates\n   * `__diminaSpawnContext.hostEnvSnapshot` in place (see `service-host/preload.cjs`).\n   */\n  HostEnvUpdate: 'service-host:host-env:update',\n} as const\n\n// \u2500\u2500 Custom simulator APIs (downstream-registered, main-process handlers) \u2500\u2500\n// list: simulator queries the names registered via instance.registerSimulatorApi().\n// invoke: simulator forwards an API call to the registry; result/reject propagates.\n//\n// These are ipcMain.handle channels invoked by the **main-window renderer**\n// only (trusted host). The simulator guest never reaches them directly \u2014 it\n// reaches the host via the bridge channels below, so the sender-policy can keep\n// the simulator off the IPC white-list.\nexport const SimulatorCustomApiChannel = {\n  List: 'simulator:custom-apis:list',\n  Invoke: 'simulator:custom-apis:invoke',\n} as const\n\n// \u2500\u2500 Custom APIs bridge (simulator \u2192 host) \u2500\u2500\n// payload = { id, op: 'list' } | { id, op: 'invoke', name, params } for Request,\n// { id, result } | { id, error } for Response. Transport (in\n// `src/preload/runtime/custom-apis.ts`): native-host \u2014 the simulator is a\n// top-level WebContentsView (no embedder), so Request goes via\n// `ipcRenderer.send` \u2192 `ipcMain.on` dispatcher bound to that simWc (view-manager\n// `attachNativeCustomApiBridge`) \u2192 Response via `simWc.send`. (The old\n// renderer-proxied `<webview>` transport, `ipcRenderer.sendToHost` \u2192\n// `<webview>.send`, no longer exists \u2014 native-host is the sole runtime.)\n//\n// Request/response are correlated by `id` so multiple concurrent invokes can\n// be in flight at once.\nexport const SimulatorCustomApiBridgeChannel = {\n  Request: 'simulator:custom-apis:bridge-request',\n  Response: 'simulator:custom-apis:bridge-response',\n} as const\n\n// \u2500\u2500 Storage (CDP-backed; main process attaches the debugger to the\n// simulator guest and forwards DOMStorage events to the renderer) \u2500\u2500\nexport const SimulatorStorageChannel = {\n  GetSnapshot: 'simulator:storage:snapshot',\n  GetActivePrefix: 'simulator:storage:activePrefix',\n  Set: 'simulator:storage:set',\n  Remove: 'simulator:storage:remove',\n  Clear: 'simulator:storage:clear',\n  ClearAll: 'simulator:storage:clearAll',\n  Event: 'simulator:storage:event',\n} as const\n\nexport interface StorageItem { key: string; value: string }\nexport type StorageEvent =\n  | { type: 'added'; key: string; newValue: string }\n  | { type: 'updated'; key: string; oldValue: string; newValue: string }\n  | { type: 'removed'; key: string }\n  | { type: 'cleared' }\n\nexport type StorageWriteResult =\n  | { ok: true }\n  | { ok: false; error: string }\n\n// \u2500\u2500 Element inspection (CDP-backed; WXML tree nodes map to real DOM by sid) \u2500\u2500\nexport const SimulatorElementChannel = {\n  Inspect: 'simulator:element:inspect',\n  Clear: 'simulator:element:clear',\n} as const\n\n// \u2500\u2500 Workbench runtime info (renderer reads once to pick panel data sources) \u2500\u2500\n// Under native-host the page DOM / service logic live in separate webContents,\n// so WXML + AppData are sourced from the main process instead of the simulator\n// guest's miniappSnapshot transport. The renderer queries this flag once and\n// branches usePanelData accordingly.\nexport const WorkbenchRuntimeChannel = {\n  GetNativeHost: 'workbench:runtime:native-host',\n} as const\n\n// \u2500\u2500 WXML tree (native-host: main pulls the tree from the active render-host\n// <webview> guest via render-inspect, and pushes/answers here \u2014 mirroring the\n// Storage panel's main\u2192renderer contract so the renderer panel is unchanged) \u2500\u2500\nexport const SimulatorWxmlChannel = {\n  GetSnapshot: 'simulator:wxml:snapshot',\n  Event: 'simulator:wxml:event',\n} as const\n\n// \u2500\u2500 AppData (native-host: main taps the service\u2192render setData stream in\n// bridge-router and pushes the cumulative snapshot here \u2014 the service logic runs\n// in the hidden service-host window, not a Worker in the simulator guest) \u2500\u2500\nexport const SimulatorAppDataChannel = {\n  GetSnapshot: 'simulator:appdata:snapshot',\n  Event: 'simulator:appdata:event',\n} as const\n\nexport interface ElementInspection {\n  sid: string\n  rect: {\n    x: number\n    y: number\n    width: number\n    height: number\n  }\n  style: {\n    display: string\n    position: string\n    boxSizing: string\n    margin: string\n    padding: string\n    color: string\n    backgroundColor: string\n    fontSize: string\n  }\n}\n\n// \u2500\u2500 Workbench settings \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport const WorkbenchSettingsChannel = {\n  Get: 'workbenchSettings:get',\n  Save: 'workbenchSettings:save',\n  SetTheme: 'workbenchSettings:setTheme',\n  GetCdpStatus: 'workbenchSettings:getCdpStatus',\n  GetMcpStatus: 'workbenchSettings:getMcpStatus',\n  SetVisible: 'workbenchSettings:setVisible',\n  Init: 'workbenchSettings:init',\n} as const\n\n// \u2500\u2500 Project session \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport const ProjectChannel = {\n  Open: 'project:open',\n  Close: 'project:close',\n  GetPages: 'project:getPages',\n  GetCompileConfig: 'project:getCompileConfig',\n  SaveCompileConfig: 'project:saveCompileConfig',\n  Status: 'project:status',\n  CaptureThumbnail: 'project:captureThumbnail',\n  GetThumbnail: 'project:getThumbnail',\n} as const\n\n// \u2500\u2500 Project file system (sandboxed to active project root) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n//\n// Read/write access to the active project's files, used by the in-renderer\n// Monaco editor. Every path is verified against the active project root in\n// the main process (see `services/project-fs`). Replaces the OpenSumi\n// editor's `editor:fs:*` bridge \u2014 same sandbox, callable from the main\n// renderer instead of a separate WebContentsView.\n\nexport const ProjectFsChannel = {\n  GetRoot: 'project:fs:getRoot',\n  ReadFile: 'project:fs:readFile',\n  WriteFile: 'project:fs:writeFile',\n  /**\n   * Synchronous (blocking) write, used ONLY by the editor's `beforeunload`\n   * flush: a hard window/app close tears the renderer down before an async\n   * `WriteFile` IPC can round-trip, so the last in-debounce-window edit would\n   * be lost. `sendSync` blocks page teardown until the bytes hit disk. Runs the\n   * SAME sandbox as `WriteFile` (see project-fs `writeFileSync`).\n   */\n  WriteFileSync: 'project:fs:writeFileSync',\n  ListFiles: 'project:fs:listFiles',\n} as const\n\n// \u2500\u2500 Editor (main \u2192 renderer) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n//\n// Drives the in-renderer Monaco editor from the main process. Used by the\n// \"click a console file link \u2192 open the file at line:col\" pipeline: the\n// embedded DevTools front-end routes a source-link click through an open-\n// resource handler \u2192 Electron `devtools-open-url` on the service host \u2192 main\n// maps the resource URL to a project-relative path \u2192 this event opens it in\n// Monaco. Payload: `EditorOpenFilePayload`.\n\nexport const EditorChannel = {\n  /** main \u2192 renderer: open `path` (project-relative POSIX) at `line`/`column`. */\n  OpenFile: 'editor:openFile',\n} as const\n\n/** Payload for `editor:openFile`. `line`/`column` are 1-based for Monaco. */\nexport interface EditorOpenFilePayload {\n  /** Project-relative POSIX path (the same key Monaco opens files by). */\n  path: string\n  /** 1-based line to reveal; omitted/<=0 means open without moving the cursor. */\n  line?: number\n  /** 1-based column to reveal; defaults to 1 when a line is given. */\n  column?: number\n}\n\n// \u2500\u2500 Project list / workspace \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport const ProjectsChannel = {\n  List: 'projects:list',\n  Add: 'projects:add',\n  Remove: 'projects:remove',\n  /** Phase 3: merged + sanitized template catalog for the create-project dialog. */\n  ListTemplates: 'projects:listTemplates',\n  /** Phase 3: host-supplied create-project dialog hook (returns input or null). */\n  OpenCreateDialog: 'projects:openCreateDialog',\n  /** Phase 3: server-side scaffold + register (delegates to create-project-service). */\n  Create: 'projects:create',\n  /** Default values used to pre-fill the create-project dialog (baseDir). */\n  GetCreateDefaults: 'projects:getCreateDefaults',\n} as const\n\n/** Renderer-facing payload for `projects:getCreateDefaults`. */\nexport interface ProjectCreateDefaults {\n  /** Absolute directory used as the parent for new projects. */\n  baseDir: string\n}\n\n// \u2500\u2500 Dialog \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport const DialogChannel = {\n  OpenDirectory: 'dialog:openDirectory',\n} as const\n\n// \u2500\u2500 Panels \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport const PanelChannel = {\n  List: 'panel:list',\n  Eval: 'panel:eval',\n  Select: 'panel:select',\n  SelectSimulator: 'panel:selectSimulator',\n} as const\n\n// \u2500\u2500 Embedded views (renderer \u2192 main) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n//\n// The main window's React layout owns the *positions* of the editor +\n// simulator-DevTools WebContentsView overlays \u2014 each visible placeholder\n// `<div>` measures its client rect via ResizeObserver and pushes the\n// rectangle to the main process. The view manager caches the latest\n// payload per kind and applies it to the overlay; no payload means the\n// overlay is hidden.\n//\n// Payload (after schema validation): `{ x, y, width, height }` in CSS\n// pixels relative to the window's content area (origin = top-left,\n// not including the OS chrome).\nexport const ViewChannel = {\n  /** Update the simulator DevTools view's bounds (or hide if w/h = 0). */\n  SimulatorDevtoolsBounds: 'view:simulator:devtools-bounds',\n  /**\n   * Host-controllable toolbar WebContentsView (sits ABOVE the devtools built-in\n   * header). Forward anchor: the main renderer reports the toolbar placeholder's\n   * bounds (or w/h=0 to hide). invoke.\n   */\n  HostToolbarBounds: 'view:host-toolbar:bounds',\n  /**\n   * Reverse size-advertiser: the host-toolbar WCV's OWN renderer advertises its\n   * intrinsic content height so main reserves exactly that much. Payload\n   * `{ axis: 'block', extent }`. fire-and-forget (send), NOT invoke.\n   */\n  HostToolbarAdvertiseHeight: 'view:host-toolbar:advertise-height',\n  /**\n   * main \u2192 main-window renderer: push the reserved host-toolbar height so the\n   * renderer placeholder div resizes (closing the dynamic-height loop).\n   */\n  HostToolbarHeightChanged: 'view:host-toolbar:height-changed',\n} as const\n\nexport interface ViewBounds {\n  x: number\n  y: number\n  width: number\n  height: number\n}\n\n// \u2500\u2500 Popover \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport const PopoverChannel = {\n  Show: 'popover:show',\n  Hide: 'popover:hide',\n  Relaunch: 'popover:relaunch',\n  Closed: 'popover:closed',\n  Init: 'popover:init',\n} as const\n\n// \u2500\u2500 Toolbar \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport const ToolbarChannel = {\n  GetActions: 'toolbar:getActions',\n  ActionsChanged: 'toolbar:actionsChanged',\n  /** Invoke a toolbar action by id: `invoke(Invoke, actionId)`. */\n  Invoke: 'toolbar:invoke',\n} as const\n\n// \u2500\u2500 Window \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport const WindowChannel = {\n  NavigateBack: 'window:navigateBack',\n} as const\n\n// \u2500\u2500 App \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport const AppChannel = {\n  GetPreloadPath: 'app:getPreloadPath',\n  GetBranding: 'app:getBranding',\n  GetHeaderHeight: 'app:getHeaderHeight',\n} as const\n\n// \u2500\u2500 miniappSnapshot (unified panel snapshot framework) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n//\n// Two generic channels shared by every snapshot source (AppData, WXML, \u2026).\n// Adding a new panel needs no new channel.\n//   Push: preload \u2192 renderer (`sendToHost`), payload: SnapshotEnvelope\n//   Pull: renderer \u2192 preload (`webview.send`),  payload: { id }\n\nexport const MiniappSnapshotChannel = {\n  Push: 'miniapp-snapshot:push',\n  Pull: 'miniapp-snapshot:pull',\n} as const\n\n// \u2500\u2500 Automation (WebSocket server) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport const AutomationChannel = {\n  GetPort: 'automation:port',\n} as const\n\n// \u2500\u2500 Embedded settings overlay \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport const SettingsChannel = {\n  SetVisible: 'settings:setVisible',\n  ConfigChanged: 'settings:configChanged',\n  ProjectSettingsChanged: 'settings:projectSettingsChanged',\n  Init: 'settings:init',\n  Closed: 'settings:closed',\n  Changed: 'settings:changed',\n} as const\n\n// \u2500\u2500 Updates (UpdateManager) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n//\n// String values are FROZEN: shipped builds key off them. Add new entries\n// here, never rename existing ones.\nexport const UpdateChannel = {\n  Check: 'updates:check',\n  Download: 'updates:download',\n  Install: 'updates:install',\n  DownloadProgress: 'updates:downloadProgress',\n  Available: 'updates:available',\n} as const\n", "// Preload for the host-controllable toolbar WebContentsView.\n//\n// Bundled into a single CJS file via build:preload (esbuild) and loaded as the\n// toolbar WCV's `preload`. Its only job is to run the reverse size-advertiser:\n// it measures the host content's intrinsic height (a shrink-to-fit element the\n// host marks `[data-host-toolbar-root]`) and posts it to main on the\n// `view:host-toolbar:advertise-height` channel, so the main renderer reserves\n// exactly that height and the toolbar tracks it (dynamic height, foundation\n// ViewAnchor reverse-advertiser).\nimport { installHostToolbarAdvertiserWhenReady } from '../runtime/host-toolbar-advertiser.js'\n\ninstallHostToolbarAdvertiserWhenReady()\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/preload/windows/host-toolbar.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=host-toolbar.d.ts.map

package/dist/preload/windows/host-toolbar.js

@@ -0,0 +1,12 @@
+// Preload for the host-controllable toolbar WebContentsView.
+//
+// Bundled into a single CJS file via build:preload (esbuild) and loaded as the
+// toolbar WCV's `preload`. Its only job is to run the reverse size-advertiser:
+// it measures the host content's intrinsic height (a shrink-to-fit element the
+// host marks `[data-host-toolbar-root]`) and posts it to main on the
+// `view:host-toolbar:advertise-height` channel, so the main renderer reserves
+// exactly that height and the toolbar tracks it (dynamic height, foundation
+// ViewAnchor reverse-advertiser).
+import { installHostToolbarAdvertiserWhenReady } from '../runtime/host-toolbar-advertiser.js';
+installHostToolbarAdvertiserWhenReady();
+//# sourceMappingURL=host-toolbar.js.map