nodality 1.3.15 → 1.3.17

package/lib/known-inert.js

@@ -0,0 +1,85 @@
+/*!
+ * nodality v1.3.17
+ * (c) 2026 Filip Vabrousek
+ * License: MIT
+ */
+
+// known-inert.js — parameters the schema advertises for a type and the type
+// ignores.
+//
+// One list, read by two things: the conformance test (which fails if a new
+// inert parameter appears, or if one listed here starts working) and
+// validate_nodes (which warns a page author who uses one, as PARAM_INERT).
+// It used to live only in the test, so the suite knew a parameter did nothing
+// while the validator told the author the page was fine.
+//
+// A baseline, not an allowlist: each entry is a known defect.
+
+export const KNOWN_INERT = new Set([
+	// The mapper builds its own options and never consults the element, so
+	// the component's vocabulary is unreachable however faithfully it reads.
+	// Fixing one means changing how every existing page of that type renders,
+	// so each is recorded here rather than quietly patched.
+	// Text elements: the element TYPE picks the fluid step, because in Text
+	// the step also picks the tag — honouring `size` here turned an h2 into an
+	// h3 and changed the document outline. `tag` is the settable option.
+	"h1.size", "h2.size", "h3.size", "h4.size", "h5.size", "h6.size", "p.size",
+	// a
+	"a.transform",
+	// checkbox
+	"checkbox.area",
+	"checkbox.background",
+	"checkbox.color",
+	"checkbox.cursor",
+	"checkbox.height",
+	"checkbox.keySet",
+	"checkbox.mar",
+	"checkbox.maxWidth",
+	"checkbox.pad",
+	"checkbox.transform",
+	"checkbox.width",
+	// circle
+	"circle.transform",
+	// code
+	"code.transform",
+	// filePicker
+	"filePicker.radius",
+	// labelInput
+	"labelInput.color",
+	"labelInput.exact",
+	// nav
+	"nav.area",
+	"nav.cursor",
+	"nav.height",
+	"nav.maxHeight",
+	"nav.maxWidth",
+	"nav.opacity",
+	"nav.size",
+	"nav.transform",
+	"nav.width",
+	"nav.zIndex",
+	// polygon
+	"polygon.transform",
+	// radio
+	"radio.color",
+	"radio.exact",
+	// sideNav
+	"sideNav.area",
+	"sideNav.background",
+	"sideNav.color",
+	"sideNav.cursor",
+	"sideNav.height",
+	"sideNav.keySet",
+	"sideNav.mar",
+	"sideNav.maxHeight",
+	"sideNav.maxWidth",
+	"sideNav.opacity",
+	"sideNav.pad",
+	"sideNav.radius",
+	"sideNav.size",
+	"sideNav.transform",
+	"sideNav.width",
+	"sideNav.zIndex",
+	// table
+	"table.transform",
+]);

package/lib/link-getter.js

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

package/lib/morph-node.js

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

package/lib/normalize-spec.js

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

package/lib/parse-html.js

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

package/lib/raster-inspect.js

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

package/lib/raster-ops.js

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

package/lib/raster-presets.js

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

package/lib/resolve-refs.js

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

package/lib/scroll-video.js

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

package/lib/seo.js

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

package/lib/stacker.js

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

package/lib/suggest.js

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

package/lib/theme.js

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

package/lib/transform-anim.js

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

package/lib/transition.js

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

package/lib/validate-nodes.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.3.15
+ * nodality v1.3.17
  * (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
@@ -555,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.

package/lib/webmcp-adapter.js

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

package/package.json

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