rapier-html 1.1.102 → 1.2.3

package/BUILD.json

@@ -1,10 +1,10 @@
 {
   "package": "rapier-html",
-  "version": "1.1.102",
+  "version": "1.2.3",
   "path": "dist/rapier.html",
-  "bytes": 3629652,
-  "sha256": "b326753f3804e8b1bd1382e062436ce631d774b41da66041427f608c4a16c032",
-  "builtAt": "2026-10-11T21:53:14.793Z",
+  "bytes": 5086203,
+  "sha256": "864fe7a94b5c3064653e2a7423449f439c0ab864062ec1644a88dee90c042af6",
+  "builtAt": "2026-10-14T16:53:28.260Z",
   "node": "v22.23.3",
   "canonical": true,
   "packing": "zopfli",
@@ -14,32 +14,39 @@
       "delivery": "built-in",
       "kind": "script",
       "element": "rapier-plugin-math",
-      "bytes": 803451,
-      "packedBytes": 544485,
+      "bytes": 749536,
+      "packedBytes": 504166,
       "files": [
         {
           "id": "rapier-math",
-          "name": "rapier-math-1.0.1.js",
-          "version": "1.0.1",
-          "bytes": 803451,
-          "sri": "1kdn6mohx3a5MAiwqRWY+6oviUHUheHfY1VMsxjDsUrn7woTaa7FSKo4juYtuNaF"
+          "name": "rapier-math-2.2.0.js",
+          "version": "2.2.0",
+          "bytes": 749536,
+          "sri": "pzYte7azbAoS8XSwIKjFg7mxGOxAxBKo9/IUy07H4j0WoyguAS/zwkR1O6kDXq9S"
         }
       ]
     },
     {
       "id": "mermaid",
       "delivery": "built-in",
-      "kind": "script",
+      "kind": "files",
       "element": "rapier-plugin-mermaid",
-      "bytes": 294857,
-      "packedBytes": 103232,
+      "bytes": 7384142,
+      "packedBytes": 1563922,
       "files": [
         {
-          "id": "rapier-mermaid",
-          "name": "rapier-diagrams-1.1.102.js",
-          "version": "1.1.102",
-          "bytes": 294857,
-          "sri": "fmQHeVOJnX1gwaqVihnI/FFSP8hm+Bh/dLQWQ17yvUAJoF9tFd2d6mY5tZ249t8u"
+          "id": "rapier-mermaid-core",
+          "name": "mermaid.min.js",
+          "version": "12.1.0",
+          "bytes": 5493176,
+          "sri": "EbBpjO7rlR6eqZEcG7GaPpyk9H9WrMyPWX4d3KvPYltgt8Z8l0z6R56B1qP40pR4"
+        },
+        {
+          "id": "rapier-mermaid-zenuml",
+          "name": "rapier-zenuml-4.5.0-1.js",
+          "version": "4.5.0-1",
+          "bytes": 1890966,
+          "sri": "MVn/Or1nIHTDvy84lSSJAH2Fx1Y7AGoaMfd7hW7i3LJe7M/dau8VDFnF8Q+X0qOl"
         }
       ]
     },

package/README.md

@@ -2,7 +2,7 @@
 
 Turn Markdown into one offline HTML file with the full Rapier editor. It opens in any browser on a phone or
 computer, with no account. People read, edit, draw and paint watercolor. Agents deliver documents, show what
-changed and receive the person's edited copy through the door. Start with `npx rapier-html@1.1.102 notes.md`.
+changed and receive the person's edited copy through the door. Start with `npx rapier-html@1.2.3 notes.md`.
 
 Use it for a plan to rearrange, an illustrated guide to annotate, a draft to continue writing, or a revision
 to review. Text and drawings stay editable, and the file remains usable independently of a hosted workspace.
