canopycms 0.0.63 → 0.0.64

package/dist/dev-content-watcher.d.ts

@@ -16,8 +16,8 @@
  * All logic lives here in the core package; framework adapters just call startDevContentWatcher() once
  * at dev startup. See packages/canopycms-next/src/context-wrapper.ts for the Next wiring.
  */
-import type { CanopyServices } from './services';
-import type { DevContentSyncMode } from './config/types';
+import type { CanopyServices } from './services.js';
+import type { DevContentSyncMode } from './config/types.js';
 export interface StartDevContentWatcherOptions {
     /** 'warn' (default) | 'off'. */
     mode?: DevContentSyncMode;
@@ -34,4 +34,3 @@ export interface StartDevContentWatcherOptions {
  * not in dev mode, or when the working-tree content directory does not exist.
  */
 export declare function startDevContentWatcher(services: CanopyServices, options?: StartDevContentWatcherOptions): () => void;
-//# sourceMappingURL=dev-content-watcher.d.ts.map

package/dist/dev-content-watcher.js

@@ -122,4 +122,3 @@ export function startDevContentWatcher(services, options = {}) {
     activeWatchers.set(workingTreeContentDir, dispose);
     return dispose;
 }
-//# sourceMappingURL=dev-content-watcher.js.map

package/dist/editor/BranchManager.d.ts

@@ -1,8 +1,8 @@
 import React from 'react';
-import type { OperatingMode } from '../operating-mode';
-import type { ConflictStatus, PullRequestState, SyncStatus } from '../types';
-import type { CommentThread } from '../comment-store';
-import type { UserSearchResult } from '../auth/types';
+import type { OperatingMode } from '../operating-mode/index.js';
+import type { ConflictStatus, PullRequestState, SyncStatus } from '../types.js';
+import type { CommentThread } from '../comment-store.js';
+import type { UserSearchResult } from '../auth/types.js';
 export interface BranchSummary {
     name: string;
     status: string;
@@ -85,4 +85,3 @@ export interface BranchManagerProps {
     onGetUserMetadata?: (userId: string) => Promise<UserSearchResult | null>;
 }
 export declare const BranchManager: React.FC<BranchManagerProps>;
-//# sourceMappingURL=BranchManager.d.ts.map

package/dist/editor/BranchManager.js

@@ -152,4 +152,3 @@ export const BranchManager = ({ branches, mode, user, onSelect, onCreate, onDele
                                                             : 'Only Admin or branch creator can delete', disabled: perms.canDelete, children: _jsx(Button, { size: "xs", variant: "outline", color: "red", onClick: () => onDelete?.(b.name), disabled: !perms.canDelete, "data-testid": `delete-branch-button-${b.name}`, children: "Delete" }) })] })] }) }, b.name));
                     }) })) })] }));
 };
-//# sourceMappingURL=BranchManager.js.map

package/dist/editor/CanopyEditor.d.ts

@@ -1,10 +1,9 @@
 import React from 'react';
-import type { CanopyClientConfig } from '../config';
-import type { EditorProps } from './Editor';
+import type { CanopyClientConfig } from '../config/index.js';
+import type { EditorProps } from './Editor.js';
 export interface CanopyEditorProps extends Omit<EditorProps, 'collections' | 'previewBaseByCollection' | 'title' | 'subtitle' | 'themeOptions' | 'entries' | 'contentRoot' | 'operatingMode'> {
     config: CanopyClientConfig;
     entries?: EditorProps['entries'];
 }
 export declare const CanopyEditor: React.FC<CanopyEditorProps>;
 export default CanopyEditor;
-//# sourceMappingURL=CanopyEditor.d.ts.map

package/dist/editor/CanopyEditor.js

