@nucleux/action-plan 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/action-plan
+
+ActionPlan — a proposed agent plan the user can accept, edit, or reject — 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/action-plan @nucleux/tokens
+```
+
+`react` / `react-dom` are peer dependencies.
+
+## Usage
+
+```tsx
+import { ActionPlan } from "@nucleux/action-plan";
+```
+
+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,111 @@
+"use client";
+'use strict';
+
+var React = require('react');
+var utils = require('@nucleux/utils');
+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 ActionPlanStep = React__namespace.forwardRef(
+  ({ title, description, className, ...props }, ref) => /* @__PURE__ */ jsxRuntime.jsx(
+    "li",
+    {
+      ref,
+      className: utils.cn(
+        "flex gap-3 [counter-increment:nx-step]",
+        "before:mt-0.5 before:inline-flex before:size-6 before:shrink-0 before:items-center before:justify-center before:rounded-full before:bg-muted before:text-xs before:font-semibold before:text-muted-foreground before:[content:counter(nx-step)]",
+        className
+      ),
+      ...props,
+      children: /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "flex min-w-0 flex-1 flex-col gap-0.5", children: [
+        /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-sm font-medium text-foreground", children: title }),
+        description && /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-xs text-muted-foreground", children: description })
+      ] })
+    }
+  )
+);
+ActionPlanStep.displayName = "ActionPlanStep";
+var ActionPlan = React__namespace.forwardRef(
+  ({
+    heading = "Proposed plan",
+    description,
+    onAccept,
+    onEdit,
+    onReject,
+    acceptLabel = "Accept plan",
+    editLabel = "Edit plan",
+    rejectLabel = "Reject",
+    className,
+    children,
+    ...props
+  }, ref) => /* @__PURE__ */ jsxRuntime.jsxs(
+    "div",
+    {
+      ref,
+      className: utils.cn("flex flex-col gap-4 rounded-xl border border-border bg-background p-5", className),
+      ...props,
+      children: [
+        /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex flex-col gap-1", children: [
+          heading && /* @__PURE__ */ jsxRuntime.jsx("h3", { className: "text-sm font-semibold text-foreground", children: heading }),
+          description && /* @__PURE__ */ jsxRuntime.jsx("p", { className: "text-sm text-muted-foreground", children: description })
+        ] }),
+        /* @__PURE__ */ jsxRuntime.jsx("ol", { className: "flex flex-col gap-3 [counter-reset:nx-step]", children }),
+        (onAccept || onEdit || onReject) && /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex flex-wrap items-center gap-2", children: [
+          onAccept && /* @__PURE__ */ jsxRuntime.jsx(
+            "button",
+            {
+              type: "button",
+              onClick: onAccept,
+              className: "inline-flex items-center rounded-lg bg-info px-3 py-2 text-sm font-medium text-info-foreground transition-colors hover:bg-info/90 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring",
+              children: acceptLabel
+            }
+          ),
+          onEdit && /* @__PURE__ */ jsxRuntime.jsx(
+            "button",
+            {
+              type: "button",
+              onClick: onEdit,
+              className: "inline-flex items-center rounded-lg border border-border bg-background px-3 py-2 text-sm font-medium text-foreground transition-colors hover:bg-accent focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring",
+              children: editLabel
+            }
+          ),
+          onReject && /* @__PURE__ */ jsxRuntime.jsx(
+            "button",
+            {
+              type: "button",
+              onClick: onReject,
+              className: "ml-auto inline-flex items-center rounded-lg px-3 py-2 text-sm font-medium text-muted-foreground transition-colors hover:bg-accent hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring",
+              children: rejectLabel
+            }
+          )
+        ] })
+      ]
+    }
+  )
+);
+ActionPlan.displayName = "ActionPlan";
+
+exports.ActionPlan = ActionPlan;
+exports.ActionPlanStep = ActionPlanStep;
+//# 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"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAYO,IAAM,cAAA,GAAuBA,gBAAA,CAAA,UAAA;AAAA,EAClC,CAAC,EAAE,KAAA,EAAO,WAAA,EAAa,WAAW,GAAG,KAAA,IAAS,GAAA,qBAC5CC,cAAA;AAAA,IAAC,IAAA;AAAA,IAAA;AAAA,MACC,GAAA;AAAA,MACA,SAAA,EAAWC,QAAA;AAAA,QACT,wCAAA;AAAA,QACA,iPAAA;AAAA,QACA;AAAA,OACF;AAAA,MACC,GAAG,KAAA;AAAA,MAEJ,QAAA,kBAAAC,eAAA,CAAC,MAAA,EAAA,EAAK,SAAA,EAAU,sCAAA,EACd,QAAA,EAAA;AAAA,wBAAAF,cAAA,CAAC,MAAA,EAAA,EAAK,SAAA,EAAU,qCAAA,EAAuC,QAAA,EAAA,KAAA,EAAM,CAAA;AAAA,QAC5D,WAAA,oBAAeA,cAAA,CAAC,MAAA,EAAA,EAAK,SAAA,EAAU,iCAAiC,QAAA,EAAA,WAAA,EAAY;AAAA,OAAA,EAC/E;AAAA;AAAA;AAGN;AACA,cAAA,CAAe,WAAA,GAAc,gBAAA;AAuBtB,IAAM,UAAA,GAAmBD,gBAAA,CAAA,UAAA;AAAA,EAC9B,CACE;AAAA,IACE,OAAA,GAAU,eAAA;AAAA,IACV,WAAA;AAAA,IACA,QAAA;AAAA,IACA,MAAA;AAAA,IACA,QAAA;AAAA,IACA,WAAA,GAAc,aAAA;AAAA,IACd,SAAA,GAAY,WAAA;AAAA,IACZ,WAAA,GAAc,QAAA;AAAA,IACd,SAAA;AAAA,IACA,QAAA;AAAA,IACA,GAAG;AAAA,KAEL,GAAA,qBAEAG,eAAA;AAAA,IAAC,KAAA;AAAA,IAAA;AAAA,MACC,GAAA;AAAA,MACA,SAAA,EAAWD,QAAA,CAAG,uEAAA,EAAyE,SAAS,CAAA;AAAA,MAC/F,GAAG,KAAA;AAAA,MAEJ,QAAA,EAAA;AAAA,wBAAAC,eAAA,CAAC,KAAA,EAAA,EAAI,WAAU,qBAAA,EACZ,QAAA,EAAA;AAAA,UAAA,OAAA,oBAAWF,cAAA,CAAC,IAAA,EAAA,EAAG,SAAA,EAAU,uCAAA,EAAyC,QAAA,EAAA,OAAA,EAAQ,CAAA;AAAA,UAC1E,WAAA,oBAAeA,cAAA,CAAC,GAAA,EAAA,EAAE,SAAA,EAAU,iCAAiC,QAAA,EAAA,WAAA,EAAY;AAAA,SAAA,EAC5E,CAAA;AAAA,wBACAA,cAAA,CAAC,IAAA,EAAA,EAAG,SAAA,EAAU,6CAAA,EAA+C,QAAA,EAAS,CAAA;AAAA,QAAA,CACpE,YAAY,MAAA,IAAU,QAAA,qBACtBE,eAAA,CAAC,KAAA,EAAA,EAAI,WAAU,mCAAA,EACZ,QAAA,EAAA;AAAA,UAAA,QAAA,oBACCF,cAAA;AAAA,YAAC,QAAA;AAAA,YAAA;AAAA,cACC,IAAA,EAAK,QAAA;AAAA,cACL,OAAA,EAAS,QAAA;AAAA,cACT,SAAA,EAAU,2MAAA;AAAA,cAET,QAAA,EAAA;AAAA;AAAA,WACH;AAAA,UAED,MAAA,oBACCA,cAAA;AAAA,YAAC,QAAA;AAAA,YAAA;AAAA,cACC,IAAA,EAAK,QAAA;AAAA,cACL,OAAA,EAAS,MAAA;AAAA,cACT,SAAA,EAAU,gOAAA;AAAA,cAET,QAAA,EAAA;AAAA;AAAA,WACH;AAAA,UAED,QAAA,oBACCA,cAAA;AAAA,YAAC,QAAA;AAAA,YAAA;AAAA,cACC,IAAA,EAAK,QAAA;AAAA,cACL,OAAA,EAAS,QAAA;AAAA,cACT,SAAA,EAAU,iOAAA;AAAA,cAET,QAAA,EAAA;AAAA;AAAA;AACH,SAAA,EAEJ;AAAA;AAAA;AAAA;AAIR;AACA,UAAA,CAAW,WAAA,GAAc,YAAA","file":"index.cjs","sourcesContent":["import * as React from \"react\";\nimport { cn } from \"@nucleux/utils\";\n\nexport interface ActionPlanStepProps\n  extends Omit<React.LiHTMLAttributes<HTMLLIElement>, \"title\"> {\n  /** Step title. */\n  title: React.ReactNode;\n  /** Supporting detail under the title. */\n  description?: React.ReactNode;\n}\n\n/** A single step in an {@link ActionPlan}. Numbered automatically by its order. */\nexport const ActionPlanStep = React.forwardRef<HTMLLIElement, ActionPlanStepProps>(\n  ({ title, description, className, ...props }, ref) => (\n    <li\n      ref={ref}\n      className={cn(\n        \"flex gap-3 [counter-increment:nx-step]\",\n        \"before:mt-0.5 before:inline-flex before:size-6 before:shrink-0 before:items-center before:justify-center before:rounded-full before:bg-muted before:text-xs before:font-semibold before:text-muted-foreground before:[content:counter(nx-step)]\",\n        className,\n      )}\n      {...props}\n    >\n      <span className=\"flex min-w-0 flex-1 flex-col gap-0.5\">\n        <span className=\"text-sm font-medium text-foreground\">{title}</span>\n        {description && <span className=\"text-xs text-muted-foreground\">{description}</span>}\n      </span>\n    </li>\n  ),\n);\nActionPlanStep.displayName = \"ActionPlanStep\";\n\nexport interface ActionPlanProps extends React.HTMLAttributes<HTMLDivElement> {\n  /** Heading, e.g. `\"Proposed plan\"`. */\n  heading?: React.ReactNode;\n  /** Short description of what the agent intends to do. */\n  description?: React.ReactNode;\n  /** Called when the plan is accepted. Renders the accept button when set. */\n  onAccept?: () => void;\n  /** Called when the user asks to edit the plan. Renders the edit button when set. */\n  onEdit?: () => void;\n  /** Called when the plan is rejected. Renders the reject button when set. */\n  onReject?: () => void;\n  acceptLabel?: React.ReactNode;\n  editLabel?: React.ReactNode;\n  rejectLabel?: React.ReactNode;\n}\n\n/**\n * A multi-step plan an agent proposes before executing — the user can accept,\n * edit, or reject it. Human-in-the-loop approval for autonomous work.\n * Source: Figma \"During Interaction / Action Plan\".\n */\nexport const ActionPlan = React.forwardRef<HTMLDivElement, ActionPlanProps>(\n  (\n    {\n      heading = \"Proposed plan\",\n      description,\n      onAccept,\n      onEdit,\n      onReject,\n      acceptLabel = \"Accept plan\",\n      editLabel = \"Edit plan\",\n      rejectLabel = \"Reject\",\n      className,\n      children,\n      ...props\n    },\n    ref,\n  ) => (\n    <div\n      ref={ref}\n      className={cn(\"flex flex-col gap-4 rounded-xl border border-border bg-background p-5\", className)}\n      {...props}\n    >\n      <div className=\"flex flex-col gap-1\">\n        {heading && <h3 className=\"text-sm font-semibold text-foreground\">{heading}</h3>}\n        {description && <p className=\"text-sm text-muted-foreground\">{description}</p>}\n      </div>\n      <ol className=\"flex flex-col gap-3 [counter-reset:nx-step]\">{children}</ol>\n      {(onAccept || onEdit || onReject) && (\n        <div className=\"flex flex-wrap items-center gap-2\">\n          {onAccept && (\n            <button\n              type=\"button\"\n              onClick={onAccept}\n              className=\"inline-flex items-center rounded-lg bg-info px-3 py-2 text-sm font-medium text-info-foreground transition-colors hover:bg-info/90 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring\"\n            >\n              {acceptLabel}\n            </button>\n          )}\n          {onEdit && (\n            <button\n              type=\"button\"\n              onClick={onEdit}\n              className=\"inline-flex items-center rounded-lg border border-border bg-background px-3 py-2 text-sm font-medium text-foreground transition-colors hover:bg-accent focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring\"\n            >\n              {editLabel}\n            </button>\n          )}\n          {onReject && (\n            <button\n              type=\"button\"\n              onClick={onReject}\n              className=\"ml-auto inline-flex items-center rounded-lg px-3 py-2 text-sm font-medium text-muted-foreground transition-colors hover:bg-accent hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring\"\n            >\n              {rejectLabel}\n            </button>\n          )}\n        </div>\n      )}\n    </div>\n  ),\n);\nActionPlan.displayName = \"ActionPlan\";\n"]}

