@vizij/runtime-react 0.4.2 → 1.0.0

package/dist/index.d.ts

@@ -1,442 +1,132 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import * as react from 'react';
-import { ReactNode, PropsWithChildren } from 'react';
-import { ValueJSON } from '@vizij/value-json';
-import { IrGraph } from '@vizij/node-graph-authoring';
-import { RawValue, AnimatableValue } from '@vizij/utils';
-import { World, VizijBundleExtension, VizijStarredItem, VizijProps } from '@vizij/render';
+import { ReactNode } from 'react';
+import { VizijOptions, ValueJSON, Runtime, VizijDescription } from '@vizij/runtime';
+import { VizijProps } from '@vizij/render';
 
-/** Value shape hint. Accepted through the public surface, unused by the device. */
-type ShapeJSON = Record<string, unknown>;
-/** Paths a graph reads/writes — metadata for output tracking and seeding. */
-type GraphSubscriptions = {
-    inputs?: string[];
-    outputs?: string[];
-};
-/** A Vizij graph spec handled structurally (nodes/edges arrays of records). */
-type GraphSpecLike = {
-    nodes?: Array<Record<string, unknown>>;
-    edges?: Array<Record<string, unknown>>;
-    metadata?: unknown;
-    [key: string]: unknown;
-};
-/** One graph source composed into the device's behavior. */
-type GraphRegistrationConfig = {
-    id?: string;
-    spec: GraphSpecLike;
-    subs?: GraphSubscriptions;
-};
-/** Per-source merge options. Composition is last-writer-wins today (VIZ-53). */
-type MergeStrategyOptions = Record<string, unknown>;
-/** Player/instance setup carried by animation assets; consumed by the JS clip pipeline. */
-type AnimationSetup = {
-    animation?: unknown;
-    player?: Record<string, unknown>;
-    instance?: Record<string, unknown>;
-};
-type PoseDefinition = {
-    id: string;
-    name?: string;
-    description?: string;
-    group?: string | null;
-    groupId?: string | null;
-    groupIds?: string[];
-    values: Record<string, number | undefined>;
-};
-type PoseBlendMode = "average" | "additive";
-type PoseGroupDefinition = {
-    id: string;
-    name: string;
-    path: string;
-    blendMode?: PoseBlendMode;
-};
-type PoseRigConfig = {
-    version: number;
-    faceId?: string | null;
-    title?: string;
-    description?: string;
-    poseGroups?: PoseGroupDefinition[];
-    crossGroupBlendMode?: PoseBlendMode;
-    neutralInputs: Record<string, number>;
-    poses: PoseDefinition[];
-    metadata?: Record<string, unknown> | {
-        createdAt: string;
-        updatedAt: string;
-        author?: string;
-    };
-};
-type RootBounds = {
-    center: {
-        x: number;
-        y: number;
-    };
-    size: {
-        x: number;
-        y: number;
-    };
-};
-type VizijGlbAsset = {
-    kind: "url";
-    src: string;
-    aggressiveImport?: boolean;
-    rootBounds?: RootBounds;
-} | {
-    kind: "blob";
-    blob: Blob;
-    aggressiveImport?: boolean;
-    rootBounds?: RootBounds;
-} | {
-    kind: "world";
-    world: World | Record<string, unknown>;
-    animatables: Record<string, AnimatableValue> | Record<string, unknown>;
-    bundle?: VizijBundleExtension | null;
-};
-type VizijGraphAsset = {
-    id: string;
-    spec?: GraphRegistrationConfig["spec"];
-    ir?: IrGraph | null;
-    subscriptions?: Partial<GraphSubscriptions>;
-    inputMetadata?: VizijInputMetadata[];
-};
-type VizijInputMetadata = {
-    id?: string;
-    path: string;
-    label?: string;
-    source?: string;
-    root?: string;
-    defaultValue?: number;
-    range?: {
-        min?: number;
-        max?: number;
-    };
-    [key: string]: unknown;
-};
-type AnimationKeyframeLike = {
-    time?: number;
-    value?: number;
-    inTangent?: number | null;
-    outTangent?: number | null;
-    [key: string]: unknown;
-};
-type AnimationTrackLike = {
-    channel: string;
-    keyframes?: AnimationKeyframeLike[];
-    interpolation?: "linear" | "step" | "cubic" | string;
-    [key: string]: unknown;
-};
-type AnimationClipLike = {
-    id?: string;
-    name?: string;
-    duration?: number;
-    tracks?: AnimationTrackLike[];
-    [key: string]: unknown;
-};
-type VizijAnimationAsset = {
-    id: string;
-    clip: AnimationClipLike;
-    setup?: Partial<AnimationSetup>;
-    weight?: number;
-};
-type VizijProgramAsset = {
-    id: string;
-    label?: string;
-    graph: VizijGraphAsset;
-    resetValues?: Record<string, number>;
-    metadata?: Record<string, unknown>;
-};
-type VizijAssetBundle = {
-    namespace?: string;
-    faceId?: string;
-    glb: VizijGlbAsset;
-    rig?: VizijGraphAsset;
-    pose?: {
-        graph?: VizijGraphAsset;
-        config?: PoseRigConfig;
-        stageNeutralFilter?: (id: string, path: string) => boolean;
-    };
-    animations?: VizijAnimationAsset[];
-    programs?: VizijProgramAsset[];
-    /**
-     * Designer-curated set of starred drivers/poses, resolved from the loaded
-     * bundle's `starred` section. References real functionality by stable id
-     * (driver = standard-input id, pose = pose id).
-     */
-    starred?: VizijStarredItem[];
-    initialInputs?: Record<string, ValueJSON>;
-    metadata?: Record<string, unknown>;
-    bundle?: VizijBundleExtension | null;
-};
-type RuntimeError = {
-    message: string;
-    cause?: unknown;
-    phase?: "assets" | "engine" | "registration" | "animation" | "bridge" | "driver" | "unknown";
-    timestamp: number;
-};
-type VizijRuntimeStatus = {
-    loading: boolean;
-    ready: boolean;
-    error: RuntimeError | null;
-    errors: RuntimeError[];
-    namespace: string;
-    faceId?: string;
-    rootId?: string | null;
-    /** Namespaced output signal paths emitted by registered graphs. */
-    outputPaths: string[];
-    /** Approximate current stepping rate in Hz (smoothed). */
-    stepHz?: number;
-    controllers: {
-        graphs: string[];
-        anims: string[];
-    };
-};
-type AnimateValueOptions = {
-    duration?: number;
-    easing?: ((t: number) => number) | "linear" | "easeInOut" | "easeOut" | "easeIn";
-    namespace?: string;
-    coordinate?: "input" | "renderer";
-};
-type PlayAnimationOptions = {
-    weight?: number;
-    speed?: number;
-    reset?: boolean;
-};
-type StopAnimationOptions = {
-    clearOutputs?: boolean;
-};
-type AnimationPlaybackState = {
-    time: number;
-    duration: number;
-    playing: boolean;
-    loop: boolean;
-    speed: number;
-};
-type StopProgramOptions = {
-    resetOutputs?: boolean;
-};
-type ProgramPlaybackState = {
-    state: "playing" | "paused" | "stopped";
-};
-type InputDriverLifecycle = {
-    start: () => void;
-    stop: () => void;
-    dispose: () => void;
-};
-type InputDriverContext = {
-    setInput: (path: string, value: ValueJSON, shape?: ShapeJSON) => void;
-    setRendererValue: (id: string, namespace: string, value: RawValue | ((prev: RawValue | undefined) => RawValue | undefined)) => void;
-    namespace: string;
-    faceId?: string;
-};
-type InputDriverFactory = (ctx: InputDriverContext) => InputDriverLifecycle;
-type RuntimeOutputWrite = {
-    id: string;
-    namespace: string;
-    value: RawValue;
-    currentValue?: RawValue;
-};
-type VizijRuntimeFaceProps = Omit<VizijProps, "rootId" | "namespace"> & {
-    namespaceOverride?: string;
-};
-type VizijRuntimeContextValue = VizijRuntimeStatus & {
-    assetBundle: VizijAssetBundle;
-    setInput: (path: string, value: ValueJSON, shape?: ShapeJSON) => void;
-    /** Current engine-store value of a path (read-your-own-write included). */
-    getValueSnapshot: (path: string) => ValueJSON | undefined;
-    /**
-     * A snapshot of EVERY key currently in the device store, as path → Value in
-     * arora's serde JSON shape (pass-through from the device; not `ValueJSON`).
-     * `undefined` until the device exists. For mirrors/bridges that forward the
-     * whole store (e.g. the standalone's native-store bridge), not for per-path
-     * sampling — use `getValueSnapshot` for that.
-     */
-    getStoreSnapshot: () => Record<string, unknown> | undefined;
-    /**
-     * Notifies with each step's drained store changes (path → Value in arora's
-     * serde JSON shape; `null` for a cleared key). The change-driven counterpart
-     * to `getStoreSnapshot` for store bridges: seed from the snapshot, then stay
-     * current from these. Returns an unsubscribe function.
-     */
-    subscribeToStoreChanges: (listener: (changes: Record<string, unknown>) => void) => () => void;
-    /**
-     * Notifies after each engine step, once the step's store changes have been
-     * applied. Pair with `getValueSnapshot` to sample values step-aligned.
-     * Returns an unsubscribe function.
-     */
-    subscribeToStep: (listener: () => void) => () => void;
-    setGraphBundle: (bundle: RuntimeGraphBundle, options?: {
-        tier?: "auto" | "assets" | "graphs";
-    }) => void;
-    setValue: (id: string, namespace: string, value: RawValue | ((prev: RawValue | undefined) => RawValue | undefined)) => void;
-    stagePoseNeutral: (force?: boolean) => void;
-    animateValue: (path: string, target: ValueJSON, options?: AnimateValueOptions) => Promise<void>;
-    cancelAnimation: (path: string) => void;
-    registerInputDriver: (id: string, factory: InputDriverFactory) => InputDriverLifecycle;
-    playAnimation: (id: string, options?: PlayAnimationOptions) => Promise<void>;
-    pauseAnimation: (id: string) => void;
-    seekAnimation: (id: string, timeSeconds: number) => void;
-    setAnimationLoop: (id: string, enabled: boolean) => void;
-    getAnimationState: (id: string) => AnimationPlaybackState | null;
-    stopAnimation: (id: string, options?: StopAnimationOptions) => void;
-    playProgram: (id: string) => void;
-    pauseProgram: (id: string) => void;
-    stopProgram: (id: string, options?: StopProgramOptions) => void;
-    getProgramState: (id: string) => ProgramPlaybackState | null;
-    setAnimationActive: (active: boolean) => void;
-    isAnimationActive: () => boolean;
-    step: (dt: number, opts?: {
-        forceRuntime?: boolean;
-    }) => void;
-    inputConstraints: Record<string, {
-        min?: number;
-        max?: number;
-        defaultValue?: number;
-    }>;
-};
-type VizijRuntimeProviderProps = {
-    assetBundle: VizijAssetBundle;
-    children: ReactNode;
-    namespace?: string;
-    faceId?: string;
-    updateTier?: RuntimeUpdateTier;
-    autoCreate?: boolean;
-    autostart?: boolean;
-    /**
-     * Whether this provider's device paces itself: when true the device is
-     * handed to its own `run()` loop at boot and the provider only pumps its
-     * changes; when false the device advances solely on `step(dt,
-     * { forceRuntime: true })` calls from the host. A device handed to `run()`
-     * keeps its loop even if this later turns false.
-     */
-    driveRuntime?: boolean;
-    mergeStrategy?: MergeStrategyOptions;
-    onRegisterControllers?: (ids: {
-        graphs: string[];
-        anims: string[];
-    }) => void;
-    onStatusChange?: (status: VizijRuntimeStatus) => void;
-    transformOutputWrite?: (write: RuntimeOutputWrite) => RuntimeOutputWrite | null;
-};
-type RuntimeUpdateTier = "auto" | "assets" | "graphs";
-type RuntimeUpdatePlan = {
-    reloadAssets: boolean;
-    reregisterGraphs: boolean;
-};
-type RuntimeGraphBundle = {
-    rig?: VizijGraphAsset;
-    pose?: VizijAssetBundle["pose"];
-    animations?: VizijAnimationAsset[];
-    programs?: VizijProgramAsset[];
-};
+/** A face's GLB: a URL to fetch, or its bytes. */
+type VizijSource = string | URL | Blob | ArrayBuffer | Uint8Array;
+interface VizijRuntimeProviderProps {
+    /** The face to show. A different source reloads the face in place;
+     * `null` shows none: the provider takes its face down, and its children,
+     * which stay mounted, see no face (`useOptionalVizijRuntime()` is
+     * `null`). */
+    glb: VizijSource | null;
+    /** The id the face is loaded and shown under; one is derived from
+     * React's `useId()` when absent. */
+    vizijId?: string;
+    /** `loadVizij`'s options, passed through unchanged. Read at each load: a
+     * change shows from the next `glb`. */
+    options?: VizijOptions;
+    /** `true` (default): the provider steps the device, once per animation
+     * frame while the page is visible and on a timer while it is hidden.
+     * `false`: the device is stopped, and the page steps it
+     * (`runtime.step(dtMs)`). */
+    run?: boolean;
+    children?: ReactNode;
+}
+/**
+ * One face's lifecycle in React, over `@vizij/runtime`.
+ *
+ * It fetches the GLB, reads it with `describe`, waits for the page's canvas
+ * (`<VizijCanvas>`), loads the face with `loadVizij`, and hands its children
+ * the face's `Runtime` unwrapped (`useVizijRuntime`). A new `glb` reloads
+ * the face under the same id: the previous scene draws until the new one is
+ * ready, and the previous `Runtime` is stopped and disposed once the new one
+ * exists. Unmounting stops the device, unloads the face and disposes it; a
+ * `null` `glb` does the same and keeps the children mounted, so a page whose
+ * face comes and goes keeps its tree.
+ *
+ * Unless `run` is `false`, it steps the device: once per animation frame
+ * while the page is visible — one step per drawn frame, each by the time
+ * since the previous step — and every {@link HIDDEN_STEP_MS} while it is
+ * hidden, where the browser throttles timers and draws nothing. A page
+ * shown again keeps that timer until its first animation frame, so the
+ * device is never left unstepped between the two.
+ *
+ * It is the one caller of the runtime's `drainChanges`, whose cursor is one
+ * per `Runtime`. While something listens (`useVizijChanges`,
+ * `useVizijValues`) it drains once per animation frame and hands each batch
+ * to every listener; while nothing does, it does not drain. The runtime
+ * holds what is not drained as the latest value per key, so a batch is the
+ * net change since the previous drain, however long ago that was. The first
+ * batch after a (re)load is the whole store.
+ *
+ * It reports the face's stages to `@vizij/render` (`setVizijProgress`), for
+ * the loading view of the face's slot: the GLB's bytes as they arrive, then
+ * `loadVizij`, then the face's first frame. Unloading the face clears them.
+ *
+ * Showing the face is the page's `<Vizij>` slot, bound to this provider by
+ * `<VizijRuntimeFace>`.
+ */
+declare function VizijRuntimeProvider({ glb, vizijId: givenId, options, run, children, }: VizijRuntimeProviderProps): ReactNode;
 
