@glissade/scene 0.29.0 → 0.30.0-pre.0

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.29.0";
+const RAW_VERSION = "0.30.0-pre.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) {
@@ -345,6 +345,12 @@ const HELPERS = [
 		import: "@glissade/scene",
 		usage: "echo(child: Node, opts?: { id?, count?: number, spacing?: number, decay?: number }): Echo"
 	},
+	{
+		name: "motionBlur",
+		summary: "Real sampled motion blur: wrap a child so it renders at N sub-frame times across a shutter interval (centered on the frame) and AVERAGES them — tracks every animated prop, not a faked directional blur. A pure multi-time re-eval (playhead re-addressed per sample, running-mean opacity, restored), byte-exact on Skia; browser↔Skia is perceptual-tier for blur.",
+		import: "@glissade/scene",
+		usage: "motionBlur(child: Node, opts?: { id?, shutter?: number, samples?: number }): MotionBlur"
+	},
 	{
 		name: "clip",
 		summary: "A reusable, target-agnostic motion captured once as a relative-time key schedule, then applied to a node at a wall-clock start time. Build-time sugar: clip.apply() compiles to ordinary Track[].",

package/dist/examples.js

@@ -5,7 +5,7 @@ import { Grid } from "./grid.js";
 import { Stack } from "./layoutCtors.js";
 import { splitText } from "./type.js";
 import { i as orientToPath, r as lookAt, s as motionPath } from "./orient.js";
-import { n as echo } from "./echo.js";
+import { i as echo, n as motionBlur } from "./motionBlur.js";
 import { pathFromSvg } from "./path.js";
 import { key, retime, timeline, track } from "@glissade/core";
 //#region src/examples.ts
@@ -257,6 +257,18 @@ const EXAMPLES = [
 			spacing: .05,
 			decay: .7
 		})
+	},
+	{
+		key: "motionBlur",
+		code: "import { Circle, motionBlur } from '@glissade/scene';\n// real sampled motion blur: renders the child at N sub-frame times across `shutter` (seconds) and averages them.\n// Wrap the MOVING content; its background stays crisp. Byte-exact on Skia, perceptual browser↔Skia.\nconst dot = new Circle({ id: 'dot', radius: 16, fill: '#ffcf3f' });\nconst blurred = motionBlur(dot, { shutter: 0.06, samples: 16 });",
+		run: () => void motionBlur(new Circle({
+			id: "dot",
+			radius: 16,
+			fill: "#ffcf3f"
+		}), {
+			shutter: .06,
+			samples: 16
+		})
 	}
 ];
 /**

package/dist/index.d.ts

@@ -445,6 +445,25 @@ declare class Echo extends Group {
  * A convenience wrapper: pass the trailing content as children of the returned Echo. */
 declare function echo(child: Node, props?: Omit<EchoProps, 'children'>): Echo;
 //#endregion
