nodality 1.2.11 → 1.3.0

package/schema.json

@@ -14,6 +14,10 @@
         {
           "name": "align"
         },
+        {
+          "name": "alt",
+          "description": "Description for an icon that carries meaning; omit for decoration."
+        },
         {
           "name": "animation"
         },
@@ -161,6 +165,10 @@
         {
           "name": "stroke"
         },
+        {
+          "name": "tag",
+          "description": "Heading level to render, independent of `size`/`fluid`."
+        },
         {
           "name": "text"
         },
@@ -202,6 +210,10 @@
         {
           "name": "align"
         },
+        {
+          "name": "alt",
+          "description": "Description for an icon that carries meaning; omit for decoration."
+        },
         {
           "name": "animation"
         },
@@ -349,6 +361,10 @@
         {
           "name": "stroke"
         },
+        {
+          "name": "tag",
+          "description": "Heading level to render, independent of `size`/`fluid`."
+        },
         {
           "name": "text"
         },
@@ -390,6 +406,10 @@
         {
           "name": "align"
         },
+        {
+          "name": "alt",
+          "description": "Description for an icon that carries meaning; omit for decoration."
+        },
         {
           "name": "animation"
         },
@@ -537,6 +557,10 @@
         {
           "name": "stroke"
         },
+        {
+          "name": "tag",
+          "description": "Heading level to render, independent of `size`/`fluid`."
+        },
         {
           "name": "text"
         },
@@ -578,6 +602,10 @@
         {
           "name": "align"
         },
+        {
+          "name": "alt",
+          "description": "Description for an icon that carries meaning; omit for decoration."
+        },
         {
           "name": "animation"
         },
@@ -725,6 +753,10 @@
         {
           "name": "stroke"
         },
+        {
+          "name": "tag",
+          "description": "Heading level to render, independent of `size`/`fluid`."
+        },
         {
           "name": "text"
         },
@@ -766,6 +798,10 @@
         {
           "name": "align"
         },
+        {
+          "name": "alt",
+          "description": "Description for an icon that carries meaning; omit for decoration."
+        },
         {
           "name": "animation"
         },
@@ -913,6 +949,10 @@
         {
           "name": "stroke"
         },
+        {
+          "name": "tag",
+          "description": "Heading level to render, independent of `size`/`fluid`."
+        },
         {
           "name": "text"
         },
@@ -954,6 +994,10 @@
         {
           "name": "align"
         },
+        {
+          "name": "alt",
+          "description": "Description for an icon that carries meaning; omit for decoration."
+        },
         {
           "name": "animation"
         },
@@ -1101,6 +1145,10 @@
         {
           "name": "stroke"
         },
+        {
+          "name": "tag",
+          "description": "Heading level to render, independent of `size`/`fluid`."
+        },
         {
           "name": "text"
         },
@@ -1142,6 +1190,10 @@
         {
           "name": "align"
         },
+        {
+          "name": "alt",
+          "description": "Description for an icon that carries meaning; omit for decoration."
+        },
         {
           "name": "animation"
         },
@@ -1289,6 +1341,10 @@
         {
           "name": "stroke"
         },
+        {
+          "name": "tag",
+          "description": "Heading level to render, independent of `size`/`fluid`."
+        },
         {
           "name": "text"
         },
@@ -1582,6 +1638,10 @@
           "name": "alignIts",
           "deprecated": "obsolete. Its body sets background:\"gray\" and hardcodes alignItems/justifyItems to flex-start with the argument commented out — debugging left in. Use `customAlign` / `customJustify`."
         },
+        {
+          "name": "alt",
+          "description": "Description for an icon that carries meaning; omit for decoration."
+        },
         {
           "name": "animation"
         },
@@ -1778,7 +1838,8 @@
           "name": "kind"
         },
         {
-          "name": "label"
+          "name": "label",
+          "description": "Accessible name for the field."
         },
         {
           "name": "layout"
@@ -1923,6 +1984,10 @@
         {
           "name": "stroke"
         },
+        {
+          "name": "tag",
+          "description": "Heading level to render, independent of `size`/`fluid`."
+        },
         {
           "name": "tags"
         },
@@ -1993,6 +2058,10 @@
         {
           "name": "align"
         },
+        {
+          "name": "alt",
+          "description": "Description for an icon that carries meaning; omit for decoration."
+        },
         {
           "name": "animation"
         },
@@ -2146,6 +2215,10 @@
         {
           "name": "stroke"
         },
+        {
+          "name": "tag",
+          "description": "Heading level to render, independent of `size`/`fluid`."
+        },
         {
           "name": "templateCols"
         },
@@ -2219,6 +2292,10 @@
           "name": "alignIts",
           "deprecated": "obsolete. Its body sets background:\"gray\" and hardcodes alignItems/justifyItems to flex-start with the argument commented out — debugging left in. Use `customAlign` / `customJustify`."
         },
