@graview/core 0.1.28 → 0.1.29

package/dist/document.schema.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://unpkg.com/@graview/core@0.1.28/dist/document.schema.json",
-  "title": "Graview declaration document, format 1 (@graview/core 0.1.28)",
+  "$id": "https://unpkg.com/@graview/core@0.1.29/dist/document.schema.json",
+  "title": "Graview declaration document, format 1 (@graview/core 0.1.29)",
   "description": "A whole Graview app as one JSON object: its kinds, fields, relations, acts, rules, roles, views and brand. `graview check --document <file>` compiles it and says what is wrong in words; this schema is the same shape, for an editor. Name it in a document's \"$schema\".",
   "type": "object",
   "properties": {
@@ -97,7 +97,11 @@
                     "url",
                     "email",
                     "image",
-                    "file"
+                    "file",
+                    "app-link",
+                    "phone",
+                    "place",
+                    "duration"
                   ]
                 },
                 "required": {
@@ -143,7 +147,8 @@
                   "enum": [
                     "money",
                     "percent",
-                    "duration"
+                    "duration",
+                    "markdown"
                   ]
                 },
                 "min": {
@@ -158,6 +163,9 @@
                 "renamedFrom": {
                   "type": "string",
                   "pattern": "^[a-z][A-Za-z0-9]*$"
+                },
+                "repeats": {
+                  "type": "boolean"
                 }
               },
               "required": [
@@ -496,6 +504,10 @@
           },
           "people": {
             "type": "boolean"
+          },
+          "archives": {
+            "type": "boolean",
+            "const": false
           }
         },
         "required": [
@@ -820,7 +832,11 @@
                     "url",
                     "email",
                     "image",
-                    "file"
+                    "file",
+                    "app-link",
+                    "phone",
+                    "place",
+                    "duration"
                   ]
                 },
                 "required": {
@@ -866,7 +882,8 @@
                   "enum": [
                     "money",
                     "percent",
-                    "duration"
+                    "duration",
+                    "markdown"
                   ]
                 },
                 "min": {
@@ -881,6 +898,9 @@
                 "renamedFrom": {
                   "type": "string",
                   "pattern": "^[a-z][A-Za-z0-9]*$"
+                },
+                "repeats": {
+                  "type": "boolean"
                 }
               },
               "required": [
@@ -1425,6 +1445,22 @@
               "via": {
                 "type": "string",
                 "pattern": "^(?:[a-z][a-z0-9]*(?:-[a-z0-9]+)*|[a-z][A-Za-z0-9]*)$"
+              },
+              "fields": {
+                "minItems": 1,
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$"
+                }
+              },
+              "hide": {
+                "minItems": 1,
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$"
+                }
               }
             },
             "required": [
@@ -1493,6 +1529,27 @@
           "type": "string",
           "minLength": 1,
           "maxLength": 40
+        },
+        "lists": {
+          "type": "object",
+          "propertyNames": {
+            "type": "string"
+          },
+          "additionalProperties": {
+            "type": "object",
+            "properties": {
+              "filters": {
+                "maxItems": 40,
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 120
+                }
+              }
+            },
+            "additionalProperties": false
+          }
         }
       },
       "additionalProperties": {}

package/dist/excerpt-of.d.ts

@@ -0,0 +1,14 @@
+/**
+ * A TEXT'S START, as a list, a card, a row, a describe line, a table cell
+ * or a search hit says it (FR-180): its first block — paragraph, heading
+ * or item — or about `most` characters (160) of it, the first sentence
+ * where that fits; an ellipsis after where words were left out mid-thought;
+ * Markdown's syntax taken out when `markdown` says the text is Markdown.
+ */
+export declare function excerptOf(text: string, options?: {
+    readonly markdown?: boolean | undefined;
+    readonly most?: number | undefined;
+}): string;
+/** Markdown said as words, whole: every block's words in a line, the syntax taken out — what a search finds by and shows a fragment of. */
+export declare const markdownWords: (text: string) => string;
+//# sourceMappingURL=excerpt-of.d.ts.map

package/dist/excerpt-of.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"excerpt-of.d.ts","sourceRoot":"","sources":["../src/excerpt-of.ts"],"names":[],"mappings":"AAkGA;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAO,GAAG,MAAM,CAO7I;AAED,2IAA2I;AAC3I,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,KAAG,MAAyE,CAAC"}

package/dist/excerpt-of.js

