@bitforgehq/ui 0.3.0

package/llms.txt

@@ -0,0 +1,329 @@
+# @bitforgehq/ui
+
+> Bitforge's Angular 22 component library (Meadow Sage design, Tailwind v4, signals-first) and Capacitor app shell.
+
+- [Guide for agents](https://bitforge-ui.web.app/ai/UI_GUIDE.md)
+
+## Get started
+
+- [Install](https://bitforge-ui.web.app/install): Add the package, wire the theme and fonts
+- [Tutorial](https://bitforge-ui.web.app/tutorial): Build a settings page: form, validation, toast, dialog, dark mode
+- [Concepts](https://bitforge-ui.web.app/concepts): Entry points, tokens, signals, desktop and Capacitor, SSR and i18n
+
+## Guides
+
+- [Forms and validation](https://bitforge-ui.web.app/forms): Signal Forms, validation messages and Reactive Forms
+- [Density](https://bitforge-ui.web.app/density): One 32/40/48 px scale, a compact default and provideBfDefaults()
+- [Labels and translation](https://bitforge-ui.web.app/labels): Translate built-in strings and validation messages
+- [Theming and dark mode](https://bitforge-ui.web.app/theming): Brand colours, dark mode, OS sync and token overrides
+- [Dialogs, menus and toasts](https://bitforge-ui.web.app/overlays): Confirm dialogs, form dialogs, row menus and undo toasts on desktop
+- [Testing](https://bitforge-ui.web.app/testing): Vitest or Jest, jsdom shims, test providers and harnesses
+- [Capacitor apps](https://bitforge-ui.web.app/mobile): Capacitor setup, the shell and its reference
+- [Troubleshooting](https://bitforge-ui.web.app/troubleshooting): Known setup failures, their cause and fix
+
+## Components
+
+- [All components](https://bitforge-ui.web.app/components): Every component, grouped by category
+
+### Actions
+
+- [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))
+
+### Forms
+
+- [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-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-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-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-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-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))
+
+### 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-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-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-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-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-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-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-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))
+
+### Overlays
+
+- [bf-action-sheet](https://bitforge-ui.web.app/ai/components/action-sheet.md): Bottom panel of labelled actions with a separate cancel button, destructive ones shown in red ([docs](https://bitforge-ui.web.app/components/action-sheet))
+- [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-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-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-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))
+
+### Icons
+
+- [bf-icon](https://bitforge-ui.web.app/ai/components/icon.md): Tree-shakable Lucide icon renderer, decorative by default or labelled when meaningful ([docs](https://bitforge-ui.web.app/components/icon))
+
+## Foundations
+
+- [Foundations](https://bitforge-ui.web.app/foundations): Colour, type, radius and shadow tokens
+
+## Reference
+
+- [API](https://bitforge-ui.web.app/api): Every service, directive, function, token and type
+- [For agents](https://bitforge-ui.web.app/agents): The manifest, llms.txt and agent docs
+- [Compatibility](https://bitforge-ui.web.app/compatibility): Peer dependencies, toolchain and supported browsers
+
+### @bitforgehq/ui
+
+- [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_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))
+- [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))
+- [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))
+- [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))
+- [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))
+- [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))
+- [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))
+- [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))
+- [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))
+- [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))
+- [BfInputMode](https://bitforge-ui.web.app/ai/reference/bf-input-mode.md): The virtual keyboards a phone can show for a text field ([docs](https://bitforge-ui.web.app/api/bf-input-mode))
+- [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))
+- [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))
+- [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))
+- [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))
+- [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))
+- [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))
+- [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))
+- [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))
+- [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))
+
+### @bitforgehq/ui/overlay
+
+- [BF_DESKTOP_TOAST_DEFAULTS](https://bitforge-ui.web.app/ai/reference/bf_desktop_toast_defaults.md): The library defaults of the desktop toast settings, bottom end with three visible ([docs](https://bitforge-ui.web.app/api/bf_desktop_toast_defaults))
+- [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))
+- [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))
+- [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))
+- [BfDesktopToastService](https://bitforge-ui.web.app/ai/reference/bf-desktop-toast-service.md): Shows brief desktop notifications in a stack at a corner of the viewport ([docs](https://bitforge-ui.web.app/api/bf-desktop-toast-service))
+- [BfDialogConfig](https://bitforge-ui.web.app/ai/reference/bf-dialog-config.md): Options of a dialog: its data, width, role, dismissal, focus and injector ([docs](https://bitforge-ui.web.app/api/bf-dialog-config))
+- [BfDialogRef](https://bitforge-ui.web.app/ai/reference/bf-dialog-ref.md): Handle on an open dialog that closes it and resolves with its result ([docs](https://bitforge-ui.web.app/api/bf-dialog-ref))
+- [BfDialogRole](https://bitforge-ui.web.app/ai/reference/bf-dialog-role.md): The role a dialog carries, plain or an alert dialog that demands an answer ([docs](https://bitforge-ui.web.app/api/bf-dialog-role))
+- [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))
+- [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))
+- [BfMenuItemCheckboxDirective](https://bitforge-ui.web.app/ai/reference/bf-menu-item-checkbox-directive.md): A menu row that toggles an option on and off with a check mark ([docs](https://bitforge-ui.web.app/api/bf-menu-item-checkbox-directive))
+- [BfMenuItemDirective](https://bitforge-ui.web.app/ai/reference/bf-menu-item-directive.md): An action row of a menu on a native button or link, with keyboard rules ([docs](https://bitforge-ui.web.app/api/bf-menu-item-directive))
+- [BfMenuItemRadioDirective](https://bitforge-ui.web.app/ai/reference/bf-menu-item-radio-directive.md): One choice of a set of exclusive options in a menu, marked with a dot ([docs](https://bitforge-ui.web.app/api/bf-menu-item-radio-directive))
+- [BfMenuPlacement](https://bitforge-ui.web.app/ai/reference/bf-menu-placement.md): Where a menu opens against its trigger, above or below, at either end ([docs](https://bitforge-ui.web.app/api/bf-menu-placement))
+- [BfMenuTriggerDirective](https://bitforge-ui.web.app/ai/reference/bf-menu-trigger-directive.md): Opens a menu from any element with the keyboard and focus rules of menus ([docs](https://bitforge-ui.web.app/api/bf-menu-trigger-directive))
+- [BfOverlayAutoFocus](https://bitforge-ui.web.app/ai/reference/bf-overlay-auto-focus.md): Where focus lands when an overlay opens, its first control or the panel ([docs](https://bitforge-ui.web.app/api/bf-overlay-auto-focus))
+- [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))
+- [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))
+- [BfOverlayService](https://bitforge-ui.web.app/ai/reference/bf-overlay-service.md): Opens a component or template in an overlay panel on the Angular CDK ([docs](https://bitforge-ui.web.app/api/bf-overlay-service))
+- [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))
+- [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))
+- [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))
+- [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))
+- [fadeUp](https://bitforge-ui.web.app/ai/reference/fade-up.md): Fades an element in while it rises, the Material modal enter animation ([docs](https://bitforge-ui.web.app/api/fade-up))
+- [OVERLAY_DURATION](https://bitforge-ui.web.app/ai/reference/overlay_duration.md): The duration of every overlay enter and exit animation, in milliseconds ([docs](https://bitforge-ui.web.app/api/overlay_duration))
+- [OVERLAY_EASING](https://bitforge-ui.web.app/ai/reference/overlay_easing.md): The easing curve of the overlay animations, the UIKit sheet curve ([docs](https://bitforge-ui.web.app/api/overlay_easing))
+- [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))
+- [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))
+- [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
+
+- [BfIconSize](https://bitforge-ui.web.app/ai/reference/bf-icon-size.md): The three icon sizes, 16, 20 and 24 pixels, matching the text sizes ([docs](https://bitforge-ui.web.app/api/bf-icon-size))
+
+### @bitforgehq/ui/number-input
+
+- [BfNumberInputMode](https://bitforge-ui.web.app/ai/reference/bf-number-input-mode.md): The virtual keyboards a number field can ask a phone to show ([docs](https://bitforge-ui.web.app/api/bf-number-input-mode))
+- [BfNumberInputStep](https://bitforge-ui.web.app/ai/reference/bf-number-input-step.md): The step of a number field, a number or any for no step check ([docs](https://bitforge-ui.web.app/api/bf-number-input-step))
+
+### @bitforgehq/ui/mobile
+
+- [BF_SHEET_DEFAULT_SNAP_POINTS](https://bitforge-ui.web.app/ai/reference/bf_sheet_default_snap_points.md): The snap points a bottom sheet rests at when none are given, half and full ([docs](https://bitforge-ui.web.app/api/bf_sheet_default_snap_points))
+- [BF_SHELL_CONFIG](https://bitforge-ui.web.app/ai/reference/bf_shell_config.md): Injection token holding the resolved mobile shell configuration of the app ([docs](https://bitforge-ui.web.app/api/bf_shell_config))
+- [BF_SHELL_DEFAULTS](https://bitforge-ui.web.app/ai/reference/bf_shell_defaults.md): The mobile shell defaults that provideBfShell merges the app settings over ([docs](https://bitforge-ui.web.app/api/bf_shell_defaults))
+- [BF_TAB_CONTEXT](https://bitforge-ui.web.app/ai/reference/bf_tab_context.md): Injection token through which the tabs page tells its outlet about the tabs ([docs](https://bitforge-ui.web.app/api/bf_tab_context))
+- [BF_THEME_STORAGE](https://bitforge-ui.web.app/ai/reference/bf_theme_storage.md): Injection token for the store that keeps the app theme choice between visits ([docs](https://bitforge-ui.web.app/api/bf_theme_storage))
+- [BfActionSheetAction](https://bitforge-ui.web.app/ai/reference/bf-action-sheet-action.md): One row of an action sheet, or its cancel button, with its answer and role ([docs](https://bitforge-ui.web.app/api/bf-action-sheet-action))
+- [BfActionSheetActionRole](https://bitforge-ui.web.app/ai/reference/bf-action-sheet-action-role.md): The role of an action sheet row, a destructive action or the cancel button ([docs](https://bitforge-ui.web.app/api/bf-action-sheet-action-role))
+- [BfActionSheetOptions](https://bitforge-ui.web.app/ai/reference/bf-action-sheet-options.md): Options of an action sheet: its title, its rows and when it closes ([docs](https://bitforge-ui.web.app/api/bf-action-sheet-options))
+- [BfActionSheetService](https://bitforge-ui.web.app/ai/reference/bf-action-sheet-service.md): Opens bottom action sheets that resolve with the row the user tapped ([docs](https://bitforge-ui.web.app/api/bf-action-sheet-service))
+- [BfAlertDialogButton](https://bitforge-ui.web.app/ai/reference/bf-alert-dialog-button.md): One button of an alert dialog: its answer, its label and its role ([docs](https://bitforge-ui.web.app/api/bf-alert-dialog-button))
+- [BfAlertDialogButtonRole](https://bitforge-ui.web.app/ai/reference/bf-alert-dialog-button-role.md): The role of an alert dialog button, the cancel answer or a destructive action ([docs](https://bitforge-ui.web.app/api/bf-alert-dialog-button-role))
+- [BfAlertDialogOptions](https://bitforge-ui.web.app/ai/reference/bf-alert-dialog-options.md): Options of an alert dialog: its title, message, buttons and when it closes ([docs](https://bitforge-ui.web.app/api/bf-alert-dialog-options))
+- [BfAlertDialogService](https://bitforge-ui.web.app/ai/reference/bf-alert-dialog-service.md): Opens small centred alerts that resolve with the button the user tapped ([docs](https://bitforge-ui.web.app/api/bf-alert-dialog-service))
+- [BfBackAtRoot](https://bitforge-ui.web.app/ai/reference/bf-back-at-root.md): What Android back does at a stack root, background the app or exit it ([docs](https://bitforge-ui.web.app/api/bf-back-at-root))
+- [BfBackButtonService](https://bitforge-ui.web.app/ai/reference/bf-back-button-service.md): The Android hardware back button queue that overlays and navigation stacks share ([docs](https://bitforge-ui.web.app/api/bf-back-button-service))
+- [BfContentScrollEvent](https://bitforge-ui.web.app/ai/reference/bf-content-scroll-event.md): What a content scroll event carries: the scroller's current top offset ([docs](https://bitforge-ui.web.app/api/bf-content-scroll-event))
+- [BfHapticsImpactStyle](https://bitforge-ui.web.app/ai/reference/bf-haptics-impact-style.md): The weight of an impact haptic, light, medium or heavy ([docs](https://bitforge-ui.web.app/api/bf-haptics-impact-style))
+- [BfHapticsNotificationType](https://bitforge-ui.web.app/ai/reference/bf-haptics-notification-type.md): The outcome a notification haptic reports: success, warning or error ([docs](https://bitforge-ui.web.app/api/bf-haptics-notification-type))
+- [BfHapticsService](https://bitforge-ui.web.app/ai/reference/bf-haptics-service.md): Haptic feedback on native devices that silently does nothing on the web ([docs](https://bitforge-ui.web.app/api/bf-haptics-service))
+- [BfHorizontalScrollDirective](https://bitforge-ui.web.app/ai/reference/bf-horizontal-scroll-directive.md): Deprecated touch-action opt-in for horizontal scrollers in stack pages, not needed ([docs](https://bitforge-ui.web.app/api/bf-horizontal-scroll-directive))
+- [BfKeyboardAssistBehavior](https://bitforge-ui.web.app/ai/reference/bf-keyboard-assist-behavior.md): Whether the keyboard assist scrolls a focused field into view smoothly or at once ([docs](https://bitforge-ui.web.app/api/bf-keyboard-assist-behavior))
+- [BfKeyboardAssistDirective](https://bitforge-ui.web.app/ai/reference/bf-keyboard-assist-directive.md): Keeps the focused text field of a scroll container clear of the soft keyboard ([docs](https://bitforge-ui.web.app/api/bf-keyboard-assist-directive))
+- [BfKeyboardPhase](https://bitforge-ui.web.app/ai/reference/bf-keyboard-phase.md): The soft keyboard phase, hidden, showing or shown, for animations only ([docs](https://bitforge-ui.web.app/api/bf-keyboard-phase))
+- [BfKeyboardService](https://bitforge-ui.web.app/ai/reference/bf-keyboard-service.md): The soft keyboard state as signals: visible, its height and its phase ([docs](https://bitforge-ui.web.app/api/bf-keyboard-service))
+- [BfModalOptions](https://bitforge-ui.web.app/ai/reference/bf-modal-options.md): Options of a modal: its data, presentation, dismissal and accessible name ([docs](https://bitforge-ui.web.app/api/bf-modal-options))
+- [BfModalPresentation](https://bitforge-ui.web.app/ai/reference/bf-modal-presentation.md): How a modal is presented: a page-sheet card over the stack, or fullscreen ([docs](https://bitforge-ui.web.app/api/bf-modal-presentation))
+- [BfModalService](https://bitforge-ui.web.app/ai/reference/bf-modal-service.md): Opens a component as a modal page sheet over the stack, or fullscreen ([docs](https://bitforge-ui.web.app/api/bf-modal-service))
+- [BfNavController](https://bitforge-ui.web.app/ai/reference/bf-nav-controller.md): Stack-aware navigation that pushes, pops through the history and replaces the root ([docs](https://bitforge-ui.web.app/api/bf-nav-controller))
+- [BfNavDirection](https://bitforge-ui.web.app/ai/reference/bf-nav-direction.md): The direction a stack navigation animates in: forward, back or a new root ([docs](https://bitforge-ui.web.app/api/bf-nav-direction))
+- [BfNavTarget](https://bitforge-ui.web.app/ai/reference/bf-nav-target.md): A navigation target as the router accepts it: a URL, a UrlTree or commands ([docs](https://bitforge-ui.web.app/api/bf-nav-target))
+- [BfOverscrollStretchDirective](https://bitforge-ui.web.app/ai/reference/bf-overscroll-stretch-directive.md): Android-style stretch of a scroll container dragged past its top or bottom edge ([docs](https://bitforge-ui.web.app/api/bf-overscroll-stretch-directive))
+- [BfPageContext](https://bitforge-ui.web.app/ai/reference/bf-page-context.md): Per-page state that the header and content of one page share ([docs](https://bitforge-ui.web.app/api/bf-page-context))
+- [BfPlatform](https://bitforge-ui.web.app/ai/reference/bf-platform.md): The platform the app runs on, native iOS, native Android or the web ([docs](https://bitforge-ui.web.app/api/bf-platform))
+- [BfPlatformService](https://bitforge-ui.web.app/ai/reference/bf-platform-service.md): Platform facts and the app theme: native or web, iOS or Android, light or dark ([docs](https://bitforge-ui.web.app/api/bf-platform-service))
+- [BfRefresherRefreshEvent](https://bitforge-ui.web.app/ai/reference/bf-refresher-refresh-event.md): What a pull-to-refresh request carries: the callback that ends the refresh ([docs](https://bitforge-ui.web.app/api/bf-refresher-refresh-event))
+- [BfSheetAutoFocus](https://bitforge-ui.web.app/ai/reference/bf-sheet-auto-focus.md): Where focus lands when a sheet opens, the sheet itself or its first field ([docs](https://bitforge-ui.web.app/api/bf-sheet-auto-focus))
+- [BfSheetOptions](https://bitforge-ui.web.app/ai/reference/bf-sheet-options.md): Options of a bottom sheet: where it rests, how it closes and its name ([docs](https://bitforge-ui.web.app/api/bf-sheet-options))
+- [BfSheetRef](https://bitforge-ui.web.app/ai/reference/bf-sheet-ref.md): Handle on an open bottom sheet that moves it between snap points and closes it ([docs](https://bitforge-ui.web.app/api/bf-sheet-ref))
+- [BfSheetService](https://bitforge-ui.web.app/ai/reference/bf-sheet-service.md): Opens bottom sheets that rest at snap points and close with a result ([docs](https://bitforge-ui.web.app/api/bf-sheet-service))
+- [BfShellConfig](https://bitforge-ui.web.app/ai/reference/bf-shell-config.md): The mobile shell settings: mode, swipe-back, haptics, Dynamic Type and system bars ([docs](https://bitforge-ui.web.app/api/bf-shell-config))
+- [BfShellConfigMode](https://bitforge-ui.web.app/ai/reference/bf-shell-config-mode.md): The shell style setting, iOS, Material or automatic from the platform ([docs](https://bitforge-ui.web.app/api/bf-shell-config-mode))
+- [BfShellDynamicType](https://bitforge-ui.web.app/ai/reference/bf-shell-dynamic-type.md): Whether the shell follows iOS Dynamic Type, and up to which scale ([docs](https://bitforge-ui.web.app/api/bf-shell-dynamic-type))
+- [BfShellDynamicTypeLimit](https://bitforge-ui.web.app/ai/reference/bf-shell-dynamic-type-limit.md): The largest root font scale iOS Dynamic Type may apply in the shell ([docs](https://bitforge-ui.web.app/api/bf-shell-dynamic-type-limit))
+- [BfShellMode](https://bitforge-ui.web.app/ai/reference/bf-shell-mode.md): The shell's look and motion conventions, iOS or Material Design ([docs](https://bitforge-ui.web.app/api/bf-shell-mode))
+- [BfShellTestingOptions](https://bitforge-ui.web.app/ai/reference/bf-shell-testing-options.md): Options of the shell test providers: the routes and the shell settings ([docs](https://bitforge-ui.web.app/api/bf-shell-testing-options))
+- [BfStackChange](https://bitforge-ui.web.app/ai/reference/bf-stack-change.md): What a stack outlet reports after its stack changed: the depth and the tab ([docs](https://bitforge-ui.web.app/api/bf-stack-change))
+- [BfStackReuseStrategy](https://bitforge-ui.web.app/ai/reference/bf-stack-reuse-strategy.md): Route reuse strategy that treats a changed path parameter as a new stack page ([docs](https://bitforge-ui.web.app/api/bf-stack-reuse-strategy))
+- [BfStackTransition](https://bitforge-ui.web.app/ai/reference/bf-stack-transition.md): A running set of page transition animations that finish together ([docs](https://bitforge-ui.web.app/api/bf-stack-transition))
+- [BfStackTransitionEvent](https://bitforge-ui.web.app/ai/reference/bf-stack-transition-event.md): What a stack outlet reports around a page transition: its kind and animation ([docs](https://bitforge-ui.web.app/api/bf-stack-transition-event))
+- [bfSystemBarsStyle](https://bitforge-ui.web.app/ai/reference/bf-system-bars-style.md): The system-bar icon style that keeps the bars readable in the in-app theme ([docs](https://bitforge-ui.web.app/api/bf-system-bars-style))
+- [BfTabContext](https://bitforge-ui.web.app/ai/reference/bf-tab-context.md): What the tabs page tells its stack outlet: which tab a URL belongs to ([docs](https://bitforge-ui.web.app/api/bf-tab-context))
+- [BfTextScaleService](https://bitforge-ui.web.app/ai/reference/bf-text-scale-service.md): Follows iOS Dynamic Type by scaling the root font size of the app ([docs](https://bitforge-ui.web.app/api/bf-text-scale-service))
+- [BfTheme](https://bitforge-ui.web.app/ai/reference/bf-theme.md): The app theme choice, following the system or forcing light or dark ([docs](https://bitforge-ui.web.app/api/bf-theme))
+- [BfToastOptions](https://bitforge-ui.web.app/ai/reference/bf-toast-options.md): Options of a mobile toast: its message, an action, its duration and position ([docs](https://bitforge-ui.web.app/api/bf-toast-options))
+- [BfToastPosition](https://bitforge-ui.web.app/ai/reference/bf-toast-position.md): Where a mobile toast pill anchors in the viewport, at the bottom or top ([docs](https://bitforge-ui.web.app/api/bf-toast-position))
+- [BfToastService](https://bitforge-ui.web.app/ai/reference/bf-toast-service.md): Shows brief toast pills on phones, one at a time, queued in order ([docs](https://bitforge-ui.web.app/api/bf-toast-service))
+- [BfTransitionKind](https://bitforge-ui.web.app/ai/reference/bf-transition-kind.md): The direction of a stack transition, a page pushed on or popped off ([docs](https://bitforge-ui.web.app/api/bf-transition-kind))
+- [BfViewEvent](https://bitforge-ui.web.app/ai/reference/bf-view-event.md): The four lifecycle events of a stacked page as it enters and leaves ([docs](https://bitforge-ui.web.app/api/bf-view-event))
+- [BfViewLifecycle](https://bitforge-ui.web.app/ai/reference/bf-view-lifecycle.md): The lifecycle of one stacked page as signals and events, from enter to leave ([docs](https://bitforge-ui.web.app/api/bf-view-lifecycle))
+- [BfViewState](https://bitforge-ui.web.app/ai/reference/bf-view-state.md): Where a stacked page is in its lifecycle: entering, active, leaving or inactive ([docs](https://bitforge-ui.web.app/api/bf-view-state))
+- [createTransition](https://bitforge-ui.web.app/ai/reference/create-transition.md): Builds the iOS push or pop with its slide, parallax and dimming layers ([docs](https://bitforge-ui.web.app/api/create-transition))
+- [DURATION_FAST](https://bitforge-ui.web.app/ai/reference/duration_fast.md): The duration of colour transitions and the reduced-motion fade, in milliseconds ([docs](https://bitforge-ui.web.app/api/duration_fast))
+- [DURATION_MD](https://bitforge-ui.web.app/ai/reference/duration_md.md): The duration of the Material fade-up and the refresher settle, in milliseconds ([docs](https://bitforge-ui.web.app/api/duration_md))
+- [DURATION_OVERLAY](https://bitforge-ui.web.app/ai/reference/duration_overlay.md): The duration of overlay enter and exit and the modal depth effect, in milliseconds ([docs](https://bitforge-ui.web.app/api/duration_overlay))
+- [DURATION_PUSH](https://bitforge-ui.web.app/ai/reference/duration_push.md): The duration of the iOS push and pop page transitions, in milliseconds ([docs](https://bitforge-ui.web.app/api/duration_push))
+- [injectShellMode](https://bitforge-ui.web.app/ai/reference/inject-shell-mode.md): Reads the shell mode in effect from the injector, iOS or Material ([docs](https://bitforge-ui.web.app/api/inject-shell-mode))
+- [IOS_DURATION](https://bitforge-ui.web.app/ai/reference/ios_duration.md): The duration of the iOS push and pop stack transitions, in milliseconds ([docs](https://bitforge-ui.web.app/api/ios_duration))
+- [IOS_EASING](https://bitforge-ui.web.app/ai/reference/ios_easing.md): The UIKit navigation and sheet easing curve of pushes, pops and overlays ([docs](https://bitforge-ui.web.app/api/ios_easing))
+- [isTextEntry](https://bitforge-ui.web.app/ai/reference/is-text-entry.md): Tells whether focusing an element opens the soft keyboard on a phone ([docs](https://bitforge-ui.web.app/api/is-text-entry))
+- [MAX_COMPLETE_MS](https://bitforge-ui.web.app/ai/reference/max_complete_ms.md): The longest a released swipe-back may take to settle, in milliseconds ([docs](https://bitforge-ui.web.app/api/max_complete_ms))
+- [MD_DURATION](https://bitforge-ui.web.app/ai/reference/md_duration.md): The duration of the Material fade-up stack transition, in milliseconds ([docs](https://bitforge-ui.web.app/api/md_duration))
+- [MD_EASING](https://bitforge-ui.web.app/ai/reference/md_easing.md): The Material standard easing curve of the Android page fade-up transition ([docs](https://bitforge-ui.web.app/api/md_easing))
+- [mdTransition](https://bitforge-ui.web.app/ai/reference/md-transition.md): Builds the Material fade-up page transition of a push or a pop ([docs](https://bitforge-ui.web.app/api/md-transition))
+- [popFramesAt](https://bitforge-ui.web.app/ai/reference/pop-frames-at.md): The positions of the pop layers at a given progress, for scrubbing a swipe ([docs](https://bitforge-ui.web.app/api/pop-frames-at))
+- [provideBfShell](https://bitforge-ui.web.app/ai/reference/provide-bf-shell.md): Provides the Capacitor app shell: its configuration, navigation and platform services ([docs](https://bitforge-ui.web.app/api/provide-bf-shell))
+- [provideBfShellTesting](https://bitforge-ui.web.app/ai/reference/provide-bf-shell-testing.md): Test providers for the mobile shell: router, shell, in-memory theme and cleanup ([docs](https://bitforge-ui.web.app/api/provide-bf-shell-testing))
+- [REDUCED_DURATION](https://bitforge-ui.web.app/ai/reference/reduced_duration.md): The duration of the cross-fade that replaces page motion under reduced motion ([docs](https://bitforge-ui.web.app/api/reduced_duration))
+- [reducedTransition](https://bitforge-ui.web.app/ai/reference/reduced-transition.md): Builds the cross-fade that replaces page motion when the user reduces motion ([docs](https://bitforge-ui.web.app/api/reduced-transition))
+- [resolveShellMode](https://bitforge-ui.web.app/ai/reference/resolve-shell-mode.md): Resolves the shell mode in effect from the configuration and the platform ([docs](https://bitforge-ui.web.app/api/resolve-shell-mode))
+- [SETTLE_EASING](https://bitforge-ui.web.app/ai/reference/settle_easing.md): The ease-out curve a released swipe-back or refresher gesture settles with ([docs](https://bitforge-ui.web.app/api/settle_easing))
+- [settleDuration](https://bitforge-ui.web.app/ai/reference/settle-duration.md): The duration of the settle animation after a released swipe-back gesture ([docs](https://bitforge-ui.web.app/api/settle-duration))
+- [settlePop](https://bitforge-ui.web.app/ai/reference/settle-pop.md): Animates a released swipe-back from its progress to done or back to the start ([docs](https://bitforge-ui.web.app/api/settle-pop))
+- [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/testing
+
+- [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))
+- [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))
+- [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))
+- [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))
+- [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))
+- [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))
+
+## Changelog
+
+- [Changelog](https://bitforge-ui.web.app/changelog): What changed in each version, with migration notes

package/package.json

@@ -0,0 +1,94 @@
+{
+  "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.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bitforge/BitforgeUI.git"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": false
+  },
+  "bin": {
+    "bf-ui": "./bin/bf-ui.js"
+  },
+  "peerDependencies": {
+    "@angular/cdk": "^22.0.0",
+    "@angular/common": "^22.0.0",
+    "@angular/core": "^22.0.0",
+    "@angular/forms": "^22.0.0",
+    "@angular/router": "^22.0.0",
+    "@capacitor/app": "^8.0.0",
+    "@capacitor/core": "^8.0.0",
+    "@capacitor/haptics": "^8.0.0",
+    "@capacitor/keyboard": "^8.0.0",
+    "lucide": "^1.0.0",
+    "rxjs": "^7.8.0"
+  },
+  "peerDependenciesMeta": {
+    "@angular/cdk": {
+      "optional": true
+    },
+    "@angular/router": {
+      "optional": true
+    },
+    "@capacitor/app": {
+      "optional": true
+    },
+    "@capacitor/core": {
+      "optional": true
+    },
+    "@capacitor/haptics": {
+      "optional": true
+    },
+    "@capacitor/keyboard": {
+      "optional": true
+    },
+    "rxjs": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "tslib": "^2.8.1"
+  },
+  "sideEffects": false,
+  "exports": {
+    "./theme.css": "./theme.css",
+    "./ai/*": "./ai/*",
+    "./llms.txt": "./llms.txt",
+    "./llms-full.txt": "./llms-full.txt",
+    "./CHANGELOG.md": "./CHANGELOG.md",
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./types/bitforgehq-ui.d.ts",
+      "default": "./fesm2022/bitforgehq-ui.mjs"
+    },
+    "./icons": {
+      "types": "./types/bitforgehq-ui-icons.d.ts",
+      "default": "./fesm2022/bitforgehq-ui-icons.mjs"
+    },
+    "./mobile": {
+      "types": "./types/bitforgehq-ui-mobile.d.ts",
+      "default": "./fesm2022/bitforgehq-ui-mobile.mjs"
+    },
+    "./number-input": {
+      "types": "./types/bitforgehq-ui-number-input.d.ts",
+      "default": "./fesm2022/bitforgehq-ui-number-input.mjs"
+    },
+    "./overlay": {
+      "types": "./types/bitforgehq-ui-overlay.d.ts",
+      "default": "./fesm2022/bitforgehq-ui-overlay.mjs"
+    },
+    "./testing": {
+      "types": "./types/bitforgehq-ui-testing.d.ts",
+      "default": "./fesm2022/bitforgehq-ui-testing.mjs"
+    }
+  },
+  "module": "fesm2022/bitforgehq-ui.mjs",
+  "typings": "types/bitforgehq-ui.d.ts",
+  "type": "module"
+}