@brandsync/wc 1.19.0 → 1.20.0

package/dist/types/components/bs-icon/bs-icon.stories.d.ts

@@ -0,0 +1,16 @@
+import type { Meta, StoryObj } from '@storybook/web-components-vite';
+interface BsIconArgs {
+    name: string;
+    size: 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+    tone: 'default' | 'muted' | 'action' | 'success' | 'info' | 'warning' | 'error' | 'inverse' | 'inherit';
+    label: string;
+}
+declare const meta: Meta<BsIconArgs>;
+export default meta;
+type Story = StoryObj<BsIconArgs>;
+export declare const Default: Story;
+export declare const AllNames: Story;
+export declare const Sizes: Story;
+export declare const Tones: Story;
+export declare const Labelled: Story;
+export declare const Slotted: Story;

package/dist/types/components/bs-icon/icon-registry.d.ts

@@ -0,0 +1,16 @@
+/** An icon drawn on its own grid with filled (not stroked) shapes, e.g. Phosphor's 256x256 glyphs. */
+export interface BsIconDefinition {
+    viewBox: string;
+    body: string;
+}
+export type BsIconEntry = string | BsIconDefinition;
+/**
+ * Register (or replace) named icons. Values are inner SVG markup for a 24x24 viewBox using
+ * `currentColor` strokes, or `{ viewBox, body }` for filled glyphs on another grid (rendered with `fill="currentColor"`). Only register markup you trust: it is inserted as-is.
+ * Already-rendered `bs-icon`s pick up new names on their next render.
+ */
+export declare function registerIcons(icons: Record<string, BsIconEntry>): void;
+/** The entry (inner SVG markup string, or `{ viewBox, body }`) registered under `name`, or undefined. */
+export declare function getIcon(name: string | undefined): BsIconEntry | undefined;
+/** All registered icon names. */
+export declare function iconNames(): string[];

package/dist/types/components/bs-input/bs-input.d.ts

@@ -5,7 +5,9 @@ import { EventEmitter } from '../../stencil-public-runtime';
  * select, textarea, chip input, initials, country, and pin) via the `type` prop, since they all
  * share the same label/description/error/icon-slot chrome.
  *
- * Built from: `bs-menu`/`bs-menu-item` (`type="dropdown"`) and `bs-chip-informative` + `bs-icon-button` (`type="chip"`).
+ * Built from: `bs-menu`/`bs-menu-item` (`type="dropdown"`), `bs-chip-informative` + `bs-icon-button` (`type="chip"`),
+ * and `bs-icon-button` + `bs-spinner` (`type="combobox"` clear button / loading indicator; its listbox is a
+ * hand-built `role="listbox"` because `bs-menu` is `role="menu"` and cannot host `option`s).
  *
  * ## When to use
  * - Collecting a single line of free-text, email, password, or numeric input.
@@ -28,13 +30,15 @@ import { EventEmitter } from '../../stencil-public-runtime';
  *   For `type="date"`, the slot is used if provided, otherwise a default calendar icon is shown.
  * @part field - The bordered field wrapper containing the icon(s) and native control(s).
  *   `type="initials"` renders this part on TWO separate elements instead of one (the title
- *   `<select>`'s own small box, and the name `<input>`'s own box) -- Figma specs these as two
+ *   picker's own small box, and the name `<input>`'s own box) -- Figma specs these as two
  *   genuinely independent bordered containers with a gap between them, not one shared field the
- *   way every other composite type (`country` included) renders, so `::part(field)` reaches
+ *   way every other composite type renders, so `::part(field)` reaches
  *   whichever of the two a given selector context matches, same "multiple elements, one shared
  *   part name" convention as `bs-attachment`'s own `star` part.
  * @part menu - The `bs-menu` rendered below the field for `type="dropdown"` when `open` and
- *   `options` is non-empty.
+ *   `options` is non-empty; for `type="combobox"` the popup (listbox + status message) while `open`.
+ * @part option - A single `role="option"` row of the `type="combobox"` listbox.
+ * @part clear - The clear button (`bs-icon-button`) of `type="combobox"`.
  * @part label - The `<label>` element.
  * @part required - The red `*` rendered after the label text when `required` is set.
  * @part icon - The leading icon wrapper element.
