@byline/cli 3.20.4 → 3.21.0

package/README.md

@@ -22,6 +22,20 @@ byline doctor                  Inspect the current app and report what's wired.
 
 See `byline init --help` for the full flag list.
 
+### Generated collection types
+
+`byline init` commits `byline/generated/collection-types.ts` and adds two application scripts:
+
+```sh
+pnpm byline:generate        # regenerate after changing collection or block schemas
+pnpm byline:generate:check  # fail without writing when the artifact is missing or stale
+```
+
+The application script evaluates `byline/collections/index.ts`; it does not load
+`server.config.ts`. That collection tuple remains the runtime registry, while the generated module
+is its deterministic, standalone TypeScript projection for typed clients and frontend code. Keep
+the artifact committed and run the check in CI.
+
 ### Already-wired apps (post-manual-config)
 
 If you wired Byline into your app by hand (collections, `server.config.ts`, env, routes, scaffold files all in place) and just need to provision the database and seed, use `setup` instead of `init`:

package/dist/phases/scaffold.d.ts

@@ -1,3 +1,5 @@
+import type { Context } from '../context.js';
 import type { Phase } from '../types.js';
 export declare const scaffoldPhase: Phase;
+export declare function ensureGenerationScripts(ctx: Context): string[];
 //# sourceMappingURL=scaffold.d.ts.map

package/dist/phases/scaffold.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../src/phases/scaffold.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAcxC,eAAO,MAAM,aAAa,EAAE,KA0D3B,CAAA"}
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../src/phases/scaffold.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAC5C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAkBxC,eAAO,MAAM,aAAa,EAAE,KA8D3B,CAAA;AAED,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,EAAE,CAmB9D"}

package/dist/phases/scaffold.js

@@ -3,6 +3,10 @@ import { dirname, join, relative } from 'node:path';
 const TARGET_DIR = 'byline';
 const BASE_TEMPLATE = 'byline';
 const EXAMPLES_TEMPLATE = 'byline-examples';
+const GENERATION_SCRIPTS = {
+    'byline:generate': 'tsx byline/scripts/generate-types.ts',
+    'byline:generate:check': 'tsx byline/scripts/generate-types.ts --check',
+};
 export const scaffoldPhase = {
     id: 'scaffold',
     title: 'Scaffold — copy byline/ config tree into the app root',
@@ -48,9 +52,31 @@ export const scaffoldPhase = {
         if (skipped > 0) {
             ctx.logger.info(`${skipped} file(s) already existed and were left untouched — re-running scaffold is non-destructive`);
         }
+        const addedScripts = ensureGenerationScripts(ctx);
+        if (addedScripts.length > 0) {
+            ctx.logger.success(`added package.json scripts: ${addedScripts.join(', ')}`);
+        }
         return { state: 'done' };
     },
 };
