ng-blatui 1.28.1 → 1.30.0

package/fesm2022/ng-blatui.mjs

@@ -1,7 +1,7 @@
 import { clsx } from 'clsx';
 import { twMerge } from 'tailwind-merge';
 import * as i0 from '@angular/core';
-import { input, computed, Directive, Component, signal, model, forwardRef, inject, PLATFORM_ID, effect, Injectable, ElementRef, ViewContainerRef, viewChild, afterNextRender, output, linkedSignal, ViewEncapsulation, DestroyRef } from '@angular/core';
+import { InjectionToken, makeEnvironmentProviders, inject, computed, input, Directive, Component, signal, model, forwardRef, PLATFORM_ID, effect, Injectable, ElementRef, ViewContainerRef, viewChild, afterNextRender, output, linkedSignal, ViewEncapsulation, DestroyRef } from '@angular/core';
 import { cva } from 'class-variance-authority';
 import { NG_VALUE_ACCESSOR } from '@angular/forms';
 export { AccordionContent, AccordionGroup, AccordionPanel, AccordionTrigger, ɵɵDeferredContent, ɵɵDeferredContentAware } from '@angular/aria/accordion';
@@ -25,6 +25,104 @@ function cn(...inputs) {
     return twMerge(clsx(inputs));
 }
 
+/** Built-in English defaults — used whenever no input or provider overrides a key. */
+const BUI_DEFAULT_LABELS = {
+    backToTop: 'Back to top',
+    bannerDismiss: 'Dismiss',
+    bannerAnnouncement: 'Announcement',
+    cookieConsent: 'Cookie consent',
+    pagination: 'pagination',
+    paginationMore: 'More pages',
+    resizableHandle: 'Resize panel',
+    spinnerLoading: 'Loading',
+    topProgressLoading: 'Page loading',
+    audioPlayerSeek: 'Seek',
+    audioPlayerPlay: 'Play',
+    audioPlayerPause: 'Pause',
+    audioPlayerMute: 'Mute',
+    audioPlayerUnmute: 'Unmute',
+    breadcrumb: 'breadcrumb',
+    breadcrumbMore: 'More',
+    calendarPreviousMonth: 'Previous month',
+    calendarMonth: 'Month',
+    calendarYear: 'Year',
+    calendarNextMonth: 'Next month',
+    carouselPrevious: 'Previous slide',
+    carouselNext: 'Next slide',
+    carouselGoToSlide: 'Go to slide',
+    codeBlockCopy: 'Copy code',
+    codeBlockCopyShort: 'Copy',
+    codeBlockCopied: 'Copied',
+    colorPickerPick: 'Pick a color',
+    colorPickerHex: 'Color hex value',
+    comparisonSliderPosition: 'Comparison position',
+    comparisonTableIncluded: 'Included',
+    comparisonTableNotIncluded: 'Not included',
+    dataTableSearch: 'Search',
+    dataTableSelectAll: 'Select all rows',
+    dataTableSelectRow: 'Select row',
+    dock: 'Dock',
+    fileUploadDropzone: 'Click to upload or drag & drop',
+    fileUploadRemove: 'Remove file',
+    miniCartTrigger: 'Cart',
+    miniCart: 'Shopping cart',
+    notificationCenter: 'Notifications',
+    notificationCenterUnread: 'Unread',
+    notificationCenterMarkAllRead: 'Mark all read',
+    notificationCenterEmpty: 'No notifications',
+    numberInputDecrease: 'Decrease',
+    numberInputIncrease: 'Increase',
+    phoneInputCountry: 'Country code',
+    phoneInputNumber: 'Phone number',
+    productCardWishlist: 'Add to wishlist',
+    promptInputAttach: 'Attach file',
+    promptInputSend: 'Send',
+    quantitySelectorDecrease: 'Decrease quantity',
+    quantitySelectorIncrease: 'Increase quantity',
+    repeaterRemove: 'Remove row',
+    richTextEditorFormatting: 'Formatting',
+    scrollspy: 'On this page',
+    sonner: 'Notifications',
+    sonnerDismiss: 'Dismiss notification',
+    themeCustomizer: 'Theme customizer',
+    treeTableToggle: 'Toggle row',
+    videoPlay: 'Play video',
+};
+/**
+ * App-wide overrides for {@link BuiLabels}. Set it with {@link provideBuiLabels}.
+ * Components read it through {@link buiLabel}; anything left unset falls back to
+ * {@link BUI_DEFAULT_LABELS}.
+ */
+const BUI_LABELS = new InjectionToken('BUI_LABELS');
+/**
+ * Provide global overrides (typically translations) for ng-blatui's built-in
+ * labels. Add to your app config:
+ *
+ * ```ts
+ * providers: [provideBuiLabels({ bannerDismiss: 'Fermer', fileUploadRemove: 'Supprimer le fichier' })]
+ * ```
+ *
+ * Pass only the keys you want to change; the rest keep their English defaults.
+ */
+function provideBuiLabels(labels) {
+    return makeEnvironmentProviders([{ provide: BUI_LABELS, useValue: labels }]);
+}
+/**
+ * Resolve a label, most-specific wins:
+ * per-instance input → global {@link provideBuiLabels} override → built-in English.
+ *
+ * Call from an injection context (a component field initializer):
+ *
+ * ```ts
+ * readonly dismissLabel = input<string>();
+ * protected readonly dismissText = buiLabel('bannerDismiss', this.dismissLabel);
+ * ```
+ */
+function buiLabel(key, override) {
+    const overrides = inject(BUI_LABELS, { optional: true });
+    return computed(() => override() ?? overrides?.[key] ?? BUI_DEFAULT_LABELS[key]);
+}
+
 const buttonVariants = cva("inline-flex shrink-0 items-center justify-center gap-2 rounded-md text-sm font-medium whitespace-nowrap transition-all outline-none focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/50 disabled:pointer-events-none disabled:opacity-50 aria-invalid:border-destructive aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4", {
     variants: {
         variant: {
@@ -53,8 +151,10 @@ const buttonVariants = cva("inline-flex shrink-0 items-center justify-center gap
  * semantics, focus and keyboard behavior (accessibility for free).
  */
 class BuiButton {
+    /** Visual style of the button. */
     variant = input('default', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "variant" }] : /* istanbul ignore next */ []));
+    /** Size preset controlling height, padding and icon scale. */
     size = input('default', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "size" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -139,10 +239,13 @@ function intensityFor(variant) {
  * element so it stays in the document flow and screen-reader friendly.
  */
 class BuiBadge {
+    /** Brand variant, or the intensity (`soft`/`solid`/`outline`) when a `tone` is set. */
     variant = input('default', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "variant" }] : /* istanbul ignore next */ []));
+    /** Optional semantic tone; when set it overrides the brand variant's color. */
     tone = input(null, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "tone" }] : /* istanbul ignore next */ []));
+    /** Badge size preset. */
     size = input('default', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "size" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -193,8 +296,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
  * `[decorative]="false"` for a semantic `role="separator"` with `aria-orientation`.
  */
 class BuiSeparator {
+    /** Axis the separator runs along, also driving its sizing. */
     orientation = input('horizontal', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "orientation" }] : /* istanbul ignore next */ []));
+    /** Whether the separator is purely visual; `false` exposes a semantic `role="separator"`. */
     decorative = input(true, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "decorative" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -248,6 +353,7 @@ const CARD_VARIANTS = {
 };
 /** BlatUI card container. Use `variant="sectioned"` with the header/content/footer parts. */
 class BuiCard {
+    /** Card layout style: simple padded box or sectioned container. */
     variant = input('default', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "variant" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -365,8 +471,10 @@ const ALERT_TONES = {
  * (`default | destructive`) or semantic `tone` (`success | warning | danger | info | neutral`).
  */
 class BuiAlert {
+    /** Brand style; ignored when `tone` is set. */
     variant = input('default', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "variant" }] : /* istanbul ignore next */ []));
+    /** Semantic tone; when set, overrides `variant`. */
     tone = input(null, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "tone" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -423,6 +531,7 @@ const INPUT_SIZES = {
 };
 /** Applies BlatUI input styling to a native `<input>` (keeps native validation & a11y). */
 class BuiInput {
+    /** Size preset controlling input height, padding and text size. */
     size = input('default', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "size" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -451,6 +560,7 @@ const TEXTAREA_SIZES = {
 };
 /** Applies BlatUI textarea styling to a native `<textarea>` (auto-grows via field-sizing). */
 class BuiTextarea {
+    /** Size preset controlling minimum height, padding and text size. */
     size = input('default', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "size" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -476,8 +586,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
  * (valuemin/max/now/text). Set `[indeterminate]="true"` for an unknown-duration bar.
  */
 class BuiProgress {
+    /** Completion percentage from 0 to 100; values are clamped to that range. */
     value = input(0, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "value" }] : /* istanbul ignore next */ []));
+    /** Show an unknown-duration animation instead of a fixed value. */
     indeterminate = input(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "indeterminate" }] : /* istanbul ignore next */ []));
     /** Render a circular ring instead of a linear bar. */
@@ -489,6 +601,7 @@ class BuiProgress {
     /** Stroke width of the circular ring, in pixels. */
     thickness = input(4, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "thickness" }] : /* istanbul ignore next */ []));
+    /** Accessible label announced for the progress bar. */
     ariaLabel = input('Progress', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "ariaLabel" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -620,8 +733,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
  * the projected fallback (initials, icon). Falls back automatically on load error.
  */
 class BuiAvatar {
+    /** Image URL to display; when unset or on load error the fallback is shown. */
     src = input(null, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "src" }] : /* istanbul ignore next */ []));
+    /** Alternative text for the avatar image. */
     alt = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "alt" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -686,10 +801,13 @@ const CHECKBOX_BASE = 'peer border-input dark:bg-input/30 data-[state=checked]:b
  * with `[(checked)]` two-way binding and tri-state `[(indeterminate)]`.
  */
 class BuiCheckbox {
+    /** Whether the box is checked. Two-way bindable with `[(checked)]`. */
     checked = model(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "checked" }] : /* istanbul ignore next */ []));
+    /** Whether the box shows the mixed/indeterminate state. Two-way bindable with `[(indeterminate)]`. */
     indeterminate = model(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "indeterminate" }] : /* istanbul ignore next */ []));
+    /** Whether the checkbox is disabled. Two-way bindable with `[(disabled)]`. */
     disabled = model(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "disabled" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -846,10 +964,13 @@ const THUMB_BASE = 'bg-background dark:data-[state=unchecked]:bg-foreground dark
  * binding; keyboard activation (Space/Enter) and focus come from the native button.
  */
 class BuiSwitch {
+    /** Whether the switch is on. Two-way bindable with `[(checked)]`. */
     checked = model(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "checked" }] : /* istanbul ignore next */ []));
+    /** Whether the switch is disabled. Two-way bindable with `[(disabled)]`. */
     disabled = model(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "disabled" }] : /* istanbul ignore next */ []));
+    /** Track and thumb size. */
     size = input('default', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "size" }] : /* istanbul ignore next */ []));
     /** Optional SVG path `d` shown inside the thumb when checked. */
@@ -1463,6 +1584,9 @@ const FONTS = [
  * through {@link ThemeStore}, then exports a paste-ready stylesheet via "Copy CSS".
  */
 class BuiThemeCustomizer {
+    ariaLabel = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "ariaLabel" }] : /* istanbul ignore next */ []));
+    ariaLabelText = buiLabel('themeCustomizer', this.ariaLabel);
     theme = inject(ThemeStore);
     open = signal(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "open" }] : /* istanbul ignore next */ []));
@@ -1544,7 +1668,7 @@ class BuiThemeCustomizer {
         }
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.2", ngImport: i0, type: BuiThemeCustomizer, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.0.2", type: BuiThemeCustomizer, isStandalone: true, selector: "bui-theme-customizer", host: { attributes: { "data-slot": "theme-customizer" } }, ngImport: i0, template: `
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.0.2", type: BuiThemeCustomizer, isStandalone: true, selector: "bui-theme-customizer", inputs: { ariaLabel: { classPropertyName: "ariaLabel", publicName: "ariaLabel", isSignal: true, isRequired: false, transformFunction: null } }, host: { attributes: { "data-slot": "theme-customizer" } }, ngImport: i0, template: `
     <button
       buiButton
       variant="outline"
@@ -1559,7 +1683,7 @@ class BuiThemeCustomizer {
     @if (open()) {
       <div
         role="dialog"
-        aria-label="Theme customizer"
+        [attr.aria-label]="ariaLabelText()"
         class="fixed right-4 bottom-16 z-50 max-h-[80vh] w-[340px] space-y-5 overflow-y-auto rounded-lg border bg-popover p-4 text-popover-foreground shadow-lg"
       >
         <div class="flex items-center justify-between">
@@ -1783,7 +1907,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
     @if (open()) {
       <div
         role="dialog"
-        aria-label="Theme customizer"
+        [attr.aria-label]="ariaLabelText()"
         class="fixed right-4 bottom-16 z-50 max-h-[80vh] w-[340px] space-y-5 overflow-y-auto rounded-lg border bg-popover p-4 text-popover-foreground shadow-lg"
       >
         <div class="flex items-center justify-between">
@@ -1986,7 +2110,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
     }
   `,
                 }]
-        }] });
+        }], propDecorators: { ariaLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "ariaLabel", required: false }] }] } });
 
 // eslint-disable-next-line @typescript-eslint/no-empty-function
 const noop$g = () => { };
@@ -1995,8 +2119,10 @@ const noop$g = () => { };
  * `buiRadioItem` buttons; `[(value)]` two-way binds the selected value.
  */
 class BuiRadioGroup {
+    /** Selected radio value. Two-way bindable with `[(value)]`. */
     value = model(null, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "value" }] : /* istanbul ignore next */ []));
+    /** Whether the whole group is disabled. Two-way bindable with `[(disabled)]`. */
     disabled = model(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "disabled" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -2062,8 +2188,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
         }], propDecorators: { value: [{ type: i0.Input, args: [{ isSignal: true, alias: "value", required: false }] }, { type: i0.Output, args: ["valueChange"] }], disabled: [{ type: i0.Input, args: [{ isSignal: true, alias: "disabled", required: false }] }, { type: i0.Output, args: ["disabledChange"] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }] } });
 const ITEM = 'border-input text-primary dark:bg-input/30 focus-visible:border-ring focus-visible:ring-ring/50 aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive flex aspect-square size-4 shrink-0 items-center justify-center rounded-full border shadow-xs transition-[color,box-shadow] outline-none focus-visible:ring-[3px] disabled:cursor-not-allowed disabled:opacity-50';
 class BuiRadioGroupItem {
+    /** Value this item contributes to the group when selected. */
     value = input.required(/* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "value" }] : /* istanbul ignore next */ []));
+    /** Whether this individual radio item is disabled. */
     disabled = input(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "disabled" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -2122,6 +2250,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 const CONTENT_BASE = 'z-50 w-fit max-w-xs rounded-md px-3 py-1.5 text-xs shadow-md bg-primary text-primary-foreground';
 /** Floating tooltip bubble rendered into a CDK overlay. */
 class BuiTooltipContent {
+    /** Text rendered inside the tooltip bubble. */
     text = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "text" }] : /* istanbul ignore next */ []));
     /** Extra classes (e.g. a colour override) merged over the base bubble styles. */
@@ -2159,7 +2288,9 @@ const FALLBACK = {
  * a hover delay with `delay`, and the bubble colour with `tooltipClass`.
  */
 class BuiTooltip {
+    /** Tooltip text; bound via the `buiTooltip` attribute. */
     text = input.required({ ...(ngDevMode ? { debugName: "text" } : /* istanbul ignore next */ {}), alias: 'buiTooltip' });
+    /** Preferred placement side relative to the host, with an automatic flip fallback. */
     side = input('top', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "side" }] : /* istanbul ignore next */ []));
     /** Delay in milliseconds before the tooltip appears on hover/focus. */
@@ -2234,16 +2365,20 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** Breadcrumb navigation landmark (`<nav aria-label="breadcrumb">`). */
 class BuiBreadcrumb {
+    /** Accessible label for the breadcrumb navigation landmark. */
+    label = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "label" }] : /* istanbul ignore next */ []));
+    labelText = buiLabel('breadcrumb', this.label);
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.2", ngImport: i0, type: BuiBreadcrumb, deps: [], target: i0.ɵɵFactoryTarget.Directive });
-    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "22.0.2", type: BuiBreadcrumb, isStandalone: true, selector: "nav[buiBreadcrumb]", host: { attributes: { "aria-label": "breadcrumb", "data-slot": "breadcrumb" } }, ngImport: i0 });
+    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "17.1.0", version: "22.0.2", type: BuiBreadcrumb, isStandalone: true, selector: "nav[buiBreadcrumb]", inputs: { label: { classPropertyName: "label", publicName: "label", isSignal: true, isRequired: false, transformFunction: null } }, host: { attributes: { "data-slot": "breadcrumb" }, properties: { "attr.aria-label": "labelText()" } }, ngImport: i0 });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImport: i0, type: BuiBreadcrumb, decorators: [{
             type: Directive,
             args: [{
                     selector: 'nav[buiBreadcrumb]',
-                    host: { 'aria-label': 'breadcrumb', 'data-slot': 'breadcrumb' },
+                    host: { '[attr.aria-label]': 'labelText()', 'data-slot': 'breadcrumb' },
                 }]
-        }] });
+        }], propDecorators: { label: [{ type: i0.Input, args: [{ isSignal: true, alias: "label", required: false }] }] } });
 class BuiBreadcrumbList {
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
     computedClass = computed(() => cn('flex flex-wrap items-center gap-1.5 text-sm break-words text-muted-foreground sm:gap-2.5', this.userClass()), /* @ts-ignore */
@@ -2359,10 +2494,14 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 /** Collapsed breadcrumb indicator (ellipsis). */
 class BuiBreadcrumbEllipsis {
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
+    /** Screen-reader text for the collapsed ellipsis indicator. */
+    moreLabel = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "moreLabel" }] : /* istanbul ignore next */ []));
+    moreText = buiLabel('breadcrumbMore', this.moreLabel);
     computedClass = computed(() => cn('flex size-9 items-center justify-center', this.userClass()), /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "computedClass" }] : /* istanbul ignore next */ []));
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.2", ngImport: i0, type: BuiBreadcrumbEllipsis, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.1.0", version: "22.0.2", type: BuiBreadcrumbEllipsis, isStandalone: true, selector: "li[buiBreadcrumbEllipsis]", inputs: { userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null } }, host: { attributes: { "data-slot": "breadcrumb-ellipsis", "role": "presentation", "aria-hidden": "true" }, properties: { "class": "computedClass()" } }, ngImport: i0, template: `
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.1.0", version: "22.0.2", type: BuiBreadcrumbEllipsis, isStandalone: true, selector: "li[buiBreadcrumbEllipsis]", inputs: { userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null }, moreLabel: { classPropertyName: "moreLabel", publicName: "moreLabel", isSignal: true, isRequired: false, transformFunction: null } }, host: { attributes: { "data-slot": "breadcrumb-ellipsis", "role": "presentation", "aria-hidden": "true" }, properties: { "class": "computedClass()" } }, ngImport: i0, template: `
     <svg
       viewBox="0 0 24 24"
       fill="none"
@@ -2376,7 +2515,7 @@ class BuiBreadcrumbEllipsis {
       <circle cx="19" cy="12" r="1" />
       <circle cx="5" cy="12" r="1" />
     </svg>
-    <span class="sr-only">More</span>
+    <span class="sr-only">{{ moreText() }}</span>
   `, isInline: true });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImport: i0, type: BuiBreadcrumbEllipsis, decorators: [{
@@ -2403,10 +2542,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
       <circle cx="19" cy="12" r="1" />
       <circle cx="5" cy="12" r="1" />
     </svg>
-    <span class="sr-only">More</span>
+    <span class="sr-only">{{ moreText() }}</span>
   `,
                 }]
-        }], propDecorators: { userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }] } });
+        }], propDecorators: { userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }], moreLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "moreLabel", required: false }] }] } });
 
 /** Keyboard key styling, applied to a native `<kbd>` element. */
 class BuiKbd {
@@ -2426,6 +2565,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** Constrains projected content to a given aspect ratio (e.g. `16 / 9`). */
 class BuiAspectRatio {
+    /** Aspect ratio for the content, as a CSS `aspect-ratio` value (e.g. `16 / 9`). */
     ratio = input('1 / 1', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "ratio" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -2449,6 +2589,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** Groups buttons (and inputs) into a single segmented control. */
 class BuiButtonGroup {
+    /** Layout direction of the grouped controls. */
     orientation = input('horizontal', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "orientation" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -2515,6 +2656,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
                 }]
         }], propDecorators: { userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }] } });
 class BuiEmptyMedia {
+    /** Media style; `icon` renders a muted rounded badge sized for an icon. */
     variant = input('default', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "variant" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -2588,6 +2730,7 @@ const SIZES$5 = {
 };
 /** Centered, padded page container with a max-width scale. */
 class BuiContainer {
+    /** Maximum width preset for the container. */
     size = input('lg', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "size" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -2611,6 +2754,7 @@ const FIELD_ORIENT = {
 };
 /** A form field row grouping a label, control, description and error. */
 class BuiField {
+    /** How the label and control are arranged within the field. */
     orientation = input('vertical', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "orientation" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -2646,6 +2790,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
                 }]
         }], propDecorators: { userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }] } });
 class BuiFieldLegend {
+    /** Whether the legend is styled as a section legend or a smaller label. */
     variant = input('legend', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "variant" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -2680,6 +2825,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
                 }]
         }], propDecorators: { userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }] } });
 class BuiFieldLabel {
+    /** Id of the control this label is associated with (maps to the `for` attribute). */
     forId = input(undefined, { ...(ngDevMode ? { debugName: "forId" } : /* istanbul ignore next */ {}), alias: 'for' });
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
     computedClass = computed(() => cn('flex w-fit gap-2 text-sm leading-snug font-medium select-none group-data-[disabled=true]/field:opacity-50', this.userClass()), /* @ts-ignore */
@@ -2780,6 +2926,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** Accessible disclosure: a trigger toggles the visibility of its content. */
 class BuiCollapsible {
+    /** Whether the content is shown. Two-way bindable with `[(open)]`. */
     open = model(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "open" }] : /* istanbul ignore next */ []));
     contentId = inject(_IdGenerator).getId('bui-collapsible-');
@@ -2852,12 +2999,16 @@ const toggleVariants = cva("inline-flex items-center justify-center gap-2 rounde
 });
 /** A two-state toggle button (`aria-pressed`). */
 class BuiToggle {
+    /** Whether the toggle is pressed (on). Two-way bindable with `[(pressed)]`. */
     pressed = model(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "pressed" }] : /* istanbul ignore next */ []));
+    /** Whether the toggle is disabled. Two-way bindable with `[(disabled)]`. */
     disabled = model(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "disabled" }] : /* istanbul ignore next */ []));
+    /** Visual style: plain or outlined. */
     variant = input('default', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "variant" }] : /* istanbul ignore next */ []));
+    /** Button size. */
     size = input('default', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "size" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -2914,10 +3065,14 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 /** A spinning loading indicator (`role="status"`). */
 class BuiSpinner {
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
+    /** Overrides the localized accessible status label. */
+    label = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "label" }] : /* istanbul ignore next */ []));
+    labelText = buiLabel('spinnerLoading', this.label);
     computedClass = computed(() => cn('inline-block size-4 animate-spin', this.userClass()), /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "computedClass" }] : /* istanbul ignore next */ []));
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.2", ngImport: i0, type: BuiSpinner, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.1.0", version: "22.0.2", type: BuiSpinner, isStandalone: true, selector: "bui-spinner", inputs: { userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null } }, host: { attributes: { "data-slot": "spinner", "role": "status", "aria-label": "Loading" }, properties: { "class": "computedClass()" } }, ngImport: i0, template: `
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.1.0", version: "22.0.2", type: BuiSpinner, isStandalone: true, selector: "bui-spinner", inputs: { userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null }, label: { classPropertyName: "label", publicName: "label", isSignal: true, isRequired: false, transformFunction: null } }, host: { attributes: { "data-slot": "spinner", "role": "status" }, properties: { "attr.aria-label": "labelText()", "class": "computedClass()" } }, ngImport: i0, template: `
     <svg
       viewBox="0 0 24 24"
       fill="none"
@@ -2939,7 +3094,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
                     host: {
                         'data-slot': 'spinner',
                         role: 'status',
-                        'aria-label': 'Loading',
+                        '[attr.aria-label]': 'labelText()',
                         '[class]': 'computedClass()',
                     },
                     template: `
@@ -2957,12 +3112,14 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
     </svg>
   `,
                 }]
-        }], propDecorators: { userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }] } });
+        }], propDecorators: { userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }], label: [{ type: i0.Input, args: [{ isSignal: true, alias: "label", required: false }] }] } });
 
 /** Copy-to-clipboard button: copies `value`, flips to a check, announces "Copied". */
 class BuiCopyButton {
+    /** Text written to the clipboard when clicked. */
     value = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "value" }] : /* istanbul ignore next */ []));
+    /** Accessible label shown before copying. */
     label = input('Copy', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "label" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -3079,13 +3236,24 @@ const TONES$1 = {
  * the dismissal in localStorage. SSR-safe — localStorage is only touched in the browser.
  */
 class BuiBanner {
+    /** Color tone (`default | primary | info | success | warning | danger`). */
     tone = input('default', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "tone" }] : /* istanbul ignore next */ []));
+    /** Whether to show the dismiss button. */
     dismissible = input(true, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "dismissible" }] : /* istanbul ignore next */ []));
+    /** When set, the dismissal is remembered in localStorage under this key. */
     persistKey = input(undefined, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "persistKey" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
+    /** Overrides the localized accessible label for the announcement region. */
+    announcementLabel = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "announcementLabel" }] : /* istanbul ignore next */ []));
+    /** Overrides the localized accessible label for the dismiss button. */
+    dismissLabel = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "dismissLabel" }] : /* istanbul ignore next */ []));
+    announcementText = buiLabel('bannerAnnouncement', this.announcementLabel);
+    dismissText = buiLabel('bannerDismiss', this.dismissLabel);
     show = signal(true, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "show" }] : /* istanbul ignore next */ []));
     isBrowser = isPlatformBrowser(inject(PLATFORM_ID));
@@ -3105,14 +3273,14 @@ class BuiBanner {
         }
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.2", ngImport: i0, type: BuiBanner, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.0.2", type: BuiBanner, isStandalone: true, selector: "bui-banner", inputs: { tone: { classPropertyName: "tone", publicName: "tone", isSignal: true, isRequired: false, transformFunction: null }, dismissible: { classPropertyName: "dismissible", publicName: "dismissible", isSignal: true, isRequired: false, transformFunction: null }, persistKey: { classPropertyName: "persistKey", publicName: "persistKey", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null } }, host: { attributes: { "data-slot": "banner", "role": "region", "aria-label": "Announcement" }, properties: { "hidden": "!show()", "class": "computedClass()" } }, ngImport: i0, template: `
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.0.2", type: BuiBanner, isStandalone: true, selector: "bui-banner", inputs: { tone: { classPropertyName: "tone", publicName: "tone", isSignal: true, isRequired: false, transformFunction: null }, dismissible: { classPropertyName: "dismissible", publicName: "dismissible", isSignal: true, isRequired: false, transformFunction: null }, persistKey: { classPropertyName: "persistKey", publicName: "persistKey", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null }, announcementLabel: { classPropertyName: "announcementLabel", publicName: "announcementLabel", isSignal: true, isRequired: false, transformFunction: null }, dismissLabel: { classPropertyName: "dismissLabel", publicName: "dismissLabel", isSignal: true, isRequired: false, transformFunction: null } }, host: { attributes: { "data-slot": "banner", "role": "region" }, properties: { "attr.aria-label": "announcementText()", "hidden": "!show()", "class": "computedClass()" } }, ngImport: i0, template: `
     <div class="flex flex-1 flex-wrap items-center justify-center gap-x-3 gap-y-1">
       <ng-content />
     </div>
     @if (dismissible()) {
       <button
         type="button"
-        aria-label="Dismiss"
+        [attr.aria-label]="dismissText()"
         class="shrink-0 rounded-md p-1 opacity-70 transition-opacity outline-none hover:opacity-100 focus-visible:ring-2 focus-visible:ring-current/40"
         (click)="dismiss()"
       >
@@ -3140,7 +3308,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
                     host: {
                         'data-slot': 'banner',
                         role: 'region',
-                        'aria-label': 'Announcement',
+                        '[attr.aria-label]': 'announcementText()',
                         '[hidden]': '!show()',
                         '[class]': 'computedClass()',
                     },
@@ -3151,7 +3319,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
     @if (dismissible()) {
       <button
         type="button"
-        aria-label="Dismiss"
+        [attr.aria-label]="dismissText()"
         class="shrink-0 rounded-md p-1 opacity-70 transition-opacity outline-none hover:opacity-100 focus-visible:ring-2 focus-visible:ring-current/40"
         (click)="dismiss()"
       >
@@ -3172,10 +3340,11 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
     }
   `,
                 }]
-        }], propDecorators: { tone: [{ type: i0.Input, args: [{ isSignal: true, alias: "tone", required: false }] }], dismissible: [{ type: i0.Input, args: [{ isSignal: true, alias: "dismissible", required: false }] }], persistKey: [{ type: i0.Input, args: [{ isSignal: true, alias: "persistKey", required: false }] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }] } });
+        }], propDecorators: { tone: [{ type: i0.Input, args: [{ isSignal: true, alias: "tone", required: false }] }], dismissible: [{ type: i0.Input, args: [{ isSignal: true, alias: "dismissible", required: false }] }], persistKey: [{ type: i0.Input, args: [{ isSignal: true, alias: "persistKey", required: false }] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }], announcementLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "announcementLabel", required: false }] }], dismissLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "dismissLabel", required: false }] }] } });
 
 /** Scroll/border wrapper around a table. `variant="card"` adds a bordered card. */
 class BuiTableContainer {
+    /** Wrapper style; `card` adds a bordered, shadowed card around the table. */
     variant = input('default', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "variant" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -3325,10 +3494,13 @@ function initials(name) {
 }
 /** Overlapping stack of avatars with an optional "+N" overflow counter. */
 class BuiAvatarGroup {
+    /** Avatars to display, in order. */
     avatars = input([], /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "avatars" }] : /* istanbul ignore next */ []));
+    /** Maximum avatars shown before the rest collapse into a "+N" counter. */
     max = input(4, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "max" }] : /* istanbul ignore next */ []));
+    /** Avatar size preset, which also controls overlap and ring width. */
     size = input('default', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "size" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -3400,11 +3572,15 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** Pagination navigation landmark. */
 class BuiPagination {
+    /** Accessible label for the navigation landmark; falls back to a localized default. */
+    ariaLabel = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "ariaLabel" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
+    ariaLabelText = buiLabel('pagination', this.ariaLabel);
     computedClass = computed(() => cn('mx-auto flex w-full justify-center', this.userClass()), /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "computedClass" }] : /* istanbul ignore next */ []));
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.2", ngImport: i0, type: BuiPagination, deps: [], target: i0.ɵɵFactoryTarget.Directive });
-    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "17.1.0", version: "22.0.2", type: BuiPagination, isStandalone: true, selector: "nav[buiPagination]", inputs: { userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null } }, host: { attributes: { "role": "navigation", "aria-label": "pagination", "data-slot": "pagination" }, properties: { "class": "computedClass()" } }, ngImport: i0 });
+    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "17.1.0", version: "22.0.2", type: BuiPagination, isStandalone: true, selector: "nav[buiPagination]", inputs: { ariaLabel: { classPropertyName: "ariaLabel", publicName: "ariaLabel", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null } }, host: { attributes: { "role": "navigation", "data-slot": "pagination" }, properties: { "attr.aria-label": "ariaLabelText()", "class": "computedClass()" } }, ngImport: i0 });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImport: i0, type: BuiPagination, decorators: [{
             type: Directive,
@@ -3412,12 +3588,12 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
                     selector: 'nav[buiPagination]',
                     host: {
                         role: 'navigation',
-                        'aria-label': 'pagination',
+                        '[attr.aria-label]': 'ariaLabelText()',
                         'data-slot': 'pagination',
                         '[class]': 'computedClass()',
                     },
                 }]
-        }], propDecorators: { userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }] } });
+        }], propDecorators: { ariaLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "ariaLabel", required: false }] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }] } });
 class BuiPaginationContent {
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
     computedClass = computed(() => cn('flex flex-row items-center gap-1', this.userClass()), /* @ts-ignore */
@@ -3452,8 +3628,10 @@ const LINK_SIZES = {
 };
 /** A pagination link; set `active` for the current page. */
 class BuiPaginationLink {
+    /** Whether this link represents the current page; sets `aria-current="page"`. */
     active = input(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "active" }] : /* istanbul ignore next */ []));
+    /** Size variant controlling link dimensions and padding. */
     size = input('icon', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "size" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -3479,10 +3657,14 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 /** Ellipsis indicator for skipped pages. */
 class BuiPaginationEllipsis {
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
+    /** Visually-hidden label announcing skipped pages; falls back to a localized default. */
+    moreLabel = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "moreLabel" }] : /* istanbul ignore next */ []));
+    moreText = buiLabel('paginationMore', this.moreLabel);
     computedClass = computed(() => cn('flex size-9 items-center justify-center', this.userClass()), /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "computedClass" }] : /* istanbul ignore next */ []));
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.2", ngImport: i0, type: BuiPaginationEllipsis, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.1.0", version: "22.0.2", type: BuiPaginationEllipsis, isStandalone: true, selector: "bui-pagination-ellipsis", inputs: { userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null } }, host: { attributes: { "data-slot": "pagination-ellipsis", "aria-hidden": "true" }, properties: { "class": "computedClass()" } }, ngImport: i0, template: `
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.1.0", version: "22.0.2", type: BuiPaginationEllipsis, isStandalone: true, selector: "bui-pagination-ellipsis", inputs: { userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null }, moreLabel: { classPropertyName: "moreLabel", publicName: "moreLabel", isSignal: true, isRequired: false, transformFunction: null } }, host: { attributes: { "data-slot": "pagination-ellipsis", "aria-hidden": "true" }, properties: { "class": "computedClass()" } }, ngImport: i0, template: `
     <svg
       viewBox="0 0 24 24"
       fill="none"
@@ -3496,7 +3678,7 @@ class BuiPaginationEllipsis {
       <circle cx="19" cy="12" r="1" />
       <circle cx="5" cy="12" r="1" />
     </svg>
-    <span class="sr-only">More pages</span>
+    <span class="sr-only">{{ moreText() }}</span>
   `, isInline: true });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImport: i0, type: BuiPaginationEllipsis, decorators: [{
@@ -3518,10 +3700,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
       <circle cx="19" cy="12" r="1" />
       <circle cx="5" cy="12" r="1" />
     </svg>
-    <span class="sr-only">More pages</span>
+    <span class="sr-only">{{ moreText() }}</span>
   `,
                 }]
