@graview/core 0.1.64 → 0.1.66

package/dist/revisions/beyond.js

@@ -0,0 +1,112 @@
+/** Every string an act's arguments hold, however deep. */
+function stringsIn(value, into) {
+    if (typeof value === "string")
+        into.add(value);
+    else if (Array.isArray(value))
+        for (const one of value)
+            stringsIn(one, into);
+    else if (typeof value === "object" && value !== null)
+        for (const one of Object.values(value))
+            stringsIn(one, into);
+    return into;
+}
+const sameAuthor = (a, b) => a.kind === b.kind && (a.id ?? "") === (b.id ?? "");
+/** The record ids a primitive touches. */
+function touched(primitive) {
+    switch (primitive.op) {
+        case "add-node":
+        case "remove-node":
+            return [primitive.node.id];
+        case "patch-node":
+        case "splice-text":
+            return [primitive.id];
+        case "add-edge":
+        case "remove-edge":
+            return [primitive.edge.from, primitive.edge.to];
+    }
+}
+const nameOf = (node) => [node["title"], node["name"], node["label"]].find((one) => typeof one === "string" && one.length > 0);
+/**
+ * WHAT AN ANSWER CHANGED BEYOND WHAT WAS ASKED: every record added,
+ * removed or changed, and every link made or taken, that is not the asking
+ * act's own — its own being the records the act's arguments name and the
+ * first record it made, and a link between two of those.
+ */
+export function beyondAsked(answer, options = {}) {
+    const askedNames = options.asked ? new Set(options.asked.map((call) => call.name)) : undefined;
+    const first = answer.ops[0]?.author;
+    const names = new Map();
+    const asked = [];
+    const beyond = [];
+    const changedAt = new Map();
+    for (const op of answer.ops) {
+        const act = op.mutation?.name ?? null;
+        for (const primitive of op.primitives)
+            if ((primitive.op === "add-node" || primitive.op === "remove-node") && nameOf(primitive.node))
+                names.set(primitive.node.id, nameOf(primitive.node));
+        /* An op is asked when it is an act, by whoever asked the first, and one of the acts asked: anything else in the answer is beyond it whole. */
+        const isAsked = act !== null && (!first || sameAuthor(op.author, first)) && (!askedNames || askedNames.has(act));
+        const ids = new Set(op.primitives.flatMap(touched));
+        const targets = new Set();
+        if (isAsked) {
+            for (const one of stringsIn(op.mutation.args, new Set()))
+                if (ids.has(one))
+                    targets.add(one);
+            const made = op.primitives.find((primitive) => primitive.op === "add-node");
+            if (made)
+                targets.add(made.node.id);
+            asked.push({ op: op.id, act, records: [...targets] });
+        }
+        for (const primitive of op.primitives) {
+            if (primitive.op === "add-node" || primitive.op === "remove-node") {
+                if (!targets.has(primitive.node.id))
+                    beyond.push({ change: primitive.op === "add-node" ? "added" : "removed", record: primitive.node.id, kind: primitive.node.kind, op: op.id, act });
+            }
+            else if (primitive.op === "patch-node" || primitive.op === "splice-text") {
+                if (targets.has(primitive.id))
+                    continue;
+                const fields = primitive.op === "patch-node" ? Object.keys(primitive.after) : [primitive.field];
+                const key = `${op.id} ${primitive.id}`;
+                const at = changedAt.get(key);
+                if (at)
+                    for (const field of fields)
+                        at.fields.add(field);
+                else {
+                    changedAt.set(key, { fields: new Set(fields), entry: beyond.length });
+                    beyond.push({ change: "changed", record: primitive.id, fields, op: op.id, act });
+                }
+            }
+            else if (!(targets.has(primitive.edge.from) && targets.has(primitive.edge.to))) {
+                beyond.push({ change: primitive.op === "add-edge" ? "linked" : "unlinked", edge: primitive.edge, op: op.id, act });
+            }
+        }
+    }
+    for (const { fields, entry } of changedAt.values()) {
+        const one = beyond[entry];
+        beyond[entry] = { ...one, fields: [...fields] };
+    }
+    const label = (id) => {
+        const name = options.label?.(id) ?? names.get(id);
+        return name ? `"${name}"` : id;
+    };
+    const groups = [];
+    const of = (change) => beyond.filter((one) => one.change === change);
+    const changed = of("changed");
+    if (changed.length > 0)
+        groups.push(`changed ${changed.map((one) => `${label(one.record)} (${one.fields.join(", ")})`).join(", ")}`);
+    const added = of("added");
+    if (added.length > 0)
+        groups.push(`added ${added.map((one) => `${one.kind} ${label(one.record)}`).join(", ")}`);
+    const removed = of("removed");
+    if (removed.length > 0)
+        groups.push(`removed ${removed.map((one) => `${one.kind} ${label(one.record)}`).join(", ")}`);
+    const linked = of("linked");
+    if (linked.length > 0)
+        groups.push(`linked ${linked.map((one) => `${label(one.edge.from)} ${one.edge.kind} ${label(one.edge.to)}`).join(", ")}`);
+    const unlinked = of("unlinked");
+    if (unlinked.length > 0)
+        groups.push(`took the link ${unlinked.map((one) => `${label(one.edge.from)} ${one.edge.kind} ${label(one.edge.to)}`).join(", ")}`);
+    const said = groups.length > 0 ? [`Besides what was asked, it also ${groups.join("; ")}.`] : [];
+    return { asked, beyond, said, text: said[0] ?? "It changed only what was asked." };
+}
+//# sourceMappingURL=beyond.js.map

