@nucleux/citation 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/citation
+
+Citation — inline source chips and a grounded sources list for AI answers — 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/citation @nucleux/tokens
+```
+
+`react` / `react-dom` are peer dependencies.
+
+## Usage
+
+```tsx
+import { Citation } from "@nucleux/citation";
+```
+
+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,109 @@
+"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 Citation = React__namespace.forwardRef(
+  ({ index, label, className, children, type = "button", ...props }, ref) => /* @__PURE__ */ jsxRuntime.jsx(
+    "button",
+    {
+      ref,
+      type,
+      className: utils.cn(
+        "inline-flex h-5 min-w-5 items-center justify-center gap-1 rounded-full border border-border bg-muted px-1.5 align-middle text-[0.6875rem] font-medium leading-none text-muted-foreground transition-colors hover:bg-accent hover:text-accent-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring",
+        className
+      ),
+      ...props,
+      children: children ?? label ?? index
+    }
+  )
+);
+Citation.displayName = "Citation";
+var SourceItem = React__namespace.forwardRef(
+  ({ index, icon, title, meta, href, actionLabel = "Open", onOpen, className, ...props }, ref) => {
+    const action = href ? /* @__PURE__ */ jsxRuntime.jsxs(
+      "a",
+      {
+        href,
+        className: "inline-flex shrink-0 items-center gap-1 rounded-md px-2 py-1 text-xs font-medium text-info transition-colors hover:bg-info/10 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring",
+        children: [
+          actionLabel,
+          /* @__PURE__ */ jsxRuntime.jsx(lucideReact.ExternalLink, { className: "size-3.5", "aria-hidden": "true" })
+        ]
+      }
+    ) : /* @__PURE__ */ jsxRuntime.jsxs(
+      "button",
+      {
+        type: "button",
+        onClick: onOpen,
+        className: "inline-flex shrink-0 items-center gap-1 rounded-md px-2 py-1 text-xs font-medium text-info transition-colors hover:bg-info/10 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring",
+        children: [
+          actionLabel,
+          /* @__PURE__ */ jsxRuntime.jsx(lucideReact.ExternalLink, { className: "size-3.5", "aria-hidden": "true" })
+        ]
+      }
+    );
+    return /* @__PURE__ */ jsxRuntime.jsxs(
+      "li",
+      {
+        ref,
+        className: utils.cn("flex items-center gap-3 rounded-lg border border-border bg-background p-3", 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", children: index != null ? /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-xs font-semibold", children: index }) : icon ?? /* @__PURE__ */ jsxRuntime.jsx(lucideReact.FileText, { className: "size-4", "aria-hidden": "true" }) }),
+          /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "flex min-w-0 flex-1 flex-col", children: [
+            /* @__PURE__ */ jsxRuntime.jsx("span", { className: "truncate text-sm font-medium text-foreground", children: title }),
+            meta && /* @__PURE__ */ jsxRuntime.jsx("span", { className: "truncate text-xs text-muted-foreground", children: meta })
+          ] }),
+          action
+        ]
+      }
+    );
+  }
+);
+SourceItem.displayName = "SourceItem";
+var SourceList = React__namespace.forwardRef(
+  ({ heading, className, children, ...props }, ref) => /* @__PURE__ */ jsxRuntime.jsxs(
+    "div",
+    {
+      ref,
+      className: utils.cn("flex flex-col gap-2 rounded-xl border border-border bg-muted/30 p-3", className),
+      ...props,
+      children: [
+        heading && /* @__PURE__ */ jsxRuntime.jsx("p", { className: "px-1 text-xs font-medium uppercase tracking-wide text-muted-foreground", children: heading }),
+        /* @__PURE__ */ jsxRuntime.jsx("ul", { className: "flex flex-col gap-2", children })
+      ]
+    }
+  )
+);
+SourceList.displayName = "SourceList";
+
+exports.Citation = Citation;
+exports.SourceItem = SourceItem;
+exports.SourceList = SourceList;
+//# 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","jsxs","ExternalLink","FileText"],"mappings":"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","file":"index.cjs","sourcesContent":["import * as React from \"react\";\nimport { cn } from \"@nucleux/utils\";\nimport { FileText, ExternalLink } from \"lucide-react\";\n\nexport interface CitationProps\n  extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, \"title\"> {\n  /** Source index shown in the chip, e.g. `4`. Ignored if `children` is given. */\n  index?: number;\n  /** Text label instead of a number, e.g. `\"wikipedia.com\"`. */\n  label?: React.ReactNode;\n}\n\n/**\n * An inline citation chip embedded in an AI answer — a compact numbered or\n * domain marker that attributes a claim to a source.\n * Source: Figma \"Explainability / Inline source chip\".\n */\nexport const Citation = React.forwardRef<HTMLButtonElement, CitationProps>(\n  ({ index, label, className, children, type = \"button\", ...props }, ref) => (\n    <button\n      ref={ref}\n      type={type}\n      className={cn(\n        \"inline-flex h-5 min-w-5 items-center justify-center gap-1 rounded-full border border-border bg-muted px-1.5 align-middle text-[0.6875rem] font-medium leading-none text-muted-foreground transition-colors hover:bg-accent hover:text-accent-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring\",\n        className,\n      )}\n      {...props}\n    >\n      {children ?? label ?? index}\n    </button>\n  ),\n);\nCitation.displayName = \"Citation\";\n\nexport interface SourceItemProps\n  extends Omit<React.LiHTMLAttributes<HTMLLIElement>, \"title\"> {\n  /** Optional leading index, e.g. `1`. */\n  index?: number;\n  /** Icon shown in the leading slot. Defaults to a document icon. */\n  icon?: React.ReactNode;\n  /** Source title, e.g. a filename. */\n  title: React.ReactNode;\n  /** Metadata line, e.g. `\"Source · PDF · Section 4.1\"`. */\n  meta?: React.ReactNode;\n  /** If set, the open affordance becomes a link to this href. */\n  href?: string;\n  /** Label for the open affordance. Defaults to `\"Open\"`. */\n  actionLabel?: React.ReactNode;\n  /** Called when the open affordance is activated (button mode). */\n  onOpen?: () => void;\n}\n\n/** A single row in a {@link SourceList}: icon, title, metadata and an open action. */\nexport const SourceItem = React.forwardRef<HTMLLIElement, SourceItemProps>(\n  ({ index, icon, title, meta, href, actionLabel = \"Open\", onOpen, className, ...props }, ref) => {\n    const action = href ? (\n      <a\n        href={href}\n        className=\"inline-flex shrink-0 items-center gap-1 rounded-md px-2 py-1 text-xs font-medium text-info transition-colors hover:bg-info/10 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring\"\n      >\n        {actionLabel}\n        <ExternalLink className=\"size-3.5\" aria-hidden=\"true\" />\n      </a>\n    ) : (\n      <button\n        type=\"button\"\n        onClick={onOpen}\n        className=\"inline-flex shrink-0 items-center gap-1 rounded-md px-2 py-1 text-xs font-medium text-info transition-colors hover:bg-info/10 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring\"\n      >\n        {actionLabel}\n        <ExternalLink className=\"size-3.5\" aria-hidden=\"true\" />\n      </button>\n    );\n    return (\n      <li\n        ref={ref}\n        className={cn(\"flex items-center gap-3 rounded-lg border border-border bg-background p-3\", className)}\n        {...props}\n      >\n        <span className=\"inline-flex size-8 shrink-0 items-center justify-center rounded-md bg-muted text-muted-foreground\">\n          {index != null ? (\n            <span className=\"text-xs font-semibold\">{index}</span>\n          ) : (\n            icon ?? <FileText className=\"size-4\" aria-hidden=\"true\" />\n          )}\n        </span>\n        <span className=\"flex min-w-0 flex-1 flex-col\">\n          <span className=\"truncate text-sm font-medium text-foreground\">{title}</span>\n          {meta && <span className=\"truncate text-xs text-muted-foreground\">{meta}</span>}\n        </span>\n        {action}\n      </li>\n    );\n  },\n);\nSourceItem.displayName = \"SourceItem\";\n\nexport interface SourceListProps extends React.HTMLAttributes<HTMLDivElement> {\n  /** Heading above the list, e.g. `\"3 sources · 1 missing policy\"`. */\n  heading?: React.ReactNode;\n}\n\n/**\n * A grounded sources block: the knowledge sources an AI answer drew on, each an\n * openable {@link SourceItem}. Surfaces the retrieval set behind a response.\n */\nexport const SourceList = React.forwardRef<HTMLDivElement, SourceListProps>(\n  ({ heading, className, children, ...props }, ref) => (\n    <div\n      ref={ref}\n      className={cn(\"flex flex-col gap-2 rounded-xl border border-border bg-muted/30 p-3\", className)}\n      {...props}\n    >\n      {heading && (\n        <p className=\"px-1 text-xs font-medium uppercase tracking-wide text-muted-foreground\">\n          {heading}\n        </p>\n      )}\n      <ul className=\"flex flex-col gap-2\">{children}</ul>\n    </div>\n  ),\n);\nSourceList.displayName = \"SourceList\";\n"]}

