@voyant-travel/admin-app 0.10.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for describing the origin of the Work and
+      reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may accept and charge a
+      fee for, the acceptance of support, warranty, indemnity, or
+      other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 PixelMakers Studio SRL
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,86 @@
+# @voyant-travel/admin-app
+
+First-party admin app composition package.
+
+The reusable shell implementation lives in `@voyant-travel/admin/app/*` so the
+top-level `admin` package owns the packaged staff shell and extension surface.
+This package re-exports those shell helpers for compatibility and owns the
+domain-backed core extension bundle that imports first-party domain React
+packages.
+
+## What it provides
+
+- **`createAdminRouter({ routeTree })`** / **`createAdminQueryClient()`** —
+  TanStack Router + QueryClient with the Voyant defaults: intent preloading
+  with matched staleTime, scroll restoration, default not-found page, and
+  QueryClient SSR dehydrate/hydrate.
+- **`adminRootHead({ title, ... })`** / **`AdminRootShell`** /
+  **`AdminRootErrorBoundary`** — the root route internals, including the
+  pre-hydration theme/locale bootstrap script (no theme flash) and an error
+  boundary that survives outside the provider tree.
+- **`createAdminWorkspaceBeforeLoad({ getCurrentUser })`** — the auth guard,
+  in `beforeLoad` so the redirect short-circuits child loaders instead of
+  racing them.
+- **`AdminWorkspaceShell`** — bootstrap gate → per-user message overrides →
+  locale sync → workspace layout, with `AdminRouterLink` (Slot-compatible,
+  external-URL-aware) as the default nav link. Pass `destinations` (a
+  `satisfies AdminDestinationResolvers` map) to mount the semantic-destination
+  contract: packaged pages resolve `AdminDestinations` keys to hrefs via
+  `useAdminHref`/`useAdminNavigate`, and the shell routes them through the app
+  router.
+- **`createAdminCoreExtension(options?)`** — dashboard, account, and settings
+  route contributions backed by first-party domain React packages.
+
+## Usage
+
+```tsx
+// src/router.tsx
+import { createAdminRouter } from "@voyant-travel/admin/app"
+
+export const getRouter = () => createAdminRouter({ routeTree })
+
+// src/routes/__root.tsx
+import { AdminRootErrorBoundary, AdminRootShell, adminRootHead } from "@voyant-travel/admin/app/root"
+
+export const Route = createRootRouteWithContext<AdminRouterContext>()({
+  head: () => adminRootHead({ title: "Acme Admin" }),
+  shellComponent: AdminRootShell,
+  component: RootComponent, // app-owned: mounts the app's provider stack
+  errorComponent: AdminRootErrorBoundary,
+})
+
+// src/routes/_workspace/route.tsx
+import {
+  AdminWorkspacePendingFallback,
+  AdminWorkspaceShell,
+  createAdminWorkspaceBeforeLoad,
+} from "@voyant-travel/admin/app/workspace"
+
+export const Route = createFileRoute("/_workspace")({
+  ssr: "data-only",
+  beforeLoad: createAdminWorkspaceBeforeLoad({ getCurrentUser }),
+  loader: ({ context }) => ({ user: context.user }),
+  pendingComponent: AdminWorkspacePendingFallback,
+  component: () => (
+    <AdminWorkspaceShell
+      user={user}
+      icons={navigationIcons}
+      extensions={(messages) => createMyAdminExtensions(messages)}
+      destinations={myAdminDestinations} // key → href resolvers, satisfies AdminDestinationResolvers
+      onSignOut={() => signOut({ redirectTo: "/sign-in" })}
+    >
+      <Outlet />
+    </AdminWorkspaceShell>
+  ),
+})
+```
+
+What stays app-owned: the provider list (which domain modules are mounted),
+extension definitions, navigation icons, branding, and the auth client.
+
+New first-party code should import shell helpers from `@voyant-travel/admin/app/*`
+and the domain-backed core extension from `@voyant-travel/admin-app/core-extension`.
+
+## License
+
+Apache-2.0

package/dist/core-extension/index.d.ts