-        }], propDecorators: { userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }] } });
+        }], propDecorators: { userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }], moreLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "moreLabel", required: false }] }] } });
 
 const POPOVER_POSITIONS = {
     bottom: { originX: 'center', originY: 'bottom', overlayX: 'center', overlayY: 'top', offsetY: 4 },
@@ -3541,7 +3723,9 @@ const POPOVER_FALLBACK = {
  * Closes on outside click and Escape. SSR-safe (the overlay is browser-only, on click).
  */
 class BuiPopover {
+    /** Template rendered as the popover content; bound via `[buiPopover]`. */
     content = input.required({ ...(ngDevMode ? { debugName: "content" } : /* istanbul ignore next */ {}), alias: 'buiPopover' });
+    /** Side of the trigger the popover opens on, with an automatic opposite-side fallback. */
     side = input('bottom', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "side" }] : /* istanbul ignore next */ []));
     overlay = inject(Overlay);
@@ -3637,8 +3821,10 @@ const ITEM_SIZES = {
 };
 /** A list/row item; use on a `<div>` or an `<a>`. */
 class BuiItem {
+    /** Visual style of the item: transparent, outlined, or muted background. */
     variant = input('default', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "variant" }] : /* istanbul ignore next */ []));
+    /** Item density: standard padding or a more compact `sm` size. */
     size = input('default', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "size" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -3665,6 +3851,7 @@ const MEDIA_VARIANTS = {
     image: 'size-10 overflow-hidden rounded-sm [&_img]:size-full [&_img]:object-cover',
 };
 class BuiItemMedia {
+    /** Media presentation: plain, an icon tile, or a cropped image thumbnail. */
     variant = input('default', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "variant" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -3812,6 +3999,7 @@ const ADDON_ALIGN = {
     'block-end': 'order-last w-full justify-start px-3 pb-3',
 };
 class BuiInputGroupAddon {
+    /** Where the addon sits relative to the input (inline or block, start or end). */
     align = input('inline-start', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "align" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -3872,8 +4060,10 @@ const IG_BUTTON_SIZES = {
     'icon-sm': 'size-8 p-0',
 };
 class BuiInputGroupButton {
+    /** Visual style of the addon button. */
     variant = input('ghost', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "variant" }] : /* istanbul ignore next */ []));
+    /** Size preset for the addon button (text or icon variants). */
     size = input('xs', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "size" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -3892,6 +4082,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** Visually hides content while keeping it available to assistive tech (sr-only). */
 class BuiVisuallyHidden {
+    /** Whether the content becomes visible when focused (e.g. skip links). */
     focusable = input(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "focusable" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -3917,21 +4108,28 @@ const TONES = {
 };
 /** A labelled meter (`role="meter"`) for a measurement within a known range. */
 class BuiMeter {
+    /** Current measurement; clamped between `min` and `max`. */
     value = input(0, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "value" }] : /* istanbul ignore next */ []));
+    /** Minimum value of the meter range. */
     min = input(0, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "min" }] : /* istanbul ignore next */ []));
+    /** Maximum value of the meter range. */
     max = input(100, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "max" }] : /* istanbul ignore next */ []));
+    /** Optional text label shown above the meter bar. */
     label = input(null, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "label" }] : /* istanbul ignore next */ []));
+    /** Fill colour tone; overridden by any matching threshold. */
     tone = input('default', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "tone" }] : /* istanbul ignore next */ []));
     /** Auto-pick the fill tone by value: the highest threshold whose `at` ≤ value wins. */
     thresholds = input([], /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "thresholds" }] : /* istanbul ignore next */ []));
+    /** Whether to display the formatted value text next to the label. */
     showValue = input(true, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "showValue" }] : /* istanbul ignore next */ []));
+    /** Unit suffix appended to the displayed value (e.g. "%"). */
     unit = input('%', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "unit" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -4035,14 +4233,19 @@ const TREND_CLASS = {
 };
 /** A KPI / statistic card: label, big value, and a trend-coloured change. */
 class BuiStat {
+    /** Small caption shown above the value. */
     label = input(null, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "label" }] : /* istanbul ignore next */ []));
+    /** Primary statistic displayed as the large value. */
     value = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "value" }] : /* istanbul ignore next */ []));
+    /** Change indicator (e.g. "+12%"); coloured by trend. */
     change = input(null, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "change" }] : /* istanbul ignore next */ []));
+    /** Explicit trend direction; inferred from `change`'s sign when null. */
     trend = input(null, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "trend" }] : /* istanbul ignore next */ []));
+    /** Muted text shown next to the change value. */
     caption = input(null, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "caption" }] : /* istanbul ignore next */ []));
     /** Optional inline sparkline drawn from a series of numbers. */
@@ -4161,9 +4364,12 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
  * and stays open while the pointer is over the card. SSR-safe (browser-only, on hover).
  */
 class BuiHoverCard {
+    /** Template rendered inside the card; bound via the `buiHoverCard` attribute. */
     content = input.required({ ...(ngDevMode ? { debugName: "content" } : /* istanbul ignore next */ {}), alias: 'buiHoverCard' });
+    /** Delay in milliseconds before the card opens on hover/focus. */
     openDelay = input(400, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "openDelay" }] : /* istanbul ignore next */ []));
+    /** Delay in milliseconds before the card closes after the pointer leaves. */
     closeDelay = input(100, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "closeDelay" }] : /* istanbul ignore next */ []));
     overlay = inject(Overlay);
@@ -4255,11 +4461,25 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** A dark code panel with an optional filename header and a copy button. */
 class BuiCodeBlock {
+    /** Source code shown in the panel and copied to the clipboard. */
     code = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "code" }] : /* istanbul ignore next */ []));
+    /** Optional filename shown in the header; omit for the floating copy button. */
     filename = input(null, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "filename" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
+    /** Accessible label for the copy button. */
+    copyLabel = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "copyLabel" }] : /* istanbul ignore next */ []));
+    /** Short visible text for the copy button. */
+    copyShortLabel = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "copyShortLabel" }] : /* istanbul ignore next */ []));
+    /** Text shown briefly after the code is copied. */
+    copiedLabel = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "copiedLabel" }] : /* istanbul ignore next */ []));
+    copyText = buiLabel('codeBlockCopy', this.copyLabel);
+    copyShortText = buiLabel('codeBlockCopyShort', this.copyShortLabel);
+    copiedText = buiLabel('codeBlockCopied', this.copiedLabel);
     copied = signal(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "copied" }] : /* istanbul ignore next */ []));
     computedClass = computed(() => cn('group/code-block relative block overflow-hidden rounded-lg border border-zinc-800 bg-zinc-950 text-zinc-100', this.userClass()), /* @ts-ignore */
@@ -4277,27 +4497,27 @@ class BuiCodeBlock {
         }
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.2", ngImport: i0, type: BuiCodeBlock, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.0.2", type: BuiCodeBlock, isStandalone: true, selector: "bui-code-block", inputs: { code: { classPropertyName: "code", publicName: "code", isSignal: true, isRequired: false, transformFunction: null }, filename: { classPropertyName: "filename", publicName: "filename", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null } }, host: { attributes: { "data-slot": "code-block" }, properties: { "class": "computedClass()" } }, ngImport: i0, template: `
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.0.2", type: BuiCodeBlock, isStandalone: true, selector: "bui-code-block", inputs: { code: { classPropertyName: "code", publicName: "code", isSignal: true, isRequired: false, transformFunction: null }, filename: { classPropertyName: "filename", publicName: "filename", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null }, copyLabel: { classPropertyName: "copyLabel", publicName: "copyLabel", isSignal: true, isRequired: false, transformFunction: null }, copyShortLabel: { classPropertyName: "copyShortLabel", publicName: "copyShortLabel", isSignal: true, isRequired: false, transformFunction: null }, copiedLabel: { classPropertyName: "copiedLabel", publicName: "copiedLabel", isSignal: true, isRequired: false, transformFunction: null } }, host: { attributes: { "data-slot": "code-block" }, properties: { "class": "computedClass()" } }, ngImport: i0, template: `
     @if (filename()) {
       <div class="flex items-center justify-between border-b border-white/10 px-4 py-2">
         <span class="font-mono text-xs text-zinc-400">{{ filename() }}</span>
         <button
           type="button"
-          aria-label="Copy code"
+          [attr.aria-label]="copyText()"
           class="text-xs text-zinc-400 transition-colors hover:text-zinc-100"
           (click)="copy()"
         >
-          {{ copied() ? 'Copied' : 'Copy' }}
+          {{ copied() ? copiedText() : copyShortText() }}
         </button>
       </div>
     } @else {
       <button
         type="button"
-        aria-label="Copy code"
+        [attr.aria-label]="copyText()"
         class="absolute end-2 top-2 z-10 rounded-md px-1.5 py-1 text-xs text-zinc-400 opacity-0 transition-all group-hover/code-block:opacity-100 hover:bg-white/10 hover:text-zinc-100 focus-visible:opacity-100"
         (click)="copy()"
       >
-        {{ copied() ? 'Copied' : 'Copy' }}
+        {{ copied() ? copiedText() : copyShortText() }}
       </button>
     }
     <pre
@@ -4316,21 +4536,21 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
         <span class="font-mono text-xs text-zinc-400">{{ filename() }}</span>
         <button
           type="button"
-          aria-label="Copy code"
+          [attr.aria-label]="copyText()"
           class="text-xs text-zinc-400 transition-colors hover:text-zinc-100"
           (click)="copy()"
         >
-          {{ copied() ? 'Copied' : 'Copy' }}
+          {{ copied() ? copiedText() : copyShortText() }}
         </button>
       </div>
     } @else {
       <button
         type="button"
-        aria-label="Copy code"
+        [attr.aria-label]="copyText()"
         class="absolute end-2 top-2 z-10 rounded-md px-1.5 py-1 text-xs text-zinc-400 opacity-0 transition-all group-hover/code-block:opacity-100 hover:bg-white/10 hover:text-zinc-100 focus-visible:opacity-100"
         (click)="copy()"
       >
-        {{ copied() ? 'Copied' : 'Copy' }}
+        {{ copied() ? copiedText() : copyShortText() }}
       </button>
     }
     <pre
@@ -4338,7 +4558,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
     ><code class="font-mono">{{ code() }}</code></pre>
   `,
                 }]
-        }], propDecorators: { code: [{ type: i0.Input, args: [{ isSignal: true, alias: "code", required: false }] }], filename: [{ type: i0.Input, args: [{ isSignal: true, alias: "filename", required: false }] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }] } });
+        }], propDecorators: { code: [{ type: i0.Input, args: [{ isSignal: true, alias: "code", required: false }] }], filename: [{ type: i0.Input, args: [{ isSignal: true, alias: "filename", required: false }] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }], copyLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "copyLabel", required: false }] }], copyShortLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "copyShortLabel", required: false }] }], copiedLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "copiedLabel", required: false }] }] } });
 
 // eslint-disable-next-line @typescript-eslint/no-empty-function
 const noop$e = () => { };
@@ -4349,23 +4569,31 @@ const noop$e = () => { };
  * only read inside browser event handlers.
  */
 class BuiSlider {
+    /** Current value (lower thumb in range mode). Two-way bindable with `[(value)]`. */
     value = model(0, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "value" }] : /* istanbul ignore next */ []));
     /** Enable a second thumb; binds `endValue` as the upper handle. */
     range = input(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "range" }] : /* istanbul ignore next */ []));
+    /** Upper thumb value in range mode. Two-way bindable with `[(endValue)]`. */
     endValue = model(100, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "endValue" }] : /* istanbul ignore next */ []));
+    /** Minimum selectable value. */
     min = input(0, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "min" }] : /* istanbul ignore next */ []));
+    /** Maximum selectable value. */
     max = input(100, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "max" }] : /* istanbul ignore next */ []));
+    /** Increment between selectable values. */
     step = input(1, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "step" }] : /* istanbul ignore next */ []));
+    /** Whether the slider is disabled. Two-way bindable with `[(disabled)]`. */
     disabled = model(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "disabled" }] : /* istanbul ignore next */ []));
+    /** Layout direction of the slider. */
     orientation = input('horizontal', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "orientation" }] : /* istanbul ignore next */ []));
+    /** Accessible label for the thumb(s). */
     ariaLabel = input('Value', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "ariaLabel" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -4623,18 +4851,25 @@ const noop$d = () => { };
 const STAR_SIZE = { sm: 'size-4', default: 'size-5', lg: 'size-6' };
 /** A star rating (`role="radiogroup"`) with hover preview and keyboard support. */
 class BuiRating {
+    /** Current rating. Two-way bindable with `[(value)]`. */
     value = model(0, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "value" }] : /* istanbul ignore next */ []));
+    /** Number of stars shown. */
     max = input(5, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "max" }] : /* istanbul ignore next */ []));
+    /** Whether the rating is display-only and cannot be changed. */
     readonly = input(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "readonly" }] : /* istanbul ignore next */ []));
+    /** Whether the rating is disabled. Two-way bindable with `[(disabled)]`. */
     disabled = model(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "disabled" }] : /* istanbul ignore next */ []));
+    /** Size of each star. */
     size = input('default', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "size" }] : /* istanbul ignore next */ []));
+    /** Tailwind text-color class applied to filled stars. */
     color = input('text-amber-500', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "color" }] : /* istanbul ignore next */ []));
+    /** Accessible label for the rating group. */
     ariaLabel = input(null, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "ariaLabel" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -4791,21 +5026,36 @@ const BTN_SIZE$1 = {
 const FIELD_WIDTH = { sm: 'w-9', default: 'w-10', lg: 'w-12' };
 /** A compact − [n] + quantity stepper (`role="group"` with a `spinbutton` field). */
 class BuiQuantitySelector {
+    /** Current quantity. Two-way bindable with `[(value)]`. */
     value = model(1, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "value" }] : /* istanbul ignore next */ []));
+    /** Minimum allowed quantity. */
     min = input(1, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "min" }] : /* istanbul ignore next */ []));
+    /** Maximum allowed quantity; unbounded when null. */
     max = input(null, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "max" }] : /* istanbul ignore next */ []));
+    /** Increment/decrement applied per button press. */
     step = input(1, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "step" }] : /* istanbul ignore next */ []));
+    /** Size preset controlling height and button width. */
     size = input('default', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "size" }] : /* istanbul ignore next */ []));
+    /** Whether the whole control is disabled. */
     disabled = input(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "disabled" }] : /* istanbul ignore next */ []));
+    /** Accessible label for the numeric input field. */
     ariaLabel = input('Quantity', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "ariaLabel" }] : /* istanbul ignore next */ []));
+    /** Accessible label override for the decrease button. */
+    decreaseLabel = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "decreaseLabel" }] : /* istanbul ignore next */ []));
+    /** Accessible label override for the increase button. */
+    increaseLabel = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "increaseLabel" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
+    decreaseText = buiLabel('quantitySelectorDecrease', this.decreaseLabel);
+    increaseText = buiLabel('quantitySelectorIncrease', this.increaseLabel);
     atMin = computed(() => this.value() <= this.min(), /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "atMin" }] : /* istanbul ignore next */ []));
     atMax = computed(() => {
@@ -4848,10 +5098,10 @@ class BuiQuantitySelector {
         return result;
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.2", ngImport: i0, type: BuiQuantitySelector, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.1.0", version: "22.0.2", type: BuiQuantitySelector, isStandalone: true, selector: "bui-quantity-selector", inputs: { value: { classPropertyName: "value", publicName: "value", isSignal: true, isRequired: false, transformFunction: null }, min: { classPropertyName: "min", publicName: "min", isSignal: true, isRequired: false, transformFunction: null }, max: { classPropertyName: "max", publicName: "max", isSignal: true, isRequired: false, transformFunction: null }, step: { classPropertyName: "step", publicName: "step", isSignal: true, isRequired: false, transformFunction: null }, size: { classPropertyName: "size", publicName: "size", isSignal: true, isRequired: false, transformFunction: null }, disabled: { classPropertyName: "disabled", publicName: "disabled", isSignal: true, isRequired: false, transformFunction: null }, ariaLabel: { classPropertyName: "ariaLabel", publicName: "ariaLabel", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { value: "valueChange" }, host: { attributes: { "data-slot": "quantity-selector", "role": "group" }, properties: { "class": "computedClass()" } }, ngImport: i0, template: `
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.1.0", version: "22.0.2", type: BuiQuantitySelector, isStandalone: true, selector: "bui-quantity-selector", inputs: { value: { classPropertyName: "value", publicName: "value", isSignal: true, isRequired: false, transformFunction: null }, min: { classPropertyName: "min", publicName: "min", isSignal: true, isRequired: false, transformFunction: null }, max: { classPropertyName: "max", publicName: "max", isSignal: true, isRequired: false, transformFunction: null }, step: { classPropertyName: "step", publicName: "step", isSignal: true, isRequired: false, transformFunction: null }, size: { classPropertyName: "size", publicName: "size", isSignal: true, isRequired: false, transformFunction: null }, disabled: { classPropertyName: "disabled", publicName: "disabled", isSignal: true, isRequired: false, transformFunction: null }, ariaLabel: { classPropertyName: "ariaLabel", publicName: "ariaLabel", isSignal: true, isRequired: false, transformFunction: null }, decreaseLabel: { classPropertyName: "decreaseLabel", publicName: "decreaseLabel", isSignal: true, isRequired: false, transformFunction: null }, increaseLabel: { classPropertyName: "increaseLabel", publicName: "increaseLabel", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { value: "valueChange" }, host: { attributes: { "data-slot": "quantity-selector", "role": "group" }, properties: { "class": "computedClass()" } }, ngImport: i0, template: `
     <button
       type="button"
-      aria-label="Decrease quantity"
+      [attr.aria-label]="decreaseText()"
       [disabled]="disabled() || atMin()"
       [class]="btnClass('e')"
       (click)="dec()"
@@ -4882,7 +5132,7 @@ class BuiQuantitySelector {
     />
     <button
       type="button"
-      aria-label="Increase quantity"
+      [attr.aria-label]="increaseText()"
       [disabled]="disabled() || atMax()"
       [class]="btnClass('s')"
       (click)="inc()"
@@ -4908,7 +5158,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
                     template: `
     <button
       type="button"
-      aria-label="Decrease quantity"
+      [attr.aria-label]="decreaseText()"
       [disabled]="disabled() || atMin()"
       [class]="btnClass('e')"
       (click)="dec()"
@@ -4939,7 +5189,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
     />
     <button
       type="button"
-      aria-label="Increase quantity"
+      [attr.aria-label]="increaseText()"
       [disabled]="disabled() || atMax()"
       [class]="btnClass('s')"
       (click)="inc()"
@@ -4957,7 +5207,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
     </button>
   `,
                 }]
-        }], propDecorators: { value: [{ type: i0.Input, args: [{ isSignal: true, alias: "value", required: false }] }, { type: i0.Output, args: ["valueChange"] }], min: [{ type: i0.Input, args: [{ isSignal: true, alias: "min", required: false }] }], max: [{ type: i0.Input, args: [{ isSignal: true, alias: "max", required: false }] }], step: [{ type: i0.Input, args: [{ isSignal: true, alias: "step", required: false }] }], size: [{ type: i0.Input, args: [{ isSignal: true, alias: "size", required: false }] }], disabled: [{ type: i0.Input, args: [{ isSignal: true, alias: "disabled", required: false }] }], ariaLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "ariaLabel", required: false }] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }] } });
+        }], propDecorators: { value: [{ type: i0.Input, args: [{ isSignal: true, alias: "value", required: false }] }, { type: i0.Output, args: ["valueChange"] }], min: [{ type: i0.Input, args: [{ isSignal: true, alias: "min", required: false }] }], max: [{ type: i0.Input, args: [{ isSignal: true, alias: "max", required: false }] }], step: [{ type: i0.Input, args: [{ isSignal: true, alias: "step", required: false }] }], size: [{ type: i0.Input, args: [{ isSignal: true, alias: "size", required: false }] }], disabled: [{ type: i0.Input, args: [{ isSignal: true, alias: "disabled", required: false }] }], ariaLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "ariaLabel", required: false }] }], decreaseLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "decreaseLabel", required: false }] }], increaseLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "increaseLabel", required: false }] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }] } });
 
 /**
  * Confirm dialog styling (`role="alertdialog"`). Open it with the CDK `Dialog` service
@@ -5075,8 +5325,10 @@ const SIZES$3 = {
  * browser (via `afterNextRender` and the `input` event).
  */
 class BuiAutosizeTextarea {
+    /** Size preset controlling minimum height, padding and text size. */
     size = input('default', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "size" }] : /* istanbul ignore next */ []));
+    /** Maximum number of rows before the textarea scrolls instead of growing (null = unlimited). */
     maxRows = input(null, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "maxRows" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -5250,6 +5502,7 @@ const TYPOGRAPHY = {
 };
 /** Applies a typographic style. Put it on the matching element (e.g. `<h1 buiTypography variant="h1">`). */
 class BuiTypography {
+    /** Typographic style to apply (e.g. `h1`, `lead`, `blockquote`, `gradient`). */
     variant = input('p', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "variant" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -5272,10 +5525,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** Decorative dotted background layer. Drop inside a `relative` container. */
 class BuiDotPattern {
+    /** Dot radius in pixels. */
     size = input(1, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "size" }] : /* istanbul ignore next */ []));
+    /** Spacing between dots in pixels. */
     gap = input(16, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "gap" }] : /* istanbul ignore next */ []));
+    /** Whether to fade the pattern with a radial mask toward the edges. */
     mask = input(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "mask" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -5308,10 +5564,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** Decorative grid background layer. Drop inside a `relative` container. */
 class BuiGridPattern {
+    /** Cell size (spacing between grid lines) in pixels. */
     gap = input(24, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "gap" }] : /* istanbul ignore next */ []));
+    /** Thickness of the grid lines in pixels. */
     lineWidth = input(1, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "lineWidth" }] : /* istanbul ignore next */ []));
+    /** Whether to fade the pattern with a radial mask toward the edges. */
     mask = input(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "mask" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -5349,10 +5608,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 const noop$c = () => { };
 /** A single-select segmented control (`role="radiogroup"`) with arrow-key navigation. */
 class BuiSegmentedControl {
+    /** Currently selected segment value. Two-way bindable with `[(value)]`. */
     value = model('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "value" }] : /* istanbul ignore next */ []));
+    /** Available segments; plain strings are used as both value and label. */
     options = input([], /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "options" }] : /* istanbul ignore next */ []));
+    /** Whether all segments are disabled. Two-way bindable with `[(disabled)]`. */
     disabled = model(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "disabled" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -5472,8 +5734,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
  * helper classes `.prompt .ok .dim .path .warn` colour them.
  */
 class BuiTerminal {
+    /** Optional title shown in the terminal title bar. */
     title = input(null, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "title" }] : /* istanbul ignore next */ []));
+    /** Whether to show the macOS-style traffic-light buttons in the title bar. */
     buttons = input(true, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "buttons" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -5543,15 +5807,27 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** A data-driven feature-comparison / pricing table. */
 class BuiComparisonTable {
+    /** Column headers, one per pricing/feature tier. */
     tiers = input([], /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "tiers" }] : /* istanbul ignore next */ []));
+    /** Feature rows; each holds one value per tier. */
     rows = input([], /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "rows" }] : /* istanbul ignore next */ []));
+    /** Tier to emphasize, by index or tier name; `null` highlights none. */
     highlight = input(null, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "highlight" }] : /* istanbul ignore next */ []));
+    /** Header text for the leading feature column. */
     featureLabel = input('Feature', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "featureLabel" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
+    /** Accessible label for the included (check) icon. */
+    includedLabel = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "includedLabel" }] : /* istanbul ignore next */ []));
+    /** Accessible label for the not-included (dash) marker. */
+    notIncludedLabel = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "notIncludedLabel" }] : /* istanbul ignore next */ []));
+    includedText = buiLabel('comparisonTableIncluded', this.includedLabel);
+    notIncludedText = buiLabel('comparisonTableNotIncluded', this.notIncludedLabel);
     highlightIndex = computed(() => {
         const highlight = this.highlight();
         if (typeof highlight === 'number') {
@@ -5563,7 +5839,7 @@ class BuiComparisonTable {
     computedClass = computed(() => cn('w-full overflow-x-auto rounded-xl border', this.userClass()), /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "computedClass" }] : /* istanbul ignore next */ []));
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.2", ngImport: i0, type: BuiComparisonTable, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.0.2", type: BuiComparisonTable, isStandalone: true, selector: "bui-comparison-table", inputs: { tiers: { classPropertyName: "tiers", publicName: "tiers", isSignal: true, isRequired: false, transformFunction: null }, rows: { classPropertyName: "rows", publicName: "rows", isSignal: true, isRequired: false, transformFunction: null }, highlight: { classPropertyName: "highlight", publicName: "highlight", isSignal: true, isRequired: false, transformFunction: null }, featureLabel: { classPropertyName: "featureLabel", publicName: "featureLabel", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null } }, host: { attributes: { "data-slot": "comparison-table" }, properties: { "class": "computedClass()" } }, ngImport: i0, template: `
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.0.2", type: BuiComparisonTable, isStandalone: true, selector: "bui-comparison-table", inputs: { tiers: { classPropertyName: "tiers", publicName: "tiers", isSignal: true, isRequired: false, transformFunction: null }, rows: { classPropertyName: "rows", publicName: "rows", isSignal: true, isRequired: false, transformFunction: null }, highlight: { classPropertyName: "highlight", publicName: "highlight", isSignal: true, isRequired: false, transformFunction: null }, featureLabel: { classPropertyName: "featureLabel", publicName: "featureLabel", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null }, includedLabel: { classPropertyName: "includedLabel", publicName: "includedLabel", isSignal: true, isRequired: false, transformFunction: null }, notIncludedLabel: { classPropertyName: "notIncludedLabel", publicName: "notIncludedLabel", isSignal: true, isRequired: false, transformFunction: null } }, host: { attributes: { "data-slot": "comparison-table" }, properties: { "class": "computedClass()" } }, ngImport: i0, template: `
     <table class="w-full text-sm">
       <caption class="sr-only">
         {{
@@ -5604,13 +5880,13 @@ class BuiComparisonTable {
                     stroke-width="2"
                     stroke-linecap="round"
                     stroke-linejoin="round"
-                    aria-label="Included"
+                    [attr.aria-label]="includedText()"
                     class="mx-auto size-4 text-primary"
                   >
                     <path d="M20 6 9 17l-5-5" />
                   </svg>
                 } @else if (value === false || value === null) {
-                  <span class="text-muted-foreground" aria-label="Not included">—</span>
+                  <span class="text-muted-foreground" [attr.aria-label]="notIncludedText()">—</span>
                 } @else {
                   {{ value }}
                 }
@@ -5668,13 +5944,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
                     stroke-width="2"
                     stroke-linecap="round"
                     stroke-linejoin="round"
-                    aria-label="Included"
+                    [attr.aria-label]="includedText()"
                     class="mx-auto size-4 text-primary"
                   >
                     <path d="M20 6 9 17l-5-5" />
                   </svg>
                 } @else if (value === false || value === null) {
-                  <span class="text-muted-foreground" aria-label="Not included">—</span>
+                  <span class="text-muted-foreground" [attr.aria-label]="notIncludedText()">—</span>
                 } @else {
                   {{ value }}
                 }
@@ -5686,15 +5962,17 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
     </table>
   `,
                 }]
-        }], propDecorators: { tiers: [{ type: i0.Input, args: [{ isSignal: true, alias: "tiers", required: false }] }], rows: [{ type: i0.Input, args: [{ isSignal: true, alias: "rows", required: false }] }], highlight: [{ type: i0.Input, args: [{ isSignal: true, alias: "highlight", required: false }] }], featureLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "featureLabel", required: false }] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }] } });
+        }], propDecorators: { tiers: [{ type: i0.Input, args: [{ isSignal: true, alias: "tiers", required: false }] }], rows: [{ type: i0.Input, args: [{ isSignal: true, alias: "rows", required: false }] }], highlight: [{ type: i0.Input, args: [{ isSignal: true, alias: "highlight", required: false }] }], featureLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "featureLabel", required: false }] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }], includedLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "includedLabel", required: false }] }], notIncludedLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "notIncludedLabel", required: false }] }] } });
 
 /**
  * A card that flips to reveal its back. Default content is the front; project the back
  * with `[buiFlipBack]`. `trigger="hover"` (default) or `"click"` (keyboard-accessible).
  */
 class BuiFlipCard {
+    /** What flips the card: hover/focus or click/keypress. */
     trigger = input('hover', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "trigger" }] : /* istanbul ignore next */ []));
+    /** Fixed card height as a CSS length. */
     height = input('16rem', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "height" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -5789,8 +6067,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** A card with a radial spotlight glow that follows the cursor on hover. */
 class BuiSpotlightCard {
+    /** Spotlight glow colour; defaults to a subtle foreground tint. */
     color = input(null, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "color" }] : /* istanbul ignore next */ []));
+    /** Spotlight radius in pixels. */
     size = input(350, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "size" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -5846,8 +6126,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** A card that tilts in 3D toward the cursor. SSR-safe (geometry read on mousemove). */
 class BuiTiltCard {
+    /** Maximum tilt angle in degrees on each axis. */
     max = input(10, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "max" }] : /* istanbul ignore next */ []));
+    /** Scale factor applied while the card is tilting. */
     scaleTo = input(1.05, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "scaleTo" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -5917,17 +6199,22 @@ const noop$b = () => { };
  * (arrows, Home/End, Enter, Escape) and outside-click close. SSR-safe.
  */
 class BuiSelect {
+    /** Selected option value (single mode). Two-way bindable with `[(value)]`. */
     value = model('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "value" }] : /* istanbul ignore next */ []));
     /** Select several options; binds `values` instead of `value`. */
     multiple = input(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "multiple" }] : /* istanbul ignore next */ []));
+    /** Selected option values (multiple mode). Two-way bindable with `[(values)]`. */
     values = model([], /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "values" }] : /* istanbul ignore next */ []));
+    /** Available options to choose from. */
     options = input([], /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "options" }] : /* istanbul ignore next */ []));
+    /** Text shown on the trigger when nothing is selected. */
     placeholder = input('Select…', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "placeholder" }] : /* istanbul ignore next */ []));
+    /** Whether the select is disabled. Two-way bindable with `[(disabled)]`. */
     disabled = model(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "disabled" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -6303,11 +6590,17 @@ const VARIANTS$1 = {
  * `threshold` px. SSR-safe — the scroll position is only read in the browser.
  */
 class BuiBackToTop {
+    /** Pixel scroll distance before the button appears. */
     threshold = input(300, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "threshold" }] : /* istanbul ignore next */ []));
+    /** Visual style of the button. */
     variant = input('primary', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "variant" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
+    /** Accessible label for the button; falls back to the i18n default. */
+    label = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "label" }] : /* istanbul ignore next */ []));
+    labelText = buiLabel('backToTop', this.label);
     shown = signal(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "shown" }] : /* istanbul ignore next */ []));
     variantClass = computed(() => VARIANTS$1[this.variant()], /* @ts-ignore */
@@ -6326,10 +6619,10 @@ class BuiBackToTop {
         globalThis.scrollTo({ top: 0, behavior: 'smooth' });
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.2", ngImport: i0, type: BuiBackToTop, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.1.0", version: "22.0.2", type: BuiBackToTop, isStandalone: true, selector: "bui-back-to-top", inputs: { threshold: { classPropertyName: "threshold", publicName: "threshold", isSignal: true, isRequired: false, transformFunction: null }, variant: { classPropertyName: "variant", publicName: "variant", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null } }, host: { attributes: { "data-slot": "back-to-top" }, listeners: { "window:scroll": "onScroll()" }, properties: { "hidden": "!shown()", "class": "computedClass()" } }, ngImport: i0, template: `
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.1.0", version: "22.0.2", type: BuiBackToTop, isStandalone: true, selector: "bui-back-to-top", inputs: { threshold: { classPropertyName: "threshold", publicName: "threshold", isSignal: true, isRequired: false, transformFunction: null }, variant: { classPropertyName: "variant", publicName: "variant", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null }, label: { classPropertyName: "label", publicName: "label", isSignal: true, isRequired: false, transformFunction: null } }, host: { attributes: { "data-slot": "back-to-top" }, listeners: { "window:scroll": "onScroll()" }, properties: { "hidden": "!shown()", "class": "computedClass()" } }, ngImport: i0, template: `
     <button
       type="button"
-      aria-label="Back to top"
+      [attr.aria-label]="labelText()"
       class="inline-flex size-10 items-center justify-center rounded-full shadow-md transition-colors outline-none focus-visible:ring-[3px] focus-visible:ring-ring/50"
       [class]="variantClass()"
       (click)="toTop()"
@@ -6363,7 +6656,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
                     template: `
     <button
       type="button"
-      aria-label="Back to top"
+      [attr.aria-label]="labelText()"
       class="inline-flex size-10 items-center justify-center rounded-full shadow-md transition-colors outline-none focus-visible:ring-[3px] focus-visible:ring-ring/50"
       [class]="variantClass()"
       (click)="toTop()"
@@ -6384,7 +6677,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
     </button>
   `,
                 }]
