@nccirtu/tablefy 0.1.0

package/dist/lib/builders/empty-state.d.ts

@@ -0,0 +1,27 @@
+import { EmptyStateConfig } from "../types/empty-state";
+import React from "react";
+/**
+ * Empty State Builder
+ * Fluent API for building empty state configurations
+ */
+export declare class EmptyStateBuilder {
+    private config;
+    static make(): EmptyStateBuilder;
+    title(title: string): this;
+    description(description: string): this;
+    icon(icon: React.ReactNode): this;
+    imageUrl(imageUrl: string): this;
+    action(label: string, onClick?: () => void, href?: string, icon?: React.ReactNode): this;
+    variant(variant: "default" | "search" | "filter" | "error" | "custom"): this;
+    error(params?: {
+        onRetry?: () => void;
+    }): this;
+    noSearchResults(params?: {
+        onClear?: () => void;
+    }): this;
+    noFilterResults(params?: {
+        onReset?: () => void;
+    }): this;
+    noData(): this;
+    build(): EmptyStateConfig;
+}

package/dist/lib/builders/index.d.ts

@@ -0,0 +1,2 @@
+export { TableSchema } from "./table-schema";
+export { EmptyStateBuilder } from "./empty-state";

package/dist/lib/builders/table-schema.d.ts

@@ -0,0 +1,15 @@
+import { ColumnDef } from "@tanstack/react-table";
+type ColumnBuilder<TData> = {
+    build(): ColumnDef<TData, unknown>;
+};
+/**
+ * Table Schema Builder
+ * Fluent API for building table column definitions
+ */
+export declare class TableSchema<TData> {
+    private columnBuilders;
+    static make<TData>(): TableSchema<TData>;
+    columns(...builders: ColumnBuilder<TData>[]): this;
+    build(): ColumnDef<TData, unknown>[];
+}
+export {};

package/dist/lib/table/schema/empty-state.d.ts

@@ -0,0 +1,23 @@
+import { EmptyStateConfig } from "../types";
+import React from "react";
+export declare class EmptyStateBuilder {
+    private config;
+    static make(): EmptyStateBuilder;
+    title(title: string): this;
+    description(description: string): this;
+    icon(icon: React.ReactNode): this;
+    imageUrl(imageUrl: string): this;
+    action(label: string, onClick?: () => void, href?: string, icon?: React.ReactNode): this;
+    variant(variant: "default" | "search" | "filter" | "error" | "custom"): this;
+    error(params?: {
+        onRetry?: () => void;
+    }): this;
+    noSearchResults(params?: {
+        onClear?: () => void;
+    }): this;
+    noFilterResults(params?: {
+        onReset?: () => void;
+    }): this;
+    noData(): this;
+    build(): EmptyStateConfig;
+}

package/dist/lib/table/types.d.ts

@@ -0,0 +1,76 @@
+import { ReactNode } from "react";
+export interface HeaderAction<TData = unknown> {
+    id: string;
+    label: string;
+    icon?: ReactNode;
+    variant?: "default" | "secondary" | "outline" | "ghost" | "destructive";
+    size?: "default" | "sm" | "lg" | "icon";
+    onClick?: () => void;
+    href?: string;
+    disabled?: boolean;
+    loading?: boolean;
+    bulk?: boolean;
+    bulkOnClick?: (selectedRows: TData[]) => void;
+    hidden?: boolean;
+    children?: Omit<HeaderAction<TData>, "children" | "bulk">[];
+}
+export interface EmptyStateConfig {
+    icon?: ReactNode;
+    imageUrl?: string;
+    title: string;
+    description?: string;
+    action?: {
+        label: string;
+        onClick?: () => void;
+        href?: string;
+        icon?: ReactNode;
+    };
+    variant?: "default" | "search" | "filter" | "error" | "custom";
+}
+export interface FilterConfig {
+    id: string;
+    label: string;
+    type: "text" | "select" | "multi-select" | "date" | "date-range" | "boolean";
+    column: string;
+    placeholder?: string;
+    options?: Array<{
+        label: string;
+        value: string;
+    }>;
+}
+export interface SearchConfig {
+    enabled: boolean;
+    placeholder?: string;
+    columns?: string[];
+    debounce?: number;
+}
+export interface PaginationConfig {
+    enabled: boolean;
+    pageSize?: number;
+    pageSizeOptions?: number[];
+    showPageInfo?: boolean;
+    showPageSizeSelector?: boolean;
+}
+export interface DataTableConfig<TData> {
+    title?: string;
+    description?: string;
+    headerActions?: HeaderAction<TData>[];
+    emptyState?: EmptyStateConfig;
+    searchEmptyState?: EmptyStateConfig;
+    filterEmptyState?: EmptyStateConfig;
+    search?: SearchConfig;
+    filters?: FilterConfig[];
+    pagination?: PaginationConfig;
+    enableRowSelection?: boolean;
+    enableMultiRowSelection?: boolean;
+    enableSorting?: boolean;
+    defaultSort?: {
+        id: string;
+        desc: boolean;
+    };
+    enableColumnVisibility?: boolean;
+    density?: "compact" | "default" | "comfortable";
+    bordered?: boolean;
+    striped?: boolean;
+    hoverable?: boolean;
+}

