@happyvertical/smrt-messages 0.43.9 → 0.44.0

package/dist/smrt-knowledge.json

@@ -3,12 +3,12 @@
   "sensitiveFieldsExcluded": true,
   "generatedAt": "1970-01-01T00:00:00.000Z",
   "packageName": "@happyvertical/smrt-messages",
-  "packageVersion": "0.43.9",
+  "packageVersion": "0.44.0",
   "sourceManifestPath": "dist/manifest.json",
   "agentDocPath": "AGENTS.md",
   "sourceHashes": {
-    "manifest": "fb46170bf0043ec7cbfdaf8adeb4b8f34f23bd42b454fbc27e1d96a5b7dce5b2",
-    "packageJson": "076af39a97467d0ddb19c7a020e95b50dda1a327ea5bf0047e2ceb4e738527f7",
+    "manifest": "4ab861dffd9f6734d3c9210e0dd7bbd675ca01d6495e149ea41e03bff850fbeb",
+    "packageJson": "a87a71171d66e1f7dfd86143d3b0c94ac3eecd1e210fc08ddc6cbcbe239dcafe",
     "agents": "712dcc2f244d01db8b49d764b8c076e94cb9274fa4b458d7c902434a0473f127"
   },
   "exports": [
@@ -1307,6 +1307,7 @@
       "methods": [
         "_setLoadedRelationship",
         "activate",
+        "claimRevision",
         "classifyConstraintError",
         "clearEmbeddings",
         "createSender",
@@ -1355,7 +1356,8 @@
         "toJSON",
         "toPlainObject",
         "toPublicJSON",
-        "withDatabase"
+        "withDatabase",
+        "withTransaction"
       ],
       "methodSignatures": [
         {
@@ -1371,6 +1373,14 @@
           "async": true,
           "returns": "Promise<void>"
         },
+        {
+          "name": "claimRevision",
+          "async": true,
+          "params": [
+            "expectedUpdatedAt: Date | string"
+          ],
+          "returns": "Promise"
+        },
         {
           "name": "classifyConstraintError",
           "static": true,
@@ -1625,6 +1635,9 @@
         {
           "name": "save",
           "async": true,
+          "params": [
+            "options?: SmrtSaveOptions"
+          ],
           "returns": "any"
         },
         {
@@ -1681,6 +1694,14 @@
             "operation: Function"
           ],
           "returns": "Promise<T>"
+        },
+        {
+          "name": "withTransaction",
+          "async": true,
+          "params": [
+            "operation: Function"
+          ],
+          "returns": "Promise<T>"
         }
       ],
       "tenant": {
@@ -2425,6 +2446,7 @@
       ],
       "methods": [
         "_setLoadedRelationship",
+        "claimRevision",
         "classifyConstraintError",
         "clearEmbeddings",
         "createForward",
@@ -2493,7 +2515,8 @@
         "toPlainObject",
         "toPublicJSON",
         "toggleFlagged",
-        "withDatabase"
+        "withDatabase",
+        "withTransaction"
       ],
       "methodSignatures": [
         {
@@ -2504,6 +2527,14 @@
           ],
           "returns": "void"
         },
+        {
+          "name": "claimRevision",
+          "async": true,
+          "params": [
+            "expectedUpdatedAt: Date | string"
+          ],
+          "returns": "Promise"
+        },
         {
           "name": "classifyConstraintError",
           "static": true,
@@ -2837,6 +2868,9 @@
         {
           "name": "save",
           "async": true,
+          "params": [
+            "options?: SmrtSaveOptions"
+          ],
           "returns": "any"
         },
         {
@@ -2918,6 +2952,14 @@
             "operation: Function"
           ],
           "returns": "Promise<T>"
+        },
+        {
+          "name": "withTransaction",
+          "async": true,
+          "params": [
+            "operation: Function"
+          ],
+          "returns": "Promise<T>"
         }
       ],
       "tableStrategy": "sti",
