@ascribed/astro 0.2.0 → 0.2.1-next.10

package/dist/review/routes.js

@@ -15,8 +15,14 @@ export function normalizeRoute(route) {
     const trimmed = (decoded.split(/[?#]/)[0] ?? "").replace(/\/+$/, "");
     return trimmed === "" ? "/" : trimmed;
 }
-/** How much of a page's JSON to read: its `path`, `route`, and `title` come first. */
-const HEAD_BYTES = 4096;
+/** How much of a page's JSON to read at a time. */
+const CHUNK_BYTES = 4096;
+/**
+ * Where the page's own keys end in the JSON output, which writes it
+ * pretty-printed: `availability` comes after `path`, `route`, `title`,
+ * `frontmatter`, and `formatted`, and before the page's blocks.
+ */
+const AFTER_HEAD = Buffer.from('\n  "availability":');
 /**
  * Every page of the build's JSON output (`<output-dir>/<build>/json/`), by
  * normalized route. Empty when there's no JSON output.
@@ -35,20 +41,43 @@ export async function readRoutes(jsonRoot) {
         if (entry.kind !== "page" || typeof entry.path !== "string")
             return;
         const page = await readHead(path.join(jsonRoot, ...entry.path.split("/")));
-        if (page)
-            routes.set(normalizeRoute(page.route), { path: page.path, title: page.title });
+        if (page) {
+            const { route, ...routed } = page;
+            routes.set(normalizeRoute(route), routed);
+        }
     }));
     return routes;
 }
-/** A page's `path`, `route`, and `title`, from the start of its JSON, or the whole of it if need be. */
+/**
+ * A page's `path`, `route`, `title`, and formatted title, from the start of
+ * its JSON up to `availability`, or the whole of it if need be.
+ */
 async function readHead(file) {
-    let head = "";
+    let text;
     try {
         const handle = await open(file, "r");
         try {
-            const buffer = Buffer.alloc(HEAD_BYTES);
-            const { bytesRead } = await handle.read(buffer, 0, HEAD_BYTES, 0);
-            head = buffer.subarray(0, bytesRead).toString("utf8");
+            const chunks = [];
+            let read = 0;
+            let end = -1;
+            for (;;) {
+                const buffer = Buffer.alloc(CHUNK_BYTES);
+                const { bytesRead } = await handle.read(buffer, 0, CHUNK_BYTES, read);
+                if (bytesRead === 0)
+                    break;
+                chunks.push(buffer.subarray(0, bytesRead));
+                read += bytesRead;
+                // The marker may straddle two chunks, so look from just before this one.
+                end = Buffer.concat(chunks).indexOf(AFTER_HEAD, Math.max(0, read - bytesRead - AFTER_HEAD.length));
+                if (end >= 0)
+                    break;
+            }
+            const all = Buffer.concat(chunks);
+            // The keys before `availability`, closed as an object of their own.
+            text =
+                end >= 0
+                    ? `${all.subarray(0, end).toString("utf8").replace(/,\s*$/, "")}}`
+                    : all.toString("utf8");
         }
         finally {
             await handle.close();
@@ -57,36 +86,21 @@ async function readHead(file) {
     catch {
         return undefined;
     }
-    const field = (name) => {
-        const match = new RegExp(`"${name}"\\s*:\\s*("(?:[^"\\\\]|\\\\.)*")`).exec(head);
-        if (!match?.[1])
-            return undefined;
-        try {
-            return JSON.parse(match[1]);
-        }
-        catch {
-            return undefined;
-        }
-    };
-    // The page's own keys come before `frontmatter`, so the first of each is the page's.
-    const pagePath = field("path");
-    const route = field("route");
-    const title = field("title");
-    if (pagePath !== undefined && route !== undefined && title !== undefined) {
-        return { path: pagePath, route, title };
-    }
+    let page;
     try {
-        const page = JSON.parse(await readFile(file, "utf8"));
-        return typeof page.path === "string" && typeof page.route === "string"
-            ? {
-                path: page.path,
-                route: page.route,
-                title: typeof page.title === "string" ? page.title : null,
-            }
-            : undefined;
+        page = JSON.parse(text);
     }
     catch {
         return undefined;
     }
+    if (typeof page.path !== "string" || typeof page.route !== "string")
+        return undefined;
+    const formatted = page.formatted?.title;
+    return {
+        path: page.path,
+        route: page.route,
+        title: typeof page.title === "string" ? page.title : null,
+        formatted_title: Array.isArray(formatted) ? formatted : null,
+    };
 }
 //# sourceMappingURL=routes.js.map

package/dist/review/routes.js.map

@@ -1 +1 @@
-{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../src/review/routes.ts"],"names":[],"mappings":"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","sourcesContent":["// Which page of the build is at a route, and its title: read from the JSON\n// output, which the dev server writes while review is on, since the site\n// output doesn't say.\nimport { open, readFile } from \"node:fs/promises\";\nimport path from \"node:path\";\n\n/** A route as compared: decoded, without a trailing `/` (except the root's). */\nexport function normalizeRoute(route: string): string {\n  let decoded: string;\n  try {\n    decoded = decodeURI(route);\n  } catch {\n    decoded = route;\n  }\n  const trimmed = (decoded.split(/[?#]/)[0] ?? \"\").replace(/\\/+$/, \"\");\n  return trimmed === \"\" ? \"/\" : trimmed;\n}\n\n/** A page of the build, as its JSON output names it. */\nexport interface RoutedPage {\n  /** The content path. */\n  path: string;\n  title: string | null;\n}\n\n/** How much of a page's JSON to read: its `path`, `route`, and `title` come first. */\nconst HEAD_BYTES = 4096;\n\n/**\n * Every page of the build's JSON output (`<output-dir>/<build>/json/`), by\n * normalized route. Empty when there's no JSON output.\n */\nexport async function readRoutes(jsonRoot: string): Promise<Map<string, RoutedPage>> {\n  const routes = new Map<string, RoutedPage>();\n  let files: { path?: unknown; kind?: unknown }[];\n  try {\n    const manifest = JSON.parse(\n      await readFile(path.join(path.dirname(jsonRoot), \"json.manifest.json\"), \"utf8\"),\n    ) as { files?: unknown };\n    files = Array.isArray(manifest.files) ? (manifest.files as typeof files) : [];\n  } catch {\n    return routes;\n  }\n  await Promise.all(\n    files.map(async (entry) => {\n      if (entry.kind !== \"page\" || typeof entry.path !== \"string\") return;\n      const page = await readHead(path.join(jsonRoot, ...entry.path.split(\"/\")));\n      if (page) routes.set(normalizeRoute(page.route), { path: page.path, title: page.title });\n    }),\n  );\n  return routes;\n}\n\n/** A page's `path`, `route`, and `title`, from the start of its JSON, or the whole of it if need be. */\nasync function readHead(\n  file: string,\n): Promise<{ path: string; route: string; title: string | null } | undefined> {\n  let head = \"\";\n  try {\n    const handle = await open(file, \"r\");\n    try {\n      const buffer = Buffer.alloc(HEAD_BYTES);\n      const { bytesRead } = await handle.read(buffer, 0, HEAD_BYTES, 0);\n      head = buffer.subarray(0, bytesRead).toString(\"utf8\");\n    } finally {\n      await handle.close();\n    }\n  } catch {\n    return undefined;\n  }\n  const field = (name: string): string | undefined => {\n    const match = new RegExp(`\"${name}\"\\\\s*:\\\\s*(\"(?:[^\"\\\\\\\\]|\\\\\\\\.)*\")`).exec(head);\n    if (!match?.[1]) return undefined;\n    try {\n      return JSON.parse(match[1]) as string;\n    } catch {\n      return undefined;\n    }\n  };\n  // The page's own keys come before `frontmatter`, so the first of each is the page's.\n  const pagePath = field(\"path\");\n  const route = field(\"route\");\n  const title = field(\"title\");\n  if (pagePath !== undefined && route !== undefined && title !== undefined) {\n    return { path: pagePath, route, title };\n  }\n  try {\n    const page = JSON.parse(await readFile(file, \"utf8\")) as {\n      path?: unknown;\n      route?: unknown;\n      title?: unknown;\n    };\n    return typeof page.path === \"string\" && typeof page.route === \"string\"\n      ? {\n          path: page.path,\n          route: page.route,\n          title: typeof page.title === \"string\" ? page.title : null,\n        }\n      : undefined;\n  } catch {\n    return undefined;\n  }\n}\n"]}
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../src/review/routes.ts"],"names":[],"mappings":"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","sourcesContent":["// Which page of the build is at a route, and its title: read from the JSON\n// output, which the dev server writes while review is on, since the site\n// output doesn't say.\nimport { open, readFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport type { FormattedPiece } from \"@ascribed/review/overlay\";\n\n/** A route as compared: decoded, without a trailing `/` (except the root's). */\nexport function normalizeRoute(route: string): string {\n  let decoded: string;\n  try {\n    decoded = decodeURI(route);\n  } catch {\n    decoded = route;\n  }\n  const trimmed = (decoded.split(/[?#]/)[0] ?? \"\").replace(/\\/+$/, \"\");\n  return trimmed === \"\" ? \"/\" : trimmed;\n}\n\n/** A page of the build, as its JSON output names it. */\nexport interface RoutedPage {\n  /** The content path. */\n  path: string;\n  title: string | null;\n  /** The title formatted, when its field sets `inline = \"code\"`. */\n  formatted_title: FormattedPiece[] | null;\n}\n\n/** How much of a page's JSON to read at a time. */\nconst CHUNK_BYTES = 4096;\n\n/**\n * Where the page's own keys end in the JSON output, which writes it\n * pretty-printed: `availability` comes after `path`, `route`, `title`,\n * `frontmatter`, and `formatted`, and before the page's blocks.\n */\nconst AFTER_HEAD = Buffer.from('\\n  \"availability\":');\n\n/**\n * Every page of the build's JSON output (`<output-dir>/<build>/json/`), by\n * normalized route. Empty when there's no JSON output.\n */\nexport async function readRoutes(jsonRoot: string): Promise<Map<string, RoutedPage>> {\n  const routes = new Map<string, RoutedPage>();\n  let files: { path?: unknown; kind?: unknown }[];\n  try {\n    const manifest = JSON.parse(\n      await readFile(path.join(path.dirname(jsonRoot), \"json.manifest.json\"), \"utf8\"),\n    ) as { files?: unknown };\n    files = Array.isArray(manifest.files) ? (manifest.files as typeof files) : [];\n  } catch {\n    return routes;\n  }\n  await Promise.all(\n    files.map(async (entry) => {\n      if (entry.kind !== \"page\" || typeof entry.path !== \"string\") return;\n      const page = await readHead(path.join(jsonRoot, ...entry.path.split(\"/\")));\n      if (page) {\n        const { route, ...routed } = page;\n        routes.set(normalizeRoute(route), routed);\n      }\n    }),\n  );\n  return routes;\n}\n\n/**\n * A page's `path`, `route`, `title`, and formatted title, from the start of\n * its JSON up to `availability`, or the whole of it if need be.\n */\nasync function readHead(file: string): Promise<(RoutedPage & { route: string }) | undefined> {\n  let text: string;\n  try {\n    const handle = await open(file, \"r\");\n    try {\n      const chunks: Buffer[] = [];\n      let read = 0;\n      let end = -1;\n      for (;;) {\n        const buffer = Buffer.alloc(CHUNK_BYTES);\n        const { bytesRead } = await handle.read(buffer, 0, CHUNK_BYTES, read);\n        if (bytesRead === 0) break;\n        chunks.push(buffer.subarray(0, bytesRead));\n        read += bytesRead;\n        // The marker may straddle two chunks, so look from just before this one.\n        end = Buffer.concat(chunks).indexOf(\n          AFTER_HEAD,\n          Math.max(0, read - bytesRead - AFTER_HEAD.length),\n        );\n        if (end >= 0) break;\n      }\n      const all = Buffer.concat(chunks);\n      // The keys before `availability`, closed as an object of their own.\n      text =\n        end >= 0\n          ? `${all.subarray(0, end).toString(\"utf8\").replace(/,\\s*$/, \"\")}}`\n          : all.toString(\"utf8\");\n    } finally {\n      await handle.close();\n    }\n  } catch {\n    return undefined;\n  }\n  let page: { path?: unknown; route?: unknown; title?: unknown; formatted?: { title?: unknown } };\n  try {\n    page = JSON.parse(text) as typeof page;\n  } catch {\n    return undefined;\n  }\n  if (typeof page.path !== \"string\" || typeof page.route !== \"string\") return undefined;\n  const formatted = page.formatted?.title;\n  return {\n    path: page.path,\n    route: page.route,\n    title: typeof page.title === \"string\" ? page.title : null,\n    formatted_title: Array.isArray(formatted) ? (formatted as FormattedPiece[]) : null,\n  };\n}\n"]}

package/dist/review/server.d.ts

@@ -75,6 +75,8 @@ export declare class ReviewServer {
     private changes;
     private compare;
     private pageView;
+    /** The build's pages by route, read once until the next rebuild. */
+    private readRoutes;
     /** Tells every page the threads or the changes changed; `from` is the page that did it. */
     private changed;
 }

package/dist/review/server.js

@@ -133,8 +133,10 @@ export class ReviewServer {
             page: pagePath === undefined ? undefined : { build: this.options.build, path: pagePath },
             lastPage: pagePath === undefined ? undefined : this.pages.get(pagePath),
             changedPages: async () => {
-                const changes = await this.changes();
-                return "result" in changes ? changes.result.pages : [];
+                const [changes, routes] = await Promise.all([this.changes(), this.readRoutes()]);
+                if (!("result" in changes))
+                    return [];
+                return changes.result.pages.map((p) => listed(p, routes.get(normalizeRoute(p.route))));
             },
         }, method, params);
         if (answer.page)
@@ -245,11 +247,10 @@ export class ReviewServer {
             throw new Error("Review is off.");
         const route = normalizeRoute(typeof params["route"] === "string" ? params["route"] : "/");
         const fromPage = typeof params["path"] === "string" ? params["path"] : null;
-        this.routes ??= this.options.readRoutes().catch(() => new Map());
         const [changes, connection, routes] = await Promise.all([
             this.changes(),
             this.connected(),
-            this.routes,
+            this.readRoutes(),
         ]);
         const pages = "result" in changes ? changes.result.pages : [];
         const shown = pages.filter((p) => p.status !== "removed");
@@ -265,20 +266,26 @@ export class ReviewServer {
             problem: "error" in changes ? changes.error : null,
             errors: "result" in changes ? changes.result.errors : 0,
             threads: threadsState(connection),
-            changedPages: pages.map((p) => listed(p, routes.get(normalizeRoute(p.route))?.title ?? null)),
+            changedPages: pages.map((p) => listed(p, routes.get(normalizeRoute(p.route)))),
             contentRoot: this.options.contentRoot,
             separator: path.sep,
         };
     }
+    /** The build's pages by route, read once until the next rebuild. */
+    readRoutes() {
+        this.routes ??= this.options.readRoutes().catch(() => new Map());
+        return this.routes;
+    }
     /** Tells every page the threads or the changes changed; `from` is the page that did it. */
     changed(from) {
         this.options.channel.send(CHANGED_EVENT, { from });
     }
 }
 /** A changed page as the list shows it: without its changes, with its title. */
-function listed(page, title) {
+function listed(page, routed) {
     return {
-        title,
+        title: routed?.title ?? null,
+        formatted_title: routed?.formatted_title ?? null,
         path: page.path,
         route: page.route,
         status: page.status,

package/dist/review/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/review/server.ts"],"names":[],"mappings":"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","sourcesContent":["// Review in the site preview, on the dev server's side: everything the\n// toolbar app asks for, answered over Astro's dev toolbar channel. Every\n// `git`, `ascribe`, and `gh` call happens here; the page gets the changes and\n// the threads, never a token. There are no HTTP routes: any page open in the\n// same browser could call a route on localhost, while the toolbar's channel\n// takes only clients that have the dev server's token (`channelProblem`).\n//\n// Nothing runs until the reviewer turns the app on. Then the server opens\n// the pull request's review (when the GitHub CLI finds one), compares the\n// build with the pull request's base (or the default branch), and compares\n// again after each rebuild.\nimport path from \"node:path\";\nimport type { OverlayMethod, ReviewSession } from \"@ascribed/review/github\";\nimport type { PageRef } from \"@ascribed/review/place\";\nimport type { DiffResult } from \"./diff.js\";\nimport { messageOf, type Connection } from \"./github.js\";\nimport {\n  CHANGED_EVENT,\n  REQUEST_EVENT,\n  RESULT_EVENT,\n  type ChangedPage,\n  type DiffPage,\n  type PageView,\n  type Request,\n  type Result,\n  type Status,\n  type ThreadsState,\n} from \"./protocol.js\";\nimport { normalizeRoute, type RoutedPage } from \"./routes.js\";\n\n/** A page's end of the channel: the server answers it alone. */\nexport interface ChannelClient {\n  send(event: string, payload?: unknown): void;\n}\n\n/**\n * The toolbar's channel, as `astro:server:setup`'s `toolbar` has it. Its\n * listeners get the sending page's client too (it is Vite's `server.hot`);\n * without one, an answer goes to every page, which tell theirs by `tab`.\n */\nexport interface ToolbarChannel {\n  on(event: string, callback: (data: unknown, client?: ChannelClient) => void): void;\n  send(event: string, payload: unknown): void;\n}\n\nexport interface ReviewServerOptions {\n  channel: ToolbarChannel;\n  logger: { info(message: string): void; warn(message: string): void };\n  build: string;\n  /** The content root, absolute. */\n  contentRoot: string;\n  /** Why someone else could use the channel, if they could: then GitHub stays off. */\n  channelProblem: string | undefined;\n  /** Compares the build with `base` (the default branch when `undefined`). */\n  diff(base: string | undefined): Promise<DiffResult>;\n  /** Opens the pull request's review. */\n  connect(): Promise<Connection>;\n  /** Writes the build's JSON output, in turn with the dev server's builds: it has the routes. */\n  writeRoutes(): Promise<void>;\n  /** Every page of the build, by normalized route. */\n  readRoutes(): Promise<Map<string, RoutedPage>>;\n  /** How long to wait after a rebuild before comparing again. Default 150 ms. */\n  debounceMs?: number;\n}\n\n/** The overlay's requests, which go to the session. */\nconst OVERLAY: ReadonlySet<string> = new Set<OverlayMethod>([\n  \"load\",\n  \"commentTarget\",\n  \"comment\",\n  \"reply\",\n  \"allThreads\",\n  \"resolve\",\n  \"submit\",\n  \"discard\",\n]);\n\nexport class ReviewServer {\n  private on = false;\n  private problem: string | undefined;\n  private connection: Connection | undefined;\n  private connecting: Promise<Connection> | undefined;\n  private diffed: { result: DiffResult } | { error: string } | undefined;\n  private diffing: Promise<void> | undefined;\n  private stale = false;\n  private timer: ReturnType<typeof setTimeout> | undefined;\n  private routes: Promise<Map<string, RoutedPage>> | undefined;\n  /** The page each overlay last read, by content path: comments are made on it. */\n  private readonly pages = new Map<string, PageRef>();\n  /** How long the last comparison took, in milliseconds. */\n  lastDiffMs: number | undefined;\n\n  constructor(private readonly options: ReviewServerOptions) {\n    this.problem = options.channelProblem;\n    options.channel.on(REQUEST_EVENT, (data, client) => {\n      void this.receive(data, client);\n    });\n  }\n\n  /**\n   * The address the dev server listens on, once it does: one other machines\n   * can reach turns comments off, as `server.host` does.\n   */\n  listening(address: string): void {\n    if (this.problem !== undefined || isLoopback(address)) return;\n    this.problem = NETWORK_PROBLEM;\n    this.connection = undefined;\n    this.connecting = undefined;\n  }\n\n  /** Whether review is on: then the dev server's builds write JSON output too. */\n  get active(): boolean {\n    return this.on;\n  }\n\n  /** The dev server rebuilt: compare again soon, and read the routes again when asked. */\n  rebuilt(): void {\n    if (!this.on) return;\n    this.stale = true;\n    this.routes = undefined;\n    if (this.timer) clearTimeout(this.timer);\n    this.timer = setTimeout(() => {\n      this.timer = undefined;\n      void this.changes();\n    }, this.options.debounceMs ?? 150);\n  }\n\n  /** The dev server stopped. */\n  dispose(): void {\n    if (this.timer) clearTimeout(this.timer);\n    this.on = false;\n  }\n\n  private async receive(data: unknown, client: ChannelClient | undefined): Promise<void> {\n    const request = data as Partial<Request> | null;\n    if (typeof request?.id !== \"number\" || typeof request.method !== \"string\") return;\n    const params =\n      typeof request.params === \"object\" && request.params !== null ? request.params : {};\n    const tab = typeof request.tab === \"string\" ? request.tab : \"\";\n    const answer: Result = { tab, id: request.id };\n    try {\n      answer.result = await this.handle(request.method, params, tab);\n    } catch (error) {\n      const code = (error as { code?: unknown }).code;\n      answer.error =\n        typeof code === \"string\"\n          ? { message: messageOf(error), code }\n          : { message: messageOf(error) };\n    }\n    if (typeof client?.send === \"function\") client.send(RESULT_EVENT, answer);\n    else this.options.channel.send(RESULT_EVENT, answer);\n  }\n\n  /** Answers one request. Rejects with a sentence to show. */\n  async handle(method: string, params: Record<string, unknown>, tab = \"\"): Promise<unknown> {\n    switch (method) {\n      case \"status\":\n        return { on: this.on } satisfies Status;\n      case \"start\":\n        await this.start();\n        return { on: true } satisfies Status;\n      case \"stop\":\n        this.stop();\n        this.changed(tab);\n        return { on: false } satisfies Status;\n      case \"page\":\n        return this.pageView(params);\n      case \"refresh\":\n        await this.refresh();\n        this.changed(tab);\n        return null;\n    }\n    if (!OVERLAY.has(method)) throw new Error(`Unknown request: ${method}.`);\n    const connection = this.on ? await this.connected() : undefined;\n    if (connection?.state !== \"on\") throw new Error(\"Review comments aren't on.\");\n    const github = await import(\"@ascribed/review/github\");\n    const pagePath = typeof params[\"path\"] === \"string\" ? params[\"path\"] : undefined;\n    const answer = await github.answerRequest(\n      {\n        session: connection.session,\n        page: pagePath === undefined ? undefined : { build: this.options.build, path: pagePath },\n        lastPage: pagePath === undefined ? undefined : this.pages.get(pagePath),\n        changedPages: async () => {\n          const changes = await this.changes();\n          return \"result\" in changes ? changes.result.pages : [];\n        },\n      },\n      method as OverlayMethod,\n      params,\n    );\n    if (answer.page) this.pages.set(answer.page.path, answer.page);\n    if (answer.changed) this.changed(tab);\n    return answer.result;\n  }\n\n  private async start(): Promise<void> {\n    if (this.on) return;\n    this.on = true;\n    this.stale = true;\n    this.routes = undefined;\n    this.connection = undefined;\n    const started = Date.now();\n    // The routes come from the JSON output, which the next builds write too.\n    const routes = this.options.writeRoutes().catch((error: unknown) => {\n      this.options.logger.warn(`couldn't write the routes for review: ${messageOf(error)}`);\n    });\n    await this.connected();\n    const changes = await this.changes();\n    await routes;\n    if (\"result\" in changes) {\n      const base = changes.result.base;\n      this.options.logger.info(\n        `review: compared \"${this.options.build}\" with ${base.requested} in ${this.lastDiffMs ?? 0} ms (started in ${Date.now() - started} ms)`,\n      );\n    } else {\n      this.options.logger.warn(`review: ${changes.error}`);\n    }\n  }\n\n  private stop(): void {\n    this.on = false;\n    this.connection = undefined;\n    this.connecting = undefined;\n    this.diffed = undefined;\n    this.routes = undefined;\n    this.pages.clear();\n    if (this.timer) clearTimeout(this.timer);\n    this.timer = undefined;\n  }\n\n  private async refresh(): Promise<void> {\n    if (!this.on) return;\n    const connection = await this.connected();\n    if (connection.state === \"on\") await connection.session.refresh();\n    else this.connection = undefined;\n    // A pull request found now changes the base.\n    await this.connected();\n    this.stale = true;\n    await this.changes();\n  }\n\n  /** The pull request's review, opened once while review is on. */\n  private connected(): Promise<Connection> {\n    if (this.connection) return Promise.resolve(this.connection);\n    if (this.problem !== undefined) {\n      this.connection = {\n        state: \"unprotected\",\n        message: `Showing changes only. Comments are off because ${this.problem}.`,\n      };\n      return Promise.resolve(this.connection);\n    }\n    this.connecting ??= this.options\n      .connect()\n      .catch((error: unknown): Connection => ({ state: \"error\", message: messageOf(error) }))\n      .then((connection) => {\n        this.connecting = undefined;\n        // The server turned out to listen on the network meanwhile.\n        if (this.problem !== undefined) return this.connected();\n        if (this.on) this.connection = connection;\n        return connection;\n      });\n    return this.connecting;\n  }\n\n  /** The build's changes, compared again first if a rebuild made them stale. */\n  private async changes(): Promise<{ result: DiffResult } | { error: string }> {\n    while (this.diffing) await this.diffing;\n    if (this.stale || this.diffed === undefined) {\n      this.stale = false;\n      this.diffing = this.compare().finally(() => {\n        this.diffing = undefined;\n      });\n      await this.diffing;\n    }\n    return this.diffed ?? { error: \"Review is off.\" };\n  }\n\n  private async compare(): Promise<void> {\n    const connection = await this.connected();\n    const base = connection.state === \"on\" ? connection.base : undefined;\n    const started = Date.now();\n    try {\n      this.diffed = { result: await this.options.diff(base) };\n    } catch (error) {\n      this.diffed = { error: messageOf(error) };\n    }\n    this.lastDiffMs = Date.now() - started;\n  }\n\n  private async pageView(params: Record<string, unknown>): Promise<PageView> {\n    if (!this.on) throw new Error(\"Review is off.\");\n    const route = normalizeRoute(typeof params[\"route\"] === \"string\" ? params[\"route\"] : \"/\");\n    const fromPage = typeof params[\"path\"] === \"string\" ? params[\"path\"] : null;\n    this.routes ??= this.options.readRoutes().catch(() => new Map<string, RoutedPage>());\n    const [changes, connection, routes] = await Promise.all([\n      this.changes(),\n      this.connected(),\n      this.routes,\n    ]);\n    const pages = \"result\" in changes ? changes.result.pages : [];\n    const shown = pages.filter((p) => p.status !== \"removed\");\n    let page = shown.find((p) => normalizeRoute(p.route) === route) ?? null;\n    const pagePath = page?.path ?? fromPage ?? routes.get(route)?.path ?? null;\n    if (page === null && pagePath !== null) page = shown.find((p) => p.path === pagePath) ?? null;\n    return {\n      kind: pagePath === null ? \"not-page\" : \"page\",\n      path: pagePath,\n      page,\n      base: \"result\" in changes ? changes.result.base : null,\n      problem: \"error\" in changes ? changes.error : null,\n      errors: \"result\" in changes ? changes.result.errors : 0,\n      threads: threadsState(connection),\n      changedPages: pages.map((p) => listed(p, routes.get(normalizeRoute(p.route))?.title ?? null)),\n      contentRoot: this.options.contentRoot,\n      separator: path.sep,\n    };\n  }\n\n  /** Tells every page the threads or the changes changed; `from` is the page that did it. */\n  private changed(from: string): void {\n    this.options.channel.send(CHANGED_EVENT, { from });\n  }\n}\n\n/** A changed page as the list shows it: without its changes, with its title. */\nfunction listed(page: DiffPage, title: string | null): ChangedPage {\n  return {\n    title,\n    path: page.path,\n    route: page.route,\n    status: page.status,\n    own_file_changed: page.own_file_changed,\n    because: page.because,\n    page_changed: page.page_changed,\n    counts: page.counts,\n  };\n}\n\n/** What the page shows about the threads. */\nfunction threadsState(connection: Connection): ThreadsState {\n  if (connection.state !== \"on\") return connection;\n  const pr: ReviewSession[\"pullRequest\"] = connection.session.pullRequest;\n  return {\n    state: \"on\",\n    pullRequest: { number: pr.number, url: pr.url, baseRefName: pr.baseRefName },\n    local: connection.local,\n  };\n}\n\n/**\n * Why someone other than the developer could use the dev server's toolbar\n * channel, or `undefined` when they can't. Vite takes a browser's connection\n * only with the token in its client script, which the page's own origin can\n * read and, by default, only localhost origins can fetch. These settings undo\n * that, and a server listening on the network gives its pages, token and all,\n * to anyone who can reach it.\n */\nexport function channelProblem(config: {\n  server: { cors?: unknown; allowedHosts?: unknown; host?: unknown };\n  legacy?: { skipWebSocketTokenCheck?: unknown } | undefined;\n}): string | undefined {\n  const pages = \"other web pages could talk to this dev server\";\n  if (config.legacy?.skipWebSocketTokenCheck === true) {\n    return `${pages}: \\`legacy.skipWebSocketTokenCheck\\` is on`;\n  }\n  if (config.server.allowedHosts === true) return `${pages}: \\`server.allowedHosts\\` is \\`true\\``;\n  const cors = config.server.cors;\n  const origin =\n    typeof cors === \"object\" && cors !== null ? (cors as { origin?: unknown }).origin : undefined;\n  if (cors === true || origin === true || origin === \"*\") {\n    return `${pages}: \\`server.cors\\` lets any origin read its pages`;\n  }\n  if (!isLoopback(config.server.host)) return NETWORK_PROBLEM;\n  return undefined;\n}\n\nconst NETWORK_PROBLEM =\n  \"the dev server is listening on the network (`--host`), so anyone who can reach it could comment as you\";\n\n/** Whether Vite's `server.host`, or the address the server listens on, keeps the server on this machine: unset, `false`, or a loopback name. */\nfunction isLoopback(host: unknown): boolean {\n  if (host === undefined || host === false) return true;\n  if (typeof host !== \"string\") return false;\n  const name = host.toLowerCase().replace(/^\\[(.*)\\]$/, \"$1\");\n  return name === \"localhost\" || name === \"::1\" || /^127(\\.\\d{1,3}){3}$/.test(name);\n}\n"]}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/review/server.ts"],"names":[],"mappings":"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","sourcesContent":["// Review in the site preview, on the dev server's side: everything the\n// toolbar app asks for, answered over Astro's dev toolbar channel. Every\n// `git`, `ascribe`, and `gh` call happens here; the page gets the changes and\n// the threads, never a token. There are no HTTP routes: any page open in the\n// same browser could call a route on localhost, while the toolbar's channel\n// takes only clients that have the dev server's token (`channelProblem`).\n//\n// Nothing runs until the reviewer turns the app on. Then the server opens\n// the pull request's review (when the GitHub CLI finds one), compares the\n// build with the pull request's base (or the default branch), and compares\n// again after each rebuild.\nimport path from \"node:path\";\nimport type { OverlayMethod, ReviewSession } from \"@ascribed/review/github\";\nimport type { PageRef } from \"@ascribed/review/place\";\nimport type { DiffResult } from \"./diff.js\";\nimport { messageOf, type Connection } from \"./github.js\";\nimport {\n  CHANGED_EVENT,\n  REQUEST_EVENT,\n  RESULT_EVENT,\n  type ChangedPage,\n  type PageDiff,\n  type PageView,\n  type Request,\n  type Result,\n  type Status,\n  type ThreadsState,\n} from \"./protocol.js\";\nimport { normalizeRoute, type RoutedPage } from \"./routes.js\";\n\n/** A page's end of the channel: the server answers it alone. */\nexport interface ChannelClient {\n  send(event: string, payload?: unknown): void;\n}\n\n/**\n * The toolbar's channel, as `astro:server:setup`'s `toolbar` has it. Its\n * listeners get the sending page's client too (it is Vite's `server.hot`);\n * without one, an answer goes to every page, which tell theirs by `tab`.\n */\nexport interface ToolbarChannel {\n  on(event: string, callback: (data: unknown, client?: ChannelClient) => void): void;\n  send(event: string, payload: unknown): void;\n}\n\nexport interface ReviewServerOptions {\n  channel: ToolbarChannel;\n  logger: { info(message: string): void; warn(message: string): void };\n  build: string;\n  /** The content root, absolute. */\n  contentRoot: string;\n  /** Why someone else could use the channel, if they could: then GitHub stays off. */\n  channelProblem: string | undefined;\n  /** Compares the build with `base` (the default branch when `undefined`). */\n  diff(base: string | undefined): Promise<DiffResult>;\n  /** Opens the pull request's review. */\n  connect(): Promise<Connection>;\n  /** Writes the build's JSON output, in turn with the dev server's builds: it has the routes. */\n  writeRoutes(): Promise<void>;\n  /** Every page of the build, by normalized route. */\n  readRoutes(): Promise<Map<string, RoutedPage>>;\n  /** How long to wait after a rebuild before comparing again. Default 150 ms. */\n  debounceMs?: number;\n}\n\n/** The overlay's requests, which go to the session. */\nconst OVERLAY: ReadonlySet<string> = new Set<OverlayMethod>([\n  \"load\",\n  \"commentTarget\",\n  \"comment\",\n  \"reply\",\n  \"allThreads\",\n  \"resolve\",\n  \"submit\",\n  \"discard\",\n]);\n\nexport class ReviewServer {\n  private on = false;\n  private problem: string | undefined;\n  private connection: Connection | undefined;\n  private connecting: Promise<Connection> | undefined;\n  private diffed: { result: DiffResult } | { error: string } | undefined;\n  private diffing: Promise<void> | undefined;\n  private stale = false;\n  private timer: ReturnType<typeof setTimeout> | undefined;\n  private routes: Promise<Map<string, RoutedPage>> | undefined;\n  /** The page each overlay last read, by content path: comments are made on it. */\n  private readonly pages = new Map<string, PageRef>();\n  /** How long the last comparison took, in milliseconds. */\n  lastDiffMs: number | undefined;\n\n  constructor(private readonly options: ReviewServerOptions) {\n    this.problem = options.channelProblem;\n    options.channel.on(REQUEST_EVENT, (data, client) => {\n      void this.receive(data, client);\n    });\n  }\n\n  /**\n   * The address the dev server listens on, once it does: one other machines\n   * can reach turns comments off, as `server.host` does.\n   */\n  listening(address: string): void {\n    if (this.problem !== undefined || isLoopback(address)) return;\n    this.problem = NETWORK_PROBLEM;\n    this.connection = undefined;\n    this.connecting = undefined;\n  }\n\n  /** Whether review is on: then the dev server's builds write JSON output too. */\n  get active(): boolean {\n    return this.on;\n  }\n\n  /** The dev server rebuilt: compare again soon, and read the routes again when asked. */\n  rebuilt(): void {\n    if (!this.on) return;\n    this.stale = true;\n    this.routes = undefined;\n    if (this.timer) clearTimeout(this.timer);\n    this.timer = setTimeout(() => {\n      this.timer = undefined;\n      void this.changes();\n    }, this.options.debounceMs ?? 150);\n  }\n\n  /** The dev server stopped. */\n  dispose(): void {\n    if (this.timer) clearTimeout(this.timer);\n    this.on = false;\n  }\n\n  private async receive(data: unknown, client: ChannelClient | undefined): Promise<void> {\n    const request = data as Partial<Request> | null;\n    if (typeof request?.id !== \"number\" || typeof request.method !== \"string\") return;\n    const params =\n      typeof request.params === \"object\" && request.params !== null ? request.params : {};\n    const tab = typeof request.tab === \"string\" ? request.tab : \"\";\n    const answer: Result = { tab, id: request.id };\n    try {\n      answer.result = await this.handle(request.method, params, tab);\n    } catch (error) {\n      const code = (error as { code?: unknown }).code;\n      answer.error =\n        typeof code === \"string\"\n          ? { message: messageOf(error), code }\n          : { message: messageOf(error) };\n    }\n    if (typeof client?.send === \"function\") client.send(RESULT_EVENT, answer);\n    else this.options.channel.send(RESULT_EVENT, answer);\n  }\n\n  /** Answers one request. Rejects with a sentence to show. */\n  async handle(method: string, params: Record<string, unknown>, tab = \"\"): Promise<unknown> {\n    switch (method) {\n      case \"status\":\n        return { on: this.on } satisfies Status;\n      case \"start\":\n        await this.start();\n        return { on: true } satisfies Status;\n      case \"stop\":\n        this.stop();\n        this.changed(tab);\n        return { on: false } satisfies Status;\n      case \"page\":\n        return this.pageView(params);\n      case \"refresh\":\n        await this.refresh();\n        this.changed(tab);\n        return null;\n    }\n    if (!OVERLAY.has(method)) throw new Error(`Unknown request: ${method}.`);\n    const connection = this.on ? await this.connected() : undefined;\n    if (connection?.state !== \"on\") throw new Error(\"Review comments aren't on.\");\n    const github = await import(\"@ascribed/review/github\");\n    const pagePath = typeof params[\"path\"] === \"string\" ? params[\"path\"] : undefined;\n    const answer = await github.answerRequest(\n      {\n        session: connection.session,\n        page: pagePath === undefined ? undefined : { build: this.options.build, path: pagePath },\n        lastPage: pagePath === undefined ? undefined : this.pages.get(pagePath),\n        changedPages: async () => {\n          const [changes, routes] = await Promise.all([this.changes(), this.readRoutes()]);\n          if (!(\"result\" in changes)) return [];\n          return changes.result.pages.map((p) => listed(p, routes.get(normalizeRoute(p.route))));\n        },\n      },\n      method as OverlayMethod,\n      params,\n    );\n    if (answer.page) this.pages.set(answer.page.path, answer.page);\n    if (answer.changed) this.changed(tab);\n    return answer.result;\n  }\n\n  private async start(): Promise<void> {\n    if (this.on) return;\n    this.on = true;\n    this.stale = true;\n    this.routes = undefined;\n    this.connection = undefined;\n    const started = Date.now();\n    // The routes come from the JSON output, which the next builds write too.\n    const routes = this.options.writeRoutes().catch((error: unknown) => {\n      this.options.logger.warn(`couldn't write the routes for review: ${messageOf(error)}`);\n    });\n    await this.connected();\n    const changes = await this.changes();\n    await routes;\n    if (\"result\" in changes) {\n      const base = changes.result.base;\n      this.options.logger.info(\n        `review: compared \"${this.options.build}\" with ${base.requested} in ${this.lastDiffMs ?? 0} ms (started in ${Date.now() - started} ms)`,\n      );\n    } else {\n      this.options.logger.warn(`review: ${changes.error}`);\n    }\n  }\n\n  private stop(): void {\n    this.on = false;\n    this.connection = undefined;\n    this.connecting = undefined;\n    this.diffed = undefined;\n    this.routes = undefined;\n    this.pages.clear();\n    if (this.timer) clearTimeout(this.timer);\n    this.timer = undefined;\n  }\n\n  private async refresh(): Promise<void> {\n    if (!this.on) return;\n    const connection = await this.connected();\n    if (connection.state === \"on\") await connection.session.refresh();\n    else this.connection = undefined;\n    // A pull request found now changes the base.\n    await this.connected();\n    this.stale = true;\n    await this.changes();\n  }\n\n  /** The pull request's review, opened once while review is on. */\n  private connected(): Promise<Connection> {\n    if (this.connection) return Promise.resolve(this.connection);\n    if (this.problem !== undefined) {\n      this.connection = {\n        state: \"unprotected\",\n        message: `Showing changes only. Comments are off because ${this.problem}.`,\n      };\n      return Promise.resolve(this.connection);\n    }\n    this.connecting ??= this.options\n      .connect()\n      .catch((error: unknown): Connection => ({ state: \"error\", message: messageOf(error) }))\n      .then((connection) => {\n        this.connecting = undefined;\n        // The server turned out to listen on the network meanwhile.\n        if (this.problem !== undefined) return this.connected();\n        if (this.on) this.connection = connection;\n        return connection;\n      });\n    return this.connecting;\n  }\n\n  /** The build's changes, compared again first if a rebuild made them stale. */\n  private async changes(): Promise<{ result: DiffResult } | { error: string }> {\n    while (this.diffing) await this.diffing;\n    if (this.stale || this.diffed === undefined) {\n      this.stale = false;\n      this.diffing = this.compare().finally(() => {\n        this.diffing = undefined;\n      });\n      await this.diffing;\n    }\n    return this.diffed ?? { error: \"Review is off.\" };\n  }\n\n  private async compare(): Promise<void> {\n    const connection = await this.connected();\n    const base = connection.state === \"on\" ? connection.base : undefined;\n    const started = Date.now();\n    try {\n      this.diffed = { result: await this.options.diff(base) };\n    } catch (error) {\n      this.diffed = { error: messageOf(error) };\n    }\n    this.lastDiffMs = Date.now() - started;\n  }\n\n  private async pageView(params: Record<string, unknown>): Promise<PageView> {\n    if (!this.on) throw new Error(\"Review is off.\");\n    const route = normalizeRoute(typeof params[\"route\"] === \"string\" ? params[\"route\"] : \"/\");\n    const fromPage = typeof params[\"path\"] === \"string\" ? params[\"path\"] : null;\n    const [changes, connection, routes] = await Promise.all([\n      this.changes(),\n      this.connected(),\n      this.readRoutes(),\n    ]);\n    const pages = \"result\" in changes ? changes.result.pages : [];\n    const shown = pages.filter((p) => p.status !== \"removed\");\n    let page = shown.find((p) => normalizeRoute(p.route) === route) ?? null;\n    const pagePath = page?.path ?? fromPage ?? routes.get(route)?.path ?? null;\n    if (page === null && pagePath !== null) page = shown.find((p) => p.path === pagePath) ?? null;\n    return {\n      kind: pagePath === null ? \"not-page\" : \"page\",\n      path: pagePath,\n      page,\n      base: \"result\" in changes ? changes.result.base : null,\n      problem: \"error\" in changes ? changes.error : null,\n      errors: \"result\" in changes ? changes.result.errors : 0,\n      threads: threadsState(connection),\n      changedPages: pages.map((p) => listed(p, routes.get(normalizeRoute(p.route)))),\n      contentRoot: this.options.contentRoot,\n      separator: path.sep,\n    };\n  }\n\n  /** The build's pages by route, read once until the next rebuild. */\n  private readRoutes(): Promise<Map<string, RoutedPage>> {\n    this.routes ??= this.options.readRoutes().catch(() => new Map<string, RoutedPage>());\n    return this.routes;\n  }\n\n  /** Tells every page the threads or the changes changed; `from` is the page that did it. */\n  private changed(from: string): void {\n    this.options.channel.send(CHANGED_EVENT, { from });\n  }\n}\n\n/** A changed page as the list shows it: without its changes, with its title. */\nfunction listed(page: PageDiff, routed: RoutedPage | undefined): ChangedPage {\n  return {\n    title: routed?.title ?? null,\n    formatted_title: routed?.formatted_title ?? null,\n    path: page.path,\n    route: page.route,\n    status: page.status,\n    own_file_changed: page.own_file_changed,\n    because: page.because,\n    page_changed: page.page_changed,\n    counts: page.counts,\n  };\n}\n\n/** What the page shows about the threads. */\nfunction threadsState(connection: Connection): ThreadsState {\n  if (connection.state !== \"on\") return connection;\n  const pr: ReviewSession[\"pullRequest\"] = connection.session.pullRequest;\n  return {\n    state: \"on\",\n    pullRequest: { number: pr.number, url: pr.url, baseRefName: pr.baseRefName },\n    local: connection.local,\n  };\n}\n\n/**\n * Why someone other than the developer could use the dev server's toolbar\n * channel, or `undefined` when they can't. Vite takes a browser's connection\n * only with the token in its client script, which the page's own origin can\n * read and, by default, only localhost origins can fetch. These settings undo\n * that, and a server listening on the network gives its pages, token and all,\n * to anyone who can reach it.\n */\nexport function channelProblem(config: {\n  server: { cors?: unknown; allowedHosts?: unknown; host?: unknown };\n  legacy?: { skipWebSocketTokenCheck?: unknown } | undefined;\n}): string | undefined {\n  const pages = \"other web pages could talk to this dev server\";\n  if (config.legacy?.skipWebSocketTokenCheck === true) {\n    return `${pages}: \\`legacy.skipWebSocketTokenCheck\\` is on`;\n  }\n  if (config.server.allowedHosts === true) return `${pages}: \\`server.allowedHosts\\` is \\`true\\``;\n  const cors = config.server.cors;\n  const origin =\n    typeof cors === \"object\" && cors !== null ? (cors as { origin?: unknown }).origin : undefined;\n  if (cors === true || origin === true || origin === \"*\") {\n    return `${pages}: \\`server.cors\\` lets any origin read its pages`;\n  }\n  if (!isLoopback(config.server.host)) return NETWORK_PROBLEM;\n  return undefined;\n}\n\nconst NETWORK_PROBLEM =\n  \"the dev server is listening on the network (`--host`), so anyone who can reach it could comment as you\";\n\n/** Whether Vite's `server.host`, or the address the server listens on, keeps the server on this machine: unset, `false`, or a loopback name. */\nfunction isLoopback(host: unknown): boolean {\n  if (host === undefined || host === false) return true;\n  if (typeof host !== \"string\") return false;\n  const name = host.toLowerCase().replace(/^\\[(.*)\\]$/, \"$1\");\n  return name === \"localhost\" || name === \"::1\" || /^127(\\.\\d{1,3}){3}$/.test(name);\n}\n"]}

package/dist/satteri.js

@@ -11,6 +11,8 @@ import { findAnchors, findEdits, toProperty } from "./attributes.js";
 /** Applies the site output's attribute markers (`ascribe-attributes`) and source anchors. */
 export function satteriAscribeAttributes() {
     return {
+        // The plugin's own name, shown in Astro's errors; it's spelled like the
+        // marker (ELEMENT_ATTRIBUTES) but isn't it, so it stays a literal.
         name: "ascribe-attributes",
         before(root, ctx) {
             for (const edit of findEdits(root)) {

package/dist/satteri.js.map

@@ -1 +1 @@
-{"version":3,"file":"satteri.js","sourceRoot":"","sources":["../src/satteri.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,kEAAkE;AAClE,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,2EAA2E;AAC3E,2EAA2E;AAC3E,8EAA8E;AAC9E,+CAA+C;AAG/C,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAiB,MAAM,iBAAiB,CAAC;AAEpF,6FAA6F;AAC7F,MAAM,UAAU,wBAAwB;IACtC,OAAO;QACL,IAAI,EAAE,oBAAoB;QAC1B,MAAM,CAAC,IAAI,EAAE,GAAG;YACd,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,IAAgB,CAAC,EAAE,CAAC;gBAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAgC,CAAC;gBACrD,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;oBACxC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;oBAC5C,GAAG,CAAC,WAAW,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;gBACvC,CAAC;gBACD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,MAAM;oBAAE,GAAG,CAAC,UAAU,CAAC,IAA8B,CAAC,CAAC;gBAC/E,KAAK,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;oBACxC,IAAI,KAAK,KAAK,EAAE;wBAAE,GAAG,CAAC,UAAU,CAAC,IAA8B,CAAC,CAAC;;wBAC5D,GAAG,CAAC,WAAW,CAAC,IAA8B,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;gBAChF,CAAC;YACH,CAAC;YACD,KAAK,MAAM,MAAM,IAAI,WAAW,CAAC,IAAgB,CAAC,EAAE,CAAC;gBACnD,KAAK,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;oBAClD,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;wBACnC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;wBAC5C,GAAG,CAAC,WAAW,CAAC,IAA8B,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;oBAC/D,CAAC;gBACH,CAAC;gBACD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;oBACnB,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,IAA8B,EAAE;wBAC7D,IAAI,EAAE,KAAK;wBACX,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK;qBAC5B,CAAC,CAAC;gBACL,CAAC;gBACD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM;oBAAE,GAAG,CAAC,UAAU,CAAC,IAA8B,CAAC,CAAC;YACnF,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["// The attribute marker and source anchors as a Sätteri hast plugin, for Astro\n// 7.3's default markdown processor (`@astrojs/markdown-satteri`).\n//\n// Astro runs that processor's hast plugins in this order: highlighting, the\n// user's plugins, its image marker (which reads an `<img>`'s properties), and\n// its heading ids (which keeps an id a heading already has). A user plugin\n// therefore runs before both, and sees a marker as two `raw` nodes, as the\n// unified processor's plugin does, and an anchor comment as a `raw` node. The\n// rules are `findEdits`'s and `findAnchors`'s.\n\nimport type { HastNode as SatteriNode, HastVisitorInstance } from \"satteri\";\nimport { findAnchors, findEdits, toProperty, type HastNode } from \"./attributes.js\";\n\n/** Applies the site output's attribute markers (`ascribe-attributes`) and source anchors. */\nexport function satteriAscribeAttributes(): HastVisitorInstance & { name: string } {\n  return {\n    name: \"ascribe-attributes\",\n    before(root, ctx) {\n      for (const edit of findEdits(root as HastNode)) {\n        const target = edit.target as unknown as SatteriNode;\n        for (const attribute of edit.attributes) {\n          const [name, value] = toProperty(attribute);\n          ctx.setProperty(target, name, value);\n        }\n        for (const node of edit.remove) ctx.removeNode(node as unknown as SatteriNode);\n        for (const { node, value } of edit.trim) {\n          if (value === \"\") ctx.removeNode(node as unknown as SatteriNode);\n          else ctx.replaceNode(node as unknown as SatteriNode, { type: \"text\", value });\n        }\n      }\n      for (const anchor of findAnchors(root as HastNode)) {\n        for (const { node, attributes } of anchor.targets) {\n          for (const attribute of attributes) {\n            const [name, value] = toProperty(attribute);\n            ctx.setProperty(node as unknown as SatteriNode, name, value);\n          }\n        }\n        if (anchor.replace) {\n          ctx.replaceNode(anchor.replace.node as unknown as SatteriNode, {\n            type: \"raw\",\n            value: anchor.replace.value,\n          });\n        }\n        for (const node of anchor.remove) ctx.removeNode(node as unknown as SatteriNode);\n      }\n    },\n  };\n}\n"]}
+{"version":3,"file":"satteri.js","sourceRoot":"","sources":["../src/satteri.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,kEAAkE;AAClE,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,2EAA2E;AAC3E,2EAA2E;AAC3E,8EAA8E;AAC9E,+CAA+C;AAG/C,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAiB,MAAM,iBAAiB,CAAC;AAEpF,6FAA6F;AAC7F,MAAM,UAAU,wBAAwB;IACtC,OAAO;QACL,wEAAwE;QACxE,mEAAmE;QACnE,IAAI,EAAE,oBAAoB;QAC1B,MAAM,CAAC,IAAI,EAAE,GAAG;YACd,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,IAAgB,CAAC,EAAE,CAAC;gBAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAgC,CAAC;gBACrD,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;oBACxC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;oBAC5C,GAAG,CAAC,WAAW,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;gBACvC,CAAC;gBACD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,MAAM;oBAAE,GAAG,CAAC,UAAU,CAAC,IAA8B,CAAC,CAAC;gBAC/E,KAAK,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;oBACxC,IAAI,KAAK,KAAK,EAAE;wBAAE,GAAG,CAAC,UAAU,CAAC,IAA8B,CAAC,CAAC;;wBAC5D,GAAG,CAAC,WAAW,CAAC,IAA8B,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;gBAChF,CAAC;YACH,CAAC;YACD,KAAK,MAAM,MAAM,IAAI,WAAW,CAAC,IAAgB,CAAC,EAAE,CAAC;gBACnD,KAAK,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;oBAClD,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;wBACnC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;wBAC5C,GAAG,CAAC,WAAW,CAAC,IAA8B,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;oBAC/D,CAAC;gBACH,CAAC;gBACD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;oBACnB,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,IAA8B,EAAE;wBAC7D,IAAI,EAAE,KAAK;wBACX,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK;qBAC5B,CAAC,CAAC;gBACL,CAAC;gBACD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM;oBAAE,GAAG,CAAC,UAAU,CAAC,IAA8B,CAAC,CAAC;YACnF,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["// The attribute marker and source anchors as a Sätteri hast plugin, for Astro\n// 7.3's default markdown processor (`@astrojs/markdown-satteri`).\n//\n// Astro runs that processor's hast plugins in this order: highlighting, the\n// user's plugins, its image marker (which reads an `<img>`'s properties), and\n// its heading ids (which keeps an id a heading already has). A user plugin\n// therefore runs before both, and sees a marker as two `raw` nodes, as the\n// unified processor's plugin does, and an anchor comment as a `raw` node. The\n// rules are `findEdits`'s and `findAnchors`'s.\n\nimport type { HastNode as SatteriNode, HastVisitorInstance } from \"satteri\";\nimport { findAnchors, findEdits, toProperty, type HastNode } from \"./attributes.js\";\n\n/** Applies the site output's attribute markers (`ascribe-attributes`) and source anchors. */\nexport function satteriAscribeAttributes(): HastVisitorInstance & { name: string } {\n  return {\n    // The plugin's own name, shown in Astro's errors; it's spelled like the\n    // marker (ELEMENT_ATTRIBUTES) but isn't it, so it stays a literal.\n    name: \"ascribe-attributes\",\n    before(root, ctx) {\n      for (const edit of findEdits(root as HastNode)) {\n        const target = edit.target as unknown as SatteriNode;\n        for (const attribute of edit.attributes) {\n          const [name, value] = toProperty(attribute);\n          ctx.setProperty(target, name, value);\n        }\n        for (const node of edit.remove) ctx.removeNode(node as unknown as SatteriNode);\n        for (const { node, value } of edit.trim) {\n          if (value === \"\") ctx.removeNode(node as unknown as SatteriNode);\n          else ctx.replaceNode(node as unknown as SatteriNode, { type: \"text\", value });\n        }\n      }\n      for (const anchor of findAnchors(root as HastNode)) {\n        for (const { node, attributes } of anchor.targets) {\n          for (const attribute of attributes) {\n            const [name, value] = toProperty(attribute);\n            ctx.setProperty(node as unknown as SatteriNode, name, value);\n          }\n        }\n        if (anchor.replace) {\n          ctx.replaceNode(anchor.replace.node as unknown as SatteriNode, {\n            type: \"raw\",\n            value: anchor.replace.value,\n          });\n        }\n        for (const node of anchor.remove) ctx.removeNode(node as unknown as SatteriNode);\n      }\n    },\n  };\n}\n"]}

package/dist/shapes.d.ts

@@ -0,0 +1,158 @@
+/**
+ * Where a block's text is written: the README's anchor grammar, the same
+ * string the rendered page carries in `data-ascribe-source` and
+ * `data-ascribe-via`.
+ */
+export interface Anchor {
+    /**
+     * `<path>:<first>-<last>`: the file's content path, percent-encoded by
+     * segment, and the block's first and last lines, from 1.
+     */
+    source: string;
+    /**
+     * The includes the block came through, outermost first, each
+     * `<path>:<line>`. Empty for a block written in the page itself.
+     */
+    via: string[];
+}
+/** The base of a comparison, in the report. */
+export interface BaseInfo {
+    /** The revision asked for, or the default branch used. */
+    requested: string;
+    /** The commit it names. */
+    commit: string;
+    /**
+     * The merge base of that commit and `HEAD`, which the comparison reads;
+     * `null` with `--base-exact`, which reads `commit`.
+     */
+    merge_base: string | null;
+}
+/** What changed in one build. */
+export interface BuildDiff {
+    /** The build's name. */
+    build: string;
+    /** The pages that changed, in path order. */
+    pages: PageDiff[];
+}
+/** One block's change. */
+export interface Change {
+    /** What happened to it. */
+    kind: ChangeKind;
+    /**
+     * For a removed block, and a moved block's old place: the block of the
+     * new version it came after, among its siblings. Absent when it was
+     * first.
+     */
+    after?: Anchor;
+    /** Where it's written now: every kind but `removed`. */
+    now?: Anchor;
+    /**
+     * For a removed block, and a moved block's old place: the block of the
+     * new version it was inside. Absent at the top of the page.
+     */
+    parent?: Anchor;
+    /**
+     * For a removed block, its text, whitespace collapsed, so it can be
+     * shown where it was.
+     */
+    text?: string;
+    /** Where it was written: every kind but `added`. */
+    was?: Anchor;
+    /** For changed prose, the words that differ. */
+    words?: Words;
+}
+/** The kinds of block change. */
+export type ChangeKind = "changed" | "added" | "removed" | "moved";
+/** How many changes of each kind a page has. */
+export interface Counts {
+    /** Blocks whose content changed. */
+    changed: number;
+    /** Blocks only in the new version. */
+    added: number;
+    /** Blocks only in the old version. */
+    removed: number;
+    /** Blocks in both, somewhere else. */
+    moved: number;
+}
+/** The whole report, as `ascribe diff --format json` writes it. */
+export interface DiffReport {
+    /** `SCHEMA_VERSION`. */
+    schema_version: number;
+    /** The version of Ascribe that wrote it. */
+    ascribe_version: string;
+    /** What was compared with. */
+    base: BaseInfo;
+    /** Where the project is. */
+    repository: RepositoryInfo;
+    /**
+     * How many errors `ascribe check` finds in the working tree, for the
+     * builds compared. The comparison runs regardless, but a page with an
+     * error may not render as it will once it's fixed, so a reviewer should
+     * know. `diff_project` sets it; `Report::new` leaves it zero.
+     */
+    working_tree_errors: number;
+    /** What changed, per build, in the order asked for. */
+    builds: BuildDiff[];
+}
+/** What changed on one page of a build. */
+export interface PageDiff {
+    /** The page's content path. */
+    path: string;
+    /** Its route: the new one, or for a removed page the old one. */
+    route: string;
+    /**
+     * Whether the build publishes it only now, only before, or in both
+     * with a difference.
+     */
+    status: PageStatus;
+    /** Whether the page's own file changed (or exists on one side only). */
+    own_file_changed: boolean;
+    /**
+     * The other changed files the page's change can come from: fragments it
+     * includes and pages its links take a title or a heading from, in path
+     * order; then the snippets whose code changed, by address
+     * (`code:app.py#main`); and `ascribe.toml` (last) when the content model
+     * is a cause.
+     */
+    because: string[];
+    /**
+     * What changed about the page itself besides its blocks, in this
+     * order: `title`, `frontmatter`, `availability` (the page-level one),
+     * and `route`. Empty for an added or removed page.
+     */
+    page_changed: string[];
+    /** How many changes of each kind. */
+    counts: Counts;
+    /**
+     * The block-level changes, in the page's order, a removed block where
+     * it was. Empty for an added or removed page.
+     */
+    changes: Change[];
+}
+/** Whether a page is new, gone, or different. */
+export type PageStatus = "added" | "removed" | "changed";
+/** The repository, in the report. */
+export interface RepositoryInfo {
+    /** The repository's top-level directory, as git prints it. */
+    root: string;
+    /**
+     * The project's folder inside it, with a trailing `/`, or empty when
+     * the project is at the repository's root.
+     */
+    project_prefix: string;
+}
+/**
+ * The words that differ inside a changed block of prose. Ranges are
+ * `[start, end)` in characters (Unicode scalar values) of each side's
+ * `text`, which is the block's text with whitespace collapsed.
+ */
+export interface Words {
+    /** Ranges in `now_text`: words added or replacing others. */
+    now: [number, number][];
+    /** Ranges in `was_text`: words removed or replaced. */
+    was: [number, number][];
+    /** The block's text now. */
+    now_text: string;
+    /** The block's text before. */
+    was_text: string;
+}

package/dist/shapes.js

@@ -0,0 +1,8 @@
+// The JSON Ascribe writes that this package reads, as TypeScript types.
+// Generated from the Rust types that write it, through the JSON Schemas in
+// schemas/, by crates/ascribe-cli/src/shapes.rs. Change the Rust types, then
+// run `ASCRIBE_BLESS=1 cargo test -p ascribe-cli shapes`. Don't edit it.
+//
+// - DiffReport (`ascribe diff --format json`)
+export {};
+//# sourceMappingURL=shapes.js.map

package/dist/shapes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shapes.js","sourceRoot":"","sources":["../src/shapes.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,2EAA2E;AAC3E,6EAA6E;AAC7E,yEAAyE;AACzE,EAAE;AACF,8CAA8C","sourcesContent":["// The JSON Ascribe writes that this package reads, as TypeScript types.\n// Generated from the Rust types that write it, through the JSON Schemas in\n// schemas/, by crates/ascribe-cli/src/shapes.rs. Change the Rust types, then\n// run `ASCRIBE_BLESS=1 cargo test -p ascribe-cli shapes`. Don't edit it.\n//\n// - DiffReport (`ascribe diff --format json`)\n\n/**\n * Where a block's text is written: the README's anchor grammar, the same\n * string the rendered page carries in `data-ascribe-source` and\n * `data-ascribe-via`.\n */\nexport interface Anchor {\n  /**\n   * `<path>:<first>-<last>`: the file's content path, percent-encoded by\n   * segment, and the block's first and last lines, from 1.\n   */\n  source: string;\n  /**\n   * The includes the block came through, outermost first, each\n   * `<path>:<line>`. Empty for a block written in the page itself.\n   */\n  via: string[];\n}\n\n/** The base of a comparison, in the report. */\nexport interface BaseInfo {\n  /** The revision asked for, or the default branch used. */\n  requested: string;\n  /** The commit it names. */\n  commit: string;\n  /**\n   * The merge base of that commit and `HEAD`, which the comparison reads;\n   * `null` with `--base-exact`, which reads `commit`.\n   */\n  merge_base: string | null;\n}\n\n/** What changed in one build. */\nexport interface BuildDiff {\n  /** The build's name. */\n  build: string;\n  /** The pages that changed, in path order. */\n  pages: PageDiff[];\n}\n\n/** One block's change. */\nexport interface Change {\n  /** What happened to it. */\n  kind: ChangeKind;\n  /**\n   * For a removed block, and a moved block's old place: the block of the\n   * new version it came after, among its siblings. Absent when it was\n   * first.\n   */\n  after?: Anchor;\n  /** Where it's written now: every kind but `removed`. */\n  now?: Anchor;\n  /**\n   * For a removed block, and a moved block's old place: the block of the\n   * new version it was inside. Absent at the top of the page.\n   */\n  parent?: Anchor;\n  /**\n   * For a removed block, its text, whitespace collapsed, so it can be\n   * shown where it was.\n   */\n  text?: string;\n  /** Where it was written: every kind but `added`. */\n  was?: Anchor;\n  /** For changed prose, the words that differ. */\n  words?: Words;\n}\n\n/** The kinds of block change. */\nexport type ChangeKind = \"changed\" | \"added\" | \"removed\" | \"moved\";\n\n/** How many changes of each kind a page has. */\nexport interface Counts {\n  /** Blocks whose content changed. */\n  changed: number;\n  /** Blocks only in the new version. */\n  added: number;\n  /** Blocks only in the old version. */\n  removed: number;\n  /** Blocks in both, somewhere else. */\n  moved: number;\n}\n\n/** The whole report, as `ascribe diff --format json` writes it. */\nexport interface DiffReport {\n  /** `SCHEMA_VERSION`. */\n  schema_version: number;\n  /** The version of Ascribe that wrote it. */\n  ascribe_version: string;\n  /** What was compared with. */\n  base: BaseInfo;\n  /** Where the project is. */\n  repository: RepositoryInfo;\n  /**\n   * How many errors `ascribe check` finds in the working tree, for the\n   * builds compared. The comparison runs regardless, but a page with an\n   * error may not render as it will once it's fixed, so a reviewer should\n   * know. `diff_project` sets it; `Report::new` leaves it zero.\n   */\n  working_tree_errors: number;\n  /** What changed, per build, in the order asked for. */\n  builds: BuildDiff[];\n}\n\n/** What changed on one page of a build. */\nexport interface PageDiff {\n  /** The page's content path. */\n  path: string;\n  /** Its route: the new one, or for a removed page the old one. */\n  route: string;\n  /**\n   * Whether the build publishes it only now, only before, or in both\n   * with a difference.\n   */\n  status: PageStatus;\n  /** Whether the page's own file changed (or exists on one side only). */\n  own_file_changed: boolean;\n  /**\n   * The other changed files the page's change can come from: fragments it\n   * includes and pages its links take a title or a heading from, in path\n   * order; then the snippets whose code changed, by address\n   * (`code:app.py#main`); and `ascribe.toml` (last) when the content model\n   * is a cause.\n   */\n  because: string[];\n  /**\n   * What changed about the page itself besides its blocks, in this\n   * order: `title`, `frontmatter`, `availability` (the page-level one),\n   * and `route`. Empty for an added or removed page.\n   */\n  page_changed: string[];\n  /** How many changes of each kind. */\n  counts: Counts;\n  /**\n   * The block-level changes, in the page's order, a removed block where\n   * it was. Empty for an added or removed page.\n   */\n  changes: Change[];\n}\n\n/** Whether a page is new, gone, or different. */\nexport type PageStatus = \"added\" | \"removed\" | \"changed\";\n\n/** The repository, in the report. */\nexport interface RepositoryInfo {\n  /** The repository's top-level directory, as git prints it. */\n  root: string;\n  /**\n   * The project's folder inside it, with a trailing `/`, or empty when\n   * the project is at the repository's root.\n   */\n  project_prefix: string;\n}\n\n/**\n * The words that differ inside a changed block of prose. Ranges are\n * `[start, end)` in characters (Unicode scalar values) of each side's\n * `text`, which is the block's text with whitespace collapsed.\n */\nexport interface Words {\n  /** Ranges in `now_text`: words added or replacing others. */\n  now: [number, number][];\n  /** Ranges in `was_text`: words removed or replaced. */\n  was: [number, number][];\n  /** The block's text now. */\n  now_text: string;\n  /** The block's text before. */\n  was_text: string;\n}\n"]}