@bitforgehq/ui 0.4.0 → 0.5.0-next.4

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",
@@ -454,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",
@@ -704,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",
@@ -798,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",
@@ -815,6 +898,57 @@
       "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": "BfImageTileAspect",
+      "slug": "bf-image-tile-aspect",
+      "kind": "type",
+      "entryPoint": "@bitforgehq/ui",
+      "file": "src/components/image-tile/image-tile.component.ts",
+      "summary": "The four aspect ratios of an image tile's picture, square by default",
+      "description": "The aspect ratio of a `bf-image-tile`'s picture: square (default), 4:3, 16:9 or 3:4.",
+      "members": [],
+      "methods": [],
+      "slots": [],
+      "references": [],
+      "usedBy": ["bf-image-tile-component"],
+      "since": "0.5.0",
+      "signature": "type BfImageTileAspect = '1/1' | '4/3' | '16/9' | '3/4'",
+      "values": ["1/1", "4/3", "16/9", "3/4"]
+    },
+    {
+      "name": "BfImageTileCaptionPlacement",
+      "slug": "bf-image-tile-caption-placement",
+      "kind": "type",
+      "entryPoint": "@bitforgehq/ui",
+      "file": "src/components/image-tile/image-tile.component.ts",
+      "summary": "Where an image tile's caption sits, below the picture or over it",
+      "description": "Where a `bf-image-tile`'s title and meta line sit: `below` the picture (default), or `overlay`,\non a soft gradient over the bottom of the picture.",
+      "members": [],
+      "methods": [],
+      "slots": [],
+      "references": [],
+      "usedBy": ["bf-image-tile-component"],
+      "since": "0.5.0",
+      "signature": "type BfImageTileCaptionPlacement = 'below' | 'overlay'",
+      "values": ["below", "overlay"]
+    },
     {
       "name": "BfInputAutocapitalize",
       "slug": "bf-input-autocapitalize",
@@ -1569,6 +1703,294 @@
           "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, bf-image-tile's and bf-image-viewer's message for an image that failed to load.",
+          "readonly": true,
+          "default": "'The image could not be loaded'"
+        },
+        {
+          "name": "imageTileEmpty",
+          "kind": "property",
+          "type": "string",
+          "required": true,
+          "doc": "bf-image-tile's placeholder text while it has no image yet.",
+          "readonly": true,
+          "default": "'No image yet'"
+        },
+        {
+          "name": "imageTileSelected",
+          "kind": "property",
+          "type": "string",
+          "required": true,
+          "doc": "bf-image-tile's selected state, read before the tile's title (\"Selected, Dragon\").",
+          "readonly": true,
+          "default": "'Selected'"
+        },
+        {
+          "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",
@@ -1601,22 +2023,71 @@
       "signature": "type BfLabelsOverrides = Partial<Omit<BfLabels, 'validation'>> & { readonly validation?: Partial<BfValidationMessages>; }"
     },
     {
-      "name": "BfPageHeaderHeadingLevel",
-      "slug": "bf-page-header-heading-level",
+      "name": "BfMediaCardAspect",
+      "slug": "bf-media-card-aspect",
       "kind": "type",
       "entryPoint": "@bitforgehq/ui",
-      "file": "src/components/page-header/page-header.component.ts",
-      "summary": "The heading level of a page header title, one for a page or two",
-      "description": "The heading level of a `bf-page-header` title: `1` for the page, `2` for a section header.",
+      "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-page-header-component"],
-      "since": "0.3.1",
+      "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",
+      "kind": "type",
+      "entryPoint": "@bitforgehq/ui",
+      "file": "src/components/page-header/page-header.component.ts",
+      "summary": "The heading level of a page header title, one for a page or two",
+      "description": "The heading level of a `bf-page-header` title: `1` for the page, `2` for a section header.",
+      "members": [],
+      "methods": [],
+      "slots": [],
+      "references": [],
+      "usedBy": ["bf-page-header-component"],
+      "since": "0.3.1",
       "signature": "type BfPageHeaderHeadingLevel = 1 | 2",
       "values": ["1", "2"]
     },
+    {
+      "name": "BfPaginationPositionLabel",
+      "slug": "bf-pagination-position-label",
+      "kind": "type",
+      "entryPoint": "@bitforgehq/ui",
+      "file": "src/components/pagination/pagination.component.ts",
+      "summary": "Function that writes a compact pager's position text, such as \"v3 of 7\"",
+      "description": "Writes a compact `bf-pagination`'s position text from the current page and the page count, such\nas \"v3 of 7\" for page 3 of 7.",
+      "members": [],
+      "methods": [],
+      "slots": [],
+      "references": [],
+      "usedBy": ["bf-pagination-component"],
+      "since": "0.5.0",
+      "signature": "type BfPaginationPositionLabel = (page: number, count: number) => string"
+    },
     {
       "name": "BfProgressSize",
       "slug": "bf-progress-size",
@@ -1651,6 +2122,22 @@
       "signature": "type BfProgressTone = 'primary' | 'success' | 'warning' | 'danger'",
       "values": ["primary", "success", "warning", "danger"]
     },