@@ -0,0 +1,120 @@
+import { firstSentence } from "./excerpt.js";
+/*
+ * A LONG TEXT'S START AT A GLANCE (FR-180): what a list, a card, a row, a
+ * describe line, a table cell and a seat's line say of a record's prose.
+ * The record's page says it whole.
+ *
+ * What is said is the text's FIRST BLOCK — its first paragraph, heading or
+ * list item, its lines run together — and of that the first sentence when
+ * the block is too long, else its words up to the most allowed, with an
+ * ellipsis wherever words were left out mid-thought. Markdown's syntax is
+ * taken out (FR-180): "## Heading **bold**" is said "Heading bold", a link
+ * is its words, code its letters. How many LINES that draws in is the
+ * surface's to clamp; this decides only WHAT text is shown.
+ */
+// Each reads one line and is linear in it.
+const HEADING = /^ {0,3}#{1,6}(?:[ \t]+|$)/;
+const LIST_ITEM = /^[ \t]*(?:[-*+•]|\d{1,9}[.)])[ \t]+(?:\[[ xX]\][ \t]+)?/;
+const RULE = /^ {0,3}(?:(?:-[ \t]*){3,}|(?:\*[ \t]*){3,}|(?:_[ \t]*){3,})$/;
+const FENCE = /^ {0,3}(?:`{3,}|~{3,})/;
+const QUOTE = /^ {0,3}(?:>[ \t]?)+/;
+// Read on a trimmed line, so no two runs of spaces meet.
+const TABLE_RULE = /^\|?\s*:?-{2,}:?\s*(?:\|\s*:?-{2,}:?\s*)*\|?$/;
+const ENTITIES = { amp: "&", lt: "<", gt: ">", quot: '"', "#39": "'", nbsp: " " };
+/** One line of Markdown said as words: emphasis, code, links, tags and escapes taken out. */
+function inlineWords(line) {
+    return line
+        .replace(/!?\[([^\]\n]{0,500})\]\([^)\n]{0,500}\)/g, "$1")
+        .replace(/<((?:https?:|mailto:)[^>\s]*)>/gi, "$1")
+        .replace(/<\/?[A-Za-z][^<>\n]*>/g, "")
+        .replace(/`+([^`\n]*)`+/g, "$1")
+        .replace(/(\*\*|__|~~)(?=\S)([^\n]{0,500}?\S)\1/g, "$2")
+        .replace(/(^|[^\w*])\*(?=\S)([^*\n]{0,500}?\S)\*(?![\w*])/g, "$1$2")
+        .replace(/(^|\W)_(?=\S)([^_\n]{0,500}?\S)_(?!\w)/g, "$1$2")
+        .replace(/\\([\\`*_{}[\]()#+\-.!>|~])/g, "$1")
+        .replace(/&(amp|lt|gt|quot|#39|nbsp);/g, (_, name) => ENTITIES[name] ?? "");
+}
+/**
+ * The text's blocks — paragraphs, headings and list items — each its lines
+ * run together and its syntax taken out, read until `enough` characters are
+ * had; and whether any text is left after the last one read.
+ */
+function blocksOf(text, markdown, enough) {
+    const lines = text.replace(/\r\n?/g, "\n").split("\n");
+    const blocks = [];
+    let taken = [];
+    let had = 0;
+    let fenced = false;
+    const close = () => {
+        const block = taken.join(" ").replace(/\s+/g, " ").trim();
+        if (block) {
+            blocks.push(block);
+            had += block.length;
+        }
+        taken = [];
+    };
+    let next = 0;
+    while (next < lines.length && had <= enough) {
+        let line = lines[next++];
+        if (markdown && FENCE.test(line)) {
+            fenced = !fenced;
+            if (!fenced)
+                close();
+            continue;
+        }
+        if (!fenced && (line.trim().length === 0 || (markdown && (RULE.test(line) || TABLE_RULE.test(line.trim()))))) {
+            close();
+            continue;
+        }
+        const heading = !fenced && markdown && HEADING.test(line);
+        const item = !fenced && LIST_ITEM.test(line);
+        // A heading or a list item is a block of its own: the paragraph before it ends there.
+        if (heading || item)
+            close();
+        if (markdown && !fenced) {
+            line = line.replace(QUOTE, "");
+            if (heading)
+                line = line.replace(HEADING, "").replace(/[ \t]+#+[ \t]*$/, "");
+            if (item)
+                line = line.replace(LIST_ITEM, "");
+            if (line.includes("|"))
+                line = line.replace(/^[ \t]*\||\|[ \t]*$/g, "").split("|").map((cell) => cell.trim()).filter(Boolean).join(" · ");
+            // A glance reads no further than it says: a 20,000-character line is not stripped whole for 160 of it.
+            line = inlineWords(Number.isFinite(enough) ? line.slice(0, enough * 2 + 200) : line);
+        }
+        else if (item)
+            line = line.replace(LIST_ITEM, "");
+        taken.push(line);
+        if (heading)
+            close();
+        // A very long block is read only as far as any excerpt says.
+        if (taken.reduce((sum, one) => sum + one.length, 0) > enough)
+            break;
+    }
+    close();
+    return { blocks, more: lines.slice(next).some((line) => line.trim().length > 0 && !(markdown && (FENCE.test(line) || RULE.test(line)))) };
+}
+/** Cuts words to at most `most` characters, at a word's end, with an ellipsis. */
+function cut(flat, most) {
+    const kept = flat.slice(0, most + 1).replace(/\s+\S*$/, "");
+    return `${(kept || flat.slice(0, most)).replace(/[\s,;:.—-]+$/, "")}…`;
+}
+/**
+ * A TEXT'S START, as a list, a card, a row, a describe line, a table cell
+ * or a search hit says it (FR-180): its first block — paragraph, heading
+ * or item — or about `most` characters (160) of it, the first sentence
+ * where that fits; an ellipsis after where words were left out mid-thought;
+ * Markdown's syntax taken out when `markdown` says the text is Markdown.
+ */
+export function excerptOf(text, options = {}) {
+    const most = options.most ?? 160;
+    const { blocks, more } = blocksOf(text, options.markdown === true, most);
+    const first = blocks[0] ?? "";
+    if (first.length <= most)
+        return (more || blocks.length > 1) && first.length > 0 && !/[.!?…:]$/.test(first) ? `${first}…` : first;
+    const sentence = firstSentence(first);
+    return sentence && sentence.length <= most ? sentence : cut(first, most);
+}
+/** Markdown said as words, whole: every block's words in a line, the syntax taken out — what a search finds by and shows a fragment of. */
+export const markdownWords = (text) => blocksOf(text, true, Number.POSITIVE_INFINITY).blocks.join(" ");
+//# sourceMappingURL=excerpt-of.js.map

package/dist/excerpt-of.js.map

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

package/dist/excerpt.d.ts

@@ -0,0 +1,9 @@
+/** The first sentence: up to the first stop that ends one — not an abbreviation's, and not before three words. */
+export declare function firstSentence(flat: string): string | undefined;
+/**
+ * A long text's start: its first sentence when that is short enough, else its
+ * words up to `most` characters and an ellipsis — a line's heading or quote
+ * mark, bold and code ticks, and a link's address left out (FR-180).
+ */
+export declare function excerpt(text: string, most?: number): string;
+//# sourceMappingURL=excerpt.d.ts.map

package/dist/excerpt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"excerpt.d.ts","sourceRoot":"","sources":["../src/excerpt.ts"],"names":[],"mappings":"AAgBA,kHAAkH;AAClH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAS9D;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,SAAM,GAAG,MAAM,CAOxD"}

package/dist/excerpt.js

@@ -0,0 +1,43 @@
+/*
+ * A LONG TEXT'S START, for a card, a row or a glance: what `{summary|excerpt}`
+ * says. The record's page says it whole. A page's first load carries this
+ * (a template may ask for it), so it takes out only Markdown's commonest
+ * marks; a glance reads prose through `excerptOf` (excerpt-of.ts), fetched
+ * with what reads a record, which takes out the rest (FR-180).
+ */
+/**
+ * A stop that ends an abbreviation, not a sentence: "e.g.", "U.S.", "Ph.D.",
+ * "Dr." — short letters between stops, or a title. A word with a stop
+ * inside it that is not that ("capabilities().shipped.", "graview.dev.")
+ * ends its sentence.
+ */
+const ABBREVIATION = /^[("'“‘]*(?:(?:[a-z]{1,3}\.){2,}|(?:dr|mr|mrs|ms|mx|st|mt|vs|jr|sr|prof|no|fig|approx)\.)$/i;
+/** The first sentence: up to the first stop that ends one — not an abbreviation's, and not before three words. */
+export function firstSentence(flat) {
+    for (const stop of flat.matchAll(/[.!?](?=\s|$)/g)) {
+        const sentence = flat.slice(0, stop.index + 1);
+        const word = /\S+$/.exec(sentence)?.[0] ?? "";
+        if (stop[0] === "." && ABBREVIATION.test(word))
+            continue;
+        if (sentence.split(" ").length < 3 && stop.index + 1 < flat.length)
+            continue;
+        return sentence;
+    }
+    return undefined;
+}
+/**
+ * A long text's start: its first sentence when that is short enough, else its
+ * words up to `most` characters and an ellipsis — a line's heading or quote
+ * mark, bold and code ticks, and a link's address left out (FR-180).
+ */
+export function excerpt(text, most = 140) {
+    const flat = text.replace(/^[#>\s]+|\*\*|`|\](\([^)\s]*\))?|\[/gm, "").replace(/\s+/g, " ").trim();
+    const sentence = firstSentence(flat);
+    if (sentence && sentence.length <= most)
+        return sentence;
+    if (flat.length <= most)
+        return flat;
+    const cut = flat.slice(0, most + 1).replace(/\s+\S*$/, "");
+    return `${(cut || flat.slice(0, most)).replace(/[\s,;:.—-]+$/, "")}…`;
+}
+//# sourceMappingURL=excerpt.js.map

package/dist/excerpt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"excerpt.js","sourceRoot":"","sources":["../src/excerpt.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;GAKG;AACH,MAAM,YAAY,GAAG,6FAA6F,CAAC;AAEnH,kHAAkH;AAClH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QAC/C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC9C,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,SAAS;QACzD,IAAI,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM;YAAE,SAAS;QAC7E,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAC,IAAY,EAAE,IAAI,GAAG,GAAG;IAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,uCAAuC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACnG,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,QAAQ,IAAI,QAAQ,CAAC,MAAM,IAAI,IAAI;QAAE,OAAO,QAAQ,CAAC;IACzD,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IACrC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IAC3D,OAAO,GAAG,CAAC,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,GAAG,CAAC;AACxE,CAAC"}

package/dist/field-sight.d.ts

@@ -0,0 +1,33 @@
+export { withoutKeptFields } from "./ops/kept-fields.js";
+import { type FieldsKept, type Records } from "./permissions/sight.js";
+import type { Policy, Principal } from "./permissions/types.js";
+import type { Judged } from "./seen.js";
+/** The edges a graph can be asked about, to say what is joined to whom. */
+interface Joined {
+    out(id: string, kind?: string): readonly {
+        readonly id: string;
+    }[];
+    in(id: string, kind?: string): readonly {
+        readonly id: string;
+    }[];
+}
+type Node = {
+    readonly id: string;
+    readonly kind: string;
+};
+/** The kinds some sight shows only some fields of: the only kinds a field is ever kept from. */
+export declare function partialKinds(policy: Policy | undefined): ReadonlySet<string>;
+/**
+ * WHICH FIELDS OF A RECORD IT SEES a principal may not: a test that says
+ * yes of a field kept from it, or undefined when it sees every field. A
+ * field is shown when any sight that shows the principal the record shows
+ * it, so one sight with neither `fields` nor `hide` shows them all.
+ */
+export declare function fieldsKept(policy: Policy | undefined, principal: Principal, node: Node, graph: Joined, records?: Pick<Records, "creatorOf">): ((field: string) => boolean) | undefined;
+/**
+ * THE FIELDS OF EACH RECORD ONE SEAT MAY NOT SEE, as the store judges them
+ * now; undefined when no sight shows only some fields. A record no log has
+ * made yet is judged the asking seat's own, as it will be once it makes it.
+ */
+export declare function keptFrom(store: Judged, principal: Principal): FieldsKept | undefined;
+//# sourceMappingURL=field-sight.d.ts.map

package/dist/field-sight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-sight.d.ts","sourceRoot":"","sources":["../src/field-sight.ts"],"names":[],"mappings":"AA8BA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAKzD,OAAO,EAAwC,KAAK,UAAU,EAAE,KAAK,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAC7G,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAS,MAAM,wBAAwB,CAAC;AAGvE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGxC,2EAA2E;AAC3E,UAAU,MAAM;IACd,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACnE,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACnE;AAED,KAAK,IAAI,GAAG;IAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAM3D,gGAAgG;AAChG,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,CAAC,MAAM,CAAC,CAK5E;AAiBD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,SAAS,CAKtL;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,UAAU,GAAG,SAAS,CASpF"}