@dimina-kit/devtools 0.4.0-dev.20260803105710 → 0.4.0-dev.20260828092243

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

@@ -0,0 +1,186 @@
+/**
+ * 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',
+    Relaunch: 'popover:relaunch',
+    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',
+};
+// ── Embedded settings overlay ────────────────────────────────────────────
+export const SettingsChannel = {
+    SetVisible: 'settings:setVisible',
+    ConfigChanged: 'settings:configChanged',
+    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

@@ -95,6 +95,7 @@ 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";
@@ -154,60 +155,6 @@ 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";
-};
 export declare const WindowChannel: {
     readonly NavigateBack: "window:navigateBack";
     readonly OpenProject: "window:openProject";
@@ -226,17 +173,4 @@ export declare const AutomationChannel: {
 export declare const InternalDevtoolsChannel: {
     readonly Open: "internal-devtools:open";
 };
-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";
-};
 //# sourceMappingURL=ipc-channels.d.ts.map

package/dist/shared/ipc-channels.js

@@ -25,8 +25,11 @@ export const SimulatorChannel = {
     Detach: 'simulator:detach',
     Console: 'simulator:console',
     // Main → renderer push of the visible top-of-stack page route whenever the
-    // mini-app navigates (navigateTo / switchTab / back). Payload: the page path
-    // string (same bare format as `getCurrentPagePath`), or '' when unknown.
+    // mini-app navigates (navigateTo / switchTab / back). Payload: the page
+    // route string (`pagePath` + `?k=v&…` query, same format as
+    // `encodePageSpec`/`decodePageSpec`), or '' when unknown. The query lets the
+    // page-path bar show params (WeChat DevTools parity) and a recompile restore
+    // the current page's params.
     CurrentPage: 'simulator:current-page',
 };
 // ── Service host (main → hidden service-host window) ─────────────────────
@@ -128,6 +131,10 @@ export const WorkbenchSettingsChannel = {
 export const ProjectChannel = {
     Open: 'project:open',
     Close: 'project:close',
+    // Renderer → main invoke: run one real recompile of the active session
+    // (the popover 重新编译 button). Resolves `{ supported: boolean }`; rejects
+    // on build failure or when no session is active.
+    Rebuild: 'project:rebuild',
     GetPages: 'project:getPages',
     GetCompileConfig: 'project:getCompileConfig',
     SaveCompileConfig: 'project:saveCompileConfig',
@@ -199,67 +206,6 @@ export const ProjectsChannel = {
 export const DialogChannel = {
     OpenDirectory: 'dialog:openDirectory',
 };
-// ── 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',
-    /**
-     * 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',
-};
-// ── Popover ──────────────────────────────────────────────────────────────
-export const PopoverChannel = {
-    Show: 'popover:show',
-    Hide: 'popover:hide',
-    Relaunch: 'popover:relaunch',
-    Closed: 'popover:closed',
-    Init: 'popover:init',
-};
 // ── Window ───────────────────────────────────────────────────────────────
 export const WindowChannel = {
     NavigateBack: 'window:navigateBack',
@@ -296,21 +242,3 @@ export const InternalDevtoolsChannel = {
     // its own dedicated window (see internal-devtools-window/index.ts).
     Open: 'internal-devtools:open',
 };
-// ── Embedded settings overlay ────────────────────────────────────────────
-export const SettingsChannel = {
-    SetVisible: 'settings:setVisible',
-    ConfigChanged: 'settings:configChanged',
-    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',
-};

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

@@ -23,6 +23,41 @@ export declare const ProjectSaveCompileConfigSchema: z.ZodTuple<[z.ZodString, z.
 }, z.core.$loose>], null>;
 /** popover:show — must be an object (not undefined/null/string). */
 export declare const PopoverShowSchema: z.ZodTuple<[z.ZodObject<{}, z.core.$loose>], null>;
