@gasm-compiler/cli 0.2.0 → 0.4.0

package/README.md

@@ -56,6 +56,7 @@ Compiles a WebAssembly binary or AssemblyScript source to WGSL.
 | `--verbose` | Show detailed compilation steps |
 | `--keep-wasm` | Keep intermediate `.wasm` file when compiling from AssemblyScript |
 | `--optimize` | Apply optimization passes |
+| `--minify` | Optimize and emit compact, single-line WGSL |
 
 **Examples:**
 

package/dist/cli.js

@@ -14,6 +14,7 @@ import {
   disassembleToWAT,
   isParseError,
   parseWasmModule,
+  prepareModule,
   validateGasmMetadataSchema
 } from "@gasm-compiler/core";
 function printDiagnostics(diagnostics, verbose) {
@@ -36,27 +37,37 @@ async function compileAssemblyScriptToWGSL(inputFile, options = {}) {
   const {
     output: outputFile,
     metadata: metadataFile,
+    prepare,
+    strict = false,
     specVersion: requestedSpecVersion,
     watOutput: watOutputFile,
     verbose = false,
     keepWasm = false,
-    optimize = false,
+    optimize,
+    minify = false,
     denyF64Demotion = false,
     allowI64Demotion = false,
     warningsAsErrors = false,
     sourceMapping
   } = options;
   try {
+    if (minify && optimize === false) {
+      throw new Error("--minify cannot be combined with --no-optimize");
+    }
     if (requestedSpecVersion !== void 0 && requestedSpecVersion !== "0.1" && requestedSpecVersion !== "0.2") {
       throw new Error(
         `Unsupported spec version "${requestedSpecVersion}"; expected 0.1 or 0.2`
       );
     }
+    if (prepare !== void 0 && prepare !== "auto") {
+      throw new Error(`Unsupported prepare mode "${prepare}"; expected "auto"`);
+    }
+    if (prepare && strict) {
+      throw new Error("--prepare and --strict cannot be used together");
+    }
     const specVersion = requestedSpecVersion ?? "0.2";
     if (metadataFile && specVersion !== "0.2") {
-      throw new Error(
-        "--metadata requires --spec-version 0.2"
-      );
+      throw new Error("--metadata requires --spec-version 0.2");
     }
     if (verbose) console.log(`[1/4] Validating input file: ${inputFile}`);
     const resolvedInput = resolve(inputFile);
@@ -141,14 +152,31 @@ ${errorMsg}`);
         sourceMappingLevel = "normal";
       }
     }
-    const compileOptions = {
-      optimize,
+    let compileOptions = {
+      optimize: minify ? true : optimize ?? false,
+      minify,
       demotionPolicy,
       warningsAsErrors,
       sourceMapping: sourceMappingLevel,
       specVersion
     };
-    const result = metadataFile ? compileToArtifact(wasmBytes, compileOptions) : compileWithDiagnostics(wasmBytes, compileOptions);
+    let compilationBytes = wasmBytes;
+    if (prepare === "auto" || strict) {
+      const prepared = prepareModule(wasmBytes, {
+        ...compileOptions,
+        mode: strict ? "strict" : "integrator"
+      });
+      for (const advisory of prepared.advisories) {
+        console.error(`advisory: ${advisory.message}`);
+      }
+      if (prepared.errors.length > 0) {
+        const first = prepared.errors[0];
+        throw new Error(`${first.code}: ${first.message}`);
+      }
+      compilationBytes = prepared.wasmBytes;
+      compileOptions = prepared.compileOptions;
+    }
+    const result = metadataFile ? compileToArtifact(compilationBytes, compileOptions) : compileWithDiagnostics(compilationBytes, compileOptions);
     printDiagnostics(result.diagnostics, verbose);
     if (!result.ok) {
       const first = result.diagnostics.errors[0];
@@ -164,7 +192,9 @@ ${errorMsg}`);
       const schema = validateGasmMetadataSchema(result.metadata);
       if (!schema.valid) {
         throw new Error(
-          `Generated metadata failed schema validation: ${schema.errors.join(", ")}`
+          `Generated metadata failed schema validation: ${schema.errors.join(
+            ", "
+          )}`
         );
       }
       const resolvedMetadata = resolve(metadataFile);
@@ -182,7 +212,7 @@ ${errorMsg}`);
     }
     if (watOutputFile) {
       if (verbose) console.log("[4a/4] Generating WAT disassembly...");
-      const parseResult = parseWasmModule(wasmBytes);
+      const parseResult = parseWasmModule(compilationBytes);
       if (!isParseError(parseResult)) {
         const watCode = disassembleToWAT(parseResult);
         const resolvedWatOutput = resolve(watOutputFile);
@@ -255,12 +285,13 @@ async function getAssemblyScriptPath() {
 }
 
 // src/cli.ts
-var VERSION = "0.2.0";
+var VERSION = "0.4.0";
 async function main() {
   const args = parseArgs(Deno.args, {
     string: [
       "output",
       "metadata",
+      "prepare",
       "spec-version",
       "wat-output",
       "source-mapping"
@@ -271,6 +302,9 @@ async function main() {
       "verbose",
       "keep-wasm",
       "optimize",
+      "no-optimize",
+      "minify",
+      "strict",
       "deny-f64-demotion",
       "allow-i64-demotion",
       "warnings-as-errors"
@@ -278,7 +312,7 @@ async function main() {
     default: {
       verbose: false,
       "keep-wasm": false,
-      optimize: false
+      minify: false
     }
   });
   if (args.version) {
@@ -303,11 +337,14 @@ async function main() {
       const options = {
         output: args.output,
         metadata: args.metadata,
+        prepare: args.prepare,
+        strict: args.strict,
         specVersion: args["spec-version"],
         watOutput: args["wat-output"],
         verbose: args.verbose,
         keepWasm: args["keep-wasm"],
-        optimize: args.optimize,
+        optimize: Deno.args.includes("--optimize") ? true : Deno.args.includes("--no-optimize") ? false : void 0,
+        minify: args.minify,
         denyF64Demotion: args["deny-f64-demotion"],
         allowI64Demotion: args["allow-i64-demotion"],
         warningsAsErrors: args["warnings-as-errors"],
@@ -347,11 +384,14 @@ COMMANDS:
 OPTIONS:
     --output <file>           Write WGSL output to file (default: stdout)
     --metadata <file>         Write validated Gasm v0.2 metadata sidecar JSON
+    --prepare auto            Infer and inject extensions for transient builds
+    --strict                  Analyze without modifying the input Wasm
     --spec-version <version>  Compile as Gasm 0.1 or 0.2 (default: 0.2)
     --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
+    --minify                  Emit compact, single-line WGSL (enables optimization)
     --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
@@ -372,6 +412,9 @@ EXAMPLES:
     # Compile with optimization
     deno run --allow-all src/cli.ts compile input.wasm --optimize --output output.wgsl
 
+    # Compile minified WGSL
+    deno run --allow-all src/cli.ts compile input.wasm --minify --output output.wgsl
+
 DOCUMENTATION:
     https://github.com/MartinEricsson/gasm-compiler
   `);

package/package.json

@@ -1,16 +1,14 @@
 {
   "name": "@gasm-compiler/cli",
-  "version": "0.2.0",
+  "version": "0.4.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"
     }
@@ -35,7 +33,7 @@
     "cli"
   ],
   "dependencies": {
-    "@gasm-compiler/core": "0.4.0"
+    "@gasm-compiler/core": "0.7.0"
   },
   "devDependencies": {
     "assemblyscript": "v0.28.9",