@onda-lang/wasm-compiler 0.7.5 → 0.8.0

package/dist/build.json

@@ -1,12 +1,12 @@
 {
-  "ondaVersion": "0.7.5",
+  "ondaVersion": "0.8.0",
   "binaryenVersion": "130.0.0",
   "frontendPackage": "onda_compiler_web",
   "frontendOptimization": {
     "tool": "wasm-opt",
     "binaryenVersion": "130.0.0",
     "optimizeLevel": 4,
-    "inputBytes": 8245581,
-    "outputBytes": 6166708
+    "inputBytes": 9547769,
+    "outputBytes": 7075855
   }
 }

package/dist/frontend/README.md

@@ -14,11 +14,14 @@ The package build runs `wasm-pack --release` and then the workspace-pinned Binar
 `wasm-opt -O4`. Its internal `--no-opt` argument only disables wasm-pack's separately bundled
 optimizer so every local, CI, website, and npm build uses the same Binaryen release.
 
-The production exports `compile_to_mir_messagepack(source, sampleRate, blockSize)` and
-`compile_source_workspace_to_mir_messagepack(entryPath, sourcesJson, sampleRate, blockSize)` return a
-`FrontendMessagePackCompilation` containing compact schema-versioned bytes plus the ordered
-contributing project paths. JSON variants return the equivalent `FrontendJsonCompilation` for
-inspection and tooling. Both result types expose the source list and exact portable source image.
+The production exports
+`compile_to_mir_messagepack(source, sampleRate, blockSize, constantsJson)` and
+`compile_source_workspace_to_mir_messagepack(entryPath, sourcesJson, sampleRate, blockSize,
+constantsJson)`. They return a `FrontendMessagePackCompilation` containing compact
+schema-versioned bytes plus the ordered contributing project paths. `constantsJson` is the typed,
+lossless internal transport for immutable `config const` inputs supplied by the public npm package.
+JSON variants return the equivalent `FrontendJsonCompilation` for inspection and tooling. Both
+result types expose the source list and exact portable source image.
 Workspace
 compilation accepts a JSON object of project-relative paths to source strings, resolving imports and
 includes entirely in memory. Paths cannot escape the virtual project root. Embedded

package/dist/frontend/onda_compiler_web.d.ts

@@ -74,15 +74,15 @@ export class WebProjectMaterializationPlan {
 
 export function buffer_asset_format_version(): number;
 
-export function compile_project_image_to_mir_messagepack(image_bytes: Uint8Array, sample_rate: number, block_size: number): FrontendMessagePackCompilation;
+export function compile_project_image_to_mir_messagepack(image_bytes: Uint8Array, sample_rate: number, block_size: number, constants_json: string): FrontendMessagePackCompilation;
 
-export function compile_source_workspace_to_mir_json(entry_path: string, sources_json: string, sample_rate: number, block_size: number): FrontendJsonCompilation;
+export function compile_source_workspace_to_mir_json(entry_path: string, sources_json: string, sample_rate: number, block_size: number, constants_json: string): FrontendJsonCompilation;
 
-export function compile_source_workspace_to_mir_messagepack(entry_path: string, sources_json: string, sample_rate: number, block_size: number): FrontendMessagePackCompilation;
+export function compile_source_workspace_to_mir_messagepack(entry_path: string, sources_json: string, sample_rate: number, block_size: number, constants_json: string): FrontendMessagePackCompilation;
 
-export function compile_to_mir_json(source: string, sample_rate: number, block_size: number): FrontendJsonCompilation;
+export function compile_to_mir_json(source: string, sample_rate: number, block_size: number, constants_json: string): FrontendJsonCompilation;
 
-export function compile_to_mir_messagepack(source: string, sample_rate: number, block_size: number): FrontendMessagePackCompilation;
+export function compile_to_mir_messagepack(source: string, sample_rate: number, block_size: number, constants_json: string): FrontendMessagePackCompilation;
 
 export function current_stdlib_digest(): string;
 
@@ -94,6 +94,12 @@ export function encode_buffer_asset(element: string, frames: number, channels: n
 
 export function inspect_project_image(image_bytes: Uint8Array): string;
 
+export function inspect_project_image_compile_constants(image_bytes: Uint8Array, sample_rate: number, block_size: number, constants_json: string): string;
+
+export function inspect_source_compile_constants(source: string, sample_rate: number, block_size: number, constants_json: string): string;
+
+export function inspect_source_workspace_compile_constants(entry_path: string, sources_json: string, sample_rate: number, block_size: number, constants_json: string): string;
+
 export function materialize_project_image(image_bytes: Uint8Array, asset_file_names_json: string): WebProjectMaterializationPlan;
 
 export function mir_schema_version(): number;
@@ -112,11 +118,11 @@ export interface InitOutput {
     readonly __wbg_webprojectimagebuilder_free: (a: number, b: number) => void;
     readonly __wbg_webprojectmaterializationplan_free: (a: number, b: number) => void;
     readonly buffer_asset_format_version: () => number;
-    readonly compile_project_image_to_mir_messagepack: (a: number, b: number, c: number, d: number) => [number, number, number];
-    readonly compile_source_workspace_to_mir_json: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number];
-    readonly compile_source_workspace_to_mir_messagepack: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number];
-    readonly compile_to_mir_json: (a: number, b: number, c: number, d: number) => [number, number, number];
-    readonly compile_to_mir_messagepack: (a: number, b: number, c: number, d: number) => [number, number, number];
+    readonly compile_project_image_to_mir_messagepack: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number];
+    readonly compile_source_workspace_to_mir_json: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => [number, number, number];
+    readonly compile_source_workspace_to_mir_messagepack: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => [number, number, number];
+    readonly compile_to_mir_json: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number];
+    readonly compile_to_mir_messagepack: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number];
     readonly current_stdlib_digest: () => [number, number];
     readonly decode_buffer_asset: (a: number, b: number) => [number, number, number];
     readonly decode_buffer_file: (a: number, b: number, c: number, d: number) => [number, number, number];
