@graview/core 0.1.63 → 0.1.65

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":"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"}

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":"AA6CA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAkDhC,CAAC;AAEN,MAAM,UAAU,GAAG,CAAC,CAAC;AACrB,MAAM,EAAE,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;AAChE,MAAM,KAAK,GAAG,CAAC,QAAkC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,MAAM,IAAI,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,QAAQ,CAAC,MAAM,GAAG,UAAU,OAAO,CAAC,CAAC;AAEnP;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAoB,EAAE,QAA4D;IACjH,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC;IACtD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,QAAQ,EAAE,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IACpF,MAAM,KAAK,GAAG,GAAG,IAAI,CAAC,IAAI,MAAM,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC;IAClE,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,IAAI,MAAM,CAAC,CAAC;IAClE,IAAI,IAAY,CAAC;IACjB,IAAI,KAAK;QAAE,IAAI,GAAG,+BAA+B,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC;SACrE,CAAC;QACJ,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,sBAAsB,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;QACpJ,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACnK,IAAI,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,gBAAgB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,0CAA0C,CAAC;IACzH,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC1F,CAAC"}

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"}

package/dist/revisions/sections.js

@@ -0,0 +1,91 @@
+/*
+ * THE SECTIONS OF A DRAWING, BY NAME (Roadmap f-revisions-say-what-broke).
+ *
+ * What a person would call a part of a page: a heading's words, and a
+ * landmark — a `<section>` or a `role="region"` named by its `aria-label`,
+ * its `aria-labelledby` or its own first heading; a `<nav>`, a `<main>`, a
+ * header, a footer or an aside, by its name or by what it is. A worker
+ * view's host draws a landmark's element as a `<div>` that says what it was
+ * asked to be (`data-graview-as`), and that is read as the landmark.
+ *
+ * Read from anything shaped like an element — a page's DOM, a headless
+ * run's tree (`@graview/guest/headless`) — and nothing is laid out here.
+ */
+const HEADING = /^h([1-6])$/;
+/** The landmarks a page is read by, and what one with no name of its own is called. */
+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 isElement = (node) => typeof node === "object" && node !== null && typeof node.getAttribute === "function" && (node.nodeType === undefined || node.nodeType === 1);
+const said = (text) => (text ?? "").replace(/\s+/g, " ").trim();
+/** Every element under `root`, `root` first, in document order. */
+export function* elementsOf(root) {
+    yield root;
+    for (const child of Array.from(root.childNodes))
+        if (isElement(child))
+            yield* elementsOf(child);
+}
+/** What an element is asked to be: the landmark a host drew as a `<div>`, else its own name. */
+const tagOf = (element) => (element.getAttribute("data-graview-as") ?? element.localName ?? "").toLowerCase();
+/** The heading level an element is, if it is one. */
+function headingLevel(element) {
+    const tag = HEADING.exec(tagOf(element));
+    if (tag)
+        return Number(tag[1]);
+    return element.getAttribute("role") === "heading" ? Number(element.getAttribute("aria-level") ?? 2) : undefined;
+}
+/** The sections a drawing has, each once by name, in document order. */
+export function sectionsOfDrawing(root) {
+    const all = [...elementsOf(root)];
+    const byId = new Map();
+    for (const element of all) {
+        const id = element.getAttribute("id");
+        if (id)
+            byId.set(id, element);
+    }
+    const out = [];
+    const seen = new Set();
+    const add = (name, as) => {
+        const key = name.toLowerCase();
+        if (!name || seen.has(key))
+            return;
+        seen.add(key);
+        out.push({ name: name.length > 80 ? `${name.slice(0, 79)}…` : name, as });
+    };
+    for (const element of all) {
+        if (element.getAttribute("aria-hidden") === "true" || element.getAttribute("hidden") !== null)
+            continue;
+        const level = headingLevel(element);
+        if (level !== undefined) {
+            add(said(element.textContent), "heading");
+            continue;
+        }
+        const tag = tagOf(element);
+        const role = (element.getAttribute("role") ?? "").toLowerCase();
+        const what = role in LANDMARKS ? role : tag in LANDMARKS ? tag : undefined;
+        if (!what)
+            continue;
+        const namedBy = (element.getAttribute("aria-labelledby") ?? "")
+            .split(/\s+/)
+            .flatMap((id) => (byId.get(id) ? [said(byId.get(id).textContent)] : []))
+            .join(" ");
+        const heading = [...elementsOf(element)].find((one) => one !== element && headingLevel(one) !== undefined);
+        const name = said(element.getAttribute("aria-label")) || namedBy || (heading ? said(heading.textContent) : "") || LANDMARKS[what] || "";
+        add(name, what === "region" ? "section" : what);
+    }
+    return out;
+}
+//# sourceMappingURL=sections.js.map