@@ -0,0 +1,105 @@
+import { type AdminExtension, type AdminRouteLoaderContext, type AdminRoutePageModule } from "@voyant-travel/admin/extensions";
+import { type AdminCoreSettingsExtraNavEntry, type AdminCoreSettingsNavGroup, type AdminCoreSettingsNavIcon, type AdminCoreSettingsPageId } from "./settings-nav.js";
+export type { AdminCoreSettingsNavGroup, AdminCoreSettingsNavIcon, AdminCoreSettingsPageId, } from "./settings-nav.js";
+/**
+ * The CORE admin extension (packaged-admin RFC §4.2/§4.8): the pages every
+ * Voyant admin ships regardless of mounted domains — the dashboard host,
+ * the account page, and the settings area (layout + built-in pages). These
+ * were the last starter-owned operator pages; they now arrive as
+ * extension route contributions bound through the host's code-assembled
+ * route tree, exactly like the domain extensions.
+ *
+ * NAVIGATION: deliberately none — Dashboard and Settings are part of the
+ * BASE operator navigation (`createOperatorAdminNavigation` in
+ * `@voyant-travel/admin`), and Account is linked from the user menu.
+ *
+ * ROUTES:
+ * - `/` — the dashboard (`DashboardPage` from `@voyant-travel/admin/dashboard`,
+ *   kept behind a lazy page module because it pulls recharts). Data comes
+ *   from the page's own client-side queries; hosts with SSR aggregates
+ *   supply a loader via {@link AdminCoreDashboardOptions.loader} (the
+ *   loader and the page share the dashboard query keys).
+ * - `/account` — `AccountPage` from `@voyant-travel/auth-react`. Localized when
+ *   the host mounts `AuthUiMessagesProvider` (e.g. through the shell's
+ *   `domainMessageProviders`); otherwise English defaults.
+ * - `/settings` — layout route (grouped sub-nav + outlet) with nested
+ *   children (the first nested contributions — hosts bind them via
+ *   `adminExtensionRouteOptions` for the statically known children plus
+ *   `adminExtensionChildRoutes` for app-supplied {@link
+ *   AdminCoreSettingsOptions.extraPages}): an index redirect and the nine
+ *   built-in pages (team, API tokens, channels, taxes, cost categories,
+ *   pricing categories, price catalogs, product types, product tags).
+ *
+ * EJECTION/DISABLING: pass `false` for a surface (`dashboard`, `account`,
+ * `settings`) to drop its contributions entirely (then own the route in
+ * the host), or `settings.omit` to drop individual built-in settings pages.
+ */
+export interface CreateAdminCoreExtensionOptions {
+    /** `false` ejects the dashboard route from the extension. */
+    dashboard?: false | AdminCoreDashboardOptions;
+    /** `false` ejects the account route from the extension. */
+    account?: false | AdminCoreAccountOptions;
+    /** `false` ejects the whole settings area from the extension. */
+    settings?: false | AdminCoreSettingsOptions;
+}
+export interface AdminCoreDashboardOptions {
+    /**
+     * App-supplied data loader (e.g. server-function aggregates that read the
+     * database directly during SSR). Must populate the dashboard query keys
+     * (`dashboardQueryKeys` from `@voyant-travel/admin/dashboard/query-options`);
+     * without it the page fetches client-side through the admin API.
+     */
+    loader?: (ctx: AdminRouteLoaderContext) => unknown;
+    /** Per-route SSR mode. Default `"data-only"`. */
+    ssr?: boolean | "data-only";
+}
+export interface AdminCoreAccountOptions {
+    /** Per-route SSR mode. Default: inherit the router/parent default. */
+    ssr?: boolean | "data-only";
+}
+export interface AdminCoreSettingsOptions {
+    /** Mount path of the settings area. Default `/settings`. */
+    basePath?: string;
+    /**
+     * Where the settings index redirects. Default `<basePath>/channels`
+     * (skipped automatically when `channels` is omitted — then the first
+     * remaining built-in page wins).
+     */
+    indexRedirectTo?: string;
+    /** Built-in settings pages to drop (route + nav entry). */
+    omit?: ReadonlyArray<AdminCoreSettingsPageId>;
+    /**
+     * App-custom settings pages: spliced into the layout's sub-navigation
+     * and bound as child routes of the settings layout. Hosts bind them at
+     * runtime via `adminExtensionChildRoutes` (they are invisible to
+     * `voyant admin generate --routes`, so they get no typed-link entries).
+     */
+    extraPages?: ReadonlyArray<AdminCoreSettingsExtraPage>;
+}
+export interface AdminCoreSettingsExtraPage {
+    /** Unique page id; the contribution id becomes `core-settings-<id>`. */
+    id: string;
+    /** Path relative to the settings base path, starting with `/` (e.g. `"/operator"`). */
+    path: string;
+    /** Route title ({@link AdminRoutePageModule} pages receive it as `title`). */
+    title: string;
+    /**
+     * Settings sub-nav label. The function form resolves against the live
+     * operator admin messages (stays localized on locale switch); defaults
+     * to `title`.
+     */
+    label?: AdminCoreSettingsExtraNavEntry["label"];
+    icon?: AdminCoreSettingsNavIcon;
+    /** Nav group. Default `"general"`. */
+    group?: AdminCoreSettingsNavGroup;
+    /**
+     * Position within the group. Built-ins use 20–80 (general) and 10–20
+     * (products); pass e.g. `10` to lead the general group. Default `100`.
+     */
+    order?: number;
+    page: () => Promise<AdminRoutePageModule>;
+    loader?: (ctx: AdminRouteLoaderContext) => unknown;
+    ssr?: boolean | "data-only";
+}
+export declare function createAdminCoreExtension(options?: CreateAdminCoreExtensionOptions): AdminExtension;
+//# sourceMappingURL=index.d.ts.map

