openalice-ui

Shared error message helpers for API hooks — extracts user-facing message from ApiRequestError, generic Error, or unknown, and strips bearer tokens / auth credentials before display.

Tiny generic helper that owns {data, loading, error} for an async fetch — collapses three useStates into one.

Verify the current session against /auth/me on mount. On 401 or missing token, clear auth + redirect to /login. Returns the authenticated user once verified.

Fetch billing status + plans, expose changePlan against the active OpenAliceClient.

List/create/delete API keys against the active OpenAliceClient. Exposes newKey + clearNewKey for one-shot reveal.

Returns an async (email, password) → AuthActionResult that drives AuthProvider.login + sets the SSO sessionStorage flag. Translates RateLimitError into a UI-friendly message with retryAfter seconds.

Returns an async () → void that drives AuthProvider.logout, then clears the SSO sessionStorage flag. Errors during logout are swallowed — local state is cleared regardless.

Fetch the currently authenticated PublicUser from the active OpenAliceClient and expose loading/error/refetch.

Returns an async (name, email, password, _confirm?) → AuthActionResult that drives AuthProvider.register + sets the SSO sessionStorage flag. Translates RateLimitError into a UI-friendly message.

Fetch usage rollup for the last N days from the active OpenAliceClient.

Legacy adapter — fetch the current User (legacy shape) from the active OpenAliceClient. Prefer useMe() for new code.

Client-side route guard — renders skeleton until auth resolves, redirects to /login if unauthenticated.

Shared React context for cross-domain SSO — JWT in localStorage, HttpOnly cookie probe, cross-tab sync.

Hook that opens a WebSocket to /auth/ws while the user is signed in, dispatches each incoming event envelope to a handler, and reconnects with exponential backoff on disconnect.

Centered auth-page layout — atmospheric grain + halo, brand mark, card, footer.

OpenAlice wordmark / monogram — SVG, crisp at any size.

Responsive auto-fit grid for stat / card lists.

Pulsing chip for live/recording state. Plasma cyan or warm red tone.

Standard page title + description + actions row.

Sub-section title row (h2-weight) inside a page.

Left-nav + main-content layout for settings/account pages.

Sets data-theme on document root, persists to localStorage, optional system mode.

Circular avatar with image fallback to initials and optional ring.

Chip / tag — 2px radius, hairline ring, semantic + brand variants.

Full-width persistent message with left-edge accent and optional dismiss.

Chevron-separated path navigation. Last item is current page.

Tactile button primitive — five variants, three sizes, loading state, spring press.

Surface card with hairline border. Optional hover-lift via `interactive`.

Square checkbox with smooth check animation, native semantics, validators.

Searchable typeahead select. Custom filter, keyboard nav, validators.

Clipboard copy with success-state animation.

Compositional dialog API on top of Modal — header, title, description, footer slots.

Compound dropdown menu — trigger / content / item / separator / label, click-outside + ESC close.

Centered empty-state panel — icon/illustration slot, title, body, optional CTA.

Composes Label + control + helper/error + optional validators. Universal form row.

Hairline text input — supports validators, helper text, icon slots, monospace mode.

Keyboard-shortcut chip. Multi-key combos via `combo` (string) or `keys` (array).

Semantic form label with required-star slot.

Centered dialog primitive — focus trap, ESC, scroll-lock, glass backdrop with grain.

Page-number navigator with prev/next + ellipsis.

Bar progress — determinate (0-100) or indeterminate sliding bar.

Radio button group with native semantics + Atelier styling + validators.

Scrollable container with Atelier scrollbar styling.

Headless select with keyboard nav, click-outside close, and validators.

Hairline horizontal/vertical divider with optional decorative gradient variant.

Loading placeholder with warm shimmer.

Range slider — native input semantics, brand-500 fill, focus ring.

Indeterminate circular loader. Matches button sizes for inline use.

Pill toggle. Solar amber active state, hairline ring, native checkbox semantics.

Hairline-underline tabs with keyboard arrow nav.

Multi-line text input with auto-resize, char count, and validators.

Hover hint with 4-position support, configurable delay, hairline border.

Cmd+K / Ctrl+K command palette — modal overlay with fuzzy filter over a flat list of commands. Mounted by EcosystemShell so every product gets the same shortcut surface.

Persistent cross-product chrome — left sidebar with product switcher, top bar with account chip. Wraps each product's layout so the 5 products feel like one app.