package/dist/revisions/beyond.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"beyond.js","sourceRoot":"","sources":["../../src/revisions/beyond.ts"],"names":[],"mappings":"AA6DA,0DAA0D;AAC1D,SAAS,SAAS,CAAC,KAAc,EAAE,IAAiB;IAClD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;SAC1C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,KAAK,MAAM,GAAG,IAAI,KAAK;YAAE,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;SACxE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;YAAE,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACnH,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,CAAS,EAAE,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;AAEhG,0CAA0C;AAC1C,SAAS,OAAO,CAAC,SAAoB;IACnC,QAAQ,SAAS,CAAC,EAAE,EAAE,CAAC;QACrB,KAAK,UAAU,CAAC;QAChB,KAAK,aAAa;YAChB,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC7B,KAAK,YAAY,CAAC;QAClB,KAAK,aAAa;YAChB,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QACxB,KAAK,UAAU,CAAC;QAChB,KAAK,aAAa;YAChB,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC;AACH,CAAC;AAED,MAAM,MAAM,GAAG,CAAC,IAAkB,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAiB,EAAE,CAAC,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAE5J;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,MAA8C,EAAE,UAA8B,EAAE;IAC1G,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/F,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC;IACpC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IACxC,MAAM,KAAK,GAA4D,EAAE,CAAC;IAC1E,MAAM,MAAM,GAAmB,EAAE,CAAC;IAClC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkD,CAAC;IAC5E,KAAK,MAAM,EAAE,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,EAAE,CAAC,QAAQ,EAAE,IAAI,IAAI,IAAI,CAAC;QACtC,KAAK,MAAM,SAAS,IAAI,EAAE,CAAC,UAAU;YAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,UAAU,IAAI,SAAS,CAAC,EAAE,KAAK,aAAa,CAAC,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC;gBAAE,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,SAAS,CAAC,IAAI,CAAE,CAAC,CAAC;QAC5L,8IAA8I;QAC9I,MAAM,OAAO,GAAG,GAAG,KAAK,IAAI,IAAI,CAAC,CAAC,KAAK,IAAI,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,IAAI,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QACjH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;QACpD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAClC,IAAI,OAAO,EAAE,CAAC;YACZ,KAAK,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,CAAC,QAAS,CAAC,IAAI,EAAE,IAAI,GAAG,EAAE,CAAC;gBAAE,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC;oBAAE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC9F,MAAM,IAAI,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,EAAuD,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,UAAU,CAAC,CAAC;YACjI,IAAI,IAAI;gBAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACpC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC;QACxD,CAAC;QACD,KAAK,MAAM,SAAS,IAAI,EAAE,CAAC,UAAU,EAAE,CAAC;YACtC,IAAI,SAAS,CAAC,EAAE,KAAK,UAAU,IAAI,SAAS,CAAC,EAAE,KAAK,aAAa,EAAE,CAAC;gBAClE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;oBAAE,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,KAAK,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,GAAG,EAAkB,CAAC,CAAC;YACxM,CAAC;iBAAM,IAAI,SAAS,CAAC,EAAE,KAAK,YAAY,IAAI,SAAS,CAAC,EAAE,KAAK,aAAa,EAAE,CAAC;gBAC3E,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;oBAAE,SAAS;gBACxC,MAAM,MAAM,GAAG,SAAS,CAAC,EAAE,KAAK,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;gBAChG,MAAM,GAAG,GAAG,GAAG,EAAE,CAAC,EAAE,IAAI,SAAS,CAAC,EAAE,EAAE,CAAC;gBACvC,MAAM,EAAE,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBAC9B,IAAI,EAAE;oBAAE,KAAK,MAAM,KAAK,IAAI,MAAM;wBAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;qBACpD,CAAC;oBACJ,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,IAAI,GAAG,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;oBACtE,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;gBACnF,CAAC;YACH,CAAC;iBAAM,IAAI,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;gBACjF,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,KAAK,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,GAAG,EAAkB,CAAC,CAAC;YACrI,CAAC;QACH,CAAC;IACH,CAAC;IACD,KAAK,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;QACnD,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAiD,CAAC;QAC1E,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,CAAC,GAAG,MAAM,CAAC,EAAE,CAAC;IAClD,CAAC;IACD,MAAM,KAAK,GAAG,CAAC,EAAU,EAAE,EAAE;QAC3B,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACjC,CAAC,CAAC;IACF,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,EAAE,GAAG,CAAmC,MAAS,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAA+C,EAAE,CAAC,GAAG,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;IACvJ,MAAM,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC9B,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,WAAW,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACrI,MAAM,KAAK,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC;IAC1B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,IAAI,IAAI,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChH,MAAM,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC9B,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,WAAW,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,IAAI,IAAI,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACtH,MAAM,MAAM,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC;IAC5B,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,UAAU,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjJ,MAAM,QAAQ,GAAG,EAAE,CAAC,UAAU,CAAC,CAAC;IAChC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,iBAAiB,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5J,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,mCAAmC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAChG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,iCAAiC,EAAE,CAAC;AACrF,CAAC"}

package/dist/revisions/pictured.d.ts

