@lifecorner/angular-ui-kit 3.30.2 → 3.32.0

package/types/lifecorner-angular-ui-kit-bottom-nav.d.ts

@@ -1,4 +1,12 @@
+import { BadgeVariant } from "@lifecorner/angular-ui-kit/badge";
 import * as i0 from "@angular/core";
+/** A count or status on a bottom-nav entry (`BottomNavItem.badge`, `moreBadge`). */
+export interface BottomNavBadge {
+  /** Text or number inside the badge. */
+  value: string | number;
+  /** Badge colour (`lc-badge` variant). */
+  variant?: BadgeVariant;
+}
 /**
  * A destination in the bottom navigation bar. A subset of `NavigationItem`, so
  * the side navigation's items can be passed as they are (sections and children
@@ -16,12 +24,7 @@ export interface BottomNavItem {
   /** Sort order; items without one keep their array order. */
   displayOrder?: number;
   /** Count or status shown on the icon; read out through `badgeAriaLabel`. */
-  badge?: {
-    /** Text or number inside the badge. */
-    value: string | number;
-    /** Badge colour (`lc-badge` variant). */
-    variant?: 'default' | 'primary' | 'success' | 'warning' | 'error' | 'info';
-  };
+  badge?: BottomNavBadge;
 }
 /** Surface of the bar: `docked` spans the bottom edge, `floating` is an inset pill. */
 export type BottomNavVariant = 'docked' | 'floating';