@@ -3106,6 +3148,7 @@
       "methods": [
         "_setLoadedRelationship",
         "activate",
+        "claimRevision",
         "classifyConstraintError",
         "clearEmbeddings",
         "createClient",
@@ -3161,7 +3204,8 @@
         "toJSON",
         "toPlainObject",
         "toPublicJSON",
-        "withDatabase"
+        "withDatabase",
+        "withTransaction"
       ],
       "methodSignatures": [
         {
@@ -3177,6 +3221,14 @@
           "async": true,
           "returns": "Promise<void>"
         },
+        {
+          "name": "claimRevision",
+          "async": true,
+          "params": [
+            "expectedUpdatedAt: Date | string"
+          ],
+          "returns": "Promise"
+        },
         {
           "name": "classifyConstraintError",
           "static": true,
@@ -3459,6 +3511,9 @@
         {
           "name": "save",
           "async": true,
+          "params": [
+            "options?: SmrtSaveOptions"
+          ],
           "returns": "any"
         },
         {
@@ -3531,6 +3586,14 @@
             "operation: Function"
           ],
           "returns": "Promise<T>"
+        },
+        {
+          "name": "withTransaction",
+          "async": true,
+          "params": [
+            "operation: Function"
+          ],
+          "returns": "Promise<T>"
         }
       ],
       "tableStrategy": "sti",
@@ -4093,6 +4156,7 @@
       ],
       "methods": [
         "_setLoadedRelationship",
+        "claimRevision",
         "classifyConstraintError",
         "clearEmbeddings",
         "createForward",
@@ -4150,7 +4214,8 @@
         "toPlainObject",
         "toPublicJSON",
         "toggleFlagged",
-        "withDatabase"
+        "withDatabase",
+        "withTransaction"
       ],
       "methodSignatures": [
         {
@@ -4161,6 +4226,14 @@
           ],
           "returns": "void"
         },
+        {
+          "name": "claimRevision",
+          "async": true,
+          "params": [
+            "expectedUpdatedAt: Date | string"
+          ],
+          "returns": "Promise"
+        },
         {
           "name": "classifyConstraintError",
           "static": true,
@@ -4460,6 +4533,9 @@
         {
           "name": "save",
           "async": true,
+          "params": [
+            "options?: SmrtSaveOptions"
+          ],
           "returns": "any"
         },
         {
@@ -4520,6 +4596,14 @@
             "operation: Function"
           ],
           "returns": "Promise<T>"
+        },
+        {
+          "name": "withTransaction",
+          "async": true,
+          "params": [
+            "operation: Function"
+          ],
+          "returns": "Promise<T>"
         }
       ],
       "tenant": {
@@ -5004,6 +5088,7 @@
       "methods": [
         "_setLoadedRelationship",
         "activate",
+        "claimRevision",
         "classifyConstraintError",
         "clearEmbeddings",
         "createSender",
@@ -5052,7 +5137,8 @@
         "toJSON",
         "toPlainObject",
         "toPublicJSON",
-        "withDatabase"
+        "withDatabase",
+        "withTransaction"
       ],
       "methodSignatures": [
         {
@@ -5068,6 +5154,14 @@
           "async": true,
           "returns": "Promise<void>"
         },
+        {
+          "name": "claimRevision",
+          "async": true,
+          "params": [
+            "expectedUpdatedAt: Date | string"
+          ],
+          "returns": "Promise"
+        },
         {
           "name": "classifyConstraintError",
           "static": true,
@@ -5322,6 +5416,9 @@
         {
           "name": "save",
           "async": true,
+          "params": [
+            "options?: SmrtSaveOptions"
+          ],
           "returns": "any"
         },
         {
@@ -5378,6 +5475,14 @@
             "operation: Function"
           ],
           "returns": "Promise<T>"
+        },
+        {
+          "name": "withTransaction",
+          "async": true,
+          "params": [
+            "operation: Function"
+          ],
+          "returns": "Promise<T>"
         }
       ],
       "tableStrategy": "sti",
@@ -5698,6 +5803,7 @@
       ],
       "methods": [
         "_setLoadedRelationship",
+        "claimRevision",
         "classifyConstraintError",
         "clearEmbeddings",
         "createForward",
@@ -5759,7 +5865,8 @@
         "toPlainObject",
         "toPublicJSON",
         "toggleFlagged",
-        "withDatabase"
+        "withDatabase",
+        "withTransaction"
       ],
       "methodSignatures": [
         {
@@ -5770,6 +5877,14 @@
           ],
           "returns": "void"
         },
