rapier-markdown-kit 1.1.0

package/dist/kit/conformance/12-heading-barrier.expected.json

@@ -0,0 +1,164 @@
+{
+  "document": "12-heading-barrier.md",
+  "measurer": {
+    "font": "normal 400 17.6px/30.8px Geist, system-ui, sans-serif",
+    "letterSpacing": 0,
+    "lineHeight": 30.8,
+    "direction": "ltr",
+    "columnWidth": 354
+  },
+  "anchorText": "This paragraph comes before the picture and stays the anchor whenever the block right after the picture cannot be one -- another image paragraph, or a heading -- so the words below keep their own separate life.",
+  "anchorFlowed": true,
+  "picture": {
+    "natural": {
+      "width": 60,
+      "height": 40
+    },
+    "occupancy": null,
+    "layout": "<!--md-layout:v1 width=35% wrap=around x=75%-->",
+    "rect": {
+      "left": 203.546875,
+      "top": 0.015625,
+      "right": 327.4375,
+      "bottom": 82.609375
+    }
+  },
+  "profileHint": null,
+  "lines": [
+    {
+      "left": 0,
+      "top": 0,
+      "right": 193.55,
+      "bottom": 30.8
+    },
+    {
+      "left": 0,
+      "top": 30.8,
+      "right": 193.55,
+      "bottom": 61.59
+    },
+    {
+      "left": 0,
+      "top": 61.59,
+      "right": 193.55,
+      "bottom": 92.39
+    },
+    {
+      "left": 0,
+      "top": 92.39,
+      "right": 193.55,
+      "bottom": 123.19
+    },
+    {
+      "left": 0,
+      "top": 123.19,
+      "right": 354,
+      "bottom": 153.98
+    },
+    {
+      "left": 0,
+      "top": 154,
+      "right": 354,
+      "bottom": 184.8
+    },
+    {
+      "left": 0,
+      "top": 184.8,
+      "right": 354,
+      "bottom": 215.59
+    },
+    {
+      "left": 0,
+      "top": 215.59,
+      "right": 354,
+      "bottom": 246.39
+    }
+  ],
+  "glyphWidths": {
+    "T": 10.747,
+    "h": 11.151,
+    "i": 4.888,
+    "s": 9.166,
+    " ": 5.593,
+    "p": 11.168,
+    "a": 10.781,
+    "r": 7.233,
+    "g": 11.168,
+    "c": 9.673,
+    "o": 10.764,
+    "m": 17.138,
+    "e": 10.824,
+    "b": 11.168,
+    "f": 6.194,
+    "t": 6.898,
+    "u": 11.151,
+    "n": 11.151,
+    "d": 11.168,
+    "y": 10.412,
+    "w": 14.389,
+    "v": 10.412,
+    "l": 4.888,
+    "k": 10.189,
+    "-": 6.349,
+    ",": 5.593,
+    ".": 5.593
+  },
+  "measurements": {
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000-": 6.349,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000 ": 5.593,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000This": 35.952,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000T": 10.747,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000h": 11.151,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000i": 4.888,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000s": 9.166,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000paragraph": 91.465,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000p": 11.168,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000a": 10.781,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000r": 7.233,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000g": 11.168,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000comes": 57.566,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000c": 9.673,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000o": 10.764,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000m": 17.138,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000e": 10.824,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000before": 56.621,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000b": 11.168,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000f": 6.194,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000the": 28.873,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000t": 6.898,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000picture": 61.449,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000u": 11.151,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000and": 33.1,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000n": 11.151,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000d": 11.168,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000stays": 46.424,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000y": 10.412,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000anchor": 60.753,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000whenever": 86.809,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000w": 14.389,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000v": 10.412,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000block": 46.682,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000l": 4.888,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000k": 10.189,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000right": 41.338,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000after": 41.622,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000cannot": 60.418,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000be": 21.992,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000one": 32.739,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000another": 68.803,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000image": 54.8,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000paragraph,": 97.058,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000,": 5.593,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000or": 17.998,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000heading": 71.131,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000so": 19.93,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000words": 52.412,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000below": 52.034,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000keep": 42.378,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000their": 40.995,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000own": 36.304,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000separate": 77.677,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000life.": 32.387,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000.": 5.593
+  }
+}

