nodality 1.5.4 → 1.5.5
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.
- package/README.md +7 -4
- package/bin/mcp-server.mjs +20 -0
- package/dist/animator.cjs.js +1 -1
- package/dist/animator.cjs.js.LICENSE.txt +1 -1
- package/dist/animator.esm.js +1 -1
- package/dist/animator.esm.js.LICENSE.txt +1 -1
- package/dist/audionew.cjs.js +1 -1
- package/dist/audionew.cjs.js.LICENSE.txt +1 -1
- package/dist/audionew.esm.js +1 -1
- package/dist/audionew.esm.js.LICENSE.txt +1 -1
- package/dist/base.cjs.js +1 -1
- package/dist/base.cjs.js.LICENSE.txt +1 -1
- package/dist/base.esm.js +1 -1
- package/dist/base.esm.js.LICENSE.txt +1 -1
- package/dist/beta-desktop-bar.cjs.js +1 -1
- package/dist/beta-desktop-bar.cjs.js.LICENSE.txt +1 -1
- package/dist/beta-desktop-bar.esm.js +1 -1
- package/dist/beta-desktop-bar.esm.js.LICENSE.txt +1 -1
- package/dist/beta-mobile-bar.cjs.js +1 -1
- package/dist/beta-mobile-bar.cjs.js.LICENSE.txt +1 -1
- package/dist/beta-mobile-bar.esm.js +1 -1
- package/dist/beta-mobile-bar.esm.js.LICENSE.txt +1 -1
- package/dist/bundle.umd.js +1 -1
- package/dist/bundle.umd.js.LICENSE.txt +1 -1
- package/dist/button.cjs.js +1 -1
- package/dist/button.cjs.js.LICENSE.txt +1 -1
- package/dist/button.esm.js +1 -1
- package/dist/button.esm.js.LICENSE.txt +1 -1
- package/dist/card-getter.cjs.js.LICENSE.txt +1 -1
- package/dist/card-getter.esm.js.LICENSE.txt +1 -1
- package/dist/center.cjs.js +1 -1
- package/dist/center.cjs.js.LICENSE.txt +1 -1
- package/dist/center.esm.js +1 -1
- package/dist/center.esm.js.LICENSE.txt +1 -1
- package/dist/checkbox.cjs.js +1 -1
- package/dist/checkbox.cjs.js.LICENSE.txt +1 -1
- package/dist/checkbox.esm.js +1 -1
- package/dist/checkbox.esm.js.LICENSE.txt +1 -1
- package/dist/code.cjs.js +1 -1
- package/dist/code.cjs.js.LICENSE.txt +1 -1
- package/dist/code.esm.js +1 -1
- package/dist/code.esm.js.LICENSE.txt +1 -1
- package/dist/container.cjs.js +1 -1
- package/dist/container.cjs.js.LICENSE.txt +1 -1
- package/dist/container.esm.js +1 -1
- package/dist/container.esm.js.LICENSE.txt +1 -1
- package/dist/data-list.cjs.js.LICENSE.txt +1 -1
- package/dist/data-list.esm.js.LICENSE.txt +1 -1
- package/dist/designer.cjs.js +1 -1
- package/dist/designer.cjs.js.LICENSE.txt +1 -1
- package/dist/designer.esm.js +1 -1
- package/dist/designer.esm.js.LICENSE.txt +1 -1
- package/dist/element-mapper.cjs.js +1 -1
- package/dist/element-mapper.cjs.js.LICENSE.txt +1 -1
- package/dist/element-mapper.esm.js +1 -1
- package/dist/element-mapper.esm.js.LICENSE.txt +1 -1
- package/dist/finalresult.esm.js +1 -1
- package/dist/finalresult.esm.js.LICENSE.txt +1 -1
- package/dist/flex-card.cjs.js +1 -1
- package/dist/flex-card.cjs.js.LICENSE.txt +1 -1
- package/dist/flex-card.esm.js +1 -1
- package/dist/flex-card.esm.js.LICENSE.txt +1 -1
- package/dist/flex-grid.cjs.js +1 -1
- package/dist/flex-grid.cjs.js.LICENSE.txt +1 -1
- package/dist/flex-grid.esm.js +1 -1
- package/dist/flex-grid.esm.js.LICENSE.txt +1 -1
- package/dist/flex-row.cjs.js +1 -1
- package/dist/flex-row.cjs.js.LICENSE.txt +1 -1
- package/dist/flex-row.esm.js +1 -1
- package/dist/flex-row.esm.js.LICENSE.txt +1 -1
- package/dist/floating-input.cjs.js +1 -1
- package/dist/floating-input.cjs.js.LICENSE.txt +1 -1
- package/dist/floating-input.esm.js +1 -1
- package/dist/floating-input.esm.js.LICENSE.txt +1 -1
- package/dist/free.cjs.js +1 -1
- package/dist/free.cjs.js.LICENSE.txt +1 -1
- package/dist/free.esm.js +1 -1
- package/dist/free.esm.js.LICENSE.txt +1 -1
- package/dist/horizontal-scroller.cjs.js.LICENSE.txt +1 -1
- package/dist/horizontal-scroller.esm.js.LICENSE.txt +1 -1
- package/dist/image-picker.cjs.js +1 -1
- package/dist/image-picker.cjs.js.LICENSE.txt +1 -1
- package/dist/image-picker.esm.js +1 -1
- package/dist/image-picker.esm.js.LICENSE.txt +1 -1
- package/dist/image.cjs.js +1 -1
- package/dist/image.cjs.js.LICENSE.txt +1 -1
- package/dist/image.esm.js +1 -1
- package/dist/image.esm.js.LICENSE.txt +1 -1
- package/dist/index.cjs.js +1 -1
- package/dist/index.cjs.js.LICENSE.txt +1 -1
- package/dist/index.d.ts +3 -2
- package/dist/index.esm.js +1 -1
- package/dist/index.esm.js.LICENSE.txt +1 -1
- package/dist/keyframe-animation.cjs.js.LICENSE.txt +1 -1
- package/dist/keyframe-animation.esm.js.LICENSE.txt +1 -1
- package/dist/link-getter.cjs.js +1 -1
- package/dist/link-getter.cjs.js.LICENSE.txt +1 -1
- package/dist/link-getter.esm.js +1 -1
- package/dist/link-getter.esm.js.LICENSE.txt +1 -1
- package/dist/link.cjs.js +1 -1
- package/dist/link.cjs.js.LICENSE.txt +1 -1
- package/dist/link.esm.js +1 -1
- package/dist/link.esm.js.LICENSE.txt +1 -1
- package/dist/meta-adder.cjs.js +1 -1
- package/dist/meta-adder.cjs.js.LICENSE.txt +1 -1
- package/dist/meta-adder.esm.js +1 -1
- package/dist/meta-adder.esm.js.LICENSE.txt +1 -1
- package/dist/modal-2025.cjs.js +1 -1
- package/dist/modal-2025.cjs.js.LICENSE.txt +1 -1
- package/dist/modal-2025.esm.js +1 -1
- package/dist/modal-2025.esm.js.LICENSE.txt +1 -1
- package/dist/multiswitcher.cjs.js +1 -1
- package/dist/multiswitcher.cjs.js.LICENSE.txt +1 -1
- package/dist/multiswitcher.esm.js +1 -1
- package/dist/multiswitcher.esm.js.LICENSE.txt +1 -1
- package/dist/new-nav-bar.cjs.js +1 -1
- package/dist/new-nav-bar.cjs.js.LICENSE.txt +1 -1
- package/dist/new-nav-bar.esm.js +1 -1
- package/dist/new-nav-bar.esm.js.LICENSE.txt +1 -1
- package/dist/picker.cjs.js +1 -1
- package/dist/picker.cjs.js.LICENSE.txt +1 -1
- package/dist/picker.esm.js +1 -1
- package/dist/picker.esm.js.LICENSE.txt +1 -1
- package/dist/progress.cjs.js +1 -1
- package/dist/progress.cjs.js.LICENSE.txt +1 -1
- package/dist/progress.esm.js +1 -1
- package/dist/progress.esm.js.LICENSE.txt +1 -1
- package/dist/radio.cjs.js.LICENSE.txt +1 -1
- package/dist/radio.esm.js.LICENSE.txt +1 -1
- package/dist/range.cjs.js.LICENSE.txt +1 -1
- package/dist/range.esm.js.LICENSE.txt +1 -1
- package/dist/scroll-video.cjs.js.LICENSE.txt +1 -1
- package/dist/scroll-video.esm.js.LICENSE.txt +1 -1
- package/dist/side-bar.cjs.js +1 -1
- package/dist/side-bar.cjs.js.LICENSE.txt +1 -1
- package/dist/side-bar.esm.js +1 -1
- package/dist/side-bar.esm.js.LICENSE.txt +1 -1
- package/dist/side-nav-bar.cjs.js +1 -1
- package/dist/side-nav-bar.cjs.js.LICENSE.txt +1 -1
- package/dist/side-nav-bar.esm.js +1 -1
- package/dist/side-nav-bar.esm.js.LICENSE.txt +1 -1
- package/dist/simple-bar.cjs.js +1 -1
- package/dist/simple-bar.cjs.js.LICENSE.txt +1 -1
- package/dist/simple-bar.esm.js +1 -1
- package/dist/simple-bar.esm.js.LICENSE.txt +1 -1
- package/dist/slider-2025.cjs.js +1 -1
- package/dist/slider-2025.cjs.js.LICENSE.txt +1 -1
- package/dist/slider-2025.esm.js +1 -1
- package/dist/slider-2025.esm.js.LICENSE.txt +1 -1
- package/dist/spacer.cjs.js +1 -1
- package/dist/spacer.cjs.js.LICENSE.txt +1 -1
- package/dist/spacer.esm.js +1 -1
- package/dist/spacer.esm.js.LICENSE.txt +1 -1
- package/dist/stack.cjs.js +1 -1
- package/dist/stack.cjs.js.LICENSE.txt +1 -1
- package/dist/stack.esm.js +1 -1
- package/dist/stack.esm.js.LICENSE.txt +1 -1
- package/dist/stacker.cjs.js.LICENSE.txt +1 -1
- package/dist/stacker.esm.js.LICENSE.txt +1 -1
- package/dist/table.cjs.js +1 -1
- package/dist/table.cjs.js.LICENSE.txt +1 -1
- package/dist/table.esm.js +1 -1
- package/dist/table.esm.js.LICENSE.txt +1 -1
- package/dist/text-field.cjs.js +1 -1
- package/dist/text-field.cjs.js.LICENSE.txt +1 -1
- package/dist/text-field.esm.js +1 -1
- package/dist/text-field.esm.js.LICENSE.txt +1 -1
- package/dist/text.cjs.js +1 -1
- package/dist/text.cjs.js.LICENSE.txt +1 -1
- package/dist/text.esm.js +1 -1
- package/dist/text.esm.js.LICENSE.txt +1 -1
- package/dist/theme.cjs.js.LICENSE.txt +1 -1
- package/dist/theme.esm.js.LICENSE.txt +1 -1
- package/dist/transform-anim.cjs.js.LICENSE.txt +1 -1
- package/dist/transform-anim.esm.js.LICENSE.txt +1 -1
- package/dist/ulist.cjs.js +1 -1
- package/dist/ulist.cjs.js.LICENSE.txt +1 -1
- package/dist/ulist.esm.js +1 -1
- package/dist/ulist.esm.js.LICENSE.txt +1 -1
- package/dist/video.cjs.js +1 -1
- package/dist/video.cjs.js.LICENSE.txt +1 -1
- package/dist/video.esm.js +1 -1
- package/dist/video.esm.js.LICENSE.txt +1 -1
- package/dist/wrap.cjs.js +1 -1
- package/dist/wrap.cjs.js.LICENSE.txt +1 -1
- package/dist/wrap.esm.js +1 -1
- package/dist/wrap.esm.js.LICENSE.txt +1 -1
- package/dist/zoom-card.cjs.js +1 -1
- package/dist/zoom-card.cjs.js.LICENSE.txt +1 -1
- package/dist/zoom-card.esm.js +1 -1
- package/dist/zoom-card.esm.js.LICENSE.txt +1 -1
- package/layout/animator.js +6 -2
- package/layout/audio.js +1 -1
- package/layout/audionew.js +1 -1
- package/layout/base.js +1 -1
- package/layout/beta-desktop-bar.js +1 -1
- package/layout/beta-mobile-bar.js +1 -1
- package/layout/button.js +1 -1
- package/layout/center.js +1 -1
- package/layout/checkbox.js +1 -1
- package/layout/circle.js +3 -3
- package/layout/code.js +2 -2
- package/layout/container.js +2 -2
- package/layout/dropdown-2025.js +1 -1
- package/layout/flex-card.js +2 -2
- package/layout/flex-grid.js +2 -2
- package/layout/flex-row.js +2 -2
- package/layout/form-components/custom.js +1 -1
- package/layout/form-components/data-list.js +1 -1
- package/layout/form-components/floating-input.js +1 -1
- package/layout/form-components/form-all.js +1 -1
- package/layout/form-components/form.js +1 -1
- package/layout/form-components/image-picker.js +1 -1
- package/layout/form-components/picker.js +1 -1
- package/layout/form-components/radio.js +1 -1
- package/layout/form-components/radiogroup.js +1 -1
- package/layout/form-components/range.js +1 -1
- package/layout/free.js +1 -1
- package/layout/grid-overlay.js +1 -1
- package/layout/grid-switcher.js +1 -1
- package/layout/grid.js +1 -1
- package/layout/horizontal-scroller.js +1 -1
- package/layout/image.js +1 -1
- package/layout/index.js +1 -1
- package/layout/link.js +2 -2
- package/layout/list.js +1 -1
- package/layout/meta-adder.js +1 -1
- package/layout/modal-2025.js +1 -1
- package/layout/morph.js +1 -1
- package/layout/multiswitcher.js +1 -1
- package/layout/nav-bar.js +1 -1
- package/layout/nav-factor/custom-div.js +1 -1
- package/layout/new-nav-bar.js +1 -1
- package/layout/polygon.js +3 -3
- package/layout/prerender-site.js +1 -1
- package/layout/prerender.js +1 -1
- package/layout/progress.js +1 -1
- package/layout/row.js +1 -1
- package/layout/scroll-video.js +1 -1
- package/layout/shop.js +1 -1
- package/layout/side-bar.js +1 -1
- package/layout/side-nav-bar.js +1 -1
- package/layout/simple-bar.js +1 -1
- package/layout/slider-2025.js +1 -1
- package/layout/spacer.js +1 -1
- package/layout/stack.js +2 -2
- package/layout/svg.js +1 -1
- package/layout/switcher.js +1 -1
- package/layout/table.js +2 -2
- package/layout/text-field.js +1 -1
- package/layout/text.js +2 -2
- package/layout/ulist.js +19 -2
- package/layout/video.js +1 -1
- package/layout/wrap.js +1 -1
- package/layout/zoom-card.js +1 -1
- package/lib/agent-surface.js +2 -2
- package/lib/card-getter.js +1 -1
- package/lib/check-page.js +1 -1
- package/lib/codegen.js +1 -1
- package/lib/data.js +1 -1
- package/lib/designer.js +1 -1
- package/lib/element-mapper.js +8 -6
- package/lib/element-params.generated.js +1 -1
- package/lib/grid-geometry.js +1 -1
- package/lib/keyframe-animation.js +1 -1
- package/lib/known-inert.js +1 -1
- package/lib/lines.js +262 -0
- package/lib/link-getter.js +3 -3
- package/lib/morph-node.js +1 -1
- package/lib/normalize-spec.js +1 -1
- package/lib/op-semantics.js +91 -2
- package/lib/parse-html.js +1 -1
- package/lib/raster-inspect.js +1 -1
- package/lib/raster-ops.js +1 -1
- package/lib/raster-presets.js +1 -1
- package/lib/react.js +1 -1
- package/lib/resolve-refs.js +1 -1
- package/lib/responsive.js +1 -1
- package/lib/scroll-video.js +1 -1
- package/lib/seo.js +1 -1
- package/lib/stacker.js +1 -1
- package/lib/suggest.js +1 -1
- package/lib/theme.js +1 -1
- package/lib/transform-anim.js +1 -1
- package/lib/transition.js +1 -1
- package/lib/validate-nodes.js +21 -1
- package/lib/view-transition.js +1 -1
- package/lib/webmcp-adapter.js +21 -6
- package/package.json +2 -1
- package/skills/nodality/SKILL.md +4 -0
package/lib/lines.js
ADDED
|
@@ -0,0 +1,262 @@
|
|
|
1
|
+
/*!
|
|
2
|
+
* nodality v1.5.5
|
|
3
|
+
* (c) 2026 Filip Vabrousek
|
|
4
|
+
* License: MIT
|
|
5
|
+
*/
|
|
6
|
+
|
|
7
|
+
/*!
|
|
8
|
+
* lines.js: a compact line syntax for the (elements, nodes) pair.
|
|
9
|
+
*
|
|
10
|
+
* One statement per line, so a model's output streams, an error points at a
|
|
11
|
+
* line, and an edit replaces a line. It is parsed, never evaluated: page text
|
|
12
|
+
* stays data. print() and parse() round-trip any pair, so the JSON form stays
|
|
13
|
+
* the stored and validated one.
|
|
14
|
+
*
|
|
15
|
+
* h1 #hero "Ship it" color=#1d6fe0 an element: type, #id, "text", key=value
|
|
16
|
+
* row #features children are indented two spaces
|
|
17
|
+
* h2 "Plain data in"
|
|
18
|
+
* + shadow() hero a node: {op:{name:"shadow"}, target:["hero"]}
|
|
19
|
+
* + gradient(gradient="linear-gradient(90deg, #000, #fff)") hero
|
|
20
|
+
* + dither hero levels=6 size=2 {op:"dither", target:["hero"], levels:6, size:2}
|
|
21
|
+
* + arrange(mode=column) features @0-424
|
|
22
|
+
* { "$ref": "card" } any element as raw JSON
|
|
23
|
+
* + { "op": "morph", "chain": [] } any node as raw JSON
|
|
24
|
+
* // a comment
|
|
25
|
+
*
|
|
26
|
+
* Values are bare when unambiguous (3px, #fff, column, 6, true) and JSON
|
|
27
|
+
* otherwise ("two words", [1,2], {"a":1}). A bare number or true/false/null
|
|
28
|
+
* means the number or literal; the string "6" prints as "6".
|
|
29
|
+
*
|
|
30
|
+
* Pure module: no DOM at import.
|
|
31
|
+
*/
|
|
32
|
+
|
|
33
|
+
const BARE = /^[A-Za-z0-9#._%/:+-]+$/;
|
|
34
|
+
const NUM = /^-?(0|[1-9]\d*)(\.\d+)?([eE][+-]?\d+)?$/;
|
|
35
|
+
const KEY = /^[A-Za-z_$][\w$-]*$/;
|
|
36
|
+
const ID = /^[A-Za-z0-9_-]+$/;
|
|
37
|
+
const OP = /^[A-Za-z][\w-]*$/;
|
|
38
|
+
|
|
39
|
+
// ── printing ─────────────────────────────────────────────────────────
|
|
40
|
+
|
|
41
|
+
function value(v) {
|
|
42
|
+
if (typeof v === "string" && v.length && BARE.test(v) && !NUM.test(v)
|
|
43
|
+
&& !["true", "false", "null"].includes(v) && !v.startsWith("@") && !v.startsWith("+")) return v;
|
|
44
|
+
return JSON.stringify(v);
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
const key = (k) => (KEY.test(k) ? k : JSON.stringify(k));
|
|
48
|
+
const pairs = (obj, skip) => Object.keys(obj)
|
|
49
|
+
.filter((k) => !skip.includes(k) && obj[k] !== undefined)
|
|
50
|
+
.map((k) => `${key(k)}=${value(obj[k])}`);
|
|
51
|
+
|
|
52
|
+
function printElement(el, depth, out) {
|
|
53
|
+
const pad = " ".repeat(depth);
|
|
54
|
+
if (!el || typeof el !== "object" || Array.isArray(el) || typeof el.type !== "string" || !OP.test(el.type)) {
|
|
55
|
+
out.push(pad + JSON.stringify(el));
|
|
56
|
+
return;
|
|
57
|
+
}
|
|
58
|
+
const parts = [el.type];
|
|
59
|
+
const skip = ["type"];
|
|
60
|
+
if (typeof el.id === "string" && ID.test(el.id)) { parts.push(`#${el.id}`); skip.push("id"); }
|
|
61
|
+
if (typeof el.text === "string") { parts.push(JSON.stringify(el.text)); skip.push("text"); }
|
|
62
|
+
const kids = Array.isArray(el.children) && el.children.length
|
|
63
|
+
&& el.children.every((c) => c && typeof c === "object" && !Array.isArray(c));
|
|
64
|
+
if (kids) skip.push("children");
|
|
65
|
+
parts.push(...pairs(el, skip));
|
|
66
|
+
out.push(pad + parts.join(" "));
|
|
67
|
+
if (kids) for (const c of el.children) printElement(c, depth + 1, out);
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
function printNode(node, out) {
|
|
71
|
+
if (!node || typeof node !== "object" || Array.isArray(node)) { out.push("+ " + JSON.stringify(node)); return; }
|
|
72
|
+
const op = node.op;
|
|
73
|
+
let head;
|
|
74
|
+
if (typeof op === "string" && OP.test(op)) head = op;
|
|
75
|
+
else if (op && typeof op === "object" && !Array.isArray(op) && typeof op.name === "string" && OP.test(op.name)) {
|
|
76
|
+
head = `${op.name}(${pairs(op, ["name"]).join(", ")})`;
|
|
77
|
+
} else { out.push("+ " + JSON.stringify(node)); return; }
|
|
78
|
+
const parts = [head];
|
|
79
|
+
const skip = ["op"];
|
|
80
|
+
if (Array.isArray(node.target) && node.target.length
|
|
81
|
+
&& node.target.every((t) => typeof t === "string" && BARE.test(t) && !NUM.test(t) && !t.startsWith("@"))) {
|
|
82
|
+
parts.push(...node.target);
|
|
83
|
+
skip.push("target");
|
|
84
|
+
}
|
|
85
|
+
const r = node.range;
|
|
86
|
+
if (Array.isArray(r) && r.length === 2 && Number.isInteger(r[0]) && Number.isInteger(r[1]) && r[0] >= 0 && r[1] >= 0) {
|
|
87
|
+
parts.push(`@${r[0]}-${r[1]}`);
|
|
88
|
+
skip.push("range");
|
|
89
|
+
}
|
|
90
|
+
parts.push(...pairs(node, skip));
|
|
91
|
+
out.push("+ " + parts.join(" "));
|
|
92
|
+
}
|
|
93
|
+
|
|
94
|
+
/** The pair as lines. */
|
|
95
|
+
export function printLines({ elements = [], nodes = [] } = {}) {
|
|
96
|
+
const out = [];
|
|
97
|
+
for (const el of elements) printElement(el, 0, out);
|
|
98
|
+
for (const n of nodes) printNode(n, out);
|
|
99
|
+
return out.join("\n") + (out.length ? "\n" : "");
|
|
100
|
+
}
|
|
101
|
+
|
|
102
|
+
// ── parsing ──────────────────────────────────────────────────────────
|
|
103
|
+
|
|
104
|
+
/** Length of a JSON string literal starting at i (s[i] === '"'), or -1. */
|
|
105
|
+
function stringEnd(s, i) {
|
|
106
|
+
for (let j = i + 1; j < s.length; j++) {
|
|
107
|
+
if (s[j] === "\\") { j++; continue; }
|
|
108
|
+
if (s[j] === '"') return j + 1;
|
|
109
|
+
}
|
|
110
|
+
return -1;
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
/** End index of a balanced [..], {..} or (..) starting at i. */
|
|
114
|
+
function balancedEnd(s, i) {
|
|
115
|
+
const open = s[i];
|
|
116
|
+
const close = { "[": "]", "{": "}", "(": ")" }[open];
|
|
117
|
+
let depth = 0;
|
|
118
|
+
for (let j = i; j < s.length; j++) {
|
|
119
|
+
const c = s[j];
|
|
120
|
+
if (c === '"') { const e = stringEnd(s, j); if (e < 0) return -1; j = e - 1; continue; }
|
|
121
|
+
if (c === "[" || c === "{" || c === "(") depth++;
|
|
122
|
+
else if (c === "]" || c === "}" || c === ")") { depth--; if (depth === 0) return c === close ? j + 1 : -1; }
|
|
123
|
+
}
|
|
124
|
+
return -1;
|
|
125
|
+
}
|
|
126
|
+
|
|
127
|
+
/** Split a line into raw tokens: strings, bracketed groups and words, keeping key=value together. */
|
|
128
|
+
function tokens(s) {
|
|
129
|
+
const out = [];
|
|
130
|
+
let i = 0;
|
|
131
|
+
while (i < s.length) {
|
|
132
|
+
if (/\s|,/.test(s[i])) { i++; continue; }
|
|
133
|
+
let j = i;
|
|
134
|
+
while (j < s.length && !/\s|,/.test(s[j])) {
|
|
135
|
+
if (s[j] === '"') { const e = stringEnd(s, j); if (e < 0) throw new Error("unterminated string"); j = e; continue; }
|
|
136
|
+
if (s[j] === "[" || s[j] === "{" || s[j] === "(") {
|
|
137
|
+
const e = balancedEnd(s, j);
|
|
138
|
+
if (e < 0) throw new Error(`unbalanced ${s[j]}`);
|
|
139
|
+
j = e;
|
|
140
|
+
continue;
|
|
141
|
+
}
|
|
142
|
+
j++;
|
|
143
|
+
}
|
|
144
|
+
out.push(s.slice(i, j));
|
|
145
|
+
i = j;
|
|
146
|
+
}
|
|
147
|
+
return out;
|
|
148
|
+
}
|
|
149
|
+
|
|
150
|
+
function parseValue(raw) {
|
|
151
|
+
if (raw === "") throw new Error("empty value");
|
|
152
|
+
if (raw[0] === '"' || raw[0] === "[" || raw[0] === "{") return JSON.parse(raw);
|
|
153
|
+
if (NUM.test(raw)) return Number(raw);
|
|
154
|
+
if (raw === "true") return true;
|
|
155
|
+
if (raw === "false") return false;
|
|
156
|
+
if (raw === "null") return null;
|
|
157
|
+
return raw;
|
|
158
|
+
}
|
|
159
|
+
|
|
160
|
+
/** "k=v" -> [k, v], or null when the token is not a pair. */
|
|
161
|
+
function pair(tok) {
|
|
162
|
+
let k, rest;
|
|
163
|
+
if (tok[0] === '"') {
|
|
164
|
+
const e = stringEnd(tok, 0);
|
|
165
|
+
if (e < 0 || tok[e] !== "=") return null;
|
|
166
|
+
k = JSON.parse(tok.slice(0, e));
|
|
167
|
+
rest = tok.slice(e + 1);
|
|
168
|
+
} else {
|
|
169
|
+
const m = /^([A-Za-z_$][\w$-]*)=(.*)$/s.exec(tok);
|
|
170
|
+
if (!m) return null;
|
|
171
|
+
k = m[1];
|
|
172
|
+
rest = m[2];
|
|
173
|
+
}
|
|
174
|
+
return [k, parseValue(rest)];
|
|
175
|
+
}
|
|
176
|
+
|
|
177
|
+
function parseNodeLine(body) {
|
|
178
|
+
if (body[0] === "{") return JSON.parse(body);
|
|
179
|
+
const toks = tokens(body);
|
|
180
|
+
if (!toks.length) throw new Error("empty node");
|
|
181
|
+
const m = /^([A-Za-z][\w-]*)(\(.*\))?$/s.exec(toks[0]);
|
|
182
|
+
if (!m) throw new Error(`not an op: ${toks[0]}`);
|
|
183
|
+
const node = {};
|
|
184
|
+
if (m[2] !== undefined) {
|
|
185
|
+
const op = { name: m[1] };
|
|
186
|
+
for (const t of tokens(m[2].slice(1, -1))) {
|
|
187
|
+
const p = pair(t);
|
|
188
|
+
if (!p) throw new Error(`op parameter is not key=value: ${t}`);
|
|
189
|
+
op[p[0]] = p[1];
|
|
190
|
+
}
|
|
191
|
+
node.op = op;
|
|
192
|
+
} else node.op = m[1];
|
|
193
|
+
const target = [];
|
|
194
|
+
for (const t of toks.slice(1)) {
|
|
195
|
+
const p = pair(t);
|
|
196
|
+
if (p) { node[p[0]] = p[1]; continue; }
|
|
197
|
+
const r = /^@(\d+)-(\d+)$/.exec(t);
|
|
198
|
+
if (r) { node.range = [Number(r[1]), Number(r[2])]; continue; }
|
|
199
|
+
if (t[0] === '"') { target.push(JSON.parse(t)); continue; }
|
|
200
|
+
target.push(t);
|
|
201
|
+
}
|
|
202
|
+
if (target.length) {
|
|
203
|
+
// Keep `target` right after `op`, as written.
|
|
204
|
+
const { op, ...rest } = node;
|
|
205
|
+
return { op, target, ...rest };
|
|
206
|
+
}
|
|
207
|
+
return node;
|
|
208
|
+
}
|
|
209
|
+
|
|
210
|
+
function parseElementLine(body) {
|
|
211
|
+
if (body[0] === "{") return JSON.parse(body);
|
|
212
|
+
const toks = tokens(body);
|
|
213
|
+
if (!OP.test(toks[0] || "")) throw new Error(`not an element type: ${toks[0]}`);
|
|
214
|
+
const el = { type: toks[0] };
|
|
215
|
+
for (const t of toks.slice(1)) {
|
|
216
|
+
const p = pair(t);
|
|
217
|
+
if (p) { el[p[0]] = p[1]; continue; }
|
|
218
|
+
if (t[0] === "#" && ID.test(t.slice(1)) && el.id === undefined) { el.id = t.slice(1); continue; }
|
|
219
|
+
if (t[0] === '"' && el.text === undefined) { el.text = JSON.parse(t); continue; }
|
|
220
|
+
throw new Error(`unexpected ${t}`);
|
|
221
|
+
}
|
|
222
|
+
return el;
|
|
223
|
+
}
|
|
224
|
+
|
|
225
|
+
/**
|
|
226
|
+
* Lines -> { elements, nodes, errors }. A line that cannot be read is
|
|
227
|
+
* reported with its number and skipped; the rest still parses, so a stream
|
|
228
|
+
* cut mid-line loses only that line.
|
|
229
|
+
*/
|
|
230
|
+
export function parseLines(text) {
|
|
231
|
+
const elements = [];
|
|
232
|
+
const nodes = [];
|
|
233
|
+
const errors = [];
|
|
234
|
+
const stack = []; // [{ depth, el }]
|
|
235
|
+
String(text == null ? "" : text).split("\n").forEach((raw, i) => {
|
|
236
|
+
const line = i + 1;
|
|
237
|
+
if (!raw.trim() || raw.trim().startsWith("//")) return;
|
|
238
|
+
const indent = raw.length - raw.trimStart().length;
|
|
239
|
+
const body = raw.trim();
|
|
240
|
+
try {
|
|
241
|
+
if (body.startsWith("+")) {
|
|
242
|
+
nodes.push(parseNodeLine(body.slice(1).trim()));
|
|
243
|
+
return;
|
|
244
|
+
}
|
|
245
|
+
if (indent % 2) throw new Error("indent by two spaces");
|
|
246
|
+
const depth = indent / 2;
|
|
247
|
+
const el = parseElementLine(body);
|
|
248
|
+
while (stack.length && stack[stack.length - 1].depth >= depth) stack.pop();
|
|
249
|
+
if (depth === 0) elements.push(el);
|
|
250
|
+
else {
|
|
251
|
+
const parent = stack[stack.length - 1];
|
|
252
|
+
if (!parent || parent.depth !== depth - 1) throw new Error("indented with no parent one level up");
|
|
253
|
+
if (!Array.isArray(parent.el.children)) parent.el.children = [];
|
|
254
|
+
parent.el.children.push(el);
|
|
255
|
+
}
|
|
256
|
+
stack.push({ depth, el });
|
|
257
|
+
} catch (e) {
|
|
258
|
+
errors.push({ line, message: e.message, text: raw });
|
|
259
|
+
}
|
|
260
|
+
});
|
|
261
|
+
return { elements, nodes, errors };
|
|
262
|
+
}
|
package/lib/link-getter.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/*!
|
|
2
|
-
* nodality v1.5.
|
|
2
|
+
* nodality v1.5.5
|
|
3
3
|
* (c) 2026 Filip Vabrousek
|
|
4
4
|
* License: MIT
|
|
5
5
|
*/
|
|
@@ -64,13 +64,13 @@ class LinkStyler {
|
|
|
64
64
|
}
|
|
65
65
|
}
|
|
66
66
|
|
|
67
|
-
let split = bst[j].op.ops.split("-");
|
|
67
|
+
let split = String(bst[j].op.ops || "").split("-");
|
|
68
68
|
|
|
69
69
|
// re["color"] = //bst.op.style.color;
|
|
70
70
|
|
|
71
71
|
// alert(allow);
|
|
72
72
|
|
|
73
|
-
/* let split = bst[j].op.ops.split("-");
|
|
73
|
+
/* let split = String(bst[j].op.ops || "").split("-");
|
|
74
74
|
|
|
75
75
|
if(allow && split.includes("round")){
|
|
76
76
|
re["borderObj"] = {width: 3, radius: "0.7rem", color: bst[j].op.style.color};
|
package/lib/morph-node.js
CHANGED
package/lib/normalize-spec.js
CHANGED
package/lib/op-semantics.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/*!
|
|
2
|
-
* nodality v1.5.
|
|
2
|
+
* nodality v1.5.5
|
|
3
3
|
* (c) 2026 Filip Vabrousek
|
|
4
4
|
* License: MIT
|
|
5
5
|
*/
|
|
@@ -30,7 +30,7 @@
|
|
|
30
30
|
*
|
|
31
31
|
* Pure module: no DOM at import.
|
|
32
32
|
*/
|
|
33
|
-
import { RASTER_OP_NAMES } from "./raster-ops.js";
|
|
33
|
+
import { RASTER_OP_NAMES, REGISTRY } from "./raster-ops.js";
|
|
34
34
|
|
|
35
35
|
const MAX_WIDTH = 99999;
|
|
36
36
|
|
|
@@ -176,3 +176,92 @@ export function shadowedNodes(nodes) {
|
|
|
176
176
|
});
|
|
177
177
|
return out;
|
|
178
178
|
}
|
|
179
|
+
|
|
180
|
+
/**
|
|
181
|
+
* What applies to one element, at every viewport width, and why.
|
|
182
|
+
*
|
|
183
|
+
* Static: computed from the nodes alone, no browser. For each op that
|
|
184
|
+
* reaches the element it names the node that decides it and the nodes that
|
|
185
|
+
* lose. `arrange` is the one op that reads `range`, so it is answered per
|
|
186
|
+
* width interval; every other op decides the same at every width.
|
|
187
|
+
*
|
|
188
|
+
* { element, ops: [
|
|
189
|
+
* { op, combine: "first", node, shadowed: [i...] },
|
|
190
|
+
* { op: "arrange", combine: "first", intervals: [{ range, node, shadowed }] },
|
|
191
|
+
* { op, combine: "sequence", stage, nodes: [i...] }, // in apply order
|
|
192
|
+
* ],
|
|
193
|
+
* page: [{ op, node, shadowed }], // page-wide ops (layout, card-style...)
|
|
194
|
+
* inert: [i...] }
|
|
195
|
+
*/
|
|
196
|
+
export function explainElement(nodes, elementId) {
|
|
197
|
+
const id = bare(elementId);
|
|
198
|
+
const list = Array.isArray(nodes) ? nodes : [];
|
|
199
|
+
const reaches = (node, sem) => {
|
|
200
|
+
if (sem.scope === "page") return true;
|
|
201
|
+
const t = Array.isArray(node.target) && node.target.length ? node.target.map(bare) : null;
|
|
202
|
+
if (!t) return sem.scope !== "range";
|
|
203
|
+
return sem.firstTargetOnly ? t[0] === id : t.includes(id);
|
|
204
|
+
};
|
|
205
|
+
const firsts = new Map(); // slot -> { op, node, shadowed }
|
|
206
|
+
const pageWide = new Map();
|
|
207
|
+
const arranges = []; // { index, lo, hi }
|
|
208
|
+
const sequences = new Map(); // op|stage -> { op, stage, nodes }
|
|
209
|
+
const inert = [];
|
|
210
|
+
|
|
211
|
+
list.forEach((node, index) => {
|
|
212
|
+
const name = opName(node);
|
|
213
|
+
const sem = name && OP_SEMANTICS[name];
|
|
214
|
+
if (!sem || !reaches(node, sem)) return;
|
|
215
|
+
if (sem.combine === "inert") { inert.push(index); return; }
|
|
216
|
+
if (sem.combine === "sequence") {
|
|
217
|
+
const stages = sem.byStage
|
|
218
|
+
? [].concat((REGISTRY[name] && REGISTRY[name].stage) || "color")
|
|
219
|
+
: [null];
|
|
220
|
+
for (const stage of stages) {
|
|
221
|
+
const key = sem.byStage ? `stage:${stage}` : name;
|
|
222
|
+
if (!sequences.has(key)) sequences.set(key, { op: sem.byStage ? null : name, stage, nodes: [] });
|
|
223
|
+
sequences.get(key).nodes.push(index);
|
|
224
|
+
}
|
|
225
|
+
return;
|
|
226
|
+
}
|
|
227
|
+
if (sem.scope === "range") {
|
|
228
|
+
const [lo, hi] = rangeOf(node);
|
|
229
|
+
arranges.push({ index, lo, hi });
|
|
230
|
+
return;
|
|
231
|
+
}
|
|
232
|
+
const slot = sem.slot || name;
|
|
233
|
+
const map = sem.scope === "page" ? pageWide : firsts;
|
|
234
|
+
if (!map.has(slot)) map.set(slot, { op: slot, combine: "first", node: index, shadowed: [] });
|
|
235
|
+
else map.get(slot).shadowed.push(index);
|
|
236
|
+
});
|
|
237
|
+
|
|
238
|
+
const ops = [...firsts.values()];
|
|
239
|
+
if (arranges.length) {
|
|
240
|
+
// Cut the width axis at every range end; each piece's winner is the
|
|
241
|
+
// first declared node covering it.
|
|
242
|
+
const cuts = new Set([0, MAX_WIDTH + 1]);
|
|
243
|
+
for (const a of arranges) { cuts.add(a.lo); cuts.add(a.hi + 1); }
|
|
244
|
+
const pts = [...cuts].filter((x) => x >= 0 && x <= MAX_WIDTH + 1).sort((a, b) => a - b);
|
|
245
|
+
const intervals = [];
|
|
246
|
+
for (let i = 0; i + 1 < pts.length; i++) {
|
|
247
|
+
const lo = pts[i], hi = pts[i + 1] - 1;
|
|
248
|
+
const cover = arranges.filter((a) => a.lo <= lo && hi <= a.hi);
|
|
249
|
+
if (!cover.length) continue;
|
|
250
|
+
const last = intervals[intervals.length - 1];
|
|
251
|
+
const node = cover[0].index;
|
|
252
|
+
const shadowed = cover.slice(1).map((c) => c.index);
|
|
253
|
+
if (last && last.node === node && last.range[1] + 1 === lo
|
|
254
|
+
&& JSON.stringify(last.shadowed) === JSON.stringify(shadowed)) last.range[1] = hi;
|
|
255
|
+
else intervals.push({ range: [lo, hi], node, shadowed });
|
|
256
|
+
}
|
|
257
|
+
ops.push({ op: "arrange", combine: "first", intervals });
|
|
258
|
+
}
|
|
259
|
+
const order = ["field", "warp", "cell", "displace", "color", null];
|
|
260
|
+
const seq = [...sequences.values()].sort((a, b) => order.indexOf(a.stage) - order.indexOf(b.stage));
|
|
261
|
+
for (const s of seq) {
|
|
262
|
+
ops.push(s.stage
|
|
263
|
+
? { op: "raster", combine: "sequence", stage: s.stage, nodes: s.nodes }
|
|
264
|
+
: { op: s.op, combine: "sequence", nodes: s.nodes });
|
|
265
|
+
}
|
|
266
|
+
return { element: id, ops, page: [...pageWide.values()], inert };
|
|
267
|
+
}
|
package/lib/parse-html.js
CHANGED
package/lib/raster-inspect.js
CHANGED
package/lib/raster-ops.js
CHANGED
package/lib/raster-presets.js
CHANGED
package/lib/react.js
CHANGED
package/lib/resolve-refs.js
CHANGED
package/lib/responsive.js
CHANGED
package/lib/scroll-video.js
CHANGED
package/lib/seo.js
CHANGED
package/lib/stacker.js
CHANGED
package/lib/suggest.js
CHANGED
package/lib/theme.js
CHANGED
package/lib/transform-anim.js
CHANGED
package/lib/transition.js
CHANGED
package/lib/validate-nodes.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/*!
|
|
2
|
-
* nodality v1.5.
|
|
2
|
+
* nodality v1.5.5
|
|
3
3
|
* (c) 2026 Filip Vabrousek
|
|
4
4
|
* License: MIT
|
|
5
5
|
*/
|
|
@@ -195,6 +195,14 @@ const BARE_DESIGN_OPS = [
|
|
|
195
195
|
* node that works, and `preview` refuses to render an invalid pair, so
|
|
196
196
|
* over-reporting costs more than under-reporting.
|
|
197
197
|
*/
|
|
198
|
+
/** Element fields the renderer cannot do without, per type. */
|
|
199
|
+
const REQUIRED_FIELDS = {
|
|
200
|
+
video: [["url", "the video's URL"]],
|
|
201
|
+
audio: [["url", "the audio file's URL"]],
|
|
202
|
+
multiswitcher: [["breakpoints", "a non-empty array of { at, view }"]],
|
|
203
|
+
simple: [["react", "a non-empty array of { at, template }"]],
|
|
204
|
+
};
|
|
205
|
+
|
|
198
206
|
export const DESIGN_OP_NAMES = [
|
|
199
207
|
"animation", "arrange", "background", "blast", "card-style", "filter", "gradient",
|
|
200
208
|
"layout", "link-style", "margin", "navStyle", "shadow", "slayout",
|
|
@@ -498,6 +506,18 @@ export function validateNodes(nodes, elements, defs) {
|
|
|
498
506
|
push("UNKNOWN_ELEMENT_TYPE", `${p}.type`, el.type,
|
|
499
507
|
suggest(el.type, ELEMENT_TYPES), ELEMENT_TYPES);
|
|
500
508
|
}
|
|
509
|
+
// Fields without which the renderer refuses the element.
|
|
510
|
+
// Validating clean and then throwing at render time is the
|
|
511
|
+
// failure the conformance test exists to rule out.
|
|
512
|
+
const need = REQUIRED_FIELDS[el.type];
|
|
513
|
+
if (need) {
|
|
514
|
+
for (const [field, what] of need) {
|
|
515
|
+
const v = el[field];
|
|
516
|
+
if (v == null || v === "" || (Array.isArray(v) && !v.length)) {
|
|
517
|
+
push("MISSING_FIELD", `${p}.${field}`, v, [], [what]);
|
|
518
|
+
}
|
|
519
|
+
}
|
|
520
|
+
}
|
|
501
521
|
// Content declared in the slot this type does not read.
|
|
502
522
|
// `{type:"table", children:[...]}` validated clean and then
|
|
503
523
|
// rendered its placeholders — the exact silent no-op Stage 1
|
package/lib/view-transition.js
CHANGED
package/lib/webmcp-adapter.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/*!
|
|
2
|
-
* nodality v1.5.
|
|
2
|
+
* nodality v1.5.5
|
|
3
3
|
* (c) 2026 Filip Vabrousek
|
|
4
4
|
* License: MIT
|
|
5
5
|
*/
|
|
@@ -128,6 +128,15 @@ export function installAgentSurface({ mount, elements, nodes, morphs }) {
|
|
|
128
128
|
if (!derived) return null; // opt-in: no node, no surface
|
|
129
129
|
|
|
130
130
|
const { tools, manifest } = derived;
|
|
131
|
+
// Views the page author excluded. The schema leaves them out of the
|
|
132
|
+
// enum, but an agent can still name one, and a graph edge may lead
|
|
133
|
+
// there; so the runtime refuses them too, and never returns their
|
|
134
|
+
// content or lists them in a refusal.
|
|
135
|
+
const excluded = new Set(derived.exclude || []);
|
|
136
|
+
const allowed = (ids) => ids.filter((id) => !excluded.has(id));
|
|
137
|
+
const contentOf = (h) => (h && excluded.has(h.current)
|
|
138
|
+
? { excluded: true }
|
|
139
|
+
: readSubtree((h && h.states.get(h.current)) || mount));
|
|
131
140
|
const handles = Array.isArray(morphs) ? morphs.filter(Boolean) : [];
|
|
132
141
|
const graphFor = (id) => handles.find((h) => h.states && h.states.has(id)) || null;
|
|
133
142
|
|
|
@@ -237,10 +246,14 @@ export function installAgentSurface({ mount, elements, nodes, morphs }) {
|
|
|
237
246
|
|
|
238
247
|
const execute = {
|
|
239
248
|
navigate: ({ destination } = {}) => serial(async () => {
|
|
249
|
+
if (excluded.has(destination)) {
|
|
250
|
+
return refuse("EXCLUDED_VIEW", destination,
|
|
251
|
+
allowed(handles.flatMap((x) => [...x.states.keys()])));
|
|
252
|
+
}
|
|
240
253
|
const h = graphFor(destination);
|
|
241
254
|
if (!h) {
|
|
242
255
|
return refuse("UNKNOWN_VIEW", destination,
|
|
243
|
-
handles.flatMap((x) => [...x.states.keys()]));
|
|
256
|
+
allowed(handles.flatMap((x) => [...x.states.keys()])));
|
|
244
257
|
}
|
|
245
258
|
// Reachability is a property of WHERE THE GRAPH IS, not of
|
|
246
259
|
// the schema, so it is answered here and not by the enum: a
|
|
@@ -251,19 +264,21 @@ export function installAgentSurface({ mount, elements, nodes, morphs }) {
|
|
|
251
264
|
if (h.current !== destination) {
|
|
252
265
|
const edge = [...h.states.keys()];
|
|
253
266
|
return refuse("UNREACHABLE_FROM_HERE", destination,
|
|
254
|
-
edge.filter((id) => id !== from));
|
|
267
|
+
allowed(edge.filter((id) => id !== from)));
|
|
255
268
|
}
|
|
256
|
-
return { ok: true, view: h.current, ...
|
|
269
|
+
return { ok: true, view: h.current, ...contentOf(h) };
|
|
257
270
|
}),
|
|
258
271
|
|
|
259
272
|
back: () => serial(async () => {
|
|
260
273
|
const h = handles.find((x) => x.history && x.history.length);
|
|
261
274
|
if (!h) return refuse("NO_HISTORY", null, []);
|
|
262
275
|
await h.goBack();
|
|
263
|
-
return { ok: true, view: h.current, ...
|
|
276
|
+
return { ok: true, view: h.current, ...contentOf(h) };
|
|
264
277
|
}),
|
|
265
278
|
|
|
266
|
-
read: async () => (
|
|
279
|
+
read: async () => (excluded.has(currentView())
|
|
280
|
+
? refuse("EXCLUDED_VIEW", currentView(), [])
|
|
281
|
+
: { ok: true, view: currentView(), ...readSubtree(currentSubtree()) }),
|
|
267
282
|
|
|
268
283
|
// What the product box shows now: the live rendering once Shopify has
|
|
269
284
|
// answered (its placeholder is hidden then), the static copy before.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "nodality",
|
|
3
|
-
"version": "1.5.
|
|
3
|
+
"version": "1.5.5",
|
|
4
4
|
"description": "A UI is two arrays: what exists, and what is done to it. Zero-dependency declarative UI library with build-time prerendering, composable WebGL effects, and an MCP server and validator for coding agents.",
|
|
5
5
|
"main": "dist/index.cjs.js",
|
|
6
6
|
"module": "dist/index.esm.js",
|
|
@@ -41,6 +41,7 @@
|
|
|
41
41
|
"./transition": "./lib/transition.js",
|
|
42
42
|
"./view-transition": "./lib/view-transition.js",
|
|
43
43
|
"./responsive": "./lib/responsive.js",
|
|
44
|
+
"./lines": "./lib/lines.js",
|
|
44
45
|
"./designer": "./lib/designer.js",
|
|
45
46
|
"./react": {
|
|
46
47
|
"types": "./lib/react.d.ts",
|
package/skills/nodality/SKILL.md
CHANGED
|
@@ -62,6 +62,10 @@ appear in sessions started where `.mcp.json` lives.
|
|
|
62
62
|
against real ids and E itself is validated. The report never throws;
|
|
63
63
|
repair from its `did-you-mean` suggestions and re-validate until
|
|
64
64
|
clean.
|
|
65
|
+
3b. **`explain_element` before changing how something looks.** It names
|
|
66
|
+
the node that decides each property of an element, at every width,
|
|
67
|
+
and the nodes that lose. Edit the deciding node; a node appended
|
|
68
|
+
after it does nothing (`SHADOWED_NODE`).
|
|
65
69
|
4. **`preview` to render.** Pass `viewport: "desktop"` to see the wide side of anything chosen by width (the default is a phone); the report lists ids that rendered `empty` instead of leaving a blank page to look finished.
|
|
66
70
|
It writes a self-contained HTML file through
|
|
67
71
|
the jsdom prerenderer. Know the boundary: the file is prerendered DOM
|