package/dist/core-extension/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core-extension/index.tsx"],"names":[],"mappings":"AAKA,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EAI1B,MAAM,iCAAiC,CAAA;AAExC,OAAO,EACL,KAAK,8BAA8B,EACnC,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAE7B,MAAM,mBAAmB,CAAA;AAE1B,YAAY,EACV,yBAAyB,EACzB,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,mBAAmB,CAAA;AAE1B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,WAAW,+BAA+B;IAC9C,6DAA6D;IAC7D,SAAS,CAAC,EAAE,KAAK,GAAG,yBAAyB,CAAA;IAC7C,2DAA2D;IAC3D,OAAO,CAAC,EAAE,KAAK,GAAG,uBAAuB,CAAA;IACzC,iEAAiE;IACjE,QAAQ,CAAC,EAAE,KAAK,GAAG,wBAAwB,CAAA;CAC5C;AAED,MAAM,WAAW,yBAAyB;IACxC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,uBAAuB,KAAK,OAAO,CAAA;IAClD,iDAAiD;IACjD,GAAG,CAAC,EAAE,OAAO,GAAG,WAAW,CAAA;CAC5B;AAED,MAAM,WAAW,uBAAuB;IACtC,sEAAsE;IACtE,GAAG,CAAC,EAAE,OAAO,GAAG,WAAW,CAAA;CAC5B;AAED,MAAM,WAAW,wBAAwB;IACvC,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,2DAA2D;IAC3D,IAAI,CAAC,EAAE,aAAa,CAAC,uBAAuB,CAAC,CAAA;IAC7C;;;;;OAKG;IACH,UAAU,CAAC,EAAE,aAAa,CAAC,0BAA0B,CAAC,CAAA;CACvD;AAED,MAAM,WAAW,0BAA0B;IACzC,wEAAwE;IACxE,EAAE,EAAE,MAAM,CAAA;IACV,uFAAuF;IACvF,IAAI,EAAE,MAAM,CAAA;IACZ,8EAA8E;IAC9E,KAAK,EAAE,MAAM,CAAA;IACb;;;;OAIG;IACH,KAAK,CAAC,EAAE,8BAA8B,CAAC,OAAO,CAAC,CAAA;IAC/C,IAAI,CAAC,EAAE,wBAAwB,CAAA;IAC/B,sCAAsC;IACtC,KAAK,CAAC,EAAE,yBAAyB,CAAA;IACjC;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,OAAO,CAAC,oBAAoB,CAAC,CAAA;IACzC,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,uBAAuB,KAAK,OAAO,CAAA;IAClD,GAAG,CAAC,EAAE,OAAO,GAAG,WAAW,CAAA;CAC5B;AAUD,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,+BAAoC,GAC5C,cAAc,CA4ChB"}

package/dist/core-extension/index.js

