@byline/core 4.11.2 → 4.12.0

package/dist/@types/admin-types.d.ts

@@ -155,7 +155,7 @@ export interface FieldAdminConfig {
      * Per-field rich-text editor component override. When set on a
      * `type: 'richText'` field's admin entry, the framework renders this
      * component instead of the globally registered
-     * `ClientConfig.fields.richText.editor`. Use to opt one specific field
+     * `AdminConfig.fields.richText.editor`. Use to opt one specific field
      * into an alternate editor (e.g. an AI-enabled wrapper around the
      * default Lexical field) without changing the site-wide registration.
      *
@@ -225,8 +225,6 @@ export interface CollectionAdminConfig<T = any> {
      * formatters are shared with the list view. Omit to fall back to a
      * single-line render of `useAsTitle` + `path`.
      *
-     * Resolve it through `resolveItemViewColumns(config)` rather than reading
-     * the field directly, so the deprecated `picker` alias keeps working.
      */
     itemView?: ColumnDefinition<T>[];
     /**
@@ -248,12 +246,6 @@ export interface CollectionAdminConfig<T = any> {
      * omitted.
      */
     itemViewSort?: ListDefaultSort<T>;
-    /**
-     * @deprecated Renamed to {@link itemView}. Kept as a backwards-compatible
-     * alias — `itemView` wins when both are present. Read both via
-     * `resolveItemViewColumns(config)`. Will be removed in a future major.
-     */
-    picker?: ColumnDefinition<T>[];
     /** Default columns to show when no explicit column config is provided. */
     defaultColumns?: string[];
     /** Named tab components. Each set is one tab bar. */
@@ -275,7 +267,7 @@ export interface CollectionAdminConfig<T = any> {
      * structure fields (`files.filesGroup.publicationFile`). Paths address
      * field *declarations*, never item instances (no `[0]` indices), and never
      * traverse a `blocks` field — blocks take their overrides from the
-     * blockType-keyed `ClientConfig.blockAdmin` registry instead.
+     * blockType-keyed `AdminConfig.blockAdmin` registry instead.
      * Placement is no longer expressed here — see the layout primitives above.
      */
     fields?: Record<string, FieldAdminConfig>;
@@ -329,9 +321,11 @@ export interface CollectionAdminConfig<T = any> {
      * }
      * ```
      *
-     * Returned URLs may be relative (`/news/foo`) for same-origin hosts
-     * or absolute (`https://example.com/news/foo`) for hosts deployed
-     * separately from the admin.
+     * Returned URLs may be relative (`/news/foo`) for same-origin hosts or
+     * absolute (`https://example.com/news/foo`) for navigation to another
+     * origin. An absolute URL does not transfer Byline's host-only admin and
+     * preview cookies; cross-origin draft preview therefore requires a separate
+     * authentication and preview-state handoff.
      *
      * Future consideration — a per-collection `preview.populate` hint
      * (`PopulateSpec`) was prototyped and removed. The edit-view loader
@@ -403,7 +397,7 @@ export declare function defineAdmin<T = any>(schema: CollectionDefinition, confi
  * `CollectionAdminConfig`, carrying **rendering overrides only**.
  *
  * Linked to a `Block` by `blockType` matching the block's `blockType`, and
- * registered site-wide on `ClientConfig.blockAdmin`. Because blocks are
+ * registered site-wide on `AdminConfig.blockAdmin`. Because blocks are
  * cross-collection units (the same `defineBlock()` object is typically shared
  * by several collections, and codegen dedupes their contracts structurally),
  * a block's admin config applies wherever the block renders. If one

package/dist/@types/collection-types.d.ts

@@ -8,7 +8,7 @@
 import type { RequestContext } from '@byline/auth';
 import type { ReadContext } from './db-types.js';
 import type { FieldSetData, FieldSetDataAllLocales, StoredFileValue } from './field-data-types.js';
-import type { Block, DefaultValue, Field, FileField, ImageField } from './field-types.js';
+import type { Block, Field, FileField, ImageField } from './field-types.js';
 import type { QueryPredicate } from './query-predicate.js';
 import type { SearchFieldDecl } from './search-types.js';
 import type { IStorageProvider } from './storage-types.js';
@@ -1340,60 +1340,3 @@ export type CollectionDataAllLocales<C extends CollectionDefinition> = Prettify<
     created_at: Date;
     updated_at: Date;
 } & CollectionFieldDataAllLocales<C>>;
-/**
- * A field definition with all function-valued properties stripped.
- *
- * Safe for JSON serialization — use for API responses, SSR loader return
- * values, RSC props, mobile clients, and CLI introspection. The following
- * are omitted:
- * - `validate` — client UI concern, cannot cross a network boundary
- * - `hooks`    — field-level hooks are always functions
- * - `defaultValue` — only literal (non-function) defaults are preserved
- *
- * Nested `fields` (composite / array / blocks) are recursively serialized.
- */
-export type SerializableField = Omit<Field, 'validate' | 'hooks' | 'defaultValue' | 'fields' | 'blocks'> & {
-    /** Only literal defaults are serializable; function defaults are dropped. */
-    defaultValue?: Exclude<DefaultValue, (...args: any[]) => any>;
-    /** Recursively serializable child fields (group / array). */
-    fields?: SerializableField[];
-    /** Recursively serializable blocks (blocks field). */
-    blocks?: SerializableBlock[];
-};
-/**
- * A block definition with all function-valued properties stripped.
- */
-export type SerializableBlock = Omit<Block, 'validate' | 'hooks' | 'fields'> & {
-    fields: SerializableField[];
-};
-/**
- * A collection definition with all function-valued properties stripped.
- *
- * Safe for JSON serialization — use for API schema endpoints, SSR loaders,
- * RSC components, mobile clients, and any context where the full definition
- * (with live functions) cannot be transmitted.
- *
- * - Collection-level `hooks` are entirely omitted (all entries are functions).
- * - Field `validate`, `hooks`, and function `defaultValue` are stripped.
- *
- * On the receiving end, resolve the full `CollectionDefinition` from the
- * local config store via `getCollectionDefinition(path)` to regain access
- * to validators, hooks, and computed defaults.
- */
-export type SerializableCollectionDefinition = Omit<CollectionDefinition, 'hooks' | 'fields'> & {
-    fields: SerializableField[];
-};
-/**
- * Strips all function-valued properties from a `CollectionDefinition`,
- * producing a version safe for JSON serialization.
- *
- * @example
- * ```ts
- * // In an API route:
- * return Response.json(toSerializableCollection(collectionDef))
- *
- * // In an SSR loader:
- * return { schema: toSerializableCollection(collectionDef), document: data }
- * ```
- */
-export declare function toSerializableCollection(def: CollectionDefinition): SerializableCollectionDefinition;

package/dist/@types/collection-types.js

@@ -277,48 +277,3 @@ export function defineBlock(definition) {
 export function defineField(definition) {
     return definition;
 }
-/**
- * Strips all function-valued properties from a `CollectionDefinition`,
- * producing a version safe for JSON serialization.
- *
- * @example
- * ```ts
- * // In an API route:
- * return Response.json(toSerializableCollection(collectionDef))
- *
- * // In an SSR loader:
- * return { schema: toSerializableCollection(collectionDef), document: data }
- * ```
- */
-export function toSerializableCollection(def) {
-    function serializeField(field) {
-        // biome-ignore lint/suspicious/noExplicitAny: intentional structural spread
-        const { validate: _v, hooks: _h, defaultValue, fields, blocks, ...rest } = field;
-        const serialized = { ...rest };
-        // Keep defaultValue only when it is a literal (not a factory function)
-        if (defaultValue !== undefined && typeof defaultValue !== 'function') {
-            serialized.defaultValue = defaultValue;
-        }
-        // Recurse into nested child fields (group / array)
-        if (Array.isArray(fields)) {
-            serialized.fields = fields.map(serializeField);
-        }
-        // Recurse into blocks (blocks field)
-        if (Array.isArray(blocks)) {
-            serialized.blocks = blocks.map(serializeBlock);
-        }
-        return serialized;
-    }
-    function serializeBlock(block) {
-        const { validate: _v, hooks: _h, fields, ...rest } = block;
-        return {
-            ...rest,
-            fields: fields.map(serializeField),
-        };
-    }
-    const { hooks: _hooks, fields, ...rest } = def;
-    return {
-        ...rest,
-        fields: fields.map(serializeField),
-    };
-}

package/dist/@types/db-types.d.ts

@@ -1,7 +1,6 @@
 import type { RequestContext } from '@byline/auth';
 import type { CollectionDefinition } from '@byline/core';
 import type { DbErrorClassification } from '../lib/errors.js';
-import type { QueryPredicate } from './query-predicate.js';
 /**
  * Read mode for document queries.
  *
@@ -61,11 +60,6 @@ export interface ReadContext {
      * (the cycle-stub path).
      */
     visited: Set<string>;
-    /**
-     * @deprecated Ignored. `beforeRead` authorization state is module-private
-     * and authority-bound; this optional slot remains only for source compatibility.
-     */
-    beforeReadCache?: Map<string, QueryPredicate | null>;
     /** Monotonic count of document materialisations; compared against `maxReads`. */
     readCount: number;
     /** Hard ceiling on materialisations per request. Default 500. */

package/dist/@types/field-types.d.ts

@@ -715,7 +715,7 @@ export interface FieldComponentSlots {
  *
  * Editor packages (e.g. `@byline/richtext-lexical`) expose a component
  * matching this shape, and the installation registers it as the
- * site-wide default via `ClientConfig.fields.richText.editor`.
+ * site-wide default via `AdminConfig.fields.richText.editor`.
  */
 export interface RichTextEditorProps {
     /** The field definition (label / helpText / optional / hooks / validate). */
@@ -733,7 +733,7 @@ export interface RichTextEditorProps {
 }
 /**
  * Component shape an editor package must export to be plugged in via
- * `ClientConfig.fields.richText.editor`. Built on `SlotComponent` so the
+ * `AdminConfig.fields.richText.editor`. Built on `SlotComponent` so the
  * type stays React-agnostic at the `@byline/core` boundary.
  */
 export type RichTextEditorComponent = SlotComponent<RichTextEditorProps>;

package/dist/@types/site-config.d.ts

@@ -33,14 +33,12 @@ export interface RoutesConfigInput {
     signIn?: string;
 }
 /**
- * Common configuration shared by the server and client. Contains only
- * serializable, framework-agnostic properties — no React components, no
- * database adapters, no storage providers.
+ * Common live configuration shared by the server and admin client. This is an
+ * in-process runtime contract, not a JSON or transport representation.
  */
 export interface BaseConfig {
-    serverURL: string;
     i18n: {
-        interface: {
+        admin: {
             defaultLocale: string;
             locales: string[];
             /**
@@ -80,7 +78,7 @@ export interface BaseConfig {
             locales: string[];
             /**
              * Optional display names for the content locales a document can be
-             * published in. Mirrors `interface.localeDefinitions`, but for the
+             * published in. Mirrors `admin.localeDefinitions`, but for the
              * *content* dimension rather than the admin chrome.
              *
              * Byline itself does not render these — the content-locale set has
@@ -109,8 +107,8 @@ export interface BaseConfig {
          *
          * Optional at the type level so `BaseConfig` stays loose for tests
          * and seed scripts; required at runtime via `validateTranslations`
-         * whenever `interface.locales` is non-empty. See `docs/08-internationalization/index.md` for
-         * the design.
+         * whenever `admin.locales` is non-empty. See
+         * `docs/08-internationalization/index.md` for the design.
          *
          * The shape is declared inline (rather than imported from
          * `@byline/i18n`) so `@byline/core` stays a leaf-ish package. The
@@ -140,12 +138,12 @@ export type TranslationBundleShape = Readonly<{
     }>;
 }>;
 /**
- * Client-side configuration. Extends BaseConfig with admin UI presentation
+ * Admin configuration. Extends BaseConfig with admin UI presentation
  * config (React components, formatters, column definitions, etc.).
  *
- * Used by `defineClientConfig()` and consumed by admin UI routes.
+ * Used by `defineAdminConfig()` and consumed by admin UI routes.
  */
-export interface ClientConfig extends BaseConfig {
+export interface AdminConfig extends BaseConfig {
     /** Admin UI configuration for collections (client-side only). */
     admin?: CollectionAdminConfig[];
     /**
@@ -169,8 +167,9 @@ export interface ClientConfig extends BaseConfig {
      * back to the default `slugify` from `@byline/core` when not set — so
      * installations that keep the default slugifier need not set this at all.
      *
-     * Lives on `ClientConfig` rather than `BaseConfig` because it is a function
-     * (not serialisable), and `BaseConfig` is contractually serialisable.
+     * Lives on `AdminConfig` because only the admin path widget consumes this
+     * client-side copy. `ServerConfig` declares the authoritative server copy
+     * separately.
      *
      * @see ServerConfig.slugifier
      */
@@ -184,7 +183,7 @@ export interface ClientConfig extends BaseConfig {
      * ```ts
      * import { RichTextField } from '@byline/richtext-lexical'
      *
-     * defineClientConfig({
+     * defineAdminConfig({
      *   // ...
      *   fields: {
      *     richText: { editor: RichTextField },
@@ -203,8 +202,8 @@ export interface ClientConfig extends BaseConfig {
         };
     };
 }
-/** Client config returned after boundary validation and canonicalization. */
-export type ResolvedClientConfig = Omit<ClientConfig, 'routes'> & {
+/** Admin config returned after boundary validation and canonicalization. */
+export type ResolvedAdminConfig = Omit<AdminConfig, 'routes'> & {
     routes: RoutesConfig;
 };
 /**
@@ -230,7 +229,7 @@ export interface ServerHooksConfig {
 }
 /**
  * Server-side configuration. Extends BaseConfig with database and storage
- * adapters. Deliberately does NOT extend ClientConfig — the server has no
+ * adapters. Deliberately does NOT extend AdminConfig — the server has no
  * knowledge of React components or admin UI presentation logic.
  *
  * Generic over `TAdminStore` so installations can thread an adapter-built
@@ -280,8 +279,8 @@ export interface ServerConfig<TAdminStore = unknown> extends BaseConfig {
      *
      * This is the **server-side** copy (the authoritative one — its output is
      * what gets persisted). For the admin path-widget's live preview to match,
-     * register the *same* function on `ClientConfig.slugifier` via
-     * `defineClientConfig`. See {@link ClientConfig.slugifier}.
+     * register the *same* function on `AdminConfig.slugifier` via
+     * `defineAdminConfig`. See {@link AdminConfig.slugifier}.
      */
     slugifier?: SlugifierFn;
     /**
@@ -353,7 +352,7 @@ export interface ServerConfig<TAdminStore = unknown> extends BaseConfig {
     adminStore?: TAdminStore;
     /**
      * Site-wide field-level server adapter slots. Mirrors
-     * `ClientConfig.fields` for the server side — each entry plugs an
+     * `AdminConfig.fields` for the server side — each entry plugs an
      * adapter package into a framework-managed read or write phase.
      *
      * @example

package/dist/@types/store-types.d.ts

@@ -5,7 +5,6 @@
  *
  * Copyright (c) Infonomic Company Limited
  */
-import type { UnifiedFieldValue } from '../storage/storage-row-types.js';
 export interface BaseStore {
     field_path: string;
     field_name: string;
@@ -90,8 +89,3 @@ export declare function isRelationStore(fieldValue: FlattenedStore): fieldValue
 export declare function isJsonStore(fieldValue: FlattenedStore): fieldValue is JsonStore;
 export declare function isNumericStore(fieldValue: FlattenedStore): fieldValue is NumericStore;
 export declare function isDateTimeStore(fieldValue: FlattenedStore): fieldValue is DateTimeStore;
-/**
- * @deprecated Use {@link UnifiedFieldValue} from '@byline/core' — same shape;
- * this alias remains for source compatibility.
- */
-export type UnionRowValue = UnifiedFieldValue;

package/dist/auth/apply-before-read.test.node.js

@@ -102,36 +102,6 @@ describe('applyBeforeRead', () => {
         expect(second).toBeNull();
         expect(callCount).toBe(1);
     });
-    it('ignores a caller-preseeded public cache entry', async () => {
-        const hook = vi.fn(() => ({ title: 'allowed' }));
-        const readContext = createReadContext({
-            beforeReadCache: new Map([['posts:any', null]]),
-        });
-        const result = await applyBeforeRead({
-            definition: baseCollection(hook),
-            requestContext: createRequestContext(),
-            readContext,
-        });
-        expect(hook).toHaveBeenCalledOnce();
-        expect(result).toEqual({ title: 'allowed' });
-    });
-    it('ignores a caller-preseeded public cache entry on the compiled-filter path', async () => {
-        const hook = vi.fn(() => ({ title: 'allowed' }));
-        const readContext = createReadContext({
-            beforeReadCache: new Map([['posts:any', null]]),
-        });
-        const filters = await compileBeforeReadFilters({
-            definition: baseCollection(hook),
-            requestContext: createRequestContext(),
-            readContext,
-            securityDomain: {},
-            parseContext: { collections: [], resolveCollectionId: vi.fn() },
-        });
-        expect(hook).toHaveBeenCalledOnce();
-        expect(filters).toEqual([
-            expect.objectContaining({ kind: 'field', fieldName: 'title', value: 'allowed' }),
-        ]);
-    });
     it('rejects reuse under a different actor authority', async () => {
         const hook = vi.fn(({ requestContext }) => ({
             title: requestContext.actor?.id,

package/dist/auth/read-context-scope.js

@@ -22,11 +22,6 @@ export function createHookReadContext(parent, entry) {
     const scoped = {};
     Object.defineProperties(scoped, {
         visited: { enumerable: true, get: () => root.visited, set: (value) => (root.visited = value) },
-        beforeReadCache: {
-            enumerable: true,
-            get: () => root.beforeReadCache,
-            set: (value) => (root.beforeReadCache = value),
-        },
         readCount: {
             enumerable: true,
             get: () => root.readCount,

package/dist/config/attach-hooks.test.node.js

@@ -137,12 +137,11 @@ describe('server hook attachment', () => {
             hooks: { collections: { documents: stable } },
         }));
         const invalid = {
-            serverURL: 'https://example.test',
             collections: [definition],
             db: {},
             hooks: { collections: { documents: replacement } },
             i18n: {
-                interface: { defaultLocale: 'en', locales: ['en'] },
+                admin: { defaultLocale: 'en', locales: ['en'] },
                 content: { defaultLocale: 'en', locales: [] },
             },
         };

package/dist/config/config-hooks.test.node.js

@@ -1,5 +1,5 @@
 import { afterEach, describe, expect, it } from 'vitest';
-import { defineClientConfig, defineServerConfig, getCollectionDefinition } from './config.js';
+import { defineAdminConfig, defineServerConfig, getCollectionDefinition } from './config.js';
 const SERVER_CONFIG = Symbol.for('__byline_server_config__');
 const CLIENT_CONFIG = Symbol.for('__byline_client_config__');
 const previousServer = globalThis[SERVER_CONFIG];
@@ -23,16 +23,16 @@ function definition(path) {
     };
 }
 const i18n = {
-    interface: { defaultLocale: 'en', locales: [] },
+    admin: { defaultLocale: 'en', locales: [] },
     content: { defaultLocale: 'en', locales: [] },
 };
 describe('collection definition config preference', () => {
-    it('uses client definitions when only client config is registered', () => {
+    it('uses client definitions when only admin config is registered', () => {
         const globals = globalThis;
         delete globals[SERVER_CONFIG];
         delete globals[CLIENT_CONFIG];
         const client = definition('client-only');
-        defineClientConfig({ serverURL: 'https://example.test', collections: [client], i18n });
+        defineAdminConfig({ collections: [client], i18n });
         expect(getCollectionDefinition('client-only')).toBe(client);
     });
     it('prefers hook-attached server definitions when both configs are registered', () => {
@@ -42,9 +42,8 @@ describe('collection definition config preference', () => {
         const client = definition('docs');
         const server = definition('docs');
         const hooks = {};
-        defineClientConfig({ serverURL: 'https://example.test', collections: [client], i18n });
+        defineAdminConfig({ collections: [client], i18n });
         defineServerConfig({
-            serverURL: 'https://example.test',
             collections: [server],
             db: {},
             hooks: { collections: { docs: hooks } },

package/dist/config/config.d.ts

@@ -1,4 +1,4 @@
-import type { ClientConfig, CollectionAdminConfig, CollectionDefinition, ColumnDefinition, ResolvedClientConfig, ResolvedServerConfig, ServerConfig } from '../@types/index.js';
+import type { AdminConfig, CollectionAdminConfig, CollectionDefinition, ResolvedAdminConfig, ResolvedServerConfig, ServerConfig } from '../@types/index.js';
 /**
  * Resolve a collection definition by `path`. Returns `null` either when
  * no config has been registered (e.g. unit tests, isolated tooling) or
@@ -7,29 +7,18 @@ import type { ClientConfig, CollectionAdminConfig, CollectionDefinition, ColumnD
  * without try/catch.
  *
  * If a caller genuinely *requires* a registered config to proceed, it
- * should reach for `getClientConfig()` / `getServerConfig()` — those
+ * should reach for `getAdminConfig()` / `getServerConfig()` — those
  * still throw the loud "Byline has not been configured" error.
  */
 export declare const getCollectionDefinition: (path: string) => CollectionDefinition | null;
 export declare const getCollectionAdminConfig: (slug: string) => CollectionAdminConfig | null;
-/**
- * Resolve a collection's item-row/tile columns — the per-collection projection
- * + presentation contract used by the relation picker, relation/`hasMany`
- * tiles, and (planned) search-result rows.
- *
- * Prefers the canonical {@link CollectionAdminConfig.itemView}, falling back to
- * the deprecated `picker` alias. Always read item-view columns through this
- * helper rather than touching `config.picker` directly, so the alias keeps
- * working until it is removed.
- */
-export declare const resolveItemViewColumns: (config: CollectionAdminConfig | null | undefined) => ColumnDefinition[] | undefined;
-export declare function defineClientConfig(config: ClientConfig): ResolvedClientConfig;
+export declare function defineAdminConfig(config: AdminConfig): ResolvedAdminConfig;
 export declare function defineServerConfig<TAdminStore = unknown>(config: ServerConfig<TAdminStore>): ResolvedServerConfig<TAdminStore>;
 /** Resolve and validate server config without replacing the registered singleton. */
 export declare function resolveServerConfig<TAdminStore = unknown>(config: ServerConfig<TAdminStore>): ResolvedServerConfig<TAdminStore>;
 /** Internal commit step used after initialization has completed successfully. */
 export declare function registerServerConfig<TAdminStore = unknown>(config: ResolvedServerConfig<TAdminStore>): ResolvedServerConfig<TAdminStore>;
-export declare function getClientConfig(): ResolvedClientConfig;
+export declare function getAdminConfig(): ResolvedAdminConfig;
 export declare function getServerConfig(): ResolvedServerConfig;
 /**
  * Order a set of locale codes by their position in the configured content

package/dist/config/config.js

@@ -10,7 +10,7 @@ import { validateCollections } from './validate-collections.js';
 // through different module graphs) shares the same state.
 // ---------------------------------------------------------------------------
 const BYLINE_SERVER_CONFIG = Symbol.for('__byline_server_config__');
-const BYLINE_CLIENT_CONFIG = Symbol.for('__byline_client_config__');
+const BYLINE_ADMIN_CONFIG = Symbol.for('__byline_admin_config__');
 const BYLINE_CORE = Symbol.for('__byline_core__');
 const preparedHookAttachments = new WeakMap();
 function getServerConfigInstance() {
@@ -20,12 +20,12 @@ function setServerConfigInstance(config) {
     ;
     globalThis[BYLINE_SERVER_CONFIG] = config;
 }
-function getClientConfigInstance() {
-    return globalThis[BYLINE_CLIENT_CONFIG] ?? null;
+function getAdminConfigInstance() {
+    return globalThis[BYLINE_ADMIN_CONFIG] ?? null;
 }
-function setClientConfigInstance(config) {
+function setAdminConfigInstance(config) {
     ;
-    globalThis[BYLINE_CLIENT_CONFIG] = config;
+    globalThis[BYLINE_ADMIN_CONFIG] = config;
 }
 function getBylineCoreInstance() {
     return globalThis[BYLINE_CORE] ?? null;
@@ -42,38 +42,27 @@ function setBylineCoreInstance(core) {
  * without try/catch.
  *
  * If a caller genuinely *requires* a registered config to proceed, it
- * should reach for `getClientConfig()` / `getServerConfig()` — those
+ * should reach for `getAdminConfig()` / `getServerConfig()` — those
  * still throw the loud "Byline has not been configured" error.
  */
 export const getCollectionDefinition = (path) => {
-    const config = getServerConfigInstance() ?? getClientConfigInstance();
+    const config = getServerConfigInstance() ?? getAdminConfigInstance();
     if (config == null)
         return null;
     return config.collections.find((collection) => collection.path === path) ?? null;
 };
 export const getCollectionAdminConfig = (slug) => {
-    const clientConfig = getClientConfigInstance();
-    if (clientConfig == null)
+    const adminConfig = getAdminConfigInstance();
+    if (adminConfig == null)
         return null;
-    return clientConfig.admin?.find((admin) => admin.slug === slug) ?? null;
+    return adminConfig.admin?.find((admin) => admin.slug === slug) ?? null;
 };
-/**
- * Resolve a collection's item-row/tile columns — the per-collection projection
- * + presentation contract used by the relation picker, relation/`hasMany`
- * tiles, and (planned) search-result rows.
- *
- * Prefers the canonical {@link CollectionAdminConfig.itemView}, falling back to
- * the deprecated `picker` alias. Always read item-view columns through this
- * helper rather than touching `config.picker` directly, so the alias keeps
- * working until it is removed.
- */
-export const resolveItemViewColumns = (config) => config?.itemView ?? config?.picker;
-export function defineClientConfig(config) {
+export function defineAdminConfig(config) {
     validateCollections(config.collections);
     validateAdminConfigs(config.admin, config.collections);
     validateBlockAdminConfigs(config.blockAdmin, config.collections);
     const resolved = { ...config, routes: resolveRoutes(config.routes) };
-    setClientConfigInstance(resolved);
+    setAdminConfigInstance(resolved);
     return resolved;
 }
 export function defineServerConfig(config) {
@@ -93,18 +82,18 @@ export function registerServerConfig(config) {
     setServerConfigInstance(config);
     return config;
 }
-export function getClientConfig() {
-    const clientConfig = getClientConfigInstance();
-    if (clientConfig != null) {
-        return clientConfig;
+export function getAdminConfig() {
+    const adminConfig = getAdminConfigInstance();
+    if (adminConfig != null) {
+        return adminConfig;
     }
-    // During SSR the client entry has not run yet, but the server config
-    // carries the same collection definitions.  Return a compatible object
-    // so route loaders and components work in both contexts.
+    // During SSR the admin entry has not run yet, but the server config carries
+    // the shared i18n, route, collection, and slugifier values. Return a
+    // compatible object with empty admin presentation so route loaders and
+    // components work in both contexts without exposing the browser-only graph.
     const serverConfig = getServerConfigInstance();
     if (serverConfig != null) {
         return {
-            serverURL: serverConfig.serverURL,
             i18n: serverConfig.i18n,
             routes: serverConfig.routes,
             collections: serverConfig.collections,
@@ -115,7 +104,7 @@ export function getClientConfig() {
             slugifier: serverConfig.slugifier,
         };
     }
-    throw new Error('Byline has not been configured yet. Please call defineClientConfig in byline.config.ts first.');
+    throw new Error('Byline has not been configured yet. Please call defineAdminConfig in byline.config.ts first.');
 }
 export function getServerConfig() {
     if (typeof globalThis !== 'undefined' && 'window' in globalThis) {

package/dist/config/order-by-content-locale.test.node.js

@@ -19,9 +19,8 @@ describe('orderByContentLocale', () => {
         // Only `collections` is validated by `defineServerConfig`; the rest of
         // the shape is irrelevant to this helper, so a minimal cast is enough.
         defineServerConfig({
-            serverURL: 'http://test.local',
             i18n: {
-                interface: { defaultLocale: 'en', locales: ['en'] },
+                admin: { defaultLocale: 'en', locales: ['en'] },
                 content: { defaultLocale: 'en', locales: ['en', 'fr', 'es', 'de'] },
             },
             collections: [],
@@ -60,11 +59,10 @@ describe('orderByContentLocale', () => {
 describe('orderByContentLocale — boundary robustness', () => {
     beforeAll(() => {
         defineServerConfig({
-            serverURL: 'http://test.local',
             i18n: {
                 // Interface set (`en`, `de`) deliberately overlaps content only on `en`
                 // — `de` is interface-only here, NOT a content locale.
-                interface: { defaultLocale: 'en', locales: ['en', 'de'] },
+                admin: { defaultLocale: 'en', locales: ['en', 'de'] },
                 content: {
                     defaultLocale: 'en',
                     locales: ['en', 'fr', 'es'],

package/dist/config/routes.test.node.js

@@ -1,6 +1,6 @@
 import { describe, expect, it } from 'vitest';
 import { normalizeRootRelativeRedirect } from '../utils/root-relative-redirect.js';
-import { defineClientConfig, getClientConfig } from './config.js';
+import { defineAdminConfig, getAdminConfig } from './config.js';
 import { resolveRoutes } from './routes.js';
 describe('resolveRoutes', () => {
     it('returns canonical defaults', () => {
@@ -95,13 +95,12 @@ describe('normalizeRootRelativeRedirect', () => {
 describe('route configuration boundary', () => {
     it('stores and exposes resolved routes independently of partial input', () => {
         const input = { admin: 'internal/cms/' };
-        const registered = defineClientConfig({
-            serverURL: 'https://example.test',
+        const registered = defineAdminConfig({
             routes: input,
             collections: [],
             admin: [],
             i18n: {
-                interface: { defaultLocale: 'en', locales: [] },
+                admin: { defaultLocale: 'en', locales: [] },
                 content: { defaultLocale: 'en', locales: [] },
             },
         });
@@ -111,17 +110,16 @@ describe('route configuration boundary', () => {
             api: '/api',
             signIn: '/sign-in',
         });
-        expect(getClientConfig().routes).toBe(registered.routes);
+        expect(getAdminConfig().routes).toBe(registered.routes);
         expect(Object.isFrozen(registered.routes)).toBe(true);
     });
     it('prevents post-registration route mutation', () => {
-        const { routes } = defineClientConfig({
-            serverURL: 'https://example.test',
+        const { routes } = defineAdminConfig({
             routes: { admin: '/internal/cms' },
             collections: [],
             admin: [],
             i18n: {
-                interface: { defaultLocale: 'en', locales: [] },
+                admin: { defaultLocale: 'en', locales: [] },
                 content: { defaultLocale: 'en', locales: [] },
             },
         });
@@ -129,16 +127,15 @@ describe('route configuration boundary', () => {
             ;
             routes.admin = '/changed';
         }).toThrow(TypeError);
-        expect(getClientConfig().routes.admin).toBe('/internal/cms');
+        expect(getAdminConfig().routes.admin).toBe('/internal/cms');
     });
     it('rejects unsafe routes during registration', () => {
-        expect(() => defineClientConfig({
-            serverURL: 'https://example.test',
+        expect(() => defineAdminConfig({
             routes: { admin: '/cms?next=/account' },
             collections: [],
             admin: [],
             i18n: {
-                interface: { defaultLocale: 'en', locales: [] },
+                admin: { defaultLocale: 'en', locales: [] },
                 content: { defaultLocale: 'en', locales: [] },
             },
         })).toThrow(/routes\.admin/);

package/dist/config/validate-admin-configs.d.ts

@@ -39,7 +39,7 @@ export declare function validateAdminConfigs(admins: readonly CollectionAdminCon
 /**
  * Validate every block admin config in a configuration.
  *
- * Enforced rules (per `ClientConfig.blockAdmin` entry):
+ * Enforced rules (per `AdminConfig.blockAdmin` entry):
  *  1. Block pairing — `blockType` matches a block declared on at least one
  *     `type: 'blocks'` field across the registered collections (blocks have
  *     no global registry; the collections walk is the source of truth).

package/dist/config/validate-admin-configs.js

@@ -81,7 +81,7 @@ export function validateAdminConfigs(admins, collections) {
 /**
  * Validate every block admin config in a configuration.
  *
- * Enforced rules (per `ClientConfig.blockAdmin` entry):
+ * Enforced rules (per `AdminConfig.blockAdmin` entry):
  *  1. Block pairing — `blockType` matches a block declared on at least one
  *     `type: 'blocks'` field across the registered collections (blocks have
  *     no global registry; the collections walk is the source of truth).

package/dist/core.js

@@ -59,16 +59,16 @@ export const initBylineCore = async (config, pinoLogger) => {
     // lock, mutate, and append audit rows in one transaction.
     validateTreeAuditCapability(composed.collections, composed.db);
     // Validate the admin i18n translation registry against the configured
-    // interface locale set. Throws on structural errors (missing bundle for
+    // admin locale set. Throws on structural errors (missing bundle for
     // a declared locale, defaultLocale outside the permitted set, …); soft
     // warnings (key-set drift between locales) are logged so contributors
     // see translation gaps without it blocking boot. The bundle lives at
-    // `i18n.translations` (one axis, not nested under `interface`) — the
+    // `i18n.translations` (one axis, not nested under `admin`) — the
     // validator takes the assembled shape so locale config and bundle
     // travel together.
     const i18nValidation = validateTranslations({
-        defaultLocale: resolvedConfig.i18n.interface.defaultLocale,
-        locales: resolvedConfig.i18n.interface.locales,
+        defaultLocale: resolvedConfig.i18n.admin.defaultLocale,
+        locales: resolvedConfig.i18n.admin.locales,
         translations: resolvedConfig.i18n.translations,
     });
     for (const warning of i18nValidation.warnings) {

package/dist/core.test.node.js

@@ -3,12 +3,11 @@ import { defineServerConfig, getServerConfig } from './config/config.js';
 import { initBylineCore } from './core.js';
 function serverConfig(admin) {
     return {
-        serverURL: 'https://example.test',
         routes: { admin },
         collections: [],
         db: {},
         i18n: {
-            interface: { defaultLocale: 'en', locales: [] },
+            admin: { defaultLocale: 'en', locales: [] },
             content: { defaultLocale: 'en', locales: [] },
         },
     };
@@ -18,7 +17,7 @@ describe('initBylineCore configuration registration', () => {
         const valid = defineServerConfig(serverConfig('/stable/admin'));
         const invalid = serverConfig('/replacement/admin');
         invalid.i18n = {
-            interface: { defaultLocale: 'en', locales: ['en'] },
+            admin: { defaultLocale: 'en', locales: ['en'] },
             content: { defaultLocale: 'en', locales: [] },
         };
         await expect(initBylineCore(invalid, {})).rejects.toThrow(/translations bundle/i);

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export * from './@types/index.js';
 export { applyBeforeRead, assertActorCanPerform, bindReadContextAuthority, COLLECTION_ABILITY_VERBS, type CollectionAbilityVerb, collectionAbilityKey, compileBeforeReadFilters, registerCollectionAbilities, } from './auth/index.js';
-export { defineClientConfig, defineServerConfig, getClientConfig, getCollectionAdminConfig, getCollectionDefinition, getServerConfig, orderByContentLocale, resolveItemViewColumns, } from './config/config.js';
+export { defineAdminConfig, defineServerConfig, getAdminConfig, getCollectionAdminConfig, getCollectionDefinition, getServerConfig, orderByContentLocale, } from './config/config.js';
 export { resolveRoutes } from './config/routes.js';
 export { validateAdminConfigs, validateBlockAdminConfigs, } from './config/validate-admin-configs.js';
 export { RESERVED_FIELD_NAMES } from './config/validate-collections.js';

package/dist/index.js

@@ -16,7 +16,7 @@
 // ---------------------------------------------------------------------------
 export * from './@types/index.js';
 export { applyBeforeRead, assertActorCanPerform, bindReadContextAuthority, COLLECTION_ABILITY_VERBS, collectionAbilityKey, compileBeforeReadFilters, registerCollectionAbilities, } from './auth/index.js';
-export { defineClientConfig, defineServerConfig, getClientConfig, getCollectionAdminConfig, getCollectionDefinition, getServerConfig, orderByContentLocale, resolveItemViewColumns, } from './config/config.js';
+export { defineAdminConfig, defineServerConfig, getAdminConfig, getCollectionAdminConfig, getCollectionDefinition, getServerConfig, orderByContentLocale, } from './config/config.js';
 export { resolveRoutes } from './config/routes.js';
 export { validateAdminConfigs, validateBlockAdminConfigs, } from './config/validate-admin-configs.js';
 export { RESERVED_FIELD_NAMES } from './config/validate-collections.js';

package/dist/services/i18n-validator.d.ts

@@ -25,7 +25,7 @@
  *     normal during community-contributor flow.
  */
 import type { TranslationBundleShape } from '../@types/site-config.js';
-export interface InterfaceI18nConfig {
+export interface AdminI18nConfig {
     defaultLocale: string;
     locales: string[];
     translations?: TranslationBundleShape;
@@ -45,4 +45,4 @@ export interface ValidateTranslationsResult {
  * locale set. Throws on any structural error; returns soft warnings for
  * key-set drift between locales.
  */
-export declare function validateTranslations(i18n: InterfaceI18nConfig): ValidateTranslationsResult;
+export declare function validateTranslations(i18n: AdminI18nConfig): ValidateTranslationsResult;

package/dist/services/i18n-validator.js

@@ -15,7 +15,7 @@ export function validateTranslations(i18n) {
     const errors = [];
     // (1) Default must be in the permitted set.
     if (locales.length > 0 && !locales.includes(defaultLocale)) {
-        errors.push(`defaultLocale '${defaultLocale}' is not in i18n.interface.locales [${locales.join(', ')}]. ` +
+        errors.push(`defaultLocale '${defaultLocale}' is not in i18n.admin.locales [${locales.join(', ')}]. ` +
             `Add it to locales, or change defaultLocale to one of the existing entries.`);
     }
     // No locales declared → skip the remaining checks. Hosts that don't
@@ -26,8 +26,8 @@ export function validateTranslations(i18n) {
     }
     // (2) Non-empty locale set requires a translations bundle.
     if (translations == null) {
-        errors.push(`i18n.interface.locales declares [${locales.join(', ')}] but no translations bundle is registered. ` +
-            `Pass one to defineClientConfig via i18n.translations — see @byline/i18n's adminTranslations() ` +
+        errors.push(`i18n.admin.locales declares [${locales.join(', ')}] but no translations bundle is registered. ` +
+            `Pass one to defineAdminConfig via i18n.translations — see @byline/i18n's adminTranslations() ` +
             `and mergeTranslations() helpers.`);
         if (errors.length > 0) {
             throw new Error(formatErrors(errors));
@@ -38,7 +38,7 @@ export function validateTranslations(i18n) {
     for (const locale of locales) {
         const localeBundle = translations[locale];
         if (localeBundle == null || namespaceKeyCount(localeBundle) === 0) {
-            errors.push(`i18n.interface.locales includes '${locale}' but no translations are registered for it. ` +
+            errors.push(`i18n.admin.locales includes '${locale}' but no translations are registered for it. ` +
                 `Either drop '${locale}' from locales or wire a community bundle (e.g. @byline/i18n-${locale}).`);
         }
     }

package/dist/services/i18n-validator.test.node.js

@@ -46,7 +46,7 @@ describe('validateTranslations — structural errors', () => {
                 en: { 'byline-admin': { a: 'A' } },
                 fr: { 'byline-admin': { a: 'A' } },
             },
-        })).toThrow(/defaultLocale 'de' is not in i18n\.interface\.locales/);
+        })).toThrow(/defaultLocale 'de' is not in i18n\.admin\.locales/);
     });
     it('throws when locales is non-empty but no translations bundle is registered', () => {
         expect(() => validateTranslations({

package/dist/services/index.d.ts

@@ -8,7 +8,7 @@ export * from './document-lifecycle/index.js';
 export * from './document-read.js';
 export * from './document-to-markdown.js';
 export * from './field-upload.js';
-export { type InterfaceI18nConfig, type TranslationDriftWarning, type ValidateTranslationsResult, validateTranslations, } from './i18n-validator.js';
+export { type AdminI18nConfig, type TranslationDriftWarning, type ValidateTranslationsResult, validateTranslations, } from './i18n-validator.js';
 export { type CanonicalNumericFieldType, type CanonicalNumericValue, isCanonicalNumericValue, normalizeNumericFields, normalizeNumericValue, } from './normalize-numeric-fields.js';
 export { type CycleRelationValue, createReadContext, type PopulatedRelationValue, type PopulateFieldOptions, type PopulateFieldSpec, type PopulateMap, type PopulateOptions, type PopulateSpec, populateDocuments, type ReadContext, resolveIdentityField, type UnresolvedRelationValue, } from './populate.js';
 export { buildRelationSummaryPopulateMap, type RelationTargetResolver, resolveRelationProjection, } from './relation-projection.js';

package/dist/services/relation-projection.d.ts

@@ -5,6 +5,17 @@
  *
  * Copyright (c) Infonomic Company Limited
  */
+/**
+ * Relation projection helpers.
+ *
+ * Translate a source collection's relation fields into a `PopulateMap`
+ * projection that fetches just enough data from each target to render
+ * a relation-summary tile on the admin edit view (picker columns,
+ * `useAsTitle`, plus an optional source-side `displayField` override).
+ *
+ * Consumed by the admin webapp's edit-route server fn so relation tiles
+ * arrive pre-hydrated on first paint — no client-side fetch per relation.
+ */
 import type { CollectionAdminConfig, CollectionDefinition, FieldSet, RelationField } from '../@types/index.js';
 import type { PopulateMap } from './populate.js';
 /**

package/dist/services/relation-projection.js

@@ -5,18 +5,6 @@
  *
  * Copyright (c) Infonomic Company Limited
  */
-/**
- * Relation projection helpers.
- *
- * Translate a source collection's relation fields into a `PopulateMap`
- * projection that fetches just enough data from each target to render
- * a relation-summary tile on the admin edit view (picker columns,
- * `useAsTitle`, plus an optional source-side `displayField` override).
- *
- * Consumed by the admin webapp's edit-route server fn so relation tiles
- * arrive pre-hydrated on first paint — no client-side fetch per relation.
- */
-import { resolveItemViewColumns } from '../config/config.js';
 /**
  * Union of the target-collection field names needed to render a
  * relation-summary tile for the given source relation field.
@@ -38,7 +26,7 @@ export function resolveRelationProjection(sourceField, targetDef, targetAdmin) {
     const firstText = targetDef?.fields.find((f) => f.type === 'text')?.name;
     if (firstText)
         out.add(firstText);
-    const itemViewColumns = resolveItemViewColumns(targetAdmin);
+    const itemViewColumns = targetAdmin?.itemView;
     if (itemViewColumns) {
         for (const col of itemViewColumns) {
             const name = String(col.fieldName);

package/package.json

@@ -2,7 +2,7 @@
   "name": "@byline/core",
   "private": false,
   "license": "MPL-2.0",
-  "version": "4.11.2",
+  "version": "4.12.0",
   "engines": {
     "node": ">=20.9.0"
   },
@@ -82,7 +82,7 @@
     "sharp": "^0.35.3",
     "uuid": "^14.0.1",
     "zod": "^4.4.3",
-    "@byline/auth": "4.11.2"
+    "@byline/auth": "4.12.0"
   },
   "devDependencies": {
     "@biomejs/biome": "2.5.6",