@elaraai/e3-ui 1.0.86 → 1.0.87

package/dist/src/roster/types.js

@@ -0,0 +1,248 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+import { ArrayType, BooleanType, DateTimeType, DictType, FloatType, IntegerType, NullType, OptionType, SetType, StringType, StructType, VariantType, } from "@elaraai/east";
+import { StatusTokenType } from "@elaraai/east-ui";
+import { ScheduleClockType } from "../schedule/types.js";
+/**
+ * One shift of one group on one day. Day zero is the record key's UTC date.
+ * @remarks Slot keys compare by East value, including when decoded in the browser.
+ * @property day - Day within the week, from zero to six
+ * @property group - Group key
+ * @property shift - Shift key
+ */
+export const RosterSlotType = StructType({ day: IntegerType, group: StringType, shift: StringType });
+/**
+ * The subject of an assignment.
+ * @remarks Requests reserve positions without pretending an agency has supplied a named person.
+ * @property person - The original staff record key
+ * @property request - The agency asked to supply someone
+ */
+export const RosterWhoType = VariantType({ person: StringType, request: StringType });
+/**
+ * An assignment stored within one week.
+ * @remarks A start offset moves the start; overtime extends the end. Agreement is absent for an unchanged shift.
+ * @property slot - The day, group and shift
+ * @property who - A named person or an agency request
+ * @property position - Position held on this assignment
+ * @property activity - One skill or duty, or none
+ * @property offset - Start offset in hours, negative for an early start
+ * @property overtime - Additional hours after the shift
+ * @property agreed - Whether the person agreed to changed hours
+ */
+export const RosterAssignmentType = StructType({
+    slot: RosterSlotType, who: RosterWhoType, position: StringType, activity: OptionType(StringType),
+    offset: FloatType, overtime: FloatType, agreed: OptionType(BooleanType),
+});
+/**
+ * A slot's staffing and work targets.
+ * @remarks A duty needs assigned hours, whereas a skill also has holder capacity.
+ * @property positions - Positions to fill
+ * @property hours - Hours required by skill or duty key
+ */
+export const RosterRequirementType = StructType({ positions: IntegerType, hours: DictType(StringType, FloatType) });
+/** Targets keyed by the complete slot. @remarks Use East's comparator for these struct keys. */
+export const RosterRequirementsType = DictType(RosterSlotType, RosterRequirementType);
+/**
+ * The durable status of a week.
+ * @remarks Publishing saves the complete week and its status atomically.
+ * @property draft - An editable week
+ * @property published - A read-only week and its publication instant
+ */
+export const RosterStatusType = VariantType({ draft: NullType, published: StructType({ at: DateTimeType }) });
+/**
+ * The single atomic entry in the roster record.
+ * @remarks Assignments, targets, dismissals and publication share one optimistic patch baseline.
+ * @property status - Draft or published
+ * @property assignments - Assignments by stable identifier
+ * @property requirements - Targets by slot
+ * @property dismissed - Proposal identifiers rejected for this week
+ */
+export const RosterWeekType = StructType({
+    status: RosterStatusType, assignments: DictType(StringType, RosterAssignmentType),
+    requirements: RosterRequirementsType, dismissed: SetType(StringType),
+});
+/** Weeks keyed by their first day at UTC midnight. @remarks This is the roster record's stored wire type. */
+export const RosterWeeksType = DictType(DateTimeType, RosterWeekType);
+/**
+ * A skill within a group, or a duty available to every group.
+ * @remarks Keys are unique across all skills and duties.
+ * @property key - Stable identifier
+ * @property label - Display name
+ * @property code - Short code on assignment chips
+ */
+export const RosterSkillType = StructType({ key: StringType, label: StringType, code: StringType });
+/**
+ * A group of people and the skills its work requires.
+ * @remarks The array order controls the grid and library order.
+ * @property key - Stable identifier
+ * @property label - Display name
+ * @property skills - Skills in display order
+ */
+export const RosterGroupType = StructType({ key: StringType, label: StringType, skills: ArrayType(RosterSkillType) });
+/**
+ * A recurring shift's time and nominal hours.
+ * @remarks An end past midnight belongs to the following day; the assignment still belongs to its 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
+ */
+export const RosterShiftType = StructType({
+    key: StringType, label: StringType, code: StringType, start: ScheduleClockType, hours: FloatType,
+});
+/**
+ * A position someone may hold on a shift.
+ * @remarks Position order determines lead ordering in the grid.
+ * @property key - Stable identifier
+ * @property label - Display name
+ * @property code - Chip badge
+ * @property lead - Whether this position satisfies the lead rule
+ */
+export const RosterPositionType = StructType({ key: StringType, label: StringType, code: StringType, lead: BooleanType });
+/**
+ * An agency from which positions may be requested.
+ * @remarks The first agency supplies the suggested open-position fix.
+ * @property key - Stable identifier
+ * @property name - Display name
+ */
+export const RosterAgencyType = StructType({ key: StringType, name: StringType });
+/**
+ * A person resolved from the author's keyed staff data.
+ * @remarks Roster reads staff; all edits go to the weeks record.
+ * @property key - Original staff key
+ * @property name - Display name
+ * @property group - Home group
+ * @property position - Default position
+ * @property skills - Skill keys held
+ * @property contract - Contracted weekly hours
+ * @property agency - Whether this is a named agency worker
+ * @property trainer - Whether this person trains others
+ * @property trainee - Whether this person needs a trainer
+ * @property usual - Usual shift, or none
+ */
+export const RosterPersonType = StructType({
+    key: StringType, name: StringType, group: StringType, position: StringType, skills: SetType(StringType),
+    contract: FloatType, agency: BooleanType, trainer: BooleanType, trainee: BooleanType, usual: OptionType(StringType),
+});
+/**
+ * Built-in checks enabled for the roster.
+ * @remarks Rest reads this week only; double booking is always reported.
+ * @property rest - Minimum hours between shifts; zero disables the rest check
+ * @property lead - Check staffed slots for a lead
+ * @property trainer - Check trainees have a trainer
+ * @property skill - Check activities against held skills
+ * @property agree - Report unagreed changed hours
+ */
+export const RosterRulesType = StructType({ rest: FloatType, lead: BooleanType, trainer: BooleanType, skill: BooleanType, agree: BooleanType });
+/**
+ * Optional costing configuration.
+ * @remarks Omitting costs hides monetary readouts; it does not affect staffing checks.
+ * @property currency - Currency identifier for the shared formatter
+ * @property rates - Permanent, overtime and agency hourly rates
+ * @property budget - Daily budget, or none
+ */
+export const RosterCostsType = StructType({
+    currency: StringType, rates: StructType({ permanent: FloatType, overtime: FloatType, agency: FloatType }), budget: OptionType(FloatType),
+});
+/**
+ * Complete reference data used by coverage and checks.
+ * @remarks Visibility filters never remove people from this context.
+ * @property people - All resolved staff by original key
+ * @property groups - Groups and their skills
+ * @property duties - Activities available to every group
+ * @property shifts - Shift definitions
+ * @property positions - Position definitions
+ * @property agencies - Agencies available for gap fixes
+ * @property rules - Enabled rules
+ * @property costs - Optional monetary configuration
+ */
+export const RosterContextType = StructType({
+    people: DictType(StringType, RosterPersonType), groups: ArrayType(RosterGroupType), duties: ArrayType(RosterSkillType),
+    shifts: ArrayType(RosterShiftType), positions: ArrayType(RosterPositionType), agencies: ArrayType(RosterAgencyType),
+    rules: RosterRulesType, costs: OptionType(RosterCostsType),
+});
+/**
+ * Coverage for one required activity.
+ * @remarks Duties have no holder count or capacity and no skill gap.
+ * @property skill - Skill or duty key
+ * @property needed - Required hours
+ * @property holders - Number of people holding the skill, or none for a duty
+ * @property capacity - Nominal hours available from holders, or none for a duty
+ * @property gap - Positive shortfall in skill capacity
+ * @property assigned - Hours explicitly assigned to this activity
+ */
+export const RosterCoverageLineType = StructType({
+    skill: StringType, needed: FloatType, holders: OptionType(IntegerType), capacity: OptionType(FloatType), gap: FloatType, assigned: FloatType,
+});
+/**
+ * Staffing, work and costs for a complete slot.
+ * @remarks Requests fill positions and contribute requested hours, but never count as named people or skilled holders.
+ * @property positions - Required positions
+ * @property filled - Assignments including requests
+ * @property open - Unfilled positions, at least zero
+ * @property people - Named people assigned
+ * @property hours - Permanent, agency, overtime, requested, needed and total rostered hours
+ * @property lines - Required skills in group order, then duties
+ * @property cost - Total cost, zero when costs are absent
+ * @property lead - A named person holds a lead position
+ * @property trainer - A trainer is assigned
+ */
+export const RosterCoverageType = StructType({
+    positions: IntegerType, filled: IntegerType, open: IntegerType, people: IntegerType,
+    hours: StructType({ permanent: FloatType, agency: FloatType, overtime: FloatType, requested: FloatType, needed: FloatType, rostered: FloatType }),
+    lines: ArrayType(RosterCoverageLineType), cost: FloatType, lead: BooleanType, trainer: BooleanType,
+});
+/**
+ * An externally computed staffing proposal.
+ * @remarks Acceptance creates an assignment; rejection stores this key in the week's dismissed set.
+ * @property key - Proposal identifier
+ * @property week - Week's first day
+ * @property slot - Suggested destination
+ * @property person - Original staff key
+ * @property reason - Explanation presented to the planner
+ */
+export const RosterProposalType = StructType({ key: StringType, week: DateTimeType, slot: RosterSlotType, person: StringType, reason: StringType });
+/**
+ * A corrective action offered for an issue.
+ * @remarks Every data-changing action is one gesture of the shared edit session.
+ * @property request - Request someone from this agency
+ * @property agree - Mark the assignment agreed
+ * @property accept - Accept this proposal key
+ * @property move - Move the assignment to this shift
+ * @property start - Set this start offset in hours
+ * @property find - Show leads, trainers or holders of a skill in the library
+ */
+export const RosterFixType = VariantType({
+    request: StringType, agree: NullType, accept: StringType, move: StringType, start: FloatType,
+    find: VariantType({ leads: NullType, trainers: NullType, skill: StringType }),
+});
+/**
+ * One explanation or warning about the drafted roster.
+ * @remarks Warnings do not introduce a separate validation barrier to Save or Publish.
+ * @property kind - Breach, gap, agreement or proposal
+ * @property tone - Shared semantic tone
+ * @property title - Short explanation
+ * @property detail - Supporting explanation
+ * @property slot - Affected slot, or none
+ * @property assignment - Affected assignment key, or none
+ * @property flag - Short text on a chip, or none
+ * @property fix - Offered action, or none
+ */
+export const RosterIssueType = StructType({
+    kind: VariantType({ breach: NullType, gap: NullType, agree: NullType, proposal: NullType }),
+    tone: StatusTokenType, title: StringType, detail: StringType, slot: OptionType(RosterSlotType),
+    assignment: OptionType(StringType), flag: OptionType(StringType), fix: OptionType(RosterFixType),
+});
+/**
+ * Input to an application's additional roster checks.
+ * @remarks The built-in coverage has already been calculated for the same draft.
+ * @property start - Week's first day
+ * @property week - Drafted week
+ * @property context - Complete reference data
+ * @property coverage - Coverage for every configured slot
+ */
+export const RosterCheckContextType = StructType({ start: DateTimeType, week: RosterWeekType, context: RosterContextType, coverage: DictType(RosterSlotType, RosterCoverageType) });
+//# sourceMappingURL=types.js.map

