@quarb/wasm 0.13.0 → 0.16.0

package/README.md

@@ -3,7 +3,9 @@
 [Quarb](https://quarb.org) — the arboreal query engine —
 compiled to WebAssembly, with TypeScript types. One path
 language over JSON, YAML, TOML, CSV/TSV, XML, HTML, and
-Markdown, running entirely client-side: no server, no native
+Markdown — including the text-level reading of HTML, Markdown,
+and plain text (sections, paragraphs, quotes, lists) — running
+entirely client-side: no server, no native
 dependency, the same engine that powers the
 [playground](https://demo.quarb.org) and the Quarb Scraper
 browser extension.

package/index.d.ts

@@ -9,7 +9,10 @@ export type Format =
   | 'tsv'
   | 'xml'
   | 'html'
-  | 'markdown';
+  | 'markdown'
+  | 'text-html'
+  | 'text-markdown'
+  | 'text';
 
 /**
  * Initialize the engine once; subsequent calls share the load.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quarb/wasm",
-  "version": "0.13.0",
+  "version": "0.16.0",
   "description": "Quarb \u2014 the arboreal query engine \u2014 compiled to WebAssembly, with TypeScript types. One-shot queries over JSON, YAML, TOML, CSV, XML, HTML, and Markdown, plus the quai session engine (multi-source mounts, joins, &N history, kaiv, SQLite) \u2014 entirely client-side.",
   "type": "module",
   "main": "index.js",

package/quai.d.ts

@@ -19,6 +19,9 @@ export interface Source {
     | 'xml'
     | 'html'
     | 'markdown'
+    | 'text-html'
+    | 'text-markdown'
+    | 'text'
     | 'kaiv'
     | 'daiv'
     | 'sqlite';

package/quai_wasm.d.ts

@@ -19,12 +19,30 @@ export class QuaiSession {
      * one-document constructor does.
      */
     static mount(sources_json: string, now_millis: number): QuaiSession;
+    /**
+     * [`mount`], enriched by a `--model` file (`model_text`): the
+     * session runs every line against the derived structure the
+     * model declares over the mounted sources — value containers,
+     * references, and pair edges. The model's own `mount` statements
+     * are ignored here (the sources come from the caller, not from
+     * disk the wasm cannot read); its `node`/`ref`/`edge`/`def`
+     * statements apply.
+     */
+    static mountWithModel(sources_json: string, model_text: string, now_millis: number): QuaiSession;
     /**
      * Open a session over `input` parsed as `format` (json, yaml,
      * toml, csv, tsv, xml, html, markdown). `now_millis` pins the
      * session's `now()` (pass `Date.now()`).
      */
     constructor(format: string, input: string, now_millis: number);
+    /**
+     * Run a line and render its results as exportable markup:
+     * `kind` is `md`, `html`, or `txt`. Text-level node results
+     * render structurally (sections back to headings, lists to
+     * lists); anything else degrades to prose lines. History refs
+     * (`&N`) resolve as in a normal line.
+     */
+    render(line: string, kind: string): string;
     /**
      * Clear the history and restart numbering.
      */
@@ -80,7 +98,9 @@ export interface InitOutput {
     readonly quaisession_history: (a: number) => [number, number];
     readonly quaisession_line: (a: number) => number;
     readonly quaisession_mount: (a: number, b: number, c: number) => [number, number, number];
+    readonly quaisession_mountWithModel: (a: number, b: number, c: number, d: number, e: number) => [number, number, number];
     readonly quaisession_new: (a: number, b: number, c: number, d: number, e: number) => [number, number, number];
+    readonly quaisession_render: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
     readonly quaisession_reset: (a: number) => void;
     readonly quaisession_restore: (a: number, b: number, c: number) => void;
     readonly quaisession_run: (a: number, b: number, c: number) => [number, number];

package/quai_wasm.js

@@ -63,6 +63,30 @@ export class QuaiSession {
         }
         return QuaiSession.__wrap(ret[0]);
     }
+    /**
+     * [`mount`], enriched by a `--model` file (`model_text`): the
+     * session runs every line against the derived structure the
+     * model declares over the mounted sources — value containers,
+     * references, and pair edges. The model's own `mount` statements
+     * are ignored here (the sources come from the caller, not from
+     * disk the wasm cannot read); its `node`/`ref`/`edge`/`def`
+     * statements apply.
+     * @param {string} sources_json
+     * @param {string} model_text
+     * @param {number} now_millis
+     * @returns {QuaiSession}
+     */
+    static mountWithModel(sources_json, model_text, now_millis) {
+        const ptr0 = passStringToWasm0(sources_json, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passStringToWasm0(model_text, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len1 = WASM_VECTOR_LEN;
+        const ret = wasm.quaisession_mountWithModel(ptr0, len0, ptr1, len1, now_millis);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return QuaiSession.__wrap(ret[0]);
+    }
     /**
      * Open a session over `input` parsed as `format` (json, yaml,
      * toml, csv, tsv, xml, html, markdown). `now_millis` pins the
@@ -84,6 +108,38 @@ export class QuaiSession {
         QuaiSessionFinalization.register(this, this.__wbg_ptr, this);
         return this;
     }
+    /**
+     * Run a line and render its results as exportable markup:
+     * `kind` is `md`, `html`, or `txt`. Text-level node results
+     * render structurally (sections back to headings, lists to
+     * lists); anything else degrades to prose lines. History refs
+     * (`&N`) resolve as in a normal line.
+     * @param {string} line
+     * @param {string} kind
+     * @returns {string}
+     */
+    render(line, kind) {
+        let deferred4_0;
+        let deferred4_1;
+        try {
+            const ptr0 = passStringToWasm0(line, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+            const len0 = WASM_VECTOR_LEN;
+            const ptr1 = passStringToWasm0(kind, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+            const len1 = WASM_VECTOR_LEN;
+            const ret = wasm.quaisession_render(this.__wbg_ptr, ptr0, len0, 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);
+        }
+    }
     /**
      * Clear the history and restart numbering.
      */

package/quarb_wasm.d.ts

@@ -3,7 +3,8 @@
 
 /**
  * Execute `query` against `input` parsed as `format`
- * (json | yaml | toml | csv | tsv | xml | html | markdown).
+ * (json | yaml | toml | csv | tsv | xml | html | markdown |
+ * text-html | text-markdown | text).
  * `now_millis` is the invocation instant for `now()`, as from
  * `Date.now()`. Returns a JSON envelope; never throws.
  */

package/quarb_wasm.js

@@ -2,7 +2,8 @@
 
 /**
  * Execute `query` against `input` parsed as `format`
- * (json | yaml | toml | csv | tsv | xml | html | markdown).
+ * (json | yaml | toml | csv | tsv | xml | html | markdown |
+ * text-html | text-markdown | text).
  * `now_millis` is the invocation instant for `now()`, as from
  * `Date.now()`. Returns a JSON envelope; never throws.
  * @param {string} format