@markup-carve/carve-wasm 0.1.5 → 0.1.7

package/render/carve_wasm_bg.wasm.d.ts

@@ -0,0 +1,21 @@
+/* tslint:disable */
+/* eslint-disable */
+export const memory: WebAssembly.Memory;
+export const extensions: () => [number, number];
+export const parseLocator: (a: number, b: number) => [number, number, number];
+export const sanitizeSvg: (a: number, b: number, c: number) => [number, number, number];
+export const toHtml: (a: number, b: number) => [number, number];
+export const toHtmlFull: (a: number, b: number, c: number) => [number, number, number, number];
+export const toHtmlWithOptions: (a: number, b: number, c: number) => [number, number, number, number];
+export const toHtmlWithRenderers: (a: number, b: number, c: number) => [number, number, number];
+export const toHtmlWithSymbols: (a: number, b: number, c: number) => [number, number, number, number];
+export const version: () => [number, number];
+export const __wbindgen_malloc: (a: number, b: number) => number;
+export const __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
+export const __wbindgen_exn_store: (a: number) => void;
+export const __externref_table_alloc: () => number;
+export const __wbindgen_externrefs: WebAssembly.Table;
+export const __externref_drop_slice: (a: number, b: number) => void;
+export const __wbindgen_free: (a: number, b: number, c: number) => void;
+export const __externref_table_dealloc: (a: number) => void;
+export const __wbindgen_start: () => void;

package/render/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@markup-carve/carve-wasm",
+  "type": "module",
+  "description": "WASM bindings for the Carve parser and HTML renderer.",
+  "version": "0.1.7",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/markup-carve/carve-wasm"
+  },
+  "files": [
+    "carve_wasm_bg.wasm",
+    "carve_wasm.js",
+    "carve_wasm.d.ts"
+  ],
+  "main": "carve_wasm.js",
+  "homepage": "https://markup-carve.github.io/carve/",
+  "types": "carve_wasm.d.ts",
+  "sideEffects": [
+    "./snippets/*"
+  ]
+}

package/web/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mark Scherer
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/web/README.md

@@ -0,0 +1,106 @@
+# carve-wasm
+
+WebAssembly build of the [Carve](https://markup-carve.github.io/carve/) markup
+renderer, compiled from
+[carve-rs](https://github.com/markup-carve/carve-rs). It runs the Rust
+implementation in browsers and powers the **Rust (WASM)** engine in the
+[Carve playground](https://markup-carve.github.io/carve/playground).
+
+## Install
+
+```bash
+npm install @markup-carve/carve-wasm
+```
+
+## Render Carve
+
+The package root selects synchronous Node bindings in Node and the bundler
+build in browser bundles. The browser bundler must support native WASM imports
+and top-level await. Vite 8.3.2 is tested. See the
+[compatibility guide](docs/compatibility.md) for explicit browser, Node and
+rendering-only imports.
+
+```js
+import { toHtml, toHtmlFull, toHtmlWithOptions } from '@markup-carve/carve-wasm'
+
+toHtml('# Hello, Carve!')
+toHtmlFull('# Hello\n\n``` mermaid\ngraph TD; A-->B\n```\n')
+toHtmlWithOptions(source, {
+  extensions: ['glossary', 'table-of-contents'],
+  rawHtml: false,
+  sections: true,
+})
+```
+
+`toHtml` uses the core renderer. `toHtmlFull` enables the extension set used
+by the playground preview. `toHtmlWithOptions` lets the caller choose
+extensions and rendering policy. Unknown extension names throw instead of
+silently producing incomplete output.
+
+Other core targets include `toMarkdown`, `toPlainText`, `toAnsi`, and
+`toCarve`. Each has a `*WithOptions` form.
+
+## Convert existing content
+
+The package imports HTML, Markdown, Djot, and BBCode. `fromHtml`,
+`fromMarkdown`, `migrateDjot`, and `migrateBbcode` return the converted value
+with a fidelity report. The simpler `fromDjot` and `fromBbcode` helpers return
+only the converted string.
+
+Markdown reports assess supported constructs and report known losses. Inputs
+outside that assessment receive `fidelity-unverified`. Djot and BBCode use the
+conservative fallback except for verified literal text.
+
+```js
+import { fromHtml, fromMarkdown, htmlToAst, htmlToCarve } from '@markup-carve/carve-wasm'
+
+const { value, report } = htmlToCarve('<p>Hello <strong>world</strong></p>', 'safe')
+const { value: ast } = htmlToAst('<p>Hello <b>world</b></p>', 'safe')
+
+fromHtml(html, 'semantic')
+fromMarkdown(markdown)
+```
+
+HTML modes are `safe` (the default), `semantic`, and trusted-only
+`roundtrip`. `htmlToAst` returns the serialized Carve AST without passing it
+through the source writer, so its report can differ from `htmlToCarve` when a
+construct is representable in the tree but not in Carve source.
+
+## Common host APIs
+
+- `extensions()` returns the extension names supported by the bundled engine.
+- `toCarvePatch()` and `applySourcePatch()` create and apply stale-safe UTF-8
+  byte edits.
+- `toHtmlWithSymbols()` resolves configured `:name:` symbols. Symbol values
+  are trusted raw output and must not come from user input.
+- `parseJson()`, `astJsonToHtml()`, and the other AST functions use the PART 12
+  AST JSON shared by Carve implementations.
+- Include expansion calls a synchronous host resolver, records dependencies,
+  and enforces depth, byte, and call budgets. The resolver decides which paths
+  to refuse.
+- `ParserSession` retains a document between edits and can reuse unchanged
+  plain paragraphs. Call `free()` when the editor closes. Tree patches,
+  three-way merge and ProseMirror helpers also support browser editors.
+
+The [complete API and usage reference](docs/reference.md) documents these
+APIs, renderer profiles, resource limits, includes, AST fields, and the
+TypeScript declarations.
+
+## Security
+
+Use `rawHtml: false` with a restrictive profile such as `comment` for
+untrusted documents. Symbols and static renderer callbacks are trusted
+configuration and may emit unescaped HTML. Treat source patches as trusted
+edit instructions, not as signed data. A profile rejection throws.
+
+Carve also enforces URL-scheme and attribute hardening in the renderer. See
+the language [security documentation](https://markup-carve.github.io/carve/security)
+for the complete model.
+
+## Development
+
+Contributor documentation lives under `docs/`:
+
+- [Building and testing](https://github.com/markup-carve/carve-wasm/blob/main/docs/building.md)
+- [The carve-rs engine pin](https://github.com/markup-carve/carve-wasm/blob/main/docs/engine-pin.md)
+- [Release process](https://github.com/markup-carve/carve-wasm/blob/main/docs/releasing.md)