@aphexcms/cms-core 5.0.5 → 6.0.0

package/dist/lib/vite/index.js

@@ -0,0 +1,274 @@
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+/**
+ * Watches the CMS config and schema files in dev. When any of them change,
+ * the plugin re-loads `aphex.config.ts` via Vite's SSR loader (so the fresh
+ * module re-runs the schema imports) and hands the new config to cms-core's
+ * `__notifyAphexConfigChanged()` setter — the engine then re-initializes on
+ * the next request without restarting the Vite dev server.
+ *
+ * Why this works without races:
+ * - `server.ssrLoadModule` is Vite's official re-eval path, no cache-bust hacks
+ * - The plugin and the running SvelteKit hook share the same cms-core module
+ *   instance through Vite's module graph, so the setter mutates the same
+ *   `activeConfig` the hook reads on each request
+ * - A single mutation point (`__notifyAphexConfigChanged`) replaces the old
+ *   global dirty-flag protocol; no two-step set-then-read race window
+ *
+ * Falls back to `server.restart()` automatically if the swap throws (e.g.
+ * the user introduced a syntax error in their schema). `mode: 'restart'`
+ * forces the slower-but-most-correct path on every change.
+ */
+export function aphexHMR(options = {}) {
+    const schemaDir = options.schemaDir ?? '/schemaTypes/';
+    const configFile = options.configFile ?? 'aphex.config.ts';
+    const debounceMs = options.debounceMs ?? 150;
+    const mode = options.mode ?? 'swap';
+    return {
+        name: 'aphex:hmr',
+        configureServer(server) {
+            const { watcher, ws } = server;
+            function isReloadTarget(file) {
+                const normalized = file.replace(/\\/g, '/');
+                return ((normalized.includes(schemaDir) && normalized.endsWith('.ts')) ||
+                    normalized.endsWith(`/${configFile}`));
+            }
+            async function swapSchemas(file) {
+                const start = Date.now();
+                const configPath = `${server.config.root}/${configFile}`;
+                // Invalidate the changed file + the config + the schemaTypes barrel
+                // so ssrLoadModule re-evaluates with the new disk contents.
+                for (const path of [file, configPath]) {
+                    const mods = server.moduleGraph.getModulesByFile(path);
+                    mods?.forEach((mod) => server.moduleGraph.invalidateModule(mod));
+                }
+                const configMod = await server.ssrLoadModule(configPath);
+                const freshConfig = configMod.default;
+                if (!freshConfig) {
+                    throw new Error(`${configFile} did not export a default config`);
+                }
+                const cmsCore = await server.ssrLoadModule('@aphexcms/cms-core/server');
+                if (typeof cmsCore.__notifyAphexConfigChanged !== 'function') {
+                    throw new Error('cms-core does not expose __notifyAphexConfigChanged — upgrade @aphexcms/cms-core');
+                }
+                cmsCore.__notifyAphexConfigChanged(freshConfig);
+                ws.send({ type: 'full-reload' });
+                console.log(`🔄 CMS schemas hot-swapped (${Date.now() - start}ms): ${file}`);
+            }
+            let pending = null;
+            let lastFile = '';
+            function scheduleReload(file) {
+                lastFile = file;
+                if (pending)
+                    clearTimeout(pending);
+                pending = setTimeout(async () => {
+                    pending = null;
+                    if (mode === 'restart') {
+                        console.log(`🔄 CMS schema change → restarting dev server: ${lastFile}`);
+                        server.restart().catch((err) => {
+                            console.error('[aphex] dev server restart failed:', err);
+                        });
+                        return;
+                    }
+                    try {
+                        await swapSchemas(lastFile);
+                    }
+                    catch (err) {
+                        console.error('[aphex] hot-swap failed, falling back to restart:', err);
+                        server.restart().catch((err) => {
+                            console.error('[aphex] dev server restart failed:', err);
+                        });
+                    }
+                }, debounceMs);
+            }
+            for (const event of ['change', 'add', 'unlink']) {
+                watcher.on(event, (file) => {
+                    if (isReloadTarget(file))
+                        scheduleReload(file);
+                });
+            }
+        }
+    };
+}
+/**
+ * Redirects `dayjs` and `dayjs/plugin/*` imports to dayjs's ESM build.
+ *
+ * dayjs 1.x ships a UMD `main` (`dayjs.min.js`) with no `exports` map or
+ * `module` field. When imports originate inside a package excluded from
+ * Vite's pre-bundling (e.g. `@aphexcms/cms-core`), Vite serves the raw UMD
+ * — which has no ESM `default` export — and the browser blows up with
+ * "does not provide an export named 'default'". This alias guarantees every
+ * dayjs import resolves to the proper ESM build.
+ */
+function aphexDayjsAlias() {
+    return {
+        name: 'aphex:dayjs-alias',
+        config() {
+            const dayjsEsm = require.resolve('dayjs/esm/index.js');
+            const dayjsEsmPluginDir = dayjsEsm.replace(/\/index\.js$/, '/plugin');
+            return {
+                resolve: {
+                    alias: [
+                        { find: /^dayjs$/, replacement: dayjsEsm },
+                        {
+                            find: /^dayjs\/plugin\/([^/]+?)(\.js)?$/,
+                            replacement: `${dayjsEsmPluginDir}/$1/index.js`
+                        }
+                    ]
+                }
+            };
+        }
+    };
+}
+/**
+ * SSR config: cms-core and ui packages re-export `.svelte` components through
+ * their entry barrels — Vite must bundle them for SSR. If they are externalised,
+ * Node's native ESM loader tries to resolve the raw `.svelte` files directly
+ * and throws ERR_UNKNOWN_FILE_EXTENSION (the `svelte` export condition is only
+ * honoured by Vite, not by Node).
+ *
+ * sharp/graphql/graphql-yoga are native or large CJS deps that should stay
+ * external — bundling them breaks Node's native bindings or balloons the SSR
+ * bundle.
+ */
+function aphexSSR() {
+    return {
+        name: 'aphex:ssr',
+        config() {
+            return {
+                ssr: {
+                    noExternal: ['@aphexcms/ui', '@aphexcms/cms-core'],
+                    external: ['sharp', 'graphql', 'graphql-yoga']
+                }
+            };
+        }
+    };
+}
+/**
+ * optimizeDeps tuning: exclude the Aphex Svelte packages from esbuild
+ * pre-bundling (esbuild can't transform `.svelte` files; vite-plugin-svelte
+ * handles them at transform time instead), and pre-bundle their transitive
+ * deps that Vite would otherwise discover lazily at runtime — which causes
+ * full-page reloads when the user first navigates to a route that triggers
+ * a new dep.
+ */
+function aphexOptimizeDeps() {
+    return {
+        name: 'aphex:optimize-deps',
+        config() {
+            return {
+                optimizeDeps: {
+                    exclude: ['sharp', '@aphexcms/ui', '@aphexcms/cms-core'],
+                    include: [
+                        'tailwind-variants',
+                        'tailwind-merge',
+                        '@internationalized/date',
+                        'bits-ui',
+                        'dayjs',
+                        'dayjs/plugin/customParseFormat',
+                        'dayjs/plugin/customParseFormat.js',
+                        'dayjs/plugin/utc',
+                        'dayjs/plugin/utc.js',
+                        '@lucide/svelte',
+                        '@lucide/svelte/icons/panel-left',
+                        '@lucide/svelte/icons/minus',
+                        '@lucide/svelte/icons/circle',
+                        '@lucide/svelte/icons/chevron-right',
+                        '@lucide/svelte/icons/search',
+                        '@lucide/svelte/icons/bot',
+                        '@lucide/svelte/icons/calendar',
+                        '@lucide/svelte/icons/check',
+                        '@lucide/svelte/icons/chevron-down',
+                        '@lucide/svelte/icons/chevron-left',
+                        '@lucide/svelte/icons/chevron-up',
+                        '@lucide/svelte/icons/chevrons-up-down',
+                        '@lucide/svelte/icons/circle-check',
+                        '@lucide/svelte/icons/info',
+                        '@lucide/svelte/icons/loader-2',
+                        '@lucide/svelte/icons/octagon-x',
+                        '@lucide/svelte/icons/plus',
+                        '@lucide/svelte/icons/triangle-alert',
+                        '@lucide/svelte/icons/x',
+                        'better-auth/client/plugins',
+                        'better-auth/svelte',
+                        'mode-watcher',
+                        'svelte-sonner',
+                        '@aphexcms/cms-core > @dnd-kit/helpers',
+                        '@aphexcms/cms-core > @dnd-kit/svelte',
+                        '@aphexcms/cms-core > @dnd-kit/svelte/sortable',
+                        '@aphexcms/cms-core > dayjs',
+                        '@aphexcms/cms-core > dayjs/plugin/customParseFormat',
+                        '@aphexcms/cms-core > dayjs/plugin/customParseFormat.js',
+                        '@aphexcms/cms-core > dayjs/plugin/utc',
+                        '@aphexcms/cms-core > dayjs/plugin/utc.js'
+                    ]
+                }
+            };
+        }
+    };
+}
+/**
+ * Vite's default watcher ignores `node_modules`. In a workspace setup where
+ * Aphex packages are linked from `node_modules/@aphexcms/*`, edits to those
+ * source files won't trigger HMR unless we explicitly un-ignore them.
+ */
+function aphexWatchUnfilter() {
+    return {
+        name: 'aphex:watch-unfilter',
+        config() {
+            return {
+                server: {
+                    watch: {
+                        ignored: [
+                            '!**/node_modules/@aphexcms/cms-core/**',
+                            '!**/node_modules/@aphexcms/ui/**'
+                        ]
+                    }
+                }
+            };
+        }
+    };
+}
+/**
+ * One-stop Vite plugin for AphexCMS apps. Bundles:
+ *
+ * - schema HMR (restart-on-change)
+ * - dayjs ESM alias redirect
+ * - SSR noExternal/external defaults for cms-core/ui packages
+ * - optimizeDeps tuning so first-render isn't slowed by lazy dep discovery
+ * - watcher un-ignore for in-monorepo Aphex package edits
+ *
+ * Each piece can be opted out individually. Returns an array of plugins so
+ * Vite can attach each one separately and keep diagnostics readable.
+ *
+ * Usage:
+ *
+ * ```ts
+ * // vite.config.ts
+ * import { aphex } from '@aphexcms/cms-core/vite';
+ *
+ * export default defineConfig({
+ *   plugins: [tailwindcss(), sveltekit(), aphex()]
+ * });
+ * ```
+ */
+export function aphex(options = {}) {
+    const plugins = [];
+    if (options.hmr !== false) {
+        plugins.push(aphexHMR(options.hmr ?? {}));
+    }
+    if (options.dayjs !== false) {
+        plugins.push(aphexDayjsAlias());
+    }
+    if (options.ssr !== false) {
+        plugins.push(aphexSSR());
+    }
+    if (options.optimizeDeps !== false) {
+        plugins.push(aphexOptimizeDeps());
+    }
+    if (options.watch !== false) {
+        plugins.push(aphexWatchUnfilter());
+    }
+    return plugins;
+}
+//# sourceMappingURL=index.js.map

