@sinequa/galactik 2.2.0 → 2.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sinequa/galactik",
-  "version": "2.2.0",
+  "version": "2.3.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>;
@@ -3737,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, {
@@ -3781,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>;
@@ -3805,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). */
@@ -3878,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). */
@@ -4015,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;
@@ -4070,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>;
@@ -4108,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>;
@@ -4149,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>;
@@ -4281,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 {
   /**
@@ -4289,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": {
@@ -4304,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>;
 }
 /**
@@ -4352,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;
@@ -4927,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, {
@@ -4959,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>;
 /**
@@ -5363,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>;
@@ -5452,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>;
@@ -5513,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. */
@@ -5571,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>;
@@ -5630,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>;