@elevasis/ui 1.17.0 → 1.18.0

package/dist/provider/published.d.ts

@@ -1,14 +1,312 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+import { QueryClient } from '@tanstack/react-query';
+
+/** Framework-agnostic theme overrides bundled with a preset (fonts, radius, component styles). */
+interface FrameworkThemeOverrides {
+    fontFamily?: string;
+    defaultRadius?: string;
+    headings?: {
+        fontFamily?: string;
+        fontWeight?: string;
+    };
+    components?: Record<string, unknown>;
+}
+interface ThemePreset {
+    light: Required<ElevasisTokenOverrides>;
+    dark: Required<ElevasisTokenOverrides>;
+    /** Optional framework theme overrides bundled with this preset (fonts, radius, etc.). */
+    framework?: FrameworkThemeOverrides;
+    /**
+     * Subtitle font family — used for card names, section labels, and nav items.
+     * Sits between heading and body in the typographic hierarchy.
+     */
+    subtitleFontFamily?: string;
+    /** Google Fonts URLs to load when this preset is active. */
+    fontImports?: string[];
+    /** Display label for settings UI (e.g. "Tactical"). Built-in presets define this; custom presets must provide it. */
+    label?: string;
+    /** Short description for settings UI (e.g. "Tactical command center aesthetic"). */
+    description?: string;
+    /** Three representative hex colors for swatch display: [primary, dark-bg, light-bg]. */
+    colors?: [string, string, string];
+    /**
+     * Background layers rendered behind app content when this preset is active.
+     * Overridden by `theme.background` on the provider if both are set.
+     */
+    background?: ReactNode;
+    /**
+     * Loader element used in loading states when this preset is active.
+     * Overridden by `theme.loader` on the provider if both are set.
+     */
+    loader?: ReactNode;
+}
+type PresetName = 'default' | 'tactical' | 'regal' | 'cyber-volt' | 'aurora' | 'rose-gold' | 'midnight' | 'ember' | 'honey' | 'canopy' | 'slate' | 'cyber-strike' | 'cyber-punk' | 'cyber-void' | 'nirvana' | 'wave';
+
+interface ApiErrorDetails {
+    method: string;
+    statusCode: number;
+    requestId?: string;
+}
+
 /**
- * Published provider barrel for @elevasis/ui
+ * Pluggable notification adapter interface.
  *
- * Headless providers only -- no Mantine dependency.
- * ElevasisUIProvider (Mantine-dependent) is available via @repo/ui internally.
+ * Implement this to connect any notification library (Mantine, react-toastify, etc.)
+ * to the Elevasis UI hooks.
  */
