@madojs/mado 0.12.0 → 0.13.1

package/dist/src/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,MAAM,EAAe,MAAM,aAAa,CAAC;AAElD,MAAM,aAAa,GAAG,cAAc,CAAC;AAQrC,MAAM,UAAU,aAAa,CAAI,YAAe;IAC9C,OAAO;QACL,IAAI,EAAE,IAAI;QACV,GAAG,EAAE,MAAM,CAAC,SAAS,CAAC;QACtB,YAAY;KACb,CAAC;AACJ,CAAC;AAOD;;;GAGG;AACH,MAAM,UAAU,OAAO,CACrB,IAAiB,EACjB,GAAe,EACf,OAAsB;IAEtB,MAAM,GAAG,GACP,OAAO,OAAO,KAAK,UAAU;QAC3B,CAAC,CAAE,OAAqB;QACxB,CAAC,CAAC,MAAM,CAAC,OAAY,CAAC,CAAC;IAE3B,MAAM,OAAO,GAAG,CAAC,CAAQ,EAAE,EAAE;QAC3B,MAAM,EAAE,GAAG,CAAoC,CAAC;QAChD,IAAI,EAAE,CAAC,MAAM,CAAC,GAAG,KAAK,GAAG,CAAC,GAAG;YAAE,OAAO;QACtC,EAAE,CAAC,MAAM,CAAC,KAAK,GAAG,GAAsB,CAAC;QACzC,CAAC,CAAC,eAAe,EAAE,CAAC;IACtB,CAAC,CAAC;IACF,IAAI,CAAC,gBAAgB,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IAE9C,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,MAAM,CAAI,IAAiB,EAAE,GAAe;IAC1D,MAAM,MAAM,GAAuB,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC;IACpD,IAAI,CAAC,aAAa,CAChB,IAAI,WAAW,CAAC,aAAa,EAAE;QAC7B,MAAM;QACN,OAAO,EAAE,IAAI;QACb,QAAQ,EAAE,IAAI;QACd,UAAU,EAAE,IAAI;KACjB,CAAC,CACH,CAAC;IACF,IAAI,MAAM,CAAC,KAAK;QAAE,OAAO,MAAM,CAAC,KAAkB,CAAC;IACnD,OAAO,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;AAClC,CAAC"}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/context.ts"],"names":[],"mappings":"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","sourcesContent":["/** Context DI implemented through the Web Components Context Protocol. */\n\nimport { effect, signal, type Disposer, type Signal } from \"./signal.js\";\nimport { getCurrentLifecycle } from \"./lifecycle.js\";\nimport { warnOnce } from \"./diagnostics.js\";\n\nconst CONTEXT_EVENT = \"context-request\";\n\nexport interface Context<T> {\n  readonly _ctx: true;\n  readonly key: symbol;\n  readonly defaultValue: T;\n}\n\nexport interface ContextRequestEventDetail<T = unknown> {\n  context: unknown;\n  callback(value: T, unsubscribe?: Disposer): void;\n  subscribe?: boolean;\n}\n\nexport function createContext<T>(defaultValue: T): Context<T> {\n  return {\n    _ctx: true,\n    key: Symbol(\"mado-context\"),\n    defaultValue,\n  };\n}\n\n/**\n * Provide a context value from a host. The returned signal updates protocol\n * subscribers. Listener/effect cleanup follows the current Mado lifecycle.\n */\nexport function provide<T>(\n  host: HTMLElement,\n  context: Context<T>,\n  initial: T | Signal<T>,\n): Signal<T> {\n  const source = isSignal<T>(initial) ? initial : signal(initial as T);\n  const subscribers = new Set<(value: T, unsubscribe?: Disposer) => void>();\n  let disposed = false;\n\n  const handler = (event: Event): void => {\n    const request = event as CustomEvent<ContextRequestEventDetail<T>>;\n    if (request.detail?.context !== context.key) return;\n    event.stopPropagation();\n\n    if (!request.detail.subscribe) {\n      request.detail.callback(source.peek());\n      return;\n    }\n\n    const callback = request.detail.callback;\n    let active = true;\n    const unsubscribe = (): void => {\n      if (!active) return;\n      active = false;\n      subscribers.delete(callback);\n    };\n    subscribers.add(callback);\n    callback(source.peek(), unsubscribe);\n  };\n\n  host.addEventListener(CONTEXT_EVENT, handler);\n  const stopPublish = effect(() => {\n    const value = source();\n    for (const callback of [...subscribers]) callback(value);\n  });\n\n  const dispose = (): void => {\n    if (disposed) return;\n    disposed = true;\n    host.removeEventListener(CONTEXT_EVENT, handler);\n    subscribers.clear();\n    stopPublish();\n  };\n  const lifecycle = getCurrentLifecycle();\n  if (lifecycle) lifecycle.onDispose(dispose);\n  else {\n    warnOnce(\n      \"context-provider-outside-lifecycle\",\n      \"provide() called outside a component/page lifecycle; its event listener cannot be cleaned up automatically.\",\n    );\n  }\n\n  return source;\n}\n\n/** Request the nearest provider and expose its current value as a Signal. */\nexport function inject<T>(host: HTMLElement, context: Context<T>): Signal<T> {\n  const value = signal(context.defaultValue);\n  let unsubscribe: Disposer | undefined;\n  const detail: ContextRequestEventDetail<T> = {\n    context: context.key,\n    subscribe: true,\n    callback(next, dispose) {\n      value.set(next);\n      if (dispose) unsubscribe = dispose;\n    },\n  };\n\n  host.dispatchEvent(\n    new CustomEvent<ContextRequestEventDetail<T>>(CONTEXT_EVENT, {\n      detail,\n      bubbles: true,\n      composed: true,\n    }),\n  );\n\n  getCurrentLifecycle()?.onDispose(() => {\n    unsubscribe?.();\n    unsubscribe = undefined;\n  });\n  return value;\n}\n\nfunction isSignal<T>(value: T | Signal<T>): value is Signal<T> {\n  return typeof value === \"function\" &&\n    typeof (value as Partial<Signal<T>>).set === \"function\" &&\n    typeof (value as Partial<Signal<T>>).peek === \"function\";\n}\n"]}

package/dist/src/css.d.ts

@@ -52,3 +52,4 @@ export declare function adopt(root: ShadowRoot, ...sheets: CSSResult[]): void;
  *     → 'x-button button { color: red }'
  */
 export declare function scopeStyles(tagName: string, sheet: CSSResult): CSSResult;