-        }], ctorParameters: () => [], propDecorators: { threshold: [{ type: i0.Input, args: [{ isSignal: true, alias: "threshold", required: false }] }], variant: [{ type: i0.Input, args: [{ isSignal: true, alias: "variant", required: false }] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }] } });
+        }], ctorParameters: () => [], propDecorators: { threshold: [{ type: i0.Input, args: [{ isSignal: true, alias: "threshold", required: false }] }], variant: [{ type: i0.Input, args: [{ isSignal: true, alias: "variant", required: false }] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }], label: [{ type: i0.Input, args: [{ isSignal: true, alias: "label", required: false }] }] } });
 
 // eslint-disable-next-line @typescript-eslint/no-empty-function
 const noop$a = () => { };
@@ -6393,17 +6686,22 @@ const noop$a = () => { };
  * filtered listbox, using the `aria-activedescendant` pattern. Full keyboard + outside-click.
  */
 class BuiCombobox {
+    /** Selected option value (single mode). Two-way bindable with `[(value)]`. */
     value = model('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "value" }] : /* istanbul ignore next */ []));
     /** Select several options; binds `values` instead of `value`. */
     multiple = input(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "multiple" }] : /* istanbul ignore next */ []));
+    /** Selected option values (multiple mode). Two-way bindable with `[(values)]`. */
     values = model([], /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "values" }] : /* istanbul ignore next */ []));
+    /** Available options to filter and choose from. */
     options = input([], /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "options" }] : /* istanbul ignore next */ []));
+    /** Placeholder text shown in the search input. */
     placeholder = input('Search…', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "placeholder" }] : /* istanbul ignore next */ []));
+    /** Whether the combobox is disabled. Two-way bindable with `[(disabled)]`. */
     disabled = model(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "disabled" }] : /* istanbul ignore next */ []));
     /** When false, the field can't be typed in — it just opens the full list (select-like). */
@@ -6706,8 +7004,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** A live countdown to a target time (`role="timer"`). SSR-safe — ticks only in the browser. */
 class BuiCountdown {
+    /** Target moment to count down to, as a Date, timestamp, or date string. */
     to = input.required(/* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "to" }] : /* istanbul ignore next */ []));
+    /** Text shown once the target time has passed. */
     expired = input('Expired', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "expired" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -6807,18 +7107,25 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
  * `aria-hidden`; an sr-only span carries the final value (SSR/no-JS read the real number).
  */
 class BuiNumberTicker {
+    /** Target value to count up to. */
     value = input(0, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "value" }] : /* istanbul ignore next */ []));
+    /** Starting value the animation counts from. */
     from = input(0, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "from" }] : /* istanbul ignore next */ []));
+    /** Animation length in milliseconds; 0 snaps instantly. */
     duration = input(1500, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "duration" }] : /* istanbul ignore next */ []));
+    /** Number of decimal places to display. */
     decimals = input(0, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "decimals" }] : /* istanbul ignore next */ []));
+    /** Text prepended before the number. */
     prefix = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "prefix" }] : /* istanbul ignore next */ []));
+    /** Text appended after the number. */
     suffix = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "suffix" }] : /* istanbul ignore next */ []));
+    /** Thousands-group separator character. */
     separator = input(',', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "separator" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -6887,8 +7194,10 @@ const VARIANTS = {
 };
 /** A styled anchor. Set `external` for `target=_blank` + safe `rel`. */
 class BuiLink {
+    /** Visual style of the link: default, muted, or subtle. */
     variant = input('default', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "variant" }] : /* istanbul ignore next */ []));
+    /** Whether the link is external, adding `target=_blank` and safe `rel`. */
     external = input(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "external" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -6922,14 +7231,19 @@ const PRESETS = {
 };
 /** Renders accessible text painted with a CSS gradient, with an optional shimmer. */
 class BuiGradientText {
+    /** Named colour preset used when from/via/to are not set. */
     preset = input('brand', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "preset" }] : /* istanbul ignore next */ []));
+    /** Gradient start colour; overrides the preset's first stop. */
     from = input(null, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "from" }] : /* istanbul ignore next */ []));
+    /** Gradient middle colour; overrides the preset's second stop. */
     via = input(null, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "via" }] : /* istanbul ignore next */ []));
+    /** Gradient end colour; overrides the preset's third stop. */
     to = input(null, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "to" }] : /* istanbul ignore next */ []));
+    /** Whether to animate a horizontal shimmer across the gradient. */
     animate = input(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "animate" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -6962,10 +7276,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
  * Provide the title via the `heading` input or by projecting content.
  */
 class BuiPageHeader {
+    /** Title text rendered in the heading (alternative to projecting content). */
     heading = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "heading" }] : /* istanbul ignore next */ []));
+    /** Optional supporting text shown beneath the heading. */
     description = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "description" }] : /* istanbul ignore next */ []));
+    /** Whether to render a bottom border separating the header from the page. */
     separator = input(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "separator" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -7013,12 +7330,16 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** A styled blockquote / testimonial with optional attribution (author, role, avatar). */
 class BuiQuote {
+    /** Name of the person credited in the attribution. */
     author = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "author" }] : /* istanbul ignore next */ []));
+    /** Role or title shown beneath the author. */
     role = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "role" }] : /* istanbul ignore next */ []));
+    /** URL of the author's avatar image. */
     avatar = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "avatar" }] : /* istanbul ignore next */ []));
+    /** Source URL for the quote, set as the blockquote's `cite` attribute. */
     cite = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "cite" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -7114,14 +7435,19 @@ const SIZES$2 = { sm: 'text-sm', default: 'text-base', lg: 'text-2xl' };
 const COMPARE_SIZES = { sm: 'text-xs', default: 'text-sm', lg: 'text-base' };
 /** A price display with optional compare-at (strikethrough) and a discount badge. */
 class BuiPrice {
+    /** Current price amount to display. */
     amount = input(0, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "amount" }] : /* istanbul ignore next */ []));
+    /** Original price; when higher than amount, shows as struck-through. */
     compareAt = input(null, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "compareAt" }] : /* istanbul ignore next */ []));
+    /** Currency symbol prefixed to each value. */
     currency = input('$', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "currency" }] : /* istanbul ignore next */ []));
+    /** Text size preset for the price. */
     size = input('default', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "size" }] : /* istanbul ignore next */ []));
+    /** Whether to show the percentage-off discount badge when on sale. */
     showDiscount = input(true, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "showDiscount" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -7217,14 +7543,19 @@ const JUSTIFY = {
 };
 /** A flexbox stack layout helper (direction, gap, alignment). */
 class BuiStack {
+    /** Flex direction: vertical (`col`) or horizontal (`row`). */
     direction = input('col', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "direction" }] : /* istanbul ignore next */ []));
+    /** Spacing between items, as a Tailwind gap step. */
     gap = input('4', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "gap" }] : /* istanbul ignore next */ []));
+    /** Cross-axis alignment (`start`/`center`/`end`/`stretch`/`baseline`). */
     align = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "align" }] : /* istanbul ignore next */ []));
+    /** Main-axis distribution (`start`/`center`/`end`/`between`/`around`/`evenly`). */
     justify = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "justify" }] : /* istanbul ignore next */ []));
+    /** Whether items wrap onto multiple lines when they overflow. */
     wrap = input(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "wrap" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -7246,8 +7577,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
  * design tokens locally. Renders as `display: contents` so it adds no box.
  */
 class BuiAccent {
+    /** Accent color applied to the primary tokens; `null` leaves the theme unchanged. */
     color = input(null, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "color" }] : /* istanbul ignore next */ []));
+    /** Foreground color paired with the accent for text/icons on accented surfaces. */
     foreground = input('#ffffff', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "foreground" }] : /* istanbul ignore next */ []));
     styleVars = computed(() => {
@@ -7296,14 +7629,19 @@ const LABELS = { online: 'Online', away: 'Away', busy: 'Busy', offline: 'Offline
 const SIZES$1 = { sm: 'size-2', default: 'size-2.5', lg: 'size-3' };
 /** A small status dot (online/away/busy/offline). Status is never colour-only — the label is always present. */
 class BuiPresence {
+    /** Presence state, which sets the dot color and default label. */
     status = input('online', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "status" }] : /* istanbul ignore next */ []));
+    /** Size preset for the status dot. */
     size = input('default', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "size" }] : /* istanbul ignore next */ []));
+    /** Whether to show a pulsing ping animation (only when `online`). */
     pulse = input(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "pulse" }] : /* istanbul ignore next */ []));
+    /** Custom label text; defaults to the status name. */
     label = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "label" }] : /* istanbul ignore next */ []));
+    /** Whether to render the label visibly; otherwise it stays screen-reader only. */
     showLabel = input(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "showLabel" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -7373,10 +7711,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** A single timeline entry: a dot + connector line and a content area. */
 class BuiTimelineItem {
+    /** Timestamp label shown above the entry's title. */
     time = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "time" }] : /* istanbul ignore next */ []));
+    /** Heading text for the entry. */
     title = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "title" }] : /* istanbul ignore next */ []));
+    /** Whether to highlight this entry as the current/active step. */
     active = input(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "active" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -7456,8 +7797,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** A description list (`<dl>`). Children should be `bui-description-item`. */
 class BuiDescriptionList {
+    /** Arrangement of each item's term and description, side by side or stacked. */
     layout = input('horizontal', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "layout" }] : /* istanbul ignore next */ []));
+    /** Whether to render a bordered card with dividers between items. */
     bordered = input(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "bordered" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -7478,6 +7821,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** A term/description row. Inherits horizontal/bordered layout from its parent list. */
 class BuiDescriptionItem {
+    /** The term label shown in the row's `<dt>`. */
     term = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "term" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -7526,8 +7870,10 @@ const GAPS = {
 };
 /** A Pinterest-style masonry grid using native CSS multi-column layout. */
 class BuiMasonry {
+    /** Maximum number of columns at the widest breakpoint (1-6, responsive). */
     columns = input(3, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "columns" }] : /* istanbul ignore next */ []));
+    /** Spacing between items, as a Tailwind spacing key ('0', '2', '3', '4', '6', '8'). */
     gap = input('4', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "gap" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -7551,6 +7897,7 @@ const COLUMNS$1 = {
 };
 /** A bento grid container. Use `bui-bento-item` for cells. */
 class BuiBentoGrid {
+    /** Number of columns at the largest breakpoint (2, 3 or 4). */
     columns = input(3, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "columns" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -7571,12 +7918,16 @@ const COL_SPAN = { 1: '', 2: 'lg:col-span-2', 3: 'lg:col-span-3' };
 const ROW_SPAN = { 1: '', 2: 'row-span-2' };
 /** A bento grid cell with optional title/description and configurable span. */
 class BuiBentoItem {
+    /** Optional heading rendered above the projected content. */
     title = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "title" }] : /* istanbul ignore next */ []));
+    /** Optional muted description rendered below the title. */
     description = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "description" }] : /* istanbul ignore next */ []));
+    /** How many grid columns the cell spans (1-3). */
     colSpan = input(1, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "colSpan" }] : /* istanbul ignore next */ []));
+    /** How many grid rows the cell spans (1-2). */
     rowSpan = input(1, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "rowSpan" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -7620,10 +7971,13 @@ const COLUMNS = {
 };
 /** A responsive thumbnail grid. */
 class BuiGallery {
+    /** Images to display, given as URLs or `GalleryImage` objects. */
     images = input([], /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "images" }] : /* istanbul ignore next */ []));
+    /** Number of grid columns (1-6). */
     columns = input(3, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "columns" }] : /* istanbul ignore next */ []));
+    /** Tailwind class controlling thumbnail corner rounding. */
     rounded = input('rounded-lg', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "rounded" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -7657,10 +8011,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** A veil with a spinner shown over its projected content while `show` is true. */
 class BuiLoadingOverlay {
+    /** Whether the loading veil is shown over the projected content. */
     show = input(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "show" }] : /* istanbul ignore next */ []));
+    /** Text shown beneath the spinner; defaults to "Loading…" when empty. */
     message = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "message" }] : /* istanbul ignore next */ []));
+    /** Whether the veil blurs the content behind it. */
     blur = input(true, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "blur" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -7750,20 +8107,35 @@ const INPUT_SIZE = {
 };
 /** A numeric stepper: − / + buttons around a number field, with min/max/step clamping. */
 class BuiNumberInput {
+    /** Current number. Two-way bindable with `[(value)]`. */
     value = model(0, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "value" }] : /* istanbul ignore next */ []));
+    /** Minimum allowed value, or null for no lower bound. */
     min = input(null, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "min" }] : /* istanbul ignore next */ []));
+    /** Maximum allowed value, or null for no upper bound. */
     max = input(null, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "max" }] : /* istanbul ignore next */ []));
+    /** Amount added or subtracted per step. */
     stepBy = input(1, { ...(ngDevMode ? { debugName: "stepBy" } : /* istanbul ignore next */ {}), alias: 'step' });
+    /** Whether the control is disabled. Two-way bindable with `[(disabled)]`. */
     disabled = model(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "disabled" }] : /* istanbul ignore next */ []));
+    /** Size preset controlling stepper button and field dimensions. */
     size = input('default', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "size" }] : /* istanbul ignore next */ []));
+    /** Accessible label for the number field. */
     ariaLabel = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "ariaLabel" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
+    /** Accessible label override for the decrease button. */
+    decreaseLabel = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "decreaseLabel" }] : /* istanbul ignore next */ []));
+    /** Accessible label override for the increase button. */
+    increaseLabel = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "increaseLabel" }] : /* istanbul ignore next */ []));
+    decreaseText = buiLabel('numberInputDecrease', this.decreaseLabel);
+    increaseText = buiLabel('numberInputIncrease', this.increaseLabel);
     onChange = noop$9;
     onTouched = noop$9;
     btnClass = computed(() => cn(BTN, BTN_SIZE[this.size()]), /* @ts-ignore */
@@ -7815,7 +8187,7 @@ class BuiNumberInput {
         this.disabled.set(isDisabled);
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.2", ngImport: i0, type: BuiNumberInput, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.1.0", version: "22.0.2", type: BuiNumberInput, isStandalone: true, selector: "bui-number-input", inputs: { value: { classPropertyName: "value", publicName: "value", isSignal: true, isRequired: false, transformFunction: null }, min: { classPropertyName: "min", publicName: "min", isSignal: true, isRequired: false, transformFunction: null }, max: { classPropertyName: "max", publicName: "max", isSignal: true, isRequired: false, transformFunction: null }, stepBy: { classPropertyName: "stepBy", publicName: "step", isSignal: true, isRequired: false, transformFunction: null }, disabled: { classPropertyName: "disabled", publicName: "disabled", isSignal: true, isRequired: false, transformFunction: null }, size: { classPropertyName: "size", publicName: "size", isSignal: true, isRequired: false, transformFunction: null }, ariaLabel: { classPropertyName: "ariaLabel", publicName: "ariaLabel", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { value: "valueChange", disabled: "disabledChange" }, host: { attributes: { "data-slot": "number-input" }, properties: { "class": "computedClass()" } }, providers: [
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.1.0", version: "22.0.2", type: BuiNumberInput, isStandalone: true, selector: "bui-number-input", inputs: { value: { classPropertyName: "value", publicName: "value", isSignal: true, isRequired: false, transformFunction: null }, min: { classPropertyName: "min", publicName: "min", isSignal: true, isRequired: false, transformFunction: null }, max: { classPropertyName: "max", publicName: "max", isSignal: true, isRequired: false, transformFunction: null }, stepBy: { classPropertyName: "stepBy", publicName: "step", isSignal: true, isRequired: false, transformFunction: null }, disabled: { classPropertyName: "disabled", publicName: "disabled", isSignal: true, isRequired: false, transformFunction: null }, size: { classPropertyName: "size", publicName: "size", isSignal: true, isRequired: false, transformFunction: null }, ariaLabel: { classPropertyName: "ariaLabel", publicName: "ariaLabel", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null }, decreaseLabel: { classPropertyName: "decreaseLabel", publicName: "decreaseLabel", isSignal: true, isRequired: false, transformFunction: null }, increaseLabel: { classPropertyName: "increaseLabel", publicName: "increaseLabel", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { value: "valueChange", disabled: "disabledChange" }, host: { attributes: { "data-slot": "number-input" }, properties: { "class": "computedClass()" } }, providers: [
             { provide: NG_VALUE_ACCESSOR, useExisting: forwardRef(() => BuiNumberInput), multi: true },
         ], ngImport: i0, template: `
     <button
@@ -7823,7 +8195,7 @@ class BuiNumberInput {
       [class]="btnClass() + ' rounded-l-md'"
       (click)="step(-1)"
       [disabled]="disabled() || atMin()"
-      aria-label="Decrease"
+      [attr.aria-label]="decreaseText()"
     >
       <svg
         viewBox="0 0 24 24"
@@ -7856,7 +8228,7 @@ class BuiNumberInput {
       [class]="btnClass() + ' rounded-r-md'"
       (click)="step(1)"
       [disabled]="disabled() || atMax()"
-      aria-label="Increase"
+      [attr.aria-label]="increaseText()"
     >
       <svg
         viewBox="0 0 24 24"
@@ -7887,7 +8259,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
       [class]="btnClass() + ' rounded-l-md'"
       (click)="step(-1)"
       [disabled]="disabled() || atMin()"
-      aria-label="Decrease"
+      [attr.aria-label]="decreaseText()"
     >
       <svg
         viewBox="0 0 24 24"
@@ -7920,7 +8292,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
       [class]="btnClass() + ' rounded-r-md'"
       (click)="step(1)"
       [disabled]="disabled() || atMax()"
-      aria-label="Increase"
+      [attr.aria-label]="increaseText()"
     >
       <svg
         viewBox="0 0 24 24"
@@ -7937,18 +8309,23 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
     </button>
   `,
                 }]
-        }], propDecorators: { value: [{ type: i0.Input, args: [{ isSignal: true, alias: "value", required: false }] }, { type: i0.Output, args: ["valueChange"] }], min: [{ type: i0.Input, args: [{ isSignal: true, alias: "min", required: false }] }], max: [{ type: i0.Input, args: [{ isSignal: true, alias: "max", required: false }] }], stepBy: [{ type: i0.Input, args: [{ isSignal: true, alias: "step", required: false }] }], disabled: [{ type: i0.Input, args: [{ isSignal: true, alias: "disabled", required: false }] }, { type: i0.Output, args: ["disabledChange"] }], size: [{ type: i0.Input, args: [{ isSignal: true, alias: "size", required: false }] }], ariaLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "ariaLabel", required: false }] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }] } });
+        }], propDecorators: { value: [{ type: i0.Input, args: [{ isSignal: true, alias: "value", required: false }] }, { type: i0.Output, args: ["valueChange"] }], min: [{ type: i0.Input, args: [{ isSignal: true, alias: "min", required: false }] }], max: [{ type: i0.Input, args: [{ isSignal: true, alias: "max", required: false }] }], stepBy: [{ type: i0.Input, args: [{ isSignal: true, alias: "step", required: false }] }], disabled: [{ type: i0.Input, args: [{ isSignal: true, alias: "disabled", required: false }] }, { type: i0.Output, args: ["disabledChange"] }], size: [{ type: i0.Input, args: [{ isSignal: true, alias: "size", required: false }] }], ariaLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "ariaLabel", required: false }] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }], decreaseLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "decreaseLabel", required: false }] }], increaseLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "increaseLabel", required: false }] }] } });
 
 /** A radio-group of product variants, rendered as pills or colour swatches. */
 class BuiVariantSelector {
+    /** Selected variant value. Two-way bindable with `[(value)]`. */
     value = model('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "value" }] : /* istanbul ignore next */ []));
+    /** Available options, as plain strings or `VariantOption` objects. */
     options = input([], /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "options" }] : /* istanbul ignore next */ []));
+    /** Render style: text pills or colour swatches. */
     type = input('pill', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "type" }] : /* istanbul ignore next */ []));
+    /** Accessible label for the radio group. */
     label = input('Variant', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "label" }] : /* istanbul ignore next */ []));
+    /** Whether the whole group is disabled. */
     disabled = input(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "disabled" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -8067,16 +8444,22 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** A tiny inline SVG trend chart (line + optional area). Pure, SSR-safe. */
 class BuiSparkline {
+    /** Numeric series to plot; needs at least two points to render. */
     data = input([], /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "data" }] : /* istanbul ignore next */ []));
+    /** SVG width in pixels. */
     width = input(100, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "width" }] : /* istanbul ignore next */ []));
+    /** SVG height in pixels. */
     height = input(28, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "height" }] : /* istanbul ignore next */ []));
+    /** Whether to draw the translucent area fill under the line. */
     area = input(true, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "area" }] : /* istanbul ignore next */ []));
+    /** Line stroke width in pixels (also used as edge padding). */
     strokeWidth = input(1.5, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "strokeWidth" }] : /* istanbul ignore next */ []));
+    /** Accessible label for the sparkline's `aria-label`. */
     ariaLabel = input('Trend', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "ariaLabel" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -8183,13 +8566,17 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 const SIZES = { default: 'h-9 px-4 py-2', sm: 'h-8 gap-1.5 px-3', lg: 'h-10 px-6' };
 /** A stateful add-to-cart button: idle → adding → added → idle. Emits `triggered` on click. */
 class BuiAddToCart {
+    /** Button text shown in the idle and adding states. */
     label = input('Add to cart', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "label" }] : /* istanbul ignore next */ []));
+    /** Button text shown briefly in the added (success) state. */
     addedLabel = input('Added', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "addedLabel" }] : /* istanbul ignore next */ []));
+    /** Size preset controlling height and padding. */
     size = input('default', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "size" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
+    /** Emitted when the button is clicked to add the item. */
     triggered = output();
     state = signal('idle', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "state" }] : /* istanbul ignore next */ []));
@@ -8364,18 +8751,25 @@ const TEXT_COLORS = [
 ];
 /** A password field with a live strength meter and (optional) requirement checklist. */
 class BuiPasswordStrength {
+    /** Current password value. Two-way bindable with `[(password)]`. */
     password = model('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "password" }] : /* istanbul ignore next */ []));
+    /** Native `name` attribute for the input. */
     name = input('password', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "name" }] : /* istanbul ignore next */ []));
+    /** Input `id`; defaults to `name` when empty. */
     id = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "id" }] : /* istanbul ignore next */ []));
+    /** Placeholder text for the input. */
     placeholder = input('••••••••', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "placeholder" }] : /* istanbul ignore next */ []));
+    /** Whether the requirement checklist is shown. */
     showChecklist = input(true, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "showChecklist" }] : /* istanbul ignore next */ []));
+    /** Minimum length required to satisfy the length rule. */
     minLength = input(8, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "minLength" }] : /* istanbul ignore next */ []));
+    /** Accessible label for the input. */
     label = input('Password', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "label" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -8553,31 +8947,47 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** A product card: image, badge, wishlist, title, rating, price, and an action slot. */
 class BuiProductCard {
+    /** Product title shown as the card heading. */
     title = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "title" }] : /* istanbul ignore next */ []));
+    /** Optional link; when set the title becomes an anchor to this URL. */
     href = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "href" }] : /* istanbul ignore next */ []));
+    /** Source URL of the product image. */
     image = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "image" }] : /* istanbul ignore next */ []));
+    /** Alt text for the image; falls back to the title when empty. */
     imageAlt = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "imageAlt" }] : /* istanbul ignore next */ []));
+    /** Current price; hides the price block when null. */
     price = input(null, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "price" }] : /* istanbul ignore next */ []));
+    /** Original price for showing a strikethrough and discount. */
     compareAt = input(null, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "compareAt" }] : /* istanbul ignore next */ []));
+    /** Currency symbol prefixed to the price. */
     currency = input('$', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "currency" }] : /* istanbul ignore next */ []));
+    /** Badge text; auto-coloured for sale/new keywords. */
     badge = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "badge" }] : /* istanbul ignore next */ []));
+    /** Small category label shown above the title. */
     category = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "category" }] : /* istanbul ignore next */ []));
+    /** Star rating value; hides the rating row when null. */
     rating = input(null, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "rating" }] : /* istanbul ignore next */ []));
+    /** Review count shown next to the rating, when set. */
     reviews = input(null, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "reviews" }] : /* istanbul ignore next */ []));
+    /** Whether to show the wishlist (heart) toggle button. */
     wishlist = input(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "wishlist" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
+    /** Accessible label override for the wishlist toggle button. */
+    wishlistLabel = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "wishlistLabel" }] : /* istanbul ignore next */ []));
+    wishlistText = buiLabel('productCardWishlist', this.wishlistLabel);
     wished = signal(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "wished" }] : /* istanbul ignore next */ []));
     alt = computed(() => this.imageAlt() || this.title(), /* @ts-ignore */
@@ -8596,7 +9006,7 @@ class BuiProductCard {
     computedClass = computed(() => cn('group flex flex-col overflow-hidden rounded-xl border bg-card text-card-foreground shadow-sm', this.userClass()), /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "computedClass" }] : /* istanbul ignore next */ []));
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.2", ngImport: i0, type: BuiProductCard, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.0.2", type: BuiProductCard, isStandalone: true, selector: "bui-product-card", inputs: { title: { classPropertyName: "title", publicName: "title", isSignal: true, isRequired: false, transformFunction: null }, href: { classPropertyName: "href", publicName: "href", isSignal: true, isRequired: false, transformFunction: null }, image: { classPropertyName: "image", publicName: "image", isSignal: true, isRequired: false, transformFunction: null }, imageAlt: { classPropertyName: "imageAlt", publicName: "imageAlt", isSignal: true, isRequired: false, transformFunction: null }, price: { classPropertyName: "price", publicName: "price", isSignal: true, isRequired: false, transformFunction: null }, compareAt: { classPropertyName: "compareAt", publicName: "compareAt", isSignal: true, isRequired: false, transformFunction: null }, currency: { classPropertyName: "currency", publicName: "currency", isSignal: true, isRequired: false, transformFunction: null }, badge: { classPropertyName: "badge", publicName: "badge", isSignal: true, isRequired: false, transformFunction: null }, category: { classPropertyName: "category", publicName: "category", isSignal: true, isRequired: false, transformFunction: null }, rating: { classPropertyName: "rating", publicName: "rating", isSignal: true, isRequired: false, transformFunction: null }, reviews: { classPropertyName: "reviews", publicName: "reviews", isSignal: true, isRequired: false, transformFunction: null }, wishlist: { classPropertyName: "wishlist", publicName: "wishlist", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null } }, host: { attributes: { "data-slot": "product-card" }, properties: { "class": "computedClass()" } }, ngImport: i0, template: `
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.0.2", type: BuiProductCard, isStandalone: true, selector: "bui-product-card", inputs: { title: { classPropertyName: "title", publicName: "title", isSignal: true, isRequired: false, transformFunction: null }, href: { classPropertyName: "href", publicName: "href", isSignal: true, isRequired: false, transformFunction: null }, image: { classPropertyName: "image", publicName: "image", isSignal: true, isRequired: false, transformFunction: null }, imageAlt: { classPropertyName: "imageAlt", publicName: "imageAlt", isSignal: true, isRequired: false, transformFunction: null }, price: { classPropertyName: "price", publicName: "price", isSignal: true, isRequired: false, transformFunction: null }, compareAt: { classPropertyName: "compareAt", publicName: "compareAt", isSignal: true, isRequired: false, transformFunction: null }, currency: { classPropertyName: "currency", publicName: "currency", isSignal: true, isRequired: false, transformFunction: null }, badge: { classPropertyName: "badge", publicName: "badge", isSignal: true, isRequired: false, transformFunction: null }, category: { classPropertyName: "category", publicName: "category", isSignal: true, isRequired: false, transformFunction: null }, rating: { classPropertyName: "rating", publicName: "rating", isSignal: true, isRequired: false, transformFunction: null }, reviews: { classPropertyName: "reviews", publicName: "reviews", isSignal: true, isRequired: false, transformFunction: null }, wishlist: { classPropertyName: "wishlist", publicName: "wishlist", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null }, wishlistLabel: { classPropertyName: "wishlistLabel", publicName: "wishlistLabel", isSignal: true, isRequired: false, transformFunction: null } }, host: { attributes: { "data-slot": "product-card" }, properties: { "class": "computedClass()" } }, ngImport: i0, template: `
     <div class="relative aspect-square overflow-hidden bg-muted">
       <img
         [src]="image()"
@@ -8614,7 +9024,7 @@ class BuiProductCard {
           type="button"
           class="absolute end-2 top-2 inline-flex size-8 items-center justify-center rounded-full border bg-background/80 shadow-sm backdrop-blur transition-colors hover:bg-background"
           [attr.aria-pressed]="wished()"
-          aria-label="Add to wishlist"
+          [attr.aria-label]="wishlistText()"
           (click)="wished.set(!wished())"
         >
           <svg
@@ -8696,7 +9106,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
           type="button"
           class="absolute end-2 top-2 inline-flex size-8 items-center justify-center rounded-full border bg-background/80 shadow-sm backdrop-blur transition-colors hover:bg-background"
           [attr.aria-pressed]="wished()"
-          aria-label="Add to wishlist"
+          [attr.aria-label]="wishlistText()"
           (click)="wished.set(!wished())"
         >
           <svg
@@ -8754,23 +9164,29 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
     </div>
   `,
                 }]
-        }], propDecorators: { title: [{ type: i0.Input, args: [{ isSignal: true, alias: "title", required: false }] }], href: [{ type: i0.Input, args: [{ isSignal: true, alias: "href", required: false }] }], image: [{ type: i0.Input, args: [{ isSignal: true, alias: "image", required: false }] }], imageAlt: [{ type: i0.Input, args: [{ isSignal: true, alias: "imageAlt", required: false }] }], price: [{ type: i0.Input, args: [{ isSignal: true, alias: "price", required: false }] }], compareAt: [{ type: i0.Input, args: [{ isSignal: true, alias: "compareAt", required: false }] }], currency: [{ type: i0.Input, args: [{ isSignal: true, alias: "currency", required: false }] }], badge: [{ type: i0.Input, args: [{ isSignal: true, alias: "badge", required: false }] }], category: [{ type: i0.Input, args: [{ isSignal: true, alias: "category", required: false }] }], rating: [{ type: i0.Input, args: [{ isSignal: true, alias: "rating", required: false }] }], reviews: [{ type: i0.Input, args: [{ isSignal: true, alias: "reviews", required: false }] }], wishlist: [{ type: i0.Input, args: [{ isSignal: true, alias: "wishlist", required: false }] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }] } });
+        }], propDecorators: { title: [{ type: i0.Input, args: [{ isSignal: true, alias: "title", required: false }] }], href: [{ type: i0.Input, args: [{ isSignal: true, alias: "href", required: false }] }], image: [{ type: i0.Input, args: [{ isSignal: true, alias: "image", required: false }] }], imageAlt: [{ type: i0.Input, args: [{ isSignal: true, alias: "imageAlt", required: false }] }], price: [{ type: i0.Input, args: [{ isSignal: true, alias: "price", required: false }] }], compareAt: [{ type: i0.Input, args: [{ isSignal: true, alias: "compareAt", required: false }] }], currency: [{ type: i0.Input, args: [{ isSignal: true, alias: "currency", required: false }] }], badge: [{ type: i0.Input, args: [{ isSignal: true, alias: "badge", required: false }] }], category: [{ type: i0.Input, args: [{ isSignal: true, alias: "category", required: false }] }], rating: [{ type: i0.Input, args: [{ isSignal: true, alias: "rating", required: false }] }], reviews: [{ type: i0.Input, args: [{ isSignal: true, alias: "reviews", required: false }] }], wishlist: [{ type: i0.Input, args: [{ isSignal: true, alias: "wishlist", required: false }] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }], wishlistLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "wishlistLabel", required: false }] }] } });
 
 /**
  * Types and deletes a cycling list of words. The animated text is `aria-hidden`; an sr-only
  * span carries the full word list so assistive tech reads it once. SSR-safe.
  */
 class BuiTypewriter {
+    /** Words cycled through by the typewriter. */
     words = input([], /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "words" }] : /* istanbul ignore next */ []));
+    /** Delay between typed characters, in milliseconds. */
     typeSpeed = input(90, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "typeSpeed" }] : /* istanbul ignore next */ []));
+    /** Delay between deleted characters, in milliseconds. */
     deleteSpeed = input(40, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "deleteSpeed" }] : /* istanbul ignore next */ []));
+    /** Pause once a word is fully typed before deleting, in milliseconds. */
     pause = input(1600, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "pause" }] : /* istanbul ignore next */ []));
+    /** Whether to restart from the first word after the last. */
     loop = input(true, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "loop" }] : /* istanbul ignore next */ []));
+    /** Whether to show the blinking cursor after the text. */
     cursor = input(true, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "cursor" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -8867,14 +9283,19 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
  * an `aria-live` region carries the full passage up front. SSR-safe.
  */
 class BuiStreamingText {
+    /** Full passage to reveal; also announced up front via an `aria-live` region. */
     text = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "text" }] : /* istanbul ignore next */ []));
+    /** Delay in milliseconds between each revealed token. */
     speed = input(18, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "speed" }] : /* istanbul ignore next */ []));
+    /** Delay in milliseconds before streaming begins. */
     startDelay = input(0, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "startDelay" }] : /* istanbul ignore next */ []));
+    /** Granularity of the reveal — one character or one word at a time. */
     by = input('char', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "by" }] : /* istanbul ignore next */ []));
+    /** Whether to show a blinking caret while streaming. */
     caret = input(true, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "caret" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -8949,10 +9370,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** A card whose border has a light beam continuously travelling around it. */
 class BuiBorderBeam {
+    /** Seconds for the beam to complete one full lap. */
     duration = input(6, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "duration" }] : /* istanbul ignore next */ []));
+    /** Beam colour; defaults to the primary theme colour. */
     color = input(null, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "color" }] : /* istanbul ignore next */ []));
+    /** Border/beam thickness in pixels. */
     size = input(2, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "size" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -8985,8 +9409,10 @@ function pseudo(seed) {
 }
 /** Animated falling meteor streaks behind content. Decorative + SSR-safe. */
 class BuiMeteors {
+    /** Number of meteor streaks to render. */
     count = input(20, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "count" }] : /* istanbul ignore next */ []));
+    /** Meteor colour; defaults to a translucent foreground tint. */
     color = input(null, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "color" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -9044,8 +9470,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** An animated aurora / northern-lights gradient background with content overlaid. */
 class BuiAurora {
+    /** Blur radius of the aurora layer in pixels. */
     blur = input(60, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "blur" }] : /* istanbul ignore next */ []));
+    /** Seconds for one full drift animation cycle. */
     speed = input(12, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "speed" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -9071,14 +9499,19 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** A seamless infinite scroll of `items` (logos, badges, testimonials…). */
 class BuiMarquee {
+    /** Items rendered in sequence and scrolled seamlessly. */
     items = input([], /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "items" }] : /* istanbul ignore next */ []));
+    /** Scroll direction; `up`/`down` switch the marquee to a vertical track. */
     direction = input('left', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "direction" }] : /* istanbul ignore next */ []));
+    /** Time for one full loop, as a CSS duration (e.g. `40s`). */
     duration = input('40s', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "duration" }] : /* istanbul ignore next */ []));
+    /** Spacing between items, as a CSS length. */
     gap = input('1rem', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "gap" }] : /* istanbul ignore next */ []));
+    /** Whether hovering pauses the scroll animation. */
     pauseOnHover = input(true, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "pauseOnHover" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -9158,6 +9591,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** A mobile bottom tab bar. Use `[buiBottomNavItem]` on each `<a>`/`<button>`. */
 class BuiBottomNavigation {
+    /** Accessible label applied to the navigation element. */
     ariaLabel = input('Bottom navigation', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "ariaLabel" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -9180,10 +9614,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** A single bottom-navigation tab. Project the icon; pass `label`, `active`, `badge`. */
 class BuiBottomNavigationItem {
+    /** Caption shown beneath the projected icon; hidden when empty. */
     label = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "label" }] : /* istanbul ignore next */ []));
+    /** Whether this tab is the current page; sets `aria-current="page"`. */
     active = input(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "active" }] : /* istanbul ignore next */ []));
+    /** Badge content; `true` renders a dot, a string/number renders a count, `null` shows nothing. */
     badge = input(null, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "badge" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -9242,6 +9679,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
  * viewport. Server-renders fully revealed (no-JS safe). SSR-safe.
  */
 class BuiTextReveal {
+    /** Text split into words that brighten one by one as it scrolls into view. */
     text = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "text" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -9301,8 +9739,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** Shifts its content relative to scroll for a depth/parallax effect. SSR-safe. */
 class BuiParallax {
+    /** Parallax intensity; higher moves content more per scroll. */
     speed = input(0.3, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "speed" }] : /* istanbul ignore next */ []));
+    /** Axis along which the content shifts. */
     axis = input('y', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "axis" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -9347,9 +9787,14 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** A "on this page" nav that highlights the section currently in view (IntersectionObserver). */
 class BuiScrollspy {
+    /** Sections to track; each item links to and observes its `href` anchor. */
     items = input([], /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "items" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
+    /** Accessible label for the nav element; falls back to a localized default. */
+    label = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "label" }] : /* istanbul ignore next */ []));
+    labelText = buiLabel('scrollspy', this.label);
     document = inject(ElementRef).nativeElement.ownerDocument;
     active = signal('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "active" }] : /* istanbul ignore next */ []));
@@ -9391,8 +9836,8 @@ class BuiScrollspy {
         }
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.2", ngImport: i0, type: BuiScrollspy, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.0.2", type: BuiScrollspy, isStandalone: true, selector: "bui-scrollspy", inputs: { items: { classPropertyName: "items", publicName: "items", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null } }, host: { attributes: { "data-slot": "scrollspy" }, properties: { "class": "computedClass()" } }, ngImport: i0, template: `
-    <nav aria-label="On this page">
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.0.2", type: BuiScrollspy, isStandalone: true, selector: "bui-scrollspy", inputs: { items: { classPropertyName: "items", publicName: "items", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null }, label: { classPropertyName: "label", publicName: "label", isSignal: true, isRequired: false, transformFunction: null } }, host: { attributes: { "data-slot": "scrollspy" }, properties: { "class": "computedClass()" } }, ngImport: i0, template: `
+    <nav [attr.aria-label]="labelText()">
       <ul class="space-y-1 text-sm">
         @for (item of items(); track item.href) {
           <li>
@@ -9415,7 +9860,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
                     selector: 'bui-scrollspy',
                     host: { 'data-slot': 'scrollspy', '[class]': 'computedClass()' },
                     template: `
-    <nav aria-label="On this page">
+    <nav [attr.aria-label]="labelText()">
       <ul class="space-y-1 text-sm">
         @for (item of items(); track item.href) {
           <li>
@@ -9432,25 +9877,32 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
     </nav>
   `,
                 }]
