nodality 1.2.2 → 1.2.4

package/layout/grid-switcher.js

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

package/layout/grid.js

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

package/layout/horizontal-scroller.js

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

package/layout/image.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.2.2
+ * nodality v1.2.4
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */
@@ -372,7 +372,7 @@ let obj = options;
 
 
 	setID(id){
-		this.res.setAttribute("id", id);
+		if (id !== undefined && id !== null) this.res.setAttribute("id", id);
 		return this;
 	}
 

package/layout/index.js

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

package/layout/link.js

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

package/layout/list.js

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

package/layout/meta-adder.js

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

package/layout/modal-2025.js

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

package/layout/morph.js

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

package/layout/multiswitcher.js

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

package/layout/nav-bar.js

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

package/layout/nav-factor/custom-div.js

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

package/layout/new-nav-bar.js

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

package/layout/polygon.js

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

package/layout/prerender-site.js

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

package/layout/prerender.js

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

package/layout/progress.js

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

package/layout/row.js

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

package/layout/scroll-video.js

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

package/layout/side-bar.js

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

package/layout/side-nav-bar.js

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

package/layout/simple-bar.js

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

package/layout/slider-2025.js

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

package/layout/spacer.js

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

package/layout/stack.js

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

package/layout/svg.js

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

package/layout/switcher.js

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

package/layout/table.js

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

package/layout/text-field.js

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

