@elaraai/e3-ui 1.0.97 → 1.0.99

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

@@ -9,7 +9,8 @@
  * and agencies (`Schedule.resources`), publishes its weeks
  * (`Schedule.periods`) and writes its targets (`Roster.targets`), with the
  * lists it reads over the app's rows (`Roster.shifts`, `groups`, `positions`,
- * `activities`, `proposals`). It stores nothing in a shape of its own.
+ * `activities`, `proposals`, and the People layout's `patterns`, #1406). It
+ * stores nothing in a shape of its own.
  *
  * The tag validates, builds the people and agencies from their kinds'
  * accessors, and assembles the closed payload; it composes no East UI
@@ -32,25 +33,40 @@ import type { ScheduleResourceKind } from "../schedule/resources.js";
 import { ScheduleClockType } from "../schedule/types.js";
 import { rosterCoverage, rosterWeekHours } from "./coverage.js";
 import { rosterAnswer, rosterFit } from "./fit.js";
-import { rosterActivitiesTab, rosterLibraryTab, rosterPeopleTab, type RosterLibraryTab } from "./library.js";
-import { rosterActivities, rosterGroups, rosterPositions, rosterProposals, rosterShifts, type RosterGroups, type RosterPositions, type RosterProposals, type RosterShifts } from "./lists.js";
+import { rosterActivitiesTab, rosterLibraryTab, rosterPatternsTab, rosterPeopleTab, type RosterLibraryTab } from "./library.js";
+import { rosterActivities, rosterGroups, rosterPatterns, rosterPositions, rosterProposals, rosterShifts, type RosterGroups, type RosterPatterns, type RosterPositions, type RosterProposals, type RosterShifts } from "./lists.js";
 import { rosterCheck, rosterRest } from "./rules.js";
 import { rosterTargets, type RosterTargets } from "./targets.js";
 import * as T from "./types.js";
-/** Roster's layout: group shifts, or people across the week. */
+/** Roster's layout: group shifts, or people across the week or the month. */
 export declare const RosterLayoutType: VariantType<{
     readonly shifts: NullType;
     readonly people: NullType;
 }>;
-/** Roster's displayed period. People always shows the whole week. */
+/** Roster's displayed period: Shifts shows a day or a week, People a week or a month (#1406); each layout keeps its own. */
 export declare const RosterPeriodType: VariantType<{
     readonly day: NullType;
     readonly week: NullType;
+    readonly month: NullType;
 }>;
