ng-blatui 1.34.0 → 1.35.0

package/types/ng-blatui.d.ts

@@ -51,6 +51,16 @@ interface BuiLabels {
     calendarMonth: string;
     calendarYear: string;
     calendarNextMonth: string;
+    calendarWeek: string;
+    datePickerPlaceholder: string;
+    dateRangePickerPlaceholder: string;
+    dateRangePresetToday: string;
+    dateRangePresetLast7Days: string;
+    dateRangePresetLast30Days: string;
+    dateRangePresetThisMonth: string;
+    dateRangePresetLastMonth: string;
+    datetimePickerPlaceholder: string;
+    datetimePickerTime: string;
     carouselPrevious: string;
     carouselNext: string;
     carouselGoToSlide: string;
@@ -68,8 +78,13 @@ interface BuiLabels {
     dock: string;
     fileUploadDropzone: string;
     fileUploadRemove: string;
+    ganttEmpty: string;
+    markdownEditorWrite: string;
+    markdownEditorPreview: string;
     miniCartTrigger: string;
     miniCart: string;
+    miniCartTitle: string;
+    miniCartSubtotal: string;
     notificationCenter: string;
     notificationCenterUnread: string;
     notificationCenterMarkAllRead: string;
@@ -79,6 +94,7 @@ interface BuiLabels {
     phoneInputCountry: string;
     phoneInputNumber: string;
     productCardWishlist: string;
+    productCardAddToCart: string;
     promptInputAttach: string;
     promptInputSend: string;
     quantitySelectorDecrease: string;
@@ -89,6 +105,25 @@ interface BuiLabels {
     sonner: string;
     sonnerDismiss: string;
     themeCustomizer: string;
+    themeCustomizerOpen: string;
+    themeCustomizerClose: string;
+    themeCustomizerTagline: string;
+    themeCustomizerReset: string;
+    themeCustomizerMode: string;
+    themeCustomizerBaseColor: string;
+    themeCustomizerAccent: string;
+    themeCustomizerRadius: string;
+    themeCustomizerInputStyle: string;
+    themeCustomizerBodyFont: string;
+    themeCustomizerHeadingFont: string;
+    themeCustomizerShadow: string;
+    themeCustomizerSpacing: string;
+    themeCustomizerTracking: string;
+    timeField: string;
+    timeFieldHours: string;
+    timeFieldMinutes: string;
+    toolCallArguments: string;
+    toolCallResult: string;
     treeTableToggle: string;
     treeTableCopy: string;
     treeTableCopied: string;
@@ -126,6 +161,54 @@ declare function provideBuiLabels(labels: Partial<BuiLabels>): EnvironmentProvid
  */
 declare function buiLabel(key: keyof BuiLabels, override: Signal<string | undefined>): Signal<string>;
 
+/**
+ * Resolve the BCP 47 locale a component formats dates in, most-specific wins:
+ * per-instance `locale` input → the app's `LOCALE_ID` → `'en-US'` (Angular's own default).
+ *
+ * Call from an injection context (a component field initializer):
+ *
+ * ```ts
+ * readonly locale = input<string>();
+ * protected readonly resolvedLocale = buiLocale(this.locale);
+ * ```
+ *
+ * The input stays a signal on purpose: apps that switch language at runtime (transloco &
+ * co.) need the display to reformat, which a statically-injected `LOCALE_ID` cannot do.
+ */
+declare function buiLocale(override: Signal<string | undefined>): Signal<string>;
+/**
+ * The calendar system ng-blatui's date grids are built on. They are computed from JavaScript
+ * `Date`, so they are Gregorian, and every label that describes them is pinned to it — otherwise
+ * a locale whose default era is not Gregorian (`th` → Buddhist 2569, `fa` → Persian 1405) would
+ * name a month or year the grid is not showing.
+ *
+ * The pickers apply it as a *default* their `dateFormat` can override: pass
+ * `[dateFormat]="{ calendar: 'persian' }"` to display a value in another calendar system.
+ */
+declare const BUI_GRID_CALENDAR = "gregory";
+/** Which day starts the week, which days are the weekend, and how week 1 is picked. */
+interface BuiWeekInfo {
+    /** First day of the week, `0` = Sunday. */
+    firstDay: number;
+    /** Days that form the local weekend, `0` = Sunday. */
+    weekend: readonly number[];
+    /**
+     * How many days of January the year's first week must contain: `4` for the ISO-8601 rule most
+     * of Europe uses, `1` in the US, where the week containing Jan 1 is always week 1. Comes from
+     * a CLDR table, not `Intl` — see {@link ISO_WEEK_REGIONS}.
+     */
+    minimalDays: number;
+}
+/**
+ * The locale's own week conventions, so a calendar is not silently US-shaped: `fr` starts the
+ * week on Monday, `ar-EG` on Saturday with a Friday/Saturday weekend, `en-US` on Sunday with a
+ * Saturday/Sunday weekend — the last being exactly the library's pre-locale behavior.
+ *
+ * Falls back to the US convention on engines without week data (rather than throwing), so this
+ * only ever adds correctness.
+ */
+declare function buiWeekInfo(locale: Signal<string>): Signal<BuiWeekInfo>;
+
 declare const buttonVariants: (props?: ({
     variant?: "default" | "destructive" | "outline" | "secondary" | "ghost" | "link" | null | undefined;
     size?: "default" | "xs" | "sm" | "lg" | "icon" | "icon-xs" | "icon-sm" | "icon-lg" | null | undefined;
@@ -676,6 +759,20 @@ interface FontOption {
 declare class BuiThemeCustomizer {
     readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
     protected readonly ariaLabelText: _angular_core.Signal<string>;
+    protected readonly openText: _angular_core.Signal<string>;
+    protected readonly closeText: _angular_core.Signal<string>;
+    protected readonly taglineText: _angular_core.Signal<string>;
+    protected readonly resetText: _angular_core.Signal<string>;
+    protected readonly modeText: _angular_core.Signal<string>;
+    protected readonly baseColorText: _angular_core.Signal<string>;
+    protected readonly accentText: _angular_core.Signal<string>;
+    protected readonly radiusText: _angular_core.Signal<string>;
+    protected readonly inputStyleText: _angular_core.Signal<string>;
+    protected readonly bodyFontText: _angular_core.Signal<string>;
+    protected readonly headingFontText: _angular_core.Signal<string>;
+    protected readonly shadowText: _angular_core.Signal<string>;
+    protected readonly spacingText: _angular_core.Signal<string>;
+    protected readonly trackingText: _angular_core.Signal<string>;
     protected readonly theme: ThemeStore;
     protected readonly open: _angular_core.WritableSignal<boolean>;
     protected readonly copied: _angular_core.WritableSignal<boolean>;
@@ -2166,6 +2263,15 @@ declare class BuiPrice {
     /** Whether to show the percentage-off discount badge when on sale. */
     readonly showDiscount: _angular_core.InputSignal<boolean>;
     readonly userClass: _angular_core.InputSignal<ClassValue>;
+    /** BCP 47 locale for number formatting. Defaults to the app's `LOCALE_ID`. */
+    readonly locale: _angular_core.InputSignal<string | undefined>;
+    /**
+     * `Intl.NumberFormat` options for the amounts. Replaces the default wholesale — pass
+     * `{ style: 'currency', currency: 'EUR' }` to let ICU place the symbol itself.
+     */
+    readonly numberFormat: _angular_core.InputSignal<Intl.NumberFormatOptions>;
+    private readonly resolvedLocale;
+    private readonly formatter;
     protected readonly onSale: _angular_core.Signal<boolean>;
     protected readonly discount: _angular_core.Signal<number>;
     protected readonly currentClass: _angular_core.Signal<string>;
@@ -2173,7 +2279,7 @@ declare class BuiPrice {
     protected readonly computedClass: _angular_core.Signal<string>;
     protected format(value: number): string;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<BuiPrice, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<BuiPrice, "bui-price", never, { "amount": { "alias": "amount"; "required": false; "isSignal": true; }; "compareAt": { "alias": "compareAt"; "required": false; "isSignal": true; }; "currency": { "alias": "currency"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "showDiscount": { "alias": "showDiscount"; "required": false; "isSignal": true; }; "userClass": { "alias": "class"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<BuiPrice, "bui-price", never, { "amount": { "alias": "amount"; "required": false; "isSignal": true; }; "compareAt": { "alias": "compareAt"; "required": false; "isSignal": true; }; "currency": { "alias": "currency"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "showDiscount": { "alias": "showDiscount"; "required": false; "isSignal": true; }; "userClass": { "alias": "class"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "numberFormat": { "alias": "numberFormat"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 /** A flexbox stack layout helper (direction, gap, alignment). */
@@ -2554,13 +2660,16 @@ declare class BuiProductCard {
     readonly userClass: _angular_core.InputSignal<ClassValue>;
     /** Accessible label override for the wishlist toggle button. */
     readonly wishlistLabel: _angular_core.InputSignal<string | undefined>;
+    /** Text of the default add-to-cart button. Falls back to `provideBuiLabels`. */
+    readonly addToCartLabel: _angular_core.InputSignal<string | undefined>;
     protected readonly wishlistText: _angular_core.Signal<string>;
+    protected readonly addToCartText: _angular_core.Signal<string>;
     protected readonly wished: _angular_core.WritableSignal<boolean>;
     protected readonly alt: _angular_core.Signal<string>;
     protected readonly badgeClass: _angular_core.Signal<"" | "border-transparent bg-red-700 text-white" | "border-transparent bg-emerald-700 text-white">;
     protected readonly computedClass: _angular_core.Signal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<BuiProductCard, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<BuiProductCard, "bui-product-card", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "href": { "alias": "href"; "required": false; "isSignal": true; }; "image": { "alias": "image"; "required": false; "isSignal": true; }; "imageAlt": { "alias": "imageAlt"; "required": false; "isSignal": true; }; "price": { "alias": "price"; "required": false; "isSignal": true; }; "compareAt": { "alias": "compareAt"; "required": false; "isSignal": true; }; "currency": { "alias": "currency"; "required": false; "isSignal": true; }; "badge": { "alias": "badge"; "required": false; "isSignal": true; }; "category": { "alias": "category"; "required": false; "isSignal": true; }; "rating": { "alias": "rating"; "required": false; "isSignal": true; }; "reviews": { "alias": "reviews"; "required": false; "isSignal": true; }; "wishlist": { "alias": "wishlist"; "required": false; "isSignal": true; }; "userClass": { "alias": "class"; "required": false; "isSignal": true; }; "wishlistLabel": { "alias": "wishlistLabel"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<BuiProductCard, "bui-product-card", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "href": { "alias": "href"; "required": false; "isSignal": true; }; "image": { "alias": "image"; "required": false; "isSignal": true; }; "imageAlt": { "alias": "imageAlt"; "required": false; "isSignal": true; }; "price": { "alias": "price"; "required": false; "isSignal": true; }; "compareAt": { "alias": "compareAt"; "required": false; "isSignal": true; }; "currency": { "alias": "currency"; "required": false; "isSignal": true; }; "badge": { "alias": "badge"; "required": false; "isSignal": true; }; "category": { "alias": "category"; "required": false; "isSignal": true; }; "rating": { "alias": "rating"; "required": false; "isSignal": true; }; "reviews": { "alias": "reviews"; "required": false; "isSignal": true; }; "wishlist": { "alias": "wishlist"; "required": false; "isSignal": true; }; "userClass": { "alias": "class"; "required": false; "isSignal": true; }; "wishlistLabel": { "alias": "wishlistLabel"; "required": false; "isSignal": true; }; "addToCartLabel": { "alias": "addToCartLabel"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 
 /**
@@ -2778,7 +2887,22 @@ declare class BuiScrollspy implements OnDestroy {
 
 /** How the time field renders: native input or hour/minute selects. */
 type TimeFieldMode = 'input' | 'select';
-/** A styled time field: a native `<input type="time">`, or hour/minute selects in `select` mode. */
+/** Which hours the clock runs through. `h12`/`h11` add a day period (AM/PM), `h23`/`h24` do not. */
+type TimeFieldHourCycle = 'h11' | 'h12' | 'h23' | 'h24';
+/** An option whose `value` stays the 24-hour data, while `label` is what the locale reads. */
+interface TimeOption {
+    value: string;
+    label: string;
+}
+/**
+ * A styled time field: a native `<input type="time">`, or hour/minute selects in `select` mode.
+ * The value is always 24-hour `HH:mm`, whatever the clock shown.
+ *
+ * **Locale:** `select` mode follows `locale` — it renders the locale's clock (1–12 with AM/PM in
+ * `en-US`, 0–23 in `fr`) and its digits. `input` mode cannot: the browser renders native time
+ * inputs in *its own* UI language, and neither `lang` nor any other attribute overrides that.
+ * Use `mode="select"` when the clock must follow the app's locale rather than the user's browser.
+ */
 declare class BuiTimeField implements ControlValueAccessor {
     /** Selected time as `HH:mm`. Two-way bindable with `[(value)]`. */
     readonly value: _angular_core.ModelSignal<string>;
@@ -2801,14 +2925,37 @@ declare class BuiTimeField implements ControlValueAccessor {
     /** Accessible label for the field. */
     readonly ariaLabel: _angular_core.InputSignal<string>;
     readonly userClass: _angular_core.InputSignal<ClassValue>;
+    /**
+     * BCP 47 locale driving `select` mode's clock and digits. Defaults to the app's `LOCALE_ID`.
+     * It has no effect in `input` mode — see the class docs.
+     */
+    readonly locale: _angular_core.InputSignal<string | undefined>;
+    /** Force a clock instead of the locale's own — `h12` gives 1–12 with AM/PM, `h23` gives 0–23. */
+    readonly hourCycle: _angular_core.InputSignal<TimeFieldHourCycle | undefined>;
+    protected readonly resolvedLocale: _angular_core.Signal<string>;
+    private readonly timeText;
+    private readonly hoursText;
+    private readonly minutesText;
+    protected readonly hoursAria: _angular_core.Signal<string>;
+    protected readonly minutesAria: _angular_core.Signal<string>;
+    /** The locale's clock unless the caller pinned one. */
+    private readonly resolvedHourCycle;
+    private readonly usesDayPeriod;
+    /** Two digits in the locale's own numbering system — `padStart` would mix `0` with `٠`. */
+    private readonly paddedNumber;
     private onChange;
     protected onTouched: () => void;
     protected readonly selectClass = "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";
     protected readonly hourPart: _angular_core.Signal<string>;
     protected readonly minutePart: _angular_core.Signal<string>;
-    protected readonly hours: _angular_core.Signal<string[]>;
-    protected readonly minutes: _angular_core.Signal<string[]>;
+    protected readonly hours: _angular_core.Signal<TimeOption[]>;
+    protected readonly minutes: _angular_core.Signal<TimeOption[]>;
     protected readonly computedClass: _angular_core.Signal<string>;
+    /**
+     * "1 PM" / "١ م". Built from parts rather than the plain format so the locale's own literal
+     * (French renders `13 h`) never leaks into a cell that already has its own `:` separator.
+     */
+    private dayPeriodLabel;
     protected onInput(event: Event): void;
     protected setHour(event: Event): void;
     protected setMinute(event: Event): void;
@@ -2817,7 +2964,7 @@ declare class BuiTimeField implements ControlValueAccessor {
     registerOnTouched(callback: () => void): void;
     setDisabledState(isDisabled: boolean): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<BuiTimeField, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<BuiTimeField, "bui-time-field", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "seconds": { "alias": "seconds"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "minuteStep": { "alias": "minuteStep"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "userClass": { "alias": "class"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "disabled": "disabledChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<BuiTimeField, "bui-time-field", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "seconds": { "alias": "seconds"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "minuteStep": { "alias": "minuteStep"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "userClass": { "alias": "class"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "hourCycle": { "alias": "hourCycle"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "disabled": "disabledChange"; }, never, never, true, never>;
 }
 
 type ToggleValue = string | string[] | null;
@@ -3074,10 +3221,16 @@ declare class BuiToolCall {
     /** Whether the arguments/result panel is expanded. Two-way bindable with `[(open)]`. */
     readonly open: _angular_core.ModelSignal<boolean>;
     readonly userClass: _angular_core.InputSignal<ClassValue>;
+    /** Heading of the arguments panel. Falls back to `provideBuiLabels`. */
+    readonly argumentsLabel: _angular_core.InputSignal<string | undefined>;
+    /** Heading of the result panel. Falls back to `provideBuiLabels`. */
+    readonly resultLabel: _angular_core.InputSignal<string | undefined>;
+    protected readonly argumentsText: _angular_core.Signal<string>;
+    protected readonly resultText: _angular_core.Signal<string>;
     protected readonly statusClass: _angular_core.Signal<string>;
     protected readonly computedClass: _angular_core.Signal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<BuiToolCall, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<BuiToolCall, "bui-tool-call", never, { "name": { "alias": "name"; "required": false; "isSignal": true; }; "status": { "alias": "status"; "required": false; "isSignal": true; }; "args": { "alias": "args"; "required": false; "isSignal": true; }; "result": { "alias": "result"; "required": false; "isSignal": true; }; "open": { "alias": "open"; "required": false; "isSignal": true; }; "userClass": { "alias": "class"; "required": false; "isSignal": true; }; }, { "open": "openChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<BuiToolCall, "bui-tool-call", never, { "name": { "alias": "name"; "required": false; "isSignal": true; }; "status": { "alias": "status"; "required": false; "isSignal": true; }; "args": { "alias": "args"; "required": false; "isSignal": true; }; "result": { "alias": "result"; "required": false; "isSignal": true; }; "open": { "alias": "open"; "required": false; "isSignal": true; }; "userClass": { "alias": "class"; "required": false; "isSignal": true; }; "argumentsLabel": { "alias": "argumentsLabel"; "required": false; "isSignal": true; }; "resultLabel": { "alias": "resultLabel"; "required": false; "isSignal": true; }; }, { "open": "openChange"; }, never, never, true, never>;
 }
 
 /** A scrollable conversation log (`role="log"`). Use `bui-chat-message` for bubbles. */
@@ -3371,7 +3524,8 @@ interface CalendarRange {
 }
 interface Day {
     iso: string;
-    num: number;
+    /** Day number rendered in the locale's numbering system — `16` in `fr`, `١٦` in `ar-EG`. */
+    num: string;
     inMonth: boolean;
     isToday: boolean;
     disabled: boolean;
@@ -3381,6 +3535,16 @@ interface MonthGrid {
     label: string;
     weeks: Day[][];
 }
+interface Weekday {
+    /** Day index, `0` = Sunday. Stable across locales, so it is the `@for` track key. */
+    day: number;
+    /** Abbreviation shown in the column header. */
+    label: string;
+    /** Full name, exposed to assistive tech since the abbreviation can be ambiguous. */
+    name: string;
+}
+/** How weekday column headers are abbreviated. `short` is each locale's native abbreviation. */
+type WeekdayFormat = 'narrow' | 'short' | 'long';
 /**
  * A date calendar. Modes: `single` (one day), `range` (start–end), `multiple` (a set of days).
  * Render several months side by side with `months`. SSR-safe.
@@ -3396,15 +3560,18 @@ declare class BuiCalendar implements ControlValueAccessor {
     readonly values: _angular_core.ModelSignal<readonly string[]>;
     /** Number of month grids to render side by side. */
     readonly months: _angular_core.InputSignal<number>;
-    /** First day of the week (0 = Sunday). */
-    readonly weekStart: _angular_core.InputSignal<number>;
+    /**
+     * First day of the week (0 = Sunday). Defaults to the locale's own convention — Sunday in
+     * `en-US`, Monday in `fr`, Saturday in `ar-EG`.
+     */
+    readonly weekStart: _angular_core.InputSignal<number | undefined>;
     /** Earliest selectable date (`yyyy-mm-dd`). */
     readonly minDate: _angular_core.InputSignal<string>;
     /** Latest selectable date (`yyyy-mm-dd`). */
     readonly maxDate: _angular_core.InputSignal<string>;
     /** Specific ISO dates (yyyy-mm-dd) to disable. */
     readonly disabledDates: _angular_core.InputSignal<readonly string[]>;
-    /** Disable Saturdays and Sundays. */
+    /** Disable the locale's weekend days — Saturday/Sunday in `en-US`, Friday/Saturday in `ar-EG`. */
     readonly disableWeekends: _angular_core.InputSignal<boolean>;
     /** Show an ISO week-number column on the left. */
     readonly showWeekNumbers: _angular_core.InputSignal<boolean>;
@@ -3415,6 +3582,20 @@ declare class BuiCalendar implements ControlValueAccessor {
     /** Whether the whole calendar is disabled. Two-way bindable with `[(disabled)]`. */
     readonly disabled: _angular_core.ModelSignal<boolean>;
     readonly userClass: _angular_core.InputSignal<ClassValue>;
+    /** BCP 47 locale used for the month captions. Defaults to the app's `LOCALE_ID`. */
+    readonly locale: _angular_core.InputSignal<string | undefined>;
+    /**
+     * `Intl.DateTimeFormat` options for the month caption. Replaces the default wholesale, so
+     * `{ dateStyle: 'short' }` and `{ month: 'long' }` are both valid (they cannot be mixed).
+     */
+    readonly monthFormat: _angular_core.InputSignal<Intl.DateTimeFormatOptions>;
+    /** How weekday column headers are abbreviated: each locale's own `short` form by default. */
+    readonly weekdayFormat: _angular_core.InputSignal<WeekdayFormat>;
+    /**
+     * Override the weekday column headers outright — 7 entries, **Sunday first**, regardless of
+     * `weekStart`. For when a locale's `Intl` abbreviation is not what your design wants.
+     */
+    readonly weekdayLabels: _angular_core.InputSignal<readonly string[] | undefined>;
     /** Accessible label for the previous-month button. */
     readonly previousMonthLabel: _angular_core.InputSignal<string | undefined>;
     /** Accessible label for the month dropdown. */
@@ -3423,14 +3604,24 @@ declare class BuiCalendar implements ControlValueAccessor {
     readonly yearLabel: _angular_core.InputSignal<string | undefined>;
     /** Accessible label for the next-month button. */
     readonly nextMonthLabel: _angular_core.InputSignal<string | undefined>;
+    /** Accessible label for the week-number column. */
+    readonly weekLabel: _angular_core.InputSignal<string | undefined>;
     protected readonly previousMonthText: _angular_core.Signal<string>;
     protected readonly monthText: _angular_core.Signal<string>;
     protected readonly yearText: _angular_core.Signal<string>;
     protected readonly nextMonthText: _angular_core.Signal<string>;
+    protected readonly weekText: _angular_core.Signal<string>;
     private onChange;
     protected onTouched: () => void;
     private readonly view;
-    protected readonly weekdays: _angular_core.Signal<string[]>;
+    protected readonly resolvedLocale: _angular_core.Signal<string>;
+    private readonly weekInfo;
+    /** The locale's first day unless the caller pinned one. */
+    private readonly resolvedWeekStart;
+    protected readonly weekdays: _angular_core.Signal<Weekday[]>;
+    private readonly monthFormatter;
+    /** Day/week/year numbers follow the locale's numbering system; never group a year as "2,026". */
+    private readonly numberFormatter;
     protected readonly monthLabel: _angular_core.Signal<string>;
     protected readonly viewMonth: _angular_core.Signal<number>;
     protected readonly viewYear: _angular_core.Signal<number>;
@@ -3438,10 +3629,17 @@ declare class BuiCalendar implements ControlValueAccessor {
         value: number;
         label: string;
     }[]>;
-    protected readonly years: _angular_core.Signal<number[]>;
+    protected readonly years: _angular_core.Signal<{
+        value: number;
+        label: string;
+    }[]>;
     protected readonly monthGrids: _angular_core.Signal<MonthGrid[]>;
     protected readonly computedClass: _angular_core.Signal<string>;
-    protected weekNum(iso: string): number;
+    /**
+     * Week number for a row, under the locale's rule and aligned on the same first day as the grid
+     * — a row cannot be labelled with a week it does not span.
+     */
+    protected weekNum(iso: string): string;
     protected changeMonth(delta: number): void;
     protected setMonth(event: Event): void;
     protected setYear(event: Event): void;
@@ -3456,7 +3654,7 @@ declare class BuiCalendar implements ControlValueAccessor {
     private weeksFor;
     private isDisabled;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<BuiCalendar, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<BuiCalendar, "bui-calendar", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "range": { "alias": "range"; "required": false; "isSignal": true; }; "values": { "alias": "values"; "required": false; "isSignal": true; }; "months": { "alias": "months"; "required": false; "isSignal": true; }; "weekStart": { "alias": "weekStart"; "required": false; "isSignal": true; }; "minDate": { "alias": "minDate"; "required": false; "isSignal": true; }; "maxDate": { "alias": "maxDate"; "required": false; "isSignal": true; }; "disabledDates": { "alias": "disabledDates"; "required": false; "isSignal": true; }; "disableWeekends": { "alias": "disableWeekends"; "required": false; "isSignal": true; }; "showWeekNumbers": { "alias": "showWeekNumbers"; "required": false; "isSignal": true; }; "captionLayout": { "alias": "captionLayout"; "required": false; "isSignal": true; }; "hideOutsideDays": { "alias": "hideOutsideDays"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "userClass": { "alias": "class"; "required": false; "isSignal": true; }; "previousMonthLabel": { "alias": "previousMonthLabel"; "required": false; "isSignal": true; }; "monthSelectLabel": { "alias": "monthSelectLabel"; "required": false; "isSignal": true; }; "yearLabel": { "alias": "yearLabel"; "required": false; "isSignal": true; }; "nextMonthLabel": { "alias": "nextMonthLabel"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "range": "rangeChange"; "values": "valuesChange"; "disabled": "disabledChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<BuiCalendar, "bui-calendar", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "range": { "alias": "range"; "required": false; "isSignal": true; }; "values": { "alias": "values"; "required": false; "isSignal": true; }; "months": { "alias": "months"; "required": false; "isSignal": true; }; "weekStart": { "alias": "weekStart"; "required": false; "isSignal": true; }; "minDate": { "alias": "minDate"; "required": false; "isSignal": true; }; "maxDate": { "alias": "maxDate"; "required": false; "isSignal": true; }; "disabledDates": { "alias": "disabledDates"; "required": false; "isSignal": true; }; "disableWeekends": { "alias": "disableWeekends"; "required": false; "isSignal": true; }; "showWeekNumbers": { "alias": "showWeekNumbers"; "required": false; "isSignal": true; }; "captionLayout": { "alias": "captionLayout"; "required": false; "isSignal": true; }; "hideOutsideDays": { "alias": "hideOutsideDays"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "userClass": { "alias": "class"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "monthFormat": { "alias": "monthFormat"; "required": false; "isSignal": true; }; "weekdayFormat": { "alias": "weekdayFormat"; "required": false; "isSignal": true; }; "weekdayLabels": { "alias": "weekdayLabels"; "required": false; "isSignal": true; }; "previousMonthLabel": { "alias": "previousMonthLabel"; "required": false; "isSignal": true; }; "monthSelectLabel": { "alias": "monthSelectLabel"; "required": false; "isSignal": true; }; "yearLabel": { "alias": "yearLabel"; "required": false; "isSignal": true; }; "nextMonthLabel": { "alias": "nextMonthLabel"; "required": false; "isSignal": true; }; "weekLabel": { "alias": "weekLabel"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "range": "rangeChange"; "values": "valuesChange"; "disabled": "disabledChange"; }, never, never, true, never>;
 }
 
 /** A named shortcut shown beside the calendar, e.g. "Last 7 days". */
@@ -3484,8 +3682,8 @@ declare class BuiDateRangePicker implements ControlValueAccessor {
     readonly minDate: _angular_core.InputSignal<string>;
     /** Latest selectable date (`yyyy-mm-dd`). */
     readonly maxDate: _angular_core.InputSignal<string>;
-    /** Text shown on the trigger when nothing is selected. */
-    readonly placeholder: _angular_core.InputSignal<string>;
+    /** Text shown on the trigger when nothing is selected. Falls back to `provideBuiLabels`. */
+    readonly placeholder: _angular_core.InputSignal<string | undefined>;
     /** Whether the picker is disabled. Two-way bindable with `[(disabled)]`. */
     readonly disabled: _angular_core.ModelSignal<boolean>;
     /** Quick-pick shortcuts. Pass `[]` to hide them; omit for a sensible default set. */
@@ -3493,8 +3691,19 @@ declare class BuiDateRangePicker implements ControlValueAccessor {
     /** Accessible name applied to the trigger. */
     readonly ariaLabel: _angular_core.InputSignal<string>;
     readonly userClass: _angular_core.InputSignal<ClassValue>;
+    /** BCP 47 locale for the trigger text and the calendar. Defaults to the app's `LOCALE_ID`. */
+    readonly locale: _angular_core.InputSignal<string | undefined>;
+    /**
+     * `Intl.DateTimeFormat` options for the trigger text. Replaces the default wholesale, so
+     * `{ dateStyle: 'short' }` renders `16/07/2026` in `fr` (options cannot be mixed with it).
+     */
+    readonly dateFormat: _angular_core.InputSignal<Intl.DateTimeFormatOptions>;
+    protected readonly placeholderText: _angular_core.Signal<string>;
+    private readonly presetText;
     protected readonly open: _angular_core.WritableSignal<boolean>;
     protected readonly popupPositions: ConnectedPosition[];
+    private readonly resolvedLocale;
+    private readonly formatter;
     private onChange;
     private onTouched;
     protected readonly hasValue: _angular_core.Signal<boolean>;
@@ -3511,7 +3720,7 @@ declare class BuiDateRangePicker implements ControlValueAccessor {
     registerOnTouched(callback: () => void): void;
     setDisabledState(isDisabled: boolean): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<BuiDateRangePicker, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<BuiDateRangePicker, "bui-date-range-picker", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "months": { "alias": "months"; "required": false; "isSignal": true; }; "minDate": { "alias": "minDate"; "required": false; "isSignal": true; }; "maxDate": { "alias": "maxDate"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "presets": { "alias": "presets"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; "userClass": { "alias": "class"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "disabled": "disabledChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<BuiDateRangePicker, "bui-date-range-picker", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "months": { "alias": "months"; "required": false; "isSignal": true; }; "minDate": { "alias": "minDate"; "required": false; "isSignal": true; }; "maxDate": { "alias": "maxDate"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "presets": { "alias": "presets"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; "userClass": { "alias": "class"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "dateFormat": { "alias": "dateFormat"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "disabled": "disabledChange"; }, never, never, true, never>;
 }
 
 /** A chat composer: an autosizing textarea with a send button. Emits `submitted` on send. */
@@ -4044,14 +4253,29 @@ declare class BuiMiniCart {
     readonly triggerLabel: _angular_core.InputSignal<string | undefined>;
     /** Accessible label override for the cart dropdown dialog. */
     readonly label: _angular_core.InputSignal<string | undefined>;
+    /** Heading shown at the top of the cart panel. Falls back to `provideBuiLabels`. */
+    readonly title: _angular_core.InputSignal<string | undefined>;
+    /** Label for the subtotal row. Falls back to `provideBuiLabels`. */
+    readonly subtotalLabel: _angular_core.InputSignal<string | undefined>;
+    /** BCP 47 locale for number formatting. Defaults to the app's `LOCALE_ID`. */
+    readonly locale: _angular_core.InputSignal<string | undefined>;
+    /**
+     * `Intl.NumberFormat` options for prices and subtotal. Replaces the default wholesale — pass
+     * `{ style: 'currency', currency: 'EUR' }` to let ICU place the symbol itself.
+     */
+    readonly numberFormat: _angular_core.InputSignal<Intl.NumberFormatOptions>;
+    private readonly resolvedLocale;
+    private readonly formatter;
     protected readonly triggerText: _angular_core.Signal<string>;
     protected readonly labelText: _angular_core.Signal<string>;
+    protected readonly titleText: _angular_core.Signal<string>;
+    protected readonly subtotalText: _angular_core.Signal<string>;
     protected readonly count: _angular_core.Signal<number>;
     protected readonly subtotal: _angular_core.Signal<number>;
     protected readonly computedClass: _angular_core.Signal<string>;
     protected format(value: number): string;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<BuiMiniCart, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<BuiMiniCart, "bui-mini-cart", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "currency": { "alias": "currency"; "required": false; "isSignal": true; }; "open": { "alias": "open"; "required": false; "isSignal": true; }; "userClass": { "alias": "class"; "required": false; "isSignal": true; }; "triggerLabel": { "alias": "triggerLabel"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, { "open": "openChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<BuiMiniCart, "bui-mini-cart", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "currency": { "alias": "currency"; "required": false; "isSignal": true; }; "open": { "alias": "open"; "required": false; "isSignal": true; }; "userClass": { "alias": "class"; "required": false; "isSignal": true; }; "triggerLabel": { "alias": "triggerLabel"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "subtotalLabel": { "alias": "subtotalLabel"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "numberFormat": { "alias": "numberFormat"; "required": false; "isSignal": true; }; }, { "open": "openChange"; }, never, never, true, never>;
 }
 
 /** An SVG beam connecting two elements (by selector) with a travelling light. SSR-safe. */
@@ -4169,13 +4393,19 @@ declare class BuiMarkdownEditor {
     /** Number of visible rows in the write textarea. */
     readonly rows: _angular_core.InputSignal<number>;
     readonly userClass: _angular_core.InputSignal<ClassValue>;
+    /** Text of the write tab. Falls back to `provideBuiLabels`. */
+    readonly writeLabel: _angular_core.InputSignal<string | undefined>;
+    /** Text of the preview tab. Falls back to `provideBuiLabels`. */
+    readonly previewLabel: _angular_core.InputSignal<string | undefined>;
+    protected readonly writeText: _angular_core.Signal<string>;
+    protected readonly previewText: _angular_core.Signal<string>;
     protected readonly tab: _angular_core.WritableSignal<"write" | "preview">;
     protected readonly rendered: _angular_core.Signal<string>;
     protected readonly computedClass: _angular_core.Signal<string>;
     protected tabClass(name: 'write' | 'preview'): string;
     protected onInput(event: Event): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<BuiMarkdownEditor, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<BuiMarkdownEditor, "bui-markdown-editor", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "userClass": { "alias": "class"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<BuiMarkdownEditor, "bui-markdown-editor", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "userClass": { "alias": "class"; "required": false; "isSignal": true; }; "writeLabel": { "alias": "writeLabel"; "required": false; "isSignal": true; }; "previewLabel": { "alias": "previewLabel"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
 }
 
 /**
@@ -4191,14 +4421,14 @@ declare class BuiDatePicker implements ControlValueAccessor {
     readonly range: _angular_core.ModelSignal<CalendarRange>;
     /** Month grids shown in the popover (handy for range). */
     readonly months: _angular_core.InputSignal<number>;
-    /** Text shown on the trigger when no date is selected. */
-    readonly placeholder: _angular_core.InputSignal<string>;
+    /** Text shown on the trigger when no date is selected. Falls back to `provideBuiLabels`. */
+    readonly placeholder: _angular_core.InputSignal<string | undefined>;
     /** Earliest selectable date (`yyyy-mm-dd`). */
     readonly minDate: _angular_core.InputSignal<string>;
     /** Latest selectable date (`yyyy-mm-dd`). */
     readonly maxDate: _angular_core.InputSignal<string>;
-    /** First day of the week (0 = Sunday). */
-    readonly weekStart: _angular_core.InputSignal<number>;
+    /** First day of the week (0 = Sunday). Defaults to the locale's own convention. */
+    readonly weekStart: _angular_core.InputSignal<number | undefined>;
     /** Specific ISO dates (yyyy-mm-dd) to disable. */
     readonly disabledDates: _angular_core.InputSignal<readonly string[]>;
     /** Disable Saturdays and Sundays. */
@@ -4212,10 +4442,20 @@ declare class BuiDatePicker implements ControlValueAccessor {
     /** Whether the picker is disabled. Two-way bindable with `[(disabled)]`. */
     readonly disabled: _angular_core.ModelSignal<boolean>;
     readonly userClass: _angular_core.InputSignal<ClassValue>;
+    /** BCP 47 locale for the trigger text and the calendar. Defaults to the app's `LOCALE_ID`. */
+    readonly locale: _angular_core.InputSignal<string | undefined>;
+    /**
+     * `Intl.DateTimeFormat` options for the trigger text. Replaces the default wholesale, so
+     * `{ dateStyle: 'short' }` renders `16/07/2026` in `fr` (options cannot be mixed with it).
+     */
+    readonly dateFormat: _angular_core.InputSignal<Intl.DateTimeFormatOptions>;
+    protected readonly placeholderText: _angular_core.Signal<string>;
     private onChange;
     protected onTouched: () => void;
     private readonly host;
     protected readonly open: _angular_core.WritableSignal<boolean>;
+    private readonly resolvedLocale;
+    private readonly formatter;
     protected readonly hasValue: _angular_core.Signal<boolean>;
     protected readonly display: _angular_core.Signal<string>;
     protected readonly popupPositions: ConnectedPosition[];
@@ -4229,7 +4469,7 @@ declare class BuiDatePicker implements ControlValueAccessor {
     registerOnTouched(callback: () => void): void;
     setDisabledState(isDisabled: boolean): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<BuiDatePicker, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<BuiDatePicker, "bui-date-picker", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "range": { "alias": "range"; "required": false; "isSignal": true; }; "months": { "alias": "months"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "minDate": { "alias": "minDate"; "required": false; "isSignal": true; }; "maxDate": { "alias": "maxDate"; "required": false; "isSignal": true; }; "weekStart": { "alias": "weekStart"; "required": false; "isSignal": true; }; "disabledDates": { "alias": "disabledDates"; "required": false; "isSignal": true; }; "disableWeekends": { "alias": "disableWeekends"; "required": false; "isSignal": true; }; "showWeekNumbers": { "alias": "showWeekNumbers"; "required": false; "isSignal": true; }; "captionLayout": { "alias": "captionLayout"; "required": false; "isSignal": true; }; "hideOutsideDays": { "alias": "hideOutsideDays"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "userClass": { "alias": "class"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "range": "rangeChange"; "disabled": "disabledChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<BuiDatePicker, "bui-date-picker", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "range": { "alias": "range"; "required": false; "isSignal": true; }; "months": { "alias": "months"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "minDate": { "alias": "minDate"; "required": false; "isSignal": true; }; "maxDate": { "alias": "maxDate"; "required": false; "isSignal": true; }; "weekStart": { "alias": "weekStart"; "required": false; "isSignal": true; }; "disabledDates": { "alias": "disabledDates"; "required": false; "isSignal": true; }; "disableWeekends": { "alias": "disableWeekends"; "required": false; "isSignal": true; }; "showWeekNumbers": { "alias": "showWeekNumbers"; "required": false; "isSignal": true; }; "captionLayout": { "alias": "captionLayout"; "required": false; "isSignal": true; }; "hideOutsideDays": { "alias": "hideOutsideDays"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "userClass": { "alias": "class"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "dateFormat": { "alias": "dateFormat"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "range": "rangeChange"; "disabled": "disabledChange"; }, never, never, true, never>;
 }
 
 /** Scroll axis of the carousel: left/right or up/down. */
@@ -4537,8 +4777,10 @@ declare class BuiDatetimePicker implements ControlValueAccessor {
     readonly range: _angular_core.ModelSignal<CalendarRange>;
     /** Month grids shown in the popover (handy for range). */
     readonly months: _angular_core.InputSignal<number>;
-    /** Text shown on the trigger when nothing is selected. */
-    readonly placeholder: _angular_core.InputSignal<string>;
+    /** Text shown on the trigger when nothing is selected. Falls back to `provideBuiLabels`. */
+    readonly placeholder: _angular_core.InputSignal<string | undefined>;
+    /** Label for the time field in the popover. Falls back to `provideBuiLabels`. */
+    readonly timeLabel: _angular_core.InputSignal<string | undefined>;
     /** Earliest selectable date (`yyyy-mm-dd`). */
     readonly minDate: _angular_core.InputSignal<string>;
     /** Latest selectable date (`yyyy-mm-dd`). */
@@ -4547,13 +4789,30 @@ declare class BuiDatetimePicker implements ControlValueAccessor {
     readonly captionLayout: _angular_core.InputSignal<"label" | "dropdown">;
     /** Whether to include seconds in the time field. */
     readonly seconds: _angular_core.InputSignal<boolean>;
+    /**
+     * How the popover's time field renders. The default native `input` is drawn by the browser in
+     * *its* language, so it can disagree with a trigger formatted in `locale`; `select` follows
+     * `locale` instead and keeps the whole picker on one clock.
+     */
+    readonly timeMode: _angular_core.InputSignal<TimeFieldMode>;
     /** Whether the picker is disabled. Two-way bindable with `[(disabled)]`. */
     readonly disabled: _angular_core.ModelSignal<boolean>;
     readonly userClass: _angular_core.InputSignal<ClassValue>;
+    /** BCP 47 locale for the trigger text and the calendar. Defaults to the app's `LOCALE_ID`. */
+    readonly locale: _angular_core.InputSignal<string | undefined>;
+    /**
+     * `Intl.DateTimeFormat` options for the trigger text. Replaces the default wholesale, so
+     * `{ dateStyle: 'short', timeStyle: 'short' }` is valid (options cannot be mixed with it).
+     */
+    readonly dateFormat: _angular_core.InputSignal<Intl.DateTimeFormatOptions>;
+    protected readonly placeholderText: _angular_core.Signal<string>;
+    protected readonly timeText: _angular_core.Signal<string>;
     private onChange;
     protected onTouched: () => void;
     private readonly host;
     protected readonly open: _angular_core.WritableSignal<boolean>;
+    private readonly resolvedLocale;
+    private readonly formatter;
     protected readonly datePart: _angular_core.Signal<string>;
     protected readonly timePart: _angular_core.Signal<string>;
     protected readonly calRange: _angular_core.Signal<CalendarRange>;
@@ -4572,7 +4831,7 @@ declare class BuiDatetimePicker implements ControlValueAccessor {
     setDisabledState(isDisabled: boolean): void;
     private todayIso;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<BuiDatetimePicker, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<BuiDatetimePicker, "bui-datetime-picker", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "range": { "alias": "range"; "required": false; "isSignal": true; }; "months": { "alias": "months"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "minDate": { "alias": "minDate"; "required": false; "isSignal": true; }; "maxDate": { "alias": "maxDate"; "required": false; "isSignal": true; }; "captionLayout": { "alias": "captionLayout"; "required": false; "isSignal": true; }; "seconds": { "alias": "seconds"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "userClass": { "alias": "class"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "range": "rangeChange"; "disabled": "disabledChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<BuiDatetimePicker, "bui-datetime-picker", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "range": { "alias": "range"; "required": false; "isSignal": true; }; "months": { "alias": "months"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "timeLabel": { "alias": "timeLabel"; "required": false; "isSignal": true; }; "minDate": { "alias": "minDate"; "required": false; "isSignal": true; }; "maxDate": { "alias": "maxDate"; "required": false; "isSignal": true; }; "captionLayout": { "alias": "captionLayout"; "required": false; "isSignal": true; }; "seconds": { "alias": "seconds"; "required": false; "isSignal": true; }; "timeMode": { "alias": "timeMode"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "userClass": { "alias": "class"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "dateFormat": { "alias": "dateFormat"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "range": "rangeChange"; "disabled": "disabledChange"; }, never, never, true, never>;
 }
 
 type AutocompleteValue = string | readonly string[];
@@ -4956,6 +5215,18 @@ declare class BuiGantt {
     /** ISO end date overriding the computed range maximum; empty derives it from tasks. */
     readonly end: _angular_core.InputSignal<string>;
     readonly userClass: _angular_core.InputSignal<ClassValue>;
+    /** BCP 47 locale used for the axis bound labels. Defaults to the app's `LOCALE_ID`. */
+    readonly locale: _angular_core.InputSignal<string | undefined>;
+    /**
+     * `Intl.DateTimeFormat` options for the axis bound labels. Replaces the default wholesale, so
+     * `{ dateStyle: 'short' }` is valid (its options cannot be mixed with `month`/`day`).
+     */
+    readonly dateFormat: _angular_core.InputSignal<Intl.DateTimeFormatOptions>;
+    /** Text shown when there are no tasks to plot. Falls back to `provideBuiLabels`. */
+    readonly emptyLabel: _angular_core.InputSignal<string | undefined>;
+    protected readonly emptyText: _angular_core.Signal<string>;
+    private readonly resolvedLocale;
+    private readonly formatter;
     protected readonly milestoneRows: _angular_core.Signal<{
         name: string;
         left: number;
@@ -4965,8 +5236,12 @@ declare class BuiGantt {
     protected readonly rangeStart: _angular_core.Signal<string>;
     protected readonly rangeEnd: _angular_core.Signal<string>;
     protected readonly computedClass: _angular_core.Signal<string>;
+    private label;
+    /** `Intl` throws on an invalid date where `toLocaleDateString` returned "Invalid Date"; an
+     *  empty bound (a task with no `start`) is a caller mistake, not a reason to break the chart. */
+    private format;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<BuiGantt, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<BuiGantt, "bui-gantt", never, { "tasks": { "alias": "tasks"; "required": false; "isSignal": true; }; "milestones": { "alias": "milestones"; "required": false; "isSignal": true; }; "start": { "alias": "start"; "required": false; "isSignal": true; }; "end": { "alias": "end"; "required": false; "isSignal": true; }; "userClass": { "alias": "class"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<BuiGantt, "bui-gantt", never, { "tasks": { "alias": "tasks"; "required": false; "isSignal": true; }; "milestones": { "alias": "milestones"; "required": false; "isSignal": true; }; "start": { "alias": "start"; "required": false; "isSignal": true; }; "end": { "alias": "end"; "required": false; "isSignal": true; }; "userClass": { "alias": "class"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "dateFormat": { "alias": "dateFormat"; "required": false; "isSignal": true; }; "emptyLabel": { "alias": "emptyLabel"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 interface SchedulerEvent {
@@ -5225,5 +5500,5 @@ declare class BuiQrCode {
 /** Encode `text` into a QR module matrix (true = dark). Level M, versions 1-10. */
 declare function encodeQr(text: string): boolean[][];
 
-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, BuiDateRangePicker, 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, BuiIconTile, BuiImage, BuiInfiniteScroll, BuiInput, BuiInputField, 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, BuiMoneyInput, 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, BuiSidebarInset, BuiSidebarMenuButton, BuiSidebarProvider, BuiSidebarState, BuiSidebarTrigger, 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 };
-export type { AddToCartSize, AlertTone, AlertVariant, AutocompleteSize, BadgeIntensity, BadgeSize, BadgeTone, BadgeVariant, BuiLabels, ButtonSize, ButtonVariant, CalendarMode, CalendarRange, CardVariant, CarouselOrientation, CartItem, ChartSeries, CheckboxTone, ComboboxOption, CommandGroup, CommandItem, ComparisonRow, ConfettiDirection, ContextMenuItem, CurrencyDisplay, DataTableColumn, DateRangePreset, DialogSize, GalleryImage, GanttMilestone, GanttTask, GroupAvatar, IconTileShape, IconTileSize, IconTileTone, InputSize, KanbanCard, KanbanColumn, Mention, NavMenuItem, NavMenuLink, NotificationItem, NumberInputSize, OrgNode, PhoneCountry, PopoverSide, RepeaterField, SchedulerEvent, ScrollspyItem, SegmentOption, SelectOption, SeparatorOrientation, SpeedDialAction, SwitchSize, TextareaSize, ThemeMode, TimeFieldMode, ToastOptions, ToastTone, TooltipSide, TourStep, TreeItem, TreeTableColumn, TreeTableRow, VariantOption };
+export { BUI_DEFAULT_LABELS, BUI_GRID_CALENDAR, 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, BuiDateRangePicker, 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, BuiIconTile, BuiImage, BuiInfiniteScroll, BuiInput, BuiInputField, 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, BuiMoneyInput, 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, BuiSidebarInset, BuiSidebarMenuButton, BuiSidebarProvider, BuiSidebarState, BuiSidebarTrigger, 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, buiLocale, buiWeekInfo, buttonVariants, cn, encodeQr, provideBuiLabels, toggleVariants };
+export type { AddToCartSize, AlertTone, AlertVariant, AutocompleteSize, BadgeIntensity, BadgeSize, BadgeTone, BadgeVariant, BuiLabels, BuiWeekInfo, ButtonSize, ButtonVariant, CalendarMode, CalendarRange, CardVariant, CarouselOrientation, CartItem, ChartSeries, CheckboxTone, ComboboxOption, CommandGroup, CommandItem, ComparisonRow, ConfettiDirection, ContextMenuItem, CurrencyDisplay, DataTableColumn, DateRangePreset, DialogSize, GalleryImage, GanttMilestone, GanttTask, GroupAvatar, IconTileShape, IconTileSize, IconTileTone, InputSize, KanbanCard, KanbanColumn, Mention, NavMenuItem, NavMenuLink, NotificationItem, NumberInputSize, OrgNode, PhoneCountry, PopoverSide, RepeaterField, SchedulerEvent, ScrollspyItem, SegmentOption, SelectOption, SeparatorOrientation, SpeedDialAction, SwitchSize, TextareaSize, ThemeMode, TimeFieldHourCycle, TimeFieldMode, ToastOptions, ToastTone, TooltipSide, TourStep, TreeItem, TreeTableColumn, TreeTableRow, VariantOption, WeekdayFormat };