nodality 1.3.14 → 1.3.16

package/lib/link-getter.js

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

package/lib/morph-node.js

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

package/lib/normalize-spec.js

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

package/lib/parse-html.js

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

package/lib/raster-inspect.js

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

package/lib/raster-ops.js

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

package/lib/raster-presets.js

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

package/lib/resolve-refs.js

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

package/lib/scroll-video.js

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

package/lib/seo.js

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

package/lib/stacker.js

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

package/lib/suggest.js

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

package/lib/theme.js

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

package/lib/transform-anim.js

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

package/lib/transition.js

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

package/lib/validate-nodes.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.3.14
+ * nodality v1.3.16
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */
@@ -142,6 +142,7 @@ function shapeFor(unit) {
     return SHAPES[unit] || null;
 }
 import { didYouMean, suggest, levenshtein } from "./suggest.js";
+import { KNOWN_INERT } from "./known-inert.js";
 
 /**
  * Every key a morph node reads. Anything else on the node is ignored by
@@ -167,7 +168,7 @@ const EDGE_FIELDS = [
  * what it exposes is DERIVED, so there is nothing here to describe the
  * tools with — only which parts of the page may be reached.
  */
-const AGENT_SURFACE_FIELDS = ["op", "name", "forms", "exclude"];
+const AGENT_SURFACE_FIELDS = ["op", "name", "forms", "exclude", "products"];
 
 /**
  * Design ops that may be written as a BARE STRING, `{ op: "gradient" }`,
@@ -277,6 +278,7 @@ export const CONTENT_SLOT = {
     cards: "items", nav: "items", sideNav: "items", table: "items", ulist: "items",
     dropdown: "items", picker: "items", radio: "items",
     row: "children", form: "children", stack: "children", wrap: "children",
+    product: "children",
 };
 
 // Of the types that read `items`, which read the entries as ELEMENT SPECS
@@ -417,6 +419,36 @@ export function validateNodes(nodes, elements, defs) {
         ? resolveRefs(elements, defs)
         : elements;
 
+    // Commerce order. A `product` looks for the page's `store` the moment
+    // it is attached; Des attaches in array order, so a product rendered
+    // before the store stays empty, and the only report is a console error
+    // in the browser. Found by building a product page with the store at the
+    // end, where it looked tidy.
+    if (Array.isArray(toWalk)) {
+        let storeAt = null;
+        const products = [];
+        const visit = (list, base) => {
+            if (!Array.isArray(list)) return;
+            list.forEach((el, i) => {
+                if (!el || typeof el !== "object") return;
+                const p = `${base}[${i}]`;
+                if (el.type === "store" && storeAt === null) storeAt = p;
+                if (el.type === "product") products.push({ p, before: storeAt === null });
+                visit(el.children, `${p}.children`);
+            });
+        };
+        visit(toWalk, "elements");
+        if (products.length && storeAt === null) {
+            warn("NO_STORE", products[0].p, "product", ["{ type: \"store\", domain: \"https://your-shop.example\" }"],
+                ["a store element placed before the first product"]);
+        } else {
+            for (const { p } of products.filter((x) => x.before)) {
+                warn("STORE_AFTER_PRODUCT", p, "product", [`move ${storeAt} before this product`],
+                    ["the store element first: a product finds its store when it is attached"]);
+            }
+        }
+    }
+
     // An alias and its canonical name both present, disagreeing: one of them
     // is going to be ignored. The author hears it here rather than finding it
     // in the page.
@@ -524,6 +556,18 @@ export function validateNodes(nodes, elements, defs) {
                                 `"${el.type}" does not read "${key}" — it is accepted and ignored`);
                         }
 
+                        // Advertised by the schema for this type, and known to
+                        // do nothing (the conformance baseline). Same failure
+                        // as above — accepted, ignored — but the name IS in
+                        // the type's vocabulary, so only this list knows.
+                        if (KNOWN_INERT.has(`${el.type}.${key}`)) {
+                            warn("PARAM_INERT", `${p}.${key}`, key, [],
+                                [key === "size" && /^(h[1-6]|p)$/.test(el.type)
+                                    ? "the element type sets the scale step; use `tag` for the heading level and keySet fontSize for the size"
+                                    : `see \`npx nodality schema ${el.type}\`; wrap the element in a \`wrap\` to style or place it`],
+                                `"${el.type}" lists "${key}" but ignores it — a known gap, recorded in lib/known-inert.js`);
+                        }
+
                         // A value the parameter cannot use. Checked only where
                         // the source declares a shape, so this grows with the
                         // annotations and never guesses.
@@ -728,11 +772,13 @@ export function validateNodes(nodes, elements, defs) {
             // form of the silent no-op, and an agent has no way to see
             // that the tool it expected was never registered.
             const formIds = [];
+            const productIds = [];
             const walkForms = (list) => {
                 if (!Array.isArray(list)) return;
                 for (const el of list) {
                     if (!el || typeof el !== "object") continue;
                     if (el.type === "form" && typeof el.id === "string") formIds.push(el.id);
+                    if (el.type === "product" && typeof el.id === "string") productIds.push(el.id.replace(/^#/, ""));
                     walkForms(el.children);
                 }
             };
@@ -743,7 +789,7 @@ export function validateNodes(nodes, elements, defs) {
                     ["a string used to prefix every derived tool name"]);
             }
 
-            for (const key of ["forms", "exclude"]) {
+            for (const key of ["forms", "exclude", "products"]) {
                 if (node[key] === undefined) continue;
                 if (!Array.isArray(node[key])) {
                     push("BAD_FIELD", `${path}.${key}`, node[key], [], ["an array of ids"]);
@@ -763,6 +809,10 @@ export function validateNodes(nodes, elements, defs) {
                         if (idsKnown && !formIds.includes(bare)) {
                             push("UNKNOWN_FORM", at, v, suggest(bare, formIds), formIds);
                         }
+                    } else if (key === "products") {
+                        if (idsKnown && !productIds.includes(bare)) {
+                            push("UNKNOWN_PRODUCT", at, v, suggest(bare, productIds), productIds);
+                        }
                     } else if (idsKnown && !ids.includes(bare)) {
                         push("UNKNOWN_STATE", at, v, suggest(bare, ids), ids);
                     }
@@ -775,7 +825,8 @@ export function validateNodes(nodes, elements, defs) {
             // in the expectation of more says so.
             const hasChain = nodes.some((n) => n && n.op === "morph");
             const hasForms = Array.isArray(node.forms) && node.forms.length > 0;
-            if (!hasChain && !hasForms) {
+            const hasProducts = Array.isArray(node.products) && node.products.length > 0;
+            if (!hasChain && !hasForms && !hasProducts) {
                 push("EMPTY_SURFACE", path, node, [],
                     ["add a { op: \"morph\" } node, or name a form in `forms`"]);
             }

package/lib/webmcp-adapter.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.3.14
+ * nodality v1.3.16
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */
@@ -265,6 +265,41 @@ export function installAgentSurface({ mount, elements, nodes, morphs }) {
 
         read: async () => ({ ok: true, view: currentView(), ...readSubtree(currentSubtree()) }),
 
+        // What the product box shows now: the live rendering once Shopify has
+        // answered (its placeholder is hidden then), the static copy before.
+        product: async (args, tool) => {
+            const box = mount && mount.querySelector(`[id="${tool.productId}"]`);
+            if (!box) return refuse("NO_PRODUCT", tool.productId, []);
+            const ph = box.querySelector("[shopify-loading-placeholder]");
+            const live = ph && typeof window !== "undefined" && window.getComputedStyle(ph).display === "none";
+            // Its own reader, not readSubtree: a price and its options sit in
+            // inline elements and in Shopify's (open) shadow DOM, which a
+            // reader of headings and paragraphs never reaches. Visible text in
+            // document order; the template, scripts, styles and anything hidden
+            // — the placeholder once the live copy is up — are skipped.
+            const parts = [];
+            const actions = [];
+            const walk = (n) => {
+                for (const c of n.childNodes) {
+                    if (c.nodeType === 3) {
+                        const t = c.textContent.replace(/\s+/g, " ").trim();
+                        if (t) parts.push(t);
+                    } else if (c.nodeType === 1) {
+                        if (/^(TEMPLATE|SCRIPT|STYLE)$/.test(c.tagName)) continue;
+                        if (window.getComputedStyle(c).display === "none") continue;
+                        if (/^(A|BUTTON)$/.test(c.tagName)) {
+                            const t = c.textContent.replace(/\s+/g, " ").trim();
+                            if (t && !actions.includes(t)) actions.push(t);
+                        }
+                        if (c.shadowRoot) walk(c.shadowRoot);
+                        walk(c);
+                    }
+                }
+            };
+            walk(box);
+            return { ok: true, product: tool.productId, handle: box.getAttribute("handle"), live: !!live, text: parts.join("\n"), actions };
+        },
+
         submit: async (args = {}, tool) => {
             const form = findForm(tool.formId);
             if (!form) return refuse("NO_FORM", tool.formId, []);

package/package.json

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