@vizij/runtime-react 0.3.1 → 0.4.1

package/dist/index.d.cts

@@ -4,7 +4,7 @@ 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, VizijProps } from '@vizij/render';
+import { World, VizijBundleExtension, VizijStarredItem, VizijProps } from '@vizij/render';
 
 /** Value shape hint. Accepted through the public surface, unused by the device. */
 type ShapeJSON = Record<string, unknown>;
@@ -156,6 +156,12 @@ type VizijAssetBundle = {
     };
     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;
@@ -394,4 +400,43 @@ declare function resolveFaceControls(assetBundle: VizijAssetBundle, runtimeFaceI
 declare function mapNormalizedControlValue(control: FaceScalarControl, normalizedValue: number): number;
 declare function mapUnitControlValue(control: FaceScalarControl, unitValue: number): number;
 
-export { type AnimateValueOptions, type AnimationClipLike, type AnimationKeyframeLike, type AnimationPlaybackState, type AnimationTrackLike, EMOTION_POSE_KEYS, EXPRESSIVE_EMOTION_POSE_KEYS, type FaceScalarControl, 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, filterPosesBySemanticKind, getPoseSemanticKey, mapNormalizedControlValue, mapUnitControlValue, normalizePoseSemanticKey, resolveFaceControls, resolvePoseMembership, resolvePoseSemantics, resolveRuntimeUpdatePlan, useOptionalVizijRuntime, useRigInput, useVizijOutputs, useVizijRuntime };
+/**
+ * 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.
+ */
+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;
+}
+/**
+ * Union `sources` into one spec. Later sources evaluate after earlier ones,
+ * so on an output-path collision the last source wins (warned).
+ */
+declare function composeGraphSpecs(sources: GraphSource[]): ComposableSpec;
+
+declare function collectInputPathMap(spec: GraphRegistrationConfig["spec"]): Record<string, string>;
+
+declare function resolveAnimationBridgeOutputPaths(channel: string, faceId?: string, rigInputMap?: Record<string, string>): string[];
+
+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 };

package/dist/index.d.ts

@@ -4,7 +4,7 @@ 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, VizijProps } from '@vizij/render';
+import { World, VizijBundleExtension, VizijStarredItem, VizijProps } from '@vizij/render';
 
 /** Value shape hint. Accepted through the public surface, unused by the device. */
 type ShapeJSON = Record<string, unknown>;
@@ -156,6 +156,12 @@ type VizijAssetBundle = {
     };
     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;
@@ -394,4 +400,43 @@ declare function resolveFaceControls(assetBundle: VizijAssetBundle, runtimeFaceI
 declare function mapNormalizedControlValue(control: FaceScalarControl, normalizedValue: number): number;
 declare function mapUnitControlValue(control: FaceScalarControl, unitValue: number): number;
 
-export { type AnimateValueOptions, type AnimationClipLike, type AnimationKeyframeLike, type AnimationPlaybackState, type AnimationTrackLike, EMOTION_POSE_KEYS, EXPRESSIVE_EMOTION_POSE_KEYS, type FaceScalarControl, 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, filterPosesBySemanticKind, getPoseSemanticKey, mapNormalizedControlValue, mapUnitControlValue, normalizePoseSemanticKey, resolveFaceControls, resolvePoseMembership, resolvePoseSemantics, resolveRuntimeUpdatePlan, useOptionalVizijRuntime, useRigInput, useVizijOutputs, useVizijRuntime };
+/**
+ * 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.
+ */
+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;
+}
+/**
+ * Union `sources` into one spec. Later sources evaluate after earlier ones,
+ * so on an output-path collision the last source wins (warned).
+ */
+declare function composeGraphSpecs(sources: GraphSource[]): ComposableSpec;
+
+declare function collectInputPathMap(spec: GraphRegistrationConfig["spec"]): Record<string, string>;
+
+declare function resolveAnimationBridgeOutputPaths(channel: string, faceId?: string, rigInputMap?: Record<string, string>): string[];
+
+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 };