@holoscript/core 8.0.8 → 8.0.9

package/dist/{chunk-Q2Q34NF3.js → chunk-77QI552M.js}

@@ -1,7 +1,7 @@
-import { init_CompilerBase, CompilerBase, escapeStringValue } from './chunk-C7ZBSV2Q.js';
-import { init_roomplan, init_lidar_scanner, init_face_tracking, init_ios_object_capture, init_shareplay, init_uwb_positioning, init_airpods_spatial_audio, ROOMPLAN_TRAITS, LIDAR_SCANNER_TRAITS, IOS_OBJECT_CAPTURE_TRAITS, FACE_TRACKING_TRAITS, SHAREPLAY_TRAITS, UWB_POSITIONING_TRAITS, AIRPODS_SPATIAL_AUDIO_TRAITS } from './chunk-SIEXCILW.js';
-import { init_npu_scene, init_portal_ar, init_camera_hand_tracking, NPU_SCENE_TRAITS, NPU_SCENE_DEFAULTS, PORTAL_AR_TRAITS, CAMERA_HAND_TRACKING_TRAITS } from './chunk-CBJY23VL.js';
-import { __esm, __export } from './chunk-OL46QLBJ.js';
+import { init_CompilerBase, CompilerBase, escapeStringValue } from './chunk-DUG3OQAS.js';
+import { init_roomplan, init_lidar_scanner, init_face_tracking, init_ios_object_capture, init_shareplay, init_uwb_positioning, init_airpods_spatial_audio, ROOMPLAN_TRAITS, LIDAR_SCANNER_TRAITS, IOS_OBJECT_CAPTURE_TRAITS, FACE_TRACKING_TRAITS, SHAREPLAY_TRAITS, UWB_POSITIONING_TRAITS, AIRPODS_SPATIAL_AUDIO_TRAITS } from './chunk-2I3XAGMF.js';
+import { init_npu_scene, init_portal_ar, init_camera_hand_tracking, NPU_SCENE_TRAITS, NPU_SCENE_DEFAULTS, PORTAL_AR_TRAITS, CAMERA_HAND_TRACKING_TRAITS } from './chunk-MD4IVS42.js';
+import { __esm, __export } from './chunk-W4GABFCR.js';
 import { ANSCapabilityPath } from '@holoscript/core-types/ans';
 
 // src/compiler/IOSARGenerators.ts
@@ -5419,5 +5419,5 @@ var init_IOSCompiler = __esm({
 });
 
 export { IOSCompiler, IOSCompiler_exports, compileToIOS, init_IOSCompiler };
-//# sourceMappingURL=chunk-Q2Q34NF3.js.map
-//# sourceMappingURL=chunk-Q2Q34NF3.js.map
+//# sourceMappingURL=chunk-77QI552M.js.map
+//# sourceMappingURL=chunk-77QI552M.js.map

package/dist/{chunk-WKX5AMOY.js → chunk-7I74JWPW.js}

@@ -1,4 +1,4 @@
-import { __esm } from './chunk-OL46QLBJ.js';
+import { __esm } from './chunk-W4GABFCR.js';
 
 // src/traits/constants/mobile/geospatial.ts
 var GEOSPATIAL_ARCORE_TRAITS, GEOSPATIAL_DEFAULTS;
@@ -305,5 +305,5 @@ var init_depth_scanner = __esm({
 });
 
 export { DEPTH_SCANNER_DEFAULTS, DEPTH_SCANNER_TRAITS, FOLDABLE_DISPLAY_TRAITS, GEOSPATIAL_ARCORE_TRAITS, GEOSPATIAL_DEFAULTS, GOOGLE_LENS_TRAITS, HAPTIC_FEEDBACK_TRAITS, NEARBY_CONNECTIONS_TRAITS, SAMSUNG_DEX_TRAITS, SPATIAL_AUTHORING_DEFAULTS, SPATIAL_AUTHORING_TRAITS, WEBXR_TRAITS, init_depth_scanner, init_foldable_display, init_geospatial, init_google_lens, init_haptic_feedback, init_nearby_connections, init_samsung_dex, init_spatial_authoring, init_webxr };
-//# sourceMappingURL=chunk-WKX5AMOY.js.map
-//# sourceMappingURL=chunk-WKX5AMOY.js.map
+//# sourceMappingURL=chunk-7I74JWPW.js.map
+//# sourceMappingURL=chunk-7I74JWPW.js.map

