@byline/host-tanstack-start 2.5.1 → 2.6.0

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

@@ -1,19 +1,24 @@
 import { jsx } from "react/jsx-runtime";
 import { useState } from "react";
+import { FormRenderer } from "@byline/admin/react";
 import { getDefaultStatus, getWorkflowStatuses } from "@byline/core";
-import { Container, FormRenderer, Section, useToastManager } from "@byline/ui/react";
+import { useTranslation } from "@byline/i18n/react";
+import { Container, Section, useToastManager } from "@byline/ui/react";
 import { copyDocumentToLocale, deleteDocument, duplicateCollectionDocument, unpublishDocument, updateCollectionDocumentWithPatches, updateDocumentStatus } from "../../server-fns/collections/index.js";
 import { useNavigate } from "../chrome/loose-router.js";
 import { useTanStackNavigationGuard } from "./tanstack-navigation-guard.js";
 import { ViewMenu } from "./view-menu.js";
 const EditView = ({ collectionDefinition, adminConfig, initialData, locale, contentLocales, defaultContentLocale })=>{
     const toastManager = useToastManager();
+    const { t } = useTranslation('byline-admin');
     const [_editState, setEditState] = useState({
         status: 'idle',
         message: ''
     });
     const navigate = useNavigate();
     const { labels, path, fields } = collectionDefinition;
+    const singular = labels.singular;
+    const singularLower = singular.toLowerCase();
     const workflowStatuses = getWorkflowStatuses(collectionDefinition);
     const currentStatus = initialData?.status ?? getDefaultStatus(collectionDefinition);
     const currentIndex = workflowStatuses.findIndex((s)=>s.name === currentStatus);
@@ -39,9 +44,14 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
                     status
                 }
             });
+            const description = t("collections.edit.statusChangedDescription", {
+                status
+            });
             toastManager.add({
-                title: `${labels.singular} Status Update`,
-                description: `Status changed to "${status}"`,
+                title: t('collections.edit.statusUpdateTitle', {
+                    label: singular
+                }),
+                description,
                 data: {
                     intent: 'success',
                     iconType: 'success',
@@ -51,7 +61,7 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
             });
             setEditState({
                 status: 'success',
-                message: `Status changed to "${status}"`
+                message: description
             });
             navigate({
                 to: '/admin/collections/$collection/$id',
@@ -65,9 +75,14 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
             });
         } catch (err) {
             console.error('Status change error:', err);
+            const description = t("collections.edit.statusChangeFailedDescription", {
+                message: err.message
+            });
             toastManager.add({
-                title: `${labels.singular} Status Update`,
-                description: `Failed to change status: ${err.message}`,
+                title: t('collections.edit.statusUpdateTitle', {
+                    label: singular
+                }),
+                description,
                 data: {
                     intent: 'danger',
                     iconType: 'danger',
@@ -77,7 +92,7 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
             });
             setEditState({
                 status: 'failed',
-                message: `Failed to change status: ${err.message}`
+                message: description
             });
         }
     };
@@ -91,9 +106,12 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
                     id: String(initialData.id)
                 }
             });
+            const description = t("collections.edit.unpublishedDescription");
             toastManager.add({
-                title: `${labels.singular} Unpublish`,
-                description: 'Published version has been taken offline.',
+                title: t('collections.edit.unpublishTitle', {
+                    label: singular
+                }),
+                description,
                 data: {
                     intent: 'success',
                     iconType: 'success',
@@ -103,7 +121,7 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
             });
             setEditState({
                 status: 'success',
-                message: 'Published version has been taken offline.'
+                message: description
             });
             navigate({
                 to: '/admin/collections/$collection/$id',
@@ -117,9 +135,14 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
             });
         } catch (err) {
             console.error('Unpublish error:', err);
+            const description = t("collections.edit.unpublishFailedDescription", {
+                message: err.message
+            });
             toastManager.add({
-                title: `${labels.singular} Unpublish`,
-                description: `Failed to unpublish: ${err.message}`,
+                title: t('collections.edit.unpublishTitle', {
+                    label: singular
+                }),
+                description,
                 data: {
                     intent: 'danger',
                     iconType: 'danger',
@@ -129,7 +152,7 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
             });
             setEditState({
                 status: 'failed',
-                message: `Failed to unpublish: ${err.message}`
+                message: description
             });
         }
     };
@@ -141,9 +164,16 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
                     id: String(initialData.id)
                 }
             });
