@elevasis/ui 1.2.1 → 1.3.0

package/dist/index.js

@@ -1,32 +1,38 @@
 import './chunk-Q47SPRY7.js';
-export { OperationsService, executionsKeys, observabilityKeys, scheduleKeys, useActivities, useActivityTrend, useBulkDeleteExecutions, useBusinessImpact, useCancelExecution, useCancelSchedule, useCostBreakdown, useCostByModel, useCostSummary, useCostTrends, useCreateSchedule, useDashboardMetrics, useDeleteExecution, useDeleteSchedule, useErrorAnalysis, useErrorDetail, useErrorDetails, useErrorDistribution, useErrorTrends, useExecuteAsync, useExecution, useExecutionHealth, useExecutionLogs, useExecutions, useGetExecutionHistory, useGetSchedule, useListSchedules, usePauseSchedule, useResolveAllErrors, useResolveError, useResolveErrorsByExecution, useResourceDefinition, useResources, useResumeSchedule, useRetryExecution, useTopFailingResources, useUnresolveError, useUpdateAnchor, useUpdateSchedule } from './chunk-WNWKOCGJ.js';
+export { OperationsService, executionsKeys, observabilityKeys, scheduleKeys, useActivities, useActivityTrend, useBulkDeleteExecutions, useBusinessImpact, useCancelExecution, useCancelSchedule, useCostBreakdown, useCostByModel, useCostSummary, useCostTrends, useCreateSchedule, useDashboardMetrics, useDeleteExecution, useDeleteSchedule, useErrorAnalysis, useErrorDetail, useErrorDetails, useErrorDistribution, useErrorTrends, useExecuteAsync, useExecution, useExecutionHealth, useExecutionLogs, useExecutions, useGetExecutionHistory, useGetSchedule, useListSchedules, usePauseSchedule, useResolveAllErrors, useResolveError, useResolveErrorsByExecution, useResourceDefinition, useResources, useResumeSchedule, useRetryExecution, useTopFailingResources, useUnresolveError, useUpdateAnchor, useUpdateSchedule } from './chunk-BZTA7IIL.js';
 export { TanStackRouterBridge } from './chunk-LHQTTUL2.js';
 export { AGENT_CONSTANTS, AgentExecutionTimeline, AgentExecutionVisualizer, AgentIterationEdge, AgentIterationNode, CONTAINER_CONSTANTS, EmptyVisualizer, ExecutionStats, ExecutionStatusBadge, SHARED_VIZ_CONSTANTS, STATUS_COLORS, TIMELINE_CONSTANTS, TimelineAxis, TimelineBar, TimelineContainer, TimelineRow, UnifiedWorkflowEdge, UnifiedWorkflowGraph, UnifiedWorkflowNode, VisualizerContainer, WORKFLOW_CONSTANTS, WorkflowExecutionTimeline, calculateBarPosition, getEdgeColor, getEdgeOpacity, getResourceStatusColor, getStatusColors, getStatusIcon, shouldAnimateEdge, useAgentIterationData, useExecutionPath, useMergedExecution, useReactFlowAgent, useTimelineData, useUnifiedWorkflowLayout, useWorkflowStepsLayout } from './chunk-RJCA5672.js';
-export { OrganizationSwitcher, createOrganizationsSlice, createUseOrgInitialization, createUseOrganizations } from './chunk-GEFB5YIR.js';
+export { OrganizationSwitcher, createOrganizationsSlice, createUseOrgInitialization, createUseOrganizations } from './chunk-EZMRFWZQ.js';
 import './chunk-XCYKC6OZ.js';
-export { createUseAppInitialization } from './chunk-YULUKCS6.js';
-export { UserProfileService, useUserProfile } from './chunk-5UWFGBFM.js';
-export { ChatHeader, ChatInputArea, ChatInterface, ChatSidebar, ConfirmationInputModal, ConfirmationModal, MessageBubble } from './chunk-S66I2PYB.js';
+export { createUseAppInitialization } from './chunk-SITSZUFW.js';
+import './chunk-RNP5R5I3.js';
+export { ChatHeader, ChatInputArea, ChatInterface, ChatSidebar, ConfirmationInputModal, ConfirmationModal, MessageBubble } from './chunk-TN3PU2WK.js';
 export { ExecutionLogsTable, ResourceHealthChart, getHealthColor } from './chunk-NE36BUGQ.js';
 import './chunk-W7ZBF5AA.js';