-type ProviderProps = PropsWithChildren<VizijRuntimeProviderProps>;
-declare function VizijRuntimeProvider({ assetBundle, children, namespace: namespaceProp, faceId: faceIdProp, updateTier, autoCreate, autostart, driveRuntime, mergeStrategy, onRegisterControllers, onStatusChange, transformOutputWrite, }: ProviderProps): react_jsx_runtime.JSX.Element;
+type VizijRuntimeFaceProps = Omit<VizijProps, "vizijId">;
+/** `<Vizij>` bound to the nearest provider's face: where it draws on the
+ * page's canvas. */
+declare function VizijRuntimeFace(props: VizijRuntimeFaceProps): ReactNode;
 
-declare function VizijRuntimeFaceInner({ namespaceOverride, ...props }: VizijRuntimeFaceProps): react_jsx_runtime.JSX.Element | null;
-declare const VizijRuntimeFace: react.MemoExoticComponent<typeof VizijRuntimeFaceInner>;
+/** A batch of store changes, as `Runtime.drainChanges` returns it: each
+ * changed key to its new value, `null` for a cleared key. */
+type VizijChanges = Record<string, ValueJSON | null>;
+type VizijRuntimeStatus = "loading" | "ready" | "error";
+/** One face, as `VizijRuntimeProvider` hands it to its children. */
+interface VizijRuntimeContextValue {
+    /** The id the face is loaded and shown under. */
+    vizijId: string;
+    /** `loading` until the face is drawn — its scene showing its device's
+     * pose — however long its GPU takes, and again while a new `glb` loads;
+     * `error` when loading failed. */
+    status: VizijRuntimeStatus;
+    error: Error | null;
+    /** The device's standing behavior error (`Runtime.behaviorError`): the
+     * message of its latest failed tick, `undefined` while healthy. */
+    behaviorError: string | undefined;
+    /** `@vizij/runtime`'s `Runtime` of the face, as it is: every device
+     * operation is called on it. `null` until the first load completes. */
+    runtime: Runtime | null;
+    /** `describe(glb)`: what the face's GLB declares — poses, rig inputs,
+     * programs, animations, metadata, bounds. `null` until read. */
+    description: VizijDescription | null;
+}
 