-        }], ctorParameters: () => [], propDecorators: { items: [{ type: i0.Input, args: [{ isSignal: true, alias: "items", required: false }] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }] } });
+        }], ctorParameters: () => [], propDecorators: { items: [{ type: i0.Input, args: [{ isSignal: true, alias: "items", required: false }] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }], label: [{ type: i0.Input, args: [{ isSignal: true, alias: "label", required: false }] }] } });
 
 // eslint-disable-next-line @typescript-eslint/no-empty-function
 const noop$8 = () => { };
 const SELECT_CLASS = 'h-9 rounded-md border border-input bg-background px-2 text-sm shadow-xs outline-none focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/50 disabled:pointer-events-none disabled:opacity-50';
 /** A styled time field: a native `<input type="time">`, or hour/minute selects in `select` mode. */
 class BuiTimeField {
+    /** Selected time as `HH:mm`. Two-way bindable with `[(value)]`. */
     value = model('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "value" }] : /* istanbul ignore next */ []));
+    /** Native `name` attribute for the input. */
     name = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "name" }] : /* istanbul ignore next */ []));
+    /** Native `id` attribute for the input. */
     id = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "id" }] : /* istanbul ignore next */ []));
+    /** Earliest allowed time (`HH:mm`) in `input` mode. */
     min = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "min" }] : /* istanbul ignore next */ []));
+    /** Latest allowed time (`HH:mm`) in `input` mode. */
     max = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "max" }] : /* istanbul ignore next */ []));
+    /** Whether to include seconds in `input` mode. */
     seconds = input(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "seconds" }] : /* istanbul ignore next */ []));
+    /** Whether the field is disabled. Two-way bindable with `[(disabled)]`. */
     disabled = model(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "disabled" }] : /* istanbul ignore next */ []));
     /** `select` renders hour + minute dropdowns instead of a native time input. */
@@ -9459,6 +9911,7 @@ class BuiTimeField {
     /** Minute step used in `select` mode. */
     minuteStep = input(5, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "minuteStep" }] : /* istanbul ignore next */ []));
+    /** Accessible label for the field. */
     ariaLabel = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "ariaLabel" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -9609,10 +10062,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** A group of toggle buttons (single or multiple selection). Use `button[buiToggleGroupItem]`. */
 class BuiToggleGroup {
+    /** Selection mode: single value or an array of values. */
     type = input('single', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "type" }] : /* istanbul ignore next */ []));
+    /** Selected value(s). Two-way bindable with `[(value)]`. */
     value = model(null, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "value" }] : /* istanbul ignore next */ []));
+    /** Layout direction of the group. */
     orientation = input('horizontal', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "orientation" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -9658,8 +10114,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** A single item within a `bui-toggle-group`. */
 class BuiToggleGroupItem {
+    /** Value this item contributes to the parent group's selection. */
     value = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "value" }] : /* istanbul ignore next */ []));
+    /** Whether this item is disabled. */
     disabled = input(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "disabled" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -9692,12 +10150,16 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 const noop$7 = () => { };
 /** A free-text tags input: type and press Enter (or comma) to add chips; Backspace removes. */
 class BuiTagsInput {
+    /** Current tags. Two-way bindable with `[(tags)]`. */
     tags = model([], /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "tags" }] : /* istanbul ignore next */ []));
+    /** Placeholder text shown in the entry field. */
     placeholder = input('Add tag…', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "placeholder" }] : /* istanbul ignore next */ []));
+    /** Maximum number of tags allowed, or `null` for no limit. */
     max = input(null, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "max" }] : /* istanbul ignore next */ []));
+    /** Whether the input is disabled. Two-way bindable with `[(disabled)]`. */
     disabled = model(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "disabled" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -9822,10 +10284,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** Click-to-edit inline text: shows a value, swaps to an input on click. Enter commits, Escape cancels. */
 class BuiEditable {
+    /** Current text. Two-way bindable with `[(value)]`. */
     value = model('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "value" }] : /* istanbul ignore next */ []));
+    /** Text shown when the value is empty. */
     placeholder = input('Empty', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "placeholder" }] : /* istanbul ignore next */ []));
+    /** Noun used in the field's accessible label. */
     label = input('value', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "label" }] : /* istanbul ignore next */ []));
     /** Edit in a multi-line textarea instead of a single-line input. */
@@ -9952,10 +10417,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** A floating action button that expands to a stack of actions. Closes on Escape / outside click. */
 class BuiSpeedDial {
+    /** Actions revealed when the dial expands. */
     actions = input([], /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "actions" }] : /* istanbul ignore next */ []));
+    /** Direction the action stack expands relative to the trigger button. */
     direction = input('up', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "direction" }] : /* istanbul ignore next */ []));
+    /** Accessible label for the trigger button. */
     label = input('Open actions', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "label" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -10086,18 +10554,25 @@ const CIRC = 2 * Math.PI * RADIUS;
 const ARC = CIRC * 0.75;
 /** A rotary dial input (role="slider"). Drag, scroll, or use the keyboard. 270° sweep. */
 class BuiKnob {
+    /** Current value. Two-way bindable with `[(value)]`. */
     value = model(50, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "value" }] : /* istanbul ignore next */ []));
+    /** Minimum value at the start of the dial's sweep. */
     min = input(0, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "min" }] : /* istanbul ignore next */ []));
+    /** Maximum value at the end of the dial's sweep. */
     max = input(100, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "max" }] : /* istanbul ignore next */ []));
+    /** Increment applied per arrow key, scroll or drag snap. */
     step = input(1, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "step" }] : /* istanbul ignore next */ []));
+    /** Size preset controlling the knob's diameter and text size. */
     size = input('default', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "size" }] : /* istanbul ignore next */ []));
+    /** Accessible label announced for the slider. */
     label = input('Value', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "label" }] : /* istanbul ignore next */ []));
+    /** Whether the knob is disabled. Two-way bindable with `[(disabled)]`. */
     disabled = model(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "disabled" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -10342,16 +10817,22 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** A lazy image with a blurred placeholder / skeleton and a graceful error state. */
 class BuiImage {
+    /** Source URL of the full image to load. */
     src = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "src" }] : /* istanbul ignore next */ []));
+    /** Alternative text for the image. */
     alt = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "alt" }] : /* istanbul ignore next */ []));
+    /** CSS `aspect-ratio` reserved for the image (e.g. `16 / 9`). */
     ratio = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "ratio" }] : /* istanbul ignore next */ []));
+    /** URL of a low-res image shown blurred while the full image loads. */
     placeholder = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "placeholder" }] : /* istanbul ignore next */ []));
+    /** Tailwind class controlling corner rounding. */
     rounded = input('rounded-lg', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "rounded" }] : /* istanbul ignore next */ []));
+    /** How the image fills its box: `cover` crops, `contain` letterboxes. */
     fit = input('cover', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "fit" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -10457,10 +10938,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** A collapsible "reasoning" / chain-of-thought disclosure. */
 class BuiReasoning {
+    /** Whether the disclosure is expanded. Two-way bindable with `[(open)]`. */
     open = model(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "open" }] : /* istanbul ignore next */ []));
+    /** Trigger label shown when no `duration` is set. */
     label = input('Reasoning', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "label" }] : /* istanbul ignore next */ []));
+    /** When set, the trigger reads "Thought for {duration}" instead of `label`. */
     duration = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "duration" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -10547,14 +11031,19 @@ const STATUS = {
 };
 /** An AI tool-call card with a status indicator and collapsible arguments / result. */
 class BuiToolCall {
+    /** Name of the invoked tool, shown as inline code in the header. */
     name = input('tool', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "name" }] : /* istanbul ignore next */ []));
+    /** Execution status; drives the colored status dot and label. */
     status = input('success', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "status" }] : /* istanbul ignore next */ []));
+    /** Tool arguments shown in the collapsible body when present. */
     args = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "args" }] : /* istanbul ignore next */ []));
+    /** Tool result shown in the collapsible body when present. */
     result = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "result" }] : /* istanbul ignore next */ []));
+    /** Whether the arguments/result panel is expanded. Two-way bindable with `[(open)]`. */
     open = model(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "open" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -10656,6 +11145,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** A scrollable conversation log (`role="log"`). Use `bui-chat-message` for bubbles. */
 class BuiChat {
+    /** Accessible label announced for the conversation log region. */
     ariaLabel = input('Conversation', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "ariaLabel" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -10681,14 +11171,19 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** A chat bubble. `role="user"` aligns end with a primary bubble; otherwise assistant-styled. */
 class BuiChatMessage {
+    /** Author role; `'user'` aligns the bubble to the end with primary styling, else assistant-styled. */
     role = input('assistant', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "role" }] : /* istanbul ignore next */ []));
+    /** Display name shown above the bubble; also seeds the fallback initials avatar. */
     name = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "name" }] : /* istanbul ignore next */ []));
+    /** Optional timestamp text shown beside the name. */
     time = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "time" }] : /* istanbul ignore next */ []));
+    /** Avatar image URL; when empty, initials (or an emoji) are shown instead. */
     avatar = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "avatar" }] : /* istanbul ignore next */ []));
+    /** When true, shows an animated typing indicator instead of the message content. */
     typing = input(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "typing" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -10802,10 +11297,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 const PALETTE$1 = ['#6366f1', '#ec4899', '#f59e0b', '#10b981', '#3b82f6', '#ef4444'];
 /** A celebratory particle burst. Project a trigger (or use the default button) to fire it. */
 class BuiConfetti {
+    /** Number of particles emitted per burst. */
     count = input(80, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "count" }] : /* istanbul ignore next */ []));
+    /** Horizontal spread factor of the burst. */
     spread = input(70, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "spread" }] : /* istanbul ignore next */ []));
+    /** Particle colours; defaults to the built-in palette. */
     colors = input(null, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "colors" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -10890,8 +11388,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** A step indicator. The `value` (1-based) marks the active step. Use `li[buiStepperItem]`. */
 class BuiStepper {
+    /** The active step as a 1-based index; items at lower values are marked completed. */
     value = input(1, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "value" }] : /* istanbul ignore next */ []));
+    /** Layout direction of the steps, horizontal or vertical. */
     orientation = input('horizontal', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "orientation" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -10936,6 +11436,7 @@ const INDICATOR = {
 };
 /** A single step within a `bui-stepper`. Resolves completed/active/inactive from the parent. */
 class BuiStepperItem {
+    /** This item's 1-based position; compared against the parent's value to derive its state. */
     step = input(1, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "step" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -11031,17 +11532,22 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 const noop$5 = () => { };
 /** A one-time-password input: a row of single-character boxes with focus management + paste. */
 class BuiInputOtp {
+    /** Current code. Two-way bindable with `[(value)]`. */
     value = model('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "value" }] : /* istanbul ignore next */ []));
+    /** Number of character boxes (length of the code). */
     maxlength = input(6, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "maxlength" }] : /* istanbul ignore next */ []));
+    /** Whether the input is disabled. Two-way bindable with `[(disabled)]`. */
     disabled = model(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "disabled" }] : /* istanbul ignore next */ []));
+    /** Whether to allow letters as well as digits. */
     alphanumeric = input(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "alphanumeric" }] : /* istanbul ignore next */ []));
     /** Insert a visual separator after every N boxes (0 = none). */
     groupSize = input(0, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "groupSize" }] : /* istanbul ignore next */ []));
+    /** Base accessible label; each box appends its position. */
     ariaLabel = input('One-time password', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "ariaLabel" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -11183,17 +11689,30 @@ const COUNTRIES = [
 ];
 /** A phone number field with a country-code selector. */
 class BuiPhoneInput {
+    /** Entered phone number. Two-way bindable with `[(value)]`. */
     value = model('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "value" }] : /* istanbul ignore next */ []));
+    /** Selected country code. Two-way bindable with `[(country)]`. */
     country = model('US', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "country" }] : /* istanbul ignore next */ []));
+    /** Name attribute applied to the number input for form submission. */
     name = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "name" }] : /* istanbul ignore next */ []));
+    /** Id attribute applied to the number input. */
     id = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "id" }] : /* istanbul ignore next */ []));
+    /** Placeholder text for the number input. */
     placeholder = input('Phone number', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "placeholder" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
+    /** Accessible label override for the country selector. */
+    countryLabel = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "countryLabel" }] : /* istanbul ignore next */ []));
+    /** Accessible label override for the number input. */
+    numberLabel = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "numberLabel" }] : /* istanbul ignore next */ []));
+    countryText = buiLabel('phoneInputCountry', this.countryLabel);
+    numberText = buiLabel('phoneInputNumber', this.numberLabel);
     countries = COUNTRIES;
     computedClass = computed(() => cn('flex w-full items-stretch', this.userClass()), /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "computedClass" }] : /* istanbul ignore next */ []));
