@elaraai/east-ui 1.0.39 → 1.0.41

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

@@ -3,23 +3,121 @@
  * 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
+ * `Calendar` — a day-of-week × week heatmap coloured by intensity (forecast,
+ * demand, OT exposure). **Visualisation only**: clicking selects/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).
+ * chart-style field encoding; the component owns the week (columns are always
+ * Mon–Sun). Optional chrome — the weekly totals rail, the per-weekday
+ * aggregate row, and the selection footer — is composed with the
+ * `Calendar.*` sub-factories.
  *
  * @packageDocumentation
  */
-import { East, Expr, variant, some, none, ArrayType, FloatType, StringType, StructType, } from "@elaraai/east";
+import { East, Expr, variant, some, none, ArrayType, BooleanType, FloatType, IntegerType, StringType, StructType, } from "@elaraai/east";
 import { UIComponentType } from "../../component.js";
 import { mapRows } from "../../shared/reify.js";
 import { DensityType } from "../../style.js";
 import { PlotGutterType } from "../../shared/plot-gutter.js";
-import { CalendarRootType, CalendarCellType, CalendarCellRefType, } from "./types.js";
+import { CalendarRootType, CalendarCellType, CalendarCellRefType, CalendarAggregateType, CalendarScaleType, CalendarTotalsType, CalendarAggregateRowType, CalendarLegendType, CalendarFooterType, } from "./types.js";
 // Re-export types
-export { CalendarRootType, CalendarCellType, CalendarCellRefType, } from "./types.js";
+export { CalendarRootType, CalendarCellType, CalendarCellRefType, CalendarAggregateType, CalendarScaleType, CalendarTotalsType, CalendarAggregateRowType, CalendarLegendType, CalendarFooterType, } from "./types.js";
+// ============================================================================
+// Sub-factory helpers
+// ============================================================================
+/** Normalise an aggregate literal / expression into a `CalendarAggregateType`. */
+function aggregateValue(agg) {
+    return typeof agg === "string"
+        ? East.value(variant(agg, null), CalendarAggregateType)
+        : agg;
+}
+/**
+ * Builds a heatmap scale — the low→high colour ramp and bucket count that map
+ * a cell value to its fill. Pass the result as `config.scale`.
+ *
+ * @param options - The scale options ({@link CalendarScaleOptions})
+ * @returns An East `CalendarScaleType` value
+ *
+ * @example
+ * ```ts
+ * Calendar.scale({ steps: 6 })
+ * ```
+ */
+function calendarScale(options = {}) {
+    return East.value({
+        ramp: options.ramp !== undefined
+            ? some(East.value(options.ramp, ArrayType(StringType)))
+            : none,
+        steps: options.steps ?? 8n,
+    }, CalendarScaleType);
+}
+/**
+ * Builds the weekly totals rail — a trailing column reducing each week row,
+ * with an optional proportion bar. Pass the result as `config.totals`.
+ * The aggregate vocabulary (`sum` / `mean` / `min` / `max` / `count`) matches
+ * the Table component.
+ *
+ * @param options - The totals options ({@link CalendarTotalsOptions})
+ * @returns An East `CalendarTotalsType` value
+ *
+ * @example
+ * ```ts
+ * Calendar.totals({ aggregate: "sum", label: "Σ wk" })
+ * ```
+ */
+function calendarTotals(options = {}) {
+    return East.value({
+        aggregate: aggregateValue(options.aggregate ?? "sum"),
+        label: options.label ?? "Σ wk",
+        bar: options.bar ?? true,
+    }, CalendarTotalsType);
+}
+/**
+ * Builds the per-weekday aggregate row — a trailing row reducing each weekday
+ * column, pinned under the grid. Pass the result as `config.aggregateRow`.
+ *
+ * @param options - The aggregate-row options ({@link CalendarAggregateRowOptions})
+ * @returns An East `CalendarAggregateRowType` value
+ *
+ * @example
+ * ```ts
+ * Calendar.aggregateRow({ aggregate: "mean", label: "mean" })
+ * ```
+ */
+function calendarAggregateRow(options = {}) {
+    return East.value({
+        aggregate: aggregateValue(options.aggregate ?? "mean"),
+        label: options.label ?? "mean",
+    }, CalendarAggregateRowType);
+}
+/**
+ * Builds the selection footer — the strip shown once a cell is selected,
+ * printing the cell value (labelled `valueLabel`), its `compare` baseline
+ * (labelled `compareLabel`) and a computed delta chip, plus an optional
+ * low→high gradient legend pinned right. Pass the result as `config.footer`.
+ *
+ * @param options - The footer options ({@link CalendarFooterOptions})
+ * @returns An East `CalendarFooterType` value
+ *
+ * @example
+ * ```ts
+ * Calendar.footer({ valueLabel: "predicted", compareLabel: "last yr", legend: true })
+ * ```
+ */
+function calendarFooter(options = {}) {
+    const legend = options.legend;
+    const legendValue = legend === undefined || legend === false
+        ? none
+        : some(East.value({
+            low: (legend === true ? undefined : legend.low) ?? "low",
+            high: (legend === true ? undefined : legend.high) ?? "high",
+        }, CalendarLegendType));
+    return East.value({
+        valueLabel: options.valueLabel ?? "value",
+        compareLabel: options.compareLabel ?? "prev",
+        legend: legendValue,
+    }, CalendarFooterType);
+}
 function buildRoot(data, config) {
     const cellMapper = config.cell;
     const cells = cellMapper === undefined
@@ -34,8 +132,8 @@ function buildRoot(data, config) {
                 day: r.day,
                 value,
                 text: r.text !== undefined ? r.text : East.print(value),
+                compare: r.compare !== undefined ? some(East.value(r.compare, FloatType)) : none,
                 summary: r.summary !== undefined ? some(r.summary) : none,
-                delta: r.delta !== undefined ? some(r.delta) : none,
             }, CalendarCellType);
         });
     const densityValue = config.density !== undefined
