@bitforgehq/ui 0.3.3 → 0.5.0-next.3

package/ai/REFERENCE.json

@@ -145,6 +145,22 @@
       "since": "0.3.0",
       "signature": "const BF_TAB_LINKS: InjectionToken<BfTabLinks>"
     },
+    {
+      "name": "BF_TABLE_SORT_SELECT",
+      "slug": "bf_table_sort_select",
+      "kind": "token",
+      "entryPoint": "@bitforgehq/ui",
+      "file": "src/components/table/table-sort-select.token.ts",
+      "summary": "The component a stacked table renders as its Sort by select",
+      "description": "The component a stacked `bf-table` renders as its Sort by select; `null` (the default) keeps the\nbuilt-in native `<select>`. `provideBfSelect()` from `@bitforgehq/ui/overlay` sets it to the\nstyled `bf-select`, so the core entry never imports the overlay entry. A component given here\nmust take the inputs `label` (string), `options` (`BfSelectOption<string>[]`) and `value`\n(string) and emit the picked value from the output `changed`. The table adds its layout classes\nto the component's host with `classList`, so the component must not overwrite its host\n`className` or `class` attribute directly.",
+      "members": [],
+      "methods": [],
+      "slots": [],
+      "references": [],
+      "usedBy": [],
+      "since": "0.5.0",
+      "signature": "const BF_TABLE_SORT_SELECT: InjectionToken<Type<unknown> | null>"
+    },
     {
       "name": "BfActionDirective",
       "slug": "bf-action-directive",
@@ -152,7 +168,7 @@
       "entryPoint": "@bitforgehq/ui",
       "file": "src/components/action/action.directive.ts",
       "summary": "Makes one link or button the click target of a whole card or list row",
-      "description": "The one interactive element of a `bf-card` or `bf-list-item` (the stretched-link pattern): put\nit on the `<a>` (navigation) or `<button>` (an action) that holds the card's heading text or the\nrow's title. Its `::after` stretches the hit area over the nearest positioned ancestor (the card\nbox, the row), so the whole surface is clickable while only the heading's link or button is\nexposed: the heading stays a heading and the accessible name is the title alone. It registers\nwith the nearest card or row, which then draws the pointer, the hover and, while the action has\nkeyboard focus, the focus ring; a card is never lit by the actions of rows nested in it. Give\nsecondary controls inside the surface `class=\"relative z-1\"` so they stay clickable above the\nstretched area.",
+      "description": "The one interactive element of a `bf-card` or `bf-list-item` (the stretched-link pattern): put\nit on the `<a>` (navigation) or `<button>` (an action) that holds the card's heading text or the\nrow's title. Its `::after` stretches the hit area over the nearest positioned ancestor (the card\nbox, the row), so the whole surface is clickable while only the heading's link or button is\nexposed: the heading stays a heading and the accessible name is the title alone. It registers\nwith the nearest card or row, which then draws the pointer, the hover and, while the action has\nkeyboard focus, the focus ring; a card is never lit by the actions of rows nested in it. Give\nsecondary controls inside the surface `class=\"relative z-1\"` so they stay clickable above the\nstretched area. When the surface marks a state that belongs in the name (an `unread` list\nrow), the directive names the element `aria-labelledby=\"<state id> <own id>\"`, so the link reads\n\"Unread, Account\", and restores the element's own `aria-labelledby` when the state goes.",
       "members": [],
       "methods": [],
       "slots": [],
@@ -280,6 +296,23 @@
       "signature": "type BfBadgeAppearance = BfBadgeVariant | 'info'",
       "values": ["neutral", "primary", "success", "warning", "danger", "info"]
     },
+    {
+      "name": "BfBadgeEmphasis",
+      "slug": "bf-badge-emphasis",
+      "kind": "type",
+      "entryPoint": "@bitforgehq/ui",
+      "file": "src/components/badge/badge.component.ts",
+      "summary": "The two badge emphases, the soft tint or the solid strong fill",
+      "description": "How loud a `bf-badge` is: `soft`, a pale tint with tinted text (the default), or `strong`, a\nsolid fill with contrasting text for the one state that must stand out, such as \"Critical\".",
+      "members": [],
+      "methods": [],
+      "slots": [],
+      "references": [],
+      "usedBy": ["bf-badge-component"],
+      "since": "0.4.0",
+      "signature": "type BfBadgeEmphasis = 'soft' | 'strong'",
+      "values": ["soft", "strong"]
+    },
     {
       "name": "BfBadgeVariant",
       "slug": "bf-badge-variant",
@@ -437,6 +470,40 @@
       "signature": "type BfCardVariant = 'raised' | 'tint' | 'ink' | 'flat'",
       "values": ["raised", "tint", "ink", "flat"]
     },
+    {
+      "name": "BfChatMessageRole",
+      "slug": "bf-chat-message-role",
+      "kind": "type",
+      "entryPoint": "@bitforgehq/ui",
+      "file": "src/components/chat-thread/chat-message.component.ts",
+      "summary": "Who wrote a chat message, the user or the assistant",
+      "description": "Who wrote a `bf-chat-message`: `user` (a tinted bubble at the inline end) or `assistant` (full\nwidth, no bubble).",
+      "members": [],
+      "methods": [],
+      "slots": [],
+      "references": [],
+      "usedBy": ["bf-chat-message-component"],
+      "since": "0.5.0",
+      "signature": "type BfChatMessageRole = 'user' | 'assistant'",
+      "values": ["user", "assistant"]
+    },
+    {
+      "name": "BfChatMessageStatus",
+      "slug": "bf-chat-message-status",
+      "kind": "type",
+      "entryPoint": "@bitforgehq/ui",
+      "file": "src/components/chat-thread/chat-message.component.ts",
+      "summary": "How a chat message ended: done, stopped by the user, or failed",
+      "description": "How a `bf-chat-message` ended: `done` (the default, no status line), `stopped` (the user\nstopped the reply) or `failed` (it did not arrive or was not sent).",
+      "members": [],
+      "methods": [],
+      "slots": [],
+      "references": [],
+      "usedBy": ["bf-chat-message-component"],
+      "since": "0.5.0",
+      "signature": "type BfChatMessageStatus = 'done' | 'stopped' | 'failed'",
+      "values": ["done", "stopped", "failed"]
+    },
     {
       "name": "BfChipGroupMode",
       "slug": "bf-chip-group-mode",
@@ -687,6 +754,22 @@
       "signature": "type BfEnterKeyHint = 'enter' | 'done' | 'go' | 'next' | 'previous' | 'search' | 'send'",
       "values": ["enter", "done", "go", "next", "previous", "search", "send"]
     },
+    {
+      "name": "BfFadeInDirective",
+      "slug": "bf-fade-in-directive",
+      "kind": "directive",
+      "entryPoint": "@bitforgehq/ui",
+      "file": "src/components/fade-in/fade-in.directive.ts",
+      "summary": "Fades an image in once it has loaded instead of popping in",
+      "description": "Fades an image in when it has loaded instead of letting it pop in line by line: put\n`bfFadeIn` on the `<img>`. The image stays transparent until its `load` (or `error`) event,\nthen fades in over 260 ms (`duration-slow`), at once under `prefers-reduced-motion: reduce`. An\nimage that is already loaded when it renders (from the cache) shows straight away. Reserve its\nspace (`width`/`height` attributes or an aspect ratio) so the layout does not move when it\narrives; for a placeholder while it loads, put a `bf-skeleton` behind it.",
+      "members": [],
+      "methods": [],
+      "slots": [],
+      "references": [],
+      "usedBy": [],
+      "since": "0.5.0",
+      "selector": "img[bfFadeIn]"
+    },
     {
       "name": "bfFieldControlClass",
       "slug": "bf-field-control-class",
@@ -781,6 +864,23 @@
       "signature": "type BfFieldSize = BfSize",
       "values": ["sm", "md", "lg"]
     },
+    {
+      "name": "BfFileInputVariant",
+      "slug": "bf-file-input-variant",
+      "kind": "type",
+      "entryPoint": "@bitforgehq/ui",
+      "file": "src/components/file-input/file-input.component.ts",
+      "summary": "The two looks of a file picker, a compact field or a drop zone",
+      "description": "The look of a `bf-file-input`: a compact field with a pick button (`field`), or a drop zone\n(`dropzone`). Both have the same API and behaviour.",
+      "members": [],
+      "methods": [],
+      "slots": [],
+      "references": [],
+      "usedBy": ["bf-file-input-component"],
+      "since": "0.5.0",
+      "signature": "type BfFileInputVariant = 'field' | 'dropzone'",
+      "values": ["field", "dropzone"]
+    },
     {
       "name": "BfIconButtonVariant",
       "slug": "bf-icon-button-variant",
@@ -798,6 +898,23 @@
       "signature": "type BfIconButtonVariant = 'tonal' | 'primary' | 'outline' | 'text'",
       "values": ["tonal", "primary", "outline", "text"]
     },
+    {
+      "name": "BfImageInputShape",
+      "slug": "bf-image-input-shape",
+      "kind": "type",
+      "entryPoint": "@bitforgehq/ui",
+      "file": "src/components/image-input/image-input.component.ts",
+      "summary": "The two tile shapes of an image picker, a circle or a rounded square",
+      "description": "The shape of a `bf-image-input` tile: a circle (`round`, for avatars) or a rounded square\n(`square`, for logos and covers).",
+      "members": [],
+      "methods": [],
+      "slots": [],
+      "references": [],
+      "usedBy": ["bf-image-input-component"],
+      "since": "0.5.0",
+      "signature": "type BfImageInputShape = 'round' | 'square'",
+      "values": ["round", "square"]
+    },
     {
       "name": "BfInputAutocapitalize",
       "slug": "bf-input-autocapitalize",
@@ -1543,6 +1660,285 @@
           "readonly": true,
           "default": "'The data could not be loaded'"
         },
