sigmx 0.1.1 → 0.2.0

package/dist/kernel/runtime.js

@@ -1,66 +1,59 @@
 import { recase } from "../lib/casing.js";
 import { functionCompiler } from "./compile.js";
-import { effect } from "./reactive.js";
+import { rootEffect } from "./reactive.js";
 import { createStore } from "./state.js";
 const isEl = (n) => n.nodeType === 1;
-const tree = (n) => isEl(n) ? [n, ...n.querySelectorAll("*")] : n instanceof ShadowRoot ? [...n.querySelectorAll("*")] : [];
-const parsed = /* @__PURE__ */ new Map();
+const tree = (n) => n.querySelectorAll ? [...isEl(n) ? [n] : [], ...n.querySelectorAll("*")] : [];
 const parseAttr = (raw) => {
-  let p = parsed.get(raw);
-  if (!p) {
-    const [head, ...modParts] = raw.split("__");
-    const i = head.indexOf(":");
-    const mods = /* @__PURE__ */ new Map();
-    for (const m of modParts) {
-      const [name, ...args] = m.split(".");
-      mods.set(name, args);
-    }
-    p = { plugin: i < 0 ? head : head.slice(0, i), key: i < 0 ? void 0 : head.slice(i + 1), mods };
-    parsed.set(raw, p);
-  }
-  return p;
+  const [head, ...modParts] = raw.split("__");
+  const [, plugin, key] = /^([^:]*)(?::(.*))?$/.exec(head);
+  return {
+    plugin,
+    key,
+    mods: new Map(
+      modParts.map((m) => {
+        const [name, ...args] = m.split(".");
+        return [name, args];
+      })
+    )
+  };
+};
+const cut = (list, s) => {
+  for (const p of list) if (s.startsWith(p)) return s.slice(p.length);
 };