@@ -44,11 +142,15 @@ function buildRoot(data, config) {
             : config.density)
         : undefined;
     return East.value(variant("Calendar", {
-        legend: config.legend ?? "",
         cells,
+        values: config.values ?? true,
+        scale: config.scale !== undefined ? some(East.value(config.scale, CalendarScaleType)) : none,
         domain: config.domain !== undefined
             ? some(East.value({ min: config.domain.min, max: config.domain.max }, StructType({ min: FloatType, max: FloatType })))
             : none,
+        totals: config.totals !== undefined ? some(East.value(config.totals, CalendarTotalsType)) : none,
+        aggregateRow: config.aggregateRow !== undefined ? some(East.value(config.aggregateRow, CalendarAggregateRowType)) : none,
+        footer: config.footer !== undefined ? some(East.value(config.footer, CalendarFooterType)) : 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,
@@ -64,7 +166,7 @@ function buildRoot(data, config) {
     }), UIComponentType);
 }
 /**
- * Creates a Calendar — a day-of-week × week intensity grid.
+ * Creates a Calendar — a day-of-week × week intensity heatmap.
  *
  * @typeParam R - The day-table input
  * @param data - The day rows (one element per week × day cell; sparse is fine)
@@ -81,6 +183,8 @@ function buildRoot(data, config) {
  *         [{ week: "W37", day: "Mon", demand: 102.0 }],
  *         {
  *             cell: d => ({ week: d.week, day: d.day, value: d.demand }),
+ *             totals: Calendar.totals(),
+ *             footer: Calendar.footer({ legend: true }),
  *         },
  *     ),
  * );
@@ -96,13 +200,16 @@ function createCalendar(data, config) {
  * 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.
+ * `Calendar.Root(data, config)` builds the heatmap from one flat day table.
+ * Compose the optional chrome with the sub-factories: `Calendar.scale` (the
+ * colour ramp), `Calendar.totals` (the weekly rail), `Calendar.aggregateRow`
+ * (the per-weekday row), and `Calendar.footer` (the selection footer + legend).
+ * 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.
+     * Creates a Calendar — a day-of-week × week intensity heatmap.
      *
      * @typeParam R - The day-table input
      * @param data - The day rows (one element per week × day cell; sparse is fine)
@@ -110,61 +217,71 @@ export const Calendar = {
      * @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`.
+     * Cells fill with the heatmap ramp normalised over the visible values (or
+     * the explicit `domain`); missing (week, day) combinations render the
+     * neutral hatched fill. Selecting a cell shows its details in the footer.
+     */
+    Root: createCalendar,
+    /**
+     * Builds a heatmap scale — the low→high colour ramp and bucket count.
+     * Pass the result as `config.scale`.
      *
-     * @example
-     * ```ts
-     * import { East } from "@elaraai/east";
-     * import { Calendar, UIComponentType } from "@elaraai/east-ui";
+     * @param options - The scale options ({@link CalendarScaleOptions})
+     * @returns An East `CalendarScaleType` value
+     */
+    scale: calendarScale,
+    /**
+     * Builds the weekly totals rail (per-row aggregation) — a trailing column
+     * with an optional proportion bar. Pass the result as `config.totals`.
      *
-     * 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 }),
-     *         },
-     *     ),
-     * );
-     * ```
+     * @param options - The totals options ({@link CalendarTotalsOptions})
+     * @returns An East `CalendarTotalsType` value
      */
