@elaraai/east-ui 1.0.86 → 1.0.87

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

@@ -1,287 +0,0 @@
-/**
- * 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 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). 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, 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, CalendarAggregateType, CalendarScaleType, CalendarTotalsType, CalendarAggregateRowType, CalendarLegendType, CalendarFooterType, } from "./types.js";
-// Re-export types
-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
-        ? East.value(data, ArrayType(CalendarCellType))
-        : mapRows(East.value(data), CalendarCellType, (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),
-                compare: r.compare !== undefined ? some(East.value(r.compare, FloatType)) : none,
-                summary: r.summary !== undefined ? some(r.summary) : none,
-            }, CalendarCellType);
-        });
-    const densityValue = config.density !== undefined
-        ? (typeof config.density === "string"
-            ? East.value(variant(config.density, null), DensityType)
-            : config.density)
-        : undefined;
-    return East.value(variant("Calendar", {
-        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,
-        density: densityValue !== undefined ? some(densityValue) : none,
-        height: config.height !== undefined ? some(config.height) : none,
-        maxHeight: config.maxHeight !== undefined ? some(config.maxHeight) : none,
-        plotGutter: config.plotGutter !== undefined
-            ? some(East.value({
-                left: config.plotGutter.left !== undefined ? some(config.plotGutter.left) : none,
-                right: config.plotGutter.right !== undefined ? some(config.plotGutter.right) : none,
-            }, PlotGutterType))
-            : none,
-    }), UIComponentType);
-}
-/**
- * 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)
- * @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 }),
- *             totals: Calendar.totals(),
- *             footer: Calendar.footer({ legend: true }),
- *         },
- *     ),
- * );
- * ```
- */
-function createCalendar(data, config) {
-    return buildRoot(data, config);
-}
-// ============================================================================
-// Namespace export
-// ============================================================================
-/**
- * Calendar component namespace.
- *
- * @remarks
- * `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 heatmap.
-     *
-     * @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 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`.
-     *
-     * @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`.
-     *
-     * @param options - The totals options ({@link CalendarTotalsOptions})
-     * @returns An East `CalendarTotalsType` value
-     */
-    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.
-         */
-        Calendar: CalendarRootType,
-        /**
-         * A resolved calendar cell.
-         */
-        Cell: CalendarCellType,
-        /**
-         * A cell reference — what `onSelect` / `onAction` receive.
-         */
-        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 +0,0 @@
-{"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

@@ -1,338 +0,0 @@
-/**
- * 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, 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.
- *
- * @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 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 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) */
-    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 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>;
-}>;
-/**
- * Type representing resolved calendar cells.
- */
-export type CalendarCellType = typeof CalendarCellType;
-/**
- * East StructType for the Calendar component.
- *
- * @remarks
- * 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 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 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<{
-    /** 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 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>;
-    }>>;
-    /** 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<{
-        /** Domain minimum */
-        readonly min: FloatType;
-        /** Domain maximum */
-        readonly max: FloatType;
-    }>>;
-    /** 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 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>>;
-    /** Optional density preset (comfortable | compact | condensed); default comfortable */
-    readonly density: OptionType<VariantType<{
-        readonly comfortable: NullType;
-        readonly compact: NullType;
-        readonly condensed: NullType;
-    }>>;
-    /** Shared plot gutter (#147) — pins the day grid to `[left, W−right]` so a Calendar stacked under a Chart lines up; `left` is the week-label column width */
-    readonly plotGutter: OptionType<StructType<{
-        readonly left: OptionType<StringType>;
-        readonly right: OptionType<StringType>;
-    }>>;
-    /** Uniform sizing (#320): bound the calendar; 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>;
-}>;
-/**
- * Type representing the Calendar component.
- */
-export type CalendarRootType = typeof CalendarRootType;
-//# sourceMappingURL=types.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/collections/calendar/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACH,SAAS,EACT,WAAW,EACX,SAAS,EACT,YAAY,EACZ,WAAW,EACX,QAAQ,EACR,UAAU,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACd,MAAM,eAAe,CAAC;AAKvB;;;;;;;;;;GAUG;AACH,eAAO,MAAM,qBAAqB;IAC9B,4CAA4C;;IAE5C,6CAA6C;;IAE7C,2BAA2B;;IAE3B,2BAA2B;;IAE3B,qCAAqC;;EAEvC,CAAC;AAEH,wDAAwD;AACxD,MAAM,MAAM,qBAAqB,GAAG,OAAO,qBAAqB,CAAC;AAEjE,kEAAkE;AAClE,MAAM,MAAM,wBAAwB,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,OAAO,CAAC;AAEhF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iBAAiB;IAC1B,gEAAgE;;IAEhE,kCAAkC;;EAEpC,CAAC;AAEH,kDAAkD;AAClD,MAAM,MAAM,iBAAiB,GAAG,OAAO,iBAAiB,CAAC;AAEzD;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB;IAC3B,qDAAqD;;QAjDrD,4CAA4C;;QAE5C,6CAA6C;;QAE7C,2BAA2B;;QAE3B,2BAA2B;;QAE3B,qCAAqC;;;IA2CrC,+CAA+C;;IAE/C,0DAA0D;;EAE5D,CAAC;AAEH,gDAAgD;AAChD,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,CAAC;AAE3D;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB;IACjC,wDAAwD;;QApExD,4CAA4C;;QAE5C,6CAA6C;;QAE7C,2BAA2B;;QAE3B,2BAA2B;;QAE3B,qCAAqC;;;IA8DrC,sCAAsC;;EAExC,CAAC;AAEH,uDAAuD;AACvD,MAAM,MAAM,wBAAwB,GAAG,OAAO,wBAAwB,CAAC;AAEvE;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB;IAC3B,yCAAyC;;IAEzC,2CAA2C;;EAE7C,CAAC;AAEH,4CAA4C;AAC5C,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,CAAC;AAE3D;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB;IAC3B,oDAAoD;;IAEpD,wDAAwD;;IAExD,6DAA6D;;QAvB7D,yCAAyC;;QAEzC,2CAA2C;;;EAuB7C,CAAC;AAEH,8CAA8C;AAC9C,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,CAAC;AAE3D;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB;IAC5B,2BAA2B;;IAE3B,qCAAqC;;EAEvC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,OAAO,mBAAmB,CAAC;AAE7D;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,gBAAgB;IACzB,mEAAmE;;IAEnE,kDAAkD;;IAElD,oCAAoC;;IAEpC,sCAAsC;;IAEtC,8DAA8D;;IAE9D,wDAAwD;;EAE1D,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,gBAAgB,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,gBAAgB;IACzB,yBAAyB;;QA1CzB,mEAAmE;;QAEnE,kDAAkD;;QAElD,oCAAoC;;QAEpC,sCAAsC;;QAEtC,8DAA8D;;QAE9D,wDAAwD;;;IAkCxD,4DAA4D;;IAE5D,qDAAqD;;QApKrD,gEAAgE;;QAEhE,kCAAkC;;;IAoKlC,qEAAqE;;QAEjE,qBAAqB;;QAErB,qBAAqB;;;IAGzB,wDAAwD;;QA3JxD,qDAAqD;;YAjDrD,4CAA4C;;YAE5C,6CAA6C;;YAE7C,2BAA2B;;YAE3B,2BAA2B;;YAE3B,qCAAqC;;;QA2CrC,+CAA+C;;QAE/C,0DAA0D;;;IAyJ1D,kEAAkE;;QA1IlE,wDAAwD;;YApExD,4CAA4C;;YAE5C,6CAA6C;;YAE7C,2BAA2B;;YAE3B,2BAA2B;;YAE3B,qCAAqC;;;QA8DrC,sCAAsC;;;IA0ItC,mEAAmE;;QAzGnE,oDAAoD;;QAEpD,wDAAwD;;QAExD,6DAA6D;;YAvB7D,yCAAyC;;YAEzC,2CAA2C;;;;IA4H3C,kCAAkC;;IAElC,kEAAkE;;QA3FlE,2BAA2B;;QAE3B,qCAAqC;;;IA2FrC,mCAAmC;;QA7FnC,2BAA2B;;QAE3B,qCAAqC;;;IA6FrC,uFAAuF;;;;;;IAEvF,6JAA6J;;;;;IAE7J,mGAAmG;;IAEnG,qEAAqE;;EAEvE,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,gBAAgB,CAAC"}