@cboxdk/cbox-ui 0.8.0 → 0.10.0

package/dist/index.d.ts

@@ -1,5 +1,8 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { ReactNode, ComponentProps, ComponentType } from 'react';
+import * as react from 'react';
+import { ReactNode, ComponentType, AnchorHTMLAttributes, ComponentProps } from 'react';
+import { C as CboxThemeMode, a as CboxKnownApp } from './catalog-BroZWvws.js';
+export { b as CboxAppCatalogState, c as CboxCatalogApp, d as authorizeHref, p as parseAppCatalog, r as readKnownAppCatalog, e as rememberAppCatalog, s as secureIconUrl, f as signInTarget } from './catalog-BroZWvws.js';
 import { LucideIcon } from 'lucide-react';
 import { ClassValue } from 'clsx';
 export { T as TimePoint, n as niceTicks, t as timeTicks } from './scale-BaaY5qJs.js';
@@ -205,176 +208,460 @@ declare function useCboxId(): CboxIdContextValue;
  */
 declare function useCboxIdOptional(): CboxIdContextValue | null;
 
-type Props$7 = ComponentProps<'main'> & {
+type CboxTranslationValues = Record<string, string | number>;
+type CboxTranslator = (message: string, values?: CboxTranslationValues) => string;
+declare function interpolate(message: string, values?: CboxTranslationValues): string;
+/** Optional and additive: without a provider existing consumers retain English. */
+declare function CboxLocalizationProvider({ locale, translate, formatDate, children }: {
+    locale: string;
+    translate: CboxTranslator;
+    formatDate?: (value: string) => string;
     children: ReactNode;
+}): react_jsx_runtime.JSX.Element;
+declare function useCboxLocalization(): {
+    locale: string;
+    t: CboxTranslator;
+    formatDate: (value: string) => string;
 };
+
 /**
- * Scrolling main column inside an <AppShell>. Wears the soft blue-
- * tinted gradient canvas so every Cbox app sits on the same
- * background.
+ * Help's state lives outside React (§7.1): open or closed, what it shows, the search, the scroll
+ * position and the support updates survive an Inertia visit and even a remount of the shell,
+ * like a browser side panel. The conversation itself lives in the `<cbox-support>` element, which
+ * survives as long as the shell sits in the host's persistent layout.
  */
-declare function AppContent({ children, className, ...props }: Props$7): react_jsx_runtime.JSX.Element;
+type HelpArticle = {
+    id: string;
+    title: string;
+    excerpt?: string;
+    body?: string;
+    url?: string;
+    source?: string;
+};
+type SupportUpdate = {
+    id: string;
+    kind: 'ticket' | 'chat';
+    title: string;
+    excerpt?: string;
+    at?: string;
+    unread: boolean;
+    url?: string;
+};
+type HelpStatus = 'idle' | 'loading' | 'ready' | 'unavailable';
+type HelpState = {
+    open: boolean;
+    /** The article shown instead of the home view, or null. */
+    article: HelpArticle | null;
+    query: string;
+    scrollTop: number;
+    updates: SupportUpdate[];
+    updatesStatus: HelpStatus;
+    /** A question waiting for the chat to be ready ("Ask Cbox: …" from the palette). */
+    pendingQuestion: string | null;
+    /** Whether `open` was taken from the person's saved preference yet. */
+    seeded: boolean;
+    /**
+     * `open` came from the saved preference, not from the person on this page. Help left open
+     * shows docked from 1280px; below that it waits until the person opens it, so a phone or a
+     * narrow window never lands under the full-screen overlay.
+     */
+    restored: boolean;
+    /** Which list the support updates came from (URL and organization), so a switch reloads them. */
+    updatesKey: string | null;
+};
+type HelpStore = {
+    get(): HelpState;
+    set(patch: Partial<HelpState> | ((state: HelpState) => Partial<HelpState>)): void;
+    subscribe(listener: () => void): () => void;
+};
+declare function createHelpStore(initial?: Partial<HelpState>): HelpStore;
+
+type ShellIcon = ComponentType<{
+    size?: number;
+    strokeWidth?: number;
+    className?: string;
+    'aria-hidden'?: boolean;
+}>;
+/** Lucide names an app can use for areas, pages and actions without shipping its own map. */
+declare const SHELL_ICONS: Readonly<Record<string, ShellIcon>>;
 
 /**
- * Top-level chrome. Hosts the desktop sidebar (left) and the
- * scrollable content column (right) side-by-side. Fits the full
- * viewport height; only the content column scrolls.
+ * The `shell` Inertia prop: the one data contract every Cbox app shares (spec §11.1).
  *
- * Pair with <AppContent> inside. Per-app sidebars compose alongside
- * — cbox-ui doesn't ship one because the nav items are app-specific.
+ * The server (laravel-console-kit) produces it; `<CboxShell>` renders it. It carries only the
+ * current selection and URLs. Lists, the app catalog, help and search load in the browser after
+ * the page has painted, so building this prop never calls another service (local first, §11.2a).
  */
-declare function AppShell({ children }: {
-    children: ReactNode;
-}): react_jsx_runtime.JSX.Element;
-
-type CboxNavItem = {
+/** The product key (URL standard §1). Unknown keys are allowed so a new app needs no release here. */
+type AppKey = 'id' | 'billing' | 'telemetry' | 'work' | 'brain' | 'infra' | 'engage' | 'assistant' | 'sites' | 'stache' | 'status' | 'tax' | 'signals' | 'domains' | (string & {});
+type Link = {
     label: string;
-    /**
-     * Absolute path the host's router can navigate to. Apps that
-     * scope nav by org slug should compose the path themselves
-     * (`/org/${slug}/endpoints`) before passing it in — cbox-ui
-     * stays unaware of routing conventions.
-     */
-    href: string;
-    icon: ComponentType<{
-        className?: string;
-        strokeWidth?: number;
-    }>;
-    /** Highlight the row for child routes too (`/endpoints/123`
-     *  matches the `Endpoints` row when this is true). */
-    matchPrefix?: boolean;
+    url: string;
 };
-type CboxNavSection = {
+/** One page inside an area. `icon` is a Lucide icon name (`"git-branch"`), resolved by the shell. */
+type NavPage = {
+    key: string;
     label: string;
-    items: CboxNavItem[];
+    url: string;
+    icon?: string;
 };
-/**
- * Generic Link contract — apps inject their own (Inertia's `Link`,
- * Wouter, React Router, plain `<a>`). cbox-ui doesn't depend on
- * any router so the same chrome works everywhere.
- */
-type LinkComponent = ComponentType<{
-    href: string;
-    prefetch?: boolean;
-    children: ReactNode;
-    className?: string;
-    title?: string;
-    'aria-label'?: string;
-    /** Set on the link of the page the person is on. */
-    'aria-current'?: 'page';
-}>;
-type CboxAppSidebarProps = {
-    /** App key for the brand submark (and aria labels). */
-    appKey: string;
-    /** Optional override for the submark — defaults to `appKey`. */
-    brandSubmark?: string | null;
-    /** Where brand assets live. Default `/brand`. */
-    assetBase?: string;
-    /** Where the brand row links to (typically the app's home). */
-    brandHref?: string;
-    /** Nav sections — top to bottom. */
-    sections: CboxNavSection[];
-    /** Active path — used to highlight the current row. */
-    currentPath: string;
-    /** Apps inject their router's Link primitive. */
-    LinkComponent: LinkComponent;
-    /** Persisted "is the desktop sidebar collapsed?" state. */
-    collapsed?: boolean;
-    className?: string;
+/** One area in the rail. The subnav shows its pages when it has more than one. */
+type NavArea = {
+    key: string;
+    label: string;
+    url: string;
+    icon?: string;
+    pages?: NavPage[];
 };
+type ContextTone = 'production' | 'sandbox' | 'neutral';
 /**
- * Standard Cbox sidebar. Every app wears this — the only variable
- * bits are `sections` (per-app nav) and `appKey` (drives the brand
- * submark).
- *
- * Hidden below `lg` — apps render a separate mobile drawer that
- * shares the same `sections` config.
- *
- * No app should ship its own sidebar component. The chrome is the
- * shape; nav items are the data.
+ * One selectable item of a level: the current one in the prop, and every row a level's
+ * `listUrl` returns. Environments are app-defined (§5.1a): `tone`, `label` and `testData` are
+ * all optional and the shell never sorts the items.
  */
-declare function CboxAppSidebar({ appKey, brandSubmark, assetBase, brandHref, sections, currentPath, LinkComponent, collapsed, className, }: CboxAppSidebarProps): react_jsx_runtime.JSX.Element;
-
-type CboxAppShellProps = {
-    /** App key — drives the brand submark + aria labels. */
-    appKey: string;
-    /** Override the submark text (defaults to appKey). */
-    brandSubmark?: string | null;
-    /** Asset base for brand pngs. Default `/brand`. */
-    assetBase?: string;
-    /** Brand row href (typically the app's home). */
-    brandHref?: string;
-    /** Sidebar nav config. */
-    sections: CboxNavSection[];
-    /** Active path — used by both sidebar (highlight) and topbar
-     *  (sidebar-collapse toggle aria state). */
-    currentPath: string;
-    /** Apps inject their router's Link primitive. */
-    LinkComponent: LinkComponent;
-    /** Persisted "sidebar collapsed?" state — owned by the host
-     *  (the cookie hook lives there). */
-    sidebarCollapsed?: boolean;
-    /** Click handler for the topbar collapse toggle. Hide the
-     *  toggle entirely by omitting this prop. */
-    onToggleSidebar?: () => void;
+type ContextItem = {
+    id: string;
+    name: string;
+    /** Chip text. Defaults to the first letters of the name. */
+    initials?: string;
+    /** The coloured square: production green, sandbox amber, neutral grey. */
+    tone?: ContextTone;
+    /** Short app-defined label beside the name ("default", "test data"). */
+    label?: string;
+    /** The sandbox strip shows while the current item has test data. */
+    testData?: boolean;
+};
+type ContextLevel = {
+    /** `organization`, `project`, `environment`, or the app's own key (`site`, `space`). */
+    key: 'organization' | 'project' | 'environment' | (string & {});
+    /** Singular, as the app names it: "Organization", "Site", "Space", "Environment". */
+    label: string;
+    /** Plural for headings ("Organizations"). Defaults to `label` + "s". */
+    labelPlural?: string;
+    current: ContextItem;
     /**
-     * Topbar centre slot — typically the org switcher / context
-     * bar. Apps that aren't org-scoped (notifications, account
-     * pages) leave this off.
+     * Lazy JSON list, fetched when a menu opens: `GET listUrl?q=&parent=&cursor=&limit=` answering
+     * `{ data: ContextItem[], has_more: boolean, next_cursor: string | null }`.
      */
-    topbarCentre?: ReactNode;
+    listUrl: string;
+    /** `POST createUrl { name, parent? }` answering `{ id, detailsUrl }`. Absent: no "New …". */
+    createUrl?: string;
+    /** "View all". */
+    allUrl: string;
     /**
-     * Handler to open the in-app command palette / search UI.
-     * Always rendered — when omitted the trigger is a no-op so the
-     * chrome stays visually identical across all apps regardless of
-     * whether a palette has been wired up yet.
+     * Settings page of one item, as a URL template on the wire: `{id}` is replaced with the
+     * item's id (`/orgs/{id}/settings`). Absent: no gear.
      */
-    onSearchOpen?: () => void;
+    settingsUrl?: string;
+};
+type PaletteAction = {
+    id: string;
+    label: string;
+    url: string;
+    /** `post` for actions that change something. Default `get`. */
+    method?: 'get' | 'post';
+    icon?: string;
+    /** Extra words the palette matches on. */
+    keywords?: string[];
+};
+type ShellHelp = {
+    /** False: Help still renders, and says it is not available here. */
+    enabled: boolean;
+    /** The page's help topic key (§7.2.3). */
+    topic?: string;
+    /** Same-origin route the Assistant SDK's `<cbox-support>` element fetches its session from. */
+    sessionUrl?: string;
+    /** Where the SDK script is served. Default `/ai-assistant/support.js` (laravel-assistant-client). */
+    scriptUrl?: string;
+    /** The support portal. Absent or offline: the link is hidden. */
+    portalUrl?: string;
+    /** `GET` support updates; `POST {updatesUrl}/{id}/read` marks one read. */
+    updatesUrl?: string;
+    /** `GET ?q=&topic=` docs, help centre and knowledge base search. */
+    searchUrl?: string;
+    /** Articles for a topic, as a template: `{topic}` is replaced. */
+    articlesUrl?: string;
+};
+type ShellNotifications = {
+    enabled: false;
+} | {
+    enabled: true;
+    unread: number;
+    url: string;
+};
+type ShellBanner = {
+    kind: 'sandbox' | 'impersonation' | 'notice';
+    text: string;
+    action?: Link;
+};
+type ShellTheme = 'system' | 'light' | 'dark';
+type ShellPreferences = {
+    theme: ShellTheme;
+    locale: string;
+    railPinned: boolean;
+    helpOpen: boolean;
+    /** The subnav collapsed to its strip (⌘.). */
+    subnavCollapsed?: boolean;
+    /** Regional format (a BCP 47 locale for dates and numbers), from Cbox ID's preferences. */
+    regionalFormat?: string;
+    /** IANA time zone, from Cbox ID's preferences. */
+    timeZone?: string;
+};
+type ShellOption = {
+    code: string;
+    label: string;
+};
+/** What the account menu (§10) links to. */
+type ShellAccount = {
+    /** Profile and security, in Cbox ID. */
+    profileUrl: string;
+    switchAccountUrl: string;
+    signOutUrl: string;
+    /** Default `post`. */
+    signOutMethod?: 'get' | 'post';
+    /** Languages the app is translated into. */
+    languages?: ShellOption[];
+    /** Regional formats offered. Defaults to a short list. */
+    formats?: ShellOption[];
+    /** Line under the name in the account menu. Default "Signed in with Cbox ID". */
+    signedInWith?: string;
+};
+type Shell = {
+    app: {
+        key: AppKey;
+        name: string;
+        homeUrl: string;
+    };
+    person: {
+        id: string;
+        name: string;
+        initials: string;
+        avatarUrl?: string;
+        email?: string;
+    };
+    /** The page title and route, for "On this page" and the chat's page intent. */
+    page?: {
+        title: string;
+        route?: string;
+    };
+    nav: {
+        areas: NavArea[];
+        activeArea: string;
+        activePage?: string;
+    };
+    context: {
+        /** 1–3, in order. The first is the organization. */
+        levels: ContextLevel[];
+        /** `POST` target; the server resolves same-page or list fallback (§5.6). */
+        switchUrl: string;
+    };
+    palette: {
+        /** `GET ?q=` → `{ data: [{ id, title, subtitle?, url }] }`, in the current context. */
+        searchUrl?: string;
+        /** `GET ?q=` → level 2/3 combinations across organizations (§6.1.4). */
+        gotoUrl?: string;
+        actions: PaletteAction[];
+    };
+    help: ShellHelp;
+    notifications: ShellNotifications;
+    apps: {
+        /** The host's catalog endpoint (laravel-id-client `CboxId::appCatalogRoutes()`). */
+        catalogUrl: string;
+        /** "All products ↗". Default https://cbox.dk. */
+        productsUrl?: string;
+    };
+    account: ShellAccount;
+    banner?: ShellBanner;
+    preferences: ShellPreferences;
+};
+/** How the shell moves the person. An Inertia host passes `router.visit`. */
+type ShellNavigate = (url: string, options?: {
+    method?: 'get' | 'post';
+    data?: Record<string, unknown>;
+    newTab?: boolean;
+}) => void;
+/** Where the shell reports a preference the person changed, for the host to persist. */
+type ShellPreferenceChange = <K extends keyof ShellPreferences>(key: K, value: ShellPreferences[K]) => void;
+
+/** A client-side link (Inertia's `Link`). Receives `href`, `className`, `children` and ARIA props. */
+type ShellLinkComponent = ComponentType<AnchorHTMLAttributes<HTMLAnchorElement> & {
+    href: string;
+    children?: ReactNode;
+}>;
+/** Which overlay is open. Only one at a time, so two menus never stack. */
+type ShellOverlay = 'org' | 'context' | 'apps' | 'account' | 'palette' | 'nav-sheet' | 'context-sheet' | null;
+type ShellApi = {
+    shell: Shell;
+    t: CboxTranslator;
+    navigate: ShellNavigate;
+    Link: ShellLinkComponent;
+    icons: Readonly<Record<string, ShellIcon>>;
+    preferences: ShellPreferences;
+    setPreference: ShellPreferenceChange;
+    overlay: ShellOverlay;
+    setOverlay: (overlay: ShellOverlay) => void;
+    help: HelpStore;
+    /** Open or close Help. */
+    toggleHelp: (open?: boolean) => void;
+    /** Open Help on an article. */
+    openArticle: (article: HelpArticle) => void;
+    /** Open Help and send a question to the chat with the page as context. */
+    ask: (question: string) => void;
+    /** Switch context: `chosen` maps level keys to ids. */
+    switchTo: (chosen: Record<string, string>) => void;
+};
+/** Help for a page's own `?` button, or `null` outside the shell. */
+declare function useShellHelp(): Pick<ShellApi, 'toggleHelp' | 'openArticle' | 'ask'> | null;
+
+type CboxShellProps = {
+    /** The shared `shell` prop. */
+    shell: Shell;
+    /** The page. */
+    children: ReactNode;
+    /** How to move the person. Inertia: `(url, o) => router.visit(url, { method: o?.method, data: o?.data })`, plus `window.open` for `newTab`. Default: page loads and form posts. */
+    navigate?: ShellNavigate;
+    /** Client-side link for nav and settings links (Inertia's `Link`). Default `<a>`. */
+    LinkComponent?: ShellLinkComponent;
+    /** Extra icons by name, on top of the built-in Lucide set. */
+    icons?: Readonly<Record<string, ShellIcon>>;
     /**
-     * Override the right cluster on the topbar. Default:
-     * `[<SearchTrigger>?] <AppLauncher /> <NotificationsBell /> <UserMenu />`.
-     * Override only when an app needs a completely different mix.
+     * Called when the person changes a preference, for the host to persist (a cookie read before
+     * first paint, and Cbox ID's preferences for theme, language, format and time zone). Without
+     * it the shell writes a `cbox_shell_<key>` cookie.
      */
-    topbarRightCluster?: ReactNode;
-    children: ReactNode;
+    onPreferenceChange?: ShellPreferenceChange;
+    /** Help's state store. Default: one per page, so it outlives the shell's own remounts. */
+    helpStore?: HelpStore;
+    /** Where the Cbox wordmark is served. Default `/brand`. */
+    brandAssetBase?: string;
+    /** `id` of the `<main>` landmark for a skip link. Default `main-content`. */
+    mainId?: string;
 };
 /**
- * Top-level Cbox application shell. Composes sidebar + topbar +
- * content into the single chrome shape every Cbox app wears.
+ * Apply a theme choice to the document the way the tokens read it: `.dark` and `data-theme` on
+ * the root, with `system` following the device. The saved choice stays `system`; the device's
+ * scheme is never written back (cbox-design, shared preferences).
+ */
+declare function applyTheme(theme: ShellTheme): void;
+/**
+ * The inline script a host puts in `<head>` so the theme is right before the first paint
+ * (§12.1). `theme` is the person's saved choice from the `shell` prop.
+ */
+declare function themeBootScript(theme: ShellTheme): string;
+/**
+ * The one shell for every Cbox app (spec 2026-11-10 shell v1): rail with the account at the
+ * bottom, subnav, header with the context selectors, Search, Help, the bell when the app has a
+ * source, Switch app; the ⌘K palette; the Help column; and the phone layout.
  *
- * Apps reduce to ~30 lines of layout: define nav, render
- * `<CboxAppShell>{children}</CboxAppShell>`. No app should
- * compose `<AppShell>`/`<AppContent>`/sidebar/topbar manually —
- * drift is the whole reason this component exists.
+ * Render it in the host's persistent layout (Inertia `Page.layout`), so the rail, Help and the
+ * chat survive page visits; only `shell` and `children` change.
  */
-declare function CboxAppShell({ appKey, brandSubmark, assetBase, brandHref, sections, currentPath, LinkComponent, sidebarCollapsed, onToggleSidebar, topbarCentre, onSearchOpen, topbarRightCluster, children, }: CboxAppShellProps): react_jsx_runtime.JSX.Element;
+declare function CboxShell({ shell, children, navigate, LinkComponent, icons, onPreferenceChange, helpStore, brandAssetBase, mainId }: CboxShellProps): react_jsx_runtime.JSX.Element;
 
-type CboxMobileNavDrawerProps = {
-    open: boolean;
-    onClose: () => void;
-    appKey: string;
-    brandSubmark?: string | null;
-    assetBase?: string;
-    brandHref?: string;
-    sections: CboxNavSection[];
-    currentPath: string;
-    LinkComponent: LinkComponent;
+/** The page intent the chat is given (§7.2.4): route, title and context. */
+type PageIntent = {
+    route?: string;
+    title?: string;
+    context: string;
+    url?: string;
+};
+declare function contextTrail(shell: Shell): string;
+declare function pageIntent(shell: Shell): PageIntent;
+
+/** One app in the grid (§9). */
+type ShellApp = {
+    key: string;
+    name: string;
+    /** One line: "Identity and sign-in". */
+    purpose: string | null;
+    /** Fixed per-app hue (0–360); the tile is drawn in it, in light and dark. */
+    hue: number;
+    iconUrl: string | null;
+    iconDarkUrl: string | null;
+    /** Where the tile goes: the app, or its admission page when the organization lacks it. */
+    url: string;
+    /** The organization has this app. False: "More from Cbox", dimmed. */
+    inOrganization: boolean;
+};
+/** Each app's fixed hue when the catalog sends none. */
+declare const APP_HUES: Readonly<Record<string, number>>;
+/** A stable hue for an unknown key, so its tile keeps its colour between pages. */
+declare function hueFor(key: string, given?: unknown): number;
+type ShellCatalogState = {
+    status: 'loading';
+} | {
+    status: 'ready';
+    apps: ShellApp[];
+} | {
+    status: 'signin_required';
+    href: string | null;
+} | {
+    status: 'unavailable';
 };
 /**
- * Mobile-only slide-in sidebar. Hidden on `lg` and up — there the
- * desktop `CboxAppSidebar` is always visible. Shares the same
- * `sections` shape as the desktop sidebar so apps don't have to
- * maintain two nav configs.
- *
- * State (open/close) lives in `CboxAppShell` so it can wire the
- * hamburger button + auto-close on `currentPath` change. The drawer
- * itself just renders; it doesn't track anything.
+ * The catalog answer, with the shell's additions (§9.3): `in_organization` (default true),
+ * `admission_url` for apps the organization does not have, `purpose` (falls back to
+ * `description`) and `hue`. Only http(s) links are kept.
+ */
+declare function parseShellCatalog(ok: boolean, body: unknown, here?: {
+    origin: string;
+    pathname: string;
+    search: string;
+}): ShellCatalogState;
+
+/**
+ * The shell's few network shapes and the pure rules around them: list pages, inline create,
+ * the switch payload and settings links. Everything here is same-origin and JSON.
+ */
+type ListPage = {
+    items: ContextItem[];
+    hasMore: boolean;
+    nextCursor: string | null;
+};
+/** First letters of the first two words, for a chip. */
+declare function initialsOf(name: string): string;
+/**
+ * A list answer. The URL standard's envelope (`{ object: 'list', data, has_more, next_cursor }`)
+ * and a bare array are both accepted; rows without an id and a name are dropped.
+ */
+declare function parseListPage(body: unknown): ListPage;
+/** `url` with query parameters added; empty values are left out. Works for relative URLs. */
+declare function withQuery(url: string, params: Record<string, string | undefined | null>): string;
+/** The settings link of one item, from the level's URL template. Null when the level has none. */
+declare function settingsHref(level: Pick<ContextLevel, 'settingsUrl'>, id: string): string | null;
+/**
+ * Which environment a project click lands on (§5.4): the one with the current environment's
+ * name when the project has it, else its first. Undefined when the project has none.
+ */
+declare function environmentFor(environments: readonly ContextItem[], currentName: string | undefined): ContextItem | undefined;
+/**
+ * The switch payload (§5.6): every level above the chosen one keeps its current id, the chosen
+ * levels get theirs, and levels below are left to the server (it lands on the last used one).
+ * `return_to` is where the person is, so the server can stay on the same page.
+ */
+declare function switchPayload(levels: readonly ContextLevel[], chosen: Record<string, string>, returnTo: string): Record<string, string>;
+
+type Props$2 = ComponentProps<'main'> & {
+    children: ReactNode;
+};
+/**
+ * Scrolling main column inside an <AppShell>. Wears the soft blue-
+ * tinted gradient canvas so every Cbox app sits on the same
+ * background.
+ */
+declare function AppContent({ children, className, ...props }: Props$2): react_jsx_runtime.JSX.Element;
+
+/**
+ * Top-level chrome. Hosts the desktop sidebar (left) and the
+ * scrollable content column (right) side-by-side. Fits the full
+ * viewport height; only the content column scrolls.
  *
- * Closes on: Escape, scrim click, navigation (parent unsets `open`
- * when `currentPath` changes). Locks body scroll while open so the
- * page underneath doesn't scroll on touch.
+ * Pair with <AppContent> inside. Per-app sidebars compose alongside
+ * — cbox-ui doesn't ship one because the nav items are app-specific.
  */
-declare function CboxMobileNavDrawer({ open, onClose, appKey, brandSubmark, assetBase, brandHref, sections, currentPath, LinkComponent, }: CboxMobileNavDrawerProps): react_jsx_runtime.JSX.Element;
+declare function AppShell({ children }: {
+    children: ReactNode;
+}): react_jsx_runtime.JSX.Element;
 
 type CboxBrandProps = {
     /**
@@ -413,119 +700,6 @@ type CboxBrandProps = {
  */
 declare function CboxBrand({ appKey, submark, assetBase, tone, collapsed, className, }: CboxBrandProps): react_jsx_runtime.JSX.Element;
 
-type CboxOrgContextBarProps = {
-    /**
-     * Apps inject their router's Link primitive — used for the
-     * crumb's brand-side anchor. The dropdown's onSelect calls
-     * `onNavigate(href)` so apps can either `router.visit(href)`
-     * (Inertia) or `<Link>`-style navigate.
-     */
-    LinkComponent: LinkComponent;
-    /**
-     * Called when the user picks a different org from the dropdown.
-     * Receives an absolute path with the slug substituted in. Apps
-     * trigger their router.
-     *
-     * Path-rewrite rule (Cbox suite convention):
-     *   /org/<old-slug>/foo/bar  →  /org/<new-slug>/foo/bar
-     *   /something-else          →  /org/<new-slug>
-     *
-     * Apps that aren't org-scoped (notifications) typically don't
-     * render this component at all — but if they do, switching
-     * lands on the new org's `/org/<slug>` root and lets the host
-     * sort the rest out.
-     */
-    onNavigate: (href: string) => void;
-};
-/**
- * Standard Cbox topbar org switcher. One crumb, one dropdown,
- * URL-driven (no POST, no session pin). Mirrors id's pattern 1:1
- * so the chrome reads identically across the suite — that's the
- * whole reason it's here, not in each app.
- *
- * Apps render this in the `topbarCentre` slot of `CboxAppShell`.
- * Hides itself when there's no current org (eg pre-auth, or
- * non-org-scoped surfaces).
- */
-declare function CboxOrgContextBar({ LinkComponent, onNavigate, }: CboxOrgContextBarProps): react_jsx_runtime.JSX.Element | null;
-
-type Props$6 = {
-    /**
-     * App branding rendered on the left — typically a small logo +
-     * the app name. Rendered inside a fixed-height bar so keep it
-     * visually compact (24-32px tall content).
-     */
-    brand: ReactNode;
-    /** Anything between brand and the right cluster — search, breadcrumbs, etc. */
-    centre?: ReactNode;
-    /**
-     * Override slots if an app needs a different control mix in the
-     * right cluster. Default: AppLauncher → NotificationsBell → UserMenu.
-     */
-    rightCluster?: ReactNode;
-    /**
-     * Whether to show the org switcher next to the brand. Hide on
-     * non-org-scoped surfaces (eg id account-settings).
-     */
-    showOrgSwitcher?: boolean;
-    className?: string;
-};
-/**
- * Standard Cbox top bar. Same shell across every app — keeps cross-app
- * navigation (launcher, account, notifications) muscle-memory-stable.
- */
-declare function TopBar({ brand, centre, rightCluster, showOrgSwitcher, className, }: Props$6): react_jsx_runtime.JSX.Element;
-
-type AppLauncherProps = {
-    className?: string;
-    /**
-     * Called when the user clicks an app they're not entitled to. Use
-     * this to open an upgrade flow / Stripe checkout / Intercom message.
-     * If unset, locked tiles fall through to a static "Add to plan"
-     * affordance — the click is a no-op so we never silently ship the
-     * user to a broken paywall.
-     */
-    onLockedAppClick?: (app: CboxAppLink) => void;
-};
-/**
- * Cross-app launcher — the 9-dot button in the top bar.
- *
- * Renders the Cbox suite as a vertical list with status per app:
- *   - entitled apps   → full-colour tile, click navigates with ?org=<slug>
- *   - locked apps     → greyed out + lock badge, opens upgrade flow if the
- *                       host app provides one (otherwise inert click)
- *   - coming-soon     → greyed out + "soon" badge, never clickable
- *   - the current app → highlighted ring on its monogram tile
- *
- * Row layout (vs. the old 3-col grid) gives us room for descriptions
- * and status badges, which makes the entitlement signal readable at a
- * glance instead of needing a tooltip.
- */
-declare function AppLauncher({ className, onLockedAppClick }: AppLauncherProps): react_jsx_runtime.JSX.Element | null;
-
-/** One app as the host's catalog endpoint lists it. */
-type CboxCatalogApp = {
-    key: string;
-    name: string;
-    launch_url: string;
-    /** Cbox ID's uploaded icon for light surfaces. */
-    icon_url?: string | null;
-    /** Cbox ID's uploaded icon for dark surfaces. */
-    icon_dark_url?: string | null;
-    description?: string | null;
-};
-type CboxAppCatalogState = {
-    status: 'idle' | 'loading';
-} | {
-    status: 'ready';
-    apps: CboxCatalogApp[];
-    refreshAfter: number;
-} | {
-    status: 'authorization_required';
-    authorizeUrl: string | null;
-} | {
-    status: 'unavailable';
-};
 type CboxAppCatalogProps = {
     /**
      * Same-origin URL the host serves the person's app catalog from (a proxy of Cbox ID's
@@ -533,59 +707,31 @@ type CboxAppCatalogProps = {
      * chrome keeps its shape on pages without an organization.
      */
     endpoint: string | null;
-    /** The app key of this app; its tile is marked current and does not navigate. */
+    /** The app key of this app; its tile is marked current. */
     currentAppKey: string;
+    /**
+     * How the theme is read. Default `auto`: `.dark`/`[data-theme]` on the root, else the
+     * system scheme. `class` for a host whose tokens only turn dark under `.dark`.
+     */
+    theme?: CboxThemeMode;
     className?: string;
 };
 /**
- * Interpret the catalog endpoint's answer. The contract every Cbox app serves:
- *
- * - `200 { apps: [{ key, name, launch_url, icon_url?, icon_dark_url?, description? }], refresh_after?: seconds }`
- * - `401`/`403 { authorize_url?: string }` or `{ state: 'authorization_required' }`: the
- *   person has to (re)connect their catalog grant; `authorize_url` is where.
- * - anything else: unavailable right now.
- *
- * Only `http(s)` launch URLs are kept: the tiles are links the person will click.
- */
-declare function parseAppCatalog(ok: boolean, body: unknown): CboxAppCatalogState;
-/** The authorize link with `return_to` set to where the person is, when it is on this origin. */
-declare function authorizeHref(authorizeUrl: string | null, location: {
-    origin: string;
-    pathname: string;
-    search: string;
-}): string | null;
-/**
- * The Switch-app control: a grid of the Cbox apps this person can open, read live from the
- * host's catalog endpoint. The host owns the endpoint and the grant; this renders the answer,
- * refreshes it when it expires while the panel is open, and offers the way back to Cbox ID
- * when the grant is missing. Each tile shows the app's icon from the catalog (light and dark),
- * and the answer is kept so `CboxServiceMark` paints the app's own mark from it.
+ * The Switch-app control. It renders `<cbox-app-switcher>` from `@cboxdk/cbox-ui/app-switcher`,
+ * the same element every Blade app uses, so React and Blade apps draw one identical control:
+ * the live catalog from the host's endpoint, Cbox ID's light and dark icons, a quiet retry when
+ * the catalog cannot be loaded, and straight to sign-in when the host answers `401 { signin_url }`.
  */
-declare function CboxAppCatalog({ endpoint, currentAppKey, className }: CboxAppCatalogProps): react_jsx_runtime.JSX.Element;
+declare function CboxAppCatalog({ endpoint, currentAppKey, theme, className }: CboxAppCatalogProps): react.ReactElement<{
+    endpoint: string;
+    current: string;
+    labels: string;
+    theme: CboxThemeMode | undefined;
+    className: string | undefined;
+}, string | react.JSXElementConstructor<any>>;
 
-/**
- * Every Cbox app's icon comes from Cbox ID's catalog: one light and one dark upload per app
- * (`icon_url`, `icon_dark_url`). There is no local copy of the marks in this package or in an
- * app. The last catalog the browser saw is kept here so an app's own mark and the switcher
- * paint at once on the next page; the live answer replaces it when it arrives.
- */
-type CboxKnownApp = {
-    key: string;
-    name: string;
-    icon_url: string | null;
-    icon_dark_url: string | null;
-};
-/** Keep the catalog the person just loaded, so every mark on this origin repaints from it. */
-declare function rememberAppCatalog(apps: ReadonlyArray<{
-    key: string;
-    name: string;
-    icon_url?: string | null;
-    icon_dark_url?: string | null;
-}>): void;
 /** The last catalog this browser kept; empty on the server and before the first answer. */
 declare function useKnownAppCatalog(): CboxKnownApp[];
-/** Only `https:` icon URLs are rendered: the icons are hosted by Cbox ID. */
-declare function secureIconUrl(url: unknown): string | null;
 type CboxAppIconProps = {
     /** The app's name; its first two letters stand in when it has no icon. */
     name: string;
@@ -616,126 +762,6 @@ type CboxServiceMarkProps = {
 /** An app's own mark (its rail or brand icon), read from the catalog this browser last kept. */
 declare function CboxServiceMark({ appKey, className, fallback }: CboxServiceMarkProps): react_jsx_runtime.JSX.Element;
 
-type AppSwitcherProps = {
-    className?: string;
-    /**
-     * Called when the user clicks an app they're not entitled to. Use
-     * this to open an upgrade flow / Stripe checkout / Intercom message.
-     * If unset, locked rows fall through to a static "Add to plan"
-     * affordance — the click is a no-op so we never silently ship the
-     * user to a broken paywall.
-     */
-    onLockedAppClick?: (app: CboxAppLink) => void;
-};
-/**
- * Left-cluster app picker — the dropdown button that sits beside OrgSwitcher.
- *
- * Shows the current app's monogram + name as the trigger so both context
- * dimensions (which app, which org) are immediately visible in the left
- * cluster without needing to open anything.
- *
- * The dropdown preserves the full AppLauncher row richness: monogram tile
- * with per-app accent, name, description, and entitlement badges. Entitled
- * apps are grouped first; locked / coming-soon land in an "Available" section.
- *
- * Includes typeahead — auto-focus on open, filters name/description/key as
- * the user types, arrow-key navigation, Enter to activate, Escape to close.
- *
- * Soft-reads via useCboxIdOptional — renders null when no provider is
- * mounted above (admin shells, pre-auth pages).
- */
-declare function AppSwitcher({ className, onLockedAppClick }: AppSwitcherProps): react_jsx_runtime.JSX.Element | null;
-
-/**
- * Bell with unread-count badge + popover preview. Click opens a
- * dropdown with the last 5 items inline (no navigation), each with
- * an inline mark-read action and an optional deep-link to the page
- * that originated the notification. "See all" at the bottom links
- * to the central notifications service inbox — the only navigation
- * away from the host app.
- *
- * Pattern matches Linear / GitHub / Stripe: glance + mark-read
- * without leaving context; cross-app jump only when the user
- * explicitly wants the full list.
- *
- * Renders nothing if the context is missing or notifications
- * aren't configured (eg pre-auth pages).
- */
-declare function NotificationsBell({ className }: {
-    className?: string;
-}): react_jsx_runtime.JSX.Element | null;
-
-type Props$5 = {
-    /**
-     * Optional renderer override for the trigger so apps can match
-     * their topbar style (filled button vs ghost vs icon-only).
-     */
-    Trigger?: ComponentType<{
-        organization: CboxOrganization | null;
-        onClick: () => void;
-        open: boolean;
-    }>;
-    className?: string;
-};
-/**
- * Dropdown that surfaces the user's orgs and dispatches the picked
- * one through `onSwitchOrganization`. Reads everything else from
- * CboxIdProvider so the same component works in id, cortex, atlas —
- * no per-app data wiring.
- *
- * Includes typeahead — auto-focus on open, filters by name as the
- * user types, arrow-key navigation, Enter to switch, Escape to close.
- */
-declare function OrgSwitcher({ Trigger, className }: Props$5): react_jsx_runtime.JSX.Element;
-
-type Props$4 = {
-    /** Click handler — typically dispatches the app's command-palette
-     *  open shortcut. Apps that don't have a palette yet pass a no-op
-     *  so the chrome stays visually consistent across the suite. */
-    onOpen?: () => void;
-    className?: string;
-    label?: string;
-};
-/**
- * Topbar Search trigger — a visual-only command-palette button.
- *
- * Hosted in cbox-ui because every Cbox app's chrome must show the
- * same search affordance in the same spot, with the same width and
- * the same shortcut hint. Drift across apps means users see layout
- * shifts when tabbing between id / webhooks / cortex; that's a UX
- * tax we don't want to charge them.
- *
- * The actual palette stays per-app (commands differ); this primitive
- * just renders the trigger and dispatches `onOpen`.
- */
-declare function SearchTrigger({ onOpen, className, label }: Props$4): react_jsx_runtime.JSX.Element;
-
-type Props$3 = {
-    /**
-     * App-specific menu items rendered above the standard
-     * "Manage account" / "Sign out" set. Use sparingly — the goal
-     * is consistency across apps.
-     */
-    extras?: ReactNode;
-    placement?: 'bottom-end' | 'top-start';
-    className?: string;
-    /**
-     * The router's link for the account and organization rows, when they are pages of this
-     * app (an Inertia `Link` keeps the visit client-side). Default: a plain anchor, which is
-     * right when the rows deep-link into Cbox ID on another origin.
-     */
-    LinkComponent?: LinkComponent;
-};
-/**
- * User-menu dropdown. Always exposes:
- *   - Manage account ↗   (deep-link into id)
- *   - Team & billing ↗   (deep-link into id, current org scope)
- *   - Sign out
- *
- * The arrows signal cross-app navigation — id is canonical.
- */
-declare function UserMenu({ extras, className, placement, LinkComponent: Link }: Props$3): react_jsx_runtime.JSX.Element;
-
 /**
  * Combobox — the canonical select replacement for the Cbox suite.
  *
@@ -806,7 +832,7 @@ type ComboboxAvatar = {
     accent?: string;
     src?: string;
 };
-type LinkComp$1 = ComponentType<{
+type LinkComp = ComponentType<{
     href: string;
     prefetch?: boolean;
     className?: string;
@@ -842,7 +868,7 @@ type CommonProps = {
      * Framework Link adapter for navigation-mode items + footer link.
      * If unset, navigation falls back to plain `<a>`.
      */
-    LinkComponent?: LinkComp$1;
+    LinkComponent?: LinkComp;
     /** ID for the trigger button (associate with a <Label htmlFor>). */
     id?: string;
     /** className for the outer wrapper. */
@@ -866,111 +892,6 @@ type NavModeProps = CommonProps & {
 type ComboboxProps = ValueModeProps | NavModeProps;
 declare function Combobox(props: ComboboxProps): react_jsx_runtime.JSX.Element;
 
-/**
- * ContextBar — the topbar breadcrumb-style context selector. One
- * crumb per level of context (org / project / environment / branch /
- * deployment). Each crumb renders as a chip (avatar + label +
- * chevron) and opens a dropdown with the items at that level plus
- * an optional "+ New X" footer.
- *
- * The pattern is the cloud-platform default — Vercel, Render, Forge,
- * GitHub, Stripe, Cortex all use it. Topbar carries identity and
- * context; sidebar carries navigation. The two never overlap.
- *
- * URL-driven by default — clicking a dropdown item navigates via the
- * supplied `LinkComponent`. Apps that need a non-navigational select
- * (post a form, mutate session state) pass `onSelect` instead.
- *
- * Separator between crumbs is a muted slash — same as Forge / Cortex.
- */
-type ContextAvatar = {
-    /** 1–2 character monogram. Defaults to first letter of the label. */
-    initials?: string;
-    /**
-     * Hex / CSS colour applied as the avatar's bg. Falls back to the
-     * neutral chip when missing. Per-item override of the default.
-     */
-    accent?: string;
-    /** Optional avatar image URL — overrides initials when set. */
-    src?: string;
-};
-type ContextItem = {
-    /** Stable identity for the item (slug, id). */
-    id: string;
-    /** Primary display label. */
-    label: string;
-    /** Optional secondary line — slug, role, env name. Mono-tracked. */
-    secondary?: string;
-    /** Avatar specification. Same shape as the crumb's own avatar. */
-    avatar?: ContextAvatar;
-    /** Navigation target — clicking the item navigates here. */
-    href?: string;
-    /** Mark the item as the active selection (gets a check on the right). */
-    current?: boolean;
-    /**
-     * Optional href to a settings page for this item. When set, a
-     * cogwheel button appears on the right of the row on hover/focus
-     * — clicking it navigates straight to settings without going
-     * through the item's normal selection. Cortex-style shortcut.
-     */
-    settingsHref?: string;
-    /**
-     * Aria-label for the optional settings cogwheel. Defaults to
-     * `Settings for <label>`. Override when the label alone isn't
-     * enough context (eg multiple items with the same name).
-     */
-    settingsAriaLabel?: string;
-};
-type ContextCrumb = {
-    /** Stable identity for the crumb (used as React key). */
-    id: string;
-    /** The chip's visible label — typically the active item's name. */
-    label: string;
-    /** The chip's avatar — typically the active item's avatar. */
-    avatar?: ContextAvatar;
-    /** Items shown in the dropdown. Empty array = chip with no menu. */
-    items: ContextItem[];
-    /**
-     * Optional footer link below the items — typically "+ New X" or
-     * "Manage Y". Renders with a + icon and an accent text colour.
-     */
-    footerLink?: {
-        label: string;
-        href: string;
-    };
-    /**
-     * Override per-item navigation. When set, item clicks call this
-     * with the item's id instead of navigating to `item.href`. Useful
-     * for posting a form (eg an org switcher that POSTs to a server-side
-     * endpoint).
-     */
-    onSelect?: (itemId: string) => void;
-    /** Optional aria-label for the chip's button (defaults to "Switch <label>"). */
-    ariaLabel?: string;
-};
-type LinkComp = ComponentType<{
-    href: string;
-    prefetch?: boolean;
-    className?: string;
-    children: ReactNode;
-}>;
-type Props$2 = {
-    crumbs: ContextCrumb[];
-    /**
-     * The framework's link component. Inertia consumers pass the
-     * Inertia Link; TanStack Router consumers pass their typed Link.
-     * Plain `<a>` is the fallback.
-     */
-    LinkComponent?: LinkComp;
-    className?: string;
-};
-declare function ContextBar({ crumbs, LinkComponent, className, }: Props$2): react_jsx_runtime.JSX.Element | null;
-declare function ContextAvatarChip({ avatar, fallbackLabel, size, }: {
-    avatar: ContextAvatar;
-    fallbackLabel: string;
-    size?: 'sm' | 'md';
-}): react_jsx_runtime.JSX.Element;
-
 /**
  * Generic panel container — soft border, card surface, subtle shadow.
  * The default building block for every section on a page.
@@ -1038,6 +959,13 @@ type Props$1 = {
     eyebrow?: ReactNode;
     description?: ReactNode;
     actions?: ReactNode;
+    /**
+     * Show the `?` beside the title that toggles the shell's Help column (spec §7.1). The page's
+     * help topic travels in `shell.help.topic`, set on the server per route (console-kit's
+     * `helpTopic`), so Help knows the topic on the first paint and for pages without a header.
+     * Ignored outside `CboxShell`.
+     */
+    help?: boolean;
     className?: string;
 };
 /**
@@ -1046,7 +974,7 @@ type Props$1 = {
  * Cortex-style — no italics, no brackets — so it carries across many
  * sibling apps cleanly.
  */
-declare function PageHeader({ title, eyebrow, description, actions, className, }: Props$1): react_jsx_runtime.JSX.Element;
+declare function PageHeader({ title, eyebrow, description, actions, help, className, }: Props$1): react_jsx_runtime.JSX.Element;
 
 /**
  * Width policy for `<PageShell>` — the single horizontal-rhythm
@@ -1272,25 +1200,17 @@ declare function StatusPill({ children, tone, className, dot, }: StatusPillProps
  * land.
  *
  * The criterion for accepting a new surface: "would it be useful
- * in *every* Cbox app?" Inbox yes. Search yes. Help yes. "Webhook
+ * in *every* Cbox app?" Inbox yes. "Webhook
  * delivery details" no — that's a route inside webhooks, not a
  * cross-app overlay.
  */
 
-type SurfaceId = 'inbox' | 'search' | 'activity' | 'help';
+/** Search and Help are the shell's palette and Help column now; `inbox` stays for apps that use it. */
+type SurfaceId = 'inbox';
 type SurfaceArgs = {
     inbox: {
         focusUnread?: boolean;
     };
-    search: {
-        initialQuery?: string;
-    };
-    activity: {
-        scope?: 'user' | 'org';
-    };
-    help: {
-        topic?: string;
-    };
 };
 /**
  * Auth + transport plumbing the host injects. cbox-ui's surface
@@ -1306,7 +1226,6 @@ type Transport = {
      */
     urls: Partial<{
         notifications: string;
-        search: string;
         audit: string;
         realtime: string;
     }>;
@@ -1327,10 +1246,6 @@ type Transport = {
     csrfToken?: () => string;
 };
 type SurfaceConfig = Partial<{
-    search: {
-        placeholder?: string;
-        scopes?: string[];
-    };
     inbox: {};
 }>;
 /**
@@ -1386,7 +1301,7 @@ type CboxSurfacesProps = {
 
 /**
  * Mount the cbox-ui surface runtime once per app, alongside the
- * page tree. The host's chrome (bell, search trigger) reads
+ * page tree. The host's chrome (the bell) reads
  * `useCboxSurfaces()` to open surfaces; cbox-ui renders the
  * active one as a modal/drawer over the page.
  *
@@ -1403,7 +1318,7 @@ declare function CboxSurfaces({ transport, surfaces, config, children, }: CboxSu
 declare function useCboxSurfaces(): SurfaceController;
 /**
  * Optional variant — returns `null` when no `<CboxSurfaces>` host is
- * mounted. Chrome controls (bell, search trigger) use this to
+ * mounted. Chrome controls (the bell) use this to
  * degrade gracefully to cross-app navigation when the host hasn't
  * opted into the surface runtime yet.
  */
@@ -1509,67 +1424,6 @@ declare function parseUrlSearch<S extends UrlSchema>(search: string, schema: S):
  */
 declare function buildUrlSearch<S extends UrlSchema>(state: InferUrlState<S>, schema: S): string;
 
-type CboxTranslationValues = Record<string, string | number>;
-type CboxTranslator = (message: string, values?: CboxTranslationValues) => string;
-declare function interpolate(message: string, values?: CboxTranslationValues): string;
-/** Optional and additive: without a provider existing consumers retain English. */
-declare function CboxLocalizationProvider({ locale, translate, formatDate, children }: {
-    locale: string;
-    translate: CboxTranslator;
-    formatDate?: (value: string) => string;
-    children: ReactNode;
-}): react_jsx_runtime.JSX.Element;
-declare function useCboxLocalization(): {
-    locale: string;
-    t: CboxTranslator;
-    formatDate: (value: string) => string;
-};
-
-type CboxNavArea = CboxNavItem & {
-    items?: CboxNavItem[];
-};
-type CboxWorkspaceShellProps = {
-    appKey: string;
-    brandSubmark: string;
-    areas: CboxNavArea[];
-    currentPath: string;
-    LinkComponent: LinkComponent;
-    context: ReactNode;
-    tools: ReactNode;
-    account: ReactNode;
-    children: ReactNode;
-    /** Where the brand row links. Default `/`. */
-    brandHref?: string;
-    /** `id` of the `<main>` landmark, so a host's skip link can target it. Default `main-content`. */
-    mainId?: string;
-    /**
-     * Rail pinned open. Pass `pinned` + `onPinnedChange` to control it (the host persists the
-     * preference, in a cookie or Cbox ID), or `defaultPinned` to seed the shell's own state.
-     */
-    pinned?: boolean;
-    defaultPinned?: boolean;
-    onPinnedChange?: (pinned: boolean) => void;
-    /** Contextual subnav collapsed to its strip. Controlled and uncontrolled as `pinned`. */
-    collapsed?: boolean;
-    defaultCollapsed?: boolean;
-    onCollapsedChange?: (collapsed: boolean) => void;
-};
-/**
- * How well `href` matches `path`: the href's length when the path is the href or beneath it,
- * -1 otherwise. `/` matches only itself, so a home item never claims every page.
- */
-declare function navMatchLength(path: string, href: string): number;
-/** The item whose href is the most specific match for `path`, or undefined. */
-declare function activeNavItem<T extends CboxNavItem>(path: string, items: readonly T[]): T | undefined;
-/**
- * The area `path` is in: the one holding the most specific match among its own href and its
- * items' hrefs. A first-match would put every page beneath an area at `/` (an overview, a
- * dashboard) under that area and never show another area's subnav.
- */
-declare function activeNavArea<T extends CboxNavArea>(path: string, areas: readonly T[]): T | undefined;
-/** Two-tier workspace navigation. Route ownership and preference persistence stay with the host. */
-declare function CboxWorkspaceShell({ appKey, brandSubmark, areas, currentPath, LinkComponent: Link, context, tools, account, children, brandHref, mainId, pinned: pinnedProp, defaultPinned, onPinnedChange, collapsed: collapsedProp, defaultCollapsed, onCollapsedChange }: CboxWorkspaceShellProps): react_jsx_runtime.JSX.Element;
-
 /** The chart tokens in order, for series that set their own colour. */
 declare const CHART_PALETTE: string[];
 /** A row's shape over the window, small: a line with a faint area, zero at the bottom. Decorative. */
@@ -1580,4 +1434,4 @@ declare function Sparkline({ values, color, width, height }: {
     height?: number;
 }): react_jsx_runtime.JSX.Element | null;
 
-export { AppContent, AppLauncher, AppShell, AppSwitcher, CHART_PALETTE, CboxAppCatalog, type CboxAppCatalogProps, type CboxAppCatalogState, CboxAppIcon, type CboxAppIconProps, type CboxAppKey, type CboxAppLink, CboxAppShell, type CboxAppShellProps, CboxAppSidebar, type CboxAppSidebarProps, CboxBrand, type CboxBrandProps, type CboxCatalogApp, type CboxIdContextValue, CboxIdProvider, type CboxKnownApp, CboxLocalizationProvider, CboxMobileNavDrawer, type CboxMobileNavDrawerProps, type CboxNavArea, type CboxNavItem, type CboxNavSection, type CboxNotificationPreviewItem, type CboxNotificationsState, CboxOrgContextBar, type CboxOrgContextBarProps, type CboxOrganization, CboxServiceMark, type CboxServiceMarkProps, CboxSurfaces, type CboxSurfacesProps, type CboxTranslationValues, type CboxTranslator, type CboxUser, CboxWorkspaceShell, type CboxWorkspaceShellProps, Combobox, type ComboboxAvatar, type ComboboxGroup, type ComboboxOption, type ComboboxProps, type ContextAvatar, ContextAvatarChip, ContextBar, type ContextCrumb, type ContextItem, DataPanel, EmptyState, Heading, type InboxState, type InferUrlState, KeyValue, KeyValueList, type LinkComponent, NotificationsBell, OrgSwitcher, PageHeader, PageShell, type PageTabSpec, PageTabs, type PageTabsProps, type PageWidth, PanelBody, type RealtimeState, type RealtimeStatus, RowLink, type RowLinkProps, SearchTrigger, SectionHeader, Sparkline, StatTile, StatusPill, type SurfaceArgs, type SurfaceConfig, type SurfaceController, type SurfaceId, TopBar, type Transport, type UrlField, type UrlSchema, UserMenu, activeNavArea, activeNavItem, authorizeHref, buildUrlSearch, cn, defineUrlSchema, interpolate, navMatchLength, parseAppCatalog, parseUrlSearch, rememberAppCatalog, secureIconUrl, urlBoolean, urlEnum, urlNumber, urlString, urlStringArray, useCboxId, useCboxIdOptional, useCboxLocalization, useCboxSurfaces, useCboxSurfacesOptional, useKnownAppCatalog };
+export { APP_HUES, AppContent, type AppKey, AppShell, CHART_PALETTE, CboxAppCatalog, type CboxAppCatalogProps, CboxAppIcon, type CboxAppIconProps, type CboxAppKey, type CboxAppLink, CboxBrand, type CboxBrandProps, type CboxIdContextValue, CboxIdProvider, CboxKnownApp, CboxLocalizationProvider, type CboxNotificationPreviewItem, type CboxNotificationsState, type CboxOrganization, CboxServiceMark, type CboxServiceMarkProps, CboxShell, type CboxShellProps, CboxSurfaces, type CboxSurfacesProps, type CboxTranslationValues, type CboxTranslator, type CboxUser, Combobox, type ComboboxAvatar, type ComboboxGroup, type ComboboxOption, type ComboboxProps, type ContextItem, type ContextLevel, type ContextTone, DataPanel, EmptyState, Heading, type HelpArticle, type HelpState, type HelpStore, type InboxState, type InferUrlState, KeyValue, KeyValueList, type ListPage, type NavArea, type NavPage, PageHeader, type PageIntent, PageShell, type PageTabSpec, PageTabs, type PageTabsProps, type PageWidth, type PaletteAction, PanelBody, type RealtimeState, type RealtimeStatus, RowLink, type RowLinkProps, SHELL_ICONS, SectionHeader, type Shell, type ShellAccount, type Link as ShellActionLink, type ShellApp, type ShellBanner, type ShellCatalogState, type ShellHelp, type ShellIcon, type ShellLinkComponent, type ShellNavigate, type ShellNotifications, type ShellOption, type ShellPreferenceChange, type ShellPreferences, type ShellTheme, Sparkline, StatTile, StatusPill, type SupportUpdate, type SurfaceArgs, type SurfaceConfig, type SurfaceController, type SurfaceId, type Transport, type UrlField, type UrlSchema, applyTheme, buildUrlSearch, cn, contextTrail, createHelpStore, defineUrlSchema, environmentFor, hueFor, initialsOf, interpolate, pageIntent, parseListPage, parseShellCatalog, parseUrlSearch, settingsHref, switchPayload, themeBootScript, urlBoolean, urlEnum, urlNumber, urlString, urlStringArray, useCboxId, useCboxIdOptional, useCboxLocalization, useCboxSurfaces, useCboxSurfacesOptional, useKnownAppCatalog, useShellHelp, withQuery };