-export { ActionModal, CustomModal, TaskCard, getIcon, iconMap } from './chunk-ZGHDPDTF.js';
-export { useCommandQueue, useCommandQueueTotals, useDeleteTask, usePatchTask, useSubmitAction } from './chunk-J3FALDQE.js';
+export { ActionModal, CustomModal, TaskCard, getIcon, iconMap } from './chunk-JYSYHVLU.js';
+export { useCommandQueue, useCommandQueueTotals, useDeleteTask, usePatchTask, useSubmitAction } from './chunk-NXHL23JW.js';
 export { FormFieldRenderer } from './chunk-PSLKGOBZ.js';
-export { NotificationBell, NotificationItem, NotificationList, NotificationPanel } from './chunk-PYL4XW6H.js';
-export { useMarkAllAsRead, useMarkAsRead, useNotificationCount, useNotifications } from './chunk-JKERRYVS.js';
+export { NotificationBell, NotificationItem, NotificationList, NotificationPanel } from './chunk-TMFCNFLW.js';
+export { useMarkAllAsRead, useMarkAsRead, useNotificationCount, useNotifications } from './chunk-BLO4SISK.js';
 export { AgentDefinitionDisplay, CollapsibleJsonSection, ConfigCard, ContractDisplay, NewKnowledgeMapEdge, NewKnowledgeMapGraph, NewKnowledgeMapNode, ResourceDefinitionSection, ToolsListDisplay, WorkflowDefinitionDisplay, useNewKnowledgeMapLayout } from './chunk-OXVOHOP3.js';
 export { formatDuration } from './chunk-6BJOYF6E.js';
 export { BaseEdge, BaseNode, GRAPH_CONSTANTS, GlowingHandle, GraphBackground, GraphContainer, GraphFitViewButton, GraphFitViewHandler, GraphLegend, calculateGraphHeight, getGraphBackgroundStyles, Graph_default as graphStyles, useConnectionHighlight, useDirectedChainHighlighting, useFitViewTrigger, useGraphBackgroundStyles, useGraphHighlighting, useGraphTheme, useNodeSelection } from './chunk-HUWJXLLF.js';
-export { APIErrorAlert, CollapsibleSection, ContextViewer, CustomSelector, DetailCardSkeleton, EmptyState, JsonViewer, ListSkeleton, NavigationButton, PageNotFound, PageTitleCaption, ResourceCard, StatCard, StatCardSkeleton, StatsCardSkeleton, TabCountBadge, TimeRangeSelector, TrendIndicator, catalogItemToResourceDefinition } from './chunk-OUHGHTE7.js';
+export { APIErrorAlert, CollapsibleSection, ContextViewer, CustomSelector, DetailCardSkeleton, EmptyState, JsonViewer, ListSkeleton, NavigationButton, PageNotFound, PageTitleCaption, ResourceCard, StatCard, StatCardSkeleton, StatsCardSkeleton, TabCountBadge, TimeRangeSelector, TrendIndicator, catalogItemToResourceDefinition } from './chunk-O3PY6B6E.js';
 export { StyledMarkdown } from './chunk-3KMDHCAR.js';
 import './chunk-YZ6GTZXL.js';
