@jmruthers/pace-core 0.6.5 → 0.6.7

package/cursor-rules/09-operations.mdc

@@ -0,0 +1,365 @@
+---
+description: Enforce error handling patterns, performance optimization, and CI/CD integration patterns
+globs: ["src/**/*.{ts,tsx,js,jsx}", "supabase/migrations/**/*.sql", ".github/workflows/**/*.{yml,yaml}", "package.json"]
+alwaysApply: false
+paceCoreVersion: "0.6.x"
+rulesVersion: "2025-01-28"
+---
+# Operations Standards Guide
+
+**📚 Human-Readable Standard**: See [9-operations-standards.md](../../packages/core/docs/standards/9-operations-standards.md) for complete documentation.
+
+This guide enforces error handling patterns, performance optimization strategies, and CI/CD integration patterns.
+
+## AI Agent Instructions
+
+**When writing or modifying code, ALWAYS:**
+1. **Use type-safe errors** - Never use `any` for errors, always use type guards or Result types
+2. **Never expose internals** - User-facing errors must be friendly, never show SQL, stack traces, or file paths
+3. **Log with context** - Always log errors with context, but never log sensitive data (passwords, tokens, PII)
+4. **Memoize expensive operations** - Use `useMemo` for expensive computations, `useCallback` for stable references
+5. **Avoid new objects in render** - Never create new objects/arrays in render, memoize them with `useMemo`
+6. **Use helper functions in RLS** - Always use STABLE SECURITY DEFINER helper functions, never subqueries
+7. **Provide recovery paths** - When possible, provide retry logic or fallback values
+
+**Decision Tree: Error Handling**
+```
+1. What type of error is this?
+   ├─ API Error → Use ApiResult shape, user-friendly message
+   ├─ Validation Error → Use Zod errors, field-specific messages
+   ├─ Network Error → Retry logic, connection message
+   └─ Unknown Error → Generic user message, detailed log
+
+2. Should user see this error?
+   ├─ YES → User-friendly message (no internals)
+   └─ NO → Log only, show generic message
+
+3. Can we recover?
+   ├─ YES → Retry logic or fallback value
+   └─ NO → Show error, allow user to retry
+```
+
+**Decision Tree: Performance**
+```
+1. Is this expensive computation?
+   ├─ YES → Use useMemo
+   └─ NO → Don't memoize (overhead not worth it)
+
+2. Is this function passed as prop?
+   ├─ YES → Use useCallback
+   └─ NO → Regular function is fine
+
+3. Is this creating new object/array in render?
+   ├─ YES → Memoize with useMemo
+   └─ NO → Continue
+```
+
+## Error Handling Patterns
+
+### MUST: Use Type-Safe Error Handling
+
+**MUST use type guards or Result types, NEVER use `any`:**
+
+```tsx
+// ❌ WRONG: Using any
+catch (error: any) {
+  console.log(error.message);
+}
+
+// ✅ CORRECT: Type guard
+function isApiError(error: unknown): error is ApiError {
+  return typeof error === 'object' && error !== null && 'ok' in error && (error as ApiError).ok === false;
+}
+catch (error) {
+  if (isApiError(error)) {
+    handleApiError(error);
+  } else {
+    handleUnknownError(error);
+  }
+}
+
+// ✅ CORRECT: Result type
+type Result<T> = { ok: true; data: T } | { ok: false; error: ApiError };
+const result = await fetchData();
+if (result.ok) {
+  useData(result.data);
+} else {
+  showError(result.error.message);
+}
+```
+
+### MUST: Never Expose Internal Details
+
+**MUST NOT expose SQL, stack traces, file paths, or internal errors to users:**
+
+```tsx
+// ❌ WRONG: Exposing internal details
+toast.error(error.message); // May contain SQL, stack traces
+
+// ✅ CORRECT: User-friendly message
+toast.error('Unable to save changes. Please try again.');
+logger.error('Save failed', { error: error.message, context: 'saveUser' });
+```
+
+### MUST: Use Consistent Error Shapes
+
+**MUST use ApiResult shape for API errors:**
+
+```tsx
+// ✅ CORRECT: Consistent error shape
+type ApiError = {
+  ok: false;
+  error: {
+    code: string;
+    message: string; // User-friendly
+    details?: object; // Non-sensitive context
+  };
+};
+```
+
+### MUST: Log Errors with Context
+
+**MUST log errors with context, but NEVER log sensitive data:**
+
+```tsx
+// ✅ CORRECT: Log with context, no sensitive data
+logger.error('Failed to save user', {
+  userId: user.id,
+  operation: 'updateUser',
+  errorCode: error.code,
+});
+
+// ❌ WRONG: Logging sensitive data
+logger.error('Failed to save user', {
+  password: user.password, // NEVER
+  token: authToken,        // NEVER
+});
+```
+
+### SHOULD: Provide Recovery Paths
+
+**SHOULD provide retry logic or fallback values when appropriate:**
+
+```tsx
+// ✅ CORRECT: Retry with exponential backoff
+async function fetchWithRetry<T>(fn: () => Promise<Result<T>>, maxRetries = 3): Promise<Result<T>> {
+  for (let attempt = 0; attempt < maxRetries; attempt++) {
+    const result = await fn();
+    if (result.ok) return result;
+    if (result.error.code?.startsWith('4')) return result; // Don't retry 4xx
+    await new Promise(resolve => setTimeout(resolve, Math.pow(2, attempt) * 1000));
+  }
+  return { ok: false, error: { code: 'MAX_RETRIES', message: 'Operation failed after retries' } };
+}
+```
+
+## Performance Optimization Patterns
+
+### MUST: Optimize React Re-renders
+
+**MUST use memoization for expensive computations and stable references:**
+
+```tsx
+// ✅ CORRECT - Memoize expensive computation
+const expensiveValue = useMemo(() => computeExpensiveValue(data), [data]);
+
+// ✅ CORRECT - Stable callback reference
+const handleClick = useCallback(() => doSomething(id), [id]);
+
+// ✅ CORRECT - Memoize component
+const ExpensiveComponent = React.memo(({ data }) => <div>{/* ... */}</div>);
+```
+
+### MUST: Avoid Creating New Objects in Render
+
+**MUST NOT create new objects/arrays in render:**
+
+```tsx
+// ❌ WRONG - New object on every render
+function Component({ items }) {
+  const config = { items, enabled: true };
+  return <Child config={config} />;
+}
+
+// ✅ CORRECT - Memoize object
+function Component({ items }) {
+  const config = useMemo(() => ({ items, enabled: true }), [items]);
+  return <Child config={config} />;
+}
+```
+
+### MUST: Use Helper Functions in RLS Policies
+
+**MUST use STABLE SECURITY DEFINER helper functions (never subqueries):**
+
+```sql
+-- ✅ CORRECT - Helper function (evaluated once)
+CREATE POLICY "rbac_select_users" ON users FOR SELECT USING (
+  check_user_organisation_access(organisation_id)
+);
+
+-- ❌ WRONG - Subquery (N+1 performance issue)
+CREATE POLICY "rbac_select_users" ON users FOR SELECT USING (
+  organisation_id IN (SELECT organisation_id FROM organisation_memberships WHERE user_id = auth.uid())
+);
+```
+
+### SHOULD: Lazy Load Heavy Components
+
+**SHOULD lazy load heavy components:**
+
+```tsx
+// ✅ CORRECT - Lazy load
+import { lazy, Suspense } from 'react';
+const HeavyComponent = lazy(() => import('./HeavyComponent'));
+<Suspense fallback={<Loading />}><HeavyComponent /></Suspense>
+```
+
+### SHOULD: Configure TanStack Query Cache
+
+**SHOULD configure appropriate cache times:**
+
+```tsx
+// ✅ CORRECT - Configure cache
+const queryClient = new QueryClient({
+  defaultOptions: {
+    queries: {
+      staleTime: 5 * 60 * 1000,
+      cacheTime: 10 * 60 * 1000,
+      retry: 1,
+      refetchOnWindowFocus: false,
+    },
+  },
+});
+```
+
+## CI/CD Integration Patterns
+
+### MUST: Include Required CI Checks
+
+**MUST run these checks in every CI pipeline:**
+
+```yaml
+# ✅ CORRECT - Required checks
+jobs:
+  quality-checks:
+    steps:
+      - name: Lint
+        run: npm run lint
+      - name: Type check
+        run: npx tsc --noEmit
+      - name: Run tests
+        run: npm run test
+      - name: Build
+        run: npm run build
+```
+
+### MUST: Have Required Scripts
+
+**MUST have these scripts in package.json:**
+
+```json
+// ✅ CORRECT - Required scripts
+{
+  "scripts": {
+    "lint": "eslint .",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run",
+    "build": "vite build"
+  }
+}
+```
+
+### MUST: Use Secrets for Sensitive Data
+
+**MUST NOT commit secrets to repository:**
+
+```yaml
+# ✅ CORRECT - Use secrets
+env:
+  SUPABASE_URL: ${{ secrets.SUPABASE_URL }}
+  VITE_SUPABASE_ANON_KEY: ${{ secrets.VITE_SUPABASE_ANON_KEY }}
+
+# ❌ WRONG - Hardcoded secrets
+env:
+  SUPABASE_URL: "https://hardcoded-url.supabase.co"
+```
+
+### SHOULD: Deploy to Staging First
+
+**SHOULD deploy to staging before production:**
+
+```yaml
+# ✅ CORRECT - Staging first
+deploy-staging:
+  if: github.ref == 'refs/heads/develop'
+  environment: staging
+
+deploy-production:
+  needs: deploy-staging
+  if: github.ref == 'refs/heads/main'
+  environment: production
+```
+
+## Common Mistakes to Avoid
+
+**When writing code, NEVER:**
+1. **Use `any` for errors** - Always use type guards or Result types
+   ```tsx
+   // ❌ WRONG
+   catch (error: any) {
+     toast.error(error.message);
+   }
+   
+   // ✅ CORRECT
+   catch (error: unknown) {
+     if (isApiError(error)) {
+       toast.error(error.error.message);
+     } else {
+       toast.error('An unexpected error occurred');
+     }
+   }
+   ```
+
+2. **Expose internal details in errors** - Always use user-friendly messages
+3. **Create new objects in render** - Always memoize with useMemo
+4. **Skip memoization for expensive operations** - Always use useMemo/useCallback
+5. **Use subqueries in RLS policies** - Always use STABLE SECURITY DEFINER helper functions
+6. **Log sensitive data** - Never log passwords, tokens, or PII
+
+## Operations Checklist
+
+Before committing, verify:
+
+**Error Handling:**
+- [ ] Type-safe error handling (no `any`)
+- [ ] User-friendly error messages (no internals)
+- [ ] Errors logged with context (no sensitive data)
+- [ ] Recovery paths provided when possible
+- [ ] Consistent error shapes used
+
+**Performance:**
+- [ ] Expensive computations memoized
+- [ ] Callbacks stable with useCallback
+- [ ] Components memoized when appropriate
+- [ ] No new objects/arrays in render
+- [ ] Heavy components lazy loaded
+- [ ] RLS policies use helper functions
+- [ ] TanStack Query configured properly
+
+**CI/CD:**
+- [ ] Lint check configured
+- [ ] Type check configured
+- [ ] Tests run in CI
+- [ ] Build succeeds in CI
+- [ ] Environment variables set as secrets
+- [ ] Staging deployment configured
+- [ ] Production deployment configured
+
+## Reference
+
+**Note**: CI/CD configuration validation and performance metric thresholds are handled by CI/audit tool. See [9-operations-standards.md](../../packages/core/docs/standards/9-operations-standards.md) for complete enforcement details.
+
+- Error Handling: [9-operations-standards.md](../../packages/core/docs/standards/9-operations-standards.md#error-handling-patterns)
+- Performance: [9-operations-standards.md](../../packages/core/docs/standards/9-operations-standards.md#performance-optimization)
+- CI/CD: [9-operations-standards.md](../../packages/core/docs/standards/9-operations-standards.md#cicd-integration)

package/dist/{AuthService-Cb34EQs3.d.ts → AuthService-DmfO5rGS.d.ts}

@@ -477,6 +477,7 @@ declare class AuthService extends BaseService implements IAuthService {
     private appName;
     private errorHandler;
     private unhandledRejectionHandler;
+    private wasAuthenticatedRef;
     constructor(supabaseClient: SupabaseClient, appName?: string);
     getInstanceId(): number;
     getUser(): User | null;
@@ -499,6 +500,15 @@ declare class AuthService extends BaseService implements IAuthService {
     private startSessionRestoration;
     private finishSessionRestoration;
     private clearRestorationTimeout;
+    /**
+     * Clear pace-core persistence entries from sessionStorage
+     * This includes dialog, form, and datatable persistence
+     *
+     * @param userId - Optional user ID to clear only that user's persistence.
+     *                 If not provided, clears all pace-core persistence (for user changes).
+     * @param clearUnscoped - If true, also clears old unscoped keys (without :user: prefix)
+     */
+    private clearPersistenceOnLogin;
     private setupAuthStateListener;
     private restoreSession;
     /**

package/dist/DataTable-7PMH7XN7.js

@@ -0,0 +1,15 @@
+export { ActionButtons, BulkOperationsDropdown, ColumnFactory, ColumnVisibilityDropdown, DataTable, DataTableCore, DataTableErrorBoundary, DataTableModals, DataTableToolbar, EditableRow, EmptyState, EnhancedPaginationControls, GroupingDropdown, ImportModal, LoadingState, PaginationControls, SortIndicator, UnifiedTableBody, announce, announceBulkOperation, announceFilterChange, announceLoadingState, announcePaginationChange, announceSearchResults, announceSelectionChange, announceSortChange, average, calculateAllDepths, calculateAllIndentation, calculateIndentation, calculateOptimalPageSize, cleanupLiveRegion, count, createHierarchicalStructure, defaultDataTableFeatures, exportToCSV, exportToCSVWithTableRows, generateCSVContent, getAriaSortState, getAriaSortValue, getCellRenderer, getColumnHeaderText, getHierarchicalSortConfig, getPageSizeOptions, getPaginationBinding, getRowDepth, getRowDescription, getRowIdSafe, getSortButtonLabel, groupHierarchicalData, hasValidRowId, initializeLiveRegion, isHierarchicalSortableColumn, max, min, normalizeDataTableFeatures, shouldShowColumnForRow, sortHierarchicalDataByStructure, sortHierarchicalDataWithSorting, sum, validateHierarchicalData, validatePaginationConfig } from './chunk-Q7Q7V5NV.js';
+import './chunk-BM4CQ5P3.js';
+export { CircuitBreaker, DEFAULT_FALLBACK_CONFIG, DataChunkManager, DataTableError, DataTableErrorType, ErrorRecoveryManager, MemoryMonitor, SearchIndex, VisibilityTracker, chunkData, debounce, determinePaginationMode, getOptimalPageSizeOptions, safeExecute, throttle, useDataTablePerformance } from './chunk-S7DKJPLT.js';
+import './chunk-VBCS3DUA.js';
+import './chunk-C7NSAPTL.js';
+import './chunk-FTCRZOG2.js';
+import './chunk-ZFYPMX46.js';
+import './chunk-AHU7G2R5.js';
+import './chunk-4SXLQIZO.js';
+import './chunk-A3W6LW53.js';
+import './chunk-OJ4SKRSV.js';
+import './chunk-7ILTDCL2.js';
+import './chunk-HF6O3O37.js';
+import './chunk-TTRFSOKR.js';
+import './chunk-3RG5ZIWI.js';

package/dist/{DataTable-BMRU8a1j.d.ts → DataTable-DRUIgtUH.d.ts}

@@ -1,5 +1,5 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { d as DataRecord, D as DataTableColumn, e as DataTableRBACConfig, f as DataTableFeatureConfig, H as HierarchicalConfig, g as PerformanceConfig, S as ServerSideConfig, h as PaginationMode, C as ChunkingConfig, i as SearchIndexConfig, j as ExportOptions, G as GetRowId, E as EmptyStateConfig, c as AggregateConfig, a as DataTableAction } from './types-CkbwOr4Y.js';
+import { d as DataRecord, D as DataTableColumn, e as DataTableRBACConfig, f as DataTableFeatureConfig, H as HierarchicalConfig, g as PerformanceConfig, S as ServerSideConfig, h as PaginationMode, C as ChunkingConfig, i as SearchIndexConfig, j as ExportOptions, G as GetRowId, E as EmptyStateConfig, c as AggregateConfig, a as DataTableAction } from './types-DXstZpNI.js';
 import React__default from 'react';
 
 /**

package/dist/{PublicPageProvider-QTFVrL-Z.d.ts → PublicPageProvider-DlsCaR5v.d.ts}

@@ -1,7 +1,7 @@
 import * as React$1 from 'react';
 import React__default, { ReactNode, Component } from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { P as ParsedAddress, A as AutocompleteOptions } from './types-CkbwOr4Y.js';
+import { P as ParsedAddress, A as AutocompleteOptions } from './types-DXstZpNI.js';
 import * as LabelPrimitive from '@radix-ui/react-label';
 import { F as FileCategory, e as FileUploadResult, U as UploadProgress, c as FileUploadOptions, a as FileReference } from './file-reference-BavO2eQj.js';
 import * as CheckboxPrimitive from '@radix-ui/react-checkbox';
@@ -12,8 +12,8 @@ import * as ToastPrimitives from '@radix-ui/react-toast';
 import * as TooltipPrimitive from '@radix-ui/react-tooltip';
 import { FieldValues, DefaultValues, SubmitHandler, SubmitErrorHandler, UseFormReturn, FieldPath, ControllerRenderProps, ControllerFieldState, UseFormStateReturn } from 'react-hook-form';
 import { z } from 'zod';
+import { N as NavigationMenuProps, a as NavigationItem } from './types-t9H8qKRw.js';
 import { User, SupabaseClient, createClient } from '@supabase/supabase-js';
-import { P as Permission, A as AccessLevel } from './types-BeoeWV5I.js';
 import { O as Organisation, E as Event } from './event-CW5YB_2p.js';
 
 /**
@@ -912,10 +912,12 @@ interface DialogContentProps extends React$1.HTMLAttributes<HTMLDialogElement> {
     minHeight?: string;
     /** Minimum width in CSS units */
     minWidth?: string;
-    /** Dialog title for accessibility (sets native title attribute) */
+    /** Dialog title - sets native title attribute and aria-labelledby */
     title?: string;
-    /** Dialog description for accessibility (sets aria-description attribute) */
+    /** Dialog description - sets native aria-description attribute */
     description?: string;
+    /** Whether to persist open state across tab switches */
+    persistOpenState?: boolean;
 }
 /**
  * Props for the DialogPortal component
@@ -924,12 +926,6 @@ interface DialogContentProps extends React$1.HTMLAttributes<HTMLDialogElement> {
 interface DialogPortalProps {
     children: React$1.ReactNode;
 }
-/**
- * Props for the DialogClose component
- * @public
- */
-interface DialogCloseProps extends React$1.ButtonHTMLAttributes<HTMLButtonElement> {
-}
 /**
  * Props for the DialogHeader component (semantic header element)
  * @public
@@ -1006,6 +1002,20 @@ declare const DialogPortal: React$1.FC<DialogPortalProps>;
  * @returns JSX.Element - The semantic dialog content with overlay and optional close button
  */
 declare const DialogContent: React$1.ForwardRefExoticComponent<DialogContentProps & React$1.RefAttributes<HTMLDialogElement>>;
+/**
+ * Props for the DialogClose component
+ * @public
+ */
+interface DialogCloseProps extends React$1.ButtonHTMLAttributes<HTMLButtonElement> {
+}
+/**
+ * Props for the DialogClose component
+ * @public
+ */
+interface DialogCloseProps extends React$1.ButtonHTMLAttributes<HTMLButtonElement> {
+    /** Whether to merge props with child element instead of rendering a button */
+    asChild?: boolean;
+}
 /**
  * DialogClose component
  * Button to close the dialog
@@ -1067,10 +1077,11 @@ interface UseSelectStateProps {
 /**
  * Props for the Select root component.
  */
-interface SelectProps extends Omit<React$1.HTMLAttributes<HTMLFormElement>, "onChange" | "onKeyDown" | "onFocus" | "onBlur"> {
+interface SelectProps extends Omit<React$1.HTMLAttributes<HTMLFieldSetElement>, "onChange" | "onKeyDown" | "onFocus" | "onBlur"> {
     children: React$1.ReactNode;
     className?: string;
     direction?: SelectDirection;
+    showCheckmark?: boolean;
 }
 /**
  * Props for the SelectTrigger component.
@@ -1106,6 +1117,7 @@ interface SelectItemProps {
     disabled?: boolean;
     className?: string;
     onClick?: (e: React$1.MouseEvent) => void;
+    showCheckmark?: boolean;
 }
 
 /**
@@ -1127,10 +1139,10 @@ interface SelectItemProps {
  * Provides select dropdown functionality with search, keyboard navigation, and accessibility.
  *
  * @param props - Select configuration
- * @param ref - Forwarded ref to the form element
+ * @param ref - Forwarded ref to the fieldset element
  * @returns The rendered select component
  */
-declare const Select: React$1.ForwardRefExoticComponent<SelectProps & UseSelectStateProps & React$1.RefAttributes<HTMLFormElement>>;
+declare const Select: React$1.ForwardRefExoticComponent<SelectProps & UseSelectStateProps & React$1.RefAttributes<HTMLFieldSetElement>>;
 /**
  * Select trigger button component.
  * Opens/closes the select dropdown and displays the selected value.
@@ -1169,39 +1181,39 @@ declare const SelectContent: React$1.ForwardRefExoticComponent<SelectContentProp
 declare const SelectItem: React$1.ForwardRefExoticComponent<SelectItemProps & React$1.RefAttributes<HTMLLIElement>>;
 /**
  * Select group component.
- * Groups related select items together.
+ * Groups related select items together using a nested list structure.
  *
  * @param props - Select group configuration
- * @param ref - Forwarded ref to the div element
+ * @param ref - Forwarded ref to the ul element
  * @returns The rendered select group
  */
 declare const SelectGroup: React$1.ForwardRefExoticComponent<{
     children: React$1.ReactNode;
     className?: string;
-} & React$1.RefAttributes<HTMLDivElement>>;
+} & React$1.RefAttributes<HTMLUListElement>>;
 /**
  * Select label component.
  * Provides a label for a group of select items.
  *
  * @param props - Select label configuration
- * @param ref - Forwarded ref to the div element
+ * @param ref - Forwarded ref to the li element
  * @returns The rendered select label
  */
 declare const SelectLabel: React$1.ForwardRefExoticComponent<{
     children: React$1.ReactNode;
     className?: string;
-} & React$1.RefAttributes<HTMLDivElement>>;
+} & React$1.RefAttributes<HTMLLIElement>>;
 /**
  * Select separator component.
  * Provides visual separation between groups of select items.
  *
  * @param props - Select separator configuration
- * @param ref - Forwarded ref to the div element
+ * @param ref - Forwarded ref to the hr element
  * @returns The rendered select separator
  */
 declare const SelectSeparator: React$1.ForwardRefExoticComponent<{
     className?: string;
-} & React$1.RefAttributes<HTMLDivElement>>;
+} & React$1.RefAttributes<HTMLHRElement>>;
 
 /**
  * @file Tabs Component System
@@ -2041,57 +2053,6 @@ interface LoginFormProps {
  */
 declare const LoginForm: React__default.NamedExoticComponent<LoginFormProps>;
 
-/**
- * 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$1.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;
-}
-
 /**
  * @file Unified Navigation Menu Component
  * @package @jmruthers/pace-core
@@ -4177,4 +4138,4 @@ declare function usePublicPageContext(): PublicPageContextType;
  */
 declare function useIsPublicPage(): boolean;
 
-export { type DialogContentProps as $, AddressField as A, Button as B, Card as C, TableHeader as D, TableBody as E, TableCaption as F, TableCell as G, TableFooter as H, Input as I, TableHead as J, TableRow as K, Label as L, Dialog as M, DialogPortal as N, DialogTrigger as O, Progress as P, DialogClose as Q, DialogContent as R, Switch as S, Textarea as T, DialogHeader as U, DialogBody as V, DialogFooter as W, DialogTitle as X, DialogDescription as Y, type DialogProps as Z, type DialogTriggerProps as _, type ButtonProps as a, SessionRestorationLoader as a$, type DialogPortalProps as a0, type DialogCloseProps as a1, type DialogHeaderProps as a2, type DialogFooterProps as a3, type DialogBodyProps as a4, type DialogSize as a5, Select as a6, SelectGroup as a7, SelectValue as a8, SelectTrigger as a9, TooltipContent as aA, TooltipProvider as aB, TooltipRoot as aC, Form as aD, FormField as aE, type FormProps as aF, type FormFieldProps as aG, LoginForm as aH, type LoginFormProps as aI, Header as aJ, Footer as aK, type FooterProps as aL, ProtectedRoute as aM, type ProtectedRouteProps as aN, NavigationMenu as aO, type NavigationMenuProps as aP, type NavigationItem as aQ, ContextSelector as aR, type ContextSelectorProps as aS, UserMenu as aT, ErrorBoundary as aU, ErrorBoundaryProvider as aV, type ErrorBoundaryProps as aW, type ErrorBoundaryState as aX, type ErrorBoundaryProviderProps as aY, type GlobalErrorHandler as aZ, LoadingSpinner as a_, SelectContent as aa, SelectLabel as ab, SelectItem as ac, SelectSeparator as ad, Tabs as ae, TabsList as af, TabsTrigger as ag, TabsContent as ah, type TabsProps as ai, type TabsListProps as aj, type TabsTriggerProps as ak, type TabsContentProps as al, Calendar as am, type CalendarProps as an, Toast as ao, Toaster as ap, ToastAction as aq, ToastProvider as ar, ToastViewport as as, ToastTitle as at, ToastDescription as au, ToastClose as av, type ToastActionElement as aw, type ToastProps as ax, Tooltip as ay, TooltipTrigger as az, CardHeader as b, type SessionRestorationLoaderProps as b0, FileUpload as b1, type FileUploadProps as b2, FileDisplay as b3, type FileDisplayProps as b4, useFileReference as b5, useFileReferenceForRecord as b6, useFileReferenceById as b7, useFilesByCategory as b8, type UseFileReferenceOptions as b9, type UseFileReferenceReturn as ba, type UseFileReferenceForRecordReturn as bb, PublicPageLayout as bc, PublicPageHeader as bd, PublicPageFooter as be, PublicPageProvider as bf, usePublicPageContext as bg, useIsPublicPage as bh, type PublicPageLayoutProps as bi, type PublicPageHeaderProps as bj, type PublicPageFooterProps as bk, type PaceAppLayoutProps as bl, PaceAppLayout as bm, type PaceLoginPageProps as bn, PaceLoginPage as bo, type NavigationMode as bp, type UserMenuProps as bq, PasswordChangeForm as br, CardFooter as c, CardTitle as d, CardDescription as e, CardContent as f, CardActions as g, type CardProps as h, type CardActionsProps as i, type InputProps as j, type AddressFieldProps as k, type AddressFieldRef as l, type LabelProps as m, type TextareaProps as n, Alert as o, AlertTitle as p, AlertDescription as q, Avatar as r, type AvatarProps as s, Badge as t, type BadgeProps as u, type BadgeVariant as v, Checkbox as w, type SwitchProps as x, type ProgressProps as y, Table as z };
+export { type DialogContentProps as $, AddressField as A, Button as B, Card as C, TableHeader as D, TableBody as E, TableCaption as F, TableCell as G, TableFooter as H, Input as I, TableHead as J, TableRow as K, Label as L, Dialog as M, DialogPortal as N, DialogTrigger as O, Progress as P, DialogClose as Q, DialogContent as R, Switch as S, Textarea as T, DialogHeader as U, DialogBody as V, DialogFooter as W, DialogTitle as X, DialogDescription as Y, type DialogProps as Z, type DialogTriggerProps as _, type ButtonProps as a, FileUpload as a$, type DialogPortalProps as a0, type DialogCloseProps as a1, type DialogHeaderProps as a2, type DialogFooterProps as a3, type DialogBodyProps as a4, type DialogSize as a5, Select as a6, SelectGroup as a7, SelectValue as a8, SelectTrigger as a9, TooltipContent as aA, TooltipProvider as aB, TooltipRoot as aC, Form as aD, FormField as aE, type FormProps as aF, type FormFieldProps as aG, LoginForm as aH, type LoginFormProps as aI, Header as aJ, Footer as aK, type FooterProps as aL, ProtectedRoute as aM, type ProtectedRouteProps as aN, NavigationMenu as aO, ContextSelector as aP, type ContextSelectorProps as aQ, UserMenu as aR, ErrorBoundary as aS, ErrorBoundaryProvider as aT, type ErrorBoundaryProps as aU, type ErrorBoundaryState as aV, type ErrorBoundaryProviderProps as aW, type GlobalErrorHandler as aX, LoadingSpinner as aY, SessionRestorationLoader as aZ, type SessionRestorationLoaderProps as a_, SelectContent as aa, SelectLabel as ab, SelectItem as ac, SelectSeparator as ad, Tabs as ae, TabsList as af, TabsTrigger as ag, TabsContent as ah, type TabsProps as ai, type TabsListProps as aj, type TabsTriggerProps as ak, type TabsContentProps as al, Calendar as am, type CalendarProps as an, Toast as ao, Toaster as ap, ToastAction as aq, ToastProvider as ar, ToastViewport as as, ToastTitle as at, ToastDescription as au, ToastClose as av, type ToastActionElement as aw, type ToastProps as ax, Tooltip as ay, TooltipTrigger as az, CardHeader as b, type FileUploadProps as b0, FileDisplay as b1, type FileDisplayProps as b2, useFileReference as b3, useFileReferenceForRecord as b4, useFileReferenceById as b5, useFilesByCategory as b6, type UseFileReferenceOptions as b7, type UseFileReferenceReturn as b8, type UseFileReferenceForRecordReturn as b9, PublicPageLayout as ba, PublicPageHeader as bb, PublicPageFooter as bc, PublicPageProvider as bd, usePublicPageContext as be, useIsPublicPage as bf, type PublicPageLayoutProps as bg, type PublicPageHeaderProps as bh, type PublicPageFooterProps as bi, type PaceAppLayoutProps as bj, PaceAppLayout as bk, type PaceLoginPageProps as bl, PaceLoginPage as bm, type UserMenuProps as bn, PasswordChangeForm as bo, CardFooter as c, CardTitle as d, CardDescription as e, CardContent as f, CardActions as g, type CardProps as h, type CardActionsProps as i, type InputProps as j, type AddressFieldProps as k, type AddressFieldRef as l, type LabelProps as m, type TextareaProps as n, Alert as o, AlertTitle as p, AlertDescription as q, Avatar as r, type AvatarProps as s, Badge as t, type BadgeProps as u, type BadgeVariant as v, Checkbox as w, type SwitchProps as x, type ProgressProps as y, Table as z };

package/dist/UnifiedAuthProvider-ZT6TIGM7.js

@@ -0,0 +1,7 @@
+export { UnifiedAuthContext, UnifiedAuthProvider, useUnifiedAuth } from './chunk-FTCRZOG2.js';
+import './chunk-ZFYPMX46.js';
+import './chunk-AHU7G2R5.js';
+import './chunk-4SXLQIZO.js';
+import './chunk-HF6O3O37.js';
+import './chunk-TTRFSOKR.js';
+import './chunk-3RG5ZIWI.js';

package/dist/api-Y4MQWOFW.js

@@ -0,0 +1,4 @@
+export { OrganisationContextRequiredError, clearCache, getAccessLevel, getPageScopeType, getPermissionMap, getRoleContext, hasAllPermissions, hasAnyPermission, invalidateAppCache, invalidateEventCache, invalidateOrganisationCache, invalidateUserCache, isEventAdmin, isOrganisationAdmin, isPermitted, isPermittedCached, isRBACInitialized, isSuperAdmin, resolveAppContext, setupRBAC } from './chunk-ZFYPMX46.js';
+import './chunk-AHU7G2R5.js';
+import './chunk-TTRFSOKR.js';
+import './chunk-3RG5ZIWI.js';

package/dist/audit-MYQXYZFU.js

@@ -0,0 +1,3 @@
+export { RBACAuditManager, createAuditManager, emitAuditEvent, getGlobalAuditManager, setGlobalAuditManager } from './chunk-AHU7G2R5.js';
+import './chunk-TTRFSOKR.js';
+import './chunk-3RG5ZIWI.js';

package/dist/{chunk-DGUM43GV.js → chunk-3RG5ZIWI.js}

@@ -5,7 +5,4 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
   throw Error('Dynamic require of "' + x + '" is not supported');
 });
 
-export {
-  __require
-};
-//# sourceMappingURL=chunk-DGUM43GV.js.map
+export { __require };