@variance-authority/tribunal 0.1.0

package/dist/ui/review.d.ts

@@ -0,0 +1,97 @@
+/**
+ * The review surface, as ordinary React.
+ *
+ * No framework imports, no router, no data-fetching library, no CSS toolchain —
+ * so it mounts inside whatever the operator already deploys. `./next` is one
+ * such wiring, for a [vinext](https://vinext.io) app; a Vite SPA needs nothing
+ * from this package but these components and `createReviewClient`.
+ *
+ * ## What this surface is *for*, which is not "looking at two screenshots"
+ *
+ * Every hosted product in this category shows you a before and an after and asks
+ * you to spot the difference. That is the review blindness the whole project
+ * exists to refuse: the hundredth screenshot in a run gets the same glance as the
+ * first, and the three-hundred-and-first is approved without being read.
+ *
+ * So the ordering here is deliberate and is the opposite of the category's:
+ *
+ * 1. **The docket first**, and it is where a build opens — components named as
+ *    *causes*, banded by what it costs to be wrong about them. One token change
+ *    across 300 subjects is one item with a count.
+ * 2. **The regions on the image.** A reviewer sees which box moved and which
+ *    component owns it, drawn over the render, cause and collateral distinct.
+ * 3. **The image last**, and only then as a comparison.
+ *
+ * Ranked by area a report of this kind is *wrong* — a container that was never
+ * edited and only reflowed outranks the edit, measured at 6× on one change. The
+ * ordering below comes from the tier that has provenance, which is why `cause`
+ * is a field on a region rather than a guess made here.
+ *
+ * ## Seven addresses, because this is a service and not a report
+ *
+ * This file is the router and nothing else. Every page is its own module and its
+ * own URL: [`builds.tsx`](./builds.tsx), [`docket.tsx`](./docket.tsx) for a build
+ * and the three stages inside it, [`change.tsx`](./change.tsx),
+ * [`subject.tsx`](./subject.tsx), [`run.tsx`](./run.tsx),
+ * [`history.tsx`](./history.tsx).
+ *
+ * The version this replaced held all of that in one component and three pieces of
+ * `useState`, which made every reading of a build the same address. A reviewer
+ * could not link a colleague to a change, could not open two in tabs, could not
+ * come back to one, and could not use the back button — and because there was one
+ * page, everything the run had to say was stacked on it. The build page reached
+ * twenty-seven thousand pixels, the divergence panel sat below four thousand of
+ * them, and the surface's best finding was in the part nobody scrolled to.
+ * [`route.ts`](./route.ts) is the address table both this and the Node service
+ * read, so a link that renders is a link that serves.
+ *
+ * ## And then the record, because "is this normal?" is the real question
+ *
+ * A difference is not a decision. The same 2px shift is a bug in a component
+ * nobody has touched since March and a Tuesday in one that moves in nineteen runs
+ * out of twenty, and a before-and-after cannot tell those apart. So the surface
+ * reaches the same history the CLI writes — churn, reach, stability, and the
+ * changelog of what was approved before — one subject at a time, and beside the
+ * change it is about rather than in a panel of its own.
+ */
+import type { ReactElement } from 'react';
+import type { ReviewClient } from './client.js';
+import type { Route } from './route.js';
+export { RegionOverlay, RegionTable, Viewer, modesFor, type ViewerMode } from './viewer.js';
+export { ChangelogEntries, ChangelogPage, ChurnLine, StabilityLine, SubjectHistory } from './history.js';
+export { ReachPanel, crossReach, type Crossing } from './reach.js';
+export { BuildList, CoverageLine } from './builds.js';
+export { OriginsPanel } from './origins.js';
+export { SubjectPanel } from './subject.js';
+export { Variations } from './variations.js';
+export { Prose } from './shell.js';
+export { originsOf, type Appearance, type Origin, type Origins } from './grouping.js';
+export { Look, frameOf, sightings, type Frame, type Sighting } from './look.js';
+export interface ReviewAppProps {
+    readonly client: ReviewClient;
+    /** Recorded on every decision. There are no accounts here; this is a name. */
+    readonly reviewer: string;
+    /** How many builds to list. The server's own default applies when absent. */
+    readonly limit?: number;
+    /**
+     * The address, when the host owns one.
+     *
+     * A Next app renders this inside a router that already holds the URL, and two
+     * things writing to one history stack is a back button that goes sideways.
+     * Given both of these, the surface reads the host's route and calls the host's
+     * navigate; given neither, it uses `pushState` itself.
+     */
+    readonly route?: Route | undefined;
+    readonly onNavigate?: ((route: Route) => void) | undefined;
+}
+/**
+ * The whole surface, mounted at whatever address it finds itself at.
+ *
+ * Give it a client and the reviewer's name and it is the entire review
+ * experience: builds awaiting decision, changes banded by what it costs to be
+ * wrong about them, regions drawn, and the approve and reject that write back. It
+ * holds no credential of its own, which is why the name is a prop and not
+ * something it asks the server for.
+ */
+export declare function ReviewApp({ client, reviewer, limit, route, onNavigate, }: ReviewAppProps): ReactElement;
+//# sourceMappingURL=review.d.ts.map

package/dist/ui/review.js

@@ -0,0 +1,39 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { BuildsPage } from './builds.js';
+import { BuildPage } from './docket.js';
+import { ChangelogPage } from './history.js';
+import { useRoute } from './navigation.js';
+import { Nowhere } from './shell.js';
+export { RegionOverlay, RegionTable, Viewer, modesFor } from './viewer.js';
+export { ChangelogEntries, ChangelogPage, ChurnLine, StabilityLine, SubjectHistory } from './history.js';
+export { ReachPanel, crossReach } from './reach.js';
+export { BuildList, CoverageLine } from './builds.js';
+export { OriginsPanel } from './origins.js';
+export { SubjectPanel } from './subject.js';
+export { Variations } from './variations.js';
+export { Prose } from './shell.js';
+export { originsOf } from './grouping.js';
+export { Look, frameOf, sightings } from './look.js';
+/**
+ * The whole surface, mounted at whatever address it finds itself at.
+ *
+ * Give it a client and the reviewer's name and it is the entire review
+ * experience: builds awaiting decision, changes banded by what it costs to be
+ * wrong about them, regions drawn, and the approve and reject that write back. It
+ * holds no credential of its own, which is why the name is a prop and not
+ * something it asks the server for.
+ */
+export function ReviewApp({ client, reviewer, limit, route, onNavigate, }) {
+    const [here, go] = useRoute(route, onNavigate);
+    // An address nobody claims is a rotted link, and rendering the front page for
+    // it would tell the reader their link worked.
+    if (here === undefined)
+        return _jsx(Nowhere, { go: go });
+    if (here.page === 'builds')
+        return _jsx(BuildsPage, { client: client, limit: limit, go: go });
+    if (here.page === 'changelog') {
+        return (_jsx("div", { className: "va-app", children: _jsx(ChangelogPage, { client: client, onBack: () => go({ page: 'builds' }) }) }));
+    }
+    return _jsx(BuildPage, { client: client, reviewer: reviewer, route: here, go: go });
+}
+//# sourceMappingURL=review.js.map

