@jmruthers/pace-core 0.6.10 → 0.6.12

package/dist/types-BE2sEHKd.d.ts

@@ -1,55 +0,0 @@
-import * as React from 'react';
-import { P as Permission, A as AccessLevel } from './types-CvOPXWWZ.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 };

package/dist/types-CvOPXWWZ.d.ts

@@ -1,111 +0,0 @@
-import { A as AppId, P as PageId } from './core-CUElvH_C.js';
-import { User } from '@supabase/supabase-js';
-
-/**
- * RBAC (Role-Based Access Control) Types - Build Contract Compliant
- * @package @jmruthers/pace-core
- * @module RBAC/Types
- * @since 1.0.0
- *
- * This module defines the core types for the RBAC system that match the build contract exactly.
- * All types are designed to be framework-agnostic and provide strong typing for permission operations.
- */
-
-type UUID = string;
-type Operation = 'read' | 'create' | 'update' | 'delete';
-type Permission = `${Operation}:${string}`;
-type AccessLevel = 'viewer' | 'participant' | 'planner' | 'admin' | 'super';
-/**
- * Scope defines the context for permission checks.
- * Can include organisation, event, and/or app identifiers.
- */
-type Scope = {
-    organisationId?: UUID;
-    eventId?: string;
-    appId?: AppId | UUID;
-};
-/**
- * Permission check request parameters.
- * Defines who (userId) is checking what permission in what context (scope).
- */
-type PermissionCheck = {
-    userId: UUID;
-    scope: Scope;
-    permission: Permission;
-    pageId?: PageId | UUID;
-};
-type PermissionMap = Record<Permission, boolean> & Partial<Record<'*', boolean>>;
-type GlobalRole = 'super_admin';
-type OrganisationRole = 'supporter' | 'member' | 'leader' | 'org_admin';
-type EventAppRole = 'viewer' | 'participant' | 'planner' | 'event_admin';
-type AuditEventType = 'permission_check' | 'permission_denied' | 'role_granted' | 'role_denied' | 'rls_denied';
-type AuditEventSource = 'api' | 'ui' | 'middleware' | 'rls';
-interface RBACAuditEvent {
-    id: UUID;
-    event_type: AuditEventType;
-    user_id: UUID;
-    organisation_id: UUID | null;
-    event_id?: string;
-    app_id?: UUID;
-    page_id?: UUID;
-    permission?: string;
-    decision?: boolean;
-    source?: AuditEventSource;
-    bypass?: boolean;
-    duration_ms?: number;
-    metadata: Record<string, unknown>;
-    created_at: string;
-}
-interface RBACAppContext {
-    appId: UUID;
-    hasAccess: boolean;
-}
-interface RBACRoleContext {
-    globalRole: GlobalRole | null;
-    organisationRole: OrganisationRole | null;
-    eventAppRole: EventAppRole | null;
-}
-interface PermissionCacheKey {
-    userId: UUID;
-    organisationId?: UUID;
-    eventId?: string;
-    appId?: UUID;
-    permission?: Permission;
-    pageId?: UUID | string;
-}
-interface UserRBACContext {
-    user: User | null;
-    globalRole: GlobalRole | null;
-    organisationRole: OrganisationRole | null;
-    eventAppRole: EventAppRole | null;
-    hasGlobalPermission: (permission: Permission) => boolean;
-    isSuperAdmin: boolean;
-    isOrgAdmin: boolean;
-    isEventAdmin: boolean;
-    canManageOrganisation: boolean;
-    canManageEvent: boolean;
-    isLoading: boolean;
-    error: Error | null;
-}
-declare class RBACError extends Error {
-    code: string;
-    context?: Record<string, unknown> | undefined;
-    constructor(message: string, code: string, context?: Record<string, unknown> | undefined);
-}
-declare class PermissionDeniedError extends RBACError {
-    constructor(permission: Permission, context?: Record<string, unknown>);
-}
-declare class OrganisationContextRequiredError extends RBACError {
-    constructor();
-}
-declare class RBACNotInitializedError extends RBACError {
-    constructor();
-}
-declare class InvalidScopeError extends RBACError {
-    constructor(scope: Scope, reason: string);
-}
-declare class MissingUserContextError extends RBACError {
-    constructor();
-}
-
-export { type AccessLevel as A, type EventAppRole as E, type GlobalRole as G, InvalidScopeError as I, MissingUserContextError as M, type Operation as O, type Permission as P, RBACError as R, type Scope as S, type UUID as U, type PermissionCheck as a, type PermissionMap as b, type OrganisationRole as c, PermissionDeniedError as d, OrganisationContextRequiredError as e, RBACNotInitializedError as f, type PermissionCacheKey as g, type AuditEventSource as h, type RBACAuditEvent as i, type RBACAppContext as j, type RBACRoleContext as k, type UserRBACContext as l };

