@elaraai/e3-ui 1.0.96 → 1.0.98

package/dist/src/calendar/index.d.ts

@@ -5,11 +5,14 @@
 import { ArrayType, BooleanType, DateTimeType, DictType, FunctionType, IntegerType, NullType, OptionType, StringType, StructType, VariantType, type EastType, type ExprType, type SubtypeExprOrValue } from "@elaraai/east";
 import { type UIElement } from "@elaraai/east-ui";
 import { RowSourceType, type RecordSlicesChromeOptions } from "@elaraai/east-ui/internal";
+import type { OptimiseHandle } from "../utils/optimise.js";
 import { type ScheduleNamespace } from "../schedule/index.js";
+import { ScheduleOptimiseRequestTypeFor, ScheduleOptimiseResultTypeFor } from "../schedule/optimise.js";
 import type { ScheduleEventKind } from "../schedule/events.js";
 import type { ScheduleResourceKind } from "../schedule/resources.js";
 import { type ScheduleTabDeclaration, type ScheduleLibraryTabConfig } from "../schedule/library.js";
 import { ScheduleCandidateType, ScheduleEventRefType } from "../schedule/types.js";
+export { CalendarPagedType, createCalendarPaged } from "./paged.js";
 /** Calendar's layout: a time grid, resource columns or a horizontal timeline. */
 export declare const CalendarLayoutType: VariantType<{
     readonly calendar: NullType;
@@ -89,10 +92,14 @@ export declare const CalendarSettingsType: StructType<{
 }>;
 /**
  * Calendar's closed interface to its React renderer. The frame is a renderer detail.
+ * @property resources - The resource kinds, their rows resolved — none for a kind paged a window at a time, whose resources come through `paged`
+ * @property paged - A paged resource kind's resources a window at a time (#1424) — of the narrowing's, when its source of the slice narrows it; `none` while no resource kind is paged
  * @property slice - The narrowing's chrome: a Slice over the event kinds', the resource kinds' and the templates' records, one rail (#1343)
  * @property narrowed - Each source's narrowed keys, paged through its own data, by the source's name — a resource
- *   kind's narrow its columns, rows and Choosers, a templates list's and a tab's their cards; an event kind reads its
- *   own narrowing through its part
+ *   kind's read whole narrow its columns, rows and Choosers, a templates list's and a tab's their cards; an event kind
+ *   reads its own narrowing through its part, and a paged resource kind its windows
+ * @property optimise - The app's optimiser, by its `e3.function`'s name (#1409): what the Elara eye calls over the window in
+ *   view, its result one edit of the session; `none`, no eye
  */
 export declare const CalendarPayloadType: StructType<{
     readonly events: ArrayType<StructType<{
@@ -216,7 +223,7 @@ export declare const CalendarPayloadType: StructType<{
                 readonly readonly: NullType;
             }>;
         }>>;
-        readonly items: FunctionType<[DateTimeType, DateTimeType, DictType<StringType, import("@elaraai/east").BlobType>], OptionType<ArrayType<StructType<{
+        readonly items: FunctionType<[DateTimeType, DateTimeType, DictType<StringType, import("@elaraai/east").BlobType>, OptionType<import("@elaraai/east").BlobType>], OptionType<ArrayType<StructType<{
             readonly kind: StringType;
             readonly key: StringType;
             readonly title: StringType;
@@ -240,7 +247,7 @@ export declare const CalendarPayloadType: StructType<{
             readonly minutes: IntegerType;
             readonly due: OptionType<DateTimeType>;
         }>>>>;
-        readonly unscheduled: FunctionType<[DateTimeType, DateTimeType, DictType<StringType, import("@elaraai/east").BlobType>], OptionType<ArrayType<StructType<{
+        readonly unscheduled: FunctionType<[DateTimeType, DateTimeType, DictType<StringType, import("@elaraai/east").BlobType>, OptionType<import("@elaraai/east").BlobType>], OptionType<ArrayType<StructType<{
             readonly kind: StringType;
             readonly key: StringType;
             readonly title: StringType;
@@ -495,7 +502,7 @@ export declare const CalendarPayloadType: StructType<{
             readonly at: DateTimeType;
             readonly delta: OptionType<StringType>;
         }>>>>;
-        readonly event: FunctionType<[StringType, DictType<StringType, import("@elaraai/east").BlobType>, DateTimeType, DateTimeType], OptionType<StructType<{
+        readonly event: FunctionType<[StringType, DictType<StringType, import("@elaraai/east").BlobType>, DateTimeType, DateTimeType, OptionType<OptionType<import("@elaraai/east").BlobType>>], OptionType<StructType<{
             readonly item: StructType<{
                 readonly kind: StringType;
                 readonly key: StringType;
@@ -534,6 +541,54 @@ export declare const CalendarPayloadType: StructType<{
             readonly allow: NullType;
         }>;
         readonly inspector: OptionType<FunctionType<[import("@elaraai/east").BlobType, FunctionType<[import("@elaraai/east").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 resources: ArrayType<StructType<{
         readonly key: StringType;
@@ -544,6 +599,131 @@ export declare const CalendarPayloadType: 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<[], import("@elaraai/east").BlobType>>;
+    }>>;
+    readonly paged: OptionType<StructType<{
+        readonly kind: StringType;
+        readonly id: StringType;
+        readonly rows: FunctionType<[IntegerType, IntegerType], OptionType<ArrayType<StructType<{
+            readonly key: StringType;
+            readonly label: StringType;
+            readonly meta: OptionType<StringType>;
+        }>>>>;
+        readonly keys: FunctionType<[IntegerType, IntegerType], OptionType<ArrayType<StringType>>>;
+        readonly total: FunctionType<[], OptionType<IntegerType>>;
+        readonly revision: FunctionType<[], OptionType<StringType>>;
+        readonly refresh: FunctionType<[OptionType<StringType>], NullType>;
+        readonly query: OptionType<FunctionType<[], StringType>>;
+        readonly seek: OptionType<FunctionType<[VariantType<{
+            readonly key: StringType;
+            readonly prefix: StringType;
+            readonly fields: StructType<{
+                readonly values: ArrayType<StringType>;
+                readonly prefix: OptionType<StringType>;
+            }>;
+            readonly range: StructType<{
+                readonly from: ArrayType<StringType>;
+                readonly to: ArrayType<StringType>;
+            }>;
+        }>], OptionType<StructType<{
+            readonly found: BooleanType;
+            readonly row: IntegerType;
+            readonly count: IntegerType;
+        }>>>>;
+        readonly entries: FunctionType<[IntegerType, IntegerType], OptionType<ArrayType<StructType<{
+            readonly key: StringType;
+            readonly label: StringType;
+            readonly meta: OptionType<StringType>;
+        }>>>>;
+        readonly byKey: FunctionType<[StringType], OptionType<OptionType<StructType<{
+            readonly key: StringType;
+            readonly label: StringType;
+            readonly meta: OptionType<StringType>;
+        }>>>>;
     }>>;
     readonly settings: StructType<{
         readonly layout: VariantType<{
@@ -714,6 +894,39 @@ export declare const CalendarPayloadType: StructType<{
                                 readonly to: import("@elaraai/east").StringType;
                                 readonly optional: import("@elaraai/east").BooleanType;
                             }>>;
+                            readonly area: OptionType<StructType<{
+                                readonly x: import("@elaraai/east").StringType;
+                                readonly y: import("@elaraai/east").StringType;
+                                readonly width: OptionType<import("@elaraai/east").StringType>;
+                                readonly height: OptionType<import("@elaraai/east").StringType>;
+                                readonly centre: import("@elaraai/east").BooleanType;
+                                readonly cell: import("@elaraai/east").FloatType;
+                                readonly optional: import("@elaraai/east").BooleanType;
+                            }>>;
+                            readonly series: OptionType<StructType<{
+                                readonly key: import("@elaraai/east").StringType;
+                                readonly from: import("@elaraai/east").StringType;
+                                readonly to: import("@elaraai/east").StringType;
+                                readonly tile: VariantType<{
+                                    readonly day: NullType;
+                                    readonly week: NullType;
+                                    readonly month: NullType;
+                                    readonly quarter: NullType;
+                                    readonly year: NullType;
+                                }>;
+                            }>>;
+                            readonly summary: OptionType<StructType<{
+                                readonly key: import("@elaraai/east").StringType;
+                                readonly from: import("@elaraai/east").StringType;
+                                readonly to: import("@elaraai/east").StringType;
+                                readonly tile: VariantType<{
+                                    readonly day: NullType;
+                                    readonly week: NullType;
+                                    readonly month: NullType;
+                                    readonly quarter: NullType;
+                                    readonly year: NullType;
+                                }>;
+                            }>>;
                         }>>;
                         readonly range: OptionType<import("@elaraai/east").StringType>;
                         readonly search: ArrayType<import("@elaraai/east").StringType>;
@@ -727,6 +940,12 @@ export declare const CalendarPayloadType: StructType<{
                                     readonly to: import("@elaraai/east").StringType;
                                 }>;
                                 readonly prefix: import("@elaraai/east").StringType;
+                                readonly window: StructType<{
+                                    readonly minX: import("@elaraai/east").FloatType;
+                                    readonly minY: import("@elaraai/east").FloatType;
+                                    readonly maxX: import("@elaraai/east").FloatType;
+                                    readonly maxY: import("@elaraai/east").FloatType;
+                                }>;
                             }>>;
                         }>>;
                     }>;
@@ -738,6 +957,12 @@ export declare const CalendarPayloadType: StructType<{
                                 readonly to: import("@elaraai/east").StringType;
                             }>;
                             readonly prefix: import("@elaraai/east").StringType;
+                            readonly window: StructType<{
+                                readonly minX: import("@elaraai/east").FloatType;
+                                readonly minY: import("@elaraai/east").FloatType;
+                                readonly maxX: import("@elaraai/east").FloatType;
+                                readonly maxY: import("@elaraai/east").FloatType;
+                            }>;
                         }>>;
                         readonly preset: OptionType<import("@elaraai/east").StringType>;
                         readonly resolution: OptionType<VariantType<{
@@ -758,6 +983,12 @@ export declare const CalendarPayloadType: StructType<{
                                 readonly to: import("@elaraai/east").StringType;
                             }>;
                             readonly prefix: import("@elaraai/east").StringType;
+                            readonly window: StructType<{
+                                readonly minX: import("@elaraai/east").FloatType;
+                                readonly minY: import("@elaraai/east").FloatType;
+                                readonly maxX: import("@elaraai/east").FloatType;
+                                readonly maxY: import("@elaraai/east").FloatType;
+                            }>;
                         }>>;
                         readonly preset: OptionType<import("@elaraai/east").StringType>;
                         readonly resolution: OptionType<VariantType<{
@@ -783,6 +1014,12 @@ export declare const CalendarPayloadType: StructType<{
                             readonly to: import("@elaraai/east").StringType;
                         }>;
                         readonly prefix: import("@elaraai/east").StringType;
+                        readonly window: StructType<{
+                            readonly minX: import("@elaraai/east").FloatType;
+                            readonly minY: import("@elaraai/east").FloatType;
+                            readonly maxX: import("@elaraai/east").FloatType;
+                            readonly maxY: import("@elaraai/east").FloatType;
+                        }>;
                     }>>], OptionType<import("@elaraai/east").IntegerType>>;
                     readonly total: import("@elaraai/east").FunctionType<[], OptionType<import("@elaraai/east").IntegerType>>;
                     readonly domain: import("@elaraai/east").FunctionType<[import("@elaraai/east").StringType], OptionType<StructType<{
@@ -824,6 +1061,12 @@ export declare const CalendarPayloadType: StructType<{
                             readonly to: import("@elaraai/east").StringType;
                         }>;
                         readonly prefix: import("@elaraai/east").StringType;
+                        readonly window: StructType<{
+                            readonly minX: import("@elaraai/east").FloatType;
+                            readonly minY: import("@elaraai/east").FloatType;
+                            readonly maxX: import("@elaraai/east").FloatType;
+                            readonly maxY: import("@elaraai/east").FloatType;
+                        }>;
                     }>>, import("@elaraai/east").StringType], OptionType<import("@elaraai/east").BooleanType>>;
                     readonly containsRow: import("@elaraai/east").FunctionType<[import("@elaraai/east").DictType<import("@elaraai/east").StringType, VariantType<{
                         readonly values: ArrayType<import("@elaraai/east").StringType>;
@@ -832,6 +1075,12 @@ export declare const CalendarPayloadType: StructType<{
                             readonly to: import("@elaraai/east").StringType;
                         }>;
                         readonly prefix: import("@elaraai/east").StringType;
+                        readonly window: StructType<{
+                            readonly minX: import("@elaraai/east").FloatType;
+                            readonly minY: import("@elaraai/east").FloatType;
+                            readonly maxX: import("@elaraai/east").FloatType;
+                            readonly maxY: import("@elaraai/east").FloatType;
+                        }>;
                     }>>, import("@elaraai/east").StringType, import("@elaraai/east").BlobType], OptionType<import("@elaraai/east").BooleanType>>;
                 }>;
             }>>;
@@ -872,6 +1121,9 @@ export declare const CalendarPayloadType: StructType<{
             readonly key: StringType;
         }>>;
     }>], OptionType<StringType>>>;
+    readonly optimise: OptionType<StructType<{
+        readonly name: StringType;
+    }>>;
     readonly onSelect: OptionType<FunctionType<[StructType<{
         readonly kind: StringType;
         readonly key: StringType;
@@ -1001,7 +1253,7 @@ export declare const CalendarComponent: import("@elaraai/east-ui").UIComponentDe
                 readonly readonly: NullType;
             }>;
         }>>;
-        readonly items: FunctionType<[DateTimeType, DateTimeType, DictType<StringType, import("@elaraai/east").BlobType>], OptionType<ArrayType<StructType<{
+        readonly items: FunctionType<[DateTimeType, DateTimeType, DictType<StringType, import("@elaraai/east").BlobType>, OptionType<import("@elaraai/east").BlobType>], OptionType<ArrayType<StructType<{
             readonly kind: StringType;
             readonly key: StringType;
             readonly title: StringType;
@@ -1025,7 +1277,7 @@ export declare const CalendarComponent: import("@elaraai/east-ui").UIComponentDe
             readonly minutes: IntegerType;
             readonly due: OptionType<DateTimeType>;
         }>>>>;
-        readonly unscheduled: FunctionType<[DateTimeType, DateTimeType, DictType<StringType, import("@elaraai/east").BlobType>], OptionType<ArrayType<StructType<{
+        readonly unscheduled: FunctionType<[DateTimeType, DateTimeType, DictType<StringType, import("@elaraai/east").BlobType>, OptionType<import("@elaraai/east").BlobType>], OptionType<ArrayType<StructType<{
             readonly kind: StringType;
             readonly key: StringType;
             readonly title: StringType;
@@ -1280,7 +1532,7 @@ export declare const CalendarComponent: import("@elaraai/east-ui").UIComponentDe
             readonly at: DateTimeType;
             readonly delta: OptionType<StringType>;
         }>>>>;
-        readonly event: FunctionType<[StringType, DictType<StringType, import("@elaraai/east").BlobType>, DateTimeType, DateTimeType], OptionType<StructType<{
+        readonly event: FunctionType<[StringType, DictType<StringType, import("@elaraai/east").BlobType>, DateTimeType, DateTimeType, OptionType<OptionType<import("@elaraai/east").BlobType>>], OptionType<StructType<{
             readonly item: StructType<{
                 readonly kind: StringType;
                 readonly key: StringType;
@@ -1319,6 +1571,54 @@ export declare const CalendarComponent: import("@elaraai/east-ui").UIComponentDe
             readonly allow: NullType;
         }>;
         readonly inspector: OptionType<FunctionType<[import("@elaraai/east").BlobType, FunctionType<[import("@elaraai/east").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 resources: ArrayType<StructType<{
         readonly key: StringType;
@@ -1329,6 +1629,131 @@ export declare const CalendarComponent: import("@elaraai/east-ui").UIComponentDe
             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<[], import("@elaraai/east").BlobType>>;
+    }>>;
+    readonly paged: OptionType<StructType<{
+        readonly kind: StringType;
+        readonly id: StringType;
+        readonly rows: FunctionType<[IntegerType, IntegerType], OptionType<ArrayType<StructType<{
+            readonly key: StringType;
+            readonly label: StringType;
+            readonly meta: OptionType<StringType>;
+        }>>>>;
+        readonly keys: FunctionType<[IntegerType, IntegerType], OptionType<ArrayType<StringType>>>;
+        readonly total: FunctionType<[], OptionType<IntegerType>>;
+        readonly revision: FunctionType<[], OptionType<StringType>>;
+        readonly refresh: FunctionType<[OptionType<StringType>], NullType>;
+        readonly query: OptionType<FunctionType<[], StringType>>;
+        readonly seek: OptionType<FunctionType<[VariantType<{
+            readonly key: StringType;
+            readonly prefix: StringType;
+            readonly fields: StructType<{
+                readonly values: ArrayType<StringType>;
+                readonly prefix: OptionType<StringType>;
+            }>;
+            readonly range: StructType<{
+                readonly from: ArrayType<StringType>;
+                readonly to: ArrayType<StringType>;
+            }>;
+        }>], OptionType<StructType<{
+            readonly found: BooleanType;
+            readonly row: IntegerType;
+            readonly count: IntegerType;
+        }>>>>;
+        readonly entries: FunctionType<[IntegerType, IntegerType], OptionType<ArrayType<StructType<{
+            readonly key: StringType;
+            readonly label: StringType;
+            readonly meta: OptionType<StringType>;
+        }>>>>;
+        readonly byKey: FunctionType<[StringType], OptionType<OptionType<StructType<{
+            readonly key: StringType;
+            readonly label: StringType;
+            readonly meta: OptionType<StringType>;
+        }>>>>;
     }>>;
     readonly settings: StructType<{
         readonly layout: VariantType<{
@@ -1499,6 +1924,39 @@ export declare const CalendarComponent: import("@elaraai/east-ui").UIComponentDe
                                 readonly to: import("@elaraai/east").StringType;
                                 readonly optional: import("@elaraai/east").BooleanType;
                             }>>;
+                            readonly area: OptionType<StructType<{
+                                readonly x: import("@elaraai/east").StringType;
+                                readonly y: import("@elaraai/east").StringType;
+                                readonly width: OptionType<import("@elaraai/east").StringType>;
+                                readonly height: OptionType<import("@elaraai/east").StringType>;
+                                readonly centre: import("@elaraai/east").BooleanType;
+                                readonly cell: import("@elaraai/east").FloatType;
+                                readonly optional: import("@elaraai/east").BooleanType;
+                            }>>;
+                            readonly series: OptionType<StructType<{
+                                readonly key: import("@elaraai/east").StringType;
+                                readonly from: import("@elaraai/east").StringType;
+                                readonly to: import("@elaraai/east").StringType;
+                                readonly tile: VariantType<{
+                                    readonly day: NullType;
+                                    readonly week: NullType;
+                                    readonly month: NullType;
+                                    readonly quarter: NullType;
+                                    readonly year: NullType;
+                                }>;
+                            }>>;
+                            readonly summary: OptionType<StructType<{
+                                readonly key: import("@elaraai/east").StringType;
+                                readonly from: import("@elaraai/east").StringType;
+                                readonly to: import("@elaraai/east").StringType;
+                                readonly tile: VariantType<{
+                                    readonly day: NullType;
+                                    readonly week: NullType;
+                                    readonly month: NullType;
+                                    readonly quarter: NullType;
+                                    readonly year: NullType;
+                                }>;
+                            }>>;
                         }>>;
                         readonly range: OptionType<import("@elaraai/east").StringType>;
                         readonly search: ArrayType<import("@elaraai/east").StringType>;
@@ -1512,6 +1970,12 @@ export declare const CalendarComponent: import("@elaraai/east-ui").UIComponentDe
                                     readonly to: import("@elaraai/east").StringType;
                                 }>;
                                 readonly prefix: import("@elaraai/east").StringType;
+                                readonly window: StructType<{
+                                    readonly minX: import("@elaraai/east").FloatType;
+                                    readonly minY: import("@elaraai/east").FloatType;
+                                    readonly maxX: import("@elaraai/east").FloatType;
+                                    readonly maxY: import("@elaraai/east").FloatType;
+                                }>;
                             }>>;
                         }>>;
                     }>;
@@ -1523,6 +1987,12 @@ export declare const CalendarComponent: import("@elaraai/east-ui").UIComponentDe
                                 readonly to: import("@elaraai/east").StringType;
                             }>;
                             readonly prefix: import("@elaraai/east").StringType;
+                            readonly window: StructType<{
+                                readonly minX: import("@elaraai/east").FloatType;
+                                readonly minY: import("@elaraai/east").FloatType;
+                                readonly maxX: import("@elaraai/east").FloatType;
+                                readonly maxY: import("@elaraai/east").FloatType;
+                            }>;
                         }>>;
                         readonly preset: OptionType<import("@elaraai/east").StringType>;
                         readonly resolution: OptionType<VariantType<{
@@ -1543,6 +2013,12 @@ export declare const CalendarComponent: import("@elaraai/east-ui").UIComponentDe
                                 readonly to: import("@elaraai/east").StringType;
                             }>;
                             readonly prefix: import("@elaraai/east").StringType;
+                            readonly window: StructType<{
+                                readonly minX: import("@elaraai/east").FloatType;
+                                readonly minY: import("@elaraai/east").FloatType;
+                                readonly maxX: import("@elaraai/east").FloatType;
+                                readonly maxY: import("@elaraai/east").FloatType;
+                            }>;
                         }>>;
                         readonly preset: OptionType<import("@elaraai/east").StringType>;
                         readonly resolution: OptionType<VariantType<{
@@ -1568,6 +2044,12 @@ export declare const CalendarComponent: import("@elaraai/east-ui").UIComponentDe
                             readonly to: import("@elaraai/east").StringType;
                         }>;
                         readonly prefix: import("@elaraai/east").StringType;
+                        readonly window: StructType<{
+                            readonly minX: import("@elaraai/east").FloatType;
+                            readonly minY: import("@elaraai/east").FloatType;
+                            readonly maxX: import("@elaraai/east").FloatType;
+                            readonly maxY: import("@elaraai/east").FloatType;
+                        }>;
                     }>>], OptionType<import("@elaraai/east").IntegerType>>;
                     readonly total: import("@elaraai/east").FunctionType<[], OptionType<import("@elaraai/east").IntegerType>>;
                     readonly domain: import("@elaraai/east").FunctionType<[import("@elaraai/east").StringType], OptionType<StructType<{
@@ -1609,6 +2091,12 @@ export declare const CalendarComponent: import("@elaraai/east-ui").UIComponentDe
                             readonly to: import("@elaraai/east").StringType;
                         }>;
                         readonly prefix: import("@elaraai/east").StringType;