package/dist/src/roster/types.js.map

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

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

@@ -0,0 +1,66 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/** Project indexed staff windows to their original identities, never a row predicate. */
+import { ArrayType, SetType, StringType, type ExprType, type StructType } from "@elaraai/east";
+/**
+ * Preserve inline key sets and adapt Slice.rows(recordSlice) through shared paging.
+ * Full staff remains a separate input for coverage, costs and validation.
+ * @param input - Original staff keys, or indexed staff windows.
+ * @returns The existing inline set or a source of original keys.
+ */
+export declare function rosterVisibility(input: unknown): {
+    inline: ExprType<SetType<StringType>>;
+    source?: never;
+} | {
+    source: import("@elaraai/east").VariantExpr<{
+        readonly inline: ArrayType<StringType>;
+        readonly paged: StructType<{
+            readonly id: StringType;
+            readonly page: import("@elaraai/east").FunctionType<[import("@elaraai/east").IntegerType, import("@elaraai/east").IntegerType], import("@elaraai/east").OptionType<ArrayType<StringType>>>;
+            readonly total: import("@elaraai/east").FunctionType<[], import("@elaraai/east").OptionType<import("@elaraai/east").IntegerType>>;
+            readonly seek: import("@elaraai/east").OptionType<import("@elaraai/east").FunctionType<[import("@elaraai/east").VariantType<{
+                readonly key: StringType;
+                readonly prefix: StringType;
+                readonly fields: StructType<{
+                    readonly values: ArrayType<StringType>;
+                    readonly prefix: import("@elaraai/east").OptionType<StringType>;
+                }>;
+                readonly range: StructType<{
+                    readonly from: ArrayType<StringType>;
+                    readonly to: ArrayType<StringType>;
+                }>;
+            }>], import("@elaraai/east").OptionType<StructType<{
+                readonly found: import("@elaraai/east").BooleanType;
+                readonly row: import("@elaraai/east").IntegerType;
+                readonly count: import("@elaraai/east").IntegerType;
+            }>>>>;
+        }>;
+        readonly pinned: StructType<{
+            readonly id: StringType;
+            readonly page: import("@elaraai/east").FunctionType<[import("@elaraai/east").IntegerType, import("@elaraai/east").IntegerType], import("@elaraai/east").OptionType<ArrayType<StringType>>>;
+            readonly total: import("@elaraai/east").FunctionType<[], import("@elaraai/east").OptionType<import("@elaraai/east").IntegerType>>;
+            readonly seek: import("@elaraai/east").OptionType<import("@elaraai/east").FunctionType<[import("@elaraai/east").VariantType<{
+                readonly key: StringType;
+                readonly prefix: StringType;
+                readonly fields: StructType<{
+                    readonly values: ArrayType<StringType>;
+                    readonly prefix: import("@elaraai/east").OptionType<StringType>;
+                }>;
+                readonly range: StructType<{
+                    readonly from: ArrayType<StringType>;
+                    readonly to: ArrayType<StringType>;
+                }>;
+            }>], import("@elaraai/east").OptionType<StructType<{
+                readonly found: import("@elaraai/east").BooleanType;
+                readonly row: import("@elaraai/east").IntegerType;
+                readonly count: import("@elaraai/east").IntegerType;
+            }>>>>;
+            readonly revision: import("@elaraai/east").FunctionType<[], import("@elaraai/east").OptionType<StringType>>;
+            readonly refresh: import("@elaraai/east").FunctionType<[import("@elaraai/east").OptionType<StringType>], import("@elaraai/east").NullType>;
+        }>;
+    }>;
+    inline?: never;
+};
+//# sourceMappingURL=visibility.d.ts.map

