@dimina-kit/devtools 0.3.0 → 0.3.1-dev.20260515105504

package/dist/main/services/mcp/server.d.ts

@@ -6,5 +6,6 @@
  * Tool registration lives in `./tool-registry` and `./tools/*`; this file
  * only wires up transports and lifecycle.
  */
-export declare function startMcpServer(resolvedCdpPort: number, mcpPort: number): void;
+import { type Disposable } from '../../utils/disposable.js';
+export declare function startMcpServer(resolvedCdpPort: number, mcpPort: number): Disposable;
 //# sourceMappingURL=server.d.ts.map

package/dist/main/services/mcp/server.js

@@ -10,6 +10,7 @@ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';
 import { createServer } from 'http';
 import { createRequire } from 'node:module';
+import { toDisposable } from '../../utils/disposable.js';
 import { connectTarget, setCdpPort } from './target-manager.js';
 import { registerCommonTargetTools } from './tool-registry.js';
 import { registerContextTools } from './tools/context-tools.js';
@@ -72,5 +73,9 @@ export function startMcpServer(resolvedCdpPort, mcpPort) {
     httpServer.listen(mcpPort, '127.0.0.1', () => {
         console.log(`[MCP] SSE server listening on http://127.0.0.1:${mcpPort}/sse`);
     });
+    return toDisposable(() => {
+        transports.clear();
+        httpServer.close();
+    });
 }
 //# sourceMappingURL=server.js.map

package/dist/main/services/module.d.ts

@@ -0,0 +1,18 @@
+import type { Disposable } from '../utils/disposable.js';
+import type { WorkbenchContext } from './workbench-context.js';
+/**
+ * A composable unit of workbench functionality.
+ *
+ * Built-in modules (projects, session, simulator, popover, settings) are
+ * implemented as `WorkbenchModule` values; hosts may also inject extra
+ * modules via `WorkbenchAppConfig.extraModules`.
+ *
+ * `setup` is invoked once during workbench bootstrap. The returned
+ * Disposable is added to `ctx.registry` so module teardown is symmetric
+ * with the rest of the workbench lifecycle.
+ */
+export interface WorkbenchModule {
+    /** Set up the module against ctx. Returns a Disposable owned by ctx.registry. */
+    setup(ctx: WorkbenchContext): Disposable;
+}
+//# sourceMappingURL=module.d.ts.map

package/dist/main/services/module.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=module.js.map

package/dist/main/services/notifications/renderer-notifier.d.ts

@@ -8,6 +8,8 @@ import type { ProjectSettings } from '../projects/project-repository.js';
 export interface ProjectStatusPayload {
     status: string;
     message: string;
+    /** True when the status update is emitted by the file-watcher rebuild loop. */
+    hotReload?: boolean;
 }
 /**
  * Payload for the `settings:init` event sent into the embedded settings overlay

package/dist/main/services/projects/project-repository.d.ts

@@ -15,6 +15,7 @@ export interface ProjectSettings {
 export type { CompileConfig } from '../../../shared/types.js';
 export declare function listProjects(): Project[];
 export declare function validateProjectDir(dirPath: string): string | null;
+export declare function hasProject(dirPath: string): boolean;
 export declare function addProject(dirPath: string): Project;
 export declare function removeProject(dirPath: string): void;
 export declare function updateLastOpened(dirPath: string): void;

package/dist/main/services/projects/project-repository.js

@@ -46,6 +46,9 @@ export function validateProjectDir(dirPath) {
     }
     return null;
 }
+export function hasProject(dirPath) {
+    return load().some((p) => p.path === dirPath);
+}
 export function addProject(dirPath) {
     const projects = load();
     let name = path.basename(dirPath);

package/dist/main/services/settings/index.d.ts

@@ -8,6 +8,10 @@ export interface WorkbenchSettings {
         enabled: boolean;
         port: number;
     };
+    compile: {
+        /** Watch project files and auto-recompile on change. */
+        watch: boolean;
+    };
     theme: ThemeSource;
 }
 export declare function loadWorkbenchSettings(): WorkbenchSettings;

package/dist/main/services/settings/index.js

@@ -10,6 +10,9 @@ const DEFAULTS = {
         enabled: false,
         port: 7789,
     },
