@opendata-ai/openchart-vanilla 8.8.0 → 8.9.1

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export { ChartLayout, ChartSpec, CompileOptions, TableLayout, TableSpec, VizSpec } from '@opendata-ai/openchart-engine';
-import { BarListSpec, BarListLayout, ThemeConfig, DarkMode, ChartLayout, ChartSpec, LayerSpec, GeoMapSpec, GeoMapLayout, RectMark, Mark, BarTableCell, CategoryTableCell, TableCell, FlagTableCell, HeatmapTableCell, ImageTableCell, SparklineTableCell, TextTableCell, SankeySpec, SankeyLayout, TableSpec, SortState, TableLayout, TileMapSpec, TileMapLayout, ResolvedYouDrawIt } from '@opendata-ai/openchart-core';
-import { J as JPGExportOptions, S as SVGExportOptions, C as Camera } from './mount-WiY9BIr9.js';
-export { a as ChartInstance, E as ExportOptions, M as MountOptions, P as PNGExportOptions, U as UpdateOptions, c as createChart, e as exportCSV, b as exportJPG, d as exportPNG, f as exportSVG, g as exportSVGWithFonts } from './mount-WiY9BIr9.js';
+import { BarListSpec, BarListLayout, ThemeConfig, DarkMode, ChartLayout, ChartSpec, LayerSpec, GeoMapSpec, GeoMapLayout, ReaderSelection, DataRow, RectMark, Mark, BarTableCell, CategoryTableCell, TableCell, FlagTableCell, HeatmapTableCell, ImageTableCell, SparklineTableCell, TextTableCell, SankeySpec, SankeyLayout, TableSpec, SortState, TableLayout, TileMapSpec, TileMapLayout, ResolvedYouDrawIt } from '@opendata-ai/openchart-core';
+import { J as JPGExportOptions, S as SVGExportOptions, C as Camera, a as ChartInstance } from './mount-TEjIdF0m.js';
+export { E as ExportOptions, M as MountOptions, P as PNGExportOptions, U as UpdateOptions, c as createChart, e as exportCSV, b as exportJPG, d as exportPNG, f as exportSVG, g as exportSVGWithFonts } from './mount-TEjIdF0m.js';
 export { C as CameraFlightOptions, G as GRAPH_3D_NOT_REGISTERED_ERROR, a as GraphCamera, b as GraphFlyTarget, c as GraphHighlightTarget, d as GraphInstance, e as GraphLegendData, f as GraphMountOptions, g as GraphRendererContext, h as GraphRendererFactory, i as GraphShell, j as GraphTooltipFormatter, k as GraphTooltipItem, T as TooltipManager, l as createGraph, m as createTooltipManager, r as registerGraphRenderer } from './renderer-registry-Cng76n8F.js';
 import './export-gif.js';
 import '@floating-ui/dom';
@@ -269,6 +269,21 @@ declare const DEFAULT_UPDATE_MAX_MARKS = 500;
  */
 declare const CANVAS_DEFAULT_UPDATE_MAX_MARKS = 20000;
 
+interface ReaderController {
+    readonly selection: ReaderSelection;
+    /** Call after chart.update(). Without an override, visibility follows compiled marks. */
+    update(spec: ChartSpec | LayerSpec, visibleKeys?: ReadonlySet<string>): void;
+    pin(datum: DataRow): void;
+    clear(): void;
+    destroy(): void;
+}
+/**
+ * Persistent reader interaction, separate from editor ElementRef selection.
+ * Layered specs clear/disable inspection and announce the unsupported binding;
+ * updating back to a single chart resumes inspection without choosing a leaf.
+ */
+declare function createReader(container: HTMLElement, instance: ChartInstance, initial: ChartSpec | LayerSpec, onChange: (selection: ReaderSelection) => void): ReaderController;
+
 /**
  * Mark rendering: dispatches to per-mark-type sub-renderers (line, area, rect,
  * arc, point, text, rule, tick).
@@ -372,7 +387,7 @@ interface SankeyInstance {
     /** Re-compile at current container dimensions. */
     resize(): void;
     /** Export the sankey diagram. */
