@bfrs/agentic-components 0.1.0

package/README.md

@@ -0,0 +1,132 @@
+# Agentic Components
+
+Production-grade React component library for Shiprocket agentic interfaces.
+
+- Repository: https://github.com/bfrs/agentic-components
+- Showcase: https://bfrs.github.io/agentic-components/
+- Package: `@bfrs/agentic-components`
+
+## Install
+
+Configure npm auth in the consuming app:
+
+```ini
+registry=https://registry.npmjs.org/
+//registry.npmjs.org/:_authToken=${NPM_TOKEN}
+```
+
+Then install:
+
+```bash
+npm install @bfrs/agentic-components
+```
+
+During install, the package writes `BFRS_AGENTIC_COMPONENTS.md` into the consuming project. It also ensures `AGENTS.md` and `CLAUDE.md` reference that file, creating either file when missing. Existing agent files are preserved and only receive the reference line:
+
+```md
+Use BFRS_AGENTIC_COMPONENTS.md for knowledge regarding the component library.
+```
+
+## Usage
+
+```tsx
+import "@bfrs/agentic-components/styles";
+import { Button, Card, Checkbox, Input, Text } from "@bfrs/agentic-components";
+
+export function Example() {
+  return (
+    <Card>
+      <Text variant="title">Create shipment</Text>
+      <Input placeholder="Pickup pincode" />
+      <Checkbox label="Save this pickup address" defaultChecked />
+      <Button onClick={() => undefined}>Continue</Button>
+    </Card>
+  );
+}
+```
+
+Most DOM-backed components forward compatible React props such as `onClick`, `onKeyDown`, `aria-*`, `data-*`, `className`, `style`, and refs. Controlled components expose explicit callbacks such as `onValueChange`, `onOpenChange`, `onSort`, `onRowClick`, and `onPageChange`.
+
+Size-aware controls support `sm`, `md`, and `lg`. `sm` is the compact dashboard size for dense controls and filters.
+
+### DateRangePicker
+
+Use `DateRangePicker` for preset and custom date-range filters. Keep API date formatting in the consuming app.
+
+```tsx
+import { DateRangePicker, presetToRange, type DateRangeValue } from "@bfrs/agentic-components";
+
+const [range, setRange] = useState<DateRangeValue>({
+  preset: "Last 30 days",
+  ...presetToRange("Last 30 days")
+});
+
+<DateRangePicker value={range} onChange={setRange} maxRangeDays={365} />;
+```
+
+### ToastProvider
+
+Wrap the app once and call toast helpers from app event handlers.
+
+```tsx
+import { Button, ToastProvider, useToast } from "@bfrs/agentic-components";
+
+function SaveButton() {
+  const { success, danger } = useToast();
+
+  return <Button onClick={() => success("Changes saved")}>Save</Button>;
+}
+
+<ToastProvider>
+  <SaveButton />
+</ToastProvider>;
+```
+
+### Checkbox
+
+Use `Checkbox` for independent true/false decisions or multi-select choices. It renders as a square checklist control, while `Radio` renders circular options for single-choice groups.
+
+```tsx
+import { Checkbox } from "@bfrs/agentic-components";
+
+<Checkbox
+  label="Accept terms"
+  description="Use checkboxes when each option can be selected independently."
+  checked={accepted}
+  onCheckedChange={setAccepted}
+/>
+
+<Checkbox label="Partially selected" checked="indeterminate" />
+```
+
+## Development
+
+```bash
+npm run typecheck
+npm run lint
+npm run build:lib
+npm run build:demo
+```
+
+`npm run build:lib` outputs the package to `dist`.
+
+`npm run build:demo` outputs the showcase app to `dist-demo`.
+
+## Publishing
+
+Package publishing is configured for npmjs private packages. Publish only through the controlled release flow:
+
+```bash
+npm run changeset
+npm run version-packages
+git tag v0.1.0
+git push origin main --tags
+```
+
+The `Publish Package` GitHub Action publishes to npmjs on version tags, published GitHub releases, or manual workflow dispatch. Configure the repository secret `NPM_TOKEN` with publish access.
+
+## Showcase Deployment
+
+The `Deploy Showcase` GitHub Action builds `dist-demo` and deploys it to GitHub Pages on pushes to `main`.
+
+In the GitHub repository settings, set Pages source to **GitHub Actions**.