package/dist/lib/vite/index.js.map

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

package/dist/schema-utils/validator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/lib/schema-utils/validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAS,MAAM,kBAAkB,CAAC;AAmB1D;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,IAAI,CAqNpE"}
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/lib/schema-utils/validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAS,MAAM,kBAAkB,CAAC;AAmB1D;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,IAAI,CA8NpE"}

package/dist/schema-utils/validator.js

@@ -117,19 +117,22 @@ export function validateSchemaReferences(schemas) {
                 }
             }
         }
-        // Validate preview config references
+        // Validate preview config references. Dot-paths are allowed (e.g.
+        // `seo.title`) — validate only the first segment exists at the top
+        // level; we don't recurse into nested object types here.
         if (schema.preview?.select) {
             const fieldNames = new Set(schema.fields?.map((f) => f.name) || []);
-            // Validate title field reference
-            if (schema.preview.select.title && !fieldNames.has(schema.preview.select.title)) {
+            const rootOf = (path) => path.split('.', 1)[0] ?? path;
+            if (schema.preview.select.title &&
+                !fieldNames.has(rootOf(schema.preview.select.title))) {
                 errors.push(`Schema "${schema.name}" preview.select.title references unknown field "${schema.preview.select.title}"`);
             }
-            // Validate subtitle field reference
-            if (schema.preview.select.subtitle && !fieldNames.has(schema.preview.select.subtitle)) {
+            if (schema.preview.select.subtitle &&
+                !fieldNames.has(rootOf(schema.preview.select.subtitle))) {
                 errors.push(`Schema "${schema.name}" preview.select.subtitle references unknown field "${schema.preview.select.subtitle}"`);
             }
-            // Validate media field reference
-            if (schema.preview.select.media && !fieldNames.has(schema.preview.select.media)) {
+            if (schema.preview.select.media &&
+                !fieldNames.has(rootOf(schema.preview.select.media))) {
                 errors.push(`Schema "${schema.name}" preview.select.media references unknown field "${schema.preview.select.media}"`);
             }
         }

package/dist/server/index.d.ts

@@ -5,7 +5,7 @@ export * from '../email/index.js';
 export { AuthError, type AuthErrorCode } from '../auth/auth-errors.js';
 export { createCMSConfig } from '../config.js';
 export { CMSEngine } from '../engine.js';
-export { createCMSHook, type CMSInstances } from '../hooks.js';
+export { createCMSHook, __notifyAphexConfigChanged, type CMSInstances } from '../hooks.js';
 export * from '../db/interfaces/index.js';
 export * from '../storage/index.js';
 export * from '../storage/interfaces/index.js';

package/dist/server/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/server/index.ts"],"names":[],"mappings":"AAIA,cAAc,gBAAgB,CAAC;AAE/B,cAAc,kBAAkB,CAAC;AAEjC,cAAc,gBAAgB,CAAC;AAE/B,cAAc,gBAAgB,CAAC;AAG/B,OAAO,EAAE,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpE,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAG5C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAGtC,OAAO,EAAE,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAG5D,cAAc,wBAAwB,CAAC;AAGvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAG7C,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAKzD,OAAO,EAAE,GAAG,IAAI,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAI5D,OAAO,EACN,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,KAAK,QAAQ,EACb,MAAM,aAAa,CAAC;AAGrB,cAAc,uBAAuB,CAAC;AAGtC,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAGhE,OAAO,EACN,oBAAoB,EACpB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACN,QAAQ,EACR,cAAc,EACd,WAAW,EACX,aAAa,EACb,uBAAuB,EACvB,iBAAiB,EACjB,eAAe,EACf,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/server/index.ts"],"names":[],"mappings":"AAIA,cAAc,gBAAgB,CAAC;AAE/B,cAAc,kBAAkB,CAAC;AAEjC,cAAc,gBAAgB,CAAC;AAE/B,cAAc,gBAAgB,CAAC;AAG/B,OAAO,EAAE,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpE,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAG5C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAGtC,OAAO,EAAE,aAAa,EAAE,0BAA0B,EAAE,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAGxF,cAAc,wBAAwB,CAAC;AAGvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAG7C,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAKzD,OAAO,EAAE,GAAG,IAAI,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAI5D,OAAO,EACN,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,KAAK,QAAQ,EACb,MAAM,aAAa,CAAC;AAGrB,cAAc,uBAAuB,CAAC;AAGtC,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAGhE,OAAO,EACN,oBAAoB,EACpB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACN,QAAQ,EACR,cAAc,EACd,WAAW,EACX,aAAa,EACb,uBAAuB,EACvB,iBAAiB,EACjB,eAAe,EACf,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,MAAM,oBAAoB,CAAC"}

package/dist/server/index.js

@@ -12,7 +12,7 @@ export { createCMSConfig } from '../config.js';
 // CMS Engine
 export { CMSEngine } from '../engine.js';
 // Hooks integration (SvelteKit server hooks)
-export { createCMSHook } from '../hooks.js';
+export { createCMSHook, __notifyAphexConfigChanged } from '../hooks.js';
 // Database interfaces (no longer export registry or adapters - use adapter packages)
 export * from '../db/interfaces/index.js';
 // Storage adapters and interfaces

package/dist/types/schemas.d.ts

@@ -141,6 +141,8 @@ export interface TypeReference {
     title?: string;
     name?: string;
     fields?: Field[];
+    icon?: typeof LucideIcon;
+    preview?: PreviewConfig;
 }
 export interface ArrayField extends BaseField {
     type: 'array';

package/dist/types/schemas.d.ts.map

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

package/dist/utils/preview.d.ts

@@ -0,0 +1,20 @@
+import type { SchemaType } from '../types/schemas.js';
+/**
+ * Walk a dot-path (e.g. `seo.title`) through an object. Returns the
+ * terminal value, or `undefined` if any segment along the way is missing.
+ */
+export declare function readPath(item: any, path: string): unknown;
+/**
+ * Resolve the title to display for an item (array row, document list row,
+ * reference picker row). Honors `schema.preview.select.title` first
+ * (with dot-path support), then falls back to the conventional field
+ * names, then the schema's own title, then the type name.
+ */
+export declare function resolvePreviewTitle(item: any, schema: SchemaType | null | undefined, defaultTypeLabel?: string): string;
+/**
+ * Resolve the subtitle to display for an item. Returns `null` when no
+ * subtitle is configured or the configured field is empty — callers
+ * should branch on the null and skip rendering the subtitle line.
+ */
+export declare function resolvePreviewSubtitle(item: any, schema: SchemaType | null | undefined): string | null;
+//# sourceMappingURL=preview.d.ts.map

package/dist/utils/preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../../src/lib/utils/preview.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAOzD;AAuBD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAClC,IAAI,EAAE,GAAG,EACT,MAAM,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,EACrC,gBAAgB,CAAC,EAAE,MAAM,GACvB,MAAM,CAYR;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACrC,IAAI,EAAE,GAAG,EACT,MAAM,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,GACnC,MAAM,GAAG,IAAI,CAIf"}

package/dist/utils/preview.js

@@ -0,0 +1,67 @@
+/**
+ * Walk a dot-path (e.g. `seo.title`) through an object. Returns the
+ * terminal value, or `undefined` if any segment along the way is missing.
+ */
+export function readPath(item, path) {
+    let current = item;
+    for (const segment of path.split('.')) {
+        if (current == null)
+            return undefined;
+        current = current[segment];
+    }
+    return current;
+}
+/**
+ * Coerce a value into a printable string for preview rows. Returns `null`
+ * when the value isn't worth rendering (empty, nullish, non-primitive).
+ */
+function toPreviewString(value) {
+    if (typeof value === 'string') {
+        const trimmed = value.trim();
+        return trimmed ? trimmed : null;
+    }
+    if (typeof value === 'number' && Number.isFinite(value))
+        return String(value);
+    if (typeof value === 'boolean')
+        return value ? 'true' : 'false';
+    return null;
+}
+/**
+ * Conventional fallback field names for the title slot when a schema
+ * doesn't declare a `preview.select.title`. Mirrors Sanity's heuristic
+ * — the first non-empty string wins.
+ */
+const DEFAULT_TITLE_FIELDS = ['title', 'heading', 'name', 'label'];
+/**
+ * Resolve the title to display for an item (array row, document list row,
+ * reference picker row). Honors `schema.preview.select.title` first
+ * (with dot-path support), then falls back to the conventional field
+ * names, then the schema's own title, then the type name.
+ */
+export function resolvePreviewTitle(item, schema, defaultTypeLabel) {
+    const configured = schema?.preview?.select?.title;
+    if (configured) {
+        const resolved = toPreviewString(readPath(item, configured));
+        if (resolved)
+            return resolved;
+    }
+    else {
+        for (const name of DEFAULT_TITLE_FIELDS) {
+            const resolved = toPreviewString(item?.[name]);
+            if (resolved)
+                return resolved;
+        }
+    }
+    return schema?.title ?? defaultTypeLabel ?? 'Untitled';
+}
+/**
+ * Resolve the subtitle to display for an item. Returns `null` when no
+ * subtitle is configured or the configured field is empty — callers
+ * should branch on the null and skip rendering the subtitle line.
+ */
+export function resolvePreviewSubtitle(item, schema) {
+    const configured = schema?.preview?.select?.subtitle;
+    if (!configured)
+        return null;
+    return toPreviewString(readPath(item, configured));
+}

package/dist/vite/index.d.ts

@@ -0,0 +1,86 @@
+import type { Plugin } from 'vite';
+export interface AphexHMROptions {
+    /**
+     * Path segment that identifies schema files (matched against the file path).
+     * Defaults to `/schemaTypes/`.
+     */
+    schemaDir?: string;
+    /**
+     * Filename of the CMS config (matched as a suffix on the changed path).
+     * Defaults to `aphex.config.ts`.
+     */
+    configFile?: string;
+    /**
+     * Debounce window in ms before reacting to a schema change.
+     * Editors that do atomic saves fire multiple chokidar events in quick
+     * succession; debouncing collapses them into a single reload.
+     * Defaults to 150.
+     */
+    debounceMs?: number;
+    /**
+     * How to refresh the CMS engine on schema change.
+     * - `'swap'` (default): re-load `aphex.config.ts` via Vite's SSR loader and
+     *   hand it to cms-core's HMR setter. The Vite dev server keeps running;
+     *   only the engine's config is replaced. ~10x faster than restart.
+     * - `'restart'`: tear down and rebuild the Vite dev server. Slower but
+     *   guarantees every server module re-evaluates from scratch.
+     */
+    mode?: 'swap' | 'restart';
+}
+export interface AphexOptions {
+    /** HMR plugin options. Pass `false` to disable schema HMR. */
+    hmr?: AphexHMROptions | false;
+    /** Disable the dayjs ESM alias redirect. */
+    dayjs?: boolean;
+    /** Disable the SSR noExternal/external defaults for cms-core/ui packages. */
+    ssr?: boolean;
+    /** Disable the optimizeDeps include/exclude defaults. */
+    optimizeDeps?: boolean;
+    /** Disable the watch unfilter for in-monorepo Aphex package edits. */
+    watch?: boolean;
+}
+/**
+ * Watches the CMS config and schema files in dev. When any of them change,
+ * the plugin re-loads `aphex.config.ts` via Vite's SSR loader (so the fresh
+ * module re-runs the schema imports) and hands the new config to cms-core's
+ * `__notifyAphexConfigChanged()` setter — the engine then re-initializes on
+ * the next request without restarting the Vite dev server.
+ *
+ * Why this works without races:
+ * - `server.ssrLoadModule` is Vite's official re-eval path, no cache-bust hacks
+ * - The plugin and the running SvelteKit hook share the same cms-core module
+ *   instance through Vite's module graph, so the setter mutates the same
+ *   `activeConfig` the hook reads on each request
+ * - A single mutation point (`__notifyAphexConfigChanged`) replaces the old
+ *   global dirty-flag protocol; no two-step set-then-read race window
+ *
+ * Falls back to `server.restart()` automatically if the swap throws (e.g.
+ * the user introduced a syntax error in their schema). `mode: 'restart'`
+ * forces the slower-but-most-correct path on every change.
+ */
+export declare function aphexHMR(options?: AphexHMROptions): Plugin;
+/**
+ * One-stop Vite plugin for AphexCMS apps. Bundles:
+ *
+ * - schema HMR (restart-on-change)
+ * - dayjs ESM alias redirect
+ * - SSR noExternal/external defaults for cms-core/ui packages
+ * - optimizeDeps tuning so first-render isn't slowed by lazy dep discovery
+ * - watcher un-ignore for in-monorepo Aphex package edits
+ *
+ * Each piece can be opted out individually. Returns an array of plugins so
+ * Vite can attach each one separately and keep diagnostics readable.
+ *
+ * Usage:
+ *
+ * ```ts
+ * // vite.config.ts
+ * import { aphex } from '@aphexcms/cms-core/vite';
+ *
+ * export default defineConfig({
+ *   plugins: [tailwindcss(), sveltekit(), aphex()]
+ * });
+ * ```
+ */
+export declare function aphex(options?: AphexOptions): Plugin[];
+//# sourceMappingURL=index.d.ts.map

package/dist/vite/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/vite/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,MAAM,CAAC;AAElD,MAAM,WAAW,eAAe;IAC/B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC5B,8DAA8D;IAC9D,GAAG,CAAC,EAAE,eAAe,GAAG,KAAK,CAAC;IAC9B,4CAA4C;IAC5C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,6EAA6E;IAC7E,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,yDAAyD;IACzD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,sEAAsE;IACtE,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB;AAID;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,QAAQ,CAAC,OAAO,GAAE,eAAoB,GAAG,MAAM,CAiF9D;AAiJD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,KAAK,CAAC,OAAO,GAAE,YAAiB,GAAG,MAAM,EAAE,CAoB1D"}