@nucleux/attachment-tile 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nucleux
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,26 @@
+# @nucleux/attachment-tile
+
+AttachmentTile — removable file and image context tiles for the composer — Nucleux agentic UI for React.
+
+Part of **[Nucleux](https://github.com/intelligaia-open-labs/nucleux)** — agentic UI components for React. Install a single component, or the full kit via [`@nucleux/react`](https://www.npmjs.com/package/@nucleux/react).
+
+## Install
+
+```bash
+pnpm add @nucleux/attachment-tile @nucleux/tokens
+```
+
+`react` / `react-dom` are peer dependencies.
+
+## Usage
+
+```tsx
+import { AttachmentTile } from "@nucleux/attachment-tile";
+```
+
+Requires the theme once in your app: `import "@nucleux/tokens/styles.css";`
+and the Tailwind preset from `@nucleux/tokens/preset`.
+
+## License
+
+MIT © Nucleux

package/dist/index.cjs

@@ -0,0 +1,96 @@
+"use client";
+'use strict';
+
+var React = require('react');
+var utils = require('@nucleux/utils');
+var lucideReact = require('lucide-react');
+var jsxRuntime = require('react/jsx-runtime');
+
+function _interopNamespace(e) {
+  if (e && e.__esModule) return e;
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+
+var React__namespace = /*#__PURE__*/_interopNamespace(React);
+
+// src/index.tsx
+var AttachmentTile = React__namespace.forwardRef(
+  ({ name, meta, thumbnail, icon, onRemove, className, ...props }, ref) => {
+    const remove = onRemove && /* @__PURE__ */ jsxRuntime.jsx(
+      "button",
+      {
+        type: "button",
+        "aria-label": `Remove ${typeof name === "string" ? name : "attachment"}`,
+        onClick: onRemove,
+        className: utils.cn(
+          "inline-flex size-5 items-center justify-center rounded-full text-muted-foreground transition-colors hover:bg-accent hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring [&_svg]:size-3.5",
+          thumbnail && "absolute right-1 top-1 bg-background/80 backdrop-blur"
+        ),
+        children: /* @__PURE__ */ jsxRuntime.jsx(lucideReact.X, { "aria-hidden": "true" })
+      }
+    );
+    if (thumbnail) {
+      return /* @__PURE__ */ jsxRuntime.jsxs(
+        "div",
+        {
+          ref,
+          className: utils.cn("relative size-16 overflow-hidden rounded-lg border border-border bg-muted", className),
+          ...props,
+          children: [
+            /* @__PURE__ */ jsxRuntime.jsx(
+              "img",
+              {
+                src: thumbnail,
+                alt: typeof name === "string" ? name : "",
+                className: "size-full object-cover"
+              }
+            ),
+            remove
+          ]
+        }
+      );
+    }
+    return /* @__PURE__ */ jsxRuntime.jsxs(
+      "div",
+      {
+        ref,
+        className: utils.cn(
+          "inline-flex max-w-64 items-center gap-2.5 rounded-lg border border-border bg-background py-2 pl-2.5 pr-2",
+          className
+        ),
+        ...props,
+        children: [
+          /* @__PURE__ */ jsxRuntime.jsx("span", { className: "inline-flex size-8 shrink-0 items-center justify-center rounded-md bg-muted text-muted-foreground [&_svg]:size-4", children: icon ?? /* @__PURE__ */ jsxRuntime.jsx(lucideReact.FileText, { "aria-hidden": "true" }) }),
+          /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "flex min-w-0 flex-col", children: [
+            /* @__PURE__ */ jsxRuntime.jsx("span", { className: "truncate text-sm font-medium text-foreground", children: name }),
+            meta && /* @__PURE__ */ jsxRuntime.jsx("span", { className: "truncate text-xs text-muted-foreground", children: meta })
+          ] }),
+          remove
+        ]
+      }
+    );
+  }
+);
+AttachmentTile.displayName = "AttachmentTile";
+var AttachmentTray = React__namespace.forwardRef(
+  ({ className, ...props }, ref) => /* @__PURE__ */ jsxRuntime.jsx("div", { ref, className: utils.cn("flex flex-wrap items-start gap-2", className), ...props })
+);
+AttachmentTray.displayName = "AttachmentTray";
+
+exports.AttachmentTile = AttachmentTile;
+exports.AttachmentTray = AttachmentTray;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.tsx"],"names":["React","jsx","cn","X","jsxs","FileText"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuBO,IAAM,cAAA,GAAuBA,gBAAA,CAAA,UAAA;AAAA,EAClC,CAAC,EAAE,IAAA,EAAM,IAAA,EAAM,SAAA,EAAW,IAAA,EAAM,QAAA,EAAU,SAAA,EAAW,GAAG,KAAA,EAAM,EAAG,GAAA,KAAQ;AACvE,IAAA,MAAM,SAAS,QAAA,oBACbC,cAAA;AAAA,MAAC,QAAA;AAAA,MAAA;AAAA,QACC,IAAA,EAAK,QAAA;AAAA,QACL,cAAY,CAAA,OAAA,EAAU,OAAO,IAAA,KAAS,QAAA,GAAW,OAAO,YAAY,CAAA,CAAA;AAAA,QACpE,OAAA,EAAS,QAAA;AAAA,QACT,SAAA,EAAWC,QAAA;AAAA,UACT,oOAAA;AAAA,UACA,SAAA,IAAa;AAAA,SACf;AAAA,QAEA,QAAA,kBAAAD,cAAA,CAACE,aAAA,EAAA,EAAE,aAAA,EAAY,MAAA,EAAO;AAAA;AAAA,KACxB;AAGF,IAAA,IAAI,SAAA,EAAW;AACb,MAAA,uBACEC,eAAA;AAAA,QAAC,KAAA;AAAA,QAAA;AAAA,UACC,GAAA;AAAA,UACA,SAAA,EAAWF,QAAA,CAAG,2EAAA,EAA6E,SAAS,CAAA;AAAA,UACnG,GAAG,KAAA;AAAA,UAEJ,QAAA,EAAA;AAAA,4BAAAD,cAAA;AAAA,cAAC,KAAA;AAAA,cAAA;AAAA,gBACC,GAAA,EAAK,SAAA;AAAA,gBACL,GAAA,EAAK,OAAO,IAAA,KAAS,QAAA,GAAW,IAAA,GAAO,EAAA;AAAA,gBACvC,SAAA,EAAU;AAAA;AAAA,aACZ;AAAA,YACC;AAAA;AAAA;AAAA,OACH;AAAA,IAEJ;AAEA,IAAA,uBACEG,eAAA;AAAA,MAAC,KAAA;AAAA,MAAA;AAAA,QACC,GAAA;AAAA,QACA,SAAA,EAAWF,QAAA;AAAA,UACT,0GAAA;AAAA,UACA;AAAA,SACF;AAAA,QACC,GAAG,KAAA;AAAA,QAEJ,QAAA,EAAA;AAAA,0BAAAD,cAAA,CAAC,MAAA,EAAA,EAAK,WAAU,kHAAA,EACb,QAAA,EAAA,IAAA,mCAASI,oBAAA,EAAA,EAAS,aAAA,EAAY,QAAO,CAAA,EACxC,CAAA;AAAA,0BACAD,eAAA,CAAC,MAAA,EAAA,EAAK,SAAA,EAAU,uBAAA,EACd,QAAA,EAAA;AAAA,4BAAAH,cAAA,CAAC,MAAA,EAAA,EAAK,SAAA,EAAU,8CAAA,EAAgD,QAAA,EAAA,IAAA,EAAK,CAAA;AAAA,YACpE,IAAA,oBAAQA,cAAA,CAAC,MAAA,EAAA,EAAK,SAAA,EAAU,0CAA0C,QAAA,EAAA,IAAA,EAAK;AAAA,WAAA,EAC1E,CAAA;AAAA,UACC;AAAA;AAAA;AAAA,KACH;AAAA,EAEJ;AACF;AACA,cAAA,CAAe,WAAA,GAAc,gBAAA;AAKtB,IAAM,cAAA,GAAuBD,gBAAA,CAAA,UAAA;AAAA,EAClC,CAAC,EAAE,SAAA,EAAW,GAAG,KAAA,IAAS,GAAA,qBACxBC,cAAA,CAAC,KAAA,EAAA,EAAI,GAAA,EAAU,WAAWC,QAAA,CAAG,kCAAA,EAAoC,SAAS,CAAA,EAAI,GAAG,KAAA,EAAO;AAE5F;AACA,cAAA,CAAe,WAAA,GAAc,gBAAA","file":"index.cjs","sourcesContent":["import * as React from \"react\";\nimport { cn } from \"@nucleux/utils\";\nimport { FileText, X } from \"lucide-react\";\n\nexport interface AttachmentTileProps\n  extends Omit<React.HTMLAttributes<HTMLDivElement>, \"title\"> {\n  /** File or attachment name. */\n  name: React.ReactNode;\n  /** Metadata line, e.g. `\"PDF · 240 KB\"`. */\n  meta?: React.ReactNode;\n  /** Image URL — renders a thumbnail tile instead of a document chip. */\n  thumbnail?: string;\n  /** Doctype icon for the document chip. Defaults to a document glyph. */\n  icon?: React.ReactNode;\n  /** Called when the remove control is used. Hidden if omitted. */\n  onRemove?: () => void;\n}\n\n/**\n * A removable preview of a file or image attached as context to an agent turn —\n * document chip or image thumbnail. The multimodal-context affordance.\n * Source: Figma \"Context Expansion / File Attachment\".\n */\nexport const AttachmentTile = React.forwardRef<HTMLDivElement, AttachmentTileProps>(\n  ({ name, meta, thumbnail, icon, onRemove, className, ...props }, ref) => {\n    const remove = onRemove && (\n      <button\n        type=\"button\"\n        aria-label={`Remove ${typeof name === \"string\" ? name : \"attachment\"}`}\n        onClick={onRemove}\n        className={cn(\n          \"inline-flex size-5 items-center justify-center rounded-full text-muted-foreground transition-colors hover:bg-accent hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring [&_svg]:size-3.5\",\n          thumbnail && \"absolute right-1 top-1 bg-background/80 backdrop-blur\",\n        )}\n      >\n        <X aria-hidden=\"true\" />\n      </button>\n    );\n\n    if (thumbnail) {\n      return (\n        <div\n          ref={ref}\n          className={cn(\"relative size-16 overflow-hidden rounded-lg border border-border bg-muted\", className)}\n          {...props}\n        >\n          <img\n            src={thumbnail}\n            alt={typeof name === \"string\" ? name : \"\"}\n            className=\"size-full object-cover\"\n          />\n          {remove}\n        </div>\n      );\n    }\n\n    return (\n      <div\n        ref={ref}\n        className={cn(\n          \"inline-flex max-w-64 items-center gap-2.5 rounded-lg border border-border bg-background py-2 pl-2.5 pr-2\",\n          className,\n        )}\n        {...props}\n      >\n        <span className=\"inline-flex size-8 shrink-0 items-center justify-center rounded-md bg-muted text-muted-foreground [&_svg]:size-4\">\n          {icon ?? <FileText aria-hidden=\"true\" />}\n        </span>\n        <span className=\"flex min-w-0 flex-col\">\n          <span className=\"truncate text-sm font-medium text-foreground\">{name}</span>\n          {meta && <span className=\"truncate text-xs text-muted-foreground\">{meta}</span>}\n        </span>\n        {remove}\n      </div>\n    );\n  },\n);\nAttachmentTile.displayName = \"AttachmentTile\";\n\nexport interface AttachmentTrayProps extends React.HTMLAttributes<HTMLDivElement> {}\n\n/** A wrapping row of {@link AttachmentTile}s, shown above the composer. */\nexport const AttachmentTray = React.forwardRef<HTMLDivElement, AttachmentTrayProps>(\n  ({ className, ...props }, ref) => (\n    <div ref={ref} className={cn(\"flex flex-wrap items-start gap-2\", className)} {...props} />\n  ),\n);\nAttachmentTray.displayName = \"AttachmentTray\";\n"]}