+                        readonly window: StructType<{
+                            readonly minX: import("@elaraai/east").FloatType;
+                            readonly minY: import("@elaraai/east").FloatType;
+                            readonly maxX: import("@elaraai/east").FloatType;
+                            readonly maxY: import("@elaraai/east").FloatType;
+                        }>;
                     }>>, import("@elaraai/east").StringType], OptionType<import("@elaraai/east").BooleanType>>;
                     readonly containsRow: import("@elaraai/east").FunctionType<[import("@elaraai/east").DictType<import("@elaraai/east").StringType, VariantType<{
                         readonly values: ArrayType<import("@elaraai/east").StringType>;
@@ -1617,6 +2105,12 @@ export declare const CalendarComponent: import("@elaraai/east-ui").UIComponentDe
                             readonly to: import("@elaraai/east").StringType;
                         }>;
                         readonly prefix: import("@elaraai/east").StringType;
+                        readonly window: StructType<{
+                            readonly minX: import("@elaraai/east").FloatType;
+                            readonly minY: import("@elaraai/east").FloatType;
+                            readonly maxX: import("@elaraai/east").FloatType;
+                            readonly maxY: import("@elaraai/east").FloatType;
+                        }>;
                     }>>, import("@elaraai/east").StringType, import("@elaraai/east").BlobType], OptionType<import("@elaraai/east").BooleanType>>;
                 }>;
             }>>;