package/dist/index.d.cts

@@ -0,0 +1,33 @@
+import * as React from 'react';
+
+interface ActionPlanStepProps extends Omit<React.LiHTMLAttributes<HTMLLIElement>, "title"> {
+    /** Step title. */
+    title: React.ReactNode;
+    /** Supporting detail under the title. */
+    description?: React.ReactNode;
+}
+/** A single step in an {@link ActionPlan}. Numbered automatically by its order. */
+declare const ActionPlanStep: React.ForwardRefExoticComponent<ActionPlanStepProps & React.RefAttributes<HTMLLIElement>>;
+interface ActionPlanProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Heading, e.g. `"Proposed plan"`. */
+    heading?: React.ReactNode;
+    /** Short description of what the agent intends to do. */
+    description?: React.ReactNode;
+    /** Called when the plan is accepted. Renders the accept button when set. */
+    onAccept?: () => void;
+    /** Called when the user asks to edit the plan. Renders the edit button when set. */
+    onEdit?: () => void;
+    /** Called when the plan is rejected. Renders the reject button when set. */
+    onReject?: () => void;
+    acceptLabel?: React.ReactNode;
+    editLabel?: React.ReactNode;
+    rejectLabel?: React.ReactNode;
+}
+/**
+ * A multi-step plan an agent proposes before executing — the user can accept,
+ * edit, or reject it. Human-in-the-loop approval for autonomous work.
+ * Source: Figma "During Interaction / Action Plan".
+ */
+declare const ActionPlan: React.ForwardRefExoticComponent<ActionPlanProps & React.RefAttributes<HTMLDivElement>>;
+
+export { ActionPlan, type ActionPlanProps, ActionPlanStep, type ActionPlanStepProps };

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+import * as React from 'react';
+
+interface ActionPlanStepProps extends Omit<React.LiHTMLAttributes<HTMLLIElement>, "title"> {
+    /** Step title. */
+    title: React.ReactNode;
+    /** Supporting detail under the title. */
+    description?: React.ReactNode;
+}
+/** A single step in an {@link ActionPlan}. Numbered automatically by its order. */
+declare const ActionPlanStep: React.ForwardRefExoticComponent<ActionPlanStepProps & React.RefAttributes<HTMLLIElement>>;
+interface ActionPlanProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Heading, e.g. `"Proposed plan"`. */
+    heading?: React.ReactNode;
+    /** Short description of what the agent intends to do. */
+    description?: React.ReactNode;
+    /** Called when the plan is accepted. Renders the accept button when set. */
+    onAccept?: () => void;
+    /** Called when the user asks to edit the plan. Renders the edit button when set. */
+    onEdit?: () => void;
+    /** Called when the plan is rejected. Renders the reject button when set. */
+    onReject?: () => void;
+    acceptLabel?: React.ReactNode;
+    editLabel?: React.ReactNode;
+    rejectLabel?: React.ReactNode;
+}
+/**
+ * A multi-step plan an agent proposes before executing — the user can accept,
+ * edit, or reject it. Human-in-the-loop approval for autonomous work.
+ * Source: Figma "During Interaction / Action Plan".
+ */
+declare const ActionPlan: React.ForwardRefExoticComponent<ActionPlanProps & React.RefAttributes<HTMLDivElement>>;
+
+export { ActionPlan, type ActionPlanProps, ActionPlanStep, type ActionPlanStepProps };

