rapier-markdown-kit 1.1.0

package/LICENSE

@@ -0,0 +1,40 @@
+MIT License
+
+Copyright (c) 2026 Jack Skipworth
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+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 and marks (`spec/md-layout.mjs`, `spec/md-marks.mjs`), the layout model and line planner
+(`layout/model.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`,
+`tools/read-shared-page.py`), and the host helper `packages/rapier-embed/embed.mjs`. The vendored Pretext (`agent/vendor/pretext`) and micromark carry their
+own MIT notices. Everything else in Rapier is AGPL-3.0-only (see `LICENSE`).
+
+The picture appendix reader and writer used to be part of `images/assets.mjs`, a file that also
+holds JPEG XL/raster header inspection and SVG sanitizing -- both of which reach the editor's own
+AGPL-3.0-only decoders (`images/raster.mjs`, `draw/font.mjs`), so the whole file could not honestly
+sit in this list. The appendix logic (`parseAssets`, `documentAssets`, `imageEnvironment`,
+`mayRetireImageDefinitions`, `retireDeletedImageDefinitions`, `assetOmissions`, `isAssetBlock`,
+`serializeAsset`, `appendAssetText`, `appendAsset`, and the small markdown-it plumbing they share)
+depends on nothing but a markdown-it factory, so it lives in `spec/md-assets.mjs`; `images/assets.mjs`
+re-imports and re-exports that surface unchanged (one owner, no copy) and keeps everything that
+needs the AGPL decoders, so it is AGPL-3.0-only like the rest of the editor. The `rapier-markdown-kit`
+package re-exports `spec/md-assets.mjs` directly, never `images/assets.mjs`, so its import graph
+never touches AGPL code.

package/README.md

