@plannotator/ui 0.43.0 → 0.43.2

package/types.ts

@@ -83,6 +83,7 @@ export interface Annotation {
   author?: string; // Tater identity for collaborative sharing
   source?: string; // External tool identifier (e.g., "eslint") — set when annotation comes from external API
   images?: ImageAttachment[]; // Attached images with human-readable names
+  mentions?: readonly string[]; // opaque host ids named with `@` in the comment body, set ONLY when a host supplied a `mentionSource` to the composer and at least one token survived; the key is absent otherwise. Host data: the package never renders, exports, shares or archives it.
   isQuickLabel?: boolean; // true if created via quick label chip
   quickLabelTip?: string; // optional instruction tip from the label definition
   diffContext?: 'added' | 'removed' | 'modified'; // set when annotation created in plan diff view

package/utils/mentions.ts

@@ -20,6 +20,12 @@ export interface MentionPerson {
   readonly label: string;
   /** Right-aligned hint shown after the label (an email, "Agent"), or null. */
   readonly detail: string | null;
+  /**
+   * Optional avatar drawn before the label (0.43.2): an image when `url` is
+   * given, else `initials` on a tinted disc (`tint` is any CSS color; absent
+   * means the muted surface). Absent → no avatar column, the 0.43.1 row.
+   */
+  readonly avatar?: { readonly url?: string; readonly initials?: string; readonly tint?: string };
   /**
    * Whether this person can open the document. Host data: rows render
    * identically either way, and a `false` row is only special when the host
@@ -37,6 +43,8 @@ export interface MentionSource {
    * to keep the menu closed instead.
    */
   readonly emptyNotice?: string | null;
+  /** Optional heading drawn above the list ("People in this workspace"). Absent → no heading row. */
+  readonly heading?: string | null;
   /** Fires on every text change with the ids whose token still survives in the body. */
   readonly onMentionsChange?: (ids: readonly string[]) => void;
   /**