nodality 1.3.0 → 1.3.1

package/lib/codegen.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.3.0
+ * nodality v1.3.1
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/lib/data.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.3.0
+ * nodality v1.3.1
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/lib/designer.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.3.0
+ * nodality v1.3.1
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/lib/element-mapper.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.3.0
+ * nodality v1.3.1
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */
@@ -566,8 +566,16 @@ animation: {
                   // wrote `label`. The field it produced then had no
                   // accessible name at all — a placeholder is not one, since
                   // it disappears the moment anyone types.
-                  ...(el.label !== undefined && el.title === undefined
-                      ? { title: el.label } : {}),
+                  //
+                  // `text` joined them after Tier 7. A model wrote
+                  // `{type:"labelInput", text:"Name"}` and the field rendered
+                  // the literal string "undefined" as its label, its
+                  // placeholder and its accessible name, while validate_nodes
+                  // reported ok — the worst available outcome for a spelling
+                  // this natural. Tier 6's rule applies: take what the world
+                  // already writes. `title` still wins, then `label`.
+                  ...(el.title === undefined && (el.label !== undefined || el.text !== undefined)
+                      ? { title: el.label !== undefined ? el.label : el.text } : {}),
                   ...this.elOpts(el),
               }), el, obj.customOptions);
       }

package/lib/element-params.generated.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.3.0
+ * nodality v1.3.1
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */
@@ -8,4 +8,4 @@
 // Every parameter name any element type reads, recovered from source.
 // Used for near-miss typo detection in validate-nodes.js. A drift test
 // regenerates this and fails if it differs, so it cannot rot silently.
-export const ELEMENT_PARAM_NAMES = ["absolute","accept","action","align","alignIts","alt","animate","animation","area","arrayMargin","arrayPadding","at","auto","backTo","background","backgroundCard","backgroundColor","backgroundOp","behaviour","blast","blastData","block","bold","border","borderObj","borderObja","borderRadius","brand","breakWord","breakpoints","cellAlign","cellPadding","center","centerColumn","centered","checkedBackgroundColor","children","clampc","class","clipPath","code","color","column","contentWidth","cursor","customAlign","customJustify","customStyle","data","diameter","disp","dropdown","em","exact","filter","filtera","fixMobileTap","fixed","flex","flexCenter","flexDir","fluid","fluidc","font","frame","ga","gap","gpos","gradient","hamColour","hamburgerColour","headStyle","height","hideField","hover","icon","id","img","index","initLetter","inline","inpad","inputType","isFull","isHidden","isNavA","italic","items","keySet","kind","label","layout","left","length","link","map","mar","margin","marginOp","maxHeight","maxWidth","mboth","method","mobile","multiple","name","new","nowrap","offcanvas","okayColor","onScroll","onTap","opacity","overflow","pad","padding","placeholder","position","positions","preffersId","radius","ranges","raster","react","removeDecoration","required","resmar","respad","responsive","resprop","rounded","scale","sequence","shadow","sides","simpleBorder","simpleCenter","size","span","sticky","stretch","stroke","style","svg","tag","tags","templateCols","text","theme","tint","title","top","transform","transition","type","url","useBrightness","value","vtn","weight","width","x","y","zIndex"];
+export const ELEMENT_PARAM_NAMES = ["absolute","accept","action","align","alignIts","alignTo","aligns","alt","animate","animation","area","arrayMargin","arrayPadding","as","at","auto","backTo","background","backgroundCard","backgroundColor","backgroundOp","behaviour","blast","blastData","block","bold","border","borderObj","borderObja","borderRadius","brand","breakWord","breakpoints","cellAlign","cellPadding","center","centerColumn","centerSelf","centered","checkedBackgroundColor","child","children","clampc","class","clipPath","code","colat","color","column","contentWidth","cursor","customAlign","customJustify","customStyle","data","decoding","diameter","disp","dropdown","em","exact","fetchPriority","filter","filtera","fitContent","fixMobileTap","fixed","flex","flexCenter","flexDir","fluid","fluidc","font","frame","ga","gap","gpos","gradient","hamColour","hamburgerColour","headStyle","height","hideField","hideOverflow","hover","icon","id","img","index","initLetter","inline","inpad","inputType","isBackground","isFull","isHidden","isLink","isNavA","italic","items","justifo","justify","keySet","kind","label","layout","left","length","link","loading","map","mar","margin","marginOp","maxHeight","maxWidth","mboth","method","minHeight","mobile","multiple","name","new","nowrap","objectFit","objectPosition","offcanvas","okayColor","onScroll","onTap","opacity","overflow","owrap","pad","padding","placeholder","position","positions","preffersId","radius","ranges","raster","react","removeDecoration","required","resmar","respad","responsive","resprop","rounded","scale","sequence","shadow","sides","simpleBorder","simpleCenter","size","sizes","span","srcset","sticky","stretch","stroke","style","stype","svg","tag","tags","templateCols","text","theme","tint","title","toColumn","top","transform","transition","type","url","useBrightness","value","vtn","weight","width","wrap","x","y","zIndex"];

