@glissade/scene 0.20.0-pre.6 → 0.20.0

package/dist/describe.js

@@ -23,7 +23,7 @@ import { easings, listValueTypes } from "@glissade/core";
 * never pulled onto the base embed path — a scene that never calls `describe()`
 * pays zero bytes for it.
 */
-const RAW_VERSION = "0.20.0-pre.6";
+const RAW_VERSION = "0.20.0";
 const PACKAGE_VERSION = RAW_VERSION.includes("GLISSADE_".concat("VERSION")) ? "0.0.0-dev" : RAW_VERSION;
 /** Arity of a value type's numeric repr: vec2/vec2-arc → 2, number → 1; others (color/paint/path/string/boolean) carry no scalar arity. */
 function arityOf(type) {

package/dist/layout.d.ts

@@ -3,7 +3,28 @@ import { Column, Layout, LayoutProps, Row, RowProps, Stack, StackProps } from ".
 
 //#region src/layoutEngineYoga.d.ts
 
+/** Options for {@link loadYogaLayoutEngine}. */
+interface LoadYogaOptions {
+  /**
+   * Override the module specifier the loader dynamic-imports for `yoga-layout`.
+   *
+   * The default (`undefined`) imports the bare `'yoga-layout/load'` specifier —
+   * correct under npm / a bundler / an import map, where the resolver finds the
+   * package. But in the **no-build `@glissade/browser` IIFE** there is no
+   * resolver, so a bare specifier throws *"Module name, 'yoga-layout/load' does
+   * not resolve to a valid URL."* — the headline no-build layout feature can't
+   * self-load. Pass a CDN ESM URL to resolve it without an import map, e.g.
+   *
+   * ```js
+   * await glissade.loadYogaLayoutEngine({ url: 'https://esm.sh/yoga-layout@3.2.1/load' });
+   * ```
+   *
+   * (Or register an `<script type="importmap">` mapping `yoga-layout/load` to
+   * that URL and call with no argument — see `docs/layout.md`.)
+   */
+  url?: string;
+}
 /** Load Yoga (wasm) and register it as the active LayoutEngine. Idempotent. */
-declare function loadYogaLayoutEngine(): Promise<LayoutEngine>;
+declare function loadYogaLayoutEngine(opts?: LoadYogaOptions): Promise<LayoutEngine>;
 //#endregion
 export { Column, Layout, type LayoutBox, type LayoutChildSpec, type LayoutContainerSpec, type LayoutEngine, LayoutEngineMissingError, type LayoutProps, type LayoutResult, Row, type RowProps, Stack, type StackProps, getLayoutEngine, loadYogaLayoutEngine, setLayoutEngine };

package/dist/layout.js

@@ -12,8 +12,12 @@ import { Column, Layout, Row, Stack } from "./layoutCtors.js";
 * of the bundle).
 */
 /** Load Yoga (wasm) and register it as the active LayoutEngine. Idempotent. */
