@ascribed/astro 0.2.0 → 0.2.1-next.10

package/README.md

@@ -8,6 +8,8 @@ It runs `ascribe build --emit site` before Astro loads content, gives you a cont
 npm install @ascribed/astro
 ```
 
+`satteri` and `@types/hast` are optional peer dependencies: the declarations of `@ascribed/astro/satteri` and `@ascribed/astro/rehype` import types from them. Astro's default Sätteri processor brings the first, and a `unified()` processor the second, so a project that uses one of those plugins has what it needs.
+
 ```js
 // astro.config.mjs
 import { defineConfig } from "astro/config";

package/dist/attributes.js

@@ -11,8 +11,9 @@
 // processor's adapter applies the edits with its own means (`rehype.ts`
 // mutates the tree, `satteri.ts` queues commands).
 import { find, html } from "property-information";
-const OPEN = /^<ascribe-attributes((?: [a-z][a-z0-9-]*="[^"\r\n]*")*)>$/;
-const CLOSE = "</ascribe-attributes>";
+import { COMMENT_ANCHOR, DATA_SOURCE, DATA_VIA, ELEMENT_ATTRIBUTES } from "./names.js";
+const OPEN = new RegExp(`^<${ELEMENT_ATTRIBUTES}((?: [a-z][a-z0-9-]*="[^"\\r\\n]*")*)>$`);
+const CLOSE = `</${ELEMENT_ATTRIBUTES}>`;
 const ATTRIBUTE = / ([a-z][a-z0-9-]*)="([^"]*)"/g;
 const HEADING = /^h[1-6]$/;
 /** Finds every marker that applies to a heading, an image, or a link in `root`. */
@@ -115,7 +116,7 @@ export function toProperty([name, value]) {
         return [info.property, value.split(/\s*,\s*/)];
     return [info.property, value];
 }