@@ -0,0 +1,179 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// Lean static only: the dashboard skeleton (pending boundary). Every page —
+// dashboard (recharts), account, and the settings pages — resolves through
+// dynamic imports of SPECIFIC modules (never barrels) inside `page`/`loader`
+// thunks, so the heavy chunks load on navigation, not with workspace chrome.
+import { DashboardSkeleton } from "@voyant-travel/admin/dashboard/skeleton";
+import { adminRoutePageModule, defineAdminExtension, } from "@voyant-travel/admin/extensions";
+import { adminCoreSettingsNavEntries, } from "./settings-nav.js";
+/** Default fetcher for the built-in settings loaders (cookie-authenticated). */
+const coreFetcher = (url, init) => fetch(url, { credentials: "include", ...init });
+function coreClient(ctx) {
+    return { baseUrl: ctx.runtime.baseUrl, fetcher: ctx.runtime.fetcher ?? coreFetcher };
+}
+export function createAdminCoreExtension(options = {}) {
+    const { dashboard = {}, account = {}, settings = {} } = options;
+    const routes = [];
+    if (dashboard !== false) {
+        routes.push({
+            id: "core-dashboard",
+            path: "/",
+            title: "Dashboard",
+            ssr: dashboard.ssr ?? "data-only",
+            // DashboardPage pulls recharts — the lazy page module keeps it out of
+            // the workspace-chrome chunk that evaluates this factory.
+            page: () => import("@voyant-travel/admin/dashboard").then((module) => adminRoutePageModule(module.DashboardPage)),
+            loader: dashboard.loader,
+            pendingComponent: DashboardSkeleton,
+        });
+    }
+    if (account !== false) {
+        routes.push({
+            id: "core-account",
+            path: "/account",
+            title: "Account",
+            ssr: account.ssr,
+            page: async () => {
+                const { AccountPage } = await import("@voyant-travel/auth-react/account");
+                // The workspace inset header already renders the sidebar trigger —
+                // suppress the page shell's own to avoid doubling it.
+                function CoreAccountPage() {
+                    return _jsx(AccountPage, { showSidebarTrigger: false });
+                }
+                return { default: CoreAccountPage };
+            },
+        });
+    }
+    if (settings !== false) {
+        routes.push(createSettingsContribution(settings));
+    }
+    return defineAdminExtension({ id: "core", routes });
+}
+function createSettingsContribution(options) {
+    const { basePath = "/settings", omit = [], extraPages = [] } = options;
+    const entries = adminCoreSettingsNavEntries.filter((entry) => !omit.includes(entry.id));
+    const indexRedirectTo = options.indexRedirectTo ??
+        (entries.some((entry) => entry.id === "channels")
+            ? `${basePath}/channels`
+            : `${basePath}${entries[0]?.path ?? "/channels"}`);
+    const extras = extraPages.map((page) => ({
+        id: page.id,
+        href: `${basePath}${page.path}`,
+        icon: page.icon,
+        group: page.group ?? "general",
+        order: page.order ?? 100,
+        label: page.label ?? page.title,
+    }));
+    const children = [
+        {
+            id: "core-settings-index",
+            path: "/",
+            title: "Settings",
+            redirectTo: indexRedirectTo,
+        },
+        ...entries.map((entry) => createBuiltInSettingsPage(entry.id)),
+        ...extraPages.map((page) => ({
+            id: `core-settings-${page.id}`,
+            path: page.path,
+            title: page.title,
+            page: page.page,
+            loader: page.loader,
+            ssr: page.ssr,
+        })),
+    ];
+    return {
+        id: "core-settings",
+        path: basePath,
+        title: "Settings",
+        page: async () => {
+            const { AdminCoreSettingsLayout } = await import("./settings-layout.js");
+            function CoreSettingsLayoutPage() {
+                return _jsx(AdminCoreSettingsLayout, { basePath: basePath, omit: omit, extras: extras });
+            }
+            return { default: CoreSettingsLayoutPage };
+        },
+        children,
+    };
+}
+function createBuiltInSettingsPage(id) {
+    const entry = adminCoreSettingsNavEntries.find((candidate) => candidate.id === id);
+    if (!entry) {
+        throw new Error(`[voyant-admin] Unknown core settings page "${id}".`);
+    }
+    const base = { id: `core-settings-${id}`, path: entry.path, title: entry.defaultTitle };
+    switch (id) {
+        case "team":
+            return {
+                ...base,
+                page: () => import("@voyant-travel/admin/components/team-settings-page").then((module) => adminRoutePageModule(module.TeamSettingsPage)),
+            };
+        case "api-tokens":
+            return {
+                ...base,
+                page: () => import("@voyant-travel/auth-react/components/service-api-keys-page").then((module) => adminRoutePageModule(module.ApiTokensPage)),
+            };
+        case "channels":
+            return {
+                ...base,
+                ssr: "data-only",
+                page: () => import("@voyant-travel/distribution-react/components/channels-page").then((module) => adminRoutePageModule(module.ChannelsPage)),
+                // Dynamic import on purpose: the query options pull the domain data
+                // layer (client + response schemas), and a static import here would
+                // pin it into the workspace-chrome chunk evaluating this factory.
+                loader: async (ctx) => {
+                    const { getChannelsQueryOptions } = await import("@voyant-travel/distribution-react");
+                    return ctx.queryClient.ensureQueryData(getChannelsQueryOptions(coreClient(ctx), { limit: 25, offset: 0 }));
+                },
+            };
+        case "taxes":
+            return {
+                ...base,
+                page: () => import("@voyant-travel/finance-react/components/taxes-page").then((module) => adminRoutePageModule(module.TaxesPage)),
+            };
+        case "cost-categories":
+            return {
+                ...base,
+                page: () => import("@voyant-travel/finance-react/components/cost-categories-page").then((module) => adminRoutePageModule(module.CostCategoriesPage)),
+            };
+        case "pricing-categories":
+            return {
+                ...base,
+                ssr: "data-only",
+                page: () => import("@voyant-travel/commerce-react/pricing/components/pricing-categories-page").then((module) => adminRoutePageModule(module.PricingCategoriesPage)),
+                loader: async (ctx) => {
+                    const { getPricingCategoriesQueryOptions } = await import("@voyant-travel/commerce-react/pricing");
+                    return ctx.queryClient.ensureQueryData(getPricingCategoriesQueryOptions(coreClient(ctx), { limit: 25, active: undefined }));
+                },
+            };
+        case "price-catalogs":
+            return {
+                ...base,
+                ssr: "data-only",
+                page: () => import("@voyant-travel/commerce-react/pricing/components/price-catalogs-page").then((module) => adminRoutePageModule(module.PriceCatalogsPage)),
+                loader: async (ctx) => {
+                    const { getPriceCatalogsQueryOptions } = await import("@voyant-travel/commerce-react/pricing");
+                    return ctx.queryClient.ensureQueryData(getPriceCatalogsQueryOptions(coreClient(ctx), { limit: 25, offset: 0 }));
+                },
+            };
+        case "product-types":
+            return {
+                ...base,
+                ssr: "data-only",
+                page: () => import("@voyant-travel/inventory-react/components/product-types-page").then((module) => adminRoutePageModule(module.ProductTypesPage)),
+                loader: async (ctx) => {
+                    const { getProductTypesQueryOptions } = await import("@voyant-travel/inventory-react");
+                    return ctx.queryClient.ensureQueryData(getProductTypesQueryOptions(coreClient(ctx), { limit: 25, offset: 0 }));
+                },
+            };
+        case "product-tags":
+            return {
+                ...base,
+                ssr: "data-only",
+                page: () => import("@voyant-travel/inventory-react/components/product-tags-page").then((module) => adminRoutePageModule(module.ProductTagsPage)),
+                loader: async (ctx) => {
+                    const { getProductTagsQueryOptions } = await import("@voyant-travel/inventory-react");
+                    return ctx.queryClient.ensureQueryData(getProductTagsQueryOptions(coreClient(ctx), { limit: 25, offset: 0 }));
+                },
+            };
+    }
+}