package/dist/index.d.cts

@@ -0,0 +1,26 @@
+import * as React from 'react';
+
+interface AttachmentTileProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "title"> {
+    /** File or attachment name. */
+    name: React.ReactNode;
+    /** Metadata line, e.g. `"PDF · 240 KB"`. */
+    meta?: React.ReactNode;
+    /** Image URL — renders a thumbnail tile instead of a document chip. */
+    thumbnail?: string;
+    /** Doctype icon for the document chip. Defaults to a document glyph. */
+    icon?: React.ReactNode;
+    /** Called when the remove control is used. Hidden if omitted. */
+    onRemove?: () => void;
+}
+/**
+ * A removable preview of a file or image attached as context to an agent turn —
+ * document chip or image thumbnail. The multimodal-context affordance.
+ * Source: Figma "Context Expansion / File Attachment".
+ */
+declare const AttachmentTile: React.ForwardRefExoticComponent<AttachmentTileProps & React.RefAttributes<HTMLDivElement>>;
+interface AttachmentTrayProps extends React.HTMLAttributes<HTMLDivElement> {
+}
+/** A wrapping row of {@link AttachmentTile}s, shown above the composer. */
+declare const AttachmentTray: React.ForwardRefExoticComponent<AttachmentTrayProps & React.RefAttributes<HTMLDivElement>>;
+
+export { AttachmentTile, type AttachmentTileProps, AttachmentTray, type AttachmentTrayProps };

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+import * as React from 'react';
+
+interface AttachmentTileProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "title"> {
+    /** File or attachment name. */
+    name: React.ReactNode;
+    /** Metadata line, e.g. `"PDF · 240 KB"`. */
+    meta?: React.ReactNode;
+    /** Image URL — renders a thumbnail tile instead of a document chip. */
+    thumbnail?: string;
+    /** Doctype icon for the document chip. Defaults to a document glyph. */
+    icon?: React.ReactNode;
+    /** Called when the remove control is used. Hidden if omitted. */
+    onRemove?: () => void;
+}
+/**
+ * A removable preview of a file or image attached as context to an agent turn —
+ * document chip or image thumbnail. The multimodal-context affordance.
+ * Source: Figma "Context Expansion / File Attachment".
+ */
+declare const AttachmentTile: React.ForwardRefExoticComponent<AttachmentTileProps & React.RefAttributes<HTMLDivElement>>;
+interface AttachmentTrayProps extends React.HTMLAttributes<HTMLDivElement> {
+}
+/** A wrapping row of {@link AttachmentTile}s, shown above the composer. */
+declare const AttachmentTray: React.ForwardRefExoticComponent<AttachmentTrayProps & React.RefAttributes<HTMLDivElement>>;
+
+export { AttachmentTile, type AttachmentTileProps, AttachmentTray, type AttachmentTrayProps };