@@ -0,0 +1,52 @@
+import type { DrawnSection } from "./sections.js";
+/** A section of a page where it stands, in CSS pixels from the top of what scrolls. */
+export interface PlacedSection extends DrawnSection {
+    readonly top: number;
+    readonly bottom: number;
+}
+/** A page as `MEASURE_PICTURED_PAGE` measured it. */
+export interface PageMeasure {
+    /** How tall the whole place is: the height of what scrolls. */
+    readonly height: number;
+    /** How far it was scrolled when measured. */
+    readonly top: number;
+    /** How much of it a window shows: what a picture of the window holds. */
+    readonly window: number;
+    readonly sections: readonly PlacedSection[];
+}
+/** How much of a page a picture held, and what it left out. */
+export interface PictureCoverage {
+    /** True when the picture held the whole page. */
+    readonly whole: boolean;
+    readonly height: number;
+    /** The part of the page pictured, top and bottom, in CSS pixels. */
+    readonly pictured: {
+        readonly top: number;
+        readonly bottom: number;
+    };
+    /** Sections wholly above the picture, and wholly below it. */
+    readonly above: readonly PlacedSection[];
+    readonly below: readonly PlacedSection[];
+    /** In a sentence: "First screen only (900 of 5,100px); not shown: This week, Dinner." */
+    readonly said: string;
+}
+/**
+ * MEASURE THE PAGE AS IT IS PICTURED: evaluate it in the page (Playwright's
+ * `page.evaluate`, a host's own browser) right before the picture is taken,
+ * and hand what it answers to `picturedCoverage`. It reads the box the
+ * place scrolls in — an embed's `[data-embed-content]`, the tallest box that
+ * scrolls, or the document — and every section on it, a worker view's
+ * among them (each view draws into an open shadow root).
+ */
+export declare const MEASURE_PICTURED_PAGE = "(() => {\n  const scrolls = (el) => /(auto|scroll)/.test(getComputedStyle(el).overflowY) && el.scrollHeight > el.clientHeight + 1;\n  const content = document.querySelector(\"[data-embed-content]\");\n  const box = content && scrolls(content)\n    ? content\n    : [...document.querySelectorAll(\"body *\")].filter((el) => scrolls(el) && el.clientHeight >= innerHeight / 2).sort((a, b) => b.clientHeight - a.clientHeight)[0];\n  const doc = document.scrollingElement || document.documentElement;\n  const height = box ? box.scrollHeight : Math.max(doc.scrollHeight, document.body ? document.body.scrollHeight : 0);\n  const top = box ? box.scrollTop : scrollY;\n  const windowHeight = box ? box.clientHeight : innerHeight;\n  const origin = box ? box.getBoundingClientRect().top - box.scrollTop : -scrollY;\n  const LANDMARKS = { section: null, article: null, form: null, region: null, nav: \"navigation\", navigation: \"navigation\", main: \"main content\", header: \"header\", banner: \"header\", footer: \"footer\", contentinfo: \"footer\", aside: \"aside\", complementary: \"aside\", search: \"search\" };\n  const said = (text) => (text || \"\").replace(/\\s+/g, \" \").trim();\n  const tagOf = (el) => (el.getAttribute(\"data-graview-as\") || el.localName || \"\").toLowerCase();\n  const level = (el) => /^h[1-6]$/.test(tagOf(el)) ? 1 : el.getAttribute(\"role\") === \"heading\" ? 1 : 0;\n  const all = [];\n  const walk = (root) => {\n    for (const el of root.querySelectorAll(\"*\")) {\n      all.push(el);\n      if (el.shadowRoot) walk(el.shadowRoot);\n    }\n  };\n  walk(document);\n  const sections = [];\n  const seen = new Set();\n  for (const el of all) {\n    if (el.closest(\"[data-testid=app-bar], [role=dialog]\")) continue;\n    const rect = el.getBoundingClientRect();\n    if (rect.height <= 0 || rect.width <= 0 || getComputedStyle(el).visibility === \"hidden\") continue;\n    let name = \"\";\n    let as = \"\";\n    if (level(el)) {\n      name = said(el.textContent);\n      as = \"heading\";\n    } else {\n      const role = (el.getAttribute(\"role\") || \"\").toLowerCase();\n      const tag = tagOf(el);\n      const what = role in LANDMARKS ? role : tag in LANDMARKS ? tag : \"\";\n      if (!what) continue;\n      const root = el.getRootNode();\n      const namedBy = (el.getAttribute(\"aria-labelledby\") || \"\").split(/\\s+/).map((id) => id && root.getElementById ? root.getElementById(id) : null).filter(Boolean).map((one) => said(one.textContent)).join(\" \");\n      const heading = [...el.querySelectorAll(\"*\")].find(level);\n      name = said(el.getAttribute(\"aria-label\")) || namedBy || (heading ? said(heading.textContent) : \"\") || LANDMARKS[what] || \"\";\n      as = what === \"region\" ? \"section\" : what;\n    }\n    if (!name || seen.has(name.toLowerCase())) continue;\n    seen.add(name.toLowerCase());\n    sections.push({ name: name.length > 80 ? name.slice(0, 79) + \"\u2026\" : name, as, top: Math.round(rect.top - origin), bottom: Math.round(rect.bottom - origin) });\n  }\n  return { height: Math.ceil(height), top: Math.round(top), window: Math.round(windowHeight), sections };\n})()";
+/**
+ * HOW MUCH OF A PAGE A PICTURE HELD. `pictured` is the part of the page in
+ * the picture, from the top of what scrolls; left out, it is the window
+ * where the page was measured. A section is shown when any of it is in the
+ * picture; one wholly above or below is named as not shown.
+ */
+export declare function picturedCoverage(measure: PageMeasure, pictured?: {
+    readonly top: number;
+    readonly height: number;
+}): PictureCoverage;
+//# sourceMappingURL=pictured.d.ts.map