+        {
+          "name": "claimRevision",
+          "async": true,
+          "params": [
+            "expectedUpdatedAt: Date | string"
+          ],
+          "returns": "Promise"
+        },
         {
           "name": "classifyConstraintError",
           "static": true,
@@ -6085,6 +6200,9 @@
         {
           "name": "save",
           "async": true,
+          "params": [
+            "options?: SmrtSaveOptions"
+          ],
           "returns": "any"
         },
         {
@@ -6145,6 +6263,14 @@
             "operation: Function"
           ],
           "returns": "Promise<T>"
+        },
+        {
+          "name": "withTransaction",
+          "async": true,
+          "params": [
+            "operation: Function"
+          ],
+          "returns": "Promise<T>"
         }
       ],
       "tableStrategy": "sti",
@@ -6304,6 +6430,7 @@
       "methods": [
         "_setLoadedRelationship",
         "activate",
+        "claimRevision",
         "classifyConstraintError",
         "clearEmbeddings",
         "createSender",
@@ -6352,7 +6479,8 @@
         "toJSON",
         "toPlainObject",
         "toPublicJSON",
-        "withDatabase"
+        "withDatabase",
+        "withTransaction"
       ],
       "methodSignatures": [
         {
@@ -6368,6 +6496,14 @@
           "async": true,
           "returns": "Promise<void>"
         },
+        {
+          "name": "claimRevision",
+          "async": true,
+          "params": [
+            "expectedUpdatedAt: Date | string"
+          ],
+          "returns": "Promise"
+        },
         {
           "name": "classifyConstraintError",
           "static": true,
@@ -6622,6 +6758,9 @@
         {
           "name": "save",
           "async": true,
+          "params": [
+            "options?: SmrtSaveOptions"
+          ],
           "returns": "any"
         },
         {
@@ -6678,6 +6817,14 @@
             "operation: Function"
           ],
           "returns": "Promise<T>"
+        },
+        {
+          "name": "withTransaction",
+          "async": true,
+          "params": [
+            "operation: Function"
+          ],
+          "returns": "Promise<T>"
         }
       ],
       "tableStrategy": "sti",
@@ -7008,6 +7155,7 @@
       ],
       "methods": [
         "_setLoadedRelationship",
+        "claimRevision",
         "classifyConstraintError",
         "clearEmbeddings",
         "createForward",
@@ -7069,7 +7217,8 @@
         "toPlainObject",
         "toPublicJSON",
         "toggleFlagged",
-        "withDatabase"
+        "withDatabase",
+        "withTransaction"
       ],
       "methodSignatures": [
         {
@@ -7080,6 +7229,14 @@
           ],
           "returns": "void"
         },
+        {
+          "name": "claimRevision",
+          "async": true,
+          "params": [
+            "expectedUpdatedAt: Date | string"
+          ],
+          "returns": "Promise"
+        },
         {
           "name": "classifyConstraintError",
           "static": true,
@@ -7395,6 +7552,9 @@
         {
           "name": "save",
           "async": true,
+          "params": [
+            "options?: SmrtSaveOptions"
+          ],
           "returns": "any"
         },
         {
@@ -7455,6 +7615,14 @@
             "operation: Function"
           ],
           "returns": "Promise<T>"
+        },
+        {
+          "name": "withTransaction",
+          "async": true,
+          "params": [
+            "operation: Function"
+          ],
+          "returns": "Promise<T>"
         }
       ],
       "tableStrategy": "sti",
@@ -7626,6 +7794,7 @@
       "methods": [
         "_setLoadedRelationship",
         "activate",
+        "claimRevision",
         "classifyConstraintError",
         "clearEmbeddings",
         "createSender",
@@ -7674,7 +7843,8 @@
         "toJSON",
         "toPlainObject",
         "toPublicJSON",
-        "withDatabase"
+        "withDatabase",
+        "withTransaction"
       ],
       "methodSignatures": [
         {
@@ -7690,6 +7860,14 @@
           "async": true,
           "returns": "Promise<void>"
         },
+        {
+          "name": "claimRevision",
+          "async": true,
+          "params": [
+            "expectedUpdatedAt: Date | string"
+          ],
+          "returns": "Promise"
+        },
         {
           "name": "classifyConstraintError",
           "static": true,
@@ -7944,6 +8122,9 @@
         {
           "name": "save",
           "async": true,
+          "params": [
+            "options?: SmrtSaveOptions"
+          ],
           "returns": "any"
         },
         {
@@ -8000,6 +8181,14 @@
             "operation: Function"
           ],
           "returns": "Promise<T>"
+        },
+        {
+          "name": "withTransaction",
+          "async": true,
+          "params": [
+            "operation: Function"
+          ],
+          "returns": "Promise<T>"
         }
       ],
       "tableStrategy": "sti",
