@acronis-platform/ui-react 0.61.0 → 0.62.0

package/dist/react.js.map

@@ -1 +1 @@
-{"version":3,"file":"react.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"react.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/src/components/ui/calendar-panel/__tests__/calendar-panel-utils.test.d.ts

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

package/dist/src/components/ui/calendar-panel/calendar-panel-utils.d.ts

@@ -0,0 +1,55 @@
+import { CalendarPanelSelected, CalendarPanelVariant } from './calendar-panel';
+import { DayPickerLocale, DayPickerProps } from 'react-day-picker';
+/** Number of years offered on each side of the current year by default. */
+export declare const DEFAULT_YEAR_SPAN = 50;
+/** A `{value, label}` pair for one `InputSelect` option in the header dropdowns. */
+export interface CalendarSelectItem<T> {
+    value: T;
+    label: string;
+}
+/**
+ * Resolves the year dropdown's bounds: an explicit `fromYear`/`toYear` wins,
+ * otherwise falls back to `currentYear` ± `span`.
+ */
+export declare function resolveYearRange(fromYear: number | undefined, toYear: number | undefined, currentYear: number, span?: number): {
+    fromYear: number;
+    toYear: number;
+};
+/** Day-of-week index DayPicker accepts for `weekStartsOn` (0 = Sunday). */
+export type WeekStartsOn = 0 | 1 | 2 | 3 | 4 | 5 | 6;
+/**
+ * Resolves the week's first day: an explicit `weekStartsOn` wins, then the
+ * `locale`'s own week start, then Monday (per the design default).
+ */
+export declare function resolveWeekStartsOn(weekStartsOn: WeekStartsOn | undefined, locale: DayPickerLocale | undefined): WeekStartsOn;
+/**
+ * Builds the 12 month dropdown items. Formats each from year 2000 (a leap
+ * year), so every month — including February 29 — formats from a valid date.
+ */
+export declare function buildMonthItems(formatMonthLabel: (date: Date) => string): CalendarSelectItem<number>[];
+/**
+ * Builds the year dropdown items spanning `fromYear`..`toYear` inclusive.
+ * An inverted range (`toYear < fromYear`) clamps to a single `fromYear` item
+ * rather than producing an empty or negative-length list.
+ */
+export declare function buildYearItems(fromYear: number, toYear: number): CalendarSelectItem<number>[];
+/**
+ * Backs a header-dropdown navigation target off so the last of `numberOfMonths`
+ * displayed months doesn't run past `endMonth`. Mirrors react-day-picker's own
+ * `getInitialMonth` back-off — its `goToMonth` only clamps the *first* displayed
+ * month to `endMonth`, so for a two-month `range` panel, requesting a first month
+ * within one month of `endMonth` (e.g. `endMonth` itself) leaves the second month
+ * past the bound, and `getDisplayMonths` silently drops it instead of the pair
+ * sliding back.
+ */
+export declare function clampNavigationTarget(target: Date, endMonth: Date, numberOfMonths: number): Date;
+/**
+ * Assembles DayPicker's mode-specific selection props from `variant`. DayPicker's
+ * props are a discriminated union keyed by a literal `mode`, so each branch is
+ * built separately (rather than a single object with `mode: variant`) — a
+ * literal tag is what lets TypeScript pick the matching union member without
+ * an `as DayPickerProps` assertion. `selected`/`onSelect` are cast per branch
+ * to their branch-specific shape only, which the discriminated `CalendarPanelProps`
+ * union above guarantees is safe at the call site.
+ */
+export declare function buildModeProps(variant: CalendarPanelVariant, selected: CalendarPanelSelected, onSelect: ((selected: CalendarPanelSelected, triggerDate: Date) => void) | undefined, min: number | undefined, max: number | undefined): DayPickerProps;

package/dist/src/components/ui/calendar-panel/calendar-panel.d.ts

@@ -0,0 +1,112 @@
+import { DateRange, DayButton, DayPickerLocale, Matcher, MonthCaptionProps } from 'react-day-picker';
+import * as React from 'react';
+export type CalendarPanelVariant = 'single' | 'multiple' | 'range';
+/** Selected value, shaped by the active `variant`. */
+export type CalendarPanelSelected = Date | Date[] | DateRange | undefined;
+/**
+ * The header of one month column: a month `InputSelect` and a year `InputSelect`.
+ * Replaces DayPicker's `MonthCaption`.
+ */
+declare function CalendarHeader({ calendarMonth, displayIndex, className, ...props }: MonthCaptionProps): import("react/jsx-runtime").JSX.Element;
+declare namespace CalendarHeader {
+    var displayName: string;
+}
+/**
+ * One day cell (Figma's "CalendarItem") — a flat 32×32 square. `data-active`
+ * (a selected day or either range endpoint) and `data-range-middle` are mutually
+ * exclusive, so their backgrounds never compete.
+ */
+declare function CalendarItem({ className, day, modifiers, ...props }: React.ComponentProps<typeof DayButton>): import("react/jsx-runtime").JSX.Element;
+declare namespace CalendarItem {
+    var displayName: string;
+}
+interface CalendarPanelSharedProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'onSelect' | 'defaultValue'> {
+    /**
+     * Text direction. Forwarded to `DayPicker` explicitly — an ancestor's `dir`
+     * mirrors the panel's CSS layout automatically (logical properties), but
+     * `react-day-picker` only flips its Arrow Left/Right keyboard roaming when
+     * `dir` is passed to it directly, so it must also be passed here.
+     */
+    dir?: 'ltr' | 'rtl';
+    /** Uncontrolled initial month shown. */
+    defaultMonth?: Date;
+    /** Controlled month shown (the first month, for `range`). */
+    month?: Date;
+    /** Called when the displayed month changes (header dropdowns). */
+    onMonthChange?: (month: Date) => void;
+    /** Days that cannot be selected. */
+    disabled?: Matcher | Matcher[];
+    /** Minimum number of selectable days (`multiple` / `range`; ignored for `single`). */
+    min?: number;
+    /** Maximum number of selectable days (`multiple` / `range`; ignored for `single`). */
+    max?: number;
+    /** Render the leading/trailing days of the adjacent months. */
+    showOutsideDays?: boolean;
+    /**
+     * First day of the week (0 = Sunday). Defaults to `locale`'s own week start,
+     * falling back to Monday (per the design) when no `locale` is given.
+     */
+    weekStartsOn?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
+    /**
+     * First year offered by the year dropdown and the earliest month the grid
+     * can navigate to. Defaults to 50 years back.
+     */
+    fromYear?: number;
+    /**
+     * Last year offered by the year dropdown and the latest month the grid can
+     * navigate to. Defaults to 50 years ahead.
+     */
+    toYear?: number;
+    /**
+     * Localizes weekday names and DayPicker's default day-cell/caption accessible
+     * labels (e.g. `import { es } from 'react-day-picker/locale'`). Defaults to
+     * date-fns `enUS`. Does not translate `monthLabel`/`yearLabel`/`cancelLabel`/
+     * `applyLabel`/`formatMonthLabel` — those are separate props the consumer
+     * must localize themselves.
+     */
+    locale?: DayPickerLocale;
+    /** Accessible name of the month dropdown. */
+    monthLabel?: string;
+    /** Accessible name of the year dropdown. */
+    yearLabel?: string;
+    /** Formats a month's name for the month dropdown. Defaults to `locale`-aware `date-fns` formatting. */
+    formatMonthLabel?: (date: Date) => string;
+    /** Footer "Cancel" button label (`multiple` / `range`). */
+    cancelLabel?: string;
+    /** Footer "Apply" button label (`multiple` / `range`). */
+    applyLabel?: string;
+    /** Called when the footer's Cancel button is pressed. */
+    onCancel?: () => void;
+    /** Called when the footer's Apply button is pressed. */
+    onApply?: () => void;
+}
+/** `variant="single"` (the default) — `selected` is a single optional `Date`. */
+export interface CalendarPanelSingleProps extends CalendarPanelSharedProps {
+    /** Selection mode + panel structure. `multiple`/`range` add the Cancel/Apply footer; `range` shows two months. */
+    variant?: 'single';
+    /** The selected date. Uncontrolled unless `onSelect` is provided. */
+    selected?: Date;
+    /** Called when the selection changes. Providing it makes `selected` controlled. */
+    onSelect?: (selected: Date | undefined, triggerDate: Date) => void;
+}
+/** `variant="multiple"` — `selected` is a `Date[]`, and the footer is shown. */
+export interface CalendarPanelMultipleProps extends CalendarPanelSharedProps {
+    variant: 'multiple';
+    selected?: Date[];
+    onSelect?: (selected: Date[] | undefined, triggerDate: Date) => void;
+}
+/** `variant="range"` — `selected` is a `DateRange`, two months render, and the footer is shown. */
+export interface CalendarPanelRangeProps extends CalendarPanelSharedProps {
+    variant: 'range';
+    selected?: DateRange;
+    onSelect?: (selected: DateRange | undefined, triggerDate: Date) => void;
+}
+/**
+ * `CalendarPanel`'s props, discriminated by `variant` — a `single` panel only
+ * accepts a `Date`, `multiple` only a `Date[]`, `range` only a `DateRange`, so
+ * mismatched `selected`/`onSelect` shapes are caught at the call site instead
+ * of silently reaching `react-day-picker` with the wrong shape at runtime.
+ */
+export type CalendarPanelProps = CalendarPanelSingleProps | CalendarPanelMultipleProps | CalendarPanelRangeProps;
+declare const CalendarPanel: React.ForwardRefExoticComponent<CalendarPanelProps & React.RefAttributes<HTMLDivElement>>;
+export { CalendarPanel, CalendarItem, CalendarHeader };

package/dist/src/components/ui/calendar-panel/index.d.ts

@@ -0,0 +1 @@
+export { CalendarPanel, CalendarItem, CalendarHeader, type CalendarPanelProps, type CalendarPanelSingleProps, type CalendarPanelMultipleProps, type CalendarPanelRangeProps, type CalendarPanelSelected, type CalendarPanelVariant, } from './calendar-panel';

package/dist/src/components/ui/filter-cards/filter-cards.d.ts

@@ -0,0 +1,11 @@
+import { useRender } from '@base-ui/react/use-render';
+import * as React from 'react';
+export interface FilterCardsProps extends React.ComponentPropsWithoutRef<'div'> {
+    /**
+     * Replace the rendered `<div>` with another element or component
+     * (Base UI composition).
+     */
+    render?: useRender.RenderProp;
+}
+declare const FilterCards: React.ForwardRefExoticComponent<FilterCardsProps & React.RefAttributes<HTMLDivElement>>;
+export { FilterCards };

package/dist/src/components/ui/filter-cards/index.d.ts

@@ -0,0 +1 @@
+export { FilterCards, type FilterCardsProps } from './filter-cards';

package/dist/src/index.d.ts

@@ -14,6 +14,7 @@ export * from './components/ui/breadcrumb';
 export * from './components/ui/button';
 export * from './components/ui/button-menu';
 export * from './components/ui/calendar';
+export * from './components/ui/calendar-panel';
 export * from './components/ui/card';
 export * from './components/ui/card-filter';
 export * from './components/ui/category-bar';
@@ -35,6 +36,7 @@ export * from './components/ui/dialog-welcome';
 export * from './components/ui/dropdown-menu';
 export * from './components/ui/empty';
 export * from './components/ui/field';
+export * from './components/ui/filter-cards';
 export * from './components/ui/funnel-chart';
 export * from './components/ui/grid';
 export * from './components/ui/histogram';