-const ANCHOR = /^<!--ascribe-anchor((?: [a-z][a-z0-9-]*="[^"\r\n]*")+)-->\s*$/;
+const ANCHOR = new RegExp(`^<!--${COMMENT_ANCHOR}((?: [a-z][a-z0-9-]*="[^"\\r\\n]*")+)-->\\s*$`);
 /** Finds every source anchor comment in `root`, and what it applies to. */
 export function findAnchors(root) {
     const edits = [];
@@ -205,9 +206,9 @@ function parseAnchor(text) {
     };
 }
 function anchorAttributes(source, via) {
-    const attributes = [["data-ascribe-source", source]];
+    const attributes = [[DATA_SOURCE, source]];
     if (via !== undefined)
-        attributes.push(["data-ascribe-via", via]);
+        attributes.push([DATA_VIA, via]);
     return attributes;
 }
 /** Raw HTML with the anchor's attributes after the name of its first tag, when that tag opens the element the anchor names. */

package/dist/attributes.js.map

@@ -1 +1 @@
-{"version":3,"file":"attributes.js","sourceRoot":"","sources":["../src/attributes.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,yEAAyE;AACzE,EAAE;AACF,8EAA8E;AAC9E,8EAA8E;AAC9E,gFAAgF;AAChF,2EAA2E;AAC3E,aAAa;AACb,4EAA4E;AAC5E,6EAA6E;AAC7E,wEAAwE;AACxE,mDAAmD;AAEnD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AA8BlD,MAAM,IAAI,GAAG,2DAA2D,CAAC;AACzE,MAAM,KAAK,GAAG,uBAAuB,CAAC;AACtC,MAAM,SAAS,GAAG,+BAA+B,CAAC;AAClD,MAAM,OAAO,GAAG,UAAU,CAAC;AAE3B,mFAAmF;AACnF,MAAM,UAAU,SAAS,CAAC,IAAc;IACtC,MAAM,KAAK,GAAW,EAAE,CAAC;IACzB,YAAY,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE;QAC5B,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC;QACvC,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;QAClF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACzC,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;YACpC,IAAI,KAAK,KAAK,SAAS;gBAAE,SAAS;YAClC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;YACrC,MAAM,IAAI,GAAG,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC;YAC5B,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC;YAC3C,MAAM,MAAM,GAAG,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC/B,IACE,MAAM,KAAK,SAAS;gBACpB,MAAM,CAAC,IAAI,KAAK,SAAS;gBACzB,CAAC,MAAM,CAAC,OAAO,KAAK,KAAK,IAAI,MAAM,CAAC,OAAO,KAAK,GAAG,CAAC,EACpD,CAAC;gBACD,oEAAoE;gBACpE,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;YACvE,CAAC;iBAAM,IAAI,SAAS,IAAI,IAAI,KAAK,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACrD,KAAK,CAAC,IAAI,CAAC;oBACT,MAAM,EAAE,MAAM;oBACd,UAAU;oBACV,MAAM,EAAE,MAAM;oBACd,IAAI,EAAE,kBAAkB,CAAC,QAAQ,EAAE,CAAC,CAAC;iBACtC,CAAC,CAAC;YACL,CAAC;YACD,CAAC,GAAG,IAAI,CAAC;QACX,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,KAAK,CAAC;AACf,CAAC;AAED,wFAAwF;AACxF,SAAS,QAAQ,CACf,QAAoB,EACpB,CAAS;IAET,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC1B,IAAI,KAAK,EAAE,IAAI,KAAK,KAAK,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACzE,IAAI,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAChC,8BAA8B;QAC9B,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACjD,MAAM,UAAU,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QACnC,OAAO,UAAU,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IACjD,CAAC;IACD,MAAM,MAAM,GAAG,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/B,IAAI,MAAM,EAAE,IAAI,KAAK,KAAK,IAAI,MAAM,CAAC,KAAK,KAAK,KAAK;QAAE,OAAO,SAAS,CAAC;IACvE,MAAM,UAAU,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC1C,OAAO,UAAU,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;AACjD,CAAC;AAED,SAAS,SAAS,CAAC,GAAW;IAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACrC,MAAM,UAAU,GAAgB,EAAE,CAAC;IACnC,KAAK,MAAM,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACnE,IAAI,IAAI,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS;YAAE,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACxF,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,2DAA2D;AAC3D,SAAS,MAAM,CAAC,KAAa;IAC3B,OAAO,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAAC,EAAE,IAAY,EAAE,EAAE,CAC9D,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CACzE,CAAC;AACJ,CAAC;AAED,yGAAyG;AACzG,SAAS,kBAAkB,CAAC,QAAoB,EAAE,CAAS;IACzD,MAAM,IAAI,GAAiB,EAAE,CAAC;IAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QACzB,IAAI,IAAI,EAAE,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;YAAE,MAAM;QAC7D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;QACpD,IAAI,KAAK,KAAK,IAAI,CAAC,KAAK;YAAE,MAAM;QAChC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAC3B,IAAI,KAAK,KAAK,EAAE;YAAE,MAAM;IAC1B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,YAAY,CAAC,IAAc,EAAE,KAAiC;IACrE,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS;QAAE,OAAO;IACxC,KAAK,CAAC,IAAI,CAAC,CAAC;IACZ,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ;QAAE,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAChE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,CAAC,IAAI,EAAE,KAAK,CAAY;IACjD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC9B,IAAI,IAAI,CAAC,cAAc;QAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAC5F,IAAI,IAAI,CAAC,cAAc;QAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;IACxE,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;AAChC,CAAC;AAYD,MAAM,MAAM,GAAG,+DAA+D,CAAC;AAE/E,2EAA2E;AAC3E,MAAM,UAAU,WAAW,CAAC,IAAc;IACxC,MAAM,KAAK,GAAiB,EAAE,CAAC;IAC/B,YAAY,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE;QAC5B,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC;QACvC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACzC,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YACzB,IAAI,IAAI,EAAE,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;gBAAE,SAAS;YAC/D,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACvC,IAAI,MAAM,KAAK,SAAS;gBAAE,SAAS;YACnC,MAAM,IAAI,GAAe,EAAE,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;YACzD,IAAI,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;YACjB,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC7B,IAAI,KAAK,EAAE,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;gBACzD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACxB,IAAI,EAAE,CAAC;YACT,CAAC;YACD,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC9B,IAAI,MAAM,CAAC,GAAG,KAAK,KAAK,IAAI,MAAM,KAAK,SAAS,IAAI,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;gBACxE,kEAAkE;gBAClE,sEAAsE;gBACtE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;oBAChB,IAAI,EAAE,MAAM;oBACZ,UAAU,EAAE,gBAAgB,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC;iBACxD,CAAC,CAAC;YACL,CAAC;iBAAM,IAAI,MAAM,EAAE,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,MAAM,CAAC,GAAG,EAAE,CAAC;gBACtF,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;oBAChB,IAAI,EAAE,MAAM;oBACZ,UAAU,EAAE,gBAAgB,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC;iBACxD,CAAC,CAAC;gBACH,IAAI,CAAC,MAAM,CAAC,GAAG,KAAK,IAAI,IAAI,MAAM,CAAC,GAAG,KAAK,IAAI,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC5E,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,MAAM,CAC1C,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI,CAC9D,CAAC;oBACF,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;oBACpE,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;wBACzC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CACxB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;4BAChB,IAAI,EAAE,IAAI;4BACV,UAAU,EAAE,gBAAgB,CAAC,GAAG,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;yBACvE,CAAC,CACH,CAAC;oBACJ,CAAC;gBACH,CAAC;YACH,CAAC;iBAAM,IAAI,MAAM,EAAE,IAAI,KAAK,KAAK,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBAChE,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;gBACjD,IAAI,KAAK,KAAK,SAAS;oBAAE,IAAI,CAAC,OAAO,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;YAClE,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,KAAK,CAAC;AACf,CAAC;AAED,8FAA8F;AAC9F,SAAS,WAAW,CAAC,IAAc;IACjC,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtF,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC,OAAO,CAAC,CAAC;IAC/E,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;QACtC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC;QACvB,CAAC,CAAC,OAAO,SAAS,KAAK,QAAQ;YAC7B,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC;YACxB,CAAC,CAAC,EAAE,CAAC;IACT,OAAO,CACL,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;QAC9B,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,IAAI,CACxB,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,KAAK,CAC9E,CACF,CAAC;AACJ,CAAC;AASD,SAAS,WAAW,CAAC,IAAY;IAC/B,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACrC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC7C,KAAK,MAAM,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACnE,IAAI,IAAI,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS;YAAE,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACrF,CAAC;IACD,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACxC,IAAI,GAAG,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAChE,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAClC,OAAO;QACL,GAAG,EAAE,GAAG,CAAC,WAAW,EAAE;QACtB,MAAM;QACN,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG;QACjC,KAAK,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;KAC5E,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,MAAc,EAAE,GAAuB;IAC/D,MAAM,UAAU,GAAgB,CAAC,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC,CAAC;IAClE,IAAI,GAAG,KAAK,SAAS;QAAE,UAAU,CAAC,IAAI,CAAC,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC,CAAC;IAClE,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,+HAA+H;AAC/H,SAAS,YAAY,CAAC,IAAY,EAAE,MAAc;IAChD,MAAM,IAAI,GAAG,qCAAqC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9D,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IACtF,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC;SACxD,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,IAAI,IAAI,KAAK,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC;SACrD,IAAI,CAAC,EAAE,CAAC,CAAC;IACZ,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,MAAM,CAAC,KAAa;IAC3B,OAAO,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,CACrC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAC5E,CAAC;AACJ,CAAC","sourcesContent":["// The site output's attribute marker (`<ascribe-attributes>`) and source\n// anchors (`<!--ascribe-anchor …-->`), found and applied on a hast tree.\n//\n// Both markdown processors Astro 7.3 can run hand a user plugin the same tree\n// at the same point: after markdown became hast, before Astro's own image and\n// heading-id passes. A marker is then two adjacent `raw` nodes (an open tag and\n// a close tag), and the elements it applies to are `<h1>`–`<h6>`, `<img>`,\n// and `<a>`.\n// An anchor comment is a `raw` node beside the block it names. So the rules\n// live here once, as pure functions from a tree to a list of edits, and each\n// processor's adapter applies the edits with its own means (`rehype.ts`\n// mutates the tree, `satteri.ts` queues commands).\n\nimport { find, html } from \"property-information\";\n\n/** The parts of a hast node the rules read. Both processors' trees fit it. */\nexport interface HastNode {\n  type: string;\n  tagName?: string;\n  value?: string;\n  properties?: Record<string, unknown> | undefined;\n  children?: HastNode[];\n}\n\n/** A marker's attribute: a name and its decoded value. */\nexport type Attribute = readonly [name: string, value: string];\n\n/** What applying one marker changes. */\nexport interface Edit {\n  /** The heading, image, or link that gets the attributes. */\n  target: HastNode;\n  /** The marker's attributes, in the order written. */\n  attributes: Attribute[];\n  /** The marker's nodes, which are removed. */\n  remove: HastNode[];\n  /**\n   * For a heading: the text nodes directly before the marker, whose trailing\n   * whitespace is removed. A node whose text becomes empty is removed\n   * (`value` is `\"\"`).\n   */\n  trim: { node: HastNode; value: string }[];\n}\n\nconst OPEN = /^<ascribe-attributes((?: [a-z][a-z0-9-]*=\"[^\"\\r\\n]*\")*)>$/;\nconst CLOSE = \"</ascribe-attributes>\";\nconst ATTRIBUTE = / ([a-z][a-z0-9-]*)=\"([^\"]*)\"/g;\nconst HEADING = /^h[1-6]$/;\n\n/** Finds every marker that applies to a heading, an image, or a link in `root`. */\nexport function findEdits(root: HastNode): Edit[] {\n  const edits: Edit[] = [];\n  visitParents(root, (parent) => {\n    const children = parent.children ?? [];\n    const isHeading = parent.type === \"element\" && HEADING.test(parent.tagName ?? \"\");\n    for (let i = 0; i < children.length; i++) {\n      const found = markerAt(children, i);\n      if (found === undefined) continue;\n      const { attributes, length } = found;\n      const last = i + length - 1;\n      const marker = children.slice(i, last + 1);\n      const before = children[i - 1];\n      if (\n        before !== undefined &&\n        before.type === \"element\" &&\n        (before.tagName === \"img\" || before.tagName === \"a\")\n      ) {\n        // Directly after an image or a link, whatever else the marker ends.\n        edits.push({ target: before, attributes, remove: marker, trim: [] });\n      } else if (isHeading && last === children.length - 1) {\n        edits.push({\n          target: parent,\n          attributes,\n          remove: marker,\n          trim: trailingWhitespace(children, i),\n        });\n      }\n      i = last;\n    }\n  });\n  return edits;\n}\n\n/** The marker starting at `children[i]`: its attributes and how many nodes it spans. */\nfunction markerAt(\n  children: HastNode[],\n  i: number,\n): { attributes: Attribute[]; length: number } | undefined {\n  const first = children[i];\n  if (first?.type !== \"raw\" || first.value === undefined) return undefined;\n  if (first.value.endsWith(CLOSE)) {\n    // One node holding both tags.\n    const open = first.value.slice(0, -CLOSE.length);\n    const attributes = parseOpen(open);\n    return attributes && { attributes, length: 1 };\n  }\n  const second = children[i + 1];\n  if (second?.type !== \"raw\" || second.value !== CLOSE) return undefined;\n  const attributes = parseOpen(first.value);\n  return attributes && { attributes, length: 2 };\n}\n\nfunction parseOpen(tag: string): Attribute[] | undefined {\n  const match = OPEN.exec(tag);\n  if (match === null) return undefined;\n  const attributes: Attribute[] = [];\n  for (const [, name, value] of (match[1] ?? \"\").matchAll(ATTRIBUTE)) {\n    if (name !== undefined && value !== undefined) attributes.push([name, decode(value)]);\n  }\n  return attributes;\n}\n\n/** The marker's four escapes; any other `&` is literal. */\nfunction decode(value: string): string {\n  return value.replace(/&(quot|amp|lt|gt);/g, (_, name: string) =>\n    name === \"quot\" ? '\"' : name === \"amp\" ? \"&\" : name === \"lt\" ? \"<\" : \">\",\n  );\n}\n\n/** The spaces, tabs, and line breaks directly before `children[i]`, which a heading's marker removes. */\nfunction trailingWhitespace(children: HastNode[], i: number): Edit[\"trim\"] {\n  const trim: Edit[\"trim\"] = [];\n  for (let j = i - 1; j >= 0; j--) {\n    const node = children[j];\n    if (node?.type !== \"text\" || node.value === undefined) break;\n    const value = node.value.replace(/[ \\t\\r\\n]+$/, \"\");\n    if (value === node.value) break;\n    trim.push({ node, value });\n    if (value !== \"\") break;\n  }\n  return trim;\n}\n\nfunction visitParents(node: HastNode, visit: (parent: HastNode) => void): void {\n  if (node.children === undefined) return;\n  visit(node);\n  for (const child of node.children) visitParents(child, visit);\n}\n\n/**\n * A marker attribute as a hast property: the property name hast and Astro use\n * (`class` is `className`) and a value of the shape that property has.\n */\nexport function toProperty([name, value]: Attribute): [string, string | string[]] {\n  const info = find(html, name);\n  if (info.spaceSeparated) return [info.property, value.split(/\\s+/).filter((s) => s !== \"\")];\n  if (info.commaSeparated) return [info.property, value.split(/\\s*,\\s*/)];\n  return [info.property, value];\n}\n\n/** What applying one source anchor (site-render contract §7) changes. */\nexport interface AnchorEdit {\n  /** The anchor comment, and the whitespace-only text directly after it, which are removed. */\n  remove: HastNode[];\n  /** Elements that get attributes: the block, and a list's items. Empty when the anchor applies to nothing. */\n  targets: { node: HastNode; attributes: Attribute[] }[];\n  /** Raw HTML whose first tag gets the anchor's attributes: the node and its new text. */\n  replace?: { node: HastNode; value: string };\n}\n\nconst ANCHOR = /^<!--ascribe-anchor((?: [a-z][a-z0-9-]*=\"[^\"\\r\\n]*\")+)-->\\s*$/;\n\n/** Finds every source anchor comment in `root`, and what it applies to. */\nexport function findAnchors(root: HastNode): AnchorEdit[] {\n  const edits: AnchorEdit[] = [];\n  visitParents(root, (parent) => {\n    const children = parent.children ?? [];\n    for (let i = 0; i < children.length; i++) {\n      const node = children[i];\n      if (node?.type !== \"raw\" || node.value === undefined) continue;\n      const anchor = parseAnchor(node.value);\n      if (anchor === undefined) continue;\n      const edit: AnchorEdit = { remove: [node], targets: [] };\n      let next = i + 1;\n      const after = children[next];\n      if (after?.type === \"text\" && after.value?.trim() === \"\") {\n        edit.remove.push(after);\n        next++;\n      }\n      const target = children[next];\n      if (anchor.tag === \"pre\" && target !== undefined && isCodeTitle(target)) {\n        // A titled code block, which the code-titles transformer put in a\n        // figure: the anchor marks the figure, so the mark holds the caption.\n        edit.targets.push({\n          node: target,\n          attributes: anchorAttributes(anchor.source, anchor.via),\n        });\n      } else if (target?.type === \"element\" && target.tagName?.toLowerCase() === anchor.tag) {\n        edit.targets.push({\n          node: target,\n          attributes: anchorAttributes(anchor.source, anchor.via),\n        });\n        if ((anchor.tag === \"ul\" || anchor.tag === \"ol\") && anchor.items.length > 0) {\n          const items = (target.children ?? []).filter(\n            (child) => child.type === \"element\" && child.tagName === \"li\",\n          );\n          const path = anchor.source.slice(0, anchor.source.lastIndexOf(\":\"));\n          if (items.length === anchor.items.length) {\n            items.forEach((item, n) =>\n              edit.targets.push({\n                node: item,\n                attributes: anchorAttributes(`${path}:${anchor.items[n]}`, anchor.via),\n              }),\n            );\n          }\n        }\n      } else if (target?.type === \"raw\" && target.value !== undefined) {\n        const value = intoFirstTag(target.value, anchor);\n        if (value !== undefined) edit.replace = { node: target, value };\n      }\n      edits.push(edit);\n    }\n  });\n  return edits;\n}\n\n/** Whether a node is a `<figure class=\"code-title\">` holding a `<pre>` (`code-titles.ts`). */\nfunction isCodeTitle(node: HastNode): boolean {\n  if (node.type !== \"element\" || node.tagName?.toLowerCase() !== \"figure\") return false;\n  const className = node.properties?.[\"className\"] ?? node.properties?.[\"class\"];\n  const classes = Array.isArray(className)\n    ? className.map(String)\n    : typeof className === \"string\"\n      ? className.split(/\\s+/)\n      : [];\n  return (\n    classes.includes(\"code-title\") &&\n    (node.children ?? []).some(\n      (child) => child.type === \"element\" && child.tagName?.toLowerCase() === \"pre\",\n    )\n  );\n}\n\ninterface Anchor {\n  tag: string;\n  source: string;\n  via: string | undefined;\n  items: string[];\n}\n\nfunction parseAnchor(text: string): Anchor | undefined {\n  const match = ANCHOR.exec(text);\n  if (match === null) return undefined;\n  const attributes = new Map<string, string>();\n  for (const [, name, value] of (match[1] ?? \"\").matchAll(ATTRIBUTE)) {\n    if (name !== undefined && value !== undefined) attributes.set(name, decode(value));\n  }\n  const tag = attributes.get(\"tag\");\n  const source = attributes.get(\"source\");\n  if (tag === undefined || source === undefined) return undefined;\n  const via = attributes.get(\"via\");\n  return {\n    tag: tag.toLowerCase(),\n    source,\n    via: via === \"\" ? undefined : via,\n    items: (attributes.get(\"items\") ?? \"\").split(/\\s+/).filter((s) => s !== \"\"),\n  };\n}\n\nfunction anchorAttributes(source: string, via: string | undefined): Attribute[] {\n  const attributes: Attribute[] = [[\"data-ascribe-source\", source]];\n  if (via !== undefined) attributes.push([\"data-ascribe-via\", via]);\n  return attributes;\n}\n\n/** Raw HTML with the anchor's attributes after the name of its first tag, when that tag opens the element the anchor names. */\nfunction intoFirstTag(html: string, anchor: Anchor): string | undefined {\n  const open = /^<([A-Za-z][A-Za-z0-9-]*)(?=[\\s>/])/.exec(html);\n  if (open?.[1] === undefined || open[1].toLowerCase() !== anchor.tag) return undefined;\n  const written = anchorAttributes(anchor.source, anchor.via)\n    .map(([name, value]) => ` ${name}=\"${encode(value)}\"`)\n    .join(\"\");\n  return html.slice(0, open[0].length) + written + html.slice(open[0].length);\n}\n\nfunction encode(value: string): string {\n  return value.replace(/[&<>\"]/g, (ch) =>\n    ch === \"&\" ? \"&amp;\" : ch === \"<\" ? \"&lt;\" : ch === \">\" ? \"&gt;\" : \"&quot;\",\n  );\n}\n"]}
+{"version":3,"file":"attributes.js","sourceRoot":"","sources":["../src/attributes.ts"],"names":[],"mappings":"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","sourcesContent":["// The site output's attribute marker (`<ascribe-attributes>`) and source\n// anchors (`<!--ascribe-anchor …-->`), found and applied on a hast tree.\n//\n// Both markdown processors Astro 7.3 can run hand a user plugin the same tree\n// at the same point: after markdown became hast, before Astro's own image and\n// heading-id passes. A marker is then two adjacent `raw` nodes (an open tag and\n// a close tag), and the elements it applies to are `<h1>`–`<h6>`, `<img>`,\n// and `<a>`.\n// An anchor comment is a `raw` node beside the block it names. So the rules\n// live here once, as pure functions from a tree to a list of edits, and each\n// processor's adapter applies the edits with its own means (`rehype.ts`\n// mutates the tree, `satteri.ts` queues commands).\n\nimport { find, html } from \"property-information\";\nimport { COMMENT_ANCHOR, DATA_SOURCE, DATA_VIA, ELEMENT_ATTRIBUTES } from \"./names.js\";\n\n/** The parts of a hast node the rules read. Both processors' trees fit it. */\nexport interface HastNode {\n  type: string;\n  tagName?: string;\n  value?: string;\n  properties?: Record<string, unknown> | undefined;\n  children?: HastNode[];\n}\n\n/** A marker's attribute: a name and its decoded value. */\nexport type Attribute = readonly [name: string, value: string];\n\n/** What applying one marker changes. */\nexport interface Edit {\n  /** The heading, image, or link that gets the attributes. */\n  target: HastNode;\n  /** The marker's attributes, in the order written. */\n  attributes: Attribute[];\n  /** The marker's nodes, which are removed. */\n  remove: HastNode[];\n  /**\n   * For a heading: the text nodes directly before the marker, whose trailing\n   * whitespace is removed. A node whose text becomes empty is removed\n   * (`value` is `\"\"`).\n   */\n  trim: { node: HastNode; value: string }[];\n}\n\nconst OPEN = new RegExp(`^<${ELEMENT_ATTRIBUTES}((?: [a-z][a-z0-9-]*=\"[^\"\\\\r\\\\n]*\")*)>$`);\nconst CLOSE = `</${ELEMENT_ATTRIBUTES}>`;\nconst ATTRIBUTE = / ([a-z][a-z0-9-]*)=\"([^\"]*)\"/g;\nconst HEADING = /^h[1-6]$/;\n\n/** Finds every marker that applies to a heading, an image, or a link in `root`. */\nexport function findEdits(root: HastNode): Edit[] {\n  const edits: Edit[] = [];\n  visitParents(root, (parent) => {\n    const children = parent.children ?? [];\n    const isHeading = parent.type === \"element\" && HEADING.test(parent.tagName ?? \"\");\n    for (let i = 0; i < children.length; i++) {\n      const found = markerAt(children, i);\n      if (found === undefined) continue;\n      const { attributes, length } = found;\n      const last = i + length - 1;\n      const marker = children.slice(i, last + 1);\n      const before = children[i - 1];\n      if (\n        before !== undefined &&\n        before.type === \"element\" &&\n        (before.tagName === \"img\" || before.tagName === \"a\")\n      ) {\n        // Directly after an image or a link, whatever else the marker ends.\n        edits.push({ target: before, attributes, remove: marker, trim: [] });\n      } else if (isHeading && last === children.length - 1) {\n        edits.push({\n          target: parent,\n          attributes,\n          remove: marker,\n          trim: trailingWhitespace(children, i),\n        });\n      }\n      i = last;\n    }\n  });\n  return edits;\n}\n\n/** The marker starting at `children[i]`: its attributes and how many nodes it spans. */\nfunction markerAt(\n  children: HastNode[],\n  i: number,\n): { attributes: Attribute[]; length: number } | undefined {\n  const first = children[i];\n  if (first?.type !== \"raw\" || first.value === undefined) return undefined;\n  if (first.value.endsWith(CLOSE)) {\n    // One node holding both tags.\n    const open = first.value.slice(0, -CLOSE.length);\n    const attributes = parseOpen(open);\n    return attributes && { attributes, length: 1 };\n  }\n  const second = children[i + 1];\n  if (second?.type !== \"raw\" || second.value !== CLOSE) return undefined;\n  const attributes = parseOpen(first.value);\n  return attributes && { attributes, length: 2 };\n}\n\nfunction parseOpen(tag: string): Attribute[] | undefined {\n  const match = OPEN.exec(tag);\n  if (match === null) return undefined;\n  const attributes: Attribute[] = [];\n  for (const [, name, value] of (match[1] ?? \"\").matchAll(ATTRIBUTE)) {\n    if (name !== undefined && value !== undefined) attributes.push([name, decode(value)]);\n  }\n  return attributes;\n}\n\n/** The marker's four escapes; any other `&` is literal. */\nfunction decode(value: string): string {\n  return value.replace(/&(quot|amp|lt|gt);/g, (_, name: string) =>\n    name === \"quot\" ? '\"' : name === \"amp\" ? \"&\" : name === \"lt\" ? \"<\" : \">\",\n  );\n}\n\n/** The spaces, tabs, and line breaks directly before `children[i]`, which a heading's marker removes. */\nfunction trailingWhitespace(children: HastNode[], i: number): Edit[\"trim\"] {\n  const trim: Edit[\"trim\"] = [];\n  for (let j = i - 1; j >= 0; j--) {\n    const node = children[j];\n    if (node?.type !== \"text\" || node.value === undefined) break;\n    const value = node.value.replace(/[ \\t\\r\\n]+$/, \"\");\n    if (value === node.value) break;\n    trim.push({ node, value });\n    if (value !== \"\") break;\n  }\n  return trim;\n}\n\nfunction visitParents(node: HastNode, visit: (parent: HastNode) => void): void {\n  if (node.children === undefined) return;\n  visit(node);\n  for (const child of node.children) visitParents(child, visit);\n}\n\n/**\n * A marker attribute as a hast property: the property name hast and Astro use\n * (`class` is `className`) and a value of the shape that property has.\n */\nexport function toProperty([name, value]: Attribute): [string, string | string[]] {\n  const info = find(html, name);\n  if (info.spaceSeparated) return [info.property, value.split(/\\s+/).filter((s) => s !== \"\")];\n  if (info.commaSeparated) return [info.property, value.split(/\\s*,\\s*/)];\n  return [info.property, value];\n}\n\n/** What applying one source anchor (site-render contract §7) changes. */\nexport interface AnchorEdit {\n  /** The anchor comment, and the whitespace-only text directly after it, which are removed. */\n  remove: HastNode[];\n  /** Elements that get attributes: the block, and a list's items. Empty when the anchor applies to nothing. */\n  targets: { node: HastNode; attributes: Attribute[] }[];\n  /** Raw HTML whose first tag gets the anchor's attributes: the node and its new text. */\n  replace?: { node: HastNode; value: string };\n}\n\nconst ANCHOR = new RegExp(`^<!--${COMMENT_ANCHOR}((?: [a-z][a-z0-9-]*=\"[^\"\\\\r\\\\n]*\")+)-->\\\\s*$`);\n\n/** Finds every source anchor comment in `root`, and what it applies to. */\nexport function findAnchors(root: HastNode): AnchorEdit[] {\n  const edits: AnchorEdit[] = [];\n  visitParents(root, (parent) => {\n    const children = parent.children ?? [];\n    for (let i = 0; i < children.length; i++) {\n      const node = children[i];\n      if (node?.type !== \"raw\" || node.value === undefined) continue;\n      const anchor = parseAnchor(node.value);\n      if (anchor === undefined) continue;\n      const edit: AnchorEdit = { remove: [node], targets: [] };\n      let next = i + 1;\n      const after = children[next];\n      if (after?.type === \"text\" && after.value?.trim() === \"\") {\n        edit.remove.push(after);\n        next++;\n      }\n      const target = children[next];\n      if (anchor.tag === \"pre\" && target !== undefined && isCodeTitle(target)) {\n        // A titled code block, which the code-titles transformer put in a\n        // figure: the anchor marks the figure, so the mark holds the caption.\n        edit.targets.push({\n          node: target,\n          attributes: anchorAttributes(anchor.source, anchor.via),\n        });\n      } else if (target?.type === \"element\" && target.tagName?.toLowerCase() === anchor.tag) {\n        edit.targets.push({\n          node: target,\n          attributes: anchorAttributes(anchor.source, anchor.via),\n        });\n        if ((anchor.tag === \"ul\" || anchor.tag === \"ol\") && anchor.items.length > 0) {\n          const items = (target.children ?? []).filter(\n            (child) => child.type === \"element\" && child.tagName === \"li\",\n          );\n          const path = anchor.source.slice(0, anchor.source.lastIndexOf(\":\"));\n          if (items.length === anchor.items.length) {\n            items.forEach((item, n) =>\n              edit.targets.push({\n                node: item,\n                attributes: anchorAttributes(`${path}:${anchor.items[n]}`, anchor.via),\n              }),\n            );\n          }\n        }\n      } else if (target?.type === \"raw\" && target.value !== undefined) {\n        const value = intoFirstTag(target.value, anchor);\n        if (value !== undefined) edit.replace = { node: target, value };\n      }\n      edits.push(edit);\n    }\n  });\n  return edits;\n}\n\n/** Whether a node is a `<figure class=\"code-title\">` holding a `<pre>` (`code-titles.ts`). */\nfunction isCodeTitle(node: HastNode): boolean {\n  if (node.type !== \"element\" || node.tagName?.toLowerCase() !== \"figure\") return false;\n  const className = node.properties?.[\"className\"] ?? node.properties?.[\"class\"];\n  const classes = Array.isArray(className)\n    ? className.map(String)\n    : typeof className === \"string\"\n      ? className.split(/\\s+/)\n      : [];\n  return (\n    classes.includes(\"code-title\") &&\n    (node.children ?? []).some(\n      (child) => child.type === \"element\" && child.tagName?.toLowerCase() === \"pre\",\n    )\n  );\n}\n\ninterface Anchor {\n  tag: string;\n  source: string;\n  via: string | undefined;\n  items: string[];\n}\n\nfunction parseAnchor(text: string): Anchor | undefined {\n  const match = ANCHOR.exec(text);\n  if (match === null) return undefined;\n  const attributes = new Map<string, string>();\n  for (const [, name, value] of (match[1] ?? \"\").matchAll(ATTRIBUTE)) {\n    if (name !== undefined && value !== undefined) attributes.set(name, decode(value));\n  }\n  const tag = attributes.get(\"tag\");\n  const source = attributes.get(\"source\");\n  if (tag === undefined || source === undefined) return undefined;\n  const via = attributes.get(\"via\");\n  return {\n    tag: tag.toLowerCase(),\n    source,\n    via: via === \"\" ? undefined : via,\n    items: (attributes.get(\"items\") ?? \"\").split(/\\s+/).filter((s) => s !== \"\"),\n  };\n}\n\nfunction anchorAttributes(source: string, via: string | undefined): Attribute[] {\n  const attributes: Attribute[] = [[DATA_SOURCE, source]];\n  if (via !== undefined) attributes.push([DATA_VIA, via]);\n  return attributes;\n}\n\n/** Raw HTML with the anchor's attributes after the name of its first tag, when that tag opens the element the anchor names. */\nfunction intoFirstTag(html: string, anchor: Anchor): string | undefined {\n  const open = /^<([A-Za-z][A-Za-z0-9-]*)(?=[\\s>/])/.exec(html);\n  if (open?.[1] === undefined || open[1].toLowerCase() !== anchor.tag) return undefined;\n  const written = anchorAttributes(anchor.source, anchor.via)\n    .map(([name, value]) => ` ${name}=\"${encode(value)}\"`)\n    .join(\"\");\n  return html.slice(0, open[0].length) + written + html.slice(open[0].length);\n}\n\nfunction encode(value: string): string {\n  return value.replace(/[&<>\"]/g, (ch) =>\n    ch === \"&\" ? \"&amp;\" : ch === \"<\" ? \"&lt;\" : ch === \">\" ? \"&gt;\" : \"&quot;\",\n  );\n}\n"]}

package/dist/content.d.ts

@@ -4,7 +4,7 @@ import { glob } from "astro/loaders";
  * pages, with the generated Zod schema (`_ascribe/schema.ts`'s `schema`).
  *
  * Entry ids are Astro's own (`guides/my-setup` for `Guides/My Setup.md`, `index`
- * for the root page), which is what `AstroRouter` in `tessera-resolve`
+ * for the root page), which is what `AstroRouter` in `ascribe-resolve`
  * computes, so a page's route is the base path plus its id, and the root page is
  * at the base path itself.
  */

package/dist/content.js

@@ -15,7 +15,7 @@ import { siteRoot } from "virtual:ascribe/site";
  * pages, with the generated Zod schema (`_ascribe/schema.ts`'s `schema`).
  *
  * Entry ids are Astro's own (`guides/my-setup` for `Guides/My Setup.md`, `index`
- * for the root page), which is what `AstroRouter` in `tessera-resolve`
+ * for the root page), which is what `AstroRouter` in `ascribe-resolve`
  * computes, so a page's route is the base path plus its id, and the root page is
  * at the base path itself.
  */

