@bricks-toolkit/toolkit 0.1.1 → 0.1.2

package/dist/components/Table/Table.types.d.ts

@@ -1,85 +0,0 @@
-import type { ReactNode, CSSProperties } from 'react';
-export type TableAlign = 'left' | 'center' | 'right';
-export type TableSize = 'sm' | 'md' | 'lg';
-export interface TableColumn<T> {
-    /** Unique key identifying this column (also used as data accessor when render is omitted). */
-    key: string;
-    /** Header label shown in <th>. */
-    header: ReactNode;
-    /** Custom cell renderer. Receives the row object and its index. */
-    render?: (row: T, rowIndex: number) => ReactNode;
-    /** When true a sort toggle is shown in the header. */
-    sortable?: boolean;
-    /** Column width, e.g. '120px' or '10%'. */
-    width?: CSSProperties['width'];
-    /** Text alignment for both header and cells. Defaults to 'left'. */
-    align?: TableAlign;
-    /** Extra class applied to every <td> in this column. */
-    cellClassName?: string;
-    /** Extra class applied to the <th> of this column. */
-    headerClassName?: string;
-}
-export type SortDirection = 'asc' | 'desc';
-export interface SortState {
-    key: string;
-    direction: SortDirection;
-}
-export type TableHeaderVariant = 'light' | 'dark';
-export interface TableProps<T extends object> {
-    /** Array of data rows. */
-    data: T[];
-    /** Column definitions. */
-    columns: TableColumn<T>[];
-    /** Returns a unique key for each row (required for React reconciliation). */
-    rowKey: (row: T) => string | number;
-    /** Show a loading skeleton overlay. */
-    loading?: boolean;
-    /** Message (or element) shown when data is empty. */
-    emptyMessage?: ReactNode;
-    /** Alternate row background colours. */
-    striped?: boolean;
-    /** Render outer and inner borders. */
-    bordered?: boolean;
-    /** Highlight row on hover. */
-    hoverable?: boolean;
-    /** Makes the header stick to the top when scrolling. */
-    stickyHeader?: boolean;
-    /** Cell padding size. Defaults to 'md'. */
-    size?: TableSize;
-    /** External sort state (controlled). When omitted, sorting is internal. */
-    sortState?: SortState;
-    /** Called when the user clicks a sortable header. */
-    onSortChange?: (sort: SortState) => void;
-    /** Additional class for the outer wrapper. */
-    className?: string;
-    /** Additional class for the <table> element. */
-    tableClassName?: string;
-    /** Pagination configuration. If null or undefined, pagination is hidden. */
-    pagination?: PaginationProps | null;
-    /** Variant for the table header */
-    headerVariant?: TableHeaderVariant;
-}
-export interface PaginationProps {
-    /** Total number of items across all pages. */
-    total: number;
-    /** Current page index (1-based). */
-    page: number;
-    /** Number of rows per page. */
-    pageSize: number;
-    /** Total number of pages. */
-    totalPages?: number;
-    /** Whether there is a next page. */
-    hasNextPage?: boolean;
-    /** Whether there is a previous page. */
-    hasPrevPage?: boolean;
-    /** Called when the user navigates to a new page. */
-    onPageChange: (page: number) => void;
-    /** Called when the user picks a new page size. */
-    onPageSizeChange?: (size: number) => void;
-    /** Available page-size options. Defaults to [10, 20, 50]. */
-    pageSizeOptions?: number[];
-    /** Show the page-size selector. Defaults to true when onPageSizeChange is provided. */
-    showSizeChanger?: boolean;
-    /** Additional class for the pagination wrapper. */
-    className?: string;
-}

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

@@ -1,3 +0,0 @@
-export * from './Table';
-export * from './Pagination';
-export * from './Table.types';

package/dist/components/Tabs/Tabs.d.ts

@@ -1,2 +0,0 @@
-import type { TabsProps } from './Tabs.types';
-export declare const Tabs: React.ForwardRefExoticComponent<TabsProps & React.RefAttributes<HTMLDivElement>>;

