@byline/admin 4.18.0 → 5.0.0

package/src/forms/form-status-display.tsx

@@ -23,12 +23,14 @@ import type { PublishedVersionInfo } from './form-renderer'
  * Unpublish action when a previously-published version is still live.
  */
 export const FormStatusDisplay = ({
+  disabled = false,
   initialData,
   workflowStatuses,
   publishedVersion,
   onUnpublish,
   afterStatusCells,
 }: {
+  disabled?: boolean
   initialData?: Record<string, any>
   workflowStatuses?: WorkflowStatus[]
   publishedVersion?: PublishedVersionInfo | null
@@ -106,7 +108,10 @@ export const FormStatusDisplay = ({
               {' '}
               <button
                 type="button"
-                onClick={onUnpublish}
+                disabled={disabled}
+                onClick={() => {
+                  if (!disabled) void onUnpublish().catch(() => {})
+                }}
                 className={cx('byline-form-status-unpublish', styles['status-unpublish'])}
               >
                 {t('common.actions.unpublish')}

package/src/forms/path-widget.tsx

@@ -31,6 +31,7 @@ function coerceToString(value: unknown): string {
 }
 
 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. */
@@ -91,6 +92,7 @@ export const PathWidget = ({
   mode,
   slugifier,
   sourceLocked = false,
+  disabled = false,
 }: PathWidgetProps) => {
   const { setSystemPath } = useFormContext()
   const { t } = useTranslation('byline-admin')
@@ -125,18 +127,19 @@ export const PathWidget = ({
 
   const handleChange = useCallback(
     (next: string) => {
+      if (disabled) return
       // Empty string clears the override — server falls back to derive
       // (create) or sticky (update).
       setSystemPath(next.length === 0 ? null : next)
     },
-    [setSystemPath]
+    [disabled, setSystemPath]
   )
 
   const handleRegenerate = useCallback(() => {
-    if (livePreview.length > 0) {
+    if (!disabled && livePreview.length > 0) {
       setSystemPath(livePreview)
     }
-  }, [livePreview, setSystemPath])
+  }, [disabled, livePreview, setSystemPath])
 
   // Validate live: if the typed value differs from its slugified form,
   // surface an inline hint without blocking input (mirrors the previous
@@ -184,6 +187,7 @@ export const PathWidget = ({
             type="button"
             onClick={handleRegenerate}
             className={cx('byline-form-path-regenerate', styles.regenerate)}
+            disabled={disabled}
             aria-label={t('pathWidget.regenerateAriaLabel', { field: useAsPath })}
           >
             {t('pathWidget.regenerateButton', { field: useAsPath })}
@@ -191,6 +195,7 @@ export const PathWidget = ({
         )}
       </div>
       <Input
+        disabled={disabled}
         id="system-path"
         name="__systemPath__"
         value={inputValue}

package/src/forms/scheduled-publication-control.tsx

@@ -110,6 +110,7 @@ function seedScheduleInstant(schedule: ScheduledPublicationInfo | null): Date {
 }
 
 export interface UseScheduledPublicationArgs {
+  disabled?: boolean
   schedule: ScheduledPublicationInfo | null
   onSchedule?: (input: SchedulePublicationInput) => Promise<void>
   onConfirm?: () => Promise<void>
@@ -132,6 +133,7 @@ export interface UseScheduledPublicationReturn {
 }
 
 export function useScheduledPublication({
+  disabled = false,
   schedule,
   onSchedule,
   onConfirm,
@@ -171,15 +173,16 @@ export function useScheduledPublication({
   // to be resolved before any of these operations can name a version. Cancel
   // is exempt: withdrawing a schedule says nothing about content.
   const openSchedule = useCallback(() => {
+    if (disabled) return
     if (hasUnsavedChanges) {
       onUnsavedChanges()
       return
     }
     setShowSchedule(true)
-  }, [hasUnsavedChanges, onUnsavedChanges])
+  }, [disabled, hasUnsavedChanges, onUnsavedChanges])
 
   const confirm = useCallback(async () => {
-    if (onConfirm == null) return
+    if (disabled || onConfirm == null) return
     if (hasUnsavedChanges) {
       onUnsavedChanges()
       return
@@ -187,37 +190,43 @@ export function useScheduledPublication({
     setBusy(true)
     try {
       await onConfirm()
+    } catch {
+      // The host reports the failure; keep this view open.
     } finally {
       setBusy(false)
     }
-  }, [onConfirm, hasUnsavedChanges, onUnsavedChanges])
+  }, [disabled, onConfirm, hasUnsavedChanges, onUnsavedChanges])
 
   const cancel = useCallback(async () => {
-    if (onCancel == null) return
+    if (disabled || onCancel == null) return
     setBusy(true)
     try {
       await onCancel()
+    } catch {
+      // The host reports the failure; keep this view open.
     } finally {
       setBusy(false)
     }
-  }, [onCancel])
+  }, [disabled, onCancel])
 
   const modal = showSchedule ? (
     <ScheduleModal
       schedule={schedule}
       timeZone={timeZone}
       onSubmit={async (input) => {
-        if (onSchedule == null) return
+        if (disabled || onSchedule == null) return
         setBusy(true)
         try {
           await onSchedule(input)
           setShowSchedule(false)
+        } catch {
+          // The host reports the failure; keep this view open.
         } finally {
           setBusy(false)
         }
       }}
       onDismiss={() => setShowSchedule(false)}
-      busy={busy}
+      busy={disabled || busy}
     />
   ) : null
 

package/src/forms/tree-placement-widget.tsx

@@ -20,6 +20,10 @@ import { RelationPicker } from '../fields/relation/relation-picker.js'
 import styles from './tree-placement-widget.module.css'
 
 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. */
@@ -44,6 +48,10 @@ export interface TreePlacementWidgetProps {
  */
 export const TreePlacementWidget = ({
   collectionPath,
+  disabled = false,
+  onMutationError,
+  onCommitted,
+  expectedRevision,
   documentId,
   useAsTitle,
 }: TreePlacementWidgetProps) => {
@@ -99,7 +107,7 @@ export const TreePlacementWidget = ({
   // placement (including making the node a root) leaves it placed.
   const place = useCallback(
     async (parentDocumentId: string | null, optimistic: { id: string; title: string } | null) => {
-      if (placeTreeNode == null || busy) return
+      if (disabled || placeTreeNode == null || busy) return
       const previousParent = parent
       const previousPlaced = placed
       setError(null)
@@ -107,8 +115,15 @@ export const TreePlacementWidget = ({
       setParent(optimistic)
       setPlaced(true)
       try {
-        await placeTreeNode({ collection: collectionPath, documentId, parentDocumentId })
-      } catch {
+        const result = await placeTreeNode({
+          expectedRevision,
+          collection: collectionPath,
+          documentId,
+          parentDocumentId,
+        })
+        onCommitted?.(result)
+      } catch (error) {
+        if (onMutationError?.(error) === 'committed') return
         setParent(previousParent)
         setPlaced(previousPlaced)
         setError(t('treeWidget.error'))
@@ -116,7 +131,19 @@ export const TreePlacementWidget = ({
         setBusy(false)
       }
     },
-    [placeTreeNode, busy, parent, placed, collectionPath, documentId, t]
+    [
+      disabled,
+      onMutationError,
+      onCommitted,
+      expectedRevision,
+      placeTreeNode,
+      busy,
+      parent,
+      placed,
+      collectionPath,
+      documentId,
+      t,
+    ]
   )
 
   const handlePick = useCallback(
@@ -156,7 +183,7 @@ export const TreePlacementWidget = ({
           size="xs"
           variant="outlined"
           intent="noeffect"
-          disabled={loading || busy}
+          disabled={disabled || loading || busy}
           onClick={() => setPickerOpen(true)}
         >
           {t('treeWidget.choose')}
@@ -165,7 +192,7 @@ export const TreePlacementWidget = ({
           <button
             type="button"
             className={cx('byline-form-tree-link', styles.link)}
-            disabled={loading || busy}
+            disabled={disabled || loading || busy}
             onClick={() => place(null, null)}
           >
             {t('treeWidget.addToTree')}
@@ -175,7 +202,7 @@ export const TreePlacementWidget = ({
             <button
               type="button"
               className={cx('byline-form-tree-link', styles.link)}
-              disabled={busy}
+              disabled={disabled || busy}
               onClick={() => place(null, null)}
             >
               {t('treeWidget.makeRoot')}