nodality 1.2.5 → 1.2.7

package/layout/side-bar.js

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

package/layout/side-nav-bar.js

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

package/layout/simple-bar.js

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

package/layout/slider-2025.js

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

package/layout/spacer.js

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

package/layout/stack.js

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

package/layout/svg.js

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

package/layout/switcher.js

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

package/layout/table.js

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

package/layout/text-field.js

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

package/layout/text.js

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

package/layout/ulist.js

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

package/layout/video.js

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

package/layout/wrap.js

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

package/layout/zoom-card.js

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

package/lib/agent-surface.js

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

package/lib/card-getter.js

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

package/lib/codegen.js

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

package/lib/data.js

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

package/lib/designer.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.2.5
+ * nodality v1.2.7
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */
@@ -1309,7 +1309,11 @@ new Slider(texts, null, { tintColor: "#e74c3c", inactiveColor: "#ccc" })
         code.style.width = 300;
         code.style.height = 300; // both work 
         code.setAttribute("id", "elements");
-        code.value = this.code.join("");
+        // ";\n\n", not "": each entry is a complete expression, and joining
+        // them with nothing produced "})new Text(" — a syntax error, so the
+        // generated code could not be pasted anywhere once a page had more
+        // than one element.
+        code.value = this.code.join(";\n\n");
         this.target = "#elements";
 
         let pre = document.createElement("pre");

