@holoscript/core 6.0.3 → 6.1.1

package/dist/{chunk-VZNKJZTT.cjs → chunk-52ULD552.cjs}

@@ -1,30 +1,36 @@
 'use strict';
 
-var chunkHHS6FMOU_cjs = require('./chunk-HHS6FMOU.cjs');
-var chunkQHVVVN47_cjs = require('./chunk-QHVVVN47.cjs');
-var chunkEGIZHYJP_cjs = require('./chunk-EGIZHYJP.cjs');
+var chunkHGVXZDSK_cjs = require('./chunk-HGVXZDSK.cjs');
+var chunkRMHC2VG7_cjs = require('./chunk-RMHC2VG7.cjs');
+var chunkE7JP3BS3_cjs = require('./chunk-E7JP3BS3.cjs');
+var chunkHCCQLAA4_cjs = require('./chunk-HCCQLAA4.cjs');
+var ans = require('@holoscript/core-types/ans');
 
 // src/compiler/VRRCompiler.ts
 var VRRCompiler_exports = {};
-chunkEGIZHYJP_cjs.__export(VRRCompiler_exports, {
+chunkHCCQLAA4_cjs.__export(VRRCompiler_exports, {
   VRRCompiler: () => exports.VRRCompiler,
   default: () => exports.VRRCompiler_default
 });
 var VRRTraitDefs; exports.VRRCompiler = void 0; exports.VRRCompiler_default = void 0;
-var init_VRRCompiler = chunkEGIZHYJP_cjs.__esm({
+var init_VRRCompiler = chunkHCCQLAA4_cjs.__esm({
   "src/compiler/VRRCompiler.ts"() {
-    chunkQHVVVN47_cjs.init_CompilerBase();
-    chunkQHVVVN47_cjs.init_ANSNamespace();
-    chunkHHS6FMOU_cjs.init_DomainBlockCompilerMixin();
+    chunkRMHC2VG7_cjs.init_CompilerBase();
+    chunkE7JP3BS3_cjs.init_safeJsonParse();
+    chunkHGVXZDSK_cjs.init_DomainBlockCompilerMixin();
     VRRTraitDefs = {
       vrr_twin: { validator: (p) => !!p.mirror },
       reality_mirror: { validator: (p) => Array.isArray(p.sync) && p.sync.length > 0 },
       geo_anchor: {
         validator: (p) => typeof p.lat === "number" && typeof p.lng === "number" && p.lat >= -90 && p.lat <= 90 && p.lng >= -180 && p.lng <= 180
       },
-      weather_sync: { validator: (p) => ["weather.gov", "openweathermap"].includes(String(p.provider)) },
+      weather_sync: {
+        validator: (p) => ["weather.gov", "openweathermap"].includes(String(p.provider))
+      },
       event_sync: { validator: (p) => ["eventbrite", "ticketmaster"].includes(String(p.provider)) },
-      inventory_sync: { validator: (p) => ["square_pos", "shopify", "woocommerce"].includes(String(p.provider)) },
+      inventory_sync: {
+        validator: (p) => ["square_pos", "shopify", "woocommerce"].includes(String(p.provider))
+      },
       quest_hub: { validator: (p) => Array.isArray(p.quests) && p.quests.length > 0 },
       layer_shift: {
         validator: (p) => {
@@ -37,7 +43,7 @@ var init_VRRCompiler = chunkEGIZHYJP_cjs.__esm({
       },
       geo_sync: { validator: (p) => !!p.center && Number(p.radius || 0) >= 0 }
     };
-    exports.VRRCompiler = class extends chunkQHVVVN47_cjs.CompilerBase {
+    exports.VRRCompiler = class extends chunkRMHC2VG7_cjs.CompilerBase {
       constructor(options) {
         super();
         this.compilerName = "VRRCompiler";
@@ -47,7 +53,7 @@ var init_VRRCompiler = chunkEGIZHYJP_cjs.__esm({
         this.options = options;
       }
       getRequiredCapability() {
-        return chunkQHVVVN47_cjs.ANSCapabilityPath.VRR;
+        return ans.ANSCapabilityPath.VRR;
       }
       // ─── 1. parseVRRComposition ───────────────────────────────────────────
       /**
@@ -84,9 +90,7 @@ var init_VRRCompiler = chunkEGIZHYJP_cjs.__esm({
               if (field) {
                 const traitDef = VRRTraitDefs[trait.name];
                 if (traitDef?.validator && !traitDef.validator(trait.params)) {
-                  this.warnings.push(
-                    `@${trait.name} on "${n.name || "unnamed"}" has invalid params`
-                  );
+                  this.warnings.push(`@${trait.name} on "${n.name || "unnamed"}" has invalid params`);
                 }
                 data[field].push(n);
               }
@@ -113,27 +117,21 @@ var init_VRRCompiler = chunkEGIZHYJP_cjs.__esm({
        * Generate a complete Three.js scene from VRR composition data.
        * Places objects using geo_anchor coordinates, sets up materials/lighting/camera.
        */
-      compileToThreeJS(compositionData) {
+      compileToThreeJS(compositionData, twinGroupName) {
         this.generatedCode.push(`
 // === Three.js Scene Generation ===`);
         this.generatedCode.push(`const ambientLight = new THREE.AmbientLight(0x404040, 0.6);`);
         this.generatedCode.push(`scene.add(ambientLight);`);
-        this.generatedCode.push(
-          `const directionalLight = new THREE.DirectionalLight(0xffffff, 0.8);`
-        );
+        this.generatedCode.push(`const directionalLight = new THREE.DirectionalLight(0xffffff, 0.8);`);
         this.generatedCode.push(`directionalLight.position.set(50, 200, 100);`);
         this.generatedCode.push(`directionalLight.castShadow = true;`);
         this.generatedCode.push(`scene.add(directionalLight);`);
-        this.generatedCode.push(
-          `const groundGeo = new THREE.PlaneGeometry(10000, 10000);`
-        );
+        this.generatedCode.push(`const groundGeo = new THREE.PlaneGeometry(10000, 10000);`);
         this.generatedCode.push(
           `const groundMat = new THREE.MeshStandardMaterial({ color: 0x3a7d3a, roughness: 0.9 });`
         );
-        this.generatedCode.push(
-          `const ground = new THREE.Mesh(groundGeo, groundMat);`
-        );
-        this.generatedCode.push(`ground.rotation.x = -Math.PI / 2;`);
+        this.generatedCode.push(`const ground = new THREE.Mesh(groundGeo, groundMat);`);
+        this.generatedCode.push(`ground.rotation[0] = -Math.PI / 2;`);
         this.generatedCode.push(`ground.receiveShadow = true;`);
         this.generatedCode.push(`scene.add(ground);`);
         this.generatedCode.push(`camera.position.set(0, 50, 100);`);
@@ -146,28 +144,20 @@ var init_VRRCompiler = chunkEGIZHYJP_cjs.__esm({
           const safeName = this.escapeStringValue(String(node.name || "geo_object"), "TypeScript");
           this.generatedCode.push(`
 // Geo-anchored: ${safeName} (${lat}, ${lng})`);
-          this.generatedCode.push(
-            `const marker_${safeName} = new THREE.Group();`
-          );
+          this.generatedCode.push(`const marker_${safeName} = new THREE.Group();`);
           this.generatedCode.push(
             `marker_${safeName}.position.copy(vrr.geoToSceneCoords(${lat}, ${lng}));`
           );
-          this.generatedCode.push(
-            `marker_${safeName}.userData.geo = { lat: ${lat}, lng: ${lng} };`
-          );
-          this.generatedCode.push(`phoenix_downtown.add(marker_${safeName});`);
+          this.generatedCode.push(`marker_${safeName}.userData.geo = { lat: ${lat}, lng: ${lng} };`);
+          this.generatedCode.push(`${twinGroupName}.add(marker_${safeName});`);
         }
         this.generatedCode.push(`
 // Skybox`);
-        this.generatedCode.push(
-          `scene.background = new THREE.Color(0x87ceeb);`
-        );
+        this.generatedCode.push(`scene.background = new THREE.Color(0x87ceeb);`);
         this.generatedCode.push(`
 // Render loop`);
         this.generatedCode.push(`renderer.shadowMap.enabled = true;`);
-        this.generatedCode.push(
-          `renderer.shadowMap.type = THREE.PCFSoftShadowMap;`
-        );
+        this.generatedCode.push(`renderer.shadowMap.type = THREE.PCFSoftShadowMap;`);
         this.generatedCode.push(`function animate() {`);
         this.generatedCode.push(`  requestAnimationFrame(animate);`);
         this.generatedCode.push(`  vrr.tick();`);
@@ -197,19 +187,11 @@ var init_VRRCompiler = chunkEGIZHYJP_cjs.__esm({
           this.generatedCode.push(`  location: vrr.getGeoCenter(),`);
           this.generatedCode.push(`});`);
           this.generatedCode.push(`const rainGeometry = new THREE.BufferGeometry();`);
-          this.generatedCode.push(
-            `const rainPositions = new Float32Array(3000 * 3);`
-          );
+          this.generatedCode.push(`const rainPositions = new Float32Array(3000 * 3);`);
           this.generatedCode.push(`for (let i = 0; i < 3000; i++) {`);
-          this.generatedCode.push(
-            `  rainPositions[i * 3] = (Math.random() - 0.5) * 500;`
-          );
-          this.generatedCode.push(
-            `  rainPositions[i * 3 + 1] = Math.random() * 200;`
-          );
-          this.generatedCode.push(
-            `  rainPositions[i * 3 + 2] = (Math.random() - 0.5) * 500;`
-          );
+          this.generatedCode.push(`  rainPositions[i * 3] = (Math.random() - 0.5) * 500;`);
+          this.generatedCode.push(`  rainPositions[i * 3 + 1] = Math.random() * 200;`);
+          this.generatedCode.push(`  rainPositions[i * 3 + 2] = (Math.random() - 0.5) * 500;`);
           this.generatedCode.push(`}`);
           this.generatedCode.push(
             `rainGeometry.setAttribute('position', new THREE.BufferAttribute(rainPositions, 3));`
@@ -217,40 +199,28 @@ var init_VRRCompiler = chunkEGIZHYJP_cjs.__esm({
           this.generatedCode.push(
             `const rainMaterial = new THREE.PointsMaterial({ color: 0xaaaaaa, size: 0.1, transparent: true });`
           );
-          this.generatedCode.push(
-            `const rainSystem = new THREE.Points(rainGeometry, rainMaterial);`
-          );
+          this.generatedCode.push(`const rainSystem = new THREE.Points(rainGeometry, rainMaterial);`);
           this.generatedCode.push(`rainSystem.visible = false;`);
           this.generatedCode.push(`scene.add(rainSystem);`);
           this.generatedCode.push(`weatherSync_${safeName}.onUpdate((weather) => {`);
-          this.generatedCode.push(
-            `  // Update fog based on visibility`
-          );
+          this.generatedCode.push(`  // Update fog based on visibility`);
           this.generatedCode.push(
             `  scene.fog = new THREE.Fog(0xcccccc, 10, Math.max(weather.visibility, 50));`
           );
           this.generatedCode.push(`  // Toggle rain particles`);
-          this.generatedCode.push(
-            `  rainSystem.visible = weather.precipitation > 0;`
-          );
+          this.generatedCode.push(`  rainSystem.visible = weather.precipitation > 0;`);
           this.generatedCode.push(`  // Adjust sun intensity based on cloud cover`);
           this.generatedCode.push(
             `  directionalLight.intensity = Math.max(0.2, 1.0 - (weather.cloud_cover || 0) / 100);`
           );
           this.generatedCode.push(`  // Update skybox color`);
-          this.generatedCode.push(
-            `  const skyHue = weather.precipitation > 50 ? 0x666680 : 0x87ceeb;`
-          );
-          this.generatedCode.push(
-            `  scene.background = new THREE.Color(skyHue);`
-          );
+          this.generatedCode.push(`  const skyHue = weather.precipitation > 50 ? 0x666680 : 0x87ceeb;`);
+          this.generatedCode.push(`  scene.background = new THREE.Color(skyHue);`);
           this.generatedCode.push(`  // Temperature-based ambient tint`);
           this.generatedCode.push(
             `  const tempNorm = Math.max(0, Math.min(1, (weather.temperature_f || 70) / 120));`
           );
-          this.generatedCode.push(
-            `  ambientLight.color.setHSL(0.6 - tempNorm * 0.4, 0.3, 0.4);`
-          );
+          this.generatedCode.push(`  ambientLight.color.setHSL(0.6 - tempNorm * 0.4, 0.3, 0.4);`);
           this.generatedCode.push(`});`);
         }
       }
@@ -280,7 +250,9 @@ var init_VRRCompiler = chunkEGIZHYJP_cjs.__esm({
           this.generatedCode.push(`eventSync_${safeName}.onUpdate((events) => {`);
           this.generatedCode.push(`  // Clear previous markers`);
           this.generatedCode.push(`  while (eventMarkers_${safeName}.children.length > 0) {`);
-          this.generatedCode.push(`    eventMarkers_${safeName}.remove(eventMarkers_${safeName}.children[0]);`);
+          this.generatedCode.push(
+            `    eventMarkers_${safeName}.remove(eventMarkers_${safeName}.children[0]);`
+          );
           this.generatedCode.push(`  }`);
           this.generatedCode.push(`  for (const evt of events) {`);
           this.generatedCode.push(`    // Create event marker billboard`);
@@ -290,13 +262,19 @@ var init_VRRCompiler = chunkEGIZHYJP_cjs.__esm({
           );
           this.generatedCode.push(`    const marker = new THREE.Mesh(markerGeo, markerMat);`);
           this.generatedCode.push(`    if (evt.geo) {`);
-          this.generatedCode.push(`      marker.position.copy(vrr.geoToSceneCoords(evt.geo.lat, evt.geo.lng));`);
+          this.generatedCode.push(
+            `      marker.position.copy(vrr.geoToSceneCoords(evt.geo.lat, evt.geo.lng));`
+          );
           this.generatedCode.push(`    }`);
-          this.generatedCode.push(`    marker.userData.event = { name: evt.name, date: evt.date, url: evt.url };`);
+          this.generatedCode.push(
+            `    marker.userData.event = { name: evt.name, date: evt.date, url: evt.url };`
+          );
           this.generatedCode.push(`    eventMarkers_${safeName}.add(marker);`);
           this.generatedCode.push(`    // Spawn NPC crowds for active events`);
           this.generatedCode.push(`    if (evt.status === 'active') {`);
-          this.generatedCode.push(`      vrr.spawnNPCCrowd(marker.position, evt.expected_attendance || 20);`);
+          this.generatedCode.push(
+            `      vrr.spawnNPCCrowd(marker.position, evt.expected_attendance || 20);`
+          );
           this.generatedCode.push(`    }`);
           this.generatedCode.push(`  }`);
           this.generatedCode.push(`});`);
@@ -307,7 +285,7 @@ var init_VRRCompiler = chunkEGIZHYJP_cjs.__esm({
        * Generate code for real-time inventory display:
        * product counts, availability badges, stock-level indicators.
        */
-      generateInventorySync(nodes) {
+      generateInventorySync(nodes, twinGroupName) {
         if (nodes.length === 0) return;
         this.generatedCode.push(`
 // === @inventory_sync \u2014 Real-Time Inventory Display ===`);
@@ -326,19 +304,29 @@ var init_VRRCompiler = chunkEGIZHYJP_cjs.__esm({
           this.generatedCode.push(`  business_id: '${safeName}',`);
           this.generatedCode.push(`});`);
           this.generatedCode.push(`const inventoryUI_${safeName} = new THREE.Group();`);
-          this.generatedCode.push(`phoenix_downtown.add(inventoryUI_${safeName});`);
+          this.generatedCode.push(`${twinGroupName}.add(inventoryUI_${safeName});`);
           this.generatedCode.push(`inventorySync_${safeName}.onUpdate((inventory) => {`);
           this.generatedCode.push(`  // Clear previous inventory display`);
           this.generatedCode.push(`  while (inventoryUI_${safeName}.children.length > 0) {`);
-          this.generatedCode.push(`    inventoryUI_${safeName}.remove(inventoryUI_${safeName}.children[0]);`);
+          this.generatedCode.push(
+            `    inventoryUI_${safeName}.remove(inventoryUI_${safeName}.children[0]);`
+          );
           this.generatedCode.push(`  }`);
           this.generatedCode.push(`  for (const item of inventory.items) {`);
-          this.generatedCode.push(`    // Availability badge color: green=in-stock, yellow=low, red=out`);
-          this.generatedCode.push(`    const badgeColor = item.quantity > 10 ? 0x00ff00 : item.quantity > 0 ? 0xffaa00 : 0xff0000;`);
+          this.generatedCode.push(
+            `    // Availability badge color: green=in-stock, yellow=low, red=out`
+          );
+          this.generatedCode.push(
+            `    const badgeColor = item.quantity > 10 ? 0x00ff00 : item.quantity > 0 ? 0xffaa00 : 0xff0000;`
+          );
           this.generatedCode.push(`    const badgeGeo = new THREE.SphereGeometry(0.3, 8, 8);`);
-          this.generatedCode.push(`    const badgeMat = new THREE.MeshStandardMaterial({ color: badgeColor, emissive: badgeColor, emissiveIntensity: 0.5 });`);
+          this.generatedCode.push(
+            `    const badgeMat = new THREE.MeshStandardMaterial({ color: badgeColor, emissive: badgeColor, emissiveIntensity: 0.5 });`
+          );
           this.generatedCode.push(`    const badge = new THREE.Mesh(badgeGeo, badgeMat);`);
-          this.generatedCode.push(`    badge.userData.product = { name: item.name, quantity: item.quantity, price: item.price };`);
+          this.generatedCode.push(
+            `    badge.userData.product = { name: item.name, quantity: item.quantity, price: item.price };`
+          );
           this.generatedCode.push(`    inventoryUI_${safeName}.add(badge);`);
           this.generatedCode.push(`  }`);
           this.generatedCode.push(`});`);
@@ -367,9 +355,7 @@ var init_VRRCompiler = chunkEGIZHYJP_cjs.__esm({
           this.generatedCode.push(
             `const questBeacon_${safeName} = new THREE.PointLight(0xffdd00, 2, 30);`
           );
-          this.generatedCode.push(
-            `questBeacon_${safeName}.position.set(0, 5, 0);`
-          );
+          this.generatedCode.push(`questBeacon_${safeName}.position.set(0, 5, 0);`);
           this.generatedCode.push(
             `if (marker_${safeName}) marker_${safeName}.add(questBeacon_${safeName});`
           );
@@ -396,9 +382,7 @@ var init_VRRCompiler = chunkEGIZHYJP_cjs.__esm({
           this.generatedCode.push(`  // Grant reward (coupon, NFT, etc.)`);
           this.generatedCode.push(`  vrr.grantReward(quest.id, reward);`);
           this.generatedCode.push(`  // Visual celebration`);
-          this.generatedCode.push(
-            `  questBeacon_${safeName}.color.setHex(0x00ff00);`
-          );
+          this.generatedCode.push(`  questBeacon_${safeName}.color.setHex(0x00ff00);`);
           this.generatedCode.push(`});`);
         }
       }
@@ -508,9 +492,7 @@ var init_VRRCompiler = chunkEGIZHYJP_cjs.__esm({
           this.generatedCode.push(`        'X-Payment-Amount': '${price}',`);
           this.generatedCode.push(`        'X-Payment-Asset': '${asset}',`);
           this.generatedCode.push(`        'X-Payment-Network': '${network}',`);
-          this.generatedCode.push(
-            `        'X-Payment-Address': vrr.getPaymentAddress('${safeName}'),`
-          );
+          this.generatedCode.push(`        'X-Payment-Address': vrr.getPaymentAddress('${safeName}'),`);
           this.generatedCode.push(`      },`);
           this.generatedCode.push(`    };`);
           this.generatedCode.push(`  },`);
@@ -524,8 +506,12 @@ var init_VRRCompiler = chunkEGIZHYJP_cjs.__esm({
           this.generatedCode.push(`    vrr.unlockContent('${safeName}');`);
           this.generatedCode.push(`  },`);
           this.generatedCode.push(`  onPaymentFailed: (error) => {`);
-          this.generatedCode.push(`    console.warn('Payment failed for ${safeName}:', error.message);`);
-          this.generatedCode.push(`    vrr.showPaywallUI('${safeName}', { price: ${price}, asset: '${asset}', network: '${network}' });`);
+          this.generatedCode.push(
+            `    console.warn('Payment failed for ${safeName}:', error.message);`
+          );
+          this.generatedCode.push(
+            `    vrr.showPaywallUI('${safeName}', { price: ${price}, asset: '${asset}', network: '${network}' });`
+          );
           this.generatedCode.push(`  },`);
           this.generatedCode.push(`});`);
         }
@@ -536,58 +522,125 @@ var init_VRRCompiler = chunkEGIZHYJP_cjs.__esm({
         return node.traits.find((t) => t.name === traitName);
       }
       // ─── Main compile() ──────────────────────────────────────────────────
+      normalizeToCompositionTree(input) {
+        if (!input || typeof input !== "object") return null;
+        const node = input;
+        const nodeType = String(node.type || "").toLowerCase();
+        if (nodeType === "composition") {
+          return input;
+        }
+        if (nodeType === "world") {
+          return {
+            type: "Composition",
+            name: String(node.name || "WorldRoot"),
+            templates: [],
+            objects: [],
+            spatialGroups: [],
+            lights: [],
+            imports: [],
+            timelines: [],
+            audio: [],
+            zones: [],
+            transitions: [],
+            conditionals: [],
+            iterators: [],
+            npcs: [],
+            quests: [],
+            abilities: [],
+            dialogues: [],
+            stateMachines: [],
+            achievements: [],
+            talentTrees: [],
+            shapes: [],
+            children: [node],
+            worlds: [node]
+          };
+        }
+        return null;
+      }
+      extractGlobalSimulationStateFromWorlds(comp) {
+        const worlds = Array.isArray(comp.worlds) ? comp.worlds : [];
+        if (worlds.length > 0 && worlds[0]) {
+          const w = worlds[0];
+          if (w.simulation_state && typeof w.simulation_state === "object") {
+            return w.simulation_state;
+          }
+          if (w.simulationState && typeof w.simulationState === "object") {
+            return w.simulationState;
+          }
+          if (w.state && typeof w.state === "object") {
+            return w.state;
+          }
+        }
+        const children = Array.isArray(comp.children) ? comp.children : [];
+        const worldChild = children.find((c) => String(c?.type || "").toLowerCase() === "world");
+        if (worldChild) {
+          if (worldChild.simulation_state && typeof worldChild.simulation_state === "object") {
+            return worldChild.simulation_state;
+          }
+          if (worldChild.simulationState && typeof worldChild.simulationState === "object") {
+            return worldChild.simulationState;
+          }
+          if (worldChild.state && typeof worldChild.state === "object") {
+            return worldChild.state;
+          }
+        }
+        return {};
+      }
       compile(composition, agentToken, outputPath) {
         this.validateCompilerAccess(agentToken, outputPath);
         this.errors = [];
         this.warnings = [];
         this.generatedCode = [];
-        if (!composition || composition.type !== "Composition") {
+        const normalizedComposition = this.normalizeToCompositionTree(composition);
+        if (!normalizedComposition) {
           this.errors.push("Invalid composition tree");
           return this.buildResult();
         }
-        const compositionData = this.parseVRRComposition(composition);
+        const compositionData = this.parseVRRComposition(normalizedComposition);
         const twinNodes = compositionData.twinNodes;
         if (twinNodes.length === 0) {
           this.warnings.push(
             "No @vrr_twin traits found. Compiling as standard 3D instead of reality mirror."
           );
         }
+        const comp = normalizedComposition;
+        const globalSimulationState = this.extractGlobalSimulationStateFromWorlds(comp);
         this.generateImports();
         this.generateSceneSetup();
-        this.generateAPIHooks(twinNodes);
-        this.compileToThreeJS(compositionData);
+        const twinGroupName = this.generateAPIHooks(twinNodes, globalSimulationState);
+        this.compileToThreeJS(compositionData, twinGroupName);
         this.generateWeatherSync(compositionData.weatherNodes);
         this.generateEventSync(compositionData.eventNodes);
-        this.generateInventorySync(compositionData.inventoryNodes);
+        this.generateInventorySync(compositionData.inventoryNodes, twinGroupName);
         this.generateQuestLogic(compositionData.questNodes);
         this.generateLayerShift(compositionData.layerShiftNodes);
         this.generateX402Paywall(compositionData.paywallNodes);
-        const comp = composition;
         const domainBlocks = Array.isArray(comp.domainBlocks) ? comp.domainBlocks : [];
         if (domainBlocks.length > 0) {
           this.generatedCode.push("\n// === v4.2 Domain Blocks ===");
-          const compiled = chunkHHS6FMOU_cjs.compileDomainBlocks(
+          const compiled = chunkHGVXZDSK_cjs.compileDomainBlocks(
             // @ts-expect-error During migration
             domainBlocks,
             {
               material: (block) => {
-                const m = chunkHHS6FMOU_cjs.compileMaterialBlock(block);
+                const m = chunkHGVXZDSK_cjs.compileMaterialBlock(block);
                 return `// VRR Material: "${this.escapeStringValue(m.name, "TypeScript")}" type=${m.type} baseColor=${m.baseColor || "none"}`;
               },
               physics: (block) => {
-                const p = chunkHHS6FMOU_cjs.compilePhysicsBlock(block);
+                const p = chunkHGVXZDSK_cjs.compilePhysicsBlock(block);
                 return `// VRR Physics: ${p.keyword} "${p.name || ""}" colliders=${p.colliders?.length || 0}`;
               },
               vfx: (block) => {
-                const ps = chunkHHS6FMOU_cjs.compileParticleBlock(block);
+                const ps = chunkHGVXZDSK_cjs.compileParticleBlock(block);
                 return `// VRR Particles: "${this.escapeStringValue(ps.name, "TypeScript")}" rate=${ps.properties.rate || "default"}`;
               },
               audio: (block) => {
-                const a = chunkHHS6FMOU_cjs.compileAudioSourceBlock(block);
+                const a = chunkHGVXZDSK_cjs.compileAudioSourceBlock(block);
                 return `// VRR Audio: "${this.escapeStringValue(a.name, "TypeScript")}" clip=${a.properties.clip || "none"}`;
               },
               weather: (block) => {
-                const w = chunkHHS6FMOU_cjs.compileWeatherBlock(block);
+                const w = chunkHGVXZDSK_cjs.compileWeatherBlock(block);
                 return `// VRR Weather: ${w.keyword} layers=[${w.layers.map((l) => l.type).join(", ")}]`;
               }
             },
@@ -600,7 +653,7 @@ var init_VRRCompiler = chunkEGIZHYJP_cjs.__esm({
         this.generatedCode.push(`
 // --- End of VRR Bindings --- //
 `);
-        this.generatedCode.push(`scene.add(phoenix_downtown);`);
+        this.generatedCode.push(`scene.add(${twinGroupName});`);
         return this.buildResult();
       }
       extractNodesWithTrait(astNode, traitName) {
@@ -623,6 +676,9 @@ var init_VRRCompiler = chunkEGIZHYJP_cjs.__esm({
         return matched;
       }
       generateImports() {
+        if (this.options.provenanceHash) {
+          this.generatedCode.push(`// Provenance Hash: ${this.options.provenanceHash}`);
+        }
         this.generatedCode.push(`import * as THREE from 'three';`);
         this.generatedCode.push(`import { VRRRuntime } from '@holoscript/runtime';`);
       }
@@ -637,28 +693,34 @@ var init_VRRCompiler = chunkEGIZHYJP_cjs.__esm({
         this.generatedCode.push(`renderer.setSize(window.innerWidth, window.innerHeight);`);
         this.generatedCode.push(`document.body.appendChild(renderer.domElement);`);
       }
-      generateAPIHooks(twinNodes) {
+      generateAPIHooks(twinNodes, globalSimulationState = {}) {
         this.generatedCode.push(`
 // Engine Initialization via @vrr_twin`);
         let geoCenter = { lat: 0, lng: 0 };
         let twinId = `auto_gen_twin`;
+        let twinName = "globalWorldContext";
         let weatherProvider = "";
         let eventProvider = "";
         let inventoryProvider = "";
         for (const rawNode of twinNodes) {
           const node = rawNode;
+          if (node.name) {
+            twinName = this.escapeStringValue(String(node.name), "TypeScript");
+          }
           if (node.traits) {
             for (const trait of node.traits) {
               if (trait.name === "geo_anchor")
                 geoCenter = { lat: Number(trait.params.lat), lng: Number(trait.params.lng) };
-              else if (trait.name === "vrr_twin" && trait.params.mirror) twinId = String(trait.params.mirror);
+              else if (trait.name === "vrr_twin" && trait.params.mirror)
+                twinId = String(trait.params.mirror);
               else if (trait.name === "weather_sync") weatherProvider = String(trait.params.provider);
               else if (trait.name === "event_sync") eventProvider = String(trait.params.provider);
-              else if (trait.name === "inventory_sync") inventoryProvider = String(trait.params.provider);
+              else if (trait.name === "inventory_sync")
+                inventoryProvider = String(trait.params.provider);
             }
           }
         }
-        const apiConfig = JSON.parse(JSON.stringify(this.options.api_integrations || {}));
+        const apiConfig = chunkE7JP3BS3_cjs.jsonClone(this.options.api_integrations || {});
         if (weatherProvider && !apiConfig.weather) apiConfig.weather = { provider: weatherProvider };
         if (eventProvider && !apiConfig.events) apiConfig.events = { provider: eventProvider };
         if (inventoryProvider && !apiConfig.inventory)
@@ -668,12 +730,13 @@ var init_VRRCompiler = chunkEGIZHYJP_cjs.__esm({
         this.generatedCode.push(`  geo_center: { lat: ${geoCenter.lat}, lng: ${geoCenter.lng} },`);
         this.generatedCode.push(`  apis: ${JSON.stringify(apiConfig, null, 2)},`);
         this.generatedCode.push(`  multiplayer: { enabled: true, max_players: 1000, tick_rate: 20 },`);
+        this.generatedCode.push(`  simulation_state: ${JSON.stringify(globalSimulationState)},`);
         this.generatedCode.push(
           `  state_persistence: { client: 'indexeddb', server: 'https://supabase.hololand.io' }`
         );
         this.generatedCode.push(`});`);
         this.generatedCode.push(`
-const phoenix_downtown = new THREE.Group();`);
+const ${twinName} = new THREE.Group();`);
         if (weatherProvider) {
           this.generatedCode.push(`
 // Extracted @weather_sync hook`);
@@ -694,12 +757,13 @@ const phoenix_downtown = new THREE.Group();`);
           this.generatedCode.push(`});`);
         }
         const questHubs = this.extractNodesWithTrait(twinNodes[0] || {}, "@quest_hub");
-        for (const hub of questHubs) {
+        for (let i = 0; i < questHubs.length; i++) {
+          const hub = questHubs[i];
           const questTrait = hub.traits?.find((t) => t.name === "quest_hub");
           const quests = questTrait ? Array.isArray(questTrait.params.quests) ? questTrait.params.quests : [] : [];
           this.generatedCode.push(`
 // Configured @quest_hub for ${hub.name || "Business"}`);
-          this.generatedCode.push(`const hub_${Math.random().toString(36).substring(7)} = {`);
+          this.generatedCode.push(`const hub_${i} = {`);
           this.generatedCode.push(`  quests: ${JSON.stringify(quests)}`);
           this.generatedCode.push(`};`);
           const inventory = hub.traits?.find((t) => t.name === "inventory_sync");
@@ -726,6 +790,7 @@ const phoenix_downtown = new THREE.Group();`);
         this.generatedCode.push(`vrr.syncPlayers((players) => {`);
         this.generatedCode.push(`  // Render avatars in scene mapped to players.position`);
         this.generatedCode.push(`});`);
+        return twinName;
       }
       buildResult() {
         return {
@@ -745,5 +810,5 @@ const phoenix_downtown = new THREE.Group();`);
 
 exports.VRRCompiler_exports = VRRCompiler_exports;
 exports.init_VRRCompiler = init_VRRCompiler;
-//# sourceMappingURL=chunk-VZNKJZTT.cjs.map
-//# sourceMappingURL=chunk-VZNKJZTT.cjs.map
+//# sourceMappingURL=chunk-52ULD552.cjs.map
+//# sourceMappingURL=chunk-52ULD552.cjs.map