@@ -11204,11 +11723,11 @@ class BuiPhoneInput {
         this.value.set(event.target.value);
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.2", ngImport: i0, type: BuiPhoneInput, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.0.2", type: BuiPhoneInput, isStandalone: true, selector: "bui-phone-input", inputs: { value: { classPropertyName: "value", publicName: "value", isSignal: true, isRequired: false, transformFunction: null }, country: { classPropertyName: "country", publicName: "country", isSignal: true, isRequired: false, transformFunction: null }, name: { classPropertyName: "name", publicName: "name", isSignal: true, isRequired: false, transformFunction: null }, id: { classPropertyName: "id", publicName: "id", isSignal: true, isRequired: false, transformFunction: null }, placeholder: { classPropertyName: "placeholder", publicName: "placeholder", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { value: "valueChange", country: "countryChange" }, host: { attributes: { "data-slot": "phone-input" }, properties: { "class": "computedClass()" } }, ngImport: i0, template: `
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.0.2", type: BuiPhoneInput, isStandalone: true, selector: "bui-phone-input", inputs: { value: { classPropertyName: "value", publicName: "value", isSignal: true, isRequired: false, transformFunction: null }, country: { classPropertyName: "country", publicName: "country", isSignal: true, isRequired: false, transformFunction: null }, name: { classPropertyName: "name", publicName: "name", isSignal: true, isRequired: false, transformFunction: null }, id: { classPropertyName: "id", publicName: "id", isSignal: true, isRequired: false, transformFunction: null }, placeholder: { classPropertyName: "placeholder", publicName: "placeholder", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null }, countryLabel: { classPropertyName: "countryLabel", publicName: "countryLabel", isSignal: true, isRequired: false, transformFunction: null }, numberLabel: { classPropertyName: "numberLabel", publicName: "numberLabel", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { value: "valueChange", country: "countryChange" }, host: { attributes: { "data-slot": "phone-input" }, properties: { "class": "computedClass()" } }, ngImport: i0, template: `
     <select
       [value]="country()"
       class="h-9 rounded-md rounded-r-none border border-r-0 border-input bg-background ps-2 pe-1 text-sm outline-none focus-visible:z-10 focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/50"
-      aria-label="Country code"
+      [attr.aria-label]="countryText()"
       (change)="onCountry($event)"
     >
       @for (option of countries; track option.code) {
@@ -11221,7 +11740,7 @@ class BuiPhoneInput {
       [placeholder]="placeholder()"
       [attr.name]="name() || null"
       [attr.id]="id() || null"
-      aria-label="Phone number"
+      [attr.aria-label]="numberText()"
       class="h-9 w-full min-w-0 rounded-md rounded-l-none border border-input bg-transparent px-3 text-sm shadow-xs outline-none focus-visible:z-10 focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/50"
       (input)="onNumber($event)"
     />
@@ -11236,7 +11755,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
     <select
       [value]="country()"
       class="h-9 rounded-md rounded-r-none border border-r-0 border-input bg-background ps-2 pe-1 text-sm outline-none focus-visible:z-10 focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/50"
-      aria-label="Country code"
+      [attr.aria-label]="countryText()"
       (change)="onCountry($event)"
     >
       @for (option of countries; track option.code) {
@@ -11249,28 +11768,42 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
       [placeholder]="placeholder()"
       [attr.name]="name() || null"
       [attr.id]="id() || null"
-      aria-label="Phone number"
+      [attr.aria-label]="numberText()"
       class="h-9 w-full min-w-0 rounded-md rounded-l-none border border-input bg-transparent px-3 text-sm shadow-xs outline-none focus-visible:z-10 focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/50"
       (input)="onNumber($event)"
     />
   `,
                 }]
-        }], propDecorators: { value: [{ type: i0.Input, args: [{ isSignal: true, alias: "value", required: false }] }, { type: i0.Output, args: ["valueChange"] }], country: [{ type: i0.Input, args: [{ isSignal: true, alias: "country", required: false }] }, { type: i0.Output, args: ["countryChange"] }], name: [{ type: i0.Input, args: [{ isSignal: true, alias: "name", required: false }] }], id: [{ type: i0.Input, args: [{ isSignal: true, alias: "id", required: false }] }], placeholder: [{ type: i0.Input, args: [{ isSignal: true, alias: "placeholder", required: false }] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }] } });
+        }], propDecorators: { value: [{ type: i0.Input, args: [{ isSignal: true, alias: "value", required: false }] }, { type: i0.Output, args: ["valueChange"] }], country: [{ type: i0.Input, args: [{ isSignal: true, alias: "country", required: false }] }, { type: i0.Output, args: ["countryChange"] }], name: [{ type: i0.Input, args: [{ isSignal: true, alias: "name", required: false }] }], id: [{ type: i0.Input, args: [{ isSignal: true, alias: "id", required: false }] }], placeholder: [{ type: i0.Input, args: [{ isSignal: true, alias: "placeholder", required: false }] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }], countryLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "countryLabel", required: false }] }], numberLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "numberLabel", required: false }] }] } });
 
 /** A chat composer: an autosizing textarea with a send button. Emits `submitted` on send. */
 class BuiPromptInput {
+    /** Current textarea content. Two-way bindable with `[(value)]`. */
     value = model('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "value" }] : /* istanbul ignore next */ []));
+    /** Placeholder text shown when the textarea is empty. */
     placeholder = input('Send a message…', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "placeholder" }] : /* istanbul ignore next */ []));
+    /** Whether to show the attachment button. */
     attachable = input(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "attachable" }] : /* istanbul ignore next */ []));
+    /** Disables the textarea and send button. */
     disabled = input(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "disabled" }] : /* istanbul ignore next */ []));
+    /** Accessible label for the message textarea. */
     ariaLabel = input('Message', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "ariaLabel" }] : /* istanbul ignore next */ []));
+    /** Overrides the localized accessible label for the attachment button. */
+    attachLabel = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "attachLabel" }] : /* istanbul ignore next */ []));
+    /** Overrides the localized accessible label for the send button. */
+    sendLabel = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "sendLabel" }] : /* istanbul ignore next */ []));
+    /** Emitted with the trimmed message text when the user sends. */
     submitted = output();
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
+    attachText = buiLabel('promptInputAttach', this.attachLabel);
+    sendText = buiLabel('promptInputSend', this.sendLabel);
     ta = viewChild('ta', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "ta" }] : /* istanbul ignore next */ []));
     computedClass = computed(() => cn('flex flex-col rounded-xl border border-input bg-transparent focus-within:border-ring focus-within:ring-[3px] focus-within:ring-ring/50', this.userClass()), /* @ts-ignore */
@@ -11309,7 +11842,7 @@ class BuiPromptInput {
         element.style.height = `${element.scrollHeight}px`;
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.2", ngImport: i0, type: BuiPromptInput, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.0.2", type: BuiPromptInput, isStandalone: true, selector: "bui-prompt-input", inputs: { value: { classPropertyName: "value", publicName: "value", isSignal: true, isRequired: false, transformFunction: null }, placeholder: { classPropertyName: "placeholder", publicName: "placeholder", isSignal: true, isRequired: false, transformFunction: null }, attachable: { classPropertyName: "attachable", publicName: "attachable", isSignal: true, isRequired: false, transformFunction: null }, disabled: { classPropertyName: "disabled", publicName: "disabled", isSignal: true, isRequired: false, transformFunction: null }, ariaLabel: { classPropertyName: "ariaLabel", publicName: "ariaLabel", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { value: "valueChange", submitted: "submitted" }, host: { attributes: { "data-slot": "prompt-input" }, properties: { "class": "computedClass()" } }, viewQueries: [{ propertyName: "ta", first: true, predicate: ["ta"], descendants: true, isSignal: true }], ngImport: i0, template: `
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.0.2", type: BuiPromptInput, isStandalone: true, selector: "bui-prompt-input", inputs: { value: { classPropertyName: "value", publicName: "value", isSignal: true, isRequired: false, transformFunction: null }, placeholder: { classPropertyName: "placeholder", publicName: "placeholder", isSignal: true, isRequired: false, transformFunction: null }, attachable: { classPropertyName: "attachable", publicName: "attachable", isSignal: true, isRequired: false, transformFunction: null }, disabled: { classPropertyName: "disabled", publicName: "disabled", isSignal: true, isRequired: false, transformFunction: null }, ariaLabel: { classPropertyName: "ariaLabel", publicName: "ariaLabel", isSignal: true, isRequired: false, transformFunction: null }, attachLabel: { classPropertyName: "attachLabel", publicName: "attachLabel", isSignal: true, isRequired: false, transformFunction: null }, sendLabel: { classPropertyName: "sendLabel", publicName: "sendLabel", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { value: "valueChange", submitted: "submitted" }, host: { attributes: { "data-slot": "prompt-input" }, properties: { "class": "computedClass()" } }, viewQueries: [{ propertyName: "ta", first: true, predicate: ["ta"], descendants: true, isSignal: true }], ngImport: i0, template: `
     <textarea
       #ta
       rows="1"
@@ -11325,7 +11858,7 @@ class BuiPromptInput {
       @if (attachable()) {
         <button
           type="button"
-          aria-label="Attach file"
+          [attr.aria-label]="attachText()"
           class="inline-flex size-8 items-center justify-center text-muted-foreground hover:text-foreground"
         >
           <svg
@@ -11348,7 +11881,7 @@ class BuiPromptInput {
         type="button"
         class="ml-auto inline-flex size-8 items-center justify-center rounded-md bg-primary text-primary-foreground disabled:opacity-50"
         [disabled]="disabled() || value().trim() === ''"
-        aria-label="Send"
+        [attr.aria-label]="sendText()"
         (click)="send()"
       >
         <svg
@@ -11389,7 +11922,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
       @if (attachable()) {
         <button
           type="button"
-          aria-label="Attach file"
+          [attr.aria-label]="attachText()"
           class="inline-flex size-8 items-center justify-center text-muted-foreground hover:text-foreground"
         >
           <svg
@@ -11412,7 +11945,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
         type="button"
         class="ml-auto inline-flex size-8 items-center justify-center rounded-md bg-primary text-primary-foreground disabled:opacity-50"
         [disabled]="disabled() || value().trim() === ''"
-        aria-label="Send"
+        [attr.aria-label]="sendText()"
         (click)="send()"
       >
         <svg
@@ -11432,10 +11965,11 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
     </div>
   `,
                 }]
-        }], ctorParameters: () => [], propDecorators: { value: [{ type: i0.Input, args: [{ isSignal: true, alias: "value", required: false }] }, { type: i0.Output, args: ["valueChange"] }], placeholder: [{ type: i0.Input, args: [{ isSignal: true, alias: "placeholder", required: false }] }], attachable: [{ type: i0.Input, args: [{ isSignal: true, alias: "attachable", required: false }] }], disabled: [{ type: i0.Input, args: [{ isSignal: true, alias: "disabled", required: false }] }], ariaLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "ariaLabel", required: false }] }], submitted: [{ type: i0.Output, args: ["submitted"] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }], ta: [{ type: i0.ViewChild, args: ['ta', { isSignal: true }] }] } });
+        }], ctorParameters: () => [], propDecorators: { value: [{ type: i0.Input, args: [{ isSignal: true, alias: "value", required: false }] }, { type: i0.Output, args: ["valueChange"] }], placeholder: [{ type: i0.Input, args: [{ isSignal: true, alias: "placeholder", required: false }] }], attachable: [{ type: i0.Input, args: [{ isSignal: true, alias: "attachable", required: false }] }], disabled: [{ type: i0.Input, args: [{ isSignal: true, alias: "disabled", required: false }] }], ariaLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "ariaLabel", required: false }] }], attachLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "attachLabel", required: false }] }], sendLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "sendLabel", required: false }] }], submitted: [{ type: i0.Output, args: ["submitted"] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }], ta: [{ type: i0.ViewChild, args: ['ta', { isSignal: true }] }] } });
 
 /** A contribution-style heatmap grid (7 rows). Pass `data` or get a deterministic demo. */
 class BuiHeatmap {
+    /** Per-cell counts filled column-first; empty yields a demo dataset. */
     data = input([], /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "data" }] : /* istanbul ignore next */ []));
     /** Smaller cells + tighter gaps. */
@@ -11512,12 +12046,16 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** An inline citation marker that reveals a source popover on hover / focus / click. */
 class BuiCitation {
+    /** Citation number shown in the inline `[n]` marker. */
     index = input(1, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "index" }] : /* istanbul ignore next */ []));
+    /** Source title shown at the top of the popover. */
     title = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "title" }] : /* istanbul ignore next */ []));
+    /** Source URL; its hostname is derived and shown in the popover. */
     url = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "url" }] : /* istanbul ignore next */ []));
+    /** Short excerpt from the source shown in the popover. */
     snippet = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "snippet" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -11639,8 +12177,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** A two-panel resizable group. Hosts the shared size; the handle drags it. */
 class BuiResizablePanelGroup {
+    /** Layout axis the panels are arranged and resized along. */
     direction = input('horizontal', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "direction" }] : /* istanbul ignore next */ []));
+    /** Size of the primary panel as a percentage (10-90). Two-way bindable with `[(size)]`. */
     size = model(50, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "size" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -11690,6 +12230,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** A panel inside a `bui-resizable-panel-group`. Mark one `primary` to make it the sized panel. */
 class BuiResizablePanel {
+    /** Whether this is the sized panel driven by the group's `size`; the other panel flexes. */
     primary = input(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "primary" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -11713,9 +12254,14 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** The draggable divider between two resizable panels. */
 class BuiResizableHandle {
+    /** Whether to render a visible grip indicator on the divider. */
     withHandle = input(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "withHandle" }] : /* istanbul ignore next */ []));
+    /** Accessible label for the handle; falls back to a localized default. */
+    ariaLabel = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "ariaLabel" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
+    ariaLabelText = buiLabel('resizableHandle', this.ariaLabel);
     group = inject(BuiResizablePanelGroup);
     roundedSize = computed(() => Math.round(this.group.size()), /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "roundedSize" }] : /* istanbul ignore next */ []));
@@ -11735,7 +12281,7 @@ class BuiResizableHandle {
         }
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.2", ngImport: i0, type: BuiResizableHandle, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.0.2", type: BuiResizableHandle, isStandalone: true, selector: "bui-resizable-handle", inputs: { withHandle: { classPropertyName: "withHandle", publicName: "withHandle", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null } }, host: { attributes: { "data-slot": "resizable-handle", "role": "separator", "tabindex": "0", "aria-label": "Resize panel", "aria-valuemin": "10", "aria-valuemax": "90" }, listeners: { "pointerdown": "group.startDrag()", "keydown": "onKeydown($event)" }, properties: { "attr.aria-orientation": "group.direction() === 'horizontal' ? 'vertical' : 'horizontal'", "attr.aria-valuenow": "roundedSize()", "class": "computedClass()" } }, ngImport: i0, template: `
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.0.2", type: BuiResizableHandle, isStandalone: true, selector: "bui-resizable-handle", inputs: { withHandle: { classPropertyName: "withHandle", publicName: "withHandle", isSignal: true, isRequired: false, transformFunction: null }, ariaLabel: { classPropertyName: "ariaLabel", publicName: "ariaLabel", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null } }, host: { attributes: { "data-slot": "resizable-handle", "role": "separator", "tabindex": "0", "aria-valuemin": "10", "aria-valuemax": "90" }, listeners: { "pointerdown": "group.startDrag()", "keydown": "onKeydown($event)" }, properties: { "attr.aria-label": "ariaLabelText()", "attr.aria-orientation": "group.direction() === 'horizontal' ? 'vertical' : 'horizontal'", "attr.aria-valuenow": "roundedSize()", "class": "computedClass()" } }, ngImport: i0, template: `
     @if (withHandle()) {
       <span
         class="absolute top-1/2 left-1/2 flex h-4 w-1 -translate-x-1/2 -translate-y-1/2 items-center justify-center rounded-full bg-border"
@@ -11751,7 +12297,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
                         'data-slot': 'resizable-handle',
                         role: 'separator',
                         tabindex: '0',
-                        'aria-label': 'Resize panel',
+                        '[attr.aria-label]': 'ariaLabelText()',
                         'aria-valuemin': '10',
                         'aria-valuemax': '90',
                         '[attr.aria-orientation]': "group.direction() === 'horizontal' ? 'vertical' : 'horizontal'",
@@ -11768,27 +12314,39 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
     }
   `,
                 }]
-        }], propDecorators: { withHandle: [{ type: i0.Input, args: [{ isSignal: true, alias: "withHandle", required: false }] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }] } });
+        }], propDecorators: { withHandle: [{ type: i0.Input, args: [{ isSignal: true, alias: "withHandle", required: false }] }], ariaLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "ariaLabel", required: false }] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }] } });
 
 /** A styled HTML5 video with a poster + play-button facade. */
 class BuiVideo {
+    /** Video source URL for the underlying `<video>` element. */
     src = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "src" }] : /* istanbul ignore next */ []));
+    /** Poster image URL shown before playback starts. */
     poster = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "poster" }] : /* istanbul ignore next */ []));
+    /** Aspect ratio: `video` (16/9), `square` (1/1), or any CSS ratio. */
     aspect = input('video', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "aspect" }] : /* istanbul ignore next */ []));
+    /** Whether to show native controls once playback has started. */
     controls = input(true, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "controls" }] : /* istanbul ignore next */ []));
+    /** Whether to start playing automatically (hides the play facade). */
     autoplay = input(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "autoplay" }] : /* istanbul ignore next */ []));
+    /** Whether the video loops when it reaches the end. */
     loop = input(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "loop" }] : /* istanbul ignore next */ []));
+    /** Whether the video starts muted. */
     muted = input(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "muted" }] : /* istanbul ignore next */ []));
+    /** Tailwind border-radius utility applied to the container. */
     rounded = input('rounded-xl', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "rounded" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
+    /** Accessible label override for the play-button facade. */
+    playLabel = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "playLabel" }] : /* istanbul ignore next */ []));
+    playText = buiLabel('videoPlay', this.playLabel);
     v = viewChild('v', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "v" }] : /* istanbul ignore next */ []));
     started = signal(false, /* @ts-ignore */
@@ -11821,7 +12379,7 @@ class BuiVideo {
         }
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.2", ngImport: i0, type: BuiVideo, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.0.2", type: BuiVideo, isStandalone: true, selector: "bui-video", inputs: { src: { classPropertyName: "src", publicName: "src", isSignal: true, isRequired: false, transformFunction: null }, poster: { classPropertyName: "poster", publicName: "poster", isSignal: true, isRequired: false, transformFunction: null }, aspect: { classPropertyName: "aspect", publicName: "aspect", isSignal: true, isRequired: false, transformFunction: null }, controls: { classPropertyName: "controls", publicName: "controls", isSignal: true, isRequired: false, transformFunction: null }, autoplay: { classPropertyName: "autoplay", publicName: "autoplay", isSignal: true, isRequired: false, transformFunction: null }, loop: { classPropertyName: "loop", publicName: "loop", isSignal: true, isRequired: false, transformFunction: null }, muted: { classPropertyName: "muted", publicName: "muted", isSignal: true, isRequired: false, transformFunction: null }, rounded: { classPropertyName: "rounded", publicName: "rounded", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null } }, host: { attributes: { "data-slot": "video" }, properties: { "class": "computedClass()", "style.aspect-ratio": "ratioValue()" } }, viewQueries: [{ propertyName: "v", first: true, predicate: ["v"], descendants: true, isSignal: true }], ngImport: i0, template: `
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.0.2", type: BuiVideo, isStandalone: true, selector: "bui-video", inputs: { src: { classPropertyName: "src", publicName: "src", isSignal: true, isRequired: false, transformFunction: null }, poster: { classPropertyName: "poster", publicName: "poster", isSignal: true, isRequired: false, transformFunction: null }, aspect: { classPropertyName: "aspect", publicName: "aspect", isSignal: true, isRequired: false, transformFunction: null }, controls: { classPropertyName: "controls", publicName: "controls", isSignal: true, isRequired: false, transformFunction: null }, autoplay: { classPropertyName: "autoplay", publicName: "autoplay", isSignal: true, isRequired: false, transformFunction: null }, loop: { classPropertyName: "loop", publicName: "loop", isSignal: true, isRequired: false, transformFunction: null }, muted: { classPropertyName: "muted", publicName: "muted", isSignal: true, isRequired: false, transformFunction: null }, rounded: { classPropertyName: "rounded", publicName: "rounded", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null }, playLabel: { classPropertyName: "playLabel", publicName: "playLabel", isSignal: true, isRequired: false, transformFunction: null } }, host: { attributes: { "data-slot": "video" }, properties: { "class": "computedClass()", "style.aspect-ratio": "ratioValue()" } }, viewQueries: [{ propertyName: "v", first: true, predicate: ["v"], descendants: true, isSignal: true }], ngImport: i0, template: `
     <video
       #v
       [src]="src() || null"
@@ -11840,7 +12398,7 @@ class BuiVideo {
       <button
         type="button"
         class="absolute inset-0 flex items-center justify-center bg-black/30 transition-colors hover:bg-black/40"
-        aria-label="Play video"
+        [attr.aria-label]="playText()"
         (click)="play()"
       >
         <span
@@ -11882,7 +12440,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
       <button
         type="button"
         class="absolute inset-0 flex items-center justify-center bg-black/30 transition-colors hover:bg-black/40"
-        aria-label="Play video"
+        [attr.aria-label]="playText()"
         (click)="play()"
       >
         <span
@@ -11896,7 +12454,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
     }
   `,
                 }]
-        }], propDecorators: { src: [{ type: i0.Input, args: [{ isSignal: true, alias: "src", required: false }] }], poster: [{ type: i0.Input, args: [{ isSignal: true, alias: "poster", required: false }] }], aspect: [{ type: i0.Input, args: [{ isSignal: true, alias: "aspect", required: false }] }], controls: [{ type: i0.Input, args: [{ isSignal: true, alias: "controls", required: false }] }], autoplay: [{ type: i0.Input, args: [{ isSignal: true, alias: "autoplay", required: false }] }], loop: [{ type: i0.Input, args: [{ isSignal: true, alias: "loop", required: false }] }], muted: [{ type: i0.Input, args: [{ isSignal: true, alias: "muted", required: false }] }], rounded: [{ type: i0.Input, args: [{ isSignal: true, alias: "rounded", required: false }] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }], v: [{ type: i0.ViewChild, args: ['v', { isSignal: true }] }] } });
+        }], propDecorators: { src: [{ type: i0.Input, args: [{ isSignal: true, alias: "src", required: false }] }], poster: [{ type: i0.Input, args: [{ isSignal: true, alias: "poster", required: false }] }], aspect: [{ type: i0.Input, args: [{ isSignal: true, alias: "aspect", required: false }] }], controls: [{ type: i0.Input, args: [{ isSignal: true, alias: "controls", required: false }] }], autoplay: [{ type: i0.Input, args: [{ isSignal: true, alias: "autoplay", required: false }] }], loop: [{ type: i0.Input, args: [{ isSignal: true, alias: "loop", required: false }] }], muted: [{ type: i0.Input, args: [{ isSignal: true, alias: "muted", required: false }] }], rounded: [{ type: i0.Input, args: [{ isSignal: true, alias: "rounded", required: false }] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }], playLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "playLabel", required: false }] }], v: [{ type: i0.ViewChild, args: ['v', { isSignal: true }] }] } });
 
 const DEFAULT_SWATCHES = [
     '#ef4444',
@@ -11912,13 +12470,24 @@ const DEFAULT_SWATCHES = [
 ];
 /** A colour picker: a native colour well, a hex field, and a swatch palette. */
 class BuiColorPicker {
+    /** Selected color as a hex string. Two-way bindable with `[(value)]`. */
     value = model('#6366f1', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "value" }] : /* istanbul ignore next */ []));
+    /** Custom swatch palette; falls back to a built-in set when null. */
     swatches = input(null, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "swatches" }] : /* istanbul ignore next */ []));
+    /** Whether the picker is disabled. */
     disabled = input(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "disabled" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
+    /** Accessible label for the native color well. */
+    pickLabel = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "pickLabel" }] : /* istanbul ignore next */ []));
+    /** Accessible label for the hex text field. */
+    hexLabel = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "hexLabel" }] : /* istanbul ignore next */ []));
+    pickText = buiLabel('colorPickerPick', this.pickLabel);
+    hexText = buiLabel('colorPickerHex', this.hexLabel);
     palette = computed(() => this.swatches() ?? DEFAULT_SWATCHES, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "palette" }] : /* istanbul ignore next */ []));
     computedClass = computed(() => cn('inline-block', this.userClass()), /* @ts-ignore */
@@ -11930,7 +12499,7 @@ class BuiColorPicker {
         this.value.set(event.target.value);
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.2", ngImport: i0, type: BuiColorPicker, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.0.2", type: BuiColorPicker, isStandalone: true, selector: "bui-color-picker", inputs: { value: { classPropertyName: "value", publicName: "value", isSignal: true, isRequired: false, transformFunction: null }, swatches: { classPropertyName: "swatches", publicName: "swatches", isSignal: true, isRequired: false, transformFunction: null }, disabled: { classPropertyName: "disabled", publicName: "disabled", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { value: "valueChange" }, host: { attributes: { "data-slot": "color-picker" }, properties: { "class": "computedClass()" } }, ngImport: i0, template: `
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.0.2", type: BuiColorPicker, isStandalone: true, selector: "bui-color-picker", inputs: { value: { classPropertyName: "value", publicName: "value", isSignal: true, isRequired: false, transformFunction: null }, swatches: { classPropertyName: "swatches", publicName: "swatches", isSignal: true, isRequired: false, transformFunction: null }, disabled: { classPropertyName: "disabled", publicName: "disabled", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null }, pickLabel: { classPropertyName: "pickLabel", publicName: "pickLabel", isSignal: true, isRequired: false, transformFunction: null }, hexLabel: { classPropertyName: "hexLabel", publicName: "hexLabel", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { value: "valueChange" }, host: { attributes: { "data-slot": "color-picker" }, properties: { "class": "computedClass()" } }, ngImport: i0, template: `
     <div class="flex items-center gap-2">
       <label
         class="relative size-9 shrink-0 overflow-hidden rounded-md border border-input"
@@ -11941,7 +12510,7 @@ class BuiColorPicker {
           [value]="value()"
           [disabled]="disabled()"
           class="absolute inset-0 size-full cursor-pointer opacity-0"
-          aria-label="Pick a color"
+          [attr.aria-label]="pickText()"
           (input)="onPick($event)"
         />
       </label>
@@ -11950,7 +12519,7 @@ class BuiColorPicker {
         [value]="value()"
         [disabled]="disabled()"
         class="h-9 w-28 rounded-md border border-input bg-transparent px-2 font-mono text-sm uppercase outline-none focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/50"
-        aria-label="Color hex value"
+        [attr.aria-label]="hexText()"
         (input)="onText($event)"
       />
     </div>
@@ -11984,7 +12553,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
           [value]="value()"
           [disabled]="disabled()"
           class="absolute inset-0 size-full cursor-pointer opacity-0"
-          aria-label="Pick a color"
+          [attr.aria-label]="pickText()"
           (input)="onPick($event)"
         />
       </label>
@@ -11993,7 +12562,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
         [value]="value()"
         [disabled]="disabled()"
         class="h-9 w-28 rounded-md border border-input bg-transparent px-2 font-mono text-sm uppercase outline-none focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/50"
-        aria-label="Color hex value"
+        [attr.aria-label]="hexText()"
         (input)="onText($event)"
       />
     </div>
@@ -12011,18 +12580,26 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
     </div>
   `,
                 }]
-        }], propDecorators: { value: [{ type: i0.Input, args: [{ isSignal: true, alias: "value", required: false }] }, { type: i0.Output, args: ["valueChange"] }], swatches: [{ type: i0.Input, args: [{ isSignal: true, alias: "swatches", required: false }] }], disabled: [{ type: i0.Input, args: [{ isSignal: true, alias: "disabled", required: false }] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }] } });
+        }], propDecorators: { value: [{ type: i0.Input, args: [{ isSignal: true, alias: "value", required: false }] }, { type: i0.Output, args: ["valueChange"] }], swatches: [{ type: i0.Input, args: [{ isSignal: true, alias: "swatches", required: false }] }], disabled: [{ type: i0.Input, args: [{ isSignal: true, alias: "disabled", required: false }] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }], pickLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "pickLabel", required: false }] }], hexLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "hexLabel", required: false }] }] } });
 
 /** A GDPR cookie banner. Persists the choice in localStorage (skipped in `demo` mode). */
 class BuiCookieConsent {
+    /** Consent message shown to the user. */
     message = input('We use cookies to enhance your experience.', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "message" }] : /* istanbul ignore next */ []));
+    /** When true, always shows the banner and skips reading/writing localStorage. */
     demo = input(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "demo" }] : /* istanbul ignore next */ []));
+    /** localStorage key under which the accept/decline choice is persisted. */
     storageKey = input('bui-cookie-consent', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "storageKey" }] : /* istanbul ignore next */ []));
+    /** Emitted with `true` when the user accepts and `false` when they decline. */
     decided = output();
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
+    /** Overrides the localized accessible label for the consent region. */
+    ariaLabel = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "ariaLabel" }] : /* istanbul ignore next */ []));
+    ariaLabelText = buiLabel('cookieConsent', this.ariaLabel);
     visible = signal(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "visible" }] : /* istanbul ignore next */ []));
     computedClass = computed(() => cn('flex flex-col items-start gap-3 rounded-lg border bg-card p-4 shadow-lg sm:flex-row sm:items-center sm:justify-between', this.userClass()), /* @ts-ignore */
@@ -12044,7 +12621,7 @@ class BuiCookieConsent {
         this.decided.emit(isAccepted);
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.2", ngImport: i0, type: BuiCookieConsent, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.1.0", version: "22.0.2", type: BuiCookieConsent, isStandalone: true, selector: "bui-cookie-consent", inputs: { message: { classPropertyName: "message", publicName: "message", isSignal: true, isRequired: false, transformFunction: null }, demo: { classPropertyName: "demo", publicName: "demo", isSignal: true, isRequired: false, transformFunction: null }, storageKey: { classPropertyName: "storageKey", publicName: "storageKey", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { decided: "decided" }, host: { attributes: { "data-slot": "cookie-consent", "role": "region", "aria-label": "Cookie consent" }, properties: { "class": "computedClass()", "hidden": "!visible()" } }, ngImport: i0, template: `
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.1.0", version: "22.0.2", type: BuiCookieConsent, isStandalone: true, selector: "bui-cookie-consent", inputs: { message: { classPropertyName: "message", publicName: "message", isSignal: true, isRequired: false, transformFunction: null }, demo: { classPropertyName: "demo", publicName: "demo", isSignal: true, isRequired: false, transformFunction: null }, storageKey: { classPropertyName: "storageKey", publicName: "storageKey", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null }, ariaLabel: { classPropertyName: "ariaLabel", publicName: "ariaLabel", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { decided: "decided" }, host: { attributes: { "data-slot": "cookie-consent", "role": "region" }, properties: { "attr.aria-label": "ariaLabelText()", "class": "computedClass()", "hidden": "!visible()" } }, ngImport: i0, template: `
     <p class="text-sm text-muted-foreground">{{ message() }}</p>
     <div class="flex shrink-0 gap-2">
       <button
@@ -12071,7 +12648,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
                     host: {
                         'data-slot': 'cookie-consent',
                         role: 'region',
-                        'aria-label': 'Cookie consent',
+                        '[attr.aria-label]': 'ariaLabelText()',
                         '[class]': 'computedClass()',
                         '[hidden]': '!visible()',
                     },
@@ -12095,19 +12672,23 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
     </div>
   `,
                 }]
-        }], ctorParameters: () => [], propDecorators: { message: [{ type: i0.Input, args: [{ isSignal: true, alias: "message", required: false }] }], demo: [{ type: i0.Input, args: [{ isSignal: true, alias: "demo", required: false }] }], storageKey: [{ type: i0.Input, args: [{ isSignal: true, alias: "storageKey", required: false }] }], decided: [{ type: i0.Output, args: ["decided"] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }] } });
+        }], ctorParameters: () => [], propDecorators: { message: [{ type: i0.Input, args: [{ isSignal: true, alias: "message", required: false }] }], demo: [{ type: i0.Input, args: [{ isSignal: true, alias: "demo", required: false }] }], storageKey: [{ type: i0.Input, args: [{ isSignal: true, alias: "storageKey", required: false }] }], decided: [{ type: i0.Output, args: ["decided"] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }], ariaLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "ariaLabel", required: false }] }] } });
 
 /**
  * Emits `more` when a sentinel scrolls into view (IntersectionObserver) or the fallback
  * "Load more" button is pressed. Drive `loading` / `finished` from the consumer. SSR-safe.
  */
 class BuiInfiniteScroll {
+    /** Whether a load is in progress; shows the spinner and suppresses new emits. */
     loading = input(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "loading" }] : /* istanbul ignore next */ []));
+    /** Whether all items are loaded; shows the end message and suppresses emits. */
     finished = input(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "finished" }] : /* istanbul ignore next */ []));
+    /** Pixel margin below the viewport at which the sentinel triggers loading. */
     threshold = input(200, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "threshold" }] : /* istanbul ignore next */ []));
+    /** Emits when the sentinel scrolls into view or the fallback button is pressed. */
     more = output();
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
     sentinel = viewChild('sentinel', /* @ts-ignore */
@@ -12232,18 +12813,42 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** A compact audio player around a native `<audio>`: play/pause, seek, time, mute. */
 class BuiAudioPlayer {
+    /** Audio source URL for the underlying `<audio>` element. */
     src = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "src" }] : /* istanbul ignore next */ []));
+    /** Track title shown next to the controls. */
     title = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "title" }] : /* istanbul ignore next */ []));
+    /** Artist name shown under the title. */
     artist = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "artist" }] : /* istanbul ignore next */ []));
+    /** Whether to start playback automatically once loaded. */
     autoplay = input(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "autoplay" }] : /* istanbul ignore next */ []));
     /** Condensed layout: hides the title block and mute button. */
     compact = input(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "compact" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
+    /** Accessible label override for the seek slider. */
+    seekLabel = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "seekLabel" }] : /* istanbul ignore next */ []));
+    /** Accessible label override for the play button. */
+    playLabel = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "playLabel" }] : /* istanbul ignore next */ []));
+    /** Accessible label override for the pause button. */
+    pauseLabel = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "pauseLabel" }] : /* istanbul ignore next */ []));
+    /** Accessible label override for the mute button. */
+    muteLabel = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "muteLabel" }] : /* istanbul ignore next */ []));
+    /** Accessible label override for the unmute button. */
+    unmuteLabel = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "unmuteLabel" }] : /* istanbul ignore next */ []));
+    seekText = buiLabel('audioPlayerSeek', this.seekLabel);
+    playText = buiLabel('audioPlayerPlay', this.playLabel);
+    pauseText = buiLabel('audioPlayerPause', this.pauseLabel);
+    muteText = buiLabel('audioPlayerMute', this.muteLabel);
+    unmuteText = buiLabel('audioPlayerUnmute', this.unmuteLabel);
     a = viewChild('a', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "a" }] : /* istanbul ignore next */ []));
     playing = signal(false, /* @ts-ignore */
@@ -12303,7 +12908,7 @@ class BuiAudioPlayer {
         return `${minutes}:${rest.toString().padStart(2, '0')}`;
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.2", ngImport: i0, type: BuiAudioPlayer, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.0.2", type: BuiAudioPlayer, isStandalone: true, selector: "bui-audio-player", inputs: { src: { classPropertyName: "src", publicName: "src", isSignal: true, isRequired: false, transformFunction: null }, title: { classPropertyName: "title", publicName: "title", isSignal: true, isRequired: false, transformFunction: null }, artist: { classPropertyName: "artist", publicName: "artist", isSignal: true, isRequired: false, transformFunction: null }, autoplay: { classPropertyName: "autoplay", publicName: "autoplay", isSignal: true, isRequired: false, transformFunction: null }, compact: { classPropertyName: "compact", publicName: "compact", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null } }, host: { attributes: { "data-slot": "audio-player" }, properties: { "class": "computedClass()" } }, viewQueries: [{ propertyName: "a", first: true, predicate: ["a"], descendants: true, isSignal: true }], ngImport: i0, template: `
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.0.2", type: BuiAudioPlayer, isStandalone: true, selector: "bui-audio-player", inputs: { src: { classPropertyName: "src", publicName: "src", isSignal: true, isRequired: false, transformFunction: null }, title: { classPropertyName: "title", publicName: "title", isSignal: true, isRequired: false, transformFunction: null }, artist: { classPropertyName: "artist", publicName: "artist", isSignal: true, isRequired: false, transformFunction: null }, autoplay: { classPropertyName: "autoplay", publicName: "autoplay", isSignal: true, isRequired: false, transformFunction: null }, compact: { classPropertyName: "compact", publicName: "compact", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null }, seekLabel: { classPropertyName: "seekLabel", publicName: "seekLabel", isSignal: true, isRequired: false, transformFunction: null }, playLabel: { classPropertyName: "playLabel", publicName: "playLabel", isSignal: true, isRequired: false, transformFunction: null }, pauseLabel: { classPropertyName: "pauseLabel", publicName: "pauseLabel", isSignal: true, isRequired: false, transformFunction: null }, muteLabel: { classPropertyName: "muteLabel", publicName: "muteLabel", isSignal: true, isRequired: false, transformFunction: null }, unmuteLabel: { classPropertyName: "unmuteLabel", publicName: "unmuteLabel", isSignal: true, isRequired: false, transformFunction: null } }, host: { attributes: { "data-slot": "audio-player" }, properties: { "class": "computedClass()" } }, viewQueries: [{ propertyName: "a", first: true, predicate: ["a"], descendants: true, isSignal: true }], ngImport: i0, template: `
     <audio
       #a
       [src]="src() || null"
@@ -12319,7 +12924,7 @@ class BuiAudioPlayer {
     <button
       type="button"
       class="inline-flex size-9 shrink-0 items-center justify-center rounded-full bg-primary text-primary-foreground"
-      [attr.aria-label]="playing() ? 'Pause' : 'Play'"
+      [attr.aria-label]="playing() ? pauseText() : playText()"
       (click)="toggle()"
     >
       <svg class="size-4" viewBox="0 0 24 24" fill="currentColor" aria-hidden="true">
@@ -12346,7 +12951,7 @@ class BuiAudioPlayer {
       [max]="duration() || 0"
       [value]="current()"
       class="h-1 flex-1 accent-primary"
-      aria-label="Seek"
+      [attr.aria-label]="seekText()"
       (input)="seek($event)"
     />
     <span class="text-xs text-muted-foreground tabular-nums">{{ format(duration()) }}</span>
@@ -12354,7 +12959,7 @@ class BuiAudioPlayer {
       <button
         type="button"
         class="shrink-0 text-muted-foreground hover:text-foreground"
-        [attr.aria-label]="muted() ? 'Unmute' : 'Mute'"
+        [attr.aria-label]="muted() ? unmuteText() : muteText()"
         (click)="toggleMute()"
       >
         <svg class="size-4" viewBox="0 0 24 24" fill="currentColor" aria-hidden="true">
@@ -12391,7 +12996,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
     <button
       type="button"
       class="inline-flex size-9 shrink-0 items-center justify-center rounded-full bg-primary text-primary-foreground"
-      [attr.aria-label]="playing() ? 'Pause' : 'Play'"
+      [attr.aria-label]="playing() ? pauseText() : playText()"
       (click)="toggle()"
     >
       <svg class="size-4" viewBox="0 0 24 24" fill="currentColor" aria-hidden="true">
@@ -12418,7 +13023,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
       [max]="duration() || 0"
       [value]="current()"
       class="h-1 flex-1 accent-primary"
-      aria-label="Seek"
+      [attr.aria-label]="seekText()"
       (input)="seek($event)"
     />
     <span class="text-xs text-muted-foreground tabular-nums">{{ format(duration()) }}</span>
@@ -12426,7 +13031,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
       <button
         type="button"
         class="shrink-0 text-muted-foreground hover:text-foreground"
-        [attr.aria-label]="muted() ? 'Unmute' : 'Mute'"
+        [attr.aria-label]="muted() ? unmuteText() : muteText()"
         (click)="toggleMute()"
       >
         <svg class="size-4" viewBox="0 0 24 24" fill="currentColor" aria-hidden="true">
@@ -12442,12 +13047,14 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
     }
   `,
                 }]
-        }], propDecorators: { src: [{ type: i0.Input, args: [{ isSignal: true, alias: "src", required: false }] }], title: [{ type: i0.Input, args: [{ isSignal: true, alias: "title", required: false }] }], artist: [{ type: i0.Input, args: [{ isSignal: true, alias: "artist", required: false }] }], autoplay: [{ type: i0.Input, args: [{ isSignal: true, alias: "autoplay", required: false }] }], compact: [{ type: i0.Input, args: [{ isSignal: true, alias: "compact", required: false }] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }], a: [{ type: i0.ViewChild, args: ['a', { isSignal: true }] }] } });
+        }], propDecorators: { src: [{ type: i0.Input, args: [{ isSignal: true, alias: "src", required: false }] }], title: [{ type: i0.Input, args: [{ isSignal: true, alias: "title", required: false }] }], artist: [{ type: i0.Input, args: [{ isSignal: true, alias: "artist", required: false }] }], autoplay: [{ type: i0.Input, args: [{ isSignal: true, alias: "autoplay", required: false }] }], compact: [{ type: i0.Input, args: [{ isSignal: true, alias: "compact", required: false }] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }], seekLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "seekLabel", required: false }] }], playLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "playLabel", required: false }] }], pauseLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "pauseLabel", required: false }] }], muteLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "muteLabel", required: false }] }], unmuteLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "unmuteLabel", required: false }] }], a: [{ type: i0.ViewChild, args: ['a', { isSignal: true }] }] } });
 
 /** A canvas signature pad with draw, undo and clear. SSR-safe (canvas set up in the browser). */
 class BuiSignaturePad {
+    /** Canvas height in pixels. */
     height = input(200, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "height" }] : /* istanbul ignore next */ []));
+    /** Stroke color; falls back to the current text color when empty. */
     penColor = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "penColor" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -12604,11 +13211,17 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** A macOS-style dock with a cursor-following fisheye magnify. Use `bui-dock-item` tiles. */
 class BuiDock {
+    /** Maximum scale factor applied to the tile directly under the cursor. */
     magnify = input(1.6, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "magnify" }] : /* istanbul ignore next */ []));
+    /** Pixel radius around the cursor within which tiles are magnified. */
     distance = input(120, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "distance" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
+    /** Accessible label for the dock navigation; falls back to the i18n default. */
+    label = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "label" }] : /* istanbul ignore next */ []));
+    labelText = buiLabel('dock', this.label);
     mouseX = signal(null, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "mouseX" }] : /* istanbul ignore next */ []));
     computedClass = computed(() => cn('inline-block', this.userClass()), /* @ts-ignore */
@@ -12625,9 +13238,9 @@ class BuiDock {
         return 1 + (this.magnify() - 1) * (1 - distance / this.distance());
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.2", ngImport: i0, type: BuiDock, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.1.0", version: "22.0.2", type: BuiDock, isStandalone: true, selector: "bui-dock", inputs: { magnify: { classPropertyName: "magnify", publicName: "magnify", isSignal: true, isRequired: false, transformFunction: null }, distance: { classPropertyName: "distance", publicName: "distance", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null } }, host: { attributes: { "data-slot": "dock" }, listeners: { "mousemove": "mouseX.set($event.clientX)", "mouseleave": "mouseX.set(null)" }, properties: { "class": "computedClass()" } }, ngImport: i0, template: `
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.1.0", version: "22.0.2", type: BuiDock, isStandalone: true, selector: "bui-dock", inputs: { magnify: { classPropertyName: "magnify", publicName: "magnify", isSignal: true, isRequired: false, transformFunction: null }, distance: { classPropertyName: "distance", publicName: "distance", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null }, label: { classPropertyName: "label", publicName: "label", isSignal: true, isRequired: false, transformFunction: null } }, host: { attributes: { "data-slot": "dock" }, listeners: { "mousemove": "mouseX.set($event.clientX)", "mouseleave": "mouseX.set(null)" }, properties: { "class": "computedClass()" } }, ngImport: i0, template: `
     <nav
-      aria-label="Dock"
+      [attr.aria-label]="labelText()"
       class="flex items-end gap-2 rounded-2xl border bg-card/80 p-2 shadow-lg backdrop-blur"
     >
       <ng-content />
@@ -12646,17 +13259,18 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
                     },
                     template: `
     <nav
-      aria-label="Dock"
+      [attr.aria-label]="labelText()"
       class="flex items-end gap-2 rounded-2xl border bg-card/80 p-2 shadow-lg backdrop-blur"
     >
       <ng-content />
     </nav>
   `,
                 }]
-        }], propDecorators: { magnify: [{ type: i0.Input, args: [{ isSignal: true, alias: "magnify", required: false }] }], distance: [{ type: i0.Input, args: [{ isSignal: true, alias: "distance", required: false }] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }] } });
+        }], propDecorators: { magnify: [{ type: i0.Input, args: [{ isSignal: true, alias: "magnify", required: false }] }], distance: [{ type: i0.Input, args: [{ isSignal: true, alias: "distance", required: false }] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }], label: [{ type: i0.Input, args: [{ isSignal: true, alias: "label", required: false }] }] } });
 
 /** A magnifying tile inside a `bui-dock`. */
 class BuiDockItem {
+    /** Whether to show the active indicator dot beneath the tile. */
     active = input(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "active" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -12713,8 +13327,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** A single tree row; renders its own children recursively. */
 class BuiTreeNode {
+    /** Node data for this row, including its label and children. */
     item = input.required(/* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "item" }] : /* istanbul ignore next */ []));
+    /** Depth of this node, used for indentation and `aria-level` (root is 1). */
     level = input(1, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "level" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -12824,8 +13440,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** A collapsible, data-driven hierarchical tree (`role="tree"`). */
 class BuiTree {
+    /** Root nodes of the tree to render. */
     items = input([], /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "items" }] : /* istanbul ignore next */ []));
+    /** Accessible label for the tree's root element. */
     ariaLabel = input('Tree', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "ariaLabel" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -12858,17 +13476,26 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** A dynamic list of repeatable form rows with add/remove and min/max bounds. */
 class BuiRepeater {
+    /** Column definitions rendered for every row. */
     fields = input([], /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "fields" }] : /* istanbul ignore next */ []));
+    /** Row data keyed by field key. Two-way bindable with `[(rows)]`. */
     rows = model([], /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "rows" }] : /* istanbul ignore next */ []));
+    /** Minimum number of rows that must remain (remove is disabled at this count). */
     min = input(1, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "min" }] : /* istanbul ignore next */ []));
+    /** Maximum number of rows allowed, or null for unlimited. */
     max = input(null, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "max" }] : /* istanbul ignore next */ []));
+    /** Text shown on the add-row button. */
     addLabel = input('Add row', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "addLabel" }] : /* istanbul ignore next */ []));
