@byline/cli 2.1.3 → 2.2.0

package/dist/manifest/deps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deps.d.ts","sourceRoot":"","sources":["../../src/manifest/deps.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,KAAK,CAAA;AAEnD,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,QAAQ,CAAA;IACf,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAA;CACb;AAED,eAAO,MAAM,cAAc,WAAW,CAAA;AAEtC,eAAO,MAAM,SAAS,EAAE,SAAS,OAAO,EAkH9B,CAAA"}
+{"version":3,"file":"deps.d.ts","sourceRoot":"","sources":["../../src/manifest/deps.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,KAAK,CAAA;AAEnD,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,QAAQ,CAAA;IACf,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAA;CACb;AAED,eAAO,MAAM,cAAc,WAAW,CAAA;AAEtC,eAAO,MAAM,SAAS,EAAE,SAAS,OAAO,EAqJ9B,CAAA"}

package/dist/manifest/deps.js

@@ -127,5 +127,39 @@ export const DEP_SPECS = [
         group: 'dev',
         note: 'runs byline/seed.ts and byline/scripts/* without a build step',
     },
+    // ---- Dev: required by byline/scripts/import-docs.ts --------------------
+    // Markdown ingestion stack used only by the optional import-docs example
+    // script. Kept in `dev` because the production app never imports them —
+    // they only matter when the developer runs `tsx byline/scripts/import-docs.ts`.
+    {
+        name: 'gray-matter',
+        version: '^4.0.3',
+        group: 'dev',
+        note: 'frontmatter parser used by byline/scripts/import-docs.ts',
+    },
+    {
+        name: 'unified',
+        version: '^11.0.5',
+        group: 'dev',
+        note: 'remark/mdast pipeline runner used by byline/scripts/import-docs.ts',
+    },
+    {
+        name: 'remark-parse',
+        version: '^11.0.0',
+        group: 'dev',
+        note: 'markdown → mdast parser used by byline/scripts/import-docs.ts',
+    },
+    {
+        name: 'remark-gfm',
+        version: '^4.0.1',
+        group: 'dev',
+        note: 'GitHub-Flavoured Markdown extensions for remark; used by byline/scripts/import-docs.ts',
+    },
+    {
+        name: '@types/mdast',
+        version: '^4.0.4',
+        group: 'dev',
+        note: 'TypeScript types for mdast nodes; consumed as type-only by byline/scripts/lib/mdast-to-lexical.ts',
+    },
 ];
 //# sourceMappingURL=deps.js.map

package/dist/manifest/deps.js.map

