@bitforgehq/ui 0.3.1 → 0.3.3

package/ai/REFERENCE.index.json

@@ -36,6 +36,13 @@
       "entryPoint": "@bitforgehq/ui",
       "summary": "Injection token holding the user-facing strings in effect for an injector"
     },
+    {
+      "name": "BF_SIDEBAR_STATE_STORAGE",
+      "slug": "bf_sidebar_state_storage",
+      "kind": "token",
+      "entryPoint": "@bitforgehq/ui",
+      "summary": "Injection token for the store that keeps the collapsed sidebar between visits"
+    },
     {
       "name": "BF_TAB_BAR",
       "slug": "bf_tab_bar",
@@ -71,6 +78,20 @@
       "entryPoint": "@bitforgehq/ui",
       "summary": "The four tones of an alert, from neutral information to a danger message"
     },
+    {
+      "name": "BfAppFrameBreakpoint",
+      "slug": "bf-app-frame-breakpoint",
+      "kind": "type",
+      "entryPoint": "@bitforgehq/ui",
+      "summary": "The breakpoint where an app frame switches from its header bar to the sidebar"
+    },
+    {
+      "name": "BfAppFrameContentWidth",
+      "slug": "bf-app-frame-content-width",
+      "kind": "type",
+      "entryPoint": "@bitforgehq/ui",
+      "summary": "The maximum width of an app frame's content column, from medium to full"
+    },
     {
       "name": "BfAutocapitalize",
       "slug": "bf-autocapitalize",
@@ -218,6 +239,13 @@
       "entryPoint": "@bitforgehq/ui",
       "summary": "The two description list layouts, divided label-value rows or a grid of tiles"
     },
+    {
+      "name": "BfEmptyStateHeading",
+      "slug": "bf-empty-state-heading",
+      "kind": "type",
+      "entryPoint": "@bitforgehq/ui",
+      "summary": "The heading level of an empty state title, one for a whole page"
+    },
     {
       "name": "BfEmptyStateHeadingLevel",
       "slug": "bf-empty-state-heading-level",
@@ -365,6 +393,13 @@
       "entryPoint": "@bitforgehq/ui",
       "summary": "One choice of a select with its value, its label and a disabled flag"
     },
+    {
+      "name": "BfSidebarStateService",
+      "slug": "bf-sidebar-state-service",
+      "kind": "service",
+      "entryPoint": "@bitforgehq/ui",
+      "summary": "The sidebar's collapsed state, kept in storage between visits of the app"
+    },
     {
       "name": "BfSize",
       "slug": "bf-size",
@@ -386,6 +421,13 @@
       "entryPoint": "@bitforgehq/ui",
       "summary": "The three spinner diameters, from inline text to a page loading state"
     },
+    {
+      "name": "BfStatAppearance",
+      "slug": "bf-stat-appearance",
+      "kind": "type",
+      "entryPoint": "@bitforgehq/ui",
+      "summary": "The three stat surfaces, plain, an outlined card or a sunken tile"
+    },
     {
       "name": "BfStatTrend",
       "slug": "bf-stat-trend",
@@ -470,6 +512,13 @@
       "entryPoint": "@bitforgehq/ui",
       "summary": "The direction a sorted table column is in, ascending or descending"
     },
+    {
+      "name": "BfTableStack",
+      "slug": "bf-table-stack",
+      "kind": "type",
+      "entryPoint": "@bitforgehq/ui",
+      "summary": "When a table stacks its rows into cards: never, when narrow, or under touch"
+    },
     {
       "name": "BfTabLinks",
       "slug": "bf-tab-links",
@@ -519,6 +568,13 @@
       "entryPoint": "@bitforgehq/ui",
       "summary": "Replaces built-in strings for an app or a sub-tree, such as a translation"
     },
+    {
+      "name": "provideBfSidebarState",
+      "slug": "provide-bf-sidebar-state",
+      "kind": "function",
+      "entryPoint": "@bitforgehq/ui",
+      "summary": "Remembers the collapsed sidebar between visits, for desktop web apps"
+    },
     {
       "name": "BF_DESKTOP_TOAST_DEFAULTS",
       "slug": "bf_desktop_toast_defaults",
@@ -1814,6 +1870,13 @@
       "entryPoint": "@bitforgehq/ui/testing",
       "summary": "Test harness for the select: reads its label and options and picks one"
     },
