@glissade/scene 0.7.0 → 0.8.0-pre.0

package/dist/index.d.ts

@@ -225,6 +225,70 @@ interface CacheColdResult {
  */
 declare function auditCacheCold(createScene: () => Scene, doc: Timeline, t: number): CacheColdResult;
 //#endregion
+//#region src/assets.d.ts
+/**
+ * Asset contracts (DESIGN.md §3.8): evaluate() never awaits — callers warm
+ * sources first (§2.5 readiness precondition), then emission is pure. The
+ * VideoFrameSource seam isolates decoder differences (WebCodecs vs FFmpeg);
+ * backends resolve asset ids to their own bitmap types.
+ */
+interface VideoFrameSource {
+  /** Source duration in seconds. */
+  readonly duration: number;
+  /** Frames per second of the source grid (mediaT quantization). */
+  readonly fps: number;
+  /**
+   * Ensure getFrameSync can serve [fromT, toT] (seconds, media time).
+   * O(GOP) for backward/random seeks; a readiness latency, never state.
+   */
+  warm(fromT: number, toT: number): Promise<void>;
+  /**
+   * The decoded frame for the source-grid frame containing mediaT.
+   * Precondition: warmed. The return is backend-consumable (VideoFrame,
+   * ImageBitmap, HTMLCanvasElement, or a node Image) — opaque here.
+   */
+  getFrameSync(mediaT: number): unknown;
+  close(): void;
+}
+/** A decoded still image — opaque to scene/core, consumed by backends. */
+type ImageHandle = unknown;
+declare class ColdAssetError extends Error {
+  readonly assetId: string;
+  readonly detail: string;
+  /** Media time that was requested cold, when known — drives demand warming. */
+  readonly mediaT: number | undefined;
+  constructor(assetId: string, detail: string, mediaT?: number);
+}
+//#endregion
+//#region src/renderBackend.d.ts
+/** A filter kind the document layer can emit (mirrors `FilterSpec['kind']`). */
+type FilterKind = FilterSpec['kind'];
+/** Every filter kind the shared Raster2D interpreter rasterizes (§3.4). */
+declare const ALL_FILTER_KINDS: ReadonlySet<FilterKind>;
+/** What a backend can do — queried, never assumed (§3.4 capability negotiation). */
+interface BackendCaps {
+  /** Filter kinds this backend rasterizes. */
+  readonly filters: ReadonlySet<FilterKind>;
+  /** Can it run a ShaderEffect pass (WebGPU)? Headless Skia: false. */
+  readonly shaders: boolean;
+  /** Largest texture/canvas dimension it will allocate. */
+  readonly maxTextureSize: number;
+}
+interface RenderBackend extends TextMeasurer {
+  readonly caps: BackendCaps;
+  render(list: DisplayList): void;
+  readPixels(): Promise<Uint8ClampedArray>;
+  /**
+   * Browser zero-copy encode path (§3.4): a decoded frame for VideoEncoder.
+   * Absent on headless backends. Typed `unknown` because `VideoFrame` is a DOM
+   * type and `@glissade/scene` carries no DOM lib — browser backends cast.
+   */
+  toVideoFrame?(timestampUs: number): unknown;
+  setImageAsset(assetId: string, image: unknown): void;
+  setVideoAsset(assetId: string, source: VideoFrameSource): void;
+  dispose(): void;
+}
+//#endregion
 //#region src/motionPath.d.ts
 /** An arc-length-parameterized sampler over a path. */
 interface PathSampler {
@@ -332,41 +396,6 @@ declare class TokenHighlight extends Node {
  */
 declare function tokenHighlight(text: Text, props: Omit<TokenHighlightProps, 'text'>): TokenHighlight;
 //#endregion
-//#region src/assets.d.ts
-/**
- * Asset contracts (DESIGN.md §3.8): evaluate() never awaits — callers warm
- * sources first (§2.5 readiness precondition), then emission is pure. The
- * VideoFrameSource seam isolates decoder differences (WebCodecs vs FFmpeg);
- * backends resolve asset ids to their own bitmap types.
- */
-interface VideoFrameSource {
-  /** Source duration in seconds. */
-  readonly duration: number;
-  /** Frames per second of the source grid (mediaT quantization). */
-  readonly fps: number;
-  /**
-   * Ensure getFrameSync can serve [fromT, toT] (seconds, media time).
-   * O(GOP) for backward/random seeks; a readiness latency, never state.
-   */
-  warm(fromT: number, toT: number): Promise<void>;
-  /**
-   * The decoded frame for the source-grid frame containing mediaT.
-   * Precondition: warmed. The return is backend-consumable (VideoFrame,
-   * ImageBitmap, HTMLCanvasElement, or a node Image) — opaque here.
-   */
-  getFrameSync(mediaT: number): unknown;
-  close(): void;
-}
-/** A decoded still image — opaque to scene/core, consumed by backends. */
-type ImageHandle = unknown;
-declare class ColdAssetError extends Error {
-  readonly assetId: string;
-  readonly detail: string;
-  /** Media time that was requested cold, when known — drives demand warming. */
-  readonly mediaT: number | undefined;
-  constructor(assetId: string, detail: string, mediaT?: number);
-}
-//#endregion
 //#region src/shaderEffect.d.ts
 interface ShaderEffectProps extends NodeProps {
   children?: Node[];
@@ -474,4 +503,4 @@ declare class Raster2D<TCanvas extends CanvasLike, TPath extends PathLike, TDraw
   render(target: TCanvas, list: DisplayList): void;
 }
 //#endregion
-export { type AnchorSpec, type BindablePropTarget, type BlendMode, type CacheColdResult, type CanvasLike, Circle, ColdAssetError, type Ctx2DLike, DeterminismViolationError, type DisplayList, type DisplayListBuilder, type DrawCommand, type DrawOnEachOptions, type DrawOnOptions, DuplicateNodeIdError, type EditMark, type EvalContext, type FilterSpec, FilterValidationError, FollowPath, type FollowPathProps, type FontSpec, Group, type GuardMode, type HachureSpec, Highlight, type HighlightProps, type HitArea, IDENTITY, type ImageHandle, ImageNode, type ImageProps, type LayoutBox, type LayoutChildSpec, type LayoutContainerSpec, type LayoutEngine, LayoutEngineMissingError, type LineBox, type Mat2x3, Node, type NodeProps, type Paint, Path, type PathLike, type PathProps, type PathSampler, type PathSeg, type Polyline, type PropInit, Raster2D, type Raster2DHost, Rect, type Rect$1 as RectShape, 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, TokenHighlight, type TokenHighlightProps, TokenMatchError, type TokenRange, type TypeEdit, type TypewriterResult, Video, type VideoFrameSource, type VideoProps, type WordBox, applyToPoint, arcLength, auditCacheCold, bindScene, breakLines, createDisplayListBuilder, createScene, drawOn, drawOnEach, estimatingMeasurer, evaluate, filtersToCanvasFilter, flatten, followPath, fontString, fromTRS, getLayoutEngine, glow, hachureLines, highlight, invert, matEquals, matchTokenRun, motionPath, multiply, pathFromSegs, pathLength, pointAtLength, quantize, requireLayoutEngine, resolveAnchor, resolveSketch, revealSchedule, roughen, roundedRectSegs, segmentGraphemes, segmentWords, setDefaultMeasurer, setLayoutEngine, sketchStrokes, textCursor, tokenHighlight, typewriter, validateFilters, validateHachure, validateSketch, withDeterminismGuards };
+export { ALL_FILTER_KINDS, type AnchorSpec, type BackendCaps, type BindablePropTarget, type BlendMode, type CacheColdResult, type CanvasLike, Circle, ColdAssetError, type Ctx2DLike, DeterminismViolationError, type DisplayList, type DisplayListBuilder, type DrawCommand, type DrawOnEachOptions, type DrawOnOptions, DuplicateNodeIdError, type EditMark, type EvalContext, type FilterKind, type FilterSpec, FilterValidationError, FollowPath, type FollowPathProps, type FontSpec, Group, type GuardMode, type HachureSpec, Highlight, type HighlightProps, type HitArea, IDENTITY, type ImageHandle, ImageNode, type ImageProps, type LayoutBox, type LayoutChildSpec, type LayoutContainerSpec, type LayoutEngine, LayoutEngineMissingError, type LineBox, type Mat2x3, Node, type NodeProps, type Paint, Path, type PathLike, type PathProps, type PathSampler, type PathSeg, type Polyline, type PropInit, Raster2D, type Raster2DHost, Rect, type Rect$1 as RectShape, type RenderBackend, 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, TokenHighlight, type TokenHighlightProps, TokenMatchError, type TokenRange, type TypeEdit, type TypewriterResult, Video, type VideoFrameSource, type VideoProps, type WordBox, applyToPoint, arcLength, auditCacheCold, bindScene, breakLines, createDisplayListBuilder, createScene, drawOn, drawOnEach, estimatingMeasurer, evaluate, filtersToCanvasFilter, flatten, followPath, fontString, fromTRS, getLayoutEngine, glow, hachureLines, highlight, invert, matEquals, matchTokenRun, motionPath, multiply, pathFromSegs, pathLength, pointAtLength, quantize, requireLayoutEngine, resolveAnchor, resolveSketch, revealSchedule, roughen, roundedRectSegs, segmentGraphemes, segmentWords, setDefaultMeasurer, setLayoutEngine, sketchStrokes, textCursor, tokenHighlight, typewriter, validateFilters, validateHachure, validateSketch, withDeterminismGuards };

package/dist/index.js

@@ -482,6 +482,16 @@ function auditCacheCold(createScene, doc, t) {
 	};
 }
 //#endregion
+//#region src/renderBackend.ts
+/** Every filter kind the shared Raster2D interpreter rasterizes (§3.4). */
+const ALL_FILTER_KINDS = new Set([
+	"blur",
+	"drop-shadow",
+	"brightness",
+	"contrast",
+	"saturate"
+]);
+//#endregion
 //#region src/motionPath.ts
 /**
 * Motion along a path: sample a point (and tangent) at an arc-length position on
@@ -1244,4 +1254,4 @@ var Raster2D = class {
 	}
 };
 //#endregion
-export { Circle, ColdAssetError, DeterminismViolationError, DuplicateNodeIdError, FilterValidationError, FollowPath, Group, Highlight, IDENTITY, ImageNode, LayoutEngineMissingError, Node, Path, Raster2D, Rect, ShaderEffect, SketchValidationError, Text, TextCursor, TokenHighlight, TokenMatchError, Video, applyToPoint, arcLength, auditCacheCold, bindScene, breakLines, createDisplayListBuilder, createScene, drawOn, drawOnEach, estimatingMeasurer, evaluate, filtersToCanvasFilter, flatten, followPath, fontString, fromTRS, getLayoutEngine, glow, hachureLines, highlight, invert, matEquals, matchTokenRun, motionPath, multiply, pathFromSegs, pathLength, pointAtLength, quantize, requireLayoutEngine, resolveAnchor, resolveSketch, revealSchedule, roughen, roundedRectSegs, segmentGraphemes, segmentWords, setDefaultMeasurer, setLayoutEngine, sketchStrokes, textCursor, tokenHighlight, typewriter, validateFilters, validateHachure, validateSketch, withDeterminismGuards };
+export { ALL_FILTER_KINDS, Circle, ColdAssetError, DeterminismViolationError, DuplicateNodeIdError, FilterValidationError, FollowPath, Group, Highlight, IDENTITY, ImageNode, LayoutEngineMissingError, Node, Path, Raster2D, Rect, ShaderEffect, SketchValidationError, Text, TextCursor, TokenHighlight, TokenMatchError, Video, applyToPoint, arcLength, auditCacheCold, bindScene, breakLines, createDisplayListBuilder, createScene, drawOn, drawOnEach, estimatingMeasurer, evaluate, filtersToCanvasFilter, flatten, followPath, fontString, fromTRS, getLayoutEngine, glow, hachureLines, highlight, invert, matEquals, matchTokenRun, motionPath, multiply, pathFromSegs, pathLength, pointAtLength, quantize, requireLayoutEngine, resolveAnchor, resolveSketch, revealSchedule, roughen, roundedRectSegs, segmentGraphemes, segmentWords, setDefaultMeasurer, setLayoutEngine, sketchStrokes, textCursor, tokenHighlight, typewriter, validateFilters, validateHachure, validateSketch, withDeterminismGuards };

package/dist/layoutEngine.d.ts

@@ -113,6 +113,8 @@ interface ShaderRef {
   wgsl: string;
   /** Scalar uniforms, packed as f32 in SORTED KEY ORDER into the Uniforms struct. */
   uniforms: Record<string, number>;
+  /** Named texture inputs: binding name → image/video asset id (the source canvas is binding 0). Reserved for multi-input passes. */
+  textures?: Record<string, string>;
 }
 type DrawCommand = {
   op: 'save';

package/package.json

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