package/dist/components/data-display/DataTable/DataTable.d.ts

@@ -0,0 +1,2 @@
+import { DataTableProps } from './DataTable.types';
+export declare function DataTable<Row>({ data, columns, getRowId, loading, error, emptyState, emptyTitle, emptyDescription, pagination, enableSorting, sorting, defaultSorting, onSortingChange, visibleColumnIds, columnOrder, defaultColumnOrder, onColumnOrderChange, enableColumnPinning, pinnedColumnCount, defaultPinnedColumnCount, onPinnedColumnCountChange, pinLeadingColumn, defaultPinLeadingColumn, onPinLeadingColumnChange, enableColumnReordering, resetKey, showSortIcon, leadingColumn, rowActions, rowActionsHeader, rowActionsWidth, stickyRowActions, selection, selectedRowIds, onSelectedRowIdsChange, stickyHeader, minWidth, density, className, tableClassName, headerClassName, rowClassName, cellClassName, onRowClick, "aria-label": ariaLabel }: DataTableProps<Row>): import("react/jsx-runtime").JSX.Element;

package/dist/components/data-display/DataTable/DataTable.types.d.ts

@@ -0,0 +1,153 @@
+import { CSSProperties, ReactNode } from 'react';
+import { ActionMenuItem } from '../../navigation/ActionMenu';
+export type SortDirection = "asc" | "desc";
+export type TableDensity = "compact" | "default" | "comfortable";
+export type TableAlign = "left" | "center" | "right";
+export type DataTableSorting = {
+    columnId: string;
+    direction: SortDirection;
+};
+export type DataTableColumn<Row> = {
+    id: string;
+    header: ReactNode;
+    accessorKey?: keyof Row;
+    accessorFn?: (row: Row) => unknown;
+    sortValue?: (row: Row) => unknown;
+    cell?: (row: Row, context: {
+        value: unknown;
+        rowIndex: number;
+        selected: boolean;
+        hovered: boolean;
+    }) => ReactNode;
+    sortable?: boolean;
+    width?: number | string;
+    minWidth?: number | string;
+    align?: TableAlign;
+    className?: string;
+    headerClassName?: string;
+    style?: CSSProperties;
+    headerStyle?: CSSProperties;
+};
+export type DataTableLeadingColumn<Row> = {
+    header: ReactNode;
+    cell: (row: Row, context: {
+        rowIndex: number;
+        selected: boolean;
+        hovered: boolean;
+    }) => ReactNode;
+    width?: number | string;
+    minWidth?: number | string;
+    className?: string;
+    headerClassName?: string;
+    style?: CSSProperties;
+    headerStyle?: CSSProperties;
+};
+export type DataTablePagination = {
+    page: number;
+    totalPages: number;
+    pageSize?: number;
+    totalItems?: number;
+    pageSizeOptions?: number[];
+    onPageChange: (page: number) => void;
+    onPageSizeChange?: (pageSize: number) => void;
+};
+export type DataTableProps<Row> = {
+    data: Row[];
+    columns: DataTableColumn<Row>[];
+    getRowId?: (row: Row, index: number) => string;
+    loading?: boolean;
+    error?: ReactNode;
+    emptyState?: ReactNode;
+    emptyTitle?: ReactNode;
+    emptyDescription?: ReactNode;
+    pagination?: DataTablePagination;
+    enableSorting?: boolean;
+    sorting?: DataTableSorting | null;
+    defaultSorting?: DataTableSorting | null;
+    onSortingChange?: (sorting: DataTableSorting | null) => void;
+    visibleColumnIds?: string[];
+    columnOrder?: string[];
+    defaultColumnOrder?: string[];
+    onColumnOrderChange?: (columnOrder: string[]) => void;
+    enableColumnPinning?: boolean;
+    pinnedColumnCount?: number;
+    defaultPinnedColumnCount?: number;
+    onPinnedColumnCountChange?: (count: number) => void;
+    pinLeadingColumn?: boolean;
+    defaultPinLeadingColumn?: boolean;
+    onPinLeadingColumnChange?: (pinned: boolean) => void;
+    enableColumnReordering?: boolean;
+    resetKey?: string | number;
+    showSortIcon?: "always" | "active" | "never";
+    leadingColumn?: DataTableLeadingColumn<Row>;
+    rowActions?: (row: Row) => ReactNode;
+    rowActionsHeader?: ReactNode;
+    rowActionsWidth?: number | string;
+    stickyRowActions?: boolean;
+    selection?: boolean;
+    selectedRowIds?: string[];
+    onSelectedRowIdsChange?: (ids: string[]) => void;
+    stickyHeader?: boolean;
+    minWidth?: number | string;
+    density?: TableDensity;
+    className?: string;
+    tableClassName?: string;
+    headerClassName?: string;
+    rowClassName?: string | ((row: Row, index: number) => string | undefined);
+    cellClassName?: string;
+    onRowClick?: (row: Row) => void;
+    "aria-label"?: string;
+};
+export type TableToolbarProps = {
+    title?: ReactNode;
+    description?: ReactNode;
+    totalLabel?: ReactNode;
+    loadingLabel?: ReactNode;
+    search?: ReactNode;
+    actions?: ReactNode;
+    columnVisibility?: ReactNode;
+    className?: string;
+};
+export type TablePaginationProps = DataTablePagination & {
+    itemLabel?: string;
+    className?: string;
+};
+export type TableStateProps = {
+    title?: ReactNode;
+    description?: ReactNode;
+    action?: ReactNode;
+    colSpan?: number;
+    className?: string;
+};
+export type TableSkeletonProps = {
+    rows?: number;
+    columns?: number;
+    density?: TableDensity;
+    colSpan?: number;
+};
+export type TableRowActionsProps<Row> = {
+    row: Row;
+    getItems: (row: Row) => ActionMenuItem[];
+    label?: string;
+};
+export type TableBulkActionsProps = {
+    selectedCount: number;
+    actions?: ReactNode;
+    onClearSelection?: () => void;
+    label?: ReactNode;
+    className?: string;
+};
+export type TableColumnVisibilityColumn = {
+    id: string;
+    label: ReactNode;
+    disabled?: boolean;
+};
+export type TableColumnVisibilityProps = {
+    columns: TableColumnVisibilityColumn[];
+    visibleColumnIds: string[];
+    onVisibleColumnIdsChange: (ids: string[]) => void;
+    label?: ReactNode;
+    resetLabel?: ReactNode;
+    onReset?: () => void;
+    className?: string;
+};

