@graphein/react 0.18.0 → 0.20.0

package/README.md

@@ -34,8 +34,14 @@ export function Dashboard() {
 ```
 
 `<Chart spec={…} />` renders into a fill-by-default container; pass a new `spec`
-to update in place, and it tears down on unmount. For headless control over your
-own element, use the `useChart(spec)` hook (returns a ref to attach).
+to update in place, and it tears down on unmount. `<Chart>` and `<Dashboard>`
+forward ordinary `<div>` props and refs. For headless control over your own
+element, use the `useChart(spec)` hook (returns a ref to attach).
+
+Selection state is safe under React 18 concurrency: `useSelection` subscribes via
+`useSyncExternalStore`, changing only the shared `store` does not drop the next
+spec update, and forwarded refs point at the host `<div>` while `onReady` exposes
+the Graphein chart/dashboard instance.
 
 ## Documentation
 

package/dist/index.d.ts

@@ -1,4 +1,5 @@
-import { RefObject, CSSProperties, ReactElement } from 'react';
+import * as react from 'react';
+import { RefObject, HTMLAttributes } from 'react';
 import { ChartInstance, SelectionStore, SelectionChangeListener, ChartSpec, DashboardInstance, DashboardSpec, SelectionValue } from 'graphein';
 export { ChartInstance, ChartSpec, DashboardInstance, DashboardSpec, SelectionChangeListener, SelectionStore, SelectionValue, createSelectionStore } from 'graphein';
 
@@ -36,11 +37,9 @@ interface UseChartOptions {
  */
 declare function useChart<T extends HTMLElement = HTMLDivElement>(spec: ChartSpec, options?: UseChartOptions): RefObject<T | null>;
 
-interface ChartProps extends UseChartOptions {
+interface ChartProps extends UseChartOptions, Omit<HTMLAttributes<HTMLDivElement>, 'children'> {
     /** The Graphein chart spec to render. */
     spec: ChartSpec;
-    className?: string;
-    style?: CSSProperties;
 }
 /**
  * Declarative React wrapper around the Graphein core runtime.
@@ -55,7 +54,7 @@ interface ChartProps extends UseChartOptions {
  * </div>
  * ```
  */
-declare function Chart({ spec, className, style, ...options }: ChartProps): ReactElement;
+declare const Chart: react.ForwardRefExoticComponent<ChartProps & react.RefAttributes<HTMLDivElement>>;
 
 interface UseDashboardOptions {
     /** Called with the live instance after each mount and update. */
@@ -88,11 +87,9 @@ interface UseDashboardOptions {
  */
 declare function useDashboard<T extends HTMLElement = HTMLDivElement>(spec: DashboardSpec, options?: UseDashboardOptions): RefObject<T | null>;
 
-interface DashboardProps extends UseDashboardOptions {
+interface DashboardProps extends UseDashboardOptions, Omit<HTMLAttributes<HTMLDivElement>, 'children'> {
     /** The Graphein dashboard spec to render. */
     spec: DashboardSpec;
-    className?: string;
-    style?: CSSProperties;
 }
 /**
  * Declarative React wrapper around the Graphein dashboard runtime.
@@ -105,7 +102,7 @@ interface DashboardProps extends UseDashboardOptions {
  * <Dashboard spec={{ type: 'dashboard', data, views, interactions: 'auto' }} />
  * ```
  */
-declare function Dashboard({ spec, className, style, ...options }: DashboardProps): ReactElement;
+declare const Dashboard: react.ForwardRefExoticComponent<DashboardProps & react.RefAttributes<HTMLDivElement>>;
 
 /** Anything that exposes a selection bus: a store, or a chart/dashboard instance. */
 type SelectionSource = SelectionStore | {
@@ -140,6 +137,6 @@ declare function useSelection(source: SelectionSource, name: string): [Selection
  * as React state. Core spec/instance types are re-exported for convenience.
  */
 
-declare const VERSION = "0.0.0";
+declare const VERSION = "0.20.0";
 
 export { Chart, type ChartProps, Dashboard, type DashboardProps, type SelectionSource, type UseChartOptions, type UseDashboardOptions, VERSION, useChart, useDashboard, useSelection };

package/dist/index.js

@@ -1,5 +1,9 @@
 // src/Chart.ts
-import { createElement } from "react";
+import {
+  createElement,
+  forwardRef,
+  useCallback
+} from "react";
 
 // src/useChart.ts
 import { useEffect, useRef } from "react";
@@ -19,35 +23,35 @@ function useChart(spec, options = {}) {
   storeRef.current = options.store;
   const inspectRef = useRef(options.inspect);
   inspectRef.current = options.inspect;
-  const skipNextUpdate = useRef(true);
+  const instanceSpecRef = useRef(null);
   useEffect(() => {
     const el = ref.current;
     if (!el) return;
-    const instance = render(el, specRef.current, {
+    const mountedSpec = specRef.current;
+    const instance = render(el, mountedSpec, {
       store: storeRef.current,
       inspect: inspectRef.current
     });
     instanceRef.current = instance;
+    instanceSpecRef.current = mountedSpec;
     const offSelection = instance.on(
       "selectionchange",
       (name, value) => onSelectionChangeRef.current?.(name, value)
     );
-    skipNextUpdate.current = true;
     onReadyRef.current?.(instance);
     return () => {
       offSelection();
       instance.destroy();
       instanceRef.current = null;
+      instanceSpecRef.current = null;
     };
   }, [options.store]);
   useEffect(() => {
-    if (skipNextUpdate.current) {
-      skipNextUpdate.current = false;
-      return;
-    }
     const instance = instanceRef.current;
     if (!instance) return;
+    if (instanceSpecRef.current === spec) return;
     instance.update(spec);
+    instanceSpecRef.current = spec;
     onReadyRef.current?.(instance);
   }, [spec]);
   return ref;
@@ -55,17 +59,34 @@ function useChart(spec, options = {}) {
 
 // src/Chart.ts
 var FILL = { width: "100%", height: "100%" };
-function Chart({ spec, className, style, ...options }) {
-  const ref = useChart(spec, options);
+var Chart = forwardRef(function Chart2({
+  spec,
+  onReady,
+  store,
+  onSelectionChange,
+  inspect,
+  style,
+  ...divProps
+}, forwardedRef) {
+  const ref = useChart(spec, { onReady, store, onSelectionChange, inspect });
+  const attachRef = useCallback((node) => {
+    ref.current = node;
+    if (typeof forwardedRef === "function") forwardedRef(node);
+    else if (forwardedRef) forwardedRef.current = node;
+  }, [forwardedRef, ref]);
   return createElement("div", {
-    ref,
-    className,
+    ...divProps,
+    ref: attachRef,
     style: style ? { ...FILL, ...style } : FILL
   });
-}
+});
 
 // src/Dashboard.ts
-import { createElement as createElement2 } from "react";
+import {
+  createElement as createElement2,
+  forwardRef as forwardRef2,
+  useCallback as useCallback2
+} from "react";
 
 // src/useDashboard.ts
 import { useEffect as useEffect2, useRef as useRef2 } from "react";
@@ -85,35 +106,35 @@ function useDashboard(spec, options = {}) {
   storeRef.current = options.store;
   const inspectRef = useRef2(options.inspect);
   inspectRef.current = options.inspect;
-  const skipNextUpdate = useRef2(true);
+  const instanceSpecRef = useRef2(null);
   useEffect2(() => {
     const el = ref.current;
     if (!el) return;
-    const instance = renderDashboard(el, specRef.current, {
+    const mountedSpec = specRef.current;
+    const instance = renderDashboard(el, mountedSpec, {
       store: storeRef.current,
       inspect: inspectRef.current
     });
     instanceRef.current = instance;
+    instanceSpecRef.current = mountedSpec;
     const offSelection = instance.on(
       "selectionchange",
       (name, value) => onSelectionChangeRef.current?.(name, value)
     );
-    skipNextUpdate.current = true;
     onReadyRef.current?.(instance);
     return () => {
       offSelection();
       instance.destroy();
       instanceRef.current = null;
+      instanceSpecRef.current = null;
     };
   }, [options.store]);
   useEffect2(() => {
-    if (skipNextUpdate.current) {
-      skipNextUpdate.current = false;
-      return;
-    }
     const instance = instanceRef.current;
     if (!instance) return;
+    if (instanceSpecRef.current === spec) return;
     instance.update(spec);
+    instanceSpecRef.current = spec;
     onReadyRef.current?.(instance);
   }, [spec]);
   return ref;
@@ -121,36 +142,46 @@ function useDashboard(spec, options = {}) {
 
 // src/Dashboard.ts
 var FILL2 = { width: "100%" };
-function Dashboard({ spec, className, style, ...options }) {
-  const ref = useDashboard(spec, options);
+var Dashboard = forwardRef2(function Dashboard2({
+  spec,
+  onReady,
+  store,
+  onSelectionChange,
+  inspect,
+  style,
+  ...divProps
+}, forwardedRef) {
+  const ref = useDashboard(spec, { onReady, store, onSelectionChange, inspect });
+  const attachRef = useCallback2((node) => {
+    ref.current = node;
+    if (typeof forwardedRef === "function") forwardedRef(node);
+    else if (forwardedRef) forwardedRef.current = node;
+  }, [forwardedRef, ref]);
   return createElement2("div", {
-    ref,
-    className,
+    ...divProps,
+    ref: attachRef,
     style: style ? { ...FILL2, ...style } : FILL2
   });
-}
+});
 
 // src/useSelection.ts
-import { useCallback, useEffect as useEffect3, useState } from "react";
+import { useCallback as useCallback3, useSyncExternalStore } from "react";
 function resolveStore(source) {
   if (!source) return null;
   return "store" in source ? source.store : source;
 }
 function useSelection(source, name) {
   const store = resolveStore(source);
-  const [value, setValue] = useState(() => store?.get(name) ?? null);
-  useEffect3(() => {
-    if (!store) {
-      setValue(null);
-      return;
-    }
-    setValue(store.get(name) ?? null);
-    const unsubscribe = store.subscribe((changed, next) => {
-      if (changed === name) setValue(next);
+  const subscribe = useCallback3((notify) => {
+    if (!store) return () => {
+    };
+    return store.subscribe((changed) => {
+      if (changed === name) notify();
     });
-    return unsubscribe;
   }, [store, name]);
-  const set = useCallback(
+  const getSnapshot = useCallback3(() => store?.get(name) ?? null, [store, name]);
+  const value = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+  const set = useCallback3(
     (next) => {
       store?.set(name, next ?? null);
     },
@@ -161,7 +192,7 @@ function useSelection(source, name) {
 
 // src/index.ts
 import { createSelectionStore } from "graphein";
-var VERSION = "0.0.0";
+var VERSION = "0.20.0";
 export {
   Chart,
   Dashboard,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/Chart.ts","../src/useChart.ts","../src/Dashboard.ts","../src/useDashboard.ts","../src/useSelection.ts","../src/index.ts"],"sourcesContent":["import { createElement, type CSSProperties, type ReactElement } from 'react';\nimport type { ChartSpec } from 'graphein';\nimport { useChart, type UseChartOptions } from './useChart';\n\nexport interface ChartProps extends UseChartOptions {\n  /** The Graphein chart spec to render. */\n  spec: ChartSpec;\n  className?: string;\n  style?: CSSProperties;\n}\n\nconst FILL: CSSProperties = { width: '100%', height: '100%' };\n\n/**\n * Declarative React wrapper around the Graphein core runtime.\n *\n * Renders a container `<div>` that fills its parent (override via `style`) and\n * draws `spec` into it. Pass a new `spec` to update; unmounting tears the chart\n * down. Give the parent an explicit size for best results.\n *\n * ```tsx\n * <div style={{ height: 360 }}>\n *   <Chart spec={{ type: 'line', data, encoding: { x, y } }} />\n * </div>\n * ```\n */\nexport function Chart({ spec, className, style, ...options }: ChartProps): ReactElement {\n  const ref = useChart<HTMLDivElement>(spec, options);\n  return createElement('div', {\n    ref,\n    className,\n    style: style ? { ...FILL, ...style } : FILL,\n  });\n}\n","import { useEffect, useRef, type RefObject } from 'react';\nimport {\n  render,\n  type ChartInstance,\n  type ChartSpec,\n  type SelectionChangeListener,\n  type SelectionStore,\n} from 'graphein';\n\nexport interface UseChartOptions {\n  /** Called with the live instance after each mount and update. */\n  onReady?: (instance: ChartInstance) => void;\n  /**\n   * A shared selection bus. Pass the same store to several charts (or a\n   * dashboard) to link them — cross-highlight / cross-filter. Should be stable\n   * across renders (e.g. `useMemo(() => createSelectionStore(), [])`); changing\n   * its identity remounts the chart.\n   */\n  store?: SelectionStore;\n  /** Called whenever any selection this chart is bound to changes. */\n  onSelectionChange?: SelectionChangeListener;\n  /**\n   * Publish the chart's config to a `data-graphein-spec` DOM attribute and\n   * re-render when an external tool edits it. Defaults to `true`; set `false` to\n   * opt out. Read once at mount.\n   */\n  inspect?: boolean;\n}\n\n/**\n * Mount an Graphein chart into a DOM node and keep it in sync with `spec`.\n *\n * Returns a ref to attach to the container element. The chart is created on\n * mount, re-rendered via `instance.update()` whenever `spec` changes identity,\n * and torn down on unmount. The effect lifecycle is StrictMode-safe (double\n * mount → destroy → mount produces no leaked instances or duplicate renders).\n *\n * ```tsx\n * const ref = useChart(spec);\n * return <div ref={ref} style={{ width: '100%', height: 360 }} />;\n * ```\n */\nexport function useChart<T extends HTMLElement = HTMLDivElement>(\n  spec: ChartSpec,\n  options: UseChartOptions = {},\n): RefObject<T | null> {\n  const ref = useRef<T | null>(null);\n  const instanceRef = useRef<ChartInstance | null>(null);\n  // Hold the latest spec / callback in refs so the mount effect (which runs\n  // once) always reads current values without re-subscribing.\n  const specRef = useRef(spec);\n  specRef.current = spec;\n  const onReadyRef = useRef(options.onReady);\n  onReadyRef.current = options.onReady;\n  const onSelectionChangeRef = useRef(options.onSelectionChange);\n  onSelectionChangeRef.current = options.onSelectionChange;\n  const storeRef = useRef(options.store);\n  storeRef.current = options.store;\n  const inspectRef = useRef(options.inspect);\n  inspectRef.current = options.inspect;\n  const skipNextUpdate = useRef(true);\n\n  useEffect(() => {\n    const el = ref.current;\n    if (!el) return;\n    const instance = render(el, specRef.current, {\n      store: storeRef.current,\n      inspect: inspectRef.current,\n    });\n    instanceRef.current = instance;\n    const offSelection = instance.on('selectionchange', (name, value) =>\n      onSelectionChangeRef.current?.(name, value),\n    );\n    // The update effect runs once right after this on mount; skip that pass so\n    // we don't redundantly re-render the freshly created chart.\n    skipNextUpdate.current = true;\n    onReadyRef.current?.(instance);\n    return () => {\n      offSelection();\n      instance.destroy();\n      instanceRef.current = null;\n    };\n  }, [options.store]);\n\n  useEffect(() => {\n    if (skipNextUpdate.current) {\n      skipNextUpdate.current = false;\n      return;\n    }\n    const instance = instanceRef.current;\n    if (!instance) return;\n    instance.update(spec);\n    onReadyRef.current?.(instance);\n  }, [spec]);\n\n  return ref;\n}\n","import { createElement, type CSSProperties, type ReactElement } from 'react';\nimport type { DashboardSpec } from 'graphein';\nimport { useDashboard, type UseDashboardOptions } from './useDashboard';\n\nexport interface DashboardProps extends UseDashboardOptions {\n  /** The Graphein dashboard spec to render. */\n  spec: DashboardSpec;\n  className?: string;\n  style?: CSSProperties;\n}\n\nconst FILL: CSSProperties = { width: '100%' };\n\n/**\n * Declarative React wrapper around the Graphein dashboard runtime.\n *\n * Renders a container `<div>` (full width by default; height comes from the\n * dashboard's grid rows) and draws `spec` into it. Pass a new `spec` to update;\n * unmounting tears it down. Auto-wires cross-interaction unless `spec` opts out.\n *\n * ```tsx\n * <Dashboard spec={{ type: 'dashboard', data, views, interactions: 'auto' }} />\n * ```\n */\nexport function Dashboard({ spec, className, style, ...options }: DashboardProps): ReactElement {\n  const ref = useDashboard<HTMLDivElement>(spec, options);\n  return createElement('div', {\n    ref,\n    className,\n    style: style ? { ...FILL, ...style } : FILL,\n  });\n}\n","import { useEffect, useRef, type RefObject } from 'react';\nimport {\n  renderDashboard,\n  type DashboardInstance,\n  type DashboardSpec,\n  type SelectionChangeListener,\n  type SelectionStore,\n} from 'graphein';\n\nexport interface UseDashboardOptions {\n  /** Called with the live instance after each mount and update. */\n  onReady?: (instance: DashboardInstance) => void;\n  /**\n   * A shared selection bus. Omit to let the dashboard own one internally; pass\n   * one (stable across renders) to drive it from React via {@link useSelection}\n   * or to link it with standalone charts. Changing its identity remounts.\n   */\n  store?: SelectionStore;\n  /** Called whenever any selection in the dashboard changes. */\n  onSelectionChange?: SelectionChangeListener;\n  /**\n   * Publish each view's config (and the dashboard's) to `data-graphein-spec` DOM\n   * attributes and re-render on external edits. Defaults to `true`; set `false` to\n   * opt out for the whole dashboard. Read once at mount.\n   */\n  inspect?: boolean;\n}\n\n/**\n * Mount an Graphein dashboard into a DOM node and keep it in sync with `spec`.\n *\n * Mirrors {@link useChart}: created on mount, updated in place when `spec`\n * changes identity, torn down on unmount, StrictMode-safe.\n *\n * ```tsx\n * const ref = useDashboard(dashboardSpec);\n * return <div ref={ref} style={{ width: '100%' }} />;\n * ```\n */\nexport function useDashboard<T extends HTMLElement = HTMLDivElement>(\n  spec: DashboardSpec,\n  options: UseDashboardOptions = {},\n): RefObject<T | null> {\n  const ref = useRef<T | null>(null);\n  const instanceRef = useRef<DashboardInstance | null>(null);\n  const specRef = useRef(spec);\n  specRef.current = spec;\n  const onReadyRef = useRef(options.onReady);\n  onReadyRef.current = options.onReady;\n  const onSelectionChangeRef = useRef(options.onSelectionChange);\n  onSelectionChangeRef.current = options.onSelectionChange;\n  const storeRef = useRef(options.store);\n  storeRef.current = options.store;\n  const inspectRef = useRef(options.inspect);\n  inspectRef.current = options.inspect;\n  const skipNextUpdate = useRef(true);\n\n  useEffect(() => {\n    const el = ref.current;\n    if (!el) return;\n    const instance = renderDashboard(el, specRef.current, {\n      store: storeRef.current,\n      inspect: inspectRef.current,\n    });\n    instanceRef.current = instance;\n    const offSelection = instance.on('selectionchange', (name, value) =>\n      onSelectionChangeRef.current?.(name, value),\n    );\n    skipNextUpdate.current = true;\n    onReadyRef.current?.(instance);\n    return () => {\n      offSelection();\n      instance.destroy();\n      instanceRef.current = null;\n    };\n  }, [options.store]);\n\n  useEffect(() => {\n    if (skipNextUpdate.current) {\n      skipNextUpdate.current = false;\n      return;\n    }\n    const instance = instanceRef.current;\n    if (!instance) return;\n    instance.update(spec);\n    onReadyRef.current?.(instance);\n  }, [spec]);\n\n  return ref;\n}\n","import { useCallback, useEffect, useState } from 'react';\nimport type { SelectionStore, SelectionValue } from 'graphein';\n\n/** Anything that exposes a selection bus: a store, or a chart/dashboard instance. */\nexport type SelectionSource =\n  | SelectionStore\n  | { store: SelectionStore }\n  | null\n  | undefined;\n\nfunction resolveStore(source: SelectionSource): SelectionStore | null {\n  if (!source) return null;\n  return 'store' in source ? source.store : source;\n}\n\n/**\n * Read and write a named selection as React state.\n *\n * Pass a shared {@link SelectionStore} (or a chart/dashboard instance, which\n * exposes one as `.store`) plus the param name. Returns the current value and a\n * setter that publishes to the bus — driving cross-highlight / cross-filter\n * across every visual bound to that store.\n *\n * ```tsx\n * const store = useMemo(() => createSelectionStore(), []);\n * const [region, setRegion] = useSelection(store, 'region');\n * // …\n * <Dashboard spec={spec} store={store} />\n * <button onClick={() => setRegion({ kind: 'set', field: 'region', values: ['West'] })}>\n *   West\n * </button>\n * ```\n */\nexport function useSelection(\n  source: SelectionSource,\n  name: string,\n): [SelectionValue | null, (value: SelectionValue | null) => void] {\n  const store = resolveStore(source);\n  const [value, setValue] = useState<SelectionValue | null>(() => store?.get(name) ?? null);\n\n  useEffect(() => {\n    if (!store) {\n      setValue(null);\n      return;\n    }\n    setValue(store.get(name) ?? null);\n    const unsubscribe = store.subscribe((changed, next) => {\n      if (changed === name) setValue(next);\n    });\n    return unsubscribe;\n  }, [store, name]);\n\n  const set = useCallback(\n    (next: SelectionValue | null) => {\n      store?.set(name, next ?? null);\n    },\n    [store, name],\n  );\n\n  return [value, set];\n}\n","/**\n * @graphein/react — a thin React wrapper around the `graphein` runtime.\n *\n * `<Chart spec={…} />` for a single chart or `<Dashboard spec={…} />` for a\n * cross-interacting page; the `useChart` / `useDashboard` hooks give headless\n * control over your own container, and `useSelection` reads/writes a selection\n * as React state. Core spec/instance types are re-exported for convenience.\n */\nexport { Chart, type ChartProps } from './Chart';\nexport { useChart, type UseChartOptions } from './useChart';\nexport { Dashboard, type DashboardProps } from './Dashboard';\nexport { useDashboard, type UseDashboardOptions } from './useDashboard';\nexport { useSelection, type SelectionSource } from './useSelection';\nexport { createSelectionStore } from 'graphein';\nexport type {\n  ChartSpec,\n  ChartInstance,\n  DashboardSpec,\n  DashboardInstance,\n  SelectionStore,\n  SelectionValue,\n  SelectionChangeListener,\n} from 'graphein';\n\nexport const VERSION = '0.0.0';\n"],"mappings":"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","names":["createElement","useEffect","useRef","FILL","createElement","useEffect"]}
+{"version":3,"sources":["../src/Chart.ts","../src/useChart.ts","../src/Dashboard.ts","../src/useDashboard.ts","../src/useSelection.ts","../src/index.ts"],"sourcesContent":["import {\n  createElement,\n  forwardRef,\n  useCallback,\n  type CSSProperties,\n  type HTMLAttributes,\n  type MutableRefObject,\n  type ReactElement,\n} from 'react';\nimport type { ChartSpec } from 'graphein';\nimport { useChart, type UseChartOptions } from './useChart';\n\nexport interface ChartProps extends UseChartOptions, Omit<HTMLAttributes<HTMLDivElement>, 'children'> {\n  /** The Graphein chart spec to render. */\n  spec: ChartSpec;\n}\n\nconst FILL: CSSProperties = { width: '100%', height: '100%' };\n\n/**\n * Declarative React wrapper around the Graphein core runtime.\n *\n * Renders a container `<div>` that fills its parent (override via `style`) and\n * draws `spec` into it. Pass a new `spec` to update; unmounting tears the chart\n * down. Give the parent an explicit size for best results.\n *\n * ```tsx\n * <div style={{ height: 360 }}>\n *   <Chart spec={{ type: 'line', data, encoding: { x, y } }} />\n * </div>\n * ```\n */\nexport const Chart = forwardRef<HTMLDivElement, ChartProps>(function Chart({\n  spec,\n  onReady,\n  store,\n  onSelectionChange,\n  inspect,\n  style,\n  ...divProps\n}, forwardedRef): ReactElement {\n  const ref = useChart<HTMLDivElement>(spec, { onReady, store, onSelectionChange, inspect });\n  const attachRef = useCallback((node: HTMLDivElement | null) => {\n    ref.current = node;\n    if (typeof forwardedRef === 'function') forwardedRef(node);\n    else if (forwardedRef) (forwardedRef as MutableRefObject<HTMLDivElement | null>).current = node;\n  }, [forwardedRef, ref]);\n  return createElement('div', {\n    ...divProps,\n    ref: attachRef,\n    style: style ? { ...FILL, ...style } : FILL,\n  });\n});\n","import { useEffect, useRef, type RefObject } from 'react';\nimport {\n  render,\n  type ChartInstance,\n  type ChartSpec,\n  type SelectionChangeListener,\n  type SelectionStore,\n} from 'graphein';\n\nexport interface UseChartOptions {\n  /** Called with the live instance after each mount and update. */\n  onReady?: (instance: ChartInstance) => void;\n  /**\n   * A shared selection bus. Pass the same store to several charts (or a\n   * dashboard) to link them — cross-highlight / cross-filter. Should be stable\n   * across renders (e.g. `useMemo(() => createSelectionStore(), [])`); changing\n   * its identity remounts the chart.\n   */\n  store?: SelectionStore;\n  /** Called whenever any selection this chart is bound to changes. */\n  onSelectionChange?: SelectionChangeListener;\n  /**\n   * Publish the chart's config to a `data-graphein-spec` DOM attribute and\n   * re-render when an external tool edits it. Defaults to `true`; set `false` to\n   * opt out. Read once at mount.\n   */\n  inspect?: boolean;\n}\n\n/**\n * Mount an Graphein chart into a DOM node and keep it in sync with `spec`.\n *\n * Returns a ref to attach to the container element. The chart is created on\n * mount, re-rendered via `instance.update()` whenever `spec` changes identity,\n * and torn down on unmount. The effect lifecycle is StrictMode-safe (double\n * mount → destroy → mount produces no leaked instances or duplicate renders).\n *\n * ```tsx\n * const ref = useChart(spec);\n * return <div ref={ref} style={{ width: '100%', height: 360 }} />;\n * ```\n */\nexport function useChart<T extends HTMLElement = HTMLDivElement>(\n  spec: ChartSpec,\n  options: UseChartOptions = {},\n): RefObject<T | null> {\n  const ref = useRef<T | null>(null);\n  const instanceRef = useRef<ChartInstance | null>(null);\n  // Hold the latest spec / callback in refs so the mount effect (which runs\n  // once) always reads current values without re-subscribing.\n  const specRef = useRef(spec);\n  specRef.current = spec;\n  const onReadyRef = useRef(options.onReady);\n  onReadyRef.current = options.onReady;\n  const onSelectionChangeRef = useRef(options.onSelectionChange);\n  onSelectionChangeRef.current = options.onSelectionChange;\n  const storeRef = useRef(options.store);\n  storeRef.current = options.store;\n  const inspectRef = useRef(options.inspect);\n  inspectRef.current = options.inspect;\n  const instanceSpecRef = useRef<ChartSpec | null>(null);\n\n  useEffect(() => {\n    const el = ref.current;\n    if (!el) return;\n    const mountedSpec = specRef.current;\n    const instance = render(el, mountedSpec, {\n      store: storeRef.current,\n      inspect: inspectRef.current,\n    });\n    instanceRef.current = instance;\n    instanceSpecRef.current = mountedSpec;\n    const offSelection = instance.on('selectionchange', (name, value) =>\n      onSelectionChangeRef.current?.(name, value),\n    );\n    onReadyRef.current?.(instance);\n    return () => {\n      offSelection();\n      instance.destroy();\n      instanceRef.current = null;\n      instanceSpecRef.current = null;\n    };\n  }, [options.store]);\n\n  useEffect(() => {\n    const instance = instanceRef.current;\n    if (!instance) return;\n    if (instanceSpecRef.current === spec) return;\n    instance.update(spec);\n    instanceSpecRef.current = spec;\n    onReadyRef.current?.(instance);\n  }, [spec]);\n\n  return ref;\n}\n","import {\n  createElement,\n  forwardRef,\n  useCallback,\n  type CSSProperties,\n  type HTMLAttributes,\n  type MutableRefObject,\n  type ReactElement,\n} from 'react';\nimport type { DashboardSpec } from 'graphein';\nimport { useDashboard, type UseDashboardOptions } from './useDashboard';\n\nexport interface DashboardProps extends UseDashboardOptions, Omit<HTMLAttributes<HTMLDivElement>, 'children'> {\n  /** The Graphein dashboard spec to render. */\n  spec: DashboardSpec;\n}\n\nconst FILL: CSSProperties = { width: '100%' };\n\n/**\n * Declarative React wrapper around the Graphein dashboard runtime.\n *\n * Renders a container `<div>` (full width by default; height comes from the\n * dashboard's grid rows) and draws `spec` into it. Pass a new `spec` to update;\n * unmounting tears it down. Auto-wires cross-interaction unless `spec` opts out.\n *\n * ```tsx\n * <Dashboard spec={{ type: 'dashboard', data, views, interactions: 'auto' }} />\n * ```\n */\nexport const Dashboard = forwardRef<HTMLDivElement, DashboardProps>(function Dashboard({\n  spec,\n  onReady,\n  store,\n  onSelectionChange,\n  inspect,\n  style,\n  ...divProps\n}, forwardedRef): ReactElement {\n  const ref = useDashboard<HTMLDivElement>(spec, { onReady, store, onSelectionChange, inspect });\n  const attachRef = useCallback((node: HTMLDivElement | null) => {\n    ref.current = node;\n    if (typeof forwardedRef === 'function') forwardedRef(node);\n    else if (forwardedRef) (forwardedRef as MutableRefObject<HTMLDivElement | null>).current = node;\n  }, [forwardedRef, ref]);\n  return createElement('div', {\n    ...divProps,\n    ref: attachRef,\n    style: style ? { ...FILL, ...style } : FILL,\n  });\n});\n","import { useEffect, useRef, type RefObject } from 'react';\nimport {\n  renderDashboard,\n  type DashboardInstance,\n  type DashboardSpec,\n  type SelectionChangeListener,\n  type SelectionStore,\n} from 'graphein';\n\nexport interface UseDashboardOptions {\n  /** Called with the live instance after each mount and update. */\n  onReady?: (instance: DashboardInstance) => void;\n  /**\n   * A shared selection bus. Omit to let the dashboard own one internally; pass\n   * one (stable across renders) to drive it from React via {@link useSelection}\n   * or to link it with standalone charts. Changing its identity remounts.\n   */\n  store?: SelectionStore;\n  /** Called whenever any selection in the dashboard changes. */\n  onSelectionChange?: SelectionChangeListener;\n  /**\n   * Publish each view's config (and the dashboard's) to `data-graphein-spec` DOM\n   * attributes and re-render on external edits. Defaults to `true`; set `false` to\n   * opt out for the whole dashboard. Read once at mount.\n   */\n  inspect?: boolean;\n}\n\n/**\n * Mount an Graphein dashboard into a DOM node and keep it in sync with `spec`.\n *\n * Mirrors {@link useChart}: created on mount, updated in place when `spec`\n * changes identity, torn down on unmount, StrictMode-safe.\n *\n * ```tsx\n * const ref = useDashboard(dashboardSpec);\n * return <div ref={ref} style={{ width: '100%' }} />;\n * ```\n */\nexport function useDashboard<T extends HTMLElement = HTMLDivElement>(\n  spec: DashboardSpec,\n  options: UseDashboardOptions = {},\n): RefObject<T | null> {\n  const ref = useRef<T | null>(null);\n  const instanceRef = useRef<DashboardInstance | null>(null);\n  const specRef = useRef(spec);\n  specRef.current = spec;\n  const onReadyRef = useRef(options.onReady);\n  onReadyRef.current = options.onReady;\n  const onSelectionChangeRef = useRef(options.onSelectionChange);\n  onSelectionChangeRef.current = options.onSelectionChange;\n  const storeRef = useRef(options.store);\n  storeRef.current = options.store;\n  const inspectRef = useRef(options.inspect);\n  inspectRef.current = options.inspect;\n  const instanceSpecRef = useRef<DashboardSpec | null>(null);\n\n  useEffect(() => {\n    const el = ref.current;\n    if (!el) return;\n    const mountedSpec = specRef.current;\n    const instance = renderDashboard(el, mountedSpec, {\n      store: storeRef.current,\n      inspect: inspectRef.current,\n    });\n    instanceRef.current = instance;\n    instanceSpecRef.current = mountedSpec;\n    const offSelection = instance.on('selectionchange', (name, value) =>\n      onSelectionChangeRef.current?.(name, value),\n    );\n    onReadyRef.current?.(instance);\n    return () => {\n      offSelection();\n      instance.destroy();\n      instanceRef.current = null;\n      instanceSpecRef.current = null;\n    };\n  }, [options.store]);\n\n  useEffect(() => {\n    const instance = instanceRef.current;\n    if (!instance) return;\n    if (instanceSpecRef.current === spec) return;\n    instance.update(spec);\n    instanceSpecRef.current = spec;\n    onReadyRef.current?.(instance);\n  }, [spec]);\n\n  return ref;\n}\n","import { useCallback, useSyncExternalStore } from 'react';\nimport type { SelectionStore, SelectionValue } from 'graphein';\n\n/** Anything that exposes a selection bus: a store, or a chart/dashboard instance. */\nexport type SelectionSource =\n  | SelectionStore\n  | { store: SelectionStore }\n  | null\n  | undefined;\n\nfunction resolveStore(source: SelectionSource): SelectionStore | null {\n  if (!source) return null;\n  return 'store' in source ? source.store : source;\n}\n\n/**\n * Read and write a named selection as React state.\n *\n * Pass a shared {@link SelectionStore} (or a chart/dashboard instance, which\n * exposes one as `.store`) plus the param name. Returns the current value and a\n * setter that publishes to the bus — driving cross-highlight / cross-filter\n * across every visual bound to that store.\n *\n * ```tsx\n * const store = useMemo(() => createSelectionStore(), []);\n * const [region, setRegion] = useSelection(store, 'region');\n * // …\n * <Dashboard spec={spec} store={store} />\n * <button onClick={() => setRegion({ kind: 'set', field: 'region', values: ['West'] })}>\n *   West\n * </button>\n * ```\n */\nexport function useSelection(\n  source: SelectionSource,\n  name: string,\n): [SelectionValue | null, (value: SelectionValue | null) => void] {\n  const store = resolveStore(source);\n\n  const subscribe = useCallback((notify: () => void) => {\n    if (!store) return () => {};\n    return store.subscribe((changed) => {\n      if (changed === name) notify();\n    });\n  }, [store, name]);\n\n  const getSnapshot = useCallback(() => store?.get(name) ?? null, [store, name]);\n  const value = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n\n  const set = useCallback(\n    (next: SelectionValue | null) => {\n      store?.set(name, next ?? null);\n    },\n    [store, name],\n  );\n\n  return [value, set];\n}\n","/**\n * @graphein/react — a thin React wrapper around the `graphein` runtime.\n *\n * `<Chart spec={…} />` for a single chart or `<Dashboard spec={…} />` for a\n * cross-interacting page; the `useChart` / `useDashboard` hooks give headless\n * control over your own container, and `useSelection` reads/writes a selection\n * as React state. Core spec/instance types are re-exported for convenience.\n */\nexport { Chart, type ChartProps } from './Chart';\nexport { useChart, type UseChartOptions } from './useChart';\nexport { Dashboard, type DashboardProps } from './Dashboard';\nexport { useDashboard, type UseDashboardOptions } from './useDashboard';\nexport { useSelection, type SelectionSource } from './useSelection';\nexport { createSelectionStore } from 'graphein';\nexport type {\n  ChartSpec,\n  ChartInstance,\n  DashboardSpec,\n  DashboardInstance,\n  SelectionStore,\n  SelectionValue,\n  SelectionChangeListener,\n} from 'graphein';\n\nexport const VERSION = '0.20.0';\n"],"mappings":";AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAKK;;;ACRP,SAAS,WAAW,cAA8B;AAClD;AAAA,EACE;AAAA,OAKK;AAmCA,SAAS,SACd,MACA,UAA2B,CAAC,GACP;AACrB,QAAM,MAAM,OAAiB,IAAI;AACjC,QAAM,cAAc,OAA6B,IAAI;AAGrD,QAAM,UAAU,OAAO,IAAI;AAC3B,UAAQ,UAAU;AAClB,QAAM,aAAa,OAAO,QAAQ,OAAO;AACzC,aAAW,UAAU,QAAQ;AAC7B,QAAM,uBAAuB,OAAO,QAAQ,iBAAiB;AAC7D,uBAAqB,UAAU,QAAQ;AACvC,QAAM,WAAW,OAAO,QAAQ,KAAK;AACrC,WAAS,UAAU,QAAQ;AAC3B,QAAM,aAAa,OAAO,QAAQ,OAAO;AACzC,aAAW,UAAU,QAAQ;AAC7B,QAAM,kBAAkB,OAAyB,IAAI;AAErD,YAAU,MAAM;AACd,UAAM,KAAK,IAAI;AACf,QAAI,CAAC,GAAI;AACT,UAAM,cAAc,QAAQ;AAC5B,UAAM,WAAW,OAAO,IAAI,aAAa;AAAA,MACvC,OAAO,SAAS;AAAA,MAChB,SAAS,WAAW;AAAA,IACtB,CAAC;AACD,gBAAY,UAAU;AACtB,oBAAgB,UAAU;AAC1B,UAAM,eAAe,SAAS;AAAA,MAAG;AAAA,MAAmB,CAAC,MAAM,UACzD,qBAAqB,UAAU,MAAM,KAAK;AAAA,IAC5C;AACA,eAAW,UAAU,QAAQ;AAC7B,WAAO,MAAM;AACX,mBAAa;AACb,eAAS,QAAQ;AACjB,kBAAY,UAAU;AACtB,sBAAgB,UAAU;AAAA,IAC5B;AAAA,EACF,GAAG,CAAC,QAAQ,KAAK,CAAC;AAElB,YAAU,MAAM;AACd,UAAM,WAAW,YAAY;AAC7B,QAAI,CAAC,SAAU;AACf,QAAI,gBAAgB,YAAY,KAAM;AACtC,aAAS,OAAO,IAAI;AACpB,oBAAgB,UAAU;AAC1B,eAAW,UAAU,QAAQ;AAAA,EAC/B,GAAG,CAAC,IAAI,CAAC;AAET,SAAO;AACT;;;AD7EA,IAAM,OAAsB,EAAE,OAAO,QAAQ,QAAQ,OAAO;AAerD,IAAM,QAAQ,WAAuC,SAASA,OAAM;AAAA,EACzE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAAG,cAA4B;AAC7B,QAAM,MAAM,SAAyB,MAAM,EAAE,SAAS,OAAO,mBAAmB,QAAQ,CAAC;AACzF,QAAM,YAAY,YAAY,CAAC,SAAgC;AAC7D,QAAI,UAAU;AACd,QAAI,OAAO,iBAAiB,WAAY,cAAa,IAAI;AAAA,aAChD,aAAc,CAAC,aAAyD,UAAU;AAAA,EAC7F,GAAG,CAAC,cAAc,GAAG,CAAC;AACtB,SAAO,cAAc,OAAO;AAAA,IAC1B,GAAG;AAAA,IACH,KAAK;AAAA,IACL,OAAO,QAAQ,EAAE,GAAG,MAAM,GAAG,MAAM,IAAI;AAAA,EACzC,CAAC;AACH,CAAC;;;AEpDD;AAAA,EACE,iBAAAC;AAAA,EACA,cAAAC;AAAA,EACA,eAAAC;AAAA,OAKK;;;ACRP,SAAS,aAAAC,YAAW,UAAAC,eAA8B;AAClD;AAAA,EACE;AAAA,OAKK;AAgCA,SAAS,aACd,MACA,UAA+B,CAAC,GACX;AACrB,QAAM,MAAMA,QAAiB,IAAI;AACjC,QAAM,cAAcA,QAAiC,IAAI;AACzD,QAAM,UAAUA,QAAO,IAAI;AAC3B,UAAQ,UAAU;AAClB,QAAM,aAAaA,QAAO,QAAQ,OAAO;AACzC,aAAW,UAAU,QAAQ;AAC7B,QAAM,uBAAuBA,QAAO,QAAQ,iBAAiB;AAC7D,uBAAqB,UAAU,QAAQ;AACvC,QAAM,WAAWA,QAAO,QAAQ,KAAK;AACrC,WAAS,UAAU,QAAQ;AAC3B,QAAM,aAAaA,QAAO,QAAQ,OAAO;AACzC,aAAW,UAAU,QAAQ;AAC7B,QAAM,kBAAkBA,QAA6B,IAAI;AAEzD,EAAAD,WAAU,MAAM;AACd,UAAM,KAAK,IAAI;AACf,QAAI,CAAC,GAAI;AACT,UAAM,cAAc,QAAQ;AAC5B,UAAM,WAAW,gBAAgB,IAAI,aAAa;AAAA,MAChD,OAAO,SAAS;AAAA,MAChB,SAAS,WAAW;AAAA,IACtB,CAAC;AACD,gBAAY,UAAU;AACtB,oBAAgB,UAAU;AAC1B,UAAM,eAAe,SAAS;AAAA,MAAG;AAAA,MAAmB,CAAC,MAAM,UACzD,qBAAqB,UAAU,MAAM,KAAK;AAAA,IAC5C;AACA,eAAW,UAAU,QAAQ;AAC7B,WAAO,MAAM;AACX,mBAAa;AACb,eAAS,QAAQ;AACjB,kBAAY,UAAU;AACtB,sBAAgB,UAAU;AAAA,IAC5B;AAAA,EACF,GAAG,CAAC,QAAQ,KAAK,CAAC;AAElB,EAAAA,WAAU,MAAM;AACd,UAAM,WAAW,YAAY;AAC7B,QAAI,CAAC,SAAU;AACf,QAAI,gBAAgB,YAAY,KAAM;AACtC,aAAS,OAAO,IAAI;AACpB,oBAAgB,UAAU;AAC1B,eAAW,UAAU,QAAQ;AAAA,EAC/B,GAAG,CAAC,IAAI,CAAC;AAET,SAAO;AACT;;;ADxEA,IAAME,QAAsB,EAAE,OAAO,OAAO;AAarC,IAAM,YAAYC,YAA2C,SAASC,WAAU;AAAA,EACrF;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAAG,cAA4B;AAC7B,QAAM,MAAM,aAA6B,MAAM,EAAE,SAAS,OAAO,mBAAmB,QAAQ,CAAC;AAC7F,QAAM,YAAYC,aAAY,CAAC,SAAgC;AAC7D,QAAI,UAAU;AACd,QAAI,OAAO,iBAAiB,WAAY,cAAa,IAAI;AAAA,aAChD,aAAc,CAAC,aAAyD,UAAU;AAAA,EAC7F,GAAG,CAAC,cAAc,GAAG,CAAC;AACtB,SAAOC,eAAc,OAAO;AAAA,IAC1B,GAAG;AAAA,IACH,KAAK;AAAA,IACL,OAAO,QAAQ,EAAE,GAAGJ,OAAM,GAAG,MAAM,IAAIA;AAAA,EACzC,CAAC;AACH,CAAC;;;AElDD,SAAS,eAAAK,cAAa,4BAA4B;AAUlD,SAAS,aAAa,QAAgD;AACpE,MAAI,CAAC,OAAQ,QAAO;AACpB,SAAO,WAAW,SAAS,OAAO,QAAQ;AAC5C;AAoBO,SAAS,aACd,QACA,MACiE;AACjE,QAAM,QAAQ,aAAa,MAAM;AAEjC,QAAM,YAAYA,aAAY,CAAC,WAAuB;AACpD,QAAI,CAAC,MAAO,QAAO,MAAM;AAAA,IAAC;AAC1B,WAAO,MAAM,UAAU,CAAC,YAAY;AAClC,UAAI,YAAY,KAAM,QAAO;AAAA,IAC/B,CAAC;AAAA,EACH,GAAG,CAAC,OAAO,IAAI,CAAC;AAEhB,QAAM,cAAcA,aAAY,MAAM,OAAO,IAAI,IAAI,KAAK,MAAM,CAAC,OAAO,IAAI,CAAC;AAC7E,QAAM,QAAQ,qBAAqB,WAAW,aAAa,WAAW;AAEtE,QAAM,MAAMA;AAAA,IACV,CAAC,SAAgC;AAC/B,aAAO,IAAI,MAAM,QAAQ,IAAI;AAAA,IAC/B;AAAA,IACA,CAAC,OAAO,IAAI;AAAA,EACd;AAEA,SAAO,CAAC,OAAO,GAAG;AACpB;;;AC5CA,SAAS,4BAA4B;AAW9B,IAAM,UAAU;","names":["Chart","createElement","forwardRef","useCallback","useEffect","useRef","FILL","forwardRef","Dashboard","useCallback","createElement","useCallback"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@graphein/react",
-  "version": "0.18.0",
+  "version": "0.20.0",
   "type": "module",
   "description": "Graphein React wrapper — declarative <Chart spec={...} /> for the Graphein visualization engine.",
   "license": "MIT",
@@ -46,17 +46,18 @@
     "access": "public"
   },
   "scripts": {
-    "build": "tsup",
+    "sync:version": "node ../core/scripts/sync-version.mjs .",
+    "build": "npm run sync:version && tsup",
     "dev": "tsup --watch",
     "test": "vitest run",
     "typecheck": "tsc --noEmit",
-    "prepack": "tsup"
+    "prepack": "npm run sync:version && tsup"
   },
   "peerDependencies": {
     "react": ">=18"
   },
   "dependencies": {
-    "graphein": "^0.18.0"
+    "graphein": "^0.20.0"
   },
   "devDependencies": {
     "@types/react": "^19.2.17",