package/dist/core-extension/settings-layout.d.ts

@@ -0,0 +1,18 @@
+import { type AdminCoreSettingsExtraNavEntry, type AdminCoreSettingsPageId } from "./settings-nav.js";
+/**
+ * The settings area layout (packaged from the operator starter's
+ * `SettingsLayout`): a grouped sub-navigation sidebar plus an outlet for
+ * the active settings page. Mounted as the core extension's `/settings`
+ * layout route; the child pages render into the outlet.
+ *
+ * Built-in nav entries resolve their labels reactively through
+ * `useOperatorAdminMessages`; app-supplied extras pass a string or a
+ * messages-resolver through the core extension factory.
+ */
+export interface AdminCoreSettingsLayoutProps {
+    basePath: string;
+    omit?: ReadonlyArray<AdminCoreSettingsPageId>;
+    extras?: ReadonlyArray<AdminCoreSettingsExtraNavEntry>;
+}
+export declare function AdminCoreSettingsLayout({ basePath, omit, extras, }: AdminCoreSettingsLayoutProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=settings-layout.d.ts.map

package/dist/core-extension/settings-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-layout.d.ts","sourceRoot":"","sources":["../../src/core-extension/settings-layout.tsx"],"names":[],"mappings":"AAIA,OAAO,EACL,KAAK,8BAA8B,EAGnC,KAAK,uBAAuB,EAE7B,MAAM,mBAAmB,CAAA;AAE1B;;;;;;;;;GASG;AACH,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,aAAa,CAAC,uBAAuB,CAAC,CAAA;IAC7C,MAAM,CAAC,EAAE,aAAa,CAAC,8BAA8B,CAAC,CAAA;CACvD;AAUD,wBAAgB,uBAAuB,CAAC,EACtC,QAAQ,EACR,IAAS,EACT,MAAW,GACZ,EAAE,4BAA4B,2CAmF9B"}

package/dist/core-extension/settings-layout.js

@@ -0,0 +1,48 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Link, Outlet, useRouterState } from "@tanstack/react-router";
+import { useOperatorAdminMessages } from "@voyant-travel/admin/providers/operator-admin-messages";
+import { cn } from "@voyant-travel/ui/lib/utils";
+import { adminCoreSettingsNavEntries, } from "./settings-nav.js";
+export function AdminCoreSettingsLayout({ basePath, omit = [], extras = [], }) {
+    const messages = useOperatorAdminMessages();
+    const pathname = useRouterState({ select: (state) => state.location.pathname });
+    const itemsByGroup = new Map();
+    const push = (group, item) => {
+        const bucket = itemsByGroup.get(group) ?? [];
+        bucket.push(item);
+        itemsByGroup.set(group, bucket);
+    };
+    for (const entry of adminCoreSettingsNavEntries) {
+        if (omit.includes(entry.id))
+            continue;
+        push(entry.group, {
+            id: entry.id,
+            label: entry.label(messages.settings),
+            href: `${basePath}${entry.path}`,
+            icon: entry.icon,
+            order: entry.order,
+        });
+    }
+    for (const extra of extras) {
+        push(extra.group, {
+            id: extra.id,
+            label: typeof extra.label === "function" ? extra.label(messages) : extra.label,
+            href: extra.href,
+            icon: extra.icon,
+            order: extra.order,
+        });
+    }
+    const navGroups = [
+        { group: "general", title: messages.settings.generalGroup },
+        { group: "products", title: messages.settings.productsGroup },
+    ]
+        .map(({ group, title }) => ({
+        title,
+        items: [...(itemsByGroup.get(group) ?? [])].sort((a, b) => a.order - b.order),
+    }))
+        .filter((group) => group.items.length > 0);
+    const isActive = (href) => pathname.replace(/\/$/, "") === href;
+    return (_jsxs("div", { className: "flex h-[calc(100vh-0px)]", children: [_jsxs("aside", { className: "w-64 shrink-0 overflow-y-auto border-r p-6", children: [_jsx("h1", { className: "text-xl font-semibold tracking-tight", children: messages.settings.title }), _jsx("p", { className: "mt-1 text-sm text-muted-foreground", children: messages.settings.description }), _jsx("nav", { className: "mt-6 flex flex-col gap-6", children: navGroups.map((group) => (_jsxs("div", { children: [_jsx("h3", { className: "mb-2 px-3 text-xs font-medium uppercase tracking-wider text-muted-foreground", children: group.title }), _jsx("ul", { className: "flex flex-col gap-0.5", children: group.items.map((item) => (_jsx("li", { children: _jsxs(Link, { to: item.href, className: cn("flex items-center gap-2.5 rounded-md px-3 py-2 text-sm transition-colors", isActive(item.href)
+                                                ? "bg-accent font-medium text-accent-foreground"
+                                                : "text-muted-foreground hover:bg-accent/50 hover:text-foreground"), children: [item.icon ? _jsx(item.icon, { className: "h-4 w-4" }) : null, item.label] }) }, item.href))) })] }, group.title))) })] }), _jsx("div", { className: "flex-1 overflow-y-auto", children: _jsx(Outlet, {}) })] }));
+}

