canopycms 0.1.0-int.115 → 0.1.0

package/dist/editor/components/EditorRail.d.ts

@@ -0,0 +1,49 @@
+import { type ReactElement, type Ref } from 'react';
+import type { PaneArrangement } from '../shell/PaneLayout.js';
+export interface EditorRailProps {
+    siteTitle: string;
+    /** Opens the site's first entry, which is also what the editor opens with no entry asked for. */
+    onHomeOpen: () => void;
+    contentPanelOpen: boolean;
+    /** The content panel's element id, for `aria-controls`. */
+    contentPanelId: string;
+    onContentToggle: () => void;
+    onQuickOpen: () => void;
+    /** The quick open shortcut as the platform writes it, such as "⌘P". */
+    quickOpenShortcut: string;
+    /** The same shortcut for `aria-keyshortcuts`, such as "Meta+P". */
+    quickOpenKeys: string;
+    branchesOpen: boolean;
+    onBranchesOpen: () => void;
+    /** Without it, the Comments button is not offered (no branch, or a mode without comments). */
+    onCommentsOpen?: () => void;
+    commentsOpen: boolean;
+    unresolvedCommentCount: number;
+    mediaLibraryOpen: boolean;
+    onMediaLibraryOpen: () => void;
+    mediaButtonRef?: Ref<HTMLButtonElement>;
+    layout: PaneArrangement;
+    onLayoutChange: (layout: PaneArrangement) => void;
+    /** The preview is maximized, so the layout has nothing to arrange. */
+    layoutBlocked?: boolean;
+    /** Admin-only, like the other two below: each Settings item renders only when given. */
+    onPermissionManagerOpen?: () => void;
+    onGroupManagerOpen?: () => void;
+    onSystemHealthOpen?: () => void;
+    /** Takes focus back when a panel opened from the Settings menu closes. */
+    settingsToggleRef?: Ref<HTMLButtonElement>;
+    /** The adopter's account control, such as Clerk's UserButton; replaces the default buttons. */
+    AccountComponent?: React.ComponentType;
+    onAccountClick?: () => void;
+    onLogoutClick?: () => void;
+}
+/**
+ * @internal Exported for tests. The Settings button and its menu of `items`; with none, no
+ * button, since a menu that opens empty offers nothing.
+ */
+export declare function SettingsMenu({ items, toggleRef, }: {
+    items: readonly ReactElement[];
+    toggleRef?: Ref<HTMLButtonElement>;
+}): import("react/jsx-runtime").JSX.Element | null;
+/** The editor's activity rail: what `ActivityRail` lays out, wired to the editor's surfaces. */
+export declare function EditorRail({ siteTitle, onHomeOpen, contentPanelOpen, contentPanelId, onContentToggle, onQuickOpen, quickOpenShortcut, quickOpenKeys, branchesOpen, onBranchesOpen, onCommentsOpen, commentsOpen, unresolvedCommentCount, mediaLibraryOpen, onMediaLibraryOpen, mediaButtonRef, layout, onLayoutChange, layoutBlocked, onPermissionManagerOpen, onGroupManagerOpen, onSystemHealthOpen, settingsToggleRef, AccountComponent, onAccountClick, onLogoutClick, }: EditorRailProps): import("react/jsx-runtime").JSX.Element;

package/dist/editor/components/EditorRail.js

