@hew-lang/wasm 0.6.2 → 0.6.3

package/README.md

@@ -28,7 +28,10 @@ The package exports JSON-string APIs for the current developer-tooling surface:
   `code_actions`, and `get_keywords`.
 
 Diagnostics include stable `phase`, `kind`, nested `span`, `message`, `notes`,
-and `suggestions` fields. The legacy `start_offset` / `end_offset` fields remain
+and `suggestions` fields, plus `source_hash` and producer-owned `fixes` (title,
+applicability and byte-range edits). Pass diagnostics unchanged to `code_actions`;
+human suggestions are prose. Stale snapshots and imported origins do not produce
+root-buffer edits. The legacy `start_offset` / `end_offset` fields remain
 for existing browser bridges.
 
 ## Compilation and execution
@@ -40,6 +43,34 @@ projection of that SIR, including ownership transfers, cleanup edges, actor
 protocols and suspension points. The historical target argument is retained for
 browser callers; it does not select a separate source-language profile.
 
+`compileProjectToSandboxBytecode(requestJson, "sandbox-vm-export")` compiles
+named documents through that same frontend. The request supplies an entry and
+UTF-8 files, including ordinary package manifests when imports use package roots:
+
+```js
+const request = {
+  entry: "main.hew",
+  files: [
+    {
+      path: "main.hew",
+      source: "import user.nav; fn main() { println(nav.go()); }",
+    },
+    { path: "user/hew.toml", source: '[package]\nname = "user"\n' },
+    { path: "user/nav.hew", source: 'pub fn go() -> string { "MOVE" }' },
+  ],
+};
+const compiled = JSON.parse(
+  compileProjectToSandboxBytecode(JSON.stringify(request)),
+);
+```
+
+The response adds `resolved_files`: the sorted, unique entry and transitively
+read supplied `.hew` sources. Unused documents, manifests and embedded standard
+library sources are excluded. Diagnostics and their notes retain project-relative
+file identity and file-local UTF-8 offsets. Paths stay inside the supplied project;
+the embedded standard library cannot be replaced and missing files never read
+the host filesystem. Native package and directory-module rules apply.
+
 Execute the package with `runBytecode` from `@hew-lang/sandbox-vm`. Its loader
 admits the package's declared operations before running any instruction. A
 refusal distinguishes `native_only`, `not_implemented` and `invalid_package`.

package/package.json

@@ -2,7 +2,7 @@
   "name": "@hew-lang/wasm",
   "type": "module",
   "description": "WebAssembly bindings for Hew analysis and verified sandbox compilation",