package/dist/lib/types/actions.d.ts

@@ -0,0 +1,20 @@
+import { ReactNode } from "react";
+/**
+ * Header Action Configuration
+ * Defines actions that can be displayed in the table header
+ */
+export interface HeaderAction<TData = unknown> {
+    id: string;
+    label: string;
+    icon?: ReactNode;
+    variant?: "default" | "secondary" | "outline" | "ghost" | "destructive";
+    size?: "default" | "sm" | "lg" | "icon";
+    onClick?: () => void;
+    href?: string;
+    disabled?: boolean;
+    loading?: boolean;
+    bulk?: boolean;
+    bulkOnClick?: (selectedRows: TData[]) => void;
+    hidden?: boolean;
+    children?: Omit<HeaderAction<TData>, "children" | "bulk">[];
+}

package/dist/lib/types/empty-state.d.ts

@@ -0,0 +1,18 @@
+import { ReactNode } from "react";
+/**
+ * Empty State Configuration
+ * Defines how empty states are displayed in the table
+ */
+export interface EmptyStateConfig {
+    icon?: ReactNode;
+    imageUrl?: string;
+    title: string;
+    description?: string;
+    action?: {
+        label: string;
+        onClick?: () => void;
+        href?: string;
+        icon?: ReactNode;
+    };
+    variant?: "default" | "search" | "filter" | "error" | "custom";
+}

package/dist/lib/types/filters.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Filter Configuration
+ * Defines filters that can be applied to table data
+ */
+export interface FilterConfig {
+    id: string;
+    label: string;
+    type: "text" | "select" | "multi-select" | "date" | "date-range" | "boolean";
+    column: string;
+    placeholder?: string;
+    options?: Array<{
+        label: string;
+        value: string;
+    }>;
+}
+/**
+ * Search Configuration
+ * Defines search functionality for the table
+ */
+export interface SearchConfig {
+    enabled: boolean;
+    placeholder?: string;
+    columns?: string[];
+    debounce?: number;
+}

package/dist/lib/types/index.d.ts

@@ -0,0 +1,4 @@
+export type { HeaderAction } from "./actions";
+export type { EmptyStateConfig } from "./empty-state";
+export type { FilterConfig, SearchConfig } from "./filters";
+export type { PaginationConfig, DataTableConfig } from "./table";

package/dist/lib/types/table.d.ts

@@ -0,0 +1,41 @@
+import { HeaderAction } from "./actions";
+import { EmptyStateConfig } from "./empty-state";
+import { FilterConfig, SearchConfig } from "./filters";
+/**
+ * Pagination Configuration
+ * Defines pagination settings for the table
+ */
+export interface PaginationConfig {
+    enabled: boolean;
+    pageSize?: number;
+    pageSizeOptions?: number[];
+    showPageInfo?: boolean;
+    showPageSizeSelector?: boolean;
+}
+/**
+ * Complete Data Table Configuration
+ * Main configuration object for the data table component
+ */
+export interface DataTableConfig<TData> {
+    title?: string;
+    description?: string;
+    headerActions?: HeaderAction<TData>[];
+    emptyState?: EmptyStateConfig;
+    searchEmptyState?: EmptyStateConfig;
+    filterEmptyState?: EmptyStateConfig;
+    search?: SearchConfig;
+    filters?: FilterConfig[];
+    pagination?: PaginationConfig;
+    enableRowSelection?: boolean;
+    enableMultiRowSelection?: boolean;
+    enableSorting?: boolean;
+    defaultSort?: {
+        id: string;
+        desc: boolean;
+    };
+    enableColumnVisibility?: boolean;
+    density?: "compact" | "default" | "comfortable";
+    bordered?: boolean;
+    striped?: boolean;
+    hoverable?: boolean;
+}