+//# sourceMappingURL=css.d.ts.map

package/dist/src/css.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"css.d.ts","sourceRoot":"","sources":["../../src/css.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,MAAM,SAAS,GAAG,aAAa,CAAC;AAItC;;;;;;;GAOG;AACH,wBAAgB,GAAG,CACjB,OAAO,EAAE,oBAAoB,EAC7B,GAAG,MAAM,EAAE,OAAO,EAAE,GACnB,SAAS,CAwBX;AAoBD;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,MAAM,CASrE;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,CAMpE;AAgBD;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,SAAS,CA4BxE"}

package/dist/src/css.js.map

@@ -1 +1 @@
-{"version":3,"file":"css.js","sourceRoot":"","sources":["../../src/css.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"css.js","sourceRoot":"","sources":["../../src/css.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Styles without CSS-in-JS, but ergonomic.\n *\n * Idea:\n *   1. `css\\`...\\`` — tagged literal, returns a CSSStyleSheet (Constructable Stylesheet).\n *   2. Sheet is shared across all component instances (one copy in memory).\n *   3. Component applies the sheet via `shadowRoot.adoptedStyleSheets`.\n *   4. No runtime CSS parsers, no className hashes —\n *      the browser does all the work.\n *\n * Theming:\n *   - change CSS variables on :host or :root — no re-renders needed.\n *   - `cssVars({ '--accent': color })` → ready string for style=\"...\".\n *\n * Optional scope without Shadow DOM:\n *   - if the browser has @scope (Chrome 118+, Safari 17.4+), we wrap styles.\n *   - fallback: prefix selectors with the tag — a simple regex at string level.\n */\n\nexport type CSSResult = CSSStyleSheet;\n\nconst stylesheetText = new WeakMap<CSSStyleSheet, string>();\n\n/**\n * Tagged literal for CSS. Returns a CSSStyleSheet ready for\n * adoptedStyleSheets. Value interpolation — only primitives or\n * other CSSResult (for composition).\n *\n * Injection guard: strings with `<` or `>` are forbidden so that\n * script tags cannot accidentally be injected through styles.\n */\nexport function css(\n  strings: TemplateStringsArray,\n  ...values: unknown[]\n): CSSResult {\n  let text = \"\";\n  for (let i = 0; i < strings.length; i++) {\n    text += strings[i];\n    if (i < strings.length - 1) {\n      const v = values[i];\n      if (v == null) continue;\n      if (v instanceof CSSStyleSheet) {\n        // composition — insert all rules\n        text += getStylesheetText(v) ?? rulesText(v);\n        continue;\n      }\n      const s = String(v);\n      if (/[<>]/.test(s)) {\n        throw new Error(\"css``: `<` and `>` are forbidden in interpolations\");\n      }\n      text += s;\n    }\n  }\n\n  const sheet = new CSSStyleSheet();\n  sheet.replaceSync(text);\n  stylesheetText.set(sheet, text);\n  return sheet;\n}\n\n/** @internal */\nexport function createStylesheet(text: string): CSSResult {\n  const sheet = new CSSStyleSheet();\n  sheet.replaceSync(text);\n  stylesheetText.set(sheet, text);\n  return sheet;\n}\n\n/** @internal */\nexport function getStylesheetText(sheet: CSSStyleSheet): string | undefined {\n  return stylesheetText.get(sheet);\n}\n\n/** @internal */\nexport function getStylesheetHash(sheet: CSSStyleSheet): string {\n  return stableHash(getStylesheetText(sheet) ?? rulesText(sheet));\n}\n\n/**\n * Build an inline-style string from a CSS variables object.\n *\n *   cssVars({ '--accent': '#f00', '--pad': '1rem' })\n *     → '--accent: #f00; --pad: 1rem;'\n *\n * Usage:\n *   html`<div style=${cssVars({ '--accent': color })}>...</div>`\n *   html`<x-app style=${cssVars(theme())}>...</x-app>`   // signal — auto-update\n */\nexport function cssVars(vars: Record<string, string | number>): string {\n  let out = \"\";\n  for (const k in vars) {\n    const v = vars[k];\n    if (v == null) continue;\n    const name = k.startsWith(\"--\") ? k : `--${k}`;\n    out += `${name}:${v};`;\n  }\n  return out;\n}\n\n/**\n * Apply sheets to a ShadowRoot. Idempotent: the same sheet\n * can be adopted into dozens of components without duplicating styles.\n */\nexport function adopt(root: ShadowRoot, ...sheets: CSSResult[]): void {\n  // append rather than overwrite — user may have already adopted something\n  const existing = root.adoptedStyleSheets;\n  const toAdd = sheets.filter((s) => !existing.includes(s));\n  if (toAdd.length === 0) return;\n  root.adoptedStyleSheets = [...existing, ...toAdd];\n}\n\n// ---------- Scope for light DOM (without Shadow DOM) ----------\n\n\nconst hasScope = (() => {\n  try {\n    return CSS.supports(\"selector(:scope)\") &&\n      // @scope at-rule support check\n      typeof (CSSRule as unknown as { SCOPE_RULE?: number }).SCOPE_RULE !==\n        \"undefined\";\n  } catch {\n    return false;\n  }\n})();\n\n/**\n * Build scoped style text limited to a selector (for light DOM).\n * Uses native @scope if the browser supports it.\n * Otherwise — naive selector prefixing.\n *\n *   scopeStyles('x-button', 'button { color: red }')\n *     → '@scope (x-button) { button { color: red } }'  // or\n *     → 'x-button button { color: red }'\n */\nexport function scopeStyles(tagName: string, sheet: CSSResult): CSSResult {\n  const text = getStylesheetText(sheet) ?? rulesText(sheet);\n\n  let scoped: string;\n  if (hasScope) {\n    scoped = `@scope (${tagName}) { ${text} }`;\n  } else {\n    // naive: prefix every top-level selector with `tagName `.\n    // Works for simple cases \"button {...}\", \"p, span {...}\".\n    // Does not touch @-rules.\n    scoped = text.replace(/(^|\\})\\s*([^{}@][^{}]*)\\{/g, (_m, brace, sel) => {\n      const prefixed = sel\n        .split(\",\")\n        .map((s: string) => {\n          const trimmed = s.trim();\n          if (!trimmed) return trimmed;\n          if (trimmed.startsWith(tagName)) return trimmed;\n          return `${tagName} ${trimmed}`;\n        })\n        .join(\", \");\n      return `${brace} ${prefixed} {`;\n    });\n  }\n\n  const out = new CSSStyleSheet();\n  out.replaceSync(scoped);\n  stylesheetText.set(out, scoped);\n  return out;\n}\n\nfunction rulesText(sheet: CSSStyleSheet): string {\n  let text = \"\";\n  for (const rule of sheet.cssRules) text += rule.cssText;\n  return text;\n}\n\nfunction stableHash(text: string): string {\n  let hash = 0x811c9dc5;\n  for (let i = 0; i < text.length; i++) {\n    hash ^= text.charCodeAt(i);\n    hash = Math.imul(hash, 0x01000193);\n  }\n  return (hash >>> 0).toString(36);\n}\n"]}