package/dist/{chunk-5FSKKMR7.cjs → chunk-7IDJDMPU.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkHCCQLAA4_cjs = require('./chunk-HCCQLAA4.cjs');
+var chunkZHPMP447_cjs = require('./chunk-ZHPMP447.cjs');
 
 // src/traitDocs/traitDocs.ts
 function getTraitDoc(name) {
@@ -117,7 +117,7 @@ function formatTraitDocCompact(doc) {
   return lines.join("\n");
 }
 exports.TRAIT_DOCS = void 0;
-var init_traitDocs = chunkHCCQLAA4_cjs.__esm({
+var init_traitDocs = chunkZHPMP447_cjs.__esm({
   "src/traitDocs/traitDocs.ts"() {
     exports.TRAIT_DOCS = {
       // ============================================================================
@@ -508,6 +508,107 @@ orb character {
 }`,
         since: "1.3.0"
       },
+      motion_source: {
+        name: "MotionSourceTrait",
+        annotation: "@motion_source",
+        description: "Declares where an embodied agent\u2019s body motion comes from \u2014 a motion library (e.g. Mixamo/MotionBricks), live mocap, procedural locomotion, or AI agent intent \u2014 and routes the resolved clip into the node\u2019s @animation pipeline and @avatar_embodiment state. Wires motion libraries into clip playback and retargeting without re-implementing either.",
+        category: "animation",
+        properties: [
+          {
+            name: "kind",
+            type: '"library" | "mocap" | "procedural" | "agent_intent"',
+            description: "Where body motion originates.",
+            default: '"library"'
+          },
+          {
+            name: "library",
+            type: "string",
+            description: 'Named motion library, e.g. "mixamo" / "motionbricks".'
+          },
+          {
+            name: "catalog",
+            type: "Record<string, string | { asset, duration?, loop?, speed? }>",
+            description: "Intent \u2192 clip mapping. Intent names double as AnimationTrait clip/state names."
+          },
+          {
+            name: "default_motion",
+            type: "string",
+            description: "Motion played on attach.",
+            default: '"idle"'
+          },
+          {
+            name: "blend",
+            type: "number",
+            description: "Crossfade duration in seconds when switching motion.",
+            default: "0.25"
+          },
+          {
+            name: "frequency",
+            type: "number",
+            description: "Procedural re-evaluation rate (Hz).",
+            default: "30"
+          },
+          {
+            name: "retarget",
+            type: "{ skeleton?, scale?, preset? }",
+            description: "Declarative skeleton-retarget descriptor consumed by the asset pipeline / MixamoIntegration."
+          },
+          {
+            name: "procedural",
+            type: "{ speed_param?, thresholds?, clips? }",
+            description: 'Speed-driven gait selection (idle/walk/run) for kind: "procedural".'
+          },
+          {
+            name: "autoplay",
+            type: "boolean",
+            description: "Auto-play the default motion on attach.",
+            default: "true"
+          }
+        ],
+        methods: [],
+        events: [
+          {
+            name: "on_motion_source_ready",
+            description: "Emitted on attach once the catalog is registered.",
+            payload: "{ node, kind, library, motions }"
+          },
+          {
+            name: "on_motion_changed",
+            description: "Emitted when the active motion changes.",
+            payload: "{ node, motion, applied }"
+          },
+          {
+            name: "motion_request",
+            description: "Consumed: request a motion by intent/clip name.",
+            payload: "{ intent | motion | clip }"
+          },
+          {
+            name: "motion_speed",
+            description: "Consumed: update the speed signal driving procedural gait.",
+            payload: "{ speed }"
+          },
+          {
+            name: "motion_stop",
+            description: "Consumed: stop the active motion.",
+            payload: "{}"
+          }
+        ],
+        example: `@avatar_embodiment({ tracking_source: "ai", ik_mode: "full_body" })
+@animation({})
+@motion_source({
+  kind: "library",
+  library: "mixamo",
+  default_motion: "idle",
+  blend: 0.25,
+  catalog: {
+    idle: { asset: "idle.fbx", loop: true },
+    wave: { asset: "wave.fbx", loop: false, duration: 1.2 },
+    walk: { asset: "walk.fbx", loop: true }
+  },
+  retarget: { skeleton: "mixamo", scale: 1.0 }
+})
+orb agent_body {}`
+      },
       skeleton: {
         name: "SkeletonTrait",
         annotation: "@skeleton",
@@ -2077,6 +2178,133 @@ on @hololand.player_joined(player) {
   spawn_particles("welcome", player.position)
 }`,
         since: "2.0.0"
+      },
+      // ============================================================================
+      // Fabric / Cloth Animation Traits
+      // ============================================================================
+      woven_animation: {
+        name: "WovenAnimationTrait",
+        annotation: "@woven_animation",
+        description: 'Procedurally animates the active weaving process on a tapestry or cloth object. Drives weft-thread advancement row by row, shuttle movement, growing completion percentage, and warp thread tension variance \u2014 enabling "in-progress artwork" scenes without custom animation scripting. Designed to compose with @tapestry (cloth physics/drape) and @cloth_simulation.',
+        category: "animation",
+        properties: [
+          {
+            name: "weft_speed_mm_per_s",
+            type: "number",
+            description: "Rate at which the weft thread advances across the warp, in millimetres per second of simulated weaving. Controls how quickly new rows appear.",
+            default: "12.0"
+          },
+          {
+            name: "completion_pct",
+            type: "number",
+            description: "Initial woven completion as a percentage (0\u2013100). Determines how much of the tapestry surface is pre-filled at scene start. Animates toward 100 over time.",
+            default: "0"
+          },
+          {
+            name: "shuttle_visible",
+            type: "boolean",
+            description: "When true, a procedural shuttle mesh is rendered traversing the shed opening with each weft pass.",
+            default: "true"
+          },
+          {
+            name: "warp_tension_variance",
+            type: "number",
+            description: "Amplitude of per-warp-thread tension noise (0\u20131). At 0 all threads are uniformly taut; at 1 threads exhibit visible sag variation typical of hand-loomed cloth.",
+            default: "0.15"
+          },
+          {
+            name: "advance_direction",
+            type: '"bottom_up" | "top_down"',
+            description: "Direction the woven region expands \u2014 bottom_up (traditional floor-loom, cloth grows upward) or top_down (tapestry/frame-loom, cloth grows downward).",
+            default: '"bottom_up"'
+          },
+          {
+            name: "thread_material_override",
+            type: "string | null",
+            description: "Asset reference to a material applied to in-flight weft threads. When null, inherits the parent tapestry material.",
+            default: "null"
+          },
+          {
+            name: "rows_per_beat",
+            type: "number",
+            description: "Number of weft rows inserted per animation beat (one shuttle pass = one beat). Higher values produce denser cloth faster.",
+            default: "1"
+          },
+          {
+            name: "shed_open_angle_deg",
+            type: "number",
+            description: "Angle in degrees by which alternate warp threads open to create the shed for the shuttle. Affects visible separation between warp sets during the pass.",
+            default: "18",
+            range: [5, 45]
+          }
+        ],
+        methods: [
+          {
+            name: "setCompletion",
+            signature: "setCompletion(pct: number): void",
+            description: "Jump the woven completion to an arbitrary percentage without animating.",
+            parameters: [
+              {
+                name: "pct",
+                type: "number",
+                description: "Target completion percentage (0\u2013100)"
+              }
+            ]
+          },
+          {
+            name: "pause",
+            signature: "pause(): void",
+            description: "Pause the weaving animation, freezing the shuttle mid-pass.",
+            parameters: []
+          },
+          {
+            name: "resume",
+            signature: "resume(): void",
+            description: "Resume the weaving animation from where it was paused.",
+            parameters: []
+          },
+          {
+            name: "getCompletion",
+            signature: "getCompletion(): number",
+            description: "Return the current woven completion percentage.",
+            parameters: [],
+            returns: "number"
+          }
+        ],
+        events: [
+          {
+            name: "onRowComplete",
+            description: "Fired each time a weft row is fully woven.",
+            payload: "{ row: number, completion_pct: number }"
+          },
+          {
+            name: "onWeavingComplete",
+            description: "Fired when completion_pct reaches 100.",
+            payload: "{ total_rows: number, elapsed_s: number }"
+          },
+          {
+            name: "onShuttlePass",
+            description: "Fired at the start and end of each shuttle traversal.",
+            payload: '{ direction: "left_to_right" | "right_to_left", row: number }'
+          }
+        ],
+        example: `@tapestry({ weave_pattern: "twill", width_m: 1.2, height_m: 1.8 })
+@woven_animation({
+  weft_speed_mm_per_s: 20,
+  completion_pct: 0,
+  shuttle_visible: true,
+  warp_tension_variance: 0.2,
+  advance_direction: "bottom_up",
+  thread_material_override: "assets/golden_thread.mat"
+})
+orb rune_loom_tapestry {
+  position: [0, 1, -2]
+  on_weaving_complete: {
+    play_sound: "loom_done.mp3"
+    spawn_effect: "completion_sparkle"
+  }
+}`,
+        since: "6.2.0"
       }
     };
   }
@@ -2088,5 +2316,5 @@ exports.getAllTraitNames = getAllTraitNames;
 exports.getTraitDoc = getTraitDoc;
 exports.getTraitsByCategory = getTraitsByCategory;
 exports.init_traitDocs = init_traitDocs;
-//# sourceMappingURL=chunk-5FSKKMR7.cjs.map
-//# sourceMappingURL=chunk-5FSKKMR7.cjs.map
+//# sourceMappingURL=chunk-7IDJDMPU.cjs.map
+//# sourceMappingURL=chunk-7IDJDMPU.cjs.map