@sinequa/galactik 2.1.0 → 2.2.0

package/package.json

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

package/types/sinequa-galactik.d.ts

@@ -2264,6 +2264,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 +2316,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 +2365,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 +2408,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;
 }
@@ -4663,6 +4689,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 +4702,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 +4723,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 +4780,11 @@ export declare class SwitchComponent {
       "required": false;
       "isSignal": true;
     };
+    "compact": {
+      "alias": "compact";
+      "required": false;
+      "isSignal": true;
+    };
     "tabIndex": {
       "alias": "tabIndex";
       "required": false;
@@ -4748,9 +4792,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";
@@ -5887,25 +5933,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 +5992,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 +6042,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 +6104,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 +6128,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 +6171,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 +6186,7 @@ export declare class SearchBarComponent implements FormValueControl<string> {
       "isSignal": true;
     };
     "ariaLabel": {
-      "alias": "ariaLabel";
+      "alias": "aria-label";
       "required": false;
       "isSignal": true;
     };
@@ -6185,7 +6223,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";
@@ -6239,6 +6311,11 @@ export declare class DialogComponent {
    */
   isPopover: import("@angular/core").WritableSignal<boolean>;
   isModal: import("@angular/core").WritableSignal<boolean>;
+  private readonly injector;
+  /** Element focused before the `[dialog]` path opened, given its focus back on close. */
+  private opener;
+  private releaseInert;
+  constructor();
   /**
    * Opens the dialog by displaying the modal.
    *
@@ -6258,6 +6335,13 @@ export declare class DialogComponent {
    * This method assumes that `dialog` is a reference to a native dialog element and `isOpen` is a state management property.
    */
   showModal(): void;
+  /**
+   * `[dialog]` path only — a native `<dialog>` gets all of this from `showModal()`. Makes the page
+   * behind inert (no Tab out of the modal, hidden from assistive technology), then moves the focus in.
+   * Inert first: the opener loses the focus it held, so nothing is left focused behind the scrim.
+   */
+  private holdBackground;
+  private releaseBackground;
   /**
    * Shows the dialog as a popover element.
    *