@lovelace_lol/embody 0.0.12 → 0.0.14

package/dist/wasm/README.md

@@ -33,7 +33,8 @@ The Rust core owns:
   (`morphTarget` / `boneTransform` tracks) for the host mixer to schedule
 - mesh-category routing and material profile data
 - hair curves, hair physics, and appearance normalization
-- annotation camera/marker math and humanoid template fitting
+- annotation regions, camera gestures/flights/orbits, marker placement and visibility,
+  preview/reveal lifecycles, and humanoid template fitting
 - profile-aware screen-space gaze geometry for eye/head AU trajectories
 - renderer-neutral model analysis and packed live frame generation
 
@@ -53,9 +54,9 @@ disable the AU's mapped morphs or the viseme shapes.
 The TypeScript adapter is intentionally limited to operations that require
 Three.js objects: scene traversal, ClipIR ↔ `AnimationClip` conversion, frame
 application, material writes, model loading/disposal, and default scene
-construction. The annotation adapter also owns camera controls, marker scene
-objects, labels, selection, and their browser lifecycle; applications provide
-the scene/camera/DOM inputs and render controls through the public API.
+construction. Annotation adapters capture DOM input, observe native geometry,
+apply Rust camera/marker frames, render labels and release native resources.
+Camera integration, region selection and marker state belong to Rust.
 
 `ThreeFrameApplier.applyMeshMaterialConfigs(model, profile.meshes)` replays named
 mesh visibility and material overrides when a host binds or replaces a profile.
@@ -67,31 +68,95 @@ do not need a separate mesh-visibility replay loop.
 
 ### Annotation runtime
 
-`DPthreeCameraController` and the `DPthree` convenience facade from
-`@lovelace_lol/embody/three` own the complete camera and annotation runtime.
-`DPthree3DMarkers`, `DPthreeHTMLMarkers`, and the legacy `DPthreeMarkers` adapter
-are available for hosts that need a marker-only layer. Rust owns camera
-framing/flights/orbits, viewport clipping, curves, visibility factors and
-endpoint separation. The Three adapter owns native model inspection,
-raycasting, labels, DOM controls, marker expansion/solo/style state and disposal.
+`AnnotationRuntime` in `src/annotation_runtime/` owns the annotation behavior
+and mutable state in Rust/Wasm: camera input and damping, framing and intro
+transitions, authored/runtime regions, AU/bone target selection, laterality,
+anchors, surface-query planning, expansion, solo, styles, visibility and layout.
+`AnnotationLifecycle` owns preview/reveal deadlines and the effects they emit.
+There is no TypeScript annotation state machine or OrbitControls dependency.
+
+`ThreeAnnotationController` and the `ThreeAnnotations` convenience facade from
+`@lovelace_lol/embody/three` provide native adapters. `ThreeAnnotationMarkers`,
+`HtmlAnnotationMarkers`, and its `OverlayAnnotationMarkers` alias provide
+marker-only views of the same Rust runtime. Their TypeScript code captures input,
+serializes model observations, calls native raycasts and skinned-vertex evaluation,
+applies packed Rust frames, creates labels, and owns renderer resources. Three
+continues to own scene objects and GPU operations; those APIs cannot be replaced
+by renderer-neutral Rust. Both marker styles share the same state and selection
+rules. HTML occlusion uses Rust-planned rays evaluated by Three.
+
+Rust fits marker endpoints before marker loading returns and on each update,
+including additions, endpoint separation and reveal overshoot. Clipping uses
+the displayed label dimensions and preserves the minimum leader-line length;
+temporary overshoot clipping does not restart the reveal. Sphere sizing retains
+the close-up scale and clamped distance scaling outside that range. Explicit
+`markerAnchor.projectToSurface: false` also applies to `objects: ['*']` anchors.
+HTML overlays align with the canvas rectangle inside its container, update on
+resize/rebind, and restore borrowed parent positioning when the final view is
+disposed. These coordinates assume axis-aligned CSS boxes without transforms.
+
+AU morph anchors currently sample native deformed vertices during marker
+preparation, then follow the selected object's transform. They do not yet
+resample morph weights or skinning on subsequent frames. Animated surface
+tracking requires cached vertex candidates and per-frame pose observations;
+ordinary object-transform tracking does not provide that behavior.
+
+This is a breaking replacement of the DPthree exports. Use
+`ThreeAnnotationController.create(options)` or `ThreeAnnotations.create(options)`
+to await Wasm initialization; synchronous constructors require an already initialized
+core. Replace DPthree-prefixed types with `AnnotationCharacterConfig`,
+`AnnotationRegion`, `AnnotationRegistry`, and the corresponding callback types.
+The `controls` bridge retains `target`, `enabled`, damping/distance settings,
+`update()`, and `change`/`start`/`end` listeners, but is not a Three `OrbitControls`
+instance. Region and camera snapshots are observations; mutate through controller
+methods. Explicit `undefined` fields in `updateAnnotationRegion` remove overrides.
+`getCharacterConfig()` retains snapshot identity until configuration content or
+the model changes; selection, visibility and camera input do not replace it.
+Call `clearModel()` before releasing a removed model's native resources. The
+controller retains renderer rebinding, canvas input reconnect and resource-drain
+support through the scene's rendering controller.
+Runtime preview region IDs retain the `runtime:annotation:` namespace.
+
+When the annotation controller owns the renderer loop, it advances registered
+native character mixers before observing annotation transforms and drawing the
+scene. The first frame establishes the timer origin; skipped asynchronous draws
+do not accumulate playback time. External render loops use the existing
+`createScenePlaybackFrame` integration to advance character playback.
+
+```ts
+import { ThreeAnnotations } from '@lovelace_lol/embody/three';
+
+const annotations = await ThreeAnnotations.create({ scene, camera, domElement: canvas });
+annotations.setModel(model);
+await annotations.loadCharacter({ characterId: 'character', profilePresetId: 'cc4' });
+// Host-owned render loop: call annotations.update() before renderer.render(...).
+```
 
 Applications pass `AnnotationCharacterConfig`; storage, agency, editor and
 character-asset metadata remain host concerns. `loadRegions` defaults to
 `resolveAnnotationCharacterConfig`, which resolves annotation and AU mapping
 fields from an Embody preset without serializing unrelated host metadata.
 An optional `resolveCharacterConfig` callback supports host profile intake.
