nodality 1.3.9 → 1.3.11

package/layout/grid-overlay.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.3.9
+ * nodality v1.3.11
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */
@@ -93,39 +93,39 @@ class GridOverlay extends Animator {
 		// or a destructure here would hide them from `get_schema` and make the
 		// validator reject valid specs.
 		this.config = {
-			//@ gridOverlay.columns: 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.
+			//@ gridOverlay.columns {count}: 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.
 			columns: obj.columns ?? DEFAULTS.columns,
-			//@ gridOverlay.rows: Rows across the overlay's height, counted as cells. 0 draws no horizontal lines. Default 2.
+			//@ gridOverlay.rows {count}: Rows across the overlay's height, counted as cells. 0 draws no horizontal lines. Default 2.
 			rows: obj.rows ?? DEFAULTS.rows,
-			//@ gridOverlay.inset: Distance of the outermost lines from the edge in px. A number, or {x, y}. Default 16.
+			//@ gridOverlay.inset {px-number}: Distance of the outermost lines from the edge in px. A number, or {x, y}. Default 16.
 			inset: obj.inset ?? DEFAULTS.inset,
-			//@ gridOverlay.color: Colour of lines, marks and readouts (drawn with currentColor). Falls back to the Theme text colour.
+			//@ gridOverlay.color {color}: Colour of lines, marks and readouts (drawn with currentColor). Falls back to the Theme text colour.
 			color: obj.color,
-			//@ gridOverlay.lineWidth: Stroke width of the grid lines in px. Default 1.
+			//@ gridOverlay.lineWidth {px-number}: Stroke width of the grid lines in px. Default 1.
 			lineWidth: obj.lineWidth ?? DEFAULTS.lineWidth,
-			//@ gridOverlay.lineOpacity: Opacity of the lines only; marks and readouts stay opaque. 0–1, default 0.35.
+			//@ gridOverlay.lineOpacity {ratio}: Opacity of the lines only; marks and readouts stay opaque. 0–1, default 0.35.
 			lineOpacity: obj.lineOpacity ?? DEFAULTS.lineOpacity,
-			//@ gridOverlay.marks: Registration mark at each intersection: "square" (default), "cross" or "none".
+			//@ gridOverlay.marks {enum(square|cross|none)}: Registration mark at each intersection: "square" (default), "cross" or "none".
 			marks: obj.marks ?? DEFAULTS.marks,
-			//@ gridOverlay.markSize: Size of each registration mark in px. Default 8.
+			//@ gridOverlay.markSize {px-number}: Size of each registration mark in px. Default 8.
 			markSize: obj.markSize ?? DEFAULTS.markSize,
-			//@ gridOverlay.position: "fixed" (default) pins the grid to the viewport; "absolute" fills the nearest positioned ancestor.
+			//@ gridOverlay.position {enum(fixed|absolute)}: "fixed" (default) pins the grid to the viewport; "absolute" fills the nearest positioned ancestor.
 			position: obj.position ?? DEFAULTS.position,
-			//@ gridOverlay.zIndex: Stacking order of the overlay. Default 2 — keep navigation above it.
+			//@ gridOverlay.zIndex {count}: Stacking order of the overlay. Default 2 — keep navigation above it.
 			zIndex: obj.zIndex ?? DEFAULTS.zIndex,
-			//@ gridOverlay.font: Font family of the readouts. Default a monospace stack.
+			//@ gridOverlay.font {text}: Font family of the readouts. Default a monospace stack.
 			font: obj.font ?? DEFAULTS.font,
-			//@ gridOverlay.fontSize: Readout font size in px. Default 11.
+			//@ gridOverlay.fontSize {px-number}: Readout font size in px. Default 11.
 			fontSize: obj.fontSize ?? DEFAULTS.fontSize,
-			//@ gridOverlay.letterSpacing: Readout letter spacing, any CSS length. Default "0.04em".
+			//@ gridOverlay.letterSpacing {text}: Readout letter spacing, any CSS length. Default "0.04em".
 			letterSpacing: obj.letterSpacing ?? DEFAULTS.letterSpacing,
-			//@ gridOverlay.uppercase: Uppercase the readout text. Default true.
+			//@ gridOverlay.uppercase {bool}: Uppercase the readout text. Default true.
 			uppercase: obj.uppercase ?? DEFAULTS.uppercase,
-			//@ gridOverlay.breakpoint: Viewport width in px below which `mobile` applies. Default 768.
+			//@ gridOverlay.breakpoint {px-number}: Viewport width in px below which `mobile` applies. Default 768.
 			breakpoint: obj.breakpoint ?? DEFAULTS.breakpoint,
-			//@ gridOverlay.mobile: Options that replace their desktop values below `breakpoint`, e.g. {columns: 1, rows: 4}.
+			//@ gridOverlay.mobile {object}: Options that replace their desktop values below `breakpoint`, e.g. {columns: 1, rows: 4}.
 			mobile: obj.mobile,
-			//@ gridOverlay.readouts: 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.
+			//@ gridOverlay.readouts {array}: 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.
 			readouts: obj.readouts ?? DEFAULTS.readouts,
 		};
 
@@ -138,7 +138,7 @@ class GridOverlay extends Animator {
 		this._watchSize();
 		this.draw();
 
-		//@ gridOverlay.raster: Raster op nodes for the overlay, e.g. an offset driven by hover to bend the lines near the cursor.
+		//@ gridOverlay.raster {nodes}: Raster op nodes for the overlay, e.g. an offset driven by hover to bend the lines near the cursor.
 		obj.raster && this.rasterize(obj.raster);
 		return this;
 	}

package/layout/grid-switcher.js

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

package/layout/grid.js

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

package/layout/horizontal-scroller.js

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

package/layout/image.js

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

package/layout/index.js

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

package/layout/link.js

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

package/layout/list.js

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

package/layout/meta-adder.js

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

package/layout/modal-2025.js

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

package/layout/morph.js

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

package/layout/multiswitcher.js

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

package/layout/nav-bar.js

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

package/layout/nav-factor/custom-div.js

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

package/layout/new-nav-bar.js

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

package/layout/polygon.js

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

package/layout/prerender-site.js

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

package/layout/prerender.js

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

package/layout/progress.js

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

package/layout/row.js

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

package/layout/scroll-video.js

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

package/layout/side-bar.js

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

package/layout/side-nav-bar.js

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

package/layout/simple-bar.js

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

package/layout/slider-2025.js

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

package/layout/spacer.js

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

package/layout/stack.js

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

package/layout/svg.js

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

package/layout/switcher.js

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

package/layout/table.js

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

package/layout/text-field.js

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

package/layout/text.js

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

package/layout/ulist.js

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

package/layout/video.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.3.9
+ * nodality v1.3.11
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */
@@ -74,7 +74,7 @@ class Video extends Animator {
 		this.options = obj;
 		const v = this.res;
 
-		//@ video.sources: 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.
+		//@ video.sources {array}: 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.
 		if (Array.isArray(obj.sources) && obj.sources.length) {
 			// A `src` attribute wins over <source> children, so it has to go.
 			v.removeAttribute("src");
@@ -93,27 +93,27 @@ class Video extends Animator {
 			}
 		}
 
-		//@ video.poster: 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.
+		//@ video.poster {url}: 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.
 		obj.poster && v.setAttribute("poster", obj.poster);
 
-		//@ video.preload: "none", "metadata" (a good default for a loop) or "auto".
+		//@ video.preload {enum(none|metadata|auto)}: "none", "metadata" (a good default for a loop) or "auto".
 		obj.preload && v.setAttribute("preload", obj.preload);
 
-		//@ video.controls: Show the browser's playback controls. Default true — pass false for an ambient loop.
+		//@ video.controls {bool}: Show the browser's playback controls. Default true — pass false for an ambient loop.
 		if (obj.controls === false) v.removeAttribute("controls");
 		else if (obj.controls === true) v.setAttribute("controls", "controls");
 
-		//@ video.loop: Restart when the clip ends.
+		//@ video.loop {bool}: Restart when the clip ends.
 		obj.loop && (v.loop = true, v.setAttribute("loop", "loop"));
 
-		//@ video.playsinline: 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.
+		//@ video.playsinline {bool}: 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.
 		const playsinline = obj.playsinline ?? obj.autoplay;
 		if (playsinline) {
 			v.setAttribute("playsinline", "");
 			v.setAttribute("webkit-playsinline", "");
 		}
 
-		//@ video.muted: Mute the audio track. Forced on by `autoplay`, because browsers block an unmuted autoplay; pass false only if you mean to accept that.
+		//@ video.muted {bool}: Mute the audio track. Forced on by `autoplay`, because browsers block an unmuted autoplay; pass false only if you mean to accept that.
 		const muted = obj.muted ?? (obj.autoplay ? true : undefined);
 		if (muted === true) {
 			v.muted = true;
@@ -123,36 +123,39 @@ class Video extends Animator {
 			v.removeAttribute("muted");
 		}
 
-		//@ video.autoplay: 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).
-		//@ video.lazy: Only play while on screen. On by default whenever `autoplay` is set; pass false to keep an autoplaying clip running off screen.
+		//@ video.autoplay {bool}: 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).
+		//@ video.lazy {bool}: Only play while on screen. On by default whenever `autoplay` is set; pass false to keep an autoplaying clip running off screen.
 		if (obj.autoplay) this._autoplay(obj.lazy !== false);
 
-		//@ video.objectFit: How the frame fills the element box: "cover", "contain", "fill", "none".
+		//@ video.objectFit {enum(cover|contain|fill|none|scale-down)}: How the frame fills the element box: "cover", "contain", "fill", "none".
 		obj.objectFit && (v.style.objectFit = obj.objectFit);
 
-		//@ video.aspectRatio: Box proportion held before the video loads, e.g. "16 / 9". Prevents the page shifting when the first frame arrives.
+		//@ video.aspectRatio {css-aspect-ratio}: Box proportion held before the video loads, e.g. "16 / 9". Prevents the page shifting when the first frame arrives.
 		obj.aspectRatio && (v.style.aspectRatio = obj.aspectRatio);
 
-		//@ video.label: Accessible name, for a clip that carries meaning.
+		//@ video.id {text}: DOM id. Also what a node's `target` names, so a clip carrying a raster op needs one.
+		obj.id && v.setAttribute("id", obj.id);
+
+		//@ video.label {text}: Accessible name, for a clip that carries meaning.
 		obj.label && v.setAttribute("aria-label", obj.label);
 
-		//@ video.decorative: Hide from assistive technology. For an ambient loop that repeats what the page already says in text.
+		//@ video.decorative {bool}: Hide from assistive technology. For an ambient loop that repeats what the page already says in text.
 		if (obj.decorative) v.setAttribute("aria-hidden", "true");
 
-		//@ video.background: CSS background behind the frame — visible while the poster loads.
+		//@ video.background {color}: CSS background behind the frame — visible while the poster loads.
 		obj.background && (v.style.background = obj.background);
-		//@ video.height: CSS height of the element.
+		//@ video.height {css-length}: CSS height of the element.
 		obj.height && (v.style.height = obj.height);
-		//@ video.maxWidth: CSS max-width of the element.
+		//@ video.maxWidth {css-length}: CSS max-width of the element.
 		obj.maxWidth && (v.style.maxWidth = obj.maxWidth);
-		//@ video.radius: Corner radius. A CSS length; a bare number is read as pixels.
+		//@ video.radius {px-or-length}: Corner radius. A CSS length; a bare number is read as pixels.
 		obj.radius && (v.style.borderRadius = typeof obj.radius === "number" ? `${obj.radius}px` : obj.radius);
-		//@ video.width: CSS width of the element.
+		//@ video.width {css-length}: CSS width of the element.
 		obj.width && (v.style.width = `${obj.width}`);
-		//@ video.opacity: 0–1.
+		//@ video.opacity {ratio}: 0–1.
 		obj.opacity && (v.style.opacity = obj.opacity);
 
-		//@ video.raster: Raster op nodes to run over this element.
+		//@ video.raster {nodes}: Raster op nodes to run over this element.
 		obj.raster && this.rasterize(obj.raster);
 
 		return this;

package/layout/wrap.js

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

package/layout/zoom-card.js

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

package/lib/agent-surface.js

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

package/lib/card-getter.js

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

package/lib/check-page.js

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

package/lib/codegen.js

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

package/lib/data.js

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

package/lib/designer.js

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