+        {
+          "name": "listItemUnread",
+          "kind": "property",
+          "type": "string",
+          "required": true,
+          "doc": "bf-list-item's visually hidden state text before the title of an `unread` row.",
+          "readonly": true,
+          "default": "'Unread'"
+        },
+        {
+          "name": "fileInputChoose",
+          "kind": "property",
+          "type": "(multiple: boolean) => string",
+          "required": true,
+          "doc": "bf-file-input's button text.",
+          "readonly": true,
+          "default": "(multiple) => (multiple ? 'Choose files' : 'Choose file')"
+        },
+        {
+          "name": "fileInputDropHint",
+          "kind": "property",
+          "type": "(multiple: boolean) => string",
+          "required": true,
+          "doc": "bf-file-input's hint beside the button.",
+          "readonly": true,
+          "default": "(multiple) => (multiple ? 'or drop them here' : 'or drop it here')"
+        },
+        {
+          "name": "fileInputDropzone",
+          "kind": "property",
+          "type": "(multiple: boolean) => string",
+          "required": true,
+          "doc": "bf-file-input's drop zone text.",
+          "readonly": true,
+          "default": "(multiple) => (multiple ? 'Drag files here or browse' : 'Drag a file here or browse')"
+        },
+        {
+          "name": "fileInputTapToChoose",
+          "kind": "property",
+          "type": "(multiple: boolean) => string",
+          "required": true,
+          "doc": "bf-file-input's text under touch input.",
+          "readonly": true,
+          "default": "(multiple) => (multiple ? 'Tap to choose files' : 'Tap to choose a file')"
+        },
+        {
+          "name": "fileInputRemove",
+          "kind": "property",
+          "type": "(name: string) => string",
+          "required": true,
+          "doc": "The accessible name of bf-file-input's remove button for a file.",
+          "readonly": true,
+          "default": "(name) => `Remove ${name}`"
+        },
+        {
+          "name": "fileInputDismiss",
+          "kind": "property",
+          "type": "(name: string) => string",
+          "required": true,
+          "doc": "The accessible name of bf-file-input's button that dismisses a rejected file.",
+          "readonly": true,
+          "default": "(name) => `Dismiss ${name}`"
+        },
+        {
+          "name": "fileInputAdded",
+          "kind": "property",
+          "type": "(count: number) => string",
+          "required": true,
+          "doc": "bf-file-input's live announcement after files are added.",
+          "readonly": true,
+          "default": "(count) => (count === 1 ? '1 file added' : `${count} files added`)"
+        },
+        {
+          "name": "fileInputNotAdded",
+          "kind": "property",
+          "type": "(name: string, reason: string) => string",
+          "required": true,
+          "doc": "bf-file-input's live announcement for a rejected file.",
+          "readonly": true,
+          "default": "(name, reason) => `${name} was not added: ${reason}`"
+        },
+        {
+          "name": "fileInputRemoved",
+          "kind": "property",
+          "type": "(name: string) => string",
+          "required": true,
+          "doc": "bf-file-input's live announcement after a file is removed.",
+          "readonly": true,
+          "default": "(name) => `${name} removed`"
+        },
+        {
+          "name": "fileInputCount",
+          "kind": "property",
+          "type": "(count: number) => string",
+          "required": true,
+          "doc": "bf-file-input's read-only box text for the number of chosen files.",
+          "readonly": true,
+          "default": "(count) => (count === 1 ? '1 file' : `${count} files`)"
+        },
+        {
+          "name": "fileRejectedType",
+          "kind": "property",
+          "type": "string",
+          "required": true,
+          "doc": "The message of a file rejected for its type.",
+          "readonly": true,
+          "default": "'Not an accepted type'"
+        },
+        {
+          "name": "fileRejectedSize",
+          "kind": "property",
+          "type": "(max: string) => string",
+          "required": true,
+          "doc": "The message of a file rejected for its size; `max` is the formatted limit.",
+          "readonly": true,
+          "default": "(max) => `Too large, max ${max}`"
+        },
+        {
+          "name": "fileRejectedCount",
+          "kind": "property",
+          "type": "(max: number) => string",
+          "required": true,
+          "doc": "The message of a file rejected because the file limit is reached.",
+          "readonly": true,
+          "default": "(max) => `Too many files, max ${max}`"
+        },
+        {
+          "name": "imageInputChoose",
+          "kind": "property",
+          "type": "string",
+          "required": true,
+          "doc": "bf-image-input's accessible name for the empty drop target.",
+          "readonly": true,
+          "default": "'Choose image'"
+        },
+        {
+          "name": "imageInputUpload",
+          "kind": "property",
+          "type": "string",
+          "required": true,
+          "doc": "bf-image-input's text for choosing the first image.",
+          "readonly": true,
+          "default": "'Upload'"
+        },
+        {
+          "name": "imageInputReplace",
+          "kind": "property",
+          "type": "string",
+          "required": true,
+          "doc": "bf-image-input's text for replacing the image.",
+          "readonly": true,
+          "default": "'Replace'"
+        },
+        {
+          "name": "imageInputRemove",
+          "kind": "property",
+          "type": "string",
+          "required": true,
+          "doc": "bf-image-input's text for removing the image.",
+          "readonly": true,
+          "default": "'Remove'"
+        },
+        {
+          "name": "chatThread",
+          "kind": "property",
+          "type": "string",
+          "required": true,
+          "doc": "bf-chat-thread's accessible name (its `role=\"log\"`) when no `label` is set.",
+          "readonly": true,
+          "default": "'Conversation'"
+        },
+        {
+          "name": "chatJumpToLatest",
+          "kind": "property",
+          "type": "string",
+          "required": true,
+          "doc": "bf-chat-thread's button that scrolls back to the newest message and follows it again.",
+          "readonly": true,
+          "default": "'Jump to latest'"
+        },
+        {
+          "name": "chatMessageStopped",
+          "kind": "property",
+          "type": "string",
+          "required": true,
+          "doc": "bf-chat-message's status line for a reply the user stopped.",
+          "readonly": true,
+          "default": "'Stopped'"
+        },
+        {
+          "name": "chatMessageFailed",
+          "kind": "property",
+          "type": "string",
+          "required": true,
+          "doc": "bf-chat-message's status line for a message that failed.",
+          "readonly": true,
+          "default": "'Something went wrong'"
+        },
+        {
+          "name": "chatComposer",
+          "kind": "property",
+          "type": "string",
+          "required": true,
+          "doc": "bf-chat-composer's text field name when no `label` or `ariaLabel` is set.",
+          "readonly": true,
+          "default": "'Message'"
+        },
+        {
+          "name": "chatSend",
+          "kind": "property",
+          "type": "string",
+          "required": true,
+          "doc": "bf-chat-composer's send button.",
+          "readonly": true,
+          "default": "'Send'"
+        },
+        {
+          "name": "chatStop",
+          "kind": "property",
+          "type": "string",
+          "required": true,
+          "doc": "bf-chat-composer's stop button, shown in place of send while a reply runs.",
+          "readonly": true,
+          "default": "'Stop'"
+        },
+        {
+          "name": "mediaCardSelect",
+          "kind": "property",
+          "type": "string",
+          "required": true,
+          "doc": "bf-media-card's select button, read before the card's name (\"Select Starfall\").",
+          "readonly": true,
+          "default": "'Select'"
+        },
+        {
+          "name": "imageLoadFailed",
+          "kind": "property",
+          "type": "string",
+          "required": true,
+          "doc": "bf-media-card's and bf-image-viewer's message for an image that failed to load.",
+          "readonly": true,
+          "default": "'The image could not be loaded'"
+        },
+        {
+          "name": "imageViewer",
+          "kind": "property",
+          "type": "string",
+          "required": true,
+          "doc": "bf-image-viewer's name.",
+          "readonly": true,
+          "default": "'Image viewer'"
+        },
+        {
+          "name": "imageViewerPrevious",
+          "kind": "property",
+          "type": "string",
+          "required": true,
+          "doc": "bf-image-viewer's button that shows the previous image.",
+          "readonly": true,
+          "default": "'Previous image'"
+        },
+        {
+          "name": "imageViewerNext",
+          "kind": "property",
+          "type": "string",
+          "required": true,
+          "doc": "bf-image-viewer's button that shows the next image.",
+          "readonly": true,
+          "default": "'Next image'"
+        },
+        {
+          "name": "imageViewerPosition",
+          "kind": "property",
+          "type": "(position: number, count: number) => string",
+          "required": true,
+          "doc": "bf-image-viewer's counter: the shown image's position (1-based) among the images.",
+          "readonly": true,
+          "default": "(position, count) => `${position} of ${count}`"
+        },
         {
           "name": "validation",
           "kind": "property",
@@ -1574,6 +1970,39 @@
       "since": "0.3.0",
       "signature": "type BfLabelsOverrides = Partial<Omit<BfLabels, 'validation'>> & { readonly validation?: Partial<BfValidationMessages>; }"
     },
+    {
+      "name": "BfMediaCardAspect",
+      "slug": "bf-media-card-aspect",
+      "kind": "type",
+      "entryPoint": "@bitforgehq/ui",
+      "file": "src/components/media-card/media-card.component.ts",
+      "summary": "The four aspect ratios of a media card's image area, wide to portrait",
+      "description": "The aspect ratio of a `bf-media-card`'s image area: 16:9 (default), 4:3, square or 3:4.",
+      "members": [],
+      "methods": [],
+      "slots": [],
+      "references": [],
+      "usedBy": ["bf-media-card-component"],
+      "since": "0.5.0",
+      "signature": "type BfMediaCardAspect = '16/9' | '4/3' | '1/1' | '3/4'",
+      "values": ["16/9", "4/3", "1/1", "3/4"]
+    },
+    {
+      "name": "BfMotionListDirective",
+      "slug": "bf-motion-list-directive",
+      "kind": "directive",
+      "entryPoint": "@bitforgehq/ui",
+      "file": "src/components/motion-list/motion-list.directive.ts",
+      "summary": "Glides the items of a list or grid to their new place when it changes",
+      "description": "Glides the items of an app's list or grid to their new place when items are added, removed or\nreordered, instead of letting them jump (the FLIP technique). Put `bfMotionList` on the element\nwhose direct children are the items, usually the one around an `@for`. Each item remembers\nwhere it was; after the DOM changes, every item that moved slides from its old place to its new\none over 200 ms (`--bf-duration-layout`, on the settle curve). Pair it with Angular's\n`animate.enter=\"motion-safe:animate-item-enter\"` and\n`animate.leave=\"motion-safe:animate-item-leave\"` on the items, so new items fade and rise in and\nremoved ones fade out before the rest close the gap. Nothing moves under\n`prefers-reduced-motion: reduce`, and nothing glides when the container is resized. It moves\nitems within one container: an item moved to another list leaves one and enters the other.",
+      "members": [],
+      "methods": [],
+      "slots": [],
+      "references": [],
+      "usedBy": [],
+      "since": "0.5.0",
+      "selector": "[bfMotionList]"
+    },
     {
       "name": "BfPageHeaderHeadingLevel",
       "slug": "bf-page-header-heading-level",
@@ -1626,8 +2055,24 @@
       "values": ["primary", "success", "warning", "danger"]
     },
     {
-      "name": "BfRadioGroupOrientation",
-      "slug": "bf-radio-group-orientation",
+      "name": "BfProseDirective",
+      "slug": "bf-prose-directive",
+      "kind": "directive",
+      "entryPoint": "@bitforgehq/ui",
+      "file": "src/components/chat-thread/prose.directive.ts",
+      "summary": "Styles rendered markdown with the library tokens: headings, lists, code and quotes",
+      "description": "Styles rendered markdown inside its element: headings, paragraphs, lists, links, inline code,\ncode blocks, quotes and rules, through the semantic tokens only (so a theme override restyles\nit). The app renders the markdown to HTML itself (and sanitises it); `bfProse` only styles it.\nA `bf-chat-message` body is a `bfProse` element already.",
+      "members": [],
+      "methods": [],
+      "slots": [],
+      "references": [],
+      "usedBy": [],
+      "since": "0.5.0",
+      "selector": "[bfProse]"
+    },
+    {
+      "name": "BfRadioGroupOrientation",
+      "slug": "bf-radio-group-orientation",
       "kind": "type",
       "entryPoint": "@bitforgehq/ui",
       "file": "src/components/radio-group/radio-group.component.ts",
@@ -1689,6 +2134,64 @@
       "since": "0.1.0",
       "signature": "interface BfRadioOption<T = string>"
     },