@@ -8274,6 +8463,7 @@
       "methods": [
         "_setLoadedRelationship",
         "activate",
+        "claimRevision",
         "classifyConstraintError",
         "clearEmbeddings",
         "createSender",
@@ -8322,7 +8512,8 @@
         "toJSON",
         "toPlainObject",
         "toPublicJSON",
-        "withDatabase"
+        "withDatabase",
+        "withTransaction"
       ],
       "methodSignatures": [
         {
@@ -8338,6 +8529,14 @@
           "async": true,
           "returns": "Promise<void>"
         },
+        {
+          "name": "claimRevision",
+          "async": true,
+          "params": [
+            "expectedUpdatedAt: Date | string"
+          ],
+          "returns": "Promise"
+        },
         {
           "name": "classifyConstraintError",
           "static": true,
@@ -8592,6 +8791,9 @@
         {
           "name": "save",
           "async": true,
+          "params": [
+            "options?: SmrtSaveOptions"
+          ],
           "returns": "any"
         },
         {
@@ -8648,6 +8850,14 @@
             "operation: Function"
           ],
           "returns": "Promise<T>"
+        },
+        {
+          "name": "withTransaction",
+          "async": true,
+          "params": [
+            "operation: Function"
+          ],
+          "returns": "Promise<T>"
         }
       ],
       "tableStrategy": "sti",

package/dist/svelte/components/AccountAvatar.svelte

@@ -4,8 +4,11 @@
  */
 
 export interface Props {
+  /** Email provider type such as Gmail, IMAP, or Slack. */
   providerType: string;
+  /** Account or user name, displayed as title and used to generate initials. */
   name: string;
+  /** Visual size of the avatar: small, medium, or large. */
   size?: 'sm' | 'md' | 'lg';
 }
 

package/dist/svelte/components/AccountAvatar.svelte.d.ts

@@ -2,8 +2,11 @@
  * AccountAvatar - Provider icon with fallback initials
  */
 export interface Props {
+    /** Email provider type such as Gmail, IMAP, or Slack. */
     providerType: string;
+    /** Account or user name, displayed as title and used to generate initials. */
     name: string;
+    /** Visual size of the avatar: small, medium, or large. */
     size?: 'sm' | 'md' | 'lg';
 }
 declare const AccountAvatar: import("svelte").Component<Props, {}, "">;

package/dist/svelte/components/AccountAvatar.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AccountAvatar.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/components/AccountAvatar.svelte.ts"],"names":[],"mappings":"AAGA;;GAEG;AAEH,MAAM,WAAW,KAAK;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;CAC3B;AA2CD,QAAA,MAAM,aAAa,2CAAwC,CAAC;AAC5D,KAAK,aAAa,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AACtD,eAAe,aAAa,CAAC"}
+{"version":3,"file":"AccountAvatar.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/components/AccountAvatar.svelte.ts"],"names":[],"mappings":"AAGA;;GAEG;AAEH,MAAM,WAAW,KAAK;IACpB,yDAAyD;IACzD,YAAY,EAAE,MAAM,CAAC;IACrB,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;CAC3B;AA2CD,QAAA,MAAM,aAAa,2CAAwC,CAAC;AAC5D,KAAK,aAAa,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AACtD,eAAe,aAAa,CAAC"}

package/dist/svelte/components/AccountCard.svelte

@@ -7,10 +7,15 @@ import type { AccountData } from '../types.js';
 import AccountAvatar from './AccountAvatar.svelte';
 
 export interface Props {
+  /** Account data to display with its status and sync history. */
   account: AccountData;
+  /** Called when user clicks the sync button to refresh the account. */
   onsync?: (account: AccountData) => void;
+  /** Called when user clicks the activate button to enable the account. */
   onactivate?: (account: AccountData) => void;
+  /** Called when user clicks the deactivate button to disable the account. */
   ondeactivate?: (account: AccountData) => void;
+  /** Called when user clicks the remove button to delete the account. */
   onremove?: (account: AccountData) => void;
 }
 

package/dist/svelte/components/AccountCard.svelte.d.ts