+    {
+      "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",
@@ -1715,6 +2202,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",
@@ -1777,7 +2322,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": [
@@ -1809,7 +2354,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",
@@ -1851,6 +2401,7 @@
         "bf-button-component",
         "bf-button-size",
         "bf-calendar-component",
+        "bf-chat-composer-component",
         "bf-checkbox-component",
         "bf-chip-component",
         "bf-combobox-component",
@@ -1860,7 +2411,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",
@@ -2685,7 +3238,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`, `listItemUnread`, `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`, `imageTileEmpty`,\n`imageTileSelected`, `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": [
         {
@@ -2700,7 +3253,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`, `listItemUnread`, `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`, `imageTileEmpty`,\n`imageTileSelected`, `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": [],
@@ -3558,138 +4111,433 @@
       "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": [],
@@ -5436,6 +6284,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",
@@ -8691,13 +9563,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": [
         {
@@ -8705,54 +9577,148 @@
           "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>",
-          "params": [
+          "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",
               "type": "string",
@@ -9125,6 +10091,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",
@@ -9150,6 +10210,323 @@
       "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": "BfImageTileHarness",
+      "slug": "bf-image-tile-harness",
+      "kind": "class",
+      "entryPoint": "@bitforgehq/ui/testing",
+      "file": "testing/harnesses/image-tile.harness.ts",
+      "summary": "Test harness for an image tile: its picture state, title, meta, selection and action",
+      "description": "Harness for `bf-image-tile`. jsdom never loads images, so `loadImage()` and `failImage()` fire\nthe picture's `load` and `error` events the way a browser would; `getState()` then tells what\nthe tile shows. `click()` clicks the tile's `bfAction` link or button.",
+      "members": [],
+      "methods": [
+        {
+          "name": "getTitle",
+          "signature": "getTitle(): Promise<string>",
+          "params": [],
+          "returns": "Promise<string>",
+          "doc": "The tile's title: the text of its default slot."
+        },
+        {
+          "name": "getMeta",
+          "signature": "getMeta(): Promise<string>",
+          "params": [],
+          "returns": "Promise<string>",
+          "doc": "The meta line under the title."
+        },
+        {
+          "name": "getState",
+          "signature": "getState(): Promise<'empty' | 'loading' | 'loaded' | 'failed'>",
+          "params": [],
+          "returns": "Promise<'empty' | 'loading' | 'loaded' | 'failed'>",
+          "doc": "What the picture area shows: `empty` (the placeholder), `loading` (the skeleton), `loaded`\n(the picture) or `failed` (the failure message)."
+        },
+        {
+          "name": "getSrc",
+          "signature": "getSrc(): Promise<string>",
+          "params": [],
+          "returns": "Promise<string>",
+          "doc": "The URL of the picture."
+        },
+        {
+          "name": "getAlt",
+          "signature": "getAlt(): Promise<string>",
+          "params": [],
+          "returns": "Promise<string>",
+          "doc": "The alternative text of the picture."
+        },
+        {
+          "name": "getPlaceholderText",
+          "signature": "getPlaceholderText(): Promise<string>",
+          "params": [],
+          "returns": "Promise<string>",
+          "doc": "The placeholder text while there is no picture."
+        },
+        {
+          "name": "getFailedMessage",
+          "signature": "getFailedMessage(): Promise<string>",
+          "params": [],
+          "returns": "Promise<string>",
+          "doc": "The failure message."
+        },
+        {
+          "name": "isSelected",
+          "signature": "isSelected(): Promise<boolean>",
+          "params": [],
+          "returns": "Promise<boolean>",
+          "doc": "Whether the tile is marked selected."
+        },
+        {
+          "name": "isClickable",
+          "signature": "isClickable(): Promise<boolean>",
+          "params": [],
+          "returns": "Promise<boolean>",
+          "doc": "Whether the tile is clickable (has a `bfAction` link or button)."
+        },
+        {
+          "name": "click",
+          "signature": "click(): Promise<void>",
+          "params": [],
+          "returns": "Promise<void>",
+          "doc": "Clicks the tile's `bfAction` link or button. Throws for a tile without one."
+        },
+        {
+          "name": "loadImage",
+          "signature": "loadImage(): Promise<void>",
+          "params": [],
+          "returns": "Promise<void>",
+          "doc": "Fires the picture'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 picture's `error` event, as a browser does when it fails. Throws without one."
+        }
+      ],
+      "slots": [],
+      "references": [],
+      "usedBy": [],
+      "since": "0.5.0",
+      "signature": "class BfImageTileHarness 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",
@@ -9184,6 +10561,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",
@@ -9624,7 +11095,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": [
         {
@@ -9634,6 +11105,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>",
@@ -9660,7 +11138,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",
@@ -9702,14 +11180,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": [],