nodality 1.5.3 → 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.
Files changed (292) hide show
  1. package/README.md +7 -4
  2. package/bin/mcp-server.mjs +23 -1
  3. package/dist/animator.cjs.js +1 -1
  4. package/dist/animator.cjs.js.LICENSE.txt +1 -1
  5. package/dist/animator.esm.js +1 -1
  6. package/dist/animator.esm.js.LICENSE.txt +1 -1
  7. package/dist/audionew.cjs.js +1 -1
  8. package/dist/audionew.cjs.js.LICENSE.txt +1 -1
  9. package/dist/audionew.esm.js +1 -1
  10. package/dist/audionew.esm.js.LICENSE.txt +1 -1
  11. package/dist/base.cjs.js +1 -1
  12. package/dist/base.cjs.js.LICENSE.txt +1 -1
  13. package/dist/base.esm.js +1 -1
  14. package/dist/base.esm.js.LICENSE.txt +1 -1
  15. package/dist/beta-desktop-bar.cjs.js +1 -1
  16. package/dist/beta-desktop-bar.cjs.js.LICENSE.txt +1 -1
  17. package/dist/beta-desktop-bar.esm.js +1 -1
  18. package/dist/beta-desktop-bar.esm.js.LICENSE.txt +1 -1
  19. package/dist/beta-mobile-bar.cjs.js +1 -1
  20. package/dist/beta-mobile-bar.cjs.js.LICENSE.txt +1 -1
  21. package/dist/beta-mobile-bar.esm.js +1 -1
  22. package/dist/beta-mobile-bar.esm.js.LICENSE.txt +1 -1
  23. package/dist/bundle.umd.js +1 -1
  24. package/dist/bundle.umd.js.LICENSE.txt +1 -1
  25. package/dist/button.cjs.js +1 -1
  26. package/dist/button.cjs.js.LICENSE.txt +1 -1
  27. package/dist/button.esm.js +1 -1
  28. package/dist/button.esm.js.LICENSE.txt +1 -1
  29. package/dist/card-getter.cjs.js.LICENSE.txt +1 -1
  30. package/dist/card-getter.esm.js.LICENSE.txt +1 -1
  31. package/dist/center.cjs.js +1 -1
  32. package/dist/center.cjs.js.LICENSE.txt +1 -1
  33. package/dist/center.esm.js +1 -1
  34. package/dist/center.esm.js.LICENSE.txt +1 -1
  35. package/dist/checkbox.cjs.js +1 -1
  36. package/dist/checkbox.cjs.js.LICENSE.txt +1 -1
  37. package/dist/checkbox.esm.js +1 -1
  38. package/dist/checkbox.esm.js.LICENSE.txt +1 -1
  39. package/dist/code.cjs.js +1 -1
  40. package/dist/code.cjs.js.LICENSE.txt +1 -1
  41. package/dist/code.esm.js +1 -1
  42. package/dist/code.esm.js.LICENSE.txt +1 -1
  43. package/dist/container.cjs.js +1 -1
  44. package/dist/container.cjs.js.LICENSE.txt +1 -1
  45. package/dist/container.esm.js +1 -1
  46. package/dist/container.esm.js.LICENSE.txt +1 -1
  47. package/dist/data-list.cjs.js.LICENSE.txt +1 -1
  48. package/dist/data-list.esm.js.LICENSE.txt +1 -1
  49. package/dist/designer.cjs.js +1 -1
  50. package/dist/designer.cjs.js.LICENSE.txt +1 -1
  51. package/dist/designer.esm.js +1 -1
  52. package/dist/designer.esm.js.LICENSE.txt +1 -1
  53. package/dist/element-mapper.cjs.js +1 -1
  54. package/dist/element-mapper.cjs.js.LICENSE.txt +1 -1
  55. package/dist/element-mapper.esm.js +1 -1
  56. package/dist/element-mapper.esm.js.LICENSE.txt +1 -1
  57. package/dist/finalresult.esm.js +1 -1
  58. package/dist/finalresult.esm.js.LICENSE.txt +1 -1
  59. package/dist/flex-card.cjs.js +1 -1
  60. package/dist/flex-card.cjs.js.LICENSE.txt +1 -1
  61. package/dist/flex-card.esm.js +1 -1
  62. package/dist/flex-card.esm.js.LICENSE.txt +1 -1
  63. package/dist/flex-grid.cjs.js +1 -1
  64. package/dist/flex-grid.cjs.js.LICENSE.txt +1 -1
  65. package/dist/flex-grid.esm.js +1 -1
  66. package/dist/flex-grid.esm.js.LICENSE.txt +1 -1
  67. package/dist/flex-row.cjs.js +1 -1
  68. package/dist/flex-row.cjs.js.LICENSE.txt +1 -1
  69. package/dist/flex-row.esm.js +1 -1
  70. package/dist/flex-row.esm.js.LICENSE.txt +1 -1
  71. package/dist/floating-input.cjs.js +1 -1
  72. package/dist/floating-input.cjs.js.LICENSE.txt +1 -1
  73. package/dist/floating-input.esm.js +1 -1
  74. package/dist/floating-input.esm.js.LICENSE.txt +1 -1
  75. package/dist/free.cjs.js +1 -1
  76. package/dist/free.cjs.js.LICENSE.txt +1 -1
  77. package/dist/free.esm.js +1 -1
  78. package/dist/free.esm.js.LICENSE.txt +1 -1
  79. package/dist/horizontal-scroller.cjs.js.LICENSE.txt +1 -1
  80. package/dist/horizontal-scroller.esm.js.LICENSE.txt +1 -1
  81. package/dist/image-picker.cjs.js +1 -1
  82. package/dist/image-picker.cjs.js.LICENSE.txt +1 -1
  83. package/dist/image-picker.esm.js +1 -1
  84. package/dist/image-picker.esm.js.LICENSE.txt +1 -1
  85. package/dist/image.cjs.js +1 -1
  86. package/dist/image.cjs.js.LICENSE.txt +1 -1
  87. package/dist/image.esm.js +1 -1
  88. package/dist/image.esm.js.LICENSE.txt +1 -1
  89. package/dist/index.cjs.js +1 -1
  90. package/dist/index.cjs.js.LICENSE.txt +1 -1
  91. package/dist/index.d.ts +3 -2
  92. package/dist/index.esm.js +1 -1
  93. package/dist/index.esm.js.LICENSE.txt +1 -1
  94. package/dist/keyframe-animation.cjs.js.LICENSE.txt +1 -1
  95. package/dist/keyframe-animation.esm.js.LICENSE.txt +1 -1
  96. package/dist/link-getter.cjs.js +1 -1
  97. package/dist/link-getter.cjs.js.LICENSE.txt +1 -1
  98. package/dist/link-getter.esm.js +1 -1
  99. package/dist/link-getter.esm.js.LICENSE.txt +1 -1
  100. package/dist/link.cjs.js +1 -1
  101. package/dist/link.cjs.js.LICENSE.txt +1 -1
  102. package/dist/link.esm.js +1 -1
  103. package/dist/link.esm.js.LICENSE.txt +1 -1
  104. package/dist/meta-adder.cjs.js +1 -1
  105. package/dist/meta-adder.cjs.js.LICENSE.txt +1 -1
  106. package/dist/meta-adder.esm.js +1 -1
  107. package/dist/meta-adder.esm.js.LICENSE.txt +1 -1
  108. package/dist/modal-2025.cjs.js +1 -1
  109. package/dist/modal-2025.cjs.js.LICENSE.txt +1 -1
  110. package/dist/modal-2025.esm.js +1 -1
  111. package/dist/modal-2025.esm.js.LICENSE.txt +1 -1
  112. package/dist/multiswitcher.cjs.js +1 -1
  113. package/dist/multiswitcher.cjs.js.LICENSE.txt +1 -1
  114. package/dist/multiswitcher.esm.js +1 -1
  115. package/dist/multiswitcher.esm.js.LICENSE.txt +1 -1
  116. package/dist/new-nav-bar.cjs.js +1 -1
  117. package/dist/new-nav-bar.cjs.js.LICENSE.txt +1 -1
  118. package/dist/new-nav-bar.esm.js +1 -1
  119. package/dist/new-nav-bar.esm.js.LICENSE.txt +1 -1
  120. package/dist/picker.cjs.js +1 -1
  121. package/dist/picker.cjs.js.LICENSE.txt +1 -1
  122. package/dist/picker.esm.js +1 -1
  123. package/dist/picker.esm.js.LICENSE.txt +1 -1
  124. package/dist/progress.cjs.js +1 -1
  125. package/dist/progress.cjs.js.LICENSE.txt +1 -1
  126. package/dist/progress.esm.js +1 -1
  127. package/dist/progress.esm.js.LICENSE.txt +1 -1
  128. package/dist/radio.cjs.js.LICENSE.txt +1 -1
  129. package/dist/radio.esm.js.LICENSE.txt +1 -1
  130. package/dist/range.cjs.js.LICENSE.txt +1 -1
  131. package/dist/range.esm.js.LICENSE.txt +1 -1
  132. package/dist/scroll-video.cjs.js.LICENSE.txt +1 -1
  133. package/dist/scroll-video.esm.js.LICENSE.txt +1 -1
  134. package/dist/side-bar.cjs.js +1 -1
  135. package/dist/side-bar.cjs.js.LICENSE.txt +1 -1
  136. package/dist/side-bar.esm.js +1 -1
  137. package/dist/side-bar.esm.js.LICENSE.txt +1 -1
  138. package/dist/side-nav-bar.cjs.js +1 -1
  139. package/dist/side-nav-bar.cjs.js.LICENSE.txt +1 -1
  140. package/dist/side-nav-bar.esm.js +1 -1
  141. package/dist/side-nav-bar.esm.js.LICENSE.txt +1 -1
  142. package/dist/simple-bar.cjs.js +1 -1
  143. package/dist/simple-bar.cjs.js.LICENSE.txt +1 -1
  144. package/dist/simple-bar.esm.js +1 -1
  145. package/dist/simple-bar.esm.js.LICENSE.txt +1 -1
  146. package/dist/slider-2025.cjs.js +1 -1
  147. package/dist/slider-2025.cjs.js.LICENSE.txt +1 -1
  148. package/dist/slider-2025.esm.js +1 -1
  149. package/dist/slider-2025.esm.js.LICENSE.txt +1 -1
  150. package/dist/spacer.cjs.js +1 -1
  151. package/dist/spacer.cjs.js.LICENSE.txt +1 -1
  152. package/dist/spacer.esm.js +1 -1
  153. package/dist/spacer.esm.js.LICENSE.txt +1 -1
  154. package/dist/stack.cjs.js +1 -1
  155. package/dist/stack.cjs.js.LICENSE.txt +1 -1
  156. package/dist/stack.esm.js +1 -1
  157. package/dist/stack.esm.js.LICENSE.txt +1 -1
  158. package/dist/stacker.cjs.js.LICENSE.txt +1 -1
  159. package/dist/stacker.esm.js.LICENSE.txt +1 -1
  160. package/dist/table.cjs.js +1 -1
  161. package/dist/table.cjs.js.LICENSE.txt +1 -1
  162. package/dist/table.esm.js +1 -1
  163. package/dist/table.esm.js.LICENSE.txt +1 -1
  164. package/dist/text-field.cjs.js +1 -1
  165. package/dist/text-field.cjs.js.LICENSE.txt +1 -1
  166. package/dist/text-field.esm.js +1 -1
  167. package/dist/text-field.esm.js.LICENSE.txt +1 -1
  168. package/dist/text.cjs.js +1 -1
  169. package/dist/text.cjs.js.LICENSE.txt +1 -1
  170. package/dist/text.esm.js +1 -1
  171. package/dist/text.esm.js.LICENSE.txt +1 -1
  172. package/dist/theme.cjs.js.LICENSE.txt +1 -1
  173. package/dist/theme.esm.js.LICENSE.txt +1 -1
  174. package/dist/transform-anim.cjs.js.LICENSE.txt +1 -1
  175. package/dist/transform-anim.esm.js.LICENSE.txt +1 -1
  176. package/dist/ulist.cjs.js +1 -1
  177. package/dist/ulist.cjs.js.LICENSE.txt +1 -1
  178. package/dist/ulist.esm.js +1 -1
  179. package/dist/ulist.esm.js.LICENSE.txt +1 -1
  180. package/dist/video.cjs.js +1 -1
  181. package/dist/video.cjs.js.LICENSE.txt +1 -1
  182. package/dist/video.esm.js +1 -1
  183. package/dist/video.esm.js.LICENSE.txt +1 -1
  184. package/dist/wrap.cjs.js +1 -1
  185. package/dist/wrap.cjs.js.LICENSE.txt +1 -1
  186. package/dist/wrap.esm.js +1 -1
  187. package/dist/wrap.esm.js.LICENSE.txt +1 -1
  188. package/dist/zoom-card.cjs.js +1 -1
  189. package/dist/zoom-card.cjs.js.LICENSE.txt +1 -1
  190. package/dist/zoom-card.esm.js +1 -1
  191. package/dist/zoom-card.esm.js.LICENSE.txt +1 -1
  192. package/layout/animator.js +6 -2
  193. package/layout/audio.js +1 -1
  194. package/layout/audionew.js +1 -1
  195. package/layout/base.js +1 -1
  196. package/layout/beta-desktop-bar.js +1 -1
  197. package/layout/beta-mobile-bar.js +1 -1
  198. package/layout/button.js +1 -1
  199. package/layout/center.js +1 -1
  200. package/layout/checkbox.js +1 -1
  201. package/layout/circle.js +3 -3
  202. package/layout/code.js +2 -2
  203. package/layout/container.js +2 -2
  204. package/layout/dropdown-2025.js +1 -1
  205. package/layout/flex-card.js +2 -2
  206. package/layout/flex-grid.js +2 -2
  207. package/layout/flex-row.js +2 -2
  208. package/layout/form-components/custom.js +1 -1
  209. package/layout/form-components/data-list.js +1 -1
  210. package/layout/form-components/floating-input.js +1 -1
  211. package/layout/form-components/form-all.js +1 -1
  212. package/layout/form-components/form.js +1 -1
  213. package/layout/form-components/image-picker.js +1 -1
  214. package/layout/form-components/picker.js +1 -1
  215. package/layout/form-components/radio.js +1 -1
  216. package/layout/form-components/radiogroup.js +1 -1
  217. package/layout/form-components/range.js +1 -1
  218. package/layout/free.js +1 -1
  219. package/layout/grid-overlay.js +1 -1
  220. package/layout/grid-switcher.js +1 -1
  221. package/layout/grid.js +1 -1
  222. package/layout/horizontal-scroller.js +1 -1
  223. package/layout/image.js +1 -1
  224. package/layout/index.js +1 -1
  225. package/layout/link.js +2 -2
  226. package/layout/list.js +1 -1
  227. package/layout/meta-adder.js +1 -1
  228. package/layout/modal-2025.js +1 -1
  229. package/layout/morph.js +1 -1
  230. package/layout/multiswitcher.js +1 -1
  231. package/layout/nav-bar.js +1 -1
  232. package/layout/nav-factor/custom-div.js +1 -1
  233. package/layout/new-nav-bar.js +1 -1
  234. package/layout/polygon.js +3 -3
  235. package/layout/prerender-site.js +1 -1
  236. package/layout/prerender.js +1 -1
  237. package/layout/progress.js +1 -1
  238. package/layout/row.js +1 -1
  239. package/layout/scroll-video.js +1 -1
  240. package/layout/shop.js +1 -1
  241. package/layout/side-bar.js +1 -1
  242. package/layout/side-nav-bar.js +1 -1
  243. package/layout/simple-bar.js +1 -1
  244. package/layout/slider-2025.js +1 -1
  245. package/layout/spacer.js +1 -1
  246. package/layout/stack.js +2 -2
  247. package/layout/svg.js +1 -1
  248. package/layout/switcher.js +1 -1
  249. package/layout/table.js +2 -2
  250. package/layout/text-field.js +1 -1
  251. package/layout/text.js +2 -2
  252. package/layout/ulist.js +19 -2
  253. package/layout/video.js +1 -1
  254. package/layout/wrap.js +1 -1
  255. package/layout/zoom-card.js +1 -1
  256. package/lib/agent-surface.js +2 -2
  257. package/lib/card-getter.js +1 -1
  258. package/lib/check-page.js +1 -1
  259. package/lib/codegen.js +1 -1
  260. package/lib/data.js +1 -1
  261. package/lib/designer.js +2 -2
  262. package/lib/element-mapper.js +8 -6
  263. package/lib/element-params.generated.js +1 -1
  264. package/lib/grid-geometry.js +1 -1
  265. package/lib/keyframe-animation.js +1 -1
  266. package/lib/known-inert.js +1 -1
  267. package/lib/lines.js +262 -0
  268. package/lib/link-getter.js +3 -3
  269. package/lib/morph-node.js +1 -1
  270. package/lib/normalize-spec.js +1 -1
  271. package/lib/op-semantics.js +91 -2
  272. package/lib/parse-html.js +60 -6
  273. package/lib/raster-inspect.js +1 -1
  274. package/lib/raster-ops.js +1 -1
  275. package/lib/raster-presets.js +1 -1
  276. package/lib/react.js +1 -1
  277. package/lib/resolve-refs.js +1 -1
  278. package/lib/responsive.js +1 -1
  279. package/lib/scroll-video.js +1 -1
  280. package/lib/seo.js +1 -1
  281. package/lib/stacker.js +1 -1
  282. package/lib/suggest.js +1 -1
  283. package/lib/theme.js +1 -1
  284. package/lib/transform-anim.js +1 -1
  285. package/lib/transition.js +1 -1
  286. package/lib/validate-nodes.js +21 -1
  287. package/lib/view-transition.js +1 -1
  288. package/lib/webmcp-adapter.js +21 -6
  289. package/package.json +2 -1
  290. package/skills/nodality/SKILL.md +4 -0
  291. package/skills/nodality/references/editing.md +8 -6
  292. package/skills/nodality-edit-page/SKILL.md +3 -1