+/**
+ * tooltip:show — the trigger's own bounding rect (CSS px, main-window content
+ * coordinates — same space `getBoundingClientRect()` reports, no conversion,
+ * mirrors the base-view placement snapshot's Bounds) plus the label text.
+ */
+export declare const TooltipShowSchema: z.ZodTuple<[z.ZodObject<{
+    anchor: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strip>;
+    text: z.ZodString;
+}, z.core.$strip>], null>;
+export declare const TooltipMeasuredSchema: z.ZodTuple<[z.ZodObject<{
+    requestId: z.ZodNumber;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+}, z.core.$strip>], null>;
+/**
+ * projectCreate:show — the merged template catalog + suggested base dir
+ * main.tsx already resolved before asking main to show the overlay panel.
+ * Templates are re-validated loosely (they only round-trip back into the
+ * panel's own render, never interpreted main-side).
+ */
+export declare const ProjectCreateShowSchema: z.ZodTuple<[z.ZodObject<{
+    templates: z.ZodArray<z.ZodObject<{}, z.core.$loose>>;
+    defaultBaseDir: z.ZodString;
+}, z.core.$strip>], null>;
+/** projectCreate:submit — the collected create-project form. */
+export declare const ProjectCreateSubmitSchema: z.ZodTuple<[z.ZodObject<{
+    name: z.ZodString;
+    path: z.ZodString;
+    templateId: z.ZodString;
+}, z.core.$strip>], null>;
 /**
  * simulator:attach-native (native-host only) — the simulator URL to load into
  * the top-level WebContentsView + simulator width. The URL is the dev-server
@@ -95,6 +130,23 @@ export declare const HostToolbarAdvertiseHeightSchema: z.ZodTuple<[z.ZodObject<{
     axis: z.ZodLiteral<"block">;
     extent: z.ZodNumber;
 }, z.core.$strip>], null>;
+/**
+ * host-sidebar reverse size-advertiser payload — mirrors
+ * `HostToolbarAdvertiseHeightSchema` on the inline (width) axis.
+ */
+export declare const HostSidebarAdvertiseWidthSchema: z.ZodTuple<[z.ZodObject<{
+    axis: z.ZodLiteral<"inline">;
+    extent: z.ZodNumber;
+}, z.core.$strip>], null>;
+/**
+ * host-dialog reverse size-advertiser payload. Unlike the single-axis
+ * toolbar/sidebar, the dialog's content advertises BOTH axes over the same
+ * channel — `axis` distinguishes which report this is.
+ */
+export declare const HostDialogAdvertiseSizeSchema: z.ZodTuple<[z.ZodObject<{
+    axis: z.ZodUnion<readonly [z.ZodLiteral<"block">, z.ZodLiteral<"inline">]>;
+    extent: z.ZodNumber;
+}, z.core.$strip>], null>;
 /**
  * simulator:custom-apis:invoke — API name + arbitrary JSON-serialisable params.
  *

package/dist/shared/ipc-schemas.js

@@ -43,6 +43,49 @@ export const ProjectSaveCompileConfigSchema = z.tuple([
 ]);
 /** popover:show — must be an object (not undefined/null/string). */
 export const PopoverShowSchema = z.tuple([z.looseObject({})]);
