@elaraai/e3-ui 1.0.97 → 1.0.98

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

@@ -188,13 +188,14 @@ export declare const RosterGroupType: StructType<{
 }>;
 export type RosterGroupType = typeof RosterGroupType;
 /**
- * A recurring shift's start and nominal hours.
+ * A recurring shift's start and nominal hours, and its colour.
  * @remarks An end past midnight belongs to the following day; a duty still belongs to its shift's start day.
  * @property key - Stable identifier
  * @property label - Display name
  * @property code - Short code in the week layout
  * @property start - Start time in UTC, shared with Schedule
  * @property hours - Nominal shift duration: what a new duty runs, and a skill holder's capacity
+ * @property color - The app's colour token for it (#1406): the People layout's tiles' and marks' fill; `none`, neutral
  */
 export declare const RosterShiftType: StructType<{
     readonly key: StringType;
@@ -205,8 +206,157 @@ export declare const RosterShiftType: StructType<{
         readonly minute: IntegerType;
     }>;
     readonly hours: 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;
+        }>;
+    }>>;
 }>;
 export type RosterShiftType = typeof RosterShiftType;
+/**
+ * A week pattern, as the Roster reads it from the app's row (`Roster.patterns`,
+ * #1406): seven days from the week's first day, each a shift's key or `none`
+ * for a day off, which a drop on a person's week applies.
+ * @remarks The Roster reads patterns and writes nothing to them; a drop writes the person's duties.
+ * @property key - Its row's key
+ * @property label - Display name: the card's, and the drop's words
+ * @property days - Seven entries from the week's first day: a shift's key, or `none` for a day off
+ */
+export declare const RosterPatternType: StructType<{
+    readonly key: StringType;
+    readonly label: StringType;
+    readonly days: ArrayType<OptionType<StringType>>;
+}>;
+export type RosterPatternType = typeof RosterPatternType;
 /**
  * A position someone may hold on a shift.
  * @remarks Position order determines lead ordering in the grid.
@@ -318,6 +468,140 @@ export declare const RosterContextType: StructType<{
             readonly minute: IntegerType;
         }>;
         readonly hours: 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 positions: ArrayType<StructType<{
         readonly key: StringType;
@@ -565,6 +849,140 @@ export declare function RosterPayRequestTypeFor<R extends EastType>(row: R): Str
                 readonly minute: IntegerType;
             }>;
             readonly hours: 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 positions: ArrayType<StructType<{
             readonly key: StringType;
@@ -663,6 +1081,140 @@ export declare function RosterCheckContextTypeFor<R extends EastType>(row: R): S
                 readonly minute: IntegerType;
             }>;
             readonly hours: 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 positions: ArrayType<StructType<{
             readonly key: StringType;
@@ -842,6 +1394,140 @@ export declare function RosterFitRequestTypeFor<R extends EastType>(row: R): Str
                 readonly minute: IntegerType;
             }>;
             readonly hours: 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 positions: ArrayType<StructType<{
             readonly key: StringType;
@@ -1314,4 +2000,230 @@ export declare const RosterFitResultType: StructType<{
     }>>;
 }>;
 export type RosterFitResultType = typeof RosterFitResultType;
+/**
+ * One request to the app's optimiser (#1409, `Optimise Spec.md` §5.1): the
+ * week in view and its duties, as drafted, for the optimiser to fill or
+ * improve — the Elara eye's one call.
+ *
+ * @typeParam R - The app's duty row type
+ * @param row - The app's duty row type
+ * @returns The request type over it
+ * @remarks `from` and `to` the week, half open; `run` the run's number, from 1 per Roster per browser; `duties` the week's duties by key, the app's own rows as the session holds them — the base with every unapplied draft in place, every row whatever the rail shows; `requirements` the week's targets by slot; `context` the complete staff and configuration — every person, shift, group, position and agency, and the rules.
+ */
+export declare function RosterOptimiseRequestTypeFor<R extends EastType>(row: R): StructType<{
+    readonly from: DateTimeType;
+    readonly to: DateTimeType;
+    readonly run: IntegerType;
+    readonly duties: DictType<StringType, R>;
+    readonly requirements: DictType<StructType<{
+        readonly day: IntegerType;
+        readonly group: StringType;
+        readonly shift: StringType;
+    }>, StructType<{
+        readonly positions: IntegerType;
+        readonly hours: DictType<StringType, FloatType>;
+    }>>;
+    readonly context: StructType<{
+        readonly people: DictType<StringType, StructType<{
+            readonly key: StringType;
+            readonly name: StringType;
+            readonly group: StringType;
+            readonly position: StringType;
+            readonly skills: SetType<StringType>;
+            readonly contract: FloatType;
+            readonly agency: BooleanType;
+            readonly trainer: BooleanType;
+            readonly trainee: BooleanType;
+            readonly usual: OptionType<StringType>;
+        }>>;
+        readonly groups: ArrayType<StructType<{
+            readonly key: StringType;
+            readonly label: StringType;
+        }>>;
+        readonly activities: ArrayType<StructType<{
+            readonly key: StringType;
+            readonly label: StringType;
+            readonly code: StringType;
+            readonly group: OptionType<StringType>;
+        }>>;
+        readonly shifts: ArrayType<StructType<{
+            readonly key: StringType;
+            readonly label: StringType;
+            readonly code: StringType;
+            readonly start: StructType<{
+                readonly hour: IntegerType;
+                readonly minute: IntegerType;
+            }>;
+            readonly hours: 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 positions: ArrayType<StructType<{
+            readonly key: StringType;
+            readonly label: StringType;
+            readonly code: StringType;
+            readonly lead: BooleanType;
+        }>>;
+        readonly agencies: ArrayType<StructType<{
+            readonly key: StringType;
+            readonly name: StringType;
+        }>>;
+        readonly rules: StructType<{
+            readonly rest: FloatType;
+            readonly lead: BooleanType;
+            readonly trainer: BooleanType;
+            readonly skill: BooleanType;
+        }>;
+    }>;
+}>;
+/** Type representing {@link RosterOptimiseRequestTypeFor}. */
+export type RosterOptimiseRequestTypeFor<R extends EastType> = ReturnType<typeof RosterOptimiseRequestTypeFor<R>>;
+/**
+ * The app's optimiser's answer (#1409): the week's duties, complete, by key.
+ * The Roster diffs it against the request by key — a key the request did not
+ * hold is a duty added, one it held with another row a duty changed, one
+ * missing a duty removed — and records the diff as one step of its history.
+ *
+ * @typeParam R - The app's duty row type
+ * @param row - The app's duty row type
+ * @returns The result type over it
+ * @remarks A new duty's key is the optimiser's own; a result equal to the request records nothing.
+ */
+export declare function RosterOptimiseResultTypeFor<R extends EastType>(row: R): StructType<{
+    readonly duties: DictType<StringType, R>;
+}>;
+/** Type representing {@link RosterOptimiseResultTypeFor}. */
+export type RosterOptimiseResultTypeFor<R extends EastType> = ReturnType<typeof RosterOptimiseResultTypeFor<R>>;
 //# sourceMappingURL=types.d.ts.map