@graview/core 0.1.64 → 0.1.66

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/touched.d.ts

@@ -0,0 +1,59 @@
+import type { GraviewApp } from "../app.js";
+import type { Primitive } from "../graph/primitives.js";
+import type { AnySchema } from "../schema/schema.js";
+import { type PinnedDate } from "./pinned-dates.js";
+/** A view the host keeps, as its manifest says it, and its source where the host has it. */
+export interface TouchedView {
+    readonly name: string;
+    readonly title?: string;
+    /** The kind it is a picture of, or "home". */
+    readonly attach: string;
+    readonly cardinality?: "one" | "many";
+    readonly hidden?: boolean;
+    /** The other kinds it is handed (its manifest's `reads.kinds`). */
+    readonly reads?: {
+        readonly kinds?: readonly string[];
+    };
+    /** Its script, read for a day it pins. */
+    readonly source?: string;
+}
+export interface PlacesTouchedOptions {
+    /** A record's kind by its id, for an op that names a record without carrying it (a field changed, a link made): `(id) => store.graph.getNode(id)?.kind`. */
+    readonly kindOf?: (id: string) => string | undefined;
+    /** The views the host keeps. */
+    readonly views?: readonly TouchedView[];
+    /** The app's today (`store.today() ?? isoToday()`): with it, a view's source is read for a day it pins. */
+    readonly today?: string;
+    readonly locale?: string;
+}
+/** A place that draws a record a change touched. */
+export interface TouchedPlace {
+    readonly slug: string;
+    readonly title: string;
+    readonly address: string;
+    /** The kinds of the touched records it draws. */
+    readonly kinds: readonly string[];
+    /** The host's view that draws it, by name, when a script view does: what to look at after the change. */
+    readonly view?: string;
+    /** What that view's source pins a day to, each in a sentence. */
+    readonly pinned?: readonly PinnedDate[];
+}
+export interface PlacesTouched {
+    /** The kinds of the records the ops touched. */
+    readonly kinds: readonly string[];
+    readonly places: readonly TouchedPlace[];
+    readonly said: readonly string[];
+    /** "These appear on Home and Tasks. Home is drawn by a view (front): look at it after this change." */
+    readonly text: string;
+}
+/**
+ * THE PLACES THAT DRAW WHAT A COMMIT TOUCHED: given its ops (`Operation`s,
+ * or anything with their `primitives`), each place of the app — the home,
+ * a lens, a kind's list, a view the host keeps — that draws a record of a
+ * kind it made, changed, removed or linked, in the app's order, with the
+ * view that draws it and what that view pins a day to.
+ */
+export declare function placesTouched<S extends AnySchema>(app: GraviewApp<S>, ops: readonly {
+    readonly primitives: readonly Primitive[];
+}[], options?: PlacesTouchedOptions): PlacesTouched;
+//# sourceMappingURL=touched.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"touched.d.ts","sourceRoot":"","sources":["../../src/revisions/touched.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEjE,4FAA4F;AAC5F,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,8CAA8C;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACtC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,mEAAmE;IACnE,QAAQ,CAAC,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAC;IACxD,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,4JAA4J;IAC5J,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IACrD,gCAAgC;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IACxC,2GAA2G;IAC3G,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,oDAAoD;AACpD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,iDAAiD;IACjD,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,yGAAyG;IACzG,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,iEAAiE;IACjE,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;CACzC;AAED,MAAM,WAAW,aAAa;IAC5B,gDAAgD;IAChD,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,CAAC;IACzC,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,uGAAuG;IACvG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AA2BD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,SAAS,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,SAAS;IAAE,QAAQ,CAAC,UAAU,EAAE,SAAS,SAAS,EAAE,CAAA;CAAE,EAAE,EAAE,OAAO,GAAE,oBAAyB,GAAG,aAAa,CA+BvL"}

package/dist/revisions/touched.js