package/dist/types-D05dCGma.d.ts

@@ -1,521 +0,0 @@
-import * as React from 'react';
-import React__default from 'react';
-import { ColumnDef, SortingState, ColumnFiltersState, GroupingState } from '@tanstack/react-table';
-
-/**
- * @file Toast hook for managing toast notifications
- * @package @jmruthers/pace-core
- * @module Hooks
- * @since 0.1.0
- *
- * Toast notifications automatically dismiss after 5 seconds by default.
- * The duration is fixed to the pace-core default to ensure consistent behaviour.
- */
-
-interface ToastProps {
-    title?: React.ReactNode;
-    description?: React.ReactNode;
-    variant?: 'default' | 'destructive' | 'success';
-    onClose?: () => void;
-    action?: React.ReactElement;
-}
-/**
- * Extended toast props with additional properties
- * @interface ToasterToast
- */
-type ToasterToast = ToastProps & {
-    /** Unique identifier for the toast */
-    id: string;
-    /** Duration before automatic dismissal in milliseconds */
-    duration?: number;
-    /** Optional title content */
-    title?: React.ReactNode;
-    /** Optional description content */
-    description?: React.ReactNode;
-    /** Optional action button */
-    action?: React.ReactElement<unknown>;
-    /** Open state */
-    open?: boolean;
-    /** Open change handler */
-    onOpenChange?: (open: boolean) => void;
-    /** Dismiss function */
-    dismiss?: () => void;
-};
-/**
- * Toast configuration without ID
- * Duration is fixed to DEFAULT_TOAST_DURATION and cannot be overridden
- */
-type Toast = Omit<ToasterToast, "id" | "duration">;
-/**
- * Creates a new toast notification
- * @param props - Toast configuration. Duration is automatically set to 5 seconds (5000ms) and cannot be customized.
- * @returns Object with toast ID and control methods
- */
-declare function toast(props: Toast): {
-    id: string;
-    dismiss: () => void;
-    update: (props: Partial<Omit<ToasterToast, "id" | "duration">>) => void;
-};
-/**
- * Hook for managing toast notifications
- * @returns Object with toast state and control methods
- */
-declare function useToast(): {
-    toast: typeof toast;
-    dismiss: (toastId?: string) => void;
-    /** Array of active toasts */
-    toasts: ToasterToast[];
-};
-
-/**
- * @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;
-    /** Alternative CSV headers that should map to this column during import */
-    importAliases?: string[];
-    /** 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 AggregateConfig as A, type ChunkingConfig as C, type DataTableColumn as D, type EmptyStateConfig as E, type GetRowId as G, type HierarchicalConfig as H, type PerformanceConfig as P, type ServerSideConfig as S, type DataTableAction as a, type DataTableToolbarButton as b, type DataRecord as c, type SearchIndexConfig as d, type PaginationMode as e, type ServerSideParams as f, type ServerSideResponse as g, type DataTableFeatureConfig as h, type ExportOptions as i, type DataTableRBACConfig as j, useToast as u };