package/dist/index.js

@@ -0,0 +1,88 @@
+"use client";
+import * as React from 'react';
+import { cn } from '@nucleux/utils';
+import { jsx, jsxs } from 'react/jsx-runtime';
+
+// src/index.tsx
+var ActionPlanStep = React.forwardRef(
+  ({ title, description, className, ...props }, ref) => /* @__PURE__ */ jsx(
+    "li",
+    {
+      ref,
+      className: cn(
+        "flex gap-3 [counter-increment:nx-step]",
+        "before:mt-0.5 before:inline-flex before:size-6 before:shrink-0 before:items-center before:justify-center before:rounded-full before:bg-muted before:text-xs before:font-semibold before:text-muted-foreground before:[content:counter(nx-step)]",
+        className
+      ),
+      ...props,
+      children: /* @__PURE__ */ jsxs("span", { className: "flex min-w-0 flex-1 flex-col gap-0.5", children: [
+        /* @__PURE__ */ jsx("span", { className: "text-sm font-medium text-foreground", children: title }),
+        description && /* @__PURE__ */ jsx("span", { className: "text-xs text-muted-foreground", children: description })
+      ] })
+    }
+  )
+);
+ActionPlanStep.displayName = "ActionPlanStep";
+var ActionPlan = React.forwardRef(
+  ({
+    heading = "Proposed plan",
+    description,
+    onAccept,
+    onEdit,
+    onReject,
+    acceptLabel = "Accept plan",
+    editLabel = "Edit plan",
+    rejectLabel = "Reject",
+    className,
+    children,
+    ...props
+  }, ref) => /* @__PURE__ */ jsxs(
+    "div",
+    {
+      ref,
+      className: cn("flex flex-col gap-4 rounded-xl border border-border bg-background p-5", className),
+      ...props,
+      children: [
+        /* @__PURE__ */ jsxs("div", { className: "flex flex-col gap-1", children: [
+          heading && /* @__PURE__ */ jsx("h3", { className: "text-sm font-semibold text-foreground", children: heading }),
+          description && /* @__PURE__ */ jsx("p", { className: "text-sm text-muted-foreground", children: description })
+        ] }),
+        /* @__PURE__ */ jsx("ol", { className: "flex flex-col gap-3 [counter-reset:nx-step]", children }),
+        (onAccept || onEdit || onReject) && /* @__PURE__ */ jsxs("div", { className: "flex flex-wrap items-center gap-2", children: [
+          onAccept && /* @__PURE__ */ jsx(
+            "button",
+            {
+              type: "button",
+              onClick: onAccept,
+              className: "inline-flex items-center rounded-lg bg-info px-3 py-2 text-sm font-medium text-info-foreground transition-colors hover:bg-info/90 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring",
+              children: acceptLabel
+            }
+          ),
+          onEdit && /* @__PURE__ */ jsx(
+            "button",
+            {
+              type: "button",
+              onClick: onEdit,
+              className: "inline-flex items-center rounded-lg border border-border bg-background px-3 py-2 text-sm font-medium text-foreground transition-colors hover:bg-accent focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring",
+              children: editLabel
+            }
+          ),
+          onReject && /* @__PURE__ */ jsx(
+            "button",
+            {
+              type: "button",
+              onClick: onReject,
+              className: "ml-auto inline-flex items-center rounded-lg px-3 py-2 text-sm font-medium text-muted-foreground transition-colors hover:bg-accent hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring",
+              children: rejectLabel
+            }
+          )
+        ] })
+      ]
+    }
+  )
+);
+ActionPlan.displayName = "ActionPlan";
+
+export { ActionPlan, ActionPlanStep };
+//# 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,cAAA,GAAuB,KAAA,CAAA,UAAA;AAAA,EAClC,CAAC,EAAE,KAAA,EAAO,WAAA,EAAa,WAAW,GAAG,KAAA,IAAS,GAAA,qBAC5C,GAAA;AAAA,IAAC,IAAA;AAAA,IAAA;AAAA,MACC,GAAA;AAAA,MACA,SAAA,EAAW,EAAA;AAAA,QACT,wCAAA;AAAA,QACA,iPAAA;AAAA,QACA;AAAA,OACF;AAAA,MACC,GAAG,KAAA;AAAA,MAEJ,QAAA,kBAAA,IAAA,CAAC,MAAA,EAAA,EAAK,SAAA,EAAU,sCAAA,EACd,QAAA,EAAA;AAAA,wBAAA,GAAA,CAAC,MAAA,EAAA,EAAK,SAAA,EAAU,qCAAA,EAAuC,QAAA,EAAA,KAAA,EAAM,CAAA;AAAA,QAC5D,WAAA,oBAAe,GAAA,CAAC,MAAA,EAAA,EAAK,SAAA,EAAU,iCAAiC,QAAA,EAAA,WAAA,EAAY;AAAA,OAAA,EAC/E;AAAA;AAAA;AAGN;AACA,cAAA,CAAe,WAAA,GAAc,gBAAA;AAuBtB,IAAM,UAAA,GAAmB,KAAA,CAAA,UAAA;AAAA,EAC9B,CACE;AAAA,IACE,OAAA,GAAU,eAAA;AAAA,IACV,WAAA;AAAA,IACA,QAAA;AAAA,IACA,MAAA;AAAA,IACA,QAAA;AAAA,IACA,WAAA,GAAc,aAAA;AAAA,IACd,SAAA,GAAY,WAAA;AAAA,IACZ,WAAA,GAAc,QAAA;AAAA,IACd,SAAA;AAAA,IACA,QAAA;AAAA,IACA,GAAG;AAAA,KAEL,GAAA,qBAEA,IAAA;AAAA,IAAC,KAAA;AAAA,IAAA;AAAA,MACC,GAAA;AAAA,MACA,SAAA,EAAW,EAAA,CAAG,uEAAA,EAAyE,SAAS,CAAA;AAAA,MAC/F,GAAG,KAAA;AAAA,MAEJ,QAAA,EAAA;AAAA,wBAAA,IAAA,CAAC,KAAA,EAAA,EAAI,WAAU,qBAAA,EACZ,QAAA,EAAA;AAAA,UAAA,OAAA,oBAAW,GAAA,CAAC,IAAA,EAAA,EAAG,SAAA,EAAU,uCAAA,EAAyC,QAAA,EAAA,OAAA,EAAQ,CAAA;AAAA,UAC1E,WAAA,oBAAe,GAAA,CAAC,GAAA,EAAA,EAAE,SAAA,EAAU,iCAAiC,QAAA,EAAA,WAAA,EAAY;AAAA,SAAA,EAC5E,CAAA;AAAA,wBACA,GAAA,CAAC,IAAA,EAAA,EAAG,SAAA,EAAU,6CAAA,EAA+C,QAAA,EAAS,CAAA;AAAA,QAAA,CACpE,YAAY,MAAA,IAAU,QAAA,qBACtB,IAAA,CAAC,KAAA,EAAA,EAAI,WAAU,mCAAA,EACZ,QAAA,EAAA;AAAA,UAAA,QAAA,oBACC,GAAA;AAAA,YAAC,QAAA;AAAA,YAAA;AAAA,cACC,IAAA,EAAK,QAAA;AAAA,cACL,OAAA,EAAS,QAAA;AAAA,cACT,SAAA,EAAU,2MAAA;AAAA,cAET,QAAA,EAAA;AAAA;AAAA,WACH;AAAA,UAED,MAAA,oBACC,GAAA;AAAA,YAAC,QAAA;AAAA,YAAA;AAAA,cACC,IAAA,EAAK,QAAA;AAAA,cACL,OAAA,EAAS,MAAA;AAAA,cACT,SAAA,EAAU,gOAAA;AAAA,cAET,QAAA,EAAA;AAAA;AAAA,WACH;AAAA,UAED,QAAA,oBACC,GAAA;AAAA,YAAC,QAAA;AAAA,YAAA;AAAA,cACC,IAAA,EAAK,QAAA;AAAA,cACL,OAAA,EAAS,QAAA;AAAA,cACT,SAAA,EAAU,iOAAA;AAAA,cAET,QAAA,EAAA;AAAA;AAAA;AACH,SAAA,EAEJ;AAAA;AAAA;AAAA;AAIR;AACA,UAAA,CAAW,WAAA,GAAc,YAAA","file":"index.js","sourcesContent":["import * as React from \"react\";\nimport { cn } from \"@nucleux/utils\";\n\nexport interface ActionPlanStepProps\n  extends Omit<React.LiHTMLAttributes<HTMLLIElement>, \"title\"> {\n  /** Step title. */\n  title: React.ReactNode;\n  /** Supporting detail under the title. */\n  description?: React.ReactNode;\n}\n\n/** A single step in an {@link ActionPlan}. Numbered automatically by its order. */\nexport const ActionPlanStep = React.forwardRef<HTMLLIElement, ActionPlanStepProps>(\n  ({ title, description, className, ...props }, ref) => (\n    <li\n      ref={ref}\n      className={cn(\n        \"flex gap-3 [counter-increment:nx-step]\",\n        \"before:mt-0.5 before:inline-flex before:size-6 before:shrink-0 before:items-center before:justify-center before:rounded-full before:bg-muted before:text-xs before:font-semibold before:text-muted-foreground before:[content:counter(nx-step)]\",\n        className,\n      )}\n      {...props}\n    >\n      <span className=\"flex min-w-0 flex-1 flex-col gap-0.5\">\n        <span className=\"text-sm font-medium text-foreground\">{title}</span>\n        {description && <span className=\"text-xs text-muted-foreground\">{description}</span>}\n      </span>\n    </li>\n  ),\n);\nActionPlanStep.displayName = \"ActionPlanStep\";\n\nexport interface ActionPlanProps extends React.HTMLAttributes<HTMLDivElement> {\n  /** Heading, e.g. `\"Proposed plan\"`. */\n  heading?: React.ReactNode;\n  /** Short description of what the agent intends to do. */\n  description?: React.ReactNode;\n  /** Called when the plan is accepted. Renders the accept button when set. */\n  onAccept?: () => void;\n  /** Called when the user asks to edit the plan. Renders the edit button when set. */\n  onEdit?: () => void;\n  /** Called when the plan is rejected. Renders the reject button when set. */\n  onReject?: () => void;\n  acceptLabel?: React.ReactNode;\n  editLabel?: React.ReactNode;\n  rejectLabel?: React.ReactNode;\n}\n\n/**\n * A multi-step plan an agent proposes before executing — the user can accept,\n * edit, or reject it. Human-in-the-loop approval for autonomous work.\n * Source: Figma \"During Interaction / Action Plan\".\n */\nexport const ActionPlan = React.forwardRef<HTMLDivElement, ActionPlanProps>(\n  (\n    {\n      heading = \"Proposed plan\",\n      description,\n      onAccept,\n      onEdit,\n      onReject,\n      acceptLabel = \"Accept plan\",\n      editLabel = \"Edit plan\",\n      rejectLabel = \"Reject\",\n      className,\n      children,\n      ...props\n    },\n    ref,\n  ) => (\n    <div\n      ref={ref}\n      className={cn(\"flex flex-col gap-4 rounded-xl border border-border bg-background p-5\", className)}\n      {...props}\n    >\n      <div className=\"flex flex-col gap-1\">\n        {heading && <h3 className=\"text-sm font-semibold text-foreground\">{heading}</h3>}\n        {description && <p className=\"text-sm text-muted-foreground\">{description}</p>}\n      </div>\n      <ol className=\"flex flex-col gap-3 [counter-reset:nx-step]\">{children}</ol>\n      {(onAccept || onEdit || onReject) && (\n        <div className=\"flex flex-wrap items-center gap-2\">\n          {onAccept && (\n            <button\n              type=\"button\"\n              onClick={onAccept}\n              className=\"inline-flex items-center rounded-lg bg-info px-3 py-2 text-sm font-medium text-info-foreground transition-colors hover:bg-info/90 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring\"\n            >\n              {acceptLabel}\n            </button>\n          )}\n          {onEdit && (\n            <button\n              type=\"button\"\n              onClick={onEdit}\n              className=\"inline-flex items-center rounded-lg border border-border bg-background px-3 py-2 text-sm font-medium text-foreground transition-colors hover:bg-accent focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring\"\n            >\n              {editLabel}\n            </button>\n          )}\n          {onReject && (\n            <button\n              type=\"button\"\n              onClick={onReject}\n              className=\"ml-auto inline-flex items-center rounded-lg px-3 py-2 text-sm font-medium text-muted-foreground transition-colors hover:bg-accent hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring\"\n            >\n              {rejectLabel}\n            </button>\n          )}\n        </div>\n      )}\n    </div>\n  ),\n);\nActionPlan.displayName = \"ActionPlan\";\n"]}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@nucleux/action-plan",
+  "version": "0.1.1",
+  "type": "module",
+  "sideEffects": false,
+  "description": "ActionPlan — a proposed agent plan the user can accept, edit, or reject — Nucleux agentic UI for React.",
+  "keywords": [
+    "nucleux",
+    "react",
+    "ui",
+    "components",
+    "agentic",
+    "ai",
+    "tailwind",
+    "action-plan"
+  ],
+  "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/action-plan"
+  },
+  "homepage": "https://github.com/intelligaia-open-labs/nucleux#readme",
+  "scripts": {
+    "build": "tsup"
+  }
+}