cpk-ui 0.7.0 → 0.8.0-beta.1

package/components/uis/Calendar/intl.js

@@ -0,0 +1,146 @@
+const OPTIONS = {
+    monthTitle: { year: 'numeric', month: 'long' },
+    weekdayNarrow: { weekday: 'narrow' },
+    dayNumber: { day: 'numeric' },
+    dayFull: { dateStyle: 'full' },
+    rangeDay: { month: 'short', day: 'numeric', year: 'numeric' },
+};
+const hasIntl = typeof Intl !== 'undefined' && typeof Intl.DateTimeFormat === 'function';
+const formatCache = new Map();
+export function getFormat(locale, shape) {
+    if (!hasIntl) {
+        return null;
+    }
+    const cacheKey = `${locale}|${shape}`;
+    if (formatCache.has(cacheKey)) {
+        return formatCache.get(cacheKey) ?? null;
+    }
+    let format = null;
+    try {
+        format = new Intl.DateTimeFormat(locale, OPTIONS[shape]);
+    }
+    catch {
+        try {
+            format = new Intl.DateTimeFormat(undefined, OPTIONS[shape]);
+        }
+        catch {
+            // Exotic runtime without a usable ICU. The English fallbacks below take over.
+            format = null;
+        }
+    }
+    formatCache.set(cacheKey, format);
+    return format;
+}
+/** The device locale, or `en-US` when the runtime has no `Intl`. */
+export function resolveLocale() {
+    if (!hasIntl) {
+        return 'en-US';
+    }
+    try {
+        return new Intl.DateTimeFormat().resolvedOptions().locale || 'en-US';
+    }
+    catch {
+        return 'en-US';
+    }
+}
+const FALLBACK_MONTHS = [
+    'January',
+    'February',
+    'March',
+    'April',
+    'May',
+    'June',
+    'July',
+    'August',
+    'September',
+    'October',
+    'November',
+    'December',
+];
+const FALLBACK_MONTHS_SHORT = [
+    'Jan',
+    'Feb',
+    'Mar',
+    'Apr',
+    'May',
+    'Jun',
+    'Jul',
+    'Aug',
+    'Sep',
+    'Oct',
+    'Nov',
+    'Dec',
+];
+const FALLBACK_WEEKDAYS = [
+    'Sunday',
+    'Monday',
+    'Tuesday',
+    'Wednesday',
+    'Thursday',
+    'Friday',
+    'Saturday',
+];
+const FALLBACK_WEEKDAY_NARROW = ['S', 'M', 'T', 'W', 'T', 'F', 'S'];
+const monthTitle = (date, locale) => {
+    const format = getFormat(locale, 'monthTitle');
+    return format
+        ? format.format(date)
+        : `${FALLBACK_MONTHS[date.getMonth()]} ${date.getFullYear()}`;
+};
+const rangeDay = (date, locale) => {
+    const format = getFormat(locale, 'rangeDay');
+    return format
+        ? format.format(date)
+        : `${FALLBACK_MONTHS_SHORT[date.getMonth()]} ${date.getDate()}, ${date.getFullYear()}`;
+};
+const weekTitle = (start, end, locale) => {
+    const format = getFormat(locale, 'rangeDay');
+    if (format && typeof format.formatRange === 'function') {
+        try {
+            return format.formatRange(start, end);
+        }
+        catch {
+            // Older ICU without formatRange. Fall through to the manual join.
+        }
+    }
+    return `${rangeDay(start, locale)} – ${rangeDay(end, locale)}`;
+};
+const weekdayLabel = (date, locale) => {
+    const format = getFormat(locale, 'weekdayNarrow');
+    return format ? format.format(date) : FALLBACK_WEEKDAY_NARROW[date.getDay()];
+};
+const dayNumber = (date, locale) => {
+    const format = getFormat(locale, 'dayNumber');
+    return format ? format.format(date) : String(date.getDate());
+};
+const dayAccessibilityLabel = (date, locale) => {
+    const format = getFormat(locale, 'dayFull');
+    return format
+        ? format.format(date)
+        : `${FALLBACK_WEEKDAYS[date.getDay()]}, ${FALLBACK_MONTHS[date.getMonth()]} ${date.getDate()}, ${date.getFullYear()}`;
+};
+export const DEFAULT_FORMATTERS = Object.freeze({
+    monthTitle,
+    weekTitle,
+    weekdayLabel,
+    dayNumber,
+    dayAccessibilityLabel,
+});
+let formattersSeq = 0;
+const formattersIds = new WeakMap();
+/**
+ * A stable id per formatters object, so the grid LRU key changes when a caller
+ * swaps in different formatters but not when it re-renders with the same ones.
+ */
+export function getFormattersId(formatters) {
+    if (formatters === DEFAULT_FORMATTERS) {
+        return 'default';
+    }
+    let id = formattersIds.get(formatters);
+    if (!id) {
+        formattersSeq += 1;
+        id = `f${formattersSeq}`;
+        formattersIds.set(formatters, id);
+    }
+    return id;
+}