package/lib/element-mapper.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.2.5
+ * nodality v1.2.7
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */
@@ -1618,10 +1618,10 @@ const blast    = this.filtero("blast", el.id, obj.customOptions);
             .items([
                 new Image(item.img).set({isFull: true, url: item.img}),
                 // #f97316 rather than the CSS keyword orange (rgb 255,165,0), a legacy
-                  // value that reads yellow beside modern palettes. No backticks here:
-                  // this block lives inside a template literal and is evaluated as
-                  // source, so module scope is not visible either.
-                  new Text(item.title).set({ size: "S5", color: "#f97316" }),
+                // value that reads yellow beside modern palettes. No backticks here:
+                // this block lives inside a template literal and is evaluated as
+                // source, so module scope is not visible either.
+                new Text(item.title).set({ size: "S5", color: "#f97316" }),
                 new Link("Link").set({
                     text: item.title, 
                     url: item.link, 

package/lib/keyframe-animation.js

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

package/lib/link-getter.js

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

package/lib/morph-node.js

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

package/lib/raster-inspect.js

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

package/lib/raster-ops.js

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

package/lib/raster-presets.js

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

package/lib/scroll-video.js

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

package/lib/seo.js

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

package/lib/stacker.js

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

package/lib/suggest.js

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

package/lib/theme.js

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

package/lib/transform-anim.js

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

package/lib/transition.js

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

package/lib/validate-nodes.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.2.5
+ * nodality v1.2.7
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */
@@ -59,6 +59,59 @@ const EDGE_FIELDS = [
  */
 const AGENT_SURFACE_FIELDS = ["op", "name", "forms", "exclude"];
 
+/**
+ * Design ops that may be written as a BARE STRING, `{ op: "gradient" }`,
+ * and are expanded against a table of defaults by `Des.add`. This list is
+ * that table's key set (`ops` in designer.js) and must track it: a string
+ * outside it is never expanded, so it reaches the renderer as a node
+ * nothing matches and does nothing at all.
+ *
+ * None of these collide with a raster op name, which is what makes the
+ * two string families separable at all.
+ */
+const BARE_DESIGN_OPS = [
+    "blast", "gradient", "shadow", "filter", "animation", "transform", "span",
+];
+
+/**
+ * Design ops written in object form, `{ op: { name: "gradient", … } }`.
+ *
+ * Assembled from the dispatch sites rather than from the documentation,
+ * because the two disagree: the reference calls one of these "LinkStyle"
+ * while the runtime matches `"link-style"`. Deliberately generous — a
+ * name missing from this list produces a false UNKNOWN_DESIGN_OP on a
+ * node that works, and `preview` refuses to render an invalid pair, so
+ * over-reporting costs more than under-reporting.
+ */
+const DESIGN_OP_NAMES = [
+    "animation", "background", "blast", "card-style", "filter", "gradient",
+    "layout", "link-style", "margin", "navStyle", "shadow", "slayout",
+    "span", "transform",
+];
+
+/**
+ * Every top-level key a design node reads.
+ *
+ * Both forms read `op`, `target`, `range`, and — from the loop that runs
+ * over every node, not just the expanded ones — `style` and `duration`.
+ * Anything else on the object form is ignored in silence, which is
+ * precisely how the README's `colors: [...]` survived.
+ *
+ * The bare-string form reads four more, because its expansion lifts them
+ * INTO the op it substitutes: that is how
+ * `{ op: "gradient", gradient: "linear-gradient(…)" }` customises the
+ * default, and it is documented, so the two forms cannot share one list.
+ *
+ * Assembled by reading every `customOptions[i].x` and `protoOptions[i].x`
+ * in designer.js, then swept against the e2e fixtures — which is how
+ * `style` and `duration` were caught. Guessing this list produces false
+ * positives on working pages, and `preview` refuses an invalid pair.
+ */
+const DESIGN_FIELDS = ["op", "target", "range", "style", "duration"];
+const BARE_DESIGN_FIELDS = [
+    ...DESIGN_FIELDS, "filter", "gradient", "color", "width",
+];
+
 /** Node families, told apart exactly the way the runtime tells them apart. */
 const familyOf = (node) => {
     if (!node || typeof node !== "object") return "invalid";
@@ -66,6 +119,12 @@ const familyOf = (node) => {
     if (typeof op === "string") {
         if (op === "morph") return "morph";
         if (op === "agent-surface") return "agent-surface";
+        // Checked BEFORE falling through to raster. A bare-string design
+        // op is not a raster op, and reporting it as an unknown one was a
+        // false positive on documented usage: `{ op: "gradient" }` is on
+        // the gradient page, renders the default gradient, and validated
+        // as UNKNOWN_OP suggesting a raster op that would not do it.
+        if (BARE_DESIGN_OPS.includes(op)) return "design";
         return "raster";
     }
     if (op && typeof op === "object" && typeof op.name === "string") return "design";
@@ -174,7 +233,53 @@ export function validateNodes(nodes, elements) {
 
         checkTargets(node.target, `${path}.target`);
 
-        if (family === "design") return;   // design nodes carry their own vocabulary
+        if (family === "design") {
+            // Was `return` — "design nodes carry their own vocabulary", which
+            // was true and yet left the whole family unchecked. The cost was
+            // paid in the reference: a design option written in the wrong
+            // place is not a no-op with a warning, it is a no-op in silence,
+            // and the gradient one made the target INVISIBLE. Checked here at
+            // the two levels the runtime actually reads.
+            const bare = typeof node.op === "string";
+            const name = bare ? node.op : node.op.name;
+
+            if (!bare && !DESIGN_OP_NAMES.includes(name)) {
+                push("UNKNOWN_DESIGN_OP", `${path}.op.name`, name,
+                    suggest(name, DESIGN_OP_NAMES), DESIGN_OP_NAMES);
+            }
+
+            // Top-level keys. The object form reads three; the bare-string
+            // form reads four more because its expansion lifts them into the
+            // op it substitutes.
+            const allowed = bare ? BARE_DESIGN_FIELDS : DESIGN_FIELDS;
+            for (const key in node) {
+                if (allowed.includes(key)) continue;
+                // A near miss of a real top-level field is a typo and gets
+                // the usual suggestion. Anything else, on the object form,
+                // is almost always an option written one level too high —
+                // design options live INSIDE `op` — so say where it goes
+                // rather than only listing what may sit out here. That is
+                // the whole of the README's `colors` mistake.
+                const near = suggest(key, allowed);
+                const hint = near.length || bare ? near : [`op.${key}`];
+                push("UNKNOWN_PARAM", `${path}.${key}`, key, hint, allowed);
+            }
+
+            // A gradient with nothing to paint. `op.gradient` is the CSS
+            // string and `op.direction: "radial"` substitutes a built-in
+            // one; with neither, the node names an effect that cannot
+            // happen. It renders as nothing since 1.2.7 and rendered as an
+            // invisible element before that, so it is worth a report either
+            // way. The bare-string form is exempt: its whole purpose is to
+            // take the default.
+            if (!bare && name === "gradient" &&
+                node.op.gradient === undefined && node.op.direction === undefined) {
+                push("MISSING_FIELD", `${path}.op.gradient`, undefined, [],
+                    ["a CSS gradient, e.g. \"linear-gradient(#1d6fe0, #7fd1ff)\"",
+                     "or direction: \"radial\" to take the built-in one"]);
+            }
+            return;
+        }
 
         if (family === "agent-surface") {
             // The ids this node names must exist, for the usual reason:

package/lib/webmcp-adapter.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nodality",
-  "version": "1.2.5",
+  "version": "1.2.7",
   "description": "A lightweight library for declarative UI elements.",
   "main": "dist/index.cjs.js",
   "module": "dist/index.esm.js",
@@ -13,7 +13,8 @@
     "dist/",
     "bin/",
     "API.md",
-    "examples/"
+    "examples/",
+    "skills/"
   ],
   "exports": {
     ".": {