@ai-matrx/associations 0.11.4 → 0.13.0

package/dist/react/index.d.cts

@@ -1,7 +1,7 @@
 import * as react from 'react';
 import { ReactNode, ComponentType } from 'react';
-import { j as AssociationsNotifier, W as WindowShellPort, k as CapturePort, P as PickerOverrideMap, E as EntityDoorsPort, l as AuthorDisplayPort, m as AssociationsStore, n as CategoryMutationResult, o as CategoryDimension, p as PlatformCategory, q as CategoriesEntry, r as EntityTypeToken, s as UniversalCandidate, t as CandidateRecord, u as PlatformComment, v as CommentsEntry, w as CommentMutationResult, e as AssociationPickerProps, x as EntityDoorProps, y as EntityRefProps, z as ContentRole } from '../CommentThread-DDeqHgTk.cjs';
-export { B as AssociationCaptureToolbar, A as AssociationCaptureToolbarProps, D as AssociationCard, F as AssociationCardGrid, b as AssociationCardGridProps, a as AssociationCardProps, G as AssociationEntitySelect, H as AssociationEntitySelectAdapter, I as AssociationEntitySelectItem, c as AssociationEntitySelectProps, J as AssociationList, d as AssociationListProps, K as AssociationWindow, f as AssociationWindowProps, L as AssociationWriteResult, M as AttachedItemsSheet, g as AttachedItemsSheetProps, N as CaptureAttach, O as CaptureAttachResult, Q as CaptureToolbarAction, R as CategorySelect, C as CategorySelectProps, S as CategoryTagPicker, h as CategoryTagPickerProps, T as CommentComposer, V as CommentComposerProps, X as CommentThread, i as CommentThreadProps, Y as ContainerLink, Z as ContainerResourceRow, _ as ContainerResourcesAdapter, $ as DefaultEntityIcon, a0 as PrimaryContainerEntity, a1 as PrimaryEntity, a2 as PrimaryEntityProvider, a3 as PrimaryFiledEntity, a4 as TagPickerIcon, a5 as UniversalAssociationPicker, U as UniversalAssociationPickerProps, a6 as UseAssociationEntitySelectAdapterArgs, a7 as UseAssociationsArgs, a8 as UseAssociationsReturn, a9 as UseContainerLinksArgs, aa as UseContainerLinksReturn, ab as attachedKey, ac as buildCommentTree, ad as containerLinksArgs, ae as useAssociationEntitySelectAdapter, af as useAssociations, ag as useContainerLinks, ah as useContainerLinksAdapter, ai as useEntityRelationships, aj as usePrimaryEntity } from '../CommentThread-DDeqHgTk.cjs';
+import { j as AssociationsNotifier, W as WindowShellPort, k as CapturePort, P as PickerOverrideMap, E as EntityDoorsPort, l as AuthorDisplayPort, m as AssociationsStore, n as CategoryMutationResult, o as CategoryDimension, p as PlatformCategory, q as CategoriesEntry, r as EntityTypeToken, s as UniversalCandidate, t as CandidateRecord, u as PlatformComment, v as CommentsEntry, w as CommentMutationResult, e as AssociationPickerProps, x as EntityDoorProps, y as EntityRefProps, z as ContentRole } from '../CommentThread-DP4sEzb2.cjs';
+export { B as AssociationCaptureToolbar, A as AssociationCaptureToolbarProps, D as AssociationCard, F as AssociationCardGrid, b as AssociationCardGridProps, a as AssociationCardProps, G as AssociationEntitySelect, H as AssociationEntitySelectAdapter, I as AssociationEntitySelectItem, c as AssociationEntitySelectProps, J as AssociationList, d as AssociationListProps, K as AssociationWindow, f as AssociationWindowProps, L as AssociationWriteResult, M as AttachedItemsSheet, g as AttachedItemsSheetProps, N as CaptureAttach, O as CaptureAttachResult, Q as CaptureToolbarAction, R as CategorySelect, C as CategorySelectProps, S as CategoryTagPicker, h as CategoryTagPickerProps, T as CommentComposer, V as CommentComposerProps, X as CommentThread, i as CommentThreadProps, Y as ContainerLink, Z as ContainerResourceRow, _ as ContainerResourcesAdapter, $ as DefaultEntityIcon, a0 as PrimaryContainerEntity, a1 as PrimaryEntity, a2 as PrimaryEntityProvider, a3 as PrimaryFiledEntity, a4 as TagPickerIcon, a5 as UniversalAssociationPicker, U as UniversalAssociationPickerProps, a6 as UseAssociationEntitySelectAdapterArgs, a7 as UseAssociationsArgs, a8 as UseAssociationsReturn, a9 as UseContainerLinksArgs, aa as UseContainerLinksReturn, ab as attachedKey, ac as buildCommentTree, ad as containerLinksArgs, ae as useAssociationEntitySelectAdapter, af as useAssociations, ag as useContainerLinks, ah as useContainerLinksAdapter, ai as useEntityRelationships, aj as usePrimaryEntity } from '../CommentThread-DP4sEzb2.cjs';
 
 interface AssociationsUiPorts {
     notifier?: AssociationsNotifier;
@@ -97,26 +97,68 @@ interface UseUniversalEntitySearchArgs {
     query: string;
     /** Restrict to these tokens; defaults to every listable token. */
     tokens?: EntityTypeToken[];
-    /** Owner filter for the per-token candidate reads. */
-    ownerId?: string | null;
     enabled?: boolean;
     perTokenLimit?: number;
     /**
      * What an empty query loads. Universal attach surfaces default to recents;
      * constrained value pickers use candidates so opening the picker immediately
-     * shows the records that are available to select.
+     * shows the records that are available to select. `"recents"` falls back
+     * to candidates when the person has no recents for the searched tokens.
      */
     emptyQueryMode?: "recents" | "candidates";
 }
+/**
+ * What the current results ARE: `"search"` for a typed query, `"recents"` for
+ * favorites/last-viewed, `"candidates"` for an empty-query browse (asked for,
+ * or the recents fallback).
+ */
+type UniversalSearchSource = "search" | "recents" | "candidates";
+/**
+ * One read that failed. `token` names the entity type whose candidate read
+ * failed; `null` means the recents read (favorites / last-viewed) failed.
+ */
+interface UniversalSearchFailure {
+    token: EntityTypeToken | null;
+    error: string;
+}
+type UniversalSearchStatus = "loading" | "error" | "ready";
 interface UseUniversalEntitySearchReturn {
     results: UniversalCandidate[];
     /** True while the current query's sweep is in flight. */
     loading: boolean;
     /** True when `results` are recents (empty query), not search hits. */
     isRecents: boolean;
+    /** What the results are — lets the face label a browse vs recents vs hits. */
+    source: UniversalSearchSource;
+    /** Every read that failed for the current results (partial or total). */
+    failures: UniversalSearchFailure[];
+    /**
+     * Non-null only when NOTHING could be read: every searched token failed
+     * (and, for recents, the recents read found nothing or failed too).
+     */
+    error: string | null;
+    status: UniversalSearchStatus;
 }
 declare function useUniversalEntitySearch(args: UseUniversalEntitySearchArgs): UseUniversalEntitySearchReturn;
 
+interface SearchFailureNoticeProps {
+    /** `useUniversalEntitySearch().error` — set when nothing could be read. */
+    error: string | null;
+    /** `useUniversalEntitySearch().failures` — every read that failed. */
+    failures: UniversalSearchFailure[];
+    /** What the person was doing, for the error report ("Search to attach"). */
+    operation?: string;
+    /** Where this rendered, for the error report ("media/MediaSharePopover"). */
+    origin?: string;
+    className?: string;
+}
+/**
+ * "Couldn't search Notes, Tasks" / "Couldn't load recent items" — the plain
+ * sentence for a failure list. `labelFor` maps a token to its plural label.
+ */
+declare function describeSearchFailures(failures: UniversalSearchFailure[], labelFor: (token: NonNullable<UniversalSearchFailure["token"]>) => string): string;
+declare function SearchFailureNotice(props: SearchFailureNoticeProps): react.JSX.Element | null;
+
 interface UseAssociationCandidatesArgs {
     token: EntityTypeToken;
     /** Skip fetching (e.g. while the picker is closed). Defaults to true. */
@@ -295,4 +337,4 @@ interface ContentRoleMeta {
 declare const CONTENT_ROLES: ContentRoleMeta[];
 declare function getContentRoleMeta(role: ContentRole): ContentRoleMeta;
 
-export { AssociationCandidateBody, type AssociationCandidateBodyProps, AssociationPicker, type AssociationPickerBridge, type AssociationPickerBridgeOptions, AssociationPickerProps, AssociationsProvider, type AssociationsProviderProps, type AssociationsUiPorts, CONTENT_ROLES, CandidateRecord, type CategoryCreateResult, CategoryMutationResult, type ContentRoleMeta, DefaultWindowShell, type DefaultWindowShellProps, DoorControlsSlot, DoorRef, type EntityTitleRef, type PickerBridgeItem, UniversalCandidate, UnresolvedRef, type UseAssociationCandidatesArgs, type UseAssociationCandidatesReturn, type UseCategoriesArgs, type UseCategoriesReturn, type UseCommentsArgs, type UseCommentsReturn, type UseEntityTitlesReturn, type UseUniversalEntitySearchArgs, type UseUniversalEntitySearchReturn, type WindowShellComponentProps, getContentRoleMeta, lazyPickerOverride, lazyWindowShell, useAssociationCandidates, useAssociationPickerBridge, useAssociationsStore, useAssociationsUiPorts, useCategories, useComments, useEntityTitles, useNotifier, useUniversalEntitySearch };
+export { AssociationCandidateBody, type AssociationCandidateBodyProps, AssociationPicker, type AssociationPickerBridge, type AssociationPickerBridgeOptions, AssociationPickerProps, AssociationsProvider, type AssociationsProviderProps, type AssociationsUiPorts, CONTENT_ROLES, CandidateRecord, type CategoryCreateResult, CategoryMutationResult, type ContentRoleMeta, DefaultWindowShell, type DefaultWindowShellProps, DoorControlsSlot, DoorRef, type EntityTitleRef, type PickerBridgeItem, SearchFailureNotice, type SearchFailureNoticeProps, UniversalCandidate, type UniversalSearchFailure, type UniversalSearchSource, type UniversalSearchStatus, UnresolvedRef, type UseAssociationCandidatesArgs, type UseAssociationCandidatesReturn, type UseCategoriesArgs, type UseCategoriesReturn, type UseCommentsArgs, type UseCommentsReturn, type UseEntityTitlesReturn, type UseUniversalEntitySearchArgs, type UseUniversalEntitySearchReturn, type WindowShellComponentProps, describeSearchFailures, getContentRoleMeta, lazyPickerOverride, lazyWindowShell, useAssociationCandidates, useAssociationPickerBridge, useAssociationsStore, useAssociationsUiPorts, useCategories, useComments, useEntityTitles, useNotifier, useUniversalEntitySearch };

package/dist/react/index.d.ts

@@ -1,7 +1,7 @@
 import * as react from 'react';
 import { ReactNode, ComponentType } from 'react';
-import { j as AssociationsNotifier, W as WindowShellPort, k as CapturePort, P as PickerOverrideMap, E as EntityDoorsPort, l as AuthorDisplayPort, m as AssociationsStore, n as CategoryMutationResult, o as CategoryDimension, p as PlatformCategory, q as CategoriesEntry, r as EntityTypeToken, s as UniversalCandidate, t as CandidateRecord, u as PlatformComment, v as CommentsEntry, w as CommentMutationResult, e as AssociationPickerProps, x as EntityDoorProps, y as EntityRefProps, z as ContentRole } from '../CommentThread-DDeqHgTk.js';
-export { B as AssociationCaptureToolbar, A as AssociationCaptureToolbarProps, D as AssociationCard, F as AssociationCardGrid, b as AssociationCardGridProps, a as AssociationCardProps, G as AssociationEntitySelect, H as AssociationEntitySelectAdapter, I as AssociationEntitySelectItem, c as AssociationEntitySelectProps, J as AssociationList, d as AssociationListProps, K as AssociationWindow, f as AssociationWindowProps, L as AssociationWriteResult, M as AttachedItemsSheet, g as AttachedItemsSheetProps, N as CaptureAttach, O as CaptureAttachResult, Q as CaptureToolbarAction, R as CategorySelect, C as CategorySelectProps, S as CategoryTagPicker, h as CategoryTagPickerProps, T as CommentComposer, V as CommentComposerProps, X as CommentThread, i as CommentThreadProps, Y as ContainerLink, Z as ContainerResourceRow, _ as ContainerResourcesAdapter, $ as DefaultEntityIcon, a0 as PrimaryContainerEntity, a1 as PrimaryEntity, a2 as PrimaryEntityProvider, a3 as PrimaryFiledEntity, a4 as TagPickerIcon, a5 as UniversalAssociationPicker, U as UniversalAssociationPickerProps, a6 as UseAssociationEntitySelectAdapterArgs, a7 as UseAssociationsArgs, a8 as UseAssociationsReturn, a9 as UseContainerLinksArgs, aa as UseContainerLinksReturn, ab as attachedKey, ac as buildCommentTree, ad as containerLinksArgs, ae as useAssociationEntitySelectAdapter, af as useAssociations, ag as useContainerLinks, ah as useContainerLinksAdapter, ai as useEntityRelationships, aj as usePrimaryEntity } from '../CommentThread-DDeqHgTk.js';
+import { j as AssociationsNotifier, W as WindowShellPort, k as CapturePort, P as PickerOverrideMap, E as EntityDoorsPort, l as AuthorDisplayPort, m as AssociationsStore, n as CategoryMutationResult, o as CategoryDimension, p as PlatformCategory, q as CategoriesEntry, r as EntityTypeToken, s as UniversalCandidate, t as CandidateRecord, u as PlatformComment, v as CommentsEntry, w as CommentMutationResult, e as AssociationPickerProps, x as EntityDoorProps, y as EntityRefProps, z as ContentRole } from '../CommentThread-DP4sEzb2.js';
+export { B as AssociationCaptureToolbar, A as AssociationCaptureToolbarProps, D as AssociationCard, F as AssociationCardGrid, b as AssociationCardGridProps, a as AssociationCardProps, G as AssociationEntitySelect, H as AssociationEntitySelectAdapter, I as AssociationEntitySelectItem, c as AssociationEntitySelectProps, J as AssociationList, d as AssociationListProps, K as AssociationWindow, f as AssociationWindowProps, L as AssociationWriteResult, M as AttachedItemsSheet, g as AttachedItemsSheetProps, N as CaptureAttach, O as CaptureAttachResult, Q as CaptureToolbarAction, R as CategorySelect, C as CategorySelectProps, S as CategoryTagPicker, h as CategoryTagPickerProps, T as CommentComposer, V as CommentComposerProps, X as CommentThread, i as CommentThreadProps, Y as ContainerLink, Z as ContainerResourceRow, _ as ContainerResourcesAdapter, $ as DefaultEntityIcon, a0 as PrimaryContainerEntity, a1 as PrimaryEntity, a2 as PrimaryEntityProvider, a3 as PrimaryFiledEntity, a4 as TagPickerIcon, a5 as UniversalAssociationPicker, U as UniversalAssociationPickerProps, a6 as UseAssociationEntitySelectAdapterArgs, a7 as UseAssociationsArgs, a8 as UseAssociationsReturn, a9 as UseContainerLinksArgs, aa as UseContainerLinksReturn, ab as attachedKey, ac as buildCommentTree, ad as containerLinksArgs, ae as useAssociationEntitySelectAdapter, af as useAssociations, ag as useContainerLinks, ah as useContainerLinksAdapter, ai as useEntityRelationships, aj as usePrimaryEntity } from '../CommentThread-DP4sEzb2.js';
 
 interface AssociationsUiPorts {
     notifier?: AssociationsNotifier;
@@ -97,26 +97,68 @@ interface UseUniversalEntitySearchArgs {
     query: string;
     /** Restrict to these tokens; defaults to every listable token. */
     tokens?: EntityTypeToken[];
-    /** Owner filter for the per-token candidate reads. */
-    ownerId?: string | null;
     enabled?: boolean;
     perTokenLimit?: number;
     /**
      * What an empty query loads. Universal attach surfaces default to recents;
      * constrained value pickers use candidates so opening the picker immediately
-     * shows the records that are available to select.
+     * shows the records that are available to select. `"recents"` falls back
+     * to candidates when the person has no recents for the searched tokens.
      */
     emptyQueryMode?: "recents" | "candidates";
 }
+/**
+ * What the current results ARE: `"search"` for a typed query, `"recents"` for
+ * favorites/last-viewed, `"candidates"` for an empty-query browse (asked for,
+ * or the recents fallback).
+ */
+type UniversalSearchSource = "search" | "recents" | "candidates";
+/**
+ * One read that failed. `token` names the entity type whose candidate read
+ * failed; `null` means the recents read (favorites / last-viewed) failed.
+ */
+interface UniversalSearchFailure {
+    token: EntityTypeToken | null;
+    error: string;
+}
+type UniversalSearchStatus = "loading" | "error" | "ready";
 interface UseUniversalEntitySearchReturn {
     results: UniversalCandidate[];
     /** True while the current query's sweep is in flight. */
     loading: boolean;
     /** True when `results` are recents (empty query), not search hits. */
     isRecents: boolean;
+    /** What the results are — lets the face label a browse vs recents vs hits. */
+    source: UniversalSearchSource;
+    /** Every read that failed for the current results (partial or total). */
+    failures: UniversalSearchFailure[];
+    /**
+     * Non-null only when NOTHING could be read: every searched token failed
+     * (and, for recents, the recents read found nothing or failed too).
+     */
+    error: string | null;
+    status: UniversalSearchStatus;
 }
 declare function useUniversalEntitySearch(args: UseUniversalEntitySearchArgs): UseUniversalEntitySearchReturn;
 
+interface SearchFailureNoticeProps {
+    /** `useUniversalEntitySearch().error` — set when nothing could be read. */
+    error: string | null;
+    /** `useUniversalEntitySearch().failures` — every read that failed. */
+    failures: UniversalSearchFailure[];
+    /** What the person was doing, for the error report ("Search to attach"). */
+    operation?: string;
+    /** Where this rendered, for the error report ("media/MediaSharePopover"). */
+    origin?: string;
+    className?: string;
+}
+/**
+ * "Couldn't search Notes, Tasks" / "Couldn't load recent items" — the plain
+ * sentence for a failure list. `labelFor` maps a token to its plural label.
+ */
+declare function describeSearchFailures(failures: UniversalSearchFailure[], labelFor: (token: NonNullable<UniversalSearchFailure["token"]>) => string): string;
+declare function SearchFailureNotice(props: SearchFailureNoticeProps): react.JSX.Element | null;
+
 interface UseAssociationCandidatesArgs {
     token: EntityTypeToken;
     /** Skip fetching (e.g. while the picker is closed). Defaults to true. */
@@ -295,4 +337,4 @@ interface ContentRoleMeta {
 declare const CONTENT_ROLES: ContentRoleMeta[];
 declare function getContentRoleMeta(role: ContentRole): ContentRoleMeta;
 
-export { AssociationCandidateBody, type AssociationCandidateBodyProps, AssociationPicker, type AssociationPickerBridge, type AssociationPickerBridgeOptions, AssociationPickerProps, AssociationsProvider, type AssociationsProviderProps, type AssociationsUiPorts, CONTENT_ROLES, CandidateRecord, type CategoryCreateResult, CategoryMutationResult, type ContentRoleMeta, DefaultWindowShell, type DefaultWindowShellProps, DoorControlsSlot, DoorRef, type EntityTitleRef, type PickerBridgeItem, UniversalCandidate, UnresolvedRef, type UseAssociationCandidatesArgs, type UseAssociationCandidatesReturn, type UseCategoriesArgs, type UseCategoriesReturn, type UseCommentsArgs, type UseCommentsReturn, type UseEntityTitlesReturn, type UseUniversalEntitySearchArgs, type UseUniversalEntitySearchReturn, type WindowShellComponentProps, getContentRoleMeta, lazyPickerOverride, lazyWindowShell, useAssociationCandidates, useAssociationPickerBridge, useAssociationsStore, useAssociationsUiPorts, useCategories, useComments, useEntityTitles, useNotifier, useUniversalEntitySearch };
+export { AssociationCandidateBody, type AssociationCandidateBodyProps, AssociationPicker, type AssociationPickerBridge, type AssociationPickerBridgeOptions, AssociationPickerProps, AssociationsProvider, type AssociationsProviderProps, type AssociationsUiPorts, CONTENT_ROLES, CandidateRecord, type CategoryCreateResult, CategoryMutationResult, type ContentRoleMeta, DefaultWindowShell, type DefaultWindowShellProps, DoorControlsSlot, DoorRef, type EntityTitleRef, type PickerBridgeItem, SearchFailureNotice, type SearchFailureNoticeProps, UniversalCandidate, type UniversalSearchFailure, type UniversalSearchSource, type UniversalSearchStatus, UnresolvedRef, type UseAssociationCandidatesArgs, type UseAssociationCandidatesReturn, type UseCategoriesArgs, type UseCategoriesReturn, type UseCommentsArgs, type UseCommentsReturn, type UseEntityTitlesReturn, type UseUniversalEntitySearchArgs, type UseUniversalEntitySearchReturn, type WindowShellComponentProps, describeSearchFailures, getContentRoleMeta, lazyPickerOverride, lazyWindowShell, useAssociationCandidates, useAssociationPickerBridge, useAssociationsStore, useAssociationsUiPorts, useCategories, useComments, useEntityTitles, useNotifier, useUniversalEntitySearch };