package/components/uis/Calendar/palette.d.ts

@@ -0,0 +1,10 @@
+import type { CpkTheme } from '../../../utils/theme';
+import type { CalendarColors, CalendarPalette } from './types';
+export declare function resolveCalendarPalette(theme: CpkTheme, colors?: CalendarColors): CalendarPalette;
+/**
+ * `ThemeProvider` rebuilds its context value on every render, so comparing the
+ * resolved colours by value is what keeps `chrome` (and therefore all 42 cells)
+ * from re-rendering when nothing about the theme actually changed.
+ */
+export declare function isSamePalette(a: CalendarPalette, b: CalendarPalette): boolean;
+//# sourceMappingURL=palette.d.ts.map

package/components/uis/Calendar/palette.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"palette.d.ts","sourceRoot":"","sources":["../../../../src/components/uis/Calendar/palette.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,sBAAsB,CAAC;AACnD,OAAO,KAAK,EAAC,cAAc,EAAE,eAAe,EAAC,MAAM,SAAS,CAAC;AAsC7D,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,QAAQ,EACf,MAAM,CAAC,EAAE,cAAc,GACtB,eAAe,CA4BjB;AA6BD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,eAAe,GAAG,OAAO,CAY7E"}

package/components/uis/Calendar/palette.js

@@ -0,0 +1,93 @@
+import { readableTextOn, relativeLuminance } from './utils';
+/**
+ * The calendar reads exactly the tokens listed below and nothing else.
+ * `background` is the only literal in the component: the grid inherits the surface
+ * it sits on instead of painting its own, so dark mode needs no special casing.
+ */
+const TRANSPARENT = 'transparent';
+/**
+ * Auto contrast for a caller supplied `selectedBackground`.
+ * A ledger colour such as a saturated yellow is unreadable under a hard coded white
+ * label, so the label is picked by relative luminance from the two text tokens.
+ */
+function resolveSelectedText(theme, selectedBackground) {
+    const contrastLuminance = relativeLuminance(theme.text.contrast);
+    const basicLuminance = relativeLuminance(theme.text.basic);
+    if (contrastLuminance === null || basicLuminance === null) {
+        return theme.text.contrast;
+    }
+    const lighter = contrastLuminance >= basicLuminance
+        ? theme.text.contrast
+        : theme.text.basic;
+    const darker = contrastLuminance >= basicLuminance
+        ? theme.text.basic
+        : theme.text.contrast;
+    return readableTextOn(selectedBackground, lighter, darker);
+}
+export function resolveCalendarPalette(theme, colors) {
+    const selectedBackground = colors?.selectedBackground ?? theme.role.primary;
+    const selectedText = colors?.selectedText ??
+        (colors?.selectedBackground
+            ? resolveSelectedText(theme, colors.selectedBackground)
+            : theme.text.contrast);
+    return Object.freeze({
+        background: colors?.background ?? TRANSPARENT,
+        headerText: colors?.headerText ?? theme.text.basic,
+        navIcon: colors?.navIcon ?? theme.text.basic,
+        weekdayLabel: colors?.weekdayLabel ?? theme.text.label,
+        weekNumberLabel: colors?.weekNumberLabel ?? theme.text.disabled,
+        dayText: colors?.dayText ?? theme.text.basic,
+        sundayText: colors?.sundayText ?? theme.role.danger,
+        saturdayText: colors?.saturdayText ?? theme.role.info,
+        outsideText: colors?.outsideText ?? theme.text.disabled,
+        disabledText: colors?.disabledText ?? theme.text.disabled,
+        todayText: colors?.todayText ?? theme.role.secondary,
+        todayRing: colors?.todayRing ?? theme.role.secondary,
+        selectedBackground,
+        selectedText,
+        underlay: colors?.underlay ?? theme.role.underlay,
+        border: colors?.border ?? theme.role.border,
+        dot: colors?.dot ?? theme.role.primary,
+        badgeText: colors?.badgeText ?? theme.text.label,
+    });
+}
+const PALETTE_KEYS = Object.keys(resolveCalendarPalette({
+    bg: { basic: '', paper: '', disabled: '' },
+    role: {
+        primary: '',
+        secondary: '',
+        success: '',
+        warning: '',
+        danger: '',
+        info: '',
+        accent: '',
+        link: '',
+        border: '',
+        underlay: '',
+        underlayContrast: '',
+    },
+    text: {
+        basic: '',
+        label: '',
+        placeholder: '',
+        disabled: '',
+        validation: '',
+        contrast: '',
+    },
+}));
+/**
+ * `ThemeProvider` rebuilds its context value on every render, so comparing the
+ * resolved colours by value is what keeps `chrome` (and therefore all 42 cells)
+ * from re-rendering when nothing about the theme actually changed.
+ */
+export function isSamePalette(a, b) {
+    if (a === b) {
+        return true;
+    }
+    for (const key of PALETTE_KEYS) {
+        if (a[key] !== b[key]) {
+            return false;
+        }
+    }
+    return true;
+}

