sigmx 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Callum Bonnyman
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,173 @@
+# sigmx
+
+**htmx on steroids, in a runtime smaller than htmx.**
+
+> **Status: an experiment.** sigmx is a personal exploration of what a hypermedia library looks like when it starts from a tiny, plugin-based core. It is inspired by [htmx](https://htmx.org) (the server sends HTML, the browser swaps it in), [Alpine.js](https://alpinejs.dev) (declarative `data-*` attributes with a little reactivity) and [Datastar](https://data-star.dev) (which fused the two and whose attribute syntax sigmx keeps for compatibility). The code is original, the APIs may still change, and it has not been used in production. Try it, break it, and open an issue with what you find.
+
+Your server renders HTML, as it always has. The browser asks for more of it with `@get` and `@post`, and sigmx merges the response into the page with a morph that keeps focus, typed input and scroll position. When you want live updates, the same request can return a stream of patches instead. Signals, two-way binding and reactive attributes cover the client-side state. You write `data-*` attributes and register only the plugins you use.
+
+- **Tiny.** 4.0 KB core, 8.9 KB with the essentials, 12.0 KB with all 52 plugins (brotli). Zero runtime dependencies.
+- **Server-driven.** Return plain HTML from any endpoint and it is morphed into the page by id, or targeted with a header. Return JSON to merge signals, or an event stream to push many patches over one request, with `Last-Event-ID` reconnects.
+- **Reactive where it matters.** Signals declared in markup; `bind`, `show`, `class`, computed values and effects keep the page in step. No component model, no virtual DOM.
+- **Pay for what you use.** Every directive and function is an opt-in plugin, and auto mode scans your source to bundle exactly the set it finds.
+- **Batteries from the ecosystem.** The Alpine plugins (`collapse`, `mask`, `trap`, `teleport`, …) and htmx extensions (`boost`, `ws`, `remove-me`, …) people bolt on are built in as plugins.
+- **Datastar-compatible markup.** Existing Datastar templates run unchanged.
+
+```html
+<div data-signals="{ count: 0, name: '' }">
+  <input data-bind:name placeholder="Your name">
+  <p data-show="$name">Hello, <span data-text="$name"></span>!</p>
+  <button data-on:click="$count++">Clicked <b data-text="$count"></b> times</button>
+  <button data-on:click="@post('/save')" data-indicator:saving data-attr:disabled="$saving">Save</button>
+</div>
+```
+
+## Install
+
+```bash
+npm install sigmx
+```
+
+```ts
+import { createSigmx } from 'sigmx'
+import { essentials } from 'sigmx/presets/essentials'
+
+createSigmx({ plugins: essentials })
+```
+
+Or pick plugins by hand (`sigmx/plugins` is tree-shakeable), use `sigmx/presets/minimal` or `sigmx/presets/all`, let [auto mode](#auto-mode) choose, or drop in the script-tag build:
+
+```html
+<script type="module" src="/sigmx.standalone.js"></script>
+```
+
+Astro users: `npm install sigmx sigmx-astro` and add `sigmx()` to the integrations; see [sdks/astro](sdks/astro).
+
+## How it works
+
+Attributes are `data-<plugin>[:key][__modifier.arg]="expression"`. Expressions are plain JavaScript in which `$name` is a signal:
+
+```html
+<button data-on:click__debounce.300ms="@get('/search')">Search</button>
+<li data-class:active="$page === 3"></li>
+<input data-bind:user.email>
+<p data-text="`${$items.length} items, ${@intl('number', $total, { style: 'currency', currency: 'EUR' })}`"></p>
+```
+
+State is one JSON-like store addressed by dotted paths and patched with merge-patch semantics: objects merge, `null` removes, arrays notify on `push`. Requests send the store (minus `_`-prefixed paths) and apply whatever comes back, decided by the response's content type:
+
+| the server returns | sigmx does |
+|---|---|
+| `text/html` | morphs it into the page: top-level elements by `id`, or a target from the `sigmx-selector` and `sigmx-mode` headers |
+| `application/json` | merges it into the signals |
+| `text/event-stream` | applies each event as it arrives: `patch-elements`, `patch-signals`, or your own handlers |
+
+The everyday case is the first row: render a partial with whatever templating you already use and return it. The morph keeps every element whose id appears on both sides, so a re-rendered form keeps what the user typed. Streams are there for progress, chat and dashboards, where one request should keep delivering:
+
+```
+event: sigmx-patch-signals
+data: signals {"progress": 40}
+
+event: sigmx-patch-elements
+data: selector #log
+data: mode append
+data: elements <li>Validating…</li>
+```
+
+## Plugins
+
+| kind | plugins |
+|---|---|
+| state | `signals` `computed` `effect` `ref` `persist` `query-string` |
+| rendering | `text` `html` `show` `class` `style` `attr` `animate` `transition` `collapse` `view-transition` `cloak` |
+| forms | `bind` `custom-validity` `mask` |
+| events | `on` `init` `on-interval` `on-intersect` `on-resize` `on-raf` `on-signal-patch` `match-media` |
+| layout | `teleport` `trap` `scroll-into-view` `remove-me` |
+| server | `@get` `@post` `@put` `@patch` `@delete` `@ws` `boost` `indicator` `patch-elements` `patch-signals` |
+| utilities | `@peek` `@setAll` `@toggleAll` `@fit` `@clipboard` `@intl` `@dispatch` `@confirm` `json-signals` `replace-url` |
+
+Every plugin has a page in the docs with a live example and its measured size.
+
+## Sizes
+
+Brotli, measured from the real source by `npm run size` and `npm run compare` (nothing is quoted from memory):
+
+| | brotli |
+|---|---:|
+| sigmx core | 4.0 KB |
+| sigmx essentials (state, rendering, forms, requests, morph) | 8.9 KB |
+| sigmx everything, 52 plugins | 12.0 KB |
+| htmx 2.0.10 | 14.6 KB |
+| Datastar 1.0.3, free bundle (23 plugins) | 11.8 KB |
+| Alpine.js 3.17.1 | 17.6 KB |
+
+Precompiling expressions at build time removes the runtime compiler and any use of `new Function`, taking the core to 3.6 KB and making strict CSP trivial.
+
+## Auto mode
+
+Like a CSS framework scanning for class names, sigmx can scan your source for the directives and functions you use and bundle only those, with an allowlist and support for your own plugins:
+
+```js
+// vite.config.js
+import { sigmxAuto } from 'sigmx/vite'
+export default { plugins: [sigmxAuto({ always: ['signals'], custom: { upper: 'src/plugins/upper.ts' } })] }
+```
+
+```ts
+import { createSigmx } from 'sigmx'
+import { plugins } from 'virtual:sigmx-plugins'
+createSigmx({ plugins })
+```
+
+Without Vite: `npx sigmx scan src --out src/sigmx-plugins.js`. In Astro: `sigmx({ plugins: 'auto' })`.
+
+## Writing a plugin
+
+```ts
+import { attribute } from 'sigmx'
+
+export const upper = attribute({
+  name: 'upper',
+  value: 'required',
+  mount({ el, evaluate, effect }) {
+    effect(() => { el.textContent = String(evaluate()).toUpperCase() })
+  },
+})
+```
+
+Plugins are plain objects; nothing registers on import. The mount context gives you `evaluate`, `effect`, `listen`, `cleanup`, the store and the runtime, and everything registered through it is torn down when the attribute or element goes away. Functions (`@name()`) and server-event handlers work the same way with `action()` and `handler()`.
+
+## Documentation
+
+The full documentation, guides and live examples live in [`website/`](website), built with Astro and Starlight:
+
+```bash
+cd website && npm install && npm run dev
+```
+
+## Repository
+
+```
+src/kernel/        reactive graph, store, expression compiler, runtime (DOM-free core)
+src/plugins/       directives, functions, server-event handlers, the morph
+src/presets/       minimal, essentials, all
+sdks/astro/        sigmx-astro: integration, server helpers, auto mode, precompilation
+website/           documentation site
+scripts/           build, size and comparison measurements, dev server
+tests/             node:test suite for the core; browser suite under tests/browser
+```
+
+```bash
+npm install
+npm run check    # type-check
+npm test         # build, then node:test over the DOM-free core
+npm run dev      # dev server with SSE and WebSocket endpoints; open /tests/browser/index.html
+npm run size     # bundle sizes for representative plugin sets
+npm run compare  # sizes of htmx, Datastar and Alpine at pinned versions
+```
+
+Contributions are welcome. Open an issue first for anything larger than a fix, keep plugins as small as their reference-page size table suggests, and run both test suites before a pull request.
+
+## Licence
+
+[MIT](LICENSE). sigmx is an independent implementation: its attribute syntax is compatible with Datastar's public API so that markup can be migrated, and it contains no Datastar code.

package/dist/auto.d.ts

@@ -0,0 +1 @@
+export declare const sigmx: import("./core/types.js").Sigmx;

package/dist/auto.js

@@ -0,0 +1,7 @@
+import { createSigmx } from "./core/index.js";
+import { all } from "./presets/all.js";
+const sigmx = createSigmx({ plugins: all });
+export {
+  sigmx
+};
+//# sourceMappingURL=auto.js.map

package/dist/auto.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/auto.ts"],
+  "sourcesContent": ["// Script-tag entry: registers every plugin and starts on DOM ready.\nimport { createSigmx } from './core/index.js'\nimport { all } from './presets/all.js'\n\nexport const sigmx = createSigmx({ plugins: all })\n"],
+  "mappings": "AACA,SAAS,mBAAmB;AAC5B,SAAS,WAAW;AAEb,MAAM,QAAQ,YAAY,EAAE,SAAS,IAAI,CAAC;",
+  "names": []
+}

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+import { writeFileSync } from "node:fs";
+import { generatePluginsModule } from "./kernel/scan.js";
+import { scanProject } from "./vite.js";
+const args = process.argv.slice(2);
+const cmd = args.shift();
+const opt = (name) => {
+  const i = args.indexOf(`--${name}`);
+  return i < 0 ? void 0 : args.splice(i, 2)[1];
+};
+if (cmd !== "scan") {
+  console.log("usage: sigmx scan [dirs...] [--out src/sigmx-plugins.js] [--always signals,httpGet] [--custom upper=src/plugins/upper.ts] [--prefix data-,hx-]");
+  process.exit(cmd ? 1 : 0);
+}
+const out = opt("out");
+const always = opt("always")?.split(",").filter(Boolean);
+const prefixes = opt("prefix")?.split(",").filter(Boolean);
+const custom = Object.fromEntries((opt("custom")?.split(",") ?? []).map((pair) => pair.split("=")));
+const sel = scanProject({ include: args.length ? args : void 0, always, prefixes, custom });
+const code = generatePluginsModule(sel);
+if (out) {
+  writeFileSync(out, code);
+  console.log(`wrote ${out}: ${sel.plugins.length} plugins, ${sel.unused.length} unused`);
+} else process.stdout.write(code);
+for (const [exp, why] of Object.entries(sel.reasons)) console.error(`  ${exp.padEnd(16)} ${why}`);
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/cli.ts"],
+  "sourcesContent": ["#!/usr/bin/env node\n// `sigmx scan [dirs...] [--out file] [--always a,b] [--custom name=path,...] [--prefix data-,hx-]`\nimport { writeFileSync } from 'node:fs'\nimport { generatePluginsModule } from './kernel/scan.js'\nimport { scanProject } from './vite.js'\n\nconst args = process.argv.slice(2)\nconst cmd = args.shift()\nconst opt = (name: string) => {\n  const i = args.indexOf(`--${name}`)\n  return i < 0 ? undefined : args.splice(i, 2)[1]\n}\nif (cmd !== 'scan') {\n  console.log('usage: sigmx scan [dirs...] [--out src/sigmx-plugins.js] [--always signals,httpGet] [--custom upper=src/plugins/upper.ts] [--prefix data-,hx-]')\n  process.exit(cmd ? 1 : 0)\n}\nconst out = opt('out')\nconst always = opt('always')?.split(',').filter(Boolean)\nconst prefixes = opt('prefix')?.split(',').filter(Boolean)\nconst custom = Object.fromEntries((opt('custom')?.split(',') ?? []).map((pair) => pair.split('=') as [string, string]))\nconst sel = scanProject({ include: args.length ? args : undefined, always, prefixes, custom })\nconst code = generatePluginsModule(sel)\nif (out) {\n  writeFileSync(out, code)\n  console.log(`wrote ${out}: ${sel.plugins.length} plugins, ${sel.unused.length} unused`)\n} else process.stdout.write(code)\nfor (const [exp, why] of Object.entries(sel.reasons)) console.error(`  ${exp.padEnd(16)} ${why}`)\n"],
+  "mappings": ";AAEA,SAAS,qBAAqB;AAC9B,SAAS,6BAA6B;AACtC,SAAS,mBAAmB;AAE5B,MAAM,OAAO,QAAQ,KAAK,MAAM,CAAC;AACjC,MAAM,MAAM,KAAK,MAAM;AACvB,MAAM,MAAM,CAAC,SAAiB;AAC5B,QAAM,IAAI,KAAK,QAAQ,KAAK,IAAI,EAAE;AAClC,SAAO,IAAI,IAAI,SAAY,KAAK,OAAO,GAAG,CAAC,EAAE,CAAC;AAChD;AACA,IAAI,QAAQ,QAAQ;AAClB,UAAQ,IAAI,gJAAgJ;AAC5J,UAAQ,KAAK,MAAM,IAAI,CAAC;AAC1B;AACA,MAAM,MAAM,IAAI,KAAK;AACrB,MAAM,SAAS,IAAI,QAAQ,GAAG,MAAM,GAAG,EAAE,OAAO,OAAO;AACvD,MAAM,WAAW,IAAI,QAAQ,GAAG,MAAM,GAAG,EAAE,OAAO,OAAO;AACzD,MAAM,SAAS,OAAO,aAAa,IAAI,QAAQ,GAAG,MAAM,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,KAAK,MAAM,GAAG,CAAqB,CAAC;AACtH,MAAM,MAAM,YAAY,EAAE,SAAS,KAAK,SAAS,OAAO,QAAW,QAAQ,UAAU,OAAO,CAAC;AAC7F,MAAM,OAAO,sBAAsB,GAAG;AACtC,IAAI,KAAK;AACP,gBAAc,KAAK,IAAI;AACvB,UAAQ,IAAI,SAAS,GAAG,KAAK,IAAI,QAAQ,MAAM,aAAa,IAAI,OAAO,MAAM,SAAS;AACxF,MAAO,SAAQ,OAAO,MAAM,IAAI;AAChC,WAAW,CAAC,KAAK,GAAG,KAAK,OAAO,QAAQ,IAAI,OAAO,EAAG,SAAQ,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC,IAAI,GAAG,EAAE;",
+  "names": []
+}

