rapier-html 1.1.87 → 1.1.89

package/BUILD.json

@@ -1,10 +1,10 @@
 {
   "package": "rapier-html",
-  "version": "1.1.87",
+  "version": "1.1.89",
   "path": "dist/rapier.html",
-  "bytes": 2268085,
-  "sha256": "de1f732bce1e8292ff1d967eca0e2c5d2251d52dd9cbf24cdb880120ededb4c4",
-  "builtAt": "2026-10-09T07:07:05.331Z",
+  "bytes": 2297314,
+  "sha256": "7a59454e6a82c474335933b9dbba6494490cdb6a6c1b021bc425b5d848db63fb",
+  "builtAt": "2026-10-10T00:06:12.965Z",
   "node": "v22.23.3",
   "canonical": true,
   "packing": "zopfli",

package/README.md

@@ -6,25 +6,25 @@ editor, offline, with the document inside.
 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.
 
-- The page writes, draws and paints, saves Markdown, exports a web page and prints, with no account and nothing
-  fetched to open, edit or save.
+- The page writes, draws and paints, saves Markdown, exports Word, PDF and a web page, and prints, with no account
+  and nothing fetched to open, edit or save.
 - `--return` adds a one-use Send back address from the agent door: the person edits offline, presses Send back,
   and the agent reads the returned copy.
-- `--view draw` opens on Draw; `--base original.md` opens on the diff of a proposed change, and the person keeps
+- `--view draw` opens on Draw; `--propose original.md` opens on the diff of a proposed change, and the person keeps
   or drops each change; `--by <name>` says on that diff who proposed it and when.
 - `wrap` and `unwrap` carry a document into a page and out again, exactly, for programs.
 
 Node 22 or newer.
 
 ```sh
-npx -- rapier-html@1.1.87 notes.md                          # the editor, notes.md inside it, written beside the file
-npx -- rapier-html@1.1.87 notes.md --view draw              # opens on Draw: sketch and paint, the document behind it
-npx -- rapier-html@1.1.87 notes.md --view notes             # opens the Notes library
-npx -- rapier-html@1.1.87 notes.md --drawing sketch.svg     # carries a drawing, opened on Draw over the document
-npx -- rapier-html@1.1.87 proposal.md --base original.md    # opens on the diff of a proposed change
-npx -- rapier-html@1.1.87 notes.md --return "$RETURN_URL" --return-expires-at "$RETURN_EXPIRES_AT" # Send back
-npx -- rapier-html@1.1.87 notes.md out.html                 # a named output
-npm install rapier-html@1.1.87                              # as a library: wrap, unwrap
+npx -- rapier-html@1.1.89 notes.md                          # the editor, notes.md inside it, written beside the file
+npx -- rapier-html@1.1.89 notes.md --view draw              # opens on Draw: sketch and paint, the document behind it
+npx -- rapier-html@1.1.89 notes.md --view notes             # opens the Notes library
+npx -- rapier-html@1.1.89 notes.md --drawing sketch.svg     # carries a drawing, opened on Draw over the document
+npx -- rapier-html@1.1.89 --propose original.md proposal.md # opens on the diff of a proposed change
+npx -- rapier-html@1.1.89 notes.md --return "$RETURN_URL" --return-expires-at "$RETURN_EXPIRES_AT" # Send back
+npx -- rapier-html@1.1.89 notes.md out.html                 # a named output
+npm install rapier-html@1.1.89                              # as a library: wrap, unwrap
 ```
 
 The first `--` is for npm, so `--help` reaches the command. It never overwrites a file.
@@ -86,18 +86,12 @@ fact of the file and written back on Save.
 ## Safety
 
 - 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
+  `--view` other than `draw` or `notes`, a `--drawing` or `--propose` 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
-
-AGPL-3.0-only (`LICENSE`): the page is the Rapier editor with the notices of the libraries it carries.
-The Markdown standard without the editor is `rapier-markdown-kit` (MIT). Rapier is https://rapier.website.
-`BUILD.json` records the page's size, SHA-256, build time and Node version.
-
+  picture or video, a plug-in on first use (maths, diagrams, PDF import, text in pictures, a letter set), or
+  Send back. A return URL names only the worker's exact origin and route; credentials, query strings and fragments
+  are refused.
 
 ## Optional edit history
 
@@ -110,3 +104,9 @@ of attaching false history. Saved Markdown written with the kit's
 `ledger/carried.writeDocument` is read automatically when wrapping. Rewrapping a
 page without parts drops its previous document's parts. Published npm files carry
 their own staged MIT validator closure; no source checkout is needed.
+
+## Licence
+
+AGPL-3.0-only (`LICENSE`): the page is the Rapier editor with the notices of the libraries it carries.
+The Markdown standard without the editor is `rapier-markdown-kit` (MIT). Rapier is https://rapier.website.
+`BUILD.json` records the page's size, SHA-256, build time and Node version.

package/dist/page.mjs

@@ -4,15 +4,14 @@ import {basename, dirname, join} from 'node:path';
 import {wrap} from './wrap.mjs';
 import {returnAddress, returnExpiresAt} from './return-address.mjs';
 export {wrap, unwrap, encodeCarried, decodeCarried} from './wrap.mjs';
-// Unknown options, a bare --drawing or --base and a third name are refused, never dropped.
-const USAGE = 'usage: rapier-html <document.md> [out.html] [--view draw|notes] [--drawing sketch.svg] [--base original.md [--by <your name>]] [--return <url> --return-expires-at <timestamp>]\n' +
+// Unknown options, a bare --drawing or --propose and a third name are refused, never dropped.
+const USAGE = 'usage: rapier-html <document.md> [out.html] [--view draw|notes] [--drawing sketch.svg] [--propose original.md [--by <your name>]] [--return <url> --return-expires-at <timestamp>]\n' +
 	'  writes <document>.rapier.html beside the file: Rapier with the document inside it, one file, offline.\n' +
 	'  It never overwrites: an output that already exists, the document itself included, is refused.\n' +
 	'  --view      opens the page on Draw (sketch and paint, the document behind it) or on Notes\n' +
 	'  --drawing   carries an SVG drawing alongside the document, opened on Draw as the page boots\n' +
-	'  --propose   <base.md> <proposed.md>: carries the original base for per-change review\n' +
-	'  --base      the older spelling of --propose; carries the text the document was proposed against; the page opens on their diff\n' +
-	'  --by        with --base: who proposes it, shown on the diff with the time the page was made\n' +
+	'  --propose   carries the text the document was proposed against; the page opens on their diff for per-change review\n' +
+	'  --by        with --propose: who proposes it, shown on the diff with the time the page was made\n' +
 	'  --return    carries a one-use return URL from document.create_return; Share offers Send back\n' +
 	'  --return-expires-at  carries the same mint\'s expiry; Share offers Save once the return expires\n' +
 	'  --          everything after it is a filename, even one that starts with a dash\n' +
@@ -29,8 +28,8 @@ export async function main(argv, pagesDir, {log = console.log} = {}) {
 			if (view !== null || !['draw', 'notes'].includes(argv[i + 1])) throw new Error('--view takes draw or notes');
 			view = argv[++i];
 		}
-		else if (arg === '--base' || arg === '--propose') {
-			if (basePath !== null || !argv[i + 1] || argv[i + 1].startsWith('-')) throw new Error('--base takes one text file (write a name that starts with a dash as ./-original.md)');
+		else if (arg === '--propose') {
+			if (basePath !== null || !argv[i + 1] || argv[i + 1].startsWith('-')) throw new Error('--propose takes one text file (write a name that starts with a dash as ./-original.md)');
 			basePath = argv[++i];
 		}
 		else if (arg === '--by') {
@@ -57,7 +56,7 @@ export async function main(argv, pagesDir, {log = console.log} = {}) {
 	const out = named || join(dirname(input), name.replace(/\.(md|markdown|txt)$/i, '') + '.rapier.html');
 	const wrapOptions = {};
 	if (drawingPath) { wrapOptions.drawing = await readFile(drawingPath, 'utf8'); wrapOptions.drawingName = basename(drawingPath); }
-	if (by !== null && !basePath) throw new Error('--by names who proposes a change: give the --base it proposes over');
+	if (by !== null && !basePath) throw new Error('--by names who proposes a change: give the --propose file it proposes over');
 	if (basePath) { wrapOptions.base = await readFile(basePath, 'utf8'); wrapOptions.baseName = basename(basePath); wrapOptions.at = new Date().toISOString(); }
 	if (by !== null) { wrapOptions.by = by; wrapOptions.at = new Date().toISOString(); }
 	if (view) wrapOptions.view = view;