-    export(format: 'svg' | 'svg-with-fonts' | 'png' | 'jpg', options?: JPGExportOptions): string | Promise<Blob> | Promise<string>;
+    export(format: 'svg' | 'svg-with-fonts' | 'png' | 'jpg', options?: JPGExportOptions | SVGExportOptions): string | Promise<Blob> | Promise<string>;
     /** Remove all DOM elements and disconnect observers. */
     destroy(): void;
     /** The current compiled layout. */
@@ -417,8 +432,15 @@ declare function renderChartSVG(layout: ChartLayout, container: HTMLElement, opt
 interface KeyboardNavOptions {
     /** The wrapper element containing the whole table UI. */
     wrapper: HTMLElement;
+    /** Logical cell to restore after a resize, sort, or data update. */
+    initialCell?: {
+        rowId: string;
+        columnKey: string;
+    };
     /** Callback to trigger sort on a column. */
     onSort: (columnKey: string) => void;
+    /** Activate the focused row through the host's existing row-click callback. */
+    onRowActivate?: (rowId: string) => void;
     /** Callback to clear search and return focus to the table body. */
     onClearSearch: () => void;
     /** Callback to announce text to screen readers via the live region. */
@@ -632,4 +654,4 @@ interface YouDrawItController {
  */
 declare function createYouDrawIt(options: YouDrawItOptions): YouDrawItController;
 
-export { type BarListInstance, type BarListMountOptions, CANVAS_DEFAULT_UPDATE_MAX_MARKS, Camera, DEFAULT_UPDATE_MAX_MARKS, type GeoMapCameraOptions, type GeoMapInstance, type GeoMapMarkEvent, type GeoMapMountOptions, JPGExportOptions, type KeyboardNavOptions, SVGExportOptions, type SankeyInstance, type SankeyMountOptions, type SpecSequenceOptions, type TableInstance, type TableMountOptions, type TableState, type TextEditOverlayConfig, type TileMapInstance, type TileMapMountOptions, VECTOR_EXPORT_MAX_POINTS, type YouDrawItController, type YouDrawItOptions, attachKeyboardNav, createBarList, createGeoMap, createSankey, createSimulationWorker, createTable, createTextEditOverlay, createTileMap, createYouDrawIt, exportSpecSequence, materializeCanvasModeSVG, observeResize, rectPathWithCorners, registerMarkRenderer, renderBarCell, renderCategoryCell, renderCell, renderChartSVG, renderFlagCell, renderHeatmapCell, renderImageCell, renderSparklineCell, renderTable, renderTextCell };
+export { type BarListInstance, type BarListMountOptions, CANVAS_DEFAULT_UPDATE_MAX_MARKS, Camera, ChartInstance, DEFAULT_UPDATE_MAX_MARKS, type GeoMapCameraOptions, type GeoMapInstance, type GeoMapMarkEvent, type GeoMapMountOptions, JPGExportOptions, type KeyboardNavOptions, type ReaderController, SVGExportOptions, type SankeyInstance, type SankeyMountOptions, type SpecSequenceOptions, type TableInstance, type TableMountOptions, type TableState, type TextEditOverlayConfig, type TileMapInstance, type TileMapMountOptions, VECTOR_EXPORT_MAX_POINTS, type YouDrawItController, type YouDrawItOptions, attachKeyboardNav, createBarList, createGeoMap, createReader, createSankey, createSimulationWorker, createTable, createTextEditOverlay, createTileMap, createYouDrawIt, exportSpecSequence, materializeCanvasModeSVG, observeResize, rectPathWithCorners, registerMarkRenderer, renderBarCell, renderCategoryCell, renderCell, renderChartSVG, renderFlagCell, renderHeatmapCell, renderImageCell, renderSparklineCell, renderTable, renderTextCell };