@wingmanjs/react 0.1.1 → 1.0.0

package/dist/hooks/use-auto-scroll.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Hook that auto-scrolls a container to the bottom as new content streams in.
+ *
+ * Works with both shadcn ScrollArea (data-slot="scroll-area-viewport") and
+ * plain scrollable divs. Respects the user's scroll position — if they've
+ * scrolled up to read history, auto-scroll pauses until they scroll back
+ * near the bottom.
+ *
+ * @param deps - Reactive values that trigger a scroll check (e.g., messages, streaming content)
+ * @param threshold - Pixels from bottom to consider "at bottom" (default: 80)
+ * @returns ref to attach to the scroll container (or its wrapper)
+ *
+ * @example
+ * ```tsx
+ * const scrollRef = useAutoScroll([messages, streamingContent], 80);
+ * return <ScrollArea ref={scrollRef}>...</ScrollArea>;
+ * ```
+ */
+export declare function useAutoScroll<T extends HTMLElement = HTMLDivElement>(deps: unknown[], threshold?: number): import("react").RefObject<T | null>;
+//# sourceMappingURL=use-auto-scroll.d.ts.map

package/dist/hooks/use-auto-scroll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-auto-scroll.d.ts","sourceRoot":"","sources":["../../src/hooks/use-auto-scroll.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,WAAW,GAAG,cAAc,EAClE,IAAI,EAAE,OAAO,EAAE,EACf,SAAS,SAAK,uCA0Cf"}

package/dist/hooks/use-auto-scroll.js

@@ -0,0 +1,58 @@
+import { useEffect, useRef, useCallback } from 'react';
+/**
+ * Hook that auto-scrolls a container to the bottom as new content streams in.
+ *
+ * Works with both shadcn ScrollArea (data-slot="scroll-area-viewport") and
+ * plain scrollable divs. Respects the user's scroll position — if they've
+ * scrolled up to read history, auto-scroll pauses until they scroll back
+ * near the bottom.
+ *
+ * @param deps - Reactive values that trigger a scroll check (e.g., messages, streaming content)
+ * @param threshold - Pixels from bottom to consider "at bottom" (default: 80)
+ * @returns ref to attach to the scroll container (or its wrapper)
+ *
+ * @example
+ * ```tsx
+ * const scrollRef = useAutoScroll([messages, streamingContent], 80);
+ * return <ScrollArea ref={scrollRef}>...</ScrollArea>;
+ * ```
+ */
+export function useAutoScroll(deps, threshold = 80) {
+    const containerRef = useRef(null);
+    const isUserScrolledUp = useRef(false);
+    // Resolve the actual scrollable element (handles shadcn ScrollArea wrapper)
+    const getScrollEl = useCallback(() => {
+        const el = containerRef.current;
+        if (!el)
+            return null;
+        // shadcn ScrollArea wraps the viewport in [data-slot="scroll-area-viewport"]
+        return el.querySelector('[data-slot="scroll-area-viewport"]') ?? el;
+    }, []);
+    // Track whether the user has scrolled away from the bottom
+    useEffect(() => {
+        const scrollEl = getScrollEl();
+        if (!scrollEl)
+            return;
+        const handleScroll = () => {
+            const { scrollTop, scrollHeight, clientHeight } = scrollEl;
+            const distanceFromBottom = scrollHeight - scrollTop - clientHeight;
+            isUserScrolledUp.current = distanceFromBottom > threshold;
+        };
+        scrollEl.addEventListener('scroll', handleScroll, { passive: true });
+        return () => scrollEl.removeEventListener('scroll', handleScroll);
+    }, [getScrollEl, threshold]);
+    // Auto-scroll when deps change, unless user has scrolled up
+    useEffect(() => {
+        if (isUserScrolledUp.current)
+            return;
+        const scrollEl = getScrollEl();
+        if (!scrollEl)
+            return;
+        // Use requestAnimationFrame for scroll after DOM paint
+        requestAnimationFrame(() => {
+            scrollEl.scrollTop = scrollEl.scrollHeight;
+        });
+    }, deps); // eslint-disable-line react-hooks/exhaustive-deps
+    return containerRef;
+}
+//# sourceMappingURL=use-auto-scroll.js.map