+    /** Accessible label override for the remove-row buttons. */
+    removeLabel = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "removeLabel" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
+    removeText = buiLabel('repeaterRemove', this.removeLabel);
     atMax = computed(() => {
         const max = this.max();
         return max !== null && this.rows().length >= max;
@@ -12899,7 +13526,7 @@ class BuiRepeater {
         this.rows.set(this.rows().map((row, index_) => (index_ === index ? { ...row, [key]: value } : row)));
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.2", ngImport: i0, type: BuiRepeater, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.0.2", type: BuiRepeater, isStandalone: true, selector: "bui-repeater", inputs: { fields: { classPropertyName: "fields", publicName: "fields", isSignal: true, isRequired: false, transformFunction: null }, rows: { classPropertyName: "rows", publicName: "rows", isSignal: true, isRequired: false, transformFunction: null }, min: { classPropertyName: "min", publicName: "min", isSignal: true, isRequired: false, transformFunction: null }, max: { classPropertyName: "max", publicName: "max", isSignal: true, isRequired: false, transformFunction: null }, addLabel: { classPropertyName: "addLabel", publicName: "addLabel", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { rows: "rowsChange" }, host: { attributes: { "data-slot": "repeater" }, properties: { "class": "computedClass()" } }, ngImport: i0, template: `
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.0.2", type: BuiRepeater, isStandalone: true, selector: "bui-repeater", inputs: { fields: { classPropertyName: "fields", publicName: "fields", isSignal: true, isRequired: false, transformFunction: null }, rows: { classPropertyName: "rows", publicName: "rows", isSignal: true, isRequired: false, transformFunction: null }, min: { classPropertyName: "min", publicName: "min", isSignal: true, isRequired: false, transformFunction: null }, max: { classPropertyName: "max", publicName: "max", isSignal: true, isRequired: false, transformFunction: null }, addLabel: { classPropertyName: "addLabel", publicName: "addLabel", isSignal: true, isRequired: false, transformFunction: null }, removeLabel: { classPropertyName: "removeLabel", publicName: "removeLabel", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { rows: "rowsChange" }, host: { attributes: { "data-slot": "repeater" }, properties: { "class": "computedClass()" } }, ngImport: i0, template: `
     @for (row of rows(); track $index; let i = $index) {
       <div class="flex items-end gap-2">
         @for (field of fields(); track field.key) {
@@ -12920,7 +13547,7 @@ class BuiRepeater {
           type="button"
           class="inline-flex size-9 shrink-0 items-center justify-center rounded-md border border-input text-muted-foreground hover:bg-accent disabled:opacity-50"
           [disabled]="rows().length <= min()"
-          aria-label="Remove row"
+          [attr.aria-label]="removeText()"
           (click)="removeRow(i)"
         >
           <svg
@@ -12989,7 +13616,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
           type="button"
           class="inline-flex size-9 shrink-0 items-center justify-center rounded-md border border-input text-muted-foreground hover:bg-accent disabled:opacity-50"
           [disabled]="rows().length <= min()"
-          aria-label="Remove row"
+          [attr.aria-label]="removeText()"
           (click)="removeRow(i)"
         >
           <svg
@@ -13032,15 +13659,33 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
     </button>
   `,
                 }]
-        }], propDecorators: { fields: [{ type: i0.Input, args: [{ isSignal: true, alias: "fields", required: false }] }], rows: [{ type: i0.Input, args: [{ isSignal: true, alias: "rows", required: false }] }, { type: i0.Output, args: ["rowsChange"] }], min: [{ type: i0.Input, args: [{ isSignal: true, alias: "min", required: false }] }], max: [{ type: i0.Input, args: [{ isSignal: true, alias: "max", required: false }] }], addLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "addLabel", required: false }] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }] } });
+        }], propDecorators: { fields: [{ type: i0.Input, args: [{ isSignal: true, alias: "fields", required: false }] }], rows: [{ type: i0.Input, args: [{ isSignal: true, alias: "rows", required: false }] }, { type: i0.Output, args: ["rowsChange"] }], min: [{ type: i0.Input, args: [{ isSignal: true, alias: "min", required: false }] }], max: [{ type: i0.Input, args: [{ isSignal: true, alias: "max", required: false }] }], addLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "addLabel", required: false }] }], removeLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "removeLabel", required: false }] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }] } });
 
 /** A bell trigger with a dropdown feed of notifications and an unread badge. */
 class BuiNotificationCenter {
+    /** Notification items rendered in the dropdown feed. */
     notifications = input([], /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "notifications" }] : /* istanbul ignore next */ []));
+    /** Whether the dropdown is open. Two-way bindable with `[(open)]`. */
     open = model(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "open" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
+    /** Accessible label for the trigger and dropdown region. */
+    ariaLabel = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "ariaLabel" }] : /* istanbul ignore next */ []));
+    /** Accessible label announced for the per-item unread dot. */
+    unreadLabel = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "unreadLabel" }] : /* istanbul ignore next */ []));
+    /** Label for the "mark all as read" action button. */
+    markAllReadLabel = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "markAllReadLabel" }] : /* istanbul ignore next */ []));
+    /** Text shown when there are no notifications. */
+    emptyLabel = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "emptyLabel" }] : /* istanbul ignore next */ []));
+    ariaText = buiLabel('notificationCenter', this.ariaLabel);
+    unreadText = buiLabel('notificationCenterUnread', this.unreadLabel);
+    markAllReadText = buiLabel('notificationCenterMarkAllRead', this.markAllReadLabel);
+    emptyText = buiLabel('notificationCenterEmpty', this.emptyLabel);
     markedRead = signal(new Set(), /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "markedRead" }] : /* istanbul ignore next */ []));
     unread = computed(() => this.notifications().filter((_, index) => !this.isRead(index)).length, /* @ts-ignore */
@@ -13054,12 +13699,12 @@ class BuiNotificationCenter {
         this.markedRead.set(new Set(this.notifications().map((_, index) => index)));
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.2", ngImport: i0, type: BuiNotificationCenter, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.0.2", type: BuiNotificationCenter, isStandalone: true, selector: "bui-notification-center", inputs: { notifications: { classPropertyName: "notifications", publicName: "notifications", isSignal: true, isRequired: false, transformFunction: null }, open: { classPropertyName: "open", publicName: "open", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { open: "openChange" }, host: { attributes: { "data-slot": "notification-center" }, properties: { "class": "computedClass()" } }, ngImport: i0, template: `
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.0.2", type: BuiNotificationCenter, isStandalone: true, selector: "bui-notification-center", inputs: { notifications: { classPropertyName: "notifications", publicName: "notifications", isSignal: true, isRequired: false, transformFunction: null }, open: { classPropertyName: "open", publicName: "open", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null }, ariaLabel: { classPropertyName: "ariaLabel", publicName: "ariaLabel", isSignal: true, isRequired: false, transformFunction: null }, unreadLabel: { classPropertyName: "unreadLabel", publicName: "unreadLabel", isSignal: true, isRequired: false, transformFunction: null }, markAllReadLabel: { classPropertyName: "markAllReadLabel", publicName: "markAllReadLabel", isSignal: true, isRequired: false, transformFunction: null }, emptyLabel: { classPropertyName: "emptyLabel", publicName: "emptyLabel", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { open: "openChange" }, host: { attributes: { "data-slot": "notification-center" }, properties: { "class": "computedClass()" } }, ngImport: i0, template: `
     <button
       type="button"
       class="relative inline-flex size-9 items-center justify-center rounded-md border border-input hover:bg-accent"
       [attr.aria-expanded]="open()"
-      aria-label="Notifications"
+      [attr.aria-label]="ariaText()"
       (click)="open.set(!open())"
     >
       <svg
@@ -13087,12 +13732,12 @@ class BuiNotificationCenter {
       <div
         class="absolute end-0 z-50 mt-2 w-80 rounded-lg border bg-popover text-popover-foreground shadow-md"
         role="region"
-        aria-label="Notifications"
+        [attr.aria-label]="ariaText()"
       >
         <div class="flex items-center justify-between border-b p-3">
-          <span class="text-sm font-medium">Notifications</span>
+          <span class="text-sm font-medium">{{ ariaText() }}</span>
           <button type="button" class="text-xs font-medium text-primary" (click)="markAllRead()">
-            Mark all read
+            {{ markAllReadText() }}
           </button>
         </div>
         <ul class="max-h-80 overflow-auto">
@@ -13113,12 +13758,12 @@ class BuiNotificationCenter {
               @if (!isRead(i)) {
                 <span
                   class="mt-1.5 size-2 shrink-0 rounded-full bg-primary"
-                  aria-label="Unread"
+                  [attr.aria-label]="unreadText()"
                 ></span>
               }
             </li>
           } @empty {
-            <li class="p-6 text-center text-sm text-muted-foreground">No notifications</li>
+            <li class="p-6 text-center text-sm text-muted-foreground">{{ emptyText() }}</li>
           }
         </ul>
       </div>
@@ -13135,7 +13780,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
       type="button"
       class="relative inline-flex size-9 items-center justify-center rounded-md border border-input hover:bg-accent"
       [attr.aria-expanded]="open()"
-      aria-label="Notifications"
+      [attr.aria-label]="ariaText()"
       (click)="open.set(!open())"
     >
       <svg
@@ -13163,12 +13808,12 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
       <div
         class="absolute end-0 z-50 mt-2 w-80 rounded-lg border bg-popover text-popover-foreground shadow-md"
         role="region"
-        aria-label="Notifications"
+        [attr.aria-label]="ariaText()"
       >
         <div class="flex items-center justify-between border-b p-3">
-          <span class="text-sm font-medium">Notifications</span>
+          <span class="text-sm font-medium">{{ ariaText() }}</span>
           <button type="button" class="text-xs font-medium text-primary" (click)="markAllRead()">
-            Mark all read
+            {{ markAllReadText() }}
           </button>
         </div>
         <ul class="max-h-80 overflow-auto">
@@ -13189,26 +13834,29 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
               @if (!isRead(i)) {
                 <span
                   class="mt-1.5 size-2 shrink-0 rounded-full bg-primary"
-                  aria-label="Unread"
+                  [attr.aria-label]="unreadText()"
                 ></span>
               }
             </li>
           } @empty {
-            <li class="p-6 text-center text-sm text-muted-foreground">No notifications</li>
+            <li class="p-6 text-center text-sm text-muted-foreground">{{ emptyText() }}</li>
           }
         </ul>
       </div>
     }
   `,
                 }]
-        }], propDecorators: { notifications: [{ type: i0.Input, args: [{ isSignal: true, alias: "notifications", required: false }] }], open: [{ type: i0.Input, args: [{ isSignal: true, alias: "open", required: false }] }, { type: i0.Output, args: ["openChange"] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }] } });
+        }], propDecorators: { notifications: [{ type: i0.Input, args: [{ isSignal: true, alias: "notifications", required: false }] }], open: [{ type: i0.Input, args: [{ isSignal: true, alias: "open", required: false }] }, { type: i0.Output, args: ["openChange"] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }], ariaLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "ariaLabel", required: false }] }], unreadLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "unreadLabel", required: false }] }], markAllReadLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "markAllReadLabel", required: false }] }], emptyLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "emptyLabel", required: false }] }] } });
 
 /** A single JSON node; renders nested objects/arrays recursively. */
 class BuiJsonViewerNode {
+    /** Arbitrary JSON value rendered by this node. */
     value = input(null, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "value" }] : /* istanbul ignore next */ []));
+    /** Object key or array index labeling this node, or null at the root. */
     keyName = input(null, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "keyName" }] : /* istanbul ignore next */ []));
+    /** Whether this node starts expanded. */
     expanded = input(true, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "expanded" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -13390,8 +14038,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** A collapsible JSON tree viewer. Accepts an object/array or a JSON string. */
 class BuiJsonViewer {
+    /** Arbitrary JSON value to render; a string is parsed as JSON when possible. */
     data = input(null, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "data" }] : /* istanbul ignore next */ []));
+    /** Whether nodes start expanded. */
     expanded = input(true, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "expanded" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -13425,6 +14075,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** A single org-chart node (a card + recursive children). Rendered on an `<li>`. */
 class BuiOrgChartNode {
+    /** Node rendered as a card, with its `children` recursed into nested `<li>`s. */
     node = input.required(/* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "node" }] : /* istanbul ignore next */ []));
     children = computed(() => this.node().children ?? [], /* @ts-ignore */
@@ -13501,6 +14152,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** A top-down organizational chart with pure-CSS connectors. Recursively renders nodes. */
 class BuiOrgChart {
+    /** Root node of the tree to render; `null` renders nothing. */
     node = input(null, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "node" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -13528,13 +14180,24 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** A cart trigger with an item-count badge and a dropdown with line items + subtotal. */
 class BuiMiniCart {
+    /** Line items in the cart, used for count and subtotal. */
     items = input([], /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "items" }] : /* istanbul ignore next */ []));
+    /** Currency symbol prefixed to prices and subtotal. */
     currency = input('$', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "currency" }] : /* istanbul ignore next */ []));
+    /** Whether the dropdown is open. Two-way bindable with `[(open)]`. */
     open = model(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "open" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
+    /** Accessible label override for the cart trigger button. */
+    triggerLabel = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "triggerLabel" }] : /* istanbul ignore next */ []));
+    /** Accessible label override for the cart dropdown dialog. */
+    label = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "label" }] : /* istanbul ignore next */ []));
+    triggerText = buiLabel('miniCartTrigger', this.triggerLabel);
+    labelText = buiLabel('miniCart', this.label);
     count = computed(() => this.items().reduce((total, item) => total + item.qty, 0), /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "count" }] : /* istanbul ignore next */ []));
     subtotal = computed(() => this.items().reduce((total, item) => total + item.price * item.qty, 0), /* @ts-ignore */
@@ -13546,12 +14209,12 @@ class BuiMiniCart {
             value.toLocaleString('en-US', { minimumFractionDigits: 2, maximumFractionDigits: 2 }));
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.2", ngImport: i0, type: BuiMiniCart, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.0.2", type: BuiMiniCart, isStandalone: true, selector: "bui-mini-cart", inputs: { items: { classPropertyName: "items", publicName: "items", isSignal: true, isRequired: false, transformFunction: null }, currency: { classPropertyName: "currency", publicName: "currency", isSignal: true, isRequired: false, transformFunction: null }, open: { classPropertyName: "open", publicName: "open", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { open: "openChange" }, host: { attributes: { "data-slot": "mini-cart" }, properties: { "class": "computedClass()" } }, ngImport: i0, template: `
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.0.2", type: BuiMiniCart, isStandalone: true, selector: "bui-mini-cart", inputs: { items: { classPropertyName: "items", publicName: "items", isSignal: true, isRequired: false, transformFunction: null }, currency: { classPropertyName: "currency", publicName: "currency", isSignal: true, isRequired: false, transformFunction: null }, open: { classPropertyName: "open", publicName: "open", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null }, triggerLabel: { classPropertyName: "triggerLabel", publicName: "triggerLabel", isSignal: true, isRequired: false, transformFunction: null }, label: { classPropertyName: "label", publicName: "label", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { open: "openChange" }, host: { attributes: { "data-slot": "mini-cart" }, properties: { "class": "computedClass()" } }, ngImport: i0, template: `
     <button
       type="button"
       class="relative inline-flex size-9 items-center justify-center rounded-md border border-input hover:bg-accent"
       [attr.aria-expanded]="open()"
-      aria-label="Cart"
+      [attr.aria-label]="triggerText()"
       (click)="open.set(!open())"
     >
       <svg
@@ -13580,7 +14243,7 @@ class BuiMiniCart {
       <div
         class="absolute end-0 z-50 mt-2 w-80 rounded-lg border bg-popover text-popover-foreground shadow-md"
         role="dialog"
-        aria-label="Shopping cart"
+        [attr.aria-label]="labelText()"
       >
         <div class="border-b p-3 text-sm font-medium">Your cart</div>
         @if (items().length === 0) {
@@ -13634,7 +14297,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
       type="button"
       class="relative inline-flex size-9 items-center justify-center rounded-md border border-input hover:bg-accent"
       [attr.aria-expanded]="open()"
-      aria-label="Cart"
+      [attr.aria-label]="triggerText()"
       (click)="open.set(!open())"
     >
       <svg
@@ -13663,7 +14326,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
       <div
         class="absolute end-0 z-50 mt-2 w-80 rounded-lg border bg-popover text-popover-foreground shadow-md"
         role="dialog"
-        aria-label="Shopping cart"
+        [attr.aria-label]="labelText()"
       >
         <div class="border-b p-3 text-sm font-medium">Your cart</div>
         @if (items().length === 0) {
@@ -13707,16 +14370,20 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
     }
   `,
                 }]
-        }], propDecorators: { items: [{ type: i0.Input, args: [{ isSignal: true, alias: "items", required: false }] }], currency: [{ type: i0.Input, args: [{ isSignal: true, alias: "currency", required: false }] }], open: [{ type: i0.Input, args: [{ isSignal: true, alias: "open", required: false }] }, { type: i0.Output, args: ["openChange"] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }] } });
+        }], propDecorators: { items: [{ type: i0.Input, args: [{ isSignal: true, alias: "items", required: false }] }], currency: [{ type: i0.Input, args: [{ isSignal: true, alias: "currency", required: false }] }], open: [{ type: i0.Input, args: [{ isSignal: true, alias: "open", required: false }] }, { type: i0.Output, args: ["openChange"] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }], triggerLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "triggerLabel", required: false }] }], label: [{ type: i0.Input, args: [{ isSignal: true, alias: "label", required: false }] }] } });
 
 /** An SVG beam connecting two elements (by selector) with a travelling light. SSR-safe. */
 class BuiAnimatedBeam {
+    /** CSS selector of the element the beam starts from. */
     from = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "from" }] : /* istanbul ignore next */ []));
+    /** CSS selector of the element the beam ends at. */
     to = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "to" }] : /* istanbul ignore next */ []));
+    /** Upward bow of the connecting curve in pixels. */
     curvature = input(0, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "curvature" }] : /* istanbul ignore next */ []));
+    /** Seconds for the travelling light to traverse the beam. */
     duration = input(3, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "duration" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -13854,10 +14521,13 @@ const ROW_CLASS = {
 const SIGN = { same: ' ', add: '+', del: '-' };
 /** A line-by-line text diff (LCS) rendered with +/- gutters. */
 class BuiDiffViewer {
+    /** Original text; lines removed relative to `after` are marked deleted. */
     before = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "before" }] : /* istanbul ignore next */ []));
+    /** Updated text; lines added relative to `before` are marked added. */
     after = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "after" }] : /* istanbul ignore next */ []));
+    /** Optional filename shown in the header above the diff. */
     filename = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "filename" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -13926,11 +14596,17 @@ const ALIGN$2 = {
 };
 /** A table whose rows can nest and expand/collapse (flattened to visible rows). */
 class BuiTreeTable {
+    /** Column definitions in display order. */
     columns = input([], /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "columns" }] : /* istanbul ignore next */ []));
+    /** Top-level rows, each able to nest children via `children`. */
     rows = input([], /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "rows" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
+    /** Accessible label for the expand/collapse toggle button. */
+    toggleLabel = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "toggleLabel" }] : /* istanbul ignore next */ []));
+    toggleText = buiLabel('treeTableToggle', this.toggleLabel);
     overrides = signal(new Map(), /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "overrides" }] : /* istanbul ignore next */ []));
     defaults = computed(() => {
@@ -13989,7 +14665,7 @@ class BuiTreeTable {
         return '';
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.2", ngImport: i0, type: BuiTreeTable, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.0.2", type: BuiTreeTable, isStandalone: true, selector: "bui-tree-table", inputs: { columns: { classPropertyName: "columns", publicName: "columns", isSignal: true, isRequired: false, transformFunction: null }, rows: { classPropertyName: "rows", publicName: "rows", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null } }, host: { attributes: { "data-slot": "tree-table" }, properties: { "class": "computedClass()" } }, ngImport: i0, template: `
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.0.2", type: BuiTreeTable, isStandalone: true, selector: "bui-tree-table", inputs: { columns: { classPropertyName: "columns", publicName: "columns", isSignal: true, isRequired: false, transformFunction: null }, rows: { classPropertyName: "rows", publicName: "rows", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null }, toggleLabel: { classPropertyName: "toggleLabel", publicName: "toggleLabel", isSignal: true, isRequired: false, transformFunction: null } }, host: { attributes: { "data-slot": "tree-table" }, properties: { "class": "computedClass()" } }, ngImport: i0, template: `
     <table class="w-full text-sm">
       <thead>
         <tr class="border-b">
@@ -14015,7 +14691,7 @@ class BuiTreeTable {
                         type="button"
                         class="text-muted-foreground hover:text-foreground"
                         [attr.aria-expanded]="isOpen(row.path)"
-                        aria-label="Toggle row"
+                        [attr.aria-label]="toggleText()"
                         (click)="toggle(row.path)"
                       >
                         <svg
@@ -14077,7 +14753,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
                         type="button"
                         class="text-muted-foreground hover:text-foreground"
                         [attr.aria-expanded]="isOpen(row.path)"
-                        aria-label="Toggle row"
+                        [attr.aria-label]="toggleText()"
                         (click)="toggle(row.path)"
                       >
                         <svg
@@ -14108,7 +14784,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
     </table>
   `,
                 }]
-        }], propDecorators: { columns: [{ type: i0.Input, args: [{ isSignal: true, alias: "columns", required: false }] }], rows: [{ type: i0.Input, args: [{ isSignal: true, alias: "rows", required: false }] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }] } });
+        }], propDecorators: { columns: [{ type: i0.Input, args: [{ isSignal: true, alias: "columns", required: false }] }], rows: [{ type: i0.Input, args: [{ isSignal: true, alias: "rows", required: false }] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }], toggleLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "toggleLabel", required: false }] }] } });
 
 // HTML is escaped first, then a safe subset of markdown is applied, so user input can't inject markup.
 function renderMarkdown(markdown) {
@@ -14124,12 +14800,16 @@ function renderMarkdown(markdown) {
 }
 /** A markdown textarea with a live, sanitized HTML preview. */
 class BuiMarkdownEditor {
+    /** Markdown source text. Two-way bindable with `[(value)]`. */
     value = model('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "value" }] : /* istanbul ignore next */ []));
+    /** Name attribute applied to the textarea for form submission. */
     name = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "name" }] : /* istanbul ignore next */ []));
+    /** Placeholder text shown while the textarea is empty. */
     placeholder = input('Write markdown…', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "placeholder" }] : /* istanbul ignore next */ []));
+    /** Number of visible rows in the write textarea. */
     rows = input(8, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "rows" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -14217,6 +14897,7 @@ function isoOf(date) {
  * Render several months side by side with `months`. SSR-safe.
  */
 class BuiCalendar {
+    /** Selected day (mode="single") as `yyyy-mm-dd`. Two-way bindable with `[(value)]`. */
     value = model('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "value" }] : /* istanbul ignore next */ []));
     /** Selection mode: `single` | `range` | `multiple`. */
@@ -14231,10 +14912,13 @@ class BuiCalendar {
     /** Number of month grids to render side by side. */
     months = input(1, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "months" }] : /* istanbul ignore next */ []));
+    /** First day of the week (0 = Sunday). */
     weekStart = input(0, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "weekStart" }] : /* istanbul ignore next */ []));
+    /** Earliest selectable date (`yyyy-mm-dd`). */
     minDate = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "minDate" }] : /* istanbul ignore next */ []));
+    /** Latest selectable date (`yyyy-mm-dd`). */
     maxDate = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "maxDate" }] : /* istanbul ignore next */ []));
     /** Specific ISO dates (yyyy-mm-dd) to disable. */
@@ -14252,9 +14936,26 @@ class BuiCalendar {
     /** Hide days that fall outside the current month. */
     hideOutsideDays = input(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "hideOutsideDays" }] : /* istanbul ignore next */ []));
+    /** Whether the whole calendar is disabled. Two-way bindable with `[(disabled)]`. */
     disabled = model(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "disabled" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
+    /** Accessible label for the previous-month button. */
+    previousMonthLabel = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "previousMonthLabel" }] : /* istanbul ignore next */ []));
+    /** Accessible label for the month dropdown. */
+    monthSelectLabel = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "monthSelectLabel" }] : /* istanbul ignore next */ []));
+    /** Accessible label for the year dropdown. */
+    yearLabel = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "yearLabel" }] : /* istanbul ignore next */ []));
+    /** Accessible label for the next-month button. */
+    nextMonthLabel = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "nextMonthLabel" }] : /* istanbul ignore next */ []));
+    previousMonthText = buiLabel('calendarPreviousMonth', this.previousMonthLabel);
+    monthText = buiLabel('calendarMonth', this.monthSelectLabel);
+    yearText = buiLabel('calendarYear', this.yearLabel);
+    nextMonthText = buiLabel('calendarNextMonth', this.nextMonthLabel);
     onChange = noop$4;
     onTouched = noop$4;
     view = signal(new Date(new Date().getFullYear(), new Date().getMonth(), 1), /* @ts-ignore */
@@ -14421,14 +15122,14 @@ class BuiCalendar {
         return false;
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.2", ngImport: i0, type: BuiCalendar, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.0.2", type: BuiCalendar, isStandalone: true, selector: "bui-calendar", inputs: { value: { classPropertyName: "value", publicName: "value", isSignal: true, isRequired: false, transformFunction: null }, mode: { classPropertyName: "mode", publicName: "mode", isSignal: true, isRequired: false, transformFunction: null }, range: { classPropertyName: "range", publicName: "range", isSignal: true, isRequired: false, transformFunction: null }, values: { classPropertyName: "values", publicName: "values", isSignal: true, isRequired: false, transformFunction: null }, months: { classPropertyName: "months", publicName: "months", isSignal: true, isRequired: false, transformFunction: null }, weekStart: { classPropertyName: "weekStart", publicName: "weekStart", isSignal: true, isRequired: false, transformFunction: null }, minDate: { classPropertyName: "minDate", publicName: "minDate", isSignal: true, isRequired: false, transformFunction: null }, maxDate: { classPropertyName: "maxDate", publicName: "maxDate", isSignal: true, isRequired: false, transformFunction: null }, disabledDates: { classPropertyName: "disabledDates", publicName: "disabledDates", isSignal: true, isRequired: false, transformFunction: null }, disableWeekends: { classPropertyName: "disableWeekends", publicName: "disableWeekends", isSignal: true, isRequired: false, transformFunction: null }, showWeekNumbers: { classPropertyName: "showWeekNumbers", publicName: "showWeekNumbers", isSignal: true, isRequired: false, transformFunction: null }, captionLayout: { classPropertyName: "captionLayout", publicName: "captionLayout", isSignal: true, isRequired: false, transformFunction: null }, hideOutsideDays: { classPropertyName: "hideOutsideDays", publicName: "hideOutsideDays", isSignal: true, isRequired: false, transformFunction: null }, disabled: { classPropertyName: "disabled", publicName: "disabled", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { value: "valueChange", range: "rangeChange", values: "valuesChange", disabled: "disabledChange" }, host: { attributes: { "data-slot": "calendar" }, listeners: { "focusout": "onTouched()" }, properties: { "class": "computedClass()" } }, providers: [
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.0.2", type: BuiCalendar, isStandalone: true, selector: "bui-calendar", inputs: { value: { classPropertyName: "value", publicName: "value", isSignal: true, isRequired: false, transformFunction: null }, mode: { classPropertyName: "mode", publicName: "mode", isSignal: true, isRequired: false, transformFunction: null }, range: { classPropertyName: "range", publicName: "range", isSignal: true, isRequired: false, transformFunction: null }, values: { classPropertyName: "values", publicName: "values", isSignal: true, isRequired: false, transformFunction: null }, months: { classPropertyName: "months", publicName: "months", isSignal: true, isRequired: false, transformFunction: null }, weekStart: { classPropertyName: "weekStart", publicName: "weekStart", isSignal: true, isRequired: false, transformFunction: null }, minDate: { classPropertyName: "minDate", publicName: "minDate", isSignal: true, isRequired: false, transformFunction: null }, maxDate: { classPropertyName: "maxDate", publicName: "maxDate", isSignal: true, isRequired: false, transformFunction: null }, disabledDates: { classPropertyName: "disabledDates", publicName: "disabledDates", isSignal: true, isRequired: false, transformFunction: null }, disableWeekends: { classPropertyName: "disableWeekends", publicName: "disableWeekends", isSignal: true, isRequired: false, transformFunction: null }, showWeekNumbers: { classPropertyName: "showWeekNumbers", publicName: "showWeekNumbers", isSignal: true, isRequired: false, transformFunction: null }, captionLayout: { classPropertyName: "captionLayout", publicName: "captionLayout", isSignal: true, isRequired: false, transformFunction: null }, hideOutsideDays: { classPropertyName: "hideOutsideDays", publicName: "hideOutsideDays", isSignal: true, isRequired: false, transformFunction: null }, disabled: { classPropertyName: "disabled", publicName: "disabled", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null }, previousMonthLabel: { classPropertyName: "previousMonthLabel", publicName: "previousMonthLabel", isSignal: true, isRequired: false, transformFunction: null }, monthSelectLabel: { classPropertyName: "monthSelectLabel", publicName: "monthSelectLabel", isSignal: true, isRequired: false, transformFunction: null }, yearLabel: { classPropertyName: "yearLabel", publicName: "yearLabel", isSignal: true, isRequired: false, transformFunction: null }, nextMonthLabel: { classPropertyName: "nextMonthLabel", publicName: "nextMonthLabel", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { value: "valueChange", range: "rangeChange", values: "valuesChange", disabled: "disabledChange" }, host: { attributes: { "data-slot": "calendar" }, listeners: { "focusout": "onTouched()" }, properties: { "class": "computedClass()" } }, providers: [
             { provide: NG_VALUE_ACCESSOR, useExisting: forwardRef(() => BuiCalendar), multi: true },
         ], ngImport: i0, template: `
     <div class="flex items-center justify-between pb-2">
       <button
         type="button"
         class="inline-flex size-7 items-center justify-center rounded-md hover:bg-accent"
-        aria-label="Previous month"
+        [attr.aria-label]="previousMonthText()"
         (click)="changeMonth(-1)"
       >
         <svg
@@ -14447,7 +15148,7 @@ class BuiCalendar {
       @if (months() === 1 && captionLayout() === 'dropdown') {
         <div class="flex items-center gap-1">
           <select
-            aria-label="Month"
+            [attr.aria-label]="monthText()"
             class="rounded-md border-0 bg-transparent py-1 text-sm font-medium outline-none focus-visible:ring-[3px] focus-visible:ring-ring/50"
             [value]="viewMonth()"
             (change)="setMonth($event)"
@@ -14457,7 +15158,7 @@ class BuiCalendar {
             }
           </select>
           <select
-            aria-label="Year"
+            [attr.aria-label]="yearText()"
             class="rounded-md border-0 bg-transparent py-1 text-sm font-medium outline-none focus-visible:ring-[3px] focus-visible:ring-ring/50"
             [value]="viewYear()"
             (change)="setYear($event)"
@@ -14475,7 +15176,7 @@ class BuiCalendar {
       <button
         type="button"
         class="inline-flex size-7 items-center justify-center rounded-md hover:bg-accent"
-        aria-label="Next month"
+        [attr.aria-label]="nextMonthText()"
         (click)="changeMonth(1)"
       >
         <svg
@@ -14562,7 +15263,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
       <button
         type="button"
         class="inline-flex size-7 items-center justify-center rounded-md hover:bg-accent"
-        aria-label="Previous month"
+        [attr.aria-label]="previousMonthText()"
         (click)="changeMonth(-1)"
       >
         <svg
@@ -14581,7 +15282,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
       @if (months() === 1 && captionLayout() === 'dropdown') {
         <div class="flex items-center gap-1">
           <select
-            aria-label="Month"
+            [attr.aria-label]="monthText()"
             class="rounded-md border-0 bg-transparent py-1 text-sm font-medium outline-none focus-visible:ring-[3px] focus-visible:ring-ring/50"
             [value]="viewMonth()"
             (change)="setMonth($event)"
@@ -14591,7 +15292,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
             }
           </select>
           <select
-            aria-label="Year"
+            [attr.aria-label]="yearText()"
             class="rounded-md border-0 bg-transparent py-1 text-sm font-medium outline-none focus-visible:ring-[3px] focus-visible:ring-ring/50"
             [value]="viewYear()"
             (change)="setYear($event)"
@@ -14609,7 +15310,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
       <button
         type="button"
         class="inline-flex size-7 items-center justify-center rounded-md hover:bg-accent"
-        aria-label="Next month"
+        [attr.aria-label]="nextMonthText()"
         (click)="changeMonth(1)"
       >
         <svg
@@ -14683,12 +15384,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
     </div>
   `,
                 }]
-        }], propDecorators: { value: [{ type: i0.Input, args: [{ isSignal: true, alias: "value", required: false }] }, { type: i0.Output, args: ["valueChange"] }], mode: [{ type: i0.Input, args: [{ isSignal: true, alias: "mode", required: false }] }], range: [{ type: i0.Input, args: [{ isSignal: true, alias: "range", required: false }] }, { type: i0.Output, args: ["rangeChange"] }], values: [{ type: i0.Input, args: [{ isSignal: true, alias: "values", required: false }] }, { type: i0.Output, args: ["valuesChange"] }], months: [{ type: i0.Input, args: [{ isSignal: true, alias: "months", required: false }] }], weekStart: [{ type: i0.Input, args: [{ isSignal: true, alias: "weekStart", required: false }] }], minDate: [{ type: i0.Input, args: [{ isSignal: true, alias: "minDate", required: false }] }], maxDate: [{ type: i0.Input, args: [{ isSignal: true, alias: "maxDate", required: false }] }], disabledDates: [{ type: i0.Input, args: [{ isSignal: true, alias: "disabledDates", required: false }] }], disableWeekends: [{ type: i0.Input, args: [{ isSignal: true, alias: "disableWeekends", required: false }] }], showWeekNumbers: [{ type: i0.Input, args: [{ isSignal: true, alias: "showWeekNumbers", required: false }] }], captionLayout: [{ type: i0.Input, args: [{ isSignal: true, alias: "captionLayout", required: false }] }], hideOutsideDays: [{ type: i0.Input, args: [{ isSignal: true, alias: "hideOutsideDays", required: false }] }], disabled: [{ type: i0.Input, args: [{ isSignal: true, alias: "disabled", required: false }] }, { type: i0.Output, args: ["disabledChange"] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }] } });
+        }], propDecorators: { value: [{ type: i0.Input, args: [{ isSignal: true, alias: "value", required: false }] }, { type: i0.Output, args: ["valueChange"] }], mode: [{ type: i0.Input, args: [{ isSignal: true, alias: "mode", required: false }] }], range: [{ type: i0.Input, args: [{ isSignal: true, alias: "range", required: false }] }, { type: i0.Output, args: ["rangeChange"] }], values: [{ type: i0.Input, args: [{ isSignal: true, alias: "values", required: false }] }, { type: i0.Output, args: ["valuesChange"] }], months: [{ type: i0.Input, args: [{ isSignal: true, alias: "months", required: false }] }], weekStart: [{ type: i0.Input, args: [{ isSignal: true, alias: "weekStart", required: false }] }], minDate: [{ type: i0.Input, args: [{ isSignal: true, alias: "minDate", required: false }] }], maxDate: [{ type: i0.Input, args: [{ isSignal: true, alias: "maxDate", required: false }] }], disabledDates: [{ type: i0.Input, args: [{ isSignal: true, alias: "disabledDates", required: false }] }], disableWeekends: [{ type: i0.Input, args: [{ isSignal: true, alias: "disableWeekends", required: false }] }], showWeekNumbers: [{ type: i0.Input, args: [{ isSignal: true, alias: "showWeekNumbers", required: false }] }], captionLayout: [{ type: i0.Input, args: [{ isSignal: true, alias: "captionLayout", required: false }] }], hideOutsideDays: [{ type: i0.Input, args: [{ isSignal: true, alias: "hideOutsideDays", required: false }] }], disabled: [{ type: i0.Input, args: [{ isSignal: true, alias: "disabled", required: false }] }, { type: i0.Output, args: ["disabledChange"] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }], previousMonthLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "previousMonthLabel", required: false }] }], monthSelectLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "monthSelectLabel", required: false }] }], yearLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "yearLabel", required: false }] }], nextMonthLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "nextMonthLabel", required: false }] }] } });
 
 // eslint-disable-next-line @typescript-eslint/no-empty-function
 const noop$3 = () => { };
 /** A date input that opens a calendar popover. */
 class BuiDatePicker {
+    /** Selected date (mode="single") as `yyyy-mm-dd`. Two-way bindable with `[(value)]`. */
     value = model('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "value" }] : /* istanbul ignore next */ []));
     /** `single` (default) or `range`. */
@@ -14700,24 +15402,34 @@ class BuiDatePicker {
     /** Month grids shown in the popover (handy for range). */
     months = input(1, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "months" }] : /* istanbul ignore next */ []));
+    /** Text shown on the trigger when no date is selected. */
     placeholder = input('Pick a date', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "placeholder" }] : /* istanbul ignore next */ []));
+    /** Earliest selectable date (`yyyy-mm-dd`). */
     minDate = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "minDate" }] : /* istanbul ignore next */ []));
+    /** Latest selectable date (`yyyy-mm-dd`). */
     maxDate = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "maxDate" }] : /* istanbul ignore next */ []));
+    /** First day of the week (0 = Sunday). */
     weekStart = input(0, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "weekStart" }] : /* istanbul ignore next */ []));
+    /** Specific ISO dates (yyyy-mm-dd) to disable. */
     disabledDates = input([], /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "disabledDates" }] : /* istanbul ignore next */ []));
+    /** Disable Saturdays and Sundays. */
     disableWeekends = input(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "disableWeekends" }] : /* istanbul ignore next */ []));
+    /** Show an ISO week-number column in the calendar. */
     showWeekNumbers = input(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "showWeekNumbers" }] : /* istanbul ignore next */ []));
+    /** `dropdown` swaps the month label for month + year selects. */
     captionLayout = input('label', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "captionLayout" }] : /* istanbul ignore next */ []));
+    /** Hide days that fall outside the current month. */
     hideOutsideDays = input(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "hideOutsideDays" }] : /* istanbul ignore next */ []));
+    /** Whether the picker is disabled. Two-way bindable with `[(disabled)]`. */
     disabled = model(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "disabled" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -14826,7 +15538,7 @@ class BuiDatePicker {
         />
       </div>
     }
-  `, isInline: true, dependencies: [{ kind: "component", type: BuiCalendar, selector: "bui-calendar", inputs: ["value", "mode", "range", "values", "months", "weekStart", "minDate", "maxDate", "disabledDates", "disableWeekends", "showWeekNumbers", "captionLayout", "hideOutsideDays", "disabled", "class"], outputs: ["valueChange", "rangeChange", "valuesChange", "disabledChange"] }] });
+  `, isInline: true, dependencies: [{ kind: "component", type: BuiCalendar, selector: "bui-calendar", inputs: ["value", "mode", "range", "values", "months", "weekStart", "minDate", "maxDate", "disabledDates", "disableWeekends", "showWeekNumbers", "captionLayout", "hideOutsideDays", "disabled", "class", "previousMonthLabel", "monthSelectLabel", "yearLabel", "nextMonthLabel"], outputs: ["valueChange", "rangeChange", "valuesChange", "disabledChange"] }] });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImport: i0, type: BuiDatePicker, decorators: [{
             type: Component,
@@ -14890,14 +15602,28 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** A slide carousel. Project slides as direct children; arrows + dots navigate. SSR-safe. */
 class BuiCarousel {
+    /** Zero-based index of the first visible slide; two-way bindable. */
     index = model(0, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "index" }] : /* istanbul ignore next */ []));
+    /** Scroll axis of the carousel. */
     orientation = input('horizontal', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "orientation" }] : /* istanbul ignore next */ []));
     /** Slides visible at once (e.g. 2 or 3 for a multi-item carousel). */
     perView = input(1, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "perView" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
+    /** Accessible label override for the previous-slide button. */
+    previousLabel = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "previousLabel" }] : /* istanbul ignore next */ []));
+    /** Accessible label override for the next-slide button. */
+    nextLabel = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "nextLabel" }] : /* istanbul ignore next */ []));
+    /** Accessible label override (prefix) for the dot navigation buttons. */
+    goToSlideLabel = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "goToSlideLabel" }] : /* istanbul ignore next */ []));
+    previousText = buiLabel('carouselPrevious', this.previousLabel);
+    nextText = buiLabel('carouselNext', this.nextLabel);
+    goToSlideText = buiLabel('carouselGoToSlide', this.goToSlideLabel);
     track = viewChild('track', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "track" }] : /* istanbul ignore next */ []));
     count = signal(0, /* @ts-ignore */
@@ -14937,7 +15663,7 @@ class BuiCarousel {
         this.index.set(Math.min(this.maxIndex(), this.index() + 1));
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.2", ngImport: i0, type: BuiCarousel, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.0.2", type: BuiCarousel, isStandalone: true, selector: "bui-carousel", inputs: { index: { classPropertyName: "index", publicName: "index", isSignal: true, isRequired: false, transformFunction: null }, orientation: { classPropertyName: "orientation", publicName: "orientation", isSignal: true, isRequired: false, transformFunction: null }, perView: { classPropertyName: "perView", publicName: "perView", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { index: "indexChange" }, host: { attributes: { "data-slot": "carousel", "role": "region", "aria-roledescription": "carousel" }, properties: { "class": "computedClass()" } }, viewQueries: [{ propertyName: "track", first: true, predicate: ["track"], descendants: true, isSignal: true }], ngImport: i0, template: `
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.0.2", type: BuiCarousel, isStandalone: true, selector: "bui-carousel", inputs: { index: { classPropertyName: "index", publicName: "index", isSignal: true, isRequired: false, transformFunction: null }, orientation: { classPropertyName: "orientation", publicName: "orientation", isSignal: true, isRequired: false, transformFunction: null }, perView: { classPropertyName: "perView", publicName: "perView", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null }, previousLabel: { classPropertyName: "previousLabel", publicName: "previousLabel", isSignal: true, isRequired: false, transformFunction: null }, nextLabel: { classPropertyName: "nextLabel", publicName: "nextLabel", isSignal: true, isRequired: false, transformFunction: null }, goToSlideLabel: { classPropertyName: "goToSlideLabel", publicName: "goToSlideLabel", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { index: "indexChange" }, host: { attributes: { "data-slot": "carousel", "role": "region", "aria-roledescription": "carousel" }, properties: { "class": "computedClass()" } }, viewQueries: [{ propertyName: "track", first: true, predicate: ["track"], descendants: true, isSignal: true }], ngImport: i0, template: `
     <div [class]="viewportClass()">
       <div
         #track
@@ -14952,7 +15678,7 @@ class BuiCarousel {
       type="button"
       [class]="prevClass()"
       [disabled]="index() === 0"
-      aria-label="Previous slide"
+      [attr.aria-label]="previousText()"
       (click)="prev()"
     >
       <svg
@@ -14972,7 +15698,7 @@ class BuiCarousel {
       type="button"
       [class]="nextClass()"
       [disabled]="index() >= maxIndex()"
-      aria-label="Next slide"
+      [attr.aria-label]="nextText()"
       (click)="next()"
     >
       <svg
@@ -14995,7 +15721,7 @@ class BuiCarousel {
             type="button"
             class="size-2 rounded-full transition-colors"
             [class]="dot === index() ? 'bg-primary' : 'bg-muted'"
-            [attr.aria-label]="'Go to slide ' + (dot + 1)"
+            [attr.aria-label]="goToSlideText() + ' ' + (dot + 1)"
             [attr.aria-current]="dot === index() ? 'true' : null"
             (click)="index.set(dot)"
           ></button>
@@ -15029,7 +15755,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
       type="button"
       [class]="prevClass()"
       [disabled]="index() === 0"
-      aria-label="Previous slide"
+      [attr.aria-label]="previousText()"
       (click)="prev()"
     >
       <svg
@@ -15049,7 +15775,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
       type="button"
       [class]="nextClass()"
       [disabled]="index() >= maxIndex()"
-      aria-label="Next slide"
+      [attr.aria-label]="nextText()"
       (click)="next()"
     >
       <svg
@@ -15072,7 +15798,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
             type="button"
             class="size-2 rounded-full transition-colors"
             [class]="dot === index() ? 'bg-primary' : 'bg-muted'"
-            [attr.aria-label]="'Go to slide ' + (dot + 1)"
+            [attr.aria-label]="goToSlideText() + ' ' + (dot + 1)"
             [attr.aria-current]="dot === index() ? 'true' : null"
             (click)="index.set(dot)"
           ></button>
@@ -15081,17 +15807,20 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
     }
   `,
                 }]
-        }], ctorParameters: () => [], propDecorators: { index: [{ type: i0.Input, args: [{ isSignal: true, alias: "index", required: false }] }, { type: i0.Output, args: ["indexChange"] }], orientation: [{ type: i0.Input, args: [{ isSignal: true, alias: "orientation", required: false }] }], perView: [{ type: i0.Input, args: [{ isSignal: true, alias: "perView", required: false }] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }], track: [{ type: i0.ViewChild, args: ['track', { isSignal: true }] }] } });
+        }], ctorParameters: () => [], propDecorators: { index: [{ type: i0.Input, args: [{ isSignal: true, alias: "index", required: false }] }, { type: i0.Output, args: ["indexChange"] }], orientation: [{ type: i0.Input, args: [{ isSignal: true, alias: "orientation", required: false }] }], perView: [{ type: i0.Input, args: [{ isSignal: true, alias: "perView", required: false }] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }], previousLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "previousLabel", required: false }] }], nextLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "nextLabel", required: false }] }], goToSlideLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "goToSlideLabel", required: false }] }], track: [{ type: i0.ViewChild, args: ['track', { isSignal: true }] }] } });
 
 /** A command palette: a filterable, keyboard-navigable list of grouped actions. */
 class BuiCommand {
+    /** Grouped commands shown in the palette and filtered as the user types. */
     groups = input([], /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "groups" }] : /* istanbul ignore next */ []));
+    /** Placeholder text for the search input. */
     placeholder = input('Type a command or search…', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "placeholder" }] : /* istanbul ignore next */ []));
     /** Render a checkmark column; activating an item toggles its checked state. */
     checkable = input(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "checkable" }] : /* istanbul ignore next */ []));
+    /** Emits the chosen command when an item is activated (click or Enter). */
     selected = output();
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
     checkedValues = signal(new Set(), /* @ts-ignore */
@@ -15334,8 +16063,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** A right-click context menu. Project the target; pass menu `items`. */
 class BuiContextMenu {
+    /** Items shown in the menu, in display order. */
     items = input([], /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "items" }] : /* istanbul ignore next */ []));
+    /** Emits the chosen item when a (non-separator) entry is activated. */
     selected = output();
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
     open = signal(false, /* @ts-ignore */
@@ -15592,19 +16323,37 @@ function cellText(value) {
 }
 /** A data table with search, sortable columns, row selection and pagination. */
 class BuiDataTable {
+    /** Column definitions that drive the headers, cell lookup and sort/search keys. */
     columns = input([], /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "columns" }] : /* istanbul ignore next */ []));
+    /** Source data rows; each is a key/value map indexed by column keys. */
     rows = input([], /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "rows" }] : /* istanbul ignore next */ []));
+    /** Whether to show the search box that filters rows across all columns. */
     searchable = input(true, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "searchable" }] : /* istanbul ignore next */ []));
+    /** Placeholder text for the search input. */
     searchPlaceholder = input('Search...', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "searchPlaceholder" }] : /* istanbul ignore next */ []));
+    /** Whether to render row checkboxes and the select-all header checkbox. */
     selectable = input(true, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "selectable" }] : /* istanbul ignore next */ []));
+    /** Number of rows displayed per page. */
     pageSize = input(5, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "pageSize" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
+    /** Accessible label override for the search input. */
+    searchLabel = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "searchLabel" }] : /* istanbul ignore next */ []));
+    /** Accessible label override for the select-all checkbox. */
+    selectAllLabel = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "selectAllLabel" }] : /* istanbul ignore next */ []));
+    /** Accessible label override for each row's select checkbox. */
+    selectRowLabel = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "selectRowLabel" }] : /* istanbul ignore next */ []));
+    searchText = buiLabel('dataTableSearch', this.searchLabel);
+    selectAllText = buiLabel('dataTableSelectAll', this.selectAllLabel);
+    selectRowText = buiLabel('dataTableSelectRow', this.selectRowLabel);
     query = signal('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "query" }] : /* istanbul ignore next */ []));
     sortKey = signal('', /* @ts-ignore */
@@ -15690,14 +16439,14 @@ class BuiDataTable {
         this.selectedRows.set(isChecked ? new Set(this.filtered()) : new Set());
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.2", ngImport: i0, type: BuiDataTable, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.0.2", type: BuiDataTable, isStandalone: true, selector: "bui-data-table", inputs: { columns: { classPropertyName: "columns", publicName: "columns", isSignal: true, isRequired: false, transformFunction: null }, rows: { classPropertyName: "rows", publicName: "rows", isSignal: true, isRequired: false, transformFunction: null }, searchable: { classPropertyName: "searchable", publicName: "searchable", isSignal: true, isRequired: false, transformFunction: null }, searchPlaceholder: { classPropertyName: "searchPlaceholder", publicName: "searchPlaceholder", isSignal: true, isRequired: false, transformFunction: null }, selectable: { classPropertyName: "selectable", publicName: "selectable", isSignal: true, isRequired: false, transformFunction: null }, pageSize: { classPropertyName: "pageSize", publicName: "pageSize", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null } }, host: { attributes: { "data-slot": "data-table" }, properties: { "class": "computedClass()" } }, ngImport: i0, template: `
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.0.2", type: BuiDataTable, isStandalone: true, selector: "bui-data-table", inputs: { columns: { classPropertyName: "columns", publicName: "columns", isSignal: true, isRequired: false, transformFunction: null }, rows: { classPropertyName: "rows", publicName: "rows", isSignal: true, isRequired: false, transformFunction: null }, searchable: { classPropertyName: "searchable", publicName: "searchable", isSignal: true, isRequired: false, transformFunction: null }, searchPlaceholder: { classPropertyName: "searchPlaceholder", publicName: "searchPlaceholder", isSignal: true, isRequired: false, transformFunction: null }, selectable: { classPropertyName: "selectable", publicName: "selectable", isSignal: true, isRequired: false, transformFunction: null }, pageSize: { classPropertyName: "pageSize", publicName: "pageSize", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null }, searchLabel: { classPropertyName: "searchLabel", publicName: "searchLabel", isSignal: true, isRequired: false, transformFunction: null }, selectAllLabel: { classPropertyName: "selectAllLabel", publicName: "selectAllLabel", isSignal: true, isRequired: false, transformFunction: null }, selectRowLabel: { classPropertyName: "selectRowLabel", publicName: "selectRowLabel", isSignal: true, isRequired: false, transformFunction: null } }, host: { attributes: { "data-slot": "data-table" }, properties: { "class": "computedClass()" } }, ngImport: i0, template: `
     @if (searchable()) {
       <input
         type="search"
         [value]="query()"
         [placeholder]="searchPlaceholder()"
         class="mb-3 h-9 w-full max-w-xs rounded-md border border-input bg-transparent px-3 text-sm shadow-xs outline-none focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/50"
-        aria-label="Search"
+        [attr.aria-label]="searchText()"
         (input)="onSearch($event)"
       />
     }
@@ -15711,7 +16460,7 @@ class BuiDataTable {
                   type="checkbox"
                   [checked]="allSelected()"
                   [indeterminate]="someSelected()"
-                  aria-label="Select all rows"
+                  [attr.aria-label]="selectAllText()"
                   (change)="toggleAll($event)"
                 />
               </th>
@@ -15744,7 +16493,7 @@ class BuiDataTable {
                   <input
                     type="checkbox"
                     [checked]="isSelected(row)"
-                    aria-label="Select row"
+                    [attr.aria-label]="selectRowText()"
                     (change)="toggleRow(row)"
                   />
                 </td>
@@ -15803,7 +16552,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
         [value]="query()"
         [placeholder]="searchPlaceholder()"
         class="mb-3 h-9 w-full max-w-xs rounded-md border border-input bg-transparent px-3 text-sm shadow-xs outline-none focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/50"
-        aria-label="Search"
+        [attr.aria-label]="searchText()"
         (input)="onSearch($event)"
       />
     }
@@ -15817,7 +16566,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
                   type="checkbox"
                   [checked]="allSelected()"
                   [indeterminate]="someSelected()"
-                  aria-label="Select all rows"
+                  [attr.aria-label]="selectAllText()"
                   (change)="toggleAll($event)"
                 />
               </th>
@@ -15850,7 +16599,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
                   <input
                     type="checkbox"
                     [checked]="isSelected(row)"
-                    aria-label="Select row"
+                    [attr.aria-label]="selectRowText()"
                     (change)="toggleRow(row)"
                   />
                 </td>
@@ -15897,21 +16646,26 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
     </div>
   `,
                 }]
-        }], propDecorators: { columns: [{ type: i0.Input, args: [{ isSignal: true, alias: "columns", required: false }] }], rows: [{ type: i0.Input, args: [{ isSignal: true, alias: "rows", required: false }] }], searchable: [{ type: i0.Input, args: [{ isSignal: true, alias: "searchable", required: false }] }], searchPlaceholder: [{ type: i0.Input, args: [{ isSignal: true, alias: "searchPlaceholder", required: false }] }], selectable: [{ type: i0.Input, args: [{ isSignal: true, alias: "selectable", required: false }] }], pageSize: [{ type: i0.Input, args: [{ isSignal: true, alias: "pageSize", required: false }] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }] } });
+        }], propDecorators: { columns: [{ type: i0.Input, args: [{ isSignal: true, alias: "columns", required: false }] }], rows: [{ type: i0.Input, args: [{ isSignal: true, alias: "rows", required: false }] }], searchable: [{ type: i0.Input, args: [{ isSignal: true, alias: "searchable", required: false }] }], searchPlaceholder: [{ type: i0.Input, args: [{ isSignal: true, alias: "searchPlaceholder", required: false }] }], selectable: [{ type: i0.Input, args: [{ isSignal: true, alias: "selectable", required: false }] }], pageSize: [{ type: i0.Input, args: [{ isSignal: true, alias: "pageSize", required: false }] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }], searchLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "searchLabel", required: false }] }], selectAllLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "selectAllLabel", required: false }] }], selectRowLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "selectRowLabel", required: false }] }] } });
 
 const PALETTE = ['#6366f1', '#22c55e', '#f59e0b', '#ec4899', '#06b6d4'];
 const WIDTH = 600;
 const PAD = 8;
 /** A lightweight SVG chart (line / area / bar). Pure + SSR-safe. */
 class BuiChart {
+    /** Chart render style: line, bar, or filled area. */
     type = input('line', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "type" }] : /* istanbul ignore next */ []));
+    /** Series to plot; bar charts use only the first series. */
     series = input([], /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "series" }] : /* istanbul ignore next */ []));
+    /** X-axis tick labels rendered below the chart. */
     labels = input([], /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "labels" }] : /* istanbul ignore next */ []));
+    /** Chart height in pixels (SVG viewBox height). */
     height = input(220, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "height" }] : /* istanbul ignore next */ []));
+    /** Accessible label for the chart's `aria-label`. */
     label = input('Chart', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "label" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -16068,6 +16822,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 const noop$2 = () => { };
 /** A combined date + time picker in a popover. Value is `YYYY-MM-DDTHH:mm`. */
 class BuiDatetimePicker {
+    /** Selected date-time (mode="single") as `YYYY-MM-DDTHH:mm`. Two-way bindable with `[(value)]`. */
     value = model('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "value" }] : /* istanbul ignore next */ []));
     /** `single` (default) or `range`. */
@@ -16079,16 +16834,22 @@ class BuiDatetimePicker {
     /** Month grids shown in the popover (handy for range). */
     months = input(1, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "months" }] : /* istanbul ignore next */ []));
+    /** Text shown on the trigger when nothing is selected. */
     placeholder = input('Pick date & time', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "placeholder" }] : /* istanbul ignore next */ []));
+    /** Earliest selectable date (`yyyy-mm-dd`). */
     minDate = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "minDate" }] : /* istanbul ignore next */ []));
+    /** Latest selectable date (`yyyy-mm-dd`). */
     maxDate = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "maxDate" }] : /* istanbul ignore next */ []));
+    /** `dropdown` swaps the month label for month + year selects. */
     captionLayout = input('label', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "captionLayout" }] : /* istanbul ignore next */ []));
+    /** Whether to include seconds in the time field. */
     seconds = input(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "seconds" }] : /* istanbul ignore next */ []));
+    /** Whether the picker is disabled. Two-way bindable with `[(disabled)]`. */
     disabled = model(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "disabled" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -16237,7 +16998,7 @@ class BuiDatetimePicker {
         </div>
       </div>
     }
-  `, isInline: true, dependencies: [{ kind: "component", type: BuiCalendar, selector: "bui-calendar", inputs: ["value", "mode", "range", "values", "months", "weekStart", "minDate", "maxDate", "disabledDates", "disableWeekends", "showWeekNumbers", "captionLayout", "hideOutsideDays", "disabled", "class"], outputs: ["valueChange", "rangeChange", "valuesChange", "disabledChange"] }, { kind: "component", type: BuiTimeField, selector: "bui-time-field", inputs: ["value", "name", "id", "min", "max", "seconds", "disabled", "mode", "minuteStep", "ariaLabel", "class"], outputs: ["valueChange", "disabledChange"] }] });
+  `, isInline: true, dependencies: [{ kind: "component", type: BuiCalendar, selector: "bui-calendar", inputs: ["value", "mode", "range", "values", "months", "weekStart", "minDate", "maxDate", "disabledDates", "disableWeekends", "showWeekNumbers", "captionLayout", "hideOutsideDays", "disabled", "class", "previousMonthLabel", "monthSelectLabel", "yearLabel", "nextMonthLabel"], outputs: ["valueChange", "rangeChange", "valuesChange", "disabledChange"] }, { kind: "component", type: BuiTimeField, selector: "bui-time-field", inputs: ["value", "name", "id", "min", "max", "seconds", "disabled", "mode", "minuteStep", "ariaLabel", "class"], outputs: ["valueChange", "disabledChange"] }] });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImport: i0, type: BuiDatetimePicker, decorators: [{
             type: Component,
@@ -16319,23 +17080,31 @@ const AC_SIZE = {
 };
 /** A free-text input with a filtered suggestion list. */
 class BuiAutocomplete {
+    /** Current text in the input. Two-way bindable with `[(value)]`. */
     value = model('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "value" }] : /* istanbul ignore next */ []));
     /** Pick several values, shown as removable chips; binds `values`. */
     multiple = input(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "multiple" }] : /* istanbul ignore next */ []));
+    /** Selected values shown as chips (multiple mode). Two-way bindable with `[(values)]`. */
     values = model([], /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "values" }] : /* istanbul ignore next */ []));
+    /** Suggestions to filter against the typed text. */
     options = input([], /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "options" }] : /* istanbul ignore next */ []));
+    /** Placeholder text for the input. */
     placeholder = input('Search...', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "placeholder" }] : /* istanbul ignore next */ []));
+    /** Message shown when no suggestion matches. */
     empty = input('No results found.', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "empty" }] : /* istanbul ignore next */ []));
+    /** Whether the input is disabled. Two-way bindable with `[(disabled)]`. */
     disabled = model(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "disabled" }] : /* istanbul ignore next */ []));
+    /** Native `name` attribute for the input. */
     name = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "name" }] : /* istanbul ignore next */ []));
+    /** Height and font size of the input. */
     size = input('default', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "size" }] : /* istanbul ignore next */ []));
     /** Optional leading icon, given as an SVG path `d` string. */
@@ -16671,21 +17440,32 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** A before/after image comparison with a draggable, keyboard-operable divider. */
 class BuiComparisonSlider {
+    /** Source URL of the "before" image (revealed on the left of the divider). */
     before = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "before" }] : /* istanbul ignore next */ []));
+    /** Source URL of the "after" image (shown on the right of the divider). */
     after = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "after" }] : /* istanbul ignore next */ []));
+    /** Caption badge shown over the "before" image; hidden when empty. */
     beforeLabel = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "beforeLabel" }] : /* istanbul ignore next */ []));
+    /** Caption badge shown over the "after" image; hidden when empty. */
     afterLabel = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "afterLabel" }] : /* istanbul ignore next */ []));
+    /** Alt text for the "before" image. */
     beforeAlt = input('Before', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "beforeAlt" }] : /* istanbul ignore next */ []));
+    /** Alt text for the "after" image. */
     afterAlt = input('After', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "afterAlt" }] : /* istanbul ignore next */ []));
+    /** Divider position as a percentage (0-100); two-way bindable. */
     value = model(50, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "value" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
+    /** Accessible label override for the range slider. */
+    positionLabel = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "positionLabel" }] : /* istanbul ignore next */ []));
+    positionText = buiLabel('comparisonSliderPosition', this.positionLabel);
     clip = computed(() => `inset(0 ${100 - this.value()}% 0 0)`, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "clip" }] : /* istanbul ignore next */ []));
     computedClass = computed(() => cn('block', this.userClass()), /* @ts-ignore */
@@ -16694,7 +17474,7 @@ class BuiComparisonSlider {
         this.value.set(Number(event.target.value));
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.2", ngImport: i0, type: BuiComparisonSlider, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.0.2", type: BuiComparisonSlider, isStandalone: true, selector: "bui-comparison-slider", inputs: { before: { classPropertyName: "before", publicName: "before", isSignal: true, isRequired: false, transformFunction: null }, after: { classPropertyName: "after", publicName: "after", isSignal: true, isRequired: false, transformFunction: null }, beforeLabel: { classPropertyName: "beforeLabel", publicName: "beforeLabel", isSignal: true, isRequired: false, transformFunction: null }, afterLabel: { classPropertyName: "afterLabel", publicName: "afterLabel", isSignal: true, isRequired: false, transformFunction: null }, beforeAlt: { classPropertyName: "beforeAlt", publicName: "beforeAlt", isSignal: true, isRequired: false, transformFunction: null }, afterAlt: { classPropertyName: "afterAlt", publicName: "afterAlt", isSignal: true, isRequired: false, transformFunction: null }, value: { classPropertyName: "value", publicName: "value", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { value: "valueChange" }, host: { attributes: { "data-slot": "comparison-slider" }, properties: { "class": "computedClass()" } }, ngImport: i0, template: `
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.0.2", type: BuiComparisonSlider, isStandalone: true, selector: "bui-comparison-slider", inputs: { before: { classPropertyName: "before", publicName: "before", isSignal: true, isRequired: false, transformFunction: null }, after: { classPropertyName: "after", publicName: "after", isSignal: true, isRequired: false, transformFunction: null }, beforeLabel: { classPropertyName: "beforeLabel", publicName: "beforeLabel", isSignal: true, isRequired: false, transformFunction: null }, afterLabel: { classPropertyName: "afterLabel", publicName: "afterLabel", isSignal: true, isRequired: false, transformFunction: null }, beforeAlt: { classPropertyName: "beforeAlt", publicName: "beforeAlt", isSignal: true, isRequired: false, transformFunction: null }, afterAlt: { classPropertyName: "afterAlt", publicName: "afterAlt", isSignal: true, isRequired: false, transformFunction: null }, value: { classPropertyName: "value", publicName: "value", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null }, positionLabel: { classPropertyName: "positionLabel", publicName: "positionLabel", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { value: "valueChange" }, host: { attributes: { "data-slot": "comparison-slider" }, properties: { "class": "computedClass()" } }, ngImport: i0, template: `
     <div class="relative overflow-hidden rounded-lg select-none">
       <img [src]="after()" [alt]="afterAlt()" class="block w-full" draggable="false" />
       <div class="absolute inset-0 overflow-hidden" [style.clip-path]="clip()">
@@ -16724,7 +17504,7 @@ class BuiComparisonSlider {
         min="0"
         max="100"
         [value]="value()"
-        aria-label="Comparison position"
+        [attr.aria-label]="positionText()"
         class="absolute inset-0 size-full cursor-ew-resize opacity-0"
         (input)="onInput($event)"
       />
@@ -16766,14 +17546,14 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
         min="0"
         max="100"
         [value]="value()"
-        aria-label="Comparison position"
+        [attr.aria-label]="positionText()"
         class="absolute inset-0 size-full cursor-ew-resize opacity-0"
         (input)="onInput($event)"
       />
     </div>
   `,
                 }]
-        }], propDecorators: { before: [{ type: i0.Input, args: [{ isSignal: true, alias: "before", required: false }] }], after: [{ type: i0.Input, args: [{ isSignal: true, alias: "after", required: false }] }], beforeLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "beforeLabel", required: false }] }], afterLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "afterLabel", required: false }] }], beforeAlt: [{ type: i0.Input, args: [{ isSignal: true, alias: "beforeAlt", required: false }] }], afterAlt: [{ type: i0.Input, args: [{ isSignal: true, alias: "afterAlt", required: false }] }], value: [{ type: i0.Input, args: [{ isSignal: true, alias: "value", required: false }] }, { type: i0.Output, args: ["valueChange"] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }] } });
+        }], propDecorators: { before: [{ type: i0.Input, args: [{ isSignal: true, alias: "before", required: false }] }], after: [{ type: i0.Input, args: [{ isSignal: true, alias: "after", required: false }] }], beforeLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "beforeLabel", required: false }] }], afterLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "afterLabel", required: false }] }], beforeAlt: [{ type: i0.Input, args: [{ isSignal: true, alias: "beforeAlt", required: false }] }], afterAlt: [{ type: i0.Input, args: [{ isSignal: true, alias: "afterAlt", required: false }] }], value: [{ type: i0.Input, args: [{ isSignal: true, alias: "value", required: false }] }, { type: i0.Output, args: ["valueChange"] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }], positionLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "positionLabel", required: false }] }] } });
 
 function formatSize(bytes) {
     if (bytes < 1024) {
@@ -16786,18 +17566,32 @@ function formatSize(bytes) {
 }
 /** A drag-and-drop file upload zone with a selected-files list. */
 class BuiFileUpload {
+    /** Whether multiple files can be selected and accumulated. */
     multiple = input(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "multiple" }] : /* istanbul ignore next */ []));
+    /** Comma-separated list of accepted file types (the `accept` attribute). */
     accept = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "accept" }] : /* istanbul ignore next */ []));
+    /** Native `name` attribute for the file input. */
     name = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "name" }] : /* istanbul ignore next */ []));
+    /** Optional helper text shown under the dropzone label. */
     hint = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "hint" }] : /* istanbul ignore next */ []));
+    /** Whether the upload zone is disabled. */
     disabled = input(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "disabled" }] : /* istanbul ignore next */ []));
+    /** Emitted with the current file list whenever the selection changes. */
     filesChange = output();
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
+    /** Custom dropzone prompt text. */
+    dropzoneLabel = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "dropzoneLabel" }] : /* istanbul ignore next */ []));
+    /** Custom accessible label for each remove button. */
+    removeLabel = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "removeLabel" }] : /* istanbul ignore next */ []));
+    dropzoneText = buiLabel('fileUploadDropzone', this.dropzoneLabel);
+    removeText = buiLabel('fileUploadRemove', this.removeLabel);
     dragging = signal(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "dragging" }] : /* istanbul ignore next */ []));
     files = signal([], /* @ts-ignore */
@@ -16825,7 +17619,7 @@ class BuiFileUpload {
         this.filesChange.emit(next);
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.2", ngImport: i0, type: BuiFileUpload, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.0.2", type: BuiFileUpload, isStandalone: true, selector: "bui-file-upload", inputs: { multiple: { classPropertyName: "multiple", publicName: "multiple", isSignal: true, isRequired: false, transformFunction: null }, accept: { classPropertyName: "accept", publicName: "accept", isSignal: true, isRequired: false, transformFunction: null }, name: { classPropertyName: "name", publicName: "name", isSignal: true, isRequired: false, transformFunction: null }, hint: { classPropertyName: "hint", publicName: "hint", isSignal: true, isRequired: false, transformFunction: null }, disabled: { classPropertyName: "disabled", publicName: "disabled", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { filesChange: "filesChange" }, host: { attributes: { "data-slot": "file-upload" }, properties: { "class": "computedClass()" } }, ngImport: i0, template: `
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.0.2", type: BuiFileUpload, isStandalone: true, selector: "bui-file-upload", inputs: { multiple: { classPropertyName: "multiple", publicName: "multiple", isSignal: true, isRequired: false, transformFunction: null }, accept: { classPropertyName: "accept", publicName: "accept", isSignal: true, isRequired: false, transformFunction: null }, name: { classPropertyName: "name", publicName: "name", isSignal: true, isRequired: false, transformFunction: null }, hint: { classPropertyName: "hint", publicName: "hint", isSignal: true, isRequired: false, transformFunction: null }, disabled: { classPropertyName: "disabled", publicName: "disabled", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null }, dropzoneLabel: { classPropertyName: "dropzoneLabel", publicName: "dropzoneLabel", isSignal: true, isRequired: false, transformFunction: null }, removeLabel: { classPropertyName: "removeLabel", publicName: "removeLabel", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { filesChange: "filesChange" }, host: { attributes: { "data-slot": "file-upload" }, properties: { "class": "computedClass()" } }, ngImport: i0, template: `
     <label [class]="zoneClass()">
       <input
         type="file"
@@ -16848,7 +17642,7 @@ class BuiFileUpload {
       >
         <path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4M17 8l-5-5-5 5M12 3v12" />
       </svg>
-      <span class="text-sm font-medium">Click to upload or drag &amp; drop</span>
+      <span class="text-sm font-medium">{{ dropzoneText() }}</span>
       @if (hint()) {
         <span class="text-xs text-muted-foreground">{{ hint() }}</span>
       }
@@ -16877,7 +17671,7 @@ class BuiFileUpload {
             <button
               type="button"
               class="rounded-sm p-1 hover:bg-accent"
-              aria-label="Remove file"
+              [attr.aria-label]="removeText()"
               (click)="remove(file)"
             >
               <svg
@@ -16927,7 +17721,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
       >
         <path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4M17 8l-5-5-5 5M12 3v12" />
       </svg>
-      <span class="text-sm font-medium">Click to upload or drag &amp; drop</span>
+      <span class="text-sm font-medium">{{ dropzoneText() }}</span>
       @if (hint()) {
         <span class="text-xs text-muted-foreground">{{ hint() }}</span>
       }
@@ -16956,7 +17750,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
             <button
               type="button"
               class="rounded-sm p-1 hover:bg-accent"
-              aria-label="Remove file"
+              [attr.aria-label]="removeText()"
               (click)="remove(file)"
             >
               <svg
@@ -16978,20 +17772,27 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
     }
   `,
                 }]
-        }], propDecorators: { multiple: [{ type: i0.Input, args: [{ isSignal: true, alias: "multiple", required: false }] }], accept: [{ type: i0.Input, args: [{ isSignal: true, alias: "accept", required: false }] }], name: [{ type: i0.Input, args: [{ isSignal: true, alias: "name", required: false }] }], hint: [{ type: i0.Input, args: [{ isSignal: true, alias: "hint", required: false }] }], disabled: [{ type: i0.Input, args: [{ isSignal: true, alias: "disabled", required: false }] }], filesChange: [{ type: i0.Output, args: ["filesChange"] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }] } });
+        }], propDecorators: { multiple: [{ type: i0.Input, args: [{ isSignal: true, alias: "multiple", required: false }] }], accept: [{ type: i0.Input, args: [{ isSignal: true, alias: "accept", required: false }] }], name: [{ type: i0.Input, args: [{ isSignal: true, alias: "name", required: false }] }], hint: [{ type: i0.Input, args: [{ isSignal: true, alias: "hint", required: false }] }], disabled: [{ type: i0.Input, args: [{ isSignal: true, alias: "disabled", required: false }] }], filesChange: [{ type: i0.Output, args: ["filesChange"] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }], dropzoneLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "dropzoneLabel", required: false }] }], removeLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "removeLabel", required: false }] }] } });
 
 /**
  * An NProgress-style top loading bar. Drive it with `start()` / `set(0..1)` / `done()`,
  * or with `top-progress:start` / `top-progress:set` / `top-progress:done` window events.
  */
 class BuiTopProgress {
+    /** CSS color (or gradient) used to fill the bar. */
     color = input('var(--color-primary, #6366f1)', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "color" }] : /* istanbul ignore next */ []));
+    /** Bar thickness in pixels. */
     height = input(2, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "height" }] : /* istanbul ignore next */ []));
+    /** When true, renders inline within its container instead of fixed at the top of the viewport. */
     demo = input(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "demo" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
+    /** Overrides the localized accessible progressbar label. */
+    ariaLabel = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "ariaLabel" }] : /* istanbul ignore next */ []));
+    ariaLabelText = buiLabel('topProgressLoading', this.ariaLabel);
     progress = signal(0, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "progress" }] : /* istanbul ignore next */ []));
     visible = signal(false, /* @ts-ignore */
@@ -17059,7 +17860,7 @@ class BuiTopProgress {
         this.timer = undefined;
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.2", ngImport: i0, type: BuiTopProgress, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.1.0", version: "22.0.2", type: BuiTopProgress, isStandalone: true, selector: "bui-top-progress", inputs: { color: { classPropertyName: "color", publicName: "color", isSignal: true, isRequired: false, transformFunction: null }, height: { classPropertyName: "height", publicName: "height", isSignal: true, isRequired: false, transformFunction: null }, demo: { classPropertyName: "demo", publicName: "demo", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null } }, host: { attributes: { "data-slot": "top-progress", "role": "progressbar", "aria-label": "Page loading" }, properties: { "class": "computedClass()", "style.height.px": "height()", "attr.aria-valuenow": "visible() ? round(progress() * 100) : null" } }, ngImport: i0, template: `
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.1.0", version: "22.0.2", type: BuiTopProgress, isStandalone: true, selector: "bui-top-progress", inputs: { color: { classPropertyName: "color", publicName: "color", isSignal: true, isRequired: false, transformFunction: null }, height: { classPropertyName: "height", publicName: "height", isSignal: true, isRequired: false, transformFunction: null }, demo: { classPropertyName: "demo", publicName: "demo", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null }, ariaLabel: { classPropertyName: "ariaLabel", publicName: "ariaLabel", isSignal: true, isRequired: false, transformFunction: null } }, host: { attributes: { "data-slot": "top-progress", "role": "progressbar" }, properties: { "class": "computedClass()", "style.height.px": "height()", "attr.aria-label": "ariaLabelText()", "attr.aria-valuenow": "visible() ? round(progress() * 100) : null" } }, ngImport: i0, template: `
     <div
       class="h-full transition-all duration-200 ease-out"
       [style.width.%]="visible() ? progress() * 100 : 0"
@@ -17077,7 +17878,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
                         '[class]': 'computedClass()',
                         '[style.height.px]': 'height()',
                         role: 'progressbar',
-                        'aria-label': 'Page loading',
+                        '[attr.aria-label]': 'ariaLabelText()',
                         '[attr.aria-valuenow]': 'visible() ? round(progress() * 100) : null',
                     },
                     template: `
@@ -17089,7 +17890,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
     ></div>
   `,
                 }]
-        }], ctorParameters: () => [], propDecorators: { color: [{ type: i0.Input, args: [{ isSignal: true, alias: "color", required: false }] }], height: [{ type: i0.Input, args: [{ isSignal: true, alias: "height", required: false }] }], demo: [{ type: i0.Input, args: [{ isSignal: true, alias: "demo", required: false }] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }] } });
+        }], ctorParameters: () => [], propDecorators: { color: [{ type: i0.Input, args: [{ isSignal: true, alias: "color", required: false }] }], height: [{ type: i0.Input, args: [{ isSignal: true, alias: "height", required: false }] }], demo: [{ type: i0.Input, args: [{ isSignal: true, alias: "demo", required: false }] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }], ariaLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "ariaLabel", required: false }] }] } });
 
 const POSITION$1 = {
     bottom: 'inset-x-0 bottom-0 max-h-[85vh] rounded-t-xl border-t',
@@ -17099,10 +17900,13 @@ const POSITION$1 = {
 };
 /** A slide-in panel anchored to a screen edge. Toggle with the `open` model. */
 class BuiDrawer {
+    /** Whether the drawer is open. Two-way bindable with `[(open)]`. */
     open = model(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "open" }] : /* istanbul ignore next */ []));
