@graview/core 0.1.27 → 0.1.29

package/dist/schema/app-link-field.d.ts

@@ -0,0 +1,4 @@
+import { z } from "zod";
+/** A field that holds another app's address: `@owner/app`, its id, or its https:// address. */
+export declare function appLinkField(): z.ZodString;
+//# sourceMappingURL=app-link-field.d.ts.map

package/dist/schema/app-link-field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-link-field.d.ts","sourceRoot":"","sources":["../../src/schema/app-link-field.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAgBxB,+FAA+F;AAC/F,wBAAgB,YAAY,IAAI,CAAC,CAAC,SAAS,CAE1C"}

package/dist/schema/app-link-field.js

@@ -0,0 +1,19 @@
+import { z } from "zod";
+import { APP_ADDRESS, markAppLink } from "./app-link.js";
+/*
+ * A DECLARATION'S LINK TO ANOTHER APP (FR-171), in the classic zod a product
+ * writes its kinds in, so it chains like any other field:
+ *
+ *   fields: z.object({
+ *     name: z.string(),
+ *     house: appLinkField().optional(),
+ *   })
+ *
+ * A document says the same as `{"type": "app-link"}`. The value is another
+ * app's address; the host's `resolveApp` says what it is called.
+ */
+/** A field that holds another app's address: `@owner/app`, its id, or its https:// address. */
+export function appLinkField() {
+    return markAppLink(z.string().max(500).regex(APP_ADDRESS, "another app's address"));
+}
+//# sourceMappingURL=app-link-field.js.map

package/dist/schema/app-link-field.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-link-field.js","sourceRoot":"","sources":["../../src/schema/app-link-field.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEzD;;;;;;;;;;;GAWG;AAEH,+FAA+F;AAC/F,MAAM,UAAU,YAAY;IAC1B,OAAO,WAAW,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,uBAAuB,CAAC,CAAC,CAAC;AACtF,CAAC"}

package/dist/schema/app-link.d.ts

@@ -0,0 +1,41 @@
+import * as z from "./zod.js";
+/** What an app-link field holds: `@owner/app`, an id, or an absolute http(s) address. */
+export declare const APP_ADDRESS: RegExp;
+/** Whether a value is another app's address: `@owner/app`, an app id, or an absolute http(s) address, of at most 500 characters. */
+export declare const isAppAddress: (value: unknown) => value is string;
+/** Marks a schema as holding another app's address. */
+export declare const markAppLink: <T extends object>(schema: T) => T;
+/** Whether a field holds another app's address — under optional, default and nullable. */
+export declare function isAppLinkField(schema: unknown): boolean;
+/** A document's `app-link` field, in zod/mini: at most 500 characters. */
+export declare const appLinkSchema: () => z.ZodMiniType;
+/** Another app, as the host says it to this viewer: its name, its icon, its home's headline, and where it opens. */
+export interface LinkedApp {
+    readonly name: string;
+    /** A picture the host serves (a path on the host or an http(s) address), or an emoji or a letter or two. */
+    readonly icon?: string;
+    /** What the app's home says first, in a line. */
+    readonly headline?: string;
+    /** Where the app opens: a path on the host or an http(s) address. */
+    readonly href: string;
+}
+/**
+ * THE HOST'S ANSWER for one address and one viewer: the app; `{ denied:
+ * true }` when this viewer may not open it (the field says "linked app (no
+ * access)" and nothing of it); or null when the host knows no such app (the
+ * field draws the address, plainly).
+ */
+export type AppResolution = LinkedApp | {
+    readonly denied: true;
+} | null;
+/**
+ * THE HOST'S WAY TO NAME ANOTHER APP (FR-171): handed to `mount`, `<Embed>`,
+ * `GraviewProvider` or the routed face as `resolveApp`. Asked once per
+ * address and viewer, and remembered; a throw is taken as null.
+ */
+export type ResolveApp = (address: string, viewer: {
+    readonly kind: string;
+    readonly id?: string | undefined;
+    readonly roles?: readonly string[] | undefined;
+}) => Promise<AppResolution>;
+//# sourceMappingURL=app-link.d.ts.map