package/dist/revisions/pictured.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pictured.d.ts","sourceRoot":"","sources":["../../src/revisions/pictured.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,uFAAuF;AACvF,MAAM,WAAW,aAAc,SAAQ,YAAY;IACjD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,qDAAqD;AACrD,MAAM,WAAW,WAAW;IAC1B,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,6CAA6C;IAC7C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;CAC7C;AAED,+DAA+D;AAC/D,MAAM,WAAW,eAAe;IAC9B,iDAAiD;IACjD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,oEAAoE;IACpE,QAAQ,CAAC,QAAQ,EAAE;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACrE,8DAA8D;IAC9D,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IACzC,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IACzC,yFAAyF;IACzF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,qlGAkD7B,CAAC;AAMN;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,eAAe,CAcpI"}

package/dist/revisions/pictured.js

@@ -0,0 +1,85 @@
+/**
+ * MEASURE THE PAGE AS IT IS PICTURED: evaluate it in the page (Playwright's
+ * `page.evaluate`, a host's own browser) right before the picture is taken,
+ * and hand what it answers to `picturedCoverage`. It reads the box the
+ * place scrolls in — an embed's `[data-embed-content]`, the tallest box that
+ * scrolls, or the document — and every section on it, a worker view's
+ * among them (each view draws into an open shadow root).
+ */
+export const MEASURE_PICTURED_PAGE = `(() => {
+  const scrolls = (el) => /(auto|scroll)/.test(getComputedStyle(el).overflowY) && el.scrollHeight > el.clientHeight + 1;
+  const content = document.querySelector("[data-embed-content]");
+  const box = content && scrolls(content)
+    ? content
+    : [...document.querySelectorAll("body *")].filter((el) => scrolls(el) && el.clientHeight >= innerHeight / 2).sort((a, b) => b.clientHeight - a.clientHeight)[0];
+  const doc = document.scrollingElement || document.documentElement;
+  const height = box ? box.scrollHeight : Math.max(doc.scrollHeight, document.body ? document.body.scrollHeight : 0);
+  const top = box ? box.scrollTop : scrollY;
+  const windowHeight = box ? box.clientHeight : innerHeight;
+  const origin = box ? box.getBoundingClientRect().top - box.scrollTop : -scrollY;
+  const LANDMARKS = { section: null, article: null, form: null, region: null, nav: "navigation", navigation: "navigation", main: "main content", header: "header", banner: "header", footer: "footer", contentinfo: "footer", aside: "aside", complementary: "aside", search: "search" };
+  const said = (text) => (text || "").replace(/\\s+/g, " ").trim();
+  const tagOf = (el) => (el.getAttribute("data-graview-as") || el.localName || "").toLowerCase();
+  const level = (el) => /^h[1-6]$/.test(tagOf(el)) ? 1 : el.getAttribute("role") === "heading" ? 1 : 0;
+  const all = [];
+  const walk = (root) => {
+    for (const el of root.querySelectorAll("*")) {
+      all.push(el);
+      if (el.shadowRoot) walk(el.shadowRoot);
+    }
+  };
+  walk(document);
+  const sections = [];
+  const seen = new Set();
+  for (const el of all) {
+    if (el.closest("[data-testid=app-bar], [role=dialog]")) continue;
+    const rect = el.getBoundingClientRect();
+    if (rect.height <= 0 || rect.width <= 0 || getComputedStyle(el).visibility === "hidden") continue;
+    let name = "";
+    let as = "";
+    if (level(el)) {
+      name = said(el.textContent);
+      as = "heading";
+    } else {
+      const role = (el.getAttribute("role") || "").toLowerCase();
+      const tag = tagOf(el);
+      const what = role in LANDMARKS ? role : tag in LANDMARKS ? tag : "";
+      if (!what) continue;
+      const root = el.getRootNode();
+      const namedBy = (el.getAttribute("aria-labelledby") || "").split(/\\s+/).map((id) => id && root.getElementById ? root.getElementById(id) : null).filter(Boolean).map((one) => said(one.textContent)).join(" ");
+      const heading = [...el.querySelectorAll("*")].find(level);
+      name = said(el.getAttribute("aria-label")) || namedBy || (heading ? said(heading.textContent) : "") || LANDMARKS[what] || "";
+      as = what === "region" ? "section" : what;
+    }
+    if (!name || seen.has(name.toLowerCase())) continue;
+    seen.add(name.toLowerCase());
+    sections.push({ name: name.length > 80 ? name.slice(0, 79) + "…" : name, as, top: Math.round(rect.top - origin), bottom: Math.round(rect.bottom - origin) });
+  }
+  return { height: Math.ceil(height), top: Math.round(top), window: Math.round(windowHeight), sections };
+})()`;
+const MOST_NAMED = 8;
+const px = (n) => Math.round(n).toLocaleString("en-US");
+const names = (sections) => (sections.length <= MOST_NAMED ? sections.map((one) => one.name).join(", ") : `${sections.slice(0, MOST_NAMED).map((one) => one.name).join(", ")} and ${sections.length - MOST_NAMED} more`);
+/**
+ * HOW MUCH OF A PAGE A PICTURE HELD. `pictured` is the part of the page in
+ * the picture, from the top of what scrolls; left out, it is the window
+ * where the page was measured. A section is shown when any of it is in the
+ * picture; one wholly above or below is named as not shown.
+ */
+export function picturedCoverage(measure, pictured) {
+    const top = Math.max(0, pictured?.top ?? measure.top);
+    const bottom = Math.min(measure.height, top + (pictured?.height ?? measure.window));
+    const whole = top <= 0 && bottom >= measure.height - 1;
+    const above = measure.sections.filter((one) => one.bottom <= top);
+    const below = measure.sections.filter((one) => one.top >= bottom);
+    let said;
+    if (whole)
+        said = `The whole page is pictured (${px(measure.height)}px).`;
+    else {
+        const part = top <= 0 ? `First screen only (${px(bottom)} of ${px(measure.height)}px)` : `Only ${px(top)}–${px(bottom)} of ${px(measure.height)}px`;
+        const left = [...(above.length > 0 ? [`above it, ${names(above)}`] : []), ...(below.length > 0 ? [`${above.length > 0 ? "below it, " : ""}${names(below)}`] : [])];
+        said = left.length > 0 ? `${part}; not shown: ${left.join("; ")}.` : `${part}; no named section is wholly outside it.`;
+    }
+    return { whole, height: measure.height, pictured: { top, bottom }, above, below, said };
+}
+//# sourceMappingURL=pictured.js.map