package/lib/keyframe-animation.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.3.0
+ * nodality v1.3.1
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/lib/link-getter.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.3.0
+ * nodality v1.3.1
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/lib/morph-node.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.3.0
+ * nodality v1.3.1
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/lib/normalize-spec.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.3.0
+ * nodality v1.3.1
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/lib/parse-html.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.3.0
+ * nodality v1.3.1
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/lib/raster-inspect.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.3.0
+ * nodality v1.3.1
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/lib/raster-ops.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.3.0
+ * nodality v1.3.1
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/lib/raster-presets.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.3.0
+ * nodality v1.3.1
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/lib/resolve-refs.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.3.0
+ * nodality v1.3.1
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/lib/scroll-video.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.3.0
+ * nodality v1.3.1
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/lib/seo.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.3.0
+ * nodality v1.3.1
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/lib/stacker.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.3.0
+ * nodality v1.3.1
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/lib/suggest.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.3.0
+ * nodality v1.3.1
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/lib/theme.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.3.0
+ * nodality v1.3.1
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/lib/transform-anim.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.3.0
+ * nodality v1.3.1
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/lib/transition.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.3.0
+ * nodality v1.3.1
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/lib/validate-nodes.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.3.0
+ * nodality v1.3.1
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */
@@ -163,6 +163,15 @@ export const CONTENT_SLOT = {
     row: "children", form: "children", wrap: "children",
 };
 
+// Of the types that read `items`, which read the entries as ELEMENT SPECS
+// rather than as data. `ulist` maps every object entry through the mapper;
+// `cards`, `nav`, `sideNav` and `table` read theirs as data — nav entries are
+// `{title, link}`, table entries are rows — and walking those as elements
+// would report every correct page. Pinned against the mapper by a test rather
+// than trusted, because a hand-kept table beside a mapper is exactly what
+// drifted before 1.2.8.
+export const SPEC_ITEMS = new Set(["ulist"]);
+
 export function validateNodes(nodes, elements, defs) {
     const errors = [];
     const push = (code, path, got, suggestions, valid) => {
@@ -382,6 +391,48 @@ export function validateNodes(nodes, elements, defs) {
                         if (Array.isArray(entry)) walkEls(entry, `${p}.items[${k}]`);
                     });
                 }
+
+                // Phase S7: an object entry with no `type`, in a slot whose
+                // entries ARE elements. `{type:"ulist", items:[{text:"Fast"}]}`
+                // validated clean and then threw from deep in the mapper —
+                // `Unknown element type "undefined"` — which is the Stage 3
+                // contract exactly inverted: validate-then-render handed the
+                // agent a stack trace in the one place the tool exists to
+                // prevent it.
+                //
+                // Tier 7 measured what that cost. The throw names every valid
+                // type and not one word about WHICH entry, so it is the same
+                // string for every fault of this shape on any page; the weaker
+                // of the two models repaired none of them and returned a
+                // byte-identical spec. The suggestion below therefore hands
+                // back the replacement rather than describing it.
+                //
+                // A string entry is the shorthand and stays valid.
+                if (SPEC_ITEMS.has(el.type) && Array.isArray(el.items)) {
+                    el.items.forEach((entry, k) => {
+                        const at = `${p}.items[${k}]`;
+                        if (typeof entry === "string" || typeof entry === "number") return;
+                        if (Array.isArray(entry)) return;
+                        if (!entry || typeof entry !== "object") {
+                            push("BAD_ELEMENT", at, entry, [],
+                                ["a string, or { type: \"<element type>\", ... }"]);
+                            return;
+                        }
+                        if (isRef(entry)) return;
+                        if (typeof entry.type !== "string") {
+                            const text = ["text", "title", "label"]
+                                .map((k2) => entry[k2]).find((v) => typeof v === "string");
+                            push("MISSING_FIELD", `${at}.type`, entry.type,
+                                text === undefined ? []
+                                    : [JSON.stringify(text),
+                                       `{ "type": "p", "text": ${JSON.stringify(text)} }`],
+                                [`"${el.type}" reads each item as an element; a plain string is the shorthand`]);
+                        } else if (!ELEMENT_TYPES.includes(entry.type)) {
+                            push("UNKNOWN_ELEMENT_TYPE", `${at}.type`, entry.type,
+                                suggest(entry.type, ELEMENT_TYPES), ELEMENT_TYPES);
+                        }
+                    });
+                }
             });
         };
         walkEls(toWalk, "elements");

package/lib/webmcp-adapter.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.3.0
+ * nodality v1.3.1
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nodality",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "description": "A lightweight library for declarative UI elements.",
   "main": "dist/index.cjs.js",
   "module": "dist/index.esm.js",