@gasm-compiler/cli 0.1.0

package/LICENSE

@@ -0,0 +1,17 @@
+Copyright (c) 2025-present Gasm Compiler Authors
+
+All rights reserved.
+
+This software and associated documentation files (the "Software") are the
+proprietary property of the copyright holder(s). No permission is granted to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, except as expressly permitted in a separate written license
+agreement with the copyright holder(s).
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,172 @@
+# Gasm Compiler CLI
+
+A Deno-based command-line tool for compiling AssemblyScript to WGSL using the Gasm compiler.
+
+## Overview
+
+This CLI tool provides an easy way to:
+
+1. **Write AssemblyScript** code (a TypeScript-like subset of WebAssembly)
+2. **Compile to WebAssembly** using the AssemblyScript compiler
+3. **Transform to WGSL** using the Gasm Compiler Gasm compiler
+4. **Execute on GPU** using WebGPU
+
+## Quick Start
+
+### Prerequisites
+
+- [Deno](https://deno.com) installed
+- AssemblyScript installed (or use `npm` within the examples folder)
+
+### Usage
+
+```bash
+# Compile AssemblyScript to WASM, then to WGSL
+deno run --allow-all src/cli.ts compile examples/demo.as --output output.wgsl
+
+# View help
+deno run --allow-all src/cli.ts --help
+
+# Show detailed compiler output
+deno run --allow-all src/cli.ts compile examples/demo.as --verbose
+```
+
+## Project Structure
+
+```
+packages/cli/
+├── src/
+│   ├── cli.ts           # Main CLI entry point
+│   ├── compiler.ts      # Compilation orchestration
+│   └── utils.ts         # Utility functions
+├── examples/
+│   ├── package.json     # AssemblyScript dependencies
+│   ├── demo.as          # Sample AssemblyScript program
+│   └── asconfig.json    # AssemblyScript compiler config
+├── deno.json            # Deno configuration
+├── package.json         # NPM package metadata
+└── README.md            # This file
+```
+
+## Example AssemblyScript Programs
+
+### Simple Arithmetic
+
+The `examples/demo.ts` file contains a basic example showing:
+- Function definitions
+- Integer arithmetic
+- Memory operations
+- Control flow
+
+### WASM vs WGSL Execution Comparison
+
+The **`examples/simple_math.ts`** and **`examples/compare.ts`** demonstrate 1:1 parity verification:
+
+```bash
+# 1. Compile AssemblyScript to WASM
+cd examples && npx asc simple_math.ts -o simple_math.wasm
+
+# 2. Run comparison (executes WASM natively and compiles to WGSL)
+cd ../.. && deno run --allow-all --unstable-webgpu packages/cli/examples/compare.ts packages/cli/examples/simple_math.wasm
+```
+
+This validates that:
+- ✅ WASM functions produce expected results
+- ✅ WGSL code compiles successfully
+- ✅ Compilation preserves semantics
+
+See **[COMPARISON_DEMO.md](examples/COMPARISON_DEMO.md)** for detailed documentation.
+
+### Running Examples
+
+```bash
+# Compile and view the WGSL output
+deno run --allow-all src/cli.ts compile examples/demo.as
+
+# Save to file
+deno run --allow-all src/cli.ts compile examples/demo.as --output output.wgsl
+
+# Verbose output with compilation steps
+deno run --allow-all src/cli.ts compile examples/demo.as --verbose
+```
+
+## How It Works
+
+1. **AssemblyScript Parsing**: Your `.as` file is compiled to WebAssembly using the official AssemblyScript compiler
+2. **Gasm Validation**: The compiler validates that the Wasm conforms to the Gasm specification
+3. **IR Generation**: An intermediate representation is built for analysis and transformation
+4. **WGSL Code Generation**: The IR is transformed into WGSL shader code ready for WebGPU
+
+## CLI Options
+
+- `compile <input>` - Compile AssemblyScript to WGSL
+  - `--output <file>` - Write output to file (default: stdout)
+  - `--verbose` - Show detailed compilation steps
+  - `--keep-wasm` - Keep intermediate WASM files
+  - `--optimize` - Apply optimization passes
+
+## Development
+
+### Building from Source
+
+```bash
+# No build step needed - Deno runs TypeScript directly
+deno run --allow-all src/cli.ts --version
+```
+
+### Running Tests
+
+The CLI uses the core compiler tests. To run all tests:
+
+```bash
+cd ../core
+deno test --allow-all
+```
+
+## Architecture
+
+The CLI integrates with the Gasm Compiler Core compiler:
+
+```
+AssemblyScript (.as)
+        ↓
+   ASC Compiler
+        ↓
+WebAssembly Binary (.wasm)
+        ↓
+Core Compiler (Gasm)
+        ├─ Parser
+        ├─ Validator
+        ├─ IR Generator
+        └─ Code Generator
+        ↓
+WGSL Code (.wgsl)
+```
+
+## Testing
+# Compiler tests (WASM → WGSL compilation)
+deno test --allow-all tests/compiler_test.ts
+
+# CLI integration tests (command parsing, help, etc.)
+deno test --allow-all tests/cli_test.ts
+
+# GPU execution tests (requires WebGPU support)
+deno test --allow-all --unstable-webgpu tests/execution_test.ts
+
+## Future Plans
+
+- [ ] Web-based REPL for interactive compilation
+- [ ] Inline WASM binary support
+- [ ] Multiple output formats (WGSL, IR, debug info)
+- [ ] Performance profiling and optimization suggestions
+- [ ] Integration with gpu.js or wgpu for execution
+
+## Related Documentation
+
+- [Core Compiler Documentation](../core/README.md)
+- [Gasm Specification](../../spec/gasm-v0.1.md)
+- [AssemblyScript Handbook](https://www.assemblyscript.org/)
+
+---
+
+**Status**: Early development | **Last Updated**: December 2025

package/dist/cli.js

@@ -0,0 +1,309 @@
+// @ts-nocheck
+// Gasm Compiler CLI — requires Deno runtime
+
+
+// src/cli.ts
+import { parseArgs } from "jsr:@std/cli/parse-args";
+
+// src/compiler.ts
+import { resolve } from "jsr:@std/path";
+import { ensureFile } from "jsr:@std/fs";
+import {
+  compileWithDiagnostics,
+  disassembleToWAT,
+  parseWasmModule,
+  isParseError
+} from "@gasm-compiler/core";
+function printDiagnostics(diagnostics, verbose) {
+  for (const w of diagnostics.warnings) {
+    const where = w.functionName ? ` (${w.functionName})` : "";
+    console.error(`warning${where}: ${w.message}`);
+  }
+  if (verbose && diagnostics.demotions.length > 0) {
+    const counts = /* @__PURE__ */ new Map();
+    for (const d of diagnostics.demotions) {
+      counts.set(d.kind, (counts.get(d.kind) ?? 0) + 1);
+    }
+    const parts = [...counts.entries()].map(([kind, count]) => `${kind} (${count})`);
+    console.error(`demotions: ${parts.join(", ")}`);
+  }
+}
+async function compileAssemblyScriptToWGSL(inputFile, options = {}) {
+  const {
+    output: outputFile,
+    watOutput: watOutputFile,
+    verbose = false,
+    keepWasm = false,
+    optimize = false,
+    denyF64Demotion = false,
+    allowI64Demotion = false,
+    warningsAsErrors = false,
+    sourceMapping
+  } = options;
+  try {
+    if (verbose) console.log(`[1/4] Validating input file: ${inputFile}`);
+    const resolvedInput = resolve(inputFile);
+    const stats = await Deno.stat(resolvedInput);
+    if (!stats.isFile) {
+      throw new Error(`Not a file: ${inputFile}`);
+    }
+    const isWasm = resolvedInput.endsWith(".wasm");
+    if (!isWasm && !resolvedInput.endsWith(".as") && !resolvedInput.endsWith(".ts")) {
+      console.warn("Warning: Input file does not have .as, .ts, or .wasm extension");
+    }
+    let wasmPath = resolvedInput.replace(/\.(as|ts)$/, ".wasm");
+    if (!isWasm) {
+      if (verbose) console.log("[2/4] Compiling AssemblyScript to WASM...");
+      const asmPath = await getAssemblyScriptPath();
+      let inputForAsc = resolvedInput;
+      let cleanupTsFile = false;
+      if (resolvedInput.endsWith(".as")) {
+        inputForAsc = resolvedInput.replace(/\.as$/, ".ts");
+        cleanupTsFile = true;
+        try {
+          await Deno.symlink(resolvedInput, inputForAsc);
+        } catch (e) {
+          if (!(e instanceof Deno.errors.AlreadyExists)) {
+            const content = await Deno.readTextFile(resolvedInput);
+            await Deno.writeTextFile(inputForAsc, content);
+          }
+        }
+      }
+      const compileCommand = new Deno.Command(asmPath, {
+        args: [inputForAsc, "-o", wasmPath],
+        stdout: "piped",
+        stderr: "piped"
+      });
+      const compileProcess = compileCommand.spawn();
+      const { success, stdout, stderr } = await compileProcess.output();
+      if (cleanupTsFile) {
+        try {
+          await Deno.remove(inputForAsc);
+        } catch {
+        }
+      }
+      if (!success) {
+        const errorMsg = new TextDecoder().decode(stderr);
+        throw new Error(`AssemblyScript compilation failed:
+${errorMsg}`);
+      }
+      if (verbose) {
+        const output = new TextDecoder().decode(stdout);
+        if (output) console.log(output);
+      }
+    } else {
+      if (verbose) console.log("[2/4] Input is WASM, skipping compilation...");
+      wasmPath = resolvedInput;
+    }
+    if (verbose) console.log("[3/4] Reading WASM binary...");
+    const wasmBytes = await Deno.readFile(wasmPath);
+    if (verbose) {
+      console.log(`    WASM size: ${wasmBytes.length} bytes`);
+      console.log("[4/4] Compiling WASM to WGSL using Gasm...");
+    }
+    const demotionPolicy = {};
+    if (denyF64Demotion) demotionPolicy.f64 = "deny";
+    if (allowI64Demotion) demotionPolicy.i64 = "allow-lossy";
+    const validLevels = ["none", "minimal", "normal", "detailed", "verbose"];
+    let sourceMappingLevel;
+    if (sourceMapping) {
+      if (validLevels.includes(sourceMapping)) {
+        sourceMappingLevel = sourceMapping;
+      } else {
+        console.warn(`Warning: Unknown source-mapping level "${sourceMapping}", using "normal"`);
+        sourceMappingLevel = "normal";
+      }
+    }
+    const result = compileWithDiagnostics(wasmBytes, {
+      optimize,
+      demotionPolicy,
+      warningsAsErrors,
+      sourceMapping: sourceMappingLevel
+    });
+    printDiagnostics(result.diagnostics, verbose);
+    if (!result.ok) {
+      const first = result.diagnostics.errors[0];
+      throw new Error(first?.message ?? "Compilation failed");
+    }
+    const wgslCode = result.wgsl;
+    if (watOutputFile) {
+      if (verbose) console.log("[4a/4] Generating WAT disassembly...");
+      const parseResult = parseWasmModule(wasmBytes);
+      if (!isParseError(parseResult)) {
+        const watCode = disassembleToWAT(parseResult);
+        const resolvedWatOutput = resolve(watOutputFile);
+        await ensureFile(resolvedWatOutput);
+        await Deno.writeTextFile(resolvedWatOutput, watCode);
+        if (verbose) {
+          console.log(`\u2713 WAT disassembly written to: ${resolvedWatOutput}`);
+        } else {
+          console.log(`\u2713 WAT written to: ${watOutputFile}`);
+        }
+      } else {
+        console.warn(`Warning: Failed to parse WASM for WAT disassembly: ${parseResult.message}`);
+      }
+    }
+    if (outputFile) {
+      const resolvedOutput = resolve(outputFile);
+      await ensureFile(resolvedOutput);
+      await Deno.writeTextFile(resolvedOutput, wgslCode);
+      if (verbose) {
+        console.log(`\u2713 Successfully compiled to: ${resolvedOutput}`);
+      } else {
+        console.log(`\u2713 Compiled to: ${outputFile}`);
+      }
+    } else {
+      console.log(wgslCode);
+    }
+    if (!keepWasm && !isWasm) {
+      try {
+        await Deno.remove(wasmPath);
+        if (verbose) console.log("    Cleaned up intermediate WASM file");
+      } catch {
+      }
+    }
+  } catch (error) {
+    if (error instanceof Error) {
+      throw error;
+    }
+    throw new Error(`Unknown error: ${String(error)}`);
+  }
+}
+async function getAssemblyScriptPath() {
+  const scriptDir = new URL(".", import.meta.url).pathname;
+  const possiblePaths = [
+    // Relative to CLI package
+    resolve(scriptDir, "../../node_modules/.bin/asc"),
+    resolve(scriptDir, "../../node_modules/.pnpm/assemblyscript@0.28.9/node_modules/assemblyscript/node_modules/.bin/asc"),
+    resolve(scriptDir, "../node_modules/.bin/asc"),
+    resolve(scriptDir, "../examples/node_modules/.bin/asc"),
+    // Relative to workspace root
+    resolve(scriptDir, "../../node_modules/.bin/asc"),
+    resolve(scriptDir, "../../../node_modules/.bin/asc"),
+    // AssemblyScript toy example
+    resolve(scriptDir, "../../assemblyscript-toy/node_modules/.bin/asc")
+  ];
+  for (const path of possiblePaths) {
+    try {
+      const stat = await Deno.stat(path);
+      if (stat.isFile) {
+        return path;
+      }
+    } catch {
+    }
+  }
+  return "asc";
+}
+
+// src/cli.ts
+var VERSION = "0.1.0";
+async function main() {
+  const args = parseArgs(Deno.args, {
+    string: ["output", "wat-output", "source-mapping"],
+    boolean: [
+      "help",
+      "version",
+      "verbose",
+      "keep-wasm",
+      "optimize",
+      "deny-f64-demotion",
+      "allow-i64-demotion",
+      "warnings-as-errors"
+    ],
+    default: {
+      verbose: false,
+      "keep-wasm": false,
+      optimize: false
+    }
+  });
+  if (args.version) {
+    console.log(`Gasm Compiler CLI v${VERSION}`);
+    Deno.exit(0);
+  }
+  if (args.help || args._.length === 0) {
+    printHelp();
+    Deno.exit(args.help ? 0 : 1);
+  }
+  const command = args._[0];
+  try {
+    if (command === "compile") {
+      if (args._.length < 2) {
+        console.error("Error: compile requires an input file");
+        console.error("Usage: cli compile <input.as|wasm> [--output <output.wgsl>]");
+        Deno.exit(1);
+      }
+      const inputFile = args._[1];
+      const options = {
+        output: args.output,
+        watOutput: args["wat-output"],
+        verbose: args.verbose,
+        keepWasm: args["keep-wasm"],
+        optimize: args.optimize,
+        denyF64Demotion: args["deny-f64-demotion"],
+        allowI64Demotion: args["allow-i64-demotion"],
+        warningsAsErrors: args["warnings-as-errors"],
+        sourceMapping: args["source-mapping"]
+      };
+      await compileAssemblyScriptToWGSL(inputFile, options);
+    } else {
+      console.error(`Unknown command: ${command}`);
+      printHelp();
+      Deno.exit(1);
+    }
+  } catch (error) {
+    console.error("Error:", error instanceof Error ? error.message : String(error));
+    if (args.verbose && error instanceof Error && error.stack) {
+      console.error("\nStack trace:");
+      console.error(error.stack);
+    }
+    Deno.exit(1);
+  }
+}
+function printHelp() {
+  console.log(`
+Gasm Compiler CLI v${VERSION}
+Compile WebAssembly or AssemblyScript to WGSL using the Gasm compiler
+
+USAGE:
+    gasm-compiler <COMMAND> [OPTIONS] [ARGS]
+
+COMMANDS:
+    compile <input.wasm|.as>   Compile WebAssembly or AssemblyScript to WGSL
+    help                       Show this help message
+    version                    Show version information
+
+OPTIONS:
+    --output <file>           Write WGSL output to file (default: stdout)
+    --wat-output <file>       Also write WAT (WebAssembly Text) disassembly to file
+    --verbose                 Show detailed compilation steps
+    --keep-wasm               Keep intermediate WASM files
+    --optimize                Apply optimization passes
+    --deny-f64-demotion       Fail if f64 would be demoted to f32
+    --allow-i64-demotion      Allow lossy i64\u2192i32 demotion (mod 2^32)
+    --warnings-as-errors      Treat compiler warnings as errors
+    --source-mapping <level>  Add source mapping comments (none, minimal, normal, detailed, verbose)
+    --help                    Show this help message
+    --version                 Show version information
+
+EXAMPLES:
+    # Compile WASM to stdout
+    deno run --allow-all src/cli.ts compile input.wasm
+
+    # Compile WASM to file
+    deno run --allow-all src/cli.ts compile input.wasm --output output.wgsl
+
+    # Compile with verbose output
+    deno run --allow-all src/cli.ts compile input.wasm --verbose --output output.wgsl
+
+    # Compile with optimization
+    deno run --allow-all src/cli.ts compile input.wasm --optimize --output output.wgsl
+
+DOCUMENTATION:
+    https://github.com/MartinEricsson/gasm-compiler
+  `);
+}
+main().catch((error) => {
+  console.error("Fatal error:", error);
+  Deno.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli.ts","../src/compiler.ts"],"sourcesContent":["/**\n * Gasm Compiler CLI - Main Entry Point\n *\n * Provides a command-line interface for compiling AssemblyScript to WGSL\n * using the Gasm compiler.\n */\n\nimport { parseArgs } from \"jsr:@std/cli/parse-args\";\nimport { compileAssemblyScriptToWGSL } from \"./compiler.ts\";\n\nconst VERSION = \"0.1.0\";\n\ninterface CLIOptions {\n  help?: boolean;\n  version?: boolean;\n  output?: string;\n  \"wat-output\"?: string;\n  verbose?: boolean;\n  \"keep-wasm\"?: boolean;\n  optimize?: boolean;\n  \"deny-f64-demotion\"?: boolean;\n  \"allow-i64-demotion\"?: boolean;\n  \"warnings-as-errors\"?: boolean;\n  \"source-mapping\"?: string;\n  _: string[];\n}\n\nasync function main() {\n  const args = parseArgs(Deno.args, {\n    string: [\"output\", \"wat-output\", \"source-mapping\"],\n    boolean: [\n      \"help\",\n      \"version\",\n      \"verbose\",\n      \"keep-wasm\",\n      \"optimize\",\n      \"deny-f64-demotion\",\n      \"allow-i64-demotion\",\n      \"warnings-as-errors\",\n    ],\n    default: {\n      verbose: false,\n      \"keep-wasm\": false,\n      optimize: false,\n    },\n  }) as CLIOptions;\n\n  // Handle --version\n  if (args.version) {\n    console.log(`Gasm Compiler CLI v${VERSION}`);\n    Deno.exit(0);\n  }\n\n  // Handle --help or no command\n  if (args.help || args._.length === 0) {\n    printHelp();\n    Deno.exit(args.help ? 0 : 1);\n  }\n\n  const command = args._[0];\n\n  try {\n    if (command === \"compile\") {\n      if (args._.length < 2) {\n        console.error(\"Error: compile requires an input file\");\n        console.error(\"Usage: cli compile <input.as|wasm> [--output <output.wgsl>]\");\n        Deno.exit(1);\n      }\n\n      const inputFile = args._[1] as string;\n      const options = {\n        output: args.output as string | undefined,\n        watOutput: args[\"wat-output\"] as string | undefined,\n        verbose: args.verbose as boolean,\n        keepWasm: args[\"keep-wasm\"] as boolean,\n        optimize: args.optimize as boolean,\n        denyF64Demotion: args[\"deny-f64-demotion\"] as boolean,\n        allowI64Demotion: args[\"allow-i64-demotion\"] as boolean,\n        warningsAsErrors: args[\"warnings-as-errors\"] as boolean,\n        sourceMapping: args[\"source-mapping\"] as string | undefined,\n      };\n\n      await compileAssemblyScriptToWGSL(inputFile, options);\n    } else {\n      console.error(`Unknown command: ${command}`);\n      printHelp();\n      Deno.exit(1);\n    }\n  } catch (error) {\n    console.error(\"Error:\", error instanceof Error ? error.message : String(error));\n    if (args.verbose && error instanceof Error && error.stack) {\n      console.error(\"\\nStack trace:\");\n      console.error(error.stack);\n    }\n    Deno.exit(1);\n  }\n}\n\nfunction printHelp() {\n  console.log(`\nGasm Compiler CLI v${VERSION}\nCompile WebAssembly or AssemblyScript to WGSL using the Gasm compiler\n\nUSAGE:\n    gasm-compiler <COMMAND> [OPTIONS] [ARGS]\n\nCOMMANDS:\n    compile <input.wasm|.as>   Compile WebAssembly or AssemblyScript to WGSL\n    help                       Show this help message\n    version                    Show version information\n\nOPTIONS:\n    --output <file>           Write WGSL output to file (default: stdout)\n    --wat-output <file>       Also write WAT (WebAssembly Text) disassembly to file\n    --verbose                 Show detailed compilation steps\n    --keep-wasm               Keep intermediate WASM files\n    --optimize                Apply optimization passes\n    --deny-f64-demotion       Fail if f64 would be demoted to f32\n    --allow-i64-demotion      Allow lossy i64→i32 demotion (mod 2^32)\n    --warnings-as-errors      Treat compiler warnings as errors\n    --source-mapping <level>  Add source mapping comments (none, minimal, normal, detailed, verbose)\n    --help                    Show this help message\n    --version                 Show version information\n\nEXAMPLES:\n    # Compile WASM to stdout\n    deno run --allow-all src/cli.ts compile input.wasm\n\n    # Compile WASM to file\n    deno run --allow-all src/cli.ts compile input.wasm --output output.wgsl\n\n    # Compile with verbose output\n    deno run --allow-all src/cli.ts compile input.wasm --verbose --output output.wgsl\n\n    # Compile with optimization\n    deno run --allow-all src/cli.ts compile input.wasm --optimize --output output.wgsl\n\nDOCUMENTATION:\n    https://github.com/MartinEricsson/gasm-compiler\n  `);\n}\n\n// Run main\nmain().catch((error) => {\n  console.error(\"Fatal error:\", error);\n  Deno.exit(1);\n});\n","/**\n * Gasm Compiler CLI - Compilation Orchestration\n *\n * Handles the compilation pipeline:\n * AssemblyScript → WASM → Gasm Validation → IR → WGSL\n * \n * Note: This Deno-based CLI wrapper will be deprecated in favor of\n * the Node.js compiler exported from @gasm-compiler/core/compiler\n */\n\nimport { resolve } from \"jsr:@std/path\";\nimport { ensureFile } from \"jsr:@std/fs\";\nimport { \n  compileWithDiagnostics, \n  disassembleToWAT,\n  parseWasmModule,\n  isParseError,\n  type CompileDiagnostics \n} from \"@gasm-compiler/core\";\n\nexport interface CompileOptions {\n  output?: string;\n  watOutput?: string;\n  verbose?: boolean;\n  keepWasm?: boolean;\n  optimize?: boolean;\n  denyF64Demotion?: boolean;\n  allowI64Demotion?: boolean;\n  warningsAsErrors?: boolean;\n  sourceMapping?: string;\n}\n\nfunction printDiagnostics(diagnostics: CompileDiagnostics, verbose: boolean): void {\n  for (const w of diagnostics.warnings) {\n    const where = w.functionName ? ` (${w.functionName})` : \"\";\n    console.error(`warning${where}: ${w.message}`);\n  }\n\n  if (verbose && diagnostics.demotions.length > 0) {\n    const counts = new Map<string, number>();\n    for (const d of diagnostics.demotions) {\n      counts.set(d.kind, (counts.get(d.kind) ?? 0) + 1);\n    }\n    const parts = [...counts.entries()].map(([kind, count]) => `${kind} (${count})`);\n    console.error(`demotions: ${parts.join(\", \")}`);\n  }\n}\n\n/**\n * Compiles an AssemblyScript file to WGSL using the Gasm compiler.\n *\n * Pipeline:\n * 1. Validate input file exists\n * 2. Compile AssemblyScript to WASM using asc\n * 3. Read WASM binary\n * 4. Compile WASM to WGSL using Gasm\n * 5. Write output to file or stdout\n *\n * @param inputFile - Path to .as file\n * @param options - Compilation options\n */\nexport async function compileAssemblyScriptToWGSL(\n  inputFile: string,\n  options: CompileOptions = {},\n) {\n  const {\n    output: outputFile,\n    watOutput: watOutputFile,\n    verbose = false,\n    keepWasm = false,\n    optimize = false,\n    denyF64Demotion = false,\n    allowI64Demotion = false,\n    warningsAsErrors = false,\n    sourceMapping,\n  } = options;\n\n  try {\n    // 1. Validate input file\n    if (verbose) console.log(`[1/4] Validating input file: ${inputFile}`);\n\n    const resolvedInput = resolve(inputFile);\n    const stats = await Deno.stat(resolvedInput);\n\n    if (!stats.isFile) {\n      throw new Error(`Not a file: ${inputFile}`);\n    }\n\n    const isWasm = resolvedInput.endsWith(\".wasm\");\n\n    if (!isWasm && !resolvedInput.endsWith(\".as\") && !resolvedInput.endsWith(\".ts\")) {\n      console.warn(\"Warning: Input file does not have .as, .ts, or .wasm extension\");\n    }\n\n    let wasmPath = resolvedInput.replace(/\\.(as|ts)$/, \".wasm\");\n\n    // 2. Compile AssemblyScript to WASM (if input is not already WASM)\n    if (!isWasm) {\n      if (verbose) console.log(\"[2/4] Compiling AssemblyScript to WASM...\");\n\n      const asmPath = await getAssemblyScriptPath();\n\n      // If input ends with .as, create a temporary .ts file for asc\n      // (asc appends .ts to .as files, causing lookup failures)\n      let inputForAsc = resolvedInput;\n      let cleanupTsFile = false;\n\n      if (resolvedInput.endsWith(\".as\")) {\n        inputForAsc = resolvedInput.replace(/\\.as$/, \".ts\");\n        cleanupTsFile = true;\n\n        try {\n          // Create a symlink from .as to .ts\n          await Deno.symlink(resolvedInput, inputForAsc);\n        } catch (e) {\n          if (!(e instanceof Deno.errors.AlreadyExists)) {\n            // If symlink fails for other reasons, copy the file instead\n            const content = await Deno.readTextFile(resolvedInput);\n            await Deno.writeTextFile(inputForAsc, content);\n          }\n        }\n      }\n\n      const compileCommand = new Deno.Command(asmPath, {\n        args: [inputForAsc, \"-o\", wasmPath],\n        stdout: \"piped\",\n        stderr: \"piped\",\n      });\n\n      const compileProcess = compileCommand.spawn();\n      const { success, stdout, stderr } = await compileProcess.output();\n\n      // Clean up temporary .ts file if we created it\n      if (cleanupTsFile) {\n        try {\n          await Deno.remove(inputForAsc);\n        } catch {\n          // Ignore cleanup errors\n        }\n      }\n\n      if (!success) {\n        const errorMsg = new TextDecoder().decode(stderr);\n        throw new Error(`AssemblyScript compilation failed:\\n${errorMsg}`);\n      }\n\n      if (verbose) {\n        const output = new TextDecoder().decode(stdout);\n        if (output) console.log(output);\n      }\n    } else {\n      if (verbose) console.log(\"[2/4] Input is WASM, skipping compilation...\");\n      wasmPath = resolvedInput;\n    }\n\n    // 3. Read WASM binary and compile to WGSL\n    if (verbose) console.log(\"[3/4] Reading WASM binary...\");\n\n    const wasmBytes = await Deno.readFile(wasmPath);\n\n    if (verbose) {\n      console.log(`    WASM size: ${wasmBytes.length} bytes`);\n      console.log(\"[4/4] Compiling WASM to WGSL using Gasm...\");\n    }\n\n    const demotionPolicy: {\n      f64?: \"allow\" | \"deny\";\n      i64?: \"deny\" | \"allow-lossy\";\n    } = {};\n    if (denyF64Demotion) demotionPolicy.f64 = \"deny\";\n    if (allowI64Demotion) demotionPolicy.i64 = \"allow-lossy\";\n\n    // Parse source mapping level\n    type SourceMappingLevel = \"none\" | \"minimal\" | \"normal\" | \"detailed\" | \"verbose\";\n    const validLevels: SourceMappingLevel[] = [\"none\", \"minimal\", \"normal\", \"detailed\", \"verbose\"];\n    let sourceMappingLevel: SourceMappingLevel | undefined;\n    if (sourceMapping) {\n      if (validLevels.includes(sourceMapping as SourceMappingLevel)) {\n        sourceMappingLevel = sourceMapping as SourceMappingLevel;\n      } else {\n        console.warn(`Warning: Unknown source-mapping level \"${sourceMapping}\", using \"normal\"`);\n        sourceMappingLevel = \"normal\";\n      }\n    }\n\n    const result = compileWithDiagnostics(wasmBytes, {\n      optimize,\n      demotionPolicy,\n      warningsAsErrors,\n      sourceMapping: sourceMappingLevel,\n    });\n\n    printDiagnostics(result.diagnostics, verbose);\n\n    if (!result.ok) {\n      const first = result.diagnostics.errors[0];\n      throw new Error(first?.message ?? \"Compilation failed\");\n    }\n\n    const wgslCode = result.wgsl;\n\n    // 4. Generate WAT disassembly if requested\n    if (watOutputFile) {\n      if (verbose) console.log(\"[4a/4] Generating WAT disassembly...\");\n      \n      // Parse the WASM to get the module structure\n      const parseResult = parseWasmModule(wasmBytes);\n      \n      // Check if parsing succeeded\n      if (!isParseError(parseResult)) {\n        const watCode = disassembleToWAT(parseResult);\n        const resolvedWatOutput = resolve(watOutputFile);\n        await ensureFile(resolvedWatOutput);\n        await Deno.writeTextFile(resolvedWatOutput, watCode);\n        \n        if (verbose) {\n          console.log(`✓ WAT disassembly written to: ${resolvedWatOutput}`);\n        } else {\n          console.log(`✓ WAT written to: ${watOutputFile}`);\n        }\n      } else {\n        console.warn(`Warning: Failed to parse WASM for WAT disassembly: ${parseResult.message}`);\n      }\n    }\n\n    // 5. Write WGSL output\n    if (outputFile) {\n      const resolvedOutput = resolve(outputFile);\n      await ensureFile(resolvedOutput);\n      await Deno.writeTextFile(resolvedOutput, wgslCode);\n\n      if (verbose) {\n        console.log(`✓ Successfully compiled to: ${resolvedOutput}`);\n      } else {\n        console.log(`✓ Compiled to: ${outputFile}`);\n      }\n    } else {\n      console.log(wgslCode);\n    }\n\n    // Clean up intermediate WASM if not keeping (and we generated it)\n    if (!keepWasm && !isWasm) {\n      try {\n        await Deno.remove(wasmPath);\n        if (verbose) console.log(\"    Cleaned up intermediate WASM file\");\n      } catch {\n        // Ignore cleanup errors\n      }\n    }\n  } catch (error) {\n    if (error instanceof Error) {\n      throw error;\n    }\n    throw new Error(`Unknown error: ${String(error)}`);\n  }\n}\n\n/**\n * Locates the AssemblyScript compiler executable\n * Tries multiple common paths\n */\nasync function getAssemblyScriptPath(): Promise<string> {\n  // Get the directory of the current script for relative path resolution\n  const scriptDir = new URL(\".\", import.meta.url).pathname;\n\n  const possiblePaths = [\n    // Relative to CLI package\n    resolve(scriptDir, \"../../node_modules/.bin/asc\"),\n    resolve(scriptDir, \"../../node_modules/.pnpm/assemblyscript@0.28.9/node_modules/assemblyscript/node_modules/.bin/asc\"),\n    resolve(scriptDir, \"../node_modules/.bin/asc\"),\n    resolve(scriptDir, \"../examples/node_modules/.bin/asc\"),\n    \n    // Relative to workspace root\n    resolve(scriptDir, \"../../node_modules/.bin/asc\"),\n    resolve(scriptDir, \"../../../node_modules/.bin/asc\"),\n    \n    // AssemblyScript toy example\n    resolve(scriptDir, \"../../assemblyscript-toy/node_modules/.bin/asc\"),\n  ];\n\n  for (const path of possiblePaths) {\n    try {\n      const stat = await Deno.stat(path);\n      if (stat.isFile) {\n        return path;\n      }\n    } catch {\n      // Path doesn't exist, try next\n    }\n  }\n\n  // If not found, assume 'asc' is in PATH\n  return \"asc\";\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@gasm-compiler/cli",
+  "version": "0.1.0",
+  "description": "CLI for compiling WebAssembly/AssemblyScript to WGSL using Gasm Compiler",
+  "type": "module",
+  "main": "./dist/cli.js",
+  "types": "./dist/cli.d.ts",
+  "bin": {
+    "gasm-compiler": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/cli.d.ts",
+      "import": "./dist/cli.js",
+      "default": "./dist/cli.js"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "license": "SEE LICENSE IN LICENSE",
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "wasm",
+    "webassembly",
+    "wgsl",
+    "webgpu",
+    "compiler",
+    "gasm",
+    "cli"
+  ],
+  "dependencies": {
+    "@gasm-compiler/core": "0.1.0"
+  },
+  "devDependencies": {
+    "assemblyscript": "v0.28.9",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "deno run --allow-all src/cli.ts",
+    "lint": "biome lint ."
+  }
+}