@byline/host-tanstack-start 6.2.1 → 6.4.0

package/dist/admin-shell/chrome/breadcrumbs/breadcrumbs-provider.js

@@ -1,16 +1,27 @@
 import { jsx } from "react/jsx-runtime";
-import { createContext, useContext, useState } from "react";
+import { createContext, useCallback, useContext, useState } from "react";
 const BreadcrumbsContext = /*#__PURE__*/ createContext(void 0);
+function sameBreadcrumbs(a, b) {
+    if (a === b) return true;
+    if (a.length !== b.length) return false;
+    return a.every((crumb, index)=>crumb.label === b[index].label && crumb.href === b[index].href && crumb.active === b[index].active);
+}
+function sameSettings(a, b) {
+    return a.homeLabel === b.homeLabel && a.homePath === b.homePath && sameBreadcrumbs(a.breadcrumbs, b.breadcrumbs);
+}
 function BreadcrumbsProvider({ children }) {
     const [breadcrumbSettings, setBreadcrumbSettings] = useState({
         homeLabel: 'Home',
         homePath: '/',
         breadcrumbs: []
     });
+    const setBreadcrumbs = useCallback((settings)=>{
+        setBreadcrumbSettings((previous)=>sameSettings(previous, settings) ? previous : settings);
+    }, []);
     return /*#__PURE__*/ jsx(BreadcrumbsContext, {
         value: {
             breadCrumbSettings: breadcrumbSettings,
-            setBreadcrumbs: setBreadcrumbSettings
+            setBreadcrumbs
         },
         children: children
     });

package/dist/admin-shell/chrome/breadcrumbs/breadcrumbs.js

@@ -18,11 +18,6 @@ function Breadcrumbs({ breadcrumbs, className, homeLabel = 'Home', homePath = '/
     const navRef = useRef(null);
     const measureRef = useRef(null);
     const [visibleIndices, setVisibleIndices] = useState(()=>breadcrumbs.map((_, i)=>i));
-    useIsoLayoutEffect(()=>{
-        setVisibleIndices(breadcrumbs.map((_, i)=>i));
-    }, [
-        breadcrumbs
-    ]);
     useIsoLayoutEffect(()=>{
         const nav = navRef.current;
         const measure = measureRef.current;
@@ -71,7 +66,8 @@ function Breadcrumbs({ breadcrumbs, className, homeLabel = 'Home', homePath = '/
         ro.observe(nav);
         return ()=>ro.disconnect();
     }, [
-        breadcrumbs
+        breadcrumbs,
+        homeLabel
     ]);
     const overflowed = useMemo(()=>{
         const visible = new Set(visibleIndices);

package/dist/admin-shell/chrome/breadcrumbs/breadcrumbs.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 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
+ */
+export {};

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

@@ -2,10 +2,11 @@ import { jsx, jsxs } from "react/jsx-runtime";
 import { useTranslation } from "@byline/i18n/react";
 import { Container, Section } from "@byline/ui/react";
 import clsx from "clsx";
-import { JsonView, allExpanded, darkStyles } from "react-json-view-lite";
+import { JsonView, darkStyles } from "react-json-view-lite";
 import api_module from "./api.module.js";
 import { ViewMenu } from "./view-menu.js";
 import "react-json-view-lite/dist/index.css";
+const expandToFirstLevel = (level)=>level < 2;
 const ApiView = ({ collectionDefinition, initialData, locale, depth, contentLocales, defaultContentLocale })=>{
     const { labels, path } = collectionDefinition;
     const { t } = useTranslation('byline-admin');
@@ -38,7 +39,7 @@ const ApiView = ({ collectionDefinition, initialData, locale, depth, contentLoca
                     className: clsx('byline-api-viewer', api_module.viewer),
                     children: /*#__PURE__*/ jsx(JsonView, {
                         data: initialData,
-                        shouldExpandNode: allExpanded,
+                        shouldExpandNode: expandToFirstLevel,
                         style: {
                             ...darkStyles,
                             container: 'api-json-view'

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

@@ -8,6 +8,7 @@ import { getAdminRoutePath } from "../../routes/admin-path.js";
 import { clearListReturnState } from "../../routes/list-return-storage.js";
 import { cancelCollectionDocumentScheduledPublish, confirmCollectionDocumentScheduledPublish, copyDocumentToLocale, deleteDocument, deleteDocumentLocale, duplicateCollectionDocument, hasCommittedDocumentHookFailure, hasDeleteSideEffectFailures, scheduleCollectionDocumentPublish, unpublishDocument, updateCollectionDocumentWithPatches, updateDocumentStatus } from "../../server-fns/collections/index.js";
 import { useNavigate } from "../chrome/loose-router.js";
+import { describeMutationFailure } from "../describe-mutation-failure.js";
 import { useDocumentMutationState } from "../document-mutation-state.js";
 import { useTanStackNavigationGuard } from "./tanstack-navigation-guard.js";
 import { ViewMenu } from "./view-menu.js";
@@ -432,7 +433,7 @@ const EditView = ({ collectionDefinition, adminConfig, initialData: loadedData,
             }
             console.error('Duplicate error:', err);
             const description = t("collections.edit.duplicateFailedDescription", {
-                message: t('documentConcurrency.failed')
+                message: describeMutationFailure(err, t)
             });
             toastManager.add({
                 title: t('collections.edit.duplicateTitle', {
@@ -533,7 +534,7 @@ const EditView = ({ collectionDefinition, adminConfig, initialData: loadedData,
             }
             console.error('Copy to locale error:', err);
             const description = t("collections.edit.copyFailedDescription", {
-                message: t('documentConcurrency.failed')
+                message: describeMutationFailure(err, t)
             });
             toastManager.add({
                 title: t('collections.edit.copyToLocaleTitle', {

package/dist/admin-shell/collections/restore-version-modal.js

@@ -17,6 +17,19 @@ function RestoreVersionModal({ disabled = false, onMutationError, versionLabel,
         setError(null);
         try {
             const result = await restoreVersion();
+            const issues = getRestoreValidationIssues(result);
+            if (issues.length > 0) toastManager.add({
+                title: t('collections.restore.validationIssuesToast'),
+                description: t("collections.restore.validationIssuesDescription", {
+                    fields: issues.join(', ')
+                }),
+                data: {
+                    intent: 'warning',
+                    iconType: 'warning',
+                    icon: true,
+                    close: true
+                }
+            });
             if (hasCommittedDocumentHookFailure(result)) toastManager.add({
                 title: t('collections.save.hookFailedToast'),
                 description: t("collections.save.hookFailedDescription"),
@@ -126,6 +139,12 @@ function RestoreVersionModal({ disabled = false, onMutationError, versionLabel,
         ]
     });
 }
+function getRestoreValidationIssues(result) {
+    if (null == result || 'object' != typeof result) return [];
+    const issues = result.validationIssues;
+    if (!Array.isArray(issues)) return [];
+    return issues.map((issue)=>null != issue && 'object' == typeof issue && 'string' == typeof issue.field ? issue.field : '').filter((field)=>field.length > 0);
+}
 function getErrorCode(err) {
     return 'string' == typeof err?.code ? err.code : null;
 }

package/dist/admin-shell/describe-mutation-failure.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 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
+ */
+import type { TranslationValues } from '@byline/i18n';
+/**
+ * Describe a failed document mutation for the editor.
+ *
+ * Content writes that are not restores — create, update, patch saves,
+ * duplication and locale copies — keep the field-validation gate, because each
+ * reads or authors content the editor can open and correct. Naming the
+ * offending fields is what makes that correction actionable; without it the
+ * editor sees only a generic failure.
+ */
+export declare function describeMutationFailure(err: unknown, t: (key: string, values?: TranslationValues) => string): string;

package/dist/admin-shell/describe-mutation-failure.js

@@ -0,0 +1,9 @@
+import { getDocumentFieldValidationDetails } from "@byline/core";
+function describeMutationFailure(err, t) {
+    const validation = getDocumentFieldValidationDetails(err);
+    if (null == validation) return t('documentConcurrency.failed');
+    return t('collections.edit.invalidFieldsMessage', {
+        fields: validation.issues.map((issue)=>issue.field || '?').join(', ')
+    });
+}
+export { describeMutationFailure };

package/dist/admin-shell/singletons/view.js

@@ -10,6 +10,7 @@ import { hasCommittedDocumentHookFailure } from "../../server-fns/collections/in
 import { cancelSingletonScheduledPublish, changeSingletonStatus, confirmSingletonScheduledPublish, copySingletonToLocale, scheduleSingletonPublish, unpublishSingleton, updateSingleton } from "../../server-fns/singletons/index.js";
 import { useNavigate } from "../chrome/loose-router.js";
 import { useTanStackNavigationGuard } from "../collections/tanstack-navigation-guard.js";
+import { describeMutationFailure } from "../describe-mutation-failure.js";
 import { useDocumentMutationState } from "../document-mutation-state.js";
 import { SingletonViewMenu } from "./view-menu.js";
 function SingletonView({ singletonDefinition, adminConfig, document: loadedDocument, initialData, locale, contentLocales, defaultContentLocale }) {
@@ -201,7 +202,7 @@ function SingletonView({ singletonDefinition, adminConfig, document: loadedDocum
             toast(t('collections.edit.copyToLocaleTitle', {
                 label
             }), t("collections.edit.copyFailedDescription", {
-                message: t('documentConcurrency.failed')
+                message: describeMutationFailure(err, t)
             }), 'danger');
             throw err;
         }

package/dist/integrations/byline-field-services.d.ts

@@ -16,3 +16,22 @@
  */
 import type { BylineFieldServices } from '@byline/admin/react';
 export declare const bylineFieldServices: BylineFieldServices;
+/** The subset of the admin session the field services need. */
+export interface FieldServicesViewer {
+    is_super_admin: boolean;
+    abilities: ReadonlyArray<string>;
+}
+/**
+ * Content-addressed memo key for the services object.
+ *
+ * Avoids notifying field-service context consumers when the host supplies an
+ * equivalent viewer object or abilities array. Existing service functions retain
+ * their module-level identity even when the containing object is rebuilt.
+ * Ability order is not meaningful, so sort a copy before building the key.
+ */
+export declare function abilityFingerprint(viewer: FieldServicesViewer): string;
+/**
+ * Field services for one viewer. Call inside `useMemo`, keyed on
+ * `abilityFingerprint(viewer)`.
+ */
+export declare function buildBylineFieldServices(viewer: FieldServicesViewer): BylineFieldServices;

package/dist/integrations/byline-field-services.js

@@ -1,3 +1,4 @@
+import { getAdminRoutePath } from "../routes/admin-path.js";
 import { getCollectionDocuments } from "../server-fns/collections/list.js";
 import { getTreeAncestors, getTreeParent, placeTreeNode, removeFromTree } from "../server-fns/collections/tree.js";
 import { uploadField } from "../server-fns/collections/upload.js";
@@ -20,12 +21,27 @@ const byline_field_services_getTreeAncestors = (input)=>getTreeAncestors({
 const byline_field_services_getTreeParent = (input)=>getTreeParent({
         data: input
     });
+const getCreateDocumentUrl = (collectionPath)=>getAdminRoutePath('collections', collectionPath, 'create');
 const bylineFieldServices = {
     getCollectionDocuments: byline_field_services_getCollectionDocuments,
     uploadField: byline_field_services_uploadField,
     placeTreeNode: byline_field_services_placeTreeNode,
     removeFromTree: byline_field_services_removeFromTree,
     getTreeAncestors: byline_field_services_getTreeAncestors,
-    getTreeParent: byline_field_services_getTreeParent
+    getTreeParent: byline_field_services_getTreeParent,
+    getCreateDocumentUrl: getCreateDocumentUrl
 };
-export { bylineFieldServices };
+function abilityFingerprint(viewer) {
+    if (viewer.is_super_admin) return 'super-admin';
+    return [
+        ...viewer.abilities
+    ].sort().join(' ');
+}
+function buildBylineFieldServices(viewer) {
+    const canCreateInCollection = (collectionPath)=>viewer.is_super_admin || viewer.abilities.includes(`collections.${collectionPath}.create`);
+    return {
+        ...bylineFieldServices,
+        canCreateInCollection
+    };
+}
+export { abilityFingerprint, buildBylineFieldServices, bylineFieldServices };

package/dist/routes/create-admin-layout-route.js

@@ -1,5 +1,5 @@
 import { jsx, jsxs } from "react/jsx-runtime";
-import { useEffect } from "react";
+import { useEffect, useMemo } from "react";
 import { Outlet, createFileRoute } from "@tanstack/react-router";
 import { applyStoredTheme } from "@byline/admin/admin-account/components/theme";
 import { BylineFieldServicesProvider } from "@byline/admin/react";
@@ -18,7 +18,7 @@ import { SessionChangeBoundary } from "../admin-shell/chrome/session-change-boun
 import { buildLocaleDefinitions } from "../i18n/locale-definitions.js";
 import { bylineAdminServices } from "../integrations/byline-admin-services.js";
 import { BylineAiAdminProvider } from "../integrations/byline-ai.js";
-import { bylineFieldServices } from "../integrations/byline-field-services.js";
+import { abilityFingerprint, buildBylineFieldServices } from "../integrations/byline-field-services.js";
 import { observeSession, sessionIsChanged } from "../integrations/session-coordination.js";
 import { renewExpectedSession } from "../integrations/session-renewal.js";
 import { getAnalyticsRuntime } from "../server-fns/analytics/index.js";
@@ -58,6 +58,9 @@ function createAdminLayoutRoute(path) {
             useEffect(()=>{
                 applyStoredTheme();
             }, []);
+            const fieldServices = useMemo(()=>buildBylineFieldServices(user), [
+                abilityFingerprint(user)
+            ]);
             const handleSetLocale = async (next)=>{
                 await setAdminLocaleFn({
                     data: {
@@ -77,7 +80,7 @@ function createAdminLayoutRoute(path) {
                     children: /*#__PURE__*/ jsx(BylineAdminServicesProvider, {
                         services: bylineAdminServices,
                         children: /*#__PURE__*/ jsx(BylineFieldServicesProvider, {
-                            services: bylineFieldServices,
+                            services: fieldServices,
                             children: /*#__PURE__*/ jsx(BylineAiAdminProvider, {
                                 children: /*#__PURE__*/ jsxs(AdminMenuProvider, {
                                     children: [

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

@@ -2,15 +2,17 @@ import { createServerFn } from "@tanstack/react-start";
 import { getAdminRequestContext } from "@byline/client/server";
 import { ERR_NOT_FOUND, getLogger, getServerConfig } from "@byline/core";
 import { createDocument } from "@byline/core/services";
+import { getDefaultStatus } from "@byline/core/workflow";
 import { ensureCollection } from "../../integrations/api-utils.js";
 import { adminSessionMiddleware } from "../../integrations/session-middleware.js";
 import { withDocumentMutationErrors } from "../document-mutation-errors.js";
+import { validateDocumentWriteInput } from "../document-write-input.js";
 import { toCommittedDocumentHookFailureResponse } from "./save-outcome.js";
 const createCollectionDocument = createServerFn({
     method: 'POST'
 }).middleware([
     adminSessionMiddleware
-]).validator((input)=>input).handler(withDocumentMutationErrors(async ({ data: input })=>{
+]).validator((input)=>validateDocumentWriteInput(input, 'create')).handler(withDocumentMutationErrors(async ({ data: input })=>{
     const { collection: path, data: documentData, locale, path: explicitPath, availableLocales } = input;
     const logger = getLogger();
     const config = await ensureCollection(path);
@@ -36,7 +38,7 @@ const createCollectionDocument = createServerFn({
     try {
         result = await createDocument(ctx, {
             data: structuredClone(documentData),
-            status: documentData.status,
+            status: getDefaultStatus(config.definition),
             locale: locale ?? serverConfig.i18n.content.defaultLocale,
             path: explicitPath,
             availableLocales

package/dist/server-fns/collections/restore-version.d.ts

@@ -23,4 +23,5 @@ export declare const restoreDocumentVersion: import("@tanstack/react-start").Req
     revision: number;
     documentVersionId: string;
     sourceVersionId: string;
+    validationIssues?: import("@byline/core").DocumentFieldIssue[] | undefined;
 }>>;

package/dist/server-fns/collections/restore-version.js

@@ -43,7 +43,10 @@ const restore_version_restoreDocumentVersion = createServerFn({
             documentId: result.documentId,
             revision: result.revision,
             documentVersionId: result.documentVersionId,
-            sourceVersionId: result.sourceVersionId
+            sourceVersionId: result.sourceVersionId,
+            ...result.validationIssues ? {
+                validationIssues: result.validationIssues
+            } : {}
         };
     } catch (error) {
         const committedFailure = toCommittedDocumentHookFailureResponse(error);

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

@@ -5,12 +5,13 @@ import { saveDocument, updateDocumentSystemFields } from "@byline/core/services"
 import { ensureCollection } from "../../integrations/api-utils.js";
 import { adminSessionMiddleware } from "../../integrations/session-middleware.js";
 import { withDocumentMutationErrors } from "../document-mutation-errors.js";
+import { validateDocumentWriteInput } from "../document-write-input.js";
 import { toCommittedDocumentHookFailureResponse } from "./save-outcome.js";
 const updateCollectionDocumentWithPatches = createServerFn({
     method: 'POST'
 }).middleware([
     adminSessionMiddleware
-]).validator((input)=>input).handler(withDocumentMutationErrors(async ({ data: input })=>{
+]).validator((input)=>validateDocumentWriteInput(input, 'patch')).handler(withDocumentMutationErrors(async ({ data: input })=>{
     const { collection: path, id, patches, expectedRevision, locale, path: explicitPath, availableLocales } = input;
     const logger = getLogger();
     const config = await ensureCollection(path);
@@ -60,7 +61,7 @@ const updateCollectionDocumentSystemFields = createServerFn({
     method: 'POST'
 }).middleware([
     adminSessionMiddleware
-]).validator((input)=>input).handler(withDocumentMutationErrors(async ({ data: input })=>{
+]).validator((input)=>validateDocumentWriteInput(input, 'metadata')).handler(withDocumentMutationErrors(async ({ data: input })=>{
     const { collection: path, id, expectedRevision, locale, path: explicitPath, availableLocales } = input;
     const logger = getLogger();
     const config = await ensureCollection(path);

package/dist/server-fns/document-mutation-errors.js

@@ -1,4 +1,4 @@
-import { BylineError, ErrorCodes, getDocumentRevisionValidationDetails, getDocumentStaleDetails, getLockConflictDetails } from "@byline/core";
+import { BylineError, ErrorCodes, getDocumentFieldValidationDetails, getDocumentRevisionValidationDetails, getDocumentStaleDetails, getLockConflictDetails } from "@byline/core";
 import { getDocumentHookCommittedDetails } from "@byline/core/services";
 import { committedTreeReceipt } from "./structural-receipt.js";
 function documentMutationError(error) {
@@ -14,6 +14,12 @@ function documentMutationError(error) {
         message: 'Reload this document before making changes.',
         details: validation
     };
+    const fields = getDocumentFieldValidationDetails(error);
+    if (fields) return {
+        code: ErrorCodes.VALIDATION,
+        message: 'Some document fields are invalid.',
+        details: fields
+    };
     const lock = getLockConflictDetails(error);
     if (lock) return {
         code: ErrorCodes.LOCK_CONFLICT,

package/dist/server-fns/document-write-input.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 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
+ */
+/** Shape checks complement lifecycle authorization, revision and field validation. */
+export declare function validateDocumentWriteInput<T>(input: T, mode: 'create' | 'patch' | 'metadata'): T;

package/dist/server-fns/document-write-input.js

@@ -0,0 +1,44 @@
+import { ERR_VALIDATION, parseInstancePath } from "@byline/core";
+const object = (value)=>null !== value && 'object' == typeof value && !Array.isArray(value);
+const document_write_input_text = (value)=>'string' == typeof value && value.trim().length > 0;
+const index = (value)=>Number.isSafeInteger(value) && value >= 0;
+const path = (value)=>document_write_input_text(value) && parseInstancePath(value).ok;
+function patches(value) {
+    return Array.isArray(value) && value.every((patch)=>{
+        if (!object(patch) || !path(patch.path)) return false;
+        if (void 0 !== patch.opId && !document_write_input_text(patch.opId)) return false;
+        if (void 0 !== patch.timestamp && !document_write_input_text(patch.timestamp)) return false;
+        switch(patch.kind){
+            case 'field.set':
+                return 'value' in patch;
+            case 'field.clear':
+                return true;
+            case 'array.insert':
+                return 'item' in patch && (void 0 === patch.index || index(patch.index));
+            case 'array.move':
+                return document_write_input_text(patch.itemId) && index(patch.toIndex);
+            case 'array.remove':
+                return document_write_input_text(patch.itemId);
+            case 'array.updateItem':
+                return document_write_input_text(patch.itemId) && patches(patch.patches);
+            case 'block.add':
+                return document_write_input_text(patch.blockType) && (void 0 === patch.index || index(patch.index));
+            case 'block.move':
+                return document_write_input_text(patch.blockId) && index(patch.toIndex);
+            case 'block.remove':
+                return document_write_input_text(patch.blockId);
+            case 'block.updateField':
+                return document_write_input_text(patch.blockId) && path(patch.fieldPath) && 'value' in patch;
+            default:
+                return false;
+        }
+    });
+}
+function validateDocumentWriteInput(input, mode) {
+    const valid = object(input) && document_write_input_text(input.collection) && ('create' === mode ? object(input.data) : document_write_input_text(input.id)) && (void 0 === input.locale || document_write_input_text(input.locale)) && (null == input.path || 'string' == typeof input.path) && (void 0 === input.availableLocales || Array.isArray(input.availableLocales) && input.availableLocales.every(document_write_input_text)) && ('patch' !== mode || patches(input.patches));
+    if (!valid) throw ERR_VALIDATION({
+        message: 'Invalid document write request.'
+    });
+    return input;
+}
+export { validateDocumentWriteInput };

package/dist/server-fns/singletons/restore-version.d.ts

@@ -15,4 +15,4 @@ export declare const restoreSingletonVersion: import("@tanstack/react-start").Re
     expectedRevision: number;
     singleton: string;
     versionId: string;
-}, Promise<import("@byline/core").SingletonSaveResult>>;
+}, Promise<import("../collections/save-outcome.js").CollectionDocumentCommittedHookFailureResponse | import("@byline/core").RestoreSingletonVersionResult>>;

package/package.json

@@ -3,7 +3,7 @@
   "private": false,
   "type": "module",
   "license": "MPL-2.0",
-  "version": "6.2.1",
+  "version": "6.4.0",
   "engines": {
     "node": ">=20.9.0"
   },
@@ -124,16 +124,16 @@
     "clsx": "^2.1.1",
     "react-json-view-lite": "^2.5.0",
     "react-swipeable": "^7.0.2",
-    "zod": "^4.6.2",
-    "@byline/admin": "6.2.1",
-    "@byline/analytics-agent": "6.2.1",
-    "@byline/analytics": "6.2.1",
-    "@byline/ai": "6.2.1",
-    "@byline/client": "6.2.1",
-    "@byline/core": "6.2.1",
-    "@byline/i18n": "6.2.1",
-    "@byline/ui": "6.2.1",
-    "@byline/auth": "6.2.1"
+    "zod": "^4.6.5",
+    "@byline/ai": "6.4.0",
+    "@byline/analytics": "6.4.0",
+    "@byline/analytics-agent": "6.4.0",
+    "@byline/client": "6.4.0",
+    "@byline/ui": "6.4.0",
+    "@byline/admin": "6.4.0",
+    "@byline/auth": "6.4.0",
+    "@byline/core": "6.4.0",
+    "@byline/i18n": "6.4.0"
   },
   "peerDependencies": {
     "@tanstack/react-router": "^1.167.0",
@@ -145,10 +145,10 @@
   "devDependencies": {
     "@biomejs/biome": "2.5.13",
     "@rsbuild/plugin-react": "^2.1.0",
-    "@rslib/core": "^1.0.0",
-    "@tanstack/react-router": "^1.170.35",
-    "@tanstack/react-start": "^1.168.52",
-    "@types/node": "^26.5.1",
+    "@rslib/core": "^1.0.1",
+    "@tanstack/react-router": "^1.170.36",
+    "@tanstack/react-start": "^1.168.54",
+    "@types/node": "^26.6.1",
     "@types/react": "19.3.0",
     "@types/react-dom": "19.3.0",
     "@vitejs/plugin-react": "^6.1.1",
@@ -159,7 +159,7 @@
     "typescript": "^7.0.2",
     "typescript-plugin-css-modules": "^5.2.0",
     "vite": "^8.3.0",
-    "vitest": "^5.0.0"
+    "vitest": "^5.0.1"
   },
   "publishConfig": {
     "access": "public",

package/src/admin-shell/chrome/breadcrumbs/breadcrumbs-provider.tsx

@@ -6,7 +6,7 @@
  * Copyright (c) Infonomic Company Limited
  */
 
-import { createContext, type ReactNode, useContext, useState } from 'react'
+import { createContext, type ReactNode, useCallback, useContext, useState } from 'react'
 
 import type { Breadcrumb } from './@types.js'
 
@@ -23,6 +23,32 @@ interface BreadcrumbsContextType {
 
 const BreadcrumbsContext = createContext<BreadcrumbsContextType | undefined>(undefined)
 
+/**
+ * Route components build their breadcrumb trail from an inline array literal,
+ * so every render submits a new array that is almost always value-identical to
+ * the last one. Comparing by value lets the provider hand back the previous
+ * state, which keeps the array reference — and therefore the measurement
+ * effect in `Breadcrumbs` — stable across unrelated renders.
+ */
+function sameBreadcrumbs(a: Breadcrumb[], b: Breadcrumb[]): boolean {
+  if (a === b) return true
+  if (a.length !== b.length) return false
+  return a.every(
+    (crumb, index) =>
+      crumb.label === b[index].label &&
+      crumb.href === b[index].href &&
+      crumb.active === b[index].active
+  )
+}
+
+function sameSettings(a: BreadcrumbsSettings, b: BreadcrumbsSettings): boolean {
+  return (
+    a.homeLabel === b.homeLabel &&
+    a.homePath === b.homePath &&
+    sameBreadcrumbs(a.breadcrumbs, b.breadcrumbs)
+  )
+}
+
 export function BreadcrumbsProvider({ children }: { children: ReactNode }) {
   const [breadcrumbSettings, setBreadcrumbSettings] = useState<BreadcrumbsSettings>({
     homeLabel: 'Home',
@@ -30,10 +56,14 @@ export function BreadcrumbsProvider({ children }: { children: ReactNode }) {
     breadcrumbs: [],
   })
 
+  // `BreadcrumbsClient` lists this setter in its effect dependencies, so it
+  // has to stay referentially stable or the effect refires on every render.
+  const setBreadcrumbs = useCallback((settings: BreadcrumbsSettings) => {
+    setBreadcrumbSettings((previous) => (sameSettings(previous, settings) ? previous : settings))
+  }, [])
+
   return (
-    <BreadcrumbsContext
-      value={{ breadCrumbSettings: breadcrumbSettings, setBreadcrumbs: setBreadcrumbSettings }}
-    >
+    <BreadcrumbsContext value={{ breadCrumbSettings: breadcrumbSettings, setBreadcrumbs }}>
       {children}
     </BreadcrumbsContext>
   )