package/dist/src/roster/visibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visibility.d.ts","sourceRoot":"","sources":["../../../src/roster/visibility.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,yFAAyF;AACzF,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAe,KAAK,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAG5G;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO;YAGL,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQtE"}

package/dist/src/roster/visibility.js

@@ -0,0 +1,25 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/** Project indexed staff windows to their original identities, never a row predicate. */
+import { ArrayType, SetType, StringType, isTypeEqual } from "@elaraai/east";
+import { buildRowSource, resolveRowSource } from "@elaraai/east-ui/internal";
+/**
+ * Preserve inline key sets and adapt Slice.rows(recordSlice) through shared paging.
+ * Full staff remains a separate input for coverage, costs and validation.
+ * @param input - Original staff keys, or indexed staff windows.
+ * @returns The existing inline set or a source of original keys.
+ */
+export function rosterVisibility(input) {
+    const resolved = resolveRowSource(input, "Roster.visiblePeople");
+    if (resolved.kind === "inline" && isTypeEqual(resolved.collectionType, SetType(StringType))) {
+        return { inline: resolved.rows };
+    }
+    if (resolved.kind !== "ordered" || !resolved.pinned || !isTypeEqual(resolved.keyType, StringType)) {
+        throw new Error("Roster.visiblePeople requires a Set of staff keys or Slice.rows of a record Slice with String primary keys");
+    }
+    const source = buildRowSource(resolved, ArrayType(StringType), rows => rows.map((_$, entry) => entry.key));
+    return { source };
+}
+//# sourceMappingURL=visibility.js.map