+    {
+      "name": "BfRejectedFile",
+      "slug": "bf-rejected-file",
+      "kind": "interface",
+      "entryPoint": "@bitforgehq/ui",
+      "file": "src/components/_shared/file-rules.ts",
+      "summary": "A picked or dropped file that broke a rule, with the rule and its message",
+      "description": "A picked or dropped file that broke a rule, with the rule and its message.",
+      "members": [
+        {
+          "name": "file",
+          "kind": "property",
+          "type": "File",
+          "required": true,
+          "doc": "The file that was not added.",
+          "readonly": true
+        },
+        {
+          "name": "reason",
+          "kind": "property",
+          "type": "BfRejectedFileReason",
+          "required": true,
+          "doc": "The rule it broke: `type` (not accepted), `size` (over `maxSize`) or `count` (over the limit).",
+          "readonly": true,
+          "expandedType": "'type' | 'size' | 'count'"
+        },
+        {
+          "name": "message",
+          "kind": "property",
+          "type": "string",
+          "required": true,
+          "doc": "The user-facing text for the rule, from the labels.",
+          "readonly": true
+        }
+      ],
+      "methods": [],
+      "slots": [],
+      "references": ["bf-rejected-file-reason"],
+      "usedBy": ["bf-file-input-component", "bf-image-input-component"],
+      "since": "0.5.0"
+    },
+    {
+      "name": "BfRejectedFileReason",
+      "slug": "bf-rejected-file-reason",
+      "kind": "type",
+      "entryPoint": "@bitforgehq/ui",
+      "file": "src/components/_shared/file-rules.ts",
+      "summary": "The rule a refused file broke, its type, its size or the file count",
+      "description": "The rule a refused file broke: `type` (not accepted), `size` (over `maxSize`) or `count` (over\nthe limit).",
+      "members": [],
+      "methods": [],
+      "slots": [],
+      "references": [],
+      "usedBy": ["bf-rejected-file"],
+      "since": "0.5.0",
+      "signature": "type BfRejectedFileReason = 'type' | 'size' | 'count'",
+      "values": ["type", "size", "count"]
+    },
     {
       "name": "BfSegmentedSize",
       "slug": "bf-segmented-size",
@@ -1751,7 +2254,7 @@
       "slug": "bf-select-option",
       "kind": "interface",
       "entryPoint": "@bitforgehq/ui",
-      "file": "src/components/select/select.component.ts",
+      "file": "src/components/_shared/select-option.ts",
       "summary": "One choice of a select with its value, its label and a disabled flag",
       "description": "One choice of `bf-select`; `value` is any type (a string by default).",
       "members": [
@@ -1783,7 +2286,12 @@
       "references": [],
       "usedBy": ["bf-select-component"],
       "since": "0.1.0",
-      "signature": "interface BfSelectOption<T = string>"
+      "signature": "interface BfSelectOption<T = string>",
+      "alsoExportedFrom": [
+        {
+          "entryPoint": "@bitforgehq/ui/overlay"
+        }
+      ]
     },
     {
       "name": "BfSidebarStateService",
@@ -1825,6 +2333,7 @@
         "bf-button-component",
         "bf-button-size",
         "bf-calendar-component",
+        "bf-chat-composer-component",
         "bf-checkbox-component",
         "bf-chip-component",
         "bf-combobox-component",
@@ -1834,7 +2343,9 @@
         "bf-defaults-options",
         "bf-field-control-state",
         "bf-field-size",
+        "bf-file-input-component",
         "bf-icon-button-component",
+        "bf-image-input-component",
         "bf-input-component",
         "bf-menu-button-component",
         "bf-menu-component",
@@ -1961,6 +2472,23 @@
       "signature": "type BfStatVariant = 'plain' | 'card'",
       "values": ["plain", "card"]
     },
+    {
+      "name": "BfStepHeadingLevel",
+      "slug": "bf-step-heading-level",
+      "kind": "type",
+      "entryPoint": "@bitforgehq/ui",
+      "file": "src/components/steps/step.component.ts",
+      "summary": "The heading level a step title can take, two, three or four",
+      "description": "The heading level of a `bf-step` title, for a guide whose steps hold enough content (screenshots,\ncode) that a screen-reader user moves between them by heading.",
+      "members": [],
+      "methods": [],
+      "slots": [],
+      "references": [],
+      "usedBy": ["bf-step-component"],
+      "since": "0.4.0",
+      "signature": "type BfStepHeadingLevel = 2 | 3 | 4",
+      "values": ["2", "3", "4"]
+    },
     {
       "name": "BfTabBarController",
       "slug": "bf-tab-bar-controller",
@@ -2135,7 +2663,7 @@
       "methods": [],
       "slots": [],
       "references": [],
-      "usedBy": ["bf-table-column"],
+      "usedBy": ["bf-table-column-align"],
       "since": "0.3.1",
       "signature": "type BfTableAlign = 'start' | 'end'",
       "values": ["start", "end"]
@@ -2238,20 +2766,37 @@
         {
           "name": "align",
           "kind": "property",
-          "type": "BfTableAlign",
+          "type": "BfTableColumnAlign",
           "required": false,
-          "doc": "The inline alignment of the header and cells; `end` also sets tabular figures.",
+          "doc": "The inline alignment of the header and cells; `end` also sets tabular figures, `center` centres a cell's control (a toggle, a checkbox) in the column.",
           "optional": true,
           "default": "'start'",
-          "expandedType": "'start' | 'end'"
+          "expandedType": "'start' | 'end' | 'center'"
         }
       ],
       "methods": [],
       "slots": [],
-      "references": ["bf-table-align"],
+      "references": ["bf-table-column-align"],
       "usedBy": ["bf-table-component"],
       "since": "0.3.1"
     },
+    {
+      "name": "BfTableColumnAlign",
+      "slug": "bf-table-column-align",
+      "kind": "type",
+      "entryPoint": "@bitforgehq/ui",
+      "file": "src/components/table/table.component.ts",
+      "summary": "The inline alignment of a table column: start, end, or centred for controls",
+      "description": "Where a `bf-table` column lines up its header and cells: a `BfTableAlign`, or `center` for a\ncolumn of controls such as the toggles of a settings matrix. A new type, so `Record`s over the\nreleased `BfTableAlign` keep compiling.",
+      "members": [],
+      "methods": [],
+      "slots": [],
+      "references": ["bf-table-align"],
+      "usedBy": ["bf-table-column"],
+      "since": "0.4.0",
+      "signature": "type BfTableColumnAlign = BfTableAlign | 'center'",
+      "values": ["start", "end", "center"]
+    },
     {
       "name": "BfTableRowKey",
       "slug": "bf-table-row-key",
@@ -2377,6 +2922,23 @@
       "usedBy": ["bf-tab-bar-controller", "bf_tab_links"],
       "since": "0.3.0"
     },
+    {
+      "name": "BfTimelineTone",
+      "slug": "bf-timeline-tone",
+      "kind": "type",
+      "entryPoint": "@bitforgehq/ui",
+      "file": "src/components/timeline/timeline-event.component.ts",
+      "summary": "The marker colour of a timeline event, neutral, primary or a status",
+      "description": "The colour of a `bf-timeline-event`'s marker: `neutral` (the default), `primary`, or a status\n(`success`, `warning`, `danger`, `info`), such as danger for a failed CI run.",
+      "members": [],
+      "methods": [],
+      "slots": [],
+      "references": [],
+      "usedBy": ["bf-timeline-event-component"],
+      "since": "0.4.0",
+      "signature": "type BfTimelineTone = 'neutral' | 'primary' | 'success' | 'warning' | 'danger' | 'info'",
+      "values": ["neutral", "primary", "success", "warning", "danger", "info"]
+    },
     {
       "name": "BfToggleLabelPosition",
       "slug": "bf-toggle-label-position",
@@ -2608,7 +3170,7 @@
       "entryPoint": "@bitforgehq/ui",
       "file": "src/config/labels.ts",
       "summary": "Replaces built-in strings for an app or a sub-tree, such as a translation",
-      "description": "Replaces built-in strings, merged over the parent's (validation merged key by key); a key left\nout or set to `undefined` keeps the parent's string. In `ApplicationConfig.providers` it covers\nevery string. In a component's `providers` it covers that sub-tree's widgets and form controls\n(`loading`, `dismiss`, `tabBar`, `tabBadge`, `back`, `refreshing`, `tableSelectAll`, `tableSortBy`,\n`tableSortNone`, `tableSortAscending`, `tableSortDescending`, `theme`, `themeSystem`, `themeLight`, `themeDark`,\n`breadcrumb`, `breadcrumbExpand`, `navigation`, `navBadge`, `sidebarCollapse`, `sidebarExpand`,\n`skipToContent`, `pagination`, `previousPage`, `nextPage`, `pageOf`, `goToPage`, `tabGroup`,\n`calendarPreviousMonth`, `calendarNextMonth`, `calendarChooseMonth`, `calendarChooseYear`,\n`statTrendUp`, `statTrendDown`, `statTrendFlat`, `comboboxEmpty`, `comboboxRemove`,\n`dateInputDay`, `dateInputMonth`, `dateInputYear`, `dateInputOpenCalendar`, `dateInputInvalid`,\n`dateInputUnavailable`, `timeInputHour`, `timeInputMinute`, `timeInputSecond`,\n`timeInputDayPeriod`, `timeInputOpenList`, `timeInputInvalid`, `timeInputMin`, `timeInputMax`,\n`chart`, `chartLegend`, `chartValues`, `chartShowData`, `chartHideData`, `chartCategory`,\n`chartValue`, `chartEmpty`, `chartError`, `validation`); the overlay services (`ok`, `cancel`,\n`actions`, `sheet`, `modal`, `close`, `expand`, `collapse`, `sheetPosition`, `dialog`,\n`notifications`) are root singletons and pick it up only when the caller passes its injector:\n`open(…, { injector: inject(Injector) })`.",
+      "description": "Replaces built-in strings, merged over the parent's (validation merged key by key); a key left\nout or set to `undefined` keeps the parent's string. In `ApplicationConfig.providers` it covers\nevery string. In a component's `providers` it covers that sub-tree's widgets and form controls\n(`loading`, `dismiss`, `tabBar`, `tabBadge`, `back`, `refreshing`, `tableSelectAll`, `tableSortBy`,\n`tableSortNone`, `tableSortAscending`, `tableSortDescending`, `theme`, `themeSystem`, `themeLight`, `themeDark`,\n`breadcrumb`, `breadcrumbExpand`, `navigation`, `navBadge`, `sidebarCollapse`, `sidebarExpand`,\n`skipToContent`, `pagination`, `previousPage`, `nextPage`, `pageOf`, `goToPage`, `tabGroup`,\n`calendarPreviousMonth`, `calendarNextMonth`, `calendarChooseMonth`, `calendarChooseYear`,\n`statTrendUp`, `statTrendDown`, `statTrendFlat`, `comboboxEmpty`, `comboboxRemove`,\n`dateInputDay`, `dateInputMonth`, `dateInputYear`, `dateInputOpenCalendar`, `dateInputInvalid`,\n`dateInputUnavailable`, `timeInputHour`, `timeInputMinute`, `timeInputSecond`,\n`timeInputDayPeriod`, `timeInputOpenList`, `timeInputInvalid`, `timeInputMin`, `timeInputMax`,\n`chart`, `chartLegend`, `chartValues`, `chartShowData`, `chartHideData`, `chartCategory`,\n`chartValue`, `chartEmpty`, `chartError`, `listItemUnread`,\n`fileInputChoose`, `fileInputDropHint`, `fileInputDropzone`, `fileInputTapToChoose`, `fileInputRemove`,\n`fileInputDismiss`, `fileInputAdded`, `fileInputNotAdded`, `fileInputRemoved`, `fileInputCount`,\n`fileRejectedType`, `fileRejectedSize`, `fileRejectedCount`,\n`imageInputChoose`, `imageInputUpload`, `imageInputReplace`, `imageInputRemove`,\n`chatThread`, `chatJumpToLatest`, `chatMessageStopped`, `chatMessageFailed`, `chatComposer`,\n`chatSend`, `chatStop`, `mediaCardSelect`, `imageLoadFailed`, `validation`); the overlay\nservices (`ok`, `cancel`, `actions`, `sheet`, `modal`, `close`, `expand`, `collapse`,\n`sheetPosition`, `dialog`, `notifications`, `imageViewer`, `imageViewerPrevious`,\n`imageViewerNext`, `imageViewerPosition`) are root singletons and pick it up only when the caller passes its injector:\n`open(…, { injector: inject(Injector) })`.",
       "members": [],
       "methods": [
         {
@@ -2623,7 +3185,7 @@
             }
           ],
           "returns": "Provider",
-          "doc": "Replaces built-in strings, merged over the parent's (validation merged key by key); a key left\nout or set to `undefined` keeps the parent's string. In `ApplicationConfig.providers` it covers\nevery string. In a component's `providers` it covers that sub-tree's widgets and form controls\n(`loading`, `dismiss`, `tabBar`, `tabBadge`, `back`, `refreshing`, `tableSelectAll`, `tableSortBy`,\n`tableSortNone`, `tableSortAscending`, `tableSortDescending`, `theme`, `themeSystem`, `themeLight`, `themeDark`,\n`breadcrumb`, `breadcrumbExpand`, `navigation`, `navBadge`, `sidebarCollapse`, `sidebarExpand`,\n`skipToContent`, `pagination`, `previousPage`, `nextPage`, `pageOf`, `goToPage`, `tabGroup`,\n`calendarPreviousMonth`, `calendarNextMonth`, `calendarChooseMonth`, `calendarChooseYear`,\n`statTrendUp`, `statTrendDown`, `statTrendFlat`, `comboboxEmpty`, `comboboxRemove`,\n`dateInputDay`, `dateInputMonth`, `dateInputYear`, `dateInputOpenCalendar`, `dateInputInvalid`,\n`dateInputUnavailable`, `timeInputHour`, `timeInputMinute`, `timeInputSecond`,\n`timeInputDayPeriod`, `timeInputOpenList`, `timeInputInvalid`, `timeInputMin`, `timeInputMax`,\n`chart`, `chartLegend`, `chartValues`, `chartShowData`, `chartHideData`, `chartCategory`,\n`chartValue`, `chartEmpty`, `chartError`, `validation`); the overlay services (`ok`, `cancel`,\n`actions`, `sheet`, `modal`, `close`, `expand`, `collapse`, `sheetPosition`, `dialog`,\n`notifications`) are root singletons and pick it up only when the caller passes its injector:\n`open(…, { injector: inject(Injector) })`."
+          "doc": "Replaces built-in strings, merged over the parent's (validation merged key by key); a key left\nout or set to `undefined` keeps the parent's string. In `ApplicationConfig.providers` it covers\nevery string. In a component's `providers` it covers that sub-tree's widgets and form controls\n(`loading`, `dismiss`, `tabBar`, `tabBadge`, `back`, `refreshing`, `tableSelectAll`, `tableSortBy`,\n`tableSortNone`, `tableSortAscending`, `tableSortDescending`, `theme`, `themeSystem`, `themeLight`, `themeDark`,\n`breadcrumb`, `breadcrumbExpand`, `navigation`, `navBadge`, `sidebarCollapse`, `sidebarExpand`,\n`skipToContent`, `pagination`, `previousPage`, `nextPage`, `pageOf`, `goToPage`, `tabGroup`,\n`calendarPreviousMonth`, `calendarNextMonth`, `calendarChooseMonth`, `calendarChooseYear`,\n`statTrendUp`, `statTrendDown`, `statTrendFlat`, `comboboxEmpty`, `comboboxRemove`,\n`dateInputDay`, `dateInputMonth`, `dateInputYear`, `dateInputOpenCalendar`, `dateInputInvalid`,\n`dateInputUnavailable`, `timeInputHour`, `timeInputMinute`, `timeInputSecond`,\n`timeInputDayPeriod`, `timeInputOpenList`, `timeInputInvalid`, `timeInputMin`, `timeInputMax`,\n`chart`, `chartLegend`, `chartValues`, `chartShowData`, `chartHideData`, `chartCategory`,\n`chartValue`, `chartEmpty`, `chartError`, `listItemUnread`,\n`fileInputChoose`, `fileInputDropHint`, `fileInputDropzone`, `fileInputTapToChoose`, `fileInputRemove`,\n`fileInputDismiss`, `fileInputAdded`, `fileInputNotAdded`, `fileInputRemoved`, `fileInputCount`,\n`fileRejectedType`, `fileRejectedSize`, `fileRejectedCount`,\n`imageInputChoose`, `imageInputUpload`, `imageInputReplace`, `imageInputRemove`,\n`chatThread`, `chatJumpToLatest`, `chatMessageStopped`, `chatMessageFailed`, `chatComposer`,\n`chatSend`, `chatStop`, `mediaCardSelect`, `imageLoadFailed`, `validation`); the overlay\nservices (`ok`, `cancel`, `actions`, `sheet`, `modal`, `close`, `expand`, `collapse`,\n`sheetPosition`, `dialog`, `notifications`, `imageViewer`, `imageViewerPrevious`,\n`imageViewerNext`, `imageViewerPosition`) are root singletons and pick it up only when the caller passes its injector:\n`open(…, { injector: inject(Injector) })`."
         }
       ],
       "slots": [],
