@hotelrank/raw-grids 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,513 @@
+import { ButtonProps } from '@chakra-ui/react';
+import { ComboboxInputProps } from '@chakra-ui/react';
+import { ComboboxRootProps } from '@chakra-ui/react';
+import { ConditionalValue } from '@chakra-ui/react';
+import { default as default_2 } from 'react';
+import { ForwardRefExoticComponent } from 'react';
+import { JSX } from 'react';
+import { JSX as JSX_2 } from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+import { RefAttributes } from 'react';
+import { Store } from '@tanstack/store';
+
+export declare type ActionHeaderProps = {
+    backgroundColor?: string;
+    children?: default_2.ReactNode;
+    showActionColumn?: boolean;
+    width?: string;
+    showColumnVisibilityMenu?: boolean;
+    backgroundColorColumnVisibilityMenu?: string;
+    showSNo?: boolean;
+    indexChildren?: default_2.ReactNode;
+};
+
+export declare const addPreset: (pageKey: string, item: PresetItem) => void;
+
+export declare interface Column {
+    id: string;
+    label: string;
+    minWidth?: number | string;
+    align?: 'left' | 'center' | 'right';
+    sortable?: boolean;
+    backgroundColor?: string;
+}
+
+export declare interface ConfirmActionDialogProps {
+    open: boolean;
+    onClose: () => void;
+    onConfirm: () => void;
+    title?: string;
+    description?: string;
+    confirmLabel?: string;
+    cancelLabel?: string;
+    icon?: React.ReactNode;
+    confirmButtonColorScheme?: string;
+    isLoading?: boolean;
+}
+
+export declare interface ConfirmDeleteDialogProps {
+    open: boolean;
+    onClose: () => void;
+    onConfirm: () => void;
+    title?: string;
+    entityName: string;
+    confirmText?: string;
+    confirmLabel?: string;
+    isLoading?: boolean;
+}
+
+export declare function DataTable<T extends Record<string, unknown>>({ tableId, data: rowData, headers, loading, loadingChildren, skeletonLoading, emptyMessage, actions, page, pageSize, onPageChange, onPageSizeChange, density, totalCount, actionConfig, pageSizeOptions, onRowSelect, onRowSelectEvent, }: DataTableProps<T>): JSX_2.Element;
+
+export declare interface DataTableAction<T> {
+    icon: JSX.Element;
+    label: string;
+    onClick: (row: T) => void;
+    visible?: (row: T) => boolean;
+    colorScheme?: 'gray' | 'red' | 'orange' | 'yellow' | 'green' | 'teal' | 'blue' | 'cyan' | 'purple' | 'pink';
+}
+
+export declare interface DataTableProps<T> {
+    tableId: string;
+    headers?: Column[];
+    data?: T[];
+    loading?: boolean;
+    emptyMessage?: string;
+    actions?: DataTableAction<T>[];
+    page?: number;
+    pageSize?: number;
+    onPageChange?: (page: number) => void | undefined;
+    onPageSizeChange?: (size: number) => void | undefined;
+    density?: DensityType;
+    totalCount?: number;
+    actionConfig?: ActionHeaderProps;
+    loadingChildren?: JSX.Element;
+    skeletonLoading?: boolean;
+    pageSizeOptions?: number[];
+    onRowSelect?: (row: T, event?: default_2.MouseEvent) => void;
+    onRowSelectEvent?: 'left' | 'right';
+}
+
+export declare type DateTimeVariant = 'date' | 'time' | 'dateTime' | 'full' | 'relative' | 'short';
+
+export declare const deletePreset: (pageKey: string, id: string) => void;
+
+export declare type DensityType = 'sm' | 'md' | 'lg';
+
+export declare interface FilterOption<T = unknown> {
+    label: ReactNode;
+    value: T;
+    displayValue?: string | ReactNode;
+}
+
+export declare const Filters: ({ title, filters, onVisibilityChange, onReorder, onSizeChange, onClear, maxToolbarUnits, pageKey, onLoadPreset, activePresetName, filterDrawerSize, }: IMainFilterType) => JSX_2.Element;
+
+export declare function formatDateTime({ value, variant, format, fallback, }: FormatDateTimeProps): string;
+
+export declare interface FormatDateTimeProps {
+    value: string | Date | number | null | undefined;
+    variant?: DateTimeVariant;
+    format?: string;
+    fallback?: string;
+}
+
+export declare const getColumnWidthKey: (tableId: string) => string;
+
+/**
+ * getOption – outside React
+ */
+export declare function getOption<T = any>(client: OptionsClient, key: string): Promise<T | undefined>;
+
+export declare const getPresets: (pageKey: string) => PresetItem[];
+
+export declare class HttpOptionsApi implements OptionsApi {
+    private baseUrl;
+    constructor(baseUrl: string);
+    fetchLatest(keys: string[]): Promise<OptionValue[]>;
+}
+
+export declare interface IFilterConfig<T = unknown> {
+    id: string;
+    label: string;
+    type?: 'date' | 'text' | 'select' | 'checkbox' | 'radio' | 'number' | 'combobox' | 'date-range';
+    value: string | number | undefined | boolean | Date;
+    options?: FilterOption<T>[];
+    onChange?: (value: any) => void;
+    visible: boolean;
+    size?: 0.5 | 1 | 1.5 | 2 | 2.5 | 3 | 3.5 | 4 | 4.5 | 5;
+    customComponent?: JSX.Element;
+    placeholder?: string;
+    startDate?: string | null;
+    endDate?: string | null;
+}
+
+export declare interface IFilterDrawerProps {
+    filters: IFilterConfig[];
+    onVisibilityChange?: (id: string, visible: boolean) => void;
+    onReorder?: (newOrder: IFilterConfig[]) => void;
+    onSizeChange?: (id: string, size: number) => void;
+    onClear?: () => void;
+    maxToolbarUnits?: number;
+    filterDrawerSize?: 'md' | 'lg' | 'sm';
+    pageKey?: string;
+    onLoadPreset?: (filters: IFilterConfig[], presetName?: string) => void;
+    activePresetName?: string | null;
+}
+
+export declare interface IMainFilterType {
+    title?: JSX.Element;
+    filters: IFilterConfig[];
+    onVisibilityChange?: (id: string, visible: boolean) => void;
+    onReorder?: (newOrder: IFilterConfig[]) => void;
+    onSizeChange?: (id: string, size: number) => void;
+    onClear?: () => void;
+    maxToolbarUnits?: number;
+    filterDrawerSize?: 'md' | 'lg' | 'sm';
+    pageKey?: string;
+    currentFilters?: Record<string, unknown>;
+    onLoadPreset?: (filters: IFilterConfig[], presetName?: string) => void;
+    activePresetName?: string | null;
+}
+
+export declare interface IMDSButtonTypes {
+    onClick?: () => void;
+    size?: 'sm' | 'md' | 'lg' | 'xs';
+    variant?: ConditionalValue<'subtle' | 'solid' | 'outline' | 'ghost' | 'plain'>;
+    label?: string;
+    leftIcon?: React.ReactNode;
+    rightIcon?: React.ReactNode;
+    isDisabled?: boolean;
+    colorScheme?: 'blue' | 'red' | 'green' | 'yellow' | 'gray' | 'cyan' | 'orange' | 'purple' | string;
+    loading?: boolean;
+    loadingText?: string;
+    rounded?: 'sm' | 'md' | 'lg' | 'xl' | 'full' | 'xs';
+    type?: 'submit' | 'reset' | 'button';
+    textColor?: string;
+    borderColor?: string;
+}
+
+export declare interface IMDSCheckboxTypes {
+    value?: boolean;
+    onChange?: (value: boolean) => void;
+    size?: 'sm' | 'md' | 'lg';
+    label?: string;
+    helperText?: string;
+    isDisabled?: boolean;
+    required?: boolean;
+    errorText?: string;
+}
+
+export declare interface IMDSComboboxTypes<T> {
+    label?: string;
+    size?: 'sm' | 'md' | 'lg';
+    width?: string | number;
+    variant?: 'outline' | 'subtle';
+    items?: T[];
+    loading?: boolean;
+    error?: boolean;
+    placeholder?: string;
+    helpText?: string;
+    errorMessage?: string;
+    value?: T | null;
+    itemToString: (item: T) => string;
+    itemToValue: (item: T) => string;
+    renderItem: (item: T) => React.ReactNode;
+    onInputChange?: (value: string) => void;
+    onSelect?: (item: T) => void;
+    rootProps?: Partial<ComboboxRootProps>;
+    inputProps?: Partial<ComboboxInputProps>;
+    controlProps?: any;
+    contentProps?: any;
+    itemProps?: any;
+    visible?: boolean;
+}
+
+export declare type IMDSDatePickerTypes = {
+    value?: Date;
+    onChange: (date: Date | null) => void;
+    width?: string;
+    visible?: boolean;
+    label?: string;
+};
+
+export declare type IMDSDateRangePickerTypes = {
+    startDate?: Date;
+    endDate?: Date;
+    onChange: (start: Date | null, end: Date | null) => void;
+    width?: string;
+    showLabel?: boolean;
+    label?: string;
+    visible?: boolean;
+};
+
+export declare interface IMDSInputTypes {
+    icon?: React.ReactNode;
+    value?: string | number;
+    onChange?: (value: string) => void;
+    placeholder?: string;
+    size?: 'sm' | 'md' | 'lg' | 'xs';
+    width?: string;
+    variant?: ConditionalValue<'subtle' | 'outline' | 'flushed' | undefined>;
+    label?: string;
+    helperText?: string;
+    isDisabled?: boolean;
+    required?: boolean;
+    errorText?: string;
+    visible?: boolean;
+    type?: string;
+    min?: number;
+    max?: number;
+    step?: number;
+}
+
+export declare interface IMDSPinInputTypes {
+    value: string;
+    onChange?: (value: string) => void;
+    length?: number;
+    size?: 'xs' | 'sm' | 'md' | 'lg';
+    isDisabled?: boolean;
+    label?: string;
+    helperText?: string;
+    errorText?: string;
+    required?: boolean;
+    visible?: boolean;
+}
+
+export declare interface IMDSSelectBoxTypes<T = unknown> {
+    options: FilterOption<T>[];
+    value?: string;
+    onChange?: (value: T | undefined) => void;
+    placeholder?: string;
+    size?: 'sm' | 'md' | 'lg' | 'xs';
+    width?: string;
+    variant?: ConditionalValue<'subtle' | 'outline' | undefined>;
+    label?: string;
+    helperText?: string;
+    isDisabled?: boolean;
+    required?: boolean;
+    errorText?: string;
+    visible?: boolean;
+}
+
+declare type Listener = (value: OptionValue | undefined) => void;
+
+export declare const loadOrder: (pageKey: string) => string[];
+
+export declare const MDSButton: ({ onClick, size, variant, label, leftIcon, rightIcon, isDisabled, colorScheme, loading, loadingText, rounded, type, textColor, borderColor, }: IMDSButtonTypes) => JSX_2.Element;
+
+export declare const MDSCheckbox: ({ value, onChange, size, label, helperText, isDisabled, required, errorText, }: IMDSCheckboxTypes) => JSX_2.Element;
+
+export declare function MDSCombobox<T>({ label, size, width, variant, items, itemToString, itemToValue, renderItem, value, loading, error, errorMessage, placeholder, helpText, onInputChange, onSelect, visible, rootProps, inputProps, controlProps, contentProps, itemProps, }: IMDSComboboxTypes<T>): JSX_2.Element;
+
+export declare function MDSConfirmActionDialog({ open, onClose, onConfirm, title, description, confirmLabel, cancelLabel, icon, isLoading, confirmButtonColorScheme, }: ConfirmActionDialogProps): JSX_2.Element;
+
+export declare function MDSConfirmDeleteDialog({ open, onClose, onConfirm, title, entityName, confirmText, confirmLabel, isLoading, }: ConfirmDeleteDialogProps): JSX_2.Element;
+
+export declare function MDSDatePicker({ value, onChange, width, visible, label, }: IMDSDatePickerTypes): JSX_2.Element;
+
+export declare function MDSDateRangePicker({ startDate, endDate, onChange, width, // Slightly wider for " to "
+    showLabel, label, visible, }: IMDSDateRangePickerTypes): JSX_2.Element;
+
+export declare const MDSDialogAction: default_2.ForwardRefExoticComponent<ButtonProps & default_2.RefAttributes<HTMLButtonElement>>;
+
+export declare const MDSDialogActions: default_2.FC<SlotProps>;
+
+export declare const MDSDialogBody: default_2.FC<SlotProps>;
+
+export declare const MDSDialogWrapper: ({ open, onClose, title, children, width, position, refetch, loading, }: MDSDialogWrapperProps) => JSX_2.Element;
+
+export declare interface MDSDialogWrapperProps {
+    open: boolean;
+    onClose: () => void;
+    title: string;
+    children: ReactNode;
+    width?: string;
+    position?: string;
+    refetch?: () => Promise<any>;
+    loading?: boolean;
+}
+
+export declare const MDSInput: ({ icon, value, onChange, placeholder, size, variant, width, label, helperText, isDisabled, required, errorText, visible, type, min, max, step, }: IMDSInputTypes) => JSX_2.Element;
+
+export declare const MDSPinInput: ({ value, onChange, length, size, isDisabled, label, helperText, errorText, required, visible, }: IMDSPinInputTypes) => JSX_2.Element;
+
+export declare const MDSSelectBox: ({ options, label, value, onChange, placeholder, size, width, variant, helperText, isDisabled, required, errorText, visible, }: IMDSSelectBoxTypes) => JSX_2.Element;
+
+export declare interface OptionsApi {
+    fetchLatest(keys: string[]): Promise<OptionValue[]>;
+}
+
+export declare interface OptionsClient {
+    getKey<T = any>(key: string): Promise<T | undefined>;
+    getMultiKey<T = any>(keys: string[]): Promise<Record<string, T>>;
+    getRaw(key: string): OptionValue | undefined;
+    subscribe(key: string, cb: (value: OptionValue | undefined) => void): () => void;
+    hydrate(data: OptionValue[]): void;
+    clear(): void;
+}
+
+export declare class OptionsClientImpl implements OptionsClient {
+    private api;
+    private store;
+    private inflight;
+    constructor(api: OptionsApi);
+    getRaw(key: string): OptionValue | undefined;
+    getKey<T = any>(key: string): Promise<T | undefined>;
+    getMultiKey<T = any>(keys: string[]): Promise<Record<string, T>>;
+    subscribe(key: string, cb: Listener): () => void;
+    hydrate(data: OptionValue[]): void;
+    clear(): void;
+    private fetchMissing;
+}
+
+export declare function OptionsProvider({ client: { apiUrl }, children, }: {
+    client: {
+        apiUrl: string;
+    };
+    children: ReactNode;
+}): JSX_2.Element;
+
+export declare class OptionsStore {
+    private state;
+    private listeners;
+    get(key: string): OptionValue | undefined;
+    set(option: OptionValue): void;
+    setMany(options: OptionValue[]): void;
+    subscribe(key: string, listener: Listener): () => void;
+    private notify;
+    clear(): void;
+}
+
+export declare interface OptionValue {
+    key: string;
+    value: any;
+    value_type: ValueType;
+    timestamp: string;
+}
+
+/**
+ * prefetchOptions – warm cache
+ */
+export declare function prefetchOptions(client: OptionsClient, keys: string[]): Promise<void>;
+
+export declare interface PresetItem {
+    id: string;
+    name: string;
+    date: string;
+    values: Record<string, any>;
+}
+
+declare function RefreshButton({ refetch, isLoading, label, }: RefreshButtonProps): JSX_2.Element;
+export { RefreshButton as MDSRefreshButton }
+export { RefreshButton }
+
+declare type RefreshButtonProps = {
+    refetch: () => Promise<any>;
+    isLoading?: boolean;
+    label?: string;
+};
+
+export declare const saveOrder: (pageKey: string, filters: string[]) => void;
+
+export declare const savePresets: (pageKey: string, items: PresetItem[]) => void;
+
+export declare const setActionsConfig: (actionsConfig: ActionHeaderProps) => void;
+
+export declare function setColumnWidth(columnId: string, width: number): void;
+
+export declare function setData(newData: any[], headers?: Column[]): void;
+
+export declare function setTableId(tableId: string): void;
+
+declare type SlotProps = {
+    children: ReactNode;
+};
+
+export declare type SortOrder = 'asc' | 'desc';
+
+export declare function StackedDateTime({ value, dateVariant, timeVariant, dateFormat, timeFormat, align, dateColor, dateFontSize, dateFontWeight, timeColor, timeFontSize, timeFontWeight, showTime, }: StackedDateTimeProps): JSX_2.Element;
+
+declare interface StackedDateTimeProps {
+    value: string | Date | number | null | undefined;
+    dateVariant?: 'date' | 'short' | 'full';
+    timeVariant?: 'time';
+    dateFormat?: string;
+    timeFormat?: string;
+    align?: 'start' | 'center' | 'end';
+    dateColor?: string;
+    dateFontSize?: string | number;
+    dateFontWeight?: string | number;
+    timeFontSize?: string | number;
+    timeFontWeight?: string | number;
+    timeColor?: string;
+    showTime?: boolean;
+}
+
+declare interface TableState {
+    tableId: string;
+    sortColumn: string | null;
+    sortDirection: 'asc' | 'desc';
+    visibility: Record<string, boolean>;
+    columnWidths: Record<string, number>;
+    columnOrder: Column[];
+    data: any[];
+    sortableColumns: {
+        id: string;
+        label: string | default_2.ReactNode;
+        sortable: boolean;
+        backgroundColor?: string;
+    }[];
+    actionsConfig?: ActionHeaderProps;
+}
+
+export declare const tableStore: Store<TableState, (cb: TableState) => TableState>;
+
+export declare function useDebouncedSearch(options?: UseDebouncedSearchOptions): UseDebouncedSearchResult;
+
+export declare interface UseDebouncedSearchOptions {
+    initialValue?: string;
+    delay?: number;
+}
+
+declare interface UseDebouncedSearchResult {
+    search: string;
+    debouncedSearch: string;
+    onSearchChange: (value: string) => void;
+    reset: () => void;
+}
+
+/**
+ * useOption – reactive single key
+ */
+export declare function useOption<T = any>(key: string): T | undefined;
+
+/**
+ * useOptions – reactive multiple keys
+ */
+export declare function useOptions<T = any>(keys: string[]): Record<string, T>;
+
+export declare function usePagination(options?: UsePaginationOptions): UsePaginationResult;
+
+export declare interface UsePaginationOptions {
+    initialPage?: number;
+    initialLimit?: number;
+}
+
+declare interface UsePaginationResult {
+    page: number;
+    limit: number;
+    setPage: (page: number) => void;
+    setLimit: (limit: number) => void;
+    nextPage: () => void;
+    prevPage: () => void;
+    reset: () => void;
+}
+
+export declare type ValueType = 'string' | 'number' | 'boolean' | 'array' | 'object';
+
+/**
+ * Chakra v3 / Ark UI slot components do NOT expose `children` in their typings.
+ * This wrapper intentionally loosens typing to make them library-safe.
+ */
+export declare function withChildren(Component: any): ForwardRefExoticComponent<Omit<any, "ref"> & RefAttributes<any>>;
+
+export { }