package/dist/index.d.cts

@@ -0,0 +1,43 @@
+import * as React from 'react';
+
+interface CitationProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "title"> {
+    /** Source index shown in the chip, e.g. `4`. Ignored if `children` is given. */
+    index?: number;
+    /** Text label instead of a number, e.g. `"wikipedia.com"`. */
+    label?: React.ReactNode;
+}
+/**
+ * An inline citation chip embedded in an AI answer — a compact numbered or
+ * domain marker that attributes a claim to a source.
+ * Source: Figma "Explainability / Inline source chip".
+ */
+declare const Citation: React.ForwardRefExoticComponent<CitationProps & React.RefAttributes<HTMLButtonElement>>;
+interface SourceItemProps extends Omit<React.LiHTMLAttributes<HTMLLIElement>, "title"> {
+    /** Optional leading index, e.g. `1`. */
+    index?: number;
+    /** Icon shown in the leading slot. Defaults to a document icon. */
+    icon?: React.ReactNode;
+    /** Source title, e.g. a filename. */
+    title: React.ReactNode;
+    /** Metadata line, e.g. `"Source · PDF · Section 4.1"`. */
+    meta?: React.ReactNode;
+    /** If set, the open affordance becomes a link to this href. */
+    href?: string;
+    /** Label for the open affordance. Defaults to `"Open"`. */
+    actionLabel?: React.ReactNode;
+    /** Called when the open affordance is activated (button mode). */
+    onOpen?: () => void;
+}
+/** A single row in a {@link SourceList}: icon, title, metadata and an open action. */
+declare const SourceItem: React.ForwardRefExoticComponent<SourceItemProps & React.RefAttributes<HTMLLIElement>>;
+interface SourceListProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Heading above the list, e.g. `"3 sources · 1 missing policy"`. */
+    heading?: React.ReactNode;
+}
+/**
+ * A grounded sources block: the knowledge sources an AI answer drew on, each an
+ * openable {@link SourceItem}. Surfaces the retrieval set behind a response.
+ */
+declare const SourceList: React.ForwardRefExoticComponent<SourceListProps & React.RefAttributes<HTMLDivElement>>;
+
+export { Citation, type CitationProps, SourceItem, type SourceItemProps, SourceList, type SourceListProps };

