nodality 1.3.8 → 1.3.10

package/lib/scroll-video.js

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

package/lib/seo.js

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

package/lib/stacker.js

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

package/lib/suggest.js

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

package/lib/theme.js

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

package/lib/transform-anim.js

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

package/lib/transition.js

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

package/lib/validate-nodes.js

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

package/lib/webmcp-adapter.js

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

package/package.json

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

package/schema.json

@@ -4593,16 +4593,85 @@
         "Set"
       ],
       "params": [
+        {
+          "name": "aspectRatio",
+          "description": "Box proportion held before the video loads, e.g. \"16 / 9\". Prevents the page shifting when the first frame arrives."
+        },
+        {
+          "name": "autoplay",
+          "description": "Start on its own. Implies muted and playsinline, pauses off screen and in a hidden tab, and is cancelled by prefers-reduced-motion (the poster stays)."
+        },
+        {
+          "name": "background",
+          "description": "CSS background behind the frame — visible while the poster loads."
+        },
+        {
+          "name": "controls",
+          "description": "Show the browser's playback controls. Default true — pass false for an ambient loop."
+        },
+        {
+          "name": "decorative",
+          "description": "Hide from assistive technology. For an ambient loop that repeats what the page already says in text."
+        },
+        {
+          "name": "height",
+          "description": "CSS height of the element."
+        },
         {
           "name": "id",
-          "description": "This element's DOM id. Also what a design node's `target` names, and what `parse` recovers an element by."
+          "description": "DOM id. Also what a node's `target` names, so a clip carrying a raster op needs one."
         },
         {
-          "name": "opacity"
+          "name": "label",
+          "description": "Accessible name, for a clip that carries meaning."
+        },
+        {
+          "name": "lazy",
+          "description": "Only play while on screen. On by default whenever `autoplay` is set; pass false to keep an autoplaying clip running off screen."
+        },
+        {
+          "name": "loop",
+          "description": "Restart when the clip ends."
+        },
+        {
+          "name": "maxWidth",
+          "description": "CSS max-width of the element."
+        },
+        {
+          "name": "muted",
+          "description": "Mute the audio track. Forced on by `autoplay`, because browsers block an unmuted autoplay; pass false only if you mean to accept that."
+        },
+        {
+          "name": "objectFit",
+          "description": "How the frame fills the element box: \"cover\", \"contain\", \"fill\", \"none\"."
+        },
+        {
+          "name": "opacity",
+          "description": "0–1."
+        },
+        {
+          "name": "playsinline",
+          "description": "Play in place on iPhone instead of taking over the screen. Implied by `autoplay`; there is no reason to refuse it on a background loop."
+        },
+        {
+          "name": "poster",
+          "description": "Image shown before the first frame decodes. Give one on any autoplaying clip: it is what holds the layout still and what reduced-motion visitors see instead of the video."
+        },
+        {
+          "name": "preload",
+          "description": "\"none\", \"metadata\" (a good default for a loop) or \"auto\"."
         },
         {
           "name": "radius",
-          "description": "Corner radius in pixels. A bare number, not a CSS length."
+          "description": "Corner radius. A CSS length; a bare number is read as pixels."
+        },
+        {
+          "name": "raster",
+          "description": "Raster op nodes to run over this element."
+        },
+        {
+          "name": "sources",
+          "description": "Several encodings of the same clip: [{url, type}] or plain url strings. The browser picks the first it can play, so order best-first (AV1, then HEVC, then H.264). `type` is inferred from the extension when omitted."
         },
         {
           "name": "type",
@@ -4612,7 +4681,8 @@
           "name": "url"
         },
         {
-          "name": "width"
+          "name": "width",
+          "description": "CSS width of the element."
         }
       ]
     },
@@ -6285,11 +6355,100 @@
           "name": "width"
         }
       ]
+    },
+    "gridOverlay": {
+      "resolved": true,
+      "mapper": "mapGridOverlay",
+      "components": [
+        "GridOverlay"
+      ],
+      "params": [
+        {
+          "name": "breakpoint",
+          "description": "Viewport width in px below which `mobile` applies. Default 768."
+        },
+        {
+          "name": "color",
+          "description": "Colour of lines, marks and readouts (drawn with currentColor). Falls back to the Theme text colour."
+        },
+        {
+          "name": "columns",
+          "description": "Columns, counted as cells (N cells draw N+1 lines). 0 draws no vertical lines. Default 4. Named `columns`, not `cols`: the library's shared `cols` means grid-template-columns verbatim."
+        },
+        {
+          "name": "font",
+          "description": "Font family of the readouts. Default a monospace stack."
+        },
+        {
+          "name": "fontSize",
+          "description": "Readout font size in px. Default 11."
+        },
+        {
+          "name": "id",
+          "description": "This element's DOM id. Also what a design node's `target` names, and what `parse` recovers an element by."
+        },
+        {
+          "name": "inset",
+          "description": "Distance of the outermost lines from the edge in px. A number, or {x, y}. Default 16."
+        },
+        {
+          "name": "letterSpacing",
+          "description": "Readout letter spacing, any CSS length. Default \"0.04em\"."
+        },
+        {
+          "name": "lineOpacity",
+          "description": "Opacity of the lines only; marks and readouts stay opaque. 0–1, default 0.35."
+        },
+        {
+          "name": "lineWidth",
+          "description": "Stroke width of the grid lines in px. Default 1."
+        },
+        {
+          "name": "markSize",
+          "description": "Size of each registration mark in px. Default 8."
+        },
+        {
+          "name": "marks",
+          "description": "Registration mark at each intersection: \"square\" (default), \"cross\" or \"none\"."
+        },
+        {
+          "name": "mobile",
+          "description": "Options that replace their desktop values below `breakpoint`, e.g. {columns: 1, rows: 4}."
+        },
+        {
+          "name": "position",
+          "description": "\"fixed\" (default) pins the grid to the viewport; \"absolute\" fills the nearest positioned ancestor."
+        },
+        {
+          "name": "raster",
+          "description": "Raster op nodes for the overlay, e.g. an offset driven by hover to bend the lines near the cursor."
+        },
+        {
+          "name": "readouts",
+          "description": "Labels beside intersections: [{id, col, row, text, anchor}]. col/row index lines from 0; anchor \"br\" (default), \"bl\", \"tr\" or \"tl\", flipped automatically when the label would fall outside. Decorative — say the same thing in real page text."
+        },
+        {
+          "name": "rows",
+          "description": "Rows across the overlay's height, counted as cells. 0 draws no horizontal lines. Default 2."
+        },
+        {
+          "name": "type",
+          "description": "The element type, which selects the mapper that builds it -- \"h1\", \"cards\", \"form\", and so on."
+        },
+        {
+          "name": "uppercase",
+          "description": "Uppercase the readout text. Default true."
+        },
+        {
+          "name": "zIndex",
+          "description": "Stacking order of the overlay. Default 2 — keep navigation above it."
+        }
+      ]
     }
   },
   "summary": {
-    "types": 35,
-    "resolved": 35,
+    "types": 36,
+    "resolved": 36,
     "unresolved": 0
   }
 }