@aphexcms/cms-core 5.0.5 → 6.0.0

package/dist/components/AdminApp.svelte

@@ -13,6 +13,7 @@
 	import { SvelteURLSearchParams } from 'svelte/reactivity';
 	import type { SchemaType } from '../types/index';
 	import type { UserSessionPreferences } from '../types/organization';
+	import { resolvePreviewTitle, resolvePreviewSubtitle } from '../utils/preview';
 	import DocumentEditor from './admin/DocumentEditor.svelte';
 	import DocumentVersionPanel from './admin/DocumentVersionPanel.svelte';
 	import DocumentsSkeleton from './admin/DocumentsSkeleton.svelte';
@@ -912,20 +913,13 @@
 				}
 				// Find schema for preview config
 				const schema = schemas.find((s) => s.name === docType);
-				const previewConfig = schema?.preview;
 
 				documentsList = result.data.map((doc: any) => {
 					// With LocalAPI, data is already flattened at top level (not in draftData)
 					// The document itself IS the data, with _meta containing metadata
 
-					// Use preview config if available
-					const title = previewConfig?.select?.title
-						? doc[previewConfig.select.title] || `Untitled`
-						: doc.title || `Untitled`;
-
-					const subtitle = previewConfig?.select?.subtitle
-						? doc[previewConfig.select.subtitle]
-						: undefined;
+					const title = resolvePreviewTitle(doc, schema);
+					const subtitle = resolvePreviewSubtitle(doc, schema) ?? undefined;
 
 					// Metadata is in _meta field (from LocalAPI transformation)
 					const meta = doc._meta || {};

package/dist/components/AdminApp.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AdminApp.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/components/AdminApp.svelte.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AA2BnE,UAAU,KAAK;IACd,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,aAAa,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5E,WAAW,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IACvE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,CAAC,EAAE;QAAE,KAAK,EAAE,WAAW,GAAG,QAAQ,GAAG,OAAO,CAAA;KAAE,CAAC;IACxD,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,eAAe,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAAC;CAChD;AAggDF,QAAA,MAAM,QAAQ,2CAAwC,CAAC;AACvD,KAAK,QAAQ,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC;AAC5C,eAAe,QAAQ,CAAC"}
+{"version":3,"file":"AdminApp.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/components/AdminApp.svelte.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AA4BnE,UAAU,KAAK;IACd,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,aAAa,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5E,WAAW,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IACvE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,CAAC,EAAE;QAAE,KAAK,EAAE,WAAW,GAAG,QAAQ,GAAG,OAAO,CAAA;KAAE,CAAC;IACxD,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,eAAe,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAAC;CAChD;AA0/CF,QAAA,MAAM,QAAQ,2CAAwC,CAAC;AACvD,KAAK,QAAQ,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC;AAC5C,eAAe,QAAQ,CAAC"}

package/dist/components/admin/AssetBrowserModal.svelte

@@ -39,7 +39,8 @@
 <Dialog.Root bind:open {onOpenChange}>
 	<Dialog.Content
 		showCloseButton={false}
-		class="flex h-[95vh] max-w-[95vw] flex-col overflow-hidden p-0 sm:max-w-[95vw]"
+		class="!z-[9999] flex h-[95vh] max-w-[95vw] flex-col overflow-hidden p-0 sm:max-w-[95vw]"
+		overlayClass="!z-[9998]"
 	>
 		<Dialog.Header class="sr-only">
 			<Dialog.Title>{multiSelect ? 'Select Assets' : 'Select Asset'}</Dialog.Title>

package/dist/components/admin/DocumentEditor.svelte

@@ -293,12 +293,16 @@
 		(hasUnpublishedContent || isUnpublished) && !saving && documentId && !hasValidationErrors
 	);
 
-	// Get preview title based on schema config
+	// Get preview title based on schema config. When viewing in published
+	// perspective, read from the loaded published snapshot — otherwise the
+	// header shows the draft's title even though the body shows published
+	// fields, which is confusing.
 	function getPreviewTitle(): string {
+		const source = perspective === 'published' && publishedData ? publishedData : documentData;
 		if (!schema?.preview?.select?.title) {
-			return documentData.title || `Untitled`;
+			return source.title || `Untitled`;
 		}
-		return documentData[schema.preview.select.title] || `Untitled`;
+		return source[schema.preview.select.title] || `Untitled`;
 	}
 
 	// CRITICAL: Clear state IMMEDIATELY when switching documents to prevent cross-contamination

package/dist/components/admin/DocumentEditor.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DocumentEditor.svelte.d.ts","sourceRoot":"","sources":["../../../src/lib/components/admin/DocumentEditor.svelte.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAaxD,UAAU,KAAK;IACd,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,OAAO,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,WAAW,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1D,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,WAAW,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,aAAa,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,UAAU,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,eAAe,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;IACrE,oBAAoB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IACpD,sBAAsB,CAAC,EAAE;QACxB,aAAa,EAAE,MAAM,CAAC;QACtB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC1B,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,IAAI,CAAC;IACT,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,6EAA6E;IAC7E,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B;AA+9CF,QAAA,MAAM,cAAc,2CAAwC,CAAC;AAC7D,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AACxD,eAAe,cAAc,CAAC"}
+{"version":3,"file":"DocumentEditor.svelte.d.ts","sourceRoot":"","sources":["../../../src/lib/components/admin/DocumentEditor.svelte.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAaxD,UAAU,KAAK;IACd,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,OAAO,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,WAAW,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1D,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,WAAW,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,aAAa,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,UAAU,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,eAAe,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;IACrE,oBAAoB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IACpD,sBAAsB,CAAC,EAAE;QACxB,aAAa,EAAE,MAAM,CAAC;QACtB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC1B,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,IAAI,CAAC;IACT,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,6EAA6E;IAC7E,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B;AAm+CF,QAAA,MAAM,cAAc,2CAAwC,CAAC;AAC7D,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AACxD,eAAe,cAAc,CAAC"}

package/dist/components/admin/MediaBrowser.svelte

@@ -1349,7 +1349,8 @@
 	<Dialog.Root bind:open={lightboxOpen}>
 		<Dialog.Content
 			showCloseButton={false}
-			class="flex max-h-[90vh] max-w-[90vw] flex-col overflow-hidden p-0 sm:max-w-[90vw]"
+			class="!z-[10000] flex max-h-[90vh] max-w-[90vw] flex-col overflow-hidden p-0 sm:max-w-[90vw]"
+			overlayClass="!z-[9999]"
 		>
 			<Dialog.Header class="border-border border-b px-4 py-3">
 				<Dialog.Title class="truncate text-sm font-medium"
@@ -1389,7 +1390,7 @@
 		}
 	}}
 >
