@graview/core 0.1.28 → 0.1.30

package/dist/graph/tracked.js

@@ -16,11 +16,6 @@ export class TrackedReader {
     reads() {
         return [...this.seen];
     }
-    mark(node) {
-        if (node)
-            this.seen.add(node.id);
-        return node;
-    }
     markAll(nodes) {
         for (const node of nodes)
             this.seen.add(node.id);
@@ -35,35 +30,35 @@ export class TrackedReader {
     }
     getNode(id) {
         this.seen.add(id);
-        return this.mark(this.inner.getNode(id));
+        return this.inner.getNode(id);
     }
     has(id) {
         this.seen.add(id);
         return this.inner.has(id);
     }
-    allNodes() {
-        return this.markAll(this.inner.allNodes());
+    allNodes(options) {
+        return this.markAll(this.inner.allNodes(options));
     }
-    allEdges() {
-        return this.markEdges(this.inner.allEdges());
+    allEdges(options) {
+        return this.markEdges(this.inner.allEdges(options));
     }
-    nodesOfKind(kind) {
-        return this.markAll(this.inner.nodesOfKind(kind));
+    nodesOfKind(kind, options) {
+        return this.markAll(this.inner.nodesOfKind(kind, options));
     }
-    edgesOfKind(kind) {
-        return this.markEdges(this.inner.edgesOfKind(kind));
+    edgesOfKind(kind, options) {
+        return this.markEdges(this.inner.edgesOfKind(kind, options));
     }
-    out(id, kind) {
+    out(id, kind, options) {
         this.seen.add(id);
-        return this.markAll(this.inner.out(id, kind));
+        return this.markAll(this.inner.out(id, kind, options));
     }
-    in(id, kind) {
+    in(id, kind, options) {
         this.seen.add(id);
-        return this.markAll(this.inner.in(id, kind));
+        return this.markAll(this.inner.in(id, kind, options));
     }
-    neighbors(id) {
+    neighbors(id, options) {
         this.seen.add(id);
-        return this.markAll(this.inner.neighbors(id));
+        return this.markAll(this.inner.neighbors(id, options));
     }
 }
 //# sourceMappingURL=tracked.js.map

package/dist/graph/tracked.js.map

@@ -1 +1 @@
-{"version":3,"file":"tracked.js","sourceRoot":"","sources":["../../src/graph/tracked.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,OAAO,aAAa;IAGK;IAFZ,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE1C,YAA6B,KAAqB;QAArB,UAAK,GAAL,KAAK,CAAgB;IAAG,CAAC;IAEtD,sDAAsD;IACtD,KAAK;QACH,OAAO,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAEO,IAAI,CAA0B,IAAO;QAC3C,IAAI,IAAI;YAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,OAAO,CAAc,KAAU;QACrC,KAAK,MAAM,IAAI,IAAI,KAAK;YAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjD,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,SAAS,CAAC,KAAkB;QAClC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACzB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,CAAC,EAAU;QAChB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3C,CAAC;IAED,GAAG,CAAC,EAAU;QACZ,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,WAAW,CAAsB,IAAO;QACtC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;IACpD,CAAC;IAED,WAAW,CAAC,IAAY;QACtB,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;IACtD,CAAC;IAED,GAAG,CAAC,EAAU,EAAE,IAAa;QAC3B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC;IAChD,CAAC;IAED,EAAE,CAAC,EAAU,EAAE,IAAa;QAC1B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC;IAC/C,CAAC;IAED,SAAS,CAAC,EAAU;QAClB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;IAChD,CAAC;CACF"}
+{"version":3,"file":"tracked.js","sourceRoot":"","sources":["../../src/graph/tracked.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,MAAM,OAAO,aAAa;IAGK;IAFZ,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE1C,YAA6B,KAAqB;QAArB,UAAK,GAAL,KAAK,CAAgB;IAAG,CAAC;IAEtD,sDAAsD;IACtD,KAAK;QACH,OAAO,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAEO,OAAO,CAAc,KAAU;QACrC,KAAK,MAAM,IAAI,IAAI,KAAK;YAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjD,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,SAAS,CAAC,KAAkB;QAClC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACzB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,CAAC,EAAU;QAChB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClB,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC;IAED,GAAG,CAAC,EAAU;QACZ,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED,QAAQ,CAAC,OAAwB;QAC/B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IACpD,CAAC;IAED,QAAQ,CAAC,OAAwB;QAC/B,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IACtD,CAAC;IAED,WAAW,CAAsB,IAAO,EAAE,OAAwB;QAChE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED,WAAW,CAAC,IAAY,EAAE,OAAwB;QAChD,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED,GAAG,CAAC,EAAU,EAAE,IAAa,EAAE,OAAwB;QACrD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IACzD,CAAC;IAED,EAAE,CAAC,EAAU,EAAE,IAAa,EAAE,OAAwB;QACpD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,SAAS,CAAC,EAAU,EAAE,OAAwB;QAC5C,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;IACzD,CAAC;CACF"}

package/dist/graph/types.d.ts

@@ -1,3 +1,4 @@
+import type { ArchivedOption } from "./archived.js";
 export interface GraphEdge {
     readonly kind: string;
     readonly from: string;
@@ -10,21 +11,28 @@ export interface GraphNodeBase {
     readonly kind: string;
 }
 export type AnyGraphNode = GraphNodeBase & Record<string, unknown>;
-/** The read surface a mutation sees. Every method here is instrumented. */
+/**
+ * The read surface a mutation sees. Every method here is instrumented.
+ *
+ * A read that LISTS records reaches the live ones unless it asks for the
+ * archived (FR-173): `{ archived: true }` for those only, `"all"` for both.
+ * A link is listed when both its ends are reached. A read BY ID — `getNode`,
+ * `has` — finds a record archived or not, as its own page does.
+ */
 export interface GraphReader<N extends GraphNodeBase = AnyGraphNode> {
     getNode(id: string): N | undefined;
-    allNodes(): N[];
-    allEdges(): GraphEdge[];
-    nodesOfKind<K extends N["kind"]>(kind: K): Extract<N, {
+    allNodes(options?: ArchivedOption): N[];
+    allEdges(options?: ArchivedOption): GraphEdge[];
+    nodesOfKind<K extends N["kind"]>(kind: K, options?: ArchivedOption): Extract<N, {
         kind: K;
     }>[];
-    edgesOfKind(kind: string): GraphEdge[];
+    edgesOfKind(kind: string, options?: ArchivedOption): GraphEdge[];
     /** Nodes reached by following `kind` edges out of `id`. */
-    out(id: string, kind?: string): N[];
+    out(id: string, kind?: string, options?: ArchivedOption): N[];
     /** Nodes with a `kind` edge pointing at `id`. */
-    in(id: string, kind?: string): N[];
+    in(id: string, kind?: string, options?: ArchivedOption): N[];
     /** Every node one edge away, in either direction. */
-    neighbors(id: string): N[];
+    neighbors(id: string, options?: ArchivedOption): N[];
     has(id: string): boolean;
 }
 export interface GraphSnapshot<N extends GraphNodeBase = AnyGraphNode> {

package/dist/graph/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/graph/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,mEAAmE;AACnE,wBAAgB,MAAM,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAE9C;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEnE,2EAA2E;AAC3E,MAAM,WAAW,WAAW,CAAC,CAAC,SAAS,aAAa,GAAG,YAAY;IACjE,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IACnC,QAAQ,IAAI,CAAC,EAAE,CAAC;IAChB,QAAQ,IAAI,SAAS,EAAE,CAAC;IACxB,WAAW,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC,EAAE,CAAC;IACrE,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,CAAC;IACvC,2DAA2D;IAC3D,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,CAAC,EAAE,CAAC;IACpC,iDAAiD;IACjD,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,CAAC,EAAE,CAAC;IACnC,qDAAqD;IACrD,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,CAAC,EAAE,CAAC;IAC3B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,aAAa,GAAG,YAAY;IACnE,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;CACtC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/graph/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,mEAAmE;AACnE,wBAAgB,MAAM,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAE9C;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEnE;;;;;;;GAOG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,SAAS,aAAa,GAAG,YAAY;IACjE,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,CAAC,EAAE,CAAC;IACxC,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,SAAS,EAAE,CAAC;IAChD,WAAW,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,EAAE;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC,EAAE,CAAC;IAC/F,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,SAAS,EAAE,CAAC;IACjE,2DAA2D;IAC3D,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,CAAC,EAAE,CAAC;IAC9D,iDAAiD;IACjD,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,CAAC,EAAE,CAAC;IAC7D,qDAAqD;IACrD,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,CAAC,EAAE,CAAC;IACrD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,aAAa,GAAG,YAAY;IACnE,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;CACtC"}

package/dist/graph/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/graph/types.ts"],"names":[],"mappings":"AAMA,mEAAmE;AACnE,MAAM,UAAU,MAAM,CAAC,IAAe;IACpC,OAAO,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;AAChD,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/graph/types.ts"],"names":[],"mappings":"AAQA,mEAAmE;AACnE,MAAM,UAAU,MAAM,CAAC,IAAe;IACpC,OAAO,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;AAChD,CAAC"}

package/dist/grid-sort.d.ts

@@ -0,0 +1,20 @@
+/** A grid's order, as a declaration writes it. */
+export type GridSort = string | {
+    readonly by: string;
+    readonly direction?: "asc" | "desc";
+};
+/** The order in its whole form, or nothing where it is not one. */
+export declare function gridSortOf(sort: unknown): {
+    readonly by: string;
+    readonly direction: "asc" | "desc";
+} | undefined;
+/** What a grid's order is wrong with, in a sentence, or nothing: a field the kind does not have, or a direction that is not one. */
+export declare function gridSortProblem(sort: unknown, fields: readonly string[], kind: string): string | undefined;
+/**
+ * `items` in the order `sort` says: by the field's value — numbers as
+ * numbers, words and dates as words in the page's order — the ones with
+ * none last whichever way it runs, and the order they came in where two are
+ * the same. Unsaid, as they came.
+ */
+export declare function sortForGrid<T>(items: readonly T[], sort: unknown, read: (item: T, field: string) => unknown): readonly T[];
+//# sourceMappingURL=grid-sort.d.ts.map

package/dist/grid-sort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grid-sort.d.ts","sourceRoot":"","sources":["../src/grid-sort.ts"],"names":[],"mappings":"AAWA,kDAAkD;AAClD,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAA;CAAE,CAAC;AAE7F,mEAAmE;AACnE,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG;IAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,KAAK,GAAG,MAAM,CAAA;CAAE,GAAG,SAAS,CAMjH;AAED,oIAAoI;AACpI,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAO1G;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,GAAG,SAAS,CAAC,EAAE,CAc1H"}

package/dist/grid-sort.js

@@ -0,0 +1,58 @@
+/*
+ * THE ORDER A GRID LENS DRAWS ITS ROWS, COLUMNS OR CARDS IN (2026-10-15).
+ *
+ * "Releases by era" listed its releases in the order they were written. A
+ * coverage lens takes `sort` for its rows and `columnSort` for its columns,
+ * and a status board `sort` for the cards in each column, written as a
+ * kind's list writes its order: a field (`"released"`), or
+ * `{ "by": "released", "direction": "desc" }`. `label` is the record's name.
+ * One comparison, so the picture and `describePlace` say the same order.
+ */
+/** The order in its whole form, or nothing where it is not one. */
+export function gridSortOf(sort) {
+    if (typeof sort === "string" && sort.length > 0)
+        return { by: sort, direction: "asc" };
+    if (typeof sort !== "object" || sort === null)
+        return undefined;
+    const { by, direction } = sort;
+    if (typeof by !== "string" || by.length === 0)
+        return undefined;
+    return { by, direction: direction === "desc" ? "desc" : "asc" };
+}
+/** What a grid's order is wrong with, in a sentence, or nothing: a field the kind does not have, or a direction that is not one. */
+export function gridSortProblem(sort, fields, kind) {
+    const whole = gridSortOf(sort);
+    if (!whole)
+        return `an order is a field, like "released", or { "by": "released", "direction": "asc" | "desc" }`;
+    const direction = typeof sort === "object" && sort !== null ? sort.direction : undefined;
+    if (direction !== undefined && direction !== "asc" && direction !== "desc")
+        return `an order runs "asc" or "desc", not "${String(direction)}"`;
+    if (whole.by !== "label" && !fields.includes(whole.by))
+        return `${kind} has no field "${whole.by}" to order by (it has ${fields.length > 0 ? fields.map((field) => `"${field}"`).join(", ") : "none"}, and "label", its name)`;
+    return undefined;
+}
+/**
+ * `items` in the order `sort` says: by the field's value — numbers as
+ * numbers, words and dates as words in the page's order — the ones with
+ * none last whichever way it runs, and the order they came in where two are
+ * the same. Unsaid, as they came.
+ */
+export function sortForGrid(items, sort, read) {
+    const whole = gridSortOf(sort);
+    if (!whole)
+        return items;
+    const flip = whole.direction === "desc" ? -1 : 1;
+    return items
+        .map((item, at) => ({ item, at, value: read(item, whole.by) }))
+        .sort((a, b) => {
+        const none = (a.value === undefined || a.value === null || a.value === "" ? 1 : 0) - (b.value === undefined || b.value === null || b.value === "" ? 1 : 0);
+        if (none !== 0)
+            return none;
+        if (a.value === b.value || a.value === undefined || a.value === null)
+            return a.at - b.at;
+        const order = typeof a.value === "number" && typeof b.value === "number" ? a.value - b.value : String(a.value).localeCompare(String(b.value), undefined, { numeric: true });
+        return order === 0 ? a.at - b.at : order * flip;
+    })
+        .map((one) => one.item);
+}
+//# sourceMappingURL=grid-sort.js.map

package/dist/grid-sort.js.map

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

package/dist/history.d.ts

@@ -0,0 +1,88 @@
+import { nameOfAuthor } from "./who.js";
+import type { Author } from "./ops/types.js";
+import type { Principal } from "./permissions/types.js";
+import type { AnySchema } from "./schema/schema.js";
+import type { PastDeclaration, Store } from "./store.js";
+/** Who made a change, as a timeline marks it: the reader, another person, an agent, or the app itself (a rule, a sync, a migration). */
+export type Maker = "you" | "person" | "agent" | "app";
+/**
+ * A CHANGE TO THE DECLARATION AT A MOMENT, as the host knows it: the seq it
+ * took effect at (the ops before it were made under the one before), the
+ * sentence it said ("Added a Budget kind"), and — so the past is drawn
+ * under it — the declaration itself. An epoch with a `change` (a migration)
+ * is one too, read from the log without the host.
+ */
+export interface DeclarationMark {
+    readonly seq: number;
+    readonly sentence: string;
+    readonly at?: string;
+    readonly author?: Author;
+    /** The declaration from this seq on; absent, the past is drawn under the next one the host does say, else the store's own. */
+    readonly declaration?: PastDeclaration;
+}
+/** What a host keeps of a script (worker) view: its code at a moment, as it registers it. */
+export type ViewVersion = {
+    readonly source: string;
+} | Readonly<Record<string, unknown>>;
+/**
+ * WHAT THE HOST KEEPS OUTSIDE THE LOG, handed to playback: the declaration
+ * changes it knows (with the declaration each began), and a script view's
+ * code as it stood at a seq — `null` when the view did not exist then,
+ * `undefined` when the host does not know (the view is drawn as it is now).
+ */
+export interface HistoryHost {
+    readonly declarations?: readonly DeclarationMark[];
+    readonly viewAt?: (name: string, seq: number) => ViewVersion | null | undefined;
+}
+/** One gesture on the timeline, or one declaration change made outside the log. */
+export interface PlaybackTick {
+    /** The moment just after it: `pastOf(store, seq)` shows it made. */
+    readonly seq: number;
+    /** The seq of its first op; equal to `seq` for a declaration change the log holds no op of. */
+    readonly from: number;
+    /** When it was made, when said. */
+    readonly at: string | undefined;
+    readonly batch: string | undefined;
+    readonly maker: Maker;
+    readonly author: Author | undefined;
+    /** What it was, in a sentence: the gesture's intent, or the declaration's change. */
+    readonly said: string;
+    /** A change to the declaration: a bigger tick. */
+    readonly declaration: boolean;
+    /** Something this seat may not see happened here (FR-16): said, and nothing more. */
+    readonly withheld: boolean;
+}
+/** Who made a change, for the reader `me`. A system or a rule is the app itself; an agent acting for a person is still an agent. */
+export declare function makerOf(author: Author, me?: Principal): Maker;
+/**
+ * THE TIMELINE OF A STORE: one tick per gesture, in the order they ended,
+ * then each declaration change at its seq — on the gesture that made it
+ * when one ends there, else a tick of its own. Read through a seat's view
+ * of the store (`seenBy`), a change it may not see is a tick that says only
+ * that something happened.
+ */
+export declare function ticksOf<S extends AnySchema>(store: Store<S>, options?: {
+    readonly me?: Principal;
+    readonly declarations?: readonly DeclarationMark[];
+}): PlaybackTick[];
+type Declared = Pick<AnySchema, "kinds" | "tryDefinition">;
+/**
+ * WHAT A DECLARATION CHANGE DID, IN A SENTENCE, from the one before and the
+ * one after: "Added a Budget kind", "Added due and priority to Task",
+ * "Removed the Note kind". Kinds first, then fields and links of the kinds
+ * both have. "Changed the declaration" when nothing it names moved.
+ */
+export declare function declarationSentence(before: Declared | undefined, after: Declared): string;
+/**
+ * THE GESTURES "RESTORE TO HERE" TAKES BACK, as one undo (`store.undo`):
+ * every gesture after `seq` still standing, but not an undo whose every
+ * target came after `seq` too — those two cancel already, and taking the
+ * undo back would put its target back. Empty when nothing after `seq`
+ * stands. Whether the undo may run is the store's to judge (`canUndo`,
+ * and the policy when it runs).
+ */
+export declare function restoreBatches<S extends AnySchema>(store: Store<S>, seq: number): string[];
+/** Who made a tick, in words, for a reader who has the app's people and seats: "you", "Claude", "Ann". */
+export declare function makerWords(tick: PlaybackTick, context: Parameters<typeof nameOfAuthor>[1]): string;
+export {};
+//# sourceMappingURL=history.d.ts.map

package/dist/history.d.ts.map

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

package/dist/history.js

@@ -0,0 +1,146 @@
+/**
+ * THE APP'S HISTORY, PLAYED BACK (Roadmap f-playback): `@graview/core/history`.
+ *
+ * `pastOf(store, when)` (`@graview/core/past`) is the app as it stood;
+ * this is what a timeline reads around it — one tick per gesture, marked by
+ * who made it, the bigger ticks where the declaration changed with the
+ * sentence it said, and the gestures a "Restore to here" takes back as one
+ * change. Its own entry, because nothing here is needed before somebody
+ * opens the past: the timeline fetches it when they do.
+ *
+ * What the log does not hold — a script view's code, an asset's bytes —
+ * is the host's, and it hands it through `HistoryHost`.
+ */
+import { capitalize } from "./capital.js";
+import { humanizeField, nounOf } from "./schema/define-node.js";
+import { nameOfAuthor } from "./who.js";
+/** Who made a change, for the reader `me`. A system or a rule is the app itself; an agent acting for a person is still an agent. */
+export function makerOf(author, me) {
+    if (author.kind === "agent")
+        return "agent";
+    if (author.kind !== "human")
+        return "app";
+    if (author.onBehalfOf !== undefined)
+        return "person";
+    return author.id === undefined || me?.id === undefined || author.id === me.id ? "you" : "person";
+}
+const opsSeen = (batch) => batch.ops.filter((op) => op.withheld !== true);
+/**
+ * THE TIMELINE OF A STORE: one tick per gesture, in the order they ended,
+ * then each declaration change at its seq — on the gesture that made it
+ * when one ends there, else a tick of its own. Read through a seat's view
+ * of the store (`seenBy`), a change it may not see is a tick that says only
+ * that something happened.
+ */
+export function ticksOf(store, options = {}) {
+    const ticks = store.batches().map((batch) => {
+        const first = batch.ops[0];
+        const last = batch.ops.at(-1);
+        const withheld = opsSeen(batch).length === 0;
+        return {
+            seq: last.seq + 1,
+            from: first.seq,
+            at: last.at,
+            batch: batch.id,
+            maker: withheld ? "person" : makerOf(batch.author, options.me),
+            author: withheld ? undefined : batch.author,
+            said: batch.intent,
+            declaration: false,
+            withheld,
+        };
+    });
+    const marks = [
+        ...store.log
+            .epochs()
+            .filter((epoch) => epoch.change !== undefined)
+            .map((epoch) => ({ seq: epoch.seq, sentence: epoch.change, ...(epoch.at ? { at: epoch.at } : {}) })),
+        ...(options.declarations ?? []),
+    ];
+    for (const mark of marks) {
+        if (mark.seq < store.log.horizon || mark.seq > store.log.length)
+            continue;
+        const at = ticks.findIndex((tick) => tick.seq === mark.seq);
+        if (at >= 0 && !ticks[at].withheld) {
+            ticks[at] = { ...ticks[at], declaration: true, said: mark.sentence };
+            continue;
+        }
+        ticks.push({
+            seq: mark.seq,
+            from: mark.seq,
+            at: mark.at,
+            batch: undefined,
+            maker: mark.author ? makerOf(mark.author, options.me) : "app",
+            author: mark.author,
+            said: mark.sentence,
+            declaration: true,
+            withheld: false,
+        });
+    }
+    return ticks.sort((a, b) => a.seq - b.seq || Number(a.batch !== undefined) - Number(b.batch !== undefined));
+}
+const fieldsOf = (schema, kind) => {
+    const fields = schema.tryDefinition(kind)?.fields;
+    return Object.keys(fields?.shape ?? {});
+};
+const edgesOf = (schema, kind) => Object.keys(schema.tryDefinition(kind)?.edges ?? {});
+const kindWords = (schema, kind) => capitalize(nounOf(schema.tryDefinition(kind), kind));
+const article = (word) => (/^[aeiou]/i.test(word) ? "an" : "a");
+const listed = (items) => (items.length <= 1 ? items.join("") : `${items.slice(0, -1).join(", ")} and ${items.at(-1)}`);
+/**
+ * WHAT A DECLARATION CHANGE DID, IN A SENTENCE, from the one before and the
+ * one after: "Added a Budget kind", "Added due and priority to Task",
+ * "Removed the Note kind". Kinds first, then fields and links of the kinds
+ * both have. "Changed the declaration" when nothing it names moved.
+ */
+export function declarationSentence(before, after) {
+    const was = new Set(before?.kinds ?? []);
+    const now = new Set(after.kinds);
+    const parts = [];
+    const added = [...now].filter((kind) => !was.has(kind));
+    const removed = [...was].filter((kind) => !now.has(kind));
+    if (added.length === 1)
+        parts.push(`added ${article(kindWords(after, added[0]))} ${kindWords(after, added[0])} kind`);
+    else if (added.length > 1)
+        parts.push(`added the ${listed(added.map((kind) => kindWords(after, kind)))} kinds`);
+    if (removed.length > 0)
+        parts.push(`removed the ${listed(removed.map((kind) => kindWords(before, kind)))} kind${removed.length > 1 ? "s" : ""}`);
+    for (const kind of [...now].filter((one) => was.has(one))) {
+        const then = new Set([...fieldsOf(before, kind), ...edgesOf(before, kind)]);
+        const since = [...fieldsOf(after, kind), ...edgesOf(after, kind)];
+        const more = since.filter((name) => !then.has(name)).map((name) => humanizeField(name).toLowerCase());
+        const fewer = [...then].filter((name) => !since.includes(name)).map((name) => humanizeField(name).toLowerCase());
+        if (more.length > 0)
+            parts.push(`added ${listed(more)} to ${kindWords(after, kind)}`);
+        if (fewer.length > 0)
+            parts.push(`removed ${listed(fewer)} from ${kindWords(after, kind)}`);
+    }
+    return parts.length > 0 ? capitalize(parts.join("; ")) : "Changed the declaration";
+}
+/**
+ * THE GESTURES "RESTORE TO HERE" TAKES BACK, as one undo (`store.undo`):
+ * every gesture after `seq` still standing, but not an undo whose every
+ * target came after `seq` too — those two cancel already, and taking the
+ * undo back would put its target back. Empty when nothing after `seq`
+ * stands. Whether the undo may run is the store's to judge (`canUndo`,
+ * and the policy when it runs).
+ */
+export function restoreBatches(store, seq) {
+    const ops = store.log.all();
+    const position = new Map(ops.map((op) => [op.id, op.seq]));
+    return store
+        .batches()
+        .filter((batch) => !batch.undone && batch.ops[0].seq >= seq)
+        .filter((batch) => !batch.ops.every((op) => op.undoes !== undefined && (position.get(op.undoes) ?? -1) >= seq))
+        .map((batch) => batch.id);
+}
+/** Who made a tick, in words, for a reader who has the app's people and seats: "you", "Claude", "Ann". */
+export function makerWords(tick, context) {
+    if (tick.withheld)
+        return "Someone";
+    if (tick.maker === "you")
+        return "you";
+    if (!tick.author)
+        return "the app";
+    return nameOfAuthor(tick.author, context);
+}
+//# sourceMappingURL=history.js.map

package/dist/history.js.map

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

package/dist/import/coerce.d.ts

@@ -0,0 +1,45 @@
+import type { FieldSpec } from "../document/schema.js";
+/**
+ * A CELL, READ AS THE FIELD IT GOES IN (FR-177). A spreadsheet holds what a
+ * person typed: "Sep 10, 2023", "$1,200.50", "12 kg", "✓", "In progress".
+ * A field holds what the declaration says it holds — an ISO day, a number,
+ * a boolean, one of its options — so each cell is read by its field's type,
+ * and a cell that cannot be read is said back in words rather than guessed.
+ */
+export type Coerced = {
+    readonly ok: true;
+    readonly value: unknown;
+} | {
+    readonly ok: false;
+    readonly why: string;
+};
+export interface CoerceOptions {
+    /** `3/4/2024` is the 4th of March read day first, the 3rd of April otherwise (US). */
+    readonly dayFirst?: boolean;
+    /** How an option reads to a person, where it is not the option itself: the kind's `display.format`. */
+    readonly optionWords?: (option: string) => string;
+}
+/** A day, as `YYYY-MM-DD`: ISO, US `M/D/YYYY` (or day first), "Sep 10, 2023", "10 September 2023", a spreadsheet's serial day. */
+export declare function readDay(input: unknown, options?: CoerceOptions): string | undefined;
+/** A day and a time, as `YYYY-MM-DDTHH:MM`: the day as `readDay` reads it, then "14:30", "2:30 PM" or "2pm". */
+export declare function readDateTime(input: unknown, options?: CoerceOptions): string | undefined;
+/**
+ * A number, however a sheet wrote it: "$1,200.50", "USD 40", "12 kg",
+ * "(300)" for a loss, "15%" for 0.15. One number per cell; text before or
+ * after it — a currency, a unit — is set aside, text between two numbers
+ * is not a number.
+ */
+export declare function readNumber(input: unknown): number | undefined;
+/** A yes or a no: yes/no, true/false, x, ✓, 1/0. */
+export declare function readBoolean(input: unknown): boolean | undefined;
+/** One of a field's options, by the option itself or its words, case and spacing aside. */
+export declare function readOption(input: unknown, options: readonly string[], words?: (option: string) => string): string | undefined;
+/** Several values in one cell: split on semicolons and line breaks, and on commas when there were none. */
+export declare function splitCell(text: string): string[];
+/** A cell read as a field of this spec. Blank cells are not handed here. */
+export declare function coerceCell(spec: FieldSpec, input: unknown, said: string, options?: CoerceOptions): Coerced;
+/** "a, b or c". */
+export declare function orList(items: readonly string[]): string;
+/** "a, b and c". */
+export declare function andList(items: readonly string[]): string;
+//# sourceMappingURL=coerce.d.ts.map

package/dist/import/coerce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coerce.d.ts","sourceRoot":"","sources":["../../src/import/coerce.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAOvD;;;;;;GAMG;AACH,MAAM,MAAM,OAAO,GAAG;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpH,MAAM,WAAW,aAAa;IAC5B,sFAAsF;IACtF,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,uGAAuG;IACvG,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;CACnD;AAoBD,kIAAkI;AAClI,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE,aAAkB,GAAG,MAAM,GAAG,SAAS,CAgCvF;AASD,gHAAgH;AAChH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE,aAAkB,GAAG,MAAM,GAAG,SAAS,CA6B5F;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAoB7D;AAKD,oDAAoD;AACpD,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAM/D;AAED,2FAA2F;AAC3F,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,MAAM,GAAG,SAAS,CAU7H;AAED,2GAA2G;AAC3G,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAGhD;AAED,4EAA4E;AAC5E,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAwE9G;AAED,mBAAmB;AACnB,wBAAgB,MAAM,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAGvD;AAED,oBAAoB;AACpB,wBAAgB,OAAO,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAGxD"}