+    {
+      "name": "BfSidebarToggleHarness",
+      "slug": "bf-sidebar-toggle-harness",
+      "kind": "class",
+      "entryPoint": "@bitforgehq/ui/testing",
+      "summary": "Test harness for a sidebar toggle: reads and flips the collapsed sidebar"
+    },
     {
       "name": "BfSidePanelHarness",
       "slug": "bf-side-panel-harness",

package/ai/REFERENCE.json

@@ -81,6 +81,22 @@
       "since": "0.3.0",
       "signature": "const BF_LABELS: InjectionToken<BfLabels>"
     },
+    {
+      "name": "BF_SIDEBAR_STATE_STORAGE",
+      "slug": "bf_sidebar_state_storage",
+      "kind": "token",
+      "entryPoint": "@bitforgehq/ui",
+      "file": "src/config/sidebar-state.ts",
+      "summary": "Injection token for the store that keeps the collapsed sidebar between visits",
+      "description": "Where `BfSidebarStateService` keeps whether the sidebar is collapsed (the key\n`bf-sidebar-collapsed`, `'true'` or `'false'`): `localStorage` when it is available, otherwise\nan in-memory map. Provide another store (`sessionStorage`, or an in-memory one in tests) to keep\nit elsewhere.",
+      "members": [],
+      "methods": [],
+      "slots": [],
+      "references": [],
+      "usedBy": [],
+      "since": "0.3.2",
+      "signature": "const BF_SIDEBAR_STATE_STORAGE: InjectionToken<Pick<Storage, \"getItem\" | \"setItem\">>"
+    },
     {
       "name": "BF_TAB_BAR",
       "slug": "bf_tab_bar",
@@ -162,6 +178,40 @@
       "signature": "type BfAlertVariant = 'neutral' | 'success' | 'warning' | 'danger'",
       "values": ["neutral", "success", "warning", "danger"]
     },
+    {
+      "name": "BfAppFrameBreakpoint",
+      "slug": "bf-app-frame-breakpoint",
+      "kind": "type",
+      "entryPoint": "@bitforgehq/ui",
+      "file": "src/components/app-frame/app-frame.component.ts",
+      "summary": "The breakpoint where an app frame switches from its header bar to the sidebar",
+      "description": "The viewport width from which `bf-app-frame` shows its sidebar column instead of the narrow\nheader bar: Tailwind's `md` (768 px) or `lg` (1024 px).",
+      "members": [],
+      "methods": [],
+      "slots": [],
+      "references": [],
+      "usedBy": ["bf-app-frame-component"],
+      "since": "0.3.2",
+      "signature": "type BfAppFrameBreakpoint = 'md' | 'lg'",
+      "values": ["md", "lg"]
+    },
+    {
+      "name": "BfAppFrameContentWidth",
+      "slug": "bf-app-frame-content-width",
+      "kind": "type",
+      "entryPoint": "@bitforgehq/ui",
+      "file": "src/components/app-frame/app-frame.component.ts",
+      "summary": "The maximum width of an app frame's content column, from medium to full",
+      "description": "The maximum width of `bf-app-frame`'s content column: `md` 48rem, `lg` 64rem, `xl` 80rem, or\n`full` for no limit.",
+      "members": [],
+      "methods": [],
+      "slots": [],
+      "references": [],
+      "usedBy": ["bf-app-frame-component"],
+      "since": "0.3.2",
+      "signature": "type BfAppFrameContentWidth = 'md' | 'lg' | 'xl' | 'full'",
+      "values": ["md", "lg", "xl", "full"]
+    },
     {
       "name": "BfAutocapitalize",
       "slug": "bf-autocapitalize",
@@ -586,6 +636,23 @@
       "signature": "type BfDescriptionListLayout = 'rows' | 'grid'",
       "values": ["rows", "grid"]
     },
