@asm198x/z80 0.1.0 → 0.3.0

package/asm198x_web.d.ts

@@ -19,6 +19,24 @@ export function assemble(dialect: string, source: string): string | undefined;
  */
 export function dialects(): string;
 
+/**
+ * Where the assembled program sits in memory, as JSON.
+ *
+ * `{"origin": 32768, "length": 11}` — the load address and the number of
+ * bytes, which together are the range the program occupies.
+ *
+ * A page running a reader's code needs this to tell whether the machine is
+ * still executing that code. A program that runs past its own last
+ * instruction has a program counter outside this range, which is the
+ * difference between "the machine stopped" and "your program ran off the end
+ * — that is what the `halt` at the bottom prevents".
+ *
+ * `origin` is `null` for a linked image whose bytes are the linker's, with no
+ * single meaningful load address. `null` overall when the dialect is unknown
+ * or the source does not assemble — [`assemble`] says why.
+ */
+export function extent(dialect: string, source: string): string | undefined;
+
 /**
  * The `--listing` rendering of `source` in `dialect`: address, bytes, and
  * source per line. `null` when the dialect is unknown or the source does not
@@ -65,6 +83,7 @@ export interface InitOutput {
     readonly memory: WebAssembly.Memory;
     readonly assemble: (a: number, b: number, c: number, d: number) => [number, number];
     readonly dialects: () => [number, number];
+    readonly extent: (a: number, b: number, c: number, d: number) => [number, number];
     readonly listing: (a: number, b: number, c: number, d: number) => [number, number];
     readonly snapshot: (a: number, b: number, c: number, d: number) => [number, number];
     readonly tape: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => [number, number];

package/asm198x_web.js

@@ -45,6 +45,39 @@ export function dialects() {
     }
 }
 
+/**
+ * Where the assembled program sits in memory, as JSON.
+ *
+ * `{"origin": 32768, "length": 11}` — the load address and the number of
+ * bytes, which together are the range the program occupies.
+ *
+ * A page running a reader's code needs this to tell whether the machine is
+ * still executing that code. A program that runs past its own last
+ * instruction has a program counter outside this range, which is the
+ * difference between "the machine stopped" and "your program ran off the end
+ * — that is what the `halt` at the bottom prevents".
+ *
+ * `origin` is `null` for a linked image whose bytes are the linker's, with no
+ * single meaningful load address. `null` overall when the dialect is unknown
+ * or the source does not assemble — [`assemble`] says why.
+ * @param {string} dialect
+ * @param {string} source
+ * @returns {string | undefined}
+ */
+export function extent(dialect, source) {
+    const ptr0 = passStringToWasm0(dialect, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ptr1 = passStringToWasm0(source, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len1 = WASM_VECTOR_LEN;
+    const ret = wasm.extent(ptr0, len0, ptr1, len1);
+    let v3;
+    if (ret[0] !== 0) {
+        v3 = getStringFromWasm0(ret[0], ret[1]);
+        wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
+    }
+    return v3;
+}
+
 /**
  * The `--listing` rendering of `source` in `dialect`: address, bytes, and
  * source per line. `null` when the dialect is unknown or the source does not

package/package.json

@@ -2,7 +2,7 @@
   "name": "@asm198x/z80",
   "type": "module",
   "description": "asm198x assembler for z80, compiled to WebAssembly.",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "license": "GPL-2.0-or-later",
   "repository": {
     "type": "git",