package/dist/components/data-display/DataTable/TableBulkActions.d.ts

@@ -0,0 +1,2 @@
+import { TableBulkActionsProps } from './DataTable.types';
+export declare function TableBulkActions({ selectedCount, actions, onClearSelection, label, className }: TableBulkActionsProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/components/data-display/DataTable/TableColumnVisibility.d.ts

@@ -0,0 +1,2 @@
+import { TableColumnVisibilityProps } from './DataTable.types';
+export declare function TableColumnVisibility({ columns, visibleColumnIds, onVisibleColumnIdsChange, label, resetLabel, onReset, className }: TableColumnVisibilityProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/data-display/DataTable/TableEmptyState.d.ts

@@ -0,0 +1,2 @@
+import { TableStateProps } from './DataTable.types';
+export declare function TableEmptyState({ title, description, action, colSpan, className }: TableStateProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/data-display/DataTable/TableErrorState.d.ts

@@ -0,0 +1,2 @@
+import { TableStateProps } from './DataTable.types';
+export declare function TableErrorState({ title, description, action, colSpan, className }: TableStateProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/data-display/DataTable/TablePagination.d.ts

@@ -0,0 +1,2 @@
+import { TablePaginationProps } from './DataTable.types';
+export declare function TablePagination({ page, totalPages, pageSize, totalItems, pageSizeOptions, onPageChange, onPageSizeChange, itemLabel, className }: TablePaginationProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/data-display/DataTable/TableRowActions.d.ts

@@ -0,0 +1,2 @@
+import { TableRowActionsProps } from './DataTable.types';
+export declare function TableRowActions<Row>({ row, getItems, label }: TableRowActionsProps<Row>): import("react/jsx-runtime").JSX.Element;

package/dist/components/data-display/DataTable/TableSkeleton.d.ts

@@ -0,0 +1,2 @@
+import { TableSkeletonProps } from './DataTable.types';
+export declare function TableSkeleton({ rows, columns, density, colSpan }: TableSkeletonProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/data-display/DataTable/TableToolbar.d.ts

@@ -0,0 +1,2 @@
+import { TableToolbarProps } from './DataTable.types';
+export declare function TableToolbar({ title, description, totalLabel, loadingLabel, search, actions, columnVisibility, className }: TableToolbarProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/data-display/DataTable/index.d.ts

@@ -0,0 +1,10 @@
+export * from './DataTable';
+export * from './DataTable.types';
+export * from './TableToolbar';
+export * from './TablePagination';
+export * from './TableEmptyState';
+export * from './TableSkeleton';
+export * from './TableErrorState';
+export * from './TableRowActions';
+export * from './TableBulkActions';
+export * from './TableColumnVisibility';

package/dist/components/data-display/MetricCard/MetricCard.d.ts

@@ -0,0 +1,14 @@
+import { TrendDirection } from './MetricCard.types';
+export declare const MetricCard: import('react').ForwardRefExoticComponent<import('react').HTMLAttributes<HTMLDivElement> & {
+    title: import('react').ReactNode;
+    value: import('react').ReactNode;
+    subtitle?: import('react').ReactNode;
+    description?: import('react').ReactNode;
+    trendValue?: import('react').ReactNode;
+    trendDirection?: TrendDirection;
+    icon?: import('react').ReactNode;
+    action?: import('react').ReactNode;
+    loading?: boolean;
+    error?: import('react').ReactNode;
+    compact?: boolean;
+} & import('react').RefAttributes<HTMLDivElement>>;

package/dist/components/data-display/MetricCard/MetricCard.types.d.ts

@@ -0,0 +1,15 @@
+import { HTMLAttributes, ReactNode } from 'react';
+export type TrendDirection = "up" | "down" | "neutral";
+export type MetricCardProps = HTMLAttributes<HTMLDivElement> & {
+    title: ReactNode;
+    value: ReactNode;
+    subtitle?: ReactNode;
+    description?: ReactNode;
+    trendValue?: ReactNode;
+    trendDirection?: TrendDirection;
+    icon?: ReactNode;
+    action?: ReactNode;
+    loading?: boolean;
+    error?: ReactNode;
+    compact?: boolean;
+};

package/dist/components/data-display/MetricCard/index.d.ts

@@ -0,0 +1,2 @@
+export * from './MetricCard';
+export * from './MetricCard.types';

package/dist/components/feedback/EmptyState/EmptyState.d.ts

@@ -0,0 +1,10 @@
+export declare const EmptyState: import('react').ForwardRefExoticComponent<Omit<import('react').HTMLAttributes<HTMLDivElement>, "title"> & {
+    icon?: import('react').ReactNode;
+    illustration?: import('react').ReactNode;
+    title: import('react').ReactNode;
+    description?: import('react').ReactNode;
+    primaryAction?: import('react').ReactNode;
+    secondaryAction?: import('react').ReactNode;
+    action?: import('react').ReactNode;
+    variant?: import('./EmptyState.types').EmptyStateVariant;
+} & import('react').RefAttributes<HTMLDivElement>>;

package/dist/components/feedback/EmptyState/EmptyState.types.d.ts

@@ -0,0 +1,12 @@
+import { HTMLAttributes, ReactNode } from 'react';
+export type EmptyStateVariant = "default" | "compact" | "full-page" | "table";
+export type EmptyStateProps = Omit<HTMLAttributes<HTMLDivElement>, "title"> & {
+    icon?: ReactNode;
+    illustration?: ReactNode;
+    title: ReactNode;
+    description?: ReactNode;
+    primaryAction?: ReactNode;
+    secondaryAction?: ReactNode;
+    action?: ReactNode;
+    variant?: EmptyStateVariant;
+};

package/dist/components/feedback/EmptyState/index.d.ts

@@ -0,0 +1,2 @@
+export * from './EmptyState';
+export * from './EmptyState.types';

package/dist/components/feedback/ErrorState/ErrorState.d.ts

@@ -0,0 +1,8 @@
+export declare const ErrorState: import('react').ForwardRefExoticComponent<Omit<import('react').HTMLAttributes<HTMLDivElement>, "title"> & {
+    icon?: import('react').ReactNode;
+    title?: import('react').ReactNode;
+    description?: import('react').ReactNode;
+    retryAction?: import('react').ReactNode;
+    secondaryAction?: import('react').ReactNode;
+    variant?: import('./ErrorState.types').ErrorStateVariant;
+} & import('react').RefAttributes<HTMLDivElement>>;

package/dist/components/feedback/ErrorState/ErrorState.types.d.ts

@@ -0,0 +1,10 @@
+import { HTMLAttributes, ReactNode } from 'react';
+export type ErrorStateVariant = "default" | "compact" | "full-page" | "table";
+export type ErrorStateProps = Omit<HTMLAttributes<HTMLDivElement>, "title"> & {
+    icon?: ReactNode;
+    title?: ReactNode;
+    description?: ReactNode;
+    retryAction?: ReactNode;
+    secondaryAction?: ReactNode;
+    variant?: ErrorStateVariant;
+};

package/dist/components/feedback/ErrorState/index.d.ts

@@ -0,0 +1,2 @@
+export * from './ErrorState';
+export * from './ErrorState.types';

package/dist/components/feedback/LoadingState/LoadingState.d.ts

@@ -0,0 +1,6 @@
+export declare const LoadingState: import('react').ForwardRefExoticComponent<import('react').HTMLAttributes<HTMLDivElement> & {
+    label?: import('react').ReactNode;
+    description?: import('react').ReactNode;
+    variant?: import('./LoadingState.types').LoadingStateVariant;
+    rows?: number;
+} & import('react').RefAttributes<HTMLDivElement>>;

package/dist/components/feedback/LoadingState/LoadingState.types.d.ts

@@ -0,0 +1,8 @@
+import { HTMLAttributes, ReactNode } from 'react';
+export type LoadingStateVariant = "spinner" | "skeleton";
+export type LoadingStateProps = HTMLAttributes<HTMLDivElement> & {
+    label?: ReactNode;
+    description?: ReactNode;
+    variant?: LoadingStateVariant;
+    rows?: number;
+};

package/dist/components/feedback/LoadingState/index.d.ts

@@ -0,0 +1,2 @@
+export * from './LoadingState';
+export * from './LoadingState.types';

package/dist/components/feedback/Toast/Toast.context.d.ts

@@ -0,0 +1,3 @@
+import { ToastContextValue } from './Toast.types';
+export declare const ToastContext: import('react').Context<ToastContextValue | null>;
+export declare function useToast(): ToastContextValue;

package/dist/components/feedback/Toast/Toast.d.ts

@@ -0,0 +1,3 @@
+import { ToastManagerProps, ToastProviderProps } from './Toast.types';
+export declare function ToastManager({ toasts, onDismiss, placement, className }: ToastManagerProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function ToastProvider({ children, placement, maxToasts, defaultDuration, className }: ToastProviderProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/feedback/Toast/Toast.types.d.ts

@@ -0,0 +1,48 @@
+import { ReactNode } from 'react';
+export type ToastTone = "neutral" | "success" | "warning" | "danger" | "info";
+export type ToastPlacement = "top-left" | "top-center" | "top-right" | "bottom-left" | "bottom-center" | "bottom-right";
+export type ToastInput = string | {
+    id?: string;
+    title: ReactNode;
+    description?: ReactNode;
+    tone?: ToastTone;
+    duration?: number;
+    icon?: ReactNode;
+    action?: ReactNode;
+    dismissible?: boolean;
+    className?: string;
+};
+export type ToastRecord = {
+    id: string;
+    title: ReactNode;
+    description?: ReactNode;
+    tone: ToastTone;
+    duration: number;
+    icon?: ReactNode;
+    action?: ReactNode;
+    dismissible: boolean;
+    className?: string;
+};
+export type ToastManagerProps = {
+    toasts: ToastRecord[];
+    onDismiss: (id: string) => void;
+    placement?: ToastPlacement;
+    className?: string;
+};
+export type ToastProviderProps = {
+    children: ReactNode;
+    placement?: ToastPlacement;
+    maxToasts?: number;
+    defaultDuration?: number;
+    className?: string;
+};
+export type ToastContextValue = {
+    toasts: ToastRecord[];
+    toast: (input: ToastInput) => string;
+    success: (input: string | Omit<Extract<ToastInput, object>, "tone">) => string;
+    warning: (input: string | Omit<Extract<ToastInput, object>, "tone">) => string;
+    danger: (input: string | Omit<Extract<ToastInput, object>, "tone">) => string;
+    info: (input: string | Omit<Extract<ToastInput, object>, "tone">) => string;
+    dismiss: (id: string) => void;
+    clear: () => void;
+};

package/dist/components/feedback/Toast/index.d.ts

@@ -0,0 +1,3 @@
+export * from './Toast';
+export * from './Toast.context';
+export * from './Toast.types';

package/dist/components/filters/DateRangePicker/DateRangePicker.d.ts

@@ -0,0 +1,5 @@
+import { DateRangePickerProps } from './DateRangePicker.types';
+export declare function DateRangePicker({ className, value, defaultValue, onChange, presets, placeholder, label, helperText, size, disabled, clearable, minDate, maxDate, maxRangeDays, months, align, side, open: controlledOpen, defaultOpen, onOpenChange, infoText, customPresetLabel, applyLabel, cancelLabel, clearLabel, formatDate, formatRange, triggerClassName, contentClassName, calendarClassName, ...props }: DateRangePickerProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace DateRangePicker {
+    var displayName: string;
+}

package/dist/components/filters/DateRangePicker/DateRangePicker.types.d.ts

@@ -0,0 +1,48 @@
+import { ComponentPropsWithoutRef, ReactNode } from 'react';
+import { ComponentSize } from '../../../tokens';
+export type DateRangePresetId = string;
+export type DateRangeValue = {
+    preset?: DateRangePresetId;
+    from?: Date;
+    to?: Date;
+};
+export type DateRangePreset = {
+    id: DateRangePresetId;
+    label: ReactNode;
+    getRange: () => {
+        from: Date;
+        to: Date;
+    };
+    disabled?: boolean;
+};
+export type DateRangePickerProps = Omit<ComponentPropsWithoutRef<"div">, "defaultValue" | "onChange"> & {
+    value?: DateRangeValue;
+    defaultValue?: DateRangeValue;
+    onChange?: (value: DateRangeValue) => void;
+    presets?: DateRangePreset[];
+    placeholder?: ReactNode;
+    label?: ReactNode;
+    helperText?: ReactNode;
+    size?: ComponentSize;
+    disabled?: boolean;
+    clearable?: boolean;
+    minDate?: Date;
+    maxDate?: Date;
+    maxRangeDays?: number;
+    months?: 1 | 2;
+    align?: "start" | "center" | "end";
+    side?: "top" | "right" | "bottom" | "left";
+    open?: boolean;
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    infoText?: ReactNode;
+    customPresetLabel?: ReactNode;
+    applyLabel?: ReactNode;
+    cancelLabel?: ReactNode;
+    clearLabel?: ReactNode;
+    formatDate?: (date: Date) => string;
+    formatRange?: (value: DateRangeValue) => ReactNode;
+    triggerClassName?: string;
+    contentClassName?: string;
+    calendarClassName?: string;
+};

package/dist/components/filters/DateRangePicker/DateRangePicker.utils.d.ts

@@ -0,0 +1,35 @@
+import { DateRangePreset, DateRangePresetId, DateRangeValue } from './DateRangePicker.types';
+export declare const CUSTOM_PRESET_ID = "Custom";
+export declare const DAY_MS: number;
+export declare const MONTH_NAMES: string[];
+export declare const SHORT_MONTH_NAMES: string[];
+export declare const DAY_HEADS: string[];
+export declare function startOfDay(date: Date): Date;
+export declare function addDays(date: Date, days: number): Date;
+export declare function compareDay(a: Date, b: Date): number;
+export declare function differenceInCalendarDays(a: Date, b: Date): number;
+export declare function sameDay(a: Date, b?: Date): boolean;
+export declare function daysInMonth(year: number, month: number): number;
+export declare function shiftMonth(year: number, month: number, delta: number): {
+    year: number;
+    month: number;
+};
+export declare function normalizeRange(from: Date, to: Date): {
+    from: Date;
+    to: Date;
+};
+export declare function defaultFormatDate(date: Date): string;
+export declare function presetToRange(preset: DateRangePresetId): {
+    from: Date;
+    to: Date;
+};
+export declare const defaultDateRangePresets: DateRangePreset[];
+export declare function hasCompleteRange(value: DateRangeValue): value is DateRangeValue & {
+    from: Date;
+    to: Date;
+};
+export declare function getInitialCalendar(value: DateRangeValue, months: 1 | 2): {
+    year: number;
+    month: number;
+};
+export declare function getPresetLabel(presets: DateRangePreset[], presetId?: string): import('react').ReactNode;

package/dist/components/filters/DateRangePicker/index.d.ts

@@ -0,0 +1,3 @@
+export * from './DateRangePicker';
+export * from './DateRangePicker.types';
+export * from './DateRangePicker.utils';

package/dist/components/filters/FilterBar/FilterBar.d.ts

@@ -0,0 +1,15 @@
+export declare const FilterBar: import('react').ForwardRefExoticComponent<import('react').HTMLAttributes<HTMLDivElement> & {
+    searchValue?: string;
+    onSearchChange?: (value: string) => void;
+    onClearSearch?: () => void;
+    searchPlaceholder?: string;
+    searchInput?: import('react').ReactNode;
+    filterTrigger?: import('react').ReactNode;
+    onOpenFilters?: () => void;
+    activeFiltersCount?: number;
+    filterChips?: import('./FilterBar.types').FilterChipItem[];
+    onClearAllFilters?: () => void;
+    primaryAction?: import('react').ReactNode;
+    secondaryActions?: import('react').ReactNode;
+    sticky?: boolean;
+} & import('react').RefAttributes<HTMLDivElement>>;

package/dist/components/filters/FilterBar/FilterBar.types.d.ts

@@ -0,0 +1,21 @@
+import { HTMLAttributes, ReactNode } from 'react';
+export type FilterChipItem = {
+    id: string;
+    label: ReactNode;
+    onRemove?: () => void;
+};
+export type FilterBarProps = HTMLAttributes<HTMLDivElement> & {
+    searchValue?: string;
+    onSearchChange?: (value: string) => void;
+    onClearSearch?: () => void;
+    searchPlaceholder?: string;
+    searchInput?: ReactNode;
+    filterTrigger?: ReactNode;
+    onOpenFilters?: () => void;
+    activeFiltersCount?: number;
+    filterChips?: FilterChipItem[];
+    onClearAllFilters?: () => void;
+    primaryAction?: ReactNode;
+    secondaryActions?: ReactNode;
+    sticky?: boolean;
+};

package/dist/components/filters/FilterBar/index.d.ts

@@ -0,0 +1,2 @@
+export * from './FilterBar';
+export * from './FilterBar.types';

package/dist/components/filters/FilterDrawer/FilterDrawer.d.ts

@@ -0,0 +1,2 @@
+import { FilterDrawerProps } from './FilterDrawer.types';
+export declare function FilterDrawer({ open, onOpenChange, onClose, title, description, children, activeFiltersCount, applyLabel, resetLabel, onApply, onReset, applying, footerActions, className }: FilterDrawerProps): import("react/jsx-runtime").JSX.Element;