+    {
+      "name": "BfEmptyStateHeading",
+      "slug": "bf-empty-state-heading",
+      "kind": "type",
+      "entryPoint": "@bitforgehq/ui",
+      "file": "src/components/empty-state/empty-state.component.ts",
+      "summary": "The heading level of an empty state title, one for a whole page",
+      "description": "The heading level a `bf-empty-state` title takes: a `BfEmptyStateHeadingLevel`, or `1` when the\nempty state is the page itself (a not-found or no-access page). A new type, so `Record`s over\nthe released `BfEmptyStateHeadingLevel` keep compiling.",
+      "members": [],
+      "methods": [],
+      "slots": [],
+      "references": ["bf-empty-state-heading-level"],
+      "usedBy": ["bf-empty-state-component"],
+      "since": "0.3.2",
+      "signature": "type BfEmptyStateHeading = BfEmptyStateHeadingLevel | 1",
+      "values": ["2", "3", "1"]
+    },
     {
       "name": "BfEmptyStateHeadingLevel",
       "slug": "bf-empty-state-heading-level",
@@ -598,7 +665,7 @@
       "methods": [],
       "slots": [],
       "references": [],
-      "usedBy": ["bf-empty-state-component"],
+      "usedBy": ["bf-empty-state-heading"],
       "since": "0.3.0",
       "signature": "type BfEmptyStateHeadingLevel = 2 | 3",
       "values": ["2", "3"]
@@ -999,6 +1066,42 @@
           "readonly": true,
           "default": "'Select all rows'"
         },
+        {
+          "name": "tableSortBy",
+          "kind": "property",
+          "type": "string",
+          "required": true,
+          "doc": "The label of a stacked bf-table's sort select.",
+          "readonly": true,
+          "default": "'Sort by'"
+        },
+        {
+          "name": "tableSortNone",
+          "kind": "property",
+          "type": "string",
+          "required": true,
+          "doc": "A stacked bf-table's first sort option: rows in the order given, no column sorted.",
+          "readonly": true,
+          "default": "'Not sorted'"
+        },
+        {
+          "name": "tableSortAscending",
+          "kind": "property",
+          "type": "(column: string) => string",
+          "required": true,
+          "doc": "A stacked bf-table's sort option for a column in ascending order.",
+          "readonly": true,
+          "default": "(column) => `${column}, ascending`"
+        },
+        {
+          "name": "tableSortDescending",
+          "kind": "property",
+          "type": "(column: string) => string",
+          "required": true,
+          "doc": "A stacked bf-table's sort option for a column in descending order.",
+          "readonly": true,
+          "default": "(column) => `${column}, descending`"
+        },
         {
           "name": "theme",
           "kind": "property",
@@ -1071,6 +1174,33 @@
           "readonly": true,
           "default": "(count) => `${count} new`"
         },
+        {
+          "name": "sidebarCollapse",
+          "kind": "property",
+          "type": "string",
+          "required": true,
+          "doc": "bf-sidebar-toggle's name and tooltip while the sidebar is expanded.",
+          "readonly": true,
+          "default": "'Collapse sidebar'"
+        },
+        {
+          "name": "sidebarExpand",
+          "kind": "property",
+          "type": "string",
+          "required": true,
+          "doc": "bf-sidebar-toggle's name and tooltip while the sidebar is an icon rail.",
+          "readonly": true,
+          "default": "'Expand sidebar'"
+        },
+        {
+          "name": "skipToContent",
+          "kind": "property",
+          "type": "string",
+          "required": true,
+          "doc": "bf-app-frame's skip link, the first stop of the tab order, which moves focus to the content.",
+          "readonly": true,
+          "default": "'Skip to main content'"
+        },
         {
           "name": "pagination",
           "kind": "property",
@@ -1655,6 +1785,30 @@
       "since": "0.1.0",
       "signature": "interface BfSelectOption<T = string>"
     },
