@jmruthers/pace-core 0.6.9 → 0.6.11

package/dist/types-DXstZpNI.d.ts

@@ -1,614 +0,0 @@
-import React__default from 'react';
-import { ColumnDef, SortingState, ColumnFiltersState, GroupingState } from '@tanstack/react-table';
-
-/**
- * @file Google Places API Types
- * @package @jmruthers/pace-core
- * @module Utils/GooglePlaces
- * @since 0.1.0
- */
-/**
- * Google Places Autocomplete API response prediction
- */
-interface GooglePlaceAutocompletePrediction {
-    description: string;
-    place_id: string;
-    structured_formatting?: {
-        main_text: string;
-        secondary_text: string;
-    };
-    types?: string[];
-}
-/**
- * Parsed address matching core_address table structure
- */
-interface ParsedAddress {
-    place_id: string;
-    full_address: string | null;
-    street_number: string | null;
-    route: string | null;
-    suburb: string | null;
-    state: string | null;
-    postcode: string | null;
-    country: string | null;
-    lat: number | null;
-    lng: number | null;
-}
-/**
- * Options for Google Places Autocomplete API
- */
-interface AutocompleteOptions {
-    /** Restrict results to specific countries (ISO 3166-1 Alpha-2 country codes) */
-    components?: string;
-    /** Location bias (lat,lng) */
-    location?: string;
-    /** Radius in meters for location bias */
-    radius?: number;
-    /** Restrict results to specific place types */
-    types?: string;
-    /** Language code for results */
-    language?: string;
-}
-
-/**
- * @file Google Maps Script Loader
- * @package @jmruthers/pace-core
- * @module Utils/GooglePlaces
- * @since 0.1.0
- *
- * Utility to dynamically load the Google Maps JavaScript API.
- * This is required because the REST API doesn't support CORS from browsers.
- */
-declare global {
-    interface Window {
-        google?: {
-            maps: {
-                places: {
-                    AutocompleteSuggestion: {
-                        fetchAutocompleteSuggestions: (request: {
-                            input: string;
-                            includedRegionCodes?: string[];
-                            locationBias?: {
-                                circle?: {
-                                    center: {
-                                        latitude: number;
-                                        longitude: number;
-                                    };
-                                    radius: number;
-                                };
-                            };
-                            includedPrimaryTypes?: string[];
-                            languageCode?: string;
-                        }) => Promise<{
-                            suggestions: Array<{
-                                placePrediction?: {
-                                    placeId: string;
-                                    text: {
-                                        text: string;
-                                        matches: Array<{
-                                            endOffset: number;
-                                            startOffset: number;
-                                        }>;
-                                    };
-                                    structuredFormat?: {
-                                        mainText: {
-                                            text: string;
-                                        };
-                                        secondaryText: {
-                                            text: string;
-                                        };
-                                    };
-                                };
-                            }>;
-                        }>;
-                    };
-                    AutocompleteService: new () => {
-                        getPlacePredictions: (request: {
-                            input: string;
-                            componentRestrictions?: {
-                                country: string | string[];
-                            };
-                            location?: {
-                                lat: () => number;
-                                lng: () => number;
-                            };
-                            radius?: number;
-                            types?: string[];
-                            language?: string;
-                        }, callback: (predictions: Array<{
-                            description: string;
-                            place_id: string;
-                            structured_formatting: {
-                                main_text: string;
-                                secondary_text: string;
-                            };
-                        }> | null, status: string) => void) => void;
-                    };
-                    PlacesService: new (element: HTMLElement) => {
-                        getDetails: (request: {
-                            placeId: string;
-                            fields?: string[];
-                        }, callback: (place: {
-                            place_id: string;
-                            formatted_address?: string;
-                            address_components?: Array<{
-                                long_name: string;
-                                short_name: string;
-                                types: string[];
-                            }>;
-                            geometry?: {
-                                location?: {
-                                    lat: () => number;
-                                    lng: () => number;
-                                };
-                            };
-                        } | null, status: string) => void) => void;
-                    };
-                    PlacesServiceStatus: {
-                        OK: string;
-                        ZERO_RESULTS: string;
-                        NOT_FOUND: string;
-                        REQUEST_DENIED: string;
-                        INVALID_REQUEST: string;
-                        OVER_QUERY_LIMIT: string;
-                    };
-                };
-                LatLng: new (lat: number, lng: number) => {
-                    lat: () => number;
-                    lng: () => number;
-                };
-            };
-        };
-    }
-}
-
-/**
- * @file DataTable Type Definitions
- * @package @jmruthers/pace-core
- * @module Components/DataTable/Types
- * @since 0.2.0
- */
-
-declare module '@tanstack/react-table' {
-    interface ColumnMeta<TData, TValue> {
-        /** Text alignment for the column content */
-        align?: 'left' | 'right' | 'center';
-        /** Column type for styling purposes */
-        type?: 'text' | 'number' | 'date' | 'boolean' | 'custom';
-    }
-    interface ColumnDefBase<TData, TValue> {
-        /** Alternative accessor key used while editing */
-        editAccessorKey?: string;
-    }
-}
-/**
- * Base data record type - all DataTable data must extend this
- * This is a marker type that allows any object to be used as a data record
- * Individual implementations should define more specific types
- */
-interface DataRecord {
-    [key: string]: unknown;
-}
-/**
- * Row ID type - always a string
- */
-type RowId = string;
-/**
- * Row identifier function type
- */
-type GetRowId<TData extends DataRecord> = (row: TData, index: number) => RowId;
-/**
- * Hierarchical configuration for DataTable
- */
-interface HierarchicalConfig {
-    /** Enable hierarchical functionality */
-    enabled: boolean;
-    /** Default expanded state - true = all expanded, false = all collapsed, array = specific IDs */
-    defaultExpanded?: boolean | string[];
-    /** Callback when expanded state changes */
-    onExpandedChange?: (expandedIds: string[]) => void;
-    /** Visual indentation for child rows (in pixels) */
-    indentSize?: number;
-    /** Custom styling for parent rows */
-    parentRowClassName?: string;
-    /** Custom styling for child rows */
-    childRowClassName?: string;
-}
-/**
- * Pagination mode determines how data is handled
- */
-type PaginationMode = 'client' | 'server' | 'hybrid';
-/**
- * Performance configuration for large datasets
- */
-interface PerformanceConfig {
-    /** Enable virtual scrolling */
-    virtualScrolling?: boolean;
-    /** Virtual scrolling overscan count */
-    overscan?: number;
-    /** Enable memoization of cell renderers */
-    memoizeCells?: boolean;
-    /** Enable debounced search */
-    debounceSearch?: number;
-    /** Enable data chunking for memory management */
-    enableChunking?: boolean;
-    /** Chunk size for data processing */
-    chunkSize?: number;
-    /** Enable Web Workers for heavy operations */
-    enableWebWorkers?: boolean;
-    /** Threshold for switching to server-side mode */
-    serverSideThreshold?: number;
-}
-/**
- * Server-side data fetching configuration
- */
-interface ServerSideConfig<TData extends DataRecord> {
-    /** Function to fetch data from server */
-    fetchData: (params: ServerSideParams) => Promise<ServerSideResponse<TData>>;
-    /** Enable server-side sorting */
-    enableServerSorting?: boolean;
-    /** Enable server-side filtering */
-    enableServerFiltering?: boolean;
-    /** Enable server-side search */
-    enableServerSearch?: boolean;
-    /** Enable server-side pagination */
-    enableServerPagination?: boolean;
-    /** Debounce delay for server requests */
-    debounceMs?: number;
-    /** Cache duration for server responses */
-    cacheMs?: number;
-}
-/**
- * Parameters sent to server for data fetching
- */
-interface ServerSideParams {
-    /** Current page index */
-    pageIndex: number;
-    /** Page size */
-    pageSize: number;
-    /** Sorting configuration */
-    sorting: SortingState;
-    /** Column filters */
-    columnFilters: ColumnFiltersState;
-    /** Global filter/search term */
-    globalFilter: string;
-    /** Grouping configuration */
-    grouping: GroupingState;
-}
-/**
- * Response from server for data fetching
- */
-interface ServerSideResponse<TData extends DataRecord> {
-    /** Array of data records */
-    data: TData[];
-    /** Total number of records (for pagination) */
-    totalCount: number;
-    /** Current page index */
-    pageIndex: number;
-    /** Page size */
-    pageSize: number;
-    /** Total number of pages */
-    pageCount: number;
-    /** Whether there are more pages */
-    hasNextPage: boolean;
-    /** Whether there are previous pages */
-    hasPreviousPage: boolean;
-}
-/**
- * Data chunking configuration
- */
-interface ChunkingConfig {
-    /** Size of each data chunk */
-    chunkSize: number;
-    /** Number of chunks to keep in memory */
-    maxChunksInMemory: number;
-    /** Enable progressive loading */
-    progressiveLoading?: boolean;
-}
-/**
- * Search index configuration for performance
- */
-interface SearchIndexConfig {
-    /** Fields to index for search */
-    indexedFields: string[];
-    /** Enable fuzzy search */
-    fuzzySearch?: boolean;
-    /** Fuzzy search threshold */
-    fuzzyThreshold?: number;
-    /** Enable search highlighting */
-    enableHighlighting?: boolean;
-}
-/**
- * Enhanced column definition that extends TanStack's ColumnDef
- */
-interface DataTableColumn<TData extends DataRecord = DataRecord> extends Omit<ColumnDef<TData>, 'id' | 'accessorKey'> {
-    /** Column identifier */
-    id?: string;
-    /** Accessor key for data */
-    accessorKey?: string;
-    /** Alternative accessor key used while editing */
-    editAccessorKey?: string;
-    /** Custom header label for the column */
-    header: string;
-    /** Whether this column should be searchable in global filter */
-    searchable?: boolean;
-    /** Enable sorting */
-    sortable?: boolean;
-    /** Enable column filter (inherits from ColumnDef) */
-    enableColumnFilter?: boolean;
-    /** Enable grouping (inherits from ColumnDef) */
-    enableGrouping?: boolean;
-    /** Enable hiding (inherits from ColumnDef) */
-    enableHiding?: boolean;
-    /** Aggregate configuration for this column */
-    aggregate?: AggregateConfig;
-    /** Enable virtual scrolling for this column */
-    virtualizable?: boolean;
-    /** Custom cell renderer with memoization */
-    memoizedCell?: React__default.ComponentType<{
-        row: TData;
-    }>;
-    /** Field type for editing (text, select, date, etc.) */
-    fieldType?: 'text' | 'select' | 'date' | 'number' | 'boolean';
-    /** Options for select fields - can be simple items or grouped with labels and separators */
-    fieldOptions?: Array<{
-        value: string | number;
-        label: string;
-    } | {
-        type: 'group';
-        label: string;
-        items: Array<{
-            value: string | number;
-            label: string;
-        }>;
-    } | {
-        type: 'separator';
-    }>;
-    /** Enable keyboard search/filtering in select dropdowns within editable columns (default: true). When fieldType is 'select', this controls dropdown searchability, not global search. */
-    selectSearchable?: boolean;
-    /** Enable creating new items in select dropdowns (default: false) */
-    creatable?: boolean;
-    /** Callback to create a new item when user types non-matching text in select dropdown */
-    onCreateNew?: (inputValue: string) => Promise<string | number> | string | number;
-    /** Maximum height for select dropdown content (default: "20rem") */
-    selectMaxHeight?: string;
-    /** Custom className for select content dropdown */
-    selectContentClassName?: string;
-    /** Custom style for select content dropdown */
-    selectContentStyle?: React__default.CSSProperties;
-    /** Hide spinner arrows on number input fields (default: true for DataTable) */
-    hideNumberSpinners?: boolean;
-    /** Filter type for column filtering (text, select, number, date) */
-    filterType?: 'text' | 'select' | 'number' | 'date';
-    /** Options for select filters (alternative to fieldOptions) */
-    filterSelectOptions?: Array<{
-        value: string | number;
-        label: string;
-    }>;
-    /** Whether this column is editable in edit mode (default: true) */
-    editable?: boolean;
-    /** Custom renderer for parent rows */
-    renderForParent?: (row: TData) => React__default.ReactNode;
-    /** Custom renderer for child rows */
-    renderForChild?: (row: TData) => React__default.ReactNode;
-    /** Hide this column for parent rows */
-    hideForParent?: boolean;
-    /** Hide this column for child rows */
-    hideForChild?: boolean;
-    /**
-     * Aggregation function for grouped rows.
-     * Receives all rows in the group and returns the aggregated value.
-     * If not provided, grouped rows will show empty/undefined for this column.
-     */
-    aggregateFn?: (rows: TData[], column: DataTableColumn<TData>) => unknown;
-    /**
-     * Optional: Custom cell renderer for aggregated values in grouped rows.
-     * If not provided, uses the column's regular cell renderer.
-     */
-    aggregateCell?: (value: unknown, rows: TData[], column: DataTableColumn<TData>) => React__default.ReactNode;
-}
-/**
- * Action definition for row-level operations
- */
-/**
- * Boolean condition or predicate evaluated against a row
- */
-type ActionCondition<TData extends DataRecord> = boolean | ((row: TData) => boolean);
-/**
- * Action definition for DataTable rows.
- * Defines custom actions that can be performed on table rows.
- *
- * @template TData - The type of data records in the table
- */
-interface DataTableAction<TData extends DataRecord> {
-    /** Display label for the action */
-    label: string;
-    /** Icon component */
-    icon?: React__default.ComponentType<{
-        className?: string;
-    }>;
-    /** Action handler */
-    onClick: (row: TData) => void;
-    /** Visual variant */
-    variant?: 'default' | 'destructive' | 'outline' | 'secondary' | 'ghost';
-    /** Whether action is disabled */
-    disabled?: ActionCondition<TData>;
-    /** Whether action is hidden (for RBAC) */
-    hidden?: boolean;
-    /** Explicit visibility override */
-    visible?: ActionCondition<TData>;
-    /** Test ID for testing */
-    testId?: string;
-    /** Whether this action should only show for parent rows (hierarchical mode) */
-    showForParent?: boolean;
-    /** Whether this action should only show for child rows (hierarchical mode) */
-    showForChild?: boolean;
-    /** Icon component for parent rows (overrides icon when showForParent is true) */
-    parentIcon?: React__default.ComponentType<{
-        className?: string;
-    }>;
-    /** Icon component for child rows (overrides icon when showForChild is true) */
-    childIcon?: React__default.ComponentType<{
-        className?: string;
-    }>;
-    /** Label for parent rows (overrides label when showForParent is true) */
-    parentLabel?: string;
-    /** Label for child rows (overrides label when showForChild is true) */
-    childLabel?: string;
-    /** Whether the action should be shown while the row is in edit mode */
-    showInEditMode?: boolean;
-    /** Whether the action should be hidden while the row is in view mode */
-    hideInViewMode?: boolean;
-    /** Whether the action should explicitly render while in view mode */
-    showInViewMode?: boolean;
-}
-/**
- * Toolbar button definition
- */
-interface DataTableToolbarButton {
-    /** Display label */
-    label: string;
-    /** Icon component */
-    icon?: React__default.ComponentType<{
-        className?: string;
-    }>;
-    /** Click handler */
-    onClick: () => void;
-    /** Visual variant */
-    variant?: 'default' | 'destructive' | 'outline' | 'secondary' | 'ghost';
-    /** Whether button is disabled */
-    disabled?: boolean;
-    /** Test ID for testing */
-    testId?: string;
-}
-/**
- * Aggregate configuration
- */
-interface AggregateConfig {
-    field: string;
-    function: 'sum' | 'avg' | 'count' | 'min' | 'max';
-    label: string;
-}
-/**
- * Empty state configuration
- */
-interface EmptyStateConfig {
-    title?: string;
-    description?: string;
-    icon?: React__default.ComponentType<{
-        className?: string;
-    }>;
-    action?: {
-        label: string;
-        onClick: () => void;
-    };
-}
-/**
- * Unified feature configuration for DataTable
- * All features are disabled by default and must be explicitly enabled
- */
-interface DataTableFeatureFlags {
-    /** Enable global search functionality */
-    search: boolean;
-    /** Enable pagination controls */
-    pagination: boolean;
-    /** Enable column sorting */
-    sorting: boolean;
-    /** Enable column filtering */
-    filtering: boolean;
-    /** Enable data import functionality */
-    import: boolean;
-    /** Enable data export functionality */
-    export: boolean;
-    /** Enable row selection for bulk operations */
-    selection: boolean;
-    /** Enable row creation */
-    creation: boolean;
-    /** Enable row editing */
-    editing: boolean;
-    /** Enable row deletion */
-    deletion: boolean;
-    /** Enable bulk deletion of selected rows */
-    deleteSelected: boolean;
-    /** Enable data grouping */
-    grouping: boolean;
-    /** Enable column visibility controls */
-    columnVisibility: boolean;
-    /** Enable column reordering */
-    columnReordering: boolean;
-    /** Enable hierarchical parent/child rows */
-    hierarchical: boolean;
-}
-/**
- * Consumer-facing feature configuration. All properties are optional and will be
- * merged with {@link defaultDataTableFeatures} at runtime to keep the public API
- * ergonomic while maintaining strict internal guarantees.
- */
-type DataTableFeatureConfig = Partial<DataTableFeatureFlags>;
-/**
- * RBAC configuration for DataTable - MANDATORY for all DataTables
- *
- * @example
- * ```tsx
- * <DataTable
- *   data={dishes}
- *   rbac={{ pageName: 'dishes' }} // Use page name (recommended)
- *   features={features}
- * />
- *
- * <DataTable
- *   data={dishes}
- *   rbac={{ pageId: 'uuid-here' }} // Use page ID directly
- *   features={features}
- * />
- * ```
- */
-interface DataTableRBACConfig {
-    /** Page name for page-based permissions - will be resolved to page ID */
-    pageName?: string;
-    /** Page ID for page-based permissions - used directly if provided */
-    pageId?: string;
-}
-/**
- * Options provided to the onExport handler for custom export functionality
- *
- * @example
- * ```tsx
- * <DataTable
- *   onExport={async (options) => {
- *     // Export only specific columns
- *     const customColumns = options.allColumns.filter(col =>
- *       ['name', 'email', 'role'].includes(col.accessorKey || '')
- *     );
- *     await exportToCSVWithTableRows(
- *       options.tableRows,
- *       customColumns,
- *       options.columnIdToTableColumn,
- *       'custom-export.csv'
- *     );
- *   }}
- * />
- * ```
- */
-interface ExportOptions<TData extends DataRecord> {
-    /** Filtered table rows with getValue() method for proper accessorFn evaluation */
-    tableRows: Array<{
-        original: TData;
-        getValue: (columnId: string) => unknown;
-        id: string;
-    }>;
-    /** All column definitions passed to the DataTable */
-    allColumns: DataTableColumn<TData>[];
-    /** Currently visible columns in the table */
-    visibleColumns: DataTableColumn<TData>[];
-    /** Mapping of column IDs to TanStack table column instances (for getValue() calls) */
-    columnIdToTableColumn: Map<string, unknown>;
-    /** Raw data array (unfiltered) */
-    data: TData[];
-    /** Default filename generated from table title */
-    filename: string;
-    /** TanStack table instance for advanced operations */
-    table: unknown;
-}
-
-export type { AutocompleteOptions as A, ChunkingConfig as C, DataTableColumn as D, EmptyStateConfig as E, GetRowId as G, HierarchicalConfig as H, ParsedAddress as P, ServerSideConfig as S, DataTableAction as a, DataTableToolbarButton as b, AggregateConfig as c, DataRecord as d, DataTableRBACConfig as e, DataTableFeatureConfig as f, PerformanceConfig as g, PaginationMode as h, SearchIndexConfig as i, ExportOptions as j, ServerSideParams as k, ServerSideResponse as l, GooglePlaceAutocompletePrediction as m };