package/dist/kit/conformance/12-heading-barrier.md

@@ -0,0 +1,12 @@
+
+# The neighbour search stops at a heading
+
+This paragraph comes before the picture and stays the anchor whenever the block right after the picture cannot be one -- another image paragraph, or a heading -- so the words below keep their own separate life.
+
+![The picture under test][opaque] <!--md-layout:v1 width=35% wrap=around x=75%-->
+
+## A heading right after the picture
+
+This paragraph comes after the picture and is its ordinary anchor whenever nothing else stands in the way, wrapping beside it line by line the way the fixture is built to show plainly.
+
+[opaque]: data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAADwAAAAoCAYAAACiu5n/AAAAQ0lEQVR42u3PMQEAAAQAMHl0095PC48dC7DI6vkkhIWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFby0f7s8anCQmZQAAAABJRU5ErkJggg==

package/dist/kit/conformance/13-rtl-text.expected.json

@@ -0,0 +1,179 @@
+{
+  "document": "13-rtl-text.md",
+  "measurer": {
+    "font": "normal 400 17.6px/30.8px Geist, system-ui, sans-serif",
+    "letterSpacing": 0,
+    "lineHeight": 30.8,
+    "direction": "rtl",
+    "columnWidth": 354
+  },
+  "anchorText": "هذه فقرة قصيرة باللغة العربية تلتف حول الصورة المجاورة لها في هذا المستند، وتُستخدم للتحقق من أن اتجاه الكتابة من اليمين إلى اليسار يُحترم عند التفاف النص حول صورة موضوعة بعرض جزئي من العمود.",
+  "anchorFlowed": true,
+  "picture": {
+    "natural": {
+      "width": 64,
+      "height": 64
+    },
+    "occupancy": null,
+    "layout": "<!--md-layout:v1 width=35% wrap=around x=20%-->",
+    "rect": {
+      "left": 8.84375,
+      "top": 0,
+      "right": 132.734375,
+      "bottom": 123.890625
+    }
+  },
+  "profileHint": {
+    "kind": "bands",
+    "descriptor": "||0.4792-0.5208|0.4583-0.5417|0.4375-0.5625|0.4167-0.5833|0.3958-0.6042|0.375-0.625|0.3542-0.6458|0.3333-0.6667|0.3125-0.6875|0.2917-0.7083|0.2708-0.7292|0.25-0.75|0.2292-0.7708|0.2083-0.7917|0.1875-0.8125|0.1667-0.8333|0.1458-0.8542|0.125-0.875|0.1042-0.8958|0.0833-0.9167|0.0625-0.9375|0.0417-0.9583|0.0417-0.9583|0.0625-0.9375|0.0833-0.9167|0.1042-0.8958|0.125-0.875|0.1458-0.8542|0.1667-0.8333|0.1875-0.8125|0.2083-0.7917|0.2292-0.7708|0.25-0.75|0.2708-0.7292|0.2917-0.7083|0.3125-0.6875|0.3333-0.6667|0.3542-0.6458|0.375-0.625|0.3958-0.6042|0.4167-0.5833|0.4375-0.5625|0.4583-0.5417|0.4792-0.5208||",
+    "note": "the same diamond.png as fixture 03"
+  },
+  "lines": [
+    {
+      "left": 122.09,
+      "top": 0,
+      "right": 353.98,
+      "bottom": 30.8
+    },
+    {
+      "left": 142.75,
+      "top": 30.8,
+      "right": 354,
+      "bottom": 61.59
+    },
+    {
+      "left": 142.75,
+      "top": 61.59,
+      "right": 354,
+      "bottom": 92.39
+    },
+    {
+      "left": 124.67,
+      "top": 92.39,
+      "right": 353.98,
+      "bottom": 123.19
+    },
+    {
+      "left": 93.7,
+      "top": 123.19,
+      "right": 353.98,
+      "bottom": 153.98
+    },
+    {
+      "left": 0,
+      "top": 154,
+      "right": 354,
+      "bottom": 184.8
+    },
+    {
+      "left": 0,
+      "top": 184.8,
+      "right": 354,
+      "bottom": 215.59
+    }
+  ],
+  "glyphWidths": {
+    "ه": 9.218,
+    "ذ": 7.835,
+    " ": 5.593,
+    "ف": 18.238,
+    "ق": 13.651,
+    "ر": 8.496,
+    "ة": 9.218,
+    "ص": 21.271,
+    "ي": 13.771,
+    "ب": 16.563,
+    "ا": 4.888,
+    "ل": 12.783,
+    "غ": 10.498,
+    "ع": 10.498,
+    "ت": 16.563,
+    "ح": 11.357,
+    "و": 8.496,
+    "م": 10.893,
+    "ج": 11.357,
+    "س": 21.477,
+    "ن": 12.92,
+    "د": 7.835,
+    "،": 5.678,
+    "ُ": 0,
+    "خ": 11.357,
+    "أ": 4.888,
+    "ك": 14.501,
+    "إ": 4.888,
+    "ى": 13.771,
+    "ض": 21.271,
+    "ز": 8.496,
+    "ئ": 13.771,
+    ".": 5.593
+  },
+  "measurements": {
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000-": 6.349,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000 ": 5.593,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000هذه": 27.731,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000ه": 9.218,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000ذ": 7.835,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000فقرة": 36.236,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000ف": 18.238,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000ق": 13.651,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000ر": 8.496,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000ة": 9.218,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000قصيرة": 47.902,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000ص": 21.271,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000ي": 13.771,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000باللغة": 39.363,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000ب": 16.563,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000ا": 4.888,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000ل": 12.783,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000غ": 10.498,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000العربية": 48.082,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000ع": 10.498,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000تلتف": 34.243,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000ت": 16.563,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000حول": 32.748,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000ح": 11.357,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000و": 8.496,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000الصورة": 52.309,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000المجاورة": 63.348,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000م": 10.893,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000ج": 11.357,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000لها": 18.831,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000في": 23.075,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000هذا": 23.401,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000المستند،": 61.647,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000س": 21.477,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000ن": 12.92,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000د": 7.835,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000،": 5.678,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000وتُستخدم": 65.882,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000تُ": 16.563,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000خ": 11.357,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000للتحقق": 51.424,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000من": 22.817,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000أن": 17.809,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000أ": 4.888,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000اتجاه": 35.72,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000الكتابة": 44.964,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000ك": 14.501,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000اليمين": 44.431,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000إلى": 24.913,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000إ": 4.888,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000ى": 13.771,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000اليسار": 45.11,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000يُحترم": 42.163,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000يُ": 13.771,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000عند": 25.042,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000التفاف": 48.056,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000النص": 37.112,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000صورة": 41.742,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000موضوعة": 62.472,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000ض": 21.271,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000بعرض": 44.362,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000جزئي": 40.144,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000ز": 8.496,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000ئ": 13.771,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000العمود.": 51.424,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000.": 5.593,
+    "normal 400 17.6px Geist, system-ui, sans-serif\u0000ُ": 0
+  }
+}

