Documentation / @finchart/react / useDataSource

Function: useDataSource()

useDataSource<T>(data): Source<T>

Defined in: react/src/hooks/use-data-source.ts:26

Turns a React state array into the core's Source — the bridge for the indicator lane.

Source's whole contract is read(): DataView<T>: if the reference changed, the value changed. React state lives by exactly that discipline (a new array every tick), so the only job here is "let something with a stable identity read the latest committed" — the Source this returns is the same object for the whole mount, so putting it in usePlugin's deps doesn't trigger a reinstall.

const source = useDataSource(bars);
usePlugin((plot) => plot.use(attachRsi({ source })), [source]);

Why this is the bridge instead of SeriesHandle: an attach* indicator's source: asks for nothing but a Source, not the whole handle, and the source identity exists from the first render. Updates become visible at commit, before passive plugin effects run. Commands that need a handle (updateLast and the like) are already covered the same way by declarative data.

Type Parameters

T

T extends BaseDataPoint

Parameters

data

T[]

Returns

Source<T>