@markup-carve/carve-wasm 0.1.0 → 0.1.1

package/README.md

@@ -27,6 +27,10 @@ import policy and canonical writer as carve-rs. Modes are `safe` (default),
 const { value, report } = htmlToCarve('<p>Hello <strong>world</strong></p>', 'safe')
 ```
 
+Portable migration code can use `fromHtml(html, mode)` and
+`fromMarkdown(markdown)`. Both return `{ value, report }`; Markdown carries an
+empty diagnostics list because the engine migrates the document whole.
+
 ### Core renderer
 
 Renders Carve markup to HTML with no extensions enabled.
@@ -38,6 +42,8 @@ call.
 ```js
 import { toHtml } from '@markup-carve/carve-wasm'
 
+// The other core targets are toMarkdown, toPlainText, toAnsi, and toCarve.
+
 const html = toHtml('# Hello, Carve!')
 document.body.innerHTML = html
 ```
@@ -168,6 +174,11 @@ const html: string = toHtml('_Hello_')
 | `toHtmlWithSymbols` | `(source: string, symbols?: object \| null) => string` | Core renderer + a `:name:` -> value symbols map (values are raw, see above) |
 | `toHtmlFull` | `(source: string, symbols?: object \| null) => string` | Core + common extensions (matches playground), optional symbols map |
 | `toHtmlWithOptions` | `(source: string, options?: object \| null) => string` | General form: `{ sections?, symbols?, full? }`, every field optional |
+| `toHtmlWithReport` | `(source: string, strict?: boolean, maximum?: number) => RenderResult` | HTML plus bounded `raw-format-dropped` losses; strict mode throws `RenderLossError` |
+| `toMarkdownWithReport` | `(source: string, strict?: boolean, maximum?: number) => RenderResult` | Checked Markdown render |
+| `toPlainTextWithReport` | `(source: string, strict?: boolean, maximum?: number) => RenderResult` | Checked plain-text render |
+| `toAnsiWithReport` | `(source: string, strict?: boolean, maximum?: number) => RenderResult` | Checked ANSI render |
+| `toCarveWithReport` | `(source: string, strict?: boolean, maximum?: number) => RenderResult` | Checked canonical Carve render (lossless) |
 | `parseJson` | `(source: string) => string` | The parsed AST as JSON (PART 12 exchange shape) |
 | `version` | `() => string` | Returns the carve-wasm package version |
 
@@ -232,6 +243,23 @@ cargo test && wasm-pack build --target nodejs && node tests/smoke.mjs
 CARVE_SPEC_CORPUS=/path/to/carve/tests/corpus node tests/corpus.mjs
 ```
 
+`scripts/check-engine-floor.py` is what notices a pin left behind. CI runs it
+against the revision carve-rb embeds:
+
+```sh
+python3 scripts/check-engine-floor.py \
+    --engine <carve-rs checkout> --manifest Cargo.toml --lock Cargo.lock \
+    --sibling-name carve-rb --sibling-manifest <carve-rb>/ext/carve/Cargo.toml \
+    --changelog CHANGELOG.md
+```
+
+It fails when this pin is a strict ancestor of the sibling's, and it also fails
+when the `[Unreleased]` changelog section names a revision the build does not
+embed - a revision quoted in prose is a second copy of the pin, and the second
+copy is the one nothing else reads. A floor rather than a leash: it is
+deliberately not a distance check against carve-rs `main`, which merges
+continuously and would be red from the moment any pull request opens there.
+
 That last line is the one that can tell a drifted pin from a current one.
 `smoke.mjs` asserts hand-written expectations, which a stale engine satisfies
 happily; `corpus.mjs` renders all ~530 mandatory spec documents through the

package/carve_wasm.d.ts

@@ -9,6 +9,10 @@
  */
 export function extensions(): string[];
 
+export function fromHtml(source: string, mode?: string | null): any;
+
+export function fromMarkdown(source: string): any;
+
 /**
  * Import HTML through the Rust HTML5 DOM and canonical Carve writer.
  *
@@ -37,6 +41,14 @@ export function htmlToCarve(source: string, mode?: string | null): any;
  */
 export function parseJson(source: string): string;
 
+export function toAnsi(source: string): string;
+
+export function toAnsiWithReport(source: string, strict?: boolean | null, maximum?: number | null): any;
+
+export function toCarve(source: string): string;
+
+export function toCarveWithReport(source: string, strict?: boolean | null, maximum?: number | null): any;
+
 export function toHtml(source: string): string;
 
 /**
@@ -99,6 +111,8 @@ export function toHtmlFull(source: string, symbols?: object | null): string;
  */
 export function toHtmlWithOptions(source: string, options?: object | null): string;
 
