@holoscript/core 7.0.0 → 8.0.0

package/dist/chunk-S3MDHNKB.cjs

@@ -0,0 +1,490 @@
+'use strict';
+
+var chunkKKP7JKN4_cjs = require('./chunk-KKP7JKN4.cjs');
+var chunkHCCQLAA4_cjs = require('./chunk-HCCQLAA4.cjs');
+var ans = require('@holoscript/core-types/ans');
+
+// src/compiler/ARCompiler.ts
+var ARCompiler_exports = {};
+chunkHCCQLAA4_cjs.__export(ARCompiler_exports, {
+  ARCompiler: () => exports.ARCompiler,
+  default: () => exports.ARCompiler_default
+});
+var AR_TRAIT_NAMES; exports.ARCompiler = void 0; exports.ARCompiler_default = void 0;
+var init_ARCompiler = chunkHCCQLAA4_cjs.__esm({
+  "src/compiler/ARCompiler.ts"() {
+    chunkKKP7JKN4_cjs.init_CompilerBase();
+    AR_TRAIT_NAMES = [
+      "ar_beacon",
+      "overlay",
+      "geo_anchor",
+      "qr_scan",
+      "ar_portal",
+      "camera_overlay",
+      "x402_paywall"
+    ];
+    exports.ARCompiler = class extends chunkKKP7JKN4_cjs.CompilerBase {
+      constructor(options = {}) {
+        super();
+        this.compilerName = "ARCompiler";
+        this.errors = [];
+        this.warnings = [];
+        this.generatedCode = [];
+        this.sceneCounter = 0;
+        this.options = {
+          target: options.target ?? "webxr",
+          minify: options.minify ?? false,
+          source_maps: options.source_maps ?? false,
+          features: {
+            hit_test: options.features?.hit_test ?? false,
+            image_tracking: options.features?.image_tracking ?? false
+          }
+        };
+      }
+      getRequiredCapability() {
+        return ans.ANSCapabilityPath.AR;
+      }
+      compile(composition, agentToken, outputPath) {
+        this.validateCompilerAccess(agentToken, outputPath);
+        this.errors = [];
+        this.warnings = [];
+        this.generatedCode = [];
+        if (!composition || composition.type !== "Composition") {
+          this.errors.push("Invalid composition tree");
+          return this.buildResult();
+        }
+        const arNodes = this.extractNodesWithAnyTrait(composition, AR_TRAIT_NAMES);
+        const beaconNodes = this.extractNodesWithTrait(composition, "ar_beacon");
+        const overlayNodes = this.extractNodesWithTrait(composition, "@overlay");
+        const geoAnchorNodes = this.extractNodesWithTrait(composition, "geo_anchor");
+        const qrScanNodes = this.extractNodesWithTrait(composition, "qr_scan");
+        const portalNodes = this.extractNodesWithTrait(composition, "ar_portal");
+        const cameraOverlayNodes = this.extractNodesWithTrait(composition, "camera_overlay");
+        const paywallNodes = this.extractNodesWithTrait(composition, "x402_paywall");
+        if (arNodes.length === 0) {
+          this.warnings.push("No AR traits found. Compilation may not trigger AR session.");
+        }
+        this.generateImports();
+        this.generateSceneSetup();
+        this.generateSceneNodes(arNodes);
+        this.generateARHooks({
+          beaconNodes,
+          overlayNodes,
+          geoAnchorNodes,
+          qrScanNodes,
+          portalNodes,
+          cameraOverlayNodes,
+          paywallNodes
+        });
+        return this.buildResult();
+      }
+      extractNodesWithTrait(astNode, traitName) {
+        return this.extractNodesWithAnyTrait(astNode, [traitName]);
+      }
+      extractNodesWithAnyTrait(astNode, traitNames) {
+        const matched = [];
+        const seen = /* @__PURE__ */ new Set();
+        const cleanTraitNames = new Set(traitNames.map((name) => this.cleanTraitName(name)));
+        const traverse = (node) => {
+          if (Array.isArray(node)) {
+            for (const item of node) traverse(item);
+            return;
+          }
+          if (!node || typeof node !== "object") return;
+          const record = node;
+          if (this.isObjectDecl(record) && this.nodeHasAnyTrait(record, cleanTraitNames) && !seen.has(record)) {
+            matched.push(record);
+            seen.add(record);
+          }
+          for (const value of Object.values(record)) {
+            if (value && typeof value === "object") {
+              traverse(value);
+            }
+          }
+        };
+        traverse(astNode);
+        return matched;
+      }
+      cleanTraitName(traitName) {
+        return traitName.startsWith("@") ? traitName.slice(1) : traitName;
+      }
+      isObjectDecl(record) {
+        return (record.type === "Object" || record.type === "ObjectDecl") && typeof record.name === "string" && Array.isArray(record.traits) && Array.isArray(record.properties);
+      }
+      nodeHasAnyTrait(node, traitNames) {
+        return node.traits.some((trait) => traitNames.has(this.cleanTraitName(String(trait.name))));
+      }
+      getTrait(node, traitName) {
+        const cleanTraitName = traitName.startsWith("@") ? traitName.slice(1) : traitName;
+        return node.traits.find((trait) => this.cleanTraitName(String(trait.name)) === cleanTraitName);
+      }
+      findObjProp(node, key) {
+        return node.properties.find((prop) => prop.key === key)?.value;
+      }
+      getTraitValue(node, traitName, keys, fallback) {
+        const trait = this.getTrait(node, traitName);
+        const config = trait?.config ?? trait?.params ?? {};
+        for (const key of keys) {
+          if (config[key] !== void 0) return config[key];
+        }
+        for (const key of keys) {
+          const prop = this.findObjProp(node, key);
+          if (prop !== void 0) return prop;
+        }
+        return fallback;
+      }
+      valueToString(value, fallback) {
+        if (typeof value === "string") return value;
+        if (typeof value === "number" || typeof value === "boolean") return String(value);
+        return fallback;
+      }
+      valueToNumber(value, fallback) {
+        if (typeof value === "number" && Number.isFinite(value)) return value;
+        if (typeof value === "string") {
+          const parsed = Number(value);
+          if (Number.isFinite(parsed)) return parsed;
+        }
+        return fallback;
+      }
+      valueToVector(value, fallback) {
+        if (Array.isArray(value)) {
+          return {
+            x: this.valueToNumber(value[0], fallback.x),
+            y: this.valueToNumber(value[1], fallback.y),
+            z: this.valueToNumber(value[2], fallback.z)
+          };
+        }
+        if (value && typeof value === "object" && !Array.isArray(value) && !("__bind" in value)) {
+          return {
+            x: this.valueToNumber(value["x"], fallback.x),
+            y: this.valueToNumber(value["y"], fallback.y),
+            z: this.valueToNumber(value["z"], fallback.z)
+          };
+        }
+        return fallback;
+      }
+      objectPosition(node) {
+        return this.valueToVector(this.findObjProp(node, "position"), { x: 0, y: 0, z: 0 });
+      }
+      objectScale(node) {
+        return this.valueToVector(this.findObjProp(node, "scale"), { x: 1, y: 1, z: 1 });
+      }
+      emitVectorLiteral(vector) {
+        return `{ x: ${vector.x}, y: ${vector.y}, z: ${vector.z} }`;
+      }
+      emitVectorSet(vector) {
+        return `${vector.x}, ${vector.y}, ${vector.z}`;
+      }
+      jsString(value) {
+        return `'${this.escapeStringValue(value, "TypeScript")}'`;
+      }
+      jsIdentifier(value) {
+        const safe = value.replace(/[^A-Za-z0-9_$]/g, "_").replace(/^[^A-Za-z_$]+/, "");
+        return safe || "node";
+      }
+      generateImports() {
+        this.generatedCode.push(`import * as THREE from 'three';`);
+        if (this.options.target === "webxr") {
+          this.generatedCode.push(`import { ARRuntime } from '@holoscript/runtime';`);
+        } else {
+          this.generatedCode.push(`// AR.js fallback imports would go here`);
+        }
+      }
+      generateSceneSetup() {
+        this.generatedCode.push(`
+// Initialize AR Scene`);
+        this.generatedCode.push(`const scene = new THREE.Scene();`);
+        this.generatedCode.push(
+          `const camera = new THREE.PerspectiveCamera(70, window.innerWidth / window.innerHeight, 0.01, 20);`
+        );
+        this.generatedCode.push(
+          `const renderer = new THREE.WebGLRenderer({ antialias: true, alpha: true });`
+        );
+        this.generatedCode.push(`renderer.setPixelRatio(window.devicePixelRatio);`);
+        this.generatedCode.push(`renderer.setSize(window.innerWidth, window.innerHeight);`);
+        if (this.options.target === "webxr") {
+          this.generatedCode.push(`renderer.xr.enabled = true;`);
+        }
+        this.generatedCode.push(`document.body.appendChild(renderer.domElement);`);
+      }
+      generateSceneNodes(arNodes) {
+        if (arNodes.length === 0) return;
+        this.generatedCode.push(`
+// Scene nodes emitted from AR trait inputs`);
+        for (const node of arNodes) {
+          const objectName = node.name;
+          const nodeVar = `arNode_${this.jsIdentifier(objectName)}`;
+          const position = this.objectPosition(node);
+          const scale = this.objectScale(node);
+          const color = this.valueToString(this.findObjProp(node, "color"), "#00d6ff");
+          this.generatedCode.push(`const ${nodeVar} = new THREE.Group();`);
+          this.generatedCode.push(`${nodeVar}.name = ${this.jsString(objectName)};`);
+          this.generatedCode.push(`${nodeVar}.position.set(${this.emitVectorSet(position)});`);
+          this.generatedCode.push(`${nodeVar}.scale.set(${this.emitVectorSet(scale)});`);
+          this.generatedCode.push(
+            `const ${nodeVar}Mesh = new THREE.Mesh(new THREE.BoxGeometry(0.16, 0.16, 0.16), new THREE.MeshBasicMaterial({ color: ${this.jsString(color)}, wireframe: true }));`
+          );
+          this.generatedCode.push(`${nodeVar}.add(${nodeVar}Mesh);`);
+          this.generatedCode.push(`scene.add(${nodeVar});`);
+        }
+      }
+      generateARHooks(nodes) {
+        this.generatedCode.push(`
+// Engine Initialization via AR Traits`);
+        if (this.options.target === "webxr") {
+          this.generatedCode.push(`const arRuntime = new ARRuntime({`);
+          this.generatedCode.push(`  scene_id: 'auto_gen_ar_${this.sceneCounter++}',`);
+          this.generatedCode.push(`  features: {`);
+          this.generatedCode.push(`    hit_test: ${this.options.features.hit_test},`);
+          this.generatedCode.push(`    image_tracking: ${this.options.features.image_tracking}`);
+          this.generatedCode.push(`  }`);
+          this.generatedCode.push(`});`);
+          this.generateBeaconHooks(nodes.beaconNodes);
+          this.generateOverlayHooks(nodes.overlayNodes);
+          this.generateGeoAnchorHooks(nodes.geoAnchorNodes);
+          this.generateQrScanHooks(nodes.qrScanNodes);
+          this.generatePortalHooks(nodes.portalNodes);
+          this.generateCameraOverlayHooks(nodes.cameraOverlayNodes);
+          this.generateX402PaywallHooks(nodes.paywallNodes);
+        }
+      }
+      generateBeaconHooks(nodes) {
+        if (nodes.length === 0) return;
+        this.generatedCode.push(`
+// Bind @ar_beacon detections`);
+        for (const node of nodes) {
+          const objectName = node.name;
+          const beaconId = this.valueToString(
+            this.getTraitValue(node, "ar_beacon", ["id", "marker_id", "marker"], objectName),
+            objectName
+          );
+          const beaconType = this.valueToString(
+            this.getTraitValue(node, "ar_beacon", ["type", "kind"], "image"),
+            "image"
+          );
+          const position = this.valueToVector(
+            this.getTraitValue(
+              node,
+              "ar_beacon",
+              ["position", "coords"],
+              this.findObjProp(node, "position")
+            ),
+            this.objectPosition(node)
+          );
+          const beaconVar = `arBeacon_${this.jsIdentifier(objectName)}`;
+          this.generatedCode.push(`const ${beaconVar} = {`);
+          this.generatedCode.push(`  id: ${this.jsString(beaconId)},`);
+          this.generatedCode.push(`  type: ${this.jsString(beaconType)},`);
+          this.generatedCode.push(`  objectName: ${this.jsString(objectName)},`);
+          this.generatedCode.push(`  position: ${this.emitVectorLiteral(position)}`);
+          this.generatedCode.push(`};`);
+          this.generatedCode.push(`arRuntime.registerBeacon?.(${beaconVar});`);
+          this.generatedCode.push(`arRuntime.onBeaconDetected(${this.jsString(beaconId)}, (pose) => {`);
+          this.generatedCode.push(
+            `  const anchoredNode = scene.getObjectByName(${this.jsString(objectName)});`
+          );
+          this.generatedCode.push(`  if (anchoredNode) anchoredNode.visible = true;`);
+          this.generatedCode.push(
+            `  console.log('Beacon ${this.escapeStringValue(beaconId, "TypeScript")} detected for ${this.escapeStringValue(objectName, "TypeScript")}', pose);`
+          );
+          this.generatedCode.push(`});`);
+        }
+      }
+      generateOverlayHooks(nodes) {
+        if (nodes.length === 0) return;
+        this.generatedCode.push(`
+// DOM overlays from @overlay traits`);
+        this.generatedCode.push(`const arOverlayRoot = document.createElement('div');`);
+        this.generatedCode.push(`arOverlayRoot.id = 'holoscript-ar-overlay';`);
+        this.generatedCode.push(`arOverlayRoot.style.position = 'fixed';`);
+        this.generatedCode.push(`arOverlayRoot.style.inset = '0';`);
+        this.generatedCode.push(`arOverlayRoot.style.pointerEvents = 'none';`);
+        this.generatedCode.push(`document.body.appendChild(arOverlayRoot);`);
+        for (const node of nodes) {
+          const objectName = node.name;
+          const overlayId = this.valueToString(
+            this.getTraitValue(node, "overlay", ["id"], `${objectName}_overlay`),
+            `${objectName}_overlay`
+          );
+          const text = this.valueToString(
+            this.getTraitValue(node, "overlay", ["text", "content", "label"], "AR overlay"),
+            "AR overlay"
+          );
+          const overlayVar = `arOverlay_${this.jsIdentifier(objectName)}`;
+          this.generatedCode.push(`const ${overlayVar} = document.createElement('div');`);
+          this.generatedCode.push(`${overlayVar}.id = ${this.jsString(overlayId)};`);
+          this.generatedCode.push(
+            `${overlayVar}.dataset.holoscriptObject = ${this.jsString(objectName)};`
+          );
+          this.generatedCode.push(`${overlayVar}.textContent = ${this.jsString(text)};`);
+          this.generatedCode.push(`${overlayVar}.style.pointerEvents = 'auto';`);
+          this.generatedCode.push(`arOverlayRoot.appendChild(${overlayVar});`);
+          this.generatedCode.push(
+            `arRuntime.registerOverlay?.({ id: ${this.jsString(overlayId)}, objectName: ${this.jsString(objectName)}, element: ${overlayVar} });`
+          );
+        }
+      }
+      generateGeoAnchorHooks(nodes) {
+        if (nodes.length === 0) return;
+        this.generatedCode.push(`
+// Geospatial anchors from @geo_anchor traits`);
+        for (const node of nodes) {
+          const objectName = node.name;
+          const anchorId = this.valueToString(
+            this.getTraitValue(node, "geo_anchor", ["id", "anchor_id"], objectName),
+            objectName
+          );
+          const latitude = this.valueToNumber(
+            this.getTraitValue(node, "geo_anchor", ["latitude", "lat"], 0),
+            0
+          );
+          const longitude = this.valueToNumber(
+            this.getTraitValue(node, "geo_anchor", ["longitude", "lng", "lon"], 0),
+            0
+          );
+          const altitude = this.valueToNumber(
+            this.getTraitValue(node, "geo_anchor", ["altitude", "alt"], 0),
+            0
+          );
+          const geoVar = `geoAnchor_${this.jsIdentifier(objectName)}`;
+          this.generatedCode.push(`const ${geoVar} = {`);
+          this.generatedCode.push(`  id: ${this.jsString(anchorId)},`);
+          this.generatedCode.push(`  objectName: ${this.jsString(objectName)},`);
+          this.generatedCode.push(`  latitude: ${latitude},`);
+          this.generatedCode.push(`  longitude: ${longitude},`);
+          this.generatedCode.push(`  altitude: ${altitude}`);
+          this.generatedCode.push(`};`);
+          this.generatedCode.push(`arRuntime.registerGeoAnchor?.(${geoVar});`);
+        }
+      }
+      generateQrScanHooks(nodes) {
+        if (nodes.length === 0) return;
+        this.generatedCode.push(`
+// QR/image scanner bindings from @qr_scan traits`);
+        for (const node of nodes) {
+          const objectName = node.name;
+          const qrId = this.valueToString(
+            this.getTraitValue(node, "qr_scan", ["id", "code_id", "marker"], objectName),
+            objectName
+          );
+          const payload = this.valueToString(
+            this.getTraitValue(node, "qr_scan", ["payload", "value", "pattern"], ""),
+            ""
+          );
+          const qrVar = `qrScan_${this.jsIdentifier(objectName)}`;
+          this.generatedCode.push(`const ${qrVar} = {`);
+          this.generatedCode.push(`  id: ${this.jsString(qrId)},`);
+          this.generatedCode.push(`  objectName: ${this.jsString(objectName)},`);
+          this.generatedCode.push(`  payload: ${this.jsString(payload)}`);
+          this.generatedCode.push(`};`);
+          this.generatedCode.push(`arRuntime.registerQrScanner?.(${qrVar});`);
+          this.generatedCode.push(
+            `arRuntime.onQRCodeDetected?.(${this.jsString(qrId)}, (payload) => {`
+          );
+          this.generatedCode.push(
+            `  console.log('QR ${this.escapeStringValue(qrId, "TypeScript")} detected for ${this.escapeStringValue(objectName, "TypeScript")}', payload);`
+          );
+          this.generatedCode.push(`});`);
+        }
+      }
+      generatePortalHooks(nodes) {
+        if (nodes.length === 0) return;
+        this.generatedCode.push(`
+// AR portals from @ar_portal traits`);
+        for (const node of nodes) {
+          const objectName = node.name;
+          const portalId = this.valueToString(
+            this.getTraitValue(node, "ar_portal", ["id", "portal_id"], objectName),
+            objectName
+          );
+          const destination = this.valueToString(
+            this.getTraitValue(node, "ar_portal", ["destination", "target", "scene"], ""),
+            ""
+          );
+          const portalVar = `arPortal_${this.jsIdentifier(objectName)}`;
+          this.generatedCode.push(`const ${portalVar} = {`);
+          this.generatedCode.push(`  id: ${this.jsString(portalId)},`);
+          this.generatedCode.push(`  objectName: ${this.jsString(objectName)},`);
+          this.generatedCode.push(`  destination: ${this.jsString(destination)},`);
+          this.generatedCode.push(`  position: ${this.emitVectorLiteral(this.objectPosition(node))}`);
+          this.generatedCode.push(`};`);
+          this.generatedCode.push(`arRuntime.registerPortal?.(${portalVar});`);
+        }
+      }
+      generateCameraOverlayHooks(nodes) {
+        if (nodes.length === 0) return;
+        this.generatedCode.push(`
+// Camera overlays from @camera_overlay traits`);
+        for (const node of nodes) {
+          const objectName = node.name;
+          const overlayId = this.valueToString(
+            this.getTraitValue(node, "camera_overlay", ["id"], objectName),
+            objectName
+          );
+          const text = this.valueToString(
+            this.getTraitValue(node, "camera_overlay", ["text", "label", "content"], ""),
+            ""
+          );
+          const cameraOverlayVar = `cameraOverlay_${this.jsIdentifier(objectName)}`;
+          this.generatedCode.push(`const ${cameraOverlayVar} = {`);
+          this.generatedCode.push(`  id: ${this.jsString(overlayId)},`);
+          this.generatedCode.push(`  objectName: ${this.jsString(objectName)},`);
+          this.generatedCode.push(`  text: ${this.jsString(text)},`);
+          this.generatedCode.push(`  position: ${this.emitVectorLiteral(this.objectPosition(node))}`);
+          this.generatedCode.push(`};`);
+          this.generatedCode.push(`arRuntime.registerCameraOverlay?.(${cameraOverlayVar});`);
+        }
+      }
+      generateX402PaywallHooks(nodes) {
+        if (nodes.length === 0) return;
+        this.generatedCode.push(`
+// x402 payment gates from @x402_paywall traits`);
+        for (const node of nodes) {
+          const objectName = node.name;
+          const paywallId = this.valueToString(
+            this.getTraitValue(node, "x402_paywall", ["id"], objectName),
+            objectName
+          );
+          const price = this.valueToNumber(
+            this.getTraitValue(node, "x402_paywall", ["price", "amount"], 0),
+            0
+          );
+          const asset = this.valueToString(
+            this.getTraitValue(node, "x402_paywall", ["asset", "currency"], "USDC"),
+            "USDC"
+          );
+          const network = this.valueToString(
+            this.getTraitValue(node, "x402_paywall", ["network", "chain"], "base"),
+            "base"
+          );
+          const paywallVar = `x402Paywall_${this.jsIdentifier(objectName)}`;
+          this.generatedCode.push(`const ${paywallVar} = {`);
+          this.generatedCode.push(`  id: ${this.jsString(paywallId)},`);
+          this.generatedCode.push(`  objectName: ${this.jsString(objectName)},`);
+          this.generatedCode.push(`  protocol: 'x402',`);
+          this.generatedCode.push(`  price: ${price},`);
+          this.generatedCode.push(`  asset: ${this.jsString(asset)},`);
+          this.generatedCode.push(`  network: ${this.jsString(network)}`);
+          this.generatedCode.push(`};`);
+          this.generatedCode.push(`arRuntime.requirePayment?.(${paywallVar});`);
+        }
+      }
+      buildResult() {
+        return {
+          success: this.errors.length === 0,
+          target: this.options.target,
+          code: this.generatedCode.join("\n"),
+          assets: [],
+          warnings: this.warnings,
+          errors: this.errors
+        };
+      }
+    };
+    exports.ARCompiler_default = exports.ARCompiler;
+  }
+});
+
+exports.ARCompiler_exports = ARCompiler_exports;
+exports.init_ARCompiler = init_ARCompiler;
+//# sourceMappingURL=chunk-S3MDHNKB.cjs.map
+//# sourceMappingURL=chunk-S3MDHNKB.cjs.map