package/dist/ui/review.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review.js","sourceRoot":"","sources":["../../src/ui/review.tsx"],"names":[],"mappings":";AA2DA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAmB,MAAM,aAAa,CAAC;AAC5F,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,SAAS,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACzG,OAAO,EAAE,UAAU,EAAE,UAAU,EAAiB,MAAM,YAAY,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,SAAS,EAA8C,MAAM,eAAe,CAAC;AACtF,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAA6B,MAAM,WAAW,CAAC;AAoBhF;;;;;;;;GAQG;AACH,MAAM,UAAU,SAAS,CAAC,EACxB,MAAM,EACN,QAAQ,EACR,KAAK,EACL,KAAK,EACL,UAAU,GACK;IACf,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IAE/C,8EAA8E;IAC9E,8CAA8C;IAC9C,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,KAAC,OAAO,IAAC,EAAE,EAAE,EAAE,GAAI,CAAC;IAEnD,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,KAAC,UAAU,IAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,GAAI,CAAC;IAExF,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QAC9B,OAAO,CACL,cAAK,SAAS,EAAC,QAAQ,YACrB,KAAC,aAAa,IAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,GAAI,GACnE,CACP,CAAC;IACJ,CAAC;IAED,OAAO,KAAC,SAAS,IAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,GAAI,CAAC;AAChF,CAAC","sourcesContent":["/**\n * The review surface, as ordinary React.\n *\n * No framework imports, no router, no data-fetching library, no CSS toolchain —\n * so it mounts inside whatever the operator already deploys. `./next` is one\n * such wiring, for a [vinext](https://vinext.io) app; a Vite SPA needs nothing\n * from this package but these components and `createReviewClient`.\n *\n * ## What this surface is *for*, which is not \"looking at two screenshots\"\n *\n * Every hosted product in this category shows you a before and an after and asks\n * you to spot the difference. That is the review blindness the whole project\n * exists to refuse: the hundredth screenshot in a run gets the same glance as the\n * first, and the three-hundred-and-first is approved without being read.\n *\n * So the ordering here is deliberate and is the opposite of the category's:\n *\n * 1. **The docket first**, and it is where a build opens — components named as\n *    *causes*, banded by what it costs to be wrong about them. One token change\n *    across 300 subjects is one item with a count.\n * 2. **The regions on the image.** A reviewer sees which box moved and which\n *    component owns it, drawn over the render, cause and collateral distinct.\n * 3. **The image last**, and only then as a comparison.\n *\n * Ranked by area a report of this kind is *wrong* — a container that was never\n * edited and only reflowed outranks the edit, measured at 6× on one change. The\n * ordering below comes from the tier that has provenance, which is why `cause`\n * is a field on a region rather than a guess made here.\n *\n * ## Seven addresses, because this is a service and not a report\n *\n * This file is the router and nothing else. Every page is its own module and its\n * own URL: [`builds.tsx`](./builds.tsx), [`docket.tsx`](./docket.tsx) for a build\n * and the three stages inside it, [`change.tsx`](./change.tsx),\n * [`subject.tsx`](./subject.tsx), [`run.tsx`](./run.tsx),\n * [`history.tsx`](./history.tsx).\n *\n * The version this replaced held all of that in one component and three pieces of\n * `useState`, which made every reading of a build the same address. A reviewer\n * could not link a colleague to a change, could not open two in tabs, could not\n * come back to one, and could not use the back button — and because there was one\n * page, everything the run had to say was stacked on it. The build page reached\n * twenty-seven thousand pixels, the divergence panel sat below four thousand of\n * them, and the surface's best finding was in the part nobody scrolled to.\n * [`route.ts`](./route.ts) is the address table both this and the Node service\n * read, so a link that renders is a link that serves.\n *\n * ## And then the record, because \"is this normal?\" is the real question\n *\n * A difference is not a decision. The same 2px shift is a bug in a component\n * nobody has touched since March and a Tuesday in one that moves in nineteen runs\n * out of twenty, and a before-and-after cannot tell those apart. So the surface\n * reaches the same history the CLI writes — churn, reach, stability, and the\n * changelog of what was approved before — one subject at a time, and beside the\n * change it is about rather than in a panel of its own.\n */\n\nimport type { ReactElement } from 'react';\nimport type { ReviewClient } from './client.js';\nimport { BuildsPage } from './builds.js';\nimport { BuildPage } from './docket.js';\nimport { ChangelogPage } from './history.js';\nimport { useRoute } from './navigation.js';\nimport type { Route } from './route.js';\nimport { Nowhere } from './shell.js';\n\nexport { RegionOverlay, RegionTable, Viewer, modesFor, type ViewerMode } from './viewer.js';\nexport { ChangelogEntries, ChangelogPage, ChurnLine, StabilityLine, SubjectHistory } from './history.js';\nexport { ReachPanel, crossReach, type Crossing } from './reach.js';\nexport { BuildList, CoverageLine } from './builds.js';\nexport { OriginsPanel } from './origins.js';\nexport { SubjectPanel } from './subject.js';\nexport { Variations } from './variations.js';\nexport { Prose } from './shell.js';\nexport { originsOf, type Appearance, type Origin, type Origins } from './grouping.js';\nexport { Look, frameOf, sightings, type Frame, type Sighting } from './look.js';\n\nexport interface ReviewAppProps {\n  readonly client: ReviewClient;\n  /** Recorded on every decision. There are no accounts here; this is a name. */\n  readonly reviewer: string;\n  /** How many builds to list. The server's own default applies when absent. */\n  readonly limit?: number;\n  /**\n   * The address, when the host owns one.\n   *\n   * A Next app renders this inside a router that already holds the URL, and two\n   * things writing to one history stack is a back button that goes sideways.\n   * Given both of these, the surface reads the host's route and calls the host's\n   * navigate; given neither, it uses `pushState` itself.\n   */\n  readonly route?: Route | undefined;\n  readonly onNavigate?: ((route: Route) => void) | undefined;\n}\n\n/**\n * The whole surface, mounted at whatever address it finds itself at.\n *\n * Give it a client and the reviewer's name and it is the entire review\n * experience: builds awaiting decision, changes banded by what it costs to be\n * wrong about them, regions drawn, and the approve and reject that write back. It\n * holds no credential of its own, which is why the name is a prop and not\n * something it asks the server for.\n */\nexport function ReviewApp({\n  client,\n  reviewer,\n  limit,\n  route,\n  onNavigate,\n}: ReviewAppProps): ReactElement {\n  const [here, go] = useRoute(route, onNavigate);\n\n  // An address nobody claims is a rotted link, and rendering the front page for\n  // it would tell the reader their link worked.\n  if (here === undefined) return <Nowhere go={go} />;\n\n  if (here.page === 'builds') return <BuildsPage client={client} limit={limit} go={go} />;\n\n  if (here.page === 'changelog') {\n    return (\n      <div className=\"va-app\">\n        <ChangelogPage client={client} onBack={() => go({ page: 'builds' })} />\n      </div>\n    );\n  }\n\n  return <BuildPage client={client} reviewer={reviewer} route={here} go={go} />;\n}\n"]}

package/dist/ui/root.d.ts

@@ -0,0 +1,72 @@
+/**
+ * How a cause is drawn — as a heading over the changes it made, and on each of them.
+ *
+ * One module for both, because they are one claim printed twice and the two
+ * places must not be able to disagree. The rail says *`ui/button.tsx` — three
+ * renders*; the change page says *`Button` moved because `ui/button.tsx` is in
+ * this commit*, and a reviewer who clicked from one to the other and found two
+ * different files would stop believing either.
+ *
+ * ## The path is drawn, not summarised
+ *
+ * A basename is what a reviewer recognises and a path is what they can act on, so
+ * both are printed and the directory is dimmed rather than dropped. Two files
+ * called `button.tsx` in one build is an ordinary repository, and a heading that
+ * showed only the leaf would put them under one name.
+ *
+ * ## Siblings are the reason this is on the change page at all
+ *
+ * `Because` already names the rung — the file, or the parent, one hop up. What it
+ * cannot say is what *else* that file did, and that is the question a reviewer
+ * has after deciding one of them: `ProductCard.tsx` moved `CardFooter` here and
+ * `ProductCard` two rows down, and those are one edit with two consequences. The
+ * links are the rest of the edit.
+ */
+import type { ReactElement } from 'react';
+import type { BuildDetail } from '../review-types.js';
+import { type Origin } from './grouping.js';
+import { type Group } from './order.js';
+import type { Route } from './route.js';
+/**
+ * A band's heading: a path, a property, or a claim about a rung.
+ *
+ * The count beside a root is **renders**, not changes. *What did editing this
+ * file do* is answered in renders — one change over eleven of them is the answer
+ * a reviewer wants before they open it — while a band with no root counts changes,
+ * because a finding the commit does not account for had no blast radius to have.
+ */
+export declare function RootHeading({ group, detail, go, }: {
+    readonly group: Group;
+    readonly detail: BuildDetail;
+    readonly go: (route: Route) => void;
+}): ReactElement;
+/**
+ * What in the commit this change hangs from, and what else hangs from it.
+ *
+ * `null` when nothing does. That is the docket's alarm bands — nothing reaches
+ * it, nothing explains it, no diff was read — and a line reading *from* with a
+ * blank after it would be the page implying a cause it does not have.
+ *
+ * Read back out of the same arrangement the rail draws, so the file named here is
+ * the heading the reviewer clicked to arrive.
+ */
+export declare function causesOf(build: BuildDetail, origin: Origin): readonly Group[];
+/**
+ * Whether one of these causes is already the file the component is declared in.
+ *
+ * The `edited` rung's whole shape: the file the commit changed and the file the
+ * component lives in are one path, and a head printing both says it twice while
+ * dropping the line number off the copy a reviewer can open. So the cause line
+ * carries the declaration and the declaration line stands down — asked here
+ * rather than decided twice, so the two lines cannot both appear or both vanish.
+ */
+export declare function namesDeclaration(bands: readonly Group[], declared: string | undefined): boolean;
+export declare function UnderRoot({ bands, component, declared, build, go, }: {
+    readonly bands: readonly Group[];
+    readonly component: string;
+    /** Where the component is declared, when the docket knows — usually with a line. */
+    readonly declared?: string | undefined;
+    readonly build: string;
+    readonly go: (route: Route) => void;
+}): ReactElement | null;
+//# sourceMappingURL=root.d.ts.map

package/dist/ui/root.js

@@ -0,0 +1,102 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { foreseenBy } from './foreseen.js';
+import { originsOf } from './grouping.js';
+import { docketOf } from './order.js';
+import { Go } from './shell.js';
+import { count, number } from './text.js';
+/**
+ * A band's heading: a path, a property, or a claim about a rung.
+ *
+ * The count beside a root is **renders**, not changes. *What did editing this
+ * file do* is answered in renders — one change over eleven of them is the answer
+ * a reviewer wants before they open it — while a band with no root counts changes,
+ * because a finding the commit does not account for had no blast radius to have.
+ */
+export function RootHeading({ group, detail, go, }) {
+    if (group.root === undefined) {
+        return (_jsxs("h3", { children: [group.title, " ", _jsx("span", { className: "va-num", children: number(group.changes.length) })] }));
+    }
+    return (_jsxs(_Fragment, { children: [_jsxs("h3", { className: `va-root va-root-${group.root.kind}`, title: group.title, children: [_jsx(Path, { root: group.root }), _jsx("span", { className: "va-num", children: number(group.root.renders) })] }), group.root.kind !== 'file' ? null : (_jsx(Prediction, { detail: detail, file: group.root.name, go: go }))] }));
+}
+/**
+ * What editing this file was going to do, beside what it did.
+ *
+ * Drawn only for a file, because only a file makes the prediction: the reach walk
+ * starts at a path the diff named. A property or an owner the commit never
+ * touched has no set of subjects it was expected to arrive at, and a line under
+ * one would be a number invented to fill the same slot.
+ */
+function Prediction({ detail, file, go, }) {
+    const seen = foreseenBy(detail, file);
+    if (seen === null || seen.reached === 0)
+        return null;
+    const gaps = [
+        ['still', seen.still],
+        ['excluded', seen.excluded],
+        ['never compared', seen.uncompared],
+    ].filter(([, subjects]) => subjects.length > 0);
+    return (_jsxs("p", { className: "va-foreseen va-note", children: [_jsx("span", { className: "va-num", children: number(seen.reached) }), " reached", gaps.length === 0 ? _jsx(_Fragment, { children: " \u00B7 all moved" }) : null, gaps.map(([what, subjects]) => (_jsxs("span", { children: [' · ', _jsx("span", { className: "va-num", children: number(subjects.length) }), " ", what, ":", ' ', _jsx(Named, { subjects: subjects, build: detail.build, go: go })] }, what)))] }));
+}
+/** The subjects themselves, up to three, and a count of any it did not print. */
+function Named({ subjects, build, go, }) {
+    const shown = subjects.slice(0, 3);
+    return (_jsxs(_Fragment, { children: [shown.map((subject, index) => (_jsxs("span", { children: [index === 0 ? '' : ', ', _jsx(Go, { to: { page: 'subject', build, subject }, go: go, className: "va-from-go", children: subject })] }, subject))), subjects.length > shown.length ? ` and ${number(subjects.length - shown.length)} more` : ''] }));
+}
+/** The name, with a file's directory dimmed and its basename left alone. */
+function Path({ root, at, }) {
+    const name = at ?? root.name;
+    const cut = root.kind === 'file' ? name.lastIndexOf('/') + 1 : 0;
+    return (_jsxs(_Fragment, { children: [cut === 0 ? null : _jsx("span", { className: "va-root-in", children: name.slice(0, cut) }), _jsx("span", { className: "va-root-name", children: name.slice(cut) })] }));
+}
+/**
+ * The declared location when it is the root file with something after it.
+ *
+ * `startsWith` and not equality, because the declaration carries a line and the
+ * root does not. Guarded on the boundary so `button.tsx` does not swallow
+ * `button.test.tsx`, which is one character of prefix away and a different file.
+ */
+function extending(declared, root) {
+    if (declared === undefined || !declared.startsWith(root))
+        return undefined;
+    const after = declared.slice(root.length);
+    return after === '' || after.startsWith(':') ? declared : undefined;
+}
+/**
+ * What in the commit this change hangs from, and what else hangs from it.
+ *
+ * `null` when nothing does. That is the docket's alarm bands — nothing reaches
+ * it, nothing explains it, no diff was read — and a line reading *from* with a
+ * blank after it would be the page implying a cause it does not have.
+ *
+ * Read back out of the same arrangement the rail draws, so the file named here is
+ * the heading the reviewer clicked to arrive.
+ */
+export function causesOf(build, origin) {
+    return docketOf(build, originsOf(build).origins, 'story').filter((group) => group.root !== undefined &&
+        group.changes.some(({ origin: each }) => each.component === origin.component));
+}
+/**
+ * Whether one of these causes is already the file the component is declared in.
+ *
+ * The `edited` rung's whole shape: the file the commit changed and the file the
+ * component lives in are one path, and a head printing both says it twice while
+ * dropping the line number off the copy a reviewer can open. So the cause line
+ * carries the declaration and the declaration line stands down — asked here
+ * rather than decided twice, so the two lines cannot both appear or both vanish.
+ */
+export function namesDeclaration(bands, declared) {
+    return bands.some((group) => group.root !== undefined && extending(declared, group.root.name) !== undefined);
+}
+export function UnderRoot({ bands, component, declared, build, go, }) {
+    if (bands.length === 0)
+        return null;
+    return (_jsx(_Fragment, { children: bands.map((group) => (_jsxs("p", { className: "va-from", children: [_jsx("span", { className: "va-from-mark", children: "from" }), ' ', _jsx("span", { className: `va-root va-root-${group.root?.kind ?? 'file'}`, title: group.title, children: group.root === undefined ? (group.title) : (_jsx(Path, { root: group.root, at: extending(declared, group.root.name) })) }), _jsx(Siblings, { group: group, component: component, build: build, go: go })] }, group.title))) }));
+}
+/** The other changes the same cause made, which is the rest of the reviewer's edit. */
+function Siblings({ group, component, build, go, }) {
+    const others = group.changes.filter(({ origin }) => origin.component !== component);
+    if (others.length === 0)
+        return null;
+    return (_jsxs("span", { className: "va-note", children: [' ', "\u2014 which also moved", ' ', others.map(({ origin, of }, index) => (_jsxs("span", { children: [index === 0 ? '' : ', ', _jsx(Go, { to: { page: 'change', build, change: origin.component }, go: go, className: "va-from-go", children: origin.component }), ' ', _jsx("span", { className: "va-num", children: count(of ?? origin.appearances.length, 'render') })] }, origin.component)))] }));
+}
+//# sourceMappingURL=root.js.map

package/dist/ui/root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"root.js","sourceRoot":"","sources":["../../src/ui/root.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * How a cause is drawn — as a heading over the changes it made, and on each of them.\n *\n * One module for both, because they are one claim printed twice and the two\n * places must not be able to disagree. The rail says *`ui/button.tsx` — three\n * renders*; the change page says *`Button` moved because `ui/button.tsx` is in\n * this commit*, and a reviewer who clicked from one to the other and found two\n * different files would stop believing either.\n *\n * ## The path is drawn, not summarised\n *\n * A basename is what a reviewer recognises and a path is what they can act on, so\n * both are printed and the directory is dimmed rather than dropped. Two files\n * called `button.tsx` in one build is an ordinary repository, and a heading that\n * showed only the leaf would put them under one name.\n *\n * ## Siblings are the reason this is on the change page at all\n *\n * `Because` already names the rung — the file, or the parent, one hop up. What it\n * cannot say is what *else* that file did, and that is the question a reviewer\n * has after deciding one of them: `ProductCard.tsx` moved `CardFooter` here and\n * `ProductCard` two rows down, and those are one edit with two consequences. The\n * links are the rest of the edit.\n */\n\nimport type { ReactElement } from 'react';\nimport type { BuildDetail } from '../review-types.js';\nimport type { Root } from './cause.js';\nimport { foreseenBy } from './foreseen.js';\nimport { originsOf, type Origin } from './grouping.js';\nimport { docketOf, type Group } from './order.js';\nimport type { Route } from './route.js';\nimport { Go } from './shell.js';\nimport { count, number } from './text.js';\n\n/**\n * A band's heading: a path, a property, or a claim about a rung.\n *\n * The count beside a root is **renders**, not changes. *What did editing this\n * file do* is answered in renders — one change over eleven of them is the answer\n * a reviewer wants before they open it — while a band with no root counts changes,\n * because a finding the commit does not account for had no blast radius to have.\n */\nexport function RootHeading({\n  group,\n  detail,\n  go,\n}: {\n  readonly group: Group;\n  readonly detail: BuildDetail;\n  readonly go: (route: Route) => void;\n}): ReactElement {\n  if (group.root === undefined) {\n    return (\n      <h3>\n        {group.title} <span className=\"va-num\">{number(group.changes.length)}</span>\n      </h3>\n    );\n  }\n\n  return (\n    <>\n      <h3 className={`va-root va-root-${group.root.kind}`} title={group.title}>\n        <Path root={group.root} />\n        <span className=\"va-num\">{number(group.root.renders)}</span>\n      </h3>\n      {group.root.kind !== 'file' ? null : (\n        <Prediction detail={detail} file={group.root.name} go={go} />\n      )}\n    </>\n  );\n}\n\n/**\n * What editing this file was going to do, beside what it did.\n *\n * Drawn only for a file, because only a file makes the prediction: the reach walk\n * starts at a path the diff named. A property or an owner the commit never\n * touched has no set of subjects it was expected to arrive at, and a line under\n * one would be a number invented to fill the same slot.\n */\nfunction Prediction({\n  detail,\n  file,\n  go,\n}: {\n  readonly detail: BuildDetail;\n  readonly file: string;\n  readonly go: (route: Route) => void;\n}): ReactElement | null {\n  const seen = foreseenBy(detail, file);\n  if (seen === null || seen.reached === 0) return null;\n\n  const gaps = (\n    [\n      ['still', seen.still],\n      ['excluded', seen.excluded],\n      ['never compared', seen.uncompared],\n    ] as const\n  ).filter(([, subjects]) => subjects.length > 0);\n\n  return (\n    <p className=\"va-foreseen va-note\">\n      <span className=\"va-num\">{number(seen.reached)}</span> reached\n      {gaps.length === 0 ? <> · all moved</> : null}\n      {gaps.map(([what, subjects]) => (\n        <span key={what}>\n          {' · '}\n          <span className=\"va-num\">{number(subjects.length)}</span> {what}:{' '}\n          <Named subjects={subjects} build={detail.build} go={go} />\n        </span>\n      ))}\n    </p>\n  );\n}\n\n/** The subjects themselves, up to three, and a count of any it did not print. */\nfunction Named({\n  subjects,\n  build,\n  go,\n}: {\n  readonly subjects: readonly string[];\n  readonly build: string;\n  readonly go: (route: Route) => void;\n}): ReactElement {\n  const shown = subjects.slice(0, 3);\n\n  return (\n    <>\n      {shown.map((subject, index) => (\n        <span key={subject}>\n          {index === 0 ? '' : ', '}\n          <Go to={{ page: 'subject', build, subject }} go={go} className=\"va-from-go\">\n            {subject}\n          </Go>\n        </span>\n      ))}\n      {subjects.length > shown.length ? ` and ${number(subjects.length - shown.length)} more` : ''}\n    </>\n  );\n}\n\n/** The name, with a file's directory dimmed and its basename left alone. */\nfunction Path({\n  root,\n  at,\n}: {\n  readonly root: Root;\n  readonly at?: string | undefined;\n}): ReactElement {\n  const name = at ?? root.name;\n  const cut = root.kind === 'file' ? name.lastIndexOf('/') + 1 : 0;\n\n  return (\n    <>\n      {cut === 0 ? null : <span className=\"va-root-in\">{name.slice(0, cut)}</span>}\n      <span className=\"va-root-name\">{name.slice(cut)}</span>\n    </>\n  );\n}\n\n/**\n * The declared location when it is the root file with something after it.\n *\n * `startsWith` and not equality, because the declaration carries a line and the\n * root does not. Guarded on the boundary so `button.tsx` does not swallow\n * `button.test.tsx`, which is one character of prefix away and a different file.\n */\nfunction extending(declared: string | undefined, root: string): string | undefined {\n  if (declared === undefined || !declared.startsWith(root)) return undefined;\n  const after = declared.slice(root.length);\n  return after === '' || after.startsWith(':') ? declared : undefined;\n}\n\n/**\n * What in the commit this change hangs from, and what else hangs from it.\n *\n * `null` when nothing does. That is the docket's alarm bands — nothing reaches\n * it, nothing explains it, no diff was read — and a line reading *from* with a\n * blank after it would be the page implying a cause it does not have.\n *\n * Read back out of the same arrangement the rail draws, so the file named here is\n * the heading the reviewer clicked to arrive.\n */\nexport function causesOf(build: BuildDetail, origin: Origin): readonly Group[] {\n  return docketOf(build, originsOf(build).origins, 'story').filter(\n    (group) =>\n      group.root !== undefined &&\n      group.changes.some(({ origin: each }) => each.component === origin.component),\n  );\n}\n\n/**\n * Whether one of these causes is already the file the component is declared in.\n *\n * The `edited` rung's whole shape: the file the commit changed and the file the\n * component lives in are one path, and a head printing both says it twice while\n * dropping the line number off the copy a reviewer can open. So the cause line\n * carries the declaration and the declaration line stands down — asked here\n * rather than decided twice, so the two lines cannot both appear or both vanish.\n */\nexport function namesDeclaration(\n  bands: readonly Group[],\n  declared: string | undefined,\n): boolean {\n  return bands.some(\n    (group) => group.root !== undefined && extending(declared, group.root.name) !== undefined,\n  );\n}\n\nexport function UnderRoot({\n  bands,\n  component,\n  declared,\n  build,\n  go,\n}: {\n  readonly bands: readonly Group[];\n  readonly component: string;\n  /** Where the component is declared, when the docket knows — usually with a line. */\n  readonly declared?: string | undefined;\n  readonly build: string;\n  readonly go: (route: Route) => void;\n}): ReactElement | null {\n  if (bands.length === 0) return null;\n\n  return (\n    <>\n      {bands.map((group) => (\n        <p key={group.title} className=\"va-from\">\n          <span className=\"va-from-mark\">from</span>{' '}\n          <span className={`va-root va-root-${group.root?.kind ?? 'file'}`} title={group.title}>\n            {group.root === undefined ? (\n              group.title\n            ) : (\n              <Path root={group.root} at={extending(declared, group.root.name)} />\n            )}\n          </span>\n          <Siblings group={group} component={component} build={build} go={go} />\n        </p>\n      ))}\n    </>\n  );\n}\n\n/** The other changes the same cause made, which is the rest of the reviewer's edit. */\nfunction Siblings({\n  group,\n  component,\n  build,\n  go,\n}: {\n  readonly group: Group;\n  readonly component: string;\n  readonly build: string;\n  readonly go: (route: Route) => void;\n}): ReactElement | null {\n  const others = group.changes.filter(({ origin }) => origin.component !== component);\n  if (others.length === 0) return null;\n\n  return (\n    <span className=\"va-note\">\n      {' '}\n      — which also moved{' '}\n      {others.map(({ origin, of }, index) => (\n        <span key={origin.component}>\n          {index === 0 ? '' : ', '}\n          <Go to={{ page: 'change', build, change: origin.component }} go={go} className=\"va-from-go\">\n            {origin.component}\n          </Go>{' '}\n          <span className=\"va-num\">{count(of ?? origin.appearances.length, 'render')}</span>\n        </span>\n      ))}\n    </span>\n  );\n}\n"]}