@@ -1,5 +1,5 @@
1
1
  /*!
2
- * nodality v1.5.3
2
+ * nodality v1.5.5
3
3
  * (c) 2026 Filip Vabrousek
4
4
  * License: MIT
5
5
  */
@@ -1,5 +1,5 @@
1
1
  /*!
2
- * nodality v1.5.3
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, ...readSubtree(h.states.get(h.current) || mount) };
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, ...readSubtree(h.states.get(h.current) || mount) };
276
+ return { ok: true, view: h.current, ...contentOf(h) };
264
277
  }),
265
278
 
266
- read: async () => ({ ok: true, view: currentView(), ...readSubtree(currentSubtree()) }),
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",
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",
@@ -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
@@ -10,16 +10,18 @@ regenerating. Read the page back to data, change the one thing, render
10
10
  again:
11
11
 
12
12
  ```js
13
- import { parseHTML } from "nodality/parse";
13
+ import { parseSpec } from "nodality/parse";
14
14
 
15
- const spec = parseHTML(html); // or the parse_html MCP tool
16
- spec[0].items[1].title = "Gamma"; // change one card
17
- new Des().nodes([]).add(spec).set({ mount: "#mount", annotate: true });
15
+ const { elements, nodes } = parseSpec(html); // or the parse_html MCP tool
16
+ elements[0].items[1].title = "Gamma"; // change one card
17
+ new Des().nodes(nodes).add(elements).set({ mount: "#mount", annotate: true });
18
18
  ```
19
19
 
20
20
  **Render with `{annotate: true}` if the page will ever be edited.** It
21
21
  writes each descriptor onto the node it produced, and that is what makes
22
- the read exact – every type, every option, nothing inferred. It is
22
+ the read exact – every type, every option, nothing inferred. It also
23
+ appends the page's nodes as one `<script type="application/json"
24
+ data-nod-nodes>` after the elements, so they come back too (`nodesExact`). It is
23
25
  opt-in and off by default because it puts attributes in the output.
24
26
 
25
27
  Without annotation only what the tag settles comes back: headings,
@@ -30,7 +32,7 @@ become a different page. Use `parseReport` (or the `parse_html` tool)
30
32
  rather than `parseHTML` when you need to know which you got:
31
33
 
32
34
  ```js
33
- const { ok, exact, spec, unrecovered, errors } = parseReport(html);
35
+ const { ok, exact, spec, nodes, nodesExact, unrecovered, errors } = parseReport(html);
34
36
  ```
35
37
 
36
38
  `ok` is false if anything was unrecovered *or* the recovered spec fails
@@ -18,7 +18,9 @@ Editing does not mean regenerating. The full background is in the
18
18
  not empty, the page was not rendered with `{annotate: true}` and some
19
19
  composites came back as bare `<div>`s. Say so and ask for the source
20
20
  rather than guessing those parts: a wrong guess silently becomes a
21
- different page.
21
+ different page. If `nodesExact` is false the page carried no nodes:
22
+ you can change elements, but ask for the source before changing or
23
+ relying on any node.
22
24
  3. **Find the target by `id`.** The id is the address. Change that element
23
25
  or the nodes whose `target` names it, and nothing else. Keep ids as they
24
26
  are: other nodes, generated code and the agent surface point at them.