@@ -1657,6 +2151,9 @@ export declare const CalendarComponent: import("@elaraai/east-ui").UIComponentDe
             readonly key: StringType;
         }>>;
     }>], OptionType<StringType>>>;
+    readonly optimise: OptionType<StructType<{
+        readonly name: StringType;
+    }>>;
     readonly onSelect: OptionType<FunctionType<[StructType<{
         readonly kind: StringType;
         readonly key: StringType;
@@ -1682,15 +2179,23 @@ declare function authorTab<K extends EastType, R extends EastType, P extends Eas
 export interface CalendarProps {
     /** Event kinds, each bound to its own record and patch mutation. */
     events: Readonly<Record<string, ScheduleEventKind<EastType, EastType>>>;
-    /** Resource kinds read from keyed data, commonly bound records. */
+    /**
+     * Resource kinds read from keyed data, commonly bound records — or one of them a paged read of its record
+     * (`Calendar.resources(Data.bindPaged(record), { … })`, #1424): its resources come a window at a time, the timeline's
+     * rows and the Resources view's columns the windows around the view, its Choosers searching it by key. An event kind
+     * placed on it is read a cell at a time: its source of the slice lists a series index and a summary index of its
+     * record (`e3.recordIndex.series`, `e3.recordIndex.summary`, filed by its resource field over its own times) beside
+     * its interval index, or it is refused.
+     */
     resources?: Readonly<Record<string, ScheduleResourceKind<EastType, EastType>>>;
     /**
      * The narrowing: `Slice.bindRecords(key, { … })`, one rail, a source per record it narrows (#1343). A source named
      * after an event kind's slot (`job`) narrows that kind's events in every layout, its backlog and its choices,
      * through its interval index — its `range` the kind's start field, which the Calendar's navigation writes in
      * every event source at once — and the kind gives `entries` beside it. A source named after a resource kind's slot
-     * (`machines`) narrows its columns, rows and choices. A source a templates list or a tab names narrows its cards.
-     * Overlaps and checks read every event. Omitted, no Slice controls.
+     * (`machines`) narrows its columns, rows and choices — a paged kind's windows are its narrowed rows themselves,
+     * `Data.bindPaged(record, { indexes })` over the kind's own record, in its index's order (#1424). A source a templates
+     * list or a tab names narrows its cards. Overlaps and checks read every event. Omitted, no Slice controls.
      */
     slice?: RecordSlicesChromeOptions;
     /** The library's tabs, in order; omitted or empty, no start pane. */
@@ -1721,6 +2226,16 @@ export interface CalendarProps {
     now?: SubtypeExprOrValue<DateTimeType>;
     /** Refuses a candidate placement with a message; none permits it. */
     canDrop?: SubtypeExprOrValue<FunctionType<[typeof ScheduleCandidateType], OptionType<StringType>>>;
+    /**
+     * The app's optimiser (#1409): `Func.bind` of its `e3.function` from `Calendar.Types.OptimiseRequest(E, S)` — the window in
+     * view, the run number, every event kind's rows in the window and its backlog by slot and by key, and the resource kinds'
+     * rows as context — to `Calendar.Types.OptimiseResult(E)`, the events complete. `E` and `S` are the kinds' row types by slot
+     * (`Calendar.Types.OptimiseRequest({ job: Job }, { machines: Machine })`); a kind keyed otherwise than by String gives its
+     * record type, `DictType(K, R)`. The Elara eye in the toolbar calls it once per run; the result lands in the session as one
+     * edit, which one Undo reverts and Save commits with everything else. Omitted, no eye. The tag cannot see its kinds' row
+     * types in TypeScript, so it checks the handle at build, and refuses one over other rows naming both.
+     */
+    optimise?: OptimiseHandle;
     /** Observes each selected event's kind and record key. */
     onSelect?: SubtypeExprOrValue<FunctionType<[typeof ScheduleEventRefType], NullType>>;
     /** Keeps this calendar's view, library, panes and editing history distinct. */
@@ -1734,7 +2249,15 @@ export interface CalendarProps {
  * @throws {Error} When kinds or library tabs are invalid, a kind has no `title` (#1367), working hours are outside the
  *   day, `slice` is not `Slice.bindRecords` or names a source no kind, templates list or tab names, a templates list is
  *   written in the code or names no source of the slice (templates are records, #1340), or a tab names a source the
- *   slice lacks
+ *   slice lacks, or `optimise` is not `Func.bind` of a function from `OptimiseRequest(E, S)` to `OptimiseResult(E)` over
+ *   the kinds' rows (#1409); more than one resource kind is paged, or an event kind is placed on the paged kind and on
+ *   another, or with no source of the slice — its record read whole, or the days in view read through its day index —
+ *   each naming the series and summary indexes to declare over the kind's own fields (#1424). The series and summary
+ *   indexes an event kind's source lists are refused in the same words as the Calendar is evaluated, the source's
+ *   indexes read only then: one filed by another field than the kind's resource, or over other times than its events';
+ *   a series index for a kind not placed on the paged kind alone; two series, or two summaries, by one tile over the
+ *   same fields; a series index with no summary beside it; and, for a kind on the paged kind, a source listing no
+ *   series index
  * @internal
  */
 export declare function createCalendarPayload(props: CalendarProps): ExprType<typeof CalendarPayloadType>;
@@ -1748,11 +2271,15 @@ export interface CalendarNamespace extends Omit<ScheduleNamespace, "Types"> {
         backlog: typeof backlogTab;
         tab: typeof authorTab;
     };
-    /** Shared schedule types and Calendar's view state. */
+    /** Shared schedule types, Calendar's view state, and the optimiser's request and answer over its kinds (#1409). */
     Types: ScheduleNamespace["Types"] & {
         Layout: typeof CalendarLayoutType;
         Period: typeof CalendarPeriodType;
         View: typeof CalendarViewType;
+        /** `OptimiseRequest(E, S)` — what the app's optimiser is asked: the window, the run, every event kind's rows and the resource kinds' by slot. */
+        OptimiseRequest: typeof ScheduleOptimiseRequestTypeFor;
+        /** `OptimiseResult(E)` — what it answers: the events, complete. */
+        OptimiseResult: typeof ScheduleOptimiseResultTypeFor;
     };
 }
 /**
@@ -1790,5 +2317,4 @@ export interface CalendarNamespace extends Omit<ScheduleNamespace, "Types"> {
  * ```
  */
 export declare const Calendar: CalendarNamespace;
-export {};
 //# sourceMappingURL=index.d.ts.map