package/components/uis/Calendar/types.d.ts

@@ -0,0 +1,286 @@
+import type { ReactNode } from 'react';
+import type { StyleProp, TextStyle, ViewStyle } from 'react-native';
+/**
+ * Canonical day key. ALWAYS `yyyy-MM-dd`, zero padded, in the DEVICE LOCAL calendar.
+ * Keys sort lexicographically, so range checks are plain string compares.
+ */
+export type CalendarDateKey = string;
+/** Canonical month key. ALWAYS `yyyy-MM`. */
+export type CalendarMonthKey = string;
+/**
+ * The key identifying one pager page: a month key in `mode='month'`, a day key
+ * (the first day of the week) in `mode='week'`.
+ */
+export type CalendarPageKey = CalendarMonthKey | CalendarDateKey;
+/** 0 = Sunday … 6 = Saturday. Same numbering as `Date.prototype.getDay()`. */
+export type WeekStart = 0 | 1 | 2 | 3 | 4 | 5 | 6;
+export type CalendarWeekday = 0 | 1 | 2 | 3 | 4 | 5 | 6;
+export type CalendarViewMode = 'month' | 'week';
+export type CalendarSizeType = 'compact' | 'regular' | 'expanded' | number;
+export type CalendarChangeSource = 'press' | 'swipe' | 'button' | 'keyboard' | 'imperative';
+/**
+ * Structural shape of a Reanimated `SharedValue<number>` in `[0, 1]`.
+ * Declared structurally so the public API is not pinned to a Reanimated version.
+ */
+export type CalendarCollapseProgress = {
+    value: number;
+};
+export type CalendarDot = {
+    /** Stable identity within the day. Used as the React key. */
+    key: string;
+    /** Defaults to `palette.dot`. */
+    color?: string;
+};
+/**
+ * Everything one day cell can be decorated with. Looked up O(1) by `CalendarDateKey`.
+ * Marker objects SHOULD be referentially stable across renders so the cell memo bails.
+ */
+export type CalendarMarker = {
+    dots?: readonly CalendarDot[];
+    /** Overrides the selected pill background for this day only. */
+    selectedColor?: string;
+    /** Overrides the day number color when the day is NOT selected. */
+    textColor?: string;
+    /** Tiny caption under the number. Hidden when the font scale exceeds 1.3. */
+    badgeText?: string;
+    badgeColor?: string;
+    disabled?: boolean;
+    /** Appended to the cell accessibility label, e.g. "3 entries, minus 42,000 won". */
+    accessibilityHint?: string;
+};
+export type CalendarMarkerMap = Readonly<Record<CalendarDateKey, CalendarMarker>>;
+export type CalendarDayModel = {
+    key: CalendarDateKey;
+    /** Local noon of that calendar day. Noon anchoring keeps DST off the day boundary. */
+    date: Date;
+    dayOfMonth: number;
+    /** 0 = Sunday, independent of `weekStart`. */
+    weekday: CalendarWeekday;
+    /** True when the cell belongs to the previous or next month (month mode only). */
+    isOutside: boolean;
+    /** 0 based row index inside the page grid. */
+    weekIndex: number;
+    /** Week number, only computed when `showWeekNumbers` is true, else 0. */
+    weekNumber: number;
+};
+export type CalendarDayState = {
+    day: CalendarDayModel;
+    isSelected: boolean;
+    isToday: boolean;
+    isDisabled: boolean;
+    marker?: CalendarMarker;
+};
+/** The resolved, frozen colour set threaded to every cell as one prop. */
+export type CalendarPalette = Readonly<{
+    background: string;
+    headerText: string;
+    navIcon: string;
+    weekdayLabel: string;
+    weekNumberLabel: string;
+    dayText: string;
+    sundayText: string;
+    saturdayText: string;
+    outsideText: string;
+    disabledText: string;
+    todayText: string;
+    todayRing: string;
+    selectedBackground: string;
+    selectedText: string;
+    underlay: string;
+    border: string;
+    dot: string;
+    badgeText: string;
+}>;
+/** Caller facing overrides. Every key defaults to a cpk-ui theme token. */
+export type CalendarColors = Partial<CalendarPalette>;
+/** Resolved geometry. Every value is a pure function of `size` and the font scale. */
+export type CalendarMetrics = Readonly<{
+    cellSize: number;
+    rowGap: number;
+    rowHeight: number;
+    weekdayRowHeight: number;
+    headerHeight: number;
+    /** Edge of the round day pill. */
+    numberSize: number;
+    dayFontSize: number;
+    weekdayFontSize: number;
+    headerFontSize: number;
+    badgeFontSize: number;
+    dotSize: number;
+    dotRowHeight: number;
+    /** Constant top inset of the day pill, so decorations never move the number. */
+    pillOffset: number;
+    weekNumberWidth: number;
+}>;
+export type CalendarFormatters = {
+    /** Header title, e.g. "August 2026" or "2026년 8월". */
+    monthTitle: (date: Date, locale: string) => string;
+    /** Header title in week mode, e.g. "Aug 23 – 29, 2026". */
+    weekTitle: (start: Date, end: Date, locale: string) => string;
+    /** Weekday column header, e.g. "S" or "일". */
+    weekdayLabel: (date: Date, locale: string) => string;
+    /** Day number. Respects locale numbering systems. */
+    dayNumber: (date: Date, locale: string) => string;
+    /** Full accessibility label, e.g. "Monday, August 24, 2026". */
+    dayAccessibilityLabel: (date: Date, locale: string) => string;
+};
+export type CalendarLabels = {
+    previousMonth?: string;
+    nextMonth?: string;
+    previousWeek?: string;
+    nextWeek?: string;
+    /** Appended to the today cell accessibility label. */
+    today?: string;
+    selected?: string;
+    weekNumber?: string;
+    /** Announced by the header live region on page change. */
+    pageAnnouncement?: (pageTitle: string) => string;
+};
+export type CalendarStyles = {
+    container?: StyleProp<ViewStyle>;
+    header?: StyleProp<ViewStyle>;
+    headerTitle?: StyleProp<TextStyle>;
+    weekdayRow?: StyleProp<ViewStyle>;
+    weekdayLabel?: StyleProp<TextStyle>;
+    weekRow?: StyleProp<ViewStyle>;
+    dayCell?: StyleProp<ViewStyle>;
+    dayText?: StyleProp<TextStyle>;
+    selectedDayCell?: StyleProp<ViewStyle>;
+    selectedDayText?: StyleProp<TextStyle>;
+    todayDayCell?: StyleProp<ViewStyle>;
+    todayDayText?: StyleProp<TextStyle>;
+    outsideDayText?: StyleProp<TextStyle>;
+    disabledDayText?: StyleProp<TextStyle>;
+    dotRow?: StyleProp<ViewStyle>;
+    dot?: StyleProp<ViewStyle>;
+    badgeText?: StyleProp<TextStyle>;
+};
+export type CalendarRenderDay = (ctx: CalendarDayState & {
+    palette: CalendarPalette;
+    cellSize: number;
+}) => ReactNode;
+/**
+ * Everything invariant across all cells of a page.
+ * Created once per (theme, size, callbacks) change and compared by identity.
+ */
+export type CalendarChrome = Readonly<{
+    palette: CalendarPalette;
+    metrics: CalendarMetrics;
+    /** Pre built geometry style objects. Stable while `metrics` is stable. */
+    geometry: Readonly<{
+        row: ViewStyle;
+        cell: ViewStyle;
+        pill: ViewStyle;
+        dayText: TextStyle;
+        badgeText: TextStyle;
+        dot: ViewStyle;
+        dotRow: ViewStyle;
+        weekNumber: ViewStyle;
+        weekNumberText: TextStyle;
+    }>;
+    showDots: boolean;
+    maxDots: number;
+    showBadges: boolean;
+    maxFontSizeMultiplier: number;
+    fontScale: number;
+    labels: Required<CalendarLabels>;
+    styles: CalendarStyles;
+    renderDay?: CalendarRenderDay;
+    onPress: (key: CalendarDateKey) => void;
+    onLongPress?: (key: CalendarDateKey) => void;
+    onDisabledPress?: (key: CalendarDateKey) => void;
+}>;
+/** Resolves whether a day is blocked. Identity changes are tracked by `disabledVersion`. */
+export type CalendarDisabledResolver = (day: CalendarDayModel, marker?: CalendarMarker) => boolean;
+export type CalendarHeaderContext = {
+    title: string;
+    date: Date;
+    mode: CalendarViewMode;
+    canGoPrevious: boolean;
+    canGoNext: boolean;
+    goPrevious: () => void;
+    goNext: () => void;
+};
+export type CalendarProps = {
+    /** Controlled selection. `null` clears it. A `Date` is normalized to its local day key. */
+    value?: Date | CalendarDateKey | null;
+    /** Uncontrolled initial selection. Ignored when `value !== undefined`. */
+    defaultValue?: Date | CalendarDateKey | null;
+    /**
+     * User interaction only, never fired on mount.
+     * Prefer `key` for persistence, `date` is provided for interop and is local midnight.
+     */
+    onChange?: (date: Date, key: CalendarDateKey, source: CalendarChangeSource) => void;
+    /** Controlled page anchor: `'yyyy-MM'`, `'yyyy-MM-dd'` or a `Date`. */
+    month?: Date | CalendarPageKey;
+    defaultMonth?: Date | CalendarPageKey;
+    onMonthChange?: (firstDayOfPage: Date, key: CalendarPageKey, source: CalendarChangeSource) => void;
+    mode?: CalendarViewMode;
+    defaultMode?: CalendarViewMode;
+    onModeChange?: (mode: CalendarViewMode) => void;
+    /**
+     * Optional shared value in `[0, 1]`: 0 = full month, 1 = single week.
+     * When supplied the caller owns the collapse animation and the component only reads it.
+     * When omitted the component animates internally on `mode` change.
+     */
+    collapseProgress?: CalendarCollapseProgress;
+    /** BCP-47 tag. Defaults to the runtime locale. */
+    locale?: string;
+    /** Defaults to the CLDR first day of the resolved locale region. */
+    weekStart?: WeekStart;
+    /**
+     * Injectable "now". A key is used verbatim, which lets hosts supply a day
+     * resolved in a business timezone instead of the device timezone.
+     * Defaults to an internal clock that re-arms at local midnight.
+     */
+    today?: Date | CalendarDateKey;
+    /** Always render 6 rows so the height never changes between months. */
+    fixedWeeks?: boolean;
+    /** O(1) lookup by `yyyy-MM-dd`. MUST be memoized by the caller. */
+    markers?: CalendarMarkerMap;
+    showDots?: boolean;
+    maxDotsPerDay?: number;
+    showWeekNumbers?: boolean;
+    showOutsideDays?: boolean;
+    minDate?: Date | CalendarDateKey;
+    maxDate?: Date | CalendarDateKey;
+    /** Normalized to a `Set` once per identity change. */
+    disabledDates?: ReadonlySet<CalendarDateKey> | readonly CalendarDateKey[];
+    /** Escape hatch, called only for the mounted window. Must be pure and cheap. */
+    isDateDisabled?: (date: Date, key: CalendarDateKey) => boolean;
+    showHeader?: boolean;
+    showNavigationButtons?: boolean;
+    showWeekdayRow?: boolean;
+    paging?: 'swipe' | 'none';
+    monthsToShow?: 1 | 2;
+    size?: CalendarSizeType;
+    /** Multiplier cap applied to every text node. */
+    maxFontSizeMultiplier?: number;
+    colors?: CalendarColors;
+    styles?: CalendarStyles;
+    style?: StyleProp<ViewStyle>;
+    formatters?: Partial<CalendarFormatters>;
+    /** Must be referentially stable. */
+    renderHeader?: (ctx: CalendarHeaderContext) => ReactNode;
+    renderWeekdayLabel?: (ctx: {
+        weekday: CalendarWeekday;
+        label: string;
+    }) => ReactNode;
+    /** Full control of a cell. Receives everything precomputed, must not format dates itself. */
+    renderDay?: CalendarRenderDay;
+    onDayLongPress?: (date: Date, key: CalendarDateKey) => void;
+    onDisabledDayPress?: (date: Date, key: CalendarDateKey) => void;
+    labels?: CalendarLabels;
+    accessibilityLabel?: string;
+    testID?: string;
+};
+export type CalendarRef = {
+    goToMonth: (month: Date | CalendarPageKey, animated?: boolean) => void;
+    goToToday: (animated?: boolean) => void;
+    next: (animated?: boolean) => void;
+    previous: (animated?: boolean) => void;
+    setMode: (mode: CalendarViewMode, animated?: boolean) => void;
+    /** Move the roving focus to a specific day (screen reader / external keyboard). */
+    focusDay: (key: CalendarDateKey) => void;
+};
+//# sourceMappingURL=types.d.ts.map

