@dimina-kit/devtools 0.4.0 → 0.5.0-dev.20260908120530

package/dist/shared/ipc-channels-overlays.js

@@ -0,0 +1,203 @@
+/**
+ * IPC channel name constants for dimina-devtools' overlay/panel
+ * WebContentsViews — layout slots (host-toolbar/host-sidebar/host-dialog),
+ * the popover, tooltip, project-create dialog and settings overlays, plus
+ * the update flow. Split out of `ipc-channels.ts` (see that file's header)
+ * once this group alone pushed it past the repo's file-length threshold —
+ * these constants share no runtime dependency on the rest of that file, so
+ * the split is a pure line-count relief valve, not a behavior change.
+ */
+// ── Embedded views (renderer → main) ─────────────────────────────────────
+//
+// The main window's React layout owns the *positions* of the editor +
+// simulator-DevTools WebContentsView overlays — each visible placeholder
+// `<div>` measures its client rect via ResizeObserver and pushes the
+// rectangle to the main process. The view manager caches the latest
+// payload per kind and applies it to the overlay; no payload means the
+// overlay is hidden.
+//
+// Payload (after schema validation): `{ x, y, width, height }` in CSS
+// pixels relative to the window's content area (origin = top-left,
+// not including the OS chrome).
+export const ViewChannel = {
+    /**
+     * 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 → host-toolbar WCV renderer: per-load MessagePort handshake for the
+     * gated narrow channel. On every toolbar `did-finish-load` main creates a
+     * `MessageChannelMain` and transfers port2 here
+     * (`wc.postMessage(HostToolbarPort, null, [port2])`); the session-resident
+     * toolbar runtime preload receives it via `event.ports[0]` and bridges it to
+     * the page as `window.diminaHostToolbar`. Envelope both directions:
+     * `{ channel: string, payload: unknown }`.
+     */
+    HostToolbarPort: 'view:host-toolbar:port',
+    /**
+     * 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',
+    /**
+     * main ← main-window renderer (invoke): pull the last NOTIFIED toolbar
+     * height retained in main. Mount-time replay companion to
+     * `HostToolbarHeightChanged`: the push listener mounts with the project
+     * view and the toolbar's size-advertiser deduplicates (never re-reports),
+     * so a height pushed while no project view was mounted would otherwise be
+     * lost forever (cold start on the project list races it; close-project →
+     * reopen hits it deterministically). No payload; resolves a number.
+     */
+    HostToolbarGetHeight: 'view:host-toolbar:get-height',
+    /**
+     * Reverse size-advertiser for the host-sidebar WCV, mirroring
+     * `HostToolbarAdvertiseHeight` on the inline (width) axis instead of block.
+     * Payload `{ axis: 'inline', extent }`. fire-and-forget (send), NOT invoke.
+     */
+    HostSidebarAdvertiseWidth: 'view:host-sidebar:advertise-width',
+    /**
+     * main → host-sidebar WCV renderer: per-load MessagePort handshake, same
+     * contract as `HostToolbarPort` (see that entry).
+     */
+    HostSidebarPort: 'view:host-sidebar:port',
+    /**
+     * main → main-window renderer: push the reserved host-sidebar width so the
+     * renderer placeholder div resizes, mirroring `HostToolbarHeightChanged`.
+     */
+    HostSidebarWidthChanged: 'view:host-sidebar:width-changed',
+    /**
+     * main ← main-window renderer (invoke): pull the last NOTIFIED sidebar
+     * width, mirroring `HostToolbarGetHeight`'s mount-time replay role.
+     */
+    HostSidebarGetWidth: 'view:host-sidebar:get-width',
+    /**
+     * main → main-window renderer: push the project category (`Project.type`)
+     * selected in the host-sidebar's content — devtools' own default icon rail,
+     * or any downstream replacement that sends on the same channel. No
+     * pull/replay companion like `HostSidebarGetWidth`: the default category is
+     * a stable initial value regardless of load-order, and nothing is ever sent
+     * before the main-window renderer (and thus `ProjectListScreen`) is already
+     * mounted.
+     */
+    HostSidebarCategorySelected: 'view:host-sidebar:category-selected',
+    /**
+     * Reverse size-advertiser for the host-dialog WCV. Unlike the toolbar/sidebar
+     * (single-axis, `setBaseDesired`-placed strips), the dialog is a BOTH-AXES
+     * overlay positioned by `setOverlayDesired` — main centers it in the main
+     * window once it knows both dimensions. One channel carries either axis'
+     * report (`{ axis: 'block' | 'inline', extent }`); the dialog's own content
+     * advertises both from the same root (see `host-dialog-advertiser.ts`).
+     * fire-and-forget (send), NOT invoke.
+     *
+     * No `HostDialogSizeChanged` / `HostDialogGetSize` counterparts: those exist
+     * for toolbar/sidebar so a renderer-owned PLACEHOLDER can replay a size it
+     * missed. The dialog has no such placeholder — it is a main-driven overlay
+     * shown/hidden on demand (`hostDialog.show()`/`hide()`), so there is nothing
+     * in the renderer to replay a size into.
+     */
+    HostDialogAdvertiseSize: 'view:host-dialog:advertise-size',
+    /**
+     * main → host-dialog WCV renderer: per-load MessagePort handshake, same
+     * contract as `HostToolbarPort` (see that entry).
+     */
+    HostDialogPort: 'view:host-dialog:port',
+    /**
+     * Renderer → main: the window-level placement snapshot (one monotonic epoch
+     * per commit tick, one generation per renderer lifetime) that drives the view
+     * reconciler. The single source of truth for every managed native view's
+     * bounds/visibility/z-order — supersedes the per-view bounds channels above.
+     * invoke.
+     */
+    PlacementSnapshot: 'view:placement-snapshot',
+    /**
+     * main ← main-window renderer (invoke): allocate a fresh placement
+     * generation seed for this renderer bootstrap. See
+     * renderer-placement-generation.ts for why the seed comes from main
+     * (a wall-clock `Date.now()` seed is not guaranteed to exceed main's
+     * still-standing high-water mark across two reloads that happen faster
+     * than the clock's resolution). No payload; resolves a number.
+     */
+    AllocatePlacementGeneration: 'view:allocate-placement-generation',
+};
+// ── Popover ──────────────────────────────────────────────────────────────
+export const PopoverChannel = {
+    Show: 'popover:show',
+    Hide: 'popover:hide',
+    // Popover → main → main-renderer: the edited compile modes, plus whether
+    // the change affects what is currently running (selecting a mode, or
+    // editing the selected one) and so needs a relaunch.
+    Apply: 'popover:apply',
+    Closed: 'popover:closed',
+    Init: 'popover:init',
+};
+// ── Tooltip ──────────────────────────────────────────────────────────────
+//
+// A top-tier overlay WebContentsView (VIEW_LAYER.tooltip — see view-ids.ts),
+// NOT a DOM tooltip in the main renderer: any DOM-portaled floating UI (Radix
+// Tooltip) or the browser-native `title` attribute lives in the main
+// renderer's own paint surface, which every other WCV (simulator, editor,
+// settings, popover) renders on top of — CSS cannot reach across that
+// boundary. A trigger reports its anchor rect + label; main computes the
+// tooltip's screen bounds and shows/repositions/hides this overlay.
+export const OverlayChannel = {
+    Ready: 'overlay:ready',
+};
+export const TooltipChannel = {
+    Prepare: 'tooltip:prepare',
+    Show: 'tooltip:show',
+    Hide: 'tooltip:hide',
+    Init: 'tooltip:init',
+    Measured: 'tooltip:measured',
+};
+// ── Project-create dialog ───────────────────────────────────────────────
+//
+// A top-tier overlay WebContentsView (VIEW_LAYER.dialog), NOT the Radix
+// `fixed inset-0` DOM portal it replaced — a DOM overlay paints inside the
+// main window's own renderer, so any native WebContentsView mounted on top
+// (simulator, host-toolbar, host-sidebar) occludes it. main.tsx fetches the
+// template catalog + base-dir defaults, then asks main to show this panel;
+// the panel relays submit/cancel back to main.tsx to run the existing
+// scaffold flow.
+export const ProjectCreateChannel = {
+    Show: 'projectCreate:show',
+    Init: 'projectCreate:init',
+    Submit: 'projectCreate:submit',
+    Cancel: 'projectCreate:cancel',
+    Submitted: 'projectCreate:submitted',
+};
+// ── Device picker ────────────────────────────────────────────────────────
+//
+// A top-tier overlay WebContentsView (VIEW_LAYER.dialog), for the same reason
+// as the project-create dialog above: the simulator's own WebContentsView is
+// mounted on top of the main renderer and overlaps the centred search panel,
+// so a DOM-portaled dialog is cut in half by it. The toolbar keeps only the
+// trigger button; it asks main to show this panel with the currently selected
+// device, and main relays the picked device name back to the toolbar.
+export const DevicePickerChannel = {
+    Show: 'devicePicker:show',
+    Init: 'devicePicker:init',
+    Select: 'devicePicker:select',
+    Cancel: 'devicePicker:cancel',
+    Selected: 'devicePicker:selected',
+};
+// ── Embedded settings overlay ────────────────────────────────────────────
+export const SettingsChannel = {
+    SetVisible: 'settings:setVisible',
+    ProjectSettingsChanged: 'settings:projectSettingsChanged',
+    Init: 'settings:init',
+};
+// ── Updates (UpdateManager) ──────────────────────────────────────────────
+//
+// String values are FROZEN: shipped builds key off them. Add new entries
+// here, never rename existing ones.
+export const UpdateChannel = {
+    Check: 'updates:check',
+    Download: 'updates:download',
+    Install: 'updates:install',
+    DownloadProgress: 'updates:downloadProgress',
+    Available: 'updates:available',
+    Close: 'updates:close',
+};
+//# sourceMappingURL=ipc-channels-overlays.js.map

