@byline/cli 2.6.1 → 3.0.0

package/dist/templates/migrations/{0000_black_sabra.sql → 0000_yielding_northstar.sql}

@@ -115,6 +115,15 @@ CREATE TABLE "byline_store_datetime" (
 	CONSTRAINT "unique_datetime_field" UNIQUE("document_version_id","field_path","locale")
 );
 --> statement-breakpoint
+CREATE TABLE "byline_document_available_locales" (
+	"document_id" uuid NOT NULL,
+	"locale" varchar(10) NOT NULL,
+	"collection_id" uuid NOT NULL,
+	"created_at" timestamp (6) with time zone DEFAULT now() NOT NULL,
+	"updated_at" timestamp (6) with time zone DEFAULT now() NOT NULL,
+	CONSTRAINT "byline_document_available_locales_document_id_locale_pk" PRIMARY KEY("document_id","locale")
+);
+--> statement-breakpoint
 CREATE TABLE "byline_document_paths" (
 	"document_id" uuid NOT NULL,
 	"locale" varchar(10) NOT NULL,
@@ -133,6 +142,12 @@ CREATE TABLE "byline_document_relationships" (
 	CONSTRAINT "byline_document_relationships_parent_document_id_child_document_id_unique" UNIQUE("parent_document_id","child_document_id")
 );
 --> statement-breakpoint
+CREATE TABLE "byline_document_version_locales" (
+	"document_version_id" uuid NOT NULL,
+	"locale" varchar(10) NOT NULL,
+	CONSTRAINT "byline_document_version_locales_document_version_id_locale_pk" PRIMARY KEY("document_version_id","locale")
+);
+--> statement-breakpoint
 CREATE TABLE "byline_document_versions" (
 	"id" uuid PRIMARY KEY NOT NULL,
 	"document_id" uuid NOT NULL,
@@ -152,6 +167,7 @@ CREATE TABLE "byline_documents" (
 	"id" uuid PRIMARY KEY NOT NULL,
 	"collection_id" uuid NOT NULL,
 	"order_key" varchar(128) COLLATE "C",
+	"source_locale" varchar(10) NOT NULL,
 	"created_at" timestamp (6) with time zone DEFAULT now() NOT NULL,
 	"updated_at" timestamp (6) with time zone DEFAULT now() NOT NULL
 );
@@ -270,10 +286,13 @@ ALTER TABLE "byline_store_boolean" ADD CONSTRAINT "byline_store_boolean_document
 ALTER TABLE "byline_store_boolean" ADD CONSTRAINT "byline_store_boolean_collection_id_byline_collections_id_fk" FOREIGN KEY ("collection_id") REFERENCES "public"."byline_collections"("id") ON DELETE cascade ON UPDATE no action;--> statement-breakpoint
 ALTER TABLE "byline_store_datetime" ADD CONSTRAINT "byline_store_datetime_document_version_id_byline_document_versions_id_fk" FOREIGN KEY ("document_version_id") REFERENCES "public"."byline_document_versions"("id") ON DELETE cascade ON UPDATE no action;--> statement-breakpoint
 ALTER TABLE "byline_store_datetime" ADD CONSTRAINT "byline_store_datetime_collection_id_byline_collections_id_fk" FOREIGN KEY ("collection_id") REFERENCES "public"."byline_collections"("id") ON DELETE cascade ON UPDATE no action;--> statement-breakpoint
+ALTER TABLE "byline_document_available_locales" ADD CONSTRAINT "byline_document_available_locales_document_id_byline_documents_id_fk" FOREIGN KEY ("document_id") REFERENCES "public"."byline_documents"("id") ON DELETE cascade ON UPDATE no action;--> statement-breakpoint
+ALTER TABLE "byline_document_available_locales" ADD CONSTRAINT "byline_document_available_locales_collection_id_byline_collections_id_fk" FOREIGN KEY ("collection_id") REFERENCES "public"."byline_collections"("id") ON DELETE cascade ON UPDATE no action;--> statement-breakpoint
 ALTER TABLE "byline_document_paths" ADD CONSTRAINT "byline_document_paths_document_id_byline_documents_id_fk" FOREIGN KEY ("document_id") REFERENCES "public"."byline_documents"("id") ON DELETE cascade ON UPDATE no action;--> statement-breakpoint
 ALTER TABLE "byline_document_paths" ADD CONSTRAINT "byline_document_paths_collection_id_byline_collections_id_fk" FOREIGN KEY ("collection_id") REFERENCES "public"."byline_collections"("id") ON DELETE cascade ON UPDATE no action;--> statement-breakpoint
 ALTER TABLE "byline_document_relationships" ADD CONSTRAINT "byline_document_relationships_parent_document_id_byline_documents_id_fk" FOREIGN KEY ("parent_document_id") REFERENCES "public"."byline_documents"("id") ON DELETE cascade ON UPDATE no action;--> statement-breakpoint
 ALTER TABLE "byline_document_relationships" ADD CONSTRAINT "byline_document_relationships_child_document_id_byline_documents_id_fk" FOREIGN KEY ("child_document_id") REFERENCES "public"."byline_documents"("id") ON DELETE cascade ON UPDATE no action;--> statement-breakpoint
+ALTER TABLE "byline_document_version_locales" ADD CONSTRAINT "byline_document_version_locales_document_version_id_byline_document_versions_id_fk" FOREIGN KEY ("document_version_id") REFERENCES "public"."byline_document_versions"("id") ON DELETE cascade ON UPDATE no action;--> statement-breakpoint
 ALTER TABLE "byline_document_versions" ADD CONSTRAINT "byline_document_versions_document_id_byline_documents_id_fk" FOREIGN KEY ("document_id") REFERENCES "public"."byline_documents"("id") ON DELETE cascade ON UPDATE no action;--> statement-breakpoint
 ALTER TABLE "byline_document_versions" ADD CONSTRAINT "byline_document_versions_collection_id_byline_collections_id_fk" FOREIGN KEY ("collection_id") REFERENCES "public"."byline_collections"("id") ON DELETE cascade ON UPDATE no action;--> statement-breakpoint
 ALTER TABLE "byline_documents" ADD CONSTRAINT "byline_documents_collection_id_byline_collections_id_fk" FOREIGN KEY ("collection_id") REFERENCES "public"."byline_collections"("id") ON DELETE cascade ON UPDATE no action;--> statement-breakpoint
@@ -304,6 +323,7 @@ CREATE INDEX "idx_datetime_date" ON "byline_store_datetime" USING btree ("value_
 CREATE INDEX "idx_datetime_timestamp_tz" ON "byline_store_datetime" USING btree ("value_timestamp_tz");--> statement-breakpoint
 CREATE INDEX "idx_datetime_path_date" ON "byline_store_datetime" USING btree ("field_path","value_timestamp_tz");--> statement-breakpoint
 CREATE INDEX "idx_datetime_collection_date" ON "byline_store_datetime" USING btree ("collection_id","value_timestamp_tz");--> statement-breakpoint
+CREATE INDEX "idx_document_available_locales_document_id" ON "byline_document_available_locales" USING btree ("document_id");--> statement-breakpoint
 CREATE INDEX "idx_document_paths_document_id" ON "byline_document_paths" USING btree ("document_id");--> statement-breakpoint
 CREATE INDEX "idx_document_relationships_parent" ON "byline_document_relationships" USING btree ("parent_document_id");--> statement-breakpoint
 CREATE INDEX "idx_document_relationships_child" ON "byline_document_relationships" USING btree ("child_document_id");--> statement-breakpoint
@@ -342,5 +362,5 @@ CREATE INDEX "idx_text_value" ON "byline_store_text" USING btree ("value");--> s
 CREATE INDEX "idx_text_fulltext" ON "byline_store_text" USING gin (to_tsvector('english', "value"));--> statement-breakpoint
 CREATE INDEX "idx_text_locale_value" ON "byline_store_text" USING btree ("locale","value");--> statement-breakpoint
 CREATE INDEX "idx_text_path_value" ON "byline_store_text" USING btree ("field_path","value");--> statement-breakpoint
-CREATE VIEW "public"."byline_current_documents" AS (with "sq" as (select "id", "document_id", "collection_id", "collection_version", "event_type", "status", "is_deleted", "created_at", "updated_at", "created_by", "change_summary", row_number() OVER (PARTITION BY "document_id" ORDER BY "id" DESC) as "rn" from "byline_document_versions" where "byline_document_versions"."is_deleted" = false) select "sq"."id", "sq"."document_id", "sq"."collection_id", "sq"."collection_version", "sq"."event_type", "sq"."status", "sq"."is_deleted", "sq"."created_at", "sq"."updated_at", "sq"."created_by", "sq"."change_summary", "byline_documents"."order_key" from "sq" inner join "byline_documents" on "byline_documents"."id" = "sq"."document_id" where "rn" = 1);--> statement-breakpoint
-CREATE VIEW "public"."byline_current_published_documents" AS (with "sq" as (select "id", "document_id", "collection_id", "collection_version", "event_type", "status", "is_deleted", "created_at", "updated_at", "created_by", "change_summary", row_number() OVER (PARTITION BY "document_id" ORDER BY "id" DESC) as "rn" from "byline_document_versions" where "byline_document_versions"."is_deleted" = false AND "byline_document_versions"."status" = 'published') select "sq"."id", "sq"."document_id", "sq"."collection_id", "sq"."collection_version", "sq"."event_type", "sq"."status", "sq"."is_deleted", "sq"."created_at", "sq"."updated_at", "sq"."created_by", "sq"."change_summary", "byline_documents"."order_key" from "sq" inner join "byline_documents" on "byline_documents"."id" = "sq"."document_id" where "rn" = 1);
+CREATE VIEW "public"."byline_current_documents" AS (with "sq" as (select "id", "document_id", "collection_id", "collection_version", "event_type", "status", "is_deleted", "created_at", "updated_at", "created_by", "change_summary", row_number() OVER (PARTITION BY "document_id" ORDER BY "id" DESC) as "rn" from "byline_document_versions" where "byline_document_versions"."is_deleted" = false) select "sq"."id", "sq"."document_id", "sq"."collection_id", "sq"."collection_version", "sq"."event_type", "sq"."status", "sq"."is_deleted", "sq"."created_at", "sq"."updated_at", "sq"."created_by", "sq"."change_summary", "byline_documents"."order_key", "byline_documents"."source_locale" from "sq" inner join "byline_documents" on "byline_documents"."id" = "sq"."document_id" where "rn" = 1);--> statement-breakpoint
+CREATE VIEW "public"."byline_current_published_documents" AS (with "sq" as (select "id", "document_id", "collection_id", "collection_version", "event_type", "status", "is_deleted", "created_at", "updated_at", "created_by", "change_summary", row_number() OVER (PARTITION BY "document_id" ORDER BY "id" DESC) as "rn" from "byline_document_versions" where "byline_document_versions"."is_deleted" = false AND "byline_document_versions"."status" = 'published') select "sq"."id", "sq"."document_id", "sq"."collection_id", "sq"."collection_version", "sq"."event_type", "sq"."status", "sq"."is_deleted", "sq"."created_at", "sq"."updated_at", "sq"."created_by", "sq"."change_summary", "byline_documents"."order_key", "byline_documents"."source_locale" from "sq" inner join "byline_documents" on "byline_documents"."id" = "sq"."document_id" where "rn" = 1);

package/dist/templates/migrations/meta/0000_snapshot.json

@@ -1,5 +1,5 @@
 {
-  "id": "2d20cd37-0ecf-467c-86dd-9f880e9d41b4",
+  "id": "52560051-1da6-41f4-8a2c-b9a7b5421d26",
   "prevId": "00000000-0000-0000-0000-000000000000",
   "version": "7",
   "dialect": "postgresql",
@@ -1053,6 +1053,102 @@
       "checkConstraints": {},
       "isRLSEnabled": false
     },
+    "public.byline_document_available_locales": {
+      "name": "byline_document_available_locales",
+      "schema": "",
+      "columns": {
+        "document_id": {
+          "name": "document_id",
+          "type": "uuid",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "locale": {
+          "name": "locale",
+          "type": "varchar(10)",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "collection_id": {
+          "name": "collection_id",
+          "type": "uuid",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp (6) with time zone",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp (6) with time zone",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        }
+      },
+      "indexes": {
+        "idx_document_available_locales_document_id": {
+          "name": "idx_document_available_locales_document_id",
+          "columns": [
+            {
+              "expression": "document_id",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        }
+      },
+      "foreignKeys": {
+        "byline_document_available_locales_document_id_byline_documents_id_fk": {
+          "name": "byline_document_available_locales_document_id_byline_documents_id_fk",
+          "tableFrom": "byline_document_available_locales",
+          "tableTo": "byline_documents",
+          "columnsFrom": [
+            "document_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "byline_document_available_locales_collection_id_byline_collections_id_fk": {
+          "name": "byline_document_available_locales_collection_id_byline_collections_id_fk",
+          "tableFrom": "byline_document_available_locales",
+          "tableTo": "byline_collections",
+          "columnsFrom": [
+            "collection_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "byline_document_available_locales_document_id_locale_pk": {
+          "name": "byline_document_available_locales_document_id_locale_pk",
+          "columns": [
+            "document_id",
+            "locale"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "policies": {},
+      "checkConstraints": {},
+      "isRLSEnabled": false
+    },
     "public.byline_document_paths": {
       "name": "byline_document_paths",
       "schema": "",
@@ -1264,6 +1360,53 @@
       "checkConstraints": {},
       "isRLSEnabled": false
     },
+    "public.byline_document_version_locales": {
+      "name": "byline_document_version_locales",
+      "schema": "",
+      "columns": {
+        "document_version_id": {
+          "name": "document_version_id",
+          "type": "uuid",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "locale": {
+          "name": "locale",
+          "type": "varchar(10)",
+          "primaryKey": false,
+          "notNull": true
+        }
+      },
+      "indexes": {},
+      "foreignKeys": {
+        "byline_document_version_locales_document_version_id_byline_document_versions_id_fk": {
+          "name": "byline_document_version_locales_document_version_id_byline_document_versions_id_fk",
+          "tableFrom": "byline_document_version_locales",
+          "tableTo": "byline_document_versions",
+          "columnsFrom": [
+            "document_version_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "byline_document_version_locales_document_version_id_locale_pk": {
+          "name": "byline_document_version_locales_document_version_id_locale_pk",
+          "columns": [
+            "document_version_id",
+            "locale"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "policies": {},
+      "checkConstraints": {},
+      "isRLSEnabled": false
+    },
     "public.byline_document_versions": {
       "name": "byline_document_versions",
       "schema": "",
@@ -1530,6 +1673,12 @@
           "primaryKey": false,
           "notNull": false
         },
+        "source_locale": {
+          "name": "source_locale",
+          "type": "varchar(10)",
+          "primaryKey": false,
+          "notNull": true
+        },
         "created_at": {
           "name": "created_at",
           "type": "timestamp (6) with time zone",
@@ -2999,9 +3148,15 @@
           "type": "varchar(128) COLLATE \"C\"",
           "primaryKey": false,
           "notNull": false
+        },
+        "source_locale": {
+          "name": "source_locale",
+          "type": "varchar(10)",
+          "primaryKey": false,
+          "notNull": true
         }
       },
-      "definition": "with \"sq\" as (select \"id\", \"document_id\", \"collection_id\", \"collection_version\", \"event_type\", \"status\", \"is_deleted\", \"created_at\", \"updated_at\", \"created_by\", \"change_summary\", row_number() OVER (PARTITION BY \"document_id\" ORDER BY \"id\" DESC) as \"rn\" from \"byline_document_versions\" where \"byline_document_versions\".\"is_deleted\" = false) select \"sq\".\"id\", \"sq\".\"document_id\", \"sq\".\"collection_id\", \"sq\".\"collection_version\", \"sq\".\"event_type\", \"sq\".\"status\", \"sq\".\"is_deleted\", \"sq\".\"created_at\", \"sq\".\"updated_at\", \"sq\".\"created_by\", \"sq\".\"change_summary\", \"byline_documents\".\"order_key\" from \"sq\" inner join \"byline_documents\" on \"byline_documents\".\"id\" = \"sq\".\"document_id\" where \"rn\" = 1",
+      "definition": "with \"sq\" as (select \"id\", \"document_id\", \"collection_id\", \"collection_version\", \"event_type\", \"status\", \"is_deleted\", \"created_at\", \"updated_at\", \"created_by\", \"change_summary\", row_number() OVER (PARTITION BY \"document_id\" ORDER BY \"id\" DESC) as \"rn\" from \"byline_document_versions\" where \"byline_document_versions\".\"is_deleted\" = false) select \"sq\".\"id\", \"sq\".\"document_id\", \"sq\".\"collection_id\", \"sq\".\"collection_version\", \"sq\".\"event_type\", \"sq\".\"status\", \"sq\".\"is_deleted\", \"sq\".\"created_at\", \"sq\".\"updated_at\", \"sq\".\"created_by\", \"sq\".\"change_summary\", \"byline_documents\".\"order_key\", \"byline_documents\".\"source_locale\" from \"sq\" inner join \"byline_documents\" on \"byline_documents\".\"id\" = \"sq\".\"document_id\" where \"rn\" = 1",
       "name": "byline_current_documents",
       "schema": "public",
       "isExisting": false,
@@ -3085,9 +3240,15 @@
           "type": "varchar(128) COLLATE \"C\"",
           "primaryKey": false,
           "notNull": false
+        },
+        "source_locale": {
+          "name": "source_locale",
+          "type": "varchar(10)",
+          "primaryKey": false,
+          "notNull": true
         }
       },
-      "definition": "with \"sq\" as (select \"id\", \"document_id\", \"collection_id\", \"collection_version\", \"event_type\", \"status\", \"is_deleted\", \"created_at\", \"updated_at\", \"created_by\", \"change_summary\", row_number() OVER (PARTITION BY \"document_id\" ORDER BY \"id\" DESC) as \"rn\" from \"byline_document_versions\" where \"byline_document_versions\".\"is_deleted\" = false AND \"byline_document_versions\".\"status\" = 'published') select \"sq\".\"id\", \"sq\".\"document_id\", \"sq\".\"collection_id\", \"sq\".\"collection_version\", \"sq\".\"event_type\", \"sq\".\"status\", \"sq\".\"is_deleted\", \"sq\".\"created_at\", \"sq\".\"updated_at\", \"sq\".\"created_by\", \"sq\".\"change_summary\", \"byline_documents\".\"order_key\" from \"sq\" inner join \"byline_documents\" on \"byline_documents\".\"id\" = \"sq\".\"document_id\" where \"rn\" = 1",
+      "definition": "with \"sq\" as (select \"id\", \"document_id\", \"collection_id\", \"collection_version\", \"event_type\", \"status\", \"is_deleted\", \"created_at\", \"updated_at\", \"created_by\", \"change_summary\", row_number() OVER (PARTITION BY \"document_id\" ORDER BY \"id\" DESC) as \"rn\" from \"byline_document_versions\" where \"byline_document_versions\".\"is_deleted\" = false AND \"byline_document_versions\".\"status\" = 'published') select \"sq\".\"id\", \"sq\".\"document_id\", \"sq\".\"collection_id\", \"sq\".\"collection_version\", \"sq\".\"event_type\", \"sq\".\"status\", \"sq\".\"is_deleted\", \"sq\".\"created_at\", \"sq\".\"updated_at\", \"sq\".\"created_by\", \"sq\".\"change_summary\", \"byline_documents\".\"order_key\", \"byline_documents\".\"source_locale\" from \"sq\" inner join \"byline_documents\" on \"byline_documents\".\"id\" = \"sq\".\"document_id\" where \"rn\" = 1",
       "name": "byline_current_published_documents",
       "schema": "public",
       "isExisting": false,

package/dist/templates/migrations/meta/_journal.json

@@ -5,8 +5,8 @@
     {
       "idx": 0,
       "version": "7",
-      "when": 1779971470037,
-      "tag": "0000_black_sabra",
+      "when": 1780302968051,
+      "tag": "0000_yielding_northstar",
       "breakpoints": true
     }
   ]

package/dist/templates/routes/_byline/route.lazy.tsx

@@ -9,9 +9,19 @@
 /**
  * Lazy companion to `_byline/route.tsx`. TanStack Router loads this on
  * demand when a `_byline/*` URL matches, so the Byline UI providers,
- * stylesheets, and the admin config side-effect import (which
- * transitively pulls in the Lexical editor module graph) only run when
- * an admin route is actually visited — public routes stay clean.
+ * stylesheets, and the admin config side-effect import (which transitively
+ * pulls in the Lexical editor module graph) only run when an admin route is
+ * actually visited — public routes stay clean.
+ *
+ * The `byline/admin.config` import below registers the client config in the
+ * *client component graph* — it runs whenever this lazy module loads (component
+ * render / initial hydration), where the sibling `route.tsx` `beforeLoad` does
+ * NOT help: on initial hydration TanStack Start reuses the dehydrated SSR result
+ * and does not re-run `beforeLoad`, yet the admin layout component still calls
+ * `getClientConfig()` at render. The two registration points are complementary —
+ * `beforeLoad` (a dynamic import) covers the *loader* phase before any
+ * `_byline/*` child loader; this import covers component render / hydration.
+ * Both call `defineClientConfig` idempotently.
  *
  * If you also want to use the Byline UI components on your public site,
  * import the same stylesheets from your front-end's pathless layout
@@ -26,9 +36,9 @@ import { ToastProvider, ToastViewport } from '@byline/ui/react'
 import '@byline/ui/reset.css'
 import '@byline/ui/styles.css'
 
-// Initialize Byline admin config — sits in the lazy companion so the
-// Lexical editor module graph only loads when a _byline/* URL matches.
-// See byline/admin.config.ts for the comment on why this is side-effecty.
+// Register the Byline client config (component-render / hydration entry point —
+// see the file header). The sibling `route.tsx` `beforeLoad` covers the loader
+// phase. Lexical's module graph only loads when a `_byline/*` URL matches.
 import '../../../byline/admin.config'
 
 export const Route = createLazyFileRoute('/_byline')({

package/dist/templates/routes/_byline/route.tsx

@@ -12,17 +12,42 @@
  * to URL paths — `/_byline/admin/...` resolves to `/admin/...` and
  * `/_byline/sign-in` resolves to `/sign-in`.
  *
- * This file is intentionally bare. The router needs the route definition
- * at startup to build the tree for URL matching, so anything declared
- * here ends up in the eager module graph (and Vite will modulepreload
- * its dependencies on every page).
+ * This file is intentionally light. The router needs the route definition
+ * at startup to build the tree for URL matching, so anything *statically*
+ * imported here ends up in the eager module graph (and Vite will
+ * modulepreload its dependencies on every page).
  *
- * The component, providers, Byline UI stylesheets, and the admin config
- * side-effect import live in the sibling `route.lazy.tsx` — TanStack
- * Router loads that file on demand when a `_byline/*` URL matches, so
- * the editor + admin shell deps stay out of public-route bundles.
+ * The component, providers, and Byline UI stylesheets live in the sibling
+ * `route.lazy.tsx` — TanStack Router loads that file on demand when a
+ * `_byline/*` URL matches, so the editor + admin shell deps stay out of
+ * public-route bundles.
+ *
+ * Registering the Byline client config has two complementary entry points
+ * (both call `defineClientConfig` idempotently):
+ *  - the `beforeLoad` below — covers the *loader* phase, resolving before any
+ *    `_byline/*` child loader reads the config (e.g. the admin dashboard
+ *    loader's `getClientConfig()`);
+ *  - the side-effect import in `route.lazy.tsx` — covers component render /
+ *    initial hydration, where `beforeLoad` is not re-run.
+ * Both use `byline/admin.config` (a dynamic import here), so its module graph
+ * (incl. the Lexical editor) stays code-split out of the eager/public bundle.
  */
 
 import { createFileRoute } from '@tanstack/react-router'
 
-export const Route = createFileRoute('/_byline')({})
+export const Route = createFileRoute('/_byline')({
+  beforeLoad: async () => {
+    // Register the Byline client config (`defineClientConfig` runs as a
+    // side-effect of importing `byline/admin.config`) before any `_byline/*`
+    // child loader reads it. A parent route's `beforeLoad` resolves before its
+    // children's loaders, closing the dev race where a loader outran the lazy
+    // component module's side-effect import (on the client there is no
+    // server-config fallback, so `getClientConfig()` threw "Byline has not been
+    // configured yet"). The dynamic import keeps `admin.config` out of the
+    // eager/public bundle and evaluates once (cached). NOTE: `beforeLoad` is
+    // not re-run on initial client hydration (the SSR result is dehydrated), so
+    // the `route.lazy.tsx` side-effect import registers the config for the
+    // hydrated component render.
+    await import('../../../byline/admin.config')
+  },
+})

package/package.json

@@ -2,7 +2,7 @@
   "name": "@byline/cli",
   "private": false,
   "license": "MPL-2.0",
-  "version": "2.6.1",
+  "version": "3.0.0",
   "engines": {
     "node": ">=20.9.0"
   },