@holoscript/core 8.0.8 → 8.0.9

package/dist/{chunk-DTGBOSEM.cjs → chunk-AWXFEAQL.cjs}

@@ -1,10 +1,10 @@
 'use strict';
 
-var chunkHCCQLAA4_cjs = require('./chunk-HCCQLAA4.cjs');
+var chunkZHPMP447_cjs = require('./chunk-ZHPMP447.cjs');
 
 // src/traits/constants/mobile/geospatial.ts
 exports.GEOSPATIAL_ARCORE_TRAITS = void 0; exports.GEOSPATIAL_DEFAULTS = void 0;
-var init_geospatial = chunkHCCQLAA4_cjs.__esm({
+var init_geospatial = chunkZHPMP447_cjs.__esm({
   "src/traits/constants/mobile/geospatial.ts"() {
     exports.GEOSPATIAL_ARCORE_TRAITS = [
       // --- VPS Core ---
@@ -60,7 +60,7 @@ var init_geospatial = chunkHCCQLAA4_cjs.__esm({
 
 // src/traits/constants/mobile/spatial-authoring.ts
 exports.SPATIAL_AUTHORING_TRAITS = void 0; exports.SPATIAL_AUTHORING_DEFAULTS = void 0;
-var init_spatial_authoring = chunkHCCQLAA4_cjs.__esm({
+var init_spatial_authoring = chunkZHPMP447_cjs.__esm({
   "src/traits/constants/mobile/spatial-authoring.ts"() {
     exports.SPATIAL_AUTHORING_TRAITS = [
       // --- Gyro Placement ---
@@ -98,7 +98,7 @@ var init_spatial_authoring = chunkHCCQLAA4_cjs.__esm({
 
 // src/traits/constants/mobile/haptic-feedback.ts
 exports.HAPTIC_FEEDBACK_TRAITS = void 0;
-var init_haptic_feedback = chunkHCCQLAA4_cjs.__esm({
+var init_haptic_feedback = chunkZHPMP447_cjs.__esm({
   "src/traits/constants/mobile/haptic-feedback.ts"() {
     exports.HAPTIC_FEEDBACK_TRAITS = [
       // --- Interaction ---
@@ -132,7 +132,7 @@ var init_haptic_feedback = chunkHCCQLAA4_cjs.__esm({
 
 // src/traits/constants/mobile/nearby-connections.ts
 exports.NEARBY_CONNECTIONS_TRAITS = void 0;
-var init_nearby_connections = chunkHCCQLAA4_cjs.__esm({
+var init_nearby_connections = chunkZHPMP447_cjs.__esm({
   "src/traits/constants/mobile/nearby-connections.ts"() {
     exports.NEARBY_CONNECTIONS_TRAITS = [
       // --- Discovery ---
@@ -162,7 +162,7 @@ var init_nearby_connections = chunkHCCQLAA4_cjs.__esm({
 
 // src/traits/constants/mobile/foldable-display.ts
 exports.FOLDABLE_DISPLAY_TRAITS = void 0;
-var init_foldable_display = chunkHCCQLAA4_cjs.__esm({
+var init_foldable_display = chunkZHPMP447_cjs.__esm({
   "src/traits/constants/mobile/foldable-display.ts"() {
     exports.FOLDABLE_DISPLAY_TRAITS = [
       "foldable_detect",
@@ -183,7 +183,7 @@ var init_foldable_display = chunkHCCQLAA4_cjs.__esm({
 
 // src/traits/constants/mobile/samsung-dex.ts
 exports.SAMSUNG_DEX_TRAITS = void 0;
-var init_samsung_dex = chunkHCCQLAA4_cjs.__esm({
+var init_samsung_dex = chunkZHPMP447_cjs.__esm({
   "src/traits/constants/mobile/samsung-dex.ts"() {
     exports.SAMSUNG_DEX_TRAITS = [
       "dex_detect",
@@ -202,7 +202,7 @@ var init_samsung_dex = chunkHCCQLAA4_cjs.__esm({
 
 // src/traits/constants/mobile/webxr.ts
 exports.WEBXR_TRAITS = void 0;
-var init_webxr = chunkHCCQLAA4_cjs.__esm({
+var init_webxr = chunkZHPMP447_cjs.__esm({
   "src/traits/constants/mobile/webxr.ts"() {
     exports.WEBXR_TRAITS = [
       // --- Session ---
@@ -236,7 +236,7 @@ var init_webxr = chunkHCCQLAA4_cjs.__esm({
 
 // src/traits/constants/mobile/google-lens.ts
 exports.GOOGLE_LENS_TRAITS = void 0;
-var init_google_lens = chunkHCCQLAA4_cjs.__esm({
+var init_google_lens = chunkZHPMP447_cjs.__esm({
   "src/traits/constants/mobile/google-lens.ts"() {
     exports.GOOGLE_LENS_TRAITS = [
       "lens_recognize",
@@ -259,7 +259,7 @@ var init_google_lens = chunkHCCQLAA4_cjs.__esm({
 
 // src/traits/constants/mobile/depth-scanner.ts
 exports.DEPTH_SCANNER_TRAITS = void 0; exports.DEPTH_SCANNER_DEFAULTS = void 0;
-var init_depth_scanner = chunkHCCQLAA4_cjs.__esm({
+var init_depth_scanner = chunkZHPMP447_cjs.__esm({
   "src/traits/constants/mobile/depth-scanner.ts"() {
     exports.DEPTH_SCANNER_TRAITS = [
       // --- Core ---
@@ -315,5 +315,5 @@ exports.init_nearby_connections = init_nearby_connections;
 exports.init_samsung_dex = init_samsung_dex;
 exports.init_spatial_authoring = init_spatial_authoring;
 exports.init_webxr = init_webxr;
-//# sourceMappingURL=chunk-DTGBOSEM.cjs.map
-//# sourceMappingURL=chunk-DTGBOSEM.cjs.map
+//# sourceMappingURL=chunk-AWXFEAQL.cjs.map
+//# sourceMappingURL=chunk-AWXFEAQL.cjs.map

package/dist/{chunk-THCK6ECW.js → chunk-B3CWTCK2.js}

@@ -1,4 +1,4 @@
-import { __esm } from './chunk-OL46QLBJ.js';
+import { __esm } from './chunk-W4GABFCR.js';
 
 // src/traitDocs/traitDocs.ts
 function getTraitDoc(name) {
@@ -506,6 +506,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",
@@ -2075,11 +2176,138 @@ 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"
       }
     };
   }
 });
 
 export { TRAIT_DOCS, formatTraitDocAsMarkdown, formatTraitDocCompact, getAllTraitNames, getTraitDoc, getTraitsByCategory, init_traitDocs };
-//# sourceMappingURL=chunk-THCK6ECW.js.map
-//# sourceMappingURL=chunk-THCK6ECW.js.map
+//# sourceMappingURL=chunk-B3CWTCK2.js.map
+//# sourceMappingURL=chunk-B3CWTCK2.js.map