@aphexcms/cms-core 6.0.0 → 8.0.0

package/dist/components/admin/fields/ReferenceField.svelte

@@ -1,31 +1,45 @@
 <script lang="ts">
 	import CheckIcon from '@lucide/svelte/icons/check';
 	import PlusIcon from '@lucide/svelte/icons/plus';
-	import { tick } from 'svelte';
 	import * as Command from '@aphexcms/ui/shadcn/command';
-	import * as Popover from '@aphexcms/ui/shadcn/popover';
 	import * as DropdownMenu from '@aphexcms/ui/shadcn/dropdown-menu';
 	import { Button } from '@aphexcms/ui/shadcn/button';
+	import { Input } from '@aphexcms/ui/shadcn/input';
 	import { cn } from '@aphexcms/ui/utils';
-	import { ExternalLink, Ellipsis, Trash2, FileText } from '@lucide/svelte';
+	import { ChevronDown, ExternalLink, Ellipsis, Trash2, FileText } from '@lucide/svelte';
 	import type { Field, ReferenceField as ReferenceFieldType } from '../../../types/schemas';
 	import { documents } from '../../../api/documents';
 	import { getSchemaContext } from '../../../schema-context.svelte';
 	import { getSchemaByName } from '../../../schema-utils/utils';
 	import { toast } from 'svelte-sonner';
-	import { cmsLogger } from '../../../utils/logger';
 	import { pluralize } from '../../../utils/pluralize';
 	import { resolvePreviewTitle, resolvePreviewSubtitle } from '../../../utils/preview';
+	import { getDocumentVersion } from '../../../document-refresh.svelte';
+
+	type ReferenceValue = { _type: 'reference'; _ref: string; _key?: string };
 
 	interface Props {
 		field: Field;
-		value: string | null; // Document ID
-		onUpdate: (value: string | null) => void;
+		value: ReferenceValue | null; // Reference wrapper — singular and array share this shape
+		onUpdate: (value: ReferenceValue | null) => void;
 		onOpenReference?: (documentId: string, documentType: string) => void;
 		readonly?: boolean;
+		onRemove?: () => void; // When set, the "Remove" menu item calls this instead of clearing the value (used by array-of-references rows)
+		preloadedDoc?: unknown; // When provided AND its id matches `value._ref`, skip the per-row getById and use this doc as `selectedDocument` (used by ArrayField to batch-hydrate reference rows in one HTTP call)
 	}
 
-	let { field, value, onUpdate, onOpenReference, readonly = false }: Props = $props();
+	let {
+		field,
+		value,
+		onUpdate,
+		onOpenReference,
+		readonly = false,
+		onRemove,
+		preloadedDoc
+	}: Props = $props();
+
+	// Pull the target ID off the wrapper (or null when nothing's selected).
+	const refId = $derived(value?._ref ?? null);
 
 	// Cast to reference field type
 	const referenceField = field as ReferenceFieldType;
@@ -41,14 +55,26 @@
 	let selectedDocument = $state<any>(null);
 	let loading = $state(false);
 	let creating = $state(false);
-	let triggerRef = $state<HTMLButtonElement>(null!);
+	let query = $state('');
 