package/dist/lib/utils.d.ts

@@ -0,0 +1 @@
+export declare function cn(...inputs: Array<string | boolean | undefined | null>): string;

package/dist/schema/data-table-schema.d.ts

@@ -0,0 +1,75 @@
+import { ColumnDef } from '@tanstack/react-table';
+import { ReactNode } from 'react';
+import { DataTableConfig, EmptyStateConfig, HeaderAction } from '../types';
+type ColumnBuilder<TData> = {
+    build(): ColumnDef<TData, unknown>;
+};
+export declare class DataTableSchema<TData> {
+    private config;
+    private columnBuilders;
+    static make<TData>(): DataTableSchema<TData>;
+    title(title: string): this;
+    description(description: string): this;
+    headerActions(builder: (b: HeaderActionsBuilder<TData>) => HeaderActionsBuilder<TData>): this;
+    emptyState(config: EmptyStateConfig): this;
+    searchEmptyState(config: EmptyStateConfig): this;
+    filterEmptyState(config: EmptyStateConfig): this;
+    searchable(config?: {
+        placeholder?: string;
+        columns?: string[];
+        debounce?: number;
+    }): this;
+    paginated(config?: {
+        pageSize?: number;
+        pageSizeOptions?: number[];
+    }): this;
+    selectable(multi?: boolean): this;
+    sortable(defaultSort?: {
+        id: string;
+        desc: boolean;
+    }): this;
+    bordered(bordered?: boolean): this;
+    striped(striped?: boolean): this;
+    hoverable(hoverable?: boolean): this;
+    density(density: 'compact' | 'default' | 'comfortable'): this;
+    columns(...builders: ColumnBuilder<TData>[]): this;
+    build(): {
+        columns: ColumnDef<TData, unknown>[];
+        config: DataTableConfig<TData>;
+    };
+}
+declare class HeaderActionsBuilder<TData> {
+    private actions;
+    create(config: {
+        label: string;
+        href?: string;
+        onClick?: () => void;
+        icon?: ReactNode;
+    }): this;
+    export(config: {
+        label: string;
+        icon?: ReactNode;
+        formats?: Array<{
+            label: string;
+            onClick: () => void;
+        }>;
+    }): this;
+    import(config: {
+        label: string;
+        icon?: ReactNode;
+        onClick?: () => void;
+    }): this;
+    bulkExport(config: {
+        label: string;
+        icon?: ReactNode;
+        onExport: (rows: TData[]) => void;
+    }): this;
+    bulkDelete(config: {
+        label: string;
+        icon?: ReactNode;
+        onDelete: (rows: TData[]) => void;
+    }): this;
+    action(config: HeaderAction<TData>): this;
+    build(): HeaderAction<TData>[];
+}
+export { HeaderActionsBuilder };

package/dist/schema/empty-state.d.ts

@@ -0,0 +1,45 @@
+import { ReactNode } from 'react';
+import { EmptyStateConfig } from '../types';
+export declare class EmptyStateBuilder {
+    private config;
+    static make(): EmptyStateBuilder;
+    title(title: string): this;
+    description(description: string): this;
+    icon(icon: ReactNode): this;
+    imageUrl(imageUrl: string): this;
+    variant(variant: EmptyStateConfig['variant']): this;
+    action(config: {
+        label: string;
+        onClick?: () => void;
+        href?: string;
+        icon?: ReactNode;
+    }): this;
+    static noData(config?: {
+        title?: string;
+        description?: string;
+        createLabel?: string;
+        onCreate?: () => void;
+        createHref?: string;
+    }): EmptyStateBuilder;
+    static noSearchResults(config?: {
+        title?: string;
+        description?: string;
+        onClear?: () => void;
+    }): EmptyStateBuilder;
+    static noFilterResults(config?: {
+        title?: string;
+        description?: string;
+        onClear?: () => void;
+    }): EmptyStateBuilder;
+    static error(config?: {
+        title?: string;
+        description?: string;
+        onRetry?: () => void;
+    }): EmptyStateBuilder;
+    private createInboxIcon;
+    private createSearchIcon;
+    private createFilterIcon;
+    private createAlertIcon;
+    private createPlusIcon;
+    build(): EmptyStateConfig;
+}

package/dist/schema/table-schema.d.ts