package/dist/content.js.map

@@ -1 +1 @@
-{"version":3,"file":"content.js","sourceRoot":"","sources":["../src/content.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,6EAA6E;AAC7E,2EAA2E;AAC3E,EAAE;AACF,sDAAsD;AACtD,iEAAiE;AACjE,6EAA6E;AAC7E,0FAA0F;AAC1F,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAI,OAAsB;IAIzD,iEAAiE;IACjE,MAAM,IAAI,GAAG,aAAa,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IAChD,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC,SAAS,EAAE,cAAc,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;AAClG,CAAC","sourcesContent":["// The content collection over a build's site output. Import it from\n// `content.config.ts`, which Vite loads, so it can read what the integration\n// resolved (`virtual:ascribe/site`) instead of finding the project itself.\n//\n//   import { defineCollection } from \"astro:content\";\n//   import { ascribeCollection } from \"@ascribed/astro/content\";\n//   import { schema } from \"../.ascribe/build/site/site/_ascribe/schema.ts\";\n//   export const collections = { docs: defineCollection(ascribeCollection({ schema })) };\nimport { pathToFileURL } from \"node:url\";\nimport path from \"node:path\";\nimport { glob } from \"astro/loaders\";\nimport { siteRoot } from \"virtual:ascribe/site\";\n\n/**\n * The collection's loader and schema: the `glob` loader on the site output's\n * pages, with the generated Zod schema (`_ascribe/schema.ts`'s `schema`).\n *\n * Entry ids are Astro's own (`guides/my-setup` for `Guides/My Setup.md`, `index`\n * for the root page), which is what `AstroRouter` in `tessera-resolve`\n * computes, so a page's route is the base path plus its id, and the root page is\n * at the base path itself.\n */\nexport function ascribeCollection<S>(options: { schema: S }): {\n  loader: ReturnType<typeof glob>;\n  schema: S;\n} {\n  // `_ascribe/` holds the schema and published files, never pages.\n  const base = pathToFileURL(siteRoot + path.sep);\n  return { loader: glob({ pattern: [\"**/*.md\", \"!_ascribe/**\"], base }), schema: options.schema };\n}\n"]}
+{"version":3,"file":"content.js","sourceRoot":"","sources":["../src/content.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,6EAA6E;AAC7E,2EAA2E;AAC3E,EAAE;AACF,sDAAsD;AACtD,iEAAiE;AACjE,6EAA6E;AAC7E,0FAA0F;AAC1F,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAI,OAAsB;IAIzD,iEAAiE;IACjE,MAAM,IAAI,GAAG,aAAa,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IAChD,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC,SAAS,EAAE,cAAc,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;AAClG,CAAC","sourcesContent":["// The content collection over a build's site output. Import it from\n// `content.config.ts`, which Vite loads, so it can read what the integration\n// resolved (`virtual:ascribe/site`) instead of finding the project itself.\n//\n//   import { defineCollection } from \"astro:content\";\n//   import { ascribeCollection } from \"@ascribed/astro/content\";\n//   import { schema } from \"../.ascribe/build/site/site/_ascribe/schema.ts\";\n//   export const collections = { docs: defineCollection(ascribeCollection({ schema })) };\nimport { pathToFileURL } from \"node:url\";\nimport path from \"node:path\";\nimport { glob } from \"astro/loaders\";\nimport { siteRoot } from \"virtual:ascribe/site\";\n\n/**\n * The collection's loader and schema: the `glob` loader on the site output's\n * pages, with the generated Zod schema (`_ascribe/schema.ts`'s `schema`).\n *\n * Entry ids are Astro's own (`guides/my-setup` for `Guides/My Setup.md`, `index`\n * for the root page), which is what `AstroRouter` in `ascribe-resolve`\n * computes, so a page's route is the base path plus its id, and the root page is\n * at the base path itself.\n */\nexport function ascribeCollection<S>(options: { schema: S }): {\n  loader: ReturnType<typeof glob>;\n  schema: S;\n} {\n  // `_ascribe/` holds the schema and published files, never pages.\n  const base = pathToFileURL(siteRoot + path.sep);\n  return { loader: glob({ pattern: [\"**/*.md\", \"!_ascribe/**\"], base }), schema: options.schema };\n}\n"]}

package/dist/names.d.ts

@@ -0,0 +1,95 @@
+/** `<ascribe-note>`: a note (packages/elements/CONTRACT.md §1). */
+export declare const ELEMENT_NOTE = "ascribe-note";
+/** `<ascribe-steps>`: a procedure (packages/elements/CONTRACT.md §2). */
+export declare const ELEMENT_STEPS = "ascribe-steps";
+/** `<ascribe-tabs>`: a variant group of several arms (packages/elements/CONTRACT.md §3). */
+export declare const ELEMENT_TABS = "ascribe-tabs";
+/** `<ascribe-tab>`: one arm of `<ascribe-tabs>` (packages/elements/CONTRACT.md §3). */
+export declare const ELEMENT_TAB = "ascribe-tab";
+/** `<ascribe-availability>`: a badge or filter (packages/elements/CONTRACT.md §4). */
+export declare const ELEMENT_AVAILABILITY = "ascribe-availability";
+/**
+ * `<ascribe-availability-target>`: one target of `<ascribe-availability>`
+ * (packages/elements/CONTRACT.md §4).
+ */
+export declare const ELEMENT_AVAILABILITY_TARGET = "ascribe-availability-target";
+/** `<ascribe-group>`: a project widget's group (packages/elements/CONTRACT.md §6). */
+export declare const ELEMENT_GROUP = "ascribe-group";
+/** `<ascribe-attributes>`: the attribute marker (site-render contract §1). */
+export declare const ELEMENT_ATTRIBUTES = "ascribe-attributes";
+/** The name an anchor comment starts with, `<!--ascribe-anchor` (site-render contract §7.3). */
+export declare const COMMENT_ANCHOR = "ascribe-anchor";
+/** A block's source anchor (site-render contract §7.1). */
+export declare const DATA_SOURCE = "data-ascribe-source";
+/** The includes a block came through (site-render contract §7.1). */
+export declare const DATA_VIA = "data-ascribe-via";
+/** A glossary term's id, on its link (packages/elements/CONTRACT.md §7). */
+export declare const DATA_TERM = "data-ascribe-term";
+/** The element the report draws into. */
+export declare const ID_REPORT = "ascribe-review";
+/** The `<script type="application/json">` holding the report's data. */
+export declare const ID_REPORT_DATA = "ascribe-review-data";
+/**
+ * The page's light or dark scheme, `light` or `dark`, on the root
+ * element (docs/content/guides/astro.md).
+ */
+export declare const DATA_SCHEME = "data-ascribe-scheme";
+/** On a marked page's root: what it shows, `changes`, `will`, or `was`. */
+export declare const DATA_SHOW = "data-ascribe-show";
+/**
+ * On a marked block: its change, `added`, `changed`, `removed`, `moved`,
+ * or `moved-from`.
+ */
+export declare const DATA_CHANGE = "data-ascribe-change";
+/** On every element review adds to the page, so it can be taken away again. */
+export declare const DATA_UI = "data-ascribe-ui";
+/** On a change's label: the change. */
+export declare const DATA_LABEL = "data-ascribe-label";
+/** On a tab's hint: `added` or `changed`. */
+export declare const DATA_HINT = "data-ascribe-hint";
+/** On a moved block: the id its "moved from" link points at. */
+export declare const DATA_MOVE = "data-ascribe-move";
+/** On a changed block whose copy as it was follows it. */
+export declare const DATA_HAS_WAS = "data-ascribe-has-was";
+/** On a copy of a block as it was, shown only with the page as it was. */
+export declare const DATA_WAS_ONLY = "data-ascribe-was-only";
+/** On a changed, removed, or moved block: its source anchor as it was. */
+export declare const DATA_WAS_SOURCE = "data-ascribe-was-source";
+/** On the elements that hold the threads' overlay. */
+export declare const DATA_OVERLAY = "data-ascribe-overlay";
+/** On the style element the Astro dev toolbar adds for the marks. */
+export declare const DATA_REVIEW = "data-ascribe-review";
+/** On the root of a page whose changes are marked. */
+export declare const CLASS_MARKS = "ascribe-marks";
+/** A change's label. */
+export declare const CLASS_LABEL = "ascribe-label";
+/** A label placed before its block rather than over it. */
+export declare const CLASS_LABEL_BEFORE = "ascribe-label-before";
+/** Inserted text. */
+export declare const CLASS_INS = "ascribe-ins";
+/** Deleted text. */
+export declare const CLASS_DEL = "ascribe-del";
+/** A removed block. */
+export declare const CLASS_REMOVED = "ascribe-removed";
+/** A removed block's content. */
+export declare const CLASS_REMOVED_BODY = "ascribe-removed-body";
+/** The button that shows or collapses a removed block. */
+export declare const CLASS_TOGGLE = "ascribe-toggle";
+/** On a removed block that's shown. */
+export declare const CLASS_OPEN = "ascribe-open";
+/** What stands where a moved block was. */
+export declare const CLASS_MOVED_FROM = "ascribe-moved-from";
+/** The note with a moved block's link. */
+export declare const CLASS_MOVE_NOTE = "ascribe-move-note";
+/** A move note after its block, not inside it. */
+export declare const CLASS_MOVE_AFTER = "ascribe-move-after";
+/** The link between a moved block and where it was. */
+export declare const CLASS_MOVE_LINK = "ascribe-move-link";
+/** A moved block's copy as it was, where it was. */
+export declare const CLASS_WAS_COPY = "ascribe-was-copy";
+/** A tab's hint that it holds changes. */
+export declare const CLASS_HINT = "ascribe-hint";
+/** A block flashed after going to it. */
+export declare const CLASS_FLASH = "ascribe-flash";
+/** The tip that shows a block's source on hover and focus. */
+export declare const CLASS_WHERE = "ascribe-where";

package/dist/names.js

@@ -0,0 +1,99 @@
+// The names Ascribe puts on a page: elements, attributes, classes, and ids.
+// Generated from crates/ascribe-core/src/names.rs by
+// `ASCRIBE_BLESS=1 cargo test -p ascribe-core --test names`. Don't edit it.
+/** `<ascribe-note>`: a note (packages/elements/CONTRACT.md §1). */
+export const ELEMENT_NOTE = "ascribe-note";
+/** `<ascribe-steps>`: a procedure (packages/elements/CONTRACT.md §2). */
+export const ELEMENT_STEPS = "ascribe-steps";
+/** `<ascribe-tabs>`: a variant group of several arms (packages/elements/CONTRACT.md §3). */
+export const ELEMENT_TABS = "ascribe-tabs";
+/** `<ascribe-tab>`: one arm of `<ascribe-tabs>` (packages/elements/CONTRACT.md §3). */
+export const ELEMENT_TAB = "ascribe-tab";
+/** `<ascribe-availability>`: a badge or filter (packages/elements/CONTRACT.md §4). */
+export const ELEMENT_AVAILABILITY = "ascribe-availability";
+/**
+ * `<ascribe-availability-target>`: one target of `<ascribe-availability>`
+ * (packages/elements/CONTRACT.md §4).
+ */
+export const ELEMENT_AVAILABILITY_TARGET = "ascribe-availability-target";
+/** `<ascribe-group>`: a project widget's group (packages/elements/CONTRACT.md §6). */
+export const ELEMENT_GROUP = "ascribe-group";
+/** `<ascribe-attributes>`: the attribute marker (site-render contract §1). */
+export const ELEMENT_ATTRIBUTES = "ascribe-attributes";
+/** The name an anchor comment starts with, `<!--ascribe-anchor` (site-render contract §7.3). */
+export const COMMENT_ANCHOR = "ascribe-anchor";
+/** A block's source anchor (site-render contract §7.1). */
+export const DATA_SOURCE = "data-ascribe-source";
+/** The includes a block came through (site-render contract §7.1). */
+export const DATA_VIA = "data-ascribe-via";
+/** A glossary term's id, on its link (packages/elements/CONTRACT.md §7). */
+export const DATA_TERM = "data-ascribe-term";
+/** The element the report draws into. */
+export const ID_REPORT = "ascribe-review";
+/** The `<script type="application/json">` holding the report's data. */
+export const ID_REPORT_DATA = "ascribe-review-data";
+/**
+ * The page's light or dark scheme, `light` or `dark`, on the root
+ * element (docs/content/guides/astro.md).
+ */
+export const DATA_SCHEME = "data-ascribe-scheme";
+/** On a marked page's root: what it shows, `changes`, `will`, or `was`. */
+export const DATA_SHOW = "data-ascribe-show";
+/**
+ * On a marked block: its change, `added`, `changed`, `removed`, `moved`,
+ * or `moved-from`.
+ */
+export const DATA_CHANGE = "data-ascribe-change";
+/** On every element review adds to the page, so it can be taken away again. */
+export const DATA_UI = "data-ascribe-ui";
+/** On a change's label: the change. */
+export const DATA_LABEL = "data-ascribe-label";
+/** On a tab's hint: `added` or `changed`. */
+export const DATA_HINT = "data-ascribe-hint";
+/** On a moved block: the id its "moved from" link points at. */
+export const DATA_MOVE = "data-ascribe-move";
+/** On a changed block whose copy as it was follows it. */
+export const DATA_HAS_WAS = "data-ascribe-has-was";
+/** On a copy of a block as it was, shown only with the page as it was. */
+export const DATA_WAS_ONLY = "data-ascribe-was-only";
+/** On a changed, removed, or moved block: its source anchor as it was. */
+export const DATA_WAS_SOURCE = "data-ascribe-was-source";
+/** On the elements that hold the threads' overlay. */
+export const DATA_OVERLAY = "data-ascribe-overlay";
+/** On the style element the Astro dev toolbar adds for the marks. */
+export const DATA_REVIEW = "data-ascribe-review";
+/** On the root of a page whose changes are marked. */
+export const CLASS_MARKS = "ascribe-marks";
+/** A change's label. */
+export const CLASS_LABEL = "ascribe-label";
+/** A label placed before its block rather than over it. */
+export const CLASS_LABEL_BEFORE = "ascribe-label-before";
+/** Inserted text. */
+export const CLASS_INS = "ascribe-ins";
+/** Deleted text. */
+export const CLASS_DEL = "ascribe-del";
+/** A removed block. */
+export const CLASS_REMOVED = "ascribe-removed";
+/** A removed block's content. */
+export const CLASS_REMOVED_BODY = "ascribe-removed-body";
+/** The button that shows or collapses a removed block. */
+export const CLASS_TOGGLE = "ascribe-toggle";
+/** On a removed block that's shown. */
+export const CLASS_OPEN = "ascribe-open";
+/** What stands where a moved block was. */
+export const CLASS_MOVED_FROM = "ascribe-moved-from";
+/** The note with a moved block's link. */
+export const CLASS_MOVE_NOTE = "ascribe-move-note";
+/** A move note after its block, not inside it. */
+export const CLASS_MOVE_AFTER = "ascribe-move-after";
+/** The link between a moved block and where it was. */
+export const CLASS_MOVE_LINK = "ascribe-move-link";
+/** A moved block's copy as it was, where it was. */
+export const CLASS_WAS_COPY = "ascribe-was-copy";
+/** A tab's hint that it holds changes. */
+export const CLASS_HINT = "ascribe-hint";
+/** A block flashed after going to it. */
+export const CLASS_FLASH = "ascribe-flash";
+/** The tip that shows a block's source on hover and focus. */
+export const CLASS_WHERE = "ascribe-where";
+//# sourceMappingURL=names.js.map

package/dist/names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"names.js","sourceRoot":"","sources":["../src/names.ts"],"names":[],"mappings":"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","sourcesContent":["// The names Ascribe puts on a page: elements, attributes, classes, and ids.\n// Generated from crates/ascribe-core/src/names.rs by\n// `ASCRIBE_BLESS=1 cargo test -p ascribe-core --test names`. Don't edit it.\n\n/** `<ascribe-note>`: a note (packages/elements/CONTRACT.md §1). */\nexport const ELEMENT_NOTE = \"ascribe-note\";\n\n/** `<ascribe-steps>`: a procedure (packages/elements/CONTRACT.md §2). */\nexport const ELEMENT_STEPS = \"ascribe-steps\";\n\n/** `<ascribe-tabs>`: a variant group of several arms (packages/elements/CONTRACT.md §3). */\nexport const ELEMENT_TABS = \"ascribe-tabs\";\n\n/** `<ascribe-tab>`: one arm of `<ascribe-tabs>` (packages/elements/CONTRACT.md §3). */\nexport const ELEMENT_TAB = \"ascribe-tab\";\n\n/** `<ascribe-availability>`: a badge or filter (packages/elements/CONTRACT.md §4). */\nexport const ELEMENT_AVAILABILITY = \"ascribe-availability\";\n\n/**\n * `<ascribe-availability-target>`: one target of `<ascribe-availability>`\n * (packages/elements/CONTRACT.md §4).\n */\nexport const ELEMENT_AVAILABILITY_TARGET = \"ascribe-availability-target\";\n\n/** `<ascribe-group>`: a project widget's group (packages/elements/CONTRACT.md §6). */\nexport const ELEMENT_GROUP = \"ascribe-group\";\n\n/** `<ascribe-attributes>`: the attribute marker (site-render contract §1). */\nexport const ELEMENT_ATTRIBUTES = \"ascribe-attributes\";\n\n/** The name an anchor comment starts with, `<!--ascribe-anchor` (site-render contract §7.3). */\nexport const COMMENT_ANCHOR = \"ascribe-anchor\";\n\n/** A block's source anchor (site-render contract §7.1). */\nexport const DATA_SOURCE = \"data-ascribe-source\";\n\n/** The includes a block came through (site-render contract §7.1). */\nexport const DATA_VIA = \"data-ascribe-via\";\n\n/** A glossary term's id, on its link (packages/elements/CONTRACT.md §7). */\nexport const DATA_TERM = \"data-ascribe-term\";\n\n/** The element the report draws into. */\nexport const ID_REPORT = \"ascribe-review\";\n\n/** The `<script type=\"application/json\">` holding the report's data. */\nexport const ID_REPORT_DATA = \"ascribe-review-data\";\n\n/**\n * The page's light or dark scheme, `light` or `dark`, on the root\n * element (docs/content/guides/astro.md).\n */\nexport const DATA_SCHEME = \"data-ascribe-scheme\";\n\n/** On a marked page's root: what it shows, `changes`, `will`, or `was`. */\nexport const DATA_SHOW = \"data-ascribe-show\";\n\n/**\n * On a marked block: its change, `added`, `changed`, `removed`, `moved`,\n * or `moved-from`.\n */\nexport const DATA_CHANGE = \"data-ascribe-change\";\n\n/** On every element review adds to the page, so it can be taken away again. */\nexport const DATA_UI = \"data-ascribe-ui\";\n\n/** On a change's label: the change. */\nexport const DATA_LABEL = \"data-ascribe-label\";\n\n/** On a tab's hint: `added` or `changed`. */\nexport const DATA_HINT = \"data-ascribe-hint\";\n\n/** On a moved block: the id its \"moved from\" link points at. */\nexport const DATA_MOVE = \"data-ascribe-move\";\n\n/** On a changed block whose copy as it was follows it. */\nexport const DATA_HAS_WAS = \"data-ascribe-has-was\";\n\n/** On a copy of a block as it was, shown only with the page as it was. */\nexport const DATA_WAS_ONLY = \"data-ascribe-was-only\";\n\n/** On a changed, removed, or moved block: its source anchor as it was. */\nexport const DATA_WAS_SOURCE = \"data-ascribe-was-source\";\n\n/** On the elements that hold the threads' overlay. */\nexport const DATA_OVERLAY = \"data-ascribe-overlay\";\n\n/** On the style element the Astro dev toolbar adds for the marks. */\nexport const DATA_REVIEW = \"data-ascribe-review\";\n\n/** On the root of a page whose changes are marked. */\nexport const CLASS_MARKS = \"ascribe-marks\";\n\n/** A change's label. */\nexport const CLASS_LABEL = \"ascribe-label\";\n\n/** A label placed before its block rather than over it. */\nexport const CLASS_LABEL_BEFORE = \"ascribe-label-before\";\n\n/** Inserted text. */\nexport const CLASS_INS = \"ascribe-ins\";\n\n/** Deleted text. */\nexport const CLASS_DEL = \"ascribe-del\";\n\n/** A removed block. */\nexport const CLASS_REMOVED = \"ascribe-removed\";\n\n/** A removed block's content. */\nexport const CLASS_REMOVED_BODY = \"ascribe-removed-body\";\n\n/** The button that shows or collapses a removed block. */\nexport const CLASS_TOGGLE = \"ascribe-toggle\";\n\n/** On a removed block that's shown. */\nexport const CLASS_OPEN = \"ascribe-open\";\n\n/** What stands where a moved block was. */\nexport const CLASS_MOVED_FROM = \"ascribe-moved-from\";\n\n/** The note with a moved block's link. */\nexport const CLASS_MOVE_NOTE = \"ascribe-move-note\";\n\n/** A move note after its block, not inside it. */\nexport const CLASS_MOVE_AFTER = \"ascribe-move-after\";\n\n/** The link between a moved block and where it was. */\nexport const CLASS_MOVE_LINK = \"ascribe-move-link\";\n\n/** A moved block's copy as it was, where it was. */\nexport const CLASS_WAS_COPY = \"ascribe-was-copy\";\n\n/** A tab's hint that it holds changes. */\nexport const CLASS_HINT = \"ascribe-hint\";\n\n/** A block flashed after going to it. */\nexport const CLASS_FLASH = \"ascribe-flash\";\n\n/** The tip that shows a block's source on hover and focus. */\nexport const CLASS_WHERE = \"ascribe-where\";\n"]}

package/dist/review/diff.d.ts

@@ -1,8 +1,8 @@
-import type { DiffBase, DiffPage } from "./protocol.js";
+import type { BaseInfo, PageDiff } from "./protocol.js";
 /** One build's changes against a base. */
 export interface DiffResult {
-    base: DiffBase;
-    pages: DiffPage[];
+    base: BaseInfo;
+    pages: PageDiff[];
     /** How many errors `ascribe check` finds in the working tree for the build. */
     errors: number;
 }

package/dist/review/diff.js

@@ -36,6 +36,7 @@ export function runDiff(options) {
 }
 /** The build's part of `ascribe diff --format json`'s output. */
 export function parseDiff(json, build) {
+    // Checked as far as telling a diff report from other JSON.
     const report = JSON.parse(json);
     if (report.base === undefined || !Array.isArray(report.builds)) {
         throw new Error("not a diff report");

package/dist/review/diff.js.map

@@ -1 +1 @@
-{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../src/review/diff.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAW9C;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,OAMvB;IACC,MAAM,IAAI,GAAG;QACX,MAAM;QACN,UAAU;QACV,MAAM;QACN,SAAS;QACT,OAAO,CAAC,KAAK;QACb,UAAU;QACV,OAAO,CAAC,UAAU;QAClB,SAAS;QACT,OAAO;KACR,CAAC;IACF,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;QAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,QAAQ,CACN,OAAO,CAAC,MAAM,EACd,IAAI,EACJ,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,GAAG,IAAI,GAAG,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,EACrE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;YACxB,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACnB,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;gBAC7B,MAAM,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;gBAC5E,OAAO;YACT,CAAC;YACD,IAAI,CAAC;gBACH,OAAO,CAAC,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;YAC5C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,IAAI,KAAK,CAAC,kDAAkD,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;YACnF,CAAC;QACH,CAAC,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,KAAa;IACnD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAI7B,CAAC;IACF,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/D,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACvC,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,EAAE,KAAK,IAAI,EAAE,CAAC;IACxE,MAAM,MAAM,GAAG,OAAO,MAAM,CAAC,mBAAmB,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/F,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAC9C,CAAC","sourcesContent":["// Running `ascribe diff --format json` for the integration's build.\nimport { execFile } from \"node:child_process\";\nimport type { DiffBase, DiffPage } from \"./protocol.js\";\n\n/** One build's changes against a base. */\nexport interface DiffResult {\n  base: DiffBase;\n  pages: DiffPage[];\n  /** How many errors `ascribe check` finds in the working tree for the build. */\n  errors: number;\n}\n\n/**\n * Compares the build's pages with `base` (the default branch when it's\n * `undefined`). Rejects with `ascribe diff`'s reason as the message.\n */\nexport function runDiff(options: {\n  binary: string;\n  configPath: string;\n  build: string;\n  cwd: string;\n  base: string | undefined;\n}): Promise<DiffResult> {\n  const args = [\n    \"diff\",\n    \"--format\",\n    \"json\",\n    \"--build\",\n    options.build,\n    \"--config\",\n    options.configPath,\n    \"--color\",\n    \"never\",\n  ];\n  if (options.base !== undefined) args.push(\"--base\", options.base);\n  return new Promise((resolve, reject) => {\n    execFile(\n      options.binary,\n      args,\n      { cwd: options.cwd, maxBuffer: 256 * 1024 * 1024, windowsHide: true },\n      (error, stdout, stderr) => {\n        if (error !== null) {\n          const reason = stderr.trim();\n          reject(new Error(reason === \"\" ? error.message : reason, { cause: error }));\n          return;\n        }\n        try {\n          resolve(parseDiff(stdout, options.build));\n        } catch (cause) {\n          reject(new Error(\"`ascribe diff` wrote output that isn't its JSON.\", { cause }));\n        }\n      },\n    );\n  });\n}\n\n/** The build's part of `ascribe diff --format json`'s output. */\nexport function parseDiff(json: string, build: string): DiffResult {\n  const report = JSON.parse(json) as {\n    base?: DiffBase;\n    working_tree_errors?: number;\n    builds?: { build: string; pages: DiffPage[] }[];\n  };\n  if (report.base === undefined || !Array.isArray(report.builds)) {\n    throw new Error(\"not a diff report\");\n  }\n  const pages = report.builds.find((b) => b.build === build)?.pages ?? [];\n  const errors = typeof report.working_tree_errors === \"number\" ? report.working_tree_errors : 0;\n  return { base: report.base, pages, errors };\n}\n"]}
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../src/review/diff.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAY9C;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,OAMvB;IACC,MAAM,IAAI,GAAG;QACX,MAAM;QACN,UAAU;QACV,MAAM;QACN,SAAS;QACT,OAAO,CAAC,KAAK;QACb,UAAU;QACV,OAAO,CAAC,UAAU;QAClB,SAAS;QACT,OAAO;KACR,CAAC;IACF,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;QAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,QAAQ,CACN,OAAO,CAAC,MAAM,EACd,IAAI,EACJ,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,GAAG,IAAI,GAAG,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,EACrE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;YACxB,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACnB,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;gBAC7B,MAAM,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;gBAC5E,OAAO;YACT,CAAC;YACD,IAAI,CAAC;gBACH,OAAO,CAAC,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;YAC5C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,IAAI,KAAK,CAAC,kDAAkD,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;YACnF,CAAC;QACH,CAAC,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,KAAa;IACnD,2DAA2D;IAC3D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAwB,CAAC;IACvD,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/D,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACvC,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,EAAE,KAAK,IAAI,EAAE,CAAC;IACxE,MAAM,MAAM,GAAG,OAAO,MAAM,CAAC,mBAAmB,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/F,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAC9C,CAAC","sourcesContent":["// Running `ascribe diff --format json` for the integration's build.\nimport { execFile } from \"node:child_process\";\nimport type { DiffReport } from \"../shapes.js\";\nimport type { BaseInfo, PageDiff } from \"./protocol.js\";\n\n/** One build's changes against a base. */\nexport interface DiffResult {\n  base: BaseInfo;\n  pages: PageDiff[];\n  /** How many errors `ascribe check` finds in the working tree for the build. */\n  errors: number;\n}\n\n/**\n * Compares the build's pages with `base` (the default branch when it's\n * `undefined`). Rejects with `ascribe diff`'s reason as the message.\n */\nexport function runDiff(options: {\n  binary: string;\n  configPath: string;\n  build: string;\n  cwd: string;\n  base: string | undefined;\n}): Promise<DiffResult> {\n  const args = [\n    \"diff\",\n    \"--format\",\n    \"json\",\n    \"--build\",\n    options.build,\n    \"--config\",\n    options.configPath,\n    \"--color\",\n    \"never\",\n  ];\n  if (options.base !== undefined) args.push(\"--base\", options.base);\n  return new Promise((resolve, reject) => {\n    execFile(\n      options.binary,\n      args,\n      { cwd: options.cwd, maxBuffer: 256 * 1024 * 1024, windowsHide: true },\n      (error, stdout, stderr) => {\n        if (error !== null) {\n          const reason = stderr.trim();\n          reject(new Error(reason === \"\" ? error.message : reason, { cause: error }));\n          return;\n        }\n        try {\n          resolve(parseDiff(stdout, options.build));\n        } catch (cause) {\n          reject(new Error(\"`ascribe diff` wrote output that isn't its JSON.\", { cause }));\n        }\n      },\n    );\n  });\n}\n\n/** The build's part of `ascribe diff --format json`'s output. */\nexport function parseDiff(json: string, build: string): DiffResult {\n  // Checked as far as telling a diff report from other JSON.\n  const report = JSON.parse(json) as Partial<DiffReport>;\n  if (report.base === undefined || !Array.isArray(report.builds)) {\n    throw new Error(\"not a diff report\");\n  }\n  const pages = report.builds.find((b) => b.build === build)?.pages ?? [];\n  const errors = typeof report.working_tree_errors === \"number\" ? report.working_tree_errors : 0;\n  return { base: report.base, pages, errors };\n}\n"]}

package/dist/review/protocol.d.ts

@@ -1,6 +1,7 @@
-import type { Change } from "@ascribed/review/marks";
-/** A block change, as `ascribe diff --format json` reports it and the marks take it. */
-export type { Change };
+import type { BaseInfo, PageDiff } from "../shapes.js";
+import type { FormattedPiece } from "@ascribed/review/overlay";
+/** `ascribe diff --format json`'s types: a changed page, its block changes, and the base. */
+export type { BaseInfo, Change, Counts, PageDiff } from "../shapes.js";
 /** The toolbar app's id, also the prefix of its events. */
 export declare const APP_ID = "ascribe:review";
 export declare const REQUEST_EVENT = "ascribe:review:request";
@@ -22,33 +23,14 @@ export interface Result {
         code?: string;
     };
 }
-export interface Counts {
-    changed: number;
-    added: number;
-    removed: number;
-    moved: number;
-}
-/** A changed page, as `ascribe diff --format json` lists it. */
-export interface DiffPage {
-    path: string;
-    route: string;
-    status: "added" | "removed" | "changed";
-    own_file_changed: boolean;
-    because: string[];
-    page_changed: string[];
-    counts: Counts;
-    changes: Change[];
-}
-/** A changed page in the list: without its changes, and with its title when the build has it. */
-export type ChangedPage = Omit<DiffPage, "changes"> & {
+/**
+ * A changed page in the list: without its changes, and with its title when
+ * the build has it, formatted when its field sets `inline = "code"`.
+ */
+export type ChangedPage = Omit<PageDiff, "changes"> & {
     title: string | null;
+    formatted_title: FormattedPiece[] | null;
 };
-/** The base compared with, as `ascribe diff` reports it. */
-export interface DiffBase {
-    requested: string;
-    commit: string;
-    merge_base: string | null;
-}
 /** How the checkout's `HEAD` relates to the pull request's head commit. */
 export type LocalState = "same" | "behind" | "ahead" | "diverged" | "missing";
 /** The review threads: on, or why not, with a sentence to show. */
@@ -81,8 +63,8 @@ export interface PageView {
     /** The page's content path; `null` for a route that isn't one. */
     path: string | null;
     /** The page's changes; `null` when it didn't change. */
-    page: DiffPage | null;
-    base: DiffBase | null;
+    page: PageDiff | null;
+    base: BaseInfo | null;
     /** Why the changes couldn't be read, when they couldn't. */
     problem: string | null;
     /** How many errors `ascribe check` finds in the working tree for the build. */

package/dist/review/protocol.js.map

@@ -1 +1 @@
-{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../src/review/protocol.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,wEAAwE;AACxE,EAAE;AACF,8EAA8E;AAC9E,yEAAyE;AACzE,8EAA8E;AAC9E,wEAAwE;AACxE,mCAAmC;AAOnC,2DAA2D;AAC3D,MAAM,CAAC,MAAM,MAAM,GAAG,gBAAgB,CAAC;AACvC,MAAM,CAAC,MAAM,aAAa,GAAG,wBAAwB,CAAC;AACtD,MAAM,CAAC,MAAM,YAAY,GAAG,uBAAuB,CAAC;AACpD,MAAM,CAAC,MAAM,aAAa,GAAG,wBAAwB,CAAC","sourcesContent":["// The messages between the toolbar app (in the page) and the dev server,\n// over Astro's dev toolbar channel. Types only: both sides import them.\n//\n// The page sends `ascribe:review:request` with `{ tab, id, method, params }`;\n// the server answers that page with `ascribe:review:result` and the same\n// `tab` and `id`. When a page's request changes the threads, or review stops,\n// the server tells every page with `ascribe:review:changed`, naming the\n// `from` tab, which already knows.\n\nimport type { Change } from \"@ascribed/review/marks\";\n\n/** A block change, as `ascribe diff --format json` reports it and the marks take it. */\nexport type { Change };\n\n/** The toolbar app's id, also the prefix of its events. */\nexport const APP_ID = \"ascribe:review\";\nexport const REQUEST_EVENT = \"ascribe:review:request\";\nexport const RESULT_EVENT = \"ascribe:review:result\";\nexport const CHANGED_EVENT = \"ascribe:review:changed\";\n\nexport interface Request {\n  /** The page's own id, made when it loads. */\n  tab: string;\n  id: number;\n  method: string;\n  params: Record<string, unknown>;\n}\n\nexport interface Result {\n  tab: string;\n  id: number;\n  result?: unknown;\n  error?: { message: string; code?: string };\n}\n\nexport interface Counts {\n  changed: number;\n  added: number;\n  removed: number;\n  moved: number;\n}\n\n/** A changed page, as `ascribe diff --format json` lists it. */\nexport interface DiffPage {\n  path: string;\n  route: string;\n  status: \"added\" | \"removed\" | \"changed\";\n  own_file_changed: boolean;\n  because: string[];\n  page_changed: string[];\n  counts: Counts;\n  changes: Change[];\n}\n\n/** A changed page in the list: without its changes, and with its title when the build has it. */\nexport type ChangedPage = Omit<DiffPage, \"changes\"> & { title: string | null };\n\n/** The base compared with, as `ascribe diff` reports it. */\nexport interface DiffBase {\n  requested: string;\n  commit: string;\n  merge_base: string | null;\n}\n\n/** How the checkout's `HEAD` relates to the pull request's head commit. */\nexport type LocalState = \"same\" | \"behind\" | \"ahead\" | \"diverged\" | \"missing\";\n\n/** The review threads: on, or why not, with a sentence to show. */\nexport type ThreadsState =\n  | {\n      state: \"on\";\n      pullRequest: { number: number; url: string; baseRefName: string };\n      local: { state: LocalState; behind: number; ahead: number };\n    }\n  /** No pull request, no GitHub CLI, no sign-in, a channel other pages could use, or a failure. */\n  | {\n      state: \"no-pull-request\" | \"gh-missing\" | \"signed-out\" | \"unprotected\" | \"error\";\n      message: string;\n    };\n\n/** `status`'s answer. */\nexport interface Status {\n  on: boolean;\n}\n\n/** `page`'s answer: what the app shows for the page at a route. */\nexport interface PageView {\n  /** `\"page\"` for a page of the Ascribe build, `\"not-page\"` for the site's own routes. */\n  kind: \"page\" | \"not-page\";\n  /** The page's content path; `null` for a route that isn't one. */\n  path: string | null;\n  /** The page's changes; `null` when it didn't change. */\n  page: DiffPage | null;\n  base: DiffBase | null;\n  /** Why the changes couldn't be read, when they couldn't. */\n  problem: string | null;\n  /** How many errors `ascribe check` finds in the working tree for the build. */\n  errors: number;\n  threads: ThreadsState;\n  /** The build's changed pages, in path order. */\n  changedPages: ChangedPage[];\n  /** The content root, absolute, and the platform's path separator: for opening a source file. */\n  contentRoot: string;\n  separator: string;\n}\n"]}
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../src/review/protocol.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,wEAAwE;AACxE,EAAE;AACF,8EAA8E;AAC9E,yEAAyE;AACzE,8EAA8E;AAC9E,wEAAwE;AACxE,mCAAmC;AAQnC,2DAA2D;AAC3D,MAAM,CAAC,MAAM,MAAM,GAAG,gBAAgB,CAAC;AACvC,MAAM,CAAC,MAAM,aAAa,GAAG,wBAAwB,CAAC;AACtD,MAAM,CAAC,MAAM,YAAY,GAAG,uBAAuB,CAAC;AACpD,MAAM,CAAC,MAAM,aAAa,GAAG,wBAAwB,CAAC","sourcesContent":["// The messages between the toolbar app (in the page) and the dev server,\n// over Astro's dev toolbar channel. Types only: both sides import them.\n//\n// The page sends `ascribe:review:request` with `{ tab, id, method, params }`;\n// the server answers that page with `ascribe:review:result` and the same\n// `tab` and `id`. When a page's request changes the threads, or review stops,\n// the server tells every page with `ascribe:review:changed`, naming the\n// `from` tab, which already knows.\n\nimport type { BaseInfo, PageDiff } from \"../shapes.js\";\nimport type { FormattedPiece } from \"@ascribed/review/overlay\";\n\n/** `ascribe diff --format json`'s types: a changed page, its block changes, and the base. */\nexport type { BaseInfo, Change, Counts, PageDiff } from \"../shapes.js\";\n\n/** The toolbar app's id, also the prefix of its events. */\nexport const APP_ID = \"ascribe:review\";\nexport const REQUEST_EVENT = \"ascribe:review:request\";\nexport const RESULT_EVENT = \"ascribe:review:result\";\nexport const CHANGED_EVENT = \"ascribe:review:changed\";\n\nexport interface Request {\n  /** The page's own id, made when it loads. */\n  tab: string;\n  id: number;\n  method: string;\n  params: Record<string, unknown>;\n}\n\nexport interface Result {\n  tab: string;\n  id: number;\n  result?: unknown;\n  error?: { message: string; code?: string };\n}\n\n/**\n * A changed page in the list: without its changes, and with its title when\n * the build has it, formatted when its field sets `inline = \"code\"`.\n */\nexport type ChangedPage = Omit<PageDiff, \"changes\"> & {\n  title: string | null;\n  formatted_title: FormattedPiece[] | null;\n};\n\n/** How the checkout's `HEAD` relates to the pull request's head commit. */\nexport type LocalState = \"same\" | \"behind\" | \"ahead\" | \"diverged\" | \"missing\";\n\n/** The review threads: on, or why not, with a sentence to show. */\nexport type ThreadsState =\n  | {\n      state: \"on\";\n      pullRequest: { number: number; url: string; baseRefName: string };\n      local: { state: LocalState; behind: number; ahead: number };\n    }\n  /** No pull request, no GitHub CLI, no sign-in, a channel other pages could use, or a failure. */\n  | {\n      state: \"no-pull-request\" | \"gh-missing\" | \"signed-out\" | \"unprotected\" | \"error\";\n      message: string;\n    };\n\n/** `status`'s answer. */\nexport interface Status {\n  on: boolean;\n}\n\n/** `page`'s answer: what the app shows for the page at a route. */\nexport interface PageView {\n  /** `\"page\"` for a page of the Ascribe build, `\"not-page\"` for the site's own routes. */\n  kind: \"page\" | \"not-page\";\n  /** The page's content path; `null` for a route that isn't one. */\n  path: string | null;\n  /** The page's changes; `null` when it didn't change. */\n  page: PageDiff | null;\n  base: BaseInfo | null;\n  /** Why the changes couldn't be read, when they couldn't. */\n  problem: string | null;\n  /** How many errors `ascribe check` finds in the working tree for the build. */\n  errors: number;\n  threads: ThreadsState;\n  /** The build's changed pages, in path order. */\n  changedPages: ChangedPage[];\n  /** The content root, absolute, and the platform's path separator: for opening a source file. */\n  contentRoot: string;\n  separator: string;\n}\n"]}

package/dist/review/routes.d.ts

@@ -1,3 +1,4 @@
+import type { FormattedPiece } from "@ascribed/review/overlay";
 /** A route as compared: decoded, without a trailing `/` (except the root's). */
 export declare function normalizeRoute(route: string): string;
 /** A page of the build, as its JSON output names it. */
@@ -5,6 +6,8 @@ export interface RoutedPage {
     /** The content path. */
     path: string;
     title: string | null;
+    /** The title formatted, when its field sets `inline = "code"`. */
+    formatted_title: FormattedPiece[] | null;
 }
 /**
  * Every page of the build's JSON output (`<output-dir>/<build>/json/`), by