@sinequa/atomic-angular 2.0.0 → 2.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sinequa/atomic-angular",
-  "version": "2.0.0",
+  "version": "2.2.0",
   "publishConfig": {
     "access": "public"
   },
@@ -35,7 +35,7 @@
     "@angular/core": "^22.0.0",
     "@angular/aria": "^22.2.0",
     "@sinequa/galactik": "^2.0.0",
-    "@sinequa/atomic": ">=2.7.0",
+    "@sinequa/atomic": ">=2.9.0",
     "vanilla-calendar-pro": "^3.4.0",
     "chart.js": "^4.4.0",
     "chartjs-chart-matrix": "^3.0.0",
@@ -147,6 +147,10 @@
     {
       "scope": "document-workspaces",
       "path": "document-workspaces/i18n"
+    },
+    {
+      "scope": "session-expiry",
+      "path": "providers/session-expiry/i18n"
     }
   ],
   "sideEffects": false,

package/providers/session-expiry/i18n/de.json

@@ -0,0 +1,7 @@
+{
+  "expiringTitle": "Ihre Sitzung läuft bald ab",
+  "expiringDescription": "Sie läuft in etwa {{minutes}} Min. ab. Speichern Sie Ihre Arbeit oder melden Sie sich erneut an.",
+  "expiredTitle": "Ihre Sitzung ist abgelaufen",
+  "expiredDescription": "Melden Sie sich erneut an, um fortzufahren.",
+  "reload": "Erneut anmelden"
+}

package/providers/session-expiry/i18n/en.json

@@ -0,0 +1,7 @@
+{
+  "expiringTitle": "Your session is about to expire",
+  "expiringDescription": "It expires in about {{minutes}} min. Save your work or sign in again.",
+  "expiredTitle": "Your session has expired",
+  "expiredDescription": "Sign in again to continue.",
+  "reload": "Sign in again"
+}

package/providers/session-expiry/i18n/fr.json

@@ -0,0 +1,7 @@
+{
+  "expiringTitle": "Votre session va bientôt expirer",
+  "expiringDescription": "Elle expire dans environ {{minutes}} min. Enregistrez votre travail ou reconnectez-vous.",
+  "expiredTitle": "Votre session a expiré",
+  "expiredDescription": "Reconnectez-vous pour continuer.",
+  "reload": "Se reconnecter"
+}

package/types/sinequa-atomic-angular-document-workspaces.d.ts

@@ -1,6 +1,6 @@
-import { SecurityPrincipal, UpdateContainerInput, UploadJobStatus } from "@sinequa/atomic";
+import { SecurityPrincipal, UpdateWorkspaceInput, UploadJobStatus } from "@sinequa/atomic";
 import * as i0 from "@angular/core";
-import { InjectionToken, PipeTransform, Signal } from "@angular/core";
+import { AfterContentInit, InjectionToken, PipeTransform, Signal } from "@angular/core";
 import { DetailedError } from "tus-js-client";
 import { DialogResult } from "@sinequa/galactik";
 import { SafeResourceUrl } from "@angular/platform-browser";
