@elaraai/east-ui 1.0.4 → 1.0.6

package/dist/src/collections/blend/types.js

@@ -0,0 +1,168 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+import { ArrayType, BooleanType, FloatType, FunctionType, NullType, OptionType, StringType, StructType, VariantType, } from "@elaraai/east";
+import { PlannerStateType } from "../planner/types.js";
+import { DragEventType } from "../../contracts/drag.js";
+/**
+ * A predicted metric row on a target panel.
+ *
+ * @property key - Metric identity — referenced by the compare `diff` list
+ * @property label - Row label (e.g. `cost / unit`)
+ * @property value - Display text (host-formatted, e.g. `$3.42`)
+ * @property numeric - Optional numeric value — drives the compare Δ column
+ * @property model - Optional trust-chip model id (e.g. `cost-v1.4`)
+ * @property band - Optional confidence band
+ */
+export const BlendMetricType = StructType({
+    /** Metric identity — referenced by the compare `diff` list */
+    key: StringType,
+    /** Row label (e.g. `cost / unit`) */
+    label: StringType,
+    /** Display text (host-formatted, e.g. `$3.42`) */
+    value: StringType,
+    /** Optional numeric value — drives the compare Δ column */
+    numeric: OptionType(FloatType),
+    /** Optional trust-chip model id (e.g. `cost-v1.4`) */
+    model: OptionType(StringType),
+    /** Optional confidence band */
+    band: OptionType(StructType({
+        /** Band minimum */
+        min: FloatType,
+        /** Band maximum */
+        max: FloatType,
+    })),
+});
+/**
+ * One source allocation in a target.
+ *
+ * @property source - Source identity (a Library item key when paired)
+ * @property label - Row label (defaults to the source key)
+ * @property sublabel - Optional muted second line (class / site)
+ * @property amount - Allocated amount, in the target's unit
+ * @property pinned - Excluded from optimise and from drag-out
+ * @property state - The audit state (committed / proposed)
+ */
+export const BlendAllocationType = StructType({
+    /** Source identity (a Library item key when paired) */
+    source: StringType,
+    /** Row label (defaults to the source key) */
+    label: StringType,
+    /** Optional muted second line (class / site) */
+    sublabel: OptionType(StringType),
+    /** Allocated amount, in the target's unit */
+    amount: FloatType,
+    /** Held fixed — excluded from drag-out and from recalculated proposals */
+    pinned: BooleanType,
+    /** The audit state (committed / proposed) */
+    state: PlannerStateType,
+});
+/**
+ * One blend target panel.
+ *
+ * @property key - Target identity (drag-grammar row; action events carry it)
+ * @property label - Panel title (e.g. `BLEND-318a`)
+ * @property capacity - Full capacity, in `unit`
+ * @property unit - Display unit (e.g. `u`, `kL`, `t`)
+ * @property objective - Optional objective line text
+ * @property allocations - The source allocations
+ * @property metrics - Predicted metric rows
+ */
+export const BlendTargetType = StructType({
+    /** Target identity (drag-grammar row; action events carry it) */
+    key: StringType,
+    /** Panel title (e.g. `BLEND-318a`) */
+    label: StringType,
+    /** Full capacity, in `unit` */
+    capacity: FloatType,
+    /** Display unit (e.g. `u`, `kL`, `t`) */
+    unit: StringType,
+    /** Optional objective line text */
+    objective: OptionType(StringType),
+    /** The source allocations */
+    allocations: ArrayType(BlendAllocationType),
+    /** Predicted metric rows */
+    metrics: ArrayType(BlendMetricType),
+});
+/**
+ * A target-panel action.
+ *
+ * @property reset - Revert proposed changes
+ * @property apply - Commit the blend
+ * @property discard - Drop a compare candidate
+ */
+export const BlendActionType = VariantType({
+    /** Revert proposed changes */
+    reset: NullType,
+    /** Commit the blend */
+    apply: NullType,
+    /** Drop a compare candidate */
+    discard: NullType,
+});
+/**
+ * The `onAmountChange` payload.
+ *
+ * @property target - Target key
+ * @property source - Allocation source key
+ * @property amount - The edited amount
+ */
+export const BlendAmountEventType = StructType({
+    /** Target key */
+    target: StringType,
+    /** Allocation source key */
+    source: StringType,
+    /** The edited amount */
+    amount: FloatType,
+});
+/**
+ * The `onAction` payload.
+ *
+ * @property target - The target key, or `none` for surface-wide actions
+ * @property action - Which action fired
+ */
+export const BlendActionEventType = StructType({
+    /** The target key, or `none` for surface-wide actions */
+    target: OptionType(StringType),
+    /** Which action fired */
+    action: BlendActionType,
+});
+/**
+ * East StructType for the Blend component.
+ *
+ * @remarks
+ * The assembly surface for blending / batching decisions — pull amounts
+ * from many sources into one or more targets. One pattern, three render
+ * modes by target count: `single` (1), `compare` (2, with the derived diff
+ * table), `portfolio` (3+, horizontal scroll). Declares the drag & drop
+ * **target** role: `add` from declared Libraries and `remove` back — no
+ * intra-surface `move`.
+ *
+ * @property id - DnD target identity
+ * @property sources - Library ids accepted for `add` drags
+ * @property targets - The target panels (length picks the render mode)
+ * @property diff - Compare mode: metric keys for the foot table (empty = all)
+ * @property verdict - Optional compare verdict line
+ * @property onDrag - Drag funnel — add / remove events
+ * @property onAmountChange - Allocation amount edits
+ * @property onAction - Panel actions (reset / optimise / apply / discard)
+ */
+export const BlendRootType = StructType({
+    /** DnD target identity */
+    id: StringType,
+    /** Library ids accepted for `add` drags */
+    sources: ArrayType(StringType),
+    /** The target panels (length picks the render mode) */
+    targets: ArrayType(BlendTargetType),
+    /** Compare mode: metric keys for the foot table (empty = all) */
+    diff: ArrayType(StringType),
+    /** Optional compare verdict line */
+    verdict: OptionType(StringType),
+    /** Drag funnel — add / remove events */
+    onDrag: OptionType(FunctionType([DragEventType], NullType)),
+    /** Allocation amount edits */
+    onAmountChange: OptionType(FunctionType([BlendAmountEventType], NullType)),
+    /** Panel actions (reset / optimise / apply / discard) */
+    onAction: OptionType(FunctionType([BlendActionEventType], NullType)),
+});
+//# sourceMappingURL=types.js.map

