@nucleux/audio-message 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/audio-message
+
+AudioMessage — a player for AI-generated voice output — 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/audio-message @nucleux/tokens
+```
+
+`react` / `react-dom` are peer dependencies.
+
+## Usage
+
+```tsx
+import { AudioMessage } from "@nucleux/audio-message";
+```
+
+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,73 @@
+"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 BARS = [40, 70, 55, 90, 60, 35, 75, 50, 85, 45, 65, 30, 80, 55, 70, 40, 60, 50];
+var AudioMessage = React__namespace.forwardRef(
+  ({ playing = false, duration, transcript, onPlayToggle, className, ...props }, ref) => /* @__PURE__ */ jsxRuntime.jsxs(
+    "div",
+    {
+      ref,
+      className: utils.cn("flex flex-col gap-2 rounded-xl border border-border bg-background p-3", className),
+      ...props,
+      children: [
+        /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-center gap-3", children: [
+          /* @__PURE__ */ jsxRuntime.jsx(
+            "button",
+            {
+              type: "button",
+              "aria-label": playing ? "Pause" : "Play",
+              "aria-pressed": playing,
+              onClick: onPlayToggle,
+              className: "inline-flex size-9 shrink-0 items-center justify-center rounded-full bg-info text-info-foreground transition-colors hover:bg-info/90 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring [&_svg]:size-4",
+              children: playing ? /* @__PURE__ */ jsxRuntime.jsx(lucideReact.Pause, { "aria-hidden": "true" }) : /* @__PURE__ */ jsxRuntime.jsx(lucideReact.Play, { "aria-hidden": "true" })
+            }
+          ),
+          /* @__PURE__ */ jsxRuntime.jsx("div", { className: "flex h-8 flex-1 items-center gap-0.5", "aria-hidden": "true", children: BARS.map((h, i) => /* @__PURE__ */ jsxRuntime.jsx(
+            "span",
+            {
+              className: utils.cn(
+                "w-1 flex-1 rounded-full bg-info/60",
+                playing && "animate-nx-typing"
+              ),
+              style: { height: `${h}%`, animationDelay: `${i % 6 * 90}ms` }
+            },
+            i
+          )) }),
+          duration && /* @__PURE__ */ jsxRuntime.jsx("span", { className: "shrink-0 text-xs tabular-nums text-muted-foreground", children: duration })
+        ] }),
+        transcript && /* @__PURE__ */ jsxRuntime.jsx("p", { className: "text-sm leading-relaxed text-muted-foreground", children: transcript })
+      ]
+    }
+  )
+);
+AudioMessage.displayName = "AudioMessage";
+
+exports.AudioMessage = AudioMessage;
+//# 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","Pause","Play"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAeA,IAAM,OAAO,CAAC,EAAA,EAAI,IAAI,EAAA,EAAI,EAAA,EAAI,IAAI,EAAA,EAAI,EAAA,EAAI,IAAI,EAAA,EAAI,EAAA,EAAI,IAAI,EAAA,EAAI,EAAA,EAAI,IAAI,EAAA,EAAI,EAAA,EAAI,IAAI,EAAE,CAAA;AAO7E,IAAM,YAAA,GAAqBA,gBAAA,CAAA,UAAA;AAAA,EAChC,CAAC,EAAE,OAAA,GAAU,KAAA,EAAO,QAAA,EAAU,UAAA,EAAY,YAAA,EAAc,SAAA,EAAW,GAAG,KAAA,EAAM,EAAG,GAAA,qBAC7EC,eAAA;AAAA,IAAC,KAAA;AAAA,IAAA;AAAA,MACC,GAAA;AAAA,MACA,SAAA,EAAWC,QAAA,CAAG,uEAAA,EAAyE,SAAS,CAAA;AAAA,MAC/F,GAAG,KAAA;AAAA,MAEJ,QAAA,EAAA;AAAA,wBAAAD,eAAA,CAAC,KAAA,EAAA,EAAI,WAAU,yBAAA,EACb,QAAA,EAAA;AAAA,0BAAAE,cAAA;AAAA,YAAC,QAAA;AAAA,YAAA;AAAA,cACC,IAAA,EAAK,QAAA;AAAA,cACL,YAAA,EAAY,UAAU,OAAA,GAAU,MAAA;AAAA,cAChC,cAAA,EAAc,OAAA;AAAA,cACd,OAAA,EAAS,YAAA;AAAA,cACT,SAAA,EAAU,6NAAA;AAAA,cAET,QAAA,EAAA,OAAA,kCAAWC,iBAAA,EAAA,EAAM,aAAA,EAAY,QAAO,CAAA,mBAAKD,cAAA,CAACE,gBAAA,EAAA,EAAK,aAAA,EAAY,MAAA,EAAO;AAAA;AAAA,WACrE;AAAA,0BACAF,cAAA,CAAC,KAAA,EAAA,EAAI,SAAA,EAAU,sCAAA,EAAuC,aAAA,EAAY,QAC/D,QAAA,EAAA,IAAA,CAAK,GAAA,CAAI,CAAC,CAAA,EAAG,CAAA,qBACZA,cAAA;AAAA,YAAC,MAAA;AAAA,YAAA;AAAA,cAEC,SAAA,EAAWD,QAAA;AAAA,gBACT,oCAAA;AAAA,gBACA,OAAA,IAAW;AAAA,eACb;AAAA,cACA,KAAA,EAAO,EAAE,MAAA,EAAQ,CAAA,EAAG,CAAC,CAAA,CAAA,CAAA,EAAK,cAAA,EAAgB,CAAA,EAAI,CAAA,GAAI,CAAA,GAAK,EAAE,CAAA,EAAA,CAAA;AAAK,aAAA;AAAA,YALzD;AAAA,WAOR,CAAA,EACH,CAAA;AAAA,UACC,QAAA,oBAAYC,cAAA,CAAC,MAAA,EAAA,EAAK,SAAA,EAAU,uDAAuD,QAAA,EAAA,QAAA,EAAS;AAAA,SAAA,EAC/F,CAAA;AAAA,QACC,UAAA,oBAAcA,cAAA,CAAC,GAAA,EAAA,EAAE,SAAA,EAAU,iDAAiD,QAAA,EAAA,UAAA,EAAW;AAAA;AAAA;AAAA;AAG9F;AACA,YAAA,CAAa,WAAA,GAAc,cAAA","file":"index.cjs","sourcesContent":["import * as React from \"react\";\nimport { cn } from \"@nucleux/utils\";\nimport { Play, Pause } from \"lucide-react\";\n\nexport interface AudioMessageProps extends React.HTMLAttributes<HTMLDivElement> {\n  /** Whether audio is currently playing (controls the play/pause glyph + animation). */\n  playing?: boolean;\n  /** Duration or elapsed label, e.g. `\"0:42\"`. */\n  duration?: React.ReactNode;\n  /** Transcript excerpt shown below the player. */\n  transcript?: React.ReactNode;\n  /** Called when the play/pause control is used. */\n  onPlayToggle?: () => void;\n}\n\nconst BARS = [40, 70, 55, 90, 60, 35, 75, 50, 85, 45, 65, 30, 80, 55, 70, 40, 60, 50];\n\n/**\n * A player for AI-generated spoken output — play/pause, a waveform, duration,\n * and an optional transcript.\n * Source: Figma \"Output & Processing / Audio player output\".\n */\nexport const AudioMessage = React.forwardRef<HTMLDivElement, AudioMessageProps>(\n  ({ playing = false, duration, transcript, onPlayToggle, className, ...props }, ref) => (\n    <div\n      ref={ref}\n      className={cn(\"flex flex-col gap-2 rounded-xl border border-border bg-background p-3\", className)}\n      {...props}\n    >\n      <div className=\"flex items-center gap-3\">\n        <button\n          type=\"button\"\n          aria-label={playing ? \"Pause\" : \"Play\"}\n          aria-pressed={playing}\n          onClick={onPlayToggle}\n          className=\"inline-flex size-9 shrink-0 items-center justify-center rounded-full bg-info text-info-foreground transition-colors hover:bg-info/90 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring [&_svg]:size-4\"\n        >\n          {playing ? <Pause aria-hidden=\"true\" /> : <Play aria-hidden=\"true\" />}\n        </button>\n        <div className=\"flex h-8 flex-1 items-center gap-0.5\" aria-hidden=\"true\">\n          {BARS.map((h, i) => (\n            <span\n              key={i}\n              className={cn(\n                \"w-1 flex-1 rounded-full bg-info/60\",\n                playing && \"animate-nx-typing\",\n              )}\n              style={{ height: `${h}%`, animationDelay: `${(i % 6) * 90}ms` }}\n            />\n          ))}\n        </div>\n        {duration && <span className=\"shrink-0 text-xs tabular-nums text-muted-foreground\">{duration}</span>}\n      </div>\n      {transcript && <p className=\"text-sm leading-relaxed text-muted-foreground\">{transcript}</p>}\n    </div>\n  ),\n);\nAudioMessage.displayName = \"AudioMessage\";\n"]}

