@byline/host-tanstack-start 2.7.0 → 3.0.1

package/dist/admin-shell/chrome/route-error.d.ts

@@ -10,9 +10,17 @@
  * These are designed to be used as `errorComponent` and `notFoundComponent`
  * on layout routes (root, admin, public) so that errors render inside the
  * appropriate shell rather than blowing away the entire page.
+ *
+ * `RouteError` / `RouteNotFound` self-mount their own `<I18nProvider>`. A
+ * route's `errorComponent` renders *in place of that route's `component`*, so
+ * the admin layout's own `<I18nProvider>` (mounted inside that component) is
+ * gone by the time the error screen renders — calling `useTranslation` against
+ * the absent provider previously threw a *second* error that masked the real
+ * one. Self-mounting (mirroring `sign-in-page.tsx`) makes the screen localised
+ * and provider-independent wherever it renders.
  */
 import type { ErrorComponentProps, NotFoundRouteProps } from '@tanstack/react-router';
-export declare function RouteError({ error, reset }: ErrorComponentProps): import("react").JSX.Element;
+export declare function RouteError(props: ErrorComponentProps): import("react").JSX.Element;
 export declare function RouteNotFound(_props: NotFoundRouteProps): import("react").JSX.Element;
 /**
  * Minimal fallback for when providers may be broken — used at the root

package/dist/admin-shell/chrome/route-error.js

@@ -1,7 +1,8 @@
-import { jsx, jsxs } from "react/jsx-runtime";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { useContext } from "react";
 import { useRouter } from "@tanstack/react-router";
-import { BylineError, ErrorCodes } from "@byline/core";
-import { useTranslation } from "@byline/i18n/react";
+import { BylineError, ErrorCodes, getClientConfig } from "@byline/core";
+import { I18nContext, I18nProvider, useTranslation } from "@byline/i18n/react";
 import { Alert, Button, Container, Section } from "@byline/ui/react";
 import classnames from "classnames";
 import route_error_module from "./route-error.module.js";
@@ -24,7 +25,26 @@ function getErrorMessage(error, t) {
     if (error instanceof Error) return error.message;
     return t('routeError.defaultMessage');
 }
-function RouteError({ error, reset }) {
+function ErrorScreenI18nProvider({ children }) {
+    if (null != useContext(I18nContext)) return /*#__PURE__*/ jsx(Fragment, {
+        children: children
+    });
+    let bundle = {};
+    let locale = 'en';
+    try {
+        const { i18n } = getClientConfig();
+        bundle = i18n.translations ?? {};
+        locale = i18n.interface.defaultLocale;
+    } catch  {}
+    return /*#__PURE__*/ jsx(I18nProvider, {
+        bundle: bundle,
+        activeLocale: locale,
+        defaultLocale: locale,
+        localeDefinitions: [],
+        children: children
+    });
+}
+function RouteErrorContent({ error, reset }) {
     const router = useRouter();
     const { t } = useTranslation('byline-admin');
     return /*#__PURE__*/ jsx(Section, {
@@ -66,7 +86,14 @@ function RouteError({ error, reset }) {
         })
     });
 }
-function RouteNotFound(_props) {
+function RouteError(props) {
+    return /*#__PURE__*/ jsx(ErrorScreenI18nProvider, {
+        children: /*#__PURE__*/ jsx(RouteErrorContent, {
+            ...props
+        })
+    });
+}
+function RouteNotFoundContent() {
     const { t } = useTranslation('byline-admin');
     return /*#__PURE__*/ jsx(Section, {
         className: classnames('byline-route-error', route_error_module.section),
@@ -95,6 +122,11 @@ function RouteNotFound(_props) {
         })
     });
 }