package/dist/ui/route.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Where you are, as an address — because this is a service and not a report.
+ *
+ * The surface began as a build report rendered into a page, and it kept the
+ * report's idea of navigation: three `useState` values, one document, and a
+ * scroll bar. That has three costs and they compound. A reviewer cannot send
+ * anybody the thing they are looking at. A reload drops them back on the build
+ * list. And, worst, nothing on the page can be *elsewhere* — every panel a build
+ * knows about has to be on the build's own page, so the crossing against the
+ * previous run ends up ten thousand pixels below the change it is about.
+ *
+ * An address fixes all three at once, and the third is the one that matters: once
+ * a change has a URL, the panels that describe *that change* can live on it.
+ *
+ * ## One table, read from both ends
+ *
+ * {@link PAGE_PATTERNS} is the whole route set. The browser reads it to turn a
+ * path into a {@link Route}; the Node service reads the same table to decide
+ * which paths get the document. Two lists would drift, and the failure is silent
+ * in the worst direction — a link the client can render and the server answers
+ * with a 404.
+ *
+ * ## Disjoint from the API by construction
+ *
+ * The service answers `/review/…`, `/baseline/…`, `/cache/…` and `/history/…`.
+ * Pages live at `/builds/…` and `/changelog…`, which share no first segment with
+ * any of them. `serve.test.ts` holds that apart rather than trusting the reading:
+ * a page pattern that swallowed an API route would take the surface down and the
+ * ingest with it.
+ *
+ * ## Identifiers are encoded, because subjects have slashes in them
+ *
+ * A subject is `route/cart@1280`. Written raw it is two path segments and the
+ * pattern stops matching, so every identifier goes through
+ * `encodeURIComponent` on the way out and comes back through
+ * `decodeURIComponent` — and `route.test.ts` asserts the round trip on the
+ * awkward ones rather than on `Button`.
+ */
+/** How the docket is arranged. Part of the address, so an arrangement is shareable. */
+export type Order = 'story' | 'name' | 'size' | 'places';
+/** Which page, and what it is about. The client's entire navigation state. */
+export type Route = {
+    readonly page: 'builds';
+} | {
+    readonly page: 'build';
+    readonly build: string;
+    readonly order?: Order;
+} | {
+    readonly page: 'change';
+    readonly build: string;
+    readonly change: string;
+} | {
+    readonly page: 'subject';
+    readonly build: string;
+    readonly subject: string;
+} | {
+    readonly page: 'run';
+    readonly build: string;
+} | {
+    readonly page: 'changelog';
+};
+/** One row of the route table: a page, the paths it answers, and what they carry. */
+export interface PagePattern {
+    readonly page: Route['page'];
+    readonly at: RegExp;
+    /** The fields the captures fill, in order. */
+    readonly parts: readonly ('build' | 'change' | 'subject')[];
+}
+/**
+ * Every path this surface answers.
+ *
+ * Most specific first, though none of these can shadow another: a capture is
+ * `[^/]+`, so `/builds/7/run` cannot be read as a build named `7/run`. The order
+ * is for a reader, and for the day somebody adds a pattern that *can*.
+ */
+export declare const PAGE_PATTERNS: readonly PagePattern[];
+/**
+ * A path and its query as a route, or `undefined` when this surface owns neither.
+ *
+ * `undefined` rather than a fallback to the build list. A path nobody claims is a
+ * link that has rotted or a deployment mounted somewhere this build does not know
+ * about, and quietly showing the front page tells a reviewer their link worked.
+ */
+export declare function parseRoute(href: string): Route | undefined;
+/** The address of a route, ready for an `href` or a `pushState`. */
+export declare function hrefOf(route: Route): string;
+/**
+ * Whether a path is one of this surface's pages.
+ *
+ * The service's question, and it is deliberately not `parseRoute(path) !==
+ * undefined`: a server that had to construct a route to decide whether to send a
+ * document would be parsing query strings it will never read.
+ */
+export declare function isPagePath(path: string): boolean;
+//# sourceMappingURL=route.d.ts.map