+    {
+      "name": "BfSidebarStateService",
+      "slug": "bf-sidebar-state-service",
+      "kind": "service",
+      "entryPoint": "@bitforgehq/ui",
+      "file": "src/config/sidebar-state.ts",
+      "summary": "The sidebar's collapsed state, kept in storage between visits of the app",
+      "description": "Whether the app's `bf-sidebar` is collapsed to an icon rail, remembered between visits: the app\nbinds the sidebar's `[(collapsed)]` to `sidebarState.collapsed`. With `provideBfSidebarState()`\nevery change is stored in `BF_SIDEBAR_STATE_STORAGE` under `bf-sidebar-collapsed`; without it\nthe signal still holds the state but nothing is written. Storage is read in the browser only, so a\nserver render starts expanded and writes nothing. The widgets never inject it.",
+      "members": [
+        {
+          "name": "collapsed",
+          "kind": "property",
+          "type": "WritableSignal<boolean>",
+          "required": false,
+          "doc": "Whether the sidebar is collapsed: the stored state in the browser, else false. Bind it two-way to `bf-sidebar`'s `collapsed`.",
+          "readonly": true
+        }
+      ],
+      "methods": [],
+      "slots": [],
+      "references": [],
+      "usedBy": [],
+      "since": "0.3.2"
+    },
     {
       "name": "BfSize",
       "slug": "bf-size",
@@ -1692,6 +1846,7 @@
         "bf-segmented-component",
         "bf-segmented-size",
         "bf-select-component",
+        "bf-sidebar-toggle-component",
         "bf-tab-group-component",
         "bf-table-component",
         "bf-textarea-component",
@@ -1738,6 +1893,23 @@
       "signature": "type BfSpinnerSize = 'sm' | 'md' | 'lg'",
       "values": ["sm", "md", "lg"]
     },
+    {
+      "name": "BfStatAppearance",
+      "slug": "bf-stat-appearance",
+      "kind": "type",
+      "entryPoint": "@bitforgehq/ui",
+      "file": "src/components/stat/stat.component.ts",
+      "summary": "The three stat surfaces, plain, an outlined card or a sunken tile",
+      "description": "The surface of a `bf-stat`, as its `variant` input takes it: a `BfStatVariant` or tile (a\nsunken, borderless tile for a stats row inside a raised card). A new type, so `Record`s over\nthe released `BfStatVariant` keep compiling.",
+      "members": [],
+      "methods": [],
+      "slots": [],
+      "references": ["bf-stat-variant"],
+      "usedBy": ["bf-stat-component"],
+      "since": "0.3.2",
+      "signature": "type BfStatAppearance = BfStatVariant | 'tile'",
+      "values": ["plain", "card", "tile"]
+    },
     {
       "name": "BfStatTrend",
       "slug": "bf-stat-trend",
@@ -1784,7 +1956,7 @@
       "methods": [],
       "slots": [],
       "references": [],
-      "usedBy": ["bf-stat-component"],
+      "usedBy": ["bf-stat-appearance"],
       "since": "0.3.1",
       "signature": "type BfStatVariant = 'plain' | 'card'",
       "values": ["plain", "card"]
@@ -2144,6 +2316,23 @@
       "signature": "type BfTableSortDirection = 'ascending' | 'descending'",
       "values": ["ascending", "descending"]
     },