package/dist/core/csp.d.ts

@@ -0,0 +1,7 @@
+import type { Compiler } from './expr.js';
+/**
+ * Compiler for pages with a strict Content-Security-Policy: compiles through a nonce-bearing
+ * inline `<script>` (and a Trusted Types policy when present) instead of `new Function`.
+ * Pass as `createSigmx({ compile: cspCompiler(nonce) })`.
+ */
+export declare const cspCompiler: (nonce: string) => Compiler;

package/dist/core/csp.js

@@ -0,0 +1,20 @@
+const cspCompiler = (nonce) => {
+  if (!nonce) throw new Error("cspCompiler needs the page nonce");
+  const tt = window.trustedTypes;
+  const policy = tt?.createPolicy("sigmx", { createScript: (s) => s });
+  return (params, body) => {
+    const script = document.createElement("script");
+    script.nonce = nonce;
+    const text = `document.currentScript.f=function(${params.join(",")}){${body}}`;
+    script.text = policy ? policy.createScript(text) : text;
+    document.head.append(script);
+    script.remove();
+    const fn = script.f;
+    if (!fn) throw new Error("the Content-Security-Policy blocked expression compilation");
+    return fn;
+  };
+};
+export {
+  cspCompiler
+};
+//# sourceMappingURL=csp.js.map

