@quillmark/wasm 0.132.0 → 0.134.0

package/runtime/runtime.js

@@ -19,7 +19,8 @@ import initCore, { Quill, Document } from '../core/wasm.js';
 // itself), a `node:fs` read under Node, whose `fetch` rejects `file:` URLs.
 // Resolution-time, so `node:fs` never enters a browser graph.
 import { toModuleSource } from '#quillmark-env';
-import { importMarkdown, exportMarkdown, rebase, mapPos, mapMarks } from '../core/wasm.js';
+import { importMarkdown, exportMarkdown, normalize, invert, diff } from '../core/wasm.js';
+import { splitBlock, joinBlocks, deleteRange, indent, outdent, wrap, inheritedMarks, mapPos } from '../core/wasm.js';
 import { isInline, isPlain } from '../core/wasm.js';
 import { parseDocPath, formatDocPath, formatDiagnostic } from '../core/wasm.js';
 
@@ -47,9 +48,17 @@ const CORE_SURFACE = Object.freeze({
 	Document,
 	importMarkdown,
 	exportMarkdown,
-	rebase,
+	normalize,
+	invert,
+	diff,
+	splitBlock,
+	joinBlocks,
+	deleteRange,
+	indent,
+	outdent,
+	wrap,
+	inheritedMarks,
 	mapPos,
-	mapMarks,
 	isInline,
 	isPlain,
 	parseDocPath,
@@ -278,7 +287,7 @@ const HANDLE_KINDS = {
 	},
 	Document: {
 		code: 'runtime::not_a_document',
-		hint: 'Pass a Document built by Document.fromMarkdown / fromStored or quill.seedDocument / emptyDocument. A Document from another copy of @quillmark/wasm is refused too — each copy is its own WASM linear memory and its own class — so run `npm ls @quillmark/wasm` and dedupe to one.'
+		hint: 'Pass a Document built by Document.fromMarkdown / fromStored or quill.seedDocument / emptyDocument / fromAuthoring. A Document from another copy of @quillmark/wasm is refused too — each copy is its own WASM linear memory and its own class — so run `npm ls @quillmark/wasm` and dedupe to one.'
 	}
 };
 
@@ -320,50 +329,16 @@ function requireLocalQuill(quill, method) {
 	throw notLocal(quill, method, 'Quill');
 }
 
-// WELD_KEYS is the rule `Container::same_weld` owns upstream: which `attrs`
-// entries two adjacent runs must share for the markdown projection to read them
-// as one. `start` is not among them, since CommonMark reads only a list's first
-// number — a subset, which is why every container needs its own entry.
-//
-// Re-spelled here rather than called, because `assignInstances` answers before
-// wasm initializes (`prose/canon/BINDINGS.md` § "WebAssembly"). What holds the
-// two spellings equal is running the rule, not comparing their sources:
-// `runtime.test.js` § "container run boundaries" stamps a pair and re-imports
-// it, where `Content::normalize` re-mints against the Rust predicate. A tag the
-// table omits welds with nothing, so `tests/known_names_drift.rs` pins that
-// every container has an entry.
-
-const WELD_KEYS = { list_item: ['ordered'], quote: [] };
-
 /**
- * @param {import('../core/wasm.js').ContentContainer} a
- * @param {import('../core/wasm.js').ContentContainer} b
- * @returns {boolean}
- */
-function weldsWith(a, b) {
-	// A malformed value welds with nothing: answer rather than throw.
-	if (typeof a?.container !== 'string' || a.container !== b?.container) return false;
-	// `hasOwn`, so a tag colliding with an `Object.prototype` member answers
-	// `false` rather than reaching a function.
-	if (!Object.hasOwn(WELD_KEYS, a.container)) return false;
-	return WELD_KEYS[a.container].every((k) => a.attrs?.[k] === b.attrs?.[k]);
-}
-
-/**
- * @param {(import('../core/wasm.js').ContentContainer | null)[]} runs
- * @returns {(import('../core/wasm.js').ContentContainer | null)[]}
+ * Throw unless `quill` and `doc` are both THIS copy's.
+ * @param {unknown} quill
+ * @param {unknown} doc
+ * @param {string} method
+ * @returns {void}
  */
-export function assignInstances(runs) {
-	let prev = null;
-	return runs.map((run) => {
-		if (run == null) {
-			prev = null;
-			return null;
-		}
-		const instance = prev && weldsWith(prev, run) ? 1 - prev.instance : 0;
-		prev = { ...run, instance };
-		return prev;
-	});
+function requireLocalBind(quill, doc, method) {
+	requireLocalQuill(quill, method);
+	requireLocalDoc(doc, method);
 }
 
 /**
@@ -750,9 +725,6 @@ export class LiveSession {
 	get pageCount() {
 		return this.#inner.pageCount;
 	}
-	get backendId() {
-		return this.#inner.backendId;
-	}
 	get warnings() {
 		return this.#inner.warnings;
 	}
@@ -855,13 +827,22 @@ export class DocumentWriter {
 	 * @param {Document} doc the document to mutate, held by reference (not owned)
 	 */
 	constructor(quill, doc) {
-		requireLocalQuill(quill, 'quill.writer(doc)');
-		requireLocalDoc(doc, 'quill.writer(doc)');
+		requireLocalBind(quill, doc, 'quill.writer(doc)');
 		this.#quill = quill;
 		this.#doc = doc;
 	}
-	get document() {
-		return this.#doc;
+	/**
+	 * @returns {string}
+	 */
+	hash() {
+		return this.#doc._hash(this.#quill);
+	}
+	/**
+	 * @param {import('../core/wasm.js').Addr | string} addr
+	 * @returns {string}
+	 */
+	hashAt(addr) {
+		return this.#doc._hashAt(this.#quill, addr);
 	}
 	/**
 	 * @param {string} name
@@ -880,25 +861,28 @@ export class DocumentWriter {
 	}
 	/**
 	 * @param {string} markdown
+	 * @param {import('../core/wasm.js').BaseOptions} [opts]
 	 * @returns {import('../core/wasm.js').Revised}
 	 */
-	reviseBody(markdown) {
-		return this.#doc.revise({}, markdown);
+	reviseBody(markdown, opts) {
+		return this.#doc._revise({}, markdown, opts);
 	}
 	/**
 	 * @param {string} name
 	 * @param {string} text
+	 * @param {import('../core/wasm.js').BaseOptions} [opts]
 	 * @returns {import('../core/wasm.js').Revised}
 	 */
-	reviseField(name, text) {
-		return this.#doc._reviseField(this.#quill, name, text);
+	reviseField(name, text, opts) {
+		return this.#doc._reviseField(this.#quill, name, text, opts);
 	}
 	/**
 	 * @param {string} markdown
+	 * @param {import('../core/wasm.js').BaseOptions} [opts]
 	 * @returns {import('../core/wasm.js').DocumentRevised}
 	 */
-	reviseDocument(markdown) {
-		return this.#doc._reviseDocument(this.#quill, markdown);
+	reviseDocument(markdown, opts) {
+		return this.#doc._reviseDocument(this.#quill, markdown, opts);
 	}
 	/**
 	 * @param {string} kind
@@ -936,20 +920,17 @@ export class CardWriter {
 	 * @param {number} index the composable card's index
 	 */
 	constructor(quill, doc, index) {
-		requireLocalQuill(quill, 'writer.card(index)');
-		requireLocalDoc(doc, 'writer.card(index)');
+		requireLocalBind(quill, doc, 'writer.card(index)');
 		this.#quill = quill;
 		this.#doc = doc;
 		this.#index = index;
 	}
-	get index() {
-		return this.#index;
-	}
 	/**
+	 * @param {string} [field]
 	 * @returns {string}
 	 */
-	get kind() {
-		return this.#doc.card(this.#index).kind;
+	hashAt(field) {
+		return this.#doc._hashAt(this.#quill, { card: this.#index, field });
 	}
 	/**
 	 * @param {string} name
@@ -968,18 +949,20 @@ export class CardWriter {
 	}
 	/**
 	 * @param {string} markdown
+	 * @param {import('../core/wasm.js').BaseOptions} [opts]
 	 * @returns {import('../core/wasm.js').Revised}
 	 */
-	reviseBody(markdown) {
-		return this.#doc.revise({ card: this.#index }, markdown);
+	reviseBody(markdown, opts) {
+		return this.#doc._revise({ card: this.#index }, markdown, opts);
 	}
 	/**
 	 * @param {string} name
 	 * @param {string} text
+	 * @param {import('../core/wasm.js').BaseOptions} [opts]
 	 * @returns {import('../core/wasm.js').Revised}
 	 */
-	reviseField(name, text) {
-		return this.#doc._reviseField(this.#quill, { card: this.#index, field: name }, text);
+	reviseField(name, text, opts) {
+		return this.#doc._reviseField(this.#quill, { card: this.#index, field: name }, text, opts);
 	}
 }
 
@@ -1007,14 +990,10 @@ export class DocumentReader {
 	 * @param {Document} doc the document to read, held by reference (not owned)
 	 */
 	constructor(quill, doc) {
-		requireLocalQuill(quill, 'quill.reader(doc)');
-		requireLocalDoc(doc, 'quill.reader(doc)');
+		requireLocalBind(quill, doc, 'quill.reader(doc)');
 		this.#quill = quill;
 		this.#doc = doc;
 	}
-	get document() {
-		return this.#doc;
-	}
 	/**
 	 * @param {import('../core/wasm.js').Addr | string} addr
 	 * @returns {unknown}
@@ -1050,68 +1029,6 @@ export class DocumentReader {
 	resolve(today) {
 		return this.#quill._resolve(this.#doc, today);
 	}
-	/**
-	 * @param {number} index
-	 * @returns {CardReader}
-	 */
-	card(index) {
-		return new CardReader(this.#quill, this.#doc, index);
-	}
-}
-
-export class CardReader {
-	#quill;
-	#doc;
-	#index;
-	/**
-	 * @param {Quill} quill the schema source
-	 * @param {Document} doc the document to read, held by reference (not owned)
-	 * @param {number} index the composable card's index
-	 */
-	constructor(quill, doc, index) {
-		requireLocalQuill(quill, 'reader.card(index)');
-		requireLocalDoc(doc, 'reader.card(index)');
-		this.#quill = quill;
-		this.#doc = doc;
-		this.#index = index;
-	}
-	get index() {
-		return this.#index;
-	}
-	/**
-	 * @returns {string}
-	 */
-	get kind() {
-		return this.#doc.card(this.#index).kind;
-	}
-	/**
-	 * @param {string} name
-	 * @returns {unknown}
-	 */
-	get(name) {
-		return this.#doc._readerGet(this.#quill, { card: this.#index, field: name });
-	}
-	/**
-	 * @param {string} name
-	 * @returns {import('../core/wasm.js').Content | undefined}
-	 */
-	getContent(name) {
-		return this.#doc._readerGetContent(this.#quill, { card: this.#index, field: name });
-	}
-	/**
-	 * @param {string} name
-	 * @param {import('../core/wasm.js').PathStep[]} path
-	 * @returns {import('../core/wasm.js').Content | undefined}
-	 */
-	getContentAt(name, path) {
-		return this.#doc._readerGetContentAt(this.#quill, { card: this.#index, field: name }, path);
-	}
-	/**
-	 * @returns {string}
-	 */
-	bodyMarkdown() {
-		return this.#doc._readerGet(this.#quill, { card: this.#index });
-	}
 }
 
 // Patched onto the same re-exported `Quill` prototype as `writer`.