-export { ElevasisCoreProvider } from './ElevasisCoreProvider';
-export { AppearanceProvider, useAppearance } from './AppearanceContext';
-export type { AppearanceConfig } from './AppearanceContext';
-export { ElevasisServiceProvider, useElevasisServices } from './ElevasisServiceContext';
-export { NotificationProvider, useNotificationAdapter } from './NotificationContext';
-export type { NotificationAdapter } from './NotificationContext';
-export type { AuthConfig, AuthKitConfig, ApiKeyConfig, ElevasisCoreProviderProps, ElevasisCoreThemeConfig, ElevasisTokenOverrides, WithSchemes, ElevasisServiceContextValue, ElevasisServiceProviderProps } from './types';
-//# sourceMappingURL=published.d.ts.map
+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 custom adapter for your notification library. ElevasisUIProvider
+ * wires the Mantine adapter automatically; template/test consumers can
+ * pass their own or omit for console output.
+ *
+ * When omitted, hooks fall back to the console adapter automatically.
+ *
+ * @example
+ * ```tsx
+ * import { NotificationProvider } from '@repo/ui/provider'
+ * import { myAdapter } from './my-adapter'
+ *
+ * <NotificationProvider adapter={myAdapter}>
+ *   <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;
+    dark?: T;
+};
+/**
+ * Theme token overrides. Each key maps 1:1 to a CSS variable.
+ * All optional — defaults come from Elevasis design system.
+ */
+interface ElevasisTokenOverrides {
+    primary?: string;
+    /** Text color that contrasts with `primary`. Defaults to '#fff'. */
+    primaryContrast?: string;
+    background?: string;
+    surface?: string;
+    surfaceHover?: string;
+    text?: string;
+    textDimmed?: string;
+    textSubtle?: string;
+    border?: string;
+    error?: string;
+    warning?: string;
+    success?: string;
+    glassBackground?: string;
+    glassBlur?: string;
+    shadow?: string;
+    cardShadow?: string;
+    durationFast?: string;
+    durationNormal?: string;
+    easing?: string;
+    /** Foreground text color for destructive/error buttons. Defaults to '#fff'. */
+    destructiveFg?: string;
+    /** Heading font family — used for titles, section headers. */
+    fontHeading?: string;
+    /** Body font family — used for general text. */
+    fontSans?: string;
+}
+/**
+ * Core theme config — Mantine-free.
+ * Used by ElevasisCoreProvider and as the base for ElevasisThemeConfig.
+ */
+interface ElevasisCoreThemeConfig {
+    /** Color scheme: 'light', 'dark', or 'auto'. Defaults to 'dark'. */
+    colorScheme?: 'light' | 'dark' | 'auto';
+    /** Named preset — bundles light/dark token defaults. Defaults to 'default'. Accepts built-in PresetName or custom preset key. */
+    preset?: PresetName | (string & {});
+    /**
+     * Semantic token overrides fed into CSS variables.
+     * Flat values apply to both schemes. `light`/`dark` nested values win over flat.
+     */
+    tokens?: WithSchemes<ElevasisTokenOverrides>;
+    /** Custom presets map — when provided, used instead of built-in presets. Typically `{ ...presets, ...customPresets }`. */
+    presets?: Record<string, ThemePreset>;
+}
+/**
+ * Auth configuration union.
+ * 'authkit' (WorkOS AuthKit) is the supported mode.
+ * 'apiKey' is defined for forward type compatibility but will throw at runtime.
+ */
+type AuthConfig = AuthKitConfig | ApiKeyConfig;
+interface AuthKitConfig {
+    mode: 'authkit';
+    clientId: string;
+    /** AuthKit API hostname. Defaults to 'api.workos.com'. */
+    apiHostname?: string;
+    /** Redirect URI after auth. */
+    redirectUri?: string;
+    /** Keep refresh tokens in localStorage. Defaults to false. */
+    devMode?: boolean;
+}
+/** Deferred -- will throw at runtime. */
+interface ApiKeyConfig {
+    mode: 'apiKey';
+    key: string;
+}
+interface ElevasisCoreProviderProps {
+    /** Auth configuration. Supports 'authkit' mode. */
+    auth: AuthConfig;
+    /**
+     * Elevasis core theme configuration (Mantine-free).
+     * Set `colorScheme` ('light', 'dark', 'auto') and override `tokens` (design tokens).
+     * Defaults: colorScheme='dark', Elevasis design system tokens.
+     */
+    theme?: ElevasisCoreThemeConfig;
+    /**
+     * @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 the full provider stack:
+     * ApiClientProvider + ElevasisServiceProvider + ProfileProvider +
+     * OrganizationProvider + NotificationProvider + InitializationProvider.
+     * When omitted, no service context is provided (theme-only mode).
+     */
+    apiUrl?: string;
+    /**
+     * Error callback for API responses with status >= 500.
+     * Only used when apiUrl is provided.
+     */
+    onError?: (endpoint: string, error: Error, details?: ApiErrorDetails) => void;
+    /**
+     * @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 a Mantine-backed adapter 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
+     * needs auth + API from this provider. Defaults to `true`.
+     */
+    injectStyles?: boolean;
+    children: ReactNode;
+}
+/**
+ * Service context value exposed by ElevasisServiceProvider.
+ * Provides a ready-to-use apiRequest function and organization state.
+ *
+ * For standalone usage (testing, embedding), use ElevasisServiceProvider directly.
+ * For standard SDK usage, ElevasisUIProvider composes this automatically when apiUrl is provided.
+ */
+interface ElevasisServiceContextValue {
+    apiRequest: <T>(endpoint: string, options?: RequestInit) => Promise<T>;
+    organizationId: string | null;
+    isReady: boolean;
+}
+interface ElevasisServiceProviderProps {
+    apiRequest: <T>(endpoint: string, options?: RequestInit) => Promise<T>;
+    organizationId: string | null;
+    isReady: boolean;
+    children: ReactNode;
+}
+
+/**
+ * Headless root provider for Elevasis-powered applications.
+ *
+ * Pure auth + API provider with no style side-effects. Does not inject CSS
+ * variables, set `data-elevasis-scheme`, or load fonts. Consumers that need
+ * Elevasis theming should use `ElevasisUIProvider` (Mantine) instead.
+ *
+ * When `apiUrl` is provided, composes the full provider stack:
+ *   QueryClientProvider -> AuthProvider -> ApiClientProvider ->
+ *   ProfileProvider -> OrganizationProvider -> ElevasisServiceProvider ->
+ *   NotificationProvider -> InitializationProvider
+ *
+ * @example Headless SDK consumer
+ * ```tsx
+ * <ElevasisCoreProvider
+ *   auth={{ mode: 'authkit', clientId: '...', redirectUri: '/' }}
+ *   apiUrl="https://api.elevasis.com"
+ * >
+ *   <Dashboard />
+ * </ElevasisCoreProvider>
+ * ```
+ */
+declare function ElevasisCoreProvider({ auth, queryClient, apiUrl, onError, notifications, children }: ElevasisCoreProviderProps): react_jsx_runtime.JSX.Element;
+
+interface AppearanceConfig {
+    /** Background layers rendered behind app content. Defaults to Elevasis background. */
+    background?: ReactNode;
+    /** Loader element rendered during loading states. Defaults to Elevasis chevron loader. */
+    loader?: ReactNode;
+}
+declare function AppearanceProvider({ value, children }: {
+    value: Required<AppearanceConfig>;
+    children: ReactNode;
+}): react_jsx_runtime.JSX.Element;
+declare function useAppearance(): Required<AppearanceConfig>;
+
+/**
+ * Hook to access the ElevasisServiceProvider context.
+ * Provides apiRequest, organizationId, and isReady.
+ *
+ * Throws if used outside of an ElevasisServiceProvider or ElevasisUIProvider (with apiUrl).
+ */
+declare function useElevasisServices(): ElevasisServiceContextValue;
+/**
+ * Standalone service provider for testing, embedding, or advanced consumers.
+ *
+ * Accepts apiRequest, organizationId, and isReady directly as props.
+ * ElevasisUIProvider composes this internally when apiUrl is provided.
+ *
+ * @example Testing
+ * ```tsx
+ * <ElevasisServiceProvider apiRequest={mockApiRequest} organizationId="org-1" isReady={true}>
+ *   <ComponentUnderTest />
+ * </ElevasisServiceProvider>
+ * ```
+ *
+ * @example Embedding
+ * ```tsx
+ * <ElevasisServiceProvider apiRequest={myFetcher} organizationId={orgId} isReady={!!orgId}>
+ *   <CommandQueuePanel />
+ * </ElevasisServiceProvider>
+ * ```
+ */
+declare function ElevasisServiceProvider({ apiRequest, organizationId, isReady, children }: ElevasisServiceProviderProps): react_jsx_runtime.JSX.Element;
+
+export { AppearanceProvider, ElevasisCoreProvider, ElevasisServiceProvider, NotificationProvider, useAppearance, useElevasisServices, useNotificationAdapter };
+export type { ApiKeyConfig, AppearanceConfig, AuthConfig, AuthKitConfig, ElevasisCoreProviderProps, ElevasisCoreThemeConfig, ElevasisServiceContextValue, ElevasisServiceProviderProps, ElevasisTokenOverrides, NotificationAdapter, WithSchemes };

package/dist/provider/published.js

@@ -1,8 +1,8 @@
-export { ElevasisCoreProvider, NotificationProvider, useNotificationAdapter } from '../chunk-53GNREDV.js';
+export { ElevasisCoreProvider, NotificationProvider, useNotificationAdapter } from '../chunk-UANJP5P7.js';
 export { AppearanceProvider, useAppearance } from '../chunk-QJ2KCHKX.js';
 import '../chunk-U2522LSW.js';
-import '../chunk-RULQSZYX.js';
-import '../chunk-FCFLBMVI.js';
+import '../chunk-JNBHUCKW.js';
+import '../chunk-MBZDE6UT.js';
 import '../chunk-DVKEEY5J.js';
 export { ElevasisServiceProvider, useElevasisServices } from '../chunk-QEPXAWE2.js';
 import '../chunk-DD3CCMCZ.js';