@@ -3481,139 +4043,434 @@
       "signature": "interface BfDialogTemplateContext<D = unknown, R = unknown>"
     },
     {
-      "name": "BfMenuButtonVariant",
-      "slug": "bf-menu-button-variant",
-      "kind": "type",
-      "entryPoint": "@bitforgehq/ui/overlay",
-      "file": "overlay/menu-button/menu-button.component.ts",
-      "summary": "The three visual styles of a menu button, matching the button styles",
-      "description": "The visual style of a `bf-menu-button`: outline, text or tonal, as `bf-button`'s.",
-      "members": [],
-      "methods": [],
-      "slots": [],
-      "references": [],
-      "usedBy": ["bf-menu-button-component", "bf-theme-menu-button-component"],
-      "since": "0.3.0",
-      "signature": "type BfMenuButtonVariant = 'outline' | 'text' | 'tonal'",
-      "values": ["outline", "text", "tonal"]
-    },
-    {
-      "name": "BfMenuDividerDirective",
-      "slug": "bf-menu-divider-directive",
-      "kind": "directive",
+      "name": "BfImageViewerActionsContext",
+      "slug": "bf-image-viewer-actions-context",
+      "kind": "interface",
       "entryPoint": "@bitforgehq/ui/overlay",
-      "file": "overlay/menu/menu-item.directive.ts",
-      "summary": "A line between groups of menu items that keyboard focus never lands on",
-      "description": "A line between groups of menu items (role `separator`, not focusable).",
-      "members": [],
+      "file": "overlay/image-viewer/image-viewer-ref.ts",
+      "summary": "What the viewer's actions template receives: the shown image, its index and the ref",
+      "description": "Context of the `actions` template of `BfImageViewerService.open()`: `let-image`,\n`let-index=\"index\"` and `let-ref=\"ref\"`.",
+      "members": [
+        {
+          "name": "$implicit",
+          "kind": "property",
+          "type": "BfImageViewerImage",
+          "required": true,
+          "doc": "The image the viewer shows (`let-image`)."
+        },
+        {
+          "name": "index",
+          "kind": "property",
+          "type": "number",
+          "required": true,
+          "doc": "Its 0-based index in the set (`let-index=\"index\"`)."
+        },
+        {
+          "name": "ref",
+          "kind": "property",
+          "type": "BfImageViewerRef",
+          "required": true,
+          "doc": "The viewer's ref (`let-ref=\"ref\"`), to close it or step."
+        }
+      ],
       "methods": [],
       "slots": [],
-      "references": [],
-      "usedBy": [],
-      "since": "0.3.0",
-      "selector": "[bfMenuDivider]"
+      "references": ["bf-image-viewer-image", "bf-image-viewer-ref"],
+      "usedBy": ["bf-image-viewer-options"],
+      "since": "0.5.0"
     },
     {
-      "name": "BfMenuGroupDirective",
-      "slug": "bf-menu-group-directive",
-      "kind": "directive",
+      "name": "BfImageViewerImage",
+      "slug": "bf-image-viewer-image",
+      "kind": "interface",
       "entryPoint": "@bitforgehq/ui/overlay",
-      "file": "overlay/menu/menu-item.directive.ts",
-      "summary": "Groups related menu items; radio items in one group exclude each other",
-      "description": "A group of menu items (role `group`); radio items in one group are exclusive. Name it with\n`aria-label` when its items share a topic (\"Density\").",
-      "members": [],
+      "file": "overlay/image-viewer/image-viewer-ref.ts",
+      "summary": "One image the viewer shows: its URL, its name as alternative text and a caption",
+      "description": "One image of a `BfImageViewerService.open()` set.",
+      "members": [
+        {
+          "name": "src",
+          "kind": "property",
+          "type": "string",
+          "required": true,
+          "doc": "URL of the full-size image."
+        },
+        {
+          "name": "label",
+          "kind": "property",
+          "type": "string",
+          "required": true,
+          "doc": "The image's name: its alternative text (`alt`), read when it shows and announced after a step (required: the viewer shows nothing else that names it)."
+        },
+        {
+          "name": "caption",
+          "kind": "property",
+          "type": "string",
+          "required": false,
+          "doc": "Text shown under the image; none shows no caption.",
+          "optional": true
+        }
+      ],
       "methods": [],
       "slots": [],
       "references": [],
-      "usedBy": [],
-      "since": "0.3.0",
-      "selector": "[bfMenuGroup]"
+      "usedBy": [
+        "bf-image-viewer-actions-context",
+        "bf-image-viewer-options",
+        "bf-image-viewer-ref"
+      ],
+      "since": "0.5.0"
     },
     {
-      "name": "BfMenuItemCheckboxDirective",
-      "slug": "bf-menu-item-checkbox-directive",
-      "kind": "directive",
+      "name": "BfImageViewerOptions",
+      "slug": "bf-image-viewer-options",
+      "kind": "interface",
       "entryPoint": "@bitforgehq/ui/overlay",
-      "file": "overlay/menu/menu-item.directive.ts",
-      "summary": "A menu row that toggles an option on and off with a check mark",
-      "description": "A toggle row of a `bf-menu` (role `menuitemcheckbox`) with a check mark while `checked`.\nActivating it (click, `Enter`, `Space`) flips its own `checked` (`aria-checked`), emits\n`triggered`, then `changed` (and `checkedChange`) with the new state, and closes the menu. Bind\nit two-way, `[(checked)]`, so your state always follows the item.",
+      "file": "overlay/image-viewer/image-viewer.service.ts",
+      "summary": "Options of an image viewer: its images, the first one, its thumbnail and actions",
+      "description": "Options of `BfImageViewerService.open()`.",
       "members": [
         {
-          "name": "checked",
-          "kind": "model",
-          "type": "boolean",
+          "name": "images",
+          "kind": "property",
+          "type": "readonly BfImageViewerImage[]",
+          "required": true,
+          "doc": "The images to step through, in order; at least one."
+        },
+        {
+          "name": "index",
+          "kind": "property",
+          "type": "number",
           "required": false,
-          "doc": "Whether the item is checked. The item flips it itself on activation (and emits `checkedChange`), so bind it two-way: `[(checked)]`.",
-          "default": "false",
-          "twoWay": true
+          "doc": "Index of the image shown first, wrapped into the set.",
+          "optional": true,
+          "default": "0"
         },
         {
-          "name": "changed",
-          "kind": "output",
-          "type": "boolean",
+          "name": "origin",
+          "kind": "property",
+          "type": "BfImageViewerOrigin",
           "required": false,
-          "doc": "Emitted with the new state right after the user toggles the item."
+          "doc": "The thumbnail the viewer zooms out of and back into (or a function returning the thumbnail of an image by index); none fades the viewer in and out.",
+          "optional": true,
+          "expandedType": "HTMLElement | (index: number) => HTMLElement | null | undefined"
         },
         {
-          "name": "bfMenuItemDisabled",
-          "kind": "input",
-          "type": "boolean",
+          "name": "actions",
+          "kind": "property",
+          "type": "TemplateRef<BfImageViewerActionsContext>",
           "required": false,
-          "doc": "Whether the item is disabled: it stays focusable and announced, but does not activate."
+          "doc": "Actions under the image, beside its caption (a download link, a \"Use this one\" button); its context is `{ $implicit: image, index, ref }`.",
+          "optional": true
         },
         {
-          "name": "bfMenuItemTypeahead",
-          "kind": "input",
-          "type": "string | null",
+          "name": "ariaLabel",
+          "kind": "property",
+          "type": "string",
           "required": false,
-          "doc": "The text typeahead matches the item by (default: its text content)."
+          "doc": "Accessible name of the viewer; empty uses `provideBfLabels()`'s `imageViewer`.",
+          "optional": true
         },
         {
-          "name": "triggered",
-          "kind": "output",
-          "type": "void",
+          "name": "closeOnNavigation",
+          "kind": "property",
+          "type": "boolean",
           "required": false,
-          "doc": "Emits when the item is activated (click, `Enter` or `Space`), before `checked` flips."
+          "doc": "A navigation to another URL path closes the viewer (default true).",
+          "optional": true,
+          "default": "true"
+        },
+        {
+          "name": "injector",
+          "kind": "property",
+          "type": "Injector",
+          "required": false,
+          "doc": "Parent of the viewer's injector and source of its labels (default the root injector). Pass the opener's `inject(Injector)` so a feature-level `provideBfLabels()` reaches the viewer.",
+          "optional": true
         }
       ],
       "methods": [],
       "slots": [],
+      "references": [
+        "bf-image-viewer-actions-context",
+        "bf-image-viewer-image",
+        "bf-image-viewer-origin"
+      ],
+      "usedBy": ["bf-image-viewer-service"],
+      "since": "0.5.0"
+    },
+    {
+      "name": "BfImageViewerOrigin",
+      "slug": "bf-image-viewer-origin",
+      "kind": "type",
+      "entryPoint": "@bitforgehq/ui/overlay",
+      "file": "overlay/image-viewer/image-viewer-ref.ts",
+      "summary": "The thumbnail an image viewer zooms from and back into, or a lookup per image",
+      "description": "Where the viewer zooms from and back to: the thumbnail that was clicked, or a function that\nreturns the thumbnail of any image of the set (so closing after stepping zooms into the right\none), `null` for none.",
+      "members": [],
+      "methods": [],
+      "slots": [],
       "references": [],
-      "usedBy": [],
-      "since": "0.3.0",
-      "selector": "button[bfMenuItemCheckbox]"
+      "usedBy": ["bf-image-viewer-options"],
+      "since": "0.5.0",
+      "signature": "type BfImageViewerOrigin = HTMLElement | ((index: number) => HTMLElement | null | undefined) | null"
     },
     {
-      "name": "BfMenuItemDirective",
-      "slug": "bf-menu-item-directive",
-      "kind": "directive",
+      "name": "BfImageViewerRef",
+      "slug": "bf-image-viewer-ref",
+      "kind": "class",
       "entryPoint": "@bitforgehq/ui/overlay",
-      "file": "overlay/menu/menu-item.directive.ts",
-      "summary": "An action row of a menu on a native button or link, with keyboard rules",
-      "description": "An action row of a `bf-menu` (role `menuitem`), on a native `<button>` or a link (`<a>` with\n`href` or `routerLink`). Activating it (click, `Enter`, `Space`) emits `triggered`, closes every\nopen menu and returns focus to the trigger. With `[bfMenuTriggerFor]` on the same element it\nopens a submenu instead (and shows a chevron). A disabled item stays focusable and announces\nitself as disabled, but does not activate; a disabled link does not navigate either, also with\n`routerLink`.",
+      "file": "overlay/image-viewer/image-viewer-ref.ts",
+      "summary": "Handle on an open image viewer that steps through its images and closes it",
+      "description": "Handle to an open image viewer, returned by `BfImageViewerService.open()` and injectable in\nits actions template (`inject(BfImageViewerRef)`). `index` is the shown image; `next()`,\n`previous()` and `goTo()` step through the set (wrapping at both ends), `close()` plays the\nexit motion and resolves `afterClosed`.",
       "members": [
         {
-          "name": "bfMenuItemDisabled",
-          "kind": "input",
-          "type": "boolean",
+          "name": "id",
+          "kind": "property",
+          "type": "string",
           "required": false,
-          "doc": "Whether the item is disabled: it stays focusable and announced, but does not activate."
+          "doc": "Unique id of the viewer (its overlay's `bf-overlay-N`).",
+          "readonly": true
         },
         {
-          "name": "bfMenuItemTypeahead",
-          "kind": "input",
-          "type": "string | null",
+          "name": "images",
+          "kind": "property",
+          "type": "readonly BfImageViewerImage[]",
           "required": false,
-          "doc": "The text typeahead matches the item by (default: its text content)."
+          "doc": "The images of the set, in order.",
+          "readonly": true
         },
         {
-          "name": "triggered",
-          "kind": "output",
-          "type": "void",
+          "name": "afterClosed",
+          "kind": "property",
+          "type": "Promise<void>",
           "required": false,
-          "doc": "Emits when the item is activated (click, `Enter` or `Space`), unless it opens a submenu."
-        }
-      ],
+          "doc": "Resolves once the viewer has closed and left the page.",
+          "readonly": true
+        },
+        {
+          "name": "closed",
+          "kind": "property",
+          "type": "Signal<boolean>",
+          "required": false,
+          "doc": "True once the viewer has been detached.",
+          "readonly": true
+        },
+        {
+          "name": "index",
+          "kind": "property",
+          "type": "Signal<number>",
+          "required": false,
+          "doc": "Index (0-based) of the image the viewer shows.",
+          "readonly": true
+        }
+      ],
+      "methods": [
+        {
+          "name": "next",
+          "signature": "next(): void",
+          "params": [],
+          "returns": "void",
+          "doc": "Shows the next image; after the last one, the first."
+        },
+        {
+          "name": "previous",
+          "signature": "previous(): void",
+          "params": [],
+          "returns": "void",
+          "doc": "Shows the previous image; before the first one, the last."
+        },
+        {
+          "name": "goTo",
+          "signature": "goTo(index: number): void",
+          "params": [
+            {
+              "name": "index",
+              "type": "number",
+              "optional": false,
+              "doc": "The 0-based index of the image to show."
+            }
+          ],
+          "returns": "void",
+          "doc": "Shows the image at `index`, wrapped into the set (`-1` is the last one)."
+        },
+        {
+          "name": "close",
+          "signature": "close(): void",
+          "params": [],
+          "returns": "void",
+          "doc": "Closes the viewer: it zooms back into its thumbnail, or fades out. Ignored once closing."
+        }
+      ],
+      "slots": [],
+      "references": ["bf-image-viewer-image"],
+      "usedBy": ["bf-image-viewer-actions-context", "bf-image-viewer-service"],
+      "since": "0.5.0"
+    },
+    {
+      "name": "BfImageViewerService",
+      "slug": "bf-image-viewer-service",
+      "kind": "service",
+      "entryPoint": "@bitforgehq/ui/overlay",
+      "file": "overlay/image-viewer/image-viewer.service.ts",
+      "summary": "Opens a full-screen image viewer that zooms from a thumbnail and steps through a set",
+      "description": "Opens a full-screen image viewer (a lightbox) on the overlay core: one image large over a dark\nscrim, previous and next buttons, the arrow keys, Home and End to step through the set\n(wrapping at both ends), a counter, the caption and optional actions. It zooms out of the\nclicked thumbnail (`origin`) and back into it, cross-fades between images, and fades when there\nis no thumbnail on screen; reduced motion only fades. It is a modal dialog: focus moves to its\nclose button and is trapped, `Escape`, the close button and a click on the scrim close it, the\npage behind it is `inert` and does not scroll, and focus returns to the opener.",
+      "members": [],
+      "methods": [
+        {
+          "name": "open",
+          "signature": "open(options: BfImageViewerOptions): BfImageViewerRef",
+          "params": [
+            {
+              "name": "options",
+              "type": "BfImageViewerOptions",
+              "optional": false,
+              "doc": "The images, the first index, the thumbnail, the actions and the injector."
+            }
+          ],
+          "returns": "BfImageViewerRef",
+          "doc": "Opens the viewer on `options.images`, showing `options.index` first."
+        }
+      ],
+      "slots": [],
+      "references": ["bf-image-viewer-options", "bf-image-viewer-ref"],
+      "usedBy": [],
+      "since": "0.5.0"
+    },
+    {
+      "name": "BfMenuButtonVariant",
+      "slug": "bf-menu-button-variant",
+      "kind": "type",
+      "entryPoint": "@bitforgehq/ui/overlay",
+      "file": "overlay/menu-button/menu-button.component.ts",
+      "summary": "The three visual styles of a menu button, matching the button styles",
+      "description": "The visual style of a `bf-menu-button`: outline, text or tonal, as `bf-button`'s.",
+      "members": [],
+      "methods": [],
+      "slots": [],
+      "references": [],
+      "usedBy": ["bf-menu-button-component", "bf-theme-menu-button-component"],
+      "since": "0.3.0",
+      "signature": "type BfMenuButtonVariant = 'outline' | 'text' | 'tonal'",
+      "values": ["outline", "text", "tonal"]
+    },
+    {
+      "name": "BfMenuDividerDirective",
+      "slug": "bf-menu-divider-directive",
+      "kind": "directive",
+      "entryPoint": "@bitforgehq/ui/overlay",
+      "file": "overlay/menu/menu-item.directive.ts",
+      "summary": "A line between groups of menu items that keyboard focus never lands on",
+      "description": "A line between groups of menu items (role `separator`, not focusable).",
+      "members": [],
+      "methods": [],
+      "slots": [],
+      "references": [],
+      "usedBy": [],
+      "since": "0.3.0",
+      "selector": "[bfMenuDivider]"
+    },
+    {
+      "name": "BfMenuGroupDirective",
+      "slug": "bf-menu-group-directive",
+      "kind": "directive",
+      "entryPoint": "@bitforgehq/ui/overlay",
+      "file": "overlay/menu/menu-item.directive.ts",
+      "summary": "Groups related menu items; radio items in one group exclude each other",
+      "description": "A group of menu items (role `group`); radio items in one group are exclusive. Name it with\n`aria-label` when its items share a topic (\"Density\").",
+      "members": [],
+      "methods": [],
+      "slots": [],
+      "references": [],
+      "usedBy": [],
+      "since": "0.3.0",
+      "selector": "[bfMenuGroup]"
+    },
+    {
+      "name": "BfMenuItemCheckboxDirective",
+      "slug": "bf-menu-item-checkbox-directive",
+      "kind": "directive",
+      "entryPoint": "@bitforgehq/ui/overlay",
+      "file": "overlay/menu/menu-item.directive.ts",
+      "summary": "A menu row that toggles an option on and off with a check mark",
+      "description": "A toggle row of a `bf-menu` (role `menuitemcheckbox`) with a check mark while `checked`.\nActivating it (click, `Enter`, `Space`) flips its own `checked` (`aria-checked`), emits\n`triggered`, then `changed` (and `checkedChange`) with the new state, and closes the menu. Bind\nit two-way, `[(checked)]`, so your state always follows the item.",
+      "members": [
+        {
+          "name": "checked",
+          "kind": "model",
+          "type": "boolean",
+          "required": false,
+          "doc": "Whether the item is checked. The item flips it itself on activation (and emits `checkedChange`), so bind it two-way: `[(checked)]`.",
+          "default": "false",
+          "twoWay": true
+        },
+        {
+          "name": "changed",
+          "kind": "output",
+          "type": "boolean",
+          "required": false,
+          "doc": "Emitted with the new state right after the user toggles the item."
+        },
+        {
+          "name": "bfMenuItemDisabled",
+          "kind": "input",
+          "type": "boolean",
+          "required": false,
+          "doc": "Whether the item is disabled: it stays focusable and announced, but does not activate."
+        },
+        {
+          "name": "bfMenuItemTypeahead",
+          "kind": "input",
+          "type": "string | null",
+          "required": false,
+          "doc": "The text typeahead matches the item by (default: its text content)."
+        },
+        {
+          "name": "triggered",
+          "kind": "output",
+          "type": "void",
+          "required": false,
+          "doc": "Emits when the item is activated (click, `Enter` or `Space`), before `checked` flips."
+        }
+      ],
+      "methods": [],
+      "slots": [],
+      "references": [],
+      "usedBy": [],
+      "since": "0.3.0",
+      "selector": "button[bfMenuItemCheckbox]"
+    },
+    {
+      "name": "BfMenuItemDirective",
+      "slug": "bf-menu-item-directive",
+      "kind": "directive",
+      "entryPoint": "@bitforgehq/ui/overlay",
+      "file": "overlay/menu/menu-item.directive.ts",
+      "summary": "An action row of a menu on a native button or link, with keyboard rules",
+      "description": "An action row of a `bf-menu` (role `menuitem`), on a native `<button>` or a link (`<a>` with\n`href` or `routerLink`). Activating it (click, `Enter`, `Space`) emits `triggered`, closes every\nopen menu and returns focus to the trigger. With `[bfMenuTriggerFor]` on the same element it\nopens a submenu instead (and shows a chevron). A disabled item stays focusable and announces\nitself as disabled, but does not activate; a disabled link does not navigate either, also with\n`routerLink`.",
+      "members": [
+        {
+          "name": "bfMenuItemDisabled",
+          "kind": "input",
+          "type": "boolean",
+          "required": false,
+          "doc": "Whether the item is disabled: it stays focusable and announced, but does not activate."
+        },
+        {
+          "name": "bfMenuItemTypeahead",
+          "kind": "input",
+          "type": "string | null",
+          "required": false,
+          "doc": "The text typeahead matches the item by (default: its text content)."
+        },
+        {
+          "name": "triggered",
+          "kind": "output",
+          "type": "void",
+          "required": false,
+          "doc": "Emits when the item is activated (click, `Enter` or `Space`), unless it opens a submenu."
+        }
+      ],
       "methods": [],
       "slots": [],
       "references": [],
@@ -5359,6 +6216,30 @@
       "since": "0.3.0",
       "signature": "function provideBfDesktopToast(config?: Partial<BfDesktopToastConfig>): EnvironmentProviders"
     },
