@sinequa/atomic-angular 2.15.0 → 2.16.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sinequa/atomic-angular",
-  "version": "2.15.0",
+  "version": "2.16.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.10.0",
+    "@sinequa/atomic": ">=2.16.0",
     "vanilla-calendar-pro": "^3.4.0",
     "chart.js": "^4.4.0",
     "chartjs-chart-matrix": "^3.0.0",

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

@@ -16,11 +16,21 @@ interface Workspace {
   color: WorkspaceColor;
   description: string;
   tags: string[];
-  documentCount: number;
+  /**
+   * Documents in the workspace. `undefined` until known: the search that lists the workspaces
+   * does not count them, the one that lists a workspace's content does.
+   */
+  documentCount?: number;
   creatorId: string;
   ownerIds: string[];
   readerIds: string[];
   currentUserRole: WorkspaceRole;
+  /**
+   * Whether `creatorId`, `ownerIds` and `readerIds` hold the real lists. The search that lists
+   * workspaces does not return them (only the create/update calls do), so a workspace read that
+   * way has them empty: sending those empty lists back would wipe the real ones.
+   */
+  membersKnown: boolean;
 }
 /** Lifecycle of a document being added: `null` (or absent) once it is indexed. */
 type DocumentStatus = "uploading" | "indexing" | "error";
@@ -148,6 +158,11 @@ interface ConnectionNotice {
    */
   retry?(): void;
 }
+/**
+ * Query web service the agent-workspace search runs on. The server answers with its own
+ * document-upload query whatever name is sent, but the request still has to carry one.
+ */
+declare const WORKSPACES_QUERY_NAME = "query_Web";
 /**
  * Most workspaces the list keeps loaded: "load more" stops there, so the list never puts an
  * unbounded number of cards in the DOM. Past it, {@link WorkspacesStore.truncated} is true.
@@ -168,6 +183,10 @@ interface WorkspacesState {
   documentPagination: Record<string, Pagination>;
   /** Ids ticked in the "+"/"@" mention pickers — shared between every picker instance. */
   selectedIds: string[];
+  /** What the list's search box asked the server for ("" = every workspace). Reloads and "load more" keep it. */
+  searchText: string;
+  /** What each open workspace's search box asked the server for, by workspace id. Refreshes keep it. */
+  documentSearch: Record<string, string>;
 }
 interface CreateWorkspaceInput {
   name: string;
@@ -185,8 +204,9 @@ interface RemoveWorkspacesResult {
   }[];
 }
 /**
- * Workspaces and their documents, backed by the container-management API
- * (`@sinequa/atomic`'s `*Container*` functions).
+ * Workspaces and their documents. They are read through the agent-workspace search
+ * (`fetchWorkspaces`, `fetchWorkspace`, `fetchWorkspaceContent` of `@sinequa/atomic`) and written
+ * through the workspace management endpoints (create, update, delete, documents).
  *
  * Root-scoped on purpose: the workspace list, the mention picker and the
  * save/move picker are separate components that have to see the same cache and
@@ -207,6 +227,8 @@ export declare const WorkspacesStore: import("@angular/core").Type<{
   documents: import("@angular/core").Signal<Record<string, WorkspaceDocument[]>>;
   documentPagination: import("@angular/core").Signal<Record<string, Pagination>>;
   selectedIds: import("@angular/core").Signal<string[]>;
+  searchText: import("@angular/core").Signal<string>;
+  documentSearch: import("@angular/core").Signal<Record<string, string>>;
   hasMore: import("@angular/core").Signal<boolean>;
   truncated: import("@angular/core").Signal<boolean>;
   selectedCount: import("@angular/core").Signal<number>;
@@ -216,6 +238,7 @@ export declare const WorkspacesStore: import("@angular/core").Type<{
   hasMoreDocuments: (workspaceId: string) => boolean;
   ensureLoaded: () => Promise<Workspace[]>;
   reload: () => Promise<Workspace[]>;
+  search: (text: string) => Promise<Workspace[]>;
   loadMore: () => Promise<Workspace[]>;
   fetch: (id: string) => Promise<Workspace>;
   create: ({ name, description, tags, owners, readers }: CreateWorkspaceInput) => Promise<Workspace>;
@@ -223,6 +246,8 @@ export declare const WorkspacesStore: import("@angular/core").Type<{
   remove: (ids: string[]) => Promise<RemoveWorkspacesResult>;
   forget: (id: string) => void;
   loadDocuments: (workspaceId: string, signal?: AbortSignal) => Promise<WorkspaceDocument[]>;
+  searchDocuments: (workspaceId: string, text: string, signal?: AbortSignal) => Promise<WorkspaceDocument[]>;
+  resetDocumentSearch: (workspaceId: string) => void;
   loadMoreDocuments: (workspaceId: string) => Promise<WorkspaceDocument[]>;
   addDocuments: (workspaceId: string, documents: WorkspaceDocument[]) => void;
   discardDocuments: (workspaceId: string, documentIds: string[]) => void;
@@ -240,6 +265,8 @@ export declare const WorkspacesStore: import("@angular/core").Type<{
   documents: Record<string, WorkspaceDocument[]>;
   documentPagination: Record<string, Pagination>;
   selectedIds: string[];
+  searchText: string;
+  documentSearch: Record<string, string>;
 }>>;
 interface TrackerWorkspace {
   id: string;
@@ -968,6 +995,11 @@ type WorkspaceSearchFields = "name" | "name+description";
 interface WorkspaceFilterOptions {
   /** What the query is matched against. Read reactively; the name only when absent. */
   fields?: () => WorkspaceSearchFields;