package/dist/core/csp.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/core/csp.ts"],
+  "sourcesContent": ["import type { Compiler } from './expr.js'\n\n/**\n * Compiler for pages with a strict Content-Security-Policy: compiles through a nonce-bearing\n * inline `<script>` (and a Trusted Types policy when present) instead of `new Function`.\n * Pass as `createSigmx({ compile: cspCompiler(nonce) })`.\n */\nexport const cspCompiler = (nonce: string): Compiler => {\n  if (!nonce) throw new Error('cspCompiler needs the page nonce')\n  const tt = (window as any).trustedTypes\n  const policy = tt?.createPolicy('sigmx', { createScript: (s: string) => s })\n  return (params, body) => {\n    const script = document.createElement('script')\n    script.nonce = nonce\n    const text = `document.currentScript.f=function(${params.join(',')}){${body}}`\n    script.text = policy ? policy.createScript(text) : text\n    document.head.append(script)\n    script.remove()\n    const fn = (script as any).f\n    if (!fn) throw new Error('the Content-Security-Policy blocked expression compilation')\n    return fn\n  }\n}\n"],
+  "mappings": "AAOO,MAAM,cAAc,CAAC,UAA4B;AACtD,MAAI,CAAC,MAAO,OAAM,IAAI,MAAM,kCAAkC;AAC9D,QAAM,KAAM,OAAe;AAC3B,QAAM,SAAS,IAAI,aAAa,SAAS,EAAE,cAAc,CAAC,MAAc,EAAE,CAAC;AAC3E,SAAO,CAAC,QAAQ,SAAS;AACvB,UAAM,SAAS,SAAS,cAAc,QAAQ;AAC9C,WAAO,QAAQ;AACf,UAAM,OAAO,qCAAqC,OAAO,KAAK,GAAG,CAAC,KAAK,IAAI;AAC3E,WAAO,OAAO,SAAS,OAAO,aAAa,IAAI,IAAI;AACnD,aAAS,KAAK,OAAO,MAAM;AAC3B,WAAO,OAAO;AACd,UAAM,KAAM,OAAe;AAC3B,QAAI,CAAC,GAAI,OAAM,IAAI,MAAM,4DAA4D;AACrF,WAAO;AAAA,EACT;AACF;",
+  "names": []
+}