package/dist/components/Tabs/Tabs.stories.d.ts

@@ -1,17 +0,0 @@
-import type { Meta, StoryObj } from '@storybook/react-vite';
-import { Tabs } from './Tabs';
-declare const meta: Meta<typeof Tabs>;
-export default meta;
-type Story = StoryObj<typeof meta>;
-/** The default Tabs component. */
-export declare const Default: Story;
-/** All five size variants stacked vertically. */
-export declare const Sizes: Story;
-/** All four visual variants. */
-export declare const Variants: Story;
-/** Tabs spanning the full width of their container. */
-export declare const FullWidth: Story;
-/** Individual tabs can be disabled. */
-export declare const DisabledTabs: Story;
-/** Controlled usage where the selection state is managed externally. */
-export declare const Controlled: Story;

package/dist/components/Tabs/Tabs.test.d.ts

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

package/dist/components/Tabs/Tabs.types.d.ts

@@ -1,21 +0,0 @@
-import type { ReactNode, HTMLAttributes } from 'react';
-export type TabsVariant = 'default' | 'filled' | 'flushed' | 'unstyled';
-export type TabsSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
-export interface TabItem {
-    id: string;
-    label: ReactNode;
-    content: ReactNode;
-    disabled?: boolean;
-}
-export interface TabsProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange'> {
-    items: TabItem[];
-    defaultSelectedId?: string;
-    selectedId?: string;
-    onChange?: (id: string) => void;
-    variant?: TabsVariant;
-    size?: TabsSize;
-    fullWidth?: boolean;
-    tabListClassName?: string;
-    tabClassName?: string;
-    tabPanelClassName?: string;
-}

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

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

package/dist/components/TextInput/TextInput.d.ts

@@ -1,2 +0,0 @@
-import type { TextInputProps } from './TextInput.types';
-export declare const TextInput: React.ForwardRefExoticComponent<TextInputProps & React.RefAttributes<HTMLInputElement | HTMLTextAreaElement>>;

package/dist/components/TextInput/TextInput.stories.d.ts

@@ -1,25 +0,0 @@
-import type { Meta, StoryObj } from '@storybook/react-vite';
-import { TextInput } from './TextInput';
-declare const meta: Meta<typeof TextInput>;
-export default meta;
-type Story = StoryObj<typeof meta>;
-/** The default input with a label, placeholder, and helper text. */
-export declare const Default: Story;
-/** All five size variants stacked vertically. */
-export declare const Sizes: Story;
-/** All four visual variants. */
-export declare const Variants: Story;
-/** All four validation states. */
-export declare const ValidationStates: Story;
-/** Inline left and right elements (SVG icons). */
-export declare const WithIcons: Story;
-/** External prefix and suffix addon elements. */
-export declare const WithPrefixSuffix: Story;
-/** Required fields show a red asterisk beside the label. */
-export declare const Required: Story;
-/** Disabled input — read-only and non-interactive. */
-export declare const Disabled: Story;
-/** Override styles via `inputClassName` and `wrapperClassName`. */
-export declare const CustomClassName: Story;
-/** Input without a label — uses `aria-label` on the `<input>` instead. */
-export declare const NoLabel: Story;

package/dist/components/TextInput/TextInput.test.d.ts

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

package/dist/components/TextInput/TextInput.types.d.ts

@@ -1,29 +0,0 @@
-import type { InputHTMLAttributes, ReactNode } from 'react';
-export type TextInputVariant = 'default' | 'filled' | 'flushed' | 'unstyled';
-export type TextInputSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
-export type TextInputState = 'default' | 'error' | 'success' | 'warning';
-export interface TextInputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'size' | 'prefix'> {
-    label?: string;
-    required?: boolean;
-    helperText?: string;
-    errorMessage?: string;
-    successMessage?: string;
-    warningMessage?: string;
-    variant?: TextInputVariant;
-    size?: TextInputSize;
-    state?: TextInputState;
-    fullWidth?: boolean;
-    leftElement?: ReactNode;
-    rightElement?: ReactNode;
-    prefix?: ReactNode;
-    suffix?: ReactNode;
-    wrapperClassName?: string;
-    inputGroupClassName?: string;
-    inputClassName?: string;
-    labelClassName?: string;
-    helperClassName?: string;
-    clearable?: boolean;
-    isLoading?: boolean;
-    multiline?: boolean;
-    rows?: number;
-}

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

