@praxisjs/composables 1.0.5 → 1.1.0

package/dist/dom.js.map

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

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export { WindowSize, ScrollPosition, ElementSize, Intersection, Focus, } from "./dom";
 export { MediaQuery, ColorScheme, Mouse, KeyCombo, Idle } from "./browser";
 export { Clipboard, Geolocation, TimeAgo, Pagination, type PaginationOptions, } from "./utilities";
+export { VirtualList, type VirtualItem } from "./list";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,cAAc,EACd,WAAW,EACX,YAAY,EACZ,KAAK,GACN,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC3E,OAAO,EACL,SAAS,EACT,WAAW,EACX,OAAO,EACP,UAAU,EACV,KAAK,iBAAiB,GACvB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,cAAc,EACd,WAAW,EACX,YAAY,EACZ,KAAK,GACN,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC3E,OAAO,EACL,SAAS,EACT,WAAW,EACX,OAAO,EACP,UAAU,EACV,KAAK,iBAAiB,GACvB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,QAAQ,CAAC"}

package/dist/index.js

@@ -1,4 +1,5 @@
 export { WindowSize, ScrollPosition, ElementSize, Intersection, Focus, } from "./dom";
 export { MediaQuery, ColorScheme, Mouse, KeyCombo, Idle } from "./browser";
 export { Clipboard, Geolocation, TimeAgo, Pagination, } from "./utilities";
+export { VirtualList } from "./list";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,cAAc,EACd,WAAW,EACX,YAAY,EACZ,KAAK,GACN,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC3E,OAAO,EACL,SAAS,EACT,WAAW,EACX,OAAO,EACP,UAAU,GAEX,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,cAAc,EACd,WAAW,EACX,YAAY,EACZ,KAAK,GACN,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC3E,OAAO,EACL,SAAS,EACT,WAAW,EACX,OAAO,EACP,UAAU,GAEX,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAoB,MAAM,QAAQ,CAAC"}

package/dist/list.d.ts

@@ -0,0 +1,30 @@
+import { Composable } from "@praxisjs/core";
+export interface VirtualItem<T> {
+    item: T;
+    index: number;
+}
+export declare class VirtualList<T = unknown> extends Composable {
+    private readonly containerRef;
+    private readonly getItems;
+    private readonly itemHeight;
+    private readonly buffer;
+    visibleItems: Array<VirtualItem<T>>;
+    totalHeight: number;
+    offsetTop: number;
+    offsetBottom: number;
+    private readonly _scrollTop;
+    private readonly _viewHeight;
+    private _scrollCleanup?;
+    constructor(containerRef: {
+        current: HTMLElement | null;
+    }, getItems: () => T[], itemHeight: number, buffer?: number);
+    setup(): {
+        visibleItems: import("@praxisjs/shared").Computed<VirtualItem<T>[]>;
+        totalHeight: import("@praxisjs/shared").Computed<number>;
+        offsetTop: import("@praxisjs/shared").Computed<number>;
+        offsetBottom: import("@praxisjs/shared").Computed<number>;
+    };
+    onMount(): void;
+    onUnmount(): void;
+}
+//# sourceMappingURL=list.d.ts.map

package/dist/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../src/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAG5C,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,IAAI,EAAE,CAAC,CAAC;IACR,KAAK,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,WAAW,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,UAAU;IAWpD,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAbjB,YAAY,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IAE7B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAe;IAC3C,OAAO,CAAC,cAAc,CAAC,CAAa;gBAGjB,YAAY,EAAE;QAAE,OAAO,EAAE,WAAW,GAAG,IAAI,CAAA;KAAE,EAC7C,QAAQ,EAAE,MAAM,CAAC,EAAE,EACnB,UAAU,EAAE,MAAM,EAClB,MAAM,SAAI;IAK7B,KAAK;;;;;;IAkCL,OAAO;IAYP,SAAS;CAGV"}

package/dist/list.js