package/dist/core/engine.d.ts

@@ -0,0 +1,10 @@
+import type { Mods, Sigmx, SigmxOptions } from './types.js';
+type Parsed = {
+    plugin: string;
+    key: string | undefined;
+    mods: Mods;
+};
+/** 'on:click__debounce.300ms__prevent' → { plugin: 'on', key: 'click', mods: {debounce: ['300ms'], prevent: []} } */
+export declare const parseAttr: (raw: string) => Parsed;
+export declare const createSigmx: (options?: SigmxOptions) => Sigmx;
+export {};

package/dist/core/engine.js

@@ -0,0 +1,200 @@
+import { compile, functionCompiler } from "./expr.js";
+import { effect } from "./signals.js";
+import { createStore } from "./store.js";
+import { recase } from "../utils/text.js";
+const isEl = (n) => n instanceof HTMLElement || n instanceof SVGElement || n instanceof MathMLElement;
+const parsed = /* @__PURE__ */ new Map();
+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 fail = (message, info) => Object.assign(new Error(message), { info });
+const createSigmx = (options = {}) => {
+  const prefixes = [].concat(options.prefix ?? "data-");
+  const store = options.store ?? createStore();
+  const compiler = options.compile ?? functionCompiler;
+  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,
+    emit: (type, detail) => document.dispatchEvent(new CustomEvent(`sigmx-${type}`, { detail })),
+    call: (name, ctx, args) => {
+      const a = actions[name];
+      if (!a) throw ctx.error(`unknown action @${name}`);
+      return a.call(ctx, ...args);
+    },
+    attributes,
+    actions,
+    handlers
+  };
+  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 unmount = (els) => {
+    for (const el of els) {
+      const m = mounted.get(el);
+      if (m && mounted.delete(el)) for (const d of m.values()) d();
+    }
+  };
+  const unmountAttr = (el, attr) => {
+    const m = mounted.get(el);
+    m?.get(attr)?.();
+    m?.delete(attr);
+  };
+  const actionsFor = (el, evt, error) => {
+    const ctx = { el, evt, store, runtime, error };
+    return new Proxy(/* @__PURE__ */ Object.create(null), { get: (_, name) => (...args) => runtime.call(name, ctx, args) });
+  };
+  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 info = { plugin: name, el, attr };
+    const error = (message, extra) => fail(`${prefixes[0]}${name}: ${message}`, { ...info, ...extra });
+    const report = (e) => onError(e, info);
+    let fn;
+    const ctx = {
+      el,
+      plugin: name,
+      attr,
+      key,
+      value,
+      mods,
+      cased: (style = "camel") => recase(key ?? "", mods.get("case")?.[0] || style),
+      evaluate: (evt, ...args) => {
+        fn ??= compile(compiler, value, ["el", "evt", ...plugin.args ?? []], plugin.returns ?? true);
+        return fn(store.scope, actionsFor(el, evt, error), el, evt, ...args);
+      },
+      effect: (f) => disposers.push(effect(f, report)),
+      listen: (target, type, f, opts) => {
+        const h = (e) => {
+          try {
+            f(e);
+          } catch (err) {
+            report(err);
+          }
+        };
+        target.addEventListener(type, h, opts);
+        disposers.push(() => target.removeEventListener(type, h, opts));
+      },
+      cleanup: (f) => disposers.push(f),
+      error,
+      store,
+      runtime
+    };
+    let m = mounted.get(el);
+    if (!m) mounted.set(el, m = /* @__PURE__ */ new Map());
+    m.set(attr, () => {
+      for (const d of disposers.splice(0)) d();
+    });
+    try {
+      if (plugin.key === "required" && !key) throw error("needs a key, e.g. :name");
+      if (plugin.key === "forbidden" && key) throw error("does not take a key");
+      if (plugin.value === "required" && !value) throw error("needs a value");
+      if (plugin.value === "forbidden" && value) throw error("does not take a value");
+      const r = plugin.mount(ctx);
+      if (typeof r === "function") disposers.push(r);
+    } catch (e) {
+      report(e);
+    }
+  };
+  const mountEls = (els, only) => {
+    for (const el of els) {
+      if (ignored(el)) continue;
+      for (const { name, value } of [...el.attributes]) {
+        const raw = strip(name);
+        if (raw) mount(el, name, raw, value, only);
+      }
+    }
+  };
+  const observer = new MutationObserver((records) => {
+    for (const { type, target, attributeName, addedNodes, removedNodes } of records) {
+      if (type === "childList") {
+        for (const n of removedNodes) if (isEl(n)) unmount([n, ...n.querySelectorAll("*")]);
+        for (const n of addedNodes) if (isEl(n)) mountEls([n, ...n.querySelectorAll("*")]);
+      } else if (attributeName && isEl(target) && !ignored(target)) {
+        const raw = strip(attributeName);
+        if (!raw) continue;
+        const value = target.getAttribute(attributeName);
+        if (value === null) unmountAttr(target, attributeName);
+        else mount(target, attributeName, raw, value);
+      }
+    }
+  });
+  let ready = false;
+  const apply = (root = document.documentElement, observe = true, only) => {
+    mountEls([...isEl(root) ? [root] : [], ...root.querySelectorAll("*")], 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;
+    }
+    if (added.size) for (const r of roots) apply(r, false, added);
+  };
+  const stopPatches = store.onPatch((patch) => runtime.emit("signal-patch", patch));
+  use(...options.plugins ?? []);
+  const sigmx = {
+    runtime,
+    store,
+    get $() {
+      return store.$;
+    },
+    apply: (root, observe) => apply(root, observe),
+    use,
+    destroy: () => {
+      observer.disconnect();
+      stopPatches();
+      unmount([...mounted.keys()]);
+      roots.clear();
+    }
+  };
+  if (options.autoStart ?? true) {
+    if (document.readyState === "loading") {
+      document.addEventListener("DOMContentLoaded", () => sigmx.apply(), { once: true });
+    } else {
+      sigmx.apply();
+    }
+  }
+  return sigmx;
+};
+export {
+  createSigmx,
+  parseAttr
+};
+//# sourceMappingURL=engine.js.map