package/dist/ui/route.js

@@ -0,0 +1,114 @@
+/**
+ * Where you are, as an address — because this is a service and not a report.
+ *
+ * The surface began as a build report rendered into a page, and it kept the
+ * report's idea of navigation: three `useState` values, one document, and a
+ * scroll bar. That has three costs and they compound. A reviewer cannot send
+ * anybody the thing they are looking at. A reload drops them back on the build
+ * list. And, worst, nothing on the page can be *elsewhere* — every panel a build
+ * knows about has to be on the build's own page, so the crossing against the
+ * previous run ends up ten thousand pixels below the change it is about.
+ *
+ * An address fixes all three at once, and the third is the one that matters: once
+ * a change has a URL, the panels that describe *that change* can live on it.
+ *
+ * ## One table, read from both ends
+ *
+ * {@link PAGE_PATTERNS} is the whole route set. The browser reads it to turn a
+ * path into a {@link Route}; the Node service reads the same table to decide
+ * which paths get the document. Two lists would drift, and the failure is silent
+ * in the worst direction — a link the client can render and the server answers
+ * with a 404.
+ *
+ * ## Disjoint from the API by construction
+ *
+ * The service answers `/review/…`, `/baseline/…`, `/cache/…` and `/history/…`.
+ * Pages live at `/builds/…` and `/changelog…`, which share no first segment with
+ * any of them. `serve.test.ts` holds that apart rather than trusting the reading:
+ * a page pattern that swallowed an API route would take the surface down and the
+ * ingest with it.
+ *
+ * ## Identifiers are encoded, because subjects have slashes in them
+ *
+ * A subject is `route/cart@1280`. Written raw it is two path segments and the
+ * pattern stops matching, so every identifier goes through
+ * `encodeURIComponent` on the way out and comes back through
+ * `decodeURIComponent` — and `route.test.ts` asserts the round trip on the
+ * awkward ones rather than on `Button`.
+ */
+/**
+ * Every path this surface answers.
+ *
+ * Most specific first, though none of these can shadow another: a capture is
+ * `[^/]+`, so `/builds/7/run` cannot be read as a build named `7/run`. The order
+ * is for a reader, and for the day somebody adds a pattern that *can*.
+ */
+export const PAGE_PATTERNS = [
+    { page: 'builds', at: /^\/(?:index\.html)?$/, parts: [] },
+    { page: 'changelog', at: /^\/changelog$/, parts: [] },
+    { page: 'run', at: /^\/builds\/([^/]+)\/run$/, parts: ['build'] },
+    { page: 'change', at: /^\/builds\/([^/]+)\/changes\/([^/]+)$/, parts: ['build', 'change'] },
+    { page: 'subject', at: /^\/builds\/([^/]+)\/subjects\/([^/]+)$/, parts: ['build', 'subject'] },
+    { page: 'build', at: /^\/builds\/([^/]+)$/, parts: ['build'] },
+];
+const ORDERS = ['story', 'name', 'size', 'places'];
+/**
+ * A path and its query as a route, or `undefined` when this surface owns neither.
+ *
+ * `undefined` rather than a fallback to the build list. A path nobody claims is a
+ * link that has rotted or a deployment mounted somewhere this build does not know
+ * about, and quietly showing the front page tells a reviewer their link worked.
+ */
+export function parseRoute(href) {
+    const url = new URL(href, 'http://route.invalid');
+    for (const pattern of PAGE_PATTERNS) {
+        const found = pattern.at.exec(url.pathname);
+        if (found === null)
+            continue;
+        const carried = {};
+        pattern.parts.forEach((part, index) => {
+            carried[part] = decodeURIComponent(found[index + 1] ?? '');
+        });
+        if (pattern.page !== 'build')
+            return { page: pattern.page, ...carried };
+        const asked = url.searchParams.get('order');
+        const order = ORDERS.find((each) => each === asked);
+        return {
+            page: 'build',
+            build: carried['build'] ?? '',
+            ...(order === undefined ? {} : { order }),
+        };
+    }
+    return undefined;
+}
+/** The address of a route, ready for an `href` or a `pushState`. */
+export function hrefOf(route) {
+    const at = (part) => encodeURIComponent(part);
+    switch (route.page) {
+        case 'builds':
+            return '/';
+        case 'build':
+            return route.order === undefined || route.order === 'story'
+                ? `/builds/${at(route.build)}`
+                : `/builds/${at(route.build)}?order=${route.order}`;
+        case 'change':
+            return `/builds/${at(route.build)}/changes/${at(route.change)}`;
+        case 'subject':
+            return `/builds/${at(route.build)}/subjects/${at(route.subject)}`;
+        case 'run':
+            return `/builds/${at(route.build)}/run`;
+        case 'changelog':
+            return '/changelog';
+    }
+}
+/**
+ * Whether a path is one of this surface's pages.
+ *
+ * The service's question, and it is deliberately not `parseRoute(path) !==
+ * undefined`: a server that had to construct a route to decide whether to send a
+ * document would be parsing query strings it will never read.
+ */
+export function isPagePath(path) {
+    return PAGE_PATTERNS.some((pattern) => pattern.at.test(path));
+}
+//# sourceMappingURL=route.js.map

