@bitforgehq/ui 0.4.0 → 0.5.0-next.4

package/llms.txt

@@ -35,6 +35,7 @@
 ### Forms
 
 - [bf-calendar](https://bitforge-ui.web.app/ai/components/calendar.md): Inline month calendar for picking one date, with month and year jumps ([docs](https://bitforge-ui.web.app/components/calendar))
+- [bf-chat-composer](https://bitforge-ui.web.app/ai/components/chat-composer.md): Chat input that grows with the text and sends on Enter, or stops a reply ([docs](https://bitforge-ui.web.app/components/chat-composer))
 - [bf-checkbox](https://bitforge-ui.web.app/ai/components/checkbox.md): Rounded checkbox with an optional label that binds to Signal Forms ([docs](https://bitforge-ui.web.app/components/checkbox))
 - [bf-chip](https://bitforge-ui.web.app/ai/components/chip.md): Toggleable filter chip with a check mark when selected, in tonal or ink style ([docs](https://bitforge-ui.web.app/components/chip))
 - [bf-chip-group](https://bitforge-ui.web.app/ai/components/chip-group.md): Named row of chips that picks one like radios, or groups independent toggles ([docs](https://bitforge-ui.web.app/components/chip-group))
@@ -42,12 +43,14 @@
 - [bf-date-input](https://bitforge-ui.web.app/ai/components/date-input.md): Typed date field with a calendar popover, valued as an ISO date string ([docs](https://bitforge-ui.web.app/components/date-input))
 - [bf-datetime-input](https://bitforge-ui.web.app/ai/components/datetime-input.md): Typed date and time field with a calendar and time list in one popover ([docs](https://bitforge-ui.web.app/components/datetime-input))
 - [bf-field](https://bitforge-ui.web.app/ai/components/field.md): Label, help text and error text wrapper that wires ids for assistive tech ([docs](https://bitforge-ui.web.app/components/field))
+- [bf-file-input](https://bitforge-ui.web.app/ai/components/file-input.md): File picker field that lists picked or dropped files and checks type, size and count ([docs](https://bitforge-ui.web.app/components/file-input))
+- [bf-image-input](https://bitforge-ui.web.app/ai/components/image-input.md): Single-image picker with a round or square preview tile and replace or remove ([docs](https://bitforge-ui.web.app/components/image-input))
 - [bf-input](https://bitforge-ui.web.app/ai/components/input.md): Single-line text field with label, help and error text, icon slots and Signal Forms binding ([docs](https://bitforge-ui.web.app/components/input))
 - [bf-multi-combobox](https://bitforge-ui.web.app/ai/components/multi-combobox.md): Text field that filters options as you type and picks several as tags ([docs](https://bitforge-ui.web.app/components/multi-combobox))
 - [bf-number-input](https://bitforge-ui.web.app/ai/components/number-input.md): Number field that binds number or null, with native min, max and step ([docs](https://bitforge-ui.web.app/components/number-input))
 - [bf-radio-group](https://bitforge-ui.web.app/ai/components/radio-group.md): Group of radio buttons for choosing one option, with optional per-option descriptions ([docs](https://bitforge-ui.web.app/components/radio-group))
 - [bf-segmented](https://bitforge-ui.web.app/ai/components/segmented.md): Segmented control for switching between two to four views, keyboard-navigable like radios ([docs](https://bitforge-ui.web.app/components/segmented))
-- [bf-select](https://bitforge-ui.web.app/ai/components/select.md): Native single-choice dropdown styled like the text field, with Signal Forms binding ([docs](https://bitforge-ui.web.app/components/select))
+- [bf-select](https://bitforge-ui.web.app/ai/components/select.md): Single-choice dropdown with a styled list, native under touch, with Signal Forms binding ([docs](https://bitforge-ui.web.app/components/select))
 - [bf-textarea](https://bitforge-ui.web.app/ai/components/textarea.md): Multi-line text field with label, help and error text, and Signal Forms binding ([docs](https://bitforge-ui.web.app/components/textarea))
 - [bf-theme-switch](https://bitforge-ui.web.app/ai/components/theme-switch.md): Segmented System, Light and Dark switch bound two-way to the app colour scheme ([docs](https://bitforge-ui.web.app/components/theme-switch))
 - [bf-time-input](https://bitforge-ui.web.app/ai/components/time-input.md): Typed time-of-day field with a popover list of times, valued as an ISO string ([docs](https://bitforge-ui.web.app/components/time-input))
@@ -60,12 +63,16 @@
 - [bf-bar-chart](https://bitforge-ui.web.app/ai/components/bar-chart.md): Bar chart of series over categories, grouped or stacked, vertical or horizontal ([docs](https://bitforge-ui.web.app/components/bar-chart))
 - [bf-card](https://bitforge-ui.web.app/ai/components/card.md): Content surface with an optional header slot, in four visual styles from raised to flat ([docs](https://bitforge-ui.web.app/components/card))
 - [bf-chart-card](https://bitforge-ui.web.app/ai/components/chart-card.md): Card around one chart with a title, period control and loading, empty and error states ([docs](https://bitforge-ui.web.app/components/chart-card))
+- [bf-chat-message](https://bitforge-ui.web.app/ai/components/chat-message.md): One chat message, a user bubble or a full-width assistant reply that can stream ([docs](https://bitforge-ui.web.app/components/chat-message))
+- [bf-chat-thread](https://bitforge-ui.web.app/ai/components/chat-thread.md): Scrolling chat message log that follows new text and offers a jump to latest ([docs](https://bitforge-ui.web.app/components/chat-thread))
 - [div[bfDescriptionItem]](https://bitforge-ui.web.app/ai/components/description-item.md): One label and value pair of a description list, label as term, content as value ([docs](https://bitforge-ui.web.app/components/description-item))
 - [bf-description-list](https://bitforge-ui.web.app/ai/components/description-list.md): Native description list of label-value pairs, as divided rows or a tile grid ([docs](https://bitforge-ui.web.app/components/description-list))
 - [bf-donut-chart](https://bitforge-ui.web.app/ai/components/donut-chart.md): Donut chart of the parts of a whole, with a legend, tooltip and centre slot ([docs](https://bitforge-ui.web.app/components/donut-chart))
+- [bf-image-tile](https://bitforge-ui.web.app/ai/components/image-tile.md): Small card for thumbnail grids: a picture and title that act as one target ([docs](https://bitforge-ui.web.app/components/image-tile))
 - [bf-line-chart](https://bitforge-ui.web.app/ai/components/line-chart.md): Line chart of series over categories, with tooltip, legend and data table ([docs](https://bitforge-ui.web.app/components/line-chart))
 - [bf-list](https://bitforge-ui.web.app/ai/components/list.md): Container for list rows, inset by default with rounded corners on a warm background ([docs](https://bitforge-ui.web.app/components/list))
 - [bf-list-item](https://bitforge-ui.web.app/ai/components/list-item.md): List row with leading slot, title, subtitle, trailing slot and an optional chevron ([docs](https://bitforge-ui.web.app/components/list-item))
+- [bf-media-card](https://bitforge-ui.web.app/ai/components/media-card.md): Card with an image that loads, fades in or fails, plus a body and actions ([docs](https://bitforge-ui.web.app/components/media-card))
 - [bf-progress](https://bitforge-ui.web.app/ai/components/progress.md): Progress bar in two sizes and four tones for completion, quotas and unknown waits ([docs](https://bitforge-ui.web.app/components/progress))
 - [bf-sparkline](https://bitforge-ui.web.app/ai/components/sparkline.md): Tiny trend line with no axes or legend, for stats and table cells ([docs](https://bitforge-ui.web.app/components/sparkline))
 - [bf-stat](https://bitforge-ui.web.app/ai/components/stat.md): One labelled figure with an optional icon tile and a supporting line ([docs](https://bitforge-ui.web.app/components/stat))
@@ -112,6 +119,7 @@
 - [bf-alert-dialog](https://bitforge-ui.web.app/ai/components/alert-dialog.md): Centred confirmation dialog with a title, message and a row of role-styled buttons ([docs](https://bitforge-ui.web.app/components/alert-dialog))
 - [bf-desktop-toast](https://bitforge-ui.web.app/ai/components/desktop-toast.md): Desktop notification card in a bottom corner stack of up to three ([docs](https://bitforge-ui.web.app/components/desktop-toast))
 - [bf-dialog](https://bitforge-ui.web.app/ai/components/dialog.md): Desktop modal dialog with a title, scrolling body, footer actions and focus trap ([docs](https://bitforge-ui.web.app/components/dialog))
+- [bf-image-viewer](https://bitforge-ui.web.app/ai/components/image-viewer.md): Full-screen image viewer that zooms from a thumbnail and steps through a set ([docs](https://bitforge-ui.web.app/components/image-viewer))
 - [bf-menu](https://bitforge-ui.web.app/ai/components/menu.md): Keyboard-operable menu panel with items, checkbox and radio items, groups and submenus ([docs](https://bitforge-ui.web.app/components/menu))
 - [bf-menu-button](https://bitforge-ui.web.app/ai/components/menu-button.md): Styled button that opens a menu, with outline, text, tonal and icon-only looks ([docs](https://bitforge-ui.web.app/components/menu-button))
 - [bf-modal](https://bitforge-ui.web.app/ai/components/modal.md): Modal overlay shown as an inset card over the scaled-down page, or full screen ([docs](https://bitforge-ui.web.app/components/modal))
@@ -147,6 +155,7 @@
 - [BF_TAB_BAR](https://bitforge-ui.web.app/ai/reference/bf_tab_bar.md): Injection token through which each tab reaches its enclosing tab bar ([docs](https://bitforge-ui.web.app/api/bf_tab_bar))
 - [BF_TAB_BAR_CONTROLLER](https://bitforge-ui.web.app/ai/reference/bf_tab_bar_controller.md): Injection token through which a parent drives the selection and hiding of its tab bar ([docs](https://bitforge-ui.web.app/api/bf_tab_bar_controller))
 - [BF_TAB_LINKS](https://bitforge-ui.web.app/ai/reference/bf_tab_links.md): Injection token that turns a projected tab bar into a navigation of links ([docs](https://bitforge-ui.web.app/api/bf_tab_links))
+- [BF_TABLE_SORT_SELECT](https://bitforge-ui.web.app/ai/reference/bf_table_sort_select.md): The component a stacked table renders as its Sort by select ([docs](https://bitforge-ui.web.app/api/bf_table_sort_select))
 - [BfActionDirective](https://bitforge-ui.web.app/ai/reference/bf-action-directive.md): Makes one link or button the click target of a whole card or list row ([docs](https://bitforge-ui.web.app/api/bf-action-directive))
 - [BfAlertVariant](https://bitforge-ui.web.app/ai/reference/bf-alert-variant.md): The four tones of an alert, from neutral information to a danger message ([docs](https://bitforge-ui.web.app/api/bf-alert-variant))
 - [BfAppFrameBreakpoint](https://bitforge-ui.web.app/ai/reference/bf-app-frame-breakpoint.md): The breakpoint where an app frame switches from its header bar to the sidebar ([docs](https://bitforge-ui.web.app/api/bf-app-frame-breakpoint))
@@ -165,6 +174,8 @@
 - [BfCalendarWeekday](https://bitforge-ui.web.app/ai/reference/bf-calendar-weekday.md): A weekday number from 0 for Sunday to 6 for Saturday, as Date counts ([docs](https://bitforge-ui.web.app/api/bf-calendar-weekday))
 - [BfCardPadding](https://bitforge-ui.web.app/ai/reference/bf-card-padding.md): The two inner paddings of a card, regular and roomy ([docs](https://bitforge-ui.web.app/api/bf-card-padding))
 - [BfCardVariant](https://bitforge-ui.web.app/ai/reference/bf-card-variant.md): The four card surfaces, from a raised panel to a flat outline ([docs](https://bitforge-ui.web.app/api/bf-card-variant))
+- [BfChatMessageRole](https://bitforge-ui.web.app/ai/reference/bf-chat-message-role.md): Who wrote a chat message, the user or the assistant ([docs](https://bitforge-ui.web.app/api/bf-chat-message-role))
+- [BfChatMessageStatus](https://bitforge-ui.web.app/ai/reference/bf-chat-message-status.md): How a chat message ended: done, stopped by the user, or failed ([docs](https://bitforge-ui.web.app/api/bf-chat-message-status))
 - [BfChipGroupMode](https://bitforge-ui.web.app/ai/reference/bf-chip-group-mode.md): Whether a chip group picks exactly one chip or lets each chip toggle alone ([docs](https://bitforge-ui.web.app/api/bf-chip-group-mode))
 - [BfChipVariant](https://bitforge-ui.web.app/ai/reference/bf-chip-variant.md): The two chip colours, a soft tonal tint or a dark ink fill ([docs](https://bitforge-ui.web.app/api/bf-chip-variant))
 - [BfColorScheme](https://bitforge-ui.web.app/ai/reference/bf-color-scheme.md): The colour scheme choice, following the system or forcing light or dark ([docs](https://bitforge-ui.web.app/api/bf-color-scheme))
@@ -176,10 +187,15 @@
 - [BfEmptyStateHeading](https://bitforge-ui.web.app/ai/reference/bf-empty-state-heading.md): The heading level of an empty state title, one for a whole page ([docs](https://bitforge-ui.web.app/api/bf-empty-state-heading))
 - [BfEmptyStateHeadingLevel](https://bitforge-ui.web.app/ai/reference/bf-empty-state-heading-level.md): The heading level of an empty state title, two for a screen or three ([docs](https://bitforge-ui.web.app/api/bf-empty-state-heading-level))
 - [BfEnterKeyHint](https://bitforge-ui.web.app/ai/reference/bf-enter-key-hint.md): The labels a phone keyboard can put on its Enter key ([docs](https://bitforge-ui.web.app/api/bf-enter-key-hint))
+- [BfFadeInDirective](https://bitforge-ui.web.app/ai/reference/bf-fade-in-directive.md): Fades an image in once it has loaded instead of popping in ([docs](https://bitforge-ui.web.app/api/bf-fade-in-directive))
 - [bfFieldControlClass](https://bitforge-ui.web.app/ai/reference/bf-field-control-class.md): The class list that makes a custom control look like a library text field ([docs](https://bitforge-ui.web.app/api/bf-field-control-class))
 - [BfFieldControlState](https://bitforge-ui.web.app/ai/reference/bf-field-control-state.md): The size and state a custom field control is styled for by bfFieldControlClass ([docs](https://bitforge-ui.web.app/api/bf-field-control-state))
 - [BfFieldSize](https://bitforge-ui.web.app/ai/reference/bf-field-size.md): Former name of the shared size scale for text fields, kept until 1.0.0 ([docs](https://bitforge-ui.web.app/api/bf-field-size))
+- [BfFileInputVariant](https://bitforge-ui.web.app/ai/reference/bf-file-input-variant.md): The two looks of a file picker, a compact field or a drop zone ([docs](https://bitforge-ui.web.app/api/bf-file-input-variant))
 - [BfIconButtonVariant](https://bitforge-ui.web.app/ai/reference/bf-icon-button-variant.md): The four visual styles of an icon button, from tonal to plain text ([docs](https://bitforge-ui.web.app/api/bf-icon-button-variant))
+- [BfImageInputShape](https://bitforge-ui.web.app/ai/reference/bf-image-input-shape.md): The two tile shapes of an image picker, a circle or a rounded square ([docs](https://bitforge-ui.web.app/api/bf-image-input-shape))
+- [BfImageTileAspect](https://bitforge-ui.web.app/ai/reference/bf-image-tile-aspect.md): The four aspect ratios of an image tile's picture, square by default ([docs](https://bitforge-ui.web.app/api/bf-image-tile-aspect))
+- [BfImageTileCaptionPlacement](https://bitforge-ui.web.app/ai/reference/bf-image-tile-caption-placement.md): Where an image tile's caption sits, below the picture or over it ([docs](https://bitforge-ui.web.app/api/bf-image-tile-caption-placement))
 - [BfInputAutocapitalize](https://bitforge-ui.web.app/ai/reference/bf-input-autocapitalize.md): A text field's capitalisation setting, a mode or empty to leave it off ([docs](https://bitforge-ui.web.app/api/bf-input-autocapitalize))
 - [BfInputEnterKeyHint](https://bitforge-ui.web.app/ai/reference/bf-input-enter-key-hint.md): A field's Enter key label setting, a label or empty to leave it off ([docs](https://bitforge-ui.web.app/api/bf-input-enter-key-hint))
 - [BfInputInputMode](https://bitforge-ui.web.app/ai/reference/bf-input-input-mode.md): A text field's virtual keyboard setting, a keyboard or empty to leave it off ([docs](https://bitforge-ui.web.app/api/bf-input-input-mode))
@@ -187,11 +203,17 @@
 - [BfInputType](https://bitforge-ui.web.app/ai/reference/bf-input-type.md): The native input types a text field supports, all bound as strings ([docs](https://bitforge-ui.web.app/api/bf-input-type))
 - [BfLabels](https://bitforge-ui.web.app/ai/reference/bf-labels.md): Every built-in user-facing string of the library, one key per string ([docs](https://bitforge-ui.web.app/api/bf-labels))
 - [BfLabelsOverrides](https://bitforge-ui.web.app/ai/reference/bf-labels-overrides.md): The strings provideBfLabels replaces, each one falling back to the parent ([docs](https://bitforge-ui.web.app/api/bf-labels-overrides))
+- [BfMediaCardAspect](https://bitforge-ui.web.app/ai/reference/bf-media-card-aspect.md): The four aspect ratios of a media card's image area, wide to portrait ([docs](https://bitforge-ui.web.app/api/bf-media-card-aspect))
+- [BfMotionListDirective](https://bitforge-ui.web.app/ai/reference/bf-motion-list-directive.md): Glides the items of a list or grid to their new place when it changes ([docs](https://bitforge-ui.web.app/api/bf-motion-list-directive))
 - [BfPageHeaderHeadingLevel](https://bitforge-ui.web.app/ai/reference/bf-page-header-heading-level.md): The heading level of a page header title, one for a page or two ([docs](https://bitforge-ui.web.app/api/bf-page-header-heading-level))
+- [BfPaginationPositionLabel](https://bitforge-ui.web.app/ai/reference/bf-pagination-position-label.md): Function that writes a compact pager's position text, such as "v3 of 7" ([docs](https://bitforge-ui.web.app/api/bf-pagination-position-label))
 - [BfProgressSize](https://bitforge-ui.web.app/ai/reference/bf-progress-size.md): The two track heights of a progress bar, thin and regular ([docs](https://bitforge-ui.web.app/api/bf-progress-size))
 - [BfProgressTone](https://bitforge-ui.web.app/ai/reference/bf-progress-tone.md): The four fill colours of a progress bar, from primary to danger ([docs](https://bitforge-ui.web.app/api/bf-progress-tone))
+- [BfProseDirective](https://bitforge-ui.web.app/ai/reference/bf-prose-directive.md): Styles rendered markdown with the library tokens: headings, lists, code and quotes ([docs](https://bitforge-ui.web.app/api/bf-prose-directive))
 - [BfRadioGroupOrientation](https://bitforge-ui.web.app/ai/reference/bf-radio-group-orientation.md): Whether a radio group stacks its options or sets them in a row ([docs](https://bitforge-ui.web.app/api/bf-radio-group-orientation))
 - [BfRadioOption](https://bitforge-ui.web.app/ai/reference/bf-radio-option.md): One choice of a radio group with its value, label and optional description ([docs](https://bitforge-ui.web.app/api/bf-radio-option))
+- [BfRejectedFile](https://bitforge-ui.web.app/ai/reference/bf-rejected-file.md): A picked or dropped file that broke a rule, with the rule and its message ([docs](https://bitforge-ui.web.app/api/bf-rejected-file))
+- [BfRejectedFileReason](https://bitforge-ui.web.app/ai/reference/bf-rejected-file-reason.md): The rule a refused file broke, its type, its size or the file count ([docs](https://bitforge-ui.web.app/api/bf-rejected-file-reason))
 - [BfSegmentedSize](https://bitforge-ui.web.app/ai/reference/bf-segmented-size.md): Former name of the shared size scale for segmented controls, kept until 1.0.0 ([docs](https://bitforge-ui.web.app/api/bf-segmented-size))
 - [BfSegmentOption](https://bitforge-ui.web.app/ai/reference/bf-segment-option.md): One segment of a segmented control with its value, its label and a disabled flag ([docs](https://bitforge-ui.web.app/api/bf-segment-option))
 - [BfSelectOption](https://bitforge-ui.web.app/ai/reference/bf-select-option.md): One choice of a select with its value, its label and a disabled flag ([docs](https://bitforge-ui.web.app/api/bf-select-option))
@@ -251,6 +273,12 @@
 - [BfDialogService](https://bitforge-ui.web.app/ai/reference/bf-dialog-service.md): Opens modal dialogs and confirm prompts, centred over the page with focus trapped ([docs](https://bitforge-ui.web.app/api/bf-dialog-service))
 - [BfDialogSize](https://bitforge-ui.web.app/ai/reference/bf-dialog-size.md): The dialog width scale from a 24 rem confirm to an edge-to-edge fullscreen dialog ([docs](https://bitforge-ui.web.app/api/bf-dialog-size))
 - [BfDialogTemplateContext](https://bitforge-ui.web.app/ai/reference/bf-dialog-template-context.md): The context a template opened as a dialog receives: its ref and its data ([docs](https://bitforge-ui.web.app/api/bf-dialog-template-context))
+- [BfImageViewerActionsContext](https://bitforge-ui.web.app/ai/reference/bf-image-viewer-actions-context.md): What the viewer's actions template receives: the shown image, its index and the ref ([docs](https://bitforge-ui.web.app/api/bf-image-viewer-actions-context))
+- [BfImageViewerImage](https://bitforge-ui.web.app/ai/reference/bf-image-viewer-image.md): One image the viewer shows: its URL, its name as alternative text and a caption ([docs](https://bitforge-ui.web.app/api/bf-image-viewer-image))
+- [BfImageViewerOptions](https://bitforge-ui.web.app/ai/reference/bf-image-viewer-options.md): Options of an image viewer: its images, the first one, its thumbnail and actions ([docs](https://bitforge-ui.web.app/api/bf-image-viewer-options))
+- [BfImageViewerOrigin](https://bitforge-ui.web.app/ai/reference/bf-image-viewer-origin.md): The thumbnail an image viewer zooms from and back into, or a lookup per image ([docs](https://bitforge-ui.web.app/api/bf-image-viewer-origin))
+- [BfImageViewerRef](https://bitforge-ui.web.app/ai/reference/bf-image-viewer-ref.md): Handle on an open image viewer that steps through its images and closes it ([docs](https://bitforge-ui.web.app/api/bf-image-viewer-ref))
+- [BfImageViewerService](https://bitforge-ui.web.app/ai/reference/bf-image-viewer-service.md): Opens a full-screen image viewer that zooms from a thumbnail and steps through a set ([docs](https://bitforge-ui.web.app/api/bf-image-viewer-service))
 - [BfMenuButtonVariant](https://bitforge-ui.web.app/ai/reference/bf-menu-button-variant.md): The three visual styles of a menu button, matching the button styles ([docs](https://bitforge-ui.web.app/api/bf-menu-button-variant))
 - [BfMenuDividerDirective](https://bitforge-ui.web.app/ai/reference/bf-menu-divider-directive.md): A line between groups of menu items that keyboard focus never lands on ([docs](https://bitforge-ui.web.app/api/bf-menu-divider-directive))
 - [BfMenuGroupDirective](https://bitforge-ui.web.app/ai/reference/bf-menu-group-directive.md): Groups related menu items; radio items in one group exclude each other ([docs](https://bitforge-ui.web.app/api/bf-menu-group-directive))
@@ -296,6 +324,7 @@
 - [OVERLAY_REDUCED_DURATION](https://bitforge-ui.web.app/ai/reference/overlay_reduced_duration.md): The duration of the fade that replaces overlay motion under reduced motion ([docs](https://bitforge-ui.web.app/api/overlay_reduced_duration))
 - [prefersReducedMotion](https://bitforge-ui.web.app/ai/reference/prefers-reduced-motion.md): Tells whether the user asked the system to minimise motion ([docs](https://bitforge-ui.web.app/api/prefers-reduced-motion))
 - [provideBfDesktopToast](https://bitforge-ui.web.app/ai/reference/provide-bf-desktop-toast.md): Sets where desktop toasts appear and how many show at once, app-wide ([docs](https://bitforge-ui.web.app/api/provide-bf-desktop-toast))
+- [provideBfSelect](https://bitforge-ui.web.app/ai/reference/provide-bf-select.md): Makes a stacked table's Sort by select the styled bf-select, app-wide ([docs](https://bitforge-ui.web.app/api/provide-bf-select))
 - [scaleIn](https://bitforge-ui.web.app/ai/reference/scale-in.md): Scales an element up while fading it in, the enter animation of centred dialogs ([docs](https://bitforge-ui.web.app/api/scale-in))
 - [slideDown](https://bitforge-ui.web.app/ai/reference/slide-down.md): Slides an element down out of place, the exit animation of a bottom sheet ([docs](https://bitforge-ui.web.app/api/slide-down))
 - [slideInFromEnd](https://bitforge-ui.web.app/ai/reference/slide-in-from-end.md): Slides an element in from the inline end, the enter animation of a side panel ([docs](https://bitforge-ui.web.app/api/slide-in-from-end))
@@ -412,13 +441,19 @@
 
 - [BfCalendarHarness](https://bitforge-ui.web.app/ai/reference/bf-calendar-harness.md): Test harness for the calendar: reads the month and picks a date by ISO string ([docs](https://bitforge-ui.web.app/api/bf-calendar-harness))
 - [BfChartHarness](https://bitforge-ui.web.app/ai/reference/bf-chart-harness.md): Test harness for the charts: reads the series, toggles one and reads the data table ([docs](https://bitforge-ui.web.app/api/bf-chart-harness))
+- [BfChatComposerHarness](https://bitforge-ui.web.app/ai/reference/bf-chat-composer-harness.md): Test harness for the chat composer: types, sends, stops and reads its state ([docs](https://bitforge-ui.web.app/api/bf-chat-composer-harness))
 - [BfComboboxHarness](https://bitforge-ui.web.app/ai/reference/bf-combobox-harness.md): Test harness for the comboboxes: types, reads and picks options and tags ([docs](https://bitforge-ui.web.app/api/bf-combobox-harness))
 - [BfDateInputHarness](https://bitforge-ui.web.app/ai/reference/bf-date-input-harness.md): Test harness for the date input: types a date or picks one in its calendar ([docs](https://bitforge-ui.web.app/api/bf-date-input-harness))
 - [BfDateTimeInputHarness](https://bitforge-ui.web.app/ai/reference/bf-date-time-input-harness.md): Test harness for the date and time input: types or picks a date and time ([docs](https://bitforge-ui.web.app/api/bf-date-time-input-harness))
 - [BfDesktopToastHarness](https://bitforge-ui.web.app/ai/reference/bf-desktop-toast-harness.md): Test harness for a desktop toast: its message, its action and Escape ([docs](https://bitforge-ui.web.app/api/bf-desktop-toast-harness))
 - [BfDialogHarness](https://bitforge-ui.web.app/ai/reference/bf-dialog-harness.md): Test harness for a dialog: its title, text and role, its buttons and Escape ([docs](https://bitforge-ui.web.app/api/bf-dialog-harness))
+- [BfFileInputHarness](https://bitforge-ui.web.app/ai/reference/bf-file-input-harness.md): Test harness for the file input: drops files and reads the list and rejections ([docs](https://bitforge-ui.web.app/api/bf-file-input-harness))
 - [BfHarnessFilters](https://bitforge-ui.web.app/ai/reference/bf-harness-filters.md): Filters a library harness query by selector, ancestor and the widget label ([docs](https://bitforge-ui.web.app/api/bf-harness-filters))
+- [BfImageInputHarness](https://bitforge-ui.web.app/ai/reference/bf-image-input-harness.md): Test harness for the image input: drops an image on it and reads the preview ([docs](https://bitforge-ui.web.app/api/bf-image-input-harness))
+- [BfImageTileHarness](https://bitforge-ui.web.app/ai/reference/bf-image-tile-harness.md): Test harness for an image tile: its picture state, title, meta, selection and action ([docs](https://bitforge-ui.web.app/api/bf-image-tile-harness))
+- [BfImageViewerHarness](https://bitforge-ui.web.app/ai/reference/bf-image-viewer-harness.md): Test harness for an image viewer: its image, index, caption, steps and close ([docs](https://bitforge-ui.web.app/api/bf-image-viewer-harness))
 - [BfJsdomShimOptions](https://bitforge-ui.web.app/ai/reference/bf-jsdom-shim-options.md): Options of the jsdom shims: the matchMedia stub and its reduced-motion answer ([docs](https://bitforge-ui.web.app/api/bf-jsdom-shim-options))
+- [BfMediaCardHarness](https://bitforge-ui.web.app/ai/reference/bf-media-card-harness.md): Test harness for a media card: its image state, its messages and its selection ([docs](https://bitforge-ui.web.app/api/bf-media-card-harness))
 - [BfMenuButtonHarness](https://bitforge-ui.web.app/ai/reference/bf-menu-button-harness.md): Test harness for a menu button: opens it and hands out the menu it opened ([docs](https://bitforge-ui.web.app/api/bf-menu-button-harness))
 - [BfMenuHarness](https://bitforge-ui.web.app/ai/reference/bf-menu-harness.md): Test harness for a menu: lists its items and clicks one, through submenus ([docs](https://bitforge-ui.web.app/api/bf-menu-harness))
 - [BfMenuItemHarness](https://bitforge-ui.web.app/ai/reference/bf-menu-item-harness.md): Test harness for a menu row: its text, disabled, checked and submenu state ([docs](https://bitforge-ui.web.app/api/bf-menu-item-harness))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bitforgehq/ui",
-  "version": "0.4.0",
+  "version": "0.5.0-next.4",
   "description": "Bitforge UI: Angular 22 widgets (Meadow Sage palette with an indigo default primary to override, Tailwind v4, signals-first) and, from v0.2, a Capacitor app shell.",
   "license": "MIT",
   "repository": {

package/theme.css

@@ -178,6 +178,14 @@
   --ease-ios: cubic-bezier(0.32, 0.72, 0, 1);
   --ease-md: cubic-bezier(0.2, 0, 0, 1);
   --ease-settle: cubic-bezier(0.2, 0.8, 0.3, 1);
+  /* Durations as utilities (duration-fast, duration-base, duration-slow), the same timings the
+     widgets use, so an app's own motion matches the library: fast 150 ms (colours, small
+     state changes, the reduced-motion fade), base 200 ms (size and position: the sidebar,
+     selection indicators, list items), slow 260 ms (overlays enter and leave). They read the
+     :root --bf-duration-* properties below, so redefining those retimes both. */
+  --transition-duration-fast: var(--bf-duration-fast);
+  --transition-duration-base: var(--bf-duration-layout);
+  --transition-duration-slow: var(--bf-duration-overlay);
 
   /* bf-progress indeterminate: a 40 % stripe runs across the track from the inline start (static
      under reduced motion); the -rtl pair runs it the other way under dir="rtl". */
@@ -221,6 +229,57 @@
     }
   }
 
+  /* App lists and grids, with Angular's animate.enter / animate.leave: an item fades and rises in
+     (`animate.enter="motion-safe:animate-item-enter"`) and fades out while it shrinks a little
+     (`animate.leave="motion-safe:animate-item-leave"`); `bfMotionList` on the container glides
+     the others into place. motion-safe: leaves both out under reduced motion. */
+  --animate-item-enter: bf-item-enter var(--bf-duration-layout) var(--ease-settle) both;
+  --animate-item-leave: bf-item-leave var(--bf-duration-fast) var(--ease-md) both;
+  @keyframes bf-item-enter {
+    from {
+      opacity: 0;
+      transform: translateY(8px) scale(0.98);
+    }
+  }
+  @keyframes bf-item-leave {
+    to {
+      opacity: 0;
+      transform: scale(0.96);
+    }
+  }
+
+  /* A field's error message fades in when it appears (and when a held message is revealed after
+     the press ends: `not-[.sr-only]:animate-message-in`). An opacity fade only, so it stays under
+     reduced motion, like the overlays' reduced fade. */
+  --animate-message-in: bf-message-in 150ms var(--ease-md) both;
+  /* bf-tab-panel: the panel a user switches to fades in over the old one's place (behind
+     motion-safe:, so not under reduced motion); never the first panel on load. */
+  --animate-panel-in: bf-message-in 200ms var(--ease-md) both;
+  @keyframes bf-message-in {
+    from {
+      opacity: 0;
+    }
+    to {
+      opacity: 1;
+    }
+  }
+
+  /* bf-chat-message: a message added after the thread's first render rises 4 px and fades in
+     (motion-safe: only), and a streaming reply's caret pulses (static under reduced motion). */
+  --animate-chat-message-in: bf-chat-message-in var(--bf-duration-layout) var(--ease-settle) both;
+  --animate-chat-caret: bf-chat-caret 1s ease-in-out infinite alternate;
+  @keyframes bf-chat-message-in {
+    from {
+      opacity: 0;
+      transform: translateY(4px);
+    }
+  }
+  @keyframes bf-chat-caret {
+    to {
+      opacity: 0.2;
+    }
+  }
+
   /* @bitforgehq/ui/charts enter motion, on the first render and on every data change (the marks
      are re-created): a line draws along its path (pathLength 1, so the dash is the whole line),
      bars grow from the baseline (scale on the fill box, origin at the baseline), areas and
@@ -274,6 +333,7 @@
 :root {
   color-scheme: light; /* native scrollbars and form controls match the light palette */
   --bf-duration-fast: 150ms; /* colour transitions, reduced-motion fade */
+  --bf-duration-layout: 200ms; /* size and position: sidebar width, selection indicators */
   --bf-duration-overlay: 260ms; /* overlays, modal depth */
   --bf-duration-push: 500ms; /* iOS push/pop */
   --bf-z-sticky: 10; /* translucent header */