@@ -0,0 +1,72 @@
+import { placesOf } from "../app-places.js";
+import { HOME_SLUG, OVERVIEW_SLUG } from "../places.js";
+import { datesPinned } from "./pinned-dates.js";
+const andList = (items) => (items.length <= 1 ? items.join("") : `${items.slice(0, -1).join(", ")} and ${items.at(-1)}`);
+/** The kinds of the records a commit's primitives touch: a record made, changed or removed, and both ends of a link. */
+function kindsTouched(ops, kindOf) {
+    const kinds = new Set();
+    const add = (kind) => kind !== undefined && kinds.add(kind);
+    for (const op of ops) {
+        for (const one of op.primitives ?? []) {
+            if (one.op === "add-node" || one.op === "remove-node")
+                add(one.node.kind);
+            else if (one.op === "patch-node" || one.op === "splice-text")
+                add(kindOf(one.id));
+            else if (one.op === "add-edge" || one.op === "remove-edge") {
+                add(kindOf(one.edge.from));
+                add(kindOf(one.edge.to));
+            }
+        }
+    }
+    return [...kinds];
+}
+/** The kinds a declared home's blocks list (`all('task')`), read from their text. */
+function kindsOfDeclaredHome(home, kinds) {
+    const text = JSON.stringify(home ?? null);
+    return kinds.filter((kind) => new RegExp(`['"]${kind.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}\\\\?['"]`).test(text));
+}
+/**
+ * THE PLACES THAT DRAW WHAT A COMMIT TOUCHED: given its ops (`Operation`s,
+ * or anything with their `primitives`), each place of the app — the home,
+ * a lens, a kind's list, a view the host keeps — that draws a record of a
+ * kind it made, changed, removed or linked, in the app's order, with the
+ * view that draws it and what that view pins a day to.
+ */
+export function placesTouched(app, ops, options = {}) {
+    const kinds = kindsTouched(ops, options.kindOf ?? (() => undefined));
+    const views = options.views ?? [];
+    const declared = app.schema.kinds;
+    const pinnedBy = (view, title) => view?.source !== undefined && options.today !== undefined ? datesPinned(view.source, { today: options.today, title, ...(options.locale ? { locale: options.locale } : {}) }) : [];
+    const places = [];
+    for (const place of placesOf(app, { views })) {
+        if (place.slug === OVERVIEW_SLUG)
+            continue;
+        let drawn;
+        let view;
+        if (place.slug === HOME_SLUG) {
+            view = views.find((one) => one.attach === "home");
+            drawn = view ? (view.reads?.kinds ?? []) : (app.home?.length ?? 0) > 0 ? kindsOfDeclaredHome(app.home, declared) : declared.filter((kind) => !(app.pages?.hide ?? []).includes(kind));
+        }
+        else {
+            view = place.view !== undefined ? views.find((one) => one.name === place.view) : undefined;
+            drawn = [...(place.over ?? (place.kind ? [place.kind] : [])), ...(view?.reads?.kinds ?? [])];
+        }
+        const touched = kinds.filter((kind) => drawn.includes(kind));
+        if (touched.length === 0)
+            continue;
+        const pinned = pinnedBy(view, place.title);
+        places.push({ slug: place.slug, title: place.title, address: place.address, kinds: touched, ...(view ? { view: view.name } : {}), ...(pinned.length > 0 ? { pinned } : {}) });
+    }
+    const said = [];
+    if (places.length > 0)
+        said.push(`These appear on ${andList(places.map((place) => place.title))}.`);
+    for (const place of places) {
+        if (!place.view)
+            continue;
+        said.push(place.pinned ? `${place.title} is drawn by a view (${place.view}) that writes its own dates: look at it after this change.` : `${place.title} is drawn by a view (${place.view}): look at it after this change.`);
+        for (const one of place.pinned ?? [])
+            said.push(one.says);
+    }
+    return { kinds, places, said, text: said.length > 0 ? said.join(" ") : "Nothing this change touched is drawn on a place of this app." };
+}
+//# sourceMappingURL=touched.js.map

package/dist/revisions/touched.js.map

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