package/dist/core/engine.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/core/engine.ts"],
+  "sourcesContent": ["import { compile, functionCompiler } from './expr.js'\nimport { effect } from './signals.js'\nimport { createStore } from './store.js'\nimport type { ActionCtx, AttributePlugin, Ctx, El, Mods, Plugin, Runtime, Sigmx, SigmxOptions } from './types.js'\nimport { recase, type CaseStyle } from '../utils/text.js'\n\nconst isEl = (n: Node): n is El => n instanceof HTMLElement || n instanceof SVGElement || n instanceof MathMLElement\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\nexport const createSigmx = (options: SigmxOptions = {}): Sigmx => {\n  const prefixes = ([] as string[]).concat(options.prefix ?? 'data-')\n  const store = options.store ?? createStore()\n  const compiler = options.compile ?? functionCompiler\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    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']) => {\n    const ctx: ActionCtx = { el, evt, store, runtime, error }\n    return new Proxy(Object.create(null), { 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: ((...args: any[]) => any) | 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 ??= compile(compiler, value, ['el', 'evt', ...(plugin.args ?? [])], plugin.returns ?? true)\n        return fn(store.scope, actionsFor(el, evt, error), 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, e.g. :name')\n      if (plugin.key === 'forbidden' && key) throw error('does not take a key')\n      if (plugin.value === 'required' && !value) throw error('needs a value')\n      if (plugin.value === 'forbidden' && value) throw error('does not take a 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) if (isEl(n)) unmount([n, ...n.querySelectorAll<El>('*')])\n        for (const n of addedNodes) if (isEl(n)) mountEls([n, ...n.querySelectorAll<El>('*')])\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([...(isEl(root) ? [root] : []), ...root.querySelectorAll<El>('*')], 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": []
+}