package/dist/src/roster/visibility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visibility.js","sourceRoot":"","sources":["../../../src/roster/visibility.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,yFAAyF;AACzF,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAkC,MAAM,eAAe,CAAC;AAC5G,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAE7E;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC3C,MAAM,QAAQ,GAAG,gBAAgB,CAAC,KAAK,EAAE,sBAAsB,CAAC,CAAC;IACjE,IAAI,QAAQ,CAAC,IAAI,KAAK,QAAQ,IAAI,WAAW,CAAC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;QAC1F,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAqC,EAAE,CAAC;IACtE,CAAC;IACD,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,CAAC;QAChG,MAAM,IAAI,KAAK,CAAC,4GAA4G,CAAC,CAAC;IAClI,CAAC;IACD,MAAM,MAAM,GAAG,cAAc,CAAC,QAAQ,EAAE,SAAS,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC,EAAE,CACjE,IAAwC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAA2B,CAAC,CAAC,CAAC;IACrG,OAAO,EAAE,MAAM,EAAE,CAAC;AACtB,CAAC"}

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

@@ -0,0 +1,54 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * The keys a large record's day index files an event under (#1218,
+ * `Calendar Spec.md` §3.4): East functions an `e3.recordIndex`'s `keys`
+ * calls, so a builder reads the days in view, and the backlog, through the
+ * index instead of the whole record.
+ *
+ * Times are UTC, as every time a schedule shows is: a day is a UTC day.
+ *
+ * @packageDocumentation
+ */
+import { DateTimeType, OptionType, SetType } from "@elaraai/east";
+/**
+ * The days an event touches: the UTC midnight of every day from its start's
+ * to its end's, leaving out an end that falls exactly on midnight. An event
+ * of no length, or one ending before it starts, touches its start's day.
+ *
+ * @example
+ * ```ts
+ * import { DateTimeType, DictType, East, SetType, StringType, StructType } from "@elaraai/east";
+ * import { Schedule } from "@elaraai/e3-ui";
+ *
+ * const ShiftType = StructType({ title: StringType, start: DateTimeType, end: DateTimeType });
+ *
+ * // A night shift from 22:00 to 06:00 touches two days.
+ * const touched = East.function([], SetType(DateTimeType), ($) => {
+ *     const days = $.const(Schedule.days);
+ *     return days(new Date("2026-10-01T22:00:00Z"), new Date("2026-10-02T06:00:00Z"));
+ * });
+ * ```
+ */
+export declare const scheduleDays: import("@elaraai/east").CallableFunctionExpr<[DateTimeType, DateTimeType], SetType<DateTimeType>>;
+/**
+ * The key a backlog index files a row under: its due date when it has no
+ * start (`none` when it has no due date either), and nothing once it is
+ * scheduled — so the index holds exactly the backlog, ordered by due date.
+ *
+ * @example
+ * ```ts
+ * import { DateTimeType, East, OptionType, SetType, none, some } from "@elaraai/east";
+ * import { Schedule } from "@elaraai/e3-ui";
+ *
+ * // An unscheduled job due on Friday is filed under Friday.
+ * const filed = East.function([], SetType(OptionType(DateTimeType)), ($) => {
+ *     const unscheduled = $.const(Schedule.unscheduled);
+ *     return unscheduled(none, some(new Date("2026-10-02T00:00:00Z")));
+ * });
+ * ```
+ */
+export declare const scheduleUnscheduled: import("@elaraai/east").CallableFunctionExpr<[OptionType<DateTimeType>, OptionType<DateTimeType>], SetType<OptionType<DateTimeType>>>;
+//# sourceMappingURL=days.d.ts.map