-const fail = (message, info) => Object.assign(new Error(message), { info });
 const createRuntime = (options) => {
   const prefixes = [].concat(options.prefix ?? "data-");
   const eventPrefixes = [].concat(options.eventPrefix ?? "sigmx-");
   const store = options.store ?? createStore();
-  const compiler = options.compile ?? functionCompiler;
   const { expressions } = options;
   const onError = options.onError ?? ((e, info) => console.error(e, info));
   const attributes = /* @__PURE__ */ Object.create(null);
-  const actions = /* @__PURE__ */ Object.create(null);
-  const handlers = /* @__PURE__ */ Object.create(null);
   const runtime = {
     prefixes,
     attr: (name) => prefixes[0] + name,
     store,
-    compiler,
+    compiler: options.compile ?? functionCompiler,
     emit: (type, detail) => document.dispatchEvent(new CustomEvent(`sigmx-${type}`, { detail })),
     call: (name, ctx, args) => {
-      const a = actions[name];
+      const a = runtime.actions[name];
       if (!a) throw ctx.error(`unknown action @${name}`);
       return a.call(ctx, ...args);
     },
     eventPrefixes,
     handle: (event, data) => {
-      const p = eventPrefixes.find((p2) => event.startsWith(p2));
-      const h = handlers[p ? event.slice(p.length) : event];
+      const h = runtime.handlers[cut(eventPrefixes, event) ?? event];
       h?.handle(runtime, data);
       return !!h;
     },
     attributes,
-    actions,
-    handlers
+    actions: /* @__PURE__ */ Object.create(null),
+    handlers: /* @__PURE__ */ Object.create(null)
   };
   const mounted = /* @__PURE__ */ new Map();
   const roots = /* @__PURE__ */ new Set();
-  const ignoreSelf = prefixes.map((p) => `[${p}ignore__self]`).join();
   const ignoreAny = prefixes.map((p) => `[${p}ignore]`).join();
-  const ignored = (el) => el.matches(ignoreSelf) || !!el.closest(ignoreAny);
-  const strip = (attr) => {
-    for (const p of prefixes) if (attr.startsWith(p)) return attr.slice(p.length);
-  };
+  const ignored = (el) => !!el.closest(ignoreAny);
+  let destroyed = false;
   const unmount = (els) => {
     for (const el of els) {
       const m = mounted.get(el);
@@ -72,29 +65,30 @@ const createRuntime = (options) => {
     m?.get(attr)?.();
     m?.delete(attr);
   };
-  const actionsFor = (el, evt, error, cleanup, report) => {
-    const ctx = { el, evt, store, runtime, error, cleanup };
-    return new Proxy(
-      {},
-      {
-        get: (_, name) => (...args) => {
-          const r = runtime.call(name, ctx, args);
-          if (r instanceof Promise) r.catch(report);
-          return r;
-        }
-      }
-    );
-  };
   const mount = (el, attr, raw, value, only) => {
     const { plugin: name, key, mods } = parseAttr(raw);
     const plugin = attributes[name];
     if (!plugin || only && !only.has(name)) return;
     unmountAttr(el, attr);
     const disposers = [];
+    const cleanup = (f) => {
+      disposers.push(f);
+      return () => {
+        const i = disposers.indexOf(f);
+        if (i >= 0) disposers.splice(i, 1);
+      };
+    };
     const info = { plugin: name, el, attr };
-    const error = (message, extra) => fail(`${prefixes[0]}${name}: ${message}`, { ...info, ...extra });
+    const error = (message, extra) => Object.assign(new Error(`${prefixes[0]}${name}: ${message}`), { info: { ...info, ...extra } });
     const report = (e) => onError(e, info);
     let fn;
+    const watched = /* @__PURE__ */ new WeakSet();
+    const watch = (r) => {
+      if (r instanceof Promise && !watched.has(r)) {
+        watched.add(r);
+        r.catch(report);
+      }
+    };
     const ctx = {
       el,
       plugin: name,
@@ -104,10 +98,27 @@ const createRuntime = (options) => {
       mods,
       cased: (style = "camel") => recase(key ?? "", mods.get("case")?.[0] || style),
       evaluate: (evt, ...args) => {
-        fn ??= expressions(value, ["el", "evt", ...plugin.args ?? []], plugin.returns ?? true);
-        return fn(store, actionsFor(el, evt, error, ctx.cleanup, report), el, evt, ...args);
+        if (plugin.literal && !mods.has("dynamic")) return value;
+        fn ??= expressions(value, ["el", "evt", ...plugin.args ?? []]);
+        const actx = { el, evt, store, runtime, error, cleanup, report };
+        const actions = new Proxy(
+          {},
+          {
+            get: (_, name2) => (...args2) => {
+              const r2 = runtime.call(name2, actx, args2);
+              watch(r2);
+              return r2;
+            }
+          }
+        );
+        const r = fn(store, actions, el, evt, ...args);
+        watch(r);
+        return r;
+      },
+      // Root-owned: an attribute mounted from inside another effect must outlive that effect's re-runs.
+      effect: (f) => {
+        cleanup(rootEffect(f, report));
       },
-      effect: (f) => disposers.push(effect(f, report)),
       listen: (target, type, f, opts) => {
         const h = (e) => {
           try {
@@ -117,10 +128,11 @@ const createRuntime = (options) => {
           }
         };
         target.addEventListener(type, h, opts);
-        disposers.push(() => target.removeEventListener(type, h, opts));
+        cleanup(() => target.removeEventListener(type, h, opts));
       },
-      cleanup: (f) => disposers.push(f),
+      cleanup,
       error,
+      report,
       store,
       runtime
     };
@@ -133,12 +145,16 @@ const createRuntime = (options) => {
       for (const d of disposers.splice(0)) d();
     });
     try {
-      if (plugin.key === "required" && !key) throw error("needs a key");
-      if (plugin.key === "forbidden" && key) throw error("takes no key");
-      if (plugin.value === "required" && !value) throw error("needs a value");
-      if (plugin.value === "forbidden" && value) throw error("takes no value");
+      for (const [k, v] of [
+        ["key", key],
+        ["value", value]
+      ]) {
+        const rule = plugin[k];
+        if (rule && rule === "required" === !v) throw error(`${rule === "required" ? "needs a" : "takes no"} ${k}`);
+      }
       const r = plugin.mount(ctx);
-      if (typeof r === "function") disposers.push(r);
+      if (typeof r === "function") cleanup(r);
+      else watch(r);
     } catch (e) {
       report(e);
     }
@@ -147,7 +163,7 @@ const createRuntime = (options) => {
     for (const el of els) {
       if (ignored(el)) continue;
       for (const { name, value } of [...el.attributes]) {
-        const raw = strip(name);
+        const raw = cut(prefixes, name);
         if (raw && !mounted.get(el)?.has(name)) mount(el, name, raw, value, only);
       }
     }
@@ -155,10 +171,10 @@ const createRuntime = (options) => {
   const observer = new MutationObserver((records) => {
     for (const { type, target, attributeName, addedNodes, removedNodes } of records) {
       if (type === "childList") {
-        for (const n of removedNodes) unmount(tree(n));
+        for (const n of removedNodes) if (!n.isConnected) unmount(tree(n));
         for (const n of addedNodes) mountEls(tree(n));
       } else if (attributeName && isEl(target) && !ignored(target)) {
-        const raw = strip(attributeName);
+        const raw = cut(prefixes, attributeName);
         if (!raw) continue;
         const value = target.getAttribute(attributeName);
         if (value === null) unmountAttr(target, attributeName);
@@ -166,26 +182,19 @@ const createRuntime = (options) => {
       }
     }
   });
-  let ready = false;
   const apply = (root = document.documentElement, observe = true, only) => {
+    if (destroyed) return;
     mountEls(tree(root), only);
     if (observe && !roots.has(root)) {
       observer.observe(root, { subtree: true, childList: true, attributes: true });
       roots.add(root);
     }
-    if (!ready && roots.has(document.documentElement)) {
-      ready = true;
-      runtime.emit("ready");
-    }
   };
   const use = (...plugins) => {
     const added = /* @__PURE__ */ new Set();
     for (const p of plugins) {
-      if (p.type === "attribute") {
-        attributes[p.name] = p;
-        added.add(p.name);
-      } else if (p.type === "action") actions[p.name] = p;
-      else handlers[p.name] = p;
+      runtime[`${p.type}s`][p.name] = p;
+      if (p.type === "attribute") added.add(p.name);
     }
     if (added.size) for (const r of roots) apply(r, false, added);
   };
@@ -200,6 +209,7 @@ const createRuntime = (options) => {
     apply: (root, observe) => apply(root, observe),
     use,
     destroy: () => {
+      destroyed = true;
       observer.disconnect();
       stopPatches();
       unmount([...mounted.keys()]);

package/dist/kernel/runtime.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/kernel/runtime.ts"],
-  "sourcesContent": ["import { type CaseStyle, recase } from '../lib/casing.js';\nimport { functionCompiler } from './compile.js';\nimport type {\n  ActionCtx,\n  AttributePlugin,\n  Ctx,\n  El,\n  Evaluator,\n  Mods,\n  Plugin,\n  Runtime,\n  RuntimeOptions,\n  Sigmx,\n} from './contracts.js';\nimport { effect } from './reactive.js';\nimport { createStore } from './state.js';\n\nconst isEl = (n: Node): n is El => n.nodeType === 1;\n/** An element (or shadow root) followed by every element under it; nothing for text and comment nodes. */\nconst tree = (n: Node): El[] =>\n  isEl(n) ? [n, ...n.querySelectorAll<El>('*')] : n instanceof ShadowRoot ? [...n.querySelectorAll<El>('*')] : [];\n\ntype Parsed = { plugin: string; key: string | undefined; mods: Mods };\nconst parsed = new Map<string, Parsed>();\n\n/** 'on:click__debounce.300ms__prevent' \u2192 { plugin: 'on', key: 'click', mods: {debounce: ['300ms'], prevent: []} } */\nexport const parseAttr = (raw: string): Parsed => {\n  let p = parsed.get(raw);\n  if (!p) {\n    const [head, ...modParts] = raw.split('__');\n    const i = head.indexOf(':');\n    const mods: Mods = new Map();\n    for (const m of modParts) {\n      const [name, ...args] = m.split('.');\n      mods.set(name, args);\n    }\n    p = { plugin: i < 0 ? head : head.slice(0, i), key: i < 0 ? undefined : head.slice(i + 1), mods };\n    parsed.set(raw, p);\n  }\n  return p;\n};\n\nconst fail = (message: string, info: Record<string, unknown>): Error => Object.assign(new Error(message), { info });\n\n/** Low-level constructor: you supply the expression pipeline. `createSigmx` wraps it with the runtime compiler. */\nexport const createRuntime = (options: RuntimeOptions): Sigmx => {\n  const prefixes = ([] as string[]).concat(options.prefix ?? 'data-');\n  const eventPrefixes = ([] as string[]).concat(options.eventPrefix ?? 'sigmx-');\n  const store = options.store ?? createStore();\n  const compiler = options.compile ?? functionCompiler;\n  const { expressions } = options;\n  const onError = options.onError ?? ((e, info) => console.error(e, info));\n  const attributes: Record<string, AttributePlugin> = Object.create(null);\n  const actions: Runtime['actions'] = Object.create(null);\n  const handlers: Runtime['handlers'] = Object.create(null);\n\n  const runtime: Runtime = {\n    prefixes,\n    attr: (name) => prefixes[0] + name,\n    store,\n    compiler,\n    emit: (type, detail) => document.dispatchEvent(new CustomEvent(`sigmx-${type}`, { detail })),\n    call: (name, ctx, args) => {\n      const a = actions[name];\n      if (!a) throw ctx.error(`unknown action @${name}`);\n      return a.call(ctx, ...args);\n    },\n    eventPrefixes,\n    handle: (event, data) => {\n      const p = eventPrefixes.find((p) => event.startsWith(p));\n      const h = handlers[p ? event.slice(p.length) : event];\n      h?.handle(runtime, data);\n      return !!h;\n    },\n    attributes,\n    actions,\n    handlers,\n  };\n\n  // element \u2192 attribute name \u2192 dispose\n  const mounted = new Map<El, Map<string, () => void>>();\n  const roots = new Set<El | ShadowRoot>();\n  const ignoreSelf = prefixes.map((p) => `[${p}ignore__self]`).join();\n  const ignoreAny = prefixes.map((p) => `[${p}ignore]`).join();\n  const ignored = (el: El) => el.matches(ignoreSelf) || !!el.closest(ignoreAny);\n\n  const strip = (attr: string): string | undefined => {\n    for (const p of prefixes) if (attr.startsWith(p)) return attr.slice(p.length);\n  };\n\n  const unmount = (els: Iterable<El>): void => {\n    for (const el of els) {\n      const m = mounted.get(el);\n      if (m && mounted.delete(el)) for (const d of m.values()) d();\n    }\n  };\n\n  const unmountAttr = (el: El, attr: string): void => {\n    const m = mounted.get(el);\n    m?.get(attr)?.();\n    m?.delete(attr);\n  };\n\n  const actionsFor = (\n    el: El,\n    evt: Event | undefined,\n    error: Ctx['error'],\n    cleanup: (fn: () => void) => void,\n    report: (e: unknown) => void,\n  ) => {\n    const ctx: ActionCtx = { el, evt, store, runtime, error, cleanup };\n    return new Proxy(\n      {},\n      {\n        get:\n          (_, name: string) =>\n          (...args: any[]) => {\n            const r = runtime.call(name, ctx, args);\n            // Async actions (requests) reject long after the expression returned; route that to onError.\n            if (r instanceof Promise) r.catch(report);\n            return r;\n          },\n      },\n    );\n  };\n\n  const mount = (el: El, attr: string, raw: string, value: string, only?: Set<string>): void => {\n    const { plugin: name, key, mods } = parseAttr(raw);\n    const plugin = attributes[name];\n    if (!plugin || (only && !only.has(name))) return;\n    unmountAttr(el, attr);\n\n    const disposers: (() => void)[] = [];\n    const info = { plugin: name, el, attr };\n    const error: Ctx['error'] = (message, extra) => fail(`${prefixes[0]}${name}: ${message}`, { ...info, ...extra });\n    const report = (e: unknown) => onError(e, info);\n    let fn: Evaluator | undefined;\n    const ctx: Ctx = {\n      el,\n      plugin: name,\n      attr,\n      key,\n      value,\n      mods,\n      cased: (style = 'camel') => recase(key ?? '', (mods.get('case')?.[0] as CaseStyle) || style),\n      evaluate: (evt, ...args) => {\n        fn ??= expressions(value, ['el', 'evt', ...(plugin.args ?? [])], plugin.returns ?? true);\n        return fn(store, actionsFor(el, evt, error, ctx.cleanup, report), el, evt, ...args);\n      },\n      effect: (f) => disposers.push(effect(f, report)),\n      listen: (target, type, f, opts) => {\n        const h = (e: Event) => {\n          try {\n            f(e);\n          } catch (err) {\n            report(err);\n          }\n        };\n        target.addEventListener(type, h, opts);\n        disposers.push(() => target.removeEventListener(type, h, opts));\n      },\n      cleanup: (f) => disposers.push(f),\n      error,\n      store,\n      runtime,\n    };\n\n    let m = mounted.get(el);\n    if (!m) {\n      m = new Map();\n      mounted.set(el, m);\n    }\n    m.set(attr, () => {\n      for (const d of disposers.splice(0)) d();\n    });\n\n    try {\n      if (plugin.key === 'required' && !key) throw error('needs a key');\n      if (plugin.key === 'forbidden' && key) throw error('takes no key');\n      if (plugin.value === 'required' && !value) throw error('needs a value');\n      if (plugin.value === 'forbidden' && value) throw error('takes no value');\n      const r = plugin.mount(ctx);\n      if (typeof r === 'function') disposers.push(r);\n    } catch (e) {\n      report(e);\n    }\n  };\n\n  const mountEls = (els: Iterable<El>, only?: Set<string>): void => {\n    for (const el of els) {\n      if (ignored(el)) continue;\n      for (const { name, value } of [...el.attributes]) {\n        const raw = strip(name);\n        // Observers can report a subtree more than once (nested insertions); a mounted attribute stays as it is.\n        if (raw && !mounted.get(el)?.has(name)) mount(el, name, raw, value, only);\n      }\n    }\n  };\n\n  const observer = new MutationObserver((records) => {\n    for (const { type, target, attributeName, addedNodes, removedNodes } of records) {\n      if (type === 'childList') {\n        for (const n of removedNodes) unmount(tree(n));\n        for (const n of addedNodes) mountEls(tree(n));\n      } else if (attributeName && isEl(target) && !ignored(target)) {\n        const raw = strip(attributeName);\n        if (!raw) continue;\n        const value = target.getAttribute(attributeName);\n        if (value === null) unmountAttr(target, attributeName);\n        else mount(target, attributeName, raw, value);\n      }\n    }\n  });\n\n  let ready = false;\n  const apply = (root: El | ShadowRoot = document.documentElement, observe = true, only?: Set<string>) => {\n    mountEls(tree(root), only);\n    if (observe && !roots.has(root)) {\n      observer.observe(root, { subtree: true, childList: true, attributes: true });\n      roots.add(root);\n    }\n    if (!ready && roots.has(document.documentElement)) {\n      ready = true;\n      runtime.emit('ready');\n    }\n  };\n\n  const use = (...plugins: Plugin[]): void => {\n    const added = new Set<string>();\n    for (const p of plugins) {\n      if (p.type === 'attribute') {\n        attributes[p.name] = p;\n        added.add(p.name);\n      } else if (p.type === 'action') actions[p.name] = p;\n      else handlers[p.name] = p;\n    }\n    if (added.size) for (const r of roots) apply(r, false, added);\n  };\n\n  const stopPatches = store.onPatch((patch) => runtime.emit('signal-patch', patch));\n  use(...(options.plugins ?? []));\n\n  const sigmx: Sigmx = {\n    runtime,\n    store,\n    get $() {\n      return store.$;\n    },\n    apply: (root, observe) => apply(root, observe),\n    use,\n    destroy: () => {\n      observer.disconnect();\n      stopPatches();\n      unmount([...mounted.keys()]);\n      roots.clear();\n    },\n  };\n\n  if (options.autoStart ?? true) {\n    if (document.readyState === 'loading') {\n      document.addEventListener('DOMContentLoaded', () => sigmx.apply(), { once: true });\n    } else {\n      sigmx.apply();\n    }\n  }\n  return sigmx;\n};\n"],
-  "mappings": "AAAA,SAAyB,cAAc;AACvC,SAAS,wBAAwB;AAajC,SAAS,cAAc;AACvB,SAAS,mBAAmB;AAE5B,MAAM,OAAO,CAAC,MAAqB,EAAE,aAAa;AAElD,MAAM,OAAO,CAAC,MACZ,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,EAAE,iBAAqB,GAAG,CAAC,IAAI,aAAa,aAAa,CAAC,GAAG,EAAE,iBAAqB,GAAG,CAAC,IAAI,CAAC;AAGhH,MAAM,SAAS,oBAAI,IAAoB;AAGhC,MAAM,YAAY,CAAC,QAAwB;AAChD,MAAI,IAAI,OAAO,IAAI,GAAG;AACtB,MAAI,CAAC,GAAG;AACN,UAAM,CAAC,MAAM,GAAG,QAAQ,IAAI,IAAI,MAAM,IAAI;AAC1C,UAAM,IAAI,KAAK,QAAQ,GAAG;AAC1B,UAAM,OAAa,oBAAI,IAAI;AAC3B,eAAW,KAAK,UAAU;AACxB,YAAM,CAAC,MAAM,GAAG,IAAI,IAAI,EAAE,MAAM,GAAG;AACnC,WAAK,IAAI,MAAM,IAAI;AAAA,IACrB;AACA,QAAI,EAAE,QAAQ,IAAI,IAAI,OAAO,KAAK,MAAM,GAAG,CAAC,GAAG,KAAK,IAAI,IAAI,SAAY,KAAK,MAAM,IAAI,CAAC,GAAG,KAAK;AAChG,WAAO,IAAI,KAAK,CAAC;AAAA,EACnB;AACA,SAAO;AACT;AAEA,MAAM,OAAO,CAAC,SAAiB,SAAyC,OAAO,OAAO,IAAI,MAAM,OAAO,GAAG,EAAE,KAAK,CAAC;AAG3G,MAAM,gBAAgB,CAAC,YAAmC;AAC/D,QAAM,WAAY,CAAC,EAAe,OAAO,QAAQ,UAAU,OAAO;AAClE,QAAM,gBAAiB,CAAC,EAAe,OAAO,QAAQ,eAAe,QAAQ;AAC7E,QAAM,QAAQ,QAAQ,SAAS,YAAY;AAC3C,QAAM,WAAW,QAAQ,WAAW;AACpC,QAAM,EAAE,YAAY,IAAI;AACxB,QAAM,UAAU,QAAQ,YAAY,CAAC,GAAG,SAAS,QAAQ,MAAM,GAAG,IAAI;AACtE,QAAM,aAA8C,uBAAO,OAAO,IAAI;AACtE,QAAM,UAA8B,uBAAO,OAAO,IAAI;AACtD,QAAM,WAAgC,uBAAO,OAAO,IAAI;AAExD,QAAM,UAAmB;AAAA,IACvB;AAAA,IACA,MAAM,CAAC,SAAS,SAAS,CAAC,IAAI;AAAA,IAC9B;AAAA,IACA;AAAA,IACA,MAAM,CAAC,MAAM,WAAW,SAAS,cAAc,IAAI,YAAY,SAAS,IAAI,IAAI,EAAE,OAAO,CAAC,CAAC;AAAA,IAC3F,MAAM,CAAC,MAAM,KAAK,SAAS;AACzB,YAAM,IAAI,QAAQ,IAAI;AACtB,UAAI,CAAC,EAAG,OAAM,IAAI,MAAM,mBAAmB,IAAI,EAAE;AACjD,aAAO,EAAE,KAAK,KAAK,GAAG,IAAI;AAAA,IAC5B;AAAA,IACA;AAAA,IACA,QAAQ,CAAC,OAAO,SAAS;AACvB,YAAM,IAAI,cAAc,KAAK,CAACA,OAAM,MAAM,WAAWA,EAAC,CAAC;AACvD,YAAM,IAAI,SAAS,IAAI,MAAM,MAAM,EAAE,MAAM,IAAI,KAAK;AACpD,SAAG,OAAO,SAAS,IAAI;AACvB,aAAO,CAAC,CAAC;AAAA,IACX;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAGA,QAAM,UAAU,oBAAI,IAAiC;AACrD,QAAM,QAAQ,oBAAI,IAAqB;AACvC,QAAM,aAAa,SAAS,IAAI,CAAC,MAAM,IAAI,CAAC,eAAe,EAAE,KAAK;AAClE,QAAM,YAAY,SAAS,IAAI,CAAC,MAAM,IAAI,CAAC,SAAS,EAAE,KAAK;AAC3D,QAAM,UAAU,CAAC,OAAW,GAAG,QAAQ,UAAU,KAAK,CAAC,CAAC,GAAG,QAAQ,SAAS;AAE5E,QAAM,QAAQ,CAAC,SAAqC;AAClD,eAAW,KAAK,SAAU,KAAI,KAAK,WAAW,CAAC,EAAG,QAAO,KAAK,MAAM,EAAE,MAAM;AAAA,EAC9E;AAEA,QAAM,UAAU,CAAC,QAA4B;AAC3C,eAAW,MAAM,KAAK;AACpB,YAAM,IAAI,QAAQ,IAAI,EAAE;AACxB,UAAI,KAAK,QAAQ,OAAO,EAAE,EAAG,YAAW,KAAK,EAAE,OAAO,EAAG,GAAE;AAAA,IAC7D;AAAA,EACF;AAEA,QAAM,cAAc,CAAC,IAAQ,SAAuB;AAClD,UAAM,IAAI,QAAQ,IAAI,EAAE;AACxB,OAAG,IAAI,IAAI,IAAI;AACf,OAAG,OAAO,IAAI;AAAA,EAChB;AAEA,QAAM,aAAa,CACjB,IACA,KACA,OACA,SACA,WACG;AACH,UAAM,MAAiB,EAAE,IAAI,KAAK,OAAO,SAAS,OAAO,QAAQ;AACjE,WAAO,IAAI;AAAA,MACT,CAAC;AAAA,MACD;AAAA,QACE,KACE,CAAC,GAAG,SACJ,IAAI,SAAgB;AAClB,gBAAM,IAAI,QAAQ,KAAK,MAAM,KAAK,IAAI;AAEtC,cAAI,aAAa,QAAS,GAAE,MAAM,MAAM;AACxC,iBAAO;AAAA,QACT;AAAA,MACJ;AAAA,IACF;AAAA,EACF;AAEA,QAAM,QAAQ,CAAC,IAAQ,MAAc,KAAa,OAAe,SAA6B;AAC5F,UAAM,EAAE,QAAQ,MAAM,KAAK,KAAK,IAAI,UAAU,GAAG;AACjD,UAAM,SAAS,WAAW,IAAI;AAC9B,QAAI,CAAC,UAAW,QAAQ,CAAC,KAAK,IAAI,IAAI,EAAI;AAC1C,gBAAY,IAAI,IAAI;AAEpB,UAAM,YAA4B,CAAC;AACnC,UAAM,OAAO,EAAE,QAAQ,MAAM,IAAI,KAAK;AACtC,UAAM,QAAsB,CAAC,SAAS,UAAU,KAAK,GAAG,SAAS,CAAC,CAAC,GAAG,IAAI,KAAK,OAAO,IAAI,EAAE,GAAG,MAAM,GAAG,MAAM,CAAC;AAC/G,UAAM,SAAS,CAAC,MAAe,QAAQ,GAAG,IAAI;AAC9C,QAAI;AACJ,UAAM,MAAW;AAAA,MACf;AAAA,MACA,QAAQ;AAAA,MACR;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,OAAO,CAAC,QAAQ,YAAY,OAAO,OAAO,IAAK,KAAK,IAAI,MAAM,IAAI,CAAC,KAAmB,KAAK;AAAA,MAC3F,UAAU,CAAC,QAAQ,SAAS;AAC1B,eAAO,YAAY,OAAO,CAAC,MAAM,OAAO,GAAI,OAAO,QAAQ,CAAC,CAAE,GAAG,OAAO,WAAW,IAAI;AACvF,eAAO,GAAG,OAAO,WAAW,IAAI,KAAK,OAAO,IAAI,SAAS,MAAM,GAAG,IAAI,KAAK,GAAG,IAAI;AAAA,MACpF;AAAA,MACA,QAAQ,CAAC,MAAM,UAAU,KAAK,OAAO,GAAG,MAAM,CAAC;AAAA,MAC/C,QAAQ,CAAC,QAAQ,MAAM,GAAG,SAAS;AACjC,cAAM,IAAI,CAAC,MAAa;AACtB,cAAI;AACF,cAAE,CAAC;AAAA,UACL,SAAS,KAAK;AACZ,mBAAO,GAAG;AAAA,UACZ;AAAA,QACF;AACA,eAAO,iBAAiB,MAAM,GAAG,IAAI;AACrC,kBAAU,KAAK,MAAM,OAAO,oBAAoB,MAAM,GAAG,IAAI,CAAC;AAAA,MAChE;AAAA,MACA,SAAS,CAAC,MAAM,UAAU,KAAK,CAAC;AAAA,MAChC;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAEA,QAAI,IAAI,QAAQ,IAAI,EAAE;AACtB,QAAI,CAAC,GAAG;AACN,UAAI,oBAAI,IAAI;AACZ,cAAQ,IAAI,IAAI,CAAC;AAAA,IACnB;AACA,MAAE,IAAI,MAAM,MAAM;AAChB,iBAAW,KAAK,UAAU,OAAO,CAAC,EAAG,GAAE;AAAA,IACzC,CAAC;AAED,QAAI;AACF,UAAI,OAAO,QAAQ,cAAc,CAAC,IAAK,OAAM,MAAM,aAAa;AAChE,UAAI,OAAO,QAAQ,eAAe,IAAK,OAAM,MAAM,cAAc;AACjE,UAAI,OAAO,UAAU,cAAc,CAAC,MAAO,OAAM,MAAM,eAAe;AACtE,UAAI,OAAO,UAAU,eAAe,MAAO,OAAM,MAAM,gBAAgB;AACvE,YAAM,IAAI,OAAO,MAAM,GAAG;AAC1B,UAAI,OAAO,MAAM,WAAY,WAAU,KAAK,CAAC;AAAA,IAC/C,SAAS,GAAG;AACV,aAAO,CAAC;AAAA,IACV;AAAA,EACF;AAEA,QAAM,WAAW,CAAC,KAAmB,SAA6B;AAChE,eAAW,MAAM,KAAK;AACpB,UAAI,QAAQ,EAAE,EAAG;AACjB,iBAAW,EAAE,MAAM,MAAM,KAAK,CAAC,GAAG,GAAG,UAAU,GAAG;AAChD,cAAM,MAAM,MAAM,IAAI;AAEtB,YAAI,OAAO,CAAC,QAAQ,IAAI,EAAE,GAAG,IAAI,IAAI,EAAG,OAAM,IAAI,MAAM,KAAK,OAAO,IAAI;AAAA,MAC1E;AAAA,IACF;AAAA,EACF;AAEA,QAAM,WAAW,IAAI,iBAAiB,CAAC,YAAY;AACjD,eAAW,EAAE,MAAM,QAAQ,eAAe,YAAY,aAAa,KAAK,SAAS;AAC/E,UAAI,SAAS,aAAa;AACxB,mBAAW,KAAK,aAAc,SAAQ,KAAK,CAAC,CAAC;AAC7C,mBAAW,KAAK,WAAY,UAAS,KAAK,CAAC,CAAC;AAAA,MAC9C,WAAW,iBAAiB,KAAK,MAAM,KAAK,CAAC,QAAQ,MAAM,GAAG;AAC5D,cAAM,MAAM,MAAM,aAAa;AAC/B,YAAI,CAAC,IAAK;AACV,cAAM,QAAQ,OAAO,aAAa,aAAa;AAC/C,YAAI,UAAU,KAAM,aAAY,QAAQ,aAAa;AAAA,YAChD,OAAM,QAAQ,eAAe,KAAK,KAAK;AAAA,MAC9C;AAAA,IACF;AAAA,EACF,CAAC;AAED,MAAI,QAAQ;AACZ,QAAM,QAAQ,CAAC,OAAwB,SAAS,iBAAiB,UAAU,MAAM,SAAuB;AACtG,aAAS,KAAK,IAAI,GAAG,IAAI;AACzB,QAAI,WAAW,CAAC,MAAM,IAAI,IAAI,GAAG;AAC/B,eAAS,QAAQ,MAAM,EAAE,SAAS,MAAM,WAAW,MAAM,YAAY,KAAK,CAAC;AAC3E,YAAM,IAAI,IAAI;AAAA,IAChB;AACA,QAAI,CAAC,SAAS,MAAM,IAAI,SAAS,eAAe,GAAG;AACjD,cAAQ;AACR,cAAQ,KAAK,OAAO;AAAA,IACtB;AAAA,EACF;AAEA,QAAM,MAAM,IAAI,YAA4B;AAC1C,UAAM,QAAQ,oBAAI,IAAY;AAC9B,eAAW,KAAK,SAAS;AACvB,UAAI,EAAE,SAAS,aAAa;AAC1B,mBAAW,EAAE,IAAI,IAAI;AACrB,cAAM,IAAI,EAAE,IAAI;AAAA,MAClB,WAAW,EAAE,SAAS,SAAU,SAAQ,EAAE,IAAI,IAAI;AAAA,UAC7C,UAAS,EAAE,IAAI,IAAI;AAAA,IAC1B;AACA,QAAI,MAAM,KAAM,YAAW,KAAK,MAAO,OAAM,GAAG,OAAO,KAAK;AAAA,EAC9D;AAEA,QAAM,cAAc,MAAM,QAAQ,CAAC,UAAU,QAAQ,KAAK,gBAAgB,KAAK,CAAC;AAChF,MAAI,GAAI,QAAQ,WAAW,CAAC,CAAE;AAE9B,QAAM,QAAe;AAAA,IACnB;AAAA,IACA;AAAA,IACA,IAAI,IAAI;AACN,aAAO,MAAM;AAAA,IACf;AAAA,IACA,OAAO,CAAC,MAAM,YAAY,MAAM,MAAM,OAAO;AAAA,IAC7C;AAAA,IACA,SAAS,MAAM;AACb,eAAS,WAAW;AACpB,kBAAY;AACZ,cAAQ,CAAC,GAAG,QAAQ,KAAK,CAAC,CAAC;AAC3B,YAAM,MAAM;AAAA,IACd;AAAA,EACF;AAEA,MAAI,QAAQ,aAAa,MAAM;AAC7B,QAAI,SAAS,eAAe,WAAW;AACrC,eAAS,iBAAiB,oBAAoB,MAAM,MAAM,MAAM,GAAG,EAAE,MAAM,KAAK,CAAC;AAAA,IACnF,OAAO;AACL,YAAM,MAAM;AAAA,IACd;AAAA,EACF;AACA,SAAO;AACT;",
-  "names": ["p"]
+  "sourcesContent": ["import { type CaseStyle, recase } from '../lib/casing.js';\nimport { functionCompiler } from './compile.js';\nimport type {\n  ActionCtx,\n  AttributePlugin,\n  Ctx,\n  El,\n  Evaluator,\n  Mods,\n  Plugin,\n  Runtime,\n  RuntimeOptions,\n  Sigmx,\n} from './contracts.js';\nimport { rootEffect } from './reactive.js';\nimport { createStore } from './state.js';\n\nconst isEl = (n: Node): n is El => n.nodeType === 1;\n/** An element (or shadow root) followed by every element under it; nothing for text and comment nodes. */\nconst tree = (n: Node): El[] =>\n  (n as ParentNode).querySelectorAll ? [...(isEl(n) ? [n] : []), ...(n as ParentNode).querySelectorAll<El>('*')] : [];\n\ntype Parsed = { plugin: string; key: string | undefined; mods: Mods };\n\n/** 'on:click__debounce.300ms__prevent' \u2192 { plugin: 'on', key: 'click', mods: {debounce: ['300ms'], prevent: []} } */\nexport const parseAttr = (raw: string): Parsed => {\n  const [head, ...modParts] = raw.split('__');\n  const [, plugin, key] = /^([^:]*)(?::(.*))?$/.exec(head) as string[];\n  return {\n    plugin,\n    key,\n    mods: new Map(\n      modParts.map((m) => {\n        const [name, ...args] = m.split('.');\n        return [name, args];\n      }),\n    ),\n  };\n};\n\n/** The rest of `s` after the first prefix in `list` that it starts with; undefined when none matches. */\nconst cut = (list: readonly string[], s: string): string | undefined => {\n  for (const p of list) if (s.startsWith(p)) return s.slice(p.length);\n};\n\n/** Low-level constructor: you supply the expression pipeline. `createSigmx` wraps it with the runtime compiler. */\nexport const createRuntime = (options: RuntimeOptions): Sigmx => {\n  const prefixes = ([] as string[]).concat(options.prefix ?? 'data-');\n  const eventPrefixes = ([] as string[]).concat(options.eventPrefix ?? 'sigmx-');\n  const store = options.store ?? createStore();\n  const { expressions } = options;\n  const onError = options.onError ?? ((e, info) => console.error(e, info));\n  const attributes: Record<string, AttributePlugin> = Object.create(null);\n\n  const runtime: Runtime = {\n    prefixes,\n    attr: (name) => prefixes[0] + name,\n    store,\n    compiler: options.compile ?? functionCompiler,\n    emit: (type, detail) => document.dispatchEvent(new CustomEvent(`sigmx-${type}`, { detail })),\n    call: (name, ctx, args) => {\n      const a = runtime.actions[name];\n      if (!a) throw ctx.error(`unknown action @${name}`);\n      return a.call(ctx, ...args);\n    },\n    eventPrefixes,\n    handle: (event, data) => {\n      const h = runtime.handlers[cut(eventPrefixes, event) ?? event];\n      h?.handle(runtime, data);\n      return !!h;\n    },\n    attributes,\n    actions: Object.create(null),\n    handlers: Object.create(null),\n  };\n\n  // element \u2192 attribute name \u2192 dispose\n  const mounted = new Map<El, Map<string, () => void>>();\n  const roots = new Set<El | ShadowRoot>();\n  const ignoreAny = prefixes.map((p) => `[${p}ignore]`).join();\n  const ignored = (el: El) => !!el.closest(ignoreAny);\n  let destroyed = false;\n\n  const unmount = (els: Iterable<El>): void => {\n    for (const el of els) {\n      const m = mounted.get(el);\n      if (m && mounted.delete(el)) for (const d of m.values()) d();\n    }\n  };\n\n  const unmountAttr = (el: El, attr: string): void => {\n    const m = mounted.get(el);\n    m?.get(attr)?.();\n    m?.delete(attr);\n  };\n\n  const mount = (el: El, attr: string, raw: string, value: string, only?: Set<string>): void => {\n    const { plugin: name, key, mods } = parseAttr(raw);\n    const plugin = attributes[name];\n    if (!plugin || (only && !only.has(name))) return;\n    unmountAttr(el, attr);\n\n    const disposers: (() => void)[] = [];\n    const cleanup = (f: () => void) => {\n      disposers.push(f);\n      return () => {\n        const i = disposers.indexOf(f);\n        if (i >= 0) disposers.splice(i, 1);\n      };\n    };\n    const info = { plugin: name, el, attr };\n    const error: Ctx['error'] = (message, extra) =>\n      Object.assign(new Error(`${prefixes[0]}${name}: ${message}`), { info: { ...info, ...extra } });\n    const report = (e: unknown) => onError(e, info);\n    let fn: Evaluator | undefined;\n    const watched = new WeakSet<Promise<unknown>>(); // promises already routed to onError\n    const watch = (r: unknown) => {\n      if (r instanceof Promise && !watched.has(r)) {\n        watched.add(r);\n        r.catch(report);\n      }\n    };\n    const ctx: Ctx = {\n      el,\n      plugin: name,\n      attr,\n      key,\n      value,\n      mods,\n      cased: (style = 'camel') => recase(key ?? '', (mods.get('case')?.[0] as CaseStyle) || style),\n      evaluate: (evt, ...args) => {\n        if (plugin.literal && !mods.has('dynamic')) return value;\n        fn ??= expressions(value, ['el', 'evt', ...(plugin.args ?? [])]);\n        const actx: ActionCtx = { el, evt, store, runtime, error, cleanup, report };\n        const actions = new Proxy(\n          {},\n          {\n            get:\n              (_, name: string) =>\n              (...args: any[]) => {\n                const r = runtime.call(name, actx, args);\n                watch(r); // async actions (requests) reject long after the expression returned\n                return r;\n              },\n          },\n        );\n        const r = fn(store, actions, el, evt, ...args);\n        watch(r); // an expression's own rejected promise is reported too, once\n        return r;\n      },\n      // Root-owned: an attribute mounted from inside another effect must outlive that effect's re-runs.\n      effect: (f) => {\n        cleanup(rootEffect(f, report));\n      },\n      listen: (target, type, f, opts) => {\n        const h = (e: Event) => {\n          try {\n            f(e);\n          } catch (err) {\n            report(err);\n          }\n        };\n        target.addEventListener(type, h, opts);\n        cleanup(() => target.removeEventListener(type, h, opts));\n      },\n      cleanup,\n      error,\n      report,\n      store,\n      runtime,\n    };\n\n    let m = mounted.get(el);\n    if (!m) {\n      m = new Map();\n      mounted.set(el, m);\n    }\n    m.set(attr, () => {\n      for (const d of disposers.splice(0)) d();\n    });\n\n    try {\n      // Contract checks: a keyed directive without a key would otherwise write to the path ''.\n      for (const [k, v] of [\n        ['key', key],\n        ['value', value],\n      ] as const) {\n        const rule = plugin[k];\n        if (rule && (rule === 'required') === !v) throw error(`${rule === 'required' ? 'needs a' : 'takes no'} ${k}`);\n      }\n      const r: unknown = plugin.mount(ctx);\n      if (typeof r === 'function') cleanup(r as () => void);\n      else watch(r); // an async mount that rejects is reported, not lost\n    } catch (e) {\n      report(e);\n    }\n  };\n\n  const mountEls = (els: Iterable<El>, only?: Set<string>): void => {\n    for (const el of els) {\n      if (ignored(el)) continue;\n      for (const { name, value } of [...el.attributes]) {\n        const raw = cut(prefixes, name);\n        // Observers can report a subtree more than once (nested insertions); a mounted attribute stays as it is.\n        if (raw && !mounted.get(el)?.has(name)) mount(el, name, raw, value, only);\n      }\n    }\n  };\n\n  const observer = new MutationObserver((records) => {\n    for (const { type, target, attributeName, addedNodes, removedNodes } of records) {\n      if (type === 'childList') {\n        // A node that is still connected was moved (teleport, morph), not removed: it keeps its state.\n        for (const n of removedNodes) if (!n.isConnected) unmount(tree(n));\n        for (const n of addedNodes) mountEls(tree(n));\n      } else if (attributeName && isEl(target) && !ignored(target)) {\n        const raw = cut(prefixes, attributeName);\n        if (!raw) continue;\n        const value = target.getAttribute(attributeName);\n        if (value === null) unmountAttr(target, attributeName);\n        else mount(target, attributeName, raw, value);\n      }\n    }\n  });\n\n  const apply = (root: El | ShadowRoot = document.documentElement, observe = true, only?: Set<string>) => {\n    if (destroyed) return;\n    mountEls(tree(root), only);\n    if (observe && !roots.has(root)) {\n      observer.observe(root, { subtree: true, childList: true, attributes: true });\n      roots.add(root);\n    }\n  };\n\n  const use = (...plugins: Plugin[]): void => {\n    const added = new Set<string>();\n    for (const p of plugins) {\n      (runtime as any)[`${p.type}s`][p.name] = p;\n      if (p.type === 'attribute') added.add(p.name);\n    }\n    if (added.size) for (const r of roots) apply(r, false, added);\n  };\n\n  const stopPatches = store.onPatch((patch) => runtime.emit('signal-patch', patch));\n  use(...(options.plugins ?? []));\n\n  const sigmx: Sigmx = {\n    runtime,\n    store,\n    get $() {\n      return store.$;\n    },\n    apply: (root, observe) => apply(root, observe),\n    use,\n    destroy: () => {\n      destroyed = true;\n      observer.disconnect();\n      stopPatches();\n      unmount([...mounted.keys()]);\n      roots.clear();\n    },\n  };\n\n  if (options.autoStart ?? true) {\n    if (document.readyState === 'loading') {\n      document.addEventListener('DOMContentLoaded', () => sigmx.apply(), { once: true });\n    } else {\n      sigmx.apply();\n    }\n  }\n  return sigmx;\n};\n"],
+  "mappings": "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",
+  "names": ["name", "args", "r"]
 }

package/dist/kernel/scan.d.ts

@@ -4,7 +4,7 @@ export type PluginMeta = {
     name: string;
     type: Plugin['type'];
     from: string;
-    returns?: boolean;
+    literal?: boolean;
     args?: string[];
 };
 export declare const implied: Record<string, string[]>;

package/dist/kernel/scan.js

@@ -11,7 +11,7 @@ const builtinPlugins = () => Object.entries(builtins).filter(([, v]) => v && typ
     name: p.name,
     type: p.type,
     from: "sigmx/plugins",
-    returns: p.returns,
+    literal: p.literal,
     args: p.args
   };
 });
@@ -25,14 +25,14 @@ const customPluginMeta = (exportName, source, from) => {
   const body = m[2];
   const name = /\bname\s*:\s*['"`]([^'"`]+)['"`]/.exec(body)?.[1];
   if (!name) return;
-  const returns = /\breturns\s*:\s*(true|false)/.exec(body)?.[1];
+  const literal = /\bliteral\s*:\s*true/.test(body);
   const args = /\bargs\s*:\s*\[([^\]]*)\]/.exec(body)?.[1];
   return {
     export: exportName,
     name,
     type: m[1],
     from,
-    returns: returns === void 0 ? void 0 : returns === "true",
+    literal: literal || void 0,
     args: args?.split(",").map((s) => s.trim().replace(/^['"`]|['"`]$/g, "")).filter(Boolean)
   };
 };

package/dist/kernel/scan.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/kernel/scan.ts"],
-  "sourcesContent": ["// Node only; never bundled for the browser.\nimport * as builtins from '../plugins/index.js';\nimport type { Plugin } from './contracts.js';\n\nexport type PluginMeta = {\n  export: string;\n  name: string;\n  type: Plugin['type'];\n  from: string;\n  returns?: boolean;\n  args?: string[];\n};\n\nconst NETWORK = ['httpGet', 'httpPost', 'httpPut', 'httpPatch', 'httpDelete', 'websocket', 'boost'];\n\nexport const implied: Record<string, string[]> = {\n  ...Object.fromEntries(NETWORK.map((n) => [n, ['applyElements', 'applyState']])),\n  boost: ['httpGet', 'httpPost', 'applyElements', 'applyState'],\n};\n\nexport const builtinPlugins = (): PluginMeta[] =>\n  Object.entries(builtins)\n    .filter(([, v]) => v && typeof v === 'object' && 'type' in (v as object))\n    .map(([key, v]) => {\n      const p = v as Plugin;\n      return {\n        export: key,\n        name: p.name,\n        type: p.type,\n        from: 'sigmx/plugins',\n        returns: (p as any).returns,\n        args: (p as any).args,\n      };\n    });\n\n/**\n * Read a custom plugin's metadata from its source without executing it: finds\n * `attribute({ name: 'x', ... })`, `action({...})` or `handler({...})` near `export const <exportName>`.\n */\nexport const customPluginMeta = (exportName: string, source: string, from: string): PluginMeta | undefined => {\n  const re = new RegExp(\n    `export\\\\s+const\\\\s+${exportName}\\\\s*(?::[^=]+)?=\\\\s*(attribute|action|handler)\\\\s*\\\\(\\\\s*\\\\{([\\\\s\\\\S]*?)\\\\}\\\\s*\\\\)`,\n    'm',\n  );\n  const m = re.exec(source);\n  if (!m) return;\n  const body = m[2];\n  const name = /\\bname\\s*:\\s*['\"`]([^'\"`]+)['\"`]/.exec(body)?.[1];\n  if (!name) return;\n  const returns = /\\breturns\\s*:\\s*(true|false)/.exec(body)?.[1];\n  const args = /\\bargs\\s*:\\s*\\[([^\\]]*)\\]/.exec(body)?.[1];\n  return {\n    export: exportName,\n    name,\n    type: m[1] as Plugin['type'],\n    from,\n    returns: returns === undefined ? undefined : returns === 'true',\n    args: args\n      ?.split(',')\n      .map((s) => s.trim().replace(/^['\"`]|['\"`]$/g, ''))\n      .filter(Boolean),\n  };\n};\n\nconst esc = (s: string) => s.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n\n/** True if `source` refers to the plugin: `data-<name>` for directives, `@name(` for functions, the name as a string for handlers. */\nexport const mentions = (source: string, p: PluginMeta, prefixes: string[]): boolean => {\n  const n = esc(p.name);\n  if (p.type === 'attribute')\n    return prefixes.some((pre) => new RegExp(`(^|[\\\\s\"'\\`<])${esc(pre)}${n}(?=[\\\\s=:_>\"'\\`/]|$)`, 'm').test(source));\n  if (p.type === 'action') return new RegExp(`@${n}\\\\s*\\\\(`).test(source);\n  return new RegExp(`['\"\\`](?:[\\\\w-]+-)?${n}['\"\\`]`).test(source);\n};\n\nexport type Selection = {\n  plugins: PluginMeta[];\n  reasons: Record<string, string>;\n  unused: string[];\n};\n\n/**\n * Decide which plugins to ship. `sources` are file contents; `custom` are extra plugins (from\n * `customPluginMeta`); `always` are export names that ship regardless.\n */\nexport const selectPlugins = (\n  sources: string[],\n  {\n    prefixes = ['data-'],\n    always = [],\n    custom = [],\n  }: { prefixes?: string[]; always?: string[]; custom?: PluginMeta[] } = {},\n): Selection => {\n  const known = [...builtinPlugins(), ...custom];\n  const byExport = new Map(known.map((p) => [p.export, p]));\n  const reasons: Record<string, string> = {};\n  const add = (exp: string, why: string) => {\n    if (!byExport.has(exp) || reasons[exp]) return;\n    reasons[exp] = why;\n    for (const dep of implied[exp] ?? []) add(dep, exp);\n  };\n  for (const exp of always) add(exp, 'always');\n  const text = sources.join('\\n');\n  for (const p of known)\n    if (!reasons[p.export] && (p.type !== 'handler' || custom.includes(p)) && mentions(text, p, prefixes))\n      add(p.export, 'used');\n  const plugins = known.filter((p) => reasons[p.export]);\n  return { plugins, reasons, unused: known.filter((p) => !reasons[p.export]).map((p) => p.export) };\n};\n\nexport const generatePluginsModule = (sel: Selection): string => {\n  const groups = new Map<string, string[]>();\n  for (const p of sel.plugins) groups.set(p.from, [...(groups.get(p.from) ?? []), p.export]);\n  const imports = [...groups]\n    .map(([from, names]) => `import { ${names.join(', ')} } from ${JSON.stringify(from)}`)\n    .join('\\n');\n  return `${imports}\\nexport const plugins = [${sel.plugins.map((p) => p.export).join(', ')}]\\nexport const report = ${JSON.stringify({ reasons: sel.reasons, unused: sel.unused }, null, 2)}\\n`;\n};\n"],
-  "mappings": "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",
+  "sourcesContent": ["// Node only; never bundled for the browser.\nimport * as builtins from '../plugins/index.js';\nimport type { Plugin } from './contracts.js';\n\nexport type PluginMeta = {\n  export: string;\n  name: string;\n  type: Plugin['type'];\n  from: string;\n  literal?: boolean;\n  args?: string[];\n};\n\nconst NETWORK = ['httpGet', 'httpPost', 'httpPut', 'httpPatch', 'httpDelete', 'websocket', 'boost'];\n\nexport const implied: Record<string, string[]> = {\n  ...Object.fromEntries(NETWORK.map((n) => [n, ['applyElements', 'applyState']])),\n  boost: ['httpGet', 'httpPost', 'applyElements', 'applyState'],\n};\n\nexport const builtinPlugins = (): PluginMeta[] =>\n  Object.entries(builtins)\n    .filter(([, v]) => v && typeof v === 'object' && 'type' in (v as object))\n    .map(([key, v]) => {\n      const p = v as Plugin;\n      return {\n        export: key,\n        name: p.name,\n        type: p.type,\n        from: 'sigmx/plugins',\n        literal: (p as any).literal,\n        args: (p as any).args,\n      };\n    });\n\n/**\n * Read a custom plugin's metadata from its source without executing it: finds\n * `attribute({ name: 'x', ... })`, `action({...})` or `handler({...})` near `export const <exportName>`.\n */\nexport const customPluginMeta = (exportName: string, source: string, from: string): PluginMeta | undefined => {\n  const re = new RegExp(\n    `export\\\\s+const\\\\s+${exportName}\\\\s*(?::[^=]+)?=\\\\s*(attribute|action|handler)\\\\s*\\\\(\\\\s*\\\\{([\\\\s\\\\S]*?)\\\\}\\\\s*\\\\)`,\n    'm',\n  );\n  const m = re.exec(source);\n  if (!m) return;\n  const body = m[2];\n  const name = /\\bname\\s*:\\s*['\"`]([^'\"`]+)['\"`]/.exec(body)?.[1];\n  if (!name) return;\n  const literal = /\\bliteral\\s*:\\s*true/.test(body);\n  const args = /\\bargs\\s*:\\s*\\[([^\\]]*)\\]/.exec(body)?.[1];\n  return {\n    export: exportName,\n    name,\n    type: m[1] as Plugin['type'],\n    from,\n    literal: literal || undefined,\n    args: args\n      ?.split(',')\n      .map((s) => s.trim().replace(/^['\"`]|['\"`]$/g, ''))\n      .filter(Boolean),\n  };\n};\n\nconst esc = (s: string) => s.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n\n/** True if `source` refers to the plugin: `data-<name>` for directives, `@name(` for functions, the name as a string for handlers. */\nexport const mentions = (source: string, p: PluginMeta, prefixes: string[]): boolean => {\n  const n = esc(p.name);\n  if (p.type === 'attribute')\n    return prefixes.some((pre) => new RegExp(`(^|[\\\\s\"'\\`<])${esc(pre)}${n}(?=[\\\\s=:_>\"'\\`/]|$)`, 'm').test(source));\n  if (p.type === 'action') return new RegExp(`@${n}\\\\s*\\\\(`).test(source);\n  return new RegExp(`['\"\\`](?:[\\\\w-]+-)?${n}['\"\\`]`).test(source);\n};\n\nexport type Selection = {\n  plugins: PluginMeta[];\n  reasons: Record<string, string>;\n  unused: string[];\n};\n\n/**\n * Decide which plugins to ship. `sources` are file contents; `custom` are extra plugins (from\n * `customPluginMeta`); `always` are export names that ship regardless.\n */\nexport const selectPlugins = (\n  sources: string[],\n  {\n    prefixes = ['data-'],\n    always = [],\n    custom = [],\n  }: { prefixes?: string[]; always?: string[]; custom?: PluginMeta[] } = {},\n): Selection => {\n  const known = [...builtinPlugins(), ...custom];\n  const byExport = new Map(known.map((p) => [p.export, p]));\n  const reasons: Record<string, string> = {};\n  const add = (exp: string, why: string) => {\n    if (!byExport.has(exp) || reasons[exp]) return;\n    reasons[exp] = why;\n    for (const dep of implied[exp] ?? []) add(dep, exp);\n  };\n  for (const exp of always) add(exp, 'always');\n  const text = sources.join('\\n');\n  for (const p of known)\n    if (!reasons[p.export] && (p.type !== 'handler' || custom.includes(p)) && mentions(text, p, prefixes))\n      add(p.export, 'used');\n  const plugins = known.filter((p) => reasons[p.export]);\n  return { plugins, reasons, unused: known.filter((p) => !reasons[p.export]).map((p) => p.export) };\n};\n\nexport const generatePluginsModule = (sel: Selection): string => {\n  const groups = new Map<string, string[]>();\n  for (const p of sel.plugins) groups.set(p.from, [...(groups.get(p.from) ?? []), p.export]);\n  const imports = [...groups]\n    .map(([from, names]) => `import { ${names.join(', ')} } from ${JSON.stringify(from)}`)\n    .join('\\n');\n  return `${imports}\\nexport const plugins = [${sel.plugins.map((p) => p.export).join(', ')}]\\nexport const report = ${JSON.stringify({ reasons: sel.reasons, unused: sel.unused }, null, 2)}\\n`;\n};\n"],
+  "mappings": "AACA,YAAY,cAAc;AAY1B,MAAM,UAAU,CAAC,WAAW,YAAY,WAAW,aAAa,cAAc,aAAa,OAAO;AAE3F,MAAM,UAAoC;AAAA,EAC/C,GAAG,OAAO,YAAY,QAAQ,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,iBAAiB,YAAY,CAAC,CAAC,CAAC;AAAA,EAC9E,OAAO,CAAC,WAAW,YAAY,iBAAiB,YAAY;AAC9D;AAEO,MAAM,iBAAiB,MAC5B,OAAO,QAAQ,QAAQ,EACpB,OAAO,CAAC,CAAC,EAAE,CAAC,MAAM,KAAK,OAAO,MAAM,YAAY,UAAW,CAAY,EACvE,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM;AACjB,QAAM,IAAI;AACV,SAAO;AAAA,IACL,QAAQ;AAAA,IACR,MAAM,EAAE;AAAA,IACR,MAAM,EAAE;AAAA,IACR,MAAM;AAAA,IACN,SAAU,EAAU;AAAA,IACpB,MAAO,EAAU;AAAA,EACnB;AACF,CAAC;AAME,MAAM,mBAAmB,CAAC,YAAoB,QAAgB,SAAyC;AAC5G,QAAM,KAAK,IAAI;AAAA,IACb,sBAAsB,UAAU;AAAA,IAChC;AAAA,EACF;AACA,QAAM,IAAI,GAAG,KAAK,MAAM;AACxB,MAAI,CAAC,EAAG;AACR,QAAM,OAAO,EAAE,CAAC;AAChB,QAAM,OAAO,mCAAmC,KAAK,IAAI,IAAI,CAAC;AAC9D,MAAI,CAAC,KAAM;AACX,QAAM,UAAU,uBAAuB,KAAK,IAAI;AAChD,QAAM,OAAO,4BAA4B,KAAK,IAAI,IAAI,CAAC;AACvD,SAAO;AAAA,IACL,QAAQ;AAAA,IACR;AAAA,IACA,MAAM,EAAE,CAAC;AAAA,IACT;AAAA,IACA,SAAS,WAAW;AAAA,IACpB,MAAM,MACF,MAAM,GAAG,EACV,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,kBAAkB,EAAE,CAAC,EACjD,OAAO,OAAO;AAAA,EACnB;AACF;AAEA,MAAM,MAAM,CAAC,MAAc,EAAE,QAAQ,uBAAuB,MAAM;AAG3D,MAAM,WAAW,CAAC,QAAgB,GAAe,aAAgC;AACtF,QAAM,IAAI,IAAI,EAAE,IAAI;AACpB,MAAI,EAAE,SAAS;AACb,WAAO,SAAS,KAAK,CAAC,QAAQ,IAAI,OAAO,iBAAiB,IAAI,GAAG,CAAC,GAAG,CAAC,wBAAwB,GAAG,EAAE,KAAK,MAAM,CAAC;AACjH,MAAI,EAAE,SAAS,SAAU,QAAO,IAAI,OAAO,IAAI,CAAC,SAAS,EAAE,KAAK,MAAM;AACtE,SAAO,IAAI,OAAO,sBAAsB,CAAC,QAAQ,EAAE,KAAK,MAAM;AAChE;AAYO,MAAM,gBAAgB,CAC3B,SACA;AAAA,EACE,WAAW,CAAC,OAAO;AAAA,EACnB,SAAS,CAAC;AAAA,EACV,SAAS,CAAC;AACZ,IAAuE,CAAC,MAC1D;AACd,QAAM,QAAQ,CAAC,GAAG,eAAe,GAAG,GAAG,MAAM;AAC7C,QAAM,WAAW,IAAI,IAAI,MAAM,IAAI,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;AACxD,QAAM,UAAkC,CAAC;AACzC,QAAM,MAAM,CAAC,KAAa,QAAgB;AACxC,QAAI,CAAC,SAAS,IAAI,GAAG,KAAK,QAAQ,GAAG,EAAG;AACxC,YAAQ,GAAG,IAAI;AACf,eAAW,OAAO,QAAQ,GAAG,KAAK,CAAC,EAAG,KAAI,KAAK,GAAG;AAAA,EACpD;AACA,aAAW,OAAO,OAAQ,KAAI,KAAK,QAAQ;AAC3C,QAAM,OAAO,QAAQ,KAAK,IAAI;AAC9B,aAAW,KAAK;AACd,QAAI,CAAC,QAAQ,EAAE,MAAM,MAAM,EAAE,SAAS,aAAa,OAAO,SAAS,CAAC,MAAM,SAAS,MAAM,GAAG,QAAQ;AAClG,UAAI,EAAE,QAAQ,MAAM;AACxB,QAAM,UAAU,MAAM,OAAO,CAAC,MAAM,QAAQ,EAAE,MAAM,CAAC;AACrD,SAAO,EAAE,SAAS,SAAS,QAAQ,MAAM,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE;AAClG;AAEO,MAAM,wBAAwB,CAAC,QAA2B;AAC/D,QAAM,SAAS,oBAAI,IAAsB;AACzC,aAAW,KAAK,IAAI,QAAS,QAAO,IAAI,EAAE,MAAM,CAAC,GAAI,OAAO,IAAI,EAAE,IAAI,KAAK,CAAC,GAAI,EAAE,MAAM,CAAC;AACzF,QAAM,UAAU,CAAC,GAAG,MAAM,EACvB,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,YAAY,MAAM,KAAK,IAAI,CAAC,WAAW,KAAK,UAAU,IAAI,CAAC,EAAE,EACpF,KAAK,IAAI;AACZ,SAAO,GAAG,OAAO;AAAA,0BAA6B,IAAI,QAAQ,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;AAAA,wBAA4B,KAAK,UAAU,EAAE,SAAS,IAAI,SAAS,QAAQ,IAAI,OAAO,GAAG,MAAM,CAAC,CAAC;AAAA;AAC5L;",
   "names": []
 }

package/dist/kernel/state.d.ts

@@ -14,7 +14,10 @@ export interface Store {
     remove(path: string): void;
     has(path: string): boolean;
     define(path: string, node: Signal<any>): void;
-    paths(filter?: Filter): string[];
+    /** Leaf paths, filtered; `computed: false` leaves out computed signals. */
+    paths(filter?: Filter, options?: {
+        computed?: boolean;
+    }): string[];
     snapshot(filter?: Filter, options?: {
         at?: string;
         computed?: boolean;
@@ -22,7 +25,5 @@ export interface Store {
     /** Called after each settled batch with the nested object of changed paths (null = removed). */
     onPatch(fn: (patch: Patch) => void): () => void;
     readonly $: any;
-    /** Identifier scope for compiled expressions: resolves `$count`, `$user`, and `$`. */
-    readonly scope: object;
 }
 export declare const createStore: () => Store;