@@ -65,8 +69,12 @@ export declare class BsInput {
     incrementLabel: string;
     /** Accessible name of the number stepper's decrement button. */
     decrementLabel: string;
-    type: 'text' | 'email' | 'password' | 'number' | 'search' | 'date' | 'dropdown' | 'select' | 'textarea' | 'chip' | 'initials' | 'country' | 'pin';
+    type: 'text' | 'email' | 'password' | 'number' | 'search' | 'date' | 'dropdown' | 'select' | 'textarea' | 'chip' | 'initials' | 'country' | 'pin' | 'combobox';
     label?: string;
+    /** Accessible name for the control, used only when no visible `label` is set (e.g. a search field
+     * with no visible label). Passed to the inner native control, because an `aria-label` on the
+     * `<bs-input>` host cannot name an element inside its shadow root. */
+    ariaLabel: string | null;
     placeholder?: string;
     description?: string;
     error?: string;
@@ -80,7 +88,7 @@ export declare class BsInput {
     min?: number;
     /** Maximum value for `type="number"`'s stepper buttons. */
     max?: number;
-    /** Options for `type="select"` (rendered as native `<option>`s) and `type="dropdown"` (rendered
+    /** Options for `type="select"` (rendered as `role="option"` rows of an in-shadow listbox) and `type="dropdown"` (rendered
      * as a `bs-menu` of `bs-menu-item`s when `open`). Must be set as a JS property, not an HTML
      * attribute -- see CONVENTIONS.md's non-string props rule. */
     options: {
@@ -99,6 +107,8 @@ export declare class BsInput {
      * `title` is a reserved standard HTML attribute (tooltip text) inherited by every element, and
      * Stencil warns against shadowing it with a component `@Prop`. */
     initialsTitle: string;
+    /** `type="initials"`: accessible name of the title picker (its visible text is just the title). */
+    titleLabel: string;
     /** Country select options for `type="country"`. Must be set as a JS property, not an HTML
      * attribute -- see CONVENTIONS.md's non-string props rule. */
     countryOptions: {
@@ -108,9 +118,26 @@ export declare class BsInput {
     }[];
     /** Current selected country code for `type="country"`. */
     country: string;
+    /** `type="country"`: accessible name of the country picker (its visible content is just the flag). */
+    countryLabel: string;
     /** Number of cells for `type="pin"`. */
     length: number;
-    /** Whether the `type="dropdown"` trigger is open. Reflects to an attribute so consumers can style
+    /** `type="combobox"`: shows a loading indicator and, while no options match, a loading message
+     * in the popup instead of "no results". Use while fetching `options` asynchronously. */
+    loading: boolean;
+    /** `type="combobox"`: when true (default) `options` are filtered client-side by whether the label
+     * contains the typed text. Set false when you supply already-filtered results yourself (e.g. from
+     * a server) in response to `bsInput`. */
+    filterOptions: boolean;
+    /** `type="combobox"`: text of the popup row shown when no option matches. */
+    noResultsLabel: string;
+    /** `type="combobox"`: text of the popup row shown while `loading` and nothing matches. */
+    loadingLabel: string;
+    /** `type="combobox"`: accessible name of the clear button. */
+    clearLabel: string;
+    /** `type="date"`: accessible name of the default calendar button that opens the native picker. */
+    openPickerLabel: string;
+    /** Whether the `type="dropdown"` / `type="combobox"` popup is open. Reflects to an attribute so consumers can style
      * an open state via CSS. When `options` is non-empty, this also controls whether the `bs-menu`
      * of `bs-menu-item`s is rendered below the field. */
     open: boolean;
@@ -120,12 +147,18 @@ export declare class BsInput {
      * shell-only limitation. */
     bsOpen: EventEmitter<boolean>;
     /** Emitted when a chip is committed (Enter pressed in the draft input) for `type="chip"`. */
+    /** Emitted when an option is chosen for `type="combobox"` (click or Enter), with the option's
+     * `{ label, value }`. `value` of the component itself becomes the option's label (the text shown). */
+    bsOptionSelect: EventEmitter<{
+        label: string;
+        value: string;
+    }>;
     bsChipAdd: EventEmitter<string>;
     /** Emitted when a chip's remove button is clicked for `type="chip"`. */
     bsChipRemove: EventEmitter<string>;
-    /** Emitted when the title `<select>` changes for `type="initials"`. */
+    /** Emitted when a title is chosen from the picker for `type="initials"`. */
     bsTitleChange: EventEmitter<string>;
-    /** Emitted when the country `<select>` changes for `type="country"`. */
+    /** Emitted when a country is chosen from the picker for `type="country"`. */
     bsCountryChange: EventEmitter<string>;
     /** Tracks whether the `icon` slot has assigned content, so the leading icon wrapper only takes
      * up space in the field when there's actually an icon (same pattern as `bs-button`). */
@@ -138,7 +171,23 @@ export declare class BsInput {
     passwordVisible: boolean;
     /** Draft text for `type="chip"`'s trailing input, committed to a chip on Enter. */
     chipDraft: string;
+    /** Index into the visible (filtered) options of the active option for `type="combobox"`, -1 for none. */
+    activeIndex: number;
+    /** True once the user has typed in the `type="combobox"` input, so opening it with a value that is
+     * already a chosen label still lists every option instead of only that one. */
+    comboFiltering: boolean;
     private pinInputs;
+    private get isPopupType();
+    /** `select`, `initials` (title) and `country` render a trigger button plus an in-shadow listbox
+     * styled like `bs-menu`, instead of a native `<select>` whose popup cannot be themed. */
+    private get isPickerType();
+    private typeahead;
+    private typeaheadTimer?;
+    private get pickerItems();
+    private get pickerSelectedValue();
+    private get pickerSelectedIndex();
+    private get visibleOptions();
+    componentDidRender(): void;
     /** Computes the initial `hasIcon`/`hasEndIcon` state directly from the host's light DOM
      * children, before first render -- see `bs-button`'s `componentWillLoad` for why `slotchange`
      * alone isn't enough for a slot that starts (and stays) empty. */
@@ -155,6 +204,11 @@ export declare class BsInput {
     private onIconSlotchange;
     private onEndIconSlotchange;
     private onInput;
+    private setOpen;
+    private onComboboxKeydown;
+    private selectComboOption;
+    private onClear;
+    private onDatePickerOpen;
     private onChange;
     private clampNumber;
     private onStepperIncrement;
@@ -171,11 +225,18 @@ export declare class BsInput {
      * a click outside that moves focus elsewhere) -- `focusout` is composed, so it bubbles across
      * the `bs-menu-item` shadow boundary too. */
     onHostFocusOut(ev: FocusEvent): void;
+    /** Closes an open picker on a click anywhere outside the component (focusout alone misses clicks
+     * on non-focusable page areas in some browsers). */
+    onDocumentClick(ev: MouseEvent): void;
     private onChipDraftInput;
     private onChipDraftKeydown;
     private onChipRemove;
-    private onTitleChange;
-    private onCountryChange;
+    private pickerCommit;
+    private pickerOpen;
+    private onPickerToggle;
+    private onPickerOptionClick;
+    private onPickerKeyup;
+    private onPickerKeydown;
     private onPinInput;
     private onPinKeydown;
     private get showsEndIconArea();
@@ -183,13 +244,23 @@ export declare class BsInput {
     private renderIconContent;
     private renderEndIconContent;
     private renderStandardControl;
+    /** An image URL flag renders as `<img>`; anything else (an emoji) as text. */
+    private renderFlag;
+    /** The trigger button of the select/title/country pickers: a focusable `role="combobox"` whose
+     * listbox lives in this same shadow root so aria-controls/aria-activedescendant resolve. */
+    private renderPickerTrigger;
+    private renderPickerPopup;
     private renderSelectControl;
     private renderTextareaControl;
     private renderChipControl;
     private renderInitialsField;
+    private renderCountryField;
     private renderSelectChevron;
-    private renderCountryControl;
     private renderControl;
+    private onComboboxFieldClick;
+    /** The `type="combobox"` popup. Rendered inside this shadow root so `aria-controls` and
+     * `aria-activedescendant` on the input resolve to real elements. */
+    private renderComboboxPopup;
     private renderField;
     private renderPinField;
     render(): any;

package/dist/types/components/bs-input/bs-input.stories.d.ts

@@ -1,5 +1,5 @@
 import type { Meta, StoryObj } from '@storybook/web-components-vite';
-type BsInputType = 'text' | 'email' | 'password' | 'number' | 'search' | 'date' | 'dropdown' | 'select' | 'textarea' | 'chip' | 'initials' | 'country' | 'pin';
+type BsInputType = 'text' | 'email' | 'password' | 'number' | 'search' | 'date' | 'dropdown' | 'select' | 'textarea' | 'chip' | 'initials' | 'country' | 'pin' | 'combobox';
 interface BsInputArgs {
     type: BsInputType;
     label: string;
@@ -26,6 +26,8 @@ export declare const NumberInput: Story;
 export declare const Password: Story;
 export declare const DateInput: Story;
 export declare const Dropdown: Story;
+export declare const Combobox: Story;
+export declare const ComboboxLoading: Story;
 export declare const Select: Story;
 export declare const TextArea: Story;
 export declare const Chip: Story;

package/dist/types/components/bs-link/bs-link.cmp.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/components/bs-link/bs-link.d.ts

@@ -0,0 +1,48 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+export type BsLinkVariant = 'inline' | 'standalone' | 'button';
+/**
+ * A navigation link: either text (inline within a sentence, or standalone with a 44px target) or a
+ * link styled as a primary button. Always renders a real `<a href>`.
+ *
+ * Built from: hand-built `<a>` (leaf). `bs-button` renders a `<button>` and has no `href`; nesting a
+ * button in an anchor is invalid HTML, so the `button` variant reuses the primary button's colour
+ * tokens instead. Known gap: add `href` support to `bs-button` and compose it here.
+ *
+ * ## When to use
+ * - Navigating to another page or an external resource.
+ *
+ * ## When not to use
+ * - Triggering an action on the current page (use `bs-button`).
+ *
+ * @slot - Default slot: the link text.
+ * @part link - The anchor element.
+ * @part label - The text wrapper.
+ * @part icon - The external-link icon.
+ */
+export declare class BsLink {
+    /** Destination. */
+    href?: string;
+    /** Browsing context (e.g. `_blank`). `_blank` implies the external icon. */
+    target?: string;
+    /** Link relationship. Defaults to `noopener noreferrer` when `target="_blank"`. */
+    rel?: string;
+    /** `inline` sits in running text; `standalone` has a 44px minimum touch target; `button` is
+     * styled as a primary button (also 44px). */
+    variant: BsLinkVariant;
+    /** Shows the external-link icon (always shown for `target="_blank"`). */
+    external: boolean;
+    /** Visually hidden suffix announced for links that open in a new tab. */
+    externalLabel: string;
+    /** Marks the link as the current page (`aria-current="page"`). */
+    current: boolean;
+    /** Accessible name override (needed on the host, as `aria-label` does not cross the shadow boundary). */
+    ariaLabel: string | null;
+    /** Fires on a plain primary click before the browser navigates. **Cancelable**: call
+     * `preventDefault()` to route it yourself (SPA router). Detail is `{ href }`. Ctrl/cmd/shift/alt
+     * and middle clicks are left to the browser. Bubbles and is composed. */
+    bsNavigate: EventEmitter<{
+        href: string;
+    }>;
+    private onClick;
+    render(): any;
+}

package/dist/types/components/bs-link/bs-link.stories.d.ts

@@ -0,0 +1,19 @@
+import type { Meta, StoryObj } from '@storybook/web-components-vite';
+type BsLinkVariant = 'inline' | 'standalone' | 'button';
+interface BsLinkArgs {
+    variant: BsLinkVariant;
+    href: string;
+    target: string;
+    external: boolean;
+    current: boolean;
+    label: string;
+}
+declare const meta: Meta<BsLinkArgs>;
+export default meta;
+type Story = StoryObj<BsLinkArgs>;
+export declare const Default: Story;
+export declare const Inline: Story;
+export declare const Standalone: Story;
+export declare const External: Story;
+export declare const LinkButton: Story;
+export declare const Current: Story;

package/dist/types/components/bs-list/bs-list.d.ts

@@ -11,6 +11,10 @@ import { EventEmitter } from '../../stencil-public-runtime';
  * - Navigation between app sections -- use `bs-navigation-drawer`.
  * - Multi-column, sortable or paged data -- use `bs-data-table`.
  *
+ * `variant` switches between a plain list, a bulleted list and a numbered list; `dividers` gives a divided
+ * list. The list keeps real list semantics in every variant (`role="list"` with `listitem` rows); the bullet
+ * or number is drawn by the row and hidden from assistive technology, which announces position itself.
+ *
  * Built from `bs-list-item` children (light DOM; the list never moves nodes).
  *
  * @slot - The `bs-list-item` rows.
@@ -24,6 +28,8 @@ export declare class BsList {
     selectable: boolean;
     /** `value` of the selected item (selectable mode). */
     value: string | null;
+    /** `plain` (default), `bulleted` (a bullet before each row) or `numbered` (1., 2., 3., ...). Ignored when `selectable`. */
+    variant: 'plain' | 'bulleted' | 'numbered';
     /** Draws a 1px separator between rows. */
     dividers: boolean;
     /** Accessible name of the list. */

package/dist/types/components/bs-list/bs-list.stories.d.ts

@@ -2,6 +2,7 @@ import type { Meta, StoryObj } from '@storybook/web-components-vite';
 interface BsListArgs {
     selectable: boolean;
     dividers: boolean;
+    variant: 'plain' | 'bulleted' | 'numbered';
     value: string;
 }
 declare const meta: Meta<BsListArgs>;
@@ -11,3 +12,6 @@ export declare const Default: Story;
 export declare const Selectable: Story;
 export declare const WithDividers: Story;
 export declare const AvatarList: Story;
+export declare const Bulleted: Story;
+export declare const Numbered: Story;
+export declare const DividedWithTrailingAction: Story;

package/dist/types/components/bs-list-item/bs-list-item.d.ts

@@ -24,6 +24,7 @@ import { EventEmitter } from '../../stencil-public-runtime';
  * @slot trailing - Replaces the default caret. Rendered when `showArrow` is set or the slot has content.
  * @slot - Rich content that replaces `label`, `description` and `supportText` entirely.
  * @part container - The row.
+ * @part marker - The bullet or number drawn by a bulleted / numbered `bs-list`.
  * @part leading - Wrapper around the leading slot.
  * @part content - The text column.
  * @part label - The label line.
@@ -72,6 +73,8 @@ export declare class BsListItem {
     interactive: boolean;
     /** Set by the parent `bs-list`: `listitem` (plain list) or `option` (selectable list). Do not set by hand. */
     selectionRole: 'listitem' | 'option' | null;
+    /** Set by the parent `bs-list` for `bulleted` / `numbered` variants: the visual marker. Hidden from assistive technology. Do not set by hand. */
+    marker: string | null;
     hasLeading: boolean;
     hasTrailing: boolean;
     hasDefault: boolean;

package/dist/types/components/bs-radio/bs-radio.d.ts

@@ -28,6 +28,10 @@ export declare class BsRadio {
     /** The native radio input's `value` attribute -- read from `event.target.value`, or used when
      * wiring the group up to a form. */
     value: string;
+    /** Accessible name for the radio, set as `aria-label` on the native input. Use it when the radio
+     * has no slotted label text (an icon-only choice) or its visible label lives elsewhere. Same as
+     * `bs-checkbox` / `bs-switch`. */
+    ariaLabel: string | null;
     /** Whether the radio is checked. Mutable so clicking the label/input sets it directly. */
     checked: boolean;
     /** Disables the radio: sets the native `disabled` attribute, suppresses hover/focus styling, and

package/dist/types/components/bs-radio-group/bs-radio-group.cmp.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/components/bs-radio-group/bs-radio-group.d.ts

@@ -0,0 +1,57 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+export type BsRadioGroupOrientation = 'vertical' | 'horizontal';
+/**
+ * A labelled group of `bs-radio`s: a visible label, helper or error text, an accessible
+ * `role="radiogroup"`, and a single `value` for the whole set.
+ *
+ * The group gives its radios one shared `name` (its own `name`, or a generated one) so they behave
+ * as one native-style group: arrow keys move the selection (wrapping), only the checked radio is in
+ * the tab order, and checking one unchecks the others. It keeps at most one radio checked (the
+ * first one wins if several start checked).
+ *
+ * Composed from: `bs-radio` (slotted by you).
+ *
+ * ## When to use
+ * - A set of 2-5 mutually exclusive options that should all stay visible, with a shared label.
+ *
+ * ## When not to use
+ * - Independent yes/no choices: use `bs-checkbox-group`.
+ * - Many options: use a select or `bs-menu`.
+ *
+ * @slot - The `bs-radio` elements.
+ * @part group - The `role="radiogroup"` element.
+ * @part label - The visible label.
+ * @part options - The wrapper laying out the radios (column, or row when `orientation="horizontal"`).
+ * @part description - The helper text (hidden while `error` is set).
+ * @part error - The error message.
+ */
+export declare class BsRadioGroup {
+    el: HTMLElement;
+    private id;
+    /** Visible group label, also the accessible name of the group. */
+    label?: string;
+    /** Helper text under the options. Replaced by `error` while that is set. */
+    description?: string;
+    /** Error message. Sets `aria-invalid`, replaces the helper text and is announced with the group. */
+    error?: string;
+    /** Layout of the radios. */
+    orientation: BsRadioGroupOrientation;
+    /** `name` given to every radio in the group. Defaults to a generated, unique name. */
+    name?: string;
+    /** `value` of the checked radio. Setting it checks the matching radio (and unchecks the rest). */
+    value?: string;
+    /** Marks the group as required: sets `aria-required` and shows an asterisk after the label. */
+    required: boolean;
+    /** Check the first enabled radio when none is checked, so a choice is always made. Off by default so a form can start empty. */
+    selectFirst: boolean;
+    /** Emitted with the new `value` when the user checks a radio. Replaces the radios' own `bsChange`, which does not reach listeners outside the group. */
+    bsChange: EventEmitter<string>;
+    private radios;
+    onValueOrName(): void;
+    componentWillLoad(): void;
+    /** Shared name on every radio, then reconcile checked state with `value`. */
+    private sync;
+    private onSlotchange;
+    onRadioChange(ev: CustomEvent<string>): void;
+    render(): any;
+}

package/dist/types/components/bs-radio-group/bs-radio-group.stories.d.ts

@@ -0,0 +1,16 @@
+import type { Meta, StoryObj } from '@storybook/web-components-vite';
+interface BsRadioGroupArgs {
+    label: string;
+    description: string;
+    error: string;
+    orientation: 'vertical' | 'horizontal';
+    required: boolean;
+    value: string;
+}
+declare const meta: Meta<BsRadioGroupArgs>;
+export default meta;
+type Story = StoryObj<BsRadioGroupArgs>;
+export declare const Default: Story;
+export declare const Horizontal: Story;
+export declare const WithHelperText: Story;
+export declare const WithError: Story;

package/dist/types/components/bs-select/bs-select.cmp.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/components/bs-select/bs-select.d.ts

@@ -0,0 +1,85 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+export interface BsSelectOption {
+    label: string;
+    value: string;
+    disabled?: boolean;
+}
+/**
+ * A single-choice select: a field-shaped combobox that opens a scrollable listbox of options. Same
+ * label / helper text / error chrome as `bs-input`.
+ *
+ * Follows the WAI-ARIA select-only combobox pattern: focus stays on the combobox and the
+ * highlighted option is exposed through `aria-activedescendant`.
+ *
+ * Built from: the field/label/description/error styling language of `bs-input` (same `--bs-input-*`
+ * tokens). The listbox rows are hand-built leaf elements: `bs-menu-item` is a `role="menuitem"`
+ * button and `bs-popover` moves focus into its popup, neither of which fits the combobox/listbox
+ * pattern where focus must stay on the field.
+ *
+ * ## When to use
+ * - Choosing exactly one value from a known list of roughly 4-15 options.
+ *
+ * ## When not to use
+ * - 2-3 options that should all be visible (use radios or `bs-toggle-button-group`).
+ * - Very long or searchable lists (use `bs-input type="dropdown"` or a search pattern).
+ *
+ * @part label - The label element.
+ * @part field - The bordered combobox element.
+ * @part value - The selected label (or placeholder).
+ * @part icon - The chevron.
+ * @part listbox - The popup listbox.
+ * @part option - A single option row.
+ * @part description - Helper text (hidden when `error` is set).
+ * @part error - Error message.
+ */
+export declare class BsSelect {
+    el: HTMLElement;
+    internals: ElementInternals;
+    private uid;
+    private initialValue;
+    private typeahead;
+    private typeaheadTimer?;
+    private listEl?;
+    private fieldEl?;
+    /** Name the value is submitted under in a surrounding `<form>`. */
+    name?: string;
+    /** The selected option's `value`. */
+    value: string;
+    /** The options. Must be set as a JS property, not an attribute. */
+    options: BsSelectOption[];
+    /** Visible label. */
+    label?: string;
+    /** Accessible name when there is no visible `label`. */
+    ariaLabel: string | null;
+    /** Text shown while no option is selected. */
+    placeholder: string;
+    /** Helper text below the field (replaced by `error` when set). */
+    description?: string;
+    /** Error message; puts the field in its error state. */
+    error?: string;
+    /** Disables the select. */
+    disabled: boolean;
+    /** Marks the field required (native form validation + asterisk). */
+    required: boolean;
+    /** Whether the listbox is open. */
+    open: boolean;
+    /** Emitted when the user picks an option, with the new value. */
+    bsChange: EventEmitter<string>;
+    activeIndex: number;
+    syncForm(): void;
+    onOpen(next: boolean): void;
+    formResetCallback(): void;
+    componentWillLoad(): void;
+    componentDidRender(): void;
+    disconnectedCallback(): void;
+    private onDocClick;
+    /** Next enabled index after `from` in direction `dir`; stays on `from` (or -1) when none. */
+    private step;
+    private commit;
+    private selectedIndex;
+    private findByPrefix;
+    private onKeyDown;
+    private onFieldClick;
+    private onBlur;
+    render(): any;
+}

package/dist/types/components/bs-select/bs-select.stories.d.ts

@@ -0,0 +1,19 @@
+import type { Meta, StoryObj } from '@storybook/web-components-vite';
+interface BsSelectArgs {
+    label: string;
+    placeholder: string;
+    description: string;
+    error: string;
+    disabled: boolean;
+    required: boolean;
+    value: string;
+}
+declare const meta: Meta<BsSelectArgs>;
+export default meta;
+type Story = StoryObj<BsSelectArgs>;
+export declare const Default: Story;
+export declare const WithHelperText: Story;
+export declare const Selected: Story;
+export declare const Error: Story;
+export declare const Disabled: Story;
+export declare const LongList: Story;

package/dist/types/components/bs-skip-link/bs-skip-link.cmp.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/components/bs-skip-link/bs-skip-link.d.ts

@@ -0,0 +1,40 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+/**
+ * A "skip to main content" link: invisible until it receives keyboard focus, then shown at the top
+ * of the page. Activating it moves focus to the element its `href` points at, so keyboard and
+ * screen-reader users can bypass repeated navigation (WCAG 2.4.1 Bypass Blocks).
+ *
+ * Place it as the very first focusable element on the page. Renders a real `<a>`; the focus move is
+ * done explicitly (the target gets a temporary `tabindex="-1"` when it is not natively focusable),
+ * because a fragment navigation alone does not reliably move focus in every browser.
+ *
+ * ## When to use
+ * - Once per page, before the header/navigation, pointing at the `<main>` landmark.
+ * - Additionally before large repeated blocks (e.g. a long sidebar) pointing past them.
+ *
+ * ## When not to use
+ * - As a general in-page link -- use a plain link or `bs-table-of-contents`.
+ * - When the page has no repeated blocks before its main content.
+ *
+ * Composition: a leaf element (a single anchor); no existing `bs-*` component renders a link.
+ *
+ * @slot - Default slot: the link text. Falls back to "Skip to main content".
+ * @part link - The anchor element.
+ */
+export declare class BsSkipLink {
+    el: HTMLElement;
+    /** Target to skip to: a fragment (`#main-content`) naming an element id in the same document or
+     * shadow tree, or any URL (then the browser just navigates). Point it at an element that exists --
+     * if the id is not found, activating the link does nothing beyond the native fragment jump. */
+    href: string;
+    /** Fires when the link is activated, before focus moves. **Cancelable**: `preventDefault()` stops
+     * both the focus move and the native navigation so you can handle it yourself. Detail is
+     * `{ href, target }` (`target` is the resolved element or `null`). Bubbles and is composed. */
+    bsSkip: EventEmitter<{
+        href: string;
+        target: HTMLElement | null;
+    }>;
+    private resolveTarget;
+    private onClick;
+    render(): any;
+}

package/dist/types/components/bs-skip-link/bs-skip-link.stories.d.ts

@@ -0,0 +1,10 @@
+import type { Meta, StoryObj } from '@storybook/web-components-vite';
+interface BsSkipLinkArgs {
+    href: string;
+    label: string;
+}
+declare const meta: Meta<BsSkipLinkArgs>;
+export default meta;
+type Story = StoryObj<BsSkipLinkArgs>;
+export declare const Default: Story;
+export declare const CustomLabelAndTarget: Story;

package/dist/types/components/bs-stat/bs-stat.cmp.test.d.ts

@@ -0,0 +1 @@
+export {};