@ai-matrx/associations 0.13.22 → 0.13.25

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,8 +1,35 @@
1
1
  # Changelog — @ai-matrx/associations
2
2
 
3
+ ## 0.13.25
4
+
5
+ Automatic changed-only republish (docs/metadata drift since the last tag — see
6
+ `git diff npm/associations/v0.13.23..npm/associations/v0.13.25 -- apps/shared/associations`).
7
+ No source changes intended and no consumer action required.
8
+
9
+ ## 0.13.24
10
+
11
+ Automatic changed-only republish (docs/metadata drift since the last tag — see
12
+ `git diff npm/associations/v0.13.23..npm/associations/v0.13.24 -- apps/shared/associations`).
13
+ No source changes intended and no consumer action required.
14
+
15
+ ## 0.13.23
16
+
17
+ Automatic changed-only republish (docs/metadata drift since the last tag — see
18
+ `git diff npm/associations/v0.13.22..npm/associations/v0.13.23 -- apps/shared/associations`).
19
+ No source changes intended and no consumer action required.
20
+
3
21
  ## 0.13.22
4
22
  ### Unreleased
5
23
 
24
+ - **Resources grid restored to its own look (Arman, 2026-09-29).** `AssociationCardGrid` and
25
+ `AssociationCard` again draw the colored group dot, the one-line group description, the colored
26
+ top bar, the tinted icon chip, the "N attached" line and the square "+" — undoing the 2026-09-27
27
+ page-pass restyle (0b7ed5ee91, ab22ca7f10, 8ab54b828c). The 12px count line (6fb9d79138) stays.
28
+ - New opt-in `look?: "tiles" | "simplified" | "compact"` on both (default `"tiles"`, used
29
+ everywhere). `"simplified"`: one uppercase line with the classic square "+". `"compact"`: one
30
+ line with the real `PlusTapButton variant="outline"` from `@ai-matrx/tap-target` (new
31
+ dependency) — no glass, no padding around it. The CRM record uses `"compact"`.
32
+ Consumer action: none (hosts already load `@ai-matrx/tap-target/styles.css`).
6
33
  - Root now exports `isRegisteredPair(source, target)` and `registeredEdgeLabel(source, target)`
7
34
  from the generated association registry, so a host decides an edge's direction from the package
