@graview/core 0.1.28 → 0.1.30

package/dist/schema/amount-words.d.ts

@@ -0,0 +1,12 @@
+import type { AmountMark } from "./amount-mark.js";
+/** Whether a unit names a currency: three capital letters, "USD", "EUR". */
+export declare const isCurrencyCode: (unit: string | undefined) => unit is string;
+/**
+ * A field's mark as its readers take it: a unit that is a currency ("EUR")
+ * makes the number money in that currency; money names its currency (the
+ * field's own, else the app's) and no unit beside it.
+ */
+export declare function amountMark(mark: AmountMark): AmountMark;
+/** What an amount is, in a sentence a model or a reader of the declaration can act on: "An amount of money in USD: a plain number, 1250.5 for 1,250.50 USD." */
+export declare function amountSentence(mark: AmountMark): string;
+//# sourceMappingURL=amount-words.d.ts.map

package/dist/schema/amount-words.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"amount-words.d.ts","sourceRoot":"","sources":["../../src/schema/amount-words.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAQnD,4EAA4E;AAC5E,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,GAAG,SAAS,KAAG,IAAI,IAAI,MAAuC,CAAC;AAE1G;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAMvD;AAED,gKAAgK;AAChK,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CASvD"}

package/dist/schema/amount-words.js

@@ -0,0 +1,31 @@
+/*
+ * WHAT AN AMOUNT IS, for what asks for one or tells of one — a form, a
+ * tool's schema, `describeApp`, an edit's sentence — and never for what a
+ * page draws first, which says the value (`sayAmount`) and no more.
+ */
+/** Whether a unit names a currency: three capital letters, "USD", "EUR". */
+export const isCurrencyCode = (unit) => /^[A-Z]{3}$/.test(unit ?? "");
+/**
+ * A field's mark as its readers take it: a unit that is a currency ("EUR")
+ * makes the number money in that currency; money names its currency (the
+ * field's own, else the app's) and no unit beside it.
+ */
+export function amountMark(mark) {
+    const { format, unit, currency, locale } = mark;
+    const code = isCurrencyCode(unit);
+    const money = format === "money" || (!format && code);
+    const named = money ? (code ? unit : currency) : undefined;
+    return { ...(money ? { format: "money" } : format ? { format } : {}), ...(unit && !(money && code) ? { unit } : {}), ...(named ? { currency: named } : {}), ...(locale ? { locale } : {}) };
+}
+/** What an amount is, in a sentence a model or a reader of the declaration can act on: "An amount of money in USD: a plain number, 1250.5 for 1,250.50 USD." */
+export function amountSentence(mark) {
+    switch (mark.format) {
+        case "money":
+            return mark.currency ? `An amount of money in ${mark.currency}: a plain number, 1250.5 for 1,250.50 ${mark.currency}.` : "An amount of money, in no named currency: a plain number.";
+        case "percent":
+            return "A fraction said as a percent: 0.15 is 15%.";
+        default:
+            return mark.unit ? `A number of ${mark.unit}.` : "A number.";
+    }
+}
+//# sourceMappingURL=amount-words.js.map

package/dist/schema/amount-words.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"amount-words.js","sourceRoot":"","sources":["../../src/schema/amount-words.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH,4EAA4E;AAC5E,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAAwB,EAAkB,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;AAE1G;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,IAAgB;IACzC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAChD,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,KAAK,GAAG,MAAM,KAAK,OAAO,IAAI,CAAC,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC;IACtD,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3D,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAgB,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AACvM,CAAC;AAED,gKAAgK;AAChK,MAAM,UAAU,cAAc,CAAC,IAAgB;IAC7C,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;QACpB,KAAK,OAAO;YACV,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,yBAAyB,IAAI,CAAC,QAAQ,yCAAyC,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,2DAA2D,CAAC;QACvL,KAAK,SAAS;YACZ,OAAO,4CAA4C,CAAC;QACtD;YACE,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC;IACjE,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,5 @@
+/** 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;
+//# sourceMappingURL=app-address.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"app-address.d.ts","sourceRoot":"","sources":["../../src/schema/app-address.ts"],"names":[],"mappings":"AAMA,yFAAyF;AACzF,eAAO,MAAM,WAAW,QAAwE,CAAC;AAEjG,oIAAoI;AACpI,eAAO,MAAM,YAAY,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAAoF,CAAC"}

package/dist/schema/app-address.js

@@ -0,0 +1,10 @@
+/*
+ * ANOTHER APP'S ADDRESS (FR-171), with nothing of zod: the rule language
+ * reads a link to another app's record through it, and a page that judges
+ * a rule must not carry zod for it (the guest host does not).
+ */
+/** 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);
+//# sourceMappingURL=app-address.js.map

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

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

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,38 @@
+import * as z from "./zod.js";
+export { APP_ADDRESS, isAppAddress } from "./app-address.js";
+/** 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;AAI9B,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AA4B7D,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,38 @@
+import * as z from "./zod.js";
+import { defOf } from "./zod.js";
+import { APP_ADDRESS } from "./app-address.js";
+export { APP_ADDRESS, isAppAddress } from "./app-address.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 a KIND in another
+ * app — a record there, walked by an expression, its changes kept in this
+ * app's history — is `linked.ts`'s.
+ */
+/*
+ * 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;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAE7D;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;;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,6 @@
 import type { z } from "zod";
-import { type FileValue } from "./files.js";
+import type { FileValue } from "./files.js";
+import type { LinkedRecordRef, LinkedRelation } from "./linked.js";
 import type { AnyNodeDefinition, EdgeMap, EmptyEdgeMap, NodeDefinition, NodeDefinitionSpec } from "./types.js";
 /**
  * The single declaration everything else derives from. Views, agent tool
@@ -19,19 +20,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 +38,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 +47,32 @@ 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;
+    /**
+     * RECORDS IN ANOTHER APP (FR-171), where the field keeps a relation to
+     * one: a record draws each with its own card and describe line, read
+     * there as the viewer — never what the link keeps. A glance leaves it out.
+     */
+    readonly linked?: {
+        readonly relation: LinkedRelation;
+        readonly refs: readonly LinkedRecordRef[];
+    };
+    /**
+     * 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 +98,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 +124,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 +158,12 @@ 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: {
+/** A kind's whole list, said beside a place that has its name (`pages-place-named-as-a-list`): "All root causes". */
+export declare function allLabel(schema: {
     tryDefinition(kind: string): {
-        readonly edges?: unknown;
+        readonly plural?: string;
     } | undefined;
-}, ownerKind: string, edgeKind: string, direction: "out" | "in"): string;
+}, kind: string): string;
 export declare function fieldWords(definition: {
     readonly display?: {
         readonly labels?: Readonly<Record<string, string>>;
@@ -186,60 +189,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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"}