package/dist/hooks/use-auto-scroll.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-auto-scroll.js","sourceRoot":"","sources":["../../src/hooks/use-auto-scroll.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAEvD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAe,EACf,SAAS,GAAG,EAAE;IAEd,MAAM,YAAY,GAAG,MAAM,CAAI,IAAI,CAAC,CAAC;IACrC,MAAM,gBAAgB,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAEvC,4EAA4E;IAC5E,MAAM,WAAW,GAAG,WAAW,CAAC,GAAuB,EAAE;QACvD,MAAM,EAAE,GAAG,YAAY,CAAC,OAAO,CAAC;QAChC,IAAI,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC;QACrB,6EAA6E;QAC7E,OAAO,EAAE,CAAC,aAAa,CAAc,oCAAoC,CAAC,IAAI,EAAE,CAAC;IACnF,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,2DAA2D;IAC3D,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;QAC/B,IAAI,CAAC,QAAQ;YAAE,OAAO;QAEtB,MAAM,YAAY,GAAG,GAAG,EAAE;YACxB,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,GAAG,QAAQ,CAAC;YAC3D,MAAM,kBAAkB,GAAG,YAAY,GAAG,SAAS,GAAG,YAAY,CAAC;YACnE,gBAAgB,CAAC,OAAO,GAAG,kBAAkB,GAAG,SAAS,CAAC;QAC5D,CAAC,CAAC;QAEF,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QACrE,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IACpE,CAAC,EAAE,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC;IAE7B,4DAA4D;IAC5D,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,gBAAgB,CAAC,OAAO;YAAE,OAAO;QAErC,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;QAC/B,IAAI,CAAC,QAAQ;YAAE,OAAO;QAEtB,uDAAuD;QACvD,qBAAqB,CAAC,GAAG,EAAE;YACzB,QAAQ,CAAC,SAAS,GAAG,QAAQ,CAAC,YAAY,CAAC;QAC7C,CAAC,CAAC,CAAC;IACL,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,kDAAkD;IAE5D,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/dist/index.d.ts

@@ -6,6 +6,7 @@
  */
 export { ChatProvider, useChat } from './providers/chat-provider.js';
 export type { ChatProviderProps, ChatState, ChatContextValue } from './providers/chat-provider.js';
+export { useAutoScroll } from './hooks/use-auto-scroll.js';
 export { ThemeProvider, useTheme } from './providers/theme-provider.js';
 export type { ThemeProviderProps, ThemeContextValue, WingmanTheme, WingmanThemeColors, } from './providers/theme-provider.js';
 export { ChatMessage } from './components/chat-message.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AACrE,YAAY,EAAE,iBAAiB,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAEnG,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AACxE,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,GACnB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,YAAY,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,YAAY,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,YAAY,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAEnE,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,YAAY,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,YAAY,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAE/E,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,YAAY,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAGzE,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,YAAY,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAEnE,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,YAAY,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,YAAY,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAEvE,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAQ/E,eAAO,MAAM,OAAO,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AACrE,YAAY,EAAE,iBAAiB,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAEnG,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AACxE,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,GACnB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,YAAY,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,YAAY,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,YAAY,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAEnE,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,YAAY,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,YAAY,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAE/E,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,YAAY,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAGzE,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,YAAY,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAEnE,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,YAAY,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,YAAY,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAEvE,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAQ/E,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/dist/index.js

@@ -6,6 +6,7 @@
  */
 // Provider + hooks
 export { ChatProvider, useChat } from './providers/chat-provider.js';
+export { useAutoScroll } from './hooks/use-auto-scroll.js';
 export { ThemeProvider, useTheme } from './providers/theme-provider.js';
 // Components
 export { ChatMessage } from './components/chat-message.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,mBAAmB;AACnB,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAGrE,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAQxE,aAAa;AACb,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAG3D,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAGvD,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAGzD,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAG/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAGrE,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAG/D,qBAAqB;AACrB,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAGzD,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAG3D,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAG7D,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAGzD,qCAAqC;AACrC,kEAAkE;AAClE,wDAAwD;AACxD,0DAA0D;AAC1D,wEAAwE;AAExE,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,mBAAmB;AACnB,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAGrE,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAQxE,aAAa;AACb,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAG3D,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAGvD,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAGzD,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAG/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAGrE,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAG/D,qBAAqB;AACrB,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAGzD,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAG3D,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAG7D,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAGzD,qCAAqC;AACrC,kEAAkE;AAClE,wDAAwD;AACxD,0DAA0D;AAC1D,wEAAwE;AAExE,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wingmanjs/react",
-  "version": "0.1.1",
+  "version": "1.0.0",
   "description": "React hooks and components for Wingman chat",
   "type": "module",
   "main": "./dist/index.js",
@@ -30,6 +30,15 @@
   ],
   "author": "Eric Hansen",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ericchansen/wingman.git",
+    "directory": "packages/react"
+  },
+  "homepage": "https://github.com/ericchansen/wingman#readme",
+  "bugs": {
+    "url": "https://github.com/ericchansen/wingman/issues"
+  },
   "engines": {
     "node": ">=20.11.0"
   },
@@ -40,7 +49,7 @@
   "peerDependencies": {
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
-    "@wingmanjs/core": "0.1.1"
+    "@wingmanjs/core": "0.2.0"
   },
   "devDependencies": {
     "@types/react": "^19.0.0",