package/dist/shared/ipc-channels.d.ts

@@ -13,51 +13,21 @@ export declare const SimulatorChannel: {
     readonly Console: "simulator:console";
     readonly CurrentPage: "simulator:current-page";
 };
-/** iPhone bezel cutout family driving the device-shell notch visual. */
-export type NotchType = 'none' | 'notch' | 'dynamic-island';
-/** Per-device safe-area insets in CSS px (portrait). */
-export interface SafeAreaInsets {
-    top: number;
-    right: number;
-    bottom: number;
-    left: number;
-}
-/**
- * Logical device metrics pushed by the renderer device dropdown under
- * native-host (`SimulatorChannel.SetDeviceInfo`). Mirrors a row of the renderer
- * `DEVICES` table; main maps it onto a `HostEnvSnapshot` for the service-host
- * window so `wx.getSystemInfoSync()` reflects the selected device, relays it to
- * the simulator WCV (DeviceShell: bezel size + status bar + notch), and drives
- * the CSS `env(safe-area-inset-*)` override on render-host guests.
- */
-export interface NativeDeviceInfo {
-    brand: string;
-    model: string;
-    system: string;
-    platform: string;
-    pixelRatio: number;
-    screenWidth: number;
-    screenHeight: number;
-    statusBarHeight: number;
-    notchType: NotchType;
-    safeAreaInsets: SafeAreaInsets;
-}
+export type { DeviceOrientation, NativeDeviceInfo, SafeAreaInsets, } from '@dimina-kit/electron-runtime';
 export declare const ServiceHostChannel: {
     /**
-     * NATIVE-HOST ONLY. Live-update the service-host window's host-env snapshot
-     * (device metrics) so subsequent `wx.getSystemInfoSync()` reflects a device
-     * change without a relaunch. The service-host preload mutates
-     * `__diminaSpawnContext.hostEnvSnapshot` in place (see `service-host/preload.cjs`).
+     * NATIVE-HOST ONLY. Deliver an AppData-panel edit (`{bridgeId, data}`) into
+     * the service-host window. The preload resolves the page instance via
+     * `getCurrentPages()` and calls `page.setData(data)`, so the resulting `ub`
+     * publish flows back through the normal service→render tap — the panel
+     * refreshes from the runtime's own state, not an optimistic local echo.
      */
-    readonly HostEnvUpdate: "service-host:host-env:update";
+    readonly AppDataSetData: "service-host:appdata:set-data";
 };
 export declare const SimulatorCustomApiChannel: {
     readonly Invoke: "simulator:custom-apis:invoke";
 };