package/dist/src/devtools-hook.d.ts

@@ -0,0 +1,14 @@
+export declare const DEVTOOLS_HOOK_KEY: unique symbol;
+export interface MadoDevtoolsEvent {
+    time: number;
+    kind: string;
+    target?: object;
+    data?: unknown;
+}
+export interface MadoDevtoolsHook {
+    readonly version: 1;
+    emit(event: MadoDevtoolsEvent): void;
+}
+export declare function emitDevtools(kind: string, target?: object, data?: unknown): void;
+export declare function installDevtoolsHook(hook: MadoDevtoolsHook): () => void;
+//# sourceMappingURL=devtools-hook.d.ts.map

package/dist/src/devtools-hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devtools-hook.d.ts","sourceRoot":"","sources":["../../src/devtools-hook.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,eAAsC,CAAC;AAErE,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,IAAI,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAAC;CACtC;AAGD,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,OAAO,GACb,IAAI,CAWN;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,IAAI,CAStE"}

package/dist/src/devtools-hook.js

@@ -0,0 +1,27 @@
+export const DEVTOOLS_HOOK_KEY = Symbol.for("@madojs/mado:devtools");
+/* @__NO_SIDE_EFFECTS__ */
+export function emitDevtools(kind, target, data) {
+    const hook = globalThis[DEVTOOLS_HOOK_KEY];
+    if (hook?.version !== 1)
+        return;
+    hook.emit({
+        time: typeof performance !== "undefined" ? performance.now() : Date.now(),
+        kind,
+        ...(target ? { target } : {}),
+        ...(data === undefined ? {} : { data }),
+    });
+}
+export function installDevtoolsHook(hook) {
+    const root = globalThis;
+    const previous = root[DEVTOOLS_HOOK_KEY];
+    root[DEVTOOLS_HOOK_KEY] = hook;
+    return () => {
+        if (root[DEVTOOLS_HOOK_KEY] !== hook)
+            return;
+        if (previous === undefined)
+            delete root[DEVTOOLS_HOOK_KEY];
+        else
+            root[DEVTOOLS_HOOK_KEY] = previous;
+    };
+}
+//# sourceMappingURL=devtools-hook.js.map

package/dist/src/devtools-hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"devtools-hook.js","sourceRoot":"","sources":["../../src/devtools-hook.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;AAcrE,0BAA0B;AAC1B,MAAM,UAAU,YAAY,CAC1B,IAAY,EACZ,MAAe,EACf,IAAc;IAEd,MAAM,IAAI,GAAI,UAA2C,CAAC,iBAAiB,CAE9D,CAAC;IACd,IAAI,IAAI,EAAE,OAAO,KAAK,CAAC;QAAE,OAAO;IAChC,IAAI,CAAC,IAAI,CAAC;QACR,IAAI,EAAE,OAAO,WAAW,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;QACzE,IAAI;QACJ,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7B,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;KACxC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAsB;IACxD,MAAM,IAAI,GAAG,UAA0C,CAAC;IACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACzC,IAAI,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAAC;IAC/B,OAAO,GAAG,EAAE;QACV,IAAI,IAAI,CAAC,iBAAiB,CAAC,KAAK,IAAI;YAAE,OAAO;QAC7C,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC,iBAAiB,CAAC,CAAC;;YACtD,IAAI,CAAC,iBAAiB,CAAC,GAAG,QAAQ,CAAC;IAC1C,CAAC,CAAC;AACJ,CAAC","sourcesContent":["export const DEVTOOLS_HOOK_KEY = Symbol.for(\"@madojs/mado:devtools\");\n\nexport interface MadoDevtoolsEvent {\n  time: number;\n  kind: string;\n  target?: object;\n  data?: unknown;\n}\n\nexport interface MadoDevtoolsHook {\n  readonly version: 1;\n  emit(event: MadoDevtoolsEvent): void;\n}\n\n/* @__NO_SIDE_EFFECTS__ */\nexport function emitDevtools(\n  kind: string,\n  target?: object,\n  data?: unknown,\n): void {\n  const hook = (globalThis as Record<PropertyKey, unknown>)[DEVTOOLS_HOOK_KEY] as\n    | MadoDevtoolsHook\n    | undefined;\n  if (hook?.version !== 1) return;\n  hook.emit({\n    time: typeof performance !== \"undefined\" ? performance.now() : Date.now(),\n    kind,\n    ...(target ? { target } : {}),\n    ...(data === undefined ? {} : { data }),\n  });\n}\n\nexport function installDevtoolsHook(hook: MadoDevtoolsHook): () => void {\n  const root = globalThis as Record<PropertyKey, unknown>;\n  const previous = root[DEVTOOLS_HOOK_KEY];\n  root[DEVTOOLS_HOOK_KEY] = hook;\n  return () => {\n    if (root[DEVTOOLS_HOOK_KEY] !== hook) return;\n    if (previous === undefined) delete root[DEVTOOLS_HOOK_KEY];\n    else root[DEVTOOLS_HOOK_KEY] = previous;\n  };\n}\n"]}

package/dist/src/devtools.d.ts