package/dist/src/collections/blend/types.js.map

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

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

@@ -0,0 +1,211 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * `Calendar` — a day-of-week × week grid coloured by intensity (forecast,
+ * demand, OT exposure). **Visualisation only**: clicking drills into a day,
+ * but the Calendar is not part of the Planner family — no events, no
+ * committed/proposed state, no drag & drop. Takes one flat table with a
+ * chart-style field encoding; the component owns the week (columns are
+ * always Mon–Sun).
+ *
+ * @packageDocumentation
+ */
+import { type ExprType, type SubtypeExprOrValue, type TypeOf, ArrayType, FloatType, type FunctionType, type NullType, StringType, StructType } from "@elaraai/east";
+import { UIComponentType } from "../../component.js";
+import { CalendarCellRefType } from "./types.js";
+export { CalendarRootType, CalendarCellType, CalendarCellRefType, } 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 `cell` mapper returns — one (week, day) cell, before defaults.
+ *
+ * @remarks
+ * The mapper returns this plain object or a full
+ * `ExprType<CalendarCellType>` when the row is already resolved.
+ *
+ * @property week - The row's week label (rows appear in first-appearance order)
+ * @property day - The day column — `"Mon"` … `"Sun"`, exact match
+ * @property value - The intensity (drives fill; printed via `text`)
+ * @property text - Optional cell text (defaults to `East.print(value)`)
+ * @property summary - Optional selection-footer text for this day
+ * @property delta - Optional signed change (renders as a pos/neg chip)
+ */
+export interface CalendarCellFields {
+    /** The row's week label (rows appear in first-appearance order). */
+    week: SubtypeExprOrValue<StringType>;
+    /** The day column — `"Mon"` … `"Sun"`, exact match. */
+    day: SubtypeExprOrValue<StringType>;
+    /** The intensity (drives fill; printed via `text`). */
+    value: SubtypeExprOrValue<FloatType>;
+    /** Optional cell text (defaults to `East.print(value)`). */
+    text?: SubtypeExprOrValue<StringType>;
+    /** Optional selection-footer text for this day. */
+    summary?: SubtypeExprOrValue<StringType>;
+    /** Optional signed change (renders as a pos/neg chip). */
+    delta?: SubtypeExprOrValue<FloatType>;
+}
+/**
+ * Configuration for {@link createCalendar}.
+ *
+ * @typeParam R - The day-row struct
+ * @property cell - Cell row mapper (omit when rows are already resolved)
+ * @property legend - Intensity caption (defaults to `low → high`)
+ * @property domain - Optional explicit intensity domain (default: observed min/max)
+ * @property actionLabel - Optional footer-right drill label
+ * @property onAction - Optional drill callback (receives the selected cell)
+ * @property onSelect - Optional cell-click callback
+ */
+export interface CalendarConfig<R extends StructType> {
+    /** Cell row mapper; omit when `data` is already `ArrayType(Calendar.Types.Cell)`. */
+    cell?: (day: ExprType<R>) => CalendarCellFields;
+    /** Intensity caption (defaults to `low → high`). */
+    legend?: SubtypeExprOrValue<StringType>;
+    /** Optional explicit intensity domain (default: observed min/max). */
+    domain?: {
+        min: SubtypeExprOrValue<FloatType>;
+        max: SubtypeExprOrValue<FloatType>;
+    };
+    /** Optional footer-right drill label. */
+    actionLabel?: SubtypeExprOrValue<StringType>;
+    /** Optional drill callback (receives the selected cell). */
+    onAction?: SubtypeExprOrValue<FunctionType<[CalendarCellRefType], NullType>>;
+    /** Optional cell-click callback. */
+    onSelect?: SubtypeExprOrValue<FunctionType<[CalendarCellRefType], NullType>>;
+}
+/**
+ * Creates a Calendar — a day-of-week × week intensity grid.
+ *
+ * @typeParam R - The day-table input
+ * @param data - The day rows (one element per week × day cell; sparse is fine)
+ * @param config - The Calendar configuration ({@link CalendarConfig})
+ * @returns An East expression of `UIComponentType`
+ *
+ * @example
+ * ```ts
+ * import { East } from "@elaraai/east";
+ * import { Calendar, UIComponentType } from "@elaraai/east-ui";
+ *
+ * const example = East.function([], UIComponentType, _$ =>
+ *     Calendar.Root(
+ *         [{ week: "W37", day: "Mon", demand: 102.0 }],
+ *         {
+ *             cell: d => ({ week: d.week, day: d.day, value: d.demand }),
+ *         },
+ *     ),
+ * );
+ * ```
+ */
+declare function createCalendar<T extends SubtypeExprOrValue<ArrayType<StructType>>>(data: T, config: CalendarConfig<RowElement<T>>): ExprType<UIComponentType>;
+/**
+ * Calendar component namespace.
+ *
+ * @remarks
+ * `Calendar.Root(data, config)` builds the grid from one flat day table.
+ * Visualisation only — pair it with a `Slice.Range` in the surrounding
+ * chrome if the time window needs to narrow.
+ */
+export declare const Calendar: {
+    /**
+     * Creates a Calendar — a day-of-week × week intensity grid.
+     *
+     * @typeParam R - The day-table input
+     * @param data - The day rows (one element per week × day cell; sparse is fine)
+     * @param config - The Calendar configuration ({@link CalendarConfig})
+     * @returns An East expression of `UIComponentType`
+     *
+     * @remarks
+     * Cells fill with brand-scale intensity normalised over the visible
+     * values (or the explicit `domain`); missing (week, day) combinations
+     * render the neutral `−` fill. Selecting a cell shows its `summary` /
+     * `delta` in the footer next to the drill `action`.
+     *
+     * @example
+     * ```ts
+     * import { East } from "@elaraai/east";
+     * import { Calendar, UIComponentType } from "@elaraai/east-ui";
+     *
+     * const example = East.function([], UIComponentType, _$ =>
+     *     Calendar.Root(
+     *         [{ week: "W37", day: "Mon", demand: 102.0 }],
+     *         {
+     *             title: "Forecasted demand · SE region",
+     *             cell: d => ({ week: d.week, day: d.day, value: d.demand }),
+     *         },
+     *     ),
+     * );
+     * ```
+     */
+    readonly Root: typeof createCalendar;
+    readonly Types: {
+        /**
+         * East StructType for the Calendar component.
+         *
+         * @remarks
+         * The resolved grid; see {@link CalendarRootType} for per-field docs.
+         *
+         * @property legend - Intensity caption
+         * @property cells - The resolved cells
+         * @property domain - Optional explicit intensity domain
+         * @property actionLabel - Optional footer-right drill label
+         * @property onAction - Optional drill callback
+         * @property onSelect - Optional cell-click callback
+         */
+        readonly Calendar: StructType<{
+            readonly legend: StringType;
+            readonly cells: ArrayType<StructType<{
+                readonly week: StringType;
+                readonly day: StringType;
+                readonly value: FloatType;
+                readonly text: StringType;
+                readonly summary: import("@elaraai/east").OptionType<StringType>;
+                readonly delta: import("@elaraai/east").OptionType<FloatType>;
+            }>>;
+            readonly domain: import("@elaraai/east").OptionType<StructType<{
+                readonly min: FloatType;
+                readonly max: FloatType;
+            }>>;
+            readonly actionLabel: import("@elaraai/east").OptionType<StringType>;
+            readonly onAction: import("@elaraai/east").OptionType<FunctionType<[StructType<{
+                readonly week: StringType;
+                readonly day: StringType;
+            }>], NullType>>;
+            readonly onSelect: import("@elaraai/east").OptionType<FunctionType<[StructType<{
+                readonly week: StringType;
+                readonly day: StringType;
+            }>], NullType>>;
+        }>;
+        /**
+         * A resolved calendar cell.
+         *
+         * @property week - The row's week label
+         * @property day - The day column
+         * @property value - The intensity / printed value
+         * @property text - The cell text
+         * @property summary - Optional selection-footer text
+         * @property delta - Optional signed change
+         */
+        readonly Cell: StructType<{
+            readonly week: StringType;
+            readonly day: StringType;
+            readonly value: FloatType;
+            readonly text: StringType;
+            readonly summary: import("@elaraai/east").OptionType<StringType>;
+            readonly delta: import("@elaraai/east").OptionType<FloatType>;
+        }>;
+        /**
+         * A cell reference — what `onSelect` / `onAction` receive.
+         *
+         * @property week - The row's week label
+         * @property day - The day column
+         */
+        readonly CellRef: StructType<{
+            readonly week: StringType;
+            readonly day: StringType;
+        }>;
+    };
+};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/collections/calendar/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;GASG;AAEH,OAAO,EACH,KAAK,QAAQ,EACb,KAAK,kBAAkB,EACvB,KAAK,MAAM,EAMX,SAAS,EACT,SAAS,EACT,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,UAAU,EACV,UAAU,EACb,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAGH,mBAAmB,EACtB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACH,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,GACtB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,kBAAkB,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,IACtE,MAAM,CAAC,CAAC,CAAC,SAAS,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,UAAU,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC;AAMtF;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,kBAAkB;IAC/B,oEAAoE;IACpE,IAAI,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;IACrC,uDAAuD;IACvD,GAAG,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;IACpC,uDAAuD;IACvD,KAAK,EAAE,kBAAkB,CAAC,SAAS,CAAC,CAAC;IACrC,4DAA4D;IAC5D,IAAI,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;IACtC,mDAAmD;IACnD,OAAO,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;IACzC,0DAA0D;IAC1D,KAAK,CAAC,EAAE,kBAAkB,CAAC,SAAS,CAAC,CAAC;CACzC;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,UAAU;IAChD,qFAAqF;IACrF,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,kBAAkB,CAAC;IAChD,oDAAoD;IACpD,MAAM,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;IACxC,sEAAsE;IACtE,MAAM,CAAC,EAAE;QAAE,GAAG,EAAE,kBAAkB,CAAC,SAAS,CAAC,CAAC;QAAC,GAAG,EAAE,kBAAkB,CAAC,SAAS,CAAC,CAAA;KAAE,CAAC;IACpF,yCAAyC;IACzC,WAAW,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAC7C,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,kBAAkB,CAAC,YAAY,CAAC,CAAC,mBAAmB,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC7E,oCAAoC;IACpC,QAAQ,CAAC,EAAE,kBAAkB,CAAC,YAAY,CAAC,CAAC,mBAAmB,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;CAChF;AAoCD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,iBAAS,cAAc,CAAC,CAAC,SAAS,kBAAkB,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,EACvE,IAAI,EAAE,CAAC,EACP,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GACtC,QAAQ,CAAC,eAAe,CAAC,CAE3B;AAMD;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ;IACjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;;;QAGC;;;;;;;;;;;;WAYG;;;;;;;;;;;;;;;;;;;;;;;;;QAEH;;;;;;;;;WASG;;;;;;;;;QAEH;;;;;WAKG;;;;;;CAGD,CAAC"}

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