@@ -0,0 +1,65 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useRef, useState } from 'react';
+import { ActionIcon, Menu, Stack, Text, Tooltip, VisuallyHidden } from '@mantine/core';
+import { useMergedRef } from '@mantine/hooks';
+import { IconActivity, IconExternalLink, IconFiles, IconGitBranch, IconInfoCircle, IconLayoutColumns, IconLayoutRows, IconLogout, IconMessageCircle, IconPhoto, IconSearch, IconSettings, IconUserCircle, } from '@tabler/icons-react';
+import { ActivityRail, RailButton } from '../shell/ActivityRail.js';
+import { useMenuItemFocusReturn } from '../utils/focus-return.js';
+import { CANOPYCMS_VERSION } from '../../version.js';
+import { EDITOR_ACTIONS } from '../copy.js';
+const ABOUT_URL = 'https://github.com/safeinsights/canopycms';
+/**
+ * @internal Exported for tests. The Settings button and its menu of `items`; with none, no
+ * button, since a menu that opens empty offers nothing.
+ */
+export function SettingsMenu({ items, toggleRef, }) {
+    const [opened, setOpened] = useState(false);
+    const toggle = useRef(null);
+    const mergedRef = useMergedRef(toggle, toggleRef);
+    const menuFocus = useMenuItemFocusReturn(toggle);
+    if (items.length === 0)
+        return null;
+    return (_jsxs(Menu, { shadow: "md", width: 220, position: "right-end", opened: opened, onChange: setOpened, ...menuFocus.menu, children: [_jsx(Menu.Target, { children: _jsx(RailButton, { railId: "settings", label: "Settings", icon: _jsx(IconSettings, { size: 20 }), tooltipDisabled: opened, ref: mergedRef, "data-testid": "settings-button" }) }), _jsx(Menu.Dropdown, { "data-testid": "settings-menu", ...menuFocus.dropdown, children: items })] }));
+}
+const LAYOUTS = {
+    side: {
+        name: 'side by side',
+        title: 'Side by side layout',
+        other: 'stacked',
+        Icon: IconLayoutColumns,
+    },
+    stacked: { name: 'stacked', title: 'Stacked layout', other: 'side', Icon: IconLayoutRows },
+};
+/** One button that shows the current layout and switches to the other. */
+function LayoutButton({ layout, onChange, blocked = false, }) {
+    const [switchedTo, setSwitchedTo] = useState('');
+    const { name, other, Icon } = LAYOUTS[layout];
+    return (_jsxs(_Fragment, { children: [_jsx(RailButton, { railId: "layout", label: `Switch to ${LAYOUTS[other].name} layout (now ${name})`, icon: _jsx(Icon, { size: 20 }), disabledReason: blocked ? 'Restore the preview to change the layout.' : undefined, "data-testid": "rail-layout-button", "data-layout": layout, onClick: () => {
+                    onChange(other);
+                    setSwitchedTo(LAYOUTS[other].title);
+                } }), _jsx(VisuallyHidden, { role: "status", "data-testid": "rail-layout-status", children: switchedTo })] }));
+}
+const monogram = (title) => Array.from(title.trim())[0]?.toUpperCase() ?? '?';
+/** The editor's activity rail: what `ActivityRail` lays out, wired to the editor's surfaces. */
+export function EditorRail({ siteTitle, onHomeOpen, contentPanelOpen, contentPanelId, onContentToggle, onQuickOpen, quickOpenShortcut, quickOpenKeys, branchesOpen, onBranchesOpen, onCommentsOpen, commentsOpen, unresolvedCommentCount, mediaLibraryOpen, onMediaLibraryOpen, mediaButtonRef, layout, onLayoutChange, layoutBlocked, onPermissionManagerOpen, onGroupManagerOpen, onSystemHealthOpen, settingsToggleRef, AccountComponent, onAccountClick, onLogoutClick, }) {
+    const adminItems = [
+        onPermissionManagerOpen && (_jsx(Menu.Item, { "data-testid": "settings-menu-permissions", onClick: onPermissionManagerOpen, children: "Manage permissions" }, "permissions")),
+        onGroupManagerOpen && (_jsx(Menu.Item, { "data-testid": "settings-menu-groups", onClick: onGroupManagerOpen, children: "Manage groups" }, "groups")),
+        onSystemHealthOpen && (_jsx(Menu.Item, { "data-testid": "settings-menu-system-health", leftSection: _jsx(IconActivity, { size: 14 }), onClick: onSystemHealthOpen, children: "System health" }, "system-health")),
+    ].filter((item) => !!item);
+    // Every user gets the version, which bug reports need, so the menu is never empty today.
+    const settingsItems = [
+        ...(adminItems.length > 0
+            ? [
+                _jsx(Menu.Label, { children: "Settings" }, "admin"),
+                ...adminItems,
+                _jsx(Menu.Divider, {}, "divider"),
+            ]
+            : []),
+        _jsx(Menu.Label, { "data-testid": "settings-menu-version", children: `CanopyCMS ${CANOPYCMS_VERSION}` }, "version"),
+        _jsxs(Menu.Item, { component: "a", href: ABOUT_URL, target: "_blank", rel: "noopener noreferrer", "data-testid": "settings-menu-about", leftSection: _jsx(IconInfoCircle, { size: 14 }), rightSection: _jsx(IconExternalLink, { size: 14, "aria-hidden": true }), children: ["About CanopyCMS", _jsx(VisuallyHidden, { component: "span", children: " (opens in a new tab)" })] }, "about"),
+    ];
+    const commentsLabel = unresolvedCommentCount > 0 ? `Comments, ${unresolvedCommentCount} unresolved` : 'Comments';
+    return (_jsx(ActivityRail, { top: _jsxs(_Fragment, { children: [_jsx(RailButton, { railId: "home", label: `Open the first entry of ${siteTitle}`, icon: _jsx(Text, { component: "span", fw: 700, size: "md", "aria-hidden": true, children: monogram(siteTitle) }), tinted: true, "data-testid": "rail-home-button", onClick: onHomeOpen }), _jsx(RailButton, { railId: "content", label: "Content", icon: _jsx(IconFiles, { size: 20 }), active: contentPanelOpen, "aria-expanded": contentPanelOpen, "aria-controls": contentPanelOpen ? contentPanelId : undefined, "data-testid": "content-panel-toggle", onClick: onContentToggle }), _jsx(RailButton, { railId: "search", label: EDITOR_ACTIONS.openEntry, shortcut: quickOpenShortcut, "aria-keyshortcuts": quickOpenKeys, icon: _jsx(IconSearch, { size: 20 }), "aria-haspopup": "dialog", "data-testid": "rail-search-button", onClick: onQuickOpen }), _jsx(RailButton, { railId: "branches", label: "Branches", icon: _jsx(IconGitBranch, { size: 20 }), active: branchesOpen, "aria-haspopup": "dialog", "data-testid": "rail-branches-button", onClick: onBranchesOpen }), onCommentsOpen && (_jsx(RailButton, { railId: "comments", label: commentsLabel, icon: _jsx(IconMessageCircle, { size: 20 }), active: commentsOpen, count: unresolvedCommentCount, countTestId: "comments-unresolved-count", "aria-haspopup": "dialog", "data-testid": "comments-button", onClick: onCommentsOpen })), _jsx(RailButton, { railId: "media", label: "Media library", icon: _jsx(IconPhoto, { size: 20 }), active: mediaLibraryOpen, "aria-haspopup": "dialog", "data-testid": "media-library-button", ref: mediaButtonRef, onClick: onMediaLibraryOpen })] }), bottom: _jsxs(_Fragment, { children: [_jsx(LayoutButton, { layout: layout, onChange: onLayoutChange, blocked: layoutBlocked }), _jsx(SettingsMenu, { items: settingsItems, toggleRef: settingsToggleRef })] }), account: AccountComponent ? (_jsx(AccountComponent, {})) : onAccountClick || onLogoutClick ? (_jsxs(Stack, { gap: 6, align: "center", children: [onAccountClick && (_jsx(Tooltip, { label: "Account", position: "right", children: _jsx(ActionIcon, { variant: "subtle", color: "gray", size: "lg", radius: "md", "aria-label": "Account", onClick: onAccountClick, children: _jsx(IconUserCircle, { size: 20 }) }) })), onLogoutClick && (_jsx(Tooltip, { label: "Sign out", position: "right", children: _jsx(ActionIcon, { variant: "subtle", color: "gray", size: "lg", radius: "md", "aria-label": "Sign out", onClick: onLogoutClick, children: _jsx(IconLogout, { size: 20 }) }) }))] })) : undefined }));
+}

package/dist/editor/components/EntryBreadcrumb.d.ts

@@ -0,0 +1,33 @@
+import { type Ref } from 'react';
+import type { BreadcrumbSegment } from '../editor-utils.js';
+export interface EntryBreadcrumbProps {
+    /** The crumbs before the entry's own, from `buildBreadcrumbSegments`. */
+    segments: BreadcrumbSegment[];
+    /** The open entry's label; undefined when no entry is open. */
+    entryLabel: string | undefined;
+    /** The open entry has unsaved changes. */
+    entryDirty: boolean;
+    /** Why the open entry or its branch is read-only; set, the "Read-only" chip shows. */
+    readOnlyReason?: string;
+    onAllContent: () => void;
+    onCollection: (collectionPath: string) => void;
+    onRefresh: () => void;
+    onDiscard: () => void;
+    /** With `onDelete`, offers "Rename…" and "Delete entry"; absent where a path rule refuses them. */
+    onRename?: () => void;
+    onDelete?: () => void;
+    refreshBlockedReason?: string;
+    discardBlockedReason?: string;
+    /** Why the entry can't be renamed or deleted now. */
+    changeBlockedReason?: string;
+    /** The entry menu's trigger, which stands in for a menu item that opened something. */
+    entryMenuRef?: Ref<HTMLButtonElement>;
+    /** The "All content" crumb, where focus goes once the open entry is gone. */
+    allContentRef?: Ref<HTMLButtonElement>;
+}
+/**
+ * Where the open entry sits: "All content" opens the content panel, a collection crumb reveals
+ * that collection in it, and the entry's own crumb is current and opens the entry menu. Crumbs
+ * shrink and truncate before the entry's own does.
+ */
+export declare function EntryBreadcrumb({ segments, entryLabel, entryDirty, readOnlyReason, onAllContent, onCollection, onRefresh, onDiscard, onRename, onDelete, refreshBlockedReason, discardBlockedReason, changeBlockedReason, entryMenuRef, allContentRef, }: EntryBreadcrumbProps): import("react/jsx-runtime").JSX.Element;