-export { ElevasisProvider, ElevasisUIProvider, createCssVariablesResolver, generateShades, getPreset, mantineThemeOverride } from './chunk-B64YDSAY.js';
-export { ElevasisCoreProvider } from './chunk-ZQVPUAGR.js';
-export { ApiClientProvider, createUseApiClient, useApiClientContext } from './chunk-GDV44UWF.js';
-export { ElevasisServiceProvider, useElevasisServices } from './chunk-KA7LO7U5.js';
-export { APIClientError, formatDate, formatErrorMessage, getErrorInfo, getErrorTitle, getResourceColor, getResourceIcon, isAPIClientError, showApiErrorNotification, showErrorNotification, showInfoNotification, showSuccessNotification, showWarningNotification, validateEmail } from './chunk-7AI5ZYJ4.js';
-export { useSessionCheck as useRefocusSessionCheck, useSessionCheck, useStableAccessToken } from './chunk-HBRMWW6V.js';
+export { ElevasisProvider, ElevasisUIProvider, createCssVariablesResolver, generateShades, getPreset, mantineNotificationAdapter, mantineThemeOverride } from './chunk-PCBXNHKY.js';
+export { ElevasisCoreProvider } from './chunk-OLD3NQLI.js';
+export { OrganizationProvider } from './chunk-FLJXZ7YC.js';
+export { ApiClientProvider, createUseApiClient, useApiClient, useApiClientContext } from './chunk-BWCC6ZJC.js';
+export { NotificationProvider, useNotificationAdapter } from './chunk-TIRMFDM4.js';
+export { formatDate, getResourceColor, getResourceIcon, showApiErrorNotification, showErrorNotification, showInfoNotification, showSuccessNotification, showWarningNotification, validateEmail } from './chunk-JVAZHVNV.js';
+export { APIClientError, formatErrorMessage, getErrorInfo, getErrorTitle, isAPIClientError } from './chunk-4VGWQ5AN.js';
+export { AdminGuard, ProtectedRoute, useSessionCheck as useRefocusSessionCheck, useSessionCheck, useStableAccessToken } from './chunk-FDCVFCOQ.js';
 export { WorkOSAuthBridge } from './chunk-NIAVTSMB.js';
 export { useOAuthContext } from './chunk-QSVZP2NU.js';
+export { InitializationContext, InitializationProvider, useInitialization } from './chunk-QQOLC46E.js';
+export { useOrganization } from './chunk-DD3CCMCZ.js';
+export { ProfileProvider, UserProfileService, useProfile, useUserProfile } from './chunk-4KAG5U7A.js';
+export { ElevasisServiceProvider, useElevasisServices } from './chunk-KA7LO7U5.js';
 export { AuthProvider, useAuthContext } from './chunk-7PLEQFHO.js';
 export { RouterProvider, useRouterContext } from './chunk-Q7DJKLEN.js';

package/dist/initialization/index.d.ts

@@ -1,3 +1,6 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+
 type Json = string | number | boolean | null | {
     [key: string]: Json | undefined;
 } | Json[];
