@madojs/mado 0.11.1 → 0.13.0

package/dist/src/component.js

@@ -12,14 +12,88 @@
  * The returned render function is called via an effect, so any signals
  * read inside it automatically re-render the template.
  *
- * Shadow DOM (open) is used by default. It can be disabled, and
- * styles will be scoped via @scope (or a tag-prefix fallback).
+ * Shadow DOM (open, serializable) is used by default. It can be disabled for
+ * advanced integration cases, and styles will be scoped via @scope
+ * (or a tag-prefix fallback).
  */
 import { signal, effect } from "./signal.js";
-import { html, render } from "./html/template.js";
-import { adopt, scopeStyles } from "./css.js";
+import { html, render, unmount } from "./html/template.js";
+import { adopt, createStylesheet, scopeStyles, } from "./css.js";
 import { createLifecycle, runInLifecycle, } from "./lifecycle.js";
 import { warnOnce } from "./diagnostics.js";
+import { emitDevtools } from "./devtools-hook.js";
+/**
+ * Components upgraded inside a server-side or build-time snapshot live
+ * temporarily under `<#app data-mado-static>`. Their setup() is intentionally
+ * NOT run yet: Mado replaces the snapshot tree atomically when the SPA
+ * boots, and any work performed by setup() before takeover would leak.
+ *
+ * The set lets the runtime double-check, after takeover, that no deferred
+ * element survives — see _flushDeferredStaticElements().
+ */
+const deferredStaticElements = new Set();
+/**
+ * Walk composed ancestry (Light DOM parentNode plus ShadowRoot.host) and
+ * return true when the element lives inside a tree marked with
+ * `data-mado-static`. Used to defer component activation until the SPA
+ * takeover atomically removes that tree.
+ */
+function isInsideStaticTree(node) {
+    let n = node;
+    while (n) {
+        if (n instanceof Element &&
+            n.hasAttribute &&
+            n.hasAttribute("data-mado-static")) {
+            return true;
+        }
+        const parent = typeof ShadowRoot !== "undefined" && n instanceof ShadowRoot
+            ? n.host
+            : n.parentNode;
+        n = parent;
+    }
+    return false;
+}
+/** @internal */
+export function _markDeferredForStatic(host) {
+    deferredStaticElements.add(host);
+}
+/** @internal */
+export function _isDeferredForStatic(host) {
+    return deferredStaticElements.has(host);
+}
+/**
+ * Called by render() after a root takeover has atomically replaced the
+ * `data-mado-static` tree. By that time every component that was
+ * mid-snapshot must either be:
+ *   1. removed with the static tree (the typical case), or
+ *   2. still connected but no longer under a static ancestor — in which
+ *      case the SPA tree placed it live and we activate it now.
+ * Any element that fails both checks is a stuck snapshot leaf; emit a
+ * single diagnostic so the developer notices the orphan.
+ *
+ * @internal
+ */
+export function _flushDeferredStaticElements() {
+    for (const el of [...deferredStaticElements]) {
+        if (!el.isConnected) {
+            deferredStaticElements.delete(el);
+            continue;
+        }
+        if (!isInsideStaticTree(el)) {
+            // Reset the guard so the live connectedCallback runs setup().
+            deferredStaticElements.delete(el);
+            // Force a clean re-enter of connectedCallback. Browsers fire that
+            // callback exactly once per insertion, so we toggle the element out
+            // and back in. Avoid this if the element is the document root.
+            const parent = el.parentNode;
+            const next = el.nextSibling;
+            if (parent) {
+                parent.removeChild(el);
+                parent.insertBefore(el, next);
+            }
+        }
+    }
+}
 export function component(tagName, setup, options = {}) {
     if (!tagName.includes("-")) {
         warnOnce(`component-invalid-tag-${tagName}`, `component("${tagName}") skipped: Custom Element names must contain a hyphen.`);
@@ -52,7 +126,13 @@ export function component(tagName, setup, options = {}) {
         #attrDefaults = new Map();
         constructor() {
             super();
-            this.#root = useShadow ? this.attachShadow({ mode: "open" }) : this;
+            this.#root = useShadow
+                ? this.shadowRoot ??
+                    this.attachShadow({
+                        mode: "open",
+                        serializable: true,
+                    })
+                : this;
         }
         connectedCallback() {
             // A keyed move (each() relocating via insertBefore) fires
@@ -62,7 +142,18 @@ export function component(tagName, setup, options = {}) {
             this.#teardownQueued = false;
             if (this.#connected)
                 return;
-            this.#connected = true;
+            // Deferred activation inside a static snapshot tree. The runtime keeps
+            // setup()/effect() asleep until the SPA performs root takeover; the
+            // existing DSD inside shadowRoot stays as inert first-paint markup.
+            // When the SPA replaces the static root, this element is either
+            // removed with that tree (the common case) or re-inserted live —
+            // in which case connectedCallback() runs again and reaches setup().
+            if (isInsideStaticTree(this)) {
+                _markDeferredForStatic(this);
+                return;
+            }
+            if (typeof __MADO_DEVTOOLS__ === "undefined" || __MADO_DEVTOOLS__)
+                emitDevtools("component:connect", this, { tagName });
             if (stylesheets.length > 0) {
                 if (useShadow) {
                     adopt(this.#root, ...stylesheets);
@@ -75,45 +166,76 @@ export function component(tagName, setup, options = {}) {
             // called from setup() (resource, ...) will see it via
             // getCurrentLifecycle() and register its own cleanup.
             const lifecycle = createLifecycle();
-            this.#lifecycle = lifecycle;
             const host = this;
+            const attr = ((name, defaultValue) => {
+                let s = host.#attrSignals.get(name);
+                if (!s) {
+                    const fallback = defaultValue ?? null;
+                    host.#attrDefaults.set(name, fallback);
+                    s = signal(host.getAttribute(name) ?? fallback);
+                    host.#attrSignals.set(name, s);
+                }
+                return s;
+            });
             const ctx = {
                 host: this,
                 // ctx.onDispose proxies to lifecycle — the single source of truth
                 // for component cleanups (including auto-cleanup from
                 // resource(), navigator listeners, etc.).
                 onDispose: (fn) => lifecycle.onDispose(fn),
-                attr(name, defaultValue = "") {
-                    let s = host.#attrSignals.get(name);
-                    if (!s) {
-                        host.#attrDefaults.set(name, defaultValue);
-                        s = signal(host.getAttribute(name) ?? defaultValue);
-                        host.#attrSignals.set(name, s);
-                    }
-                    return s;
-                },
+                attr,
             };
-            this.#renderer = runInLifecycle(lifecycle, () => setup(ctx));
-            // After setup(), install a single MutationObserver for all attrs
-            // registered via ctx.attr().
-            if (this.#attrSignals.size > 0) {
-                const attrNames = [...this.#attrSignals.keys()];
-                const obs = new MutationObserver((mutations) => {
-                    for (const m of mutations) {
-                        const s = this.#attrSignals.get(m.attributeName);
-                        const fallback = this.#attrDefaults.get(m.attributeName) ?? "";
-                        if (s)
-                            s.set(this.getAttribute(m.attributeName) ?? fallback);
-                    }
-                });
-                obs.observe(this, { attributes: true, attributeFilter: attrNames });
-                lifecycle.onDispose(() => obs.disconnect());
+            try {
+                const renderer = runInLifecycle(lifecycle, () => setup(ctx));
+                if (typeof renderer !== "function") {
+                    throw new TypeError(`component("${tagName}") setup must return a renderer function`);
+                }
+                // After setup(), install a single MutationObserver for all attrs
+                // registered via ctx.attr().
+                if (this.#attrSignals.size > 0) {
+                    const attrNames = [...this.#attrSignals.keys()];
+                    const obs = new MutationObserver((mutations) => {
+                        for (const m of mutations) {
+                            const s = this.#attrSignals.get(m.attributeName);
+                            const fallback = this.#attrDefaults.get(m.attributeName) ?? null;
+                            if (s)
+                                s.set(this.getAttribute(m.attributeName) ?? fallback);
+                        }
+                    });
+                    obs.observe(this, { attributes: true, attributeFilter: attrNames });
+                    lifecycle.onDispose(() => obs.disconnect());
+                }
+                const effectDispose = runInLifecycle(lifecycle, () => effect(() => {
+                    if (typeof __MADO_DEVTOOLS__ === "undefined" || __MADO_DEVTOOLS__)
+                        emitDevtools("component:render", this, { tagName });
+                    render(renderer(), this.#root);
+                }));
+                this.#renderer = renderer;
+                this.#effectDispose = effectDispose;
+                this.#lifecycle = lifecycle;
+                this.#connected = true;
+                if (typeof __MADO_DEVTOOLS__ === "undefined" || __MADO_DEVTOOLS__)
+                    emitDevtools("component:ready", this, { tagName });
+            }
+            catch (err) {
+                unmount(this.#root);
+                lifecycle.dispose();
+                this.#renderer = null;
+                this.#effectDispose = null;
+                this.#lifecycle = null;
+                this.#attrSignals.clear();
+                this.#attrDefaults.clear();
+                this.#connected = false;
+                if (typeof __MADO_DEVTOOLS__ === "undefined" || __MADO_DEVTOOLS__)
+                    emitDevtools("component:error", this, { tagName, error: err });
+                throw err;
             }
-            this.#effectDispose = effect(() => {
-                render(this.#renderer(), this.#root);
-            });
         }
         disconnectedCallback() {
+            // A deferred snapshot leaf was removed by takeover before setup() ever
+            // ran. Clear the deferred marker so the registry does not accumulate
+            // dead references.
+            deferredStaticElements.delete(this);
             // Defer teardown to a microtask. A keyed move (each() relocating a node
             // via insertBefore) fires disconnectedCallback → connectedCallback in the
             // same tick; connectedCallback clears #teardownQueued so the teardown is
@@ -133,10 +255,16 @@ export function component(tagName, setup, options = {}) {
         }
         /** Synchronously dispose effects and lifecycle. */
         #teardown() {
+            if (typeof __MADO_DEVTOOLS__ === "undefined" || __MADO_DEVTOOLS__)
+                emitDevtools("component:dispose", this, { tagName });
             this.#effectDispose?.();
             this.#effectDispose = null;
+            unmount(this.#root);
             this.#lifecycle?.dispose();
             this.#lifecycle = null;
+            this.#renderer = null;
+            this.#attrSignals.clear();
+            this.#attrDefaults.clear();
             this.#connected = false;
         }
     }
@@ -151,8 +279,7 @@ function normalizeStyles(input, tagName, useShadow) {
     return arr.map((s) => {
         let sheet;
         if (typeof s === "string") {
-            sheet = new CSSStyleSheet();
-            sheet.replaceSync(s);
+            sheet = createStylesheet(s);
         }
         else {
             sheet = s;

package/dist/src/component.js.map

@@ -1 +1 @@
-{"version":3,"file":"component.js","sourceRoot":"","sources":["../../src/component.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"component.js","sourceRoot":"","sources":["../../src/component.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Wrapper around Custom Elements.\n *\n *   component('x-counter', () => {\n *     const count = signal(0);\n *     return () => html`<button @click=${() => count.update(n=>n+1)}>${count}</button>`;\n *   }, {\n *     styles: css`button { padding: .5rem }`,\n *   });\n *\n * The setup function is called once on the first connectedCallback.\n * The returned render function is called via an effect, so any signals\n * read inside it automatically re-render the template.\n *\n * Shadow DOM (open, serializable) is used by default. It can be disabled for\n * advanced integration cases, and styles will be scoped via @scope\n * (or a tag-prefix fallback).\n */\n\nimport { signal, effect, type Signal, type Disposer } from \"./signal.js\";\nimport { html, render, unmount } from \"./html/template.js\";\nimport type { TemplateResult } from \"./html/template-types.js\";\nimport {\n  adopt,\n  createStylesheet,\n  scopeStyles,\n  type CSSResult,\n} from \"./css.js\";\nimport {\n  createLifecycle,\n  runInLifecycle,\n  type LifecycleHandle,\n} from \"./lifecycle.js\";\nimport { warnOnce } from \"./diagnostics.js\";\nimport { emitDevtools } from \"./devtools-hook.js\";\n\n/**\n * Components upgraded inside a server-side or build-time snapshot live\n * temporarily under `<#app data-mado-static>`. Their setup() is intentionally\n * NOT run yet: Mado replaces the snapshot tree atomically when the SPA\n * boots, and any work performed by setup() before takeover would leak.\n *\n * The set lets the runtime double-check, after takeover, that no deferred\n * element survives — see _flushDeferredStaticElements().\n */\nconst deferredStaticElements = new Set<HTMLElement>();\n\n/**\n * Walk composed ancestry (Light DOM parentNode plus ShadowRoot.host) and\n * return true when the element lives inside a tree marked with\n * `data-mado-static`. Used to defer component activation until the SPA\n * takeover atomically removes that tree.\n */\nfunction isInsideStaticTree(node: Node | null): boolean {\n  let n: Node | null = node;\n  while (n) {\n    if (\n      n instanceof Element &&\n      (n as Element).hasAttribute &&\n      (n as Element).hasAttribute(\"data-mado-static\")\n    ) {\n      return true;\n    }\n    const parent: Node | null =\n      typeof ShadowRoot !== \"undefined\" && n instanceof ShadowRoot\n        ? n.host\n        : n.parentNode;\n    n = parent;\n  }\n  return false;\n}\n\n/** @internal */\nexport function _markDeferredForStatic(host: HTMLElement): void {\n  deferredStaticElements.add(host);\n}\n\n/** @internal */\nexport function _isDeferredForStatic(host: HTMLElement): boolean {\n  return deferredStaticElements.has(host);\n}\n\n/**\n * Called by render() after a root takeover has atomically replaced the\n * `data-mado-static` tree. By that time every component that was\n * mid-snapshot must either be:\n *   1. removed with the static tree (the typical case), or\n *   2. still connected but no longer under a static ancestor — in which\n *      case the SPA tree placed it live and we activate it now.\n * Any element that fails both checks is a stuck snapshot leaf; emit a\n * single diagnostic so the developer notices the orphan.\n *\n * @internal\n */\nexport function _flushDeferredStaticElements(): void {\n  for (const el of [...deferredStaticElements]) {\n    if (!el.isConnected) {\n      deferredStaticElements.delete(el);\n      continue;\n    }\n    if (!isInsideStaticTree(el)) {\n      // Reset the guard so the live connectedCallback runs setup().\n      deferredStaticElements.delete(el);\n      // Force a clean re-enter of connectedCallback. Browsers fire that\n      // callback exactly once per insertion, so we toggle the element out\n      // and back in. Avoid this if the element is the document root.\n      const parent = el.parentNode;\n      const next = el.nextSibling;\n      if (parent) {\n        parent.removeChild(el);\n        parent.insertBefore(el, next);\n      }\n    }\n  }\n}\n\nexport interface ComponentContext {\n  host: HTMLElement;\n  /** Run cleanup when the component is removed. */\n  onDispose(fn: Disposer): void;\n  /**\n   * Reactive attribute accessor. Returns a Signal<string> that updates\n   * automatically whenever the attribute changes on the host element.\n   *\n   *   const variant = ctx.attr(\"variant\", \"primary\");\n   *   return () => html`<div class=${variant()}>…</div>`;\n   *\n   * No MutationObserver boilerplate needed. The signal updates via a\n   * per-instance MutationObserver registered during setup().\n   */\n  attr(name: string): Signal<string | null>;\n  attr(name: string, defaultValue: string): Signal<string>;\n}\n\nexport type SetupFn = (ctx: ComponentContext) => () => TemplateResult;\n\nexport type StyleInput = string | CSSResult | Array<string | CSSResult>;\n\nexport interface ComponentOptions {\n  /** Enable Shadow DOM (default: true). */\n  shadow?: boolean;\n  /**\n   * Component styles. Accepts:\n   *   - a CSS string (quick start)\n   *   - a CSSStyleSheet via `css\\`...\\`` (recommended — one copy in memory)\n   *   - an array of the above\n   */\n  styles?: StyleInput;\n}\n\nexport function component(\n  tagName: string,\n  setup: SetupFn,\n  options: ComponentOptions = {},\n): void {\n  if (!tagName.includes(\"-\")) {\n    warnOnce(\n      `component-invalid-tag-${tagName}`,\n      `component(\"${tagName}\") skipped: Custom Element names must contain a hyphen.`,\n    );\n    return;\n  }\n\n  const existingMeta = registered.get(tagName);\n  if (customElements.get(tagName)) {\n    if (\n      !existingMeta ||\n      existingMeta.setup !== setup ||\n      !sameComponentOptions(existingMeta.options, options)\n    ) {\n      warnOnce(\n        `component-duplicate-${tagName}`,\n        `component(\"${tagName}\") is already registered. Re-registration with different setup/options is ignored.`,\n      );\n    }\n    return; // idempotent hot-reload\n  }\n\n  const useShadow = options.shadow !== false;\n\n  // Normalize styles to an array of CSSStyleSheet once.\n  // Sheets are shared across all instances — memory is not duplicated.\n  const stylesheets: CSSResult[] = normalizeStyles(\n    options.styles,\n    tagName,\n    useShadow,\n  );\n\n  class MadoElement extends HTMLElement {\n    #root: Element | ShadowRoot;\n    #renderer: (() => TemplateResult) | null = null;\n    #effectDispose: Disposer | null = null;\n    #lifecycle: LifecycleHandle | null = null;\n    #connected = false;\n    // True while a teardown is queued on the microtask after a\n    // disconnectedCallback. Used to cancel teardown when the element is\n    // re-inserted in the same tick (a keyed move via insertBefore).\n    #teardownQueued = false;\n    #attrSignals = new Map<string, Signal<string | null>>();\n    #attrDefaults = new Map<string, string | null>();\n\n    constructor() {\n      super();\n      this.#root = useShadow\n        ? this.shadowRoot ??\n          this.attachShadow({\n            mode: \"open\",\n            serializable: true,\n          } as ShadowRootInit)\n        : this;\n    }\n\n    connectedCallback() {\n      // A keyed move (each() relocating via insertBefore) fires\n      // disconnectedCallback → connectedCallback synchronously. The teardown\n      // queued by disconnectedCallback is cancelled here so state survives the\n      // move and setup() is NOT re-run.\n      this.#teardownQueued = false;\n      if (this.#connected) return;\n\n      // Deferred activation inside a static snapshot tree. The runtime keeps\n      // setup()/effect() asleep until the SPA performs root takeover; the\n      // existing DSD inside shadowRoot stays as inert first-paint markup.\n      // When the SPA replaces the static root, this element is either\n      // removed with that tree (the common case) or re-inserted live —\n      // in which case connectedCallback() runs again and reaches setup().\n      if (isInsideStaticTree(this)) {\n        _markDeferredForStatic(this);\n        return;\n      }\n      if (typeof __MADO_DEVTOOLS__ === \"undefined\" || __MADO_DEVTOOLS__) emitDevtools(\"component:connect\", this, { tagName });\n\n      if (stylesheets.length > 0) {\n        if (useShadow) {\n          adopt(this.#root as ShadowRoot, ...stylesheets);\n        } else {\n          installGlobalSheets(stylesheets);\n        }\n      }\n\n      // create a lifecycle for this component. Any function\n      // called from setup() (resource, ...) will see it via\n      // getCurrentLifecycle() and register its own cleanup.\n      const lifecycle = createLifecycle();\n      const host = this;\n\n      const attr = ((name: string, defaultValue?: string) => {\n        let s = host.#attrSignals.get(name);\n        if (!s) {\n          const fallback = defaultValue ?? null;\n          host.#attrDefaults.set(name, fallback);\n          s = signal(host.getAttribute(name) ?? fallback);\n          host.#attrSignals.set(name, s);\n        }\n        return s;\n      }) as ComponentContext[\"attr\"];\n\n      const ctx: ComponentContext = {\n        host: this,\n        // ctx.onDispose proxies to lifecycle — the single source of truth\n        // for component cleanups (including auto-cleanup from\n        // resource(), navigator listeners, etc.).\n        onDispose: (fn) => lifecycle.onDispose(fn),\n        attr,\n      };\n\n      try {\n        const renderer = runInLifecycle(lifecycle, () => setup(ctx));\n        if (typeof renderer !== \"function\") {\n          throw new TypeError(`component(\"${tagName}\") setup must return a renderer function`);\n        }\n\n        // After setup(), install a single MutationObserver for all attrs\n        // registered via ctx.attr().\n        if (this.#attrSignals.size > 0) {\n          const attrNames = [...this.#attrSignals.keys()];\n          const obs = new MutationObserver((mutations) => {\n            for (const m of mutations) {\n              const s = this.#attrSignals.get(m.attributeName!);\n              const fallback = this.#attrDefaults.get(m.attributeName!) ?? null;\n              if (s) s.set(this.getAttribute(m.attributeName!) ?? fallback);\n            }\n          });\n          obs.observe(this, { attributes: true, attributeFilter: attrNames });\n          lifecycle.onDispose(() => obs.disconnect());\n        }\n\n        const effectDispose = runInLifecycle(lifecycle, () => effect(() => {\n          if (typeof __MADO_DEVTOOLS__ === \"undefined\" || __MADO_DEVTOOLS__) emitDevtools(\"component:render\", this, { tagName });\n          render(renderer(), this.#root);\n        }));\n        this.#renderer = renderer;\n        this.#effectDispose = effectDispose;\n        this.#lifecycle = lifecycle;\n        this.#connected = true;\n        if (typeof __MADO_DEVTOOLS__ === \"undefined\" || __MADO_DEVTOOLS__) emitDevtools(\"component:ready\", this, { tagName });\n      } catch (err) {\n        unmount(this.#root);\n        lifecycle.dispose();\n        this.#renderer = null;\n        this.#effectDispose = null;\n        this.#lifecycle = null;\n        this.#attrSignals.clear();\n        this.#attrDefaults.clear();\n        this.#connected = false;\n        if (typeof __MADO_DEVTOOLS__ === \"undefined\" || __MADO_DEVTOOLS__) emitDevtools(\"component:error\", this, { tagName, error: err });\n        throw err;\n      }\n    }\n\n    disconnectedCallback() {\n      // A deferred snapshot leaf was removed by takeover before setup() ever\n      // ran. Clear the deferred marker so the registry does not accumulate\n      // dead references.\n      deferredStaticElements.delete(this);\n\n      // Defer teardown to a microtask. A keyed move (each() relocating a node\n      // via insertBefore) fires disconnectedCallback → connectedCallback in the\n      // same tick; connectedCallback clears #teardownQueued so the teardown is\n      // skipped and component state survives the move. A genuine removal leaves\n      // the element disconnected, so the microtask tears it down.\n      if (this.#teardownQueued) return;\n      this.#teardownQueued = true;\n      queueMicrotask(() => {\n        if (!this.#teardownQueued) return; // re-inserted in the same tick\n        this.#teardownQueued = false;\n        if (this.isConnected) return; // moved back into the document\n        this.#teardown();\n      });\n    }\n\n    /** Synchronously dispose effects and lifecycle. */\n    #teardown() {\n      if (typeof __MADO_DEVTOOLS__ === \"undefined\" || __MADO_DEVTOOLS__) emitDevtools(\"component:dispose\", this, { tagName });\n      this.#effectDispose?.();\n      this.#effectDispose = null;\n      unmount(this.#root);\n      this.#lifecycle?.dispose();\n      this.#lifecycle = null;\n      this.#renderer = null;\n      this.#attrSignals.clear();\n      this.#attrDefaults.clear();\n      this.#connected = false;\n    }\n\n  }\n\n  customElements.define(tagName, MadoElement);\n  registered.set(tagName, { setup, options });\n}\n\n// ---------- helpers ----------\n\nfunction normalizeStyles(\n  input: StyleInput | undefined,\n  tagName: string,\n  useShadow: boolean,\n): CSSResult[] {\n  if (!input) return [];\n  const arr = Array.isArray(input) ? input : [input];\n  return arr.map((s) => {\n    let sheet: CSSResult;\n    if (typeof s === \"string\") {\n      sheet = createStylesheet(s);\n    } else {\n      sheet = s;\n    }\n    // light DOM: scope by tag name\n    return useShadow ? sheet : scopeStyles(tagName, sheet);\n  });\n}\n\nconst installedGlobal = new WeakSet<CSSResult>();\nconst registered = new Map<\n  string,\n  { setup: SetupFn; options: ComponentOptions }\n>();\n\nfunction sameComponentOptions(\n  a: ComponentOptions,\n  b: ComponentOptions,\n): boolean {\n  if (a.shadow !== b.shadow) return false;\n  if (a.styles !== b.styles) return false;\n  return true;\n}\n\nfunction installGlobalSheets(sheets: CSSResult[]): void {\n  const toAdd = sheets.filter((s) => !installedGlobal.has(s));\n  if (toAdd.length === 0) return;\n  for (const s of toAdd) installedGlobal.add(s);\n  document.adoptedStyleSheets = [...document.adoptedStyleSheets, ...toAdd];\n}\n\n// Convenience re-export.\nexport { html };\n"]}

package/dist/src/context.d.ts

@@ -1,40 +1,21 @@
-/**
- * Context (DI) without props drilling. A native pattern from Lit / Open Web Components.
- *
- *   const ThemeCtx = createContext<'light'|'dark'>('light');
- *
- *   component('x-app', ({ host }) => {
- *     provide(host, ThemeCtx, signal('dark'));
- *     return () => html`<x-child/>`;
- *   });
- *
- *   component('x-child', ({ host }) => {
- *     const theme = inject(host, ThemeCtx);   // signal: () => 'dark' | 'light'
- *     return () => html`<div data-theme=${theme}>...</div>`;
- *   });
- *
- * How it works:
- *   provide() listens for the 'mado:context' event on the host — when a child
- *   component dispatches it (bubbles), the parent writes the current signal
- *   into the event detail and calls preventDefault.
- *   inject() dispatches the event and reads the result.
- *   This fully conforms to the Web Components Community Context Protocol.
- */
-import { type Signal } from "./signal.js";
+/** Context DI implemented through the Web Components Context Protocol. */
+import { type Disposer, type Signal } from "./signal.js";
 export interface Context<T> {
     readonly _ctx: true;
     readonly key: symbol;
     readonly defaultValue: T;
 }
+export interface ContextRequestEventDetail<T = unknown> {
+    context: unknown;
+    callback(value: T, unsubscribe?: Disposer): void;
+    subscribe?: boolean;
+}
 export declare function createContext<T>(defaultValue: T): Context<T>;
 /**
- * Declare that this host provides a value for the given context.
- * Returns the signal itself so the provider can update it.
- */
-export declare function provide<T>(host: HTMLElement, ctx: Context<T>, initial: T | Signal<T>): Signal<T>;
-/**
- * Request a context value. Walks up the DOM tree (including
- * Shadow DOM via composed) to the first provider. If not found —
- * returns the defaultValue wrapped in a signal.
+ * Provide a context value from a host. The returned signal updates protocol
+ * subscribers. Listener/effect cleanup follows the current Mado lifecycle.
  */
-export declare function inject<T>(host: HTMLElement, ctx: Context<T>): Signal<T>;
+export declare function provide<T>(host: HTMLElement, context: Context<T>, initial: T | Signal<T>): Signal<T>;
+/** Request the nearest provider and expose its current value as a Signal. */
+export declare function inject<T>(host: HTMLElement, context: Context<T>): Signal<T>;
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/context.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAE1E,OAAO,EAAkB,KAAK,QAAQ,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAMzE,MAAM,WAAW,OAAO,CAAC,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,YAAY,EAAE,CAAC,CAAC;CAC1B;AAED,MAAM,WAAW,yBAAyB,CAAC,CAAC,GAAG,OAAO;IACpD,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,WAAW,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;IACjD,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAM5D;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,CAAC,EACvB,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,OAAO,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,GACrB,MAAM,CAAC,CAAC,CAAC,CAiDX;AAED,6EAA6E;AAC7E,wBAAgB,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAyB3E"}

package/dist/src/context.js

@@ -1,67 +1,92 @@
-/**
- * Context (DI) without props drilling. A native pattern from Lit / Open Web Components.
- *
- *   const ThemeCtx = createContext<'light'|'dark'>('light');
- *
- *   component('x-app', ({ host }) => {
- *     provide(host, ThemeCtx, signal('dark'));
- *     return () => html`<x-child/>`;
- *   });
- *
- *   component('x-child', ({ host }) => {
- *     const theme = inject(host, ThemeCtx);   // signal: () => 'dark' | 'light'
- *     return () => html`<div data-theme=${theme}>...</div>`;
- *   });
- *
- * How it works:
- *   provide() listens for the 'mado:context' event on the host — when a child
- *   component dispatches it (bubbles), the parent writes the current signal
- *   into the event detail and calls preventDefault.
- *   inject() dispatches the event and reads the result.
- *   This fully conforms to the Web Components Community Context Protocol.
- */
-import { signal } from "./signal.js";
-const CONTEXT_EVENT = "mado:context";
+/** Context DI implemented through the Web Components Context Protocol. */
+import { effect, signal } from "./signal.js";
+import { getCurrentLifecycle } from "./lifecycle.js";
+import { warnOnce } from "./diagnostics.js";
+const CONTEXT_EVENT = "context-request";
 export function createContext(defaultValue) {
     return {
         _ctx: true,
-        key: Symbol("madoctx"),
+        key: Symbol("mado-context"),
         defaultValue,
     };
 }
 /**
- * Declare that this host provides a value for the given context.
- * Returns the signal itself so the provider can update it.
+ * Provide a context value from a host. The returned signal updates protocol
+ * subscribers. Listener/effect cleanup follows the current Mado lifecycle.
  */
-export function provide(host, ctx, initial) {
-    const sig = typeof initial === "function"
-        ? initial
-        : signal(initial);
-    const handler = (e) => {
-        const ce = e;
-        if (ce.detail.key !== ctx.key)
+export function provide(host, context, initial) {
+    const source = isSignal(initial) ? initial : signal(initial);
+    const subscribers = new Set();
+    let disposed = false;
+    const handler = (event) => {
+        const request = event;
+        if (request.detail?.context !== context.key)
+            return;
+        event.stopPropagation();
+        if (!request.detail.subscribe) {
+            request.detail.callback(source.peek());
             return;
-        ce.detail.value = sig;
-        e.stopPropagation();
+        }
+        const callback = request.detail.callback;
+        let active = true;
+        const unsubscribe = () => {
+            if (!active)
+                return;
+            active = false;
+            subscribers.delete(callback);
+        };
+        subscribers.add(callback);
+        callback(source.peek(), unsubscribe);
     };
     host.addEventListener(CONTEXT_EVENT, handler);
-    return sig;
+    const stopPublish = effect(() => {
+        const value = source();
+        for (const callback of [...subscribers])
+            callback(value);
+    });
+    const dispose = () => {
+        if (disposed)
+            return;
+        disposed = true;
+        host.removeEventListener(CONTEXT_EVENT, handler);
+        subscribers.clear();
+        stopPublish();
+    };
+    const lifecycle = getCurrentLifecycle();
+    if (lifecycle)
+        lifecycle.onDispose(dispose);
+    else {
+        warnOnce("context-provider-outside-lifecycle", "provide() called outside a component/page lifecycle; its event listener cannot be cleaned up automatically.");
+    }
+    return source;
 }
-/**
- * Request a context value. Walks up the DOM tree (including
- * Shadow DOM via composed) to the first provider. If not found —
- * returns the defaultValue wrapped in a signal.
- */
-export function inject(host, ctx) {
-    const detail = { key: ctx.key };
+/** Request the nearest provider and expose its current value as a Signal. */
+export function inject(host, context) {
+    const value = signal(context.defaultValue);
+    let unsubscribe;
+    const detail = {
+        context: context.key,
+        subscribe: true,
+        callback(next, dispose) {
+            value.set(next);
+            if (dispose)
+                unsubscribe = dispose;
+        },
+    };
     host.dispatchEvent(new CustomEvent(CONTEXT_EVENT, {
         detail,
         bubbles: true,
         composed: true,
-        cancelable: true,
     }));
-    if (detail.value)
-        return detail.value;
-    return signal(ctx.defaultValue);
+    getCurrentLifecycle()?.onDispose(() => {
+        unsubscribe?.();
+        unsubscribe = undefined;
+    });
+    return value;
+}
+function isSignal(value) {
+    return typeof value === "function" &&
+        typeof value.set === "function" &&
+        typeof value.peek === "function";
 }
 //# sourceMappingURL=context.js.map

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

@@ -16,6 +16,7 @@
  *   - if the browser has @scope (Chrome 118+, Safari 17.4+), we wrap styles.
  *   - fallback: prefix selectors with the tag — a simple regex at string level.
  */
+const stylesheetText = new WeakMap();
 /**
  * Tagged literal for CSS. Returns a CSSStyleSheet ready for
  * adoptedStyleSheets. Value interpolation — only primitives or
@@ -34,8 +35,7 @@ export function css(strings, ...values) {
                 continue;
             if (v instanceof CSSStyleSheet) {
                 // composition — insert all rules
-                for (const rule of v.cssRules)
-                    text += rule.cssText;
+                text += getStylesheetText(v) ?? rulesText(v);
                 continue;
             }
             const s = String(v);
@@ -47,8 +47,24 @@ export function css(strings, ...values) {
     }
     const sheet = new CSSStyleSheet();
     sheet.replaceSync(text);
+    stylesheetText.set(sheet, text);
     return sheet;
 }
+/** @internal */
+export function createStylesheet(text) {
+    const sheet = new CSSStyleSheet();
+    sheet.replaceSync(text);
+    stylesheetText.set(sheet, text);
+    return sheet;
+}
+/** @internal */
+export function getStylesheetText(sheet) {
+    return stylesheetText.get(sheet);
+}
+/** @internal */
+export function getStylesheetHash(sheet) {
+    return stableHash(getStylesheetText(sheet) ?? rulesText(sheet));
+}
 /**
  * Build an inline-style string from a CSS variables object.
  *
@@ -104,9 +120,7 @@ const hasScope = (() => {
  *     → 'x-button button { color: red }'
  */
 export function scopeStyles(tagName, sheet) {
-    let text = "";
-    for (const rule of sheet.cssRules)
-        text += rule.cssText;
+    const text = getStylesheetText(sheet) ?? rulesText(sheet);
     let scoped;
     if (hasScope) {
         scoped = `@scope (${tagName}) { ${text} }`;
@@ -132,6 +146,21 @@ export function scopeStyles(tagName, sheet) {
     }
     const out = new CSSStyleSheet();
     out.replaceSync(scoped);
+    stylesheetText.set(out, scoped);
     return out;
 }
+function rulesText(sheet) {
+    let text = "";
+    for (const rule of sheet.cssRules)
+        text += rule.cssText;
+    return text;
+}
+function stableHash(text) {
+    let hash = 0x811c9dc5;
+    for (let i = 0; i < text.length; i++) {
+        hash ^= text.charCodeAt(i);
+        hash = Math.imul(hash, 0x01000193);
+    }
+    return (hash >>> 0).toString(36);
+}
 //# sourceMappingURL=css.js.map