@ai-matrx/associations 0.10.7 → 0.11.0

package/dist/index.d.cts

@@ -2,6 +2,18 @@ import { ElementType, ComponentType, ReactNode } from 'react';
 
 declare const ASSOCIATION_TARGET_TYPES: readonly ["organization", "scope", "scope_type", "project", "task", "context_item", "thread", "war_room", "category", "conversation", "fc_set", "fc_card", "study_media", "assessment", "note", "file", "quiz_session", "agent", "agent_term_list", "research_tag", "skill", "surface", "plan_entity", "plan_node", "web_site", "seo_topic", "seo_keyword", "web_page", "web_screenshot", "party", "crm_outreach_list", "crm_deal", "rulebook"];
 type AssociationTargetType = (typeof ASSOCIATION_TARGET_TYPES)[number];
+/** Runtime guard: is this token one of the deliberate container (target) types? */
+declare function isAssociationTargetType(value: unknown): value is AssociationTargetType;
+/**
+ * Which edges a primary entity's association surfaces read and write.
+ *  - `incoming` (default) — the primary is a CONTAINER: it lists what is
+ *    attached INTO it (`resource → primary`) and "+" attaches resources to it.
+ *  - `outgoing` — the primary is FILED UNDER things (a Source under a project,
+ *    a research topic, a Library): it lists its own `primary → container`
+ *    edges and "+" files it under a container. Only container (target) types
+ *    can be filed under.
+ */
+type AssociationDirection = "incoming" | "outgoing";
 interface AssociationEdge {
     id: string;
     direction: "outgoing" | "incoming";
@@ -16767,6 +16779,11 @@ interface AssociationPickerProps {
         ok: boolean;
         error?: string;
     }>;
+    /**
+     * Filed-under mode: the primary is being FILED UNDER the picked items
+     * (`primary → item`), so the header says "File … under" not "Attach to".
+     */
+    filing?: boolean;
 }
 /** Per-token picker override map — absent tokens use the generic picker sheet. */
 type PickerOverrideMap = Partial<Record<EntityTypeToken, ComponentType<AssociationPickerProps>>>;
@@ -16848,4 +16865,4 @@ interface AssociationsConfig {
     authorDisplay?: AuthorDisplayPort;
 }
 
-export { ASSOCIATION_TARGET_TYPES, type AssociationEdge, type AssociationPickerProps, type AssociationSourceEdge, type AssociationTargetEdge, type AssociationTargetType, type AssociationsConfig, type AssociationsDataSource, type AssociationsEntry, type AssociationsIdentity, type AssociationsNotifier, type AssociationsRpcError, type AssociationsRpcErrorCode, type AssociationsRpcResult, type AuthorDisplayInput, type AuthorDisplayPort, type CapturePickOpts, type CapturePort, type CaptureUploadOpts, type CaptureUploadResult, type CategoriesEntry, type CategoryDimension, type CommentAuthor, type CommentsEntry, type ComponentEntityToken, DEMANDED_RPC_NAMES, type DemandedRpcArgs, type DemandedRpcName, type DemandedRpcReturns, type DemandedRpcSignatures, ENTITY_TYPE_METADATA, ENTITY_TYPE_TOKENS, type EntityDoorProps, type EntityDoorsPort, type EntityOverlayEntry, type EntityOverlayMap, type EntityRefProps, type EntityTypeMeta, type EntityTypeToken, type ErrorSink, type ListedEntityToken, type ModuleEntityToken, type PgError, type PickerOverrideMap, type PlatformCategory, type PlatformComment, REFERENCE_CATEGORY_DISPLAY, type ReferencePickableEntityToken, SCHEMA_DISPLAY, type ScopeableEntityToken, type UserEntityState, type UserStateKind, type WindowShellPort, isAssociationsRpcErr, isEntityTypeToken };
+export { ASSOCIATION_TARGET_TYPES, type AssociationDirection, type AssociationEdge, type AssociationPickerProps, type AssociationSourceEdge, type AssociationTargetEdge, type AssociationTargetType, type AssociationsConfig, type AssociationsDataSource, type AssociationsEntry, type AssociationsIdentity, type AssociationsNotifier, type AssociationsRpcError, type AssociationsRpcErrorCode, type AssociationsRpcResult, type AuthorDisplayInput, type AuthorDisplayPort, type CapturePickOpts, type CapturePort, type CaptureUploadOpts, type CaptureUploadResult, type CategoriesEntry, type CategoryDimension, type CommentAuthor, type CommentsEntry, type ComponentEntityToken, DEMANDED_RPC_NAMES, type DemandedRpcArgs, type DemandedRpcName, type DemandedRpcReturns, type DemandedRpcSignatures, ENTITY_TYPE_METADATA, ENTITY_TYPE_TOKENS, type EntityDoorProps, type EntityDoorsPort, type EntityOverlayEntry, type EntityOverlayMap, type EntityRefProps, type EntityTypeMeta, type EntityTypeToken, type ErrorSink, type ListedEntityToken, type ModuleEntityToken, type PgError, type PickerOverrideMap, type PlatformCategory, type PlatformComment, REFERENCE_CATEGORY_DISPLAY, type ReferencePickableEntityToken, SCHEMA_DISPLAY, type ScopeableEntityToken, type UserEntityState, type UserStateKind, type WindowShellPort, isAssociationTargetType, isAssociationsRpcErr, isEntityTypeToken };

package/dist/index.d.ts