-    Root: createCalendar,
+    totals: calendarTotals,
+    /**
+     * Builds the per-weekday aggregate row (per-column aggregation). Pass the
+     * result as `config.aggregateRow`.
+     *
+     * @param options - The aggregate-row options ({@link CalendarAggregateRowOptions})
+     * @returns An East `CalendarAggregateRowType` value
+     */
+    aggregateRow: calendarAggregateRow,
+    /**
+     * Builds the selection footer (value / compare / delta + legend). Pass the
+     * result as `config.footer`.
+     *
+     * @param options - The footer options ({@link CalendarFooterOptions})
+     * @returns An East `CalendarFooterType` value
+     */
+    footer: calendarFooter,
     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,
+        /** The aggregate reduction vocabulary (sum / mean / min / max / count). */
+        Aggregate: CalendarAggregateType,
+        /** The heatmap scale (ramp / steps). */
+        Scale: CalendarScaleType,
+        /** The weekly totals rail. */
+        Totals: CalendarTotalsType,
+        /** The per-weekday aggregate row. */
+        AggregateRow: CalendarAggregateRowType,
+        /** The selection footer. */
+        Footer: CalendarFooterType,
+        /** The heatmap legend. */
+        Legend: CalendarLegendType,
     },
 };
 //# sourceMappingURL=index.js.map

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

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

@@ -2,7 +2,147 @@
  * 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";
