@bitforgehq/ui 0.3.0 → 0.3.2

package/llms.txt

@@ -1,6 +1,6 @@
 # @bitforgehq/ui
 
-> Bitforge's Angular 22 component library (Meadow Sage design, Tailwind v4, signals-first) and Capacitor app shell.
+> Bitforge's Angular 22 component library (Meadow Sage palette with an indigo default primary to override, Tailwind v4, signals-first) and Capacitor app shell.
 
 - [Guide for agents](https://bitforge-ui.web.app/ai/UI_GUIDE.md)
 
@@ -30,47 +30,77 @@
 - [bf-action-bar](https://bitforge-ui.web.app/ai/components/action-bar.md): Floating pill of contextual actions that appears while items are selected ([docs](https://bitforge-ui.web.app/components/action-bar))
 - [bf-button](https://bitforge-ui.web.app/ai/components/button.md): Pill-shaped action button with five variants, three sizes and a loading state ([docs](https://bitforge-ui.web.app/components/button))
 - [bf-icon-button](https://bitforge-ui.web.app/ai/components/icon-button.md): Round icon-only button for toolbars and rows, with a required accessible label ([docs](https://bitforge-ui.web.app/components/icon-button))
+- [bf-toolbar](https://bitforge-ui.web.app/ai/components/toolbar.md): Dense row of search, filters, view switch, result count and actions ([docs](https://bitforge-ui.web.app/components/toolbar))
 
 ### 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-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))
+- [bf-combobox](https://bitforge-ui.web.app/ai/components/combobox.md): Text field that filters a list of options as you type and picks one ([docs](https://bitforge-ui.web.app/components/combobox))
+- [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-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-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))
 - [bf-toggle](https://bitforge-ui.web.app/ai/components/toggle.md): On/off switch for settings that apply immediately, with Signal Forms binding ([docs](https://bitforge-ui.web.app/components/toggle))
 
 ### Data display
 
 - [bf-avatar](https://bitforge-ui.web.app/ai/components/avatar.md): Round avatar showing a photo or initials, in three sizes and four color variants ([docs](https://bitforge-ui.web.app/components/avatar))
 - [bf-badge](https://bitforge-ui.web.app/ai/components/badge.md): Small status label in semantic tones, or a compact numeric pill for counts ([docs](https://bitforge-ui.web.app/components/badge))
+- [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))
+- [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-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-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))
+- [bf-table](https://bitforge-ui.web.app/ai/components/table.md): Desktop data table with sortable headers, row selection, custom cells and an empty slot ([docs](https://bitforge-ui.web.app/components/table))
 
 ### Feedback
 
 - [bf-alert](https://bitforge-ui.web.app/ai/components/alert.md): Inline status message in four tones with a title and an optional dismiss button ([docs](https://bitforge-ui.web.app/components/alert))
 - [bf-empty-state](https://bitforge-ui.web.app/ai/components/empty-state.md): Placeholder for an empty screen or list with icon, title, message and action ([docs](https://bitforge-ui.web.app/components/empty-state))
+- [bf-skeleton](https://bitforge-ui.web.app/ai/components/skeleton.md): Loading placeholder shaped as text lines, a rectangle or a circle, with a shimmer ([docs](https://bitforge-ui.web.app/components/skeleton))
 - [bf-spinner](https://bitforge-ui.web.app/ai/components/spinner.md): Indeterminate loading spinner in three sizes that inherits its parent's text color ([docs](https://bitforge-ui.web.app/components/spinner))
 
 ### Navigation
 
+- [bf-app-frame](https://bitforge-ui.web.app/ai/components/app-frame.md): Desktop app frame with skip link, sticky sidebar, narrow header and main content ([docs](https://bitforge-ui.web.app/components/app-frame))
 - [bf-back-button](https://bitforge-ui.web.app/ai/components/back-button.md): Header back button that pops the page stack or falls back to a default route ([docs](https://bitforge-ui.web.app/components/back-button))
+- [bf-breadcrumb](https://bitforge-ui.web.app/ai/components/breadcrumb.md): Desktop breadcrumb trail of links to the current page, with optional collapsing ([docs](https://bitforge-ui.web.app/components/breadcrumb))
+- [li[bfBreadcrumbItem]](https://bitforge-ui.web.app/ai/components/breadcrumb-item.md): One level of a breadcrumb trail: a link, or the current page as text ([docs](https://bitforge-ui.web.app/components/breadcrumb-item))
 - [bf-content](https://bitforge-ui.web.app/ai/components/content.md): Page's single scroll container that keeps focused fields clear of the soft keyboard ([docs](https://bitforge-ui.web.app/components/content))
 - [bf-header](https://bitforge-ui.web.app/ai/components/header.md): Page header toolbar with a large title that collapses into the toolbar on scroll ([docs](https://bitforge-ui.web.app/components/header))
+- [bf-nav-group](https://bitforge-ui.web.app/ai/components/nav-group.md): A titled group of sidebar links with a small heading that names it ([docs](https://bitforge-ui.web.app/components/nav-group))
+- [a[bfNavItem]](https://bitforge-ui.web.app/ai/components/nav-item.md): Navigation link for a sidebar or top nav, with icon, label and count ([docs](https://bitforge-ui.web.app/components/nav-item))
 - [bf-page](https://bitforge-ui.web.app/ai/components/page.md): Frame for one stacked mobile screen that supplies lifecycle events and shared page state ([docs](https://bitforge-ui.web.app/components/page))
+- [bf-page-header](https://bitforge-ui.web.app/ai/components/page-header.md): Desktop page header with breadcrumb, title, subtitle, badges and a row of actions ([docs](https://bitforge-ui.web.app/components/page-header))
+- [bf-pagination](https://bitforge-ui.web.app/ai/components/pagination.md): Previous, next and numbered page buttons for a long list or table ([docs](https://bitforge-ui.web.app/components/pagination))
 - [bf-refresher](https://bitforge-ui.web.app/ai/components/refresher.md): Pull-to-refresh indicator with haptic feedback, native iOS bounce and an Android-style pull ([docs](https://bitforge-ui.web.app/components/refresher))
+- [bf-sidebar](https://bitforge-ui.web.app/ai/components/sidebar.md): Vertical app navigation with brand, grouped links, footer and an icon rail mode ([docs](https://bitforge-ui.web.app/components/sidebar))
+- [bf-sidebar-toggle](https://bitforge-ui.web.app/ai/components/sidebar-toggle.md): Icon button inside a sidebar that collapses it to an icon rail and back ([docs](https://bitforge-ui.web.app/components/sidebar-toggle))
 - [bf-stack-outlet](https://bitforge-ui.web.app/ai/components/stack-outlet.md): Router outlet keeping a live page stack with slide transitions and iOS swipe back ([docs](https://bitforge-ui.web.app/components/stack-outlet))
 - [bf-tab](https://bitforge-ui.web.app/ai/components/tab.md): One tab bar destination with an icon, a label and an optional count badge ([docs](https://bitforge-ui.web.app/components/tab))
 - [bf-tab-bar](https://bitforge-ui.web.app/ai/components/tab-bar.md): Floating pill tab bar for mobile apps with arrow-key selection and count badges ([docs](https://bitforge-ui.web.app/components/tab-bar))
+- [bf-tab-group](https://bitforge-ui.web.app/ai/components/tab-group.md): In-page tabs that switch between content panels, with keyboard navigation and badges ([docs](https://bitforge-ui.web.app/components/tab-group))
+- [bf-tab-panel](https://bitforge-ui.web.app/ai/components/tab-panel.md): One tab of a tab group with its label, badge, icon and lazy content ([docs](https://bitforge-ui.web.app/components/tab-panel))
 - [bf-tabs](https://bitforge-ui.web.app/ai/components/tabs.md): Tabs page with one navigation stack per tab, wiring the tab bar to the router ([docs](https://bitforge-ui.web.app/components/tabs))
+- [bf-top-nav](https://bitforge-ui.web.app/ai/components/top-nav.md): Horizontal app navigation, a wrapping row of links for apps with few sections ([docs](https://bitforge-ui.web.app/components/top-nav))
 
 ### Overlays
 
@@ -81,8 +111,12 @@
 - [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))
+- [bf-popover](https://bitforge-ui.web.app/ai/components/popover.md): Anchored, non-modal panel for filters, details or a small form ([docs](https://bitforge-ui.web.app/components/popover))
 - [bf-sheet](https://bitforge-ui.web.app/ai/components/sheet.md): Bottom sheet with snap points, drag to dismiss and a backdrop ([docs](https://bitforge-ui.web.app/components/sheet))
+- [bf-side-panel](https://bitforge-ui.web.app/ai/components/side-panel.md): Desktop panel sliding in from the end edge, with a title, body and footer actions ([docs](https://bitforge-ui.web.app/components/side-panel))
+- [bf-theme-menu-button](https://bitforge-ui.web.app/ai/components/theme-menu-button.md): Menu button with System, Light and Dark radio items bound to the colour scheme ([docs](https://bitforge-ui.web.app/components/theme-menu-button))
 - [bf-toast](https://bitforge-ui.web.app/ai/components/toast.md): Passive status pill with an optional action that never steals focus ([docs](https://bitforge-ui.web.app/components/toast))
+- [bf-tooltip](https://bitforge-ui.web.app/ai/components/tooltip.md): Short hint beside a control on hover or keyboard focus, for desktop ([docs](https://bitforge-ui.web.app/components/tooltip))
 
 ### Icons
 
@@ -100,29 +134,41 @@
 
 ### @bitforgehq/ui
 
+- [BF_COLOR_SCHEME_STORAGE](https://bitforge-ui.web.app/ai/reference/bf_color_scheme_storage.md): Injection token for the store that keeps the colour scheme choice between visits ([docs](https://bitforge-ui.web.app/api/bf_color_scheme_storage))
 - [BF_DEFAULT_LABELS](https://bitforge-ui.web.app/ai/reference/bf_default_labels.md): The library's built-in English strings, the labels every widget starts from ([docs](https://bitforge-ui.web.app/api/bf_default_labels))
 - [BF_DEFAULT_VALUES](https://bitforge-ui.web.app/ai/reference/bf_default_values.md): The library's built-in widget defaults, the compact md step everywhere ([docs](https://bitforge-ui.web.app/api/bf_default_values))
 - [BF_DEFAULTS](https://bitforge-ui.web.app/ai/reference/bf_defaults.md): Injection token holding the widget defaults in effect for an injector ([docs](https://bitforge-ui.web.app/api/bf_defaults))
 - [BF_LABELS](https://bitforge-ui.web.app/ai/reference/bf_labels.md): Injection token holding the user-facing strings in effect for an injector ([docs](https://bitforge-ui.web.app/api/bf_labels))
+- [BF_SIDEBAR_STATE_STORAGE](https://bitforge-ui.web.app/ai/reference/bf_sidebar_state_storage.md): Injection token for the store that keeps the collapsed sidebar between visits ([docs](https://bitforge-ui.web.app/api/bf_sidebar_state_storage))
 - [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))
 - [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))
+- [BfAppFrameContentWidth](https://bitforge-ui.web.app/ai/reference/bf-app-frame-content-width.md): The maximum width of an app frame's content column, from medium to full ([docs](https://bitforge-ui.web.app/api/bf-app-frame-content-width))
 - [BfAutocapitalize](https://bitforge-ui.web.app/ai/reference/bf-autocapitalize.md): How a phone keyboard capitalises the text typed into a field ([docs](https://bitforge-ui.web.app/api/bf-autocapitalize))
 - [BfAvatarSize](https://bitforge-ui.web.app/ai/reference/bf-avatar-size.md): The three sizes of an avatar, from a list row to a profile header ([docs](https://bitforge-ui.web.app/api/bf-avatar-size))
 - [BfAvatarVariant](https://bitforge-ui.web.app/ai/reference/bf-avatar-variant.md): The four colour schemes of an avatar behind its initials or icon ([docs](https://bitforge-ui.web.app/api/bf-avatar-variant))
+- [BfBadgeAppearance](https://bitforge-ui.web.app/ai/reference/bf-badge-appearance.md): Every badge tone, the five variants plus the informational info tone ([docs](https://bitforge-ui.web.app/api/bf-badge-appearance))
 - [BfBadgeVariant](https://bitforge-ui.web.app/ai/reference/bf-badge-variant.md): The five tones of a badge, from neutral counts to danger states ([docs](https://bitforge-ui.web.app/api/bf-badge-variant))
+- [BfButtonAppearance](https://bitforge-ui.web.app/ai/reference/bf-button-appearance.md): Every button style, the five variants plus the quiet neutral ghost ([docs](https://bitforge-ui.web.app/api/bf-button-appearance))
 - [BfButtonSize](https://bitforge-ui.web.app/ai/reference/bf-button-size.md): Former name of the shared size scale for buttons, kept until 1.0.0 ([docs](https://bitforge-ui.web.app/api/bf-button-size))
 - [BfButtonType](https://bitforge-ui.web.app/ai/reference/bf-button-type.md): The native button types, for a plain action, a form submit or reset ([docs](https://bitforge-ui.web.app/api/bf-button-type))
 - [BfButtonVariant](https://bitforge-ui.web.app/ai/reference/bf-button-variant.md): The five visual styles of a button, from filled primary to plain text ([docs](https://bitforge-ui.web.app/api/bf-button-variant))
+- [BfCalendarDisabledDate](https://bitforge-ui.web.app/ai/reference/bf-calendar-disabled-date.md): A function that marks an ISO date as not pickable in a calendar ([docs](https://bitforge-ui.web.app/api/bf-calendar-disabled-date))
+- [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))
 - [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))
+- [BfColorSchemeService](https://bitforge-ui.web.app/ai/reference/bf-color-scheme-service.md): The app colour scheme choice and dark state, applied to html and stored ([docs](https://bitforge-ui.web.app/api/bf-color-scheme-service))
 - [BfCompareWith](https://bitforge-ui.web.app/ai/reference/bf-compare-with.md): Equality of choice values, for options that are objects rather than primitives ([docs](https://bitforge-ui.web.app/api/bf-compare-with))
 - [BfDefaults](https://bitforge-ui.web.app/ai/reference/bf-defaults.md): The default height steps of text fields and of actions and choice controls ([docs](https://bitforge-ui.web.app/api/bf-defaults))
 - [BfDefaultsOptions](https://bitforge-ui.web.app/ai/reference/bf-defaults-options.md): The size steps provideBfDefaults sets, each one falling back to the parent ([docs](https://bitforge-ui.web.app/api/bf-defaults-options))
+- [BfDescriptionListLayout](https://bitforge-ui.web.app/ai/reference/bf-description-list-layout.md): The two description list layouts, divided label-value rows or a grid of tiles ([docs](https://bitforge-ui.web.app/api/bf-description-list-layout))
+- [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))
 - [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))
@@ -136,6 +182,7 @@
 - [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))
+- [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))
 - [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))
 - [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))
@@ -143,16 +190,32 @@
 - [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))
+- [BfSidebarStateService](https://bitforge-ui.web.app/ai/reference/bf-sidebar-state-service.md): The sidebar's collapsed state, kept in storage between visits of the app ([docs](https://bitforge-ui.web.app/api/bf-sidebar-state-service))
 - [BfSize](https://bitforge-ui.web.app/ai/reference/bf-size.md): The three height steps every sized field and control shares ([docs](https://bitforge-ui.web.app/api/bf-size))
+- [BfSkeletonShape](https://bitforge-ui.web.app/ai/reference/bf-skeleton-shape.md): The three skeleton shapes, text lines, a rectangle or a circle ([docs](https://bitforge-ui.web.app/api/bf-skeleton-shape))
 - [BfSpinnerSize](https://bitforge-ui.web.app/ai/reference/bf-spinner-size.md): The three spinner diameters, from inline text to a page loading state ([docs](https://bitforge-ui.web.app/api/bf-spinner-size))
+- [BfStatAppearance](https://bitforge-ui.web.app/ai/reference/bf-stat-appearance.md): The three stat surfaces, plain, an outlined card or a sunken tile ([docs](https://bitforge-ui.web.app/api/bf-stat-appearance))
+- [BfStatTrend](https://bitforge-ui.web.app/ai/reference/bf-stat-trend.md): The three directions of a stat's delta pill, up, down or no change ([docs](https://bitforge-ui.web.app/api/bf-stat-trend))
+- [BfStatTrendIntent](https://bitforge-ui.web.app/ai/reference/bf-stat-trend-intent.md): Whether a rising or a falling figure is the good news for a stat ([docs](https://bitforge-ui.web.app/api/bf-stat-trend-intent))
+- [BfStatVariant](https://bitforge-ui.web.app/ai/reference/bf-stat-variant.md): The two stat surfaces, plain on its container or an outlined card tile ([docs](https://bitforge-ui.web.app/api/bf-stat-variant))
 - [BfTabBarController](https://bitforge-ui.web.app/ai/reference/bf-tab-bar-controller.md): The state a parent that drives a projected tab bar gives it to derive from ([docs](https://bitforge-ui.web.app/api/bf-tab-bar-controller))
 - [BfTabBarHost](https://bitforge-ui.web.app/ai/reference/bf-tab-bar-host.md): What each tab reads from its tab bar: the selection, tab stop and link mode ([docs](https://bitforge-ui.web.app/api/bf-tab-bar-host))
+- [BfTableAlign](https://bitforge-ui.web.app/ai/reference/bf-table-align.md): The inline alignment of a table column, start for text or end for numbers ([docs](https://bitforge-ui.web.app/api/bf-table-align))
+- [BfTableCellContext](https://bitforge-ui.web.app/ai/reference/bf-table-cell-context.md): The row and its index that a custom table cell template receives ([docs](https://bitforge-ui.web.app/api/bf-table-cell-context))
+- [BfTableCellDirective](https://bitforge-ui.web.app/ai/reference/bf-table-cell-directive.md): Custom template for the cells of one table column, with the row typed ([docs](https://bitforge-ui.web.app/api/bf-table-cell-directive))
+- [BfTableColumn](https://bitforge-ui.web.app/ai/reference/bf-table-column.md): One table column with its row key, header label, sorting and alignment ([docs](https://bitforge-ui.web.app/api/bf-table-column))
+- [BfTableRowKey](https://bitforge-ui.web.app/ai/reference/bf-table-row-key.md): Function that returns the unique string key of one table row ([docs](https://bitforge-ui.web.app/api/bf-table-row-key))
+- [BfTableSort](https://bitforge-ui.web.app/ai/reference/bf-table-sort.md): The column key and direction a table is sorted by, set by its headers ([docs](https://bitforge-ui.web.app/api/bf-table-sort))
+- [BfTableSortDirection](https://bitforge-ui.web.app/ai/reference/bf-table-sort-direction.md): The direction a sorted table column is in, ascending or descending ([docs](https://bitforge-ui.web.app/api/bf-table-sort-direction))
+- [BfTableStack](https://bitforge-ui.web.app/ai/reference/bf-table-stack.md): When a table stacks its rows into cards: never, when narrow, or under touch ([docs](https://bitforge-ui.web.app/api/bf-table-stack))
 - [BfTabLinks](https://bitforge-ui.web.app/ai/reference/bf-tab-links.md): The URLs a router-aware parent gives a tab bar to render its tabs as links ([docs](https://bitforge-ui.web.app/api/bf-tab-links))
 - [BfToggleLabelPosition](https://bitforge-ui.web.app/ai/reference/bf-toggle-label-position.md): Whether a toggle's label sits after or before its switch ([docs](https://bitforge-ui.web.app/api/bf-toggle-label-position))
 - [bfValidationMessage](https://bitforge-ui.web.app/ai/reference/bf-validation-message.md): Turns one validation error into the text a form field shows under it ([docs](https://bitforge-ui.web.app/api/bf-validation-message))
 - [BfValidationMessages](https://bitforge-ui.web.app/ai/reference/bf-validation-messages.md): The default error text of each validator kind, shown under a form field ([docs](https://bitforge-ui.web.app/api/bf-validation-messages))
+- [provideBfColorScheme](https://bitforge-ui.web.app/ai/reference/provide-bf-color-scheme.md): Applies the stored colour scheme choice to html, for desktop web apps ([docs](https://bitforge-ui.web.app/api/provide-bf-color-scheme))
 - [provideBfDefaults](https://bitforge-ui.web.app/ai/reference/provide-bf-defaults.md): Sets the default field and control sizes for an app or a sub-tree ([docs](https://bitforge-ui.web.app/api/provide-bf-defaults))
 - [provideBfLabels](https://bitforge-ui.web.app/ai/reference/provide-bf-labels.md): Replaces built-in strings for an app or a sub-tree, such as a translation ([docs](https://bitforge-ui.web.app/api/provide-bf-labels))
+- [provideBfSidebarState](https://bitforge-ui.web.app/ai/reference/provide-bf-sidebar-state.md): Remembers the collapsed sidebar between visits, for desktop web apps ([docs](https://bitforge-ui.web.app/api/provide-bf-sidebar-state))
 
 ### @bitforgehq/ui/overlay
 
@@ -160,11 +223,16 @@
 - [BF_DIALOG_DATA](https://bitforge-ui.web.app/ai/reference/bf_dialog_data.md): Injection token carrying the data a dialog was opened with, for its content ([docs](https://bitforge-ui.web.app/api/bf_dialog_data))
 - [BF_OVERLAY_DATA](https://bitforge-ui.web.app/ai/reference/bf_overlay_data.md): Injection token carrying the data an overlay was opened with, for its content ([docs](https://bitforge-ui.web.app/api/bf_overlay_data))
 - [BF_OVERLAY_HOST](https://bitforge-ui.web.app/ai/reference/bf_overlay_host.md): Optional injection token through which a host shell plugs into the overlay core ([docs](https://bitforge-ui.web.app/api/bf_overlay_host))
+- [BF_SIDE_PANEL_DATA](https://bitforge-ui.web.app/ai/reference/bf_side_panel_data.md): Injection token carrying the data a side panel was opened with, for its content ([docs](https://bitforge-ui.web.app/api/bf_side_panel_data))
+- [BfComboboxFilter](https://bitforge-ui.web.app/ai/reference/bf-combobox-filter.md): Decides whether a combobox option matches the text typed into the field ([docs](https://bitforge-ui.web.app/api/bf-combobox-filter))
+- [BfComboboxOption](https://bitforge-ui.web.app/ai/reference/bf-combobox-option.md): One combobox choice with its value, label, description, group and disabled flag ([docs](https://bitforge-ui.web.app/api/bf-combobox-option))
 - [BfComponentOverlayRef](https://bitforge-ui.web.app/ai/reference/bf-component-overlay-ref.md): Overlay handle whose content is a component, with access to its ComponentRef ([docs](https://bitforge-ui.web.app/api/bf-component-overlay-ref))
 - [BfConfirmButton](https://bitforge-ui.web.app/ai/reference/bf-confirm-button.md): One button of a confirm dialog: its answer, its label and its role ([docs](https://bitforge-ui.web.app/api/bf-confirm-button))
 - [BfConfirmButtonRole](https://bitforge-ui.web.app/ai/reference/bf-confirm-button-role.md): The role of a confirm dialog button, the cancel answer or a destructive action ([docs](https://bitforge-ui.web.app/api/bf-confirm-button-role))
 - [BfConfirmOptions](https://bitforge-ui.web.app/ai/reference/bf-confirm-options.md): Options of a confirm dialog: its title, message, buttons and width ([docs](https://bitforge-ui.web.app/api/bf-confirm-options))
 - [BfConfirmSize](https://bitforge-ui.web.app/ai/reference/bf-confirm-size.md): The two widths a confirm dialog comes in, small or medium ([docs](https://bitforge-ui.web.app/api/bf-confirm-size))
+- [BfDateInputPicker](https://bitforge-ui.web.app/ai/reference/bf-date-input-picker.md): Whether a date input offers a calendar popover besides typing ([docs](https://bitforge-ui.web.app/api/bf-date-input-picker))
+- [BfDateTimeInputPicker](https://bitforge-ui.web.app/ai/reference/bf-date-time-input-picker.md): Whether a date and time input offers a calendar and time list popover ([docs](https://bitforge-ui.web.app/api/bf-date-time-input-picker))
 - [BfDesktopToastConfig](https://bitforge-ui.web.app/ai/reference/bf-desktop-toast-config.md): App-wide settings of desktop toasts: where they sit and how many show at once ([docs](https://bitforge-ui.web.app/api/bf-desktop-toast-config))
 - [BfDesktopToastOptions](https://bitforge-ui.web.app/ai/reference/bf-desktop-toast-options.md): Options of one desktop toast: its message, an action and its duration ([docs](https://bitforge-ui.web.app/api/bf-desktop-toast-options))
 - [BfDesktopToastPosition](https://bitforge-ui.web.app/ai/reference/bf-desktop-toast-position.md): The viewport corners and edges a desktop toast stack can anchor to ([docs](https://bitforge-ui.web.app/api/bf-desktop-toast-position))
@@ -187,6 +255,7 @@
 - [BfOverlayController](https://bitforge-ui.web.app/ai/reference/bf-overlay-controller.md): What the overlay service does for a ref: close it and re-apply its position ([docs](https://bitforge-ui.web.app/api/bf-overlay-controller))
 - [BfOverlayHost](https://bitforge-ui.web.app/ai/reference/bf-overlay-host.md): What a host shell tells the overlay core: back handling and document scroll ([docs](https://bitforge-ui.web.app/api/bf-overlay-host))
 - [BfOverlayOptions](https://bitforge-ui.web.app/ai/reference/bf-overlay-options.md): Options of an overlay: its data, backdrop, focus, dismissal, position and motion ([docs](https://bitforge-ui.web.app/api/bf-overlay-options))
+- [BfOverlayPlacement](https://bitforge-ui.web.app/ai/reference/bf-overlay-placement.md): Where an overlay panel sits: a viewport position or full height at the end ([docs](https://bitforge-ui.web.app/api/bf-overlay-placement))
 - [BfOverlayPosition](https://bitforge-ui.web.app/ai/reference/bf-overlay-position.md): Where an overlay panel sits in the viewport: bottom, centre, top or fullscreen ([docs](https://bitforge-ui.web.app/api/bf-overlay-position))
 - [BfOverlayRef](https://bitforge-ui.web.app/ai/reference/bf-overlay-ref.md): Handle on an open overlay that closes it and resolves with its result ([docs](https://bitforge-ui.web.app/api/bf-overlay-ref))
 - [BfOverlayRole](https://bitforge-ui.web.app/ai/reference/bf-overlay-role.md): The role an overlay panel carries: a dialog, an alert dialog or a status ([docs](https://bitforge-ui.web.app/api/bf-overlay-role))
@@ -194,11 +263,22 @@
 - [BfOverlayStack](https://bitforge-ui.web.app/ai/reference/bf-overlay-stack.md): Keeps the open overlays in order and makes the page behind them inert ([docs](https://bitforge-ui.web.app/api/bf-overlay-stack))
 - [BfOverlayStackOptions](https://bitforge-ui.web.app/ai/reference/bf-overlay-stack-options.md): How an overlay takes part in the stack: its back priority and modal depth ([docs](https://bitforge-ui.web.app/api/bf-overlay-stack-options))
 - [BfOverlayTemplateContext](https://bitforge-ui.web.app/ai/reference/bf-overlay-template-context.md): The context a template opened as an overlay receives: its ref and data ([docs](https://bitforge-ui.web.app/api/bf-overlay-template-context))
+- [BfPopoverPlacement](https://bitforge-ui.web.app/ai/reference/bf-popover-placement.md): Where a popover opens against its trigger, above or below, at either end ([docs](https://bitforge-ui.web.app/api/bf-popover-placement))
+- [BfPopoverTriggerDirective](https://bitforge-ui.web.app/ai/reference/bf-popover-trigger-directive.md): Opens an anchored, non-modal popover panel from any element or button ([docs](https://bitforge-ui.web.app/api/bf-popover-trigger-directive))
+- [BfSidePanelConfig](https://bitforge-ui.web.app/ai/reference/bf-side-panel-config.md): Options of a side panel: its data, width, modality, name and injector ([docs](https://bitforge-ui.web.app/api/bf-side-panel-config))
+- [BfSidePanelRef](https://bitforge-ui.web.app/ai/reference/bf-side-panel-ref.md): Handle on an open side panel that closes it and resolves with its result ([docs](https://bitforge-ui.web.app/api/bf-side-panel-ref))
+- [BfSidePanelService](https://bitforge-ui.web.app/ai/reference/bf-side-panel-service.md): Opens a full-height panel from the end edge, modal or beside the page ([docs](https://bitforge-ui.web.app/api/bf-side-panel-service))
+- [BfSidePanelTemplateContext](https://bitforge-ui.web.app/ai/reference/bf-side-panel-template-context.md): The context a template opened as a side panel receives: its ref and its data ([docs](https://bitforge-ui.web.app/api/bf-side-panel-template-context))
+- [BfSidePanelWidth](https://bitforge-ui.web.app/ai/reference/bf-side-panel-width.md): The side panel widths, from a 360 px detail list to a 640 px form ([docs](https://bitforge-ui.web.app/api/bf-side-panel-width))
 - [BfStackedOverlay](https://bitforge-ui.web.app/ai/reference/bf-stacked-overlay.md): What the overlay stack needs of an overlay: a way to close it ([docs](https://bitforge-ui.web.app/api/bf-stacked-overlay))
+- [BfTimeInputHourCycle](https://bitforge-ui.web.app/ai/reference/bf-time-input-hour-cycle.md): A twelve-hour clock with AM and PM, or a twenty-four-hour clock ([docs](https://bitforge-ui.web.app/api/bf-time-input-hour-cycle))
+- [BfTimeInputPicker](https://bitforge-ui.web.app/ai/reference/bf-time-input-picker.md): Whether a time input offers a popover list of times besides typing ([docs](https://bitforge-ui.web.app/api/bf-time-input-picker))
 - [BfToastAction](https://bitforge-ui.web.app/ai/reference/bf-toast-action.md): The action button of a toast: its label and what it runs when clicked ([docs](https://bitforge-ui.web.app/api/bf-toast-action))
 - [BfToastController](https://bitforge-ui.web.app/ai/reference/bf-toast-controller.md): What the toast queue does for a toast ref: dismiss the toast now ([docs](https://bitforge-ui.web.app/api/bf-toast-controller))
 - [BfToastDismissReason](https://bitforge-ui.web.app/ai/reference/bf-toast-dismiss-reason.md): Why a toast ended: its time ran out, its action fired or it was dismissed ([docs](https://bitforge-ui.web.app/api/bf-toast-dismiss-reason))
 - [BfToastRef](https://bitforge-ui.web.app/ai/reference/bf-toast-ref.md): Handle on a shown or queued toast that dismisses it and reports why it ended ([docs](https://bitforge-ui.web.app/api/bf-toast-ref))
+- [BfTooltipDirective](https://bitforge-ui.web.app/ai/reference/bf-tooltip-directive.md): Adds a hover and keyboard-focus tooltip to any control on desktop ([docs](https://bitforge-ui.web.app/api/bf-tooltip-directive))
+- [BfTooltipPlacement](https://bitforge-ui.web.app/ai/reference/bf-tooltip-placement.md): Which side of its element a tooltip sits on: top, bottom, start or end ([docs](https://bitforge-ui.web.app/api/bf-tooltip-placement))
 - [fadeDown](https://bitforge-ui.web.app/ai/reference/fade-down.md): Fades an element out while it sinks, the reverse of the fadeUp animation ([docs](https://bitforge-ui.web.app/api/fade-down))
 - [fadeIn](https://bitforge-ui.web.app/ai/reference/fade-in.md): Fades an element in, the default enter animation of an overlay ([docs](https://bitforge-ui.web.app/api/fade-in))
 - [fadeOut](https://bitforge-ui.web.app/ai/reference/fade-out.md): Fades an element out, the default exit animation of an overlay ([docs](https://bitforge-ui.web.app/api/fade-out))
@@ -210,6 +290,8 @@
 - [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))
 - [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))
+- [slideOutToEnd](https://bitforge-ui.web.app/ai/reference/slide-out-to-end.md): Slides an element out past the inline end, the exit animation of a side panel ([docs](https://bitforge-ui.web.app/api/slide-out-to-end))
 - [slideUp](https://bitforge-ui.web.app/ai/reference/slide-up.md): Slides an element up into place, the enter animation of a bottom sheet ([docs](https://bitforge-ui.web.app/api/slide-up))
 
 ### @bitforgehq/ui/icons
@@ -308,8 +390,23 @@
 - [shouldCompletePop](https://bitforge-ui.web.app/ai/reference/should-complete-pop.md): Decides whether a released swipe-back completes the pop or settles back ([docs](https://bitforge-ui.web.app/api/should-complete-pop))
 - [withBfShellRouting](https://bitforge-ui.web.app/ai/reference/with-bf-shell-routing.md): The router setting the mobile shell's stack needs, passed to provideRouter ([docs](https://bitforge-ui.web.app/api/with-bf-shell-routing))
 
+### @bitforgehq/ui/charts
+
+- [BfBarChartOrientation](https://bitforge-ui.web.app/ai/reference/bf-bar-chart-orientation.md): The two bar directions, vertical columns or horizontal bars ([docs](https://bitforge-ui.web.app/api/bf-bar-chart-orientation))
+- [BfChartCardHeadingLevel](https://bitforge-ui.web.app/ai/reference/bf-chart-card-heading-level.md): Heading level of a chart card title, two on a page or three inside ([docs](https://bitforge-ui.web.app/api/bf-chart-card-heading-level))
+- [BfChartCurve](https://bitforge-ui.web.app/ai/reference/bf-chart-curve.md): The two line shapes, straight segments or a smooth monotone curve ([docs](https://bitforge-ui.web.app/api/bf-chart-curve))
+- [BfChartLegendPosition](https://bitforge-ui.web.app/ai/reference/bf-chart-legend-position.md): The legend positions of a chart, above or below the plot, or none ([docs](https://bitforge-ui.web.app/api/bf-chart-legend-position))
+- [BfChartSeries](https://bitforge-ui.web.app/ai/reference/bf-chart-series.md): One named series of chart values, one per category, null for a gap ([docs](https://bitforge-ui.web.app/api/bf-chart-series))
+- [BfChartValueFormat](https://bitforge-ui.web.app/ai/reference/bf-chart-value-format.md): Function that formats one chart value for axes, tooltips and the table ([docs](https://bitforge-ui.web.app/api/bf-chart-value-format))
+- [BfDonutSlice](https://bitforge-ui.web.app/ai/reference/bf-donut-slice.md): One labelled slice of a donut chart with its value ([docs](https://bitforge-ui.web.app/api/bf-donut-slice))
+
 ### @bitforgehq/ui/testing
 
+- [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))
+- [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))
 - [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))
@@ -317,10 +414,18 @@
 - [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))
+- [BfPaginationHarness](https://bitforge-ui.web.app/ai/reference/bf-pagination-harness.md): Test harness for pagination: reads the current page and moves between pages ([docs](https://bitforge-ui.web.app/api/bf-pagination-harness))
+- [BfPopoverHarness](https://bitforge-ui.web.app/ai/reference/bf-popover-harness.md): Test harness for a popover: opens and closes it and reads its panel ([docs](https://bitforge-ui.web.app/api/bf-popover-harness))
 - [BfRadioGroupHarness](https://bitforge-ui.web.app/ai/reference/bf-radio-group-harness.md): Test harness for the radio group: reads its options and selects one by label ([docs](https://bitforge-ui.web.app/api/bf-radio-group-harness))
 - [BfSegmentedHarness](https://bitforge-ui.web.app/ai/reference/bf-segmented-harness.md): Test harness for the segmented control: reads its segments and selects one ([docs](https://bitforge-ui.web.app/api/bf-segmented-harness))
 - [BfSelectHarness](https://bitforge-ui.web.app/ai/reference/bf-select-harness.md): Test harness for the select: reads its label and options and picks one ([docs](https://bitforge-ui.web.app/api/bf-select-harness))
+- [BfSidebarToggleHarness](https://bitforge-ui.web.app/ai/reference/bf-sidebar-toggle-harness.md): Test harness for a sidebar toggle: reads and flips the collapsed sidebar ([docs](https://bitforge-ui.web.app/api/bf-sidebar-toggle-harness))
+- [BfSidePanelHarness](https://bitforge-ui.web.app/ai/reference/bf-side-panel-harness.md): Test harness for a side panel: its title, its close button and its state ([docs](https://bitforge-ui.web.app/api/bf-side-panel-harness))
+- [BfTabGroupHarness](https://bitforge-ui.web.app/ai/reference/bf-tab-group-harness.md): Test harness for the tab group: reads its tabs and panel and selects a tab ([docs](https://bitforge-ui.web.app/api/bf-tab-group-harness))
+- [BfTableHarness](https://bitforge-ui.web.app/ai/reference/bf-table-harness.md): Test harness for the data table: reads rows and cells, sorts and selects rows ([docs](https://bitforge-ui.web.app/api/bf-table-harness))
 - [BfTestingOptions](https://bitforge-ui.web.app/ai/reference/bf-testing-options.md): Options of the test providers: the size defaults and labels a spec runs with ([docs](https://bitforge-ui.web.app/api/bf-testing-options))
+- [BfTimeInputHarness](https://bitforge-ui.web.app/ai/reference/bf-time-input-harness.md): Test harness for the time input: types a time or picks one from its list ([docs](https://bitforge-ui.web.app/api/bf-time-input-harness))
+- [BfTooltipHarness](https://bitforge-ui.web.app/ai/reference/bf-tooltip-harness.md): Test harness for a tooltip: shows it, reads its text and whether it shows ([docs](https://bitforge-ui.web.app/api/bf-tooltip-harness))
 - [installBfJsdomShims](https://bitforge-ui.web.app/ai/reference/install-bf-jsdom-shims.md): Installs the browser APIs jsdom lacks and the library needs, only where missing ([docs](https://bitforge-ui.web.app/api/install-bf-jsdom-shims))
 - [provideBfTesting](https://bitforge-ui.web.app/ai/reference/provide-bf-testing.md): Test providers for the widgets and overlays, with document cleanup after each test ([docs](https://bitforge-ui.web.app/api/provide-bf-testing))
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@bitforgehq/ui",
-  "version": "0.3.0",
-  "description": "Bitforge UI: Angular 22 widgets (Meadow Sage design, Tailwind v4, signals-first) and, from v0.2, a Capacitor app shell.",
+  "version": "0.3.2",
+  "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": {
     "type": "git",
@@ -12,7 +12,7 @@
     "provenance": false
   },
   "bin": {
-    "bf-ui": "./bin/bf-ui.js"
+    "bf-ui": "bin/bf-ui.js"
   },
   "peerDependencies": {
     "@angular/cdk": "^22.0.0",
@@ -67,6 +67,10 @@
       "types": "./types/bitforgehq-ui.d.ts",
       "default": "./fesm2022/bitforgehq-ui.mjs"
     },
+    "./charts": {
+      "types": "./types/bitforgehq-ui-charts.d.ts",
+      "default": "./fesm2022/bitforgehq-ui-charts.mjs"
+    },
     "./icons": {
       "types": "./types/bitforgehq-ui-icons.d.ts",
       "default": "./fesm2022/bitforgehq-ui-icons.mjs"

package/theme.css

@@ -2,6 +2,10 @@
  * @bitforgehq/ui — Meadow Sage design tokens.
  * Source: docs/design/foundations.md (extracted from docs/design/meadow-sage.dc.html).
  *
+ * The palette is Meadow Sage; the default primary is a neutral indigo (#2b26ba), not the design's
+ * sage green, because it is meant to be overridden with the app's brand colour (below). An indigo
+ * primary after install is expected.
+ *
  * Usage (web and mobile apps alike):
  *   @import 'tailwindcss';
  *   @import '@bitforgehq/ui/theme.css';
@@ -92,6 +96,26 @@
   --color-danger-border: #c8452f;
   --color-neutral: #4a5347;
   --color-neutral-soft: #efece3;
+  --color-info: #0f4c6b; /* informational badge: 7.7:1 on info-soft */
+  --color-info-soft: #dcecf5;
+
+  /* Tooltip: a dark pill in light mode, inverted (light) in dark mode */
+  --color-tooltip: #1f2a22;
+  --color-on-tooltip: #ffffff; /* 14.9:1 on tooltip */
+
+  /* Charts (@bitforgehq/ui/charts): a categorical palette in a fixed order (series 1 takes chart-1,
+     never cycled by rank), each >= 3:1 on surface and bg, adjacent pairs distinct under colour
+     vision deficiency; recessive grid lines and a >= 3:1 axis line. */
+  --color-chart-1: #2f7d4f; /* sage green */
+  --color-chart-2: #4a55d0; /* indigo */
+  --color-chart-3: #c4561f; /* terracotta */
+  --color-chart-4: #00809a; /* teal */
+  --color-chart-5: #8a6a00; /* ochre */
+  --color-chart-6: #c2387a; /* berry */
+  --color-chart-7: #8045c4; /* violet */
+  --color-chart-8: #5f7d10; /* olive */
+  --color-chart-grid: #ebe8df; /* grid lines: decorative */
+  --color-chart-axis: #8e8e82; /* axis baseline: >= 3:1 on surface */
 
   /* Lines */
   --color-border: #e4e0d4; /* decorative lines only (dividers, card edges) */
@@ -164,6 +188,68 @@
     }
   }
 
+  /* bf-skeleton shimmer: a soft highlight sweeps across the placeholder from the inline start
+     (hidden under reduced motion); the -rtl pair sweeps it the other way under dir="rtl". */
+  --animate-skeleton-shimmer: bf-skeleton-shimmer 1.6s ease-in-out infinite;
+  --animate-skeleton-shimmer-rtl: bf-skeleton-shimmer-rtl 1.6s ease-in-out infinite;
+  @keyframes bf-skeleton-shimmer {
+    from {
+      transform: translateX(-100%);
+    }
+    to {
+      transform: translateX(100%);
+    }
+  }
+  @keyframes bf-skeleton-shimmer-rtl {
+    from {
+      transform: translateX(100%);
+    }
+    to {
+      transform: translateX(-100%);
+    }
+  }
+
+  /* @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
+     markers fade in. Charts drop every one under reduced motion (motion-reduce:animate-none). */
+  --animate-chart-draw: bf-chart-draw 700ms var(--ease-md) both;
+  --animate-chart-grow-y: bf-chart-grow-y 600ms var(--ease-md) both;
+  --animate-chart-grow-x: bf-chart-grow-x 600ms var(--ease-md) both;
+  --animate-chart-fade: bf-chart-fade 700ms var(--ease-md) both;
+  @keyframes bf-chart-draw {
+    from {
+      stroke-dashoffset: 1;
+    }
+    to {
+      stroke-dashoffset: 0;
+    }
+  }
+  @keyframes bf-chart-grow-y {
+    from {
+      transform: scaleY(0);
+    }
+    to {
+      transform: scaleY(1);
+    }
+  }
+  @keyframes bf-chart-grow-x {
+    from {
+      transform: scaleX(0);
+    }
+    to {
+      transform: scaleX(1);
+    }
+  }
+  @keyframes bf-chart-fade {
+    from {
+      opacity: 0;
+    }
+    to {
+      opacity: 1;
+    }
+  }
+
   /* Safe areas: Capacitor 8.3+ injects --safe-area-inset-* on Android; env() covers iOS and web. */
   --spacing-safe-top: var(--safe-area-inset-top, env(safe-area-inset-top, 0px));
   --spacing-safe-bottom: var(--safe-area-inset-bottom, env(safe-area-inset-bottom, 0px));
@@ -213,6 +299,21 @@
   --color-danger-soft: #3d1f1a;
   --color-danger-pressed: #f4a497;
   --color-danger-border: #d3563f;
+  --color-info: #7cc4ea; /* 7.2:1 on info-soft */
+  --color-info-soft: #14303e;
+  --color-tooltip: #ececee;
+  --color-on-tooltip: #1e2024; /* 13.8:1 on tooltip */
+
+  --color-chart-1: #3e9e66;
+  --color-chart-2: #7479ee;
+  --color-chart-3: #d8692f;
+  --color-chart-4: #1f9cb8;
+  --color-chart-5: #b08a1c;
+  --color-chart-6: #dc5893;
+  --color-chart-7: #a072e6;
+  --color-chart-8: #7f9c2c;
+  --color-chart-grid: #2a2c31;
+  --color-chart-axis: #75777e;
   --color-neutral: #b8bbc2;
   --color-neutral-soft: #24262b;