package/dist/editor/components/EntryBreadcrumb.js

@@ -0,0 +1,56 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useEffect, useRef, useState } from 'react';
+import { Badge, Box, Button, Group, Menu, Text, Tooltip, VisuallyHidden } from '@mantine/core';
+import { useMergedRef } from '@mantine/hooks';
+import { IconChevronDown, IconChevronRight, IconLock } from '@tabler/icons-react';
+import { EDITOR_ACTIONS } from '../copy.js';
+import { DestructiveMenuItem } from './DestructiveMenuItem.js';
+import { ReasonedMenuItem } from './ReasonedMenuItem.js';
+import { useMenuItemFocusReturn } from '../utils/focus-return.js';
+/** Whether the element's text is cut short, kept current as it resizes. */
+function useTruncated(label) {
+    const ref = useRef(null);
+    const [truncated, setTruncated] = useState(false);
+    useEffect(() => {
+        const el = ref.current;
+        if (!el)
+            return;
+        const check = () => setTruncated(el.scrollWidth > el.clientWidth);
+        check();
+        const observer = new ResizeObserver(check);
+        observer.observe(el);
+        return () => observer.disconnect();
+    }, [label]);
+    return [ref, truncated];
+}
+const crumbText = (label, ref) => (_jsx(Text, { ref: ref, span: true, inherit: true, truncate: "end", display: "block", children: label }));
+/** A cut-short crumb shows its full label in a Tooltip, on hover and on focus. */
+function CrumbTooltip({ label, truncated, children, }) {
+    return (_jsx(Tooltip, { label: label, disabled: !truncated, events: { hover: true, focus: true, touch: false }, children: children }));
+}
+function CollectionCrumb({ label, onClick, buttonRef, }) {
+    const [ref, truncated] = useTruncated(label);
+    return (_jsx(CrumbTooltip, { label: label, truncated: truncated, children: _jsx(Button, { ref: buttonRef, variant: "subtle", color: "gray", size: "compact-sm", fw: 400, miw: 0, maw: 180, onClick: onClick, "data-testid": "breadcrumb-segment", styles: { label: { minWidth: 0 } }, children: crumbText(label, ref) }) }));
+}
+const separator = (_jsx(IconChevronRight, { size: 14, "aria-hidden": "true", style: { flexShrink: 0, color: 'var(--mantine-color-dimmed)' } }));
+/**
+ * Where the open entry sits: "All content" opens the content panel, a collection crumb reveals
+ * that collection in it, and the entry's own crumb is current and opens the entry menu. Crumbs
+ * shrink and truncate before the entry's own does.
+ */
+export function EntryBreadcrumb({ segments, entryLabel, entryDirty, readOnlyReason, onAllContent, onCollection, onRefresh, onDiscard, onRename, onDelete, refreshBlockedReason, discardBlockedReason, changeBlockedReason, entryMenuRef, allContentRef, }) {
+    const trigger = useRef(null);
+    const triggerRef = useMergedRef(trigger, entryMenuRef);
+    const menuFocus = useMenuItemFocusReturn(trigger);
+    const [entryLabelRef, entryTruncated] = useTruncated(entryLabel ?? '');
+    return (_jsxs(Group, { gap: "xs", wrap: "nowrap", miw: 0, children: [_jsx(Box, { component: "nav", "aria-label": "Breadcrumb", miw: 0, 
+                // Clips crumbs that overflow, padded by the focus ring's reach so the ring is not clipped.
+                style: { flex: '0 1 auto', overflow: 'hidden', padding: 4, margin: -4 }, children: _jsxs(Group, { component: "ol", gap: 2, wrap: "nowrap", miw: 0, style: { listStyle: 'none', margin: 0, padding: 0 }, children: [segments.map((segment, index) => (_jsxs(Group, { component: "li", gap: 2, wrap: "nowrap", miw: 0, 
+                            // Collections give up their width long before the entry's own crumb does.
+                            style: { flex: '0 100 auto' }, children: [index > 0 && separator, segment.folder ? (_jsx(Text, { size: "sm", c: "dimmed", px: 4, miw: 0, truncate: "end", children: segment.label })) : (_jsx(CollectionCrumb, { label: segment.label, buttonRef: index === 0 ? allContentRef : undefined, onClick: () => segment.collectionPath ? onCollection(segment.collectionPath) : onAllContent() }))] }, `${segment.label}-${index}`))), _jsxs(Group, { component: "li", gap: 2, wrap: "nowrap", miw: 64, style: { flex: '0 1 auto' }, children: [separator, entryLabel === undefined ? (_jsx(Text, { size: "sm", c: "dimmed", px: 4, "data-testid": "file-dropdown-button", children: "No entry open" })) : (_jsxs(Menu, { withinPortal: true, shadow: "sm", position: "bottom-start", ...menuFocus.menu, children: [_jsx(CrumbTooltip, { label: entryLabel, truncated: entryTruncated, children: _jsx(Menu.Target, { children: _jsxs(Button, { ref: triggerRef, variant: "subtle", color: "gray", size: "compact-sm", fw: 600, miw: 0, maw: "100%", "aria-current": "page", rightSection: _jsx(IconChevronDown, { size: 14, "aria-hidden": "true" }), "data-testid": "file-dropdown-button", styles: { label: { minWidth: 0, gap: 6 } }, children: [crumbText(entryLabel, entryLabelRef), entryDirty && (_jsxs(_Fragment, { children: [_jsx(Box, { component: "span", "aria-hidden": "true", w: 8, h: 8, style: {
+                                                                        borderRadius: '50%',
+                                                                        flexShrink: 0,
+                                                                        background: 'var(--mantine-color-text)',
+                                                                    }, "data-testid": "entry-unsaved-dot" }), _jsx(VisuallyHidden, { component: "span", children: ", unsaved changes" })] }))] }) }) }), _jsxs(Menu.Dropdown, { ...menuFocus.dropdown, children: [_jsx(ReasonedMenuItem, { onClick: onRefresh, blockedReason: refreshBlockedReason, "data-testid": "refresh-entry-menu-item", children: EDITOR_ACTIONS.refreshFromServer }), _jsx(ReasonedMenuItem, { "data-testid": "discard-file-draft-menu-item", onClick: onDiscard, blockedReason: discardBlockedReason, children: "Discard changes" }), onRename && onDelete && (_jsxs(_Fragment, { children: [_jsx(Menu.Divider, {}), _jsx(ReasonedMenuItem, { onClick: onRename, blockedReason: changeBlockedReason, "data-testid": "entry-menu-rename", children: "Rename\u2026" }), _jsx(DestructiveMenuItem, { onClick: onDelete, blockedReason: changeBlockedReason, "data-testid": "entry-menu-delete", children: "Delete entry" })] }))] })] }))] })] }) }), readOnlyReason && (_jsx(Tooltip, { label: readOnlyReason, multiline: true, maw: 300, children: _jsxs(Badge, { variant: "light", color: "gray", radius: "sm", leftSection: _jsx(IconLock, { size: 12, "aria-hidden": "true" }), style: { flexShrink: 0, textTransform: 'none' }, "data-testid": "read-only-chip", children: ["Read-only", _jsxs(VisuallyHidden, { component: "span", children: [". ", readOnlyReason] })] }) }))] }));
+}

