@nucleux/activity-log 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/activity-log
+
+ActivityLog — a timestamped audit trail of the actions an agent took — 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/activity-log @nucleux/tokens
+```
+
+`react` / `react-dom` are peer dependencies.
+
+## Usage
+
+```tsx
+import { ActivityLog } from "@nucleux/activity-log";
+```
+
+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,62 @@
+"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 ActivityLogItem = React__namespace.forwardRef(
+  ({ icon, time, className, children, ...props }, ref) => /* @__PURE__ */ jsxRuntime.jsxs("li", { ref, className: utils.cn("relative flex gap-3 pb-4 last:pb-0", className), ...props, children: [
+    /* @__PURE__ */ jsxRuntime.jsx("span", { className: "relative z-10 mt-0.5 inline-flex size-6 shrink-0 items-center justify-center rounded-full border border-border bg-background text-muted-foreground [&_svg]:size-3.5", children: icon ?? /* @__PURE__ */ jsxRuntime.jsx(lucideReact.Activity, { "aria-hidden": "true" }) }),
+    /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "flex min-w-0 flex-1 flex-col gap-0.5", children: [
+      /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-sm text-foreground", children }),
+      time && /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-xs text-muted-foreground", children: time })
+    ] })
+  ] })
+);
+ActivityLogItem.displayName = "ActivityLogItem";
+var ActivityLog = React__namespace.forwardRef(
+  ({ heading, className, children, ...props }, ref) => /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex flex-col gap-3", children: [
+    heading && /* @__PURE__ */ jsxRuntime.jsx("p", { className: "text-xs font-medium uppercase tracking-wide text-muted-foreground", children: heading }),
+    /* @__PURE__ */ jsxRuntime.jsx(
+      "ol",
+      {
+        ref,
+        className: utils.cn(
+          "relative before:absolute before:left-3 before:top-1 before:h-[calc(100%-1rem)] before:w-px before:-translate-x-1/2 before:bg-border",
+          className
+        ),
+        ...props,
+        children
+      }
+    )
+  ] })
+);
+ActivityLog.displayName = "ActivityLog";
+
+exports.ActivityLog = ActivityLog;
+exports.ActivityLogItem = ActivityLogItem;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.tsx"],"names":["React","jsxs","cn","jsx","Activity"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAYO,IAAM,eAAA,GAAwBA,gBAAA,CAAA,UAAA;AAAA,EACnC,CAAC,EAAE,IAAA,EAAM,MAAM,SAAA,EAAW,QAAA,EAAU,GAAG,KAAA,EAAM,EAAG,wBAC9CC,eAAA,CAAC,IAAA,EAAA,EAAG,KAAU,SAAA,EAAWC,QAAA,CAAG,sCAAsC,SAAS,CAAA,EAAI,GAAG,KAAA,EAChF,QAAA,EAAA;AAAA,oBAAAC,cAAA,CAAC,MAAA,EAAA,EAAK,WAAU,qKAAA,EACb,QAAA,EAAA,IAAA,mCAASC,oBAAA,EAAA,EAAS,aAAA,EAAY,QAAO,CAAA,EACxC,CAAA;AAAA,oBACAH,eAAA,CAAC,MAAA,EAAA,EAAK,SAAA,EAAU,sCAAA,EACd,QAAA,EAAA;AAAA,sBAAAE,cAAA,CAAC,MAAA,EAAA,EAAK,SAAA,EAAU,yBAAA,EAA2B,QAAA,EAAS,CAAA;AAAA,MACnD,IAAA,oBAAQA,cAAA,CAAC,MAAA,EAAA,EAAK,SAAA,EAAU,iCAAiC,QAAA,EAAA,IAAA,EAAK;AAAA,KAAA,EACjE;AAAA,GAAA,EACF;AAEJ;AACA,eAAA,CAAgB,WAAA,GAAc,iBAAA;AAYvB,IAAM,WAAA,GAAoBH,gBAAA,CAAA,UAAA;AAAA,EAC/B,CAAC,EAAE,OAAA,EAAS,SAAA,EAAW,QAAA,EAAU,GAAG,KAAA,EAAM,EAAG,GAAA,qBAC3CC,eAAA,CAAC,KAAA,EAAA,EAAI,SAAA,EAAU,qBAAA,EACZ,QAAA,EAAA;AAAA,IAAA,OAAA,oBACCE,cAAA,CAAC,GAAA,EAAA,EAAE,SAAA,EAAU,mEAAA,EAAqE,QAAA,EAAA,OAAA,EAAQ,CAAA;AAAA,oBAE5FA,cAAA;AAAA,MAAC,IAAA;AAAA,MAAA;AAAA,QACC,GAAA;AAAA,QACA,SAAA,EAAWD,QAAA;AAAA,UACT,qIAAA;AAAA,UACA;AAAA,SACF;AAAA,QACC,GAAG,KAAA;AAAA,QAEH;AAAA;AAAA;AACH,GAAA,EACF;AAEJ;AACA,WAAA,CAAY,WAAA,GAAc,aAAA","file":"index.cjs","sourcesContent":["import * as React from \"react\";\nimport { cn } from \"@nucleux/utils\";\nimport { Activity } from \"lucide-react\";\n\nexport interface ActivityLogItemProps extends React.LiHTMLAttributes<HTMLLIElement> {\n  /** Icon for the action type. Defaults to a generic activity glyph. */\n  icon?: React.ReactNode;\n  /** Relative or absolute timestamp, e.g. `\"2m ago\"`. */\n  time?: React.ReactNode;\n}\n\n/** A single entry in an {@link ActivityLog}: an action the agent took, with a timestamp. */\nexport const ActivityLogItem = React.forwardRef<HTMLLIElement, ActivityLogItemProps>(\n  ({ icon, time, className, children, ...props }, ref) => (\n    <li ref={ref} className={cn(\"relative flex gap-3 pb-4 last:pb-0\", className)} {...props}>\n      <span className=\"relative z-10 mt-0.5 inline-flex size-6 shrink-0 items-center justify-center rounded-full border border-border bg-background text-muted-foreground [&_svg]:size-3.5\">\n        {icon ?? <Activity aria-hidden=\"true\" />}\n      </span>\n      <span className=\"flex min-w-0 flex-1 flex-col gap-0.5\">\n        <span className=\"text-sm text-foreground\">{children}</span>\n        {time && <span className=\"text-xs text-muted-foreground\">{time}</span>}\n      </span>\n    </li>\n  ),\n);\nActivityLogItem.displayName = \"ActivityLogItem\";\n\nexport interface ActivityLogProps extends React.HTMLAttributes<HTMLOListElement> {\n  /** Heading above the trail. */\n  heading?: React.ReactNode;\n}\n\n/**\n * A timestamped audit trail of the actions an agent performed on the user's\n * behalf — a connected timeline of {@link ActivityLogItem}s.\n * Source: Figma \"Explainability / Footprints\".\n */\nexport const ActivityLog = React.forwardRef<HTMLOListElement, ActivityLogProps>(\n  ({ heading, className, children, ...props }, ref) => (\n    <div className=\"flex flex-col gap-3\">\n      {heading && (\n        <p className=\"text-xs font-medium uppercase tracking-wide text-muted-foreground\">{heading}</p>\n      )}\n      <ol\n        ref={ref}\n        className={cn(\n          \"relative before:absolute before:left-3 before:top-1 before:h-[calc(100%-1rem)] before:w-px before:-translate-x-1/2 before:bg-border\",\n          className,\n        )}\n        {...props}\n      >\n        {children}\n      </ol>\n    </div>\n  ),\n);\nActivityLog.displayName = \"ActivityLog\";\n"]}

