@npm-questionpro/wick-ui-lib 2.0.0-next.9 → 2.0.1

package/README.md

@@ -1,7 +1,7 @@
 # Getting Started
 
-Welcome! Whether you're a designer or a developer, this guide will help you get
-started and connect you to the essential resources you need.
+Welcome! Whether you're a designer or a developer, this guide will help you get started and connect you to the essential
+resources you need.
 
 #### Table of Contents
 
@@ -15,8 +15,7 @@ started and connect you to the essential resources you need.
 npm install @npm-questionpro/wick-ui-lib@latest`
 ```
 
-- Import the CSS files required for the library. Ideally in your `main.tsx/jsx`
-  or `index.tsx/jsx` file.
+- Import the CSS files required for the library. Ideally in your `main.tsx/jsx` or `index.tsx/jsx` file.
 
 ```tsx
 import '@npm-questionpro/wick-ui-lib/dist/style.css'

package/dist/base/ui/table.d.ts

@@ -7,4 +7,4 @@ declare const TableRow: React.ForwardRefExoticComponent<React.HTMLAttributes<HTM
 declare const TableHead: React.ForwardRefExoticComponent<React.ThHTMLAttributes<HTMLTableCellElement> & React.RefAttributes<HTMLTableCellElement>>;
 declare const TableCell: React.ForwardRefExoticComponent<React.TdHTMLAttributes<HTMLTableCellElement> & React.RefAttributes<HTMLTableCellElement>>;
 declare const TableCaption: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLTableCaptionElement> & React.RefAttributes<HTMLTableCaptionElement>>;
-export { Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, };
+export { Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow };

package/dist/components/button/WuButton.d.ts

@@ -1,13 +1,39 @@
-export interface IWuButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
-    variant?: 'primary' | 'secondary' | 'outline' | 'rounded' | 'link' | 'iconOnly';
-    size?: 'md' | 'sm' | 'mobile';
-    color?: 'primary' | 'upgrade' | 'error' | 'neutral';
+import React from 'react';
+import { Button } from '@base-ui/react/button';
+export type IWuButtonProps = Button.Props & {
+    ref?: React.Ref<HTMLButtonElement | null>;
+    /** Icon node rendered alongside the label. Position controlled by `iconPosition`. */
     Icon?: React.ReactNode;
+    /** Custom spinner shown while `loading=true`. Defaults to `<WuLoader color="white" size="sm" />`. */
+    Loader?: React.ReactNode;
+    /** Which side the icon appears on. @default 'left' */
     iconPosition?: 'left' | 'right';
-    floating?: boolean;
-    disabled?: boolean;
+    /** Visual structure of the button. @default 'primary' */
+    variant?: 'primary' | 'secondary' | 'outlined'
+    /** @deprecated use variant="outlined" instead */
+     | 'outline' | 'link'
+    /** @deprecated use size="icon" and variant="secondary" instead */
+     | 'iconOnly'
+    /** @deprecated use shape="rounded" instead */
+     | 'rounded';
+    /** Touch target and density. @default 'md' */
+    size?: 'sm' | 'md' | 'mobile';
+    /** Icon-only button. @default 'false' */
+    iconOnly?: boolean;
+    /** Semantic color palette. @default 'primary' */
+    color?: 'primary' | 'error' | 'upgrade' | 'neutral' | 'deep';
+    /** Border-radius style. */
+    shape?: 'rounded' | 'sharp' | 'default';
+    /** Shows spinner and blocks interaction. Sets `aria-busy`. */
     loading?: boolean;
+    /** Adds elevation shadow. Use for FAB-style buttons. */
+    floating?: boolean;
+    /** Toggled/active state. Sets `aria-pressed`. */
     selected?: boolean;
-    dir?: 'rtl' | 'ltr';
-}
-export declare const WuButton: import("react").ForwardRefExoticComponent<IWuButtonProps & import("react").RefAttributes<HTMLButtonElement>>;
+};
+/**
+ * Primary action trigger for user interactions.
+ *
+ * @summary action trigger — use variant + color to set visual weight and semantic intent
+ */
+export declare const WuButton: React.FC<IWuButtonProps>;

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

@@ -0,0 +1,48 @@
+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;
+/**
+ * Date picker built on react-day-picker with WuDesign styling.
+ *
+ * @summary Calendar for selecting single dates, multiple dates, or date ranges.
+ */
+export declare function WuCalendar(props: IWuCalendarProps): React.JSX.Element;
+export {};

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

@@ -1,5 +1 @@
-export { WuDatePicker } from './components/datePicker/WuDatePicker';
-export type { IWuDatePickerProps } from './components/datePicker/WuDatePicker';
-export { WuDateRangePicker } from './components/dateRangePicker/WuDateRangePicker';
-export type { IWuDateRangePickerProps } from './components/dateRangePicker/WuDateRangePicker';
-export { WuCalender } from './WuCalender';
+export { WuCalendar, type IWuCalendarProps } from './WuCalendar';

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

@@ -0,0 +1,6 @@
+import { DropdownOption } from 'react-day-picker';
+import { SelectHTMLAttributes } from 'react';
+export type IWuCalendarDropdownProps = {
+    options?: DropdownOption[];
+} & Omit<SelectHTMLAttributes<HTMLSelectElement>, 'children'>;
+export declare function WuCalendarDropdown({ options, value, onChange }: IWuCalendarDropdownProps): React.JSX.Element;

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

@@ -0,0 +1,10 @@
+import React from 'react';
+import { DateRange, PropsBase, PropsRange } from 'react-day-picker';
+type IRangeCalendarProps = Partial<PropsBase> & {
+    selected?: DateRange;
+    onSelect?: PropsRange['onSelect'];
+    currentMonthPosition?: 'start' | 'end';
+    defaultMonth?: Date;
+};
+export declare function RangeCalendar({ disabled, selected, onSelect, currentMonthPosition, defaultMonth, ...dayPickerProps }: IRangeCalendarProps): React.JSX.Element;
+export {};

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

@@ -1,3 +1,3 @@
-export type { IWuComboboxDivider, IWuComboboxGroup, IWuComboboxItem, IWuComboboxOption, } from './types/IWuComboboxOptions';
+export type { IWuComboboxDivider, IWuComboboxGroup, IWuComboboxItem, IWuComboboxOption } from './types/IWuComboboxOptions';
 export { WuCombobox } from './WuCombobox';
 export type { IWuComboboxProps } from './WuCombobox';

package/dist/components/menu/WuMenu.d.ts

@@ -2,10 +2,6 @@ import React from 'react';
 import { DropdownMenu } from '@/base/ui/dropdownMenu';
 export interface IWuMenuProps extends Omit<React.ComponentProps<typeof DropdownMenu>, 'open' | 'onOpenChange'> {
     name?: string;
-    /**
-     * @deprecated This property is no longer recommended. Use `MenuTitle` instead.
-     */
-    menuTitle?: string;
     MenuTitle?: React.ReactNode;
     Trigger?: React.ReactElement<HTMLBaseElement>;
     variant?: 'flat' | 'outlined';

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

@@ -3,7 +3,7 @@ export type { IWuMenuCheckboxItemProps } from './ui/WuMenuCheckboxItem';
 export { WuMenuItem } from './ui/WuMenuItem';
 export { WuMenuItemGroup } from './ui/WuMenuItemGroup';
 export { WuMenuRadioItem } from './ui/WuMenuRadioItem';
-export type { IWuMenuRadioItemOption, IWuMenuRadioItemProps, } from './ui/WuMenuRadioItem';
+export type { IWuMenuRadioItemOption, IWuMenuRadioItemProps } from './ui/WuMenuRadioItem';
 export { WuMenuSeparatorItem } from './ui/WuMenuSeparatorItem';
 export { WuSubMenu } from './ui/WuSubMenu';
 export { WuMenu } from './WuMenu';

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

@@ -1,8 +1,5 @@
+import React from 'react';
 import { DropdownMenuGroup } from '@/base/ui/dropdownMenu';
 export declare const WuMenuItemGroup: React.FC<React.ComponentProps<typeof DropdownMenuGroup> & {
-    /**
-     * @deprecated This property is no longer recommended. Use `Label` instead.
-     */
-    label?: string;
     Label: React.ReactNode;
 }>;

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

@@ -1,9 +1,6 @@
+import React from 'react';
 export interface IWuMenuRadioItemOption {
     value: string;
-    /**
-     * @deprecated This property is no longer recommended. Use `Label` instead.
-     */
-    label?: string;
     Label: React.ReactNode;
     disabled?: boolean;
 }

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

@@ -1,9 +1,6 @@
+import React from 'react';
 import { DropdownMenuSub } from '@/base/ui/dropdownMenu';
 export interface IWuSubMenuProps extends Omit<React.ComponentProps<typeof DropdownMenuSub>, 'onOpenChange'> {
-    /**
-     * @deprecated This property is no longer recommended. Use `Label` instead.
-     */
-    label?: string;
     Label: React.ReactNode;
     open?: boolean;
     onOpenChange?: (open: boolean) => void;

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

@@ -1,2 +1,2 @@
-export { WuModal, WuModalClose, WuModalContent, WuModalFooter, WuModalHeader, } from './WuModal';
+export { WuModal, WuModalClose, WuModalContent, WuModalFooter, WuModalHeader } from './WuModal';
 export type { IWuModalProps } from './WuModal';

package/dist/components/monthPicker/WuMonthPicker.d.ts

@@ -1,6 +1,6 @@
 import React from 'react';
-import { WuDatePickerTrigger } from '../calendar/ui/_trigger';
-export type IWuMonthPickerProps = Omit<React.ComponentProps<typeof WuDatePickerTrigger>, 'value' | 'onChange'> & {
+import { IPickerShellProps } from '../pickers/_shared/PickerShell';
+export type IWuMonthPickerProps = Omit<IPickerShellProps, 'Label'> & {
     value?: Date | string;
     onChange?: (value: Date) => void;
     min?: Date | string;
@@ -8,8 +8,6 @@ export type IWuMonthPickerProps = Omit<React.ComponentProps<typeof WuDatePickerT
     placeholder?: string;
     Label?: React.ReactNode;
     labelPosition?: 'top' | 'left' | 'right';
-    id?: string;
-    disabled?: boolean;
     readonly?: boolean;
     disabledMonths?: (`${number}-${number}-${number}` | Date)[];
 };

package/dist/components/pickers/_shared/PickerShell.d.ts

@@ -0,0 +1,48 @@
+import React from 'react';
+export interface IPickerShellProps extends Omit<React.ComponentProps<'button'>, 'value' | 'onChange'> {
+    /** Label rendered above (or beside) the trigger. */
+    Label?: React.ReactNode;
+    /** Position of the label relative to the trigger. @default 'top' */
+    labelPosition?: 'top' | 'bottom' | 'left' | 'right';
+    /** Controlled open state of the popover. */
+    open?: boolean;
+    /** Called when the popover opens or closes. */
+    onOpenChange?: (open: boolean) => void;
+    /** Placeholder shown when no value is selected. @default 'Select date' */
+    placeholder?: string;
+    /** Called when the user clicks Reset. */
+    onReset?: () => void;
+    /** @deprecated Will not be supported in future versions */
+    formatString?: string;
+    /** Popover placement relative to the trigger. */
+    position?: {
+        align: 'start' | 'end';
+        alignOffset?: number;
+        side: 'bottom' | 'top';
+        sideOffset?: number;
+    };
+    /** @deprecated Use position.align instead */
+    align?: 'start' | 'end';
+    /** @deprecated Use position.alignOffset instead */
+    alignOffset?: number;
+    /** @deprecated Use position.side instead */
+    side?: 'bottom' | 'top';
+    /** @deprecated Use position.sideOffset instead */
+    sideOffset?: number;
+    /** Replaces the default trigger. Receives the formatted value string. */
+    CustomTrigger?: (formattedText?: string) => React.ReactElement;
+    /** Visual style of the trigger button. @default 'outlined' */
+    variant?: 'primary' | 'outlined';
+    /** Marks the trigger as invalid — applies error border styling. */
+    invalid?: boolean;
+}
+interface IPickerShellInternalProps extends IPickerShellProps {
+    formattedText?: string;
+    children: React.ReactNode;
+    Footer?: React.ReactNode;
+    Header?: React.ReactNode;
+    onApply?: () => void;
+    disableApply?: boolean;
+}
+export declare function PickerShell({ children, className, Label, labelPosition, open, onOpenChange, placeholder, formattedText, Header, Footer, onApply, onReset, invalid, disableApply, position, CustomTrigger, variant, ...props }: IPickerShellInternalProps): React.JSX.Element;
+export {};

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

@@ -0,0 +1,23 @@
+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/datePicker/index.d.ts

@@ -0,0 +1 @@
+export * from './WuDatePicker';

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

@@ -0,0 +1,35 @@
+import React from 'react';
+import { IWuCalendarProps } from '../../calendar';
+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/index.d.ts

@@ -0,0 +1 @@
+export * from './WuDateRangePicker';

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

@@ -0,0 +1,7 @@
+import React from 'react';
+import { DateRange } from 'react-day-picker';
+export interface IRangeFooterProps {
+    selected?: DateRange;
+    onSelect?: (range: DateRange) => void;
+}
+export declare function RangeFooter({ selected, onSelect }: IRangeFooterProps): React.JSX.Element;

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

@@ -0,0 +1,16 @@
+import React from 'react';
+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[];
+    append?: boolean;
+    includeToday?: boolean;
+    selected?: DateRange;
+    onSelect?: (d: DateRange) => void;
+}
+export declare function RangeHeader({ presetRanges, append, includeToday, selected, onSelect, }: IRangeHeaderProps): React.JSX.Element;

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

@@ -0,0 +1,2 @@
+export * from './datePicker';
+export * from './dateRangePicker';

package/dist/components/radio/WuRadioGroup.d.ts

@@ -1,12 +1,26 @@
 import React from 'react';
 import { IWuRadioOption } from './types/IWuRadioOption';
 export interface IWuRadioGroupProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, 'onChange'> {
+    /** Radio options to render. Each requires `label` and `value`; optionally `disabled` or `required`. */
     options: IWuRadioOption[];
+    /** Initially selected value for uncontrolled usage. */
     defaultValue?: string;
+    /** Disables every option in the group. */
     disabled?: boolean;
+    /** Called with the new value when the selection changes. */
     onChange?: (e: string) => void;
+    /** Label for the whole group. */
     label?: string;
+    /** ID forwarded to the underlying RadioGroup root. */
     id?: string;
+    /** Text direction. */
     dir?: 'ltr' | 'rtl';
+    /** Layout orientation of the options. @default 'vertical' */
+    orientation?: 'horizontal' | 'vertical';
 }
+/**
+ * Group of radio buttons for single-choice selection.
+ *
+ * @summary Single-choice selector; supports vertical/horizontal orientation, disabled states, and RTL.
+ */
 export declare const WuRadioGroup: React.FC<IWuRadioGroupProps>;

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/components/stackedCard/index.d.ts

@@ -1,3 +1,3 @@
-export type { IWuStackedCardProps, IWuStackedCardOverlayProps, } from './WuStackedCard';
+export type { IWuStackedCardProps, IWuStackedCardOverlayProps } from './WuStackedCard';
 export { WuStackedCardOverlay, WuStackedCard } from './WuStackedCard';
 export { calculatePosition } from './utils/helper';

package/dist/components/stackedCard/utils/helper.d.ts

@@ -12,5 +12,5 @@ interface ICalcPosResult {
     position: number;
     styles: CSSProperties;
 }
-export declare const calculatePosition: ({ index, viewIndex, length, itemHeight, }: ICalcPosProps) => ICalcPosResult;
+export declare const calculatePosition: ({ index, viewIndex, length, itemHeight }: ICalcPosProps) => ICalcPosResult;
 export {};

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

@@ -3,4 +3,4 @@ export { WuSurveyItem } from './subComponents/WuSurveyItem';
 export { WuSurveyList } from './subComponents/WuSurveyList';
 export { WuSurveySource } from './subComponents/WuSurveySource';
 export { WuSurveySelect, type IWuSurveySelectProps } from './WuSurveySelect';
-export type { IWuSharedSurveyProps, IWuSurveyItemProps, IWuSurveyListProps, IWuSurveySourceProps, } from './types';
+export type { IWuSharedSurveyProps, IWuSurveyItemProps, IWuSurveyListProps, IWuSurveySourceProps } from './types';

package/dist/components/table/components/dataTable/WuDataTable.d.ts

@@ -19,6 +19,7 @@ export interface IWuDataTableProps<T> extends React.TableHTMLAttributes<HTMLTabl
     HeaderAction?: React.ReactNode;
     NoDataContent?: React.ReactNode;
     stickyHeader?: boolean;
+    maxHeight?: number | string;
     isRowExpandable?: boolean;
     hideHeader?: boolean;
     virtualization?: {
@@ -28,4 +29,4 @@ export interface IWuDataTableProps<T> extends React.TableHTMLAttributes<HTMLTabl
     };
     tableLayout?: 'fixed' | 'auto';
 }
-export declare const WuDataTable: <T>({ data, columns, isLoading, variant, sort, size, rowSelection, HeaderAction, NoDataContent, stickyHeader, CustomLoader, caption, virtualization, isRowExpandable, hideHeader, tableLayout, style, className, ...props }: IWuDataTableProps<T>) => React.JSX.Element;
+export declare const WuDataTable: <T>({ data, columns, isLoading, variant, sort, size, rowSelection, HeaderAction, NoDataContent, stickyHeader, maxHeight, CustomLoader, caption, virtualization, isRowExpandable, hideHeader, tableLayout, style, className, ...props }: IWuDataTableProps<T>) => React.JSX.Element;

package/dist/components/table/components/table/WuTable.d.ts

@@ -19,6 +19,7 @@ export interface IWuTableProps<T> extends React.TableHTMLAttributes<HTMLTableEle
         pageSize: number;
     };
     stickyHeader?: boolean;
+    maxHeight?: number | string;
     HeaderAction?: React.ReactNode;
     CustomLoader?: React.ReactNode;
     NoDataContent?: React.ReactNode;
@@ -32,4 +33,4 @@ export interface IWuTableProps<T> extends React.TableHTMLAttributes<HTMLTableEle
     };
     tableLayout?: 'fixed' | 'auto';
 }
-export declare const WuTable: <T>({ data, columns, variant, size, sort, filterText, pagination, stickyHeader, HeaderAction, CustomLoader, NoDataContent, isLoading, caption, rowSelection, isRowExpandable, hideHeader, virtualization, tableLayout, style, className, ...rest }: IWuTableProps<T>) => React.JSX.Element;
+export declare const WuTable: <T>({ data, columns, variant, size, sort, filterText, pagination, stickyHeader, maxHeight, HeaderAction, CustomLoader, NoDataContent, isLoading, caption, rowSelection, isRowExpandable, hideHeader, virtualization, tableLayout, style, className, ...rest }: IWuTableProps<T>) => React.JSX.Element;

package/dist/components/table/hooks/useRowSelection.d.ts

@@ -7,5 +7,5 @@ interface IUseRowSelectionProps<T> {
 interface IUseRowSelectionResult<T> {
     finalColumns: IWuTableColumnDef<T>[];
 }
-export declare const useRowSelection: <T>({ columns, rowSelection, }: IUseRowSelectionProps<T>) => IUseRowSelectionResult<T>;
+export declare const useRowSelection: <T>({ columns, rowSelection }: IUseRowSelectionProps<T>) => IUseRowSelectionResult<T>;
 export {};

package/dist/components/tooltip/WuTooltip.d.ts

@@ -1,15 +1,30 @@
 import React from 'react';
 import { TooltipTrigger } from '@/base/ui/tooltip';
 export interface IWuTooltipProps extends Omit<React.ComponentProps<typeof TooltipTrigger>, 'content'> {
+    /** Content shown inside the tooltip — text or any ReactNode. Omit or pass empty string to suppress. */
     content?: string | React.ReactNode;
+    /** Delay before the tooltip appears in milliseconds. @default 200 */
     duration?: number;
+    /** Preferred side to show the tooltip; auto-flips when there is insufficient viewport space. @default 'top' */
     position?: 'top' | 'right' | 'bottom' | 'left';
+    /** Gap between tooltip and trigger in pixels. @default 0 */
     positionOffset?: number;
+    /** Element that triggers the tooltip on hover or focus. */
     children: React.ReactNode;
+    /** Text direction set on the trigger wrapper span. */
     dir?: 'rtl' | 'ltr';
+    /** Renders an arrow pointing toward the trigger. @default false */
     showArrow?: boolean;
+    /** Controlled open state; pair with onOpenChange. */
     open?: boolean;
+    /** Called when the open state changes. */
     onOpenChange?: (open: boolean) => void;
+    /** Inline styles for the tooltip content container. */
     style?: React.CSSProperties;
 }
+/**
+ * Floating label that appears on hover or focus to explain a UI element.
+ *
+ * @summary Use to surface extra context for icon buttons, abbreviated labels, or dense UI without cluttering the layout.
+ */
 export declare const WuTooltip: React.ForwardRefExoticComponent<Omit<IWuTooltipProps, "ref"> & React.RefAttributes<HTMLSpanElement>>;

package/dist/components/typography/WuTypography.d.ts

@@ -1,20 +1,80 @@
 import React from 'react';
 import type { IWuIcons } from './iconTypes';
-export declare const WuText: React.FC<React.HTMLAttributes<HTMLParagraphElement> & {
+export interface IWuTextProps extends React.HTMLAttributes<HTMLParagraphElement> {
+    /** Body text scale. @default 'lg' */
     size?: 'sm' | 'md' | 'lg';
+    /** Underlying HTML element. @default 'div' */
     as?: 'p' | 'div' | 'span';
-}>;
-export declare const WuHeading: React.FC<React.HTMLAttributes<HTMLHeadingElement> & {
+}
+/**
+ * Body text for paragraphs and general content.
+ *
+ * @summary default text primitive — reach for it for any non-heading copy
+ */
+export declare const WuText: React.FC<IWuTextProps>;
+export interface IWuHeadingProps extends React.HTMLAttributes<HTMLHeadingElement> {
+    /** Heading scale; also picks the semantic tag (xl→h1 … sm→h4). @default 'xl' */
     size?: 'sm' | 'md' | 'lg' | 'xl';
-}>;
-export declare const WuSubtext: React.FC<React.HTMLAttributes<HTMLParagraphElement> & {
+}
+/**
+ * Section and page headings with matching semantic levels.
+ *
+ * @summary heading primitive — size drives both visual scale and h1–h4 tag
+ */
+export declare const WuHeading: React.FC<IWuHeadingProps>;
+export interface IWuSubtextProps extends React.HTMLAttributes<HTMLParagraphElement> {
+    /** Subtitle scale. @default 'lg' */
     size?: 'sm' | 'md' | 'lg';
+    /** Underlying HTML element. @default 'div' */
     as?: 'p' | 'div' | 'span';
-}>;
-export declare const WuDisplay: React.FC<React.HTMLAttributes<HTMLHeadingElement> & {
+}
+/**
+ * Secondary text for captions, labels, and metadata.
+ *
+ * @summary muted supporting text — use beneath or beside primary content
+ */
+export declare const WuSubtext: React.FC<IWuSubtextProps>;
+export interface IWuDisplayProps extends React.HTMLAttributes<HTMLHeadingElement> {
+    /** Display scale. @default 'lg' */
     size?: 'md' | 'lg';
+    /** Underlying HTML element. @default 'h1' */
     as?: 'h1' | 'h2' | 'h3' | 'h4' | 'div';
-}>;
-export declare const WuIcon: React.FC<React.BaseHTMLAttributes<HTMLBaseElement> & {
+}
+/**
+ * Oversized text for hero sections and page intros.
+ *
+ * @summary largest type ramp — sparing, attention-grabbing display copy
+ */
+export declare const WuDisplay: React.FC<IWuDisplayProps>;
+export interface IWuIconProps extends React.BaseHTMLAttributes<HTMLBaseElement> {
+    /** Icon-font identifier to render. */
     icon: IWuIcons;
-}>;
+}
+/**
+ * Renders an icon-font glyph as a decorative, accessible span.
+ *
+ * @summary icon-font primitive — size/color via text utilities
+ */
+export declare const WuIcon: React.FC<IWuIconProps>;
+/** Typography components WuNumber can render its value into via the `as` prop. */
+declare const numberTagMap: {
+    readonly WuText: React.FC<IWuTextProps>;
+    readonly WuHeading: React.FC<IWuHeadingProps>;
+    readonly WuSubtext: React.FC<IWuSubtextProps>;
+    readonly WuDisplay: React.FC<IWuDisplayProps>;
+};
+export interface IWuNumberProps extends React.HTMLAttributes<HTMLSpanElement> {
+    /** Intl.NumberFormat options — style, currency, notation, fraction digits, etc. */
+    format?: Intl.NumberFormatOptions;
+    /** BCP-47 locale tag. @default browser locale */
+    locale?: string;
+    /** Render the value inside a typography component instead of a bare span. @default 'span' */
+    as?: keyof typeof numberTagMap;
+}
+/**
+ * Formats a numeric value with `Intl.NumberFormat` and renders it in a styled span.
+ *
+ * @summary locale-aware number/currency/percent formatter — Intl options in, formatted text out
+ */
+export declare function WuNumber({ children, className, format, locale, as, ...rest }: IWuNumberProps): React.JSX.Element;
+export {};