@voyant-travel/admin 0.111.0

package/dist/extensions.d.ts

@@ -0,0 +1,254 @@
+import type { QueryClient } from "@tanstack/react-query";
+import type * as React from "react";
+import type { AdminDestinationKey } from "./navigation/destinations.js";
+import type { NavItem } from "./types.js";
+/**
+ * App-supplied runtime handed to route loaders: where the API lives and how
+ * to reach it (the host's cookie-forwarding fetcher in SSR setups).
+ *
+ * The fetcher takes a string URL — the `VoyantFetcher` convention every
+ * `*-react` data client uses — so host fetchers typed against that contract
+ * (and the global `fetch`, which accepts a superset of inputs) bind directly.
+ */
+export interface AdminRouteRuntime {
+    baseUrl: string;
+    fetcher?: (url: string, init?: RequestInit) => Promise<Response>;
+}
+export interface AdminRouteLoaderContext {
+    queryClient: QueryClient;
+    runtime: AdminRouteRuntime;
+    /**
+     * Path params of the matched route (e.g. `{ id: "book_..." }`). Empty for
+     * param-less routes. Hosts that bind contributions into a router supply
+     * the matched params so package loaders can prefetch detail data.
+     */
+    params: Record<string, string>;
+}
+/**
+ * Props a packaged route page receives from the host's route binder
+ * (packaged-admin RFC §4.2 endgame). The binder reads route state off the
+ * matched route — `useParams`/`useSearch` — and hands it to the page, which
+ * is what dissolves the old "zero-prop components only" restriction: a
+ * param-taking page is just a page that reads `params`/`search` from props.
+ */
+export interface AdminRoutePageProps {
+    /** Path params of the matched route (e.g. `{ id: "book_..." }`). */
+    params: Record<string, string>;
+    /**
+     * Search params of the matched route, already validated by the
+     * contribution's `validateSearch`. Pages narrow this to their own search
+     * contract (the same schema the contribution carries).
+     */
+    search: Record<string, unknown>;
+    /**
+     * Patch the route's URL search state in place (same-route navigation).
+     * Defaults to `replace: true` — filter/tab state shouldn't grow history.
+     */
+    updateSearch: (updater: (prev: Record<string, unknown>) => Record<string, unknown>, options?: {
+        replace?: boolean;
+    }) => void;
+    /** Localized route title from the contribution (factory `labels`). */
+    title?: string;
+}
+export type AdminRoutePageComponent = React.ComponentType<AdminRoutePageProps>;
+/** Module shape `AdminUiRouteContribution.page` loaders resolve to. */
+export interface AdminRoutePageModule {
+    default: AdminRoutePageComponent;
+}
+/**
+ * Adapt a component into an {@link AdminRoutePageModule}. Use inside `page`
+ * loaders for components that ignore route props entirely (zero-prop hosts)
+ * or take an all-optional props bag — both of which TypeScript's weak-type
+ * rule rejects as `AdminRoutePageComponent` despite being safe to mount.
+ */
+export declare function adminRoutePageModule<P>(component: React.ComponentType<P>): AdminRoutePageModule;
+/**
+ * A named route contribution for the admin shell.
+ *
+ * Originally metadata only; as of the packaged-admin RFC Phase 2
+ * (docs/architecture/packaged-admin-rfc.md §4.2) contributions may carry the
+ * route IMPLEMENTATION — everything a starter route file can express — so
+ * domain packages can ship pages. All implementation fields are optional:
+ * metadata-only contributions remain valid, and hosts decide how the fields
+ * map onto their router (TanStack hosts spread them into route options).
+ */
+export interface AdminUiRouteContribution {
+    id: string;
+    path: string;
+    title: string;
+    /** The page. Keep it lazy-importable for code-splitting. */
+    component?: React.ComponentType;
+    /**
+     * The page as a LAZY module loader (preferred over `component`). The host
+     * binder wraps it in the router's lazy-component machinery, so the page
+     * lands in its own chunk instead of the workspace-chrome chunk, and
+     * hover/intent preloading fetches it ahead of navigation. The resolved
+     * component receives {@link AdminRoutePageProps} (params/search/title), so
+     * param-taking pages need no host route file.
+     */
+    page?: () => Promise<AdminRoutePageModule>;
+    /** Data loader; receives the host QueryClient + app runtime. */
+    loader?: (ctx: AdminRouteLoaderContext) => unknown;
+    /** Typed search-param validation (e.g. a zod schema's parse). */
+    validateSearch?: (search: Record<string, unknown>) => unknown;
+    /** Per-route SSR mode, mirroring the host router's option. */
+    ssr?: boolean | "data-only";
+    pendingComponent?: React.ComponentType;
+    errorComponent?: React.ComponentType<{
+        error: unknown;
+        reset: () => void;
+    }>;
+    /** Capability/permission key the shell checks before rendering. */
+    capability?: string;
+    /** Preload policy override, mirroring the host router's option. */
+    preload?: false | "intent" | "render" | "viewport";
+    /**
+     * The semantic destination key this route SATISFIES (packaged-admin RFC
+     * §4.7 endgame). Declare it only when the destination's semantics map 1:1
+     * onto this route's path with pure param interpolation — the binding lets
+     * `voyant admin generate --destinations` emit the host's resolver for the
+     * key instead of the host hand-writing it. Destinations that need search
+     * params, multiple candidate routes, or any construction beyond path
+     * interpolation must NOT be bound here; their resolvers stay hand-written
+     * in the host map. The key must be declared on {@link AdminDestinations}
+     * (by this package or one whose augmentation is in scope), which keeps the
+     * annotation typo-proof.
+     */
+    destination?: AdminDestinationKey;
+    /**
+     * Route param name → destination param name, for params whose names
+     * differ (e.g. route `/suppliers/$id` satisfying
+     * `"supplier.detail": { supplierId: string }` maps `{ id: "supplierId" }`).
+     * Params absent from the map keep their route name. Only meaningful next
+     * to {@link AdminUiRouteContribution.destination}.
+     */
+    destinationParams?: Record<string, string>;
+    /**
+     * Redirect target: the route navigates here instead of rendering
+     * (host binders emit a `beforeLoad`-style redirect, which also covers
+     * SSR). A redirect contribution needs no `page`/`component` — it counts
+     * as implemented on its own. Used for the index redirects that used to be
+     * host route files (e.g. `/catalog` → `/catalog/products`).
+     */
+    redirectTo?: string;
+    /**
+     * Nested child contributions rendered inside this route's layout (this
+     * contribution becomes a LAYOUT route — its page renders an outlet).
+     * Child `path`s are RELATIVE to the parent path and start with `/`;
+     * a child path of exactly `"/"` is the parent's index route. Hosts bind
+     * children under the parent's code-based route (packaged-admin RFC §4.8 —
+     * see `attachAdminExtensionRoutes` / `adminExtensionChildRoutes` in
+     * `@voyant-travel/admin/app`).
+     */
+    children?: ReadonlyArray<AdminUiRouteContribution>;
+}
+/**
+ * Contribute one or more navigation items to the shared admin shell.
+ *
+ * Contributions are appended after the starter's base navigation and sorted
+ * by `order`. Set `insertAfter` to a base nav item id to splice the
+ * contribution's items in directly after that item instead — useful when
+ * the extension's items belong logically next to a built-in entry (e.g.
+ * Trips below Bookings).
+ */
+export interface AdminNavigationContribution {
+    items: ReadonlyArray<NavItem>;
+    order?: number;
+    insertAfter?: string;
+}
+/**
+ * Named widget slot identifier.
+ *
+ * Starters define the slots they expose on specific admin pages and modules
+ * or extensions can target them with React components.
+ */
+export type AdminWidgetSlot = string;
+/**
+ * A widget contribution that can be rendered inside a starter-defined slot.
+ */
+export interface AdminWidgetContribution<Props = Record<string, unknown>> {
+    id: string;
+    slot: AdminWidgetSlot;
+    order?: number;
+    component: React.ComponentType<Props>;
+}
+/**
+ * Shared admin extension bundle.
+ *
+ * This keeps the extension surface explicit and typed without forcing a more
+ * dynamic plugin runtime into starters.
+ */
+export interface AdminExtension {
+    id: string;
+    navigation?: ReadonlyArray<AdminNavigationContribution>;
+    routes?: ReadonlyArray<AdminUiRouteContribution>;
+    widgets?: ReadonlyArray<AdminWidgetContribution>;
+}
+export declare function defineAdminExtension<T extends AdminExtension>(extension: T): T;
+/**
+ * A route contribution whose `component` is guaranteed present, typed as a
+ * function component so it attaches directly to router `component:` options
+ * (router component types reject the class side of `React.ComponentType`).
+ */
+export type BindableAdminRoute = Omit<AdminUiRouteContribution, "component"> & {
+    component: React.FunctionComponent;
+};
+/**
+ * Look up a route contribution by id and assert it carries a component.
+ *
+ * This is the binding contract generated thin route files rely on
+ * (`voyant admin generate --routes`, packaged-admin RFC §4.2): the generator
+ * only emits hosts for zero-prop contributions whose `component` is present,
+ * and the emitted file resolves the contribution through this helper so a
+ * contribution that later loses its id or component fails loudly at module
+ * evaluation (build/dev start) instead of rendering an empty route.
+ */
+export declare function requireAdminRoute(extension: AdminExtension, routeId: string): BindableAdminRoute;
+/**
+ * A route contribution guaranteed to carry an implementation — a lazy
+ * `page` module loader, an eager zero-prop `component`, or a `redirectTo`
+ * target (redirect routes render nothing).
+ */
+export type ImplementedAdminRoute = AdminUiRouteContribution & ({
+    page: () => Promise<AdminRoutePageModule>;
+} | {
+    component: React.FunctionComponent;
+} | {
+    redirectTo: string;
+});
+/**
+ * Depth-first lookup of a route contribution by id, descending into
+ * {@link AdminUiRouteContribution.children} so nested contributions (e.g.
+ * settings pages under the settings layout) resolve like top-level ones.
+ */
+export declare function findAdminRouteContribution(routes: ReadonlyArray<AdminUiRouteContribution> | undefined, routeId: string): AdminUiRouteContribution | undefined;
+/**
+ * Look up a route contribution by id (including nested `children`) and
+ * assert it carries an implementation (`page`, `component`, or
+ * `redirectTo`).
+ *
+ * This is the binding contract of the code-assembled admin route tree
+ * (packaged-admin RFC §4.8 endgame): the host's generated route module
+ * resolves every extension route through this helper, so a contribution
+ * that later loses its id or implementation fails loudly at module
+ * evaluation (build/dev start) instead of rendering an empty route.
+ */
+export declare function requireImplementedAdminRoute(extension: AdminExtension, routeId: string): ImplementedAdminRoute;
+/**
+ * Compose an explicit admin extension registry for a starter or app shell.
+ *
+ * The admin surface stays source-controlled and typed while still routing
+ * all contributions through the shared admin runtime package.
+ */
+export declare function createAdminExtensionRegistry(...extensions: ReadonlyArray<AdminExtension>): ReadonlyArray<AdminExtension>;
+export interface ResolveAdminNavigationOptions {
+    baseItems: ReadonlyArray<NavItem>;
+    extensions?: ReadonlyArray<AdminExtension>;
+}
+export declare function resolveAdminNavigation({ baseItems, extensions, }: ResolveAdminNavigationOptions): NavItem[];
+export interface ResolveAdminWidgetsOptions {
+    slot: AdminWidgetSlot;
+    extensions?: ReadonlyArray<AdminExtension>;
+}
+export declare function resolveAdminWidgets({ slot, extensions, }: ResolveAdminWidgetsOptions): AdminWidgetContribution[];
+//# sourceMappingURL=extensions.d.ts.map