package/dist/revisions/pictured.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pictured.js","sourceRoot":"","sources":["../../src/revisions/pictured.ts"],"names":[],"mappings":"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"}

package/dist/revisions/pinned-dates.d.ts

@@ -0,0 +1,30 @@
+/** One thing in a view's source that pins a day, and the sentence that says so. */
+export interface PinnedDate {
+    /** Where in the source: `source line 12`. */
+    readonly at: string;
+    /** The words as the source writes them: `TODAY = "2026-11-01"`, `Tomorrow · Mon 2 Nov`, `due Fri 30 Oct`. */
+    readonly phrase: string;
+    /** `today`, a date given to a name that means today; `day-words`, today's words beside a written date; `past`, a written date already gone by. */
+    readonly why: "today" | "day-words" | "past";
+    /** "Home may be out of date: it says “Tomorrow · Mon 2 Nov” and today is Wed, Nov 4. Read today from graview instead." */
+    readonly says: string;
+}
+export interface DatesPinnedOptions {
+    /** The app's today, `YYYY-MM-DD` (`store.today() ?? isoToday()`). */
+    readonly today: string;
+    /** What the view is called in the sentence: its place's title ("Home"). "This view" when unsaid. */
+    readonly title?: string;
+    /** The locale today is said in. The app's when unsaid. */
+    readonly locale?: string;
+    /** How many days back a written date counts as pinning today: 31 by default, so a founding year or a launch long gone is not one. */
+    readonly pastDays?: number;
+}
+/**
+ * WHAT IN A VIEW'S SOURCE PINS A DAY, each said against the app's today:
+ * a date given to a name that means today, today's words beside a written
+ * date ("Tomorrow · Mon 2 Nov"), and a written date that has gone by in the
+ * last month ("due Fri 30 Oct"). Empty for a view that reads today from
+ * `graview`.
+ */
+export declare function datesPinned(source: string, options: DatesPinnedOptions): readonly PinnedDate[];
+//# sourceMappingURL=pinned-dates.d.ts.map

package/dist/revisions/pinned-dates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pinned-dates.d.ts","sourceRoot":"","sources":["../../src/revisions/pinned-dates.ts"],"names":[],"mappings":"AAkBA,mFAAmF;AACnF,MAAM,WAAW,UAAU;IACzB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,6GAA6G;IAC7G,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,kJAAkJ;IAClJ,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,WAAW,GAAG,MAAM,CAAC;IAC7C,0HAA0H;IAC1H,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,qEAAqE;IACrE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,oGAAoG;IACpG,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,0DAA0D;IAC1D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,qIAAqI;IACrI,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAqDD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,SAAS,UAAU,EAAE,CA+C9F"}

package/dist/revisions/pinned-dates.js