+    {
+      "name": "BfTableStack",
+      "slug": "bf-table-stack",
+      "kind": "type",
+      "entryPoint": "@bitforgehq/ui",
+      "file": "src/components/table/table.component.ts",
+      "summary": "When a table stacks its rows into cards: never, when narrow, or under touch",
+      "description": "When a `bf-table` renders each row as a card of label/value pairs: `never` (the default),\n`narrow` while the table is narrower than 36rem (a container query), or `coarse` under a coarse\npointer at any width.",
+      "members": [],
+      "methods": [],
+      "slots": [],
+      "references": [],
+      "usedBy": ["bf-table-component"],
+      "since": "0.3.2",
+      "signature": "type BfTableStack = 'never' | 'narrow' | 'coarse'",
+      "values": ["never", "narrow", "coarse"]
+    },
     {
       "name": "BfTabLinks",
       "slug": "bf-tab-links",
@@ -2419,7 +2608,7 @@
       "entryPoint": "@bitforgehq/ui",
       "file": "src/config/labels.ts",
       "summary": "Replaces built-in strings for an app or a sub-tree, such as a translation",
-      "description": "Replaces built-in strings, merged over the parent's (validation merged key by key); a key left\nout or set to `undefined` keeps the parent's string. In `ApplicationConfig.providers` it covers\nevery string. In a component's `providers` it covers that sub-tree's widgets and form controls\n(`loading`, `dismiss`, `tabBar`, `tabBadge`, `back`, `refreshing`, `tableSelectAll`, `theme`,\n`themeSystem`, `themeLight`, `themeDark`, `breadcrumb`, `breadcrumbExpand`, `navigation`,\n`navBadge`, `pagination`, `previousPage`, `nextPage`, `pageOf`, `goToPage`, `tabGroup`,\n`calendarPreviousMonth`, `calendarNextMonth`, `calendarChooseMonth`, `calendarChooseYear`,\n`statTrendUp`, `statTrendDown`, `statTrendFlat`, `comboboxEmpty`, `comboboxRemove`,\n`dateInputDay`, `dateInputMonth`, `dateInputYear`, `dateInputOpenCalendar`, `dateInputInvalid`,\n`dateInputUnavailable`, `timeInputHour`, `timeInputMinute`, `timeInputSecond`,\n`timeInputDayPeriod`, `timeInputOpenList`, `timeInputInvalid`, `timeInputMin`, `timeInputMax`,\n`chart`, `chartLegend`, `chartValues`, `chartShowData`, `chartHideData`, `chartCategory`,\n`chartValue`, `chartEmpty`, `chartError`, `validation`); the overlay services (`ok`, `cancel`,\n`actions`, `sheet`, `modal`, `close`, `expand`, `collapse`, `sheetPosition`, `dialog`,\n`notifications`) are root singletons and pick it up only when the caller passes its injector:\n`open(…, { injector: inject(Injector) })`.",
+      "description": "Replaces built-in strings, merged over the parent's (validation merged key by key); a key left\nout or set to `undefined` keeps the parent's string. In `ApplicationConfig.providers` it covers\nevery string. In a component's `providers` it covers that sub-tree's widgets and form controls\n(`loading`, `dismiss`, `tabBar`, `tabBadge`, `back`, `refreshing`, `tableSelectAll`, `tableSortBy`,\n`tableSortNone`, `tableSortAscending`, `tableSortDescending`, `theme`, `themeSystem`, `themeLight`, `themeDark`,\n`breadcrumb`, `breadcrumbExpand`, `navigation`, `navBadge`, `sidebarCollapse`, `sidebarExpand`,\n`skipToContent`, `pagination`, `previousPage`, `nextPage`, `pageOf`, `goToPage`, `tabGroup`,\n`calendarPreviousMonth`, `calendarNextMonth`, `calendarChooseMonth`, `calendarChooseYear`,\n`statTrendUp`, `statTrendDown`, `statTrendFlat`, `comboboxEmpty`, `comboboxRemove`,\n`dateInputDay`, `dateInputMonth`, `dateInputYear`, `dateInputOpenCalendar`, `dateInputInvalid`,\n`dateInputUnavailable`, `timeInputHour`, `timeInputMinute`, `timeInputSecond`,\n`timeInputDayPeriod`, `timeInputOpenList`, `timeInputInvalid`, `timeInputMin`, `timeInputMax`,\n`chart`, `chartLegend`, `chartValues`, `chartShowData`, `chartHideData`, `chartCategory`,\n`chartValue`, `chartEmpty`, `chartError`, `validation`); the overlay services (`ok`, `cancel`,\n`actions`, `sheet`, `modal`, `close`, `expand`, `collapse`, `sheetPosition`, `dialog`,\n`notifications`) are root singletons and pick it up only when the caller passes its injector:\n`open(…, { injector: inject(Injector) })`.",
       "members": [],
       "methods": [
         {
@@ -2434,7 +2623,7 @@
             }
           ],
           "returns": "Provider",
-          "doc": "Replaces built-in strings, merged over the parent's (validation merged key by key); a key left\nout or set to `undefined` keeps the parent's string. In `ApplicationConfig.providers` it covers\nevery string. In a component's `providers` it covers that sub-tree's widgets and form controls\n(`loading`, `dismiss`, `tabBar`, `tabBadge`, `back`, `refreshing`, `tableSelectAll`, `theme`,\n`themeSystem`, `themeLight`, `themeDark`, `breadcrumb`, `breadcrumbExpand`, `navigation`,\n`navBadge`, `pagination`, `previousPage`, `nextPage`, `pageOf`, `goToPage`, `tabGroup`,\n`calendarPreviousMonth`, `calendarNextMonth`, `calendarChooseMonth`, `calendarChooseYear`,\n`statTrendUp`, `statTrendDown`, `statTrendFlat`, `comboboxEmpty`, `comboboxRemove`,\n`dateInputDay`, `dateInputMonth`, `dateInputYear`, `dateInputOpenCalendar`, `dateInputInvalid`,\n`dateInputUnavailable`, `timeInputHour`, `timeInputMinute`, `timeInputSecond`,\n`timeInputDayPeriod`, `timeInputOpenList`, `timeInputInvalid`, `timeInputMin`, `timeInputMax`,\n`chart`, `chartLegend`, `chartValues`, `chartShowData`, `chartHideData`, `chartCategory`,\n`chartValue`, `chartEmpty`, `chartError`, `validation`); the overlay services (`ok`, `cancel`,\n`actions`, `sheet`, `modal`, `close`, `expand`, `collapse`, `sheetPosition`, `dialog`,\n`notifications`) are root singletons and pick it up only when the caller passes its injector:\n`open(…, { injector: inject(Injector) })`."
+          "doc": "Replaces built-in strings, merged over the parent's (validation merged key by key); a key left\nout or set to `undefined` keeps the parent's string. In `ApplicationConfig.providers` it covers\nevery string. In a component's `providers` it covers that sub-tree's widgets and form controls\n(`loading`, `dismiss`, `tabBar`, `tabBadge`, `back`, `refreshing`, `tableSelectAll`, `tableSortBy`,\n`tableSortNone`, `tableSortAscending`, `tableSortDescending`, `theme`, `themeSystem`, `themeLight`, `themeDark`,\n`breadcrumb`, `breadcrumbExpand`, `navigation`, `navBadge`, `sidebarCollapse`, `sidebarExpand`,\n`skipToContent`, `pagination`, `previousPage`, `nextPage`, `pageOf`, `goToPage`, `tabGroup`,\n`calendarPreviousMonth`, `calendarNextMonth`, `calendarChooseMonth`, `calendarChooseYear`,\n`statTrendUp`, `statTrendDown`, `statTrendFlat`, `comboboxEmpty`, `comboboxRemove`,\n`dateInputDay`, `dateInputMonth`, `dateInputYear`, `dateInputOpenCalendar`, `dateInputInvalid`,\n`dateInputUnavailable`, `timeInputHour`, `timeInputMinute`, `timeInputSecond`,\n`timeInputDayPeriod`, `timeInputOpenList`, `timeInputInvalid`, `timeInputMin`, `timeInputMax`,\n`chart`, `chartLegend`, `chartValues`, `chartShowData`, `chartHideData`, `chartCategory`,\n`chartValue`, `chartEmpty`, `chartError`, `validation`); the overlay services (`ok`, `cancel`,\n`actions`, `sheet`, `modal`, `close`, `expand`, `collapse`, `sheetPosition`, `dialog`,\n`notifications`) are root singletons and pick it up only when the caller passes its injector:\n`open(…, { injector: inject(Injector) })`."
         }
       ],
       "slots": [],
