@holoscript/core 8.0.8 → 8.0.10

package/dist/chunk-GGR7QUKK.cjs

@@ -0,0 +1,4724 @@
+'use strict';
+
+var chunkKROXXBK5_cjs = require('./chunk-KROXXBK5.cjs');
+var chunkYKY2JBER_cjs = require('./chunk-YKY2JBER.cjs');
+var chunkQQFB4RT2_cjs = require('./chunk-QQFB4RT2.cjs');
+var chunkENZCIQZC_cjs = require('./chunk-ENZCIQZC.cjs');
+var chunkV6GXFSK7_cjs = require('./chunk-V6GXFSK7.cjs');
+var chunkTZCFKZ6Z_cjs = require('./chunk-TZCFKZ6Z.cjs');
+var chunkQEDMOGF3_cjs = require('./chunk-QEDMOGF3.cjs');
+var chunkVHORVGCG_cjs = require('./chunk-VHORVGCG.cjs');
+var chunkZK7KX5CD_cjs = require('./chunk-ZK7KX5CD.cjs');
+var chunkHCX4SMFK_cjs = require('./chunk-HCX4SMFK.cjs');
+
+// src/compiler/SceneIRCompiler.ts
+chunkVHORVGCG_cjs.init_PerceptualColorPass();
+
+// src/traits/visual/presets/hologram-media.visual.ts
+var HOLOGRAM_MEDIA_VISUALS = {
+  depth_estimation: {
+    material: { roughness: 0.3 },
+    emissive: { color: "#6644FF", intensity: 0.2 },
+    tags: ["ai", "depth", "hologram"],
+    layer: "visual_effect"
+  },
+  displacement: {
+    material: { roughness: 0.4 },
+    emissive: { color: "#8866FF", intensity: 0.15 },
+    tags: ["3d", "depth", "mesh"],
+    layer: "visual_effect"
+  },
+  segment: {
+    material: { roughness: 0.3 },
+    emissive: { color: "#FF44AA", intensity: 0.15 },
+    tags: ["ai", "segmentation", "mask"],
+    layer: "visual_effect"
+  },
+  animated_texture: {
+    material: { roughness: 0.3 },
+    emissive: { color: "#44FFAA", intensity: 0.15 },
+    tags: ["animation", "texture", "gif"],
+    layer: "visual_effect"
+  },
+  holographic_sprite: {
+    material: { roughness: 0.2 },
+    emissive: { color: "#AA44FF", intensity: 0.3 },
+    tags: ["hologram", "sprite", "3d"],
+    layer: "visual_effect"
+  },
+  quilt: {
+    material: { roughness: 0.3 },
+    emissive: { color: "#44AAFF", intensity: 0.2 },
+    tags: ["hologram", "multiview", "looking-glass"],
+    layer: "visual_effect"
+  },
+  gaussian_splatting: {
+    material: { roughness: 0.2 },
+    emissive: { color: "#AACCFF", intensity: 0.15 },
+    tags: ["3d", "photorealistic", "splat"],
+    layer: "visual_effect"
+  },
+  spatial_video: {
+    material: { roughness: 0.3 },
+    emissive: { color: "#FF8844", intensity: 0.15 },
+    tags: ["video", "stereo", "spatial"],
+    layer: "visual_effect"
+  },
+  image: {
+    material: { roughness: 0.4 },
+    tags: ["media", "texture", "source"],
+    layer: "base_material"
+  },
+  depth_sequence: {
+    material: { roughness: 0.3 },
+    emissive: { color: "#6644FF", intensity: 0.1 },
+    tags: ["video", "depth", "temporal"],
+    layer: "visual_effect"
+  },
+  temporal_smoothing: {
+    material: { roughness: 0.3 },
+    tags: ["processing", "temporal"],
+    layer: "visual_effect"
+  },
+  depth_to_normal: {
+    material: { roughness: 0.3 },
+    emissive: { color: "#8888FF", intensity: 0.1 },
+    tags: ["processing", "normal-map"],
+    layer: "visual_effect"
+  }
+};
+
+// src/traits/visual/presets/gaps-physics.visual.ts
+var GAPS_PHYSICS_VISUALS = /* @__PURE__ */ new Map([
+  // --- Pillar A: Unified Physics ---
+  [
+    "fluid",
+    {
+      material: {
+        type: "physical",
+        color: "#1a6fc4",
+        metalness: 0,
+        roughness: 0.05,
+        transmission: 0.95,
+        ior: 1.33,
+        thickness: 0.5
+      },
+      layers: [
+        {
+          type: "effect",
+          name: "ssfr",
+          priority: 50,
+          config: {
+            resolutionScale: 0.5,
+            absorptionColor: [0.4, 0.04, 0],
+            absorptionStrength: 2,
+            fresnelPower: 0.02,
+            refractionStrength: 0.1
+          }
+        }
+      ]
+    }
+  ],
+  [
+    "soft_body_pro",
+    {
+      material: {
+        type: "physical",
+        color: "#e8a87c",
+        metalness: 0,
+        roughness: 0.6
+      },
+      layers: [
+        {
+          type: "deformation",
+          name: "pbd_tearing",
+          priority: 45,
+          config: { tearThreshold: 0.8, tearColor: "#8b0000" }
+        }
+      ]
+    }
+  ],
+  [
+    "crowd_sim",
+    {
+      material: {
+        type: "standard",
+        color: "#7b68ee"
+      },
+      layers: [
+        {
+          type: "instanced",
+          name: "crowd_instances",
+          priority: 30,
+          config: { maxInstances: 1e4, lodLevels: 3 }
+        }
+      ]
+    }
+  ],
+  [
+    "deformable_terrain",
+    {
+      material: {
+        type: "standard",
+        color: "#8b7355",
+        roughness: 0.9
+      },
+      layers: [
+        {
+          type: "displacement",
+          name: "heightmap_erosion",
+          priority: 40,
+          config: { displacementScale: 5 }
+        }
+      ]
+    }
+  ],
+  [
+    "volumetric_clouds",
+    {
+      material: {
+        type: "shader",
+        color: "#ffffff"
+      },
+      layers: [
+        {
+          type: "volumetric",
+          name: "cloud_raymarcher",
+          priority: 80,
+          config: {
+            absorptionCoeff: 0.04,
+            scatteringCoeff: 0.06,
+            phaseG: 0.3,
+            maxSteps: 64
+          }
+        }
+      ]
+    }
+  ],
+  [
+    "god_rays",
+    {
+      material: {
+        type: "shader",
+        color: "#fffde7"
+      },
+      layers: [
+        {
+          type: "post_process",
+          name: "volumetric_light",
+          priority: 85,
+          config: { decay: 0.96, weight: 0.5, exposure: 0.3, samples: 100 }
+        }
+      ]
+    }
+  ],
+  // --- Weather Hub ---
+  [
+    "weather",
+    {
+      material: {
+        type: "none",
+        color: "#87ceeb"
+      },
+      layers: [
+        {
+          type: "ambient",
+          name: "weather_atmosphere",
+          priority: 90,
+          config: { affectsLighting: true, affectsFog: true }
+        }
+      ]
+    }
+  ],
+  // --- Pillar B: Persistent World ---
+  [
+    "world_state",
+    {
+      material: {
+        type: "none",
+        color: "#4a90d9"
+      },
+      layers: []
+    }
+  ],
+  [
+    "spatial_voice",
+    {
+      material: {
+        type: "none",
+        color: "#90ee90"
+      },
+      layers: [
+        {
+          type: "indicator",
+          name: "voice_range",
+          priority: 10,
+          config: { showRadius: true, radiusColor: "#90ee9040" }
+        }
+      ]
+    }
+  ],
+  [
+    "lip_sync",
+    {
+      material: {
+        type: "none",
+        color: "#ffb6c1"
+      },
+      layers: [
+        {
+          type: "morph",
+          name: "viseme_blendshapes",
+          priority: 60,
+          config: { blendShapePrefix: "viseme_" }
+        }
+      ]
+    }
+  ],
+  // --- Pillar C: Living Economy ---
+  [
+    "ai_companion",
+    {
+      material: {
+        type: "standard",
+        color: "#dda0dd",
+        emissive: "#330033",
+        emissiveIntensity: 0.2
+      },
+      layers: [
+        {
+          type: "indicator",
+          name: "ai_thinking",
+          priority: 15,
+          config: { pulseColor: "#9b59b6", pulseSpeed: 1.5 }
+        }
+      ]
+    }
+  ],
+  [
+    "token_gated",
+    {
+      material: {
+        type: "standard",
+        color: "#ffd700",
+        metalness: 0.8,
+        roughness: 0.2
+      },
+      layers: [
+        {
+          type: "barrier",
+          name: "token_gate_barrier",
+          priority: 70,
+          config: { barrierColor: "#ffd70060", shimmer: true }
+        }
+      ]
+    }
+  ],
+  [
+    "moderation",
+    {
+      material: {
+        type: "none",
+        color: "#ff6347"
+      },
+      layers: []
+    }
+  ],
+  [
+    "anti_grief",
+    {
+      material: {
+        type: "none",
+        color: "#32cd32"
+      },
+      layers: [
+        {
+          type: "shield",
+          name: "grief_shield",
+          priority: 95,
+          config: { shieldColor: "#32cd3230" }
+        }
+      ]
+    }
+  ]
+]);
+
+// src/traits/visual/presets/phone-sleeve-vr.visual.ts
+var PHONE_SLEEVE_VR_VISUALS = {
+  // --- Hardware Form Factor ---
+  phone_sleeve: {
+    material: { roughness: 0.3, metalness: 0.6 },
+    emissive: { color: "#00CCFF", intensity: 0.2 },
+    tags: ["vr", "phone", "sleeve", "headset"],
+    layer: "visual_effect"
+  },
+  sleeve_nfc_trigger: {
+    material: { roughness: 0.4 },
+    emissive: { color: "#FFD700", intensity: 0.15 },
+    tags: ["nfc", "trigger", "hardware"],
+    layer: "visual_effect"
+  },
+  sleeve_lens_profile: {
+    material: { roughness: 0.1, metalness: 0 },
+    opacity: 0.6,
+    tags: ["lens", "optics"],
+    layer: "visual_effect"
+  },
+  phone_detection: {
+    material: { roughness: 0.4 },
+    emissive: { color: "#44FF88", intensity: 0.1 },
+    tags: ["detection", "calibration"],
+    layer: "visual_effect"
+  },
+  // --- Display ---
+  stereo_split: {
+    material: { roughness: 0.2 },
+    emissive: { color: "#FF44AA", intensity: 0.2 },
+    tags: ["stereoscopic", "display", "split"],
+    layer: "visual_effect"
+  },
+  barrel_distortion: {
+    material: { roughness: 0.3 },
+    emissive: { color: "#AA44FF", intensity: 0.15 },
+    tags: ["distortion", "shader", "lens"],
+    layer: "visual_effect"
+  },
+  chromatic_aberration_fix: {
+    material: { roughness: 0.3 },
+    emissive: { color: "#FF8800", intensity: 0.1 },
+    tags: ["color", "correction", "lens"],
+    layer: "visual_effect"
+  },
+  ipd_adjust: {
+    material: { roughness: 0.4 },
+    emissive: { color: "#44CCFF", intensity: 0.1 },
+    tags: ["calibration", "ipd", "comfort"],
+    layer: "visual_effect"
+  },
+  // --- Sensor / Tracking ---
+  gyro_head_tracking: {
+    material: { roughness: 0.4 },
+    emissive: { color: "#00FF88", intensity: 0.15 },
+    tags: ["tracking", "gyroscope", "3dof"],
+    layer: "visual_effect"
+  },
+  accel_sensor_fusion: {
+    material: { roughness: 0.4 },
+    emissive: { color: "#00CC66", intensity: 0.1 },
+    tags: ["sensor", "accelerometer", "fusion"],
+    layer: "visual_effect"
+  },
+  mag_drift_correction: {
+    material: { roughness: 0.4 },
+    emissive: { color: "#8844FF", intensity: 0.1 },
+    tags: ["magnetometer", "drift", "correction"],
+    layer: "visual_effect"
+  },
+  positional_estimation: {
+    material: { roughness: 0.4 },
+    emissive: { color: "#FFAA00", intensity: 0.15 },
+    tags: ["6dof", "vio", "tracking"],
+    layer: "visual_effect"
+  },
+  // --- Interaction ---
+  gaze_cursor: {
+    material: { roughness: 0.2 },
+    emissive: { color: "#FFFFFF", intensity: 0.3 },
+    tags: ["gaze", "cursor", "reticle"],
+    layer: "visual_effect"
+  },
+  gaze_dwell_select: {
+    material: { roughness: 0.3 },
+    emissive: { color: "#FFFF44", intensity: 0.2 },
+    tags: ["gaze", "dwell", "selection"],
+    layer: "visual_effect"
+  },
+  bt_controller: {
+    material: { roughness: 0.5, metalness: 0.3 },
+    tags: ["bluetooth", "controller", "input"],
+    layer: "visual_effect"
+  },
+  tap_select: {
+    material: { roughness: 0.4 },
+    emissive: { color: "#44FF44", intensity: 0.1 },
+    tags: ["tap", "capacitive", "input"],
+    layer: "visual_effect"
+  },
+  voice_command: {
+    material: { roughness: 0.4 },
+    emissive: { color: "#4488FF", intensity: 0.1 },
+    tags: ["voice", "speech", "command"],
+    layer: "visual_effect"
+  },
+  // --- Performance ---
+  thermal_throttle: {
+    material: { roughness: 0.6 },
+    emissive: { color: "#FF4400", intensity: 0.2 },
+    tags: ["thermal", "throttle", "performance"],
+    layer: "visual_effect"
+  },
+  battery_aware_lod: {
+    material: { roughness: 0.5 },
+    emissive: { color: "#44FF00", intensity: 0.1 },
+    tags: ["battery", "lod", "adaptive"],
+    layer: "visual_effect"
+  },
+  sleeve_foveated: {
+    material: { roughness: 0.3 },
+    emissive: { color: "#CC44FF", intensity: 0.15 },
+    tags: ["foveated", "rendering", "performance"],
+    layer: "visual_effect"
+  },
+  low_persistence: {
+    material: { roughness: 0.2 },
+    emissive: { color: "#88CCFF", intensity: 0.1 },
+    tags: ["display", "persistence", "blur"],
+    layer: "visual_effect"
+  },
+  // --- Comfort ---
+  vr_comfort_vignette: {
+    material: { roughness: 0.5 },
+    opacity: 0.7,
+    tags: ["comfort", "vignette", "motion"],
+    layer: "visual_effect"
+  },
+  reorient_snap: {
+    material: { roughness: 0.4 },
+    emissive: { color: "#44FFCC", intensity: 0.1 },
+    tags: ["snap", "recenter", "comfort"],
+    layer: "visual_effect"
+  },
+  static_horizon: {
+    material: { roughness: 0.4 },
+    emissive: { color: "#88FF88", intensity: 0.1 },
+    tags: ["horizon", "stability", "nausea"],
+    layer: "visual_effect"
+  },
+  session_timer: {
+    material: { roughness: 0.4 },
+    emissive: { color: "#FFCC00", intensity: 0.15 },
+    tags: ["timer", "health", "breaks"],
+    layer: "visual_effect"
+  }
+};
+
+// src/traits/visual/index.ts
+var ALL_PRESETS = [
+  // Original 12
+  chunkYKY2JBER_cjs.MATERIAL_PROPERTIES_VISUALS,
+  chunkYKY2JBER_cjs.SURFACE_TEXTURE_VISUALS,
+  chunkYKY2JBER_cjs.LIGHTING_VISUALS,
+  chunkYKY2JBER_cjs.GEMS_MINERALS_VISUALS,
+  chunkYKY2JBER_cjs.FABRIC_CLOTH_VISUALS,
+  chunkYKY2JBER_cjs.VISUAL_EFFECTS_VISUALS,
+  chunkYKY2JBER_cjs.AGE_CONDITION_VISUALS,
+  chunkYKY2JBER_cjs.WATER_FLUID_VISUALS,
+  chunkYKY2JBER_cjs.WEATHER_PHENOMENA_VISUALS,
+  chunkYKY2JBER_cjs.EMOTION_MOOD_VISUALS,
+  chunkYKY2JBER_cjs.SIZE_SCALE_VISUALS,
+  chunkYKY2JBER_cjs.ENVIRONMENTAL_BIOME_VISUALS,
+  // Expansion wave 1
+  chunkYKY2JBER_cjs.MAGIC_FANTASY_VISUALS,
+  chunkYKY2JBER_cjs.SCIFI_TECHNOLOGY_VISUALS,
+  chunkYKY2JBER_cjs.CREATURES_MYTHICAL_VISUALS,
+  chunkYKY2JBER_cjs.NATURE_LIFE_VISUALS,
+  chunkYKY2JBER_cjs.FURNITURE_DECOR_VISUALS,
+  chunkYKY2JBER_cjs.CONSTRUCTION_BUILDING_VISUALS,
+  chunkYKY2JBER_cjs.CONTAINERS_STORAGE_VISUALS,
+  chunkYKY2JBER_cjs.SHAPE_FORM_VISUALS,
+  chunkYKY2JBER_cjs.ANIMALS_VISUALS,
+  chunkYKY2JBER_cjs.MARITIME_NAVAL_VISUALS,
+  chunkYKY2JBER_cjs.TIME_PERIOD_VISUALS,
+  // Expansion wave 2 — full coverage
+  chunkYKY2JBER_cjs.ACCESSIBILITY_VISUALS,
+  chunkYKY2JBER_cjs.ACCESSIBILITY_EXTENDED_VISUALS,
+  chunkYKY2JBER_cjs.ARCHITECTURE_REALESTATE_VISUALS,
+  chunkYKY2JBER_cjs.AUDIO_VISUALS,
+  chunkYKY2JBER_cjs.COOKING_FOOD_VISUALS,
+  chunkYKY2JBER_cjs.CORE_VR_INTERACTION_VISUALS,
+  chunkYKY2JBER_cjs.DATA_VISUALIZATION_VISUALS,
+  chunkYKY2JBER_cjs.PERCEPTUAL_COLOR_VISUALS,
+  chunkYKY2JBER_cjs.EDUCATION_LEARNING_VISUALS,
+  chunkYKY2JBER_cjs.ENVIRONMENT_INPUT_VISUALS,
+  chunkYKY2JBER_cjs.GAME_MECHANICS_VISUALS,
+  chunkYKY2JBER_cjs.GEOSPATIAL_WEB3_VISUALS,
+  chunkYKY2JBER_cjs.HEALTHCARE_MEDICAL_VISUALS,
+  chunkYKY2JBER_cjs.HUMANOID_AVATAR_VISUALS,
+  chunkYKY2JBER_cjs.INTELLIGENCE_BEHAVIOR_VISUALS,
+  chunkYKY2JBER_cjs.INTEROP_COPRESENCE_VISUALS,
+  chunkYKY2JBER_cjs.IOT_AUTONOMOUS_AGENTS_VISUALS,
+  chunkYKY2JBER_cjs.LOCOMOTION_MOVEMENT_VISUALS,
+  chunkYKY2JBER_cjs.MEASUREMENT_SENSING_VISUALS,
+  chunkYKY2JBER_cjs.MEDIA_ANALYTICS_VISUALS,
+  chunkYKY2JBER_cjs.MULTISENSORY_HAPTIC_VISUALS,
+  chunkYKY2JBER_cjs.MUSICAL_SOUND_VISUALS,
+  chunkYKY2JBER_cjs.MUSIC_PERFORMANCE_VISUALS,
+  chunkYKY2JBER_cjs.NARRATIVE_STORYTELLING_VISUALS,
+  chunkYKY2JBER_cjs.NETWORKING_AI_VISUALS,
+  chunkYKY2JBER_cjs.NPC_ROLES_VISUALS,
+  chunkYKY2JBER_cjs.OBJECT_INTERACTION_VISUALS,
+  chunkYKY2JBER_cjs.PARSER_CORE_UI_VISUALS,
+  chunkYKY2JBER_cjs.PHYSICAL_AFFORDANCES_VISUALS,
+  chunkYKY2JBER_cjs.PHYSICS_EXPANSION_VISUALS,
+  chunkYKY2JBER_cjs.PROCEDURAL_GENERATION_VISUALS,
+  chunkYKY2JBER_cjs.RESOURCE_GATHERING_VISUALS,
+  chunkYKY2JBER_cjs.SAFETY_BOUNDARIES_VISUALS,
+  chunkYKY2JBER_cjs.SIGNS_COMMUNICATION_VISUALS,
+  chunkYKY2JBER_cjs.SIMPLE_MODIFIERS_VISUALS,
+  chunkYKY2JBER_cjs.SOCIAL_COMMERCE_VISUALS,
+  chunkYKY2JBER_cjs.SOCIAL_EFFECTS_VISUALS,
+  chunkYKY2JBER_cjs.SPORTS_FITNESS_VISUALS,
+  chunkYKY2JBER_cjs.STATE_PERSISTENCE_VISUALS,
+  chunkYKY2JBER_cjs.TRANSPORTATION_VEHICLES_VISUALS,
+  chunkYKY2JBER_cjs.VOLUMETRIC_WEBGPU_VISUALS,
+  chunkYKY2JBER_cjs.WEATHER_PARTICLES_VISUALS,
+  chunkYKY2JBER_cjs.XR_PLATFORM_VISUALS,
+  // Hologram Media Pipeline
+  HOLOGRAM_MEDIA_VISUALS,
+  // GAPS Feature Roadmap — Phase 1
+  GAPS_PHYSICS_VISUALS,
+  // Phone Sleeve VR — smartphone-as-headset
+  PHONE_SLEEVE_VR_VISUALS
+];
+function registerAllPresets() {
+  const registry = chunkQQFB4RT2_cjs.TraitVisualRegistry.getInstance();
+  for (const presetMap of ALL_PRESETS) {
+    registry.registerBatch(presetMap);
+  }
+}
+registerAllPresets();
+
+// src/compiler/SceneIRCompiler.ts
+chunkQEDMOGF3_cjs.init_DomainBlockCompilerMixin();
+chunkTZCFKZ6Z_cjs.init_PlatformConditionalCompilerMixin();
+chunkZK7KX5CD_cjs.init_AgentRBAC();
+chunkZK7KX5CD_cjs.init_CompilerBase();
+
+// src/animation/stagger.ts
+function staggerOffsets(count, step, from = 0) {
+  if (count <= 0) return [];
+  return Array.from({ length: count }, (_, i) => from + i * step);
+}
+function applyStaggerToChildren(children, step, from = 0) {
+  if (!step || children.length === 0) return;
+  const offsets = staggerOffsets(children.length, step, from);
+  children.forEach((child, i) => {
+    const channels = child.props?.__animatedTransform;
+    if (!Array.isArray(channels)) return;
+    const delta = offsets[i];
+    for (const ch of channels) {
+      if (typeof ch.edge0 === "number") ch.edge0 = ch.edge0 + delta;
+      if (typeof ch.edge1 === "number") ch.edge1 = ch.edge1 + delta;
+    }
+  });
+}
+function defaultEntranceChannel(target) {
+  return { prop: "scaleUniform", target, edge0: 0, edge1: 0.4, from: 0, to: 1 };
+}
+function synthesizeEntranceChannels(children, target) {
+  let count = 0;
+  for (const child of children) {
+    const props = child.props;
+    if (!props) continue;
+    if (props.animated !== true) continue;
+    if (Array.isArray(props.__animatedTransform)) continue;
+    props.__animatedTransform = [defaultEntranceChannel(target)];
+    count += 1;
+  }
+  return count;
+}
+
+// src/compiler/SceneIRCompiler.ts
+var sceneIRNodePool = new chunkKROXXBK5_cjs.ASTNodePool(
+  () => ({ type: "", props: {} }),
+  (node) => {
+    node.type = "";
+    node.id = void 0;
+    node.props = {};
+    node.children = void 0;
+    node.traits = void 0;
+    node.directives = void 0;
+    node.assetMaturity = void 0;
+  },
+  0
+  // Was 20000 — demand-allocate instead of pre-allocating
+);
+function isVfxParticleTraitName(name) {
+  return name.startsWith("vfx_particle_");
+}
+function vfxParticleEffect(name) {
+  return name.replace("vfx_particle_", "");
+}
+function gemResonanceConfig(config) {
+  return {
+    max_distance: 0.5,
+    base_frequencies: "auto",
+    blend_mode: "harmonic",
+    output: "spatial_audio",
+    ...config || {}
+  };
+}
+var MATERIAL_PRESETS = {
+  plastic: { roughness: 0.5, metalness: 0, clearcoat: 0.1 },
+  metal: { roughness: 0.2, metalness: 1 },
+  chrome: { roughness: 0.05, metalness: 1, envMapIntensity: 1.5 },
+  gold: { roughness: 0.3, metalness: 1, color: "#ffd700" },
+  copper: { roughness: 0.4, metalness: 1, color: "#b87333" },
+  glass: {
+    roughness: 0,
+    metalness: 0,
+    transmission: 0.95,
+    ior: 1.5,
+    thickness: 0.5,
+    transparent: true
+  },
+  crystal: {
+    roughness: 0,
+    metalness: 0.1,
+    transmission: 0.9,
+    ior: 2,
+    iridescence: 1,
+    iridescenceIOR: 1.3
+  },
+  wood: { roughness: 0.8, metalness: 0 },
+  fabric: {
+    roughness: 0.95,
+    metalness: 0,
+    sheen: 0.5,
+    sheenRoughness: 0.8,
+    sheenColor: "#ffffff"
+  },
+  rubber: { roughness: 0.9, metalness: 0 },
+  leather: {
+    roughness: 0.7,
+    metalness: 0,
+    sheen: 0.3,
+    sheenRoughness: 0.6,
+    sheenColor: "#3d2b1f"
+  },
+  water: {
+    roughness: 0,
+    metalness: 0,
+    transmission: 0.9,
+    ior: 1.33,
+    transparent: true,
+    color: "#006994"
+  },
+  emissive: { roughness: 0.5, metalness: 0, emissiveIntensity: 2 },
+  hologram: {
+    roughness: 0,
+    metalness: 0.3,
+    transparent: true,
+    opacity: 0.6,
+    emissiveIntensity: 1
+  },
+  stone: { roughness: 0.85, metalness: 0, color: "#808080" },
+  marble: { roughness: 0.15, metalness: 0, color: "#F0EDE6", envMapIntensity: 0.8 },
+  shiny: { roughness: 0.05, metalness: 0.3, envMapIntensity: 1.5, clearcoat: 0.8 },
+  neon: {
+    roughness: 0,
+    metalness: 0,
+    emissiveIntensity: 3,
+    transparent: true,
+    opacity: 0.9
+  },
+  toon: { roughness: 1, metalness: 0 },
+  wireframe: { roughness: 0.5, metalness: 0.5, wireframe: true },
+  velvet: {
+    roughness: 1,
+    metalness: 0,
+    sheen: 1,
+    sheenRoughness: 0.8,
+    sheenColor: "#ffffff",
+    clearcoat: 0.3
+  },
+  xray: { roughness: 0, metalness: 0, transparent: true, opacity: 0.3, emissiveIntensity: 0.5 },
+  gradient: { roughness: 0.5, metalness: 0 },
+  matte: { roughness: 1, metalness: 0 },
+  // ===========================================================================
+  // REALISTIC FABRICS — differentiated by sheen, roughness, and anisotropy
+  // ===========================================================================
+  cotton: {
+    roughness: 0.95,
+    metalness: 0,
+    sheen: 0.6,
+    sheenRoughness: 0.9,
+    sheenColor: "#ffffff"
+  },
+  polyester: {
+    roughness: 0.7,
+    metalness: 0,
+    sheen: 0.8,
+    sheenRoughness: 0.4,
+    sheenColor: "#e8e8e8"
+  },
+  silk: {
+    roughness: 0.3,
+    metalness: 0,
+    sheen: 1,
+    sheenRoughness: 0.2,
+    sheenColor: "#fffaf0",
+    anisotropy: 0.8,
+    anisotropyRotation: 0
+  },
+  satin: {
+    roughness: 0.25,
+    metalness: 0,
+    sheen: 0.9,
+    sheenRoughness: 0.15,
+    sheenColor: "#fff5ee",
+    anisotropy: 0.6,
+    anisotropyRotation: 0
+  },
+  linen: {
+    roughness: 0.9,
+    metalness: 0,
+    sheen: 0.4,
+    sheenRoughness: 0.85,
+    sheenColor: "#f5f0e8"
+  },
+  wool: {
+    roughness: 1,
+    metalness: 0,
+    sheen: 0.7,
+    sheenRoughness: 1,
+    sheenColor: "#e8dcc8"
+  },
+  denim: {
+    roughness: 0.85,
+    metalness: 0,
+    color: "#2b4570",
+    sheen: 0.5,
+    sheenRoughness: 0.7,
+    sheenColor: "#4a6fa5"
+  },
+  canvas: {
+    roughness: 0.95,
+    metalness: 0,
+    color: "#c8b88a",
+    sheen: 0.3,
+    sheenRoughness: 0.9,
+    sheenColor: "#d4c9a8"
+  },
+  burlap: {
+    roughness: 1,
+    metalness: 0,
+    color: "#8b7355",
+    sheen: 0.2,
+    sheenRoughness: 1,
+    sheenColor: "#a08060"
+  },
+  // ===========================================================================
+  // SKIN & ORGANIC — differentiated by subsurface scattering
+  // ===========================================================================
+  skin: {
+    roughness: 0.5,
+    metalness: 0,
+    color: "#e8b89d",
+    thickness: 0.8,
+    attenuationColor: "#cc4422",
+    attenuationDistance: 0.5
+  },
+  skin_dark: {
+    roughness: 0.45,
+    metalness: 0,
+    color: "#8d5524",
+    thickness: 1,
+    attenuationColor: "#661111",
+    attenuationDistance: 0.3
+  },
+  // Dragon / creature material presets
+  dragon_bone: {
+    roughness: 0.35,
+    metalness: 0.15,
+    color: "#e8dcc8"
+  },
+  dragon_leather: {
+    roughness: 0.8,
+    metalness: 0,
+    color: "#5c3a21"
+  },
+  dragon_scale: {
+    roughness: 0.25,
+    metalness: 0.4,
+    color: "#1a0d3d"
+  },
+  obsidian: {
+    roughness: 0.05,
+    metalness: 0.1,
+    color: "#0d0d0d",
+    clearcoat: 0.9,
+    clearcoatRoughness: 0.1,
+    envMapIntensity: 1.2
+  },
+  skin_pale: {
+    roughness: 0.55,
+    metalness: 0,
+    color: "#fde0c8",
+    thickness: 0.6,
+    attenuationColor: "#ee5533",
+    attenuationDistance: 0.6
+  },
+  candle_wax: {
+    roughness: 0.7,
+    metalness: 0,
+    color: "#fff8dc",
+    thickness: 2,
+    attenuationColor: "#ffaa44",
+    attenuationDistance: 0.3,
+    transmission: 0.15
+  },
+  jade: {
+    roughness: 0.2,
+    metalness: 0,
+    color: "#00a86b",
+    thickness: 1.5,
+    attenuationColor: "#004d32",
+    attenuationDistance: 1,
+    transmission: 0.1
+  },
+  milk: {
+    roughness: 0.3,
+    metalness: 0,
+    color: "#fdfff5",
+    thickness: 1,
+    attenuationColor: "#fff5d6",
+    attenuationDistance: 0.2,
+    transmission: 0.6,
+    ior: 1.35
+  },
+  leaf: {
+    roughness: 0.6,
+    metalness: 0,
+    color: "#228b22",
+    thickness: 0.3,
+    attenuationColor: "#44cc22",
+    attenuationDistance: 0.5
+  },
+  honey: {
+    roughness: 0.1,
+    metalness: 0,
+    color: "#eb9605",
+    thickness: 1.5,
+    attenuationColor: "#cc6600",
+    attenuationDistance: 0.4,
+    transmission: 0.7,
+    ior: 1.5
+  },
+  // ===========================================================================
+  // MUD & EARTH — differentiated by roughness, color, and subtle properties
+  // ===========================================================================
+  clay_mud: {
+    roughness: 0.95,
+    metalness: 0,
+    color: "#8b4513",
+    thickness: 0.5,
+    attenuationColor: "#663311",
+    attenuationDistance: 0.8
+  },
+  sandy_mud: {
+    roughness: 0.85,
+    metalness: 0.02,
+    color: "#c2a66b"
+  },
+  wet_mud: {
+    roughness: 0.4,
+    metalness: 0,
+    color: "#3d2b1f",
+    clearcoat: 0.6,
+    clearcoatRoughness: 0.2
+  },
+  dry_earth: {
+    roughness: 1,
+    metalness: 0,
+    color: "#9b7653"
+  },
+  peat: {
+    roughness: 0.9,
+    metalness: 0,
+    color: "#2d1f0e"
+  },
+  red_clay: {
+    roughness: 0.95,
+    metalness: 0,
+    color: "#cc4b2e",
+    thickness: 0.4,
+    attenuationColor: "#993322",
+    attenuationDistance: 0.6
+  },
+  volcanic_ash: {
+    roughness: 0.8,
+    metalness: 0.05,
+    color: "#3c3c3c"
+  },
+  wet_sand: {
+    roughness: 0.6,
+    metalness: 0.02,
+    color: "#c2b280",
+    clearcoat: 0.3,
+    clearcoatRoughness: 0.4
+  },
+  dry_sand: {
+    roughness: 0.95,
+    metalness: 0.02,
+    color: "#e0cc8e"
+  },
+  // ===========================================================================
+  // METALS (BRUSHED/ANISOTROPIC) — directional roughness
+  // ===========================================================================
+  brushed_steel: {
+    roughness: 0.35,
+    metalness: 1,
+    color: "#c0c0c0",
+    anisotropy: 0.7,
+    anisotropyRotation: 0
+  },
+  brushed_aluminum: {
+    roughness: 0.3,
+    metalness: 1,
+    color: "#d0d0d0",
+    anisotropy: 0.8,
+    anisotropyRotation: 0
+  },
+  brushed_copper: {
+    roughness: 0.35,
+    metalness: 1,
+    color: "#b87333",
+    anisotropy: 0.6,
+    anisotropyRotation: 0
+  },
+  cast_iron: {
+    roughness: 0.7,
+    metalness: 0.9,
+    color: "#3a3a3a"
+  },
+  bronze: {
+    roughness: 0.45,
+    metalness: 1,
+    color: "#cd7f32"
+  },
+  silver: {
+    roughness: 0.15,
+    metalness: 1,
+    color: "#c0c0c0",
+    envMapIntensity: 1.3
+  },
+  platinum: {
+    roughness: 0.2,
+    metalness: 1,
+    color: "#e5e4e2",
+    envMapIntensity: 1.2
+  },
+  rust: {
+    roughness: 0.9,
+    metalness: 0.3,
+    color: "#8b3a15"
+  },
+  // ===========================================================================
+  // HAIR & FIBERS — anisotropy-driven
+  // ===========================================================================
+  hair_dark: {
+    roughness: 0.35,
+    metalness: 0,
+    color: "#1a1209",
+    anisotropy: 1,
+    anisotropyRotation: Math.PI / 2,
+    sheen: 0.3,
+    sheenRoughness: 0.3,
+    sheenColor: "#2a2219"
+  },
+  hair_blonde: {
+    roughness: 0.3,
+    metalness: 0,
+    color: "#c8a55a",
+    anisotropy: 1,
+    anisotropyRotation: Math.PI / 2,
+    sheen: 0.4,
+    sheenRoughness: 0.25,
+    sheenColor: "#d4b86a"
+  },
+  hair_red: {
+    roughness: 0.35,
+    metalness: 0,
+    color: "#8b3a15",
+    anisotropy: 1,
+    anisotropyRotation: Math.PI / 2,
+    sheen: 0.35,
+    sheenRoughness: 0.3,
+    sheenColor: "#a04520"
+  },
+  // ===========================================================================
+  // WET SURFACES — clearcoat simulates water film
+  // ===========================================================================
+  wet_stone: {
+    roughness: 0.3,
+    metalness: 0,
+    color: "#606060",
+    clearcoat: 0.8,
+    clearcoatRoughness: 0.1
+  },
+  wet_wood: {
+    roughness: 0.4,
+    metalness: 0,
+    color: "#5a3a1a",
+    clearcoat: 0.7,
+    clearcoatRoughness: 0.15
+  },
+  wet_concrete: {
+    roughness: 0.5,
+    metalness: 0,
+    color: "#707070",
+    clearcoat: 0.5,
+    clearcoatRoughness: 0.2
+  },
+  // ===========================================================================
+  // FOOD & ORGANIC — SSS-heavy
+  // ===========================================================================
+  fruit: {
+    roughness: 0.4,
+    metalness: 0,
+    color: "#ff4444",
+    thickness: 0.8,
+    attenuationColor: "#cc2200",
+    attenuationDistance: 0.5,
+    clearcoat: 0.3,
+    clearcoatRoughness: 0.2
+  },
+  cheese: {
+    roughness: 0.7,
+    metalness: 0,
+    color: "#ffc125",
+    thickness: 1.2,
+    attenuationColor: "#cc9900",
+    attenuationDistance: 0.4
+  },
+  bread: {
+    roughness: 0.95,
+    metalness: 0,
+    color: "#c4a35a",
+    thickness: 0.3,
+    attenuationColor: "#8b6914",
+    attenuationDistance: 0.8
+  },
+  chocolate: {
+    roughness: 0.5,
+    metalness: 0,
+    color: "#3b1e08",
+    clearcoat: 0.2,
+    clearcoatRoughness: 0.3
+  },
+  // ===========================================================================
+  // COATED SURFACES — clearcoat-driven
+  // ===========================================================================
+  car_paint: {
+    roughness: 0.1,
+    metalness: 0,
+    clearcoat: 1,
+    clearcoatRoughness: 0.05
+  },
+  lacquer: {
+    roughness: 0.05,
+    metalness: 0,
+    clearcoat: 1,
+    clearcoatRoughness: 0.02
+  },
+  varnished_wood: {
+    roughness: 0.3,
+    metalness: 0,
+    color: "#8b5e3c",
+    clearcoat: 0.9,
+    clearcoatRoughness: 0.1
+  },
+  glazed_ceramic: {
+    roughness: 0.15,
+    metalness: 0,
+    color: "#f0ede6",
+    clearcoat: 0.8,
+    clearcoatRoughness: 0.05
+  },
+  enamel: {
+    roughness: 0.1,
+    metalness: 0,
+    clearcoat: 0.9,
+    clearcoatRoughness: 0.03
+  },
+  // ===========================================================================
+  // IRIDESCENT — thin-film interference
+  // ===========================================================================
+  soap_bubble: {
+    roughness: 0,
+    metalness: 0,
+    transmission: 0.9,
+    ior: 1.33,
+    transparent: true,
+    opacity: 0.3,
+    iridescence: 1,
+    iridescenceIOR: 1.5
+  },
+  oil_slick: {
+    roughness: 0,
+    metalness: 0.1,
+    color: "#1a1a2e",
+    iridescence: 1,
+    iridescenceIOR: 1.8
+  },
+  beetle_shell: {
+    roughness: 0.2,
+    metalness: 0.3,
+    color: "#0a3d0a",
+    iridescence: 0.8,
+    iridescenceIOR: 1.6,
+    clearcoat: 0.5,
+    clearcoatRoughness: 0.1
+  },
+  pearl: {
+    roughness: 0.15,
+    metalness: 0,
+    color: "#fdeef4",
+    iridescence: 0.6,
+    iridescenceIOR: 1.3,
+    sheen: 0.3,
+    sheenRoughness: 0.2,
+    sheenColor: "#fff0f5"
+  },
+  abalone: {
+    roughness: 0.1,
+    metalness: 0.1,
+    color: "#e0f0e8",
+    iridescence: 1,
+    iridescenceIOR: 1.5
+  },
+  // ===========================================================================
+  // GEMSTONES — transmission + IOR + iridescence
+  // ===========================================================================
+  diamond: {
+    roughness: 0,
+    metalness: 0,
+    color: "#ffffff",
+    transmission: 0.95,
+    ior: 2.417,
+    thickness: 0.5,
+    transparent: true
+  },
+  ruby: {
+    roughness: 0.05,
+    metalness: 0,
+    color: "#e0115f",
+    transmission: 0.4,
+    ior: 1.76,
+    thickness: 1
+  },
+  sapphire: {
+    roughness: 0.05,
+    metalness: 0,
+    color: "#0f52ba",
+    transmission: 0.4,
+    ior: 1.77,
+    thickness: 1
+  },
+  emerald: {
+    roughness: 0.1,
+    metalness: 0,
+    color: "#50c878",
+    transmission: 0.3,
+    ior: 1.57,
+    thickness: 1.2
+  },
+  amber: {
+    roughness: 0.1,
+    metalness: 0,
+    color: "#ffbf00",
+    transmission: 0.6,
+    ior: 1.55,
+    thickness: 2,
+    transparent: true,
+    attenuationColor: "#cc6600",
+    attenuationDistance: 1
+  },
+  opal: {
+    roughness: 0.15,
+    metalness: 0,
+    color: "#e8e0d0",
+    iridescence: 0.9,
+    iridescenceIOR: 1.45,
+    transmission: 0.1,
+    ior: 1.45
+  },
+  amethyst: {
+    roughness: 0.05,
+    metalness: 0,
+    color: "#9966cc",
+    transmission: 0.5,
+    ior: 1.54,
+    thickness: 1,
+    transparent: true
+  },
+  topaz: {
+    roughness: 0.02,
+    metalness: 0,
+    color: "#ffc87c",
+    transmission: 0.7,
+    ior: 1.63,
+    thickness: 0.8,
+    transparent: true
+  },
+  turquoise: {
+    roughness: 0.6,
+    metalness: 0,
+    color: "#40e0d0"
+  },
+  lapis_lazuli: {
+    roughness: 0.4,
+    metalness: 0,
+    color: "#26619c",
+    clearcoat: 0.3,
+    clearcoatRoughness: 0.1
+  },
+  // ===========================================================================
+  // MORE METALS — extended metallic palette
+  // ===========================================================================
+  titanium: {
+    roughness: 0.25,
+    metalness: 1,
+    color: "#878681"
+  },
+  tungsten: {
+    roughness: 0.3,
+    metalness: 1,
+    color: "#696969"
+  },
+  tin: {
+    roughness: 0.35,
+    metalness: 1,
+    color: "#b0b0b0",
+    envMapIntensity: 0.8
+  },
+  lead: {
+    roughness: 0.6,
+    metalness: 0.9,
+    color: "#595959"
+  },
+  brass: {
+    roughness: 0.35,
+    metalness: 1,
+    color: "#b5a642"
+  },
+  wrought_iron: {
+    roughness: 0.7,
+    metalness: 0.85,
+    color: "#2c2c2c"
+  },
+  mercury: {
+    roughness: 0,
+    metalness: 1,
+    color: "#d4d4d4",
+    envMapIntensity: 2
+  },
+  // ===========================================================================
+  // NATURAL / WEATHER — environmental surfaces
+  // ===========================================================================
+  snow: {
+    roughness: 0.8,
+    metalness: 0,
+    color: "#f0f8ff",
+    thickness: 0.5,
+    attenuationColor: "#c8e0ff",
+    attenuationDistance: 2
+  },
+  fresh_snow: {
+    roughness: 0.6,
+    metalness: 0,
+    color: "#ffffff",
+    sheen: 0.3,
+    sheenRoughness: 0.5,
+    sheenColor: "#e8f0ff"
+  },
+  frost: {
+    roughness: 0.3,
+    metalness: 0,
+    color: "#e8f4f8",
+    transmission: 0.15,
+    ior: 1.31,
+    clearcoat: 0.4,
+    clearcoatRoughness: 0.1
+  },
+  ice: {
+    roughness: 0.1,
+    metalness: 0,
+    color: "#d6eaf8",
+    transmission: 0.8,
+    ior: 1.31,
+    transparent: true
+  },
+  moss: {
+    roughness: 1,
+    metalness: 0,
+    color: "#4a7c3f",
+    sheen: 0.2,
+    sheenRoughness: 1,
+    sheenColor: "#5a9c4f"
+  },
+  lichen: {
+    roughness: 0.9,
+    metalness: 0,
+    color: "#8fa37a"
+  },
+  bark: {
+    roughness: 0.95,
+    metalness: 0,
+    color: "#5c4033"
+  },
+  dried_leaves: {
+    roughness: 0.9,
+    metalness: 0,
+    color: "#8b6914",
+    thickness: 0.1,
+    attenuationColor: "#664400",
+    attenuationDistance: 0.3
+  },
+  // ===========================================================================
+  // AGED / WEATHERED — patina, tarnish, wear
+  // ===========================================================================
+  patina: {
+    roughness: 0.6,
+    metalness: 0.4,
+    color: "#4a9c7e"
+  },
+  tarnished_silver: {
+    roughness: 0.5,
+    metalness: 0.7,
+    color: "#8a8a7a"
+  },
+  aged_bronze: {
+    roughness: 0.55,
+    metalness: 0.6,
+    color: "#6b8e5a"
+  },
+  weathered_wood: {
+    roughness: 0.95,
+    metalness: 0,
+    color: "#8a8070"
+  },
+  cracked_paint: {
+    roughness: 0.8,
+    metalness: 0,
+    color: "#c8c0b0"
+  },
+  oxidized_copper: {
+    roughness: 0.65,
+    metalness: 0.5,
+    color: "#2e8b57"
+  },
+  // ===========================================================================
+  // CONSTRUCTION — architectural materials
+  // ===========================================================================
+  asphalt: {
+    roughness: 0.9,
+    metalness: 0,
+    color: "#3a3a3a"
+  },
+  cement: {
+    roughness: 0.85,
+    metalness: 0,
+    color: "#a0a0a0"
+  },
+  tile_ceramic: {
+    roughness: 0.2,
+    metalness: 0,
+    color: "#e8e0d0",
+    clearcoat: 0.6,
+    clearcoatRoughness: 0.05
+  },
+  tile_porcelain: {
+    roughness: 0.1,
+    metalness: 0,
+    color: "#f5f5f5",
+    clearcoat: 0.8,
+    clearcoatRoughness: 0.02
+  },
+  linoleum: {
+    roughness: 0.6,
+    metalness: 0,
+    color: "#c0b090",
+    clearcoat: 0.2,
+    clearcoatRoughness: 0.3
+  },
+  drywall: {
+    roughness: 1,
+    metalness: 0,
+    color: "#f0ece0"
+  },
+  rebar: {
+    roughness: 0.6,
+    metalness: 0.9,
+    color: "#5a4a3a"
+  },
+  stucco: {
+    roughness: 0.95,
+    metalness: 0,
+    color: "#e8dcc8"
+  },
+  gravel: {
+    roughness: 1,
+    metalness: 0.02,
+    color: "#8a8070"
+  },
+  // ===========================================================================
+  // LEATHER VARIANTS — sheen + clearcoat differentiation
+  // ===========================================================================
+  suede: {
+    roughness: 1,
+    metalness: 0,
+    color: "#8b6914",
+    sheen: 0.6,
+    sheenRoughness: 1,
+    sheenColor: "#a07828"
+  },
+  patent_leather: {
+    roughness: 0.05,
+    metalness: 0,
+    color: "#1a1a1a",
+    clearcoat: 1,
+    clearcoatRoughness: 0.02
+  },
+  distressed_leather: {
+    roughness: 0.8,
+    metalness: 0,
+    color: "#5a3a1a",
+    sheen: 0.15,
+    sheenRoughness: 0.8,
+    sheenColor: "#4a3010"
+  },
+  nubuck: {
+    roughness: 0.95,
+    metalness: 0,
+    color: "#c8a882",
+    sheen: 0.5,
+    sheenRoughness: 0.9,
+    sheenColor: "#d4b892"
+  },
+  // ===========================================================================
+  // RUBBER VARIANTS
+  // ===========================================================================
+  tire_rubber: {
+    roughness: 0.85,
+    metalness: 0,
+    color: "#1a1a1a"
+  },
+  silicone: {
+    roughness: 0.6,
+    metalness: 0,
+    color: "#e0e0e0",
+    thickness: 0.5,
+    attenuationColor: "#cccccc",
+    attenuationDistance: 1,
+    transmission: 0.05
+  },
+  latex: {
+    roughness: 0.3,
+    metalness: 0,
+    color: "#ffefd5",
+    clearcoat: 0.5,
+    clearcoatRoughness: 0.1,
+    thickness: 0.3,
+    attenuationColor: "#ffcc88",
+    attenuationDistance: 0.5
+  },
+  eraser: {
+    roughness: 0.95,
+    metalness: 0,
+    color: "#ff6b81"
+  },
+  // ===========================================================================
+  // LIQUIDS — transmission + animated surface hints
+  // ===========================================================================
+  lava: {
+    roughness: 0.8,
+    metalness: 0,
+    color: "#ff4400",
+    emissive: "#ff2200",
+    emissiveIntensity: 3
+  },
+  blood: {
+    roughness: 0.2,
+    metalness: 0,
+    color: "#8b0000",
+    clearcoat: 0.7,
+    clearcoatRoughness: 0.05,
+    thickness: 1,
+    attenuationColor: "#440000",
+    attenuationDistance: 0.3
+  },
+  oil_liquid: {
+    roughness: 0.05,
+    metalness: 0,
+    color: "#1a1a0a",
+    clearcoat: 0.9,
+    clearcoatRoughness: 0.02
+  },
+  molten_metal: {
+    roughness: 0.15,
+    metalness: 0.8,
+    color: "#ff8c00",
+    emissive: "#ff6600",
+    emissiveIntensity: 5
+  },
+  syrup: {
+    roughness: 0.1,
+    metalness: 0,
+    color: "#8b4513",
+    transmission: 0.4,
+    ior: 1.49,
+    thickness: 2,
+    attenuationColor: "#663300",
+    attenuationDistance: 0.5
+  },
+  // ===========================================================================
+  // BLACKBODY / THERMAL — temperature-driven emission
+  // ===========================================================================
+  heated_metal_low: {
+    roughness: 0.5,
+    metalness: 0.9,
+    color: "#4a4a4a",
+    emissive: "#ff1a00",
+    emissiveIntensity: 1.5
+  },
+  heated_metal_mid: {
+    roughness: 0.4,
+    metalness: 0.8,
+    color: "#5a5a5a",
+    emissive: "#ff6600",
+    emissiveIntensity: 3
+  },
+  heated_metal_hot: {
+    roughness: 0.3,
+    metalness: 0.7,
+    color: "#6a6a6a",
+    emissive: "#ffcc00",
+    emissiveIntensity: 5
+  },
+  heated_metal_white: {
+    roughness: 0.2,
+    metalness: 0.6,
+    color: "#8a8a8a",
+    emissive: "#ffffff",
+    emissiveIntensity: 8
+  },
+  ember: {
+    roughness: 0.9,
+    metalness: 0,
+    color: "#2a0a00",
+    emissive: "#ff4400",
+    emissiveIntensity: 2
+  },
+  coal: {
+    roughness: 0.85,
+    metalness: 0,
+    color: "#1a1a1a",
+    emissive: "#cc2200",
+    emissiveIntensity: 0.5
+  },
+  // ===========================================================================
+  // SPECIAL EFFECTS — sparkle, glow, energy
+  // ===========================================================================
+  glitter: {
+    roughness: 0.2,
+    metalness: 0.8,
+    color: "#ffd700",
+    envMapIntensity: 2
+  },
+  sequin: {
+    roughness: 0.05,
+    metalness: 1,
+    envMapIntensity: 2.5,
+    iridescence: 0.3
+  },
+  mica: {
+    roughness: 0.3,
+    metalness: 0.2,
+    color: "#c8b888",
+    iridescence: 0.4,
+    iridescenceIOR: 1.58,
+    sheen: 0.2,
+    sheenRoughness: 0.3,
+    sheenColor: "#d4c498"
+  },
+  fluorescent_green: {
+    roughness: 0.5,
+    metalness: 0,
+    color: "#39ff14",
+    emissive: "#39ff14",
+    emissiveIntensity: 1.5
+  },
+  fluorescent_orange: {
+    roughness: 0.5,
+    metalness: 0,
+    color: "#ff6700",
+    emissive: "#ff6700",
+    emissiveIntensity: 1.5
+  },
+  fluorescent_pink: {
+    roughness: 0.5,
+    metalness: 0,
+    color: "#ff1493",
+    emissive: "#ff1493",
+    emissiveIntensity: 1.5
+  },
+  glow_in_dark: {
+    roughness: 0.7,
+    metalness: 0,
+    color: "#2a3a2a",
+    emissive: "#44ff44",
+    emissiveIntensity: 0.8
+  },
+  plasma: {
+    roughness: 0,
+    metalness: 0,
+    color: "#4400ff",
+    emissive: "#8844ff",
+    emissiveIntensity: 4,
+    transparent: true,
+    opacity: 0.7
+  },
+  energy_field: {
+    roughness: 0,
+    metalness: 0,
+    emissive: "#00ccff",
+    emissiveIntensity: 3,
+    transparent: true,
+    opacity: 0.4,
+    transmission: 0.6
+  },
+  force_field: {
+    roughness: 0,
+    metalness: 0,
+    emissive: "#00ff88",
+    emissiveIntensity: 2,
+    transparent: true,
+    opacity: 0.2,
+    iridescence: 0.8,
+    iridescenceIOR: 1.5
+  },
+  // ===========================================================================
+  // RETROREFLECTIVE — safety, signage
+  // ===========================================================================
+  safety_vest: {
+    roughness: 0.6,
+    metalness: 0,
+    color: "#ccff00",
+    emissive: "#ccff00",
+    emissiveIntensity: 0.3
+  },
+  road_sign: {
+    roughness: 0.4,
+    metalness: 0.1,
+    color: "#ffffff",
+    envMapIntensity: 1.8,
+    emissive: "#ffffff",
+    emissiveIntensity: 0.2
+  },
+  reflective_tape: {
+    roughness: 0.2,
+    metalness: 0.3,
+    color: "#e0e0e0",
+    envMapIntensity: 2.5
+  },
+  // ===========================================================================
+  // MISC — everything else in the real world
+  // ===========================================================================
+  chalkboard: {
+    roughness: 0.9,
+    metalness: 0,
+    color: "#2a3a2a"
+  },
+  chalk: {
+    roughness: 1,
+    metalness: 0,
+    color: "#ffffff"
+  },
+  charcoal: {
+    roughness: 0.9,
+    metalness: 0,
+    color: "#1a1a1a"
+  },
+  cork: {
+    roughness: 0.95,
+    metalness: 0,
+    color: "#b88a50"
+  },
+  felt: {
+    roughness: 1,
+    metalness: 0,
+    color: "#5a8a5a",
+    sheen: 0.4,
+    sheenRoughness: 1,
+    sheenColor: "#6a9a6a"
+  },
+  sponge: {
+    roughness: 1,
+    metalness: 0,
+    color: "#e8c840"
+  },
+  porcelain: {
+    roughness: 0.1,
+    metalness: 0,
+    color: "#f8f4f0",
+    clearcoat: 0.7,
+    clearcoatRoughness: 0.02
+  },
+  terracotta: {
+    roughness: 0.85,
+    metalness: 0,
+    color: "#cc6644"
+  },
+  concrete_polished: {
+    roughness: 0.3,
+    metalness: 0,
+    color: "#a0a0a0",
+    clearcoat: 0.3,
+    clearcoatRoughness: 0.15
+  },
+  rope: {
+    roughness: 1,
+    metalness: 0,
+    color: "#c4a35a",
+    sheen: 0.2,
+    sheenRoughness: 1,
+    sheenColor: "#b89848"
+  },
+  wicker: {
+    roughness: 0.9,
+    metalness: 0,
+    color: "#a08050"
+  },
+  parchment: {
+    roughness: 0.8,
+    metalness: 0,
+    color: "#f0e6c8",
+    thickness: 0.1,
+    attenuationColor: "#d4c0a0",
+    attenuationDistance: 0.2
+  },
+  // ===========================================================================
+  // ANIMATED MATERIALS — time-driven surface effects (wired to scene.time)
+  // These set metadata flags that the runtime uses to drive animated shaders.
+  // ===========================================================================
+  flowing_water: {
+    roughness: 0,
+    metalness: 0,
+    color: "#006994",
+    transmission: 0.85,
+    ior: 1.33,
+    transparent: true,
+    _animated: { pattern: "flow", speed: 0.8, amplitude: 0.3 }
+  },
+  rippling_water: {
+    roughness: 0.05,
+    metalness: 0,
+    color: "#005577",
+    transmission: 0.8,
+    ior: 1.33,
+    transparent: true,
+    _animated: { pattern: "ripple", speed: 1, amplitude: 0.4 }
+  },
+  flickering_fire: {
+    roughness: 0.8,
+    metalness: 0,
+    color: "#ff4400",
+    emissive: "#ff2200",
+    emissiveIntensity: 3,
+    _animated: { pattern: "flicker", speed: 3, amplitude: 0.6 }
+  },
+  pulsing_glow: {
+    roughness: 0.5,
+    metalness: 0,
+    emissive: "#00ff88",
+    emissiveIntensity: 2,
+    _animated: { pattern: "pulse", speed: 1.5, amplitude: 0.5 }
+  },
+  breathing_light: {
+    roughness: 0.3,
+    metalness: 0,
+    emissive: "#4488ff",
+    emissiveIntensity: 1.5,
+    _animated: { pattern: "breathe", speed: 0.5, amplitude: 0.8 }
+  },
+  scrolling_lava: {
+    roughness: 0.8,
+    metalness: 0,
+    color: "#ff4400",
+    emissive: "#ff2200",
+    emissiveIntensity: 4,
+    _animated: { pattern: "scroll", speed: 0.3, amplitude: 1 }
+  },
+  waving_grass: {
+    roughness: 0.9,
+    metalness: 0,
+    color: "#228b22",
+    sheen: 0.2,
+    sheenRoughness: 0.8,
+    sheenColor: "#44cc22",
+    _animated: { pattern: "wave", speed: 0.8, amplitude: 0.2 }
+  },
+  flickering_neon: {
+    roughness: 0,
+    metalness: 0,
+    emissive: "#ff00ff",
+    emissiveIntensity: 3.5,
+    transparent: true,
+    opacity: 0.9,
+    _animated: { pattern: "flicker", speed: 5, amplitude: 0.4 }
+  },
+  pulsing_crystal: {
+    roughness: 0,
+    metalness: 0.1,
+    transmission: 0.8,
+    ior: 2,
+    iridescence: 0.8,
+    iridescenceIOR: 1.3,
+    emissive: "#8844ff",
+    emissiveIntensity: 1,
+    _animated: { pattern: "pulse", speed: 0.8, amplitude: 0.6 }
+  },
+  animated_hologram: {
+    roughness: 0,
+    metalness: 0.3,
+    transparent: true,
+    opacity: 0.5,
+    emissive: "#00ccff",
+    emissiveIntensity: 1.5,
+    _animated: { pattern: "scroll", speed: 1.5, amplitude: 0.3 }
+  },
+  boiling_surface: {
+    roughness: 0.7,
+    metalness: 0,
+    color: "#cc4400",
+    emissive: "#ff6600",
+    emissiveIntensity: 2,
+    _animated: { pattern: "noise", speed: 2, amplitude: 0.5 }
+  },
+  shimmer_heat: {
+    roughness: 0,
+    metalness: 0,
+    transparent: true,
+    opacity: 0.15,
+    _animated: { pattern: "wave", speed: 2, amplitude: 0.1 }
+  },
+  // ===========================================================================
+  // VOLUMETRIC MATERIALS — metadata for ray-marched volume rendering
+  // These presets describe volumetric phenomena; the runtime renders them via
+  // a ray marching pass on a bounding box/sphere geometry.
+  // ===========================================================================
+  fog: {
+    roughness: 0,
+    metalness: 0,
+    color: "#c0c0c0",
+    transparent: true,
+    opacity: 0.3,
+    _volumetric: { type: "fog", density: 0.3, scattering: 0.8, absorption: 0.05 }
+  },
+  dense_fog: {
+    roughness: 0,
+    metalness: 0,
+    color: "#a0a0a0",
+    transparent: true,
+    opacity: 0.5,
+    _volumetric: { type: "fog", density: 0.7, scattering: 0.9, absorption: 0.1 }
+  },
+  smoke: {
+    roughness: 0,
+    metalness: 0,
+    color: "#404040",
+    transparent: true,
+    opacity: 0.4,
+    _volumetric: {
+      type: "smoke",
+      density: 0.5,
+      scattering: 0.3,
+      absorption: 0.4,
+      riseSpeed: 0.5,
+      turbulence: 0.6
+    }
+  },
+  campfire_smoke: {
+    roughness: 0,
+    metalness: 0,
+    color: "#505050",
+    transparent: true,
+    opacity: 0.35,
+    _volumetric: {
+      type: "smoke",
+      density: 0.4,
+      scattering: 0.25,
+      absorption: 0.5,
+      riseSpeed: 0.8,
+      turbulence: 0.4
+    }
+  },
+  fire_volume: {
+    roughness: 0,
+    metalness: 0,
+    color: "#ff4400",
+    emissive: "#ff2200",
+    emissiveIntensity: 4,
+    transparent: true,
+    opacity: 0.7,
+    _volumetric: {
+      type: "fire",
+      density: 0.6,
+      scattering: 0.1,
+      absorption: 0.2,
+      riseSpeed: 1.2,
+      turbulence: 0.7,
+      temperature: 2500
+    }
+  },
+  candle_flame: {
+    roughness: 0,
+    metalness: 0,
+    color: "#ffaa33",
+    emissive: "#ff8800",
+    emissiveIntensity: 3,
+    transparent: true,
+    opacity: 0.6,
+    _volumetric: {
+      type: "fire",
+      density: 0.4,
+      scattering: 0.05,
+      absorption: 0.1,
+      riseSpeed: 0.3,
+      turbulence: 0.2,
+      temperature: 1800
+    }
+  },
+  clouds: {
+    roughness: 0,
+    metalness: 0,
+    color: "#ffffff",
+    transparent: true,
+    opacity: 0.6,
+    _volumetric: {
+      type: "clouds",
+      density: 0.4,
+      scattering: 0.95,
+      absorption: 0.02,
+      noiseScale: 2,
+      octaves: 6
+    }
+  },
+  storm_clouds: {
+    roughness: 0,
+    metalness: 0,
+    color: "#3a3a4a",
+    transparent: true,
+    opacity: 0.8,
+    _volumetric: {
+      type: "clouds",
+      density: 0.7,
+      scattering: 0.6,
+      absorption: 0.15,
+      noiseScale: 1.5,
+      octaves: 6
+    }
+  },
+  dust_motes: {
+    roughness: 0,
+    metalness: 0,
+    color: "#c8b888",
+    transparent: true,
+    opacity: 0.15,
+    _volumetric: { type: "dust", density: 0.1, scattering: 0.5, absorption: 0.02 }
+  },
+  mist: {
+    roughness: 0,
+    metalness: 0,
+    color: "#e0e8f0",
+    transparent: true,
+    opacity: 0.25,
+    _volumetric: {
+      type: "mist",
+      density: 0.2,
+      scattering: 0.85,
+      absorption: 0.03,
+      heightFalloff: 1.5
+    }
+  },
+  steam: {
+    roughness: 0,
+    metalness: 0,
+    color: "#e8e8e8",
+    transparent: true,
+    opacity: 0.3,
+    _volumetric: {
+      type: "steam",
+      density: 0.35,
+      scattering: 0.7,
+      absorption: 0.05,
+      riseSpeed: 1,
+      turbulence: 0.3
+    }
+  },
+  aurora_borealis: {
+    roughness: 0,
+    metalness: 0,
+    emissive: "#00ff88",
+    emissiveIntensity: 2,
+    transparent: true,
+    opacity: 0.3,
+    _volumetric: {
+      type: "aurora",
+      density: 0.15,
+      scattering: 0.1,
+      absorption: 0.01,
+      emissionIntensity: 2
+    }
+  },
+  nebula: {
+    roughness: 0,
+    metalness: 0,
+    emissive: "#ff44aa",
+    emissiveIntensity: 1.5,
+    transparent: true,
+    opacity: 0.4,
+    _volumetric: {
+      type: "nebula",
+      density: 0.25,
+      scattering: 0.3,
+      absorption: 0.05,
+      emissionIntensity: 1.5,
+      noiseScale: 1
+    }
+  },
+  underwater_caustics: {
+    roughness: 0,
+    metalness: 0,
+    color: "#003366",
+    transparent: true,
+    opacity: 0.2,
+    _volumetric: { type: "underwater", density: 0.15, scattering: 0.6, absorption: 0.1 }
+  },
+  god_rays: {
+    roughness: 0,
+    metalness: 0,
+    color: "#ffffd0",
+    transparent: true,
+    opacity: 0.15,
+    emissive: "#ffff88",
+    emissiveIntensity: 0.5,
+    _volumetric: { type: "god_rays", density: 0.1, scattering: 0.9, absorption: 0.01 }
+  },
+  neon_gas: {
+    roughness: 0,
+    metalness: 0,
+    emissive: "#ff4400",
+    emissiveIntensity: 3,
+    transparent: true,
+    opacity: 0.5,
+    _volumetric: {
+      type: "neon_gas",
+      density: 0.3,
+      scattering: 0.2,
+      absorption: 0.05,
+      emissionIntensity: 3
+    }
+  },
+  explosion: {
+    roughness: 0,
+    metalness: 0,
+    color: "#ff6600",
+    emissive: "#ff4400",
+    emissiveIntensity: 6,
+    transparent: true,
+    opacity: 0.8,
+    _volumetric: {
+      type: "fire",
+      density: 0.8,
+      scattering: 0.15,
+      absorption: 0.3,
+      riseSpeed: 2,
+      turbulence: 1,
+      temperature: 4e3
+    }
+  },
+  toxic_gas: {
+    roughness: 0,
+    metalness: 0,
+    color: "#44cc00",
+    emissive: "#33aa00",
+    emissiveIntensity: 1,
+    transparent: true,
+    opacity: 0.35,
+    _volumetric: {
+      type: "smoke",
+      density: 0.3,
+      scattering: 0.4,
+      absorption: 0.2,
+      riseSpeed: 0.2,
+      turbulence: 0.3
+    }
+  },
+  magical_mist: {
+    roughness: 0,
+    metalness: 0,
+    emissive: "#8844ff",
+    emissiveIntensity: 1.5,
+    transparent: true,
+    opacity: 0.3,
+    iridescence: 0.6,
+    iridescenceIOR: 1.5,
+    _volumetric: {
+      type: "mist",
+      density: 0.2,
+      scattering: 0.5,
+      absorption: 0.03,
+      emissionIntensity: 1.5
+    }
+  },
+  // --- Architectural & Natural Stone ---
+  brick: { roughness: 0.9, metalness: 0, color: "#a6523c" },
+  concrete: { roughness: 0.88, metalness: 0, color: "#8a8a8a" },
+  granite: { roughness: 0.6, metalness: 0, color: "#666670" },
+  sandstone: { roughness: 0.85, metalness: 0, color: "#cca66e" },
+  slate: { roughness: 0.7, metalness: 0, color: "#3f4450" },
+  adobe: { roughness: 0.95, metalness: 0, color: "#bf9160" },
+  plaster: { roughness: 0.82, metalness: 0, color: "#ebe8de" },
+  // --- Plant & Cellulose ---
+  bamboo: { roughness: 0.65, metalness: 0, color: "#b3a84d" },
+  paper: { roughness: 0.9, metalness: 0, color: "#f3f0e5" },
+  cardboard: { roughness: 0.88, metalness: 0, color: "#b88c58" },
+  // --- Organic & Animal ---
+  bone: { roughness: 0.7, metalness: 0, color: "#e0d4b5" },
+  ivory: { roughness: 0.35, metalness: 0, color: "#f0e8c5", envMapIntensity: 0.4 },
+  coral: { roughness: 0.75, metalness: 0, color: "#f2614d" },
+  shell: {
+    roughness: 0.25,
+    metalness: 0.05,
+    color: "#f5ede0",
+    iridescence: 0.8,
+    iridescenceIOR: 1.5,
+    envMapIntensity: 0.6
+  },
+  thatch: { roughness: 0.95, metalness: 0, color: "#c0a84a" },
+  // --- Synthetic & Engineered ---
+  resin: {
+    roughness: 0.08,
+    metalness: 0,
+    transmission: 0.75,
+    ior: 1.5,
+    color: "#e8c46a",
+    transparent: true,
+    opacity: 0.88
+  },
+  foam: { roughness: 0.95, metalness: 0, color: "#f0f0f0" },
+  composite: { roughness: 0.5, metalness: 0.25, color: "#333338" },
+  carbon_fiber: {
+    roughness: 0.28,
+    metalness: 0.6,
+    color: "#111114",
+    envMapIntensity: 1.2,
+    clearcoat: 0.6,
+    clearcoatRoughness: 0.1
+  },
+  kevlar: { roughness: 0.82, metalness: 0, color: "#ccbb66" },
+  fiberglass: {
+    roughness: 0.3,
+    metalness: 0.05,
+    transmission: 0.4,
+    ior: 1.45,
+    color: "#e0ede0",
+    transparent: true,
+    opacity: 0.92
+  },
+  stained_glass: {
+    roughness: 0.05,
+    metalness: 0,
+    transmission: 0.85,
+    ior: 1.52,
+    color: "#cc44ff",
+    transparent: true,
+    opacity: 0.75,
+    thickness: 0.3
+  }
+};
+var ENVIRONMENT_PRESETS = {
+  forest_sunset: {
+    background: true,
+    envPreset: "sunset",
+    fog: { color: "#ff9966", near: 10, far: 100 },
+    ground: { color: "#2d5a27" },
+    lighting: {
+      ambient: { color: "#ffa366", intensity: 0.3 },
+      directional: { color: "#ff7700", intensity: 1.5, position: [10, 20, 5], shadows: true }
+    }
+  },
+  cyberpunk_city: {
+    background: true,
+    envPreset: "night",
+    fog: { color: "#0a0020", near: 5, far: 60 },
+    ground: { color: "#1a1a2e" },
+    lighting: {
+      ambient: { color: "#220044", intensity: 0.2 },
+      directional: { color: "#ff00ff", intensity: 0.5, position: [5, 15, 5], shadows: true },
+      points: [
+        { color: "#00ffff", intensity: 3, position: [-5, 3, -5], distance: 15 },
+        { color: "#ff00ff", intensity: 3, position: [5, 3, 5], distance: 15 }
+      ]
+    },
+    postprocessing: { bloom: { intensity: 1.5, luminanceThreshold: 0.1 } }
+  },
+  space_void: {
+    background: true,
+    envPreset: "night",
+    lighting: {
+      ambient: { color: "#111133", intensity: 0.1 },
+      directional: { color: "#ffffff", intensity: 0.5, position: [0, 10, 0], shadows: false }
+    }
+  },
+  studio: {
+    background: true,
+    envPreset: "studio",
+    ground: { color: "#cccccc" },
+    lighting: {
+      ambient: { color: "#ffffff", intensity: 0.4 },
+      directional: { color: "#ffffff", intensity: 1, position: [5, 10, 5], shadows: true }
+    }
+  },
+  underwater: {
+    background: true,
+    envPreset: "dawn",
+    fog: { color: "#003366", near: 2, far: 40 },
+    ground: { color: "#1a3a4a" },
+    lighting: {
+      ambient: { color: "#004488", intensity: 0.3 },
+      directional: { color: "#66aacc", intensity: 0.8, position: [0, 20, 0], shadows: true }
+    }
+  },
+  desert: {
+    background: true,
+    envPreset: "sunset",
+    fog: { color: "#d4a574", near: 20, far: 150 },
+    ground: { color: "#c4a35a" },
+    lighting: {
+      ambient: { color: "#f5deb3", intensity: 0.4 },
+      directional: { color: "#ffffcc", intensity: 2, position: [15, 30, 10], shadows: true }
+    }
+  }
+};
+var MESH_TYPES = /* @__PURE__ */ new Set([
+  "orb",
+  "sphere",
+  "cube",
+  "box",
+  "cylinder",
+  "pyramid",
+  "cone",
+  "plane",
+  "torus",
+  "ring",
+  "capsule",
+  "object",
+  "avatar",
+  "dna",
+  "nerf",
+  "volumetric_video",
+  // Procedural geometry types (hull/spline/membrane/blob/metaball)
+  "hull",
+  "spline",
+  "membrane",
+  "blob",
+  "metaball"
+]);
+var UI_COMPONENT_PRESETS = {
+  UIPanel: {
+    component: "Container",
+    // @react-three/uikit Container
+    defaultProps: {
+      flexDirection: "column",
+      padding: 16,
+      backgroundColor: "rgba(0, 0, 0, 0.8)",
+      borderRadius: 8
+    }
+  },
+  UIText: {
+    component: "Text",
+    // @react-three/uikit Text
+    defaultProps: {
+      fontSize: 16,
+      color: "white"
+    }
+  },
+  UIButton: {
+    component: "Button",
+    // Custom button using Container with hover
+    defaultProps: {
+      padding: 12,
+      paddingX: 24,
+      backgroundColor: "#4a90d9",
+      borderRadius: 4,
+      cursor: "pointer"
+    }
+  },
+  UISlider: {
+    component: "Slider",
+    // Custom slider implementation
+    defaultProps: {
+      width: 200,
+      height: 20,
+      trackColor: "#333",
+      fillColor: "#4a90d9",
+      thumbSize: 16
+    }
+  },
+  UIInput: {
+    component: "Input",
+    // @react-three/uikit Input
+    defaultProps: {
+      width: 200,
+      padding: 8,
+      backgroundColor: "#222",
+      borderColor: "#444",
+      borderWidth: 1,
+      borderRadius: 4,
+      color: "white"
+    }
+  },
+  UIImage: {
+    component: "Image",
+    // @react-three/uikit Image
+    defaultProps: {
+      objectFit: "contain"
+    }
+  },
+  UIChart: {
+    component: "Chart",
+    // Custom chart component
+    defaultProps: {
+      width: 300,
+      height: 200,
+      backgroundColor: "#1a1a2e"
+    }
+  },
+  UIGauge: {
+    component: "Gauge",
+    // Custom gauge component
+    defaultProps: {
+      size: 100,
+      strokeWidth: 8,
+      trackColor: "#333",
+      fillColor: "#4a90d9"
+    }
+  }
+};
+var QUALITY_TIER_SCALES = {
+  low: {
+    particleScale: 0.25,
+    lodLevel: "draft",
+    maxLights: 2,
+    shadowMapSize: 512,
+    shaderComplexity: "basic"
+  },
+  med: {
+    particleScale: 0.6,
+    lodLevel: "mesh",
+    maxLights: 4,
+    shadowMapSize: 1024,
+    shaderComplexity: "standard"
+  },
+  high: {
+    particleScale: 1,
+    lodLevel: "final",
+    maxLights: 8,
+    shadowMapSize: 2048,
+    shaderComplexity: "physical"
+  },
+  ultra: {
+    particleScale: 1.5,
+    lodLevel: "final",
+    maxLights: 16,
+    shadowMapSize: 4096,
+    shaderComplexity: "physical"
+  }
+};
+var SceneIRCompiler = class {
+  constructor(options = {}) {
+    // ─── RBAC Enforcement ─────────────────────────────────────────────────
+    this.rbac = chunkZK7KX5CD_cjs.getRBAC();
+    this.compilerName = options.compilerName ?? "SceneIRCompiler";
+    this.qualityTier = options.qualityTier ?? "high";
+    this.tierScales = QUALITY_TIER_SCALES[this.qualityTier];
+    this._defaultLighting = options.defaultLighting ?? true;
+    this._holomapPointCloud = options.holomapPointCloud;
+    if (options.platformTarget) {
+      this._platformTarget = typeof options.platformTarget === "string" ? chunkTZCFKZ6Z_cjs.createPlatformTarget(options.platformTarget) : options.platformTarget;
+    }
+  }
+  /**
+   * Validate agent permissions before compilation.
+   * Skips validation when no token is provided (backwards compatibility).
+   *
+   * Checks:
+   * 1. AST read access (can the agent read AST?)
+   * 2. Code generation access (can the agent generate code?)
+   * 3. Output path scope (if outputPath provided)
+   *
+   * @param agentToken - Agent JWT token (optional for backwards compat)
+   * @param outputPath - Optional output file path for scope validation
+   * @throws UnauthorizedCompilerAccessError if token is provided but invalid/unauthorized
+   */
+  validateCompilerAccess(agentToken, outputPath) {
+    if (!agentToken) return;
+    const astDecision = this.rbac.checkAccess({
+      token: agentToken,
+      resourceType: "ast" /* AST */,
+      operation: "read",
+      expectedWorkflowStep: "generate_assembly" /* GENERATE_ASSEMBLY */
+    });
+    if (!astDecision.allowed) {
+      throw new chunkZK7KX5CD_cjs.UnauthorizedCompilerAccessError(astDecision, "AST access", this.compilerName);
+    }
+    const codeDecision = this.rbac.checkAccess({
+      token: agentToken,
+      resourceType: "code" /* CODE */,
+      operation: "write",
+      expectedWorkflowStep: "generate_assembly" /* GENERATE_ASSEMBLY */
+    });
+    if (!codeDecision.allowed) {
+      throw new chunkZK7KX5CD_cjs.UnauthorizedCompilerAccessError(codeDecision, "code generation", this.compilerName);
+    }
+    if (outputPath) {
+      const outputDecision = this.rbac.checkAccess({
+        token: agentToken,
+        resourceType: "output" /* OUTPUT */,
+        operation: "write",
+        resourcePath: outputPath,
+        expectedWorkflowStep: "serialize" /* SERIALIZE */
+      });
+      if (!outputDecision.allowed) {
+        throw new chunkZK7KX5CD_cjs.UnauthorizedCompilerAccessError(
+          outputDecision,
+          `output write to '${outputPath}'`,
+          this.compilerName
+        );
+      }
+    }
+  }
+  // ─── Spread Expansion Utility ─────────────────────────────────────────
+  /**
+   * Expands spread expressions in a properties object.
+   * Spreads are stored with keys like `__spread_0`, `__spread_1` and have
+   * the structure: { type: 'spread', argument: <value> }
+   *
+   * @param props - The properties object potentially containing spreads
+   * @param context - Optional context for resolving references (templates, state)
+   * @returns A new object with spreads expanded and merged
+   */
+  expandSpreads(props, context) {
+    const result = {};
+    const spreadKeys = [];
+    for (const [key, value] of Object.entries(props)) {
+      if (key.startsWith("__spread_")) {
+        spreadKeys.push(key);
+      } else if (value && typeof value === "object" && value.type === "spread") {
+        spreadKeys.push(key);
+      } else {
+        if (value && typeof value === "object" && !Array.isArray(value) && !("__ref" in value) && !("__expr" in value)) {
+          result[key] = this.expandSpreads(value, context);
+        } else if (Array.isArray(value)) {
+          result[key] = this.expandArraySpreads(value, context);
+        } else {
+          result[key] = value;
+        }
+      }
+    }
+    for (const spreadKey of spreadKeys) {
+      const spreadValue = props[spreadKey];
+      if (spreadValue && typeof spreadValue === "object" && spreadValue.type === "spread") {
+        const resolved = this.resolveSpreadArgument(
+          spreadValue.argument,
+          context
+        );
+        if (resolved && typeof resolved === "object" && !Array.isArray(resolved)) {
+          Object.assign(result, this.expandSpreads(resolved, context));
+        }
+      }
+    }
+    for (const [key, value] of Object.entries(props)) {
+      if (!key.startsWith("__spread_") && !(value && typeof value === "object" && value.type === "spread")) {
+        if (value && typeof value === "object" && !Array.isArray(value) && !("__ref" in value) && !("__expr" in value)) {
+          result[key] = this.expandSpreads(value, context);
+        } else if (Array.isArray(value)) {
+          result[key] = this.expandArraySpreads(value, context);
+        } else {
+          result[key] = value;
+        }
+      }
+    }
+    return result;
+  }
+  /**
+   * Expands spread expressions within an array.
+   * Spread elements have { type: 'spread', argument: <value> }
+   */
+  expandArraySpreads(arr, context) {
+    const result = [];
+    for (const item of arr) {
+      if (item && typeof item === "object" && item.type === "spread") {
+        const resolved = this.resolveSpreadArgument(
+          item.argument,
+          context
+        );
+        if (Array.isArray(resolved)) {
+          result.push(...resolved);
+        } else if (resolved !== void 0 && resolved !== null) {
+          result.push(resolved);
+        }
+      } else if (item && typeof item === "object" && !Array.isArray(item)) {
+        result.push(this.expandSpreads(item, context));
+      } else {
+        result.push(item);
+      }
+    }
+    return result;
+  }
+  /**
+   * Resolves a spread argument to its value.
+   * Handles: direct values, __ref references, template references
+   */
+  resolveSpreadArgument(argument, context) {
+    if (argument === null || argument === void 0) {
+      return void 0;
+    }
+    if (typeof argument === "object" && !("__ref" in argument)) {
+      return argument;
+    }
+    if (typeof argument === "object" && "__ref" in argument) {
+      const ref = argument.__ref;
+      if (context?.templates) {
+        const template = context.templates.get(ref);
+        if (template) {
+          return template.properties || template;
+        }
+      }
+      if (context?.state && ref in context.state) {
+        return context.state[ref];
+      }
+      if (context?.state && ref.includes(".")) {
+        const parts = ref.split(".");
+        let value = context.state;
+        for (const part of parts) {
+          if (value && typeof value === "object" && part in value) {
+            value = value[part];
+          } else {
+            value = void 0;
+            break;
+          }
+        }
+        if (value !== void 0) {
+          return value;
+        }
+      }
+      return argument;
+    }
+    if (typeof argument === "string") {
+      if (context?.templates) {
+        const template = context.templates.get(argument);
+        if (template) {
+          return template.properties || template;
+        }
+      }
+      return { __ref: argument };
+    }
+    return argument;
+  }
+  // ─── HSPlusAST Compilation ────────────────────────────────────────────
+  compile(ast, agentToken, outputPath) {
+    this.validateCompilerAccess(agentToken, outputPath);
+    const root = this.compileNode(ast.root);
+    if (this.hasPostProcessing(root)) {
+      root.children?.unshift({
+        type: "EffectComposer",
+        props: {},
+        children: this.extractPostProcessingNodes(root)
+      });
+    }
+    this.injectDefaultLighting(root);
+    const domainBlocks = ast.domainBlocks ?? [];
+    if (domainBlocks.length > 0) {
+      const compiled = chunkQEDMOGF3_cjs.compileDomainBlocks(
+        domainBlocks,
+        {
+          material: (block) => {
+            const mat = chunkQEDMOGF3_cjs.compileMaterialBlock(block);
+            return {
+              type: "DomainBlockOutput",
+              props: {
+                __raw: chunkQEDMOGF3_cjs.materialToR3F(mat, this.tierScales),
+                __domain: "material",
+                __name: mat.name
+              },
+              children: []
+            };
+          },
+          physics: (block) => {
+            const phys = chunkQEDMOGF3_cjs.compilePhysicsBlock(block);
+            return {
+              type: "DomainBlockOutput",
+              props: {
+                __raw: chunkQEDMOGF3_cjs.physicsToR3F(phys),
+                __domain: "physics",
+                __name: phys.name || phys.keyword
+              },
+              children: []
+            };
+          },
+          vfx: (block) => {
+            const ps = chunkQEDMOGF3_cjs.compileParticleBlock(block);
+            return {
+              type: "DomainBlockOutput",
+              props: {
+                __raw: chunkQEDMOGF3_cjs.particlesToR3F(ps, this.tierScales),
+                __domain: "vfx",
+                __name: ps.name
+              },
+              children: []
+            };
+          },
+          postfx: (block) => {
+            const pp = chunkQEDMOGF3_cjs.compilePostProcessingBlock(block);
+            return {
+              type: "DomainBlockOutput",
+              props: {
+                __raw: chunkQEDMOGF3_cjs.postProcessingToR3F(pp),
+                __domain: "postfx",
+                __name: pp.name || "PostProcessing"
+              },
+              children: []
+            };
+          },
+          audio: (block) => {
+            const audio = chunkQEDMOGF3_cjs.compileAudioSourceBlock(block);
+            return {
+              type: "DomainBlockOutput",
+              props: { __raw: chunkQEDMOGF3_cjs.audioSourceToR3F(audio), __domain: "audio", __name: audio.name },
+              children: []
+            };
+          },
+          weather: (block) => {
+            const weather = chunkQEDMOGF3_cjs.compileWeatherBlock(block);
+            return {
+              type: "DomainBlockOutput",
+              props: {
+                __raw: chunkQEDMOGF3_cjs.weatherToR3F(weather),
+                __domain: "weather",
+                __name: weather.name || "Weather"
+              },
+              children: []
+            };
+          },
+          simulation: (block) => {
+            const sim = chunkQEDMOGF3_cjs.compileSimulationBlock(block);
+            return {
+              type: "DomainBlockOutput",
+              props: {
+                __raw: chunkQEDMOGF3_cjs.simulationToR3F(sim),
+                __domain: "simulation",
+                __name: sim.name || "Simulation"
+              },
+              children: []
+            };
+          },
+          procedural: (block) => this.compileProceduralScatterNode(block) ?? this.createNode("Group", {}, block.name)
+        }
+      );
+      if (!root.children) root.children = [];
+      for (const c of compiled) {
+        if (typeof c === "object") root.children.push(c);
+      }
+    }
+    return root;
+  }
+  /**
+   * Compiles a declarative 'world' node into R3F scene nodes.
+   * Nested `world.children` (objects) are compiled via the same path as top-level objects.
+   */
+  compileWorldNode(world, templateMap) {
+    const nodes = [];
+    const props = {};
+    if (world.properties) {
+      for (const prop of world.properties) {
+        props[prop.key] = prop.value;
+      }
+    }
+    if (props.ambient_light !== void 0) {
+      nodes.push(
+        this.createNode("ambientLight", {
+          intensity: Number(props.ambient_light)
+        })
+      );
+    }
+    if (props.skybox_color !== void 0) {
+      nodes.push(
+        this.createNode("Environment", {
+          background: true,
+          preset: "sunset"
+          // Default preset if just color is given
+        })
+      );
+      nodes.push(
+        this.createNode("color", {
+          attach: "background",
+          args: [props.skybox_color]
+        })
+      );
+    }
+    if (props.gravity !== void 0) {
+      nodes.push(
+        this.createNode("Physics", {
+          gravity: [0, -Number(props.gravity), 0]
+        })
+      );
+    }
+    const childNodes = [];
+    if (world.children && world.children.length > 0) {
+      for (const child of world.children) {
+        childNodes.push(
+          this.compileObjectDecl(child, templateMap)
+        );
+      }
+    }
+    if (childNodes.length === 0) {
+      return nodes;
+    }
+    const group = this.createNode(
+      "group",
+      {},
+      world.name ? chunkZK7KX5CD_cjs.escapeStringValue(world.name, "JSX") : void 0
+    );
+    group.children = [...nodes, ...childNodes];
+    return [group];
+  }
+  createNode(type, props = {}, id) {
+    const node = sceneIRNodePool.acquire();
+    node.type = type;
+    node.id = id;
+    node.props = props;
+    node.children = [];
+    node.traits = /* @__PURE__ */ new Map();
+    node.directives = [];
+    return node;
+  }
+  /**
+   * Compiles a `procedural` domain block (keyword scatter/procedural/generate/
+   * distribute/pcg_graph) into an instanced `scatter` R3FNode that the web R3F
+   * renderer (ScatterMesh) consumes as a THREE.InstancedMesh.
+   *
+   * Before this method, `.holo` scatter/procedural blocks parsed into the IR but
+   * were silently dropped (compileComposition never read composition.domainBlocks),
+   * so every "dense" world rendered only its hand-listed objects.
+   *
+   * Emitted node shape (shared contract with ImmersiveViewer):
+   *   { type: 'scatter', id: block.name, props: { transforms, count, sourceMesh,
+   *     hsType, color?, roughness?, metalness?, emissive? }, children: [] }
+   * where each transform is [x, y, z, rotationY, scale].
+   *
+   * Placement is DETERMINISTIC (seeded mulberry32 — never Math.random) so builds
+   * are reproducible. Placement is uniform on the XZ plane within `bounds`, with a
+   * bounded rejection loop honoring `min_distance`.
+   *
+   * v1 limitations (documented):
+   *  - .glb/.gltf sourceMesh instances as a `box` placeholder (instancing a loaded
+   *    GLB across instances is a follow-up).
+   *  - Placement is flat (y=0); slope/terrain-conforming placement is out of scope.
+   */
+  compileProceduralScatterNode(block) {
+    const proc = chunkQEDMOGF3_cjs.compileProceduralBlock(block);
+    const props = block.properties ?? {};
+    let scatterNode;
+    if (Array.isArray(props.nodes)) {
+      for (const n of props.nodes) {
+        const nType = n.type ?? n.op ?? n.keyword ?? n.kind;
+        if (typeof nType === "string" && nType.toLowerCase().includes("scatter")) {
+          scatterNode = n.properties ?? n;
+          break;
+        }
+      }
+    }
+    const rawCount = props.count ?? scatterNode?.count ?? proc.density;
+    const count = Math.floor(typeof rawCount === "number" ? rawCount : 0);
+    if (count < 1) return null;
+    const sourceMesh = proc.sourceMesh || (scatterNode?.source_mesh || scatterNode?.sourceMesh || scatterNode?.mesh) || "box";
+    const isGlb = /\.(glb|gltf)$/i.test(sourceMesh);
+    const hsType = isGlb ? "box" : sourceMesh;
+    const boundsRaw = props.bounds ?? props.area ?? scatterNode?.bounds ?? [10, 0, 10];
+    const bx = typeof boundsRaw[0] === "number" ? boundsRaw[0] : 10;
+    const bz = typeof boundsRaw[2] === "number" ? boundsRaw[2] : 10;
+    const minDistance = (() => {
+      const md = props.min_distance ?? props.minDistance ?? scatterNode?.min_distance;
+      return typeof md === "number" && md > 0 ? md : 0;
+    })();
+    const sr = proc.scaleRange ?? props.scale_range;
+    const sMin = Array.isArray(sr) && typeof sr[0] === "number" ? sr[0] : 1;
+    const sMax = Array.isArray(sr) && typeof sr[1] === "number" ? sr[1] : 1;
+    const randomRotation = (() => {
+      const rr = props.random_rotation ?? props.randomRotation ?? scatterNode?.random_rotation;
+      return rr === true;
+    })();
+    const seed = typeof proc.seed === "number" ? proc.seed : 1337;
+    const rand = chunkHCX4SMFK_cjs.mulberry32(seed);
+    const halfX = bx / 2;
+    const halfZ = bz / 2;
+    const minDistSq = minDistance * minDistance;
+    const transforms = [];
+    const maxAttempts = count * 30;
+    let attempts = 0;
+    while (transforms.length < count && attempts < maxAttempts) {
+      attempts++;
+      const x = (rand() * 2 - 1) * halfX;
+      const z = (rand() * 2 - 1) * halfZ;
+      if (minDistSq > 0) {
+        let tooClose = false;
+        for (const t of transforms) {
+          const dx = t[0] - x;
+          const dz = t[2] - z;
+          if (dx * dx + dz * dz < minDistSq) {
+            tooClose = true;
+            break;
+          }
+        }
+        if (tooClose) continue;
+      }
+      const ry = randomRotation ? rand() * Math.PI * 2 : 0;
+      const scale = sMin + rand() * (sMax - sMin);
+      transforms.push([x, 0, z, ry, scale]);
+    }
+    if (transforms.length < 1) return null;
+    const materialProps = {};
+    if (props.color != null) materialProps.color = props.color;
+    if (props.roughness != null) materialProps.roughness = props.roughness;
+    if (props.metalness != null) materialProps.metalness = props.metalness;
+    if (props.emissive != null) materialProps.emissive = props.emissive;
+    if (props.material != null) materialProps.material = props.material;
+    return this.createNode(
+      "scatter",
+      {
+        transforms,
+        count: transforms.length,
+        sourceMesh,
+        hsType,
+        ...materialProps
+      },
+      block.name
+    );
+  }
+  /**
+   * I.007 closure: emit a node's compiled petal material spec into its props.
+   * Shared by every trait-bearing compile path (compileNode directives + the
+   * .holo compileObjectDecl obj.traits path) so the emission can't silently miss
+   * the real parser route. The spec is the locked CompiledMaterialSpec shape that
+   * the renderer's buildCompiledMaterial consumes — building the petal material
+   * from `.holo` data instead of hand-authoring it.
+   */
+  emitCompiledLotusMaterial(props, config) {
+    const profile = chunkENZCIQZC_cjs.createBotanicalLotusRenderProfile(config);
+    props.__compiledMaterial = chunkENZCIQZC_cjs.buildLotusPetalMaterialSpec(profile);
+    props.__uniformBindings = chunkENZCIQZC_cjs.LOTUS_PETAL_UNIFORM_BINDINGS;
+    props.__petalGeometry = chunkENZCIQZC_cjs.buildLotusPetalGeometryData(
+      chunkENZCIQZC_cjs.lotusPetalGeometryParamsFromProfile(profile)
+    );
+    props.__petalPlacements = chunkENZCIQZC_cjs.buildLotusFlowerPlacements(profile);
+    const scaffold = chunkENZCIQZC_cjs.buildLotusSceneScaffold();
+    props.__lotusScene = {
+      stemHeight: scaffold.stem.height,
+      scaffold,
+      colors: {
+        water: profile.colors.water,
+        leaf: profile.colors.leaf,
+        leafDark: profile.colors.leaf_dark
+      },
+      // The flower CENTRE: the seed pod (receptacle) ringed by stamen filaments —
+      // the iconic lotus centre, colours + count from the profile.
+      center: {
+        seedPod: profile.colors.seed_pod,
+        seedPodRim: profile.colors.seed_pod_rim,
+        stamen: profile.colors.stamen,
+        stamenTip: profile.colors.stamen_tip,
+        stamenCount: profile.stamen_filament_count,
+        // Carpel layout for the flat-topped "shower-head" seed pod, parsed from the
+        // profile's declared dot pattern (e.g. '1_center_7_12_18_radial' → [1,7,12,18]
+        // = 1 central carpel + radial rings of 7, 12, 18). The renderer recesses a
+        // carpel well per entry — the iconic lotus receptacle, compiled from `.holo`.
+        carpelRings: (profile.seed_pod_dot_pattern?.match(/\d+/g) ?? [
+          "1",
+          "7",
+          "12",
+          "18"
+        ]).map(Number)
+      }
+    };
+    const waterColor = profile.colors.water;
+    const leafColor = profile.colors.leaf;
+    const leafDarkColor = profile.colors.leaf_dark;
+    const stemHeight = scaffold.stem.height;
+    const scaffoldNodes = [
+      this.createNode("mesh", {
+        hsType: "plane",
+        width: scaffold.waterSize,
+        height: scaffold.waterSize,
+        rotation: [-Math.PI / 2, 0, 0],
+        color: waterColor,
+        roughness: 0.22,
+        metalness: 0.5,
+        // Mark the pond as a REFLECTIVE surface — the renderer's generic MeshNode draws
+        // it with a mirror material so the flower + pads reflect (a real water read).
+        reflective: true
+      }),
+      ...scaffold.pads.map(
+        (pad, padIdx) => this.createNode("mesh", {
+          hsType: "lilypad",
+          radius: pad.radius,
+          // Per-pad notch width variation so the pads don't look stamped.
+          notchAngle: 0.48 + padIdx % 3 * 0.07,
+          position: pad.pos,
+          rotation: [-Math.PI / 2, 0, pad.rotation],
+          color: pad.dark ? leafDarkColor : leafColor,
+          roughness: 0.85
+        })
+      )
+    ];
+    const stemNode = this.createNode("group", {
+      __animatedTransform: [
+        { prop: "scaleY", target: "developmentalTime", edge0: 0, edge1: 0.42, from: 1e-3, to: 1 },
+        {
+          prop: "posY",
+          target: "developmentalTime",
+          edge0: 0,
+          edge1: 0.42,
+          from: 0,
+          to: stemHeight / 2
+        }
+      ]
+    });
+    stemNode.children = [
+      this.createNode("mesh", {
+        hsType: "cylinder",
+        radiusTop: scaffold.stem.topRadius,
+        radiusBottom: scaffold.stem.bottomRadius,
+        height: stemHeight,
+        color: leafDarkColor,
+        roughness: 0.7
+      })
+    ];
+    scaffoldNodes.push(stemNode);
+    scaffold.leaves.forEach((lf, i) => {
+      const leafNode = this.createNode("group", {
+        position: lf.pos,
+        __animatedTransform: [
+          {
+            prop: "scaleUniform",
+            target: "developmentalTime",
+            edge0: 0.15 + i * 0.08,
+            edge1: 0.55 + i * 0.08,
+            from: 0,
+            to: 1
+          }
+        ]
+      });
+      leafNode.children = [
+        this.createNode("mesh", {
+          hsType: "cylinder",
+          radiusTop: 0.03,
+          radiusBottom: 0.045,
+          height: lf.height,
+          position: [0, lf.height / 2, 0],
+          color: leafDarkColor,
+          roughness: 0.7
+        }),
+        this.createNode("mesh", {
+          hsType: "circle",
+          radius: lf.radius,
+          position: [0, lf.height, 0],
+          rotation: [-Math.PI / 2 + lf.tilt, 0, lf.rotation],
+          color: lf.dark ? leafDarkColor : leafColor,
+          roughness: 0.8
+        })
+      ];
+      scaffoldNodes.push(leafNode);
+    });
+    props.__scaffoldNodes = scaffoldNodes;
+  }
+  compileNode(node) {
+    if (node.type === "system") {
+      return this.compileSystemNode(node);
+    }
+    if (node.type === "component") {
+      return this.compileComponentNode(node);
+    }
+    if (node.type === "timeline") {
+      return this.compileHsplusTimelineNode(node);
+    }
+    const rawProps = node.properties || {};
+    const type = this.mapType(node.type, rawProps);
+    const r3fNode = sceneIRNodePool.acquire();
+    r3fNode.type = type;
+    const rawId = node.id || node.name;
+    r3fNode.id = rawId ? chunkZK7KX5CD_cjs.escapeStringValue(rawId, "JSX") : void 0;
+    r3fNode.props = this.compileProperties(node, rawProps);
+    r3fNode.children = [];
+    r3fNode.traits = /* @__PURE__ */ new Map();
+    r3fNode.directives = node.directives || [];
+    if (node.directives) {
+      for (const directive of node.directives) {
+        if (directive.type === "trait") {
+          r3fNode.traits?.set(
+            directive.name,
+            directive.config
+          );
+        }
+      }
+    }
+    const lotusConfig = r3fNode.traits?.get("botanical_lotus");
+    if (lotusConfig) {
+      this.emitCompiledLotusMaterial(r3fNode.props, lotusConfig);
+    }
+    const enhanced = node;
+    if (enhanced.graphics) {
+      this.applyGraphicsConfig(r3fNode, enhanced.graphics);
+    }
+    if (enhanced.children && Array.isArray(enhanced.children)) {
+      r3fNode.children = enhanced.children.map(
+        (child) => this.compileNode(child)
+      );
+    }
+    return r3fNode;
+  }
+  // ─── HoloComposition Compilation (.holo files) ────────────────────────
+  compileComposition(composition, agentToken, outputPath) {
+    this.validateCompilerAccess(agentToken, outputPath);
+    if (this._platformTarget) {
+      const platformMixin = new chunkTZCFKZ6Z_cjs.PlatformConditionalCompilerMixin();
+      composition = platformMixin.filterForPlatform(composition, this._platformTarget);
+    }
+    const root = sceneIRNodePool.acquire();
+    root.type = "group";
+    root.id = composition.name ? chunkZK7KX5CD_cjs.escapeStringValue(composition.name, "JSX") : void 0;
+    root.props = {};
+    root.children = [];
+    root.traits = /* @__PURE__ */ new Map();
+    root.directives = [];
+    const templateMap = /* @__PURE__ */ new Map();
+    if (Array.isArray(composition.templates)) {
+      for (const tmpl of composition.templates) {
+        templateMap.set(tmpl.name, tmpl);
+      }
+    }
+    if (composition.children && Array.isArray(composition.children)) {
+      for (const child of composition.children) {
+        if (child.type === "template" && child.name) {
+          templateMap.set(child.name, child);
+        }
+      }
+      for (const child of composition.children) {
+        root.children.push(this.compileChildNode(child, templateMap));
+      }
+    }
+    if (composition.environment) {
+      root.children.push(
+        ...this.compileEnvironmentBlock(
+          composition.environment
+        )
+      );
+    }
+    if (Array.isArray(composition.lights)) {
+      for (const light of composition.lights) {
+        root.children.push(this.compileLightBlock(light));
+      }
+    }
+    if (Array.isArray(composition.objects)) {
+      for (const obj of composition.objects) {
+        root.children.push(this.compileObjectDecl(obj, templateMap));
+      }
+    }
+    if (Array.isArray(composition.spatialGroups)) {
+      for (const group of composition.spatialGroups) {
+        root.children.push(this.compileSpatialGroup(group, templateMap));
+      }
+    }
+    if (Array.isArray(composition.timelines)) {
+      for (const timeline of composition.timelines) {
+        root.children.push(
+          this.compileTimelineBlock(timeline)
+        );
+      }
+    }
+    if (Array.isArray(composition.audio)) {
+      for (const audio of composition.audio) {
+        root.children.push(this.compileAudioBlock(audio));
+      }
+    }
+    if (Array.isArray(composition.zones)) {
+      for (const zone of composition.zones) {
+        root.children.push(this.compileZoneBlock(zone));
+      }
+    }
+    if (Array.isArray(composition.worlds)) {
+      for (const world of composition.worlds) {
+        root.children.push(
+          ...this.compileWorldNode(
+            world,
+            templateMap
+          )
+        );
+      }
+    }
+    if (composition.ui) {
+      root.children.push(
+        this.compileUIBlock(composition.ui)
+      );
+    }
+    if (Array.isArray(composition.transitions)) {
+      for (const transition of composition.transitions) {
+        root.children.push(
+          this.compileTransitionBlock(transition)
+        );
+      }
+    }
+    if (Array.isArray(composition.conditionals)) {
+      for (const cond of composition.conditionals) {
+        root.children.push(this.compileConditionalBlock(cond, templateMap));
+      }
+    }
+    if (Array.isArray(composition.iterators)) {
+      for (const iter of composition.iterators) {
+        root.children.push(this.compileForEachBlock(iter, templateMap));
+      }
+    }
+    if (composition.camera) {
+      root.children.push(
+        this.compileCameraBlock(composition.camera)
+      );
+    }
+    if (composition.effects) {
+      root.children.unshift(
+        this.compileEffectsBlock(composition.effects)
+      );
+    } else if (this.hasPostProcessing(root)) {
+      root.children.unshift({
+        type: "EffectComposer",
+        props: {},
+        children: this.extractPostProcessingNodes(root)
+      });
+    }
+    const domainBlocks = composition.domainBlocks ?? [];
+    for (const block of domainBlocks) {
+      const kw = (block.keyword ?? "").toLowerCase();
+      const isProcedural = block.domain === "procedural" || kw === "scatter" || kw === "procedural" || kw === "generate" || kw === "distribute" || kw === "pcg_graph";
+      if (!isProcedural) continue;
+      const node = this.compileProceduralScatterNode(block);
+      if (node) root.children.push(node);
+    }
+    this.injectHolomapPointCloud(root);
+    this.injectDefaultLighting(root);
+    return root;
+  }
+  /** R3F host apps can map this node to BufferGeometry + pointsMaterial from base64 buffers. */
+  injectHolomapPointCloud(root) {
+    const h = this._holomapPointCloud;
+    if (!h || h.pointCount < 1 || !h.positionsB64 || !h.colorsB64) return;
+    if (!root.children) root.children = [];
+    root.children.push({
+      type: "holomapPointCloud",
+      props: {
+        positionsB64: h.positionsB64,
+        colorsB64: h.colorsB64,
+        pointCount: h.pointCount
+      }
+    });
+  }
+  compileLightBlock(light) {
+    const lightMapping = {
+      directional: "directionalLight",
+      point: "pointLight",
+      spot: "spotLight",
+      hemisphere: "hemisphereLight",
+      ambient: "ambientLight",
+      area: "rectAreaLight"
+    };
+    const type = lightMapping[light.lightType] || "directionalLight";
+    const props = {};
+    if (Array.isArray(light.properties)) {
+      for (const prop of light.properties) {
+        const key = prop.key;
+        const value = prop.value;
+        if (key === "cast_shadow" || key === "castShadow") {
+          props.castShadow = value;
+        } else if (key === "ground_color" || key === "groundColor") {
+          props.groundColor = value;
+        } else if (key === "shadow_map_size") {
+          props["shadow-mapSize"] = Array.isArray(value) ? value : [value, value];
+        } else {
+          props[key] = value;
+        }
+      }
+    }
+    if ((light.lightType === "directional" || light.lightType === "spot") && props.castShadow === void 0) {
+      props.castShadow = true;
+    }
+    const r3fNode = sceneIRNodePool.acquire();
+    r3fNode.type = type;
+    r3fNode.id = light.name ? chunkZK7KX5CD_cjs.escapeStringValue(light.name, "JSX") : void 0;
+    r3fNode.props = props;
+    r3fNode.children = [];
+    r3fNode.traits = /* @__PURE__ */ new Map();
+    r3fNode.directives = [];
+    return r3fNode;
+  }
+  compileEffectsBlock(effects) {
+    const children = [];
+    if (Array.isArray(effects.effects)) {
+      for (const effect of effects.effects) {
+        const effectMapping = {
+          bloom: "Bloom",
+          ssao: "SSAO",
+          vignette: "Vignette",
+          dof: "DepthOfField",
+          chromatic_aberration: "ChromaticAberration",
+          tone_mapping: "ToneMapping",
+          noise: "Noise"
+        };
+        const effectType = effect.effectType;
+        const type = effectMapping[effectType] || effectType;
+        children.push(
+          this.createNode(type, { ...effect.properties || {} })
+        );
+      }
+    }
+    const composer = this.createNode("EffectComposer", {});
+    composer.children = children;
+    return composer;
+  }
+  compileCameraBlock(camera) {
+    const props = {};
+    if (Array.isArray(camera.properties)) {
+      for (const prop of camera.properties) {
+        if (prop.key === "field_of_view" || prop.key === "fov") {
+          props.fov = prop.value;
+        } else if (prop.key === "look_at" || prop.key === "lookAt") {
+          props.lookAt = prop.value;
+        } else {
+          props[prop.key] = prop.value;
+        }
+      }
+    }
+    props.cameraType = camera.cameraType;
+    return this.createNode("Camera", props, "__camera");
+  }
+  compileEnvironmentBlock(env) {
+    const nodes = [];
+    const envProps = {};
+    if (env.properties) {
+      for (const prop of env.properties) {
+        envProps[prop.key] = prop.value;
+      }
+    }
+    const presetName = envProps.skybox || envProps.preset;
+    if (presetName) {
+      const preset = ENVIRONMENT_PRESETS[presetName];
+      if (preset) {
+        nodes.push(
+          this.createNode("Environment", {
+            background: true,
+            preset: preset.envPreset || presetName
+          })
+        );
+        const lighting = preset.lighting;
+        if (lighting?.ambient) {
+          nodes.push(
+            this.createNode("ambientLight", {
+              color: lighting.ambient.color,
+              intensity: lighting.ambient.intensity
+            })
+          );
+        }
+        if (lighting?.directional) {
+          const dl = lighting.directional;
+          nodes.push(
+            this.createNode("directionalLight", {
+              color: dl.color,
+              intensity: dl.intensity,
+              position: dl.position,
+              castShadow: dl.shadows !== false,
+              "shadow-mapSize": [2048, 2048]
+            })
+          );
+        }
+        if (Array.isArray(lighting?.points)) {
+          for (const pl of lighting.points) {
+            nodes.push(
+              this.createNode("pointLight", {
+                color: pl.color,
+                intensity: pl.intensity,
+                position: pl.position,
+                distance: pl.distance
+              })
+            );
+          }
+        }
+        const presetMap = preset;
+        if (presetMap.fog) {
+          const fogMap = presetMap.fog;
+          nodes.push(
+            this.createNode("fog", {
+              attach: "fog",
+              color: fogMap.color,
+              near: fogMap.near,
+              far: fogMap.far
+            })
+          );
+        }
+        if (presetMap.ground) {
+          const groundMap = presetMap.ground;
+          nodes.push(
+            this.createNode(
+              "mesh",
+              {
+                hsType: "plane",
+                rotation: [-Math.PI / 2, 0, 0],
+                position: [0, -0.01, 0],
+                receiveShadow: true,
+                args: [200, 200],
+                color: groundMap.color,
+                materialProps: { roughness: 0.8, metalness: 0 }
+              },
+              "__ground"
+            )
+          );
+        }
+      } else {
+        nodes.push(this.createNode("Environment", { background: true, preset: presetName }));
+      }
+    }
+    if (envProps.ambient_light !== void 0) {
+      nodes.push(
+        this.createNode("ambientLight", {
+          intensity: typeof envProps.ambient_light === "number" ? envProps.ambient_light : 0.5
+        })
+      );
+    }
+    const explicitFog = envProps.fog;
+    if (explicitFog && typeof explicitFog === "object") {
+      nodes.push(
+        this.createNode("fog", {
+          attach: "fog",
+          color: explicitFog.color || "#cccccc",
+          near: explicitFog.near || 10,
+          far: explicitFog.far || 100
+        })
+      );
+    }
+    return nodes;
+  }
+  compileObjectDecl(obj, templateMap) {
+    const props = {};
+    let geometryType = "cube";
+    if (obj.template && templateMap) {
+      const tmpl = templateMap.get(obj.template);
+      if (tmpl) {
+        const tmplTraits = tmpl.traits;
+        if (tmplTraits && Array.isArray(tmplTraits)) {
+          const existingTraitNames = new Set(
+            (obj.traits || []).map(
+              (t) => t.name
+            )
+          );
+          obj.traits = [
+            ...tmplTraits.filter(
+              (t) => !existingTraitNames.has(t.name)
+            ),
+            ...obj.traits || []
+          ];
+        }
+        const tmplProps = tmpl.properties;
+        if (tmplProps && Array.isArray(tmplProps)) {
+          const existingKeys = new Set(
+            (obj.properties || []).map(
+              (p) => p.key
+            )
+          );
+          const mergedProps = tmplProps.filter((p) => !existingKeys.has(p.key)).map((p) => ({
+            type: "ObjectProperty",
+            key: p.key,
+            value: p.value
+          }));
+          obj.properties = [...mergedProps, ...obj.properties || []];
+        }
+      }
+    }
+    if (obj.properties && Array.isArray(obj.properties)) {
+      const expandedProperties = [];
+      for (const p of obj.properties) {
+        const prop = p;
+        if (prop && prop.type === "spread") {
+          const resolved = this.resolveSpreadArgument(
+            prop.target || prop.argument,
+            {
+              templates: templateMap
+            }
+          );
+          if (resolved && typeof resolved === "object" && !Array.isArray(resolved)) {
+            for (const [key, value] of Object.entries(resolved)) {
+              expandedProperties.push({ key, value });
+            }
+          } else if (Array.isArray(resolved)) {
+            expandedProperties.push(...resolved);
+          }
+        } else {
+          expandedProperties.push(prop);
+        }
+      }
+      obj.properties = expandedProperties;
+    }
+    if (obj.properties) {
+      for (const p of obj.properties) {
+        const key = p.key;
+        const value = p.value;
+        if (key === "geometry" || key === "mesh") {
+          geometryType = value;
+        } else if (key === "type") {
+          const valStr = value;
+          if (["text", "sparkles", "portal", "audio"].includes(valStr)) {
+            geometryType = valStr;
+          } else if (["directional", "point", "spot", "hemisphere", "ambient", "area"].includes(valStr)) {
+            geometryType = "light";
+            props.lightType = valStr;
+          } else {
+            props[key] = value;
+          }
+        } else if (key === "light_type") {
+          props.lightType = value;
+        } else if (key === "position" && Array.isArray(value)) {
+          props.position = value;
+        } else if (key === "rotation" && Array.isArray(value)) {
+          props.rotation = value;
+        } else if (key === "scale") {
+          props.scale = Array.isArray(value) ? value : [value, value, value];
+        } else if (key === "color") {
+          props.color = value;
+        } else if (key === "src" || key === "model" || key === "source") {
+          props.src = value;
+          geometryType = "model";
+        } else if (key === "text") {
+          props.children = this.resolveValue(value);
+          props.text = this.resolveValue(value);
+        } else if (key === "font_size") {
+          props.fontSize = value;
+        } else if (key === "material") {
+          const currentMaterialProps = props.materialProps || {};
+          if (typeof value === "string" && MATERIAL_PRESETS[value]) {
+            props.materialProps = { ...MATERIAL_PRESETS[value], ...currentMaterialProps };
+          } else if (typeof value === "object" && value !== null) {
+            const valObj = value;
+            if (valObj.preset && typeof valObj.preset === "string" && MATERIAL_PRESETS[valObj.preset]) {
+              const { preset: _, ...rest } = valObj;
+              props.materialProps = {
+                ...MATERIAL_PRESETS[valObj.preset],
+                ...rest,
+                ...currentMaterialProps
+              };
+            } else {
+              props.materialProps = { ...currentMaterialProps, ...valObj };
+            }
+          }
+        } else if (key === "roughness" || key === "metalness" || key === "metallic") {
+          const mProps = props.materialProps || {};
+          mProps[key === "metallic" ? "metalness" : key] = value;
+          props.materialProps = mProps;
+        } else if (key === "opacity") {
+          const mProps = props.materialProps || {};
+          mProps.opacity = value;
+          mProps.transparent = value < 1;
+          props.materialProps = mProps;
+        } else if (key === "emissive") {
+          props.materialProps = {
+            ...props.materialProps || {},
+            emissive: value
+          };
+        } else if (key === "emissiveIntensity" || key === "emissive_intensity") {
+          props.materialProps = {
+            ...props.materialProps || {},
+            emissiveIntensity: value
+          };
+        } else if (key === "size") {
+          if (Array.isArray(value)) {
+            props.args = value;
+          }
+          props.size = value;
+        } else if (key === "radius") {
+          props.size = value * 2;
+        } else if (key === "intensity") {
+          props.intensity = value;
+        } else if (key === "cast_shadow" || key === "castShadow") {
+          props.castShadow = value;
+        } else if (key === "receiveShadow" || key === "receive_shadow") {
+          props.receiveShadow = value;
+        } else if (key === "visible") {
+          props[key] = value;
+        } else if (key === "maturity") {
+          props.maturityOverride = value;
+        } else if (key === "promoteUrl" || key === "promote_url") {
+          props.promoteUrl = value;
+        } else if (key === "collisionShape" || key === "collision_shape") {
+          props.collisionShape = value;
+        } else {
+          props[key] = this.resolveValue(value);
+        }
+      }
+    }
+    if (obj.traits && Array.isArray(obj.traits)) {
+      const semiring = new chunkV6GXFSK7_cjs.ProvenanceSemiring();
+      const physicsApplications = obj.traits.filter((t) => t.name === "physics" || t.name === "collidable").map((t) => {
+        let baseConfig = t.config || {};
+        if (t.name === "collidable" && !baseConfig.type)
+          baseConfig = { ...baseConfig, type: "fixed" };
+        if (t.name === "physics" && !baseConfig.type)
+          baseConfig = { ...baseConfig, type: "dynamic" };
+        return {
+          name: t.name,
+          config: baseConfig,
+          context: obj.provenance?.context
+        };
+      });
+      if (physicsApplications.length > 0) {
+        const { config: mergedPhysics } = semiring.add(physicsApplications);
+        props.rigidBody = { ...mergedPhysics };
+        props.collider = { type: "auto" };
+        if (props.rigidBody?.type === "fixed") {
+          props.castShadow = true;
+          props.receiveShadow = true;
+        }
+      }
+      for (const trait of obj.traits) {
+        const name = trait.name;
+        if (name === "physics" || name === "collidable") {
+          continue;
+        } else if (name === "grabbable") {
+          props.castShadow = true;
+          props.grabbable = trait.config || true;
+          if (!props.rigidBody) props.rigidBody = { type: "dynamic" };
+          if (!props.collider) props.collider = { type: "auto" };
+        } else if (name === "hoverable") {
+          props.hoverable = trait.config || true;
+        } else if (name === "animated") {
+          props.animated = trait.config || true;
+        } else if (name === "positional" || name === "spatial_audio") {
+          props.spatial = true;
+        } else if (name === "gem_resonance") {
+          props.gemResonance = gemResonanceConfig(trait.config);
+          props.spatial = true;
+        } else if (name === "shadow") {
+          props.castShadow = true;
+          if (trait.config?.mapSize)
+            props["shadow-mapSize"] = [trait.config.mapSize, trait.config.mapSize];
+        } else if (name === "material") {
+          const presetName = trait.config?.preset;
+          if (presetName && typeof presetName === "string" && MATERIAL_PRESETS[presetName]) {
+            const { preset: _, ...rest } = trait.config;
+            props.materialProps = {
+              ...MATERIAL_PRESETS[presetName],
+              ...rest,
+              ...props.materialProps
+            };
+          } else {
+            props.materialProps = {
+              ...props.materialProps,
+              ...trait.config
+            };
+          }
+        } else if (name === "networked") {
+          props.networked = trait.config || true;
+        } else if (name === "moldable") {
+          props.moldable = trait.config || true;
+        } else if (name === "stretchable") {
+          props.stretchable = trait.config || true;
+        } else if (name === "bloom") {
+          props.bloom = trait.config || { intensity: 1 };
+        } else if (name === "portal") {
+          props.portal = trait.config || true;
+        } else if (name === "attach") {
+          props.attach = trait.config || true;
+        } else if (name === "orbit") {
+          props.orbit = trait.config || true;
+        } else if (name === "look_at") {
+          props.lookAtTarget = trait.config || true;
+        } else if (name === "follow") {
+          props.follow = trait.config || true;
+        } else if (name === "plane_detection") {
+          props.planeDetection = trait.config || { mode: "all" };
+        } else if (name === "mesh_detection") {
+          props.meshDetection = trait.config || { classification: true };
+        } else if (name === "anchor") {
+          props.anchor = trait.config || { type: "spatial" };
+        } else if (name === "persistent_anchor") {
+          props.persistentAnchor = trait.config || { storage: "local" };
+        } else if (name === "shared_anchor") {
+          props.sharedAnchor = trait.config || { authority: "creator" };
+        } else if (name === "occlusion") {
+          props.occlusionMode = trait.config?.mode || "environment";
+          props.occlusion = trait.config || true;
+        } else if (name === "light_estimation") {
+          props.lightEstimation = trait.config || { auto_apply: true };
+        } else if (name === "geospatial") {
+          props.geospatial = trait.config || true;
+        } else if (name === "gaussian_splat") {
+          props.gaussianSplat = trait.config || true;
+        } else if (name === "nerf") {
+          props.nerf = trait.config || true;
+        } else if (name === "volumetric_video") {
+          props.volumetricVideo = trait.config || true;
+        } else if (name === "point_cloud") {
+          props.pointCloud = trait.config || true;
+        } else if (name === "photogrammetry") {
+          props.photogrammetry = trait.config || true;
+        } else if (name === "web_surface") {
+          props.webSurface = trait.config || true;
+        } else if (name === "cloth") {
+          props.cloth = trait.config || { stiffness: 0.8 };
+          if (!props.rigidBody) props.rigidBody = { type: "dynamic" };
+        } else if (name === "fluid") {
+          props.fluid = trait.config || { viscosity: 0.01 };
+          props.__gapsComponents = props.__gapsComponents || [];
+          props.__gapsComponents.push("FluidRenderer");
+        } else if (name === "soft_body") {
+          props.softBody = trait.config || { elasticity: 0.5 };
+          if (!props.rigidBody) props.rigidBody = { type: "dynamic" };
+        } else if (name === "rope") {
+          props.rope = trait.config || { segments: 20 };
+        } else if (name === "chain") {
+          props.chain = trait.config || { link_count: 20 };
+        } else if (name === "wind") {
+          props.wind = trait.config || { strength: 5 };
+        } else if (name === "buoyancy") {
+          props.buoyancy = trait.config || { water_level: 0 };
+        } else if (name === "destruction") {
+          props.destruction = trait.config || { health: 100 };
+          if (!props.rigidBody) props.rigidBody = { type: "dynamic" };
+          if (!props.collider) props.collider = { type: "auto" };
+        } else if (name === "soft_body_pro") {
+          props.softBodyPro = trait.config || { tear_threshold: 0.5 };
+          if (!props.rigidBody) props.rigidBody = { type: "dynamic" };
+        } else if (name === "crowd_sim") {
+          props.crowdSim = trait.config || { max_agents: 1e3 };
+        } else if (name === "deformable_terrain") {
+          props.deformableTerrain = trait.config || { resolution: 256 };
+        } else if (name === "volumetric_clouds") {
+          props.volumetricClouds = trait.config || { coverage: 0.5 };
+          props.__gapsComponents = props.__gapsComponents || [];
+          props.__gapsComponents.push("CloudRenderer");
+        } else if (name === "god_rays") {
+          props.godRays = trait.config || { intensity: 1 };
+          props.__gapsComponents = props.__gapsComponents || [];
+          props.__gapsComponents.push("GodRaysEffect");
+        } else if (name === "spatial_voice") {
+          props.spatialVoice = trait.config || { max_distance: 30 };
+          props.spatial = true;
+        } else if (name === "ai_companion") {
+          props.aiCompanion = trait.config || { personality: "friendly" };
+        } else if (name === "moderation") {
+          props.moderation = trait.config || { sensitivity: "medium" };
+        } else if (name === "anti_grief") {
+          props.antiGrief = trait.config || { detection_window: 30 };
+        } else if (name === "world_state") {
+          props.worldState = trait.config || { sync_rate: 10 };
+        } else if (name === "token_gated") {
+          props.tokenGated = trait.config || { token_contract: "", min_balance: 1 };
+        } else if (name === "ambisonics") {
+          props.ambisonics = trait.config || { order: 1 };
+          props.spatial = true;
+        } else if (name === "hrtf") {
+          props.hrtf = trait.config || true;
+          props.spatial = true;
+        } else if (name === "reverb_zone") {
+          props.reverbZone = trait.config || { preset: "room" };
+        } else if (name === "audio_occlusion") {
+          props.audioOcclusion = trait.config || true;
+        } else if (name === "audio_portal") {
+          props.audioPortal = trait.config || true;
+        } else if (name === "head_tracked_audio") {
+          props.headTrackedAudio = trait.config || true;
+          props.spatial = true;
+        } else if (name === "accessible") {
+          props.accessible = trait.config || { role: "generic" };
+        } else if (name === "alt_text") {
+          props.altText = trait.config?.text || "";
+        } else if (name === "magnifiable") {
+          props.magnifiable = trait.config || { max_scale: 3 };
+        } else if (name === "high_contrast") {
+          props.highContrast = trait.config || { mode: "outline" };
+        } else if (name === "perceptual_color") {
+          props.perceptualColor = trait.config || true;
+        } else if (name === "motion_reduced") {
+          props.motionReduced = trait.config || true;
+          if (props.animated) props.animated = false;
+        } else if (name === "compute") {
+          props.compute = trait.config || true;
+        } else if (name === "gpu_particle") {
+          props.gpuParticle = trait.config || { count: 1e4 };
+        } else if (isVfxParticleTraitName(name)) {
+          const particleConfig = {
+            effect: vfxParticleEffect(name),
+            ...trait.config || {}
+          };
+          const gpuParticles = props.gpuParticles ?? [];
+          props.gpuParticles = [...gpuParticles, particleConfig];
+          if (!props.gpuParticle) props.gpuParticle = particleConfig;
+        } else if (name === "gpu_physics") {
+          props.gpuPhysics = trait.config || true;
+        } else if (name === "digital_twin") {
+          props.digitalTwin = trait.config || true;
+        } else if (name === "sensor") {
+          props.sensor = trait.config || true;
+        } else if (name === "data_binding") {
+          props.dataBinding = trait.config || true;
+        } else if (name === "behavior_tree") {
+          props.behaviorTree = trait.config || true;
+        } else if (name === "llm_agent") {
+          props.llmAgent = trait.config || true;
+        } else if (name === "neural_link") {
+          props.neuralLink = trait.config || { model: "brittney-v4.gguf", temperature: 0.7 };
+        } else if (name === "perception") {
+          props.perception = trait.config || { sight_range: 20 };
+        } else if (name === "patrol") {
+          props.patrol = trait.config || true;
+        } else if (name === "co_located") {
+          props.coLocated = trait.config || true;
+        } else if (name === "shared_world") {
+          props.sharedWorld = trait.config || true;
+        } else if (name === "voice_proximity") {
+          props.voiceProximity = trait.config || { max_distance: 20 };
+          props.spatial = true;
+        } else if (name === "spatial_persona") {
+          props.spatialPersona = trait.config || { style: "realistic" };
+        } else if (name === "shareplay") {
+          props.sharePlay = trait.config || { activity_type: "custom" };
+        } else if (name === "object_tracking") {
+          props.objectTracking = trait.config || true;
+        } else if (name === "scene_reconstruction") {
+          props.sceneReconstruction = trait.config || { mode: "mesh" };
+        } else if (name === "eye_tracked") {
+          props.eyeTracked = true;
+        } else if (name === "eye_hand_fusion") {
+          props.eyeHandFusion = true;
+        } else if (name === "controlnet") {
+          props.controlNet = trait.config || { model: "canny" };
+        } else if (name === "ai_texture_gen") {
+          props.aiTextureGen = trait.config || { style: "photorealistic" };
+        } else if (name === "diffusion_realtime") {
+          props.diffusionRealtime = trait.config || { backend: "cuda" };
+        } else if (name === "ai_upscaling") {
+          props.aiUpscaling = trait.config || { factor: 2 };
+        } else if (name === "ai_inpainting") {
+          props.aiInpainting = trait.config || true;
+        } else if (name === "neural_forge") {
+          props.neuralForge = trait.config || true;
+        } else if (name === "embedding_search") {
+          props.embeddingSearch = trait.config || { dimensions: 1536 };
+        } else if (name === "ai_npc_brain") {
+          props.aiNpcBrain = trait.config || { model: "llm" };
+        } else if (name === "vector_db") {
+          props.vectorDb = trait.config || true;
+        } else if (name === "vision" || name === "ai_vision") {
+          props.vision = trait.config || { task: "detection" };
+        } else if (name === "spatial_awareness") {
+          props.spatialAwareness = trait.config || true;
+        } else if (name === "neural_animation") {
+          props.neuralAnimation = trait.config || { style: "motion_matching" };
+        } else if (name === "draft") {
+          props.draftMode = true;
+          props.draftShape = trait.config?.shape || "box";
+          props.draftColor = trait.config?.color || "#88aaff";
+          props.draftOpacity = trait.config?.opacity ?? 1;
+          props.draftWireframe = trait.config?.wireframe || false;
+          if (trait.config?.collision !== false) {
+            if (!props.rigidBody) props.rigidBody = { type: "fixed" };
+            if (!props.collider) props.collider = { type: "auto" };
+          }
+        } else if (name === "botanical_lotus") {
+          this.emitCompiledLotusMaterial(props, trait.config || {});
+        } else {
+          props[name] = trait.config || true;
+          if (!props.__unrecognizedTraits) {
+            props.__unrecognizedTraits = [];
+          }
+          props.__unrecognizedTraits.push(name);
+        }
+      }
+    }
+    if (obj.traits && Array.isArray(obj.traits)) {
+      const traitNames = obj.traits.map(
+        (t) => t.name
+      );
+      const compositor = new chunkQQFB4RT2_cjs.TraitCompositor();
+      const composedMaterial = compositor.compose(traitNames);
+      if (Object.keys(composedMaterial).length > 0) {
+        props.materialProps = {
+          ...props.materialProps,
+          ...composedMaterial
+        };
+      }
+    }
+    const perceptualTrait = Array.isArray(obj.traits) ? obj.traits.find((trait) => trait.name === "perceptual_color") : void 0;
+    const perceptualTraitConfig = perceptualTrait ? perceptualTrait.config && typeof perceptualTrait.config === "object" ? perceptualTrait.config : {} : void 0;
+    this.applyPerceptualColorProps(
+      props,
+      perceptualTraitConfig,
+      this.isScientificColorNode(geometryType, props)
+    );
+    let type;
+    if (geometryType === "model" && props.src) {
+      type = "gltfModel";
+    } else if (geometryType === "light") {
+      const lightType = props.lightType || props.type || "directional";
+      const lightMapping = {
+        directional: "directionalLight",
+        point: "pointLight",
+        spot: "spotLight",
+        hemisphere: "hemisphereLight",
+        ambient: "ambientLight",
+        area: "rectAreaLight"
+      };
+      type = lightMapping[lightType] || "directionalLight";
+      delete props.lightType;
+    } else if (geometryType === "text") {
+      type = "Text";
+    } else if (geometryType === "sparkles") {
+      type = "Sparkles";
+    } else if (geometryType === "portal") {
+      type = "Portal";
+    } else if (geometryType === "gaussian_splat" || geometryType === "splat" || props.gaussianSplat !== void 0) {
+      type = "splat";
+    } else {
+      type = "mesh";
+      props.hsType = geometryType;
+      if (!props.args) {
+        const size = typeof props.size === "number" ? props.size : 1;
+        props.args = this.getGeometryArgs(geometryType, { size });
+      }
+    }
+    const r3fNode = this.createNode(type, props, obj.name);
+    if (props.draftMode) {
+      r3fNode.assetMaturity = "draft";
+    } else if (props.maturityOverride) {
+      const m = props.maturityOverride;
+      if (m === "draft" || m === "mesh" || m === "final") {
+        r3fNode.assetMaturity = m;
+      }
+    }
+    delete props.maturityOverride;
+    if (obj.children && Array.isArray(obj.children)) {
+      for (const child of obj.children) {
+        r3fNode.children.push(this.compileObjectDecl(child));
+      }
+    }
+    if (props.__gapsComponents && Array.isArray(props.__gapsComponents)) {
+      for (const componentType of props.__gapsComponents) {
+        const componentProps = {};
+        if (componentType === "CloudRenderer" && props.volumetricClouds) {
+          const vc = props.volumetricClouds;
+          componentProps.coverage = vc.coverage ?? 0.5;
+          componentProps.altitude = vc.altitude ?? 500;
+          componentProps.windOffset = vc.wind ?? [0, 0, 0];
+          componentProps.layers = vc.layers ?? 3;
+        } else if (componentType === "GodRaysEffect" && props.godRays) {
+          const gr = props.godRays;
+          componentProps.intensity = gr.intensity ?? 1;
+          componentProps.decay = gr.decay ?? 0.96;
+          componentProps.lightColor = gr.color ?? "#fffde7";
+        } else if (componentType === "FluidRenderer" && props.fluid) {
+          const fl = props.fluid;
+          componentProps.color = fl.color ?? "#1a6fc4";
+          componentProps.particleSize = fl.particle_radius ?? 0.02;
+          componentProps.renderMode = fl.render_mode ?? "points";
+        }
+        r3fNode.children.push(
+          this.createNode(componentType, componentProps, `${obj.name}-${componentType}`)
+        );
+      }
+      delete props.__gapsComponents;
+    }
+    return r3fNode;
+  }
+  /**
+   * Compile a SystemNode into an R3FNode.
+   *
+   * Systems are logical containers with state, actions, lifecycle hooks,
+   * and optionally child objects/UI. In the R3F tree, a system compiles
+   * to a group node annotated with its rich metadata (state, actions,
+   * hooks) so the runtime/renderer can wire up behavior.
+   */
+  compileSystemNode(node, templateMap) {
+    const props = {};
+    if (node.state) {
+      props.systemState = node.state;
+    }
+    if (node.actions) {
+      props.systemActions = node.actions;
+    }
+    if (node.hooks) {
+      props.systemHooks = node.hooks;
+    }
+    if (node.properties && typeof node.properties === "object") {
+      for (const [key, value] of Object.entries(node.properties)) {
+        props[key] = value;
+      }
+    }
+    const r3fNode = this.createNode("System", props, node.id || node.name);
+    if (node.directives) {
+      r3fNode.directives = node.directives;
+    }
+    if (node.directives) {
+      for (const d of node.directives) {
+        if (d.type === "trait") {
+          r3fNode.traits?.set(d.name, d.config || {});
+        }
+      }
+    }
+    if (node.children && Array.isArray(node.children)) {
+      for (const child of node.children) {
+        r3fNode.children.push(this.compileChildNode(child, templateMap));
+      }
+    }
+    if (node.ui && Array.isArray(node.ui)) {
+      for (const uiNode of node.ui) {
+        r3fNode.children.push(this.compileNode(uiNode));
+      }
+    }
+    return r3fNode;
+  }
+  /**
+   * Compile a ComponentNode into an R3FNode.
+   *
+   * Components are UI-focused containers with props, state, actions,
+   * and render/UI blocks. They compile to a group node annotated with
+   * component metadata for the runtime.
+   */
+  compileComponentNode(node, templateMap) {
+    const props = {};
+    if (node.props) {
+      props.componentProps = node.props;
+    }
+    if (node.state) {
+      props.componentState = node.state;
+    }
+    if (node.actions) {
+      props.componentActions = node.actions;
+    }
+    if (node.hooks) {
+      props.componentHooks = node.hooks;
+    }
+    if (node.properties && typeof node.properties === "object") {
+      for (const [key, value] of Object.entries(node.properties)) {
+        props[key] = value;
+      }
+    }
+    const r3fNode = this.createNode(
+      "Component",
+      props,
+      node.id || node.name
+    );
+    if (node.directives) {
+      r3fNode.directives = node.directives;
+    }
+    if (node.directives) {
+      for (const d of node.directives) {
+        if (d.type === "trait") {
+          r3fNode.traits?.set(d.name, d.config || {});
+        }
+      }
+    }
+    if (node.children && Array.isArray(node.children)) {
+      for (const child of node.children) {
+        r3fNode.children.push(this.compileChildNode(child, templateMap));
+      }
+    }
+    if (node.ui && Array.isArray(node.ui)) {
+      for (const uiNode of node.ui) {
+        r3fNode.children.push(this.compileNode(uiNode));
+      }
+    }
+    return r3fNode;
+  }
+  /**
+   * Dispatch a child node to the appropriate compile method based on its type.
+   * Used by compileSystemNode, compileComponentNode, and compileComposition
+   * when processing the parser's children array.
+   */
+  compileChildNode(child, templateMap) {
+    switch (child.type) {
+      case "system":
+        return this.compileSystemNode(child, templateMap);
+      case "component":
+        return this.compileComponentNode(child, templateMap);
+      case "object":
+        return this.compileObjectDecl(child, templateMap);
+      case "template":
+        if (templateMap && typeof child.name === "string") {
+          templateMap.set(child.name, child);
+        }
+        return this.compileTemplateNode(child, templateMap);
+      case "spatial_group":
+        return this.compileSpatialGroup(child, templateMap);
+      default:
+        return this.compileNode(child);
+    }
+  }
+  /**
+   * Compile a template node. Templates define reusable types.
+   * In the R3F tree, they compile to an empty group (they're not
+   * rendered directly — objects "using" them inherit their properties).
+   */
+  compileTemplateNode(node, _templateMap) {
+    const props = {};
+    if (node.state || node.properties?.state) {
+      props.templateState = node.state || node.properties?.state;
+    }
+    if (node.properties) {
+      for (const [key, value] of Object.entries(node.properties)) {
+        if (key !== "state") {
+          props[key] = value;
+        }
+      }
+    }
+    return this.createNode("Template", props, node.name);
+  }
+  compileSpatialGroup(group, templateMap) {
+    const props = {};
+    let staggerStep = 0;
+    if (group.properties) {
+      for (const prop of group.properties) {
+        if (prop.key === "position") props.position = prop.value;
+        else if (prop.key === "rotation") props.rotation = prop.value;
+        else if (prop.key === "scale")
+          props.scale = Array.isArray(prop.value) ? prop.value : [prop.value, prop.value, prop.value];
+        else if (prop.key === "stagger") {
+          const n = Number(prop.value);
+          if (Number.isFinite(n)) {
+            staggerStep = n;
+            props.stagger = n;
+          }
+        }
+      }
+    }
+    const node = this.createNode("group", props, group.name);
+    if (group.objects) {
+      for (const obj of group.objects)
+        node.children.push(this.compileObjectDecl(obj, templateMap));
+    }
+    if (group.groups) {
+      for (const sub of group.groups)
+        node.children.push(this.compileSpatialGroup(sub, templateMap));
+    }
+    if (staggerStep && node.children) {
+      const entranceTarget = `entrance_${String(group.name ?? "group").replace(
+        /[^a-zA-Z0-9_]/g,
+        "_"
+      )}`;
+      const synthesized = synthesizeEntranceChannels(
+        node.children,
+        entranceTarget
+      );
+      applyStaggerToChildren(node.children, staggerStep);
+      if (synthesized > 0) {
+        node.children.push(this.buildEntranceDriver(entranceTarget));
+      }
+    }
+    return node;
+  }
+  /**
+   * Build a hidden `Timeline` node that ramps `target` 0→1, played by the
+   * existing `<TimelineDriver>`, so the synthesized `@animated` entrance channels
+   * in a staggered group animate with no author-supplied timeline. (S3)
+   */
+  buildEntranceDriver(target) {
+    const driver = this.createNode("Timeline", { autoplay: true, loop: false });
+    driver.children = [
+      this.createNode("TimelineEntry", {
+        time: 0,
+        actionKind: "animate",
+        target,
+        properties: { value: 0 }
+      }),
+      this.createNode("TimelineEntry", {
+        time: 1,
+        actionKind: "animate",
+        target,
+        properties: { value: 1 }
+      })
+    ];
+    return driver;
+  }
+  compileTimelineBlock(timeline) {
+    const entries = [];
+    if (timeline.entries) {
+      for (const entry of timeline.entries) {
+        const action = entry.action;
+        const entryProps = { time: entry.time, actionKind: action.kind };
+        if (action.kind === "animate") {
+          entryProps.target = action.target;
+          entryProps.properties = action.properties;
+        } else if (action.kind === "emit") {
+          entryProps.event = action.event;
+          if (action.data !== void 0) entryProps.data = action.data;
+        } else if (action.kind === "call") {
+          entryProps.method = action.method;
+          if (action.args) entryProps.args = action.args;
+        }
+        entries.push(this.createNode("TimelineEntry", entryProps));
+      }
+    }
+    const safeName = timeline.name ? chunkZK7KX5CD_cjs.escapeStringValue(timeline.name, "JSX") : void 0;
+    const timelineNode = this.createNode(
+      "Timeline",
+      { autoplay: timeline.autoplay, loop: timeline.loop },
+      safeName
+    );
+    timelineNode.children = entries;
+    return timelineNode;
+  }
+  /**
+   * Compile a `.hsplus` keyframe-track timeline (HoloScriptPlusParser shape:
+   * `{ type:'timeline', children:[{ type:'track', target, keyframes:[{time,value,easing}] }] }`,
+   * the Theatre.js harvest grammar) into the SAME `Timeline` + `TimelineEntry`
+   * R3F shape the existing `<TimelineDriver>` already plays — one `TimelineEntry`
+   * per keyframe, grouped by the track's target. The per-keyframe `easing` is
+   * carried onto the entry so the driver can honor it (driver-side application is
+   * the S4b slice; today the driver tweens with smoothstep). End-to-end: a
+   * keyframe-track timeline now DRIVES `__animatedTransform` consumers.
+   */
+  compileHsplusTimelineNode(node) {
+    const entries = [];
+    const children = node.children || [];
+    for (const track of children) {
+      if (track.type !== "track") continue;
+      const target = track.target;
+      const keyframes = track.keyframes || [];
+      for (const kf of keyframes) {
+        const entryProps = {
+          time: Number(kf.time),
+          actionKind: "animate",
+          target,
+          properties: { value: this.resolveKeyframeValue(kf.value) }
+        };
+        if (typeof kf.easing === "string") entryProps.easing = kf.easing;
+        entries.push(this.createNode("TimelineEntry", entryProps));
+      }
+    }
+    const props = node.properties || {};
+    const safeName = node.name ? chunkZK7KX5CD_cjs.escapeStringValue(node.name, "JSX") : void 0;
+    const timelineNode = this.createNode(
+      "Timeline",
+      { autoplay: props.autoplay, loop: props.loop },
+      safeName
+    );
+    timelineNode.children = entries;
+    return timelineNode;
+  }
+  /** Resolve a keyframe value (a HoloScriptPlusParser `parseValue` result) to a
+   *  number — a bare number, a `{ value }` literal wrapper, or a coercible. */
+  resolveKeyframeValue(v) {
+    if (typeof v === "number") return v;
+    if (v && typeof v === "object" && "value" in v) {
+      const n2 = Number(v.value);
+      return Number.isFinite(n2) ? n2 : 0;
+    }
+    const n = Number(v);
+    return Number.isFinite(n) ? n : 0;
+  }
+  compileAudioBlock(audio) {
+    const props = {};
+    if (audio.properties) {
+      for (const prop of audio.properties) {
+        if (prop.key === "src" || prop.key === "source") {
+          props.src = prop.value;
+        } else if (prop.key === "rolloff") {
+          props.rolloffFactor = prop.value;
+        } else {
+          props[prop.key] = prop.value;
+        }
+      }
+    }
+    const safeName = audio.name ? chunkZK7KX5CD_cjs.escapeStringValue(audio.name, "JSX") : void 0;
+    return this.createNode("Audio", props, safeName);
+  }
+  compileZoneBlock(zone) {
+    const props = {};
+    if (zone.properties) {
+      for (const prop of zone.properties) {
+        props[prop.key] = prop.value;
+      }
+    }
+    if (zone.handlers && zone.handlers.length > 0) {
+      props.handlers = zone.handlers.map(
+        (h) => ({
+          event: h.event,
+          parameters: h.parameters,
+          body: h.body
+        })
+      );
+    }
+    const safeName = zone.name ? chunkZK7KX5CD_cjs.escapeStringValue(zone.name, "JSX") : void 0;
+    return this.createNode("Zone", props, safeName);
+  }
+  compileUIBlock(ui) {
+    const children = [];
+    if (ui.elements) {
+      for (const el of ui.elements) {
+        const elProps = {};
+        if (el.properties) {
+          for (const prop of el.properties) {
+            if (prop.key === "font_size") {
+              elProps.fontSize = prop.value;
+            } else {
+              elProps[prop.key] = this.resolveValue(prop.value);
+            }
+          }
+        }
+        const safeElName = el.name ? chunkZK7KX5CD_cjs.escapeStringValue(el.name, "JSX") : void 0;
+        children.push(this.createNode("UIElement", elProps, safeElName));
+      }
+    }
+    const uiNode = this.createNode("UI", {}, "__ui");
+    uiNode.children = children;
+    return uiNode;
+  }
+  compileTransitionBlock(transition) {
+    const props = {};
+    if (transition.properties) {
+      for (const prop of transition.properties) {
+        props[prop.key] = prop.value;
+      }
+    }
+    const safeName = transition.name ? chunkZK7KX5CD_cjs.escapeStringValue(transition.name, "JSX") : void 0;
+    return this.createNode("Transition", props, safeName);
+  }
+  compileConditionalBlock(cond, templateMap) {
+    const children = [];
+    if (cond.objects) {
+      for (const obj of cond.objects)
+        children.push(this.compileObjectDecl(obj, templateMap));
+    }
+    if (cond.spatialGroups) {
+      for (const g of cond.spatialGroups)
+        children.push(this.compileSpatialGroup(g, templateMap));
+    }
+    const elseChildren = [];
+    if (cond.elseObjects) {
+      for (const obj of cond.elseObjects)
+        elseChildren.push(this.compileObjectDecl(obj, templateMap));
+    }
+    if (cond.elseSpatialGroups) {
+      for (const g of cond.elseSpatialGroups)
+        elseChildren.push(this.compileSpatialGroup(g, templateMap));
+    }
+    const conditionalNode = this.createNode("ConditionalGroup", {
+      condition: cond.condition,
+      elseChildren: elseChildren.length > 0 ? elseChildren : void 0
+    });
+    conditionalNode.children = children;
+    return conditionalNode;
+  }
+  compileForEachBlock(iter, templateMap) {
+    const templateChildren = [];
+    if (iter.objects) {
+      for (const obj of iter.objects)
+        templateChildren.push(this.compileObjectDecl(obj, templateMap));
+    }
+    if (iter.spatialGroups) {
+      for (const g of iter.spatialGroups)
+        templateChildren.push(this.compileSpatialGroup(g, templateMap));
+    }
+    const forEachNode = this.createNode("ForEachGroup", {
+      variable: iter.variable,
+      iterable: iter.iterable
+    });
+    forEachNode.children = templateChildren;
+    return forEachNode;
+  }
+  /**
+   * Resolve a property value, converting bind expressions into runtime-reactive markers.
+   */
+  resolveValue(value) {
+    if (value && typeof value === "object" && value.__bind) {
+      return {
+        __bind: true,
+        source: value.source,
+        transform: value.transform
+      };
+    }
+    return value;
+  }
+  // ─── Shared Helpers ───────────────────────────────────────────────────
+  injectDefaultLighting(root) {
+    if (!this._defaultLighting) return;
+    if (!this.treeHasLights(root)) {
+      const shadowSize = this.tierScales.shadowMapSize;
+      root.children?.unshift(
+        this.createNode("ambientLight", { intensity: 0.4, color: "#ffffff" }),
+        this.createNode("directionalLight", {
+          intensity: 1,
+          position: [5, 10, 5],
+          castShadow: true,
+          "shadow-mapSize": [shadowSize, shadowSize],
+          color: "#ffffff"
+        })
+      );
+    }
+  }
+  treeHasLights(node) {
+    if (node.type.toLowerCase().includes("light")) return true;
+    return node.children?.some((c) => this.treeHasLights(c)) || false;
+  }
+  hasPostProcessing(node) {
+    if (node.traits?.has("bloom") || node.traits?.has("postprocessing"))
+      return true;
+    if (node.props.bloom) return true;
+    return node.children?.some((c) => this.hasPostProcessing(c)) || false;
+  }
+  extractPostProcessingNodes(node) {
+    const effects = [];
+    const ppTrait = node.traits?.get(
+      "postprocessing"
+    );
+    if (ppTrait) {
+      if (ppTrait.bloom)
+        effects.push(this.createNode("Bloom", ppTrait.bloom));
+      if (ppTrait.ssao)
+        effects.push(this.createNode("SSAO", ppTrait.ssao));
+      if (ppTrait.vignette)
+        effects.push(this.createNode("Vignette", ppTrait.vignette));
+    }
+    if (node.props.bloom) {
+      const bloom = node.props.bloom;
+      const bloomProps = typeof bloom === "object" && bloom !== null ? bloom : { intensity: 1 };
+      effects.push(this.createNode("Bloom", bloomProps));
+    }
+    node.children?.forEach((child) => effects.push(...this.extractPostProcessingNodes(child)));
+    return effects;
+  }
+  mapType(type, props) {
+    if (type === "environment") {
+      if (props.name && typeof props.name === "string" && ENVIRONMENT_PRESETS[props.name]) {
+        Object.assign(props, ENVIRONMENT_PRESETS[props.name]);
+      }
+      return "Environment";
+    }
+    if (type === "light") {
+      const lightType = props.type || "directional";
+      const lightMapping = {
+        directional: "directionalLight",
+        point: "pointLight",
+        spot: "spotLight",
+        hemisphere: "hemisphereLight",
+        ambient: "ambientLight",
+        area: "rectAreaLight"
+      };
+      return lightMapping[lightType] || "directionalLight";
+    }
+    if (type === "portal") return "Portal";
+    if (type === "sparkles") return "Sparkles";
+    if (MESH_TYPES.has(type)) {
+      props.hsType = type;
+      return "mesh";
+    }
+    const mapping = {
+      ambient_light: "ambientLight",
+      model: "gltfModel",
+      audio: "positionalAudio",
+      composition: "group",
+      scale: "group",
+      focus: "group",
+      spatial_agent: "SpatialAgent",
+      spatial_container: "group",
+      ui_panel: "UIPanel",
+      ui_text: "UIText",
+      ui_button: "UIButton",
+      ui_slider: "UISlider",
+      ui_input: "UIInput",
+      ui_image: "UIImage",
+      ui_chart: "UIChart",
+      ui_gauge: "UIGauge",
+      ui_value: "UIValue",
+      ui_status_indicator: "UIStatusIndicator",
+      tool_slot: "ToolSlot",
+      behavior: "group",
+      system: "System",
+      component: "Component",
+      dna: "DNA",
+      gaussian_splat: "splat",
+      splat: "splat",
+      nerf: "NeRF",
+      volumetric_video: "VolumetricVideo",
+      world: "group"
+    };
+    return mapping[type] || type;
+  }
+  applyPerceptualColorProps(props, traitConfig, scientific) {
+    const input = this.resolvePerceptualColorInput(props, traitConfig, scientific);
+    if (!input) return;
+    const pass = chunkVHORVGCG_cjs.applyPerceptualColorPass(input);
+    props.perceptualColor = pass;
+    if (pass.palette) {
+      props.palette = pass.palette.colors;
+    }
+    if (pass.gradient) {
+      props.gradient = pass.gradient.stops;
+      props.gradientColors = pass.gradient.colors;
+    }
+    if (pass.colorMap) {
+      props.colorMap = pass.colorMap.name;
+      props.colorMapColors = pass.colorMap.colors;
+      delete props.color_map;
+    }
+    if (!props.color && pass.gradient?.colors[0]) {
+      props.color = pass.gradient.colors[0];
+    }
+    const materialProps = props.materialProps && typeof props.materialProps === "object" ? props.materialProps : {};
+    if (pass.gradient?.colors[0] && materialProps.color === void 0) {
+      props.materialProps = { ...materialProps, color: pass.gradient.colors[0] };
+    }
+  }
+  resolvePerceptualColorInput(props, traitConfig, scientific) {
+    const palette = this.stringArray(props.palette) ?? this.stringArray(traitConfig?.palette);
+    const gradient = this.gradientStops(props.gradient) ?? this.gradientStops(traitConfig?.gradient);
+    const colorMap = this.colorMapValue(props.colorMap) ?? this.colorMapValue(props.color_map) ?? this.colorMapValue(traitConfig?.color_map) ?? this.colorMapValue(traitConfig?.colorMap);
+    const hasColorInput = palette !== void 0 || gradient !== void 0 || colorMap !== void 0;
+    if (!traitConfig && !(scientific && hasColorInput)) return void 0;
+    const mode = typeof traitConfig?.mode === "string" ? traitConfig.mode : "auto";
+    const base = {
+      steps: this.numberValue(traitConfig?.steps) ?? this.numberValue(props.steps) ?? 7,
+      dampening: this.numberValue(traitConfig?.dampening),
+      targetDeltaE: this.numberValue(traitConfig?.target_delta_e) ?? this.numberValue(traitConfig?.targetDeltaE),
+      neutralAxis: this.booleanValue(traitConfig?.neutral_axis) ?? this.booleanValue(traitConfig?.neutralAxis),
+      scientific
+    };
+    if (mode === "palette") return { ...base, palette: palette ?? ["#1F77B4", "#FF7F0E"] };
+    if (mode === "gradient") return { ...base, gradient: gradient ?? palette };
+    if (mode === "color_map") return { ...base, colorMap: colorMap ?? "viridis" };
+    if (colorMap !== void 0) return { ...base, colorMap };
+    if (gradient !== void 0) return { ...base, gradient };
+    if (palette !== void 0) return { ...base, palette };
+    return { ...base, colorMap: "viridis" };
+  }
+  isScientificColorNode(type, props) {
+    return type === "heatmap_view" || type === "heatmap" || type === "chart" || type === "graph" || type === "scatter_plot" || type === "line_graph" || props.scientific === true || props.color_map !== void 0 || props.colorMap !== void 0;
+  }
+  stringArray(value) {
+    return Array.isArray(value) && value.every((entry) => typeof entry === "string") ? [...value] : void 0;
+  }
+  gradientStops(value) {
+    const stringColors = this.stringArray(value);
+    if (stringColors) return stringColors;
+    if (!Array.isArray(value)) return void 0;
+    const stops = [];
+    for (const entry of value) {
+      if (!entry || typeof entry !== "object") continue;
+      const record = entry;
+      if (typeof record.t === "number" && typeof record.color === "string") {
+        stops.push({ t: record.t, color: record.color });
+      }
+    }
+    return stops.length > 0 ? stops : void 0;
+  }
+  colorMapValue(value) {
+    if (typeof value === "string") return value;
+    return this.gradientStops(value) ?? this.stringArray(value);
+  }
+  numberValue(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : void 0;
+  }
+  booleanValue(value) {
+    return typeof value === "boolean" ? value : void 0;
+  }
+  compileProperties(node, rawProps) {
+    const expandedProps = this.expandSpreads(rawProps);
+    const props = { ...expandedProps };
+    if (node.position) {
+      props.position = node.position;
+    }
+    if (rawProps.position && Array.isArray(rawProps.position)) {
+      props.position = rawProps.position;
+    }
+    if (node.hologram) {
+      const h = node.hologram;
+      if (h.color) props.color = h.color;
+      if (MESH_TYPES.has(node.type)) {
+        props.args = this.getGeometryArgs(node.type, h);
+        props.hsType = node.type;
+      }
+    }
+    if (rawProps.scale !== void 0 && !props.scale) {
+      props.scale = Array.isArray(rawProps.scale) ? rawProps.scale : [rawProps.scale, rawProps.scale, rawProps.scale];
+    }
+    if (rawProps.geometry && !props.hsType) {
+      props.hsType = rawProps.geometry;
+      props.args = this.getGeometryArgs(rawProps.geometry, { size: rawProps.size || 1 });
+    }
+    if (rawProps.material && typeof rawProps.material === "string" && MATERIAL_PRESETS[rawProps.material]) {
+      props.materialProps = {
+        ...MATERIAL_PRESETS[rawProps.material],
+        ...props.materialProps
+      };
+    }
+    if (node.directives) {
+      for (const d of node.directives) {
+        if (d.type === "trait") {
+          if (d.name === "grabbable") {
+            props.castShadow = true;
+            props.grabbable = d.config || true;
+            if (!props.rigidBody) props.rigidBody = { type: "dynamic" };
+            if (!props.collider) props.collider = { type: "auto" };
+          } else if (d.name === "animated") {
+            props.animated = d.config || true;
+          } else if (d.name === "spatial_audio" || d.name === "voice") {
+            props.spatial = true;
+          } else if (d.name === "gem_resonance") {
+            props.gemResonance = gemResonanceConfig(
+              d.config
+            );
+            props.spatial = true;
+          } else if (d.name === "networked") {
+            props.networked = d.config || true;
+          } else if (d.name === "moldable") {
+            props.moldable = d.config || true;
+          } else if (d.name === "stretchable") {
+            props.stretchable = d.config || true;
+          } else if (d.name === "ai_driven") {
+            props.ai_driven = d.config || true;
+          } else if (d.name === "dialogue") {
+            props.dialogue = d.config || true;
+          } else if (d.name === "gesture") {
+            props.gesture = d.config || true;
+          } else if (d.name === "haptic") {
+            props.haptic = d.config || true;
+          } else if (d.name === "avatar_embodiment") {
+            props.avatarEmbodiment = d.config || true;
+          } else if (d.name === "lip_sync") {
+            props.lipSync = d.config || true;
+          } else if (d.name === "emotion_directive") {
+            props.emotionDirective = d.config || true;
+          } else if (d.name === "stt") {
+            props.stt = d.config || true;
+          } else if (d.name === "tts") {
+            props.tts = d.config || true;
+          } else if (d.name === "generate") {
+            props.generate = d.config;
+          } else if (d.name === "skeleton") {
+            props.skeleton = d.config || true;
+          } else if (d.name === "body") {
+            props.body = d.config || true;
+          } else if (d.name === "gaussian_splat") {
+            props.gaussianSplat = d.config || true;
+          } else if (d.name === "nerf") {
+            props.nerf = d.config || true;
+          } else if (d.name === "volumetric_video") {
+            props.volumetricVideo = d.config || true;
+          } else if (d.name === "web_surface") {
+            props.webSurface = d.config || true;
+          }
+        }
+      }
+    }
+    const perceptualDirective = node.directives?.find(
+      (directive) => directive.type === "trait" && directive.name === "perceptual_color"
+    );
+    const perceptualDirectiveConfig = perceptualDirective ? perceptualDirective.config && typeof perceptualDirective.config === "object" ? perceptualDirective.config : {} : void 0;
+    this.applyPerceptualColorProps(
+      props,
+      perceptualDirectiveConfig,
+      this.isScientificColorNode(node.type, props)
+    );
+    delete props.type;
+    delete props.geometry;
+    return props;
+  }
+  applyGraphicsConfig(r3fNode, graphics) {
+    if (graphics.material) {
+      const m = graphics.material;
+      const materialProps = {};
+      if (m.preset && MATERIAL_PRESETS[m.preset]) {
+        Object.assign(materialProps, MATERIAL_PRESETS[m.preset]);
+      }
+      if (m.type === "pbr" && m.pbr) {
+        if (m.pbr.baseColor) materialProps["color"] = this.mapColor(m.pbr.baseColor);
+        if (m.pbr.metallic !== void 0) materialProps["metalness"] = m.pbr.metallic;
+        if (m.pbr.roughness !== void 0) materialProps["roughness"] = m.pbr.roughness;
+        if (m.pbr.emission) materialProps["emissive"] = this.mapColor(m.pbr.emission);
+        if (m.pbr.emissionStrength) materialProps["emissiveIntensity"] = m.pbr.emissionStrength;
+        if (m.pbr.clearcoat !== void 0) materialProps["clearcoat"] = m.pbr.clearcoat;
+        if (m.pbr.transmission !== void 0) materialProps["transmission"] = m.pbr.transmission;
+        if (m.pbr.ior !== void 0) materialProps["ior"] = m.pbr.ior;
+        if (m.pbr.iridescence !== void 0) materialProps["iridescence"] = m.pbr.iridescence;
+      }
+      const prior = r3fNode.props.materialProps ?? {};
+      r3fNode.props.materialProps = { ...prior, ...materialProps };
+    }
+    if (graphics.lighting) {
+      const l = graphics.lighting;
+      if (r3fNode.type.toLowerCase().includes("light")) {
+        if (l.shadows) r3fNode.props.castShadow = true;
+        if (l.intensity !== void 0) r3fNode.props.intensity = l.intensity;
+        if (l.color) r3fNode.props.color = this.mapColor(l.color);
+      }
+      if (r3fNode.type === "Environment" && l.preset) {
+        r3fNode.props.preset = l.preset;
+      }
+    }
+    if (graphics.networked) {
+      r3fNode.props.networked = graphics.networked;
+    }
+  }
+  mapColor(c) {
+    if (typeof c === "string") return c;
+    if (typeof c === "number") return `#${c.toString(16).padStart(6, "0")}`;
+    if (c.r !== void 0) {
+      const r = c.r > 1 ? c.r : Math.floor(c.r * 255);
+      const g = c.g > 1 ? c.g : Math.floor(c.g * 255);
+      const b = c.b > 1 ? c.b : Math.floor(c.b * 255);
+      return `rgb(${r}, ${g}, ${b})`;
+    }
+    return "#ffffff";
+  }
+  getGeometryArgs(type, hologram) {
+    const size = hologram.size || 1;
+    switch (type) {
+      case "sphere":
+      case "orb":
+        return [size * 0.5, 32, 32];
+      case "cube":
+      case "box":
+        return [size, size, size];
+      case "cylinder":
+        return [size * 0.5, size * 0.5, size, 32];
+      case "pyramid":
+      case "cone":
+        return [size * 0.5, 0, size, 4];
+      case "plane":
+        return [size, size];
+      case "torus":
+        return [size * 0.5, size * 0.15, 16, 32];
+      case "ring":
+        return [size * 0.3, size * 0.5, 32];
+      case "capsule":
+        return [size * 0.3, size * 0.5, 4, 16];
+      default:
+        return [size, size, size];
+    }
+  }
+};
+
+exports.ENVIRONMENT_PRESETS = ENVIRONMENT_PRESETS;
+exports.MATERIAL_PRESETS = MATERIAL_PRESETS;
+exports.QUALITY_TIER_SCALES = QUALITY_TIER_SCALES;
+exports.SceneIRCompiler = SceneIRCompiler;
+exports.UI_COMPONENT_PRESETS = UI_COMPONENT_PRESETS;
+exports.registerAllPresets = registerAllPresets;
+//# sourceMappingURL=chunk-GGR7QUKK.cjs.map
+//# sourceMappingURL=chunk-GGR7QUKK.cjs.map