@lovelace_lol/embody 0.0.11 → 0.0.12

package/README.md

@@ -294,7 +294,7 @@ step/linear clip conversion, and remaining import work.
 
 `humanoid.getSpecification` exposes all 55 VRM 1.0 anatomical roles and their
 parent/required rules. CC4 maps all 55 to distinct authored bones and supplies
-58 body controls for fingers, wrists, shoulders, feet, whole body motion, the
+authored AU mappings for fingers, wrists, shoulders, feet, whole body motion, the
 spine, head, eyes and jaw. `profile.setHumanoidRoleBinding` edits or clears a role and
 retargets its existing actuators. The runtime keeps the same bone/morph evaluator;
 other rigs must author their own calibrated axes/ranges and optional muscle
@@ -525,42 +525,27 @@ the package; CI checks and publishes that same build.
 
 MIT. See [LICENSE](LICENSE) and [AUTHORS.md](AUTHORS.md).
 
-### Semantic poses and generated motion
-
-`RuntimeCore.get_semantic_pose_catalog_json()` returns the configured profile's
-motion identifiers, direction labels, VRM roles, resolved bone/morph names and
-per-direction model support and available sides. VRM names anatomy; profile motion IDs name authored
-actions. Hosts should send only supported directions to generation prompts,
-along with their bounds: intensity and morph strength `0..1`, bilateral balance
-`-1` character-left, `0` both, `1` character-right. Amounts are normalized authored
-motion, not radians or world-space rotation.
-
-`capture_semantic_pose_json()` returns `{version:1,controls:[{controlId,positive,
-negative?}]}`. Each direction stores intensity, balance and morphStrength
-independently, preserving opposed action values. These are manual runtime
-controls; capturing an arbitrary mixer/baked pose would require pose inference.
-`validate_semantic_pose_json()` fills omitted settings without mutation.
-`apply_semantic_pose_json()` validates the complete input before replacing Body
-actions, preserving unrelated facial state. Either direction may be omitted;
-a control requires at least one. Known missing outputs remain portable to partial
-rigs; unknown IDs, duplicate actions and invalid bounds fail. Applying a semantic pose releases prior direct overrides on its exact mapped
-mesh/target IDs, preserving unrelated facial overrides and same-named targets on
-unmapped meshes.
-
-`build_semantic_clip(name, animationJson, optionsJson)` compiles
-`{version:1,durationSeconds,tracks:[{controlId,direction,balance?,morphStrength?,
-keyframes:[{time,intensity}]}]}` through the same AU/bone/morph evaluator.
-Direction is `positive` or `negative`; time is seconds. Unsupported directions,
-unknown controls, duplicate actions and non-increasing/out-of-range keys fail.
-`options.faceCurves` accepts additional non-Body AU curves so face and body compile
-together, including overlapping mapped bones. Compilation preserves live state;
-per-track morph strength changes only the compiled output. The host mixer owns
-playback and interpolation, as with existing snippets.
-
-Catalog `availableSides` identifies actual mapped left/right/center outputs.
-Generated animations reject a negative balance without a left output or positive
-balance without a right output; balance zero may drive the remaining side of a
-partial rig. Stored static poses retain their portability across missing outputs.
-`evaluate_semantic_body_bone_frame()` returns exact Body-owned properties including
-neutral values, allowing an explicit semantic pose/reset to replace old raw bone
-edits without touching unrelated properties.
+### AU controls and authored animation
+
+Character controls come from the character's saved `auInfo`/`actionInfo`,
+`auToBones`, `auToMorphs`, `compositeRotations` and `continuumPairs`. There is
+no named body-control catalog or fixed control count. `engine.getAUDescriptors()`
+and initialized `getAUDescriptors(profile, modelDescriptor?)` return per-AU
+metadata and resolved output support, including labels, signed pair IDs,
+bilateral sides, saved morph strength and resolved bone/morph names.
+
+Use `setAU`/`transitionAU`, `setContinuum`, `getAUBalance` and
+`setAUMixWeight` for live controls. `buildClip`/`playSnippet` compile numeric
+AU curves through the same saved bone/morph evaluator; `balanceMap` and
+`mixWeights` are per-AU compilation options. Compilation preserves live state.
+Native playback owns interpolation, pause, resume, cancellation and blending.
+Reset an authored control by setting its mapped AU values to zero. Hosts select
+which mapped AU IDs to reset; unrelated face state and saved mix strengths remain
+under their existing owners.
+
+Named semantic pose/animation APIs and profile `bodyControls` are retired.
+Persisted named records must be decoded at the storage boundary to numeric AU
+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.