@@ -2321,5 +2324,50 @@ interface AppInitializationState {
  */
 declare function createUseAppInitialization(useOrgInitialization: () => UseOrgInitializationReturn): () => AppInitializationState;
 
-export { createUseAppInitialization };
+declare const InitializationContext: react.Context<AppInitializationState | null>;
+/**
+ * Consumes the nearest InitializationProvider.
+ *
+ * @throws {Error} If called outside of an InitializationProvider tree.
+ */
+declare function useInitialization(): AppInitializationState;
+/**
+ * Aggregates auth, profile, and organization state into a single initialization context.
+ *
+ * Must be rendered inside:
+ * - An AuthProvider (needs useAuthContext)
+ * - A ProfileProvider (needs useProfile)
+ * - An OrganizationProvider (needs useOrganization)
+ *
+ * Initialization Layers (Sequential):
+ * 1. WorkOS Auth (useAuthContext)
+ * 2. User Profile Sync (useProfile)
+ * 3. Organization Context (useOrganization)
+ *
+ * @example
+ * // Org-scoped pages with data queries (most common)
+ * const { organizationReady } = useInitialization()
+ * const { data, isLoading } = useResources()
+ * if (!organizationReady || isLoading) return <SubshellLoader />
+ *
+ * @example
+ * // Pages accessible without org (invitations, pending)
+ * const { userReady, error } = useInitialization()
+ * if (!userReady) return <SubshellLoader />
+ * if (error?.layer === 'organization') {
+ *   return <PendingInvitationPage message={error.message} />
+ * }
+ *
+ * @example
+ * // Pages with error handling
+ * const { organizationReady, error, retry } = useInitialization()
+ * if (error?.layer === 'organization') return <NoOrgError error={error} />
+ * if (error) return <ErrorCard error={error} onRetry={retry} />
+ * if (!organizationReady) return <SubshellLoader />
+ */
+declare function InitializationProvider({ children }: {
+    children: ReactNode;
+}): react.FunctionComponentElement<react.ProviderProps<AppInitializationState | null>>;
+
+export { InitializationContext, InitializationProvider, createUseAppInitialization, useInitialization };
 export type { AppInitializationState, InitializationError };

package/dist/initialization/index.js

@@ -1,4 +1,7 @@
-export { createUseAppInitialization } from '../chunk-YULUKCS6.js';
-import '../chunk-5UWFGBFM.js';
+export { createUseAppInitialization } from '../chunk-SITSZUFW.js';
+import '../chunk-RNP5R5I3.js';
+export { InitializationContext, InitializationProvider, useInitialization } from '../chunk-QQOLC46E.js';
+import '../chunk-DD3CCMCZ.js';
+import '../chunk-4KAG5U7A.js';
 import '../chunk-KA7LO7U5.js';
 import '../chunk-7PLEQFHO.js';

package/dist/organization/index.d.ts

@@ -1,3 +1,5 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
 import { UseBoundStore, StoreApi } from 'zustand';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
@@ -75,6 +77,63 @@ interface MembershipWithDetails extends OrganizationMembership {
     config?: MembershipFeatureConfig;
 }
 
+/**
+ * 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.
+ *
+ * Must be rendered inside:
+ * - ElevasisServiceProvider (needs apiRequest)
+ * - ProfileProvider (needs useProfile for last_visited_org preference)
+ * - A TanStack QueryClientProvider (needs useQueryClient for cache invalidation)
+ *
+ * Behaviors:
+ * - Fetches all memberships for the authenticated user via GET /memberships/my-memberships
+ * - Selects the active org by priority: saved preference > WorkOS org ID > first membership
+ * - Persists org switches to PATCH /users/me { last_visited_org }
+ * - Clears all state when the user signs out (user becomes null)
+ */
+declare function OrganizationProvider({ children }: {
+    children: ReactNode;
+}): react.FunctionComponentElement<react.ProviderProps<OrganizationContextValue | null>>;
+
 interface OrganizationsState {
     currentWorkOSOrganizationId: string | null;
     currentSupabaseOrganizationId: string | null;
@@ -221,5 +280,5 @@ interface OrganizationSwitcherProps {
 }
 declare function OrganizationSwitcher({ currentOrganization, memberships, isLoading, onSwitch }: OrganizationSwitcherProps): react_jsx_runtime.JSX.Element;
 
-export { OrganizationSwitcher, createOrganizationsSlice, createUseOrgInitialization, createUseOrganizations };
-export type { OrganizationsActions, OrganizationsSlice, OrganizationsState, UseApiClientReturn, UseOrgInitializationReturn, UseOrganizationsReturn };
+export { OrganizationProvider, OrganizationSwitcher, createOrganizationsSlice, createUseOrgInitialization, createUseOrganizations, useOrganization };
+export type { OrganizationContextValue, OrganizationsActions, OrganizationsSlice, OrganizationsState, UseApiClientReturn, UseOrgInitializationReturn, UseOrganizationsReturn };

package/dist/organization/index.js

@@ -1,4 +1,7 @@
-export { OrganizationSwitcher, createOrganizationsSlice, createUseOrgInitialization, createUseOrganizations } from '../chunk-GEFB5YIR.js';
-import '../chunk-5UWFGBFM.js';
+export { OrganizationSwitcher, createOrganizationsSlice, createUseOrgInitialization, createUseOrganizations } from '../chunk-EZMRFWZQ.js';
+import '../chunk-RNP5R5I3.js';
+export { OrganizationProvider } from '../chunk-FLJXZ7YC.js';
+export { useOrganization } from '../chunk-DD3CCMCZ.js';
+import '../chunk-4KAG5U7A.js';
 import '../chunk-KA7LO7U5.js';
 import '../chunk-7PLEQFHO.js';

package/dist/profile/index.d.ts

@@ -1,3 +1,6 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+
 type Json = string | number | boolean | null | {
     [key: string]: Json | undefined;
 } | Json[];
@@ -2204,6 +2207,31 @@ type Tables<DefaultSchemaTableNameOrOptions extends keyof (DefaultSchema["Tables
 
 type SupabaseUserProfile = Tables<'users'>;
 
+interface ProfileContextValue {
+    profile: SupabaseUserProfile | null;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+}
+/**
+ * Consumes the nearest ProfileProvider.
+ *
+ * @throws {Error} If called outside of a ProfileProvider tree.
+ */
+declare function useProfile(): ProfileContextValue;
+/**
+ * Provides shared profile state to its subtree via React Context.
+ *
+ * Wraps useUserProfile so that all consumers share one profile fetch
+ * instead of each triggering an independent sync call.
+ *
+ * Must be rendered inside the auth and service provider layers so that
+ * the underlying hook can access useAuthContext and useElevasisServices.
+ */
+declare function ProfileProvider({ children }: {
+    children: ReactNode;
+}): react.FunctionComponentElement<react.ProviderProps<ProfileContextValue | null>>;
+
 interface UseUserProfileOptions {
     /**
      * Optional error handler for profile sync failures
@@ -2261,5 +2289,5 @@ declare class UserProfileService {
     }>): Promise<SupabaseUserProfile | null>;
 }
 
-export { UserProfileService, useUserProfile };
-export type { UseUserProfileReturn };
+export { ProfileProvider, UserProfileService, useProfile, useUserProfile };
+export type { ProfileContextValue, UseUserProfileReturn };

package/dist/profile/index.js

@@ -1,3 +1,4 @@
-export { UserProfileService, useUserProfile } from '../chunk-5UWFGBFM.js';
+import '../chunk-RNP5R5I3.js';
+export { ProfileProvider, UserProfileService, useProfile, useUserProfile } from '../chunk-4KAG5U7A.js';
 import '../chunk-KA7LO7U5.js';
 import '../chunk-7PLEQFHO.js';

package/dist/provider/index.d.ts

@@ -11,6 +11,53 @@ interface ApiErrorDetails {
     requestId?: string;
 }
 
+/**
+ * Pluggable notification adapter interface.
+ *
+ * Implement this to connect any notification library (Mantine, react-toastify, etc.)
+ * to the Elevasis UI hooks.
+ */
+interface NotificationAdapter {
+    success(title: string, message: string): void;
+    error(title: string, message: string): void;
+    info(title: string, message: string): void;
+    warning(title: string, message: string): void;
+    /** Formats and displays an API error using structured error-utils helpers. */
+    apiError(error: unknown): void;
+}
+/**
+ * Provides a notification adapter to all descendant components.
+ *
+ * Pass a `MantineNotificationAdapter` for Command Center, or any custom
+ * adapter for other consumers (template, tests, etc.).
+ *
+ * When omitted, hooks fall back to the console adapter automatically.
+ *
+ * @example
+ * ```tsx
+ * import { NotificationProvider } from '@repo/ui/provider'
+ * import { mantineNotificationAdapter } from '@repo/ui/provider'
+ *
+ * <NotificationProvider adapter={mantineNotificationAdapter}>
+ *   <App />
+ * </NotificationProvider>
+ * ```
+ */
+declare function NotificationProvider({ adapter, children }: {
+    adapter: NotificationAdapter;
+    children: ReactNode;
+}): react_jsx_runtime.JSX.Element;
+/**
+ * Returns the active notification adapter.
+ *
+ * Falls back to the console adapter when used outside a NotificationProvider,
+ * so hooks remain functional in template environments without Mantine.
+ *
+ * Named `useNotificationAdapter` to avoid collision with the data-fetching
+ * `useNotifications` hook exported from `hooks/monitoring`.
+ */
+declare function useNotificationAdapter(): NotificationAdapter;
+
 /** Flat + per-scheme override pattern. Flat values apply to both; `light`/`dark` win over flat. */
 type WithSchemes<T> = T & {
     light?: T;
@@ -112,16 +159,18 @@ interface ElevasisCoreProviderProps {
      */
     theme?: ElevasisCoreThemeConfig;
     /**
-     * Override organization ID resolution.
-     * Command-center passes Zustand-managed org ID here.
-     * SDK consumers typically omit this (auto-resolved from JWT/API key).
+     * @deprecated Organization ID is now resolved automatically via OrganizationProvider.
+     * This prop is accepted for backwards compatibility during migration but is no longer
+     * used when the full provider stack is active (apiUrl provided).
      */
     organizationId?: string | null;
     /** Custom QueryClient. If omitted, a default is created internally. */
     queryClient?: QueryClient;
     /**
      * API base URL (e.g., 'https://api.elevasis.com' or 'http://localhost:5170').
-     * When provided, ElevasisCoreProvider composes ApiClientProvider + ElevasisServiceProvider internally.
+     * When provided, ElevasisCoreProvider composes the full provider stack:
+     * ApiClientProvider + ElevasisServiceProvider + ProfileProvider +
+     * OrganizationProvider + NotificationProvider + InitializationProvider.
      * When omitted, no service context is provided (theme-only mode).
      */
     apiUrl?: string;
@@ -131,11 +180,19 @@ interface ElevasisCoreProviderProps {
      */
     onError?: (endpoint: string, error: Error, details?: ApiErrorDetails) => void;
     /**
-     * Override organization readiness check.
-     * Defaults to `!!organizationId` if not provided.
-     * Command-center passes `!!currentMembership` for its stricter readiness requirement.
+     * @deprecated Organization readiness is now managed internally by OrganizationProvider.
+     * Accepted for backwards compatibility but ignored when apiUrl is provided.
      */
     isOrganizationReady?: boolean;
+    /**
+     * Notification adapter for displaying success/error/info messages.
+     * When provided, wraps the subtree in a NotificationProvider with this adapter.
+     * When omitted, the console fallback adapter is used automatically.
+     *
+     * ElevasisUIProvider (Mantine variant) passes mantineNotificationAdapter here automatically.
+     * Headless/SDK consumers can pass a custom adapter or omit for console output.
+     */
+    notifications?: NotificationAdapter;
     /**
      * Whether to inject CSS variables, `data-elevasis-scheme` attribute, and font links.
      * Set to `false` when the consumer has its own complete design system and only
@@ -154,16 +211,15 @@ interface ElevasisProviderProps {
      */
     theme?: ElevasisThemeConfig;
     /**
-     * Override organization ID resolution.
-     * Command-center passes Zustand-managed org ID here.
-     * SDK consumers typically omit this (auto-resolved from JWT/API key).
+     * @deprecated Organization ID is now resolved automatically via OrganizationProvider.
+     * Accepted for backwards compatibility during migration but no longer used internally.
      */
     organizationId?: string | null;
     /** Custom QueryClient. If omitted, a default is created internally. */
     queryClient?: QueryClient;
     /**
      * API base URL (e.g., 'https://api.elevasis.com' or 'http://localhost:5170').
-     * When provided, ElevasisProvider composes ApiClientProvider + ElevasisServiceProvider internally.
+     * When provided, ElevasisUIProvider composes the full provider stack via ElevasisCoreProvider.
      * When omitted, no service context is provided (theme-only mode).
      */
     apiUrl?: string;
@@ -173,9 +229,8 @@ interface ElevasisProviderProps {
      */
     onError?: (endpoint: string, error: Error, details?: ApiErrorDetails) => void;
     /**
-     * Override organization readiness check.
-     * Defaults to `!!organizationId` if not provided.
-     * Command-center passes `!!currentMembership` for its stricter readiness requirement.
+     * @deprecated Organization readiness is now managed internally by OrganizationProvider.
+     * Accepted for backwards compatibility but ignored when apiUrl is provided.
      */
     isOrganizationReady?: boolean;
     children: ReactNode;
@@ -202,18 +257,19 @@ interface ElevasisServiceProviderProps {
 /**
  * UI provider for Elevasis-powered applications. Includes Mantine theme integration.
  *
- * Composes: MantineThemeProvider + QueryClientProvider + auth provider +
- * auth bridge. When apiUrl is provided, also composes
- * ApiClientProvider + ElevasisServiceProvider.
+ * A thin Mantine shell around ElevasisCoreProvider. Handles:
+ * - MantineProvider with theme resolution (presets, token overrides, color scheme)
+ * - Google Font injection for preset fonts
+ * - CSS variables resolver
+ * - Mantine notification adapter (wired into NotificationProvider automatically)
  *
- * Supports authkit and oauth modes. apiKey mode will throw until implemented.
+ * All auth, API, profile, organization, and initialization composition is
+ * delegated to ElevasisCoreProvider.
  *
  * @example Command-center (dogfooding)
  * ```tsx
  * <ElevasisUIProvider
  *   auth={{ mode: 'authkit', clientId: '...', redirectUri: '/auth-redirect' }}
- *   organizationId={currentWorkOSOrganizationId}
- *   isOrganizationReady={!!currentMembership}
  *   apiUrl={import.meta.env.VITE_API_SERVER}
  *   onError={handleApiError}
  *   queryClient={queryClient}
@@ -239,7 +295,7 @@ interface ElevasisServiceProviderProps {
  * </ElevasisUIProvider>
  * ```
  */
-declare function ElevasisUIProvider({ auth, theme, organizationId, queryClient, apiUrl, onError, isOrganizationReady, children }: ElevasisProviderProps): react_jsx_runtime.JSX.Element;
+declare function ElevasisUIProvider({ theme, children, ...coreProps }: ElevasisProviderProps): react_jsx_runtime.JSX.Element;
 /** @deprecated Use ElevasisUIProvider instead. Alias kept for backwards compatibility. */
 declare const ElevasisProvider: typeof ElevasisUIProvider;
 
@@ -250,21 +306,36 @@ declare const ElevasisProvider: typeof ElevasisUIProvider;
  * variables, set `data-elevasis-scheme`, or load fonts. Consumers that need
  * Elevasis theming should use `ElevasisProvider` (Mantine) instead.
  *
- * Composes: QueryClientProvider + auth provider + auth bridge.
- * When apiUrl is provided, also composes ApiClientProvider + ElevasisServiceProvider.
+ * When `apiUrl` is provided, composes the full provider stack:
+ *   QueryClientProvider -> AuthProvider -> ApiClientProvider ->
+ *   ElevasisServiceProvider -> ProfileProvider -> OrganizationProvider ->
+ *   NotificationProvider -> InitializationProvider
+ *
+ * The `notifications` prop wires a custom adapter (e.g. mantineNotificationAdapter)
+ * into the NotificationProvider. When omitted, the console fallback is used.
  *
  * @example Headless SDK consumer
  * ```tsx
  * <ElevasisCoreProvider
  *   auth={{ mode: 'authkit', clientId: '...', redirectUri: '/' }}
- *   theme={{ colorScheme: 'dark', preset: 'default' }}
  *   apiUrl="https://api.elevasis.com"
  * >
  *   <Dashboard />
  * </ElevasisCoreProvider>
  * ```
+ *
+ * @example With custom notification adapter
+ * ```tsx
+ * <ElevasisCoreProvider
+ *   auth={{ mode: 'authkit', clientId: '...', redirectUri: '/' }}
+ *   apiUrl="https://api.elevasis.com"
+ *   notifications={myNotificationAdapter}
+ * >
+ *   <Dashboard />
+ * </ElevasisCoreProvider>
+ * ```
  */
-declare function ElevasisCoreProvider({ auth, organizationId, queryClient, apiUrl, onError, isOrganizationReady, children }: ElevasisCoreProviderProps): react_jsx_runtime.JSX.Element;
+declare function ElevasisCoreProvider({ auth, queryClient, apiUrl, onError, notifications, children }: ElevasisCoreProviderProps): react_jsx_runtime.JSX.Element;
 
 /**
  * Hook to access the ElevasisServiceProvider context.
@@ -295,5 +366,19 @@ declare function useElevasisServices(): ElevasisServiceContextValue;
  */
 declare function ElevasisServiceProvider({ apiRequest, organizationId, isReady, children }: ElevasisServiceProviderProps): react_jsx_runtime.JSX.Element;
 
-export { ElevasisCoreProvider, ElevasisProvider, ElevasisServiceProvider, ElevasisUIProvider, useElevasisServices };
-export type { ApiKeyConfig, AuthConfig, AuthKitConfig, ElevasisCoreProviderProps, ElevasisCoreThemeConfig, ElevasisProviderProps, ElevasisServiceContextValue, ElevasisServiceProviderProps, ElevasisThemeConfig, ElevasisTokenOverrides, OAuthConfig, PresetName, WithSchemes };
+/**
+ * Mantine-backed notification adapter.
+ *
+ * Wraps `@mantine/notifications` with the same defaults as `notify.tsx`
+ * (`autoClose: 5000`, `position: 'top-right'`). The `apiError()` method
+ * replicates `showApiErrorNotification` behavior including retryAfter-based
+ * autoClose.
+ *
+ * Use this adapter in Command Center (Mantine-powered) consumers.
+ * Template consumers should omit the NotificationProvider and rely on the
+ * console fallback, or supply their own adapter.
+ */
+declare const mantineNotificationAdapter: NotificationAdapter;
+
+export { ElevasisCoreProvider, ElevasisProvider, ElevasisServiceProvider, ElevasisUIProvider, NotificationProvider, mantineNotificationAdapter, useElevasisServices, useNotificationAdapter };
+export type { ApiKeyConfig, AuthConfig, AuthKitConfig, ElevasisCoreProviderProps, ElevasisCoreThemeConfig, ElevasisProviderProps, ElevasisServiceContextValue, ElevasisServiceProviderProps, ElevasisThemeConfig, ElevasisTokenOverrides, NotificationAdapter, OAuthConfig, PresetName, WithSchemes };

package/dist/provider/index.js

@@ -1,8 +1,13 @@
-export { ElevasisProvider, ElevasisUIProvider } from '../chunk-B64YDSAY.js';
-export { ElevasisCoreProvider } from '../chunk-ZQVPUAGR.js';
-import '../chunk-GDV44UWF.js';
-export { ElevasisServiceProvider, useElevasisServices } from '../chunk-KA7LO7U5.js';
-import '../chunk-7AI5ZYJ4.js';
-import '../chunk-NIAVTSMB.js';
+export { ElevasisProvider, ElevasisUIProvider, mantineNotificationAdapter } from '../chunk-PCBXNHKY.js';
+export { ElevasisCoreProvider } from '../chunk-OLD3NQLI.js';
+import '../chunk-FLJXZ7YC.js';
+import '../chunk-BWCC6ZJC.js';
+export { NotificationProvider, useNotificationAdapter } from '../chunk-TIRMFDM4.js';
+import '../chunk-JVAZHVNV.js';
+import '../chunk-4VGWQ5AN.js';
 import '../chunk-QSVZP2NU.js';
+import '../chunk-QQOLC46E.js';
+import '../chunk-DD3CCMCZ.js';
+import '../chunk-4KAG5U7A.js';
+export { ElevasisServiceProvider, useElevasisServices } from '../chunk-KA7LO7U5.js';
 import '../chunk-7PLEQFHO.js';