dalila 1.8.3 → 1.9.0

package/README.md

@@ -94,6 +94,12 @@ bind(document.getElementById('app')!, ctx);
 - [Scheduler](./docs/core/scheduler.md) — Batching and coordination
 - [Keys](./docs/core/key.md) — Cache key encoding
 - [Dev Mode](./docs/core/dev.md) — Warnings and helpers
+- [Devtools Extension](./devtools-extension/README.md) — Browser panel for reactive graph and scopes
+
+Firefox extension workflows:
+
+- `npm run devtools:firefox:run` — launch Firefox with extension loaded for dev
+- `npm run devtools:firefox:build` — package extension artifact for submission/signing
 
 ## Features
 

package/dist/cli/routes-generator.js

@@ -969,8 +969,7 @@ function generateRouteObject(node, depth = 0) {
 export async function generateRoutesFile(routesDir, outputPath) {
     console.log('🔍 Scanning app directory:', routesDir);
     if (!await pathExists(routesDir)) {
-        console.error('❌ Routes directory not found:', routesDir);
-        process.exit(1);
+        throw new Error(`Routes directory not found: ${routesDir}`);
     }
     const tree = await buildRouteTree(routesDir, '', '');
     const projectRoot = await findProjectRoot(routesDir) ?? process.cwd();

package/dist/components/ui/dialog/index.d.ts

@@ -1,10 +1,2 @@
-import { type Signal } from "../../../core/signal.js";
 import type { Dialog, DialogOptions } from "../ui-types.js";
-/**
- * Shared dialog behavior — used by both createDialog and createDrawer.
- */
-export declare function _attachDialogBehavior(el: HTMLDialogElement, open: Signal<boolean>, closeFn: () => void, opts: {
-    closeOnBackdrop: boolean;
-    closeOnEscape: boolean;
-}): void;
 export declare function createDialog(options?: DialogOptions): Dialog;

package/dist/components/ui/dialog/index.js

@@ -1,45 +1,6 @@
 import { signal } from "../../../core/signal.js";
-import { getCurrentScope } from "../../../core/scope.js";
 import { validateDialogOptions } from "../validate.js";
-/**
- * Shared dialog behavior — used by both createDialog and createDrawer.
- */
-export function _attachDialogBehavior(el, open, closeFn, opts) {
-    const scope = getCurrentScope();
-    // Sync signal → native dialog
-    const unsub = open.on((isOpen) => {
-        if (isOpen && !el.open)
-            el.showModal();
-        else if (!isOpen && el.open)
-            el.close();
-    });
-    // Native close event → sync signal
-    const onClose = () => open.set(false);
-    el.addEventListener("close", onClose);
-    // Backdrop click
-    const onBackdropClick = (e) => {
-        if (opts.closeOnBackdrop && e.target === el)
-            closeFn();
-    };
-    el.addEventListener("click", onBackdropClick);
-    // Escape key
-    if (!opts.closeOnEscape) {
-        const onCancel = (e) => e.preventDefault();
-        el.addEventListener("cancel", onCancel);
-        if (scope) {
-            scope.onCleanup(() => el.removeEventListener("cancel", onCancel));
-        }
-    }
-    // ARIA
-    el.setAttribute("aria-modal", "true");
-    if (scope) {
-        scope.onCleanup(() => {
-            unsub();
-            el.removeEventListener("close", onClose);
-            el.removeEventListener("click", onBackdropClick);
-        });
-    }
-}
+import { attachDialogBehavior } from "./internal.js";
 export function createDialog(options = {}) {
     validateDialogOptions(options);
     const { closeOnBackdrop = true, closeOnEscape = true } = options;
@@ -48,7 +9,7 @@ export function createDialog(options = {}) {
     const close = () => open.set(false);
     const toggle = () => open.update((v) => !v);
     const _attachTo = (el) => {
-        _attachDialogBehavior(el, open, close, { closeOnBackdrop, closeOnEscape });
+        attachDialogBehavior(el, open, close, { closeOnBackdrop, closeOnEscape });
     };
     return { open, show, close, toggle, _attachTo };
 }

package/dist/components/ui/dialog/internal.d.ts

@@ -0,0 +1,5 @@
+import type { Signal } from "../../../core/signal.js";
+export declare function attachDialogBehavior(el: HTMLDialogElement, open: Signal<boolean>, closeFn: () => void, opts: {
+    closeOnBackdrop: boolean;
+    closeOnEscape: boolean;
+}): void;

package/dist/{componentes/ui/dialog/index.js → components/ui/dialog/internal.js}

@@ -1,28 +1,19 @@
-import { signal } from "../../../core/signal.js";
 import { getCurrentScope } from "../../../core/scope.js";
-import { validateDialogOptions } from "../validate.js";
-/**
- * Shared dialog behavior — used by both createDialog and createDrawer.
- */
-export function _attachDialogBehavior(el, open, closeFn, opts) {
+export function attachDialogBehavior(el, open, closeFn, opts) {
     const scope = getCurrentScope();
-    // Sync signal → native dialog
     const unsub = open.on((isOpen) => {
         if (isOpen && !el.open)
             el.showModal();
         else if (!isOpen && el.open)
             el.close();
     });
-    // Native close event → sync signal
     const onClose = () => open.set(false);
     el.addEventListener("close", onClose);
-    // Backdrop click
     const onBackdropClick = (e) => {
         if (opts.closeOnBackdrop && e.target === el)
             closeFn();
     };
     el.addEventListener("click", onBackdropClick);
-    // Escape key
     if (!opts.closeOnEscape) {
         const onCancel = (e) => e.preventDefault();
         el.addEventListener("cancel", onCancel);
@@ -30,7 +21,6 @@ export function _attachDialogBehavior(el, open, closeFn, opts) {
             scope.onCleanup(() => el.removeEventListener("cancel", onCancel));
         }
     }
-    // ARIA
     el.setAttribute("aria-modal", "true");
     if (scope) {
         scope.onCleanup(() => {
@@ -40,15 +30,3 @@ export function _attachDialogBehavior(el, open, closeFn, opts) {
         });
     }
 }
-export function createDialog(options = {}) {
-    validateDialogOptions(options);
-    const { closeOnBackdrop = true, closeOnEscape = true } = options;
-    const open = signal(false);
-    const show = () => open.set(true);
-    const close = () => open.set(false);
-    const toggle = () => open.update((v) => !v);
-    const _attachTo = (el) => {
-        _attachDialogBehavior(el, open, close, { closeOnBackdrop, closeOnEscape });
-    };
-    return { open, show, close, toggle, _attachTo };
-}

package/dist/components/ui/drawer/index.js

@@ -1,6 +1,6 @@
 import { signal } from "../../../core/signal.js";
 import { getCurrentScope } from "../../../core/scope.js";
-import { _attachDialogBehavior } from "../dialog/index.js";
+import { attachDialogBehavior } from "../dialog/internal.js";
 import { validateDrawerOptions } from "../validate.js";
 const SIDE_CLASSES = {
     right: "",
@@ -18,7 +18,7 @@ export function createDrawer(options = {}) {
     const _attachTo = (el) => {
         const scope = getCurrentScope();
         // Shared dialog behavior (open sync, backdrop, escape, ARIA)
-        _attachDialogBehavior(el, open, close, { closeOnBackdrop, closeOnEscape });
+        attachDialogBehavior(el, open, close, { closeOnBackdrop, closeOnEscape });
         // Apply initial side class
         const initial = SIDE_CLASSES[side()];
         if (initial)

package/dist/components/ui/index.d.ts

@@ -1,5 +1,5 @@
 export * from "./ui-types.js";
-export { createDialog, _attachDialogBehavior } from "./dialog/index.js";
+export { createDialog } from "./dialog/index.js";
 export { createDrawer } from "./drawer/index.js";
 export { createToast, toastIcon } from "./toast/index.js";
 export { createTabs, tabBindings } from "./tabs/index.js";

package/dist/components/ui/index.js

@@ -1,5 +1,5 @@
 export * from "./ui-types.js";
-export { createDialog, _attachDialogBehavior } from "./dialog/index.js";
+export { createDialog } from "./dialog/index.js";
 export { createDrawer } from "./drawer/index.js";
 export { createToast, toastIcon } from "./toast/index.js";
 export { createTabs, tabBindings } from "./tabs/index.js";

package/dist/core/dev.d.ts

@@ -1,7 +1,16 @@
+import { DevtoolsEvent, DevtoolsRuntimeOptions, DevtoolsSnapshot } from "./devtools.js";
 export declare function setDevMode(enabled: boolean): void;
 export declare function isInDevMode(): boolean;
+export interface InitDevToolsOptions extends DevtoolsRuntimeOptions {
+}
+export declare function setDevtoolsEnabled(enabled: boolean, options?: DevtoolsRuntimeOptions): void;
+export declare function isDevtoolsEnabled(): boolean;
+export declare function configureDevtools(options: DevtoolsRuntimeOptions): void;
+export declare function getDevtoolsSnapshot(): DevtoolsSnapshot;
+export declare function onDevtoolsEvent(listener: (event: DevtoolsEvent) => void): () => void;
+export declare function resetDevtools(): void;
 /**
- * Initialize dev tools. Currently just enables dev mode.
+ * Initialize dev tools runtime bridge for graph inspection.
  * Returns a promise for future async initialization support.
  */
-export declare function initDevTools(): Promise<void>;
+export declare function initDevTools(options?: InitDevToolsOptions): Promise<void>;

package/dist/core/dev.js

@@ -1,3 +1,4 @@
+import { configure, getSnapshot, isEnabled, reset, setEnabled, subscribe, } from "./devtools.js";
 let isDevMode = true;
 export function setDevMode(enabled) {
     isDevMode = enabled;
@@ -5,10 +6,33 @@ export function setDevMode(enabled) {
 export function isInDevMode() {
     return isDevMode;
 }
+export function setDevtoolsEnabled(enabled, options) {
+    setEnabled(enabled, options);
+}
+export function isDevtoolsEnabled() {
+    return isEnabled();
+}
+export function configureDevtools(options) {
+    configure(options);
+}
+export function getDevtoolsSnapshot() {
+    return getSnapshot();
+}
+export function onDevtoolsEvent(listener) {
+    return subscribe(listener);
+}
+export function resetDevtools() {
+    reset();
+}
 /**
- * Initialize dev tools. Currently just enables dev mode.
+ * Initialize dev tools runtime bridge for graph inspection.
  * Returns a promise for future async initialization support.
  */
-export async function initDevTools() {
+export async function initDevTools(options = {}) {
     setDevMode(true);
+    setEnabled(true, {
+        exposeGlobalHook: options.exposeGlobalHook ?? true,
+        dispatchEvents: options.dispatchEvents ?? true,
+        maxEvents: options.maxEvents,
+    });
 }

package/dist/core/devtools.d.ts

@@ -0,0 +1,65 @@
+export type DevtoolsNodeType = "scope" | "signal" | "computed" | "effect" | "effectAsync";
+export type DevtoolsEdgeKind = "dependency" | "ownership";
+export interface DevtoolsNode {
+    id: number;
+    type: DevtoolsNodeType;
+    label: string;
+    disposed: boolean;
+    scopeId: number | null;
+    parentScopeId: number | null;
+    reads: number;
+    writes: number;
+    runs: number;
+    lastValue: string;
+    lastRunAt: number;
+    createdAt: number;
+}
+export interface DevtoolsEdge {
+    from: number;
+    to: number;
+    kind: DevtoolsEdgeKind;
+}
+export interface DevtoolsEvent {
+    type: string;
+    at: number;
+    payload: Record<string, unknown>;
+}
+export interface DevtoolsSnapshot {
+    enabled: boolean;
+    nodes: DevtoolsNode[];
+    edges: DevtoolsEdge[];
+    events: DevtoolsEvent[];
+}
+export interface DevtoolsRuntimeOptions {
+    maxEvents?: number;
+    exposeGlobalHook?: boolean;
+    dispatchEvents?: boolean;
+}
+export interface DevtoolsHighlightOptions {
+    durationMs?: number;
+}
+export declare function configure(options?: DevtoolsRuntimeOptions): void;
+export declare function setEnabled(next: boolean, options?: DevtoolsRuntimeOptions): void;
+export declare function isEnabled(): boolean;
+export declare function reset(): void;
+export declare function subscribe(listener: (event: DevtoolsEvent) => void): () => void;
+export declare function getSnapshot(): DevtoolsSnapshot;
+export declare function registerScope(scopeRef: object, parentScopeRef: object | null): void;
+export declare function withDevtoolsDomTarget<T>(element: Element | null, fn: () => T): T;
+export declare function linkScopeToDom(scopeRef: object, element: Element, label?: string): void;
+export declare function disposeScope(scopeRef: object): void;
+export declare function registerSignal(signalRef: object, type: "signal" | "computed", options?: {
+    scopeRef?: object | null;
+    initialValue?: unknown;
+}): void;
+export declare function registerEffect(effectRef: object, type: "effect" | "effectAsync", scopeRef: object | null): void;
+export declare function aliasEffectToNode(effectRef: object, targetRef: object): void;
+export declare function linkSubscriberSetToSignal(subscriberSetRef: object, signalRef: object): void;
+export declare function trackSignalRead(signalRef: object): void;
+export declare function trackSignalWrite(signalRef: object, nextValue: unknown): void;
+export declare function trackEffectRun(effectRef: object): void;
+export declare function trackEffectDispose(effectRef: object): void;
+export declare function trackDependency(signalRef: object, effectRef: object): void;
+export declare function untrackDependencyBySet(subscriberSetRef: object, effectRef: object): void;
+export declare function clearHighlights(): void;
+export declare function highlightNode(nodeId: number, options?: DevtoolsHighlightOptions): boolean;