package/dist/index.js

@@ -2,7 +2,7 @@ import * as THREE3 from 'three';
 import { NoBlending, MultiplyBlending, SubtractiveBlending, AdditiveBlending, NormalBlending, Vector3, Box3, Timer, Matrix4, AnimationMixer, AdditiveAnimationBlendMode, NormalAnimationBlendMode, LoopOnce, LoopRepeat, LoopPingPong, PropertyBinding, Euler, Quaternion, AnimationUtils, InterpolateDiscrete, InterpolateLinear, MathUtils, Mesh, PlaneGeometry, ShadowMaterial, HemisphereLight, DirectionalLight, SRGBColorSpace, ACESFilmicToneMapping, WebGLRenderer, Scene, Color, PerspectiveCamera, PCFShadowMap, PCFSoftShadowMap, NumberKeyframeTrack, QuaternionKeyframeTrack, VectorKeyframeTrack, AnimationClip, PMREMGenerator, FloatType, Float32BufferAttribute, BufferAttribute, WebGPUCoordinateSystem, WebGLCoordinateSystem } from 'three';
 import { CC4_HUMANOID_SKELETON_TEMPLATE, HUMANOID_SKELETON_TEMPLATES, DEFAULT_HAIR_COLOR_APPEARANCE, initEmbodyCore, requireInitializedEmbodyCore } from '@lovelace_lol/embody/wasm';
 export * from '@lovelace_lol/embody/wasm';
-export { CC4_HUMANOID_SKELETON_TEMPLATE, DEFAULT_AXIS_TO_CHANNEL, DEFAULT_BONE_MAX_DEGREES, DEFAULT_HAIR_COLOR_APPEARANCE, HAIR_COLOR_PRESETS, HUMANOID_SKELETON_TEMPLATES, JOINT_CONTROL_SECTION, VISEME_KEYS } from '@lovelace_lol/embody/wasm';
+export { CC4_HUMANOID_SKELETON_TEMPLATE, DEFAULT_AXIS_TO_CHANNEL, DEFAULT_BONE_MAX_DEGREES, DEFAULT_HAIR_COLOR_APPEARANCE, HAIR_COLOR_PRESETS, HUMANOID_SKELETON_TEMPLATES, JOINT_CONTROL_SECTION, LEGACY_BODY_CONTROL_AUS, VISEME_KEYS, getAUDescriptors } from '@lovelace_lol/embody/wasm';
 import { OrbitControls } from 'three/examples/jsm/controls/OrbitControls.js';
 import { DRACOLoader } from 'three/examples/jsm/loaders/DRACOLoader.js';
 import { FBXLoader } from 'three/examples/jsm/loaders/FBXLoader.js';
@@ -6583,9 +6583,6 @@ var resolveContinuumDisplayLabel = (profile, negativeAuId, positiveAuId) => requ
 function inspectModel(model, meshes, profile) {
   return new ThreeModelInspector().inspectModel(model, { meshes, profile });
 }