@@ -18,14 +18,14 @@ to review. Text and drawings stay editable, and the file remains usable independ
 Node 22 or newer.
 
 ```sh
-npx -- rapier-html@1.1.102 notes.md                          # the editor, notes.md inside it, written beside the file
-npx -- rapier-html@1.1.102 notes.md --view draw              # opens on Draw: sketch and paint, the document behind it
-npx -- rapier-html@1.1.102 notes.md --view notes             # opens the Notes library
-npx -- rapier-html@1.1.102 notes.md --drawing sketch.svg     # carries a drawing, opened on Draw over the document
-npx -- rapier-html@1.1.102 revised.md --compare original.md # opens showing what changed
-npx -- rapier-html@1.1.102 notes.md --return "$RETURN_URL" --return-expires-at "$RETURN_EXPIRES_AT" # Send back
-npx -- rapier-html@1.1.102 notes.md out.html                 # a named output
-npm install rapier-html@1.1.102                              # as a library: wrap, unwrap
+npx -- rapier-html@1.2.3 notes.md                          # the editor, notes.md inside it, written beside the file
+npx -- rapier-html@1.2.3 notes.md --view draw              # opens on Draw: sketch and paint, the document behind it
+npx -- rapier-html@1.2.3 notes.md --view notes             # opens the Notes library
+npx -- rapier-html@1.2.3 notes.md --drawing sketch.svg     # carries a drawing, opened on Draw over the document
+npx -- rapier-html@1.2.3 revised.md --compare original.md # opens showing what changed
+npx -- rapier-html@1.2.3 notes.md --return "$RETURN_URL" --return-expires-at "$RETURN_EXPIRES_AT" # Send back
+npx -- rapier-html@1.2.3 notes.md out.html                 # a named output
+npm install rapier-html@1.2.3                              # as a library: wrap, unwrap
 ```
 
 The first `--` is for npm, so `--help` reaches the command. It never overwrites a file.
@@ -46,8 +46,8 @@ Collaborate over MCP and WebMCP, use optional encrypted sync to your own Cloudfl
 editor and lightweight reader (about 190 kB gzipped). The agent edits live; the person sees its presence and
 changes, taps a change to see the before and undoes anything. Use `show {target:"comparison"}` to show a diff deliberately.
 
