@glissade/scene 0.24.0 → 0.25.0-pre.1

package/dist/describe.js

@@ -22,7 +22,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.24.0";
+const RAW_VERSION = "0.25.0-pre.1";
 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/examples.d.ts

@@ -30,9 +30,21 @@ interface ApiExample {
   run: () => void;
 }
 declare const EXAMPLES: readonly ApiExample[];
-/** Group the corpus by describe-key → the surfaced code snippets. */
-declare function examplesByKey(): {
+/**
+ * Rewrite an npm `import`-form snippet to the no-build IIFE form: every export is
+ * `window.glissade.<name>`, so `import { Rect, timeline } from '@glissade/scene'`
+ * becomes `const { Rect, timeline } = window.glissade`. The body is unchanged, so
+ * the snippet runs verbatim in a no-build `<script src>` page (§0.24 follow-up,
+ * card 7eC7Pb4wTbHj). Derived from the single npm-form source — no duplicate to
+ * maintain.
+ */
+declare function toIifeForm(code: string): string;
+/** Group the corpus by describe-key → the surfaced code snippets. `iife: true`
+ *  rewrites each snippet to the no-build `window.glissade` form. */
+declare function examplesByKey(opts?: {
+  iife?: boolean;
+}): {
   readonly [key: string]: readonly string[];
 };
 //#endregion
-export { ApiExample, EXAMPLES, examplesByKey };
+export { ApiExample, EXAMPLES, examplesByKey, toIifeForm };

package/dist/examples.js

@@ -206,12 +206,24 @@ const EXAMPLES = [
 		run: () => void motionPath(pathFromSvg("M0 0 C50 0 50 100 100 100")).atProgress(.5)
 	}
 ];
-/** Group the corpus by describe-key → the surfaced code snippets. */
-function examplesByKey() {
+/**
+* Rewrite an npm `import`-form snippet to the no-build IIFE form: every export is
+* `window.glissade.<name>`, so `import { Rect, timeline } from '@glissade/scene'`
+* becomes `const { Rect, timeline } = window.glissade`. The body is unchanged, so
+* the snippet runs verbatim in a no-build `<script src>` page (§0.24 follow-up,
+* card 7eC7Pb4wTbHj). Derived from the single npm-form source — no duplicate to
+* maintain.
+*/
+function toIifeForm(code) {
+	return code.replace(/import\s+\{([^}]*)\}\s+from\s+'[^']*';?/g, (_m, names) => `const {${names}} = window.glissade;`);
+}
+/** Group the corpus by describe-key → the surfaced code snippets. `iife: true`
+*  rewrites each snippet to the no-build `window.glissade` form. */
+function examplesByKey(opts = {}) {
 	const byKey = {};
-	for (const ex of EXAMPLES) (byKey[ex.key] ??= []).push(ex.code);
+	for (const ex of EXAMPLES) (byKey[ex.key] ??= []).push(opts.iife ? toIifeForm(ex.code) : ex.code);
 	return byKey;
 }
 registerExamples(examplesByKey());
 //#endregion
-export { EXAMPLES, examplesByKey };
+export { EXAMPLES, examplesByKey, toIifeForm };

package/dist/grid.d.ts

@@ -40,6 +40,15 @@ interface GridProps extends NodeProps {
    * (v1 is position-only, so the grid does not measure child heights.)
    */
   cellHeight?: number;
+  /**
+   * Stretch each child to fill its cell (0.25): sets the child's `width` to its
+   * resolved column-track width and, when `cellHeight` is given, its `height` to
+   * `cellHeight` — a plain `signal.set`, so a later explicit bind still wins.
+   * Only children that expose a settable `width`/`height` signal (Rect/Image) are
+   * sized; others (Circle/Text/Path) keep their own size and are just positioned.
+   * Default false (position-only, byte-identical to v1).
+   */
+  stretch?: boolean;
 }
 /**
  * Lay `children` out into a column grid and return a `Group` holding them, each

package/dist/grid.js

@@ -36,7 +36,8 @@ function resolveColumns(spec, columnGap, totalWidth) {
 	}
 	return {
 		centers,
-		width
+		width,
+		widths
 	};
 }
 /**
@@ -50,11 +51,11 @@ function resolveColumns(spec, columnGap, totalWidth) {
 * rebinds it). Pass freshly constructed nodes for a clean, deterministic layout.
 */
 function Grid(props) {
-	const { columns, gap = 0, columnGap, rowGap, width, cellHeight } = props;
+	const { columns, gap = 0, columnGap, rowGap, width, cellHeight, stretch = false } = props;
 	const children = props.children ?? [];
 	const colGap = columnGap ?? gap;
 	const rowGapPx = rowGap ?? gap;
-	const { centers, width: gridWidth } = resolveColumns(columns, colGap, width);
+	const { centers, width: gridWidth, widths: colWidths } = resolveColumns(columns, colGap, width);
 	const cols = centers.length;
 	const rows = Math.ceil(children.length / cols);
 	if (rows > 1 && cellHeight === void 0) throw new GridError("Grid spanning more than one row needs `cellHeight` (the row pitch) — v1 is position-only and does not measure child heights");
@@ -68,15 +69,25 @@ function Grid(props) {
 		const cx = ox + centers[col];
 		const cy = oy + row * rowPitch + (cellHeight ?? 0) / 2;
 		child.position.set([cx, cy]);
+		if (stretch) {
+			setDim(child, "width", colWidths[col]);
+			if (cellHeight !== void 0) setDim(child, "height", cellHeight);
+		}
 	});
 	return new Group({
 		children,
 		...stripGridOnly(props)
 	});
 }
+/** Set a child's `width`/`height` signal IF it exposes one (Rect/Image do;
+*  Circle/Text/Path don't) — a plain `.set`, so a later explicit bind still wins. */
+function setDim(child, prop, value) {
+	const sig = child[prop];
+	if (sig != null && typeof sig.set === "function") sig.set(value);
+}
 /** Strip Grid's own props so the rest (id/position/opacity/…) pass to the Group. */
 function stripGridOnly(props) {
-	const { columns, children, gap, columnGap, rowGap, width, cellHeight, ...nodeProps } = props;
+	const { columns, children, gap, columnGap, rowGap, width, cellHeight, stretch, ...nodeProps } = props;
 	return nodeProps;
 }
 //#endregion

package/dist/scene.js

@@ -71,6 +71,7 @@ function constructionPropMessage(nodes, target) {
 		if (!node) continue;
 		const prop = target.slice(slash + 1);
 		if (isConstructionProp(node.describeType, prop)) return `'${target}' is a construction prop (animatable:false) — set it at construction (new ${node.describeType}({ ${prop} })); it is not an animatable target.`;
+		if (/^fill\.points\./.test(prop)) return `'${target}' does not resolve — a mesh Paint has no per-point sub-path targets. Animate the WHOLE fill as a paint track: track('${target.slice(0, slash)}/fill', 'paint', [key(0, meshA), key(1, meshB)]) — two same-point-count meshes interpolate their points pairwise (pos + color).`;
 		return;
 	}
 }

package/package.json

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