@byline/admin 4.19.0 → 5.1.0

package/dist/fields/field-services-context.d.ts

@@ -6,7 +6,7 @@
  * Copyright (c) Infonomic Company Limited
  */
 import { type ReactNode } from 'react';
-import type { BylineFieldServices } from './field-services-types';
+import type { BylineFieldServices } from './field-services-types.js';
 interface BylineFieldServicesProviderProps {
     services: BylineFieldServices;
     children: ReactNode;

package/dist/fields/field-services-types.d.ts

@@ -1,3 +1,4 @@
+import type { StructuralMutationReceipt } from '@byline/core';
 /**
  * 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
@@ -64,6 +65,7 @@ export interface TreeAncestor {
     path?: string;
 }
 export interface PlaceTreeNodeInput {
+    expectedRevision: number;
     collection: string;
     documentId: string;
     /** The new parent; `null` makes the document a root node. */
@@ -75,12 +77,13 @@ export interface PlaceTreeNodeInput {
 /** Place / move a document within its collection's tree. */
 export type PlaceTreeNodeFn = (input: PlaceTreeNodeInput) => Promise<{
     orderKey: string;
-}>;
+} & StructuralMutationReceipt>;
 /** Remove a document from the tree (back to the unplaced state). */
 export type RemoveFromTreeFn = (input: {
     collection: string;
     documentId: string;
-}) => Promise<void>;
+    expectedRevision: number;
+}) => Promise<StructuralMutationReceipt>;
 /** Resolve a document's ancestor chain, root-first, hydrated with titles. */
 export type GetTreeAncestorsFn = (input: {
     collection: string;

package/dist/forms/available-locales-widget.d.ts

@@ -1,10 +1,11 @@
-export { type ReconciledLocaleState, reconcileLocaleState } from './available-locales-reconcile';
+export { type ReconciledLocaleState, reconcileLocaleState } from './available-locales-reconcile.js';
 /** A content locale to render a checkbox for. */
 export interface AvailableLocalesWidgetLocale {
     code: string;
     label: string;
 }
 export interface AvailableLocalesWidgetProps {
+    disabled?: boolean;
     /** All configured content locales — one checkbox each (code + display label). */
     contentLocales: ReadonlyArray<AvailableLocalesWidgetLocale>;
     /**
@@ -26,4 +27,4 @@ export interface AvailableLocalesWidgetProps {
  * Stable override handles: `.byline-form-available-locales`,
  * `.byline-form-available-locales-list`.
  */
-export declare const AvailableLocalesWidget: ({ contentLocales, availableVersionLocales, }: AvailableLocalesWidgetProps) => import("react").JSX.Element | null;
+export declare const AvailableLocalesWidget: ({ disabled: mutationsBlocked, contentLocales, availableVersionLocales, }: AvailableLocalesWidgetProps) => import("react").JSX.Element | null;

package/dist/forms/available-locales-widget.js

@@ -7,7 +7,7 @@ import clsx from "clsx";
 import { reconcileLocaleState } from "./available-locales-reconcile.js";
 import available_locales_widget_module from "./available-locales-widget.module.js";
 import { useFormContext, useSystemAvailableLocales } from "./form-context.js";
-const AvailableLocalesWidget = ({ contentLocales, availableVersionLocales })=>{
+const AvailableLocalesWidget = ({ disabled: mutationsBlocked = false, contentLocales, availableVersionLocales })=>{
     const { t } = useTranslation('byline-admin');
     const { setSystemAvailableLocales } = useFormContext();
     const advertised = useSystemAvailableLocales();
@@ -18,6 +18,7 @@ const AvailableLocalesWidget = ({ contentLocales, availableVersionLocales })=>{
         availableVersionLocales
     ]);
     const toggle = useCallback((code, checked)=>{
+        if (mutationsBlocked) return;
         const next = new Set(advertised);
         if (checked) next.add(code);
         else next.delete(code);
@@ -25,6 +26,7 @@ const AvailableLocalesWidget = ({ contentLocales, availableVersionLocales })=>{
             ...next
         ]);
     }, [
+        mutationsBlocked,
         advertised,
         setSystemAvailableLocales
     ]);
@@ -52,7 +54,7 @@ const AvailableLocalesWidget = ({ contentLocales, availableVersionLocales })=>{
                         label: label,
                         intent: intent,
                         checked: checked,
-                        disabled: disabled,
+                        disabled: mutationsBlocked || disabled,
                         onCheckedChange: (value)=>toggle(code, true === value)
                     }, code);
                 })

package/dist/forms/document-actions.d.ts