package/dist/kit/conformance/13-rtl-text.md

@@ -0,0 +1,8 @@
+
+# RTL text wrapping around a picture
+
+![صورة][diamond] <!--md-layout:v1 width=35% wrap=around x=20%-->
+
+هذه فقرة قصيرة باللغة العربية تلتف حول الصورة المجاورة لها في هذا المستند، وتُستخدم للتحقق من أن اتجاه الكتابة من اليمين إلى اليسار يُحترم عند التفاف النص حول صورة موضوعة بعرض جزئي من العمود.
+
+[diamond]: data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAEAAAABACAYAAACqaXHeAAAA40lEQVR42u3bSQ6DMBAAQZ7N7zvXSNmAYHuWPtQ9akUJ2DPbvu9bZ5sB1n8IOgfgSbsAvNEmAF+UD8ABZQNwQrkAXFAmAH9IH4AbpA3AjdIFYIA0ARgofAAmCBuAicIFYIEwAVhoeQACWBaAQKYHIKBpAQhseAASGBaARG4PQEK3BSCxvwNQwOUAFHI6AAUdDkBhPwPQwMcANPISgIb8Bvgb4L+AzwE+Cfou4Nug5wGeCHkm6Kmw9wLeDHk36O2w8wFOiDgj5JSYc4JOijor7LS4+wJujLgz5NaYe4Nujro73MEDip6/b+F9FD0AAAAASUVORK5CYII=