-export declare const SimulatorCustomApiBridgeChannel: {
-    readonly Request: "simulator:custom-apis:bridge-request";
-    readonly Response: "simulator:custom-apis:bridge-response";
-};
+export { SimulatorCustomApiBridgeChannel, } from '@dimina-kit/electron-runtime/shared/bridge-channels';
 export declare const SimulatorStorageChannel: {
     readonly GetSnapshot: "simulator:storage:snapshot";
     readonly GetActivePrefix: "simulator:storage:activePrefix";
@@ -67,31 +37,7 @@ export declare const SimulatorStorageChannel: {
     readonly ClearAll: "simulator:storage:clearAll";
     readonly Event: "simulator:storage:event";
 };
-export interface StorageItem {
-    key: string;
-    value: string;
-}
-export type StorageEvent = {
-    type: 'added';
-    key: string;
-    newValue: string;
-} | {
-    type: 'updated';
-    key: string;
-    oldValue: string;
-    newValue: string;
-} | {
-    type: 'removed';
-    key: string;
-} | {
-    type: 'cleared';
-};
-export type StorageWriteResult = {
-    ok: true;
-} | {
-    ok: false;
-    error: string;
-};
+export type { StorageEvent, StorageItem, StorageWriteResult } from '@dimina-kit/inspect';
 /**
  * A storage mutation reported by the service-host's SYNC wx storage APIs
  * (`setStorageSync`/`removeStorageSync`/`clearStorageSync`). Those run inside the
@@ -125,30 +71,14 @@ export declare const SimulatorWxmlChannel: {
 export declare const SimulatorAppDataChannel: {
     readonly GetSnapshot: "simulator:appdata:snapshot";
     readonly Event: "simulator:appdata:event";
+    readonly SetData: "simulator:appdata:set-data";
 };
-export interface ElementInspection {
-    sid: string;
-    rect: {
-        x: number;
-        y: number;
-        width: number;
-        height: number;
-    };
-    style: {
-        display: string;
-        position: string;
-        boxSizing: string;
-        margin: string;
-        padding: string;
-        color: string;
-        backgroundColor: string;
-        fontSize: string;
-    };
-}
+export type { ElementInspection } from '@dimina-kit/inspect';
 export declare const WorkbenchSettingsChannel: {
     readonly Get: "workbenchSettings:get";
     readonly Save: "workbenchSettings:save";
     readonly SetTheme: "workbenchSettings:setTheme";
+    readonly Restart: "workbenchSettings:restart";
     readonly GetCdpStatus: "workbenchSettings:getCdpStatus";
     readonly GetMcpStatus: "workbenchSettings:getMcpStatus";
     readonly Init: "workbenchSettings:init";
@@ -157,17 +87,17 @@ export declare const WorkbenchSettingsChannel: {
 export declare const ProjectChannel: {
     readonly Open: "project:open";
     readonly Close: "project:close";
+    readonly Rebuild: "project:rebuild";
     readonly GetPages: "project:getPages";
     readonly GetCompileConfig: "project:getCompileConfig";
     readonly SaveCompileConfig: "project:saveCompileConfig";
+    readonly GetCompileModeState: "project:getCompileModeState";
+    readonly CompileModesChanged: "project:compileModesChanged";
+    readonly CompileModesApplyFailed: "project:compileModesApplyFailed";
     readonly Status: "project:status";
     readonly CompileLog: "project:compileLog";
     readonly CaptureThumbnail: "project:captureThumbnail";
     readonly GetThumbnail: "project:getThumbnail";
-    readonly GetLaunchConfigs: "project:getLaunchConfigs";
-    readonly SaveLaunchConfigs: "project:saveLaunchConfigs";
-    readonly GetActiveLaunchConfigId: "project:getActiveLaunchConfigId";
-    readonly SaveActiveLaunchConfigId: "project:saveActiveLaunchConfigId";
 };
 export declare const SessionChannel: {
     readonly RuntimeStatus: "session:runtimeStatus";
@@ -203,10 +133,14 @@ export declare const ProjectsChannel: {
     readonly List: "projects:list";
     readonly Add: "projects:add";
     readonly Remove: "projects:remove";
+    /** Edit an existing record's name / icon; its path stays the identity. */
+    readonly Update: "projects:update";
     /** Merged + sanitized template catalog for the create-project dialog. */
     readonly ListTemplates: "projects:listTemplates";
     /** Host-supplied create-project dialog hook (returns input or null). */
     readonly OpenCreateDialog: "projects:openCreateDialog";
+    /** Host-supplied edit-project dialog hook; `null` means no hook is configured. */
+    readonly OpenEditDialog: "projects:openEditDialog";
     /** Server-side scaffold + register (delegates to create-project-service). */
     readonly Create: "projects:create";
     /** Default values used to pre-fill the create-project dialog (baseDir). */
@@ -220,64 +154,10 @@ export interface ProjectCreateDefaults {
 export declare const DialogChannel: {
     readonly OpenDirectory: "dialog:openDirectory";
 };
-export declare const ViewChannel: {
-    /**
-     * 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.
-     */
-    readonly HostToolbarAdvertiseHeight: "view:host-toolbar:advertise-height";
-    /**
-     * main → host-toolbar WCV renderer: per-load MessagePort handshake for the
-     * gated narrow channel. On every toolbar `did-finish-load` main creates a
-     * `MessageChannelMain` and transfers port2 here
-     * (`wc.postMessage(HostToolbarPort, null, [port2])`); the session-resident
-     * toolbar runtime preload receives it via `event.ports[0]` and bridges it to
-     * the page as `window.diminaHostToolbar`. Envelope both directions:
-     * `{ channel: string, payload: unknown }`.
-     */
-    readonly HostToolbarPort: "view:host-toolbar:port";
-    /**
-     * main → main-window renderer: push the reserved host-toolbar height so the
-     * renderer placeholder div resizes (closing the dynamic-height loop).
-     */
-    readonly HostToolbarHeightChanged: "view:host-toolbar:height-changed";
-    /**
-     * main ← main-window renderer (invoke): pull the last NOTIFIED toolbar
-     * height retained in main. Mount-time replay companion to
-     * `HostToolbarHeightChanged`: the push listener mounts with the project
-     * view and the toolbar's size-advertiser deduplicates (never re-reports),
-     * so a height pushed while no project view was mounted would otherwise be
-     * lost forever (cold start on the project list races it; close-project →
-     * reopen hits it deterministically). No payload; resolves a number.
-     */
-    readonly HostToolbarGetHeight: "view:host-toolbar:get-height";
-    /**
-     * Renderer → main: the window-level placement snapshot (one monotonic epoch
-     * per commit tick, one generation per renderer lifetime) that drives the view
-     * reconciler. The single source of truth for every managed native view's
-     * bounds/visibility/z-order — supersedes the per-view bounds channels above.
-     * invoke.
-     */
-    readonly PlacementSnapshot: "view:placement-snapshot";
-};
-export interface ViewBounds {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-}
-export declare const PopoverChannel: {
-    readonly Show: "popover:show";
-    readonly Hide: "popover:hide";
-    readonly Relaunch: "popover:relaunch";
-    readonly Closed: "popover:closed";
-    readonly Init: "popover:init";
-    readonly SwitchLaunchConfig: "popover:switchLaunchConfig";
-    readonly UpdateLaunchConfigs: "popover:updateLaunchConfigs";
-};
 export declare const WindowChannel: {
     readonly NavigateBack: "window:navigateBack";
+    readonly OpenProject: "window:openProject";
+    readonly OpenProjectWindow: "window:openProjectWindow";
 };
 export declare const AppChannel: {
     readonly GetBranding: "app:getBranding";
@@ -289,17 +169,7 @@ export declare const MiniappSnapshotChannel: {
 export declare const AutomationChannel: {
     readonly GetPort: "automation:port";
 };
-export declare const SettingsChannel: {
-    readonly SetVisible: "settings:setVisible";
-    readonly ConfigChanged: "settings:configChanged";
-    readonly ProjectSettingsChanged: "settings:projectSettingsChanged";
-    readonly Init: "settings:init";
-};
-export declare const UpdateChannel: {
-    readonly Check: "updates:check";
-    readonly Download: "updates:download";
-    readonly Install: "updates:install";
-    readonly DownloadProgress: "updates:downloadProgress";
-    readonly Available: "updates:available";
+export declare const InternalDevtoolsChannel: {
+    readonly Open: "internal-devtools:open";
 };
 //# sourceMappingURL=ipc-channels.d.ts.map