+//#region src/motionBlur.d.ts
+interface MotionBlurProps extends NodeProps {
+  children?: Node[];
+  /** the shutter interval in SECONDS, centered on the frame time (0 = no blur); default 0.04. */
+  shutter?: number;
+  /** number of sub-frame samples averaged across the shutter (≥ 1); default 8. */
+  samples?: number;
+}
+declare class MotionBlur extends Group {
+  get describeType(): string;
+  readonly shutter: number;
+  readonly samples: number;
+  constructor(props?: MotionBlurProps);
+  protected draw(out: DisplayListBuilder, ctx: EvalContext): void;
+}
+/** `children: [motionBlur(fastDot, { shutter: 0.05 })]` — fastDot smears with real
+ * sub-frame motion blur. Wrap the moving content; its background stays crisp. */
+declare function motionBlur(child: Node, props?: Omit<MotionBlurProps, 'children'>): MotionBlur;
+//#endregion
 //#region src/raster2d.d.ts
 /** A backend gradient handle (DOM CanvasGradient and @napi-rs CanvasGradient both satisfy it). */
 interface CanvasGradientLike {
@@ -691,4 +710,4 @@ declare function meshRasterSize(bw: number, bh: number): {
   h: number;
 };
 //#endregion
-export { ALL_FILTER_KINDS, type AnchorSpec, type BackendCaps, type BindablePropTarget, type BlendMode, type Bounds, type CanvasLike, Circle, ColdAssetError, type Ctx2DLike, Custom, DeterminismViolationError, type DisplayList, type DisplayListBuilder, type DrawCommand, type DrawOnEachOptions, type DrawOnOptions, DuplicateNodeIdError, type EachBox, type EachContext, type EachDistribute, EachError, type EachLayout, type EachMotion, type EachOpts, type EachResult, Echo, type EchoProps, type EditMark, type EvalContext, type FilterKind, type FilterSpec, FilterValidationError, type FontByteLoader, type FontSpec, type GraphemeBox, Group, type GuardMode, type HachureSpec, Highlight, type HighlightProps, type HitArea, IDENTITY, ImageNode as Image, ImageNode, type ImageDataLike, type ImageHandle, type ImageProps, type LayerCacheEntry, type LayerStore, type LayoutBox, type LayoutChildSpec, type LayoutContainerSpec, type LayoutEngine, LayoutEngineMissingError, type LineBox, MEASURE_QUANTUM_PX, MESH_DOWNSCALE, MESH_SHEPARD_POWER, MESH_SIGMA, type Mat2x3, type MeshInterpolation, type MeshPaint, type MeshPoint, NODE_TAXONOMY, Node, NodeConstructionError, type NodeProps, type NodeTypeName, type Paint, Path, type PathLike, type PathProps, type PathSeg, type Place, type Polyline, type PropInit, Raster2D, type Raster2DHost, Rect, type Rect$1 as RectShape, type RenderBackend, ReservedNodeIdError, type ResolvedSketch, type Resource, type ResourceId, type RevealMark, type Scene, type SceneInit, type SceneModule, type ShaderCaps, ShaderEffect, type ShaderEffectProps, type ShaderRef, type ShapeProps, type SketchStyle, SketchValidationError, type StepMark, type StrokeStyle, Text, TextCursor, type TextCursorProps, type TextMeasurer, type TextMetricsLite, type TextProps, type TypeEdit, type TypewriterResult, type ValidateSceneFontsOptions, Video, type VideoFrameSource, type VideoProps, type WordBox, type WrappedTextMetrics, __resetEstimateWarnings, applyToPoint, arcLength, assertFiniteFontSize, bindScene, breakLines, coercePathData, collapseReplacer, collectLocalizedTextUsages, collectTextUsages, createDisplayListBuilder, createScene, drawOn, drawOnEach, each, echo, estimatingMeasurer, evaluate, filtersToCanvasFilter, flatten, fontString, fromTRS, getLayoutEngine, glow, hachureLines, highlight, invert, isEstimatingMeasurer, matEquals, measureWrappedText, meshRasterSize, multiply, pathFromSegs, quantize, rasterizeMesh, requireLayoutEngine, resolveAnchor, resolveSketch, revealSchedule, roughen, roundedRectSegs, segmentGraphemes, segmentWords, setDefaultMeasurer, setLayoutEngine, sketchStrokes, textCursor, typewriter, validateFilters, validateHachure, validateSceneFonts, validateSketch, withDeterminismGuards };
+export { ALL_FILTER_KINDS, type AnchorSpec, type BackendCaps, type BindablePropTarget, type BlendMode, type Bounds, type CanvasLike, Circle, ColdAssetError, type Ctx2DLike, Custom, DeterminismViolationError, type DisplayList, type DisplayListBuilder, type DrawCommand, type DrawOnEachOptions, type DrawOnOptions, DuplicateNodeIdError, type EachBox, type EachContext, type EachDistribute, EachError, type EachLayout, type EachMotion, type EachOpts, type EachResult, Echo, type EchoProps, type EditMark, type EvalContext, type FilterKind, type FilterSpec, FilterValidationError, type FontByteLoader, type FontSpec, type GraphemeBox, Group, type GuardMode, type HachureSpec, Highlight, type HighlightProps, type HitArea, IDENTITY, ImageNode as Image, ImageNode, type ImageDataLike, type ImageHandle, type ImageProps, type LayerCacheEntry, type LayerStore, type LayoutBox, type LayoutChildSpec, type LayoutContainerSpec, type LayoutEngine, LayoutEngineMissingError, type LineBox, MEASURE_QUANTUM_PX, MESH_DOWNSCALE, MESH_SHEPARD_POWER, MESH_SIGMA, type Mat2x3, type MeshInterpolation, type MeshPaint, type MeshPoint, MotionBlur, type MotionBlurProps, NODE_TAXONOMY, Node, NodeConstructionError, type NodeProps, type NodeTypeName, type Paint, Path, type PathLike, type PathProps, type PathSeg, type Place, type Polyline, type PropInit, Raster2D, type Raster2DHost, Rect, type Rect$1 as RectShape, type RenderBackend, ReservedNodeIdError, type ResolvedSketch, type Resource, type ResourceId, type RevealMark, type Scene, type SceneInit, type SceneModule, type ShaderCaps, ShaderEffect, type ShaderEffectProps, type ShaderRef, type ShapeProps, type SketchStyle, SketchValidationError, type StepMark, type StrokeStyle, Text, TextCursor, type TextCursorProps, type TextMeasurer, type TextMetricsLite, type TextProps, type TypeEdit, type TypewriterResult, type ValidateSceneFontsOptions, Video, type VideoFrameSource, type VideoProps, type WordBox, type WrappedTextMetrics, __resetEstimateWarnings, applyToPoint, arcLength, assertFiniteFontSize, bindScene, breakLines, coercePathData, collapseReplacer, collectLocalizedTextUsages, collectTextUsages, createDisplayListBuilder, createScene, drawOn, drawOnEach, each, echo, estimatingMeasurer, evaluate, filtersToCanvasFilter, flatten, fontString, fromTRS, getLayoutEngine, glow, hachureLines, highlight, invert, isEstimatingMeasurer, matEquals, measureWrappedText, meshRasterSize, motionBlur, multiply, pathFromSegs, quantize, rasterizeMesh, requireLayoutEngine, resolveAnchor, resolveSketch, revealSchedule, roughen, roundedRectSegs, segmentGraphemes, segmentWords, setDefaultMeasurer, setLayoutEngine, sketchStrokes, textCursor, typewriter, validateFilters, validateHachure, validateSceneFonts, validateSketch, withDeterminismGuards };

package/dist/index.js

@@ -1,7 +1,7 @@
 import { $ as multiply, A as setDefaultMeasurer, B as validateHachure, C as estimatingMeasurer, D as quantize, E as measureWrappedText, F as hachureLines, G as glow, H as FilterValidationError, I as hashStr, J as IDENTITY, K as validateFilters, L as resolveSketch, M as SketchValidationError, N as arcLength, O as segmentGraphemes, P as flatten, Q as matEquals, R as roughen, S as breakLines, T as isEstimatingMeasurer, U as createDisplayListBuilder, V as validateSketch, W as filtersToCanvasFilter, X as fromTRS, Y as applyToPoint, Z as invert, a as Path, b as __resetEstimateWarnings, c as Video, d as revealSchedule, f as roundedRectSegs, h as resolveAnchor, i as ImageNode, k as segmentWords, l as coercePathData, m as NodeConstructionError, n as Custom, o as Rect, p as Node, q as collapseReplacer, r as Group, s as Text, t as Circle, u as pathFromSegs, x as assertFiniteFontSize, y as MEASURE_QUANTUM_PX, z as sketchStrokes } from "./nodes.js";
 import { a as evaluate, i as createScene, n as ReservedNodeIdError, r as bindScene, t as DuplicateNodeIdError } from "./scene.js";
 import { i as setLayoutEngine, n as getLayoutEngine, r as requireLayoutEngine, t as LayoutEngineMissingError } from "./layoutEngine.js";
-import { n as echo, t as Echo } from "./echo.js";
+import { i as echo, n as motionBlur, r as Echo, t as MotionBlur } from "./motionBlur.js";
 import { buildFontRegistry, emitDevWarning, key, lerpColor, oklabToRgba, parseCmap, parseColor, random, rgbaToOklab, signal, stagger, track, validateFonts } from "@glissade/core";
 //#region src/taxonomy.ts
 /**
@@ -1396,4 +1396,4 @@ var Raster2D = class {
 	}
 };
 //#endregion
-export { ALL_FILTER_KINDS, Circle, ColdAssetError, Custom, DeterminismViolationError, DuplicateNodeIdError, EachError, Echo, FilterValidationError, Group, Highlight, IDENTITY, ImageNode as Image, ImageNode, LayoutEngineMissingError, MEASURE_QUANTUM_PX, MESH_DOWNSCALE, MESH_SHEPARD_POWER, MESH_SIGMA, NODE_TAXONOMY, Node, NodeConstructionError, Path, Raster2D, Rect, ReservedNodeIdError, ShaderEffect, SketchValidationError, Text, TextCursor, Video, __resetEstimateWarnings, applyToPoint, arcLength, assertFiniteFontSize, bindScene, breakLines, coercePathData, collapseReplacer, collectLocalizedTextUsages, collectTextUsages, createDisplayListBuilder, createScene, drawOn, drawOnEach, each, echo, estimatingMeasurer, evaluate, filtersToCanvasFilter, flatten, fontString, fromTRS, getLayoutEngine, glow, hachureLines, highlight, invert, isEstimatingMeasurer, matEquals, measureWrappedText, meshRasterSize, multiply, pathFromSegs, quantize, rasterizeMesh, requireLayoutEngine, resolveAnchor, resolveSketch, revealSchedule, roughen, roundedRectSegs, segmentGraphemes, segmentWords, setDefaultMeasurer, setLayoutEngine, sketchStrokes, textCursor, typewriter, validateFilters, validateHachure, validateSceneFonts, validateSketch, withDeterminismGuards };
+export { ALL_FILTER_KINDS, Circle, ColdAssetError, Custom, DeterminismViolationError, DuplicateNodeIdError, EachError, Echo, FilterValidationError, Group, Highlight, IDENTITY, ImageNode as Image, ImageNode, LayoutEngineMissingError, MEASURE_QUANTUM_PX, MESH_DOWNSCALE, MESH_SHEPARD_POWER, MESH_SIGMA, MotionBlur, NODE_TAXONOMY, Node, NodeConstructionError, Path, Raster2D, Rect, ReservedNodeIdError, ShaderEffect, SketchValidationError, Text, TextCursor, Video, __resetEstimateWarnings, applyToPoint, arcLength, assertFiniteFontSize, bindScene, breakLines, coercePathData, collapseReplacer, collectLocalizedTextUsages, collectTextUsages, createDisplayListBuilder, createScene, drawOn, drawOnEach, each, echo, estimatingMeasurer, evaluate, filtersToCanvasFilter, flatten, fontString, fromTRS, getLayoutEngine, glow, hachureLines, highlight, invert, isEstimatingMeasurer, matEquals, measureWrappedText, meshRasterSize, motionBlur, multiply, pathFromSegs, quantize, rasterizeMesh, requireLayoutEngine, resolveAnchor, resolveSketch, revealSchedule, roughen, roundedRectSegs, segmentGraphemes, segmentWords, setDefaultMeasurer, setLayoutEngine, sketchStrokes, textCursor, typewriter, validateFilters, validateHachure, validateSceneFonts, validateSketch, withDeterminismGuards };

package/dist/{echo.js → motionBlur.js}

@@ -75,4 +75,77 @@ function echo(child, props = {}) {
 	});
 }
 //#endregion
-export { echo as n, Echo as t };
+//#region src/motionBlur.ts
+/**
+* MotionBlur (0.30): real sampled motion blur — the flagship motion-craft feature.
+* It renders its subtree at N sub-frame times across a shutter interval centered on
+* the current frame and AVERAGES them, so a fast-moving element smears exactly the
+* way an analog shutter captures it — and it tracks EVERY animated prop (position,
+* rotation, scale, path progress, colour), not a faked directional blur.
+*
+* Like `Echo`, it re-addresses the scene playhead within one frame (wrapped in
+* `batch()`, restored after) to sample sub-frame times. The averaging is a running
+* mean done with plain compositing, NO backend change: paint the k-th sample (of N)
+* at opacity 1/(k+1). Over source-over that is the exact equal-weight mean —
+*   L₀=∅; Lₖ₊₁ = Lₖ·(k/(k+1)) + sₖ·(1/(k+1)) = mean(s₀…sₖ)
+* — so all N samples contribute equally (unlike a decaying trail). Each sub-frame t
+* is a pure function of the current time, so evaluate() stays deterministic and the
+* result is byte-stable on Skia (the golden twin); browser↔Skia is perceptual-tier
+* for blur, marked in describe().
+*
+* Ships on the base scene index alongside Echo/ShaderEffect (off the closed 9-node
+* taxonomy). No blur ⇒ pass `samples: 1` or `shutter: 0` and it's a plain group.
+*/
+var MotionBlur = class extends Group {
+	get describeType() {
+		return "MotionBlur";
+	}
+	shutter;
+	samples;
+	constructor(props = {}) {
+		super(props);
+		this.shutter = props.shutter ?? .04;
+		this.samples = Math.max(1, Math.floor(props.samples ?? 8));
+	}
+	draw(out, ctx) {
+		const playhead = ctx.playhead;
+		if (this.samples <= 1 || this.shutter === 0 || playhead === void 0) {
+			super.draw(out, ctx);
+			return;
+		}
+		const now = ctx.time;
+		const n = this.samples;
+		batch(() => {
+			try {
+				for (let i = 0; i < n; i++) {
+					const t = now + (i / (n - 1) - .5) * this.shutter;
+					const opacity = 1 / (i + 1);
+					playhead.forceSet(t);
+					out.push({
+						op: "pushGroup",
+						opacity,
+						blend: "source-over",
+						filters: []
+					});
+					super.draw(out, {
+						...ctx,
+						time: t
+					});
+					out.push({ op: "popGroup" });
+				}
+			} finally {
+				playhead.forceSet(now);
+			}
+		});
+	}
+};
+/** `children: [motionBlur(fastDot, { shutter: 0.05 })]` — fastDot smears with real
+* sub-frame motion blur. Wrap the moving content; its background stays crisp. */
+function motionBlur(child, props = {}) {
+	return new MotionBlur({
+		...props,
+		children: [child]
+	});
+}
+//#endregion
+export { echo as i, motionBlur as n, Echo as r, MotionBlur as t };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glissade/scene",
-  "version": "0.29.0",
+  "version": "0.30.0-pre.0",
   "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.29.0"
+    "@glissade/core": "0.30.0-pre.0"
   },
   "repository": {
     "type": "git",