8
35
  instead of reading `platform.association_types` itself (A3-F, the Source input's file filing).
@@ -684,7 +684,7 @@ interface AssociationsConfig {
684
684
  authorDisplay?: AuthorDisplayPort;
685
685
  }
686
686
 
687
- 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", "research_topic", "media_source_library"];
687
+ 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", "processed_document", "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", "research_topic", "media_source_library"];
688
688
  type AssociationTargetType = (typeof ASSOCIATION_TARGET_TYPES)[number];
689
689
  interface AssociationEdge {
690
690
  id: string;
@@ -1696,18 +1696,33 @@ interface AssociationCardProps {
1696
1696
  token: EntityTypeToken;
1697
1697
  /** Override the page's primary entity. Defaults to PrimaryEntityProvider. */
1698
1698
  container?: PrimaryEntity;
1699
+ /**
1700
+ * "tiles" (default, everywhere): the tinted icon chip, role-colored top bar,
1701
+ * "N attached" line and square "+". Opt-in one-line looks for pages that do
1702
+ * not want the full card: "simplified" (square "+") and "compact" (the
1703
+ * outline PlusTapButton — the CRM record's look).
1704
+ */
1705
+ look?: AssociationCardLook;
1699
1706
  className?: string;
1700
1707
  }
1701
- declare function AssociationCard({ token, container: containerProp, className, }: AssociationCardProps): react.JSX.Element | null;
1708
+ type AssociationCardLook = "tiles" | "simplified" | "compact";
1709
+ declare function AssociationCard({ token, container: containerProp, look, className, }: AssociationCardProps): react.JSX.Element | null;
1702
1710
 
1703
1711
  interface AssociationCardGridProps {
1704
1712
  /** Tokens to show. Defaults to every registry-listable token. */
1705
1713
  tokens?: EntityTypeToken[];
1706
1714
  /** Registry tokens this surface cannot honestly support yet. */
1707
1715
  excludeTokens?: EntityTypeToken[];
1716
+ /**
1717
+ * "tiles" (default, everywhere): each group has a colored dot, its title and
1718
+ * a one-line description; cards sit in a 1/2/3-column grid. Opt-in
1719
+ * "simplified" / "compact": an uppercase eyebrow over wrapping one-line
1720
+ * cards (see AssociationCard for the two "+" buttons).
1721
+ */
1722
+ look?: AssociationCardLook;
1708
1723
  className?: string;
1709
1724
  }
1710
- declare function AssociationCardGrid({ tokens, excludeTokens, className, }: AssociationCardGridProps): react.JSX.Element;
1725
+ declare function AssociationCardGrid({ tokens, excludeTokens, look, className, }: AssociationCardGridProps): react.JSX.Element;
1711
1726
 
1712
1727
  /** One attached resource, as the list renders it. Tokens are CANONICAL. */
1713
1728
  interface ContainerResourceRow {
@@ -1993,4 +2008,4 @@ declare function buildCommentTree(comments: readonly PlatformComment[]): {
1993
2008
  };
1994
2009
  declare function CommentThread({ token, id, orgId, showHeader, className, }: CommentThreadProps): react.JSX.Element;
1995
2010
 
1996
- export { DefaultEntityIcon as $, type AssociationCaptureToolbarProps as A, AssociationCaptureToolbar as B, type CategorySelectProps as C, AssociationCard as D, type EntityDoorsPort as E, AssociationCardGrid as F, AssociationEntitySelect as G, type AssociationEntitySelectAdapter as H, type AssociationEntitySelectItem as I, AssociationList as J, AssociationWindow as K, type AssociationWriteResult as L, AttachedItemsSheet as M, type CaptureAttach as N, type CaptureAttachResult as O, type PickerOverrideMap as P, CaptureToolbarAction as Q, CategorySelect as R, CategoryTagPicker as S, CommentComposer as T, type UniversalAssociationPickerProps as U, type CommentComposerProps as V, type WindowShellPort as W, CommentThread as X, type ContainerLink as Y, type ContainerResourceRow as Z, type ContainerResourcesAdapter as _, type AssociationCardProps as a, type PrimaryContainerEntity as a0, type PrimaryEntity as a1, PrimaryEntityProvider as a2, type PrimaryFiledEntity as a3, type TagPickerIcon as a4, UniversalAssociationPicker as a5, type UseAssociationEntitySelectAdapterArgs as a6, type UseAssociationsArgs as a7, type UseAssociationsReturn as a8, type UseContainerLinksArgs as a9, type UseContainerLinksReturn as aa, attachedKey as ab, buildCommentTree as ac, containerLinksArgs as ad, linkDirection as ae, useAssociationEntitySelectAdapter as af, useAssociations as ag, useContainerLinks as ah, useContainerLinksAdapter as ai, useEntityRelationships as aj, usePrimaryEntity as ak, type AssociationCardGridProps as b, type AssociationEntitySelectProps as c, type AssociationListProps as d, type AssociationPickerProps as e, type AssociationWindowProps as f, type AttachedItemsSheetProps as g, type CategoryTagPickerProps as h, type CommentThreadProps as i, type AssociationsNotifier as j, type CapturePort as k, type AuthorDisplayPort as l, type AssociationsStore as m, type CategoryMutationResult as n, type CategoryDimension as o, type PlatformCategory as p, type CategoriesEntry as q, type EntityTypeToken as r, type UniversalCandidate as s, type CandidateRecord as t, type PlatformComment as u, type CommentsEntry as v, type CommentMutationResult as w, type EntityDoorProps as x, type EntityRefProps as y, type ContentRole as z };
2011
+ export { type ContainerResourcesAdapter as $, type AssociationCaptureToolbarProps as A, AssociationCaptureToolbar as B, type CategorySelectProps as C, AssociationCard as D, type EntityDoorsPort as E, AssociationCardGrid as F, type AssociationCardLook as G, AssociationEntitySelect as H, type AssociationEntitySelectAdapter as I, type AssociationEntitySelectItem as J, AssociationList as K, AssociationWindow as L, type AssociationWriteResult as M, AttachedItemsSheet as N, type CaptureAttach as O, type PickerOverrideMap as P, type CaptureAttachResult as Q, CaptureToolbarAction as R, CategorySelect as S, CategoryTagPicker as T, type UniversalAssociationPickerProps as U, CommentComposer as V, type WindowShellPort as W, type CommentComposerProps as X, CommentThread as Y, type ContainerLink as Z, type ContainerResourceRow as _, type AssociationCardProps as a, DefaultEntityIcon as a0, type PrimaryContainerEntity as a1, type PrimaryEntity as a2, PrimaryEntityProvider as a3, type PrimaryFiledEntity as a4, type TagPickerIcon as a5, UniversalAssociationPicker as a6, type UseAssociationEntitySelectAdapterArgs as a7, type UseAssociationsArgs as a8, type UseAssociationsReturn as a9, type UseContainerLinksArgs as aa, type UseContainerLinksReturn as ab, attachedKey as ac, buildCommentTree as ad, containerLinksArgs as ae, linkDirection as af, useAssociationEntitySelectAdapter as ag, useAssociations as ah, useContainerLinks as ai, useContainerLinksAdapter as aj, useEntityRelationships as ak, usePrimaryEntity as al, type AssociationCardGridProps as b, type AssociationEntitySelectProps as c, type AssociationListProps as d, type AssociationPickerProps as e, type AssociationWindowProps as f, type AttachedItemsSheetProps as g, type CategoryTagPickerProps as h, type CommentThreadProps as i, type AssociationsNotifier as j, type CapturePort as k, type AuthorDisplayPort as l, type AssociationsStore as m, type CategoryMutationResult as n, type CategoryDimension as o, type PlatformCategory as p, type CategoriesEntry as q, type EntityTypeToken as r, type UniversalCandidate as s, type CandidateRecord as t, type PlatformComment as u, type CommentsEntry as v, type CommentMutationResult as w, type EntityDoorProps as x, type EntityRefProps as y, type ContentRole as z };
@@ -684,7 +684,7 @@ interface AssociationsConfig {
684
684
  authorDisplay?: AuthorDisplayPort;
685
685
  }
686
686
 
687
- 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", "research_topic", "media_source_library"];
687
+ 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", "processed_document", "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", "research_topic", "media_source_library"];
688
688
  type AssociationTargetType = (typeof ASSOCIATION_TARGET_TYPES)[number];
689
689
  interface AssociationEdge {
690
690
  id: string;
@@ -1696,18 +1696,33 @@ interface AssociationCardProps {
1696
1696
  token: EntityTypeToken;
1697
1697
  /** Override the page's primary entity. Defaults to PrimaryEntityProvider. */
1698
1698
  container?: PrimaryEntity;
1699
+ /**
1700
+ * "tiles" (default, everywhere): the tinted icon chip, role-colored top bar,
1701
+ * "N attached" line and square "+". Opt-in one-line looks for pages that do
1702
+ * not want the full card: "simplified" (square "+") and "compact" (the
1703
+ * outline PlusTapButton — the CRM record's look).
1704
+ */
1705
+ look?: AssociationCardLook;
1699
1706
  className?: string;
1700
1707
  }
1701
- declare function AssociationCard({ token, container: containerProp, className, }: AssociationCardProps): react.JSX.Element | null;
1708
+ type AssociationCardLook = "tiles" | "simplified" | "compact";
1709
+ declare function AssociationCard({ token, container: containerProp, look, className, }: AssociationCardProps): react.JSX.Element | null;
1702
1710
 
1703
1711
  interface AssociationCardGridProps {
1704
1712
  /** Tokens to show. Defaults to every registry-listable token. */
1705
1713
  tokens?: EntityTypeToken[];
1706
1714
  /** Registry tokens this surface cannot honestly support yet. */
1707
1715
  excludeTokens?: EntityTypeToken[];
1716
+ /**
1717
+ * "tiles" (default, everywhere): each group has a colored dot, its title and
1718
+ * a one-line description; cards sit in a 1/2/3-column grid. Opt-in
1719
+ * "simplified" / "compact": an uppercase eyebrow over wrapping one-line
1720
+ * cards (see AssociationCard for the two "+" buttons).
1721
+ */
1722
+ look?: AssociationCardLook;
1708
1723
  className?: string;
1709
1724
  }
1710
- declare function AssociationCardGrid({ tokens, excludeTokens, className, }: AssociationCardGridProps): react.JSX.Element;
1725
+ declare function AssociationCardGrid({ tokens, excludeTokens, look, className, }: AssociationCardGridProps): react.JSX.Element;
1711
1726
 
1712
1727
  /** One attached resource, as the list renders it. Tokens are CANONICAL. */
1713
1728
  interface ContainerResourceRow {
@@ -1993,4 +2008,4 @@ declare function buildCommentTree(comments: readonly PlatformComment[]): {
1993
2008
  };
1994
2009
  declare function CommentThread({ token, id, orgId, showHeader, className, }: CommentThreadProps): react.JSX.Element;
1995
2010
 
1996
- export { DefaultEntityIcon as $, type AssociationCaptureToolbarProps as A, AssociationCaptureToolbar as B, type CategorySelectProps as C, AssociationCard as D, type EntityDoorsPort as E, AssociationCardGrid as F, AssociationEntitySelect as G, type AssociationEntitySelectAdapter as H, type AssociationEntitySelectItem as I, AssociationList as J, AssociationWindow as K, type AssociationWriteResult as L, AttachedItemsSheet as M, type CaptureAttach as N, type CaptureAttachResult as O, type PickerOverrideMap as P, CaptureToolbarAction as Q, CategorySelect as R, CategoryTagPicker as S, CommentComposer as T, type UniversalAssociationPickerProps as U, type CommentComposerProps as V, type WindowShellPort as W, CommentThread as X, type ContainerLink as Y, type ContainerResourceRow as Z, type ContainerResourcesAdapter as _, type AssociationCardProps as a, type PrimaryContainerEntity as a0, type PrimaryEntity as a1, PrimaryEntityProvider as a2, type PrimaryFiledEntity as a3, type TagPickerIcon as a4, UniversalAssociationPicker as a5, type UseAssociationEntitySelectAdapterArgs as a6, type UseAssociationsArgs as a7, type UseAssociationsReturn as a8, type UseContainerLinksArgs as a9, type UseContainerLinksReturn as aa, attachedKey as ab, buildCommentTree as ac, containerLinksArgs as ad, linkDirection as ae, useAssociationEntitySelectAdapter as af, useAssociations as ag, useContainerLinks as ah, useContainerLinksAdapter as ai, useEntityRelationships as aj, usePrimaryEntity as ak, type AssociationCardGridProps as b, type AssociationEntitySelectProps as c, type AssociationListProps as d, type AssociationPickerProps as e, type AssociationWindowProps as f, type AttachedItemsSheetProps as g, type CategoryTagPickerProps as h, type CommentThreadProps as i, type AssociationsNotifier as j, type CapturePort as k, type AuthorDisplayPort as l, type AssociationsStore as m, type CategoryMutationResult as n, type CategoryDimension as o, type PlatformCategory as p, type CategoriesEntry as q, type EntityTypeToken as r, type UniversalCandidate as s, type CandidateRecord as t, type PlatformComment as u, type CommentsEntry as v, type CommentMutationResult as w, type EntityDoorProps as x, type EntityRefProps as y, type ContentRole as z };
2011
+ export { type ContainerResourcesAdapter as $, type AssociationCaptureToolbarProps as A, AssociationCaptureToolbar as B, type CategorySelectProps as C, AssociationCard as D, type EntityDoorsPort as E, AssociationCardGrid as F, type AssociationCardLook as G, AssociationEntitySelect as H, type AssociationEntitySelectAdapter as I, type AssociationEntitySelectItem as J, AssociationList as K, AssociationWindow as L, type AssociationWriteResult as M, AttachedItemsSheet as N, type CaptureAttach as O, type PickerOverrideMap as P, type CaptureAttachResult as Q, CaptureToolbarAction as R, CategorySelect as S, CategoryTagPicker as T, type UniversalAssociationPickerProps as U, CommentComposer as V, type WindowShellPort as W, type CommentComposerProps as X, CommentThread as Y, type ContainerLink as Z, type ContainerResourceRow as _, type AssociationCardProps as a, DefaultEntityIcon as a0, type PrimaryContainerEntity as a1, type PrimaryEntity as a2, PrimaryEntityProvider as a3, type PrimaryFiledEntity as a4, type TagPickerIcon as a5, UniversalAssociationPicker as a6, type UseAssociationEntitySelectAdapterArgs as a7, type UseAssociationsArgs as a8, type UseAssociationsReturn as a9, type UseContainerLinksArgs as aa, type UseContainerLinksReturn as ab, attachedKey as ac, buildCommentTree as ad, containerLinksArgs as ae, linkDirection as af, useAssociationEntitySelectAdapter as ag, useAssociations as ah, useContainerLinks as ai, useContainerLinksAdapter as aj, useEntityRelationships as ak, usePrimaryEntity as al, type AssociationCardGridProps as b, type AssociationEntitySelectProps as c, type AssociationListProps as d, type AssociationPickerProps as e, type AssociationWindowProps as f, type AttachedItemsSheetProps as g, type CategoryTagPickerProps as h, type CommentThreadProps as i, type AssociationsNotifier as j, type CapturePort as k, type AuthorDisplayPort as l, type AssociationsStore as m, type CategoryMutationResult as n, type CategoryDimension as o, type PlatformCategory as p, type CategoriesEntry as q, type EntityTypeToken as r, type UniversalCandidate as s, type CandidateRecord as t, type PlatformComment as u, type CommentsEntry as v, type CommentMutationResult as w, type EntityDoorProps as x, type EntityRefProps as y, type ContentRole as z };
@@ -1,4 +1,4 @@
1
- import { E as EntityOverlayMap, a as EntityTypeToken, b as EntityOverlayEntry, c as ErrorSink, A as AssociationsRpcError, d as AssociationsDataSource, e as AssociationsIdentity, f as AssociationTargetType, g as AssociationsRpcResult, h as AssociationEdge, i as AssociationTargetEdge, j as AssociationSourceEdge, C as CategoryDimension, P as PlatformCategory, U as UserStateKind, k as UserEntityState, l as PlatformComment, m as AssociationsEntry, n as CategoriesEntry, o as CommentsEntry, p as AssociationsConfig } from '../ports-D2Im-Tjl.cjs';
1
+ import { E as EntityOverlayMap, a as EntityTypeToken, b as EntityOverlayEntry, c as ErrorSink, A as AssociationsRpcError, d as AssociationsDataSource, e as AssociationsIdentity, f as AssociationTargetType, g as AssociationsRpcResult, h as AssociationEdge, i as AssociationTargetEdge, j as AssociationSourceEdge, C as CategoryDimension, P as PlatformCategory, U as UserStateKind, k as UserEntityState, l as PlatformComment, m as AssociationsEntry, n as CategoriesEntry, o as CommentsEntry, p as AssociationsConfig } from '../ports-vvtD75Sp.cjs';
2
2
  import 'react';
3
3
 
4
4
  /** The universal ownership column post-2026-reorg. */
@@ -1,4 +1,4 @@
1
- import { E as EntityOverlayMap, a as EntityTypeToken, b as EntityOverlayEntry, c as ErrorSink, A as AssociationsRpcError, d as AssociationsDataSource, e as AssociationsIdentity, f as AssociationTargetType, g as AssociationsRpcResult, h as AssociationEdge, i as AssociationTargetEdge, j as AssociationSourceEdge, C as CategoryDimension, P as PlatformCategory, U as UserStateKind, k as UserEntityState, l as PlatformComment, m as AssociationsEntry, n as CategoriesEntry, o as CommentsEntry, p as AssociationsConfig } from '../ports-D2Im-Tjl.js';
1
+ import { E as EntityOverlayMap, a as EntityTypeToken, b as EntityOverlayEntry, c as ErrorSink, A as AssociationsRpcError, d as AssociationsDataSource, e as AssociationsIdentity, f as AssociationTargetType, g as AssociationsRpcResult, h as AssociationEdge, i as AssociationTargetEdge, j as AssociationSourceEdge, C as CategoryDimension, P as PlatformCategory, U as UserStateKind, k as UserEntityState, l as PlatformComment, m as AssociationsEntry, n as CategoriesEntry, o as CommentsEntry, p as AssociationsConfig } from '../ports-vvtD75Sp.js';
2
2
  import 'react';
3
3
 
4
4
  /** The universal ownership column post-2026-reorg. */
package/dist/index.cjs CHANGED
@@ -2196,6 +2196,8 @@ var ASSOCIATION_TARGET_TYPES = [
2196
2196
  // a note — the origin a converted study artifact links back to (artifact→note 'source' lineage, P4)
2197
2197
  "file",
2198
2198
  // a file (card→file media + source lineage)
2199
+ "processed_document",
2200
+ // a processed source document (study-aid source lineage and kit membership)
2199
2201
  "quiz_session",
2200
2202
  // a quiz a card is used in
2201
2203
  "agent",