package/dist/editor/components/QuickOpenPalette.d.ts

@@ -1,4 +1,4 @@
-/** Marks an overlay Mod+P may open over: the navigator drawer, and the palette's own closing dialog. */
+/** @internal Exported for tests. Marks an overlay Mod+P may open over: the palette's own closing dialog. */
 export declare const QUICK_OPEN_REPLACES_ATTR = "data-quick-open-replaces";
 /** @internal Exported for tests and stories. */
 export interface QuickOpenEntry {

package/dist/editor/components/QuickOpenPalette.js

@@ -7,8 +7,9 @@ import { useHotkeys } from '@mantine/hooks';
 import { IconSearch } from '@tabler/icons-react';
 import { filterEntries, groupEntriesByCollection } from '../entry-search.js';
 import { modKeyLabel } from '../platform.js';
+import { EDITOR_ACTIONS } from '../copy.js';
 import { FOCUS_RETURN_ATTR, focusIfIdle } from '../utils/focus-return.js';
-/** Marks an overlay Mod+P may open over: the navigator drawer, and the palette's own closing dialog. */
+/** @internal Exported for tests. Marks an overlay Mod+P may open over: the palette's own closing dialog. */
 export const QUICK_OPEN_REPLACES_ATTR = 'data-quick-open-replaces';
 /**
  * True while a modal or drawer (not a popover) is open that `QUICK_OPEN_REPLACES_ATTR` doesn't mark.
@@ -61,5 +62,5 @@ export function QuickOpenPalette({ opened, onOpen, onClose, entries, collectionL
         onSelect(path);
         onClose();
     };
-    return (_jsx(Modal, { opened: opened, onClose: onClose, title: "Open entry", size: "lg", yOffset: "10vh", returnFocus: !returnFocusTo, onExitTransitionEnd: () => returnFocusTo && focusIfIdle(returnFocusTo()), [QUICK_OPEN_REPLACES_ATTR]: true, [FOCUS_RETURN_ATTR]: true, children: _jsxs(Combobox, { store: combobox, onOptionSubmit: handleSubmit, children: [_jsx(Combobox.EventsTarget, { withExpandedAttribute: true, "data-mantine-stop-propagation": false, children: _jsx(TextInput, { role: "combobox", "aria-label": "Search entries", "aria-autocomplete": "list", placeholder: "Type an entry title or slug", leftSection: _jsx(IconSearch, { size: 14, "aria-hidden": true }), value: query, onChange: (event) => setQuery(event.currentTarget.value), "data-autofocus": true, "data-testid": "quick-open-input" }) }), _jsx(Combobox.Options, { mt: "sm", "aria-label": "Entries", children: _jsx(ScrollArea.Autosize, { mah: 360, type: "scroll", scrollbars: "y", children: matches.length === 0 ? (_jsxs(Text, { size: "sm", c: "dimmed", p: "xs", "data-testid": "quick-open-empty", children: ["No entries match \u201C", query, "\u201D."] })) : (groups.map((group, index) => (_jsx(Combobox.Group, { label: group.heading || undefined, children: group.entries.map((entry) => (_jsxs(Combobox.Option, { value: entry.path, "data-testid": "quick-open-option", children: [_jsx(Highlight, { highlight: query.trim(), size: "sm", children: entry.label }), entry.slug && _jsx(Text, { size: "xs", children: entry.slug })] }, entry.path))) }, index)))) }) }), matches.length > MAX_OPTIONS && (_jsxs(Text, { size: "xs", c: "dimmed", mt: "xs", children: ["Showing ", MAX_OPTIONS, " of ", matches.length, ". Keep typing to narrow the list."] }))] }) }));
+    return (_jsx(Modal, { opened: opened, onClose: onClose, title: EDITOR_ACTIONS.openEntry, size: "lg", yOffset: "10vh", returnFocus: !returnFocusTo, onExitTransitionEnd: () => returnFocusTo && focusIfIdle(returnFocusTo()), [QUICK_OPEN_REPLACES_ATTR]: true, [FOCUS_RETURN_ATTR]: true, children: _jsxs(Combobox, { store: combobox, onOptionSubmit: handleSubmit, children: [_jsx(Combobox.EventsTarget, { withExpandedAttribute: true, "data-mantine-stop-propagation": false, children: _jsx(TextInput, { role: "combobox", "aria-label": "Search entries", "aria-autocomplete": "list", placeholder: "Type an entry title or slug", leftSection: _jsx(IconSearch, { size: 14, "aria-hidden": true }), value: query, onChange: (event) => setQuery(event.currentTarget.value), "data-autofocus": true, "data-testid": "quick-open-input" }) }), _jsx(Combobox.Options, { mt: "sm", "aria-label": "Entries", children: _jsx(ScrollArea.Autosize, { mah: 360, type: "scroll", scrollbars: "y", children: matches.length === 0 ? (_jsxs(Text, { size: "sm", c: "dimmed", p: "xs", "data-testid": "quick-open-empty", children: ["No entries match \u201C", query, "\u201D."] })) : (groups.map((group, index) => (_jsx(Combobox.Group, { label: group.heading || undefined, children: group.entries.map((entry) => (_jsxs(Combobox.Option, { value: entry.path, "data-testid": "quick-open-option", children: [_jsx(Highlight, { highlight: query.trim(), size: "sm", children: entry.label }), entry.slug && _jsx(Text, { size: "xs", children: entry.slug })] }, entry.path))) }, index)))) }) }), matches.length > MAX_OPTIONS && (_jsxs(Text, { size: "xs", c: "dimmed", mt: "xs", children: ["Showing ", MAX_OPTIONS, " of ", matches.length, ". Keep typing to narrow the list."] }))] }) }));
 }

package/dist/editor/components/RenameEntryModal.d.ts

@@ -19,5 +19,7 @@ export interface RenameEntryModalProps {
     existingSlugs?: ReadonlySet<string>;
     /** The URL path the entry will be served at for a slug; undefined when it has no page. */
     previewPath?: (slug: string) => string | undefined;
+    /** Where focus goes once it closes; Mantine's default, the element focused at open, without it. */
+    returnFocusTo?: () => HTMLElement | null;
 }
