@elaraai/e3-ui 1.0.97 → 1.0.98

package/dist/src/schedule/types.d.ts

@@ -424,6 +424,13 @@ export declare const ScheduleRolesType: StructType<{
  * One event kind, closed: every row crosses as bytes at the record's own entry
  * type, so a builder's payload is one type whatever the records hold.
  *
+ * A builder over resources read a window at a time reads a kind placed on them
+ * a cell at a time (#1039, #1424): the shared schedule reader reads the kind's
+ * series index's cells — the events of a block of resources in one time tile —
+ * and hands what it read to the kind's seams as beast2 of `cellsType`. Every
+ * other kind is counted first (`count`), and read over the window only within
+ * the builder's cap.
+ *
  * @property key - The kind's slot name
  * @property name - Its name
  * @property icon - Its Font Awesome icon
@@ -433,15 +440,33 @@ export declare const ScheduleRolesType: StructType<{
  * @property templates - Its templates, for the library
  * @property templatesSource - The builder's Slice source whose shown keys filter its templates, the source its templates list names; none, every template shows (#1343)
  * @property fields - The inspector's form over its other fields (`Fields`)
- * @property items - Its events overlapping `[from, to)`, the drafts in place; `none` while a read is in flight
+ * @property items - Its events overlapping `[from, to)`, the drafts in place; `none` while a read is in flight. Given the
+ *   entries a reader read by the kind's series index's cells (#1039) — beast2 of `cellsType`, a key given twice held once
+ *   — it draws those and never reads the window: every draft given in place, one of an entry not given drawn as drafted,
+ *   for the reader gives a draft of an entry it did not read only where its narrowing holds the entry, or the record
+ *   does not. A builder that caps its kinds (the Calendar's and the Plan's) reads the window only within the cap
+ *   (`SCHEDULE_EVENT_CAP`), counted first: past it, the window answers `none` and reads no page
  * @property unscheduled - Its backlog: the rows with no time, the drafts in place. It takes the window `[from, to)`
  *   the canvas reads: a kind narrowed by its builder's slice holds the events its narrowing holds there and in its
- *   backlog alike, so a draft moves one between them by its times (#1343)
+ *   backlog alike, so a draft moves one between them by its times (#1343). Given the entries a reader read by its cells
+ *   (#1039), it reads its backlog alone, never the window, those entries held beside it
  * @property write - Each gesture into its entry's new bytes; `none` for a gesture the kind refuses
  * @property ready - The author's check over drafted entries, one result each
  * @property editing - The shared session over the record: its entry and key types, and its patch door — its base the record's snapshot, or for a kind read a window at a time (#1199) its revision
  * @property entries - The record read by key, for a kind read a window at a time (#1199); `none` for a kind read whole
  * @property history - The record's commits, newest first
+ * @property event - One event by its key's text, the drafts in place, and its row: `none` when there is no such event. A
+ *   kind read a window at a time (#1199) looks for it first among the rows its windows hold over `[from, to)` and its
+ *   backlog's, then reads it by its key, `none` while that read is in flight; a kind read whole takes no notice of the
+ *   range. Given the event's row as a reader of its cells holds it (#1039), or `some(none)` for one it does not hold, it
+ *   looks there, then in its backlog, then reads it by its key, and never reads the window
+ * @property schedule - The inspector's schedule fields
+ * @property overlaps - Whether two of its events on one resource at once are a conflict
+ * @property inspector - The author's form in place of the default fields
+ * @property seriesKey - The `.east` text of the value its resource field holds for a resource, or for no resource (#1039): what a series or a summary index of its record files that resource's events under, the key a reader's cells search for; `none` where the field cannot hold it — a resource of a kind it does not take, or no resource for a field that must name one
+ * @property cellsType - What a reader encodes the entries it read by cells in for `items`, `unscheduled` and `event` (#1039): an Array of `{ key, row }`, at the record's key and row types
+ * @property count - How many of its stored events overlap `[from, to)`, counted before one is read (#1039) — every kind's are: a kind read through its source of the slice counted through the source's interval index — the count its window's read asks first, so asking it costs no request of its own; a kind read through its day index (`window`) by the entries it files under the days of `[from, to)`, the search its window's read asks first — an event under each day it runs on, so an upper bound on the events, never their number (`countExact`); and a kind whose record is read whole counted in memory. `none` while the count is in flight
+ * @property countExact - Whether `count` counts its events themselves (#1039): `false` for a kind read through its day index, whose count is the days its events run on — what a builder's figures never take for its events, saying they are not counted
  */
 export declare const ScheduleKindType: StructType<{
     readonly key: StringType;
@@ -564,7 +589,7 @@ export declare const ScheduleKindType: StructType<{
             readonly readonly: NullType;
         }>;
     }>>;
-    readonly items: FunctionType<[DateTimeType, DateTimeType, DictType<StringType, BlobType>], OptionType<ArrayType<StructType<{
+    readonly items: FunctionType<[DateTimeType, DateTimeType, DictType<StringType, BlobType>, OptionType<BlobType>], OptionType<ArrayType<StructType<{
         readonly kind: StringType;
         readonly key: StringType;
         readonly title: StringType;
@@ -588,7 +613,7 @@ export declare const ScheduleKindType: StructType<{
         readonly minutes: IntegerType;
         readonly due: OptionType<DateTimeType>;
     }>>>>;
-    readonly unscheduled: FunctionType<[DateTimeType, DateTimeType, DictType<StringType, BlobType>], OptionType<ArrayType<StructType<{
+    readonly unscheduled: FunctionType<[DateTimeType, DateTimeType, DictType<StringType, BlobType>, OptionType<BlobType>], OptionType<ArrayType<StructType<{
         readonly kind: StringType;
         readonly key: StringType;
         readonly title: StringType;
@@ -843,8 +868,7 @@ export declare const ScheduleKindType: StructType<{
         readonly at: DateTimeType;
         readonly delta: OptionType<StringType>;
     }>>>>;
-    /** One event and its row, read from the window or by key, with drafts applied. */
-    readonly event: FunctionType<[StringType, DictType<StringType, BlobType>, DateTimeType, DateTimeType], OptionType<StructType<{
+    readonly event: FunctionType<[StringType, DictType<StringType, BlobType>, DateTimeType, DateTimeType, OptionType<OptionType<BlobType>>], OptionType<StructType<{
         readonly item: StructType<{
             readonly kind: StringType;
             readonly key: StringType;
@@ -871,7 +895,6 @@ export declare const ScheduleKindType: StructType<{
         }>;
         readonly row: BlobType;
     }>>>;
-    /** The inspector's schedule fields. */
     readonly schedule: StructType<{
         readonly title: StringType;
         readonly start: StringType;
@@ -879,13 +902,59 @@ export declare const ScheduleKindType: StructType<{
         readonly resource: OptionType<StringType>;
         readonly status: OptionType<StringType>;
     }>;
-    /** Whether this kind participates in overlap warnings. */
     readonly overlaps: VariantType<{
         readonly warn: NullType;
         readonly allow: NullType;
     }>;
-    /** The author's form in place of the default fields. */
     readonly inspector: OptionType<FunctionType<[BlobType, FunctionType<[BlobType], NullType>], import("@elaraai/east").RecursiveType<import("@elaraai/east-ui").UIComponentNode>>>;
+    readonly seriesKey: FunctionType<[OptionType<StructType<{
+        readonly kind: StringType;
+        readonly key: StringType;
+    }>>], OptionType<StringType>>;
+    readonly cellsType: import("@elaraai/east").RecursiveType<VariantType<{
+        readonly Never: NullType;
+        readonly Null: NullType;
+        readonly Boolean: NullType;
+        readonly Integer: NullType;
+        readonly Float: NullType;
+        readonly String: NullType;
+        readonly DateTime: NullType;
+        readonly Blob: NullType;
+        readonly Ref: import("@elaraai/east").RecursiveTypeMarker;
+        readonly Array: import("@elaraai/east").RecursiveTypeMarker;
+        readonly Set: import("@elaraai/east").RecursiveTypeMarker;
+        readonly Dict: StructType<{
+            readonly key: import("@elaraai/east").RecursiveTypeMarker;
+            readonly value: import("@elaraai/east").RecursiveTypeMarker;
+        }>;
+        readonly Struct: ArrayType<StructType<{
+            readonly name: StringType;
+            readonly type: import("@elaraai/east").RecursiveTypeMarker;
+        }>>;
+        readonly Variant: ArrayType<StructType<{
+            readonly name: StringType;
+            readonly type: import("@elaraai/east").RecursiveTypeMarker;
+        }>>;
+        readonly Recursive: VariantType<{
+            readonly ref: IntegerType;
+            readonly wrapper: StructType<{
+                readonly id: IntegerType;
+                readonly inner: import("@elaraai/east").RecursiveTypeMarker;
+            }>;
+        }>;
+        readonly Function: StructType<{
+            readonly inputs: ArrayType<import("@elaraai/east").RecursiveTypeMarker>;
+            readonly output: import("@elaraai/east").RecursiveTypeMarker;
+        }>;
+        readonly AsyncFunction: StructType<{
+            readonly inputs: ArrayType<import("@elaraai/east").RecursiveTypeMarker>;
+            readonly output: import("@elaraai/east").RecursiveTypeMarker;
+        }>;
+        readonly Vector: import("@elaraai/east").RecursiveTypeMarker;
+        readonly Matrix: import("@elaraai/east").RecursiveTypeMarker;
+    }>>;
+    readonly count: FunctionType<[DateTimeType, DateTimeType], OptionType<IntegerType>>;
+    readonly countExact: BooleanType;
 }>;
 /** Type representing {@link ScheduleKindType}. */
 export type ScheduleKindType = typeof ScheduleKindType;
@@ -903,6 +972,14 @@ export declare const ScheduleResourceRowType: StructType<{
 }>;
 /** Type representing {@link ScheduleResourceRowType}. */
 export type ScheduleResourceRowType = typeof ScheduleResourceRowType;
+/**
+ * A resource kind's records read whole, for the app's optimiser (#1409): its
+ * rows as bytes at `DictType(keyType, rowType)`, read as a run starts — what
+ * the run's request carries of the kind beside the events, as context.
+ */
+export declare const ScheduleResourceRecordsType: FunctionType<[], BlobType>;
+/** Type representing {@link ScheduleResourceRecordsType}. */
+export type ScheduleResourceRecordsType = typeof ScheduleResourceRecordsType;
 /**
  * One resource kind, its rows resolved.
  *
@@ -910,6 +987,9 @@ export type ScheduleResourceRowType = typeof ScheduleResourceRowType;
  * @property name - Its name
  * @property icon - Its Font Awesome icon
  * @property rows - Its resources, in key order
+ * @property keyType - The kind's key type: what the app's optimiser is asked its rows by (#1409)
+ * @property rowType - Its row type
+ * @property records - Its records read whole, as a run's request carries them (#1409); `none` for a kind paged a window at a time, whose rows are never read whole — a run carries none of it
  */
 export declare const ScheduleResourcesType: StructType<{
     readonly key: StringType;
@@ -920,6 +1000,91 @@ export declare const ScheduleResourcesType: StructType<{
         readonly label: StringType;
         readonly meta: OptionType<StringType>;
     }>>;
+    readonly keyType: import("@elaraai/east").RecursiveType<VariantType<{
+        readonly Never: NullType;
+        readonly Null: NullType;
+        readonly Boolean: NullType;
+        readonly Integer: NullType;
+        readonly Float: NullType;
+        readonly String: NullType;
+        readonly DateTime: NullType;
+        readonly Blob: NullType;
+        readonly Ref: import("@elaraai/east").RecursiveTypeMarker;
+        readonly Array: import("@elaraai/east").RecursiveTypeMarker;
+        readonly Set: import("@elaraai/east").RecursiveTypeMarker;
+        readonly Dict: StructType<{
+            readonly key: import("@elaraai/east").RecursiveTypeMarker;
+            readonly value: import("@elaraai/east").RecursiveTypeMarker;
+        }>;
+        readonly Struct: ArrayType<StructType<{
+            readonly name: StringType;
+            readonly type: import("@elaraai/east").RecursiveTypeMarker;
+        }>>;
+        readonly Variant: ArrayType<StructType<{
+            readonly name: StringType;
+            readonly type: import("@elaraai/east").RecursiveTypeMarker;
+        }>>;
+        readonly Recursive: VariantType<{
+            readonly ref: IntegerType;
+            readonly wrapper: StructType<{
+                readonly id: IntegerType;
+                readonly inner: import("@elaraai/east").RecursiveTypeMarker;
+            }>;
+        }>;
+        readonly Function: StructType<{
+            readonly inputs: ArrayType<import("@elaraai/east").RecursiveTypeMarker>;
+            readonly output: import("@elaraai/east").RecursiveTypeMarker;
+        }>;
+        readonly AsyncFunction: StructType<{
+            readonly inputs: ArrayType<import("@elaraai/east").RecursiveTypeMarker>;
+            readonly output: import("@elaraai/east").RecursiveTypeMarker;
+        }>;
+        readonly Vector: import("@elaraai/east").RecursiveTypeMarker;
+        readonly Matrix: import("@elaraai/east").RecursiveTypeMarker;
+    }>>;
+    readonly rowType: import("@elaraai/east").RecursiveType<VariantType<{
+        readonly Never: NullType;
+        readonly Null: NullType;
+        readonly Boolean: NullType;
+        readonly Integer: NullType;
+        readonly Float: NullType;
+        readonly String: NullType;
+        readonly DateTime: NullType;
+        readonly Blob: NullType;
+        readonly Ref: import("@elaraai/east").RecursiveTypeMarker;
+        readonly Array: import("@elaraai/east").RecursiveTypeMarker;
+        readonly Set: import("@elaraai/east").RecursiveTypeMarker;
+        readonly Dict: StructType<{
+            readonly key: import("@elaraai/east").RecursiveTypeMarker;
+            readonly value: import("@elaraai/east").RecursiveTypeMarker;
+        }>;
+        readonly Struct: ArrayType<StructType<{
+            readonly name: StringType;
+            readonly type: import("@elaraai/east").RecursiveTypeMarker;
+        }>>;
+        readonly Variant: ArrayType<StructType<{
+            readonly name: StringType;
+            readonly type: import("@elaraai/east").RecursiveTypeMarker;
+        }>>;
+        readonly Recursive: VariantType<{
+            readonly ref: IntegerType;
+            readonly wrapper: StructType<{
+                readonly id: IntegerType;
+                readonly inner: import("@elaraai/east").RecursiveTypeMarker;
+            }>;
+        }>;
+        readonly Function: StructType<{
+            readonly inputs: ArrayType<import("@elaraai/east").RecursiveTypeMarker>;
+            readonly output: import("@elaraai/east").RecursiveTypeMarker;
+        }>;
+        readonly AsyncFunction: StructType<{
+            readonly inputs: ArrayType<import("@elaraai/east").RecursiveTypeMarker>;
+            readonly output: import("@elaraai/east").RecursiveTypeMarker;
+        }>;
+        readonly Vector: import("@elaraai/east").RecursiveTypeMarker;
+        readonly Matrix: import("@elaraai/east").RecursiveTypeMarker;
+    }>>;
+    readonly records: OptionType<FunctionType<[], BlobType>>;
 }>;
 /** Type representing {@link ScheduleResourcesType}. */
 export type ScheduleResourcesType = typeof ScheduleResourcesType;
@@ -1048,16 +1213,18 @@ export declare const PlanEventRolesType: StructType<{
 export type PlanEventRolesType = typeof PlanEventRolesType;
 /**
  * One event kind as Plan's builder takes it: the Calendar's closed kind
- * ({@link ScheduleKindType}), field for field, with how the kind draws and its
- * roles, its events as Plan draws them, and its own inspector.
+ * ({@link ScheduleKindType}), field for field — its cells' seams and its count
+ * among them (#1039) — with how the kind draws and its roles, its events as
+ * Plan draws them, and its own inspector.
  *
  * @property draw - How it draws: bars, tiles, chips or marks
  * @property instant - Whether each of its events is one instant (`at`), its start and its end the same
  * @property overlaps - Whether two of its events on one resource at once are a conflict
  * @property roles - The fields its roles read
- * @property planItems - Its events overlapping `[from, to)` as Plan draws them, the drafts in place; `none` while a read is in flight
- * @property planUnscheduled - Its backlog as Plan draws it, the drafts in place, over the window `[from, to)` the canvas reads, as `unscheduled` takes it
- * @property planEvent - One event by its key's text, the drafts in place (#1197): as Plan draws it, and its row; `none` when there is no such event. A kind read a window at a time (#1199) looks for it first among the rows its windows hold over `[from, to)` — the range the canvas reads, where a gesture's event is drawn — and its backlog's, then reads it by its key, `none` while that read is in flight; a kind read whole takes no notice of the range
+ * @property planItems - Its events overlapping `[from, to)` as Plan draws them, as `items` reads them: the drafts in place, from the entries a reader read by its cells when it is given them, else over the window; `none` while a read is in flight
+ * @property planUnscheduled - Its backlog as Plan draws it, as `unscheduled` reads it
+ * @property planEvent - One event by its key's text, the drafts in place (#1197): as Plan draws it, and its row, as `event` reads it; `none` when there is no such event
+ * @property planRows - Its events' rows over `[from, to)` and its backlog's beside them, by key, the drafts in place, read once (#1409, R24): beast2 of `DictType(keyType, rowType)`, the record's own key and row types — the reads `planEvent` finds one row in, so a run's request finds every event's row there rather than reading them all again an event; `none` while a read is in flight. It reads the window, never a reader's cells: a kind read by its cells carries no request
  * @property inspector - Its own inspector for one event (PB60, #1197): the event's row and a writer of the edited row, as bytes, to what the inspector shows in place of the kind's form; `none`, the form
  */
 export declare const PlanEventKindType: StructType<{
@@ -1077,7 +1244,7 @@ export declare const PlanEventKindType: StructType<{
         readonly quantity: OptionType<StringType>;
         readonly lane: OptionType<StringType>;
     }>;
-    readonly planItems: FunctionType<[DateTimeType, DateTimeType, DictType<StringType, BlobType>], OptionType<ArrayType<StructType<{
+    readonly planItems: FunctionType<[DateTimeType, DateTimeType, DictType<StringType, BlobType>, OptionType<BlobType>], OptionType<ArrayType<StructType<{
         readonly state: VariantType<{
             readonly estimated: NullType;
             readonly proposed: VariantType<{
@@ -1120,7 +1287,7 @@ export declare const PlanEventKindType: StructType<{
         readonly minutes: IntegerType;
         readonly due: OptionType<DateTimeType>;
     }>>>>;
-    readonly planUnscheduled: FunctionType<[DateTimeType, DateTimeType, DictType<StringType, BlobType>], OptionType<ArrayType<StructType<{
+    readonly planUnscheduled: FunctionType<[DateTimeType, DateTimeType, DictType<StringType, BlobType>, OptionType<BlobType>], OptionType<ArrayType<StructType<{
         readonly state: VariantType<{
             readonly estimated: NullType;
             readonly proposed: VariantType<{
@@ -1163,7 +1330,7 @@ export declare const PlanEventKindType: StructType<{
         readonly minutes: IntegerType;
         readonly due: OptionType<DateTimeType>;
     }>>>>;
-    readonly planEvent: FunctionType<[StringType, DictType<StringType, BlobType>, DateTimeType, DateTimeType], OptionType<StructType<{
+    readonly planEvent: FunctionType<[StringType, DictType<StringType, BlobType>, DateTimeType, DateTimeType, OptionType<OptionType<BlobType>>], OptionType<StructType<{
         readonly item: StructType<{
             readonly state: VariantType<{
                 readonly estimated: NullType;
@@ -1209,6 +1376,7 @@ export declare const PlanEventKindType: StructType<{
         }>;
         readonly row: BlobType;
     }>>>;
+    readonly planRows: FunctionType<[DateTimeType, DateTimeType, DictType<StringType, BlobType>], OptionType<BlobType>>;
     readonly inspector: OptionType<FunctionType<[BlobType, FunctionType<[BlobType], NullType>], import("@elaraai/east").RecursiveType<import("@elaraai/east-ui").UIComponentNode>>>;
     readonly key: StringType;
     readonly name: StringType;
@@ -1330,7 +1498,7 @@ export declare const PlanEventKindType: StructType<{
             readonly readonly: NullType;
         }>;
     }>>;
-    readonly items: FunctionType<[DateTimeType, DateTimeType, DictType<StringType, BlobType>], OptionType<ArrayType<StructType<{
+    readonly items: FunctionType<[DateTimeType, DateTimeType, DictType<StringType, BlobType>, OptionType<BlobType>], OptionType<ArrayType<StructType<{
         readonly kind: StringType;
         readonly key: StringType;
         readonly title: StringType;
@@ -1354,7 +1522,7 @@ export declare const PlanEventKindType: StructType<{
         readonly minutes: IntegerType;
         readonly due: OptionType<DateTimeType>;
     }>>>>;
-    readonly unscheduled: FunctionType<[DateTimeType, DateTimeType, DictType<StringType, BlobType>], OptionType<ArrayType<StructType<{
+    readonly unscheduled: FunctionType<[DateTimeType, DateTimeType, DictType<StringType, BlobType>, OptionType<BlobType>], OptionType<ArrayType<StructType<{
         readonly kind: StringType;
         readonly key: StringType;
         readonly title: StringType;
@@ -1609,8 +1777,7 @@ export declare const PlanEventKindType: StructType<{
         readonly at: DateTimeType;
         readonly delta: OptionType<StringType>;
     }>>>>;
-    /** One event and its row, read from the window or by key, with drafts applied. */
-    readonly event: FunctionType<[StringType, DictType<StringType, BlobType>, DateTimeType, DateTimeType], OptionType<StructType<{
+    readonly event: FunctionType<[StringType, DictType<StringType, BlobType>, DateTimeType, DateTimeType, OptionType<OptionType<BlobType>>], OptionType<StructType<{
         readonly item: StructType<{
             readonly kind: StringType;
             readonly key: StringType;
@@ -1637,7 +1804,6 @@ export declare const PlanEventKindType: StructType<{
         }>;
         readonly row: BlobType;
     }>>>;
-    /** The inspector's schedule fields. */
     readonly schedule: StructType<{
         readonly title: StringType;
         readonly start: StringType;
@@ -1645,6 +1811,54 @@ export declare const PlanEventKindType: StructType<{
         readonly resource: OptionType<StringType>;
         readonly status: OptionType<StringType>;
     }>;
+    readonly seriesKey: FunctionType<[OptionType<StructType<{
+        readonly kind: StringType;
+        readonly key: StringType;
+    }>>], OptionType<StringType>>;
+    readonly cellsType: import("@elaraai/east").RecursiveType<VariantType<{
+        readonly Never: NullType;
+        readonly Null: NullType;
+        readonly Boolean: NullType;
+        readonly Integer: NullType;
+        readonly Float: NullType;
+        readonly String: NullType;
+        readonly DateTime: NullType;
+        readonly Blob: NullType;
+        readonly Ref: import("@elaraai/east").RecursiveTypeMarker;
+        readonly Array: import("@elaraai/east").RecursiveTypeMarker;
+        readonly Set: import("@elaraai/east").RecursiveTypeMarker;
+        readonly Dict: StructType<{
+            readonly key: import("@elaraai/east").RecursiveTypeMarker;
+            readonly value: import("@elaraai/east").RecursiveTypeMarker;
+        }>;
+        readonly Struct: ArrayType<StructType<{
+            readonly name: StringType;
+            readonly type: import("@elaraai/east").RecursiveTypeMarker;
+        }>>;
+        readonly Variant: ArrayType<StructType<{
+            readonly name: StringType;
+            readonly type: import("@elaraai/east").RecursiveTypeMarker;
+        }>>;
+        readonly Recursive: VariantType<{
+            readonly ref: IntegerType;
+            readonly wrapper: StructType<{
+                readonly id: IntegerType;
+                readonly inner: import("@elaraai/east").RecursiveTypeMarker;
+            }>;
+        }>;
+        readonly Function: StructType<{
+            readonly inputs: ArrayType<import("@elaraai/east").RecursiveTypeMarker>;
+            readonly output: import("@elaraai/east").RecursiveTypeMarker;
+        }>;
+        readonly AsyncFunction: StructType<{
+            readonly inputs: ArrayType<import("@elaraai/east").RecursiveTypeMarker>;
+            readonly output: import("@elaraai/east").RecursiveTypeMarker;
+        }>;
+        readonly Vector: import("@elaraai/east").RecursiveTypeMarker;
+        readonly Matrix: import("@elaraai/east").RecursiveTypeMarker;
+    }>>;
+    readonly count: FunctionType<[DateTimeType, DateTimeType], OptionType<IntegerType>>;
+    readonly countExact: BooleanType;
 }>;
 /** Type representing {@link PlanEventKindType}. */
 export type PlanEventKindType = typeof PlanEventKindType;
@@ -1688,6 +1902,9 @@ export type PlanResourceRowType = typeof PlanResourceRowType;
  * @property measures - Its measures' keys, in order: the rows under each of its resources, each at its resource's path (#1197)
  * @property rows - Its resources, in key order — none for a kind paged a window at a time (#1199)
  * @property byKey - A paged kind's resource by its key's text (#1199): its window's key search for the key, then a one-row page, as Plan's builder takes it — `none` while either is in flight, `some(none)` for a key the kind does not have; `none` for a kind whose rows are listed
+ * @property keyType - The kind's key type: what the app's optimiser is asked its rows by (#1409)
+ * @property rowType - Its row type
+ * @property records - Its records read whole, as a run's request carries them (#1409); `none` for a kind paged a window at a time — a run carries none of it
  */
 export declare const PlanResourcesType: StructType<{
     readonly key: StringType;
@@ -1733,6 +1950,91 @@ export declare const PlanResourcesType: StructType<{
         readonly label: StringType;
         readonly meta: OptionType<StringType>;
     }>>>>>;
+    readonly keyType: import("@elaraai/east").RecursiveType<VariantType<{
+        readonly Never: NullType;
+        readonly Null: NullType;
+        readonly Boolean: NullType;
+        readonly Integer: NullType;
+        readonly Float: NullType;
+        readonly String: NullType;
+        readonly DateTime: NullType;
+        readonly Blob: NullType;
+        readonly Ref: import("@elaraai/east").RecursiveTypeMarker;
+        readonly Array: import("@elaraai/east").RecursiveTypeMarker;
+        readonly Set: import("@elaraai/east").RecursiveTypeMarker;
+        readonly Dict: StructType<{
+            readonly key: import("@elaraai/east").RecursiveTypeMarker;
+            readonly value: import("@elaraai/east").RecursiveTypeMarker;
+        }>;
+        readonly Struct: ArrayType<StructType<{
+            readonly name: StringType;
+            readonly type: import("@elaraai/east").RecursiveTypeMarker;
+        }>>;
+        readonly Variant: ArrayType<StructType<{
+            readonly name: StringType;
+            readonly type: import("@elaraai/east").RecursiveTypeMarker;
+        }>>;
+        readonly Recursive: VariantType<{
+            readonly ref: IntegerType;
+            readonly wrapper: StructType<{
+                readonly id: IntegerType;
+                readonly inner: import("@elaraai/east").RecursiveTypeMarker;
+            }>;
+        }>;
+        readonly Function: StructType<{
+            readonly inputs: ArrayType<import("@elaraai/east").RecursiveTypeMarker>;
+            readonly output: import("@elaraai/east").RecursiveTypeMarker;
+        }>;
+        readonly AsyncFunction: StructType<{
+            readonly inputs: ArrayType<import("@elaraai/east").RecursiveTypeMarker>;
+            readonly output: import("@elaraai/east").RecursiveTypeMarker;
+        }>;
+        readonly Vector: import("@elaraai/east").RecursiveTypeMarker;
+        readonly Matrix: import("@elaraai/east").RecursiveTypeMarker;
+    }>>;
+    readonly rowType: import("@elaraai/east").RecursiveType<VariantType<{
+        readonly Never: NullType;
+        readonly Null: NullType;
+        readonly Boolean: NullType;
+        readonly Integer: NullType;
+        readonly Float: NullType;
+        readonly String: NullType;
+        readonly DateTime: NullType;
+        readonly Blob: NullType;
+        readonly Ref: import("@elaraai/east").RecursiveTypeMarker;
+        readonly Array: import("@elaraai/east").RecursiveTypeMarker;
+        readonly Set: import("@elaraai/east").RecursiveTypeMarker;
+        readonly Dict: StructType<{
+            readonly key: import("@elaraai/east").RecursiveTypeMarker;
+            readonly value: import("@elaraai/east").RecursiveTypeMarker;
+        }>;
+        readonly Struct: ArrayType<StructType<{
+            readonly name: StringType;
+            readonly type: import("@elaraai/east").RecursiveTypeMarker;
+        }>>;
+        readonly Variant: ArrayType<StructType<{
+            readonly name: StringType;
+            readonly type: import("@elaraai/east").RecursiveTypeMarker;
+        }>>;
+        readonly Recursive: VariantType<{
+            readonly ref: IntegerType;
+            readonly wrapper: StructType<{
+                readonly id: IntegerType;
+                readonly inner: import("@elaraai/east").RecursiveTypeMarker;
+            }>;
+        }>;
+        readonly Function: StructType<{
+            readonly inputs: ArrayType<import("@elaraai/east").RecursiveTypeMarker>;
+            readonly output: import("@elaraai/east").RecursiveTypeMarker;
+        }>;
+        readonly AsyncFunction: StructType<{
+            readonly inputs: ArrayType<import("@elaraai/east").RecursiveTypeMarker>;
+            readonly output: import("@elaraai/east").RecursiveTypeMarker;
+        }>;
+        readonly Vector: import("@elaraai/east").RecursiveTypeMarker;
+        readonly Matrix: import("@elaraai/east").RecursiveTypeMarker;
+    }>>;
+    readonly records: OptionType<FunctionType<[], BlobType>>;
 }>;
 /** Type representing {@link PlanResourcesType}. */
 export type PlanResourcesType = typeof PlanResourcesType;
@@ -1926,7 +2228,7 @@ export declare const ScheduleRosterKindType: StructType<{
                 readonly readonly: NullType;
             }>;
         }>>;
-        readonly items: FunctionType<[DateTimeType, DateTimeType, DictType<StringType, BlobType>], OptionType<ArrayType<StructType<{
+        readonly items: FunctionType<[DateTimeType, DateTimeType, DictType<StringType, BlobType>, OptionType<BlobType>], OptionType<ArrayType<StructType<{
             readonly kind: StringType;
             readonly key: StringType;
             readonly title: StringType;
@@ -1950,7 +2252,7 @@ export declare const ScheduleRosterKindType: StructType<{
             readonly minutes: IntegerType;
             readonly due: OptionType<DateTimeType>;
         }>>>>;
-        readonly unscheduled: FunctionType<[DateTimeType, DateTimeType, DictType<StringType, BlobType>], OptionType<ArrayType<StructType<{
+        readonly unscheduled: FunctionType<[DateTimeType, DateTimeType, DictType<StringType, BlobType>, OptionType<BlobType>], OptionType<ArrayType<StructType<{
             readonly kind: StringType;
             readonly key: StringType;
             readonly title: StringType;
@@ -2205,8 +2507,7 @@ export declare const ScheduleRosterKindType: StructType<{
             readonly at: DateTimeType;
             readonly delta: OptionType<StringType>;
         }>>>>;
-        /** One event and its row, read from the window or by key, with drafts applied. */
-        readonly event: FunctionType<[StringType, DictType<StringType, BlobType>, DateTimeType, DateTimeType], OptionType<StructType<{
+        readonly event: FunctionType<[StringType, DictType<StringType, BlobType>, DateTimeType, DateTimeType, OptionType<OptionType<BlobType>>], OptionType<StructType<{
             readonly item: StructType<{
                 readonly kind: StringType;
                 readonly key: StringType;
@@ -2233,7 +2534,6 @@ export declare const ScheduleRosterKindType: StructType<{
             }>;
             readonly row: BlobType;
         }>>>;
-        /** The inspector's schedule fields. */
         readonly schedule: StructType<{
             readonly title: StringType;
             readonly start: StringType;
@@ -2241,13 +2541,59 @@ export declare const ScheduleRosterKindType: StructType<{
             readonly resource: OptionType<StringType>;
             readonly status: OptionType<StringType>;
         }>;
-        /** Whether this kind participates in overlap warnings. */
         readonly overlaps: VariantType<{
             readonly warn: NullType;
             readonly allow: NullType;
         }>;
-        /** The author's form in place of the default fields. */
         readonly inspector: OptionType<FunctionType<[BlobType, FunctionType<[BlobType], NullType>], import("@elaraai/east").RecursiveType<import("@elaraai/east-ui").UIComponentNode>>>;
+        readonly seriesKey: FunctionType<[OptionType<StructType<{
+            readonly kind: StringType;
+            readonly key: StringType;
+        }>>], OptionType<StringType>>;
+        readonly cellsType: import("@elaraai/east").RecursiveType<VariantType<{
+            readonly Never: NullType;
+            readonly Null: NullType;
+            readonly Boolean: NullType;
+            readonly Integer: NullType;
+            readonly Float: NullType;
+            readonly String: NullType;
+            readonly DateTime: NullType;
+            readonly Blob: NullType;
+            readonly Ref: import("@elaraai/east").RecursiveTypeMarker;
+            readonly Array: import("@elaraai/east").RecursiveTypeMarker;
+            readonly Set: import("@elaraai/east").RecursiveTypeMarker;
+            readonly Dict: StructType<{
+                readonly key: import("@elaraai/east").RecursiveTypeMarker;
+                readonly value: import("@elaraai/east").RecursiveTypeMarker;
+            }>;
+            readonly Struct: ArrayType<StructType<{
+                readonly name: StringType;
+                readonly type: import("@elaraai/east").RecursiveTypeMarker;
+            }>>;
+            readonly Variant: ArrayType<StructType<{
+                readonly name: StringType;
+                readonly type: import("@elaraai/east").RecursiveTypeMarker;
+            }>>;
+            readonly Recursive: VariantType<{
+                readonly ref: IntegerType;
+                readonly wrapper: StructType<{
+                    readonly id: IntegerType;
+                    readonly inner: import("@elaraai/east").RecursiveTypeMarker;
+                }>;
+            }>;
+            readonly Function: StructType<{
+                readonly inputs: ArrayType<import("@elaraai/east").RecursiveTypeMarker>;
+                readonly output: import("@elaraai/east").RecursiveTypeMarker;
+            }>;
+            readonly AsyncFunction: StructType<{
+                readonly inputs: ArrayType<import("@elaraai/east").RecursiveTypeMarker>;
+                readonly output: import("@elaraai/east").RecursiveTypeMarker;
+            }>;
+            readonly Vector: import("@elaraai/east").RecursiveTypeMarker;
+            readonly Matrix: import("@elaraai/east").RecursiveTypeMarker;
+        }>>;
+        readonly count: FunctionType<[DateTimeType, DateTimeType], OptionType<IntegerType>>;
+        readonly countExact: BooleanType;
     }>;
     readonly rows: FunctionType<[DateTimeType, DateTimeType], OptionType<DictType<StringType, StructType<{
         readonly roles: StructType<{
@@ -2547,7 +2893,7 @@ export declare const ScheduleAllocationKindType: StructType<{
                 readonly readonly: NullType;
             }>;
         }>>;
-        readonly items: FunctionType<[DateTimeType, DateTimeType, DictType<StringType, BlobType>], OptionType<ArrayType<StructType<{
+        readonly items: FunctionType<[DateTimeType, DateTimeType, DictType<StringType, BlobType>, OptionType<BlobType>], OptionType<ArrayType<StructType<{
             readonly kind: StringType;
             readonly key: StringType;
             readonly title: StringType;
@@ -2571,7 +2917,7 @@ export declare const ScheduleAllocationKindType: StructType<{
             readonly minutes: IntegerType;
             readonly due: OptionType<DateTimeType>;
         }>>>>;
-        readonly unscheduled: FunctionType<[DateTimeType, DateTimeType, DictType<StringType, BlobType>], OptionType<ArrayType<StructType<{
+        readonly unscheduled: FunctionType<[DateTimeType, DateTimeType, DictType<StringType, BlobType>, OptionType<BlobType>], OptionType<ArrayType<StructType<{
             readonly kind: StringType;
             readonly key: StringType;
             readonly title: StringType;
@@ -2826,8 +3172,7 @@ export declare const ScheduleAllocationKindType: StructType<{
             readonly at: DateTimeType;
             readonly delta: OptionType<StringType>;
         }>>>>;
-        /** One event and its row, read from the window or by key, with drafts applied. */
-        readonly event: FunctionType<[StringType, DictType<StringType, BlobType>, DateTimeType, DateTimeType], OptionType<StructType<{
+        readonly event: FunctionType<[StringType, DictType<StringType, BlobType>, DateTimeType, DateTimeType, OptionType<OptionType<BlobType>>], OptionType<StructType<{
             readonly item: StructType<{
                 readonly kind: StringType;
                 readonly key: StringType;
@@ -2854,7 +3199,6 @@ export declare const ScheduleAllocationKindType: StructType<{
             }>;
             readonly row: BlobType;
         }>>>;
-        /** The inspector's schedule fields. */
         readonly schedule: StructType<{
             readonly title: StringType;
             readonly start: StringType;
@@ -2862,13 +3206,59 @@ export declare const ScheduleAllocationKindType: StructType<{
             readonly resource: OptionType<StringType>;
             readonly status: OptionType<StringType>;
         }>;
-        /** Whether this kind participates in overlap warnings. */
         readonly overlaps: VariantType<{
             readonly warn: NullType;
             readonly allow: NullType;
         }>;
-        /** The author's form in place of the default fields. */
         readonly inspector: OptionType<FunctionType<[BlobType, FunctionType<[BlobType], NullType>], import("@elaraai/east").RecursiveType<import("@elaraai/east-ui").UIComponentNode>>>;
+        readonly seriesKey: FunctionType<[OptionType<StructType<{
+            readonly kind: StringType;
+            readonly key: StringType;
+        }>>], OptionType<StringType>>;
+        readonly cellsType: import("@elaraai/east").RecursiveType<VariantType<{
+            readonly Never: NullType;
+            readonly Null: NullType;
+            readonly Boolean: NullType;
+            readonly Integer: NullType;
+            readonly Float: NullType;
+            readonly String: NullType;
+            readonly DateTime: NullType;
+            readonly Blob: NullType;
+            readonly Ref: import("@elaraai/east").RecursiveTypeMarker;
+            readonly Array: import("@elaraai/east").RecursiveTypeMarker;
+            readonly Set: import("@elaraai/east").RecursiveTypeMarker;
+            readonly Dict: StructType<{
+                readonly key: import("@elaraai/east").RecursiveTypeMarker;
+                readonly value: import("@elaraai/east").RecursiveTypeMarker;
+            }>;
+            readonly Struct: ArrayType<StructType<{
+                readonly name: StringType;
+                readonly type: import("@elaraai/east").RecursiveTypeMarker;
+            }>>;
+            readonly Variant: ArrayType<StructType<{
+                readonly name: StringType;
+                readonly type: import("@elaraai/east").RecursiveTypeMarker;
+            }>>;
+            readonly Recursive: VariantType<{
+                readonly ref: IntegerType;
+                readonly wrapper: StructType<{
+                    readonly id: IntegerType;
+                    readonly inner: import("@elaraai/east").RecursiveTypeMarker;
+                }>;
+            }>;
+            readonly Function: StructType<{
+                readonly inputs: ArrayType<import("@elaraai/east").RecursiveTypeMarker>;
+                readonly output: import("@elaraai/east").RecursiveTypeMarker;
+            }>;
+            readonly AsyncFunction: StructType<{
+                readonly inputs: ArrayType<import("@elaraai/east").RecursiveTypeMarker>;
+                readonly output: import("@elaraai/east").RecursiveTypeMarker;
+            }>;
+            readonly Vector: import("@elaraai/east").RecursiveTypeMarker;
+            readonly Matrix: import("@elaraai/east").RecursiveTypeMarker;
+        }>>;
+        readonly count: FunctionType<[DateTimeType, DateTimeType], OptionType<IntegerType>>;
+        readonly countExact: BooleanType;
     }>;
     readonly rows: FunctionType<[DateTimeType, DateTimeType], OptionType<DictType<StringType, StructType<{
         readonly roles: StructType<{