@byline/core 3.0.0 → 3.0.1

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

@@ -729,7 +729,7 @@ export interface CollectionDefinition {
      * collection has at least one `localized` field, so the validator rejects
      * `advertiseLocales: true` on a collection with none.
      *
-     * See `docs/AVAILABLE-LOCALES.md`.
+     * See `docs/I18N.md`.
      */
     advertiseLocales?: boolean;
     /**
@@ -864,8 +864,8 @@ export type BlocksUnion<Bs extends readonly Block[]> = Bs[number] extends infer
  * on hand-authored fields without waiting for them to be placed inside a
  * `fields: [...]` array. Replaces the `as const satisfies Field` pattern.
  *
- * For factories that *generate* a field shape from input (e.g. mapped-type
- * driven fields like `availableLanguagesField`), a custom return type is
+ * For factories that *generate* a field shape from input (e.g. a helper whose
+ * return type is a mapped type over its options), a custom return type is
  * still the right tool — `defineField` is for identity / passthrough cases.
  *
  * The companion data-shape extractor `FieldData<F>` lives in

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

@@ -182,8 +182,8 @@ export function defineBlock(definition) {
  * on hand-authored fields without waiting for them to be placed inside a
  * `fields: [...]` array. Replaces the `as const satisfies Field` pattern.
  *
- * For factories that *generate* a field shape from input (e.g. mapped-type
- * driven fields like `availableLanguagesField`), a custom return type is
+ * For factories that *generate* a field shape from input (e.g. a helper whose
+ * return type is a mapped type over its options), a custom return type is
  * still the right tool — `defineField` is for identity / passthrough cases.
  *
  * The companion data-shape extractor `FieldData<F>` lives in

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

@@ -39,7 +39,7 @@ export type ReadMode = 'any' | 'published';
  * safe default for internal/direct reads); `@byline/client` defaults it to
  * `'fallback'` for application reads. Availability follows path-coverage against
  * the default content locale; a document with no localized content is available
- * in every locale. See `docs/CONTENT-LOCALE-RESOLUTION.md`.
+ * in every locale. See `docs/I18N.md`.
  */
 export type MissingLocalePolicy = 'empty' | 'fallback' | 'omit';
 /**
@@ -215,7 +215,7 @@ export interface IDbAdapter {
      * boot by `initBylineCore` so in-place upgrades self-heal without a manual
      * step or a migrate-ordering constraint — a no-op (zero rows) once every
      * document is stamped. Optional so adapters that don't model `source_locale`
-     * need not implement it. See docs/DEFAULT-LOCALE-SWITCHING.md.
+     * need not implement it. See docs/I18N.md.
      */
     backfillSourceLocales?: () => Promise<{
         rowsUpdated: number;
@@ -315,7 +315,7 @@ export interface IDocumentCommands {
          * editorial advertised-locale set. `undefined` leaves the existing set
          * untouched (sticky across versions, like `path`); `[]` clears it. The
          * locale values are the advertised content locales themselves, not the
-         * write locale. See `docs/AVAILABLE-LOCALES.md`.
+         * write locale. See `docs/I18N.md`.
          */
         availableLocales?: string[];
         locale?: string;

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

@@ -63,7 +63,7 @@ export interface BaseConfig {
              * its path locale, and the completeness ledger — so changing this value
              * is safe for existing data: they keep reading against the locale they
              * were authored in. New documents created after the change anchor to the
-             * new value. See docs/DEFAULT-LOCALE-SWITCHING.md.
+             * new value. See docs/I18N.md.
              *
              * (Switching this on a live system still needs the one-time
              * `backfillSourceLocales()` maintenance step to have stamped any rows

package/dist/core.js

@@ -96,7 +96,7 @@ export const initBylineCore = async (config, pinoLogger) => {
     // and is a no-op (zero rows) once every document is stamped. Self-heals
     // in-place upgrades without a manual maintenance step. The write path stamps
     // new documents directly, so steady-state boots touch nothing. See
-    // docs/DEFAULT-LOCALE-SWITCHING.md.
+    // docs/I18N.md.
     if (typeof composed.db.backfillSourceLocales === 'function') {
         const { rowsUpdated } = await composed.db.backfillSourceLocales();
         if (rowsUpdated > 0) {

package/dist/schemas/zod/builder.js

@@ -197,7 +197,7 @@ export const createBaseSchema = (collection) => {
         id: z.uuid(),
         versionId: z.uuid().optional(),
         path: z.string().optional(),
-        // The document's content source-locale anchor (see docs/DEFAULT-LOCALE-SWITCHING.md).
+        // The document's content source-locale anchor (see docs/I18N.md).
         // Carried through list/get responses so the admin can badge it; Zod would
         // otherwise strip it as an undeclared key.
         sourceLocale: z.string().optional(),

package/dist/services/document-lifecycle.d.ts

@@ -185,7 +185,7 @@ export declare function createDocument(ctx: DocumentLifecycleContext, params: {
      * sidebar widget). Document-grain and sticky like `path`: passed straight
      * to the storage primitive, which replaces the document's rows wholesale.
      * `undefined` writes nothing (a new document starts with an empty set —
-     * the safe opt-in default); `[]` clears it. See docs/AVAILABLE-LOCALES.md.
+     * the safe opt-in default); `[]` clears it. See docs/I18N.md.
      */
     availableLocales?: string[];
 }): Promise<CreateDocumentResult>;
@@ -217,7 +217,7 @@ export declare function updateDocument(ctx: DocumentLifecycleContext, params: {
      * The editorial advertised-locale set. `undefined` leaves the existing
      * set untouched (sticky — document-grain, like `path`); an explicit array
      * (empty included) replaces it wholesale. Driven by the admin
-     * available-locales sidebar widget. See docs/AVAILABLE-LOCALES.md.
+     * available-locales sidebar widget. See docs/I18N.md.
      */
     availableLocales?: string[];
 }): Promise<UpdateDocumentResult>;
@@ -252,7 +252,7 @@ export declare function updateDocumentWithPatches(ctx: DocumentLifecycleContext,
      * The editorial advertised-locale set (typically supplied alongside
      * patches when the admin available-locales widget has been edited).
      * `undefined` leaves the existing set untouched (sticky); an explicit
-     * array replaces it wholesale. See docs/AVAILABLE-LOCALES.md.
+     * array replaces it wholesale. See docs/I18N.md.
      */
     availableLocales?: string[];
 }): Promise<UpdateDocumentWithPatchesResult>;

package/dist/services/document-lifecycle.js

@@ -134,7 +134,7 @@ function resolvePathForUpdate(args) {
         // skip the write (existing path row stays as-is — sticky). The path row
         // lives under the document's source_locale (its anchor), not the mutable
         // global default — so this stays correct after the global default is
-        // switched. See docs/DEFAULT-LOCALE-SWITCHING.md.
+        // switched. See docs/I18N.md.
         return explicitPath ?? undefined;
     }
     // Non-source-locale (translation) write: reject any path change with a warn

package/package.json

@@ -2,7 +2,7 @@
   "name": "@byline/core",
   "private": false,
   "license": "MPL-2.0",
-  "version": "3.0.0",
+  "version": "3.0.1",
   "engines": {
     "node": ">=20.9.0"
   },
@@ -79,7 +79,7 @@
     "sharp": "^0.34.5",
     "uuid": "^14.0.0",
     "zod": "^4.4.3",
-    "@byline/auth": "3.0.0"
+    "@byline/auth": "3.0.1"
   },
   "devDependencies": {
     "@biomejs/biome": "2.4.15",