@@ -0,0 +1,153 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * `Calendar` — a day-of-week × week grid coloured by intensity (forecast,
+ * demand, OT exposure). **Visualisation only**: clicking drills into a day,
+ * but the Calendar is not part of the Planner family — no events, no
+ * committed/proposed state, no drag & drop. Takes one flat table with a
+ * chart-style field encoding; the component owns the week (columns are
+ * always Mon–Sun).
+ *
+ * @packageDocumentation
+ */
+import { East, Expr, variant, some, none, ArrayType, FloatType, StringType, StructType, } from "@elaraai/east";
+import { UIComponentType } from "../../component.js";
+import { CalendarRootType, CalendarCellType, CalendarCellRefType, } from "./types.js";
+// Re-export types
+export { CalendarRootType, CalendarCellType, CalendarCellRefType, } from "./types.js";
+function buildRoot(data, config) {
+    const cellMapper = config.cell;
+    const cells = cellMapper === undefined
+        ? East.value(data, ArrayType(CalendarCellType))
+        : East.value(data).map((_$, row) => {
+            const r = cellMapper(row);
+            if (r instanceof Expr)
+                return East.value(r, CalendarCellType);
+            const value = East.value(r.value, FloatType);
+            return East.value({
+                week: r.week,
+                day: r.day,
+                value,
+                text: r.text !== undefined ? r.text : East.print(value),
+                summary: r.summary !== undefined ? some(r.summary) : none,
+                delta: r.delta !== undefined ? some(r.delta) : none,
+            }, CalendarCellType);
+        });
+    return East.value(variant("Calendar", {
+        legend: config.legend ?? "low → high",
+        cells,
+        domain: config.domain !== undefined
+            ? some(East.value({ min: config.domain.min, max: config.domain.max }, StructType({ min: FloatType, max: FloatType })))
+            : none,
+        actionLabel: config.actionLabel !== undefined ? some(config.actionLabel) : none,
+        onAction: config.onAction !== undefined ? some(config.onAction) : none,
+        onSelect: config.onSelect !== undefined ? some(config.onSelect) : none,
+    }), UIComponentType);
+}
+/**
+ * Creates a Calendar — a day-of-week × week intensity grid.
+ *
+ * @typeParam R - The day-table input
+ * @param data - The day rows (one element per week × day cell; sparse is fine)
+ * @param config - The Calendar configuration ({@link CalendarConfig})
+ * @returns An East expression of `UIComponentType`
+ *
+ * @example
+ * ```ts
+ * import { East } from "@elaraai/east";
+ * import { Calendar, UIComponentType } from "@elaraai/east-ui";
+ *
+ * const example = East.function([], UIComponentType, _$ =>
+ *     Calendar.Root(
+ *         [{ week: "W37", day: "Mon", demand: 102.0 }],
+ *         {
+ *             cell: d => ({ week: d.week, day: d.day, value: d.demand }),
+ *         },
+ *     ),
+ * );
+ * ```
+ */
+function createCalendar(data, config) {
+    return buildRoot(data, config);
+}
+// ============================================================================
+// Namespace export
+// ============================================================================
+/**
+ * Calendar component namespace.
+ *
+ * @remarks
+ * `Calendar.Root(data, config)` builds the grid from one flat day table.
+ * Visualisation only — pair it with a `Slice.Range` in the surrounding
+ * chrome if the time window needs to narrow.
+ */
+export const Calendar = {
+    /**
+     * Creates a Calendar — a day-of-week × week intensity grid.
+     *
+     * @typeParam R - The day-table input
+     * @param data - The day rows (one element per week × day cell; sparse is fine)
+     * @param config - The Calendar configuration ({@link CalendarConfig})
+     * @returns An East expression of `UIComponentType`
+     *
+     * @remarks
+     * Cells fill with brand-scale intensity normalised over the visible
+     * values (or the explicit `domain`); missing (week, day) combinations
+     * render the neutral `−` fill. Selecting a cell shows its `summary` /
+     * `delta` in the footer next to the drill `action`.
+     *
+     * @example
+     * ```ts
+     * import { East } from "@elaraai/east";
+     * import { Calendar, UIComponentType } from "@elaraai/east-ui";
+     *
+     * const example = East.function([], UIComponentType, _$ =>
+     *     Calendar.Root(
+     *         [{ week: "W37", day: "Mon", demand: 102.0 }],
+     *         {
+     *             title: "Forecasted demand · SE region",
+     *             cell: d => ({ week: d.week, day: d.day, value: d.demand }),
+     *         },
+     *     ),
+     * );
+     * ```
+     */
+    Root: createCalendar,
+    Types: {
+        /**
+         * East StructType for the Calendar component.
+         *
+         * @remarks
+         * The resolved grid; see {@link CalendarRootType} for per-field docs.
+         *
+         * @property legend - Intensity caption
+         * @property cells - The resolved cells
+         * @property domain - Optional explicit intensity domain
+         * @property actionLabel - Optional footer-right drill label
+         * @property onAction - Optional drill callback
+         * @property onSelect - Optional cell-click callback
+         */
+        Calendar: CalendarRootType,
+        /**
+         * A resolved calendar cell.
+         *
+         * @property week - The row's week label
+         * @property day - The day column
+         * @property value - The intensity / printed value
+         * @property text - The cell text
+         * @property summary - Optional selection-footer text
+         * @property delta - Optional signed change
+         */
+        Cell: CalendarCellType,
+        /**
+         * A cell reference — what `onSelect` / `onAction` receive.
+         *
+         * @property week - The row's week label
+         * @property day - The day column
+         */
+        CellRef: CalendarCellRefType,
+    },
+};
+//# sourceMappingURL=index.js.map

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

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