+/**
+ * tooltip:show — the trigger's own bounding rect (CSS px, main-window content
+ * coordinates — same space `getBoundingClientRect()` reports, no conversion,
+ * mirrors the base-view placement snapshot's Bounds) plus the label text.
+ */
+export const TooltipShowSchema = z.tuple([
+    z.object({
+        anchor: z.object({
+            x: z.number().finite(),
+            y: z.number().finite(),
+            width: z.number().finite().nonnegative(),
+            height: z.number().finite().nonnegative(),
+        }),
+        text: z.string().min(1).max(200),
+    }),
+]);
+export const TooltipMeasuredSchema = z.tuple([
+    z.object({
+        requestId: z.number().int().positive(),
+        width: z.number().finite().positive(),
+        height: z.number().finite().positive(),
+    }),
+]);
+/**
+ * projectCreate:show — the merged template catalog + suggested base dir
+ * main.tsx already resolved before asking main to show the overlay panel.
+ * Templates are re-validated loosely (they only round-trip back into the
+ * panel's own render, never interpreted main-side).
+ */
+export const ProjectCreateShowSchema = z.tuple([
+    z.object({
+        templates: z.array(z.looseObject({})),
+        defaultBaseDir: z.string(),
+    }),
+]);
+/** projectCreate:submit — the collected create-project form. */
+export const ProjectCreateSubmitSchema = z.tuple([
+    z.object({
+        name: z.string().min(1),
+        path: AbsolutePath,
+        templateId: z.string().min(1),
+    }),
+]);
 /**
  * Reasonable simulator width range. Window width is clamped UI-side, but
  * we still reject obvious garbage (negative, zero, absurdly large).
@@ -144,6 +187,27 @@ export const HostToolbarAdvertiseHeightSchema = z.tuple([
         extent: NonNegInt,
     }),
 ]);
+/**
+ * host-sidebar reverse size-advertiser payload — mirrors
+ * `HostToolbarAdvertiseHeightSchema` on the inline (width) axis.
+ */
+export const HostSidebarAdvertiseWidthSchema = z.tuple([
+    z.object({
+        axis: z.literal('inline'),
+        extent: NonNegInt,
+    }),
+]);
+/**
+ * host-dialog reverse size-advertiser payload. Unlike the single-axis
+ * toolbar/sidebar, the dialog's content advertises BOTH axes over the same
+ * channel — `axis` distinguishes which report this is.
+ */
+export const HostDialogAdvertiseSizeSchema = z.tuple([
+    z.object({
+        axis: z.union([z.literal('block'), z.literal('inline')]),
+        extent: NonNegInt,
+    }),
+]);
 /**
  * simulator:custom-apis:invoke — API name + arbitrary JSON-serialisable params.
  *

package/dist/shared/simulator-route.d.ts

@@ -63,6 +63,14 @@ export declare function parseLocationRoute(search: string): SimulatorRoute | nul
 export declare function parseRoute(url: string): SimulatorRoute | null;
 /** Return the current page path (no query) from a URL, or `''` if unparseable. */
 export declare function getCurrentPagePath(url: string): string;
+/**
+ * Return the current page as a `pagePath?k=v&…` route string (WeChat DevTools
+ * page-path format), with the internal `scene` bookkeeping param stripped so
+ * the displayed route matches what the page actually received in `onLoad`.
+ * Returns `''` if unparseable. Symmetric with `encodePageSpec`/`decodePageSpec`
+ * and with the `SimulatorChannel.CurrentPage` payload.
+ */
+export declare function getCurrentPageRoute(url: string): string;
 /**
  * Rewrite the URL so `entry === current`. Used before a hot-reload so the
  * container boots at just the top page — avoids merged-bundle requests for a

package/dist/shared/simulator-route.js

@@ -133,6 +133,21 @@ export function getCurrentPagePath(url) {
     const route = parseRoute(url);
     return route?.current.pagePath ?? '';
 }
+/**
+ * Return the current page as a `pagePath?k=v&…` route string (WeChat DevTools
+ * page-path format), with the internal `scene` bookkeeping param stripped so
+ * the displayed route matches what the page actually received in `onLoad`.
+ * Returns `''` if unparseable. Symmetric with `encodePageSpec`/`decodePageSpec`
+ * and with the `SimulatorChannel.CurrentPage` payload.
+ */
+export function getCurrentPageRoute(url) {
+    const route = parseRoute(url);
+    if (!route)
+        return '';
+    const query = { ...route.current.query };
+    delete query['scene'];
+    return encodePageSpec({ pagePath: route.current.pagePath, query });
+}
 /**
  * Rewrite the URL so `entry === current`. Used before a hot-reload so the
  * container boots at just the top page — avoids merged-bundle requests for a

package/dist/shared/types.d.ts

@@ -54,6 +54,13 @@ export interface ProjectSession {
     close: () => Promise<void>;
     port: number;
     appInfo: AppInfo;
+    /**
+     * Run one real recompile of the session's project. Optional: a host
+     * CompilationAdapter predating this capability may omit it — the rebuild
+     * IPC then degrades to `{ supported: false }` and the renderer falls back
+     * to its reattach-only relaunch.
+     */
+    rebuild?: () => Promise<void>;
 }
 export interface CompilationAdapter {
     openProject(opts: Omit<OpenProjectOptions, 'containerDir' | 'outputDir'>): Promise<ProjectSession>;
@@ -116,6 +123,16 @@ export interface CompileConfig {
         value: string;
     }[];
 }
