@nucleux/agent-steps 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/agent-steps
+
+AgentSteps — a live tracker of an agent's multi-step plan — 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/agent-steps @nucleux/tokens
+```
+
+`react` / `react-dom` are peer dependencies.
+
+## Usage
+
+```tsx
+import { AgentSteps } from "@nucleux/agent-steps";
+```
+
+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,98 @@
+"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 marker = {
+  pending: "border-border bg-background text-muted-foreground",
+  active: "border-info bg-info/10 text-info",
+  done: "border-success bg-success text-success-foreground",
+  error: "border-destructive bg-destructive text-destructive-foreground"
+};
+function StatusGlyph({ status }) {
+  if (status === "done") return /* @__PURE__ */ jsxRuntime.jsx(lucideReact.Check, { className: "size-3.5", "aria-hidden": "true" });
+  if (status === "active") return /* @__PURE__ */ jsxRuntime.jsx(lucideReact.Loader2, { className: "size-3.5 animate-spin", "aria-hidden": "true" });
+  if (status === "error") return /* @__PURE__ */ jsxRuntime.jsx(lucideReact.X, { className: "size-3.5", "aria-hidden": "true" });
+  return /* @__PURE__ */ jsxRuntime.jsx(lucideReact.Circle, { className: "size-2 fill-current", "aria-hidden": "true" });
+}
+var AgentStep = React__namespace.forwardRef(
+  ({ status = "pending", icon, title, description, progress, className, ...props }, ref) => /* @__PURE__ */ jsxRuntime.jsxs(
+    "li",
+    {
+      ref,
+      className: utils.cn(
+        "relative flex gap-3 pb-5 last:pb-0",
+        "before:absolute before:left-[0.6875rem] before:top-6 before:h-[calc(100%-1.25rem)] before:w-px before:-translate-x-1/2 before:bg-border last:before:hidden",
+        className
+      ),
+      "aria-current": status === "active" ? "step" : void 0,
+      ...props,
+      children: [
+        /* @__PURE__ */ jsxRuntime.jsx(
+          "span",
+          {
+            className: utils.cn(
+              "relative z-10 mt-0.5 inline-flex size-[1.375rem] shrink-0 items-center justify-center rounded-full border [&_svg]:size-3.5",
+              marker[status]
+            ),
+            children: icon ?? /* @__PURE__ */ jsxRuntime.jsx(StatusGlyph, { status })
+          }
+        ),
+        /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "flex min-w-0 flex-1 flex-col gap-1", children: [
+          /* @__PURE__ */ jsxRuntime.jsx(
+            "span",
+            {
+              className: utils.cn(
+                "text-sm font-medium",
+                status === "pending" ? "text-muted-foreground" : "text-foreground"
+              ),
+              children: title
+            }
+          ),
+          description && /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-xs text-muted-foreground", children: description }),
+          progress != null && /* @__PURE__ */ jsxRuntime.jsx("span", { className: "mt-1 block h-1 w-full overflow-hidden rounded-full bg-muted", children: /* @__PURE__ */ jsxRuntime.jsx(
+            "span",
+            {
+              className: "block h-full rounded-full bg-info transition-[width]",
+              style: { width: `${Math.max(0, Math.min(100, progress))}%` }
+            }
+          ) })
+        ] })
+      ]
+    }
+  )
+);
+AgentStep.displayName = "AgentStep";
+var AgentSteps = React__namespace.forwardRef(
+  ({ className, children, ...props }, ref) => /* @__PURE__ */ jsxRuntime.jsx("ol", { ref, className: utils.cn("flex flex-col", className), ...props, children })
+);
+AgentSteps.displayName = "AgentSteps";
+
+exports.AgentStep = AgentStep;
+exports.AgentSteps = AgentSteps;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.tsx"],"names":["jsx","Check","Loader2","X","Circle","React","jsxs","cn"],"mappings":"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","file":"index.cjs","sourcesContent":["import * as React from \"react\";\nimport { cn } from \"@nucleux/utils\";\nimport { Check, Loader2, Circle, X } from \"lucide-react\";\n\nexport type AgentStepStatus = \"pending\" | \"active\" | \"done\" | \"error\";\n\nexport interface AgentStepProps\n  extends Omit<React.LiHTMLAttributes<HTMLLIElement>, \"title\"> {\n  /** Execution status of the step. */\n  status?: AgentStepStatus;\n  /** Action-type icon (e.g. read, execute, search). Overrides the status glyph. */\n  icon?: React.ReactNode;\n  /** Step label. */\n  title: React.ReactNode;\n  /** Supporting detail under the title. */\n  description?: React.ReactNode;\n  /** Optional progress track, 0–100, shown under the step while active. */\n  progress?: number;\n}\n\nconst marker: Record<AgentStepStatus, string> = {\n  pending: \"border-border bg-background text-muted-foreground\",\n  active: \"border-info bg-info/10 text-info\",\n  done: \"border-success bg-success text-success-foreground\",\n  error: \"border-destructive bg-destructive text-destructive-foreground\",\n};\n\nfunction StatusGlyph({ status }: { status: AgentStepStatus }) {\n  if (status === \"done\") return <Check className=\"size-3.5\" aria-hidden=\"true\" />;\n  if (status === \"active\") return <Loader2 className=\"size-3.5 animate-spin\" aria-hidden=\"true\" />;\n  if (status === \"error\") return <X className=\"size-3.5\" aria-hidden=\"true\" />;\n  return <Circle className=\"size-2 fill-current\" aria-hidden=\"true\" />;\n}\n\n/** A single step in an {@link AgentSteps} tracker. */\nexport const AgentStep = React.forwardRef<HTMLLIElement, AgentStepProps>(\n  ({ status = \"pending\", icon, title, description, progress, className, ...props }, ref) => (\n    <li\n      ref={ref}\n      className={cn(\n        \"relative flex gap-3 pb-5 last:pb-0\",\n        \"before:absolute before:left-[0.6875rem] before:top-6 before:h-[calc(100%-1.25rem)] before:w-px before:-translate-x-1/2 before:bg-border last:before:hidden\",\n        className,\n      )}\n      aria-current={status === \"active\" ? \"step\" : undefined}\n      {...props}\n    >\n      <span\n        className={cn(\n          \"relative z-10 mt-0.5 inline-flex size-[1.375rem] shrink-0 items-center justify-center rounded-full border [&_svg]:size-3.5\",\n          marker[status],\n        )}\n      >\n        {icon ?? <StatusGlyph status={status} />}\n      </span>\n      <span className=\"flex min-w-0 flex-1 flex-col gap-1\">\n        <span\n          className={cn(\n            \"text-sm font-medium\",\n            status === \"pending\" ? \"text-muted-foreground\" : \"text-foreground\",\n          )}\n        >\n          {title}\n        </span>\n        {description && <span className=\"text-xs text-muted-foreground\">{description}</span>}\n        {progress != null && (\n          <span className=\"mt-1 block h-1 w-full overflow-hidden rounded-full bg-muted\">\n            <span\n              className=\"block h-full rounded-full bg-info transition-[width]\"\n              style={{ width: `${Math.max(0, Math.min(100, progress))}%` }}\n            />\n          </span>\n        )}\n      </span>\n    </li>\n  ),\n);\nAgentStep.displayName = \"AgentStep\";\n\nexport interface AgentStepsProps extends React.HTMLAttributes<HTMLOListElement> {}\n\n/**\n * A live tracker of an agent's multi-step plan — each {@link AgentStep} shows an\n * action-type icon, status and optional progress as the agent works.\n * Source: Figma \"During Interaction / Processing Steps · Footprints\".\n */\nexport const AgentSteps = React.forwardRef<HTMLOListElement, AgentStepsProps>(\n  ({ className, children, ...props }, ref) => (\n    <ol ref={ref} className={cn(\"flex flex-col\", className)} {...props}>\n      {children}\n    </ol>\n  ),\n);\nAgentSteps.displayName = \"AgentSteps\";\n"]}

package/dist/index.d.cts

@@ -0,0 +1,27 @@
+import * as React from 'react';
+
+type AgentStepStatus = "pending" | "active" | "done" | "error";
+interface AgentStepProps extends Omit<React.LiHTMLAttributes<HTMLLIElement>, "title"> {
+    /** Execution status of the step. */
+    status?: AgentStepStatus;
+    /** Action-type icon (e.g. read, execute, search). Overrides the status glyph. */
+    icon?: React.ReactNode;
+    /** Step label. */
+    title: React.ReactNode;
+    /** Supporting detail under the title. */
+    description?: React.ReactNode;
+    /** Optional progress track, 0–100, shown under the step while active. */
+    progress?: number;
+}
+/** A single step in an {@link AgentSteps} tracker. */
+declare const AgentStep: React.ForwardRefExoticComponent<AgentStepProps & React.RefAttributes<HTMLLIElement>>;
+interface AgentStepsProps extends React.HTMLAttributes<HTMLOListElement> {
+}
+/**
+ * A live tracker of an agent's multi-step plan — each {@link AgentStep} shows an
+ * action-type icon, status and optional progress as the agent works.
+ * Source: Figma "During Interaction / Processing Steps · Footprints".
+ */
+declare const AgentSteps: React.ForwardRefExoticComponent<AgentStepsProps & React.RefAttributes<HTMLOListElement>>;
+
+export { AgentStep, type AgentStepProps, type AgentStepStatus, AgentSteps, type AgentStepsProps };

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+import * as React from 'react';
+
+type AgentStepStatus = "pending" | "active" | "done" | "error";
+interface AgentStepProps extends Omit<React.LiHTMLAttributes<HTMLLIElement>, "title"> {
+    /** Execution status of the step. */
+    status?: AgentStepStatus;
+    /** Action-type icon (e.g. read, execute, search). Overrides the status glyph. */
+    icon?: React.ReactNode;
+    /** Step label. */
+    title: React.ReactNode;
+    /** Supporting detail under the title. */
+    description?: React.ReactNode;
+    /** Optional progress track, 0–100, shown under the step while active. */
+    progress?: number;
+}
+/** A single step in an {@link AgentSteps} tracker. */
+declare const AgentStep: React.ForwardRefExoticComponent<AgentStepProps & React.RefAttributes<HTMLLIElement>>;
+interface AgentStepsProps extends React.HTMLAttributes<HTMLOListElement> {
+}
+/**
+ * A live tracker of an agent's multi-step plan — each {@link AgentStep} shows an
+ * action-type icon, status and optional progress as the agent works.
+ * Source: Figma "During Interaction / Processing Steps · Footprints".
+ */
+declare const AgentSteps: React.ForwardRefExoticComponent<AgentStepsProps & React.RefAttributes<HTMLOListElement>>;
+
+export { AgentStep, type AgentStepProps, type AgentStepStatus, AgentSteps, type AgentStepsProps };

package/dist/index.js

@@ -0,0 +1,75 @@
+"use client";
+import * as React from 'react';
+import { cn } from '@nucleux/utils';
+import { Check, Loader2, X, Circle } from 'lucide-react';
+import { jsxs, jsx } from 'react/jsx-runtime';
+
+// src/index.tsx
+var marker = {
+  pending: "border-border bg-background text-muted-foreground",
+  active: "border-info bg-info/10 text-info",
+  done: "border-success bg-success text-success-foreground",
+  error: "border-destructive bg-destructive text-destructive-foreground"
+};
+function StatusGlyph({ status }) {
+  if (status === "done") return /* @__PURE__ */ jsx(Check, { className: "size-3.5", "aria-hidden": "true" });
+  if (status === "active") return /* @__PURE__ */ jsx(Loader2, { className: "size-3.5 animate-spin", "aria-hidden": "true" });
+  if (status === "error") return /* @__PURE__ */ jsx(X, { className: "size-3.5", "aria-hidden": "true" });
+  return /* @__PURE__ */ jsx(Circle, { className: "size-2 fill-current", "aria-hidden": "true" });
+}
+var AgentStep = React.forwardRef(
+  ({ status = "pending", icon, title, description, progress, className, ...props }, ref) => /* @__PURE__ */ jsxs(
+    "li",
+    {
+      ref,
+      className: cn(
+        "relative flex gap-3 pb-5 last:pb-0",
+        "before:absolute before:left-[0.6875rem] before:top-6 before:h-[calc(100%-1.25rem)] before:w-px before:-translate-x-1/2 before:bg-border last:before:hidden",
+        className
+      ),
+      "aria-current": status === "active" ? "step" : void 0,
+      ...props,
+      children: [
+        /* @__PURE__ */ jsx(
+          "span",
+          {
+            className: cn(
+              "relative z-10 mt-0.5 inline-flex size-[1.375rem] shrink-0 items-center justify-center rounded-full border [&_svg]:size-3.5",
+              marker[status]
+            ),
+            children: icon ?? /* @__PURE__ */ jsx(StatusGlyph, { status })
+          }
+        ),
+        /* @__PURE__ */ jsxs("span", { className: "flex min-w-0 flex-1 flex-col gap-1", children: [
+          /* @__PURE__ */ jsx(
+            "span",
+            {
+              className: cn(
+                "text-sm font-medium",
+                status === "pending" ? "text-muted-foreground" : "text-foreground"
+              ),
+              children: title
+            }
+          ),
+          description && /* @__PURE__ */ jsx("span", { className: "text-xs text-muted-foreground", children: description }),
+          progress != null && /* @__PURE__ */ jsx("span", { className: "mt-1 block h-1 w-full overflow-hidden rounded-full bg-muted", children: /* @__PURE__ */ jsx(
+            "span",
+            {
+              className: "block h-full rounded-full bg-info transition-[width]",
+              style: { width: `${Math.max(0, Math.min(100, progress))}%` }
+            }
+          ) })
+        ] })
+      ]
+    }
+  )
+);
+AgentStep.displayName = "AgentStep";
+var AgentSteps = React.forwardRef(
+  ({ className, children, ...props }, ref) => /* @__PURE__ */ jsx("ol", { ref, className: cn("flex flex-col", className), ...props, children })
+);
+AgentSteps.displayName = "AgentSteps";
+
+export { AgentStep, AgentSteps };
+//# 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 { Check, Loader2, Circle, X } from \"lucide-react\";\n\nexport type AgentStepStatus = \"pending\" | \"active\" | \"done\" | \"error\";\n\nexport interface AgentStepProps\n  extends Omit<React.LiHTMLAttributes<HTMLLIElement>, \"title\"> {\n  /** Execution status of the step. */\n  status?: AgentStepStatus;\n  /** Action-type icon (e.g. read, execute, search). Overrides the status glyph. */\n  icon?: React.ReactNode;\n  /** Step label. */\n  title: React.ReactNode;\n  /** Supporting detail under the title. */\n  description?: React.ReactNode;\n  /** Optional progress track, 0–100, shown under the step while active. */\n  progress?: number;\n}\n\nconst marker: Record<AgentStepStatus, string> = {\n  pending: \"border-border bg-background text-muted-foreground\",\n  active: \"border-info bg-info/10 text-info\",\n  done: \"border-success bg-success text-success-foreground\",\n  error: \"border-destructive bg-destructive text-destructive-foreground\",\n};\n\nfunction StatusGlyph({ status }: { status: AgentStepStatus }) {\n  if (status === \"done\") return <Check className=\"size-3.5\" aria-hidden=\"true\" />;\n  if (status === \"active\") return <Loader2 className=\"size-3.5 animate-spin\" aria-hidden=\"true\" />;\n  if (status === \"error\") return <X className=\"size-3.5\" aria-hidden=\"true\" />;\n  return <Circle className=\"size-2 fill-current\" aria-hidden=\"true\" />;\n}\n\n/** A single step in an {@link AgentSteps} tracker. */\nexport const AgentStep = React.forwardRef<HTMLLIElement, AgentStepProps>(\n  ({ status = \"pending\", icon, title, description, progress, className, ...props }, ref) => (\n    <li\n      ref={ref}\n      className={cn(\n        \"relative flex gap-3 pb-5 last:pb-0\",\n        \"before:absolute before:left-[0.6875rem] before:top-6 before:h-[calc(100%-1.25rem)] before:w-px before:-translate-x-1/2 before:bg-border last:before:hidden\",\n        className,\n      )}\n      aria-current={status === \"active\" ? \"step\" : undefined}\n      {...props}\n    >\n      <span\n        className={cn(\n          \"relative z-10 mt-0.5 inline-flex size-[1.375rem] shrink-0 items-center justify-center rounded-full border [&_svg]:size-3.5\",\n          marker[status],\n        )}\n      >\n        {icon ?? <StatusGlyph status={status} />}\n      </span>\n      <span className=\"flex min-w-0 flex-1 flex-col gap-1\">\n        <span\n          className={cn(\n            \"text-sm font-medium\",\n            status === \"pending\" ? \"text-muted-foreground\" : \"text-foreground\",\n          )}\n        >\n          {title}\n        </span>\n        {description && <span className=\"text-xs text-muted-foreground\">{description}</span>}\n        {progress != null && (\n          <span className=\"mt-1 block h-1 w-full overflow-hidden rounded-full bg-muted\">\n            <span\n              className=\"block h-full rounded-full bg-info transition-[width]\"\n              style={{ width: `${Math.max(0, Math.min(100, progress))}%` }}\n            />\n          </span>\n        )}\n      </span>\n    </li>\n  ),\n);\nAgentStep.displayName = \"AgentStep\";\n\nexport interface AgentStepsProps extends React.HTMLAttributes<HTMLOListElement> {}\n\n/**\n * A live tracker of an agent's multi-step plan — each {@link AgentStep} shows an\n * action-type icon, status and optional progress as the agent works.\n * Source: Figma \"During Interaction / Processing Steps · Footprints\".\n */\nexport const AgentSteps = React.forwardRef<HTMLOListElement, AgentStepsProps>(\n  ({ className, children, ...props }, ref) => (\n    <ol ref={ref} className={cn(\"flex flex-col\", className)} {...props}>\n      {children}\n    </ol>\n  ),\n);\nAgentSteps.displayName = \"AgentSteps\";\n"]}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@nucleux/agent-steps",
+  "version": "0.1.1",
+  "type": "module",
+  "sideEffects": false,
+  "description": "AgentSteps — a live tracker of an agent's multi-step plan — Nucleux agentic UI for React.",
+  "keywords": [
+    "nucleux",
+    "react",
+    "ui",
+    "components",
+    "agentic",
+    "ai",
+    "tailwind",
+    "agent-steps"
+  ],
+  "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/agent-steps"
+  },
+  "homepage": "https://github.com/intelligaia-open-labs/nucleux#readme",
+  "scripts": {
+    "build": "tsup"
+  }
+}