+        {
+          "name": "alt",
+          "description": "Description for an icon that carries meaning; omit for decoration."
+        },
         {
           "name": "animate"
         },
@@ -2448,7 +2525,8 @@
           "name": "kind"
         },
         {
-          "name": "label"
+          "name": "label",
+          "description": "Accessible name for the field."
         },
         {
           "name": "layout"
@@ -2602,6 +2680,10 @@
         {
           "name": "stroke"
         },
+        {
+          "name": "tag",
+          "description": "Heading level to render, independent of `size`/`fluid`."
+        },
         {
           "name": "tags"
         },
@@ -2695,6 +2777,10 @@
           "name": "alignIts",
           "deprecated": "obsolete. Its body sets background:\"gray\" and hardcodes alignItems/justifyItems to flex-start with the argument commented out — debugging left in. Use `customAlign` / `customJustify`."
         },
+        {
+          "name": "alt",
+          "description": "Description for an icon that carries meaning; omit for decoration."
+        },
         {
           "name": "animate"
         },
@@ -2915,7 +3001,8 @@
           "name": "kind"
         },
         {
-          "name": "label"
+          "name": "label",
+          "description": "Accessible name for the field."
         },
         {
           "name": "layout"
@@ -3069,6 +3156,10 @@
         {
           "name": "stroke"
         },
+        {
+          "name": "tag",
+          "description": "Heading level to render, independent of `size`/`fluid`."
+        },
         {
           "name": "tags"
         },
@@ -3158,6 +3249,10 @@
           "name": "alignIts",
           "deprecated": "obsolete. Its body sets background:\"gray\" and hardcodes alignItems/justifyItems to flex-start with the argument commented out — debugging left in. Use `customAlign` / `customJustify`."
         },
+        {
+          "name": "alt",
+          "description": "Description for an icon that carries meaning; omit for decoration."
+        },
         {
           "name": "animation"
         },
@@ -3354,7 +3449,8 @@
           "name": "kind"
         },
         {
-          "name": "label"
+          "name": "label",
+          "description": "Accessible name for the field."
         },
         {
           "name": "layout"
@@ -3499,6 +3595,10 @@
         {
           "name": "stroke"
         },
+        {
+          "name": "tag",
+          "description": "Heading level to render, independent of `size`/`fluid`."
+        },
         {
           "name": "tags"
         },
@@ -3593,6 +3693,10 @@
           "name": "alignIts",
           "deprecated": "obsolete. Its body sets background:\"gray\" and hardcodes alignItems/justifyItems to flex-start with the argument commented out — debugging left in. Use `customAlign` / `customJustify`."
         },
+        {
+          "name": "alt",
+          "description": "Description for an icon that carries meaning; omit for decoration."
+        },
         {
           "name": "animate"
         },