package/dist/index.d.ts

@@ -0,0 +1,43 @@
+import * as React from 'react';
+
+interface CitationProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "title"> {
+    /** Source index shown in the chip, e.g. `4`. Ignored if `children` is given. */
+    index?: number;
+    /** Text label instead of a number, e.g. `"wikipedia.com"`. */
+    label?: React.ReactNode;
+}
+/**
+ * An inline citation chip embedded in an AI answer — a compact numbered or
+ * domain marker that attributes a claim to a source.
+ * Source: Figma "Explainability / Inline source chip".
+ */
+declare const Citation: React.ForwardRefExoticComponent<CitationProps & React.RefAttributes<HTMLButtonElement>>;
+interface SourceItemProps extends Omit<React.LiHTMLAttributes<HTMLLIElement>, "title"> {
+    /** Optional leading index, e.g. `1`. */
+    index?: number;
+    /** Icon shown in the leading slot. Defaults to a document icon. */
+    icon?: React.ReactNode;
+    /** Source title, e.g. a filename. */
+    title: React.ReactNode;
+    /** Metadata line, e.g. `"Source · PDF · Section 4.1"`. */
+    meta?: React.ReactNode;
+    /** If set, the open affordance becomes a link to this href. */
+    href?: string;
+    /** Label for the open affordance. Defaults to `"Open"`. */
+    actionLabel?: React.ReactNode;
+    /** Called when the open affordance is activated (button mode). */
+    onOpen?: () => void;
+}
+/** A single row in a {@link SourceList}: icon, title, metadata and an open action. */
+declare const SourceItem: React.ForwardRefExoticComponent<SourceItemProps & React.RefAttributes<HTMLLIElement>>;
+interface SourceListProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Heading above the list, e.g. `"3 sources · 1 missing policy"`. */
+    heading?: React.ReactNode;
+}
+/**
+ * A grounded sources block: the knowledge sources an AI answer drew on, each an
+ * openable {@link SourceItem}. Surfaces the retrieval set behind a response.
+ */
+declare const SourceList: React.ForwardRefExoticComponent<SourceListProps & React.RefAttributes<HTMLDivElement>>;
+
+export { Citation, type CitationProps, SourceItem, type SourceItemProps, SourceList, type SourceListProps };