@@ -1 +1 @@
-{"version":3,"file":"deps.js","sourceRoot":"","sources":["../../src/manifest/deps.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAYH,MAAM,CAAC,MAAM,cAAc,GAAG,QAAQ,CAAA;AAEtC,MAAM,CAAC,MAAM,SAAS,GAAuB;IAC3C,4EAA4E;IAC5E;QACE,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,cAAc;QACvB,KAAK,EAAE,QAAQ;QACf,IAAI,EAAE,6DAA6D;KACpE;IACD;QACE,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,cAAc;QACvB,KAAK,EAAE,QAAQ;QACf,IAAI,EAAE,+EAA+E;KACtF;IACD;QACE,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,cAAc;QACvB,KAAK,EAAE,QAAQ;QACf,IAAI,EAAE,mDAAmD;KAC1D;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,cAAc;QACvB,KAAK,EAAE,QAAQ;QACf,IAAI,EAAE,6DAA6D;KACpE;IACD;QACE,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,cAAc;QACvB,KAAK,EAAE,QAAQ;QACf,IAAI,EAAE,sDAAsD;KAC7D;IACD;QACE,IAAI,EAAE,qBAAqB;QAC3B,OAAO,EAAE,cAAc;QACvB,KAAK,EAAE,QAAQ;QACf,IAAI,EAAE,gCAAgC;KACvC;IACD;QACE,IAAI,EAAE,6BAA6B;QACnC,OAAO,EAAE,cAAc;QACvB,KAAK,EAAE,QAAQ;QACf,IAAI,EAAE,2CAA2C;KAClD;IACD;QACE,IAAI,EAAE,0BAA0B;QAChC,OAAO,EAAE,cAAc;QACvB,KAAK,EAAE,QAAQ;QACf,IAAI,EAAE,iDAAiD;KACxD;IACD;QACE,IAAI,EAAE,uBAAuB;QAC7B,OAAO,EAAE,cAAc;QACvB,KAAK,EAAE,QAAQ;QACf,IAAI,EAAE,6CAA6C;KACpD;IACD;QACE,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,cAAc;QACvB,KAAK,EAAE,QAAQ;QACf,IAAI,EAAE,gDAAgD;KACvD;IAED,4EAA4E;IAC5E;QACE,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,QAAQ;QACjB,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,+EAA+E;KACtF;IACD;QACE,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,SAAS;QAClB,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,qBAAqB;KAC5B;IACD;QACE,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,SAAS;QAClB,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,2FAA2F;KAClG;IACD;QACE,IAAI,EAAE,sBAAsB;QAC5B,OAAO,EAAE,QAAQ;QACjB,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,oFAAoF;KAC3F;IACD;QACE,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,SAAS;QAClB,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,mIAAmI;KAC1I;IACD;QACE,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,0BAA0B;QACnC,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,2LAA2L;KAClM;IAED,2EAA2E;IAC3E;QACE,IAAI,EAAE,yBAAyB;QAC/B,OAAO,EAAE,QAAQ;QACjB,KAAK,EAAE,KAAK;QACZ,IAAI,EAAE,kEAAkE;KACzE;IACD;QACE,IAAI,EAAE,KAAK;QACX,OAAO,EAAE,SAAS;QAClB,KAAK,EAAE,KAAK;QACZ,IAAI,EAAE,+DAA+D;KACtE;CACO,CAAA"}
+{"version":3,"file":"deps.js","sourceRoot":"","sources":["../../src/manifest/deps.ts"],"names":[],"mappings":"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"}

package/dist/templates/byline/i18n.ts

@@ -23,7 +23,7 @@ export interface LocaleDefinition {
 /** Locales available in the CMS admin interface. */
 export const interfaceLocales: LocaleDefinition[] = [
   { code: 'en', label: 'English' },
-  { code: 'fr', label: 'Français' },
+  { code: 'es', label: 'Español' },
 ]
 
 /** Locales a document can be published in. */

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

@@ -76,6 +76,18 @@ export const config: ClientConfig = {
     //   }),
     // },
     // ---------------------------------------------------------------------
+    //
+    // Or — enable the AI assistant on every richtext field globally by
+    // registering the `LexicalRichTextAi` editor. It is built with
+    // `lexicalEditor((c) => c.extensions.add(AiLexicalExtension))`, so
+    // the AI drawer mounts as a Lexical extension decorator and the
+    // toolbar button arrives via the BylineToolbarExtension peer
+    // contract. Server-side auth is provided by `executeAiInstruction`
+    // via `<BylineAiAdminProvider>` in the admin layout.
+    //
+    // import { LexicalRichTextAi } from './fields/lexical-richtext-ai.js'
+    // richText: { editor: LexicalRichTextAi },
+    // ---------------------------------------------------------------------
   },
 }
 

package/dist/templates/byline-examples/collections/media/components/media-list-view.module.css

@@ -11,7 +11,7 @@
 }
 
 .heading {
-  margin: 0 !important;
+  margin: 0;
   padding-bottom: 0.125rem;
 }
 

package/dist/templates/byline-examples/collections/news/admin.tsx

@@ -11,6 +11,9 @@ import { DateTimeFormatter } from '@byline/ui/react'
 
 import { SummaryLength } from '~/components/summary-length.js'
 
+import { aiTextFieldAdmin } from '../../fields/ai-text.js'
+import { aiTextAreaFieldAdmin } from '../../fields/ai-textarea.js'
+import { aiRichTextAdmin } from '../../fields/lexical-richtext-ai.js'
 import { FeaturedFormatter } from './components/feature-formatter.js'
 import { News } from './schema.js'
 
