@graphysdk/react-renderer 0.0.1-experimental.4 → 0.0.1-experimental.5

package/dist/index.d.ts

@@ -182,12 +182,14 @@ declare interface GraphProviderProps {
  * no `config` prop: every consumer must wrap with `<GraphProvider>` so commands can operate
  * on the live spec.
  */
-export declare const GraphRenderer: ({ slots, ...props }: GraphRendererProps) => JSX.Element;
+export declare const GraphRenderer: ({ slots, sizing, onResize, ...props }: GraphRendererProps) => JSX.Element;
 
-/** Props for {@link GraphRenderer}: pixel size, interaction toggles, and per-region slot overrides. */
+/** Props for {@link GraphRenderer}: container sizing, interaction toggles, and per-region slot overrides. */
 export declare interface GraphRendererProps {
-    width: number;
-    height: number;
+    /** Controls how the graph responds to its container size. Defaults to filling the parent container. */
+    sizing?: GraphSizing;
+    /** Callback invoked when the graph's container is resized. Fires in every sizing mode. */
+    onResize?: ResizeObserverOnResize;
     isAnimated?: boolean;
     showTooltips?: boolean;
     mode?: GraphMode;
@@ -195,6 +197,27 @@ export declare interface GraphRendererProps {
     slots?: GraphSlots;
 }
 
+/** Controls how the graph claims space in its container. */
+export declare type GraphSizing = {
+    mode: 'responsive';
+} | {
+    mode: 'fixed';
+    width: number;
+    height: number;
+} | {
+    mode: 'keepAspectRatio';
+    intrinsicWidth: number;
+    intrinsicHeight: number;
+} | {
+    mode: 'keepAspectRatio';
+    intrinsicWidth: number;
+    aspectRatio: number;
+} | {
+    mode: 'keepAspectRatio';
+    intrinsicHeight: number;
+    aspectRatio: number;
+};
+
 /**
  * Region overrides for `GraphRenderer`. Each slot replaces how one region paints; the viz-engine
  * `Spec` stays the source of truth for whether a region exists and what data it receives. An
@@ -295,6 +318,15 @@ export declare interface LegendSlotProps {
 /** vanilla-extract class that binds the light token values; the default theme. */
 export declare const lightTheme: string;
 
+export declare type ResizeObserverOnResize = (state: ResizeObserverState) => void;
+
+export declare interface ResizeObserverState {
+    width: number;
+    height: number;
+    /** True until the first ResizeObserver measurement lands. */
+    isDefault: boolean;
+}
+
 /**
  * Passed as the second argument to a layout-coupled slot's `measure`. Exposes the renderer's own
  * text measurer — the same Canvas-backed instance the built-in measurers use — and the active