package/dist/revisions/sections.js.map

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

package/dist/revisions/view.d.ts

@@ -0,0 +1,71 @@
+import { type DrawnSection, type ElementLike } from "./sections.js";
+/** One side of a revision: the view's source, and what a run of it drew where the host has it. */
+export interface ViewRevisionSide {
+    /** The view's whole source. */
+    readonly source: string;
+    /** The stylesheet it drew with (`HeadlessDescribed.css`, or the page's): read from the source's strings when left out. */
+    readonly css?: string;
+    /** What it drew (`HeadlessDescribed.drawing.root`, or a page's element): its classes and sections are read from it. */
+    readonly drawing?: ElementLike;
+    /** The classes its drawing uses, where the host has a list and no tree. */
+    readonly classes?: readonly string[];
+    /** How tall the page it is drawn on is, in CSS pixels, where the host measured it. */
+    readonly height?: number;
+}
+/** A class the revision still draws that a rule styled before and none styles now. */
+export interface UnstyledClass {
+    readonly class: string;
+    /** The selectors that styled it before. */
+    readonly styledBy: readonly string[];
+}
+/** A selector the revision took out, while the markup it matched is still drawn. */
+export interface RemovedSelector {
+    readonly selector: string;
+    /** The classes (`.name`) and ids (`#name`) in it, each still drawn. */
+    readonly names: readonly string[];
+}
+export interface HeightChange {
+    readonly before: number;
+    readonly after: number;
+    /** `after - before`, in CSS pixels. */
+    readonly change: number;
+    /** The change as a part of `before`: -0.5 is half as tall. */
+    readonly ratio: number;
+}
+/** What a revision broke, as entries and in words. */
+export interface ViewRevision {
+    /** True when anything below was found; a height that moved less than a tenth is not. */
+    readonly regressed: boolean;
+    readonly unstyled: readonly UnstyledClass[];
+    readonly selectorsRemoved: readonly RemovedSelector[];
+    /** Sections drawn before and not now, by name. */
+    readonly sectionsMissing: readonly DrawnSection[];
+    readonly height?: HeightChange;
+    /** Where each side was read from: its drawing and stylesheet, or its source alone. */
+    readonly read: {
+        readonly before: "drawing" | "source";
+        readonly after: "drawing" | "source";
+    };
+    /** One sentence per finding. */
+    readonly said: readonly string[];
+    /** The sentences together, or one saying nothing was lost. */
+    readonly text: string;
+}
+/**
+ * THE STRINGS A SCRIPT SAYS: each quoted string and template's text, an
+ * interpolation left as a hole. Comments and regular expressions are passed
+ * over; nothing is run.
+ */
+export declare function stringsOfSource(source: string): string[];
+/** Every style rule's selector in a stylesheet, each once, in order. A keyframe's steps and a font's face are not selectors. */
+export declare function selectorsOfStylesheet(css: string): string[];
+/** The classes and ids a selector names, as `.name` and `#name`; what is inside `[…]` and strings is not read. */
+export declare function namesInSelector(selector: string): string[];
+/**
+ * WHAT A REVISION OF A VIEW BROKE, against the version it replaces: the
+ * classes it still draws that lost every rule styling them, the selectors
+ * taken out while the markup they matched is still drawn, the sections
+ * drawn before and not now, and how the page's height moved.
+ */
+export declare function compareViewRevision(before: ViewRevisionSide, after: ViewRevisionSide): ViewRevision;
+//# sourceMappingURL=view.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../../src/revisions/view.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAiC,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAEnG,kGAAkG;AAClG,MAAM,WAAW,gBAAgB;IAC/B,+BAA+B;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,0HAA0H;IAC1H,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,uHAAuH;IACvH,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC;IAC/B,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,sFAAsF;IACtF,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,sFAAsF;AACtF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,2CAA2C;IAC3C,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,oFAAoF;AACpF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,uEAAuE;IACvE,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,uCAAuC;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,8DAA8D;IAC9D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,sDAAsD;AACtD,MAAM,WAAW,YAAY;IAC3B,wFAAwF;IACxF,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;IAC5C,QAAQ,CAAC,gBAAgB,EAAE,SAAS,eAAe,EAAE,CAAC;IACtD,kDAAkD;IAClD,QAAQ,CAAC,eAAe,EAAE,SAAS,YAAY,EAAE,CAAC;IAClD,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC;IAC/B,sFAAsF;IACtF,QAAQ,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ,CAAA;KAAE,CAAC;IAC/F,gCAAgC;IAChC,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAKD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAoFxD;AA8BD,gIAAgI;AAChI,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAwD3D;AAED,kHAAkH;AAClH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAG1D;AA6DD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,EAAE,KAAK,EAAE,gBAAgB,GAAG,YAAY,CAgDnG"}