@@ -1,22 +1,24 @@
-/**
- * Dev logger for signals and effects.
- *
- * Enabled by a flag in localStorage:
- *   localStorage.madoDebug = '1'
- *
- * What it does:
- *   - wraps signal/effect/computed for logging
- *   - shows [signal] name: old → new
- *   - groups effects via console.group / console.groupEnd
- *
- * Setup:
- *   import '@madojs/mado/devtools.js';  // at the very top of app.ts
- *
- * In production — just don't import this file, and all dev code will be
- * tree-shaken (or simply absent from the module graph).
- *
- * Implementation: imports the already-initialised signal module and
- * patches the factory. A simple proof-of-concept approach; for production-
- * grade DevTools a full hook is needed, but that's a different story.
- */
-export {};
+/** Dev-only instrumentation overlay. Import this subpath before app startup. */
+export type DevtoolsLogLevel = "debug" | "info" | "warn" | "error" | "silent";
+export interface DevtoolsRecord {
+    id: number;
+    time: number;
+    kind: string;
+    targetId?: number;
+    data?: unknown;
+}
+export interface DevtoolsSnapshot {
+    version: 1;
+    paused: boolean;
+    records: DevtoolsRecord[];
+}
+export interface DevtoolsController {
+    open(): void;
+    close(): void;
+    toggle(): void;
+    clear(): void;
+    setLogLevel(level: DevtoolsLogLevel): void;
+    snapshot(): DevtoolsSnapshot;
+}
+export declare const devtools: DevtoolsController;
+//# sourceMappingURL=devtools.d.ts.map

package/dist/src/devtools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devtools.d.ts","sourceRoot":"","sources":["../../src/devtools.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAShF,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE9E,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,CAAC,CAAC;IACX,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,cAAc,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,IAAI,IAAI,CAAC;IACb,KAAK,IAAI,IAAI,CAAC;IACd,MAAM,IAAI,IAAI,CAAC;IACf,KAAK,IAAI,IAAI,CAAC;IACd,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC3C,QAAQ,IAAI,gBAAgB,CAAC;CAC9B;AAuBD,eAAO,MAAM,QAAQ,EAAE,kBAkCtB,CAAC"}

package/dist/src/devtools.js