@@ -16,7 +16,6 @@ export const CanopyEditor = ({ config, entries = [], initialSelectedId, initialV
     const resolvedTitle = config.editor?.title ?? 'CanopyCMS Editor';
     const resolvedSubtitle = config.editor?.subtitle;
     const resolvedTheme = config.editor?.theme ?? undefined;
-    return (_jsx(SWRProvider, { children: _jsx(ApiClientProvider, { children: _jsx(Editor, { entries: entries, title: resolvedTitle, subtitle: resolvedSubtitle, branchName: resolvedBranchName, operatingMode: config.mode, initialSelectedId: initialSelectedId, initialValues: initialValues, renderPreview: renderPreview, onCreateEntry: onCreateEntry, customRenderers: customRenderers, collections: collections, contentRoot: config.contentRoot, entryLinkUrl: config.entryLinkUrl, previewBaseByCollection: previewBase, assetBaseUrl: config.assetBaseUrl, themeOptions: resolvedTheme, AccountComponent: config.editor?.AccountComponent, onAccountClick: config.editor?.onAccountClick, onLogoutClick: config.editor?.onLogoutClick }) }) }));
+    return (_jsx(SWRProvider, { children: _jsx(ApiClientProvider, { basePath: config.basePath, children: _jsx(Editor, { entries: entries, title: resolvedTitle, subtitle: resolvedSubtitle, branchName: resolvedBranchName, operatingMode: config.mode, initialSelectedId: initialSelectedId, initialValues: initialValues, renderPreview: renderPreview, onCreateEntry: onCreateEntry, customRenderers: customRenderers, collections: collections, contentRoot: config.contentRoot, entryLinkUrl: config.entryLinkUrl, previewBaseByCollection: previewBase, assetBaseUrl: config.assetBaseUrl, basePath: config.basePath, themeOptions: resolvedTheme, AccountComponent: config.editor?.AccountComponent, onAccountClick: config.editor?.onAccountClick, onLogoutClick: config.editor?.onLogoutClick }) }) }));
 };
 export default CanopyEditor;
-//# sourceMappingURL=CanopyEditor.js.map

package/dist/editor/CanopyEditorPage.d.ts

@@ -1,5 +1,5 @@
-import type { CanopyClientConfig } from '../config';
-import type { CustomFieldRenderers } from './FormRenderer';
+import type { CanopyClientConfig } from '../config/index.js';
+import type { CustomFieldRenderers } from './FormRenderer.js';
 /**
  * @param customRenderers Optional adopter overrides for how specific field
  * types render (see `FormRenderer`'s `customRenderers` prop). Threaded
@@ -17,4 +17,3 @@ export declare const CanopyEditorPage: (config: CanopyClientConfig, customRender
     displayName: string;
 };
 export default CanopyEditorPage;
-//# sourceMappingURL=CanopyEditorPage.d.ts.map

package/dist/editor/CanopyEditorPage.js

@@ -20,4 +20,3 @@ export const CanopyEditorPage = (config, customRenderers) => {
     return CanopyEditorPageInner;
 };
 export default CanopyEditorPage;
-//# sourceMappingURL=CanopyEditorPage.js.map

package/dist/editor/CommentsPanel.d.ts

@@ -1,6 +1,6 @@
 import React from 'react';
-import type { CommentThread } from '../comment-store';
-import type { UserSearchResult } from '../auth/types';
+import type { CommentThread } from '../comment-store.js';
+import type { UserSearchResult } from '../auth/types.js';
 export interface CommentsPanelProps {
     branchName: string;
     comments: CommentThread[];
@@ -18,4 +18,3 @@ export interface CommentsPanelProps {
     onGetUserMetadata?: (userId: string) => Promise<UserSearchResult | null>;
 }
 export declare const CommentsPanel: React.FC<CommentsPanelProps>;
-//# sourceMappingURL=CommentsPanel.d.ts.map

package/dist/editor/CommentsPanel.js

@@ -66,4 +66,3 @@ export const CommentsPanel = ({ branchName, comments, canResolve, onAddComment,
                                             setNewCommentText('');
                                         }, mt: "xs", children: "Reply" }))] }) }, thread.id))) })) })] }) }));
 };
-//# sourceMappingURL=CommentsPanel.js.map

package/dist/editor/Editor.d.ts

@@ -1,16 +1,15 @@
 import React from 'react';
-import type { ContentFormat, EntrySchema } from '../config';
-import type { CustomFieldRenderers, FormValue } from './FormRenderer';
-import type { OperatingMode } from '../operating-mode';
-import { type CanopyThemeOptions } from './theme';
-import type { LogicalPath, ContentId } from '../paths/types';
+import type { ContentFormat, EntrySchema } from '../config/index.js';
+import type { CustomFieldRenderers, FormValue } from './FormRenderer.js';
+import type { OperatingMode } from '../operating-mode/index.js';
+import { type CanopyThemeOptions } from './theme.js';
+import type { LogicalPath, ContentId } from '../paths/types.js';
 export interface EditorEntry {
     path: LogicalPath;
     contentId: ContentId;
     label: string;
     status?: string;
     schema: EntrySchema;
-    apiPath: string;
     previewSrc?: string;
     collectionPath?: LogicalPath;
     collectionName?: string;
@@ -52,7 +51,7 @@ export interface EditorProps {
     operatingMode: OperatingMode;
     collections?: EditorCollection[];
     contentRoot?: string;
-    entryLinkUrl?: import('../entry-link-resolver').EntryLinkUrlResolver;
+    entryLinkUrl?: import('../entry-link-resolver.js').EntryLinkUrlResolver;
     initialSelectedId?: string;
     initialValues?: Record<string, FormValue>;
     renderPreview?: (entry: EditorEntry, value: FormValue | undefined) => React.ReactNode;
@@ -63,6 +62,13 @@ export interface EditorProps {
     canResolveComments?: boolean;
     /** `media.publicBaseUrl` from config - prefixed onto asset URLs the editor builds (MediaLibrary/ImageField/MDX image dialog). Undefined means root-relative (editor and site share an origin). */
     assetBaseUrl?: string;
+    /**
+     * `CanopyClientConfig.basePath` - the deployment prefix the host Next.js app is served under
+     * (e.g. `/preview-123`). Prefixed onto every preview iframe `src` this component builds via
+     * `buildPreviewSrc`, so the iframe navigates to the entry's real served URL instead of the
+     * un-prefixed root. Undefined means the app is served at its origin's root (no-op).
+     */
+    basePath?: string;
     /**
      * Adopter-supplied overrides for how specific field types render, keyed by
      * field `type` (see `FormRenderer`'s `customRenderers` prop). Threaded
@@ -81,4 +87,3 @@ export interface EditorProps {
  */
 export declare const Editor: React.FC<EditorProps>;
 export default Editor;
-//# sourceMappingURL=Editor.d.ts.map

package/dist/editor/Editor.js

@@ -33,7 +33,7 @@ import { MediaLibrary } from './media/MediaLibrary.js';
  * High-level editor wrapper that wires entry navigation, form rendering,
  * saving/loading, and preview rendering using entry definitions.
  */
-export const Editor = ({ entries, title, subtitle, siteTitle = title, siteSubtitle = subtitle, branchName = '', collections, contentRoot, entryLinkUrl, initialSelectedId, initialValues, renderPreview, onCreateEntry, themeOptions, operatingMode, previewBaseByCollection, currentUser = 'current-user', canResolveComments = true, assetBaseUrl, AccountComponent, onAccountClick, onLogoutClick, customRenderers, }) => {
+export const Editor = ({ entries, title, subtitle, siteTitle = title, siteSubtitle = subtitle, branchName = '', collections, contentRoot, entryLinkUrl, initialSelectedId, initialValues, renderPreview, onCreateEntry, themeOptions, operatingMode, previewBaseByCollection, currentUser = 'current-user', canResolveComments = true, assetBaseUrl, basePath, AccountComponent, onAccountClick, onLogoutClick, customRenderers, }) => {
     // Per-resource loading states
     const [branchesLoading, setBranchesLoading] = useState(false);
     const [entriesLoading, setEntriesLoading] = useState(false);
@@ -117,9 +117,9 @@ export const Editor = ({ entries, title, subtitle, siteTitle = title, siteSubtit
             branchName: branchNameState,
             previewBaseByCollection,
             contentRoot,
+            basePath,
         }),
         setBusy: setEntriesLoading,
-        contentRoot,
     });
     // Keep the entry-type list referentially stable for as long as the create
     // modal is showing the same collection. Building it inline in the JSX handed
@@ -492,7 +492,7 @@ export const Editor = ({ entries, title, subtitle, siteTitle = title, siteSubtit
         // such collection" the same (correct) not-found outcome, so the guard
         // below is reachable again. See the correction to PR #196's "unreachable
         // with entries empty" claim in
-        // .claude/future-tasks/program-b-final-review-followups.md for the write
+        // .claude/future-tasks/resolved/program-b-final-review-followups.md for the write
         // hazard this closes -- found by the 2026-08-12 adversarial review.
         const collection = findCollection(collectionsFromApi, collectionPath);
         if (!collection) {
@@ -663,7 +663,7 @@ export const Editor = ({ entries, title, subtitle, siteTitle = title, siteSubtit
     const footerHeight = 40;
     const headerTitle = currentEntry?.label ?? currentEntry?.slug ?? title;
     const breadcrumbSegments = useMemo(() => buildBreadcrumbSegments(currentEntry, collectionLabels), [collectionLabels, currentEntry]);
-    return (_jsx(CanopyCMSProvider, { ...(themeOptions ?? {}), children: _jsx(AssetContextProvider, { baseUrl: assetBaseUrl, children: _jsxs(Box, { bg: "gray.0", style: { minHeight: '100vh', width: '100%' }, children: [_jsx(EditorHeader, { ref: headerRef, siteTitle: siteTitle, siteSubtitle: siteSubtitle, headerTitle: headerTitle, currentEntry: currentEntry, branchName: branchNameState, operatingMode: operatingMode, branchStatus: currentBranch?.status, busy: busy, breadcrumbSegments: breadcrumbSegments, editedFiles: editedFiles, modifiedCount: modifiedCount, unresolvedCommentCount: comments.filter((t) => !t.resolved).length, comments: comments, hasUnsavedChanges: isSelectedDirty(), userContext: userContext, branchCreatedBy: currentBranch?.createdBy, branchAccess: currentBranch?.access, 
+    return (_jsx(CanopyCMSProvider, { ...(themeOptions ?? {}), children: _jsx(AssetContextProvider, { baseUrl: assetBaseUrl, basePath: basePath, children: _jsxs(Box, { bg: "gray.0", style: { minHeight: '100vh', width: '100%' }, children: [_jsx(EditorHeader, { ref: headerRef, siteTitle: siteTitle, siteSubtitle: siteSubtitle, headerTitle: headerTitle, currentEntry: currentEntry, branchName: branchNameState, operatingMode: operatingMode, branchStatus: currentBranch?.status, busy: busy, breadcrumbSegments: breadcrumbSegments, editedFiles: editedFiles, modifiedCount: modifiedCount, unresolvedCommentCount: comments.filter((t) => !t.resolved).length, comments: comments, hasUnsavedChanges: isSelectedDirty(), userContext: userContext, branchCreatedBy: currentBranch?.createdBy, branchAccess: currentBranch?.access, 
                         // Fail-closed for the same reason branchContentLocked above is:
                         // isProtected/writeBlocked gate real actions in EditorHeader (hiding
                         // Submit, disabling Save), so a missing wire value must read as
@@ -753,4 +753,3 @@ export const Editor = ({ entries, title, subtitle, siteTitle = title, siteSubtit
                         }, loading: deleteInProgress })] }) }) }));
 };
 export default Editor;
-//# sourceMappingURL=Editor.js.map

package/dist/editor/EditorPanes.d.ts

@@ -8,4 +8,3 @@ export interface EditorPanesProps {
 }
 export declare const EditorPanes: React.FC<EditorPanesProps>;
 export default EditorPanes;
-//# sourceMappingURL=EditorPanes.d.ts.map

package/dist/editor/EditorPanes.js

@@ -96,4 +96,3 @@ export const EditorPanes = ({ layout: layoutProp = 'side', onLayoutChange: _, pr
                                 }, children: form ?? 'Form' }) })] }) }) }) }));
 };
 export default EditorPanes;
-//# sourceMappingURL=EditorPanes.js.map

package/dist/editor/EntryNavigator.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import type { ContentId, LogicalPath } from '../paths/types';
+import type { ContentId, LogicalPath } from '../paths/types.js';
 import { useTree } from '@mantine/core';
 type TreeController = ReturnType<typeof useTree>;
 export interface EntryNavItem {
@@ -54,4 +54,3 @@ export interface EntryNavigatorProps {
 }
 export declare const EntryNavigator: React.FC<EntryNavigatorProps>;
 export default EntryNavigator;
-//# sourceMappingURL=EntryNavigator.d.ts.map

package/dist/editor/EntryNavigator.js

@@ -340,4 +340,3 @@ export const EntryNavigator = ({ items, collections, selectedPath, onSelect, onT
     return (_jsx(Stack, { h: "100%", style: { display: 'flex', flexDirection: 'column' }, gap: 0, "data-testid": "entry-navigator", children: _jsx(ScrollArea, { type: "auto", offsetScrollbars: true, style: { flex: 1 }, children: treeData.length === 0 ? (loading ? (_jsxs(Group, { gap: "xs", py: "sm", children: [_jsx(Loader, { size: "xs" }), _jsx(Text, { size: "xs", c: "dimmed", children: "Loading content\u2026" })] })) : (_jsx(Text, { size: "xs", c: "dimmed", py: "sm", children: "No content" }))) : (_jsx(Box, { py: "sm", children: _jsx(Tree, { data: treeData, tree: tree, renderNode: renderNode, selectOnClick: false, levelOffset: "sm" }) })) }) }));
 };
 export default EntryNavigator;
-//# sourceMappingURL=EntryNavigator.js.map

package/dist/editor/FormRenderer.d.ts

@@ -1,6 +1,6 @@
 import React from 'react';
-import type { EntrySchema, FieldConfig } from '../config';
-import type { CommentThread } from '../comment-store';
+import type { EntrySchema, FieldConfig } from '../config/index.js';
+import type { CommentThread } from '../comment-store.js';
 export type FormValue = Record<string, unknown>;
 export interface CustomFieldRenderProps {
     field: FieldConfig;
@@ -38,4 +38,3 @@ export interface FormRendererProps {
 }
 export declare const FormRenderer: React.FC<FormRendererProps>;
 export default FormRenderer;
-//# sourceMappingURL=FormRenderer.d.ts.map

package/dist/editor/FormRenderer.js

@@ -139,13 +139,33 @@ export const FormRenderer = ({ fields, value, onChange, customRenderers, branch
                     const items = Array.isArray(currentValue)
                         ? currentValue
                         : [];
-                    return (_jsx(Paper, { withBorder: true, radius: "md", p: "md", shadow: "xs", children: _jsxs(Stack, { gap: "sm", children: [_jsxs(Group, { justify: "space-between", children: [_jsx(Text, { size: "sm", fw: 600, children: label }), _jsx(Button, { size: "xs", variant: "light", onClick: () => update([...items, {}]), children: "Add item" })] }), _jsxs(Stack, { gap: "sm", children: [items.map((item, idx) => (_jsx(Paper, { withBorder: true, radius: "md", p: "sm", shadow: "xs", children: _jsxs(Stack, { gap: "xs", children: [_jsxs(Group, { justify: "space-between", children: [_jsxs(Text, { size: "xs", fw: 700, children: [label, " #", idx + 1] }), _jsx(Button, { size: "xs", variant: "subtle", color: "red", onClick: () => update(items.filter((_, i) => i !== idx)), children: "Remove" })] }), _jsx(ObjectField, { label: objectField.label, fields: objectField.fields, value: item, onChange: (next) => {
+                    return wrapWithComments(_jsx(Paper, { withBorder: true, radius: "md", p: "md", shadow: "xs", children: _jsxs(Stack, { gap: "sm", children: [_jsxs(Group, { justify: "space-between", children: [_jsx(Text, { size: "sm", fw: 600, children: label }), _jsx(Button, { size: "xs", variant: "light", onClick: () => update([...items, {}]), children: "Add item" })] }), _jsxs(Stack, { gap: "sm", children: [items.map((item, idx) => (_jsx(Paper, { withBorder: true, radius: "md", p: "sm", shadow: "xs", children: _jsxs(Stack, { gap: "xs", children: [_jsxs(Group, { justify: "space-between", children: [_jsxs(Text, { size: "xs", fw: 700, children: [label, " #", idx + 1] }), _jsx(Button, { size: "xs", variant: "subtle", color: "red", onClick: () => update(items.filter((_, i) => i !== idx)), children: "Remove" })] }), _jsx(ObjectField, { label: objectField.label, fields: objectField.fields, value: item, onChange: (next) => {
                                                             const nextItems = [...items];
                                                             nextItems[idx] = next;
                                                             update(nextItems);
                                                         }, renderField: renderField, path: [...path, idx], dataCanopyField: normalizeCanopyPath([...path, idx]) })] }) }, fieldKey([...path, idx])))), items.length === 0 && (_jsx(Text, { size: "xs", c: "dimmed", children: "No items yet. Add one to get started." }))] })] }) }, fieldKey(path)));
                 }
-                return (_jsx(ObjectField, { label: label, fields: objectField.fields, value: currentValue, onChange: (next) => update(next), renderField: renderField, path: path, dataCanopyField: normalizeCanopyPath(path) }, fieldKey(path)));
+                // Non-list object: unlike the list branch above (where each item has
+                // its own Remove button), this field had no way to return to
+                // `undefined` once given a value. That mattered because a required
+                // child field inside it can be filled and then cleared back to `''`,
+                // which `isEmptyForRequired` treats as empty (entry-validator.ts) --
+                // but the object as a whole only reads as "absent" when it is
+                // `undefined`/`null`, not when its children are individually empty.
+                // Without a way to unset the object, that state was permanently
+                // invalid. The Clear button (wired through ObjectField's onRemove)
+                // fixes that by resetting to `undefined`, never `{}` (which would
+                // still carry a required-but-empty child into validation).
+                //
+                // Shown only when the field is optional (a required object should
+                // not be clearable back to a missing state) and only once it
+                // actually has a value (nothing to clear otherwise). Labeled
+                // "Clear" rather than "Remove" so it doesn't read as deleting the
+                // field from the schema, the way "Remove" correctly does for a list
+                // item above.
+                const hasValue = currentValue !== undefined && currentValue !== null;
+                const canClear = objectField.required !== true && hasValue;
+                return wrapWithComments(_jsx(ObjectField, { label: label, fields: objectField.fields, value: currentValue, onChange: (next) => update(next), onRemove: canClear ? () => update(undefined) : undefined, renderField: renderField, path: path, dataCanopyField: normalizeCanopyPath(path) }, fieldKey(path)));
             }
             case 'code':
                 return wrapWithComments(_jsx(CodeField, { id: fieldId, label: label, value: typeof currentValue === 'string' ? currentValue : '', onChange: (v) => update(v), dataCanopyField: normalizeCanopyPath(path) }, fieldKey(path)));
@@ -165,4 +185,3 @@ export const FormRenderer = ({ fields, value, onChange, customRenderers, branch
             })] }));
 };
 export default FormRenderer;
-//# sourceMappingURL=FormRenderer.js.map

package/dist/editor/GroupManager.d.ts

@@ -2,6 +2,5 @@
  * GroupManager - Re-exports from the group-manager module.
  * This file maintains backward compatibility with existing imports.
  */
-export { GroupManager, useGroupState, useUserSearch, useExternalGroupSearch } from './group-manager';
-export type { GroupManagerProps, InternalGroup } from './group-manager';
-//# sourceMappingURL=GroupManager.d.ts.map
+export { GroupManager, useGroupState, useUserSearch, useExternalGroupSearch } from './group-manager/index.js';
+export type { GroupManagerProps, InternalGroup } from './group-manager/index.js';

package/dist/editor/GroupManager.js

@@ -4,4 +4,3 @@
  * This file maintains backward compatibility with existing imports.
  */
 export { GroupManager, useGroupState, useUserSearch, useExternalGroupSearch } from './group-manager/index.js';
-//# sourceMappingURL=GroupManager.js.map

package/dist/editor/PermissionManager.d.ts

@@ -4,6 +4,5 @@
  * This file maintains backward compatibility for imports.
  * The actual implementation is in ./permission-manager/
  */
-export { PermissionManager, usePermissionTree, useGroupsAndUsers } from './permission-manager';
-export type { PermissionManagerProps, ContentNode, TreeNode } from './permission-manager';
-//# sourceMappingURL=PermissionManager.d.ts.map
+export { PermissionManager, usePermissionTree, useGroupsAndUsers } from './permission-manager/index.js';
+export type { PermissionManagerProps, ContentNode, TreeNode } from './permission-manager/index.js';

package/dist/editor/PermissionManager.js

@@ -6,4 +6,3 @@
  * The actual implementation is in ./permission-manager/
  */
 export { PermissionManager, usePermissionTree, useGroupsAndUsers } from './permission-manager/index.js';
-//# sourceMappingURL=PermissionManager.js.map

package/dist/editor/admin/SystemHealthPanel.d.ts

@@ -3,4 +3,3 @@ export interface SystemHealthPanelProps {
     onClose: () => void;
 }
 export declare function SystemHealthPanel({ opened, onClose }: SystemHealthPanelProps): import("react/jsx-runtime").JSX.Element;
-//# sourceMappingURL=SystemHealthPanel.d.ts.map

package/dist/editor/admin/SystemHealthPanel.js

@@ -236,4 +236,3 @@ function BranchHealthRow({ entry, onMarkMerged, onRepair, onPurge, }) {
     const purgeGate = purgeGateFor(entry);
     return (_jsxs(Table.Tr, { style: { opacity: 0.65 }, children: [_jsx(Table.Td, { children: entry.dirName }), _jsx(Table.Td, { children: _jsx(Badge, { color: "gray", variant: "outline", children: "orphan" }) }), _jsx(Table.Td, { colSpan: 3, children: _jsxs(Text, { size: "xs", c: "dimmed", children: [entry.ageMs !== undefined ? `${formatAgeMs(entry.ageMs)} old` : 'unknown age', " \u00B7", ' ', entry.hasGitDir ? 'has .git' : 'no .git'] }) }), _jsx(Table.Td, { children: _jsx(Text, { size: "xs", c: "dimmed", children: entry.dirMtime ?? '—' }) }), _jsx(Table.Td, { children: _jsx(Tooltip, { label: purgeGate.tooltip, disabled: !purgeGate.disabled, children: _jsx("span", { children: _jsx(Button, { size: "xs", variant: "light", color: "red", disabled: purgeGate.disabled, "data-testid": `purge-dir-${entry.dirName}`, onClick: () => onPurge(entry.dirName), children: "Purge" }) }) }) })] }));
 }
-//# sourceMappingURL=SystemHealthPanel.js.map

package/dist/editor/admin/useSystemHealth.d.ts

@@ -1,5 +1,5 @@
-import type { AdminStatusData, AdminTasksData, ListAdminTasksParams, DeleteTaskParams } from '../../api/admin';
-import type { BranchHealthData } from '../../api/admin-branch-health';
+import type { AdminStatusData, AdminTasksData, ListAdminTasksParams, DeleteTaskParams } from '../../api/admin.js';
+import type { BranchHealthData } from '../../api/admin-branch-health.js';
 export type AdminTaskStatus = ListAdminTasksParams['status'];
 export type DeletableTaskStatus = DeleteTaskParams['status'];
 export interface UseSystemHealthOptions {
@@ -37,4 +37,3 @@ export interface UseSystemHealthReturn {
     markMerged: (branchName: string) => Promise<void>;
 }
 export declare function useSystemHealth(options: UseSystemHealthOptions): UseSystemHealthReturn;
-//# sourceMappingURL=useSystemHealth.d.ts.map

package/dist/editor/admin/useSystemHealth.js

@@ -202,4 +202,3 @@ export function useSystemHealth(options) {
         markMerged,
     };
 }
-//# sourceMappingURL=useSystemHealth.js.map

package/dist/editor/canopy-path.d.ts

@@ -14,4 +14,3 @@ export declare const parseCanopyPath: (path: string) => CanopyPathSegment[];
  * canonical bracketed representation.
  */
 export declare const normalizeCanopyPath: (input: string | CanopyPathSegment[]) => string;
-//# sourceMappingURL=canopy-path.d.ts.map

package/dist/editor/canopy-path.js

@@ -46,4 +46,3 @@ export const normalizeCanopyPath = (input) => {
     }
     return formatCanopyPath(parseCanopyPath(input));
 };
-//# sourceMappingURL=canopy-path.js.map

package/dist/editor/client-reference-resolver.d.ts

@@ -1,8 +1,18 @@
-import type { EntrySchema, FieldConfig } from '../config';
-import type { FormValue } from './FormRenderer';
+import type { EntrySchema, FieldConfig } from '../config/index.js';
+import type { FormValue } from './FormRenderer.js';
+import type { ApiClient } from './context/index.js';
 /**
  * Client-side utility for incrementally resolving reference fields in form data.
  * Used by FormRenderer to transform draft data before sending to preview.
+ *
+ * This module is a plain function file, not a hook/component -- it's invoked from inside a
+ * `setTimeout` callback in `useReferenceResolution`'s effect, well after that render has
+ * finished, where calling a React hook would violate the rules of hooks. So the API client
+ * can't be sourced here via `useApiClient()`/`useOptionalApiClient()` directly; instead every
+ * entry point takes an optional `apiClient`, which the caller (a hook, which CAN call
+ * `useOptionalApiClient()` during render) resolves and passes down. Falls back to a
+ * default-configured `createApiClient()` when no client is supplied, so direct callers/tests
+ * that predate this DI path keep working unchanged.
  */
 /**
  * Find which fields changed between two form values.
@@ -14,5 +24,4 @@ export declare function findChangedFields(prevValue: FormValue, currentValue: Fo
  * Only resolves reference fields that have changed.
  * Uses cache to avoid duplicate API calls.
  */
-export declare function resolveChangedReferences(prevValue: FormValue, currentValue: FormValue, schema: EntrySchema, branch: string, cache: Map<string, unknown>): Promise<Partial<FormValue>>;
-//# sourceMappingURL=client-reference-resolver.d.ts.map
+export declare function resolveChangedReferences(prevValue: FormValue, currentValue: FormValue, schema: EntrySchema, branch: string, cache: Map<string, unknown>, apiClient?: ApiClient): Promise<Partial<FormValue>>;

package/dist/editor/client-reference-resolver.js

@@ -3,6 +3,15 @@ import { flattenGroupFields } from '../utils/flatten-group-fields.js';
 /**
  * Client-side utility for incrementally resolving reference fields in form data.
  * Used by FormRenderer to transform draft data before sending to preview.
+ *
+ * This module is a plain function file, not a hook/component -- it's invoked from inside a
+ * `setTimeout` callback in `useReferenceResolution`'s effect, well after that render has
+ * finished, where calling a React hook would violate the rules of hooks. So the API client
+ * can't be sourced here via `useApiClient()`/`useOptionalApiClient()` directly; instead every
+ * entry point takes an optional `apiClient`, which the caller (a hook, which CAN call
+ * `useOptionalApiClient()` during render) resolves and passes down. Falls back to a
+ * default-configured `createApiClient()` when no client is supplied, so direct callers/tests
+ * that predate this DI path keep working unchanged.
  */
 /**
  * Find which fields changed between two form values.
@@ -25,7 +34,7 @@ export function findChangedFields(prevValue, currentValue, schema) {
  * Only resolves reference fields that have changed.
  * Uses cache to avoid duplicate API calls.
  */
-export async function resolveChangedReferences(prevValue, currentValue, schema, branch, cache) {
+export async function resolveChangedReferences(prevValue, currentValue, schema, branch, cache, apiClient) {
     const changedFields = findChangedFields(prevValue, currentValue, schema);
     const updates = {};
     for (const field of changedFields) {
@@ -35,12 +44,12 @@ export async function resolveChangedReferences(prevValue, currentValue, schema,
             // Resolve this field's value
             if (refField.list && Array.isArray(fieldValue)) {
                 // List of references
-                const resolved = await Promise.all(fieldValue.map((id) => resolveReferenceId(id, branch, cache)));
+                const resolved = await Promise.all(fieldValue.map((id) => resolveReferenceId(id, branch, cache, apiClient)));
                 updates[field.name] = resolved;
             }
             else if (fieldValue) {
                 // Single reference
-                const resolved = await resolveReferenceId(fieldValue, branch, cache);
+                const resolved = await resolveReferenceId(fieldValue, branch, cache, apiClient);
                 updates[field.name] = resolved;
             }
         }
@@ -52,7 +61,7 @@ export async function resolveChangedReferences(prevValue, currentValue, schema,
  * Checks cache first, then makes API call if needed.
  * Returns original ID if resolution fails.
  */
-async function resolveReferenceId(id, branch, cache) {
+async function resolveReferenceId(id, branch, cache, apiClient) {
     // Only resolve string IDs
     if (typeof id !== 'string') {
         return id;
@@ -67,9 +76,11 @@ async function resolveReferenceId(id, branch, cache) {
         return cache.get(cacheKey);
     }
     try {
-        // Fetch from API (single ID)
-        const apiClient = createApiClient();
-        const result = await apiClient.content.resolveReferences({ branch }, { ids: [id] });
+        // Fetch from API (single ID) -- use the caller-supplied (context-sourced) client when
+        // available, so requests carry the deployment's configured basePath; fall back to a
+        // default-configured client for direct callers that don't have one to hand.
+        const client = apiClient ?? createApiClient();
+        const result = await client.content.resolveReferences({ branch }, { ids: [id] });
         if (result.ok && result.data && result.data.resolved[id]) {
             // Cache and return resolved object
             const resolved = result.data.resolved[id];
@@ -85,4 +96,3 @@ async function resolveReferenceId(id, branch, cache) {
         return id;
     }
 }
-//# sourceMappingURL=client-reference-resolver.js.map

package/dist/editor/comments/BranchComments.d.ts

@@ -1,6 +1,6 @@
 import React from 'react';
-import type { CommentThread } from '../../comment-store';
-import type { UserSearchResult } from '../../auth/types';
+import type { CommentThread } from '../../comment-store.js';
+import type { UserSearchResult } from '../../auth/types.js';
 export interface BranchCommentsProps {
     /** All comments (will be filtered for branch-level) */
     comments: CommentThread[];
@@ -24,4 +24,3 @@ export interface BranchCommentsProps {
  * Uses ThreadCarousel for navigation.
  */
 export declare const BranchComments: React.FC<BranchCommentsProps>;
-//# sourceMappingURL=BranchComments.d.ts.map

package/dist/editor/comments/BranchComments.js

@@ -23,4 +23,3 @@ export const BranchComments = ({ comments, currentUserId, canResolve, onAddComme
     }
     return (_jsx(ThreadCarousel, { threads: branchThreads, label: "Branch Discussion", contextType: "branch", currentUserId: currentUserId, canResolve: canResolve, onAddComment: handleAddComment, onResolveThread: onResolveThread, autoFocus: autoFocus, autoOpenNewThread: showCarousel && branchThreads.length === 0, highlightThreadId: highlightThreadId, onGetUserMetadata: onGetUserMetadata }));
 };
-//# sourceMappingURL=BranchComments.js.map

package/dist/editor/comments/EntryComments.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import type { CommentThread } from '../../comment-store';
+import type { CommentThread } from '../../comment-store.js';
 export interface EntryCommentsProps {
     /** All comments (will be filtered for entry-level) */
     comments: CommentThread[];
@@ -23,4 +23,3 @@ export interface EntryCommentsProps {
  * Uses ThreadCarousel for navigation.
  */
 export declare const EntryComments: React.FC<EntryCommentsProps>;
-//# sourceMappingURL=EntryComments.d.ts.map

package/dist/editor/comments/EntryComments.js

@@ -23,4 +23,3 @@ export const EntryComments = ({ comments, entryPath, currentUserId, canResolve,
     }
     return (_jsx(ThreadCarousel, { threads: entryThreads, label: "Entry Comments", contextType: "entry", currentUserId: currentUserId, canResolve: canResolve, onAddComment: handleAddComment, onResolveThread: onResolveThread, autoFocus: autoFocus, autoOpenNewThread: showCarousel && entryThreads.length === 0, highlightThreadId: highlightThreadId }));
 };
-//# sourceMappingURL=EntryComments.js.map

package/dist/editor/comments/FieldWrapper.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import type { CommentThread } from '../../comment-store';
+import type { CommentThread } from '../../comment-store.js';
 export interface FieldWrapperProps {
     /** Child form field element */
     children: React.ReactNode;
@@ -29,4 +29,3 @@ export interface FieldWrapperProps {
  * Shows ThreadCarousel when comments exist or when user clicks "New comment".
  */
 export declare const FieldWrapper: React.FC<FieldWrapperProps>;
-//# sourceMappingURL=FieldWrapper.d.ts.map

package/dist/editor/comments/FieldWrapper.js

@@ -38,4 +38,3 @@ export const FieldWrapper = ({ children, canopyPath, entryPath, threads, autoFoc
                     zIndex: 1,
                 }, children: _jsx(Button, { size: "xs", variant: "subtle", color: "gray", onClick: () => setShowCarousel(true), style: { fontSize: '0.75rem', height: '1.5rem' }, "data-testid": `field-new-comment-${canopyPath}`, children: "New comment" }) })), shouldShowCarousel && (_jsx(ThreadCarousel, { threads: threads, contextType: "field", currentUserId: currentUserId, canResolve: canResolve, onAddComment: handleAddComment, onResolveThread: onResolveThread, autoFocus: autoFocus, autoOpenNewThread: showCarousel && threads.length === 0, highlightThreadId: highlightThreadId, onCancelNewThread: () => setShowCarousel(false) }))] }));
 };
-//# sourceMappingURL=FieldWrapper.js.map

package/dist/editor/comments/InlineCommentThread.d.ts

@@ -1,6 +1,6 @@
 import React from 'react';
-import type { CommentThread } from '../../comment-store';
-import type { UserSearchResult } from '../../auth/types';
+import type { CommentThread } from '../../comment-store.js';
+import type { UserSearchResult } from '../../auth/types.js';
 export interface InlineCommentThreadProps {
     /** The thread to display */
     thread: CommentThread;
@@ -20,4 +20,3 @@ export interface InlineCommentThreadProps {
  * Always shows full thread view with per-thread scrolling.
  */
 export declare const InlineCommentThread: React.FC<InlineCommentThreadProps>;
-//# sourceMappingURL=InlineCommentThread.d.ts.map

package/dist/editor/comments/InlineCommentThread.js

@@ -60,4 +60,3 @@ export const InlineCommentThread = ({ thread, onAddReply, onResolve, currentUser
                                     marginBottom: 8,
                                 } })), _jsxs(Stack, { gap: 4, children: [_jsxs(Group, { gap: "xs", justify: "space-between", children: [onGetUserMetadata ? (_jsx(UserBadge, { userId: comment.userId, getUserMetadata: onGetUserMetadata, variant: "avatar-name", size: "xs", showEmailTooltip: true, showBadge: true, badgeVariant: "light", color: "gray" })) : (_jsx(Text, { size: "xs", fw: 600, children: comment.userId })), _jsx(Text, { size: "xs", c: "dimmed", children: formatRelativeTime(comment.timestamp) })] }), _jsx(Text, { size: "sm", style: { whiteSpace: 'pre-wrap' }, children: comment.text })] })] }, comment.id))) }), error && (_jsx(Alert, { icon: _jsx(IconAlertCircle, { size: 16 }), color: "red", variant: "light", onClose: () => setError(null), withCloseButton: true, children: error })), !thread.resolved && (_jsxs(Stack, { gap: "xs", children: [_jsx(Textarea, { placeholder: "Write a reply...", value: replyText, onChange: (e) => setReplyText(e.target.value), minRows: 2, disabled: isSubmitting }), _jsxs(Group, { gap: "xs", children: [_jsx(Button, { size: "xs", onClick: handleReply, loading: isSubmitting, disabled: !replyText.trim(), children: "Reply" }), canUserResolve() && (_jsx(Button, { size: "xs", variant: "light", color: "green", onClick: handleResolve, loading: isSubmitting, "data-testid": "resolve-thread-button", children: "Resolve" }))] })] })), thread.resolved && thread.resolvedBy && (_jsxs(Group, { gap: 4, children: [_jsx(Text, { size: "xs", c: "dimmed", fs: "italic", children: "Resolved by" }), onGetUserMetadata ? (_jsx(UserBadge, { userId: thread.resolvedBy, getUserMetadata: onGetUserMetadata, variant: "avatar-name", size: "xs", showEmailTooltip: true, showBadge: true, badgeVariant: "light", color: "gray" })) : (_jsx(Text, { size: "xs", c: "dimmed", fs: "italic", children: thread.resolvedBy })), thread.resolvedAt && (_jsx(Text, { size: "xs", c: "dimmed", fs: "italic", children: formatRelativeTime(thread.resolvedAt) }))] }))] }) }));
 };
-//# sourceMappingURL=InlineCommentThread.js.map

package/dist/editor/comments/ThreadCarousel.d.ts

@@ -1,6 +1,6 @@
 import React from 'react';
-import type { CommentThread } from '../../comment-store';
-import type { UserSearchResult } from '../../auth/types';
+import type { CommentThread } from '../../comment-store.js';
+import type { UserSearchResult } from '../../auth/types.js';
 /**
  * ThreadCarousel - Horizontal comment thread navigation component
  *
@@ -109,4 +109,3 @@ export interface ThreadCarouselProps {
     onCancelNewThread?: () => void;
 }
 export declare const ThreadCarousel: React.FC<ThreadCarouselProps>;
-//# sourceMappingURL=ThreadCarousel.d.ts.map

package/dist/editor/comments/ThreadCarousel.js

@@ -223,4 +223,3 @@ export const ThreadCarousel = ({ threads, label = 'Comments', contextType: _, cu
                                     background: 'var(--mantine-color-gray-5)',
                                 } }) })] })), sortedThreads.length === 0 && !showNewThreadBox && (_jsx(Text, { size: "xs", c: "dimmed", ta: "center", py: "xs", children: "No comments yet. Click \"+ New\" to start a thread." }))] }) }));
 };
-//# sourceMappingURL=ThreadCarousel.js.map

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

@@ -12,4 +12,3 @@ export interface ConfirmDeleteModalProps {
  * Provides a clear warning UI with red/danger theme.
  */
 export declare function ConfirmDeleteModal({ isOpen, title, message, confirmLabel, onConfirm, onClose, loading, }: ConfirmDeleteModalProps): import("react/jsx-runtime").JSX.Element;
-//# sourceMappingURL=ConfirmDeleteModal.d.ts.map

package/dist/editor/components/ConfirmDeleteModal.js

@@ -8,4 +8,3 @@ import { Modal, Button, Text, Group, Stack } from '@mantine/core';
 export function ConfirmDeleteModal({ isOpen, title, message, confirmLabel = 'Delete', onConfirm, onClose, loading = false, }) {
     return (_jsx(Modal, { opened: isOpen, onClose: onClose, title: title, centered: true, size: "md", children: _jsxs(Stack, { gap: "md", "data-testid": "confirm-delete-modal", children: [_jsx(Text, { size: "sm", children: message }), _jsxs(Group, { justify: "flex-end", gap: "sm", children: [_jsx(Button, { variant: "default", onClick: onClose, disabled: loading, children: "Cancel" }), _jsx(Button, { color: "red", onClick: onConfirm, loading: loading, "data-testid": "confirm-delete-submit", children: confirmLabel })] })] }) }));
 }
-//# sourceMappingURL=ConfirmDeleteModal.js.map

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

@@ -17,4 +17,3 @@ export interface EditorFooterProps {
  * ```
  */
 export declare function EditorFooter({ children }: EditorFooterProps): import("react/jsx-runtime").JSX.Element;
-//# sourceMappingURL=EditorFooter.d.ts.map