@elaraai/east-ui 1.0.85 → 1.0.87

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

@@ -1,855 +0,0 @@
-/**
- * Copyright (c) 2025 Elara AI Pty Ltd
- * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
- */
-/**
- * `Board` — the single-day assignment board: an areas × shifts grid where
- * each cell holds multiple people as chips under the shared event-state
- * grammar (committed / proposed / rejected, with the `model` flavour
- * rendering as a dashed ghost). Takes the flat tables a dataset naturally
- * provides — areas, shifts, people, and assignments — each with a
- * chart-style field encoding; the factory joins assignments to people by
- * person key and groups them into cells by `area × shift`. Optional
- * `requirements` add per-cell coverage (`n/required` numerals, open-slot
- * placeholders, under / over tones).
- *
- * 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. The component
- * renders no built-in user-facing copy — every string it shows arrives as
- * data or a prop.
- *
- * @packageDocumentation
- */
-import { type ExprType, type SubtypeExprOrValue, type TypeOf, ArrayType, BooleanType, FunctionType, IntegerType, OptionType, StringType, StructType, NullType } 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 { BoardModeType, type BoardModeLiteral } from "./types.js";
-import { RowRefType, type ReviewConfig } from "../../contracts/review.js";
-export { BoardModeType, type BoardModeLiteral, BoardEntityType, BoardAssignmentType, BoardRequirementType, } from "./types.js";
-/**
- * East StructType for the Board component.
- *
- * @remarks
- * Flat resolved tables — the renderer groups assignments into cells by
- * `area × shift` and joins each to `people` by person key for the chip face.
- * Assignment states reuse the Planner event-state grammar
- * ({@link PlannerStateType}); the `model` flavour renders as the dashed
- * ghost with the acceptance affordance. The component renders no built-in
- * user-facing copy. 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 areaHeader - Optional frozen area column header (none = blank)
- * @property areaWidth - Optional CSS width for the frozen area column
- * @property areas - The grid rows
- * @property shifts - The grid columns (this day's shift types, in order)
- * @property people - The chip directory (faces), joined by person key
- * @property assignments - The person chips (grouped into cells by area × shift)
- * @property requirements - Optional per-cell coverage (none = no coverage chrome)
- * @property density - Optional density
- * @property maxVisible - Optional per-cell chip cap before the `+N` overflow
- * @property summary - Optional status-strip text (open / proposed counts)
- * @property canDrop - Optional IR-level drop veto over synthesized candidate events
- * @property onDrag - Drag funnel — add / move / remove events
- * @property onSelect - Assignment / cell click callback
- * @property onAccept - Ghost-assignment acceptance callback (ONE proposed assignment)
- * @property onAddAt - Open-slot / empty-cell click callback (edit mode)
- * @property review - Optional batch review foot (shared contract, #265)
- */
-export declare const BoardRootType: 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;
-    }>;
-    /** Optional frozen area column header (none = blank) */
-    readonly areaHeader: OptionType<StringType>;
-    /** Optional CSS width for the frozen area column (none = the Planner-consistent 150px) */
-    readonly areaWidth: OptionType<StringType>;
-    /** The grid rows */
-    readonly areas: ArrayType<StructType<{
-        readonly key: StringType;
-        readonly label: StringType;
-        readonly sublabel: OptionType<StringType>;
-    }>>;
-    /** The grid columns (this day's shift types, in order) */
-    readonly shifts: ArrayType<StructType<{
-        readonly key: StringType;
-        readonly label: StringType;
-        readonly sublabel: OptionType<StringType>;
-    }>>;
-    /** The chip directory (faces), joined by person key */
-    readonly people: ArrayType<StructType<{
-        readonly key: StringType;
-        readonly label: StringType;
-        readonly sublabel: OptionType<StringType>;
-    }>>;
-    /** The person chips (grouped into cells by area × shift) */
-    readonly assignments: ArrayType<StructType<{
-        readonly key: StringType;
-        readonly person: StringType;
-        readonly area: StringType;
-        readonly shift: 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 per-cell coverage (none = no coverage chrome) */
-    readonly requirements: OptionType<ArrayType<StructType<{
-        readonly area: StringType;
-        readonly shift: StringType;
-        readonly required: IntegerType;
-    }>>>;
-    /** Optional density */
-    readonly density: OptionType<import("@elaraai/east").VariantType<{
-        readonly comfortable: NullType;
-        readonly compact: NullType;
-        readonly condensed: NullType;
-    }>>;
-    /** Optional per-cell chip cap before the `+N` overflow */
-    readonly maxVisible: OptionType<IntegerType>;
-    /** Uniform sizing (#320): bound the board; 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 (open / proposed counts) */
-    readonly summary: OptionType<StringType>;
-    /** Optional IR-level drop veto — consulted per hovered cell with the
-     *  synthesized candidate event ({@link CanDropFnType} semantics); `false`
-     *  ⇒ the ⊘ invalid stage and the drop is a no-op. Absent ⇒ accept. The
-     *  factory's deprecated `canAssign` sugar compiles into this predicate. */
-    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>>;
-    /** 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>>;
-    /** Assignment / cell click callback */
-    readonly onSelect: OptionType<FunctionType<[StructType<{
-        readonly surface: StringType;
-        readonly row: StringType;
-        readonly slot: StringType;
-        readonly event: OptionType<StringType>;
-    }>], NullType>>;
-    /** Ghost-assignment acceptance callback — resolves ONE proposed
-     *  assignment; `review`'s batch verbs sign off the whole board. The
-     *  interplay is host-owned (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>>;
-    /** Open-slot / 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 batch review foot (#265) — the shared contract's commitBar
-     *  verbs (`onApproveAll` / `onRejectAll` / `onRerun` + `summary`). Board
-     *  is single-day areas × shifts, so v1 renders the FOOT only: the
-     *  per-row fields (`columnLabel`, `onApprove`, `onReject`) are unused
-     *  (a per-area decision column is an epic candidate); the factory warns
-     *  when they are set. */
-    readonly review: OptionType<import("../../contracts/approval.js").ReviewStructType<StructType<{
-        readonly rowIndex: IntegerType;
-    }>, import("@elaraai/east").RecursiveType<import("../../component.js").UIComponentNode>>>;
-}>;
-/**
- * Type representing the Board component.
- */
-export type BoardRootType = typeof BoardRootType;
-/**
- * The struct element type of a `SubtypeExprOrValue<ArrayType<StructType>>`.
- */
-export type BoardRowElement<T extends SubtypeExprOrValue<ArrayType<StructType>>> = TypeOf<T> extends ArrayType<infer S> ? (S extends StructType ? S : never) : never;
-/**
- * Fields the `area` / `shift` / `person` mappers return — one board entity,
- * before defaults.
- *
- * @remarks
- * The mapper returns this plain object or a full
- * `ExprType<BoardEntityType>` when the row is already resolved.
- *
- * @property key - Entity identity — the key assignments reference
- * @property label - Display name
- * @property sublabel - Optional muted second line (e.g. wing, time window, role)
- */
-export interface BoardEntityFields {
-    /** Entity identity — the key assignments reference. */
-    key: SubtypeExprOrValue<StringType>;
-    /** Display name. */
-    label: SubtypeExprOrValue<StringType>;
-    /** Optional muted second line (e.g. wing, time window, role). */
-    sublabel?: SubtypeExprOrValue<StringType>;
-}
-/**
- * Fields the `assignment` mapper returns — one person chip, before defaults.
- *
- * @remarks
- * Carries no display label — the chip face comes from joining `person` to
- * the board's `people` table by key.
- *
- * @property key - Stable assignment identity
- * @property person - The person key (join key into `people`)
- * @property area - The area key — must name one of `areas`
- * @property shift - The shift key — must name one of `shifts`
- * @property state - The audit state (a `PlannerStateType` value)
- */
-export interface BoardAssignmentFields {
-    /** Stable assignment identity. */
-    key: SubtypeExprOrValue<StringType>;
-    /** The person key (join key into `people`). */
-    person: SubtypeExprOrValue<StringType>;
-    /** The area key — must name one of `areas`. */
-    area: SubtypeExprOrValue<StringType>;
-    /** The shift key — must name one of `shifts`. */
-    shift: SubtypeExprOrValue<StringType>;
-    /** The audit state (a `PlannerStateType` value). */
-    state: SubtypeExprOrValue<PlannerStateType>;
-}
-/**
- * Fields the `requirement` mapper returns — one cell's coverage, before
- * defaults.
- *
- * @property area - The area key
- * @property shift - The shift key
- * @property required - Required headcount for the cell
- */
-export interface BoardRequirementFields {
-    /** The area key. */
-    area: SubtypeExprOrValue<StringType>;
-    /** The shift key. */
-    shift: SubtypeExprOrValue<StringType>;
-    /** Required headcount for the cell. */
-    required: SubtypeExprOrValue<IntegerType>;
-}
-/**
- * Configuration for {@link createBoard}.
- *
- * @typeParam A - The areas row struct
- * @typeParam S - The shifts row struct
- * @typeParam P - The people row struct
- * @typeParam X - The assignments 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 area - Areas row mapper (omit when rows are already resolved)
- * @property areaHeader - Optional frozen area column header (omit = blank)
- * @property areaWidth - Optional CSS width for the frozen area column
- * @property shift - Shifts row mapper (omit when rows are already resolved)
- * @property person - People row mapper (omit when rows are already resolved)
- * @property assignment - Assignments row mapper (omit when rows are already resolved)
- * @property requirements - Optional coverage table (omit = no coverage chrome)
- * @property requirement - Requirements row mapper (omit when rows are already resolved)
- * @property density - Optional density
- * @property maxVisible - Optional per-cell chip cap before the `+N` overflow
- * @property summary - Optional status-strip text (open / proposed counts)
- * @property canDrop - Optional IR-level drop veto over synthesized candidate events
- * @property canAssign - Deprecated assignability sugar — compiled into `canDrop`
- * @property onDrag - Drag funnel — add / move / remove events
- * @property onSelect - Assignment / cell click callback (a drag-grammar cell ref)
- * @property onAccept - Ghost-assignment acceptance callback
- * @property onAddAt - Open-slot / empty-cell click callback (edit mode)
- */
-export interface BoardConfig<A extends StructType, S extends StructType, P extends StructType, X extends StructType, R extends StructType = StructType> {
-    /** DnD target identity. */
-    id: string;
-    /** Library ids accepted for `add` drags (omit = no adds). */
-    sources?: string[];
-    /** `published` (default) or `edit`. */
-    mode?: SubtypeExprOrValue<BoardModeType> | BoardModeLiteral;
-    /** Areas row mapper; omit when `areas` is already `ArrayType(Board.Types.Entity)`. */
-    area?: (area: ExprType<A>) => BoardEntityFields;
-    /** Optional frozen area column header (omit = blank — the component bakes in no copy). */
-    areaHeader?: string;
-    /** Optional CSS width for the frozen area column (omit = the Planner-consistent `150px`). */
-    areaWidth?: string;
-    /** Shifts row mapper; omit when `shifts` is already `ArrayType(Board.Types.Entity)`. */
-    shift?: (shift: ExprType<S>) => BoardEntityFields;
-    /** People row mapper; omit when `people` is already `ArrayType(Board.Types.Entity)`. */
-    person?: (person: ExprType<P>) => BoardEntityFields;
-    /** Assignments row mapper; omit when `assignments` is already `ArrayType(Board.Types.Assignment)`. */
-    assignment?: (assignment: ExprType<X>) => BoardAssignmentFields;
-    /** Requirements row mapper; omit when `requirements` is already `ArrayType(Board.Types.Requirement)`. */
-    requirement?: (requirement: ExprType<R>) => BoardRequirementFields;
-    /** 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 per-cell chip cap before the `+N` overflow. */
-    maxVisible?: SubtypeExprOrValue<IntegerType> | number;
-    /** Optional status-strip text (open / proposed counts). */
-    summary?: SubtypeExprOrValue<StringType>;
-    /** 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. When `canAssign` is also given, both must
-     *  allow. */
-    canDrop?: SubtypeExprOrValue<FunctionType<[DragEventType], BooleanType>>;
-    /** Optional assignability predicate `(person, area, shift) => Boolean` — a
-     * `false` verdict renders the invalid-drop treatment (red outline + ⊘)
-     * while dragging and vetoes the drop. Fail-open: a throwing predicate
-     * logs and allows.
-     *
-     * @deprecated Use {@link BoardConfig.canDrop} — `canAssign` is compiled
-     * into a `canDrop` predicate by the factory (an `add`'s person is the
-     * dragged card's key; a `move`'s person is resolved from the authored
-     * assignments by event key, allowing when unresolvable). It will be
-     * removed once hosts migrate. */
-    canAssign?: SubtypeExprOrValue<FunctionType<[StringType, StringType, StringType], BooleanType>>;
-    /** Drag funnel — add / move / remove events. */
-    onDrag?: SubtypeExprOrValue<FunctionType<[DragEventType], NullType>>;
-    /** Assignment / cell click callback (a drag-grammar cell ref). */
-    onSelect?: SubtypeExprOrValue<FunctionType<[CellRefType], NullType>>;
-    /** Ghost-assignment acceptance callback. */
-    onAccept?: SubtypeExprOrValue<FunctionType<[CellRefType], NullType>>;
-    /** Open-slot / empty-cell click callback (edit mode). */
-    onAddAt?: SubtypeExprOrValue<FunctionType<[CellRefType], NullType>>;
-    /** Optional batch review foot (#265) — the shared contract's commitBar
-     *  verbs (`onApproveAll` / `onRejectAll` / `onRerun` + `summary`). Board
-     *  v1 renders the foot only: `columnLabel` / `onApprove` / `onReject`
-     *  are unused (per-area decisions are an epic candidate) and the factory
-     *  warns when set. Ghost `onAccept` is unchanged and complementary. */
-    review?: ReviewConfig<RowRefType>;
-}
-/**
- * Creates a Board — single-day areas × shifts assignment scheduling.
- *
- * @typeParam A - The areas-table input
- * @typeParam S - The shifts-table input
- * @typeParam P - The people-table input
- * @typeParam X - The assignments-table input
- * @param areas - The area rows (one grid row each)
- * @param shifts - The shift rows (one grid column each, in order)
- * @param people - The people rows (chip faces, joined by the encoded person key)
- * @param assignments - The assignment rows (grouped into cells by area × shift)
- * @param config - The Board configuration ({@link BoardConfig})
- * @returns An East expression of `UIComponentType`
- *
- * @example
- * ```ts
- * import { East, variant } from "@elaraai/east";
- * import { Board, UIComponentType } from "@elaraai/east-ui";
- *
- * const example = East.function([], UIComponentType, _$ =>
- *     Board.Root(
- *         [{ id: "icu", name: "ICU" }],
- *         [{ id: "am", name: "AM" }],
- *         [{ id: "patel", name: "Patel, R." }],
- *         [{ id: "x1", personId: "patel", areaId: "icu", shiftId: "am", state: variant("committed", null) }],
- *         {
- *             id: "board-tue",
- *             sources: ["people"],
- *             mode: "edit",
- *             area: a => ({ key: a.id, label: a.name }),
- *             shift: s => ({ key: s.id, label: s.name }),
- *             person: p => ({ key: p.id, label: p.name }),
- *             assignment: x => ({ key: x.id, person: x.personId, area: x.areaId,
- *                                 shift: x.shiftId, state: x.state }),
- *         },
- *     ),
- * );
- * ```
- */
-declare function createBoard<A extends SubtypeExprOrValue<ArrayType<StructType>>, S extends SubtypeExprOrValue<ArrayType<StructType>>, P extends SubtypeExprOrValue<ArrayType<StructType>>, X extends SubtypeExprOrValue<ArrayType<StructType>>, R extends SubtypeExprOrValue<ArrayType<StructType>> = []>(areas: A, shifts: S, people: P, assignments: X, config: BoardConfig<BoardRowElement<A>, BoardRowElement<S>, BoardRowElement<P>, BoardRowElement<X>, BoardRowElement<R>> & {
-    requirements?: R;
-}): ExprType<UIComponentType>;
-/**
- * Board component namespace.
- *
- * @remarks
- * `Board.Root(areas, shifts, people, assignments, config)` builds the
- * single-day grid from the flat tables; assignment states reuse the Planner
- * event-state grammar (`Board.Types.State`), so data carries typed
- * `variant(...)` values.
- */
-export declare const Board: {
-    /**
-     * Creates a Board — single-day areas × shifts assignment scheduling with
-     * the drag & drop target role.
-     *
-     * @typeParam A - The areas-table input
-     * @typeParam S - The shifts-table input
-     * @typeParam P - The people-table input
-     * @typeParam X - The assignments-table input
-     * @param areas - The area rows (one grid row each)
-     * @param shifts - The shift rows (one grid column each, in order)
-     * @param people - The people rows (chip faces, joined by the encoded person key)
-     * @param assignments - The assignment rows (grouped into cells by area × shift)
-     * @param config - The Board configuration ({@link BoardConfig})
-     * @returns An East expression of `UIComponentType`
-     *
-     * @remarks
-     * Published mode renders committed assignments only, pointer-immutable;
-     * edit mode enables drag handles on proposed assignments, open-slot /
-     * empty-cell add, and ghost acceptance. Dropping a person onto a cell
-     * that already holds them is a no-op (the duplicate-person guard); the
-     * same person in different cells is legal — host policy. Cross-area
-     * moves arrive as plain `move` events — the host derives any swap
-     * representation from `from.row ≠ to.row`.
-     *
-     * @example
-     * ```ts
-     * import { East, variant } from "@elaraai/east";
-     * import { Board, UIComponentType } from "@elaraai/east-ui";
-     *
-     * const example = East.function([], UIComponentType, _$ =>
-     *     Board.Root(
-     *         [{ id: "icu", name: "ICU" }],
-     *         [{ id: "am", name: "AM" }],
-     *         [{ id: "patel", name: "Patel, R." }],
-     *         [{ id: "x1", personId: "patel", areaId: "icu", shiftId: "am", state: variant("committed", null) }],
-     *         {
-     *             id: "board-tue",
-     *             area: a => ({ key: a.id, label: a.name }),
-     *             shift: s => ({ key: s.id, label: s.name }),
-     *             person: p => ({ key: p.id, label: p.name }),
-     *             assignment: x => ({ key: x.id, person: x.personId, area: x.areaId,
-     *                                 shift: x.shiftId, state: x.state }),
-     *         },
-     *     ),
-     * );
-     * ```
-     */
-    readonly Root: typeof createBoard;
-    readonly Types: {
-        /**
-         * East StructType for the Board component.
-         *
-         * @remarks
-         * Flat resolved tables; the renderer groups assignments into cells
-         * by `area × shift` and joins each to `people` by person key. See
-         * {@link BoardRootType} for per-field docs.
-         *
-         * @property id - DnD target identity
-         * @property sources - Library ids accepted for `add` drags
-         * @property mode - `published` or `edit`
-         * @property areaHeader - Optional frozen area column header
-         * @property areas - The grid rows
-         * @property shifts - The grid columns, in order
-         * @property people - The chip directory (faces)
-         * @property assignments - The person chips
-         * @property requirements - Optional per-cell coverage
-         * @property density - Optional density
-         * @property maxVisible - Optional per-cell chip cap
-         * @property summary - Optional status-strip text
-         * @property onDrag - Drag funnel
-         * @property onSelect - Assignment / cell click callback
-         * @property onAccept - Ghost acceptance callback
-         * @property onAddAt - Open-slot / empty-cell click callback
-         */
-        readonly Board: 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;
-            }>;
-            /** Optional frozen area column header (none = blank) */
-            readonly areaHeader: OptionType<StringType>;
-            /** Optional CSS width for the frozen area column (none = the Planner-consistent 150px) */
-            readonly areaWidth: OptionType<StringType>;
-            /** The grid rows */
-            readonly areas: ArrayType<StructType<{
-                readonly key: StringType;
-                readonly label: StringType;
-                readonly sublabel: OptionType<StringType>;
-            }>>;
-            /** The grid columns (this day's shift types, in order) */
-            readonly shifts: ArrayType<StructType<{
-                readonly key: StringType;
-                readonly label: StringType;
-                readonly sublabel: OptionType<StringType>;
-            }>>;
-            /** The chip directory (faces), joined by person key */
-            readonly people: ArrayType<StructType<{
-                readonly key: StringType;
-                readonly label: StringType;
-                readonly sublabel: OptionType<StringType>;
-            }>>;
-            /** The person chips (grouped into cells by area × shift) */
-            readonly assignments: ArrayType<StructType<{
-                readonly key: StringType;
-                readonly person: StringType;
-                readonly area: StringType;
-                readonly shift: 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 per-cell coverage (none = no coverage chrome) */
-            readonly requirements: OptionType<ArrayType<StructType<{
-                readonly area: StringType;
-                readonly shift: StringType;
-                readonly required: IntegerType;
-            }>>>;
-            /** Optional density */
-            readonly density: OptionType<import("@elaraai/east").VariantType<{
-                readonly comfortable: NullType;
-                readonly compact: NullType;
-                readonly condensed: NullType;
-            }>>;
-            /** Optional per-cell chip cap before the `+N` overflow */
-            readonly maxVisible: OptionType<IntegerType>;
-            /** Uniform sizing (#320): bound the board; 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 (open / proposed counts) */
-            readonly summary: OptionType<StringType>;
-            /** Optional IR-level drop veto — consulted per hovered cell with the
-             *  synthesized candidate event ({@link CanDropFnType} semantics); `false`
-             *  ⇒ the ⊘ invalid stage and the drop is a no-op. Absent ⇒ accept. The
-             *  factory's deprecated `canAssign` sugar compiles into this predicate. */
-            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>>;
-            /** 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>>;
-            /** Assignment / cell click callback */
-            readonly onSelect: OptionType<FunctionType<[StructType<{
-                readonly surface: StringType;
-                readonly row: StringType;
-                readonly slot: StringType;
-                readonly event: OptionType<StringType>;
-            }>], NullType>>;
-            /** Ghost-assignment acceptance callback — resolves ONE proposed
-             *  assignment; `review`'s batch verbs sign off the whole board. The
-             *  interplay is host-owned (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>>;
-            /** Open-slot / 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 batch review foot (#265) — the shared contract's commitBar
-             *  verbs (`onApproveAll` / `onRejectAll` / `onRerun` + `summary`). Board
-             *  is single-day areas × shifts, so v1 renders the FOOT only: the
-             *  per-row fields (`columnLabel`, `onApprove`, `onReject`) are unused
-             *  (a per-area decision column is an epic candidate); the factory warns
-             *  when they are set. */
-            readonly review: OptionType<import("../../contracts/approval.js").ReviewStructType<StructType<{
-                readonly rowIndex: IntegerType;
-            }>, import("@elaraai/east").RecursiveType<import("../../component.js").UIComponentNode>>>;
-        }>;
-        /** The review configuration — the shared `RowReviewType`; Board v1 renders the batch foot only (#265). */
-        readonly Review: import("../../contracts/approval.js").ReviewStructType<StructType<{
-            readonly rowIndex: IntegerType;
-        }>, import("@elaraai/east").RecursiveType<import("../../component.js").UIComponentNode>>;
-        /**
-         * Board 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 board entity — area row, shift column, or person face.
-         *
-         * @property key - Entity identity — the key assignments reference
-         * @property label - Display name
-         * @property sublabel - Optional muted second line
-         */
-        readonly Entity: StructType<{
-            readonly key: StringType;
-            readonly label: StringType;
-            readonly sublabel: OptionType<StringType>;
-        }>;
-        /**
-         * A resolved assignment — one person chip in one (area, shift) cell.
-         *
-         * @property key - Stable assignment identity
-         * @property person - The person key (joined for the chip face)
-         * @property area - The area key (the grid row)
-         * @property shift - The shift key (the grid column)
-         * @property state - The audit state
-         */
-        readonly Assignment: StructType<{
-            readonly key: StringType;
-            readonly person: StringType;
-            readonly area: StringType;
-            readonly shift: 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;
-            }>;
-        }>;
-        /**
-         * A resolved coverage requirement for one (area, shift) cell.
-         *
-         * @property area - The area key
-         * @property shift - The shift key
-         * @property required - Required headcount for the cell
-         */
-        readonly Requirement: StructType<{
-            readonly area: StringType;
-            readonly shift: StringType;
-            readonly required: IntegerType;
-        }>;
-        /**
-         * The shared event-state grammar (committed / proposed / rejected).
-         *
-         * @property committed - A published assignment
-         * @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