@graview/core 0.1.28 → 0.1.30

package/dist/schema/json-schema.js

@@ -1,16 +1,31 @@
+import { ARCHIVED, LEFT_ALONE } from "../graph/archived.js";
 import * as z from "./zod.js";
 import { argumentsTaken, takesAnId } from "../mutations/define-mutation.js";
 import { nodeRefArgs } from "../mutations/node-ref.js";
+import { isAppLinkField } from "./app-link.js";
+import { linkedRelationOf } from "./linked.js";
+import { EVERY, isRepeatField, WEEKDAYS } from "../repeat.js";
+import { isMarkdownField } from "./markdown.js";
+import { typedFieldOf } from "./typed-field-of.js";
+import { amountOf } from "./amount-mark.js";
+import { amountMark, amountSentence } from "./amount-words.js";
+import { writeJsonSchema } from "./to-json-schema.js";
 /**
  * One source, three outputs: the same Zod declaration produces runtime
  * validation, TypeScript inference, and the JSON Schema an agent tool
  * definition needs. Nothing is written twice, so nothing drifts.
  */
 export function toJsonSchema(schema) {
-    return z.toJSONSchema(schema, { io: "input", unrepresentable: "any", override: formatsByName });
+    return writeJsonSchema(schema, formatsByName);
 }
 /** zod's names for string formats that JSON Schema calls something else; the rest are the same word. */
 const JSON_SCHEMA_FORMATS = { guid: "uuid", url: "uri", datetime: "date-time", json_string: "json-string" };
+/** What a phone, a place and a duration hold, for an agent, where the field says nothing of itself. */
+const TYPED_WORDS = {
+    phone: "A phone number as it is written, like +1 555 123 4567 or 020 7946 0958 ext. 12.",
+    place: "An address or a place's name, as a person would search a map for it.",
+    duration: "A length of time in whole minutes: 90 is 1 h 30 min.",
+};
 /*
  * A FORMAT IS SAID BY ITS NAME (a tool schema is a stability surface). zod
  * writes its own regex for `z.email()`, `z.uuid()`, `z.iso.datetime()` beside
@@ -19,7 +34,64 @@ const JSON_SCHEMA_FORMATS = { guid: "uuid", url: "uri", datetime: "date-time", j
  * A string format says `format` and nothing else; a pattern the author wrote
  * with `.regex(…)` is the author's, and is kept.
  */