-export declare function RenameEntryModal({ isOpen, entryLabel, currentSlug, onSave, onClose, isSaving, error, warning, existingSlugs, previewPath, }: RenameEntryModalProps): import("react/jsx-runtime").JSX.Element;
+export declare function RenameEntryModal({ isOpen, entryLabel, currentSlug, onSave, onClose, isSaving, error, warning, existingSlugs, previewPath, returnFocusTo, }: RenameEntryModalProps): import("react/jsx-runtime").JSX.Element;

package/dist/editor/components/RenameEntryModal.js

@@ -8,7 +8,8 @@ import { useState } from 'react';
 import { Modal, Stack, TextInput, Group, Button, Alert, Text } from '@mantine/core';
 import { IconAlertCircle, IconAlertTriangle } from '@tabler/icons-react';
 import { validateEntrySlug } from '../slug.js';
-export function RenameEntryModal({ isOpen, entryLabel, currentSlug, onSave, onClose, isSaving = false, error = null, warning = null, existingSlugs, previewPath, }) {
+import { focusReturnProps } from '../utils/focus-return.js';
+export function RenameEntryModal({ isOpen, entryLabel, currentSlug, onSave, onClose, isSaving = false, error = null, warning = null, existingSlugs, previewPath, returnFocusTo, }) {
     const [newSlug, setNewSlug] = useState(currentSlug);
     const [touched, setTouched] = useState(false);
     // Reset state when modal opens (adjust state during render instead of effect)
@@ -37,7 +38,7 @@ export function RenameEntryModal({ isOpen, entryLabel, currentSlug, onSave, onCl
         await onSave(newSlug);
     };
     const slugPath = previewPath?.(newSlug || 'your-slug');
-    return (_jsx(Modal, { opened: isOpen, onClose: onClose, title: _jsx(Text, { fw: 600, children: "Rename entry" }), size: "md", closeOnClickOutside: !isSaving, closeOnEscape: !isSaving, children: _jsx("form", { onSubmit: handleSubmit, noValidate: true, children: _jsxs(Stack, { gap: "md", "data-testid": "rename-entry-modal", children: [warning ? (_jsx(Alert, { icon: _jsx(IconAlertTriangle, { size: 16 }), color: "yellow", variant: "light", children: warning })) : (error && (_jsx(Alert, { icon: _jsx(IconAlertCircle, { size: 16 }), color: "red", variant: "light", children: error }))), _jsxs(Text, { size: "sm", c: "dimmed", children: ["Renaming \u201C", entryLabel, "\u201D"] }), _jsx(TextInput, { label: "Slug", description: slugPath ? `URL path: ${slugPath}` : 'Lowercase letters, numbers and hyphens', value: newSlug, onChange: (e) => {
+    return (_jsx(Modal, { opened: isOpen, onClose: onClose, title: _jsx(Text, { fw: 600, children: "Rename entry" }), size: "md", closeOnClickOutside: !isSaving, closeOnEscape: !isSaving, ...focusReturnProps(returnFocusTo), children: _jsx("form", { onSubmit: handleSubmit, noValidate: true, children: _jsxs(Stack, { gap: "md", "data-testid": "rename-entry-modal", children: [warning ? (_jsx(Alert, { icon: _jsx(IconAlertTriangle, { size: 16 }), color: "yellow", variant: "light", children: warning })) : (error && (_jsx(Alert, { icon: _jsx(IconAlertCircle, { size: 16 }), color: "red", variant: "light", children: error }))), _jsxs(Text, { size: "sm", c: "dimmed", children: ["Renaming \u201C", entryLabel, "\u201D"] }), _jsx(TextInput, { label: "Slug", description: slugPath ? `URL path: ${slugPath}` : 'Lowercase letters, numbers and hyphens', value: newSlug, onChange: (e) => {
                             setNewSlug(e.currentTarget.value);
                             setTouched(true);
                         }, error: touched ? validationError : null, placeholder: "my-entry-slug", required: true, disabled: isSaving, "data-autofocus": true, "data-testid": "rename-slug-input" }), _jsxs(Group, { justify: "flex-end", gap: "sm", children: [_jsx(Button, { size: "sm", variant: "subtle", onClick: onClose, disabled: isSaving, children: "Cancel" }), _jsx(Button, { size: "sm", type: "submit", loading: isSaving, disabled: newSlug === currentSlug, "data-testid": "rename-entry-submit", children: "Rename" })] })] }) }) }));

package/dist/editor/components/SaveAllResult.d.ts

@@ -0,0 +1,25 @@
+import type { LogicalPath } from '../../paths/types.js';
+import { type SaveAllResult } from '../hooks/save-all.js';
+interface SaveAllResultMessageProps {
+    result: SaveAllResult;
+    onOpenEntry: (path: LogicalPath) => void;
+    /** Runs Save all again over whatever is still unsaved. */
+    onRetry: () => void;
+}
+/**
+ * Names every entry Save all could not save, each opening that entry, with its reason and a
+ * warning or error mark. "Try again" is offered only when a failure is one a retry can pass.
+ * @internal Exported for stories.
+ */
+export declare function SaveAllResultMessage({ result, onOpenEntry, onRetry }: SaveAllResultMessageProps): import("react/jsx-runtime").JSX.Element;
+type Actions = Omit<SaveAllResultMessageProps, 'result'>;
+/**
+ * Reports a finished Save all in one toast. Partly failed, it stays until dismissed: yellow when
+ * nothing failed for good, else red, each entry marked by its own severity.
+ */
+export declare function showSaveAllResult(result: SaveAllResult, actions: Actions): void;
+/** Takes an entry out of the result on screen, and the toast down with its last entry. */
+export declare function settleSaveAllEntry(contentId: string): void;
+/** Takes a partly failed result down, as when the branch it belongs to is left. */
+export declare function clearSaveAllResult(): void;
+export {};

package/dist/editor/components/SaveAllResult.js

@@ -0,0 +1,86 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Anchor, Box, Button, Group, List, Stack, Text, VisuallyHidden } from '@mantine/core';
+import { notifications } from '@mantine/notifications';
+import { IconAlertTriangle, IconCircleX } from '@tabler/icons-react';
+import { SAVE_ALL_RESULT_TOAST_ID, } from '../hooks/save-all.js';
+import { getNotificationDuration } from '../utils/env.js';
+const entries = (count) => `${count} ${count === 1 ? 'entry' : 'entries'}`;
+/** Nothing is lost yet: no answer, or a change made elsewhere. */
+const isWarning = (failure) => failure.kind === 'unanswered' || failure.kind === 'conflict';
+/**
+ * Names every entry Save all could not save, each opening that entry, with its reason and a
+ * warning or error mark. "Try again" is offered only when a failure is one a retry can pass.
+ * @internal Exported for stories.
+ */
+export function SaveAllResultMessage({ result, onOpenEntry, onRetry }) {
+    const retryable = result.failed.some((failure) => failure.kind === 'error' || failure.retryable);
+    return (_jsxs(Stack, { gap: 6, "data-testid": "save-all-result", children: [result.saved.length > 0 && _jsx(Text, { size: "sm", children: `${entries(result.saved.length)} saved.` }), _jsx(List, { size: "sm", spacing: 6, listStyleType: "none", pl: 0, children: result.failed.map((failure) => (_jsx(List.Item, { "data-testid": "save-all-failure", children: _jsxs(Group, { gap: 6, wrap: "nowrap", align: "flex-start", children: [_jsx(Box, { component: "span", display: "inline-flex", mt: 2, "aria-hidden": "true", c: isWarning(failure) ? 'var(--mantine-color-text)' : 'var(--canopy-danger-text)', children: isWarning(failure) ? _jsx(IconAlertTriangle, { size: 16 }) : _jsx(IconCircleX, { size: 16 }) }), _jsxs("div", { children: [_jsx(VisuallyHidden, { component: "span", children: isWarning(failure) ? 'Warning: ' : 'Error: ' }), _jsx(Anchor, { component: "button", type: "button", size: "sm", fw: 600, onClick: () => onOpenEntry(failure.path), children: failure.label }), _jsx(Text, { size: "sm", span: true, children: `: ${failure.reason}` }), failure.recreate && (_jsx(Button, { display: "block", mt: 4, size: "compact-xs", variant: "default", onClick: failure.recreate, children: "Save as new entry" }))] })] }) }, failure.contentId))) }), _jsx(Text, { size: "sm", children: result.failed.length === 1
+                    ? 'Its unsaved changes are kept.'
+                    : 'Their unsaved changes are kept.' }), retryable && (_jsx(Button, { size: "compact-sm", variant: "default", w: "fit-content", onClick: onRetry, children: "Try again" }))] }));
+}
+// The result on screen, so an entry settled elsewhere (saved, refreshed, discarded) leaves it.
+let shown;
+const renderFailures = (result, actions, update) => {
+    const data = {
+        id: SAVE_ALL_RESULT_TOAST_ID,
+        // An unanswered save may have landed, so "not saved" would claim more than is known.
+        title: `${result.failed.length === result.total
+            ? entries(result.total)
+            : `${result.failed.length} of ${entries(result.total)}`} ${result.failed.some((failure) => failure.kind === 'unanswered') ? 'may not have saved' : 'not saved'}`,
+        message: _jsx(SaveAllResultMessage, { result: result, ...actions }),
+        color: result.failed.every(isWarning) ? 'yellow' : 'red',
+        autoClose: false,
+        withCloseButton: true,
+        onClose: () => {
+            shown = undefined;
+        },
+    };
+    if (update)
+        notifications.update(data);
+    else
+        notifications.show(data);
+};
+/**
+ * Reports a finished Save all in one toast. Partly failed, it stays until dismissed: yellow when
+ * nothing failed for good, else red, each entry marked by its own severity.
+ */
+export function showSaveAllResult(result, actions) {
+    shown = undefined;
+    notifications.hide(SAVE_ALL_RESULT_TOAST_ID);
+    if (result.total === 0 || result.failed.length === 0) {
+        notifications.show({
+            id: SAVE_ALL_RESULT_TOAST_ID,
+            // An empty run found every change already on the server, or settled meanwhile.
+            message: result.total === 0 ? 'No changes to save' : `${entries(result.saved.length)} saved`,
+            color: result.total === 0 ? 'blue' : 'green',
+            autoClose: getNotificationDuration(4000),
+            withCloseButton: true,
+        });
+        return;
+    }
+    shown = { result, actions };
+    renderFailures(result, actions, false);
+}
+/** Takes an entry out of the result on screen, and the toast down with its last entry. */
+export function settleSaveAllEntry(contentId) {
+    if (!shown)
+        return;
+    const failed = shown.result.failed.filter((failure) => failure.contentId !== contentId);
+    if (failed.length === shown.result.failed.length)
+        return;
+    if (failed.length === 0) {
+        clearSaveAllResult();
+        return;
+    }
+    // Settled, the entry is no longer part of the run the title counts.
+    shown = { ...shown, result: { ...shown.result, failed, total: shown.result.total - 1 } };
+    renderFailures(shown.result, shown.actions, true);
+}
+/** Takes a partly failed result down, as when the branch it belongs to is left. */
+export function clearSaveAllResult() {
+    if (!shown)
+        return;
+    shown = undefined;
+    notifications.hide(SAVE_ALL_RESULT_TOAST_ID);
+}

package/dist/editor/components/SaveSplitButton.d.ts

@@ -0,0 +1,30 @@
+import type { SaveAllProgress } from '../hooks/save-all.js';
+export interface SaveSplitButtonProps {
+    onSave: () => void;
+    /** Why Save can't act now; empty when it can. */
+    saveBlockedReason: string;
+    /** The editor is loading or saving: Save waits without a reason. */
+    busy: boolean;
+    onSaveAll: () => void;
+    /** Entries on the branch with unsaved changes. */
+    unsavedCount: number;
+    /** Why Save all can't act now, other than nothing being unsaved. */
+    saveAllBlockedReason?: string;
+    /** Set while Save all runs. */
+    saveAllProgress: SaveAllProgress | null;
+    /** A Save of the open entry is in flight. */
+    saving?: boolean;
+    /** Rises each time a single Save lands, whichever entry it saved. */
+    savedSignal?: number;
+    /** The last Save that landed saved the open entry. */
+    savedHere?: boolean;
+    /** The open entry has unsaved changes. */
+    entryDirty: boolean;
+    /** Writing drafts to localStorage failed, so they live only in this tab. */
+    draftStorageFailed: boolean;
+}
+/**
+ * The unsaved indicator, then Save with a caret offering "Save all". The indicator is icon-only
+ * below `lg`, its text then its Tooltip and accessible name.
+ */
+export declare function SaveSplitButton({ onSave, saveBlockedReason, busy, onSaveAll, unsavedCount, saveAllBlockedReason, saveAllProgress, saving, savedSignal, savedHere, entryDirty, draftStorageFailed, }: SaveSplitButtonProps): import("react/jsx-runtime").JSX.Element;

package/dist/editor/components/SaveSplitButton.js

@@ -0,0 +1,108 @@
+'use client';
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useRef, useState } from 'react';
+import { Box, Button, Loader, Menu, Text, Tooltip, VisuallyHidden } from '@mantine/core';
+import { useReducedMotion } from '@mantine/hooks';
+import { IconAlertTriangle, IconCheck, IconChevronDown, IconCircleDot, IconLoader2, } from '@tabler/icons-react';
+import { EDITOR_ACTIONS } from '../copy.js';
+import { ReasonedMenuItem } from './ReasonedMenuItem.js';
+import { useMenuItemFocusReturn } from '../utils/focus-return.js';
+const STORAGE_FAILED_HINT = "Save before you leave or reload, or they'll be lost.";
+const SAVED_SHOWN_MS = 2000;
+// Below `sm` the status words are visually hidden, so Save keeps its own width beside an icon.
+const LABEL_TEXT_CLASS = 'canopy-save-label-text';
+const LABEL_STYLES = `
+@media (max-width: 47.99em) {
+  .${LABEL_TEXT_CLASS} {
+    position: absolute; width: 1px; height: 1px; overflow: hidden;
+    clip: rect(0 0 0 0); white-space: nowrap;
+  }
+}
+`;
+/**
+ * Every label in one grid cell, only `shown` visible, so the button keeps the widest one's width
+ * and the top bar never shifts.
+ */
+function SaveLabels({ shown, spinner }) {
+    const labels = {
+        save: EDITOR_ACTIONS.save,
+        saving: (_jsxs(_Fragment, { children: [_jsx(Box, { component: "span", display: "inline-flex", w: 14, children: shown === 'saving' &&
+                        (spinner ? (_jsx(Loader, { size: 14, color: "currentColor" })) : (_jsx(IconLoader2, { size: 14, "aria-hidden": "true" }))) }), _jsx("span", { className: LABEL_TEXT_CLASS, children: "Saving\u2026" })] })),
+        saved: (_jsxs(_Fragment, { children: [_jsx(IconCheck, { size: 14, "aria-hidden": "true" }), _jsx("span", { className: LABEL_TEXT_CLASS, children: "Saved" })] })),
+    };
+    return (_jsx(Box, { component: "span", pos: "relative", style: { display: 'inline-grid' }, children: Object.keys(labels).map((key) => (_jsx(Box, { component: "span", "aria-hidden": key === shown ? undefined : true, style: {
+                gridArea: '1 / 1',
+                display: 'inline-flex',
+                alignItems: 'center',
+                justifyContent: 'center',
+                gap: 6,
+                visibility: key === shown ? 'visible' : 'hidden',
+            }, children: labels[key] }, key))) }));
+}
+/**
+ * The unsaved indicator, then Save with a caret offering "Save all". The indicator is icon-only
+ * below `lg`, its text then its Tooltip and accessible name.
+ */
+export function SaveSplitButton({ onSave, saveBlockedReason, busy, onSaveAll, unsavedCount, saveAllBlockedReason, saveAllProgress, saving = false, savedSignal, savedHere = false, entryDirty, draftStorageFailed, }) {
+    const caret = useRef(null);
+    const menuFocus = useMenuItemFocusReturn(caret);
+    const reducedMotion = useReducedMotion();
+    // Each landed Save shows "Saved" once, as it lands and only on its own entry: one that landed
+    // before mount or while another entry was open shows nothing later.
+    const [seenSignal, setSeenSignal] = useState(savedSignal ?? 0);
+    const [flashing, setFlashing] = useState();
+    // Leaving the saved entry ends its "Saved", so a quick return doesn't show or announce it again.
+    const [wasHere, setWasHere] = useState(savedHere);
+    if (wasHere !== savedHere) {
+        setWasHere(savedHere);
+        if (!savedHere)
+            setFlashing(undefined);
+    }
+    if (savedSignal !== undefined && savedSignal > seenSignal) {
+        setSeenSignal(savedSignal);
+        setFlashing(savedHere ? savedSignal : undefined);
+    }
+    useEffect(() => {
+        if (flashing === undefined)
+            return;
+        const timer = setTimeout(() => setFlashing(undefined), SAVED_SHOWN_MS);
+        return () => clearTimeout(timer);
+    }, [flashing]);
+    // Blocked, Save stays focusable (`aria-disabled`, not `disabled`), so its reason opens on focus.
+    const saveBlocked = !!saveBlockedReason || busy || !!saveAllProgress;
+    const label = saving
+        ? 'saving'
+        : flashing !== undefined &&
+            flashing === savedSignal &&
+            savedHere &&
+            !entryDirty &&
+            !saveAllProgress
+            ? 'saved'
+            : 'save';
+    const saveGreyed = saveBlocked && !saveAllProgress && label === 'save';
+    const indicatorText = draftStorageFailed
+        ? 'Unsaved · not kept on this device'
+        : 'Unsaved · kept on this device';
+    const indicatorColor = draftStorageFailed ? 'var(--canopy-danger-text)' : 'dimmed';
+    return (_jsxs(_Fragment, { children: [_jsx(Box, { role: "status", ta: "right", w: { base: 20, lg: 112 }, style: { flexShrink: 0 }, children: entryDirty && (_jsx(Tooltip, { label: draftStorageFailed ? `${indicatorText}. ${STORAGE_FAILED_HINT}` : indicatorText, multiline: true, w: 260, children: _jsxs(Text, { size: "xs", lh: 1.2, c: indicatorColor, "data-testid": "unsaved-indicator", children: [_jsx(Box, { component: "span", visibleFrom: "lg", children: indicatorText }), _jsx(Box, { component: "span", hiddenFrom: "lg", display: "inline-flex", "aria-hidden": "true", children: draftStorageFailed ? _jsx(IconAlertTriangle, { size: 18 }) : _jsx(IconCircleDot, { size: 18 }) }), _jsx(VisuallyHidden, { component: "span", hiddenFrom: "lg", children: indicatorText }), draftStorageFailed && (_jsxs(VisuallyHidden, { component: "span", children: [". ", STORAGE_FAILED_HINT] }))] }) })) }), _jsx(VisuallyHidden, { role: "status", children: saveAllProgress
+                    ? `Saving ${saveAllProgress.total} ${saveAllProgress.total === 1 ? 'entry' : 'entries'}…`
+                    : label === 'saved'
+                        ? 'Saved'
+                        : '' }), _jsx("style", { children: LABEL_STYLES }), _jsxs(Button.Group, { style: { flexShrink: 0 }, children: [_jsx(Tooltip, { label: saveBlockedReason, 
+                        // Not beside "Saving…" or "Saved", which already say what happened.
+                        disabled: !saveBlockedReason || busy || label !== 'save', multiline: true, maw: 280, children: _jsx(Button, { "data-testid": "save-button", variant: "filled", size: "sm", leftSection: saveAllProgress && !reducedMotion ? (_jsx(Loader, { size: 14, color: "currentColor" })) : undefined, onClick: () => {
+                                if (!saveBlocked)
+                                    onSave();
+                            }, "data-disabled": saveGreyed ? true : undefined, "aria-disabled": saveBlocked ? true : undefined, children: saveAllProgress ? (`Saving ${Math.min(saveAllProgress.done + 1, saveAllProgress.total)} of ${saveAllProgress.total}…`) : (_jsx(SaveLabels, { shown: label, spinner: !reducedMotion })) }) }), _jsxs(Menu, { withinPortal: true, shadow: "sm", position: "bottom-end", ...menuFocus.menu, children: [_jsx(Tooltip, { label: "Save options", events: { hover: true, focus: true, touch: false }, children: _jsx(Menu.Target, { children: _jsx(Button, { ref: caret, 
+                                        // Light beside a greyed Save, so a blocked split button shows no filled half.
+                                        variant: saveGreyed ? 'light' : 'filled', size: "sm", px: 8, "aria-label": "Save options", "data-testid": "save-options-button", style: { borderInlineStart: '1px solid var(--mantine-color-body)' }, children: _jsx(IconChevronDown, { size: 14, "aria-hidden": "true" }) }) }) }), _jsx(Menu.Dropdown, { ...menuFocus.dropdown, children: _jsx(ReasonedMenuItem, { "data-testid": "save-all-menu-item", onClick: onSaveAll, blockedReason: saveAllBlockedReason ??
+                                        (saveAllProgress
+                                            ? `${EDITOR_ACTIONS.saveAll} is already running.`
+                                            : unsavedCount === 0
+                                                ? 'No entry on this branch has unsaved changes.'
+                                                : busy
+                                                    ? 'Wait for the current save or load to finish.'
+                                                    : undefined), children: unsavedCount > 0
+                                        ? `${EDITOR_ACTIONS.saveAll} (${unsavedCount})`
+                                        : EDITOR_ACTIONS.saveAll }) })] })] })] }));
+}

package/dist/editor/components/index.d.ts

@@ -1,3 +1,3 @@
-export * from './EditorFooter.js';
+export * from './BranchLockBanner.js';
 export * from './EditorHeader.js';
-export * from './EditorSidebar.js';
+export * from './EditorRail.js';

package/dist/editor/components/index.js

@@ -1,3 +1,3 @@
-export * from './EditorFooter.js';
+export * from './BranchLockBanner.js';
 export * from './EditorHeader.js';
-export * from './EditorSidebar.js';
+export * from './EditorRail.js';

package/dist/editor/context/EditorStateContext.d.ts

@@ -21,11 +21,11 @@ interface EditorStateProviderProps {
     /** Initial modal states (useful for deep linking) */
     initialModals?: Partial<ModalState>;
 }
-/** @internal No importer; deletion candidate in editor-state-context-migration.md. */
+/** @internal No importer; deletion candidate in safeinsights/canopycms#678. */
 export declare function EditorStateProvider({ children, initialModals }: EditorStateProviderProps): import("react/jsx-runtime").JSX.Element;
 /**
  * Convenience hook for loading states only.
- * @internal No importer; deletion candidate in editor-state-context-migration.md.
+ * @internal No importer; deletion candidate in safeinsights/canopycms#678.
  */
 export declare function useEditorLoading(): {
     busy: boolean;
@@ -36,7 +36,7 @@ export declare function useEditorLoading(): {
 };
 /**
  * Convenience hook for modal states only.
- * @internal No importer; deletion candidate in editor-state-context-migration.md.
+ * @internal No importer; deletion candidate in safeinsights/canopycms#678.
  */
 export declare function useEditorModals(): {
     openModal: (key: keyof ModalState) => void;
@@ -50,7 +50,7 @@ export declare function useEditorModals(): {
 };
 /**
  * Convenience hook for preview state only.
- * @internal No importer; deletion candidate in editor-state-context-migration.md.
+ * @internal No importer; deletion candidate in safeinsights/canopycms#678.
  */
 export declare function useEditorPreview(): {
     data: FormValue;

package/dist/editor/context/EditorStateContext.js

@@ -6,7 +6,7 @@ import { jsx as _jsx } from "react/jsx-runtime";
  */
 import { createContext, useContext, useCallback, useState, useMemo } from 'react';
 const EditorStateContext = createContext(null);
-/** @internal No importer; deletion candidate in editor-state-context-migration.md. */
+/** @internal No importer; deletion candidate in safeinsights/canopycms#678. */
 export function EditorStateProvider({ children, initialModals }) {
     const [loading, setLoadingState] = useState({
         branches: false,
@@ -88,7 +88,7 @@ function useEditorState() {
 }
 /**
  * Convenience hook for loading states only.
- * @internal No importer; deletion candidate in editor-state-context-migration.md.
+ * @internal No importer; deletion candidate in safeinsights/canopycms#678.
  */
 export function useEditorLoading() {
     const { state, actions } = useEditorState();
@@ -100,7 +100,7 @@ export function useEditorLoading() {
 }
 /**
  * Convenience hook for modal states only.
- * @internal No importer; deletion candidate in editor-state-context-migration.md.
+ * @internal No importer; deletion candidate in safeinsights/canopycms#678.
  */
 export function useEditorModals() {
     const { state, actions } = useEditorState();
@@ -113,7 +113,7 @@ export function useEditorModals() {
 }
 /**
  * Convenience hook for preview state only.
- * @internal No importer; deletion candidate in editor-state-context-migration.md.
+ * @internal No importer; deletion candidate in safeinsights/canopycms#678.
  */
 export function useEditorPreview() {
     const { state, actions } = useEditorState();