@@ -3822,7 +3926,8 @@
           "name": "kind"
         },
         {
-          "name": "label"
+          "name": "label",
+          "description": "Accessible name for the field."
         },
         {
           "name": "layout"
@@ -3976,6 +4081,10 @@
         {
           "name": "stroke"
         },
+        {
+          "name": "tag",
+          "description": "Heading level to render, independent of `size`/`fluid`."
+        },
         {
           "name": "tags"
         },
@@ -4103,6 +4212,10 @@
         {
           "name": "inputType"
         },
+        {
+          "name": "label",
+          "description": "Accessible name for the field."
+        },
         {
           "name": "mar",
           "description": "Margin. The same array-of-side-objects form as `pad`: `mar: [{a: 40}]`, keys `a t r b l`, combinable. Additionally `mar: \"center\"` sets left and right to auto, as does `{a: \"auto\"}` or `{center: true}`."
@@ -4134,6 +4247,9 @@
           "name": "theme",
           "description": "Explicit light/dark overrides — {light: {...}, dark: {...}}."
         },
+        {
+          "name": "title"
+        },
         {
           "name": "type",
           "description": "Input type attribute. Defaults to \"text\"; \"search\" adds the native clear button."
@@ -4168,6 +4284,10 @@
         {
           "name": "inputType"
         },
+        {
+          "name": "label",
+          "description": "Accessible name for the field."
+        },
         {
           "name": "mar",
           "description": "Margin. The same array-of-side-objects form as `pad`: `mar: [{a: 40}]`, keys `a t r b l`, combinable. Additionally `mar: \"center\"` sets left and right to auto, as does `{a: \"auto\"}` or `{center: true}`."
@@ -4377,6 +4497,10 @@
           "name": "alignIts",
           "deprecated": "obsolete. Its body sets background:\"gray\" and hardcodes alignItems/justifyItems to flex-start with the argument commented out — debugging left in. Use `customAlign` / `customJustify`."
         },
+        {
+          "name": "alt",
+          "description": "Description for an icon that carries meaning; omit for decoration."
+        },
         {
           "name": "animation"
         },
@@ -4576,7 +4700,8 @@
           "name": "kind"
         },
         {
-          "name": "label"
+          "name": "label",
+          "description": "Accessible name for the field."
         },
         {
           "name": "layout"
@@ -4718,6 +4843,10 @@
         {
           "name": "stroke"
         },
+        {
+          "name": "tag",
+          "description": "Heading level to render, independent of `size`/`fluid`."
+        },
         {
           "name": "tags"
         },
@@ -4902,6 +5031,10 @@
           "name": "alignIts",
           "deprecated": "obsolete. Its body sets background:\"gray\" and hardcodes alignItems/justifyItems to flex-start with the argument commented out — debugging left in. Use `customAlign` / `customJustify`."
         },
+        {
+          "name": "alt",
+          "description": "Description for an icon that carries meaning; omit for decoration."
+        },
         {
           "name": "animation"
         },
@@ -5098,7 +5231,8 @@
           "name": "kind"
         },
         {
-          "name": "label"
+          "name": "label",
+          "description": "Accessible name for the field."
         },
         {
           "name": "layout"
@@ -5240,6 +5374,10 @@
         {
           "name": "stroke"
         },
+        {
+          "name": "tag",
+          "description": "Heading level to render, independent of `size`/`fluid`."
+        },
         {
           "name": "tags"
         },
@@ -5307,6 +5445,10 @@
         {
           "name": "align"
         },
+        {
+          "name": "alt",
+          "description": "Description for an icon that carries meaning; omit for decoration."
+        },
         {
           "name": "animation"
         },
@@ -5413,7 +5555,8 @@
           "description": "Escape hatch — {key, value} written straight to element.style, or an array of them."
         },
         {
-          "name": "label"
+          "name": "label",
+          "description": "Accessible name for the field."
         },
         {
           "name": "layout"
@@ -5481,6 +5624,10 @@
         {
           "name": "stroke"
         },
+        {
+          "name": "tag",
+          "description": "Heading level to render, independent of `size`/`fluid`."
+        },
         {
           "name": "title"
         },
@@ -5539,6 +5686,10 @@
           "name": "alignIts",
           "deprecated": "obsolete. Its body sets background:\"gray\" and hardcodes alignItems/justifyItems to flex-start with the argument commented out — debugging left in. Use `customAlign` / `customJustify`."
         },
+        {
+          "name": "alt",
+          "description": "Description for an icon that carries meaning; omit for decoration."
+        },
         {
           "name": "animation"
         },
@@ -5735,7 +5886,8 @@
           "name": "kind"
         },
         {
-          "name": "label"
+          "name": "label",
+          "description": "Accessible name for the field."
         },
         {
           "name": "layout"
@@ -5877,6 +6029,10 @@
         {
           "name": "stroke"
         },
+        {
+          "name": "tag",
+          "description": "Heading level to render, independent of `size`/`fluid`."
+        },
         {
           "name": "tags"
         },
@@ -5962,6 +6118,10 @@
           "name": "alignIts",
           "deprecated": "obsolete. Its body sets background:\"gray\" and hardcodes alignItems/justifyItems to flex-start with the argument commented out — debugging left in. Use `customAlign` / `customJustify`."
         },
+        {
+          "name": "alt",
+          "description": "Description for an icon that carries meaning; omit for decoration."
+        },
         {
           "name": "animation"
         },
@@ -6158,7 +6318,8 @@
           "name": "kind"
         },
         {
-          "name": "label"
+          "name": "label",
+          "description": "Accessible name for the field."
         },
         {
           "name": "layout"
@@ -6300,6 +6461,10 @@
         {
           "name": "stroke"
         },
+        {
+          "name": "tag",
+          "description": "Heading level to render, independent of `size`/`fluid`."
+        },
         {
           "name": "tags"
         },
@@ -6370,6 +6535,10 @@
           "name": "alignIts",
           "deprecated": "obsolete. Its body sets background:\"gray\" and hardcodes alignItems/justifyItems to flex-start with the argument commented out — debugging left in. Use `customAlign` / `customJustify`."
         },
+        {
+          "name": "alt",
+          "description": "Description for an icon that carries meaning; omit for decoration."
+        },
         {
           "name": "animation"
         },
@@ -6616,6 +6785,10 @@
         {
           "name": "stroke"
         },
+        {
+          "name": "tag",
+          "description": "Heading level to render, independent of `size`/`fluid`."
+        },
         {
           "name": "top"
         },