package/dist/ui/route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.js","sourceRoot":"","sources":["../../src/ui/route.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Where you are, as an address — because this is a service and not a report.\n *\n * The surface began as a build report rendered into a page, and it kept the\n * report's idea of navigation: three `useState` values, one document, and a\n * scroll bar. That has three costs and they compound. A reviewer cannot send\n * anybody the thing they are looking at. A reload drops them back on the build\n * list. And, worst, nothing on the page can be *elsewhere* — every panel a build\n * knows about has to be on the build's own page, so the crossing against the\n * previous run ends up ten thousand pixels below the change it is about.\n *\n * An address fixes all three at once, and the third is the one that matters: once\n * a change has a URL, the panels that describe *that change* can live on it.\n *\n * ## One table, read from both ends\n *\n * {@link PAGE_PATTERNS} is the whole route set. The browser reads it to turn a\n * path into a {@link Route}; the Node service reads the same table to decide\n * which paths get the document. Two lists would drift, and the failure is silent\n * in the worst direction — a link the client can render and the server answers\n * with a 404.\n *\n * ## Disjoint from the API by construction\n *\n * The service answers `/review/…`, `/baseline/…`, `/cache/…` and `/history/…`.\n * Pages live at `/builds/…` and `/changelog…`, which share no first segment with\n * any of them. `serve.test.ts` holds that apart rather than trusting the reading:\n * a page pattern that swallowed an API route would take the surface down and the\n * ingest with it.\n *\n * ## Identifiers are encoded, because subjects have slashes in them\n *\n * A subject is `route/cart@1280`. Written raw it is two path segments and the\n * pattern stops matching, so every identifier goes through\n * `encodeURIComponent` on the way out and comes back through\n * `decodeURIComponent` — and `route.test.ts` asserts the round trip on the\n * awkward ones rather than on `Button`.\n */\n\n/** How the docket is arranged. Part of the address, so an arrangement is shareable. */\nexport type Order = 'story' | 'name' | 'size' | 'places';\n\n/** Which page, and what it is about. The client's entire navigation state. */\nexport type Route =\n  | { readonly page: 'builds' }\n  | { readonly page: 'build'; readonly build: string; readonly order?: Order }\n  | { readonly page: 'change'; readonly build: string; readonly change: string }\n  | { readonly page: 'subject'; readonly build: string; readonly subject: string }\n  | { readonly page: 'run'; readonly build: string }\n  | { readonly page: 'changelog' };\n\n/** One row of the route table: a page, the paths it answers, and what they carry. */\nexport interface PagePattern {\n  readonly page: Route['page'];\n  readonly at: RegExp;\n  /** The fields the captures fill, in order. */\n  readonly parts: readonly ('build' | 'change' | 'subject')[];\n}\n\n/**\n * Every path this surface answers.\n *\n * Most specific first, though none of these can shadow another: a capture is\n * `[^/]+`, so `/builds/7/run` cannot be read as a build named `7/run`. The order\n * is for a reader, and for the day somebody adds a pattern that *can*.\n */\nexport const PAGE_PATTERNS: readonly PagePattern[] = [\n  { page: 'builds', at: /^\\/(?:index\\.html)?$/, parts: [] },\n  { page: 'changelog', at: /^\\/changelog$/, parts: [] },\n  { page: 'run', at: /^\\/builds\\/([^/]+)\\/run$/, parts: ['build'] },\n  { page: 'change', at: /^\\/builds\\/([^/]+)\\/changes\\/([^/]+)$/, parts: ['build', 'change'] },\n  { page: 'subject', at: /^\\/builds\\/([^/]+)\\/subjects\\/([^/]+)$/, parts: ['build', 'subject'] },\n  { page: 'build', at: /^\\/builds\\/([^/]+)$/, parts: ['build'] },\n];\n\nconst ORDERS: readonly Order[] = ['story', 'name', 'size', 'places'];\n\n/**\n * A path and its query as a route, or `undefined` when this surface owns neither.\n *\n * `undefined` rather than a fallback to the build list. A path nobody claims is a\n * link that has rotted or a deployment mounted somewhere this build does not know\n * about, and quietly showing the front page tells a reviewer their link worked.\n */\nexport function parseRoute(href: string): Route | undefined {\n  const url = new URL(href, 'http://route.invalid');\n\n  for (const pattern of PAGE_PATTERNS) {\n    const found = pattern.at.exec(url.pathname);\n    if (found === null) continue;\n\n    const carried: Record<string, string> = {};\n    pattern.parts.forEach((part, index) => {\n      carried[part] = decodeURIComponent(found[index + 1] ?? '');\n    });\n\n    if (pattern.page !== 'build') return { page: pattern.page, ...carried } as Route;\n\n    const asked = url.searchParams.get('order');\n    const order = ORDERS.find((each) => each === asked);\n    return {\n      page: 'build',\n      build: carried['build'] ?? '',\n      ...(order === undefined ? {} : { order }),\n    };\n  }\n\n  return undefined;\n}\n\n/** The address of a route, ready for an `href` or a `pushState`. */\nexport function hrefOf(route: Route): string {\n  const at = (part: string): string => encodeURIComponent(part);\n\n  switch (route.page) {\n    case 'builds':\n      return '/';\n    case 'build':\n      return route.order === undefined || route.order === 'story'\n        ? `/builds/${at(route.build)}`\n        : `/builds/${at(route.build)}?order=${route.order}`;\n    case 'change':\n      return `/builds/${at(route.build)}/changes/${at(route.change)}`;\n    case 'subject':\n      return `/builds/${at(route.build)}/subjects/${at(route.subject)}`;\n    case 'run':\n      return `/builds/${at(route.build)}/run`;\n    case 'changelog':\n      return '/changelog';\n  }\n}\n\n/**\n * Whether a path is one of this surface's pages.\n *\n * The service's question, and it is deliberately not `parseRoute(path) !==\n * undefined`: a server that had to construct a route to decide whether to send a\n * document would be parsing query strings it will never read.\n */\nexport function isPagePath(path: string): boolean {\n  return PAGE_PATTERNS.some((pattern) => pattern.at.test(path));\n}\n"]}

package/dist/ui/run.d.ts

@@ -0,0 +1,26 @@
+/**
+ * The run, in full — everything the report says that is not one change.
+ *
+ * This is the material that used to sit under the docket on the build page, and
+ * moving it is the whole of the layout argument. Reach, the crossing against the
+ * last run, the variation lattice, what a declaration settled, what was declared,
+ * what was never observed: every one of those is worth reading, and none of them
+ * is worth reading *while deciding whether to approve a restyle of `Button`*. On
+ * one page they were four thousand pixels of scroll between a reviewer and the
+ * second change in the build.
+ *
+ * So they have an address. A reviewer working a docket never opens it; a reviewer
+ * asking *what did this run actually do* opens nothing else. The crossing is
+ * handed down rather than fetched again — the build page has already asked, and
+ * the two readings of one comparison must not be able to disagree.
+ */
+import type { ReactElement } from 'react';
+import type { BuildDetail } from '../review-types.js';
+import type { ReviewClient } from './client.js';
+import type { Crossing } from './crossing.js';
+export declare function RunPage({ client, build, crossing, }: {
+    readonly client: ReviewClient;
+    readonly build: BuildDetail;
+    readonly crossing: Crossing;
+}): ReactElement;
+//# sourceMappingURL=run.d.ts.map