-1. **Work together live.** Connect to `https://mcp.rapier.website/mcp`, then call `open` to share one document with the person.
-2. **Deliver an offline editor.** Run `npx rapier-html@1.1.102 notes.md` to put the document and editor in one HTML file ([rapier-html](https://github.com/jackskip22/rapier-plugins/tree/main/npm/rapier-html)).
+1. **Work together live.** Connect to `https://mcp.rapier.website/door/mcp`, then call `open` to share one document with the person.
+2. **Deliver an offline editor.** Run `npx rapier-html@1.2.3 notes.md` to put the document and editor in one HTML file ([rapier-html](https://github.com/jackskip22/rapier-plugins/tree/main/npm/rapier-html)).
 3. **Embed in your app.** Install [rapier-embed](https://github.com/jackskip22/rapier-plugins/tree/main/npm/rapier-embed); mount the editor or reader, with your app's agent over WebMCP in the editor.
 4. **Keep portable Markdown.** Use [rapier-markdown-kit](https://github.com/jackskip22/rapier-plugins/tree/main/npm/rapier-markdown-kit) for pictures, editable SVG drawings and layout in one `.md` file. Respect [Will/1](https://github.com/jackskip22/will) `keep`, `append` and `edit` regions.
 5. **Encode JPEG XL.** Install [rapier-jxl](https://github.com/jackskip22/rapier-jxl) to encode pixels, photographs and existing JPEGs in JavaScript.

package/dist/ledger/LICENSE

@@ -21,8 +21,11 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 
 Files under this licence carry `SPDX-License-Identifier: MIT` in their first lines: the standard's
-grammar, marks and reference style (`spec/md-layout.mjs`, `spec/md-marks.mjs`, `spec/flowchart.mjs`, `spec/markdown-style.css`), the layout model and line planner
-(`layout/model.mjs`, `layout/line-plan.mjs`, `layout/typography.mjs`),
+grammar, marks and reference style (`spec/md-layout.mjs`, `spec/md-marks.mjs`, `spec/md-source.mjs`, `spec/flowchart.mjs`, `spec/markdown-style.css`), ink geometry
+(`spec/ink.mjs`),
+the layout model and line planner (`layout/model.mjs`, `layout/line-plan.mjs`, `layout/typography.mjs`, `layout/preparation.mjs`,
+`layout/prepared-paragraph.mjs`, `layout/hyphenation.mjs`, `layout/paragraph-fit.mjs`), the animated-picture reader and playback
+the HTML blocks use (`images/gif.mjs`, `images/playback.mjs`),
 the portable HTML and document metadata helpers (`spec/html-blocks.mjs`, `spec/frontmatter.mjs`,
 `spec/document-settings.mjs`, `spec/document-fonts.mjs`), the Will grammar (`agent/will.mjs`), the picture appendix reader and writer
 (`spec/md-assets.mjs`), the two shared-page reference readers (`tools/read-shared-page.mjs`,

package/dist/ledger/carried.mjs

@@ -71,18 +71,21 @@ export function readDocument(source) {
 
 // One portable baseline. A digest is integrity evidence, not authentication of the named author.
 export function readBase(value) {
-  if (!value || typeof value !== 'object' || typeof value.text !== 'string' ||
-      typeof value.sha256 !== 'string' || !/^[a-f0-9]{64}$/.test(value.sha256) || sha256(value.text) !== value.sha256)
+  if (!value || typeof value !== 'object') throw fault('comparison base SHA-256 differs from its text');
+  // Capture each caller-owned field once; admission and serialization use these same scalars.
+  const {text, sha256: digest, revision, name, by, at, fonts} = value;
+  if (typeof text !== 'string' || typeof digest !== 'string' || !/^[a-f0-9]{64}$/.test(digest) || sha256(text) !== digest)
     throw fault('comparison base SHA-256 differs from its text');
-  if (typeof value.revision !== 'string' || !value.revision || value.revision.length > 256 || /[\u0000-\u001f\u007f]/.test(value.revision))
+  if (typeof revision !== 'string' || !revision || revision.length > 256 || /[\u0000-\u001f\u007f]/.test(revision))
     throw fault('invalid comparison base revision');
-  if (typeof value.name !== 'string' || !value.name || [...value.name].length > 256 || /[\\/\u0000-\u001f\u007f]/.test(value.name))
+  if (typeof name !== 'string' || !name || [...name].length > 256 || /[\\/\u0000-\u001f\u007f]/.test(name))
     throw fault('invalid comparison base name');
-  if (typeof value.by !== 'string' || !value.by.trim() || value.by.length > 96 || /[\u0000-\u001f\u007f]/.test(value.by))
+  if (typeof by !== 'string' || !by.trim() || by.length > 96 || /[\u0000-\u001f\u007f]/.test(by))
     throw fault('a comparison needs its author name');
-  if (typeof value.at !== 'string' || !/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{1,3})?Z$/.test(value.at) || !Number.isFinite(Date.parse(value.at)))
+  if (typeof at !== 'string' || !/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{1,3})?Z$/.test(at) || !Number.isFinite(Date.parse(at)))
     throw fault('the time of a comparison is an ISO 8601 UTC timestamp');
-  return {text: value.text, sha256: value.sha256, revision: value.revision, name: value.name, by: value.by, at: value.at};
+  if (fonts != null && typeof fonts !== 'string') throw fault('invalid comparison font resources');
+  return {text, sha256: digest, revision, name, by, at, ...(fonts ? {fonts} : {})};
 }
 const escapeAttribute = value => value.replace(/&/g, '&amp;').replace(/"/g, '&quot;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
 const readAttribute = value => value.replace(/&(quot|lt|gt|amp);/g, (_, name) => ({quot: '"', lt: '<', gt: '>', amp: '&'})[name]);
@@ -91,7 +94,8 @@ export function writeBase(text, value) {
   const base = readBase(value);
   if (base.text === text) return '';
   return '<script type="text/markdown" id="rapier-base"' + ['name', 'sha256', 'revision', 'by', 'at']
-    .map(key => ' data-' + key + '="' + escapeAttribute(base[key]) + '"').join('') + '>' + encodeCarried(base.text) + '</script>';
+    .map(key => ' data-' + key + '="' + escapeAttribute(base[key]) + '"').join('') +
+    (base.fonts ? ' data-fonts="' + escapeAttribute(JSON.stringify(base.fonts)) + '"' : '') + '>' + encodeCarried(base.text) + '</script>';
 }
 export function readBaseElements(elements) {
   const rows = [...elements].filter(element => element.id === 'rapier-base');
@@ -100,7 +104,10 @@ export function readBaseElements(elements) {
   if (rows.length !== 1 || row.type !== 'text/markdown' || (row.tagName && row.tagName.toLowerCase() !== 'script'))
     throw fault('duplicate or executable comparison base');
   const get = name => row.getAttribute ? row.getAttribute('data-' + name) : row[name];
-  return readBase({text: decodeCarried(row.textContent), ...Object.fromEntries(['name', 'sha256', 'revision', 'by', 'at'].map(key => [key, get(key)]))});
+  let fonts;
+  try { const value = get('fonts'); if (value != null) fonts = JSON.parse(value); }
+  catch (_) { throw fault('invalid comparison font resources'); }
+  return readBase({text: decodeCarried(row.textContent), fonts, ...Object.fromEntries(['name', 'sha256', 'revision', 'by', 'at'].map(key => [key, get(key)]))});
 }
 export function takeBase(html) {
   const elements = [];
@@ -113,7 +120,7 @@ export function takeBase(html) {
       seen.add(key); values[key] = value;
     }
     elements.push({id: values.id, type: values.type, textContent: content,
-      ...Object.fromEntries(['name', 'sha256', 'revision', 'by', 'at'].map(key => [key, values['data-' + key]]))});
+      ...Object.fromEntries(['name', 'sha256', 'revision', 'by', 'at', 'fonts'].map(key => [key, values['data-' + key]]))});
     return '';
   });
   return {html: stripped, base: readBaseElements(elements)};

package/dist/ledger/data.mjs

@@ -1,10 +1,7 @@
 // SPDX-License-Identifier: MIT
 // Only plain JSON data enters the public format. Accessors and toJSON are never executed.
 export function fault(message) { return Object.assign(new Error('Ledger: ' + message), {code: 'ledger_invalid'}); }
-export function canonicalJSON(value, depth = 0, active = new Set()) {
-  if (value === null || typeof value === 'boolean') return JSON.stringify(value);
-  if (typeof value === 'string') { if (/[\uD800-\uDFFF]/u.test(value)) throw fault('unpaired surrogate'); return JSON.stringify(value); }
-  if (typeof value === 'number' && Number.isFinite(value) && !Object.is(value, -0)) return JSON.stringify(value);
+function fields(value, depth, active, sorted = true) {
   if (!value || typeof value !== 'object' || depth > 64 || active.has(value)) throw fault('not plain JSON data');
   const array = Array.isArray(value), proto = Object.getPrototypeOf(value);
   if (!array && proto !== null && (Object.getPrototypeOf(proto) !== null || Object.getOwnPropertyDescriptor(proto, 'constructor')?.value?.name !== 'Object')) throw fault('not a plain object');
@@ -15,19 +12,82 @@ export function canonicalJSON(value, depth = 0, active = new Set()) {
     if (typeof key !== 'string' || ['__proto__', 'constructor', 'prototype'].includes(key) || !Object.hasOwn(field, 'value') || !field.enumerable) throw fault('non-data property');
   }
   if (array && (keys.length !== value.length + 1 || keys.some(k => k !== 'length' && (!/^(0|[1-9]\d*)$/.test(k) || +k >= value.length)))) throw fault('sparse array');
+  return {array, descriptors, keys: array ? keys.filter(key => key !== 'length') : sorted ? keys.sort() : keys};
+}
+function scalar(value) {
+  if (value === null || typeof value === 'boolean') return true;
+  if (typeof value === 'string') { if (/[\uD800-\uDFFF]/u.test(value)) throw fault('unpaired surrogate'); return true; }
+  return typeof value === 'number' && Number.isFinite(value) && !Object.is(value, -0);
+}
+// A canonical copy does not need a serialized document and a second parsed document.
+// Sorted insertion preserves the previous plainData result, including numeric-key ordering.
+export function plainData(value) {
+  if (typeof value === 'string') value = JSON.parse(value);
+  const active = new Set();
+  const copy = (value, depth) => {
+    if (scalar(value)) return value;
+    const {array, descriptors, keys} = fields(value, depth, active);
+    const out = array ? [] : {};
+    active.add(value);
+    for (const key of keys) out[key] = copy(descriptors[key].value, depth + 1);
+    active.delete(value); return out;
+  };
+  return copy(value, 0);
+}
+// Each yielded string is bounded, even when one value contains the whole document.
+// JSON.stringify still owns escaping; scalar boundaries keep its spelling exact.
+function* quoted(text, whole = true) {
+  yield '"';
+  for (let at = 0; at < text.length;) {
+    let end = Math.min(text.length, at + 16384);
+    if (end < text.length && (text.charCodeAt(end - 1) & 0xfc00) === 0xd800 && (text.charCodeAt(end) & 0xfc00) === 0xdc00) end--;
+    const part = text.slice(at, end);
+    if (whole && /[\uD800-\uDFFF]/u.test(part)) throw fault('unpaired surrogate');
+    yield JSON.stringify(part).slice(1, -1); at = end;
+  }
+  yield '"';
+}
+function* dataParts(value, depth, active, sorted) {
+  if (typeof value === 'string') { yield* quoted(value); return; }
+  if (value === null || typeof value === 'boolean' || typeof value === 'number' && Number.isFinite(value) && !Object.is(value, -0)) {
+    yield JSON.stringify(value); return;
+  }
+  const {array, descriptors, keys} = fields(value, depth, active, sorted);
   active.add(value);
-  const encode = item => canonicalJSON(item, depth + 1, active);
-  const out = array ? '[' + Array.from({length: value.length}, (_, i) => encode(descriptors[i].value)).join(',') + ']'
-    : '{' + keys.sort().map(key => JSON.stringify(key) + ':' + encode(descriptors[key].value)).join(',') + '}';
-  active.delete(value); return out;
+  yield array ? '[' : '{';
+  for (let i = 0; i < keys.length; i++) {
+    if (i) yield ',';
+    const key = keys[i];
+    if (!array) { yield* quoted(key, false); yield ':'; }
+    yield* dataParts(descriptors[key].value, depth + 1, active, sorted);
+  }
+  yield array ? ']' : '}';
+  active.delete(value);
 }
-export function plainData(value) { return JSON.parse(canonicalJSON(typeof value === 'string' ? JSON.parse(value) : value)); }
+export function canonicalParts(value, depth = 0, active = new Set()) { return dataParts(value, depth, active, true); }
+export function jsonParts(value) { return dataParts(value, 0, new Set(), false); }
+export function canonicalJSON(value, depth = 0, active = new Set()) { return Array.from(canonicalParts(value, depth, active)).join(''); }
 export function exactKeys(value, keys) {
   return value && typeof value === 'object' && !Array.isArray(value) && Object.keys(value).length === keys.length && keys.every(key => Object.hasOwn(value, key));
 }
-export function documentText(text) {
-  if (typeof text !== 'string' || /[\uD800-\uDFFF]/u.test(text)) throw fault('document is not whole-character text');
-  if (new TextEncoder().encode(text).length > 64 * 1024 * 1024) throw fault('document exceeds the editor text limit');
-  return text;
+// TextEncoder's exact byte count, without allocating an encoded copy. Whole-character
+// admission is performed in this same pass when the document owner requests it.
+export function utf8Length(text, whole = false) {
+  let bytes = 0;
+  for (let at = 0; at < text.length; at++) {
+    const code = text.charCodeAt(at);
+    if (code < 0x80) bytes++;
+    else if (code < 0x800) bytes += 2;
+    else if ((code & 0xfc00) === 0xd800 && (text.charCodeAt(at + 1) & 0xfc00) === 0xdc00) { bytes += 4; at++; }
+    else { if (whole && code >= 0xd800 && code <= 0xdfff) throw fault('document is not whole-character text'); bytes += 3; }
+  }
+  return bytes;
+}
+export function documentBytes(text) {
+  if (typeof text !== 'string') throw fault('document is not whole-character text');
+  const bytes = utf8Length(text, true);
+  if (bytes > 64 * 1024 * 1024) throw fault('document exceeds the editor text limit');
+  return bytes;
 }
+export function documentText(text) { documentBytes(text); return text; }
 export const nonnegative = value => Number.isSafeInteger(value) && value >= 0 && !Object.is(value, -0);