@gasm-compiler/core 0.3.2 → 0.4.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

@@ -4,7 +4,8 @@
 
 Transform WebAssembly binaries into WGSL (WebGPU Shading Language) compute shaders. Write your GPU kernels in any language that compiles to WebAssembly (C, C++, Rust, Go, AssemblyScript, or hand-written WAT), then run them on the GPU via WebGPU.
 
-Implements the [Gasm v0.1 specification](https://github.com/gasm-compiler/spec) — a GPU-executable subset of WebAssembly.
+Gasm v0.2 is the default through the Rust/Wasm compiler backend. Archived
+Gasm v0.1 behavior remains available through an explicit compatibility option.
 
 ---
 
@@ -49,6 +50,69 @@ const shaderModule = device.createShaderModule({ code: wgslCode });
 
 ## Usage
 
+### Specification Versions
+
+Gasm v0.2 is the default:
+
+```typescript
+const wgsl = compile(wasmBytes);
+```
+
+The default enables strict v0.2 validation and lowering. Existing consumers can
+keep the archived v0.1 compiler behavior explicitly:
+
+```typescript
+const wgsl = compile(wasmBytes, { specVersion: "0.1" });
+```
+
+Compile a v0.2 artifact and metadata sidecar through the Rust/Wasm compiler:
+
+```typescript
+import {
+  compileToArtifact,
+  validateGasmMetadataSchema,
+} from "@gasm-compiler/core";
+
+const result = compileToArtifact(wasmBytes);
+if (!result.ok) {
+  throw new Error(
+    `${result.diagnostics.errors[0]?.code}: ` +
+      `${result.diagnostics.errors[0]?.message}`,
+  );
+}
+
+const schema = validateGasmMetadataSchema(result.metadata);
+if (!schema.valid) throw new Error(schema.errors.join(", "));
+```
+
+Gasm v0.2 semantics are implemented only in `packages/core-rs` and distributed
+through its Wasm artifact. The TypeScript compiler implementation is retained
+at v0.1 for compatibility. Deno remains the runtime for the CLI and the live
+core/CLI test suites, including headless WebGPU execution.
+
+The CLI also defaults to v0.2:
+
+```bash
+gasm-compiler compile input.wasm \
+  --output output.wgsl \
+  --metadata output.gasm.json
+```
+
+Use `--spec-version 0.1` when compiling archived v0.1 inputs.
+
+#### Migrating from 0.3.x
+
+- Compilation now defaults to strict Gasm v0.2 validation.
+- Pass `{ specVersion: "0.1" }` to retain archived v0.1 behavior.
+- Gasm v0.2 extensions must be declared in the module's
+  `gasm.extensions` custom section.
+- Math extension scalar imports use explicit type suffixes such as
+  `sin_f32`. Legacy unsuffixed imports remain accepted for compatibility.
+
+Required extensions are declared by the module's `gasm.extensions` custom
+section. The CLI does not inject extensions, so validation reflects the exact
+module that will be distributed.
+
 ### Basic Compilation
 
 ```typescript
@@ -82,7 +146,10 @@ const wgslCode = compile(wasmBytes, {
 });
 ```
 
-When enabled, WebAssembly imports like `(import "gasm" "sin" (func ...))` compile to direct WGSL built-in calls (`sin(...)`) with zero overhead.
+When enabled, WebAssembly imports like
+`(import "gasm" "sin_f32" (func ...))` compile to direct WGSL built-in calls
+(`sin(...)`) with zero overhead. Unsuffixed scalar names such as `sin` remain
+accepted as legacy aliases.
 
 **Math Levels:**
 - **M0 (Core):** sin, cos, sqrt, abs, min, max, clamp, floor, ceil, etc.

package/dist/browser.d.ts

@@ -1,5 +1,5 @@
-import { C as CompileDiagnostics, D as DispatchInfo$1, a as CompileOptions } from './error_codes-D6RsiZ33.js';
-export { b as CompileError, h as ErrorCode, E as ErrorCodes, c as SPEC_VERSION_V01, d as SPEC_VERSION_V02, S as SpecVersion, e as isCompileError, g as isParseError, i as isV02Mode, f as parseWasmModule, r as resolveSpecVersion } from './error_codes-D6RsiZ33.js';
+import { a as CompileDiagnostics, D as DispatchInfo$1, C as CompileOptions } from './error_codes-Cdy_3FNo.js';
+export { b as CompileError, c as DEFAULT_SPEC_VERSION, j as ErrorCode, E as ErrorCodes, d as SPEC_VERSION_V01, e as SPEC_VERSION_V02, S as SpecVersion, f as isCompileError, h as isParseError, i as isV02Mode, g as parseWasmModule, r as resolveSpecVersion } from './error_codes-Cdy_3FNo.js';
 export { BrowserGPUExecutor } from './browser-executor.js';
 export { BufferData, ExecuteOptions, ExecutionError, ExecutorConfig, IGPUExecutor, OutputBufferSpec, isExecutionError } from './executor.js';