package/dist/core-extension/settings-nav.d.ts

@@ -0,0 +1,43 @@
+import type { OperatorAdminMessages } from "@voyant-travel/admin/providers/operator-admin-messages";
+import type * as React from "react";
+/**
+ * Catalog of the BUILT-IN settings pages the admin core extension ships
+ * (packaged-admin RFC §4.2 — the operator's former
+ * `src/routes/_workspace/settings/*` files). One entry drives both the
+ * route contribution (id/path) and the settings layout's sub-navigation
+ * (label/icon/group/order), so the two can never drift.
+ */
+export type AdminCoreSettingsPageId = "team" | "api-tokens" | "channels" | "taxes" | "cost-categories" | "pricing-categories" | "price-catalogs" | "product-types" | "product-tags";
+export type AdminCoreSettingsNavGroup = "general" | "products";
+/** Icon component contract — lucide icons satisfy it without depending on them. */
+export type AdminCoreSettingsNavIcon = React.ComponentType<{
+    className?: string;
+}>;
+export interface AdminCoreSettingsNavEntry {
+    id: AdminCoreSettingsPageId;
+    /** Child path relative to the settings base path (starts with `/`). */
+    path: string;
+    icon: AdminCoreSettingsNavIcon;
+    group: AdminCoreSettingsNavGroup;
+    /**
+     * Position within the group. Built-ins use 20–80 (general) and 10–20
+     * (products); app extras pick numbers around them (e.g. 10 to lead the
+     * general group).
+     */
+    order: number;
+    /** Reactive nav label, resolved against the live operator admin messages. */
+    label: (settings: OperatorAdminMessages["settings"]) => string;
+    /** Default (English) route title for the contribution. */
+    defaultTitle: string;
+}
+export declare const adminCoreSettingsNavEntries: ReadonlyArray<AdminCoreSettingsNavEntry>;
+/** Extra (app-supplied) entry the settings layout splices into its nav. */
+export interface AdminCoreSettingsExtraNavEntry {
+    id: string;
+    href: string;
+    icon?: AdminCoreSettingsNavIcon;
+    group: AdminCoreSettingsNavGroup;
+    order: number;
+    label: string | ((messages: OperatorAdminMessages) => string);
+}
+//# sourceMappingURL=settings-nav.d.ts.map

