@holoscript/core 6.0.3 → 7.0.0

package/dist/chunk-HBZYCASG.js

@@ -1,4208 +0,0 @@
-import { init_material_properties_visual, init_surface_texture_visual, init_lighting_visual, init_gems_minerals_visual, init_fabric_cloth_visual, init_visual_effects_visual, init_age_condition_visual, init_water_fluid_visual, init_weather_phenomena_visual, init_emotion_mood_visual, init_size_scale_visual, init_environmental_biome_visual, init_magic_fantasy_visual, init_scifi_technology_visual, init_creatures_mythical_visual, init_nature_life_visual, init_furniture_decor_visual, init_construction_building_visual, init_containers_storage_visual, init_shape_form_visual, init_animals_visual, init_maritime_naval_visual, init_time_period_visual, init_accessibility_visual, init_accessibility_extended_visual, init_architecture_realestate_visual, init_audio_visual, init_cooking_food_visual, init_core_vr_interaction_visual, init_data_visualization_visual, init_education_learning_visual, init_environment_input_visual, init_game_mechanics_visual, init_geospatial_web3_visual, init_healthcare_medical_visual, init_humanoid_avatar_visual, init_intelligence_behavior_visual, init_interop_copresence_visual, init_iot_autonomous_agents_visual, init_locomotion_movement_visual, init_measurement_sensing_visual, init_media_analytics_visual, init_multisensory_haptic_visual, init_musical_sound_visual, init_music_performance_visual, init_narrative_storytelling_visual, init_networking_ai_visual, init_npc_roles_visual, init_object_interaction_visual, init_parser_core_ui_visual, init_physical_affordances_visual, init_physics_expansion_visual, init_procedural_generation_visual, init_resource_gathering_visual, init_safety_boundaries_visual, init_signs_communication_visual, init_simple_modifiers_visual, init_social_commerce_visual, init_social_effects_visual, init_sports_fitness_visual, init_state_persistence_visual, init_transportation_vehicles_visual, init_volumetric_webgpu_visual, init_weather_particles_visual, init_xr_platform_visual, MATERIAL_PROPERTIES_VISUALS, SURFACE_TEXTURE_VISUALS, LIGHTING_VISUALS, GEMS_MINERALS_VISUALS, FABRIC_CLOTH_VISUALS, VISUAL_EFFECTS_VISUALS, AGE_CONDITION_VISUALS, WATER_FLUID_VISUALS, WEATHER_PHENOMENA_VISUALS, EMOTION_MOOD_VISUALS, SIZE_SCALE_VISUALS, ENVIRONMENTAL_BIOME_VISUALS, MAGIC_FANTASY_VISUALS, SCIFI_TECHNOLOGY_VISUALS, CREATURES_MYTHICAL_VISUALS, NATURE_LIFE_VISUALS, FURNITURE_DECOR_VISUALS, CONSTRUCTION_BUILDING_VISUALS, CONTAINERS_STORAGE_VISUALS, SHAPE_FORM_VISUALS, ANIMALS_VISUALS, MARITIME_NAVAL_VISUALS, TIME_PERIOD_VISUALS, ACCESSIBILITY_VISUALS, ACCESSIBILITY_EXTENDED_VISUALS, ARCHITECTURE_REALESTATE_VISUALS, AUDIO_VISUALS, COOKING_FOOD_VISUALS, CORE_VR_INTERACTION_VISUALS, DATA_VISUALIZATION_VISUALS, EDUCATION_LEARNING_VISUALS, ENVIRONMENT_INPUT_VISUALS, GAME_MECHANICS_VISUALS, GEOSPATIAL_WEB3_VISUALS, HEALTHCARE_MEDICAL_VISUALS, HUMANOID_AVATAR_VISUALS, INTELLIGENCE_BEHAVIOR_VISUALS, INTEROP_COPRESENCE_VISUALS, IOT_AUTONOMOUS_AGENTS_VISUALS, LOCOMOTION_MOVEMENT_VISUALS, MEASUREMENT_SENSING_VISUALS, MEDIA_ANALYTICS_VISUALS, MULTISENSORY_HAPTIC_VISUALS, MUSICAL_SOUND_VISUALS, MUSIC_PERFORMANCE_VISUALS, NARRATIVE_STORYTELLING_VISUALS, NETWORKING_AI_VISUALS, NPC_ROLES_VISUALS, OBJECT_INTERACTION_VISUALS, PARSER_CORE_UI_VISUALS, PHYSICAL_AFFORDANCES_VISUALS, PHYSICS_EXPANSION_VISUALS, PROCEDURAL_GENERATION_VISUALS, RESOURCE_GATHERING_VISUALS, SAFETY_BOUNDARIES_VISUALS, SIGNS_COMMUNICATION_VISUALS, SIMPLE_MODIFIERS_VISUALS, SOCIAL_COMMERCE_VISUALS, SOCIAL_EFFECTS_VISUALS, SPORTS_FITNESS_VISUALS, STATE_PERSISTENCE_VISUALS, TRANSPORTATION_VEHICLES_VISUALS, VOLUMETRIC_WEBGPU_VISUALS, WEATHER_PARTICLES_VISUALS, XR_PLATFORM_VISUALS } from './chunk-ODGMVILH.js';
-import { init_ProvenanceSemiring, ProvenanceSemiring } from './chunk-UQW6SLM5.js';
-import { init_TraitVisualRegistry, init_types, init_TraitCompositor, TraitCompositor, TraitVisualRegistry } from './chunk-XSF76QRU.js';
-import { init_DomainBlockCompilerMixin, compileDomainBlocks, compileWeatherBlock, weatherToR3F, compileAudioSourceBlock, audioSourceToR3F, compilePostProcessingBlock, postProcessingToR3F, compileParticleBlock, particlesToR3F, compilePhysicsBlock, physicsToR3F, compileMaterialBlock, materialToR3F } from './chunk-KDB6BUMB.js';
-import { init_CompilerBase, UnauthorizedCompilerAccessError, escapeStringValue } from './chunk-QWKUKVRE.js';
-import { init_AgentRBAC, getRBAC } from './chunk-V42NTCFH.js';
-import { __esm, __export } from './chunk-32TWR3HE.js';
-
-// src/traits/visual/presets/hologram-media.visual.ts
-var HOLOGRAM_MEDIA_VISUALS;
-var init_hologram_media_visual = __esm({
-  "src/traits/visual/presets/hologram-media.visual.ts"() {
-    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;
-var init_gaps_physics_visual = __esm({
-  "src/traits/visual/presets/gaps-physics.visual.ts"() {
-    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;
-var init_phone_sleeve_vr_visual = __esm({
-  "src/traits/visual/presets/phone-sleeve-vr.visual.ts"() {
-    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
-function registerAllPresets() {
-  const registry = TraitVisualRegistry.getInstance();
-  for (const presetMap of ALL_PRESETS) {
-    registry.registerBatch(presetMap);
-  }
-}
-var ALL_PRESETS;
-var init_visual = __esm({
-  "src/traits/visual/index.ts"() {
-    init_TraitVisualRegistry();
-    init_types();
-    init_TraitVisualRegistry();
-    init_material_properties_visual();
-    init_surface_texture_visual();
-    init_lighting_visual();
-    init_gems_minerals_visual();
-    init_fabric_cloth_visual();
-    init_visual_effects_visual();
-    init_age_condition_visual();
-    init_water_fluid_visual();
-    init_weather_phenomena_visual();
-    init_emotion_mood_visual();
-    init_size_scale_visual();
-    init_environmental_biome_visual();
-    init_magic_fantasy_visual();
-    init_scifi_technology_visual();
-    init_creatures_mythical_visual();
-    init_nature_life_visual();
-    init_furniture_decor_visual();
-    init_construction_building_visual();
-    init_containers_storage_visual();
-    init_shape_form_visual();
-    init_animals_visual();
-    init_maritime_naval_visual();
-    init_time_period_visual();
-    init_accessibility_visual();
-    init_accessibility_extended_visual();
-    init_architecture_realestate_visual();
-    init_audio_visual();
-    init_cooking_food_visual();
-    init_core_vr_interaction_visual();
-    init_data_visualization_visual();
-    init_education_learning_visual();
-    init_environment_input_visual();
-    init_game_mechanics_visual();
-    init_geospatial_web3_visual();
-    init_healthcare_medical_visual();
-    init_humanoid_avatar_visual();
-    init_intelligence_behavior_visual();
-    init_interop_copresence_visual();
-    init_iot_autonomous_agents_visual();
-    init_locomotion_movement_visual();
-    init_measurement_sensing_visual();
-    init_media_analytics_visual();
-    init_multisensory_haptic_visual();
-    init_musical_sound_visual();
-    init_music_performance_visual();
-    init_narrative_storytelling_visual();
-    init_networking_ai_visual();
-    init_npc_roles_visual();
-    init_object_interaction_visual();
-    init_parser_core_ui_visual();
-    init_physical_affordances_visual();
-    init_physics_expansion_visual();
-    init_procedural_generation_visual();
-    init_resource_gathering_visual();
-    init_safety_boundaries_visual();
-    init_signs_communication_visual();
-    init_simple_modifiers_visual();
-    init_social_commerce_visual();
-    init_social_effects_visual();
-    init_sports_fitness_visual();
-    init_state_persistence_visual();
-    init_transportation_vehicles_visual();
-    init_volumetric_webgpu_visual();
-    init_weather_particles_visual();
-    init_xr_platform_visual();
-    init_hologram_media_visual();
-    init_gaps_physics_visual();
-    init_phone_sleeve_vr_visual();
-    ALL_PRESETS = [
-      // Original 12
-      MATERIAL_PROPERTIES_VISUALS,
-      SURFACE_TEXTURE_VISUALS,
-      LIGHTING_VISUALS,
-      GEMS_MINERALS_VISUALS,
-      FABRIC_CLOTH_VISUALS,
-      VISUAL_EFFECTS_VISUALS,
-      AGE_CONDITION_VISUALS,
-      WATER_FLUID_VISUALS,
-      WEATHER_PHENOMENA_VISUALS,
-      EMOTION_MOOD_VISUALS,
-      SIZE_SCALE_VISUALS,
-      ENVIRONMENTAL_BIOME_VISUALS,
-      // Expansion wave 1
-      MAGIC_FANTASY_VISUALS,
-      SCIFI_TECHNOLOGY_VISUALS,
-      CREATURES_MYTHICAL_VISUALS,
-      NATURE_LIFE_VISUALS,
-      FURNITURE_DECOR_VISUALS,
-      CONSTRUCTION_BUILDING_VISUALS,
-      CONTAINERS_STORAGE_VISUALS,
-      SHAPE_FORM_VISUALS,
-      ANIMALS_VISUALS,
-      MARITIME_NAVAL_VISUALS,
-      TIME_PERIOD_VISUALS,
-      // Expansion wave 2 — full coverage
-      ACCESSIBILITY_VISUALS,
-      ACCESSIBILITY_EXTENDED_VISUALS,
-      ARCHITECTURE_REALESTATE_VISUALS,
-      AUDIO_VISUALS,
-      COOKING_FOOD_VISUALS,
-      CORE_VR_INTERACTION_VISUALS,
-      DATA_VISUALIZATION_VISUALS,
-      EDUCATION_LEARNING_VISUALS,
-      ENVIRONMENT_INPUT_VISUALS,
-      GAME_MECHANICS_VISUALS,
-      GEOSPATIAL_WEB3_VISUALS,
-      HEALTHCARE_MEDICAL_VISUALS,
-      HUMANOID_AVATAR_VISUALS,
-      INTELLIGENCE_BEHAVIOR_VISUALS,
-      INTEROP_COPRESENCE_VISUALS,
-      IOT_AUTONOMOUS_AGENTS_VISUALS,
-      LOCOMOTION_MOVEMENT_VISUALS,
-      MEASUREMENT_SENSING_VISUALS,
-      MEDIA_ANALYTICS_VISUALS,
-      MULTISENSORY_HAPTIC_VISUALS,
-      MUSICAL_SOUND_VISUALS,
-      MUSIC_PERFORMANCE_VISUALS,
-      NARRATIVE_STORYTELLING_VISUALS,
-      NETWORKING_AI_VISUALS,
-      NPC_ROLES_VISUALS,
-      OBJECT_INTERACTION_VISUALS,
-      PARSER_CORE_UI_VISUALS,
-      PHYSICAL_AFFORDANCES_VISUALS,
-      PHYSICS_EXPANSION_VISUALS,
-      PROCEDURAL_GENERATION_VISUALS,
-      RESOURCE_GATHERING_VISUALS,
-      SAFETY_BOUNDARIES_VISUALS,
-      SIGNS_COMMUNICATION_VISUALS,
-      SIMPLE_MODIFIERS_VISUALS,
-      SOCIAL_COMMERCE_VISUALS,
-      SOCIAL_EFFECTS_VISUALS,
-      SPORTS_FITNESS_VISUALS,
-      STATE_PERSISTENCE_VISUALS,
-      TRANSPORTATION_VEHICLES_VISUALS,
-      VOLUMETRIC_WEBGPU_VISUALS,
-      WEATHER_PARTICLES_VISUALS,
-      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
-    ];
-    registerAllPresets();
-  }
-});
-
-// src/compiler/ObjectPool.ts
-var ASTNodePool;
-var init_ObjectPool = __esm({
-  "src/compiler/ObjectPool.ts"() {
-    ASTNodePool = class {
-      /**
-       * @param factory Creates a fresh instance of the node.
-       * @param resetter Resets the node state before it is handed out again.
-       * @param initialCapacity How many nodes to pre-allocate.
-       */
-      constructor(factory, resetter, initialCapacity = 1e4) {
-        this.pool = [];
-        this.factory = factory;
-        this.resetter = resetter;
-        for (let i = 0; i < initialCapacity; i++) {
-          this.pool.push(this.factory());
-        }
-      }
-      /**
-       * Acquire a node from the pool, or create a new one if the pool is empty.
-       */
-      acquire() {
-        if (this.pool.length > 0) {
-          const node = this.pool.pop();
-          this.resetter(node);
-          return node;
-        }
-        return this.factory();
-      }
-      /**
-       * Release a node back to the pool to be reused.
-       */
-      release(node) {
-        this.pool.push(node);
-      }
-      /**
-       * Release an array of nodes back to the pool.
-       */
-      releaseAll(nodes) {
-        for (const node of nodes) {
-          this.pool.push(node);
-        }
-      }
-      /**
-       * Clear the pool, allowing garbage collection.
-       */
-      clear() {
-        this.pool.length = 0;
-      }
-    };
-  }
-});
-
-// src/compiler/R3FCompiler.ts
-var R3FCompiler_exports = {};
-__export(R3FCompiler_exports, {
-  ENVIRONMENT_PRESETS: () => ENVIRONMENT_PRESETS,
-  MATERIAL_PRESETS: () => MATERIAL_PRESETS,
-  QUALITY_TIER_SCALES: () => QUALITY_TIER_SCALES,
-  R3FCompiler: () => R3FCompiler,
-  UI_COMPONENT_PRESETS: () => UI_COMPONENT_PRESETS
-});
-var r3fNodePool, MATERIAL_PRESETS, ENVIRONMENT_PRESETS, MESH_TYPES, UI_COMPONENT_PRESETS, QUALITY_TIER_SCALES, R3FCompiler;
-var init_R3FCompiler = __esm({
-  "src/compiler/R3FCompiler.ts"() {
-    init_TraitCompositor();
-    init_ProvenanceSemiring();
-    init_visual();
-    init_DomainBlockCompilerMixin();
-    init_AgentRBAC();
-    init_CompilerBase();
-    init_ObjectPool();
-    r3fNodePool = new 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
-    );
-    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
-      }
-    };
-    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 }
-        }
-      }
-    };
-    MESH_TYPES = /* @__PURE__ */ new Set([
-      "orb",
-      "sphere",
-      "cube",
-      "box",
-      "cylinder",
-      "pyramid",
-      "cone",
-      "plane",
-      "torus",
-      "ring",
-      "capsule",
-      "object",
-      "avatar",
-      "dna",
-      "gaussian_splat",
-      "splat",
-      "nerf",
-      "volumetric_video",
-      // Procedural geometry types (hull/spline/membrane/blob/metaball)
-      "hull",
-      "spline",
-      "membrane",
-      "blob",
-      "metaball"
-    ]);
-    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"
-        }
-      }
-    };
-    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"
-      }
-    };
-    R3FCompiler = class {
-      constructor(options = {}) {
-        // ─── RBAC Enforcement ─────────────────────────────────────────────────
-        this.compilerName = "R3FCompiler";
-        this.rbac = getRBAC();
-        this.qualityTier = options.qualityTier ?? "high";
-        this.tierScales = QUALITY_TIER_SCALES[this.qualityTier];
-        this._defaultLighting = options.defaultLighting ?? true;
-      }
-      /**
-       * 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 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 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 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 = compileDomainBlocks(
-            domainBlocks,
-            {
-              material: (block) => {
-                const mat = compileMaterialBlock(block);
-                return {
-                  type: "DomainBlockOutput",
-                  props: {
-                    __raw: materialToR3F(mat, this.tierScales),
-                    __domain: "material",
-                    __name: mat.name
-                  },
-                  children: []
-                };
-              },
-              physics: (block) => {
-                const phys = compilePhysicsBlock(block);
-                return {
-                  type: "DomainBlockOutput",
-                  props: {
-                    __raw: physicsToR3F(phys),
-                    __domain: "physics",
-                    __name: phys.name || phys.keyword
-                  },
-                  children: []
-                };
-              },
-              vfx: (block) => {
-                const ps = compileParticleBlock(block);
-                return {
-                  type: "DomainBlockOutput",
-                  props: {
-                    __raw: particlesToR3F(ps, this.tierScales),
-                    __domain: "vfx",
-                    __name: ps.name
-                  },
-                  children: []
-                };
-              },
-              postfx: (block) => {
-                const pp = compilePostProcessingBlock(block);
-                return {
-                  type: "DomainBlockOutput",
-                  props: {
-                    __raw: postProcessingToR3F(pp),
-                    __domain: "postfx",
-                    __name: pp.name || "PostProcessing"
-                  },
-                  children: []
-                };
-              },
-              audio: (block) => {
-                const audio = compileAudioSourceBlock(block);
-                return {
-                  type: "DomainBlockOutput",
-                  props: { __raw: audioSourceToR3F(audio), __domain: "audio", __name: audio.name },
-                  children: []
-                };
-              },
-              weather: (block) => {
-                const weather = compileWeatherBlock(block);
-                return {
-                  type: "DomainBlockOutput",
-                  props: {
-                    __raw: weatherToR3F(weather),
-                    __domain: "weather",
-                    __name: weather.name || "Weather"
-                  },
-                  children: []
-                };
-              }
-            }
-          );
-          if (!root.children) root.children = [];
-          for (const c of compiled) {
-            if (typeof c === "object") root.children.push(c);
-          }
-        }
-        return root;
-      }
-      createNode(type, props = {}, id) {
-        const node = r3fNodePool.acquire();
-        node.type = type;
-        node.id = id;
-        node.props = props;
-        node.children = [];
-        node.traits = /* @__PURE__ */ new Map();
-        node.directives = [];
-        return node;
-      }
-      compileNode(node) {
-        if (node.type === "system") {
-          return this.compileSystemNode(node);
-        }
-        if (node.type === "component") {
-          return this.compileComponentNode(node);
-        }
-        const rawProps = node.properties || {};
-        const type = this.mapType(node.type, rawProps);
-        const r3fNode = r3fNodePool.acquire();
-        r3fNode.type = type;
-        const rawId = node.id || node.name;
-        r3fNode.id = rawId ? 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 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);
-        const root = r3fNodePool.acquire();
-        root.type = "group";
-        root.id = composition.name ? 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 (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)
-          });
-        }
-        this.injectDefaultLighting(root);
-        return root;
-      }
-      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 = r3fNodePool.acquire();
-        r3fNode.type = type;
-        r3fNode.id = light.name ? 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 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 === "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 === "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 === "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 (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 {
-              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 TraitCompositor();
-          const composedMaterial = compositor.compose(traitNames);
-          if (Object.keys(composedMaterial).length > 0) {
-            props.materialProps = { ...props.materialProps, ...composedMaterial };
-          }
-        }
-        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 {
-          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;
-          }
-        }
-        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 = {};
-        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];
-          }
-        }
-        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));
-        }
-        return node;
-      }
-      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 ? escapeStringValue(timeline.name, "JSX") : void 0;
-        const timelineNode = this.createNode(
-          "Timeline",
-          { autoplay: timeline.autoplay, loop: timeline.loop },
-          safeName
-        );
-        timelineNode.children = entries;
-        return timelineNode;
-      }
-      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 ? 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 ? 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 ? 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 ? 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) {
-          effects.push(
-            this.createNode(
-              "Bloom",
-              typeof node.props.bloom === "object" ? node.props.bloom : { intensity: 1 }
-            )
-          );
-        }
-        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",
-          avatar: "Avatar",
-          dna: "DNA",
-          gaussian_splat: "GaussianSplat",
-          splat: "GaussianSplat",
-          nerf: "NeRF",
-          volumetric_video: "VolumetricVideo"
-        };
-        return mapping[type] || type;
-      }
-      compileProperties(node, rawProps) {
-        const expandedProps = this.expandSpreads(rawProps);
-        const props = { ...expandedProps };
-        if (node.position) {
-          props.position = [node.position.x, node.position.y, node.position.z];
-        }
-        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 === "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;
-              }
-            }
-          }
-        }
-        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;
-          }
-          r3fNode.props.materialProps = { ...r3fNode.props.materialProps, ...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];
-        }
-      }
-    };
-  }
-});
-
-export { ASTNodePool, ENVIRONMENT_PRESETS, MATERIAL_PRESETS, QUALITY_TIER_SCALES, R3FCompiler, R3FCompiler_exports, UI_COMPONENT_PRESETS, init_ObjectPool, init_R3FCompiler, init_visual, registerAllPresets };
-//# sourceMappingURL=chunk-HBZYCASG.js.map
-//# sourceMappingURL=chunk-HBZYCASG.js.map