-function getBodyControls(profile, model) {
-  return request2("profile.getBodyControls", { profile, ...model ? { model: inspectModel(model, void 0, profile).descriptor } : {} });
-}
 function extractModelData(model, meshes, animations = []) {
   const inspection = inspectModel(model, meshes);
   return JSON.parse(requireInitializedEmbodyCore().extract_model_data_json(json(inspection.descriptor), json(serializeAnimationClips(model, animations, inspection))));
@@ -7437,12 +7434,10 @@ var Embody = class _Embody {
         return parse(this.core.build_clip(source.name, json2(source.input), json2(buildOptions)));
       case "typed":
         return parse(this.core.build_typed_clip(source.name, json2(source.input), json2(buildOptions)));
-      case "semantic":
-        return parse(this.core.build_semantic_clip(source.name, json2(source.input), json2(buildOptions)));
       case "compiled":
         return source.clip;
       case "native":
-        throw new Error("Native animation sources do not require semantic compilation.");
+        throw new Error("Native animation sources do not require AU compilation.");
     }
   }
   restValues(track) {
@@ -7881,7 +7876,8 @@ var Embody = class _Embody {
     return this.handle(source, options, play);
   }
   buildClip(name, curves, options = {}) {
-    return options.semanticAnimation ? this.semanticAnimationToClip(name, options.semanticAnimation, { ...options, faceCurves: curves }) : this.build({ name, kind: "curves", input: copy(curves), options: copy(options) }, options, false);
+    if (options.semanticAnimation) throw new Error("Decode legacy named animation tracks to numeric AU curves before building a clip.");
+    return this.build({ name, kind: "curves", input: copy(curves), options: copy(options) }, options, false);
   }
   snippetToClip(name, curves, options = {}) {
     return this.buildClip(name, curves, options);
@@ -7892,9 +7888,6 @@ var Embody = class _Embody {
   typedSnippetToClip(name, channels, options = {}) {
     return this.buildTypedClip(name, channels, options);
   }
-  semanticAnimationToClip(name, animation, options = {}) {
-    return this.build({ name, kind: "semantic", input: copy(animation), options: copy(options) }, options, false);
-  }
   playSnippet(snippet, curvesOrOptions = {}, options = {}) {
     return typeof snippet === "string" ? this.buildClip(snippet, curvesOrOptions, options).play() : this.buildClip(snippet.name, snippet.curves, curvesOrOptions).play();
   }
@@ -8104,26 +8097,8 @@ var Embody = class _Embody {
   getAUBalance(id) {
     return this.core.get_au_balance(id);
   }
-  getBodyControls() {
-    return parse(this.core.get_body_controls_json());
-  }
-  getSemanticPoseCatalog() {
-    return parse(this.core.get_semantic_pose_catalog_json());
-  }
-  captureSemanticPose() {
-    return parse(this.core.capture_semantic_pose_json());
-  }
-  validateSemanticPose(pose) {
-    return parse(this.core.validate_semantic_pose_json(json2(pose)));
-  }
-  applySemanticPose(pose) {
-    this.mutateLive(() => this.core.apply_semantic_pose_json(json2(pose)));
-  }
-  validateSemanticAnimation(animation, options = {}) {
-    this.core.validate_semantic_animation_json(json2(animation), json2(options));
-  }
-  resetBodyControls() {
-    this.mutateLive(() => this.core.reset_body_controls());
+  getAUDescriptors() {
+    return parse(this.core.get_au_descriptors_json());
   }
   setContinuum(negative, positive, value, balance = NaN) {
     this.mutateLive(() => this.core.set_continuum(negative, positive, value, balance));
@@ -9984,6 +9959,6 @@ var collectMorphMeshes = (root) => {
   return meshes;
 };
 
-export { BLENDING_MODES, CHARACTER_SCENE_TYPES, CHARACTER_SCENE_TYPE_IDS, DPthreeCameraController as CameraController, CameraDOMControls, CameraDOMControls as Controls, DEFAULT_CHARACTER_LIGHTING_PRESETS, DEFAULT_CHARACTER_LIGHTING_PRESET_ID, DEFAULT_CHARACTER_LIGHTING_PRESET_IDS, DEFAULT_CHARACTER_LIGHTING_SETTINGS, DEFAULT_CHARACTER_SCENE_TYPE_ID, DEFAULT_MARKER_AUTO_HIDE_MS, DEFAULT_PREVIEW_AUTO_CLEAR_MS, DPthree, DPthree3DMarkers, DPthreeCameraController, DPthreeHTMLMarkers, DPthreeMarkers, Embody, DPthree3DMarkers as Markers3D, DPthreeHTMLMarkers as MarkersHTML, RUNTIME_ANNOTATION_REGION_PREFIX, RustAnnotationCameraCore, THREE_BLENDING_MODES, ThreeFrameApplier, ThreeModelInspector, ThreeNativePlaybackConnector, analyzeModel, applyAUBoneBindingUpdate, applyBilateralAxisBindingUpdate, applyBoneAxisBindingUpdate, applyCharacterModelTransform, bindModelReferencePose, boneResolutionProfile, buildBoneAuOptions, buildRegionDisplayOptions, captureModelReferencePose, classifyAuAsJointControl, collectMorphMeshes, computeHumanoidSkeletonTemplateRestBounds, createAnimationClipFromClipIR, createBilateralBoneAxisAu, createBoneAxisAu, createCharacterHost, createDefaultCharacterLighting, createDefaultCharacterScene, createDefaultCharacterSceneAsync, createDefaultCharacterSceneRuntime, createMarkerLifecycleRevealOptions, createMarkerVisibilityLifecycle, createRuntimeAnnotationPreviewLifecycle, createRustAnnotationCameraCore, createRustEmbodyHost, createRustEmbodyHostUnbound, createScenePlaybackFrame, createShadowPlane, createValidationSkeletonFromHumanoidTemplate, detectAnnotationLaterality, disposeCharacterModel, ensureBilateralBoneNodeKeys, ensureBoneNodeKey, extendCharacterConfigWithPreset, extendModelReferencePose, extractHumanoidSkeletonTemplateFromModel, extractModelData, extractProfileOverrides, filterCameraViewRegions, findNodeKeyForBone, formatAxisDirectionLabel, formatAxisLabel, fuzzyNameMatch, getAUBoneBindingState, getAxisFromChannel, getBilateralAxisBindingState, getBodyControls, getBoneAxisBindingState, getDefaultAnnotationLaterality, getHumanoidSkeletonTemplate, getHumanoidSkeletonTemplateBoneNames, getHumanoidSpecification, getMeshNamesForAUProfile, getModelLocalOrbitAngle, getPreset, getRuntimeAUMeshSideOffset, getRuntimeAUMorphAnchorPoint, getRuntimeAnnotationSide, getSemanticHorizontalSign, getSemanticHorizontalSignForSide, getWorldDirectionForCameraAngle, hasLeftRightMorphs, inferChiralBoneNamePair, inferEyeControlFamily, inferEyeControlScope, inferRuntimeAnnotationPreviewSide, isJointControlAuInfo, isMaxDegreesOnlyAxisBindingUpdate, isMixedAU, isRuntimeAnnotationRegionName, loadCharacterModel, mergeCharacterRegionsByName, normalizeDefaultCharacterLightingSettings, normalizeHairColorAppearance, parseCharacterModel, passesMarkerCameraAngleGate, pickContinuumAnnotationAuId, renderScenePlayback, resolveAnnotationCharacterConfig, resolveBoneAxisChannel, resolveBoneNameForNodeKey, resolveBoneNames, resolveContinuumDisplayLabel, resolveFaceCenter, resolveHumanoidCharacterization, resolveMarkerAnchorRegion, resolveRegionCameraAngle, resolveRegionVisibilityCameraAngle, resolveVisemeProfile, serializeAnimationClips, setAUMorphTargets, setHumanoidRoleBinding, shouldProjectMarkerAnchorToSurface, shouldUseFaceCenterForMarkerAnchor, stripConfiguredBoneAffixes, supportsRustEmbodyPreset, toWorldDirection, validateHumanoidCharacterization, validateMappings };
+export { BLENDING_MODES, CHARACTER_SCENE_TYPES, CHARACTER_SCENE_TYPE_IDS, DPthreeCameraController as CameraController, CameraDOMControls, CameraDOMControls as Controls, DEFAULT_CHARACTER_LIGHTING_PRESETS, DEFAULT_CHARACTER_LIGHTING_PRESET_ID, DEFAULT_CHARACTER_LIGHTING_PRESET_IDS, DEFAULT_CHARACTER_LIGHTING_SETTINGS, DEFAULT_CHARACTER_SCENE_TYPE_ID, DEFAULT_MARKER_AUTO_HIDE_MS, DEFAULT_PREVIEW_AUTO_CLEAR_MS, DPthree, DPthree3DMarkers, DPthreeCameraController, DPthreeHTMLMarkers, DPthreeMarkers, Embody, DPthree3DMarkers as Markers3D, DPthreeHTMLMarkers as MarkersHTML, RUNTIME_ANNOTATION_REGION_PREFIX, RustAnnotationCameraCore, THREE_BLENDING_MODES, ThreeFrameApplier, ThreeModelInspector, ThreeNativePlaybackConnector, analyzeModel, applyAUBoneBindingUpdate, applyBilateralAxisBindingUpdate, applyBoneAxisBindingUpdate, applyCharacterModelTransform, bindModelReferencePose, boneResolutionProfile, buildBoneAuOptions, buildRegionDisplayOptions, captureModelReferencePose, classifyAuAsJointControl, collectMorphMeshes, computeHumanoidSkeletonTemplateRestBounds, createAnimationClipFromClipIR, createBilateralBoneAxisAu, createBoneAxisAu, createCharacterHost, createDefaultCharacterLighting, createDefaultCharacterScene, createDefaultCharacterSceneAsync, createDefaultCharacterSceneRuntime, createMarkerLifecycleRevealOptions, createMarkerVisibilityLifecycle, createRuntimeAnnotationPreviewLifecycle, createRustAnnotationCameraCore, createRustEmbodyHost, createRustEmbodyHostUnbound, createScenePlaybackFrame, createShadowPlane, createValidationSkeletonFromHumanoidTemplate, detectAnnotationLaterality, disposeCharacterModel, ensureBilateralBoneNodeKeys, ensureBoneNodeKey, extendCharacterConfigWithPreset, extendModelReferencePose, extractHumanoidSkeletonTemplateFromModel, extractModelData, extractProfileOverrides, filterCameraViewRegions, findNodeKeyForBone, formatAxisDirectionLabel, formatAxisLabel, fuzzyNameMatch, getAUBoneBindingState, getAxisFromChannel, getBilateralAxisBindingState, getBoneAxisBindingState, getDefaultAnnotationLaterality, getHumanoidSkeletonTemplate, getHumanoidSkeletonTemplateBoneNames, getHumanoidSpecification, getMeshNamesForAUProfile, getModelLocalOrbitAngle, getPreset, getRuntimeAUMeshSideOffset, getRuntimeAUMorphAnchorPoint, getRuntimeAnnotationSide, getSemanticHorizontalSign, getSemanticHorizontalSignForSide, getWorldDirectionForCameraAngle, hasLeftRightMorphs, inferChiralBoneNamePair, inferEyeControlFamily, inferEyeControlScope, inferRuntimeAnnotationPreviewSide, isJointControlAuInfo, isMaxDegreesOnlyAxisBindingUpdate, isMixedAU, isRuntimeAnnotationRegionName, loadCharacterModel, mergeCharacterRegionsByName, normalizeDefaultCharacterLightingSettings, normalizeHairColorAppearance, parseCharacterModel, passesMarkerCameraAngleGate, pickContinuumAnnotationAuId, renderScenePlayback, resolveAnnotationCharacterConfig, resolveBoneAxisChannel, resolveBoneNameForNodeKey, resolveBoneNames, resolveContinuumDisplayLabel, resolveFaceCenter, resolveHumanoidCharacterization, resolveMarkerAnchorRegion, resolveRegionCameraAngle, resolveRegionVisibilityCameraAngle, resolveVisemeProfile, serializeAnimationClips, setAUMorphTargets, setHumanoidRoleBinding, shouldProjectMarkerAnchorToSurface, shouldUseFaceCenterForMarkerAnchor, stripConfiguredBoneAffixes, supportsRustEmbodyPreset, toWorldDirection, validateHumanoidCharacterization, validateMappings };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map