package/dist/kit/conformance/README.md

@@ -0,0 +1,99 @@
+# The conformance kit
+
+Thirteen small documents, each covering one placement fact from [the Markdown
+standard](../../docs/markdown-standard.md): inline (no layout comment), width/x/align, `wrap=around`
+with a real alpha silhouette, `wrap=box`, `behind`, `front`, `rotate=` on a plain raster, a foreign
+SVG "drawing" already turned in its own bytes, a ring drawing whose unfilled interior takes a line of
+text, both-sides wrapping around a centred picture, the neighbour search skipping a second, unrelated
+picture, the neighbour search stopping at a heading, and RTL (Arabic) text.
+
+## What each document's JSON carries
+
+`<NN>-<name>.expected.json`, committed beside `<NN>-<name>.md`:
+
+- `measurer` — the anchor paragraph's own resolved `font` (canvas-shaped: style/weight/size/family),
+  `letterSpacing`, `lineHeight`, `direction` and `columnWidth` — the facts an implementer needs to
+  reproduce the same lines with the same measurer.
+- `anchorText` / `anchorFlowed` — which paragraph is the anchor, and whether a picture obstacle
+  reached it at all (a plain, `behind`, or `front` document has none).
+- `picture` — the picture's own natural size, its layout comment, and (when `anchorFlowed`) its
+  reserved rectangle *relative to the anchor paragraph's own content box* — the same coordinate frame
+  `pictureSlices`/`flowLines` expect.
+- `profileHint` — which of the kit's calls reconstructs the obstacle's shape: `{kind: "bands",
+  descriptor}` for `parseProfile`, `{kind: "polygon", corners}` for `polygonProfile`, `{kind:
+  "rasterTilt", width, height, radiusDeg}` for `rasterTiltProfile`, or `null` for the plain
+  conservative-rectangle fallback (`pictureSlices(null, …)`) — an opaque raster's own alpha profile
+  is `null` too (`alphaProfile` refuses a fully opaque image on purpose; `wrap=box` with no drawing
+  recipe and no rotation is the same fallback). The `bands`/`polygon` fixtures' hints are the exact
+  alpha shape of the fixture's own picture, computed independently in Node from how the picture was
+  built (see the generation notes at the foot of this file) — not read back from Rapier — since these
+  are plain rasters/foreign SVGs and Rapier's export only serializes `data-rapier-occupancy` for its
+  own drawing recipes (`docs/architecture.md`, "Layout and images").
+- `lines` — the anchor's own line boxes (`left`/`top`/`right`/`bottom`), relative to its own content
+  box, read from Rapier's styled export: from the reflow script's own `<span>` boxes when the
+  paragraph is flowed (their `right` is the reserved *slot*'s edge, `x + width` — the script sizes
+  each span to its slot and left-aligns ragged text inside it, so that is the honest thing to compare,
+  not a text-measurement guess), or from `Range.getClientRects()` on the plain text otherwise (which
+  *is* the glyphs' own tight extent).
+- `glyphWidths` — every character the anchor's text uses, with its own measured width in that exact
+  font, from this browser's `measureText`, called in isolation on one character at a time. Always
+  present; the fallback `measurer.mjs` (R77) reaches for when a query is not in `measurements` below.
+- `measurements` (R77) — every `(font, text)` pair Pretext's own `getMeasureContext()` was actually
+  asked to measure while *this fixture's own export* ran its real reflow script, each with the exact
+  width the browser gave it — captured from the exported page's own reflow as it ran.
+  This is Rapier's own measurement, not a stand-in: a caller replaying the same font and text later
+  gets back the *same* number, kerning and shaping included, because it is looked up, not re-derived.
+  **Which fixtures carry a real trace:** only one whose picture actually pushes a flow obstacle into
+  the anchor paragraph — `layout/interchange.js`'s own `prepare()` calls Pretext exclusively for a
+  paragraph an obstacle reaches, so `01-inline` and `02-width-x-align` (no `wrap`, no obstacle at
+  all) and `05-behind`/`06-front` (`behind`/`front` are out-of-flow by design and never push one
+  either) never run Pretext during export and so have an empty `measurements` — every other fixture
+  (`wrap=around`/`box`) does. `measurer.mjs`'s own `createMeasurer` merges every document's
+  `measurements` and `glyphWidths` into one process-wide lookup, matching `run.mjs`'s pre-existing
+  merge-once-upfront discipline (Pretext's `getMeasureContext()` memoizes its context once per
+  process, so installing a fresh measurer per document would silently keep serving the first
+  document's data to every later one).
+
+## The expectations
+
+`<name>.expected.json` is compared against the exported page's own reflow within 1.5 px; a missing one is a failure. `profileHint` is hand-computed from how each fixture's picture bytes were built ("Generation notes" below) and is restored by hand if a file is regenerated.
+
+## Running the comparison
+
+```sh
+node run.mjs                                   # the kit itself, driven by measurer.mjs (R77)
+node run.mjs --impl path/to/other-kit/index.mjs --tolerance 4
+```
+
+Prints two separate tables (preservation and presentation are different claims):
+
+- **Preservation** — does each fixture's own layout comment round-trip exactly through
+  `parseLayout`/`formatLayout`. No measurer, no font: either exactly right, or a real bug. 12/12.
+- **Presentation** — does the planned line count and each line's left/right agree with the recorded
+  fact, within `--tolerance` pixels (default 2). This depends entirely on the measurer supplied;
+  `run.mjs`'s own default (`measurer.mjs`, R77) replays Rapier's real Pretext trace wherever one was
+  captured, falling back to the character-glyph sum only where none exists. Current result: **4/13
+  AGREE outright** (`04-wrap-box`, `07-rotate-raster`, `10-both-sides`, `12-heading-barrier` — every
+  one a case where the compared edge is pure obstacle-slot geometry, unaffected by text fidelity
+  either way), **9 CLOSE, 0 DIFFERS**, each CLOSE row's cause named rather than left as "close
+  enough": `01-inline`/`02-width-x-align`/`05-behind`/`06-front` have no real trace at all (see
+  `measurements` above) so still rest on the character-sum fallback; `03-wrap-around-silhouette`,
+  `09-drawing-ring-interior`, `11-neighbour-skips-image` and `13-rtl-text` run Pretext for real during
+  export (`13-rtl-text` at 100% — every query of its own answered from the real trace) yet still
+  carry a small, constant left-edge delta (5.18px for 03/11/13, 6.63px for 09) that is a
+  picture-obstacle *geometry* fact, not a text one: their `profileHint` is a hand-computed, quantized
+  alpha-band descriptor for a picture Rapier's own export never serializes an occupancy descriptor
+  for, and that descriptor's own precision — not the measurer — is the residual gap. Before this
+  measurer existed (a per-character glyph-sum with no real trace at all), the same run reported 4
+  AGREE / 8 CLOSE / 1 DIFFERS — `13-rtl-text` disagreed by a whole line (7 expected, 8 planned): real
+  Arabic shaping (ligatures, diacritic combination) changes a run's total measured width in a way an
+  isolated-character sum cannot reproduce, and that was enough to move one word to the next line. The
+  real trace above fixes exactly that: `13-rtl-text` now plans the correct 7 lines.
+
+## Generation notes (how the pictures were built)
+
+`opaque.png` (60×40, fully opaque blue) and `diamond.png` (64×64, a Manhattan-diamond alpha mask) are
+hand-built PNGs (no canvas library — a raw RGBA buffer through `zlib.deflateSync`, wrapped in
+IHDR/IDAT/IEND chunks). `ring.svg` (a 200×200 stroked circle, `fill="none"`, leaving a real transparent
+hole) and `rotated.svg` (a 140×100 rectangle already rotated 20° in its own `transform`) are hand-written
+SVG. None of this is shipped; it only explains where each fixture's bytes and `profileHint` came from.

package/dist/kit/conformance/run.mjs

@@ -0,0 +1,123 @@
+#!/usr/bin/env node
+// SPDX-License-Identifier: MIT
+// Usage: node run.mjs [--impl path/to/module.mjs] [--tolerance 2]
+import {resolve} from 'node:path';
+import {dirname} from 'node:path';
+import {fileURLToPath} from 'node:url';
+import {loadDocuments, installMeasurer} from './measurer.mjs';
+
+const here = dirname(fileURLToPath(import.meta.url));
+
+function parseArgs(argv) {
+	const out = {impl: resolve(here, '../index.mjs'), tolerance: 2};
+	for (let i = 0; i < argv.length; i++) {
+		if (argv[i] === '--impl') out.impl = resolve(process.cwd(), argv[++i]);
+		else if (argv[i] === '--tolerance') out.tolerance = Number(argv[++i]);
+	}
+	return out;
+}
+const args = parseArgs(process.argv.slice(2));
+const impl = await import(args.impl.startsWith('file://') ? args.impl : 'file://' + args.impl);
+
+const need = ['parseLayout', 'formatLayout', 'prepareRun', 'prepareRichInline', 'flowLines', 'pictureSlices', 'bandsProfile', 'polygonProfile', 'rasterTiltProfile', 'parseProfile', 'wrapColumnFloor'];
+const missing = need.filter(name => typeof impl[name] !== 'function');
+if (missing.length) { console.error('run.mjs: implementation at ' + args.impl + ' is missing: ' + missing.join(', ')); process.exit(2); }
+
+function buildProfile(hint) {
+	if (!hint) return null;
+	if (hint.kind === 'bands') return impl.parseProfile(hint.descriptor);
+	if (hint.kind === 'polygon') return impl.polygonProfile(hint.corners);
+	if (hint.kind === 'rasterTilt') return impl.rasterTiltProfile(hint.width, hint.height, hint.radiusDeg * Math.PI / 180);
+	throw new Error('unknown profileHint.kind: ' + hint.kind);
+}
+
+const documents = loadDocuments(here);
+// Install once over merged data: Pretext memoizes its context (measurer.mjs).
+const measurer = installMeasurer(documents);
+
+// Preservation and presentation are separate claims; preservation is exact or a bug.
+const preservationRows = documents.map(expected => {
+	const comment = expected.picture?.layout;
+	if (!comment) return {document: expected.document, verdict: 'n/a', detail: "this fixture's picture carries no md-layout comment"};
+	try {
+		const value = impl.parseLayout(comment);
+		if (!value) return {document: expected.document, verdict: 'FAIL', detail: 'parseLayout refused a comment the fixture actually carries: ' + comment};
+		const back = impl.formatLayout(value);
+		return back === comment
+			? {document: expected.document, verdict: 'EXACT', detail: comment}
+			: {document: expected.document, verdict: 'FAIL', detail: `parsed ${JSON.stringify(value)} then reformatted to ${JSON.stringify(back)}, source was ${JSON.stringify(comment)}`};
+	} catch (error) { return {document: expected.document, verdict: 'FAIL', detail: error.message}; }
+});
+{
+	const width = Math.max(...preservationRows.map(r => r.document.length));
+	console.log('Preservation (source facts: exact, no measurer involved)\n');
+	console.log('document'.padEnd(width) + '  verdict  detail');
+	for (const row of preservationRows) console.log(row.document.padEnd(width) + '  ' + row.verdict.padEnd(7) + '  ' + row.detail);
+	const exact = preservationRows.filter(r => r.verdict === 'EXACT').length, applicable = preservationRows.filter(r => r.verdict !== 'n/a').length;
+	console.log(`\n${exact}/${applicable} documents with a layout comment round-trip it exactly through parseLayout/formatLayout.\n`);
+}
+
+console.log('Presentation (line boxes; hits/misses show how much of each row rests on the real trace vs. the character-sum fallback)\n');
+const rows = [];
+for (const expected of documents) {
+	const font = expected.measurer.font.replace(/\/[^ ]+ /, ' '); // canvas fonts take no line-height
+	const before = {hits: measurer.stats.hits, misses: measurer.stats.misses};
+	const run = impl.prepareRun(expected.anchorText, font, expected.measurer.letterSpacing || 0);
+	if (!run) { rows.push({document: expected.document, verdict: 'ERROR', detail: 'prepareRun refused this font/text/letterSpacing'}); continue; }
+	const flow = impl.prepareRichInline([{text: run.raw, font, letterSpacing: expected.measurer.letterSpacing || 0}]);
+	let obstacles = [];
+	if (expected.picture?.rect) {
+		const profile = buildProfile(expected.profileHint);
+		const {left, top, right, bottom} = expected.picture.rect;
+		obstacles = impl.pictureSlices(profile, left, top, right - left, bottom - top);
+	}
+	const fontSize = parseFloat(/(\d+(?:\.\d+)?)px/.exec(expected.measurer.font)?.[1]) || 16;
+	const minWidth = impl.wrapColumnFloor(fontSize);
+	const plan = impl.flowLines(flow, expected.measurer.columnWidth, 0, obstacles, expected.measurer.lineHeight, minWidth, expected.measurer.direction);
+	if (!plan) { rows.push({document: expected.document, verdict: 'ERROR', detail: 'flowLines returned null (no plan fits)'}); continue; }
+
+	const lineCountAgrees = plan.lines.length === expected.lines.length;
+	let maxLeftDelta = 0, maxRightDelta = 0;
+	for (let i = 0; i < Math.min(plan.lines.length, expected.lines.length); i++) {
+		const got = plan.lines[i], want = expected.lines[i];
+		// Flowed lines compare slot geometry (x+width); unflowed lines compare the measured tight extent.
+		const right = expected.anchorFlowed ? got.x + got.width : got.x + measurer.measure(font, got.fragments.map(f => f.text).join(''));
+		maxLeftDelta = Math.max(maxLeftDelta, Math.abs(got.x - want.left));
+		maxRightDelta = Math.max(maxRightDelta, Math.abs(right - want.right));
+	}
+	const withinTolerance = lineCountAgrees && maxLeftDelta <= args.tolerance && maxRightDelta <= args.tolerance;
+	rows.push({
+		document: expected.document,
+		verdict: withinTolerance ? 'AGREE' : lineCountAgrees ? 'CLOSE' : 'DIFFERS',
+		expectedLines: expected.lines.length, gotLines: plan.lines.length,
+		maxLeftDelta: Math.round(maxLeftDelta * 100) / 100, maxRightDelta: Math.round(maxRightDelta * 100) / 100,
+		hits: measurer.stats.hits - before.hits, misses: measurer.stats.misses - before.misses,
+	});
+}
+
+const width = Math.max(...rows.map(r => r.document.length));
+console.log('document'.padEnd(width) + '  verdict   lines(exp/got)  maxΔleft  maxΔright  measurer(hits/misses)');
+for (const row of rows) {
+	if (row.verdict === 'ERROR') { console.log(row.document.padEnd(width) + '  ERROR     ' + row.detail); continue; }
+	console.log(row.document.padEnd(width) + '  ' + row.verdict.padEnd(8) + '  ' + `${row.expectedLines}/${row.gotLines}`.padEnd(14) + '  ' +
+		`${row.maxLeftDelta}px`.padEnd(8) + '  ' + `${row.maxRightDelta}px`.padEnd(9) + '  ' + `${row.hits}/${row.misses}`);
+}
+const agree = rows.filter(r => r.verdict === 'AGREE').length;
+const close = rows.filter(r => r.verdict === 'CLOSE').length;
+const differs = rows.filter(r => r.verdict === 'DIFFERS').length;
+console.log(`\n${agree}/${rows.length} documents AGREE within ${args.tolerance}px, ${close} CLOSE, ${differs} DIFFERS.`);
+console.log(`Measurer: ${measurer.stats.hits} queries answered from Rapier's own real browser trace, ${measurer.stats.misses} fell back to a character-glyph sum (no kerning/shaping).`);
+console.log(`A row's own hits/misses can undercount its real coverage: several fixtures share one identical anchor sentence, and Pretext's own per-process`);
+console.log(`segment cache (agent/vendor/pretext/measurement.js) serves a repeated (font, segment) query straight from that cache without calling`);
+console.log(`measureText again at all -- real data, just not counted against the SECOND document to ask for it. Two named, separate reasons a row still`);
+console.log(`reads CLOSE rather than AGREE, neither of them "close enough": (a) no real trace exists at all for 01-inline/02-width-x-align/05-behind/06-front`);
+console.log(`-- their picture pushes no flow obstacle, so layout/interchange.js's own prepare() never calls Pretext for this paragraph during export (see`);
+console.log(`measurer.mjs) -- the from-scratch character-sum approximation disagrees with real shaping by a bounded, named amount; (b) 03/09/11/13 DO run`);
+console.log(`Pretext for real (hits > 0, 13-rtl-text at 100% -- every query answered from the real trace) yet still carry a small, constant left-edge delta`);
+console.log(`(5.18px for 03/11/13, 6.63px for 09, unchanged from before this measurer existed) -- a picture-obstacle geometry fact, not a text one: these`);
+console.log(`fixtures' profileHint is a hand-computed, quantized alpha band descriptor for a raster Rapier's own export never serialized an occupancy`);
+console.log(`descriptor for (conformance/README.md, "profileHint"), and that descriptor's own precision -- not this lane's measurer -- is the residual gap.`);
+if (measurer.stats.missedQueries.length) {
+	console.log(`\nFirst ${Math.min(10, measurer.stats.missedQueries.length)} of ${measurer.stats.misses} missed (font, text) queries (fell back to the character sum):`);
+	for (const {font, text} of measurer.stats.missedQueries.slice(0, 10)) console.log(`  ${JSON.stringify(text)}  (${font})`);
+}

package/dist/kit/index.mjs

@@ -0,0 +1,6 @@
+// SPDX-License-Identifier: MIT
+export * from './layout.mjs';
+export * from './marks.mjs';
+export * from './model.mjs';
+export * from './will.mjs';
+export * from './assets.mjs';

package/dist/kit/layout.mjs

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: MIT
+export * from '../spec/md-layout.mjs';

package/dist/kit/marks.mjs

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: MIT
+export * from '../spec/md-marks.mjs';

package/dist/kit/model.mjs

@@ -0,0 +1,3 @@
+// SPDX-License-Identifier: MIT
+export * from '../layout/model.mjs';
+export {prepareRichInline, materializeRichInlineLineRange} from '../agent/vendor/pretext/rich-inline.js';

package/dist/kit/will.mjs

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: MIT
+export * from '../agent/will.mjs';