package/dist/index.js

@@ -0,0 +1,73 @@
+"use client";
+import * as React from 'react';
+import { cn } from '@nucleux/utils';
+import { X, FileText } from 'lucide-react';
+import { jsx, jsxs } from 'react/jsx-runtime';
+
+// src/index.tsx
+var AttachmentTile = React.forwardRef(
+  ({ name, meta, thumbnail, icon, onRemove, className, ...props }, ref) => {
+    const remove = onRemove && /* @__PURE__ */ jsx(
+      "button",
+      {
+        type: "button",
+        "aria-label": `Remove ${typeof name === "string" ? name : "attachment"}`,
+        onClick: onRemove,
+        className: cn(
+          "inline-flex size-5 items-center justify-center rounded-full text-muted-foreground transition-colors hover:bg-accent hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring [&_svg]:size-3.5",
+          thumbnail && "absolute right-1 top-1 bg-background/80 backdrop-blur"
+        ),
+        children: /* @__PURE__ */ jsx(X, { "aria-hidden": "true" })
+      }
+    );
+    if (thumbnail) {
+      return /* @__PURE__ */ jsxs(
+        "div",
+        {
+          ref,
+          className: cn("relative size-16 overflow-hidden rounded-lg border border-border bg-muted", className),
+          ...props,
+          children: [
+            /* @__PURE__ */ jsx(
+              "img",
+              {
+                src: thumbnail,
+                alt: typeof name === "string" ? name : "",
+                className: "size-full object-cover"
+              }
+            ),
+            remove
+          ]
+        }
+      );
+    }
+    return /* @__PURE__ */ jsxs(
+      "div",
+      {
+        ref,
+        className: cn(
+          "inline-flex max-w-64 items-center gap-2.5 rounded-lg border border-border bg-background py-2 pl-2.5 pr-2",
+          className
+        ),
+        ...props,
+        children: [
+          /* @__PURE__ */ jsx("span", { className: "inline-flex size-8 shrink-0 items-center justify-center rounded-md bg-muted text-muted-foreground [&_svg]:size-4", children: icon ?? /* @__PURE__ */ jsx(FileText, { "aria-hidden": "true" }) }),
+          /* @__PURE__ */ jsxs("span", { className: "flex min-w-0 flex-col", children: [
+            /* @__PURE__ */ jsx("span", { className: "truncate text-sm font-medium text-foreground", children: name }),
+            meta && /* @__PURE__ */ jsx("span", { className: "truncate text-xs text-muted-foreground", children: meta })
+          ] }),
+          remove
+        ]
+      }
+    );
+  }
+);
+AttachmentTile.displayName = "AttachmentTile";
+var AttachmentTray = React.forwardRef(
+  ({ className, ...props }, ref) => /* @__PURE__ */ jsx("div", { ref, className: cn("flex flex-wrap items-start gap-2", className), ...props })
+);
+AttachmentTray.displayName = "AttachmentTray";
+
+export { AttachmentTile, AttachmentTray };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.tsx"],"names":[],"mappings":";;;;;;AAuBO,IAAM,cAAA,GAAuB,KAAA,CAAA,UAAA;AAAA,EAClC,CAAC,EAAE,IAAA,EAAM,IAAA,EAAM,SAAA,EAAW,IAAA,EAAM,QAAA,EAAU,SAAA,EAAW,GAAG,KAAA,EAAM,EAAG,GAAA,KAAQ;AACvE,IAAA,MAAM,SAAS,QAAA,oBACb,GAAA;AAAA,MAAC,QAAA;AAAA,MAAA;AAAA,QACC,IAAA,EAAK,QAAA;AAAA,QACL,cAAY,CAAA,OAAA,EAAU,OAAO,IAAA,KAAS,QAAA,GAAW,OAAO,YAAY,CAAA,CAAA;AAAA,QACpE,OAAA,EAAS,QAAA;AAAA,QACT,SAAA,EAAW,EAAA;AAAA,UACT,oOAAA;AAAA,UACA,SAAA,IAAa;AAAA,SACf;AAAA,QAEA,QAAA,kBAAA,GAAA,CAAC,CAAA,EAAA,EAAE,aAAA,EAAY,MAAA,EAAO;AAAA;AAAA,KACxB;AAGF,IAAA,IAAI,SAAA,EAAW;AACb,MAAA,uBACE,IAAA;AAAA,QAAC,KAAA;AAAA,QAAA;AAAA,UACC,GAAA;AAAA,UACA,SAAA,EAAW,EAAA,CAAG,2EAAA,EAA6E,SAAS,CAAA;AAAA,UACnG,GAAG,KAAA;AAAA,UAEJ,QAAA,EAAA;AAAA,4BAAA,GAAA;AAAA,cAAC,KAAA;AAAA,cAAA;AAAA,gBACC,GAAA,EAAK,SAAA;AAAA,gBACL,GAAA,EAAK,OAAO,IAAA,KAAS,QAAA,GAAW,IAAA,GAAO,EAAA;AAAA,gBACvC,SAAA,EAAU;AAAA;AAAA,aACZ;AAAA,YACC;AAAA;AAAA;AAAA,OACH;AAAA,IAEJ;AAEA,IAAA,uBACE,IAAA;AAAA,MAAC,KAAA;AAAA,MAAA;AAAA,QACC,GAAA;AAAA,QACA,SAAA,EAAW,EAAA;AAAA,UACT,0GAAA;AAAA,UACA;AAAA,SACF;AAAA,QACC,GAAG,KAAA;AAAA,QAEJ,QAAA,EAAA;AAAA,0BAAA,GAAA,CAAC,MAAA,EAAA,EAAK,WAAU,kHAAA,EACb,QAAA,EAAA,IAAA,wBAAS,QAAA,EAAA,EAAS,aAAA,EAAY,QAAO,CAAA,EACxC,CAAA;AAAA,0BACA,IAAA,CAAC,MAAA,EAAA,EAAK,SAAA,EAAU,uBAAA,EACd,QAAA,EAAA;AAAA,4BAAA,GAAA,CAAC,MAAA,EAAA,EAAK,SAAA,EAAU,8CAAA,EAAgD,QAAA,EAAA,IAAA,EAAK,CAAA;AAAA,YACpE,IAAA,oBAAQ,GAAA,CAAC,MAAA,EAAA,EAAK,SAAA,EAAU,0CAA0C,QAAA,EAAA,IAAA,EAAK;AAAA,WAAA,EAC1E,CAAA;AAAA,UACC;AAAA;AAAA;AAAA,KACH;AAAA,EAEJ;AACF;AACA,cAAA,CAAe,WAAA,GAAc,gBAAA;AAKtB,IAAM,cAAA,GAAuB,KAAA,CAAA,UAAA;AAAA,EAClC,CAAC,EAAE,SAAA,EAAW,GAAG,KAAA,IAAS,GAAA,qBACxB,GAAA,CAAC,KAAA,EAAA,EAAI,GAAA,EAAU,WAAW,EAAA,CAAG,kCAAA,EAAoC,SAAS,CAAA,EAAI,GAAG,KAAA,EAAO;AAE5F;AACA,cAAA,CAAe,WAAA,GAAc,gBAAA","file":"index.js","sourcesContent":["import * as React from \"react\";\nimport { cn } from \"@nucleux/utils\";\nimport { FileText, X } from \"lucide-react\";\n\nexport interface AttachmentTileProps\n  extends Omit<React.HTMLAttributes<HTMLDivElement>, \"title\"> {\n  /** File or attachment name. */\n  name: React.ReactNode;\n  /** Metadata line, e.g. `\"PDF · 240 KB\"`. */\n  meta?: React.ReactNode;\n  /** Image URL — renders a thumbnail tile instead of a document chip. */\n  thumbnail?: string;\n  /** Doctype icon for the document chip. Defaults to a document glyph. */\n  icon?: React.ReactNode;\n  /** Called when the remove control is used. Hidden if omitted. */\n  onRemove?: () => void;\n}\n\n/**\n * A removable preview of a file or image attached as context to an agent turn —\n * document chip or image thumbnail. The multimodal-context affordance.\n * Source: Figma \"Context Expansion / File Attachment\".\n */\nexport const AttachmentTile = React.forwardRef<HTMLDivElement, AttachmentTileProps>(\n  ({ name, meta, thumbnail, icon, onRemove, className, ...props }, ref) => {\n    const remove = onRemove && (\n      <button\n        type=\"button\"\n        aria-label={`Remove ${typeof name === \"string\" ? name : \"attachment\"}`}\n        onClick={onRemove}\n        className={cn(\n          \"inline-flex size-5 items-center justify-center rounded-full text-muted-foreground transition-colors hover:bg-accent hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring [&_svg]:size-3.5\",\n          thumbnail && \"absolute right-1 top-1 bg-background/80 backdrop-blur\",\n        )}\n      >\n        <X aria-hidden=\"true\" />\n      </button>\n    );\n\n    if (thumbnail) {\n      return (\n        <div\n          ref={ref}\n          className={cn(\"relative size-16 overflow-hidden rounded-lg border border-border bg-muted\", className)}\n          {...props}\n        >\n          <img\n            src={thumbnail}\n            alt={typeof name === \"string\" ? name : \"\"}\n            className=\"size-full object-cover\"\n          />\n          {remove}\n        </div>\n      );\n    }\n\n    return (\n      <div\n        ref={ref}\n        className={cn(\n          \"inline-flex max-w-64 items-center gap-2.5 rounded-lg border border-border bg-background py-2 pl-2.5 pr-2\",\n          className,\n        )}\n        {...props}\n      >\n        <span className=\"inline-flex size-8 shrink-0 items-center justify-center rounded-md bg-muted text-muted-foreground [&_svg]:size-4\">\n          {icon ?? <FileText aria-hidden=\"true\" />}\n        </span>\n        <span className=\"flex min-w-0 flex-col\">\n          <span className=\"truncate text-sm font-medium text-foreground\">{name}</span>\n          {meta && <span className=\"truncate text-xs text-muted-foreground\">{meta}</span>}\n        </span>\n        {remove}\n      </div>\n    );\n  },\n);\nAttachmentTile.displayName = \"AttachmentTile\";\n\nexport interface AttachmentTrayProps extends React.HTMLAttributes<HTMLDivElement> {}\n\n/** A wrapping row of {@link AttachmentTile}s, shown above the composer. */\nexport const AttachmentTray = React.forwardRef<HTMLDivElement, AttachmentTrayProps>(\n  ({ className, ...props }, ref) => (\n    <div ref={ref} className={cn(\"flex flex-wrap items-start gap-2\", className)} {...props} />\n  ),\n);\nAttachmentTray.displayName = \"AttachmentTray\";\n"]}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@nucleux/attachment-tile",
+  "version": "0.1.1",
+  "type": "module",
+  "sideEffects": false,
+  "description": "AttachmentTile — removable file and image context tiles for the composer — Nucleux agentic UI for React.",
+  "keywords": [
+    "nucleux",
+    "react",
+    "ui",
+    "components",
+    "agentic",
+    "ai",
+    "tailwind",
+    "attachment-tile"
+  ],
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "peerDependencies": {
+    "react": ">=18",
+    "react-dom": ">=18"
+  },
+  "dependencies": {
+    "lucide-react": "^0.469.0",
+    "@nucleux/utils": "0.1.1"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "@types/react": "^18.3.18",
+    "react": "^18.3.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/intelligaia-open-labs/nucleux.git",
+    "directory": "packages/attachment-tile"
+  },
+  "homepage": "https://github.com/intelligaia-open-labs/nucleux#readme",
+  "scripts": {
+    "build": "tsup"
+  }
+}