@elaraai/east-ui 1.0.85 → 1.0.87

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

@@ -1,787 +0,0 @@
-/**
- * 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 BooleanType, FunctionType, IntegerType, NullType, OptionType, StringType, StructType } from "@elaraai/east";
-import { UIComponentType } from "../../component.js";
-import { DensityType, type DensityLiteral } from "../../style/interaction.js";
-import { CellRefType, DragEventType } from "../../contracts/drag.js";
-import { PlannerStateType } from "../../contracts/states.js";
-import { RosterModeType, type RosterModeLiteral } from "./types.js";
-import { ApprovalStateType, RowRefType, type ReviewConfig } from "../../contracts/review.js";
-import { StatusValueType } from "../../feedback/status/types.js";
-export { RosterModeType, type RosterModeLiteral, RosterPersonType, RosterShiftType, } from "./types.js";
-/**
- * East StructType for the Roster component.
- *
- * @remarks
- * Flat resolved tables — the renderer groups shifts into cells by
- * `person × day`. Shift states reuse the Planner event-state grammar
- * ({@link PlannerStateType}); the `model` flavour renders as the dashed
- * ghost with the acceptance affordance. Defined here (not `types.ts`)
- * since #265: the root carries the shared review config, whose `summary`
- * is a `UIComponentType` — `component.ts` mirrors this arm inline with the
- * recursion `node`.
- *
- * @property id - DnD target identity
- * @property sources - Library ids accepted for `add` drags
- * @property mode - `published` (committed-only, immutable) or `edit`
- * @property days - The day columns, in order
- * @property personHeader - The frozen person column's header
- * @property personWidth - Optional CSS width for the frozen person column
- * @property people - The grid rows
- * @property shifts - The shift chips (joined to people by person key)
- * @property density - Optional density
- * @property summary - Optional status-strip text (dirty / ghost counts)
- * @property onDrag - Drag funnel — add / move / remove events
- * @property canDrop - Optional IR-level drop veto over synthesized candidate events
- * @property onSelect - Shift / cell click callback
- * @property onAccept - Ghost-shift acceptance callback (ONE proposed shift)
- * @property onAddAt - Empty-cell click callback (edit mode)
- * @property review - Optional row-level review chrome (shared contract, #265)
- */
-export declare const RosterRootType: StructType<{
-    /** DnD target identity */
-    readonly id: StringType;
-    /** Library ids accepted for `add` drags */
-    readonly sources: ArrayType<StringType>;
-    /** `published` (committed-only, immutable) or `edit` */
-    readonly mode: import("@elaraai/east").VariantType<{
-        readonly published: NullType;
-        readonly edit: NullType;
-    }>;
-    /** The day columns, in order */
-    readonly days: ArrayType<StringType>;
-    /** The frozen person column's header */
-    readonly personHeader: StringType;
-    /** Optional CSS width for the frozen person column (none = the Planner-consistent 150px) */
-    readonly personWidth: OptionType<StringType>;
-    /** The grid rows */
-    readonly people: ArrayType<StructType<{
-        readonly key: StringType;
-        readonly label: StringType;
-        readonly sublabel: OptionType<StringType>;
-        readonly status: OptionType<import("@elaraai/east").VariantType<{
-            readonly success: NullType;
-            readonly warning: NullType;
-            readonly danger: NullType;
-            readonly info: NullType;
-            readonly neutral: NullType;
-        }>>;
-        readonly approval: OptionType<import("@elaraai/east").VariantType<{
-            readonly approved: NullType;
-            readonly pending: NullType;
-            readonly rejected: NullType;
-        }>>;
-    }>>;
-    /** The shift chips (joined to people by person key) */
-    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;
-        }>;
-    }>>;
-    /** Optional density */
-    readonly density: OptionType<import("@elaraai/east").VariantType<{
-        readonly comfortable: NullType;
-        readonly compact: NullType;
-        readonly condensed: NullType;
-    }>>;
-    /** Uniform sizing (#320): bound the grid; it scrolls within. `"fill"` fills the parent box. */
-    readonly height: OptionType<StringType>;
-    /** Uniform sizing (#320): max-height cap; content-sized up to it. */
-    readonly maxHeight: OptionType<StringType>;
-    /** Optional status-strip text (dirty / ghost counts) */
-    readonly summary: OptionType<StringType>;
-    /** Drag funnel — add / move / remove events */
-    readonly onDrag: 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: OptionType<StringType>;
-            }>;
-            readonly duplicate: BooleanType;
-        }>;
-        readonly move: StructType<{
-            readonly from: StructType<{
-                readonly surface: StringType;
-                readonly row: StringType;
-                readonly slot: StringType;
-                readonly event: OptionType<StringType>;
-            }>;
-            readonly to: StructType<{
-                readonly surface: StringType;
-                readonly row: StringType;
-                readonly slot: StringType;
-                readonly event: OptionType<StringType>;
-            }>;
-        }>;
-        readonly remove: StructType<{
-            readonly from: StructType<{
-                readonly surface: StringType;
-                readonly row: StringType;
-                readonly slot: StringType;
-                readonly event: 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: OptionType<StringType>;
-            }>;
-            readonly edge: import("@elaraai/east").VariantType<{
-                readonly start: NullType;
-                readonly end: NullType;
-            }>;
-        }>;
-    }>], NullType>>;
-    /** Optional IR-level drop veto — consulted per hovered cell with the
-     *  synthesized candidate event (`CanDropFnType` semantics); `false`
-     *  ⇒ the ⊘ invalid stage and the drop is a no-op. Absent ⇒ accept. */
-    readonly canDrop: 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: OptionType<StringType>;
-            }>;
-            readonly duplicate: BooleanType;
-        }>;
-        readonly move: StructType<{
-            readonly from: StructType<{
-                readonly surface: StringType;
-                readonly row: StringType;
-                readonly slot: StringType;
-                readonly event: OptionType<StringType>;
-            }>;
-            readonly to: StructType<{
-                readonly surface: StringType;
-                readonly row: StringType;
-                readonly slot: StringType;
-                readonly event: OptionType<StringType>;
-            }>;
-        }>;
-        readonly remove: StructType<{
-            readonly from: StructType<{
-                readonly surface: StringType;
-                readonly row: StringType;
-                readonly slot: StringType;
-                readonly event: 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: OptionType<StringType>;
-            }>;
-            readonly edge: import("@elaraai/east").VariantType<{
-                readonly start: NullType;
-                readonly end: NullType;
-            }>;
-        }>;
-    }>], BooleanType>>;
-    /** Shift / cell click callback */
-    readonly onSelect: OptionType<FunctionType<[StructType<{
-        readonly surface: StringType;
-        readonly row: StringType;
-        readonly slot: StringType;
-        readonly event: OptionType<StringType>;
-    }>], NullType>>;
-    /** Ghost-shift acceptance callback — resolves ONE proposed shift. The
-     *  granularity contract (#265): `onAccept(CellRef)` is the *item*-level
-     *  call; `review.onApprove({ rowIndex })` signs off a LINE. The interplay
-     *  is host-owned — the component reports, the host decides whether
-     *  row-approval implies accepting the row's ghosts (no implicit
-     *  cascading in the component). */
-    readonly onAccept: OptionType<FunctionType<[StructType<{
-        readonly surface: StringType;
-        readonly row: StringType;
-        readonly slot: StringType;
-        readonly event: OptionType<StringType>;
-    }>], NullType>>;
-    /** Empty-cell click callback (edit mode) */
-    readonly onAddAt: OptionType<FunctionType<[StructType<{
-        readonly surface: StringType;
-        readonly row: StringType;
-        readonly slot: StringType;
-        readonly event: OptionType<StringType>;
-    }>], NullType>>;
-    /** Optional row-level review chrome (#265) — the shared contract's
-     *  Decision column + commitBar foot; rows are people. Absent ⇒ a plain
-     *  Roster (people `status`/`approval` are inert). Composes with — does
-     *  not replace — per-tile ghost `onAccept`. */
-    readonly review: OptionType<import("../../contracts/approval.js").ReviewStructType<StructType<{
-        readonly rowIndex: IntegerType;
-    }>, import("@elaraai/east").RecursiveType<import("../../component.js").UIComponentNode>>>;
-}>;
-/**
- * Type representing the Roster component.
- */
-export type RosterRootType = typeof RosterRootType;
-/**
- * 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>;
-    /** Optional per-row status — the quiet dot beside the person (some ⇒
-     *  flagged, none ⇒ clean). Only rendered when `review` is set (#265). */
-    status?: SubtypeExprOrValue<OptionType<StatusValueType>>;
-    /** Optional per-row review decision (see the shared `deriveApproval`
-     *  helper: clean ⇒ approved, flagged ⇒ pending). Only rendered when
-     *  `review` is set (#265). */
-    approval?: SubtypeExprOrValue<OptionType<ApprovalStateType>>;
-}
-/**
- * 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 canDrop - Optional IR-level drop veto over synthesized candidate 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;
-    /** Optional CSS width for the frozen person column (omit = the Planner-consistent `150px`). */
-    personWidth?: 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;
-    /** Uniform sizing (#320): bound the component — a pixel number, `"fill"` (fill the parent box), or a CSS length; the whole component takes this height and scrolls within. */
-    height?: SubtypeExprOrValue<StringType>;
-    /** Uniform sizing (#320): max-height cap — a pixel number or CSS length; content-sized up to it. */
-    maxHeight?: SubtypeExprOrValue<StringType>;
-    /** Optional status-strip text (dirty / ghost counts). */
-    summary?: SubtypeExprOrValue<StringType>;
-    /** Drag funnel — add / move / remove events. */
-    onDrag?: SubtypeExprOrValue<FunctionType<[DragEventType], NullType>>;
-    /** Optional IR-level drop veto — consulted per hovered cell with the
-     *  synthesized candidate event (`CanDropFnType` semantics, see
-     *  `contracts/drag.ts`); `false` ⇒ the ⊘ invalid stage and the drop is a
-     *  no-op. Absent ⇒ accept (the pre-#261 behaviour). */
-    canDrop?: SubtypeExprOrValue<FunctionType<[DragEventType], BooleanType>>;
-    /** 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>>;
-    /** Optional row-level review chrome (#265) — the shared contract's
-     *  Decision column + commitBar foot; rows are people, callbacks receive
-     *  `{ rowIndex }`. Presence is the opt-in. Composes with — does not
-     *  replace — per-tile ghost `onAccept`: accept resolves ONE ghost,
-     *  approve signs off a LINE; the interplay is host-owned. */
-    review?: ReviewConfig<RowRefType>;
-}
-/**
- * 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<{
-            /** DnD target identity */
-            readonly id: StringType;
-            /** Library ids accepted for `add` drags */
-            readonly sources: ArrayType<StringType>;
-            /** `published` (committed-only, immutable) or `edit` */
-            readonly mode: import("@elaraai/east").VariantType<{
-                readonly published: NullType;
-                readonly edit: NullType;
-            }>;
-            /** The day columns, in order */
-            readonly days: ArrayType<StringType>;
-            /** The frozen person column's header */
-            readonly personHeader: StringType;
-            /** Optional CSS width for the frozen person column (none = the Planner-consistent 150px) */
-            readonly personWidth: OptionType<StringType>;
-            /** The grid rows */
-            readonly people: ArrayType<StructType<{
-                readonly key: StringType;
-                readonly label: StringType;
-                readonly sublabel: OptionType<StringType>;
-                readonly status: OptionType<import("@elaraai/east").VariantType<{
-                    readonly success: NullType;
-                    readonly warning: NullType;
-                    readonly danger: NullType;
-                    readonly info: NullType;
-                    readonly neutral: NullType;
-                }>>;
-                readonly approval: OptionType<import("@elaraai/east").VariantType<{
-                    readonly approved: NullType;
-                    readonly pending: NullType;
-                    readonly rejected: NullType;
-                }>>;
-            }>>;
-            /** The shift chips (joined to people by person key) */
-            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;
-                }>;
-            }>>;
-            /** Optional density */
-            readonly density: OptionType<import("@elaraai/east").VariantType<{
-                readonly comfortable: NullType;
-                readonly compact: NullType;
-                readonly condensed: NullType;
-            }>>;
-            /** Uniform sizing (#320): bound the grid; it scrolls within. `"fill"` fills the parent box. */
-            readonly height: OptionType<StringType>;
-            /** Uniform sizing (#320): max-height cap; content-sized up to it. */
-            readonly maxHeight: OptionType<StringType>;
-            /** Optional status-strip text (dirty / ghost counts) */
-            readonly summary: OptionType<StringType>;
-            /** Drag funnel — add / move / remove events */
-            readonly onDrag: 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: OptionType<StringType>;
-                    }>;
-                    readonly duplicate: BooleanType;
-                }>;
-                readonly move: StructType<{
-                    readonly from: StructType<{
-                        readonly surface: StringType;
-                        readonly row: StringType;
-                        readonly slot: StringType;
-                        readonly event: OptionType<StringType>;
-                    }>;
-                    readonly to: StructType<{
-                        readonly surface: StringType;
-                        readonly row: StringType;
-                        readonly slot: StringType;
-                        readonly event: OptionType<StringType>;
-                    }>;
-                }>;
-                readonly remove: StructType<{
-                    readonly from: StructType<{
-                        readonly surface: StringType;
-                        readonly row: StringType;
-                        readonly slot: StringType;
-                        readonly event: 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: OptionType<StringType>;
-                    }>;
-                    readonly edge: import("@elaraai/east").VariantType<{
-                        readonly start: NullType;
-                        readonly end: NullType;
-                    }>;
-                }>;
-            }>], NullType>>;
-            /** Optional IR-level drop veto — consulted per hovered cell with the
-             *  synthesized candidate event (`CanDropFnType` semantics); `false`
-             *  ⇒ the ⊘ invalid stage and the drop is a no-op. Absent ⇒ accept. */
-            readonly canDrop: 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: OptionType<StringType>;
-                    }>;
-                    readonly duplicate: BooleanType;
-                }>;
-                readonly move: StructType<{
-                    readonly from: StructType<{
-                        readonly surface: StringType;
-                        readonly row: StringType;
-                        readonly slot: StringType;
-                        readonly event: OptionType<StringType>;
-                    }>;
-                    readonly to: StructType<{
-                        readonly surface: StringType;
-                        readonly row: StringType;
-                        readonly slot: StringType;
-                        readonly event: OptionType<StringType>;
-                    }>;
-                }>;
-                readonly remove: StructType<{
-                    readonly from: StructType<{
-                        readonly surface: StringType;
-                        readonly row: StringType;
-                        readonly slot: StringType;
-                        readonly event: 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: OptionType<StringType>;
-                    }>;
-                    readonly edge: import("@elaraai/east").VariantType<{
-                        readonly start: NullType;
-                        readonly end: NullType;
-                    }>;
-                }>;
-            }>], BooleanType>>;
-            /** Shift / cell click callback */
-            readonly onSelect: OptionType<FunctionType<[StructType<{
-                readonly surface: StringType;
-                readonly row: StringType;
-                readonly slot: StringType;
-                readonly event: OptionType<StringType>;
-            }>], NullType>>;
-            /** Ghost-shift acceptance callback — resolves ONE proposed shift. The
-             *  granularity contract (#265): `onAccept(CellRef)` is the *item*-level
-             *  call; `review.onApprove({ rowIndex })` signs off a LINE. The interplay
-             *  is host-owned — the component reports, the host decides whether
-             *  row-approval implies accepting the row's ghosts (no implicit
-             *  cascading in the component). */
-            readonly onAccept: OptionType<FunctionType<[StructType<{
-                readonly surface: StringType;
-                readonly row: StringType;
-                readonly slot: StringType;
-                readonly event: OptionType<StringType>;
-            }>], NullType>>;
-            /** Empty-cell click callback (edit mode) */
-            readonly onAddAt: OptionType<FunctionType<[StructType<{
-                readonly surface: StringType;
-                readonly row: StringType;
-                readonly slot: StringType;
-                readonly event: OptionType<StringType>;
-            }>], NullType>>;
-            /** Optional row-level review chrome (#265) — the shared contract's
-             *  Decision column + commitBar foot; rows are people. Absent ⇒ a plain
-             *  Roster (people `status`/`approval` are inert). Composes with — does
-             *  not replace — per-tile ghost `onAccept`. */
-            readonly review: OptionType<import("../../contracts/approval.js").ReviewStructType<StructType<{
-                readonly rowIndex: IntegerType;
-            }>, import("@elaraai/east").RecursiveType<import("../../component.js").UIComponentNode>>>;
-        }>;
-        /** A row's review decision — the shared `ApprovalStateType` (#265). */
-        readonly Approval: import("@elaraai/east").VariantType<{
-            readonly approved: NullType;
-            readonly pending: NullType;
-            readonly rejected: NullType;
-        }>;
-        /** The review configuration — the shared row-granularity `RowReviewType` (#265). */
-        readonly Review: import("../../contracts/approval.js").ReviewStructType<StructType<{
-            readonly rowIndex: IntegerType;
-        }>, import("@elaraai/east").RecursiveType<import("../../component.js").UIComponentNode>>;
-        /** The per-row approve / reject payload — the shared `RowRefType` (`{ rowIndex }`). */
-        readonly ApproveEvent: StructType<{
-            readonly rowIndex: IntegerType;
-        }>;
-        /**
-         * 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: OptionType<StringType>;
-            readonly status: OptionType<import("@elaraai/east").VariantType<{
-                readonly success: NullType;
-                readonly warning: NullType;
-                readonly danger: NullType;
-                readonly info: NullType;
-                readonly neutral: NullType;
-            }>>;
-            readonly approval: OptionType<import("@elaraai/east").VariantType<{
-                readonly approved: NullType;
-                readonly pending: NullType;
-                readonly rejected: NullType;
-            }>>;
-        }>;
-        /**
-         * 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