package/dist/types-t9H8qKRw.d.ts

@@ -1,55 +0,0 @@
-import * as React from 'react';
-import { P as Permission, A as AccessLevel } from './types-BeoeWV5I.js';
-
-/**
- * Navigation mode type
- */
-type NavigationMode = "dropdown" | "hierarchical";
-/**
- * Navigation item metadata
- */
-interface NavigationItemMeta {
-    hidden?: boolean;
-    [key: string]: unknown;
-}
-/**
- * Navigation item interface
- */
-interface NavigationItem {
-    id: string;
-    label: string;
-    href?: string;
-    icon?: string;
-    children?: NavigationItem[];
-    permissions?: (Permission | string)[];
-    roles?: string[];
-    accessLevel?: AccessLevel | string;
-    meta?: NavigationItemMeta;
-    pageId?: string;
-}
-/**
- * Navigation menu component props
- */
-interface NavigationMenuProps extends React.HTMLAttributes<HTMLDivElement> {
-    items: NavigationItem[];
-    mode?: NavigationMode;
-    currentPath?: string;
-    onNavigate?: (item: NavigationItem) => void;
-    className?: string;
-    disabled?: boolean;
-    buttonText?: string;
-    showIcons?: boolean;
-    navigationLabel?: string;
-    strictMode?: boolean;
-    auditLog?: boolean;
-    onNavigationAccessDenied?: (item: NavigationItem) => void;
-    onStrictModeViolation?: (item: NavigationItem, reason: string) => void;
-    /**
-     * If true, indicates that items have already been filtered by the parent component (e.g., PaceAppLayout).
-     * When true, NavigationMenu will skip expensive permission checks and trust the provided items.
-     * This significantly improves performance when items are pre-filtered.
-     */
-    itemsPreFiltered?: boolean;
-}
-
-export type { NavigationMenuProps as N, NavigationItem as a, NavigationMode as b };