@tinyactors/scxmljs 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (89) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +174 -0
  3. package/THIRD_PARTY_NOTICES +63 -0
  4. package/dist/bridge.d.ts +44 -0
  5. package/dist/bridge.js +254 -0
  6. package/dist/bridge.js.map +1 -0
  7. package/dist/clock.d.ts +113 -0
  8. package/dist/clock.js +310 -0
  9. package/dist/clock.js.map +1 -0
  10. package/dist/common.d.ts +15 -0
  11. package/dist/common.js +14 -0
  12. package/dist/common.js.map +1 -0
  13. package/dist/datamodel-base.d.ts +122 -0
  14. package/dist/datamodel-base.js +268 -0
  15. package/dist/datamodel-base.js.map +1 -0
  16. package/dist/datamodel-quickjs.d.ts +21 -0
  17. package/dist/datamodel-quickjs.js +286 -0
  18. package/dist/datamodel-quickjs.js.map +1 -0
  19. package/dist/datamodel-trusted.d.ts +1 -0
  20. package/dist/datamodel-trusted.js +149 -0
  21. package/dist/datamodel-trusted.js.map +1 -0
  22. package/dist/diagnostics.d.ts +39 -0
  23. package/dist/diagnostics.js +154 -0
  24. package/dist/diagnostics.js.map +1 -0
  25. package/dist/element-events.d.ts +85 -0
  26. package/dist/element-events.js +129 -0
  27. package/dist/element-events.js.map +1 -0
  28. package/dist/events.d.ts +31 -0
  29. package/dist/events.js +33 -0
  30. package/dist/events.js.map +1 -0
  31. package/dist/explorer/element.d.ts +150 -0
  32. package/dist/explorer/element.js +1791 -0
  33. package/dist/explorer/element.js.map +1 -0
  34. package/dist/explorer/layout.d.ts +43 -0
  35. package/dist/explorer/layout.js +50 -0
  36. package/dist/explorer/layout.js.map +1 -0
  37. package/dist/explorer/strings.d.ts +275 -0
  38. package/dist/explorer/strings.js +135 -0
  39. package/dist/explorer/strings.js.map +1 -0
  40. package/dist/explorer/styles.d.ts +10 -0
  41. package/dist/explorer/styles.js +265 -0
  42. package/dist/explorer/styles.js.map +1 -0
  43. package/dist/explorer/viewmodel.d.ts +284 -0
  44. package/dist/explorer/viewmodel.js +481 -0
  45. package/dist/explorer/viewmodel.js.map +1 -0
  46. package/dist/explorer.d.ts +21 -0
  47. package/dist/explorer.js +22 -0
  48. package/dist/explorer.js.map +1 -0
  49. package/dist/index.d.ts +34 -0
  50. package/dist/index.js +39 -0
  51. package/dist/index.js.map +1 -0
  52. package/dist/model.d.ts +157 -0
  53. package/dist/model.js +485 -0
  54. package/dist/model.js.map +1 -0
  55. package/dist/session-events.d.ts +136 -0
  56. package/dist/session-events.js +114 -0
  57. package/dist/session-events.js.map +1 -0
  58. package/dist/session.d.ts +412 -0
  59. package/dist/session.js +1399 -0
  60. package/dist/session.js.map +1 -0
  61. package/dist/themes/tinyactors.css +44 -0
  62. package/dist/trusted.d.ts +15 -0
  63. package/dist/trusted.js +30 -0
  64. package/dist/trusted.js.map +1 -0
  65. package/dist/ui/announcer.d.ts +22 -0
  66. package/dist/ui/announcer.js +31 -0
  67. package/dist/ui/announcer.js.map +1 -0
  68. package/dist/ui/svg.d.ts +8 -0
  69. package/dist/ui/svg.js +29 -0
  70. package/dist/ui/svg.js.map +1 -0
  71. package/dist/ui/theme.d.ts +34 -0
  72. package/dist/ui/theme.js +151 -0
  73. package/dist/ui/theme.js.map +1 -0
  74. package/dist/view/element.d.ts +172 -0
  75. package/dist/view/element.js +1045 -0
  76. package/dist/view/element.js.map +1 -0
  77. package/dist/view/layout.d.ts +154 -0
  78. package/dist/view/layout.js +1122 -0
  79. package/dist/view/layout.js.map +1 -0
  80. package/dist/view/strings.d.ts +72 -0
  81. package/dist/view/strings.js +48 -0
  82. package/dist/view/strings.js.map +1 -0
  83. package/dist/view/styles.d.ts +1 -0
  84. package/dist/view/styles.js +115 -0
  85. package/dist/view/styles.js.map +1 -0
  86. package/dist/view.d.ts +20 -0
  87. package/dist/view.js +21 -0
  88. package/dist/view.js.map +1 -0
  89. package/package.json +87 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"datamodel-quickjs.js","sourceRoot":"","sources":["../src/datamodel-quickjs.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The sandboxed engine for the ECMAScript data model: one QuickJS context\n * (WebAssembly) per session. Semantics live in datamodel-base.ts.\n *\n * Why a separate engine: the spec's scoping rules need a real global scope per\n * session. `<script>` runs as a global script (so `var` and function\n * declarations persist), `<data>` ids become global variables, system\n * variables are read-only (assigning one raises `error.execution`), and\n * sessions cannot see each other or the host page.\n *\n * Values cross the boundary as plain data (JSON-like, plus `undefined`):\n * event payloads go in, send payloads / logs / snapshots come out. Anything\n * that stays inside (assign, foreach, data expressions) is never marshalled,\n * so functions and object identity survive.\n */\n\n// the WebAssembly is inlined, so bundlers and browsers need no extra asset\nimport variant from \"@jitl/quickjs-singlefile-browser-release-sync\";\nimport { newQuickJSWASMModuleFromVariant, type QuickJSContext, type QuickJSHandle, type QuickJSWASMModule } from \"quickjs-emscripten-core\";\nimport {\n DataModelError,\n type DataModelFactory,\n type DataModelOptions,\n EVENT_SETTER_SOURCE,\n eventObject,\n isDomNode,\n PLAIN_DATA_SOURCE,\n ScriptDataModel,\n SYSTEM_VARIABLES_SOURCE,\n systemVariableValues,\n} from \"./datamodel-base.ts\";\nimport type { SCXMLEvent } from \"./events.ts\";\n\nlet modulePromise: Promise<QuickJSWASMModule> | undefined;\nlet moduleSync: QuickJSWASMModule | undefined;\n\n/**\n * Loads the QuickJS WebAssembly module (once; later calls return the same\n * promise). `createSession` does this for you; await it yourself before\n * constructing `Session`s directly.\n */\nexport function loadQuickJS(): Promise<void> {\n modulePromise ??= newQuickJSWASMModuleFromVariant(variant).then((m) => (moduleSync = m));\n return modulePromise.then(() => {});\n}\n\n/** @internal */\nexport function quickJSModule(): QuickJSWASMModule {\n if (!moduleSync) throw new Error(\"QuickJS is not loaded yet: await loadQuickJS() (createSession does this for you)\");\n return moduleSync;\n}\n\n/**\n * The sandboxed ECMAScript data model: one QuickJS context per session.\n * @internal\n */\nexport class QuickJSDataModel extends ScriptDataModel {\n private vm: QuickJSContext;\n private setEventFn: QuickJSHandle;\n private plainFn: QuickJSHandle;\n private deadline = 0;\n private timeoutMs: number;\n private disposed = false;\n\n constructor(opts: DataModelOptions) {\n super();\n this.timeoutMs = opts.timeoutMs ?? 2000;\n this.vm = quickJSModule().newContext();\n const rt = this.vm.runtime;\n rt.setMemoryLimit(opts.memoryLimitBytes ?? 64 * 1024 * 1024);\n rt.setMaxStackSize(1024 * 1024);\n rt.setInterruptHandler(() => Date.now() > this.deadline);\n\n const inFn = this.vm.newFunction(\"In\", (h) => (opts.In(this.vm.getString(h)) ? this.vm.true : this.vm.false));\n this.vm.setProp(this.vm.global, \"In\", inFn);\n inFn.dispose();\n\n const install = this.evalHandle(SYSTEM_VARIABLES_SOURCE);\n const values = this.toVm(systemVariableValues(opts));\n const r = this.vm.callFunction(install, this.vm.undefined, values);\n values.dispose();\n install.dispose();\n if (r.error) {\n const err = this.describe(r.error);\n r.error.dispose();\n throw new DataModelError(err);\n }\n r.value.dispose();\n this.run(MINI_DOM);\n this.setEventFn = this.evalHandle(EVENT_SETTER_SOURCE);\n this.plainFn = this.evalHandle(PLAIN_DATA_SOURCE);\n }\n\n dispose() {\n if (this.disposed) return;\n this.disposed = true;\n this.setEventFn.dispose();\n this.plainFn.dispose();\n this.vm.dispose();\n }\n\n setEvent(ev: SCXMLEvent) {\n const h = this.toVm(eventObject(ev));\n const r = this.vm.callFunction(this.setEventFn, this.vm.undefined, h);\n h.dispose();\n if (r.error) r.error.dispose();\n else r.value.dispose();\n }\n\n // ─────────────────────────── engine primitives ───────────────────────────\n\n protected run(code: string) {\n this.evalHandle(code).dispose();\n }\n\n protected read(code: string): unknown {\n const h = this.evalHandle(code);\n try {\n // converted to plain data inside the engine first (see plainData), then copied out\n this.deadline = Date.now() + this.timeoutMs;\n const r = this.vm.callFunction(this.plainFn, this.vm.undefined, h);\n if (r.error) {\n r.error.dispose();\n return undefined;\n }\n try {\n return this.dump(r.value);\n } finally {\n r.value.dispose();\n }\n } finally {\n h.dispose();\n }\n }\n\n protected setGlobal(name: string, value: unknown) {\n const h = this.toVm(value);\n this.vm.setProp(this.vm.global, name, h);\n h.dispose();\n }\n\n protected setGlobalFromExpr(name: string, code: string) {\n const h = this.evalHandle(code);\n this.vm.setProp(this.vm.global, name, h);\n h.dispose();\n }\n\n private evalHandle(code: string): QuickJSHandle {\n this.deadline = Date.now() + this.timeoutMs;\n const r = this.vm.evalCode(code, \"scxml.js\");\n if (r.error) {\n const err = this.describe(r.error);\n r.error.dispose();\n throw new DataModelError(err);\n }\n return r.value;\n }\n\n private describe(h: QuickJSHandle): string {\n try {\n const e = this.vm.dump(h);\n if (e && typeof e === \"object\" && \"message\" in e) {\n const err = e as { name?: string; message: unknown };\n return `${err.name ?? \"Error\"}: ${err.message}`;\n }\n return String(e);\n } catch {\n return \"error\";\n }\n }\n\n private dump(h: QuickJSHandle): unknown {\n try {\n return this.vm.dump(h);\n } catch {\n return undefined;\n }\n }\n\n // ─────────────────────────── marshalling ─────────────────────────────\n\n /** Host value → engine value. A reference back into its own ancestors (a cycle) becomes `undefined`, as in the trusted engine. */\n private toVm(value: unknown, depth = 0, ancestors: object[] = []): QuickJSHandle {\n const vm = this.vm;\n if (depth > 64) return vm.undefined;\n switch (typeof value) {\n case \"undefined\":\n return vm.undefined;\n case \"boolean\":\n return value ? vm.true : vm.false;\n case \"number\":\n return vm.newNumber(value);\n case \"bigint\":\n return vm.newBigInt(value);\n case \"string\":\n return vm.newString(value);\n case \"object\": {\n if (value === null) return vm.null;\n if (ancestors.includes(value)) return vm.undefined;\n if (value instanceof Date) return vm.newNumber(value.getTime());\n if (isDomNode(value)) return this.evalHandle(`__scxml_xml(${JSON.stringify(domTree(value))})`);\n ancestors.push(value);\n try {\n if (Array.isArray(value)) {\n const arr = vm.newArray();\n value.forEach((v, i) => {\n const h = this.toVm(v, depth + 1, ancestors);\n vm.setProp(arr, i, h);\n h.dispose();\n });\n return arr;\n }\n const obj = vm.newObject();\n for (const [k, v] of Object.entries(value as Record<string, unknown>)) {\n const h = this.toVm(v, depth + 1, ancestors);\n vm.setProp(obj, k, h);\n h.dispose();\n }\n return obj;\n } finally {\n ancestors.pop();\n }\n }\n default:\n return vm.undefined; // functions and symbols do not cross the boundary\n }\n }\n}\n\n/**\n * Factory for the sandboxed data model. QuickJS must be loaded (`await loadQuickJS()`).\n * @internal\n */\nexport const sandboxedDataModel: DataModelFactory = (opts) => new QuickJSDataModel(opts);\n\ninterface XmlTree {\n t: \"e\" | \"x\";\n n?: string;\n p?: string | null;\n ns?: string | null;\n a?: [string, string][];\n c?: XmlTree[];\n v?: string;\n}\n\n/** Host DOM → plain tree, rebuilt as a DOM inside the sandbox by MINI_DOM. */\nfunction domTree(node: Node): XmlTree {\n if (node.nodeType === 9) return domTree((node as Document).documentElement);\n if (node.nodeType !== 1) return { t: \"x\", v: node.nodeValue ?? \"\" };\n const el = node as Element;\n return {\n t: \"e\",\n n: el.localName,\n p: el.prefix,\n ns: el.namespaceURI,\n a: Array.from(el.attributes).map((a) => [a.name, a.value]),\n c: Array.from(el.childNodes)\n .filter((c) => c.nodeType === 1 || c.nodeType === 3 || c.nodeType === 4)\n .map(domTree),\n };\n}\n\n/**\n * A small XML DOM for the sandbox (spec B.2: XML data values are DOM objects).\n * Values are Documents; they serialise back to XML text when they leave the\n * sandbox (toJSON) or are converted to strings.\n */\nconst MINI_DOM = `\nvar __scxml_xml = (function () {\n function esc(s) { return String(s).replace(/&/g, \"&amp;\").replace(/</g, \"&lt;\").replace(/\"/g, \"&quot;\"); }\n function Text(v, parent) { this.nodeType = 3; this.nodeName = \"#text\"; this.nodeValue = this.data = v; this.parentNode = parent; this.childNodes = []; }\n Object.defineProperty(Text.prototype, \"textContent\", { get: function () { return this.nodeValue; } });\n Text.prototype.serialize = function () { return esc(this.nodeValue).replace(/\"/g, '\"'); };\n function Element(t, parent) {\n var self = this;\n this.nodeType = 1; this.localName = t.n; this.prefix = t.p || null; this.namespaceURI = t.ns || null;\n this.nodeName = this.tagName = t.p ? t.p + \":\" + t.n : t.n; this.parentNode = parent || null;\n this.attributes = t.a.map(function (a) { return { name: a[0], nodeName: a[0], value: a[1], nodeValue: a[1] }; });\n this.childNodes = t.c.map(function (c) { return c.t === \"e\" ? new Element(c, self) : new Text(c.v, self); });\n }\n var E = Element.prototype;\n Object.defineProperty(E, \"children\", { get: function () { return this.childNodes.filter(function (c) { return c.nodeType === 1; }); } });\n Object.defineProperty(E, \"firstChild\", { get: function () { return this.childNodes[0] || null; } });\n Object.defineProperty(E, \"lastChild\", { get: function () { return this.childNodes[this.childNodes.length - 1] || null; } });\n Object.defineProperty(E, \"firstElementChild\", { get: function () { return this.children[0] || null; } });\n Object.defineProperty(E, \"textContent\", { get: function () { return this.childNodes.map(function (c) { return c.textContent; }).join(\"\"); } });\n E.getAttribute = function (n) { for (var i = 0; i < this.attributes.length; i++) if (this.attributes[i].name === n) return this.attributes[i].value; return null; };\n E.hasAttribute = function (n) { return this.getAttribute(n) !== null; };\n E.setAttribute = function (n, v) { v = String(v); for (var i = 0; i < this.attributes.length; i++) if (this.attributes[i].name === n) { this.attributes[i].value = this.attributes[i].nodeValue = v; return; } this.attributes.push({ name: n, nodeName: n, value: v, nodeValue: v }); };\n E.getElementsByTagName = function (name) {\n var out = [];\n (function walk(e) { e.children.forEach(function (c) { if (name === \"*\" || c.nodeName === name || c.localName === name) out.push(c); walk(c); }); })(this);\n return out;\n };\n E.serialize = function (parentNs) {\n var self = this;\n var a = this.attributes.map(function (x) { return \" \" + x.name + '=\"' + esc(x.value) + '\"'; }).join(\"\");\n // declare the default namespace where it changes (it may have been inherited in the source)\n if (!this.prefix && (this.namespaceURI || null) !== (parentNs === undefined ? null : parentNs) && !this.hasAttribute(\"xmlns\"))\n a = ' xmlns=\"' + esc(this.namespaceURI || \"\") + '\"' + a;\n var body = this.childNodes.map(function (c) { return c.serialize(self.namespaceURI || null); }).join(\"\");\n return \"<\" + this.nodeName + a + (body ? \">\" + body + \"</\" + this.nodeName + \">\" : \"/>\");\n };\n E.toString = E.toJSON = function () { return this.serialize(); };\n function Doc(root) { this.nodeType = 9; this.nodeName = \"#document\"; this.documentElement = root; this.childNodes = [root]; root.parentNode = this; }\n Doc.prototype.getElementsByTagName = function (name) {\n var r = this.documentElement;\n return (name === \"*\" || r.nodeName === name || r.localName === name ? [r] : []).concat(r.getElementsByTagName(name));\n };\n Doc.prototype.toString = Doc.prototype.toJSON = function () { return this.documentElement.serialize(); };\n Object.defineProperty(Doc.prototype, \"textContent\", { get: function () { return this.documentElement.textContent; } });\n return function (tree) { return tree.t === \"e\" ? new Doc(new Element(tree)) : tree.v; };\n})();\n`;\n"]}
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,149 @@
1
+ /**
2
+ * The trusted engine for the ECMAScript data model: the host's own JavaScript
3
+ * engine, in a separate realm per session — no WebAssembly download.
4
+ *
5
+ * Each session still gets its own global scope, which the spec's semantics
6
+ * need (`<script>` declarations persist, sessions — including invoked
7
+ * children — don't share variables, system variables are read-only):
8
+ *
9
+ * - in browsers: a hidden same-origin <iframe>; code runs through the
10
+ * iframe's own `eval`, i.e. as a global script of that window.
11
+ * - in Bun / Node: a `node:vm` context (reached via process.getBuiltinModule,
12
+ * so browser bundles never see a Node import).
13
+ *
14
+ * TRUSTED means: the chart can reach the host (the iframe has `parent`, a vm
15
+ * context is not a security boundary), can't be interrupted when it loops, and
16
+ * needs `eval` to be allowed by the page's Content-Security-Policy. Use it for
17
+ * charts you (or your build) authored; use the sandboxed default for anything
18
+ * a user typed or uploaded.
19
+ */
20
+ import { DataModelError, EVENT_SETTER_SOURCE, eventObject, isDomNode, plainData, ScriptDataModel, SYSTEM_VARIABLES_SOURCE, systemVariableValues, } from "./datamodel-base.js";
21
+ const XHTML_NS = "http://www.w3.org/1999/xhtml";
22
+ function createRealm() {
23
+ const doc = globalThis.document;
24
+ const parent = doc?.body ?? doc?.documentElement;
25
+ if (doc && parent && typeof doc.createElementNS === "function") {
26
+ // createElementNS: works in HTML pages and in XML documents (e.g. a raw .scxml file)
27
+ const iframe = doc.createElementNS(XHTML_NS, "iframe");
28
+ iframe.setAttribute("aria-hidden", "true");
29
+ iframe.setAttribute("tabindex", "-1");
30
+ iframe.style.display = "none"; // CSSOM, not a style attribute: allowed by a strict style-src
31
+ iframe.setAttribute("data-scxml-realm", "");
32
+ parent.appendChild(iframe);
33
+ const win = iframe.contentWindow;
34
+ if (win && typeof win.eval === "function") {
35
+ return {
36
+ global: win,
37
+ // a method call of another realm's eval is an indirect eval: global scope of that window
38
+ evaluate: (code) => win.eval(code),
39
+ dispose: () => iframe.remove(),
40
+ };
41
+ }
42
+ iframe.remove();
43
+ }
44
+ const vm = globalThis.process?.getBuiltinModule?.("node:vm");
45
+ if (vm?.createContext) {
46
+ const context = vm.createContext({});
47
+ return {
48
+ global: vm.runInContext("globalThis", context),
49
+ evaluate: (code) => vm.runInContext(code, context, { filename: "scxml.js" }),
50
+ dispose: () => { },
51
+ };
52
+ }
53
+ throw new Error("trusted data model: needs a DOM document (for an iframe realm) or node:vm");
54
+ }
55
+ /**
56
+ * The trusted ECMAScript data model.
57
+ * @internal
58
+ */
59
+ export class TrustedDataModel extends ScriptDataModel {
60
+ realm;
61
+ setEventFn;
62
+ disposed = false;
63
+ constructor(opts) {
64
+ super();
65
+ this.realm = createRealm();
66
+ this.realm.global.In = (id) => opts.In(String(id));
67
+ const install = this.evaluateRaw(SYSTEM_VARIABLES_SOURCE);
68
+ install(this.copyIn(systemVariableValues(opts)));
69
+ this.setEventFn = this.evaluateRaw(EVENT_SETTER_SOURCE);
70
+ }
71
+ dispose() {
72
+ if (this.disposed)
73
+ return;
74
+ this.disposed = true;
75
+ this.realm.dispose();
76
+ }
77
+ setEvent(ev) {
78
+ this.setEventFn(this.copyIn(eventObject(ev)));
79
+ }
80
+ // ─────────────────────────── engine primitives ───────────────────────────
81
+ run(code) {
82
+ this.evaluateRaw(code);
83
+ }
84
+ read(code) {
85
+ return plainData(this.evaluateRaw(code), isDomNode); // DOM values stay real nodes here
86
+ }
87
+ setGlobal(name, value) {
88
+ this.realm.global[name] = this.copyIn(value);
89
+ }
90
+ setGlobalFromExpr(name, code) {
91
+ this.realm.global[name] = this.evaluateRaw(code);
92
+ }
93
+ evaluateRaw(code) {
94
+ try {
95
+ return this.realm.evaluate(code);
96
+ }
97
+ catch (e) {
98
+ throw new DataModelError(describe(e));
99
+ }
100
+ }
101
+ // ─────────────────────────── marshalling ─────────────────────────────
102
+ /**
103
+ * Host value → a fresh copy built from the realm's own constructors, so the
104
+ * chart never shares mutable objects with the host (or with another
105
+ * session) and `instanceof Array/Object` work inside the chart.
106
+ */
107
+ copyIn(value, depth = 0, seen = new Set()) {
108
+ if (typeof value === "function" || typeof value === "symbol")
109
+ return undefined;
110
+ if (typeof value !== "object" || value === null)
111
+ return value;
112
+ if (depth > 64 || seen.has(value))
113
+ return undefined;
114
+ if (isDomNode(value))
115
+ return value.cloneNode(true); // XML values are real DOM here
116
+ if (value instanceof Date)
117
+ return value.getTime(); // same as the sandboxed engine
118
+ seen.add(value);
119
+ const g = this.realm.global;
120
+ try {
121
+ if (Array.isArray(value)) {
122
+ const arr = new g.Array();
123
+ value.forEach((v, i) => {
124
+ arr[i] = this.copyIn(v, depth + 1, seen);
125
+ });
126
+ return arr;
127
+ }
128
+ const obj = new g.Object();
129
+ for (const [k, v] of Object.entries(value))
130
+ obj[k] = this.copyIn(v, depth + 1, seen);
131
+ return obj;
132
+ }
133
+ finally {
134
+ seen.delete(value);
135
+ }
136
+ }
137
+ }
138
+ function describe(e) {
139
+ // errors from another realm are not `instanceof Error` here
140
+ if (e && typeof e === "object" && "message" in e)
141
+ return `${e.name ?? "Error"}: ${e.message}`;
142
+ return String(e);
143
+ }
144
+ /**
145
+ * Factory for the trusted data model. Synchronous; no download.
146
+ * @internal
147
+ */
148
+ export const trustedDataModel = (opts) => new TrustedDataModel(opts);
149
+ //# sourceMappingURL=datamodel-trusted.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"datamodel-trusted.js","sourceRoot":"","sources":["../src/datamodel-trusted.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The trusted engine for the ECMAScript data model: the host's own JavaScript\n * engine, in a separate realm per session — no WebAssembly download.\n *\n * Each session still gets its own global scope, which the spec's semantics\n * need (`<script>` declarations persist, sessions — including invoked\n * children — don't share variables, system variables are read-only):\n *\n * - in browsers: a hidden same-origin <iframe>; code runs through the\n * iframe's own `eval`, i.e. as a global script of that window.\n * - in Bun / Node: a `node:vm` context (reached via process.getBuiltinModule,\n * so browser bundles never see a Node import).\n *\n * TRUSTED means: the chart can reach the host (the iframe has `parent`, a vm\n * context is not a security boundary), can't be interrupted when it loops, and\n * needs `eval` to be allowed by the page's Content-Security-Policy. Use it for\n * charts you (or your build) authored; use the sandboxed default for anything\n * a user typed or uploaded.\n */\nimport {\n DataModelError,\n type DataModelFactory,\n type DataModelOptions,\n EVENT_SETTER_SOURCE,\n eventObject,\n isDomNode,\n plainData,\n ScriptDataModel,\n SYSTEM_VARIABLES_SOURCE,\n systemVariableValues,\n} from \"./datamodel-base.ts\";\nimport type { SCXMLEvent } from \"./events.ts\";\n\n/** The realm's global object: another realm's `globalThis`, so its properties are dynamic. */\ntype RealmGlobal = Record<string, unknown> & {\n Array: ArrayConstructor;\n Object: ObjectConstructor;\n};\n\n/** Just enough of `node:vm` (reached at run time, so no Node types are needed). */\ninterface NodeVm {\n createContext(sandbox: object): object;\n runInContext(code: string, context: object, options?: { filename?: string }): unknown;\n}\n\ninterface Realm {\n /** The realm's global object. */\n global: RealmGlobal;\n /** Run code as a global script of the realm. */\n evaluate(code: string): unknown;\n dispose(): void;\n}\n\nconst XHTML_NS = \"http://www.w3.org/1999/xhtml\";\n\nfunction createRealm(): Realm {\n const doc: Document | undefined = (globalThis as { document?: Document }).document;\n const parent = doc?.body ?? doc?.documentElement;\n if (doc && parent && typeof doc.createElementNS === \"function\") {\n // createElementNS: works in HTML pages and in XML documents (e.g. a raw .scxml file)\n const iframe = doc.createElementNS(XHTML_NS, \"iframe\") as HTMLIFrameElement;\n iframe.setAttribute(\"aria-hidden\", \"true\");\n iframe.setAttribute(\"tabindex\", \"-1\");\n iframe.style.display = \"none\"; // CSSOM, not a style attribute: allowed by a strict style-src\n iframe.setAttribute(\"data-scxml-realm\", \"\");\n parent.appendChild(iframe);\n const win = iframe.contentWindow as (Window & typeof globalThis) | null;\n if (win && typeof win.eval === \"function\") {\n return {\n global: win as unknown as RealmGlobal,\n // a method call of another realm's eval is an indirect eval: global scope of that window\n evaluate: (code) => win.eval(code),\n dispose: () => iframe.remove(),\n };\n }\n iframe.remove();\n }\n const vm = (globalThis as { process?: { getBuiltinModule?(id: string): unknown } }).process?.getBuiltinModule?.(\"node:vm\") as\n | NodeVm\n | undefined;\n if (vm?.createContext) {\n const context = vm.createContext({});\n return {\n global: vm.runInContext(\"globalThis\", context) as RealmGlobal,\n evaluate: (code) => vm.runInContext(code, context, { filename: \"scxml.js\" }),\n dispose: () => {},\n };\n }\n throw new Error(\"trusted data model: needs a DOM document (for an iframe realm) or node:vm\");\n}\n\n/**\n * The trusted ECMAScript data model.\n * @internal\n */\nexport class TrustedDataModel extends ScriptDataModel {\n private realm: Realm;\n private setEventFn: (ev: unknown) => void;\n private disposed = false;\n\n constructor(opts: DataModelOptions) {\n super();\n this.realm = createRealm();\n this.realm.global.In = (id: unknown) => opts.In(String(id));\n const install = this.evaluateRaw(SYSTEM_VARIABLES_SOURCE) as (values: unknown) => void;\n install(this.copyIn(systemVariableValues(opts)));\n this.setEventFn = this.evaluateRaw(EVENT_SETTER_SOURCE) as (ev: unknown) => void;\n }\n\n dispose() {\n if (this.disposed) return;\n this.disposed = true;\n this.realm.dispose();\n }\n\n setEvent(ev: SCXMLEvent) {\n this.setEventFn(this.copyIn(eventObject(ev)));\n }\n\n // ─────────────────────────── engine primitives ───────────────────────────\n\n protected run(code: string) {\n this.evaluateRaw(code);\n }\n\n protected read(code: string): unknown {\n return plainData(this.evaluateRaw(code), isDomNode); // DOM values stay real nodes here\n }\n\n protected setGlobal(name: string, value: unknown) {\n this.realm.global[name] = this.copyIn(value);\n }\n\n protected setGlobalFromExpr(name: string, code: string) {\n this.realm.global[name] = this.evaluateRaw(code);\n }\n\n private evaluateRaw(code: string): unknown {\n try {\n return this.realm.evaluate(code);\n } catch (e) {\n throw new DataModelError(describe(e));\n }\n }\n\n // ─────────────────────────── marshalling ─────────────────────────────\n\n /**\n * Host value → a fresh copy built from the realm's own constructors, so the\n * chart never shares mutable objects with the host (or with another\n * session) and `instanceof Array/Object` work inside the chart.\n */\n private copyIn(value: unknown, depth = 0, seen = new Set<object>()): unknown {\n if (typeof value === \"function\" || typeof value === \"symbol\") return undefined;\n if (typeof value !== \"object\" || value === null) return value;\n if (depth > 64 || seen.has(value)) return undefined;\n if (isDomNode(value)) return value.cloneNode(true); // XML values are real DOM here\n if (value instanceof Date) return value.getTime(); // same as the sandboxed engine\n seen.add(value);\n const g = this.realm.global;\n try {\n if (Array.isArray(value)) {\n const arr = new g.Array();\n value.forEach((v, i) => {\n arr[i] = this.copyIn(v, depth + 1, seen);\n });\n return arr;\n }\n const obj = new g.Object() as Record<string, unknown>;\n for (const [k, v] of Object.entries(value)) obj[k] = this.copyIn(v, depth + 1, seen);\n return obj;\n } finally {\n seen.delete(value);\n }\n }\n}\n\nfunction describe(e: unknown): string {\n // errors from another realm are not `instanceof Error` here\n if (e && typeof e === \"object\" && \"message\" in e)\n return `${(e as { name?: string }).name ?? \"Error\"}: ${(e as { message: string }).message}`;\n return String(e);\n}\n\n/**\n * Factory for the trusted data model. Synchronous; no download.\n * @internal\n */\nexport const trustedDataModel: DataModelFactory = (opts) => new TrustedDataModel(opts);\n"]}
@@ -0,0 +1,39 @@
1
+ /**
2
+ * Warnings: valid SCXML that is very likely not what the author meant.
3
+ * `compile()` puts them on `model.warnings`; nothing is rejected.
4
+ *
5
+ * Each check is chosen to be precise rather than exhaustive, so warnings stay
6
+ * rare on real charts (on the W3C suite and the example charts, see
7
+ * docs/deviations.md for the counts). Deliberately *not* checked: events that
8
+ * nothing in the document sends — most events come from outside (hosts,
9
+ * I/O processors, webhooks), so that warning would fire on almost every chart.
10
+ */
11
+ import { type Model, type StateNode } from "./model.js";
12
+ /** The kinds of authoring warning `compile()` reports on `model.warnings`. */
13
+ export type DiagnosticCode =
14
+ /** An external transition on a state inside a `<parallel>` targets its own descendants, so the whole parallel state is exited and re-entered. */
15
+ "SCXML_W_EXITS_PARALLEL"
16
+ /** No initial state, transition or history default can ever lead to the state. */
17
+ | "SCXML_W_UNREACHABLE"
18
+ /** A `done.state.X` / `done.invoke.X` transition waits for something that can never happen. */
19
+ | "SCXML_W_NEVER_DONE"
20
+ /** An earlier transition in the same state, without a condition, handles every event this one does. */
21
+ | "SCXML_W_SHADOWED";
22
+ /**
23
+ * An authoring warning: valid SCXML that is very likely not what the author
24
+ * meant. Nothing is rejected; `<scxml-view>` and the explorer show them.
25
+ */
26
+ export interface Diagnostic {
27
+ /** Which check fired; stable across versions, so hosts can filter on it. */
28
+ code: DiagnosticCode;
29
+ /** Always `"warning"`: invalid documents throw `SCXMLValidationError` instead. */
30
+ severity: "warning";
31
+ /** A human-readable explanation, in English, naming the states involved. */
32
+ message: string;
33
+ /** The source element (a `<transition>` or state element). */
34
+ element: Element | null;
35
+ /** The state the warning is about (for a transition: its source). */
36
+ state: StateNode | null;
37
+ }
38
+ /** All warnings for a compiled model, in document order. */
39
+ export declare function lint(model: Model): Diagnostic[];
@@ -0,0 +1,154 @@
1
+ /**
2
+ * Warnings: valid SCXML that is very likely not what the author meant.
3
+ * `compile()` puts them on `model.warnings`; nothing is rejected.
4
+ *
5
+ * Each check is chosen to be precise rather than exhaustive, so warnings stay
6
+ * rare on real charts (on the W3C suite and the example charts, see
7
+ * docs/deviations.md for the counts). Deliberately *not* checked: events that
8
+ * nothing in the document sends — most events come from outside (hosts,
9
+ * I/O processors, webhooks), so that warning would fire on almost every chart.
10
+ */
11
+ import { isCompound, isCompoundOrRoot, isDescendant, properAncestors } from "./model.js";
12
+ /** All warnings for a compiled model, in document order. */
13
+ export function lint(model) {
14
+ const out = [];
15
+ const warn = (code, message, state, element = state.element) => out.push({ code, severity: "warning", message, element, state });
16
+ exitsParallel(model, warn);
17
+ unreachable(model, warn);
18
+ neverDone(model, warn);
19
+ shadowed(model, warn);
20
+ return out.sort((a, b) => (a.state?.order ?? 0) - (b.state?.order ?? 0));
21
+ }
22
+ const name = (s) => (s.kind === "scxml" ? "<scxml>" : `"${s.id}"`);
23
+ const describe = (t) => (t.events.length ? `on ${t.events.join(" ")}` : t.cond ? `[${t.cond}]` : "(eventless)");
24
+ /**
25
+ * The trap: a transition on a region of a `<parallel>` that targets states
26
+ * inside that region. As an external transition its domain is the nearest
27
+ * *compound* ancestor — and a `<parallel>` isn't one — so it exits the whole
28
+ * parallel state, resetting every sibling region. `type="internal"` keeps it
29
+ * inside the region.
30
+ */
31
+ function exitsParallel(model, warn) {
32
+ for (const s of model.states) {
33
+ for (const t of s.transitions) {
34
+ if (t.type !== "external" || !t.element || !t.targets.length)
35
+ continue;
36
+ if (!t.targets.every((x) => isDescendant(x, s)))
37
+ continue;
38
+ const domain = properAncestors(s, null).find(isCompoundOrRoot);
39
+ const parallel = properAncestors(s, domain ?? null).find((a) => a.kind === "parallel");
40
+ if (!parallel)
41
+ continue;
42
+ warn("SCXML_W_EXITS_PARALLEL", `The transition ${describe(t)} in ${name(s)} targets states inside ${name(s)}, but as an external transition it exits ` +
43
+ `and re-enters the whole parallel state ${name(parallel)}, resetting all of its regions. ` +
44
+ `Add type="internal" if it should only change ${name(s)}.`, s, t.element);
45
+ }
46
+ }
47
+ }
48
+ /** States that nothing can ever enter. Only the outermost unreachable state is reported. */
49
+ function unreachable(model, warn) {
50
+ const reached = new Set();
51
+ const queue = [];
52
+ const mark = (s) => {
53
+ for (const x of [s, ...properAncestors(s, null)]) {
54
+ if (reached.has(x))
55
+ continue;
56
+ reached.add(x);
57
+ queue.push(x);
58
+ }
59
+ };
60
+ mark(model.root);
61
+ while (queue.length) {
62
+ const s = queue.shift();
63
+ if (s.kind === "history")
64
+ for (const t of s.transitions)
65
+ t.targets.forEach(mark);
66
+ if (s.initial)
67
+ s.initial.targets.forEach(mark);
68
+ if (s.kind === "parallel")
69
+ s.children.forEach(mark);
70
+ for (const t of s.transitions)
71
+ t.targets.forEach(mark);
72
+ }
73
+ for (const s of model.states) {
74
+ if (reached.has(s) || s.kind === "history" || s.kind === "scxml")
75
+ continue;
76
+ if (s.parent && !reached.has(s.parent) && s.parent.kind !== "scxml")
77
+ continue; // its parent is already reported
78
+ warn("SCXML_W_UNREACHABLE", `State ${name(s)} can never be entered: no initial state, transition or history default leads to it or to a state inside it.`, s);
79
+ }
80
+ }
81
+ /** Can this state ever raise done.state.<id>? */
82
+ function canComplete(s) {
83
+ if (isCompound(s))
84
+ return s.children.some((c) => c.kind === "final");
85
+ if (s.kind === "parallel")
86
+ return s.children.length > 0 && s.children.every(canComplete);
87
+ return false;
88
+ }
89
+ function neverDone(model, warn) {
90
+ const invokeIds = new Set();
91
+ let generatedInvokeIds = false;
92
+ for (const s of model.states)
93
+ for (const inv of s.invokes) {
94
+ const id = inv.element.getAttribute("id");
95
+ if (id)
96
+ invokeIds.add(id);
97
+ else
98
+ generatedInvokeIds = true;
99
+ }
100
+ for (const s of model.states) {
101
+ for (const t of s.transitions) {
102
+ if (!t.element)
103
+ continue;
104
+ for (const d of t.events) {
105
+ const tokens = d.replace(/\.\*$/, "").replace(/\.$/, "").split(".");
106
+ if (tokens[0] !== "done" || tokens.length < 3)
107
+ continue;
108
+ const id = tokens.slice(2).join(".");
109
+ if (tokens[1] === "state") {
110
+ const target = model.byId.get(id);
111
+ const why = !target
112
+ ? `there is no state "${id}"`
113
+ : target.kind === "final"
114
+ ? `"${id}" is a final state; done.state events carry the id of its parent${target.parent && target.parent.kind !== "scxml" ? ` ("${target.parent.id}")` : ""}`
115
+ : `"${id}" can never complete (${target.kind === "parallel" ? "one of its regions has no final state" : "it has no final child state"})`;
116
+ if (!target || !canComplete(target))
117
+ warn("SCXML_W_NEVER_DONE", `The transition on ${d} in ${name(s)} can never fire: ${why}.`, s, t.element);
118
+ }
119
+ else if (tokens[1] === "invoke" && !invokeIds.has(id) && !generatedInvokeIds) {
120
+ // done.invoke ids can also be longer than the invoke id (done.invoke.kid matches done.invoke.kid.x), so check the prefix
121
+ if (![...invokeIds].some((i) => i === id || id.startsWith(`${i}.`)))
122
+ warn("SCXML_W_NEVER_DONE", `The transition on ${d} in ${name(s)} can never fire: no <invoke> has the id "${id}".`, s, t.element);
123
+ }
124
+ }
125
+ }
126
+ }
127
+ }
128
+ /** Does descriptor `a` match every event that descriptor `b` matches? */
129
+ function covers(a, b) {
130
+ if (a === "*")
131
+ return true;
132
+ if (b === "*")
133
+ return false;
134
+ const ta = a.replace(/\.\*$/, "").replace(/\.$/, "").split(".");
135
+ const tb = b.replace(/\.\*$/, "").replace(/\.$/, "").split(".");
136
+ return ta.length <= tb.length && ta.every((t, i) => t === tb[i]);
137
+ }
138
+ function shadowed(model, warn) {
139
+ for (const s of model.states) {
140
+ if (s.kind === "history")
141
+ continue;
142
+ const earlier = [];
143
+ for (const t of s.transitions) {
144
+ const by = earlier.find((e) => !e.cond &&
145
+ (e.events.length === 0
146
+ ? t.events.length === 0
147
+ : t.events.length > 0 && t.events.every((d) => e.events.some((c) => covers(c, d)))));
148
+ if (by && t.element)
149
+ warn("SCXML_W_SHADOWED", `The transition ${describe(t)} in ${name(s)} can never fire: the earlier transition ${describe(by)} in the same state has no condition and handles every event it does.`, s, t.element);
150
+ earlier.push(t);
151
+ }
152
+ }
153
+ }
154
+ //# sourceMappingURL=diagnostics.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Warnings: valid SCXML that is very likely not what the author meant.\n * `compile()` puts them on `model.warnings`; nothing is rejected.\n *\n * Each check is chosen to be precise rather than exhaustive, so warnings stay\n * rare on real charts (on the W3C suite and the example charts, see\n * docs/deviations.md for the counts). Deliberately *not* checked: events that\n * nothing in the document sends — most events come from outside (hosts,\n * I/O processors, webhooks), so that warning would fire on almost every chart.\n */\nimport { isCompound, isCompoundOrRoot, isDescendant, type Model, properAncestors, type StateNode, type TransitionNode } from \"./model.ts\";\n\n/** The kinds of authoring warning `compile()` reports on `model.warnings`. */\nexport type DiagnosticCode =\n /** An external transition on a state inside a `<parallel>` targets its own descendants, so the whole parallel state is exited and re-entered. */\n | \"SCXML_W_EXITS_PARALLEL\"\n /** No initial state, transition or history default can ever lead to the state. */\n | \"SCXML_W_UNREACHABLE\"\n /** A `done.state.X` / `done.invoke.X` transition waits for something that can never happen. */\n | \"SCXML_W_NEVER_DONE\"\n /** An earlier transition in the same state, without a condition, handles every event this one does. */\n | \"SCXML_W_SHADOWED\";\n\n/**\n * An authoring warning: valid SCXML that is very likely not what the author\n * meant. Nothing is rejected; `<scxml-view>` and the explorer show them.\n */\nexport interface Diagnostic {\n /** Which check fired; stable across versions, so hosts can filter on it. */\n code: DiagnosticCode;\n /** Always `\"warning\"`: invalid documents throw `SCXMLValidationError` instead. */\n severity: \"warning\";\n /** A human-readable explanation, in English, naming the states involved. */\n message: string;\n /** The source element (a `<transition>` or state element). */\n element: Element | null;\n /** The state the warning is about (for a transition: its source). */\n state: StateNode | null;\n}\n\n/** All warnings for a compiled model, in document order. */\nexport function lint(model: Model): Diagnostic[] {\n const out: Diagnostic[] = [];\n const warn = (code: DiagnosticCode, message: string, state: StateNode, element: Element | null = state.element) =>\n out.push({ code, severity: \"warning\", message, element, state });\n exitsParallel(model, warn);\n unreachable(model, warn);\n neverDone(model, warn);\n shadowed(model, warn);\n return out.sort((a, b) => (a.state?.order ?? 0) - (b.state?.order ?? 0));\n}\n\ntype Warn = (code: DiagnosticCode, message: string, state: StateNode, element?: Element | null) => void;\n\nconst name = (s: StateNode) => (s.kind === \"scxml\" ? \"<scxml>\" : `\"${s.id}\"`);\nconst describe = (t: TransitionNode) => (t.events.length ? `on ${t.events.join(\" \")}` : t.cond ? `[${t.cond}]` : \"(eventless)\");\n\n/**\n * The trap: a transition on a region of a `<parallel>` that targets states\n * inside that region. As an external transition its domain is the nearest\n * *compound* ancestor — and a `<parallel>` isn't one — so it exits the whole\n * parallel state, resetting every sibling region. `type=\"internal\"` keeps it\n * inside the region.\n */\nfunction exitsParallel(model: Model, warn: Warn) {\n for (const s of model.states) {\n for (const t of s.transitions) {\n if (t.type !== \"external\" || !t.element || !t.targets.length) continue;\n if (!t.targets.every((x) => isDescendant(x, s))) continue;\n const domain = properAncestors(s, null).find(isCompoundOrRoot);\n const parallel = properAncestors(s, domain ?? null).find((a) => a.kind === \"parallel\");\n if (!parallel) continue;\n warn(\n \"SCXML_W_EXITS_PARALLEL\",\n `The transition ${describe(t)} in ${name(s)} targets states inside ${name(s)}, but as an external transition it exits ` +\n `and re-enters the whole parallel state ${name(parallel)}, resetting all of its regions. ` +\n `Add type=\"internal\" if it should only change ${name(s)}.`,\n s,\n t.element,\n );\n }\n }\n}\n\n/** States that nothing can ever enter. Only the outermost unreachable state is reported. */\nfunction unreachable(model: Model, warn: Warn) {\n const reached = new Set<StateNode>();\n const queue: StateNode[] = [];\n const mark = (s: StateNode) => {\n for (const x of [s, ...properAncestors(s, null)]) {\n if (reached.has(x)) continue;\n reached.add(x);\n queue.push(x);\n }\n };\n mark(model.root);\n while (queue.length) {\n const s = queue.shift()!;\n if (s.kind === \"history\") for (const t of s.transitions) t.targets.forEach(mark);\n if (s.initial) s.initial.targets.forEach(mark);\n if (s.kind === \"parallel\") s.children.forEach(mark);\n for (const t of s.transitions) t.targets.forEach(mark);\n }\n for (const s of model.states) {\n if (reached.has(s) || s.kind === \"history\" || s.kind === \"scxml\") continue;\n if (s.parent && !reached.has(s.parent) && s.parent.kind !== \"scxml\") continue; // its parent is already reported\n warn(\n \"SCXML_W_UNREACHABLE\",\n `State ${name(s)} can never be entered: no initial state, transition or history default leads to it or to a state inside it.`,\n s,\n );\n }\n}\n\n/** Can this state ever raise done.state.<id>? */\nfunction canComplete(s: StateNode): boolean {\n if (isCompound(s)) return s.children.some((c) => c.kind === \"final\");\n if (s.kind === \"parallel\") return s.children.length > 0 && s.children.every(canComplete);\n return false;\n}\n\nfunction neverDone(model: Model, warn: Warn) {\n const invokeIds = new Set<string>();\n let generatedInvokeIds = false;\n for (const s of model.states)\n for (const inv of s.invokes) {\n const id = inv.element.getAttribute(\"id\");\n if (id) invokeIds.add(id);\n else generatedInvokeIds = true;\n }\n for (const s of model.states) {\n for (const t of s.transitions) {\n if (!t.element) continue;\n for (const d of t.events) {\n const tokens = d.replace(/\\.\\*$/, \"\").replace(/\\.$/, \"\").split(\".\");\n if (tokens[0] !== \"done\" || tokens.length < 3) continue;\n const id = tokens.slice(2).join(\".\");\n if (tokens[1] === \"state\") {\n const target = model.byId.get(id);\n const why = !target\n ? `there is no state \"${id}\"`\n : target.kind === \"final\"\n ? `\"${id}\" is a final state; done.state events carry the id of its parent${target.parent && target.parent.kind !== \"scxml\" ? ` (\"${target.parent.id}\")` : \"\"}`\n : `\"${id}\" can never complete (${target.kind === \"parallel\" ? \"one of its regions has no final state\" : \"it has no final child state\"})`;\n if (!target || !canComplete(target))\n warn(\"SCXML_W_NEVER_DONE\", `The transition on ${d} in ${name(s)} can never fire: ${why}.`, s, t.element);\n } else if (tokens[1] === \"invoke\" && !invokeIds.has(id) && !generatedInvokeIds) {\n // done.invoke ids can also be longer than the invoke id (done.invoke.kid matches done.invoke.kid.x), so check the prefix\n if (![...invokeIds].some((i) => i === id || id.startsWith(`${i}.`)))\n warn(\n \"SCXML_W_NEVER_DONE\",\n `The transition on ${d} in ${name(s)} can never fire: no <invoke> has the id \"${id}\".`,\n s,\n t.element,\n );\n }\n }\n }\n }\n}\n\n/** Does descriptor `a` match every event that descriptor `b` matches? */\nfunction covers(a: string, b: string): boolean {\n if (a === \"*\") return true;\n if (b === \"*\") return false;\n const ta = a.replace(/\\.\\*$/, \"\").replace(/\\.$/, \"\").split(\".\");\n const tb = b.replace(/\\.\\*$/, \"\").replace(/\\.$/, \"\").split(\".\");\n return ta.length <= tb.length && ta.every((t, i) => t === tb[i]);\n}\n\nfunction shadowed(model: Model, warn: Warn) {\n for (const s of model.states) {\n if (s.kind === \"history\") continue;\n const earlier: TransitionNode[] = [];\n for (const t of s.transitions) {\n const by = earlier.find(\n (e) =>\n !e.cond &&\n (e.events.length === 0\n ? t.events.length === 0\n : t.events.length > 0 && t.events.every((d) => e.events.some((c) => covers(c, d)))),\n );\n if (by && t.element)\n warn(\n \"SCXML_W_SHADOWED\",\n `The transition ${describe(t)} in ${name(s)} can never fire: the earlier transition ${describe(by)} in the same state has no condition and handles every event it does.`,\n s,\n t.element,\n );\n earlier.push(t);\n }\n }\n}\n"]}
@@ -0,0 +1,85 @@
1
+ /**
2
+ * Opt-in integration with the chart's own DOM: bubbling events on the source
3
+ * elements (`elementEvents`) and live attributes for CSS (`reflect`).
4
+ *
5
+ * Both are off by default: one compiled model can be shared by many sessions,
6
+ * and their events and attributes would collide on the same elements.
7
+ */
8
+ import type { Clock } from "./clock.js";
9
+ import type { SCXMLEvent } from "./events.js";
10
+ import type { Model, StateNode, TransitionNode } from "./model.js";
11
+ import type { SCXMLSession } from "./session.js";
12
+ /** `scxml:enter` / `scxml:exit`, dispatched on a state's source element. Bubbles, composed. */
13
+ export interface StateElementEvent extends Event {
14
+ /** The session that entered or exited the state. */
15
+ readonly session: SCXMLSession;
16
+ /** The state, as a model node (its `element` is the event's target). */
17
+ readonly state: StateNode;
18
+ /** The SCXML event that triggered the microstep, if any. */
19
+ readonly event?: SCXMLEvent;
20
+ }
21
+ /** `scxml:transition`, dispatched on a fired `<transition>` element. Bubbles, composed. */
22
+ export interface TransitionElementEvent extends Event {
23
+ /** The session that took the transition. */
24
+ readonly session: SCXMLSession;
25
+ /** The transition, as a model node. */
26
+ readonly transition: TransitionNode;
27
+ /** The SCXML event that triggered it, if any (eventless transitions have none). */
28
+ readonly event?: SCXMLEvent;
29
+ }
30
+ /** `scxml:done`, dispatched on the `<scxml>` element when the session terminates. Bubbles, composed. */
31
+ export interface ChartDoneElementEvent extends Event {
32
+ /** The session that terminated. */
33
+ readonly session: SCXMLSession;
34
+ /** The top-level final state's `<donedata>`, if any. */
35
+ readonly data: unknown;
36
+ }
37
+ /**
38
+ * The events `elementEvents: true` dispatches on the chart's own elements.
39
+ * Merged into the DOM's `ElementEventMap`, `DocumentEventMap` and
40
+ * `WindowEventMap`, so `document.addEventListener("scxml:enter", …)` is typed.
41
+ */
42
+ export interface ElementEventsMap {
43
+ /** A state was entered (on the state's element). */
44
+ "scxml:enter": StateElementEvent;
45
+ /** A state was exited (on the state's element). */
46
+ "scxml:exit": StateElementEvent;
47
+ /** A transition fired (on the `<transition>` element). */
48
+ "scxml:transition": TransitionElementEvent;
49
+ /** The session terminated (on the `<scxml>` element). */
50
+ "scxml:done": ChartDoneElementEvent;
51
+ }
52
+ declare global {
53
+ interface ElementEventMap extends ElementEventsMap {
54
+ }
55
+ interface DocumentEventMap extends ElementEventsMap {
56
+ }
57
+ interface WindowEventMap extends ElementEventsMap {
58
+ }
59
+ }
60
+ /** Options for `SessionOptions.reflect` (or pass `true` for the defaults). */
61
+ export interface ReflectOptions {
62
+ /** How long `data-fired` stays on a transition element (session clock, ms). Default 900. */
63
+ firedMs?: number;
64
+ }
65
+ export declare class ElementBridge {
66
+ private readonly session;
67
+ private readonly model;
68
+ private readonly clock;
69
+ private readonly events;
70
+ private readonly reflect;
71
+ private readonly firedMs;
72
+ private readonly timers;
73
+ constructor(session: SCXMLSession, model: Model, clock: Clock, events: boolean, reflect: false | ReflectOptions);
74
+ /** Before the first microstep. */
75
+ start(): void;
76
+ /** After each microstep, once the configuration is consistent. */
77
+ microstep(transitions: TransitionNode[], exited: StateNode[], entered: StateNode[], event: SCXMLEvent | undefined): void;
78
+ /** The session terminated. The last configuration stays visible; nothing is enabled any more. */
79
+ done(data: unknown): void;
80
+ /** Remove every attribute this session set (on dispose/cancel). */
81
+ cleanup(): void;
82
+ private syncEnabled;
83
+ private fire;
84
+ private dispatch;
85
+ }