@nucleux/message-scroller 0.0.0-stage → 0.6.0

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

@@ -1,3 +1,26 @@
-# Temporary Holding Version
+# @nucleux/message-scroller
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Auto-scrolling chat transcript container — 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/message-scroller @nucleux/tokens
+```
+
+`react` / `react-dom` are peer dependencies.
+
+## Usage
+
+```tsx
+import { MessageScroller } from "@nucleux/message-scroller";
+```
+
+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,63 @@
+"use client";
+'use strict';
+
+var React = require('react');
+var lucideReact = require('lucide-react');
+var utils = require('@nucleux/utils');
+var hooks = require('@nucleux/hooks');
+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 MessageScroller = React__namespace.forwardRef(
+  ({ autoScrollKey, hideScrollButton = false, className, children, ...props }, _ref) => {
+    const { ref, pinned, scrollToBottom } = hooks.useAutoScroll({
+      dependency: autoScrollKey
+    });
+    return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "relative flex min-h-0 flex-1 flex-col", children: [
+      /* @__PURE__ */ jsxRuntime.jsx(
+        "div",
+        {
+          ref,
+          className: utils.cn("flex-1 space-y-4 overflow-y-auto scroll-smooth p-4", className),
+          ...props,
+          children
+        }
+      ),
+      !hideScrollButton && !pinned && /* @__PURE__ */ jsxRuntime.jsx(
+        "button",
+        {
+          type: "button",
+          onClick: () => scrollToBottom(),
+          "aria-label": "Scroll to latest",
+          className: "absolute bottom-4 left-1/2 -translate-x-1/2 inline-flex size-9 items-center justify-center rounded-full border border-border bg-background text-foreground shadow-md transition-transform hover:scale-105 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring animate-nx-fade-in",
+          children: /* @__PURE__ */ jsxRuntime.jsx(lucideReact.ArrowDown, { className: "size-4" })
+        }
+      )
+    ] });
+  }
+);
+MessageScroller.displayName = "MessageScroller";
+
+exports.MessageScroller = MessageScroller;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.tsx"],"names":["React","useAutoScroll","jsxs","jsx","cn","ArrowDown"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiBO,IAAM,eAAA,GAAwBA,gBAAA,CAAA,UAAA;AAAA,EACnC,CAAC,EAAE,aAAA,EAAe,gBAAA,GAAmB,KAAA,EAAO,WAAW,QAAA,EAAU,GAAG,KAAA,EAAM,EAAG,IAAA,KAAS;AACpF,IAAA,MAAM,EAAE,GAAA,EAAK,MAAA,EAAQ,cAAA,KAAmBC,mBAAA,CAA8B;AAAA,MACpE,UAAA,EAAY;AAAA,KACb,CAAA;AAED,IAAA,uBACEC,eAAA,CAAC,KAAA,EAAA,EAAI,SAAA,EAAU,uCAAA,EACb,QAAA,EAAA;AAAA,sBAAAC,cAAA;AAAA,QAAC,KAAA;AAAA,QAAA;AAAA,UACC,GAAA;AAAA,UACA,SAAA,EAAWC,QAAA,CAAG,oDAAA,EAAsD,SAAS,CAAA;AAAA,UAC5E,GAAG,KAAA;AAAA,UAEH;AAAA;AAAA,OACH;AAAA,MACC,CAAC,gBAAA,IAAoB,CAAC,MAAA,oBACrBD,cAAA;AAAA,QAAC,QAAA;AAAA,QAAA;AAAA,UACC,IAAA,EAAK,QAAA;AAAA,UACL,OAAA,EAAS,MAAM,cAAA,EAAe;AAAA,UAC9B,YAAA,EAAW,kBAAA;AAAA,UACX,SAAA,EAAU,sSAAA;AAAA,UAEV,QAAA,kBAAAA,cAAA,CAACE,qBAAA,EAAA,EAAU,SAAA,EAAU,QAAA,EAAS;AAAA;AAAA;AAChC,KAAA,EAEJ,CAAA;AAAA,EAEJ;AACF;AACA,eAAA,CAAgB,WAAA,GAAc,iBAAA","file":"index.cjs","sourcesContent":["import * as React from \"react\";\nimport { ArrowDown } from \"lucide-react\";\nimport { cn } from \"@nucleux/utils\";\nimport { useAutoScroll } from \"@nucleux/hooks\";\n\nexport interface MessageScrollerProps extends React.HTMLAttributes<HTMLDivElement> {\n  /** Change this whenever messages are added so the view re-pins to bottom. */\n  autoScrollKey?: unknown;\n  /** Disable the sticky \"scroll to bottom\" affordance. */\n  hideScrollButton?: boolean;\n}\n\n/**\n * Scrollable transcript container that keeps itself pinned to the newest\n * message while content streams, and surfaces a \"jump to latest\" button when\n * the user scrolls away.\n */\nexport const MessageScroller = React.forwardRef<HTMLDivElement, MessageScrollerProps>(\n  ({ autoScrollKey, hideScrollButton = false, className, children, ...props }, _ref) => {\n    const { ref, pinned, scrollToBottom } = useAutoScroll<HTMLDivElement>({\n      dependency: autoScrollKey,\n    });\n\n    return (\n      <div className=\"relative flex min-h-0 flex-1 flex-col\">\n        <div\n          ref={ref}\n          className={cn(\"flex-1 space-y-4 overflow-y-auto scroll-smooth p-4\", className)}\n          {...props}\n        >\n          {children}\n        </div>\n        {!hideScrollButton && !pinned && (\n          <button\n            type=\"button\"\n            onClick={() => scrollToBottom()}\n            aria-label=\"Scroll to latest\"\n            className=\"absolute bottom-4 left-1/2 -translate-x-1/2 inline-flex size-9 items-center justify-center rounded-full border border-border bg-background text-foreground shadow-md transition-transform hover:scale-105 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring animate-nx-fade-in\"\n          >\n            <ArrowDown className=\"size-4\" />\n          </button>\n        )}\n      </div>\n    );\n  },\n);\nMessageScroller.displayName = \"MessageScroller\";\n"]}

package/dist/index.d.cts

@@ -0,0 +1,16 @@
+import * as React from 'react';
+
+interface MessageScrollerProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Change this whenever messages are added so the view re-pins to bottom. */
+    autoScrollKey?: unknown;
+    /** Disable the sticky "scroll to bottom" affordance. */
+    hideScrollButton?: boolean;
+}
+/**
+ * Scrollable transcript container that keeps itself pinned to the newest
+ * message while content streams, and surfaces a "jump to latest" button when
+ * the user scrolls away.
+ */
+declare const MessageScroller: React.ForwardRefExoticComponent<MessageScrollerProps & React.RefAttributes<HTMLDivElement>>;
+
+export { MessageScroller, type MessageScrollerProps };

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+import * as React from 'react';
+
+interface MessageScrollerProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Change this whenever messages are added so the view re-pins to bottom. */
+    autoScrollKey?: unknown;
+    /** Disable the sticky "scroll to bottom" affordance. */
+    hideScrollButton?: boolean;
+}
+/**
+ * Scrollable transcript container that keeps itself pinned to the newest
+ * message while content streams, and surfaces a "jump to latest" button when
+ * the user scrolls away.
+ */
+declare const MessageScroller: React.ForwardRefExoticComponent<MessageScrollerProps & React.RefAttributes<HTMLDivElement>>;
+
+export { MessageScroller, type MessageScrollerProps };

package/dist/index.js

@@ -0,0 +1,41 @@
+"use client";
+import * as React from 'react';
+import { ArrowDown } from 'lucide-react';
+import { cn } from '@nucleux/utils';
+import { useAutoScroll } from '@nucleux/hooks';
+import { jsxs, jsx } from 'react/jsx-runtime';
+
+// src/index.tsx
+var MessageScroller = React.forwardRef(
+  ({ autoScrollKey, hideScrollButton = false, className, children, ...props }, _ref) => {
+    const { ref, pinned, scrollToBottom } = useAutoScroll({
+      dependency: autoScrollKey
+    });
+    return /* @__PURE__ */ jsxs("div", { className: "relative flex min-h-0 flex-1 flex-col", children: [
+      /* @__PURE__ */ jsx(
+        "div",
+        {
+          ref,
+          className: cn("flex-1 space-y-4 overflow-y-auto scroll-smooth p-4", className),
+          ...props,
+          children
+        }
+      ),
+      !hideScrollButton && !pinned && /* @__PURE__ */ jsx(
+        "button",
+        {
+          type: "button",
+          onClick: () => scrollToBottom(),
+          "aria-label": "Scroll to latest",
+          className: "absolute bottom-4 left-1/2 -translate-x-1/2 inline-flex size-9 items-center justify-center rounded-full border border-border bg-background text-foreground shadow-md transition-transform hover:scale-105 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring animate-nx-fade-in",
+          children: /* @__PURE__ */ jsx(ArrowDown, { className: "size-4" })
+        }
+      )
+    ] });
+  }
+);
+MessageScroller.displayName = "MessageScroller";
+
+export { MessageScroller };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.tsx"],"names":[],"mappings":";;;;;;;AAiBO,IAAM,eAAA,GAAwB,KAAA,CAAA,UAAA;AAAA,EACnC,CAAC,EAAE,aAAA,EAAe,gBAAA,GAAmB,KAAA,EAAO,WAAW,QAAA,EAAU,GAAG,KAAA,EAAM,EAAG,IAAA,KAAS;AACpF,IAAA,MAAM,EAAE,GAAA,EAAK,MAAA,EAAQ,cAAA,KAAmB,aAAA,CAA8B;AAAA,MACpE,UAAA,EAAY;AAAA,KACb,CAAA;AAED,IAAA,uBACE,IAAA,CAAC,KAAA,EAAA,EAAI,SAAA,EAAU,uCAAA,EACb,QAAA,EAAA;AAAA,sBAAA,GAAA;AAAA,QAAC,KAAA;AAAA,QAAA;AAAA,UACC,GAAA;AAAA,UACA,SAAA,EAAW,EAAA,CAAG,oDAAA,EAAsD,SAAS,CAAA;AAAA,UAC5E,GAAG,KAAA;AAAA,UAEH;AAAA;AAAA,OACH;AAAA,MACC,CAAC,gBAAA,IAAoB,CAAC,MAAA,oBACrB,GAAA;AAAA,QAAC,QAAA;AAAA,QAAA;AAAA,UACC,IAAA,EAAK,QAAA;AAAA,UACL,OAAA,EAAS,MAAM,cAAA,EAAe;AAAA,UAC9B,YAAA,EAAW,kBAAA;AAAA,UACX,SAAA,EAAU,sSAAA;AAAA,UAEV,QAAA,kBAAA,GAAA,CAAC,SAAA,EAAA,EAAU,SAAA,EAAU,QAAA,EAAS;AAAA;AAAA;AAChC,KAAA,EAEJ,CAAA;AAAA,EAEJ;AACF;AACA,eAAA,CAAgB,WAAA,GAAc,iBAAA","file":"index.js","sourcesContent":["import * as React from \"react\";\nimport { ArrowDown } from \"lucide-react\";\nimport { cn } from \"@nucleux/utils\";\nimport { useAutoScroll } from \"@nucleux/hooks\";\n\nexport interface MessageScrollerProps extends React.HTMLAttributes<HTMLDivElement> {\n  /** Change this whenever messages are added so the view re-pins to bottom. */\n  autoScrollKey?: unknown;\n  /** Disable the sticky \"scroll to bottom\" affordance. */\n  hideScrollButton?: boolean;\n}\n\n/**\n * Scrollable transcript container that keeps itself pinned to the newest\n * message while content streams, and surfaces a \"jump to latest\" button when\n * the user scrolls away.\n */\nexport const MessageScroller = React.forwardRef<HTMLDivElement, MessageScrollerProps>(\n  ({ autoScrollKey, hideScrollButton = false, className, children, ...props }, _ref) => {\n    const { ref, pinned, scrollToBottom } = useAutoScroll<HTMLDivElement>({\n      dependency: autoScrollKey,\n    });\n\n    return (\n      <div className=\"relative flex min-h-0 flex-1 flex-col\">\n        <div\n          ref={ref}\n          className={cn(\"flex-1 space-y-4 overflow-y-auto scroll-smooth p-4\", className)}\n          {...props}\n        >\n          {children}\n        </div>\n        {!hideScrollButton && !pinned && (\n          <button\n            type=\"button\"\n            onClick={() => scrollToBottom()}\n            aria-label=\"Scroll to latest\"\n            className=\"absolute bottom-4 left-1/2 -translate-x-1/2 inline-flex size-9 items-center justify-center rounded-full border border-border bg-background text-foreground shadow-md transition-transform hover:scale-105 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring animate-nx-fade-in\"\n          >\n            <ArrowDown className=\"size-4\" />\n          </button>\n        )}\n      </div>\n    );\n  },\n);\nMessageScroller.displayName = \"MessageScroller\";\n"]}

package/package.json

@@ -1,6 +1,59 @@
 {
   "name": "@nucleux/message-scroller",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.6.0",
+  "type": "module",
+  "sideEffects": false,
+  "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": {
+    "@nucleux/hooks": "0.6.0",
+    "@nucleux/utils": "0.6.0",
+    "lucide-react": "^0.469.0"
+  },
+  "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/message-scroller"
+  },
+  "homepage": "https://github.com/intelligaia-open-labs/nucleux#readme",
+  "description": "Auto-scrolling message list container — Nucleux agentic UI for React.",
+  "keywords": [
+    "nucleux",
+    "react",
+    "ui",
+    "components",
+    "agentic",
+    "ai",
+    "tailwind",
+    "message-scroller"
+  ],
+  "scripts": {
+    "build": "tsup"
+  }
 }