package/dist/index.d.cts

@@ -0,0 +1,20 @@
+import * as React from 'react';
+
+interface AudioMessageProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Whether audio is currently playing (controls the play/pause glyph + animation). */
+    playing?: boolean;
+    /** Duration or elapsed label, e.g. `"0:42"`. */
+    duration?: React.ReactNode;
+    /** Transcript excerpt shown below the player. */
+    transcript?: React.ReactNode;
+    /** Called when the play/pause control is used. */
+    onPlayToggle?: () => void;
+}
+/**
+ * A player for AI-generated spoken output — play/pause, a waveform, duration,
+ * and an optional transcript.
+ * Source: Figma "Output & Processing / Audio player output".
+ */
+declare const AudioMessage: React.ForwardRefExoticComponent<AudioMessageProps & React.RefAttributes<HTMLDivElement>>;
+
+export { AudioMessage, type AudioMessageProps };

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+import * as React from 'react';
+
+interface AudioMessageProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Whether audio is currently playing (controls the play/pause glyph + animation). */
+    playing?: boolean;
+    /** Duration or elapsed label, e.g. `"0:42"`. */
+    duration?: React.ReactNode;
+    /** Transcript excerpt shown below the player. */
+    transcript?: React.ReactNode;
+    /** Called when the play/pause control is used. */
+    onPlayToggle?: () => void;
+}
+/**
+ * A player for AI-generated spoken output — play/pause, a waveform, duration,
+ * and an optional transcript.
+ * Source: Figma "Output & Processing / Audio player output".
+ */
+declare const AudioMessage: React.ForwardRefExoticComponent<AudioMessageProps & React.RefAttributes<HTMLDivElement>>;
+
+export { AudioMessage, type AudioMessageProps };

