@elevasis/ui 1.3.0 → 1.3.1

package/dist/index.d.ts

@@ -182,10 +182,10 @@ interface ElevasisThemeConfig extends ElevasisCoreThemeConfig {
 }
 /**
  * Auth configuration union.
- * 'authkit' (WorkOS AuthKit) and 'oauth' (WorkOS Connect) are implemented.
+ * 'authkit' (WorkOS AuthKit) is the supported mode.
  * 'apiKey' is defined for forward type compatibility but will throw at runtime.
  */
-type AuthConfig = AuthKitConfig | OAuthConfig | ApiKeyConfig;
+type AuthConfig = AuthKitConfig | ApiKeyConfig;
 interface AuthKitConfig {
     mode: 'authkit';
     clientId: string;
@@ -196,25 +196,13 @@ interface AuthKitConfig {
     /** Keep refresh tokens in localStorage. Defaults to false. */
     devMode?: boolean;
 }
-/** OAuth config for "Sign in with Elevasis" via WorkOS Connect. */
-interface OAuthConfig {
-    mode: 'oauth';
-    clientId: string;
-    redirectUri: string;
-    /** Persist tokens in sessionStorage. Default is memory-only. */
-    tokenStorage?: 'session';
-    /** Pre-select organization in WorkOS flow. */
-    organizationId?: string;
-    /** Auth provider for the authorize request. Defaults to 'authkit' (hosted login UI). */
-    provider?: 'authkit' | 'GoogleOAuth' | 'MicrosoftOAuth' | 'GitHubOAuth' | 'AppleOAuth';
-}
 /** Deferred -- will throw at runtime. */
 interface ApiKeyConfig {
     mode: 'apiKey';
     key: string;
 }
 interface ElevasisCoreProviderProps {
-    /** Auth configuration. Supports 'authkit' and 'oauth' modes. */
+    /** Auth configuration. Supports 'authkit' mode. */
     auth: AuthConfig;
     /**
      * Elevasis core theme configuration (Mantine-free).
@@ -266,7 +254,7 @@ interface ElevasisCoreProviderProps {
     children: ReactNode;
 }
 interface ElevasisProviderProps {
-    /** Auth configuration. Supports 'authkit' and 'oauth' modes. */
+    /** Auth configuration. Supports 'authkit' mode. */
     auth: AuthConfig;
     /**
      * Elevasis theme configuration.
@@ -3753,6 +3741,34 @@ interface OrgFeatureConfig {
  * Overrides org-level feature config for specific users
  */
 type MembershipFeatureConfig = OrgFeatureConfig;
+/**
+ * User-global config (stored in users.config)
+ * Training and theme are user-specific, NOT org-specific
+ */
+interface UserConfig {
+    training?: {
+        enabled?: boolean;
+        allowed_courses?: string[];
+        allowed_course_groups?: CourseGroup[];
+    };
+    theme?: {
+        preset?: 'default' | 'tactical' | 'regal' | 'cyber-volt' | 'aurora' | 'rose-gold' | 'midnight' | 'ember' | 'obsidian' | 'honey' | 'abyss' | 'canopy' | 'slate' | 'cyber-strike' | 'cyber-flux' | 'cyber-void';
+        colorScheme?: 'light' | 'dark' | 'auto';
+    };
+    onboarding?: {
+        completed?: boolean;
+        completedAt?: string;
+        role?: string;
+        primaryUseCase?: string[];
+        experienceLevel?: string;
+        /** Onboarding guide system state (set by checklist/tour system) */
+        guides?: {
+            completedIds?: string[];
+            dismissed?: boolean;
+            completedAt?: string;
+        };
+    };
+}
 
 /**
  * Organization Membership types based on WorkOS API
@@ -6628,6 +6644,43 @@ declare function useMarkAllAsRead(): _tanstack_react_query.UseMutationResult<voi
  */
 declare function useNotificationCount(): _tanstack_react_query.UseQueryResult<number, Error>;
 
+/**
+ * Hook that provides a standardized error notification handler
+ * for use in React Query mutation hooks.
+ *
+ * Delegates to the active NotificationAdapter so it works in any
+ * consumer (Mantine, Sonner, console fallback, etc.)
+ *
+ * @example
+ * ```typescript
+ * const mutation = useMutation({
+ *   mutationFn: deleteApiKey,
+ *   onError: useErrorNotification()
+ * })
+ * ```
+ */
+declare function useErrorNotification(): (error: unknown) => void;
+
+/**
+ * Hook that provides a standardized success notification handler.
+ * Delegates to the active NotificationAdapter.
+ */
+declare function useSuccessNotification(): (title: string, message: string) => void;
+
+/**
+ * Hook that provides a standardized warning notification handler.
+ * Delegates to the active NotificationAdapter.
+ */
+declare function useWarningNotification(): (title: string, message: string) => void;
+
+/**
+ * Generic batch delete hook. Deletes multiple rows from a Supabase table by ID.
+ *
+ * @param tableName - Supabase table name (e.g. 'acq_social_posts')
+ * @param invalidateQueryKeys - Array of query key prefixes to invalidate on success
+ */
+declare function useBatchDelete(tableName: string, invalidateQueryKeys: readonly (readonly unknown[])[]): _tanstack_react_query.UseMutationResult<void, Error, string[], unknown>;
+
 /**
  * Query key factories for observability hooks.
  * Scoped by organizationId for cache isolation between tenants.
@@ -7014,91 +7067,76 @@ declare class OperationsService {
     archiveSession(sessionId: string): Promise<void>;
 }
 
-interface AuthAdapter {
-    user: {
-        id: string;
-    } | null;
-    isLoading: boolean;
-    getAccessToken: () => Promise<string>;
-    organizationId?: string | null;
-}
-declare function useAuthContext(): AuthAdapter;
-declare function AuthProvider({ value, children }: {
-    value: AuthAdapter;
-    children: ReactNode;
-}): react.FunctionComponentElement<react.ProviderProps<AuthAdapter | null>>;
-
 /**
- * Bridge component that reads WorkOS AuthKit state and provides it
- * via the generic AuthContext. Place inside AuthKitProvider.
+ * Shared hook for pagination state management.
+ * Encapsulates page state, offset calculation, and reset-on-filter-change.
  *
- * Narrows WorkOS User to { id: string } -- @repo/ui hooks only need the ID.
- * Uses useMemo to stabilize the user object and prevent unnecessary
- * useEffect re-runs in downstream hooks.
+ * @param pageSize - Number of items per page
+ * @param resetDeps - When any dependency changes, page resets to 1. Omit to disable auto-reset.
+ * @param total - When provided, automatically retreats to the last valid page if the current page becomes empty (e.g., after bulk deletion).
  */
-declare function WorkOSAuthBridge({ children }: {
-    children: ReactNode;
-}): react_jsx_runtime.JSX.Element;
-
-interface OAuthContextValue {
-    user: {
-        id: string;
-    } | null;
-    isLoading: boolean;
-    organizationId: string | null;
-    getAccessToken: () => Promise<string>;
-    error: string | null;
-    initiateOAuthFlow: () => void;
-}
-declare function useOAuthContext(): OAuthContextValue;
+declare function usePaginationState(pageSize: number, resetDeps?: unknown[], total?: number): {
+    page: number;
+    setPage: react.Dispatch<react.SetStateAction<number>>;
+    offset: number;
+    totalPages: (total: number) => number;
+};
 
 /**
- * Returns a stable reference to getAccessToken that won't change between renders
+ * Generic table row selection hook.
+ * Tracks selected IDs, provides toggle/toggleAll/clear, and computes selection state.
  *
- * This prevents SSE connections from reconnecting unnecessarily when the
- * WorkOS useAuth hook returns a new getAccessToken function reference
- *
- * @example
- * ```tsx
- * const getAccessToken = useStableAccessToken()
- *
- * useEffect(() => {
- *   fetchEventSourceWithTokenRefresh({
- *     getToken: getAccessToken,
- *     // ...
- *   })
- * }, [getAccessToken]) // Won't re-run on every render
- * ```
+ * @param items - Current page items (must have `id: string`)
+ * @param allItems - All items across all pages (for "select all" to work across pages). Defaults to `items`.
  */
-declare function useStableAccessToken(): () => Promise<string>;
+declare function useTableSelection<T extends {
+    id: string;
+}>(items: T[], allItems?: T[]): {
+    selectedIds: Set<string>;
+    toggle: (id: string) => void;
+    togglePage: () => void;
+    clear: () => void;
+    isPageAllSelected: boolean;
+    isPagePartiallySelected: boolean;
+    selectedCount: number;
+    isSelected: (id: string) => boolean;
+};
 
+type SortDirection = 'asc' | 'desc';
+interface SortState {
+    column: string;
+    direction: SortDirection;
+}
 /**
- * Checks WorkOS session validity when window/tab regains focus
- *
- * When window or tab becomes visible after inactivity, validates session
- * by attempting to get access token. If session expired (WorkOS inactivity
- * timeout exceeded), signs out user and redirects to login.
- *
- * How it works:
- * 1. Window/tab regains focus after inactivity
- * 2. Cancel all pending queries to prevent 401 error cascade
- * 3. Attempt to get access token from WorkOS
- * 4. If successful: Resume queries with fresh token
- * 5. If failed (session expired): Sign out and redirect to login
+ * Generic table sorting hook.
+ * Manages sort column + direction, and provides a sort utility for client-side data.
+ */
+declare function useTableSort(defaultColumn: string, defaultDirection?: SortDirection): {
+    sort: SortState;
+    toggleSort: (column: string) => void;
+};
+/**
+ * Sort an array of items by a column using accessor functions.
  *
- * @example
- * // In __root.tsx
- * export function RootLayoutComponent() {
- *   useSessionCheck()
- *   return <YourApp />
- * }
+ * @param data - Array to sort (not mutated)
+ * @param sort - Current sort state
+ * @param accessors - Map of column name → accessor function
  */
-declare function useSessionCheck(): void;
+declare function sortData<T>(data: T[], sort: SortState, accessors: Record<string, (item: T) => string | number | boolean | null | undefined>): T[];
+/**
+ * Hook that combines useTableSort with memoized sortData.
+ * Returns the sort state, toggle function, and a memoized sort function.
+ */
+declare function useSortedData<T>(data: T[], defaultColumn: string, accessors: Record<string, (item: T) => string | number | boolean | null | undefined>, defaultDirection?: SortDirection): {
+    sorted: T[];
+    sort: SortState;
+    toggleSort: (column: string) => void;
+};
 
 /**
  * Type for the useOrganizations hook return value
  */
-interface UseOrganizationsReturn$1 {
+interface UseOrganizationsReturn {
     currentWorkOSOrganizationId: string | null;
     currentMembership: MembershipWithDetails | null;
     setCurrentWorkOSOrganizationId: (id: string | null) => void;
@@ -7148,7 +7186,7 @@ interface UseOrgInitializationReturn {
  * This pattern allows the shared package to provide the hook logic
  * while each app provides its own hook instances.
  */
-declare function createUseOrgInitialization(useOrganizations: () => UseOrganizationsReturn$1, useApiClient: () => UseApiClientReturn): () => UseOrgInitializationReturn;
+declare function createUseOrgInitialization(useOrganizations: () => UseOrganizationsReturn, useApiClient: () => UseApiClientReturn): () => UseOrgInitializationReturn;
 
 interface InitializationError {
     layer: 'auth' | 'profile' | 'organization';
@@ -7180,10 +7218,292 @@ interface AppInitializationState {
  */
 declare function createUseAppInitialization(useOrgInitialization: () => UseOrgInitializationReturn): () => AppInitializationState;
 
+/**
+ * The value exposed by OrganizationProvider to all consumers.
+ */
+interface OrganizationContextValue {
+    /** WorkOS organization ID of the currently selected organization. */
+    currentWorkOSOrganizationId: string | null;
+    /** Supabase (UUID) organization ID of the currently selected organization. */
+    currentSupabaseOrganizationId: string | null;
+    /** Full membership record for the currently selected organization. */
+    currentMembership: MembershipWithDetails | null;
+    /** All memberships for the authenticated user. */
+    memberships: MembershipWithDetails[];
+    /** True while the initial membership list is being fetched. */
+    isInitializing: boolean;
+    /** True while a subsequent org switch / refresh is in flight. */
+    isOrgRefreshing: boolean;
+    /** Error message if the membership fetch or org switch failed. */
+    error: string | null;
+    /**
+     * Switch the active organization.
+     *
+     * Persists the selection to `last_visited_org` on the user profile and
+     * invalidates all org-scoped TanStack Query cache entries.
+     *
+     * @param workosOrgId - WorkOS organization ID to switch to.
+     */
+    switchOrganization: (workosOrgId: string) => void;
+    /**
+     * Re-fetch memberships and retry org selection after an error.
+     */
+    retry: () => Promise<void>;
+}
+/**
+ * Consumes the nearest OrganizationProvider.
+ *
+ * @throws {Error} If called outside of an OrganizationProvider tree.
+ */
+declare function useOrganization(): OrganizationContextValue;
+
+type RestrictionSource = 'org' | 'membership' | null;
+interface FeatureAccessResult {
+    allowed: boolean;
+    restrictedBy: RestrictionSource;
+}
+/**
+ * Factory that creates a `useFeatureAccess` hook scoped to the consumer's
+ * feature configuration.
+ *
+ * @param useInitialization - Initialization hook providing `profile` and `organizationReady`
+ * @param useOrganization   - Organization hook providing `currentMembership`
+ * @param optInFeatures     - Feature keys that are disabled by default (must be explicitly enabled)
+ * @param getCoursesByGroup - Resolver that maps a course group name to its course slugs
+ *
+ * @example
+ * ```typescript
+ * // In your app's feature-access module
+ * import { createUseFeatureAccess } from '@repo/ui/hooks'
+ * import { useInitialization } from '@repo/ui/initialization'
+ * import { useOrganization } from '@repo/ui/organization'
+ * import { getCoursesByGroup } from './training/registry'
+ *
+ * export const useFeatureAccess = createUseFeatureAccess({
+ *   useInitialization,
+ *   useOrganization,
+ *   optInFeatures: ['acquisition', 'calibration'],
+ *   getCoursesByGroup,
+ * })
+ * ```
+ */
+declare function createUseFeatureAccess({ useInitialization, useOrganization, optInFeatures, getCoursesByGroup }: {
+    useInitialization: () => Pick<AppInitializationState, 'profile' | 'organizationReady'>;
+    useOrganization: () => Pick<OrganizationContextValue, 'currentMembership'>;
+    optInFeatures?: string[];
+    getCoursesByGroup?: (group: CourseGroup) => string[];
+}): () => {
+    orgConfig: OrgFeatureConfig | undefined;
+    membershipConfig: OrgFeatureConfig | undefined;
+    userConfig: UserConfig | undefined;
+    hasFeature: (featureKey: string) => boolean;
+    checkFeature: (featureKey: string) => FeatureAccessResult;
+    hasTrainingAccess: () => boolean;
+    getAllowedCourses: () => string[] | null;
+    getResolvedCourseAccess: () => string[] | null;
+    hasAccessToCourse: (courseSlug: string) => boolean;
+    getEnabledGroups: () => CourseGroup[];
+    isReady: boolean;
+};
+
+interface EventSourceMessage {
+    id: string;
+    event: string;
+    data: string;
+    retry?: number;
+}
+
+interface FetchEventSourceWithTokenRefreshOptions {
+    url: string;
+    getToken: () => Promise<string | undefined>;
+    headers?: Record<string, string>;
+    signal: AbortSignal;
+    /** Delay in ms before reconnecting after token refresh. Defaults to 2000. */
+    tokenRefreshDelayMs?: number;
+    onopen?: (response: Response) => void | Promise<void>;
+    onmessage?: (event: EventSourceMessage) => void;
+    onerror?: (error: unknown) => void;
+    onclose?: () => void;
+}
+
+interface SSEConnectionManagerOptions {
+    /** Grace period in ms before closing idle connections. Defaults to 5000. */
+    closeGracePeriodMs?: number;
+}
+/**
+ * SSE Connection Manager
+ *
+ * Ensures only ONE SSE connection exists per endpoint, preventing duplicate
+ * connections when components re-render or remount.
+ *
+ * Benefits:
+ * - Prevents resource waste from duplicate connections
+ * - Eliminates race conditions from overlapping connections
+ * - Automatically manages connection lifecycle
+ * - Shares single connection across multiple subscribers
+ */
+declare class SSEConnectionManager {
+    private connections;
+    private closeGracePeriodMs;
+    constructor(options?: SSEConnectionManagerOptions);
+    /**
+     * Subscribe to an SSE endpoint
+     *
+     * If a connection already exists for this endpoint, reuses it.
+     * Otherwise, creates a new connection.
+     *
+     * @param key - Unique identifier for the connection (e.g., 'notifications', 'resource-executive-agent')
+     * @param subscriberId - Unique identifier for this subscriber (usually component instance)
+     * @param options - SSE connection options
+     * @returns Unsubscribe function to call when component unmounts
+     */
+    subscribe(key: string, subscriberId: string, options: Omit<FetchEventSourceWithTokenRefreshOptions, 'signal'>): () => void;
+    /**
+     * Unsubscribe from an SSE endpoint
+     *
+     * If this is the last subscriber, closes the connection after grace period.
+     */
+    private unsubscribe;
+    /**
+     * Force close a connection and all its subscribers
+     */
+    closeConnection(key: string): void;
+    /**
+     * Get current connection status
+     */
+    getConnectionInfo(): Map<string, {
+        url: string;
+        subscribers: number;
+    }>;
+}
+
+interface UseSSEConnectionOptions {
+    manager: SSEConnectionManager;
+    /** Shared connection key — all subscribers with the same key share ONE connection. */
+    connectionKey: string;
+    url: string;
+    /** When false the subscription is skipped. Defaults to true. */
+    enabled?: boolean;
+    headers?: Record<string, string>;
+    /** Called for each non-empty SSE message with the raw `event.data` string. */
+    onmessage: (data: string) => void;
+    /**
+     * Called when the connection opens. Return a non-empty string to set it as
+     * the error state (e.g. `response.status === 403 ? 'Access denied' : undefined`).
+     */
+    onopen?: (response: Response) => string | void;
+    onerror?: (err: Error) => void;
+    onclose?: () => void;
+}
+/**
+ * Generic SSE subscription hook.
+ *
+ * Handles token refresh, connection state, subscriber ID generation, and
+ * subscribe/cleanup lifecycle via the shared SSEConnectionManager.
+ *
+ * Domain-specific event parsing (e.g. `ExecutionSSEEvent`) stays in the
+ * caller's `onmessage` handler.
+ *
+ * @example
+ * ```typescript
+ * const { connected, error } = useSSEConnection({
+ *   manager: sseConnectionManager,
+ *   connectionKey: `resource-${resourceId}`,
+ *   url: `${API_URL}/api/execution-engine/sse/${resourceId}`,
+ *   enabled: isOrganizationReady,
+ *   headers: { [HTTP_HEADERS.WORKOS_ORGANIZATION_ID]: orgId },
+ *   onmessage: (data) => {
+ *     const event = JSON.parse(data)
+ *     // handle domain-specific event
+ *   },
+ * })
+ * ```
+ */
+declare function useSSEConnection({ manager, connectionKey, url, enabled, headers, onmessage, onopen, onerror, onclose }: UseSSEConnectionOptions): {
+    connected: boolean;
+    error: string | null;
+};
+
+interface AuthContextValue {
+    user: {
+        id: string;
+    } | null;
+    isLoading: boolean;
+    getAccessToken: () => Promise<string>;
+    organizationId?: string | null;
+    /**
+     * Trigger WorkOS AuthKit's sign-in flow (redirect to WorkOS hosted auth page).
+     * Used by ProtectedRoute for auto-recovery when `canRecover()` returns true.
+     */
+    signIn: (options?: {
+        state?: {
+            returnTo?: string;
+        };
+    }) => void;
+    /**
+     * Returns true when a previous session can be recovered (refresh token
+     * exists in storage). ProtectedRoute calls `signIn()` only when this returns
+     * true; otherwise it navigates to the login page.
+     *
+     * Explicit logout clears the stored token, so canRecover() returns false
+     * and the user sees the login page as expected.
+     */
+    canRecover: () => boolean;
+}
+declare function useAuthContext(): AuthContextValue;
+declare function AuthProvider({ value, children }: {
+    value: AuthContextValue;
+    children: ReactNode;
+}): react.FunctionComponentElement<react.ProviderProps<AuthContextValue | null>>;
+
+/**
+ * Returns a stable reference to getAccessToken that won't change between renders
+ *
+ * This prevents SSE connections from reconnecting unnecessarily when the
+ * WorkOS useAuth hook returns a new getAccessToken function reference
+ *
+ * @example
+ * ```tsx
+ * const getAccessToken = useStableAccessToken()
+ *
+ * useEffect(() => {
+ *   fetchEventSourceWithTokenRefresh({
+ *     getToken: getAccessToken,
+ *     // ...
+ *   })
+ * }, [getAccessToken]) // Won't re-run on every render
+ * ```
+ */
+declare function useStableAccessToken(): () => Promise<string>;
+
+/**
+ * Checks WorkOS session validity when window/tab regains focus
+ *
+ * When window or tab becomes visible after inactivity, validates session
+ * by attempting to get access token. If session expired (WorkOS inactivity
+ * timeout exceeded), signs out user and redirects to login.
+ *
+ * How it works:
+ * 1. Window/tab regains focus after inactivity
+ * 2. Cancel all pending queries to prevent 401 error cascade
+ * 3. Attempt to get access token from WorkOS
+ * 4. If successful: Resume queries with fresh token
+ * 5. If failed (session expired): Sign out and redirect to login
+ *
+ * @example
+ * // In __root.tsx
+ * export function RootLayoutComponent() {
+ *   useSessionCheck()
+ *   return <YourApp />
+ * }
+ */
+declare function useSessionCheck(): void;
+
 interface ProtectedRouteProps {
     children: ReactNode;
     /**
-     * Path to redirect to when user is unauthenticated.
+     * Path to redirect to when user is unauthenticated and the auth adapter
+     * does not provide a `signIn` function.
      * @default '/login'
      */
     redirectTo?: string;
@@ -7209,10 +7529,18 @@ interface ProtectedRouteProps {
  * Headless route guard for authenticated pages.
  *
  * Reads initialization state from the nearest InitializationProvider.
- * Redirects unauthenticated users to `redirectTo` (default: '/login')
- * with a `returnTo` search param preserving the current location.
  *
- * Organization-layer errors are allowed through — routes like /invitations
+ * When `canRecover()` returns true (refresh token exists), unauthenticated users
+ * are sent directly to WorkOS AuthKit via `signIn()`. WorkOS checks its
+ * server-side session and either signs the user in immediately (page-reload case)
+ * or shows a login form (logged-out case). Explicit logout destroys the
+ * server-side session, so the next auto-signIn correctly presents a login form
+ * rather than looping.
+ *
+ * When `canRecover()` returns false, falls back to navigating to `redirectTo`
+ * (default: '/login') with a `returnTo` search param.
+ *
+ * Organization-layer errors are allowed through -- routes like /invitations
  * must be accessible even when the user has no org membership.
  *
  * @example
@@ -7342,45 +7670,6 @@ declare class UserProfileService {
     }>): Promise<SupabaseUserProfile | null>;
 }
 
-/**
- * The value exposed by OrganizationProvider to all consumers.
- */
-interface OrganizationContextValue {
-    /** WorkOS organization ID of the currently selected organization. */
-    currentWorkOSOrganizationId: string | null;
-    /** Supabase (UUID) organization ID of the currently selected organization. */
-    currentSupabaseOrganizationId: string | null;
-    /** Full membership record for the currently selected organization. */
-    currentMembership: MembershipWithDetails | null;
-    /** All memberships for the authenticated user. */
-    memberships: MembershipWithDetails[];
-    /** True while the initial membership list is being fetched. */
-    isInitializing: boolean;
-    /** True while a subsequent org switch / refresh is in flight. */
-    isOrgRefreshing: boolean;
-    /** Error message if the membership fetch or org switch failed. */
-    error: string | null;
-    /**
-     * Switch the active organization.
-     *
-     * Persists the selection to `last_visited_org` on the user profile and
-     * invalidates all org-scoped TanStack Query cache entries.
-     *
-     * @param workosOrgId - WorkOS organization ID to switch to.
-     */
-    switchOrganization: (workosOrgId: string) => void;
-    /**
-     * Re-fetch memberships and retry org selection after an error.
-     */
-    retry: () => Promise<void>;
-}
-/**
- * Consumes the nearest OrganizationProvider.
- *
- * @throws {Error} If called outside of an OrganizationProvider tree.
- */
-declare function useOrganization(): OrganizationContextValue;
-
 /**
  * Provides organization state to its subtree via React Context.
  *
@@ -7522,18 +7811,17 @@ declare function useApiClientContext(): ApiClientContextValue;
  */
 declare function ApiClientProvider({ children, getAccessToken, organizationId, getOrganizationId: getOrganizationIdProp, isOrganizationReady, onError }: ApiClientProviderProps): react_jsx_runtime.JSX.Element;
 
-/**
- * Return type of useOrganizations hook (subset needed by the factory)
- */
-interface UseOrganizationsReturn {
-    isInitializing: boolean;
-    isOrgRefreshing: boolean;
-}
 /**
  * Hook that returns apiRequest and deferredApiRequest bound to the current
  * ApiClientContext. apiUrl is the only parameter because org ID is resolved
  * at call time via getOrganizationId() from context.
  *
+ * When OrganizationProvider is present in the tree, isOrganizationReady and
+ * isInitializing reflect the live org state (currentWorkOSOrganizationId,
+ * isInitializing, isOrgRefreshing). When OrganizationProvider is absent
+ * (e.g. theme-only mode, testing), the hook falls back to the values from
+ * ApiClientContext.
+ *
  * Usage:
  * ```typescript
  * import { useApiClient } from '@repo/ui/api'
@@ -7551,29 +7839,6 @@ declare function useApiClient(apiUrl: string): {
     isOrganizationReady: boolean;
     isInitializing: boolean;
 };
-/**
- * Factory function to create a useApiClient hook for your app.
- *
- * @deprecated Use the plain `useApiClient(apiUrl)` hook instead.
- * The factory pattern is no longer needed because org ID is resolved at
- * call time via getOrganizationId() from ApiClientContext.
- *
- * Migration:
- * ```typescript
- * // Before
- * export const useApiClient = createUseApiClient(useOrganizations, API_URL)
- *
- * // After
- * import { useApiClient } from '@repo/ui/api'
- * // call useApiClient(API_URL) directly in your hook/component
- * ```
- */
-declare function createUseApiClient(useOrganizations: () => UseOrganizationsReturn, apiUrl: string): () => {
-    apiRequest: <T>(endpoint: string, options?: RequestInit) => Promise<T>;
-    deferredApiRequest: <T>(endpoint: string, options?: RequestInit) => Promise<T>;
-    isOrganizationReady: boolean;
-    isInitializing: boolean;
-};
 
 declare const InitializationContext: react.Context<AppInitializationState | null>;
 /**
@@ -7620,5 +7885,5 @@ declare function InitializationProvider({ children }: {
     children: ReactNode;
 }): react.FunctionComponentElement<react.ProviderProps<AppInitializationState | null>>;
 
-export { AGENT_CONSTANTS, APIClientError, APIErrorAlert, ActionModal, AdminGuard, AgentDefinitionDisplay, AgentExecutionTimeline, AgentExecutionVisualizer, AgentIterationEdge, AgentIterationNode, ApiClientProvider, AuthProvider, BaseEdge, BaseNode, CONTAINER_CONSTANTS, ChatHeader, ChatInputArea, ChatInterface, ChatSidebar, CollapsibleJsonSection, CollapsibleSection, ConfigCard, ConfirmationInputModal, ConfirmationModal, ContextViewer, ContractDisplay, CustomModal, CustomSelector, DetailCardSkeleton, ElevasisCoreProvider, ElevasisProvider, ElevasisServiceProvider, ElevasisUIProvider, EmptyState, EmptyVisualizer, ExecutionLogsTable, ExecutionStats, ExecutionStatusBadge, FormFieldRenderer, GRAPH_CONSTANTS, GlowingHandle, GraphBackground, GraphContainer, GraphFitViewButton, GraphFitViewHandler, GraphLegend, InitializationContext, InitializationProvider, JsonViewer, ListSkeleton, MessageBubble, NavigationButton, NewKnowledgeMapEdge, NewKnowledgeMapGraph, NewKnowledgeMapNode, NotificationBell, NotificationItem, NotificationList, NotificationPanel, NotificationProvider, OperationsService, OrganizationProvider, OrganizationSwitcher, PageNotFound, PageTitleCaption, ProfileProvider, ProtectedRoute, ResourceCard, ResourceDefinitionSection, ResourceHealthChart, RouterProvider, SHARED_VIZ_CONSTANTS, STATUS_COLORS, StatCard, StatCardSkeleton, StatsCardSkeleton, StyledMarkdown, TIMELINE_CONSTANTS, TabCountBadge, TanStackRouterBridge, TaskCard, TimeRangeSelector, TimelineAxis, TimelineBar, TimelineContainer, TimelineRow, ToolsListDisplay, TrendIndicator, UnifiedWorkflowEdge, UnifiedWorkflowGraph, UnifiedWorkflowNode, UserProfileService, VisualizerContainer, WORKFLOW_CONSTANTS, WorkOSAuthBridge, WorkflowDefinitionDisplay, WorkflowExecutionTimeline, calculateBarPosition, calculateGraphHeight, catalogItemToResourceDefinition, createCssVariablesResolver, createOrganizationsSlice, createUseApiClient, createUseAppInitialization, createUseOrgInitialization, createUseOrganizations, executionsKeys, formatDate, formatDuration, formatErrorMessage, generateShades, getEdgeColor, getEdgeOpacity, getErrorInfo, getErrorTitle, getGraphBackgroundStyles, getHealthColor, getIcon, getPreset, getResourceColor, getResourceIcon, getResourceStatusColor, getStatusColors, getStatusIcon, iconMap, isAPIClientError, mantineNotificationAdapter, mantineThemeOverride, observabilityKeys, scheduleKeys, shouldAnimateEdge, showApiErrorNotification, showErrorNotification, showInfoNotification, showSuccessNotification, showWarningNotification, useActivities, useActivityTrend, useAgentIterationData, useApiClient, useApiClientContext, useAuthContext, useBulkDeleteExecutions, useBusinessImpact, useCancelExecution, useCancelSchedule, useCommandQueue, useCommandQueueTotals, useConnectionHighlight, useCostBreakdown, useCostByModel, useCostSummary, useCostTrends, useCreateSchedule, useDashboardMetrics, useDeleteExecution, useDeleteSchedule, useDeleteTask, useDirectedChainHighlighting, useElevasisServices, useErrorAnalysis, useErrorDetail, useErrorDetails, useErrorDistribution, useErrorTrends, useExecuteAsync, useExecution, useExecutionHealth, useExecutionLogs, useExecutionPath, useExecutions, useFitViewTrigger, useGetExecutionHistory, useGetSchedule, useGraphBackgroundStyles, useGraphHighlighting, useGraphTheme, useInitialization, useListSchedules, useMarkAllAsRead, useMarkAsRead, useMergedExecution, useNewKnowledgeMapLayout, useNodeSelection, useNotificationAdapter, useNotificationCount, useNotifications, useOAuthContext, useOrganization, usePatchTask, usePauseSchedule, useProfile, useReactFlowAgent, useSessionCheck as useRefocusSessionCheck, useResolveAllErrors, useResolveError, useResolveErrorsByExecution, useResourceDefinition, useResources, useResumeSchedule, useRetryExecution, useRouterContext, useSessionCheck, useStableAccessToken, useSubmitAction, useTimelineData, useTopFailingResources, useUnifiedWorkflowLayout, useUnresolveError, useUpdateAnchor, useUpdateSchedule, useUserProfile, useWorkflowStepsLayout, validateEmail };
-export type { ActivityTrendResponse, AdminGuardProps, AgentIterationEdgeData, AgentIterationNodeData, AgentStatus, ApiClientContextValue, ApiClientProviderProps, ApiErrorDetails, ApiKeyConfig, AppInitializationState, AuthAdapter, AuthConfig, AuthKitConfig, BulkDeleteExecutionsParams, BulkDeleteExecutionsResult, BusinessImpactMetrics, CancelExecutionParams, CancelExecutionResult, ContextViewerProps, CostBreakdownItem, CreateScheduleInput, CreateSessionResponse, DeleteExecutionParams, DirectedChainHighlightingOptions, DirectedChainHighlightingResult, EdgeColorOptions, EdgeOpacityOptions, ElevasisCoreProviderProps, ElevasisCoreThemeConfig, ElevasisProviderProps, ElevasisServiceContextValue, ElevasisServiceProviderProps, ElevasisThemeConfig, ElevasisTokenOverrides, ErrorDistributionItem, ErrorDistributionParams, ErrorFilters, ErrorTrendsParams, ExecuteAsyncParams, ExecuteAsyncResult, ExecutionErrorDetails, ExecutionHistoryItem, ExecutionHistoryResponse, ExecutionLogEntry, ExecutionLogsPageResponse, ExecutionLogsTableProps, ExecutionPathState, ExecutionStatus$1 as ExecutionStatus, FailingResource, FitViewButtonVariant, GlowIntensity, GraphFitViewHandlerProps, GraphHeightOptions, GraphHighlightingResult, GraphMode, GraphThemeColors, InitializationError, JsonViewerProps, KnowledgeMapEdgeData, KnowledgeMapNodeData, LinkProps, ListActivitiesResponse, ListSchedulesFilters, ListSchedulesResponse, NavigationButtonProps, NodeColorType, NotificationAdapter, OAuthConfig, OAuthContextValue, OrganizationContextValue, OrganizationsActions, OrganizationsSlice, OrganizationsState, PresetName, ProfileContextValue, ProtectedRouteProps, ResourcesResponse, RetryExecutionParams, RouterAdapter, SerializedKnowledgeMap, SerializedKnowledgeNode, SessionListItem, StatCardProps, StatusColorScheme, StatusIconColors, StepExecutionData, StyledMarkdownProps, SubmitActionRequest, SubmitActionResponse, TablerIcon, TaskSchedule, ThemePreset, TimelineBarProps, TimelineContainerProps, TimelineRowProps, TopFailingResourcesParams, TrendIndicatorProps, UnifiedWorkflowEdgeData, UnifiedWorkflowNodeData, UpdateScheduleInput, UseActivitiesParams, UseActivityTrendParams, UseApiClientReturn, UseExecutionHealthParams, UseExecutionLogsParams, UseOrgInitializationReturn, UseOrganizationsReturn$1 as UseOrganizationsReturn, UseUserProfileReturn, WithSchemes, WorkflowEdgeType, WorkflowStepEdgeData, WorkflowStepNodeData, WorkflowStepsLayoutInput };
+export { AGENT_CONSTANTS, APIClientError, APIErrorAlert, ActionModal, AdminGuard, AgentDefinitionDisplay, AgentExecutionTimeline, AgentExecutionVisualizer, AgentIterationEdge, AgentIterationNode, ApiClientProvider, AuthProvider, BaseEdge, BaseNode, CONTAINER_CONSTANTS, ChatHeader, ChatInputArea, ChatInterface, ChatSidebar, CollapsibleJsonSection, CollapsibleSection, ConfigCard, ConfirmationInputModal, ConfirmationModal, ContextViewer, ContractDisplay, CustomModal, CustomSelector, DetailCardSkeleton, ElevasisCoreProvider, ElevasisProvider, ElevasisServiceProvider, ElevasisUIProvider, EmptyState, EmptyVisualizer, ExecutionLogsTable, ExecutionStats, ExecutionStatusBadge, FormFieldRenderer, GRAPH_CONSTANTS, GlowingHandle, GraphBackground, GraphContainer, GraphFitViewButton, GraphFitViewHandler, GraphLegend, InitializationContext, InitializationProvider, JsonViewer, ListSkeleton, MessageBubble, NavigationButton, NewKnowledgeMapEdge, NewKnowledgeMapGraph, NewKnowledgeMapNode, NotificationBell, NotificationItem, NotificationList, NotificationPanel, NotificationProvider, OperationsService, OrganizationProvider, OrganizationSwitcher, PageNotFound, PageTitleCaption, ProfileProvider, ProtectedRoute, ResourceCard, ResourceDefinitionSection, ResourceHealthChart, RouterProvider, SHARED_VIZ_CONSTANTS, STATUS_COLORS, StatCard, StatCardSkeleton, StatsCardSkeleton, StyledMarkdown, TIMELINE_CONSTANTS, TabCountBadge, TanStackRouterBridge, TaskCard, TimeRangeSelector, TimelineAxis, TimelineBar, TimelineContainer, TimelineRow, ToolsListDisplay, TrendIndicator, UnifiedWorkflowEdge, UnifiedWorkflowGraph, UnifiedWorkflowNode, UserProfileService, VisualizerContainer, WORKFLOW_CONSTANTS, WorkflowDefinitionDisplay, WorkflowExecutionTimeline, calculateBarPosition, calculateGraphHeight, catalogItemToResourceDefinition, createCssVariablesResolver, createOrganizationsSlice, createUseAppInitialization, createUseFeatureAccess, createUseOrgInitialization, createUseOrganizations, executionsKeys, formatDate, formatDuration, formatErrorMessage, generateShades, getEdgeColor, getEdgeOpacity, getErrorInfo, getErrorTitle, getGraphBackgroundStyles, getHealthColor, getIcon, getPreset, getResourceColor, getResourceIcon, getResourceStatusColor, getStatusColors, getStatusIcon, iconMap, isAPIClientError, mantineNotificationAdapter, mantineThemeOverride, observabilityKeys, scheduleKeys, shouldAnimateEdge, showApiErrorNotification, showErrorNotification, showInfoNotification, showSuccessNotification, showWarningNotification, sortData, useActivities, useActivityTrend, useAgentIterationData, useApiClient, useApiClientContext, useAuthContext, useBatchDelete, useBulkDeleteExecutions, useBusinessImpact, useCancelExecution, useCancelSchedule, useCommandQueue, useCommandQueueTotals, useConnectionHighlight, useCostBreakdown, useCostByModel, useCostSummary, useCostTrends, useCreateSchedule, useDashboardMetrics, useDeleteExecution, useDeleteSchedule, useDeleteTask, useDirectedChainHighlighting, useElevasisServices, useErrorAnalysis, useErrorDetail, useErrorDetails, useErrorDistribution, useErrorNotification, useErrorTrends, useExecuteAsync, useExecution, useExecutionHealth, useExecutionLogs, useExecutionPath, useExecutions, useFitViewTrigger, useGetExecutionHistory, useGetSchedule, useGraphBackgroundStyles, useGraphHighlighting, useGraphTheme, useInitialization, useListSchedules, useMarkAllAsRead, useMarkAsRead, useMergedExecution, useNewKnowledgeMapLayout, useNodeSelection, useNotificationAdapter, useNotificationCount, useNotifications, useOrganization, usePaginationState, usePatchTask, usePauseSchedule, useProfile, useReactFlowAgent, useSessionCheck as useRefocusSessionCheck, useResolveAllErrors, useResolveError, useResolveErrorsByExecution, useResourceDefinition, useResources, useResumeSchedule, useRetryExecution, useRouterContext, useSSEConnection, useSessionCheck, useSortedData, useStableAccessToken, useSubmitAction, useSuccessNotification, useTableSelection, useTableSort, useTimelineData, useTopFailingResources, useUnifiedWorkflowLayout, useUnresolveError, useUpdateAnchor, useUpdateSchedule, useUserProfile, useWarningNotification, useWorkflowStepsLayout, validateEmail };
+export type { ActivityTrendResponse, AdminGuardProps, AgentIterationEdgeData, AgentIterationNodeData, AgentStatus, ApiClientContextValue, ApiClientProviderProps, ApiErrorDetails, ApiKeyConfig, AppInitializationState, AuthConfig, AuthContextValue, AuthKitConfig, BulkDeleteExecutionsParams, BulkDeleteExecutionsResult, BusinessImpactMetrics, CancelExecutionParams, CancelExecutionResult, ContextViewerProps, CostBreakdownItem, CreateScheduleInput, CreateSessionResponse, DeleteExecutionParams, DirectedChainHighlightingOptions, DirectedChainHighlightingResult, EdgeColorOptions, EdgeOpacityOptions, ElevasisCoreProviderProps, ElevasisCoreThemeConfig, ElevasisProviderProps, ElevasisServiceContextValue, ElevasisServiceProviderProps, ElevasisThemeConfig, ElevasisTokenOverrides, ErrorDistributionItem, ErrorDistributionParams, ErrorFilters, ErrorTrendsParams, ExecuteAsyncParams, ExecuteAsyncResult, ExecutionErrorDetails, ExecutionHistoryItem, ExecutionHistoryResponse, ExecutionLogEntry, ExecutionLogsPageResponse, ExecutionLogsTableProps, ExecutionPathState, ExecutionStatus$1 as ExecutionStatus, FailingResource, FitViewButtonVariant, GlowIntensity, GraphFitViewHandlerProps, GraphHeightOptions, GraphHighlightingResult, GraphMode, GraphThemeColors, InitializationError, JsonViewerProps, KnowledgeMapEdgeData, KnowledgeMapNodeData, LinkProps, ListActivitiesResponse, ListSchedulesFilters, ListSchedulesResponse, NavigationButtonProps, NodeColorType, NotificationAdapter, OrganizationContextValue, OrganizationsActions, OrganizationsSlice, OrganizationsState, PresetName, ProfileContextValue, ProtectedRouteProps, ResourcesResponse, RetryExecutionParams, RouterAdapter, SerializedKnowledgeMap, SerializedKnowledgeNode, SessionListItem, SortDirection, SortState, StatCardProps, StatusColorScheme, StatusIconColors, StepExecutionData, StyledMarkdownProps, SubmitActionRequest, SubmitActionResponse, TablerIcon, TaskSchedule, ThemePreset, TimelineBarProps, TimelineContainerProps, TimelineRowProps, TopFailingResourcesParams, TrendIndicatorProps, UnifiedWorkflowEdgeData, UnifiedWorkflowNodeData, UpdateScheduleInput, UseActivitiesParams, UseActivityTrendParams, UseApiClientReturn, UseExecutionHealthParams, UseExecutionLogsParams, UseOrgInitializationReturn, UseOrganizationsReturn, UseSSEConnectionOptions, UseUserProfileReturn, WithSchemes, WorkflowEdgeType, WorkflowStepEdgeData, WorkflowStepNodeData, WorkflowStepsLayoutInput };