+    {
+      "name": "provideBfSelect",
+      "slug": "provide-bf-select",
+      "kind": "function",
+      "entryPoint": "@bitforgehq/ui/overlay",
+      "file": "overlay/select/provide-bf-select.ts",
+      "summary": "Makes a stacked table's Sort by select the styled bf-select, app-wide",
+      "description": "Makes the library's built-in selects use the styled `bf-select`: a stacked `bf-table` then\nrenders its Sort by select as a `bf-select` (the native `<select>` under a coarse pointer, as\n`bf-select` itself does) instead of the plain native one. Add it to\n`ApplicationConfig.providers`.",
+      "members": [],
+      "methods": [
+        {
+          "name": "provideBfSelect",
+          "signature": "provideBfSelect(): EnvironmentProviders",
+          "params": [],
+          "returns": "EnvironmentProviders",
+          "doc": "Makes the library's built-in selects use the styled `bf-select`: a stacked `bf-table` then\nrenders its Sort by select as a `bf-select` (the native `<select>` under a coarse pointer, as\n`bf-select` itself does) instead of the plain native one. Add it to\n`ApplicationConfig.providers`."
+        }
+      ],
+      "slots": [],
+      "references": [],
+      "usedBy": [],
+      "since": "0.5.0",
+      "signature": "function provideBfSelect(): EnvironmentProviders"
+    },
     {
       "name": "scaleIn",
       "slug": "scale-in",
@@ -8614,13 +9495,13 @@
       "signature": "class BfChartHarness extends ComponentHarness"
     },
     {
-      "name": "BfComboboxHarness",
-      "slug": "bf-combobox-harness",
+      "name": "BfChatComposerHarness",
+      "slug": "bf-chat-composer-harness",
       "kind": "class",
       "entryPoint": "@bitforgehq/ui/testing",
-      "file": "testing/harnesses/combobox.harness.ts",
-      "summary": "Test harness for the comboboxes: types, reads and picks options and tags",
-      "description": "Harness for `bf-combobox` and `bf-multi-combobox`. Its option list renders in the CDK overlay\ncontainer while open (found through the input's `aria-controls`); it works by option label, so a\ntest never needs the option values. Its `label` filter matches the visible label, else the\n`aria-label`.",
+      "file": "testing/harnesses/chat-composer.harness.ts",
+      "summary": "Test harness for the chat composer: types, sends, stops and reads its state",
+      "description": "Harness for `bf-chat-composer` (`@bitforgehq/ui/overlay`). Its `label` filter matches the text\nfield's name: the visible label, else its `aria-label` (\"Message\" by default).",
       "members": [],
       "methods": [
         {
@@ -8628,53 +9509,147 @@
           "signature": "getLabel(): Promise<string>",
           "params": [],
           "returns": "Promise<string>",
-          "doc": "The visible label without the required mark, else the `aria-label`."
-        },
-        {
-          "name": "open",
-          "signature": "open(): Promise<void>",
-          "params": [],
-          "returns": "Promise<void>",
-          "doc": "Opens the option list with a click into the field; does nothing while it is open."
-        },
-        {
-          "name": "close",
-          "signature": "close(): Promise<void>",
-          "params": [],
-          "returns": "Promise<void>",
-          "doc": "Closes the option list with `Escape`, as a user would; does nothing while it is closed."
+          "doc": "The text field's name: the visible label, else its `aria-label`."
         },
         {
-          "name": "isOpen",
-          "signature": "isOpen(): Promise<boolean>",
+          "name": "getValue",
+          "signature": "getValue(): Promise<string>",
           "params": [],
-          "returns": "Promise<boolean>",
-          "doc": "Whether the option list is open (`aria-expanded`)."
+          "returns": "Promise<string>",
+          "doc": "The text in the field."
         },
         {
-          "name": "type",
-          "signature": "type(query: string): Promise<void>",
+          "name": "setValue",
+          "signature": "setValue(text: string): Promise<void>",
           "params": [
             {
-              "name": "query",
+              "name": "text",
               "type": "string",
               "optional": false,
-              "doc": "The text to type."
+              "doc": "The new text."
             }
           ],
           "returns": "Promise<void>",
-          "doc": "Replaces the field's text with `query`, key by key as a user types; the list opens filtered."
+          "doc": "Replaces the text as the user would type it (`changed` and the value update)."
         },
         {
-          "name": "getOptionLabels",
-          "signature": "getOptionLabels(): Promise<string[]>",
+          "name": "send",
+          "signature": "send(): Promise<void>",
           "params": [],
-          "returns": "Promise<string[]>",
-          "doc": "The labels of the listed options, in order, opening the list first when it is closed."
+          "returns": "Promise<void>",
+          "doc": "Sends the text with the send button, as a click does. Does nothing while it cannot send."
         },
         {
-          "name": "selectOption",
-          "signature": "selectOption(label: string): Promise<void>",
+          "name": "pressEnter",
+          "signature": "pressEnter(): Promise<void>",
+          "params": [],
+          "returns": "Promise<void>",
+          "doc": "Sends the text with `Enter` in the field, as the keyboard does."
+        },
+        {
+          "name": "stop",
+          "signature": "stop(): Promise<void>",
+          "params": [],
+          "returns": "Promise<void>",
+          "doc": "Stops the running reply with the stop button. Does nothing unless a reply is running."
+        },
+        {
+          "name": "isRunning",
+          "signature": "isRunning(): Promise<boolean>",
+          "params": [],
+          "returns": "Promise<boolean>",
+          "doc": "Whether a reply is running, so the button stops instead of sending."
+        },
+        {
+          "name": "isDisabled",
+          "signature": "isDisabled(): Promise<boolean>",
+          "params": [],
+          "returns": "Promise<boolean>",
+          "doc": "Whether the composer is disabled (its text field is)."
+        },
+        {
+          "name": "canAct",
+          "signature": "canAct(): Promise<boolean>",
+          "params": [],
+          "returns": "Promise<boolean>",
+          "doc": "Whether the button can send (or stop) now: not disabled and, to send, with text."
+        },
+        {
+          "name": "getButtonLabel",
+          "signature": "getButtonLabel(): Promise<string>",
+          "params": [],
+          "returns": "Promise<string>",
+          "doc": "The button's name, \"Send\" or \"Stop\" by default."
+        }
+      ],
+      "slots": [],
+      "references": [],
+      "usedBy": [],
+      "since": "0.5.0",
+      "signature": "class BfChatComposerHarness extends ComponentHarness"
+    },
+    {
+      "name": "BfComboboxHarness",
+      "slug": "bf-combobox-harness",
+      "kind": "class",
+      "entryPoint": "@bitforgehq/ui/testing",
+      "file": "testing/harnesses/combobox.harness.ts",
+      "summary": "Test harness for the comboboxes: types, reads and picks options and tags",
+      "description": "Harness for `bf-combobox` and `bf-multi-combobox`. Its option list renders in the CDK overlay\ncontainer while open (found through the input's `aria-controls`); it works by option label, so a\ntest never needs the option values. Its `label` filter matches the visible label, else the\n`aria-label`.",
+      "members": [],
+      "methods": [
+        {
+          "name": "getLabel",
+          "signature": "getLabel(): Promise<string>",
+          "params": [],
+          "returns": "Promise<string>",
+          "doc": "The visible label without the required mark, else the `aria-label`."
+        },
+        {
+          "name": "open",
+          "signature": "open(): Promise<void>",
+          "params": [],
+          "returns": "Promise<void>",
+          "doc": "Opens the option list with a click into the field; does nothing while it is open."
+        },
+        {
+          "name": "close",
+          "signature": "close(): Promise<void>",
+          "params": [],
+          "returns": "Promise<void>",
+          "doc": "Closes the option list with `Escape`, as a user would; does nothing while it is closed."
+        },
+        {
+          "name": "isOpen",
+          "signature": "isOpen(): Promise<boolean>",
+          "params": [],
+          "returns": "Promise<boolean>",
+          "doc": "Whether the option list is open (`aria-expanded`)."
+        },
+        {
+          "name": "type",
+          "signature": "type(query: string): Promise<void>",
+          "params": [
+            {
+              "name": "query",
+              "type": "string",
+              "optional": false,
+              "doc": "The text to type."
+            }
+          ],
+          "returns": "Promise<void>",
+          "doc": "Replaces the field's text with `query`, key by key as a user types; the list opens filtered."
+        },
+        {
+          "name": "getOptionLabels",
+          "signature": "getOptionLabels(): Promise<string[]>",
+          "params": [],
+          "returns": "Promise<string[]>",
+          "doc": "The labels of the listed options, in order, opening the list first when it is closed."
+        },
+        {
+          "name": "selectOption",
+          "signature": "selectOption(label: string): Promise<void>",
           "params": [
             {
               "name": "label",
@@ -9048,6 +10023,100 @@
       "since": "0.3.0",
       "signature": "class BfDialogHarness extends ComponentHarness"
     },
+    {
+      "name": "BfFileInputHarness",
+      "slug": "bf-file-input-harness",
+      "kind": "class",
+      "entryPoint": "@bitforgehq/ui/testing",
+      "file": "testing/harnesses/file-input.harness.ts",
+      "summary": "Test harness for the file input: drops files and reads the list and rejections",
+      "description": "Harness for `bf-file-input`, in both looks. `addFiles()` drops files on the field, so they go\nthrough the same `accept`, `maxSize` and `maxFiles` rules as a real drop; read the outcome with\n`getFileNames()` and `getRejected()`. It works by file name, so a test never needs the rows.",
+      "members": [],
+      "methods": [
+        {
+          "name": "getLabel",
+          "signature": "getLabel(): Promise<string>",
+          "params": [],
+          "returns": "Promise<string>",
+          "doc": "The visible label without the required mark, else `ariaLabel`."
+        },
+        {
+          "name": "getErrorText",
+          "signature": "getErrorText(): Promise<string>",
+          "params": [],
+          "returns": "Promise<string>",
+          "doc": "The error text under the field (an explicit message, or the first form error once touched)."
+        },
+        {
+          "name": "getVariant",
+          "signature": "getVariant(): Promise<'field' | 'dropzone'>",
+          "params": [],
+          "returns": "Promise<'field' | 'dropzone'>",
+          "doc": "The look of the field."
+        },
+        {
+          "name": "isDisabled",
+          "signature": "isDisabled(): Promise<boolean>",
+          "params": [],
+          "returns": "Promise<boolean>",
+          "doc": "Whether the field is disabled."
+        },
+        {
+          "name": "isReadonly",
+          "signature": "isReadonly(): Promise<boolean>",
+          "params": [],
+          "returns": "Promise<boolean>",
+          "doc": "Whether the field is read-only: it has no pick target."
+        },
+        {
+          "name": "addFiles",
+          "signature": "addFiles(files: File[]): Promise<void>",
+          "params": [
+            {
+              "name": "files",
+              "type": "File[]",
+              "optional": false,
+              "doc": "The files to drop."
+            }
+          ],
+          "returns": "Promise<void>",
+          "doc": "Drops files on the field, as a user would. On a disabled or read-only field it does nothing,\nlike the UI."
+        },
+        {
+          "name": "getFileNames",
+          "signature": "getFileNames(): Promise<string[]>",
+          "params": [],
+          "returns": "Promise<string[]>",
+          "doc": "The names of the chosen files, in order (rejected files are not included)."
+        },
+        {
+          "name": "getRejected",
+          "signature": "getRejected(): Promise<{ name: string; message: string }[]>",
+          "params": [],
+          "returns": "Promise<{ name: string; message: string }[]>",
+          "doc": "The files the last pick or drop refused, each with its reason, until they are dismissed."
+        },
+        {
+          "name": "removeFile",
+          "signature": "removeFile(name: string): Promise<void>",
+          "params": [
+            {
+              "name": "name",
+              "type": "string",
+              "optional": false,
+              "doc": "The file's name."
+            }
+          ],
+          "returns": "Promise<void>",
+          "doc": "Removes the chosen file with this name, as the row's remove button does. Throws when no\nchosen file has that name or the field cannot be edited."
+        }
+      ],
+      "slots": [],
+      "references": [],
+      "usedBy": [],
+      "since": "0.5.0",
+      "signature": "class BfFileInputHarness extends ComponentHarness"
+    },
     {
       "name": "BfHarnessFilters",
       "slug": "bf-harness-filters",
@@ -9073,6 +10142,222 @@
       "since": "0.3.0",
       "signature": "interface BfHarnessFilters extends BaseHarnessFilters"
     },
+    {
+      "name": "BfImageInputHarness",
+      "slug": "bf-image-input-harness",
+      "kind": "class",
+      "entryPoint": "@bitforgehq/ui/testing",
+      "file": "testing/harnesses/image-input.harness.ts",
+      "summary": "Test harness for the image input: drops an image on it and reads the preview",
+      "description": "Harness for `bf-image-input`. `addFile()` drops the image on the tile, so it goes through the\nsame `accept` and `maxSize` rules as a real drop; read the outcome with `hasPreview()`,\n`getPreviewSrc()` and `getRejectedMessage()`. jsdom has no `URL.createObjectURL`, so a picked\nimage shows no preview there: assert on the bound value, or stub `URL.createObjectURL` to read\nthe preview.",
+      "members": [],
+      "methods": [
+        {
+          "name": "getLabel",
+          "signature": "getLabel(): Promise<string>",
+          "params": [],
+          "returns": "Promise<string>",
+          "doc": "The visible label without the required mark, else the tile's `aria-label`."
+        },
+        {
+          "name": "getErrorText",
+          "signature": "getErrorText(): Promise<string>",
+          "params": [],
+          "returns": "Promise<string>",
+          "doc": "The error text beside the tile (an explicit message, or the first form error once touched)."
+        },
+        {
+          "name": "isDisabled",
+          "signature": "isDisabled(): Promise<boolean>",
+          "params": [],
+          "returns": "Promise<boolean>",
+          "doc": "Whether the control is disabled."
+        },
+        {
+          "name": "isReadonly",
+          "signature": "isReadonly(): Promise<boolean>",
+          "params": [],
+          "returns": "Promise<boolean>",
+          "doc": "Whether the control is read-only: its tile is not a button and there are no Upload or Remove\nbuttons."
+        },
+        {
+          "name": "hasPreview",
+          "signature": "hasPreview(): Promise<boolean>",
+          "params": [],
+          "returns": "Promise<boolean>",
+          "doc": "Whether the tile shows an image, picked or from `src`. A picked image needs\n`URL.createObjectURL`, which jsdom lacks: stub it to see one."
+        },
+        {
+          "name": "getPreviewSrc",
+          "signature": "getPreviewSrc(): Promise<string | null>",
+          "params": [],
+          "returns": "Promise<string | null>",
+          "doc": "The `src` of the shown image."
+        },
+        {
+          "name": "addFile",
+          "signature": "addFile(file: File): Promise<void>",
+          "params": [
+            {
+              "name": "file",
+              "type": "File",
+              "optional": false,
+              "doc": "The image to drop."
+            }
+          ],
+          "returns": "Promise<void>",
+          "doc": "Drops an image on the tile, as a user would. On a disabled or read-only control it does\nnothing, like the UI. It waits on no timer, so it works under fake timers and `fakeAsync`."
+        },
+        {
+          "name": "remove",
+          "signature": "remove(): Promise<void>",
+          "params": [],
+          "returns": "Promise<void>",
+          "doc": "Presses Remove, which clears the picked and the existing image. Throws while there is no\nimage or the control cannot be edited."
+        },
+        {
+          "name": "getRejectedMessage",
+          "signature": "getRejectedMessage(): Promise<string>",
+          "params": [],
+          "returns": "Promise<string>",
+          "doc": "The reason the last pick was refused, until the next pick or Remove."
+        }
+      ],
+      "slots": [],
+      "references": [],
+      "usedBy": [],
+      "since": "0.5.0",
+      "signature": "class BfImageInputHarness extends ComponentHarness"
+    },
+    {
+      "name": "BfImageViewerHarness",
+      "slug": "bf-image-viewer-harness",
+      "kind": "class",
+      "entryPoint": "@bitforgehq/ui/testing",
+      "file": "testing/harnesses/image-viewer.harness.ts",
+      "summary": "Test harness for an image viewer: its image, index, caption, steps and close",
+      "description": "Harness for `bf-image-viewer`, the lightbox `BfImageViewerService.open()` renders. It renders\nin the CDK overlay container outside the tested component, so get it through\n`TestbedHarnessEnvironment.documentRootLoader(fixture)`. jsdom never loads images: call\n`loadImage()` to fire the shown image's `load` event.",
+      "members": [],
+      "methods": [
+        {
+          "name": "getLabel",
+          "signature": "getLabel(): Promise<string>",
+          "params": [],
+          "returns": "Promise<string>",
+          "doc": "The viewer's accessible name (`ariaLabel`, else the `imageViewer` label)."
+        },
+        {
+          "name": "getIndex",
+          "signature": "getIndex(): Promise<number>",
+          "params": [],
+          "returns": "Promise<number>",
+          "doc": "The 0-based index of the shown image."
+        },
+        {
+          "name": "getCount",
+          "signature": "getCount(): Promise<number>",
+          "params": [],
+          "returns": "Promise<number>",
+          "doc": "How many images the viewer steps through."
+        },
+        {
+          "name": "getCounterText",
+          "signature": "getCounterText(): Promise<string>",
+          "params": [],
+          "returns": "Promise<string>",
+          "doc": "The counter's text (\"2 of 5\"); a viewer of one image shows none."
+        },
+        {
+          "name": "getSrc",
+          "signature": "getSrc(): Promise<string>",
+          "params": [],
+          "returns": "Promise<string>",
+          "doc": "The URL of the shown image."
+        },
+        {
+          "name": "getAlt",
+          "signature": "getAlt(): Promise<string>",
+          "params": [],
+          "returns": "Promise<string>",
+          "doc": "The alternative text of the shown image."
+        },
+        {
+          "name": "getCaption",
+          "signature": "getCaption(): Promise<string>",
+          "params": [],
+          "returns": "Promise<string>",
+          "doc": "The caption under the shown image."
+        },
+        {
+          "name": "isLoaded",
+          "signature": "isLoaded(): Promise<boolean>",
+          "params": [],
+          "returns": "Promise<boolean>",
+          "doc": "Whether the shown image has loaded (no spinner and no failure message)."
+        },
+        {
+          "name": "hasFailed",
+          "signature": "hasFailed(): Promise<boolean>",
+          "params": [],
+          "returns": "Promise<boolean>",
+          "doc": "Whether the shown image failed to load (the failure message shows)."
+        },
+        {
+          "name": "loadImage",
+          "signature": "loadImage(): Promise<void>",
+          "params": [],
+          "returns": "Promise<void>",
+          "doc": "Fires the shown image's `load` event, as a browser does when it arrives."
+        },
+        {
+          "name": "failImage",
+          "signature": "failImage(): Promise<void>",
+          "params": [],
+          "returns": "Promise<void>",
+          "doc": "Fires the shown image's `error` event, as a browser does when it fails."
+        },
+        {
+          "name": "next",
+          "signature": "next(): Promise<void>",
+          "params": [],
+          "returns": "Promise<void>",
+          "doc": "Clicks the next button. Throws for a viewer of one image (it has none)."
+        },
+        {
+          "name": "previous",
+          "signature": "previous(): Promise<void>",
+          "params": [],
+          "returns": "Promise<void>",
+          "doc": "Clicks the previous button. Throws for a viewer of one image (it has none)."
+        },
+        {
+          "name": "pressKey",
+          "signature": "pressKey(key: 'ArrowLeft' | 'ArrowRight' | 'Home' | 'End' | 'Escape'): Promise<void>",
+          "params": [
+            {
+              "name": "key",
+              "type": "'ArrowLeft' | 'ArrowRight' | 'Home' | 'End' | 'Escape'",
+              "optional": false,
+              "doc": "The key to press."
+            }
+          ],
+          "returns": "Promise<void>",
+          "doc": "Presses a key inside the viewer: ArrowLeft and ArrowRight step, Home and End jump, Escape\ncloses."
+        },
+        {
+          "name": "close",
+          "signature": "close(): Promise<void>",
+          "params": [],
+          "returns": "Promise<void>",
+          "doc": "Clicks the close button."
+        }
+      ],
+      "slots": [],
+      "references": [],
+      "usedBy": [],
+      "since": "0.5.0",
+      "signature": "class BfImageViewerHarness extends ComponentHarness"
+    },
     {
       "name": "BfJsdomShimOptions",
       "slug": "bf-jsdom-shim-options",
@@ -9107,6 +10392,100 @@
       "usedBy": ["install-bf-jsdom-shims"],
       "since": "0.3.0"
     },
+    {
+      "name": "BfMediaCardHarness",
+      "slug": "bf-media-card-harness",
+      "kind": "class",
+      "entryPoint": "@bitforgehq/ui/testing",
+      "file": "testing/harnesses/media-card.harness.ts",
+      "summary": "Test harness for a media card: its image state, its messages and its selection",
+      "description": "Harness for `bf-media-card`. jsdom never loads images, so `loadImage()` and `failImage()` fire\nthe image's `load` and `error` events the way a browser would; `getState()` then tells what the\nimage area shows.",
+      "members": [],
+      "methods": [
+        {
+          "name": "getTitle",
+          "signature": "getTitle(): Promise<string>",
+          "params": [],
+          "returns": "Promise<string>",
+          "doc": "The card's title: the text of the first heading in its body."
+        },
+        {
+          "name": "getState",
+          "signature": "getState(): Promise<'empty' | 'loading' | 'loaded' | 'failed'>",
+          "params": [],
+          "returns": "Promise<'empty' | 'loading' | 'loaded' | 'failed'>",
+          "doc": "What the image area shows: `empty` (no `src`, not loading), `loading` (the skeleton),\n`loaded` (the image) or `failed` (the failure message)."
+        },
+        {
+          "name": "getSrc",
+          "signature": "getSrc(): Promise<string>",
+          "params": [],
+          "returns": "Promise<string>",
+          "doc": "The URL of the image."
+        },
+        {
+          "name": "getAlt",
+          "signature": "getAlt(): Promise<string>",
+          "params": [],
+          "returns": "Promise<string>",
+          "doc": "The alternative text of the image."
+        },
+        {
+          "name": "getLoadingLabel",
+          "signature": "getLoadingLabel(): Promise<string>",
+          "params": [],
+          "returns": "Promise<string>",
+          "doc": "The caption over the skeleton while loading (the `loading` label when none is set)."
+        },
+        {
+          "name": "getFailedMessage",
+          "signature": "getFailedMessage(): Promise<string>",
+          "params": [],
+          "returns": "Promise<string>",
+          "doc": "The failure message."
+        },
+        {
+          "name": "loadImage",
+          "signature": "loadImage(): Promise<void>",
+          "params": [],
+          "returns": "Promise<void>",
+          "doc": "Fires the image's `load` event, as a browser does when it arrives. Throws without one."
+        },
+        {
+          "name": "failImage",
+          "signature": "failImage(): Promise<void>",
+          "params": [],
+          "returns": "Promise<void>",
+          "doc": "Fires the image's `error` event, as a browser does when it fails. Throws without one."
+        },
+        {
+          "name": "isSelectable",
+          "signature": "isSelectable(): Promise<boolean>",
+          "params": [],
+          "returns": "Promise<boolean>",
+          "doc": "Whether the card has a select button (`selectable`)."
+        },
+        {
+          "name": "isSelected",
+          "signature": "isSelected(): Promise<boolean>",
+          "params": [],
+          "returns": "Promise<boolean>",
+          "doc": "Whether the card is selected (its select button is pressed)."
+        },
+        {
+          "name": "toggleSelected",
+          "signature": "toggleSelected(): Promise<void>",
+          "params": [],
+          "returns": "Promise<void>",
+          "doc": "Clicks the select button, toggling the selection. Throws for a card that is not selectable."
+        }
+      ],
+      "slots": [],
+      "references": [],
+      "usedBy": [],
+      "since": "0.5.0",
+      "signature": "class BfMediaCardHarness extends ComponentHarness"
+    },
     {
       "name": "BfMenuButtonHarness",
       "slug": "bf-menu-button-harness",
@@ -9547,7 +10926,7 @@
       "entryPoint": "@bitforgehq/ui/testing",
       "file": "testing/harnesses/select.harness.ts",
       "summary": "Test harness for the select: reads its label and options and picks one",
-      "description": "Harness for `bf-select`. It works by option label, so a test never needs the native option\nvalues (an object option's native value is its index).",
+      "description": "Harness for `bf-select`, in both modes: the styled list under a mouse (its options render in the\nCDK overlay container while open, found through the field's `aria-controls`) and the native\n`<select>` under a coarse pointer. It also drives the native select with `data-bf-select` that a\nstacked `bf-table` renders as its Sort by select without `provideBfSelect()`. It works by option\nlabel, so a test never needs the option values (an object option's native value is its index).",
       "members": [],
       "methods": [
         {
@@ -9557,6 +10936,13 @@
           "returns": "Promise<string>",
           "doc": "The visible label without the required mark, else the `aria-label`."
         },
+        {
+          "name": "isOpen",
+          "signature": "isOpen(): Promise<boolean>",
+          "params": [],
+          "returns": "Promise<boolean>",
+          "doc": "Whether the styled option list is open (`aria-expanded`). Always false for the native select,\nwhose list belongs to the platform."
+        },
         {
           "name": "getValueLabel",
           "signature": "getValueLabel(): Promise<string>",
@@ -9583,7 +10969,7 @@
             }
           ],
           "returns": "Promise<void>",
-          "doc": "Chooses the option with this label, as a user would: the select's `value` becomes that\noption's value. Throws, leaving the value as it is, for an unknown or disabled option and\nwhile the select itself is disabled."
+          "doc": "Chooses the option with this label, as a user would: the select's `value` becomes that\noption's value. Throws, leaving the value as it is, for an unknown or disabled option and\nwhile the select itself is disabled. On a read-only select it changes nothing, in both modes:\nthe styled list does not open, and the native select restores the shown option."
         },
         {
           "name": "isDisabled",
@@ -9625,14 +11011,14 @@
           "signature": "focus(): Promise<void>",
           "params": [],
           "returns": "Promise<void>",
-          "doc": "Focuses the native select."
+          "doc": "Focuses the field, or the native select."
         },
         {
           "name": "blur",
           "signature": "blur(): Promise<void>",
           "params": [],
           "returns": "Promise<void>",
-          "doc": "Blurs the native select, which marks a bound form field touched."
+          "doc": "Blurs the field, or the native select, which marks a bound form field touched."
         }
       ],
       "slots": [],
@@ -9827,6 +11213,32 @@
           "returns": "Promise<string>",
           "doc": "The text of one cell."
         },
+        {
+          "name": "getCellHarness",
+          "signature": "getCellHarness<T extends ComponentHarness>(row: number, column: string, query: HarnessQuery<T>): Promise<T>",
+          "params": [
+            {
+              "name": "row",
+              "type": "number",
+              "optional": false,
+              "doc": "The row's position, from 0."
+            },
+            {
+              "name": "column",
+              "type": "string",
+              "optional": false,
+              "doc": "The column's header text."
+            },
+            {
+              "name": "query",
+              "type": "HarnessQuery<T>",
+              "optional": false,
+              "doc": "The harness type, or a predicate from its `with()`."
+            }
+          ],
+          "returns": "Promise<T>",
+          "doc": "A harness for a control in one cell, such as a `bf-toggle` of a settings matrix or a\n`bf-select` in a custom cell. Throws for an unknown row or column, or when the cell holds no\nmatching control."
+        },
         {
           "name": "sortBy",
           "signature": "sortBy(column: string): Promise<void>",
@@ -10016,6 +11428,79 @@
       "since": "0.3.1",
       "signature": "class BfTimeInputHarness extends ComponentHarness"
     },
+    {
+      "name": "BfToggleHarness",
+      "slug": "bf-toggle-harness",
+      "kind": "class",
+      "entryPoint": "@bitforgehq/ui/testing",
+      "file": "testing/harnesses/toggle.harness.ts",
+      "summary": "Test harness for the toggle: reads its name and state and switches it",
+      "description": "Harness for `bf-toggle`. Its `label` filter matches the switch's name: the text of the elements\n`ariaLabelledby` names, else `ariaLabel`, else the visible label, so a label-less switch in a\ntable cell or a list row is found the same way.",
+      "members": [],
+      "methods": [
+        {
+          "name": "getLabel",
+          "signature": "getLabel(): Promise<string>",
+          "params": [],
+          "returns": "Promise<string>",
+          "doc": "The switch's name, as the browser computes it: the text of the elements `ariaLabelledby`\nnames, else `ariaLabel`, else the visible label (the `label` text and the default slot)."
+        },
+        {
+          "name": "isChecked",
+          "signature": "isChecked(): Promise<boolean>",
+          "params": [],
+          "returns": "Promise<boolean>",
+          "doc": "Whether the switch is on."
+        },
+        {
+          "name": "isDisabled",
+          "signature": "isDisabled(): Promise<boolean>",
+          "params": [],
+          "returns": "Promise<boolean>",
+          "doc": "Whether the switch is disabled."
+        },
+        {
+          "name": "isReadonly",
+          "signature": "isReadonly(): Promise<boolean>",
+          "params": [],
+          "returns": "Promise<boolean>",
+          "doc": "Whether the switch is read-only (`aria-readonly`): it shows its state but a click does nothing."
+        },
+        {
+          "name": "toggle",
+          "signature": "toggle(): Promise<void>",
+          "params": [],
+          "returns": "Promise<void>",
+          "doc": "Clicks the switch, as a user would, so it turns on or off. Throws while it is disabled (a\nuser's click would do nothing); a read-only switch takes the click and stays as it is."
+        },
+        {
+          "name": "check",
+          "signature": "check(): Promise<void>",
+          "params": [],
+          "returns": "Promise<void>",
+          "doc": "Turns the switch on with a click; an on switch stays on. Throws while it is disabled."
+        },
+        {
+          "name": "uncheck",
+          "signature": "uncheck(): Promise<void>",
+          "params": [],
+          "returns": "Promise<void>",
+          "doc": "Turns the switch off with a click; an off switch stays off. Throws while it is disabled."
+        },
+        {
+          "name": "getErrorText",
+          "signature": "getErrorText(): Promise<string>",
+          "params": [],
+          "returns": "Promise<string>",
+          "doc": "The error text under the switch."
+        }
+      ],
+      "slots": [],
+      "references": [],
+      "usedBy": [],
+      "since": "0.4.0",
+      "signature": "class BfToggleHarness extends ComponentHarness"
+    },
     {
       "name": "BfTooltipHarness",
       "slug": "bf-tooltip-harness",