package/dist/src/schedule/days.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"days.d.ts","sourceRoot":"","sources":["../../../src/schedule/days.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;GASG;AAEH,OAAO,EAAE,YAAY,EAAQ,UAAU,EAAE,OAAO,EAAe,MAAM,eAAe,CAAC;AAErF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,YAAY,mGAUvB,CAAC;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,mBAAmB,uIAO/B,CAAC"}

package/dist/src/schedule/days.js

@@ -0,0 +1,68 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * The keys a large record's day index files an event under (#1218,
+ * `Calendar Spec.md` §3.4): East functions an `e3.recordIndex`'s `keys`
+ * calls, so a builder reads the days in view, and the backlog, through the
+ * index instead of the whole record.
+ *
+ * Times are UTC, as every time a schedule shows is: a day is a UTC day.
+ *
+ * @packageDocumentation
+ */
+import { DateTimeType, East, OptionType, SetType } from "@elaraai/east";
+/**
+ * The days an event touches: the UTC midnight of every day from its start's
+ * to its end's, leaving out an end that falls exactly on midnight. An event
+ * of no length, or one ending before it starts, touches its start's day.
+ *
+ * @example
+ * ```ts
+ * import { DateTimeType, DictType, East, SetType, StringType, StructType } from "@elaraai/east";
+ * import { Schedule } from "@elaraai/e3-ui";
+ *
+ * const ShiftType = StructType({ title: StringType, start: DateTimeType, end: DateTimeType });
+ *
+ * // A night shift from 22:00 to 06:00 touches two days.
+ * const touched = East.function([], SetType(DateTimeType), ($) => {
+ *     const days = $.const(Schedule.days);
+ *     return days(new Date("2026-10-01T22:00:00Z"), new Date("2026-10-02T06:00:00Z"));
+ * });
+ * ```
+ */
+export const scheduleDays = East.function([DateTimeType, DateTimeType], SetType(DateTimeType), ($, start, end) => {
+    const days = $.let(new Set(), SetType(DateTimeType));
+    const day = $.let(East.DateTime.roundDownDay(start, 1n));
+    $(days.insert(day));
+    $.assign(day, day.addDays(1n));
+    $.while(East.less(day, end), ($) => {
+        $(days.insert(day));
+        $.assign(day, day.addDays(1n));
+    });
+    return days;
+});
+/**
+ * The key a backlog index files a row under: its due date when it has no
+ * start (`none` when it has no due date either), and nothing once it is
+ * scheduled — so the index holds exactly the backlog, ordered by due date.
+ *
+ * @example
+ * ```ts
+ * import { DateTimeType, East, OptionType, SetType, none, some } from "@elaraai/east";
+ * import { Schedule } from "@elaraai/e3-ui";
+ *
+ * // An unscheduled job due on Friday is filed under Friday.
+ * const filed = East.function([], SetType(OptionType(DateTimeType)), ($) => {
+ *     const unscheduled = $.const(Schedule.unscheduled);
+ *     return unscheduled(none, some(new Date("2026-10-02T00:00:00Z")));
+ * });
+ * ```
+ */
+export const scheduleUnscheduled = East.function([OptionType(DateTimeType), OptionType(DateTimeType)], SetType(OptionType(DateTimeType)), ($, start, due) => {
+    const keys = $.let(new Set(), SetType(OptionType(DateTimeType)));
+    $.if(start.hasTag("none"), ($) => { $(keys.insert(due)); });
+    return keys;
+});
+//# sourceMappingURL=days.js.map

package/dist/src/schedule/days.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"days.js","sourceRoot":"","sources":["../../../src/schedule/days.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;GASG;AAEH,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAe,MAAM,eAAe,CAAC;AAErF;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,YAAY,EAAE,YAAY,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;IAC7G,MAAM,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,GAAG,EAAQ,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;IAC3D,MAAM,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;IACzD,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IACpB,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;IAC/B,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE;QAC/B,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACpB,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IACH,OAAO,IAAI,CAAC;AAChB,CAAC,CAAC,CAAC;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC,QAAQ,CAC5C,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,UAAU,CAAC,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,EACvF,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;IACd,MAAM,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,GAAG,EAAgB,EAAE,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAC/E,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5D,OAAO,IAAI,CAAC;AAChB,CAAC,CACJ,CAAC"}