+            const description = result.pathRetried ? t("collections.edit.duplicatedAutoPathDescription", {
+                path: result.newPath
+            }) : t("collections.edit.duplicatedPathDescription", {
+                path: result.newPath
+            });
             toastManager.add({
-                title: `${labels.singular} Duplicated`,
-                description: result.pathRetried ? `Created with auto-generated path "${result.newPath}" (the preferred slug was already in use).` : `Created with path "${result.newPath}". Update the title and path in the new document.`,
+                title: t('collections.edit.duplicatedTitle', {
+                    label: singular
+                }),
+                description,
                 data: {
                     intent: 'success',
                     iconType: 'success',
@@ -153,7 +183,9 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
             });
             setEditState({
                 status: 'success',
-                message: `${labels.singular} duplicated.`
+                message: t('collections.edit.duplicatedSuccessMessage', {
+                    label: singular
+                })
             });
             navigate({
                 to: '/admin/collections/$collection/$id',
@@ -164,9 +196,14 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
             });
         } catch (err) {
             console.error('Duplicate error:', err);
+            const description = t("collections.edit.duplicateFailedDescription", {
+                message: err.message
+            });
             toastManager.add({
-                title: `${labels.singular} Duplicate`,
-                description: `Failed to duplicate: ${err.message}`,
+                title: t('collections.edit.duplicateTitle', {
+                    label: singular
+                }),
+                description,
                 data: {
                     intent: 'danger',
                     iconType: 'danger',
@@ -176,7 +213,7 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
             });
             setEditState({
                 status: 'failed',
-                message: `Failed to duplicate: ${err.message}`
+                message: description
             });
         }
     };
@@ -193,9 +230,19 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
             });
             const sourceLabel = contentLocales.find((l)=>l.code === result.sourceLocale)?.label ?? result.sourceLocale;
             const targetLabel = contentLocales.find((l)=>l.code === result.targetLocale)?.label ?? result.targetLocale;
+            const description = result.fieldsUpdated > 0 ? t("collections.edit.copiedFieldsDescription", {
+                count: result.fieldsUpdated,
+                source: sourceLabel,
+                target: targetLabel
+            }) : t("collections.edit.copiedNoFieldsDescription", {
+                source: sourceLabel,
+                target: targetLabel
+            });
             toastManager.add({
-                title: `${labels.singular} Copy to Locale`,
-                description: result.fieldsUpdated > 0 ? `Copied ${result.fieldsUpdated} field${1 === result.fieldsUpdated ? '' : 's'} from ${sourceLabel} to ${targetLabel}.` : `No fields needed copying from ${sourceLabel} to ${targetLabel} under the current rule.`,
+                title: t('collections.edit.copyToLocaleTitle', {
+                    label: singular
+                }),
+                description,
                 data: {
                     intent: 'success',
                     iconType: 'success',
@@ -205,7 +252,10 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
             });
             setEditState({
                 status: 'success',
-                message: `Copied ${sourceLabel} → ${targetLabel}.`
+                message: t('collections.edit.copiedSuccessMessage', {
+                    source: sourceLabel,
+                    target: targetLabel
+                })
             });
             navigate({
                 to: '/admin/collections/$collection/$id',
@@ -219,9 +269,14 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
             });
         } catch (err) {
             console.error('Copy to locale error:', err);
+            const description = t("collections.edit.copyFailedDescription", {
+                message: err.message
+            });
             toastManager.add({
-                title: `${labels.singular} Copy to Locale`,
-                description: `Failed to copy: ${err.message}`,
+                title: t('collections.edit.copyToLocaleTitle', {
+                    label: singular
+                }),
+                description,
                 data: {
                     intent: 'danger',
                     iconType: 'danger',
@@ -231,7 +286,7 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
             });
             setEditState({
                 status: 'failed',
-                message: `Failed to copy: ${err.message}`
+                message: description
             });
         }
     };
@@ -243,9 +298,14 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
                     id: String(initialData.id)
                 }
             });