+/**
+ * A project's runtime kind, detected from its source layout (see
+ * `detectRuntimeType` in main's `project-repository.ts`). Lives here because
+ * the value crosses the process boundary — main detects it and pushes it to
+ * the renderer over `ViewChannel.HostSidebarCategorySelected`, and the
+ * renderer's `Project.type` carries it back in the project list. Two
+ * structurally identical unions declared on either side would type-check
+ * against each other today and silently diverge the moment one gains a member.
+ */
+export type ProjectType = 'miniprogram' | 'minigame';
 export interface IpcResult<T = unknown> {
     success: boolean;
     data?: T;

package/dist/shared/view-ids.d.ts

@@ -3,8 +3,13 @@ export declare const VIEW_ID: {
     readonly simulatorDevtools: "simulator-devtools";
     readonly workbench: "workbench";
     readonly hostToolbar: "host-toolbar";
+    readonly hostSidebar: "host-sidebar";
+    readonly hostDialog: "host-dialog";
     readonly settings: "settings";
     readonly popover: "popover";
+    readonly tooltip: "tooltip";
+    readonly projectCreateDialog: "project-create-dialog";
+    readonly updateDialog: "update-dialog";
 };
 export type DevtoolsViewId = (typeof VIEW_ID)[keyof typeof VIEW_ID];
 export interface DevtoolsExtra {
@@ -13,7 +18,11 @@ export interface DevtoolsExtra {
 export declare const VIEW_LAYER: {
     readonly base: 0;
     readonly hostToolbar: 5;
+    readonly hostSidebar: 5;
     readonly settings: 10;
     readonly popover: 20;
+    readonly tooltip: 30;
+    readonly dialog: 40;
+    readonly hostDialog: 45;
 };
 //# sourceMappingURL=view-ids.d.ts.map

package/dist/shared/view-ids.js

@@ -8,18 +8,39 @@ export const VIEW_ID = {
     simulatorDevtools: 'simulator-devtools',
     workbench: 'workbench',
     hostToolbar: 'host-toolbar',
+    hostSidebar: 'host-sidebar',
+    hostDialog: 'host-dialog',
     settings: 'settings',
     popover: 'popover',
+    tooltip: 'tooltip',
+    projectCreateDialog: 'project-create-dialog',
+    updateDialog: 'update-dialog',
 };
 // z-order layers; larger paints on top. Base overlays share layer 0 (they never
 // overlap each other — the simulator device WCV, the console/DevTools WCV, and
 // the embedded workbench occupy disjoint dock regions). The host-toolbar strip
 // sits above the base row; settings and popover are the top tier (settings below
 // a simultaneously-open popover), replacing the imperative raiseTopOverlays.
+// tooltip sits above ALL of them — it must never be occluded by a popover/
+// settings sheet either, and it's the reason this layer exists at all: a
+// DOM-portaled (Radix) tooltip rendered by the main window's OWN renderer, or
+// even the browser-native `title` attribute, is part of that renderer's paint
+// surface and renders BEHIND every other WCV mounted on top of it (simulator,
+// editor, settings, popover) — CSS z-index cannot reach across that boundary.
+// Routing the tooltip through this same reconciler (a real WCV of its own,
+// placed via `setOverlayDesired`) is what actually fixes that; see
+// `overlay-panels-view.ts`'s tooltip functions.
 export const VIEW_LAYER = {
     base: 0,
     hostToolbar: 5,
+    hostSidebar: 5,
     settings: 10,
     popover: 20,
+    tooltip: 30,
+    // devtools' own ProjectCreateDialog/UpdateDialog panels (createOverlayPanel).
+    dialog: 40,
+    // Host-controlled fully-custom dialog (loadURL-level takeover); sits above
+    // devtools' own dialog layer so host content is never occluded by it.
+    hostDialog: 45,
 };
 //# sourceMappingURL=view-ids.js.map