@@ -0,0 +1,44 @@
+import { ReactNode } from 'react';
+import { EmptyStateConfig } from '../types';
+export declare class EmptyStateBuilder {
+    private config;
+    static make(): EmptyStateBuilder;
+    title(title: string): this;
+    description(description: string): this;
+    icon(icon: ReactNode): this;
+    variant(variant: EmptyStateConfig['variant']): this;
+    action(config: {
+        label: string;
+        onClick?: () => void;
+        href?: string;
+        icon?: ReactNode;
+    }): this;
+    static noData(config?: {
+        title?: string;
+        description?: string;
+        createLabel?: string;
+        onCreate?: () => void;
+        createHref?: string;
+    }): EmptyStateBuilder;
+    static noSearchResults(config?: {
+        title?: string;
+        description?: string;
+        onClear?: () => void;
+    }): EmptyStateBuilder;
+    static noFilterResults(config?: {
+        title?: string;
+        description?: string;
+        onClear?: () => void;
+    }): EmptyStateBuilder;
+    static error(config?: {
+        title?: string;
+        description?: string;
+        onRetry?: () => void;
+    }): EmptyStateBuilder;
+    private createInboxIcon;
+    private createSearchIcon;
+    private createFilterIcon;
+    private createAlertIcon;
+    private createPlusIcon;
+    build(): EmptyStateConfig;
+}

package/dist/schema.d.ts

@@ -0,0 +1,11 @@
+import { ColumnDef } from '@tanstack/react-table';
+type ColumnBuilder<TData> = {
+    build(): ColumnDef<TData, unknown>;
+};
+export declare class TableSchema<TData> {
+    private columnBuilders;
+    static make<TData>(): TableSchema<TData>;
+    columns(...builders: ColumnBuilder<TData>[]): this;
+    build(): ColumnDef<TData, unknown>[];
+}
+export {};

package/dist/src/columns/actions-column.d.ts

@@ -0,0 +1,26 @@
+import { ColumnDef } from '@tanstack/react-table';
+import { ReactNode } from 'react';
+interface ActionItem<TData> {
+    label: string;
+    icon?: ReactNode;
+    onClick?: (row: TData) => void;
+    href?: (row: TData) => string;
+    variant?: 'default' | 'destructive';
+    separator?: boolean;
+    hidden?: (row: TData) => boolean;
+    disabled?: (row: TData) => boolean;
+}
+export declare class ActionsColumn<TData> {
+    private config;
+    static make<TData>(): ActionsColumn<TData>;
+    label(label: string): this;
+    triggerIcon(icon: ReactNode): this;
+    action(action: ActionItem<TData>): this;
+    view(onClick: (row: TData) => void): this;
+    edit(onClick: (row: TData) => void): this;
+    delete(onClick: (row: TData) => void): this;
+    link(label: string, href: (row: TData) => string): this;
+    separator(): this;
+    build(): ColumnDef<TData, unknown>;
+}
+export {};

package/dist/src/columns/avatar-group-column.d.ts

@@ -0,0 +1,38 @@
+import { ColumnDef } from "@tanstack/react-table";
+import { BaseColumn } from "./base-column";
+import { BaseColumnConfig } from "./types";
+interface AvatarItem {
+    src?: string;
+    name: string;
+    fallback?: string;
+}
+interface AvatarGroupColumnConfig<TData> extends BaseColumnConfig<TData> {
+    maxVisible?: number;
+    size?: "xs" | "sm" | "md" | "lg";
+    overlap?: "none" | "sm" | "md" | "lg";
+    showTooltip?: boolean;
+    nameField?: keyof TData | ((row: TData) => AvatarItem[]);
+    srcField?: string;
+    fallbackField?: string;
+    showNames?: boolean;
+    maxNames?: number;
+}
+export declare class AvatarGroupColumn<TData> extends BaseColumn<TData, AvatarGroupColumnConfig<TData>> {
+    constructor(accessor: keyof TData | string);
+    static make<TData>(accessor: keyof TData | string): AvatarGroupColumn<TData>;
+    maxVisible(max: number): this;
+    size(size: "xs" | "sm" | "md" | "lg"): this;
+    overlap(overlap: "none" | "sm" | "md" | "lg"): this;
+    noOverlap(): this;
+    hideTooltip(): this;
+    fields(config: {
+        src?: string;
+        name: string;
+        fallback?: string;
+    }): this;
+    mapItems(fn: (row: TData) => AvatarItem[]): this;
+    showNames(show?: boolean, max?: number): this;
+    private toContactItems;
+    build(): ColumnDef<TData, unknown>;
+}
+export {};