-	<Dialog.Content class="max-w-lg">
+	<Dialog.Content class="!z-[10000] max-w-lg" overlayClass="!z-[9999]">
 		<Dialog.Header>
 			<Dialog.Title>Upload Assets</Dialog.Title>
 		</Dialog.Header>

package/dist/components/admin/ObjectModal.svelte

@@ -84,7 +84,7 @@
 	     backdrops cover the full screen, but for now keeping it inside the
 	     editor is the design we want. -->
 	<div
-		class="bg-background/80 absolute inset-0 backdrop-blur-xs"
+		class="bg-background/80 absolute inset-0"
 		style="z-index: {backdropZ}"
 		onclick={handleBackdropClick}
 		onkeydown={handleKeydown}

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

@@ -28,6 +28,7 @@
 	import type { ImageValue } from '../../../types/asset';
 	import { toast } from 'svelte-sonner';
 	import AssetBrowserModal from '../AssetBrowserModal.svelte';
+	import { resolvePreviewTitle, resolvePreviewSubtitle } from '../../../utils/preview';
 
 	interface Props {
 		field: ArrayFieldType;
@@ -59,7 +60,9 @@
 				type: 'object',
 				name: inlineDef.name || typeName,
 				title: inlineDef.title || typeName,
-				fields: inlineDef.fields
+				fields: inlineDef.fields,
+				icon: inlineDef.icon,
+				preview: inlineDef.preview
 			};
 		}
 
@@ -401,21 +404,19 @@
 
 	function getItemTitle(item: any): string {
 		if (!item._type) return 'Unknown Item';
-
 		const schema = getSchemaForType(item._type);
-		if (!schema) return item._type;
-
-		const titleField = item.title || item.heading || item.name || item.label;
-		if (titleField && typeof titleField === 'string' && titleField.trim()) {
-			return titleField;
-		}
+		return resolvePreviewTitle(item, schema, item._type);
+	}
 
