@graview/core 0.1.17 → 0.1.19

package/dist/document/edit.js

@@ -16,6 +16,8 @@ import { canonicalize } from "./canonical.js";
 import { quotedAtTheEnd } from "./quote.js";
 import { respellDocument } from "./respell.js";
 import { accentProblem } from "../theme/accent.js";
+import { pageFieldFindings, pageNames, renamedOnPage, withoutOnPage } from "./page-fields.js";
+import { capitalize } from "../capital.js";
 /** The ops, for tool schemas and the guide. */
 export const EDIT_OPS = [
     "add-kind",
@@ -43,6 +45,7 @@ export const EDIT_OPS = [
     "set-describe",
     "set-view",
     "set-glance",
+    "set-page-fields",
     "add-lens",
     "remove-lens",
     "set-home",
@@ -100,6 +103,15 @@ const SHAPES = {
     // A kind's slot; the front page (`slot: "home"`, no kind); or a blocks lens's blocks, by its title (FR-84).
     "set-view": z.object({ op: z.literal("set-view"), kind: kindName.optional(), slot: z.enum([...VIEW_SLOTS, "home"]).optional(), lens: lensTitle.optional(), blocks: z.union([z.array(z.unknown()).min(1), z.null()]) }).strict(),
     "set-glance": z.object({ op: z.literal("set-glance"), kind: kindName, fields: z.array(fieldName).max(20) }).strict(),
+    // How a record's page orders and groups its facts (FR-148): these first, then each group under its title; none of either takes the choice away.
+    "set-page-fields": z
+        .object({
+        op: z.literal("set-page-fields"),
+        kind: kindName,
+        fields: z.array(fieldName).max(40),
+        groups: z.union([z.array(z.object({ title: z.string().min(1).max(60), fields: z.array(fieldName).min(1).max(40) }).strict()).max(12), z.null()]).optional(),
+    })
+        .strict(),
     "add-lens": z
         .object({
         op: z.literal("add-lens"),
@@ -548,7 +560,7 @@ class Editor {
             if (unknown)
                 return this.fail(i, "accents", `"${unknown}" is not a kind this app has; it has ${Object.keys(this.doc.kinds).join(", ")}`);
         }
-        merge("accents", (kind, hue) => (hue === null ? `${cap(kind)} goes back to its own hue.` : `${cap(kind)} is drawn at hue ${hue}°.`), "Every kind goes back to its own hue.");
+        merge("accents", (kind, hue) => (hue === null ? `${capitalize(kind)} goes back to its own hue.` : `${capitalize(kind)} is drawn at hue ${hue}°.`), "Every kind goes back to its own hue.");
         if (e.scheme !== undefined) {
             if (e.scheme === null || e.scheme === "auto")
                 delete brand["scheme"];
@@ -759,6 +771,8 @@ class Editor {
                 }
                 return;
             }
+            case "set-page-fields":
+                return this.setPageFields(i, e);
             case "add-lens":
                 return this.addLens(i, e);
             case "remove-lens":
@@ -771,6 +785,28 @@ class Editor {
                 return this.setComputed(i, e);
         }
     }
+    /** How a record's page orders and groups its facts (FR-148): judged as the compile judges `kinds.<kind>.page`. */
+    setPageFields(i, e) {
+        const spec = this.kind(i, e.kind);
+        if (!spec)
+            return;
+        const fields = e.fields;
+        const groups = e.groups ?? [];
+        const noun = spec.noun ?? words(e.kind);
+        const a = /^[aeiou]/i.test(noun) ? "An" : "A";
+        if (fields.length === 0 && groups.length === 0) {
+            delete spec.page;
+            this.said.push(`${a} ${noun}'s page shows its facts in the order the kind declares them.`);
+            return;
+        }
+        const page = { ...(fields.length > 0 ? { fields: [...fields] } : {}), ...(groups.length > 0 ? { groups: groups.map((group) => ({ title: group.title, fields: [...group.fields] })) } : {}) };
+        const wrong = pageFieldFindings(e.kind, { ...spec, page }, "")[0];
+        if (wrong)
+            return this.fail(i, wrong.path.replace(/^\./, ""), wrong.message, wrong.fix);
+        spec.page = page;
+        const shown = [...(fields.length > 0 ? [`${listOf(fields)} first`] : []), ...groups.map((group) => `${listOf(group.fields)} under "${group.title}"`)];
+        this.said.push(`${a} ${noun}'s page shows ${listOf(shown)}, and the rest ${groups.length > 0 ? 'under "Details"' : "after them"}.`);
+    }
     // ── views, the front page, lenses, the arrangement, what is worked out (FR-84) ──
     /** Blocks checked where they will stand: an error refuses the edit at that path, so a chat is told before anything is previewed. */
     blocksHold(i, at) {
@@ -819,13 +855,13 @@ class Editor {
                 delete views[e.kind];
             if (Object.keys(views).length === 0)
                 delete this.doc.views;
-            this.said.push(`${cap(withA(noun))} ${e.slot} goes back to Graview's own look.`);
+            this.said.push(`${capitalize(withA(noun))} ${e.slot} goes back to Graview's own look.`);
             return;
         }
         (views[e.kind] ??= {})[e.slot] = e.blocks;
         if (!this.blocksHold(i, `views.${e.kind}.${e.slot}`))
             return;
-        this.said.push(`${cap(withA(noun))} ${e.slot} gets a look of its own: ${blockWords(e.blocks)}.`);
+        this.said.push(`${capitalize(withA(noun))} ${e.slot} gets a look of its own: ${blockWords(e.blocks)}.`);
     }
     setHome(i, blocks) {
         const views = (this.doc.views ??= {});
@@ -941,7 +977,7 @@ class Editor {
         if (index < 0)
             return;
         const said = this.removeLensAt(index);
-        this.said.push(`${cap(said.replace(/ \(the app opens at its home again\)$/, ""))} is removed${said.endsWith("again)") ? "; the app opens at its home again" : ""}.`);
+        this.said.push(`${capitalize(said.replace(/ \(the app opens at its home again\)$/, ""))} is removed${said.endsWith("again)") ? "; the app opens at its home again" : ""}.`);
     }
     arrangePages(i, given) {
         // `overview` is the scene's word as 0.1.15 and 0.1.16 took it (FR-134): read as `scene`, which wins when both are said.
@@ -1013,7 +1049,7 @@ class Editor {
         }
         if (Object.keys(pages).length === 0)
             delete this.doc.pages;
-        this.said.push(`${cap(listOf(said))}.`);
+        this.said.push(`${capitalize(listOf(said))}.`);
     }
     /** Whether `first` names something the app can open on: home, a kind or its plural, a titled lens. */
     opens(first) {
@@ -1031,7 +1067,7 @@ class Editor {
         if (!spec)
             return;
         const name = e.name;
-        const plural = cap(pluralWords(this.doc, e.kind));
+        const plural = capitalize(pluralWords(this.doc, e.kind));
         const existing = spec.computed?.[name];
         if (e.expr === null) {
             if (existing === undefined)
@@ -1340,6 +1376,10 @@ class Editor {
             spec.glance = spec.glance.map((name) => (name === field ? to : name));
             touched.push(`${kind}'s glance`);
         }
+        if (pageNames(spec.page, field)) {
+            spec.page = renamedOnPage(spec.page, field, to);
+            touched.push(`${kind}'s page`);
+        }
         for (const x of this.fills) {
             if (x.kind === kind && x.field === field)
                 x.field = to;
@@ -1470,6 +1510,16 @@ class Editor {
                 gone.push(`${kind}'s glance`);
             }
         }
+        // Its page shows the fields that are left; one that showed only this one goes back to the declared order.
+        if (pageNames(spec.page, field)) {
+            const page = withoutOnPage(spec.page, field);
+            if (page)
+                spec.page = page;
+            else {
+                delete spec.page;
+                gone.push(`${kind}'s page order`);
+            }
+        }
         for (const x of [...this.fills])
             if (x.kind === kind && (x.field === field || x.from === field))
                 this.fills.splice(this.fills.indexOf(x), 1);
@@ -1966,6 +2016,13 @@ class Editor {
                 if (spec.glance.length === 0)
                     delete spec.glance;
             }
+            if (pageNames(spec.page, name)) {
+                const page = withoutOnPage(spec.page, name);
+                if (page)
+                    spec.page = page;
+                else
+                    delete spec.page;
+            }
         }
         this.dropping.delete(key);
         return gone;
@@ -2173,7 +2230,6 @@ function mapBlocks(blocks, f) {
     return out;
 }
 // ── words for what changed ───────────────────────────────────────────────────
-const cap = (text) => text.charAt(0).toUpperCase() + text.slice(1);
 const withA = (noun) => `${/^[aeiou]/i.test(noun) ? "an" : "a"} ${noun}`;
 const nounOf = (doc, kind) => doc.kinds[kind]?.noun ?? words(kind);
 /** A kind's plural as a person reads it: "packages", "people and teams". */