package/components/uis/Calendar/types.d.ts.map

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

package/components/uis/Calendar/types.js

@@ -0,0 +1 @@
+export {};

package/components/uis/Calendar/useCalendarState.d.ts

@@ -0,0 +1,66 @@
+import type { CalendarDateKey, CalendarDisabledResolver, CalendarViewMode, WeekStart } from './types';
+/**
+ * Controlled first: the prop wins whenever it is not `undefined`, and the internal
+ * state is only used as the uncontrolled fallback.
+ */
+export declare function useControllable<T>(controlled: T | undefined, initial: T): [T, (next: T) => void];
+/**
+ * "Today" as a local noon date that re-arms itself at local midnight and also
+ * refreshes when the app returns to the foreground, so a device that slept through
+ * midnight still moves the highlight.
+ */
+export declare function useToday(explicit?: Date | CalendarDateKey): Date;
+/** Every spring and timing in the component collapses to duration 0 when this is on. */
+export declare function useReduceMotion(): boolean;
+export type CalendarDisabledState = {
+    resolver: CalendarDisabledResolver;
+    version: number;
+    minKey: CalendarDateKey | null;
+    maxKey: CalendarDateKey | null;
+};
+/**
+ * Precedence, first match wins:
+ * `marker.disabled` → `disabledDates` → `minDate`/`maxDate` → `isDateDisabled`.
+ * Range checks are lexicographic string compares, which are allocation free and
+ * timezone proof because `yyyy-MM-dd` sorts chronologically.
+ */
+export declare function useDisabledState(args: {
+    minDate?: Date | CalendarDateKey;
+    maxDate?: Date | CalendarDateKey;
+    disabledDates?: ReadonlySet<CalendarDateKey> | readonly CalendarDateKey[];
+    isDateDisabled?: (date: Date, key: CalendarDateKey) => boolean;
+}): CalendarDisabledState;
+export type CalendarKeyboardAction = {
+    type: 'move';
+    key: CalendarDateKey;
+} | {
+    type: 'select';
+} | null;
+/**
+ * One handler covers the whole grid. Moving past a page edge simply targets a day
+ * outside the mounted page, and the caller pages to it while keeping focus.
+ */
+export declare function resolveKeyboardAction(args: {
+    key: string;
+    shiftKey: boolean;
+    focusedKey: CalendarDateKey;
+    weekStart: WeekStart;
+    isRTL: boolean;
+    mode: CalendarViewMode;
+}): CalendarKeyboardAction;
+/**
+ * Keeps the previous object for as long as a SHALLOW value compare says nothing
+ * changed.
+ *
+ * `labels`, `styles` and `formatters` are written as inline object literals at
+ * almost every call site — `labels={{today: t('calendar.today')}}` is the only
+ * way to localize the component — and a fresh identity there invalidates
+ * `chrome`, which re-renders all 42 day cells on every parent render. `palette`
+ * already compared by value for exactly this reason; these three did not.
+ *
+ * One level deep only. A caller writing `styles={{dayText: {fontWeight: '600'}}}`
+ * fully inline still allocates a new nested object every render and still pays;
+ * hoist the inner style object or wrap it in `useMemo`.
+ */
+export declare function useShallowStable<T extends object | undefined>(value: T): T;
+//# sourceMappingURL=useCalendarState.d.ts.map