package/dist/core-extension/settings-nav.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-nav.d.ts","sourceRoot":"","sources":["../../src/core-extension/settings-nav.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wDAAwD,CAAA;AAEnG,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAA;AAEnC;;;;;;GAMG;AAEH,MAAM,MAAM,uBAAuB,GAC/B,MAAM,GACN,YAAY,GACZ,UAAU,GACV,OAAO,GACP,iBAAiB,GACjB,oBAAoB,GACpB,gBAAgB,GAChB,eAAe,GACf,cAAc,CAAA;AAElB,MAAM,MAAM,yBAAyB,GAAG,SAAS,GAAG,UAAU,CAAA;AAE9D,mFAAmF;AACnF,MAAM,MAAM,wBAAwB,GAAG,KAAK,CAAC,aAAa,CAAC;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAA;AAElF,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,uBAAuB,CAAA;IAC3B,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,wBAAwB,CAAA;IAC9B,KAAK,EAAE,yBAAyB,CAAA;IAChC;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAA;IACb,6EAA6E;IAC7E,KAAK,EAAE,CAAC,QAAQ,EAAE,qBAAqB,CAAC,UAAU,CAAC,KAAK,MAAM,CAAA;IAC9D,0DAA0D;IAC1D,YAAY,EAAE,MAAM,CAAA;CACrB;AAED,eAAO,MAAM,2BAA2B,EAAE,aAAa,CAAC,yBAAyB,CAkFhF,CAAA;AAED,2EAA2E;AAC3E,MAAM,WAAW,8BAA8B;IAC7C,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,wBAAwB,CAAA;IAC/B,KAAK,EAAE,yBAAyB,CAAA;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,GAAG,CAAC,CAAC,QAAQ,EAAE,qBAAqB,KAAK,MAAM,CAAC,CAAA;CAC9D"}

package/dist/core-extension/settings-nav.js

@@ -0,0 +1,84 @@
+import { Coins, Hash, KeyRound, Layers, Package, Percent, Tag, Tags, Users } from "lucide-react";
+export const adminCoreSettingsNavEntries = [
+    {
+        id: "team",
+        path: "/team",
+        icon: Users,
+        group: "general",
+        order: 20,
+        label: (settings) => settings.team,
+        defaultTitle: "Team",
+    },
+    {
+        id: "api-tokens",
+        path: "/api-tokens",
+        icon: KeyRound,
+        group: "general",
+        order: 30,
+        label: (settings) => settings.apiTokens,
+        defaultTitle: "API Tokens",
+    },
+    {
+        id: "channels",
+        path: "/channels",
+        icon: Hash,
+        group: "general",
+        order: 40,
+        label: (settings) => settings.channels,
+        defaultTitle: "Channels",
+    },
+    {
+        id: "taxes",
+        path: "/taxes",
+        icon: Percent,
+        group: "general",
+        order: 50,
+        label: (settings) => settings.taxes,
+        defaultTitle: "Taxes",
+    },
+    {
+        id: "cost-categories",
+        path: "/cost-categories",
+        icon: Coins,
+        group: "general",
+        order: 60,
+        label: (settings) => settings.costCategories,
+        defaultTitle: "Cost Categories",
+    },
+    {
+        id: "pricing-categories",
+        path: "/pricing-categories",
+        icon: Tags,
+        group: "general",
+        order: 70,
+        label: (settings) => settings.pricingCategories,
+        defaultTitle: "Pricing Categories",
+    },
+    {
+        id: "price-catalogs",
+        path: "/price-catalogs",
+        icon: Layers,
+        group: "general",
+        order: 80,
+        label: (settings) => settings.priceCatalogs,
+        defaultTitle: "Price Catalogs",
+    },
+    {
+        id: "product-types",
+        path: "/product-types",
+        icon: Package,
+        group: "products",
+        order: 10,
+        label: (settings) => settings.productTypes,
+        defaultTitle: "Product Types",
+    },
+    {
+        id: "product-tags",
+        path: "/product-tags",
+        icon: Tag,
+        group: "products",
+        order: 20,
+        label: (settings) => settings.productTags,
+        defaultTitle: "Product Tags",
+    },
+];

package/dist/extension-routes.d.ts

@@ -0,0 +1,2 @@
+export * from "@voyant-travel/admin/app/extension-routes";
+//# sourceMappingURL=extension-routes.d.ts.map