+function RouteNotFound(_props) {
+    return /*#__PURE__*/ jsx(ErrorScreenI18nProvider, {
+        children: /*#__PURE__*/ jsx(RouteNotFoundContent, {})
+    });
+}
 function RootError({ error, reset }) {
     function rootMessage(err) {
         if (err instanceof Error) return err.message;

package/dist/admin-shell/collections/create.js

@@ -15,7 +15,7 @@ const CreateView = ({ collectionDefinition, adminConfig, initialData })=>{
     });
     const navigate = useNavigate();
     const { labels, path, fields } = collectionDefinition;
-    const handleSubmit = async ({ data, systemPath })=>{
+    const handleSubmit = async ({ data, systemPath, systemAvailableLocales })=>{
         try {
             await createCollectionDocument({
                 data: {
@@ -23,6 +23,9 @@ const CreateView = ({ collectionDefinition, adminConfig, initialData })=>{
                     data,
                     ...systemPath ? {
                         path: systemPath
+                    } : {},
+                    ...systemAvailableLocales ? {
+                        availableLocales: systemAvailableLocales
                     } : {}
                 }
             });
@@ -68,6 +71,7 @@ const CreateView = ({ collectionDefinition, adminConfig, initialData })=>{
                 adminConfig: adminConfig,
                 useAsTitle: collectionDefinition.useAsTitle,
                 useAsPath: collectionDefinition.useAsPath,
+                advertiseLocales: collectionDefinition.advertiseLocales,
                 headingLabel: labels.singular,
                 useNavigationGuard: useTanStackNavigationGuard,
                 onCancel: ()=>navigate({

package/dist/admin-shell/collections/edit.js

@@ -346,7 +346,7 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
             });
         }
     };
-    const handleSubmit = async ({ data: _data, patches, systemPath })=>{
+    const handleSubmit = async ({ data: _data, patches, systemPath, systemAvailableLocales })=>{
         try {
             await updateCollectionDocumentWithPatches({
                 data: {
@@ -357,6 +357,9 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
                     locale,
                     ...systemPath ? {
                         path: systemPath
+                    } : {},
+                    ...systemAvailableLocales ? {
+                        availableLocales: systemAvailableLocales
                     } : {}
                 }
             });
@@ -422,6 +425,7 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
                 adminConfig: adminConfig,
                 useAsTitle: collectionDefinition.useAsTitle,
                 useAsPath: collectionDefinition.useAsPath,
+                advertiseLocales: collectionDefinition.advertiseLocales,
                 headingLabel: labels.singular,
                 initialLocale: locale,
                 onLocaleChange: handleLocaleChange,

package/dist/server-fns/collections/create.d.ts

@@ -10,11 +10,13 @@ export declare const createCollectionDocument: import("@tanstack/react-start").R
     data: any;
     locale?: string;
     path?: string;
+    availableLocales?: string[];
 }) => {
     collection: string;
     data: any;
     locale?: string;
     path?: string;
+    availableLocales?: string[];
 }, Promise<{
     status: "ok";
 }>>;

package/dist/server-fns/collections/create.js

@@ -6,7 +6,7 @@ import { ensureCollection } from "../../integrations/api-utils.js";
 const createCollectionDocument = createServerFn({
     method: 'POST'
 }).inputValidator((input)=>input).handler(async ({ data: input })=>{
-    const { collection: path, data: documentData, locale, path: explicitPath } = input;
+    const { collection: path, data: documentData, locale, path: explicitPath, availableLocales } = input;
     const logger = getLogger();
     const config = await ensureCollection(path);
     if (!config) throw ERR_NOT_FOUND({
@@ -31,7 +31,8 @@ const createCollectionDocument = createServerFn({
         data: structuredClone(documentData),
         status: documentData.status,
         locale: locale ?? serverConfig.i18n.content.defaultLocale,
-        path: explicitPath
+        path: explicitPath,
+        availableLocales
     });
     return {
         status: 'ok'

package/dist/server-fns/collections/get.d.ts

@@ -16,6 +16,8 @@
  * `{target_document_id, target_collection_id}` refs.
  */
 export declare function getCollectionDocument(collection: string, id: string, locale?: string, depth?: number, populateRelations?: boolean): Promise<{
+    _availableVersionLocales?: string[] | undefined;
+    availableLocales?: string[] | undefined;
     _restoreWarnings?: string[] | undefined;
     _publishedVersion: Record<string, any> | null;
 } | null>;

package/dist/server-fns/collections/get.js

@@ -39,6 +39,7 @@ const getDocumentFn = createServerFn({
         populate,
         depth: resolvedDepth,
         status: 'any',
+        onMissingLocale: 'empty',
         lenient: true
     });
     if (!document) throw ERR_NOT_FOUND({
@@ -69,11 +70,19 @@ const getDocumentFn = createServerFn({
         }) : null;
     }
     const restoreWarnings = serialised._restoreWarnings;
+    const availableLocales = serialised.availableLocales;
+    const availableVersionLocales = serialised._availableVersionLocales;
     return {
         ...parsed,
         _publishedVersion: publishedVersion,
         ...restoreWarnings && restoreWarnings.length > 0 ? {
             _restoreWarnings: restoreWarnings
+        } : {},
+        ...Array.isArray(availableLocales) ? {
+            availableLocales
+        } : {},
+        ...Array.isArray(availableVersionLocales) ? {
+            _availableVersionLocales: availableVersionLocales
         } : {}
     };
 });

package/dist/server-fns/collections/history.d.ts

@@ -29,6 +29,7 @@ export declare const getCollectionDocumentHistory: import("@tanstack/react-start
         updatedAt: string;
         versionId?: string | undefined;
         path?: string | undefined;
+        sourceLocale?: string | undefined;
         hasPublishedVersion?: boolean | undefined;
     }[];
     meta: {

package/dist/server-fns/collections/list.d.ts

@@ -30,6 +30,7 @@ export declare const getCollectionDocuments: import("@tanstack/react-start").Req
         updatedAt: string;
         versionId?: string | undefined;
         path?: string | undefined;
+        sourceLocale?: string | undefined;
         hasPublishedVersion?: boolean | undefined;
     }[];
     meta: {

package/dist/server-fns/collections/list.js

@@ -33,7 +33,8 @@ const getCollectionDocuments = createServerFn({
         page: params.page,
         pageSize,
         select: params.fields,
-        status: 'any'
+        status: 'any',
+        onMissingLocale: 'empty'
     });
     const documentIds = result.docs.map((d)=>d.id);
     const publishedSet = documentIds.length > 0 ? await getServerConfig().db.queries.documents.getPublishedDocumentIds({

package/dist/server-fns/collections/update.d.ts

@@ -13,6 +13,7 @@ export declare const updateCollectionDocumentWithPatches: import("@tanstack/reac
     versionId?: string;
     locale?: string;
     path?: string;
+    availableLocales?: string[];
 }) => {
     collection: string;
     id: string;
@@ -20,6 +21,7 @@ export declare const updateCollectionDocumentWithPatches: import("@tanstack/reac
     versionId?: string;
     locale?: string;
     path?: string;
+    availableLocales?: string[];
 }, Promise<{
     status: "ok";
 }>>;

package/dist/server-fns/collections/update.js

@@ -6,7 +6,7 @@ import { ensureCollection } from "../../integrations/api-utils.js";
 const updateCollectionDocumentWithPatches = createServerFn({
     method: 'POST'
 }).inputValidator((input)=>input).handler(async ({ data: input })=>{
-    const { collection: path, id, patches, versionId, locale, path: explicitPath } = input;
+    const { collection: path, id, patches, versionId, locale, path: explicitPath, availableLocales } = input;
     const logger = getLogger();
     const config = await ensureCollection(path);
     if (!config) throw ERR_NOT_FOUND({
@@ -32,7 +32,8 @@ const updateCollectionDocumentWithPatches = createServerFn({
         patches,
         documentVersionId: versionId,
         locale: locale ?? serverConfig.i18n.content.defaultLocale,
-        path: explicitPath
+        path: explicitPath,
+        availableLocales
     });
     return {
         status: 'ok'

package/package.json

@@ -3,7 +3,7 @@
   "private": false,
   "type": "module",
   "license": "MPL-2.0",
-  "version": "2.7.0",
+  "version": "3.0.1",
   "engines": {
     "node": ">=20.9.0"
   },
@@ -115,13 +115,13 @@
     "react-swipeable": "^7.0.2",
     "uuid": "^14.0.0",
     "zod": "^4.4.3",
-    "@byline/ai": "2.7.0",
-    "@byline/core": "2.7.0",
-    "@byline/i18n": "2.7.0",
-    "@byline/client": "2.7.0",
-    "@byline/admin": "2.7.0",
-    "@byline/auth": "2.7.0",
-    "@byline/ui": "2.7.0"
+    "@byline/admin": "3.0.1",
+    "@byline/auth": "3.0.1",
+    "@byline/core": "3.0.1",
+    "@byline/ui": "3.0.1",
+    "@byline/i18n": "3.0.1",
+    "@byline/client": "3.0.1",
+    "@byline/ai": "3.0.1"
   },
   "peerDependencies": {
     "@tanstack/react-router": "^1.167.0",

package/src/admin-shell/chrome/route-error.tsx

@@ -10,14 +10,24 @@
  * These are designed to be used as `errorComponent` and `notFoundComponent`
  * on layout routes (root, admin, public) so that errors render inside the
  * appropriate shell rather than blowing away the entire page.
+ *
+ * `RouteError` / `RouteNotFound` self-mount their own `<I18nProvider>`. A
+ * route's `errorComponent` renders *in place of that route's `component`*, so
+ * the admin layout's own `<I18nProvider>` (mounted inside that component) is
+ * gone by the time the error screen renders — calling `useTranslation` against
+ * the absent provider previously threw a *second* error that masked the real
+ * one. Self-mounting (mirroring `sign-in-page.tsx`) makes the screen localised
+ * and provider-independent wherever it renders.
  */
 
+import { type ReactNode, useContext } from 'react'
 import type { ErrorComponentProps, NotFoundRouteProps } from '@tanstack/react-router'
 import { useRouter } from '@tanstack/react-router'
 
-import { BylineError, ErrorCodes } from '@byline/core'
+import { BylineError, ErrorCodes, getClientConfig } from '@byline/core'
+import type { TranslationBundle } from '@byline/i18n'
 import type { UseTranslationReturn } from '@byline/i18n/react'
-import { useTranslation } from '@byline/i18n/react'
+import { I18nContext, I18nProvider, useTranslation } from '@byline/i18n/react'
 import { Alert, Button, Container, Section } from '@byline/ui/react'
 import cx from 'classnames'
 
@@ -56,7 +66,52 @@ function getErrorMessage(error: unknown, t: Translate): string {
   return t('routeError.defaultMessage')
 }
 
-export function RouteError({ error, reset }: ErrorComponentProps) {
+/**
+ * Self-mounts the byline-admin `<I18nProvider>` for the error/not-found
+ * screens (see the file header for why the layout-level provider is absent
+ * here).
+ *
+ * When a provider is already in scope (e.g. a not-found that renders inside
+ * the admin layout) it is reused as-is, preserving the user's active locale.
+ * Only when none is present (the error-boundary case) does it self-mount.
+ *
+ * Resilient by design (an error component that throws masks the real error):
+ * if the client config can't be read, it falls back to an English-default
+ * provider with an empty bundle. With a provider always present,
+ * `useTranslation` never throws; a missing key then renders as the raw key
+ * rather than crashing (see `I18nProvider`'s `onMissing`).
+ */
+function ErrorScreenI18nProvider({ children }: { children: ReactNode }) {
+  // Already inside a provider — reuse it (keeps the active locale) and skip the
+  // self-mount entirely.
+  if (useContext(I18nContext) != null) {
+    return <>{children}</>
+  }
+  let bundle: TranslationBundle = {}
+  let locale = 'en'
+  try {
+    const { i18n } = getClientConfig()
+    bundle = i18n.translations ?? {}
+    // No active provider, so render in the default locale — recovering the
+    // per-user active locale isn't worth another lookup that could itself throw.
+    locale = i18n.interface.defaultLocale
+  } catch {
+    // Config unavailable (very early boot / broken provider chain) — fall
+    // through with the English defaults above.
+  }
+  return (
+    <I18nProvider
+      bundle={bundle}
+      activeLocale={locale}
+      defaultLocale={locale}
+      localeDefinitions={[]}
+    >
+      {children}
+    </I18nProvider>
+  )
+}
+
+function RouteErrorContent({ error, reset }: ErrorComponentProps) {
   const router = useRouter()
   const { t } = useTranslation('byline-admin')
 
@@ -89,7 +144,15 @@ export function RouteError({ error, reset }: ErrorComponentProps) {
   )
 }
 
-export function RouteNotFound(_props: NotFoundRouteProps) {
+export function RouteError(props: ErrorComponentProps) {
+  return (
+    <ErrorScreenI18nProvider>
+      <RouteErrorContent {...props} />
+    </ErrorScreenI18nProvider>
+  )
+}
+
+function RouteNotFoundContent() {
   const { t } = useTranslation('byline-admin')
   return (
     <Section className={cx('byline-route-error', styles.section)}>
@@ -109,6 +172,14 @@ export function RouteNotFound(_props: NotFoundRouteProps) {
   )
 }
 
+export function RouteNotFound(_props: NotFoundRouteProps) {
+  return (
+    <ErrorScreenI18nProvider>
+      <RouteNotFoundContent />
+    </ErrorScreenI18nProvider>
+  )
+}
+
 /**
  * Minimal fallback for when providers may be broken — used at the root
  * route where the i18n provider itself may not be mounted. Stays in

package/src/admin-shell/collections/create.tsx

@@ -44,10 +44,12 @@ export const CreateView = ({
   const handleSubmit = async ({
     data,
     systemPath,
+    systemAvailableLocales,
   }: {
     // biome-ignore lint/suspicious/noExplicitAny: data is collection-specific
     data: any
     systemPath?: string | null
+    systemAvailableLocales?: string[]
   }) => {
     try {
       await createCollectionDocument({
@@ -55,6 +57,7 @@ export const CreateView = ({
           collection: path,
           data,
           ...(systemPath ? { path: systemPath } : {}),
+          ...(systemAvailableLocales ? { availableLocales: systemAvailableLocales } : {}),
         },
       })
       navigate({
@@ -97,6 +100,7 @@ export const CreateView = ({
           adminConfig={adminConfig}
           useAsTitle={collectionDefinition.useAsTitle}
           useAsPath={collectionDefinition.useAsPath}
+          advertiseLocales={collectionDefinition.advertiseLocales}
           headingLabel={labels.singular}
           useNavigationGuard={useTanStackNavigationGuard}
           onCancel={() =>

package/src/admin-shell/collections/edit.tsx

@@ -334,12 +334,14 @@ export const EditView = ({
     data: _data,
     patches,
     systemPath,
+    systemAvailableLocales,
   }: {
     // biome-ignore lint/suspicious/noExplicitAny: data is collection-specific
     data: any
     // biome-ignore lint/suspicious/noExplicitAny: patches list shape
     patches: any[]
     systemPath?: string | null
+    systemAvailableLocales?: string[]
   }) => {
     try {
       await updateCollectionDocumentWithPatches({
@@ -350,6 +352,7 @@ export const EditView = ({
           versionId: initialData.versionId as string | undefined,
           locale,
           ...(systemPath ? { path: systemPath } : {}),
+          ...(systemAvailableLocales ? { availableLocales: systemAvailableLocales } : {}),
         },
       })
 
@@ -404,6 +407,7 @@ export const EditView = ({
           adminConfig={adminConfig}
           useAsTitle={collectionDefinition.useAsTitle}
           useAsPath={collectionDefinition.useAsPath}
+          advertiseLocales={collectionDefinition.advertiseLocales}
           headingLabel={labels.singular}
           initialLocale={locale}
           onLocaleChange={handleLocaleChange}

package/src/server-fns/collections/create.ts

@@ -21,10 +21,22 @@ import { ensureCollection } from '../../integrations/api-utils.js'
 
 export const createCollectionDocument = createServerFn({ method: 'POST' })
   .inputValidator(
-    (input: { collection: string; data: any; locale?: string; path?: string }) => input
+    (input: {
+      collection: string
+      data: any
+      locale?: string
+      path?: string
+      availableLocales?: string[]
+    }) => input
   )
   .handler(async ({ data: input }) => {
-    const { collection: path, data: documentData, locale, path: explicitPath } = input
+    const {
+      collection: path,
+      data: documentData,
+      locale,
+      path: explicitPath,
+      availableLocales,
+    } = input
     const logger = getLogger()
     const config = await ensureCollection(path)
     if (!config) {
@@ -52,6 +64,7 @@ export const createCollectionDocument = createServerFn({ method: 'POST' })
       status: documentData.status,
       locale: locale ?? serverConfig.i18n.content.defaultLocale,
       path: explicitPath,
+      availableLocales,
     })
 
     return { status: 'ok' as const }

package/src/server-fns/collections/get.ts

@@ -88,6 +88,10 @@ const getDocumentFn = createServerFn({ method: 'GET' })
       populate,
       depth: resolvedDepth,
       status: 'any',
+      // Admin edit path: show the RAW per-locale values — untranslated localized
+      // fields stay empty (the signal to use "Copy to Locale"), never falling
+      // back to the default locale. Overrides the client's `'fallback'` default.
+      onMissingLocale: 'empty',
       // Admin edit path: tolerate schema-mismatch warnings rather than
       // hard-failing the load. Warnings (if any) come back on the document
       // as `_restoreWarnings` and the edit form surfaces them via an Alert.
@@ -148,12 +152,29 @@ const getDocumentFn = createServerFn({ method: 'GET' })
       | string[]
       | undefined
 
+    // Same preservation for the available-locales metadata — both are stripped
+    // by the Zod parse but the sidebar widget needs them at edit time:
+    //   `availableLocales`          — the stored editorial set → initialises the
+    //                                 form-context slot / the checked state.
+    //   `_availableVersionLocales`  — the ledger fact → drives each row's intent.
+    // See docs/I18N.md.
+    const availableLocales = (serialised as Record<string, any>).availableLocales as
+      | string[]
+      | undefined
+    const availableVersionLocales = (serialised as Record<string, any>)._availableVersionLocales as
+      | string[]
+      | undefined
+
     return {
       ...(parsed as Record<string, any>),
       _publishedVersion: publishedVersion,
       ...(restoreWarnings && restoreWarnings.length > 0
         ? { _restoreWarnings: restoreWarnings }
         : {}),
+      ...(Array.isArray(availableLocales) ? { availableLocales } : {}),
+      ...(Array.isArray(availableVersionLocales)
+        ? { _availableVersionLocales: availableVersionLocales }
+        : {}),
     }
   })
 

package/src/server-fns/collections/list.ts

@@ -82,6 +82,11 @@ export const getCollectionDocuments = createServerFn({ method: 'GET' })
       pageSize,
       select: params.fields,
       status: 'any',
+      // Admin list: show the raw per-locale state (untranslated docs render
+      // empty in the active locale's columns) rather than falling back to the
+      // default locale. Consistent with the edit view; overrides the client's
+      // `'fallback'` default.
+      onMissingLocale: 'empty',
     })
 
     // Decorate each doc with `hasPublishedVersion` so the list UI can show a

package/src/server-fns/collections/update.ts

@@ -29,10 +29,19 @@ export const updateCollectionDocumentWithPatches = createServerFn({ method: 'POS
       versionId?: string
       locale?: string
       path?: string
+      availableLocales?: string[]
     }) => input
   )
   .handler(async ({ data: input }) => {
-    const { collection: path, id, patches, versionId, locale, path: explicitPath } = input
+    const {
+      collection: path,
+      id,
+      patches,
+      versionId,
+      locale,
+      path: explicitPath,
+      availableLocales,
+    } = input
     const logger = getLogger()
     const config = await ensureCollection(path)
     if (!config) {
@@ -61,6 +70,7 @@ export const updateCollectionDocumentWithPatches = createServerFn({ method: 'POS
       documentVersionId: versionId,
       locale: locale ?? serverConfig.i18n.content.defaultLocale,
       path: explicitPath,
+      availableLocales,
     })
 
     return { status: 'ok' as const }