package/layout/text.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.2.2
+ * nodality v1.2.4
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */
@@ -693,7 +693,7 @@ addIcon(obj){
 		if (obj){
 			// alert(obj.type);
 			el = document.createElement(obj.type);
-			el.setAttribute("id", obj.id);
+			if (obj.id !== undefined && obj.id !== null) el.setAttribute("id", obj.id);
 
 
 			if (obj.type === "span"){

package/layout/ulist.js

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

package/layout/video.js

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

package/layout/wrap.js

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

package/layout/zoom-card.js

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

package/lib/agent-surface.js

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

package/lib/card-getter.js

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

package/lib/codegen.js

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

package/lib/data.js

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

package/lib/designer.js

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

package/lib/element-mapper.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.2.2
+ * nodality v1.2.4
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */
@@ -1961,4 +1961,9 @@ static form(obj){
 }
 
 
-export {ElementMapper};
+// ELEMENT_TYPES is exported so the validator can check the E array against
+// the same vocabulary the mapper dispatches on. Without it the two would
+// drift, and a validator that accepted a type the mapper rejects would be
+// worse than none: it would promise an agent that a page is well-formed
+// and then throw when it rendered.
+export {ElementMapper, ELEMENT_TYPES};

package/lib/keyframe-animation.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.2.2
+ * nodality v1.2.4
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */
@@ -25,7 +25,7 @@ class KeyframeAnim {
         this.targetHeight = this.data.targetHeight;
         this.html = document.body;
         this.res = document.createElement("div"); // stack
-        this.res.setAttribute("id", this.data.id);
+        if (this.data.id !== undefined && this.data.id !== null) this.res.setAttribute("id", this.data.id);
         this.res.style.border = "1px solid green";
         this.res.style.width = "100%";
         this.res.style.display = "grid";

package/lib/link-getter.js

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

package/lib/morph-node.js

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

package/lib/raster-inspect.js

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

package/lib/raster-ops.js

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

package/lib/raster-presets.js

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

package/lib/scroll-video.js

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

package/lib/seo.js

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

package/lib/stacker.js

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

package/lib/suggest.js

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

package/lib/theme.js

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

package/lib/transform-anim.js

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

package/lib/transition.js

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

package/lib/validate-nodes.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.2.2
+ * nodality v1.2.4
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */
@@ -29,6 +29,8 @@ import {
     REGISTRY, RASTER_OP_NAMES, DRIVER_NAMES, RASTER_UNITS,
     FRAMEWORK_DOC, EASING_NAMES,
 } from "./raster-ops.js";
+import { presetNames, presetInfo } from "./raster-presets.js";
+import { ELEMENT_TYPES } from "./element-mapper.js";
 import { didYouMean, suggest } from "./suggest.js";
 
 /**
@@ -131,6 +133,34 @@ export function validateNodes(nodes, elements) {
         });
     };
 
+    // ── the E array ─────────────────────────────────────────────────
+    //
+    // Checked here because half the pair was previously unvalidated: an
+    // element whose `type` names nothing is not a silent no-op but a THROW
+    // from the mapper at render time, which reaches a generator as a stack
+    // trace rather than as a report it can repair from.
+    if (idsKnown) {
+        const walkEls = (list, at) => {
+            if (!Array.isArray(list)) return;
+            list.forEach((el, i) => {
+                const p = `${at}[${i}]`;
+                if (!el || typeof el !== "object" || Array.isArray(el)) {
+                    push("BAD_ELEMENT", p, el, [], ["{ type: \"<element type>\", ... }"]);
+                    return;
+                }
+                if (typeof el.type !== "string") {
+                    push("MISSING_FIELD", `${p}.type`, el.type, [],
+                        ["an element type, e.g. \"h1\", \"wrap\", \"nav\""]);
+                } else if (!ELEMENT_TYPES.includes(el.type)) {
+                    push("UNKNOWN_ELEMENT_TYPE", `${p}.type`, el.type,
+                        suggest(el.type, ELEMENT_TYPES), ELEMENT_TYPES);
+                }
+                walkEls(el.children, `${p}.children`);
+            });
+        };
+        walkEls(elements, "elements");
+    }
+
     nodes.forEach((node, i) => {
         const path = `nodes[${i}]`;
         const family = familyOf(node);
@@ -256,6 +286,15 @@ export function validateNodes(nodes, elements) {
                     typeof o.effect !== "string" && !Array.isArray(o.effect)) {
                     push("BAD_FIELD", `${at}.effect`, o.effect, [],
                         ["a preset name, or an inline array of raster nodes"]);
+                } else if (typeof o.effect === "string" &&
+                           !presetNames().includes(o.effect)) {
+                    // A preset that does not exist resolves to an EMPTY chain
+                    // and the transition runs with no effect at all: it
+                    // validates, renders, and does nothing. That is the silent
+                    // omission this validator exists to remove, and it sat
+                    // inside the validator's own blind spot until 1.2.3.
+                    push("UNKNOWN_EFFECT", `${at}.effect`, o.effect,
+                        suggest(o.effect, presetNames()), presetNames());
                 }
                 for (const flag of ["back", "live"]) {
                     if (o[flag] !== undefined && typeof o[flag] !== "boolean") {
@@ -333,9 +372,31 @@ export function validateNodes(nodes, elements) {
         // ── raster nodes ────────────────────────────────────────────
         const def = REGISTRY[node.op];
         if (!def) {
-            push("UNKNOWN_OP", `${path}.op`, node.op,
-                suggest(node.op, RASTER_OP_NAMES), RASTER_OP_NAMES);
-            return;   // parameters cannot be judged without a definition
+            const guesses = suggest(node.op, RASTER_OP_NAMES);
+            push("UNKNOWN_OP", `${path}.op`, node.op, guesses, RASTER_OP_NAMES);
+
+            // Parameters cannot be judged without a definition — but where the
+            // op is a near miss, they can be judged against the op that was
+            // MEANT, and reported as provisional. Without this a node with a
+            // misspelled op AND a misspelled parameter takes two round-trips:
+            // the op error hides the parameter error until it is fixed. The
+            // `assuming` field says which definition the check used, so a
+            // consumer can tell a certain finding from a conditional one.
+            const meant = guesses.length ? REGISTRY[guesses[0]] : null;
+            if (meant) {
+                const known = Object.keys((meant.doc && meant.doc.params) || {});
+                const shared = Object.keys(FRAMEWORK_DOC);
+                for (const key in node) {
+                    if (key === "op" || shared.includes(key) || known.includes(key)) continue;
+                    errors.push({
+                        code: "UNKNOWN_PARAM", path: `${path}.${key}`, got: key,
+                        suggestions: suggest(key, known.concat(shared)),
+                        valid: known.concat(shared),
+                        assuming: guesses[0],
+                    });
+                }
+            }
+            return;
         }
 
         const params = (def.doc && def.doc.params) || {};
@@ -396,6 +457,16 @@ export function describeOps() {
     });
     return {
         ops,
+        // The transition presets a morph's `effect` may name. Absent from
+        // this reply until 1.2.3, which left an agent to guess them from an
+        // example in the tool description.
+        presets: presetNames().map((name) => {
+            const info = presetInfo(name) || {};
+            return { name, summary: info.summary || "", live: info.live };
+        }),
+        // The vocabulary of E, so both halves of the pair are discoverable
+        // from one call rather than only the half that is transformed.
+        elementTypes: ELEMENT_TYPES,
         shared: Object.keys(FRAMEWORK_DOC).map((k) => ({
             name: k,
             default: FRAMEWORK_DOC[k].default,

package/lib/webmcp-adapter.js

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

package/package.json

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