+export function toHtmlWithReport(source: string, strict?: boolean | null, maximum?: number | null): any;
+
 /**
  * Render with the core profile and a **symbols map**: `{ rocket: "🚀" }` (a
  * plain object or a `Map`). A `:name:` symbol whose name is in the map renders
@@ -117,4 +131,12 @@ export function toHtmlWithOptions(source: string, options?: object | null): stri
  */
 export function toHtmlWithSymbols(source: string, symbols?: object | null): string;
 
+export function toMarkdown(source: string): string;
+
+export function toMarkdownWithReport(source: string, strict?: boolean | null, maximum?: number | null): any;
+
+export function toPlainText(source: string): string;
+
+export function toPlainTextWithReport(source: string, strict?: boolean | null, maximum?: number | null): any;
+
 export function version(): string;

package/carve_wasm.js

@@ -5,5 +5,5 @@ import { __wbg_set_wasm } from "./carve_wasm_bg.js";
 __wbg_set_wasm(wasm);
 wasm.__wbindgen_start();
 export {
-    extensions, htmlToCarve, parseJson, toHtml, toHtmlFull, toHtmlWithOptions, toHtmlWithSymbols, version
+    extensions, fromHtml, fromMarkdown, htmlToCarve, parseJson, toAnsi, toAnsiWithReport, toCarve, toCarveWithReport, toHtml, toHtmlFull, toHtmlWithOptions, toHtmlWithReport, toHtmlWithSymbols, toMarkdown, toMarkdownWithReport, toPlainText, toPlainTextWithReport, version
 } from "./carve_wasm_bg.js";

package/carve_wasm_bg.js

@@ -12,6 +12,37 @@ export function extensions() {
     return v1;
 }
 
