@graview/core 0.1.28 → 0.1.29

package/README.md

@@ -93,6 +93,12 @@ Everything a Graview app declares, and the checker that verifies it.
   (`readonly`, refused here with their `because`), links seeded from a
   version field, and transports for Google Calendar and for a tool server
   over MCP (`mcpClient`, `mcpDoor`, `doorClient`, `mcpRemote`).
+- **A spreadsheet brought in** — `@graview/core/import`: `importRows(store,
+  kind, rows, mapping, { by })` reads each cell by its field's type, links a
+  cell to a record by its name, keeps every row that fits as one undoable
+  batch `via: "import"`, and says each refused row in words;
+  `previewImport` keeps nothing, `proposeMapping` offers a mapping from the
+  header row, and `parseCsv` reads a CSV or a paste (`docs/import.md`).
 - **The city** — `@graview/core/scene`: `sceneThumbnail` draws a document
   (or an app) as the Scene draws it from altitude — the same districts on
   the same map, in their hues — as one SVG string, with no DOM, for a host
@@ -106,6 +112,17 @@ Everything a Graview app declares, and the checker that verifies it.
   district on its block in its hue with one block on it, readable at 16
   pixels and about a kilobyte — a standalone SVG to serve as a favicon. A kind's
   figures are `@graview/core/figures`.
+- **What is said, matched and listed after a page draws** (FR-179) —
+  `@graview/core/search`: the one matcher (`search`, `actsOn`,
+  `touchWeights`, `parseQuery`, `matchNode`), fetched when somebody first
+  searches. `@graview/core/words`: a record read as a person reads it
+  (`readableFields`, `pageSections`, `isLongText`, `describeNode`,
+  `tellApart`), what an argument asks for (`argShape`, `describeArg`), an
+  argument and a refusal in the record's words (`argumentWords`,
+  `failureWords`) and `viaSaid`. `@graview/core/seat`: an act's answer as
+  its seat may see it (`answerSeenBy`), every place an app has (`placesOf`,
+  `placesFrom`) and the order things are made in (`beginning`). Judging the
+  arrangement (`arrangementFindings`) is `@graview/core/check`'s.
 - **What a page loads first** — `@graview/core` and `@graview/core/document`
   hold only what a page draws with. The checker, the city, the figures and
   the block resolver are on the subpaths above because a bundler places a

package/dist/amount-input.d.ts

@@ -0,0 +1,21 @@
+import type { AmountMark } from "./schema/amount-mark.js";
+/** What a box for an amount shows: the symbol before it, the unit after it, and what the empty box suggests. */
+export interface AmountBox {
+    readonly prefix?: string;
+    readonly suffix?: string;
+    readonly placeholder: string;
+    /** The amount in words, for a label a screen reader reads: "in US dollars", "as a percent". */
+    readonly hint: string;
+}
+/** The box an amount is typed into: "$" before "1,250.00", "%" after "15", "min" after "90". */
+export declare function amountBox(mark: AmountMark): AmountBox;
+/** The text a held amount is edited as: "1,250.50" for $1,250.50, "15" for 15%, "1 h 30 min" for ninety minutes. */
+export declare function amountInBox(value: number | undefined, mark: AmountMark): string;
+/**
+ * THE NUMBER A PERSON'S TEXT MEANS for an amount: "$1,250.50" is 1250.5;
+ * "15%" of a percent is 0.15.
+ * Its currency's symbol or code, spaces and group separators are let be;
+ * `undefined` where it is no number at all, for the form to say so.
+ */
+export declare function readAmount(text: string, mark: AmountMark | undefined): number | undefined;
+//# sourceMappingURL=amount-input.d.ts.map

package/dist/amount-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"amount-input.d.ts","sourceRoot":"","sources":["../src/amount-input.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAY1D,gHAAgH;AAChH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,+FAA+F;IAC/F,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAmBD,gGAAgG;AAChG,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,CASrD;AAED,oHAAoH;AACpH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CAK/E;AAyBD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAczF"}

package/dist/amount-input.js