@@ -0,0 +1,102 @@
+# rapier-markdown-kit
+
+Read and write the Rapier Markdown standard -- picture layout, text marks, Will intent markers and
+the picture appendix -- and lay text out around pictures exactly as Rapier does, without taking the
+Rapier editor.
+
+**MIT. No Rapier required. No npm dependencies.** The text layout engine it uses, Pretext, is
+vendored inside the package with its own MIT licence. Nothing from the editor, Draw, the image
+decoders or the apps is in here.
+
+## Install
+
+Node 22 or newer:
+
+```sh
+npm install rapier-markdown-kit
+```
+
+## What it gives you
+
+| Import | What it is |
+| --- | --- |
+| `rapier-markdown-kit/layout` | The `md-layout:v1` comment a picture carries: parse it, validate it, write it back. |
+| `rapier-markdown-kit/marks` | Text colour and page-break markers. |
+| `rapier-markdown-kit/model` | Occupancy profiles and the line planner: the wrapping itself. |
+| `rapier-markdown-kit/will` | The Will/1 grammar (a separate, optional standard): the markers around an agent's intent regions. |
+| `rapier-markdown-kit/assets` | The picture appendix: the reference definitions a document's pictures live in. It never decodes a picture. |
+| `rapier-markdown-kit` | All five in one import. |
+
+Every convention here is plain Markdown or an HTML comment that other readers ignore. Laying lines
+out exactly as Rapier does also takes the same font metrics, which the host supplies (below).
+
+## Example
+
+Save this as `example.mjs` in the folder you installed into and run `node example.mjs`. It prints
+`lines: 4 height: 80`.
+
+```js
+import {parseLayout} from 'rapier-markdown-kit/layout';
+import {parseProfile, pictureSlices, prepareRun, flowLines, prepareRichInline} from 'rapier-markdown-kit/model';
+const {loadDocuments, installMeasurer} = await import(new URL(
+  './dist/kit/conformance/measurer.mjs', import.meta.resolve('rapier-markdown-kit/package.json')));
+
+// Text metrics: the widths the conformance documents recorded in Rapier's own browser, standing in
+// for a font shaper so the example runs anywhere (see "What the host supplies").
+installMeasurer(loadDocuments());
+
+// 1. Parse the layout comment a picture carries.
+const layout = parseLayout('<!--md-layout:v1 width=40% wrap=around x=25%-->');
+// => {width: 40, wrap: 'around', x: 25}
+
+// 2. The picture's shape: the occupancy descriptor Rapier's exports carry beside a picture
+// (`data-rapier-occupancy`, one left-right pair per horizontal band), placed as obstacles.
+const profile = parseProfile('0.1-0.9|0.2-0.8|0.3-0.7');
+const obstacles = pictureSlices(profile, /* x */ 0, /* y */ 0, /* width */ 120, /* height */ 90);
+
+// 3. Plan the lines of a paragraph around those obstacles.
+const text = 'This anchor paragraph carries enough ordinary prose', font = 'normal 400 17.6px Geist, system-ui, sans-serif';
+const run = prepareRun(text, font);
+const flow = prepareRichInline([{text: run.raw, font, letterSpacing: 0}]);
+const plan = flowLines(flow, /* column width */ 300, /* top */ 0, obstacles, /* line height */ 20, /* min slot */ 40);
+// Each line carries its own x, y and width, and the text fragments laid into it.
+console.log('lines:', plan.lines.length, 'height:', plan.height); // lines: 4 height: 80
+```
+
+## What the host supplies
+
+`prepareRun` and `prepareRichInline` measure text the way a browser does: they need a global
+`OffscreenCanvas` (or a DOM `document`) whose `getContext('2d')` has a settable `font` and a
+`measureText(text)` returning `{width}`. A browser has one already; in Node, put those two members
+in front of whatever shaper you have. The example replays recorded measurements instead, and a
+query they never recorded falls back to summing single characters, without kerning or shaping.
+
+`alphaProfile(image)` samples a decoded `<img>` through a canvas, so it needs a browser. Without
+one, read the saved descriptor with `parseProfile`, or sample the picture with your own image
+library. `polygonProfile` and `rasterTiltProfile` are plain geometry.
+
+The appendix parser takes a markdown-it-compatible parser factory from the caller
+(`parseAssets(source, factory)`, or once through `configureParser`); no parser is bundled.
+
+## Conformance
+
+```sh
+node node_modules/rapier-markdown-kit/dist/kit/conformance/run.mjs
+```
+
+Thirteen small documents, each with the line boxes Rapier's own export produced for it. The runner
+reports two things separately. **Preservation**: every layout comment round-trips exactly (12 of
+the 12 documents that carry one). **Presentation**: how closely the planned lines match (4 agree
+within 2px, 9 are close, none differ); each close row has a named cause, given in the runner's
+output and in `dist/kit/conformance/README.md`. `--impl path/to/module.mjs` runs another
+implementation against the same documents; `--tolerance 2` sets the pixel tolerance.
+
+## Licence
+
+MIT, the full text in `LICENSE`; every module keeps its own MIT line. Pretext's licence, notice and
+pinned source inventory are in `dist/agent/vendor/pretext/`. The Rapier editor is AGPL-3.0-only and
+none of it is in this package. The kit's version is its own and does not follow the editor's.
+
+## Where the modules live
+
+Each module of the standard has one home in the Rapier source (`spec/`, `layout/`, `agent/`), where Rapier itself reads it; `dist/` is that closure copied byte for byte, so an installed copy needs nothing beside it.

package/dist/agent/vendor/pretext/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pretext contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/agent/vendor/pretext/NOTICE

@@ -0,0 +1,15 @@
+Pretext 0.0.9
+Copyright (c) 2026 Pretext contributors
+https://github.com/chenglou/pretext
+MIT license: see LICENSE.
+
+Vendored from the user-supplied pretext-main source snapshot.
+SOURCE.json records every original and generated module hash.
+Node's built-in TypeScript transform generated these ESM modules;
+the upstream runtime implementation is unchanged.
+
+Upstream README credits Sebastian Markbage's text-layout research:
+canvas measureText for shaping, bidi from pdf.js, and streaming line breaking.
+Upstream src/bidi.ts identifies its simplified bidi metadata helper as
+forked from pdf.js through Sebastian's text-layout. This provenance applies
+to the generated bidi.js module as well.

package/dist/agent/vendor/pretext/SOURCE.json