package/dist/src/columns/badge-column.d.ts

@@ -0,0 +1,22 @@
+import { ColumnDef } from "@tanstack/react-table";
+import { ReactNode } from "react";
+import { BaseColumn } from "./base-column";
+import { BadgeColumnConfig } from "./types";
+type BadgeVariant = "default" | "secondary" | "destructive" | "outline" | "success" | "warning" | "info" | "muted";
+interface VariantConfig {
+    label?: string;
+    variant?: BadgeVariant;
+    className?: string;
+    icon?: ReactNode;
+}
+export declare class BadgeColumn<TData> extends BaseColumn<TData, BadgeColumnConfig<TData>> {
+    static make<TData>(accessor: keyof TData | string): BadgeColumn<TData>;
+    variants(variants: Record<string, VariantConfig>): this;
+    boolean(trueLabel?: string, falseLabel?: string): this;
+    status(statuses: Record<string, {
+        label: string;
+        color: string;
+    }>): this;
+    build(): ColumnDef<TData, unknown>;
+}
+export {};

package/dist/src/columns/base-column.d.ts

@@ -0,0 +1,19 @@
+import { ColumnDef } from '@tanstack/react-table';
+import { BaseColumnConfig } from './types';
+export declare abstract class BaseColumn<TData, TConfig extends BaseColumnConfig<TData>> {
+    protected config: TConfig;
+    constructor(accessor: keyof TData | string);
+    label(label: string): this;
+    sortable(sortable?: boolean): this;
+    searchable(searchable?: boolean): this;
+    hidden(hidden?: boolean): this;
+    alignLeft(): this;
+    alignCenter(): this;
+    alignRight(): this;
+    width(width: string | number): this;
+    className(className: string): this;
+    headerClassName(className: string): this;
+    cellClassName(className: string): this;
+    abstract build(): ColumnDef<TData, unknown>;
+    protected getAlignmentClass(): string;
+}

package/dist/src/columns/button-column.d.ts

@@ -0,0 +1,14 @@
+interface ButtonColumnConfig {
+    accessorKey?: string;
+    header?: string;
+    label?: string;
+    onClick?: (data: any) => void;
+}
+export declare const ButtonColumn: (config: ButtonColumnConfig) => {
+    accessorKey: string;
+    header: string;
+    cell: ({ row }: {
+        row: any;
+    }) => import("react/jsx-runtime").JSX.Element;
+};
+export { ButtonColumn as buttonColumn };

package/dist/src/columns/checkbox-column.d.ts

@@ -0,0 +1,5 @@
+import { ColumnDef } from '@tanstack/react-table';
+export declare class CheckboxColumn<TData> {
+    static make<TData>(): CheckboxColumn<TData>;
+    build(): ColumnDef<TData, unknown>;
+}

package/dist/src/columns/date-column.d.ts

@@ -0,0 +1,24 @@
+import { ColumnDef } from '@tanstack/react-table';
+import { BaseColumn } from './base-column';
+import { BaseColumnConfig } from './types';
+interface DateColumnConfig<TData> extends BaseColumnConfig<TData> {
+    format?: 'short' | 'long' | 'relative' | 'time' | 'datetime' | string;
+    locale?: string;
+    showIcon?: boolean;
+}
+export declare class DateColumn<TData> extends BaseColumn<TData, DateColumnConfig<TData>> {
+    constructor(accessor: keyof TData | string);
+    static make<TData>(accessor: keyof TData | string): DateColumn<TData>;
+    format(format: 'short' | 'long' | 'relative' | 'time' | 'datetime'): this;
+    locale(locale: string): this;
+    withIcon(show?: boolean): this;
+    short(): this;
+    long(): this;
+    relative(): this;
+    time(): this;
+    datetime(): this;
+    private formatDate;
+    private getRelativeTime;
+    build(): ColumnDef<TData, unknown>;
+}
+export {};

package/dist/src/columns/dropdown-column.d.ts

@@ -0,0 +1,17 @@
+interface DropdownOption {
+    label: string;
+    onClick?: (data: any) => void;
+}
+interface DropdownColumnConfig {
+    accessorKey?: string;
+    header?: string;
+    options: DropdownOption[];
+}
+export declare const DropdownColumn: (config: DropdownColumnConfig) => {
+    accessorKey: string;
+    header: string;
+    cell: ({ row }: {
+        row: any;
+    }) => import("react/jsx-runtime").JSX.Element;
+};
+export { DropdownColumn as dropdownColumn };