+            const description = t("collections.edit.deletedDescription", {
+                label: singular
+            });
             toastManager.add({
-                title: `${labels.singular} Deletion`,
-                description: `${labels.singular} has been deleted.`,
+                title: t('collections.edit.deleteTitle', {
+                    label: singular
+                }),
+                description,
                 data: {
                     intent: 'success',
                     iconType: 'success',
@@ -255,7 +315,7 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
             });
             setEditState({
                 status: 'success',
-                message: `${labels.singular} has been deleted.`
+                message: description
             });
             navigate({
                 to: '/admin/collections/$collection',
@@ -265,9 +325,14 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
             });
         } catch (err) {
             console.error('Delete error:', err);
+            const description = t("collections.edit.deleteFailedDescription", {
+                message: err.message
+            });
             toastManager.add({
-                title: `${labels.singular} Deletion`,
-                description: `Failed to delete: ${err.message}`,
+                title: t('collections.edit.deleteTitle', {
+                    label: singular
+                }),
+                description,
                 data: {
                     intent: 'danger',
                     iconType: 'danger',
@@ -277,7 +342,7 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
             });
             setEditState({
                 status: 'failed',
-                message: `Failed to delete: ${err.message}`
+                message: description
             });
         }
     };
@@ -295,9 +360,14 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
                     } : {}
                 }
             });
+            const description = t("collections.edit.updatedDescription", {
+                label: singularLower
+            });
             toastManager.add({
-                title: `${labels.singular} Update`,
-                description: `Successfully updated ${labels.singular.toLowerCase()}`,
+                title: t('collections.edit.updateTitle', {
+                    label: singular
+                }),
+                description,
                 data: {
                     intent: 'success',
                     iconType: 'success',
@@ -307,7 +377,7 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
             });
             setEditState({
                 status: 'success',
-                message: `Successfully updated ${labels.singular.toLowerCase()}`
+                message: description
             });
             navigate({
                 to: '/admin/collections/$collection/$id',
@@ -321,9 +391,14 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
             });
         } catch (err) {
             console.error('Network error:', err);
+            const description = t("collections.edit.updateFailedDescription", {
+                label: singularLower
+            });
             toastManager.add({
-                title: `${labels.singular} Update`,
-                description: `An error occurred while updating ${labels.singular.toLowerCase()}`,
+                title: t('collections.edit.updateTitle', {
+                    label: singular
+                }),
+                description,
                 data: {
                     intent: 'danger',
                     iconType: 'danger',
@@ -333,7 +408,7 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
             });
             setEditState({
                 status: 'failed',
-                message: `An error occurred while updating ${labels.singular.toLowerCase()}`
+                message: description
             });
         }
     };

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

@@ -1,8 +1,10 @@
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { Suspense, lazy, useState } from "react";
 import { useParams, useRouterState } from "@tanstack/react-router";
+import { StatusBadge, renderFormatted } from "@byline/admin/react";
 import { useBylineAdminServices } from "@byline/admin/services";
-import { Button, CloseIcon, Container, IconButton, Modal, Section, Select, StatusBadge, Table, renderFormatted } from "@byline/ui/react";
+import { useTranslation } from "@byline/i18n/react";
+import { Button, CloseIcon, Container, IconButton, Modal, Section, Select, Table } from "@byline/ui/react";
 import classnames from "classnames";
 import { Link, useNavigate } from "../chrome/loose-router.js";
 import { RouterPager } from "../chrome/router-pager.js";
@@ -15,7 +17,7 @@ function getColumnValue(document, fieldName) {
     if (document.fields && fieldName in document.fields) return document.fields[fieldName];
     return document[fieldName];
 }
