@wheelhouse/ui 0.2.1 → 0.2.3

package/dist/blocks/date-selector/date-selector-value.d.ts

@@ -0,0 +1,81 @@
+import { type DateSelectorFilterType, type DateSelectorI18nConfig, type DateSelectorPeriodType, type DateSelectorRollingUnit, type DateSelectorSelectionMode, type DateSelectorValue, type FormatDateValueOptions } from './date-selector-types';
+/** Compact US-style day display (`4/18/26`): rolling day spans, tooltips, and dense UIs such as the date-metric filter bar. */
+export declare const DATE_SELECTOR_COMPACT_DAY_FORMAT = "M/d/yy";
+export declare function resolveRollingCount(value: DateSelectorValue): number | undefined;
+export declare function resolveRollingUnit(value: DateSelectorValue): DateSelectorRollingUnit;
+/**
+ * Short rolling label only (no calendar parenthetical, no day span) for compact bars when detail is shown in a tooltip.
+ */
+export declare function getRollingBarShortLabel(value: DateSelectorValue, i18n?: DateSelectorI18nConfig): string | null;
+/**
+ * Human-readable rolling preset title for compact summaries. **Rolling year** presets with bounds use
+ * `Next Year (2027)` / `Last Year (2025)`; **rolling month** inner text uses calendar-relative months, e.g.
+ * `Next Month (May 2026)`, `Last Month (March 2026)`; multi-month uses a span, e.g. `Next 6 Months (May 2026 - Oct 2026)`.
+ */
+export declare function getRollingSummaryLabel(value: DateSelectorValue, i18n?: DateSelectorI18nConfig): string | null;
+/**
+ * Inclusive calendar bounds for rolling presets. **Days:** “next N” / “last N” are the N calendar days **after** today /
+ * **before** today (today excluded). **Months** use month boundaries (last span can include today through end of day).
+ * **Years:** “last” / “next” use **full calendar years**
+ * adjacent to the current year (`last` → prior year(s), `next` → following year(s)), not partial ranges from today.
+ * **Quarters:** same pattern using calendar quarters adjacent to the current quarter.
+ */
+export declare function computeRollingPresetRange(mode: 'rolling-next' | 'rolling-last', unit: DateSelectorRollingUnit, count: number, now?: Date): {
+    startDate: Date;
+    endDate: Date;
+};
+/**
+ * Computes inclusive calendar date bounds for rolling day windows. “Next N” is the N days **after** today (exclusive of
+ * today). “Last N” is the N days **before** today (exclusive of today).
+ */
+export declare function computeRollingDateRange(mode: 'rolling-next' | 'rolling-last', days: number, now?: Date): {
+    startDate: Date;
+    endDate: Date;
+};
+/**
+ * Calendar detail for any rolling preset — for tooltips when the bar uses {@link getRollingBarShortLabel} only.
+ * Uses `value` bounds when present, otherwise {@link computeRollingPresetRange}.
+ * Rolling **day** spans always use compact `M/d/yy` (e.g. `4/18/26`); the `dayDateFormat` argument is reserved for API compatibility and ignored for that unit.
+ */
+export declare function formatRollingRangeTooltipDetail(value: DateSelectorValue, i18n?: DateSelectorI18nConfig, 
+/** @deprecated Ignored for rolling days; day tooltips use compact `M/d/yy`. Kept for call-site compatibility. */
+_dayDateFormat?: string): string | null;
+/**
+ * Formats a {@link DateSelectorValue} for display using the same rules as the selector’s summary text.
+ */
+export declare function formatDateValue(value: DateSelectorValue, i18n?: DateSelectorI18nConfig, dayDateFormat?: string, options?: FormatDateValueOptions): string;
+/** Stable fingerprint for a {@link DateSelectorValue} (for sync keys and onChange deduplication). */
+export declare function dateSelectorDataKey(value: DateSelectorValue | undefined): string;
+export declare function computeStateSyncKey(value: DateSelectorValue | undefined, presetMode: DateSelectorFilterType | undefined, defaultFilterType: DateSelectorFilterType, validDefaultPeriodType: DateSelectorPeriodType): string;
+/** Full local UI state for {@link useDateSelector} (calendar month / hover are not part of {@link DateSelectorValue}). */
+export interface DateSelectorInternalState {
+    periodType: DateSelectorPeriodType;
+    filterType: DateSelectorFilterType;
+    selectedDate: Date | undefined;
+    selectedEndDate: Date | undefined;
+    calendarMonth: Date;
+    selectedYear: number | undefined;
+    selectedMonth: number | undefined;
+    selectedQuarter: number | undefined;
+    rangeStart: {
+        year: number;
+        value: number;
+    } | undefined;
+    rangeEnd: {
+        year: number;
+        value: number;
+    } | undefined;
+    hoverDate: Date | undefined;
+    selectionMode: DateSelectorSelectionMode;
+    rollingUnit: DateSelectorRollingUnit;
+    rollingCount: number | undefined;
+}
+export declare function createInitialInternalState(value: DateSelectorValue | undefined, validDefaultPeriodType: DateSelectorPeriodType, defaultFilterType: DateSelectorFilterType, presetMode: DateSelectorFilterType | undefined): DateSelectorInternalState;
+export declare function buildRollingValueFromState(selectionMode: DateSelectorSelectionMode, rollingUnit: DateSelectorRollingUnit, rollingCount: number | undefined): DateSelectorValue | undefined;
+export declare function buildCurrentValueFromInternal(s: DateSelectorInternalState, presetMode: DateSelectorFilterType | undefined): DateSelectorValue;
+/** Combined UI state + last emitted value fingerprint for `onChange` deduplication. */
+export interface DateSelectorHookState {
+    internal: DateSelectorInternalState;
+    lastEmittedDataKey: string;
+}
+//# sourceMappingURL=date-selector-value.d.ts.map

