@opendata-ai/openchart-engine 8.3.1 → 8.4.1

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as _opendata_ai_openchart_core from '@opendata-ai/openchart-core';
-import { AnimationEase, LegendLayout, ResolvedChrome, TooltipContent, A11yMetadata, ResolvedTheme, LegendEntry, CompileOptions, ChartLayout, LayerSpec, CompileTableOptions, TableLayout, ResolvedAnimationPhase, AnimationSpec, ResolvedAnimation, Point, DataRow, BarListEncoding, ThemeConfig, DarkMode, GeoMapGeo, GeoMapEncoding, LegendConfig, GeoMapPointsLayer, SankeyEncoding, SankeyNodeAlign, SankeyLinkColor, TileMapEncoding, TileMapPalette, MarkType, MarkDef, Encoding, ChromeText, Annotation, LabelConfig, Display, ColumnConfig, GraphSpec, GraphEncoding, GraphLayoutConfig, NodeOverride, GraphAnimationSpec, GraphInteractionConfig, ScaleType, EncodingChannel, FieldFormatContext, Rect, LayoutStrategy, VizSpec, Mark, BinTransform, CalculateTransform, ConditionalValueDef, FilterPredicate, TimeUnitTransform, Transform } from '@opendata-ai/openchart-core';
+import { AnimationEase, LegendLayout, ResolvedChrome, TooltipContent, A11yMetadata, ResolvedTheme, LegendEntry, CompileOptions, ChartLayout, LayerSpec, CompileTableOptions, TableLayout, ResolvedAnimationPhase, AnimationSpec, ResolvedAnimation, Point, DataRow, BarListEncoding, ThemeConfig, DarkMode, GeoMapGeo, GeoMapProjection, GeoMapEncoding, LegendConfig, GeoMapPointsLayer, SankeyEncoding, SankeyNodeAlign, SankeyLinkColor, TileMapEncoding, TileMapPalette, MarkType, MarkDef, Encoding, ChromeText, Annotation, LabelConfig, Display, ColumnConfig, TableDensity, SortState, GraphSpec, GraphEncoding, GraphLayoutConfig, NodeOverride, GraphAnimationSpec, GraphInteractionConfig, ScaleType, EncodingChannel, FieldFormatContext, Rect, LayoutStrategy, VizSpec, Mark, BinTransform, CalculateTransform, ConditionalValueDef, FilterPredicate, TimeUnitTransform, Transform } from '@opendata-ai/openchart-core';
 export { BarListLayout, BarListSpec, ChartLayout, ChartSpec, CompileOptions, CompileTableOptions, GeoMapLayout, GeoMapSpec, GraphLayout, GraphSpec, LayerSpec, SankeyLayout, SankeySpec, TableLayout, TableSpec, TileMapLayout, TileMapSpec, VizSpec } from '@opendata-ai/openchart-core';
 import { ScaleLinear, ScaleTime, ScaleLogarithmic, ScalePower, ScaleSymLog, ScaleBand, ScalePoint, ScaleOrdinal, ScaleQuantile, ScaleQuantize, ScaleThreshold } from 'd3-scale';
 
@@ -66,7 +66,7 @@ type GraphHoverMode = 'neighbors' | 'category' | 'node' | 'none';
 interface ResolvedGraphInteraction {
     /** Hover emphasis mode. Default `'neighbors'`. */
     hoverMode: GraphHoverMode;
-    /** Node dim tier during hover/focus. Default 0.15. */
+    /** Node dim tier during hover/focus. Default 0.3. */
     dimOpacity: number;
     /** Whether selecting a node flies the camera to it. Default false. */
     selectFlyTo: boolean;
@@ -421,7 +421,9 @@ interface NormalizedBarListSpec {
 
 interface NormalizedGeoMapSpec {
     type: 'map';
-    geo: Required<GeoMapGeo>;
+    geo: Required<Omit<GeoMapGeo, 'projection'>> & {
+        projection?: GeoMapProjection;
+    };
     data: Record<string, unknown>[];
     encoding: GeoMapEncoding;
     chrome: NormalizedChrome;
@@ -462,6 +464,10 @@ interface NormalizedSankeySpec {
     animation?: AnimationSpec;
     valueFormat?: string;
     linkOpacity?: number;
+    other?: number | {
+        threshold: number;
+        label?: string;
+    };
 }
 
 /**
@@ -604,6 +610,13 @@ interface NormalizedTableSpec {
         pageSize: number;
     };
     stickyFirstColumn: boolean;
+    density: TableDensity;
+    striped: boolean;
+    sort?: SortState;
+    totalRow?: {
+        label: string;
+    };
+    /** Mirrors `density === 'condensed'` for back-compat. */
     compact: boolean;
     responsive: boolean;
     animation?: AnimationSpec;
@@ -788,7 +801,7 @@ declare function computeArrowheadPoints(tipX: number, tipY: number, tangentX: nu
  * scored search, and two-pass deterministic placement.
  */
 
-type ObstacleKind = 'mark' | 'line' | 'area-fill' | 'legend' | 'data-label' | 'endpoint-label' | 'watermark' | 'axis-band' | 'annotation';
+type ObstacleKind = 'mark' | 'line' | 'area-fill' | 'legend' | 'data-label' | 'endpoint-label' | 'watermark' | 'axis-band' | 'annotation' | 'chrome';
 interface PlacementObstacle extends Rect {
     kind: ObstacleKind;
 }
@@ -822,6 +835,12 @@ interface AnnotationContext {
     debugPlacement?: boolean;
     /** When true, annotations that overlap are demoted to footnote markers instead of being hidden. */
     autoThin?: boolean;
+    /**
+     * First y an annotation label may occupy, in SVG coordinates. Callers pass
+     * the bottom of the top chrome block so hand-placed callouts stay clear of
+     * the title/subtitle. Defaults to the plain SVG clamp margin.
+     */
+    topBound?: number;
 }
 
 /**