@@ -0,0 +1,47 @@
+import { Composable } from "@praxisjs/core";
+import { computed, signal } from "@praxisjs/core/internal";
+export class VirtualList extends Composable {
+    constructor(containerRef, getItems, itemHeight, buffer = 3) {
+        super();
+        this.containerRef = containerRef;
+        this.getItems = getItems;
+        this.itemHeight = itemHeight;
+        this.buffer = buffer;
+        this._scrollTop = signal(0);
+        this._viewHeight = signal(600);
+    }
+    setup() {
+        const { _scrollTop, _viewHeight, itemHeight, buffer, getItems } = this;
+        const items = computed(getItems);
+        const total = computed(() => items().length);
+        const startIdx = computed(() => Math.max(0, Math.floor(_scrollTop() / itemHeight) - buffer));
+        const endIdx = computed(() => Math.min(total() - 1, Math.ceil((_scrollTop() + _viewHeight()) / itemHeight) + buffer));
+        const visibleItems = computed(() => {
+            const arr = items();
+            const result = [];
+            for (let i = startIdx(); i <= endIdx(); i++) {
+                result.push({ item: arr[i], index: i });
+            }
+            return result;
+        });
+        const totalHeight = computed(() => total() * itemHeight);
+        const offsetTop = computed(() => startIdx() * itemHeight);
+        const offsetBottom = computed(() => Math.max(0, total() - 1 - endIdx()) * itemHeight);
+        return { visibleItems, totalHeight, offsetTop, offsetBottom };
+    }
+    onMount() {
+        const el = this.containerRef.current;
+        if (!el)
+            return;
+        const h = el.clientHeight;
+        if (h > 0)
+            this._viewHeight.set(h);
+        const handler = () => { this._scrollTop.set(el.scrollTop); };
+        el.addEventListener("scroll", handler);
+        this._scrollCleanup = () => { el.removeEventListener("scroll", handler); };
+    }
+    onUnmount() {
+        this._scrollCleanup?.();
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../src/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAO3D,MAAM,OAAO,WAAyB,SAAQ,UAAU;IAUtD,YACmB,YAA6C,EAC7C,QAAmB,EACnB,UAAkB,EAClB,SAAS,CAAC;QAE3B,KAAK,EAAE,CAAC;QALS,iBAAY,GAAZ,YAAY,CAAiC;QAC7C,aAAQ,GAAR,QAAQ,CAAW;QACnB,eAAU,GAAV,UAAU,CAAQ;QAClB,WAAM,GAAN,MAAM,CAAI;QARZ,eAAU,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACvB,gBAAW,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAU3C,CAAC;IAED,KAAK;QACH,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;QAEvE,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACjC,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC,MAAM,CAAC,CAAC;QAE7C,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,EAAE,CAC7B,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,GAAG,UAAU,CAAC,GAAG,MAAM,CAAC,CAC5D,CAAC;QACF,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,EAAE,CAC3B,IAAI,CAAC,GAAG,CACN,KAAK,EAAE,GAAG,CAAC,EACX,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,GAAG,WAAW,EAAE,CAAC,GAAG,UAAU,CAAC,GAAG,MAAM,CAChE,CACF,CAAC;QAEF,MAAM,YAAY,GAAG,QAAQ,CAAwB,GAAG,EAAE;YACxD,MAAM,GAAG,GAAG,KAAK,EAAE,CAAC;YACpB,MAAM,MAAM,GAA0B,EAAE,CAAC;YACzC,KAAK,IAAI,CAAC,GAAG,QAAQ,EAAE,EAAE,CAAC,IAAI,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC5C,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;YAC1C,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC,CAAC;QAEH,MAAM,WAAW,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,GAAG,UAAU,CAAC,CAAC;QACzD,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,GAAG,UAAU,CAAC,CAAC;QAC1D,MAAM,YAAY,GAAG,QAAQ,CAAC,GAAG,EAAE,CACjC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,GAAG,MAAM,EAAE,CAAC,GAAG,UAAU,CACjD,CAAC;QAEF,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC;IAChE,CAAC;IAED,OAAO;QACL,MAAM,EAAE,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC;QACrC,IAAI,CAAC,EAAE;YAAE,OAAO;QAEhB,MAAM,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC;QAC1B,IAAI,CAAC,GAAG,CAAC;YAAE,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAEnC,MAAM,OAAO,GAAG,GAAG,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7D,EAAE,CAAC,gBAAgB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACvC,IAAI,CAAC,cAAc,GAAG,GAAG,EAAE,GAAG,EAAE,CAAC,mBAAmB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7E,CAAC;IAED,SAAS;QACP,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;IAC1B,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisjs/composables",
-  "version": "1.0.5",
+  "version": "1.1.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -14,7 +14,7 @@
     "typescript": "^5.9.3"
   },
   "dependencies": {
-    "@praxisjs/core": "1.4.1",
+    "@praxisjs/core": "1.5.0",
     "@praxisjs/shared": "0.2.0"
   },
   "scripts": {

package/src/__tests__/browser.test.ts

@@ -283,6 +283,14 @@ describe("KeyCombo (additional)", () => {
     expect(pressed()).toBe(true);
   });
 
+  it("modifier-only combo (ctrl+shift) — keyup resets pressed to false", () => {
+    const kc = new KeyCombo("ctrl+shift");
+    const { pressed } = kc.setup() as { pressed: () => boolean };
+    // Fire keyup to cover the _keyupHandler arrow function inside the !key branch
+    window.dispatchEvent(new KeyboardEvent("keyup"));
+    expect(pressed()).toBe(false);
+  });
+
   it("modifier-only combo (ctrl+shift) never fires", () => {
     const kc = new KeyCombo("ctrl+shift");
     const { pressed } = kc.setup() as { pressed: () => boolean };

package/src/__tests__/dom.test.ts

@@ -1,8 +1,6 @@
 // @vitest-environment jsdom
 import { describe, it, expect, vi, beforeEach } from "vitest";
 
-import { signal } from "@praxisjs/core/internal";
-
 import { WindowSize, ScrollPosition, ElementSize, Intersection, Focus } from "../dom";
 
 // ── WindowSize ────────────────────────────────────────────────────────────────
@@ -55,6 +53,7 @@ describe("ScrollPosition", () => {
   it("updates on scroll event for window", () => {
     const sp = new ScrollPosition(window);
     const { x, y } = sp.setup() as { x: () => number; y: () => number };
+    sp.onMount();
 
     Object.defineProperty(window, "scrollX", { value: 100, configurable: true });
     Object.defineProperty(window, "scrollY", { value: 200, configurable: true });
@@ -68,6 +67,7 @@ describe("ScrollPosition", () => {
     const el = document.createElement("div");
     const sp = new ScrollPosition(el);
     const { x, y } = sp.setup() as { x: () => number; y: () => number };
+    sp.onMount();
 
     Object.defineProperty(el, "scrollLeft", { value: 50, configurable: true });
     Object.defineProperty(el, "scrollTop", { value: 75, configurable: true });
@@ -82,6 +82,7 @@ describe("ScrollPosition", () => {
     const remove = vi.spyOn(el, "removeEventListener");
     const sp = new ScrollPosition(el);
     sp.setup();
+    sp.onMount();
     sp.onUnmount();
     expect(remove).toHaveBeenCalledWith("scroll", expect.any(Function));
   });
@@ -137,6 +138,13 @@ describe("ElementSize", () => {
     es.onUnmount();
     expect(disconnect).toHaveBeenCalled();
   });
+
+  it("onMount() with null ref is a no-op", () => {
+    const ref = { current: null };
+    const es = new ElementSize(ref);
+    es.setup();
+    expect(() => es.onMount()).not.toThrow();
+  });
 });
 
 // ── Intersection ──────────────────────────────────────────────────────────────
@@ -187,6 +195,38 @@ describe("Intersection", () => {
     int.onUnmount();
     expect(disconnect).toHaveBeenCalled();
   });
+
+  it("onMount() calls observe() with the element", () => {
+    const observeFn = vi.fn();
+    vi.stubGlobal("IntersectionObserver", class {
+      constructor(cb: IntersectionObserverCallback) { observerCallback = cb; }
+      observe = observeFn;
+      disconnect = vi.fn();
+    });
+
+    const el = document.createElement("div");
+    const ref = { current: el };
+    const int = new Intersection(ref);
+    int.setup();
+    int.onMount();
+
+    expect(observeFn).toHaveBeenCalledWith(el);
+  });
+
+  it("onMount() does nothing when ref is null", () => {
+    const observeFn = vi.fn();
+    vi.stubGlobal("IntersectionObserver", class {
+      constructor(cb: IntersectionObserverCallback) { observerCallback = cb; }
+      observe = observeFn;
+      disconnect = vi.fn();
+    });
+
+    const ref = { current: null };
+    const int = new Intersection(ref);
+    int.setup();
+    expect(() => int.onMount()).not.toThrow();
+    expect(observeFn).not.toHaveBeenCalled();
+  });
 });
 
 // ── ElementSize (additional) ──────────────────────────────────────────────────
@@ -205,6 +245,7 @@ describe("ElementSize (additional)", () => {
     const ref = { current: el1 as HTMLElement | null };
     const es = new ElementSize(ref);
     es.setup();
+    es.onMount();
 
     // Disconnect old observer and create new one for el2
     es.onUnmount();
@@ -214,6 +255,7 @@ describe("ElementSize (additional)", () => {
     ref.current = el2;
     const es2 = new ElementSize(ref);
     es2.setup();
+    es2.onMount();
     expect(observeFn).toHaveBeenCalledWith(el2);
   });
 });
@@ -251,15 +293,56 @@ describe("Intersection (additional)", () => {
   });
 });
 
+// ── ScrollPosition (ref-based) ────────────────────────────────────────────────
+
+describe("ScrollPosition (ref-based)", () => {
+  it("accepts a ref object and reads scrollLeft/scrollTop from it", () => {
+    const el = document.createElement("div");
+    const ref = { current: el };
+    const sp = new ScrollPosition(ref);
+    const { x, y } = sp.setup() as { x: () => number; y: () => number };
+    sp.onMount();
+
+    Object.defineProperty(el, "scrollLeft", { value: 30, configurable: true });
+    Object.defineProperty(el, "scrollTop", { value: 60, configurable: true });
+    el.dispatchEvent(new Event("scroll"));
+
+    expect(x()).toBe(30);
+    expect(y()).toBe(60);
+  });
+
+  it("uses ref.current at mount time — subsequent current changes do not affect the listener target", () => {
+    const el = document.createElement("div");
+    const ref = { current: el as HTMLElement | null };
+    const sp = new ScrollPosition(ref);
+    sp.setup();
+    sp.onMount();
+
+    const remove = vi.spyOn(el, "removeEventListener");
+    sp.onUnmount();
+    expect(remove).toHaveBeenCalledWith("scroll", expect.any(Function));
+  });
+
+  it("falls back to window when ref.current is null at mount time", () => {
+    const ref = { current: null as HTMLElement | null };
+    const sp = new ScrollPosition(ref);
+    sp.setup();
+    // Should not throw; _target falls back to window
+    expect(() => sp.onMount()).not.toThrow();
+    sp.onUnmount();
+  });
+});
+
 // ── ScrollPosition (additional) ───────────────────────────────────────────────
 
 describe("ScrollPosition (additional)", () => {
-  it("setup() called twice registers only one scroll listener", () => {
+  it("onMount() called twice registers only one scroll listener", () => {
     const el = document.createElement("div");
     const add = vi.spyOn(el, "addEventListener");
     const sp = new ScrollPosition(el);
     sp.setup();
-    sp.setup();
+    sp.onMount();
+    sp.onMount(); // second call must be a no-op
     const scrollCalls = add.mock.calls.filter((c) => c[0] === "scroll").length;
     expect(scrollCalls).toBe(1);
   });
@@ -282,6 +365,7 @@ describe("Focus", () => {
     const ref = { current: el };
     const focus = new Focus(ref);
     const { focused } = focus.setup() as { focused: () => boolean };
+    focus.onMount();
 
     el.dispatchEvent(new Event("focus"));
     expect(focused()).toBe(true);
@@ -295,6 +379,7 @@ describe("Focus", () => {
     const ref = { current: el };
     const focus = new Focus(ref);
     const { focused } = focus.setup() as { focused: () => boolean };
+    focus.onMount();
 
     el.dispatchEvent(new Event("focus"));
     el.dispatchEvent(new Event("blur"));
@@ -309,40 +394,46 @@ describe("Focus", () => {
     expect(() => focus.setup()).not.toThrow();
   });
 
-  it("removes focus/blur listeners when reactive ref changes (effect cleanup)", () => {
-    const el1 = document.createElement("input");
-    document.body.appendChild(el1);
-
-    // Make ref.current reactive so the effect tracks it and re-runs on change
-    const refSignal = signal<HTMLElement | null>(el1);
-    const ref = { get current() { return refSignal(); } };
+  it("onMount() with null ref is a no-op", () => {
+    const ref = { current: null };
+    const focus = new Focus(ref);
+    focus.setup();
+    expect(() => focus.onMount()).not.toThrow();
+  });
 
+  it("onUnmount() with null ref is a no-op", () => {
+    const ref = { current: null };
     const focus = new Focus(ref);
     focus.setup();
+    expect(() => focus.onUnmount()).not.toThrow();
+  });
 
-    const removeEl1 = vi.spyOn(el1, "removeEventListener");
+  it("removes focus/blur listeners on unmount", () => {
+    const el = document.createElement("input");
+    document.body.appendChild(el);
+    const ref = { current: el };
+    const focus = new Focus(ref);
+    focus.setup();
+    focus.onMount();
 
-    // Changing the signal causes the effect to re-run, calling cleanup for el1
-    // This covers the cleanup function at dom.ts:134-135
-    const el2 = document.createElement("input");
-    document.body.appendChild(el2);
-    refSignal.set(el2);
+    const remove = vi.spyOn(el, "removeEventListener");
+    focus.onUnmount();
 
-    expect(removeEl1).toHaveBeenCalledWith("focus", expect.any(Function));
-    expect(removeEl1).toHaveBeenCalledWith("blur", expect.any(Function));
+    expect(remove).toHaveBeenCalledWith("focus", expect.any(Function));
+    expect(remove).toHaveBeenCalledWith("blur", expect.any(Function));
 
-    document.body.removeChild(el1);
-    document.body.removeChild(el2);
+    document.body.removeChild(el);
   });
 
-  it("setup() called twice registers only one listener pair", () => {
+  it("onMount() called twice registers only one listener pair", () => {
     const el = document.createElement("input");
     document.body.appendChild(el);
     const add = vi.spyOn(el, "addEventListener");
     const ref = { current: el };
     const focus = new Focus(ref);
     focus.setup();
-    focus.setup();
+    focus.onMount();
+    focus.onMount(); // second call must be a no-op
     const focusCalls = add.mock.calls.filter((c) => c[0] === "focus").length;
     expect(focusCalls).toBe(1);
     document.body.removeChild(el);

package/src/__tests__/list.test.ts

@@ -0,0 +1,210 @@
+// @vitest-environment jsdom
+import { describe, it, expect, vi } from "vitest";
+
+import { signal } from "@praxisjs/core/internal";
+
+// Import from index to cover re-exports
+import { VirtualList, type VirtualItem } from "../index";
+
+type AnyItem = { id: number };
+
+function makeItems(count: number): AnyItem[] {
+  return Array.from({ length: count }, (_, i) => ({ id: i }));
+}
+
+// ── VirtualList ───────────────────────────────────────────────────────────────
+
+describe("VirtualList", () => {
+  const ITEM_HEIGHT = 50;
+  const VIEW_HEIGHT = 600;
+  const BUFFER = 3;
+
+  it("setup() returns computed signals for all four properties", () => {
+    const ref = { current: null };
+    const vl = new VirtualList(ref, () => makeItems(10), ITEM_HEIGHT);
+    const view = vl.setup() as {
+      visibleItems: () => VirtualItem<AnyItem>[];
+      totalHeight: () => number;
+      offsetTop: () => number;
+      offsetBottom: () => number;
+    };
+
+    expect(typeof view.visibleItems).toBe("function");
+    expect(typeof view.totalHeight).toBe("function");
+    expect(typeof view.offsetTop).toBe("function");
+    expect(typeof view.offsetBottom).toBe("function");
+  });
+
+  it("totalHeight = items.length * itemHeight", () => {
+    const ref = { current: null };
+    const vl = new VirtualList(ref, () => makeItems(100), ITEM_HEIGHT);
+    const { totalHeight } = vl.setup() as { totalHeight: () => number };
+    expect(totalHeight()).toBe(100 * ITEM_HEIGHT);
+  });
+
+  it("offsetTop = 0 when scrolled to top", () => {
+    const ref = { current: null };
+    const vl = new VirtualList(ref, () => makeItems(100), ITEM_HEIGHT);
+    const { offsetTop } = vl.setup() as { offsetTop: () => number };
+    expect(offsetTop()).toBe(0);
+  });
+
+  it("visibleItems starts at index 0 with buffer window", () => {
+    const ref = { current: null };
+    // default viewHeight=600, buffer=3, scrollTop=0
+    // startIdx = max(0, floor(0/50) - 3) = 0
+    // endIdx   = min(99, ceil((0+600)/50) + 3) = min(99, 12+3) = 15
+    const vl = new VirtualList(ref, () => makeItems(100), ITEM_HEIGHT, BUFFER);
+    const { visibleItems } = vl.setup() as { visibleItems: () => VirtualItem<AnyItem>[] };
+
+    const items = visibleItems();
+    expect(items[0].index).toBe(0);
+    expect(items[items.length - 1].index).toBe(15);
+  });
+
+  it("visibleItems contains the correct item references", () => {
+    const source = makeItems(20);
+    const ref = { current: null };
+    const vl = new VirtualList(ref, () => source, ITEM_HEIGHT, 0);
+    const { visibleItems } = vl.setup() as { visibleItems: () => VirtualItem<AnyItem>[] };
+
+    const items = visibleItems();
+    expect(items[0].item).toBe(source[0]);
+    expect(items[0].index).toBe(0);
+  });
+
+  it("offsetBottom reflects the hidden rows below the window", () => {
+    const ref = { current: null };
+    // startIdx=0, endIdx=15, total=100
+    // offsetBottom = max(0, 100-1-15) * 50 = 84 * 50 = 4200
+    const vl = new VirtualList(ref, () => makeItems(100), ITEM_HEIGHT, BUFFER);
+    const { offsetBottom } = vl.setup() as { offsetBottom: () => number };
+    expect(offsetBottom()).toBe((100 - 1 - 15) * ITEM_HEIGHT);
+  });
+
+  it("empty list: all offsets are 0 and visibleItems is empty", () => {
+    const ref = { current: null };
+    const vl = new VirtualList(ref, () => [], ITEM_HEIGHT);
+    const { visibleItems, totalHeight, offsetTop, offsetBottom } = vl.setup() as {
+      visibleItems: () => VirtualItem<AnyItem>[];
+      totalHeight: () => number;
+      offsetTop: () => number;
+      offsetBottom: () => number;
+    };
+
+    expect(visibleItems()).toHaveLength(0);
+    expect(totalHeight()).toBe(0);
+    expect(offsetTop()).toBe(0);
+    expect(offsetBottom()).toBe(0);
+  });
+});
+
+// ── VirtualList — onMount ─────────────────────────────────────────────────────
+
+describe("VirtualList — onMount", () => {
+  const ITEM_HEIGHT = 50;
+
+  it("onMount() with null ref is a no-op", () => {
+    const ref = { current: null };
+    const vl = new VirtualList(ref, () => makeItems(10), ITEM_HEIGHT);
+    vl.setup();
+    expect(() => vl.onMount()).not.toThrow();
+  });
+
+  it("onMount() sets viewHeight from container's clientHeight when > 0", () => {
+    const el = document.createElement("div");
+    Object.defineProperty(el, "clientHeight", { value: 400, configurable: true });
+
+    const ref = { current: el };
+    const vl = new VirtualList(ref, () => makeItems(100), ITEM_HEIGHT, 0);
+    const { visibleItems } = vl.setup() as { visibleItems: () => VirtualItem<AnyItem>[] };
+    vl.onMount();
+
+    // With viewHeight=400 and no buffer: endIdx = min(99, ceil(400/50)-1) = 7
+    // Visible range [0..7] = 8 items
+    const items = visibleItems();
+    expect(items.length).toBeLessThan(100);
+    expect(items.length).toBeGreaterThan(0);
+    // Specifically: ceil((0+400)/50) + 0 = 8; min(99, 8) = 8 → indices 0..8 = 9 items
+    expect(items[items.length - 1].index).toBe(8);
+  });
+
+  it("onMount() does not override default viewHeight when clientHeight is 0", () => {
+    const el = document.createElement("div");
+    Object.defineProperty(el, "clientHeight", { value: 0, configurable: true });
+
+    const ref = { current: el };
+    const vl = new VirtualList(ref, () => makeItems(100), ITEM_HEIGHT, 0);
+    const { visibleItems } = vl.setup() as { visibleItems: () => VirtualItem<AnyItem>[] };
+    vl.onMount();
+
+    // Default viewHeight=600 preserved; endIdx = min(99, ceil(600/50)) = 12
+    const items = visibleItems();
+    expect(items[items.length - 1].index).toBe(12);
+  });
+
+  it("onMount() registers a scroll listener that updates the window", () => {
+    const el = document.createElement("div");
+    Object.defineProperty(el, "clientHeight", { value: 0, configurable: true });
+
+    const ref = { current: el };
+    const vl = new VirtualList(ref, () => makeItems(100), ITEM_HEIGHT, 0);
+    const { offsetTop } = vl.setup() as { offsetTop: () => number };
+    vl.onMount();
+
+    expect(offsetTop()).toBe(0);
+
+    Object.defineProperty(el, "scrollTop", { value: 500, configurable: true });
+    el.dispatchEvent(new Event("scroll"));
+
+    // scrollTop=500, buffer=0: startIdx = floor(500/50) = 10; offsetTop = 10*50 = 500
+    expect(offsetTop()).toBe(500);
+  });
+});
+
+// ── VirtualList — onUnmount ───────────────────────────────────────────────────
+
+describe("VirtualList — onUnmount", () => {
+  const ITEM_HEIGHT = 50;
+
+  it("onUnmount() removes the scroll listener", () => {
+    const el = document.createElement("div");
+    const remove = vi.spyOn(el, "removeEventListener");
+
+    const ref = { current: el };
+    const vl = new VirtualList(ref, () => makeItems(50), ITEM_HEIGHT);
+    vl.setup();
+    vl.onMount();
+    vl.onUnmount();
+
+    expect(remove).toHaveBeenCalledWith("scroll", expect.any(Function));
+  });
+
+  it("onUnmount() without prior onMount() does not throw", () => {
+    const ref = { current: null };
+    const vl = new VirtualList(ref, () => makeItems(10), ITEM_HEIGHT);
+    vl.setup();
+    expect(() => vl.onUnmount()).not.toThrow();
+  });
+});
+
+// ── VirtualList — reactive getItems ──────────────────────────────────────────
+
+describe("VirtualList — reactive getItems", () => {
+  it("visibleItems updates when the source signal changes", () => {
+    const itemsSignal = signal(makeItems(5));
+    const ref = { current: null };
+    const vl = new VirtualList(ref, () => itemsSignal(), 50);
+    const { visibleItems, totalHeight } = vl.setup() as {
+      visibleItems: () => VirtualItem<AnyItem>[];
+      totalHeight: () => number;
+    };
+
+    expect(totalHeight()).toBe(250);
+    expect(visibleItems()).toHaveLength(5);
+
+    itemsSignal.set(makeItems(10));
+    expect(totalHeight()).toBe(500);
+    expect(visibleItems()).toHaveLength(10);
+  });
+});

package/src/__tests__/utilities.test.ts

@@ -213,6 +213,17 @@ describe("TimeAgo", () => {
     expect(clearInterval).toHaveBeenCalled();
   });
 
+  it("interval callback fires after 60s — tick updates and value recomputes", () => {
+    const ta = new TimeAgo(() => now - 30_000, "en");
+    const { value } = ta.setup() as { value: () => string };
+    const before = value();
+    vi.advanceTimersByTime(60_000);
+    // After 60s the tick signal updates; value() still produces a valid string
+    expect(typeof value()).toBe("string");
+    expect(value()).not.toBe(undefined);
+    void before;
+  });
+
   it("future date produces a positive relative time string (e.g. 'in 30 seconds')", () => {
     // A future timestamp produces a positive diff; Intl.RelativeTimeFormat formats it as "in X"
     const ta = new TimeAgo(() => now + 30_000, "en");