rapier-html 1.2.12 → 1.2.15

package/BUILD.json

@@ -1,10 +1,10 @@
 {
   "package": "rapier-html",
-  "version": "1.2.12",
+  "version": "1.2.15",
   "path": "dist/rapier.html",
-  "bytes": 5252185,
-  "sha256": "3f6e80c2bc5f8a5c1e5bad1826abc15b08ad11347c3c92a4005da1a0f136970e",
-  "builtAt": "2026-10-18T14:10:49.865Z",
+  "bytes": 5256020,
+  "sha256": "0ddaf7fd3564de7c9edbe954e21f2294993f851c3d9de37c1a465ebe6e3d381a",
+  "builtAt": "2026-10-19T02:29:57.696Z",
   "node": "v22.23.3",
   "canonical": true,
   "packing": "zopfli",

package/README.md

@@ -2,14 +2,14 @@
 
 Turn Markdown into one offline HTML file that contains the full Rapier editor. It opens in any browser, on a phone or
 computer, with no account. People read, edit, draw and paint; agents hand over documents, show what changed and get
-the edited copy back. Start with `npx rapier-html@1.2.12 notes.md`.
+the edited copy back. Start with `npx rapier-html@1.2.15 notes.md`.
 
 Use it for a plan to rearrange, a guide to annotate, a draft to keep writing, or a revision to review. The file works
 without any hosted workspace.
 
 - The page writes, saves Markdown, exports Word, PDF and a web page, and prints. It needs no account and fetches
   nothing to open, edit or save. It is the base editor (about 1.7 MB) with the plug-ins the document displays with
-  (Math, Mermaid); `--include draw` adds drawing and painting. Notes never travel.
+  (Math, Mermaid, and page layout for a template page); `--include draw` adds drawing and painting. Notes never travel.
 - `--return` adds a one-use Send back address from the agent door.
 - `--view draw` opens on Draw. `--compare original.md` opens the edit with its diff; `--by <name>` attributes it.
 - `writePage(text, name)` makes the page in one call; `unwrap` gives the document back, exactly.
@@ -17,14 +17,14 @@ without any hosted workspace.
 Needs Node 22 or newer.
 
 ```sh
-npx -- rapier-html@1.2.12 notes.md                          # the editor, notes.md inside it, written beside the file
-npx -- rapier-html@1.2.12 notes.md --view draw              # opens on Draw: sketch and paint, the document behind it
-npx -- rapier-html@1.2.12 notes.md --include draw,math     # carries Draw and Math (default: what the document needs)
-npx -- rapier-html@1.2.12 notes.md --drawing sketch.svg     # carries a drawing, opened on Draw over the document
-npx -- rapier-html@1.2.12 revised.md --compare original.md # opens showing what changed
-npx -- rapier-html@1.2.12 notes.md --return "$RETURN_URL" --return-expires-at "$RETURN_EXPIRES_AT" # Send back
-npx -- rapier-html@1.2.12 notes.md out.html                 # a named output
-npm install rapier-html@1.2.12                              # as a library: writePage, unwrap
+npx -- rapier-html@1.2.15 notes.md                          # the editor, notes.md inside it, written beside the file
+npx -- rapier-html@1.2.15 notes.md --view draw              # opens on Draw: sketch and paint, the document behind it
+npx -- rapier-html@1.2.15 notes.md --include draw,math     # carries Draw and Math (default: what the document needs)
+npx -- rapier-html@1.2.15 notes.md --drawing sketch.svg     # carries a drawing, opened on Draw over the document
+npx -- rapier-html@1.2.15 revised.md --compare original.md # opens showing what changed
+npx -- rapier-html@1.2.15 notes.md --return "$RETURN_URL" --return-expires-at "$RETURN_EXPIRES_AT" # Send back
+npx -- rapier-html@1.2.15 notes.md out.html                 # a named output
+npm install rapier-html@1.2.15                              # as a library: writePage, unwrap
 ```
 
 The first `--` is for npm, so `--help` reaches the command. It never overwrites a file.

package/dist/page.d.mts

@@ -1,6 +1,6 @@
 // SPDX-License-Identifier: MIT
 // rapier-html: Markdown to one offline HTML file that carries its exact source, and back.
-export type Part = 'drawing' | 'math' | 'mermaid';
+export type Part = 'drawing' | 'layout' | 'math' | 'mermaid';
 export type DocKind = 'markdown' | 'text' | 'code';
 export interface WrapOptions {
   kind?: DocKind;

package/dist/page.mjs

@@ -11,10 +11,11 @@ export async function writePage(text, name = 'document.md', {include, ...options
 	const carries = include ?? [...(options.view === 'draw' || options.drawing != null ? ['drawing'] : []), ...portableNeeds(String(text), {base: options.base})];
 	return wrap(carry(await carriedPage(), carries), text, name, options);
 }
-const USAGE = 'usage: rapier-html <document.md> [out.html] [--include draw,math,mermaid] [--view draw] [--drawing sketch.svg] [--compare original.md [--by <your name>]] [--return <url> --return-expires-at <timestamp>]\n' +
+const USAGE = 'usage: rapier-html <document.md> [out.html] [--include draw,layout,math,mermaid] [--view draw] [--drawing sketch.svg] [--compare 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' +
-	'  --include   what the file carries beyond the base editor: draw (drawing and painting), math, mermaid, or none;\n' +
+	'  --include   what the file carries beyond the base editor: draw (drawing and painting), layout (a template page), math,\n' +
+	'              mermaid, or none;\n' +
 	'              by default, the plug-ins the document displays with, and Draw for --view draw or --drawing\n' +
 	'  --view      draw: opens the page on Draw (sketch and paint, the document behind it)\n' +
 	'  --drawing   carries an SVG drawing alongside the document, opened on Draw as the page boots\n' +
@@ -40,7 +41,7 @@ export async function main(argv, pagesDir, {log = console.log} = {}) {
 		}
 		else if (arg === '--include') {
 			const listed = argv[i + 1] === 'none' ? [] : String(argv[i + 1] || '').split(',');
-			if (include !== null || listed.some(item => !['draw', 'math', 'mermaid'].includes(item))) throw new Error('--include takes draw, math and mermaid, comma-separated, or none');
+			if (include !== null || listed.some(item => !['draw', 'layout', 'math', 'mermaid'].includes(item))) throw new Error('--include takes draw, layout, math and mermaid, comma-separated, or none');
 			include = listed.map(item => item === 'draw' ? 'drawing' : item);
 			i++;
 		}