package/dist/core/expr.d.ts

@@ -0,0 +1,12 @@
+export type Compiler = (params: string[], body: string) => (...args: any[]) => any;
+/** Default compiler: `new Function`. Not usable under a strict CSP; see `cspCompiler`. */
+export declare const functionCompiler: Compiler;
+/** Replace `@name(` with `__a.name(` outside strings and comments. */
+export declare const rewriteActions: (src: string) => string;
+/** Split on top-level semicolons. */
+export declare const splitStatements: (src: string) => string[];
+/**
+ * Compile an expression to `(scope, actions, ...params) => any`. With `returns`, the value of the
+ * last statement is returned, so `$a = 1; $a * 2` works. Compiled functions are cached by source.
+ */
+export declare const compile: (compiler: Compiler, src: string, params: string[], returns: boolean) => ((...args: any[]) => any);

package/dist/core/expr.js

@@ -0,0 +1,94 @@
+const functionCompiler = (params, body) => Function(...params, body);
+const cache = /* @__PURE__ */ new Map();
+const isIdent = (c) => /[A-Za-z0-9_$]/.test(c);
+const scan = (src, onCode) => {
+  let i = 0;
+  const n = src.length;
+  while (i < n) {
+    const c = src[i];
+    const next = src[i + 1];
+    if (c === '"' || c === "'" || c === "`") {
+      let j = i + 1;
+      while (j < n && src[j] !== c) j += src[j] === "\\" ? 2 : 1;
+      onCode(src.slice(i, j + 1), i);
+      i = j + 1;
+    } else if (c === "/" && next === "/") {
+      const j = src.indexOf("\n", i);
+      i = j < 0 ? n : j;
+    } else if (c === "/" && next === "*") {
+      const j = src.indexOf("*/", i + 2);
+      i = j < 0 ? n : j + 2;
+    } else {
+      const skip = onCode(c, i);
+      i += skip || 1;
+    }
+  }
+};
+const rewriteActions = (src) => {
+  let out = "";
+  scan(src, (c, i) => {
+    if (c === "@") {
+      let j = i + 1;
+      while (j < src.length && isIdent(src[j])) j++;
+      let k = j;
+      while (k < src.length && /\s/.test(src[k])) k++;
+      if (j > i + 1 && src[k] === "(") {
+        out += `__a.${src.slice(i + 1, j)}(`;
+        return k + 1 - i;
+      }
+    }
+    out += c;
+  });
+  return out;
+};
+const splitStatements = (src) => {
+  const parts = [];
+  let depth = 0;
+  let start = 0;
+  scan(src, (c, i) => {
+    if (c.length > 1) return;
+    if ("([{".includes(c)) depth++;
+    else if (")]}".includes(c)) depth--;
+    else if (c === ";" && !depth) {
+      parts.push(src.slice(start, i));
+      start = i + 1;
+    }
+  });
+  parts.push(src.slice(start));
+  return parts.filter((p) => p.trim());
+};
+const compile = (compiler, src, params, returns) => {
+  const key = `${+returns}|${params.join()}|${src}`;
+  const hit = cache.get(key);
+  if (hit) return hit;
+  const code = rewriteActions(src.trim());
+  const make = (body) => compiler(["$", "__a", ...params], `with($){${body}
+}`);
+  let fn;
+  if (!returns) {
+    fn = make(code);
+  } else {
+    try {
+      fn = make(`return(${code}
+)`);
+    } catch {
+      const parts = splitStatements(code);
+      const last = parts.pop() ?? "";
+      try {
+        fn = make(`${parts.join(";")};return(${last}
+)`);
+      } catch {
+        fn = make(code);
+      }
+    }
+  }
+  cache.set(key, fn);
+  return fn;
+};
+export {
+  compile,
+  functionCompiler,
+  rewriteActions,
+  splitStatements
+};
+//# sourceMappingURL=expr.js.map