package/dist/blocks/date-selector/date-selector-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-selector-value.d.ts","sourceRoot":"","sources":["../../../src/blocks/date-selector/date-selector-value.ts"],"names":[],"mappings":"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"}

package/dist/blocks/date-selector/date-selector-value.js

@@ -0,0 +1,423 @@
+import { addDays, addMonths, addQuarters, addYears, endOfDay, endOfMonth, endOfQuarter, endOfYear, format, getQuarter, startOfDay, startOfMonth, startOfQuarter, startOfYear, subDays, subMonths, subQuarters, subYears, } from 'date-fns';
+import { DATE_SELECTOR_ROLLING_DAY_OPTIONS, DEFAULT_DATE_SELECTOR_I18N, } from './date-selector-types';
+/** Compact US-style day display (`4/18/26`): rolling day spans, tooltips, and dense UIs such as the date-metric filter bar. */
+export const DATE_SELECTOR_COMPACT_DAY_FORMAT = 'M/d/yy';
+export function resolveRollingCount(value) {
+    return value.rollingCount ?? value.rollingDays;
+}
+export function resolveRollingUnit(value) {
+    return value.rollingUnit ?? 'day';
+}
+/**
+ * Inner text for rolling month chips. Count 1: the single target calendar month. Multiple months: `May 2026 - Oct 2026`
+ * style range (first–last month in the preset, {@link monthsShort}).
+ */
+function formatRollingMonthInnerLabel(startDate, endDate, mode, count, i18n) {
+    const full = (d) => `${i18n.months[d.getMonth()]} ${d.getFullYear()}`;
+    const short = (d) => `${i18n.monthsShort[d.getMonth()]} ${d.getFullYear()}`;
+    if (count === 1) {
+        if (mode === 'rolling-last') {
+            return full(subMonths(startOfMonth(endDate), 1));
+        }
+        return full(addMonths(startOfMonth(startDate), 1));
+    }
+    if (mode === 'rolling-next') {
+        const anchor = startOfMonth(startDate);
+        const first = addMonths(anchor, 1);
+        const last = addMonths(anchor, count);
+        return `${short(first)} - ${short(last)}`;
+    }
+    const anchorLast = startOfMonth(endDate);
+    const first = subMonths(anchorLast, count);
+    const last = subMonths(anchorLast, 1);
+    return `${short(first)} - ${short(last)}`;
+}
+function formatRollingQuarterSpan(startDate, endDate, i18n) {
+    const qLabel = (d) => `${i18n.quarters[getQuarter(d) - 1]} ${d.getFullYear()}`;
+    if (getQuarter(startDate) === getQuarter(endDate) && startDate.getFullYear() === endDate.getFullYear()) {
+        return qLabel(startDate);
+    }
+    return `${qLabel(startDate)} - ${qLabel(endDate)}`;
+}
+/**
+ * Short rolling label only (no calendar parenthetical, no day span) for compact bars when detail is shown in a tooltip.
+ */
+export function getRollingBarShortLabel(value, i18n = DEFAULT_DATE_SELECTOR_I18N) {
+    const { selectionMode } = value;
+    const count = resolveRollingCount(value);
+    if ((selectionMode !== 'rolling-next' && selectionMode !== 'rolling-last') || count === undefined)
+        return null;
+    const unit = resolveRollingUnit(value);
+    const isNext = selectionMode === 'rolling-next';
+    if (unit === 'month') {
+        if (count === 1)
+            return isNext ? i18n.rollingSummaryNextSingleMonth : i18n.rollingSummaryLastSingleMonth;
+        return (isNext ? i18n.rollingSummaryNextMonths : i18n.rollingSummaryLastMonths).replace('{{count}}', String(count));
+    }
+    if (unit === 'year') {
+        if (count === 1)
+            return isNext ? i18n.rollingSummaryNextYear : i18n.rollingSummaryLastYear;
+        return (isNext ? i18n.rollingSummaryNextYears : i18n.rollingSummaryLastYears).replace('{{count}}', String(count));
+    }
+    if (unit === 'quarter') {
+        if (count === 1)
+            return isNext ? i18n.rollingSummaryNextQuarter : i18n.rollingSummaryLastQuarter;
+        return (isNext ? i18n.rollingSummaryNextQuarters : i18n.rollingSummaryLastQuarters).replace('{{count}}', String(count));
+    }
+    return (isNext ? i18n.rollingSummaryNext : i18n.rollingSummaryLast).replace('{{count}}', String(count));
+}
+/**
+ * Human-readable rolling preset title for compact summaries. **Rolling year** presets with bounds use
+ * `Next Year (2027)` / `Last Year (2025)`; **rolling month** inner text uses calendar-relative months, e.g.
+ * `Next Month (May 2026)`, `Last Month (March 2026)`; multi-month uses a span, e.g. `Next 6 Months (May 2026 - Oct 2026)`.
+ */
+export function getRollingSummaryLabel(value, i18n = DEFAULT_DATE_SELECTOR_I18N) {
+    const { selectionMode } = value;
+    const count = resolveRollingCount(value);
+    if ((selectionMode !== 'rolling-next' && selectionMode !== 'rolling-last') || count === undefined)
+        return null;
+    const unit = resolveRollingUnit(value);
+    const isNext = selectionMode === 'rolling-next';
+    if (unit === 'month') {
+        const phraseForMonthRange = (inner) => {
+            if (count === 1) {
+                return `${isNext ? i18n.rollingSummaryNextSingleMonth : i18n.rollingSummaryLastSingleMonth} (${inner})`;
+            }
+            const head = (isNext ? i18n.rollingSummaryNextMonths : i18n.rollingSummaryLastMonths).replace('{{count}}', String(count));
+            return `${head} (${inner})`;
+        };
+        if (value.startDate && value.endDate) {
+            return phraseForMonthRange(formatRollingMonthInnerLabel(value.startDate, value.endDate, selectionMode, count, i18n));
+        }
+        const { startDate, endDate } = computeRollingPresetRange(selectionMode, 'month', count, new Date());
+        return phraseForMonthRange(formatRollingMonthInnerLabel(startDate, endDate, selectionMode, count, i18n));
+    }
+    if (unit === 'year') {
+        const phraseForYearRange = (inner) => {
+            if (count === 1) {
+                return `${isNext ? i18n.rollingSummaryNextYear : i18n.rollingSummaryLastYear} (${inner})`;
+            }
+            const head = (isNext ? i18n.rollingSummaryNextYears : i18n.rollingSummaryLastYears).replace('{{count}}', String(count));
+            return `${head} (${inner})`;
+        };
+        if (value.startDate && value.endDate) {
+            const y1 = value.startDate.getFullYear();
+            const y2 = value.endDate.getFullYear();
+            const inner = y1 === y2 ? String(y1) : `${y1}–${y2}`;
+            return phraseForYearRange(inner);
+        }
+        if (count === undefined || count === 1)
+            return null;
+        const { startDate, endDate } = computeRollingPresetRange(selectionMode, 'year', count, new Date());
+        const y1 = startDate.getFullYear();
+        const y2 = endDate.getFullYear();
+        const inner = y1 === y2 ? String(y1) : `${y1}–${y2}`;
+        return phraseForYearRange(inner);
+    }
+    if (unit === 'quarter') {
+        const phraseForQuarterRange = (inner) => {
+            if (count === 1) {
+                return `${isNext ? i18n.rollingSummaryNextQuarter : i18n.rollingSummaryLastQuarter} (${inner})`;
+            }
+            const head = (isNext ? i18n.rollingSummaryNextQuarters : i18n.rollingSummaryLastQuarters).replace('{{count}}', String(count));
+            return `${head} (${inner})`;
+        };
+        if (value.startDate && value.endDate) {
+            return phraseForQuarterRange(formatRollingQuarterSpan(value.startDate, value.endDate, i18n));
+        }
+        if (count === undefined || count === 1)
+            return null;
+        const { startDate, endDate } = computeRollingPresetRange(selectionMode, 'quarter', count, new Date());
+        return phraseForQuarterRange(formatRollingQuarterSpan(startDate, endDate, i18n));
+    }
+    return (isNext ? i18n.rollingSummaryNext : i18n.rollingSummaryLast).replace('{{count}}', String(count));
+}
+/**
+ * Inclusive calendar bounds for rolling presets. **Days:** “next N” / “last N” are the N calendar days **after** today /
+ * **before** today (today excluded). **Months** use month boundaries (last span can include today through end of day).
+ * **Years:** “last” / “next” use **full calendar years**
+ * adjacent to the current year (`last` → prior year(s), `next` → following year(s)), not partial ranges from today.
+ * **Quarters:** same pattern using calendar quarters adjacent to the current quarter.
+ */
+export function computeRollingPresetRange(mode, unit, count, now = new Date()) {
+    const today = startOfDay(now);
+    if (unit === 'day') {
+        if (mode === 'rolling-next') {
+            return {
+                startDate: startOfDay(addDays(today, 1)),
+                endDate: startOfDay(addDays(today, count)),
+            };
+        }
+        return {
+            startDate: startOfDay(subDays(today, count)),
+            endDate: startOfDay(subDays(today, 1)),
+        };
+    }
+    if (unit === 'month') {
+        if (mode === 'rolling-last') {
+            return {
+                startDate: startOfMonth(subMonths(today, count - 1)),
+                endDate: endOfDay(today),
+            };
+        }
+        const monthStart = startOfMonth(today);
+        return {
+            startDate: today,
+            endDate: endOfMonth(addMonths(monthStart, count - 1)),
+        };
+    }
+    if (unit === 'year') {
+        const yearStart = startOfYear(today);
+        if (mode === 'rolling-last') {
+            return {
+                startDate: startOfYear(subYears(yearStart, count)),
+                endDate: endOfYear(subYears(yearStart, 1)),
+            };
+        }
+        return {
+            startDate: startOfYear(addYears(yearStart, 1)),
+            endDate: endOfYear(addYears(yearStart, count)),
+        };
+    }
+    if (unit === 'quarter') {
+        const quarterStart = startOfQuarter(today);
+        if (mode === 'rolling-last') {
+            return {
+                startDate: startOfQuarter(subQuarters(quarterStart, count)),
+                endDate: endOfQuarter(subQuarters(quarterStart, 1)),
+            };
+        }
+        return {
+            startDate: startOfQuarter(addQuarters(quarterStart, 1)),
+            endDate: endOfQuarter(addQuarters(quarterStart, count)),
+        };
+    }
+    const _unreachable = unit;
+    return _unreachable;
+}
+/**
+ * Computes inclusive calendar date bounds for rolling day windows. “Next N” is the N days **after** today (exclusive of
+ * today). “Last N” is the N days **before** today (exclusive of today).
+ */
+export function computeRollingDateRange(mode, days, now = new Date()) {
+    return computeRollingPresetRange(mode, 'day', days, now);
+}
+/**
+ * Calendar detail for any rolling preset — for tooltips when the bar uses {@link getRollingBarShortLabel} only.
+ * Uses `value` bounds when present, otherwise {@link computeRollingPresetRange}.
+ * Rolling **day** spans always use compact `M/d/yy` (e.g. `4/18/26`); the `dayDateFormat` argument is reserved for API compatibility and ignored for that unit.
+ */
+export function formatRollingRangeTooltipDetail(value, i18n = DEFAULT_DATE_SELECTOR_I18N, 
+/** @deprecated Ignored for rolling days; day tooltips use compact `M/d/yy`. Kept for call-site compatibility. */
+_dayDateFormat = 'MM/dd/yyyy') {
+    if (value.selectionMode !== 'rolling-next' && value.selectionMode !== 'rolling-last')
+        return null;
+    const count = resolveRollingCount(value);
+    if (count === undefined)
+        return null;
+    const unit = resolveRollingUnit(value);
+    const mode = value.selectionMode;
+    const rangeOrCompute = (u) => value.startDate && value.endDate ? { startDate: value.startDate, endDate: value.endDate } : computeRollingPresetRange(mode, u, count);
+    if (unit === 'day') {
+        const { startDate, endDate } = rangeOrCompute('day');
+        return `${format(startDate, DATE_SELECTOR_COMPACT_DAY_FORMAT)} – ${format(endDate, DATE_SELECTOR_COMPACT_DAY_FORMAT)}`;
+    }
+    if (unit === 'month') {
+        const { startDate, endDate } = rangeOrCompute('month');
+        return formatRollingMonthInnerLabel(startDate, endDate, mode, count, i18n);
+    }
+    if (unit === 'quarter') {
+        const { startDate, endDate } = rangeOrCompute('quarter');
+        return formatRollingQuarterSpan(startDate, endDate, i18n);
+    }
+    if (unit === 'year') {
+        const { startDate, endDate } = rangeOrCompute('year');
+        const y1 = startDate.getFullYear();
+        const y2 = endDate.getFullYear();
+        return y1 === y2 ? String(y1) : `${y1}–${y2}`;
+    }
+    return null;
+}
+/**
+ * Formats a {@link DateSelectorValue} for display using the same rules as the selector’s summary text.
+ */
+export function formatDateValue(value, i18n = DEFAULT_DATE_SELECTOR_I18N, dayDateFormat = 'MM/dd/yyyy', options) {
+    const { period, startDate, endDate, year, month, quarter, rangeStart, rangeEnd } = value;
+    const includeRollingDetail = options?.includeRollingRangeDetailInLabel !== false;
+    const rollingLabel = getRollingSummaryLabel(value, i18n);
+    if (rollingLabel !== null) {
+        if (!includeRollingDetail) {
+            const short = getRollingBarShortLabel(value, i18n);
+            return short ?? rollingLabel;
+        }
+        const ru = resolveRollingUnit(value);
+        if (ru === 'year' || ru === 'month' || ru === 'quarter') {
+            return rollingLabel;
+        }
+        if (startDate && endDate) {
+            return `${rollingLabel} (${format(startDate, DATE_SELECTOR_COMPACT_DAY_FORMAT)} – ${format(endDate, DATE_SELECTOR_COMPACT_DAY_FORMAT)})`;
+        }
+        return rollingLabel;
+    }
+    if (period === 'day') {
+        if (startDate && endDate) {
+            return `${format(startDate, dayDateFormat)} - ${format(endDate, dayDateFormat)}`;
+        }
+        if (startDate) {
+            return format(startDate, dayDateFormat);
+        }
+        return '';
+    }
+    if (period === 'month') {
+        if (rangeStart && rangeEnd) {
+            return `${i18n.monthsShort[rangeStart.value]} ${rangeStart.year} - ${i18n.monthsShort[rangeEnd.value]} ${rangeEnd.year}`;
+        }
+        if (year !== undefined && month !== undefined) {
+            return `${i18n.monthsShort[month]} ${year}`;
+        }
+        return '';
+    }
+    if (period === 'quarter') {
+        if (rangeStart && rangeEnd) {
+            return `${i18n.quarters[rangeStart.value]} ${rangeStart.year} - ${i18n.quarters[rangeEnd.value]} ${rangeEnd.year}`;
+        }
+        if (year !== undefined && quarter !== undefined) {
+            return `${i18n.quarters[quarter]} ${year}`;
+        }
+        return '';
+    }
+    if (period === 'year') {
+        if (rangeStart && rangeEnd) {
+            return `${rangeStart.year} - ${rangeEnd.year}`;
+        }
+        if (year !== undefined) {
+            return `${year}`;
+        }
+        return '';
+    }
+    return '';
+}
+/** Stable fingerprint for a {@link DateSelectorValue} (for sync keys and onChange deduplication). */
+export function dateSelectorDataKey(value) {
+    if (value === undefined)
+        return '__uc__';
+    const v = value;
+    return [
+        v.period,
+        v.operator,
+        v.selectionMode ?? '',
+        v.rollingUnit ?? (v.rollingDays != null ? 'day' : ''),
+        v.rollingCount ?? v.rollingDays ?? '',
+        v.year ?? '',
+        v.month ?? '',
+        v.quarter ?? '',
+        v.startDate?.getTime() ?? '',
+        v.endDate?.getTime() ?? '',
+        v.rangeStart ? `${v.rangeStart.year}-${v.rangeStart.value}` : '',
+        v.rangeEnd ? `${v.rangeEnd.year}-${v.rangeEnd.value}` : '',
+    ].join('|');
+}
+export function computeStateSyncKey(value, presetMode, defaultFilterType, validDefaultPeriodType) {
+    return `${dateSelectorDataKey(value)}|${presetMode ?? ''}|${defaultFilterType}|${validDefaultPeriodType}`;
+}
+export function createInitialInternalState(value, validDefaultPeriodType, defaultFilterType, presetMode) {
+    const calendarMonth = value?.startDate ?? new Date();
+    if (!value) {
+        return {
+            periodType: validDefaultPeriodType,
+            filterType: presetMode ?? defaultFilterType,
+            selectedDate: undefined,
+            selectedEndDate: undefined,
+            calendarMonth,
+            selectedYear: undefined,
+            selectedMonth: undefined,
+            selectedQuarter: undefined,
+            rangeStart: undefined,
+            rangeEnd: undefined,
+            hoverDate: undefined,
+            selectionMode: 'custom',
+            rollingUnit: 'day',
+            rollingCount: undefined,
+        };
+    }
+    const filterType = presetMode ?? value.operator ?? defaultFilterType;
+    if (value.selectionMode === 'rolling-next' || value.selectionMode === 'rolling-last') {
+        const rollingUnit = resolveRollingUnit(value);
+        const rollingCount = resolveRollingCount(value);
+        return {
+            periodType: value.period || validDefaultPeriodType,
+            filterType,
+            selectedDate: undefined,
+            selectedEndDate: undefined,
+            calendarMonth,
+            selectedYear: value.year,
+            selectedMonth: value.month,
+            selectedQuarter: value.quarter,
+            rangeStart: value.rangeStart,
+            rangeEnd: value.rangeEnd,
+            hoverDate: undefined,
+            selectionMode: value.selectionMode,
+            rollingUnit,
+            rollingCount,
+        };
+    }
+    return {
+        periodType: value.period || validDefaultPeriodType,
+        filterType,
+        selectedYear: value.year,
+        selectedMonth: value.month,
+        selectedQuarter: value.quarter,
+        rangeStart: value.rangeStart,
+        rangeEnd: value.rangeEnd,
+        hoverDate: undefined,
+        selectionMode: 'custom',
+        rollingUnit: 'day',
+        rollingCount: undefined,
+        selectedDate: value.startDate,
+        selectedEndDate: value.endDate,
+        calendarMonth,
+    };
+}
+export function buildRollingValueFromState(selectionMode, rollingUnit, rollingCount) {
+    if (selectionMode !== 'rolling-next' && selectionMode !== 'rolling-last') {
+        return undefined;
+    }
+    if (rollingCount === undefined) {
+        return {
+            period: 'day',
+            operator: 'between',
+            selectionMode,
+        };
+    }
+    const mode = selectionMode === 'rolling-next' ? 'rolling-next' : 'rolling-last';
+    const { startDate: rs, endDate: re } = computeRollingPresetRange(mode, rollingUnit, rollingCount, new Date());
+    const out = {
+        period: 'day',
+        operator: 'between',
+        selectionMode,
+        rollingUnit,
+        rollingCount,
+        startDate: rs,
+        endDate: re,
+    };
+    if (rollingUnit === 'day' && DATE_SELECTOR_ROLLING_DAY_OPTIONS.includes(rollingCount)) {
+        out.rollingDays = rollingCount;
+    }
+    return out;
+}
+export function buildCurrentValueFromInternal(s, presetMode) {
+    const rolling = buildRollingValueFromState(s.selectionMode, s.rollingUnit, s.rollingCount);
+    if (rolling)
+        return rolling;
+    return {
+        period: s.periodType,
+        operator: presetMode ?? s.filterType,
+        startDate: s.selectedDate,
+        endDate: s.selectedEndDate,
+        year: s.selectedYear,
+        month: s.selectedMonth,
+        quarter: s.selectedQuarter,
+        rangeStart: s.rangeStart,
+        rangeEnd: s.rangeEnd,
+    };
+}