package/dist/schema/app-link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-link.d.ts","sourceRoot":"","sources":["../../src/schema/app-link.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAC;AAsB9B,yFAAyF;AACzF,eAAO,MAAM,WAAW,QAAwE,CAAC;AAEjG,oIAAoI;AACpI,eAAO,MAAM,YAAY,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAAoF,CAAC;AAS5I,uDAAuD;AACvD,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,MAAM,EAAE,QAAQ,CAAC,KAAG,CAA8F,CAAC;AAEzJ,0FAA0F;AAC1F,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAGvD;AAED,0EAA0E;AAC1E,eAAO,MAAM,aAAa,QAAO,CAAC,CAAC,WAA6G,CAAC;AAEjJ,oHAAoH;AACpH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,4GAA4G;IAC5G,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,iDAAiD;IACjD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,qEAAqE;IACrE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAA;CAAE,GAAG,IAAI,CAAC;AAEzE;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;CAAE,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC"}

package/dist/schema/app-link.js

@@ -0,0 +1,40 @@
+import * as z from "./zod.js";
+import { defOf } from "./zod.js";
+/*
+ * A LINK TO ANOTHER APP (FR-171).
+ *
+ * A relation's `to` names kinds inside one document, so a scenario in one
+ * app could not point at a house in another. This is the first step there:
+ * a field whose value is ANOTHER APP'S ADDRESS — `@nick/house`, an id the
+ * host knows its apps by (`app_kf5eydr9z58jzf`), or the app's absolute
+ * `https:` address. The record keeps the address as any other value; what
+ * the address is CALLED, and whether this viewer may open it, is the
+ * host's to say (`ResolveApp`), and the field draws as that app's name,
+ * icon and home headline rather than as the address.
+ *
+ * A hosted page loads this up front to build a document's fields, so it
+ * holds that and no more; what draws one is `@graview/primitives`'s,
+ * fetched with the first drawn. A relation whose `to` is another app's
+ * kind, an expression that walks it and the history of the far value are
+ * left for 0.2.
+ */
+/** What an app-link field holds: `@owner/app`, an id, or an absolute http(s) address. */
+export const APP_ADDRESS = /^(?:https?:\/\/[^\s<>"'`\\]+|@?[A-Za-z0-9][\w.~-]*(?:\/[\w.~-]+)*)$/;
+/** Whether a value is another app's address: `@owner/app`, an app id, or an absolute http(s) address, of at most 500 characters. */
+export const isAppAddress = (value) => typeof value === "string" && value.length < 501 && APP_ADDRESS.test(value);
+/*
+ * WHICH FIELDS HOLD AN APP'S ADDRESS: a mark on the schema's def, as a file
+ * field is marked (`files.ts`), so a clone shares it, a refinement spreads it
+ * and a wrapper holds it inside.
+ */
+const APP_LINK = Symbol.for("@graview/core:app-link");
+/** Marks a schema as holding another app's address. */
+export const markAppLink = (schema) => (Object.defineProperty(defOf(schema), APP_LINK, { value: 1, enumerable: true }), schema);
+/** Whether a field holds another app's address — under optional, default and nullable. */
+export function isAppLinkField(schema) {
+    const def = defOf(schema);
+    return !!def && (def[APP_LINK] === 1 || isAppLinkField(def.innerType));
+}
+/** A document's `app-link` field, in zod/mini: at most 500 characters. */
+export const appLinkSchema = () => markAppLink(z.string().check(z.maxLength(500), z.regex(APP_ADDRESS, "another app's address")));
+//# sourceMappingURL=app-link.js.map

package/dist/schema/app-link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-link.js","sourceRoot":"","sources":["../../src/schema/app-link.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAC;AAC9B,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEjC;;;;;;;;;;;;;;;;;GAiBG;AAEH,yFAAyF;AACzF,MAAM,CAAC,MAAM,WAAW,GAAG,qEAAqE,CAAC;AAEjG,oIAAoI;AACpI,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAc,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAE5I;;;;GAIG;AACH,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;AAEtD,uDAAuD;AACvD,MAAM,CAAC,MAAM,WAAW,GAAG,CAAmB,MAAS,EAAK,EAAE,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,MAAM,CAAE,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;AAEzJ,0FAA0F;AAC1F,MAAM,UAAU,cAAc,CAAC,MAAe;IAC5C,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAwD,CAAC;IACjF,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;AACzE,CAAC;AAED,0EAA0E;AAC1E,MAAM,CAAC,MAAM,aAAa,GAAG,GAAkB,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,uBAAuB,CAAC,CAAC,CAAC,CAAC"}

package/dist/schema/define-node.d.ts

@@ -1,5 +1,5 @@
 import type { z } from "zod";
-import { type FileValue } from "./files.js";
+import type { FileValue } from "./files.js";
 import type { AnyNodeDefinition, EdgeMap, EmptyEdgeMap, NodeDefinition, NodeDefinitionSpec } from "./types.js";
 /**
  * The single declaration everything else derives from. Views, agent tool
@@ -19,19 +19,6 @@ export declare function isCurrent(definition: AnyNodeDefinition | undefined, nod
     id: string;
     kind: string;
 } & Record<string, unknown>, today?: string): boolean;
-/**
- * WHAT TELLS TWO SAME-NAMED THINGS APART, among the nodes a person is
- * choosing from. A single and its album are both "Blue Hour", and every
- * picker, every ask and the Find strip listed "Blue Hour, Blue Hour": a
- * choice nobody could make. For each node whose name another in the list
- * shares, the first fact that differs between them — "single" and "album",
- * or the dates — else its kind, else its id. Nodes with a name of their
- * own get nothing.
- */
-export declare function tellApart(nodes: readonly ({
-    id: string;
-    kind: string;
-} & Record<string, unknown>)[], definitionOf: (kind: string) => AnyNodeDefinition | undefined): Map<string, string>;
 /** Resolves a node's display label, honoring the declaration's override. */
 export declare function labelOf(definition: AnyNodeDefinition | undefined, node: {
     id: string;
@@ -50,11 +37,6 @@ export declare function labelOf(definition: AnyNodeDefinition | undefined, node:
  * is a heading that ignores the limit it was given.
  */
 export declare function summarize(text: string, max?: number): string;
-/** Resolves a node's prose description, used for a11y and tool text. */
-export declare function describeNode(definition: AnyNodeDefinition | undefined, node: {
-    id: string;
-    kind: string;
-} & Record<string, unknown>): string;
 /** One field, as a person sees it. */
 export interface ReadableField {
     readonly key: string;
@@ -64,6 +46,23 @@ export interface ReadableField {
      * and its words are their names. A glance leaves them out of its words.
      */
     readonly files?: readonly FileValue[];
+    /**
+     * ANOTHER APP'S ADDRESS (FR-171), where the field links to one: a record
+     * draws it as the app the host's `resolveApp` names, never as the
+     * address. A glance leaves it out of its words, as it does a file.
+     */
+    readonly app?: string;
+    /**
+     * A DATE THAT MAY REPEAT (`repeat.ts`): its value says how and the next
+     * one ("Every Tuesday, next Oct 27"), and a record draws, beside it, the
+     * control that changes how it repeats (`<field>Repeat`).
+     */
+    readonly repeats?: true;
+    /**
+     * WHERE A PHONE OR A PLACE TAKES ITS READER: a `tel:` link, or the
+     * reader's maps app. A face draws the value as a link to it.
+     */
+    readonly href?: string;
     /** The field name in words, after `display.labels` and humanizing. */
     readonly label: string;
     /** The value in words, after `display.format` and the built-in defaults: a day as a person reads it, a choice as it is declared. */
@@ -89,6 +88,13 @@ export interface ReadableField {
      * edits it in a text area.
      */
     readonly long: boolean;
+    /**
+     * WRITTEN IN MARKDOWN (FR-180): the declaration says so
+     * (`markdownField()`, `{"type": "text", "format": "markdown"}`). A
+     * record's page draws it as prose; a glance says its start with the
+     * syntax taken out.
+     */
+    readonly markdown?: true;
 }
 /** `effectiveFrom` shown to a person is a schema leaking through a surface. */
 /**
@@ -108,13 +114,6 @@ export declare function humanizeField(field: string): string;
  * so `plannedAt` never reaches a person from one surface while another says
  * "Planned at".
  */
-/**
- * One of a field's values, as the declaration says it: its `display.format`
- * where it has one ("SUV", "Plug-in hybrid"), else the value spoken. A
- * filter that offered "suv" and "plug-in-hybrid" beside a record that said
- * "SUV" and "Plug-in hybrid" read one field two ways.
- */
-export declare function valueWords(definition: AnyNodeDefinition | undefined, key: string, value: unknown): string;
 /**
  * HOW MANY OF A KIND, in its words: "1 car", "3 cars", "1 test drive" —
  * the noun for one, the plural for the rest. Sentences that took the kind's
@@ -149,18 +148,6 @@ export declare function pluralLabel(schema: {
         readonly plural?: string;
     } | undefined;
 }, kind: string): string;
-/**
- * A RELATION IN WORDS, read from the end you are standing on (FR-142): from
- * the kind that declares it, its `description`; from the far end, its
- * `inverse`. Where the declaration says nothing, the key is spoken —
- * "partOf" is "part of", never `partOf` — so a sentence a person reads never
- * carries a key, whichever surface wrote it.
- */
-export declare function edgeWords(schema: {
-    tryDefinition(kind: string): {
-        readonly edges?: unknown;
-    } | undefined;
-}, ownerKind: string, edgeKind: string, direction: "out" | "in"): string;
 export declare function fieldWords(definition: {
     readonly display?: {
         readonly labels?: Readonly<Record<string, string>>;
@@ -186,60 +173,4 @@ export declare function withArticle(word: string): string;
 export declare function nounOf(definition: {
     readonly noun?: string;
 } | undefined, kind: string): string;
-/**
- * WHICH of a node's fields a person sees, and HOW each one reads.
- *
- * One implementation, because there were two: the record on a page and the
- * summary on a card each decided this for themselves, and every rule — hide an
- * ordering key, format minutes as a time, render a boolean as a word, drop a
- * value the heading already said — had to be written into both and kept in
- * step by hand. They diverged the day the second one was written, which is how
- * a summary card ended up showing a list's ordering key as a chip reading "0"
- * while the page beside it did not.
- *
- * `said` is what the surrounding view has already put on screen. A value the
- * heading already carries is not information twice, it is the same sentence
- * twice — and where the heading is a SHORTENED form of a field, an exact
- * comparison never catches it, so the summary's stem is compared too.
- */
-export declare function readableFields(node: Record<string, unknown>, definition: AnyNodeDefinition | undefined, options?: {
-    /** How many a GLANCE shows. Unset, every field: a record is read whole (W-156). */
-    readonly limit?: number;
-    readonly said?: readonly (string | undefined)[];
-    /**
-     * A GLANCE drops a value the heading already says as a WORD, not only as
-     * the whole heading: a vehicle's summary is headed "2027 Subaru Forester
-     * Sport", and "Year 2027 · Subaru" under it spent two of its three facts
-     * saying the heading again while the price never appeared. A record's
-     * full facts keep every field — that is where each is changed.
-     */
-    readonly glance?: boolean;
-}): readonly ReadableField[];
-/**
- * WHETHER A FIELD'S VALUE IS PROSE (FR-147): a string field declared to hold
- * more than 500 characters — a document's `text`, or `z.string().max(5000)`
- * in TypeScript — whatever it holds now, so an empty draft is still edited
- * in a text area; or a value with a line break in it, or longer than 160
- * characters.
- */
-export declare function isLongText(definition: AnyNodeDefinition | undefined, key: string, value: unknown): boolean;
-/** One run of a record's facts: under a group's title, or (the first) under none. */
-export interface FieldSection<F extends {
-    readonly key: string;
-} = ReadableField> {
-    readonly title?: string;
-    readonly fields: readonly F[];
-}
-/**
- * A RECORD'S FACTS, IN THE SECTIONS ITS PAGE DECLARES (FR-148).
- *
- * `fields` are read as `readableFields` ordered them. Unsaid, one untitled
- * section of all of them. With `display.page`, its `fields` first, untitled;
- * each of its `groups` under its title; and what neither names under
- * "Details" when there are groups, else after the first fields. A section
- * with nothing to show is left out.
- */
-export declare function pageSections<F extends {
-    readonly key: string;
-}>(definition: AnyNodeDefinition | undefined, fields: readonly F[]): readonly FieldSection<F>[];
 //# sourceMappingURL=define-node.d.ts.map

package/dist/schema/define-node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"define-node.d.ts","sourceRoot":"","sources":["../../src/schema/define-node.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"define-node.d.ts","sourceRoot":"","sources":["../../src/schema/define-node.ts"],"names":[],"mappings":"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"}

package/dist/schema/define-node.js

@@ -1,6 +1,5 @@
-import { dayAsRead, ISO_DAY, isoToday } from "../days.js";
+import { isoToday, numberAsRead } from "../days.js";
 import { capitalize } from "../capital.js";
-import { filesOf } from "./files.js";
 /**
  * The single declaration everything else derives from. Views, agent tool
  * schemas, drag legality, aggregate contents and accessibility labels all
@@ -35,48 +34,6 @@ export function isCurrent(definition, node, today) {
     }
     return !lifecycle.retired.includes(value);
 }
-/**
- * WHAT TELLS TWO SAME-NAMED THINGS APART, among the nodes a person is
- * choosing from. A single and its album are both "Blue Hour", and every
- * picker, every ask and the Find strip listed "Blue Hour, Blue Hour": a
- * choice nobody could make. For each node whose name another in the list
- * shares, the first fact that differs between them — "single" and "album",
- * or the dates — else its kind, else its id. Nodes with a name of their
- * own get nothing.
- */
-export function tellApart(nodes, definitionOf) {
-    const apart = new Map();
-    const byName = new Map();
-    for (const node of nodes) {
-        const name = labelOf(definitionOf(node.kind), node).trim().toLowerCase();
-        byName.set(name, [...(byName.get(name) ?? []), node]);
-    }
-    for (const same of byName.values()) {
-        if (same.length < 2)
-            continue;
-        const byKind = new Map();
-        for (const node of same)
-            byKind.set(node.kind, [...(byKind.get(node.kind) ?? []), node]);
-        for (const [kind, alike] of byKind) {
-            // One of its kind among namesakes of other kinds: the kind is what differs.
-            if (alike.length === 1) {
-                apart.set(alike[0].id, nounOf(definitionOf(kind), kind));
-                continue;
-            }
-            const facts = alike.map((node) => new Map(readableFields(node, definitionOf(node.kind)).map((field) => [field.key, field.alone])));
-            const keys = [...new Set(facts.flatMap((fact) => [...fact.keys()]))];
-            // A word before a number: "single" and "album" say more than two dates.
-            const wordy = (key) => facts.every((fact) => !/\d/.test(fact.get(key) ?? ""));
-            const ordered = [...keys.filter(wordy), ...keys.filter((key) => !wordy(key))];
-            const telling = ordered.find((key) => new Set(facts.map((fact) => fact.get(key) ?? "")).size === alike.length);
-            alike.forEach((node, at) => {
-                const fact = telling ? facts[at].get(telling) : undefined;
-                apart.set(node.id, fact ?? node.id);
-            });
-        }
-    }
-    return apart;
-}
 /** Resolves a node's display label, honoring the declaration's override. */
 export function labelOf(definition, node) {
     if (definition?.label) {
@@ -106,15 +63,6 @@ export function summarize(text, max = 60) {
     // A trailing comma or full stop before the ellipsis reads as a typo.
     return `${(boundary > max * 0.5 ? cut.slice(0, boundary) : cut).replace(/[\s,.;:]+$/, "")}…`;
 }
-/** Resolves a node's prose description, used for a11y and tool text. */
-export function describeNode(definition, node) {
-    if (definition?.describe) {
-        return definition.describe(node);
-    }
-    return `${node.kind} ${labelOf(definition, node)}`;
-}
-/** Never shown: identity and the name, which the heading already is. */
-const NOT_A_FIELD = new Set(["id", "kind", "label"]);
 /** `effectiveFrom` shown to a person is a schema leaking through a surface. */
 /**
  * WHAT AN ACT IS CALLED, everywhere it is offered — the actions strip, the
@@ -139,16 +87,6 @@ export function humanizeField(field) {
  * so `plannedAt` never reaches a person from one surface while another says
  * "Planned at".
  */
-/**
- * One of a field's values, as the declaration says it: its `display.format`
- * where it has one ("SUV", "Plug-in hybrid"), else the value spoken. A
- * filter that offered "suv" and "plug-in-hybrid" beside a record that said
- * "SUV" and "Plug-in hybrid" read one field two ways.
- */
-export function valueWords(definition, key, value) {
-    const format = definition?.display?.format?.[key];
-    return format ? format(value) : typeof value === "string" ? humanizeField(value) : String(value);
-}
 /**
  * HOW MANY OF A KIND, in its words: "1 car", "3 cars", "1 test drive" —
  * the noun for one, the plural for the rest. Sentences that took the kind's
@@ -157,7 +95,8 @@ export function valueWords(definition, key, value) {
  */
 export function counted(schema, kind, count) {
     const definition = schema.tryDefinition(kind);
-    return `${count} ${count === 1 ? nounOf(definition, kind) : pluralOf(schema, kind).toLowerCase()}`;
+    // A count is a figure, said in the page's locale like every other (W-198): "7,540 inspections", never "7540".
+    return `${numberAsRead(count)} ${count === 1 ? nounOf(definition, kind) : pluralOf(schema, kind).toLowerCase()}`;
 }
 /**
  * WHAT A KIND'S RECORDS ARE CALLED TOGETHER, inside a sentence: its
@@ -177,19 +116,6 @@ export function pluralOf(schema, kind) {
 export function pluralLabel(schema, kind) {
     return capitalize(pluralOf(schema, kind));
 }
-/**
- * A RELATION IN WORDS, read from the end you are standing on (FR-142): from
- * the kind that declares it, its `description`; from the far end, its
- * `inverse`. Where the declaration says nothing, the key is spoken —
- * "partOf" is "part of", never `partOf` — so a sentence a person reads never
- * carries a key, whichever surface wrote it.
- */
-export function edgeWords(schema, ownerKind, edgeKind, direction) {
-    const edges = schema.tryDefinition(ownerKind)?.edges;
-    const declared = edges && Object.hasOwn(edges, edgeKind) ? edges[edgeKind] : undefined;
-    const said = direction === "out" ? declared?.description : declared?.inverse;
-    return said ?? humanizeField(edgeKind).toLowerCase();
-}
 export function fieldWords(definition, key) {
     // A computed field's own label is its words too (FR-83), where the display does not say otherwise.
     const computed = definition?.computed && Object.hasOwn(definition.computed, key) ? definition.computed[key] : undefined;
@@ -238,174 +164,4 @@ export function withArticle(word) {
 export function nounOf(definition, kind) {
     return definition?.noun ?? humanizeField(kind).toLowerCase();
 }
-/** Whether `line` carries `value` as whole words: "2027 Subaru Forester" says "Subaru" and "2027", not "Sub". */
-function saysAsWords(line, value) {
-    if (value.length === 0)
-        return false;
-    const escaped = value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-    return new RegExp(`(^|[\\s·,(/])${escaped}($|[\\s·,)/])`).test(line);
-}
-/**
- * WHICH of a node's fields a person sees, and HOW each one reads.
- *
- * One implementation, because there were two: the record on a page and the
- * summary on a card each decided this for themselves, and every rule — hide an
- * ordering key, format minutes as a time, render a boolean as a word, drop a
- * value the heading already said — had to be written into both and kept in
- * step by hand. They diverged the day the second one was written, which is how
- * a summary card ended up showing a list's ordering key as a chip reading "0"
- * while the page beside it did not.
- *
- * `said` is what the surrounding view has already put on screen. A value the
- * heading already carries is not information twice, it is the same sentence
- * twice — and where the heading is a SHORTENED form of a field, an exact
- * comparison never catches it, so the summary's stem is compared too.
- */
-export function readableFields(node, definition, options = {}) {
-    const display = definition?.display;
-    const skip = new Set([...NOT_A_FIELD, ...(display?.hide ?? [])]);
-    const said = (options.said ?? []).filter((text) => Boolean(text));
-    const stems = said
-        .filter((text) => text.endsWith("…"))
-        .map((text) => text.replace(/…$/, "").trim())
-        .filter((stem) => stem.length > 12);
-    const fields = [];
-    /*
-     * IN THE ORDER THE DECLARATION SAYS, NOT THE ORDER THE RECORD WAS WRITTEN
-     * IN (FR-148). This read `Object.entries(node)`, so a record created with
-     * three of its fields and given two more later read Status, Summary, Due,
-     * Draft, Subject line — the order of its writes, which nobody chose.
-     * A glance says what the declaration chose for it first (`display.glance`);
-     * a record's page, what its page chose (`display.page`); then the fields
-     * as the kind declares them, its computed ones after.
-     */
-    // Unchosen, a glance leads with who made the record and when, where the kind's roles say (`fieldRoles.who`, `.when`).
-    const roles = definition?.fieldRoles;
-    const chosen = options.glance ? (display?.glance ?? [roles?.["who"], roles?.["when"]].filter((key) => !!key)) : pageOrder(display?.page);
-    const keys = [...new Set([...chosen, ...declaredOrder(definition), ...Object.keys(node)])].filter((key) => Object.hasOwn(node, key));
-    const entries = keys.map((key) => [key, node[key]]);
-    for (const [key, value] of entries) {
-        if (skip.has(key) || value === undefined || value === null)
-            continue;
-        const format = display?.format?.[key];
-        // A picture or a document (FR-162) is drawn, not said on a glance; its words are its names.
-        const files = format ? [] : filesOf(value);
-        if (files[0] && options.glance)
-            continue;
-        /*
-         * A NESTED OBJECT HAS NO ONE-LINE RENDERING, and inventing one is worse
-         * than leaving it to a view that knows what it is.
-         *
-         * That was true of an object and was not checked of an ARRAY of them,
-         * which fell through to `join(", ")` — so a piece of ground with a
-         * five-corner outline had a field on its record reading "[object
-         * Object], [object Object], [object Object], [object Object]". Nobody
-         * wrote that; nobody could have read it. The shape is drawn on the map
-         * and belongs there, not in a list of words.
-         *
-         * A declaration that HAS a one-line rendering says so with `format`,
-         * and then it is the declaration's sentence rather than this one's
-         * guess — "5 corners" is a useful thing to say and only the app knows
-         * that the numbers are corners.
-         */
-        const nested = !files[0] &&
-            typeof value === "object" &&
-            (!Array.isArray(value) || value.some((one) => typeof one === "object" && one !== null));
-        if (nested && format === undefined)
-            continue;
-        const stored = files[0] ? files.map((file) => (file.caption ? `${file.name} — ${file.caption}` : file.name)).join(", ") : Array.isArray(value) ? value.join(", ") : typeof value === "boolean" ? (value ? "Yes" : "No") : String(value);
-        const text = format
-            ? format(value)
-            : Array.isArray(value) || typeof value === "boolean"
-                ? // Nobody says "false". A boolean is a state, and the words for a
-                    // state are words.
-                    stored
-                : /*
-                   * A DAY AS A PERSON READS IT ("28 Aug 2026"), on a glance and in a
-                   * record's facts alike; the edit control holds it as it is written
-                   * (`stored`). And a CHOICE as it is declared — its `display.format`,
-                   * else the value spoken — never the code it is kept as ("tue").
-                   */
-                    typeof value === "string" && ISO_DAY.test(value)
-                        ? dayAsRead(value)
-                        : typeof value === "string" && isChoice(definition, key)
-                            ? valueWords(definition, key, value)
-                            : stored;
-        if (said.includes(text) || stems.some((stem) => text.startsWith(stem)))
-            continue;
-        if (options.glance && (typeof value === "string" || typeof value === "number") && said.some((line) => saysAsWords(line, text)))
-            continue;
-        const label = fieldWords(definition, key);
-        const alone = 
-        // A yes or no the kind words itself ("Not yet inducted") is said whole; "Inducted: not yet inducted" said it twice (W-187).
-        typeof value === "number" ? `${label} ${text}` : typeof value === "boolean" && !format ? `${label}: ${text.toLowerCase()}` : text;
-        fields.push({ key, label, value: text, stored, alone, long: typeof value === "string" && isLongText(definition, key, text), ...(files[0] ? { files } : {}) });
-        if (options.limit !== undefined && fields.length >= options.limit)
-            break;
-    }
-    return fields;
-}
-/** Whether a field is one of a declared set of values (`z.enum`), under optional, default and nullable. */
-function isChoice(definition, key) {
-    let at = definition?.fields?.shape?.[key];
-    for (let depth = 0; depth < 6 && at?._zod?.def?.innerType !== undefined; depth++)
-        at = at._zod.def.innerType;
-    return at?._zod?.def?.type === "enum";
-}
-/** The kind's fields as it declares them, then its computed fields. */
-function declaredOrder(definition) {
-    const shape = definition?.fields?.shape;
-    return [...Object.keys(shape ?? {}), ...Object.keys(definition?.computed ?? {})];
-}
-/** Every field a page names, in the order it names them: its first fields, then each group's. */
-function pageOrder(page) {
-    return [...(page?.fields ?? []), ...(page?.groups ?? []).flatMap((group) => group.fields)];
-}
-/** What a string field may hold beyond which it is prose: a document's `string` holds 500, its `text` 20,000. */
-const PROSE_ALLOWED = 500;
-/** A value this long, or with a line break in it, is read as prose whatever its field allows. */
-const PROSE_LENGTH = 160;
-/** The string schema under optional, default and nullable. */
-function stringSchema(schema) {
-    let at = schema;
-    for (let depth = 0; depth < 6 && at?._zod?.def?.innerType !== undefined; depth++)
-        at = at._zod.def.innerType;
-    return at?._zod?.def?.type === "string" ? at._zod.def : undefined;
-}
-/**
- * WHETHER A FIELD'S VALUE IS PROSE (FR-147): a string field declared to hold
- * more than 500 characters — a document's `text`, or `z.string().max(5000)`
- * in TypeScript — whatever it holds now, so an empty draft is still edited
- * in a text area; or a value with a line break in it, or longer than 160
- * characters.
- */
-export function isLongText(definition, key, value) {
-    const field = stringSchema(definition?.fields?.shape?.[key]);
-    if (field?.checks?.some((check) => check._zod?.def?.check === "max_length" && (check._zod.def.maximum ?? 0) > PROSE_ALLOWED))
-        return true;
-    return typeof value === "string" && (value.includes("\n") || value.length > PROSE_LENGTH);
-}
-/**
- * A RECORD'S FACTS, IN THE SECTIONS ITS PAGE DECLARES (FR-148).
- *
- * `fields` are read as `readableFields` ordered them. Unsaid, one untitled
- * section of all of them. With `display.page`, its `fields` first, untitled;
- * each of its `groups` under its title; and what neither names under
- * "Details" when there are groups, else after the first fields. A section
- * with nothing to show is left out.
- */
-export function pageSections(definition, fields) {
-    const page = definition?.display?.page;
-    const groups = page?.groups ?? [];
-    const byKey = new Map(fields.map((field) => [field.key, field]));
-    const named = new Set(pageOrder(page));
-    const pick = (keys) => keys.flatMap((key) => (byKey.has(key) ? [byKey.get(key)] : []));
-    const rest = fields.filter((field) => !named.has(field.key));
-    const sections = [
-        { fields: [...pick(page?.fields ?? []), ...(groups.length > 0 ? [] : rest)] },
-        ...groups.map((group) => ({ title: group.title, fields: pick(group.fields) })),
-        ...(groups.length > 0 ? [{ title: "Details", fields: rest }] : []),
-    ];
-    return sections.filter((section) => section.fields.length > 0);
-}
 //# sourceMappingURL=define-node.js.map