@@ -0,0 +1,85 @@
+{
+  "package": "@chenglou/pretext",
+  "version": "0.0.9",
+  "releaseDate": "2026-09-07",
+  "repository": "https://github.com/chenglou/pretext",
+  "sourceSnapshot": "User-supplied pretext-main archive; no commit identifier included",
+  "license": "MIT",
+  "licenseSha256": "e9355cb16457e81acd97dac2e50f2f8bbf2a9a464025f9c46db3680cf9598846",
+  "exports": {
+    ".": "./layout.js",
+    "./rich-inline": "./rich-inline.js"
+  },
+  "compiler": {
+    "runtime": "v24.19.0",
+    "api": "node:module.stripTypeScriptTypes",
+    "mode": "transform"
+  },
+  "changes": "TypeScript erased by the Node built-in transform; attribution header added. Runtime semantics and module imports preserved.",
+  "files": [
+    {
+      "source": "src/analysis.ts",
+      "sourceBytes": 47015,
+      "sourceSha256": "45d06ff67f5e7c8334fd3188bc6e3d13c582c36714cbf584aca5c4280587f571",
+      "output": "analysis.js",
+      "outputBytes": 44912,
+      "outputSha256": "68f7c705892b03c6b2e93b5f86ec4216231246607aac11c2dab98ed06f0f602b"
+    },
+    {
+      "source": "src/bidi.ts",
+      "sourceBytes": 6034,
+      "sourceSha256": "70f7f01dcd866076b68dbf2a3c398364aceaba2ccf98037e77e0b3b8bcfbeaa5",
+      "output": "bidi.js",
+      "outputBytes": 5176,
+      "outputSha256": "f69a132df81d5ad666bd35a295e10bf2549f8f0bc6470ab37fe361eafd0162b5"
+    },
+    {
+      "source": "src/generated/bidi-data.ts",
+      "sourceBytes": 21681,
+      "sourceSha256": "745211b804d907af78afb6c1ed87eff6d7454a5e85152a6129eb7b3bf0f6f262",
+      "output": "generated/bidi-data.js",
+      "outputBytes": 44541,
+      "outputSha256": "2f3fd15a0dbc1df87fefc53e23d261419b392feab32e1288a3d7d568cd368fea"
+    },
+    {
+      "source": "src/layout.ts",
+      "sourceBytes": 22096,
+      "sourceSha256": "2b44bcc39ecf287de621d40dbc443815cf2faa8c976a98de8a02f1639b782b9d",
+      "output": "layout.js",
+      "outputBytes": 13886,
+      "outputSha256": "ed52968b68a8d7fb3726333ff522f41f10a779d2c072ba05eb9aa841a6daf469"
+    },
+    {
+      "source": "src/line-break.ts",
+      "sourceBytes": 30545,
+      "sourceSha256": "f226213c179d65adea48b849040719349c8c3928519348d03d38b7b41f344796",
+      "output": "line-break.js",
+      "outputBytes": 29515,
+      "outputSha256": "30d83886d6e681fec3da72073749d14f7d01e5371cc907554596782df9c3de7c"
+    },
+    {
+      "source": "src/line-text.ts",
+      "sourceBytes": 2234,
+      "sourceSha256": "5e21684d995df8c30324c03a14b8a0bc3a579ce169a0e10b6d579b6aeee577dc",
+      "output": "line-text.js",
+      "outputBytes": 1994,
+      "outputSha256": "d7485c43086420e37418b68a49bf42acc45c13a6045d170eecbf37df4738a03c"
+    },
+    {
+      "source": "src/measurement.ts",
+      "sourceBytes": 8430,
+      "sourceSha256": "7768e0452c9dcc027182a3ed8131ed4a26d1d6099c9642ed93389a1c52342b01",
+      "output": "measurement.js",
+      "outputBytes": 7468,
+      "outputSha256": "58d8827d10367319d667c54056ef1200b0850a4ef6d298eaad486217cc84277e"
+    },
+    {
+      "source": "src/rich-inline.ts",
+      "sourceBytes": 15398,
+      "sourceSha256": "5a7e5d339e1f703d52928913e3b7d6a5f5df04bdfdd365f47c1890dde3b61964",
+      "output": "rich-inline.js",
+      "outputBytes": 11352,
+      "outputSha256": "60b7d96428236a8f12f7d6fdbd7d402c8c3b39e4da9cd4bf83b1d3dee27a7418"
+    }
+  ]
+}