sigmx 0.1.0 → 0.2.0

package/dist/kernel/runtime.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/kernel/runtime.ts"],
-  "sourcesContent": ["import { functionCompiler } from './compile.js'\nimport { effect } from './reactive.js'\nimport { createStore } from './state.js'\nimport type { ActionCtx, AttributePlugin, Ctx, El, Evaluator, Mods, Plugin, Runtime, RuntimeOptions, Sigmx } from './contracts.js'\nimport { recase, type CaseStyle } from '../lib/casing.js'\n\nconst isEl = (n: Node): n is El => n instanceof HTMLElement || n instanceof SVGElement || n instanceof MathMLElement\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 =>\n  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 = (el: El, evt: Event | undefined, error: Ctx['error'], cleanup: (fn: () => void) => void) => {\n    const ctx: ActionCtx = { el, evt, store, runtime, error, cleanup }\n    return new Proxy({}, { get: (_, name: string) => (...args: any[]) => runtime.call(name, ctx, args) })\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), 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) mounted.set(el, (m = new Map()))\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        if (raw) 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": "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",
-  "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

@@ -1,18 +1,13 @@
 import type { Plugin } from './contracts.js';
 export type PluginMeta = {
-    /** Export name, e.g. `httpGet`; what the generated module imports. */
     export: string;
-    /** Registered name, e.g. `get`; what markup refers to. */
     name: string;
     type: Plugin['type'];
-    /** Module to import from; built-ins come from `sigmx/plugins`. */
     from: string;
-    returns?: boolean;
+    literal?: boolean;
     args?: string[];
 };
-/** Plugins that only make sense together. */
 export declare const implied: Record<string, string[]>;
-/** Metadata for every built-in plugin. */
 export declare const builtinPlugins: () => PluginMeta[];
 /**
  * Read a custom plugin's metadata from its source without executing it: finds
@@ -22,21 +17,17 @@ export declare const customPluginMeta: (exportName: string, source: string, from
 /** True if `source` refers to the plugin: `data-<name>` for directives, `@name(` for functions, the name as a string for handlers. */
 export declare const mentions: (source: string, p: PluginMeta, prefixes: string[]) => boolean;
 export type Selection = {
-    /** Selected plugins in a stable order. */
     plugins: PluginMeta[];
-    /** Why each one is in: 'used', 'always', or the plugin that implied it. */
     reasons: Record<string, string>;
-    /** Known plugins that were left out. */
     unused: string[];
 };
 /**
  * Decide which plugins to ship. `sources` are file contents; `custom` are extra plugins (from
  * `customPluginMeta`); `always` are export names that ship regardless.
  */
-export declare const selectPlugins: (sources: string[], { prefixes, always, custom }?: {
+export declare const selectPlugins: (sources: string[], { prefixes, always, custom, }?: {
     prefixes?: string[];
     always?: string[];
     custom?: PluginMeta[];
 }) => Selection;
-/** JavaScript source for a module exporting `plugins` (and the selection report). */
 export declare const generatePluginsModule: (sel: Selection) => string;

package/dist/kernel/scan.js

@@ -6,34 +6,49 @@ const implied = {
 };
 const builtinPlugins = () => Object.entries(builtins).filter(([, v]) => v && typeof v === "object" && "type" in v).map(([key, v]) => {
   const p = v;
-  return { export: key, name: p.name, type: p.type, from: "sigmx/plugins", returns: p.returns, args: p.args };
+  return {
+    export: key,
+    name: p.name,
+    type: p.type,
+    from: "sigmx/plugins",
+    literal: p.literal,
+    args: p.args
+  };
 });
 const customPluginMeta = (exportName, source, from) => {
-  const re = new RegExp(`export\\s+const\\s+${exportName}\\s*(?::[^=]+)?=\\s*(attribute|action|handler)\\s*\\(\\s*\\{([\\s\\S]*?)\\}\\s*\\)`, "m");
+  const re = new RegExp(
+    `export\\s+const\\s+${exportName}\\s*(?::[^=]+)?=\\s*(attribute|action|handler)\\s*\\(\\s*\\{([\\s\\S]*?)\\}\\s*\\)`,
+    "m"
+  );
   const m = re.exec(source);
   if (!m) return;
   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)
   };
 };
-const escape = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+const esc = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 const mentions = (source, p, prefixes) => {
-  const n = escape(p.name);
-  if (p.type === "attribute") return prefixes.some((pre) => new RegExp(`(^|[\\s"'\`<])${escape(pre)}${n}(?=[\\s=:_>"'\`/]|$)`, "m").test(source));
+  const n = esc(p.name);
+  if (p.type === "attribute")
+    return prefixes.some((pre) => new RegExp(`(^|[\\s"'\`<])${esc(pre)}${n}(?=[\\s=:_>"'\`/]|$)`, "m").test(source));
   if (p.type === "action") return new RegExp(`@${n}\\s*\\(`).test(source);
   return new RegExp(`['"\`](?:[\\w-]+-)?${n}['"\`]`).test(source);
 };
-const selectPlugins = (sources, { prefixes = ["data-"], always = [], custom = [] } = {}) => {
+const selectPlugins = (sources, {
+  prefixes = ["data-"],
+  always = [],
+  custom = []
+} = {}) => {
   const known = [...builtinPlugins(), ...custom];
   const byExport = new Map(known.map((p) => [p.export, p]));
   const reasons = {};
@@ -44,7 +59,9 @@ const selectPlugins = (sources, { prefixes = ["data-"], always = [], custom = []
   };
   for (const exp of always) add(exp, "always");
   const text = sources.join("\n");
-  for (const p of known) if (!reasons[p.export] && (p.type !== "handler" || custom.includes(p)) && mentions(text, p, prefixes)) add(p.export, "used");
+  for (const p of known)
+    if (!reasons[p.export] && (p.type !== "handler" || custom.includes(p)) && mentions(text, p, prefixes))
+      add(p.export, "used");
   const plugins = known.filter((p) => reasons[p.export]);
   return { plugins, reasons, unused: known.filter((p) => !reasons[p.export]).map((p) => p.export) };
 };

package/dist/kernel/scan.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/kernel/scan.ts"],
-  "sourcesContent": ["// Auto mode: work out which plugins a codebase uses by scanning its source, the way a CSS\n// framework scans templates for class names. 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 name, e.g. `httpGet`; what the generated module imports. */\n  export: string\n  /** Registered name, e.g. `get`; what markup refers to. */\n  name: string\n  type: Plugin['type']\n  /** Module to import from; built-ins come from `sigmx/plugins`. */\n  from: string\n  returns?: boolean\n  args?: string[]\n}\n\nconst NETWORK = ['httpGet', 'httpPost', 'httpPut', 'httpPatch', 'httpDelete', 'websocket', 'boost']\n\n/** Plugins that only make sense together. */\nexport const implied: Record<string, string[]> = {\n  ...Object.fromEntries(NETWORK.map((n) => [n, ['applyElements', 'applyState']])),\n  boost: ['httpGet', 'httpPost', 'applyElements', 'applyState'],\n}\n\n/** Metadata for every built-in plugin. */\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 { export: key, name: p.name, type: p.type, from: 'sigmx/plugins', returns: (p as any).returns, args: (p as any).args }\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(`export\\\\s+const\\\\s+${exportName}\\\\s*(?::[^=]+)?=\\\\s*(attribute|action|handler)\\\\s*\\\\(\\\\s*\\\\{([\\\\s\\\\S]*?)\\\\}\\\\s*\\\\)`, 'm')\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?.split(',').map((s) => s.trim().replace(/^['\"`]|['\"`]$/g, '')).filter(Boolean),\n  }\n}\n\nconst escape = (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 = escape(p.name)\n  if (p.type === 'attribute') return prefixes.some((pre) => new RegExp(`(^|[\\\\s\"'\\`<])${escape(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  /** Selected plugins in a stable order. */\n  plugins: PluginMeta[]\n  /** Why each one is in: 'used', 'always', or the plugin that implied it. */\n  reasons: Record<string, string>\n  /** Known plugins that were left out. */\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  { prefixes = ['data-'], always = [], custom = [] }: { 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) if (!reasons[p.export] && (p.type !== 'handler' || custom.includes(p)) && mentions(text, p, prefixes)) 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\n/** JavaScript source for a module exporting `plugins` (and the selection report). */\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].map(([from, names]) => `import { ${names.join(', ')} } from ${JSON.stringify(from)}`).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": "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",
   "names": []
 }

package/dist/kernel/state.d.ts

@@ -1,5 +1,5 @@
-import { Signal } from './reactive.js';
 import { type Filter } from '../lib/objects.js';
+import { Signal } from './reactive.js';
 export type Patch = Record<string, any>;
 export interface Store {
     /** Value at a dotted path: a leaf value, a namespace proxy, or undefined. Reads subscribe. */
@@ -13,20 +13,17 @@ export interface Store {
     }): void;
     remove(path: string): void;
     has(path: string): boolean;
-    /** Install a computed (or any signal) as the leaf at a path. */
     define(path: string, node: Signal<any>): void;
-    /** Leaf paths, optionally filtered. */
-    paths(filter?: Filter): string[];
-    /** Plain-object copy of the store or a namespace. */
+    /** Leaf paths, filtered; `computed: false` leaves out computed signals. */
+    paths(filter?: Filter, options?: {
+        computed?: boolean;
+    }): string[];
     snapshot(filter?: Filter, options?: {
         at?: string;
         computed?: boolean;
     }): Patch;
     /** Called after each settled batch with the nested object of changed paths (null = removed). */
     onPatch(fn: (patch: Patch) => void): () => void;
-    /** Root namespace proxy: `$.count`, `$.user.name = 'x'`, `JSON.stringify($)`. */
     readonly $: any;
-    /** Identifier scope for compiled expressions: resolves `$count`, `$user`, and `$`. */
-    readonly scope: object;
 }
 export declare const createStore: () => Store;

package/dist/kernel/state.js

@@ -1,10 +1,13 @@
-import { Computed, Signal, batch, onSettled } from "./reactive.js";
-import { expand, isPlain, toPredicate } from "../lib/objects.js";
-const parentOf = (p) => p.slice(0, Math.max(0, p.lastIndexOf(".")));
-const nameOf = (p) => p.slice(p.lastIndexOf(".") + 1);
+import { expand, isPlain, safeKey, toPredicate } from "../lib/objects.js";
+import { batch, Computed, onSettled, Signal } from "./reactive.js";
+const split = (p) => {
+  const i = p.lastIndexOf(".");
+  return [i < 0 ? "" : p.slice(0, i), p.slice(i + 1)];
+};
 const join = (a, b) => a ? `${a}.${b}` : b;
-const under = (p, at) => !at || p === at || p.startsWith(`${at}.`);
+const under = (p, at) => !at || p.startsWith(`${at}.`);
 const str = (k) => typeof k === "string";
+const rawOf = /* @__PURE__ */ new WeakMap();
 const createStore = () => {
   const leaves = /* @__PURE__ */ new Map();
   const kids = /* @__PURE__ */ new Map([["", /* @__PURE__ */ new Set()]]);
@@ -12,14 +15,24 @@ const createStore = () => {
   const pending = /* @__PURE__ */ new Map();
   const listeners = /* @__PURE__ */ new Set();
   const nsCache = /* @__PURE__ */ new Map();
-  const arrCache = /* @__PURE__ */ new WeakMap();
+  const proxies = /* @__PURE__ */ new WeakMap();
+  const link = (p) => {
+    const [parent, name] = split(p);
+    ensureNs(parent).add(name);
+    shape.bump();
+  };
+  const unlink = (p) => {
+    const [parent, name] = split(p);
+    kids.get(parent)?.delete(name);
+    shape.bump();
+  };
   const ensureNs = (p) => {
     let set2 = kids.get(p);
     if (!set2) {
       if (leaves.has(p)) dropLeaf(p);
-      kids.set(p, set2 = /* @__PURE__ */ new Set());
-      ensureNs(parentOf(p)).add(nameOf(p));
-      shape.bump();
+      set2 = /* @__PURE__ */ new Set();
+      kids.set(p, set2);
+      link(p);
     }
     return set2;
   };
@@ -27,10 +40,10 @@ const createStore = () => {
     const s = leaves.get(p);
     if (!s) return;
     leaves.delete(p);
-    kids.get(parentOf(p))?.delete(nameOf(p));
+    unlink(p);
     pending.set(p, null);
     s.bump();
-    shape.bump();
+    if (s instanceof Computed) s.dispose();
   };
   const dropNs = (p) => {
     const set2 = kids.get(p);
@@ -38,34 +51,35 @@ const createStore = () => {
     for (const k of [...set2]) remove(join(p, k));
     if (p) {
       kids.delete(p);
-      kids.get(parentOf(p))?.delete(nameOf(p));
       nsCache.delete(p);
+      unlink(p);
     }
-    shape.bump();
   };
   const remove = (p) => batch(() => {
     dropLeaf(p);
     dropNs(p);
   });
   const define = (p, node) => batch(() => {
-    if (kids.has(p)) dropNs(p);
+    dropNs(p);
     const old = leaves.get(p);
     leaves.set(p, node);
-    ensureNs(parentOf(p)).add(nameOf(p));
-    old?.bump();
-    shape.bump();
+    link(p);
+    if (old) {
+      old.bump();
+      if (old instanceof Computed) old.dispose();
+    }
   });
   const set = (p, v) => batch(() => {
     if (v == null) return remove(p);
+    v = (v && rawOf.get(v)) ?? v;
     if (isPlain(v)) {
-      const names = ensureNs(p);
-      for (const k of [...names]) if (!(k in v)) remove(join(p, k));
-      for (const k in v) set(join(p, k), v[k]);
+      for (const k of [...ensureNs(p)]) if (!(k in v)) remove(join(p, k));
+      for (const k in v) if (safeKey(k)) set(join(p, k), v[k]);
       return;
     }
-    if (kids.has(p)) dropNs(p);
+    dropNs(p);
     const s = leaves.get(p);
-    if (s instanceof Computed) throw new Error(`"${p}" is a computed signal and cannot be assigned`);
+    if (s instanceof Computed) throw new Error(`computed "${p}" is read-only`);
     if (s) {
       if (Object.is(s.peek(), v)) return;
       s.value = v;
@@ -76,33 +90,57 @@ const createStore = () => {
   });
   const merge = (patch, { at = "", ifMissing = false } = {}) => batch(() => {
     if (!isPlain(patch)) return;
-    ensureNs(at);
-    for (const k in patch) {
+    const keys = Object.keys(patch).filter(safeKey);
+    if (keys.length) ensureNs(at);
+    for (const k of keys) {
       const p = join(at, k);
       const v = patch[k];
+      const leaf = leaves.get(p);
+      if (leaf && (ifMissing || leaf instanceof Computed)) continue;
       if (v === null) {
         if (!ifMissing) remove(p);
-      } else if (isPlain(v)) {
-        merge(v, { at: p, ifMissing });
-      } else if (!(ifMissing && (leaves.has(p) || kids.has(p))) && !(leaves.get(p) instanceof Computed)) {
-        set(p, v);
-      }
+      } else if (isPlain(v)) merge(v, { at: p, ifMissing });
+      else if (!(ifMissing && kids.has(p))) set(p, v);
     }
   });
+  const has = (p) => leaves.has(p) || kids.has(p);
   const wrapArray = (raw, s, p) => {
-    let px = arrCache.get(raw);
-    if (!px) {
-      const touch = () => {
-        pending.set(p, raw);
-        s.bump();
-      };
-      px = new Proxy(raw, {
-        set: (t, k, v) => (t[k] = v, touch(), true),
-        deleteProperty: (t, k) => (delete t[k], touch(), true)
-      });
-      arrCache.set(raw, px);
+    let cache = proxies.get(s);
+    if (!cache) {
+      cache = /* @__PURE__ */ new WeakMap();
+      proxies.set(s, cache);
     }
-    return px;
+    const touch = () => {
+      pending.set(p, raw);
+      s.bump();
+      return true;
+    };
+    const wrap = (target) => {
+      let px = cache?.get(target);
+      if (!px) {
+        px = new Proxy(target, {
+          get: (t, k, r) => {
+            const v = Reflect.get(t, k, r);
+            if (typeof v === "function" && Array.isArray(t)) return (...a) => batch(() => v.apply(r, a));
+            if (!v || typeof v !== "object" || !(Array.isArray(v) || isPlain(v))) return v;
+            const d = Object.getOwnPropertyDescriptor(t, k);
+            return d && !d.configurable && !d.writable ? v : wrap(v);
+          },
+          set: (t, k, v) => {
+            t[k] = (v && rawOf.get(v)) ?? v;
+            return touch();
+          },
+          deleteProperty: (t, k) => {
+            delete t[k];
+            return touch();
+          }
+        });
+        cache?.set(target, px);
+        rawOf.set(px, target);
+      }
+      return px;
+    };
+    return wrap(raw);
   };
   const get = (p) => {
     const s = leaves.get(p);
@@ -110,51 +148,49 @@ const createStore = () => {
       const v = s.value;
       return Array.isArray(v) ? wrapArray(v, s, p) : v;
     }
-    if (kids.has(p)) return ns(p);
     shape.value;
-    return void 0;
+    if (kids.has(p)) return ns(p);
   };
   const ns = (p) => {
     let px = nsCache.get(p);
     if (!px) {
-      const names = () => (shape.value, kids.get(p));
-      px = new Proxy({}, {
-        get: (_, k) => !str(k) ? void 0 : k === "toJSON" ? () => snapshot(void 0, { at: p }) : get(join(p, k)),
-        set: (_, k, v) => (str(k) && set(join(p, k), v), true),
-        deleteProperty: (_, k) => (str(k) && remove(join(p, k)), true),
-        has: (_, k) => str(k) && !!names()?.has(k),
-        ownKeys: () => [...names() ?? []],
-        getOwnPropertyDescriptor: (_, k) => str(k) && names()?.has(k) ? { enumerable: true, configurable: true, writable: true, value: get(join(p, k)) } : void 0
-      });
+      const names = (k) => {
+        shape.value;
+        return str(k) && !!kids.get(p)?.has(k);
+      };
+      px = new Proxy(
+        {},
+        {
+          get: (_, k) => !str(k) ? void 0 : k === "toJSON" ? () => snapshot(void 0, { at: p }) : get(join(p, k)),
+          set: (_, k, v) => {
+            if (str(k)) set(join(p, k), v);
+            return true;
+          },
+          deleteProperty: (_, k) => {
+            if (str(k)) remove(join(p, k));
+            return true;
+          },
+          has: (_, k) => names(k),
+          ownKeys: () => {
+            shape.value;
+            return [...kids.get(p) ?? []];
+          },
+          getOwnPropertyDescriptor: (_, k) => names(k) ? { enumerable: true, configurable: true, writable: true, value: get(join(p, k)) } : void 0
+        }
+      );
       nsCache.set(p, px);
     }
     return px;
   };
-  const scope = new Proxy({}, {
-    has: (_, k) => str(k) && k[0] === "$",
-    get: (_, k) => !str(k) ? void 0 : k === "$" ? ns("") : get(k.slice(1)),
-    set: (_, k, v) => {
-      if (str(k)) k === "$" ? merge(v) : set(k.slice(1), v);
-      return true;
-    }
-  });
-  const paths = (filter) => {
+  const paths = (filter, { computed = true } = {}) => {
     shape.value;
     const ok = toPredicate(filter);
-    return [...leaves.keys()].filter(ok);
+    return [...leaves].filter(([p, s]) => ok(p) && (computed || !(s instanceof Computed))).map(([p]) => p);
   };
   const snapshot = (filter, { at = "", computed = true } = {}) => {
-    shape.value;
-    const ok = toPredicate(filter);
     const out = {};
-    const rel = (p) => at ? p.slice(at.length + 1) : p;
-    for (const [p, s] of leaves) {
-      if (!under(p, at) || !ok(p) || !computed && s instanceof Computed) continue;
-      expand(out, rel(p), s.value);
-    }
-    for (const p of kids.keys()) {
-      if (p && p !== at && under(p, at) && ok(p) && !kids.get(p).size) expand(out, rel(p), {});
-    }
+    for (const p of paths(filter, { computed }))
+      if (under(p, at)) expand(out, at ? p.slice(at.length + 1) : p, leaves.get(p)?.value);
     return out;
   };
   onSettled(() => {
@@ -169,15 +205,17 @@ const createStore = () => {
     set,
     merge,
     remove,
-    has: (p) => leaves.has(p) || kids.has(p),
+    has,
     define,
     paths,
     snapshot,
-    onPatch: (fn) => (listeners.add(fn), () => listeners.delete(fn)),
+    onPatch: (fn) => {
+      listeners.add(fn);
+      return () => listeners.delete(fn);
+    },
     get $() {
       return ns("");
-    },
-    scope
+    }
   };
 };
 export {