@@ -127,11 +133,15 @@ export interface InitOutput {
     readonly frontendmessagepackcompilation_source_files_json: (a: number) => [number, number];
     readonly frontendmessagepackcompilation_source_image_json: (a: number) => [number, number];
     readonly inspect_project_image: (a: number, b: number) => [number, number, number, number];
+    readonly inspect_project_image_compile_constants: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
+    readonly inspect_source_compile_constants: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
+    readonly inspect_source_workspace_compile_constants: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => [number, number, number, number];
     readonly materialize_project_image: (a: number, b: number, c: number, d: number) => [number, number, number];
     readonly mir_schema_version: () => number;
     readonly ondalsp_handle_message: (a: number, b: number, c: number) => [number, number, number, number];
     readonly ondalsp_new: () => number;
     readonly ondalsp_set_analysis_options: (a: number, b: number, c: number) => [number, number];
+    readonly project_image_format_version: () => number;
     readonly webdecodedbufferasset_canonical_payload: (a: number) => [number, number];
     readonly webdecodedbufferasset_channels: (a: number) => number;
     readonly webdecodedbufferasset_element: (a: number) => [number, number];
@@ -148,12 +158,11 @@ export interface InitOutput {
     readonly webprojectmaterializationplan_file_bytes: (a: number, b: number) => [number, number];
     readonly webprojectmaterializationplan_file_count: (a: number) => number;
     readonly webprojectmaterializationplan_file_path: (a: number, b: number) => [number, number];
-    readonly project_image_format_version: () => number;
     readonly frontendmessagepackcompilation_take_mir: (a: number) => [number, number];
     readonly __wbindgen_externrefs: WebAssembly.Table;
     readonly __wbindgen_malloc: (a: number, b: number) => number;
-    readonly __externref_table_dealloc: (a: number) => void;
     readonly __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
+    readonly __externref_table_dealloc: (a: number) => void;
     readonly __wbindgen_free: (a: number, b: number, c: number) => void;
     readonly __wbindgen_start: () => void;
 }

package/dist/frontend/onda_compiler_web.js

@@ -443,12 +443,15 @@ export function buffer_asset_format_version() {
  * @param {Uint8Array} image_bytes
  * @param {number} sample_rate
  * @param {number} block_size
+ * @param {string} constants_json
  * @returns {FrontendMessagePackCompilation}
  */
-export function compile_project_image_to_mir_messagepack(image_bytes, sample_rate, block_size) {
+export function compile_project_image_to_mir_messagepack(image_bytes, sample_rate, block_size, constants_json) {
     const ptr0 = passArray8ToWasm0(image_bytes, wasm.__wbindgen_malloc);
     const len0 = WASM_VECTOR_LEN;
-    const ret = wasm.compile_project_image_to_mir_messagepack(ptr0, len0, sample_rate, block_size);
+    const ptr1 = passStringToWasm0(constants_json, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len1 = WASM_VECTOR_LEN;
+    const ret = wasm.compile_project_image_to_mir_messagepack(ptr0, len0, sample_rate, block_size, ptr1, len1);
     if (ret[2]) {
         throw takeFromExternrefTable0(ret[1]);
     }
@@ -460,14 +463,17 @@ export function compile_project_image_to_mir_messagepack(image_bytes, sample_rat
  * @param {string} sources_json
  * @param {number} sample_rate
  * @param {number} block_size
+ * @param {string} constants_json
  * @returns {FrontendJsonCompilation}
  */
-export function compile_source_workspace_to_mir_json(entry_path, sources_json, sample_rate, block_size) {
+export function compile_source_workspace_to_mir_json(entry_path, sources_json, sample_rate, block_size, constants_json) {
     const ptr0 = passStringToWasm0(entry_path, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
     const len0 = WASM_VECTOR_LEN;
     const ptr1 = passStringToWasm0(sources_json, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
     const len1 = WASM_VECTOR_LEN;
-    const ret = wasm.compile_source_workspace_to_mir_json(ptr0, len0, ptr1, len1, sample_rate, block_size);
+    const ptr2 = passStringToWasm0(constants_json, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len2 = WASM_VECTOR_LEN;
+    const ret = wasm.compile_source_workspace_to_mir_json(ptr0, len0, ptr1, len1, sample_rate, block_size, ptr2, len2);
     if (ret[2]) {
         throw takeFromExternrefTable0(ret[1]);
     }
@@ -479,14 +485,17 @@ export function compile_source_workspace_to_mir_json(entry_path, sources_json, s
  * @param {string} sources_json
  * @param {number} sample_rate
  * @param {number} block_size
+ * @param {string} constants_json
  * @returns {FrontendMessagePackCompilation}
  */
-export function compile_source_workspace_to_mir_messagepack(entry_path, sources_json, sample_rate, block_size) {
+export function compile_source_workspace_to_mir_messagepack(entry_path, sources_json, sample_rate, block_size, constants_json) {
     const ptr0 = passStringToWasm0(entry_path, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
     const len0 = WASM_VECTOR_LEN;
     const ptr1 = passStringToWasm0(sources_json, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
     const len1 = WASM_VECTOR_LEN;
-    const ret = wasm.compile_source_workspace_to_mir_messagepack(ptr0, len0, ptr1, len1, sample_rate, block_size);
+    const ptr2 = passStringToWasm0(constants_json, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len2 = WASM_VECTOR_LEN;
+    const ret = wasm.compile_source_workspace_to_mir_messagepack(ptr0, len0, ptr1, len1, sample_rate, block_size, ptr2, len2);
     if (ret[2]) {
         throw takeFromExternrefTable0(ret[1]);
     }
@@ -497,12 +506,15 @@ export function compile_source_workspace_to_mir_messagepack(entry_path, sources_
  * @param {string} source
  * @param {number} sample_rate
  * @param {number} block_size
+ * @param {string} constants_json
  * @returns {FrontendJsonCompilation}
  */
-export function compile_to_mir_json(source, sample_rate, block_size) {
+export function compile_to_mir_json(source, sample_rate, block_size, constants_json) {
     const ptr0 = passStringToWasm0(source, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
     const len0 = WASM_VECTOR_LEN;
-    const ret = wasm.compile_to_mir_json(ptr0, len0, sample_rate, block_size);
+    const ptr1 = passStringToWasm0(constants_json, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len1 = WASM_VECTOR_LEN;
+    const ret = wasm.compile_to_mir_json(ptr0, len0, sample_rate, block_size, ptr1, len1);
     if (ret[2]) {
         throw takeFromExternrefTable0(ret[1]);
     }
@@ -513,12 +525,15 @@ export function compile_to_mir_json(source, sample_rate, block_size) {
  * @param {string} source
  * @param {number} sample_rate
  * @param {number} block_size
+ * @param {string} constants_json
  * @returns {FrontendMessagePackCompilation}
  */
-export function compile_to_mir_messagepack(source, sample_rate, block_size) {
+export function compile_to_mir_messagepack(source, sample_rate, block_size, constants_json) {
     const ptr0 = passStringToWasm0(source, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
     const len0 = WASM_VECTOR_LEN;
-    const ret = wasm.compile_to_mir_messagepack(ptr0, len0, sample_rate, block_size);
+    const ptr1 = passStringToWasm0(constants_json, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len1 = WASM_VECTOR_LEN;
+    const ret = wasm.compile_to_mir_messagepack(ptr0, len0, sample_rate, block_size, ptr1, len1);
     if (ret[2]) {
         throw takeFromExternrefTable0(ret[1]);
     }
@@ -619,6 +634,99 @@ export function inspect_project_image(image_bytes) {
     }
 }
 
+/**
+ * @param {Uint8Array} image_bytes
+ * @param {number} sample_rate
+ * @param {number} block_size
+ * @param {string} constants_json
+ * @returns {string}
+ */
+export function inspect_project_image_compile_constants(image_bytes, sample_rate, block_size, constants_json) {
+    let deferred4_0;
+    let deferred4_1;
+    try {
+        const ptr0 = passArray8ToWasm0(image_bytes, wasm.__wbindgen_malloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passStringToWasm0(constants_json, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len1 = WASM_VECTOR_LEN;
+        const ret = wasm.inspect_project_image_compile_constants(ptr0, len0, sample_rate, block_size, ptr1, len1);
+        var ptr3 = ret[0];
+        var len3 = ret[1];
+        if (ret[3]) {
+            ptr3 = 0; len3 = 0;
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        deferred4_0 = ptr3;
+        deferred4_1 = len3;
+        return getStringFromWasm0(ptr3, len3);
+    } finally {
+        wasm.__wbindgen_free(deferred4_0, deferred4_1, 1);
+    }
+}
+
+/**
+ * @param {string} source
+ * @param {number} sample_rate
+ * @param {number} block_size
+ * @param {string} constants_json
+ * @returns {string}
+ */
+export function inspect_source_compile_constants(source, sample_rate, block_size, constants_json) {
+    let deferred4_0;
+    let deferred4_1;
+    try {
+        const ptr0 = passStringToWasm0(source, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passStringToWasm0(constants_json, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len1 = WASM_VECTOR_LEN;
+        const ret = wasm.inspect_source_compile_constants(ptr0, len0, sample_rate, block_size, ptr1, len1);
+        var ptr3 = ret[0];
+        var len3 = ret[1];
+        if (ret[3]) {
+            ptr3 = 0; len3 = 0;
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        deferred4_0 = ptr3;
+        deferred4_1 = len3;
+        return getStringFromWasm0(ptr3, len3);
+    } finally {
+        wasm.__wbindgen_free(deferred4_0, deferred4_1, 1);
+    }
+}
+
+/**
+ * @param {string} entry_path
+ * @param {string} sources_json
+ * @param {number} sample_rate
+ * @param {number} block_size
+ * @param {string} constants_json
+ * @returns {string}
+ */
+export function inspect_source_workspace_compile_constants(entry_path, sources_json, sample_rate, block_size, constants_json) {
+    let deferred5_0;
+    let deferred5_1;
+    try {
+        const ptr0 = passStringToWasm0(entry_path, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passStringToWasm0(sources_json, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len1 = WASM_VECTOR_LEN;
+        const ptr2 = passStringToWasm0(constants_json, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len2 = WASM_VECTOR_LEN;
+        const ret = wasm.inspect_source_workspace_compile_constants(ptr0, len0, ptr1, len1, sample_rate, block_size, ptr2, len2);
+        var ptr4 = ret[0];
+        var len4 = ret[1];
+        if (ret[3]) {
+            ptr4 = 0; len4 = 0;
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        deferred5_0 = ptr4;
+        deferred5_1 = len4;
+        return getStringFromWasm0(ptr4, len4);
+    } finally {
+        wasm.__wbindgen_free(deferred5_0, deferred5_1, 1);
+    }
+}
+
 /**
  * @param {Uint8Array} image_bytes
  * @param {string} asset_file_names_json

package/dist/frontend/onda_compiler_web_bg.wasm.d.ts

@@ -9,11 +9,11 @@ export const __wbg_webmaterializedprojectbuilder_free: (a: number, b: number) =>
 export const __wbg_webprojectimagebuilder_free: (a: number, b: number) => void;
 export const __wbg_webprojectmaterializationplan_free: (a: number, b: number) => void;
 export const buffer_asset_format_version: () => number;
-export const compile_project_image_to_mir_messagepack: (a: number, b: number, c: number, d: number) => [number, number, number];
-export const compile_source_workspace_to_mir_json: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number];
-export const compile_source_workspace_to_mir_messagepack: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number];
-export const compile_to_mir_json: (a: number, b: number, c: number, d: number) => [number, number, number];
-export const compile_to_mir_messagepack: (a: number, b: number, c: number, d: number) => [number, number, number];
+export const compile_project_image_to_mir_messagepack: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number];
+export const compile_source_workspace_to_mir_json: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => [number, number, number];
+export const compile_source_workspace_to_mir_messagepack: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => [number, number, number];
+export const compile_to_mir_json: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number];
+export const compile_to_mir_messagepack: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number];
 export const current_stdlib_digest: () => [number, number];
 export const decode_buffer_asset: (a: number, b: number) => [number, number, number];
 export const decode_buffer_file: (a: number, b: number, c: number, d: number) => [number, number, number];
@@ -24,11 +24,15 @@ export const frontendjsoncompilation_take_mir: (a: number) => [number, number];
 export const frontendmessagepackcompilation_source_files_json: (a: number) => [number, number];
 export const frontendmessagepackcompilation_source_image_json: (a: number) => [number, number];
 export const inspect_project_image: (a: number, b: number) => [number, number, number, number];
+export const inspect_project_image_compile_constants: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
+export const inspect_source_compile_constants: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
+export const inspect_source_workspace_compile_constants: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => [number, number, number, number];
 export const materialize_project_image: (a: number, b: number, c: number, d: number) => [number, number, number];
 export const mir_schema_version: () => number;
 export const ondalsp_handle_message: (a: number, b: number, c: number) => [number, number, number, number];
 export const ondalsp_new: () => number;
 export const ondalsp_set_analysis_options: (a: number, b: number, c: number) => [number, number];
+export const project_image_format_version: () => number;
 export const webdecodedbufferasset_canonical_payload: (a: number) => [number, number];
 export const webdecodedbufferasset_channels: (a: number) => number;
 export const webdecodedbufferasset_element: (a: number) => [number, number];
@@ -45,11 +49,10 @@ export const webprojectmaterializationplan_directories_json: (a: number) => [num
 export const webprojectmaterializationplan_file_bytes: (a: number, b: number) => [number, number];
 export const webprojectmaterializationplan_file_count: (a: number) => number;
 export const webprojectmaterializationplan_file_path: (a: number, b: number) => [number, number];
-export const project_image_format_version: () => number;
 export const frontendmessagepackcompilation_take_mir: (a: number) => [number, number];
 export const __wbindgen_externrefs: WebAssembly.Table;
 export const __wbindgen_malloc: (a: number, b: number) => number;
-export const __externref_table_dealloc: (a: number) => void;
 export const __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
+export const __externref_table_dealloc: (a: number) => void;
 export const __wbindgen_free: (a: number, b: number, c: number) => void;
 export const __wbindgen_start: () => void;

package/dist/frontend/package.json

@@ -5,7 +5,7 @@
     "onda contributors"
   ],
   "description": "Browser-safe Onda source-to-MIR compiler",
-  "version": "0.7.5",
+  "version": "0.8.0",
   "license": "MIT",
   "repository": {
     "type": "git",

package/dist/version.js

@@ -1 +1 @@
-export const ONDA_VERSION = "0.7.5";
+export const ONDA_VERSION = "0.8.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onda-lang/wasm-compiler",
-  "version": "0.7.5",
+  "version": "0.8.0",
   "type": "module",
   "description": "Onda source-to-WebAssembly compiler for browsers and Node.js",
   "license": "MIT",
@@ -44,6 +44,7 @@
     "bin",
     "dist",
     "src",
+    "api.md",
     "LICENSE",
     "README.md",
     "THIRD_PARTY_NOTICES.md"
@@ -54,12 +55,12 @@
     "check:versions": "node ../../scripts/sync-package-versions.mjs --check",
     "test": "npm run build && npm run test:built",
     "test:built": "node --test ./test/*.test.js",
-    "test:pack": "node ./scripts/test-package.mjs",
-    "test:pack:built": "node ./scripts/test-package.mjs --skip-build",
-    "prepack": "npm run build"
+    "test:pack": "node ../../scripts/stage-web-api-docs.mjs && node ./scripts/test-package.mjs",
+    "test:pack:built": "node ../../scripts/stage-web-api-docs.mjs && node ./scripts/test-package.mjs --skip-build",
+    "prepack": "npm run build && node ../../scripts/stage-web-api-docs.mjs"
   },
   "dependencies": {
-    "@onda-lang/processor-abi": "0.7.5",
+    "@onda-lang/processor-abi": "0.8.0",
     "binaryen": "130.0.0"
   },
   "publishConfig": {

package/src/index.d.ts

@@ -47,9 +47,56 @@ export interface OndaCodegenOptions {
 export interface OndaCompileOptions {
   sampleRate?: number;
   blockSize?: number;
+  constants?: Map<string, OndaCompileConstValue>
+    | Record<string, OndaCompileConstValue>;
   codegen?: OndaCodegenOptions;
 }
 
+export interface OndaCompileConstInspectionOptions {
+  sampleRate?: number;
+  blockSize?: number;
+  /** Optional partial overrides; omitted declarations retain their authored values. */
+  constants?: Map<string, OndaCompileConstValue>
+    | Record<string, OndaCompileConstValue>;
+}
+
+export interface OndaLspAnalysisOptions {
+  sampleRate?: number;
+  blockSize?: number;
+}
+
+export type OndaCompileConstValue =
+  | boolean
+  | number
+  | bigint
+  | boolean[]
+  | Uint8Array
+  | Int32Array
+  | BigInt64Array
+  | Float32Array
+  | Float64Array;
+
+export type OndaCompileConstElement = "bool" | "i32" | "i64" | "f32" | "f64";
+export type OndaCompileConstKind = "scalar" | "fixed-array" | "array";
+export type OndaResolvedCompileConstValue =
+  | boolean
+  | number
+  | bigint
+  | Uint8Array
+  | Int32Array
+  | BigInt64Array
+  | Float32Array
+  | Float64Array;
+
+export interface OndaCompileConstDescriptor {
+  name: string;
+  element: OndaCompileConstElement;
+  kind: OndaCompileConstKind;
+  /** One for scalars; the resolved length for either array kind. */
+  elementCount: number;
+  value: OndaResolvedCompileConstValue;
+}
+
 export interface OndaSourceWorkspace {
   entry: string;
   sources: Record<string, string>;
@@ -141,14 +188,26 @@ export interface OndaCompilerInstance {
     source: string,
     options?: OndaCompileOptions,
   ): Promise<OndaCompilationResult>;
+  inspectSourceConstants(
+    source: string,
+    options?: OndaCompileConstInspectionOptions,
+  ): Promise<OndaCompileConstDescriptor[]>;
   compileWorkspace(
     workspace: OndaSourceWorkspace,
     options?: OndaCompileOptions,
   ): Promise<OndaCompilationResult>;
+  inspectWorkspaceConstants(
+    workspace: OndaSourceWorkspace,
+    options?: OndaCompileConstInspectionOptions,
+  ): Promise<OndaCompileConstDescriptor[]>;
   compileProjectImage(
     imageBytes: ArrayBuffer | ArrayBufferView,
     options?: OndaCompileOptions,
   ): Promise<OndaCompilationResult>;
+  inspectProjectImageConstants(
+    imageBytes: ArrayBuffer | ArrayBufferView,
+    options?: OndaCompileConstInspectionOptions,
+  ): Promise<OndaCompileConstDescriptor[]>;
   createProjectImage(
     sourceGraph: OndaSourceGraph,
     buffers?: Map<string, ArrayBuffer | ArrayBufferView>
@@ -174,7 +233,8 @@ export interface OndaCompilerInstance {
   ): Promise<OndaBufferAssetBinding>;
   projectCapabilities(): Promise<OndaProjectCapabilities>;
   sendLspMessage(message: OndaLspMessage): Promise<OndaLspMessage[]>;
-  setLspAnalysisOptions(options?: OndaCompileOptions): Promise<void>;
+  setLspAnalysisOptions(options?: OndaLspAnalysisOptions): Promise<void>;
+  /** Idempotently releases compiler resources. All subsequent operations reject. */
   dispose(): Promise<void>;
 }