mn-angular-lib 1.0.162 → 1.0.163

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mn-angular-lib",
-  "version": "1.0.162",
+  "version": "1.0.163",
   "peerDependencies": {
     "@angular/common": "^21.1.3",
     "@angular/core": "^21.1.3",

package/types/mn-angular-lib.d.ts

@@ -2826,6 +2826,8 @@ type MnMultiSelectUIConfig = {
     errorMessages?: Record<string, string>;
     /** Text shown when no options match the search filter */
     noOptionsFound?: string;
+    /** Placeholder and accessible name for the dropdown's search input */
+    searchPlaceholder?: string;
 };
 
 declare const MN_MULTI_SELECT_CONFIG: InjectionToken<MnMultiSelectUIConfig>;
@@ -3047,6 +3049,34 @@ declare class MnMultiSelect implements OnInit {
      * is selected, then `collapsePlaceholder`, then `"{count} selected"`.
      */
     get collapseSummaryText(): string;
+    /** Trigger text shown while nothing is selected. */
+    get placeholderLabel(): string;
+    /**
+     * Placeholder and accessible name of the dropdown's search input.
+     *
+     * Search auto-enables at `searchThreshold` options, so this box appears without any
+     * call site opting in — which is exactly why it must be translatable without one.
+     */
+    get searchPlaceholderLabel(): string;
+    /** Empty text shown when the search filters every option away. */
+    get noOptionsLabel(): string;
+    /**
+     * Resolves one of the component's own labels, preferring what the caller gave it
+     * and falling back through the config layer, a conventional translation key and
+     * finally a readable English default.
+     *
+     * Mirrors `MnCollectionBase.resolveLabel`. Every string this component puts on
+     * screen that is not caller data goes through here: without the key step a
+     * consumer could only translate these by repeating the same literal at every call
+     * site, which is how "Search..." ends up in English on an otherwise Dutch page.
+     *
+     * @param explicit The label the caller passed through `props`, if any.
+     * @param key The conventional translation key to try next.
+     * @param fallback The English text used when neither resolves.
+     * @param configured The value the config layer resolved, if any.
+     * @returns The resolved label.
+     */
+    private resolveLabel;
     handleBlur(): void;
     get control(): _angular_forms.AbstractControl<any, any, any> | null;
     get showError(): boolean;
@@ -3964,6 +3994,8 @@ type MnSelectUIConfig = {
     errorMessages?: Record<string, string>;
     /** Text shown when no options match the search filter */
     noOptionsFound?: string;
+    /** Placeholder and accessible name for the dropdown's search input */
+    searchPlaceholder?: string;
 };
 
 declare const MN_SELECT_CONFIG: InjectionToken<MnSelectUIConfig>;
@@ -4077,6 +4109,30 @@ declare class MnSelect implements OnInit {
     get selectedOption(): MnSelectOption | undefined;
     /** The label shown in the trigger: the selected option, else the placeholder. */
     get displayText(): string;
+    /** Trigger text shown while no option is selected. */
+    get placeholderLabel(): string;
+    /** Placeholder and accessible name of the dropdown's search input. */
+    get searchPlaceholderLabel(): string;
+    /** Empty text shown when the search filters every option away. */
+    get noOptionsLabel(): string;
+    /**
+     * Resolves one of the component's own labels, preferring what the caller gave it
+     * and falling back through the config layer, a conventional translation key and
+     * finally a readable English default.
+     *
+     * Mirrors `MnCollectionBase.resolveLabel` and its twin in `MnMultiSelect`. Without
+     * the key step a consumer could only translate these by repeating the same literal
+     * at every call site, and the search box in particular auto-enables on option
+     * count — it appears without anyone asking for it, so it must be translatable
+     * without anyone asking either.
+     *
+     * @param explicit The label the caller passed through `props`, if any.
+     * @param key The conventional translation key to try next.
+     * @param fallback The English text used when neither resolves.
+     * @param configured The value the config layer resolved, if any.
+     * @returns The resolved label.
+     */
+    private resolveLabel;
     get showError(): boolean;
     get errorMessages(): string[];
     get errorMessage(): string | null;
@@ -7362,6 +7418,8 @@ declare class MnList<T = unknown> extends MnSelectableCollectionBase<T, ListData
     protected applyFilter(searchForItems: boolean): void;
     /** Accessible name for the scrollable list region. */
     get listRegionLabel(): string;
+    /** Label on the header checkbox that selects or clears every visible row. */
+    get selectAllLabel(): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<MnList<any>, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<MnList<any>, "mn-list", never, {}, { "itemClick": "itemClick"; }, never, never, true, never>;
 }
@@ -8804,8 +8862,12 @@ declare class MnBreadcrumbs {
     crumbClick: EventEmitter<MnBreadcrumbItem>;
     /** Emits when the fallback "Back" control is activated. */
     back: EventEmitter<void>;
-    /** Default translation key / literal for the Back control's label. */
-    private static readonly DEFAULT_BACK_LABEL;
+    /** Conventional key an app defines to translate the Back control's label. */
+    private static readonly BACK_LABEL_KEY;
+    /** Conventional key an app defines to name the navigation landmark. */
+    private static readonly NAV_LABEL_KEY;
+    /** Resolves this component's own labels against the app's bundle. */
+    private readonly lang;
     /** Resolved tailwind-variants slot functions for the current size. */
     get styles(): {
         root: (slotProps?: ({
@@ -8846,9 +8908,25 @@ declare class MnBreadcrumbs {
             size?: "sm" | "md" | undefined;
         } & tailwind_variants.ClassProp<tailwind_merge.ClassNameValue>) | undefined) => string;
     } & {};
+    /**
+     * Accessible name of the `<nav>` landmark.
+     *
+     * A landmark's name is announced verbatim, so leaving it as a hardcoded English
+     * "Breadcrumb" put one English word into every page of a translated app — in the
+     * one place only screen-reader users hear.
+     */
+    get navLabel(): string;
     /** Whether a linkable trail should render (vs the Back fallback). */
     get hasTrail(): boolean;
-    /** Label for the Back control — the configured key/literal, or the default. */
+    /**
+     * Text of the Back control, already translated.
+     *
+     * `data.backLabel` is a key (or a literal, which `translate` passes through
+     * unchanged). Without one this falls back to the conventional key and then to
+     * English — never to a raw key: the old default was the bare key `'back'`, which
+     * the template's translate pipe echoed as lowercase "back" in every app that had
+     * not happened to define it.
+     */
     get backLabel(): string;
     /** The last crumb is the current page and is rendered as plain text. */
     isCurrent(index: number): boolean;