@@ -1,4 +1,4 @@
-import type { PublishedVersionInfo } from './form-renderer';
+import type { PublishedVersionInfo } from './form-renderer.js';
 import type { ScheduledPublicationState } from './scheduled-publication-state.js';
 /**
  * Shape of a content-locale option as consumed by the Copy-to-Locale
@@ -9,7 +9,8 @@ export interface DocumentActionsLocaleOption {
     code: string;
     label: string;
 }
-export declare function DocumentActions({ publishedVersion, onUnpublish, onDelete, onDuplicate, sourceTitle, onCopyToLocale, sourceLocale, contentLocales, hasUnsavedChanges, onUnsavedChanges, onDeleteLocale, defaultLocale, availableLocales, scheduledPublicationState, onSchedulePublication, onConfirmScheduledPublication, onCancelScheduledPublication, }: {
+export declare function DocumentActions({ disabled, publishedVersion, onUnpublish, onDelete, onDuplicate, sourceTitle, onCopyToLocale, sourceLocale, contentLocales, hasUnsavedChanges, onUnsavedChanges, onDeleteLocale, defaultLocale, availableLocales, scheduledPublicationState, onSchedulePublication, onConfirmScheduledPublication, onCancelScheduledPublication, }: {
+    disabled?: boolean;
     publishedVersion?: PublishedVersionInfo | null;
     onUnpublish?: () => Promise<void>;
     onDelete?: () => Promise<void>;

package/dist/forms/document-actions.js

@@ -6,7 +6,7 @@ import { Button, Checkbox, CloseIcon, DeleteIcon, Dropdown, EllipsisIcon, IconBu
 import clsx from "clsx";
 import document_actions_module from "./document-actions.module.js";
 const DUPLICATE_TITLE_SUFFIX = ' (copy)';
-function DocumentActions({ publishedVersion, onUnpublish, onDelete, onDuplicate, sourceTitle, onCopyToLocale, sourceLocale, contentLocales, hasUnsavedChanges, onUnsavedChanges, onDeleteLocale, defaultLocale, availableLocales, scheduledPublicationState, onSchedulePublication, onConfirmScheduledPublication, onCancelScheduledPublication }) {
+function DocumentActions({ disabled = false, publishedVersion, onUnpublish, onDelete, onDuplicate, sourceTitle, onCopyToLocale, sourceLocale, contentLocales, hasUnsavedChanges, onUnsavedChanges, onDeleteLocale, defaultLocale, availableLocales, scheduledPublicationState, onSchedulePublication, onConfirmScheduledPublication, onCancelScheduledPublication }) {
     const { t } = useTranslation('byline-admin');
     const [showDeleteConfirm, setShowDeleteConfirm] = useState(false);
     const [showDuplicateConfirm, setShowDuplicateConfirm] = useState(false);
@@ -51,30 +51,35 @@ function DocumentActions({ publishedVersion, onUnpublish, onDelete, onDuplicate,
     }
     const hasAnyAction = schedulingActions.length > 0 || copyToLocaleAvailable || deleteLocaleAvailable || null != onDuplicate || null != onDelete;
     const handleOnDelete = ()=>{
+        if (disabled) return;
         setShowDeleteConfirm(false);
-        if (onDelete) onDelete();
+        if (onDelete) onDelete().catch(()=>{});
     };
     const handleOnDuplicate = async ()=>{
+        if (disabled) return;
         if (!onDuplicate) return;
         setDuplicateBusy(true);
         try {
             await onDuplicate();
             setShowDuplicateConfirm(false);
-        } finally{
+        } catch  {} finally{
             setDuplicateBusy(false);
         }
     };
     const handleOpenDuplicate = ()=>{
+        if (disabled) return;
         if (hasUnsavedChanges) return void onUnsavedChanges?.();
         setShowDuplicateConfirm(true);
     };
     const handleOpenCopyToLocale = ()=>{
+        if (disabled) return;
         if (hasUnsavedChanges) return void onUnsavedChanges?.();
         setCopyTargetLocale(availableTargetLocales[0]?.code ?? '');
         setCopyOverwrite(false);
         setShowCopyToLocaleConfirm(true);
     };
     const handleOnCopyToLocale = async ()=>{
+        if (disabled) return;
         if (!onCopyToLocale || !copyTargetLocale) return;
         setCopyToLocaleBusy(true);
         try {
@@ -83,17 +88,19 @@ function DocumentActions({ publishedVersion, onUnpublish, onDelete, onDuplicate,
                 overwrite: copyOverwrite
             });
             setShowCopyToLocaleConfirm(false);
-        } finally{
+        } catch  {} finally{
             setCopyToLocaleBusy(false);
         }
     };
     const handleOpenDeleteLocale = ()=>{
+        if (disabled) return;
         if (hasUnsavedChanges) return void onUnsavedChanges?.();
         const preferred = deletableLocales.find((loc)=>loc.code === sourceLocale)?.code;
         setDeleteTargetLocale(preferred ?? deletableLocales[0]?.code ?? '');
         setShowDeleteLocaleConfirm(true);
     };
     const handleOnDeleteLocale = async ()=>{
+        if (disabled) return;
         if (!onDeleteLocale || !deleteTargetLocale) return;
         setDeleteLocaleBusy(true);
         try {
@@ -101,7 +108,7 @@ function DocumentActions({ publishedVersion, onUnpublish, onDelete, onDuplicate,
                 targetLocale: deleteTargetLocale
             });
             setShowDeleteLocaleConfirm(false);
-        } finally{
+        } catch  {} finally{
             setDeleteLocaleBusy(false);
         }
     };
@@ -113,6 +120,7 @@ function DocumentActions({ publishedVersion, onUnpublish, onDelete, onDuplicate,
             hasAnyAction && /*#__PURE__*/ jsxs(Dropdown.Root, {
                 children: [
                     /*#__PURE__*/ jsx(Dropdown.Trigger, {
+                        disabled: disabled,
                         render: /*#__PURE__*/ jsx(IconButton, {
                             variant: "text",
                             intent: "noeffect",
@@ -134,6 +142,7 @@ function DocumentActions({ publishedVersion, onUnpublish, onDelete, onDuplicate,
                                 schedulingActions.length > 0 && /*#__PURE__*/ jsxs(Fragment, {
                                     children: [
                                         schedulingActions.map((action)=>/*#__PURE__*/ jsx(Dropdown.Item, {
+                                                disabled: disabled,
                                                 onClick: action.onSelect,
                                                 children: /*#__PURE__*/ jsx("div", {
                                                     className: clsx('byline-form-actions-item', document_actions_module.item),
@@ -141,6 +150,7 @@ function DocumentActions({ publishedVersion, onUnpublish, onDelete, onDuplicate,
                                                         className: clsx('byline-form-actions-item-text', document_actions_module["item-text"]),
                                                         children: /*#__PURE__*/ jsx("button", {
                                                             type: "button",
+                                                            disabled: disabled,
                                                             children: action.label
                                                         })
                                                     })
@@ -150,6 +160,7 @@ function DocumentActions({ publishedVersion, onUnpublish, onDelete, onDuplicate,
                                     ]
                                 }),
                                 copyToLocaleAvailable && /*#__PURE__*/ jsx(Dropdown.Item, {
+                                    disabled: disabled,
                                     onClick: handleOpenCopyToLocale,
                                     children: /*#__PURE__*/ jsx("div", {
                                         className: clsx('byline-form-actions-item', document_actions_module.item),
@@ -157,12 +168,14 @@ function DocumentActions({ publishedVersion, onUnpublish, onDelete, onDuplicate,
                                             className: clsx('byline-form-actions-item-text', document_actions_module["item-text"]),
                                             children: /*#__PURE__*/ jsx("button", {
                                                 type: "button",
+                                                disabled: disabled,
                                                 children: t('documentActions.copyToLocaleMenuItem')
                                             })
                                         })
                                     })
                                 }),
                                 deleteLocaleAvailable && /*#__PURE__*/ jsx(Dropdown.Item, {
+                                    disabled: disabled,
                                     onClick: handleOpenDeleteLocale,
                                     children: /*#__PURE__*/ jsx("div", {
                                         className: clsx('byline-form-actions-item', document_actions_module.item),
@@ -170,12 +183,14 @@ function DocumentActions({ publishedVersion, onUnpublish, onDelete, onDuplicate,
                                             className: clsx('byline-form-actions-item-text', document_actions_module["item-text"]),
                                             children: /*#__PURE__*/ jsx("button", {
                                                 type: "button",
+                                                disabled: disabled,
                                                 children: t('documentActions.deleteLocale.menuItem')
                                             })
                                         })
                                     })
                                 }),
                                 onDuplicate && /*#__PURE__*/ jsx(Dropdown.Item, {
+                                    disabled: disabled,
                                     onClick: handleOpenDuplicate,
                                     children: /*#__PURE__*/ jsx("div", {
                                         className: clsx('byline-form-actions-item', document_actions_module.item),
@@ -183,6 +198,7 @@ function DocumentActions({ publishedVersion, onUnpublish, onDelete, onDuplicate,
                                             className: clsx('byline-form-actions-item-text', document_actions_module["item-text"]),
                                             children: /*#__PURE__*/ jsx("button", {
                                                 type: "button",
+                                                disabled: disabled,
                                                 children: t('common.actions.duplicate')
                                             })
                                         })
@@ -192,6 +208,7 @@ function DocumentActions({ publishedVersion, onUnpublish, onDelete, onDuplicate,
                                     children: [
                                         /*#__PURE__*/ jsx(Dropdown.Separator, {}),
                                         /*#__PURE__*/ jsx(Dropdown.Item, {
+                                            disabled: disabled,
                                             onClick: ()=>{
                                                 setShowDeleteConfirm(true);
                                             },
@@ -286,6 +303,7 @@ function DocumentActions({ publishedVersion, onUnpublish, onDelete, onDuplicate,
                                         minWidth: '80px'
                                     },
                                     intent: "danger",
+                                    disabled: disabled,
                                     onClick: handleOnDelete,
                                     children: t('common.actions.delete')
                                 })
@@ -397,7 +415,7 @@ function DocumentActions({ publishedVersion, onUnpublish, onDelete, onDuplicate,
                                     onClick: ()=>{
                                         if (!duplicateBusy) setShowDuplicateConfirm(false);
                                     },
-                                    disabled: duplicateBusy,
+                                    disabled: disabled || duplicateBusy,
                                     children: t('common.actions.cancel')
                                 }),
                                 /*#__PURE__*/ jsx(Button, {
@@ -407,7 +425,7 @@ function DocumentActions({ publishedVersion, onUnpublish, onDelete, onDuplicate,
                                     },
                                     intent: "primary",
                                     onClick: handleOnDuplicate,
-                                    disabled: duplicateBusy,
+                                    disabled: disabled || duplicateBusy,
                                     children: duplicateBusy ? t('documentActions.duplicate.busyButton') : t('common.actions.duplicate')
                                 })
                             ]
@@ -499,7 +517,7 @@ function DocumentActions({ publishedVersion, onUnpublish, onDelete, onDuplicate,
                                             onValueChange: (value)=>{
                                                 if (null != value) setCopyTargetLocale(value);
                                             },
-                                            disabled: copyToLocaleBusy
+                                            disabled: disabled || copyToLocaleBusy
                                         })
                                     ]
                                 }),
@@ -513,7 +531,7 @@ function DocumentActions({ publishedVersion, onUnpublish, onDelete, onDuplicate,
                                         name: "overwrite",
                                         label: t('documentActions.copyToLocale.overwriteLabel'),
                                         checked: copyOverwrite,
-                                        disabled: copyToLocaleBusy,
+                                        disabled: disabled || copyToLocaleBusy,
                                         helpText: t('documentActions.copyToLocale.overwriteHelp'),
                                         onCheckedChange: (value)=>{
                                             setCopyOverwrite(true === value);
@@ -540,7 +558,7 @@ function DocumentActions({ publishedVersion, onUnpublish, onDelete, onDuplicate,
                                     onClick: ()=>{
                                         if (!copyToLocaleBusy) setShowCopyToLocaleConfirm(false);
                                     },
-                                    disabled: copyToLocaleBusy,
+                                    disabled: disabled || copyToLocaleBusy,
                                     children: t('common.actions.cancel')
                                 }),
                                 /*#__PURE__*/ jsx(Button, {
@@ -550,7 +568,7 @@ function DocumentActions({ publishedVersion, onUnpublish, onDelete, onDuplicate,
                                     },
                                     intent: "primary",
                                     onClick: handleOnCopyToLocale,
-                                    disabled: copyToLocaleBusy || !copyTargetLocale,
+                                    disabled: disabled || copyToLocaleBusy || !copyTargetLocale,
                                     children: copyToLocaleBusy ? t('documentActions.copyToLocale.busyButton') : t('documentActions.copyToLocale.confirmButton')
                                 })
                             ]
@@ -620,7 +638,7 @@ function DocumentActions({ publishedVersion, onUnpublish, onDelete, onDuplicate,
                                             onValueChange: (value)=>{
                                                 if (null != value) setDeleteTargetLocale(value);
                                             },
-                                            disabled: deleteLocaleBusy
+                                            disabled: disabled || deleteLocaleBusy
                                         })
                                     ]
                                 }),
@@ -650,7 +668,7 @@ function DocumentActions({ publishedVersion, onUnpublish, onDelete, onDuplicate,
                                     onClick: ()=>{
                                         if (!deleteLocaleBusy) setShowDeleteLocaleConfirm(false);
                                     },
-                                    disabled: deleteLocaleBusy,
+                                    disabled: disabled || deleteLocaleBusy,
                                     children: t('common.actions.cancel')
                                 }),
                                 /*#__PURE__*/ jsx(Button, {
@@ -660,7 +678,7 @@ function DocumentActions({ publishedVersion, onUnpublish, onDelete, onDuplicate,
                                     },
                                     intent: "danger",
                                     onClick: handleOnDeleteLocale,
-                                    disabled: deleteLocaleBusy || !deleteTargetLocale,
+                                    disabled: disabled || deleteLocaleBusy || !deleteTargetLocale,
                                     children: deleteLocaleBusy ? t('documentActions.deleteLocale.busyButton') : t('documentActions.deleteLocale.confirmButton')
                                 })
                             ]

package/dist/forms/form-renderer.d.ts

@@ -8,9 +8,9 @@
 import { type ReactNode } from 'react';
 import type { Field, FormAdminConfig, WorkflowStatus } from '@byline/core';
 import type { DocumentPatch } from '@byline/core/patches';
-import { type DocumentActionsLocaleOption } from './document-actions';
-import { type ScheduledPublicationInfo, type SchedulePublicationInput } from './scheduled-publication-control';
-import type { UseNavigationGuard } from './navigation-guard';
+import { type DocumentActionsLocaleOption } from './document-actions.js';
+import { type ScheduledPublicationInfo, type SchedulePublicationInput } from './scheduled-publication-control.js';
+import type { UseNavigationGuard } from './navigation-guard.js';
 /** Metadata about a previously published version that is still live. */
 export interface PublishedVersionInfo {
     id: string;
@@ -37,6 +37,15 @@ export interface SystemFieldsSubmitPayload {
 }
 /** Props shared by both the public FormRenderer and its internal FormContent component. */
 export interface FormRendererProps {
+    mutationIssue?: 'stale' | 'reload' | 'lock' | 'unavailable' | 'committed' | null;
+    mutationsBlocked?: boolean;
+    observedRevision?: number;
+    onMutationError?: (error: unknown) => 'blocked' | 'committed' | null | void;
+    onTreeMutationCommitted?: (receipt: import('@byline/core').StructuralMutationReceipt) => void;
+    scheduledPublicationsNeedReconfirmation?: boolean;
+    scheduledPublicationsHref?: string;
+    /** Explicit discard action; defaults to a complete server reload. */
+    onReloadDocument?: () => void | Promise<void>;
     mode: 'create' | 'edit';
     fields: Field[];
     onSubmit: (data: any) => void | Promise<void>;

package/dist/forms/form-renderer.js

@@ -24,7 +24,7 @@ import { computeStatusTransitions } from "./status-transitions.js";
 import { TreePlacementWidget } from "./tree-placement-widget.js";
 import { executeUploadsWithProgress } from "./upload-executor.js";
 import { useFormLayout } from "./use-form-layout.js";
-const FormContent = ({ mode, fields, onSubmit, onCancel, onStatusChange, onUnpublish, scheduledPublication, onSchedulePublication, onConfirmScheduledPublication, onCancelScheduledPublication, onDelete, onDuplicate, onCopyToLocale, onDeleteLocale, contentLocales, nextStatus, workflowStatuses, publishedVersion, initialData, adminConfig, useAsTitle, useAsPath, showPath = true, heading, advertiseLocales, tree, headingLabel, headerSlot, collectionPath, initialLocale, onLocaleChange, defaultLocale = 'en', useNavigationGuard: useNavigationGuardProp, restoreWarnings, _activeTabBySet, _onTabChange })=>{
+const FormContent = ({ mode, mutationIssue, mutationsBlocked = false, observedRevision, onMutationError, onTreeMutationCommitted, scheduledPublicationsNeedReconfirmation = false, scheduledPublicationsHref, onReloadDocument, fields, onSubmit, onCancel, onStatusChange, onUnpublish, scheduledPublication, onSchedulePublication, onConfirmScheduledPublication, onCancelScheduledPublication, onDelete, onDuplicate, onCopyToLocale, onDeleteLocale, contentLocales, nextStatus, workflowStatuses, publishedVersion, initialData, adminConfig, useAsTitle, useAsPath, showPath = true, heading, advertiseLocales, tree, headingLabel, headerSlot, collectionPath, initialLocale, onLocaleChange, defaultLocale = 'en', useNavigationGuard: useNavigationGuardProp, restoreWarnings, _activeTabBySet, _onTabChange })=>{
     const { getFieldValues, runFieldHooks, validateForm, errors: initialErrors, hasChanges: hasChangesFn, resetHasChanges, getPatches, getDirtyBreakdown, getSystemPath, getSystemAvailableLocales, subscribeErrors, subscribeMeta, setFieldValue, setFieldError, getPendingUploads, clearPendingUploads, setFieldUploading } = useFormContext();
     const { t } = useTranslation('byline-admin');
     const [errors, setErrors] = useState(initialErrors);
@@ -41,6 +41,7 @@ const FormContent = ({ mode, fields, onSubmit, onCancel, onStatusChange, onUnpub
     const [pendingSystemFieldsSubmit, setPendingSystemFieldsSubmit] = useState(null);
     const [contentLocale, setContentLocale] = useState(initialLocale ?? defaultLocale);
     const scheduling = useScheduledPublication({
+        disabled: mutationsBlocked,
         schedule: scheduledPublication ?? null,
         onSchedule: onSchedulePublication,
         onConfirm: onConfirmScheduledPublication,
@@ -96,7 +97,27 @@ const FormContent = ({ mode, fields, onSubmit, onCancel, onStatusChange, onUnpub
     }) : 'create' === mode ? t('forms.heading.create') : t('forms.heading.edit'));
     const guardFromContext = useNavigationGuardAdapter();
     const useGuard = useNavigationGuardProp ?? guardFromContext;
-    const guard = useGuard(hasChanges);
+    const [discarding, setDiscarding] = useState(false);
+    const [reloadFailed, setReloadFailed] = useState(false);
+    const warningRef = useRef(null);
+    const mutationBlockedRef = useRef(mutationsBlocked);
+    mutationBlockedRef.current = mutationsBlocked || discarding;
+    const guard = useGuard(hasChanges && !discarding);
+    useEffect(()=>{
+        if (mutationIssue) warningRef.current?.focus();
+    }, [
+        mutationIssue
+    ]);
+    useEffect(()=>{
+        if (!discarding) return;
+        Promise.resolve().then(()=>onReloadDocument ? onReloadDocument() : window.location.reload()).catch(()=>{
+            setDiscarding(false);
+            setReloadFailed(true);
+        });
+    }, [
+        discarding,
+        onReloadDocument
+    ]);
     const currentStatus = initialData?.status;
     const { primaryStatus, secondaryStatuses, isTerminal } = computeStatusTransitions(currentStatus, workflowStatuses, nextStatus);
     useEffect(()=>subscribeErrors((newErrors)=>setErrors(newErrors)), [
@@ -113,6 +134,11 @@ const FormContent = ({ mode, fields, onSubmit, onCancel, onStatusChange, onUnpub
     useEffect(()=>{
         if (isBusy || !restoreFocusAfterBusyRef.current) return;
         restoreFocusAfterBusyRef.current = false;
+        if (mutationIssue) {
+            warningRef.current?.focus();
+            focusBeforeBusyRef.current = null;
+            return;
+        }
         const original = focusBeforeBusyRef.current;
         focusBeforeBusyRef.current = null;
         const originalCanReceiveFocus = original?.isConnected === true && !original.matches(':disabled, [aria-disabled="true"]');
@@ -121,7 +147,8 @@ const FormContent = ({ mode, fields, onSubmit, onCancel, onStatusChange, onUnpub
             preventScroll: true
         });
     }, [
-        isBusy
+        isBusy,
+        mutationIssue
     ]);
     const captureFocusBeforeBusy = useCallback(()=>{
         if (null != focusBeforeBusyRef.current) return;
@@ -134,7 +161,7 @@ const FormContent = ({ mode, fields, onSubmit, onCancel, onStatusChange, onUnpub
         if (onCancel && 'function' == typeof onCancel) onCancel();
     };
     const submitPayload = useCallback(async (payload)=>{
-        if ('function' != typeof onSubmit) return;
+        if (mutationBlockedRef.current || 'function' != typeof onSubmit) return;
         if (submittingRef.current) return;
         submittingRef.current = true;
         captureFocusBeforeBusy();
@@ -152,6 +179,7 @@ const FormContent = ({ mode, fields, onSubmit, onCancel, onStatusChange, onUnpub
         resetHasChanges
     ]);
     const handleSubmit = (e)=>{
+        if (mutationBlockedRef.current) return void e.preventDefault();
         e.preventDefault();
         (async ()=>{
             const hookErrors = await runFieldHooks(fields);
@@ -161,6 +189,7 @@ const FormContent = ({ mode, fields, onSubmit, onCancel, onStatusChange, onUnpub
                 ...formErrors
             ];
             if (allErrors.length > 0) return void console.error('Form validation failed:', allErrors);
+            if (mutationBlockedRef.current) return;
             const pendingUploads = getPendingUploads();
             if (pendingUploads.size > 0) {
                 captureFocusBeforeBusy();
@@ -307,6 +336,7 @@ const FormContent = ({ mode, fields, onSubmit, onCancel, onStatusChange, onUnpub
                                 /*#__PURE__*/ jsx("div", {
                                     className: clsx('byline-form-status-details', form_renderer_module["status-details"]),
                                     children: /*#__PURE__*/ jsx(FormStatusDisplay, {
+                                        disabled: mutationsBlocked || discarding,
                                         initialData: initialData,
                                         workflowStatuses: workflowStatuses,
                                         publishedVersion: publishedVersion,
@@ -332,7 +362,7 @@ const FormContent = ({ mode, fields, onSubmit, onCancel, onStatusChange, onUnpub
                                             className: clsx('byline-form-actions-button', form_renderer_module["actions-button"]),
                                             size: "sm",
                                             type: "submit",
-                                            disabled: false === hasChanges || isUploading || isSubmitting,
+                                            disabled: mutationsBlocked || discarding || false === hasChanges || isUploading || isSubmitting,
                                             "aria-label": isSubmitting ? t('common.actions.save') : void 0,
                                             children: isUploading ? t('forms.actions.uploading') : /*#__PURE__*/ jsxs("span", {
                                                 className: clsx('byline-form-save-content', form_renderer_module["save-content"]),
@@ -366,21 +396,27 @@ const FormContent = ({ mode, fields, onSubmit, onCancel, onStatusChange, onUnpub
                                                 size: "sm",
                                                 type: "button",
                                                 intent: isTerminal ? 'info' : 'success',
-                                                disabled: statusBusy,
+                                                disabled: mutationsBlocked || discarding || statusBusy,
                                                 onOptionSelect: async (value)=>{
+                                                    if (mutationBlockedRef.current) return;
                                                     if (hasChanges) return void setShowUnsavedModal(true);
                                                     setStatusBusy(true);
                                                     try {
                                                         await onStatusChange(value);
+                                                    } catch (error) {
+                                                        onMutationError?.(error);
                                                     } finally{
                                                         setStatusBusy(false);
                                                     }
                                                 },
                                                 onButtonClick: isTerminal ? void 0 : async ()=>{
+                                                    if (mutationBlockedRef.current) return;
                                                     if (hasChanges) return void setShowUnsavedModal(true);
                                                     setStatusBusy(true);
                                                     try {
                                                         await onStatusChange(primaryStatus.name);
+                                                    } catch (error) {
+                                                        onMutationError?.(error);
                                                     } finally{
                                                         setStatusBusy(false);
                                                     }
@@ -389,6 +425,7 @@ const FormContent = ({ mode, fields, onSubmit, onCancel, onStatusChange, onUnpub
                                             })
                                         }),
                                         /*#__PURE__*/ jsx(DocumentActions, {
+                                            disabled: mutationsBlocked || discarding,
                                             publishedVersion: publishedVersion,
                                             onUnpublish: onUnpublish,
                                             onDelete: onDelete,
@@ -411,10 +448,57 @@ const FormContent = ({ mode, fields, onSubmit, onCancel, onStatusChange, onUnpub
                                 })
                             ]
                         }),
+                        (mutationIssue || scheduledPublicationsNeedReconfirmation) && /*#__PURE__*/ jsxs("div", {
+                            ref: warningRef,
+                            tabIndex: -1,
+                            role: "alert",
+                            "aria-live": "assertive",
+                            className: clsx('byline-document-concurrency', form_renderer_module.concurrency),
+                            children: [
+                                mutationIssue && /*#__PURE__*/ jsxs(Alert, {
+                                    intent: "warning",
+                                    icon: true,
+                                    close: false,
+                                    title: t(`documentConcurrency.${mutationIssue}Title`),
+                                    children: [
+                                        /*#__PURE__*/ jsx("p", {
+                                            children: t(`documentConcurrency.${mutationIssue}`)
+                                        }),
+                                        'committed' !== mutationIssue && /*#__PURE__*/ jsx(Button, {
+                                            type: "button",
+                                            disabled: discarding,
+                                            onClick: ()=>{
+                                                setReloadFailed(false);
+                                                setDiscarding(true);
+                                            },
+                                            children: t('documentConcurrency.reloadAction')
+                                        }),
+                                        reloadFailed && /*#__PURE__*/ jsx("p", {
+                                            children: t('documentConcurrency.reloadFailed')
+                                        })
+                                    ]
+                                }),
+                                scheduledPublicationsNeedReconfirmation && /*#__PURE__*/ jsxs(Alert, {
+                                    intent: "warning",
+                                    icon: true,
+                                    close: false,
+                                    title: t('documentConcurrency.schedulesTitle'),
+                                    children: [
+                                        /*#__PURE__*/ jsx("p", {
+                                            children: t('documentConcurrency.schedules')
+                                        }),
+                                        scheduledPublicationsHref && /*#__PURE__*/ jsx("a", {
+                                            href: scheduledPublicationsHref,
+                                            children: t('documentConcurrency.reviewSchedules')
+                                        })
+                                    ]
+                                })
+                            ]
+                        }),
                         /*#__PURE__*/ jsx(ScheduledPublicationNotice, {
                             state: scheduling.state,
                             timeZone: scheduling.timeZone,
-                            busy: scheduling.busy,
+                            busy: mutationsBlocked || discarding || scheduling.busy,
                             onConfirm: scheduling.confirm,
                             onReschedule: scheduling.openSchedule,
                             onCancel: scheduling.cancel
@@ -450,6 +534,7 @@ const FormContent = ({ mode, fields, onSubmit, onCancel, onStatusChange, onUnpub
                                     className: clsx('byline-form-sidebar', form_renderer_module.sidebar),
                                     children: [
                                         showPath && (useAsPath || 'string' == typeof initialData?.path && initialData.path.length > 0) && /*#__PURE__*/ jsx(PathWidget, {
+                                            disabled: mutationsBlocked || discarding,
                                             useAsPath: useAsPath,
                                             collectionPath: collectionPath ?? '',
                                             defaultLocale: defaultLocale,
@@ -459,11 +544,16 @@ const FormContent = ({ mode, fields, onSubmit, onCancel, onStatusChange, onUnpub
                                             sourceLocked: pathSourceLocked
                                         }),
                                         tree && 'edit' === mode && 'string' == typeof initialData?.id && /*#__PURE__*/ jsx(TreePlacementWidget, {
+                                            disabled: mutationsBlocked || discarding,
+                                            onMutationError: onMutationError,
+                                            onCommitted: onTreeMutationCommitted,
+                                            expectedRevision: observedRevision ?? initialData.revision,
                                             collectionPath: collectionPath ?? '',
                                             documentId: initialData.id,
                                             useAsTitle: useAsTitle
                                         }),
                                         advertiseLocales && /*#__PURE__*/ jsx(AvailableLocalesWidget, {
+                                            disabled: mutationsBlocked || discarding,
                                             contentLocales: contentLocales ?? [],
                                             availableVersionLocales: initialData?._availableVersionLocales ?? []
                                         }),
@@ -475,7 +565,7 @@ const FormContent = ({ mode, fields, onSubmit, onCancel, onStatusChange, onUnpub
                         showUnsavedModal && /*#__PURE__*/ jsx(UnsavedChangesModal, {
                             onClose: ()=>setShowUnsavedModal(false)
                         }),
-                        null != pendingSystemFieldsSubmit && /*#__PURE__*/ jsx(SystemFieldsConfirmModal, {
+                        !mutationsBlocked && !discarding && null != pendingSystemFieldsSubmit && /*#__PURE__*/ jsx(SystemFieldsConfirmModal, {
                             contentDirty: pendingSystemFieldsSubmit.contentDirty,
                             pathDirty: pendingSystemFieldsSubmit.pathDirty,
                             availableLocalesDirty: pendingSystemFieldsSubmit.availableLocalesDirty,

package/dist/forms/form-renderer.module.js

@@ -40,6 +40,7 @@ const form_renderer_module = {
     actionsComboButton: "actions-combo-button-XvqHCC",
     "actions-combo-trigger": "actions-combo-trigger-bmXUzc",
     actionsComboTrigger: "actions-combo-trigger-bmXUzc",
+    concurrency: "concurrency-UT6bX5",
     layout: "layout-WTbLYr",
     content: "content-_P5cdJ",
     sidebar: "sidebar-WsxX88",

package/dist/forms/form-renderer_module.css

@@ -189,6 +189,18 @@
   min-height: 28px;
 }
 
+:is(.concurrency-UT6bX5, .byline-document-concurrency) {
+  margin-top: var(--spacing-16);
+}
+
+:is(.concurrency-UT6bX5 button, .byline-document-concurrency button) {
+  margin-top: var(--spacing-12);
+}
+
+:is(.concurrency-UT6bX5 ~ .layout-WTbLYr, .byline-document-concurrency ~ .byline-form-layout) {
+  padding-top: var(--spacing-16);
+}
+
 :is(.layout-WTbLYr, .byline-form-layout) {
   gap: var(--spacing-12);
   padding-top: var(--spacing-32);