@itilite/lumina-ui 1.0.1 → 1.0.3-alpha

package/README.md

@@ -22,6 +22,43 @@ npm install react antd
 
 ## Usage
 
+### Prerequisites
+
+This component library requires Tailwind CSS to be set up in your consuming application. The components use Tailwind utility classes and will not be styled without it.
+
+#### Setting up Tailwind CSS in your app
+
+1. Install Tailwind CSS:
+```bash
+npm install -D tailwindcss postcss autoprefixer
+npx tailwindcss init
+```
+
+2. Configure Tailwind to scan your app (you don't need to scan the component library):
+```js
+// tailwind.config.js
+module.exports = {
+  content: [
+    "./src/**/*.{js,ts,jsx,tsx}",
+    // No need to scan node_modules - component utilities are pre-compiled
+  ],
+  theme: {
+    extend: {},
+  },
+  plugins: [],
+}
+```
+
+3. Add Tailwind directives to your main CSS file:
+```css
+/* app.css or index.css */
+@tailwind base;
+@tailwind components;
+@tailwind utilities;
+```
+
+**Important:** The component library includes only the Tailwind utilities it uses. Your app must provide the base/reset styles via `@tailwind base`.
+
 ### Importing Components
 
 You can import components individually (recommended for tree-shaking):
@@ -29,21 +66,20 @@ You can import components individually (recommended for tree-shaking):
 ```tsx
 import { Button } from '@itilite/lumina-ui/button';
 import { Checkbox } from '@itilite/lumina-ui/checkbox';
-import '@itilite/lumina-ui/styles.css';
+import '@itilite/lumina-ui/styles.css'; // Import component styles
 ```
 
 Or import all components from the main entry point:
 
 ```tsx
 import { Button, Checkbox } from '@itilite/lumina-ui';
-import '@itilite/lumina-ui/styles.css';
+import '@itilite/lumina-ui/styles.css'; // Import component styles
 ```
 
 ### Button Component
 
 ```tsx
 import { Button } from '@itilite/lumina-ui/button';
-import '@itilite/lumina-ui/styles.css';
 
 function App() {
   return (
@@ -58,7 +94,6 @@ function App() {
 
 ```tsx
 import { Checkbox } from '@itilite/lumina-ui/checkbox';
-import '@itilite/lumina-ui/styles.css';
 
 function App() {
   return (
@@ -69,13 +104,11 @@ function App() {
 }
 ```
 
-## Styling
+## Requirements
 
-The package exports a `styles.css` file that includes all component styles. Import it in your application:
-
-```tsx
-import '@itilite/lumina-ui/styles.css';
-```
+- **Tailwind CSS**: This library requires Tailwind CSS to be configured in your consuming application
+- **React**: 18+
+- **Ant Design**: 5.13.1
 
 ## Available Components
 

package/dist/AdvancedDateRangePicker-D7xn4So6.d.mts

@@ -0,0 +1,59 @@
+import * as React from 'react';
+
+interface TimeValue {
+    hour: string;
+    minute: string;
+    period: "AM" | "PM";
+}
+interface DateRangeValue {
+    startDate: Date | null;
+    endDate: Date | null;
+    startTime: TimeValue;
+    endTime: TimeValue;
+    timezone: string;
+}
+interface PresetOption {
+    label: string;
+    key: string;
+    getRange: () => (Date | null)[];
+}
+interface TimezoneOption {
+    label: string;
+    value: string;
+}
+interface DateRangePickerProps {
+    /** Controlled value for the date range */
+    value?: DateRangeValue;
+    /** Called when the user clicks "Done" */
+    onChange?: (value: DateRangeValue) => void;
+    /** Called on every selection change (live) */
+    onRangeChange?: (value: DateRangeValue) => void;
+    /** Label for the confirm button. Defaults to "Done" */
+    confirmLabel?: string;
+    /** Additional class name for the root wrapper */
+    className?: string;
+    /** Whether the picker is disabled */
+    disabled?: boolean;
+    /** Disable dates before today */
+    disablePastDates?: boolean;
+    /** Minimum selectable date (ISO string) */
+    minDate?: string | null;
+    /** Maximum selectable date (ISO string) */
+    maxDate?: string | null;
+    /** Show a single calendar instead of two */
+    showSingleCalendar?: boolean;
+    /** Id prefix for accessibility */
+    id?: string;
+    defaultTimezone?: string;
+    isTimezoneDisabled?: boolean;
+    timezoneOptions?: TimezoneOption[];
+    /** Initial active preset key. Defaults to "custom". e.g. "this-month", "yesterday" */
+    defaultPreset?: string;
+}
+
+declare function AdvancedDateRangePicker({ value, onChange, confirmLabel, className, disabled, disablePastDates, minDate, maxDate, showSingleCalendar, id, defaultTimezone, isTimezoneDisabled, timezoneOptions, defaultPreset, }: DateRangePickerProps): React.JSX.Element;
+declare namespace AdvancedDateRangePicker {
+    var displayName: string;
+}
+
+export { AdvancedDateRangePicker as A, type DateRangePickerProps as D, type PresetOption as P, type TimeValue as T, type DateRangeValue as a, type TimezoneOption as b };

package/dist/AdvancedDateRangePicker-D7xn4So6.d.ts

@@ -0,0 +1,59 @@
+import * as React from 'react';
+
+interface TimeValue {
+    hour: string;
+    minute: string;
+    period: "AM" | "PM";
+}
+interface DateRangeValue {
+    startDate: Date | null;
+    endDate: Date | null;
+    startTime: TimeValue;
+    endTime: TimeValue;
+    timezone: string;
+}
+interface PresetOption {
+    label: string;
+    key: string;
+    getRange: () => (Date | null)[];
+}
+interface TimezoneOption {
+    label: string;
+    value: string;
+}
+interface DateRangePickerProps {
+    /** Controlled value for the date range */
+    value?: DateRangeValue;
+    /** Called when the user clicks "Done" */
+    onChange?: (value: DateRangeValue) => void;
+    /** Called on every selection change (live) */
+    onRangeChange?: (value: DateRangeValue) => void;
+    /** Label for the confirm button. Defaults to "Done" */
+    confirmLabel?: string;
+    /** Additional class name for the root wrapper */
+    className?: string;
+    /** Whether the picker is disabled */
+    disabled?: boolean;
+    /** Disable dates before today */
+    disablePastDates?: boolean;
+    /** Minimum selectable date (ISO string) */
+    minDate?: string | null;
+    /** Maximum selectable date (ISO string) */
+    maxDate?: string | null;
+    /** Show a single calendar instead of two */
+    showSingleCalendar?: boolean;
+    /** Id prefix for accessibility */
+    id?: string;
+    defaultTimezone?: string;
+    isTimezoneDisabled?: boolean;
+    timezoneOptions?: TimezoneOption[];
+    /** Initial active preset key. Defaults to "custom". e.g. "this-month", "yesterday" */
+    defaultPreset?: string;
+}
+
+declare function AdvancedDateRangePicker({ value, onChange, confirmLabel, className, disabled, disablePastDates, minDate, maxDate, showSingleCalendar, id, defaultTimezone, isTimezoneDisabled, timezoneOptions, defaultPreset, }: DateRangePickerProps): React.JSX.Element;
+declare namespace AdvancedDateRangePicker {
+    var displayName: string;
+}
+
+export { AdvancedDateRangePicker as A, type DateRangePickerProps as D, type PresetOption as P, type TimeValue as T, type DateRangeValue as a, type TimezoneOption as b };

package/dist/AdvancedDateRangePicker-ozItnkhp.d.mts

@@ -0,0 +1,57 @@
+import * as React from 'react';
+
+interface TimeValue {
+    hour: string;
+    minute: string;
+    period: "AM" | "PM";
+}
+interface DateRangeValue {
+    startDate: Date | null;
+    endDate: Date | null;
+    startTime: TimeValue;
+    endTime: TimeValue;
+    timezone: string;
+}
+interface PresetOption {
+    label: string;
+    key: string;
+    getRange: () => (Date | null)[];
+}
+interface TimezoneOption {
+    label: string;
+    value: string;
+}
+interface DateRangePickerProps {
+    /** Controlled value for the date range */
+    value?: DateRangeValue;
+    /** Called when the user clicks "Done" */
+    onChange?: (value: DateRangeValue) => void;
+    /** Called on every selection change (live) */
+    onRangeChange?: (value: DateRangeValue) => void;
+    /** Label for the confirm button. Defaults to "Done" */
+    confirmLabel?: string;
+    /** Additional class name for the root wrapper */
+    className?: string;
+    /** Whether the picker is disabled */
+    disabled?: boolean;
+    /** Disable dates before today */
+    disablePastDates?: boolean;
+    /** Minimum selectable date (ISO string) */
+    minDate?: string | null;
+    /** Maximum selectable date (ISO string) */
+    maxDate?: string | null;
+    /** Show a single calendar instead of two */
+    showSingleCalendar?: boolean;
+    /** Id prefix for accessibility */
+    id?: string;
+    defaultTimezone?: string;
+    isTimezoneDisabled?: boolean;
+    timezoneOptions?: TimezoneOption[];
+}
+
+declare function AdvancedDateRangePicker({ value, onChange, confirmLabel, className, disabled, disablePastDates, minDate, maxDate, showSingleCalendar, id, defaultTimezone, isTimezoneDisabled, timezoneOptions, }: DateRangePickerProps): React.JSX.Element;
+declare namespace AdvancedDateRangePicker {
+    var displayName: string;
+}
+
+export { AdvancedDateRangePicker as A, type DateRangePickerProps as D, type PresetOption as P, type TimeValue as T, type DateRangeValue as a, type TimezoneOption as b };

package/dist/AdvancedDateRangePicker-ozItnkhp.d.ts

@@ -0,0 +1,57 @@
+import * as React from 'react';
+
+interface TimeValue {
+    hour: string;
+    minute: string;
+    period: "AM" | "PM";
+}
+interface DateRangeValue {
+    startDate: Date | null;
+    endDate: Date | null;
+    startTime: TimeValue;
+    endTime: TimeValue;
+    timezone: string;
+}
+interface PresetOption {
+    label: string;
+    key: string;
+    getRange: () => (Date | null)[];
+}
+interface TimezoneOption {
+    label: string;
+    value: string;
+}
+interface DateRangePickerProps {
+    /** Controlled value for the date range */
+    value?: DateRangeValue;
+    /** Called when the user clicks "Done" */
+    onChange?: (value: DateRangeValue) => void;
+    /** Called on every selection change (live) */
+    onRangeChange?: (value: DateRangeValue) => void;
+    /** Label for the confirm button. Defaults to "Done" */
+    confirmLabel?: string;
+    /** Additional class name for the root wrapper */
+    className?: string;
+    /** Whether the picker is disabled */
+    disabled?: boolean;
+    /** Disable dates before today */
+    disablePastDates?: boolean;
+    /** Minimum selectable date (ISO string) */
+    minDate?: string | null;
+    /** Maximum selectable date (ISO string) */
+    maxDate?: string | null;
+    /** Show a single calendar instead of two */
+    showSingleCalendar?: boolean;
+    /** Id prefix for accessibility */
+    id?: string;
+    defaultTimezone?: string;
+    isTimezoneDisabled?: boolean;
+    timezoneOptions?: TimezoneOption[];
+}
+
+declare function AdvancedDateRangePicker({ value, onChange, confirmLabel, className, disabled, disablePastDates, minDate, maxDate, showSingleCalendar, id, defaultTimezone, isTimezoneDisabled, timezoneOptions, }: DateRangePickerProps): React.JSX.Element;
+declare namespace AdvancedDateRangePicker {
+    var displayName: string;
+}
+
+export { AdvancedDateRangePicker as A, type DateRangePickerProps as D, type PresetOption as P, type TimeValue as T, type DateRangeValue as a, type TimezoneOption as b };

package/dist/Table-BOq-_9Nr.d.mts

@@ -0,0 +1,121 @@
+import * as React from 'react';
+import { TableProps as TableProps$1, TablePaginationConfig } from 'antd';
+
+type SortOrder = "ascend" | "descend" | undefined;
+type AntColumnType<RecordType> = NonNullable<TableProps$1<RecordType>["columns"]>[number];
+/**
+ * Header icon configuration added to any column definition.
+ * The Table component reads these props and renders sort/filter icons automatically.
+ */
+interface LuminaColumnHeaderProps {
+    /** Show sort icon. Clicking cycles: undefined (↑↓) → ascend (↑) → descend (↓) → undefined */
+    sortable?: boolean;
+    /** Current sort direction. Provide to make sort controlled. */
+    sortOrder?: SortOrder;
+    /** Called when the user clicks the sort icon. */
+    onSortChange?: (order: SortOrder) => void;
+    /**
+     * Custom sort icon. This MUST be provided if sortable is true.
+     * If omitted, no icon will be rendered.
+     */
+    sortIcon?: React.ReactNode;
+    /** > 0 turns the filter icon red and shows a count badge. */
+    filterCount?: number;
+    /**
+     * Custom filter icon. This MUST be provided if filterContent is present.
+     * If omitted, no icon will be rendered.
+     */
+    filterIcon?: React.ReactNode;
+    /**
+     * Filter dropdown content from the consumer.
+     * Providing this prop renders the filter icon button.
+     * Clicking the icon toggles visibility of this content.
+     */
+    filterContent?: React.ReactNode;
+    /** Optional class name to apply to the header label. */
+    className?: string;
+}
+/**
+ * AntD ColumnType extended with optional `headerProps` for Lumina sort/filter icons.
+ */
+type LuminaColumnType<RecordType = any> = AntColumnType<RecordType> & {
+    headerProps?: LuminaColumnHeaderProps;
+};
+type LuminaColumnsType<RecordType = any> = LuminaColumnType<RecordType>[];
+interface TableProps<RecordType = any> extends Omit<TableProps$1<RecordType>, "size" | "bordered" | "pagination" | "columns"> {
+    /**
+     * Lumina UI table variant.
+     * - `default`    – standard table
+     * - `selectable` – checkbox rows; clicking any row toggles its checkbox
+     */
+    variant?: "default" | "selectable";
+    /** If true, strips outer card chrome to fit inside an Accordion parent. */
+    isAccordion?: boolean;
+    /** If true, strips outer card chrome to fit inside a Toolbar/Container parent. */
+    isToolbar?: boolean;
+    /** Table size. Defaults to 'middle'. */
+    size?: "small" | "middle" | "large";
+    /** Extra class applied on the outermost wrapper div. */
+    className?: string;
+    /** AntD pagination config. Pass `false` to hide pagination. */
+    pagination?: TablePaginationConfig | boolean;
+    /**
+     * Column definitions. Add `headerProps` to any column to get sort/filter icons
+     * rendered automatically in the column header.
+     */
+    columns?: LuminaColumnsType<RecordType>;
+    /** Total number of items in the dataset (for server-side pagination). */
+    total?: number;
+    /** Current page number (1-indexed). */
+    current?: number;
+    /** Number of rows per page. */
+    pageSize?: number;
+    /** Called when the page or page size changes. */
+    onPaginationChange?: TablePaginationConfig["onChange"];
+    /**
+     * Custom content to show when the table has no data.
+     * If provided, it overrides the default Ant Design "No Data" view.
+     */
+    emptyState?: React.ReactNode;
+    /**
+     * If true, the table header (the row with column labels) will be hidden.
+     * Useful during loading or for specific visual variants.
+     */
+    hideHeader?: boolean;
+    /**
+     * Custom loading indicator (e.g. a spinner or skeleton).
+     * If provided, this will be rendered when the table is in a loading state.
+     */
+    loadingIndicator?: React.ReactElement;
+}
+
+/**
+ * Lumina Table component.
+ *
+ * Variants:
+ * - `default`         – standalone table card with rounded border
+ * - `hover`           – row highlight on mouse-over
+ * - `selectable`      – use with `rowSelection`; clicking any row toggles its checkbox
+ * - `accordion-child` – strips outer card chrome; place inside your own accordion wrapper
+ * - `toolbar-child`   – strips outer card chrome; place inside your own toolbar/container wrapper
+ *
+ * Column header icons — add `headerProps` to any column definition:
+ * ```tsx
+ * columns={[{
+ *   key: "name", dataIndex: "name", title: "Name",
+ *   headerProps: {
+ *     sortable: true,
+ *     sortOrder: sortOrders.name,
+ *     onSortChange: (order) => setSortOrders(prev => ({ ...prev, name: order })),
+ *     filterCount: activeFilters.name ?? 0,
+ *     filterContent: <MyFilterPanel />,
+ *   },
+ * }]}
+ * ```
+ */
+declare function Table<RecordType extends object = any>(props: TableProps<RecordType>): React.JSX.Element;
+declare namespace Table {
+    var displayName: string;
+}
+
+export { type LuminaColumnHeaderProps as L, type SortOrder as S, Table as T, type LuminaColumnType as a, type LuminaColumnsType as b, type TableProps as c };

package/dist/Table-BOq-_9Nr.d.ts

@@ -0,0 +1,121 @@
+import * as React from 'react';
+import { TableProps as TableProps$1, TablePaginationConfig } from 'antd';
+
+type SortOrder = "ascend" | "descend" | undefined;
+type AntColumnType<RecordType> = NonNullable<TableProps$1<RecordType>["columns"]>[number];
+/**
+ * Header icon configuration added to any column definition.
+ * The Table component reads these props and renders sort/filter icons automatically.
+ */
+interface LuminaColumnHeaderProps {
+    /** Show sort icon. Clicking cycles: undefined (↑↓) → ascend (↑) → descend (↓) → undefined */
+    sortable?: boolean;
+    /** Current sort direction. Provide to make sort controlled. */
+    sortOrder?: SortOrder;
+    /** Called when the user clicks the sort icon. */
+    onSortChange?: (order: SortOrder) => void;
+    /**
+     * Custom sort icon. This MUST be provided if sortable is true.
+     * If omitted, no icon will be rendered.
+     */
+    sortIcon?: React.ReactNode;
+    /** > 0 turns the filter icon red and shows a count badge. */
+    filterCount?: number;
+    /**
+     * Custom filter icon. This MUST be provided if filterContent is present.
+     * If omitted, no icon will be rendered.
+     */
+    filterIcon?: React.ReactNode;
+    /**
+     * Filter dropdown content from the consumer.
+     * Providing this prop renders the filter icon button.
+     * Clicking the icon toggles visibility of this content.
+     */
+    filterContent?: React.ReactNode;
+    /** Optional class name to apply to the header label. */
+    className?: string;
+}
+/**
+ * AntD ColumnType extended with optional `headerProps` for Lumina sort/filter icons.
+ */
+type LuminaColumnType<RecordType = any> = AntColumnType<RecordType> & {
+    headerProps?: LuminaColumnHeaderProps;
+};
+type LuminaColumnsType<RecordType = any> = LuminaColumnType<RecordType>[];
+interface TableProps<RecordType = any> extends Omit<TableProps$1<RecordType>, "size" | "bordered" | "pagination" | "columns"> {
+    /**
+     * Lumina UI table variant.
+     * - `default`    – standard table
+     * - `selectable` – checkbox rows; clicking any row toggles its checkbox
+     */
+    variant?: "default" | "selectable";
+    /** If true, strips outer card chrome to fit inside an Accordion parent. */
+    isAccordion?: boolean;
+    /** If true, strips outer card chrome to fit inside a Toolbar/Container parent. */
+    isToolbar?: boolean;
+    /** Table size. Defaults to 'middle'. */
+    size?: "small" | "middle" | "large";
+    /** Extra class applied on the outermost wrapper div. */
+    className?: string;
+    /** AntD pagination config. Pass `false` to hide pagination. */
+    pagination?: TablePaginationConfig | boolean;
+    /**
+     * Column definitions. Add `headerProps` to any column to get sort/filter icons
+     * rendered automatically in the column header.
+     */
+    columns?: LuminaColumnsType<RecordType>;
+    /** Total number of items in the dataset (for server-side pagination). */
+    total?: number;
+    /** Current page number (1-indexed). */
+    current?: number;
+    /** Number of rows per page. */
+    pageSize?: number;
+    /** Called when the page or page size changes. */
+    onPaginationChange?: TablePaginationConfig["onChange"];
+    /**
+     * Custom content to show when the table has no data.
+     * If provided, it overrides the default Ant Design "No Data" view.
+     */
+    emptyState?: React.ReactNode;
+    /**
+     * If true, the table header (the row with column labels) will be hidden.
+     * Useful during loading or for specific visual variants.
+     */
+    hideHeader?: boolean;
+    /**
+     * Custom loading indicator (e.g. a spinner or skeleton).
+     * If provided, this will be rendered when the table is in a loading state.
+     */
+    loadingIndicator?: React.ReactElement;
+}
+
+/**
+ * Lumina Table component.
+ *
+ * Variants:
+ * - `default`         – standalone table card with rounded border
+ * - `hover`           – row highlight on mouse-over
+ * - `selectable`      – use with `rowSelection`; clicking any row toggles its checkbox
+ * - `accordion-child` – strips outer card chrome; place inside your own accordion wrapper
+ * - `toolbar-child`   – strips outer card chrome; place inside your own toolbar/container wrapper
+ *
+ * Column header icons — add `headerProps` to any column definition:
+ * ```tsx
+ * columns={[{
+ *   key: "name", dataIndex: "name", title: "Name",
+ *   headerProps: {
+ *     sortable: true,
+ *     sortOrder: sortOrders.name,
+ *     onSortChange: (order) => setSortOrders(prev => ({ ...prev, name: order })),
+ *     filterCount: activeFilters.name ?? 0,
+ *     filterContent: <MyFilterPanel />,
+ *   },
+ * }]}
+ * ```
+ */
+declare function Table<RecordType extends object = any>(props: TableProps<RecordType>): React.JSX.Element;
+declare namespace Table {
+    var displayName: string;
+}
+
+export { type LuminaColumnHeaderProps as L, type SortOrder as S, Table as T, type LuminaColumnType as a, type LuminaColumnsType as b, type TableProps as c };

package/dist/atom/AdvancedDateRangePicker/AdvancedDateRangePicker.d.mts

@@ -0,0 +1,2 @@
+import 'react';
+export { A as AdvancedDateRangePicker, A as default } from '../../AdvancedDateRangePicker-D7xn4So6.mjs';

package/dist/atom/AdvancedDateRangePicker/AdvancedDateRangePicker.d.ts

@@ -0,0 +1,2 @@
+import 'react';
+export { A as AdvancedDateRangePicker, A as default } from '../../AdvancedDateRangePicker-D7xn4So6.js';