+/** The face of the nearest `VizijRuntimeProvider`; throws outside one. */
 declare function useVizijRuntime(): VizijRuntimeContextValue;
-
+/** The face of the nearest `VizijRuntimeProvider`, or `null` outside one. */
 declare function useOptionalVizijRuntime(): VizijRuntimeContextValue | null;
-
-declare function useVizijOutputs(paths: string[]): Record<string, RawValue | undefined>;
-
-declare function useRigInput(path: string): [RawValue | undefined, (value: ValueJSON, shape?: ShapeJSON) => void];
-
-declare function resolveRuntimeUpdatePlan(previous: VizijAssetBundle | null, next: VizijAssetBundle, tier: RuntimeUpdateTier): RuntimeUpdatePlan;
-
-declare const POSE_WEIGHT_INPUT_PATH_PREFIX = "/poses/";
-declare const VISEME_POSE_KEYS: readonly ["a", "at", "b", "e", "e_2", "f", "i", "k", "m", "o", "o_2", "p", "r", "s", "t", "t_2", "u"];
-declare const EXPRESSIVE_EMOTION_POSE_KEYS: readonly ["concerned", "happy", "sad", "sleepy", "surprise"];
-declare const EMOTION_POSE_KEYS: readonly ["concerned", "happy", "neutral", "sad", "sleepy", "surprise", "angry"];
-type PoseSemanticKind = "emotion" | "viseme" | "other";
-declare function buildRigInputPath(faceId: string, path: string): string;
-declare function buildPoseWeightInputPathSegment(poseId: string | null | undefined): string;
-declare function buildPoseWeightRelativePath(poseId: string | null | undefined): string;
-declare function buildPoseWeightPathMap(poses: PoseDefinition[], faceId: string | null | undefined): Map<string, string>;
-declare function normalizePoseSemanticKey(value: string | null | undefined): string | null;
-declare function getPoseSemanticKey(pose: Pick<PoseDefinition, "id" | "name">): string | null;
-declare function resolvePoseMembership(pose: Pick<PoseDefinition, "group" | "groupId" | "groupIds">, groups: PoseGroupDefinition[] | undefined): {
-    groupIds: string[];
-    primaryGroupId: string | null;
-    primaryGroupPath: string | null;
-    groupPathsById: Record<string, string>;
-};
-declare function resolvePoseSemantics(pose: Pick<PoseDefinition, "id" | "name" | "group" | "groupId" | "groupIds">, groups: PoseGroupDefinition[] | undefined): {
-    key: string | null;
-    kind: PoseSemanticKind;
-    membership: ReturnType<typeof resolvePoseMembership>;
-};
-declare function filterPosesBySemanticKind(poses: PoseDefinition[], groups: PoseGroupDefinition[] | undefined, kind: PoseSemanticKind): PoseDefinition[];
-declare function buildSemanticPoseWeightPathMap(poses: PoseDefinition[], groups: PoseGroupDefinition[] | undefined, faceId: string | null | undefined, kind: Exclude<PoseSemanticKind, "other">): Map<string, string>;
-
-type InputConstraint = {
-    min?: number;
-    max?: number;
-    defaultValue?: number;
-};
-type FaceScalarControl = {
-    path: string;
-    min: number;
-    max: number;
-    defaultValue: number;
-};
-type ResolvedFaceControls = {
-    faceId: string;
-    gazeSource: "standard-vizij" | "standard" | "propsrig" | "coupled-gaze" | "none";
-    blinkSource: "lids" | "blink" | "none";
-    eyes: {
-        leftX: FaceScalarControl | null;
-        leftY: FaceScalarControl | null;
-        rightX: FaceScalarControl | null;
-        rightY: FaceScalarControl | null;
-    };
-    eyelids: {
-        leftUpper: FaceScalarControl | null;
-        rightUpper: FaceScalarControl | null;
-    };
-    blink: FaceScalarControl | null;
-};
-declare function resolveFaceControls(assetBundle: VizijAssetBundle, runtimeFaceId?: string | null, inputConstraints?: Record<string, InputConstraint>): ResolvedFaceControls;
-declare function mapNormalizedControlValue(control: FaceScalarControl, normalizedValue: number): number;
-declare function mapUnitControlValue(control: FaceScalarControl, unitValue: number): number;
-
 /**
- * Compose several Vizij graph specs into the ONE graph an Arora device runs.
- *
- * The device runs a single ProcessingGraph as its behavior, so the separate
- * graph sources become a union of nodes and edges here. Sources and their
- * provenance (see `graphSourcesRef` in VizijRuntimeProvider for details):
- * the **rig** graph shipped in the loaded GLB/asset bundle, the bundle's
- * **pose-driver** graph, and one source per **playing program** (bundle
- * programs and the authoring motiongraph, which publishes the editor's
- * graph as a program). Node ids
- * are prefixed `${sourceId}::` so sources can't collide; `params.path` is
- * deliberately NOT prefixed — path identity on the device's shared store is
- * the cross-graph contract (a pose output written to a store path is read by
- * a rig input node with the same path on the next tick).
- *
- * Output-path collisions across sources (two `output` nodes writing one
- * path) are warned and resolved last-writer-wins by evaluation order; there
- * is no additive merge for that case yet, and current bundles don't collide.
- * If a real bundle does, insert an explicit combiner node here instead of
- * widening this warning.
+ * Call `listener` with each batch of store changes the provider drains: at
+ * most once per animation frame, the first batch after a (re)load being the
+ * whole store. For a consumer that must not re-render per change — a
+ * sampler, a scrubber, a bridge to another system. The latest `listener` is
+ * called; it need not be stable.
  */
