@elaraai/e3-ui 1.0.86 → 1.0.87

package/dist/test/roster/domain.examples.d.ts

@@ -0,0 +1,367 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+import { FloatType, IntegerType, type ValueTypeOf } from "@elaraai/east";
+import { Roster } from "@elaraai/e3-ui";
+/** Small staffing fixture with independently calculable hours and cost. */
+export declare const context: ValueTypeOf<typeof Roster.Types.Context>;
+export declare const slot: {
+    day: bigint;
+    group: string;
+    shift: string;
+};
+export declare const week: ValueTypeOf<typeof Roster.Types.Week>;
+export declare const rosterCoverage: import("@elaraai/east").ExampleDef<[import("@elaraai/east").StructType<{
+    readonly status: import("@elaraai/east").VariantType<{
+        readonly draft: import("@elaraai/east").NullType;
+        readonly published: import("@elaraai/east").StructType<{
+            readonly at: import("@elaraai/east").DateTimeType;
+        }>;
+    }>;
+    readonly assignments: import("@elaraai/east").DictType<import("@elaraai/east").StringType, import("@elaraai/east").StructType<{
+        readonly slot: import("@elaraai/east").StructType<{
+            readonly day: IntegerType;
+            readonly group: import("@elaraai/east").StringType;
+            readonly shift: import("@elaraai/east").StringType;
+        }>;
+        readonly who: import("@elaraai/east").VariantType<{
+            readonly person: import("@elaraai/east").StringType;
+            readonly request: import("@elaraai/east").StringType;
+        }>;
+        readonly position: import("@elaraai/east").StringType;
+        readonly activity: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+        readonly offset: FloatType;
+        readonly overtime: FloatType;
+        readonly agreed: import("@elaraai/east").OptionType<import("@elaraai/east").BooleanType>;
+    }>>;
+    readonly requirements: import("@elaraai/east").DictType<import("@elaraai/east").StructType<{
+        readonly day: IntegerType;
+        readonly group: import("@elaraai/east").StringType;
+        readonly shift: import("@elaraai/east").StringType;
+    }>, import("@elaraai/east").StructType<{
+        readonly positions: IntegerType;
+        readonly hours: import("@elaraai/east").DictType<import("@elaraai/east").StringType, FloatType>;
+    }>>;
+    readonly dismissed: import("@elaraai/east").SetType<import("@elaraai/east").StringType>;
+}>, import("@elaraai/east").StructType<{
+    readonly people: import("@elaraai/east").DictType<import("@elaraai/east").StringType, import("@elaraai/east").StructType<{
+        readonly key: import("@elaraai/east").StringType;
+        readonly name: import("@elaraai/east").StringType;
+        readonly group: import("@elaraai/east").StringType;
+        readonly position: import("@elaraai/east").StringType;
+        readonly skills: import("@elaraai/east").SetType<import("@elaraai/east").StringType>;
+        readonly contract: FloatType;
+        readonly agency: import("@elaraai/east").BooleanType;
+        readonly trainer: import("@elaraai/east").BooleanType;
+        readonly trainee: import("@elaraai/east").BooleanType;
+        readonly usual: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+    }>>;
+    readonly groups: import("@elaraai/east").ArrayType<import("@elaraai/east").StructType<{
+        readonly key: import("@elaraai/east").StringType;
+        readonly label: import("@elaraai/east").StringType;
+        readonly skills: import("@elaraai/east").ArrayType<import("@elaraai/east").StructType<{
+            readonly key: import("@elaraai/east").StringType;
+            readonly label: import("@elaraai/east").StringType;
+            readonly code: import("@elaraai/east").StringType;
+        }>>;
+    }>>;
+    readonly duties: import("@elaraai/east").ArrayType<import("@elaraai/east").StructType<{
+        readonly key: import("@elaraai/east").StringType;
+        readonly label: import("@elaraai/east").StringType;
+        readonly code: import("@elaraai/east").StringType;
+    }>>;
+    readonly shifts: import("@elaraai/east").ArrayType<import("@elaraai/east").StructType<{
+        readonly key: import("@elaraai/east").StringType;
+        readonly label: import("@elaraai/east").StringType;
+        readonly code: import("@elaraai/east").StringType;
+        readonly start: import("@elaraai/east").StructType<{
+            readonly hour: IntegerType;
+            readonly minute: IntegerType;
+        }>;
+        readonly hours: FloatType;
+    }>>;
+    readonly positions: import("@elaraai/east").ArrayType<import("@elaraai/east").StructType<{
+        readonly key: import("@elaraai/east").StringType;
+        readonly label: import("@elaraai/east").StringType;
+        readonly code: import("@elaraai/east").StringType;
+        readonly lead: import("@elaraai/east").BooleanType;
+    }>>;
+    readonly agencies: import("@elaraai/east").ArrayType<import("@elaraai/east").StructType<{
+        readonly key: import("@elaraai/east").StringType;
+        readonly name: import("@elaraai/east").StringType;
+    }>>;
+    readonly rules: import("@elaraai/east").StructType<{
+        readonly rest: FloatType;
+        readonly lead: import("@elaraai/east").BooleanType;
+        readonly trainer: import("@elaraai/east").BooleanType;
+        readonly skill: import("@elaraai/east").BooleanType;
+        readonly agree: import("@elaraai/east").BooleanType;
+    }>;
+    readonly costs: import("@elaraai/east").OptionType<import("@elaraai/east").StructType<{
+        readonly currency: import("@elaraai/east").StringType;
+        readonly rates: import("@elaraai/east").StructType<{
+            readonly permanent: FloatType;
+            readonly overtime: FloatType;
+            readonly agency: FloatType;
+        }>;
+        readonly budget: import("@elaraai/east").OptionType<FloatType>;
+    }>>;
+}>], any>;
+export declare const rosterChecks: import("@elaraai/east").ExampleDef<[import("@elaraai/east").StructType<{
+    readonly status: import("@elaraai/east").VariantType<{
+        readonly draft: import("@elaraai/east").NullType;
+        readonly published: import("@elaraai/east").StructType<{
+            readonly at: import("@elaraai/east").DateTimeType;
+        }>;
+    }>;
+    readonly assignments: import("@elaraai/east").DictType<import("@elaraai/east").StringType, import("@elaraai/east").StructType<{
+        readonly slot: import("@elaraai/east").StructType<{
+            readonly day: IntegerType;
+            readonly group: import("@elaraai/east").StringType;
+            readonly shift: import("@elaraai/east").StringType;
+        }>;
+        readonly who: import("@elaraai/east").VariantType<{
+            readonly person: import("@elaraai/east").StringType;
+            readonly request: import("@elaraai/east").StringType;
+        }>;
+        readonly position: import("@elaraai/east").StringType;
+        readonly activity: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+        readonly offset: FloatType;
+        readonly overtime: FloatType;
+        readonly agreed: import("@elaraai/east").OptionType<import("@elaraai/east").BooleanType>;
+    }>>;
+    readonly requirements: import("@elaraai/east").DictType<import("@elaraai/east").StructType<{
+        readonly day: IntegerType;
+        readonly group: import("@elaraai/east").StringType;
+        readonly shift: import("@elaraai/east").StringType;
+    }>, import("@elaraai/east").StructType<{
+        readonly positions: IntegerType;
+        readonly hours: import("@elaraai/east").DictType<import("@elaraai/east").StringType, FloatType>;
+    }>>;
+    readonly dismissed: import("@elaraai/east").SetType<import("@elaraai/east").StringType>;
+}>, import("@elaraai/east").StructType<{
+    readonly people: import("@elaraai/east").DictType<import("@elaraai/east").StringType, import("@elaraai/east").StructType<{
+        readonly key: import("@elaraai/east").StringType;
+        readonly name: import("@elaraai/east").StringType;
+        readonly group: import("@elaraai/east").StringType;
+        readonly position: import("@elaraai/east").StringType;
+        readonly skills: import("@elaraai/east").SetType<import("@elaraai/east").StringType>;
+        readonly contract: FloatType;
+        readonly agency: import("@elaraai/east").BooleanType;
+        readonly trainer: import("@elaraai/east").BooleanType;
+        readonly trainee: import("@elaraai/east").BooleanType;
+        readonly usual: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+    }>>;
+    readonly groups: import("@elaraai/east").ArrayType<import("@elaraai/east").StructType<{
+        readonly key: import("@elaraai/east").StringType;
+        readonly label: import("@elaraai/east").StringType;
+        readonly skills: import("@elaraai/east").ArrayType<import("@elaraai/east").StructType<{
+            readonly key: import("@elaraai/east").StringType;
+            readonly label: import("@elaraai/east").StringType;
+            readonly code: import("@elaraai/east").StringType;
+        }>>;
+    }>>;
+    readonly duties: import("@elaraai/east").ArrayType<import("@elaraai/east").StructType<{
+        readonly key: import("@elaraai/east").StringType;
+        readonly label: import("@elaraai/east").StringType;
+        readonly code: import("@elaraai/east").StringType;
+    }>>;
+    readonly shifts: import("@elaraai/east").ArrayType<import("@elaraai/east").StructType<{
+        readonly key: import("@elaraai/east").StringType;
+        readonly label: import("@elaraai/east").StringType;
+        readonly code: import("@elaraai/east").StringType;
+        readonly start: import("@elaraai/east").StructType<{
+            readonly hour: IntegerType;
+            readonly minute: IntegerType;
+        }>;
+        readonly hours: FloatType;
+    }>>;
+    readonly positions: import("@elaraai/east").ArrayType<import("@elaraai/east").StructType<{
+        readonly key: import("@elaraai/east").StringType;
+        readonly label: import("@elaraai/east").StringType;
+        readonly code: import("@elaraai/east").StringType;
+        readonly lead: import("@elaraai/east").BooleanType;
+    }>>;
+    readonly agencies: import("@elaraai/east").ArrayType<import("@elaraai/east").StructType<{
+        readonly key: import("@elaraai/east").StringType;
+        readonly name: import("@elaraai/east").StringType;
+    }>>;
+    readonly rules: import("@elaraai/east").StructType<{
+        readonly rest: FloatType;
+        readonly lead: import("@elaraai/east").BooleanType;
+        readonly trainer: import("@elaraai/east").BooleanType;
+        readonly skill: import("@elaraai/east").BooleanType;
+        readonly agree: import("@elaraai/east").BooleanType;
+    }>;
+    readonly costs: import("@elaraai/east").OptionType<import("@elaraai/east").StructType<{
+        readonly currency: import("@elaraai/east").StringType;
+        readonly rates: import("@elaraai/east").StructType<{
+            readonly permanent: FloatType;
+            readonly overtime: FloatType;
+            readonly agency: FloatType;
+        }>;
+        readonly budget: import("@elaraai/east").OptionType<FloatType>;
+    }>>;
+}>], any>;
+export declare const rosterWeeklyHours: import("@elaraai/east").ExampleDef<[import("@elaraai/east").StructType<{
+    readonly status: import("@elaraai/east").VariantType<{
+        readonly draft: import("@elaraai/east").NullType;
+        readonly published: import("@elaraai/east").StructType<{
+            readonly at: import("@elaraai/east").DateTimeType;
+        }>;
+    }>;
+    readonly assignments: import("@elaraai/east").DictType<import("@elaraai/east").StringType, import("@elaraai/east").StructType<{
+        readonly slot: import("@elaraai/east").StructType<{
+            readonly day: IntegerType;
+            readonly group: import("@elaraai/east").StringType;
+            readonly shift: import("@elaraai/east").StringType;
+        }>;
+        readonly who: import("@elaraai/east").VariantType<{
+            readonly person: import("@elaraai/east").StringType;
+            readonly request: import("@elaraai/east").StringType;
+        }>;
+        readonly position: import("@elaraai/east").StringType;
+        readonly activity: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+        readonly offset: FloatType;
+        readonly overtime: FloatType;
+        readonly agreed: import("@elaraai/east").OptionType<import("@elaraai/east").BooleanType>;
+    }>>;
+    readonly requirements: import("@elaraai/east").DictType<import("@elaraai/east").StructType<{
+        readonly day: IntegerType;
+        readonly group: import("@elaraai/east").StringType;
+        readonly shift: import("@elaraai/east").StringType;
+    }>, import("@elaraai/east").StructType<{
+        readonly positions: IntegerType;
+        readonly hours: import("@elaraai/east").DictType<import("@elaraai/east").StringType, FloatType>;
+    }>>;
+    readonly dismissed: import("@elaraai/east").SetType<import("@elaraai/east").StringType>;
+}>, import("@elaraai/east").StructType<{
+    readonly people: import("@elaraai/east").DictType<import("@elaraai/east").StringType, import("@elaraai/east").StructType<{
+        readonly key: import("@elaraai/east").StringType;
+        readonly name: import("@elaraai/east").StringType;
+        readonly group: import("@elaraai/east").StringType;
+        readonly position: import("@elaraai/east").StringType;
+        readonly skills: import("@elaraai/east").SetType<import("@elaraai/east").StringType>;
+        readonly contract: FloatType;
+        readonly agency: import("@elaraai/east").BooleanType;
+        readonly trainer: import("@elaraai/east").BooleanType;
+        readonly trainee: import("@elaraai/east").BooleanType;
+        readonly usual: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+    }>>;
+    readonly groups: import("@elaraai/east").ArrayType<import("@elaraai/east").StructType<{
+        readonly key: import("@elaraai/east").StringType;
+        readonly label: import("@elaraai/east").StringType;
+        readonly skills: import("@elaraai/east").ArrayType<import("@elaraai/east").StructType<{
+            readonly key: import("@elaraai/east").StringType;
+            readonly label: import("@elaraai/east").StringType;
+            readonly code: import("@elaraai/east").StringType;
+        }>>;
+    }>>;
+    readonly duties: import("@elaraai/east").ArrayType<import("@elaraai/east").StructType<{
+        readonly key: import("@elaraai/east").StringType;
+        readonly label: import("@elaraai/east").StringType;
+        readonly code: import("@elaraai/east").StringType;
+    }>>;
+    readonly shifts: import("@elaraai/east").ArrayType<import("@elaraai/east").StructType<{
+        readonly key: import("@elaraai/east").StringType;
+        readonly label: import("@elaraai/east").StringType;
+        readonly code: import("@elaraai/east").StringType;
+        readonly start: import("@elaraai/east").StructType<{
+            readonly hour: IntegerType;
+            readonly minute: IntegerType;
+        }>;
+        readonly hours: FloatType;
+    }>>;
+    readonly positions: import("@elaraai/east").ArrayType<import("@elaraai/east").StructType<{
+        readonly key: import("@elaraai/east").StringType;
+        readonly label: import("@elaraai/east").StringType;
+        readonly code: import("@elaraai/east").StringType;
+        readonly lead: import("@elaraai/east").BooleanType;
+    }>>;
+    readonly agencies: import("@elaraai/east").ArrayType<import("@elaraai/east").StructType<{
+        readonly key: import("@elaraai/east").StringType;
+        readonly name: import("@elaraai/east").StringType;
+    }>>;
+    readonly rules: import("@elaraai/east").StructType<{
+        readonly rest: FloatType;
+        readonly lead: import("@elaraai/east").BooleanType;
+        readonly trainer: import("@elaraai/east").BooleanType;
+        readonly skill: import("@elaraai/east").BooleanType;
+        readonly agree: import("@elaraai/east").BooleanType;
+    }>;
+    readonly costs: import("@elaraai/east").OptionType<import("@elaraai/east").StructType<{
+        readonly currency: import("@elaraai/east").StringType;
+        readonly rates: import("@elaraai/east").StructType<{
+            readonly permanent: FloatType;
+            readonly overtime: FloatType;
+            readonly agency: FloatType;
+        }>;
+        readonly budget: import("@elaraai/east").OptionType<FloatType>;
+    }>>;
+}>], any>;
+export declare const rosterRest: import("@elaraai/east").ExampleDef<[import("@elaraai/east").StructType<{
+    readonly people: import("@elaraai/east").DictType<import("@elaraai/east").StringType, import("@elaraai/east").StructType<{
+        readonly key: import("@elaraai/east").StringType;
+        readonly name: import("@elaraai/east").StringType;
+        readonly group: import("@elaraai/east").StringType;
+        readonly position: import("@elaraai/east").StringType;
+        readonly skills: import("@elaraai/east").SetType<import("@elaraai/east").StringType>;
+        readonly contract: FloatType;
+        readonly agency: import("@elaraai/east").BooleanType;
+        readonly trainer: import("@elaraai/east").BooleanType;
+        readonly trainee: import("@elaraai/east").BooleanType;
+        readonly usual: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+    }>>;
+    readonly groups: import("@elaraai/east").ArrayType<import("@elaraai/east").StructType<{
+        readonly key: import("@elaraai/east").StringType;
+        readonly label: import("@elaraai/east").StringType;
+        readonly skills: import("@elaraai/east").ArrayType<import("@elaraai/east").StructType<{
+            readonly key: import("@elaraai/east").StringType;
+            readonly label: import("@elaraai/east").StringType;
+            readonly code: import("@elaraai/east").StringType;
+        }>>;
+    }>>;
+    readonly duties: import("@elaraai/east").ArrayType<import("@elaraai/east").StructType<{
+        readonly key: import("@elaraai/east").StringType;
+        readonly label: import("@elaraai/east").StringType;
+        readonly code: import("@elaraai/east").StringType;
+    }>>;
+    readonly shifts: import("@elaraai/east").ArrayType<import("@elaraai/east").StructType<{
+        readonly key: import("@elaraai/east").StringType;
+        readonly label: import("@elaraai/east").StringType;
+        readonly code: import("@elaraai/east").StringType;
+        readonly start: import("@elaraai/east").StructType<{
+            readonly hour: IntegerType;
+            readonly minute: IntegerType;
+        }>;
+        readonly hours: FloatType;
+    }>>;
+    readonly positions: import("@elaraai/east").ArrayType<import("@elaraai/east").StructType<{
+        readonly key: import("@elaraai/east").StringType;
+        readonly label: import("@elaraai/east").StringType;
+        readonly code: import("@elaraai/east").StringType;
+        readonly lead: import("@elaraai/east").BooleanType;
+    }>>;
+    readonly agencies: import("@elaraai/east").ArrayType<import("@elaraai/east").StructType<{
+        readonly key: import("@elaraai/east").StringType;
+        readonly name: import("@elaraai/east").StringType;
+    }>>;
+    readonly rules: import("@elaraai/east").StructType<{
+        readonly rest: FloatType;
+        readonly lead: import("@elaraai/east").BooleanType;
+        readonly trainer: import("@elaraai/east").BooleanType;
+        readonly skill: import("@elaraai/east").BooleanType;
+        readonly agree: import("@elaraai/east").BooleanType;
+    }>;
+    readonly costs: import("@elaraai/east").OptionType<import("@elaraai/east").StructType<{
+        readonly currency: import("@elaraai/east").StringType;
+        readonly rates: import("@elaraai/east").StructType<{
+            readonly permanent: FloatType;
+            readonly overtime: FloatType;
+            readonly agency: FloatType;
+        }>;
+        readonly budget: import("@elaraai/east").OptionType<FloatType>;
+    }>>;
+}>], any>;
+//# sourceMappingURL=domain.examples.d.ts.map