-		return schema.title || item._type;
+	function getItemSubtitle(item: any): string | null {
+		if (!item._type) return null;
+		const schema = getSchemaForType(item._type);
+		return resolvePreviewSubtitle(item, schema);
 	}
 
 	function getItemIcon(item: any): any {
 		if (!item._type) return null;
-		const schema = getSchemaByName(schemas, item._type);
+		const schema = getSchemaForType(item._type);
 		return schema?.icon || null;
 	}
 </script>
@@ -771,7 +772,8 @@
 
 							<!-- Title (clickable to edit) — wraps the type icon so the whole
 							     row body is a generous click target instead of just the
-							     truncated title text. -->
+							     truncated title text. When the schema's preview config
+							     supplies a `subtitle` field, render it on a second line. -->
 							<button
 								class="flex flex-1 cursor-pointer items-center gap-2 self-stretch truncate px-1 py-2 text-left text-sm"
 								onclick={() => handleEditItem(index)}
@@ -784,7 +786,14 @@
 										<FileText class="h-4 w-4" />
 									{/if}
 								</span>
-								<span class="truncate">{getItemTitle(item)}</span>
+								<span class="flex min-w-0 flex-1 flex-col">
+									<span class="truncate">{getItemTitle(item)}</span>
+									{#if getItemSubtitle(item)}
+										<span class="text-muted-foreground truncate text-xs"
+											>{getItemSubtitle(item)}</span
+										>
+									{/if}
+								</span>
 							</button>
 
 							<!-- Context menu -->
@@ -875,7 +884,7 @@
 <!-- Image upload modal -->
 {#if imageModalOpen}
 	<div
-		class="bg-background/80 fixed top-12 right-0 bottom-0 left-0 z-40 flex items-center justify-center p-6 backdrop-blur-xs sm:absolute sm:top-0 sm:p-4"
+		class="bg-background/80 fixed top-12 right-0 bottom-0 left-0 z-40 flex items-center justify-center p-6 sm:absolute sm:top-0 sm:p-4"
 		onclick={(e) => {
 			if (e.target === e.currentTarget) handleImageModalClose();
 		}}
@@ -931,7 +940,7 @@
 <!-- Text editing modal -->
 {#if textModalOpen}
 	<div
-		class="bg-background/80 fixed top-12 right-0 bottom-0 left-0 z-[100] flex items-center justify-center p-6 backdrop-blur-xs sm:absolute sm:top-0 sm:p-4"
+		class="bg-background/80 fixed top-12 right-0 bottom-0 left-0 z-[100] flex items-center justify-center p-6 sm:absolute sm:top-0 sm:p-4"
 		onclick={(e) => {
 			if (e.target === e.currentTarget) handleTextModalClose();
 		}}

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

@@ -1 +1 @@
-{"version":3,"file":"ArrayField.svelte.d.ts","sourceRoot":"","sources":["../../../../src/lib/components/admin/fields/ArrayField.svelte.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,UAAU,IAAI,cAAc,EAAc,MAAM,wBAAwB,CAAC;AAyBtF,UAAU,KAAK;IACd,KAAK,EAAE,cAAc,CAAC;IACtB,KAAK,EAAE,GAAG,CAAC;IACX,QAAQ,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;IAC/B,eAAe,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;IACrE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AAwxBF,QAAA,MAAM,UAAU,2CAAwC,CAAC;AACzD,KAAK,UAAU,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;AAChD,eAAe,UAAU,CAAC"}
+{"version":3,"file":"ArrayField.svelte.d.ts","sourceRoot":"","sources":["../../../../src/lib/components/admin/fields/ArrayField.svelte.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,UAAU,IAAI,cAAc,EAAc,MAAM,wBAAwB,CAAC;AA0BtF,UAAU,KAAK;IACd,KAAK,EAAE,cAAc,CAAC;IACtB,KAAK,EAAE,GAAG,CAAC;IACX,QAAQ,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;IAC/B,eAAe,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;IACrE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AA8xBF,QAAA,MAAM,UAAU,2CAAwC,CAAC;AACzD,KAAK,UAAU,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;AAChD,eAAe,UAAU,CAAC"}

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

@@ -52,6 +52,8 @@
 	const isReadOnly = $derived(readonly || !perms.can('asset.upload'));
 
 	let isDragging = $state(false);
+	// Drag-counter to defeat the dragleave/dragenter flicker — see ImageField for rationale.
+	let dragDepth = 0;
 	let isUploading = $state(false);
 	let uploadError = $state<string | null>(null);
 	let fileInputRef: HTMLInputElement;
@@ -121,21 +123,29 @@
 		}
 	}
 
-	function handleDragOver(event: DragEvent) {
+	function handleDragEnter(event: DragEvent) {
 		if (isReadOnly) return;
 		event.preventDefault();
+		dragDepth++;
 		isDragging = true;
 	}
 
+	function handleDragOver(event: DragEvent) {
+		if (isReadOnly) return;
+		event.preventDefault();
+	}
+
 	function handleDragLeave(event: DragEvent) {
 		if (isReadOnly) return;
 		event.preventDefault();
-		isDragging = false;
+		dragDepth = Math.max(0, dragDepth - 1);
+		if (dragDepth === 0) isDragging = false;
 	}
 
 	function handleDrop(event: DragEvent) {
 		if (isReadOnly) return;
 		event.preventDefault();
+		dragDepth = 0;
 		isDragging = false;
 		handleFileSelect(event.dataTransfer?.files || null);
 	}
@@ -285,7 +295,7 @@
 							<Ellipsis size={16} />
 						</Button>
 					</DropdownMenuTrigger>
-					<DropdownMenuContent align="end">
+					<DropdownMenuContent align="end" class="!z-[9999]">
 						<DropdownMenuGroup>
 							<DropdownMenuItem onclick={openFileDialog} disabled={isUploading}>
 								<Upload size={16} />
@@ -365,7 +375,7 @@
 								<Ellipsis size={16} />
 							</Button>
 						</DropdownMenuTrigger>
-						<DropdownMenuContent align="end">
+						<DropdownMenuContent align="end" class="!z-[9999]">
 							<DropdownMenuGroup>
 								<DropdownMenuItem onclick={openFileDialog} disabled={isUploading}>
 									<Upload size={16} />
@@ -409,13 +419,14 @@
 	{:else}
 		<!-- Upload bar -->
 		<div
-			class="border-border flex h-10 items-center overflow-hidden rounded-md border transition-colors {validationClasses} {isReadOnly
+			class="border-border flex h-12 items-center overflow-hidden rounded-md border transition-colors {validationClasses} {isReadOnly
 				? ''
 				: isDragging
-					? 'bg-primary/5'
+					? 'border-primary bg-primary/5'
 					: ''}"
 			use:elementEvents={{
 				events: [
+					{ name: 'dragenter', handler: handleDragEnter },
 					{ name: 'dragover', handler: handleDragOver },
 					{ name: 'drop', handler: handleDrop },
 					{ name: 'dragleave', handler: handleDragLeave }

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

@@ -1 +1 @@
-{"version":3,"file":"FileField.svelte.d.ts","sourceRoot":"","sources":["../../../../src/lib/components/admin/fields/FileField.svelte.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAkBxE,UAAU,KAAK;IACd,KAAK,EAAE,aAAa,CAAC;IACrB,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,KAAK,IAAI,CAAC;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AAuaF,QAAA,MAAM,SAAS,2CAAwC,CAAC;AACxD,KAAK,SAAS,GAAG,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC;AAC9C,eAAe,SAAS,CAAC"}
+{"version":3,"file":"FileField.svelte.d.ts","sourceRoot":"","sources":["../../../../src/lib/components/admin/fields/FileField.svelte.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAkBxE,UAAU,KAAK;IACd,KAAK,EAAE,aAAa,CAAC;IACrB,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,KAAK,IAAI,CAAC;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AAkbF,QAAA,MAAM,SAAS,2CAAwC,CAAC;AACxD,KAAK,SAAS,GAAG,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC;AAC9C,eAAe,SAAS,CAAC"}

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

@@ -53,6 +53,12 @@
 
 	// Component state
 	let isDragging = $state(false);
+	// Drag-counter to defeat the dragleave/dragenter flicker: every child
+	// element the cursor crosses fires `dragleave` on the parent immediately
+	// followed by `dragenter`, so a naive `dragover → true / dragleave → false`
+	// flickers `isDragging` rapidly. Counting enters/leaves and only resetting
+	// at zero gives stable highlight state.
+	let dragDepth = 0;
 	let isUploading = $state(false);
 	let uploadError = $state<string | null>(null);
 	let fileInputRef: HTMLInputElement;
@@ -112,21 +118,29 @@
 	}
 
 	// Drag and drop handlers
-	function handleDragOver(event: DragEvent) {
+	function handleDragEnter(event: DragEvent) {
 		if (isReadOnly) return;
 		event.preventDefault();
+		dragDepth++;
 		isDragging = true;
 	}
 
+	function handleDragOver(event: DragEvent) {
+		if (isReadOnly) return;
+		event.preventDefault(); // required to allow `drop` to fire
+	}
+
 	function handleDragLeave(event: DragEvent) {
 		if (isReadOnly) return;
 		event.preventDefault();
-		isDragging = false;
+		dragDepth = Math.max(0, dragDepth - 1);
+		if (dragDepth === 0) isDragging = false;
 	}
 
 	function handleDrop(event: DragEvent) {
 		if (isReadOnly) return;
 		event.preventDefault();
+		dragDepth = 0;
 		isDragging = false;
 		handleFileSelect(event.dataTransfer?.files || null);
 	}
@@ -312,7 +326,7 @@
 							<Ellipsis size={16} />
 						</Button>
 					</DropdownMenuTrigger>
-					<DropdownMenuContent align="end">
+					<DropdownMenuContent align="end" class="!z-[9999]">
 						<DropdownMenuGroup>
 							<DropdownMenuItem onclick={openFileDialog} disabled={isUploading}>
 								<Upload size={16} />
@@ -397,7 +411,7 @@
 									<Ellipsis size={16} />
 								</Button>
 							</DropdownMenuTrigger>
-							<DropdownMenuContent align="end">
+							<DropdownMenuContent align="end" class="!z-[9999]">
 								<DropdownMenuGroup>
 									<DropdownMenuItem onclick={openFileDialog} disabled={isUploading}>
 										<Upload size={16} />
@@ -456,13 +470,14 @@
 	{:else}
 		<!-- Sanity-style upload bar -->
 		<div
-			class="border-border flex h-10 items-center overflow-hidden rounded-md border transition-colors {validationClasses} {isReadOnly
+			class="border-border flex h-12 items-center overflow-hidden rounded-md border transition-colors {validationClasses} {isReadOnly
 				? ''
 				: isDragging
-					? 'bg-primary/5'
+					? 'border-primary bg-primary/5'
 					: ''}"
 			use:elementEvents={{
 				events: [
+					{ name: 'dragenter', handler: handleDragEnter },
 					{ name: 'dragover', handler: handleDragOver },
 					{ name: 'drop', handler: handleDrop },
 					{ name: 'dragleave', handler: handleDragLeave }

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

@@ -1 +1 @@
-{"version":3,"file":"ImageField.svelte.d.ts","sourceRoot":"","sources":["../../../../src/lib/components/admin/fields/ImageField.svelte.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,IAAI,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAmB1E,UAAU,KAAK;IACd,KAAK,EAAE,cAAc,CAAC;IACtB,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,KAAK,IAAI,CAAC;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AA6bF,QAAA,MAAM,UAAU,2CAAwC,CAAC;AACzD,KAAK,UAAU,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;AAChD,eAAe,UAAU,CAAC"}
+{"version":3,"file":"ImageField.svelte.d.ts","sourceRoot":"","sources":["../../../../src/lib/components/admin/fields/ImageField.svelte.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,IAAI,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAmB1E,UAAU,KAAK;IACd,KAAK,EAAE,cAAc,CAAC;IACtB,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,KAAK,IAAI,CAAC;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AA4cF,QAAA,MAAM,UAAU,2CAAwC,CAAC;AACzD,KAAK,UAAU,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;AAChD,eAAe,UAAU,CAAC"}

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

@@ -15,6 +15,7 @@
 	import { toast } from 'svelte-sonner';
 	import { cmsLogger } from '../../../utils/logger';
 	import { pluralize } from '../../../utils/pluralize';
+	import { resolvePreviewTitle, resolvePreviewSubtitle } from '../../../utils/preview';
 
 	interface Props {
 		field: Field;
@@ -141,17 +142,19 @@
 	}
 
 	function getDocumentTitle(doc: any): string {
-		// With LocalAPI, data is flattened at top level
-		return doc.title || doc.name || doc.heading || 'Untitled';
+		return resolvePreviewTitle(doc, targetSchema);
 	}
 
-	const selectedLabel = $derived(selectedDocument ? getDocumentTitle(selectedDocument) : null);
+	function getDocumentSubtitle(doc: any): string | null {
+		return resolvePreviewSubtitle(doc, targetSchema);
+	}
 </script>
 
 {#if selectedDocument}
-	<!-- Selected document — row styled like an ArrayField item -->
+	<!-- Selected document — row styled like an ArrayField item. Grows to two
+	     lines when the target schema's preview config exposes a subtitle. -->
 	<div
-		class="border-border/50 bg-background hover:bg-muted/50 flex h-10 items-center gap-1 rounded border px-1 transition-colors"
+		class="border-border/50 bg-background hover:bg-muted/50 flex min-h-10 items-center gap-1 rounded border px-1 transition-colors"
 	>
 		<!-- Type icon -->
 		<div class="text-muted-foreground flex h-8 w-8 shrink-0 items-center justify-center">
@@ -162,13 +165,20 @@
 			{/if}
 		</div>
 
-		<!-- Title + status dot (clickable to open referenced document) -->
+		<!-- Title (+ subtitle) + status dot (clickable to open referenced document) -->
 		<button
-			class="flex min-w-0 flex-1 cursor-pointer items-center gap-2 text-left"
+			class="flex min-w-0 flex-1 cursor-pointer items-center gap-2 py-1 text-left"
 			onclick={openReference}
 			title="Open referenced document"
 		>
-			<span class="truncate text-sm">{getDocumentTitle(selectedDocument)}</span>
+			<span class="flex min-w-0 flex-1 flex-col">
+				<span class="truncate text-sm">{getDocumentTitle(selectedDocument)}</span>
+				{#if getDocumentSubtitle(selectedDocument)}
+					<span class="text-muted-foreground truncate text-xs"
+						>{getDocumentSubtitle(selectedDocument)}</span
+					>
+				{/if}
+			</span>
 			{#if selectedDocument.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'}
@@ -261,7 +271,14 @@
 										<CheckIcon
 											class={cn('h-4 w-4 shrink-0', value !== doc.id && 'text-transparent')}
 										/>
-										<span class="truncate text-sm">{getDocumentTitle(doc)}</span>
+										<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.status === 'published'}
 										<span class="h-1.5 w-1.5 shrink-0 rounded-full bg-green-500" title="Published"

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;AASzF,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;AAqQF,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":"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"}

package/dist/hooks.d.ts

@@ -24,5 +24,16 @@ export interface CMSInstances {
     graphqlSettings?: GraphQLSettings | null;
     apiApp: Hono<AphexEnv>;
 }
+/**
+ * Called by the Vite HMR plugin (`@aphexcms/cms-core/vite`) when schema
+ * files or `aphex.config.ts` change. Replaces the captured config with the
+ * freshly re-evaluated module and marks instances for re-initialization on
+ * the next request — no Vite dev-server restart required.
+ *
+ * Module-level state means the Vite plugin and the running SvelteKit hook
+ * share the same cms-core instance through Vite's module graph, so this
+ * setter mutates the same `activeConfig` the hook reads on each request.
+ */
+export declare function __notifyAphexConfigChanged(newConfig: CMSConfig): void;
 export declare function createCMSHook(config: CMSConfig): Handle;
 //# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/lib/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAKvD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAa,SAAS,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAIN,KAAK,QAAQ,EACb,MAAM,oBAAoB,CAAC;AAG5B,MAAM,WAAW,YAAY;IAC5B,MAAM,EAAE,SAAS,CAAC;IAClB,YAAY,EAAE,YAAY,CAAC;IAC3B,cAAc,EAAE,cAAc,CAAC;IAC/B,eAAe,EAAE,eAAe,CAAC;IACjC,YAAY,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IACnC,SAAS,EAAE,SAAS,CAAC;IACrB,QAAQ,EAAE,QAAQ,CAAC;IACnB,YAAY,EAAE,YAAY,CAAC;IAC3B,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,eAAe,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IACzC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;CACvB;AA0BD,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAgJvD"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/lib/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAKvD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAa,SAAS,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAIN,KAAK,QAAQ,EACb,MAAM,oBAAoB,CAAC;AAG5B,MAAM,WAAW,YAAY;IAC5B,MAAM,EAAE,SAAS,CAAC;IAClB,YAAY,EAAE,YAAY,CAAC;IAC3B,cAAc,EAAE,cAAc,CAAC;IAC/B,eAAe,EAAE,eAAe,CAAC;IACjC,YAAY,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IACnC,SAAS,EAAE,SAAS,CAAC;IACrB,QAAQ,EAAE,QAAQ,CAAC;IACnB,YAAY,EAAE,YAAY,CAAC;IAC3B,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,eAAe,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IACzC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;CACvB;AAQD;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAGrE;AAgBD,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAwJvD"}

package/dist/hooks.js

@@ -9,16 +9,27 @@ import { createAphexApi, mountAphexBuiltins, toHonoHandler } from './server/api/
 let cmsInstances = null;
 let schemaError = null;
 let initPromise = null;
+let activeConfig = null;
+let configDirty = false;
 /**
- * Check if schemas are dirty (changed via Vite HMR)
- * Vite plugin sets a global flag when schema files change
+ * Called by the Vite HMR plugin (`@aphexcms/cms-core/vite`) when schema
+ * files or `aphex.config.ts` change. Replaces the captured config with the
+ * freshly re-evaluated module and marks instances for re-initialization on
+ * the next request — no Vite dev-server restart required.
+ *
+ * Module-level state means the Vite plugin and the running SvelteKit hook
+ * share the same cms-core instance through Vite's module graph, so this
+ * setter mutates the same `activeConfig` the hook reads on each request.
  */
+export function __notifyAphexConfigChanged(newConfig) {
+    activeConfig = newConfig;
+    configDirty = true;
+}
 function checkSchemasDirty() {
-    const dirty = global.__aphexSchemasDirty === true;
-    if (dirty) {
-        global.__aphexSchemasDirty = false; // Reset the flag
-    }
-    return dirty;
+    if (!configDirty)
+        return false;
+    configDirty = false;
+    return true;
 }
 // Factory function to create the default local storage adapter
 function createDefaultStorageAdapter() {
@@ -35,7 +46,13 @@ export function createCMSHook(config) {
     // Apply log level from config (if provided)
     if (config.logLevel)
         setLogLevel(config.logLevel);
+    // Stash the config in module scope so the HMR plugin can replace it via
+    // __notifyAphexConfigChanged() without going through this factory again.
+    activeConfig = config;
     return async ({ event, resolve }) => {
+        // Use the latest config that the HMR plugin handed us; falls back to
+        // the one captured at hook construction time.
+        const currentConfig = activeConfig ?? config;
         // Note: In dev mode, /storage/ might be accessible via Vite dev server
         // In production, only /static/ folder is served - /storage/ is private
         // Initialize CMS instances once at application startup
@@ -59,20 +76,20 @@ export function createCMSHook(config) {
             let resolveInit;
             initPromise = new Promise((r) => (resolveInit = r));
             cmsLogger.info('[CMS]', 'Initializing...');
-            const databaseAdapter = config.database;
+            const databaseAdapter = currentConfig.database;
             // Use the storage adapter from config, or create the default local one.
-            const storageAdapter = config.storage ?? createDefaultStorageAdapter();
-            const emailAdapter = config.email ?? null;
+            const storageAdapter = currentConfig.storage ?? createDefaultStorageAdapter();
+            const emailAdapter = currentConfig.email ?? null;
             const assetService = new AssetServiceClass(storageAdapter, databaseAdapter);
-            const cmsEngine = createCMS(config, databaseAdapter);
-            const rolesService = new RolesService(databaseAdapter, config.cache ?? null);
+            const cmsEngine = createCMS(currentConfig, databaseAdapter);
+            const rolesService = new RolesService(databaseAdapter, currentConfig.cache ?? null);
             // Initialize Local API (unified operations layer)
-            const localAPI = createLocalAPI(config, databaseAdapter);
+            const localAPI = createLocalAPI(currentConfig, databaseAdapter);
             // Build the Hono API app shell. User middleware/overrides register
             // FIRST (so they sit ahead of built-ins in the chain), then we mount
             // the built-in routes, then GraphQL.
             const apiApp = createAphexApi();
-            config.api?.(apiApp);
+            currentConfig.api?.(apiApp);
             mountAphexBuiltins(apiApp);
             // Initialize schemas with validation
             try {
@@ -84,12 +101,12 @@ export function createCMSHook(config) {
             }
             // Initialize built-in GraphQL (enabled by default, opt-out with graphql: false)
             let graphqlSettings = null;
-            if (config.graphql !== false) {
+            if (currentConfig.graphql !== false) {
                 try {
                     const { createGraphQLHandler } = await import('./graphql/index.js');
-                    const graphqlConfig = typeof config.graphql === 'object' ? config.graphql : {};
+                    const graphqlConfig = typeof currentConfig.graphql === 'object' ? currentConfig.graphql : {};
                     const result = await createGraphQLHandler({
-                        config,
+                        config: currentConfig,
                         databaseAdapter,
                         assetService,
                         storageAdapter,
@@ -97,9 +114,9 @@ export function createCMSHook(config) {
                         cmsEngine,
                         localAPI,
                         rolesService,
-                        auth: config.auth?.provider,
+                        auth: currentConfig.auth?.provider,
                         apiApp
-                    }, config.schemaTypes, graphqlConfig);
+                    }, currentConfig.schemaTypes, graphqlConfig);
                     // Register GraphQL directly on the Hono app. The Yoga handler
                     // internally distinguishes GET (GraphiQL UI) from POST (queries),
                     // so we mount with `app.all()` and let it route by method.
@@ -120,7 +137,7 @@ export function createCMSHook(config) {
                 }
             }
             cmsInstances = {
-                config,
+                config: currentConfig,
                 databaseAdapter: databaseAdapter,
                 assetService: assetService,
                 storageAdapter: storageAdapter,
@@ -128,7 +145,7 @@ export function createCMSHook(config) {
                 cmsEngine: cmsEngine,
                 localAPI: localAPI,
                 rolesService,
-                auth: config.auth?.provider,
+                auth: currentConfig.auth?.provider,
                 graphqlSettings,
                 apiApp
             };
@@ -142,7 +159,7 @@ export function createCMSHook(config) {
         event.locals.aphexCMS = cmsInstances;
         // Auth protection if configured
         if (cmsInstances.auth) {
-            const authResponse = await handleAuthHook(event, config, cmsInstances.auth, cmsInstances.databaseAdapter, cmsInstances.rolesService);
+            const authResponse = await handleAuthHook(event, currentConfig, cmsInstances.auth, cmsInstances.databaseAdapter, cmsInstances.rolesService);
             if (authResponse)
                 return authResponse;
         }

package/dist/lib/hooks.d.ts

@@ -24,5 +24,16 @@ export interface CMSInstances {
     graphqlSettings?: GraphQLSettings | null;
     apiApp: Hono<AphexEnv>;
 }
+/**
+ * Called by the Vite HMR plugin (`@aphexcms/cms-core/vite`) when schema
+ * files or `aphex.config.ts` change. Replaces the captured config with the
+ * freshly re-evaluated module and marks instances for re-initialization on
+ * the next request — no Vite dev-server restart required.
+ *
+ * Module-level state means the Vite plugin and the running SvelteKit hook
+ * share the same cms-core instance through Vite's module graph, so this
+ * setter mutates the same `activeConfig` the hook reads on each request.
+ */
+export declare function __notifyAphexConfigChanged(newConfig: CMSConfig): void;
 export declare function createCMSHook(config: CMSConfig): Handle;
 //# sourceMappingURL=hooks.d.ts.map

package/dist/lib/hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/lib/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAKvD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAa,SAAS,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAIN,KAAK,QAAQ,EACb,MAAM,oBAAoB,CAAC;AAG5B,MAAM,WAAW,YAAY;IAC5B,MAAM,EAAE,SAAS,CAAC;IAClB,YAAY,EAAE,YAAY,CAAC;IAC3B,cAAc,EAAE,cAAc,CAAC;IAC/B,eAAe,EAAE,eAAe,CAAC;IACjC,YAAY,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IACnC,SAAS,EAAE,SAAS,CAAC;IACrB,QAAQ,EAAE,QAAQ,CAAC;IACnB,YAAY,EAAE,YAAY,CAAC;IAC3B,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,eAAe,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IACzC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;CACvB;AA0BD,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAgJvD"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/lib/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAKvD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAa,SAAS,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAIN,KAAK,QAAQ,EACb,MAAM,oBAAoB,CAAC;AAG5B,MAAM,WAAW,YAAY;IAC5B,MAAM,EAAE,SAAS,CAAC;IAClB,YAAY,EAAE,YAAY,CAAC;IAC3B,cAAc,EAAE,cAAc,CAAC;IAC/B,eAAe,EAAE,eAAe,CAAC;IACjC,YAAY,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IACnC,SAAS,EAAE,SAAS,CAAC;IACrB,QAAQ,EAAE,QAAQ,CAAC;IACnB,YAAY,EAAE,YAAY,CAAC;IAC3B,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,eAAe,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IACzC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;CACvB;AAQD;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAGrE;AAgBD,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAwJvD"}