@@ -1,2 +0,0 @@
-export { TextInput } from './TextInput';
-export type { TextInputProps, TextInputVariant, TextInputSize, TextInputState, } from './TextInput.types';

package/dist/components/ThemeProvider/ThemeProvider.d.ts

@@ -1,8 +0,0 @@
-import type { ThemeProviderProps, ThemeProviderState } from './ThemeProvider.types';
-interface ThemeProviderComponent {
-    (props: ThemeProviderProps): React.JSX.Element;
-    displayName?: string;
-}
-export declare const ThemeProvider: ThemeProviderComponent;
-export declare const useTheme: () => ThemeProviderState;
-export {};

package/dist/components/ThemeProvider/ThemeProvider.stories.d.ts

@@ -1,16 +0,0 @@
-import type { Meta, StoryObj } from '@storybook/react-vite';
-import { ThemeProvider } from './ThemeProvider';
-/**
- * The ThemeProvider is the heart of the design system. It manages theme state,
- * synchronizes with user preferences, and injects a comprehensive set of
- * CSS variables into the application root.
- */
-declare const meta: Meta<typeof ThemeProvider>;
-export default meta;
-type Story = StoryObj<typeof meta>;
-/** The default Storybook demonstration using the library's premium tokens. */
-export declare const Default: Story;
-/** Demonstration of a high-contrast custom brand configuration. */
-export declare const CustomBranding: Story;
-/** A comprehensive gallery for auditing all theme design tokens. */
-export declare const TokenGalleryStory: Story;

package/dist/components/ThemeProvider/ThemeProvider.test.d.ts

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

package/dist/components/ThemeProvider/ThemeProvider.types.d.ts