+    compile: {
+        watch: true,
+    },
     theme: 'system',
 };
 function getSettingsFile() {
@@ -30,11 +33,19 @@ export function loadWorkbenchSettings() {
                 enabled: data.mcp?.enabled ?? DEFAULTS.mcp.enabled,
                 port: data.mcp?.port ?? DEFAULTS.mcp.port,
             },
+            compile: {
+                watch: data.compile?.watch ?? DEFAULTS.compile.watch,
+            },
             theme,
         };
     }
     catch {
-        return { ...DEFAULTS, cdp: { ...DEFAULTS.cdp }, mcp: { ...DEFAULTS.mcp } };
+        return {
+            ...DEFAULTS,
+            cdp: { ...DEFAULTS.cdp },
+            mcp: { ...DEFAULTS.mcp },
+            compile: { ...DEFAULTS.compile },
+        };
     }
 }
 export function saveWorkbenchSettings(settings) {

package/dist/main/services/simulator/custom-apis.d.ts

@@ -0,0 +1,10 @@
+export type SimulatorApiHandler = (params: unknown) => unknown | Promise<unknown>;
+export interface SimulatorApiRegistry {
+    register(name: string, handler: SimulatorApiHandler): () => void;
+    list(): string[];
+    invoke(name: string, params: unknown): Promise<unknown>;
+    clear(): void;
+}
+export declare function createSimulatorApiRegistry(): SimulatorApiRegistry;
+export declare const simulatorApiRegistry: SimulatorApiRegistry;
+//# sourceMappingURL=custom-apis.d.ts.map

package/dist/main/services/simulator/custom-apis.js

@@ -0,0 +1,26 @@
+export function createSimulatorApiRegistry() {
+    const handlers = new Map();
+    return {
+        register(name, handler) {
+            handlers.set(name, handler);
+            return () => {
+                if (handlers.get(name) === handler)
+                    handlers.delete(name);
+            };
+        },
+        list() {
+            return Array.from(handlers.keys());
+        },
+        async invoke(name, params) {
+            const handler = handlers.get(name);
+            if (!handler)
+                throw new Error(`Simulator API "${name}" is not registered`);
+            return await handler(params);
+        },
+        clear() {
+            handlers.clear();
+        },
+    };
+}
+export const simulatorApiRegistry = createSimulatorApiRegistry();
+//# sourceMappingURL=custom-apis.js.map

package/dist/main/services/simulator/dir.d.ts

@@ -1,2 +1,2 @@
-export declare const simulatorDir: string;
+export { simulatorDir } from '../../utils/paths.js';
 //# sourceMappingURL=dir.d.ts.map

package/dist/main/services/simulator/dir.js

@@ -1,5 +1,2 @@
-import path from 'path';
-import { fileURLToPath } from 'url';
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-export const simulatorDir = path.join(__dirname, '../../../simulator');
+export { simulatorDir } from '../../utils/paths.js';
 //# sourceMappingURL=dir.js.map

package/dist/main/services/simulator-storage/index.d.ts

@@ -16,5 +16,26 @@
  *     events stop flowing until they close it.
  */
 import { type WebContents } from 'electron';
-export declare function setupSimulatorStorage(host: WebContents): void;
+import { type Disposable } from '../../utils/disposable.js';
+import { type SenderPolicy } from '../../utils/ipc-registry.js';
+export interface SimulatorStorageOptions {
+    /**
+     * Sender gate applied to `SimulatorStorageChannel.GetSnapshot`.
+     * When provided, the IpcRegistry rejects invocations whose `event.sender`
+     * is not whitelisted (typically the workbench-wide policy that allows
+     * the main window renderer and overlay views only).
+     * Omitted in unit tests that mock the electron module.
+     */
+    senderPolicy?: SenderPolicy;
+    /**
+     * Returns the appId of the currently-active project session, or null when
+     * no session is active. The simulator uses a fixed `persist:simulator`
+     * partition + simulator.html origin, so localStorage is shared across
+     * every project that has ever opened. The dimina runtime isolates writes
+     * with `${appId}_` prefixes; this callback lets the panel filter the
+     * CDP snapshot/event stream to the active appId.
+     */
+    getActiveAppId: () => string | null;
+}
+export declare function setupSimulatorStorage(host: WebContents, options: SimulatorStorageOptions): Disposable;
 //# sourceMappingURL=index.d.ts.map