package/dist/src/collections/calendar/types.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+import { ArrayType, FloatType, FunctionType, NullType, OptionType, StringType, StructType } from "@elaraai/east";
+/**
+ * A cell reference on the calendar grid — what `onSelect` receives.
+ *
+ * @property week - The row's week label
+ * @property day - The day column ("Mon" … "Sun")
+ */
+export declare const CalendarCellRefType: StructType<{
+    /** The row's week label */
+    readonly week: StringType;
+    /** The day column ("Mon" … "Sun") */
+    readonly day: StringType;
+}>;
+/**
+ * Type representing calendar cell references.
+ */
+export type CalendarCellRefType = typeof CalendarCellRefType;
+/**
+ * A resolved calendar cell.
+ *
+ * @remarks
+ * One element per (week, day) the data covered; days with no cell render
+ * the neutral `−` fill. `summary` / `delta` are the selection-footer facts
+ * for this day, resolved from the accessors at authoring time.
+ *
+ * @property week - The row's week label (rows appear in first-appearance order)
+ * @property day - The day column ("Mon" … "Sun", exact match)
+ * @property value - The intensity / printed value
+ * @property text - The cell text (formatted value)
+ * @property summary - Optional selection-footer text for this day
+ * @property delta - Optional signed change (renders as a pos/neg chip)
+ */
+export declare const CalendarCellType: StructType<{
+    /** The row's week label (rows appear in first-appearance order) */
+    readonly week: StringType;
+    /** The day column ("Mon" … "Sun", exact match) */
+    readonly day: StringType;
+    /** The intensity / printed value */
+    readonly value: FloatType;
+    /** The cell text (formatted value) */
+    readonly text: StringType;
+    /** Optional selection-footer text for this day */
+    readonly summary: OptionType<StringType>;
+    /** Optional signed change (renders as a pos/neg chip) */
+    readonly delta: OptionType<FloatType>;
+}>;
+/**
+ * Type representing resolved calendar cells.
+ */
+export type CalendarCellType = typeof CalendarCellType;
+/**
+ * East StructType for the Calendar component.
+ *
+ * @remarks
+ * Day-of-week × week grid coloured by intensity — visualisation only: click
+ * drills into a day (`onSelect` / the footer `action`), but there are no
+ * events, no committed/proposed state, and no drag & drop.
+ *
+ * @property legend - Intensity caption (decodes the colour ramp)
+ * @property cells - The resolved cells
+ * @property domain - Optional explicit intensity domain (default: observed min/max)
+ * @property actionLabel - Optional footer-right drill label
+ * @property onAction - Optional footer-right drill callback (receives the selected cell)
+ * @property onSelect - Optional cell-click callback
+ */
+export declare const CalendarRootType: StructType<{
+    /** Intensity caption (decodes the colour ramp) */
+    readonly legend: StringType;
+    /** The resolved cells */
+    readonly cells: ArrayType<StructType<{
+        /** The row's week label (rows appear in first-appearance order) */
+        readonly week: StringType;
+        /** The day column ("Mon" … "Sun", exact match) */
+        readonly day: StringType;
+        /** The intensity / printed value */
+        readonly value: FloatType;
+        /** The cell text (formatted value) */
+        readonly text: StringType;
+        /** Optional selection-footer text for this day */
+        readonly summary: OptionType<StringType>;
+        /** Optional signed change (renders as a pos/neg chip) */
+        readonly delta: OptionType<FloatType>;
+    }>>;
+    /** Optional explicit intensity domain (default: observed min/max) */
+    readonly domain: OptionType<StructType<{
+        /** Domain minimum */
+        readonly min: FloatType;
+        /** Domain maximum */
+        readonly max: FloatType;
+    }>>;
+    /** Optional footer-right drill label */
+    readonly actionLabel: OptionType<StringType>;
+    /** Optional footer-right drill callback (receives the selected cell) */
+    readonly onAction: OptionType<FunctionType<[StructType<{
+        /** The row's week label */
+        readonly week: StringType;
+        /** The day column ("Mon" … "Sun") */
+        readonly day: StringType;
+    }>], NullType>>;
+    /** Optional cell-click callback */
+    readonly onSelect: OptionType<FunctionType<[StructType<{
+        /** The row's week label */
+        readonly week: StringType;
+        /** The day column ("Mon" … "Sun") */
+        readonly day: StringType;
+    }>], NullType>>;
+}>;
+/**
+ * Type representing the Calendar component.
+ */
+export type CalendarRootType = typeof CalendarRootType;
+//# sourceMappingURL=types.d.ts.map