@@ -1,112 +0,0 @@
-import type { ReactNode } from 'react';
-/** Theme modes supported by the library. */
-export type ThemeMode = 'light' | 'dark' | 'system';
-/** A record of semantic design tokens for a single theme (light or dark). */
-export interface SemanticColors {
-    /** Main primary color used for actions and highlights. */
-    primary?: string;
-    /** Hover state for primary actions. */
-    primaryHover?: string;
-    /** Active/pressed state for primary actions. */
-    primaryActive?: string;
-    /** Secondary actions or secondary emphasis. */
-    secondary?: string;
-    /** Hover state for secondary actions. */
-    secondaryHover?: string;
-    /** A vibrant accent color for specific focus or brand elements. */
-    accent?: string;
-    /** Main application background. */
-    background?: string;
-    /** Primary surface color for cards, modals, and navigation. */
-    surface?: string;
-    /** A darker/lighter alternate surface for contrast. */
-    surfaceSecondary?: string;
-    /** Default border color for elements like inputs or cards. */
-    border?: string;
-    /** A more subtle border for secondary grouping. */
-    borderLight?: string;
-    /** Explicit divider color between content blocks. */
-    divider?: string;
-    /** Standard high-contrast text for body and headings. */
-    text?: string;
-    /** Slightly lower contrast text for secondary descriptions. */
-    textSecondary?: string;
-    /** Muted text for captions, metadata, or disabled labels. */
-    textMuted?: string;
-    /** High-contrast text to be used on dark背景 (e.g. on primary buttons). */
-    textInverse?: string;
-    /** Color representing success (often green). */
-    success?: string;
-    /** Color representing warnings (often amber). */
-    warning?: string;
-    /** Color representing errors or destructive actions (often red). */
-    error?: string;
-    /** Color representing informational messages (often blue). */
-    info?: string;
-    /** Background color for item hover states (e.g. list items). */
-    hover?: string;
-    /** Background color for item active/selected states. */
-    active?: string;
-    /** Ring or outline color for focus states. */
-    focus?: string;
-    /** Color for disabled backgrounds or indicators. */
-    disabled?: string;
-    /** A subtle, tight shadow for small components. */
-    shadowSm?: string;
-    /** The standard shadow for cards and modals. */
-    shadowMd?: string;
-    /** A large, diffuse shadow for overlays. */
-    shadowLg?: string;
-    /** For quick interactions like hover entry. */
-    transitionFast?: string;
-    /** The default transition for most entry/exit animations. */
-    transitionNormal?: string;
-    /** For large surface changes or fade-ins. */
-    transitionSlow?: string;
-    /** Layer for dropdowns and popovers. */
-    zIndexDropdown?: string | number;
-    /** Layer for sticky headers or nav. */
-    zIndexSticky?: string | number;
-    /** Layer for modals and drawers. */
-    zIndexModal?: string | number;
-    /** Highest layer for tooltips and alerts. */
-    zIndexTooltip?: string | number;
-    primaryForeground?: string;
-    secondaryForeground?: string;
-    muted?: string;
-    mutedForeground?: string;
-    accentForeground?: string;
-    destructive?: string;
-    destructiveForeground?: string;
-    card?: string;
-    cardForeground?: string;
-    input?: string;
-    ring?: string;
-}
-/** Theme configuration that allows overriding light and dark properties. */
-export interface ThemeConfig {
-    /** Light theme overrides. */
-    light?: SemanticColors;
-    /** Dark theme overrides. */
-    dark?: SemanticColors;
-}
-/** Props for the ThemeProvider component. */
-export interface ThemeProviderProps {
-    /** The children to render within the provider. */
-    children: ReactNode;
-    /** The default theme mode ('light', 'dark', or 'system'). Default is 'system'. */
-    defaultTheme?: ThemeMode;
-    /** The key used to store the theme mode in localStorage. Default is 'ui-theme'. */
-    storageKey?: string;
-    /** Optional custom theme configuration to override default tokens. */
-    themeConfig?: ThemeConfig;
-}
-/** Context state provided by the ThemeProvider. */
-export interface ThemeProviderState {
-    /** The currently active theme mode. */
-    theme: ThemeMode;
-    /** Function to update the theme mode. */
-    setTheme: (theme: ThemeMode) => void;
-    /** The currently active theme configuration (including overrides). */
-    themeConfig?: ThemeConfig;
-}

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

@@ -1,2 +0,0 @@
-export { ThemeProvider, useTheme } from './ThemeProvider';
-export type { ThemeProviderProps, ThemeProviderState, ThemeMode, ThemeConfig, SemanticColors, } from './ThemeProvider.types';

package/dist/components/TimePicker/TimePicker.d.ts

@@ -1,2 +0,0 @@
-import type { TimePickerProps } from './TimePicker.types';
-export declare const TimePicker: React.ForwardRefExoticComponent<TimePickerProps & React.RefAttributes<HTMLInputElement>>;

package/dist/components/TimePicker/TimePicker.stories.d.ts

@@ -1,23 +0,0 @@
-import type { Meta, StoryObj } from '@storybook/react-vite';
-import { TimePicker } from './TimePicker';
-declare const meta: Meta<typeof TimePicker>;
-export default meta;
-type Story = StoryObj<typeof meta>;
-/** The default input with a label and helper text. */
-export declare const Default: Story;
-/** All five size variants stacked vertically. */
-export declare const Sizes: Story;
-/** All four visual variants. */
-export declare const Variants: Story;
-/** All four validation states. */
-export declare const ValidationStates: Story;
-/** External prefix and suffix addon elements. */
-export declare const WithPrefixSuffix: Story;
-/** Required fields show a red asterisk beside the label. */
-export declare const Required: Story;
-/** Disabled input — read-only and non-interactive. */
-export declare const Disabled: Story;
-/** Override styles via `inputClassName` and `wrapperClassName`. */
-export declare const CustomClassName: Story;
-/** Input without a label — uses `aria-label` on the `<input>` instead. */
-export declare const NoLabel: Story;