package/dist/extensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../src/extensions.ts"],"names":[],"mappings":"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"}

package/dist/extensions.js

@@ -0,0 +1,139 @@
+/**
+ * Adapt a component into an {@link AdminRoutePageModule}. Use inside `page`
+ * loaders for components that ignore route props entirely (zero-prop hosts)
+ * or take an all-optional props bag — both of which TypeScript's weak-type
+ * rule rejects as `AdminRoutePageComponent` despite being safe to mount.
+ */
+export function adminRoutePageModule(component) {
+    const Component = component;
+    return { default: Component };
+}
+export function defineAdminExtension(extension) {
+    return extension;
+}
+/**
+ * Look up a route contribution by id and assert it carries a component.
+ *
+ * This is the binding contract generated thin route files rely on
+ * (`voyant admin generate --routes`, packaged-admin RFC §4.2): the generator
+ * only emits hosts for zero-prop contributions whose `component` is present,
+ * and the emitted file resolves the contribution through this helper so a
+ * contribution that later loses its id or component fails loudly at module
+ * evaluation (build/dev start) instead of rendering an empty route.
+ */
+export function requireAdminRoute(extension, routeId) {
+    const route = extension.routes?.find((candidate) => candidate.id === routeId);
+    if (!route) {
+        throw new Error(`[voyant-admin] Extension "${extension.id}" has no route contribution "${routeId}". ` +
+            `Regenerate the host's route files with \`voyant admin generate --routes\`.`);
+    }
+    if (!route.component) {
+        throw new Error(`[voyant-admin] Route contribution "${routeId}" of extension "${extension.id}" carries no component. ` +
+            `Generated thin hosts require zero-prop components — regenerate with \`voyant admin generate --routes\`.`);
+    }
+    return route;
+}
+/**
+ * Depth-first lookup of a route contribution by id, descending into
+ * {@link AdminUiRouteContribution.children} so nested contributions (e.g.
+ * settings pages under the settings layout) resolve like top-level ones.
+ */
+export function findAdminRouteContribution(routes, routeId) {
+    for (const route of routes ?? []) {
+        if (route.id === routeId)
+            return route;
+        const nested = findAdminRouteContribution(route.children, routeId);
+        if (nested)
+            return nested;
+    }
+    return undefined;
+}
+/**
+ * Look up a route contribution by id (including nested `children`) and
+ * assert it carries an implementation (`page`, `component`, or
+ * `redirectTo`).
+ *
+ * This is the binding contract of the code-assembled admin route tree
+ * (packaged-admin RFC §4.8 endgame): the host's generated route module
+ * resolves every extension route through this helper, so a contribution
+ * that later loses its id or implementation fails loudly at module
+ * evaluation (build/dev start) instead of rendering an empty route.
+ */
+export function requireImplementedAdminRoute(extension, routeId) {
+    const route = findAdminRouteContribution(extension.routes, routeId);
+    if (!route) {
+        throw new Error(`[voyant-admin] Extension "${extension.id}" has no route contribution "${routeId}". ` +
+            `Regenerate the host's admin route module with \`voyant admin generate --routes\`.`);
+    }
+    if (!route.page && !route.component && !route.redirectTo) {
+        throw new Error(`[voyant-admin] Route contribution "${routeId}" of extension "${extension.id}" carries no ` +
+            `implementation (neither \`page\`, \`component\`, nor \`redirectTo\`). Add one to the ` +
+            `extension, or keep the route as a hand-written host route file.`);
+    }
+    return route;
+}
+/**
+ * Compose an explicit admin extension registry for a starter or app shell.
+ *
+ * The admin surface stays source-controlled and typed while still routing
+ * all contributions through the shared admin runtime package.
+ */
+export function createAdminExtensionRegistry(...extensions) {
+    return extensions;
+}
+function sortOrderedValues(values) {
+    return [...values]
+        .sort((a, b) => {
+        if (a.order !== b.order) {
+            return a.order - b.order;
+        }
+        return a.index - b.index;
+    })
+        .map((entry) => entry.value);
+}
+export function resolveAdminNavigation({ baseItems, extensions = [], }) {
+    const contributions = extensions.flatMap((extension) => extension.navigation ?? []);
+    const orderedContributions = sortOrderedValues(contributions.map((contribution, index) => ({
+        index,
+        order: contribution.order ?? 0,
+        value: contribution,
+    })));
+    const anchoredByBaseId = new Map();
+    const appended = [];
+    for (const contribution of orderedContributions) {
+        if (contribution.insertAfter) {
+            const bucket = anchoredByBaseId.get(contribution.insertAfter) ?? [];
+            bucket.push(...contribution.items);
+            anchoredByBaseId.set(contribution.insertAfter, bucket);
+        }
+        else {
+            appended.push(...contribution.items);
+        }
+    }
+    const merged = [];
+    for (const item of baseItems) {
+        merged.push(item);
+        if (!item.id)
+            continue;
+        const anchored = anchoredByBaseId.get(item.id);
+        if (anchored)
+            merged.push(...anchored);
+    }
+    // Items anchored to a base id that no longer exists fall through to the
+    // tail so they're still discoverable rather than silently dropped.
+    for (const [baseId, items] of anchoredByBaseId.entries()) {
+        if (!baseItems.some((item) => item.id === baseId))
+            appended.push(...items);
+    }
+    return [...merged, ...appended];
+}
+export function resolveAdminWidgets({ slot, extensions = [], }) {
+    const widgets = extensions
+        .flatMap((extension) => extension.widgets ?? [])
+        .filter((widget) => widget.slot === slot);
+    return sortOrderedValues(widgets.map((widget, index) => ({
+        index,
+        order: widget.order ?? 0,
+        value: widget,
+    })));
+}