+import { ArrayType, BooleanType, FloatType, FunctionType, IntegerType, NullType, OptionType, StringType, StructType, VariantType } from "@elaraai/east";
+/**
+ * A reduction applied across a calendar row (the weekly totals rail) or
+ * column (the aggregate row). Mirrors the Table component's aggregate
+ * vocabulary so the two collections stay consistent.
+ *
+ * @property sum - Numeric sum of the member cell values
+ * @property mean - Numeric mean of the member cell values
+ * @property min - Minimum member value
+ * @property max - Maximum member value
+ * @property count - Number of member cells present
+ */
+export declare const CalendarAggregateType: VariantType<{
+    /** Numeric sum of the member cell values */
+    readonly sum: NullType;
+    /** Numeric mean of the member cell values */
+    readonly mean: NullType;
+    /** Minimum member value */
+    readonly min: NullType;
+    /** Maximum member value */
+    readonly max: NullType;
+    /** Number of member cells present */
+    readonly count: NullType;
+}>;
+/** Type representing a calendar aggregate reduction. */
+export type CalendarAggregateType = typeof CalendarAggregateType;
+/** String-literal shorthand for {@link CalendarAggregateType}. */
+export type CalendarAggregateLiteral = "sum" | "mean" | "min" | "max" | "count";
+/**
+ * The heatmap colour scale — how a cell value maps to a fill.
+ *
+ * @remarks
+ * `ramp` is a low→high list of CSS colours; when absent the renderer uses
+ * the built-in eight-step teal ramp (theme-aware — it flips to a bright-on-
+ * dark ramp in dark mode). `steps` buckets the domain (default the ramp
+ * length). The intensity domain lives on the root as `domain`.
+ *
+ * @property ramp - Optional low→high colour list (absent = the default ramp)
+ * @property steps - Number of intensity buckets
+ */
+export declare const CalendarScaleType: StructType<{
+    /** Optional low→high colour list (absent = the default ramp) */
+    readonly ramp: OptionType<ArrayType<StringType>>;
+    /** Number of intensity buckets */
+    readonly steps: IntegerType;
+}>;
+/** Type representing a calendar heatmap scale. */
+export type CalendarScaleType = typeof CalendarScaleType;
+/**
+ * The weekly totals rail — a trailing column that reduces each week row and
+ * (optionally) shows a proportion bar against the largest total.
+ *
+ * @property aggregate - The reduction applied across each week's cells
+ * @property label - The rail's column header (e.g. `"Σ wk"`)
+ * @property bar - Whether to draw the proportion bar under each total
+ */
+export declare const CalendarTotalsType: StructType<{
+    /** The reduction applied across each week's cells */
+    readonly aggregate: VariantType<{
+        /** Numeric sum of the member cell values */
+        readonly sum: NullType;
+        /** Numeric mean of the member cell values */
+        readonly mean: NullType;
+        /** Minimum member value */
+        readonly min: NullType;
+        /** Maximum member value */
+        readonly max: NullType;
+        /** Number of member cells present */
+        readonly count: NullType;
+    }>;
+    /** The rail's column header (e.g. `"Σ wk"`) */
+    readonly label: StringType;
+    /** Whether to draw the proportion bar under each total */
+    readonly bar: BooleanType;
+}>;
+/** Type representing the weekly totals rail. */
+export type CalendarTotalsType = typeof CalendarTotalsType;
+/**
+ * The aggregate row — a trailing row that reduces each weekday column
+ * (e.g. the per-weekday mean), pinned under the grid with a top rule.
+ *
+ * @property aggregate - The reduction applied across each weekday's cells
+ * @property label - The row's label (e.g. `"mean"`)
+ */
+export declare const CalendarAggregateRowType: StructType<{
+    /** The reduction applied across each weekday's cells */
+    readonly aggregate: VariantType<{
+        /** Numeric sum of the member cell values */
+        readonly sum: NullType;
+        /** Numeric mean of the member cell values */
+        readonly mean: NullType;
+        /** Minimum member value */
+        readonly min: NullType;
+        /** Maximum member value */
+        readonly max: NullType;
+        /** Number of member cells present */
+        readonly count: NullType;
+    }>;
+    /** The row's label (e.g. `"mean"`) */
+    readonly label: StringType;
+}>;
+/** Type representing the per-weekday aggregate row. */
+export type CalendarAggregateRowType = typeof CalendarAggregateRowType;
+/**
+ * The footer's low→high gradient legend that decodes the heatmap ramp.
+ *
+ * @property low - The low-end caption (e.g. `"low"`)
+ * @property high - The high-end caption (e.g. `"high"`)
+ */
+export declare const CalendarLegendType: StructType<{
+    /** The low-end caption (e.g. `"low"`) */
+    readonly low: StringType;
+    /** The high-end caption (e.g. `"high"`) */
+    readonly high: StringType;
+}>;
+/** Type representing the heatmap legend. */
+export type CalendarLegendType = typeof CalendarLegendType;
+/**
+ * The selection footer — shown once a cell is selected. Reads the selected
+ * cell's `value` (labelled `valueLabel`) and, when present, its `compare`
+ * baseline (labelled `compareLabel`) plus the computed delta chip.
+ *
+ * @property valueLabel - Label for the cell value (e.g. `"predicted"`)
+ * @property compareLabel - Label for the compare baseline (e.g. `"last yr"`)
+ * @property legend - Optional low→high gradient legend, pinned footer-right
+ */
+export declare const CalendarFooterType: StructType<{
+    /** Label for the cell value (e.g. `"predicted"`) */
+    readonly valueLabel: StringType;
+    /** Label for the compare baseline (e.g. `"last yr"`) */
+    readonly compareLabel: StringType;
+    /** Optional low→high gradient legend, pinned footer-right */
+    readonly legend: OptionType<StructType<{
+        /** The low-end caption (e.g. `"low"`) */
+        readonly low: StringType;
+        /** The high-end caption (e.g. `"high"`) */
+        readonly high: StringType;
+    }>>;
+}>;
+/** Type representing the selection footer. */
+export type CalendarFooterType = typeof CalendarFooterType;
 /**
  * A cell reference on the calendar grid — what `onSelect` receives.
  *
@@ -24,15 +164,16 @@ export type CalendarCellRefType = typeof CalendarCellRefType;
  *
  * @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.
+ * the neutral hatched fill. `compare` is the footer's baseline (last year /
+ * forecast) — when present the footer prints it and a computed delta chip;
+ * `summary` is optional extra footer text.
  *
  * @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)
+ * @property compare - Optional baseline for the footer delta (e.g. last year)
+ * @property summary - Optional extra selection-footer text for this day
  */
 export declare const CalendarCellType: StructType<{
     /** The row's week label (rows appear in first-appearance order) */
@@ -43,10 +184,10 @@ export declare const CalendarCellType: StructType<{
     readonly value: FloatType;
     /** The cell text (formatted value) */
     readonly text: StringType;
-    /** Optional selection-footer text for this day */
+    /** Optional baseline for the footer delta (e.g. last year) */
+    readonly compare: OptionType<FloatType>;
+    /** Optional extra 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.
@@ -56,21 +197,25 @@ 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.
+ * Day-of-week × week heatmap coloured by intensity — visualisation only:
+ * clicking selects/drills a day (`onSelect` / the footer `action`), but
+ * there are no events, no committed/proposed state, and no drag & drop.
+ * Optional chrome: the weekly `totals` rail, the per-weekday `aggregateRow`,
+ * and the selection `footer` (with its gradient legend).
  *
- * @property legend - Intensity caption (decodes the colour ramp)
  * @property cells - The resolved cells
+ * @property values - Whether the numeric value is printed inside each cell
+ * @property scale - Optional heatmap scale override (ramp / steps)
  * @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 totals - Optional weekly totals rail (per-row aggregation)
+ * @property aggregateRow - Optional per-weekday aggregate row (per-column aggregation)
+ * @property footer - Optional selection footer (value / compare / delta + legend)
+ * @property actionLabel - Optional footer drill label
+ * @property onAction - Optional footer drill callback (receives the selected cell)
  * @property onSelect - Optional cell-click callback
  * @property density - Optional density preset (comfortable | compact | condensed)
  */
 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) */
@@ -81,10 +226,19 @@ export declare const CalendarRootType: StructType<{
         readonly value: FloatType;
         /** The cell text (formatted value) */
         readonly text: StringType;
-        /** Optional selection-footer text for this day */
+        /** Optional baseline for the footer delta (e.g. last year) */
+        readonly compare: OptionType<FloatType>;
+        /** Optional extra selection-footer text for this day */
         readonly summary: OptionType<StringType>;
-        /** Optional signed change (renders as a pos/neg chip) */
-        readonly delta: OptionType<FloatType>;
+    }>>;
+    /** Whether the numeric value is printed inside each cell */
+    readonly values: BooleanType;
+    /** Optional heatmap scale override (ramp / steps) */
+    readonly scale: OptionType<StructType<{
+        /** Optional low→high colour list (absent = the default ramp) */
+        readonly ramp: OptionType<ArrayType<StringType>>;
+        /** Number of intensity buckets */
+        readonly steps: IntegerType;
     }>>;
     /** Optional explicit intensity domain (default: observed min/max) */
     readonly domain: OptionType<StructType<{
@@ -93,9 +247,61 @@ export declare const CalendarRootType: StructType<{
         /** Domain maximum */
         readonly max: FloatType;
     }>>;
-    /** Optional footer-right drill label */
+    /** Optional weekly totals rail (per-row aggregation) */
+    readonly totals: OptionType<StructType<{
+        /** The reduction applied across each week's cells */
+        readonly aggregate: VariantType<{
+            /** Numeric sum of the member cell values */
+            readonly sum: NullType;
+            /** Numeric mean of the member cell values */
+            readonly mean: NullType;
+            /** Minimum member value */
+            readonly min: NullType;
+            /** Maximum member value */
+            readonly max: NullType;
+            /** Number of member cells present */
+            readonly count: NullType;
+        }>;
+        /** The rail's column header (e.g. `"Σ wk"`) */
+        readonly label: StringType;
+        /** Whether to draw the proportion bar under each total */
+        readonly bar: BooleanType;
+    }>>;
+    /** Optional per-weekday aggregate row (per-column aggregation) */
+    readonly aggregateRow: OptionType<StructType<{
+        /** The reduction applied across each weekday's cells */
+        readonly aggregate: VariantType<{
+            /** Numeric sum of the member cell values */
+            readonly sum: NullType;
+            /** Numeric mean of the member cell values */
+            readonly mean: NullType;
+            /** Minimum member value */
+            readonly min: NullType;
+            /** Maximum member value */
+            readonly max: NullType;
+            /** Number of member cells present */
+            readonly count: NullType;
+        }>;
+        /** The row's label (e.g. `"mean"`) */
+        readonly label: StringType;
+    }>>;
+    /** Optional selection footer (value / compare / delta + legend) */
+    readonly footer: OptionType<StructType<{
+        /** Label for the cell value (e.g. `"predicted"`) */
+        readonly valueLabel: StringType;
+        /** Label for the compare baseline (e.g. `"last yr"`) */
+        readonly compareLabel: StringType;
+        /** Optional low→high gradient legend, pinned footer-right */
+        readonly legend: OptionType<StructType<{
+            /** The low-end caption (e.g. `"low"`) */
+            readonly low: StringType;
+            /** The high-end caption (e.g. `"high"`) */
+            readonly high: StringType;
+        }>>;
+    }>>;
+    /** Optional footer drill label */
     readonly actionLabel: OptionType<StringType>;
-    /** Optional footer-right drill callback (receives the selected cell) */
+    /** Optional footer drill callback (receives the selected cell) */
     readonly onAction: OptionType<FunctionType<[StructType<{
         /** The row's week label */
         readonly week: StringType;
@@ -110,7 +316,7 @@ export declare const CalendarRootType: StructType<{
         readonly day: StringType;
     }>], NullType>>;
     /** Optional density preset (comfortable | compact | condensed); default comfortable */
-    readonly density: OptionType<import("@elaraai/east").VariantType<{
+    readonly density: OptionType<VariantType<{
         readonly comfortable: NullType;
         readonly compact: NullType;
         readonly condensed: NullType;

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

@@ -1 +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;AAKvB;;;;;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;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,gBAAgB;IACzB,kDAAkD;;IAElD,yBAAyB;;QAtCzB,mEAAmE;;QAEnE,kDAAkD;;QAElD,oCAAoC;;QAEpC,sCAAsC;;QAEtC,kDAAkD;;QAElD,yDAAyD;;;IA8BzD,qEAAqE;;QAEjE,qBAAqB;;QAErB,qBAAqB;;;IAGzB,wCAAwC;;IAExC,wEAAwE;;QA5ExE,2BAA2B;;QAE3B,qCAAqC;;;IA4ErC,mCAAmC;;QA9EnC,2BAA2B;;QAE3B,qCAAqC;;;IA8ErC,uFAAuF;;;;;;IAEvF,6JAA6J;;;;;IAE7J,mGAAmG;;IAEnG,qEAAqE;;EAEvE,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,gBAAgB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/collections/calendar/types.ts"],"names":[],"mappings":"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"}