@elaraai/east-ui 1.0.4 → 1.0.5

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

@@ -0,0 +1,396 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * `Roster` — people-on-shifts scheduling: a people × days-of-week grid of
+ * shift chips under the shared event-state grammar (committed / proposed /
+ * rejected, with the `model` flavour rendering as a dashed ghost). Takes the
+ * two flat tables a dataset naturally provides — people and shifts — each
+ * with a chart-style field encoding; the factory joins them by person key.
+ * The component owns the week: `days` defaults to Mon–Sun.
+ *
+ * Declares the drag & drop **target** role: `id` + `sources` connect it to
+ * sibling Libraries, and every completed drag (add / move / remove) funnels
+ * through one `onDrag` callback as a `DragEventType` value.
+ *
+ * @packageDocumentation
+ */
+import { type ExprType, type SubtypeExprOrValue, type TypeOf, ArrayType, type FunctionType, IntegerType, type NullType, StringType, StructType } from "@elaraai/east";
+import { UIComponentType } from "../../component.js";
+import { DensityType, type DensityLiteral } from "../../style/interaction.js";
+import { type CellRefType, type DragEventType } from "../../contracts/drag.js";
+import { PlannerStateType } from "../planner/types.js";
+import { RosterModeType, type RosterModeLiteral } from "./types.js";
+export { RosterModeType, type RosterModeLiteral, RosterPersonType, RosterShiftType, RosterRootType, } from "./types.js";
+/**
+ * The struct element type of a `SubtypeExprOrValue<ArrayType<StructType>>`.
+ */
+export type RowElement<T extends SubtypeExprOrValue<ArrayType<StructType>>> = TypeOf<T> extends ArrayType<infer S> ? (S extends StructType ? S : never) : never;
+/**
+ * Fields the `person` mapper returns — one grid row, before defaults.
+ *
+ * @remarks
+ * The mapper returns this plain object or a full
+ * `ExprType<RosterPersonType>` when the row is already resolved.
+ *
+ * @property key - Person identity — the join key shifts reference
+ * @property label - Display name
+ * @property sublabel - Optional muted second line (e.g. target hours)
+ */
+export interface RosterPersonFields {
+    /** Person identity — the join key shifts reference. */
+    key: SubtypeExprOrValue<StringType>;
+    /** Display name. */
+    label: SubtypeExprOrValue<StringType>;
+    /** Optional muted second line (e.g. target hours). */
+    sublabel?: SubtypeExprOrValue<StringType>;
+}
+/**
+ * Fields the `shift` mapper returns — one shift chip, before defaults.
+ *
+ * @remarks
+ * One of `hours` / `label` is required: `hours` resolves to the `${hours}h`
+ * chip text unless `label` overrides it.
+ *
+ * @property key - Stable shift identity
+ * @property person - The person key (join key)
+ * @property day - The day — must name one of `days`
+ * @property hours - Shift length; chips read `${hours}h`
+ * @property label - Explicit chip text (overrides `hours`)
+ * @property state - The audit state (a `PlannerStateType` value)
+ */
+export interface RosterShiftFields {
+    /** Stable shift identity. */
+    key: SubtypeExprOrValue<StringType>;
+    /** The person key (join key). */
+    person: SubtypeExprOrValue<StringType>;
+    /** The day — must name one of `days`. */
+    day: SubtypeExprOrValue<StringType>;
+    /** Shift length; chips read `${hours}h`. */
+    hours?: SubtypeExprOrValue<IntegerType>;
+    /** Explicit chip text (overrides `hours`). */
+    label?: SubtypeExprOrValue<StringType>;
+    /** The audit state (a `PlannerStateType` value). */
+    state: SubtypeExprOrValue<PlannerStateType>;
+}
+/**
+ * Configuration for {@link createRoster}.
+ *
+ * @typeParam P - The people row struct
+ * @typeParam S - The shift row struct
+ * @property id - DnD target identity
+ * @property sources - Library ids accepted for `add` drags (omit = no adds)
+ * @property mode - `published` (default) or `edit`
+ * @property person - People row mapper (omit when rows are already resolved)
+ * @property personHeader - The frozen person column's header
+ * @property shift - Shifts row mapper (omit when rows are already resolved)
+ * @property days - The day columns, in order (defaults to Mon–Sun)
+ * @property density - Optional density
+ * @property summary - Optional status-strip text (dirty / ghost counts)
+ * @property onDrag - Drag funnel — add / move / remove events
+ * @property onSelect - Shift / cell click callback (a drag-grammar cell ref)
+ * @property onAccept - Ghost-shift acceptance callback
+ * @property onAddAt - Empty-cell click callback (edit mode)
+ */
+export interface RosterConfig<P extends StructType, S extends StructType> {
+    /** DnD target identity. */
+    id: string;
+    /** Library ids accepted for `add` drags (omit = no adds). */
+    sources?: string[];
+    /** `published` (default) or `edit`. */
+    mode?: SubtypeExprOrValue<RosterModeType> | RosterModeLiteral;
+    /** People row mapper; omit when `people` is already `ArrayType(Roster.Types.Person)`. */
+    person?: (person: ExprType<P>) => RosterPersonFields;
+    /** The frozen person column's header (defaults to `"Operator"`). */
+    personHeader?: string;
+    /** Shifts row mapper; omit when `shifts` is already `ArrayType(Roster.Types.Shift)`. */
+    shift?: (shift: ExprType<S>) => RosterShiftFields;
+    /** The day columns, in order (defaults to Mon–Sun). */
+    days?: string[];
+    /** Optional density. */
+    density?: SubtypeExprOrValue<DensityType> | DensityLiteral;
+    /** Optional status-strip text (dirty / ghost counts). */
+    summary?: SubtypeExprOrValue<StringType>;
+    /** Drag funnel — add / move / remove events. */
+    onDrag?: SubtypeExprOrValue<FunctionType<[DragEventType], NullType>>;
+    /** Shift / cell click callback (a drag-grammar cell ref). */
+    onSelect?: SubtypeExprOrValue<FunctionType<[CellRefType], NullType>>;
+    /** Ghost-shift acceptance callback. */
+    onAccept?: SubtypeExprOrValue<FunctionType<[CellRefType], NullType>>;
+    /** Empty-cell click callback (edit mode). */
+    onAddAt?: SubtypeExprOrValue<FunctionType<[CellRefType], NullType>>;
+}
+/**
+ * Creates a Roster — people × days-of-week shift scheduling.
+ *
+ * @typeParam P - The people-table input
+ * @typeParam S - The shifts-table input
+ * @param people - The people rows (one grid row each)
+ * @param shifts - The shift rows (joined to people by the encoded person key)
+ * @param config - The Roster configuration ({@link RosterConfig})
+ * @returns An East expression of `UIComponentType`
+ *
+ * @example
+ * ```ts
+ * import { East, variant } from "@elaraai/east";
+ * import { Roster, UIComponentType } from "@elaraai/east-ui";
+ *
+ * const example = East.function([], UIComponentType, _$ =>
+ *     Roster.Root(
+ *         [{ id: "patel", name: "Patel" }],
+ *         [{ id: "p1", person: "patel", day: "Mon", hours: 8n, state: variant("committed", null) }],
+ *         {
+ *             id: "roster-se",
+ *             sources: ["people"],
+ *             mode: "edit",
+ *             person: p => ({ key: p.id, label: p.name }),
+ *             shift: s => ({ key: s.id, person: s.person, day: s.day,
+ *                            hours: s.hours, state: s.state }),
+ *         },
+ *     ),
+ * );
+ * ```
+ */
+declare function createRoster<P extends SubtypeExprOrValue<ArrayType<StructType>>, S extends SubtypeExprOrValue<ArrayType<StructType>>>(people: P, shifts: S, config: RosterConfig<RowElement<P>, RowElement<S>>): ExprType<UIComponentType>;
+/**
+ * Roster component namespace.
+ *
+ * @remarks
+ * `Roster.Root(people, shifts, config)` builds the grid from the two flat
+ * tables; shift states reuse the Planner event-state grammar
+ * (`Roster.Types.State`), so data carries typed `variant(...)` values.
+ */
+export declare const Roster: {
+    /**
+     * Creates a Roster — people × days-of-week shift scheduling with the
+     * drag & drop target role.
+     *
+     * @typeParam P - The people-table input
+     * @typeParam S - The shifts-table input
+     * @param people - The people rows (one grid row each)
+     * @param shifts - The shift rows (joined to people by the encoded person key)
+     * @param config - The Roster configuration ({@link RosterConfig})
+     * @returns An East expression of `UIComponentType`
+     *
+     * @remarks
+     * Published mode renders committed shifts only, pointer-immutable; edit
+     * mode enables drag handles on proposed shifts, empty-cell add, and
+     * ghost acceptance. Cross-row moves arrive as plain `move` events — the
+     * host derives any swap-proposal representation from
+     * `from.row ≠ to.row`.
+     *
+     * @example
+     * ```ts
+     * import { East, variant } from "@elaraai/east";
+     * import { Roster, UIComponentType } from "@elaraai/east-ui";
+     *
+     * const example = East.function([], UIComponentType, _$ =>
+     *     Roster.Root(
+     *         [{ id: "patel", name: "Patel" }],
+     *         [{ id: "p1", person: "patel", day: "Mon", hours: 8n, state: variant("committed", null) }],
+     *         {
+     *             id: "roster-se",
+     *             person: p => ({ key: p.id, label: p.name }),
+     *             shift: s => ({ key: s.id, person: s.person, day: s.day,
+     *                            hours: s.hours, state: s.state }),
+     *         },
+     *     ),
+     * );
+     * ```
+     */
+    readonly Root: typeof createRoster;
+    readonly Types: {
+        /**
+         * East StructType for the Roster component.
+         *
+         * @remarks
+         * Flat resolved tables; the renderer groups shifts into cells by
+         * `person × day`. See {@link RosterRootType} for per-field docs.
+         *
+         * @property id - DnD target identity
+         * @property sources - Library ids accepted for `add` drags
+         * @property mode - `published` or `edit`
+         * @property days - The day columns, in order
+         * @property personHeader - The frozen person column's header
+         * @property people - The grid rows
+         * @property shifts - The shift chips
+         * @property density - Optional density
+         * @property summary - Optional status-strip text
+         * @property onDrag - Drag funnel
+         * @property onSelect - Shift / cell click callback
+         * @property onAccept - Ghost acceptance callback
+         * @property onAddAt - Empty-cell click callback
+         */
+        readonly Roster: StructType<{
+            readonly id: StringType;
+            readonly sources: ArrayType<StringType>;
+            readonly mode: import("@elaraai/east").VariantType<{
+                readonly published: NullType;
+                readonly edit: NullType;
+            }>;
+            readonly days: ArrayType<StringType>;
+            readonly personHeader: StringType;
+            readonly people: ArrayType<StructType<{
+                readonly key: StringType;
+                readonly label: StringType;
+                readonly sublabel: import("@elaraai/east").OptionType<StringType>;
+            }>>;
+            readonly shifts: ArrayType<StructType<{
+                readonly key: StringType;
+                readonly person: StringType;
+                readonly day: StringType;
+                readonly label: StringType;
+                readonly state: import("@elaraai/east").VariantType<{
+                    readonly committed: NullType;
+                    readonly proposed: import("@elaraai/east").VariantType<{
+                        readonly added: NullType;
+                        readonly model: NullType;
+                        readonly removed: NullType;
+                    }>;
+                    readonly rejected: NullType;
+                }>;
+            }>>;
+            readonly density: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
+                readonly comfortable: NullType;
+                readonly compact: NullType;
+                readonly condensed: NullType;
+            }>>;
+            readonly summary: import("@elaraai/east").OptionType<StringType>;
+            readonly onDrag: import("@elaraai/east").OptionType<FunctionType<[import("@elaraai/east").VariantType<{
+                readonly add: StructType<{
+                    readonly from: StructType<{
+                        readonly library: StringType;
+                        readonly key: StringType;
+                    }>;
+                    readonly into: StructType<{
+                        readonly surface: StringType;
+                        readonly row: StringType;
+                        readonly slot: StringType;
+                        readonly event: import("@elaraai/east").OptionType<StringType>;
+                    }>;
+                    readonly duplicate: import("@elaraai/east").BooleanType;
+                }>;
+                readonly move: StructType<{
+                    readonly from: StructType<{
+                        readonly surface: StringType;
+                        readonly row: StringType;
+                        readonly slot: StringType;
+                        readonly event: import("@elaraai/east").OptionType<StringType>;
+                    }>;
+                    readonly to: StructType<{
+                        readonly surface: StringType;
+                        readonly row: StringType;
+                        readonly slot: StringType;
+                        readonly event: import("@elaraai/east").OptionType<StringType>;
+                    }>;
+                }>;
+                readonly remove: StructType<{
+                    readonly from: StructType<{
+                        readonly surface: StringType;
+                        readonly row: StringType;
+                        readonly slot: StringType;
+                        readonly event: import("@elaraai/east").OptionType<StringType>;
+                    }>;
+                    readonly to: import("@elaraai/east").VariantType<{
+                        readonly trash: NullType;
+                        readonly source: NullType;
+                    }>;
+                }>;
+                readonly resize: StructType<{
+                    readonly event: StructType<{
+                        readonly surface: StringType;
+                        readonly row: StringType;
+                        readonly slot: StringType;
+                        readonly event: import("@elaraai/east").OptionType<StringType>;
+                    }>;
+                    readonly edge: import("@elaraai/east").VariantType<{
+                        readonly start: NullType;
+                        readonly end: NullType;
+                    }>;
+                }>;
+            }>], NullType>>;
+            readonly onSelect: import("@elaraai/east").OptionType<FunctionType<[StructType<{
+                readonly surface: StringType;
+                readonly row: StringType;
+                readonly slot: StringType;
+                readonly event: import("@elaraai/east").OptionType<StringType>;
+            }>], NullType>>;
+            readonly onAccept: import("@elaraai/east").OptionType<FunctionType<[StructType<{
+                readonly surface: StringType;
+                readonly row: StringType;
+                readonly slot: StringType;
+                readonly event: import("@elaraai/east").OptionType<StringType>;
+            }>], NullType>>;
+            readonly onAddAt: import("@elaraai/east").OptionType<FunctionType<[StructType<{
+                readonly surface: StringType;
+                readonly row: StringType;
+                readonly slot: StringType;
+                readonly event: import("@elaraai/east").OptionType<StringType>;
+            }>], NullType>>;
+        }>;
+        /**
+         * Roster render mode (`published` / `edit`).
+         *
+         * @property published - Committed-only, pointer-immutable
+         * @property edit - Operator + model proposals are interactive
+         */
+        readonly Mode: import("@elaraai/east").VariantType<{
+            readonly published: NullType;
+            readonly edit: NullType;
+        }>;
+        /**
+         * A resolved roster person (one grid row).
+         *
+         * @property key - Person identity — the join key shifts reference
+         * @property label - Display name
+         * @property sublabel - Optional muted second line
+         */
+        readonly Person: StructType<{
+            readonly key: StringType;
+            readonly label: StringType;
+            readonly sublabel: import("@elaraai/east").OptionType<StringType>;
+        }>;
+        /**
+         * A resolved shift chip.
+         *
+         * @property key - Stable shift identity
+         * @property person - The person key this shift belongs to
+         * @property day - The day column this shift sits in
+         * @property label - The chip text
+         * @property state - The audit state
+         */
+        readonly Shift: StructType<{
+            readonly key: StringType;
+            readonly person: StringType;
+            readonly day: StringType;
+            readonly label: StringType;
+            readonly state: import("@elaraai/east").VariantType<{
+                readonly committed: NullType;
+                readonly proposed: import("@elaraai/east").VariantType<{
+                    readonly added: NullType;
+                    readonly model: NullType;
+                    readonly removed: NullType;
+                }>;
+                readonly rejected: NullType;
+            }>;
+        }>;
+        /**
+         * The shared event-state grammar (committed / proposed / rejected).
+         *
+         * @property committed - A published shift
+         * @property proposed - A proposal (`added` / `model` / `removed`)
+         * @property rejected - A rejected proposal
+         */
+        readonly State: import("@elaraai/east").VariantType<{
+            readonly committed: NullType;
+            readonly proposed: import("@elaraai/east").VariantType<{
+                readonly added: NullType;
+                readonly model: NullType;
+                readonly removed: NullType;
+            }>;
+            readonly rejected: NullType;
+        }>;
+    };
+};
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/src/collections/roster/index.js