+    /** Screen edge the drawer is anchored to and slides in from. */
     direction = input('bottom', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "direction" }] : /* istanbul ignore next */ []));
+    /** Accessible label applied to the drawer dialog. */
     ariaLabel = input('Drawer', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "ariaLabel" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -17187,16 +17991,22 @@ function applyMask$1(value, mask) {
 }
 /** A text input that formats its value against a mask (9 = digit, a = letter, * = alnum). */
 class BuiInputMask {
+    /** Mask pattern where `9` accepts a digit, `a` a letter, `*` an alphanumeric, and other chars are literals. */
     mask = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "mask" }] : /* istanbul ignore next */ []));
+    /** Current masked value. Two-way bindable with `[(value)]`. */
     value = model('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "value" }] : /* istanbul ignore next */ []));
+    /** Placeholder text shown when the input is empty. */
     placeholder = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "placeholder" }] : /* istanbul ignore next */ []));
+    /** Value for the native `inputmode` attribute hinting the virtual keyboard. */
     inputmode = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "inputmode" }] : /* istanbul ignore next */ []));
+    /** Name attribute applied to the underlying input for form submission. */
     name = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "name" }] : /* istanbul ignore next */ []));
+    /** Whether the input is disabled. Two-way bindable with `[(disabled)]`. */
     disabled = model(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "disabled" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -17270,10 +18080,13 @@ const SIDE = {
 };
 /** A sheet overlay sliding in from a screen edge. Toggle with the `open` model. */
 class BuiSheet {
+    /** Whether the sheet is open. Two-way bindable with `[(open)]`. */
     open = model(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "open" }] : /* istanbul ignore next */ []));
