@sinequa/galactik 2.1.1 → 2.3.0

package/types/sinequa-galactik.d.ts

@@ -14,6 +14,14 @@ import { ToolbarWidget } from "@angular/aria/toolbar";
 import * as i1$1 from "@angular/aria/listbox";
 import * as i1 from "@angular/aria/tree";
 import { Tree, TreeItem, TreeItemGroup } from "@angular/aria/tree";
+/**
+ * Whether the user is on an Apple platform (macOS, iPadOS, iOS).
+ *
+ * An iPad in desktop mode reports itself as a Mac, which is the right answer for its hardware keyboard.
+ * Meant for adapting a *hint* or *adding* a key (a MacBook has no dedicated `Delete`, only `fn+⌫`) — never
+ * for restricting one.
+ */
+export declare function isApplePlatform(): boolean;
 export declare class ArrowDownIcon {
   class: import("@angular/core").InputSignal<string | undefined>;
   classes: import("@angular/core").Signal<string>;
@@ -2264,6 +2272,8 @@ declare function injectPopover(options: {
   config: Signal<PopoverConfig>;
   lockPosition: Signal<boolean>;
   matchTriggerWidth: Signal<boolean>;
+  /** Hides the popover (without closing it) while its trigger is scrolled out of sight. Optional, default `false`. */
+  hideWhenTriggerHidden?: Signal<boolean>;
 }): {
   width: import("@angular/core").WritableSignal<number | undefined>;
   state: import("@angular/core").WritableSignal<"open" | "closed">;
@@ -2314,6 +2324,14 @@ export declare class PopoverDirective {
    * popover element itself instead.
    */
   matchTriggerWidth: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  /**
+   * When true, the popover is hidden (`visibility: hidden`, still open) while its trigger is scrolled
+   * out of sight — out of the list or container it sits in — and reappears with it. Without it, a
+   * popover in the top layer, which no ancestor clips, keeps floating over nothing.
+   *
+   * @default false
+   */
+  hideWhenTriggerHidden: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
   readonly elementRef: ElementRef<HTMLElement>;
   private readonly _isDropdown;
   private readonly _config;
@@ -2355,6 +2373,11 @@ export declare class PopoverDirective {
       "required": false;
       "isSignal": true;
     };
+    "hideWhenTriggerHidden": {
+      "alias": "hideWhenTriggerHidden";
+      "required": false;
+      "isSignal": true;
+    };
   }, {}, never, never, true, never>;
 }
 /** What {@link injectFloatingPanel} needs to know about a panel and the element it hangs from. */
@@ -2393,6 +2416,17 @@ interface FloatingPanelOptions {
    * colours the arrow's visible sides.
    */
   arrow?: () => HTMLElement | null | undefined;
+  /**
+   * Name of a CSS custom property (`"--floating-max-h"`) that receives the height left on the side the panel ended up on
+   * (after `flip`), in pixels, for the panel's own CSS (`max-h-[min(24rem,var(--floating-max-h))]`). Without it, a panel taller
+   * than the room it has runs off the viewport.
+   */
+  maxHeightVariable?: string;
+  /**
+   * Hides the panel (`visibility: hidden`) while the anchor is out of sight — scrolled out of the list it sits in — so that a
+   * panel in the top layer, which no ancestor clips any more, does not float over nothing. A signal read is fine.
+   */
+  hideWhenAnchorHidden?: boolean | (() => boolean);
   /** Runs after each position update, with the anchor and the panel (a submenu that mirrors the anchor's width in a signal…). */
   afterPosition?: (anchor: HTMLElement, panel: HTMLElement) => void;
 }
@@ -3711,7 +3745,7 @@ export declare class ButtonComponent {
   variant: import("@angular/core").InputSignal<"primary" | "secondary" | "none" | "light-accent" | "accent" | "tertiary" | null | undefined>;
   scheme: import("@angular/core").InputSignal<"default" | "neutral" | null | undefined>;
   iconOnly: import("@angular/core").InputSignal<boolean | null | undefined>;
-  size: import("@angular/core").InputSignal<"small" | "sm" | "md" | "xs" | "lg" | "xsmall" | "medium" | "large" | null | undefined>;
+  size: import("@angular/core").InputSignal<"small" | "medium" | "sm" | "md" | "xs" | "lg" | "xsmall" | "large" | null | undefined>;
   variants: import("@angular/core").Signal<string | undefined>;
   static ɵfac: i0.ɵɵFactoryDeclaration<ButtonComponent, never>;
   static ɵdir: i0.ɵɵDirectiveDeclaration<ButtonComponent, "button", never, {
@@ -3755,7 +3789,7 @@ declare const BUTTON_ICON_SOLO_CLASS = "btn-icon-solo";
 declare const buttonVariants: (props?: ({
   variant?: "primary" | "secondary" | "none" | "light-accent" | "accent" | "tertiary" | null | undefined;
   scheme?: "default" | "neutral" | null | undefined;
-  size?: "small" | "sm" | "md" | "xs" | "lg" | "xsmall" | "medium" | "large" | null | undefined;
+  size?: "small" | "medium" | "sm" | "md" | "xs" | "lg" | "xsmall" | "large" | null | undefined;
   iconOnly?: boolean | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 type ButtonVariants = VariantProps<typeof buttonVariants>;
@@ -3779,7 +3813,7 @@ export declare class ToggleComponent {
   /** Palette : `unique` (primaire) ou `multi` (secondaire). */
   readonly variant: import("@angular/core").InputSignal<"multi" | "unique" | null | undefined>;
   /** Taille (`sm`/`md`, alias `small`/`medium`). */
-  readonly size: import("@angular/core").InputSignal<"small" | "sm" | "md" | "medium" | null | undefined>;
+  readonly size: import("@angular/core").InputSignal<"small" | "medium" | "sm" | "md" | null | undefined>;
   /** Pilule carrée (icône seule). */
   readonly iconOnly: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
   /** Discriminant de rendu d'icône (piloté par le consommateur). */
@@ -3852,7 +3886,7 @@ export declare class ToggleItemComponent {
   /** Palette explicite ; à défaut, héritée du `<ToggleGroup>` parent, sinon `unique`. */
   readonly variant: import("@angular/core").InputSignal<"multi" | "unique" | null | undefined>;
   /** Taille (`sm`/`md`, alias `small`/`medium`). */
-  readonly size: import("@angular/core").InputSignal<"small" | "sm" | "md" | "medium" | null | undefined>;
+  readonly size: import("@angular/core").InputSignal<"small" | "medium" | "sm" | "md" | null | undefined>;
   /** Pilule carrée (icône seule). */
   readonly iconOnly: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
   /** Discriminant de rendu d'icône (piloté par le consommateur). */
@@ -3989,7 +4023,7 @@ export declare const TOGGLE_ICON_CLASS = "toggle-icon";
 export declare const TOGGLE_LABEL_CLASS = "toggle-label";
 export declare const toggleVariants: (props?: ({
   variant?: "multi" | "unique" | null | undefined;
-  size?: "small" | "sm" | "md" | "medium" | null | undefined;
+  size?: "small" | "medium" | "sm" | "md" | null | undefined;
   iconOnly?: boolean | null | undefined;
   showIcon?: boolean | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
@@ -4044,6 +4078,17 @@ export declare class ListComponent {
    * `list-navigation` / `list-menu`.
    */
   readonly size: import("@angular/core").InputSignal<"small" | "medium" | null | undefined>;
+  private readonly host;
+  private readonly keyboardFocusState;
+  /**
+   * Vrai tant que le focus **clavier** est dans la liste (`:focus-visible` : un clic à la souris sur une
+   * ligne ne compte pas). Permet à l'application d'afficher une aide de navigation (« ↑ ↓ pour naviguer »)
+   * exactement quand elle sert, sans aller lire le DOM de la liste.
+   */
+  readonly keyboardFocused: import("@angular/core").Signal<boolean>;
+  protected onFocusIn(event: FocusEvent): void;
+  /** Le focus passe d'une ligne à l'autre par un `focusout` suivi d'un `focusin` : seul un départ de la liste éteint l'état. */
+  protected onFocusOut(event: FocusEvent): void;
   /** Le CVA ne stylise pas le conteneur : classes minimales de layout + `class` consommateur. */
   protected readonly variants: import("@angular/core").Signal<string>;
   static ɵfac: i0.ɵɵFactoryDeclaration<ListComponent, never>;
@@ -4082,28 +4127,6 @@ export declare class ListComponent {
     };
   }]>;
 }
-/**
- * `<ListItem>` — item d'un `<List>`, bâti sur la primitive accessible `@angular/aria/listbox`
- * (`Option` → `role="option"`, `aria-selected`/`aria-disabled` reflétés automatiquement, ce que
- * le CVA `listItemVariants` stylise via ses sélecteurs d'attributs).
- *
- * `variant`/`size` sont hérités du `<List>` parent (via {@link LIST_REF}) sauf s'ils sont fournis
- * explicitement sur l'item. `depth` applique l'indentation d'arbre (`getListDepthStyle`).
- *
- * La sélection appartient au modèle `value` du `<List>` (listbox) — on ne pilote donc pas de
- * `selected` manuel ici.
- *
- * @example
- * ```html
- * <ListItem [value]="u.id">
- *   <ListItemLeft>
- *     <ListItemAvatar>{{ u.initials }}</ListItemAvatar>
- *     <ListItemText [subtext]="u.email">{{ u.name }}</ListItemText>
- *   </ListItemLeft>
- *   <ListItemAction ariaLabel="Supprimer" (click)="remove(u)"><trash-icon /></ListItemAction>
- * </ListItem>
- * ```
- */
 export declare class ListItemComponent {
   /** Classe(s) additionnelle(s), fusionnée(s) via `cn`. */
   readonly class: import("@angular/core").InputSignal<string | undefined>;
@@ -4123,13 +4146,24 @@ export declare class ListItemComponent {
   protected readonly variants: import("@angular/core").Signal<string>;
   /** Indentation d'arbre (réutilise le helper du CVA) ; `null` à la racine (depth 0). */
   protected readonly paddingLeft: import("@angular/core").Signal<string | null>;
-  private readonly host;
-  /** Vrai quand la ligne projette une `<ListItemAction>` — conditionne `aria-keyshortcuts`. */
+  /**
+   * Vrai quand la ligne projette une `<ListItemAction>` **utilisable** — conditionne `aria-keyshortcuts`.
+   * Une action désactivée ignore sa touche : l'annoncer promettrait une action qui ne fait rien.
+   */
   protected readonly hasAction: import("@angular/core").Signal<boolean>;
   private readonly action;
+  /** Les touches de l'action, au format de `aria-keyshortcuts` (« Delete Backspace »). */
+  protected readonly keyShortcuts: import("@angular/core").Signal<string | null>;
   /**
-   * `Suppr` déclenche l'action de fin de ligne. Celle-ci n'est pas un contrôle focusable (une
-   * option de listbox ne peut pas en contenir), donc c'est le seul chemin clavier vers elle.
+   * Relie la ligne au texte masqué de son action. `aria-keyshortcuts` n'est pas lu de façon fiable
+   * (selon le lecteur, le réglage et le navigateur, et alors en anglais brut) : seul un texte relié
+   * garantit que l'utilisateur apprend que `Suppr` supprime la ligne.
+   */
+  protected readonly actionDescriptionId: import("@angular/core").Signal<string | null>;
+  /**
+   * La touche de l'action (`keys` de `<ListItemAction>`, `Delete` par défaut) la déclenche. Celle-ci n'est
+   * pas un contrôle focusable (une option de listbox ne peut pas en contenir), donc c'est le seul chemin
+   * clavier vers elle.
    */
   protected onKeydown(event: KeyboardEvent): void;
   static ɵfac: i0.ɵɵFactoryDeclaration<ListItemComponent, never>;
@@ -4255,6 +4289,20 @@ export declare class ListItemAvatarDirective {
  * L'accès clavier passe donc par `<ListItem>`, qui déclenche l'action sur `Suppr` et l'annonce via
  * `aria-keyshortcuts`. Le `<span>` reste la cible souris, et garde tout son style (le CVA cible la
  * classe, jamais la balise).
+ *
+ * Une ligne n'est pas faite pour contenir un champ de saisie ni aucun contrôle : une `option` de listbox
+ * n'en admet pas, et la ligne prend `Suppr` quelle que soit la cible du clavier. Une ligne éditable relève de
+ * `RowGrid`, pas de `<List>`.
+ *
+ * Une action par ligne : `<ListItem>` ne déclenche que la première, par la touche de `keys` (`Delete`
+ * par défaut). La corbeille n'est qu'une icône posée en contenu : l'action est ce que fait le `(click)`.
+ *
+ * Un utilisateur voyant n'apprend rien d'`aria-keyshortcuts` : tant que la ligne a le focus clavier, une
+ * seconde ligne, dans la ligne, écrit donc la phrase `description` avec la touche en `<kbd>` (« Appuyez
+ * sur Suppr pour supprimer »). Sans `description`, il n'y a pas de seconde ligne : la ligne garde sa hauteur.
+ * Le CVA la garde masquée hors focus clavier : la souris dispose du clic, et l'afficher au survol ferait
+ * bouger les lignes sous le pointeur. Cette ligne est `aria-hidden` : la
+ * même phrase, reliée par `aria-describedby`, porte l'annonce.
  */
 export declare class ListItemActionComponent {
   /**
@@ -4263,9 +4311,48 @@ export declare class ListItemActionComponent {
    * porté par `<ListItem>`. Le nom de l'entrée est conservé pour ne pas casser les appelants.
    */
   readonly ariaLabel: import("@angular/core").InputSignal<string | undefined>;
-  /** Désactive le bouton d'action. */
+  /**
+   * Désactive l'action : `Suppr` ne la déclenche plus, et ni l'aide visible, ni la phrase reliée par
+   * `aria-describedby`, ni `aria-keyshortcuts` n'annoncent plus un raccourci qui ne ferait rien.
+   */
   readonly disabled: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  /**
+   * Les touches (`KeyboardEvent.key`) qui déclenchent l'action quand sa ligne a le focus. `Delete` par
+   * défaut. La première nomme l'action dans `aria-keyshortcuts` et, à défaut de `shortcut`, dans l'aide.
+   *
+   * Ajouter une touche qui n'existe que sur certains claviers est à l'appelant (un Mac n'a pas de
+   * `Delete` dédié : `["Delete", "Backspace"]` quand `isApplePlatform()`), la librairie ne le devine pas.
+   */
+  readonly keys: import("@angular/core").InputSignal<readonly string[]>;
+  /**
+   * Nom de la touche écrit dans la ligne d'aide quand la ligne a le focus clavier (ex. « Suppr »). Il
+   * doit apparaître tel quel dans `description` pour y être mis en forme. La librairie ne dépend pas de
+   * transloco : à l'application de le traduire. Par défaut, le nom de la première de `keys` (`Del` pour
+   * `Delete`).
+   */
+  readonly shortcut: import("@angular/core").InputSignal<string | undefined>;
+  /**
+   * Phrase lue par un lecteur d'écran quand la ligne prend le focus (ex. « Appuyez sur Suppr pour
+   * supprimer »), reliée à la ligne par `aria-describedby`. À traduire par l'application ; sans elle,
+   * seul `aria-keyshortcuts` renseigne les technologies d'assistance.
+   */
+  readonly description: import("@angular/core").InputSignal<string | undefined>;
+  readonly descriptionId: string;
+  protected readonly keyName: import("@angular/core").Signal<string>;
+  private readonly trigger$;
+  /** Déclenche l'action comme le ferait un clic sur son icône (`<ListItem>` l'appelle sur la touche). */
+  trigger(): void;
+  /**
+   * La phrase coupée autour du nom de la touche, qui prend alors la forme d'un `<kbd>`. Une phrase qui ne
+   * contient pas le nom est écrite telle quelle, sans touche.
+   */
+  protected readonly hint: import("@angular/core").Signal<{
+    before: string;
+    after: string;
+    withKey: boolean;
+  }>;
   protected readonly btnClass = "list-item-icon-right";
+  protected readonly hintClass = "list-item-action-hint";
   static ɵfac: i0.ɵɵFactoryDeclaration<ListItemActionComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<ListItemActionComponent, "ListItemAction,list-item-action,listitemaction", ["listItemAction"], {
     "ariaLabel": {
@@ -4278,6 +4365,21 @@ export declare class ListItemActionComponent {
       "required": false;
       "isSignal": true;
     };
+    "keys": {
+      "alias": "keys";
+      "required": false;
+      "isSignal": true;
+    };
+    "shortcut": {
+      "alias": "shortcut";
+      "required": false;
+      "isSignal": true;
+    };
+    "description": {
+      "alias": "description";
+      "required": false;
+      "isSignal": true;
+    };
   }, {}, never, ["*"], true, never>;
 }
 /**
@@ -4326,6 +4428,7 @@ export declare const LIST_ITEM_EXPANDER_CLASS = "list-item-expander";
 export declare const LIST_ITEM_EXPANDER_BUTTON_CLASS = "list-item-expander-btn";
 export declare const LIST_ITEM_AVATAR_CLASS = "list-item-avatar";
 export declare const LIST_ITEM_ICON_RIGHT_CLASS = "list-item-icon-right";
+declare const LIST_ITEM_ACTION_HINT_CLASS = "list-item-action-hint";
 export declare const LIST_ITEM_CHEVRON_RIGHT_CLASS = "list-item-chevron-right";
 export declare function getListDepthStyle(depth?: number): {
   paddingLeft: string;
@@ -4663,6 +4766,11 @@ export declare class RowFeedComponent<T> extends RowListBase<T> {
     };
   }, {}, never, never, true, never>;
 }
+/**
+ * On/off toggle. The projected content is its visible label: it renders to the right of the switch, inside
+ * the switch's own `<label>`, so it names the switch and a click on it toggles the switch (RGAA 11.1 / 11.4).
+ * Same contract as `Checkbox`.
+ */
 export declare class SwitchComponent {
   readonly checked: import("@angular/core").ModelSignal<boolean>;
   readonly disabled: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
@@ -4671,15 +4779,16 @@ export declare class SwitchComponent {
   /**
    * Accessible name of the inner `<input>`, for a switch whose label is not projected.
    *
-   * A switch has no content, so without a name it is unlabelled (RGAA 11.1). Aliased on the
+   * A switch with no projected content has no name, so it is unlabelled (RGAA 11.1). Aliased on the
    * attribute, as `Checkbox.ariaLabel` is, and applied to the `<input>`: the host is in
    * `display: contents` and carries no role, so a name on it would be read by nobody.
    */
   readonly ariaLabel: import("@angular/core").InputSignal<string | undefined>;
   /**
    * Id of the element that names the inner `<input>`, for a switch labelled by visible text elsewhere
-   * in the template. Wrapping the switch in a `<label>` is not an option: it already renders its own
-   * (nested labels are invalid, RGAA 8.2). Takes precedence over `aria-label`.
+   * in the template (a label that must not toggle the switch, e.g. the header of an expandable card).
+   * To label the switch with text that toggles it, project that text instead: it renders to the right of
+   * the switch, inside the switch's own `<label>`. Takes precedence over `aria-label` and over the projected text.
    */
   readonly ariaLabelledby: import("@angular/core").InputSignal<string | undefined>;
   /**
@@ -4691,6 +4800,13 @@ export declare class SwitchComponent {
    * Le clic traverse vers le parent, et `:checked` continue de piloter le rendu.
    */
   readonly presentational: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  /**
+   * Drops the 44×44 touch target: the hitbox shrinks to the track (24 px in `small`, 18 px in `xsmall`).
+   *
+   * For a switch whose parent already is the touch target (a menu or list row, a toolbar). Implied by
+   * `presentational`. Below the 24 px WCAG 2.5.8 minimum in `xsmall`/`xs`, so do not use it on a standalone switch.
+   */
+  readonly compact: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
   /**
    * Index de tabulation de l'`<input>`, pour un hôte qui possède l'ordre de tabulation.
    *
@@ -4741,6 +4857,11 @@ export declare class SwitchComponent {
       "required": false;
       "isSignal": true;
     };
+    "compact": {
+      "alias": "compact";
+      "required": false;
+      "isSignal": true;
+    };
     "tabIndex": {
       "alias": "tabIndex";
       "required": false;
@@ -4748,9 +4869,11 @@ export declare class SwitchComponent {
     };
   }, {
     "checked": "checkedChange";
-  }, never, never, true, never>;
+  }, never, ["*"], true, never>;
 }
 declare const SWITCH_INPUT_CLASS = "switch-input";
+declare const SWITCH_HITBOX_CLASS = "switch-hitbox";
+declare const SWITCH_LABEL_CLASS = "switch-label";
 declare const SWITCH_TRACK_CLASS = "switch-track";
 declare const SWITCH_THUMB_CLASS = "switch-thumb";
 declare const SWITCH_THUMB_ICON_CLASS = "switch-thumb-icon";
@@ -4881,7 +5004,7 @@ export declare class TagComponent {
   class: import("@angular/core").InputSignal<string | undefined>;
   variant: import("@angular/core").InputSignal<"primary" | "secondary" | null | undefined>;
   scheme: import("@angular/core").InputSignal<"error" | "sage" | "success" | "almond" | "pink" | "grey" | "yellow" | "cherry" | "indigo" | "cyan" | "warning" | "info" | null | undefined>;
-  size: import("@angular/core").InputSignal<"small" | "sm" | "md" | "xs" | "xsmall" | "medium" | null | undefined>;
+  size: import("@angular/core").InputSignal<"small" | "medium" | "sm" | "md" | "xs" | "xsmall" | null | undefined>;
   variants: import("@angular/core").Signal<string>;
   static ɵfac: i0.ɵɵFactoryDeclaration<TagComponent, never>;
   static ɵdir: i0.ɵɵDirectiveDeclaration<TagComponent, "tag, Tag", never, {
@@ -4913,7 +5036,7 @@ declare const TAG_FLAG_CLASS = "tag-flag";
 declare const tagVariants: (props?: ({
   variant?: "primary" | "secondary" | null | undefined;
   scheme?: "error" | "sage" | "success" | "almond" | "pink" | "grey" | "yellow" | "cherry" | "indigo" | "cyan" | "warning" | "info" | null | undefined;
-  size?: "small" | "sm" | "md" | "xs" | "xsmall" | "medium" | null | undefined;
+  size?: "small" | "medium" | "sm" | "md" | "xs" | "xsmall" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 type TagVariants = VariantProps<typeof tagVariants>;
 /**
@@ -5317,14 +5440,14 @@ export declare class AvatarFallbackComponent {
   canrender: import("@angular/core").WritableSignal<boolean>;
   class: import("@angular/core").InputSignal<string | undefined>;
   /** Explicite ; à défaut, hérité de l'`<avatar>` parent, sinon `"large"` (aligné sur le cva). */
-  size: import("@angular/core").InputSignal<"small" | "xsmall" | "medium" | "large" | null | undefined>;
+  size: import("@angular/core").InputSignal<"small" | "medium" | "xsmall" | "large" | null | undefined>;
   /** Explicite ; à défaut, hérité de l'`<avatar>` parent, sinon `"primary"`. */
   fill: import("@angular/core").InputSignal<"primary" | "secondary" | null | undefined>;
   /** Explicite ; à défaut, hérité de l'`<avatar>` parent, sinon `"sage"`. */
   scheme: import("@angular/core").InputSignal<"error" | "sage" | "success" | "almond" | "pink" | "grey" | "yellow" | "cherry" | "indigo" | "cyan" | "warning" | "info" | null | undefined>;
   /** Conteneur parent, pour hériter size/fill/scheme par défaut. */
   private readonly avatar;
-  protected readonly resolvedSize: import("@angular/core").Signal<NonNullable<"small" | "xsmall" | "medium" | "large" | null | undefined>>;
+  protected readonly resolvedSize: import("@angular/core").Signal<NonNullable<"small" | "medium" | "xsmall" | "large" | null | undefined>>;
   protected readonly resolvedFill: import("@angular/core").Signal<NonNullable<"primary" | "secondary" | null | undefined>>;
   protected readonly resolvedScheme: import("@angular/core").Signal<NonNullable<"error" | "sage" | "success" | "almond" | "pink" | "grey" | "yellow" | "cherry" | "indigo" | "cyan" | "warning" | "info" | null | undefined>>;
   variants: import("@angular/core").Signal<string>;
@@ -5406,7 +5529,7 @@ export declare class AvatarComponent {
   avatarImage: import("@angular/core").Signal<AvatarImageComponent | undefined>;
   avatarFallback: import("@angular/core").Signal<AvatarFallbackComponent | undefined>;
   class: import("@angular/core").InputSignal<string | undefined>;
-  size: import("@angular/core").InputSignal<"small" | "xsmall" | "medium" | "large" | null | undefined>;
+  size: import("@angular/core").InputSignal<"small" | "medium" | "xsmall" | "large" | null | undefined>;
   fill: import("@angular/core").InputSignal<"primary" | "secondary" | null | undefined>;
   scheme: import("@angular/core").InputSignal<"error" | "sage" | "success" | "almond" | "pink" | "grey" | "yellow" | "cherry" | "indigo" | "cyan" | "warning" | "info" | null | undefined>;
   variants: import("@angular/core").Signal<string>;
@@ -5467,7 +5590,7 @@ declare const avatarVariants: (props?: ({
   content?: "picture" | "initials" | null | undefined;
   style?: "primary" | "secondary" | null | undefined;
   scheme?: "error" | "sage" | "success" | "almond" | "pink" | "grey" | "yellow" | "cherry" | "indigo" | "cyan" | "warning" | "info" | null | undefined;
-  size?: "small" | "xsmall" | "medium" | "large" | null | undefined;
+  size?: "small" | "medium" | "xsmall" | "large" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 type AvatarVariants = VariantProps<typeof avatarVariants>;
 /** Left icon slot — tags its host with the `link-icon-left` class and pins it to the start. */
@@ -5525,7 +5648,7 @@ export declare class LinkIconRightDirective {
  */
 export declare class LinkComponent {
   class: import("@angular/core").InputSignal<string | undefined>;
-  size: import("@angular/core").InputSignal<"small" | "sm" | "md" | "medium" | null | undefined>;
+  size: import("@angular/core").InputSignal<"small" | "medium" | "sm" | "md" | null | undefined>;
   visited: import("@angular/core").InputSignal<boolean | null | undefined>;
   icon: import("@angular/core").InputSignal<boolean | null | undefined>;
   openWindow: import("@angular/core").InputSignal<boolean | null | undefined>;
@@ -5584,13 +5707,13 @@ export declare class LinkComponent {
 }
 export declare const LINK_LABEL_CLASS = "link-label";
 declare const linkVariants: (props?: ({
-  size?: "small" | "sm" | "md" | "medium" | null | undefined;
+  size?: "small" | "medium" | "sm" | "md" | null | undefined;
   visited?: boolean | null | undefined;
   icon?: boolean | null | undefined;
   openWindow?: boolean | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 export declare const linkIconVariants: (props?: ({
-  size?: "small" | "sm" | "md" | "medium" | null | undefined;
+  size?: "small" | "medium" | "sm" | "md" | null | undefined;
   position?: "right" | "left" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 type LinkVariants = VariantProps<typeof linkVariants>;
@@ -5887,25 +6010,14 @@ export declare const textareaWrapVariants: (props?: ({
   filled?: boolean | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 type TextareaWrapVariants = VariantProps<typeof textareaWrapVariants>;
-export declare class SearchInputComponent implements FormValueControl<string> {
+/**
+ * What the plain field and the one with suggestions share: every input, the value, the sizes and the clear button.
+ * Not a component of its own: `SearchInputComponent` and `SearchInputSuggestionsComponent` differ only by the
+ * `ngCombobox` on the inner `<input>`.
+ */
+declare abstract class SearchInputBase implements FormValueControl<string> {
   cn: import("cn").CnFunction;
   searchInput: import("@angular/core").Signal<ElementRef<any>>;
-  /**
-   * The `ngCombobox` directive instance applied to the inner input element.
-   *
-   * @remarks
-   * Use this reference to attach a suggestions popup from the consumer side:
-   *
-   * ```html
-   * <SearchInput #si [(value)]="query" />
-   * <ng-template ngComboboxPopup [combobox]="si.combobox()">
-   *   <ul ngComboboxWidget ngListbox #lb="ngListbox" [activeDescendant]="lb.activeDescendant()">
-   *     <li ngOption [value]="suggestion">…</li>
-   *   </ul>
-   * </ng-template>
-   * ```
-   */
-  combobox: import("@angular/core").Signal<Combobox>;
   /**
    * The search text, kept in sync with the inner input element.
    *
@@ -5957,10 +6069,9 @@ export declare class SearchInputComponent implements FormValueControl<string> {
   iconClass: import("@angular/core").Signal<"" | "size-3">;
   /** Leading magnifier: focus-rotation animation + size-aware sizing. */
   searchIconClass: import("@angular/core").Signal<string>;
-  constructor();
   clearSearch(e: Event): void;
-  static ɵfac: i0.ɵɵFactoryDeclaration<SearchInputComponent, never>;
-  static ɵcmp: i0.ɵɵComponentDeclaration<SearchInputComponent, "SearchInput, search-input, searchinput", never, {
+  static ɵfac: i0.ɵɵFactoryDeclaration<SearchInputBase, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<SearchInputBase, never, never, {
     "value": {
       "alias": "value";
       "required": false;
@@ -6008,7 +6119,41 @@ export declare class SearchInputComponent implements FormValueControl<string> {
     };
   }, {
     "value": "valueChange";
-  }, never, ["*"], true, never>;
+  }, never, never, true, never>;
+}
+/**
+ * A search field: a native `<input type="search">`, with no combobox semantics.
+ *
+ * For a field that shows suggestions, write `<SearchInput suggestions>` and import
+ * `SearchInputSuggestionsComponent` instead: that one is a real ARIA combobox.
+ */
+export declare class SearchInputComponent extends SearchInputBase {
+  static ɵfac: i0.ɵɵFactoryDeclaration<SearchInputComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<SearchInputComponent, "SearchInput:not([suggestions]), search-input:not([suggestions]), searchinput:not([suggestions])", never, {}, {}, never, ["*"], true, never>;
+}
+/**
+ * A search field with a suggestions popup: its inner `<input>` carries `ngCombobox`, so it is announced as a combobox.
+ * Selected by the `suggestions` attribute, which must be static (`<SearchInput suggestions>`).
+ */
+export declare class SearchInputSuggestionsComponent extends SearchInputBase {
+  /**
+   * The `ngCombobox` directive instance applied to the inner input element.
+   *
+   * @remarks
+   * Use this reference to attach a suggestions popup from the consumer side:
+   *
+   * ```html
+   * <SearchInput suggestions #si [(value)]="query" />
+   * <ng-template ngComboboxPopup [combobox]="si.combobox()">
+   *   <ul ngComboboxWidget ngListbox #lb="ngListbox" [activeDescendant]="lb.activeDescendant()">
+   *     <li ngOption [value]="suggestion">…</li>
+   *   </ul>
+   * </ng-template>
+   * ```
+   */
+  combobox: import("@angular/core").Signal<Combobox>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<SearchInputSuggestionsComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<SearchInputSuggestionsComponent, "SearchInput[suggestions], search-input[suggestions], searchinput[suggestions]", never, {}, {}, never, ["*"], true, never>;
 }
 /**
  * Makes the active option of an `ngListbox` follow the mouse pointer.
@@ -6036,47 +6181,17 @@ export declare class ListboxActivateOnHover {
   static ɵdir: i0.ɵɵDirectiveDeclaration<ListboxActivateOnHover, "[ngListbox][activateOnHover]", never, {}, {}, never, never, true, never>;
 }
 /**
- * Workaround for https://github.com/angular/components/issues/33361.
- *
- * `@angular/aria`'s `keyboardEventRelayEffect` reads `controlTarget()` outside of `untracked()`, so it re-runs when the
- * popup widget registers again on a later expansion and re-dispatches the LAST relayed keyboard event onto the fresh
- * listbox: reopening the popup with ArrowDown lands on the 2nd option instead of the 1st. Clearing the relayed event
- * whenever the popup collapses prevents the replay.
- *
- * Call it from the constructor (an injection context) of every component that owns an `ngCombobox`. It is the one place
- * to delete once the issue is fixed upstream.
- *
- * ```ts
- * private readonly combobox = viewChild.required(Combobox);
- * constructor() {
- *   fixStaleComboboxRelay(() => this.combobox());
- * }
- * ```
+ * What the plain bar and the one with suggestions share: every input, the value, the sizes and the buttons.
+ * Not a component of its own: `SearchBarComponent` and `SearchBarSuggestionsComponent` differ only by the
+ * `ngCombobox` on the inner `<input>`.
  */
-export declare function fixStaleComboboxRelay(combobox: () => Combobox): void;
-export declare class SearchBarComponent implements FormValueControl<string> {
+declare abstract class SearchBarBase implements FormValueControl<string> {
   cn: import("cn").CnFunction;
   searchBarVariants: (props?: ({
     size?: "small" | "medium" | "large" | null | undefined;
   } & import("class-variance-authority/types").ClassProp) | undefined) => string;
   protected readonly searchNativeReset: string;
   searchInput: import("@angular/core").Signal<ElementRef<any>>;
-  /**
-   * The `ngCombobox` directive instance applied to the inner input element.
-   *
-   * @remarks
-   * Use this reference to attach a suggestions popup from the consumer side:
-   *
-   * ```html
-   * <SearchBar #sb [(value)]="query" />
-   * <ng-template ngComboboxPopup [combobox]="sb.combobox()">
-   *   <ul ngComboboxWidget ngListbox #lb="ngListbox" [activeDescendant]="lb.activeDescendant()">
-   *     <li ngOption [value]="suggestion">…</li>
-   *   </ul>
-   * </ng-template>
-   * ```
-   */
-  combobox: import("@angular/core").Signal<Combobox>;
   /**
    * The search text, kept in sync with the inner input element.
    *
@@ -6090,11 +6205,12 @@ export declare class SearchBarComponent implements FormValueControl<string> {
   search: import("@angular/core").OutputEmitterRef<string>;
   placeholder: import("@angular/core").InputSignal<string>;
   /**
-   * Nom accessible du champ, posé sur l'`<input>` interne.
+   * Accessible name of the inner `<input>`.
    *
-   * À utiliser plutôt qu'un `aria-label` sur `<SearchBar>` : l'hôte est un élément personnalisé
-   * sans rôle, où ARIA interdit `aria-label` — l'attribut y est ignoré et le champ retombe sur son
-   * `placeholder` pour tout nom accessible.
+   * A placeholder is not a label: it disappears on the first keystroke and screen readers are not
+   * required to announce it (RGAA 11.1). Aliased on the attribute, as `SearchInput.ariaLabel` and
+   * `Badge.ariaLabel` are, so a caller writes `aria-label="…"` on the element and the name lands where
+   * it is read: the `<input>`, this host being an unknown element with no role of its own.
    */
   ariaLabel: import("@angular/core").InputSignal<string | undefined>;
   /** Accessible name of the clear button. Nothing in the library translates: pass it translated. */
@@ -6132,11 +6248,10 @@ export declare class SearchBarComponent implements FormValueControl<string> {
   iconClass: import("@angular/core").Signal<string>;
   /** Leading magnifier class: focus-rotation animation + size-aware sizing. */
   searchIconClass: import("@angular/core").Signal<string>;
-  constructor();
   clearSearch(e: Event): void;
   emitSearch(e: Event): void;
-  static ɵfac: i0.ɵɵFactoryDeclaration<SearchBarComponent, never>;
-  static ɵcmp: i0.ɵɵComponentDeclaration<SearchBarComponent, "SearchBar, search-bar, searchbar", never, {
+  static ɵfac: i0.ɵɵFactoryDeclaration<SearchBarBase, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<SearchBarBase, never, never, {
     "value": {
       "alias": "value";
       "required": false;
@@ -6148,7 +6263,7 @@ export declare class SearchBarComponent implements FormValueControl<string> {
       "isSignal": true;
     };
     "ariaLabel": {
-      "alias": "ariaLabel";
+      "alias": "aria-label";
       "required": false;
       "isSignal": true;
     };
@@ -6185,7 +6300,41 @@ export declare class SearchBarComponent implements FormValueControl<string> {
   }, {
     "value": "valueChange";
     "search": "search";
-  }, never, ["*", "[slot='trailing']"], true, never>;
+  }, never, never, true, never>;
+}
+/**
+ * A search bar: a native `<input type="search">`, with no combobox semantics.
+ *
+ * For a bar that shows suggestions, write `<SearchBar suggestions>` and import `SearchBarSuggestionsComponent`
+ * instead: that one is a real ARIA combobox.
+ */
+export declare class SearchBarComponent extends SearchBarBase {
+  static ɵfac: i0.ɵɵFactoryDeclaration<SearchBarComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<SearchBarComponent, "SearchBar:not([suggestions]), search-bar:not([suggestions]), searchbar:not([suggestions])", never, {}, {}, never, ["*", "[slot='trailing']"], true, never>;
+}
+/**
+ * A search bar with a suggestions popup: its inner `<input>` carries `ngCombobox`, so it is announced as a combobox.
+ * Selected by the `suggestions` attribute, which must be static (`<SearchBar suggestions>`).
+ */
+export declare class SearchBarSuggestionsComponent extends SearchBarBase {
+  /**
+   * The `ngCombobox` directive instance applied to the inner input element.
+   *
+   * @remarks
+   * Use this reference to attach a suggestions popup from the consumer side:
+   *
+   * ```html
+   * <SearchBar suggestions #sb [(value)]="query" />
+   * <ng-template ngComboboxPopup [combobox]="sb.combobox()">
+   *   <ul ngComboboxWidget ngListbox #lb="ngListbox" [activeDescendant]="lb.activeDescendant()">
+   *     <li ngOption [value]="suggestion">…</li>
+   *   </ul>
+   * </ng-template>
+   * ```
+   */
+  combobox: import("@angular/core").Signal<Combobox>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<SearchBarSuggestionsComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<SearchBarSuggestionsComponent, "SearchBar[suggestions], search-bar[suggestions], searchbar[suggestions]", never, {}, {}, never, ["*", "[slot='trailing']"], true, never>;
 }
 export declare const SB_ICON_CLASS = "sb-icon";
 export declare const SB_INPUT_CLASS = "sb-input";