+  /**
+   * The server does the searching: `filtered` then keeps only the tab and does not narrow by the query itself
+   * (the list it reads is already the answer). The query is still there for the search box and the highlighting.
+   */
+  serverSide?: boolean;
 }
 /**
  * The workspace list's tab and search box, and the list they produce.
@@ -1509,6 +1541,8 @@ export declare class WorkspaceList {
     documents: import("@angular/core").Signal<Record<string, import("@sinequa/atomic-angular/document-workspaces").WorkspaceDocument[]>>;
     documentPagination: import("@angular/core").Signal<Record<string, import("@sinequa/atomic-angular/document-workspaces").Pagination>>;
     selectedIds: import("@angular/core").Signal<string[]>;
+    searchText: import("@angular/core").Signal<string>;
+    documentSearch: import("@angular/core").Signal<Record<string, string>>;
     hasMore: import("@angular/core").Signal<boolean>;
     truncated: import("@angular/core").Signal<boolean>;
     selectedCount: import("@angular/core").Signal<number>;
@@ -1518,6 +1552,7 @@ export declare class WorkspaceList {
     hasMoreDocuments: (workspaceId: string) => boolean;
     ensureLoaded: () => Promise<Workspace[]>;
     reload: () => Promise<Workspace[]>;
+    search: (text: string) => Promise<Workspace[]>;
     loadMore: () => Promise<Workspace[]>;
     fetch: (id: string) => Promise<Workspace>;
     create: ({ name, description, tags, owners, readers }: import("@sinequa/atomic-angular/document-workspaces").CreateWorkspaceInput) => Promise<Workspace>;
@@ -1525,6 +1560,8 @@ export declare class WorkspaceList {
     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[]>;
+    searchDocuments: (workspaceId: string, text: string, signal?: AbortSignal) => Promise<import("@sinequa/atomic-angular/document-workspaces").WorkspaceDocument[]>;
+    resetDocumentSearch: (workspaceId: string) => void;
     loadMoreDocuments: (workspaceId: string) => Promise<import("@sinequa/atomic-angular/document-workspaces").WorkspaceDocument[]>;
     addDocuments: (workspaceId: string, documents: import("@sinequa/atomic-angular/document-workspaces").WorkspaceDocument[]) => void;
     discardDocuments: (workspaceId: string, documentIds: string[]) => void;
@@ -1542,6 +1579,8 @@ export declare class WorkspaceList {
     documents: Record<string, import("@sinequa/atomic-angular/document-workspaces").WorkspaceDocument[]>;
     documentPagination: Record<string, import("@sinequa/atomic-angular/document-workspaces").Pagination>;
     selectedIds: string[];
+    searchText: string;
+    documentSearch: Record<string, string>;
   }>;
   private readonly uploads;
   private readonly injector;
@@ -1551,7 +1590,7 @@ export declare class WorkspaceList {
     labelKey: string;
   }[];
   protected readonly viewMode: import("@angular/core").WritableSignal<ViewMode$1>;
-  protected readonly status: import("@angular/core").WritableSignal<"loading" | "ready" | "error">;
+  protected readonly status: import("@angular/core").WritableSignal<"error" | "loading" | "ready">;
   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>;
@@ -1568,6 +1607,7 @@ export declare class WorkspaceList {
   protected readonly selection: import("@sinequa/atomic-angular/document-workspaces").Selection<Workspace>;
   private readonly liveRefresh;
   constructor();
+  private search;
   /** Shows what is cached at once and refreshes behind it, or loads for the first time. */
   protected load(): Promise<void>;
   private refresh;
