@adobe/data-lit 0.10.30 → 0.10.31

package/README.md

@@ -16,6 +16,18 @@ import { ApplicationHost, DatabaseElement } from "@adobe/data-lit";
 import { createDatabase } from "@adobe/data/ecs";
 ```
 
+## State and resize callbacks
+
+`useState` returns a setter whose identity is stable for the lifetime of the hook state. The setter
+requests a render only when `Object.is` reports that the value has changed. Lazy initializers run once
+per hook state, including when the initial value is `null` or `undefined`.
+
+Treat state objects and arrays as immutable: pass a new object or array when its contents change.
+Mutating a value in place and passing the same reference to the setter does not request a render.
+
+`useResizeObserver` keeps its observer attached across renders and invokes the latest callback.
+Inline callbacks do not cause the observer to disconnect and reattach.
+
 ## Hooks and the disconnect lifecycle
 
 Hooks (`useState`, `useEffect`, `useObservable`, `useObservableValues`, `useMemo`, `useRef`, ...) follow

package/dist/hooks/use-resize-observer.js

@@ -1,6 +1,7 @@
 // © 2026 Adobe. MIT License. See /LICENSE for details.
 import { useEffect } from "./use-effect.js";
 import { useElement } from "./use-element.js";
+import { useRef } from "./use-ref.js";
 /**
  * Hook to observe element resizes. Calls callback with width, height, and the original entry
  * when the element's size changes.
@@ -9,15 +10,17 @@ import { useElement } from "./use-element.js";
  */
 export function useResizeObserver(onResize) {
     const element = useElement();
+    const latestCallback = useRef(onResize);
+    latestCallback.current = onResize;
     useEffect(() => {
         const observer = new ResizeObserver(entries => {
             for (const entry of entries) {
                 const { width, height } = entry.contentRect;
-                onResize({ width, height, entry });
+                latestCallback.current({ width, height, entry });
             }
         });
         observer.observe(element);
         return () => observer.disconnect();
-    }, [element, onResize]);
+    }, [element]);
 }
 //# sourceMappingURL=use-resize-observer.js.map

package/dist/hooks/use-resize-observer.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-resize-observer.js","sourceRoot":"","sources":["../../src/hooks/use-resize-observer.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAQ9C;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAoC;IAClE,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAE7B,SAAS,CAAC,GAAG,EAAE;QACX,MAAM,QAAQ,GAAG,IAAI,cAAc,CAAC,OAAO,CAAC,EAAE;YAC1C,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC1B,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC,WAAW,CAAC;gBAC5C,QAAQ,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;YACvC,CAAC;QACL,CAAC,CAAC,CAAC;QACH,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC1B,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;IACvC,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;AAC5B,CAAC"}
+{"version":3,"file":"use-resize-observer.js","sourceRoot":"","sources":["../../src/hooks/use-resize-observer.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAQtC;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAoC;IAClE,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,cAAc,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IACxC,cAAc,CAAC,OAAO,GAAG,QAAQ,CAAC;IAElC,SAAS,CAAC,GAAG,EAAE;QACX,MAAM,QAAQ,GAAG,IAAI,cAAc,CAAC,OAAO,CAAC,EAAE;YAC1C,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC1B,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC,WAAW,CAAC;gBAC5C,cAAc,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;YACrD,CAAC;QACL,CAAC,CAAC,CAAC;QACH,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC1B,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;IACvC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;AAClB,CAAC"}

package/dist/hooks/use-resize-observer.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/hooks/use-resize-observer.test.js

@@ -0,0 +1,102 @@
+// @vitest-environment happy-dom
+import { afterEach, describe, it, expect, vi } from "vitest";
+import { LitElement, html } from "lit";
+import { attachDecorator } from "./attach-decorator.js";
+import { withHooks } from "./with-hooks.js";
+import { useMemo } from "./use-memo.js";
+import { useResizeObserver } from "./use-resize-observer.js";
+import { useState } from "./use-state.js";
+class ResizeProbeElement extends LitElement {
+    constructor() {
+        super();
+        this.renders = 0;
+        this.offset = 0;
+        this.widths = [];
+        this.calculateCallback = vi.fn((setWidth) => setWidth);
+        attachDecorator(this, "render", withHooks);
+    }
+    render() {
+        this.renders++;
+        const [width, setWidth] = useState(0);
+        const memoizedSetter = useMemo(() => this.calculateCallback(setWidth), [setWidth]);
+        const offset = this.offset;
+        useResizeObserver(info => {
+            this.widths.push(info.width + offset);
+            memoizedSetter(Math.floor(info.width + offset));
+        });
+        return html `<span>${width}</span>`;
+    }
+}
+customElements.define("resize-state-probe", ResizeProbeElement);
+function mockResizeObserver() {
+    const observers = [];
+    vi.stubGlobal("ResizeObserver", class {
+        constructor(callback) {
+            this.observe = vi.fn();
+            this.disconnect = vi.fn();
+            observers.push({
+                emit: width => callback([
+                    { contentRect: { width, height: 20 } },
+                ], this),
+                observe: this.observe,
+                disconnect: this.disconnect,
+            });
+        }
+    });
+    return observers;
+}
+afterEach(async () => {
+    document.body.replaceChildren();
+    await new Promise(resolve => queueMicrotask(resolve));
+    vi.unstubAllGlobals();
+});
+describe("useResizeObserver with state", () => {
+    it("keeps one observer, uses the latest inline callback, and skips unchanged widths", async () => {
+        const observers = mockResizeObserver();
+        const element = document.createElement("resize-state-probe");
+        document.body.appendChild(element);
+        await element.updateComplete;
+        const observer = observers[0];
+        expect(observer.observe).toHaveBeenCalledExactlyOnceWith(element);
+        observer.emit(100.2);
+        await element.updateComplete;
+        expect(element.shadowRoot?.textContent).toBe("100");
+        expect(element.renders).toBe(2);
+        expect(observers).toHaveLength(1);
+        expect(observer.disconnect).not.toHaveBeenCalled();
+        expect(element.calculateCallback).toHaveBeenCalledTimes(1);
+        const requestUpdate = vi.spyOn(element, "requestUpdate");
+        observer.emit(100.8);
+        await element.updateComplete;
+        expect(requestUpdate).not.toHaveBeenCalled();
+        expect(element.renders).toBe(2);
+        element.offset = 10;
+        element.requestUpdate();
+        await element.updateComplete;
+        observer.emit(200);
+        await element.updateComplete;
+        expect(element.widths).toEqual([100.2, 100.8, 210]);
+        expect(element.shadowRoot?.textContent).toBe("210");
+        expect(observers).toHaveLength(1);
+        expect(observer.disconnect).not.toHaveBeenCalled();
+        expect(element.calculateCallback).toHaveBeenCalledTimes(1);
+    });
+    it("disconnects on unmount and creates fresh state and observer on remount", async () => {
+        const observers = mockResizeObserver();
+        const element = document.createElement("resize-state-probe");
+        document.body.appendChild(element);
+        await element.updateComplete;
+        observers[0].emit(100);
+        await element.updateComplete;
+        element.remove();
+        await new Promise(resolve => queueMicrotask(resolve));
+        expect(observers[0].disconnect).toHaveBeenCalledTimes(1);
+        document.body.appendChild(element);
+        await element.updateComplete;
+        expect(element.shadowRoot?.textContent).toBe("0");
+        expect(observers).toHaveLength(2);
+        expect(observers[1].observe).toHaveBeenCalledExactlyOnceWith(element);
+        expect(element.calculateCallback).toHaveBeenCalledTimes(2);
+    });
+});
+//# sourceMappingURL=use-resize-observer.test.js.map

package/dist/hooks/use-resize-observer.test.js.map

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

package/dist/hooks/use-state.js

@@ -3,13 +3,15 @@ import { Component_stack } from "./component/stack.js";
 export function useState(initial) {
     const component = Component_stack.active();
     const hookIndex = component.hookIndex++;
-    const value = component.hooks[hookIndex] ??= (typeof initial === "function" ? initial() : initial);
-    return [
-        value,
-        (newValue) => {
-            component.hooks[hookIndex] = newValue;
+    const state = component.hooks[hookIndex] ??= {
+        value: typeof initial === "function" ? initial() : initial,
+        setValue: (newValue) => {
+            if (Object.is(state.value, newValue))
+                return;
+            state.value = newValue;
             component.requestUpdate();
-        }
-    ];
+        },
+    };
+    return [state.value, state.setValue];
 }
 //# sourceMappingURL=use-state.js.map

package/dist/hooks/use-state.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-state.js","sourceRoot":"","sources":["../../src/hooks/use-state.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAIvD,MAAM,UAAU,QAAQ,CAAI,OAAgB;IACxC,MAAM,SAAS,GAAG,eAAe,CAAC,MAAM,EAAE,CAAC;IAC3C,MAAM,SAAS,GAAG,SAAS,CAAC,SAAS,EAAE,CAAC;IACxC,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IACnG,OAAO;QACH,KAAK;QACL,CAAC,QAAW,EAAE,EAAE;YACZ,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,QAAQ,CAAC;YACtC,SAAS,CAAC,aAAa,EAAE,CAAC;QAC9B,CAAC;KACJ,CAAC;AAEN,CAAC"}
+{"version":3,"file":"use-state.js","sourceRoot":"","sources":["../../src/hooks/use-state.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AASvD,MAAM,UAAU,QAAQ,CAAI,OAAsB;IAC9C,MAAM,SAAS,GAAG,eAAe,CAAC,MAAM,EAAE,CAAC;IAC3C,MAAM,SAAS,GAAG,SAAS,CAAC,SAAS,EAAE,CAAC;IACxC,MAAM,KAAK,GAAa,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK;QACnD,KAAK,EAAE,OAAO,OAAO,KAAK,UAAU,CAAC,CAAC,CAAE,OAAmB,EAAE,CAAC,CAAC,CAAC,OAAO;QACvE,QAAQ,EAAE,CAAC,QAAW,EAAE,EAAE;YACtB,IAAI,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,QAAQ,CAAC;gBAAE,OAAO;YAC7C,KAAK,CAAC,KAAK,GAAG,QAAQ,CAAC;YACvB,SAAS,CAAC,aAAa,EAAE,CAAC;QAC9B,CAAC;KACJ,CAAC;IACF,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;AACzC,CAAC"}

package/dist/hooks/use-state.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/hooks/use-state.test.js

@@ -0,0 +1,83 @@
+import { describe, it, expect, vi } from "vitest";
+import { Component_stack } from "./component/stack.js";
+import { useState } from "./use-state.js";
+function createHost() {
+    return Object.assign(new EventTarget(), {
+        isConnected: true,
+        hookIndex: 0,
+        hooks: [],
+        updatedListeners: new Set(),
+        requestUpdate: vi.fn(),
+    });
+}
+function render(host, callback) {
+    Component_stack.push(host);
+    try {
+        return callback();
+    }
+    finally {
+        Component_stack.pop();
+    }
+}
+describe("useState", () => {
+    it("keeps the setter stable across renders and updates", () => {
+        const host = createHost();
+        const [, setValue] = render(host, () => useState(0));
+        expect(render(host, () => useState(0))[1]).toBe(setValue);
+        setValue(1);
+        const [value, nextSetter] = render(host, () => useState(0));
+        expect(value).toBe(1);
+        expect(nextSetter).toBe(setValue);
+        expect(host.requestUpdate).toHaveBeenCalledTimes(1);
+    });
+    it.each([0, NaN, null, undefined, "value", false, {}, []])("does not request an update for an Object.is-equal value: %s", initial => {
+        const host = createHost();
+        const [, setValue] = render(host, () => useState(initial));
+        setValue(initial);
+        setValue(initial);
+        expect(host.requestUpdate).not.toHaveBeenCalled();
+    });
+    it("compares against the latest value before another render", () => {
+        const host = createHost();
+        const [, setValue] = render(host, () => useState(0));
+        setValue(1);
+        setValue(1);
+        setValue(2);
+        expect(host.requestUpdate).toHaveBeenCalledTimes(2);
+        expect(render(host, () => useState(0))[0]).toBe(2);
+    });
+    it("distinguishes positive and negative zero", () => {
+        const host = createHost();
+        const [, setValue] = render(host, () => useState(0));
+        setValue(-0);
+        expect(host.requestUpdate).toHaveBeenCalledTimes(1);
+        expect(render(host, () => useState(0))[0]).toBe(-0);
+    });
+    it.each([null, undefined])("initializes a nullish value only once: %s", initial => {
+        const host = createHost();
+        const initialize = vi.fn(() => initial);
+        render(host, () => useState(initialize));
+        render(host, () => useState(initialize));
+        expect(initialize).toHaveBeenCalledTimes(1);
+    });
+    it.each([null, undefined])("preserves a nullish update: %s", nextValue => {
+        const host = createHost();
+        const [, setValue] = render(host, () => useState(1));
+        setValue(nextValue);
+        expect(render(host, () => useState(1))[0]).toBe(nextValue);
+    });
+    it("keeps state slots and hosts independent", () => {
+        const host = createHost();
+        const otherHost = createHost();
+        const read = () => [useState(0), useState(10)];
+        const [first, second] = render(host, read);
+        const [other] = render(otherHost, read);
+        first[1](1);
+        expect(render(host, read).map(([value]) => value)).toEqual([1, 10]);
+        expect(render(otherHost, read).map(([value]) => value)).toEqual([0, 10]);
+        expect(first[1]).not.toBe(second[1]);
+        expect(first[1]).not.toBe(other[1]);
+        expect(otherHost.requestUpdate).not.toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=use-state.test.js.map

package/dist/hooks/use-state.test.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adobe/data-lit",
-  "version": "0.10.30",
+  "version": "0.10.31",
   "description": "Adobe data Lit bindings - hooks, elements, decorators",
   "type": "module",
   "private": false,
@@ -12,7 +12,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@adobe/data": "0.10.30"
+    "@adobe/data": "0.10.31"
   },
   "peerDependencies": {
     "lit": "^3.3.1"

package/src/hooks/use-resize-observer.test.ts

@@ -0,0 +1,114 @@
+// @vitest-environment happy-dom
+import { afterEach, describe, it, expect, vi } from "vitest";
+import { LitElement, html } from "lit";
+import { attachDecorator } from "./attach-decorator.js";
+import { withHooks } from "./with-hooks.js";
+import { useMemo } from "./use-memo.js";
+import { useResizeObserver } from "./use-resize-observer.js";
+import { useState } from "./use-state.js";
+
+class ResizeProbeElement extends LitElement {
+    renders = 0;
+    offset = 0;
+    widths: number[] = [];
+    calculateCallback = vi.fn((setWidth: (value: number) => void) => setWidth);
+
+    constructor() {
+        super();
+        attachDecorator(this, "render", withHooks);
+    }
+
+    render() {
+        this.renders++;
+        const [width, setWidth] = useState(0);
+        const memoizedSetter = useMemo(() => this.calculateCallback(setWidth), [setWidth]);
+        const offset = this.offset;
+        useResizeObserver(info => {
+            this.widths.push(info.width + offset);
+            memoizedSetter(Math.floor(info.width + offset));
+        });
+        return html`<span>${width}</span>`;
+    }
+}
+customElements.define("resize-state-probe", ResizeProbeElement);
+
+function mockResizeObserver() {
+    const observers: { emit: (width: number) => void; observe: ReturnType<typeof vi.fn>; disconnect: ReturnType<typeof vi.fn> }[] = [];
+    vi.stubGlobal("ResizeObserver", class {
+        observe = vi.fn();
+        disconnect = vi.fn();
+
+        constructor(callback: ResizeObserverCallback) {
+            observers.push({
+                emit: width => callback([
+                    { contentRect: { width, height: 20 } } as ResizeObserverEntry,
+                ], this as unknown as ResizeObserver),
+                observe: this.observe,
+                disconnect: this.disconnect,
+            });
+        }
+    });
+    return observers;
+}
+
+afterEach(async () => {
+    document.body.replaceChildren();
+    await new Promise<void>(resolve => queueMicrotask(resolve));
+    vi.unstubAllGlobals();
+});
+
+describe("useResizeObserver with state", () => {
+    it("keeps one observer, uses the latest inline callback, and skips unchanged widths", async () => {
+        const observers = mockResizeObserver();
+        const element = document.createElement("resize-state-probe") as ResizeProbeElement;
+        document.body.appendChild(element);
+        await element.updateComplete;
+        const observer = observers[0];
+        expect(observer.observe).toHaveBeenCalledExactlyOnceWith(element);
+
+        observer.emit(100.2);
+        await element.updateComplete;
+        expect(element.shadowRoot?.textContent).toBe("100");
+        expect(element.renders).toBe(2);
+        expect(observers).toHaveLength(1);
+        expect(observer.disconnect).not.toHaveBeenCalled();
+        expect(element.calculateCallback).toHaveBeenCalledTimes(1);
+
+        const requestUpdate = vi.spyOn(element, "requestUpdate");
+        observer.emit(100.8);
+        await element.updateComplete;
+        expect(requestUpdate).not.toHaveBeenCalled();
+        expect(element.renders).toBe(2);
+
+        element.offset = 10;
+        element.requestUpdate();
+        await element.updateComplete;
+        observer.emit(200);
+        await element.updateComplete;
+        expect(element.widths).toEqual([100.2, 100.8, 210]);
+        expect(element.shadowRoot?.textContent).toBe("210");
+        expect(observers).toHaveLength(1);
+        expect(observer.disconnect).not.toHaveBeenCalled();
+        expect(element.calculateCallback).toHaveBeenCalledTimes(1);
+    });
+
+    it("disconnects on unmount and creates fresh state and observer on remount", async () => {
+        const observers = mockResizeObserver();
+        const element = document.createElement("resize-state-probe") as ResizeProbeElement;
+        document.body.appendChild(element);
+        await element.updateComplete;
+        observers[0].emit(100);
+        await element.updateComplete;
+
+        element.remove();
+        await new Promise<void>(resolve => queueMicrotask(resolve));
+        expect(observers[0].disconnect).toHaveBeenCalledTimes(1);
+
+        document.body.appendChild(element);
+        await element.updateComplete;
+        expect(element.shadowRoot?.textContent).toBe("0");
+        expect(observers).toHaveLength(2);
+        expect(observers[1].observe).toHaveBeenCalledExactlyOnceWith(element);
+        expect(element.calculateCallback).toHaveBeenCalledTimes(2);
+    });
+});

package/src/hooks/use-resize-observer.ts

@@ -2,6 +2,7 @@
 
 import { useEffect } from "./use-effect.js";
 import { useElement } from "./use-element.js";
+import { useRef } from "./use-ref.js";
 
 export interface ResizeInfo {
     width: number;
@@ -17,15 +18,17 @@ export interface ResizeInfo {
  */
 export function useResizeObserver(onResize: (info: ResizeInfo) => void) {
     const element = useElement();
+    const latestCallback = useRef(onResize);
+    latestCallback.current = onResize;
 
     useEffect(() => {
         const observer = new ResizeObserver(entries => {
             for (const entry of entries) {
                 const { width, height } = entry.contentRect;
-                onResize({ width, height, entry });
+                latestCallback.current({ width, height, entry });
             }
         });
         observer.observe(element);
         return () => observer.disconnect();
-    }, [element, onResize]);
+    }, [element]);
 } 

package/src/hooks/use-state.test.ts

@@ -0,0 +1,108 @@
+import { describe, it, expect, vi } from "vitest";
+import type { Component } from "./component/component.js";
+import { Component_stack } from "./component/stack.js";
+import { useState } from "./use-state.js";
+
+function createHost(): Component {
+    return Object.assign(new EventTarget(), {
+        isConnected: true,
+        hookIndex: 0,
+        hooks: [],
+        updatedListeners: new Set<() => void>(),
+        requestUpdate: vi.fn(),
+    });
+}
+
+function render<T>(host: Component, callback: () => T): T {
+    Component_stack.push(host);
+    try {
+        return callback();
+    } finally {
+        Component_stack.pop();
+    }
+}
+
+describe("useState", () => {
+    it("keeps the setter stable across renders and updates", () => {
+        const host = createHost();
+        const [, setValue] = render(host, () => useState(0));
+        expect(render(host, () => useState(0))[1]).toBe(setValue);
+
+        setValue(1);
+
+        const [value, nextSetter] = render(host, () => useState(0));
+        expect(value).toBe(1);
+        expect(nextSetter).toBe(setValue);
+        expect(host.requestUpdate).toHaveBeenCalledTimes(1);
+    });
+
+    it.each([0, NaN, null, undefined, "value", false, {}, []])(
+        "does not request an update for an Object.is-equal value: %s",
+        initial => {
+            const host = createHost();
+            const [, setValue] = render(host, () => useState(initial));
+
+            setValue(initial);
+            setValue(initial);
+
+            expect(host.requestUpdate).not.toHaveBeenCalled();
+        },
+    );
+
+    it("compares against the latest value before another render", () => {
+        const host = createHost();
+        const [, setValue] = render(host, () => useState(0));
+
+        setValue(1);
+        setValue(1);
+        setValue(2);
+
+        expect(host.requestUpdate).toHaveBeenCalledTimes(2);
+        expect(render(host, () => useState(0))[0]).toBe(2);
+    });
+
+    it("distinguishes positive and negative zero", () => {
+        const host = createHost();
+        const [, setValue] = render(host, () => useState(0));
+
+        setValue(-0);
+
+        expect(host.requestUpdate).toHaveBeenCalledTimes(1);
+        expect(render(host, () => useState(0))[0]).toBe(-0);
+    });
+
+    it.each([null, undefined])("initializes a nullish value only once: %s", initial => {
+        const host = createHost();
+        const initialize = vi.fn(() => initial);
+
+        render(host, () => useState(initialize));
+        render(host, () => useState(initialize));
+
+        expect(initialize).toHaveBeenCalledTimes(1);
+    });
+
+    it.each([null, undefined])("preserves a nullish update: %s", nextValue => {
+        const host = createHost();
+        const [, setValue] = render(host, () => useState<number | null | undefined>(1));
+
+        setValue(nextValue);
+
+        expect(render(host, () => useState(1))[0]).toBe(nextValue);
+    });
+
+    it("keeps state slots and hosts independent", () => {
+        const host = createHost();
+        const otherHost = createHost();
+        const read = () => [useState(0), useState(10)] as const;
+        const [first, second] = render(host, read);
+        const [other] = render(otherHost, read);
+
+        first[1](1);
+
+        expect(render(host, read).map(([value]) => value)).toEqual([1, 10]);
+        expect(render(otherHost, read).map(([value]) => value)).toEqual([0, 10]);
+        expect(first[1]).not.toBe(second[1]);
+        expect(first[1]).not.toBe(other[1]);
+        expect(otherHost.requestUpdate).not.toHaveBeenCalled();
+    });
+});

package/src/hooks/use-state.ts

@@ -2,18 +2,23 @@
 
 import { Component_stack } from "./component/stack.js";
 
+interface State<T> {
+    value: T;
+    setValue: (value: T) => void;
+}
+
 export function useState<T>(initializer: () => T): [T, (value: T) => void]
 export function useState<T>(initialValue: T): [T, (value: T) => void]
-export function useState<T>(initial: () => T) {
+export function useState<T>(initial: T | (() => T)): [T, (value: T) => void] {
     const component = Component_stack.active();
     const hookIndex = component.hookIndex++;
-    const value = component.hooks[hookIndex] ??= (typeof initial === "function" ? initial() : initial);
-    return [
-        value,
-        (newValue: T) => {
-            component.hooks[hookIndex] = newValue;
+    const state: State<T> = component.hooks[hookIndex] ??= {
+        value: typeof initial === "function" ? (initial as () => T)() : initial,
+        setValue: (newValue: T) => {
+            if (Object.is(state.value, newValue)) return;
+            state.value = newValue;
             component.requestUpdate();
-        }
-    ];
-
+        },
+    };
+    return [state.value, state.setValue];
 }