@@ -2,6 +2,18 @@ import { ElementType, ComponentType, ReactNode } from 'react';
 
 declare const ASSOCIATION_TARGET_TYPES: readonly ["organization", "scope", "scope_type", "project", "task", "context_item", "thread", "war_room", "category", "conversation", "fc_set", "fc_card", "study_media", "assessment", "note", "file", "quiz_session", "agent", "agent_term_list", "research_tag", "skill", "surface", "plan_entity", "plan_node", "web_site", "seo_topic", "seo_keyword", "web_page", "web_screenshot", "party", "crm_outreach_list", "crm_deal", "rulebook"];
 type AssociationTargetType = (typeof ASSOCIATION_TARGET_TYPES)[number];
+/** Runtime guard: is this token one of the deliberate container (target) types? */
+declare function isAssociationTargetType(value: unknown): value is AssociationTargetType;
+/**
+ * Which edges a primary entity's association surfaces read and write.
+ *  - `incoming` (default) — the primary is a CONTAINER: it lists what is
+ *    attached INTO it (`resource → primary`) and "+" attaches resources to it.
+ *  - `outgoing` — the primary is FILED UNDER things (a Source under a project,
+ *    a research topic, a Library): it lists its own `primary → container`
+ *    edges and "+" files it under a container. Only container (target) types
+ *    can be filed under.
+ */
+type AssociationDirection = "incoming" | "outgoing";
 interface AssociationEdge {
     id: string;
     direction: "outgoing" | "incoming";
@@ -16767,6 +16779,11 @@ interface AssociationPickerProps {
         ok: boolean;
         error?: string;
     }>;
+    /**
+     * Filed-under mode: the primary is being FILED UNDER the picked items
+     * (`primary → item`), so the header says "File … under" not "Attach to".
+     */
+    filing?: boolean;
 }
 /** Per-token picker override map — absent tokens use the generic picker sheet. */
 type PickerOverrideMap = Partial<Record<EntityTypeToken, ComponentType<AssociationPickerProps>>>;
@@ -16848,4 +16865,4 @@ interface AssociationsConfig {
     authorDisplay?: AuthorDisplayPort;
 }
 
-export { ASSOCIATION_TARGET_TYPES, type AssociationEdge, type AssociationPickerProps, type AssociationSourceEdge, type AssociationTargetEdge, type AssociationTargetType, type AssociationsConfig, type AssociationsDataSource, type AssociationsEntry, type AssociationsIdentity, type AssociationsNotifier, type AssociationsRpcError, type AssociationsRpcErrorCode, type AssociationsRpcResult, type AuthorDisplayInput, type AuthorDisplayPort, type CapturePickOpts, type CapturePort, type CaptureUploadOpts, type CaptureUploadResult, type CategoriesEntry, type CategoryDimension, type CommentAuthor, type CommentsEntry, type ComponentEntityToken, DEMANDED_RPC_NAMES, type DemandedRpcArgs, type DemandedRpcName, type DemandedRpcReturns, type DemandedRpcSignatures, ENTITY_TYPE_METADATA, ENTITY_TYPE_TOKENS, type EntityDoorProps, type EntityDoorsPort, type EntityOverlayEntry, type EntityOverlayMap, type EntityRefProps, type EntityTypeMeta, type EntityTypeToken, type ErrorSink, type ListedEntityToken, type ModuleEntityToken, type PgError, type PickerOverrideMap, type PlatformCategory, type PlatformComment, REFERENCE_CATEGORY_DISPLAY, type ReferencePickableEntityToken, SCHEMA_DISPLAY, type ScopeableEntityToken, type UserEntityState, type UserStateKind, type WindowShellPort, isAssociationsRpcErr, isEntityTypeToken };
+export { ASSOCIATION_TARGET_TYPES, type AssociationDirection, type AssociationEdge, type AssociationPickerProps, type AssociationSourceEdge, type AssociationTargetEdge, type AssociationTargetType, type AssociationsConfig, type AssociationsDataSource, type AssociationsEntry, type AssociationsIdentity, type AssociationsNotifier, type AssociationsRpcError, type AssociationsRpcErrorCode, type AssociationsRpcResult, type AuthorDisplayInput, type AuthorDisplayPort, type CapturePickOpts, type CapturePort, type CaptureUploadOpts, type CaptureUploadResult, type CategoriesEntry, type CategoryDimension, type CommentAuthor, type CommentsEntry, type ComponentEntityToken, DEMANDED_RPC_NAMES, type DemandedRpcArgs, type DemandedRpcName, type DemandedRpcReturns, type DemandedRpcSignatures, ENTITY_TYPE_METADATA, ENTITY_TYPE_TOKENS, type EntityDoorProps, type EntityDoorsPort, type EntityOverlayEntry, type EntityOverlayMap, type EntityRefProps, type EntityTypeMeta, type EntityTypeToken, type ErrorSink, type ListedEntityToken, type ModuleEntityToken, type PgError, type PickerOverrideMap, type PlatformCategory, type PlatformComment, REFERENCE_CATEGORY_DISPLAY, type ReferencePickableEntityToken, SCHEMA_DISPLAY, type ScopeableEntityToken, type UserEntityState, type UserStateKind, type WindowShellPort, isAssociationTargetType, isAssociationsRpcErr, isEntityTypeToken };

package/dist/index.js

@@ -2107,6 +2107,9 @@ var ASSOCIATION_TARGET_TYPES = [
   "rulebook"
   //             a Masterwork Rulebook — its Scout interviews attach here (conversation→rulebook, role 'interview')
 ];
+function isAssociationTargetType(value) {
+  return typeof value === "string" && ASSOCIATION_TARGET_TYPES.includes(value);
+}
 
 // src/results.ts
 function isAssociationsRpcErr(r) {
@@ -2152,6 +2155,7 @@ export {
   ENTITY_TYPE_TOKENS,
   REFERENCE_CATEGORY_DISPLAY,
   SCHEMA_DISPLAY,
+  isAssociationTargetType,
   isAssociationsRpcErr,
   isEntityTypeToken
 };