@@ -2005,8 +2045,17 @@ export declare class ShareDialog {
   protected readonly staged: import("@angular/core").WritableSignal<PickedPrincipal[]>;
   protected readonly adding: import("@angular/core").WritableSignal<boolean>;
   protected readonly busy: import("@angular/core").WritableSignal<boolean>;
+  /** The people with access are being read: the search that lists workspaces does not return them. */
+  protected readonly loadingMembers: import("@angular/core").WritableSignal<boolean>;
   protected readonly error: import("@angular/core").WritableSignal<WorkspaceErrorMessage | null>;
   constructor();
+  /**
+   * The search that lists the workspaces returns who the caller is, not who else has access. An update
+   * that changes nothing answers with the whole workspace: that is where the people come from.
+   * Until then the dialog writes nothing, since the API replaces the owners and readers wholesale.
+   */
+  private loadMembers;
+  protected reloadMembers(): void;
   protected add(): Promise<void>;
   protected change(id: string, role: AssignableRole | "remove"): Promise<void>;
   /** One write at a time: the arrays it sends are built from the workspace as it is now. */
@@ -2135,7 +2184,7 @@ export declare class WorkspaceEditDialog {
   protected readonly busy: import("@angular/core").WritableSignal<boolean>;
   protected readonly error: import("@angular/core").WritableSignal<WorkspaceErrorMessage | null>;
   protected readonly descriptionTooLong: import("@angular/core").Signal<boolean>;
-  protected readonly saveLabel: import("@angular/core").Signal<"documentWorkspaces.edit.creating" | "documentWorkspaces.edit.saving" | "documentWorkspaces.common.create" | "documentWorkspaces.common.save">;
+  protected readonly saveLabel: import("@angular/core").Signal<"documentWorkspaces.common.save" | "documentWorkspaces.edit.creating" | "documentWorkspaces.edit.saving" | "documentWorkspaces.common.create">;
   /** What to resolve with once the native dialog has closed: the saved workspace, or the plain dismissal. */
   private outcome;
   constructor();
@@ -2192,7 +2241,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<"loading" | "ready" | "error">;
+  protected readonly status: import("@angular/core").WritableSignal<"error" | "loading" | "ready">;
   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>;
@@ -2216,6 +2265,7 @@ export declare class WorkspaceDetail {
   protected readonly selection: import("@sinequa/atomic-angular/document-workspaces").Selection<WorkspaceDocument>;
   private readonly liveRefresh;
   constructor();
+  private search;
   private open;
   /**
    * Leaving from here: once the background refresh found the workspace gone,
@@ -2278,7 +2328,7 @@ interface MentionItem {
   name: string;
   description: string;
   color: WorkspaceColor;
-  documentCount: number;
+  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;
@@ -2327,7 +2377,7 @@ export declare function injectWorkspaceMention(options?: WorkspaceMentionOptions
   /** 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">;
+  status: import("@angular/core").Signal<"error" | "loading" | "ready">;
   /** 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. */
@@ -2374,7 +2424,7 @@ export declare const WORKSPACE_MENTION: InjectionToken<{
   /** 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">;
+  status: import("@angular/core").Signal<"error" | "loading" | "ready">;
   /** 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. */
@@ -2525,7 +2575,7 @@ export declare class WorkspaceMention implements WorkspaceMentionApi, AfterConte
     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 status: import("@angular/core").Signal<"error" | "loading" | "ready">;
   readonly hasMore: import("@angular/core").Signal<boolean>;
   readonly truncated: import("@angular/core").Signal<boolean>;
   readonly loadingMore: import("@angular/core").Signal<boolean>;
@@ -2595,7 +2645,7 @@ export declare class WorkspaceMentionNew implements AfterContentInit {
   /** 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<"sm" | "md" | "lg" | "small" | "xs" | "xsmall" | "medium" | "large" | null | undefined>;
+  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. */
@@ -2638,7 +2688,7 @@ export declare class WorkspaceMentionRows {
       labelKey: string;
     }[];
     counts: import("@angular/core").Signal<import("@sinequa/atomic-angular/document-workspaces").WorkspaceTabCounts>;
-    status: import("@angular/core").Signal<"loading" | "ready" | "error">;
+    status: import("@angular/core").Signal<"error" | "loading" | "ready">;
     hasMore: import("@angular/core").Signal<boolean>;
     truncated: import("@angular/core").Signal<boolean>;
     loadingMore: import("@angular/core").Signal<boolean>;
@@ -2660,9 +2710,9 @@ export declare class WorkspaceMentionRows {
 /** 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<"sm" | "md" | "lg" | null | undefined>;
+  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<"sm" | "base" | null | undefined>;
+  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. */
@@ -2709,7 +2759,7 @@ export declare class WorkspaceMentionSelectAll {
       labelKey: string;
     }[];
     counts: import("@angular/core").Signal<import("@sinequa/atomic-angular/document-workspaces").WorkspaceTabCounts>;
-    status: import("@angular/core").Signal<"loading" | "ready" | "error">;
+    status: import("@angular/core").Signal<"error" | "loading" | "ready">;
     hasMore: import("@angular/core").Signal<boolean>;
     truncated: import("@angular/core").Signal<boolean>;
     loadingMore: import("@angular/core").Signal<boolean>;
@@ -2745,7 +2795,7 @@ export declare class WorkspaceMentionTabs {
       labelKey: string;
     }[];
     counts: import("@angular/core").Signal<import("@sinequa/atomic-angular/document-workspaces").WorkspaceTabCounts>;
-    status: import("@angular/core").Signal<"loading" | "ready" | "error">;
+    status: import("@angular/core").Signal<"error" | "loading" | "ready">;
     hasMore: import("@angular/core").Signal<boolean>;
     truncated: import("@angular/core").Signal<boolean>;
     loadingMore: import("@angular/core").Signal<boolean>;
@@ -2790,14 +2840,14 @@ export declare const NEW_WORKSPACE_NAME_MAX = 50;
  */
 export declare class WorkspacePicker {
   /** `save` attaches `documents` to the chosen workspace; `move` takes `documentIds` from `fromWorkspaceId` to it. */
-  readonly mode: import("@angular/core").InputSignal<"save" | "move">;
+  readonly mode: import("@angular/core").InputSignal<"move" | "save">;
   readonly documents: import("@angular/core").InputSignal<readonly PickerDocument[]>;
   readonly fromWorkspaceId: import("@angular/core").InputSignal<string | null>;
   readonly documentIds: import("@angular/core").InputSignal<readonly string[]>;
   /** 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<"loading" | "ready" | "error">;
+  protected readonly status: import("@angular/core").WritableSignal<"error" | "loading" | "ready">;
   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>;