-const DiffModal = /*#__PURE__*/ lazy(()=>import("@byline/ui/react").then((m)=>({
+const DiffModal = /*#__PURE__*/ lazy(()=>import("@byline/admin/react").then((m)=>({
             default: m.DiffModal
         })));
 function resolveDisplayValue(value, locale, defaultContentLocale) {
@@ -47,6 +49,7 @@ const HistoryView = ({ collectionDefinition, adminConfig, data, workflowStatuses
     });
     const navigate = useNavigate();
     const { getCollectionDocumentVersion } = useBylineAdminServices();
+    const { t } = useTranslation('byline-admin');
     const columns = adminConfig?.columns || [];
     const { labels } = collectionDefinition;
     const location = useRouterState({
@@ -79,8 +82,10 @@ const HistoryView = ({ collectionDefinition, adminConfig, data, workflowStatuses
                             /*#__PURE__*/ jsxs("h2", {
                                 className: classnames('byline-coll-history-title', history_module.title),
                                 children: [
-                                    labels.singular,
-                                    " History ",
+                                    t('collections.history.title', {
+                                        label: labels.singular
+                                    }),
+                                    ' ',
                                     /*#__PURE__*/ jsx(Stats, {
                                         total: data?.meta.total
                                     })
@@ -109,7 +114,7 @@ const HistoryView = ({ collectionDefinition, adminConfig, data, workflowStatuses
                                 showFirstButton: true,
                                 showLastButton: true,
                                 componentName: "pagerTop",
-                                "aria-label": "Top Pager"
+                                "aria-label": t('collections.list.pagerTopAriaLabel')
                             })
                         }),
                         /*#__PURE__*/ jsxs(Table.Container, {
@@ -160,8 +165,8 @@ const HistoryView = ({ collectionDefinition, adminConfig, data, workflowStatuses
                                                                 size: "xs",
                                                                 variant: "outlined",
                                                                 intent: "noeffect",
-                                                                "aria-label": "Compare this version with the current version",
-                                                                title: "Compare with current",
+                                                                "aria-label": t('collections.history.compareAriaLabel'),
+                                                                title: t('collections.history.compareTitle'),
                                                                 className: classnames('byline-coll-history-version-button', history_module.versionButton),
                                                                 onClick: ()=>setSelectedVersion({
                                                                         versionId,
@@ -213,8 +218,8 @@ const HistoryView = ({ collectionDefinition, adminConfig, data, workflowStatuses
                                                                                 versionNumber
                                                                             }),
                                                                         className: classnames('byline-coll-history-restore-button', history_module.restoreButton),
-                                                                        title: "Restore this version as the current draft",
-                                                                        children: "Restore"
+                                                                        title: t('collections.history.restoreButtonTitle'),
+                                                                        children: t('collections.history.restoreButton')
                                                                     }) : null
                                                                 }, "__restore")
                                                             ];
@@ -267,7 +272,7 @@ const HistoryView = ({ collectionDefinition, adminConfig, data, workflowStatuses
                                     showFirstButton: true,
                                     showLastButton: true,
                                     componentName: "pagerBottom",
-                                    "aria-label": "Bottom Pager"
+                                    "aria-label": t('collections.list.pagerBottomAriaLabel')
                                 })
                             ]
                         })
@@ -300,10 +305,10 @@ const HistoryView = ({ collectionDefinition, adminConfig, data, workflowStatuses
                             children: [
                                 /*#__PURE__*/ jsx("h3", {
                                     className: "m-0",
-                                    children: "Restore version"
+                                    children: t('collections.history.restoreModalTitle')
                                 }),
                                 /*#__PURE__*/ jsx(IconButton, {
-                                    "aria-label": "Close",
+                                    "aria-label": t('common.actions.close'),
                                     size: "xs",
                                     onClick: ()=>setRestoreTarget(null),
                                     children: /*#__PURE__*/ jsx(CloseIcon, {

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

@@ -1,7 +1,9 @@
 import { jsx, jsxs } from "react/jsx-runtime";
 import { useEffect, useMemo, useState } from "react";
 import { useRouter, useRouterState } from "@tanstack/react-router";
-import { Container, GripperVerticalIcon, IconButton, LoaderRing, PlusIcon, Search, Section, Select, StatusBadge, Table, renderFormatted, useToastManager } from "@byline/ui/react";
+import { StatusBadge, renderFormatted } from "@byline/admin/react";
+import { useTranslation } from "@byline/i18n/react";
+import { Container, GripperVerticalIcon, IconButton, LoaderRing, PlusIcon, Search, Section, Select, Table, useToastManager } from "@byline/ui/react";
 import { DndContext, KeyboardSensor, PointerSensor, useSensor, useSensors } from "@dnd-kit/core";
 import { SortableContext, sortableKeyboardCoordinates, useSortable, verticalListSortingStrategy } from "@dnd-kit/sortable";
 import classnames from "classnames";
@@ -35,7 +37,7 @@ function padRows(value) {
             children: "\xa0"
         }, `empty-row-${index}`));
 }
-function SortableTableRow({ id, disabled, children }) {
+function SortableTableRow({ id, disabled, t, children }) {
     const { setNodeRef, attributes, listeners, transform, transition, isDragging } = useSortable({
         id,
         disabled
@@ -57,7 +59,7 @@ function SortableTableRow({ id, disabled, children }) {
                 children: /*#__PURE__*/ jsx("button", {
                     type: "button",
                     className: classnames('byline-coll-list-drag-handle', list_module.dragHandle),
-                    "aria-label": disabled ? 'Drag disabled while filters or search are active' : 'Drag to reorder',
+                    "aria-label": disabled ? t('collections.list.dragDisabledAriaLabel') : t('collections.list.dragHandleAriaLabel'),
                     disabled: disabled,
                     ...attributes,
                     ...listeners,
@@ -72,6 +74,7 @@ const ListView = ({ data, columns, workflowStatuses, useAsTitle, orderable = fal
     const navigate = useNavigate();
     const router = useRouter();
     const toastManager = useToastManager();
+    const { t } = useTranslation('byline-admin');
     const location = useRouterState({
         select: (s)=>s.location
     });
@@ -120,8 +123,8 @@ const ListView = ({ data, columns, workflowStatuses, useAsTitle, orderable = fal
         } catch (_err) {
             setLocalDocs(previousDocs);
             toastManager.add({
-                title: 'Could not save the new order',
-                description: 'Please try again.',
+                title: t('collections.list.reorderFailedToast'),
+                description: t("collections.list.reorderFailedDescription"),
                 data: {
                     intent: 'danger',
                     iconType: 'danger',
@@ -136,14 +139,15 @@ const ListView = ({ data, columns, workflowStatuses, useAsTitle, orderable = fal
     const statusItems = useMemo(()=>[
             {
                 value: '_all',
-                label: 'All'
+                label: t('collections.list.statusFilterAll')
             },
             ...workflowStatuses?.map((ws)=>({
                     value: ws.name,
                     label: ws.label ?? ws.name
                 })) ?? []
         ], [
-        workflowStatuses
+        workflowStatuses,
+        t
     ]);
     const handleOnSearch = (query)=>{
         if (null != query && query.length > 0) {
@@ -212,7 +216,7 @@ const ListView = ({ data, columns, workflowStatuses, useAsTitle, orderable = fal
                             total: data?.meta.total
                         }),
                         /*#__PURE__*/ jsx(IconButton, {
-                            "aria-label": "Create New",
+                            "aria-label": t('collections.list.createAriaLabel'),
                             render: /*#__PURE__*/ jsx(Link, {
                                 to: '/admin/collections/$collection/create',
                                 params: {
@@ -234,7 +238,7 @@ const ListView = ({ data, columns, workflowStatuses, useAsTitle, orderable = fal
                             onSearch: handleOnSearch,
                             onClear: handleOnClear,
                             inputSize: "sm",
-                            placeholder: "Search",
+                            placeholder: t('collections.list.searchPlaceholder'),
                             className: classnames('byline-coll-list-search', list_module.search)
                         }),
                         workflowStatuses && workflowStatuses.length > 1 && /*#__PURE__*/ jsx(Select, {
@@ -251,7 +255,7 @@ const ListView = ({ data, columns, workflowStatuses, useAsTitle, orderable = fal
                             showFirstButton: true,
                             showLastButton: true,
                             componentName: "pagerTop",
-                            "aria-label": "Top Pager"
+                            "aria-label": t('collections.list.pagerTopAriaLabel')
                         })
                     ]
                 }),
@@ -288,8 +292,8 @@ const ListView = ({ data, columns, workflowStatuses, useAsTitle, orderable = fal
                                                                     search: params
                                                                 });
                                                             },
-                                                            "aria-label": "Sort by manual order",
-                                                            title: "Sort by manual order",
+                                                            "aria-label": t('collections.list.sortManualOrderAriaLabel'),
+                                                            title: t('collections.list.sortManualOrderAriaLabel'),
                                                             children: /*#__PURE__*/ jsx(SortAscendingIcon, {})
                                                         })
                                                     }),
@@ -308,6 +312,7 @@ const ListView = ({ data, columns, workflowStatuses, useAsTitle, orderable = fal
                                             children: localDocs.map((document)=>/*#__PURE__*/ jsx(SortableTableRow, {
                                                     id: document.id,
                                                     disabled: !dragEnabled,
+                                                    t: t,
                                                     children: columns.map((column)=>/*#__PURE__*/ jsx(Table.Cell, {
                                                             className: classnames({
                                                                 'byline-coll-list-cell-right': 'right' === column.align,
@@ -412,7 +417,7 @@ const ListView = ({ data, columns, workflowStatuses, useAsTitle, orderable = fal
                             showFirstButton: true,
                             showLastButton: true,
                             componentName: "pagerBottom",
-                            "aria-label": "Bottom Pager"
+                            "aria-label": t('collections.list.pagerBottomAriaLabel')
                         })
                     ]
                 })

package/dist/admin-shell/collections/preview-link.d.ts

@@ -6,6 +6,7 @@
  * Copyright (c) Infonomic Company Limited
  */
 import type { CollectionAdminConfig, PreviewDocument } from '@byline/core';
+export { resolvePreviewUrl } from './resolve-preview-url.js';
 export interface PreviewLinkProps {
     /** Collection path (e.g. `'news'`, `'pages'`). */
     collectionPath: string;
@@ -18,14 +19,4 @@ export interface PreviewLinkProps {
     /** Optional className for the IconButton. */
     className?: string;
 }
-/**
- * Resolve the preview URL for a doc against an admin config. Exported so
- * other surfaces (list-row preview links in the future) can share the
- * same fallback logic.
- *
- * Returns:
- *   - `string`  → URL to open
- *   - `null`    → no preview URL meaningful for this doc; hide affordance
- */
-export declare function resolvePreviewUrl(doc: PreviewDocument, collectionPath: string, adminConfig: CollectionAdminConfig | undefined, locale: string | undefined): string | null;
 export declare const PreviewLink: ({ collectionPath, doc, adminConfig, locale, className, }: PreviewLinkProps) => import("react").JSX.Element | null;

package/dist/admin-shell/collections/preview-link.js

@@ -1,17 +1,13 @@
 import { jsx } from "react/jsx-runtime";
 import { useState } from "react";
+import { useTranslation } from "@byline/i18n/react";
 import { ExternalLinkIcon, IconButton, useToastManager } from "@byline/ui/react";
 import classnames from "classnames";
 import { enablePreviewModeFn } from "../../server-fns/preview/index.js";
-function resolvePreviewUrl(doc, collectionPath, adminConfig, locale) {
-    if (adminConfig?.preview) return adminConfig.preview.url(doc, {
-        locale
-    });
-    if (!doc.path) return null;
-    return `/${collectionPath}/${doc.path}`;
-}
+import { resolvePreviewUrl } from "./resolve-preview-url.js";
 const PreviewLink = ({ collectionPath, doc, adminConfig, locale, className })=>{
     const toastManager = useToastManager();
+    const { t } = useTranslation('byline-admin');
     const [busy, setBusy] = useState(false);
     const url = resolvePreviewUrl(doc, collectionPath, adminConfig, locale);
     if (null == url) return null;
@@ -23,8 +19,10 @@ const PreviewLink = ({ collectionPath, doc, adminConfig, locale, className })=>{
             window.location.assign(url);
         } catch (err) {
             toastManager.add({
-                title: 'Preview',
-                description: `Could not enable preview mode: ${err.message}`,
+                title: t('collections.preview.toastTitle'),
+                description: t("collections.preview.failedDescription", {
+                    message: err.message
+                }),
                 data: {
                     intent: 'danger',
                     iconType: 'danger',
@@ -42,8 +40,8 @@ const PreviewLink = ({ collectionPath, doc, adminConfig, locale, className })=>{
         variant: "text",
         disabled: busy,
         onClick: handleClick,
-        "aria-label": "Open preview",
-        title: "Preview",
+        "aria-label": t('collections.preview.openAriaLabel'),
+        title: t('collections.preview.title'),
         children: /*#__PURE__*/ jsx(ExternalLinkIcon, {
             width: "20px",
             height: "20px",

package/dist/admin-shell/collections/resolve-preview-url.d.ts

@@ -0,0 +1,34 @@
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ */
+/**
+ * Pure (no React, no DOM) resolver for the admin Preview button's URL.
+ * Lives in its own module so it can be unit-tested without dragging the
+ * React UI graph of `preview-link.tsx` into a node-mode test run.
+ */
+import { type CollectionAdminConfig, type PreviewDocument } from '@byline/core';
+/**
+ * Resolve the preview URL for a doc against an admin config. Exported so
+ * other surfaces (list-row preview links in the future) can share the
+ * same fallback logic.
+ *
+ * Cascade:
+ *   1. `adminConfig.preview.url(doc, { locale })` — wins outright when
+ *      configured. The host can do anything (locale prefix, query
+ *      string, conditional return-null).
+ *   2. `CollectionDefinition.buildDocumentPath(doc, { collectionPath })`
+ *      — the schema-side hook the richtext embed walker also reads.
+ *      Locale-agnostic by contract; hosts that need a locale prefix
+ *      keep their own `preview.url`.
+ *   3. Generic compose `/${collectionPath}/${doc.path}` — last-resort
+ *      convention for collections with no schema-side hook.
+ *
+ * Returns:
+ *   - `string`  → URL to open
+ *   - `null`    → no preview URL meaningful for this doc; hide affordance
+ */
+export declare function resolvePreviewUrl(doc: PreviewDocument, collectionPath: string, adminConfig: CollectionAdminConfig | undefined, locale: string | undefined): string | null;