+/**
+ * @param {string} source
+ * @param {string | null} [mode]
+ * @returns {any}
+ */
+export function fromHtml(source, mode) {
+    const ptr0 = passStringToWasm0(source, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len0 = WASM_VECTOR_LEN;
+    var ptr1 = isLikeNone(mode) ? 0 : passStringToWasm0(mode, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    var len1 = WASM_VECTOR_LEN;
+    const ret = wasm.fromHtml(ptr0, len0, ptr1, len1);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return takeFromExternrefTable0(ret[0]);
+}
+
+/**
+ * @param {string} source
+ * @returns {any}
+ */
+export function fromMarkdown(source) {
+    const ptr0 = passStringToWasm0(source, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.fromMarkdown(ptr0, len0);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return takeFromExternrefTable0(ret[0]);
+}
+
 /**
  * Import HTML through the Rust HTML5 DOM and canonical Carve writer.
  *
@@ -68,6 +99,76 @@ export function parseJson(source) {
     }
 }
 
+/**
+ * @param {string} source
+ * @returns {string}
+ */
+export function toAnsi(source) {
+    let deferred2_0;
+    let deferred2_1;
+    try {
+        const ptr0 = passStringToWasm0(source, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.toAnsi(ptr0, len0);
+        deferred2_0 = ret[0];
+        deferred2_1 = ret[1];
+        return getStringFromWasm0(ret[0], ret[1]);
+    } finally {
+        wasm.__wbindgen_free(deferred2_0, deferred2_1, 1);
+    }
+}
+
+/**
+ * @param {string} source
+ * @param {boolean | null} [strict]
+ * @param {number | null} [maximum]
+ * @returns {any}
+ */
+export function toAnsiWithReport(source, strict, maximum) {
+    const ptr0 = passStringToWasm0(source, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.toAnsiWithReport(ptr0, len0, isLikeNone(strict) ? 0xFFFFFF : strict ? 1 : 0, isLikeNone(maximum) ? 0x100000001 : (maximum) >>> 0);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return takeFromExternrefTable0(ret[0]);
+}
+
+/**
+ * @param {string} source
+ * @returns {string}
+ */
+export function toCarve(source) {
+    let deferred2_0;
+    let deferred2_1;
+    try {
+        const ptr0 = passStringToWasm0(source, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.toCarve(ptr0, len0);
+        deferred2_0 = ret[0];
+        deferred2_1 = ret[1];
+        return getStringFromWasm0(ret[0], ret[1]);
+    } finally {
+        wasm.__wbindgen_free(deferred2_0, deferred2_1, 1);
+    }
+}
+
+/**
+ * @param {string} source
+ * @param {boolean | null} [strict]
+ * @param {number | null} [maximum]
+ * @returns {any}
+ */
+export function toCarveWithReport(source, strict, maximum) {
+    const ptr0 = passStringToWasm0(source, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.toCarveWithReport(ptr0, len0, isLikeNone(strict) ? 0xFFFFFF : strict ? 1 : 0, isLikeNone(maximum) ? 0x100000001 : (maximum) >>> 0);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return takeFromExternrefTable0(ret[0]);
+}
+
 /**
  * @param {string} source
  * @returns {string}
@@ -191,6 +292,22 @@ export function toHtmlWithOptions(source, options) {
     }
 }
 
+/**
+ * @param {string} source
+ * @param {boolean | null} [strict]
+ * @param {number | null} [maximum]
+ * @returns {any}
+ */
+export function toHtmlWithReport(source, strict, maximum) {
+    const ptr0 = passStringToWasm0(source, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.toHtmlWithReport(ptr0, len0, isLikeNone(strict) ? 0xFFFFFF : strict ? 1 : 0, isLikeNone(maximum) ? 0x100000001 : (maximum) >>> 0);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return takeFromExternrefTable0(ret[0]);
+}
+
 /**
  * Render with the core profile and a **symbols map**: `{ rocket: "🚀" }` (a
  * plain object or a `Map`). A `:name:` symbol whose name is in the map renders
@@ -231,6 +348,76 @@ export function toHtmlWithSymbols(source, symbols) {
     }
 }
 
+/**
+ * @param {string} source
+ * @returns {string}
+ */
+export function toMarkdown(source) {
+    let deferred2_0;
+    let deferred2_1;
+    try {
+        const ptr0 = passStringToWasm0(source, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.toMarkdown(ptr0, len0);
+        deferred2_0 = ret[0];
+        deferred2_1 = ret[1];
+        return getStringFromWasm0(ret[0], ret[1]);
+    } finally {
+        wasm.__wbindgen_free(deferred2_0, deferred2_1, 1);
+    }
+}
+
+/**
+ * @param {string} source
+ * @param {boolean | null} [strict]
+ * @param {number | null} [maximum]
+ * @returns {any}
+ */
+export function toMarkdownWithReport(source, strict, maximum) {
+    const ptr0 = passStringToWasm0(source, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.toMarkdownWithReport(ptr0, len0, isLikeNone(strict) ? 0xFFFFFF : strict ? 1 : 0, isLikeNone(maximum) ? 0x100000001 : (maximum) >>> 0);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return takeFromExternrefTable0(ret[0]);
+}
+
+/**
+ * @param {string} source
+ * @returns {string}
+ */
+export function toPlainText(source) {
+    let deferred2_0;
+    let deferred2_1;
+    try {
+        const ptr0 = passStringToWasm0(source, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.toPlainText(ptr0, len0);
+        deferred2_0 = ret[0];
+        deferred2_1 = ret[1];
+        return getStringFromWasm0(ret[0], ret[1]);
+    } finally {
+        wasm.__wbindgen_free(deferred2_0, deferred2_1, 1);
+    }
+}
+
+/**
+ * @param {string} source
+ * @param {boolean | null} [strict]
+ * @param {number | null} [maximum]
+ * @returns {any}
+ */
+export function toPlainTextWithReport(source, strict, maximum) {
+    const ptr0 = passStringToWasm0(source, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.toPlainTextWithReport(ptr0, len0, isLikeNone(strict) ? 0xFFFFFF : strict ? 1 : 0, isLikeNone(maximum) ? 0x100000001 : (maximum) >>> 0);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return takeFromExternrefTable0(ret[0]);
+}
+
 /**
  * @returns {string}
  */
@@ -330,15 +517,32 @@ export function __wbg_new_4f9fafbb3909af72() {
     const ret = new Object();
     return ret;
 }
+export function __wbg_new_e3b04b4d53d1b593(arg0, arg1) {
+    const ret = new Error(getStringFromWasm0(arg0, arg1));
+    return ret;
+}
+export function __wbg_new_f3c9df4f38f3f798() {
+    const ret = new Array();
+    return ret;
+}
 export function __wbg_parse_545d11396395fbbd() { return handleError(function (arg0, arg1) {
     const ret = JSON.parse(getStringFromWasm0(arg0, arg1));
     return ret;
 }, arguments); }
+export function __wbg_push_6bdbc990be5ac37b(arg0, arg1) {
+    const ret = arg0.push(arg1);
+    return ret;
+}
 export function __wbg_set_8ee2d34facb8466e() { return handleError(function (arg0, arg1, arg2) {
     const ret = Reflect.set(arg0, arg1, arg2);
     return ret;
 }, arguments); }
-export function __wbindgen_cast_0000000000000001(arg0, arg1) {
+export function __wbindgen_cast_0000000000000001(arg0) {
+    // Cast intrinsic for `F64 -> Externref`.
+    const ret = arg0;
+    return ret;
+}
+export function __wbindgen_cast_0000000000000002(arg0, arg1) {
     // Cast intrinsic for `Ref(String) -> Externref`.
     const ret = getStringFromWasm0(arg0, arg1);
     return ret;

package/package.json

@@ -2,7 +2,7 @@
   "name": "@markup-carve/carve-wasm",
   "type": "module",
   "description": "WASM bindings for the Carve parser and HTML renderer.",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "license": "MIT",
   "repository": {
     "type": "git",