@@ -1,63 +1,235 @@
-/**
- * Dev logger for signals and effects.
- *
- * Enabled by a flag in localStorage:
- *   localStorage.madoDebug = '1'
- *
- * What it does:
- *   - wraps signal/effect/computed for logging
- *   - shows [signal] name: old → new
- *   - groups effects via console.group / console.groupEnd
- *
- * Setup:
- *   import '@madojs/mado/devtools.js';  // at the very top of app.ts
- *
- * In production — just don't import this file, and all dev code will be
- * tree-shaken (or simply absent from the module graph).
- *
- * Implementation: imports the already-initialised signal module and
- * patches the factory. A simple proof-of-concept approach; for production-
- * grade DevTools a full hook is needed, but that's a different story.
- */
-import * as signalModule from "./signal.js";
-const ENABLED = typeof localStorage !== "undefined" &&
-    localStorage.getItem("madoDebug") === "1";
-if (ENABLED) {
-    // eslint-disable-next-line no-console
-    console.info("%c[mado] devtools enabled", "color: #888");
-    const origSignal = signalModule.signal;
-    let counter = 0;
-    // @ts-expect-error patching module live
-    signalModule.signal = function patchedSignal(initial) {
-        const name = `s${++counter}`;
-        const sig = origSignal(initial);
-        const origSet = sig.set;
-        sig.set = (next) => {
-            const prev = sig.peek();
-            if (!Object.is(prev, next)) {
-                // eslint-disable-next-line no-console
-                console.log(`%c[signal ${name}]`, "color: #888", prev, "→", next);
-            }
-            origSet(next);
+/** Dev-only instrumentation overlay. Import this subpath before app startup. */
+import { installDevtoolsHook, } from "./devtools-hook.js";
+import { reportDiagnostic } from "./diagnostics.js";
+const MAX_RECORDS = 1_000;
+const records = [];
+const targetIds = new WeakMap();
+let nextRecordId = 0;
+let nextTargetId = 0;
+let paused = false;
+let overlay = null;
+let renderQueued = false;
+const hook = {
+    version: 1,
+    emit(event) {
+        if (paused)
+            return;
+        records.push(toRecord(event));
+        if (records.length > MAX_RECORDS)
+            records.splice(0, records.length - MAX_RECORDS);
+        queueOverlayRender();
+    },
+};
+installDevtoolsHook(hook);
+export const devtools = {
+    open() {
+        if (typeof document === "undefined")
+            return;
+        overlay ??= createOverlay();
+        if (!overlay.isConnected)
+            document.documentElement.appendChild(overlay);
+        overlay.hidden = false;
+        renderOverlay();
+    },
+    close() {
+        if (overlay)
+            overlay.hidden = true;
+    },
+    toggle() {
+        if (!overlay || overlay.hidden || !overlay.isConnected)
+            this.open();
+        else
+            this.close();
+    },
+    clear() {
+        records.length = 0;
+        renderOverlay();
+    },
+    setLogLevel(level) {
+        if (!isLogLevel(level))
+            throw new TypeError(`Unknown Mado log level: ${level}`);
+        try {
+            localStorage.setItem("mado:log-level", level);
+        }
+        catch {
+            /* storage may be disabled */
+        }
+    },
+    snapshot() {
+        return {
+            version: 1,
+            paused,
+            records: records.map((record) => ({ ...record })),
         };
-        return sig;
+    },
+};
+if (typeof window !== "undefined") {
+    window.addEventListener("keydown", (event) => {
+        if (event.altKey && event.shiftKey && event.key.toLowerCase() === "m") {
+            event.preventDefault();
+            devtools.toggle();
+        }
+    });
+    try {
+        if (localStorage.getItem("madoDebug") === "1") {
+            reportDiagnostic("warn", "devtools", "legacy-debug-flag", "localStorage.madoDebug is deprecated; use Alt+Shift+M or devtools.open().");
+            devtools.setLogLevel("debug");
+            queueMicrotask(() => devtools.open());
+        }
+    }
+    catch {
+        /* storage may be disabled */
+    }
+}
+function toRecord(event) {
+    let targetId;
+    if (event.target) {
+        targetId = targetIds.get(event.target);
+        if (!targetId) {
+            targetId = ++nextTargetId;
+            targetIds.set(event.target, targetId);
+        }
+    }
+    return {
+        id: ++nextRecordId,
+        time: event.time,
+        kind: event.kind,
+        ...(targetId ? { targetId } : {}),
+        ...(event.data === undefined ? {} : { data: safePreview(event.data) }),
     };
-    const origEffect = signalModule.effect;
-    // @ts-expect-error patching module live
-    signalModule.effect = function patchedEffect(fn) {
-        let id = 0;
-        return origEffect(() => {
-            const tag = `[effect #${++id}]`;
-            // eslint-disable-next-line no-console
-            console.groupCollapsed(tag);
-            try {
-                return fn();
-            }
-            finally {
-                // eslint-disable-next-line no-console
-                console.groupEnd();
-            }
+}
+function createOverlay() {
+    const host = document.createElement("aside");
+    host.id = "mado-devtools";
+    host.setAttribute("aria-label", "Mado developer tools");
+    const root = host.attachShadow({ mode: "open" });
+    root.innerHTML = `
+    <style>${OVERLAY_CSS}</style>
+    <header><strong>Mado Devtools</strong><span data-summary></span><button data-close title="Close">×</button></header>
+    <nav>
+      <button data-tab="overview">Overview</button>
+      <button data-tab="reactivity">Reactivity</button>
+      <button data-tab="components">Components</button>
+      <button data-tab="router-data">Router/Data</button>
+      <button data-tab="timeline">Timeline/Errors</button>
+    </nav>
+    <section class="tools">
+      <input data-filter aria-label="Filter events" placeholder="Filter events">
+      <button data-pause>Pause</button><button data-clear>Clear</button><button data-copy>Copy snapshot</button>
+    </section>
+    <main data-content></main>`;
+    host.dataset.tab = "overview";
+    root.querySelector("[data-close]")?.addEventListener("click", () => devtools.close());
+    root.querySelector("[data-clear]")?.addEventListener("click", () => devtools.clear());
+    root.querySelector("[data-pause]")?.addEventListener("click", () => {
+        paused = !paused;
+        renderOverlay();
+    });
+    root.querySelector("[data-copy]")?.addEventListener("click", () => {
+        void navigator.clipboard?.writeText(JSON.stringify(devtools.snapshot(), null, 2));
+    });
+    root.querySelector("[data-filter]")?.addEventListener("input", () => renderOverlay());
+    for (const button of root.querySelectorAll("[data-tab]")) {
+        button.addEventListener("click", () => {
+            host.dataset.tab = button.dataset.tab ?? "overview";
+            renderOverlay();
         });
-    };
+    }
+    return host;
+}
+function queueOverlayRender() {
+    if (!overlay?.isConnected || overlay.hidden || renderQueued)
+        return;
+    renderQueued = true;
+    queueMicrotask(() => {
+        renderQueued = false;
+        renderOverlay();
+    });
+}
+function renderOverlay() {
+    const root = overlay?.shadowRoot;
+    if (!root)
+        return;
+    const tab = overlay?.dataset.tab ?? "overview";
+    const filter = (root.querySelector("[data-filter]")?.value ?? "").toLowerCase();
+    const visible = records.filter((record) => {
+        if (!matchesTab(record.kind, tab))
+            return false;
+        return !filter || `${record.kind} ${JSON.stringify(record.data ?? "")}`.toLowerCase().includes(filter);
+    });
+    const summary = root.querySelector("[data-summary]");
+    if (summary)
+        summary.textContent = `${records.length} events · ${paused ? "paused" : "live"}`;
+    const pause = root.querySelector("[data-pause]");
+    if (pause)
+        pause.textContent = paused ? "Resume" : "Pause";
+    const content = root.querySelector("[data-content]");
+    if (!content)
+        return;
+    if (tab === "overview") {
+        const counts = countGroups(records);
+        content.innerHTML = `<div class="cards">${Object.entries(counts)
+            .map(([name, count]) => `<article><b>${escapeHtml(name)}</b><span>${count}</span></article>`)
+            .join("")}</div>`;
+        return;
+    }
+    content.innerHTML = visible.slice(-250).reverse().map((record) => `
+    <article class="event ${record.kind.includes("error") ? "error" : ""}">
+      <time>${record.time.toFixed(1)}</time><b>${escapeHtml(record.kind)}</b>
+      ${record.targetId ? `<i>#${record.targetId}</i>` : ""}
+      <code>${escapeHtml(JSON.stringify(record.data ?? ""))}</code>
+    </article>`).join("") || `<p class="empty">No matching events</p>`;
+}
+function matchesTab(kind, tab) {
+    if (tab === "overview")
+        return true;
+    if (tab === "reactivity")
+        return /^(signal|computed|effect):/.test(kind);
+    if (tab === "components")
+        return kind.startsWith("component:");
+    if (tab === "router-data")
+        return /^(router|resource|mutation):/.test(kind);
+    return kind.startsWith("diagnostic:") || kind.includes("error");
+}
+function countGroups(input) {
+    const counts = {};
+    for (const record of input) {
+        const group = record.kind.split(":", 1)[0] ?? "other";
+        counts[group] = (counts[group] ?? 0) + 1;
+    }
+    return counts;
+}
+function safePreview(value, depth = 0) {
+    if (value == null || typeof value === "string" || typeof value === "number" ||
+        typeof value === "boolean")
+        return value;
+    if (typeof value === "bigint")
+        return `${value}n`;
+    if (typeof value === "function")
+        return `[Function ${value.name || "anonymous"}]`;
+    if (value instanceof Error)
+        return { name: value.name, message: value.message, stack: value.stack };
+    if (depth >= 2)
+        return `[${Object.prototype.toString.call(value).slice(8, -1)}]`;
+    if (Array.isArray(value))
+        return value.slice(0, 20).map((item) => safePreview(item, depth + 1));
+    const result = {};
+    for (const [key, descriptor] of Object.entries(Object.getOwnPropertyDescriptors(value))) {
+        if (Object.keys(result).length >= 20)
+            break;
+        result[key] = "value" in descriptor ? safePreview(descriptor.value, depth + 1) : "[Getter]";
+    }
+    return result;
+}
+function escapeHtml(value) {
+    return value.replace(/[&<>"']/g, (char) => ({
+        "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&#39;",
+    })[char]);
+}
+function isLogLevel(value) {
+    return ["debug", "info", "warn", "error", "silent"].includes(value);
 }
+const OVERLAY_CSS = `
+  :host{all:initial;position:fixed;right:12px;bottom:12px;width:min(720px,calc(100vw - 24px));height:min(520px,calc(100vh - 24px));z-index:2147483647;color:#e7e9ee;background:#11141a;border:1px solid #384152;border-radius:12px;box-shadow:0 18px 70px #0009;font:12px/1.45 ui-monospace,SFMono-Regular,Consolas,monospace;display:grid;grid-template-rows:auto auto auto 1fr;overflow:hidden}
+  :host([hidden]){display:none}header{display:flex;gap:12px;align-items:center;padding:10px 12px;background:#1a1f29}header strong{font:600 14px system-ui}header span{color:#929bad;flex:1}button,input{font:inherit;color:inherit;background:#222936;border:1px solid #3a4558;border-radius:6px;padding:5px 8px}button{cursor:pointer}button:hover{background:#30394a}nav,.tools{display:flex;gap:6px;padding:7px 10px;border-top:1px solid #2a3240}.tools input{flex:1}main{overflow:auto;padding:10px}.cards{display:grid;grid-template-columns:repeat(auto-fit,minmax(120px,1fr));gap:8px}.cards article{display:flex;justify-content:space-between;padding:12px;background:#1b212b;border-radius:8px}.cards span{font-size:18px;color:#77d6a5}.event{display:grid;grid-template-columns:64px 150px 40px 1fr;gap:8px;padding:6px;border-bottom:1px solid #262e3a}.event time,.event i{color:#7f8a9d}.event code{white-space:pre-wrap;overflow-wrap:anywhere;color:#bac3d2}.event.error{background:#4b1f263d;color:#ff9aa8}.empty{color:#8993a4;text-align:center;margin-top:40px}`;
 //# sourceMappingURL=devtools.js.map

package/dist/src/devtools.js.map

@@ -1 +1 @@
-{"version":3,"file":"devtools.js","sourceRoot":"","sources":["../../src/devtools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,YAAY,MAAM,aAAa,CAAC;AAE5C,MAAM,OAAO,GACX,OAAO,YAAY,KAAK,WAAW;IACnC,YAAY,CAAC,OAAO,CAAC,WAAW,CAAC,KAAK,GAAG,CAAC;AAE5C,IAAI,OAAO,EAAE,CAAC;IACZ,sCAAsC;IACtC,OAAO,CAAC,IAAI,CAAC,2BAA2B,EAAE,aAAa,CAAC,CAAC;IAEzD,MAAM,UAAU,GAAG,YAAY,CAAC,MAAM,CAAC;IACvC,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,wCAAwC;IACxC,YAAY,CAAC,MAAM,GAAG,SAAS,aAAa,CAAI,OAAU;QACxD,MAAM,IAAI,GAAG,IAAI,EAAE,OAAO,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;QAChC,MAAM,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC;QACxB,GAAG,CAAC,GAAG,GAAG,CAAC,IAAO,EAAE,EAAE;YACpB,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;YACxB,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;gBAC3B,sCAAsC;gBACtC,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,GAAG,EAAE,aAAa,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;YACpE,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC,CAAC;QACF,OAAO,GAAG,CAAC;IACb,CAAC,CAAC;IAEF,MAAM,UAAU,GAAG,YAAY,CAAC,MAAM,CAAC;IACvC,wCAAwC;IACxC,YAAY,CAAC,MAAM,GAAG,SAAS,aAAa,CAAC,EAAiB;QAC5D,IAAI,EAAE,GAAG,CAAC,CAAC;QACX,OAAO,UAAU,CAAC,GAAG,EAAE;YACrB,MAAM,GAAG,GAAG,YAAY,EAAE,EAAE,GAAG,CAAC;YAChC,sCAAsC;YACtC,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;YAC5B,IAAI,CAAC;gBACH,OAAO,EAAE,EAAU,CAAC;YACtB,CAAC;oBAAS,CAAC;gBACT,sCAAsC;gBACtC,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrB,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"devtools.js","sourceRoot":"","sources":["../../src/devtools.ts"],"names":[],"mappings":"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","sourcesContent":["/** Dev-only instrumentation overlay. Import this subpath before app startup. */\n\nimport {\n  installDevtoolsHook,\n  type MadoDevtoolsEvent,\n  type MadoDevtoolsHook,\n} from \"./devtools-hook.js\";\nimport { reportDiagnostic } from \"./diagnostics.js\";\n\nexport type DevtoolsLogLevel = \"debug\" | \"info\" | \"warn\" | \"error\" | \"silent\";\n\nexport interface DevtoolsRecord {\n  id: number;\n  time: number;\n  kind: string;\n  targetId?: number;\n  data?: unknown;\n}\n\nexport interface DevtoolsSnapshot {\n  version: 1;\n  paused: boolean;\n  records: DevtoolsRecord[];\n}\n\nexport interface DevtoolsController {\n  open(): void;\n  close(): void;\n  toggle(): void;\n  clear(): void;\n  setLogLevel(level: DevtoolsLogLevel): void;\n  snapshot(): DevtoolsSnapshot;\n}\n\nconst MAX_RECORDS = 1_000;\nconst records: DevtoolsRecord[] = [];\nconst targetIds = new WeakMap<object, number>();\nlet nextRecordId = 0;\nlet nextTargetId = 0;\nlet paused = false;\nlet overlay: HTMLElement | null = null;\nlet renderQueued = false;\n\nconst hook: MadoDevtoolsHook = {\n  version: 1,\n  emit(event) {\n    if (paused) return;\n    records.push(toRecord(event));\n    if (records.length > MAX_RECORDS) records.splice(0, records.length - MAX_RECORDS);\n    queueOverlayRender();\n  },\n};\n\ninstallDevtoolsHook(hook);\n\nexport const devtools: DevtoolsController = {\n  open() {\n    if (typeof document === \"undefined\") return;\n    overlay ??= createOverlay();\n    if (!overlay.isConnected) document.documentElement.appendChild(overlay);\n    overlay.hidden = false;\n    renderOverlay();\n  },\n  close() {\n    if (overlay) overlay.hidden = true;\n  },\n  toggle() {\n    if (!overlay || overlay.hidden || !overlay.isConnected) this.open();\n    else this.close();\n  },\n  clear() {\n    records.length = 0;\n    renderOverlay();\n  },\n  setLogLevel(level) {\n    if (!isLogLevel(level)) throw new TypeError(`Unknown Mado log level: ${level}`);\n    try {\n      localStorage.setItem(\"mado:log-level\", level);\n    } catch {\n      /* storage may be disabled */\n    }\n  },\n  snapshot() {\n    return {\n      version: 1,\n      paused,\n      records: records.map((record) => ({ ...record })),\n    };\n  },\n};\n\nif (typeof window !== \"undefined\") {\n  window.addEventListener(\"keydown\", (event) => {\n    if (event.altKey && event.shiftKey && event.key.toLowerCase() === \"m\") {\n      event.preventDefault();\n      devtools.toggle();\n    }\n  });\n  try {\n    if (localStorage.getItem(\"madoDebug\") === \"1\") {\n      reportDiagnostic(\n        \"warn\",\n        \"devtools\",\n        \"legacy-debug-flag\",\n        \"localStorage.madoDebug is deprecated; use Alt+Shift+M or devtools.open().\",\n      );\n      devtools.setLogLevel(\"debug\");\n      queueMicrotask(() => devtools.open());\n    }\n  } catch {\n    /* storage may be disabled */\n  }\n}\n\nfunction toRecord(event: MadoDevtoolsEvent): DevtoolsRecord {\n  let targetId: number | undefined;\n  if (event.target) {\n    targetId = targetIds.get(event.target);\n    if (!targetId) {\n      targetId = ++nextTargetId;\n      targetIds.set(event.target, targetId);\n    }\n  }\n  return {\n    id: ++nextRecordId,\n    time: event.time,\n    kind: event.kind,\n    ...(targetId ? { targetId } : {}),\n    ...(event.data === undefined ? {} : { data: safePreview(event.data) }),\n  };\n}\n\nfunction createOverlay(): HTMLElement {\n  const host = document.createElement(\"aside\");\n  host.id = \"mado-devtools\";\n  host.setAttribute(\"aria-label\", \"Mado developer tools\");\n  const root = host.attachShadow({ mode: \"open\" });\n  root.innerHTML = `\n    <style>${OVERLAY_CSS}</style>\n    <header><strong>Mado Devtools</strong><span data-summary></span><button data-close title=\"Close\">×</button></header>\n    <nav>\n      <button data-tab=\"overview\">Overview</button>\n      <button data-tab=\"reactivity\">Reactivity</button>\n      <button data-tab=\"components\">Components</button>\n      <button data-tab=\"router-data\">Router/Data</button>\n      <button data-tab=\"timeline\">Timeline/Errors</button>\n    </nav>\n    <section class=\"tools\">\n      <input data-filter aria-label=\"Filter events\" placeholder=\"Filter events\">\n      <button data-pause>Pause</button><button data-clear>Clear</button><button data-copy>Copy snapshot</button>\n    </section>\n    <main data-content></main>`;\n  host.dataset.tab = \"overview\";\n  root.querySelector(\"[data-close]\")?.addEventListener(\"click\", () => devtools.close());\n  root.querySelector(\"[data-clear]\")?.addEventListener(\"click\", () => devtools.clear());\n  root.querySelector(\"[data-pause]\")?.addEventListener(\"click\", () => {\n    paused = !paused;\n    renderOverlay();\n  });\n  root.querySelector(\"[data-copy]\")?.addEventListener(\"click\", () => {\n    void navigator.clipboard?.writeText(JSON.stringify(devtools.snapshot(), null, 2));\n  });\n  root.querySelector(\"[data-filter]\")?.addEventListener(\"input\", () => renderOverlay());\n  for (const button of root.querySelectorAll<HTMLElement>(\"[data-tab]\")) {\n    button.addEventListener(\"click\", () => {\n      host.dataset.tab = button.dataset.tab ?? \"overview\";\n      renderOverlay();\n    });\n  }\n  return host;\n}\n\nfunction queueOverlayRender(): void {\n  if (!overlay?.isConnected || overlay.hidden || renderQueued) return;\n  renderQueued = true;\n  queueMicrotask(() => {\n    renderQueued = false;\n    renderOverlay();\n  });\n}\n\nfunction renderOverlay(): void {\n  const root = overlay?.shadowRoot;\n  if (!root) return;\n  const tab = overlay?.dataset.tab ?? \"overview\";\n  const filter = (root.querySelector<HTMLInputElement>(\"[data-filter]\")?.value ?? \"\").toLowerCase();\n  const visible = records.filter((record) => {\n    if (!matchesTab(record.kind, tab)) return false;\n    return !filter || `${record.kind} ${JSON.stringify(record.data ?? \"\")}`.toLowerCase().includes(filter);\n  });\n  const summary = root.querySelector(\"[data-summary]\");\n  if (summary) summary.textContent = `${records.length} events · ${paused ? \"paused\" : \"live\"}`;\n  const pause = root.querySelector(\"[data-pause]\");\n  if (pause) pause.textContent = paused ? \"Resume\" : \"Pause\";\n  const content = root.querySelector(\"[data-content]\");\n  if (!content) return;\n  if (tab === \"overview\") {\n    const counts = countGroups(records);\n    content.innerHTML = `<div class=\"cards\">${Object.entries(counts)\n      .map(([name, count]) => `<article><b>${escapeHtml(name)}</b><span>${count}</span></article>`)\n      .join(\"\")}</div>`;\n    return;\n  }\n  content.innerHTML = visible.slice(-250).reverse().map((record) => `\n    <article class=\"event ${record.kind.includes(\"error\") ? \"error\" : \"\"}\">\n      <time>${record.time.toFixed(1)}</time><b>${escapeHtml(record.kind)}</b>\n      ${record.targetId ? `<i>#${record.targetId}</i>` : \"\"}\n      <code>${escapeHtml(JSON.stringify(record.data ?? \"\"))}</code>\n    </article>`).join(\"\") || `<p class=\"empty\">No matching events</p>`;\n}\n\nfunction matchesTab(kind: string, tab: string): boolean {\n  if (tab === \"overview\") return true;\n  if (tab === \"reactivity\") return /^(signal|computed|effect):/.test(kind);\n  if (tab === \"components\") return kind.startsWith(\"component:\");\n  if (tab === \"router-data\") return /^(router|resource|mutation):/.test(kind);\n  return kind.startsWith(\"diagnostic:\") || kind.includes(\"error\");\n}\n\nfunction countGroups(input: DevtoolsRecord[]): Record<string, number> {\n  const counts: Record<string, number> = {};\n  for (const record of input) {\n    const group = record.kind.split(\":\", 1)[0] ?? \"other\";\n    counts[group] = (counts[group] ?? 0) + 1;\n  }\n  return counts;\n}\n\nfunction safePreview(value: unknown, depth = 0): unknown {\n  if (value == null || typeof value === \"string\" || typeof value === \"number\" ||\n    typeof value === \"boolean\") return value;\n  if (typeof value === \"bigint\") return `${value}n`;\n  if (typeof value === \"function\") return `[Function ${value.name || \"anonymous\"}]`;\n  if (value instanceof Error) return { name: value.name, message: value.message, stack: value.stack };\n  if (depth >= 2) return `[${Object.prototype.toString.call(value).slice(8, -1)}]`;\n  if (Array.isArray(value)) return value.slice(0, 20).map((item) => safePreview(item, depth + 1));\n  const result: Record<string, unknown> = {};\n  for (const [key, descriptor] of Object.entries(Object.getOwnPropertyDescriptors(value))) {\n    if (Object.keys(result).length >= 20) break;\n    result[key] = \"value\" in descriptor ? safePreview(descriptor.value, depth + 1) : \"[Getter]\";\n  }\n  return result;\n}\n\nfunction escapeHtml(value: string): string {\n  return value.replace(/[&<>\"']/g, (char) => ({\n    \"&\": \"&amp;\", \"<\": \"&lt;\", \">\": \"&gt;\", '\"': \"&quot;\", \"'\": \"&#39;\",\n  })[char]!);\n}\n\nfunction isLogLevel(value: string): value is DevtoolsLogLevel {\n  return [\"debug\", \"info\", \"warn\", \"error\", \"silent\"].includes(value);\n}\n\nconst OVERLAY_CSS = `\n  :host{all:initial;position:fixed;right:12px;bottom:12px;width:min(720px,calc(100vw - 24px));height:min(520px,calc(100vh - 24px));z-index:2147483647;color:#e7e9ee;background:#11141a;border:1px solid #384152;border-radius:12px;box-shadow:0 18px 70px #0009;font:12px/1.45 ui-monospace,SFMono-Regular,Consolas,monospace;display:grid;grid-template-rows:auto auto auto 1fr;overflow:hidden}\n  :host([hidden]){display:none}header{display:flex;gap:12px;align-items:center;padding:10px 12px;background:#1a1f29}header strong{font:600 14px system-ui}header span{color:#929bad;flex:1}button,input{font:inherit;color:inherit;background:#222936;border:1px solid #3a4558;border-radius:6px;padding:5px 8px}button{cursor:pointer}button:hover{background:#30394a}nav,.tools{display:flex;gap:6px;padding:7px 10px;border-top:1px solid #2a3240}.tools input{flex:1}main{overflow:auto;padding:10px}.cards{display:grid;grid-template-columns:repeat(auto-fit,minmax(120px,1fr));gap:8px}.cards article{display:flex;justify-content:space-between;padding:12px;background:#1b212b;border-radius:8px}.cards span{font-size:18px;color:#77d6a5}.event{display:grid;grid-template-columns:64px 150px 40px 1fr;gap:8px;padding:6px;border-bottom:1px solid #262e3a}.event time,.event i{color:#7f8a9d}.event code{white-space:pre-wrap;overflow-wrap:anywhere;color:#bac3d2}.event.error{background:#4b1f263d;color:#ff9aa8}.empty{color:#8993a4;text-align:center;margin-top:40px}`;\n"]}

package/dist/src/diagnostics.d.ts

@@ -4,4 +4,16 @@
  * Warnings are intentionally best-effort: they never throw and they are printed
  * once per code so noisy app renders do not flood the console.
  */
+export type DiagnosticLevel = "debug" | "info" | "warn" | "error";
+export interface DiagnosticRecord {
+    timestamp: number;
+    level: DiagnosticLevel;
+    scope: string;
+    code: string;
+    message: string;
+    data?: unknown;
+}
+export declare function reportDiagnostic(level: DiagnosticLevel, scope: string, code: string, message: string, data?: unknown): void;
+export declare function reportError(scope: string, code: string, message: string, error: unknown): void;
 export declare function warnOnce(code: string, message: string): void;
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/src/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/diagnostics.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAElE,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,eAAe,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAWD,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,eAAe,EACtB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,OAAO,GACb,IAAI,CAiCN;AAED,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,OAAO,GACb,IAAI,CAEN;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAQ5D"}

package/dist/src/diagnostics.js

@@ -1,17 +1,58 @@
-/**
- * Internal dev diagnostics.
- *
- * Warnings are intentionally best-effort: they never throw and they are printed
- * once per code so noisy app renders do not flood the console.
- */
+import { emitDevtools } from "./devtools-hook.js";
 const seen = new Set();
+const LEVELS = {
+    debug: 10,
+    info: 20,
+    warn: 30,
+    error: 40,
+    silent: 50,
+};
+export function reportDiagnostic(level, scope, code, message, data) {
+    if (LEVELS[level] < LEVELS[configuredLevel()])
+        return;
+    const record = {
+        timestamp: Date.now(),
+        level,
+        scope,
+        code,
+        message,
+        ...(data === undefined ? {} : { data }),
+    };
+    try {
+        const method = level === "debug" ? "debug" : level;
+        const colour = level === "error"
+            ? "color:#d33;font-weight:600"
+            : level === "warn"
+                ? "color:#b26a00;font-weight:600"
+                : level === "info"
+                    ? "color:#087ea4"
+                    : "color:#777";
+        const args = [
+            `%c[mado:${scope}:${code}]%c ${message}`,
+            colour,
+            "color:inherit;font-weight:normal",
+        ];
+        if (data !== undefined)
+            args.push(data);
+        console[method](...args);
+    }
+    catch {
+        /* diagnostics must never affect application behaviour */
+    }
+    if (typeof __MADO_DEVTOOLS__ === "undefined" || __MADO_DEVTOOLS__) {
+        emitDevtools(`diagnostic:${level}`, undefined, record);
+    }
+    dispatchDiagnostic(record);
+}
+export function reportError(scope, code, message, error) {
+    reportDiagnostic("error", scope, code, message, error);
+}
 export function warnOnce(code, message) {
     if (seen.has(code))
         return;
     seen.add(code);
     try {
-        // eslint-disable-next-line no-console
-        console.warn(`[mado:${code}] ${message}`);
+        reportDiagnostic("warn", "runtime", code, message);
     }
     catch {
         /* noop */
@@ -26,4 +67,23 @@ export const _testHooks = {
         return [...seen];
     },
 };
+function configuredLevel() {
+    try {
+        const value = localStorage.getItem("mado:log-level") ?? "warn";
+        if (Object.hasOwn(LEVELS, value))
+            return value;
+    }
+    catch {
+        /* localStorage is unavailable in Node, workers and locked-down pages */
+    }
+    return "warn";
+}
+function dispatchDiagnostic(record) {
+    try {
+        globalThis.dispatchEvent?.(new CustomEvent("mado:diagnostic", { detail: record }));
+    }
+    catch {
+        /* EventTarget/CustomEvent may not exist in non-browser runtimes. */
+    }
+}
 //# sourceMappingURL=diagnostics.js.map