@holoscript/core 7.0.0 → 8.0.1

package/dist/chunk-BGY3SDG3.js

@@ -0,0 +1,4396 @@
+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-XT6JY5W5.js';
+import { init_BotanicalLotusTrait, createBotanicalLotusRenderProfile, buildLotusPetalMaterialSpec, LOTUS_PETAL_UNIFORM_BINDINGS } from './chunk-4GU5GCIY.js';
+import { init_ProvenanceSemiring, ProvenanceSemiring } from './chunk-TJHVSBP2.js';
+import { init_TraitVisualRegistry, init_types, init_TraitCompositor, TraitCompositor, TraitVisualRegistry } from './chunk-4C57PR42.js';
+import { init_PlatformConditionalCompilerMixin, createPlatformTarget, PlatformConditionalCompilerMixin } from './chunk-GZG4KA4E.js';
+import { init_DomainBlockCompilerMixin, compileDomainBlocks, compileSimulationBlock, simulationToR3F, compileWeatherBlock, weatherToR3F, compileAudioSourceBlock, audioSourceToR3F, compilePostProcessingBlock, postProcessingToR3F, compileParticleBlock, particlesToR3F, compilePhysicsBlock, physicsToR3F, compileMaterialBlock, materialToR3F } from './chunk-BOVPWH4H.js';
+import { init_AgentRBAC, init_CompilerBase, getRBAC, UnauthorizedCompilerAccessError, escapeStringValue } from './chunk-QPSKHBJP.js';
+import { __esm, __export } from './chunk-OL46QLBJ.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
+});
+function isVfxParticleTraitName(name) {
+  return name.startsWith("vfx_particle_");
+}
+function vfxParticleEffect(name) {
+  return name.replace("vfx_particle_", "");
+}
+function gemResonanceConfig(config) {
+  return {
+    max_distance: 0.5,
+    base_frequencies: "auto",
+    blend_mode: "harmonic",
+    output: "spatial_audio",
+    ...config || {}
+  };
+}
+var 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_PlatformConditionalCompilerMixin();
+    init_AgentRBAC();
+    init_CompilerBase();
+    init_ObjectPool();
+    init_BotanicalLotusTrait();
+    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;
+        this._holomapPointCloud = options.holomapPointCloud;
+        if (options.platformTarget) {
+          this._platformTarget = typeof options.platformTarget === "string" ? createPlatformTarget(options.platformTarget) : options.platformTarget;
+        }
+      }
+      /**
+       * Validate agent permissions before compilation.
+       * Skips validation when no token is provided (backwards compatibility).
+       *
+       * Checks:
+       * 1. AST read access (can the agent read AST?)
+       * 2. Code generation access (can the agent generate code?)
+       * 3. Output path scope (if outputPath provided)
+       *
+       * @param agentToken - Agent JWT token (optional for backwards compat)
+       * @param outputPath - Optional output file path for scope validation
+       * @throws UnauthorizedCompilerAccessError if token is provided but invalid/unauthorized
+       */
+      validateCompilerAccess(agentToken, outputPath) {
+        if (!agentToken) return;
+        const astDecision = this.rbac.checkAccess({
+          token: agentToken,
+          resourceType: "ast" /* AST */,
+          operation: "read",
+          expectedWorkflowStep: "generate_assembly" /* GENERATE_ASSEMBLY */
+        });
+        if (!astDecision.allowed) {
+          throw new 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: []
+                };
+              },
+              simulation: (block) => {
+                const sim = compileSimulationBlock(block);
+                return {
+                  type: "DomainBlockOutput",
+                  props: {
+                    __raw: simulationToR3F(sim),
+                    __domain: "simulation",
+                    __name: sim.name || "Simulation"
+                  },
+                  children: []
+                };
+              }
+            }
+          );
+          if (!root.children) root.children = [];
+          for (const c of compiled) {
+            if (typeof c === "object") root.children.push(c);
+          }
+        }
+        return root;
+      }
+      /**
+       * Compiles a declarative 'world' node into R3F scene nodes.
+       * Nested `world.children` (objects) are compiled via the same path as top-level objects.
+       */
+      compileWorldNode(world, templateMap) {
+        const nodes = [];
+        const props = {};
+        if (world.properties) {
+          for (const prop of world.properties) {
+            props[prop.key] = prop.value;
+          }
+        }
+        if (props.ambient_light !== void 0) {
+          nodes.push(
+            this.createNode("ambientLight", {
+              intensity: Number(props.ambient_light)
+            })
+          );
+        }
+        if (props.skybox_color !== void 0) {
+          nodes.push(
+            this.createNode("Environment", {
+              background: true,
+              preset: "sunset"
+              // Default preset if just color is given
+            })
+          );
+          nodes.push(
+            this.createNode("color", {
+              attach: "background",
+              args: [props.skybox_color]
+            })
+          );
+        }
+        if (props.gravity !== void 0) {
+          nodes.push(
+            this.createNode("Physics", {
+              gravity: [0, -Number(props.gravity), 0]
+            })
+          );
+        }
+        const childNodes = [];
+        if (world.children && world.children.length > 0) {
+          for (const child of world.children) {
+            childNodes.push(this.compileObjectDecl(child, templateMap));
+          }
+        }
+        if (childNodes.length === 0) {
+          return nodes;
+        }
+        const group = this.createNode(
+          "group",
+          {},
+          world.name ? escapeStringValue(world.name, "JSX") : void 0
+        );
+        group.children = [...nodes, ...childNodes];
+        return [group];
+      }
+      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;
+      }
+      /**
+       * I.007 closure: emit a node's compiled petal material spec into its props.
+       * Shared by every trait-bearing compile path (compileNode directives + the
+       * .holo compileObjectDecl obj.traits path) so the emission can't silently miss
+       * the real parser route. The spec is the locked CompiledMaterialSpec shape that
+       * the renderer's buildCompiledMaterial consumes — building the petal material
+       * from `.holo` data instead of hand-authoring it.
+       */
+      emitCompiledLotusMaterial(props, config) {
+        const profile = createBotanicalLotusRenderProfile(config);
+        props.__compiledMaterial = buildLotusPetalMaterialSpec(profile);
+        props.__uniformBindings = LOTUS_PETAL_UNIFORM_BINDINGS;
+      }
+      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 lotusConfig = r3fNode.traits?.get("botanical_lotus");
+        if (lotusConfig) {
+          this.emitCompiledLotusMaterial(r3fNode.props, lotusConfig);
+        }
+        const enhanced = node;
+        if (enhanced.graphics) {
+          this.applyGraphicsConfig(r3fNode, enhanced.graphics);
+        }
+        if (enhanced.children && Array.isArray(enhanced.children)) {
+          r3fNode.children = enhanced.children.map(
+            (child) => this.compileNode(child)
+          );
+        }
+        return r3fNode;
+      }
+      // ─── HoloComposition Compilation (.holo files) ────────────────────────
+      compileComposition(composition, agentToken, outputPath) {
+        this.validateCompilerAccess(agentToken, outputPath);
+        if (this._platformTarget) {
+          const platformMixin = new PlatformConditionalCompilerMixin();
+          composition = platformMixin.filterForPlatform(composition, this._platformTarget);
+        }
+        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 (Array.isArray(composition.worlds)) {
+          for (const world of composition.worlds) {
+            root.children.push(
+              ...this.compileWorldNode(
+                world,
+                templateMap
+              )
+            );
+          }
+        }
+        if (composition.ui) {
+          root.children.push(this.compileUIBlock(composition.ui));
+        }
+        if (Array.isArray(composition.transitions)) {
+          for (const transition of composition.transitions) {
+            root.children.push(this.compileTransitionBlock(transition));
+          }
+        }
+        if (Array.isArray(composition.conditionals)) {
+          for (const cond of composition.conditionals) {
+            root.children.push(this.compileConditionalBlock(cond, templateMap));
+          }
+        }
+        if (Array.isArray(composition.iterators)) {
+          for (const iter of composition.iterators) {
+            root.children.push(this.compileForEachBlock(iter, templateMap));
+          }
+        }
+        if (composition.camera) {
+          root.children.push(this.compileCameraBlock(composition.camera));
+        }
+        if (composition.effects) {
+          root.children.unshift(
+            this.compileEffectsBlock(composition.effects)
+          );
+        } else if (this.hasPostProcessing(root)) {
+          root.children.unshift({
+            type: "EffectComposer",
+            props: {},
+            children: this.extractPostProcessingNodes(root)
+          });
+        }
+        this.injectHolomapPointCloud(root);
+        this.injectDefaultLighting(root);
+        return root;
+      }
+      /** R3F host apps can map this node to BufferGeometry + pointsMaterial from base64 buffers. */
+      injectHolomapPointCloud(root) {
+        const h = this._holomapPointCloud;
+        if (!h || h.pointCount < 1 || !h.positionsB64 || !h.colorsB64) return;
+        if (!root.children) root.children = [];
+        root.children.push({
+          type: "holomapPointCloud",
+          props: {
+            positionsB64: h.positionsB64,
+            colorsB64: h.colorsB64,
+            pointCount: h.pointCount
+          }
+        });
+      }
+      compileLightBlock(light) {
+        const lightMapping = {
+          directional: "directionalLight",
+          point: "pointLight",
+          spot: "spotLight",
+          hemisphere: "hemisphereLight",
+          ambient: "ambientLight",
+          area: "rectAreaLight"
+        };
+        const type = lightMapping[light.lightType] || "directionalLight";
+        const props = {};
+        if (Array.isArray(light.properties)) {
+          for (const prop of light.properties) {
+            const key = prop.key;
+            const value = prop.value;
+            if (key === "cast_shadow" || key === "castShadow") {
+              props.castShadow = value;
+            } else if (key === "ground_color" || key === "groundColor") {
+              props.groundColor = value;
+            } else if (key === "shadow_map_size") {
+              props["shadow-mapSize"] = Array.isArray(value) ? value : [value, value];
+            } else {
+              props[key] = value;
+            }
+          }
+        }
+        if ((light.lightType === "directional" || light.lightType === "spot") && props.castShadow === void 0) {
+          props.castShadow = true;
+        }
+        const r3fNode = 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 === "gem_resonance") {
+              props.gemResonance = gemResonanceConfig(trait.config);
+              props.spatial = true;
+            } else if (name === "shadow") {
+              props.castShadow = true;
+              if (trait.config?.mapSize)
+                props["shadow-mapSize"] = [trait.config.mapSize, trait.config.mapSize];
+            } else if (name === "material") {
+              const presetName = trait.config?.preset;
+              if (presetName && typeof presetName === "string" && MATERIAL_PRESETS[presetName]) {
+                const { preset: _, ...rest } = trait.config;
+                props.materialProps = {
+                  ...MATERIAL_PRESETS[presetName],
+                  ...rest,
+                  ...props.materialProps
+                };
+              } else {
+                props.materialProps = {
+                  ...props.materialProps,
+                  ...trait.config
+                };
+              }
+            } else if (name === "networked") {
+              props.networked = trait.config || true;
+            } else if (name === "moldable") {
+              props.moldable = trait.config || true;
+            } else if (name === "stretchable") {
+              props.stretchable = trait.config || true;
+            } else if (name === "bloom") {
+              props.bloom = trait.config || { intensity: 1 };
+            } else if (name === "portal") {
+              props.portal = trait.config || true;
+            } else if (name === "attach") {
+              props.attach = trait.config || true;
+            } else if (name === "orbit") {
+              props.orbit = trait.config || true;
+            } else if (name === "look_at") {
+              props.lookAtTarget = trait.config || true;
+            } else if (name === "follow") {
+              props.follow = trait.config || true;
+            } else if (name === "plane_detection") {
+              props.planeDetection = trait.config || { mode: "all" };
+            } else if (name === "mesh_detection") {
+              props.meshDetection = trait.config || { classification: true };
+            } else if (name === "anchor") {
+              props.anchor = trait.config || { type: "spatial" };
+            } else if (name === "persistent_anchor") {
+              props.persistentAnchor = trait.config || { storage: "local" };
+            } else if (name === "shared_anchor") {
+              props.sharedAnchor = trait.config || { authority: "creator" };
+            } else if (name === "occlusion") {
+              props.occlusionMode = trait.config?.mode || "environment";
+              props.occlusion = trait.config || true;
+            } else if (name === "light_estimation") {
+              props.lightEstimation = trait.config || { auto_apply: true };
+            } else if (name === "geospatial") {
+              props.geospatial = trait.config || true;
+            } else if (name === "gaussian_splat") {
+              props.gaussianSplat = trait.config || true;
+            } else if (name === "nerf") {
+              props.nerf = trait.config || true;
+            } else if (name === "volumetric_video") {
+              props.volumetricVideo = trait.config || true;
+            } else if (name === "point_cloud") {
+              props.pointCloud = trait.config || true;
+            } else if (name === "photogrammetry") {
+              props.photogrammetry = trait.config || true;
+            } else if (name === "web_surface") {
+              props.webSurface = trait.config || true;
+            } else if (name === "cloth") {
+              props.cloth = trait.config || { stiffness: 0.8 };
+              if (!props.rigidBody) props.rigidBody = { type: "dynamic" };
+            } else if (name === "fluid") {
+              props.fluid = trait.config || { viscosity: 0.01 };
+              props.__gapsComponents = props.__gapsComponents || [];
+              props.__gapsComponents.push("FluidRenderer");
+            } else if (name === "soft_body") {
+              props.softBody = trait.config || { elasticity: 0.5 };
+              if (!props.rigidBody) props.rigidBody = { type: "dynamic" };
+            } else if (name === "rope") {
+              props.rope = trait.config || { segments: 20 };
+            } else if (name === "chain") {
+              props.chain = trait.config || { link_count: 20 };
+            } else if (name === "wind") {
+              props.wind = trait.config || { strength: 5 };
+            } else if (name === "buoyancy") {
+              props.buoyancy = trait.config || { water_level: 0 };
+            } else if (name === "destruction") {
+              props.destruction = trait.config || { health: 100 };
+              if (!props.rigidBody) props.rigidBody = { type: "dynamic" };
+              if (!props.collider) props.collider = { type: "auto" };
+            } else if (name === "soft_body_pro") {
+              props.softBodyPro = trait.config || { tear_threshold: 0.5 };
+              if (!props.rigidBody) props.rigidBody = { type: "dynamic" };
+            } else if (name === "crowd_sim") {
+              props.crowdSim = trait.config || { max_agents: 1e3 };
+            } else if (name === "deformable_terrain") {
+              props.deformableTerrain = trait.config || { resolution: 256 };
+            } else if (name === "volumetric_clouds") {
+              props.volumetricClouds = trait.config || { coverage: 0.5 };
+              props.__gapsComponents = props.__gapsComponents || [];
+              props.__gapsComponents.push("CloudRenderer");
+            } else if (name === "god_rays") {
+              props.godRays = trait.config || { intensity: 1 };
+              props.__gapsComponents = props.__gapsComponents || [];
+              props.__gapsComponents.push("GodRaysEffect");
+            } else if (name === "spatial_voice") {
+              props.spatialVoice = trait.config || { max_distance: 30 };
+              props.spatial = true;
+            } else if (name === "ai_companion") {
+              props.aiCompanion = trait.config || { personality: "friendly" };
+            } else if (name === "moderation") {
+              props.moderation = trait.config || { sensitivity: "medium" };
+            } else if (name === "anti_grief") {
+              props.antiGrief = trait.config || { detection_window: 30 };
+            } else if (name === "world_state") {
+              props.worldState = trait.config || { sync_rate: 10 };
+            } else if (name === "token_gated") {
+              props.tokenGated = trait.config || { token_contract: "", min_balance: 1 };
+            } else if (name === "ambisonics") {
+              props.ambisonics = trait.config || { order: 1 };
+              props.spatial = true;
+            } else if (name === "hrtf") {
+              props.hrtf = trait.config || true;
+              props.spatial = true;
+            } else if (name === "reverb_zone") {
+              props.reverbZone = trait.config || { preset: "room" };
+            } else if (name === "audio_occlusion") {
+              props.audioOcclusion = trait.config || true;
+            } else if (name === "audio_portal") {
+              props.audioPortal = trait.config || true;
+            } else if (name === "head_tracked_audio") {
+              props.headTrackedAudio = trait.config || true;
+              props.spatial = true;
+            } else if (name === "accessible") {
+              props.accessible = trait.config || { role: "generic" };
+            } else if (name === "alt_text") {
+              props.altText = trait.config?.text || "";
+            } else if (name === "magnifiable") {
+              props.magnifiable = trait.config || { max_scale: 3 };
+            } else if (name === "high_contrast") {
+              props.highContrast = trait.config || { mode: "outline" };
+            } else if (name === "motion_reduced") {
+              props.motionReduced = trait.config || true;
+              if (props.animated) props.animated = false;
+            } else if (name === "compute") {
+              props.compute = trait.config || true;
+            } else if (name === "gpu_particle") {
+              props.gpuParticle = trait.config || { count: 1e4 };
+            } else if (isVfxParticleTraitName(name)) {
+              const particleConfig = {
+                effect: vfxParticleEffect(name),
+                ...trait.config || {}
+              };
+              const gpuParticles = props.gpuParticles ?? [];
+              props.gpuParticles = [...gpuParticles, particleConfig];
+              if (!props.gpuParticle) props.gpuParticle = particleConfig;
+            } else if (name === "gpu_physics") {
+              props.gpuPhysics = trait.config || true;
+            } else if (name === "digital_twin") {
+              props.digitalTwin = trait.config || true;
+            } else if (name === "sensor") {
+              props.sensor = trait.config || true;
+            } else if (name === "data_binding") {
+              props.dataBinding = trait.config || true;
+            } else if (name === "behavior_tree") {
+              props.behaviorTree = trait.config || true;
+            } else if (name === "llm_agent") {
+              props.llmAgent = trait.config || true;
+            } else if (name === "neural_link") {
+              props.neuralLink = trait.config || { model: "brittney-v4.gguf", temperature: 0.7 };
+            } else if (name === "perception") {
+              props.perception = trait.config || { sight_range: 20 };
+            } else if (name === "patrol") {
+              props.patrol = trait.config || true;
+            } else if (name === "co_located") {
+              props.coLocated = trait.config || true;
+            } else if (name === "shared_world") {
+              props.sharedWorld = trait.config || true;
+            } else if (name === "voice_proximity") {
+              props.voiceProximity = trait.config || { max_distance: 20 };
+              props.spatial = true;
+            } else if (name === "spatial_persona") {
+              props.spatialPersona = trait.config || { style: "realistic" };
+            } else if (name === "shareplay") {
+              props.sharePlay = trait.config || { activity_type: "custom" };
+            } else if (name === "object_tracking") {
+              props.objectTracking = trait.config || true;
+            } else if (name === "scene_reconstruction") {
+              props.sceneReconstruction = trait.config || { mode: "mesh" };
+            } else if (name === "eye_tracked") {
+              props.eyeTracked = true;
+            } else if (name === "eye_hand_fusion") {
+              props.eyeHandFusion = true;
+            } else if (name === "controlnet") {
+              props.controlNet = trait.config || { model: "canny" };
+            } else if (name === "ai_texture_gen") {
+              props.aiTextureGen = trait.config || { style: "photorealistic" };
+            } else if (name === "diffusion_realtime") {
+              props.diffusionRealtime = trait.config || { backend: "cuda" };
+            } else if (name === "ai_upscaling") {
+              props.aiUpscaling = trait.config || { factor: 2 };
+            } else if (name === "ai_inpainting") {
+              props.aiInpainting = trait.config || true;
+            } else if (name === "neural_forge") {
+              props.neuralForge = trait.config || true;
+            } else if (name === "embedding_search") {
+              props.embeddingSearch = trait.config || { dimensions: 1536 };
+            } else if (name === "ai_npc_brain") {
+              props.aiNpcBrain = trait.config || { model: "llm" };
+            } else if (name === "vector_db") {
+              props.vectorDb = trait.config || true;
+            } else if (name === "vision" || name === "ai_vision") {
+              props.vision = trait.config || { task: "detection" };
+            } else if (name === "spatial_awareness") {
+              props.spatialAwareness = trait.config || true;
+            } else if (name === "neural_animation") {
+              props.neuralAnimation = trait.config || { style: "motion_matching" };
+            } else if (name === "draft") {
+              props.draftMode = true;
+              props.draftShape = trait.config?.shape || "box";
+              props.draftColor = trait.config?.color || "#88aaff";
+              props.draftOpacity = trait.config?.opacity ?? 1;
+              props.draftWireframe = trait.config?.wireframe || false;
+              if (trait.config?.collision !== false) {
+                if (!props.rigidBody) props.rigidBody = { type: "fixed" };
+                if (!props.collider) props.collider = { type: "auto" };
+              }
+            } else if (name === "botanical_lotus") {
+              this.emitCompiledLotusMaterial(props, trait.config || {});
+            } else {
+              props[name] = trait.config || true;
+              if (!props.__unrecognizedTraits) {
+                props.__unrecognizedTraits = [];
+              }
+              props.__unrecognizedTraits.push(name);
+            }
+          }
+        }
+        if (obj.traits && Array.isArray(obj.traits)) {
+          const traitNames = obj.traits.map(
+            (t) => t.name
+          );
+          const compositor = new 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;
+          }
+        }
+        delete props.maturityOverride;
+        if (obj.children && Array.isArray(obj.children)) {
+          for (const child of obj.children) {
+            r3fNode.children.push(this.compileObjectDecl(child));
+          }
+        }
+        if (props.__gapsComponents && Array.isArray(props.__gapsComponents)) {
+          for (const componentType of props.__gapsComponents) {
+            const componentProps = {};
+            if (componentType === "CloudRenderer" && props.volumetricClouds) {
+              const vc = props.volumetricClouds;
+              componentProps.coverage = vc.coverage ?? 0.5;
+              componentProps.altitude = vc.altitude ?? 500;
+              componentProps.windOffset = vc.wind ?? [0, 0, 0];
+              componentProps.layers = vc.layers ?? 3;
+            } else if (componentType === "GodRaysEffect" && props.godRays) {
+              const gr = props.godRays;
+              componentProps.intensity = gr.intensity ?? 1;
+              componentProps.decay = gr.decay ?? 0.96;
+              componentProps.lightColor = gr.color ?? "#fffde7";
+            } else if (componentType === "FluidRenderer" && props.fluid) {
+              const fl = props.fluid;
+              componentProps.color = fl.color ?? "#1a6fc4";
+              componentProps.particleSize = fl.particle_radius ?? 0.02;
+              componentProps.renderMode = fl.render_mode ?? "points";
+            }
+            r3fNode.children.push(
+              this.createNode(componentType, componentProps, `${obj.name}-${componentType}`)
+            );
+          }
+          delete props.__gapsComponents;
+        }
+        return r3fNode;
+      }
+      /**
+       * Compile a SystemNode into an R3FNode.
+       *
+       * Systems are logical containers with state, actions, lifecycle hooks,
+       * and optionally child objects/UI. In the R3F tree, a system compiles
+       * to a group node annotated with its rich metadata (state, actions,
+       * hooks) so the runtime/renderer can wire up behavior.
+       */
+      compileSystemNode(node, templateMap) {
+        const props = {};
+        if (node.state) {
+          props.systemState = node.state;
+        }
+        if (node.actions) {
+          props.systemActions = node.actions;
+        }
+        if (node.hooks) {
+          props.systemHooks = node.hooks;
+        }
+        if (node.properties && typeof node.properties === "object") {
+          for (const [key, value] of Object.entries(node.properties)) {
+            props[key] = value;
+          }
+        }
+        const r3fNode = this.createNode("System", props, node.id || node.name);
+        if (node.directives) {
+          r3fNode.directives = node.directives;
+        }
+        if (node.directives) {
+          for (const d of node.directives) {
+            if (d.type === "trait") {
+              r3fNode.traits?.set(d.name, d.config || {});
+            }
+          }
+        }
+        if (node.children && Array.isArray(node.children)) {
+          for (const child of node.children) {
+            r3fNode.children.push(this.compileChildNode(child, templateMap));
+          }
+        }
+        if (node.ui && Array.isArray(node.ui)) {
+          for (const uiNode of node.ui) {
+            r3fNode.children.push(this.compileNode(uiNode));
+          }
+        }
+        return r3fNode;
+      }
+      /**
+       * Compile a ComponentNode into an R3FNode.
+       *
+       * Components are UI-focused containers with props, state, actions,
+       * and render/UI blocks. They compile to a group node annotated with
+       * component metadata for the runtime.
+       */
+      compileComponentNode(node, templateMap) {
+        const props = {};
+        if (node.props) {
+          props.componentProps = node.props;
+        }
+        if (node.state) {
+          props.componentState = node.state;
+        }
+        if (node.actions) {
+          props.componentActions = node.actions;
+        }
+        if (node.hooks) {
+          props.componentHooks = node.hooks;
+        }
+        if (node.properties && typeof node.properties === "object") {
+          for (const [key, value] of Object.entries(node.properties)) {
+            props[key] = value;
+          }
+        }
+        const r3fNode = this.createNode(
+          "Component",
+          props,
+          node.id || node.name
+        );
+        if (node.directives) {
+          r3fNode.directives = node.directives;
+        }
+        if (node.directives) {
+          for (const d of node.directives) {
+            if (d.type === "trait") {
+              r3fNode.traits?.set(d.name, d.config || {});
+            }
+          }
+        }
+        if (node.children && Array.isArray(node.children)) {
+          for (const child of node.children) {
+            r3fNode.children.push(this.compileChildNode(child, templateMap));
+          }
+        }
+        if (node.ui && Array.isArray(node.ui)) {
+          for (const uiNode of node.ui) {
+            r3fNode.children.push(this.compileNode(uiNode));
+          }
+        }
+        return r3fNode;
+      }
+      /**
+       * Dispatch a child node to the appropriate compile method based on its type.
+       * Used by compileSystemNode, compileComponentNode, and compileComposition
+       * when processing the parser's children array.
+       */
+      compileChildNode(child, templateMap) {
+        switch (child.type) {
+          case "system":
+            return this.compileSystemNode(child, templateMap);
+          case "component":
+            return this.compileComponentNode(child, templateMap);
+          case "object":
+            return this.compileObjectDecl(child, templateMap);
+          case "template":
+            if (templateMap && typeof child.name === "string") {
+              templateMap.set(child.name, child);
+            }
+            return this.compileTemplateNode(child, templateMap);
+          case "spatial_group":
+            return this.compileSpatialGroup(child, templateMap);
+          default:
+            return this.compileNode(child);
+        }
+      }
+      /**
+       * Compile a template node. Templates define reusable types.
+       * In the R3F tree, they compile to an empty group (they're not
+       * rendered directly — objects "using" them inherit their properties).
+       */
+      compileTemplateNode(node, _templateMap) {
+        const props = {};
+        if (node.state || node.properties?.state) {
+          props.templateState = node.state || node.properties?.state;
+        }
+        if (node.properties) {
+          for (const [key, value] of Object.entries(node.properties)) {
+            if (key !== "state") {
+              props[key] = value;
+            }
+          }
+        }
+        return this.createNode("Template", props, node.name);
+      }
+      compileSpatialGroup(group, templateMap) {
+        const props = {};
+        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) {
+          const bloom = node.props.bloom;
+          const bloomProps = typeof bloom === "object" && bloom !== null ? bloom : { intensity: 1 };
+          effects.push(this.createNode("Bloom", bloomProps));
+        }
+        node.children?.forEach((child) => effects.push(...this.extractPostProcessingNodes(child)));
+        return effects;
+      }
+      mapType(type, props) {
+        if (type === "environment") {
+          if (props.name && typeof props.name === "string" && ENVIRONMENT_PRESETS[props.name]) {
+            Object.assign(props, ENVIRONMENT_PRESETS[props.name]);
+          }
+          return "Environment";
+        }
+        if (type === "light") {
+          const lightType = props.type || "directional";
+          const lightMapping = {
+            directional: "directionalLight",
+            point: "pointLight",
+            spot: "spotLight",
+            hemisphere: "hemisphereLight",
+            ambient: "ambientLight",
+            area: "rectAreaLight"
+          };
+          return lightMapping[lightType] || "directionalLight";
+        }
+        if (type === "portal") return "Portal";
+        if (type === "sparkles") return "Sparkles";
+        if (MESH_TYPES.has(type)) {
+          props.hsType = type;
+          return "mesh";
+        }
+        const mapping = {
+          ambient_light: "ambientLight",
+          model: "gltfModel",
+          audio: "positionalAudio",
+          composition: "group",
+          scale: "group",
+          focus: "group",
+          spatial_agent: "SpatialAgent",
+          spatial_container: "group",
+          ui_panel: "UIPanel",
+          ui_text: "UIText",
+          ui_button: "UIButton",
+          ui_slider: "UISlider",
+          ui_input: "UIInput",
+          ui_image: "UIImage",
+          ui_chart: "UIChart",
+          ui_gauge: "UIGauge",
+          ui_value: "UIValue",
+          ui_status_indicator: "UIStatusIndicator",
+          tool_slot: "ToolSlot",
+          behavior: "group",
+          system: "System",
+          component: "Component",
+          dna: "DNA",
+          gaussian_splat: "GaussianSplat",
+          splat: "GaussianSplat",
+          nerf: "NeRF",
+          volumetric_video: "VolumetricVideo",
+          world: "group"
+        };
+        return mapping[type] || type;
+      }
+      compileProperties(node, rawProps) {
+        const expandedProps = this.expandSpreads(rawProps);
+        const props = { ...expandedProps };
+        if (node.position) {
+          props.position = node.position;
+        }
+        if (rawProps.position && Array.isArray(rawProps.position)) {
+          props.position = rawProps.position;
+        }
+        if (node.hologram) {
+          const h = node.hologram;
+          if (h.color) props.color = h.color;
+          if (MESH_TYPES.has(node.type)) {
+            props.args = this.getGeometryArgs(node.type, h);
+            props.hsType = node.type;
+          }
+        }
+        if (rawProps.scale !== void 0 && !props.scale) {
+          props.scale = Array.isArray(rawProps.scale) ? rawProps.scale : [rawProps.scale, rawProps.scale, rawProps.scale];
+        }
+        if (rawProps.geometry && !props.hsType) {
+          props.hsType = rawProps.geometry;
+          props.args = this.getGeometryArgs(rawProps.geometry, { size: rawProps.size || 1 });
+        }
+        if (rawProps.material && typeof rawProps.material === "string" && MATERIAL_PRESETS[rawProps.material]) {
+          props.materialProps = {
+            ...MATERIAL_PRESETS[rawProps.material],
+            ...props.materialProps
+          };
+        }
+        if (node.directives) {
+          for (const d of node.directives) {
+            if (d.type === "trait") {
+              if (d.name === "grabbable") {
+                props.castShadow = true;
+                props.grabbable = d.config || true;
+                if (!props.rigidBody) props.rigidBody = { type: "dynamic" };
+                if (!props.collider) props.collider = { type: "auto" };
+              } else if (d.name === "animated") {
+                props.animated = d.config || true;
+              } else if (d.name === "spatial_audio" || d.name === "voice") {
+                props.spatial = true;
+              } else if (d.name === "gem_resonance") {
+                props.gemResonance = gemResonanceConfig(d.config);
+                props.spatial = true;
+              } else if (d.name === "networked") {
+                props.networked = d.config || true;
+              } else if (d.name === "moldable") {
+                props.moldable = d.config || true;
+              } else if (d.name === "stretchable") {
+                props.stretchable = d.config || true;
+              } else if (d.name === "ai_driven") {
+                props.ai_driven = d.config || true;
+              } else if (d.name === "dialogue") {
+                props.dialogue = d.config || true;
+              } else if (d.name === "gesture") {
+                props.gesture = d.config || true;
+              } else if (d.name === "haptic") {
+                props.haptic = d.config || true;
+              } else if (d.name === "avatar_embodiment") {
+                props.avatarEmbodiment = d.config || true;
+              } else if (d.name === "lip_sync") {
+                props.lipSync = d.config || true;
+              } else if (d.name === "emotion_directive") {
+                props.emotionDirective = d.config || true;
+              } else if (d.name === "stt") {
+                props.stt = d.config || true;
+              } else if (d.name === "tts") {
+                props.tts = d.config || true;
+              } else if (d.name === "generate") {
+                props.generate = d.config;
+              } else if (d.name === "skeleton") {
+                props.skeleton = d.config || true;
+              } else if (d.name === "body") {
+                props.body = d.config || true;
+              } else if (d.name === "gaussian_splat") {
+                props.gaussianSplat = d.config || true;
+              } else if (d.name === "nerf") {
+                props.nerf = d.config || true;
+              } else if (d.name === "volumetric_video") {
+                props.volumetricVideo = d.config || true;
+              } else if (d.name === "web_surface") {
+                props.webSurface = d.config || true;
+              }
+            }
+          }
+        }
+        delete props.type;
+        delete props.geometry;
+        return props;
+      }
+      applyGraphicsConfig(r3fNode, graphics) {
+        if (graphics.material) {
+          const m = graphics.material;
+          const materialProps = {};
+          if (m.preset && MATERIAL_PRESETS[m.preset]) {
+            Object.assign(materialProps, MATERIAL_PRESETS[m.preset]);
+          }
+          if (m.type === "pbr" && m.pbr) {
+            if (m.pbr.baseColor) materialProps["color"] = this.mapColor(m.pbr.baseColor);
+            if (m.pbr.metallic !== void 0) materialProps["metalness"] = m.pbr.metallic;
+            if (m.pbr.roughness !== void 0) materialProps["roughness"] = m.pbr.roughness;
+            if (m.pbr.emission) materialProps["emissive"] = this.mapColor(m.pbr.emission);
+            if (m.pbr.emissionStrength) materialProps["emissiveIntensity"] = m.pbr.emissionStrength;
+            if (m.pbr.clearcoat !== void 0) materialProps["clearcoat"] = m.pbr.clearcoat;
+            if (m.pbr.transmission !== void 0) materialProps["transmission"] = m.pbr.transmission;
+            if (m.pbr.ior !== void 0) materialProps["ior"] = m.pbr.ior;
+            if (m.pbr.iridescence !== void 0) materialProps["iridescence"] = m.pbr.iridescence;
+          }
+          const prior = r3fNode.props.materialProps ?? {};
+          r3fNode.props.materialProps = { ...prior, ...materialProps };
+        }
+        if (graphics.lighting) {
+          const l = graphics.lighting;
+          if (r3fNode.type.toLowerCase().includes("light")) {
+            if (l.shadows) r3fNode.props.castShadow = true;
+            if (l.intensity !== void 0) r3fNode.props.intensity = l.intensity;
+            if (l.color) r3fNode.props.color = this.mapColor(l.color);
+          }
+          if (r3fNode.type === "Environment" && l.preset) {
+            r3fNode.props.preset = l.preset;
+          }
+        }
+        if (graphics.networked) {
+          r3fNode.props.networked = graphics.networked;
+        }
+      }
+      mapColor(c) {
+        if (typeof c === "string") return c;
+        if (typeof c === "number") return `#${c.toString(16).padStart(6, "0")}`;
+        if (c.r !== void 0) {
+          const r = c.r > 1 ? c.r : Math.floor(c.r * 255);
+          const g = c.g > 1 ? c.g : Math.floor(c.g * 255);
+          const b = c.b > 1 ? c.b : Math.floor(c.b * 255);
+          return `rgb(${r}, ${g}, ${b})`;
+        }
+        return "#ffffff";
+      }
+      getGeometryArgs(type, hologram) {
+        const size = hologram.size || 1;
+        switch (type) {
+          case "sphere":
+          case "orb":
+            return [size * 0.5, 32, 32];
+          case "cube":
+          case "box":
+            return [size, size, size];
+          case "cylinder":
+            return [size * 0.5, size * 0.5, size, 32];
+          case "pyramid":
+          case "cone":
+            return [size * 0.5, 0, size, 4];
+          case "plane":
+            return [size, size];
+          case "torus":
+            return [size * 0.5, size * 0.15, 16, 32];
+          case "ring":
+            return [size * 0.3, size * 0.5, 32];
+          case "capsule":
+            return [size * 0.3, size * 0.5, 4, 16];
+          default:
+            return [size, size, size];
+        }
+      }
+    };
+  }
+});
+
+export { ASTNodePool, ENVIRONMENT_PRESETS, MATERIAL_PRESETS, QUALITY_TIER_SCALES, R3FCompiler, R3FCompiler_exports, UI_COMPONENT_PRESETS, init_ObjectPool, init_R3FCompiler, init_visual, registerAllPresets };
+//# sourceMappingURL=chunk-BGY3SDG3.js.map
+//# sourceMappingURL=chunk-BGY3SDG3.js.map