-type SpecRecord = Record<string, unknown>;
-/** A graph spec treated structurally (same tolerance as `utils/graph.ts`). */
-type ComposableSpec = SpecRecord;
-interface GraphSource {
-    /** Stable id of the source graph (e.g. "rig", "pose", a program id). */
-    sourceId: string;
-    spec: ComposableSpec;
-}
+declare function useVizijChanges(listener: (changes: VizijChanges) => void): void;
 /**
- * Union `sources` into one spec. Later sources evaluate after earlier ones,
- * so on an output-path collision the last source wins (warned).
+ * The current values of `paths` in the face's store — `null` for an unset
+ * key — re-rendering the component when one of them changes. Read from the
+ * runtime when it (re)loads, then kept current from the provider's batches.
  */
-declare function composeGraphSpecs(sources: GraphSource[]): ComposableSpec;
+declare function useVizijValues(paths: string[]): Record<string, ValueJSON | null>;
 
-declare function collectInputPathMap(spec: GraphRegistrationConfig["spec"]): Record<string, string>;
-
-declare function resolveAnimationBridgeOutputPaths(channel: string, faceId?: string, rigInputMap?: Record<string, string>): string[];
+type Easing = "linear" | "easeIn" | "easeOut" | "easeInOut" | ((t: number) => number);
+interface AnimateValueOptions {
+    /** Seconds; default 0.35. `0` writes the target at once. */
+    duration?: number;
+    /** Default `linear`. */
+    easing?: Easing;
+}
+/**
+ * Animate a key of the face's store towards a number: a JS tween, one write
+ * per animation frame through `runtime.setValue`, eased, in the numeric kind
+ * the key holds (an `f32` key stays `f32`). A key nothing has written yet
+ * starts from the value the device lists it resting at. A newer tween on the
+ * same path replaces the running one; the component's tweens are cancelled
+ * when it unmounts, and a face's when it reloads. The promise resolves when
+ * the tween ends or is cancelled, and rejects when the key holds no number
+ * and rests at none.
+ */
+declare function useAnimateValue(): {
+    animateValue(path: string, target: number, options?: AnimateValueOptions): Promise<void>;
+    cancelAnimation(path: string): void;
+};
 
