nodality 1.3.10 → 1.3.12

package/lib/element-mapper.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.3.10
+ * nodality v1.3.12
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */
@@ -176,7 +176,54 @@ function warnWrongSlot(el) {
 }
 
 class ElementMapper { // 22:09:58 04/11/2024
-   static mapType(obj) {
+    // Every element may carry an `id`. It is the joint between E and N — what
+    // `target`, `parse` and the agent surface all name — and applying it inside
+    // each of thirty-six mappers means thirty-six chances to forget. Two were
+    // already forgotten: `video` and `table` both accepted an id, advertised it
+    // in their schema, and rendered a node without one. Nothing failed; the
+    // element simply could not be named. So it is applied HERE, once, after
+    // dispatch, and a component that sets its own id keeps it.
+    static mapType(obj) {
+        const built = this.dispatchType(obj);
+        const id = obj && obj.el && obj.el.id;
+        if (id != null && id !== "") {
+            // `res` on almost every component; `formElement` on Form, which
+            // predates the convention. A mapper that returns emitted CODE
+            // rather than an instance (cards, copy) carries the id in the
+            // source it emits, and there is no node here to write to.
+            // Four conventions for "the node this component owns": `res` on
+            // most, `formElement` on Form, `el` on RadioGroup and
+            // FilePickera, `container` on Switcher. A mapper that returns
+            // emitted CODE rather than an instance (cards, copy) carries the
+            // id in the source it emits, and there is no node here to write.
+            // The generated code is what Des actually runs, so the id has to
+            // be IN it. Most components serialise `this.options` in toCode();
+            // a mapper that builds its own options object (table, circle,
+            // polygon…) leaves the id out of them, and the rendered element
+            // loses it. Put it back before the code is taken.
+            //
+            // The element's declared id also WINS over one a mapper hardcoded:
+            // `free` emitted `id: "#3"` for every free element on a page.
+            // SideNav keeps its config in `obj` rather than `options`.
+            const declared = String(id);
+            if (built && typeof built === "object") {
+                if (built.options && typeof built.options === "object") built.options.id = declared;
+                if (built.obj && typeof built.obj === "object") built.obj.id = declared;
+            }
+            const node = built && (built.res || built.formElement || built.el || built.container);
+            if (node && typeof node.setAttribute === "function") {
+                const current = node.getAttribute("id");
+                // Written exactly as declared, hash and all. Ids are compared in
+                // normalised form everywhere (see sameId), and the DOM keeps the
+                // author's spelling so that a page selecting [id="#hero"] keeps
+                // working — normalising here broke exactly such pages.
+                if (!current) node.setAttribute("id", String(id));
+            }
+        }
+        return built;
+    }
+
+   static dispatchType(obj) {
         warnWrongSlot(obj && obj.el);
   // console.log("LOBJ");
    // console.log(obj);
@@ -305,7 +352,7 @@ class ElementMapper { // 22:09:58 04/11/2024
               span: this.filtero("span", el.id, obj.customOptions),
               backgroundOp: this.filtero("background", el.id, obj.customOptions),
               marginOp: this.filtero("margin", el.id, obj.customOptions),
-              transform: this.filtero("transform", el.id, obj.customOptions),
+              transform: this.filtero("transform", el.id, obj.customOptions) ?? el.transform,
               filtera: this.filtero("filter", el.id, obj.customOptions),
                 raster: this.filteroRaster(el.id, obj.customOptions),
           });
@@ -343,7 +390,10 @@ class ElementMapper { // 22:09:58 04/11/2024
                          span: this.filtero("span", el.id, obj.customOptions),
                          backgroundOp: this.filtero("background", el.id, obj.customOptions),
                          marginOp: this.filtero("margin", el.id, obj.customOptions),
-                         transform: this.filtero("transform", el.id, obj.customOptions),
+                         // A transform design node wins; without one the element's
+                // own CSS string is used. Previously the lookup overwrote it
+                // with undefined, so `transform` on an element was dropped.
+                transform: this.filtero("transform", el.id, obj.customOptions) ?? el.transform,
                          filtera: this.filtero("filter", el.id, obj.customOptions),
                 raster: this.filteroRaster(el.id, obj.customOptions),
         }).items([
@@ -388,7 +438,10 @@ new Text("row.").set({
                          span: this.filtero("span", el.id, obj.customOptions),
                          backgroundOp: this.filtero("background", el.id, obj.customOptions),
                          marginOp: this.filtero("margin", el.id, obj.customOptions),
-                         transform: this.filtero("transform", el.id, obj.customOptions),
+                         // A transform design node wins; without one the element's
+                // own CSS string is used. Previously the lookup overwrote it
+                // with undefined, so `transform` on an element was dropped.
+                transform: this.filtero("transform", el.id, obj.customOptions) ?? el.transform,
                          filtera: this.filtero("filter", el.id, obj.customOptions),
                 raster: this.filteroRaster(el.id, obj.customOptions),
                         pad: [
@@ -465,6 +518,8 @@ animation: {
     },
   `;
 
+  // The id below was hardcoded to "#first", so every copy element on a page
+  // emitted the same id and none could be targeted individually.
   return `new Wrapper()
 .set({
   width: "${minSize}px",
@@ -473,7 +528,7 @@ animation: {
   justifyContent: "center",
   alignItems: "center",
   position: "absolute",
-  id: "#first",
+  id: "${obj.el.id ? String(obj.el.id) : "#first"}",
   scale: 0.3,
   ${ft?.animation ? animation : ""}${
     // Wrapper routes its options through commonMethods(), so a raster
@@ -1039,6 +1094,10 @@ if (obj.el.dropdown){
 
        const navBar = new Switcher()
            .set({
+               // A Switcher applies its id when it renders, because its box
+               // does not exist before then. Omitting it here is why a `nav`
+               // element accepted an id and rendered a bar without one.
+               id: obj.el && obj.el.id,
                breakpoints: [ // 172800 almost
                    {
                        at: "0px", view: new MobileBar().set({
@@ -1647,7 +1706,10 @@ return new Circle()
                 span: this.filtero("span", el.id, obj.customOptions),
                 backgroundOp: this.filtero("background", el.id, obj.customOptions),
                 marginOp: this.filtero("margin", el.id, obj.customOptions),
-                transform: this.filtero("transform", el.id, obj.customOptions),
+                // A transform design node wins; without one the element's
+                // own CSS string is used. Previously the lookup overwrote it
+                // with undefined, so `transform` on an element was dropped.
+                transform: this.filtero("transform", el.id, obj.customOptions) ?? el.transform,
                 filtera: this.filtero("filter", el.id, obj.customOptions),
                 raster: this.filteroRaster(el.id, obj.customOptions),
    })
@@ -1662,7 +1724,9 @@ return new Circle()
    
   const count = obj.el.sides ?? 7;
 
-let elo = new Polygon({ id: "hex" })
+// Was `{ id: "hex" }` hardcoded, so every polygon on a page rendered the
+  // same id and none could be targeted individually.
+  let elo = new Polygon({ id: el.id ? String(el.id) : "hex" })
   .set({
     sides: count,
     size: 300,
@@ -1674,7 +1738,10 @@ let elo = new Polygon({ id: "hex" })
                 span: this.filtero("span", el.id, obj.customOptions),
                 backgroundOp: this.filtero("background", el.id, obj.customOptions),
                 marginOp: this.filtero("margin", el.id, obj.customOptions),
-                transform: this.filtero("transform", el.id, obj.customOptions),
+                // A transform design node wins; without one the element's
+                // own CSS string is used. Previously the lookup overwrote it
+                // with undefined, so `transform` on an element was dropped.
+                transform: this.filtero("transform", el.id, obj.customOptions) ?? el.transform,
                 filtera: this.filtero("filter", el.id, obj.customOptions),
                 raster: this.filteroRaster(el.id, obj.customOptions),
   })
@@ -1718,6 +1785,13 @@ let elo = new Polygon({ id: "hex" })
                 id: el.id,
                 class: el.class,
                 color: el.color,
+                // Deliberately NOT `el.size ?? …`. In Text the step picks the
+                // TAG as well as the font size, so honouring an explicit
+                // `size` turned `{type:"h2", size:"S3"}` into an <h3> and
+                // quietly changed the document outline. The element type owns
+                // the step here; `tag` is the option for choosing the heading
+                // level independently. `size` is therefore not settable on a
+                // text element, which the schema now says.
                 size: this.getElType(el.type), // update 23/07/2025
                 //@ tag: Heading level to render, independent of the type's size.
                 // Without this the option exists on the component and is not
@@ -1735,7 +1809,10 @@ let elo = new Polygon({ id: "hex" })
                 span: this.filtero("span", el.id, obj.customOptions),
                 backgroundOp: this.filtero("background", el.id, obj.customOptions),
                 marginOp: this.filtero("margin", el.id, obj.customOptions),
-                transform: this.filtero("transform", el.id, obj.customOptions),
+                // A transform design node wins; without one the element's
+                // own CSS string is used. Previously the lookup overwrote it
+                // with undefined, so `transform` on an element was dropped.
+                transform: this.filtero("transform", el.id, obj.customOptions) ?? el.transform,
                 filtera: this.filtero("filter", el.id, obj.customOptions),
                 raster: this.filteroRaster(el.id, obj.customOptions),
                 // The caller's own breakpoints. This used to REPLACE them
@@ -1806,12 +1883,16 @@ let elo = new Polygon({ id: "hex" })
 
                    
 
-                    re["font"] = "Arial";
+                    // Arial is the default, not an override: this used to discard
+                    // the element's own font, so a link could never match the
+                    // page's typography — a nav in the page's mono rendered in
+                    // Arial with nothing reported.
+                    re["font"] = obj.el.font ?? "Arial";
                     re["fluidc"] = obj.el.fluidc;
                   //  re["index"] = obj.i + "", // add other options here
 
                     //  transform: this.filtero("transform", el.id, obj.customOptions),
-                     re["transform"] = this.filtero("transform", obj.el.id, obj.customOptions),
+                     re["transform"] = this.filtero("transform", obj.el.id, obj.customOptions) ?? obj.el.transform,
                     re["shadow"] = this.filtero("shadow", obj.el.id, obj.customOptions),//customOptions.filter(l => l.op.name === "shadow")[0],
                     re["gradient"] = this.filtero("gradient", obj.el.id, obj.customOptions),
                       re["blast"] = this.filtero("blast", obj.el.id, obj.customOptions),
@@ -1823,7 +1904,8 @@ let elo = new Polygon({ id: "hex" })
                     // mapWrap. Link takes `raster` through commonMethods like
                     // every other component; only the wiring was missing.
                     re["raster"] = this.filteroRaster(obj.el.id, obj.customOptions);
-                    re["pad"] = [{ "a": 10 }];
+                    // Same pattern: the element's padding wins over the default.
+                    re["pad"] = obj.el.pad ?? [{ "a": 10 }];
 
                 if (bst.length > 0) {
                         ela = LinkStyler.style({
@@ -2244,7 +2326,10 @@ static form(obj){
                 gradient: this.filtero("gradient", el.id, obj.customOptions),
                 animation: this.filtero("animation", el.id, obj.customOptions),
                 shadow: this.filtero("shadow", el.id, obj.customOptions),
-                transform: this.filtero("transform", el.id, obj.customOptions),
+                // A transform design node wins; without one the element's
+                // own CSS string is used. Previously the lookup overwrote it
+                // with undefined, so `transform` on an element was dropped.
+                transform: this.filtero("transform", el.id, obj.customOptions) ?? el.transform,
                 filtera: this.filtero("filter", el.id, obj.customOptions),
                 raster: this.filteroRaster(el.id, obj.customOptions),
             });
@@ -2290,7 +2375,10 @@ static form(obj){
                 gradient: this.filtero("gradient", el.id, obj.customOptions),
                 animation: this.filtero("animation", el.id, obj.customOptions),
                 shadow: this.filtero("shadow", el.id, obj.customOptions),
-                transform: this.filtero("transform", el.id, obj.customOptions),
+                // A transform design node wins; without one the element's
+                // own CSS string is used. Previously the lookup overwrote it
+                // with undefined, so `transform` on an element was dropped.
+                transform: this.filtero("transform", el.id, obj.customOptions) ?? el.transform,
                 filtera: this.filtero("filter", el.id, obj.customOptions),
                 raster: this.filteroRaster(el.id, obj.customOptions),
             });

package/lib/element-params.generated.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.3.10
+ * nodality v1.3.12
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */
@@ -8,4 +8,15 @@
 // 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","alignTo","aligns","alt","animate","animation","area","arrayMargin","arrayPadding","as","aspectRatio","at","auto","autoplay","backTo","background","backgroundCard","backgroundColor","backgroundOp","behaviour","blast","blastData","block","bold","border","borderObj","borderObja","borderRadius","brand","breakWord","breakpoint","breakpoints","cellAlign","cellPadding","center","centerColumn","centerSelf","centered","checkedBackgroundColor","child","children","clampc","class","clipPath","code","colat","color","column","columns","contentWidth","controls","cursor","customAlign","customJustify","customStyle","data","decoding","decorative","diameter","disp","dropdown","em","exact","fetchPriority","filter","filtera","fitContent","fixMobileTap","fixed","flex","flexCenter","flexDir","fluid","fluidc","font","fontSize","frame","ga","gap","gpos","gradient","hamColour","hamburgerColour","headStyle","height","hideField","hideOverflow","hover","icon","id","img","index","initLetter","inline","inpad","inputType","inset","isBackground","isFull","isHidden","isLink","isNavA","italic","items","justifo","justify","keySet","kind","label","layout","lazy","left","length","letterSpacing","lineOpacity","lineWidth","link","loading","loop","map","mar","margin","marginOp","markSize","marks","maxHeight","maxWidth","mboth","method","minHeight","mobile","multiple","muted","name","new","nowrap","objectFit","objectPosition","offcanvas","okayColor","onScroll","onTap","opacity","overflow","owrap","pad","padding","placeholder","playsinline","position","positions","poster","preffersId","preload","radius","ranges","raster","react","readouts","removeDecoration","required","resmar","respad","responsive","resprop","rounded","rows","scale","sequence","shadow","sides","simpleBorder","simpleCenter","size","sizes","sources","span","srcset","sticky","stretch","stroke","style","stype","svg","tag","tags","templateCols","text","theme","tint","title","toColumn","top","transform","transition","type","uppercase","url","useBrightness","value","vtn","weight","width","wrap","x","y","zIndex"];
+export const ELEMENT_PARAM_NAMES = ["absolute","accept","action","align","alignItems","alignIts","alignTo","aligns","alt","animate","animation","area","ariaLabel","arrayMargin","arrayPadding","as","aspectRatio","at","auto","autoplay","backTo","background","backgroundCard","backgroundColor","backgroundOp","barPad","behaviour","blast","blastData","block","bold","border","borderBottom","borderObj","borderObja","brand","breakWord","breakpoint","breakpoints","center","centerColumn","centerSelf","centered","checkedBackgroundColor","child","children","clampc","class","clipPath","colat","color","column","columns","contentWidth","controls","cursor","customAlign","customJustify","customStyle","data","decoding","decorative","desktopSize","diameter","disp","dropdown","els","em","exact","fetchPriority","filter","filtera","fitContent","fixMobileTap","fixed","flex","flexCenter","flexDir","fluid","fluidc","font","fontSize","frame","ga","gap","gpos","gradient","hamColour","hamburgerColour","hamburgerInset","height","hideField","hideOverflow","hover","icon","id","img","index","initLetter","inline","inpad","inputType","inset","isBackground","isFull","isHidden","isLink","isNavA","isSide","italic","items","justifo","justify","keySet","kind","label","layout","lazy","left","length","letterSpacing","lineOpacity","lineWidth","link","loading","loop","map","mar","margin","marginOp","markSize","marks","maxHeight","maxWidth","mboth","method","minHeight","mobile","mobileSize","multiple","muted","name","new","nowrap","objectFit","objectPosition","offcanvas","okayColor","onScroll","onTap","opacity","openColor","overflow","owrap","pad","padding","placeholder","playsinline","position","positions","poster","preffersId","preload","radius","ranges","raster","react","readouts","removeDecoration","required","resmar","respad","responsive","resprop","rounded","rows","scale","sequence","shadow","sides","simpleBorder","simpleCenter","size","sizes","sources","spacing","span","srcset","sticky","stretch","stroke","stype","svg","tag","tags","templateCols","text","theme","tint","title","toColumn","top","transform","transition","type","uppercase","url","useBrightness","value","vtn","weight","width","wrap","x","y","zIndex"];
+
+// Per-type vocabulary. The union above answers "is this a real parameter
+// anywhere"; this answers "does THIS type accept it", which is what a page
+// actually needs to know — writing `keySet` on a `table` is a name the
+// union knows and the type ignores.
+export const ELEMENT_PARAMS_BY_TYPE = {"h1":["absolute","align","alt","animation","area","background","backgroundOp","block","border","borderObj","breakWord","center","clampc","class","color","cursor","em","filtera","flex","fluid","fluidc","font","gpos","gradient","height","icon","id","index","initLetter","italic","keySet","layout","left","mar","marginOp","maxWidth","onScroll","onTap","preffersId","raster","removeDecoration","responsive","resprop","shadow","size","span","stroke","tag","text","top","transform","type","url","value","vtn","width"],"h2":["absolute","align","alt","animation","area","background","backgroundOp","block","border","borderObj","breakWord","center","clampc","class","color","cursor","em","filtera","flex","fluid","fluidc","font","gpos","gradient","height","icon","id","index","initLetter","italic","keySet","layout","left","mar","marginOp","maxWidth","onScroll","onTap","preffersId","raster","removeDecoration","responsive","resprop","shadow","size","span","stroke","tag","text","top","transform","type","url","value","vtn","width"],"h3":["absolute","align","alt","animation","area","background","backgroundOp","block","border","borderObj","breakWord","center","clampc","class","color","cursor","em","filtera","flex","fluid","fluidc","font","gpos","gradient","height","icon","id","index","initLetter","italic","keySet","layout","left","mar","marginOp","maxWidth","onScroll","onTap","preffersId","raster","removeDecoration","responsive","resprop","shadow","size","span","stroke","tag","text","top","transform","type","url","value","vtn","width"],"h4":["absolute","align","alt","animation","area","background","backgroundOp","block","border","borderObj","breakWord","center","clampc","class","color","cursor","em","filtera","flex","fluid","fluidc","font","gpos","gradient","height","icon","id","index","initLetter","italic","keySet","layout","left","mar","marginOp","maxWidth","onScroll","onTap","preffersId","raster","removeDecoration","responsive","resprop","shadow","size","span","stroke","tag","text","top","transform","type","url","value","vtn","width"],"h5":["absolute","align","alt","animation","area","background","backgroundOp","block","border","borderObj","breakWord","center","clampc","class","color","cursor","em","filtera","flex","fluid","fluidc","font","gpos","gradient","height","icon","id","index","initLetter","italic","keySet","layout","left","mar","marginOp","maxWidth","onScroll","onTap","preffersId","raster","removeDecoration","responsive","resprop","shadow","size","span","stroke","tag","text","top","transform","type","url","value","vtn","width"],"h6":["absolute","align","alt","animation","area","background","backgroundOp","block","border","borderObj","breakWord","center","clampc","class","color","cursor","em","filtera","flex","fluid","fluidc","font","gpos","gradient","height","icon","id","index","initLetter","italic","keySet","layout","left","mar","marginOp","maxWidth","onScroll","onTap","preffersId","raster","removeDecoration","responsive","resprop","shadow","size","span","stroke","tag","text","top","transform","type","url","value","vtn","width"],"p":["absolute","align","alt","animation","area","background","backgroundOp","block","border","borderObj","breakWord","center","clampc","class","color","cursor","em","filtera","flex","fluid","fluidc","font","gpos","gradient","height","icon","id","index","initLetter","italic","keySet","layout","left","mar","marginOp","maxWidth","onScroll","onTap","preffersId","raster","removeDecoration","responsive","resprop","shadow","size","span","stroke","tag","text","top","transform","type","url","value","vtn","width"],"img":["alt","animation","area","as","at","backgroundOp","centerSelf","class","clipPath","color","decoding","fetchPriority","filtera","fitContent","gpos","gradient","height","id","index","isBackground","isFull","keySet","layout","loading","marginOp","maxWidth","minHeight","objectFit","objectPosition","onScroll","onTap","opacity","radius","resprop","shadow","sizes","span","srcset","stroke","stype","type","url","vtn","width","x","y","zIndex"],"a":["align","animation","background","backgroundOp","blast","blastData","block","bold","border","borderObj","clampc","class","color","data","fixMobileTap","flex","fluidc","font","gradient","hover","icon","id","isNavA","link","mar","marginOp","maxWidth","new","nowrap","onTap","pad","padding","preffersId","radius","rounded","shadow","span","stroke","tags","text","transform","type","url","width"],"cards":["absolute","action","align","alignIts","alt","animation","area","as","at","backTo","background","backgroundCard","backgroundColor","backgroundOp","blast","blastData","block","bold","border","borderObj","borderObja","breakWord","center","centerColumn","centerSelf","checkedBackgroundColor","child","children","clampc","class","clipPath","colat","color","column","cursor","customAlign","customJustify","customStyle","data","decoding","disp","em","fetchPriority","filter","filtera","fitContent","fixMobileTap","flex","flexCenter","flexDir","fluid","fluidc","font","ga","gap","gpos","gradient","height","hideOverflow","hover","icon","id","index","initLetter","inpad","isBackground","isFull","isHidden","isLink","isNavA","italic","items","keySet","kind","label","layout","left","loading","map","mar","marginOp","maxHeight","maxWidth","mboth","method","minHeight","name","new","nowrap","objectFit","objectPosition","onScroll","onTap","opacity","overflow","pad","padding","position","preffersId","radius","ranges","raster","react","removeDecoration","resmar","respad","responsive","resprop","rounded","scale","sequence","shadow","simpleBorder","simpleCenter","size","sizes","span","srcset","sticky","stretch","stroke","stype","tag","tags","text","title","top","transform","transition","type","url","useBrightness","vtn","weight","width","wrap","x","y","zIndex"],"free":["els","id","type"],"nav":["absolute","action","align","alignItems","alignIts","alt","animate","animation","area","ariaLabel","as","at","backTo","background","backgroundCard","backgroundColor","backgroundOp","barPad","behaviour","blast","blastData","block","bold","border","borderBottom","borderObj","borderObja","brand","breakWord","breakpoints","center","centerColumn","centerSelf","checkedBackgroundColor","child","children","clampc","class","clipPath","colat","color","column","contentWidth","cursor","customAlign","customJustify","customStyle","data","decoding","desktopSize","diameter","disp","dropdown","els","em","fetchPriority","filter","filtera","fitContent","fixMobileTap","fixed","flex","flexCenter","flexDir","fluid","fluidc","font","ga","gap","gpos","gradient","hamColour","hamburgerColour","hamburgerInset","height","hideOverflow","hover","icon","id","index","initLetter","inline","inpad","isBackground","isFull","isHidden","isLink","isNavA","isSide","italic","items","justify","keySet","kind","label","layout","left","link","loading","map","mar","margin","marginOp","maxHeight","maxWidth","mboth","method","minHeight","mobileSize","name","new","nowrap","objectFit","objectPosition","offcanvas","onScroll","onTap","opacity","openColor","overflow","pad","padding","position","positions","preffersId","radius","ranges","raster","react","removeDecoration","resmar","respad","responsive","resprop","rounded","scale","sequence","shadow","sides","simpleBorder","simpleCenter","size","sizes","spacing","span","srcset","sticky","stretch","stroke","stype","tag","tags","templateCols","text","title","top","transform","transition","type","url","useBrightness","value","vtn","weight","width","wrap","x","y","zIndex"],"sideNav":["absolute","action","align","alignIts","alt","animate","animation","area","as","at","backTo","background","backgroundCard","backgroundColor","backgroundOp","behaviour","blast","blastData","block","bold","border","borderObj","borderObja","breakWord","center","centerColumn","centerSelf","checkedBackgroundColor","child","children","clampc","class","clipPath","colat","color","column","contentWidth","cursor","customAlign","customJustify","customStyle","data","decoding","diameter","disp","dropdown","els","em","fetchPriority","filter","filtera","fitContent","fixMobileTap","fixed","flex","flexCenter","flexDir","fluid","fluidc","font","ga","gap","gpos","gradient","hamColour","height","hideOverflow","hover","icon","id","index","initLetter","inline","inpad","isBackground","isFull","isHidden","isLink","isNavA","italic","items","keySet","kind","label","layout","left","link","loading","map","mar","margin","marginOp","maxHeight","maxWidth","mboth","method","minHeight","name","new","nowrap","objectFit","objectPosition","offcanvas","onScroll","onTap","opacity","overflow","pad","padding","position","positions","preffersId","radius","ranges","raster","react","removeDecoration","resmar","respad","responsive","resprop","rounded","scale","sequence","shadow","sides","simpleBorder","simpleCenter","size","sizes","span","srcset","sticky","stretch","stroke","stype","tag","tags","templateCols","text","title","top","transform","transition","type","url","useBrightness","value","vtn","weight","width","wrap","x","y","zIndex"],"row":["absolute","align","alignIts","alignTo","aligns","alt","animation","area","background","backgroundOp","block","border","borderObj","breakWord","center","children","clampc","class","colat","color","column","cursor","em","filtera","flex","fluid","fluidc","font","gap","gpos","gradient","height","icon","id","index","initLetter","italic","justifo","justify","keySet","layout","left","mar","marginOp","maxWidth","mobile","onScroll","onTap","owrap","padding","position","preffersId","radius","raster","removeDecoration","responsive","shadow","size","span","stroke","tag","toColumn","top","transform","type","url","vtn","width","wrap"],"dropdown":["id","items","label","title","type"],"radio":["color","exact","font","id","items","length","multiple","tint","type"],"input":["background","bold","color","exact","font","id","inputType","label","mar","maxWidth","name","pad","placeholder","radius","required","theme","title","type","weight"],"labelInput":["color","exact","font","id","inputType","label","mar","name","pad","text","title","type"],"filePicker":["accept","background","color","font","hideField","id","index","name","okayColor","radius","title","type"],"picker":["arrayMargin","arrayPadding","background","id","items","label","mar","name","pad","radius","title","type"],"video":["aspectRatio","autoplay","background","controls","decorative","height","id","label","lazy","loop","maxWidth","muted","objectFit","opacity","playsinline","poster","preload","radius","raster","sources","type","url","width"],"audio":["id","type","url"],"multiswitcher":["area","breakpoints","id","type"],"button":["align","auto","background","bold","border","centered","class","color","exact","fluidc","frame","height","id","img","keySet","margin","onTap","padding","radius","resmar","respad","svg","text","type","url","weight","width"],"form":["action","children","id","method","type"],"checkbox":["absolute","align","alt","animation","area","background","backgroundColor","backgroundOp","block","border","borderObj","breakWord","center","checkedBackgroundColor","clampc","class","clipPath","color","cursor","customStyle","em","filtera","flex","fluid","fluidc","font","gpos","gradient","height","icon","id","index","initLetter","italic","keySet","label","layout","left","mar","marginOp","maxWidth","name","onScroll","onTap","pad","preffersId","raster","removeDecoration","resmar","respad","responsive","shadow","size","span","stroke","tag","title","top","transform","type","url","vtn","width"],"stack":["children","height","id","sticky","type"],"simple":["children","gap","height","id","react","type"],"copy":["id","type"],"wrap":["absolute","align","alignIts","alt","animation","area","at","backTo","background","backgroundOp","blast","block","border","borderObj","borderObja","breakWord","center","centerColumn","child","children","clampc","class","color","column","cursor","customAlign","customJustify","disp","em","filter","filtera","flex","flexCenter","flexDir","fluid","fluidc","font","ga","gpos","gradient","height","hideOverflow","icon","id","index","initLetter","isHidden","isLink","italic","keySet","kind","layout","left","mar","marginOp","maxHeight","maxWidth","mboth","name","onScroll","onTap","opacity","overflow","pad","position","preffersId","radius","ranges","raster","removeDecoration","responsive","resprop","scale","sequence","shadow","simpleBorder","simpleCenter","size","span","sticky","stretch","stroke","tag","top","transform","transition","type","url","vtn","weight","width","zIndex"],"circle":["id","transform","type"],"polygon":["id","sides","transform","type"],"code":["id","transform","type"],"table":["id","items","transform","type"],"ulist":["absolute","align","alt","animation","area","background","backgroundOp","block","border","borderObj","breakWord","center","clampc","class","color","cursor","em","filtera","flex","fluid","fluidc","font","gpos","gradient","height","icon","id","index","initLetter","italic","items","keySet","kind","layout","left","mar","marginOp","maxWidth","onScroll","onTap","pad","preffersId","raster","removeDecoration","responsive","shadow","size","span","stroke","tag","top","transform","type","url","vtn","width"],"gridOverlay":["breakpoint","color","columns","font","fontSize","id","inset","letterSpacing","lineOpacity","lineWidth","markSize","marks","mobile","position","readouts","rows","type","uppercase","zIndex"]};
+
+// Declared value shapes, keyed "type.param". Only parameters whose source
+// carries a `//@ name {unit}:` annotation appear, so this grows as the
+// library documents itself and never claims a shape it was not told.
+export const ELEMENT_PARAM_UNITS = {"h1.area":"text","h1.background":"color","h1.borderObj":"object","h1.color":"color","h1.cursor":"css-cursor","h1.height":"css-length","h1.keySet":"keyset","h1.mar":"sides","h1.maxWidth":"css-length","h1.raster":"nodes","h1.resprop":"breakpoints","h1.size":"scale-step","h1.transform":"css-transform","h1.width":"css-length","h2.area":"text","h2.background":"color","h2.borderObj":"object","h2.color":"color","h2.cursor":"css-cursor","h2.height":"css-length","h2.keySet":"keyset","h2.mar":"sides","h2.maxWidth":"css-length","h2.raster":"nodes","h2.resprop":"breakpoints","h2.size":"scale-step","h2.transform":"css-transform","h2.width":"css-length","h3.area":"text","h3.background":"color","h3.borderObj":"object","h3.color":"color","h3.cursor":"css-cursor","h3.height":"css-length","h3.keySet":"keyset","h3.mar":"sides","h3.maxWidth":"css-length","h3.raster":"nodes","h3.resprop":"breakpoints","h3.size":"scale-step","h3.transform":"css-transform","h3.width":"css-length","h4.area":"text","h4.background":"color","h4.borderObj":"object","h4.color":"color","h4.cursor":"css-cursor","h4.height":"css-length","h4.keySet":"keyset","h4.mar":"sides","h4.maxWidth":"css-length","h4.raster":"nodes","h4.resprop":"breakpoints","h4.size":"scale-step","h4.transform":"css-transform","h4.width":"css-length","h5.area":"text","h5.background":"color","h5.borderObj":"object","h5.color":"color","h5.cursor":"css-cursor","h5.height":"css-length","h5.keySet":"keyset","h5.mar":"sides","h5.maxWidth":"css-length","h5.raster":"nodes","h5.resprop":"breakpoints","h5.size":"scale-step","h5.transform":"css-transform","h5.width":"css-length","h6.area":"text","h6.background":"color","h6.borderObj":"object","h6.color":"color","h6.cursor":"css-cursor","h6.height":"css-length","h6.keySet":"keyset","h6.mar":"sides","h6.maxWidth":"css-length","h6.raster":"nodes","h6.resprop":"breakpoints","h6.size":"scale-step","h6.transform":"css-transform","h6.width":"css-length","p.area":"text","p.background":"color","p.borderObj":"object","p.color":"color","p.cursor":"css-cursor","p.height":"css-length","p.keySet":"keyset","p.mar":"sides","p.maxWidth":"css-length","p.raster":"nodes","p.resprop":"breakpoints","p.size":"scale-step","p.transform":"css-transform","p.width":"css-length","img.area":"text","img.color":"color","img.height":"css-length","img.keySet":"keyset","img.maxWidth":"css-length","img.opacity":"ratio","img.radius":"px-or-length","img.resprop":"breakpoints","img.width":"css-length","img.zIndex":"count","a.background":"color","a.borderObj":"object","a.color":"color","a.hover":"object","a.mar":"sides","a.maxWidth":"css-length","a.pad":"sides","a.radius":"px-or-length","a.transform":"css-transform","a.width":"css-length","cards.area":"text","cards.background":"color","cards.borderObj":"object","cards.color":"color","cards.cursor":"css-cursor","cards.height":"css-length","cards.hover":"object","cards.keySet":"keyset","cards.mar":"sides","cards.maxHeight":"css-length","cards.maxWidth":"css-length","cards.opacity":"ratio","cards.pad":"sides","cards.radius":"px-or-length","cards.raster":"nodes","cards.resmar":"breakpoints","cards.respad":"breakpoints","cards.resprop":"breakpoints","cards.size":"scale-step","cards.transform":"css-transform","cards.width":"css-length","cards.zIndex":"count","nav.area":"text","nav.background":"color","nav.borderObj":"object","nav.color":"color","nav.cursor":"css-cursor","nav.height":"css-length","nav.hover":"object","nav.keySet":"keyset","nav.mar":"sides","nav.maxHeight":"css-length","nav.maxWidth":"css-length","nav.opacity":"ratio","nav.pad":"sides","nav.radius":"px-or-length","nav.raster":"nodes","nav.resmar":"breakpoints","nav.respad":"breakpoints","nav.resprop":"breakpoints","nav.size":"scale-step","nav.transform":"css-transform","nav.width":"css-length","nav.zIndex":"count","sideNav.area":"text","sideNav.background":"color","sideNav.borderObj":"object","sideNav.color":"color","sideNav.cursor":"css-cursor","sideNav.height":"css-length","sideNav.hover":"object","sideNav.keySet":"keyset","sideNav.mar":"sides","sideNav.maxHeight":"css-length","sideNav.maxWidth":"css-length","sideNav.opacity":"ratio","sideNav.pad":"sides","sideNav.radius":"px-or-length","sideNav.raster":"nodes","sideNav.resmar":"breakpoints","sideNav.respad":"breakpoints","sideNav.resprop":"breakpoints","sideNav.size":"scale-step","sideNav.transform":"css-transform","sideNav.width":"css-length","sideNav.zIndex":"count","row.area":"text","row.background":"color","row.borderObj":"object","row.color":"color","row.cursor":"css-cursor","row.height":"css-length","row.keySet":"keyset","row.mar":"sides","row.maxWidth":"css-length","row.radius":"px-or-length","row.raster":"nodes","row.size":"scale-step","row.transform":"css-transform","row.width":"css-length","radio.color":"color","radio.exact":"css-length","input.background":"color","input.color":"color","input.exact":"css-length","input.mar":"sides","input.maxWidth":"css-length","input.pad":"sides","input.radius":"px-or-length","input.theme":"object","labelInput.color":"color","labelInput.exact":"css-length","labelInput.mar":"sides","labelInput.pad":"sides","filePicker.background":"color","filePicker.color":"color","filePicker.radius":"px-or-length","picker.background":"color","picker.mar":"sides","picker.pad":"sides","picker.radius":"px-or-length","video.aspectRatio":"css-aspect-ratio","video.autoplay":"bool","video.background":"color","video.controls":"bool","video.decorative":"bool","video.height":"css-length","video.id":"text","video.label":"text","video.lazy":"bool","video.loop":"bool","video.maxWidth":"css-length","video.muted":"bool","video.objectFit":"enum(cover|contain|fill|none|scale-down)","video.opacity":"ratio","video.playsinline":"bool","video.poster":"url","video.preload":"enum(none|metadata|auto)","video.radius":"px-or-length","video.raster":"nodes","video.sources":"array","video.width":"css-length","multiswitcher.area":"text","button.background":"color","button.color":"color","button.exact":"css-length","button.height":"css-length","button.keySet":"keyset","button.radius":"px-or-length","button.resmar":"breakpoints","button.respad":"breakpoints","button.width":"css-length","checkbox.area":"text","checkbox.background":"color","checkbox.borderObj":"object","checkbox.color":"color","checkbox.cursor":"css-cursor","checkbox.height":"css-length","checkbox.keySet":"keyset","checkbox.mar":"sides","checkbox.maxWidth":"css-length","checkbox.pad":"sides","checkbox.raster":"nodes","checkbox.resmar":"breakpoints","checkbox.respad":"breakpoints","checkbox.size":"scale-step","checkbox.transform":"css-transform","checkbox.width":"css-length","stack.height":"css-length","simple.height":"css-length","wrap.area":"text","wrap.background":"color","wrap.borderObj":"object","wrap.color":"color","wrap.cursor":"css-cursor","wrap.height":"css-length","wrap.keySet":"keyset","wrap.mar":"sides","wrap.maxHeight":"css-length","wrap.maxWidth":"css-length","wrap.opacity":"ratio","wrap.pad":"sides","wrap.radius":"px-or-length","wrap.raster":"nodes","wrap.resprop":"breakpoints","wrap.size":"scale-step","wrap.transform":"css-transform","wrap.width":"css-length","wrap.zIndex":"count","circle.transform":"css-transform","polygon.transform":"css-transform","code.transform":"css-transform","table.transform":"css-transform","ulist.area":"text","ulist.background":"color","ulist.borderObj":"object","ulist.color":"color","ulist.cursor":"css-cursor","ulist.height":"css-length","ulist.keySet":"keyset","ulist.mar":"sides","ulist.maxWidth":"css-length","ulist.pad":"sides","ulist.raster":"nodes","ulist.size":"scale-step","ulist.transform":"css-transform","ulist.width":"css-length","gridOverlay.breakpoint":"px-number","gridOverlay.color":"color","gridOverlay.columns":"count","gridOverlay.font":"text","gridOverlay.fontSize":"px-number","gridOverlay.inset":"px-number","gridOverlay.letterSpacing":"text","gridOverlay.lineOpacity":"ratio","gridOverlay.lineWidth":"px-number","gridOverlay.markSize":"px-number","gridOverlay.marks":"enum(square|cross|none)","gridOverlay.mobile":"object","gridOverlay.position":"enum(fixed|absolute)","gridOverlay.readouts":"array","gridOverlay.rows":"count","gridOverlay.uppercase":"bool","gridOverlay.zIndex":"count"};

package/lib/grid-geometry.js

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

package/lib/keyframe-animation.js

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

package/lib/link-getter.js

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

package/lib/morph-node.js

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

package/lib/normalize-spec.js

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

package/lib/parse-html.js

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

package/lib/raster-inspect.js

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

package/lib/raster-ops.js

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

package/lib/raster-presets.js

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

package/lib/resolve-refs.js

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

package/lib/scroll-video.js

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

package/lib/seo.js

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

package/lib/stacker.js

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

package/lib/suggest.js

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

package/lib/theme.js

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

package/lib/transform-anim.js

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

package/lib/transition.js

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