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

package/dist/main/api.d.ts

@@ -2,7 +2,7 @@ export { launch, buildDefaultMenu, openSettingsWindow } from './app/launch.js';
 export type { WorkbenchAppInstance } from './app/app.js';
 export { suppressEpipe, setupCdpPort } from './app/bootstrap.js';
 export { asMiniappRuntime } from './runtime/miniapp-runtime.js';
-export type { MiniappRuntime, MiniappSessionAppInfo, DiminaHostToolbarPageBridge, } from './runtime/miniapp-runtime.js';
+export type { MiniappRuntime, MiniappSessionAppInfo, DiminaHostToolbarPageBridge, DiminaHostSidebarPageBridge, DiminaHostDialogPageBridge, } from './runtime/miniapp-runtime.js';
 export { createWorkbenchContext } from './services/workbench-context.js';
 export type { WorkbenchContext, CreateContextOptions } from './services/workbench-context.js';
 export { createMainWindow } from './windows/main-window/index.js';
@@ -11,6 +11,7 @@ export type { ViewManager } from './services/views/view-manager.js';
 export type { WorkspaceService } from './services/workspace/workspace-service.js';
 export type { Project, ProjectPages, ProjectSettings } from './services/projects/project-repository.js';
 export type { SimulatorApiHandler } from './services/simulator/custom-apis.js';
+export type { SimulatorUiExtensionHandle, SimulatorUiExtensionRegistration, } from '../shared/simulator-ui.js';
 export { rendererDir, defaultPreloadPath, simulatorDir, getRendererDir, getPreloadDir, getRendererHtml, } from './utils/paths.js';
 export { IpcRegistry } from './utils/ipc-registry.js';
 export type { SenderPolicy } from './utils/ipc-registry.js';

package/dist/main/app/app.d.ts

@@ -1,26 +1,45 @@
 import { BrowserWindow } from 'electron';
-import type { LaunchConfig, WorkbenchAppConfig } from '../../shared/types.js';
+import type { WorkbenchAppConfig } from '../../shared/types.js';
+import type { SimulatorUiExtensionHandle, SimulatorUiExtensionRegistration } from '../../shared/simulator-ui.js';
 import type { SimulatorApiHandler } from '../services/simulator/custom-apis.js';
-import { type WorkbenchContext } from '../services/workbench-context.js';
-import { type AutomationServer } from '../services/automation/index.js';
+import type { WorkbenchContext } from '../services/workbench-context.js';
+import type { AutomationServer } from '../services/automation/index.js';
 import { UpdateManager } from '../services/update/index.js';
 import { type Disposable } from '@dimina-kit/electron-deck/main';
 import { IpcRegistry } from '../utils/ipc-registry.js';
+import { type ProjectRef, type ProjectWindow } from './project-window.js';
+export { setupWindowModules } from './workbench-modules.js';
 export interface WorkbenchAppInstance {
+    /** The project-list window. It stays open for the whole session. */
     mainWindow: BrowserWindow;
+    /** The project-list window's context. Workbench windows have their own. */
     context: WorkbenchContext;
-    /** Gated custom-IPC registration surface bound to `context.senderPolicy`. */
+    /**
+     * Open `project` in its own workbench window, or focus the window already
+     * showing it. This is the only way a project is opened: the list window never
+     * turns into a workbench.
+     */
+    openProjectWindow: (project: ProjectRef) => Promise<BrowserWindow>;
+    /** Every open workbench window, in the order they were opened. */
+    projectWindows: () => ProjectWindow[];
+    /**
+     * Dispose every live window's WebContentsViews. Called at `before-quit`,
+     * while the main loop is still healthy, so no view survives into Chromium's
+     * native shutdown. Idempotent, and covers every window — a workbench window's
+     * views hold the MessagePorts that segfault if torn down natively.
+     */
+    disposeViews: () => void;
+    /** Gated custom-IPC registration surface; admits every workbench window. */
     readonly ipc: IpcRegistry;
     /** Adds a host-owned BrowserWindow to the trusted-sender set. */
     registerTrustedWindow: (win: BrowserWindow) => Disposable;
     /** Registers a simulator custom API into this context's registry. */
     registerSimulatorApi: (name: string, handler: SimulatorApiHandler) => Disposable;
+    /** Registers a downstream renderer extension for the simulator device UI. */
+    registerSimulatorUiExtension: (registration: SimulatorUiExtensionRegistration) => SimulatorUiExtensionHandle;
     automationServer?: AutomationServer;
     updateManager?: UpdateManager;
     dispose: () => Promise<void>;
-    getLaunchConfigs: () => Promise<LaunchConfig[]>;
-    setLaunchConfigs: (configs: LaunchConfig[]) => Promise<void>;
-    setActiveLaunchConfig: (id: string | null) => Promise<void>;
 }
 /**
  * Pre-ready bootstrap side effects (app name, CDP port, CSP suppression,
@@ -29,11 +48,21 @@ export interface WorkbenchAppInstance {
  */
 export declare function runDevtoolsBootstrap(config?: WorkbenchAppConfig): void;
 /**
- * Domain runtime assembly — the post-whenReady body. Builds the main window +
- * context, registers IPC modules, stands up simulator/storage/CDP/native-host
- * services, and returns the fat {@link WorkbenchAppInstance}. Extracted so the
- * v2 `RuntimeBackend.assemble` reuses the exact same body (parity by shared
+ * Domain runtime assembly — the post-whenReady body. Builds the app-wide
+ * services and the context router, opens the project window, registers IPC
+ * against the router, stands up simulator/storage/CDP/native-host services, and
+ * returns the fat {@link WorkbenchAppInstance}. Extracted so the v2
+ * `RuntimeBackend.assemble` reuses the exact same body (parity by shared
  * implementation, not behavioural re-creation).
  */
-export declare function createDevtoolsRuntime(config?: WorkbenchAppConfig): Promise<WorkbenchAppInstance>;
+export declare function createDevtoolsRuntime(config?: WorkbenchAppConfig, 
+/**
+ * Fired the instant the `WorkbenchAppInstance` exists — BEFORE `config.onSetup`
+ * is awaited below, which may run arbitrarily long host code (including
+ * loading the host-toolbar, which opens a live MessagePort). A caller that
+ * only learns `instance` from this function's return value would not see it
+ * until `onSetup` resolves, leaving a window where an app-quit teardown hook
+ * has nothing to dispose yet a live toolbar port already exists.
+ */
+onInstanceCreated?: (instance: WorkbenchAppInstance) => void): Promise<WorkbenchAppInstance>;
 //# sourceMappingURL=app.d.ts.map