@@ -6680,6 +6853,10 @@
           "name": "alignIts",
           "deprecated": "obsolete. Its body sets background:\"gray\" and hardcodes alignItems/justifyItems to flex-start with the argument commented out — debugging left in. Use `customAlign` / `customJustify`."
         },
+        {
+          "name": "alt",
+          "description": "Description for an icon that carries meaning; omit for decoration."
+        },
         {
           "name": "animation"
         },
@@ -6876,7 +7053,8 @@
           "name": "kind"
         },
         {
-          "name": "label"
+          "name": "label",
+          "description": "Accessible name for the field."
         },
         {
           "name": "layout"
@@ -7018,6 +7196,10 @@
         {
           "name": "stroke"
         },
+        {
+          "name": "tag",
+          "description": "Heading level to render, independent of `size`/`fluid`."
+        },
         {
           "name": "tags"
         },
@@ -7247,6 +7429,10 @@
         {
           "name": "align"
         },
+        {
+          "name": "alt",
+          "description": "Description for an icon that carries meaning; omit for decoration."
+        },
         {
           "name": "animation"
         },
@@ -7412,6 +7598,10 @@
         {
           "name": "stroke"
         },
+        {
+          "name": "tag",
+          "description": "Heading level to render, independent of `size`/`fluid`."
+        },
         {
           "name": "top"
         },
@@ -7554,6 +7744,10 @@
           "name": "alignIts",
           "deprecated": "obsolete. Its body sets background:\"gray\" and hardcodes alignItems/justifyItems to flex-start with the argument commented out — debugging left in. Use `customAlign` / `customJustify`."
         },
+        {
+          "name": "alt",
+          "description": "Description for an icon that carries meaning; omit for decoration."
+        },
         {
           "name": "animation"
         },
@@ -7750,7 +7944,8 @@
           "name": "kind"
         },
         {
-          "name": "label"
+          "name": "label",
+          "description": "Accessible name for the field."
         },
         {
           "name": "layout"
@@ -7892,6 +8087,10 @@
         {
           "name": "stroke"
         },
+        {
+          "name": "tag",
+          "description": "Heading level to render, independent of `size`/`fluid`."
+        },
         {
           "name": "tags"
         },

package/skills/nodality/SKILL.md

@@ -68,6 +68,20 @@ Skipping step 3 is the classic failure: a misspelled op renders
 *nothing* rather than erroring, so the page looks plausible and is
 silently missing its effects.
 
+## HTML's names are accepted
+
+`src` and `href` both mean `url`; `options` means `items`. Write either — the
+canonical names are `url` and `items`, and that is what `get_schema` reports.
+Giving both with **different** values is reported as `CONFLICTING_ALIAS`,
+because one of them would be ignored.
+
+A table's rows may also be written as arrays with the header row first, the way
+a CSV is:
+
+```js
+{ type: "table", items: [["date", "race"], ["29/08", "Krusnoman"]] }
+```
+
 ## Composites carry their content in a slot
 
 A composite is not empty scaffolding – you give it content, and **which
@@ -195,6 +209,42 @@ One naming caution: `Text` and `Image` collide with DOM constructor
 names. Always use the module import; on a page using the CDN globals,
 never assume `window.Text` / `window.Image` are still the DOM's own.
 
+## Building more than one page
+
+Declare shared chrome once and reference it. **`.defs()` must come before
+`.add()`** — `add` renders as it goes, so definitions arriving later cannot be
+used, and the wrong order is refused with a message saying so.
+
+```js
+const shared = {                      // one file, imported by every page
+  nav:    { type: "nav", items: [{ title: "Home", link: "/" }] },
+  footer: { type: "wrap", children: [{ type: "p", text: "Acme" }] },
+};
+
+new Des().defs(shared).nodes(N)
+  .add([{ $ref: "nav" }, { type: "h1", text: "Pricing" }, { $ref: "footer" }])
+  .set({ mount: "#mount" });
+```
+
+Keys written beside a reference **override** the definition, which is how one
+nav serves every page:
+
+```js
+{ $ref: "nav", id: "topnav" }                       // adds an id
+{ $ref: "nav", items: [{ title: "Docs", link: "/d" }] }   // replaces the list
+```
+
+The merge is shallow: an override replaces a slot, it does not extend it.
+
+Worth it from **two pages up**: on a single page a reference costs more than
+writing the thing, so do not reach for it before then. On a real site's nav and
+footer it is 1.7x at four pages and about 2x at ten — measured, because 61% of
+every token in that site was the same chrome repeated.
+
+A name with no definition is refused at render and reported by
+`validate_nodes` as `DANGLING_REF` with a did-you-mean, so pass `defs` as the
+third argument when you validate a page that uses references.
+
 ## Editing a page that already exists
 
 Editing is the common case in production, and it does not mean