@npm-questionpro/wick-ui-lib 2.0.0-next.32 → 2.0.0-next.34

package/dist/components/calendar/WuCalendar.d.ts

@@ -1,26 +1,42 @@
 import { DateRange, Matcher, PropsMulti, PropsRange, PropsSingle } from 'react-day-picker';
 import React from 'react';
 type ISharedProps = {
+    /** Earliest selectable and navigable date. Months before this are unreachable. */
     min?: Date;
+    /** Latest selectable and navigable date. Months after this are unreachable. */
     max?: Date;
+    /** Dates to disable. Accepts any react-day-picker Matcher — e.g. `{before: new Date()}` or `{dayOfWeek: [0, 6]}`. */
     disabled?: Matcher | Matcher[];
 };
 type ISingleProps = ISharedProps & {
+    /** @default 'single' */
     mode?: 'single';
+    /** Controlled selected date. */
     selected?: Date;
+    /** Called when the user selects or deselects a date. */
     onSelect?: PropsSingle['onSelect'];
+    /** Prevents deselecting the current date when clicked again. */
     required?: boolean;
+    /** Initial month to display on mount. Falls back to the current month. */
+    defaultMonth?: Date;
 };
 type IMultipleProps = ISharedProps & {
     mode: 'multiple';
+    /** Controlled array of selected dates. */
     selected?: Date[];
+    /** Called when the selection changes. */
     onSelect?: PropsMulti['onSelect'];
 };
 type IRangeProps = ISharedProps & {
     mode: 'range';
+    /** Controlled selected range with `from` and `to`. */
     selected?: DateRange;
+    /** Called when the range changes. */
     onSelect?: PropsRange['onSelect'];
+    /** Which panel shows the current month — the other panel shows the adjacent month. @default 'end' */
     currentMonthPosition?: 'start' | 'end';
+    /** Initial month to display on mount. Overrides the `currentMonthPosition` default. */
+    defaultMonth?: Date;
 };
 export type IWuCalendarProps = ISingleProps | IMultipleProps | IRangeProps;
 /**

package/dist/components/calendar/internal/RangeWrapper.d.ts

@@ -4,6 +4,7 @@ type IRangeCalendarProps = Partial<PropsBase> & {
     selected?: DateRange;
     onSelect?: PropsRange['onSelect'];
     currentMonthPosition?: 'start' | 'end';
+    defaultMonth?: Date;
 };
-export declare function RangeCalendar({ disabled, selected, onSelect, currentMonthPosition, ...dayPickerProps }: IRangeCalendarProps): React.JSX.Element;
+export declare function RangeCalendar({ disabled, selected, onSelect, currentMonthPosition, defaultMonth, ...dayPickerProps }: IRangeCalendarProps): React.JSX.Element;
 export {};

package/dist/components/menu/ui/WuMenuItemGroup.d.ts

@@ -1,3 +1,4 @@
+import React from 'react';
 import { DropdownMenuGroup } from '@/base/ui/dropdownMenu';
 export declare const WuMenuItemGroup: React.FC<React.ComponentProps<typeof DropdownMenuGroup> & {
     /**

package/dist/components/menu/ui/WuMenuRadioItem.d.ts

@@ -1,3 +1,4 @@
+import React from 'react';
 export interface IWuMenuRadioItemOption {
     value: string;
     /**

package/dist/components/menu/ui/WuSubMenu.d.ts

@@ -1,3 +1,4 @@
+import React from 'react';
 import { DropdownMenuSub } from '@/base/ui/dropdownMenu';
 export interface IWuSubMenuProps extends Omit<React.ComponentProps<typeof DropdownMenuSub>, 'onOpenChange'> {
     /**

package/dist/components/pickers/datePicker/WuDatePicker.d.ts

@@ -2,11 +2,22 @@ import React from 'react';
 import { IWuCalendarProps } from '../../calendar';
 import { IPickerShellProps } from '../_shared/PickerShell';
 export interface IWuDatePickerProps extends IPickerShellProps {
+    /** Controlled selected date. Accepts a `Date` object or an ISO date string. */
     value?: Date | string;
+    /** Called when the user confirms a selection via Apply. */
     onChange?: (date?: Date) => void;
+    /** Earliest selectable and navigable date. */
     minDate?: Date;
+    /** Latest selectable and navigable date. */
     maxDate?: Date;
+    /** Dates to disable. Accepts any react-day-picker Matcher — e.g. `{before: new Date()}`. */
     disabledDate?: IWuCalendarProps['disabled'];
+    /** Prevents Apply until a date is selected. */
     required?: boolean;
 }
+/**
+ * Popover-based single date picker with a calendar, label, and Apply / Reset actions.
+ *
+ * @summary Pick a single date from a popover calendar; supports controlled value, bounds, and disabled dates.
+ */
 export declare function WuDatePicker({ value, onChange, minDate, maxDate, disabledDate, required, Label, onReset, formatString, ...props }: IWuDatePickerProps): React.JSX.Element;