-export { type AnimateValueOptions, type AnimationClipLike, type AnimationKeyframeLike, type AnimationPlaybackState, type AnimationTrackLike, type ComposableSpec, EMOTION_POSE_KEYS, EXPRESSIVE_EMOTION_POSE_KEYS, type FaceScalarControl, type GraphSource, type InputDriverContext, type InputDriverFactory, type InputDriverLifecycle, POSE_WEIGHT_INPUT_PATH_PREFIX, type PlayAnimationOptions, type PoseDefinition, type PoseGroupDefinition, type PoseRigConfig, type ProgramPlaybackState, type RootBounds, type RuntimeGraphBundle, type RuntimeOutputWrite, type RuntimeUpdatePlan, type RuntimeUpdateTier, type StopProgramOptions, VISEME_POSE_KEYS, type VizijAnimationAsset, type VizijAssetBundle, type VizijGlbAsset, type VizijGraphAsset, type VizijProgramAsset, VizijRuntimeFace, type VizijRuntimeFaceProps, VizijRuntimeProvider, type VizijRuntimeProviderProps, type VizijRuntimeStatus, buildPoseWeightInputPathSegment, buildPoseWeightPathMap, buildPoseWeightRelativePath, buildRigInputPath, buildSemanticPoseWeightPathMap, collectInputPathMap, composeGraphSpecs, filterPosesBySemanticKind, getPoseSemanticKey, mapNormalizedControlValue, mapUnitControlValue, normalizePoseSemanticKey, resolveAnimationBridgeOutputPaths, resolveFaceControls, resolvePoseMembership, resolvePoseSemantics, resolveRuntimeUpdatePlan, useOptionalVizijRuntime, useRigInput, useVizijOutputs, useVizijRuntime };
+export { type AnimateValueOptions, type Easing, type VizijChanges, type VizijRuntimeContextValue, VizijRuntimeFace, type VizijRuntimeFaceProps, VizijRuntimeProvider, type VizijRuntimeProviderProps, type VizijRuntimeStatus, type VizijSource, useAnimateValue, useOptionalVizijRuntime, useVizijChanges, useVizijRuntime, useVizijValues };