@ai-matrx/associations 0.12.1 → 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-C78e8433.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-C78e8433.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,8 +97,6 @@ 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;
     /**
@@ -115,6 +113,15 @@ interface UseUniversalEntitySearchArgs {
  * 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. */
@@ -123,9 +130,35 @@ interface UseUniversalEntitySearchReturn {
     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. */
@@ -304,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, type UniversalSearchSource, 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-C78e8433.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-C78e8433.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,8 +97,6 @@ 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;
     /**
@@ -115,6 +113,15 @@ interface UseUniversalEntitySearchArgs {
  * 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. */
@@ -123,9 +130,35 @@ interface UseUniversalEntitySearchReturn {
     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. */
@@ -304,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, type UniversalSearchSource, 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 };