-  "version": "0.6.2",
+  "version": "0.6.3",
   "license": "MIT OR Apache-2.0",
   "repository": {
     "type": "git",
@@ -26,8 +26,8 @@
     "webassembly"
   ],
   "hewSource": {
-    "commit": "dd0911184af12136eda7e89052e5b564d56ba643",
-    "tag": "v0.6.2",
+    "commit": "97c1d865aa46afca1c75cf8ef2c1ea0d7f232471",
+    "tag": "v0.6.3",
     "dirty": false
   },
   "publishConfig": {

package/wasm.d.ts

@@ -14,7 +14,8 @@ export function analyze(source: string, files?: Map<any, any> | null): string;
  * Get code actions for given diagnostics JSON. Returns JSON array of `CodeAction`.
  *
  * `diagnostics_json` should be a JSON array of `DiagnosticInfo` objects:
- * `[{ "kind": "UndefinedVariable", "message": "...", "span": { "start": 0, "end": 5 }, "suggestions": [] }]`
+ * Each object carries the `source_hash` and producer-owned `fixes` from
+ * `analyze` or `parse_source`. Stale source snapshots produce no actions.
  *
  * # Errors
  *
@@ -23,6 +24,14 @@ export function analyze(source: string, files?: Map<any, any> | null): string;
  */
 export function code_actions(source: string, diagnostics_json: string): string;
 
+/**
+ * Compile named browser documents through the canonical source graph.
+ *
+ * # Panics
+ * Panics if the compiler output cannot be serialized as JSON.
+ */
+export function compileProjectToSandboxBytecode(request: string, profile?: string | null): string;
+
 /**
  * Compile every test in one editor buffer once, returning one selected VM
  * package per discovered declaration. The browser chooses the package by its
@@ -66,6 +75,12 @@ export function complete(source: string, offset: number): string;
  */
 export function document_symbols(source: string): string;
 
+/**
+ * Execute a pure checked calendar operation. Integers cross JSON as decimal
+ * strings so the timestamp's full seconds range never passes through f64.
+ */
+export function executeCalendar(request: string): string;
+
 /**
  * Execute the compiler's typed codec plan using the shared native engine.
  */
@@ -212,10 +227,12 @@ export interface InitOutput {
     readonly memory: WebAssembly.Memory;
     readonly analyze: (a: number, b: number, c: number, d: number) => void;
     readonly code_actions: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly compileProjectToSandboxBytecode: (a: number, b: number, c: number, d: number, e: number) => void;
     readonly compileTestsToSandboxBytecode: (a: number, b: number, c: number, d: number, e: number) => void;
     readonly compileToSandboxBytecode: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
     readonly complete: (a: number, b: number, c: number, d: number) => void;
     readonly document_symbols: (a: number, b: number, c: number) => void;
+    readonly executeCalendar: (a: number, b: number, c: number) => void;
     readonly executeCodec: (a: number, b: number, c: number) => void;
     readonly expand_macro: (a: number, b: number, c: number, d: number) => void;
     readonly find_references: (a: number, b: number, c: number, d: number) => void;

package/wasm.js

@@ -41,7 +41,8 @@ export function analyze(source, files) {
  * Get code actions for given diagnostics JSON. Returns JSON array of `CodeAction`.
  *
  * `diagnostics_json` should be a JSON array of `DiagnosticInfo` objects:
- * `[{ "kind": "UndefinedVariable", "message": "...", "span": { "start": 0, "end": 5 }, "suggestions": [] }]`
+ * Each object carries the `source_hash` and producer-owned `fixes` from
+ * `analyze` or `parse_source`. Stale source snapshots produce no actions.
  *
  * # Errors
  *
@@ -80,6 +81,36 @@ export function code_actions(source, diagnostics_json) {
     }
 }
 
+/**
+ * Compile named browser documents through the canonical source graph.
+ *
+ * # Panics
+ * Panics if the compiler output cannot be serialized as JSON.
+ * @param {string} request
+ * @param {string | null} [profile]
+ * @returns {string}
+ */
+export function compileProjectToSandboxBytecode(request, profile) {
+    let deferred3_0;
+    let deferred3_1;
+    try {
+        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+        const ptr0 = passStringToWasm0(request, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+        const len0 = WASM_VECTOR_LEN;
+        var ptr1 = isLikeNone(profile) ? 0 : passStringToWasm0(profile, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+        var len1 = WASM_VECTOR_LEN;
+        wasm.compileProjectToSandboxBytecode(retptr, ptr0, len0, ptr1, len1);
+        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+        deferred3_0 = r0;
+        deferred3_1 = r1;
+        return getStringFromWasm0(r0, r1);
+    } finally {
+        wasm.__wbindgen_add_to_stack_pointer(16);
+        wasm.__wbindgen_export4(deferred3_0, deferred3_1, 1);
+    }
+}
+
 /**
  * Compile every test in one editor buffer once, returning one selected VM
  * package per discovered declaration. The browser chooses the package by its
@@ -223,6 +254,31 @@ export function document_symbols(source) {
     }
 }
 
+/**
+ * Execute a pure checked calendar operation. Integers cross JSON as decimal
+ * strings so the timestamp's full seconds range never passes through f64.
+ * @param {string} request
+ * @returns {string}
+ */
+export function executeCalendar(request) {
+    let deferred2_0;
+    let deferred2_1;
+    try {
+        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+        const ptr0 = passStringToWasm0(request, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+        const len0 = WASM_VECTOR_LEN;
+        wasm.executeCalendar(retptr, ptr0, len0);
+        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+        deferred2_0 = r0;
+        deferred2_1 = r1;
+        return getStringFromWasm0(r0, r1);
+    } finally {
+        wasm.__wbindgen_add_to_stack_pointer(16);
+        wasm.__wbindgen_export4(deferred2_0, deferred2_1, 1);
+    }
+}
+
 /**
  * Execute the compiler's typed codec plan using the shared native engine.
  * @param {string} request