package/dist/index.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @voyant-travel/admin — shared admin-dashboard shell for Voyant starters.
+ *
+ * Exports:
+ * - Theme provider: zero-dependency ThemeProvider + useTheme that toggles
+ *   `light`/`dark` classes on `document.documentElement` and honors
+ *   `prefers-color-scheme` for the "system" mode.
+ * - Locale provider: useLocale + LocaleProvider for admin locale/timezone
+ *   resolution and persistence.
+ * - Query client factory: `makeQueryClient()` with Voyant's admin defaults.
+ * - `AdminProvider` composing QueryClient + ThemeProvider + LocaleProvider.
+ * - Operator admin shell helpers for API, i18n, and domain provider wiring.
+ * - Dashboard page composition, skeletons, aggregate query helpers, and extension context.
+ * - Operator admin sidebar, navigation, and workspace layout helpers.
+ * - Admin extension helpers for navigation contributions and widget slots.
+ * - Semantic destinations: `AdminDestinations` + `AdminNavigationProvider` +
+ *   `useAdminHref`/`useAdminNavigate` for package-owned pages that navigate
+ *   to routes they don't own (packaged-admin RFC §4.7).
+ * - User utilities: `getInitials`, `getDisplayName`.
+ * - Types: `AdminUser`, `NavItem`, `NavSubItem`, `AuthActions`, `ThemeMode`.
+ */
+export { type AdminBreadcrumbSegment, AdminBreadcrumbsProvider, type AdminBreadcrumbsProviderProps, AdminBreadcrumbsTrail, type AdminBreadcrumbsTrailProps, useAdminBreadcrumbs, useAdminBreadcrumbsValue, } from "./components/admin-breadcrumbs.js";
+export { AdminNavGroup, type AdminNavGroupProps, } from "./components/admin-nav-group.js";
+export { type AdminNavLinkComponent, type AdminNavLinkProps, DefaultAdminNavLink, } from "./components/admin-nav-link.js";
+export { AdminPageHead, type AdminPageHeadOptions, type AdminPageHeadProps, AdminPageHeadProvider, type AdminPageHeadProviderProps, useAdminPageHead, } from "./components/admin-page-head.js";
+export { AdminWidgetSlotRenderer, type AdminWidgetSlotRendererProps, } from "./components/admin-widget-slot.js";
+export { VoyantMark } from "./components/brand/voyant-mark.js";
+export { VoyantWordmark } from "./components/brand/voyant-wordmark.js";
+export { OperatorAdminBootstrapGate, type OperatorAdminBootstrapGateProps, type OperatorAdminBootstrapMode, type OperatorAdminBootstrapRenderState, } from "./components/operator-admin-bootstrap-gate.js";
+export { OperatorAdminPageShell, type OperatorAdminPageShellProps, } from "./components/operator-admin-page-shell.js";
+export { DefaultOperatorAdminBrand, type DefaultOperatorAdminBrandProps, OperatorAdminSidebar, type OperatorAdminSidebarProps, OperatorAdminWorkspaceLayout, type OperatorAdminWorkspaceLayoutProps, resolveAdminPageTitle, } from "./components/operator-admin-sidebar.js";
+export { OperatorAdminUserMenu, type OperatorAdminUserMenuProps, } from "./components/operator-admin-user-menu.js";
+export { TeamSettingsPage, type TeamSettingsPageApi, type TeamSettingsPageProps, } from "./components/team-settings-page.js";
+export type { DashboardEmptyAction, DashboardEmptyStateConfig, DashboardEmptyStateKey, DashboardPageProps, } from "./dashboard/dashboard-page.js";
+export { type BookingsAggregates, bookingStatusConfig, buildDashboardSixMonthWindow, buildMonthSeries, DashboardApiError, type DashboardQueryClient, dashboardQueryKeys, type FinanceAggregates, formatCurrency, getDashboardBookingsAggregatesQueryOptions, getDashboardFinanceAggregatesQueryOptions, getDashboardProductsAggregatesQueryOptions, getDashboardSuppliersAggregatesQueryOptions, getStatusColor, monthlyBookingsConfig, type ProductsAggregates, pickPrimaryCurrency, revenueChartConfig, type SuppliersAggregates, } from "./dashboard/dashboard-query-options.js";
+export { DashboardAreaChartSkeleton, DashboardBarChartSkeleton, DashboardKpiRowSkeleton, DashboardKpiSkeleton, DashboardOutstandingInvoicesSkeleton, DashboardPieChartSkeleton, DashboardSkeleton, DashboardUpcomingListSkeleton, } from "./dashboard/dashboard-skeleton.js";
+export { type AdminExtension, type AdminNavigationContribution, type AdminRouteLoaderContext, type AdminRoutePageComponent, type AdminRoutePageModule, type AdminRoutePageProps, type AdminRouteRuntime, type AdminUiRouteContribution, type AdminWidgetContribution, type AdminWidgetSlot, adminRoutePageModule, type BindableAdminRoute, createAdminExtensionRegistry, defineAdminExtension, findAdminRouteContribution, type ImplementedAdminRoute, type ResolveAdminNavigationOptions, type ResolveAdminWidgetsOptions, requireAdminRoute, requireImplementedAdminRoute, resolveAdminNavigation, resolveAdminWidgets, } from "./extensions.js";
+export { composeLocaleMessageDefinitions, type DeepPartial, formatMessage, type LocaleMessageDefinitions, type LocaleMessageOverrides, MessagesProvider, resolveLocaleMessages, useMessages, } from "./lib/i18n.js";
+export { getDisplayName, getInitials } from "./lib/initials.js";
+export { type AdminDestinationKey, type AdminDestinationNavigator, type AdminDestinationResolvers, type AdminDestinations, type AdminHrefResolver, type AdminNavigateOptions, AdminNavigationProvider, type AdminNavigationProviderProps, useAdminHref, useAdminNavigate, } from "./navigation/destinations.js";
+export { type CreateOperatorAdminNavigationOptions, createOperatorAdminNavigation, type OperatorAdminNavigationIconName, type OperatorAdminNavigationIcons, } from "./navigation/operator-navigation.js";
+export { AdminExtensionsProvider, type AdminExtensionsProviderProps, useAdminExtensions, } from "./providers/admin-extensions.js";
+export { AdminProvider, type AdminProviderProps } from "./providers/admin-provider.js";
+export { DEFAULT_ADMIN_LOCALE, DEFAULT_ADMIN_LOCALES, type LocaleContextValue, LocaleProvider, type LocaleProviderProps, resolveAdminLocale, useLocale, } from "./providers/locale.js";
+export { type AdminLocalePreferenceSource, AdminLocalePreferenceSync, type AdminLocalePreferenceSyncProps, } from "./providers/locale-preferences.js";
+export { getOperatorAdminMessageOverridesFromUiPrefs, type OperatorAdminMessageOverrides, type OperatorAdminMessages, OperatorAdminMessagesProvider, useOperatorAdminI18n, useOperatorAdminMessages, useOptionalOperatorAdminI18n, useOptionalOperatorAdminMessages, } from "./providers/operator-admin-messages.js";
+export { type AdminChildProvider, type AdminDomainMessagesProvider, type AdminDomainMessagesProviderProps, AdminDomainMessagesProviderStack, AdminProviderSequence, type AdminProviderSequenceProps, OperatorAdminShellProvider, type OperatorAdminShellProviderProps, } from "./providers/operator-admin-shell.js";
+export { makeQueryClient } from "./providers/query-client.js";
+export { type ThemeContextValue, ThemeProvider, type ThemeProviderProps, useTheme, } from "./providers/theme.js";
+export { type AdminUser, type AuthActions, BETA, COMING_SOON, type NavItem, type NavItemStatus, type NavSubItem, type ThemeMode, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,53 @@
+/**
+ * @voyant-travel/admin — shared admin-dashboard shell for Voyant starters.
+ *
+ * Exports:
+ * - Theme provider: zero-dependency ThemeProvider + useTheme that toggles
+ *   `light`/`dark` classes on `document.documentElement` and honors
+ *   `prefers-color-scheme` for the "system" mode.
+ * - Locale provider: useLocale + LocaleProvider for admin locale/timezone
+ *   resolution and persistence.
+ * - Query client factory: `makeQueryClient()` with Voyant's admin defaults.
+ * - `AdminProvider` composing QueryClient + ThemeProvider + LocaleProvider.
+ * - Operator admin shell helpers for API, i18n, and domain provider wiring.
+ * - Dashboard page composition, skeletons, aggregate query helpers, and extension context.
+ * - Operator admin sidebar, navigation, and workspace layout helpers.
+ * - Admin extension helpers for navigation contributions and widget slots.
+ * - Semantic destinations: `AdminDestinations` + `AdminNavigationProvider` +
+ *   `useAdminHref`/`useAdminNavigate` for package-owned pages that navigate
+ *   to routes they don't own (packaged-admin RFC §4.7).
+ * - User utilities: `getInitials`, `getDisplayName`.
+ * - Types: `AdminUser`, `NavItem`, `NavSubItem`, `AuthActions`, `ThemeMode`.
+ */
+export { AdminBreadcrumbsProvider, AdminBreadcrumbsTrail, useAdminBreadcrumbs, useAdminBreadcrumbsValue, } from "./components/admin-breadcrumbs.js";
+export { AdminNavGroup, } from "./components/admin-nav-group.js";
+export { DefaultAdminNavLink, } from "./components/admin-nav-link.js";
+export { AdminPageHead, AdminPageHeadProvider, useAdminPageHead, } from "./components/admin-page-head.js";
+export { AdminWidgetSlotRenderer, } from "./components/admin-widget-slot.js";
+export { VoyantMark } from "./components/brand/voyant-mark.js";
+export { VoyantWordmark } from "./components/brand/voyant-wordmark.js";
+export { OperatorAdminBootstrapGate, } from "./components/operator-admin-bootstrap-gate.js";
+export { OperatorAdminPageShell, } from "./components/operator-admin-page-shell.js";
+export { DefaultOperatorAdminBrand, OperatorAdminSidebar, OperatorAdminWorkspaceLayout, resolveAdminPageTitle, } from "./components/operator-admin-sidebar.js";
+export { OperatorAdminUserMenu, } from "./components/operator-admin-user-menu.js";
+export { TeamSettingsPage, } from "./components/team-settings-page.js";
+// DashboardPage pulls recharts (~390 KB) — intentionally NOT re-exported
+// here so consumers of this barrel for non-dashboard concerns (sidebar,
+// providers, hooks) don't transitively pull the chart bundle. Import
+// directly from "@voyant-travel/admin/dashboard/dashboard-page" instead.
+export { bookingStatusConfig, buildDashboardSixMonthWindow, buildMonthSeries, DashboardApiError, dashboardQueryKeys, formatCurrency, getDashboardBookingsAggregatesQueryOptions, getDashboardFinanceAggregatesQueryOptions, getDashboardProductsAggregatesQueryOptions, getDashboardSuppliersAggregatesQueryOptions, getStatusColor, monthlyBookingsConfig, pickPrimaryCurrency, revenueChartConfig, } from "./dashboard/dashboard-query-options.js";
+export { DashboardAreaChartSkeleton, DashboardBarChartSkeleton, DashboardKpiRowSkeleton, DashboardKpiSkeleton, DashboardOutstandingInvoicesSkeleton, DashboardPieChartSkeleton, DashboardSkeleton, DashboardUpcomingListSkeleton, } from "./dashboard/dashboard-skeleton.js";
+export { adminRoutePageModule, createAdminExtensionRegistry, defineAdminExtension, findAdminRouteContribution, requireAdminRoute, requireImplementedAdminRoute, resolveAdminNavigation, resolveAdminWidgets, } from "./extensions.js";
+export { composeLocaleMessageDefinitions, formatMessage, MessagesProvider, resolveLocaleMessages, useMessages, } from "./lib/i18n.js";
+export { getDisplayName, getInitials } from "./lib/initials.js";
+export { AdminNavigationProvider, useAdminHref, useAdminNavigate, } from "./navigation/destinations.js";
+export { createOperatorAdminNavigation, } from "./navigation/operator-navigation.js";
+export { AdminExtensionsProvider, useAdminExtensions, } from "./providers/admin-extensions.js";
+export { AdminProvider } from "./providers/admin-provider.js";
+export { DEFAULT_ADMIN_LOCALE, DEFAULT_ADMIN_LOCALES, LocaleProvider, resolveAdminLocale, useLocale, } from "./providers/locale.js";
+export { AdminLocalePreferenceSync, } from "./providers/locale-preferences.js";
+export { getOperatorAdminMessageOverridesFromUiPrefs, OperatorAdminMessagesProvider, useOperatorAdminI18n, useOperatorAdminMessages, useOptionalOperatorAdminI18n, useOptionalOperatorAdminMessages, } from "./providers/operator-admin-messages.js";
+export { AdminDomainMessagesProviderStack, AdminProviderSequence, OperatorAdminShellProvider, } from "./providers/operator-admin-shell.js";
+export { makeQueryClient } from "./providers/query-client.js";
+export { ThemeProvider, useTheme, } from "./providers/theme.js";
+export { BETA, COMING_SOON, } from "./types.js";

package/dist/lib/i18n.d.ts

@@ -0,0 +1,2 @@
+export { composeLocaleMessageDefinitions, createLocaleFormatters, createPackageMessagesContext, type DeepPartial, dmcAdminMessageDefinitions, formatMessage, getLocaleMessageOverridesFromUiPrefs, type LocaleFormatters, type LocaleMessageDefinitions, type LocaleMessageOverrides, type LocaleMessageSchema, MessagesProvider, operatorAdminMessageDefinitions, type PackageI18nValue, type PackageMessagesProviderProps, type ResolvedPackageMessagesProviderProps, resolveLocaleMessages, resolvePackageMessages, useMessages, useResolvedLocaleMessages, } from "@voyant-travel/i18n";
+//# sourceMappingURL=i18n.d.ts.map

package/dist/lib/i18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../src/lib/i18n.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,+BAA+B,EAC/B,sBAAsB,EACtB,4BAA4B,EAC5B,KAAK,WAAW,EAChB,0BAA0B,EAC1B,aAAa,EACb,oCAAoC,EACpC,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,gBAAgB,EAChB,+BAA+B,EAC/B,KAAK,gBAAgB,EACrB,KAAK,4BAA4B,EACjC,KAAK,oCAAoC,EACzC,qBAAqB,EACrB,sBAAsB,EACtB,WAAW,EACX,yBAAyB,GAC1B,MAAM,qBAAqB,CAAA"}

package/dist/lib/i18n.js

@@ -0,0 +1 @@
+export { composeLocaleMessageDefinitions, createLocaleFormatters, createPackageMessagesContext, dmcAdminMessageDefinitions, formatMessage, getLocaleMessageOverridesFromUiPrefs, MessagesProvider, operatorAdminMessageDefinitions, resolveLocaleMessages, resolvePackageMessages, useMessages, useResolvedLocaleMessages, } from "@voyant-travel/i18n";

package/dist/lib/initials.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Derives a two-character uppercase initials string from a user's name or
+ * email address. Used by avatar fallbacks.
+ *
+ * Rules (in priority order):
+ * 1. If `firstName` + `lastName` are available → "FL"
+ * 2. If only `firstName` → first two characters of first name
+ * 3. If only `lastName` → first two characters of last name
+ * 4. If `email` has a prefix of ≥2 chars → first two characters of prefix
+ * 5. If `email` prefix is 1 char → that character
+ * 6. Otherwise → "?"
+ */
+export declare function getInitials(firstName?: string | null, lastName?: string | null, email?: string | null): string;
+/**
+ * Computes display name for a user, preferring `firstName + lastName`, falling
+ * back to `name`, then `email`, then "Unknown User".
+ */
+export declare function getDisplayName(user: {
+    firstName?: string | null;
+    lastName?: string | null;
+    name?: string | null;
+    email?: string | null;
+}): string;
+//# sourceMappingURL=initials.d.ts.map

package/dist/lib/initials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initials.d.ts","sourceRoot":"","sources":["../../src/lib/initials.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CACzB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,EACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,EACxB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GACpB,MAAM,CAkBR;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE;IACnC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB,GAAG,MAAM,CAMT"}

package/dist/lib/initials.js

@@ -0,0 +1,45 @@
+/**
+ * Derives a two-character uppercase initials string from a user's name or
+ * email address. Used by avatar fallbacks.
+ *
+ * Rules (in priority order):
+ * 1. If `firstName` + `lastName` are available → "FL"
+ * 2. If only `firstName` → first two characters of first name
+ * 3. If only `lastName` → first two characters of last name
+ * 4. If `email` has a prefix of ≥2 chars → first two characters of prefix
+ * 5. If `email` prefix is 1 char → that character
+ * 6. Otherwise → "?"
+ */
+export function getInitials(firstName, lastName, email) {
+    const f = (firstName ?? "").trim();
+    const l = (lastName ?? "").trim();
+    if (f && l) {
+        return (f.charAt(0) + l.charAt(0)).toUpperCase();
+    }
+    if (f) {
+        return f.slice(0, 2).toUpperCase();
+    }
+    if (l) {
+        return l.slice(0, 2).toUpperCase();
+    }
+    const prefix = (email ?? "").split("@")[0] ?? "";
+    if (prefix.length >= 2)
+        return prefix.slice(0, 2).toUpperCase();
+    if (prefix.length === 1)
+        return prefix.toUpperCase();
+    return "?";
+}
+/**
+ * Computes display name for a user, preferring `firstName + lastName`, falling
+ * back to `name`, then `email`, then "Unknown User".
+ */
+export function getDisplayName(user) {
+    const combined = [user.firstName, user.lastName].filter(Boolean).join(" ").trim();
+    if (combined)
+        return combined;
+    if (user.name?.trim())
+        return user.name.trim();
+    if (user.email?.trim())
+        return user.email.trim();
+    return "Unknown User";
+}