-	// Load selected document details when value changes
+	// Load selected document details when value changes — and re-load whenever
+	// the referenced document is saved elsewhere (the version counter bumps),
+	// so the row reflects edits made in a side-panel editor without needing
+	// the user to navigate away and back. When the parent (e.g. ArrayField)
+	// hands us a preloaded doc whose id matches `value`, use it directly and
+	// skip the network call.
 	$effect(() => {
+		const id = refId;
+		// Subscribe to the document's version so this effect re-fires on save.
+		getDocumentVersion(id);
+		if (id && preloadedDoc && (preloadedDoc as any).id === id) {
+			selectedDocument = preloadedDoc;
+			return;
+		}
 		async function loadDocument() {
-			if (value) {
+			if (id) {
 				try {
-					const doc = await documents.getById(value);
+					const doc = await documents.getById(id);
 					if (doc.success) {
 						selectedDocument = doc.data;
 					}
@@ -63,46 +89,84 @@
 		loadDocument();
 	});
 
-	// Load documents when dropdown opens
+	// Reset query whenever the popover closes so the next open starts empty.
 	$effect(() => {
-		async function loadDocuments() {
-			if (open && targetType) {
-				cmsLogger.debug(
-					'[ReferenceField] Opening select box, loading documents for type:',
-					targetType
-				);
-				loading = true;
-				try {
-					const result = await documents.list({
-						docType: targetType,
-						limit: 10
-					});
-					cmsLogger.debug('[ReferenceField] Documents loaded:', result);
-					if (result.success && result.data) {
-						searchResults = result.data;
-						cmsLogger.debug('[ReferenceField] Search results:', searchResults.length, 'documents');
-					}
-				} catch (err) {
-					toast.error('Failed to load documents');
-					searchResults = [];
-				} finally {
-					loading = false;
-				}
+		if (!open) {
+			query = '';
+			searchResults = [];
+		}
+	});
+
+	// All docs cache — fetched once when the dropdown opens, reused for
+	// empty-query browsing and client-side filtering while typing.
+	let allDocs = $state<any[]>([]);
+	let allDocsFetched = $state(false);
+
+	async function fetchAllDocs() {
+		if (allDocsFetched || !targetType) return;
+		loading = true;
+		try {
+			const result = await documents.list({ docType: targetType, limit: 20 });
+			if (result.success && result.data) {
+				allDocs = result.data;
 			}
+		} catch {
+			toast.error('Failed to load documents');
+		} finally {
+			allDocsFetched = true;
+			loading = false;
+		}
+	}
+
+	// Fetch docs when dropdown opens; reset cache when it closes.
+	$effect(() => {
+		if (open) {
+			fetchAllDocs();
+		} else {
+			query = '';
+			searchResults = [];
+			allDocs = [];
+			allDocsFetched = false;
 		}
-		loadDocuments();
+	});
+
+	// Filter results client-side as the user types. Empty query shows all.
+	$effect(() => {
+		const q = query.trim().toLowerCase();
+		if (!open) return;
+		if (!q) {
+			searchResults = allDocs;
+			return;
+		}
+		searchResults = allDocs.filter((doc: any) => {
+			const title = resolvePreviewTitle(doc, targetSchema).toLowerCase();
+			const subtitle = (resolvePreviewSubtitle(doc, targetSchema) ?? '').toLowerCase();
+			return title.includes(q) || subtitle.includes(q);
+		});
 	});
 
 	function closeAndFocusTrigger() {
 		open = false;
-		tick().then(() => {
-			triggerRef?.focus();
-		});
+	}
+
+	// Tiny click-outside action for the inline results dropdown — closes the
+	// dropdown when the user clicks anywhere outside the wrapper. Cheaper
+	// than reaching for a Popover and avoids the focus-stealing problem.
+	function clickOutside(node: HTMLElement, callback: () => void) {
+		function handle(e: MouseEvent) {
+			if (!node.contains(e.target as Node)) callback();
+		}
+		document.addEventListener('mousedown', handle);
+		return {
+			destroy() {
+				document.removeEventListener('mousedown', handle);
+			}
+		};
 	}
 
 	function selectDocument(doc: any) {
 		if (readonly) return;
-		onUpdate(doc.id);
+		onUpdate({ _type: 'reference', _ref: doc.id });
 		closeAndFocusTrigger();
 	}
 
@@ -125,13 +189,11 @@
 		try {
 			const result = await documents.create({
 				type: targetType,
-				data: {
-					title: 'Untitled'
-				}
+				data: {}
 			});
 
 			if (result.success && result.data) {
-				onUpdate(result.data.id);
+				onUpdate({ _type: 'reference', _ref: result.data.id });
 				closeAndFocusTrigger();
 			}
 		} catch (err) {
@@ -179,9 +241,9 @@
 					>
 				{/if}
 			</span>
-			{#if selectedDocument.status === 'published'}
+			{#if selectedDocument._meta?.status === 'published'}
 				<span class="h-1.5 w-1.5 shrink-0 rounded-full bg-green-500" title="Published"></span>
-			{:else if selectedDocument.status === 'unpublished'}
+			{:else if selectedDocument._meta?.status === 'unpublished'}
 				<span class="bg-muted-foreground/60 h-1.5 w-1.5 shrink-0 rounded-full" title="Unpublished"
 				></span>
 			{:else}
@@ -210,7 +272,7 @@
 					<DropdownMenu.Separator />
 					<DropdownMenu.Item
 						class="text-destructive focus:text-destructive"
-						onclick={clearSelection}
+						onclick={() => (onRemove ? onRemove() : clearSelection())}
 					>
 						<Trash2 class="mr-2 h-4 w-4" />
 						Remove
@@ -227,86 +289,97 @@
 		<p class="text-muted-foreground text-sm">No reference selected</p>
 	</div>
 {:else}
-	<!-- Empty state: dashed "Add reference" button that opens a search popover -->
-	<Popover.Root bind:open>
-		<Popover.Trigger bind:ref={triggerRef}>
-			{#snippet child({ props })}
+	<!-- Inline empty state: search input + chevron + Create button. The input
+	     is the primary focus target — the results dropdown is a sibling div
+	     positioned absolutely under the input wrapper, with click-outside
+	     closing it. No popover wrapping the input, so no double-click. -->
+	<div class="flex items-center gap-1">
+		<div class="relative min-w-0 flex-1" use:clickOutside={() => (open = false)}>
+			<div
+				class="border-input bg-background focus-within:ring-ring flex h-9 items-center rounded-md border focus-within:ring-1"
+			>
+				<Input
+					bind:value={query}
+					placeholder="Type to search..."
+					onfocus={() => (open = true)}
+					class="h-8 border-0 bg-transparent shadow-none focus-visible:ring-0"
+				/>
 				<button
-					{...props}
-					class="border-border/50 text-muted-foreground hover:text-foreground hover:bg-muted/50 flex h-10 w-full cursor-pointer items-center justify-center gap-2 rounded border border-dashed text-sm transition-colors"
-					role="combobox"
-					aria-expanded={open}
+					type="button"
+					onclick={() => (open = !open)}
+					class="text-muted-foreground hover:text-foreground flex h-8 w-8 shrink-0 items-center justify-center"
+					aria-label="Toggle results"
 				>
-					<PlusIcon class="h-4 w-4" />
-					Add {targetType || 'reference'}...
+					<ChevronDown class="h-4 w-4" />
 				</button>
-			{/snippet}
-		</Popover.Trigger>
-		<Popover.Content class="!z-[9999] w-[400px] p-0">
-			<Command.Root>
-				<Command.List>
-					{#if loading}
-						<Command.Loading>Loading...</Command.Loading>
-					{:else if searchResults.length === 0}
-						<Command.Empty>
-							<div class="flex flex-col items-center gap-2 py-4">
-								<p class="text-muted-foreground text-sm">
-									No {pluralize(targetType || '')} found
-								</p>
-								<Button size="sm" onclick={createNewDocument} disabled={creating} class="gap-1">
-									<PlusIcon class="h-3 w-3" />
-									{creating ? 'Creating...' : `Create new ${targetType}`}
-								</Button>
-							</div>
-						</Command.Empty>
-					{:else}
-						<Command.Group>
-							{#each searchResults as doc (doc.id)}
-								<Command.Item
-									value={doc.id}
-									onSelect={() => selectDocument(doc)}
-									class="flex items-center justify-between"
-								>
-									<div class="flex min-w-0 flex-1 items-center gap-2">
-										<CheckIcon
-											class={cn('h-4 w-4 shrink-0', value !== doc.id && 'text-transparent')}
-										/>
-										<span class="flex min-w-0 flex-1 flex-col">
-											<span class="truncate text-sm">{getDocumentTitle(doc)}</span>
-											{#if getDocumentSubtitle(doc)}
-												<span class="text-muted-foreground truncate text-xs"
-													>{getDocumentSubtitle(doc)}</span
-												>
-											{/if}
-										</span>
+			</div>
+			{#if open}
+				<div
+					class="bg-popover text-popover-foreground absolute top-full left-0 z-[9999] mt-1 w-[400px] max-w-[min(400px,calc(100vw-2rem))] rounded-md border p-0 shadow-md"
+				>
+					<Command.Root shouldFilter={false}>
+						<Command.List class="max-h-[300px] overflow-y-auto">
+							{#if loading}
+								<Command.Loading>Loading...</Command.Loading>
+							{:else if searchResults.length === 0}
+								<Command.Empty>
+									<div class="text-muted-foreground py-4 text-center text-sm">
+										{query.trim()
+											? `No ${pluralize(targetType || '')} match "${query}"`
+											: `No ${pluralize(targetType || '')} found`}
 									</div>
-									{#if doc.status === 'published'}
-										<span class="h-1.5 w-1.5 shrink-0 rounded-full bg-green-500" title="Published"
-										></span>
-									{:else if doc.status === 'unpublished'}
-										<span
-											class="bg-muted-foreground/60 h-1.5 w-1.5 shrink-0 rounded-full"
-											title="Unpublished"
-										></span>
-									{:else}
-										<span class="h-1.5 w-1.5 shrink-0 rounded-full bg-amber-500" title="Draft"
-										></span>
-									{/if}
-								</Command.Item>
-							{/each}
-						</Command.Group>
-						<Command.Separator />
-						<Command.Group>
-							<Command.Item onSelect={createNewDocument} class="justify-center">
-								<div class="flex items-center gap-1">
-									<PlusIcon class="h-3 w-3" />
-									{creating ? 'Creating...' : `Create new ${targetType}`}
-								</div>
-							</Command.Item>
-						</Command.Group>
-					{/if}
-				</Command.List>
-			</Command.Root>
-		</Popover.Content>
-	</Popover.Root>
+								</Command.Empty>
+							{:else}
+								<Command.Group>
+									{#each searchResults as doc (doc.id)}
+										<Command.Item
+											value={doc.id}
+											onSelect={() => selectDocument(doc)}
+											class="flex items-center justify-between"
+										>
+											<div class="flex min-w-0 flex-1 items-center gap-2">
+												<CheckIcon
+													class={cn('h-4 w-4 shrink-0', refId !== doc.id && 'text-transparent')}
+												/>
+												<span class="flex min-w-0 flex-1 flex-col">
+													<span class="truncate text-sm">{getDocumentTitle(doc)}</span>
+													{#if getDocumentSubtitle(doc)}
+														<span class="text-muted-foreground truncate text-xs"
+															>{getDocumentSubtitle(doc)}</span
+														>
+													{/if}
+												</span>
+											</div>
+											{#if doc._meta?.status === 'published'}
+												<span class="h-1.5 w-1.5 shrink-0 rounded-full bg-green-500" title="Published"
+												></span>
+											{:else if doc._meta?.status === 'unpublished'}
+												<span
+													class="bg-muted-foreground/60 h-1.5 w-1.5 shrink-0 rounded-full"
+													title="Unpublished"
+												></span>
+											{:else}
+												<span class="h-1.5 w-1.5 shrink-0 rounded-full bg-amber-500" title="Draft"
+												></span>
+											{/if}
+										</Command.Item>
+									{/each}
+								</Command.Group>
+							{/if}
+						</Command.List>
+					</Command.Root>
+				</div>
+			{/if}
+		</div>
+		<Button
+			variant="outline"
+			size="sm"
+			onclick={createNewDocument}
+			disabled={creating}
+			class="h-9 shrink-0 gap-1"
+		>
+			<PlusIcon class="h-4 w-4" />
+			{creating ? 'Creating...' : 'Create...'}
+		</Button>
+	</div>
 {/if}

package/dist/components/admin/fields/ReferenceField.svelte.d.ts

@@ -1,10 +1,17 @@
 import type { Field } from '../../../types/schemas.js';
+type ReferenceValue = {
+    _type: 'reference';
+    _ref: string;
+    _key?: string;
+};
 interface Props {
     field: Field;
-    value: string | null;
-    onUpdate: (value: string | null) => void;
+    value: ReferenceValue | null;
+    onUpdate: (value: ReferenceValue | null) => void;
     onOpenReference?: (documentId: string, documentType: string) => void;
     readonly?: boolean;
+    onRemove?: () => void;
+    preloadedDoc?: unknown;
 }
 declare const ReferenceField: import("svelte").Component<Props, {}, "">;
 type ReferenceField = ReturnType<typeof ReferenceField>;

package/dist/components/admin/fields/ReferenceField.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ReferenceField.svelte.d.ts","sourceRoot":"","sources":["../../../../src/lib/components/admin/fields/ReferenceField.svelte.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,KAAK,EAAwC,MAAM,wBAAwB,CAAC;AAUzF,UAAU,KAAK;IACd,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACzC,eAAe,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;IACrE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAiRF,QAAA,MAAM,cAAc,2CAAwC,CAAC;AAC7D,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AACxD,eAAe,cAAc,CAAC"}
+{"version":3,"file":"ReferenceField.svelte.d.ts","sourceRoot":"","sources":["../../../../src/lib/components/admin/fields/ReferenceField.svelte.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,KAAK,EAAwC,MAAM,wBAAwB,CAAC;AAUzF,KAAK,cAAc,GAAG;IAAE,KAAK,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1E,UAAU,KAAK;IACd,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,cAAc,GAAG,IAAI,CAAC;IAC7B,QAAQ,EAAE,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,KAAK,IAAI,CAAC;IACjD,eAAe,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;IACrE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB;AAqUF,QAAA,MAAM,cAAc,2CAAwC,CAAC;AAC7D,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AACxD,eAAe,cAAc,CAAC"}

package/dist/components/layout/Sidebar.svelte

@@ -49,7 +49,7 @@
 </script>
 
 <ModeWatcher />
-<Toaster />
+<Toaster closeButton />
 <SidebarProvider class="h-screen">
 	<AppSidebar {data} {onSignOut} />
 	<SidebarInset class="flex h-full min-w-0 flex-col">

package/dist/components/layout/sidebar/AppSidebar.svelte

@@ -31,7 +31,8 @@
 				title: 'Content',
 				url: '/admin',
 				icon: undefined,
-				isActive: false
+				isActive: false,
+				exact: true
 			}
 		]
 	);

package/dist/components/layout/sidebar/AppSidebar.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AppSidebar.svelte.d.ts","sourceRoot":"","sources":["../../../../src/lib/components/layout/sidebar/AppSidebar.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,OAAO,EAKP,MAAM,6BAA6B,CAAC;AAItC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAG5C,KAAK,KAAK,GAAG,cAAc,CAAC,OAAO,OAAO,CAAC,GAAG;IAC7C,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC,CAAC;AAqDH,QAAA,MAAM,UAAU,2CAAwC,CAAC;AACzD,KAAK,UAAU,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;AAChD,eAAe,UAAU,CAAC"}
+{"version":3,"file":"AppSidebar.svelte.d.ts","sourceRoot":"","sources":["../../../../src/lib/components/layout/sidebar/AppSidebar.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,OAAO,EAKP,MAAM,6BAA6B,CAAC;AAItC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAG5C,KAAK,KAAK,GAAG,cAAc,CAAC,OAAO,OAAO,CAAC,GAAG;IAC7C,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC,CAAC;AAsDH,QAAA,MAAM,UAAU,2CAAwC,CAAC;AACzD,KAAK,UAAU,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;AAChD,eAAe,UAAU,CAAC"}

package/dist/components/layout/sidebar/NavMain.svelte

@@ -19,6 +19,7 @@
 		url: string;
 		icon?: typeof IconType;
 		isActive?: boolean;
+		exact?: boolean;
 		items?: {
 			title: string;
 			url: string;
@@ -28,9 +29,15 @@
 	type Props = {
 		items: NavItem[];
 		label?: string;
+		isActive?: (path: string, item: NavItem) => boolean;
 	};
 
-	let { items, label = 'Content' }: Props = $props();
+	let { items, label = 'Content', isActive: isActiveProp }: Props = $props();
+
+	function matchActive(item: NavItem): boolean {
+		if (isActiveProp) return isActiveProp(currentPath, item);
+		return item.exact ? currentPath === item.url : currentPath.startsWith(item.url);
+	}
 
 	let currentPath = $derived(page.url.pathname);
 </script>
@@ -79,7 +86,7 @@
 				<SidebarMenuItem>
 					<SidebarMenuButton
 						onclick={() => goto(item.url)}
-						isActive={currentPath.startsWith(item.url)}
+						isActive={matchActive(item)}
 						tooltipContent={item.title}
 						class="cursor-pointer"
 					>

package/dist/components/layout/sidebar/NavMain.svelte.d.ts

@@ -4,6 +4,7 @@ type NavItem = {
     url: string;
     icon?: typeof IconType;
     isActive?: boolean;
+    exact?: boolean;
     items?: {
         title: string;
         url: string;
@@ -12,6 +13,7 @@ type NavItem = {
 type Props = {
     items: NavItem[];
     label?: string;
+    isActive?: (path: string, item: NavItem) => boolean;
 };
 declare const NavMain: import("svelte").Component<Props, {}, "">;
 type NavMain = ReturnType<typeof NavMain>;

package/dist/components/layout/sidebar/NavMain.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NavMain.svelte.d.ts","sourceRoot":"","sources":["../../../../src/lib/components/layout/sidebar/NavMain.svelte.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAgB,KAAK,IAAI,IAAI,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAGpE,KAAK,OAAO,GAAG;IACd,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,OAAO,QAAQ,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;KACZ,EAAE,CAAC;CACJ,CAAC;AAEF,KAAK,KAAK,GAAG;IACZ,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAsEH,QAAA,MAAM,OAAO,2CAAwC,CAAC;AACtD,KAAK,OAAO,GAAG,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC;AAC1C,eAAe,OAAO,CAAC"}
+{"version":3,"file":"NavMain.svelte.d.ts","sourceRoot":"","sources":["../../../../src/lib/components/layout/sidebar/NavMain.svelte.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAgB,KAAK,IAAI,IAAI,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAGpE,KAAK,OAAO,GAAG;IACd,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,OAAO,QAAQ,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;KACZ,EAAE,CAAC;CACJ,CAAC;AAEF,KAAK,KAAK,GAAG;IACZ,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC;CACpD,CAAC;AA2EH,QAAA,MAAM,OAAO,2CAAwC,CAAC;AACtD,KAAK,OAAO,GAAG,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC;AAC1C,eAAe,OAAO,CAAC"}

package/dist/db/interfaces/index.d.ts

@@ -5,6 +5,7 @@ import type { SchemaAdapter } from './schema.js';
 import type { OrganizationAdapter } from './organization.js';
 import type { InstanceAdapter } from './instance.js';
 import type { RolesAdapter } from './role.js';
+import type { ReferenceAdapter } from './reference.js';
 export type { DocumentAdapter, DocumentFilters, CreateDocumentData, UpdateDocumentData } from './document.js';
 export type { AssetAdapter, CreateAssetData, UpdateAssetData } from './asset.js';
 export type { UserProfileAdapter, NewUserProfileData } from './user.js';
@@ -12,11 +13,12 @@ export type { SchemaAdapter } from './schema.js';
 export type { OrganizationAdapter } from './organization.js';
 export type { InstanceAdapter, InstanceSettings } from './instance.js';
 export type { RolesAdapter } from './role.js';
+export type { ReferenceAdapter, BackReferenceRow, BackReferenceLookup } from './reference.js';
 /**
  * Combined database adapter interface
  * Extends all entity-specific adapters for full database functionality
  */
-export interface DatabaseAdapter extends DocumentAdapter, AssetAdapter, UserProfileAdapter, SchemaAdapter, OrganizationAdapter, InstanceAdapter, RolesAdapter {
+export interface DatabaseAdapter extends DocumentAdapter, AssetAdapter, UserProfileAdapter, SchemaAdapter, OrganizationAdapter, InstanceAdapter, RolesAdapter, ReferenceAdapter {
     connect?(): Promise<void>;
     disconnect?(): Promise<void>;
     isHealthy(): Promise<boolean>;

package/dist/db/interfaces/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/db/interfaces/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/db/interfaces/index.ts"],"names":[],"mappings":"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"}

package/dist/db/interfaces/reference.d.ts

@@ -0,0 +1,43 @@
+export interface BackReferenceRow {
+    id: string;
+    type: string;
+    status: string | null;
+}
+export interface BackReferenceLookup extends BackReferenceRow {
+    refId: string;
+}
+export interface ReferenceAdapter {
+    /**
+     * Replace all back-reference rows for a given referencer atomically.
+     * Called by the references service after every doc save with the full
+     * set of refs extracted from the doc's data.
+     */
+    replaceReferencesFor(organizationId: string, referencerId: string, refIds: string[]): Promise<void>;
+    /**
+     * Find all documents that reference the given target. Joins through the
+     * documents table so callers get type/status without a second round-trip.
+     */
+    findBackReferences(organizationId: string, refId: string): Promise<BackReferenceRow[]>;
+    /**
+     * Bulk variant of findBackReferences — returns all back-refs for a set
+     * of target IDs, with `refId` included so callers can group by target.
+     */
+    findBackReferencesForMany(organizationId: string, refIds: string[]): Promise<BackReferenceLookup[]>;
+    /**
+     * Whether the references table has any rows for this organization.
+     * Used by the boot path to decide whether a one-time backfill is needed.
+     */
+    hasAnyReferences(organizationId: string): Promise<boolean>;
+    /**
+     * Bulk insert variant for the backfill path. Single INSERT for all rows
+     * — caller is responsible for ensuring the table is empty for this org
+     * (no DELETE step). Adapter implementations should ignore conflicts so
+     * the operation is idempotent if called twice.
+     */
+    bulkInsertReferences(rows: Array<{
+        organizationId: string;
+        referencerId: string;
+        refId: string;
+    }>): Promise<void>;
+}
+//# sourceMappingURL=reference.d.ts.map

package/dist/db/interfaces/reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference.d.ts","sourceRoot":"","sources":["../../../src/lib/db/interfaces/reference.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,gBAAgB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;IAC5D,KAAK,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAChC;;;;OAIG;IACH,oBAAoB,CACnB,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,EAAE,GACd,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;OAGG;IACH,kBAAkB,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAEvF;;;OAGG;IACH,yBAAyB,CACxB,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,MAAM,EAAE,GACd,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAElC;;;OAGG;IACH,gBAAgB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE3D;;;;;OAKG;IACH,oBAAoB,CACnB,IAAI,EAAE,KAAK,CAAC;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,GAC1E,OAAO,CAAC,IAAI,CAAC,CAAC;CACjB"}

package/dist/db/interfaces/reference.js

@@ -0,0 +1,4 @@
+// Back-reference index for the publish/unpublish integrity guards. Adapters
+// that implement this maintain a (referencer_id, ref_id) table that the
+// references service in cms-core repopulates after every save.
+export {};

package/dist/db/utils/reference-resolver.d.ts

@@ -6,12 +6,10 @@ interface ResolveOptions {
     visited?: Set<string>;
 }
 /**
- * Recursively resolves reference fields in a document
- * @param document - The document to resolve references for
- * @param adapter - Document adapter for fetching referenced documents
- * @param organizationId - Organization ID for filtering referenced documents
- * @param options - Resolution options (depth, tracking)
- * @returns Document with resolved references
+ * Recursively resolves reference fields in a document. Both singular and
+ * array refs share the on-disk shape `{ _type: 'reference', _ref }`, so the
+ * resolver finds them by that marker and replaces the entire object with
+ * the fetched document.
  */
 export declare function resolveReferences(document: Document, adapter: DocumentAdapter, organizationId: string, options: ResolveOptions): Promise<Document>;
 export {};

package/dist/db/utils/reference-resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reference-resolver.d.ts","sourceRoot":"","sources":["../../../src/lib/db/utils/reference-resolver.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D,UAAU,cAAc;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACtC,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,eAAe,EACxB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,cAAc,GACrB,OAAO,CAAC,QAAQ,CAAC,CA2CnB"}
+{"version":3,"file":"reference-resolver.d.ts","sourceRoot":"","sources":["../../../src/lib/db/utils/reference-resolver.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D,UAAU,cAAc;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACtC,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,eAAe,EACxB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,cAAc,GACrB,OAAO,CAAC,QAAQ,CAAC,CA2CnB"}