@besaitech/ng-design-system 0.0.32 → 0.0.33

package/index.d.ts

@@ -459,6 +459,26 @@ declare class SdsCalendar {
     readonly firstDayOfWeek: _angular_core.InputSignal<0 | 1>;
     readonly locale: _angular_core.InputSignal<string>;
     readonly showActions: _angular_core.InputSignal<boolean>;
+    /**
+     * Accessible name for the calendar container. French default so existing consumers are unchanged,
+     * but an app serving more than one language MUST translate it.
+     */
+    readonly calendarLabel: _angular_core.InputSignal<string>;
+    /**
+     * Accessible name for the "previous" nav button. It is icon-only, so this string is its ONLY
+     * accessible name — a hardcoded French one is simply wrong in every other locale. Translate it in
+     * the consuming app.
+     */
+    readonly previousLabel: _angular_core.InputSignal<string>;
+    /** Accessible name for the icon-only "next" nav button. See {@link previousLabel}. */
+    readonly nextLabel: _angular_core.InputSignal<string>;
+    /**
+     * Visible text of the "today" action (shown when {@link showActions} is true). Translate it in the
+     * consuming app — the library ships no i18n of its own.
+     */
+    readonly todayActionLabel: _angular_core.InputSignal<string>;
+    /** Visible text of the "clear" action. See {@link todayActionLabel}. */
+    readonly clearActionLabel: _angular_core.InputSignal<string>;
     /** Emitted when a concrete date is picked (day click or "Aujourd'hui"). */
     readonly dateSelect: _angular_core.OutputEmitterRef<Date>;
     protected readonly view: _angular_core.WritableSignal<CalView>;
@@ -505,7 +525,7 @@ declare class SdsCalendar {
     protected dayClass(cell: DayCell): string;
     protected cellClass(selected: boolean, current: boolean, disabled: boolean): string;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdsCalendar, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdsCalendar, "sds-calendar", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "firstDayOfWeek": { "alias": "firstDayOfWeek"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "showActions": { "alias": "showActions"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "dateSelect": "dateSelect"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdsCalendar, "sds-calendar", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "firstDayOfWeek": { "alias": "firstDayOfWeek"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "showActions": { "alias": "showActions"; "required": false; "isSignal": true; }; "calendarLabel": { "alias": "calendarLabel"; "required": false; "isSignal": true; }; "previousLabel": { "alias": "previousLabel"; "required": false; "isSignal": true; }; "nextLabel": { "alias": "nextLabel"; "required": false; "isSignal": true; }; "todayActionLabel": { "alias": "todayActionLabel"; "required": false; "isSignal": true; }; "clearActionLabel": { "alias": "clearActionLabel"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "dateSelect": "dateSelect"; }, never, never, true, never>;
 }
 
 type SdsDatePickerSize = 'sm' | 'md' | 'lg';
@@ -537,6 +557,31 @@ declare class SdsDatePicker implements ControlValueAccessor, OnDestroy {
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Custom display formatter (default dd/MM/yyyy). */
     readonly format: _angular_core.InputSignal<(d: Date) => string>;
+    /**
+     * Accessible name for the clear button. French default so existing consumers are unchanged, but an
+     * app serving more than one language MUST translate it — it is an icon-only control, so this string
+     * is its only name.
+     */
+    readonly clearLabel: _angular_core.InputSignal<string>;
+    /**
+     * Accessible name for the icon-only calendar toggle while the panel is CLOSED. See
+     * {@link clearLabel} for why this has to be translatable.
+     */
+    readonly openCalendarLabel: _angular_core.InputSignal<string>;
+    /** Accessible name for the calendar toggle while the panel is OPEN. See {@link openCalendarLabel}. */
+    readonly closeCalendarLabel: _angular_core.InputSignal<string>;
+    /** Accessible name for the overlay dialog that holds the calendar. */
+    readonly panelLabel: _angular_core.InputSignal<string>;
+    /**
+     * Labels forwarded to the embedded <sds-calendar>. They live here because the picker is how the
+     * calendar is normally reached — without forwarding, a consumer could translate the field but not
+     * the panel it opens. Defaults match SdsCalendar's own, so nothing changes for existing consumers.
+     */
+    readonly calendarLabel: _angular_core.InputSignal<string>;
+    readonly previousLabel: _angular_core.InputSignal<string>;
+    readonly nextLabel: _angular_core.InputSignal<string>;
+    readonly todayActionLabel: _angular_core.InputSignal<string>;
+    readonly clearActionLabel: _angular_core.InputSignal<string>;
     protected readonly value: _angular_core.WritableSignal<Date | null>;
     protected readonly open: _angular_core.WritableSignal<boolean>;
     private readonly cvaDisabled;
@@ -569,7 +614,7 @@ declare class SdsDatePicker implements ControlValueAccessor, OnDestroy {
     registerOnTouched(fn: () => void): void;
     setDisabledState(isDisabled: boolean): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdsDatePicker, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdsDatePicker, "sds-date-picker", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "firstDayOfWeek": { "alias": "firstDayOfWeek"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "inline": { "alias": "inline"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "showActions": { "alias": "showActions"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "format": { "alias": "format"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdsDatePicker, "sds-date-picker", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "firstDayOfWeek": { "alias": "firstDayOfWeek"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "inline": { "alias": "inline"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "showActions": { "alias": "showActions"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "format": { "alias": "format"; "required": false; "isSignal": true; }; "clearLabel": { "alias": "clearLabel"; "required": false; "isSignal": true; }; "openCalendarLabel": { "alias": "openCalendarLabel"; "required": false; "isSignal": true; }; "closeCalendarLabel": { "alias": "closeCalendarLabel"; "required": false; "isSignal": true; }; "panelLabel": { "alias": "panelLabel"; "required": false; "isSignal": true; }; "calendarLabel": { "alias": "calendarLabel"; "required": false; "isSignal": true; }; "previousLabel": { "alias": "previousLabel"; "required": false; "isSignal": true; }; "nextLabel": { "alias": "nextLabel"; "required": false; "isSignal": true; }; "todayActionLabel": { "alias": "todayActionLabel"; "required": false; "isSignal": true; }; "clearActionLabel": { "alias": "clearActionLabel"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 type SdsSelectSize = 'sm' | 'md' | 'lg';
@@ -863,6 +908,40 @@ declare class SdsPhoneInput implements ControlValueAccessor, Validator, OnDestro
     /** Show an example number as a hint when no [hint] is provided. */
     readonly showExampleHint: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly requiredMessage: _angular_core.InputSignal<string>;
+    /**
+     * Accessible name of the country selector. `{country}` is replaced with the selected country's
+     * name. A token rather than a prefix because word order differs per language. French default so
+     * existing consumers are unchanged; translate it in any app serving more than one language.
+     *
+     * Note the interpolated country NAME still comes from the library's built-in country table, which
+     * is French-only — translating this template fixes the wrapper, not the name inside it.
+     */
+    readonly countryLabel: _angular_core.InputSignal<string>;
+    /**
+     * Accessible name for the clear button. It is icon-only, so this string is its ONLY accessible
+     * name — a hardcoded French one is simply wrong in every other locale.
+     */
+    readonly clearLabel: _angular_core.InputSignal<string>;
+    /** Accessible name for the country-search field inside the dropdown. */
+    readonly searchLabel: _angular_core.InputSignal<string>;
+    /** Placeholder text of the country-search field. */
+    readonly searchPlaceholder: _angular_core.InputSignal<string>;
+    /** Shown in place of the list when no country matches the filter. */
+    readonly noResultsLabel: _angular_core.InputSignal<string>;
+    /**
+     * Built-in validation messages. `{lengths}` is replaced with the country's accepted national
+     * lengths, joined with {@link lengthSeparator}. Siblings of {@link requiredMessage}, which was
+     * already translatable — these two were not, so an English or Dutch app showed French errors.
+     */
+    readonly incompleteMessage: _angular_core.InputSignal<string>;
+    readonly invalidMessage: _angular_core.InputSignal<string>;
+    /** Joins the accepted lengths when a country allows more than one (e.g. "8 ou 9"). */
+    readonly lengthSeparator: _angular_core.InputSignal<string>;
+    /**
+     * Auto-generated example hint (see {@link showExampleHint}). `{number}` is replaced with the
+     * formatted international example number.
+     */
+    readonly exampleHintTemplate: _angular_core.InputSignal<string>;
     /** Emitted with the parsed parts whenever the number or country changes. */
     readonly phoneChange: _angular_core.OutputEmitterRef<SdsPhoneValue>;
     protected readonly national: _angular_core.WritableSignal<string>;
@@ -883,6 +962,7 @@ declare class SdsPhoneInput implements ControlValueAccessor, Validator, OnDestro
     protected readonly display: _angular_core.Signal<string>;
     protected readonly placeholderText: _angular_core.Signal<string>;
     protected readonly autoHint: _angular_core.Signal<string>;
+    protected readonly countryAriaLabel: _angular_core.Signal<string>;
     protected readonly e164: _angular_core.Signal<string>;
     /** Non-empty but national length is not valid for the country. */
     protected readonly invalid: _angular_core.Signal<boolean>;
@@ -923,7 +1003,7 @@ declare class SdsPhoneInput implements ControlValueAccessor, Validator, OnDestro
     validate(_control: AbstractControl): ValidationErrors | null;
     registerOnValidatorChange(fn: () => void): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdsPhoneInput, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdsPhoneInput, "sds-phone-input", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "defaultCountry": { "alias": "defaultCountry"; "required": false; "isSignal": true; }; "preferredCountries": { "alias": "preferredCountries"; "required": false; "isSignal": true; }; "onlyCountries": { "alias": "onlyCountries"; "required": false; "isSignal": true; }; "showExampleHint": { "alias": "showExampleHint"; "required": false; "isSignal": true; }; "requiredMessage": { "alias": "requiredMessage"; "required": false; "isSignal": true; }; }, { "phoneChange": "phoneChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdsPhoneInput, "sds-phone-input", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "defaultCountry": { "alias": "defaultCountry"; "required": false; "isSignal": true; }; "preferredCountries": { "alias": "preferredCountries"; "required": false; "isSignal": true; }; "onlyCountries": { "alias": "onlyCountries"; "required": false; "isSignal": true; }; "showExampleHint": { "alias": "showExampleHint"; "required": false; "isSignal": true; }; "requiredMessage": { "alias": "requiredMessage"; "required": false; "isSignal": true; }; "countryLabel": { "alias": "countryLabel"; "required": false; "isSignal": true; }; "clearLabel": { "alias": "clearLabel"; "required": false; "isSignal": true; }; "searchLabel": { "alias": "searchLabel"; "required": false; "isSignal": true; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; "isSignal": true; }; "noResultsLabel": { "alias": "noResultsLabel"; "required": false; "isSignal": true; }; "incompleteMessage": { "alias": "incompleteMessage"; "required": false; "isSignal": true; }; "invalidMessage": { "alias": "invalidMessage"; "required": false; "isSignal": true; }; "lengthSeparator": { "alias": "lengthSeparator"; "required": false; "isSignal": true; }; "exampleHintTemplate": { "alias": "exampleHintTemplate"; "required": false; "isSignal": true; }; }, { "phoneChange": "phoneChange"; }, never, never, true, never>;
 }
 
 type SdsPaginatorSize = 'sm' | 'md' | 'lg';
@@ -978,6 +1058,28 @@ declare class SdsPaginator {
     readonly showJumpToPageInput: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly rowsPerPageLabel: _angular_core.InputSignal<string>;
     readonly jumpToPageLabel: _angular_core.InputSignal<string>;
+    /**
+     * Accessible name for the <nav> wrapping the page controls, and for the four icon-only
+     * first/prev/next/last buttons. Those buttons have no text, so these strings are their ONLY
+     * accessible names — the French defaults keep existing consumers unchanged, but an app serving more
+     * than one language MUST pass translated values.
+     */
+    readonly paginationLabel: _angular_core.InputSignal<string>;
+    readonly firstPageLabel: _angular_core.InputSignal<string>;
+    readonly previousPageLabel: _angular_core.InputSignal<string>;
+    readonly nextPageLabel: _angular_core.InputSignal<string>;
+    readonly lastPageLabel: _angular_core.InputSignal<string>;
+    /**
+     * Accessible name of a numbered page link. `{page}` is replaced with the 1-based page number —
+     * a token rather than a prefix because word order is not the same in every language.
+     */
+    readonly pageLinkLabel: _angular_core.InputSignal<string>;
+    /**
+     * Accessible name of the jump-to-page field. Separate from the visible {@link jumpToPageLabel}
+     * ("Aller à") on purpose: the visible text is terse because it sits next to the field, while the
+     * accessible name has to stand alone.
+     */
+    readonly jumpToPageAriaLabel: _angular_core.InputSignal<string>;
     readonly size: _angular_core.InputSignal<SdsPaginatorSize>;
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Fires after any page or page-size change with the full paginator state. */
@@ -990,6 +1092,7 @@ declare class SdsPaginator {
     protected readonly pageLinks: _angular_core.Signal<number[]>;
     protected readonly reportText: _angular_core.Signal<string>;
     protected readonly hostClass: _angular_core.Signal<string>;
+    protected pageLinkAriaLabel(page: number): string;
     protected navClass(isDisabled: boolean): string;
     protected linkClass(active: boolean): string;
     protected firstPage(): void;
@@ -1001,7 +1104,7 @@ declare class SdsPaginator {
     protected onJump(event: Event): void;
     private emit;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdsPaginator, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdsPaginator, "sds-paginator", never, { "totalRecords": { "alias": "totalRecords"; "required": false; "isSignal": true; }; "first": { "alias": "first"; "required": false; "isSignal": true; }; "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "rowsPerPageOptions": { "alias": "rowsPerPageOptions"; "required": false; "isSignal": true; }; "pageLinkSize": { "alias": "pageLinkSize"; "required": false; "isSignal": true; }; "showFirstLastIcon": { "alias": "showFirstLastIcon"; "required": false; "isSignal": true; }; "showPageLinks": { "alias": "showPageLinks"; "required": false; "isSignal": true; }; "showCurrentPageReport": { "alias": "showCurrentPageReport"; "required": false; "isSignal": true; }; "currentPageReportTemplate": { "alias": "currentPageReportTemplate"; "required": false; "isSignal": true; }; "showJumpToPageInput": { "alias": "showJumpToPageInput"; "required": false; "isSignal": true; }; "rowsPerPageLabel": { "alias": "rowsPerPageLabel"; "required": false; "isSignal": true; }; "jumpToPageLabel": { "alias": "jumpToPageLabel"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "first": "firstChange"; "rows": "rowsChange"; "pageChange": "pageChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdsPaginator, "sds-paginator", never, { "totalRecords": { "alias": "totalRecords"; "required": false; "isSignal": true; }; "first": { "alias": "first"; "required": false; "isSignal": true; }; "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "rowsPerPageOptions": { "alias": "rowsPerPageOptions"; "required": false; "isSignal": true; }; "pageLinkSize": { "alias": "pageLinkSize"; "required": false; "isSignal": true; }; "showFirstLastIcon": { "alias": "showFirstLastIcon"; "required": false; "isSignal": true; }; "showPageLinks": { "alias": "showPageLinks"; "required": false; "isSignal": true; }; "showCurrentPageReport": { "alias": "showCurrentPageReport"; "required": false; "isSignal": true; }; "currentPageReportTemplate": { "alias": "currentPageReportTemplate"; "required": false; "isSignal": true; }; "showJumpToPageInput": { "alias": "showJumpToPageInput"; "required": false; "isSignal": true; }; "rowsPerPageLabel": { "alias": "rowsPerPageLabel"; "required": false; "isSignal": true; }; "jumpToPageLabel": { "alias": "jumpToPageLabel"; "required": false; "isSignal": true; }; "paginationLabel": { "alias": "paginationLabel"; "required": false; "isSignal": true; }; "firstPageLabel": { "alias": "firstPageLabel"; "required": false; "isSignal": true; }; "previousPageLabel": { "alias": "previousPageLabel"; "required": false; "isSignal": true; }; "nextPageLabel": { "alias": "nextPageLabel"; "required": false; "isSignal": true; }; "lastPageLabel": { "alias": "lastPageLabel"; "required": false; "isSignal": true; }; "pageLinkLabel": { "alias": "pageLinkLabel"; "required": false; "isSignal": true; }; "jumpToPageAriaLabel": { "alias": "jumpToPageAriaLabel"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "first": "firstChange"; "rows": "rowsChange"; "pageChange": "pageChange"; }, never, never, true, never>;
 }
 
 /** Identifier of a tab / panel pair. Keep types consistent across a tab set. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@besaitech/ng-design-system",
-  "version": "0.0.32",
+  "version": "0.0.33",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"