@sinequa/galactik 2.2.0 → 2.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sinequa/galactik",
-  "version": "2.2.0",
+  "version": "2.4.0",
   "publishConfig": {
     "access": "public"
   },

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>;
@@ -1352,6 +1360,23 @@ export declare class LoadingCircleIcon {
  */
 export declare const LoadingCircleIconComponent: typeof LoadingCircleIcon;
 export type LoadingCircleIconComponent = LoadingCircleIcon;
+export declare class LockIcon {
+  class: import("@angular/core").InputSignal<string | undefined>;
+  classes: import("@angular/core").Signal<string>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<LockIcon, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<LockIcon, "lock, lock-icon, Lock, LockIcon", never, {
+    "class": {
+      "alias": "class";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, never, true, never>;
+}
+/**
+ * @deprecated Use LockIcon instead.
+ */
+export declare const LockIconComponent: typeof LockIcon;
+export type LockIconComponent = LockIcon;
 export declare class MagnifyingGlassIcon {
   class: import("@angular/core").InputSignal<string | undefined>;
   classes: import("@angular/core").Signal<string>;
@@ -2708,7 +2733,24 @@ export declare class MenuComponent {
   classes: import("@angular/core").Signal<string>;
   ngMenu: Menu<any>;
   readonly popover: PopoverDirective;
+  private readonly host;
+  /** Whether a submenu was open when the last Escape keydown started its way down to its target. */
+  private submenuOpenAtEscape;
   constructor();
+  /**
+   * Escape closes the menu and gives the focus back to its trigger.
+   *
+   * Left to the browser, it does nothing: a `popover="auto"` is dismissed by Escape through the browser's
+   * close request, but `@angular/aria` handles the same keydown and calls `preventDefault()` on it, which
+   * cancels that request — while its own Escape only closes a *sub*menu (a standalone `ngMenu` has no
+   * trigger of its own to close). Hence it is done here.
+   *
+   * While a submenu is open, Escape stays with `@angular/aria`: it closes that submenu alone and puts the
+   * focus back on the parent item (APG: one level per press); the next Escape then reaches this method.
+   * Whether a submenu was open is read in the capture phase (see the constructor): by the time this bubbling
+   * listener runs, `@angular/aria` has already closed it.
+   */
+  onEscape(): void;
   onClick(event: MouseEvent): void;
   static ɵfac: i0.ɵɵFactoryDeclaration<MenuComponent, never>;
   static ɵdir: i0.ɵɵDirectiveDeclaration<MenuComponent, "Menu,menu", ["menu"], {
@@ -3737,7 +3779,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" | "large" | "xs" | "sm" | "md" | "lg" | "xsmall" | null | undefined>;
   variants: import("@angular/core").Signal<string | undefined>;
   static ɵfac: i0.ɵɵFactoryDeclaration<ButtonComponent, never>;
   static ɵdir: i0.ɵɵDirectiveDeclaration<ButtonComponent, "button", never, {
@@ -3781,7 +3823,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" | "large" | "xs" | "sm" | "md" | "lg" | "xsmall" | null | undefined;
   iconOnly?: boolean | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 type ButtonVariants = VariantProps<typeof buttonVariants>;
@@ -3805,7 +3847,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). */
@@ -3878,7 +3920,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). */
@@ -4015,7 +4057,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;
@@ -4070,6 +4112,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>;
@@ -4108,28 +4161,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>;
@@ -4149,13 +4180,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>;
+  /**
+   * 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>;
   /**
-   * `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.
+   * 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>;
@@ -4281,6 +4323,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 {
   /**
@@ -4289,9 +4345,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": {
@@ -4304,6 +4399,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>;
 }
 /**
@@ -4352,6 +4462,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;
@@ -4927,7 +5038,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" | "xs" | "sm" | "md" | "xsmall" | null | undefined>;
   variants: import("@angular/core").Signal<string>;
   static ɵfac: i0.ɵɵFactoryDeclaration<TagComponent, never>;
   static ɵdir: i0.ɵɵDirectiveDeclaration<TagComponent, "tag, Tag", never, {
@@ -4959,7 +5070,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" | "xs" | "sm" | "md" | "xsmall" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 type TagVariants = VariantProps<typeof tagVariants>;
 /**
@@ -5170,7 +5281,7 @@ export declare class BadgeComponent {
   variant: import("@angular/core").InputSignal<"number" | "icon" | 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>;
-  size: import("@angular/core").InputSignal<"sm" | "md" | "xs" | null | undefined>;
+  size: import("@angular/core").InputSignal<"xs" | "sm" | "md" | null | undefined>;
   ariaLabel: import("@angular/core").InputSignal<string | undefined>;
   variants: import("@angular/core").Signal<string>;
   static ɵfac: i0.ɵɵFactoryDeclaration<BadgeComponent, never>;
@@ -5214,7 +5325,7 @@ declare const badgeVariants: (props?: ({
   variant?: "number" | "icon" | null | undefined;
   style?: "primary" | "secondary" | null | undefined;
   scheme?: "error" | "sage" | "success" | "almond" | "pink" | "grey" | "yellow" | "cherry" | "indigo" | "cyan" | "warning" | "info" | null | undefined;
-  size?: "sm" | "md" | "xs" | null | undefined;
+  size?: "xs" | "sm" | "md" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 type BadgeVariants = VariantProps<typeof badgeVariants>;
 /**
@@ -5236,7 +5347,7 @@ export declare class BulletComponent {
   readonly class: import("@angular/core").InputSignal<string | undefined>;
   readonly scheme: import("@angular/core").InputSignal<"error" | "sage" | "success" | "almond" | "pink" | "grey" | "yellow" | "cherry" | "indigo" | "cyan" | "warning" | "info" | null | undefined>;
   readonly fill: import("@angular/core").InputSignal<"primary" | "secondary" | null | undefined>;
-  readonly size: import("@angular/core").InputSignal<"sm" | "md" | "xs" | null | undefined>;
+  readonly size: import("@angular/core").InputSignal<"xs" | "sm" | "md" | null | undefined>;
   /**
    * Wraps the dot in an expanding, fading halo — the "live" status light. Off by default; it
    * animates nothing under `prefers-reduced-motion`.
@@ -5281,7 +5392,7 @@ export declare class BulletComponent {
 declare const bulletVariants: (props?: ({
   scheme?: "error" | "sage" | "success" | "almond" | "pink" | "grey" | "yellow" | "cherry" | "indigo" | "cyan" | "warning" | "info" | null | undefined;
   fill?: "primary" | "secondary" | null | undefined;
-  size?: "sm" | "md" | "xs" | null | undefined;
+  size?: "xs" | "sm" | "md" | null | undefined;
   pulse?: boolean | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 type BulletVariants = VariantProps<typeof bulletVariants>;
@@ -5295,7 +5406,7 @@ type BulletVariants = VariantProps<typeof bulletVariants>;
  */
 export declare class KbdComponent {
   class: import("@angular/core").InputSignal<string | undefined>;
-  size: import("@angular/core").InputSignal<"sm" | "md" | "xs" | null | undefined>;
+  size: import("@angular/core").InputSignal<"xs" | "sm" | "md" | null | undefined>;
   variants: import("@angular/core").Signal<string>;
   static ɵfac: i0.ɵɵFactoryDeclaration<KbdComponent, never>;
   static ɵdir: i0.ɵɵDirectiveDeclaration<KbdComponent, "kbd, Kbd", never, {
@@ -5349,7 +5460,7 @@ export declare class KbdGroupComponent {
  * n'aurait pas de sens et gêne le copier d'un texte l'entourant.
  */
 declare const kbdVariants: (props?: ({
-  size?: "sm" | "md" | "xs" | null | undefined;
+  size?: "xs" | "sm" | "md" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 type KbdVariants = VariantProps<typeof kbdVariants>;
 /**
@@ -5363,14 +5474,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" | "large" | "xsmall" | 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" | "large" | "xsmall" | 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>;
@@ -5452,7 +5563,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" | "large" | "xsmall" | 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>;
@@ -5513,7 +5624,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" | "large" | "xsmall" | 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. */
@@ -5571,7 +5682,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>;
@@ -5630,13 +5741,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>;
@@ -5987,7 +6098,7 @@ declare abstract class SearchInputBase implements FormValueControl<string> {
    * The clear button is a square box: it drops to `xs` (16px) with small text, and always at `size="sm"`
    * so it fits inside the 24px field whatever the text size.
    */
-  buttonSize: import("@angular/core").Signal<"sm" | "xs">;
+  buttonSize: import("@angular/core").Signal<"xs" | "sm">;
   /** Icon size follows the text: below the default 16px with small text, like `SearchBar`'s `small`. */
   iconClass: import("@angular/core").Signal<"" | "size-3">;
   /** Leading magnifier: focus-rotation animation + size-aware sizing. */
@@ -6124,7 +6235,14 @@ declare abstract class SearchBarBase implements FormValueControl<string> {
    * (`<SearchBar [formField]="form.query" />`).
    */
   value: import("@angular/core").ModelSignal<string>;
-  /** Emitted with the current query when the built-in send button is activated (click or Enter). */
+  /**
+   * Emitted with the current query, always a `string`: when the built-in send button is activated (click or Enter on
+   * it) and, on the plain bar, when Enter is pressed in the field. The bar with `suggestions` is a combobox, so
+   * Enter in its field commits the active option instead and does not emit.
+   *
+   * The native DOM `search` event of the inner `<input type="search">` (fired by Chromium on Enter) is stopped
+   * inside the component: `(search)` on the host never receives an `Event`.
+   */
   search: import("@angular/core").OutputEmitterRef<string>;
   placeholder: import("@angular/core").InputSignal<string>;
   /**
@@ -6159,7 +6277,7 @@ declare abstract class SearchBarBase implements FormValueControl<string> {
    * Icon-only action buttons (clear / send) shrink to `xs` at the `small`
    * size so their square box fits inside the `h-6` pill instead of overflowing.
    */
-  buttonSize: import("@angular/core").Signal<"sm" | "xs">;
+  buttonSize: import("@angular/core").Signal<"xs" | "sm">;
   /**
    * Trailing/leading icons drop below the default 16px at the `small` size
    * so they leave breathing room inside the smaller buttons/pill.
@@ -6173,6 +6291,12 @@ declare abstract class SearchBarBase implements FormValueControl<string> {
   searchIconClass: import("@angular/core").Signal<string>;
   clearSearch(e: Event): void;
   emitSearch(e: Event): void;
+  /**
+   * Enter in the field of the plain bar: emits the current text, and leaves the keydown to bubble up to the host
+   * (unlike `emitSearch`, which is for the buttons). Ignored while an IME composition is running — that Enter
+   * validates the candidate, not the search — and while disabled.
+   */
+  emitSearchOnEnter(e: Event): void;
   static ɵfac: i0.ɵɵFactoryDeclaration<SearchBarBase, never>;
   static ɵdir: i0.ɵɵDirectiveDeclaration<SearchBarBase, never, never, {
     "value": {