Import src/client/store-hook.ts
This commit is contained in:
parent
5c7a95689f
commit
ba4e44232c
|
|
@ -0,0 +1,86 @@
|
||||||
|
/**
|
||||||
|
* A framework-shaped selector hook over a store instance.
|
||||||
|
*
|
||||||
|
* The renderer builds this hook for slot seats (`bindSnapshotSelector` in
|
||||||
|
* ui-renderer, wrapping React's `useSyncExternalStoreWithSelector`), but the tab
|
||||||
|
* strip is NOT a slot occupant: it renders through a DOM seat as a child of this
|
||||||
|
* plugin's own `sidebar.workspaces` occupant, so it receives its store face as a
|
||||||
|
* plain prop and needs the equivalent binding here.
|
||||||
|
*
|
||||||
|
* The implementation mirrors React's `useSyncExternalStoreWithSelector` without
|
||||||
|
* depending on the `use-sync-external-store` package (it is not resolvable from
|
||||||
|
* this plugin). The two behaviours that matter:
|
||||||
|
*
|
||||||
|
* - identity-stable subscribe/getSnapshot closures, so the strip never
|
||||||
|
* resubscribes across renders;
|
||||||
|
* - a memoized selection: the selector re-runs only when the state reference
|
||||||
|
* changes, and an equal result (by `eq`, defaulting to `Object.is`) returns
|
||||||
|
* the PREVIOUS reference, so a selector allocating a fresh array or object
|
||||||
|
* does not spin the render loop.
|
||||||
|
*
|
||||||
|
* The hook must be called unconditionally (Rules of Hooks).
|
||||||
|
*/
|
||||||
|
import { useCallback, useRef, useSyncExternalStore } from 'react'
|
||||||
|
import type { ActionsDecl, StoreInstance } from '@deepseek-ai/dsh-client-store'
|
||||||
|
|
||||||
|
/** One memory cell: the state it was derived from, and the value it produced. */
|
||||||
|
interface Selection<T, S> {
|
||||||
|
state: T
|
||||||
|
value: S
|
||||||
|
/** Whether `value` was produced by the selector (vs. carried over as equal). */
|
||||||
|
hasValue: boolean
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Build a selector hook bound to one store instance.
|
||||||
|
* @param instance - the live store instance (snapshot source).
|
||||||
|
* @returns a `SnapshotSelectorHook`-compatible hook over that instance.
|
||||||
|
*/
|
||||||
|
export function createStoreHook<T, A extends ActionsDecl<T>>(
|
||||||
|
instance: StoreInstance<T, A>,
|
||||||
|
): <S>(selector: (state: T) => S, eq?: (a: S, b: S) => boolean) => S {
|
||||||
|
// Captured once: stable closures keep uSES from resubscribing every render.
|
||||||
|
const subscribe = (onChange: () => void): (() => void) => instance.subscribe(onChange)
|
||||||
|
const getState = (): T => instance.getSnapshot()
|
||||||
|
|
||||||
|
return function useSelector<S>(
|
||||||
|
selector: (state: T) => S,
|
||||||
|
eq?: (a: S, b: S) => boolean,
|
||||||
|
): S {
|
||||||
|
// Seeded eagerly so the first render selects without an extra pass.
|
||||||
|
const memory = useRef<Selection<T, S> | null>(null)
|
||||||
|
|
||||||
|
// Re-select the value for the current state. Called by uSES on every
|
||||||
|
// notification AND on every render; the memory makes it cheap and
|
||||||
|
// reference-stable.
|
||||||
|
const getSelection = useCallback((): S => {
|
||||||
|
const state = getState()
|
||||||
|
const previous = memory.current
|
||||||
|
|
||||||
|
// Same state object => the previous value is still valid. This is the
|
||||||
|
// path that lets an allocating selector stay reference-stable.
|
||||||
|
if (previous !== null && previous.hasValue && Object.is(previous.state, state)) {
|
||||||
|
return previous.value
|
||||||
|
}
|
||||||
|
|
||||||
|
const value = selector(state)
|
||||||
|
|
||||||
|
// New state, but an equal value: carry the old reference forward so uSES
|
||||||
|
// sees no change and skips the re-render.
|
||||||
|
if (previous !== null && previous.hasValue) {
|
||||||
|
const equal = eq !== undefined ? eq(previous.value, value) : Object.is(previous.value, value)
|
||||||
|
if (equal) {
|
||||||
|
memory.current = { state, value: previous.value, hasValue: true }
|
||||||
|
return previous.value
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
memory.current = { state, value, hasValue: true }
|
||||||
|
return value
|
||||||
|
}, [selector, eq])
|
||||||
|
|
||||||
|
// The third argument is the server snapshot; the client plugin never
|
||||||
|
// server-renders, so the same getter is correct for both.
|
||||||
|
return useSyncExternalStore(subscribe, getSelection, getSelection)
|
||||||
|
}
|
||||||
|
}
|
||||||
Loading…
Reference in New Issue