@@ -2443,6 +2632,30 @@
       "since": "0.3.0",
       "signature": "function provideBfLabels(overrides: BfLabelsOverrides): Provider"
     },
+    {
+      "name": "provideBfSidebarState",
+      "slug": "provide-bf-sidebar-state",
+      "kind": "function",
+      "entryPoint": "@bitforgehq/ui",
+      "file": "src/config/sidebar-state.ts",
+      "summary": "Remembers the collapsed sidebar between visits, for desktop web apps",
+      "description": "Lets `BfSidebarStateService` remember the collapsed sidebar: it stores every change of its\n`collapsed` signal (key `bf-sidebar-collapsed`, `localStorage` in the browser), so the app opens\nwith the sidebar as the user left it. Add it to `ApplicationConfig.providers` and bind the\nsidebar's `[(collapsed)]` to `sidebarState.collapsed`.",
+      "members": [],
+      "methods": [
+        {
+          "name": "provideBfSidebarState",
+          "signature": "provideBfSidebarState(): EnvironmentProviders",
+          "params": [],
+          "returns": "EnvironmentProviders",
+          "doc": "Lets `BfSidebarStateService` remember the collapsed sidebar: it stores every change of its\n`collapsed` signal (key `bf-sidebar-collapsed`, `localStorage` in the browser), so the app opens\nwith the sidebar as the user left it. Add it to `ApplicationConfig.providers` and bind the\nsidebar's `[(collapsed)]` to `sidebarState.collapsed`."
+        }
+      ],
+      "slots": [],
+      "references": [],
+      "usedBy": [],
+      "since": "0.3.2",
+      "signature": "function provideBfSidebarState(): EnvironmentProviders"
+    },
     {
       "name": "BF_DESKTOP_TOAST_DEFAULTS",
       "slug": "bf_desktop_toast_defaults",
@@ -9424,10 +9637,48 @@
       ],
       "slots": [],
       "references": [],