package/components/uis/Calendar/useCalendarState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCalendarState.d.ts","sourceRoot":"","sources":["../../../../src/components/uis/Calendar/useCalendarState.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,eAAe,EACf,wBAAwB,EACxB,gBAAgB,EAChB,SAAS,EACV,MAAM,SAAS,CAAC;AAYjB;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAC/B,UAAU,EAAE,CAAC,GAAG,SAAS,EACzB,OAAO,EAAE,CAAC,GACT,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC,CAcxB;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,GAAG,eAAe,GAAG,IAAI,CAwDhE;AAED,wFAAwF;AACxF,wBAAgB,eAAe,IAAI,OAAO,CAiCzC;AAID,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,EAAE,wBAAwB,CAAC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC;IAC/B,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC;CAChC,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,OAAO,CAAC,EAAE,IAAI,GAAG,eAAe,CAAC;IACjC,OAAO,CAAC,EAAE,IAAI,GAAG,eAAe,CAAC;IACjC,aAAa,CAAC,EAAE,WAAW,CAAC,eAAe,CAAC,GAAG,SAAS,eAAe,EAAE,CAAC;IAC1E,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC;CAChE,GAAG,qBAAqB,CAkDxB;AAED,MAAM,MAAM,sBAAsB,GAC9B;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,eAAe,CAAA;CAAC,GACpC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAC,GAChB,IAAI,CAAC;AAET;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,eAAe,CAAC;IAC5B,SAAS,EAAE,SAAS,CAAC;IACrB,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,gBAAgB,CAAC;CACxB,GAAG,sBAAsB,CAqCzB;AA8BD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAU1E"}