package/dist/index.js

@@ -0,0 +1,51 @@
+"use client";
+import * as React from 'react';
+import { cn } from '@nucleux/utils';
+import { Pause, Play } from 'lucide-react';
+import { jsxs, jsx } from 'react/jsx-runtime';
+
+// src/index.tsx
+var BARS = [40, 70, 55, 90, 60, 35, 75, 50, 85, 45, 65, 30, 80, 55, 70, 40, 60, 50];
+var AudioMessage = React.forwardRef(
+  ({ playing = false, duration, transcript, onPlayToggle, className, ...props }, ref) => /* @__PURE__ */ jsxs(
+    "div",
+    {
+      ref,
+      className: cn("flex flex-col gap-2 rounded-xl border border-border bg-background p-3", className),
+      ...props,
+      children: [
+        /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-3", children: [
+          /* @__PURE__ */ jsx(
+            "button",
+            {
+              type: "button",
+              "aria-label": playing ? "Pause" : "Play",
+              "aria-pressed": playing,
+              onClick: onPlayToggle,
+              className: "inline-flex size-9 shrink-0 items-center justify-center rounded-full bg-info text-info-foreground transition-colors hover:bg-info/90 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring [&_svg]:size-4",
+              children: playing ? /* @__PURE__ */ jsx(Pause, { "aria-hidden": "true" }) : /* @__PURE__ */ jsx(Play, { "aria-hidden": "true" })
+            }
+          ),
+          /* @__PURE__ */ jsx("div", { className: "flex h-8 flex-1 items-center gap-0.5", "aria-hidden": "true", children: BARS.map((h, i) => /* @__PURE__ */ jsx(
+            "span",
+            {
+              className: cn(
+                "w-1 flex-1 rounded-full bg-info/60",
+                playing && "animate-nx-typing"
+              ),
+              style: { height: `${h}%`, animationDelay: `${i % 6 * 90}ms` }
+            },
+            i
+          )) }),
+          duration && /* @__PURE__ */ jsx("span", { className: "shrink-0 text-xs tabular-nums text-muted-foreground", children: duration })
+        ] }),
+        transcript && /* @__PURE__ */ jsx("p", { className: "text-sm leading-relaxed text-muted-foreground", children: transcript })
+      ]
+    }
+  )
+);
+AudioMessage.displayName = "AudioMessage";
+
+export { AudioMessage };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.tsx"],"names":[],"mappings":";;;;;;AAeA,IAAM,OAAO,CAAC,EAAA,EAAI,IAAI,EAAA,EAAI,EAAA,EAAI,IAAI,EAAA,EAAI,EAAA,EAAI,IAAI,EAAA,EAAI,EAAA,EAAI,IAAI,EAAA,EAAI,EAAA,EAAI,IAAI,EAAA,EAAI,EAAA,EAAI,IAAI,EAAE,CAAA;AAO7E,IAAM,YAAA,GAAqB,KAAA,CAAA,UAAA;AAAA,EAChC,CAAC,EAAE,OAAA,GAAU,KAAA,EAAO,QAAA,EAAU,UAAA,EAAY,YAAA,EAAc,SAAA,EAAW,GAAG,KAAA,EAAM,EAAG,GAAA,qBAC7E,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,yBAAA,EACb,QAAA,EAAA;AAAA,0BAAA,GAAA;AAAA,YAAC,QAAA;AAAA,YAAA;AAAA,cACC,IAAA,EAAK,QAAA;AAAA,cACL,YAAA,EAAY,UAAU,OAAA,GAAU,MAAA;AAAA,cAChC,cAAA,EAAc,OAAA;AAAA,cACd,OAAA,EAAS,YAAA;AAAA,cACT,SAAA,EAAU,6NAAA;AAAA,cAET,QAAA,EAAA,OAAA,uBAAW,KAAA,EAAA,EAAM,aAAA,EAAY,QAAO,CAAA,mBAAK,GAAA,CAAC,IAAA,EAAA,EAAK,aAAA,EAAY,MAAA,EAAO;AAAA;AAAA,WACrE;AAAA,0BACA,GAAA,CAAC,KAAA,EAAA,EAAI,SAAA,EAAU,sCAAA,EAAuC,aAAA,EAAY,QAC/D,QAAA,EAAA,IAAA,CAAK,GAAA,CAAI,CAAC,CAAA,EAAG,CAAA,qBACZ,GAAA;AAAA,YAAC,MAAA;AAAA,YAAA;AAAA,cAEC,SAAA,EAAW,EAAA;AAAA,gBACT,oCAAA;AAAA,gBACA,OAAA,IAAW;AAAA,eACb;AAAA,cACA,KAAA,EAAO,EAAE,MAAA,EAAQ,CAAA,EAAG,CAAC,CAAA,CAAA,CAAA,EAAK,cAAA,EAAgB,CAAA,EAAI,CAAA,GAAI,CAAA,GAAK,EAAE,CAAA,EAAA,CAAA;AAAK,aAAA;AAAA,YALzD;AAAA,WAOR,CAAA,EACH,CAAA;AAAA,UACC,QAAA,oBAAY,GAAA,CAAC,MAAA,EAAA,EAAK,SAAA,EAAU,uDAAuD,QAAA,EAAA,QAAA,EAAS;AAAA,SAAA,EAC/F,CAAA;AAAA,QACC,UAAA,oBAAc,GAAA,CAAC,GAAA,EAAA,EAAE,SAAA,EAAU,iDAAiD,QAAA,EAAA,UAAA,EAAW;AAAA;AAAA;AAAA;AAG9F;AACA,YAAA,CAAa,WAAA,GAAc,cAAA","file":"index.js","sourcesContent":["import * as React from \"react\";\nimport { cn } from \"@nucleux/utils\";\nimport { Play, Pause } from \"lucide-react\";\n\nexport interface AudioMessageProps extends React.HTMLAttributes<HTMLDivElement> {\n  /** Whether audio is currently playing (controls the play/pause glyph + animation). */\n  playing?: boolean;\n  /** Duration or elapsed label, e.g. `\"0:42\"`. */\n  duration?: React.ReactNode;\n  /** Transcript excerpt shown below the player. */\n  transcript?: React.ReactNode;\n  /** Called when the play/pause control is used. */\n  onPlayToggle?: () => void;\n}\n\nconst BARS = [40, 70, 55, 90, 60, 35, 75, 50, 85, 45, 65, 30, 80, 55, 70, 40, 60, 50];\n\n/**\n * A player for AI-generated spoken output — play/pause, a waveform, duration,\n * and an optional transcript.\n * Source: Figma \"Output & Processing / Audio player output\".\n */\nexport const AudioMessage = React.forwardRef<HTMLDivElement, AudioMessageProps>(\n  ({ playing = false, duration, transcript, onPlayToggle, className, ...props }, ref) => (\n    <div\n      ref={ref}\n      className={cn(\"flex flex-col gap-2 rounded-xl border border-border bg-background p-3\", className)}\n      {...props}\n    >\n      <div className=\"flex items-center gap-3\">\n        <button\n          type=\"button\"\n          aria-label={playing ? \"Pause\" : \"Play\"}\n          aria-pressed={playing}\n          onClick={onPlayToggle}\n          className=\"inline-flex size-9 shrink-0 items-center justify-center rounded-full bg-info text-info-foreground transition-colors hover:bg-info/90 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring [&_svg]:size-4\"\n        >\n          {playing ? <Pause aria-hidden=\"true\" /> : <Play aria-hidden=\"true\" />}\n        </button>\n        <div className=\"flex h-8 flex-1 items-center gap-0.5\" aria-hidden=\"true\">\n          {BARS.map((h, i) => (\n            <span\n              key={i}\n              className={cn(\n                \"w-1 flex-1 rounded-full bg-info/60\",\n                playing && \"animate-nx-typing\",\n              )}\n              style={{ height: `${h}%`, animationDelay: `${(i % 6) * 90}ms` }}\n            />\n          ))}\n        </div>\n        {duration && <span className=\"shrink-0 text-xs tabular-nums text-muted-foreground\">{duration}</span>}\n      </div>\n      {transcript && <p className=\"text-sm leading-relaxed text-muted-foreground\">{transcript}</p>}\n    </div>\n  ),\n);\nAudioMessage.displayName = \"AudioMessage\";\n"]}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@nucleux/audio-message",
+  "version": "0.1.1",
+  "type": "module",
+  "sideEffects": false,
+  "description": "AudioMessage — a player for AI-generated voice output — Nucleux agentic UI for React.",
+  "keywords": [
+    "nucleux",
+    "react",
+    "ui",
+    "components",
+    "agentic",
+    "ai",
+    "tailwind",
+    "audio-message"
+  ],
+  "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/audio-message"
+  },
+  "homepage": "https://github.com/intelligaia-open-labs/nucleux#readme",
+  "scripts": {
+    "build": "tsup"
+  }
+}