@effect-tui/react 0.1.3 → 0.1.5

package/dist/src/hooks/index.js

@@ -1,3 +1,5 @@
 export { useKeyboard } from "./use-keyboard.js";
+export { useMouse } from "./use-mouse.js";
 export { usePaste } from "./use-paste.js";
+export { useScroll } from "./use-scroll.js";
 //# sourceMappingURL=index.js.map

package/dist/src/hooks/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE/C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE/C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAEzC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/src/hooks/use-keyboard.d.ts

@@ -13,6 +13,17 @@ export type UseKeyboardOptions = {
 /**
  * Subscribe to keyboard events.
  * Handler is called for every key press while mounted.
+ *
+ * Uses a ref internally so you don't need useCallback - the handler
+ * always sees the latest props/state without re-subscribing.
+ *
+ * @example
+ * ```tsx
+ * // No useCallback needed - just pass your handler directly
+ * useKeyboard((key) => {
+ *   if (key.name === "enter") submitForm(currentValue)
+ * })
+ * ```
  */
 export declare function useKeyboard(handler: (key: KeyMsg) => void, opts?: UseKeyboardOptions): void;
 //# sourceMappingURL=use-keyboard.d.ts.map

package/dist/src/hooks/use-keyboard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-keyboard.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-keyboard.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAG9C,MAAM,MAAM,kBAAkB,GAAG;IAC/B,0FAA0F;IAC1F,KAAK,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,KAAK,CAAA;IAC9C,qEAAqE;IACrE,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAA;IACjC;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B,CAAA;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,EAAE,IAAI,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAgB3F"}
+{"version":3,"file":"use-keyboard.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-keyboard.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAG9C,MAAM,MAAM,kBAAkB,GAAG;IAChC,0FAA0F;IAC1F,KAAK,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,KAAK,CAAA;IAC9C,qEAAqE;IACrE,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAA;IACjC;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;CACzB,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,EAAE,IAAI,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAyB3F"}

package/dist/src/hooks/use-keyboard.js

@@ -1,26 +1,44 @@
-import { useEffect } from "react";
+import { useEffect, useRef } from "react";
 import { useRenderer } from "../renderer.js";
 /**
  * Subscribe to keyboard events.
  * Handler is called for every key press while mounted.
+ *
+ * Uses a ref internally so you don't need useCallback - the handler
+ * always sees the latest props/state without re-subscribing.
+ *
+ * @example
+ * ```tsx
+ * // No useCallback needed - just pass your handler directly
+ * useKeyboard((key) => {
+ *   if (key.name === "enter") submitForm(currentValue)
+ * })
+ * ```
  */
 export function useKeyboard(handler, opts) {
     const renderer = useRenderer();
     const phase = opts?.phase ?? "press";
     const filter = opts?.filter;
     const stopPropagation = opts?.stopPropagation ?? false;
+    // Store handler in ref so we always call the latest version
+    // without needing to re-subscribe on every render
+    const handlerRef = useRef(handler);
+    handlerRef.current = handler;
+    // Store filter in ref too for same reason
+    const filterRef = useRef(filter);
+    filterRef.current = filter;
     useEffect(() => {
         const wrapped = (key) => {
             const keyPhase = key.phase ?? "press";
             if (phase !== "any" && phase !== keyPhase)
                 return;
-            if (filter && !filter(key))
+            if (filterRef.current && !filterRef.current(key))
                 return;
             if (stopPropagation && key.preventDefault)
                 key.preventDefault();
-            handler(key);
+            handlerRef.current(key);
         };
         return renderer.onKey(wrapped);
-    }, [renderer, handler, phase, filter, stopPropagation]);
+    }, [renderer, phase, stopPropagation]);
 }
 //# sourceMappingURL=use-keyboard.js.map

