@holoscript/core 6.0.3 → 6.1.1

package/dist/{chunk-65RFOWZI.js → chunk-5CKA5SXU.js}

@@ -1,6 +1,7 @@
-import { init_DomainBlockCompilerMixin, compileDomainBlocks, compileMaterialBlock } from './chunk-KDB6BUMB.js';
-import { createTestCompilerToken, init_CompilerBase, init_ANSNamespace, CompilerBase, ANSCapabilityPath } from './chunk-QWKUKVRE.js';
-import { __export, __esm } from './chunk-32TWR3HE.js';
+import { init_DomainBlockCompilerMixin, compileDomainBlocks, compileMaterialBlock } from './chunk-W55Z7QIX.js';
+import { createTestCompilerToken, init_CompilerBase, CompilerBase } from './chunk-QTPMJRGS.js';
+import { __export, __esm } from './chunk-OL46QLBJ.js';
+import { ANSCapabilityPath } from '@holoscript/core-types/ans';
 
 // src/compiler/WASMCompiler.ts
 var WASMCompiler_exports = {};
@@ -22,12 +23,21 @@ function compileASTToWASM(ast, options) {
   const compiler = new WASMCompiler(options);
   return compiler.compileAST(ast);
 }
-var WASMCompiler, WASMCompiler_default;
+var WASM_WAT_LIMITATIONS, WASM_BINARY_LIMITATIONS, WASMCompiler, WASMCompiler_default;
 var init_WASMCompiler = __esm({
   "src/compiler/WASMCompiler.ts"() {
     init_CompilerBase();
-    init_ANSNamespace();
     init_DomainBlockCompilerMixin();
+    WASM_WAT_LIMITATIONS = [
+      "Emits WebAssembly Text Format scaffolding only.",
+      'Does not return instantiable bytes unless format is set to "wasm".',
+      "Lowers trait/lifecycle/event hooks to deterministic host event calls, not arbitrary user code."
+    ];
+    WASM_BINARY_LIMITATIONS = [
+      "Returns an instantiable WebAssembly binary for the compiler-supported runtime subset.",
+      "Lowers trait/lifecycle/event hooks to deterministic host event calls, not arbitrary user code.",
+      "Does not run a general-purpose WAT parser for unsupported custom WAT extensions."
+    ];
     WASMCompiler = class extends CompilerBase {
       constructor(options = {}) {
         super();
@@ -54,15 +64,18 @@ var init_WASMCompiler = __esm({
           stringsSize: 0,
           totalSize: 0
         };
+        const { generateDocs, docsOptions, provenanceHash, ...wasmRest } = options;
+        this.docGenerationOptions = { generateDocs, docsOptions, provenanceHash };
+        const w = wasmRest;
         this.options = {
-          format: options.format || "wat",
-          debug: options.debug ?? false,
-          memoryPages: options.memoryPages || 16,
+          format: w.format || "wat",
+          debug: w.debug ?? false,
+          memoryPages: w.memoryPages || 16,
           // 1MB default
-          simd: options.simd ?? false,
-          threads: options.threads ?? false,
-          generateBindings: options.generateBindings ?? true,
-          moduleName: options.moduleName || "holoscript"
+          simd: w.simd ?? false,
+          threads: w.threads ?? false,
+          generateBindings: w.generateBindings ?? true,
+          moduleName: w.moduleName || "holoscript"
         };
       }
       getRequiredCapability() {
@@ -75,8 +88,6 @@ var init_WASMCompiler = __esm({
        * Compile HoloComposition AST to WASM
        */
       compile(composition, agentToken, outputPath) {
-        this.validateCompilerAccess(agentToken, outputPath);
-        this.reset();
         this.validateCompilerAccess(agentToken, outputPath);
         this.reset();
         this.analyzeState(composition.state);
@@ -110,13 +121,19 @@ var init_WASMCompiler = __esm({
           );
         }
         const bindings = this.options.generateBindings ? this.generateBindings(composition) : "";
-        return {
+        const wasm = this.options.format === "wasm" ? this.emitWASMBytes(this.lowerCompositionObjectUpdates(composition.objects || [])) : void 0;
+        const result = {
+          artifactKind: wasm ? "wasm-binary" : "wat-scaffold",
+          format: this.options.format,
           wat: this.lines.join("\n"),
+          ...wasm ? { wasm } : {},
           bindings,
           memoryLayout: this.memoryLayout,
           exports: this.exports,
-          imports: this.imports
+          imports: this.imports,
+          limitations: wasm ? [...WASM_BINARY_LIMITATIONS] : [...WASM_WAT_LIMITATIONS]
         };
+        return this.withTripleOutputIfRequested(composition, result, this.docGenerationOptions);
       }
       /**
        * Compile HSPlusAST to WASM
@@ -128,12 +145,17 @@ var init_WASMCompiler = __esm({
         this.calculateMemoryLayout();
         this.emitModuleFromAST(ast);
         const bindings = this.options.generateBindings ? this.generateBindingsFromAST(ast) : "";
+        const wasm = this.options.format === "wasm" ? this.emitWASMBytes(this.lowerASTObjectUpdates(ast.root.children || [])) : void 0;
         return {
+          artifactKind: wasm ? "wasm-binary" : "wat-scaffold",
+          format: this.options.format,
           wat: this.lines.join("\n"),
+          ...wasm ? { wasm } : {},
           bindings,
           memoryLayout: this.memoryLayout,
           exports: this.exports,
-          imports: this.imports
+          imports: this.imports,
+          limitations: wasm ? [...WASM_BINARY_LIMITATIONS] : [...WASM_WAT_LIMITATIONS]
         };
       }
       reset() {
@@ -416,6 +438,14 @@ var init_WASMCompiler = __esm({
             signature: `(${v.type}) -> void`
           });
         }
+        this.emit('(func $get_frame_count (export "get_frame_count") (result i32)');
+        this.emit("  (global.get $frame_count)");
+        this.emit(")");
+        this.exports.push({
+          name: "get_frame_count",
+          kind: "function",
+          signature: "() -> i32"
+        });
         this.emit("");
       }
       emitObjectFunctions() {
@@ -466,7 +496,8 @@ var init_WASMCompiler = __esm({
         this.emit(")");
         this.emit("");
       }
-      emitUpdateFunction(_composition) {
+      emitUpdateFunction(composition) {
+        const objectUpdates = this.lowerCompositionObjectUpdates(composition.objects || []);
         this.emit(";; Main update function");
         this.emit('(func $update (export "update") (param $dt f32)');
         this.indent();
@@ -492,13 +523,14 @@ var init_WASMCompiler = __esm({
           const safeName = this.sanitizeName(obj.id);
           this.emit(`(func $update_object_${i} (param $dt f32)`);
           this.emit(`  ;; Update logic for ${safeName}`);
-          this.emit("  ;; (custom logic would be generated here based on traits/lifecycle)");
+          this.emitLoweredObjectUpdateBody(objectUpdates[i] || [], i);
           this.emit(")");
         }
         this.exports.push({ name: "update", kind: "function", signature: "(f32) -> void" });
         this.emit("");
       }
-      emitUpdateFunctionFromAST(_ast) {
+      emitUpdateFunctionFromAST(ast) {
+        const objectUpdates = this.lowerASTObjectUpdates(ast.root.children || []);
         this.emit(";; Main update function");
         this.emit('(func $update (export "update") (param $dt f32)');
         this.indent();
@@ -524,11 +556,84 @@ var init_WASMCompiler = __esm({
           const safeName = this.sanitizeName(obj.id);
           this.emit(`(func $update_object_${i} (param $dt f32)`);
           this.emit(`  ;; Update logic for ${safeName}`);
+          this.emitLoweredObjectUpdateBody(objectUpdates[i] || [], i);
           this.emit(")");
         }
         this.exports.push({ name: "update", kind: "function", signature: "(f32) -> void" });
         this.emit("");
       }
+      emitLoweredObjectUpdateBody(updates, objectIndex) {
+        if (updates.length === 0) {
+          this.emit("  ;; No WASM-lowerable trait/lifecycle/event hooks for this object");
+          return;
+        }
+        for (const update of updates) {
+          this.emit(`  ;; ${this.escapeStringValue(update.label, "TypeScript")}`);
+          this.emit(`  (call $emit_event (i32.const ${update.eventId}) (i32.const ${objectIndex}))`);
+        }
+      }
+      lowerCompositionObjectUpdates(objects) {
+        return objects.map((obj) => {
+          const events = [];
+          for (const trait of obj.traits || []) {
+            events.push(this.createLoweredUpdate(`trait:${trait.name}`));
+          }
+          for (const eventHandler of this.getUnknownArray(obj, "eventHandlers")) {
+            const event = this.getUnknownString(eventHandler, "event");
+            if (event) events.push(this.createLoweredUpdate(`event:${event}`));
+          }
+          for (const directive of this.getUnknownArray(obj, "directives")) {
+            const directiveType = this.getUnknownString(directive, "type");
+            const hook = this.getUnknownString(directive, "hook") || this.getUnknownString(directive, "name");
+            if (directiveType === "lifecycle" && hook) {
+              events.push(this.createLoweredUpdate(`lifecycle:${hook}`));
+            }
+          }
+          return events;
+        });
+      }
+      lowerASTObjectUpdates(nodes) {
+        return nodes.map((node) => {
+          const events = [];
+          for (const directive of node.directives || []) {
+            const directiveType = this.getUnknownString(directive, "type");
+            const name = this.getUnknownString(directive, "name") || this.getUnknownString(directive, "hook");
+            if (directiveType === "trait" && name) {
+              events.push(this.createLoweredUpdate(`trait:${name}`));
+            } else if (directiveType === "lifecycle" && name) {
+              events.push(this.createLoweredUpdate(`lifecycle:${name}`));
+            }
+          }
+          for (const [key] of Object.entries(node.properties || {})) {
+            if (key.startsWith("on_")) events.push(this.createLoweredUpdate(`event:${key}`));
+          }
+          return events;
+        });
+      }
+      createLoweredUpdate(label) {
+        return {
+          label,
+          eventId: this.stableEventId(label)
+        };
+      }
+      stableEventId(label) {
+        let hash = 2166136261;
+        for (let i = 0; i < label.length; i++) {
+          hash ^= label.charCodeAt(i);
+          hash = Math.imul(hash, 16777619);
+        }
+        return hash >>> 1;
+      }
+      getUnknownArray(source, key) {
+        if (!source || typeof source !== "object") return [];
+        const value = source[key];
+        return Array.isArray(value) ? value : [];
+      }
+      getUnknownString(source, key) {
+        if (!source || typeof source !== "object") return void 0;
+        const value = source[key];
+        return typeof value === "string" ? value : void 0;
+      }
       emitDataSections() {
         if (this.stringPool.size === 0) return;
         this.emit(";; Data sections");
@@ -553,7 +658,9 @@ var init_WASMCompiler = __esm({
         lines.push("export class HoloScriptWASM {");
         lines.push("  private instance: WebAssembly.Instance | null = null;");
         lines.push("  private memory: WebAssembly.Memory | null = null;");
-        lines.push("  private eventHandlers: Map<string, Set<(payload: unknown) => void>> = new Map();");
+        lines.push(
+          "  private eventHandlers: Map<string, Set<(payload: unknown) => void>> = new Map();"
+        );
         lines.push("");
         lines.push("  private static EVENT_IDS: Record<string, number> = {");
         lines.push("    'update': 0,");
@@ -693,6 +800,317 @@ var init_WASMCompiler = __esm({
         return this.generateBindings(minimalComposition);
       }
       // ===========================================================================
+      // WASM BINARY GENERATION
+      // ===========================================================================
+      emitWASMBytes(objectUpdates) {
+        const types = [];
+        const typeIndexes = /* @__PURE__ */ new Map();
+        const typeIndex = (params, results = []) => {
+          const key = `${params.join(",")}->${results.join(",")}`;
+          const existing = typeIndexes.get(key);
+          if (existing !== void 0) return existing;
+          const next = types.length;
+          types.push({ params, results });
+          typeIndexes.set(key, next);
+          return next;
+        };
+        const imports = [
+          { module: "env", name: "log_i32", typeIndex: typeIndex(["i32"]) },
+          { module: "env", name: "log_f32", typeIndex: typeIndex(["f32"]) },
+          { module: "env", name: "log_str", typeIndex: typeIndex(["i32", "i32"]) },
+          { module: "env", name: "emit_event", typeIndex: typeIndex(["i32", "i32"]) },
+          { module: "env", name: "get_time", typeIndex: typeIndex([], ["f64"]) }
+        ];
+        const functions = [];
+        const functionIndexes = /* @__PURE__ */ new Map();
+        const addFunction = (name, params, results, body) => {
+          functionIndexes.set(name, imports.length + functions.length);
+          functions.push({ name, typeIndex: typeIndex(params, results), body });
+        };
+        addFunction("init", [], [], () => this.binaryInitBody());
+        for (const stateVar of this.stateVars) {
+          const safeName = this.sanitizeName(stateVar.name);
+          addFunction(
+            `get_${safeName}`,
+            [],
+            [stateVar.type],
+            () => this.binaryStateGetterBody(stateVar)
+          );
+          addFunction(
+            `set_${safeName}`,
+            [stateVar.type],
+            [],
+            () => this.binaryStateSetterBody(stateVar)
+          );
+        }
+        addFunction("get_frame_count", [], ["i32"], () => [0, 35, ...this.encodeULEB(0), 11]);
+        addFunction("get_object_count", [], ["i32"], () => [0, 35, ...this.encodeULEB(3), 11]);
+        addFunction("is_object_active", ["i32"], ["i32"], () => this.binaryIsObjectActiveBody());
+        addFunction("set_object_active", ["i32", "i32"], [], () => this.binarySetObjectActiveBody());
+        addFunction(
+          "update",
+          ["f32"],
+          [],
+          () => this.binaryUpdateBody(functionIndexes, objectUpdates.length)
+        );
+        for (let i = 0; i < this.objects.length; i++) {
+          addFunction(
+            `update_object_${i}`,
+            ["f32"],
+            [],
+            () => this.binaryUpdateObjectBody(objectUpdates[i] || [], i)
+          );
+        }
+        const bytes = [
+          0,
+          97,
+          115,
+          109,
+          1,
+          0,
+          0,
+          0,
+          ...this.binarySection(1, this.binaryTypeSection(types)),
+          ...this.binarySection(2, this.binaryImportSection(imports)),
+          ...this.binarySection(3, this.binaryFunctionSection(functions)),
+          ...this.binarySection(5, this.binaryMemorySection()),
+          ...this.binarySection(6, this.binaryGlobalSection()),
+          ...this.binarySection(7, this.binaryExportSection(functions, imports.length)),
+          ...this.binarySection(10, this.binaryCodeSection(functions))
+        ];
+        return new Uint8Array(bytes);
+      }
+      binaryTypeSection(types) {
+        return this.binaryVector(
+          types.map((type) => [
+            96,
+            ...this.binaryVector(type.params.map((param) => [this.wasmBinaryValueType(param)])),
+            ...this.binaryVector(type.results.map((result) => [this.wasmBinaryValueType(result)]))
+          ])
+        );
+      }
+      binaryImportSection(imports) {
+        return this.binaryVector(
+          imports.map((entry) => [
+            ...this.encodeString(entry.module),
+            ...this.encodeString(entry.name),
+            0,
+            ...this.encodeULEB(entry.typeIndex)
+          ])
+        );
+      }
+      binaryFunctionSection(functions) {
+        return this.binaryVector(functions.map((fn) => this.encodeULEB(fn.typeIndex)));
+      }
+      binaryMemorySection() {
+        if (this.options.threads) {
+          return this.binaryVector([
+            [
+              3,
+              ...this.encodeULEB(this.options.memoryPages),
+              ...this.encodeULEB(this.options.memoryPages * 2)
+            ]
+          ]);
+        }
+        return this.binaryVector([[0, ...this.encodeULEB(this.options.memoryPages)]]);
+      }
+      binaryGlobalSection() {
+        return this.binaryVector([
+          [127, 1, 65, ...this.encodeSLEB(0), 11],
+          [125, 1, 67, ...this.f32Bytes(0), 11],
+          [124, 1, 68, ...this.f64Bytes(0), 11],
+          [127, 0, 65, ...this.encodeSLEB(this.objects.length), 11]
+        ]);
+      }
+      binaryExportSection(functions, importedFunctionCount) {
+        const exports$1 = [
+          [...this.encodeString("memory"), 2, ...this.encodeULEB(0)],
+          ...functions.filter((fn) => !fn.name.startsWith("update_object_")).map((fn, index) => [
+            ...this.encodeString(fn.name),
+            0,
+            ...this.encodeULEB(importedFunctionCount + index)
+          ])
+        ];
+        return this.binaryVector(exports$1);
+      }
+      binaryCodeSection(functions) {
+        return this.binaryVector(
+          functions.map((fn) => {
+            const body = fn.body();
+            return [...this.encodeULEB(body.length), ...body];
+          })
+        );
+      }
+      binaryInitBody() {
+        const body = [0];
+        for (const stateVar of this.stateVars) {
+          const offset = this.memoryLayout.stateOffset + stateVar.offset;
+          body.push(65, ...this.encodeSLEB(offset));
+          this.pushWASMConst(body, stateVar.type, stateVar.initialValue);
+          this.pushWASMStore(body, stateVar.type);
+        }
+        for (const obj of this.objects) {
+          const baseOffset = this.memoryLayout.objectsOffset + obj.offset;
+          this.pushI32StoreConst(body, baseOffset, obj.typeIndex);
+          this.pushI32StoreConst(body, baseOffset + 4, 1);
+          this.pushI32StoreConst(body, baseOffset + 8, -1);
+        }
+        body.push(11);
+        return body;
+      }
+      binaryStateGetterBody(stateVar) {
+        const offset = this.memoryLayout.stateOffset + stateVar.offset;
+        const body = [0, 65, ...this.encodeSLEB(offset)];
+        this.pushWASMLoad(body, stateVar.type);
+        body.push(11);
+        return body;
+      }
+      binaryStateSetterBody(stateVar) {
+        const offset = this.memoryLayout.stateOffset + stateVar.offset;
+        const body = [0, 65, ...this.encodeSLEB(offset), 32, 0];
+        this.pushWASMStore(body, stateVar.type);
+        body.push(11);
+        return body;
+      }
+      binaryIsObjectActiveBody() {
+        const body = [0];
+        this.pushObjectActiveAddress(body, 0);
+        body.push(40, 2, 0, 11);
+        return body;
+      }
+      binarySetObjectActiveBody() {
+        const body = [0];
+        this.pushObjectActiveAddress(body, 0);
+        body.push(32, 1, 54, 2, 0, 11);
+        return body;
+      }
+      binaryUpdateBody(functionIndexes, loweredObjectCount) {
+        const body = [0];
+        body.push(32, 0, 36, ...this.encodeULEB(1));
+        body.push(35, ...this.encodeULEB(0), 65, ...this.encodeSLEB(1), 106);
+        body.push(36, ...this.encodeULEB(0));
+        const isActiveIndex = functionIndexes.get("is_object_active");
+        if (isActiveIndex === void 0) throw new Error("missing is_object_active function index");
+        for (let i = 0; i < loweredObjectCount; i++) {
+          const updateObjectIndex = functionIndexes.get(`update_object_${i}`);
+          if (updateObjectIndex === void 0) continue;
+          body.push(65, ...this.encodeSLEB(i), 16, ...this.encodeULEB(isActiveIndex));
+          body.push(4, 64);
+          body.push(32, 0, 16, ...this.encodeULEB(updateObjectIndex));
+          body.push(11);
+        }
+        body.push(11);
+        return body;
+      }
+      binaryUpdateObjectBody(updates, objectIndex) {
+        const body = [0];
+        for (const update of updates) {
+          body.push(
+            65,
+            ...this.encodeSLEB(update.eventId),
+            65,
+            ...this.encodeSLEB(objectIndex),
+            16,
+            ...this.encodeULEB(3)
+          );
+        }
+        body.push(11);
+        return body;
+      }
+      pushObjectActiveAddress(body, localIndex) {
+        body.push(65, ...this.encodeSLEB(this.memoryLayout.objectsOffset));
+        body.push(32, ...this.encodeULEB(localIndex));
+        body.push(65, ...this.encodeSLEB(64), 108);
+        body.push(65, ...this.encodeSLEB(4), 106);
+        body.push(106);
+      }
+      pushI32StoreConst(body, offset, value) {
+        body.push(65, ...this.encodeSLEB(offset), 65, ...this.encodeSLEB(value), 54, 2, 0);
+      }
+      pushWASMConst(body, type, value) {
+        switch (type) {
+          case "i32":
+            body.push(65, ...this.encodeSLEB(Number(value)));
+            break;
+          case "i64":
+            body.push(66, ...this.encodeSLEB(value));
+            break;
+          case "f32":
+            body.push(67, ...this.f32Bytes(Number(value)));
+            break;
+          case "f64":
+            body.push(68, ...this.f64Bytes(Number(value)));
+            break;
+        }
+      }
+      pushWASMLoad(body, type) {
+        const opcode = { i32: 40, i64: 41, f32: 42, f64: 43 }[type];
+        const align = type === "i64" || type === "f64" ? 3 : 2;
+        body.push(opcode, align, 0);
+      }
+      pushWASMStore(body, type) {
+        const opcode = { i32: 54, i64: 55, f32: 56, f64: 57 }[type];
+        const align = type === "i64" || type === "f64" ? 3 : 2;
+        body.push(opcode, align, 0);
+      }
+      binarySection(id, payload) {
+        return [id, ...this.encodeULEB(payload.length), ...payload];
+      }
+      binaryVector(items) {
+        return [...this.encodeULEB(items.length), ...items.flat()];
+      }
+      encodeString(value) {
+        const bytes = Array.from(new TextEncoder().encode(value));
+        return [...this.encodeULEB(bytes.length), ...bytes];
+      }
+      encodeULEB(value) {
+        const bytes = [];
+        let next = value >>> 0;
+        do {
+          let byte = next & 127;
+          next >>>= 7;
+          if (next !== 0) byte |= 128;
+          bytes.push(byte);
+        } while (next !== 0);
+        return bytes;
+      }
+      encodeSLEB(value) {
+        const bytes = [];
+        let next = BigInt(value);
+        let more = true;
+        while (more) {
+          let byte = Number(next & 0x7fn);
+          next >>= 7n;
+          const signBitSet = (byte & 64) !== 0;
+          more = !(next === 0n && !signBitSet || next === -1n && signBitSet);
+          if (more) byte |= 128;
+          bytes.push(byte);
+        }
+        return bytes;
+      }
+      f32Bytes(value) {
+        const bytes = new Uint8Array(4);
+        new DataView(bytes.buffer).setFloat32(0, value, true);
+        return Array.from(bytes);
+      }
+      f64Bytes(value) {
+        const bytes = new Uint8Array(8);
+        new DataView(bytes.buffer).setFloat64(0, value, true);
+        return Array.from(bytes);
+      }
+      wasmBinaryValueType(type) {
+        switch (type) {
+          case "i32":
+            return 127;
+          case "i64":
+            return 126;
+          case "f32":
+            return 125;
+          case "f64":
+            return 124;
+        }
+      }
+      // ===========================================================================
       // HELPERS
       // ===========================================================================
       emit(line) {
@@ -761,5 +1179,5 @@ var init_WASMCompiler = __esm({
 });
 
 export { WASMCompiler, WASMCompiler_default, WASMCompiler_exports, compileASTToWASM, compileToWASM, createWASMCompiler, init_WASMCompiler };
-//# sourceMappingURL=chunk-65RFOWZI.js.map
-//# sourceMappingURL=chunk-65RFOWZI.js.map
+//# sourceMappingURL=chunk-5CKA5SXU.js.map
+//# sourceMappingURL=chunk-5CKA5SXU.js.map