package/dist/test/roster/domain.examples.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.examples.d.ts","sourceRoot":"","sources":["../../../test/roster/domain.examples.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAQ,SAAS,EAAE,WAAW,EAAuD,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AACpI,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAExC,2EAA2E;AAC3E,eAAO,MAAM,OAAO,EAAE,WAAW,CAAC,OAAO,MAAM,CAAC,KAAK,CAAC,OAAO,CAa5D,CAAC;AACF,eAAO,MAAM,IAAI;;;;CAA8C,CAAC;AAChE,eAAO,MAAM,IAAI,EAAE,WAAW,CAAC,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAQtD,CAAC;AAEF,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;SAWzB,CAAC;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;SAMvB,CAAC;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;SAM5B,CAAC;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;SAUrB,CAAC"}

package/dist/test/roster/domain.examples.js

@@ -0,0 +1,72 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+import { East, FloatType, IntegerType, SortedMap, compareFor, example, none, some, variant } from "@elaraai/east";
+import { Roster } from "@elaraai/e3-ui";
+/** Small staffing fixture with independently calculable hours and cost. */
+export const context = {
+    people: new Map([
+        ["lead", { key: "lead", name: "Lead", group: "goods", position: "lead", skills: new Set(["reach"]), contract: 40, agency: false, trainer: true, trainee: false, usual: some("early") }],
+        ["agency", { key: "agency", name: "Agency", group: "goods", position: "crew", skills: new Set(), contract: 0, agency: true, trainer: false, trainee: false, usual: none }],
+        ["off", { key: "off", name: "Off", group: "goods", position: "crew", skills: new Set(), contract: 40, agency: false, trainer: false, trainee: false, usual: none }],
+    ]),
+    groups: [{ key: "goods", label: "Goods", skills: [{ key: "reach", label: "Reach truck", code: "RT" }] }],
+    duties: [{ key: "general", label: "General duties", code: "GD" }],
+    shifts: [{ key: "early", label: "Early", code: "E", start: { hour: 6n, minute: 0n }, hours: 8 }, { key: "night", label: "Night", code: "N", start: { hour: 22n, minute: 0n }, hours: 8 }],
+    positions: [{ key: "crew", label: "Crew", code: "", lead: false }, { key: "lead", label: "Lead", code: "SV", lead: true }],
+    agencies: [{ key: "agency", name: "Staffing agency" }],
+    rules: { rest: 10, lead: true, skill: true, trainer: true, agree: true },
+    costs: some({ currency: "AUD", rates: { permanent: 42, overtime: 63, agency: 51 }, budget: none }),
+};
+export const slot = { day: 0n, group: "goods", shift: "early" };
+export const week = {
+    status: variant("draft", null), dismissed: new Set(),
+    assignments: new Map([
+        ["a", { slot, who: variant("person", "lead"), position: "lead", activity: some("reach"), offset: 1, overtime: 2, agreed: none }],
+        ["b", { slot, who: variant("person", "agency"), position: "crew", activity: some("general"), offset: 0, overtime: 0, agreed: none }],
+        ["c", { slot, who: variant("request", "agency"), position: "crew", activity: none, offset: 0, overtime: 0, agreed: none }],
+    ]),
+    requirements: new SortedMap([[slot, { positions: 4n, hours: new Map([["reach", 24], ["general", 6]]) }]], compareFor(Roster.Types.Slot)),
+};
+export const rosterCoverage = example({
+    description: "Coverage separates named staff, requested positions, nominal skill capacity, assigned activity hours and overtime cost",
+    keywords: ["Roster", "Roster.coverage", "coverage", "skills", "agency", "cost"], inputs: [week, context],
+    fn: East.function([Roster.Types.Week, Roster.Types.Context], Roster.Types.Coverage, ($, week, context) => {
+        const coverage = $.const(Roster.coverage);
+        return coverage(week, context).get(slot);
+    }),
+    returns: { positions: 4n, filled: 3n, open: 1n, people: 2n,
+        hours: { permanent: 8, agency: 8, overtime: 2, requested: 8, needed: 30, rostered: 26 },
+        lines: [{ skill: "reach", needed: 24, holders: some(1n), capacity: some(8), gap: 16, assigned: 10 },
+            { skill: "general", needed: 6, holders: none, capacity: none, gap: 0, assigned: 8 }],
+        cost: 1278, lead: true, trainer: true },
+});
+export const rosterChecks = example({
+    description: "Built-in checks report an open position, a skill-capacity gap and unagreed changed hours",
+    keywords: ["Roster", "Roster.check", "issues", "fix"], inputs: [week, context], returns: 3n,
+    fn: East.function([Roster.Types.Week, Roster.Types.Context], IntegerType, ($, week, context) => {
+        const check = $.const(Roster.check);
+        return check(week, context).size();
+    }),
+});
+export const rosterWeeklyHours = example({
+    description: "Weekly hours include overtime without shortening the shift for a later start",
+    keywords: ["Roster", "Roster.weekHours", "offset", "overtime"], inputs: [week, context], returns: 10,
+    fn: East.function([Roster.Types.Week, Roster.Types.Context], FloatType, ($, week, context) => {
+        const hours = $.const(Roster.weekHours);
+        return hours(week, context).get("lead");
+    }),
+});
+export const rosterRest = example({
+    description: "A night shift with overtime leaves only six hours before the following late shift",
+    keywords: ["Roster", "Roster.rest", "rest", "overnight", "overtime"], inputs: [context], returns: 6,
+    fn: East.function([Roster.Types.Context], FloatType, ($, context) => {
+        const rest = $.const(Roster.rest);
+        const prior = $.const({ status: variant("draft", null), dismissed: new Set(), requirements: new Map(), assignments: new Map([
+                ["night", { slot: { day: 0n, group: "goods", shift: "night" }, who: variant("person", "lead"), position: "lead", activity: none, offset: 0, overtime: 2, agreed: some(true) }],
+            ]) }, Roster.Types.Week);
+        return rest({ slot: { day: 1n, group: "goods", shift: "early" }, who: variant("person", "lead"), position: "lead", activity: none, offset: 8, overtime: 0, agreed: none }, "next", prior, context).before;
+    }),
+});
+//# sourceMappingURL=domain.examples.js.map

package/dist/test/roster/domain.examples.js.map

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