package/dist/index.d.cts

@@ -0,0 +1,22 @@
+import * as React from 'react';
+
+interface ActivityLogItemProps extends React.LiHTMLAttributes<HTMLLIElement> {
+    /** Icon for the action type. Defaults to a generic activity glyph. */
+    icon?: React.ReactNode;
+    /** Relative or absolute timestamp, e.g. `"2m ago"`. */
+    time?: React.ReactNode;
+}
+/** A single entry in an {@link ActivityLog}: an action the agent took, with a timestamp. */
+declare const ActivityLogItem: React.ForwardRefExoticComponent<ActivityLogItemProps & React.RefAttributes<HTMLLIElement>>;
+interface ActivityLogProps extends React.HTMLAttributes<HTMLOListElement> {
+    /** Heading above the trail. */
+    heading?: React.ReactNode;
+}
+/**
+ * A timestamped audit trail of the actions an agent performed on the user's
+ * behalf — a connected timeline of {@link ActivityLogItem}s.
+ * Source: Figma "Explainability / Footprints".
+ */
+declare const ActivityLog: React.ForwardRefExoticComponent<ActivityLogProps & React.RefAttributes<HTMLOListElement>>;
+
+export { ActivityLog, ActivityLogItem, type ActivityLogItemProps, type ActivityLogProps };

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+import * as React from 'react';
+
+interface ActivityLogItemProps extends React.LiHTMLAttributes<HTMLLIElement> {
+    /** Icon for the action type. Defaults to a generic activity glyph. */
+    icon?: React.ReactNode;
+    /** Relative or absolute timestamp, e.g. `"2m ago"`. */
+    time?: React.ReactNode;
+}
+/** A single entry in an {@link ActivityLog}: an action the agent took, with a timestamp. */
+declare const ActivityLogItem: React.ForwardRefExoticComponent<ActivityLogItemProps & React.RefAttributes<HTMLLIElement>>;
+interface ActivityLogProps extends React.HTMLAttributes<HTMLOListElement> {
+    /** Heading above the trail. */
+    heading?: React.ReactNode;
+}
+/**
+ * A timestamped audit trail of the actions an agent performed on the user's
+ * behalf — a connected timeline of {@link ActivityLogItem}s.
+ * Source: Figma "Explainability / Footprints".
+ */
+declare const ActivityLog: React.ForwardRefExoticComponent<ActivityLogProps & React.RefAttributes<HTMLOListElement>>;
+
+export { ActivityLog, ActivityLogItem, type ActivityLogItemProps, type ActivityLogProps };