-/** A declared library tab: the People tab, the Activities tab, or an app's tab, its cards resolved over the duty kind. */
+/** The periods each layout takes, in the Period segment's order. */
+export declare const ROSTER_LAYOUT_PERIODS: Readonly<Record<"shifts" | "people", readonly ("day" | "week" | "month")[]>>;
+/** Whether a People tile shows the shift's hours always, or only a duty's own times where they differ from the shift's (#1406). */
+export declare const RosterTileTimesType: VariantType<{
+    readonly always: NullType;
+    readonly different: NullType;
+}>;
+/**
+ * A declared library tab: the People tab, the Activities tab, the Patterns tab — the app's week patterns under the name
+ * and icon `Roster.patterns` gives (#1406) — or an app's tab, its cards resolved over the duty kind.
+ */
 export declare const RosterLibraryTabType: VariantType<{
     readonly people: NullType;
     readonly activities: NullType;
+    readonly patterns: StructType<{
+        readonly name: StringType;
+        readonly icon: StringType;
+    }>;
     readonly tab: StructType<{
         readonly name: StringType;
         readonly icon: OptionType<StringType>;
@@ -76,20 +92,22 @@ export declare const RosterLibraryTabType: VariantType<{
  * @property periods - The app's weeks: their status and dismissals, and Publish; `none`, no Publish
  * @property targets - The app's targets, a row per slot; `none`, no slot has a target
  * @property groups - The groups, in their order
- * @property shifts - The shifts, in their order
+ * @property shifts - The shifts, in their order, each with its colour token, or none (#1406)
  * @property activities - Every activity: each group's skills and the duties of no group
  * @property positions - The positions, in their order; none for a duty kind with no `position` role
  * @property proposals - The app's suggestions, in key order
+ * @property patterns - The app's week patterns, in their order (#1406); none without `patterns`
  * @property rules - The built-in rules
  * @property pay - The app's pay, from a `PayRequest(R)` as bytes to each duty's cost by code; `none`, no costs show
  * @property currency - How costs print
  * @property check - The app's issues, from a `CheckContext(R)` as bytes
  * @property fit - The app's fit, by its `e3.function`'s name: who fits a Find fix's need; `none`, no Find fix is offered (#1334)
+ * @property optimise - The app's optimiser, by its `e3.function`'s name: what the Elara eye calls over the week in view, its result one edit of the session; `none`, no eye (#1409)
  * @property library - The library's tabs, in order
  * @property inspector - Whether the inspector pane shows
- * @property narrowed - Each narrowed source's keys, paged through its part of `slice`: the people and the activities that show (#1342)
+ * @property narrowed - Each narrowed source's keys, paged through its part of `slice`: the people, the activities and the patterns that show (#1342)
  * @property slice - The narrowing's chrome: a Slice over the duties', the targets', the staff's and the activities' records, one rail
- * @property settings - The first view and the view settings
+ * @property settings - The first view and the view settings: the layout, its period, the date, the week's start, the density, the chip skills, the requirement rows, read-only, and the People layout's `tileTimes` and `letters` (#1406)
  * @property id - The viewer's identity
  */
 export declare const RosterPayloadType: StructType<{
@@ -215,7 +233,7 @@ export declare const RosterPayloadType: StructType<{
                     readonly readonly: NullType;
                 }>;
             }>>;
-            readonly items: FunctionType<[DateTimeType, DateTimeType, import("@elaraai/east").DictType<StringType, BlobType>], OptionType<ArrayType<StructType<{
+            readonly items: FunctionType<[DateTimeType, DateTimeType, import("@elaraai/east").DictType<StringType, BlobType>, OptionType<BlobType>], OptionType<ArrayType<StructType<{
                 readonly kind: StringType;
                 readonly key: StringType;
                 readonly title: StringType;
@@ -239,7 +257,7 @@ export declare const RosterPayloadType: StructType<{
                 readonly minutes: import("@elaraai/east").IntegerType;
                 readonly due: OptionType<DateTimeType>;
             }>>>>;
-            readonly unscheduled: FunctionType<[DateTimeType, DateTimeType, import("@elaraai/east").DictType<StringType, BlobType>], OptionType<ArrayType<StructType<{
+            readonly unscheduled: FunctionType<[DateTimeType, DateTimeType, import("@elaraai/east").DictType<StringType, BlobType>, OptionType<BlobType>], OptionType<ArrayType<StructType<{
                 readonly kind: StringType;
                 readonly key: StringType;
                 readonly title: StringType;
@@ -494,7 +512,7 @@ export declare const RosterPayloadType: StructType<{
                 readonly at: DateTimeType;
                 readonly delta: OptionType<StringType>;
             }>>>>;
-            readonly event: FunctionType<[StringType, import("@elaraai/east").DictType<StringType, BlobType>, DateTimeType, DateTimeType], OptionType<StructType<{
+            readonly event: FunctionType<[StringType, import("@elaraai/east").DictType<StringType, BlobType>, DateTimeType, DateTimeType, OptionType<OptionType<BlobType>>], OptionType<StructType<{
                 readonly item: StructType<{
                     readonly kind: StringType;
                     readonly key: StringType;
@@ -527,12 +545,63 @@ export declare const RosterPayloadType: StructType<{
                 readonly end: StringType;
                 readonly resource: OptionType<StringType>;
                 readonly status: OptionType<StringType>;
+                readonly quantity: OptionType<StringType>;
+                readonly parts: OptionType<StringType>;
+                readonly withTimes: ArrayType<StringType>;
             }>;
             readonly overlaps: VariantType<{
                 readonly warn: NullType;
                 readonly allow: NullType;
             }>;
             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: import("@elaraai/east").IntegerType;
+                    readonly wrapper: StructType<{
+                        readonly id: import("@elaraai/east").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<import("@elaraai/east").IntegerType>>;
+            readonly countExact: BooleanType;
         }>;
         readonly rows: FunctionType<[DateTimeType, DateTimeType], OptionType<import("@elaraai/east").DictType<StringType, StructType<{
             readonly roles: StructType<{
@@ -1179,6 +1248,140 @@ export declare const RosterPayloadType: StructType<{
             readonly minute: import("@elaraai/east").IntegerType;
         }>;
         readonly hours: import("@elaraai/east").FloatType;
+        readonly color: OptionType<VariantType<{
+            readonly brand: VariantType<{
+                readonly "50": NullType;
+                readonly "100": NullType;
+                readonly "200": NullType;
+                readonly "300": NullType;
+                readonly "400": NullType;
+                readonly "500": NullType;
+                readonly "600": NullType;
+                readonly "700": NullType;
+                readonly "800": NullType;
+                readonly "900": NullType;
+            }>;
+            readonly gray: VariantType<{
+                readonly "50": NullType;
+                readonly "100": NullType;
+                readonly "200": NullType;
+                readonly "300": NullType;
+                readonly "400": NullType;
+                readonly "500": NullType;
+                readonly "600": NullType;
+                readonly "700": NullType;
+                readonly "800": NullType;
+                readonly "900": NullType;
+            }>;
+            readonly red: VariantType<{
+                readonly "50": NullType;
+                readonly "100": NullType;
+                readonly "200": NullType;
+                readonly "300": NullType;
+                readonly "400": NullType;
+                readonly "500": NullType;
+                readonly "600": NullType;
+                readonly "700": NullType;
+                readonly "800": NullType;
+                readonly "900": NullType;
+            }>;
+            readonly orange: VariantType<{
+                readonly "50": NullType;
+                readonly "100": NullType;
+                readonly "200": NullType;
+                readonly "300": NullType;
+                readonly "400": NullType;
+                readonly "500": NullType;
+                readonly "600": NullType;
+                readonly "700": NullType;
+                readonly "800": NullType;
+                readonly "900": NullType;
+            }>;
+            readonly yellow: VariantType<{
+                readonly "50": NullType;
+                readonly "100": NullType;
+                readonly "200": NullType;
+                readonly "300": NullType;
+                readonly "400": NullType;
+                readonly "500": NullType;
+                readonly "600": NullType;
+                readonly "700": NullType;
+                readonly "800": NullType;
+                readonly "900": NullType;
+            }>;
+            readonly green: VariantType<{
+                readonly "50": NullType;
+                readonly "100": NullType;
+                readonly "200": NullType;
+                readonly "300": NullType;
+                readonly "400": NullType;
+                readonly "500": NullType;
+                readonly "600": NullType;
+                readonly "700": NullType;
+                readonly "800": NullType;
+                readonly "900": NullType;
+            }>;
+            readonly teal: VariantType<{
+                readonly "50": NullType;
+                readonly "100": NullType;
+                readonly "200": NullType;
+                readonly "300": NullType;
+                readonly "400": NullType;
+                readonly "500": NullType;
+                readonly "600": NullType;
+                readonly "700": NullType;
+                readonly "800": NullType;
+                readonly "900": NullType;
+            }>;
+            readonly blue: VariantType<{
+                readonly "50": NullType;
+                readonly "100": NullType;
+                readonly "200": NullType;
+                readonly "300": NullType;
+                readonly "400": NullType;
+                readonly "500": NullType;
+                readonly "600": NullType;
+                readonly "700": NullType;
+                readonly "800": NullType;
+                readonly "900": NullType;
+            }>;
+            readonly cyan: VariantType<{
+                readonly "50": NullType;
+                readonly "100": NullType;
+                readonly "200": NullType;
+                readonly "300": NullType;
+                readonly "400": NullType;
+                readonly "500": NullType;
+                readonly "600": NullType;
+                readonly "700": NullType;
+                readonly "800": NullType;
+                readonly "900": NullType;
+            }>;
+            readonly purple: VariantType<{
+                readonly "50": NullType;
+                readonly "100": NullType;
+                readonly "200": NullType;
+                readonly "300": NullType;
+                readonly "400": NullType;
+                readonly "500": NullType;
+                readonly "600": NullType;
+                readonly "700": NullType;
+                readonly "800": NullType;
+                readonly "900": NullType;
+            }>;
+            readonly pink: VariantType<{
+                readonly "50": NullType;
+                readonly "100": NullType;
+                readonly "200": NullType;
+                readonly "300": NullType;
+                readonly "400": NullType;
+                readonly "500": NullType;
+                readonly "600": NullType;
+                readonly "700": NullType;
+                readonly "800": NullType;
+                readonly "900": NullType;
+            }>;
+        }>>;
     }>>;
     readonly activities: ArrayType<StructType<{
         readonly key: StringType;
@@ -1200,6 +1403,11 @@ export declare const RosterPayloadType: StructType<{
         readonly person: StringType;
         readonly reason: StringType;
     }>>;
+    readonly patterns: ArrayType<StructType<{
+        readonly key: StringType;
+        readonly label: StringType;
+        readonly days: ArrayType<OptionType<StringType>>;
+    }>>;
     readonly rules: StructType<{
         readonly rest: import("@elaraai/east").FloatType;
         readonly lead: BooleanType;
@@ -1245,9 +1453,16 @@ export declare const RosterPayloadType: StructType<{
     readonly fit: OptionType<StructType<{
         readonly name: StringType;
     }>>;
+    readonly optimise: OptionType<StructType<{
+        readonly name: StringType;
+    }>>;
     readonly library: ArrayType<VariantType<{
         readonly people: NullType;
         readonly activities: NullType;
+        readonly patterns: StructType<{
+            readonly name: StringType;
+            readonly icon: StringType;
+        }>;
         readonly tab: StructType<{
             readonly name: StringType;
             readonly icon: OptionType<StringType>;
@@ -1269,6 +1484,7 @@ export declare const RosterPayloadType: StructType<{
     readonly narrowed: StructType<{
         readonly people: OptionType<RowSourceType<ArrayType<StringType>>>;
         readonly activities: OptionType<RowSourceType<ArrayType<StringType>>>;
+        readonly patterns: OptionType<RowSourceType<ArrayType<StringType>>>;
     }>;
     readonly slice: OptionType<StructType<{
         readonly slice: StructType<{
@@ -1389,6 +1605,39 @@ export declare const RosterPayloadType: 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>;
@@ -1451,14 +1700,25 @@ export declare const RosterPayloadType: StructType<{
                     readonly clear: import("@elaraai/east").FunctionType<[import("@elaraai/east").StringType], NullType>;
                     readonly clearAll: import("@elaraai/east").FunctionType<[], NullType>;
                     readonly count: import("@elaraai/east").FunctionType<[], OptionType<import("@elaraai/east").IntegerType>>;
-                    readonly countWhere: import("@elaraai/east").FunctionType<[import("@elaraai/east").DictType<import("@elaraai/east").StringType, VariantType<{
-                        readonly values: ArrayType<import("@elaraai/east").StringType>;
-                        readonly range: StructType<{
-                            readonly from: import("@elaraai/east").StringType;
-                            readonly to: import("@elaraai/east").StringType;
-                        }>;
-                        readonly prefix: import("@elaraai/east").StringType;
-                    }>>], OptionType<import("@elaraai/east").IntegerType>>;
+                    readonly countWhere: import("@elaraai/east").FunctionType<[StructType<{
+                        readonly where: import("@elaraai/east").DictType<import("@elaraai/east").StringType, VariantType<{
+                            readonly values: ArrayType<import("@elaraai/east").StringType>;
+                            readonly range: StructType<{
+                                readonly from: import("@elaraai/east").StringType;
+                                readonly to: import("@elaraai/east").StringType;
+                            }>;
+                            readonly prefix: import("@elaraai/east").StringType;
+                        }>>;
+                        readonly area: OptionType<VariantType<{
+                            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 unplaced: NullType;
+                        }>>;
+                    }>], 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<{
                         readonly from: import("@elaraai/east").StringType;
@@ -1540,6 +1800,7 @@ export declare const RosterPayloadType: StructType<{
         readonly period: VariantType<{
             readonly day: NullType;
             readonly week: NullType;
+            readonly month: NullType;
         }>;
         readonly date: OptionType<DateTimeType>;
         readonly weekStart: VariantType<{
@@ -1553,6 +1814,11 @@ export declare const RosterPayloadType: StructType<{
         readonly chipSkills: BooleanType;
         readonly requirements: BooleanType;
         readonly readOnly: BooleanType;
+        readonly tileTimes: VariantType<{
+            readonly always: NullType;
+            readonly different: NullType;
+        }>;
+        readonly letters: BooleanType;
     }>;
     readonly id: OptionType<StringType>;
 }>;
@@ -1680,7 +1946,7 @@ export declare const RosterComponent: import("@elaraai/east-ui").UIComponentDef<
                     readonly readonly: NullType;
                 }>;
             }>>;
-            readonly items: FunctionType<[DateTimeType, DateTimeType, import("@elaraai/east").DictType<StringType, BlobType>], OptionType<ArrayType<StructType<{
+            readonly items: FunctionType<[DateTimeType, DateTimeType, import("@elaraai/east").DictType<StringType, BlobType>, OptionType<BlobType>], OptionType<ArrayType<StructType<{
                 readonly kind: StringType;
                 readonly key: StringType;
                 readonly title: StringType;
@@ -1704,7 +1970,7 @@ export declare const RosterComponent: import("@elaraai/east-ui").UIComponentDef<
                 readonly minutes: import("@elaraai/east").IntegerType;
                 readonly due: OptionType<DateTimeType>;
             }>>>>;
-            readonly unscheduled: FunctionType<[DateTimeType, DateTimeType, import("@elaraai/east").DictType<StringType, BlobType>], OptionType<ArrayType<StructType<{
+            readonly unscheduled: FunctionType<[DateTimeType, DateTimeType, import("@elaraai/east").DictType<StringType, BlobType>, OptionType<BlobType>], OptionType<ArrayType<StructType<{
                 readonly kind: StringType;
                 readonly key: StringType;
                 readonly title: StringType;
@@ -1959,7 +2225,7 @@ export declare const RosterComponent: import("@elaraai/east-ui").UIComponentDef<
                 readonly at: DateTimeType;
                 readonly delta: OptionType<StringType>;
             }>>>>;
-            readonly event: FunctionType<[StringType, import("@elaraai/east").DictType<StringType, BlobType>, DateTimeType, DateTimeType], OptionType<StructType<{
+            readonly event: FunctionType<[StringType, import("@elaraai/east").DictType<StringType, BlobType>, DateTimeType, DateTimeType, OptionType<OptionType<BlobType>>], OptionType<StructType<{
                 readonly item: StructType<{
                     readonly kind: StringType;
                     readonly key: StringType;
@@ -1992,12 +2258,63 @@ export declare const RosterComponent: import("@elaraai/east-ui").UIComponentDef<
                 readonly end: StringType;
                 readonly resource: OptionType<StringType>;
                 readonly status: OptionType<StringType>;
+                readonly quantity: OptionType<StringType>;
+                readonly parts: OptionType<StringType>;
+                readonly withTimes: ArrayType<StringType>;
             }>;
             readonly overlaps: VariantType<{
                 readonly warn: NullType;
                 readonly allow: NullType;
             }>;
             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: import("@elaraai/east").IntegerType;
+                    readonly wrapper: StructType<{
+                        readonly id: import("@elaraai/east").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<import("@elaraai/east").IntegerType>>;
+            readonly countExact: BooleanType;
         }>;
         readonly rows: FunctionType<[DateTimeType, DateTimeType], OptionType<import("@elaraai/east").DictType<StringType, StructType<{
             readonly roles: StructType<{
@@ -2644,6 +2961,140 @@ export declare const RosterComponent: import("@elaraai/east-ui").UIComponentDef<
             readonly minute: import("@elaraai/east").IntegerType;
         }>;
         readonly hours: import("@elaraai/east").FloatType;
+        readonly color: OptionType<VariantType<{
+            readonly brand: VariantType<{
+                readonly "50": NullType;
+                readonly "100": NullType;
+                readonly "200": NullType;
+                readonly "300": NullType;
+                readonly "400": NullType;
+                readonly "500": NullType;
+                readonly "600": NullType;
+                readonly "700": NullType;
+                readonly "800": NullType;
+                readonly "900": NullType;
+            }>;
+            readonly gray: VariantType<{
+                readonly "50": NullType;
+                readonly "100": NullType;
+                readonly "200": NullType;
+                readonly "300": NullType;
+                readonly "400": NullType;
+                readonly "500": NullType;
+                readonly "600": NullType;
+                readonly "700": NullType;
+                readonly "800": NullType;
+                readonly "900": NullType;
+            }>;
+            readonly red: VariantType<{
+                readonly "50": NullType;
+                readonly "100": NullType;
+                readonly "200": NullType;
+                readonly "300": NullType;
+                readonly "400": NullType;
+                readonly "500": NullType;
+                readonly "600": NullType;
+                readonly "700": NullType;
+                readonly "800": NullType;
+                readonly "900": NullType;
+            }>;
+            readonly orange: VariantType<{
+                readonly "50": NullType;
+                readonly "100": NullType;
+                readonly "200": NullType;
+                readonly "300": NullType;
+                readonly "400": NullType;
+                readonly "500": NullType;
+                readonly "600": NullType;
+                readonly "700": NullType;
+                readonly "800": NullType;
+                readonly "900": NullType;
+            }>;
+            readonly yellow: VariantType<{
+                readonly "50": NullType;
+                readonly "100": NullType;
+                readonly "200": NullType;
+                readonly "300": NullType;
+                readonly "400": NullType;
+                readonly "500": NullType;
+                readonly "600": NullType;
+                readonly "700": NullType;
+                readonly "800": NullType;
+                readonly "900": NullType;
+            }>;
+            readonly green: VariantType<{
+                readonly "50": NullType;
+                readonly "100": NullType;
+                readonly "200": NullType;
+                readonly "300": NullType;
+                readonly "400": NullType;
+                readonly "500": NullType;
+                readonly "600": NullType;
+                readonly "700": NullType;
+                readonly "800": NullType;
+                readonly "900": NullType;
+            }>;
+            readonly teal: VariantType<{
+                readonly "50": NullType;
+                readonly "100": NullType;
+                readonly "200": NullType;
+                readonly "300": NullType;
+                readonly "400": NullType;
+                readonly "500": NullType;
+                readonly "600": NullType;
+                readonly "700": NullType;
+                readonly "800": NullType;
+                readonly "900": NullType;
+            }>;
+            readonly blue: VariantType<{
+                readonly "50": NullType;
+                readonly "100": NullType;
+                readonly "200": NullType;
+                readonly "300": NullType;
+                readonly "400": NullType;
+                readonly "500": NullType;
+                readonly "600": NullType;
+                readonly "700": NullType;
+                readonly "800": NullType;
+                readonly "900": NullType;
+            }>;
+            readonly cyan: VariantType<{
+                readonly "50": NullType;
+                readonly "100": NullType;
+                readonly "200": NullType;
+                readonly "300": NullType;
+                readonly "400": NullType;
+                readonly "500": NullType;
+                readonly "600": NullType;
+                readonly "700": NullType;
+                readonly "800": NullType;
+                readonly "900": NullType;
+            }>;
+            readonly purple: VariantType<{
+                readonly "50": NullType;
+                readonly "100": NullType;
+                readonly "200": NullType;
+                readonly "300": NullType;
+                readonly "400": NullType;
+                readonly "500": NullType;
+                readonly "600": NullType;
+                readonly "700": NullType;
+                readonly "800": NullType;
+                readonly "900": NullType;
+            }>;
+            readonly pink: VariantType<{
+                readonly "50": NullType;
+                readonly "100": NullType;
+                readonly "200": NullType;
+                readonly "300": NullType;
+                readonly "400": NullType;
+                readonly "500": NullType;
+                readonly "600": NullType;
+                readonly "700": NullType;
+                readonly "800": NullType;
+                readonly "900": NullType;
+            }>;
+        }>>;
     }>>;
     readonly activities: ArrayType<StructType<{
         readonly key: StringType;
@@ -2665,6 +3116,11 @@ export declare const RosterComponent: import("@elaraai/east-ui").UIComponentDef<
         readonly person: StringType;
         readonly reason: StringType;
     }>>;
+    readonly patterns: ArrayType<StructType<{
+        readonly key: StringType;
+        readonly label: StringType;
+        readonly days: ArrayType<OptionType<StringType>>;
+    }>>;
     readonly rules: StructType<{
         readonly rest: import("@elaraai/east").FloatType;
         readonly lead: BooleanType;
@@ -2710,9 +3166,16 @@ export declare const RosterComponent: import("@elaraai/east-ui").UIComponentDef<
     readonly fit: OptionType<StructType<{
         readonly name: StringType;
     }>>;
+    readonly optimise: OptionType<StructType<{
+        readonly name: StringType;
+    }>>;
     readonly library: ArrayType<VariantType<{
         readonly people: NullType;
         readonly activities: NullType;
+        readonly patterns: StructType<{
+            readonly name: StringType;
+            readonly icon: StringType;
+        }>;
         readonly tab: StructType<{
             readonly name: StringType;
             readonly icon: OptionType<StringType>;
@@ -2734,6 +3197,7 @@ export declare const RosterComponent: import("@elaraai/east-ui").UIComponentDef<
     readonly narrowed: StructType<{
         readonly people: OptionType<RowSourceType<ArrayType<StringType>>>;
         readonly activities: OptionType<RowSourceType<ArrayType<StringType>>>;
+        readonly patterns: OptionType<RowSourceType<ArrayType<StringType>>>;
     }>;
     readonly slice: OptionType<StructType<{
         readonly slice: StructType<{
@@ -2854,6 +3318,39 @@ export declare const RosterComponent: import("@elaraai/east-ui").UIComponentDef<
                                 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>;
@@ -2916,14 +3413,25 @@ export declare const RosterComponent: import("@elaraai/east-ui").UIComponentDef<
                     readonly clear: import("@elaraai/east").FunctionType<[import("@elaraai/east").StringType], NullType>;
                     readonly clearAll: import("@elaraai/east").FunctionType<[], NullType>;
                     readonly count: import("@elaraai/east").FunctionType<[], OptionType<import("@elaraai/east").IntegerType>>;
-                    readonly countWhere: import("@elaraai/east").FunctionType<[import("@elaraai/east").DictType<import("@elaraai/east").StringType, VariantType<{
-                        readonly values: ArrayType<import("@elaraai/east").StringType>;
-                        readonly range: StructType<{
-                            readonly from: import("@elaraai/east").StringType;
-                            readonly to: import("@elaraai/east").StringType;
-                        }>;
-                        readonly prefix: import("@elaraai/east").StringType;
-                    }>>], OptionType<import("@elaraai/east").IntegerType>>;
+                    readonly countWhere: import("@elaraai/east").FunctionType<[StructType<{
+                        readonly where: import("@elaraai/east").DictType<import("@elaraai/east").StringType, VariantType<{
+                            readonly values: ArrayType<import("@elaraai/east").StringType>;
+                            readonly range: StructType<{
+                                readonly from: import("@elaraai/east").StringType;
+                                readonly to: import("@elaraai/east").StringType;
+                            }>;
+                            readonly prefix: import("@elaraai/east").StringType;
+                        }>>;
+                        readonly area: OptionType<VariantType<{
+                            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 unplaced: NullType;
+                        }>>;
+                    }>], 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<{
                         readonly from: import("@elaraai/east").StringType;
@@ -3005,6 +3513,7 @@ export declare const RosterComponent: import("@elaraai/east-ui").UIComponentDef<
         readonly period: VariantType<{
             readonly day: NullType;
             readonly week: NullType;
+            readonly month: NullType;
         }>;
         readonly date: OptionType<DateTimeType>;
         readonly weekStart: VariantType<{
@@ -3018,6 +3527,11 @@ export declare const RosterComponent: import("@elaraai/east-ui").UIComponentDef<
         readonly chipSkills: BooleanType;
         readonly requirements: BooleanType;
         readonly readOnly: BooleanType;
+        readonly tileTimes: VariantType<{
+            readonly always: NullType;
+            readonly different: NullType;
+        }>;
+        readonly letters: BooleanType;
     }>;
     readonly id: OptionType<StringType>;
 }>>;
@@ -3027,7 +3541,7 @@ export declare const RosterComponent: import("@elaraai/east-ui").UIComponentDef<
  * @typeParam R - The app's duty row type: the duty kind's row
  */
 export interface RosterProps<R extends EastType = EastType> {
-    /** Exactly one event kind, the duties: `{ duty: Schedule.events(Record.bind(duties, [dutiesPatch]), { start, end, resource, shift, group, … }) }`. */
+    /** Exactly one event kind, the duties: `{ duty: Schedule.events(Record.bind(duties), { start, end, resource, shift, group, … }) }`. */
     events: Readonly<Record<string, ScheduleEventKind<EastType, R>>>;
     /**
      * Who is rostered: `people`, the staff — `Schedule.resources(staff.read(), { name, icon, label, group, … })`, every
@@ -3037,11 +3551,11 @@ export interface RosterProps<R extends EastType = EastType> {
         readonly people: ScheduleResourceKind<EastType, EastType>;
         readonly agencies?: ScheduleResourceKind<EastType, EastType>;
     };
-    /** What it publishes, the app's weeks: `Schedule.periods(Record.bind(weeks, [weeksPatch]), { every: "week", status, dismissed? })`. Omitted, no Publish. */
+    /** What it publishes, the app's weeks: `Schedule.periods(Record.bind(weeks), { every: "week", status, dismissed? })`. Omitted, no Publish. */
     periods?: SchedulePeriods;
-    /** The app's targets, a row per slot: `Roster.targets(Record.bind(cover, [coverPatch]), { day, group, shift, positions, hours })`. */
+    /** The app's targets, a row per slot: `Roster.targets(Record.bind(cover), { day, group, shift, positions, hours })`. */
     targets?: RosterTargets;
-    /** The shifts: `Roster.shifts(rows, { label, code, start, hours, order? })`. */
+    /** The shifts: `Roster.shifts(rows, { label, code, start, hours, order?, color? })`; `color` an `Option<ColorToken>`, the People tiles' fill (#1406). */
     shifts: RosterShifts;
     /** The groups: `Roster.groups(rows, { label, order? })`. */
     groups: RosterGroups;
@@ -3054,6 +3568,12 @@ export interface RosterProps<R extends EastType = EastType> {
     activities?: SubtypeExprOrValue<ArrayType<T.RosterSkillType>>;
     /** The app's suggestions: `Roster.proposals(rows, { person, day, group, shift, reason })`. */
     proposals?: RosterProposals;
+    /**
+     * The app's week patterns (#1406): `Roster.patterns(rows, { name, icon?, label, days, order? })` — the cards of the tab `name`
+     * titles (`Roster.library.patterns()`), and what a drop on a person's week applies: seven days from the week's first day,
+     * each a shift's key or none for a day off. Omitted, no patterns and no tab.
+     */
+    patterns?: RosterPatterns;
     /**
      * The app's pay (§5.6): an East function from `Roster.Types.PayRequest(R)` — one person's duties for the week, or one agency's
      * requests — to `Roster.Types.Pay`, each duty's cost by the app's own pay codes. Asked a person at a time; omitted, no costs show.
@@ -3077,6 +3597,13 @@ export interface RosterProps<R extends EastType = EastType> {
      * every person. Omitted, no Find fix is offered; `Roster.check(R)` still reports the issue.
      */
     fit?: BoundFunc<[T.RosterFitRequestTypeFor<R>], T.RosterFitResultType>;
+    /**
+     * The app's optimiser (#1409): `Func.bind` of its `e3.function` from `Roster.Types.OptimiseRequest(R)` — the week in view, the run
+     * number, the week's duties as drafted, its targets by slot and `Roster.Types.Context` — to `Roster.Types.OptimiseResult(R)`, the
+     * week's duties complete. 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.
+     */
+    optimise?: BoundFunc<[T.RosterOptimiseRequestTypeFor<R>], T.RosterOptimiseResultTypeFor<R>>;
     /**
      * The narrowing: one `Slice.bindRecords`, a source per record it narrows — the duty kind's slot (its interval index from the
      * start to the end, its `range` the start field, which the Roster's navigation writes), `targets`, `people` and `activities`,
@@ -3087,10 +3614,13 @@ export interface RosterProps<R extends EastType = EastType> {
     library?: readonly RosterLibraryTab[];
     /** Shows the inspector pane: the duty kind's own `inspector` and `Roster.targets`' `inspector` draw in it where given. */
     inspector?: boolean;
-    /** Initial view, persisted under id. */
+    /**
+     * Initial view, persisted under id. Shifts takes `"day"` or `"week"` (`"day"` by default); People `"week"` or `"month"`
+     * (`"week"` by default, #1406); a period its layout does not take is refused at build. Each layout keeps its own period per viewer.
+     */
     view?: {
         layout?: "shifts" | "people";
-        period?: "day" | "week";
+        period?: "day" | "week" | "month";
         date?: SubtypeExprOrValue<DateTimeType>;
     };
     /** Week boundary; Monday by default. */
@@ -3105,6 +3635,10 @@ export interface RosterProps<R extends EastType = EastType> {
     requirements?: SubtypeExprOrValue<BooleanType>;
     /** Disables edits; published weeks are always read-only. */
     readOnly?: SubtypeExprOrValue<BooleanType>;
+    /** Whether a People tile shows the shift's hours (`06–14`) always, or only a duty's own times where they differ from the shift's (#1406); `"always"` by default. */
+    tileTimes?: "always" | "different";
+    /** Whether a month's marks carry the shift's letter (#1406); `true` by default. */
+    letters?: boolean;
     /** Stable viewer identity when multiple Rosters share a surface. */
     id?: string;
 }
@@ -3137,8 +3671,11 @@ export declare function rosterAgenciesOf(kind: ScheduleResourceKind<EastType, Ea
  *   Roster values rather than its declaration; `events` holding other than one kind, or `resources` other than `people`
  *   and `agencies`; a duty kind whose resource names no `people`, or a resource kind read a window at a time; a `people`
  *   kind with no `group`; `positions` beside a duty kind with no `position` role; `pay` without `currency`; a `pay`, a
- *   `check` or a `fit` over another type; a library tab listed twice; and as `Schedule`'s checks, the duty kind's
- *   build (`buildRoster`) and the slice's (`recordSources`) do
+ *   `check` or a `fit` over another type, or an `optimise` that is not `Func.bind` of a function from `OptimiseRequest(R)` to
+ *   `OptimiseResult(R)` (#1409); a library tab listed twice; a `view.period` its layout does not take, naming each
+ *   layout's periods; `Roster.library.patterns()` without `patterns`; a `tileTimes` other than `"always"` or
+ *   `"different"`, or a `letters` that is no boolean (#1406); and as `Schedule`'s checks, the duty kind's build
+ *   (`buildRoster`) and the slice's (`recordSources`) do
  * @internal
  */
 export declare function createRosterPayload<R extends EastType>(props: RosterProps<R>): ExprType<typeof RosterPayloadType>;
@@ -3156,6 +3693,8 @@ export interface RosterNamespace {
     activities: typeof rosterActivities;
     /** Reads the app's suggestion rows as the Roster's proposals. */
     proposals: typeof rosterProposals;
+    /** Reads the app's week pattern rows as the Roster's patterns, with their tab's name and icon (#1406). */
+    patterns: typeof rosterPatterns;
     /** Declares the app's targets, a row per slot, over its own record. */
     targets: typeof rosterTargets;
     /** `coverage(R)`: computes coverage without a browser. */
@@ -3174,6 +3713,7 @@ export interface RosterNamespace {
     library: {
         people: typeof rosterPeopleTab;
         activities: typeof rosterActivitiesTab;
+        patterns: typeof rosterPatternsTab;
         tab: typeof rosterLibraryTab;
     };
     /** @deprecated Removed (#1368): the people are `resources={{ people: Schedule.resources(staff.read(), { name, icon, label, group, … }) }}`. */
@@ -3214,6 +3754,10 @@ export interface RosterNamespace {
         Pay: T.RosterPayType;
         Layout: typeof RosterLayoutType;
         Period: typeof RosterPeriodType;
+        Pattern: T.RosterPatternType;
+        TileTimes: typeof RosterTileTimesType;
+        OptimiseRequest: typeof T.RosterOptimiseRequestTypeFor;
+        OptimiseResult: typeof T.RosterOptimiseResultTypeFor;
     };
 }
 /**