package/dist/index.js

@@ -0,0 +1,85 @@
+"use client";
+import * as React from 'react';
+import { cn } from '@nucleux/utils';
+import { FileText, ExternalLink } from 'lucide-react';
+import { jsx, jsxs } from 'react/jsx-runtime';
+
+// src/index.tsx
+var Citation = React.forwardRef(
+  ({ index, label, className, children, type = "button", ...props }, ref) => /* @__PURE__ */ jsx(
+    "button",
+    {
+      ref,
+      type,
+      className: cn(
+        "inline-flex h-5 min-w-5 items-center justify-center gap-1 rounded-full border border-border bg-muted px-1.5 align-middle text-[0.6875rem] font-medium leading-none text-muted-foreground transition-colors hover:bg-accent hover:text-accent-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring",
+        className
+      ),
+      ...props,
+      children: children ?? label ?? index
+    }
+  )
+);
+Citation.displayName = "Citation";
+var SourceItem = React.forwardRef(
+  ({ index, icon, title, meta, href, actionLabel = "Open", onOpen, className, ...props }, ref) => {
+    const action = href ? /* @__PURE__ */ jsxs(
+      "a",
+      {
+        href,
+        className: "inline-flex shrink-0 items-center gap-1 rounded-md px-2 py-1 text-xs font-medium text-info transition-colors hover:bg-info/10 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring",
+        children: [
+          actionLabel,
+          /* @__PURE__ */ jsx(ExternalLink, { className: "size-3.5", "aria-hidden": "true" })
+        ]
+      }
+    ) : /* @__PURE__ */ jsxs(
+      "button",
+      {
+        type: "button",
+        onClick: onOpen,
+        className: "inline-flex shrink-0 items-center gap-1 rounded-md px-2 py-1 text-xs font-medium text-info transition-colors hover:bg-info/10 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring",
+        children: [
+          actionLabel,
+          /* @__PURE__ */ jsx(ExternalLink, { className: "size-3.5", "aria-hidden": "true" })
+        ]
+      }
+    );
+    return /* @__PURE__ */ jsxs(
+      "li",
+      {
+        ref,
+        className: cn("flex items-center gap-3 rounded-lg border border-border bg-background p-3", className),
+        ...props,
+        children: [
+          /* @__PURE__ */ jsx("span", { className: "inline-flex size-8 shrink-0 items-center justify-center rounded-md bg-muted text-muted-foreground", children: index != null ? /* @__PURE__ */ jsx("span", { className: "text-xs font-semibold", children: index }) : icon ?? /* @__PURE__ */ jsx(FileText, { className: "size-4", "aria-hidden": "true" }) }),
+          /* @__PURE__ */ jsxs("span", { className: "flex min-w-0 flex-1 flex-col", children: [
+            /* @__PURE__ */ jsx("span", { className: "truncate text-sm font-medium text-foreground", children: title }),
+            meta && /* @__PURE__ */ jsx("span", { className: "truncate text-xs text-muted-foreground", children: meta })
+          ] }),
+          action
+        ]
+      }
+    );
+  }
+);
+SourceItem.displayName = "SourceItem";
+var SourceList = React.forwardRef(
+  ({ heading, className, children, ...props }, ref) => /* @__PURE__ */ jsxs(
+    "div",
+    {
+      ref,
+      className: cn("flex flex-col gap-2 rounded-xl border border-border bg-muted/30 p-3", className),
+      ...props,
+      children: [
+        heading && /* @__PURE__ */ jsx("p", { className: "px-1 text-xs font-medium uppercase tracking-wide text-muted-foreground", children: heading }),
+        /* @__PURE__ */ jsx("ul", { className: "flex flex-col gap-2", children })
+      ]
+    }
+  )
+);
+SourceList.displayName = "SourceList";
+
+export { Citation, SourceItem, SourceList };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.tsx"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import * as React from \"react\";\nimport { cn } from \"@nucleux/utils\";\nimport { FileText, ExternalLink } from \"lucide-react\";\n\nexport interface CitationProps\n  extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, \"title\"> {\n  /** Source index shown in the chip, e.g. `4`. Ignored if `children` is given. */\n  index?: number;\n  /** Text label instead of a number, e.g. `\"wikipedia.com\"`. */\n  label?: React.ReactNode;\n}\n\n/**\n * An inline citation chip embedded in an AI answer — a compact numbered or\n * domain marker that attributes a claim to a source.\n * Source: Figma \"Explainability / Inline source chip\".\n */\nexport const Citation = React.forwardRef<HTMLButtonElement, CitationProps>(\n  ({ index, label, className, children, type = \"button\", ...props }, ref) => (\n    <button\n      ref={ref}\n      type={type}\n      className={cn(\n        \"inline-flex h-5 min-w-5 items-center justify-center gap-1 rounded-full border border-border bg-muted px-1.5 align-middle text-[0.6875rem] font-medium leading-none text-muted-foreground transition-colors hover:bg-accent hover:text-accent-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring\",\n        className,\n      )}\n      {...props}\n    >\n      {children ?? label ?? index}\n    </button>\n  ),\n);\nCitation.displayName = \"Citation\";\n\nexport interface SourceItemProps\n  extends Omit<React.LiHTMLAttributes<HTMLLIElement>, \"title\"> {\n  /** Optional leading index, e.g. `1`. */\n  index?: number;\n  /** Icon shown in the leading slot. Defaults to a document icon. */\n  icon?: React.ReactNode;\n  /** Source title, e.g. a filename. */\n  title: React.ReactNode;\n  /** Metadata line, e.g. `\"Source · PDF · Section 4.1\"`. */\n  meta?: React.ReactNode;\n  /** If set, the open affordance becomes a link to this href. */\n  href?: string;\n  /** Label for the open affordance. Defaults to `\"Open\"`. */\n  actionLabel?: React.ReactNode;\n  /** Called when the open affordance is activated (button mode). */\n  onOpen?: () => void;\n}\n\n/** A single row in a {@link SourceList}: icon, title, metadata and an open action. */\nexport const SourceItem = React.forwardRef<HTMLLIElement, SourceItemProps>(\n  ({ index, icon, title, meta, href, actionLabel = \"Open\", onOpen, className, ...props }, ref) => {\n    const action = href ? (\n      <a\n        href={href}\n        className=\"inline-flex shrink-0 items-center gap-1 rounded-md px-2 py-1 text-xs font-medium text-info transition-colors hover:bg-info/10 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring\"\n      >\n        {actionLabel}\n        <ExternalLink className=\"size-3.5\" aria-hidden=\"true\" />\n      </a>\n    ) : (\n      <button\n        type=\"button\"\n        onClick={onOpen}\n        className=\"inline-flex shrink-0 items-center gap-1 rounded-md px-2 py-1 text-xs font-medium text-info transition-colors hover:bg-info/10 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring\"\n      >\n        {actionLabel}\n        <ExternalLink className=\"size-3.5\" aria-hidden=\"true\" />\n      </button>\n    );\n    return (\n      <li\n        ref={ref}\n        className={cn(\"flex items-center gap-3 rounded-lg border border-border bg-background p-3\", className)}\n        {...props}\n      >\n        <span className=\"inline-flex size-8 shrink-0 items-center justify-center rounded-md bg-muted text-muted-foreground\">\n          {index != null ? (\n            <span className=\"text-xs font-semibold\">{index}</span>\n          ) : (\n            icon ?? <FileText className=\"size-4\" aria-hidden=\"true\" />\n          )}\n        </span>\n        <span className=\"flex min-w-0 flex-1 flex-col\">\n          <span className=\"truncate text-sm font-medium text-foreground\">{title}</span>\n          {meta && <span className=\"truncate text-xs text-muted-foreground\">{meta}</span>}\n        </span>\n        {action}\n      </li>\n    );\n  },\n);\nSourceItem.displayName = \"SourceItem\";\n\nexport interface SourceListProps extends React.HTMLAttributes<HTMLDivElement> {\n  /** Heading above the list, e.g. `\"3 sources · 1 missing policy\"`. */\n  heading?: React.ReactNode;\n}\n\n/**\n * A grounded sources block: the knowledge sources an AI answer drew on, each an\n * openable {@link SourceItem}. Surfaces the retrieval set behind a response.\n */\nexport const SourceList = React.forwardRef<HTMLDivElement, SourceListProps>(\n  ({ heading, className, children, ...props }, ref) => (\n    <div\n      ref={ref}\n      className={cn(\"flex flex-col gap-2 rounded-xl border border-border bg-muted/30 p-3\", className)}\n      {...props}\n    >\n      {heading && (\n        <p className=\"px-1 text-xs font-medium uppercase tracking-wide text-muted-foreground\">\n          {heading}\n        </p>\n      )}\n      <ul className=\"flex flex-col gap-2\">{children}</ul>\n    </div>\n  ),\n);\nSourceList.displayName = \"SourceList\";\n"]}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@nucleux/citation",
+  "version": "0.1.1",
+  "type": "module",
+  "sideEffects": false,
+  "description": "Citation — inline source chips and a grounded sources list for AI answers — Nucleux agentic UI for React.",
+  "keywords": [
+    "nucleux",
+    "react",
+    "ui",
+    "components",
+    "agentic",
+    "ai",
+    "tailwind",
+    "citation"
+  ],
+  "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/citation"
+  },
+  "homepage": "https://github.com/intelligaia-open-labs/nucleux#readme",
+  "scripts": {
+    "build": "tsup"
+  }
+}