@byline/admin 3.15.2 → 3.16.1

package/src/fields/array/array-field.tsx

@@ -29,12 +29,20 @@ export const ArrayField = ({
   defaultValue,
   path,
   disableSorting = false,
+  collectionPath,
   contentLocale,
 }: {
   field: ArrayFieldType
   defaultValue: any
   path: string
   disableSorting?: boolean
+  /**
+   * Collection path forwarded to upload-capable fields (`file` / `image`)
+   * nested inside an array item, which need it to reach the `/upload`
+   * endpoint. Without it those fields fall back to their empty placeholder
+   * and never render an upload widget.
+   */
+  collectionPath?: string
   /**
    * Active content locale, forwarded to each array item's fields so
    * localized widgets nested inside an array (e.g. a `localized` richText)
@@ -205,6 +213,7 @@ export const ArrayField = ({
                 defaultValue={groupData[innerField.name]}
                 basePath={`${arrayElementPath}.${childField.name}`}
                 disableSorting={true}
+                collectionPath={collectionPath}
                 contentLocale={contentLocale}
               />
             ))}
@@ -219,6 +228,7 @@ export const ArrayField = ({
           defaultValue={initial}
           basePath={arrayElementPath}
           disableSorting={true}
+          collectionPath={collectionPath}
           contentLocale={contentLocale}
         />
       )

package/src/fields/field-renderer.tsx

@@ -254,6 +254,7 @@ export const FieldRenderer = ({
             }
             defaultValue={defaultValue}
             path={path}
+            collectionPath={collectionPath}
             contentLocale={contentLocale}
           />
         )
@@ -275,6 +276,7 @@ export const FieldRenderer = ({
             defaultValue={defaultValue}
             path={path}
             disableSorting={disableSorting}
+            collectionPath={collectionPath}
             contentLocale={contentLocale}
           />
         )

package/src/fields/field-services-types.ts

@@ -62,7 +62,7 @@ export type UploadFieldFn = (
   createDocument?: boolean
 ) => Promise<UploadedFileResult>
 
-// --- Document tree (the `tree: true` primitive — docs/DOCUMENT-TREE.md) -----
+// --- Document tree (the `tree: true` primitive — docs/04-collections/03-document-trees.md) -----
 
 /** One hydrated ancestor in a document's breadcrumb trail (root-first). */
 export interface TreeAncestor {

package/src/fields/group/group-field.tsx

@@ -32,6 +32,12 @@ interface GroupFieldProps {
   field: GroupFieldType
   defaultValue: any
   path: string
+  /**
+   * Collection path forwarded to upload-capable child fields (`file` / `image`),
+   * which need it to reach the `/upload` endpoint. Without it those fields fall
+   * back to their empty placeholder and never render an upload widget.
+   */
+  collectionPath?: string
   /**
    * Active content locale, forwarded to child fields so localized widgets
    * nested inside the group (e.g. a `localized` richText) can render their
@@ -40,7 +46,13 @@ interface GroupFieldProps {
   contentLocale?: string
 }
 
-export const GroupField = ({ field, defaultValue, path, contentLocale }: GroupFieldProps) => {
+export const GroupField = ({
+  field,
+  defaultValue,
+  path,
+  collectionPath,
+  contentLocale,
+}: GroupFieldProps) => {
   const fieldError = useFieldError(field.name)
   // Default value for a group field is a plain object: { rating: 5, comment: '...' }
   // Normalize to a plain object if not already one.
@@ -80,6 +92,7 @@ export const GroupField = ({ field, defaultValue, path, contentLocale }: GroupFi
               defaultValue={groupData[innerField.name]}
               basePath={path}
               disableSorting={true}
+              collectionPath={collectionPath}
               contentLocale={contentLocale}
             />
           )

package/src/fields/relation/relation-many-field.tsx

@@ -32,7 +32,7 @@ import cx from 'classnames'
 
 import { useFieldError, useFieldValue, useFormContext } from '../../forms/form-context'
 import styles from './relation-field.module.css'
-import { RelationPicker } from './relation-picker'
+import { RelationPicker, type RelationPickerSelection } from './relation-picker'
 import { RelationSummary } from './relation-summary'
 
 // A single stored item. On the edit path the loader's populate pass attaches
@@ -147,24 +147,29 @@ export const RelationManyField = ({ field, defaultValue, id, path }: RelationMan
     return Array.isArray(defaultValue) ? (defaultValue as IncomingRelationValue[]) : []
   }
 
-  const handleAdd = (selection: {
-    targetDocumentId: string
-    targetCollectionId: string
-    record?: Record<string, any>
-  }) => {
+  const handleAddMany = (selections: RelationPickerSelection[]) => {
     setPickerOpen(false)
     const current = currentArray()
-    // Dedup — a target may appear at most once.
-    if (current.some((v) => v.targetDocumentId === selection.targetDocumentId)) return
-    if (selection.record) {
-      setPickedRecords((prev) => ({ ...prev, [selection.targetDocumentId]: selection.record! }))
+    // Dedup the batch against the current array — a target may appear at most
+    // once. The picker already disables already-added rows, so this is a
+    // belt-and-braces guard for stale state (e.g. a concurrent remove).
+    const existing = new Set(current.map((v) => v.targetDocumentId))
+    const additions = selections.filter((s) => !existing.has(s.targetDocumentId))
+    if (additions.length === 0) return
+    const records = additions.filter((s) => s.record != null)
+    if (records.length > 0) {
+      setPickedRecords((prev) => {
+        const next = { ...prev }
+        for (const s of records) next[s.targetDocumentId] = s.record!
+        return next
+      })
     }
     setFieldValue(fieldPath, [
       ...current,
-      {
-        targetDocumentId: selection.targetDocumentId,
-        targetCollectionId: selection.targetCollectionId,
-      },
+      ...additions.map((s) => ({
+        targetDocumentId: s.targetDocumentId,
+        targetCollectionId: s.targetCollectionId,
+      })),
     ])
   }
 
@@ -260,11 +265,13 @@ export const RelationManyField = ({ field, defaultValue, id, path }: RelationMan
           </div>
 
           <RelationPicker
+            multiple
             targetCollectionPath={field.targetCollection}
             targetDefinition={targetDef}
             displayField={field.displayField}
             isOpen={pickerOpen}
-            onSelect={handleAdd}
+            excludeIds={items.map((v) => v.targetDocumentId)}
+            onSelectMany={handleAddMany}
             onDismiss={() => setPickerOpen(false)}
           />
         </>

package/src/fields/relation/relation-picker.module.css

@@ -108,6 +108,55 @@
   border-left: 2px solid var(--primary-200);
 }
 
+/* Multi-select mode: rows lay out check indicator + content + trailing hint. */
+.row-multi,
+:global(.byline-field-relation-picker-row-multi) {
+  display: flex;
+  align-items: center;
+  gap: 0.625rem;
+}
+
+.check,
+:global(.byline-field-relation-picker-check) {
+  flex: none;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 16px;
+  height: 16px;
+  border: 1px solid var(--gray-400);
+  border-radius: 4px;
+  color: transparent;
+}
+
+.check-checked,
+:global(.byline-field-relation-picker-check-checked) {
+  background-color: var(--primary-200);
+  border-color: var(--primary-200);
+  color: #fff;
+}
+
+/* Already-added rows: inert, dimmed, no hover affordance. */
+.row-added,
+:global(.byline-field-relation-picker-row-added) {
+  opacity: 0.55;
+  cursor: default;
+}
+
+.row-added:hover,
+:global(.byline-field-relation-picker-row-added):hover {
+  background-color: transparent;
+}
+
+.added-hint,
+:global(.byline-field-relation-picker-added-hint) {
+  margin-left: auto;
+  flex: none;
+  color: var(--gray-500);
+  font-size: var(--font-size-xs);
+  white-space: nowrap;
+}
+
 .row-cells,
 :global(.byline-field-relation-picker-row-cells) {
   display: flex;

package/src/fields/relation/relation-picker.tsx

@@ -11,7 +11,7 @@ import { useCallback, useEffect, useState } from 'react'
 import type { CollectionAdminConfig, CollectionDefinition } from '@byline/core'
 import { getCollectionAdminConfig, resolveItemViewColumns } from '@byline/core'
 import { useTranslation } from '@byline/i18n/react'
-import { Button, LoaderRing, Modal, Search } from '@byline/ui/react'
+import { Button, CheckIcon, LoaderRing, Modal, Search } from '@byline/ui/react'
 import cx from 'classnames'
 
 import { useBylineFieldServices } from '../field-services-context'
@@ -39,7 +39,21 @@ import styles from './relation-picker.module.css'
  *
  * Paths 2–4 render a single-line label (primary) + `path` (secondary).
  */
-interface RelationPickerProps {
+/**
+ * One confirmed pick. `record` is the raw document the picker row rendered —
+ * the caller can use it to show the selected value in its own tile without a
+ * refetch. The fields available on `record` are whatever `resolveSelectFields`
+ * asked the listing endpoint for (picker columns + `useAsTitle` +
+ * `displayField`), so any display surface downstream of the picker that also
+ * renders from those same columns will find the data it needs.
+ */
+export interface RelationPickerSelection {
+  targetDocumentId: string
+  targetCollectionId: string
+  record?: Record<string, any>
+}
+
+interface RelationPickerBaseProps {
   /** The target collection path (e.g. `'media'`). */
   targetCollectionPath: string
   /** The target collection definition (used for labels + displayField fallback). */
@@ -58,25 +72,38 @@ interface RelationPickerProps {
   extraSelectFields?: string[]
   /** Modal open/close state. */
   isOpen: boolean
-  /**
-   * Called with the picked selection when the user confirms.
-   *
-   * `record` is the raw document the picker row rendered — the caller can
-   * use it to show the selected value in its own tile without a refetch.
-   * The fields available on `record` are whatever `resolveSelectFields`
-   * asked the listing endpoint for (picker columns + `useAsTitle` +
-   * `displayField`), so any display surface downstream of the picker that
-   * also renders from those same columns will find the data it needs.
-   */
-  onSelect: (selection: {
-    targetDocumentId: string
-    targetCollectionId: string
-    record?: Record<string, any>
-  }) => void
   /** Called when the user dismisses the modal. */
   onDismiss: () => void
 }
 
+interface RelationPickerSingleProps extends RelationPickerBaseProps {
+  /** Single-select (default): clicking a row selects it; confirm returns one pick. */
+  multiple?: false
+  /** Called with the picked selection when the user confirms. */
+  onSelect: (selection: RelationPickerSelection) => void
+  onSelectMany?: never
+  excludeIds?: never
+}
+
+interface RelationPickerMultiProps extends RelationPickerBaseProps {
+  /**
+   * Multi-select mode (`hasMany` widgets): rows toggle a check state and the
+   * confirm action returns every selection in pick order — several picks in
+   * one trip instead of reopening the modal per item.
+   */
+  multiple: true
+  /** Called with the full selection set (pick order) when the user confirms. */
+  onSelectMany: (selections: RelationPickerSelection[]) => void
+  onSelect?: never
+  /**
+   * Target ids already present on the caller's value. Rendered as disabled
+   * "already added" rows so the same target can't be picked twice.
+   */
+  excludeIds?: string[]
+}
+
+type RelationPickerProps = RelationPickerSingleProps | RelationPickerMultiProps
+
 const PAGE_SIZE = 15
 
 export const RelationPicker = ({
@@ -85,13 +112,22 @@ export const RelationPicker = ({
   displayField,
   extraSelectFields,
   isOpen,
+  multiple = false,
+  excludeIds,
   onSelect,
+  onSelectMany,
   onDismiss,
 }: RelationPickerProps) => {
   const [query, setQuery] = useState<string>('')
   const [page, setPage] = useState<number>(1)
   const { t } = useTranslation('byline-admin')
   const [selectedDocumentId, setSelectedDocumentId] = useState<string | null>(null)
+  // Multi-select state. A Map keyed by target id preserves pick order (the
+  // confirmed batch appends in that order) and carries each row's record so
+  // picks survive page/search changes that swap out `documents`.
+  const [selectedMap, setSelectedMap] = useState<Map<string, Record<string, any> | undefined>>(
+    () => new Map()
+  )
   const [loading, setLoading] = useState<boolean>(false)
   const [error, setError] = useState<string | null>(null)
   const [documents, setDocuments] = useState<any[]>([])
@@ -110,6 +146,7 @@ export const RelationPicker = ({
       setQuery('')
       setPage(1)
       setSelectedDocumentId(null)
+      setSelectedMap(new Map())
       setError(null)
     }
   }, [isOpen])
@@ -174,7 +211,7 @@ export const RelationPicker = ({
     null
 
   const handleSelect = useCallback(() => {
-    if (!selectedDocumentId || !collectionId) return
+    if (!selectedDocumentId || !collectionId || !onSelect) return
     const record = documents.find((d) => d?.id === selectedDocumentId)
     onSelect({
       targetDocumentId: selectedDocumentId,
@@ -183,6 +220,30 @@ export const RelationPicker = ({
     })
   }, [selectedDocumentId, collectionId, documents, onSelect])
 
+  const handleSelectMany = useCallback(() => {
+    if (selectedMap.size === 0 || !collectionId || !onSelectMany) return
+    onSelectMany(
+      Array.from(selectedMap, ([targetDocumentId, record]) => ({
+        targetDocumentId,
+        targetCollectionId: collectionId,
+        record,
+      }))
+    )
+  }, [selectedMap, collectionId, onSelectMany])
+
+  const toggleSelected = useCallback((doc: Record<string, any>) => {
+    const id = doc.id as string
+    setSelectedMap((prev) => {
+      const next = new Map(prev)
+      if (next.has(id)) {
+        next.delete(id)
+      } else {
+        next.set(id, doc)
+      }
+      return next
+    })
+  }, [])
+
   const title = t('fields.relation.selectPickerTitle', {
     label: targetDefinition?.labels.singular ?? targetCollectionPath,
   })
@@ -228,21 +289,55 @@ export const RelationPicker = ({
                 <ul className={cx('byline-field-relation-picker-rows', styles.rows)}>
                   {documents.map((doc) => {
                     const id = doc.id as string
-                    const selected = selectedDocumentId === id
+                    const selected = multiple ? selectedMap.has(id) : selectedDocumentId === id
+                    const excluded = multiple && (excludeIds?.includes(id) ?? false)
                     return (
                       <li key={id}>
                         <button
                           type="button"
+                          disabled={excluded}
+                          aria-pressed={multiple ? selected : undefined}
+                          title={excluded ? t('fields.relation.picker.alreadyAdded') : undefined}
                           className={cx(
                             'byline-field-relation-picker-row-button',
                             styles['row-button'],
+                            multiple && [
+                              'byline-field-relation-picker-row-multi',
+                              styles['row-multi'],
+                            ],
                             selected && [
                               'byline-field-relation-picker-row-selected',
                               styles['row-selected'],
+                            ],
+                            excluded && [
+                              'byline-field-relation-picker-row-added',
+                              styles['row-added'],
                             ]
                           )}
-                          onClick={() => setSelectedDocumentId(id)}
+                          onClick={() => {
+                            if (excluded) return
+                            if (multiple) {
+                              toggleSelected(doc)
+                            } else {
+                              setSelectedDocumentId(id)
+                            }
+                          }}
                         >
+                          {multiple && (
+                            <span
+                              aria-hidden="true"
+                              className={cx(
+                                'byline-field-relation-picker-check',
+                                styles.check,
+                                (selected || excluded) && [
+                                  'byline-field-relation-picker-check-checked',
+                                  styles['check-checked'],
+                                ]
+                              )}
+                            >
+                              {(selected || excluded) && <CheckIcon width="12px" height="12px" />}
+                            </span>
+                          )}
                           {pickerColumns && pickerColumns.length > 0 ? (
                             <div
                               className={cx(
@@ -281,6 +376,16 @@ export const RelationPicker = ({
                               )}
                             </div>
                           )}
+                          {excluded && (
+                            <span
+                              className={cx(
+                                'byline-field-relation-picker-added-hint',
+                                styles['added-hint']
+                              )}
+                            >
+                              {t('fields.relation.picker.alreadyAdded')}
+                            </span>
+                          )}
                         </button>
                       </li>
                     )
@@ -331,10 +436,12 @@ export const RelationPicker = ({
             className={cx('byline-field-relation-picker-action', styles.action)}
             intent="primary"
             type="button"
-            disabled={!selectedDocumentId}
-            onClick={handleSelect}
+            disabled={multiple ? selectedMap.size === 0 : !selectedDocumentId}
+            onClick={multiple ? handleSelectMany : handleSelect}
           >
-            {t('common.actions.select')}
+            {multiple
+              ? t('fields.relation.picker.addSelected', { count: selectedMap.size })
+              : t('common.actions.select')}
           </Button>
         </Modal.Actions>
       </Modal.Container>

package/src/forms/available-locales-reconcile.test.node.ts

@@ -14,7 +14,7 @@ import { reconcileLocaleState } from './available-locales-reconcile.js'
  * The widget's reconciliation is expressed purely as Checkbox intent +
  * disabled state — no per-row text. `reconcileLocaleState` is the pure heart
  * of that mapping; the four cells below are the full truth table from
- * docs/I18N.md.
+ * docs/07-internationalization/index.md.
  */
 describe('reconcileLocaleState', () => {
   it('ledger-complete + advertised → green, enabled (advertised & complete)', () => {

package/src/forms/form-context.tsx

@@ -64,7 +64,7 @@ const sameLocaleSet = (a: string[], b: string[]): boolean => {
  * Save button. `content` mints a new version (normal workflow). `direct-write`
  * is an immediate, non-versioned write of the document-grain system fields
  * (path / advertised locales) that does NOT reset workflow status. `both` does
- * each through its own write path. See docs/I18N.md.
+ * each through its own write path. See docs/07-internationalization/index.md.
  */
 export type DirtyReason = 'none' | 'content' | 'direct-write' | 'both'
 
@@ -103,7 +103,7 @@ interface FormContextType {
   /**
    * Partition the current dirty state into content vs. system-field (path /
    * advertised-locales) writes so the Save button can branch. See
-   * docs/I18N.md.
+   * docs/07-internationalization/index.md.
    */
   getDirtyBreakdown: () => DirtyBreakdown
   subscribeField: (name: string, listener: FieldListener) => () => void
@@ -349,7 +349,7 @@ export const FormProvider = ({
   // button can route each piece correctly: content → versioned write; the
   // document-grain system fields (path / advertised locales) → immediate,
   // non-versioned direct write that leaves workflow status untouched.
-  // See docs/I18N.md.
+  // See docs/07-internationalization/index.md.
   const getDirtyBreakdown = useCallback((): DirtyBreakdown => {
     const keys = dirtyFields.current
     const pathDirty = keys.has(SYSTEM_PATH_DIRTY_KEY)

package/src/forms/form-modals.tsx

@@ -54,7 +54,7 @@ export const UnsavedChangesModal = ({ onClose }: { onClose: () => void }) => {
  * Confirms an immediate, non-versioned write of the document-grain system
  * fields (path / advertised locales) — which does NOT reset workflow status.
  * When content is also dirty, the copy reassures that content edits still
- * follow the normal revision + publish workflow. See docs/I18N.md.
+ * follow the normal revision + publish workflow. See docs/07-internationalization/index.md.
  */
 export const SystemFieldsConfirmModal = ({
   contentDirty,

package/src/forms/form-renderer.tsx

@@ -56,7 +56,7 @@ export interface PublishedVersionInfo {
  * patches) alongside the document-grain system fields (path / advertised
  * locales) and per-bucket dirty flags so the host can route each piece to the
  * right write path — versioned for content, immediate/non-versioned for the
- * system fields. See docs/I18N.md.
+ * system fields. See docs/07-internationalization/index.md.
  */
 export interface SystemFieldsSubmitPayload {
   // biome-ignore lint/suspicious/noExplicitAny: data is collection-specific
@@ -134,7 +134,7 @@ export interface FormRendererProps {
    * Opts the document-tree placement widget into the sidebar (above the
    * available-locales widget). Sourced from `CollectionDefinition.tree` by the
    * caller. Renders only in edit mode (placement needs a persisted document)
-   * and only when the host wires the tree services. See docs/DOCUMENT-TREE.md.
+   * and only when the host wires the tree services. See docs/04-collections/03-document-trees.md.
    */
   tree?: boolean
   headingLabel?: string
@@ -235,7 +235,7 @@ const FormContent = ({
   const [showUnsavedModal, setShowUnsavedModal] = useState(false)
   // Holds the pending Save payload while the editor confirms an immediate,
   // non-versioned system-field write (path / advertised locales). Non-null
-  // means the confirmation modal is open. See docs/I18N.md.
+  // means the confirmation modal is open. See docs/07-internationalization/index.md.
   const [pendingSystemFieldsSubmit, setPendingSystemFieldsSubmit] =
     useState<SystemFieldsSubmitPayload | null>(null)
   const [contentLocale, setContentLocale] = useState(initialLocale ?? defaultLocale)
@@ -532,7 +532,7 @@ const FormContent = ({
         {/* Source-locale anchor indicator removed pending heading-layout work.
             To re-enable: render `<SourceLocaleBadge locale={sourceLocale} />`
             here from `initialData.sourceLocale` (mismatch-only is the intended
-            end state). See docs/I18N.md. */}
+            end state). See docs/07-internationalization/index.md. */}
         {headerSlot}
       </div>
       <div className={cx('byline-form-status-bar', styles['status-bar'])}>

package/src/forms/tree-placement-widget.tsx

@@ -30,7 +30,7 @@ export interface TreePlacementWidgetProps {
 
 /**
  * Sidebar widget for placing the current document within its collection's
- * single-parent document tree (the `tree: true` primitive — docs/DOCUMENT-TREE.md).
+ * single-parent document tree (the `tree: true` primitive — docs/04-collections/03-document-trees.md).
  *
  * The tree is document-grain and **unversioned**, so changes here write
  * immediately (independent of the form's content save). The editor picks a

package/src/lib/create-command.ts

@@ -16,7 +16,7 @@ import { assertAdminActor, requireAdminActor } from './assert-admin-actor.js'
  * contract (validate → authorise → invoke → shape) into a single
  * declaration.
  *
- * Implements Phase 1 of `docs/CORE-COMPOSITION.md`. Today's scope is
+ * Implements Phase 1 of `docs/03-architecture/02-core-composition.md`. Today's scope is
  * `@byline/admin`-internal: it gates against admin actor identity using
  * the existing `assertAdminActor` / `requireAdminActor` helpers, which
  * inherit the super-admin bypass from `AdminAuth.assertAbility`.

package/src/modules/admin-activity/abilities.ts

@@ -9,7 +9,7 @@
 import type { AbilityRegistry } from '@byline/auth'
 
 /**
- * Ability keys for the admin-activity module (docs/AUDIT.md — Workstream 4).
+ * Ability keys for the admin-activity module (docs/06-auth-and-security/02-auditability.md — Workstream 4).
  *
  * `read` gates the system-wide activity area — the `/admin/activity` report
  * over the version-stream + audit-log union. It is deliberately a **separate**

package/src/modules/admin-activity/index.ts

@@ -8,7 +8,7 @@
 
 /**
  * `@byline/admin/admin-activity` — the system-wide activity area
- * (docs/AUDIT.md — Workstream 4).
+ * (docs/06-auth-and-security/02-auditability.md — Workstream 4).
  *
  * Unlike the other admin modules this one owns no table and no AdminStore
  * repository: the activity feed is a read over the document db adapter's

package/src/modules/admin-permissions/abilities.ts

@@ -11,7 +11,7 @@ import type { AbilityRegistry } from '@byline/auth'
 /**
  * Ability keys for the admin-permissions module.
  *
- * `read` gates the inspector view (see docs/AUTHN-AUTHZ.md).
+ * `read` gates the inspector view (see docs/06-auth-and-security/01-authn-authz.md).
  * `update` will gate the per-role ability editor mounted on the
  * admin-roles role detail page — declared here so the role editor can
  * assert against it once that surface lands. The per-role editor shares

package/src/modules/admin-permissions/components/inspector.tsx

@@ -9,7 +9,7 @@
  */
 
 /**
- * Read-only abilities inspector — see docs/AUTHN-AUTHZ.md.
+ * Read-only abilities inspector — see docs/06-auth-and-security/01-authn-authz.md.
  *
  * Top level: a collapsible group per ability source (collections.docs,
  * admin.users, etc.), each containing the abilities that group

package/src/modules/admin-users/repository.ts

@@ -128,7 +128,7 @@ export interface AdminUsersRepository {
   getById(id: string): Promise<AdminUserRow | null>
   /**
    * Bulk lookup for audit actor-label resolution (the `actors`
-   * map on admin document reads — see docs/AUDIT.md, Workstream 1). Ids
+   * map on admin document reads — see docs/06-auth-and-security/02-auditability.md, Workstream 1). Ids
    * with no matching row are simply absent from the result; callers
    * render a tombstone label for them.
    */

package/src/widgets/source-locale-badge/source-locale-badge.tsx

@@ -27,7 +27,7 @@ export interface SourceLocaleBadgeProps {
  * NOTE: currently rendered for *every* document so the anchor is visible during
  * development. The intended end state is to show it only when `locale` differs
  * from the system's current default content locale (a normal single-default
- * install then shows nothing). See docs/I18N.md.
+ * install then shows nothing). See docs/07-internationalization/index.md.
  *
  * Stable override handle: `.byline-source-locale-badge`.
  */