package/dist/{components → blocks}/date-selector/date-selector.d.ts

@@ -2,5 +2,5 @@ import { type DateSelectorProps } from './date-selector-types';
 /**
  * Composite filter control for dates and calendar periods. Root element sets `data-slot="date-selector"`.
  */
-export declare function DateSelector({ value, onChange, allowRange, periodTypes, defaultPeriodType, defaultFilterType, presetMode, showInput, showOperators, showTwoMonths, label, className, yearRange, baseYear, minYear, maxYear, yearOptions, i18n: i18nOverride, inputHint, dayDateFormat, dayDateFormats, weekStartsOn, showRollingPresets, rollingDayOptions, }: DateSelectorProps): import("react/jsx-runtime").JSX.Element;
+export declare function DateSelector({ value, onChange, allowRange, periodTypes, defaultPeriodType, defaultFilterType, presetMode, showInput, showOperators, showTwoMonths, label, className, yearRange, baseYear, minYear, maxYear, yearOptions, i18n: i18nOverride, i18nInstance: i18nInstanceProp, inputHint, dayDateFormat, dayDateFormats, weekStartsOn, showRollingPresets, rollingDayOptions, rollingMonthOptions, rollingQuarterOptions, rollingYearOptions, fillHeight, separateDayPeriod, }: DateSelectorProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=date-selector.d.ts.map

package/dist/blocks/date-selector/date-selector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-selector.d.ts","sourceRoot":"","sources":["../../../src/blocks/date-selector/date-selector.tsx"],"names":[],"mappings":"AAiCA,OAAO,EAKH,KAAK,iBAAiB,EAGzB,MAAM,uBAAuB,CAAC;AAI/B;;GAEG;AACH,wBAAgB,YAAY,CAAC,EACzB,KAAK,EACL,QAAQ,EACR,UAAiB,EACjB,WAAW,EACX,iBAAyB,EACzB,iBAAwB,EACxB,UAAU,EACV,SAAgB,EAChB,aAAoB,EACpB,aAAqB,EACrB,KAAK,EACL,SAAS,EACT,SAAa,EACb,QAAQ,EACR,OAAc,EACd,OAAc,EACd,WAAW,EACX,IAAI,EAAE,YAAY,EAClB,YAAY,EAAE,gBAAgB,EAC9B,SAAS,EACT,aAA4B,EAC5B,cAAc,EACd,YAAY,EACZ,kBAA0B,EAC1B,iBAAqD,EACrD,mBAAyD,EACzD,qBAA6D,EAC7D,kBAAuD,EACvD,UAAkB,EAClB,iBAAyB,GAC5B,EAAE,iBAAiB,2CAianB"}