@neta-art/cohub 8.23.0 → 9.0.0

package/dist/board/animation.d.ts

@@ -1,191 +1,67 @@
-import { BoardCapability, BoardRenderCost } from "../protocol/dist/board-constants.js";
-import { BoardAnimationTarget, BoardComposition, BoardEasing, BoardProceduralClip, BoardTimelineMarker, BoardTrack, BoardTrackInterpolation } from "../protocol/dist/board-composition.js";
-import { BoardAssetRef, BoardEffect } from "../protocol/dist/board-effect.js";
-import { BoardDiagnostic, BoardValidationResult } from "../protocol/dist/board.js";
+import { BoardAnimationHeader, BoardColor, BoardDocument, BoardItem, BoardVec2 } from "../protocol/dist/board-model.js";
+import { BoardValueKind } from "../protocol/dist/board-patch.js";
 import "../protocol/dist/index.js";
 //#region src/board/animation.d.ts
-type CompositionInput = Omit<BoardComposition, "revision"> & {
-  revision?: number;
-};
-type TrackInput = Omit<BoardTrack, "channelVersion" | "metadata"> & {
-  channelVersion?: number;
-  metadata?: Record<string, unknown>;
-};
-type ProceduralClipInput = Omit<BoardProceduralClip, "kindVersion" | "layer" | "fill" | "easing" | "params" | "assetRefs" | "metadata"> & {
-  kindVersion?: number;
-  layer?: BoardProceduralClip["layer"];
-  fill?: BoardProceduralClip["fill"];
-  easing?: BoardEasing;
-  params?: Record<string, unknown>;
-  assetRefs?: BoardAssetRef[];
-  metadata?: Record<string, unknown>;
+type BoardEaseFunction = (progress: number) => number;
+declare function boardEase(ease: string | undefined): BoardEaseFunction;
+declare function boardAnimationTime(header: Pick<BoardAnimationHeader, "duration" | "delay" | "loop" | "end" | "play">, elapsed: number): number | null;
+type Kind = BoardValueKind;
+type CompiledTrack = {
+  id: string;
+  animationId: string;
+  target: string;
+  property: string;
+  path: readonly string[];
+  kind: Kind;
+  multiplicative: boolean;
+  composite: "replace" | "add";
+  spline: boolean;
+  step: boolean;
+  orient: boolean;
+  times: Float64Array;
+  values: readonly unknown[];
+  eases: readonly BoardEaseFunction[];
+  start: number;
 };
-declare function track(input: TrackInput): BoardTrack;
-declare function proceduralClip(input: ProceduralClipInput): BoardProceduralClip;
-declare function composition(input: CompositionInput): BoardComposition;
-declare function compileComposition(input: {
+type CompiledAnimation = {
   id: string;
-  name: string;
-  duration: number;
-  tracks?: TrackInput[];
-  clips?: ProceduralClipInput[];
-  markers?: BoardTimelineMarker[];
-  playback?: BoardComposition["playback"];
-  metadata?: Record<string, unknown>;
-}): BoardComposition;
-type SampledTrack = {
-  target: BoardAnimationTarget;
-  channel: string;
-  value: unknown;
+  header: BoardAnimationHeader;
+  tracks: readonly CompiledTrack[];
+  children: readonly CompiledTrack[];
 };
-declare function sampleEasing(easing: BoardEasing, value: number): number;
-/** Deterministically sample one validated Track without touching scene state. */
-declare function sampleTrack(trackValue: BoardTrack, time: number): SampledTrack | null;
-declare function sampleCompositionTracks(value: BoardComposition, time: number): SampledTrack[];
-type RenderBounds = {
-  x: number;
-  y: number;
-  width: number;
-  height: number;
+type CompiledBoardAnimations = {
+  readonly animations: ReadonlyMap<string, CompiledAnimation>;
+  readonly order: readonly string[];
+  readonly document: BoardDocument;
 };
-type QualityProfile = "low" | "medium" | "high";
-type BoardExtensionDefinition = BoardCapability & {
-  validate?: (params: Record<string, unknown>) => BoardDiagnostic[];
-  getBounds?: (params: Record<string, unknown>) => RenderBounds | null;
-  getAssetRefs?: (params: Record<string, unknown>) => BoardAssetRef[];
-  estimateCost: (params: Record<string, unknown>, profile: QualityProfile) => Partial<BoardRenderCost>;
+declare function compileBoardAnimations(document: BoardDocument): CompiledBoardAnimations;
+type BoardColorResolver = (color: BoardColor) => number | null;
+declare function parseHexColor(color: BoardColor): number | null;
+declare function sampleBoardTrack(track: CompiledTrack, time: number, resolveColor?: BoardColorResolver): unknown;
+type BoardCameraOverride = {
+  focus?: string | {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+  };
+  zoom?: number;
+  center?: BoardVec2;
+  shake?: number;
 };
-type BoardPresetDefinition = BoardCapability & {
-  kind: "preset";
-  compile: (params: Record<string, unknown>) => BoardComposition;
+type BoardEvaluation = {
+  items: ReadonlyMap<string, BoardItem>;
+  camera: BoardCameraOverride;
+  times: ReadonlyMap<string, number>;
 };
-declare const DEFAULT_BOARD_LIMITS: BoardRenderCost;
-declare class BoardExtensionRegistry {
-  #private;
-  constructor();
-  register(definition: BoardExtensionDefinition | BoardPresetDefinition): this;
-  capabilities(): BoardCapability[];
-  compilePreset(id: string, version: number, params: Record<string, unknown>): {
-    id: string;
-    name: string;
-    timeline: {
-      duration: number;
-      tracks: {
-        id: string;
-        target: {
-          type: "item";
-          itemId: string;
-        } | {
-          type: "effect";
-          effectId: string;
-        } | {
-          type: "camera";
-        } | {
-          type: "board";
-        };
-        channel: string;
-        channelVersion: number;
-        interpolation: "linear" | "step";
-        fill: "backwards" | "both" | "forwards" | "none";
-        keyframes: {
-          time: number;
-          value: unknown;
-          easing?: "ease-in-cubic" | "ease-in-out-cubic" | "ease-in-out-quad" | "ease-in-quad" | "ease-out-cubic" | "ease-out-expo" | "ease-out-quad" | "ease-out-quart" | "linear" | undefined;
-        }[];
-        metadata: Record<string, unknown>;
-      }[];
-      clips: {
-        id: string;
-        kind: string;
-        kindVersion: number;
-        target: {
-          type: "item";
-          itemId: string;
-        } | {
-          type: "effect";
-          effectId: string;
-        } | {
-          type: "camera";
-        } | {
-          type: "board";
-        };
-        start: number;
-        duration: number;
-        layer: "behind" | "content" | "front" | "screen";
-        fill: "backwards" | "both" | "forwards" | "none";
-        easing: "ease-in-cubic" | "ease-in-out-cubic" | "ease-in-out-quad" | "ease-in-quad" | "ease-out-cubic" | "ease-out-expo" | "ease-out-quad" | "ease-out-quart" | "linear";
-        params: Record<string, unknown>;
-        assetRefs: {
-          type: "extension" | "space-file";
-          ref: string;
-          digest?: string | undefined;
-        }[];
-        seed: string;
-        metadata: Record<string, unknown>;
-      }[];
-      markers: {
-        id: string;
-        time: number;
-        duration?: number | undefined;
-        metadata: Record<string, unknown>;
-      }[];
-    };
-    playback: {
-      loop: boolean;
-      endBehavior: "hold" | "reset";
-      reducedMotion: {
-        mode: "base";
-      } | {
-        mode: "time";
-        time: number;
-      } | {
-        mode: "marker";
-        markerId: string;
-      };
-    };
-    metadata: Record<string, unknown>;
-    revision: number;
-  };
-  validate(input: {
-    composition: BoardComposition;
-    effects?: Array<Omit<BoardEffect, "boardId" | "revision">>;
-    profile?: QualityProfile;
-    limits?: BoardRenderCost;
-  }): BoardValidationResult;
-}
-declare function createBoardExtensionRegistry(): BoardExtensionRegistry;
-declare const BOARD_CHANNELS: {
-  readonly "transform.translation": {
-    readonly targets: readonly ["item"];
-    readonly value: import("zod").ZodObject<{
-      x: import("zod").ZodNumber;
-      y: import("zod").ZodNumber;
-    }, import("zod/v4/core").$strict>;
-    readonly interpolations: readonly ["linear", "step"];
-    readonly coordinateSpace: "world-offset";
-    readonly unit: "board";
-  };
-  readonly "transform.rotation": {
-    readonly targets: readonly ["item"];
-    readonly value: import("zod").ZodNumber;
-    readonly interpolations: readonly ["linear", "step"];
-    readonly unit: "radian";
-  };
-  readonly "transform.scale": {
-    readonly targets: readonly ["item"];
-    readonly value: import("zod").ZodUnion<readonly [import("zod").ZodNumber, import("zod").ZodObject<{
-      x: import("zod").ZodNumber;
-      y: import("zod").ZodNumber;
-    }, import("zod/v4/core").$strict>]>;
-    readonly interpolations: readonly ["linear", "step"];
-    readonly unit: "ratio";
-  };
-  readonly "style.opacity": {
-    readonly targets: readonly ["item"];
-    readonly value: import("zod").ZodNumber;
-    readonly interpolations: readonly ["linear", "step"];
-    readonly unit: "ratio";
-  };
+type BoardEvaluateOptions = {
+  resolveColor?: BoardColorResolver;
+};
+declare function evaluateBoardAnimations(compiled: CompiledBoardAnimations, times: ReadonlyMap<string, number> | Readonly<Record<string, number>>, options?: BoardEvaluateOptions): BoardEvaluation;
+declare function applyBoardEvaluation(document: BoardDocument, evaluation: BoardEvaluation): BoardDocument;
+declare function boardDocumentAt(document: BoardDocument, animationId: string | null, time: number, options?: BoardEvaluateOptions): {
+  document: BoardDocument;
+  evaluation: BoardEvaluation;
 };
 //#endregion
-export { BOARD_CHANNELS, BoardExtensionDefinition, BoardExtensionRegistry, BoardPresetDefinition, type BoardTrackInterpolation, CompositionInput, DEFAULT_BOARD_LIMITS, ProceduralClipInput, QualityProfile, RenderBounds, SampledTrack, TrackInput, compileComposition, composition, createBoardExtensionRegistry, proceduralClip, sampleCompositionTracks, sampleEasing, sampleTrack, track };
+export { BoardCameraOverride, BoardColorResolver, BoardEaseFunction, BoardEvaluateOptions, BoardEvaluation, CompiledAnimation, CompiledBoardAnimations, CompiledTrack, applyBoardEvaluation, boardAnimationTime, boardDocumentAt, boardEase, compileBoardAnimations, evaluateBoardAnimations, parseHexColor, sampleBoardTrack };