@@ -129,8 +132,22 @@ export declare class BottomNavComponent {
    */
   readonly moreRoute: import("@angular/core").InputSignal<string>;
   /**
-   * Text read after an item's label when it has a badge; `{value}` is
-   * replaced with the badge value (e.g. "3 new").
+   * Badge on the "More" entry (on overflow or with `showMore`), e.g. the open
+   * tasks on the pages behind it: drawn like an item badge and read after the
+   * label through `badgeAriaLabel`. The kit doesn't add up the hidden
+   * destinations' badges; pass the value to show. It sits on the bar's last
+   * entry, so keep it to two characters (`'9+'`). `null` or `undefined`: no
+   * badge.
+   *
+   * @default null
+   */
+  readonly moreBadge: import("@angular/core").InputSignal<BottomNavBadge | null | undefined>;
+  /**
+   * Text read after an item's label, and after the "More" label with
+   * `moreBadge`, when it has a badge; `{value}` is replaced with the badge
+   * value (e.g. "3 new").
+   *
+   * @default '{value} new'
    */
   readonly badgeAriaLabel: import("@angular/core").InputSignal<string>;
   /** The current item was tapped again (e.g. scroll the page to the top). */
@@ -205,6 +222,11 @@ export declare class BottomNavComponent {
       "required": false;
       "isSignal": true;
     };
+    "moreBadge": {
+      "alias": "moreBadge";
+      "required": false;
+      "isSignal": true;
+    };
     "badgeAriaLabel": {
       "alias": "badgeAriaLabel";
       "required": false;

package/types/lifecorner-angular-ui-kit-combobox.d.ts

@@ -76,6 +76,16 @@ export declare class ComboboxComponent implements ControlValueAccessor {
   readonly createOptionLabel: import("@angular/core").InputSignal<string>;
   /** Size */
   readonly size: import("@angular/core").InputSignal<ComboboxSize>;
+  /**
+   * Whether the list opens when the field gets focus (3.32, request 051).
+   * With `false`, focus alone (`focus()` from the page, Tab) leaves the list
+   * closed and `aria-expanded="false"`; a click or tap on the field, typing or
+   * ArrowDown opens it. Use it in forms that move focus into the field
+   * themselves, on open or to the first invalid field after a rejected save.
+   * Escape and choosing an option work as before.
+   * @default true
+   */
+  readonly openOnFocus: import("@angular/core").InputSignal<boolean>;
   /**
    * The `value` of the selected option, two-way (3.29, regeln row 2):
    * `[(selectedValue)]="month"`. Shows the matching option's label (from
@@ -162,10 +172,16 @@ export declare class ComboboxComponent implements ControlValueAccessor {
    * and its buttons keeps focus where it is (no blur, so the list stays open).
    */
   protected onFrameMousedown(event: MouseEvent): void;
-  /** A click on the frame beside the input and its buttons focuses the input. */
+  /**
+   * A click on the frame beside the input and its buttons focuses the input.
+   * With `openOnFocus` off (3.32, request 051), a click or tap on the input or
+   * the frame also opens the list, which focus alone no longer does.
+   */
   protected onFrameClick(event: MouseEvent): void;
   protected onInputChange(event: Event): void;
   protected onInputFocus(): void;
+  /** Opens the list when there is something to show: a long enough query, or options. */
+  private openIfAny;
   protected onInputBlur(): void;
   protected onKeydown(event: KeyboardEvent): void;
   protected selectOption(option: ComboboxOption): void;
@@ -254,6 +270,11 @@ export declare class ComboboxComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "openOnFocus": {
+      "alias": "openOnFocus";
+      "required": false;
+      "isSignal": true;
+    };
     "selectedValue": {
       "alias": "selectedValue";
       "required": false;

package/types/lifecorner-angular-ui-kit-select.d.ts

@@ -24,6 +24,8 @@ export type SelectValue = string | number | string[] | number[] | null;
  * - CDK overlay positioning
  * - ControlValueAccessor integration for reactive forms
  *
+ * The dropdown takes the `lang` of the host's closest `[lang]` (3.31).
+ *
  * @example
  * ```html
  * <lc-select [options]="options" placeholder="Choose" [(ngModel)]="selected" />
@@ -115,6 +117,13 @@ export declare class SelectComponent implements ControlValueAccessor {
   private readonly formDisabled;
   /** Effective disabled state: the `disabled` input OR the form control's disabled state. */
   readonly isDisabled: import("@angular/core").Signal<boolean>;
+  private readonly host;
+  /**
+   * `lang` of the open dropdown (3.31, request 050, WCAG 3.1.2): the overlay
+   * renders under `<body>`, so it takes the host's closest `[lang]`, else none.
+   * Read at every opening; `null` while closed, so the server never reads the DOM.
+   */
+  protected readonly panelLang: import("@angular/core").Signal<string | null>;
   readonly filteredOptions: import("@angular/core").Signal<SelectOption[]>;
   /** Keyboard highlight; resets whenever the visible option list changes so it never points at a stale row. */
   readonly highlightedIndex: import("@angular/core").WritableSignal<number>;

package/types/lifecorner-angular-ui-kit-sidenav.d.ts

@@ -25,7 +25,9 @@ export type SidenavVariant = 'default' | 'transparent';
  * - Hierarchical navigation with collapsible groups (up to 3 levels)
  * - Section headlines for item grouping with optional action buttons
  * - Action buttons on any item (hover-reveal)
- * - Badge support on items (count / status indicator)
+ * - Badge support on items (count / status indicator), read after the label
+ *   through `badgeAriaLabel` (3.31); on the collapsed rail the label and the
+ *   badge text name the item
  * - One current item, announced and painted alike: the link for `activeRoute`
  *   (or, without it, the one the router's URL matches) gets
  *   `aria-current="page"` and the current look, every other link neither
@@ -202,6 +204,16 @@ export declare class SidenavComponent implements OnDestroy {
   readonly collapseTitle: import("@angular/core").InputSignal<string>;
   /** Accessible name of the close button (drawer mode). */
   readonly closeAriaLabel: import("@angular/core").InputSignal<string>;
+  /**
+   * Text read after an item's label when it has a badge, at every level. On
+   * the collapsed rail, where labels are hidden, the label and this text name
+   * the item. `{value}` is replaced with the badge value, e.g.
+   * `'{value} offen'` → "Stammdaten 1 offen". The badge itself is hidden from
+   * screen readers. Empty: the badge isn't read.
+   *
+   * @default '{value}'
+   */
+  readonly badgeAriaLabel: import("@angular/core").InputSignal<string>;
   /**
    * Ids of the expanded parent items — the single source of truth for
    * `isExpanded`. Seeded with the current item's parent whenever it changes
@@ -265,6 +277,8 @@ export declare class SidenavComponent implements OnDestroy {
   protected readonly brandInitial: import("@angular/core").Signal<string>;
   /** Whether the rail shows only icons (as `lc-sidenav--collapsed`). */
   protected readonly isRail: import("@angular/core").Signal<boolean>;
+  /** Visually hidden badge text: `badgeAriaLabel` with `{value}`; on the rail, where labels are hidden, after the label. */
+  protected badgeText(item: NavigationItem): string;
   /** The collapse button's accessible name: what a press does. */
   protected readonly collapseToggleLabel: import("@angular/core").Signal<string>;
   /** The collapse button's chevron points where the rail moves: ⟨ to collapse a left rail, ⟩ to expand it (mirrored on the right). */
@@ -458,6 +472,11 @@ export declare class SidenavComponent implements OnDestroy {
       "required": false;
       "isSignal": true;
     };
+    "badgeAriaLabel": {
+      "alias": "badgeAriaLabel";
+      "required": false;
+      "isSignal": true;
+    };
   }, {
     "collapsed": "collapsedChange";
     "closed": "closed";

package/types/lifecorner-angular-ui-kit-tooltip.d.ts

@@ -15,6 +15,12 @@ export declare class TooltipContentComponent {
  * the preferred one does not fit the viewport, and can be dismissed with
  * Escape (WCAG 1.4.13).
  *
+ * The tooltip takes the `lang` of the host's closest `[lang]` (3.31).
+ *
+ * Shows on hover and on keyboard focus of the host or of an element inside it
+ * (3.32). On a wrapper such as `lc-button`, the tooltip describes and anchors
+ * to the wrapped `<button>`.
+ *
  * @example
  * ```html
  * <button lcTooltip="Click me!" tooltipPosition="top">
@@ -48,10 +54,17 @@ export declare class TooltipDirective implements OnDestroy {
    * @default false
    */
   tooltipDisabled: import("@angular/core").InputSignal<boolean>;
-  /** Id of the tooltip element; the host's `aria-describedby` points at it while shown. */
+  /**
+   * Id of the tooltip element; while shown, the `aria-describedby` of the
+   * described element (the host, or the focusable element it wraps, such as
+   * `lc-button`'s `<button>`) points at it.
+   */
   readonly tooltipId: string;
   private overlayRef?;
   private tooltipRef?;
+  private positionStrategy?;
+  /** The element whose `aria-describedby` holds the tooltip id while shown. */
+  private describedEl?;
   private positionSubscription?;
   private showTimeout?;
   private hideTimeout?;
@@ -66,6 +79,14 @@ export declare class TooltipDirective implements OnDestroy {
   onMouseLeave(): void;
   onFocus(): void;
   onBlur(): void;
+  /**
+   * 3.32 (request 051, 050-f3): `focus` does not bubble, so focus on an
+   * element inside the host (`lc-button`'s `<button>`) arrives as `focusin`.
+   * The host's own focus is handled by `onFocus`, so it is skipped here.
+   */
+  onFocusIn(event: FocusEvent): void;
+  /** Hides when focus leaves the host from an element inside it (not when it moves within). */
+  onFocusOut(event: FocusEvent): void;
   /**
    * Show tooltip programmatically
    */
@@ -84,8 +105,13 @@ export declare class TooltipDirective implements OnDestroy {
   /** Preferred position first, then the fallbacks the overlay may flip to. */
   private getPositions;
   private setPositionClass;
-  /** Append the tooltip id to the host's aria-describedby without clobbering ids the caller set. */
+  /** The described element: the host if it is a control, else the first control inside it, else the host. */
+  private resolveControl;
+  /** The overlay origin: the control when it is the host's only element child (a wrapper), else the host. */
+  private resolveAnchor;
+  /** Append the tooltip id to the element's aria-describedby without clobbering ids the caller set. */
   private addDescribedBy;
+  /** Removes the tooltip id from the element it was added to, keeping the other ids. */
   private removeDescribedBy;
   private clearTimeouts;
   private cleanup;