@@ -0,0 +1,227 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * `Roster` — people-on-shifts scheduling: a people × days-of-week grid of
+ * shift chips under the shared event-state grammar (committed / proposed /
+ * rejected, with the `model` flavour rendering as a dashed ghost). Takes the
+ * two flat tables a dataset naturally provides — people and shifts — each
+ * with a chart-style field encoding; the factory joins them by person key.
+ * The component owns the week: `days` defaults to Mon–Sun.
+ *
+ * Declares the drag & drop **target** role: `id` + `sources` connect it to
+ * sibling Libraries, and every completed drag (add / move / remove) funnels
+ * through one `onDrag` callback as a `DragEventType` value.
+ *
+ * @packageDocumentation
+ */
+import { East, Expr, variant, some, none, ArrayType, IntegerType, StringType, StructType, } from "@elaraai/east";
+import { UIComponentType } from "../../component.js";
+import { DensityType } from "../../style/interaction.js";
+import {} from "../../contracts/drag.js";
+import { PlannerStateType } from "../planner/types.js";
+import { RosterModeType, RosterPersonType, RosterShiftType, RosterRootType, } from "./types.js";
+// Re-export types
+export { RosterModeType, RosterPersonType, RosterShiftType, RosterRootType, } from "./types.js";
+/** The default week. */
+const WEEK = ["Mon", "Tue", "Wed", "Thu", "Fri", "Sat", "Sun"];
+function buildRoot(people, shifts, config) {
+    const personMapper = config.person;
+    const resolvedPeople = personMapper === undefined
+        ? East.value(people, ArrayType(RosterPersonType))
+        : East.value(people).map((_$, row) => {
+            const r = personMapper(row);
+            if (r instanceof Expr)
+                return East.value(r, RosterPersonType);
+            return East.value({
+                key: r.key,
+                label: r.label,
+                sublabel: r.sublabel !== undefined ? some(r.sublabel) : none,
+            }, RosterPersonType);
+        });
+    const shiftMapper = config.shift;
+    const resolvedShifts = shiftMapper === undefined
+        ? East.value(shifts, ArrayType(RosterShiftType))
+        : East.value(shifts).map((_$, row) => {
+            const r = shiftMapper(row);
+            if (r instanceof Expr)
+                return East.value(r, RosterShiftType);
+            if (r.hours === undefined && r.label === undefined) {
+                throw new Error("Roster shift fields require `hours` or `label`");
+            }
+            return East.value({
+                key: r.key,
+                person: r.person,
+                day: r.day,
+                label: r.label !== undefined
+                    ? r.label
+                    : East.str `${East.value(r.hours, IntegerType)}h`,
+                state: r.state,
+            }, RosterShiftType);
+        });
+    const mode = config.mode !== undefined
+        ? (typeof config.mode === "string" ? East.value(variant(config.mode, null), RosterModeType) : config.mode)
+        : East.value(variant("published", null), RosterModeType);
+    const density = config.density !== undefined
+        ? some(typeof config.density === "string" ? East.value(variant(config.density, null), DensityType) : config.density)
+        : none;
+    return East.value(variant("Roster", {
+        id: config.id,
+        sources: East.value(config.sources ?? [], ArrayType(StringType)),
+        mode,
+        days: East.value(config.days ?? WEEK, ArrayType(StringType)),
+        personHeader: config.personHeader ?? "Operator",
+        people: resolvedPeople,
+        shifts: resolvedShifts,
+        density,
+        summary: config.summary !== undefined ? some(config.summary) : none,
+        onDrag: config.onDrag !== undefined ? some(config.onDrag) : none,
+        onSelect: config.onSelect !== undefined ? some(config.onSelect) : none,
+        onAccept: config.onAccept !== undefined ? some(config.onAccept) : none,
+        onAddAt: config.onAddAt !== undefined ? some(config.onAddAt) : none,
+    }), UIComponentType);
+}
+/**
+ * Creates a Roster — people × days-of-week shift scheduling.
+ *
+ * @typeParam P - The people-table input
+ * @typeParam S - The shifts-table input
+ * @param people - The people rows (one grid row each)
+ * @param shifts - The shift rows (joined to people by the encoded person key)
+ * @param config - The Roster configuration ({@link RosterConfig})
+ * @returns An East expression of `UIComponentType`
+ *
+ * @example
+ * ```ts
+ * import { East, variant } from "@elaraai/east";
+ * import { Roster, UIComponentType } from "@elaraai/east-ui";
+ *
+ * const example = East.function([], UIComponentType, _$ =>
+ *     Roster.Root(
+ *         [{ id: "patel", name: "Patel" }],
+ *         [{ id: "p1", person: "patel", day: "Mon", hours: 8n, state: variant("committed", null) }],
+ *         {
+ *             id: "roster-se",
+ *             sources: ["people"],
+ *             mode: "edit",
+ *             person: p => ({ key: p.id, label: p.name }),
+ *             shift: s => ({ key: s.id, person: s.person, day: s.day,
+ *                            hours: s.hours, state: s.state }),
+ *         },
+ *     ),
+ * );
+ * ```
+ */
+function createRoster(people, shifts, config) {
+    return buildRoot(people, shifts, config);
+}
+// ============================================================================
+// Namespace export
+// ============================================================================
+/**
+ * Roster component namespace.
+ *
+ * @remarks
+ * `Roster.Root(people, shifts, config)` builds the grid from the two flat
+ * tables; shift states reuse the Planner event-state grammar
+ * (`Roster.Types.State`), so data carries typed `variant(...)` values.
+ */
+export const Roster = {
+    /**
+     * Creates a Roster — people × days-of-week shift scheduling with the
+     * drag & drop target role.
+     *
+     * @typeParam P - The people-table input
+     * @typeParam S - The shifts-table input
+     * @param people - The people rows (one grid row each)
+     * @param shifts - The shift rows (joined to people by the encoded person key)
+     * @param config - The Roster configuration ({@link RosterConfig})
+     * @returns An East expression of `UIComponentType`
+     *
+     * @remarks
+     * Published mode renders committed shifts only, pointer-immutable; edit
+     * mode enables drag handles on proposed shifts, empty-cell add, and
+     * ghost acceptance. Cross-row moves arrive as plain `move` events — the
+     * host derives any swap-proposal representation from
+     * `from.row ≠ to.row`.
+     *
+     * @example
+     * ```ts
+     * import { East, variant } from "@elaraai/east";
+     * import { Roster, UIComponentType } from "@elaraai/east-ui";
+     *
+     * const example = East.function([], UIComponentType, _$ =>
+     *     Roster.Root(
+     *         [{ id: "patel", name: "Patel" }],
+     *         [{ id: "p1", person: "patel", day: "Mon", hours: 8n, state: variant("committed", null) }],
+     *         {
+     *             id: "roster-se",
+     *             person: p => ({ key: p.id, label: p.name }),
+     *             shift: s => ({ key: s.id, person: s.person, day: s.day,
+     *                            hours: s.hours, state: s.state }),
+     *         },
+     *     ),
+     * );
+     * ```
+     */
+    Root: createRoster,
+    Types: {
+        /**
+         * East StructType for the Roster component.
+         *
+         * @remarks
+         * Flat resolved tables; the renderer groups shifts into cells by
+         * `person × day`. See {@link RosterRootType} for per-field docs.
+         *
+         * @property id - DnD target identity
+         * @property sources - Library ids accepted for `add` drags
+         * @property mode - `published` or `edit`
+         * @property days - The day columns, in order
+         * @property personHeader - The frozen person column's header
+         * @property people - The grid rows
+         * @property shifts - The shift chips
+         * @property density - Optional density
+         * @property summary - Optional status-strip text
+         * @property onDrag - Drag funnel
+         * @property onSelect - Shift / cell click callback
+         * @property onAccept - Ghost acceptance callback
+         * @property onAddAt - Empty-cell click callback
+         */
+        Roster: RosterRootType,
+        /**
+         * Roster render mode (`published` / `edit`).
+         *
+         * @property published - Committed-only, pointer-immutable
+         * @property edit - Operator + model proposals are interactive
+         */
+        Mode: RosterModeType,
+        /**
+         * A resolved roster person (one grid row).
+         *
+         * @property key - Person identity — the join key shifts reference
+         * @property label - Display name
+         * @property sublabel - Optional muted second line
+         */
+        Person: RosterPersonType,
+        /**
+         * A resolved shift chip.
+         *
+         * @property key - Stable shift identity
+         * @property person - The person key this shift belongs to
+         * @property day - The day column this shift sits in
+         * @property label - The chip text
+         * @property state - The audit state
+         */
+        Shift: RosterShiftType,
+        /**
+         * The shared event-state grammar (committed / proposed / rejected).
+         *
+         * @property committed - A published shift
+         * @property proposed - A proposal (`added` / `model` / `removed`)
+         * @property rejected - A rejected proposal
+         */
+        State: PlannerStateType,
+    },
+};
+//# sourceMappingURL=index.js.map

package/dist/src/collections/roster/index.js.map

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