-function formatsByName(ctx) {
+export function formatsByName(ctx) {
+    // Another app's address (FR-171), beside its pattern: an agent sets an address, not a name.
+    if (isAppLinkField(ctx.zodSchema))
+        ctx.jsonSchema["x-graview-app-link"] = true;
+    /*
+     * A RECORD IN ANOTHER APP (FR-171): which app and kinds, and how one is
+     * written — `house:<id>`, an id the host's search finds there (the seat's
+     * `find_linked`). The far app is read as the viewer, and never changed.
+     */
+    const linked = linkedRelationOf(ctx.zodSchema);
+    if (linked && (ctx.jsonSchema["type"] === "string" || ctx.jsonSchema["type"] === "array")) {
+        ctx.jsonSchema["x-graview-linked"] = { address: linked.address, kinds: [...linked.kinds], cardinality: linked.cardinality };
+        const kinds = linked.kinds.join(" or ");
+        const how = `${linked.cardinality === "many" ? "Records" : "A record"}: a ${kinds} in the app ${linked.address}, as "${linked.kinds[0]}:<id>" — an id found there with find_linked. Linking never changes that app.`;
+        const said = ctx.jsonSchema["description"];
+        if (!(typeof said === "string" && said.includes(how)))
+            ctx.jsonSchema["description"] = `${typeof said === "string" && said ? `${said.replace(/\.?$/, ".")} ` : ""}${how}`;
+    }
+    // How a date repeats, kept beside it as `<date>Repeat`: written out where a declaration checks it by a function of its own.
+    if (isRepeatField(ctx.zodSchema)) {
+        ctx.jsonSchema["x-graview-repeat"] = true;
+        if (!ctx.jsonSchema["type"] && !ctx.jsonSchema["anyOf"] && !ctx.jsonSchema["oneOf"])
+            Object.assign(ctx.jsonSchema, repeatJson());
+    }
+    // Prose in Markdown (FR-180): a caller writes Markdown, and it is kept as written.
+    if (isMarkdownField(ctx.zodSchema)) {
+        ctx.jsonSchema["contentMediaType"] = "text/markdown";
+        // Said in words too: not every tool caller reads `contentMediaType`.
+        const said = ctx.jsonSchema["description"];
+        if (!(typeof said === "string" && said.endsWith("Written in Markdown.")))
+            ctx.jsonSchema["description"] = `${typeof said === "string" && said ? `${said.replace(/\.?$/, ".")} ` : ""}Written in Markdown.`;
+    }
+    /*
+     * A PHONE, A PLACE OR A DURATION says which (`x-graview-type`), so an agent
+     * sends the shape the field keeps: a phone as it is written, a place as an
+     * address or a name, and a duration as WHOLE MINUTES — 90, never "1h 30m".
+     * Where the field says nothing of itself, its description says the same.
+     */
+    const typed = typedFieldOf(ctx.zodSchema);
+    if (typed) {
+        const js = ctx.jsonSchema;
+        js["x-graview-type"] = typed;
+        if (typed === "duration")
+            js["x-graview-unit"] = "minutes";
+        js["description"] ??= TYPED_WORDS[typed];
+    }
+    // An amount says what it is (money in USD, a percent as a fraction), so a model sets 10000, never "$10,000" or 15 for 15%.
+    const marked = amountOf(ctx.zodSchema, false);
+    if (marked) {
+        const amount = amountMark(marked);
+        ctx.jsonSchema["x-graview-format"] = amount.format ?? "unit";
+        if (amount.currency)
+            ctx.jsonSchema["x-graview-currency"] = amount.currency;
+        if (amount.unit && amount.format !== "money")
+            ctx.jsonSchema["x-graview-unit"] = amount.unit;
+        const said = ctx.jsonSchema["description"];
+        ctx.jsonSchema["description"] = typeof said === "string" && said.length > 0 ? `${said} ${amountSentence(amount)}` : amountSentence(amount);
+    }
     const def = ctx.zodSchema._zod?.def;
     if (!def || def.type !== "string" || typeof def.format !== "string" || def.format === "regex")
         return;
@@ -44,6 +116,13 @@ export function nodeJsonSchema(definition) {
     // The kind that stands for the people says so (Roadmap f-people-kind): a record's id is a member's principal id.
     if (definition.people)
         js["x-graview-people"] = true;
+    // A stored record may be archived (FR-173): the framework's mark, never a declared field.
+    const properties = js["properties"];
+    if (properties)
+        properties[ARCHIVED] = { type: "boolean", const: true, description: "Set when the record is archived: kept with its links and history, out of lists, counts and rules." };
+    // And a person may have said to leave it alone: no automated author changes it.
+    if (properties)
+        properties[LEFT_ALONE] = { type: "boolean", const: true, description: "Set when a person said to leave the record alone: no automated author changes it." };
     return js;
 }
 /**
@@ -90,6 +169,26 @@ export function mutationToolSchema(mutation) {
         nodeRefs: refs,
     };
 }
+/** How a date repeats, as JSON Schema: what `repeatSchema` checks, said for an agent. */
+function repeatJson() {
+    const day = { type: "string", pattern: "^\\d{4}-\\d{2}-\\d{2}$" };
+    const int = (minimum, maximum) => ({ type: "integer", minimum, maximum });
+    return {
+        type: "object",
+        description: 'How the date beside it repeats; the date is the first occurrence. "on" is weekdays for "week", days of the month (-1 the last) for "month".',
+        properties: {
+            every: { type: "string", enum: [...EVERY] },
+            interval: int(1, 99),
+            on: { type: "array", minItems: 1, maxItems: 31, items: { anyOf: [{ type: "string", enum: [...WEEKDAYS] }, int(-1, 31)] } },
+            until: day,
+            count: int(1, 1000),
+            except: { type: "array", maxItems: 500, items: day },
+            continues: { type: "string", maxLength: 200 },
+        },
+        required: ["every"],
+        additionalProperties: false,
+    };
+}
 /** Every node kind's JSON Schema, keyed by kind. */
 export function schemaJson(schema) {
     const out = {};

package/dist/schema/json-schema.js.map

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

package/dist/schema/linked-field.d.ts

@@ -0,0 +1,6 @@
+import { z } from "zod";
+export declare function linkedRecordField(target: string | readonly string[], options?: {
+    readonly cardinality?: "one" | "many";
+    readonly description?: string;
+}): z.ZodString | z.ZodArray<z.ZodString>;
+//# sourceMappingURL=linked-field.d.ts.map

package/dist/schema/linked-field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linked-field.d.ts","sourceRoot":"","sources":["../../src/schema/linked-field.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAkBxB,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,EAAE,OAAO,GAAE;IAAE,QAAQ,CAAC,WAAW,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAanM"}

package/dist/schema/linked-field.js

@@ -0,0 +1,34 @@
+import { z } from "zod";
+import { linkedRefOf, markLinked, parseLinkedTarget } from "./linked.js";
+/*
+ * A DECLARATION'S RELATION TO ANOTHER APP'S KIND (FR-171), in the classic
+ * zod a product writes its kinds in. A relation to another app is kept on
+ * the record that links, so in TypeScript it is a field:
+ *
+ *   fields: z.object({
+ *     name: z.string(),
+ *     forHouse: linkedRecordField("@nick/house/house").optional(),
+ *   })
+ *
+ * A document says the same as a relation, `"forHouse": { "to":
+ * ["@nick/house/house"], "cardinality": "one" }`. Its value is `house:<id>`
+ * (or a list of them, `{ cardinality: "many" }`); the host's
+ * `linkedRecords` says what that record is, as the viewer.
+ */
+export function linkedRecordField(target, options = {}) {
+    const targets = [target].flat();
+    const parsed = targets.map((one) => parseLinkedTarget(one));
+    if (parsed.length === 0 || parsed.some((one) => !one))
+        throw new Error(`linkedRecordField(${JSON.stringify(target)}): a target is "@", the app's address, "/" and the kind, like "@nick/house/house"`);
+    const address = parsed[0].address;
+    if (parsed.some((one) => one.address !== address))
+        throw new Error(`linkedRecordField(${JSON.stringify(target)}): a relation reaches one app`);
+    const relation = { address, kinds: [...new Set(parsed.map((one) => one.kind))], cardinality: options.cardinality ?? "one", ...(options.description ? { description: options.description } : {}) };
+    const one = z
+        .string()
+        .max(300)
+        .refine((value) => linkedRefOf(value, relation) !== undefined, `a record of ${relation.kinds.join(" or ")} in ${address}, as "<kind>:<id>"`);
+    const schema = relation.cardinality === "one" ? one : z.array(one).max(200);
+    return markLinked(options.description ? schema.describe(options.description) : schema, relation);
+}
+//# sourceMappingURL=linked-field.js.map

package/dist/schema/linked-field.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linked-field.js","sourceRoot":"","sources":["../../src/schema/linked-field.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,iBAAiB,EAAuB,MAAM,aAAa,CAAC;AAE9F;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAkC,EAAE,UAAoF,EAAE;IAC1J,MAAM,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IAChC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5D,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,mFAAmF,CAAC,CAAC;IACvM,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC,OAAO,CAAC;IACnC,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAI,CAAC,OAAO,KAAK,OAAO,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,+BAA+B,CAAC,CAAC;IAChJ,MAAM,QAAQ,GAAmB,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACnN,MAAM,GAAG,GAAG,CAAC;SACV,MAAM,EAAE;SACR,GAAG,CAAC,GAAG,CAAC;SACR,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,SAAS,EAAE,eAAe,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,OAAO,oBAAoB,CAAC,CAAC;IAC/I,MAAM,MAAM,GAAG,QAAQ,CAAC,WAAW,KAAK,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5E,OAAO,UAAU,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AACnG,CAAC"}

package/dist/schema/linked-reads.d.ts

@@ -0,0 +1,20 @@
+import type { LinkedReader, LinkedRecordAnswer, LinkedRecordRef, LinkedRecords, LinkedViewer } from "./linked.js";
+/** A page's reading of far records, as one viewer: at once, from the answers in. */
+export interface LinkedReads {
+    /** What the rule language reads through: an answer in, or unread — and asked for, once. */
+    readonly read: LinkedReader;
+    /** The host's answer for one record, asked once; a throw is null. */
+    ask(ref: LinkedRecordRef): Promise<LinkedRecordAnswer>;
+    /** The answer in for one record, if any: undefined while it is asked. */
+    answered(ref: LinkedRecordRef): LinkedRecordAnswer | undefined;
+    /** Asked afresh: every answer forgotten, so the next read asks again (a far value changed). */
+    forget(ref?: LinkedRecordRef): void;
+}
+/**
+ * WHAT A PAGE READS FAR RECORDS THROUGH, AS ONE VIEWER (FR-171): each record
+ * asked of the host once, its answer kept, and `answered` told — so the page
+ * reads again, and a computed value that read "not read yet" reads the far
+ * value. An expression never waits: until the answer is in, it reads unread.
+ */
+export declare function linkedReads(host: LinkedRecords, viewer: LinkedViewer, answered?: (ref: LinkedRecordRef) => void): LinkedReads;
+//# sourceMappingURL=linked-reads.d.ts.map

package/dist/schema/linked-reads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linked-reads.d.ts","sourceRoot":"","sources":["../../src/schema/linked-reads.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,YAAY,EAAgB,kBAAkB,EAAE,eAAe,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAU5I,oFAAoF;AACpF,MAAM,WAAW,WAAW;IAC1B,2FAA2F;IAC3F,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,qEAAqE;IACrE,GAAG,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACvD,yEAAyE;IACzE,QAAQ,CAAC,GAAG,EAAE,eAAe,GAAG,kBAAkB,GAAG,SAAS,CAAC;IAC/D,+FAA+F;IAC/F,MAAM,CAAC,GAAG,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;CACrC;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,GAAE,CAAC,GAAG,EAAE,eAAe,KAAK,IAAe,GAAG,WAAW,CA+CvI"}

package/dist/schema/linked-reads.js

@@ -0,0 +1,69 @@
+/*
+ * WHAT A PAGE READS ANOTHER APP'S RECORDS THROUGH (FR-171), on the main
+ * entry because the provider builds one wherever a host hands it
+ * `linkedRecords`: small, and nothing of zod or of the record's words.
+ */
+const keyOf = (ref, viewer) => `${viewer.kind}\u0000${viewer.id ?? ""}\u0000${ref.address}\u0000${ref.kind}\u0000${ref.id}`;
+/**
+ * WHAT A PAGE READS FAR RECORDS THROUGH, AS ONE VIEWER (FR-171): each record
+ * asked of the host once, its answer kept, and `answered` told — so the page
+ * reads again, and a computed value that read "not read yet" reads the far
+ * value. An expression never waits: until the answer is in, it reads unread.
+ */
+export function linkedReads(host, viewer, answered = () => { }) {
+    const asked = new Map();
+    const answers = new Map();
+    const ask = (ref) => {
+        const key = keyOf(ref, viewer);
+        let answer = asked.get(key);
+        if (!answer) {
+            answer = Promise.resolve()
+                .then(() => host.resolve(ref, viewer))
+                .then((found) => (isAnswer(found) ? found : null), () => null)
+                .then((found) => {
+                if (asked.get(key) === answer) {
+                    answers.set(key, found);
+                    answered(ref);
+                }
+                return found;
+            });
+            asked.set(key, answer);
+        }
+        return answer;
+    };
+    return {
+        read(ref) {
+            const key = keyOf(ref, viewer);
+            if (answers.has(key)) {
+                const found = answers.get(key);
+                return found === null ? { unread: true } : "denied" in found ? { denied: true } : { record: found };
+            }
+            void ask(ref);
+            return { unread: true };
+        },
+        ask,
+        answered: (ref) => answers.get(keyOf(ref, viewer)),
+        forget(ref) {
+            if (!ref) {
+                asked.clear();
+                answers.clear();
+                return;
+            }
+            const key = keyOf(ref, viewer);
+            asked.delete(key);
+            answers.delete(key);
+        },
+    };
+}
+/** Whether the host's answer is one a page can read: a record with a label and fields, a refusal, or nothing. */
+function isAnswer(found) {
+    if (found === null)
+        return true;
+    if (typeof found !== "object" || found === undefined)
+        return false;
+    if (found.denied === true)
+        return true;
+    const record = found;
+    return typeof record.label === "string" && typeof record.id === "string" && typeof record.kind === "string" && typeof record.fields === "object" && record.fields !== null;
+}
+//# sourceMappingURL=linked-reads.js.map

package/dist/schema/linked-reads.js.map

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

package/dist/schema/linked-schema.d.ts

@@ -0,0 +1,5 @@
+import * as z from "./zod.js";
+import { type LinkedRelation } from "./linked.js";
+/** The schema a relation to another app is kept in, in zod/mini: `kind:id`, or a list of them. */
+export declare function linkedSchema(relation: LinkedRelation): z.ZodMiniType;
+//# sourceMappingURL=linked-schema.d.ts.map

package/dist/schema/linked-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linked-schema.d.ts","sourceRoot":"","sources":["../../src/schema/linked-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAC;AAC9B,OAAO,EAA2B,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAE3E,kGAAkG;AAClG,wBAAgB,YAAY,CAAC,QAAQ,EAAE,cAAc,GAAG,CAAC,CAAC,WAAW,CAOpE"}

package/dist/schema/linked-schema.js

@@ -0,0 +1,9 @@
+import * as z from "./zod.js";
+import { linkedRefOf, markLinked } from "./linked.js";
+/** The schema a relation to another app is kept in, in zod/mini: `kind:id`, or a list of them. */
+export function linkedSchema(relation) {
+    const one = z.string().check(z.maxLength(300), z.refine((value) => linkedRefOf(value, relation) !== undefined, `a record of ${relation.kinds.join(" or ")} in ${relation.address}, as "<kind>:<id>"`));
+    const schema = relation.cardinality === "one" ? one : z.array(one).check(z.maxLength(200));
+    return markLinked(relation.description ? schema.check(z.describe(relation.description)) : schema, relation);
+}
+//# sourceMappingURL=linked-schema.js.map

package/dist/schema/linked-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linked-schema.js","sourceRoot":"","sources":["../../src/schema/linked-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAC;AAC9B,OAAO,EAAE,WAAW,EAAE,UAAU,EAAuB,MAAM,aAAa,CAAC;AAE3E,kGAAkG;AAClG,MAAM,UAAU,YAAY,CAAC,QAAwB;IACnD,MAAM,GAAG,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAC1B,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EAChB,CAAC,CAAC,MAAM,CAAC,CAAC,KAAa,EAAE,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,SAAS,EAAE,eAAe,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,QAAQ,CAAC,OAAO,oBAAoB,CAAC,CAC/J,CAAC;IACF,MAAM,MAAM,GAAkB,QAAQ,CAAC,WAAW,KAAK,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1G,OAAO,UAAU,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AAC9G,CAAC"}

package/dist/schema/linked.d.ts

@@ -0,0 +1,147 @@
+/** A kind in another app, as a relation's `to` names it: `@` + the app's address + `/` + the kind. */
+export declare const LINKED_TARGET: RegExp;
+/**
+ * THE APP AND THE KIND A RELATION'S TARGET NAMES — or undefined when it names
+ * a kind of this document. The address is what an app-link field would
+ * hold for that app: `@nick/house/house` is the kind `house` of `@nick/house`;
+ * `@app_kf5eydr9z58jzf/house` of the app with that id; `@https://x.dev/a/house`
+ * of the app at `https://x.dev/a`.
+ */
+export declare function parseLinkedTarget(target: string): {
+    readonly address: string;
+    readonly kind: string;
+} | undefined;
+/** Whether a relation's target is a kind in another app. */
+export declare const isLinkedTarget: (target: unknown) => target is string;
+/** A relation to another app's kinds, as its declaration says it. */
+export interface LinkedRelation {
+    /** The other app's address: `@nick/house`, an app id, or an http(s) address. */
+    readonly address: string;
+    /** Its kinds the relation may link. */
+    readonly kinds: readonly string[];
+    readonly cardinality: "one" | "many";
+    /** The relation's own sentence, where the declaration gave one. */
+    readonly description?: string;
+}
+/** One record in another app: which app, which kind, which id. */
+export interface LinkedRecordRef {
+    readonly address: string;
+    readonly kind: string;
+    readonly id: string;
+}
+/** What a link keeps for a far record: `house:h1`. */
+export declare const linkedValue: (ref: Pick<LinkedRecordRef, "kind" | "id">) => string;
+/** The far record a kept value names, read against its relation; undefined when it names none. */
+export declare function linkedRefOf(value: unknown, relation: Pick<LinkedRelation, "address" | "kinds">): LinkedRecordRef | undefined;
+/** Every far record a link's value names — one, or each of many — in order. */
+export declare function linkedRefsOf(value: unknown, relation: Pick<LinkedRelation, "address" | "kinds">): readonly LinkedRecordRef[];
+/** Marks a schema as holding links to records of another app. */
+export declare const markLinked: <T extends object>(schema: T, relation: LinkedRelation) => T;
+/** The relation to another app a field holds — under optional, default and nullable — or undefined. */
+export declare function linkedRelationOf(schema: unknown): LinkedRelation | undefined;
+/** A definition's relations to other apps, by the field each is kept in. */
+export declare function linkedRelations(definition: {
+    readonly fields?: unknown;
+} | undefined): ReadonlyMap<string, LinkedRelation>;
+/** A relation as a document declares it: where it goes, how many, and its sentence. */
+interface DeclaredRelation {
+    readonly to: readonly string[] | "*";
+    readonly cardinality?: "one" | "many" | undefined;
+    readonly description?: string | undefined;
+}
+/**
+ * The relation to another app a document's relation declares, or undefined
+ * for one within the document. Only a relation whose every target is a kind
+ * of ONE other app is one (`graview check` says `linked-mixed` and
+ * `linked-apps` of the rest).
+ */
+export declare function linkedRelationOfSpec(edge: DeclaredRelation): LinkedRelation | undefined;
+/** Whether a document's relation reaches out of the document at all: any of its targets names another app. */
+export declare const reachesAnotherApp: (edge: DeclaredRelation) => boolean;
+/** A document kind's relations within the document, its relations to other apps aside. */
+export declare function localEdges<E extends DeclaredRelation>(edges: Readonly<Record<string, E>> | undefined): Record<string, E>;
+/** A document kind's relations to other apps, by name. */
+export declare function linkedEdges(edges: Readonly<Record<string, DeclaredRelation>> | undefined): Map<string, LinkedRelation>;
+/** A far record as the host says it to one viewer. */
+export interface LinkedRecord {
+    readonly address: string;
+    readonly kind: string;
+    readonly id: string;
+    /** What it is called in its own app: its label there. */
+    readonly label: string;
+    /** Its describe line there, where its kind has one. */
+    readonly describe?: string;
+    /** Its card's lines there — a glance at it, field by field, in words — after its title. */
+    readonly card?: readonly {
+        readonly label: string;
+        readonly text: string;
+    }[];
+    /** The fields this viewer may see there, as values, for an expression to walk (`forHouse.listPrice`). Nothing they may not see. */
+    readonly fields: Readonly<Record<string, unknown>>;
+    /** Where it opens in its own app: a path on the host or an http(s) address. */
+    readonly href?: string;
+    /** Its app's name, as the host says it. */
+    readonly app?: string;
+}
+/** The host's answer for one far record and one viewer: the record; `{ denied: true }` when they may not open its app; null when there is no such record. */
+export type LinkedRecordAnswer = LinkedRecord | {
+    readonly denied: true;
+} | null;
+/** Who is looking, as the host is told: a principal. */
+export type LinkedViewer = {
+    readonly kind: string;
+    readonly id?: string | undefined;
+    readonly roles?: readonly string[] | undefined;
+};
+/** What linking asks the host for: records of these kinds in that app, matching words. */
+export interface LinkedSearch {
+    readonly address: string;
+    readonly kinds: readonly string[];
+    /** Words a person typed; empty for the first few. */
+    readonly query: string;
+    readonly limit: number;
+}
+/**
+ * THE HOST'S WAY TO READ ANOTHER APP'S RECORDS (FR-171), beside `resolveApp`
+ * and handed where it is — `mount`, `<Embed>`, `GraviewProvider` and the
+ * routed face (`PagesApp`) — as `linkedRecords`. Every call is AS THE VIEWER:
+ * what it answers is what that viewer may see in the far app, and a viewer
+ * who may not open that app is answered `{ denied: true }`. A throw is
+ * taken as null.
+ */
+export interface LinkedRecords {
+    /** One far record: its label, describe line, card and the fields this viewer may see; denied; or null. */
+    resolve(ref: LinkedRecordRef, viewer: LinkedViewer): Promise<LinkedRecordAnswer>;
+    /** The records a link may pick, for this viewer: at most `limit`, best first; denied when they may not open the app. */
+    find(search: LinkedSearch, viewer: LinkedViewer): Promise<readonly LinkedRecord[] | {
+        readonly denied: true;
+    }>;
+    /**
+     * THE NAVIGATION SEAM: open the far record in its own app. Where a host
+     * gives it, pressing a linked record calls it rather than following its
+     * `href` (an app on the same host opening in place); otherwise the
+     * record's `href` is followed.
+     */
+    open?(ref: LinkedRecordRef, viewer: LinkedViewer): void;
+}
+/**
+ * A FAR RECORD AS AN EXPRESSION READS IT, at once: the host's answer once it
+ * is in; `denied`; or `unread` — not asked yet, not answered yet, no host to
+ * ask, or no such record. An expression never waits and never throws for
+ * one: it reads nothing, and says which.
+ */
+export type LinkedRead = {
+    readonly record: LinkedRecord;
+} | {
+    readonly denied: true;
+} | {
+    readonly unread: true;
+};
+/** How the rule language reads a far record: at once, from what has been answered. */
+export type LinkedReader = (ref: LinkedRecordRef) => LinkedRead;
+/** Read far records through `reader` for every expression judged over `graph`; undefined stops. */
+export declare function readLinkedThrough(graph: object, reader: LinkedReader | undefined): void;
+/** The reader a graph's far records are read through, if any. */
+export declare const linkedReaderOf: (graph: object) => LinkedReader | undefined;
+export {};
+//# sourceMappingURL=linked.d.ts.map

package/dist/schema/linked.d.ts.map

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