-      "usedBy": [],
+      "usedBy": ["bf-table-harness"],
       "since": "0.3.0",
       "signature": "class BfSelectHarness extends ComponentHarness"
     },
+    {
+      "name": "BfSidebarToggleHarness",
+      "slug": "bf-sidebar-toggle-harness",
+      "kind": "class",
+      "entryPoint": "@bitforgehq/ui/testing",
+      "file": "testing/harnesses/sidebar-toggle.harness.ts",
+      "summary": "Test harness for a sidebar toggle: reads and flips the collapsed sidebar",
+      "description": "Harness for `bf-sidebar-toggle`, the button that collapses a `bf-sidebar` to an icon rail. Its\n`label` filter matches the button's name (\"Collapse sidebar\" or \"Expand sidebar\").",
+      "members": [],
+      "methods": [
+        {
+          "name": "getLabel",
+          "signature": "getLabel(): Promise<string>",
+          "params": [],
+          "returns": "Promise<string>",
+          "doc": "The button's name, which says what the next press does."
+        },
+        {
+          "name": "isExpanded",
+          "signature": "isExpanded(): Promise<boolean>",
+          "params": [],
+          "returns": "Promise<boolean>",
+          "doc": "Whether the sidebar is at full width (`aria-expanded`)."
+        },
+        {
+          "name": "toggle",
+          "signature": "toggle(): Promise<void>",
+          "params": [],
+          "returns": "Promise<void>",
+          "doc": "Flips the sidebar with a click."
+        }
+      ],
+      "slots": [],
+      "references": [],
+      "usedBy": [],
+      "since": "0.3.2",
+      "signature": "class BfSidebarToggleHarness extends ComponentHarness"
+    },
     {
       "name": "BfSidePanelHarness",
       "slug": "bf-side-panel-harness",
@@ -9532,7 +9783,7 @@
       "entryPoint": "@bitforgehq/ui/testing",
       "file": "testing/harnesses/table.harness.ts",
       "summary": "Test harness for the data table: reads rows and cells, sorts and selects rows",
-      "description": "Harness for `bf-table`. It works by column header text and row position, so a test never needs\nthe column keys or the row keys (except `getSort()`, which returns the column's `key`, as the\n`sort` model holds it).",
+      "description": "Harness for `bf-table`. It works by column header text and row position, so a test never needs\nthe column keys or the row keys (except `getSort()`, which returns the column's `key`, as the\n`sort` model holds it). It reads and drives a stacked table (`stack`) the same way.",
       "members": [],
       "methods": [
         {
@@ -9597,6 +9848,13 @@
           "returns": "Promise<BfTableSort | null>",
           "doc": "The sorted column (its `key`) and direction, from `aria-sort`."
         },
+        {
+          "name": "getSortSelect",
+          "signature": "getSortSelect(): Promise<BfSelectHarness | null>",
+          "params": [],
+          "returns": "Promise<BfSelectHarness | null>",
+          "doc": "The Sort by select in a stacked table's bar: its first option, Not sorted (`tableSortNone`),\nsets `sort` to null and shows while it is; then each sortable column ascending and descending."
+        },
         {
           "name": "selectRow",
           "signature": "selectRow(index: number): Promise<void>",
@@ -9627,7 +9885,7 @@
         }
       ],
       "slots": [],
-      "references": ["bf-table-sort"],
+      "references": ["bf-select-harness", "bf-table-sort"],
       "usedBy": [],
       "since": "0.3.1",
       "signature": "class BfTableHarness extends ComponentHarness"