@@ -219,7 +219,7 @@ export declare const WorkspacesStore: import("@angular/core").Type<{
   loadMore: () => Promise<Workspace[]>;
   fetch: (id: string) => Promise<Workspace>;
   create: ({ name, description, tags, owners, readers }: CreateWorkspaceInput) => Promise<Workspace>;
-  update: (id: string, patch: UpdateContainerInput) => Promise<Workspace | null>;
+  update: (id: string, patch: UpdateWorkspaceInput) => Promise<Workspace | null>;
   remove: (ids: string[]) => Promise<RemoveWorkspacesResult>;
   forget: (id: string) => void;
   loadDocuments: (workspaceId: string, signal?: AbortSignal) => Promise<WorkspaceDocument[]>;
@@ -963,6 +963,12 @@ interface WorkspaceTabCounts {
   editor: number;
   reader: number;
 }
+/** What the search box looks at: the name only, or the name and the description. */
+type WorkspaceSearchFields = "name" | "name+description";
+interface WorkspaceFilterOptions {
+  /** What the query is matched against. Read reactively; the name only when absent. */
+  fields?: () => WorkspaceSearchFields;
+}
 /**
  * The workspace list's tab and search box, and the list they produce.
  *
@@ -971,7 +977,7 @@ interface WorkspaceTabCounts {
  *
  * Must be called from an injection context (a component field initializer).
  */
-export declare function injectWorkspaceFilter(workspaces: Signal<readonly Workspace[]>): {
+export declare function injectWorkspaceFilter(workspaces: Signal<readonly Workspace[]>, options?: WorkspaceFilterOptions): {
   tab: import("@angular/core").WritableSignal<WorkspaceTab>;
   query: import("@angular/core").WritableSignal<string>;
   counts: Signal<WorkspaceTabCounts>;
@@ -1515,7 +1521,7 @@ export declare class WorkspaceList {
     loadMore: () => Promise<Workspace[]>;
     fetch: (id: string) => Promise<Workspace>;
     create: ({ name, description, tags, owners, readers }: import("@sinequa/atomic-angular/document-workspaces").CreateWorkspaceInput) => Promise<Workspace>;
-    update: (id: string, patch: import("@sinequa/atomic").UpdateContainerInput) => Promise<Workspace | null>;
+    update: (id: string, patch: import("@sinequa/atomic").UpdateWorkspaceInput) => Promise<Workspace | null>;
     remove: (ids: string[]) => Promise<import("@sinequa/atomic-angular/document-workspaces").RemoveWorkspacesResult>;
     forget: (id: string) => void;
     loadDocuments: (workspaceId: string, signal?: AbortSignal) => Promise<import("@sinequa/atomic-angular/document-workspaces").WorkspaceDocument[]>;
@@ -1545,7 +1551,7 @@ export declare class WorkspaceList {
     labelKey: string;
   }[];
   protected readonly viewMode: import("@angular/core").WritableSignal<ViewMode$1>;
-  protected readonly status: import("@angular/core").WritableSignal<"error" | "loading" | "ready">;
+  protected readonly status: import("@angular/core").WritableSignal<"loading" | "ready" | "error">;
   protected readonly loadError: import("@angular/core").WritableSignal<Message | null>;
   protected readonly refreshError: import("@angular/core").WritableSignal<string | null>;
   protected readonly loadingMore: import("@angular/core").WritableSignal<boolean>;
@@ -2187,7 +2193,7 @@ export declare class WorkspaceDetail {
   protected readonly query: import("@angular/core").WritableSignal<string>;
   /** The search box, bound to `query`. */
   protected readonly searchForm: import("@angular/forms/signals").FieldTree<string, string | number, "writable">;
-  protected readonly status: import("@angular/core").WritableSignal<"error" | "loading" | "ready">;
+  protected readonly status: import("@angular/core").WritableSignal<"loading" | "ready" | "error">;
   protected readonly loadError: import("@angular/core").WritableSignal<Message | null>;
   protected readonly refreshError: import("@angular/core").WritableSignal<string | null>;
   protected readonly refreshing: import("@angular/core").WritableSignal<boolean>;
@@ -2267,37 +2273,505 @@ interface MentionSelection {
   ids: string[];
   count: number;
 }
+/** One displayed workspace, with whether it is ticked. */
+interface MentionItem {
+  id: string;
+  name: string;
+  description: string;
+  color: WorkspaceColor;
+  documentCount: number;
+  /** The current user's role on it: a host can mark the read-only rows (`reader`) without hiding them. */
+  currentUserRole: WorkspaceRole;
+  selected: boolean;
+}
+/** The categories, in order: the translation key of each one's label. */
+export declare const MENTION_TABS: readonly {
+  id: WorkspaceTab;
+  labelKey: string;
+}[];
+interface WorkspaceMentionOptions {
+  /** What the search matches. Read reactively; the name only when absent. */
+  searchFields?: () => WorkspaceSearchFields;
+  /**
+   * The ticked ids, when the host owns the selection (controlled mode): the ticks are then
+   * the host's and the store's are left alone. `undefined` — the default — keeps them in the store.
+   */
+  selectedIds?: () => readonly string[] | undefined;
+  /** An extra condition a workspace must meet to be offered, on top of the tab and the search. */
+  predicate?: () => ((workspace: Workspace) => boolean) | undefined;
+  /** The ticks changed because of this menu. */
+  onSelectionChange?: (selection: MentionSelection) => void;
+  /** A workspace was created from here, and ticked. */
+  onCreated?: (workspace: Workspace) => void;
+}
+/**
+ * The state behind a "mention a workspace" menu — search, category, ticks, "select all"
+ * and "new workspace" — with no markup, so any layout can be drawn over it.
+ *
+ * The ticks are the store's unless the host passes `selectedIds`: however many menus
+ * are on screen they then show the same thing. "Select all" works on what is displayed,
+ * so on the current category and search. Every workspace is offered, the ones shared
+ * read-only too — mentioning one only reads it.
+ *
+ * Must be called from an injection context (a component field initializer).
+ */
+export declare function injectWorkspaceMention(options?: WorkspaceMentionOptions): {
+  /** The search text; writable, so a text box can bind to it. */
+  query: import("@angular/core").WritableSignal<string>;
+  clearQuery: () => void;
+  /** The category: all, the ones you own (`editor`), the ones shared with you (`reader`). */
+  tab: import("@angular/core").WritableSignal<WorkspaceTab>;
+  tabs: readonly {
+    id: WorkspaceTab;
+    labelKey: string;
+  }[];
+  /** The workspaces in each category — the whole list, not what the search left. */
+  counts: import("@angular/core").Signal<import("@sinequa/atomic-angular/document-workspaces").WorkspaceTabCounts>;
+  /** Whether the first page is loading, ready or failed. */
+  status: import("@angular/core").Signal<"loading" | "ready" | "error">;
+  /** More workspaces than the loaded ones exist on the server: `loadMore()` fetches the next page. */
+  hasMore: import("@angular/core").Signal<boolean>;
+  /** The loading cap is reached: some workspaces will never be offered, search included. */
+  truncated: import("@angular/core").Signal<boolean>;
+  /** A page is being fetched by `loadMore()`. */
+  loadingMore: import("@angular/core").Signal<boolean>;
+  /** Loads the next page; the search and the categories then run over it too. */
+  loadMore(): Promise<void>;
+  /** What is offered: the category, the search and the predicate applied. */
+  items: import("@angular/core").Signal<MentionItem[]>;
+  /** How many are ticked, displayed or not. */
+  count: import("@angular/core").Signal<number>;
+  /** The ticked ids, displayed or not. */
+  ids: import("@angular/core").Signal<readonly string[]>;
+  allSelected: import("@angular/core").Signal<boolean>;
+  partiallySelected: import("@angular/core").Signal<boolean>;
+  isSelected: (id: string) => boolean;
+  toggle: (id: string, checked: boolean) => void;
+  /** Ticks every displayed workspace, or unticks them all when they already are. */
+  toggleAll: () => void;
+  /** Ticks a workspace from outside — a host that has its own way of choosing one. */
+  select: (id: string) => void;
+  /**
+   * Opens the "new workspace" dialog; the workspace it makes is ticked and shown (the category
+   * and the search are reset so it is not hidden). Resolves with it, or `null` when dismissed.
+   *
+   * The dialog is deliberately not tied to the caller's `DestroyRef`: a menu that closes on
+   * focus-out (a hover-mounted panel) would end it mid-save.
+   */
+  create(): Promise<Workspace | null>;
+};
+type WorkspaceMentionApi = ReturnType<typeof injectWorkspaceMention>;
+/** Provided by `<workspace-mention>` to the pieces placed inside it. */
+export declare const WORKSPACE_MENTION: InjectionToken<{
+  /** The search text; writable, so a text box can bind to it. */
+  query: import("@angular/core").WritableSignal<string>;
+  clearQuery: () => void;
+  /** The category: all, the ones you own (`editor`), the ones shared with you (`reader`). */
+  tab: import("@angular/core").WritableSignal<WorkspaceTab>;
+  tabs: readonly {
+    id: WorkspaceTab;
+    labelKey: string;
+  }[];
+  /** The workspaces in each category — the whole list, not what the search left. */
+  counts: import("@angular/core").Signal<import("@sinequa/atomic-angular/document-workspaces").WorkspaceTabCounts>;
+  /** Whether the first page is loading, ready or failed. */
+  status: import("@angular/core").Signal<"loading" | "ready" | "error">;
+  /** More workspaces than the loaded ones exist on the server: `loadMore()` fetches the next page. */
+  hasMore: import("@angular/core").Signal<boolean>;
+  /** The loading cap is reached: some workspaces will never be offered, search included. */
+  truncated: import("@angular/core").Signal<boolean>;
+  /** A page is being fetched by `loadMore()`. */
+  loadingMore: import("@angular/core").Signal<boolean>;
+  /** Loads the next page; the search and the categories then run over it too. */
+  loadMore(): Promise<void>;
+  /** What is offered: the category, the search and the predicate applied. */
+  items: import("@angular/core").Signal<MentionItem[]>;
+  /** How many are ticked, displayed or not. */
+  count: import("@angular/core").Signal<number>;
+  /** The ticked ids, displayed or not. */
+  ids: import("@angular/core").Signal<readonly string[]>;
+  allSelected: import("@angular/core").Signal<boolean>;
+  partiallySelected: import("@angular/core").Signal<boolean>;
+  isSelected: (id: string) => boolean;
+  toggle: (id: string, checked: boolean) => void;
+  /** Ticks every displayed workspace, or unticks them all when they already are. */
+  toggleAll: () => void;
+  /** Ticks a workspace from outside — a host that has its own way of choosing one. */
+  select: (id: string) => void;
+  /**
+   * Opens the "new workspace" dialog; the workspace it makes is ticked and shown (the category
+   * and the search are reset so it is not hidden). Resolves with it, or `null` when dismissed.
+   *
+   * The dialog is deliberately not tied to the caller's `DestroyRef`: a menu that closes on
+   * focus-out (a hover-mounted panel) would end it mid-save.
+   */
+  create(): Promise<Workspace | null>;
+}>;
+/** The enclosing `<workspace-mention>`, for a piece that cannot work outside one. */
+export declare function injectWorkspaceMentionScope(): WorkspaceMentionApi;
 /**
- * The workspaces as rows to tick, for the "+" / "@" menu of a host chat.
+ * The workspaces as rows to tick, for the "+" / "@" menu of a host chat — the ready-made
+ * `<workspace-mention>`, with the search box, "select all" and "new workspace" switched on
+ * by `searchable`, `selectAll` and `allowCreate` (all off by default).
+ *
+ * The ticks are the store's, not this component's, unless `selectedIds` is passed: however
+ * many of these are on screen (one per open menu), and wherever else the selection is read,
+ * they then show the same thing. Every workspace is listed, the ones shared read-only too —
+ * mentioning one only reads it.
  *
- * The ticks are the store's, not this component's: however many of these are on
- * screen (one per open menu), and wherever else the selection is read, they show the
- * same thing. Every workspace is listed, the ones shared read-only too — mentioning
- * one only reads it.
+ * To lay the pieces out yourself, use `<workspace-mention>` with its own content instead.
  */
 export declare class WorkspaceMentionList {
+  /** Shows a search box. */
+  readonly searchable: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  /** Shows "select all". */
+  readonly selectAll: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  /** Shows "new workspace". */
+  readonly allowCreate: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  /** What the search matches: the name only (default), or the name and the description. */
+  readonly searchFields: import("@angular/core").InputSignal<WorkspaceSearchFields>;
+  /** The ticked ids when the host owns the selection; absent, they live in the store. */
+  readonly selectedIds: import("@angular/core").InputSignal<readonly string[] | undefined>;
   /** The ticks changed because of this list. */
   readonly selectionChanged: import("@angular/core").OutputEmitterRef<MentionSelection>;
-  private readonly store;
-  protected readonly status: import("@angular/core").WritableSignal<"error" | "loading" | "ready">;
+  /** A workspace was created from here, and ticked. */
+  readonly workspaceCreated: import("@angular/core").OutputEmitterRef<Workspace>;
+  private readonly mention;
   /** The rows, for this list and for a host that draws its own. */
-  readonly items: import("@angular/core").Signal<{
-    id: string;
-    name: string;
-    color: import("@sinequa/atomic-angular/document-workspaces").WorkspaceColor;
-    documentCount: number;
-    selected: boolean;
-  }[]>;
-  constructor();
+  readonly items: import("@angular/core").Signal<import("@sinequa/atomic-angular/document-workspaces").MentionItem[]>;
   /** Ticks a workspace from outside — a host that has its own way of choosing one. */
   select(id: string): void;
-  protected toggle(id: string, checked: boolean): void;
-  private announce;
   static ɵfac: i0.ɵɵFactoryDeclaration<WorkspaceMentionList, never>;
-  static ɵcmp: i0.ɵɵComponentDeclaration<WorkspaceMentionList, "workspace-mention-list", never, {}, {
+  static ɵcmp: i0.ɵɵComponentDeclaration<WorkspaceMentionList, "workspace-mention-list", never, {
+    "searchable": {
+      "alias": "searchable";
+      "required": false;
+      "isSignal": true;
+    };
+    "selectAll": {
+      "alias": "selectAll";
+      "required": false;
+      "isSignal": true;
+    };
+    "allowCreate": {
+      "alias": "allowCreate";
+      "required": false;
+      "isSignal": true;
+    };
+    "searchFields": {
+      "alias": "searchFields";
+      "required": false;
+      "isSignal": true;
+    };
+    "selectedIds": {
+      "alias": "selectedIds";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {
     "selectionChanged": "selectionChanged";
+    "workspaceCreated": "workspaceCreated";
   }, never, never, true, never>;
 }
+/**
+ * Mention workspaces: the state of the menu (search, category, ticks, "select all", "new
+ * workspace") shared with the pieces placed inside it.
+ *
+ * Empty, it is the ready-made menu — the rows, plus the search box, "select all" and "new
+ * workspace" you switch on:
+ *
+ * ```html
+ * <workspace-mention searchable selectAll allowCreate (selectionChanged)="onMention($event)" />
+ * ```
+ *
+ * With content, it only provides the state, and you lay it out with the pieces
+ * (`workspace-mention-search`, `-select-all`, `-new`, `-tabs`) and your own markup over `items()`:
+ *
+ * ```html
+ * <workspace-mention #ws="workspaceMention" searchFields="name+description" [selectedIds]="ids()" (selectionChanged)="ids.set($event.ids)">
+ *   <workspace-mention-search />
+ *   @for (w of ws.items(); track w.id) { <my-card [workspace]="w" (click)="ws.toggle(w.id, !w.selected)" /> }
+ * </workspace-mention>
+ * ```
+ *
+ * The ticks are the store's, so every menu on screen shows the same ones — unless `selectedIds`
+ * is passed: the ticks are then the host's, and it hears each change from `selectionChanged`.
+ */
+export declare class WorkspaceMention implements WorkspaceMentionApi, AfterContentInit {
+  /** What the search matches: the name only (default), or the name and the description. */
+  readonly searchFields: import("@angular/core").InputSignal<WorkspaceSearchFields>;
+  /** The ticked ids when the host owns the selection; absent, they live in the store. */
+  readonly selectedIds: import("@angular/core").InputSignal<readonly string[] | undefined>;
+  /** An extra condition a workspace must meet to be offered, on top of the category and the search. */
+  readonly predicate: import("@angular/core").InputSignal<((workspace: Workspace) => boolean) | undefined>;
+  /** The ready-made menu only: shows the search box. */
+  readonly searchable: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  /** The ready-made menu only: shows "select all". */
+  readonly selectAll: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  /** The ready-made menu only: shows "new workspace". */
+  readonly allowCreate: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  /** The ticks changed because of this menu. */
+  readonly selectionChanged: import("@angular/core").OutputEmitterRef<MentionSelection>;
+  /** A workspace was created from here, and ticked. */
+  readonly workspaceCreated: import("@angular/core").OutputEmitterRef<Workspace>;
+  private readonly slot;
+  /** Whether the host put its own content inside: the ready-made menu then stays out. */
+  protected readonly custom: import("@angular/core").WritableSignal<boolean>;
+  private readonly state;
+  readonly query: import("@angular/core").WritableSignal<string>;
+  readonly clearQuery: () => void;
+  readonly tab: import("@angular/core").WritableSignal<import("@sinequa/atomic-angular/document-workspaces").WorkspaceTab>;
+  readonly tabs: readonly {
+    id: import("@sinequa/atomic-angular/document-workspaces").WorkspaceTab;
+    labelKey: string;
+  }[];
+  readonly counts: import("@angular/core").Signal<import("@sinequa/atomic-angular/document-workspaces").WorkspaceTabCounts>;
+  readonly status: import("@angular/core").Signal<"loading" | "ready" | "error">;
+  readonly hasMore: import("@angular/core").Signal<boolean>;
+  readonly truncated: import("@angular/core").Signal<boolean>;
+  readonly loadingMore: import("@angular/core").Signal<boolean>;
+  readonly loadMore: () => Promise<void>;
+  readonly items: import("@angular/core").Signal<import("@sinequa/atomic-angular/document-workspaces").MentionItem[]>;
+  readonly count: import("@angular/core").Signal<number>;
+  readonly ids: import("@angular/core").Signal<readonly string[]>;
+  readonly allSelected: import("@angular/core").Signal<boolean>;
+  readonly partiallySelected: import("@angular/core").Signal<boolean>;
+  readonly isSelected: (id: string) => boolean;
+  readonly toggle: (id: string, checked: boolean) => void;
+  readonly toggleAll: () => void;
+  readonly select: (id: string) => void;
+  readonly create: () => Promise<Workspace | null>;
+  ngAfterContentInit(): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<WorkspaceMention, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<WorkspaceMention, "workspace-mention", ["workspaceMention"], {
+    "searchFields": {
+      "alias": "searchFields";
+      "required": false;
+      "isSignal": true;
+    };
+    "selectedIds": {
+      "alias": "selectedIds";
+      "required": false;
+      "isSignal": true;
+    };
+    "predicate": {
+      "alias": "predicate";
+      "required": false;
+      "isSignal": true;
+    };
+    "searchable": {
+      "alias": "searchable";
+      "required": false;
+      "isSignal": true;
+    };
+    "selectAll": {
+      "alias": "selectAll";
+      "required": false;
+      "isSignal": true;
+    };
+    "allowCreate": {
+      "alias": "allowCreate";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {
+    "selectionChanged": "selectionChanged";
+    "workspaceCreated": "workspaceCreated";
+  }, never, ["*"], true, never>;
+}
+/**
+ * The "+ New workspace" button of the enclosing `<workspace-mention>`: it opens the same
+ * dialog as the workspaces page, and the workspace it makes is ticked.
+ *
+ * Its look is the host's: `variant`, `scheme` and `size` are the button's own, and content
+ * placed inside replaces the icon and the label.
+ *
+ * ```html
+ * <workspace-mention-new variant="primary" size="md">Add a workspace</workspace-mention-new>
+ * ```
+ */
+export declare class WorkspaceMentionNew implements AfterContentInit {
+  /** The button's variant. */
+  readonly variant: import("@angular/core").InputSignal<"none" | "primary" | "secondary" | "light-accent" | "accent" | "tertiary" | null | undefined>;
+  /** The button's colour scheme. */
+  readonly scheme: import("@angular/core").InputSignal<"default" | "neutral" | null | undefined>;
+  /** The button's size. */
+  readonly size: import("@angular/core").InputSignal<"small" | "medium" | "md" | "lg" | "sm" | "xs" | "xsmall" | "large" | null | undefined>;
+  private readonly mention;
+  private readonly slot;
+  /** Whether the host put its own content inside: the icon and the label then stay out. */
+  protected readonly custom: import("@angular/core").WritableSignal<boolean>;
+  ngAfterContentInit(): void;
+  protected create(): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<WorkspaceMentionNew, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<WorkspaceMentionNew, "workspace-mention-new", never, {
+    "variant": {
+      "alias": "variant";
+      "required": false;
+      "isSignal": true;
+    };
+    "scheme": {
+      "alias": "scheme";
+      "required": false;
+      "isSignal": true;
+    };
+    "size": {
+      "alias": "size";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, ["*"], true, never>;
+}
+/**
+ * The workspaces of the enclosing `<workspace-mention>` as rows to tick: the default
+ * look of the menu. A host that wants another look loops over the scope's `items()` itself.
+ *
+ * It fills the height its host gives it and scrolls inside it; with no fixed height around it,
+ * it stops at 18rem — or at `--workspace-mention-rows-max-height`, which the host can set (`none` lifts it).
+ */
+export declare class WorkspaceMentionRows {
+  protected readonly mention: {
+    query: import("@angular/core").WritableSignal<string>;
+    clearQuery: () => void;
+    tab: import("@angular/core").WritableSignal<import("@sinequa/atomic-angular/document-workspaces").WorkspaceTab>;
+    tabs: readonly {
+      id: import("@sinequa/atomic-angular/document-workspaces").WorkspaceTab;
+      labelKey: string;
+    }[];
+    counts: import("@angular/core").Signal<import("@sinequa/atomic-angular/document-workspaces").WorkspaceTabCounts>;
+    status: import("@angular/core").Signal<"loading" | "ready" | "error">;
+    hasMore: import("@angular/core").Signal<boolean>;
+    truncated: import("@angular/core").Signal<boolean>;
+    loadingMore: import("@angular/core").Signal<boolean>;
+    loadMore(): Promise<void>;
+    items: import("@angular/core").Signal<import("@sinequa/atomic-angular/document-workspaces").MentionItem[]>;
+    count: import("@angular/core").Signal<number>;
+    ids: import("@angular/core").Signal<readonly string[]>;
+    allSelected: import("@angular/core").Signal<boolean>;
+    partiallySelected: import("@angular/core").Signal<boolean>;
+    isSelected: (id: string) => boolean;
+    toggle: (id: string, checked: boolean) => void;
+    toggleAll: () => void;
+    select: (id: string) => void;
+    create(): Promise<import("@sinequa/atomic-angular/document-workspaces").Workspace | null>;
+  };
+  static ɵfac: i0.ɵɵFactoryDeclaration<WorkspaceMentionRows, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<WorkspaceMentionRows, "workspace-mention-rows", never, {}, {}, never, never, true, never>;
+}
+/** The search box of the enclosing `<workspace-mention>`: it narrows what the menu offers. */
+export declare class WorkspaceMentionSearch {
+  /** The size of the box, as `<SearchInput>` sizes it. */
+  readonly size: import("@angular/core").InputSignal<"md" | "lg" | "sm" | null | undefined>;
+  /** The size of the text, as `<SearchInput>` sizes it; follows `size` when absent. */
+  readonly textSize: import("@angular/core").InputSignal<"base" | "sm" | null | undefined>;
+  /** The hint shown in the empty box; the translated "Search workspace..." when absent. */
+  readonly placeholder: import("@angular/core").InputSignal<string | undefined>;
+  /** The accessible name of the box; the placeholder when absent. */
+  readonly ariaLabel: import("@angular/core").InputSignal<string | undefined>;
+  private readonly mention;
+  /** Bound to the scope's own query signal. */
+  protected readonly searchForm: import("@angular/forms/signals").FieldTree<string, string | number, "writable">;
+  static ɵfac: i0.ɵɵFactoryDeclaration<WorkspaceMentionSearch, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<WorkspaceMentionSearch, "workspace-mention-search", never, {
+    "size": {
+      "alias": "size";
+      "required": false;
+      "isSignal": true;
+    };
+    "textSize": {
+      "alias": "textSize";
+      "required": false;
+      "isSignal": true;
+    };
+    "placeholder": {
+      "alias": "placeholder";
+      "required": false;
+      "isSignal": true;
+    };
+    "ariaLabel": {
+      "alias": "aria-label";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, never, true, never>;
+}
+/**
+ * The "select all" checkbox of the enclosing `<workspace-mention>`. It acts on what is
+ * displayed — the current category and search — and shows a mixed state when only some are ticked.
+ * Absent while the list loads and while nothing is displayed: there is nothing to select.
+ */
+export declare class WorkspaceMentionSelectAll {
+  protected readonly mention: {
+    query: import("@angular/core").WritableSignal<string>;
+    clearQuery: () => void;
+    tab: import("@angular/core").WritableSignal<import("@sinequa/atomic-angular/document-workspaces").WorkspaceTab>;
+    tabs: readonly {
+      id: import("@sinequa/atomic-angular/document-workspaces").WorkspaceTab;
+      labelKey: string;
+    }[];
+    counts: import("@angular/core").Signal<import("@sinequa/atomic-angular/document-workspaces").WorkspaceTabCounts>;
+    status: import("@angular/core").Signal<"loading" | "ready" | "error">;
+    hasMore: import("@angular/core").Signal<boolean>;
+    truncated: import("@angular/core").Signal<boolean>;
+    loadingMore: import("@angular/core").Signal<boolean>;
+    loadMore(): Promise<void>;
+    items: import("@angular/core").Signal<import("@sinequa/atomic-angular/document-workspaces").MentionItem[]>;
+    count: import("@angular/core").Signal<number>;
+    ids: import("@angular/core").Signal<readonly string[]>;
+    allSelected: import("@angular/core").Signal<boolean>;
+    partiallySelected: import("@angular/core").Signal<boolean>;
+    isSelected: (id: string) => boolean;
+    toggle: (id: string, checked: boolean) => void;
+    toggleAll: () => void;
+    select: (id: string) => void;
+    create(): Promise<import("@sinequa/atomic-angular/document-workspaces").Workspace | null>;
+  };
+  static ɵfac: i0.ɵɵFactoryDeclaration<WorkspaceMentionSelectAll, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<WorkspaceMentionSelectAll, "workspace-mention-select-all", never, {}, {}, never, never, true, never>;
+}
+/**
+ * The categories of the enclosing `<workspace-mention>` — all, owned, shared — each with the
+ * number of workspaces it holds. A host that lays the categories out differently (a sidebar)
+ * reads `tabs`, `tab` and `counts` from the scope instead.
+ */
+export declare class WorkspaceMentionTabs {
+  /** The accessible name of the category list; the translated "Categories" when absent. */
+  readonly ariaLabel: import("@angular/core").InputSignal<string | undefined>;
+  protected readonly mention: {
+    query: import("@angular/core").WritableSignal<string>;
+    clearQuery: () => void;
+    tab: import("@angular/core").WritableSignal<WorkspaceTab>;
+    tabs: readonly {
+      id: WorkspaceTab;
+      labelKey: string;
+    }[];
+    counts: import("@angular/core").Signal<import("@sinequa/atomic-angular/document-workspaces").WorkspaceTabCounts>;
+    status: import("@angular/core").Signal<"loading" | "ready" | "error">;
+    hasMore: import("@angular/core").Signal<boolean>;
+    truncated: import("@angular/core").Signal<boolean>;
+    loadingMore: import("@angular/core").Signal<boolean>;
+    loadMore(): Promise<void>;
+    items: import("@angular/core").Signal<import("@sinequa/atomic-angular/document-workspaces").MentionItem[]>;
+    count: import("@angular/core").Signal<number>;
+    ids: import("@angular/core").Signal<readonly string[]>;
+    allSelected: import("@angular/core").Signal<boolean>;
+    partiallySelected: import("@angular/core").Signal<boolean>;
+    isSelected: (id: string) => boolean;
+    toggle: (id: string, checked: boolean) => void;
+    toggleAll: () => void;
+    select: (id: string) => void;
+    create(): Promise<import("@sinequa/atomic-angular/document-workspaces").Workspace | null>;
+  };
+  protected onTabChange(tab: string | undefined): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<WorkspaceMentionTabs, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<WorkspaceMentionTabs, "workspace-mention-tabs", never, {
+    "ariaLabel": {
+      "alias": "aria-label";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, never, true, never>;
+}
 /** What "save" attaches to a workspace: a document that already exists, by name. */
 interface PickerDocument {
   name: string;
@@ -2324,7 +2798,7 @@ export declare class WorkspacePicker {
   /** The documents are in the workspace, and the check mark has been seen. */
   readonly completed: import("@angular/core").OutputEmitterRef<Workspace>;
   private readonly store;
-  protected readonly status: import("@angular/core").WritableSignal<"error" | "loading" | "ready">;
+  protected readonly status: import("@angular/core").WritableSignal<"loading" | "ready" | "error">;
   protected readonly busyId: import("@angular/core").WritableSignal<string | null>;
   protected readonly doneId: import("@angular/core").WritableSignal<string | null>;
   protected readonly error: import("@angular/core").WritableSignal<Message | null>;
@@ -2524,4 +2998,4 @@ export declare class WorkspacesShell {
     "askFollowUp": "askFollowUp";
   }, never, never, true, never>;
 }
-export type { AddFilesOptions, AskFollowUp, AssignableRole, ConfirmDialogConfig, ConnectionNotice, CreateWorkspaceInput, CurrentUser, DocumentLabels, DocumentStatus, DocumentType, Member, MentionSelection, Pagination, PickedPrincipal, PickerDocument, PrincipalSummary, RemoveWorkspacesResult, ResolvedPrincipal, Selection, SelectionOptions, ShareDialogConfig, TextSearch, TextSearchOptions, TrackFileInput, TrackedUpload, TrackerWorkspace, UploadDialogConfig, UploadEvents, UploadFactory, UploadHandle, UploadOptions, UploadStatus, UploadTarget, UploadTrackerState, Workspace, WorkspaceColor, WorkspaceDocument, WorkspaceEditDialogConfig, WorkspaceEditResult, WorkspacePickerDialogConfig, WorkspacePickerResult, WorkspaceRole, WorkspaceTab, WorkspaceTabCounts, WorkspacesState };
+export type { AddFilesOptions, AskFollowUp, AssignableRole, ConfirmDialogConfig, ConnectionNotice, CreateWorkspaceInput, CurrentUser, DocumentLabels, DocumentStatus, DocumentType, Member, MentionItem, MentionSelection, Pagination, PickedPrincipal, PickerDocument, PrincipalSummary, RemoveWorkspacesResult, ResolvedPrincipal, Selection, SelectionOptions, ShareDialogConfig, TextSearch, TextSearchOptions, TrackFileInput, TrackedUpload, TrackerWorkspace, UploadDialogConfig, UploadEvents, UploadFactory, UploadHandle, UploadOptions, UploadStatus, UploadTarget, UploadTrackerState, Workspace, WorkspaceColor, WorkspaceDocument, WorkspaceEditDialogConfig, WorkspaceEditResult, WorkspaceFilterOptions, WorkspaceMentionApi, WorkspaceMentionOptions, WorkspacePickerDialogConfig, WorkspacePickerResult, WorkspaceRole, WorkspaceSearchFields, WorkspaceTab, WorkspaceTabCounts, WorkspacesState };