package/dist/components/TimePicker/TimePicker.test.d.ts

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

package/dist/components/TimePicker/TimePicker.types.d.ts

@@ -1,27 +0,0 @@
-import type { InputHTMLAttributes, ReactNode } from 'react';
-export type TimePickerVariant = 'default' | 'filled' | 'flushed' | 'unstyled';
-export type TimePickerSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
-export type TimePickerState = 'default' | 'error' | 'success' | 'warning';
-export interface TimePickerProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'size' | 'prefix' | 'type'> {
-    label?: string;
-    required?: boolean;
-    helperText?: string;
-    errorMessage?: string;
-    successMessage?: string;
-    warningMessage?: string;
-    variant?: TimePickerVariant;
-    size?: TimePickerSize;
-    state?: TimePickerState;
-    fullWidth?: boolean;
-    leftElement?: ReactNode;
-    rightElement?: ReactNode;
-    prefix?: ReactNode;
-    suffix?: ReactNode;
-    wrapperClassName?: string;
-    inputGroupClassName?: string;
-    inputClassName?: string;
-    labelClassName?: string;
-    helperClassName?: string;
-    clearable?: boolean;
-    isLoading?: boolean;
-}

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

@@ -1,2 +0,0 @@
-export { TimePicker } from './TimePicker';
-export type { TimePickerProps, TimePickerVariant, TimePickerSize, TimePickerState, } from './TimePicker.types';

package/dist/components/Toaster/Toaster.d.ts

@@ -1,2 +0,0 @@
-import type { ToasterProps } from './Toaster.types';
-export declare const Toaster: React.ForwardRefExoticComponent<ToasterProps & React.RefAttributes<HTMLDivElement>>;

package/dist/components/Toaster/Toaster.stories.d.ts

@@ -1,13 +0,0 @@
-import type { Meta, StoryObj } from '@storybook/react-vite';
-import { Toaster } from './Toaster';
-declare const meta: Meta<typeof Toaster>;
-export default meta;
-type Story = StoryObj<typeof Toaster>;
-export declare const Success: Story;
-export declare const Error: Story;
-export declare const Warning: Story;
-export declare const Info: Story;
-export declare const Subtle: Story;
-export declare const LeftAccent: Story;
-export declare const OnlyTitle: Story;
-export declare const OnlyDescription: Story;

package/dist/components/Toaster/Toaster.test.d.ts

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

package/dist/components/Toaster/Toaster.types.d.ts

@@ -1,23 +0,0 @@
-import type { ReactNode } from 'react';
-export type ToasterStatus = 'success' | 'error' | 'warning' | 'info';
-export type ToasterVariant = 'solid' | 'subtle' | 'left-accent';
-export interface ToasterProps {
-    /** The unique identifier of the toaster */
-    id?: string;
-    /** The title of the toaster */
-    title?: string;
-    /** The description text of the toaster */
-    description?: ReactNode;
-    /** The status of the toaster, affects color and icon */
-    status?: ToasterStatus;
-    /** The visual variant of the toaster */
-    variant?: ToasterVariant;
-    /** Whether the toaster is closable */
-    isClosable?: boolean;
-    /** Callback function called when the toaster is closed */
-    onClose?: () => void;
-    /** Custom class name for the toaster container */
-    className?: string;
-    /** Custom duration in ms before toaster closes automatically (if managed by a provider) */
-    duration?: number;
-}

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

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

package/dist/components/Toggle/Toggle.d.ts

@@ -1,2 +0,0 @@
-import type { ToggleProps } from './Toggle.types';
-export declare const Toggle: React.ForwardRefExoticComponent<ToggleProps & React.RefAttributes<HTMLInputElement>>;

package/dist/components/Toggle/Toggle.stories.d.ts