@@ -0,0 +1,120 @@
+/*
+ * A VIEW THAT PINS TODAY (Roadmap f-views-know-today).
+ *
+ * A chat added records to a Cloud app, every act succeeded, and the app's
+ * home went on saying the day before: its view held `TODAY = "2026-11-01"`,
+ * "Tomorrow · Mon 2 Nov" and "due Fri 30 Oct" as written text. Nothing
+ * told the agent its home was now wrong, so it said it was done. This
+ * reads a view's source for what pins a day — a date given to a name that
+ * means today, day words beside a written date, and a written date already
+ * past — and says each in a sentence against the app's today, so a check,
+ * an act's answer and a headless run can carry it.
+ *
+ * Read from the source's text alone: a date the view works out from
+ * `graview.today` is never written in it, so it is never said.
+ */
+import { weekdayAsRead } from "../days.js";
+import { addDays } from "../wall-time.js";
+const WEEKDAY = String.raw `(?:Mon(?:day)?|Tue(?:s(?:day)?)?|Wed(?:nesday)?|Thu(?:r(?:s(?:day)?)?)?|Fri(?:day)?|Sat(?:urday)?|Sun(?:day)?)\.?`;
+const MONTHS = ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"];
+const MONTH = String.raw `(?:Jan(?:uary)?|Feb(?:ruary)?|Mar(?:ch)?|Apr(?:il)?|May|June?|July?|Aug(?:ust)?|Sept?(?:ember)?|Oct(?:ober)?|Nov(?:ember)?|Dec(?:ember)?)\.?`;
+const ORDINAL = String.raw `(?:st|nd|rd|th)?`;
+/** A written date: `2026-11-01`, `Mon 2 Nov`, `2 November 2026`, `Fri, Oct 30`, `Nov 2, 2026`. */
+const DATES = [
+    /\b(?<year>\d{4})-(?<month>\d{2})-(?<day>\d{2})\b/g,
+    new RegExp(String.raw `\b(?:${WEEKDAY},?\s+)?(?<day>\d{1,2})${ORDINAL}\s+(?<name>${MONTH})(?![a-z])(?:,?\s+(?<year>\d{4})\b)?`, "g"),
+    new RegExp(String.raw `\b(?:${WEEKDAY},?\s+)?(?<name>${MONTH})\s+(?<day>\d{1,2})${ORDINAL}(?!\d)\b(?:,?\s+(?<year>\d{4})\b)?`, "g"),
+];
+/** A name that means today: `TODAY`, `today`, `now`, `currentDay`, `CURRENT_DATE`. */
+const TODAY_NAME = /^(?:.*today.*|now|current_?(?:day|date))$/i;
+/** A date given to a name: `const TODAY = "2026-11-01"`, `today: "2026-11-01"`, `now = new Date("2026-11-01")`. */
+const ASSIGNED = /\b([A-Za-z_$][\w$]*)\s*[:=]\s*(?:new\s+Date\(\s*)?(["'`])(\d{4}-\d{2}-\d{2})[^"'`\n]*\2/g;
+const DAY_WORD = String.raw `(?:today|tomorrow|yesterday|tonight)`;
+const BETWEEN = String.raw `[\s·•|,:()\-–—]{1,5}`;
+/** The day a written date names, its year the one nearest today where it says none. */
+function dayOf(groups, today) {
+    const month = groups["month"] !== undefined ? Number(groups["month"]) : MONTHS.indexOf(groups["name"].slice(0, 3)) + 1;
+    const date = Number(groups["day"]);
+    if (!(month >= 1 && month <= 12 && date >= 1 && date <= 31))
+        return undefined;
+    const at = (year) => `${year}-${String(month).padStart(2, "0")}-${String(date).padStart(2, "0")}`;
+    if (groups["year"] !== undefined)
+        return at(Number(groups["year"]));
+    const year = Number(today.slice(0, 4));
+    const away = (day) => Math.abs(Date.parse(day) - Date.parse(today));
+    return [year - 1, year, year + 1].map(at).sort((a, b) => away(a) - away(b))[0];
+}
+function writtenDates(source, today) {
+    const out = [];
+    for (const pattern of DATES) {
+        for (const match of source.matchAll(pattern)) {
+            const from = match.index;
+            const to = from + match[0].length;
+            if (out.some((one) => from < one.to && to > one.from))
+                continue;
+            const day = dayOf(match.groups ?? {}, today);
+            if (day !== undefined && !Number.isNaN(Date.parse(day)))
+                out.push({ from, to, day });
+        }
+    }
+    return out.sort((a, b) => a.from - b.from);
+}
+const lineAt = (source, index) => `source line ${source.slice(0, index).split("\n").length}`;
+/**
+ * WHAT IN A VIEW'S SOURCE PINS A DAY, each said against the app's today:
+ * a date given to a name that means today, today's words beside a written
+ * date ("Tomorrow · Mon 2 Nov"), and a written date that has gone by in the
+ * last month ("due Fri 30 Oct"). Empty for a view that reads today from
+ * `graview`.
+ */
+export function datesPinned(source, options) {
+    if (typeof source !== "string" || !/^\d{4}-\d{2}-\d{2}$/.test(options.today))
+        return [];
+    const { today } = options;
+    const title = options.title?.trim() || "This view";
+    const todaySaid = weekdayAsRead(today, { weekday: "short", year: false }, options.locale);
+    const say = (phrase) => `${title} may be out of date: it says “${phrase}” and today is ${todaySaid}. Read today from graview instead.`;
+    const out = [];
+    const taken = (from, to) => out.some((one) => from < one.to && to > one.from);
+    for (const match of source.matchAll(ASSIGNED)) {
+        if (!TODAY_NAME.test(match[1]))
+            continue;
+        const phrase = `${match[1]} = "${match[3]}"`;
+        out.push({ at: lineAt(source, match.index), phrase, why: "today", says: say(phrase), from: match.index, to: match.index + match[0].length });
+    }
+    const before = new RegExp(String.raw `\b${DAY_WORD}${BETWEEN}$`, "i");
+    const after = new RegExp(String.raw `^${BETWEEN}${DAY_WORD}\b`, "i");
+    const leading = /\b(?:due|by|until|on)\s+$/i;
+    const oldest = addDays(today, -(options.pastDays ?? 31));
+    for (const date of writtenDates(source, today)) {
+        if (taken(date.from, date.to))
+            continue;
+        /* A day handed to graview.fromToday is said against today, whatever today is. */
+        if (/fromToday\(\s*["'`]$/.test(source.slice(Math.max(0, date.from - 24), date.from)))
+            continue;
+        const ahead = source.slice(Math.max(0, date.from - 16), date.from);
+        const behind = source.slice(date.to, date.to + 16);
+        const word = before.exec(ahead);
+        const wordAfter = after.exec(behind);
+        if (word || wordAfter) {
+            const from = word ? date.from - word[0].length : date.from;
+            const to = wordAfter ? date.to + wordAfter[0].length : date.to;
+            const phrase = source.slice(from, to).replace(/\s+/g, " ").trim();
+            out.push({ at: lineAt(source, from), phrase, why: "day-words", says: say(phrase), from, to });
+            continue;
+        }
+        if (date.day < today && date.day >= oldest) {
+            const lead = leading.exec(ahead);
+            const from = lead ? date.from - lead[0].length : date.from;
+            const phrase = source.slice(from, date.to).replace(/\s+/g, " ").trim();
+            out.push({ at: lineAt(source, from), phrase, why: "past", says: say(phrase), from, to: date.to });
+        }
+    }
+    /* Each phrase once, in the order the source says them. */
+    const seen = new Set();
+    return out
+        .sort((a, b) => a.from - b.from)
+        .filter((one) => !seen.has(one.phrase) && seen.add(one.phrase))
+        .map(({ at, phrase, why, says }) => ({ at, phrase, why, says }));
+}
+//# sourceMappingURL=pinned-dates.js.map

package/dist/revisions/pinned-dates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pinned-dates.js","sourceRoot":"","sources":["../../src/revisions/pinned-dates.ts"],"names":[],"mappings":"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"}

package/dist/revisions/problems.d.ts

@@ -0,0 +1,57 @@
+import type { InvariantDefinition, Violation } from "../invariants/types.js";
+/** A problem a view says: the view by name, where in it, and what it says (a headless run's `description.problems`). */
+export interface ViewProblem {
+    readonly view: string;
+    readonly at?: string;
+    readonly says: string;
+}
+/** What was judged at one moment: the rules' problems and the views'. */
+export interface ProblemSet {
+    readonly rules?: readonly Violation[];
+    readonly views?: readonly ViewProblem[];
+}
+/** A problem one side has and the other does not. */
+export type ChangedProblem = {
+    readonly key: string;
+    readonly kind: "rule";
+    readonly rule: string;
+    /** The record it is about, where it is about one. */
+    readonly subject?: string;
+    readonly says: string;
+    /** The act the rule names to repair it, first; `missing` is what its caller still chooses. */
+    readonly repair?: {
+        readonly act: string;
+        readonly label: string;
+        readonly args?: Readonly<Record<string, unknown>>;
+        readonly missing?: readonly string[];
+    };
+    readonly violation: Violation;
+} | {
+    readonly key: string;
+    readonly kind: "view";
+    readonly view: string;
+    readonly at?: string;
+    readonly says: string;
+};
+/** What a change broke and mended, as entries and in words. */
+export interface ProblemsMade {
+    /** Problems after it that were not before: rules that held and fail, and view problems new after. */
+    readonly made: readonly ChangedProblem[];
+    /** Problems before it that are not after. */
+    readonly mended: readonly ChangedProblem[];
+    readonly said: readonly string[];
+    /** "This change broke: …", or that it broke nothing. */
+    readonly text: string;
+}
+/** A view problem's key: its view, where, and its words. */
+export declare const viewProblemKey: (problem: ViewProblem) => string;
+/**
+ * WHAT A CHANGE BROKE: the problems after it that were not before, and
+ * those it mended. `rules` are the app's rules, so a rule written in the
+ * rule language is one problem whether or not its words were loaded
+ * (`shapedRules`); without them, a problem is known by its words.
+ */
+export declare function problemsMade(before: ProblemSet, after: ProblemSet, options?: {
+    readonly rules?: readonly Pick<InvariantDefinition, "name" | "shape">[];
+}): ProblemsMade;
+//# sourceMappingURL=problems.d.ts.map

package/dist/revisions/problems.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"problems.d.ts","sourceRoot":"","sources":["../../src/revisions/problems.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,mBAAmB,EAAU,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAGrF,wHAAwH;AACxH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,yEAAyE;AACzE,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;IACtC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;CACzC;AAED,qDAAqD;AACrD,MAAM,MAAM,cAAc,GACtB;IACE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qDAAqD;IACrD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8FAA8F;IAC9F,QAAQ,CAAC,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAC;IAC5J,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;CAC/B,GACD;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAExH,+DAA+D;AAC/D,MAAM,WAAW,YAAY;IAC3B,qGAAqG;IACrG,QAAQ,CAAC,IAAI,EAAE,SAAS,cAAc,EAAE,CAAC;IACzC,6CAA6C;IAC7C,QAAQ,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,CAAC;IAC3C,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,wDAAwD;IACxD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,4DAA4D;AAC5D,eAAO,MAAM,cAAc,GAAI,SAAS,WAAW,KAAG,MAAoE,CAAC;AAkB3H;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,GAAE;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,IAAI,CAAC,mBAAmB,EAAE,MAAM,GAAG,OAAO,CAAC,EAAE,CAAA;CAAO,GAAG,YAAY,CAa3K"}

package/dist/revisions/problems.js

@@ -0,0 +1,51 @@
+/*
+ * THE PROBLEMS A CHANGE MADE (Roadmap f-revisions-say-what-broke).
+ *
+ * An act, a batch or a proposed view can break what held: a rule that held
+ * before fails after, a view says a problem it did not. A host that judged
+ * the app before and after a change — the store's `violations()`, a
+ * headless run's problems — hands both sets here and is told what is new,
+ * each keyed as it will be keyed next time (a rule's problem by
+ * `violationKey`, a view's by its view, where and words), in words, and with
+ * the act a rule names to repair it, so an answer can carry "this change
+ * broke: …" and how to mend it rather than leave it to a later look.
+ */
+import { problemWords } from "../invariants/line.js";
+import { problemsMoved, violationKey, shapedRules } from "../store.js";
+/** A view problem's key: its view, where, and its words. */
+export const viewProblemKey = (problem) => `view:${problem.view}|${problem.at ?? ""}|${problem.says}`;
+/** Only a rule that judged and failed is broken: one that could not judge (`could-not-judge`, `over-budget`) is not said as made. */
+const failed = (v) => v.status === undefined || v.status === "violated";
+const repairOf = (repair) => repair ? { repair: { act: repair.mutation, label: repair.label, ...(repair.args ? { args: repair.args } : {}), ...(repair.missing && repair.missing.length > 0 ? { missing: repair.missing } : {}) } } : {};
+function ruleEntry(v, shaped) {
+    return { key: violationKey(v, shaped), kind: "rule", rule: v.invariant, ...(v.subjectId ? { subject: v.subjectId } : {}), says: problemWords(v), ...repairOf(v.repairs[0]), violation: v };
+}
+function sayProblem(problem) {
+    if (problem.kind === "view")
+        return `the view "${problem.view}"${problem.at ? ` at ${problem.at}` : ""} says: ${problem.says.replace(/[.\s]+$/, "")}`;
+    const repair = problem.repair ? ` (repair: ${problem.repair.act}${problem.repair.missing ? `, choosing ${problem.repair.missing.join(", ")}` : ""} — ${problem.repair.label})` : "";
+    return `${problem.says.replace(/[.\s]+$/, "")}${repair}`;
+}
+/**
+ * WHAT A CHANGE BROKE: the problems after it that were not before, and
+ * those it mended. `rules` are the app's rules, so a rule written in the
+ * rule language is one problem whether or not its words were loaded
+ * (`shapedRules`); without them, a problem is known by its words.
+ */
+export function problemsMade(before, after, options = {}) {
+    const rules = options.rules ?? [];
+    const shaped = shapedRules(rules);
+    const moved = problemsMoved(rules, (before.rules ?? []).filter(failed), (after.rules ?? []).filter(failed));
+    const viewsBefore = new Set((before.views ?? []).map(viewProblemKey));
+    const viewsAfter = new Set((after.views ?? []).map(viewProblemKey));
+    const viewEntry = (problem) => ({ key: viewProblemKey(problem), kind: "view", view: problem.view, ...(problem.at ? { at: problem.at } : {}), says: problem.says });
+    const made = [...moved.introduces.map((v) => ruleEntry(v, shaped)), ...(after.views ?? []).filter((one) => !viewsBefore.has(viewProblemKey(one))).map(viewEntry)];
+    const mended = [...moved.resolves.map((v) => ruleEntry(v, shaped)), ...(before.views ?? []).filter((one) => !viewsAfter.has(viewProblemKey(one))).map(viewEntry)];
+    const said = [];
+    if (made.length > 0)
+        said.push(`This change broke ${made.length === 1 ? "one thing that held" : `${made.length} things that held`}: ${made.map(sayProblem).join("; ")}. Fix ${made.length === 1 ? "it" : "them"} before going on.`);
+    if (mended.length > 0)
+        said.push(`It mended ${mended.length === 1 ? "one problem" : `${mended.length} problems`}: ${mended.map(sayProblem).join("; ")}.`);
+    return { made, mended, said, text: made.length > 0 ? said.join(" ") : `This change broke nothing that held.${mended.length > 0 ? ` ${said.join(" ")}` : ""}` };
+}
+//# sourceMappingURL=problems.js.map

package/dist/revisions/problems.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"problems.js","sourceRoot":"","sources":["../../src/revisions/problems.ts"],"names":[],"mappings":"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"}

package/dist/revisions/sections.d.ts

@@ -0,0 +1,18 @@
+/** Anything that reads like an element: a DOM `Element`, or a headless run's `TreeElement`. */
+export interface ElementLike {
+    readonly localName?: string;
+    readonly nodeType?: number;
+    getAttribute(name: string): string | null;
+    readonly childNodes: ArrayLike<unknown>;
+    readonly textContent: string | null;
+}
+/** One section of a drawing: what a person would call it, and what it is (`heading`, `section`, `nav` …). */
+export interface DrawnSection {
+    readonly name: string;
+    readonly as: string;
+}
+/** Every element under `root`, `root` first, in document order. */
+export declare function elementsOf(root: ElementLike): Generator<ElementLike>;
+/** The sections a drawing has, each once by name, in document order. */
+export declare function sectionsOfDrawing(root: ElementLike): DrawnSection[];
+//# sourceMappingURL=sections.d.ts.map

package/dist/revisions/sections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sections.d.ts","sourceRoot":"","sources":["../../src/revisions/sections.ts"],"names":[],"mappings":"AAcA,+FAA+F;AAC/F,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAED,6GAA6G;AAC7G,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAwBD,mEAAmE;AACnE,wBAAiB,UAAU,CAAC,IAAI,EAAE,WAAW,GAAG,SAAS,CAAC,WAAW,CAAC,CAGrE;AAYD,wEAAwE;AACxE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,YAAY,EAAE,CAmCnE"}