@@ -0,0 +1,96 @@
+import { localeFor, numberAsRead } from "./days.js";
+const currencyParts = (mark) => {
+    if (!mark.currency)
+        return { before: true };
+    try {
+        const locale = localeFor(mark.locale);
+        const parts = new Intl.NumberFormat(locale, { style: "currency", currency: mark.currency }).formatToParts(1);
+        const at = parts.findIndex((part) => part.type === "currency");
+        const integer = parts.findIndex((part) => part.type === "integer");
+        let name;
+        try {
+            name = new Intl.DisplayNames([locale], { type: "currency" }).of(mark.currency);
+        }
+        catch { }
+        return { ...(at >= 0 ? { symbol: parts[at].value } : {}), before: at < integer, ...(name ? { name } : {}) };
+    }
+    catch {
+        return { symbol: mark.currency, before: true };
+    }
+};
+/** The box an amount is typed into: "$" before "1,250.00", "%" after "15", "min" after "90". */
+export function amountBox(mark) {
+    const locale = mark.locale;
+    if (mark.format === "money") {
+        const { symbol, before, name } = currencyParts(mark);
+        const placeholder = numberAsRead(1250, locale, { minimumFractionDigits: 2, maximumFractionDigits: 2 });
+        return { ...(symbol ? (before ? { prefix: symbol } : { suffix: symbol }) : {}), placeholder, hint: name ? `in ${name}` : mark.currency ? `in ${mark.currency}` : "an amount of money" };
+    }
+    if (mark.format === "percent")
+        return { suffix: "%", placeholder: numberAsRead(15, locale), hint: "as a percent" };
+    return { ...(mark.unit ? { suffix: mark.unit } : {}), placeholder: "", hint: mark.unit ? `in ${mark.unit}` : "a number" };
+}
+/** The text a held amount is edited as: "1,250.50" for $1,250.50, "15" for 15%, "1 h 30 min" for ninety minutes. */
+export function amountInBox(value, mark) {
+    if (value === undefined || !Number.isFinite(value))
+        return "";
+    if (mark.format === "money")
+        return numberAsRead(value, mark.locale, Number.isInteger(value) ? { maximumFractionDigits: 0 } : { minimumFractionDigits: 2, maximumFractionDigits: 2 });
+    if (mark.format === "percent")
+        return numberAsRead(value * 100, mark.locale, { maximumFractionDigits: 4 });
+    return numberAsRead(value, mark.locale, { maximumFractionDigits: 6 });
+}
+/** The separators a locale writes numbers with: "," and "." in en-US, "." and "," in de-DE. */
+function separators(locale) {
+    try {
+        const parts = new Intl.NumberFormat(localeFor(locale)).formatToParts(12345.6);
+        return { group: parts.find((part) => part.type === "group")?.value ?? ",", decimal: parts.find((part) => part.type === "decimal")?.value ?? "." };
+    }
+    catch {
+        return { group: ",", decimal: "." };
+    }
+}
+/** A plain number in a person's writing, in a locale: "1,250.50", "1.250,50", "1 250,5", "-3". */
+function plainNumber(text, locale) {
+    const { group, decimal } = separators(locale);
+    let t = text.replace(/[\s  ']/g, "").replace(/[−–]/g, "-");
+    // A decimal point where the locale writes a comma, typed as most keyboards do ("12.5" in de-DE), is read as a point.
+    if (decimal !== "." && !t.includes(decimal) && /^-?\d+\.\d{1,2}$/.test(t))
+        return Number(t);
+    if (group)
+        t = t.split(group).join("");
+    if (decimal !== ".")
+        t = t.replace(decimal, ".");
+    if (!/^-?(\d+\.?\d*|\.\d+)$/.test(t))
+        return undefined;
+    const n = Number(t);
+    return Number.isFinite(n) ? n : undefined;
+}
+/**
+ * THE NUMBER A PERSON'S TEXT MEANS for an amount: "$1,250.50" is 1250.5;
+ * "15%" of a percent is 0.15.
+ * Its currency's symbol or code, spaces and group separators are let be;
+ * `undefined` where it is no number at all, for the form to say so.
+ */
+export function readAmount(text, mark) {
+    const raw = text.trim();
+    if (raw === "")
+        return undefined;
+    const symbol = mark?.format === "money" && mark.currency ? currencyParts(mark).symbol : undefined;
+    let t = raw;
+    if (symbol)
+        t = t.split(symbol).join("");
+    if (mark?.currency)
+        t = t.replace(new RegExp(mark.currency, "gi"), "");
+    t = t.replace(/^[$€£¥₹]|[$€£¥₹]$/g, "");
+    const percent = /%\s*$/.test(t);
+    if (percent)
+        t = t.replace(/%\s*$/, "");
+    if (mark?.unit && mark.format !== "money")
+        t = t.replace(new RegExp(`\\s*${mark.unit.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}\\s*$`), "");
+    const n = plainNumber(t, mark?.locale);
+    if (n === undefined)
+        return undefined;
+    return mark?.format === "percent" ? n / 100 : n;
+}
+//# sourceMappingURL=amount-input.js.map

package/dist/amount-input.js.map

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

package/dist/answer-seen.d.ts

@@ -0,0 +1,38 @@
+import type { GraphDiff } from "./graph/diff.js";
+import type { Primitive } from "./graph/primitives.js";
+import type { GraphNodeBase } from "./graph/types.js";
+import type { InvariantDefinition, Violation } from "./invariants/types.js";
+import type { Operation } from "./ops/types.js";
+import type { Principal } from "./permissions/types.js";
+import type { AnySchema } from "./schema/schema.js";
+import { type Judged } from "./seen.js";
+import type { Store } from "./store.js";
+/**
+ * A CHANGE'S ANSWER AS ONE SEAT MAY BE TOLD IT (FR-55) — the diff, the
+ * primitives, the ops and the rules it would break or mend of a preview,
+ * an apply or an undo, for a surface that hands a seat what its own act
+ * did: an act may touch what its own seat may not see. Records and edges
+ * it is not served go, a field naming one it may not see is cleared as
+ * the view clears it, the ops are redacted as its log is, and a sentence
+ * that names what it may not see says only that a change it cannot see
+ * happened. With nothing kept from the seat, the answer as it is.
+ */
+export declare function answerSeenBy<A extends {
+    readonly diff?: GraphDiff<GraphNodeBase>;
+    readonly primitives?: readonly unknown[];
+    readonly reads?: readonly string[];
+    readonly writes?: readonly string[];
+    readonly intent?: string;
+    readonly introduces?: readonly Violation[];
+    readonly resolves?: readonly Violation[];
+    readonly violationsAfter?: readonly Violation[];
+    readonly ops?: readonly Operation[];
+}>(store: Judged & {
+    allInvariants(): readonly InvariantDefinition[];
+}, principal: Principal, answer: A): A;
+/** A change's problems as a seat judges them over its own world: `@graview/core/lines` hands it over as it loads. */
+type SeatJudged = (store: Store<AnySchema>, seat: Store<AnySchema>, made: boolean, served: readonly Primitive[]) => Record<"introduces" | "resolves" | "violationsAfter", Violation[]>;
+/** Hands `answerSeenBy` what judges a change's problems over a seat's world. */
+export declare const answersJudgedWith: (judge: SeatJudged) => void;
+export {};
+//# sourceMappingURL=answer-seen.d.ts.map

package/dist/answer-seen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"answer-seen.d.ts","sourceRoot":"","sources":["../src/answer-seen.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,iBAAiB,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAA2B,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC/E,OAAO,KAAK,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAOhD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAA+B,KAAK,MAAM,EAAE,MAAM,WAAW,CAAC;AACrE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAQxC;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAC1B,CAAC,SAAS;IACR,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,aAAa,CAAC,CAAC;IACzC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IACzC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;IAC3C,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;IACzC,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;IAChD,QAAQ,CAAC,GAAG,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;CACrC,EACD,KAAK,EAAE,MAAM,GAAG;IAAE,aAAa,IAAI,SAAS,mBAAmB,EAAE,CAAA;CAAE,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAwFzG;AAED,qHAAqH;AACrH,KAAK,UAAU,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,SAAS,EAAE,KAAK,MAAM,CAAC,YAAY,GAAG,UAAU,GAAG,iBAAiB,EAAE,SAAS,EAAE,CAAC,CAAC;AAGvL,gFAAgF;AAChF,eAAO,MAAM,iBAAiB,GAAI,OAAO,UAAU,KAAG,IAAqC,CAAC"}

package/dist/answer-seen.js

@@ -0,0 +1,122 @@
+import { servePrimitives } from "./ops/served.js";
+import { writersOf } from "./ops/writers.js";
+import { withoutKeptFields } from "./ops/kept-fields.js";
+import { namesUnseen, redact, WITHHELD_INTENT } from "./ops/withheld.js";
+import { actingAs } from "./permissions/policy.js";
+import { recordsOf } from "./permissions/sight.js";
+import { hidesFrom, seatLens, seenBy } from "./seen.js";
+/*
+ * A file of its own (FR-179): what a seat's tools hand back after an act is
+ * fetched with those tools (`@graview/core/seat`), and a page that only
+ * draws what its seat sees (`./seen.ts`) carries none of it up front.
+ */
+/**
+ * A CHANGE'S ANSWER AS ONE SEAT MAY BE TOLD IT (FR-55) — the diff, the
+ * primitives, the ops and the rules it would break or mend of a preview,
+ * an apply or an undo, for a surface that hands a seat what its own act
+ * did: an act may touch what its own seat may not see. Records and edges
+ * it is not served go, a field naming one it may not see is cleared as
+ * the view clears it, the ops are redacted as its log is, and a sentence
+ * that names what it may not see says only that a change it cannot see
+ * happened. With nothing kept from the seat, the answer as it is.
+ */
+export function answerSeenBy(store, principal, answer) {
+    if (!hidesFrom(store, principal))
+        return answer;
+    const lens = seatLens(store, principal);
+    const has = (id) => store.graph.getNode(id) !== undefined || recordsOf(store.log).kindOf(id) !== undefined;
+    const out = { ...answer };
+    if (answer.diff) {
+        const diff = answer.diff;
+        /*
+         * EACH SIDE AS WHO WROTE IT THEN (FR-55): the seat's own words are served
+         * as written, and the words a change replaced were somebody's before it.
+         * Before is judged as of the first op the answer made (now, for a
+         * preview); after as of now — and, for a preview, what it would write
+         * is the caller's.
+         */
+        const writers = writersOf(store.log);
+        const end = store.log.length ?? store.log.all().length;
+        const first = answer.ops?.[0]?.seq ?? end;
+        const actor = actingAs(principal).id;
+        const wroteAt = (id, seq) => (field) => writers.writerAt(id, field, seq);
+        const node = (one, writer) => (lens.shows(one.id) ? lens.servedWith(one, writer) : undefined);
+        const nodes = (all, writer) => all.flatMap((one) => node(one, writer(one.id)) ?? []);
+        const edge = (one) => lens.shows(one.from) && lens.shows(one.to) && !namesUnseen(one, lens.sees);
+        const madeBy = (id, fields) => answer.ops ? wroteAt(id, end) : (field) => (fields === undefined || fields.includes(field) ? actor : writers.writerAt(id, field, end));
+        const changed = diff.changedNodes.flatMap((change) => {
+            const before = node(change.before, wroteAt(change.before.id, first));
+            const after = node(change.after, madeBy(change.after.id, change.fields));
+            return before && after ? [{ before, after, fields: change.fields.filter((field) => field in before || field in after) }] : [];
+        });
+        /*
+         * A WRITE THAT CHANGED NOTHING BUT WHOSE WORDS THEY ARE. A seat that
+         * wrote the value a field already held, naming what it may not see, made
+         * those words its own (FR-55): the store's graph did not move, and the
+         * seat's view of the record did. Said as a change, so the answer reads
+         * as it would had the field held anything else.
+         */
+        const listed = new Set(diff.changedNodes.map((change) => change.after.id));
+        const patched = new Map();
+        for (const primitive of (answer.ops?.flatMap((op) => op.primitives) ?? answer.primitives ?? [])) {
+            if (primitive.op !== "patch-node" || listed.has(primitive.id))
+                continue;
+            patched.set(primitive.id, [...(patched.get(primitive.id) ?? []), ...Object.keys(primitive.after)]);
+        }
+        const kept = () => [...patched].flatMap(([id, fields]) => {
+            const held = store.graph.getNode(id);
+            if (!held)
+                return [];
+            const before = node(held, wroteAt(id, first));
+            const after = node(held, madeBy(id, fields));
+            return before && after && JSON.stringify(before) !== JSON.stringify(after) ? [{ before, after, fields }] : [];
+        });
+        const madeTheirs = kept();
+        out["diff"] = {
+            addedNodes: nodes(diff.addedNodes, (id) => madeBy(id)),
+            removedNodes: nodes(diff.removedNodes, (id) => wroteAt(id, first)),
+            changedNodes: [...changed, ...madeTheirs],
+            addedEdges: diff.addedEdges.filter(edge),
+            removedEdges: diff.removedEdges.filter(edge),
+            touched: [...diff.touched.filter(lens.shows), ...[...patched.keys()].filter((id) => lens.shows(id) && !diff.touched.includes(id))],
+        };
+    }
+    if (answer.ops)
+        out["ops"] = redact(answer.ops, lens);
+    if (answer.primitives) {
+        // An apply's primitives are its ops'; a preview's are not in the log yet, and are judged from the graph as it stands.
+        const ops = out["ops"];
+        out["primitives"] = ops
+            ? ops.flatMap((op) => op.primitives)
+            : lens.timeline
+                ? servePrimitives(answer.primitives, lens.timeline, { served: (node, writer) => lens.servedWith(node, writer), edgeClean: (edge) => !namesUnseen(edge, lens.sees), sees: lens.sees }, actingAs(principal).id)
+                : redact([{ id: "", seq: 0, batch: "", author: { kind: "system" }, intent: "", mutation: null, primitives: answer.primitives, inverse: [], reads: [], writes: [], at: "" }], lens)[0].primitives;
+    }
+    // What a change wrote of a field the seat may not see is no part of what it is told (Roadmap f-field-sight).
+    if (lens.kept && out["primitives"])
+        out["primitives"] = withoutKeptFields(out["primitives"], lens);
+    // Records the seat is served, and no id that names nothing: a hidden record and an absent one are left out alike (FR-55).
+    if (answer.reads)
+        out["reads"] = answer.reads.filter((id) => lens.shows(id) && has(id));
+    if (answer.writes)
+        out["writes"] = answer.writes.filter(lens.shows);
+    if (answer.intent !== undefined && namesUnseen(answer.intent, lens.sees))
+        out["intent"] = WITHHELD_INTENT;
+    /*
+     * THE RULES IT BROKE OR MENDED, AS THE SEAT JUDGES THEM (FR-55). Judged
+     * over the whole graph, whether a rule that counts, sweeps or walks was
+     * broken or mended depends on records this seat may not see, and its
+     * title alone says so. So they are judged again over the seat's own
+     * world: what it is served now, and that world with the change it is
+     * served taken back — or, for a preview, put on. The judging is
+     * `@graview/core/lines`', which a seat's tools load before they answer;
+     * without it, nothing judged over the whole graph is said.
+     */
+    if (answer.violationsAfter)
+        Object.assign(out, judgedForASeat ? judgedForASeat(store, seenBy(store, principal), !!answer.ops, (out["primitives"] ?? [])) : { introduces: [], resolves: [], violationsAfter: [] });
+    return out;
+}
+let judgedForASeat;
+/** Hands `answerSeenBy` what judges a change's problems over a seat's world. */
+export const answersJudgedWith = (judge) => void (judgedForASeat = judge);
+//# sourceMappingURL=answer-seen.js.map

package/dist/answer-seen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"answer-seen.js","sourceRoot":"","sources":["../src/answer-seen.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,eAAe,EAAoB,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAGnD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAe,MAAM,WAAW,CAAC;AAGrE;;;;GAIG;AAEH;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY,CAY1B,KAAmE,EAAE,SAAoB,EAAE,MAAS;IACpG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC;QAAE,OAAO,MAAM,CAAC;IAChD,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IACxC,MAAM,GAAG,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,SAAS,IAAI,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,SAAS,CAAC;IACnH,MAAM,GAAG,GAA4B,EAAE,GAAG,MAAM,EAAE,CAAC;IACnD,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,MAAM,IAAI,GAAG,MAAM,CAAC,IAAiB,CAAC;QACtC;;;;;;WAMG;QACH,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,GAAY,CAAC,CAAC;QAC9C,MAAM,GAAG,GAAI,KAAK,CAAC,GAAoC,CAAC,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC;QACzF,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,GAAG,CAAC;QAC1C,MAAM,KAAK,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;QACrC,MAAM,OAAO,GAAG,CAAC,EAAU,EAAE,GAAW,EAAE,EAAE,CAAC,CAAC,KAAa,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;QACjG,MAAM,IAAI,GAAG,CAAyC,GAAM,EAAE,MAAmB,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACtJ,MAAM,KAAK,GAAG,CAAyC,GAAiB,EAAE,MAAmC,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACxK,MAAM,IAAI,GAAG,CAAC,GAAc,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5G,MAAM,MAAM,GAAG,CAAC,EAAU,EAAE,MAA0B,EAAe,EAAE,CACrE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;QACzI,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,MAAkB,EAAE,EAAE;YAC/D,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC;YACrE,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;YACzE,OAAO,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAChI,CAAC,CAAC,CAAC;QACH;;;;;;WAMG;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,MAAkB,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;QACvF,MAAM,OAAO,GAAG,IAAI,GAAG,EAAoB,CAAC;QAC5C,KAAK,MAAM,SAAS,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,IAAK,MAAM,CAAC,UAA+C,IAAI,EAAE,CAAC,EAAE,CAAC;YACtI,IAAI,SAAS,CAAC,EAAE,KAAK,YAAY,IAAI,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;gBAAE,SAAS;YACxE,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACrG,CAAC;QACD,MAAM,IAAI,GAAG,GAAG,EAAE,CAChB,CAAC,GAAG,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE;YACpC,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAA6B,CAAC;YACjE,IAAI,CAAC,IAAI;gBAAE,OAAO,EAAE,CAAC;YACrB,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC;YAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;YAC7C,OAAO,MAAM,IAAI,KAAK,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAChH,CAAC,CAAC,CAAC;QACL,MAAM,UAAU,GAAG,IAAI,EAAE,CAAC;QAC1B,GAAG,CAAC,MAAM,CAAC,GAAG;YACZ,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACtD,YAAY,EAAE,KAAK,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;YAClE,YAAY,EAAE,CAAC,GAAG,OAAO,EAAE,GAAG,UAAU,CAAC;YACzC,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC;YACxC,YAAY,EAAE,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC;YAC5C,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;SACnI,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,GAAG;QAAE,GAAG,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACtD,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACtB,sHAAsH;QACtH,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAqC,CAAC;QAC3D,GAAG,CAAC,YAAY,CAAC,GAAG,GAAG;YACrB,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC;YACpC,CAAC,CAAC,IAAI,CAAC,QAAQ;gBACb,CAAC,CAAC,eAAe,CAAC,MAAM,CAAC,UAAkC,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;gBACrO,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,UAAmB,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAE,CAAC,UAAU,CAAC;IACjN,CAAC;IACD,6GAA6G;IAC7G,IAAI,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,YAAY,CAAC;QAAE,GAAG,CAAC,YAAY,CAAC,GAAG,iBAAiB,CAAC,GAAG,CAAC,YAAY,CAAyB,EAAE,IAAI,CAAC,CAAC;IAC3H,0HAA0H;IAC1H,IAAI,MAAM,CAAC,KAAK;QAAE,GAAG,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IACxF,IAAI,MAAM,CAAC,MAAM;QAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpE,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC;QAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,eAAe,CAAC;IAC1G;;;;;;;;;OASG;IACH,IAAI,MAAM,CAAC,eAAe;QAAE,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC,KAAc,EAAE,MAAM,CAAC,KAAc,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,CAAyB,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,eAAe,EAAE,EAAE,EAAE,CAAC,CAAC;IAC5P,OAAO,GAAQ,CAAC;AAClB,CAAC;AAID,IAAI,cAAsC,CAAC;AAE3C,gFAAgF;AAChF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,KAAiB,EAAQ,EAAE,CAAC,KAAK,CAAC,cAAc,GAAG,KAAK,CAAC,CAAC"}

package/dist/app-places.d.ts

@@ -0,0 +1,56 @@
+import type { GraviewApp } from "./app.js";
+import { type PlaceFinding, type ShippedLensName } from "./places.js";
+import type { AnySchema } from "./schema/schema.js";
+import { type PagesArrangement, type Place } from "./views/types.js";
+/** What the arrangement asks that the declaration cannot honor: kinds and places that do not exist. */
+export declare function arrangementFindings<S extends AnySchema>(app: GraviewApp<S>, places?: readonly Place[]): readonly PlaceFinding[];
+/**
+ * ONE OF AN APP'S NAMED PLACES, as a host lists them (FR-79, FR-80): what it
+ * is called, what it is over, and its address on each face — `address` on
+ * the routed face, `stop` in the scene's fragment.
+ */
+export interface AppPlace {
+    /** The address word: a place's `as`, a kind's plural, or `home`. */
+    readonly slug: string;
+    readonly title: string;
+    /** The kind it is over; null for the home. A picture over several kinds is listed once, under the first. */
+    readonly kind: string | null;
+    /** Every kind a picture over several is over — the timetable of talks and workshops — each one's district going in to it. */
+    readonly over?: readonly string[];
+    readonly cardinality: "many";
+    /** Its path on the routed face: `/`, `/<plural>`, `/places/<as>`. */
+    readonly address: string;
+    /** Its stop in the scene: `#view=<as>`, `#focus=aggregate:<kind>`, or `#`. */
+    readonly stop: string;
+    /** Which shipped lens draws it, when a declared lens does. */
+    readonly lens?: ShippedLensName;
+    /** Left off the home by `pages.hide`; still reachable at its address. */
+    readonly hidden?: boolean;
+    /** Where the app opens (`pages.first`). */
+    readonly first?: boolean;
+}
+/**
+ * EVERY PLACE AN APP HAS, by name: the home, each declared lens that draws
+ * (and each place its registered views name, when the app carries them),
+ * and each kind — in the arrangement's order. What Graview Cloud's
+ * connector lists when an app is opened, and what a chat can send somebody
+ * to.
+ */
+export declare function placesOf<S extends AnySchema>(app: GraviewApp<S>): readonly AppPlace[];
+/**
+ * THE SAME LIST FROM WHAT A FACE HOLDS: the schema, the places its view
+ * registry names, and the arrangement — what `placesOf` makes from the
+ * declaration, for a seat handed a store and its views rather than the app.
+ * One builder, so the two can never name, address or order a place
+ * differently.
+ */
+export declare function placesFrom(schema: AnySchema, lensPlaces: readonly Place[], options?: {
+    readonly pages?: PagesArrangement;
+    readonly lenses?: readonly {
+        readonly as: string;
+        readonly kinds: readonly string[];
+        readonly lens: ShippedLensName;
+    }[];
+    readonly home?: boolean;
+}): readonly AppPlace[];
+//# sourceMappingURL=app-places.d.ts.map

package/dist/app-places.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-places.d.ts","sourceRoot":"","sources":["../src/app-places.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAA8G,KAAK,YAAY,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAClL,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,EAAqD,KAAK,gBAAgB,EAAE,KAAK,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAYxH,uGAAuG;AACvG,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,SAAS,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,MAAM,GAAE,SAAS,KAAK,EAAwB,GAAG,SAAS,YAAY,EAAE,CAiEpJ;AAeD;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,oEAAoE;IACpE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,4GAA4G;IAC5G,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,6HAA6H;IAC7H,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,qEAAqE;IACrE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,CAAC,EAAE,eAAe,CAAC;IAChC,yEAAyE;IACzE,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,2CAA2C;IAC3C,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,SAAS,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,SAAS,QAAQ,EAAE,CAErF;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,SAAS,EACjB,UAAU,EAAE,SAAS,KAAK,EAAE,EAC5B,OAAO,GAAE;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAA;KAAE,EAAE,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAO,GACpM,SAAS,QAAQ,EAAE,CA0CrB"}

package/dist/app-places.js

@@ -0,0 +1,153 @@
+import { declaredLenses, MOST_STANDING, openingOf, orderKinds, OVERVIEW_PATH, OVERVIEW_SLUG, pagesTitle, sceneTitle } from "./places.js";
+import { pluralLabel } from "./schema/define-node.js";
+import { kindPath, onePerPicture, placePath, sharesItsName } from "./views/types.js";
+/*
+ * EVERY PLACE AN APP HAS, AND WHAT ITS ARRANGEMENT ASKS THAT IT CANNOT
+ * HONOR. A file of its own (FR-179): the seat lists the places an ask can
+ * go to, a host lists them when an app is opened and the checker judges
+ * the arrangement — none of it before a page draws its bar, which reads
+ * the places that stand from `./places.ts` (`@graview/core/seat`,
+ * `@graview/core/check`).
+ */
+/** What the arrangement asks that the declaration cannot honor: kinds and places that do not exist. */
+export function arrangementFindings(app, places = placesOfLenses(app)) {
+    const pages = app.pages;
+    const findings = [];
+    const taken = places.find((place) => place.as === OVERVIEW_SLUG);
+    if (taken) {
+        findings.push({
+            severity: "warning",
+            code: "pages-overview-taken",
+            path: "pages",
+            message: `The place "${taken.title}" has the address the scene keeps (${OVERVIEW_PATH}), so the bar's "${sceneTitle(pages)}" and it cannot both be reached there.`,
+            fix: `Give "${taken.title}" another title (or another "as"): the scene keeps ${OVERVIEW_PATH} whatever the declaration calls it.`,
+        });
+    }
+    if (!pages)
+        return findings;
+    if (sceneTitle(pages).toLowerCase() === pagesTitle(pages).toLowerCase()) {
+        findings.push({
+            severity: "warning",
+            code: "pages-faces-alike",
+            path: "pages",
+            message: `The bar's switch would call both the scene and the pages "${sceneTitle(pages)}", so a reader could not tell its two buttons apart.`,
+            fix: `Give pages.scene and pages.pages two different words (unsaid, they are "Scene" and "Pages").`,
+        });
+    }
+    const kinds = app.schema.kinds;
+    for (const part of ["order", "hide"]) {
+        (pages[part] ?? []).forEach((kind, index) => {
+            if (!kinds.includes(kind)) {
+                findings.push({ severity: "warning", code: "pages-kind-unknown", path: `pages.${part}.${index}`, message: `pages.${part} names "${kind}", which is not a kind, so it is passed over.`, fix: `Use one of: ${kinds.join(", ")}.` });
+            }
+        });
+    }
+    (pages.primary ?? []).forEach((word, index) => {
+        const opening = openingOf(word, app.schema, places);
+        if (opening === undefined || opening.to === "home") {
+            findings.push({
+                severity: "warning",
+                code: "pages-primary-unknown",
+                path: `pages.primary.${index}`,
+                message: opening?.to === "home"
+                    ? `pages.primary names "${word}", but Home always stands on the bar, so it is passed over.`
+                    : `pages.primary names "${word}", which is not a kind or a place, so it is passed over.`,
+                fix: `Name a kind (${kinds.join(", ")}) or a place (${places.map((place) => `"${place.title}"`).join(", ") || "none is declared"}).`,
+            });
+        }
+    });
+    if ((pages.primary?.length ?? 0) > MOST_STANDING - 1) {
+        findings.push({
+            severity: "warning",
+            code: "pages-primary-many",
+            path: "pages.primary",
+            message: `pages.primary names ${pages.primary.length} places, and at most ${MOST_STANDING - 1} stand beside Home: the rest fold into "More" anyway.`,
+            fix: `Name the ${MOST_STANDING - 1} a person reaches for most.`,
+        });
+    }
+    if (pages.first !== undefined && openingOf(pages.first, app.schema, places) === undefined) {
+        findings.push({
+            severity: "warning",
+            code: "pages-first-unknown",
+            path: "pages.first",
+            message: `pages.first is "${pages.first}", which is not a place, a kind or "home", so the app opens at its home.`,
+            fix: `Name a place (${places.map((place) => `"${place.title}"`).join(", ") || "none is declared"}), a kind, or "home".`,
+        });
+    }
+    return findings;
+}
+/** The places a declaration's lenses make, with any its registered views name. */
+function placesOfLenses(app) {
+    const out = [];
+    for (const lens of declaredLenses(app).drawn) {
+        // One picture over several kinds is a place on each, and says so (`over`): every list names it once.
+        for (const kind of lens.kinds)
+            out.push({ kind, title: lens.title, as: lens.as, ...(lens.across ? { across: lens.across } : {}), ...(lens.kinds.length > 1 ? { over: lens.kinds } : {}) });
+    }
+    for (const place of app.views?.places?.() ?? []) {
+        if (!out.some((held) => held.kind === place.kind && held.as === place.as))
+            out.push(place);
+    }
+    return out;
+}
+/**
+ * EVERY PLACE AN APP HAS, by name: the home, each declared lens that draws
+ * (and each place its registered views name, when the app carries them),
+ * and each kind — in the arrangement's order. What Graview Cloud's
+ * connector lists when an app is opened, and what a chat can send somebody
+ * to.
+ */
+export function placesOf(app) {
+    return placesFrom(app.schema, placesOfLenses(app), { ...(app.pages ? { pages: app.pages } : {}), lenses: declaredLenses(app).drawn, home: (app.home?.length ?? 0) > 0 });
+}
+/**
+ * THE SAME LIST FROM WHAT A FACE HOLDS: the schema, the places its view
+ * registry names, and the arrangement — what `placesOf` makes from the
+ * declaration, for a seat handed a store and its views rather than the app.
+ * One builder, so the two can never name, address or order a place
+ * differently.
+ */
+export function placesFrom(schema, lensPlaces, options = {}) {
+    const { pages } = options;
+    const kindsDeclared = schema.kinds;
+    const places = lensPlaces.filter((place) => kindsDeclared.includes(place.kind));
+    const opening = openingOf(pages?.first, schema, places);
+    const hidden = new Set(pages?.hide ?? []);
+    const kinds = orderKinds(kindsDeclared, pages?.order);
+    const out = [
+        { slug: "home", title: "Home", kind: null, cardinality: "many", address: "/", stop: "#", ...(opening?.to === "home" || (opening === undefined && options.home) ? { first: true } : {}) },
+        // The scene, a place like the others (FR-132): its stop rides on its address.
+        { slug: OVERVIEW_SLUG, title: sceneTitle(pages), kind: null, cardinality: "many", address: OVERVIEW_PATH, stop: "#" },
+    ];
+    // A picture over several kinds once, under the first of them in the arrangement's order.
+    const byKind = onePerPicture([...places].sort((a, b) => kinds.indexOf(a.kind) - kinds.indexOf(b.kind)));
+    for (const place of byKind) {
+        const lens = options.lenses?.find((one) => one.as === place.as && one.kinds.includes(place.kind));
+        const shared = sharesItsName(place, places);
+        out.push({
+            slug: place.as,
+            title: place.title,
+            kind: place.kind,
+            ...(place.over ? { over: place.over.filter((kind) => kindsDeclared.includes(kind)) } : {}),
+            cardinality: "many",
+            address: placePath(place.as, shared ? kindPath(schema, place.kind).slice(1) : undefined),
+            stop: shared ? `#focus=aggregate:${place.kind}&in.view=${encodeURIComponent(place.as)}` : `#view=${encodeURIComponent(place.as)}`,
+            ...(lens ? { lens: lens.lens } : {}),
+            ...(opening?.to === "place" && opening.place.as === place.as && (opening.place.kind === place.kind || place.over?.includes(opening.place.kind)) ? { first: true } : {}),
+        });
+    }
+    for (const kind of kinds) {
+        out.push({
+            slug: kindPath(schema, kind).slice(1),
+            title: pluralLabel(schema, kind),
+            kind,
+            cardinality: "many",
+            address: kindPath(schema, kind),
+            stop: `#focus=aggregate:${kind}`,
+            ...(hidden.has(kind) ? { hidden: true } : {}),
+            ...(opening?.to === "kind" && opening.kind === kind ? { first: true } : {}),
+        });
+    }
+    return out;
+}
+//# sourceMappingURL=app-places.js.map

package/dist/app-places.js.map

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

package/dist/arrange.d.ts

@@ -10,7 +10,7 @@
  * arranging. The types stay on `@graview/core`, where a declaration names
  * them.
  */
-export { arrangeable, asksForThePast, conditionHolds, edgesOf, NO_ARRANGEMENT, parseArrangement } from "./arrangement.js";
-export { admitArrangement, arrange, arrangeAllows, bucketStart, formatArrangement, matches } from "./arranging.js";
+export { arrangeable, asksForThePast, conditionHolds, edgesOf, NO_ARRANGEMENT, parseArrangement, throughEdges } from "./arrangement.js";
+export { admitArrangement, arrange, arrangeAllows, bucketStart, formatArrangement, matches, } from "./arranging.js";
 export type { Arrangeable, ArrangeContext, Arranged, ArrangeGraph, ArrangedGroup, Arrangement, ArrangementWords, ArrangeNode, ArrangeOffer, ArrangeOption, Condition, DateBucket, Grouping, OfferType, Sort, SortDirection, } from "./arrangement.js";
 //# sourceMappingURL=arrange.d.ts.map

package/dist/arrange.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"arrange.d.ts","sourceRoot":"","sources":["../src/arrange.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,cAAc,EAAE,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC1H,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACnH,YAAY,EACV,WAAW,EACX,cAAc,EACd,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,aAAa,EACb,SAAS,EACT,UAAU,EACV,QAAQ,EACR,SAAS,EACT,IAAI,EACJ,aAAa,GACd,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"arrange.d.ts","sourceRoot":"","sources":["../src/arrange.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,cAAc,EAAE,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACxI,OAAO,EACL,gBAAgB,EAChB,OAAO,EACP,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,OAAO,GACR,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,WAAW,EACX,cAAc,EACd,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,aAAa,EACb,SAAS,EACT,UAAU,EACV,QAAQ,EACR,SAAS,EACT,IAAI,EACJ,aAAa,GACd,MAAM,kBAAkB,CAAC"}

package/dist/arrange.js

@@ -10,6 +10,6 @@
  * arranging. The types stay on `@graview/core`, where a declaration names
  * them.
  */
-export { arrangeable, asksForThePast, conditionHolds, edgesOf, NO_ARRANGEMENT, parseArrangement } from "./arrangement.js";
-export { admitArrangement, arrange, arrangeAllows, bucketStart, formatArrangement, matches } from "./arranging.js";
+export { arrangeable, asksForThePast, conditionHolds, edgesOf, NO_ARRANGEMENT, parseArrangement, throughEdges } from "./arrangement.js";
+export { admitArrangement, arrange, arrangeAllows, bucketStart, formatArrangement, matches, } from "./arranging.js";
 //# sourceMappingURL=arrange.js.map

package/dist/arrange.js.map

@@ -1 +1 @@
-{"version":3,"file":"arrange.js","sourceRoot":"","sources":["../src/arrange.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,cAAc,EAAE,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC1H,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"arrange.js","sourceRoot":"","sources":["../src/arrange.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,cAAc,EAAE,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACxI,OAAO,EACL,gBAAgB,EAChB,OAAO,EACP,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,OAAO,GACR,MAAM,gBAAgB,CAAC"}

package/dist/arrangement-words.d.ts

@@ -0,0 +1,3 @@
+import type { Arrangement, ArrangementWords } from "./arrangement.js";
+export declare function parseArrangement(words: ArrangementWords): Arrangement;
+//# sourceMappingURL=arrangement-words.d.ts.map

package/dist/arrangement-words.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrangement-words.d.ts","sourceRoot":"","sources":["../src/arrangement-words.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAyC,MAAM,kBAAkB,CAAC;AAqB7G,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,gBAAgB,GAAG,WAAW,CAwBrE"}