package/dist/src/collections/calendar/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/collections/calendar/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACH,SAAS,EACT,SAAS,EACT,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,UAAU,EACV,UAAU,EACb,MAAM,eAAe,CAAC;AAEvB;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB;IAC5B,2BAA2B;;IAE3B,qCAAqC;;EAEvC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,OAAO,mBAAmB,CAAC;AAE7D;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,gBAAgB;IACzB,mEAAmE;;IAEnE,kDAAkD;;IAElD,oCAAoC;;IAEpC,sCAAsC;;IAEtC,kDAAkD;;IAElD,yDAAyD;;EAE3D,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,gBAAgB,CAAC;AAEvD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,gBAAgB;IACzB,kDAAkD;;IAElD,yBAAyB;;QArCzB,mEAAmE;;QAEnE,kDAAkD;;QAElD,oCAAoC;;QAEpC,sCAAsC;;QAEtC,kDAAkD;;QAElD,yDAAyD;;;IA6BzD,qEAAqE;;QAEjE,qBAAqB;;QAErB,qBAAqB;;;IAGzB,wCAAwC;;IAExC,wEAAwE;;QA3ExE,2BAA2B;;QAE3B,qCAAqC;;;IA2ErC,mCAAmC;;QA7EnC,2BAA2B;;QAE3B,qCAAqC;;;EA6EvC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,gBAAgB,CAAC"}