@byline/admin 4.19.0 → 5.0.0

package/dist/forms/path-widget.d.ts

@@ -1,5 +1,6 @@
 import type { SlugifierFn } from '@byline/core';
 export interface PathWidgetProps {
+    disabled?: boolean;
     /** The collection's `useAsPath` source field name, when configured. */
     useAsPath: string | undefined;
     /** Collection path, forwarded to the slugifier as context. */
@@ -51,4 +52,4 @@ export interface PathWidgetProps {
  * Stable override handles: `.byline-form-path`, `.byline-form-path-header`,
  * `.byline-form-path-regenerate`.
  */
-export declare const PathWidget: ({ useAsPath, collectionPath, defaultLocale, activeLocale, mode, slugifier, sourceLocked, }: PathWidgetProps) => import("react").JSX.Element;
+export declare const PathWidget: ({ useAsPath, collectionPath, defaultLocale, activeLocale, mode, slugifier, sourceLocked, disabled, }: PathWidgetProps) => import("react").JSX.Element;

package/dist/forms/path-widget.js

@@ -12,7 +12,7 @@ function coerceToString(value) {
     if (value instanceof Date) return value.toISOString();
     return String(value);
 }
-const PathWidget = ({ useAsPath, collectionPath, defaultLocale, activeLocale, mode, slugifier, sourceLocked = false })=>{
+const PathWidget = ({ useAsPath, collectionPath, defaultLocale, activeLocale, mode, slugifier, sourceLocked = false, disabled = false })=>{
     const { setSystemPath } = useFormContext();
     const { t } = useTranslation('byline-admin');
     const systemPath = useSystemPath();
@@ -37,13 +37,16 @@ const PathWidget = ({ useAsPath, collectionPath, defaultLocale, activeLocale, mo
     ]);
     const inputValue = systemPath ?? '';
     const handleChange = useCallback((next)=>{
+        if (disabled) return;
         setSystemPath(0 === next.length ? null : next);
     }, [
+        disabled,
         setSystemPath
     ]);
     const handleRegenerate = useCallback(()=>{
-        if (livePreview.length > 0) setSystemPath(livePreview);
+        if (!disabled && livePreview.length > 0) setSystemPath(livePreview);
     }, [
+        disabled,
         livePreview,
         setSystemPath
     ]);
@@ -90,6 +93,7 @@ const PathWidget = ({ useAsPath, collectionPath, defaultLocale, activeLocale, mo
                         type: "button",
                         onClick: handleRegenerate,
                         className: clsx('byline-form-path-regenerate', path_widget_module.regenerate),
+                        disabled: disabled,
                         "aria-label": t('pathWidget.regenerateAriaLabel', {
                             field: useAsPath
                         }),
@@ -100,6 +104,7 @@ const PathWidget = ({ useAsPath, collectionPath, defaultLocale, activeLocale, mo
                 ]
             }),
             /*#__PURE__*/ jsx(Input, {
+                disabled: disabled,
                 id: "system-path",
                 name: "__systemPath__",
                 value: inputValue,

package/dist/forms/scheduled-publication-control.d.ts

@@ -5,6 +5,7 @@ export interface SchedulePublicationInput {
     publishAt: string;
 }
 export interface UseScheduledPublicationArgs {
+    disabled?: boolean;
     schedule: ScheduledPublicationInfo | null;
     onSchedule?: (input: SchedulePublicationInput) => Promise<void>;
     onConfirm?: () => Promise<void>;
@@ -24,7 +25,7 @@ export interface UseScheduledPublicationReturn {
     /** The schedule / reschedule modal. Render once, anywhere in the form. */
     modal: React.ReactNode;
 }
-export declare function useScheduledPublication({ schedule, onSchedule, onConfirm, onCancel, hasUnsavedChanges, onUnsavedChanges, }: UseScheduledPublicationArgs): UseScheduledPublicationReturn;
+export declare function useScheduledPublication({ disabled, schedule, onSchedule, onConfirm, onCancel, hasUnsavedChanges, onUnsavedChanges, }: UseScheduledPublicationArgs): UseScheduledPublicationReturn;
 /**
  * One metadata cell for the form's status bar, matching the Status /
  * Last modified / Created cells in scale, sitting immediately after the status

package/dist/forms/scheduled-publication-control.js

@@ -28,7 +28,7 @@ function seedScheduleInstant(schedule) {
     seed.setSeconds(0, 0);
     return seed;
 }
-function useScheduledPublication({ schedule, onSchedule, onConfirm, onCancel, hasUnsavedChanges, onUnsavedChanges }) {
+function useScheduledPublication({ disabled = false, schedule, onSchedule, onConfirm, onCancel, hasUnsavedChanges, onUnsavedChanges }) {
     const timeZone = useMemo(browserTimeZone, []);
     const [now, setNow] = useState(()=>Date.now());
     const [showSchedule, setShowSchedule] = useState(false);
@@ -55,52 +55,56 @@ function useScheduledPublication({ schedule, onSchedule, onConfirm, onCancel, ha
         now
     ]);
     const openSchedule = useCallback(()=>{
+        if (disabled) return;
         if (hasUnsavedChanges) return void onUnsavedChanges();
         setShowSchedule(true);
     }, [
+        disabled,
         hasUnsavedChanges,
         onUnsavedChanges
     ]);
     const confirm = useCallback(async ()=>{
-        if (null == onConfirm) return;
+        if (disabled || null == onConfirm) return;
         if (hasUnsavedChanges) return void onUnsavedChanges();
         setBusy(true);
         try {
             await onConfirm();
-        } finally{
+        } catch  {} finally{
             setBusy(false);
         }
     }, [
+        disabled,
         onConfirm,
         hasUnsavedChanges,
         onUnsavedChanges
     ]);
     const cancel = useCallback(async ()=>{
-        if (null == onCancel) return;
+        if (disabled || null == onCancel) return;
         setBusy(true);
         try {
             await onCancel();
-        } finally{
+        } catch  {} finally{
             setBusy(false);
         }
     }, [
+        disabled,
         onCancel
     ]);
     const modal = showSchedule ? /*#__PURE__*/ jsx(ScheduleModal, {
         schedule: schedule,
         timeZone: timeZone,
         onSubmit: async (input)=>{
-            if (null == onSchedule) return;
+            if (disabled || null == onSchedule) return;
             setBusy(true);
             try {
                 await onSchedule(input);
                 setShowSchedule(false);
-            } finally{
+            } catch  {} finally{
                 setBusy(false);
             }
         },
         onDismiss: ()=>setShowSchedule(false),
-        busy: busy
+        busy: disabled || busy
     }) : null;
     return {
         state,

package/dist/forms/tree-placement-widget.d.ts

@@ -1,4 +1,8 @@
 export interface TreePlacementWidgetProps {
+    disabled?: boolean;
+    onMutationError?: (error: unknown) => 'blocked' | 'committed' | null | void;
+    onCommitted?: (receipt: import('@byline/core').StructuralMutationReceipt) => void;
+    expectedRevision: number;
     /** The collection path (`tree: true`). */
     collectionPath: string;
     /** The logical id of the document being edited. */
@@ -20,4 +24,4 @@ export interface TreePlacementWidgetProps {
  * Renders only in edit mode (placement needs a persisted document) and only when
  * the host wires the tree services. Stable override handle: `.byline-form-tree`.
  */
-export declare const TreePlacementWidget: ({ collectionPath, documentId, useAsTitle, }: TreePlacementWidgetProps) => import("react").JSX.Element | null;
+export declare const TreePlacementWidget: ({ collectionPath, disabled, onMutationError, onCommitted, expectedRevision, documentId, useAsTitle, }: TreePlacementWidgetProps) => import("react").JSX.Element | null;

package/dist/forms/tree-placement-widget.js

@@ -8,7 +8,7 @@ import clsx from "clsx";
 import { useBylineFieldServices } from "../fields/field-services-context.js";
 import { RelationPicker } from "../fields/relation/relation-picker.js";
 import tree_placement_widget_module from "./tree-placement-widget.module.js";
-const TreePlacementWidget = ({ collectionPath, documentId, useAsTitle })=>{
+const TreePlacementWidget = ({ collectionPath, disabled = false, onMutationError, onCommitted, expectedRevision, documentId, useAsTitle })=>{
     const { t } = useTranslation('byline-admin');
     const { getTreeAncestors, getTreeParent, placeTreeNode } = useBylineFieldServices();
     const definition = getCollectionDefinition(collectionPath);
@@ -60,7 +60,7 @@ const TreePlacementWidget = ({ collectionPath, documentId, useAsTitle })=>{
         t
     ]);
     const place = useCallback(async (parentDocumentId, optimistic)=>{
-        if (null == placeTreeNode || busy) return;
+        if (disabled || null == placeTreeNode || busy) return;
         const previousParent = parent;
         const previousPlaced = placed;
         setError(null);
@@ -68,12 +68,15 @@ const TreePlacementWidget = ({ collectionPath, documentId, useAsTitle })=>{
         setParent(optimistic);
         setPlaced(true);
         try {
-            await placeTreeNode({
+            const result = await placeTreeNode({
+                expectedRevision,
                 collection: collectionPath,
                 documentId,
                 parentDocumentId
             });
-        } catch  {
+            onCommitted?.(result);
+        } catch (error) {
+            if (onMutationError?.(error) === 'committed') return;
             setParent(previousParent);
             setPlaced(previousPlaced);
             setError(t('treeWidget.error'));
@@ -81,6 +84,10 @@ const TreePlacementWidget = ({ collectionPath, documentId, useAsTitle })=>{
             setBusy(false);
         }
     }, [
+        disabled,
+        onMutationError,
+        onCommitted,
+        expectedRevision,
         placeTreeNode,
         busy,
         parent,
@@ -136,20 +143,20 @@ const TreePlacementWidget = ({ collectionPath, documentId, useAsTitle })=>{
                         size: "xs",
                         variant: "outlined",
                         intent: "noeffect",
-                        disabled: loading || busy,
+                        disabled: disabled || loading || busy,
                         onClick: ()=>setPickerOpen(true),
                         children: t('treeWidget.choose')
                     }),
                     placed ? null != parent && /*#__PURE__*/ jsx("button", {
                         type: "button",
                         className: clsx('byline-form-tree-link', tree_placement_widget_module.link),
-                        disabled: busy,
+                        disabled: disabled || busy,
                         onClick: ()=>place(null, null),
                         children: t('treeWidget.makeRoot')
                     }) : /*#__PURE__*/ jsx("button", {
                         type: "button",
                         className: clsx('byline-form-tree-link', tree_placement_widget_module.link),
-                        disabled: loading || busy,
+                        disabled: disabled || loading || busy,
                         onClick: ()=>place(null, null),
                         children: t('treeWidget.addToTree')
                     })

package/package.json

@@ -2,7 +2,7 @@
   "name": "@byline/admin",
   "private": false,
   "license": "MPL-2.0",
-  "version": "4.19.0",
+  "version": "5.0.0",
   "engines": {
     "node": ">=20.9.0"
   },
@@ -183,12 +183,12 @@
     "react-diff-viewer-continued": "^4.4.0",
     "uuid": "^14.0.2",
     "zod": "^4.4.3",
-    "@byline/analytics": "4.19.0",
-    "@byline/analytics-agent": "4.19.0",
-    "@byline/auth": "4.19.0",
-    "@byline/ui": "4.19.0",
-    "@byline/i18n": "4.19.0",
-    "@byline/core": "4.19.0"
+    "@byline/core": "5.0.0",
+    "@byline/analytics": "5.0.0",
+    "@byline/i18n": "5.0.0",
+    "@byline/ui": "5.0.0",
+    "@byline/auth": "5.0.0",
+    "@byline/analytics-agent": "5.0.0"
   },
   "peerDependencies": {
     "react": "^19.0.0",

package/src/fields/field-services-types.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
@@ -72,6 +73,7 @@ export interface TreeAncestor {
 }
 
 export interface PlaceTreeNodeInput {
+  expectedRevision: number
   collection: string
   documentId: string
   /** The new parent; `null` makes the document a root node. */
@@ -82,10 +84,16 @@ export interface PlaceTreeNodeInput {
 }
 
 /** Place / move a document within its collection's tree. */
-export type PlaceTreeNodeFn = (input: PlaceTreeNodeInput) => Promise<{ orderKey: string }>
+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>
+export type RemoveFromTreeFn = (input: {
+  collection: string
+  documentId: string
+  expectedRevision: number
+}) => Promise<StructuralMutationReceipt>
 
 /** Resolve a document's ancestor chain, root-first, hydrated with titles. */
 export type GetTreeAncestorsFn = (input: {

package/src/forms/available-locales-widget.tsx

@@ -27,6 +27,7 @@ export interface AvailableLocalesWidgetLocale {
 }
 
 export interface AvailableLocalesWidgetProps {
+  disabled?: boolean
   /** All configured content locales — one checkbox each (code + display label). */
   contentLocales: ReadonlyArray<AvailableLocalesWidgetLocale>
   /**
@@ -50,6 +51,7 @@ export interface AvailableLocalesWidgetProps {
  * `.byline-form-available-locales-list`.
  */
 export const AvailableLocalesWidget = ({
+  disabled: mutationsBlocked = false,
   contentLocales,
   availableVersionLocales,
 }: AvailableLocalesWidgetProps) => {
@@ -62,6 +64,7 @@ export const AvailableLocalesWidget = ({
 
   const toggle = useCallback(
     (code: string, checked: boolean) => {
+      if (mutationsBlocked) return
       const next = new Set(advertised)
       if (checked) {
         next.add(code)
@@ -70,7 +73,7 @@ export const AvailableLocalesWidget = ({
       }
       setSystemAvailableLocales([...next])
     },
-    [advertised, setSystemAvailableLocales]
+    [mutationsBlocked, advertised, setSystemAvailableLocales]
   )
 
   if (contentLocales.length === 0) {
@@ -102,7 +105,7 @@ export const AvailableLocalesWidget = ({
               label={label}
               intent={intent}
               checked={checked}
-              disabled={disabled}
+              disabled={mutationsBlocked || disabled}
               onCheckedChange={(value) => toggle(code, value === true)}
             />
           )

package/src/forms/document-actions.tsx

@@ -41,6 +41,7 @@ export interface DocumentActionsLocaleOption {
 }
 
 export function DocumentActions({
+  disabled = false,
   publishedVersion,
   onUnpublish,
   onDelete,
@@ -59,6 +60,7 @@ export function DocumentActions({
   onConfirmScheduledPublication,
   onCancelScheduledPublication,
 }: {
+  disabled?: boolean
   publishedVersion?: PublishedVersionInfo | null
   onUnpublish?: () => Promise<void>
   onDelete?: () => Promise<void>
@@ -221,24 +223,29 @@ export function DocumentActions({
     onDelete != null
 
   const handleOnDelete = () => {
+    if (disabled) return
     setShowDeleteConfirm(false)
     if (onDelete) {
-      onDelete()
+      void onDelete().catch(() => {})
     }
   }
 
   const handleOnDuplicate = async () => {
+    if (disabled) return
     if (!onDuplicate) return
     setDuplicateBusy(true)
     try {
       await onDuplicate()
       setShowDuplicateConfirm(false)
+    } catch {
+      // The host reports the failure and retains the editor observation.
     } finally {
       setDuplicateBusy(false)
     }
   }
 
   const handleOpenDuplicate = () => {
+    if (disabled) return
     // Duplicate copies the saved version — block when the form is dirty so
     // unsaved edits are not silently dropped from the copy.
     if (hasUnsavedChanges) {
@@ -249,6 +256,7 @@ export function DocumentActions({
   }
 
   const handleOpenCopyToLocale = () => {
+    if (disabled) return
     // Copy-to-Locale reads the saved version — block when the form is dirty.
     if (hasUnsavedChanges) {
       onUnsavedChanges?.()
@@ -263,17 +271,21 @@ export function DocumentActions({
   }
 
   const handleOnCopyToLocale = async () => {
+    if (disabled) return
     if (!onCopyToLocale || !copyTargetLocale) return
     setCopyToLocaleBusy(true)
     try {
       await onCopyToLocale({ targetLocale: copyTargetLocale, overwrite: copyOverwrite })
       setShowCopyToLocaleConfirm(false)
+    } catch {
+      // The host reports the failure and retains the editor observation.
     } finally {
       setCopyToLocaleBusy(false)
     }
   }
 
   const handleOpenDeleteLocale = () => {
+    if (disabled) return
     // Delete-Locale removes the saved version's locale content — block when
     // the form is dirty so the editor saves (or discards) first.
     if (hasUnsavedChanges) {
@@ -288,11 +300,14 @@ export function DocumentActions({
   }
 
   const handleOnDeleteLocale = async () => {
+    if (disabled) return
     if (!onDeleteLocale || !deleteTargetLocale) return
     setDeleteLocaleBusy(true)
     try {
       await onDeleteLocale({ targetLocale: deleteTargetLocale })
       setShowDeleteLocaleConfirm(false)
+    } catch {
+      // The host reports the failure and retains the editor observation.
     } finally {
       setDeleteLocaleBusy(false)
     }
@@ -311,6 +326,7 @@ export function DocumentActions({
       {hasAnyAction && (
         <DropdownComponent.Root>
           <DropdownComponent.Trigger
+            disabled={disabled}
             render={<IconButton variant="text" intent="noeffect" size="sm" />}
           >
             <EllipsisIcon
@@ -329,7 +345,7 @@ export function DocumentActions({
             >
               {/*{publishedVersion && (
               <>
-                <DropdownComponent.Item onClick={onUnpublish}>
+                <DropdownComponent.Item disabled={disabled} onClick={onUnpublish}>
                   <div className={cx('byline-form-actions-item', styles.item)}>
                     <span className={cx('byline-form-actions-item-icon', styles['item-icon'])} />
                     <span className={cx('byline-form-actions-item-text', styles['item-text'])}>
@@ -343,10 +359,16 @@ export function DocumentActions({
               {schedulingActions.length > 0 && (
                 <>
                   {schedulingActions.map((action) => (
-                    <DropdownComponent.Item key={action.key} onClick={action.onSelect}>
+                    <DropdownComponent.Item
+                      disabled={disabled}
+                      key={action.key}
+                      onClick={action.onSelect}
+                    >
                       <div className={cx('byline-form-actions-item', styles.item)}>
                         <span className={cx('byline-form-actions-item-text', styles['item-text'])}>
-                          <button type="button">{action.label}</button>
+                          <button type="button" disabled={disabled}>
+                            {action.label}
+                          </button>
                         </span>
                       </div>
                     </DropdownComponent.Item>
@@ -355,28 +377,34 @@ export function DocumentActions({
                 </>
               )}
               {copyToLocaleAvailable && (
-                <DropdownComponent.Item onClick={handleOpenCopyToLocale}>
+                <DropdownComponent.Item disabled={disabled} onClick={handleOpenCopyToLocale}>
                   <div className={cx('byline-form-actions-item', styles.item)}>
                     <span className={cx('byline-form-actions-item-text', styles['item-text'])}>
-                      <button type="button">{t('documentActions.copyToLocaleMenuItem')}</button>
+                      <button type="button" disabled={disabled}>
+                        {t('documentActions.copyToLocaleMenuItem')}
+                      </button>
                     </span>
                   </div>
                 </DropdownComponent.Item>
               )}
               {deleteLocaleAvailable && (
-                <DropdownComponent.Item onClick={handleOpenDeleteLocale}>
+                <DropdownComponent.Item disabled={disabled} onClick={handleOpenDeleteLocale}>
                   <div className={cx('byline-form-actions-item', styles.item)}>
                     <span className={cx('byline-form-actions-item-text', styles['item-text'])}>
-                      <button type="button">{t('documentActions.deleteLocale.menuItem')}</button>
+                      <button type="button" disabled={disabled}>
+                        {t('documentActions.deleteLocale.menuItem')}
+                      </button>
                     </span>
                   </div>
                 </DropdownComponent.Item>
               )}
               {onDuplicate && (
-                <DropdownComponent.Item onClick={handleOpenDuplicate}>
+                <DropdownComponent.Item disabled={disabled} onClick={handleOpenDuplicate}>
                   <div className={cx('byline-form-actions-item', styles.item)}>
                     <span className={cx('byline-form-actions-item-text', styles['item-text'])}>
-                      <button type="button">{t('common.actions.duplicate')}</button>
+                      <button type="button" disabled={disabled}>
+                        {t('common.actions.duplicate')}
+                      </button>
                     </span>
                   </div>
                 </DropdownComponent.Item>
@@ -385,6 +413,7 @@ export function DocumentActions({
                 <>
                   <DropdownComponent.Separator />
                   <DropdownComponent.Item
+                    disabled={disabled}
                     onClick={() => {
                       setShowDeleteConfirm(true)
                     }}
@@ -454,7 +483,13 @@ export function DocumentActions({
             >
               {t('common.actions.cancel')}
             </Button>
-            <Button size="sm" style={{ minWidth: '80px' }} intent="danger" onClick={handleOnDelete}>
+            <Button
+              size="sm"
+              style={{ minWidth: '80px' }}
+              intent="danger"
+              disabled={disabled}
+              onClick={handleOnDelete}
+            >
               {t('common.actions.delete')}
             </Button>
           </Modal.Actions>
@@ -533,7 +568,7 @@ export function DocumentActions({
               onClick={() => {
                 if (!duplicateBusy) setShowDuplicateConfirm(false)
               }}
-              disabled={duplicateBusy}
+              disabled={disabled || duplicateBusy}
             >
               {t('common.actions.cancel')}
             </Button>
@@ -542,7 +577,7 @@ export function DocumentActions({
               style={{ minWidth: '80px' }}
               intent="primary"
               onClick={handleOnDuplicate}
-              disabled={duplicateBusy}
+              disabled={disabled || duplicateBusy}
             >
               {duplicateBusy
                 ? t('documentActions.duplicate.busyButton')
@@ -611,7 +646,7 @@ export function DocumentActions({
                 onValueChange={(value) => {
                   if (value != null) setCopyTargetLocale(value)
                 }}
-                disabled={copyToLocaleBusy}
+                disabled={disabled || copyToLocaleBusy}
               />
             </div>
             <div
@@ -623,7 +658,7 @@ export function DocumentActions({
                 name="overwrite"
                 label={t('documentActions.copyToLocale.overwriteLabel')}
                 checked={copyOverwrite}
-                disabled={copyToLocaleBusy}
+                disabled={disabled || copyToLocaleBusy}
                 helpText={t('documentActions.copyToLocale.overwriteHelp')}
                 onCheckedChange={(value) => {
                   setCopyOverwrite(value === true)
@@ -647,7 +682,7 @@ export function DocumentActions({
               onClick={() => {
                 if (!copyToLocaleBusy) setShowCopyToLocaleConfirm(false)
               }}
-              disabled={copyToLocaleBusy}
+              disabled={disabled || copyToLocaleBusy}
             >
               {t('common.actions.cancel')}
             </Button>
@@ -656,7 +691,7 @@ export function DocumentActions({
               style={{ minWidth: '80px' }}
               intent="primary"
               onClick={handleOnCopyToLocale}
-              disabled={copyToLocaleBusy || !copyTargetLocale}
+              disabled={disabled || copyToLocaleBusy || !copyTargetLocale}
             >
               {copyToLocaleBusy
                 ? t('documentActions.copyToLocale.busyButton')
@@ -711,7 +746,7 @@ export function DocumentActions({
                 onValueChange={(value) => {
                   if (value != null) setDeleteTargetLocale(value)
                 }}
-                disabled={deleteLocaleBusy}
+                disabled={disabled || deleteLocaleBusy}
               />
             </div>
             <p style={{ marginTop: 'var(--spacing-12)' }}>
@@ -734,7 +769,7 @@ export function DocumentActions({
               onClick={() => {
                 if (!deleteLocaleBusy) setShowDeleteLocaleConfirm(false)
               }}
-              disabled={deleteLocaleBusy}
+              disabled={disabled || deleteLocaleBusy}
             >
               {t('common.actions.cancel')}
             </Button>
@@ -743,7 +778,7 @@ export function DocumentActions({
               style={{ minWidth: '80px' }}
               intent="danger"
               onClick={handleOnDeleteLocale}
-              disabled={deleteLocaleBusy || !deleteTargetLocale}
+              disabled={disabled || deleteLocaleBusy || !deleteTargetLocale}
             >
               {deleteLocaleBusy
                 ? t('documentActions.deleteLocale.busyButton')