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
package/README.md CHANGED
@@ -189,6 +189,8 @@ median of 2.1–4.2× as many output tokens, depending on how the
189
189
  specification is serialised. With one repair turn using only the
190
190
  library's own reports, two models reached 24 of 24 defect-free pages.
191
191
  Method and limits are in the FLLM 2026 paper (see [Citing](#citing)).
192
+ A later re-run on release 1.3.26 with fresh generations was closer: task
193
+ success tied at 22 of 24, and 18 against 15 pages free of rendered defects.
192
194
 
193
195
  ### Agents that use pages
194
196
 
@@ -212,10 +214,11 @@ storefronts, documentation, brochure sites. It is not a replacement for a
212
214
  component framework with client-side state management, and it does not
213
215
  try to be one.
214
216
 
215
- Two honest caveats. The HTML-in-Canvas capture backend is **experimental
216
- and flag-gated**: where it is unavailable the pipeline falls back to
217
- snapshot capture on its own, so a page authored against it degrades to
218
- stills rather than breaking. And determinism is a property of the
217
+ Two honest caveats. The live capture backend uses HTML-in-Canvas, which
218
+ Chrome ships on by default since version 157 (October 2026); other
219
+ browsers do not implement it yet. Where it is unavailable the pipeline
220
+ falls back to snapshot capture on its own, so a page authored against it
221
+ degrades to stills rather than breaking. And determinism is a property of the
219
222
  compiled artefact – the same pair always produces the same output – not
220
223
  of the pixels a particular GPU eventually paints.
221
224
 
@@ -40,6 +40,7 @@
40
40
  // large enough that guessing at it fails.
41
41
  import { inspect } from "node:util";
42
42
  import { validateNodes, describeOps } from "../lib/validate-nodes.js";
43
+ import { explainElement } from "../lib/op-semantics.js";
43
44
 
44
45
  const PROTOCOL = "2025-06-18";
45
46
  // Versions whose envelope this server is known to speak. A client asking
@@ -113,6 +114,24 @@ const TOOLS = [
113
114
  "of the pair are discoverable from one call.",
114
115
  inputSchema: { type: "object", properties: {} },
115
116
  },
117
+ {
118
+ name: "explain_element",
119
+ description:
120
+ "Why an element looks the way it does, at every viewport width, " +
121
+ "without rendering: for each op that reaches the element, the node " +
122
+ "(by index in `nodes`) that decides it and the nodes that lose. " +
123
+ "`arrange` is answered per width interval; raster ops are listed per " +
124
+ "stage in the order they apply. Call this before appending a fix: if " +
125
+ "an earlier node decides the property, edit that node instead.",
126
+ inputSchema: {
127
+ type: "object",
128
+ properties: {
129
+ nodes: { type: "array", description: "The page's N." },
130
+ id: { type: "string", description: "The element id to explain." },
131
+ },
132
+ required: ["nodes", "id"],
133
+ },
134
+ },
116
135
  {
117
136
  name: "validate_nodes",
118
137
  description:
@@ -194,7 +213,9 @@ const TOOLS = [
194
213
  {
195
214
  name: "parse_html",
196
215
  description:
197
- "Read a rendered page back into an E array, so a page can be EDITED " +
216
+ "Read a rendered page back into its elements (and its nodes, when the " +
217
+ "page was rendered with `{annotate: true}` and has any: `nodes`, " +
218
+ "`nodesExact`), so a page can be EDITED " +
198
219
  "rather than only generated: parse it, change the one thing, render " +
199
220
  "again. Two tiers, and the report says which one you got. A page " +
200
221
  "rendered with `{annotate: true}` carries its own descriptors and " +
@@ -254,6 +275,7 @@ const ok = (value) => ({
254
275
 
255
276
  const IMPL = {
256
277
  list_ops: async () => ok(describeOps()),
278
+ explain_element: async ({ nodes, id }) => ok(explainElement(nodes || [], id)),
257
279
 
258
280
  // Verbatim: the report is the product, and reshaping it here would put
259
281
  // this server's opinion between the core and the agent.