package/dist/components/pickers/dateRangePicker/WuDateRangePicker.d.ts

@@ -4,16 +4,32 @@ import { IPickerShellProps } from '../_shared/PickerShell';
 import { DateRange } from 'react-day-picker';
 import { IRangeHeaderProps } from './internal/RangeHeader';
 export interface IWuDateRangePickerProps extends Omit<IPickerShellProps, 'onChange' | 'children' | 'value'> {
+    /** Controlled selected date range with `from` and `to`. */
     value?: DateRange;
+    /** Called when the user confirms a range via Apply. */
     onChange?: (range?: DateRange) => void;
+    /** Called when the user clicks Reset. */
     onReset?: () => void;
+    /** Earliest selectable and navigable date. */
     minDate?: Date;
+    /** Latest selectable and navigable date. */
     maxDate?: Date;
+    /** Dates to disable. Accepts any react-day-picker Matcher. */
     disabledDate?: IWuCalendarProps['disabled'];
+    /** Additional preset items appended to the header dropdown. Each item needs a unique `value` number. */
     presetRanges?: IRangeHeaderProps['presetRanges'];
+    /** Whether to include the built-in presets (Last week, Last month…). @default true */
     append?: IRangeHeaderProps['append'];
+    /** Whether rolling presets (e.g. Last week) include today as the end date. @default false */
     includeToday?: IRangeHeaderProps['includeToday'];
+    /** Which panel shows the current month when no selection is present. @default 'end' */
     currentMonthPosition?: 'start' | 'end';
+    /** Prevents Apply until both `from` and `to` are selected. */
     required?: boolean;
 }
+/**
+ * Popover-based date range picker with preset shortcuts, inline text inputs, and Apply / Reset actions.
+ *
+ * @summary Pick a date range from a popover calendar; supports preset shortcuts, bounds, and controlled value.
+ */
 export declare function WuDateRangePicker({ value, onChange, onReset, minDate, maxDate, disabledDate, Label, presetRanges, append, includeToday, currentMonthPosition, required, formatString, onOpenChange, ...props }: IWuDateRangePickerProps): React.JSX.Element;

package/dist/components/pickers/dateRangePicker/internal/RangeHeader.d.ts

@@ -3,6 +3,8 @@ import { DateRange } from 'react-day-picker';
 export type IPresetItem = {
     label: string;
     value: number;
+    /** Hardcoded date range — when present, used as-is instead of computing from `value` */
+    range?: DateRange;
 };
 export interface IRangeHeaderProps {
     presetRanges?: IPresetItem[];

package/dist/components/segmentedSelector/WuSegmentedSelector.d.ts

@@ -0,0 +1,13 @@
+import { ToggleGroup } from '@base-ui/react/toggle-group';
+import React from 'react';
+export interface IWuSegmentedSelectorProps extends Omit<ToggleGroup.Props, 'value' | 'defaultValue' | 'onValueChange' | 'onChange' | 'multiple' | 'orientation'> {
+    value?: string;
+    defaultValue?: string;
+    onChange?: (value: string) => void;
+    size?: 'sm' | 'md' | 'lg';
+    iconOnly?: boolean;
+}
+export declare const WuSegmentedSelector: {
+    ({ value, defaultValue, onChange, size, iconOnly, disabled, className, children, ...props }: IWuSegmentedSelectorProps): React.JSX.Element;
+    displayName: string;
+};

package/dist/components/segmentedSelector/hooks/useSegmentedIndicator.d.ts

@@ -0,0 +1,2 @@
+import { type RefObject } from 'react';
+export declare function useSegmentedIndicator(rootRef: RefObject<HTMLDivElement | null>, selectionKey: unknown): void;

package/dist/components/segmentedSelector/index.d.ts

@@ -0,0 +1,4 @@
+export { WuSegmentedSelector } from './WuSegmentedSelector';
+export type { IWuSegmentedSelectorProps } from './WuSegmentedSelector';
+export { WuSegmentedSelectorItem } from './subComponents/WuSegmentedSelectorItem';
+export type { IWuSegmentedSelectorItemProps } from './subComponents/WuSegmentedSelectorItem';

package/dist/components/segmentedSelector/subComponents/WuSegmentedSelectorItem.d.ts

@@ -0,0 +1,6 @@
+import { Toggle } from '@base-ui/react/toggle';
+export interface IWuSegmentedSelectorItemProps extends Omit<Toggle.Props, 'className'> {
+    value: string;
+    className?: string;
+}
+export declare const WuSegmentedSelectorItem: import("react").ForwardRefExoticComponent<Omit<IWuSegmentedSelectorItemProps, "ref"> & import("react").RefAttributes<HTMLButtonElement>>;

package/dist/index.d.ts

@@ -34,7 +34,7 @@ export * from './components/pagination';
 export * from './components/popover';
 export * from './components/radio';
 export * from './components/scrollArea';
-export * from './components/segment';
+export * from './components/segmentedSelector';
 export * from './components/select';
 export * from './components/sidebar';
 export * from './components/spotlight';