@@ -1,9 +1,14 @@
 import type { AccountData } from '../types.js';
 export interface Props {
+    /** Account data to display with its status and sync history. */
     account: AccountData;
+    /** Called when user clicks the sync button to refresh the account. */
     onsync?: (account: AccountData) => void;
+    /** Called when user clicks the activate button to enable the account. */
     onactivate?: (account: AccountData) => void;
+    /** Called when user clicks the deactivate button to disable the account. */
     ondeactivate?: (account: AccountData) => void;
+    /** Called when user clicks the remove button to delete the account. */
     onremove?: (account: AccountData) => void;
 }
 declare const AccountCard: import("svelte").Component<Props, {}, "">;

package/dist/svelte/components/AccountCard.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AccountCard.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/components/AccountCard.svelte.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI/C,MAAM,WAAW,KAAK;IACpB,OAAO,EAAE,WAAW,CAAC;IACrB,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;IACxC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;IAC5C,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;IAC9C,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;CAC3C;AAwED,QAAA,MAAM,WAAW,2CAAwC,CAAC;AAC1D,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;AAClD,eAAe,WAAW,CAAC"}
+{"version":3,"file":"AccountCard.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/components/AccountCard.svelte.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI/C,MAAM,WAAW,KAAK;IACpB,gEAAgE;IAChE,OAAO,EAAE,WAAW,CAAC;IACrB,sEAAsE;IACtE,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;IACxC,yEAAyE;IACzE,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;IAC5C,4EAA4E;IAC5E,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;IAC9C,uEAAuE;IACvE,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;CAC3C;AAwED,QAAA,MAAM,WAAW,2CAAwC,CAAC;AAC1D,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;AAClD,eAAe,WAAW,CAAC"}

package/dist/svelte/components/AccountList.svelte

@@ -11,10 +11,15 @@ import AccountCard from './AccountCard.svelte';
 const { t } = useI18n();
 
 export interface Props {
+  /** Array of accounts to display in the list. */
   accounts: AccountData[];
+  /** Shows a loading indicator while accounts are being fetched. */
   loading?: boolean;
+  /** Called when user clicks on an account card to view details. */
   onaccountclick?: (account: AccountData) => void;
+  /** Called when user requests to sync an account. */
   onsync?: (account: AccountData) => void;
+  /** Called when user requests to remove an account. */
   onremove?: (account: AccountData) => void;
 }
 

package/dist/svelte/components/AccountList.svelte.d.ts

@@ -1,9 +1,14 @@
 import type { AccountData } from '../types.js';
 export interface Props {
+    /** Array of accounts to display in the list. */
     accounts: AccountData[];
+    /** Shows a loading indicator while accounts are being fetched. */
     loading?: boolean;
+    /** Called when user clicks on an account card to view details. */
     onaccountclick?: (account: AccountData) => void;
+    /** Called when user requests to sync an account. */
     onsync?: (account: AccountData) => void;
+    /** Called when user requests to remove an account. */
     onremove?: (account: AccountData) => void;
 }
 declare const AccountList: import("svelte").Component<Props, {}, "">;

package/dist/svelte/components/AccountList.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AccountList.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/components/AccountList.svelte.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI/C,MAAM,WAAW,KAAK;IACpB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;IAChD,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;IACxC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;CAC3C;AA6ED,QAAA,MAAM,WAAW,2CAAwC,CAAC;AAC1D,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;AAClD,eAAe,WAAW,CAAC"}
+{"version":3,"file":"AccountList.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/components/AccountList.svelte.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI/C,MAAM,WAAW,KAAK;IACpB,gDAAgD;IAChD,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,kEAAkE;IAClE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kEAAkE;IAClE,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;IAChD,oDAAoD;IACpD,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;IACxC,sDAAsD;IACtD,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;CAC3C;AA6ED,QAAA,MAAM,WAAW,2CAAwC,CAAC;AAC1D,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;AAClD,eAAe,WAAW,CAAC"}

package/dist/svelte/components/AttachmentChip.svelte

@@ -6,7 +6,9 @@ import { Button } from '@happyvertical/smrt-ui/ui';
 import type { AttachmentData } from '../types.js';
 
 export interface Props {
+  /** File attachment to display with icon, name, and size. */
   attachment: AttachmentData;
+  /** Called when user clicks on the attachment chip. */
   onclick?: (attachment: AttachmentData) => void;
 }