package/dist/src/hooks/use-keyboard.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-keyboard.js","sourceRoot":"","sources":["../../../src/hooks/use-keyboard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEjC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAc5C;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,OAA8B,EAAE,IAAyB;IACnF,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAA;IAC9B,MAAM,KAAK,GAAG,IAAI,EAAE,KAAK,IAAI,OAAO,CAAA;IACpC,MAAM,MAAM,GAAG,IAAI,EAAE,MAAM,CAAA;IAC3B,MAAM,eAAe,GAAG,IAAI,EAAE,eAAe,IAAI,KAAK,CAAA;IAEtD,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,OAAO,GAAG,CAAC,GAAW,EAAE,EAAE;YAC9B,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,IAAI,OAAO,CAAA;YACrC,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,QAAQ;gBAAE,OAAM;YACjD,IAAI,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC;gBAAE,OAAM;YAClC,IAAI,eAAe,IAAI,GAAG,CAAC,cAAc;gBAAE,GAAG,CAAC,cAAc,EAAE,CAAA;YAC/D,OAAO,CAAC,GAAG,CAAC,CAAA;QACd,CAAC,CAAA;QACD,OAAO,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IAChC,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,CAAC,CAAC,CAAA;AACzD,CAAC"}
+{"version":3,"file":"use-keyboard.js","sourceRoot":"","sources":["../../../src/hooks/use-keyboard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAA;AAEzC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAc5C;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,WAAW,CAAC,OAA8B,EAAE,IAAyB;IACpF,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAA;IAC9B,MAAM,KAAK,GAAG,IAAI,EAAE,KAAK,IAAI,OAAO,CAAA;IACpC,MAAM,MAAM,GAAG,IAAI,EAAE,MAAM,CAAA;IAC3B,MAAM,eAAe,GAAG,IAAI,EAAE,eAAe,IAAI,KAAK,CAAA;IAEtD,4DAA4D;IAC5D,kDAAkD;IAClD,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,CAAA;IAClC,UAAU,CAAC,OAAO,GAAG,OAAO,CAAA;IAE5B,0CAA0C;IAC1C,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAA;IAChC,SAAS,CAAC,OAAO,GAAG,MAAM,CAAA;IAE1B,SAAS,CAAC,GAAG,EAAE;QACd,MAAM,OAAO,GAAG,CAAC,GAAW,EAAE,EAAE;YAC/B,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,IAAI,OAAO,CAAA;YACrC,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,QAAQ;gBAAE,OAAM;YACjD,IAAI,SAAS,CAAC,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC;gBAAE,OAAM;YACxD,IAAI,eAAe,IAAI,GAAG,CAAC,cAAc;gBAAE,GAAG,CAAC,cAAc,EAAE,CAAA;YAC/D,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QACxB,CAAC,CAAA;QACD,OAAO,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IAC/B,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,EAAE,eAAe,CAAC,CAAC,CAAA;AACvC,CAAC"}

package/dist/src/hooks/use-mouse.d.ts

@@ -0,0 +1,24 @@
+import type { MouseMsg, MouseButton } from "@effect-tui/core";
+export type UseMouseOptions = {
+    /** Filter by action type */
+    action?: "press" | "release" | "drag" | "move" | "any";
+    /** Filter by button */
+    button?: MouseButton | MouseButton[];
+};
+/**
+ * Subscribe to mouse events.
+ * Handler is called for mouse clicks, drags, and scroll while mounted.
+ *
+ * Uses a ref internally so you don't need useCallback - the handler
+ * always sees the latest props/state without re-subscribing.
+ *
+ * @example
+ * ```tsx
+ * // No useCallback needed - just pass your handler directly
+ * useMouse((mouse) => {
+ *   if (mouse.action === "press") handleClick(mouse.x, mouse.y)
+ * })
+ * ```
+ */
+export declare function useMouse(handler: (mouse: MouseMsg) => void, opts?: UseMouseOptions): void;
+//# sourceMappingURL=use-mouse.d.ts.map

package/dist/src/hooks/use-mouse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-mouse.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-mouse.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAG7D,MAAM,MAAM,eAAe,GAAG;IAC7B,4BAA4B;IAC5B,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAA;IACtD,uBAAuB;IACvB,MAAM,CAAC,EAAE,WAAW,GAAG,WAAW,EAAE,CAAA;CACpC,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,EAAE,IAAI,CAAC,EAAE,eAAe,GAAG,IAAI,CAwBzF"}

package/dist/src/hooks/use-mouse.js

@@ -0,0 +1,41 @@
+import { useEffect, useRef } from "react";
+import { useRenderer } from "../renderer.js";
+/**
+ * Subscribe to mouse events.
+ * Handler is called for mouse clicks, drags, and scroll while mounted.
+ *
+ * Uses a ref internally so you don't need useCallback - the handler
+ * always sees the latest props/state without re-subscribing.
+ *
+ * @example
+ * ```tsx
+ * // No useCallback needed - just pass your handler directly
+ * useMouse((mouse) => {
+ *   if (mouse.action === "press") handleClick(mouse.x, mouse.y)
+ * })
+ * ```
+ */
+export function useMouse(handler, opts) {
+    const renderer = useRenderer();
+    const action = opts?.action ?? "any";
+    const button = opts?.button;
+    // Store handler in ref so we always call the latest version
+    const handlerRef = useRef(handler);
+    handlerRef.current = handler;
+    useEffect(() => {
+        const wrapped = (mouse) => {
+            // Filter by action
+            if (action !== "any" && action !== mouse.action)
+                return;
+            // Filter by button
+            if (button !== undefined) {
+                const buttons = Array.isArray(button) ? button : [button];
+                if (!buttons.includes(mouse.button))
+                    return;
+            }
+            handlerRef.current(mouse);
+        };
+        return renderer.onMouse(wrapped);
+    }, [renderer, action, button]);
+}
+//# sourceMappingURL=use-mouse.js.map

package/dist/src/hooks/use-mouse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-mouse.js","sourceRoot":"","sources":["../../../src/hooks/use-mouse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAA;AAEzC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAS5C;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,QAAQ,CAAC,OAAkC,EAAE,IAAsB;IAClF,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAA;IAC9B,MAAM,MAAM,GAAG,IAAI,EAAE,MAAM,IAAI,KAAK,CAAA;IACpC,MAAM,MAAM,GAAG,IAAI,EAAE,MAAM,CAAA;IAE3B,4DAA4D;IAC5D,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,CAAA;IAClC,UAAU,CAAC,OAAO,GAAG,OAAO,CAAA;IAE5B,SAAS,CAAC,GAAG,EAAE;QACd,MAAM,OAAO,GAAG,CAAC,KAAe,EAAE,EAAE;YACnC,mBAAmB;YACnB,IAAI,MAAM,KAAK,KAAK,IAAI,MAAM,KAAK,KAAK,CAAC,MAAM;gBAAE,OAAM;YAEvD,mBAAmB;YACnB,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC1B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;gBACzD,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC;oBAAE,OAAM;YAC5C,CAAC;YAED,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;QAC1B,CAAC,CAAA;QACD,OAAO,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;IACjC,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;AAC/B,CAAC"}

package/dist/src/hooks/use-paste.d.ts

@@ -1,5 +1,16 @@
 /**
  * Subscribe to bracketed paste events (if supported by renderer/terminal).
+ *
+ * Uses a ref internally so you don't need useCallback - the handler
+ * always sees the latest props/state without re-subscribing.
+ *
+ * @example
+ * ```tsx
+ * // No useCallback needed - just pass your handler directly
+ * usePaste((text) => {
+ *   insertText(text, cursorPosition)
+ * })
+ * ```
  */
 export declare function usePaste(handler: (text: string) => void): void;
 //# sourceMappingURL=use-paste.d.ts.map

package/dist/src/hooks/use-paste.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-paste.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-paste.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAO9D"}
+{"version":3,"file":"use-paste.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-paste.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAW9D"}

package/dist/src/hooks/use-paste.js

@@ -1,14 +1,28 @@
-import { useEffect } from "react";
+import { useEffect, useRef } from "react";
 import { useRenderer } from "../renderer.js";
 /**
  * Subscribe to bracketed paste events (if supported by renderer/terminal).
+ *
+ * Uses a ref internally so you don't need useCallback - the handler
+ * always sees the latest props/state without re-subscribing.
+ *
+ * @example
+ * ```tsx
+ * // No useCallback needed - just pass your handler directly
+ * usePaste((text) => {
+ *   insertText(text, cursorPosition)
+ * })
+ * ```
  */
 export function usePaste(handler) {
     const renderer = useRenderer();
+    // Store handler in ref so we always call the latest version
+    const handlerRef = useRef(handler);
+    handlerRef.current = handler;
     useEffect(() => {
         if (!renderer.onPaste)
             return;
-        return renderer.onPaste(handler);
-    }, [renderer, handler]);
+        return renderer.onPaste((text) => handlerRef.current(text));
+    }, [renderer]);
 }
 //# sourceMappingURL=use-paste.js.map

