rapier-html 1.1.14 → 1.1.21

package/BUILD.json

@@ -1,10 +1,10 @@
 {
   "package": "rapier-html",
-  "version": "1.1.14",
+  "version": "1.1.21",
   "path": "rapier.html",
-  "bytes": 1811175,
-  "sha256": "39205eaef21f2bd55e03b7d4ed41b87d0708aad3b9196dbcc40eca02b4eea10f",
-  "builtAt": "2026-09-29T19:20:54.502Z",
+  "bytes": 1551980,
+  "sha256": "2ff760ab90f2eeb4b7afae6cd2eb2acf23d0479823c9a57b1ad16cb3cd509220",
+  "builtAt": "2026-09-30T16:20:55.079Z",
   "node": "v22.22.2",
   "canonical": true,
   "packing": "zopfli",

package/README.md

@@ -4,75 +4,40 @@ Rapier, the offline Markdown editor, as one HTML page with your document inside
 install, nothing fetched to open, edit or save. Node 22 or newer.
 
 ```sh
-npx -- rapier-html@1.1.14 notes.md                          # the editor, notes.md inside it, written beside the file
-npx -- rapier-html@1.1.14 notes.md --view draw              # opens on Draw: sketch and paint, the document behind it
-npx -- rapier-html@1.1.14 notes.md --view notes             # opens on Notes: the document as cards
-npx -- rapier-html@1.1.14 notes.md --drawing sketch.svg     # carries a drawing, opened on Draw over the document
-npx -- rapier-html@1.1.14 proposal.md --base original.md    # opens on the diff of a proposed change
-npx -- rapier-html@1.1.14 notes.md --return "$RETURN_URL" --return-expires-at "$RETURN_EXPIRES_AT" # Send back
-npx -- rapier-html@1.1.14 notes.md out.html                 # a named output
-npm install rapier-html@1.1.14                              # as a library: wrap, unwrap
+npx -- rapier-html@1.1.21 notes.md                          # the editor, notes.md inside it, written beside the file
+npx -- rapier-html@1.1.21 notes.md --view draw              # opens on Draw: sketch and paint, the document behind it
+npx -- rapier-html@1.1.21 notes.md --view notes             # opens on Notes: the document as cards
+npx -- rapier-html@1.1.21 notes.md --drawing sketch.svg     # carries a drawing, opened on Draw over the document
+npx -- rapier-html@1.1.21 proposal.md --base original.md    # opens on the diff of a proposed change
+npx -- rapier-html@1.1.21 notes.md --return "$RETURN_URL" --return-expires-at "$RETURN_EXPIRES_AT" # Send back
+npx -- rapier-html@1.1.21 notes.md out.html                 # a named output
+npm install rapier-html@1.1.21                              # as a library: wrap, unwrap
 ```
 
 The first `--` is for npm, so `--help` reaches the command. It never overwrites a file.
 
-## What the page can do
-
-**Write**
-- Markdown the way it reads: headings, lists, checklists, tables, code, quotes, footnotes, pictures placed
-  around text.
-- Find and replace, Undo, a source view of the exact bytes.
-- Supported Mermaid flowchart fences draw offline in Rapier's look, so an agent can write a fence or use figures; other diagrams and math use optional plugins.
-
-**Draw and paint**
-- Shapes, lines, arrows, text on a canvas that goes into the document as a picture.
-- Paint with real brushes: pencil, pen, ink, watercolour that runs and dries, oil that mixes, a smudge
-  finger; dip the brush for more paint or more water.
-- Your own brush files, a dropper, paint laid over the drawing as a layer of its own.
-
-**Notes**
-- The document as cards: sections, drag to reorder, search across every note.
-- Voice recordings, reminders, a recycle bin that keeps seven days.
-- Import from Keep, Notion, Evernote, Joplin, Bear, Simplenote, OneNote, Obsidian and more.
-
-**Review a change**
-- Open on the diff of a proposal against the original; keep or drop each change; nothing applies until
-  the person says so.
-- Will markers in the Markdown say what an agent may change: `keep`, `append`, `edit`.
-
-**Keep it**
-- Save to the device, share the page on, open it again anywhere a browser is; offline throughout.
-- Export the document as Markdown or as a web page; print it.
-
-**For agents**
-- Hand a person a document, a sketch or a change as one file that opens with one click.
-- What they save comes back byte for byte through `unwrap`.
-- Add the return URL from `document.create_return`: the person edits the page and presses Send back;
-  `document.wait_for_user` wakes the agent, which reads the exact returned Markdown and continues.
+The page is the whole editor: write, draw and paint, the document as Notes cards, Find and replace, Undo, a
+source view of the exact bytes; save to the device, share the page on, export Markdown or a web page, print; all
+offline. Opened with `--base` it shows the diff of a proposal against the original, and the person keeps or drops
+each change. Will markers in the Markdown say what an agent may change: `keep`, `append`, `edit`.
 
 ## Send an edited document back
 
-Call `document.create_return` on the Rapier agent door for the document's workspace. Pass its
-`return_url` and `return_expires_at` as `--return "$RETURN_URL" --return-expires-at "$RETURN_EXPIRES_AT"`
-or `wrap(..., {return: return_url, return_expires_at})`. Both values come from the same mint. Only the worker's
-HTTPS return route at `https://mcp.rapier.website/return/…` is accepted. The page shows Send back
-in Share; a page without an address has no such action.
-
-The person reads and edits offline, then presses Send back when ready. That press sends the current
-source and filename once, and shows acceptance or the worker's refusal. After acceptance, that page
-sends nothing again. Save to the device stays local. The return URL lasts up to one day, accepts one
-document up to 25 MiB, and grants no read or edit access to the agent's workspace.
+Call `document.create_return` on the Rapier agent door for the document's workspace and pass its `return_url`
+and `return_expires_at` as `--return "$RETURN_URL" --return-expires-at "$RETURN_EXPIRES_AT"`, or
+`wrap(..., {return: return_url, return_expires_at})`. Only the worker's HTTPS return route at
+`https://mcp.rapier.website/return/…` is accepted. The page then shows Send back in Share; a page without an
+address has no such action.
 
-Once the carried expiry passes, Share offers Save in place of Send back: the work is safe on the page.
-A used or expired return refused by the worker offers the same Save. Saving keeps the current words,
-filename, byte-order mark and line endings through the normal local save path. Bring that file back to the
-assistant, which compares it against the workspace's current work and creates a fresh return for the next
-handoff; the old capability stays spent.
+The person edits offline and presses Send back: the current source and filename go once, the page shows the
+acceptance or the worker's refusal, and it sends nothing again. The return lasts up to one day, takes one
+document up to 25 MiB and grants no access to the agent's workspace. After the expiry, or a refusal, Share offers
+Save instead; bring that file back to the assistant for a fresh return.
 
-The agent's `document.wait_for_user` returns a `returned` receipt with the `return_id`, name and time.
-`document.get_context` lists receipts even when no agent was waiting. Read the source with
-`document.read_context({return_id, start: 0})`, continuing at the returned `end` until `complete`.
-The returned copy stays separate from the workspace's current document, so newer work survives too.
+The agent's `document.wait_for_user` returns a `returned` receipt with the `return_id`, name and time;
+`document.get_context` lists receipts; `document.read_context({return_id, start: 0})` reads the source,
+continuing at the returned `end` until `complete`. The returned copy stays separate from the workspace's
+current document.
 
 ## As a library
 
@@ -89,9 +54,9 @@ console.log('words back exactly:', unwrap(page).text === words);
 await writeFile('hello.rapier.html', page, {flag: 'wx'});        // 'wx': never over an existing file
 ```
 
-`wrap(rapierHtml, text, name, {view, drawing, drawingName, base, baseName, return: returnURL, return_expires_at})` and `unwrap(pageHtml)`,
-which returns `{html, text, name, view, drawing, drawingName, base, baseName, return: returnURL, return_expires_at}` with `null` for what a
-page does not carry. Also exported: `encodeCarried`, `decodeCarried`, `main`.
+`wrap(rapierHtml, text, name, {view, drawing, drawingName, base, baseName, return: returnURL, return_expires_at})`
+and `unwrap(pageHtml)`, which returns the same fields with `null` for what a page does not carry. Also exported:
+`encodeCarried`, `decodeCarried`, `main`.
 
 ## How the page carries the document
 
@@ -105,13 +70,12 @@ fact of the file and written back on Save.
 
 ## Safety
 
-- It never overwrites: an output that exists, the document itself included, is refused. Unknown options,
-  a `--view` that is not `draw` or `notes`, a `--drawing` or `--base` with no file, a missing or repeated
-  `--return` or `--return-expires-at`, a return without its expiry, an invalid expiry, an unsafe return URL and a third filename are refused too.
-- Nothing reports on the page's use. It reaches the network only when the document or the person asks:
-  a picture or video the document links to, the math, diagram and PDF-import helpers on first use,
-  or the person's Send back press. A return URL names only the worker's exact origin and return route;
-  credentials, query strings and fragments are refused by both the writer and carried-page boot.
+- It never overwrites: an existing output, the document itself included, is refused, as are unknown options, a
+  `--view` other than `draw` or `notes`, a `--drawing` or `--base` with no file, a return without its expiry, an
+  invalid expiry, an unsafe return URL and a third filename.
+- Nothing reports on the page's use. It reaches the network only when the document or the person asks: a linked
+  picture or video, the maths, diagram and PDF-import helpers on first use, or Send back. A return URL names only
+  the worker's exact origin and route; credentials, query strings and fragments are refused.
 
 ## Licence
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rapier-html",
-  "version": "1.1.14",
+  "version": "1.1.21",
   "description": "Rapier, the offline Markdown editor, as one HTML page with your document inside it: write, draw and paint, notes, the diff of a change; no account, nothing fetched.",
   "keywords": [
     "markdown",

package/page.mjs

@@ -7,6 +7,9 @@ const DRAWING_START = '<script type="text/plain" id="rapier-drawing"';
 // The text the document was proposed against (docs/page-door.md, "2. A change carried"): the page opens on its diff.
 const BASE_START = '<script type="text/markdown" id="rapier-base"';
 const END = '</script>';
+// The page's search words (rapier.html's RAPIER_SEO regions: description, canonical address, previews, structured data and the plain guide
+// a crawler reads) are rapier.website's own. A page that carries someone's document never claims that address or that description.
+const SEARCH_WORDS = /<!-- RAPIER_SEO_BEGIN -->[\s\S]*?<!-- RAPIER_SEO_END -->\n?/g;
 
 // One encoding, exactly reversible (docs/page-door.md, "What a block may hold"): no `<` before `/` or `!`, no CR, no NUL.
 // engine.js _rapierDecodeCarried is its inverse.
@@ -46,7 +49,7 @@ export function wrap(pageHtml, text, name, options) {
 		if (typeof opts.base !== 'string') throw new Error('the base must be text');
 		carriedBlocks += '\n' + BASE_START + ' data-name="' + safeName(opts.baseName, docName) + '">' + encodeCarried(opts.base) + END;
 	}
-	const stripped = unwrap(pageHtml).html;
+	const stripped = unwrap(pageHtml).html.replace(SEARCH_WORDS, '');
 	// Before Rapier's scripts: parsed before the engine boots.
 	const bodyTag = /<body[^>]*>/.exec(stripped);
 	if (!bodyTag) throw new Error('not a Rapier page: no <body>');