@@ -111,11 +114,13 @@ export const NewsAdmin: CollectionAdminConfig = defineAdmin(News, {
    * Placement is controlled exclusively through the layout primitives below.
    */
   fields: {
-    summary: {
+    title: aiTextFieldAdmin(),
+    summary: aiTextAreaFieldAdmin({
       components: {
         HelpText: SummaryLength,
       },
-    },
+    }),
+    content: aiRichTextAdmin(),
   },
 
   /**

package/dist/templates/byline-examples/collections/pages/admin.tsx

@@ -139,7 +139,8 @@ export const PagesAdmin: CollectionAdminConfig = defineAdmin(Pages, {
     url: (doc, { locale }) => {
       if (!doc.path) return null
       const prefix = locale && locale !== i18n.interface.defaultLocale ? `/${locale}` : ''
-      const pathWithArea = doc.fields?.area && doc.fields.area !== 'root' ? `${doc.fields.area}/${doc.path}` : doc.path
+      const pathWithArea =
+        doc.fields?.area && doc.fields.area !== 'root' ? `${doc.fields.area}/${doc.path}` : doc.path
       return `${prefix}/${pathWithArea}`
     },
   },

package/dist/templates/byline-examples/fields/ai-text.ts

@@ -0,0 +1,47 @@
+/**
+ * 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
+ */
+
+/**
+ * **Admin-side helper.** Returns a `FieldAdminConfig` — drop into a
+ * collection's `fields` map in `<collection>/admin.tsx`, keyed by the
+ * schema field's name. Pairs with a plain `{ type: 'text' }` entry on
+ * the schema side; this file owns the React (label icon + AI panel).
+ *
+ * See `docs/FIELDS.md` for the schema-vs-admin model.
+ */
+
+import type { FieldAdminConfig, FieldComponentSlots } from '@byline/core'
+
+import { AiFieldLabel } from './ai-widgets/ai-field-label.js'
+import { AiFieldPanel } from './ai-widgets/ai-field-panel.js'
+
+/**
+ * Returns a `FieldAdminConfig` that adds an AI toggle button to the field
+ * label and an `<AiPluginText>` panel as an `afterField` adornment. Spread
+ * any extra `components` overrides via the optional argument.
+ *
+ * @example
+ * ```ts
+ * // apps/webapp/byline/collections/news/admin.tsx
+ * fields: {
+ *   title: aiTextFieldAdmin(),
+ * }
+ * ```
+ */
+export function aiTextFieldAdmin(
+  options: { components?: FieldComponentSlots } = {}
+): FieldAdminConfig {
+  const { components: extra } = options
+  return {
+    components: {
+      Label: AiFieldLabel,
+      afterField: AiFieldPanel,
+      ...extra,
+    },
+  }
+}

package/dist/templates/byline-examples/fields/ai-textarea.ts

@@ -0,0 +1,50 @@
+/**
+ * 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
+ */
+
+/**
+ * **Admin-side helper.** Returns a `FieldAdminConfig` — drop into a
+ * collection's `fields` map in `<collection>/admin.tsx`, keyed by the
+ * schema field's name. Pairs with a plain `{ type: 'textArea' }` entry
+ * on the schema side; this file owns the React (label icon + AI panel).
+ *
+ * See `docs/FIELDS.md` for the schema-vs-admin model.
+ */
+
+import type { FieldAdminConfig, FieldComponentSlots } from '@byline/core'
+
+import { AiFieldLabel } from './ai-widgets/ai-field-label.js'
+import { AiFieldPanel } from './ai-widgets/ai-field-panel.js'
+
+/**
+ * Returns a `FieldAdminConfig` that adds an AI toggle button to the field
+ * label and an `<AiPluginText>` panel as an `afterField` adornment for a
+ * `textArea` schema field. Spread any extra `components` overrides via
+ * the optional argument.
+ *
+ * @example
+ * ```ts
+ * // apps/webapp/byline/collections/news/admin.tsx
+ * fields: {
+ *   summary: aiTextAreaFieldAdmin({
+ *     components: { HelpText: SummaryLength },
+ *   }),
+ * }
+ * ```
+ */
+export function aiTextAreaFieldAdmin(
+  options: { components?: FieldComponentSlots } = {}
+): FieldAdminConfig {
+  const { components: extra } = options
+  return {
+    components: {
+      Label: AiFieldLabel,
+      afterField: AiFieldPanel,
+      ...extra,
+    },
+  }
+}

package/dist/templates/byline-examples/fields/ai-widgets/ai-field-label.tsx

@@ -0,0 +1,48 @@
+/**
+ * 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 { FieldLabelSlotProps } from '@byline/core'
+import { AiIcon, IconButton, Label } from '@byline/ui/react'
+
+import { useAiPanelOpen } from './ai-panel-store.js'
+
+/**
+ * `Label` slot for AI-enabled text fields. Renders the standard label
+ * alongside a small icon button that toggles the AI panel rendered by
+ * the matching `afterField` slot.
+ */
+export function AiFieldLabel({
+  field,
+  path,
+  label,
+  required,
+  id,
+}: FieldLabelSlotProps): React.JSX.Element {
+  const [open, setOpen] = useAiPanelOpen(path)
+  return (
+    <span style={{ display: 'inline-flex', alignItems: 'center', gap: '0.5rem' }}>
+      <Label
+        id={`${id}-label`}
+        htmlFor={id}
+        label={label ?? field.label ?? field.name}
+        required={required}
+      />
+      <IconButton
+        size="sm"
+        variant="text"
+        className="outline-none"
+        type="button"
+        aria-label={open ? 'Hide AI assistant' : 'Show AI assistant'}
+        aria-pressed={open}
+        onClick={() => setOpen(!open)}
+      >
+        <AiIcon />
+      </IconButton>
+    </span>
+  )
+}

package/dist/templates/byline-examples/fields/ai-widgets/ai-field-panel.tsx

@@ -0,0 +1,42 @@
+/**
+ * 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 { useCallback } from 'react'
+
+import { AiPluginText } from '@byline/ai/plugins/text'
+import type { FieldAdornmentSlotProps } from '@byline/core'
+import { useFormContext } from '@byline/ui/react'
+
+import { useAiPanelOpen } from './ai-panel-store.js'
+
+/**
+ * `afterField` slot for AI-enabled text fields. Renders `<AiPluginText>`
+ * controlled by the per-path store, reads the current value from form
+ * context, and dispatches a value update via `setFieldValue` when the
+ * AI returns a result.
+ */
+export function AiFieldPanel({ path, value }: FieldAdornmentSlotProps): React.JSX.Element {
+  const { setFieldValue } = useFormContext()
+  const [open, setOpen] = useAiPanelOpen(path)
+
+  const handleApply = useCallback(
+    (nextText: string) => {
+      setFieldValue(path, nextText)
+    },
+    [path, setFieldValue]
+  )
+
+  return (
+    <AiPluginText
+      inputText={typeof value === 'string' ? value : ''}
+      onApplyResult={handleApply}
+      open={open}
+      onOpenChange={setOpen}
+    />
+  )
+}

package/dist/templates/byline-examples/fields/ai-widgets/ai-panel-store.ts

@@ -0,0 +1,52 @@
+/**
+ * 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
+ */
+
+/**
+ * Tiny per-field-path open/closed store for the AI panel. The `Label`
+ * slot (toggle button) and the `afterField` slot (panel) for the same
+ * field render as siblings in the form, so they coordinate through this
+ * module-level store rather than React context.
+ */
+
+import { useSyncExternalStore } from 'react'
+
+type Listener = () => void
+
+const openByPath = new Map<string, boolean>()
+const listenersByPath = new Map<string, Set<Listener>>()
+
+function notify(path: string): void {
+  const set = listenersByPath.get(path)
+  if (set == null) return
+  for (const listener of set) listener()
+}
+
+function subscribe(path: string, listener: Listener): () => void {
+  let set = listenersByPath.get(path)
+  if (set == null) {
+    set = new Set()
+    listenersByPath.set(path, set)
+  }
+  set.add(listener)
+  return () => {
+    set?.delete(listener)
+  }
+}
+
+export function useAiPanelOpen(path: string): [boolean, (open: boolean) => void] {
+  const open = useSyncExternalStore(
+    (listener) => subscribe(path, listener),
+    () => openByPath.get(path) ?? false,
+    () => false
+  )
+  const setOpen = (next: boolean) => {
+    openByPath.set(path, next)
+    notify(path)
+  }
+  return [open, setOpen]
+}

package/dist/templates/byline-examples/fields/lexical-richtext-ai.tsx

@@ -0,0 +1,82 @@
+/**
+ * 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
+ */
+
+/**
+ * **Admin-side module.** Exports two things — both consumed admin-side,
+ * never from a schema:
+ *
+ *   - `LexicalRichTextAi` — a `RichTextEditorComponent` that registers
+ *     the AI assistant by adding `AiLexicalExtension` to the editor's
+ *     extension graph. Register globally in
+ *     `apps/webapp/byline/admin.config.ts` under
+ *     `fields.richText.editor` to AI-enable every richtext field.
+ *   - `aiRichTextAdmin()` — a `FieldAdminConfig` factory. Drop into a
+ *     collection's `fields` map in `<collection>/admin.tsx` to opt one
+ *     field into the AI editor without changing the global registration.
+ *
+ * Pairs with a plain `{ type: 'richText' }` entry on the schema side —
+ * schema files must stay React-free and tsx-loadable.
+ *
+ * See `docs/FIELDS.md` for the schema-vs-admin model.
+ */
+
+import { AiLexicalExtension } from '@byline/ai/plugins/lexical'
+import type { FieldAdminConfig, RichTextEditorProps } from '@byline/core'
+import { lexicalEditor } from '@byline/richtext-lexical'
+
+/**
+ * AI-enabled wrapper around `@byline/richtext-lexical`'s editor.
+ *
+ * Composes a `lexicalEditor()` with `AiLexicalExtension` added to the
+ * extensions graph. The extension contributes a toolbar button via the
+ * `BylineToolbarExtension` peer-dependency contract and mounts the AI
+ * drawer via `ReactExtension.decorators` — no `featureAfterEditor`, no
+ * React-context registry hop.
+ *
+ * **Global** opt-in — register in `apps/webapp/byline/admin.config.ts`:
+ *
+ * ```ts
+ * fields: {
+ *   richText: { editor: LexicalRichTextAi },
+ * }
+ * ```
+ *
+ * **Per-field** opt-in — see `aiRichTextAdmin()` below.
+ */
+export const LexicalRichTextAi = lexicalEditor((c) => {
+  c.extensions.add(AiLexicalExtension)
+  return c
+}) satisfies (props: RichTextEditorProps) => React.JSX.Element
+
+/**
+ * Returns a `FieldAdminConfig` that opts a single richText field into
+ * the AI-enabled editor (`LexicalRichTextAi`) without changing the
+ * site-wide registration. Drop into a `CollectionAdminConfig.fields`
+ * map, keyed by the schema field's name.
+ *
+ * Lives on the admin side (alongside `aiTextFieldAdmin` /
+ * `aiTextAreaFieldAdmin`) so the schema graph stays React-free and
+ * tsx-loadable — the server bootstrap in `byline/server.config.ts`
+ * must be able to import collection schemas without pulling in the
+ * Lexical editor and the AI plugin.
+ *
+ * @example
+ * ```ts
+ * // apps/webapp/byline/collections/news/admin.tsx
+ * import { aiRichTextAdmin } from '../../fields/lexical-richtext-ai.js'
+ *
+ * fields: {
+ *   content: aiRichTextAdmin(),
+ * }
+ * ```
+ */
+export function aiRichTextAdmin(): FieldAdminConfig {
+  return {
+    editor: LexicalRichTextAi,
+  }
+}

package/dist/templates/byline-examples/fields/lexical-richtext-compact.ts

@@ -18,7 +18,10 @@
  * Extension references (TableExtension, AdmonitionExtension, etc.) are
  * not JSON-safe and would break tsx-loaded seeds; per-field extension
  * removal goes through a client-side wrapper component registered via
- * `FieldAdminConfig.editor`.
+ * `FieldAdminConfig.editor` — see `aiRichTextAdmin()` for the pattern.
+ *
+ * To AI-enable the resulting field, pair this with `aiRichTextAdmin()`
+ * on the admin side — see `lexical-richtext-ai.tsx`.
  *
  * See `docs/FIELDS.md` for the full schema-vs-admin model.
  */
@@ -51,9 +54,10 @@ type Options = Partial<Omit<RichTextField, 'type' | 'editorConfig'>> & {
  *
  * To narrow the *extension* set per-field — drop tables, lists, embeds,
  * the floating format toolbar, the table action menu — register a
- * `LexicalRichTextCompact` wrapper component via `FieldAdminConfig.editor`.
- * Extension references aren't safe to bake into schemas, and floating
- * UIs are now extension-presence controlled rather than settings-controlled.
+ * `LexicalRichTextCompact` wrapper component via `FieldAdminConfig.editor`
+ * (same pattern as `aiRichTextAdmin()`). Extension references aren't safe
+ * to bake into schemas, and floating UIs are now extension-presence
+ * controlled rather than settings-controlled.
  */
 function applyCompactPreset(config: EditorConfig): EditorConfig {
   const o = config.settings.options

package/dist/templates/byline-examples/i18n.ts

@@ -23,7 +23,7 @@ export interface LocaleDefinition {
 /** Locales available in the CMS admin interface. */
 export const interfaceLocales: LocaleDefinition[] = [
   { code: 'en', label: 'English' },
-  { code: 'fr', label: 'Français' },
+  { code: 'es', label: 'Español' },
 ]
 
 /** Locales a document can be published in. */

package/dist/templates/byline-examples/plugins/ai/ai-plugin-text.tsx

@@ -0,0 +1,58 @@
+'use client'
+
+import type * as React from 'react'
+import { useCallback, useState } from 'react'
+
+import { AiPluginText as AiPluginTextRoot } from '@byline/ai/plugins/text'
+import { AiIcon, IconButton, Input } from '@byline/ui/react'
+
+export function AiPluginText() {
+  const [inputText, setInputText] = useState('')
+  const [open, setOpen] = useState(false)
+
+  const handleToggleOpen = useCallback(() => {
+    setOpen((prevOpen) => !prevOpen)
+  }, [])
+
+  const handleInputChange = useCallback((event: React.ChangeEvent<HTMLInputElement>) => {
+    setInputText(event.target.value)
+  }, [])
+
+  const handleApplyResult = useCallback((nextText: string) => {
+    setInputText(nextText)
+  }, [])
+
+  const handleClearInput = useCallback(() => {
+    setInputText('')
+  }, [])
+
+  return (
+    <div className="ai-plugin-text">
+      <IconButton
+        onClick={handleToggleOpen}
+        variant="text"
+        size="md"
+        className="w-7 h-7 max-w-7 max-h-7 min-w-7 min-h-7"
+      >
+        <AiIcon />
+      </IconButton>
+      <Input
+        id="foo"
+        name="foo"
+        label="Simple Text Input"
+        type="text"
+        onChange={handleInputChange}
+        value={inputText}
+        helpText="Enter some text, or enter a prompt below to generate text."
+        placeholder="Start writing your content here..."
+      />
+      <AiPluginTextRoot
+        inputText={inputText}
+        onApplyResult={handleApplyResult}
+        onClearInput={handleClearInput}
+        open={open}
+        onOpenChange={setOpen}
+      />
+    </div>
+  )
+}