package/dist/extension-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-routes.d.ts","sourceRoot":"","sources":["../src/extension-routes.tsx"],"names":[],"mappings":"AAAA,cAAc,2CAA2C,CAAA"}

package/dist/extension-routes.js

@@ -0,0 +1 @@
+export * from "@voyant-travel/admin/app/extension-routes";

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from "@voyant-travel/admin/app";
+export * from "./core-extension/index.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":"AAAA,cAAc,0BAA0B,CAAA;AACxC,cAAc,2BAA2B,CAAA"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export * from "@voyant-travel/admin/app";
+export * from "./core-extension/index.js";

package/dist/root.d.ts

@@ -0,0 +1,2 @@
+export * from "@voyant-travel/admin/app/root";
+//# sourceMappingURL=root.d.ts.map

package/dist/root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"root.d.ts","sourceRoot":"","sources":["../src/root.tsx"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAA"}

package/dist/root.js

@@ -0,0 +1 @@
+export * from "@voyant-travel/admin/app/root";

package/dist/router.d.ts

@@ -0,0 +1,2 @@
+export * from "@voyant-travel/admin/app/router";
+//# sourceMappingURL=router.d.ts.map

package/dist/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.tsx"],"names":[],"mappings":"AAAA,cAAc,iCAAiC,CAAA"}

package/dist/router.js

@@ -0,0 +1 @@
+export * from "@voyant-travel/admin/app/router";

package/dist/workspace.d.ts

@@ -0,0 +1,2 @@
+export * from "@voyant-travel/admin/app/workspace";
+//# sourceMappingURL=workspace.d.ts.map

package/dist/workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../src/workspace.tsx"],"names":[],"mappings":"AAAA,cAAc,oCAAoC,CAAA"}

package/dist/workspace.js

@@ -0,0 +1 @@
+export * from "@voyant-travel/admin/app/workspace";

package/package.json

@@ -0,0 +1,104 @@
+{
+  "name": "@voyant-travel/admin-app",
+  "version": "0.10.0",
+  "license": "Apache-2.0",
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./root": {
+      "types": "./dist/root.d.ts",
+      "import": "./dist/root.js",
+      "default": "./dist/root.js"
+    },
+    "./router": {
+      "types": "./dist/router.d.ts",
+      "import": "./dist/router.js",
+      "default": "./dist/router.js"
+    },
+    "./workspace": {
+      "types": "./dist/workspace.d.ts",
+      "import": "./dist/workspace.js",
+      "default": "./dist/workspace.js"
+    },
+    "./core-extension": {
+      "types": "./dist/core-extension/index.d.ts",
+      "import": "./dist/core-extension/index.js",
+      "default": "./dist/core-extension/index.js"
+    }
+  },
+  "peerDependencies": {
+    "@tanstack/react-query": "^5.0.0",
+    "@tanstack/react-router": "^1.0.0",
+    "lucide-react": "^0.475.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "@voyant-travel/admin": "^0.111.0",
+    "@voyant-travel/auth-react": "^0.113.3",
+    "@voyant-travel/commerce-react": "^0.1.0",
+    "@voyant-travel/distribution-react": "^0.109.8",
+    "@voyant-travel/inventory-react": "^0.1.0",
+    "@voyant-travel/finance-react": "^0.119.5",
+    "@voyant-travel/ui": "^0.106.1"
+  },
+  "devDependencies": {
+    "@tanstack/react-query": "^5.100.11",
+    "@tanstack/react-router": "^1.170.4",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "lucide-react": "^1.7.0",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.2",
+    "@voyant-travel/admin": "^0.111.0",
+    "@voyant-travel/commerce-react": "^0.1.0",
+    "@voyant-travel/auth-react": "^0.113.3",
+    "@voyant-travel/distribution-react": "^0.109.8",
+    "@voyant-travel/finance-react": "^0.119.5",
+    "@voyant-travel/inventory-react": "^0.1.0",
+    "@voyant-travel/ui": "^0.106.1",
+    "@voyant-travel/voyant-typescript-config": "^0.1.0"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/voyant-travel/voyant.git",
+    "directory": "packages/admin-app"
+  },
+  "peerDependenciesMeta": {
+    "@voyant-travel/auth-react": {
+      "optional": true
+    },
+    "@voyant-travel/commerce-react": {
+      "optional": true
+    },
+    "@voyant-travel/distribution-react": {
+      "optional": true
+    },
+    "@voyant-travel/finance-react": {
+      "optional": true
+    },
+    "@voyant-travel/inventory-react": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist tsconfig.tsbuildinfo",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check src/ tests/",
+    "test": "vitest run --passWithNoTests"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts"
+}