+`prepareRegionsForReveal` defers native marker construction until the first
+`setMarkersVisible(true)` call. Later visibility changes reuse those resources;
+Rust's loaded state resets when the model or configuration is replaced.
 `prepareRegionsAndMarkersForReveal` accepts an already-resolved profile and
 prepares native surface queries while the model pose is still stable.
 Initial queries yield to a browser paint between meshes once a 4 ms slice is
-spent. Each native mesh raycast is indivisible; a large mesh can still cause a
-frame drop, and slicing does not reduce total raycast CPU time. Interactive
-annotation changes retain synchronous queries so a marker samples one pose.
-Replacement, clearing and disposal cancel stale loads before scene commits.
-New 3D markers and separated endpoints invalidate the cached camera layout.
-Visible markers receive the current zoom sizing and Rust viewport constraints
-before paint; hidden markers receive that layout before reveal captures label
-scales. Viewport clipping also follows the animated label size during reveal
-overshoot. Markers added during a reveal stay hidden until its layout pass resumes.
+spent. Each native mesh raycast is indivisible; slicing does not reduce total
+raycast CPU time. Interactive edits retain synchronous queries so a marker samples
+one pose. Rust generations reject stale profile, surface and reveal completions
+after replacement, clearing, region edits or disposal. Camera requests settle when
+completed or cancelled, including controller disposal.
+
+The direct Wasm boundary uses JSON commands/snapshots for configuration and
+primitive model observations with stable object IDs. Frames, vertex candidates,
+transform observations and ray results use packed typed arrays; coordinates are
+world-space, camera/visibility angles are degrees, durations are milliseconds,
+and viewport dimensions are CSS pixels. The layouts and operations are maintained
+in [the Rust runtime](src/annotation_runtime/mod.rs) and
+[marker frames](src/annotation_runtime/markers.rs); generated Wasm declarations
+remain the ABI type source. IDs are scoped to one model lifetime.
 
 For first reveal, call `controller.prepareModelForRender(model, { signal })`
 from the existing `beforeReveal` callback (or directly before attaching the
@@ -103,8 +168,14 @@ it settles, even after `controller.dispose()`. This prepares visible variants,
 not every future hidden material or animation state. See the
 [model readiness contract](docs/SCENE_READINESS.md#model-readiness).
 
-`createMarkerVisibilityLifecycle` owns automatic reveal/hide timers;
-`createRuntimeAnnotationPreviewLifecycle` owns temporary authoring previews.
+`createMarkerVisibilityLifecycle` and `createRuntimeAnnotationPreviewLifecycle`
+transport host events to `AnnotationLifecycle`; browser timers only wake Rust at
+its next deadline. Factories can queue input while Wasm initializes; `ready`
+reports the current initialization attempt. After an initialization failure,
+the next command retries or adopts a core initialized by another scene. Failed
+attempts discard their queued input. `dispose()` also discards pending input,
+cancels timers and frees the runtime, so cleanup before readiness cannot replay
+callbacks. Later calls create a fresh runtime, preserving host effect-replay cleanup.
 React hosts forward user events and subscribe to controller state. They do not
 need local copies of the camera, marker, placement or timer algorithms.
 The convenience facade delegates to one controller-owned marker layer.
@@ -177,7 +248,7 @@ controller immediately. `ready` reports the initial attempt; failure retains the
 controller for recovery through `setSettings`. `getSettings`, `getSnapshot` and
 `subscribe` expose the requested preference, actual backend, status and errors.
 Live changes prepare and replace only backend resources, preserving the character,
-scene, camera, lighting and marker state. `DPthreeCameraController({ rendering,
+scene, camera, lighting and marker state. `ThreeAnnotationController({ rendering,
 scene, camera, domElement: container })` retargets its existing loop and controls;
 hosts persist settings and display status without recreating the scene.
 
@@ -549,3 +620,15 @@ values/curves, using their original profile mappings. `LEGACY_BODY_CONTROL_AUS`
 is a deprecated reader-only historical identity snapshot for old CC4 records;
 it is never consulted for current controls, actuation or profile compilation.
 Unknown legacy names must be reported rather than silently omitted.
+
+### Character-derived studio background
+
+The Three `createCharacterHost` paints its container with soft gradients sampled
+from the selected model's material and texture colors. The studio uses the
+original visible ink strengths (24/12%, 22/10%, 18%) over a gunmetal base.
+Embody owns palette extraction and updates after successful character replacement;
+late extraction cannot repaint a newer selection or a disposed host. Disposal
+restores the container's original inline background. Explicit saved backgrounds,
+including `null` transparency, non-studio scene types and external scenes retain
+their authored appearance. Polymer forwards the host; applications do not sample
+textures or construct a second scene background.

package/dist/wasm/embody_wasm.d.ts

@@ -1,10 +1,67 @@
 /* tslint:disable */
 /* eslint-disable */
 
+/**
+ * Browser timers only wake this state machine. Rust owns deadlines, expiry,
+ * manual overrides, repeated preview starts, and one-shot end notifications.
+ */
+export class AnnotationLifecycle {
+    free(): void;
+    [Symbol.dispose](): void;
+    command(operation: string, options_json: string, now_ms: number): string;
+    deadline(): number | undefined;
+    is_active(): boolean;
+    constructor(mode: string, default_duration_ms: number);
+}
+
+export class AnnotationRuntime {
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * The only camera integrator: pose observation(6), fov/aspect/viewport(4).
+     * Returns pose(6), active request id, completed request id, needs frame.
+     */
+    camera_frame(now_ms: number, observation: Float32Array): Float32Array;
+    command(operation: string, payload_json: string, now_ms: number): string;
+    completed_camera_request(): number;
+    dispose(): void;
+    finish_markers(generation: number): void;
+    generation(): number;
+    is_current(generation: number): boolean;
+    label_metrics(id: number, width: number, height: number): void;
+    marker_frame(now_ms: number, projection: Float32Array, view_projection: Float32Array, width: number, height: number): Float32Array;
+    needs_frame(): boolean;
+    constructor(settings_json: string);
+    observe_model(model_json: string): void;
+    /**
+     * Native hit observations are [marker id, nearest distance], with infinity for no hit.
+     */
+    observe_occlusion(hits: Float32Array): void;
+    /**
+     * Packed observation records are [object id, column-major matrixWorld(16)].
+     */
+    observe_transforms(transforms: Float32Array): void;
+    /**
+     * HTML occlusion rays: [id, origin(3), direction(3), maximum distance].
+     * Three reports the nearest native hit; Rust owns its visibility meaning.
+     */
+    occlusion_queries(): Float32Array;
+    /**
+     * Plans contain native ray queries, never native handles. Every result is
+     * tied to this generation; a stale query cannot resurrect cleared markers.
+     */
+    plan_markers(morph_anchors_json: string): string;
+    revision(): number;
+    set_model(model_json: string): void;
+    snapshot(): string;
+    surface_result(generation: number, id: number, phase: number, hits: Float32Array): string;
+    tracked_objects(): Uint32Array;
+}
+
 /**
  * Spherical camera flight between two camera poses.
  *
- * Mirrors the DPthree camera transition: orbital interpolation with a
+ * Mirrors the ThreeAnnotations camera transition: orbital interpolation with a
  * pullback arc so large rotations do not pass through the model.
  * `sample(elapsed_ms)` returns
  * `[posX, posY, posZ, targetX, targetY, targetZ, done]`.
@@ -304,8 +361,24 @@ export function analyze_mesh_proportions(vertices: Float32Array, vertical_axis:
 
 export function analyze_model_descriptor(model_json: string, clips_json: string, profile_json: string, options_json: string): string;
 
+/**
+ * Select vertices influenced by any requested skeleton index. The adapter
+ * evaluates these indices through the native skinned vertex API.
+ */
+export function annotation_bone_vertices(indices: Float32Array, weights: Float32Array, bones: Uint32Array): Uint32Array;
+
 export function annotation_camera_framing_stride(): number;
 
+export function annotation_marker_frame_stride(): number;
+
+export function annotation_morph_candidates(base: Float32Array, morphs: Float32Array, relative: boolean): Float32Array;
+
+export function annotation_morph_center(region_json: string, candidates: Float32Array): Float32Array;
+
+export function annotation_point_bounds(points: Float32Array): Float32Array;
+
+export function annotation_query(operation: string, payload_json: string): string;
+
 /**
  * Build head-pitch gravity hair morph curves.
  */
@@ -495,7 +568,7 @@ export function sample_marker_bezier_curve(start: Float32Array, end: Float32Arra
  *
  * `starts` and `ends` are packed `[x, y, z, ...]` arrays. The output includes
  * one endpoint for every complete start/end pair. Proximity and rotation
- * constants match DPthree's marker layout, scaled to the current model height.
+ * constants match ThreeAnnotations's marker layout, scaled to the current model height.
  */
 export function separate_overlapping_marker_endpoints(starts: Float32Array, ends: Float32Array, model_center: Float32Array, model_height: number): Float32Array;
 
@@ -600,48 +673,81 @@ export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembl
 
 export interface InitOutput {
     readonly memory: WebAssembly.Memory;
-    readonly default_hair_color_appearance_json: () => [number, number, number, number];
-    readonly hair_color_presets_json: () => [number, number, number, number];
-    readonly normalize_hair_color_appearance_json: (a: number, b: number, c: number, d: number) => [number, number, number, number];
-    readonly embody_request: (a: number, b: number) => [number, number, number, number];
-    readonly compute_humanoid_skeleton_template_rest_bounds: (a: number, b: number) => [number, number, number, number];
     readonly core_abi_version: () => number;
-    readonly create_validation_skeleton_json: (a: number, b: number) => [number, number, number, number];
-    readonly extract_humanoid_skeleton_template_json: (a: number, b: number, c: number, d: number) => [number, number, number, number];
-    readonly get_humanoid_skeleton_template_json: (a: number, b: number) => [number, number, number, number];
-    readonly humanoid_skeleton_template_bone_names: (a: number, b: number) => [number, number, number, number];
-    readonly list_humanoid_skeleton_templates_json: () => [number, number, number, number];
-    readonly marker_endpoint_stride: () => number;
-    readonly marker_visibility_animation_factors: (a: number, b: number) => [number, number];
     readonly pack_morph_frame_delta: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => [number, number];
     readonly packed_bone_frame_delta_stride: () => number;
     readonly packed_morph_frame_delta_stride: () => number;
-    readonly passes_marker_camera_angle_gate: (a: number, b: number, c: number) => number;
-    readonly resolve_viewport_constrained_line_scale: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number];
-    readonly resolve_viewport_safe_bounds: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number];
-    readonly sample_marker_arc_curve: (a: number, b: number, c: number, d: number, e: number) => [number, number];
-    readonly sample_marker_bezier_curve: (a: number, b: number, c: number, d: number, e: number) => [number, number];
-    readonly separate_overlapping_marker_endpoints: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number];
-    readonly should_show_marker: (a: number, b: number, c: number, d: number) => number;
-    readonly marker_visibility_factors_stride: () => number;
-    readonly __wbg_cameraflight_free: (a: number, b: number) => void;
-    readonly __wbg_cameraorbit_free: (a: number, b: number) => void;
+    readonly solve_axis_quaternion: (a: number, b: number, c: number, d: number) => [number, number];
+    readonly solve_bilateral_values: (a: number, b: number) => [number, number];
+    readonly solve_morph_batch: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number];
+    readonly compose_template_skeleton_fit_transform: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number];
+    readonly template_skeleton_fit_transform_stride: () => number;
+    readonly __wbg_annotationruntime_free: (a: number, b: number) => void;
+    readonly __wbg_nativeplaybacksession_free: (a: number, b: number) => void;
+    readonly annotation_marker_frame_stride: () => number;
+    readonly annotationruntime_camera_frame: (a: number, b: number, c: number, d: number) => [number, number];
+    readonly annotationruntime_command: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
+    readonly annotationruntime_completed_camera_request: (a: number) => number;
+    readonly annotationruntime_dispose: (a: number) => void;
+    readonly annotationruntime_finish_markers: (a: number, b: number) => void;
+    readonly annotationruntime_generation: (a: number) => number;
+    readonly annotationruntime_is_current: (a: number, b: number) => number;
+    readonly annotationruntime_label_metrics: (a: number, b: number, c: number, d: number) => void;
+    readonly annotationruntime_marker_frame: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => [number, number];
+    readonly annotationruntime_needs_frame: (a: number) => number;
+    readonly annotationruntime_new: (a: number, b: number) => [number, number, number];
+    readonly annotationruntime_observe_model: (a: number, b: number, c: number) => [number, number];
+    readonly annotationruntime_observe_occlusion: (a: number, b: number, c: number) => void;
+    readonly annotationruntime_observe_transforms: (a: number, b: number, c: number) => void;
+    readonly annotationruntime_occlusion_queries: (a: number) => [number, number];
+    readonly annotationruntime_plan_markers: (a: number, b: number, c: number) => [number, number, number, number];
+    readonly annotationruntime_revision: (a: number) => number;
+    readonly annotationruntime_set_model: (a: number, b: number, c: number) => [number, number];
+    readonly annotationruntime_snapshot: (a: number) => [number, number];
+    readonly annotationruntime_surface_result: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number];
+    readonly annotationruntime_tracked_objects: (a: number) => [number, number];
+    readonly nativeplaybacksession_control: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
+    readonly nativeplaybacksession_dispose: (a: number) => [number, number, number, number];
+    readonly nativeplaybacksession_new: () => [number, number, number];
+    readonly nativeplaybacksession_notify: (a: number, b: number, c: number) => [number, number, number, number];
+    readonly nativeplaybacksession_play: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
+    readonly nativeplaybacksession_rebind: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
+    readonly nativeplaybacksession_replace_clip: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
+    readonly analyze_model_descriptor: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => [number, number, number, number];
+    readonly build_hair_gravity_curves: (a: number, b: number) => [number, number, number, number];
+    readonly build_hair_idle_curves: (a: number, b: number, c: number) => [number, number, number, number];
+    readonly build_hair_impulse_curves: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
+    readonly compile_clip: (a: number, b: number) => [number, number, number, number];
+    readonly compile_clip_curves: (a: number, b: number) => [number, number, number, number];
+    readonly extract_model_data_json: (a: number, b: number, c: number, d: number) => [number, number, number, number];
+    readonly get_preset_json: (a: number, b: number) => [number, number, number, number];
+    readonly has_preset: (a: number, b: number) => number;
+    readonly list_presets: () => [number, number];
+    readonly merge_embedded_preset: (a: number, b: number, c: number, d: number) => [number, number, number, number];
+    readonly merge_preset_profile: (a: number, b: number, c: number, d: number) => [number, number, number, number];
+    readonly resolve_embedded_profile_view: (a: number, b: number, c: number, d: number) => [number, number, number, number];
+    readonly resolve_profile_view: (a: number, b: number) => [number, number, number, number];
+    readonly validate_humanoid_characterization: (a: number, b: number, c: number, d: number) => [number, number, number, number];
+    readonly validate_profile_model: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
+    readonly embody_request: (a: number, b: number) => [number, number, number, number];
+    readonly __wbg_hairphysicssolver_free: (a: number, b: number) => void;
     readonly __wbg_runtimecore_free: (a: number, b: number) => void;
-    readonly analyze_mesh_proportions: (a: number, b: number, c: number) => [number, number];
-    readonly annotation_camera_framing_stride: () => number;
-    readonly cameraflight_duration_ms: (a: number) => number;
-    readonly cameraflight_new: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => number;
-    readonly cameraflight_sample: (a: number, b: number) => [number, number];
-    readonly cameraorbit_duration_ms: (a: number) => number;
-    readonly cameraorbit_new: (a: number, b: number, c: number, d: number, e: number) => number;
-    readonly cameraorbit_sample: (a: number, b: number) => [number, number];
-    readonly compose_template_fit_adjustment: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number];
-    readonly focus_padding_factor: (a: number, b: number, c: number, d: number) => number;
-    readonly mesh_proportions_stride: () => number;
-    readonly normalize_camera_angle_degrees: (a: number) => number;
-    readonly resolve_auto_closeup_angle: (a: number, b: number, c: number, d: number, e: number) => number;
-    readonly resolve_focus_camera_direction: (a: number, b: number, c: number, d: number, e: number) => [number, number];
-    readonly runtimecore_au_morph_binding_stride: () => number;
+    readonly annotation_bone_vertices: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number];
+    readonly annotation_morph_candidates: (a: number, b: number, c: number, d: number, e: number) => [number, number];
+    readonly annotation_morph_center: (a: number, b: number, c: number, d: number) => [number, number, number, number];
+    readonly annotation_point_bounds: (a: number, b: number) => [number, number];
+    readonly annotation_query: (a: number, b: number, c: number, d: number) => [number, number, number, number];
+    readonly default_hair_physics_config_values: () => [number, number];
+    readonly hair_config_stride: () => number;
+    readonly hair_head_state_stride: () => number;
+    readonly hair_morph_output_stride: () => number;
+    readonly hair_state_stride: () => number;
+    readonly hairphysicssolver_get_config: (a: number) => [number, number];
+    readonly hairphysicssolver_get_state: (a: number) => [number, number];
+    readonly hairphysicssolver_new: (a: number, b: number) => number;
+    readonly hairphysicssolver_reset: (a: number) => void;
+    readonly hairphysicssolver_set_config: (a: number, b: number, c: number) => void;
+    readonly hairphysicssolver_update: (a: number, b: number, c: number, d: number) => [number, number];
     readonly runtimecore_begin_live_command: (a: number) => void;
     readonly runtimecore_build_clip: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number, number, number];
     readonly runtimecore_build_hair_gravity_clip: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number, number, number];
@@ -699,57 +805,57 @@ export interface InitOutput {
     readonly runtimecore_set_viseme: (a: number, b: number, c: number) => void;
     readonly runtimecore_set_viseme_jaw_scale: (a: number, b: number, c: number) => void;
     readonly runtimecore_set_viseme_slot_count: (a: number, b: number) => void;
-    readonly runtimecore_viseme_morph_binding_stride: () => number;
     readonly runtimecore_viseme_slot_index: (a: number, b: number, c: number) => number;
+    readonly validate_generated_template_fit_metadata: (a: number, b: number, c: number, d: number, e: number, f: number) => number;
+    readonly runtimecore_au_morph_binding_stride: () => number;
+    readonly runtimecore_viseme_morph_binding_stride: () => number;
+    readonly runtimecore_remove_animation_clip: (a: number, b: number, c: number) => number;
+    readonly __wbg_annotationlifecycle_free: (a: number, b: number) => void;
+    readonly annotationlifecycle_command: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
+    readonly annotationlifecycle_deadline: (a: number) => [number, number];
+    readonly annotationlifecycle_is_active: (a: number) => number;
+    readonly annotationlifecycle_new: (a: number, b: number, c: number) => number;
+    readonly compute_humanoid_skeleton_template_rest_bounds: (a: number, b: number) => [number, number, number, number];
+    readonly create_validation_skeleton_json: (a: number, b: number) => [number, number, number, number];
+    readonly extract_humanoid_skeleton_template_json: (a: number, b: number, c: number, d: number) => [number, number, number, number];
+    readonly get_humanoid_skeleton_template_json: (a: number, b: number) => [number, number, number, number];
+    readonly humanoid_skeleton_template_bone_names: (a: number, b: number) => [number, number, number, number];
+    readonly list_humanoid_skeleton_templates_json: () => [number, number, number, number];
+    readonly __wbg_cameraflight_free: (a: number, b: number) => void;
+    readonly __wbg_cameraorbit_free: (a: number, b: number) => void;
+    readonly annotation_camera_framing_stride: () => number;
+    readonly cameraflight_duration_ms: (a: number) => number;
+    readonly cameraflight_new: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => number;
+    readonly cameraflight_sample: (a: number, b: number) => [number, number];
+    readonly cameraorbit_duration_ms: (a: number) => number;
+    readonly cameraorbit_new: (a: number, b: number, c: number, d: number, e: number) => number;
+    readonly cameraorbit_sample: (a: number, b: number) => [number, number];
+    readonly focus_padding_factor: (a: number, b: number, c: number, d: number) => number;
+    readonly normalize_camera_angle_degrees: (a: number) => number;
+    readonly resolve_auto_closeup_angle: (a: number, b: number, c: number, d: number, e: number) => number;
+    readonly resolve_focus_camera_direction: (a: number, b: number, c: number, d: number, e: number) => [number, number];
     readonly solve_focus_framing: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number, m: number, n: number, o: number) => [number, number];
     readonly solve_full_body_framing: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number, m: number) => [number, number];
-    readonly solve_template_skeleton_fit: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number];
-    readonly template_skeleton_fit_solution_stride: () => number;
     readonly world_direction_for_camera_angle: (a: number, b: number, c: number) => [number, number];
     readonly camera_flight_sample_stride: () => number;
-    readonly runtimecore_remove_animation_clip: (a: number, b: number, c: number) => number;
-    readonly analyze_model_descriptor: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => [number, number, number, number];
-    readonly build_hair_gravity_curves: (a: number, b: number) => [number, number, number, number];
-    readonly build_hair_idle_curves: (a: number, b: number, c: number) => [number, number, number, number];
-    readonly build_hair_impulse_curves: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
-    readonly compile_clip: (a: number, b: number) => [number, number, number, number];
-    readonly compile_clip_curves: (a: number, b: number) => [number, number, number, number];
-    readonly compose_template_skeleton_fit_transform: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number];
-    readonly extract_model_data_json: (a: number, b: number, c: number, d: number) => [number, number, number, number];
-    readonly get_preset_json: (a: number, b: number) => [number, number, number, number];
-    readonly has_preset: (a: number, b: number) => number;
-    readonly list_presets: () => [number, number];
-    readonly merge_embedded_preset: (a: number, b: number, c: number, d: number) => [number, number, number, number];
-    readonly merge_preset_profile: (a: number, b: number, c: number, d: number) => [number, number, number, number];
-    readonly resolve_embedded_profile_view: (a: number, b: number, c: number, d: number) => [number, number, number, number];
-    readonly resolve_profile_view: (a: number, b: number) => [number, number, number, number];
-    readonly solve_axis_quaternion: (a: number, b: number, c: number, d: number) => [number, number];
-    readonly solve_bilateral_values: (a: number, b: number) => [number, number];
-    readonly solve_morph_batch: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number];
-    readonly template_skeleton_fit_transform_stride: () => number;
-    readonly validate_generated_template_fit_metadata: (a: number, b: number, c: number, d: number, e: number, f: number) => number;
-    readonly validate_humanoid_characterization: (a: number, b: number, c: number, d: number) => [number, number, number, number];
-    readonly validate_profile_model: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
-    readonly __wbg_hairphysicssolver_free: (a: number, b: number) => void;
-    readonly __wbg_nativeplaybacksession_free: (a: number, b: number) => void;
-    readonly default_hair_physics_config_values: () => [number, number];
-    readonly hair_config_stride: () => number;
-    readonly hair_head_state_stride: () => number;
-    readonly hair_morph_output_stride: () => number;
-    readonly hair_state_stride: () => number;
-    readonly hairphysicssolver_get_config: (a: number) => [number, number];
-    readonly hairphysicssolver_get_state: (a: number) => [number, number];
-    readonly hairphysicssolver_new: (a: number, b: number) => number;
-    readonly hairphysicssolver_reset: (a: number) => void;
-    readonly hairphysicssolver_set_config: (a: number, b: number, c: number) => void;
-    readonly hairphysicssolver_update: (a: number, b: number, c: number, d: number) => [number, number];
-    readonly nativeplaybacksession_control: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
-    readonly nativeplaybacksession_dispose: (a: number) => [number, number, number, number];
-    readonly nativeplaybacksession_new: () => [number, number, number];
-    readonly nativeplaybacksession_notify: (a: number, b: number, c: number) => [number, number, number, number];
-    readonly nativeplaybacksession_play: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
-    readonly nativeplaybacksession_rebind: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
-    readonly nativeplaybacksession_replace_clip: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
+    readonly analyze_mesh_proportions: (a: number, b: number, c: number) => [number, number];
+    readonly compose_template_fit_adjustment: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number];
+    readonly default_hair_color_appearance_json: () => [number, number, number, number];
+    readonly hair_color_presets_json: () => [number, number, number, number];
+    readonly marker_endpoint_stride: () => number;
+    readonly marker_visibility_animation_factors: (a: number, b: number) => [number, number];
+    readonly mesh_proportions_stride: () => number;
+    readonly normalize_hair_color_appearance_json: (a: number, b: number, c: number, d: number) => [number, number, number, number];
+    readonly passes_marker_camera_angle_gate: (a: number, b: number, c: number) => number;
+    readonly resolve_viewport_constrained_line_scale: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number];
+    readonly resolve_viewport_safe_bounds: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number];
+    readonly sample_marker_arc_curve: (a: number, b: number, c: number, d: number, e: number) => [number, number];
+    readonly sample_marker_bezier_curve: (a: number, b: number, c: number, d: number, e: number) => [number, number];
+    readonly separate_overlapping_marker_endpoints: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number];
+    readonly should_show_marker: (a: number, b: number, c: number, d: number) => number;
+    readonly solve_template_skeleton_fit: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number];
+    readonly template_skeleton_fit_solution_stride: () => number;
+    readonly marker_visibility_factors_stride: () => number;
     readonly __wbindgen_externrefs: WebAssembly.Table;
     readonly __wbindgen_malloc: (a: number, b: number) => number;
     readonly __wbindgen_free: (a: number, b: number, c: number) => void;