-async function loadYogaLayoutEngine() {
-	const { loadYoga, FlexDirection, Justify, Align, Gutter, Edge, Direction } = await import("yoga-layout/load");
+async function loadYogaLayoutEngine(opts) {
+	const { loadYoga, FlexDirection, Justify, Align, Gutter, Edge, Direction } = opts?.url ? await import(
+		/* @vite-ignore */
+		/* webpackIgnore: true */
+		opts.url
+) : await import("yoga-layout/load");
 	const yoga = await loadYoga();
 	const JUSTIFY = {
 		start: Justify.FlexStart,

package/dist/layoutCtors.d.ts

@@ -29,6 +29,13 @@ declare class Layout extends Group {
   #private;
   /** CLI/host detection marker — avoids importing this entry just to instanceof. */
   static readonly isLayoutNode = true;
+  /**
+   * Taxonomy name pinned literally (survives IIFE minification — see {@link Group}).
+   * Overrides Group's `'Group'`; `Stack`/`Row`/`Column` are factories returning a
+   * `Layout`, so they inherit `'Layout'` and the bind-guard names their construction
+   * props (`direction`/`justify`/`align`/`children`) correctly in the minified bundle.
+   */
+  get describeType(): string;
   readonly width: BindableSignal<number>;
   readonly height: BindableSignal<number>;
   readonly gap: BindableSignal<number>;

package/dist/layoutCtors.js

@@ -33,6 +33,15 @@ import { computed, signal } from "@glissade/core";
 var Layout = class extends Group {
 	/** CLI/host detection marker — avoids importing this entry just to instanceof. */
 	static isLayoutNode = true;
+	/**
+	* Taxonomy name pinned literally (survives IIFE minification — see {@link Group}).
+	* Overrides Group's `'Group'`; `Stack`/`Row`/`Column` are factories returning a
+	* `Layout`, so they inherit `'Layout'` and the bind-guard names their construction
+	* props (`direction`/`justify`/`align`/`children`) correctly in the minified bundle.
+	*/
+	get describeType() {
+		return "Layout";
+	}
 	width;
 	height;
 	gap;

package/dist/nodes.d.ts

@@ -363,6 +363,17 @@ declare abstract class Custom extends Node {}
 declare function roundedRectSegs(x: number, y: number, w: number, h: number, r: number): PathSeg[];
 declare class Group extends Node {
   #private;
+  /**
+   * Taxonomy name pinned as a STRING LITERAL (not the inherited
+   * `constructor.name`): the minified `@glissade/browser` IIFE mangles class
+   * names, so the base `Node.describeType` getter returns a garbled name in the
+   * bundle — which silently breaks the bind-guard's construction-prop message
+   * (`scene.ts` keys `isConstructionProp(node.describeType, …)` on it, so a
+   * mangled name falls through to the generic "no signal resolves" error).
+   * Every built-in node pins it literally; `ImageNode` already did. Render-neutral
+   * (describeType is read only on the error path + by `describe()`).
+   */
+  get describeType(): string;
   readonly children: Node[];
   constructor(props?: NodeProps & {
     children?: Node[];
@@ -429,6 +440,8 @@ declare function coercePathData(data: unknown): PathValue;
  */
 declare function pathFromSegs(segs: readonly PathSeg[]): PathValue;
 declare class Rect extends Shape {
+  /** Taxonomy name pinned literally (survives IIFE minification — see {@link Group}). */
+  get describeType(): string;
   readonly width: BindableSignal<number>;
   readonly height: BindableSignal<number>;
   /** Corner radius; clamped to half the smaller dimension. radius = h/2 makes a pill. */
@@ -445,6 +458,8 @@ declare class Rect extends Shape {
   protected pathSegs(): PathSeg[];
 }
 declare class Circle extends Shape {
+  /** Taxonomy name pinned literally (survives IIFE minification — see {@link Group}). */
+  get describeType(): string;
   readonly radius: BindableSignal<number>;
   constructor(props?: ShapeProps & {
     radius?: PropInit<number>;
@@ -472,6 +487,8 @@ interface PathProps extends ShapeProps {
  * wherever the author put 0,0); flow placement uses the control-point bounds.
  */
 declare class Path extends Shape {
+  /** Taxonomy name pinned literally (survives IIFE minification — see {@link Group}). */
+  get describeType(): string;
   readonly data: BindableSignal<PathValue>;
   constructor(props?: PathProps);
   /** Control-point bounding box (conservative: contains the true curve). */
@@ -540,6 +557,8 @@ interface VideoProps extends NodeProps {
 declare class Video extends Node {
   /** Marks this node as referencing a kind 'video' timeline asset (§3.8). */
   static readonly assetKind: "video";
+  /** Taxonomy name pinned literally (survives IIFE minification — see {@link Group}). */
+  get describeType(): string;
   readonly assetId: string;
   readonly at: number;
   readonly trimStart: number;
@@ -637,6 +656,8 @@ interface TextProps extends NodeProps {
   revealFraction?: PropInit<number>;
 }
 declare class Text extends Node {
+  /** Taxonomy name pinned literally (survives IIFE minification — see {@link Group}). */
+  get describeType(): string;
   readonly text: BindableSignal<string>;
   readonly fill: BindableSignal<string>;
   readonly fontSize: BindableSignal<number>;

package/dist/nodes.js

@@ -1035,6 +1035,19 @@ function roundedRectSegs(x, y, w, h, r) {
 	];
 }
 var Group = class extends Node {
+	/**
+	* Taxonomy name pinned as a STRING LITERAL (not the inherited
+	* `constructor.name`): the minified `@glissade/browser` IIFE mangles class
+	* names, so the base `Node.describeType` getter returns a garbled name in the
+	* bundle — which silently breaks the bind-guard's construction-prop message
+	* (`scene.ts` keys `isConstructionProp(node.describeType, …)` on it, so a
+	* mangled name falls through to the generic "no signal resolves" error).
+	* Every built-in node pins it literally; `ImageNode` already did. Render-neutral
+	* (describeType is read only on the error path + by `describe()`).
+	*/
+	get describeType() {
+		return "Group";
+	}
 	children;
 	/** Version bumped on structural child mutation, so a dependency-tracked memo
 	* (e.g. Layout's computed) re-runs when the child SET changes — not only when
@@ -1356,6 +1369,10 @@ function pathFromSegs(segs) {
 	return contours;
 }
 var Rect = class extends Shape {
+	/** Taxonomy name pinned literally (survives IIFE minification — see {@link Group}). */
+	get describeType() {
+		return "Rect";
+	}
 	width;
 	height;
 	/** Corner radius; clamped to half the smaller dimension. radius = h/2 makes a pill. */
@@ -1383,6 +1400,10 @@ var Rect = class extends Shape {
 	}
 };
 var Circle = class extends Shape {
+	/** Taxonomy name pinned literally (survives IIFE minification — see {@link Group}). */
+	get describeType() {
+		return "Circle";
+	}
 	radius;
 	constructor(props = {}) {
 		super(props);
@@ -1416,6 +1437,10 @@ var Circle = class extends Shape {
 * wherever the author put 0,0); flow placement uses the control-point bounds.
 */
 var Path = class extends Shape {
+	/** Taxonomy name pinned literally (survives IIFE minification — see {@link Group}). */
+	get describeType() {
+		return "Path";
+	}
 	data;
 	constructor(props = {}) {
 		super(props);
@@ -1560,6 +1585,10 @@ var ImageNode = class extends Node {
 var Video = class extends Node {
 	/** Marks this node as referencing a kind 'video' timeline asset (§3.8). */
 	static assetKind = "video";
+	/** Taxonomy name pinned literally (survives IIFE minification — see {@link Group}). */
+	get describeType() {
+		return "Video";
+	}
 	assetId;
 	at;
 	trimStart;
@@ -1614,6 +1643,10 @@ var Video = class extends Node {
 	}
 };
 var Text = class extends Node {
+	/** Taxonomy name pinned literally (survives IIFE minification — see {@link Group}). */
+	get describeType() {
+		return "Text";
+	}
 	text;
 	fill;
 	fontSize;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glissade/scene",
-  "version": "0.20.0-pre.6",
+  "version": "0.20.0",
   "description": "glissade scene graph: nodes, transforms, DisplayList emission. Renderer-agnostic; zero DOM/Node dependencies.",
   "license": "Apache-2.0",
   "engines": {
@@ -59,7 +59,7 @@
   ],
   "dependencies": {
     "yoga-layout": "^3.2.1",
-    "@glissade/core": "0.20.0-pre.6"
+    "@glissade/core": "0.20.0"
   },
   "repository": {
     "type": "git",