@byline/cli 3.0.0 → 3.0.2

package/dist/templates/byline-examples/scripts/backfill-version-locales.ts

@@ -18,7 +18,7 @@
  *
  *   cd apps/webapp && pnpm tsx byline/scripts/backfill-version-locales.ts
  *
- * See docs/CONTENT-LOCALE-RESOLUTION.md.
+ * See docs/I18N.md.
  */
 
 import '../load-env.js'

package/dist/templates/byline-examples/scripts/import-docs.ts

@@ -287,7 +287,7 @@ async function processFile(
       // Advertise the imported locale (editorial available-locales set), merged
       // with whatever is already advertised so a later-locale re-import doesn't
       // clobber an earlier one. The public set is still gated by the version
-      // completeness ledger (intersection). See docs/AVAILABLE-LOCALES.md.
+      // completeness ledger (intersection). See docs/I18N.md.
       availableLocales: [...new Set([...(existing.availableLocales ?? []), locale])],
     })
     await walkToStatus(handle, result.documentId, workflowStatuses, defaultStatus, desiredStatus)

package/dist/templates/byline-examples/scripts/re-anchor.ts

@@ -20,7 +20,7 @@
  *   cd apps/webapp && pnpm tsx byline/scripts/re-anchor.ts --to fr --collection pages
  *   cd apps/webapp && pnpm tsx byline/scripts/re-anchor.ts --to fr --dry-run
  *
- * See docs/DEFAULT-LOCALE-SWITCHING.md.
+ * See docs/I18N.md.
  */
 
 import '../load-env.js'

package/package.json

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

package/dist/templates/byline-examples/fields/available-languages-field.ts

@@ -1,106 +0,0 @@
-/**
- * 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
- */
-
-/**
- * **Schema-side helper.** Returns a `GroupField` schema that emits one
- * `checkbox` field per configured content locale. Drop the result into
- * a collection's `fields` array in `<collection>/schema.ts`. Pure data;
- * the only imports are `@byline/core` types and the i18n locale list.
- *
- * See `docs/FIELDS.md` for the schema-vs-admin model.
- *
- * @deprecated **No longer needed** as of the content-locale-resolution work.
- * The editorial "advertise these locales" control is now a core *system
- * attribute* + ledger-aware sidebar widget (`availableLocales`) — see
- * `docs/AVAILABLE-LOCALES.md`. This userland custom field is **left in place as
- * a reference example** of the schema-side field-builder pattern; it is not used
- * by the system widget and can be removed from collection schemas.
- */
-
-import type { GroupField } from '@byline/core'
-
-import { contentLocales, type LocaleDefinition } from '../i18n.js'
-
-type Options = Partial<Omit<GroupField, 'type' | 'fields'>> & {
-  locales?: readonly LocaleDefinition[]
-}
-
-type LocaleFields<T extends readonly LocaleDefinition[]> = {
-  [K in keyof T]: {
-    name: T[K]['code']
-    label: T[K]['label']
-    type: 'checkbox'
-    optional: true
-  }
-}
-
-type WithOverride<O, K extends string, V, D> = O extends { [P in K]: V } ? O[K] : D
-
-type AvailableLanguagesField<Opts extends Options> = Omit<GroupField, 'name' | 'fields'> & {
-  name: WithOverride<Opts, 'name', string, 'availableLanguages'>
-  fields: LocaleFields<
-    WithOverride<Opts, 'locales', readonly LocaleDefinition[], typeof contentLocales>
-  >
-}
-
-const builtInValidate = (value: Record<string, boolean> | undefined): string | undefined => {
-  const hasSelection =
-    value != null &&
-    typeof value === 'object' &&
-    !Array.isArray(value) &&
-    Object.values(value).some(Boolean)
-  if (!hasSelection) {
-    return 'At least one language must be selected'
-  }
-  return undefined
-}
-
-/**
- * Returns a `GroupField` that renders one checkbox per locale entry.
- * Validation requires at least one language to be selected; if the caller
- * supplies its own `validate`, the built-in rule runs first and the caller's
- * validator only runs when the built-in passes.
- *
- * @description This field is intended for use in a document's "Edit" view
- * to allow editors to specify which languages a document is available in.
- * It is orthogonal to the defined workflow system and is here as a 'signal'
- * to frontend websites / consumers - allowing them to implement their own
- * logic around content availability per language.
- *
- * @param options - Optional overrides. Accepts any `GroupField` property
- *   except `type` and `fields` (which are computed), plus a `locales` array
- *   that drives the generated checkbox set.
- */
-export function availableLanguagesField<const Opts extends Options>(
-  options: Opts = {} as Opts
-): AvailableLanguagesField<Opts> {
-  const { name, label, helpText, locales, validate: userValidate, ...rest } = options
-
-  const validate = userValidate
-    ? (value: any, data: Record<string, any>) => {
-        const builtInError = builtInValidate(value)
-        if (builtInError) return builtInError
-        return userValidate(value, data)
-      }
-    : builtInValidate
-
-  return {
-    ...rest,
-    name: (name ?? 'availableLanguages') as any,
-    label: label ?? 'Published Languages',
-    helpText: helpText ?? 'Select the languages this document is available in.',
-    type: 'group',
-    fields: (locales ?? contentLocales).map(({ code, label }) => ({
-      name: code,
-      label,
-      type: 'checkbox' as const,
-      optional: true,
-    })) as any,
-    validate,
-  }
-}