+export function ensureGenerationScripts(ctx) {
+    const packagePath = ctx.resolve('package.json');
+    if (!existsSync(packagePath))
+        return [];
+    const pkg = JSON.parse(readFileSync(packagePath, 'utf8'));
+    const scripts = { ...(pkg.scripts ?? {}) };
+    const added = [];
+    for (const [name, command] of Object.entries(GENERATION_SCRIPTS)) {
+        if (scripts[name] !== undefined)
+            continue;
+        scripts[name] = command;
+        added.push(name);
+    }
+    if (added.length === 0)
+        return added;
+    writeFileSync(packagePath, `${JSON.stringify({ ...pkg, scripts }, null, 2)}\n`, 'utf8');
+    return added;
+}
 function collectEntries(ctx, examples, importDocs) {
     const targetRoot = ctx.resolve(TARGET_DIR);
     const baseRoot = join(ctx.templatesDir(), BASE_TEMPLATE);

package/dist/phases/scaffold.js.map

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

package/dist/phases/scaffold.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=scaffold.test.d.ts.map

package/dist/phases/scaffold.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.test.d.ts","sourceRoot":"","sources":["../../src/phases/scaffold.test.ts"],"names":[],"mappings":""}

package/dist/phases/scaffold.test.js

@@ -0,0 +1,29 @@
+import { mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join, resolve } from 'node:path';
+import { afterEach, describe, expect, it } from 'vitest';
+import { ensureGenerationScripts } from './scaffold.js';
+const temporaryDirectories = [];
+afterEach(() => {
+    for (const directory of temporaryDirectories.splice(0)) {
+        rmSync(directory, { recursive: true, force: true });
+    }
+});
+describe('ensureGenerationScripts', () => {
+    it('adds generation commands without replacing an existing script', () => {
+        const directory = mkdtempSync(join(tmpdir(), 'byline-scaffold-'));
+        temporaryDirectories.push(directory);
+        writeFileSync(join(directory, 'package.json'), `${JSON.stringify({ scripts: { 'byline:generate': 'custom-generator' } }, null, 2)}\n`, 'utf8');
+        const ctx = {
+            resolve: (...parts) => resolve(directory, ...parts),
+        };
+        expect(ensureGenerationScripts(ctx)).toEqual(['byline:generate:check']);
+        const pkg = JSON.parse(readFileSync(join(directory, 'package.json'), 'utf8'));
+        expect(pkg.scripts).toEqual({
+            'byline:generate': 'custom-generator',
+            'byline:generate:check': 'tsx byline/scripts/generate-types.ts --check',
+        });
+        expect(ensureGenerationScripts(ctx)).toEqual([]);
+    });
+});
+//# sourceMappingURL=scaffold.test.js.map

package/dist/phases/scaffold.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.test.js","sourceRoot":"","sources":["../../src/phases/scaffold.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAC1E,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAChC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEzC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAExD,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAA;AAGvD,MAAM,oBAAoB,GAAa,EAAE,CAAA;AAEzC,SAAS,CAAC,GAAG,EAAE;IACb,KAAK,MAAM,SAAS,IAAI,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,MAAM,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IACrD,CAAC;AACH,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACvE,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,kBAAkB,CAAC,CAAC,CAAA;QACjE,oBAAoB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QACpC,aAAa,CACX,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,EAC/B,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EACtF,MAAM,CACP,CAAA;QACD,MAAM,GAAG,GAAG;YACV,OAAO,EAAE,CAAC,GAAG,KAAe,EAAE,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,KAAK,CAAC;SACnD,CAAA;QAEZ,MAAM,CAAC,uBAAuB,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAA;QACvE,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAE3E,CAAA;QACD,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC;YAC1B,iBAAiB,EAAE,kBAAkB;YACrC,uBAAuB,EAAE,8CAA8C;SACxE,CAAC,CAAA;QACF,MAAM,CAAC,uBAAuB,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;IAClD,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/templates/byline/admin.config.ts

@@ -8,20 +8,21 @@
 
 /**
  * Registers Byline's client-side config (collection admin UI configs,
- * field editors, i18n, routes) in the current module graph. Imported as
- * a side-effect from `src/routes/_byline/route.lazy.tsx` so registration
- * fires only when a `_byline/*` URL matches — keeping the Lexical
- * editor module graph out of public-route bundles entirely.
+ * field editors, i18n, routes) in the current module graph. The `_byline`
+ * route registers it from two complementary points: a dynamic import in
+ * `route.tsx` covers child loaders, while the side-effect import in
+ * `route.lazy.tsx` covers component render and initial hydration. Keeping
+ * both imports behind `_byline/*` keeps the admin graph off public routes.
  *
  * This is the minimal scaffold: no example collections registered. Add
- * collection schemas + admin configs to the `collections` and `admin`
- * arrays as you create them.
+ * schemas to `collections/index.ts` and presentation configs to `admin`.
  */
 
 import type { ClientConfig } from '@byline/core'
 import { defineClientConfig } from '@byline/core'
 import { RichTextField as LexicalRichTextField } from '@byline/richtext-lexical'
 
+import { collections } from './collections/index.js'
 import { i18n } from './i18n.js'
 import { DEFAULT_SERVER_URL, routes } from './routes.js'
 
@@ -31,7 +32,7 @@ export const config: ClientConfig = {
   serverURL,
   i18n,
   routes,
-  collections: [],
+  collections,
   admin: [],
   fields: {
     richText: { editor: LexicalRichTextField },

package/dist/templates/byline/client.server.ts

@@ -0,0 +1,32 @@
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ */
+
+/**
+ * Server-only application boundary for the host-owned client singletons.
+ * The host stays config-agnostic; this assertion binds it to the app registry.
+ */
+import type { BylineClient } from '@byline/client'
+import {
+  getAdminBylineClient as getHostAdminBylineClient,
+  getSystemBylineClient as getHostSystemBylineClient,
+} from '@byline/host-tanstack-start/integrations/byline-client'
+import { getPublicBylineClient as getHostPublicBylineClient } from '@byline/host-tanstack-start/integrations/byline-public-client'
+import {
+  getViewerBylineClient as getHostViewerBylineClient,
+  isPreviewActive,
+} from '@byline/host-tanstack-start/integrations/byline-viewer-client'
+
+import type { BylineCollections } from './collections/index.js'
+
+type AppBylineClient = BylineClient<BylineCollections>
+
+export const getAdminBylineClient = getHostAdminBylineClient as () => AppBylineClient
+export const getPublicBylineClient = getHostPublicBylineClient as () => AppBylineClient
+export const getSystemBylineClient = getHostSystemBylineClient as () => AppBylineClient
+export const getViewerBylineClient = getHostViewerBylineClient as () => AppBylineClient
+export { isPreviewActive }

package/dist/templates/byline/collection-types.contract.ts

@@ -0,0 +1,42 @@
+import type { CollectionFieldData, CollectionFieldDataAllLocales } from '@byline/core'
+
+import type { collections } from './collections/index.js'
+import type {
+  CollectionFieldsAllLocalesByPath,
+  CollectionFieldsByPath,
+} from './generated/collection-types.js'
+
+type InferredFieldsByPath = {
+  [Definition in (typeof collections)[number] as Definition['path']]: CollectionFieldData<Definition>
+}
+
+type InferredFieldsAllLocalesByPath = {
+  [Definition in (typeof collections)[number] as Definition['path']]: CollectionFieldDataAllLocales<Definition>
+}
+
+type IsAny<Value> = 0 extends 1 & Value ? true : false
+type Exact<Left, Right> = IsAny<Left> extends true
+  ? IsAny<Right>
+  : IsAny<Right> extends true
+    ? false
+    : (<Value>() => Value extends Left ? 1 : 2) extends <Value>() =>
+          Value extends Right ? 1 : 2
+      ? (<Value>() => Value extends Right ? 1 : 2) extends <Value>() =>
+          Value extends Left ? 1 : 2
+        ? true
+        : false
+      : false
+type Assert<Value extends true> = Value
+
+type GeneratedKeysMatchRuntimeRegistry = Assert<
+  Exact<keyof CollectionFieldsByPath, keyof InferredFieldsByPath>
+>
+type GeneratedFieldsMatchRuntimeRegistry = Assert<
+  Exact<CollectionFieldsByPath, InferredFieldsByPath>
+>
+type GeneratedAllLocalesKeysMatchRuntimeRegistry = Assert<
+  Exact<keyof CollectionFieldsAllLocalesByPath, keyof InferredFieldsAllLocalesByPath>
+>
+type GeneratedAllLocalesFieldsMatchRuntimeRegistry = Assert<
+  Exact<CollectionFieldsAllLocalesByPath, InferredFieldsAllLocalesByPath>
+>

package/dist/templates/byline/collections/index.ts

@@ -0,0 +1,17 @@
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ */
+
+import type { InferCollectionRegistry } from '@byline/core'
+
+import type { CollectionFieldsByPath } from '../generated/collection-types.js'
+
+/** Add schema-only collection imports here; keep admin presentation separate. */
+export const collections = [] as const
+
+export type InferredBylineCollections = InferCollectionRegistry<typeof collections>
+export type BylineCollections = CollectionFieldsByPath

package/dist/templates/byline/generated/collection-types.ts

@@ -0,0 +1,11 @@
+// Generated by @byline/core/codegen
+// Format version: 1
+// Hash: 4ef42b796dc35fceb394f97eaef885c5795c52031ba91f9ca6ca7e0fd2f20608
+
+export type CollectionFieldsByPath = {
+}
+
+export type CollectionFieldsAllLocalesByPath = {
+}
+
+export type CollectionPath = keyof CollectionFieldsByPath

package/dist/templates/byline/i18n.ts

@@ -12,9 +12,9 @@
  * translation bundle.
  *
  * The locale arrays themselves live in `./locales.ts`, a dependency-free leaf
- * module, so the public frontend can import them without pulling in the admin
- * translation graph this file depends on. Re-exported here for back-compat
- * with existing `~/i18n` importers.
+ * module exposed to public frontend code by `./public.ts`, without pulling in
+ * the admin translation graph this file depends on. Re-exported here for
+ * back-compat with existing `~/i18n` importers.
  *
  * `interface` locales govern the CMS admin UI language.
  * `content` locales govern the languages a document can be published in.

package/dist/templates/byline/locales.ts

@@ -12,12 +12,12 @@
  * registry). `byline/i18n.ts` consumes these to assemble the
  * `defineServerConfig` / `defineClientConfig` payload.
  *
- * Kept separate from `byline/i18n.ts` so a public frontend (or a collection
- * schema file loaded outside Vite — e.g. when running seeds via tsx) can
- * import the locale arrays without dragging in the admin translation graph
- * (`@byline/i18n/admin`) that `i18n.ts` depends on. Importing `byline/i18n.ts`
- * would; importing this won't — which keeps the lazy admin/public bundle split
- * (`src/routes/_byline/route.lazy.tsx`) intact.
+ * Kept separate from `byline/i18n.ts` so `byline/public.ts` can expose the
+ * locale arrays to a public frontend (or a collection schema file loaded
+ * outside Vite — e.g. when running seeds via tsx) without dragging in the
+ * admin translation graph (`@byline/i18n/admin`) that `i18n.ts` depends on.
+ * Importing `byline/i18n.ts` would; importing this won't — which keeps the lazy
+ * admin/public bundle split (`src/routes/_byline/route.lazy.tsx`) intact.
  *
  * `interface` locales govern the CMS admin UI language; `content` locales
  * govern the languages a document can be published in.
@@ -33,10 +33,10 @@ export interface LocaleDefinition {
 // (or a third-party plugin merged in via `mergeTranslations(...)`).
 // `adminTranslations({ locales })` in `byline/i18n.ts` throws at boot if a
 // requested code is not bundled — `@byline/i18n/admin` ships English and French.
-export const interfaceLocales: LocaleDefinition[] = [
+export const interfaceLocales = [
   { code: 'en', label: 'English' },
   { code: 'fr', label: 'Français' },
-]
+] as const satisfies readonly LocaleDefinition[]
 
 /** Locales a document can be published in. */
 export const contentLocales = [
@@ -44,4 +44,4 @@ export const contentLocales = [
   { code: 'fr', label: 'Français' },
   { code: 'es', label: 'Español' },
   { code: 'de', label: 'Deutsch' },
-] as const
+] as const satisfies readonly LocaleDefinition[]

package/dist/templates/byline/public.ts

@@ -0,0 +1,12 @@
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ */
+
+/** Client-safe public configuration. Keep this barrel free of admin and server imports. */
+export { contentLocales, interfaceLocales } from './locales.js'
+export { routes } from './routes.js'
+export type { LocaleDefinition } from './locales.js'

package/dist/templates/byline/scripts/generate-types.ts

@@ -0,0 +1,81 @@
+import { randomUUID } from 'node:crypto'
+import { existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from 'node:fs'
+import { dirname, resolve } from 'node:path'
+import { fileURLToPath, pathToFileURL } from 'node:url'
+
+import { emitCollectionTypes } from '@byline/core/codegen'
+
+import { collections } from '../collections/index.js'
+
+const defaultOutputPath = fileURLToPath(
+  new URL('../generated/collection-types.ts', import.meta.url)
+)
+
+export type GenerationStatus = 'current' | 'unchanged' | 'written'
+
+export function writeCollectionTypes(
+  outputPath: string,
+  source: string,
+  check: boolean
+): GenerationStatus {
+  const existing = existsSync(outputPath) ? readFileSync(outputPath, 'utf8') : undefined
+
+  if (check) {
+    if (existing === undefined) {
+      throw new Error(
+        `generated collection types are missing: ${outputPath}. Run pnpm byline:generate`
+      )
+    }
+    if (existing !== source) {
+      throw new Error(
+        `generated collection types are stale: ${outputPath}. Run pnpm byline:generate`
+      )
+    }
+    return 'current'
+  }
+
+  if (existing === source) return 'unchanged'
+
+  mkdirSync(dirname(outputPath), { recursive: true })
+  const temporaryPath = `${outputPath}.${process.pid}.${randomUUID()}.tmp`
+  try {
+    writeFileSync(temporaryPath, source, 'utf8')
+    renameSync(temporaryPath, outputPath)
+  } finally {
+    rmSync(temporaryPath, { force: true })
+  }
+  return 'written'
+}
+
+function parseArgs(args: readonly string[]): { check: boolean } {
+  const unknown = args.filter((arg) => arg !== '--check')
+  if (unknown.length > 0) throw new Error(`unknown argument: ${unknown.join(', ')}`)
+  if (args.filter((arg) => arg === '--check').length > 1) {
+    throw new Error('duplicate argument: --check')
+  }
+  return { check: args.includes('--check') }
+}
+
+export function generateCollectionTypes(
+  outputPath = defaultOutputPath,
+  check = false
+): { hash: string; status: GenerationStatus } {
+  const { source, hash } = emitCollectionTypes(collections)
+  return { hash, status: writeCollectionTypes(outputPath, source, check) }
+}
+
+function main(): void {
+  const { check } = parseArgs(process.argv.slice(2))
+  const { hash, status } = generateCollectionTypes(defaultOutputPath, check)
+  console.log(`collection types: ${collections.length} collections ${hash.slice(0, 12)} ${status}`)
+}
+
+const entryPath = process.argv[1]
+if (entryPath !== undefined && pathToFileURL(resolve(entryPath)).href === import.meta.url) {
+  try {
+    main()
+  } catch (error) {
+    console.error(`collection type generation failed: ${(error as Error).message}`)
+    process.exitCode = 1
+  }
+}

package/dist/templates/byline/server.config.ts

@@ -14,8 +14,7 @@
  * read it back with `getBylineCore<AdminStore>()`.
  *
  * This is the minimal scaffold: no example collections registered. Add
- * collection schemas to the `collections` array as you create them under
- * `byline/collections/<name>/schema.ts`.
+ * collection schemas to the shared tuple in `byline/collections/index.ts`.
  */
 
 import { type AdminStore, registerAdminAbilities } from '@byline/admin'
@@ -23,7 +22,6 @@ import { JwtSessionProvider } from '@byline/admin/auth'
 import { type BylineCore, initBylineCore } from '@byline/core'
 import { pgAdapter } from '@byline/db-postgres'
 import { createAdminStore } from '@byline/db-postgres/admin'
-import { getAdminBylineClient } from '@byline/host-tanstack-start/integrations/byline-client'
 import {
   lexicalEditorEmbedServer,
   lexicalEditorPopulateServer,
@@ -31,13 +29,13 @@ import {
 } from '@byline/richtext-lexical/server'
 import { localStorageProvider } from '@byline/storage-local'
 
+import { getAdminBylineClient } from './client.server.js'
+import { collections } from './collections/index.js'
 import { i18n } from './i18n.js'
 import { DEFAULT_SERVER_URL, routes } from './routes.js'
 
 const serverURL = process.env.VITE_SERVER_URL || DEFAULT_SERVER_URL
 
-const collections: Parameters<typeof pgAdapter>[0]['collections'] = []
-
 // HMR-safe singleton. Vite's program reload re-evaluates this module
 // without disposing the previous module's resources — every reload
 // would otherwise allocate a fresh pg `Pool` (max: 20) inside

package/dist/templates/byline-examples/admin.config.ts

@@ -8,10 +8,11 @@
 
 /**
  * Registers Byline's client-side config (collection admin UI configs,
- * field editors, i18n, routes) in the current module graph. Imported as
- * a side-effect from `src/routes/_byline/route.lazy.tsx` so registration
- * fires only when a `_byline/*` URL matches — keeping the Lexical
- * editor module graph out of public-route bundles entirely.
+ * field editors, i18n, routes) in the current module graph. The `_byline`
+ * route registers it from two complementary points: a dynamic import in
+ * `route.tsx` covers child loaders, while the side-effect import in
+ * `route.lazy.tsx` covers component render and initial hydration. Keeping
+ * both imports behind `_byline/*` keeps the admin graph off public routes.
  *
  * In TanStack Start with Vite 6 the server entry (`src/server.ts`) and
  * the SSR rendering context run in separate Vite environments, so
@@ -28,11 +29,12 @@ import { RichTextField as LexicalRichTextField } from '@byline/richtext-lexical'
 // commented `richText` block below for the exact shape.
 // import { lexicalEditor } from '@byline/richtext-lexical'
 
-import { Docs, DocsAdmin } from './collections/docs/index.js'
-import { Media, MediaAdmin } from './collections/media/index.js'
-import { News, NewsAdmin } from './collections/news/index.js'
-import { NewsCategories, NewsCategoriesAdmin } from './collections/news-categories/index.js'
-import { Pages, PagesAdmin } from './collections/pages/index.js'
+import { collections } from './collections/index.js'
+import { DocsAdmin } from './collections/docs/admin.js'
+import { MediaAdmin } from './collections/media/admin.js'
+import { NewsAdmin } from './collections/news/admin.js'
+import { NewsCategoriesAdmin } from './collections/news-categories/admin.js'
+import { PagesAdmin } from './collections/pages/admin.js'
 import { i18n } from './i18n.js'
 import { DEFAULT_SERVER_URL, routes } from './routes.js'
 
@@ -42,7 +44,7 @@ export const config: ClientConfig = {
   serverURL,
   i18n,
   routes,
-  collections: [Docs, News, Pages, Media, NewsCategories],
+  collections,
   admin: [DocsAdmin, NewsAdmin, PagesAdmin, MediaAdmin, NewsCategoriesAdmin],
   fields: {
     // Default registration — every `type: 'richText'` field gets the full

package/dist/templates/byline-examples/client.server.ts

@@ -0,0 +1,32 @@
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ */
+
+/**
+ * Server-only application boundary for the host-owned client singletons.
+ * The host stays config-agnostic; this assertion binds it to the app registry.
+ */
+import type { BylineClient } from '@byline/client'
+import {
+  getAdminBylineClient as getHostAdminBylineClient,
+  getSystemBylineClient as getHostSystemBylineClient,
+} from '@byline/host-tanstack-start/integrations/byline-client'
+import { getPublicBylineClient as getHostPublicBylineClient } from '@byline/host-tanstack-start/integrations/byline-public-client'
+import {
+  getViewerBylineClient as getHostViewerBylineClient,
+  isPreviewActive,
+} from '@byline/host-tanstack-start/integrations/byline-viewer-client'
+
+import type { BylineCollections } from './collections/index.js'
+
+type AppBylineClient = BylineClient<BylineCollections>
+
+export const getAdminBylineClient = getHostAdminBylineClient as () => AppBylineClient
+export const getPublicBylineClient = getHostPublicBylineClient as () => AppBylineClient
+export const getSystemBylineClient = getHostSystemBylineClient as () => AppBylineClient
+export const getViewerBylineClient = getHostViewerBylineClient as () => AppBylineClient
+export { isPreviewActive }

package/dist/templates/byline-examples/collection-types.contract.ts

@@ -0,0 +1,42 @@
+import type { CollectionFieldData, CollectionFieldDataAllLocales } from '@byline/core'
+
+import type { collections } from './collections/index.js'
+import type {
+  CollectionFieldsAllLocalesByPath,
+  CollectionFieldsByPath,
+} from './generated/collection-types.js'
+
+type InferredFieldsByPath = {
+  [Definition in (typeof collections)[number] as Definition['path']]: CollectionFieldData<Definition>
+}
+
+type InferredFieldsAllLocalesByPath = {
+  [Definition in (typeof collections)[number] as Definition['path']]: CollectionFieldDataAllLocales<Definition>
+}
+
+type IsAny<Value> = 0 extends 1 & Value ? true : false
+type Exact<Left, Right> = IsAny<Left> extends true
+  ? IsAny<Right>
+  : IsAny<Right> extends true
+    ? false
+    : (<Value>() => Value extends Left ? 1 : 2) extends <Value>() =>
+          Value extends Right ? 1 : 2
+      ? (<Value>() => Value extends Right ? 1 : 2) extends <Value>() =>
+          Value extends Left ? 1 : 2
+        ? true
+        : false
+      : false
+type Assert<Value extends true> = Value
+
+type GeneratedKeysMatchRuntimeRegistry = Assert<
+  Exact<keyof CollectionFieldsByPath, keyof InferredFieldsByPath>
+>
+type GeneratedFieldsMatchRuntimeRegistry = Assert<
+  Exact<CollectionFieldsByPath, InferredFieldsByPath>
+>
+type GeneratedAllLocalesKeysMatchRuntimeRegistry = Assert<
+  Exact<keyof CollectionFieldsAllLocalesByPath, keyof InferredFieldsAllLocalesByPath>
+>
+type GeneratedAllLocalesFieldsMatchRuntimeRegistry = Assert<
+  Exact<CollectionFieldsAllLocalesByPath, InferredFieldsAllLocalesByPath>
+>