package/dist/index.js

@@ -0,0 +1,39 @@
+"use client";
+import * as React from 'react';
+import { cn } from '@nucleux/utils';
+import { Activity } from 'lucide-react';
+import { jsxs, jsx } from 'react/jsx-runtime';
+
+// src/index.tsx
+var ActivityLogItem = React.forwardRef(
+  ({ icon, time, className, children, ...props }, ref) => /* @__PURE__ */ jsxs("li", { ref, className: cn("relative flex gap-3 pb-4 last:pb-0", className), ...props, children: [
+    /* @__PURE__ */ jsx("span", { className: "relative z-10 mt-0.5 inline-flex size-6 shrink-0 items-center justify-center rounded-full border border-border bg-background text-muted-foreground [&_svg]:size-3.5", children: icon ?? /* @__PURE__ */ jsx(Activity, { "aria-hidden": "true" }) }),
+    /* @__PURE__ */ jsxs("span", { className: "flex min-w-0 flex-1 flex-col gap-0.5", children: [
+      /* @__PURE__ */ jsx("span", { className: "text-sm text-foreground", children }),
+      time && /* @__PURE__ */ jsx("span", { className: "text-xs text-muted-foreground", children: time })
+    ] })
+  ] })
+);
+ActivityLogItem.displayName = "ActivityLogItem";
+var ActivityLog = React.forwardRef(
+  ({ heading, className, children, ...props }, ref) => /* @__PURE__ */ jsxs("div", { className: "flex flex-col gap-3", children: [
+    heading && /* @__PURE__ */ jsx("p", { className: "text-xs font-medium uppercase tracking-wide text-muted-foreground", children: heading }),
+    /* @__PURE__ */ jsx(
+      "ol",
+      {
+        ref,
+        className: cn(
+          "relative before:absolute before:left-3 before:top-1 before:h-[calc(100%-1rem)] before:w-px before:-translate-x-1/2 before:bg-border",
+          className
+        ),
+        ...props,
+        children
+      }
+    )
+  ] })
+);
+ActivityLog.displayName = "ActivityLog";
+
+export { ActivityLog, ActivityLogItem };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.tsx"],"names":[],"mappings":";;;;;;AAYO,IAAM,eAAA,GAAwB,KAAA,CAAA,UAAA;AAAA,EACnC,CAAC,EAAE,IAAA,EAAM,MAAM,SAAA,EAAW,QAAA,EAAU,GAAG,KAAA,EAAM,EAAG,wBAC9C,IAAA,CAAC,IAAA,EAAA,EAAG,KAAU,SAAA,EAAW,EAAA,CAAG,sCAAsC,SAAS,CAAA,EAAI,GAAG,KAAA,EAChF,QAAA,EAAA;AAAA,oBAAA,GAAA,CAAC,MAAA,EAAA,EAAK,WAAU,qKAAA,EACb,QAAA,EAAA,IAAA,wBAAS,QAAA,EAAA,EAAS,aAAA,EAAY,QAAO,CAAA,EACxC,CAAA;AAAA,oBACA,IAAA,CAAC,MAAA,EAAA,EAAK,SAAA,EAAU,sCAAA,EACd,QAAA,EAAA;AAAA,sBAAA,GAAA,CAAC,MAAA,EAAA,EAAK,SAAA,EAAU,yBAAA,EAA2B,QAAA,EAAS,CAAA;AAAA,MACnD,IAAA,oBAAQ,GAAA,CAAC,MAAA,EAAA,EAAK,SAAA,EAAU,iCAAiC,QAAA,EAAA,IAAA,EAAK;AAAA,KAAA,EACjE;AAAA,GAAA,EACF;AAEJ;AACA,eAAA,CAAgB,WAAA,GAAc,iBAAA;AAYvB,IAAM,WAAA,GAAoB,KAAA,CAAA,UAAA;AAAA,EAC/B,CAAC,EAAE,OAAA,EAAS,SAAA,EAAW,QAAA,EAAU,GAAG,KAAA,EAAM,EAAG,GAAA,qBAC3C,IAAA,CAAC,KAAA,EAAA,EAAI,SAAA,EAAU,qBAAA,EACZ,QAAA,EAAA;AAAA,IAAA,OAAA,oBACC,GAAA,CAAC,GAAA,EAAA,EAAE,SAAA,EAAU,mEAAA,EAAqE,QAAA,EAAA,OAAA,EAAQ,CAAA;AAAA,oBAE5F,GAAA;AAAA,MAAC,IAAA;AAAA,MAAA;AAAA,QACC,GAAA;AAAA,QACA,SAAA,EAAW,EAAA;AAAA,UACT,qIAAA;AAAA,UACA;AAAA,SACF;AAAA,QACC,GAAG,KAAA;AAAA,QAEH;AAAA;AAAA;AACH,GAAA,EACF;AAEJ;AACA,WAAA,CAAY,WAAA,GAAc,aAAA","file":"index.js","sourcesContent":["import * as React from \"react\";\nimport { cn } from \"@nucleux/utils\";\nimport { Activity } from \"lucide-react\";\n\nexport interface ActivityLogItemProps extends React.LiHTMLAttributes<HTMLLIElement> {\n  /** Icon for the action type. Defaults to a generic activity glyph. */\n  icon?: React.ReactNode;\n  /** Relative or absolute timestamp, e.g. `\"2m ago\"`. */\n  time?: React.ReactNode;\n}\n\n/** A single entry in an {@link ActivityLog}: an action the agent took, with a timestamp. */\nexport const ActivityLogItem = React.forwardRef<HTMLLIElement, ActivityLogItemProps>(\n  ({ icon, time, className, children, ...props }, ref) => (\n    <li ref={ref} className={cn(\"relative flex gap-3 pb-4 last:pb-0\", className)} {...props}>\n      <span className=\"relative z-10 mt-0.5 inline-flex size-6 shrink-0 items-center justify-center rounded-full border border-border bg-background text-muted-foreground [&_svg]:size-3.5\">\n        {icon ?? <Activity aria-hidden=\"true\" />}\n      </span>\n      <span className=\"flex min-w-0 flex-1 flex-col gap-0.5\">\n        <span className=\"text-sm text-foreground\">{children}</span>\n        {time && <span className=\"text-xs text-muted-foreground\">{time}</span>}\n      </span>\n    </li>\n  ),\n);\nActivityLogItem.displayName = \"ActivityLogItem\";\n\nexport interface ActivityLogProps extends React.HTMLAttributes<HTMLOListElement> {\n  /** Heading above the trail. */\n  heading?: React.ReactNode;\n}\n\n/**\n * A timestamped audit trail of the actions an agent performed on the user's\n * behalf — a connected timeline of {@link ActivityLogItem}s.\n * Source: Figma \"Explainability / Footprints\".\n */\nexport const ActivityLog = React.forwardRef<HTMLOListElement, ActivityLogProps>(\n  ({ heading, className, children, ...props }, ref) => (\n    <div className=\"flex flex-col gap-3\">\n      {heading && (\n        <p className=\"text-xs font-medium uppercase tracking-wide text-muted-foreground\">{heading}</p>\n      )}\n      <ol\n        ref={ref}\n        className={cn(\n          \"relative before:absolute before:left-3 before:top-1 before:h-[calc(100%-1rem)] before:w-px before:-translate-x-1/2 before:bg-border\",\n          className,\n        )}\n        {...props}\n      >\n        {children}\n      </ol>\n    </div>\n  ),\n);\nActivityLog.displayName = \"ActivityLog\";\n"]}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@nucleux/activity-log",
+  "version": "0.1.1",
+  "type": "module",
+  "sideEffects": false,
+  "description": "ActivityLog — a timestamped audit trail of the actions an agent took — Nucleux agentic UI for React.",
+  "keywords": [
+    "nucleux",
+    "react",
+    "ui",
+    "components",
+    "agentic",
+    "ai",
+    "tailwind",
+    "activity-log"
+  ],
+  "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/activity-log"
+  },
+  "homepage": "https://github.com/intelligaia-open-labs/nucleux#readme",
+  "scripts": {
+    "build": "tsup"
+  }
+}