@dimina-kit/devtools 0.4.0-dev.20260824071518 → 0.4.0-dev.20260828161241

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

@@ -138,10 +138,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). */
@@ -155,70 +159,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 OverlayChannel: {
-    readonly Ready: "overlay:ready";
-};
-export declare const TooltipChannel: {
-    readonly Prepare: "tooltip:prepare";
-    readonly Show: "tooltip:show";
-    readonly Hide: "tooltip:hide";
-    readonly Init: "tooltip:init";
-    readonly Measured: "tooltip:measured";
-};
 export declare const WindowChannel: {
     readonly NavigateBack: "window:navigateBack";
     readonly OpenProject: "window:openProject";
@@ -237,17 +177,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

@@ -193,10 +193,14 @@ export const ProjectsChannel = {
     List: 'projects:list',
     Add: 'projects:add',
     Remove: 'projects:remove',
+    /** Edit an existing record's name / icon; its path stays the identity. */
+    Update: 'projects:update',
     /** Merged + sanitized template catalog for the create-project dialog. */
     ListTemplates: 'projects:listTemplates',
     /** Host-supplied create-project dialog hook (returns input or null). */
     OpenCreateDialog: 'projects:openCreateDialog',
+    /** Host-supplied edit-project dialog hook; `null` means no hook is configured. */
+    OpenEditDialog: 'projects:openEditDialog',
     /** Server-side scaffold + register (delegates to create-project-service). */
     Create: 'projects:create',
     /** Default values used to pre-fill the create-project dialog (baseDir). */
@@ -206,86 +210,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',
-};
-// ── 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',
-};
 // ── Window ───────────────────────────────────────────────────────────────
 export const WindowChannel = {
     NavigateBack: 'window:navigateBack',
@@ -322,21 +246,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

@@ -42,6 +42,22 @@ export declare const TooltipMeasuredSchema: z.ZodTuple<[z.ZodObject<{
     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
@@ -114,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.
  *
@@ -125,8 +158,19 @@ export declare const SimulatorCustomApiInvokeSchema: z.ZodTuple<[z.ZodString, z.
 export declare const ProjectGetPagesSchema: z.ZodTuple<[z.ZodString], null>;
 /** project:getCompileConfig — absolute project path. */
 export declare const ProjectGetCompileConfigSchema: z.ZodTuple<[z.ZodString], null>;
+/**
+ * projects:update — absolute project directory path + the editable subset of
+ * its record. The path is the identity of the record being edited, never a
+ * field of the patch.
+ */
+export declare const ProjectsUpdateSchema: z.ZodTuple<[z.ZodString, z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    iconUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], null>;
 /** projects:remove — absolute project directory path. */
 export declare const ProjectsRemoveSchema: z.ZodTuple<[z.ZodString], null>;
+/** projects:openEditDialog — absolute project directory path. */
+export declare const ProjectsOpenEditDialogSchema: z.ZodTuple<[z.ZodString], null>;
 /**
  * workbenchSettings:save — full WorkbenchSettings object.
  *

package/dist/shared/ipc-schemas.js

@@ -66,6 +66,26 @@ export const TooltipMeasuredSchema = z.tuple([
         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).
@@ -167,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.
  *
@@ -181,8 +222,22 @@ export const SimulatorCustomApiInvokeSchema = z.tuple([
 export const ProjectGetPagesSchema = z.tuple([AbsolutePath]);
 /** project:getCompileConfig — absolute project path. */
 export const ProjectGetCompileConfigSchema = z.tuple([AbsolutePath]);
+/**
+ * projects:update — absolute project directory path + the editable subset of
+ * its record. The path is the identity of the record being edited, never a
+ * field of the patch.
+ */
+export const ProjectsUpdateSchema = z.tuple([
+    AbsolutePath,
+    z.object({
+        name: z.string().min(1).max(200).optional(),
+        iconUrl: z.string().max(2048).optional(),
+    }),
+]);
 /** projects:remove — absolute project directory path. */
 export const ProjectsRemoveSchema = z.tuple([AbsolutePath]);
+/** projects:openEditDialog — absolute project directory path. */
+export const ProjectsOpenEditDialogSchema = z.tuple([AbsolutePath]);
 /**
  * workbenchSettings:save — full WorkbenchSettings object.
  *

package/dist/shared/types.d.ts

@@ -123,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;
@@ -212,6 +222,7 @@ export interface ProjectsProvider {
     validateProjectDir?(dirPath: string): string | null;
     addProject(dirPath: string): unknown;
     removeProject(dirPath: string): void | Promise<void>;
+    updateProject?(dirPath: string, patch: unknown): unknown;
     updateLastOpened?(dirPath: string): void | Promise<void>;
     getCompileConfig?(dirPath: string): unknown;
     saveCompileConfig?(dirPath: string, cfg: unknown): void | Promise<void>;
@@ -345,6 +356,32 @@ export interface WorkbenchAppConfig extends WorkbenchConfig {
         parentWindow: import('electron').BrowserWindow;
         templates: ProjectTemplate[];
     }) => Promise<CustomCreateProjectDialogResult>;
+    /**
+     * Host-supplied "编辑项目" dialog. When provided, the renderer routes the
+     * project card's edit action through IPC into this main-process hook
+     * instead of showing the built-in dialog. `project` is read from the
+     * current project-list record (not whatever the renderer happened to have
+     * in state), so the host always sees devtools' own authoritative record.
+     *
+     * Return either:
+     *  - `null` — user cancelled; devtools does nothing.
+     *  - `{ name?, iconUrl? }` — the host collected an edit; devtools applies
+     *    it via `workspace.updateProject`, the same path the built-in dialog's
+     *    submit uses.
+     *  - `{ updated: EditableProject }` — the host has ALREADY persisted the
+     *    change itself; devtools just refreshes the list.
+     *
+     * Unlike `customCreateProjectDialog`, "no hook configured" and "user
+     * cancelled" are NOT both collapsed to `null` on the wire: the create flow
+     * does that and it means a cancelled host dialog falls through into the
+     * built-in one right after. The `projects:openEditDialog` IPC instead
+     * returns `null` only when no hook is configured, and wraps the hook's
+     * result as `{ result }` otherwise — see `OpenEditProjectDialogReply`.
+     */
+    customEditProjectDialog?: (ctx: {
+        parentWindow: import('electron').BrowserWindow;
+        project: EditableProject;
+    }) => Promise<CustomEditProjectDialogResult>;
 }
 /**
  * Discriminated return of `customCreateProjectDialog`. `null` = cancelled.
@@ -362,4 +399,38 @@ export type CustomCreateProjectDialogResult = null | {
         lastOpened?: string | null;
     };
 } | CreateProjectInput;
+/**
+ * Structural minimum devtools needs to render a project-list card, passed to
+ * `customEditProjectDialog` and returned as its `updated` variant. Mirrors
+ * `Project` in `./projects-provider`.
+ */
+export interface EditableProject {
+    name: string;
+    path: string;
+    iconUrl?: string;
+    lastOpened?: string | null;
+}
+/**
+ * Discriminated return of `customEditProjectDialog`. `null` = cancelled.
+ * `{ updated }` = the host already persisted the edit; devtools just
+ * refreshes. Otherwise a `{ name?, iconUrl? }` patch devtools applies via
+ * `workspace.updateProject`.
+ */
+export type CustomEditProjectDialogResult = null | {
+    updated: EditableProject;
+} | {
+    name?: string;
+    iconUrl?: string;
+};
+/**
+ * Wire reply for `projects:openEditDialog`. `null` means the host configured
+ * no `customEditProjectDialog` hook at all — the renderer should show the
+ * built-in dialog. When a hook IS configured, the IPC always resolves
+ * `{ result }` even if `result` is `null` (user cancelled the host dialog),
+ * so the renderer can tell "no hook" apart from "hook ran, user cancelled"
+ * and skip the built-in fallback in the latter case.
+ */
+export type OpenEditProjectDialogReply = null | {
+    result: CustomEditProjectDialogResult;
+};
 //# sourceMappingURL=types.d.ts.map