+    /** Screen edge the sheet slides in from. */
     side = input('right', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "side" }] : /* istanbul ignore next */ []));
+    /** Accessible label applied to the sheet dialog. */
     ariaLabel = input('Sheet', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "ariaLabel" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -17360,8 +18173,17 @@ const TONE = {
 };
 /** The toast viewport. Drives off the {@link BuiToaster} store. */
 class BuiSonner {
+    /** Viewport corner where toasts stack (e.g. `top-left`, `bottom-right`). */
     position = input('bottom-right', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "position" }] : /* istanbul ignore next */ []));
+    /** Overrides the localized accessible label for the toast region. */
+    ariaLabel = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "ariaLabel" }] : /* istanbul ignore next */ []));
+    /** Overrides the localized accessible label for each dismiss button. */
+    dismissLabel = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "dismissLabel" }] : /* istanbul ignore next */ []));
+    ariaLabelText = buiLabel('sonner', this.ariaLabel);
+    dismissText = buiLabel('sonnerDismiss', this.dismissLabel);
     toaster = inject(BuiToaster);
     regionClass = computed(() => cn('pointer-events-none fixed z-[100] flex flex-col gap-2', POSITION[this.position()]), /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "regionClass" }] : /* istanbul ignore next */ []));
@@ -17373,8 +18195,8 @@ class BuiSonner {
         this.toaster.dismiss(toast.id);
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.2", ngImport: i0, type: BuiSonner, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.0.2", type: BuiSonner, isStandalone: true, selector: "bui-sonner", inputs: { position: { classPropertyName: "position", publicName: "position", isSignal: true, isRequired: false, transformFunction: null } }, host: { attributes: { "data-slot": "sonner" } }, ngImport: i0, template: `
-    <div role="region" aria-label="Notifications" [class]="regionClass()">
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.0.2", type: BuiSonner, isStandalone: true, selector: "bui-sonner", inputs: { position: { classPropertyName: "position", publicName: "position", isSignal: true, isRequired: false, transformFunction: null }, ariaLabel: { classPropertyName: "ariaLabel", publicName: "ariaLabel", isSignal: true, isRequired: false, transformFunction: null }, dismissLabel: { classPropertyName: "dismissLabel", publicName: "dismissLabel", isSignal: true, isRequired: false, transformFunction: null } }, host: { attributes: { "data-slot": "sonner" } }, ngImport: i0, template: `
+    <div role="region" [attr.aria-label]="ariaLabelText()" [class]="regionClass()">
       @for (toast of toaster.toasts(); track toast.id) {
         <div
           role="status"
@@ -17400,7 +18222,7 @@ class BuiSonner {
           <button
             type="button"
             class="shrink-0 opacity-70 hover:opacity-100"
-            aria-label="Dismiss notification"
+            [attr.aria-label]="dismissText()"
             (click)="toaster.dismiss(toast.id)"
           >
             <svg
@@ -17426,7 +18248,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
                     selector: 'bui-sonner',
                     host: { 'data-slot': 'sonner' },
                     template: `
-    <div role="region" aria-label="Notifications" [class]="regionClass()">
+    <div role="region" [attr.aria-label]="ariaLabelText()" [class]="regionClass()">
       @for (toast of toaster.toasts(); track toast.id) {
         <div
           role="status"
@@ -17452,7 +18274,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
           <button
             type="button"
             class="shrink-0 opacity-70 hover:opacity-100"
-            aria-label="Dismiss notification"
+            [attr.aria-label]="dismissText()"
             (click)="toaster.dismiss(toast.id)"
           >
             <svg
@@ -17472,10 +18294,11 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
     </div>
   `,
                 }]
-        }], propDecorators: { position: [{ type: i0.Input, args: [{ isSignal: true, alias: "position", required: false }] }] } });
+        }], propDecorators: { position: [{ type: i0.Input, args: [{ isSignal: true, alias: "position", required: false }] }], ariaLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "ariaLabel", required: false }] }], dismissLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "dismissLabel", required: false }] }] } });
 
 /** A horizontal navigation menu with hover/click dropdown panels. */
 class BuiNavigationMenu {
+    /** Top-level menu entries, each optionally opening a dropdown panel. */
     items = input([], /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "items" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -17650,16 +18473,22 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** A textarea that suggests mentions when you type the trigger character. */
 class BuiMentionInput {
+    /** Textarea contents. Two-way bindable with `[(value)]`. */
     value = model('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "value" }] : /* istanbul ignore next */ []));
+    /** Mentions offered when the trigger character is typed. */
     mentions = input([], /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "mentions" }] : /* istanbul ignore next */ []));
+    /** Character that opens the mention suggestion list. */
     trigger = input('@', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "trigger" }] : /* istanbul ignore next */ []));
+    /** Placeholder text for the textarea. */
     placeholder = input('Type @ to mention…', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "placeholder" }] : /* istanbul ignore next */ []));
+    /** Number of visible textarea rows. */
     rows = input(3, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "rows" }] : /* istanbul ignore next */ []));
+    /** Native `name` attribute for the textarea. */
     name = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "name" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -17796,18 +18625,25 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** A keyless OpenStreetMap embed centred on a coordinate. SSR-safe. */
 class BuiMap {
+    /** Latitude of the map centre, in degrees. */
     lat = input(50.8503, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "lat" }] : /* istanbul ignore next */ []));
+    /** Longitude of the map centre, in degrees. */
     lon = input(4.3517, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "lon" }] : /* istanbul ignore next */ []));
+    /** Zoom level; higher values zoom in closer. */
     zoom = input(14, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "zoom" }] : /* istanbul ignore next */ []));
+    /** Accessible title for the map iframe. */
     label = input('Location', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "label" }] : /* istanbul ignore next */ []));
+    /** Whether to drop a pin at the centre coordinate. */
     marker = input(true, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "marker" }] : /* istanbul ignore next */ []));
+    /** Map height in pixels; ignored when `ratio` is set. */
     height = input(320, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "height" }] : /* istanbul ignore next */ []));
+    /** CSS aspect ratio (e.g. `16/9`); overrides `height` when set. */
     ratio = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "ratio" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -17917,12 +18753,16 @@ function label(iso) {
 }
 /** A horizontal Gantt chart positioning task bars over a date range. SSR-safe. */
 class BuiGantt {
+    /** Tasks to plot as horizontal bars across the date range. */
     tasks = input([], /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "tasks" }] : /* istanbul ignore next */ []));
+    /** Milestones to plot as diamond markers below the task bars. */
     milestones = input([], /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "milestones" }] : /* istanbul ignore next */ []));
+    /** ISO start date overriding the computed range minimum; empty derives it from tasks. */
     start = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "start" }] : /* istanbul ignore next */ []));
+    /** ISO end date overriding the computed range maximum; empty derives it from tasks. */
     end = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "end" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -18083,16 +18923,22 @@ function toMinutes(value) {
 }
 /** A week/day calendar grid with positioned events. SSR-safe. */
 class BuiScheduler {
+    /** Events to position within the calendar grid. */
     events = input([], /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "events" }] : /* istanbul ignore next */ []));
+    /** Custom day-column headers; empty falls back to weekday names or `Today`. */
     days = input([], /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "days" }] : /* istanbul ignore next */ []));
+    /** First hour shown on the time axis (24-hour). */
     startHour = input(8, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "startHour" }] : /* istanbul ignore next */ []));
+    /** Last hour shown on the time axis (24-hour), exclusive of the final row. */
     endHour = input(18, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "endHour" }] : /* istanbul ignore next */ []));
+    /** Layout mode; `day` shows a single column, `week` shows the full week. */
     view = input('week', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "view" }] : /* istanbul ignore next */ []));
+    /** Accessible label applied to the grid's `aria-label`. */
     label = input('Schedule', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "label" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -18220,8 +19066,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** A drag-and-drop kanban board (Angular CDK drag-drop). */
 class BuiKanban {
+    /** Columns and their cards used to seed the board. */
     columns = input([], /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "columns" }] : /* istanbul ignore next */ []));
+    /** Emits the updated board whenever a card is moved. */
     changed = output();
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
     board = linkedSignal(() => this.columns().map((column) => ({ ...column, cards: [...column.cards] })), /* @ts-ignore */
@@ -18339,15 +19187,23 @@ const TOOLS = [
 ];
 /** A contenteditable rich-text editor with a basic formatting toolbar. */
 class BuiRichTextEditor {
+    /** Editor contents as HTML. Two-way bindable with `[(value)]`. */
     value = model('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "value" }] : /* istanbul ignore next */ []));
+    /** Placeholder text shown while the editor is empty. */
     placeholder = input('Write something…', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "placeholder" }] : /* istanbul ignore next */ []));
+    /** Accessible label for the editable region. */
     ariaLabel = input('Rich text editor', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "ariaLabel" }] : /* istanbul ignore next */ []));
+    /** Accessible label override for the formatting toolbar. */
+    formattingLabel = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "formattingLabel" }] : /* istanbul ignore next */ []));
+    /** Name attribute associated with the editor for form submission. */
     name = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "name" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
+    formattingText = buiLabel('richTextEditorFormatting', this.formattingLabel);
     tools = TOOLS;
     editor = viewChild('editor', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "editor" }] : /* istanbul ignore next */ []));
@@ -18377,10 +19233,10 @@ class BuiRichTextEditor {
         }
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.2", ngImport: i0, type: BuiRichTextEditor, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.0.2", type: BuiRichTextEditor, isStandalone: true, selector: "bui-rich-text-editor", inputs: { value: { classPropertyName: "value", publicName: "value", isSignal: true, isRequired: false, transformFunction: null }, placeholder: { classPropertyName: "placeholder", publicName: "placeholder", isSignal: true, isRequired: false, transformFunction: null }, ariaLabel: { classPropertyName: "ariaLabel", publicName: "ariaLabel", isSignal: true, isRequired: false, transformFunction: null }, name: { classPropertyName: "name", publicName: "name", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { value: "valueChange" }, host: { attributes: { "data-slot": "rich-text-editor" }, properties: { "class": "computedClass()" } }, viewQueries: [{ propertyName: "editor", first: true, predicate: ["editor"], descendants: true, isSignal: true }], ngImport: i0, template: `
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.0.2", type: BuiRichTextEditor, isStandalone: true, selector: "bui-rich-text-editor", inputs: { value: { classPropertyName: "value", publicName: "value", isSignal: true, isRequired: false, transformFunction: null }, placeholder: { classPropertyName: "placeholder", publicName: "placeholder", isSignal: true, isRequired: false, transformFunction: null }, ariaLabel: { classPropertyName: "ariaLabel", publicName: "ariaLabel", isSignal: true, isRequired: false, transformFunction: null }, formattingLabel: { classPropertyName: "formattingLabel", publicName: "formattingLabel", isSignal: true, isRequired: false, transformFunction: null }, name: { classPropertyName: "name", publicName: "name", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { value: "valueChange" }, host: { attributes: { "data-slot": "rich-text-editor" }, properties: { "class": "computedClass()" } }, viewQueries: [{ propertyName: "editor", first: true, predicate: ["editor"], descendants: true, isSignal: true }], ngImport: i0, template: `
     <div
       role="toolbar"
-      aria-label="Formatting"
+      [attr.aria-label]="formattingText()"
       class="flex flex-wrap gap-0.5 border-b bg-muted/40 p-1"
     >
       @for (tool of tools; track tool.cmd) {
@@ -18416,7 +19272,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
                     template: `
     <div
       role="toolbar"
-      aria-label="Formatting"
+      [attr.aria-label]="formattingText()"
       class="flex flex-wrap gap-0.5 border-b bg-muted/40 p-1"
     >
       @for (tool of tools; track tool.cmd) {
@@ -18444,14 +19300,17 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
     ></div>
   `,
                 }]
-        }], ctorParameters: () => [], propDecorators: { value: [{ type: i0.Input, args: [{ isSignal: true, alias: "value", required: false }] }, { type: i0.Output, args: ["valueChange"] }], placeholder: [{ type: i0.Input, args: [{ isSignal: true, alias: "placeholder", required: false }] }], ariaLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "ariaLabel", required: false }] }], name: [{ type: i0.Input, args: [{ isSignal: true, alias: "name", required: false }] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }], editor: [{ type: i0.ViewChild, args: ['editor', { isSignal: true }] }] } });
+        }], ctorParameters: () => [], propDecorators: { value: [{ type: i0.Input, args: [{ isSignal: true, alias: "value", required: false }] }, { type: i0.Output, args: ["valueChange"] }], placeholder: [{ type: i0.Input, args: [{ isSignal: true, alias: "placeholder", required: false }] }], ariaLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "ariaLabel", required: false }] }], formattingLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "formattingLabel", required: false }] }], name: [{ type: i0.Input, args: [{ isSignal: true, alias: "name", required: false }] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }], editor: [{ type: i0.ViewChild, args: ['editor', { isSignal: true }] }] } });
 
 /** A collapsible vertical navigation sidebar. Toggle width with the `open` model. */
 class BuiSidebar {
+    /** Whether the sidebar is expanded. Two-way bindable with `[(open)]`. */
     open = model(true, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "open" }] : /* istanbul ignore next */ []));
+    /** Edge the sidebar is docked to, which sets its border side. */
     side = input('left', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "side" }] : /* istanbul ignore next */ []));
+    /** Collapse behavior: hide entirely (`offcanvas`) or shrink to an icon rail (`icon`). */
     collapsible = input('offcanvas', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "collapsible" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -18477,6 +19336,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
         }], propDecorators: { open: [{ type: i0.Input, args: [{ isSignal: true, alias: "open", required: false }] }, { type: i0.Output, args: ["openChange"] }], side: [{ type: i0.Input, args: [{ isSignal: true, alias: "side", required: false }] }], collapsible: [{ type: i0.Input, args: [{ isSignal: true, alias: "collapsible", required: false }] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }] } });
 /** A styled, accessible item button for a {@link BuiSidebar} menu. */
 class BuiSidebarMenuButton {
+    /** Whether this item is the current page; sets active styling and `aria-current`. */
     isActive = input(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "isActive" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -18499,8 +19359,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
 
 /** A guided product tour with a spotlight on each step's target element. SSR-safe. */
 class BuiOnboardingTour {
+    /** Whether the tour is open. Two-way bindable with `[(open)]`. */
     open = model(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "open" }] : /* istanbul ignore next */ []));
+    /** Ordered steps; each spotlights its `target` element in turn. */
     steps = input([], /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "steps" }] : /* istanbul ignore next */ []));
     step = signal(0, /* @ts-ignore */
@@ -19094,16 +19956,22 @@ function encodeQr(text) {
 
 /** Renders a value as a scannable QR code (SVG). Level M, byte mode. SSR-safe. */
 class BuiQrCode {
+    /** Text or URL to encode into the QR code. */
     value = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "value" }] : /* istanbul ignore next */ []));
+    /** Rendered width and height of the SVG in pixels. */
     size = input(160, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "size" }] : /* istanbul ignore next */ []));
+    /** Accessible label for the QR code image. */
     label = input('QR code', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "label" }] : /* istanbul ignore next */ []));
+    /** Fill colour of the QR modules (dark squares). */
     foreground = input('currentColor', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "foreground" }] : /* istanbul ignore next */ []));
+    /** Background fill colour behind the modules. */
     background = input('transparent', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "background" }] : /* istanbul ignore next */ []));
+    /** Quiet-zone border width, in modules. */
     margin = input(2, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "margin" }] : /* istanbul ignore next */ []));
     userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
@@ -19174,5 +20042,5 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImpor
  * Generated bundle index. Do not edit.
  */
 
-export { BuiAccent, BuiAccordion, BuiAccordionContent, BuiAccordionItem, BuiAccordionTrigger, BuiAddToCart, BuiAlert, BuiAlertDescription, BuiAlertDialogAction, BuiAlertDialogCancel, BuiAlertDialogContent, BuiAlertDialogDescription, BuiAlertDialogFooter, BuiAlertDialogHeader, BuiAlertDialogTitle, BuiAlertTitle, BuiAnimatedBeam, BuiAspectRatio, BuiAudioPlayer, BuiAurora, BuiAutocomplete, BuiAutosizeTextarea, BuiAvatar, BuiAvatarGroup, BuiBackToTop, BuiBadge, BuiBanner, BuiBentoGrid, BuiBentoItem, BuiBorderBeam, BuiBottomNavigation, BuiBottomNavigationItem, BuiBreadcrumb, BuiBreadcrumbEllipsis, BuiBreadcrumbItem, BuiBreadcrumbLink, BuiBreadcrumbList, BuiBreadcrumbPage, BuiBreadcrumbSeparator, BuiButton, BuiButtonGroup, BuiButtonGroupText, BuiCalendar, BuiCard, BuiCardAction, BuiCardContent, BuiCardDescription, BuiCardFooter, BuiCardHeader, BuiCardTitle, BuiCarousel, BuiChart, BuiChat, BuiChatMessage, BuiCheckbox, BuiCitation, BuiCodeBlock, BuiCollapsible, BuiCollapsibleContent, BuiCollapsibleTrigger, BuiColorPicker, BuiCombobox, BuiCommand, BuiComparisonSlider, BuiComparisonTable, BuiConfetti, BuiContainer, BuiContextMenu, BuiCookieConsent, BuiCopyButton, BuiCountdown, BuiDataTable, BuiDatePicker, BuiDatetimePicker, BuiDescriptionItem, BuiDescriptionList, BuiDialogContent, BuiDialogDescription, BuiDialogFooter, BuiDialogHeader, BuiDialogTitle, BuiDiffViewer, BuiDock, BuiDockItem, BuiDotPattern, BuiDrawer, BuiDropdownMenu, BuiDropdownMenuItem, BuiDropdownMenuLabel, BuiDropdownMenuSeparator, BuiEditable, BuiEmpty, BuiEmptyContent, BuiEmptyDescription, BuiEmptyHeader, BuiEmptyMedia, BuiEmptyTitle, BuiField, BuiFieldContent, BuiFieldDescription, BuiFieldError, BuiFieldGroup, BuiFieldLabel, BuiFieldLegend, BuiFieldSeparator, BuiFieldSet, BuiFieldTitle, BuiFileUpload, BuiFlipCard, BuiGallery, BuiGantt, BuiGradientText, BuiGridPattern, BuiHeatmap, BuiHoverCard, BuiHoverCardContent, BuiImage, BuiInfiniteScroll, BuiInput, BuiInputGroup, BuiInputGroupAddon, BuiInputGroupButton, BuiInputGroupInput, BuiInputGroupText, BuiInputMask, BuiInputOtp, BuiItem, BuiItemActions, BuiItemContent, BuiItemDescription, BuiItemGroup, BuiItemMedia, BuiItemTitle, BuiJsonViewer, BuiJsonViewerNode, BuiKanban, BuiKbd, BuiKbdGroup, BuiKnob, BuiLabel, BuiLink, BuiLoadingOverlay, BuiMap, BuiMarkdownEditor, BuiMarquee, BuiMasonry, BuiMentionInput, BuiMenubar, BuiMenubarTrigger, BuiMeteors, BuiMeter, BuiMiniCart, BuiNavigationMenu, BuiNotificationCenter, BuiNumberInput, BuiNumberTicker, BuiOnboardingTour, BuiOrgChart, BuiOrgChartNode, BuiPageHeader, BuiPagination, BuiPaginationContent, BuiPaginationEllipsis, BuiPaginationItem, BuiPaginationLink, BuiParallax, BuiPasswordStrength, BuiPhoneInput, BuiPopover, BuiPopoverContent, BuiPresence, BuiPrice, BuiProductCard, BuiProgress, BuiPromptInput, BuiQrCode, BuiQuantitySelector, BuiQuote, BuiRadioGroup, BuiRadioGroupItem, BuiRating, BuiReasoning, BuiRepeater, BuiResizableHandle, BuiResizablePanel, BuiResizablePanelGroup, BuiRichTextEditor, BuiScheduler, BuiScrollArea, BuiScrollspy, BuiSegmentedControl, BuiSelect, BuiSeparator, BuiSheet, BuiSidebar, BuiSidebarMenuButton, BuiSignaturePad, BuiSkeleton, BuiSlider, BuiSonner, BuiSparkline, BuiSpeedDial, BuiSpinner, BuiSpotlightCard, BuiStack, BuiStat, BuiStepper, BuiStepperItem, BuiStreamingText, BuiSwitch, BuiTabList, BuiTabPanel, BuiTabTrigger, BuiTable, BuiTableBody, BuiTableCaption, BuiTableCell, BuiTableContainer, BuiTableFooter, BuiTableHead, BuiTableHeader, BuiTableRow, BuiTabs, BuiTagsInput, BuiTerminal, BuiTextReveal, BuiTextarea, BuiThemeCustomizer, BuiTiltCard, BuiTimeField, BuiTimeline, BuiTimelineItem, BuiToaster, BuiToggle, BuiToggleGroup, BuiToggleGroupItem, BuiToolCall, BuiTooltip, BuiTooltipContent, BuiTopProgress, BuiTree, BuiTreeNode, BuiTreeTable, BuiTypewriter, BuiTypography, BuiVariantSelector, BuiVideo, BuiVisuallyHidden, THEME_TOKENS, ThemeStore, buttonVariants, cn, encodeQr, toggleVariants };
+export { BUI_DEFAULT_LABELS, BUI_LABELS, BuiAccent, BuiAccordion, BuiAccordionContent, BuiAccordionItem, BuiAccordionTrigger, BuiAddToCart, BuiAlert, BuiAlertDescription, BuiAlertDialogAction, BuiAlertDialogCancel, BuiAlertDialogContent, BuiAlertDialogDescription, BuiAlertDialogFooter, BuiAlertDialogHeader, BuiAlertDialogTitle, BuiAlertTitle, BuiAnimatedBeam, BuiAspectRatio, BuiAudioPlayer, BuiAurora, BuiAutocomplete, BuiAutosizeTextarea, BuiAvatar, BuiAvatarGroup, BuiBackToTop, BuiBadge, BuiBanner, BuiBentoGrid, BuiBentoItem, BuiBorderBeam, BuiBottomNavigation, BuiBottomNavigationItem, BuiBreadcrumb, BuiBreadcrumbEllipsis, BuiBreadcrumbItem, BuiBreadcrumbLink, BuiBreadcrumbList, BuiBreadcrumbPage, BuiBreadcrumbSeparator, BuiButton, BuiButtonGroup, BuiButtonGroupText, BuiCalendar, BuiCard, BuiCardAction, BuiCardContent, BuiCardDescription, BuiCardFooter, BuiCardHeader, BuiCardTitle, BuiCarousel, BuiChart, BuiChat, BuiChatMessage, BuiCheckbox, BuiCitation, BuiCodeBlock, BuiCollapsible, BuiCollapsibleContent, BuiCollapsibleTrigger, BuiColorPicker, BuiCombobox, BuiCommand, BuiComparisonSlider, BuiComparisonTable, BuiConfetti, BuiContainer, BuiContextMenu, BuiCookieConsent, BuiCopyButton, BuiCountdown, BuiDataTable, BuiDatePicker, BuiDatetimePicker, BuiDescriptionItem, BuiDescriptionList, BuiDialogContent, BuiDialogDescription, BuiDialogFooter, BuiDialogHeader, BuiDialogTitle, BuiDiffViewer, BuiDock, BuiDockItem, BuiDotPattern, BuiDrawer, BuiDropdownMenu, BuiDropdownMenuItem, BuiDropdownMenuLabel, BuiDropdownMenuSeparator, BuiEditable, BuiEmpty, BuiEmptyContent, BuiEmptyDescription, BuiEmptyHeader, BuiEmptyMedia, BuiEmptyTitle, BuiField, BuiFieldContent, BuiFieldDescription, BuiFieldError, BuiFieldGroup, BuiFieldLabel, BuiFieldLegend, BuiFieldSeparator, BuiFieldSet, BuiFieldTitle, BuiFileUpload, BuiFlipCard, BuiGallery, BuiGantt, BuiGradientText, BuiGridPattern, BuiHeatmap, BuiHoverCard, BuiHoverCardContent, BuiImage, BuiInfiniteScroll, BuiInput, BuiInputGroup, BuiInputGroupAddon, BuiInputGroupButton, BuiInputGroupInput, BuiInputGroupText, BuiInputMask, BuiInputOtp, BuiItem, BuiItemActions, BuiItemContent, BuiItemDescription, BuiItemGroup, BuiItemMedia, BuiItemTitle, BuiJsonViewer, BuiJsonViewerNode, BuiKanban, BuiKbd, BuiKbdGroup, BuiKnob, BuiLabel, BuiLink, BuiLoadingOverlay, BuiMap, BuiMarkdownEditor, BuiMarquee, BuiMasonry, BuiMentionInput, BuiMenubar, BuiMenubarTrigger, BuiMeteors, BuiMeter, BuiMiniCart, BuiNavigationMenu, BuiNotificationCenter, BuiNumberInput, BuiNumberTicker, BuiOnboardingTour, BuiOrgChart, BuiOrgChartNode, BuiPageHeader, BuiPagination, BuiPaginationContent, BuiPaginationEllipsis, BuiPaginationItem, BuiPaginationLink, BuiParallax, BuiPasswordStrength, BuiPhoneInput, BuiPopover, BuiPopoverContent, BuiPresence, BuiPrice, BuiProductCard, BuiProgress, BuiPromptInput, BuiQrCode, BuiQuantitySelector, BuiQuote, BuiRadioGroup, BuiRadioGroupItem, BuiRating, BuiReasoning, BuiRepeater, BuiResizableHandle, BuiResizablePanel, BuiResizablePanelGroup, BuiRichTextEditor, BuiScheduler, BuiScrollArea, BuiScrollspy, BuiSegmentedControl, BuiSelect, BuiSeparator, BuiSheet, BuiSidebar, BuiSidebarMenuButton, BuiSignaturePad, BuiSkeleton, BuiSlider, BuiSonner, BuiSparkline, BuiSpeedDial, BuiSpinner, BuiSpotlightCard, BuiStack, BuiStat, BuiStepper, BuiStepperItem, BuiStreamingText, BuiSwitch, BuiTabList, BuiTabPanel, BuiTabTrigger, BuiTable, BuiTableBody, BuiTableCaption, BuiTableCell, BuiTableContainer, BuiTableFooter, BuiTableHead, BuiTableHeader, BuiTableRow, BuiTabs, BuiTagsInput, BuiTerminal, BuiTextReveal, BuiTextarea, BuiThemeCustomizer, BuiTiltCard, BuiTimeField, BuiTimeline, BuiTimelineItem, BuiToaster, BuiToggle, BuiToggleGroup, BuiToggleGroupItem, BuiToolCall, BuiTooltip, BuiTooltipContent, BuiTopProgress, BuiTree, BuiTreeNode, BuiTreeTable, BuiTypewriter, BuiTypography, BuiVariantSelector, BuiVideo, BuiVisuallyHidden, THEME_TOKENS, ThemeStore, buiLabel, buttonVariants, cn, encodeQr, provideBuiLabels, toggleVariants };
 //# sourceMappingURL=ng-blatui.mjs.map