@byline/admin 4.18.0 → 5.0.0

package/dist/forms/form-renderer_module.css

@@ -141,6 +141,40 @@
   min-height: 28px;
 }
 
+:is(.busy-status-kzSMVH, .byline-form-busy-status) {
+  clip: rect(0 0 0 0);
+  clip-path: inset(50%);
+  white-space: nowrap;
+  border: 0;
+  width: 1px;
+  height: 1px;
+  margin: -1px;
+  padding: 0;
+  position: absolute;
+  overflow: hidden;
+}
+
+:is(.save-content-bc8XeC, .byline-form-save-content) {
+  display: inline-block;
+  position: relative;
+}
+
+:is(.save-label-iJw9DA, .byline-form-save-label) {
+  display: inline-block;
+}
+
+.save-label-hidden-Wct46I {
+  visibility: hidden;
+}
+
+:is(.save-loader-g2wcnV, .byline-form-save-loader) {
+  display: inline-flex;
+  position: absolute;
+  top: 50%;
+  left: 50%;
+  transform: translate(-50%, -50%);
+}
+
 :is(.actions-status-wrap-hSvlps, .byline-form-actions-status-wrap) {
   z-index: 10;
   position: relative;
@@ -155,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);

package/dist/forms/form-status-display.d.ts

@@ -13,7 +13,8 @@ import type { PublishedVersionInfo } from './form-renderer';
  * created timestamps, and a "published live" indicator with an inline
  * Unpublish action when a previously-published version is still live.
  */
-export declare const FormStatusDisplay: ({ initialData, workflowStatuses, publishedVersion, onUnpublish, afterStatusCells, }: {
+export declare const FormStatusDisplay: ({ disabled, initialData, workflowStatuses, publishedVersion, onUnpublish, afterStatusCells, }: {
+    disabled?: boolean;
     initialData?: Record<string, any>;
     workflowStatuses?: WorkflowStatus[];
     publishedVersion?: PublishedVersionInfo | null;

package/dist/forms/form-status-display.js

@@ -4,7 +4,7 @@ import { useTranslation } from "@byline/i18n/react";
 import clsx from "clsx";
 import { LocalDateTime } from "../fields/local-date-time.js";
 import form_renderer_module from "./form-renderer.module.js";
-const FormStatusDisplay = ({ initialData, workflowStatuses, publishedVersion, onUnpublish, afterStatusCells })=>{
+const FormStatusDisplay = ({ disabled = false, initialData, workflowStatuses, publishedVersion, onUnpublish, afterStatusCells })=>{
     const { t } = useTranslation('byline-admin');
     const statusCode = initialData?.status;
     const statusLabel = workflowStatuses?.find((s)=>s.name === statusCode)?.label ?? statusCode;
@@ -82,7 +82,10 @@ const FormStatusDisplay = ({ initialData, workflowStatuses, publishedVersion, on
                             ' ',
                             /*#__PURE__*/ jsx("button", {
                                 type: "button",
-                                onClick: onUnpublish,
+                                disabled: disabled,
+                                onClick: ()=>{
+                                    if (!disabled) onUnpublish().catch(()=>{});
+                                },
                                 className: clsx('byline-form-status-unpublish', form_renderer_module["status-unpublish"]),
                                 children: t('common.actions.unpublish')
                             })

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.18.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.18.0",
-    "@byline/core": "4.18.0",
-    "@byline/analytics-agent": "4.18.0",
-    "@byline/auth": "4.18.0",
-    "@byline/ui": "4.18.0",
-    "@byline/i18n": "4.18.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)}
             />
           )