@lovelace_lol/embody 0.0.13 → 0.0.14

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lovelace_lol/embody",
-  "version": "0.0.13",
+  "version": "0.0.14",
   "description": "Renderer-agnostic character animation runtime for facial AUs, visemes, and bone-driven motion",
   "type": "module",
   "main": "./dist/index.js",
@@ -92,5 +92,5 @@
   "author": "Jonathan Sutton Fields",
   "license": "MIT",
   "packageManager": "npm@10.9.2",
-  "gitHead": "a8c82e1fabcac27ca5a132ef21440b939873af4f"
+  "gitHead": "1f88a30576b4be1f078d818d5b01d6d9eab000fc"
 }

package/dist/three/annotations/DPthree3DMarkers.d.ts

@@ -1,320 +0,0 @@
-import * as THREE from 'three';
-import type { Region, CharacterConfig, MarkerStyleOverrides, LineConfig, ExpandAnimation, ExpandedRegionState } from './types';
-interface MarkerConfig {
-    markerRadius?: number;
-    markerColor?: number;
-    lineColor?: number;
-    lineLength?: number;
-    labelColor?: string;
-    labelBackground?: string;
-    labelFontSize?: number;
-    labelScale?: number;
-}
-export declare function shouldShow3DMarker(params: {
-    name: string;
-    hiddenChildren: Set<string>;
-    soloedMarker: string | null;
-    markerAngle?: number;
-    currentCameraAngle?: number;
-}): boolean;
-export declare function resolveViewportConstrainedLineScale(params: {
-    startClip: THREE.Vector4;
-    endClip: THREE.Vector4;
-    safeX: number;
-    safeY: number;
-    minLengthRatio?: number;
-}): {
-    visible: boolean;
-    lineScale: number;
-};
-export declare function resolveViewportSafeBounds(params: {
-    labelScaleX: number;
-    labelScaleY: number;
-    projectionXScale: number;
-    projectionYScale: number;
-    viewportWidth: number;
-    viewportHeight: number;
-    edgePaddingPx?: number;
-}): {
-    safeX: number;
-    safeY: number;
-};
-/**
- * Pure 3D visual markers for annotations.
- *
- * SIMPLE RULE: Lines always point AWAY from model center.
- * - Horizontal: left annotations go left, right go right
- * - Vertical: high annotations go up, low go down
- */
-export declare class DPthree3DMarkers {
-    private scene;
-    private camera;
-    private domElement;
-    private model;
-    private regions;
-    private currentRegion;
-    private onSelect;
-    private config;
-    private markerGroup;
-    private markerMeshes;
-    private lineMeshes;
-    private lineEndpoints;
-    private labelSprites;
-    private labelScales;
-    private originalLineLengths;
-    private boneRefs;
-    private localOffsets;
-    private modelCenter;
-    private modelSize;
-    private modelMeshes;
-    private regionLoadHasFreshMatrices;
-    private isZoomedIn;
-    private zoomThreshold;
-    private autoCollapseThreshold;
-    private lastCameraDistance;
-    private markerLayoutDirty;
-    private visibilityAnimationActive;
-    private readonly visibilityAnimationScheduler;
-    private visibilityAnimationStates;
-    private activeMarkerVisibilityAnimations;
-    private markerVisibilityAnimationStates;
-    private markerTargetVisibility;
-    private markerAngleGateVisibility;
-    private markerViewportVisibility;
-    private hasCameraAngleUpdateSnapshot;
-    private lastCameraAngleUpdatePosition;
-    private lastCameraAngleUpdateQuaternion;
-    private raycaster;
-    private mouse;
-    private scratchClipStart;
-    private scratchClipEnd;
-    private readonly scratchClipStartValues;
-    private readonly scratchClipEndValues;
-    private scratchWorldEnd;
-    private scratchConstrainedEnd;
-    private tempSurfacePoint;
-    private scratchArrowDirection;
-    private scratchArrowQuaternion;
-    private arrowUp;
-    private charLineDefaults;
-    private charMarkerDefaults;
-    private resolvedStyles;
-    private expandedRegions;
-    private parentChildIndex;
-    private childParentIndex;
-    private hiddenChildren;
-    private soloedMarker;
-    private markerGroups;
-    private groupVisibility;
-    private arrowMeshes;
-    private characterConfig;
-    private laterality;
-    private regionLoadGeneration;
-    constructor(inputConfig: {
-        scene: THREE.Scene;
-        camera: THREE.PerspectiveCamera;
-        domElement: HTMLElement;
-        onSelect: (name: string) => void;
-        markerConfig?: MarkerConfig;
-    });
-    /** Preserve marker state while a scene replaces its renderer canvas. */
-    setDomElement(element: HTMLElement): void;
-    setModel(model: THREE.Object3D): void;
-    loadRegions(config: CharacterConfig, options?: {
-        sliceSurfaceQueries?: boolean;
-    }): Promise<void>;
-    /**
-     * Update a region's configuration and recreate its marker.
-     * This is the general method for updating any region properties.
-     *
-     * @param regionName - Name of the region to update
-     * @param update - Partial region config to merge with existing config
-     */
-    updateRegion(regionName: string, update: Partial<Region>): void;
-    removeRegion(regionName: string): void;
-    /**
-     * Remove all marker components for a region (marker, line, label, bone refs)
-     */
-    private removeMarkerComponents;
-    updateRegionMeshes(regionName: string, meshNames: string[]): void;
-    /**
-     * Reposition an existing marker to a new position.
-     * This moves the marker, line, and label without recreating them.
-     *
-     * @param regionName - Name of the region to reposition
-     * @param newPosition - New world position for the marker
-     */
-    repositionMarker(regionName: string, newPosition: THREE.Vector3): void;
-    /**
-     * Get the current position of a marker
-     */
-    getMarkerPosition(regionName: string): THREE.Vector3 | null;
-    /**
-     * Resolve the effective style for a region by merging:
-     * global defaults -> character defaults -> region style
-     */
-    private resolveRegionStyle;
-    /**
-     * Resolve a named direction or custom vector to a THREE.Vector3.
-     * For 'camera' direction, returns direction from position toward current camera.
-     */
-    private resolveLineDirection;
-    /**
-     * Create a bezier curve between two points.
-     */
-    private createBezierCurve;
-    /**
-     * Create an arc curve between two points.
-     */
-    private createArcCurve;
-    private unpackCurvePoints;
-    /**
-     * Create a styled line with support for dashed/dotted, curves, and arrow heads.
-     */
-    private createStyledLine;
-    /**
-     * Create an arrow head cone mesh.
-     */
-    private createArrowHead;
-    setCurrentRegion(name: string | null): void;
-    /**
-     * Create a marker for an annotation.
-     *
-     * Algorithm:
-     * 1. Find annotation center from bones/meshes
-     * 2. Determine best outward direction based on annotation type, cameraAngle, or style.lineDirection
-     * 3. Raycast from outside toward annotation center to find surface point
-     * 4. Line extends outward from surface with configured styling
-     *
-     */
-    private resolveMarkerPlacement;
-    private createMarker;
-    private createMarkerInSlices;
-    private renderMarker;
-    /**
-     * Embody Rust owns endpoint layout; the Three adapter applies the returned positions
-     * to its Three.js marker geometry and labels.
-     */
-    private separateOverlappingMarkers;
-    /**
-     * Determine the outward direction for marker placement based on annotation type.
-     *
-     * This uses semantic knowledge about body parts:
-     * - Face/eyes/mouth: forward (positive Z)
-     * - Back: backward (negative Z)
-     * - Left/right parts: semantic side, resolved against model laterality
-     * - Feet: down (negative Y)
-     * - If cameraAngle is specified, use that angle
-     * - Default: direction from model center to annotation center
-     */
-    private getOutwardDirection;
-    /**
-     * Find surface point by raycasting from OUTSIDE toward the annotation center.
-     * This ensures we hit the outer surface facing the outward direction.
-     */
-    private findSurfacePoint;
-    private findSurfacePointInSlices;
-    private getSuffixPattern;
-    /**
-     * Get center point and bounding box of annotation's bones/meshes.
-     * Uses fuzzy matching to handle bone names with numeric suffixes.
-     */
-    private getRegionCenterAndBox;
-    private formatLabelText;
-    private buildLabelTexture;
-    private createLabelSprite;
-    private updateLabelSprite;
-    private updateMarkerStyles;
-    private getResolvedLineConfig;
-    private getViewportSafeBounds;
-    private updateMarkerGeometry;
-    private updateMarkerLineLayout;
-    private onClick;
-    /**
-     * Update marker positions to follow animated bones.
-     * Uses stored bone references and local offsets for efficiency.
-     */
-    private updateMarkerPositions;
-    /**
-     * Find the primary bone for a region (for animation tracking).
-     */
-    private findPrimaryBone;
-    /**
-     * Per-frame update: distance-based scaling + explicit cameraAngle visibility.
-     * Markers scale continuously with camera distance to maintain consistent screen size.
-     * Occlusion is handled by the GPU via depth testing (depthTest: true).
-     */
-    update(): void;
-    private refreshLaterality;
-    /**
-     * Apply zoom-based scaling to all markers, lines, and labels.
-     * Runs on zoom threshold crossings and when marker geometry changes.
-     */
-    private applyZoomScale;
-    setVisible(visible: boolean): void;
-    private readObjectOpacity;
-    private setObjectOpacity;
-    private captureVisibilityAnimationStates;
-    private getVisibilityAnimationFactors;
-    private applyVisibilityAnimationStates;
-    private restoreVisibilityAnimationStates;
-    private stopAllMarkerVisibilityAnimations;
-    private stopMarkerVisibilityAnimation;
-    private getMarkerTargetVisibility;
-    private setMarkerObjectsVisible;
-    private getMarkerFallbackOpacity;
-    private getMarkerBaseLabelScale;
-    private captureMarkerVisibilityAnimationState;
-    private animateMarkerVisibility;
-    private stopVisibilityAnimation;
-    private animateVisibility;
-    clear(): void;
-    /**
-     * Solo a specific marker - hide all others.
-     * Pass null to unsolo.
-     */
-    setSoloMarker(regionName: string | null): void;
-    /**
-     * Get currently soloed marker name.
-     */
-    getSoloedMarker(): string | null;
-    /**
-     * Expand a parent region to show its children.
-     */
-    expandRegion(regionName: string, animation?: ExpandAnimation, duration?: number): Promise<void>;
-    /**
-     * Collapse a parent region to hide its children.
-     */
-    collapseRegion(regionName: string, duration?: number): Promise<void>;
-    /**
-     * Toggle expand/collapse state.
-     */
-    toggleRegion(regionName: string, animation?: ExpandAnimation, duration?: number): void;
-    /**
-     * Get expanded state of all regions.
-     */
-    getExpandedRegions(): ExpandedRegionState[];
-    /**
-     * Collapse all currently expanded regions.
-     * Called automatically when zooming out past threshold.
-     */
-    private collapseAllRegions;
-    /**
-     * Animate a child marker in place using the same visibility curve as regular markers.
-     */
-    private animateMarkerIn;
-    /**
-     * Animate a child marker out in place using the same visibility curve as regular markers.
-     */
-    private animateMarkerOut;
-    /**
-     * Update line style for a specific region at runtime.
-     */
-    updateLineStyle(regionName: string, lineConfig: Partial<LineConfig>): void;
-    /**
-     * Update marker style for a specific region at runtime.
-     */
-    updateMarkerStyle(regionName: string, styleOverrides: Partial<MarkerStyleOverrides>): void;
-    dispose(): void;
-}
-export {};