@@ -1,11 +0,0 @@
-import type { Meta, StoryObj } from '@storybook/react';
-import { Toggle } from './Toggle';
-declare const meta: Meta<typeof Toggle>;
-export default meta;
-type Story = StoryObj<typeof Toggle>;
-export declare const Default: Story;
-export declare const Sizes: Story;
-export declare const States: Story;
-export declare const WithHelperText: Story;
-export declare const WithErrorText: Story;
-export declare const Disabled: Story;

package/dist/components/Toggle/Toggle.types.d.ts

@@ -1,10 +0,0 @@
-import type { InputHTMLAttributes } from 'react';
-export type ToggleSize = 'sm' | 'md' | 'lg';
-export type ToggleState = 'default' | 'error' | 'success' | 'warning';
-export interface ToggleProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'size'> {
-    size?: ToggleSize;
-    state?: ToggleState;
-    label?: string;
-    helperText?: string;
-    errorText?: string;
-}

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

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

package/dist/components/Tooltip/Tooltip.d.ts

@@ -1,2 +0,0 @@
-import type { TooltipProps } from './Tooltip.types';
-export declare function Tooltip({ content, children, placement, trigger, showDelay, hideDelay, size, variant, open: controlledOpen, disabled, maxWidth, className, wrapperClassName, }: TooltipProps): React.JSX.Element;

package/dist/components/Tooltip/Tooltip.stories.d.ts

@@ -1,13 +0,0 @@
-import type { Meta, StoryObj } from '@storybook/react-vite';
-import { Tooltip } from './Tooltip';
-declare const meta: Meta<typeof Tooltip>;
-export default meta;
-type Story = StoryObj<typeof meta>;
-export declare const Default: Story;
-export declare const Variants: Story;
-export declare const Placements: Story;
-export declare const Sizes: Story;
-export declare const ClickTrigger: Story;
-export declare const RichContent: Story;
-export declare const AlwaysOpen: Story;
-export declare const DisabledTooltip: Story;

package/dist/components/Tooltip/Tooltip.test.d.ts

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

package/dist/components/Tooltip/Tooltip.types.d.ts

@@ -1,33 +0,0 @@
-import type { ReactNode } from 'react';
-export type TooltipPlacement = 'top' | 'bottom' | 'left' | 'right';
-export type TooltipTrigger = 'hover' | 'click' | 'focus';
-export type TooltipSize = 'sm' | 'md' | 'lg';
-export type TooltipVariant = 'dark' | 'primary' | 'light';
-export interface TooltipProps {
-    /** The content shown inside the tooltip bubble. */
-    content: ReactNode;
-    /** The element the tooltip is anchored to. */
-    children?: ReactNode;
-    /** Preferred placement relative to the trigger. Defaults to 'top'. */
-    placement?: TooltipPlacement;
-    /** What interaction opens the tooltip. Defaults to 'hover'. */
-    trigger?: TooltipTrigger;
-    /** Delay in ms before showing (hover only). Defaults to 0. */
-    showDelay?: number;
-    /** Delay in ms before hiding (hover only). Defaults to 100. */
-    hideDelay?: number;
-    /** Size / padding of the tooltip bubble. Defaults to 'md'. */
-    size?: TooltipSize;
-    /** Visual style of the tooltip bubble. Defaults to 'dark'. */
-    variant?: TooltipVariant;
-    /** When true the tooltip is always visible (controlled). */
-    open?: boolean;
-    /** When true the tooltip is disabled and will never show. */
-    disabled?: boolean;
-    /** Max width of the tooltip bubble in px. Defaults to 240. */
-    maxWidth?: number;
-    /** Additional class for the tooltip bubble. */
-    className?: string;
-    /** Additional class for the tooltip wrapper span. */
-    wrapperClassName?: string;
-}

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

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

package/dist/utils/cn.d.ts

@@ -1,2 +0,0 @@
-import { type ClassValue } from 'clsx';
-export declare function cn(...inputs: ClassValue[]): string;

package/dist/utils/index.d.ts

@@ -1 +0,0 @@
-export { cn } from './cn';