package/dist/src/hooks/use-paste.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-paste.js","sourceRoot":"","sources":["../../../src/hooks/use-paste.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAE5C;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,OAA+B;IACtD,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAA;IAE9B,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,QAAQ,CAAC,OAAO;YAAE,OAAM;QAC7B,OAAO,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;IAClC,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAA;AACzB,CAAC"}
+{"version":3,"file":"use-paste.js","sourceRoot":"","sources":["../../../src/hooks/use-paste.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAA;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAE5C;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,QAAQ,CAAC,OAA+B;IACvD,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAA;IAE9B,4DAA4D;IAC5D,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,CAAA;IAClC,UAAU,CAAC,OAAO,GAAG,OAAO,CAAA;IAE5B,SAAS,CAAC,GAAG,EAAE;QACd,IAAI,CAAC,QAAQ,CAAC,OAAO;YAAE,OAAM;QAC7B,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;IAC5D,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAA;AACf,CAAC"}

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

@@ -0,0 +1,79 @@
+export interface ScrollState {
+    /** Current scroll offset (pixels from start) */
+    offset: number;
+    /** Maximum scroll offset */
+    maxOffset: number;
+    /** Viewport height (or width for horizontal) */
+    viewportSize: number;
+    /** Total content size */
+    contentSize: number;
+    /** Whether we're at the start edge */
+    atStart: boolean;
+    /** Whether we're at the end edge */
+    atEnd: boolean;
+}
+export interface UseScrollOptions {
+    /** Scroll axis: "vertical" (default) or "horizontal" */
+    axis?: "vertical" | "horizontal";
+    /** Initial scroll offset */
+    initialOffset?: number;
+    /** Enable keyboard navigation (default: true) */
+    enableKeyboard?: boolean;
+    /** Enable mouse wheel (default: true) */
+    enableMouseWheel?: boolean;
+    /** Enable scroll acceleration (default: true) */
+    enableAcceleration?: boolean;
+    /** Sticky scroll - auto-scroll to end when content grows (default: false) */
+    sticky?: boolean;
+    /** Scroll speed for arrow keys (pixels, default: 1) */
+    arrowSpeed?: number;
+    /** Scroll speed for page up/down (fraction of viewport, default: 0.5) */
+    pageSpeed?: number;
+}
+export interface UseScrollReturn {
+    /** Current scroll state */
+    state: ScrollState;
+    /** Set scroll offset directly */
+    setOffset: (offset: number) => void;
+    /** Scroll by delta pixels */
+    scrollBy: (delta: number) => void;
+    /** Scroll to start */
+    scrollToStart: () => void;
+    /** Scroll to end */
+    scrollToEnd: () => void;
+    /**
+     * Scroll to make a position visible in the viewport.
+     * Useful for keeping a selected item in view.
+     * @param position - The position (row/col index or pixel offset)
+     * @param itemSize - Size of each item (default: 1 for row-based lists)
+     * @param padding - Extra padding around the item (default: 0)
+     */
+    scrollToVisible: (position: number, itemSize?: number, padding?: number) => void;
+    /** Props to spread on <scroll> element */
+    scrollProps: {
+        offset: number;
+        axis: "vertical" | "horizontal";
+        onContentSize: (width: number, height: number) => void;
+        onViewportSize: (width: number, height: number) => void;
+    };
+}
+/**
+ * Hook for managing scroll state with keyboard/mouse input.
+ *
+ * @example
+ * ```tsx
+ * function ScrollableList({ items }) {
+ *   const { state, scrollProps } = useScroll({ sticky: true })
+ *
+ *   return (
+ *     <scroll {...scrollProps}>
+ *       <vstack>
+ *         {items.map(item => <text key={item.id}>{item.text}</text>)}
+ *       </vstack>
+ *     </scroll>
+ *   )
+ * }
+ * ```
+ */
+export declare function useScroll(options?: UseScrollOptions): UseScrollReturn;
+//# sourceMappingURL=use-scroll.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-scroll.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-scroll.ts"],"names":[],"mappings":"AAqFA,MAAM,WAAW,WAAW;IAC3B,gDAAgD;IAChD,MAAM,EAAE,MAAM,CAAA;IACd,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAA;IACjB,gDAAgD;IAChD,YAAY,EAAE,MAAM,CAAA;IACpB,yBAAyB;IACzB,WAAW,EAAE,MAAM,CAAA;IACnB,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAA;IAChB,oCAAoC;IACpC,KAAK,EAAE,OAAO,CAAA;CACd;AAED,MAAM,WAAW,gBAAgB;IAChC,wDAAwD;IACxD,IAAI,CAAC,EAAE,UAAU,GAAG,YAAY,CAAA;IAChC,4BAA4B;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,iDAAiD;IACjD,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,yCAAyC;IACzC,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,iDAAiD;IACjD,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,6EAA6E;IAC7E,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,eAAe;IAC/B,2BAA2B;IAC3B,KAAK,EAAE,WAAW,CAAA;IAClB,iCAAiC;IACjC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IACnC,6BAA6B;IAC7B,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACjC,sBAAsB;IACtB,aAAa,EAAE,MAAM,IAAI,CAAA;IACzB,oBAAoB;IACpB,WAAW,EAAE,MAAM,IAAI,CAAA;IACvB;;;;;;OAMG;IACH,eAAe,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;IAChF,0CAA0C;IAC1C,WAAW,EAAE;QACZ,MAAM,EAAE,MAAM,CAAA;QACd,IAAI,EAAE,UAAU,GAAG,YAAY,CAAA;QAC/B,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;QACtD,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;KACvD,CAAA;CACD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,SAAS,CAAC,OAAO,GAAE,gBAAqB,GAAG,eAAe,CA4NzE"}

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

@@ -0,0 +1,239 @@
+// use-scroll.ts — Hook for managing scroll state with keyboard/mouse input
+import { useState, useCallback, useRef, useMemo, useLayoutEffect } from "react";
+import { useKeyboard } from "./use-keyboard.js";
+import { useTerminalSize } from "../renderer.js";
+/**
+ * macOS-inspired scroll acceleration.
+ * Tracks velocity via moving window of tick intervals.
+ * Fast scrolling gets progressively faster.
+ */
+class MacOSScrollAccel {
+    opts;
+    lastTickTime = 0;
+    velocityHistory = [];
+    historySize = 3;
+    streakTimeout = 150;
+    // Some terminals send duplicate ticks ~4ms apart (Ghostty workaround)
+    minTickInterval = 6;
+    constructor(opts = {}) {
+        this.opts = opts;
+    }
+    tick(now = Date.now()) {
+        const A = this.opts.A ?? 0.8;
+        const tau = this.opts.tau ?? 3;
+        const maxMultiplier = this.opts.maxMultiplier ?? 6;
+        const dt = this.lastTickTime ? now - this.lastTickTime : Infinity;
+        // Reset if too much time passed
+        if (dt === Infinity || dt > this.streakTimeout) {
+            this.lastTickTime = now;
+            this.velocityHistory = [];
+            return 1;
+        }
+        // Ignore duplicate ticks (terminal quirks)
+        if (dt < this.minTickInterval) {
+            return 1;
+        }
+        this.lastTickTime = now;
+        this.velocityHistory.push(dt);
+        if (this.velocityHistory.length > this.historySize) {
+            this.velocityHistory.shift();
+        }
+        // Calculate average interval (lower = faster scrolling)
+        const avgInterval = this.velocityHistory.reduce((a, b) => a + b, 0) / this.velocityHistory.length;
+        // Convert to velocity: faster ticks = higher velocity
+        const referenceInterval = 100;
+        const velocity = referenceInterval / avgInterval;
+        // Apply exponential curve
+        const x = velocity / tau;
+        const multiplier = 1 + A * (Math.exp(x) - 1);
+        return Math.min(multiplier, maxMultiplier);
+    }
+    reset() {
+        this.lastTickTime = 0;
+        this.velocityHistory = [];
+    }
+}
+/**
+ * Hook for managing scroll state with keyboard/mouse input.
+ *
+ * @example
+ * ```tsx
+ * function ScrollableList({ items }) {
+ *   const { state, scrollProps } = useScroll({ sticky: true })
+ *
+ *   return (
+ *     <scroll {...scrollProps}>
+ *       <vstack>
+ *         {items.map(item => <text key={item.id}>{item.text}</text>)}
+ *       </vstack>
+ *     </scroll>
+ *   )
+ * }
+ * ```
+ */
+export function useScroll(options = {}) {
+    const { axis = "vertical", initialOffset = 0, enableKeyboard = true, enableMouseWheel = true, enableAcceleration = true, sticky = false, arrowSpeed = 1, pageSpeed = 0.5, } = options;
+    const { width: termWidth, height: termHeight } = useTerminalSize();
+    // Scroll state
+    const [offset, setOffsetRaw] = useState(initialOffset);
+    const [contentSize, setContentSize] = useState(0);
+    // Use terminal size as initial estimate, but scroll component will report actual size
+    const [viewportSize, setViewportSize] = useState(axis === "vertical" ? termHeight : termWidth);
+    // Refs for sticky scroll behavior
+    const wasAtEndRef = useRef(sticky);
+    const prevContentSizeRef = useRef(0);
+    // Scroll acceleration
+    const accel = useMemo(() => (enableAcceleration ? new MacOSScrollAccel() : { tick: () => 1, reset: () => { } }), [enableAcceleration]);
+    // Fractional accumulator for smooth sub-pixel scrolling
+    const accumulatorRef = useRef(0);
+    // Ref for scrollToVisible so it doesn't change on every scroll
+    const offsetRef = useRef(offset);
+    offsetRef.current = offset;
+    // Calculate derived state
+    const maxOffset = Math.max(0, contentSize - viewportSize);
+    const atStart = offset <= 0;
+    const atEnd = offset >= maxOffset;
+    // Clamp and set offset
+    const setOffset = useCallback((newOffset) => {
+        const clamped = Math.max(0, Math.min(maxOffset, newOffset));
+        setOffsetRaw(clamped);
+        // Track if we're at end for sticky behavior
+        wasAtEndRef.current = clamped >= maxOffset - 1;
+    }, [maxOffset]);
+    // Scroll by delta with accumulator for fractional scrolling
+    const scrollBy = useCallback((delta) => {
+        accumulatorRef.current += delta;
+        const integerDelta = Math.trunc(accumulatorRef.current);
+        if (integerDelta !== 0) {
+            setOffset(offset + integerDelta);
+            accumulatorRef.current -= integerDelta;
+        }
+    }, [offset, setOffset]);
+    const scrollToStart = useCallback(() => {
+        setOffset(0);
+        accumulatorRef.current = 0;
+        accel.reset();
+    }, [setOffset, accel]);
+    const scrollToEnd = useCallback(() => {
+        setOffset(maxOffset);
+        accumulatorRef.current = 0;
+        accel.reset();
+    }, [setOffset, maxOffset, accel]);
+    // Handle content size changes (for sticky scroll)
+    const handleContentSize = useCallback((width, height) => {
+        const newSize = axis === "vertical" ? height : width;
+        setContentSize(newSize);
+        prevContentSizeRef.current = newSize;
+    }, [axis]);
+    // Synchronous sticky scroll: snap to end when content grows
+    // useLayoutEffect runs synchronously after React commit but before paint
+    useLayoutEffect(() => {
+        if (!sticky)
+            return;
+        const newMaxOffset = Math.max(0, contentSize - viewportSize);
+        if (wasAtEndRef.current && contentSize > 0) {
+            setOffsetRaw(newMaxOffset);
+        }
+    }, [sticky, contentSize, viewportSize]);
+    // Handle viewport size changes (reported by scroll component)
+    const handleViewportSize = useCallback((width, height) => {
+        const newSize = axis === "vertical" ? height : width;
+        setViewportSize(newSize);
+    }, [axis]);
+    // Keyboard handler
+    const handleKey = useCallback((key) => {
+        // Mouse wheel comes as pageup/pagedown with meta=true
+        // Handle separately from keyboard since enableKeyboard shouldn't disable mouse
+        if (key.meta && enableMouseWheel && (key.name === "pageup" || key.name === "pagedown")) {
+            const multiplier = accel.tick();
+            const delta = Math.ceil(arrowSpeed * multiplier);
+            scrollBy(key.name === "pageup" ? -delta : delta);
+            return;
+        }
+        if (!enableKeyboard)
+            return;
+        const isVertical = axis === "vertical";
+        const upKey = isVertical ? "up" : "left";
+        const downKey = isVertical ? "down" : "right";
+        switch (key.name) {
+            case upKey:
+                scrollBy(-arrowSpeed);
+                break;
+            case downKey:
+                scrollBy(arrowSpeed);
+                break;
+            case "pageup":
+                scrollBy(-Math.floor(viewportSize * pageSpeed));
+                break;
+            case "pagedown":
+                scrollBy(Math.floor(viewportSize * pageSpeed));
+                break;
+            case "home":
+                scrollToStart();
+                break;
+            case "end":
+                scrollToEnd();
+                break;
+        }
+    }, [
+        enableKeyboard,
+        axis,
+        arrowSpeed,
+        pageSpeed,
+        viewportSize,
+        enableMouseWheel,
+        accel,
+        scrollBy,
+        scrollToStart,
+        scrollToEnd,
+    ]);
+    useKeyboard(handleKey);
+    // Scroll to make a position visible (for keeping selection in view)
+    // Uses refs to avoid changing on every scroll - only triggers when selection changes
+    const scrollToVisible = useCallback((position, itemSize = 1, padding = 0) => {
+        const currentOffset = offsetRef.current;
+        const itemStart = position * itemSize;
+        const itemEnd = itemStart + itemSize;
+        // If item is above viewport, scroll up to show it
+        if (itemStart < currentOffset + padding) {
+            setOffset(Math.max(0, itemStart - padding));
+        }
+        // If item is below viewport, scroll down to show it
+        else if (itemEnd > currentOffset + viewportSize - padding) {
+            const currentMaxOffset = Math.max(0, contentSize - viewportSize);
+            setOffset(Math.min(currentMaxOffset, itemEnd - viewportSize + padding));
+        }
+    }, [viewportSize, contentSize, setOffset]);
+    const state = {
+        offset,
+        maxOffset,
+        viewportSize,
+        contentSize,
+        atStart,
+        atEnd,
+    };
+    // Handle effective offset sync from host (when sticky adjusts the offset)
+    const handleEffectiveOffset = useCallback((effectiveOffset) => {
+        // Sync the ref so scrollToVisible uses the actual rendered position
+        offsetRef.current = effectiveOffset;
+        // Also update state to keep in sync (but don't trigger wasAtEnd change)
+        setOffsetRaw(effectiveOffset);
+    }, []);
+    const scrollProps = {
+        offset,
+        axis,
+        onContentSize: handleContentSize,
+        onViewportSize: handleViewportSize,
+        onEffectiveOffset: handleEffectiveOffset,
+    };
+    return {
+        state,
+        setOffset,
+        scrollBy,
+        scrollToStart,
+        scrollToEnd,
+        scrollToVisible,
+        scrollProps,
+    };
+}
+//# sourceMappingURL=use-scroll.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-scroll.js","sourceRoot":"","sources":["../../../src/hooks/use-scroll.ts"],"names":[],"mappings":"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"}

package/dist/src/hooks/useFrameStats.js.map

@@ -1 +1 @@
-{"version":3,"file":"useFrameStats.js","sourceRoot":"","sources":["../../../src/hooks/useFrameStats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAG5C;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,QAAQ,GAAG,GAAG;IAC1C,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAA;IAC9B,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAoB,IAAI,CAAC,CAAA;IAE3D,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,QAAQ,CAAC,YAAY;YAAE,OAAM;QAElC,IAAI,IAAI,GAAsB,IAAI,CAAA;QAClC,MAAM,KAAK,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE;YACxC,IAAI,GAAG,CAAC,CAAA;QACV,CAAC,CAAC,CAAA;QAEF,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,EAAE;YAC1B,IAAI,IAAI;gBAAE,QAAQ,CAAC,IAAI,CAAC,CAAA;QAC1B,CAAC,EAAE,QAAQ,CAAC,CAAA;QAEZ,OAAO,GAAG,EAAE;YACV,aAAa,CAAC,EAAE,CAAC,CAAA;YACjB,KAAK,EAAE,EAAE,CAAA;QACX,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAA;IAExB,OAAO,KAAK,CAAA;AACd,CAAC"}
+{"version":3,"file":"useFrameStats.js","sourceRoot":"","sources":["../../../src/hooks/useFrameStats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAG5C;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,QAAQ,GAAG,GAAG;IAC3C,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAA;IAC9B,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAoB,IAAI,CAAC,CAAA;IAE3D,SAAS,CAAC,GAAG,EAAE;QACd,IAAI,CAAC,QAAQ,CAAC,YAAY;YAAE,OAAM;QAElC,IAAI,IAAI,GAAsB,IAAI,CAAA;QAClC,MAAM,KAAK,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE;YACzC,IAAI,GAAG,CAAC,CAAA;QACT,CAAC,CAAC,CAAA;QAEF,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,EAAE;YAC3B,IAAI,IAAI;gBAAE,QAAQ,CAAC,IAAI,CAAC,CAAA;QACzB,CAAC,EAAE,QAAQ,CAAC,CAAA;QAEZ,OAAO,GAAG,EAAE;YACX,aAAa,CAAC,EAAE,CAAC,CAAA;YACjB,KAAK,EAAE,EAAE,CAAA;QACV,CAAC,CAAA;IACF,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAA;IAExB,OAAO,KAAK,CAAA;AACb,CAAC"}

package/dist/src/hosts/base.d.ts

@@ -1,5 +1,11 @@
-import type { CellBuffer, Palette } from "@effect-tui/core";
+import type { CellBuffer, Palette, Color } from "@effect-tui/core";
 import type { HostInstance, Rect, Size, HostContext, CommonProps } from "../reconciler/types.js";
+/** Host that may have a background color (e.g., BoxHost) */
+export interface HostWithBg extends HostInstance {
+    bg?: Color;
+}
+/** Walk up parent chain to find inherited background color */
+export declare function getInheritedBg(startParent: HostInstance | null): Color | undefined;
 export declare abstract class BaseHost implements HostInstance {
     id: string;
     type: string;
@@ -8,11 +14,66 @@ export declare abstract class BaseHost implements HostInstance {
     rect: Rect | null;
     flexGrow: number;
     flexShrink: number;
+    frameWidth?: number;
+    frameHeight?: number;
+    frameMinWidth?: number;
+    frameMaxWidth?: number;
+    frameMinHeight?: number;
+    frameMaxHeight?: number;
+    /** @internal Marks this node as static content (for Static component) */
+    __static?: boolean;
     protected ctx: HostContext;
     constructor(type: string, props: CommonProps, ctx: HostContext);
     abstract measure(maxW: number, maxH: number): Size;
     abstract render(buffer: CellBuffer, palette: Palette): void;
     layout(rect: Rect): void;
+    /**
+     * Apply frame constraints to a proposed size before passing to children.
+     *
+     * This is the first half of SwiftUI-style frame semantics. When a parent
+     * proposes a size to us, we modify it based on our constraints before
+     * passing it down to our children.
+     *
+     * @example
+     * ```
+     * Parent proposes: 100x100
+     * Our height constraint: 10
+     * We propose to children: 100x10
+     * ```
+     *
+     * This prevents greedy children (like scroll) from measuring larger than
+     * our constrained size.
+     *
+     * @param maxW - Width proposed by parent
+     * @param maxH - Height proposed by parent
+     * @returns Constrained size to propose to children
+     */
+    protected constrainProposal(maxW: number, maxH: number): {
+        w: number;
+        h: number;
+    };
+    /**
+     * Apply frame constraints to our measured size before returning to parent.
+     *
+     * This is the second half of SwiftUI-style frame semantics. After measuring
+     * our children, we modify our reported size based on our constraints before
+     * returning it to our parent.
+     *
+     * @example
+     * ```
+     * Children measured: 5x1 (small content)
+     * Our height constraint: 10
+     * We report to parent: 5x10
+     * ```
+     *
+     * This ensures we report our constrained size regardless of children's
+     * natural size, which is essential for layout composition (e.g., spacer
+     * needs to know our fixed size to calculate remaining space).
+     *
+     * @param size - Natural size from measuring children
+     * @returns Constrained size to report to parent
+     */
+    protected constrainResult(size: Size): Size;
     updateProps(props: Record<string, unknown>): void;
     destroy(): void;
     appendChild(child: HostInstance): void;