@nova-lab/charts 0.0.0-stage → 1.0.1-dev.32

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (228) hide show
  1. package/LICENSE +202 -0
  2. package/README.md +158 -2
  3. package/dist/GeometryIndex-DDQ34Jf4.js +104 -0
  4. package/dist/MarkSeries-CQCAnV4s.js +245 -0
  5. package/dist/aggregation.d.ts +6 -0
  6. package/dist/aggregation.js +124 -0
  7. package/dist/annotations.d.ts +34 -0
  8. package/dist/annotations.js +71 -0
  9. package/dist/api/camera.d.ts +8 -0
  10. package/dist/api/cartesian.d.ts +21 -0
  11. package/dist/api/events.d.ts +13 -0
  12. package/dist/api/font.d.ts +3 -0
  13. package/dist/api/handle.d.ts +5 -0
  14. package/dist/api/host.d.ts +23 -0
  15. package/dist/api/internal.d.ts +41 -0
  16. package/dist/api/map-background.d.ts +12 -0
  17. package/dist/api/mark-paint.d.ts +5 -0
  18. package/dist/api/mark-style.d.ts +4 -0
  19. package/dist/api/navigation.d.ts +4 -0
  20. package/dist/api/overlay.d.ts +7 -0
  21. package/dist/api/partition.d.ts +11 -0
  22. package/dist/api/scene.d.ts +42 -0
  23. package/dist/api/state.d.ts +34 -0
  24. package/dist/api/types.d.ts +743 -0
  25. package/dist/area.d.ts +9 -0
  26. package/dist/area.js +706 -0
  27. package/dist/bar.d.ts +9 -0
  28. package/dist/bar.js +554 -0
  29. package/dist/brush.d.ts +17 -0
  30. package/dist/brush.js +86 -0
  31. package/dist/bubble.d.ts +8 -0
  32. package/dist/bubble.js +434 -0
  33. package/dist/camera-CUJAMfpx.js +57 -0
  34. package/dist/candlestick.d.ts +8 -0
  35. package/dist/candlestick.js +42 -0
  36. package/dist/cartesian-k_WIYsGp.js +1139 -0
  37. package/dist/chart-runtime-resolver-DwwXp3X8.js +20 -0
  38. package/dist/chart-series-runtime-C0P7h8Tl.js +127 -0
  39. package/dist/charts.js +1 -0
  40. package/dist/composed.d.ts +2 -0
  41. package/dist/composed.js +4 -0
  42. package/dist/crosshair.d.ts +23 -0
  43. package/dist/crosshair.js +60 -0
  44. package/dist/donut.d.ts +5 -0
  45. package/dist/donut.js +7 -0
  46. package/dist/funnel.d.ts +5 -0
  47. package/dist/funnel.js +40 -0
  48. package/dist/graph.d.ts +6 -0
  49. package/dist/graph.js +260 -0
  50. package/dist/heatmap.d.ts +8 -0
  51. package/dist/heatmap.js +37 -0
  52. package/dist/host-DLDeDU5k.js +4373 -0
  53. package/dist/index.d.ts +1 -0
  54. package/dist/internal-I5BDhahD.js +4 -0
  55. package/dist/layout-donut-BG4ubBtU.js +39 -0
  56. package/dist/line.d.ts +9 -0
  57. package/dist/line.js +452 -0
  58. package/dist/mark-paint-CMHKGegE.js +14 -0
  59. package/dist/mark-style-Cpl-ARQM.js +10 -0
  60. package/dist/model/area/create-area-series-layout.d.ts +15 -0
  61. package/dist/model/area/hit-test-area-layout.d.ts +2 -0
  62. package/dist/model/axis/ChartAxisModel.d.ts +28 -0
  63. package/dist/model/bar/create-bar-series-layout.d.ts +19 -0
  64. package/dist/model/bar/hit-test-bar-layout.d.ts +2 -0
  65. package/dist/model/bubble/create-bubble-series-layout.d.ts +15 -0
  66. package/dist/model/bubble/hit-test-bubble-layout.d.ts +2 -0
  67. package/dist/model/cartesian/append-line-contours.d.ts +4 -0
  68. package/dist/model/cartesian/axis-line-batch.d.ts +3 -0
  69. package/dist/model/cartesian/numeric-window.d.ts +7 -0
  70. package/dist/model/cartesian/point-series.d.ts +54 -0
  71. package/dist/model/cartesian/sample-extrema.d.ts +7 -0
  72. package/dist/model/cartesian/smooth-y.d.ts +4 -0
  73. package/dist/model/cartesian/translation-window.d.ts +17 -0
  74. package/dist/model/context/nova-chart-runtime.d.ts +54 -0
  75. package/dist/model/customization/chart-customization.d.ts +47 -0
  76. package/dist/model/customization/chart-presets.d.ts +6 -0
  77. package/dist/model/customization/chart-style-sheet.d.ts +9 -0
  78. package/dist/model/data/ChartDataStore.d.ts +113 -0
  79. package/dist/model/exploration/create-graph-layout.d.ts +11 -0
  80. package/dist/model/exploration/exploration-chart.types.d.ts +150 -0
  81. package/dist/model/exploration/force-layout.d.ts +9 -0
  82. package/dist/model/exploration/presets/airplane.d.ts +2 -0
  83. package/dist/model/exploration/presets/apartment.d.ts +2 -0
  84. package/dist/model/exploration/presets/botanical-park.d.ts +2 -0
  85. package/dist/model/exploration/presets/ferry.d.ts +2 -0
  86. package/dist/model/exploration/presets/ice-arena.d.ts +2 -0
  87. package/dist/model/exploration/presets/planetarium.d.ts +2 -0
  88. package/dist/model/exploration/presets/science-museum.d.ts +2 -0
  89. package/dist/model/exploration/presets/train.d.ts +2 -0
  90. package/dist/model/exploration/route-geometry.d.ts +9 -0
  91. package/dist/model/exploration/seat-shape.d.ts +7 -0
  92. package/dist/model/interaction/GeometryIndex.d.ts +14 -0
  93. package/dist/model/line/create-line-series-layout.d.ts +15 -0
  94. package/dist/model/line/hit-test-line-layout.d.ts +2 -0
  95. package/dist/model/novel/create-novel-layout.d.ts +5 -0
  96. package/dist/model/novel/hit-test-novel-layout.d.ts +3 -0
  97. package/dist/model/novel/layout-candlestick.d.ts +3 -0
  98. package/dist/model/novel/layout-donut.d.ts +3 -0
  99. package/dist/model/novel/layout-funnel.d.ts +3 -0
  100. package/dist/model/novel/layout-heatmap.d.ts +3 -0
  101. package/dist/model/novel/layout-input.d.ts +12 -0
  102. package/dist/model/novel/layout-radar.d.ts +3 -0
  103. package/dist/model/novel/layout-tree.d.ts +3 -0
  104. package/dist/model/novel/layout-treemap.d.ts +3 -0
  105. package/dist/model/novel/layout-values.d.ts +10 -0
  106. package/dist/model/novel/novel-chart.types.d.ts +140 -0
  107. package/dist/model/novel/novel-domains.d.ts +5 -0
  108. package/dist/model/scale/BandScale.d.ts +86 -0
  109. package/dist/model/scale/ChartScaleRegistry.d.ts +45 -0
  110. package/dist/model/scale/LinearScale.d.ts +48 -0
  111. package/dist/model/scale/TimeScale.d.ts +48 -0
  112. package/dist/model/scale/create-chart-scale.d.ts +3 -0
  113. package/dist/model/scale/resolve-chart-scale.d.ts +5 -0
  114. package/dist/model/scatter/create-scatter-series-layout.d.ts +14 -0
  115. package/dist/model/scatter/hit-test-scatter-layout.d.ts +4 -0
  116. package/dist/model/time/calendar-time.d.ts +16 -0
  117. package/dist/model/types/chart-axis.types.d.ts +43 -0
  118. package/dist/model/types/chart-components.types.d.ts +1393 -0
  119. package/dist/model/types/chart-scale.types.d.ts +78 -0
  120. package/dist/model/viewport-controller/viewport-controller.d.ts +5 -0
  121. package/dist/novel-domains-DBpA_AOT.js +24 -0
  122. package/dist/partition-D-0LTCr3.js +221 -0
  123. package/dist/presets/route-map/apartment.d.ts +2 -0
  124. package/dist/presets/route-map/apartment.js +116 -0
  125. package/dist/presets/route-map/botanical-park.d.ts +2 -0
  126. package/dist/presets/route-map/botanical-park.js +116 -0
  127. package/dist/presets/route-map/science-museum.d.ts +2 -0
  128. package/dist/presets/route-map/science-museum.js +45 -0
  129. package/dist/presets/seat-map/airplane.d.ts +2 -0
  130. package/dist/presets/seat-map/airplane.js +95 -0
  131. package/dist/presets/seat-map/ferry.d.ts +2 -0
  132. package/dist/presets/seat-map/ferry.js +54 -0
  133. package/dist/presets/seat-map/ice-arena.d.ts +2 -0
  134. package/dist/presets/seat-map/ice-arena.js +67 -0
  135. package/dist/presets/seat-map/planetarium.d.ts +2 -0
  136. package/dist/presets/seat-map/planetarium.js +54 -0
  137. package/dist/presets/seat-map/train.d.ts +2 -0
  138. package/dist/presets/seat-map/train.js +66 -0
  139. package/dist/presets.d.ts +78 -0
  140. package/dist/presets.js +14 -0
  141. package/dist/public.d.ts +2 -0
  142. package/dist/radar.d.ts +5 -0
  143. package/dist/radar.js +47 -0
  144. package/dist/rose.d.ts +5 -0
  145. package/dist/rose.js +7 -0
  146. package/dist/route-map.d.ts +6 -0
  147. package/dist/route-map.js +200 -0
  148. package/dist/scatter.d.ts +8 -0
  149. package/dist/scatter.js +433 -0
  150. package/dist/scene-CPvPzTaB.js +137 -0
  151. package/dist/seat-map.d.ts +6 -0
  152. package/dist/seat-map.js +84 -0
  153. package/dist/seat-shape--kEFiUXX.js +66 -0
  154. package/dist/state-C5pICb11.js +134 -0
  155. package/dist/sync.d.ts +82 -0
  156. package/dist/sync.js +326 -0
  157. package/dist/translation-window-Ca_rCenJ.js +57 -0
  158. package/dist/tree.d.ts +6 -0
  159. package/dist/tree.js +114 -0
  160. package/dist/treemap.d.ts +5 -0
  161. package/dist/treemap.js +85 -0
  162. package/dist/ui/area-series/AreaSeries.d.ts +44 -0
  163. package/dist/ui/area-series/area-series.config.d.ts +10 -0
  164. package/dist/ui/area-series/area-series.registry.d.ts +4 -0
  165. package/dist/ui/axis/Axis.d.ts +55 -0
  166. package/dist/ui/axis/axis.config.d.ts +10 -0
  167. package/dist/ui/axis/axis.registry.d.ts +4 -0
  168. package/dist/ui/bar-chart/BarChart.d.ts +124 -0
  169. package/dist/ui/bar-chart/bar-chart.config.d.ts +10 -0
  170. package/dist/ui/bar-chart/bar-chart.registry.d.ts +2 -0
  171. package/dist/ui/bar-series/BarSeries.d.ts +102 -0
  172. package/dist/ui/bar-series/bar-series.config.d.ts +10 -0
  173. package/dist/ui/bar-series/bar-series.registry.d.ts +4 -0
  174. package/dist/ui/bubble-series/BubbleSeries.d.ts +33 -0
  175. package/dist/ui/bubble-series/bubble-series.config.d.ts +10 -0
  176. package/dist/ui/bubble-series/bubble-series.registry.d.ts +4 -0
  177. package/dist/ui/composed-chart/ComposedChart.d.ts +41 -0
  178. package/dist/ui/composed-chart/composed-chart.config.d.ts +10 -0
  179. package/dist/ui/composed-chart/composed-chart.registry.d.ts +4 -0
  180. package/dist/ui/exploration-chart/ExplorationChart.d.ts +83 -0
  181. package/dist/ui/exploration-chart/exploration-chart.config.d.ts +7 -0
  182. package/dist/ui/exploration-chart/exploration-chart.registry.d.ts +6 -0
  183. package/dist/ui/grid/Grid.d.ts +35 -0
  184. package/dist/ui/grid/grid.config.d.ts +10 -0
  185. package/dist/ui/grid/grid.registry.d.ts +4 -0
  186. package/dist/ui/interaction/Interaction.d.ts +53 -0
  187. package/dist/ui/interaction/interaction.config.d.ts +10 -0
  188. package/dist/ui/interaction/interaction.registry.d.ts +4 -0
  189. package/dist/ui/legend/Legend.d.ts +38 -0
  190. package/dist/ui/legend/legend.config.d.ts +10 -0
  191. package/dist/ui/legend/legend.registry.d.ts +2 -0
  192. package/dist/ui/line-series/LineSeries.d.ts +67 -0
  193. package/dist/ui/line-series/line-series.config.d.ts +10 -0
  194. package/dist/ui/line-series/line-series.registry.d.ts +4 -0
  195. package/dist/ui/mark-series/MarkSeries.d.ts +55 -0
  196. package/dist/ui/novel-series/NovelSeries.d.ts +34 -0
  197. package/dist/ui/novel-series/novel-series.config.d.ts +9 -0
  198. package/dist/ui/novel-series/novel-series.registry.d.ts +4 -0
  199. package/dist/ui/partition-chart/PartitionChart.d.ts +24 -0
  200. package/dist/ui/partition-chart/partition-chart.config.d.ts +7 -0
  201. package/dist/ui/partition-chart/partition-chart.registry.d.ts +9 -0
  202. package/dist/ui/plot/Plot.d.ts +64 -0
  203. package/dist/ui/plot/plot.config.d.ts +10 -0
  204. package/dist/ui/plot/plot.registry.d.ts +4 -0
  205. package/dist/ui/root/Root.d.ts +206 -0
  206. package/dist/ui/root/root.config.d.ts +10 -0
  207. package/dist/ui/root/root.registry.d.ts +5 -0
  208. package/dist/ui/scale/Scale.d.ts +55 -0
  209. package/dist/ui/scale/scale.config.d.ts +10 -0
  210. package/dist/ui/scale/scale.registry.d.ts +4 -0
  211. package/dist/ui/scatter-series/ScatterSeries.d.ts +33 -0
  212. package/dist/ui/scatter-series/scatter-series.config.d.ts +10 -0
  213. package/dist/ui/scatter-series/scatter-series.registry.d.ts +4 -0
  214. package/dist/ui/shared/chart-props.d.ts +150 -0
  215. package/dist/ui/shared/chart-runtime-resolver.d.ts +4 -0
  216. package/dist/ui/shared/chart-semantic-marks.d.ts +20 -0
  217. package/dist/ui/shared/chart-series-runtime.d.ts +48 -0
  218. package/dist/ui/shared/schema-types.d.ts +34 -0
  219. package/dist/ui/tooltip/Tooltip.d.ts +64 -0
  220. package/dist/ui/tooltip/tooltip.config.d.ts +10 -0
  221. package/dist/ui/tooltip/tooltip.registry.d.ts +4 -0
  222. package/dist/ui/viewport/Viewport.d.ts +81 -0
  223. package/dist/ui/viewport/viewport.config.d.ts +10 -0
  224. package/dist/ui/viewport/viewport.registry.d.ts +2 -0
  225. package/dist/ui/viewport-controller/ViewportController.d.ts +30 -0
  226. package/dist/ui/viewport-controller/viewport-controller.config.d.ts +10 -0
  227. package/dist/ui/viewport-controller/viewport-controller.registry.d.ts +2 -0
  228. package/package.json +179 -4
@@ -0,0 +1,743 @@
1
+ import { NovaApp, NovaNode, NovaSchema, NovaSemanticSnapshot, NovaSurface, NovaSyncPort, NovaSyncTransaction } from '@nova-lab/core';
2
+ import { ChartScaleDomain, ChartScaleTick, ChartScaleTickOptions } from '../model/types/chart-scale.types';
3
+ export type ChartKind = 'bar' | 'line' | 'area' | 'scatter' | 'bubble' | 'heatmap' | 'candlestick' | 'composed' | 'donut' | 'rose' | 'treemap' | 'funnel' | 'radar' | 'tree' | 'graph' | 'aggregation' | 'route-map' | 'seat-map';
4
+ export type CartesianKind = Extract<ChartKind, 'bar' | 'line' | 'area' | 'scatter' | 'bubble' | 'heatmap' | 'candlestick'>;
5
+ export type ChartKey = string | number;
6
+ export type Field<T, V = unknown> = keyof T | ((row: T) => V);
7
+ export type ChangeOrigin = 'user' | 'api' | 'sync';
8
+ export interface Point {
9
+ x: number;
10
+ y: number;
11
+ }
12
+ export interface DatumRef {
13
+ type: 'datum';
14
+ seriesId: string;
15
+ key: ChartKey;
16
+ }
17
+ export interface BucketRef {
18
+ type: 'bucket';
19
+ seriesId: string;
20
+ key: string;
21
+ }
22
+ export interface NodeRef {
23
+ type: 'node';
24
+ key: ChartKey;
25
+ }
26
+ export interface EdgeRef {
27
+ type: 'edge';
28
+ key: ChartKey;
29
+ }
30
+ export interface SeatRef {
31
+ type: 'seat';
32
+ key: ChartKey;
33
+ }
34
+ export interface RouteRef {
35
+ type: 'route';
36
+ key: ChartKey;
37
+ }
38
+ export interface RegionRef {
39
+ type: 'region';
40
+ key: ChartKey;
41
+ }
42
+ export interface WalkerRef {
43
+ type: 'walker';
44
+ key: ChartKey;
45
+ }
46
+ export type ItemRef = DatumRef | BucketRef | NodeRef | EdgeRef | SeatRef | RouteRef | RegionRef | WalkerRef;
47
+ export interface ChartItem<T = unknown, R extends ItemRef = ItemRef> {
48
+ ref: R;
49
+ row?: T;
50
+ label: string;
51
+ value?: number;
52
+ point?: Point;
53
+ bounds?: {
54
+ x: number;
55
+ y: number;
56
+ width: number;
57
+ height: number;
58
+ };
59
+ members?: ReadonlyArray<ChartKey>;
60
+ }
61
+ export interface CartesianViewport {
62
+ ranges: Record<string, ChartScaleDomain>;
63
+ followTail?: {
64
+ scaleId: string;
65
+ span: number;
66
+ };
67
+ }
68
+ export interface CameraState {
69
+ center: Point;
70
+ zoom: number;
71
+ }
72
+ export interface NavigationState {
73
+ expanded: ReadonlyArray<ChartKey>;
74
+ drilldown: ReadonlyArray<ChartKey>;
75
+ }
76
+ export interface PlaybackState {
77
+ status: 'playing' | 'paused' | 'ended';
78
+ position: number;
79
+ duration: number;
80
+ rate: number;
81
+ loop: boolean;
82
+ }
83
+ export interface GraphState {
84
+ positions: ReadonlyArray<Point & {
85
+ key: ChartKey;
86
+ }>;
87
+ pinned: ReadonlyArray<ChartKey>;
88
+ }
89
+ export interface BrushState {
90
+ ranges: Record<string, ChartScaleDomain>;
91
+ }
92
+ export type ChartItemState = 'normal' | 'hovered' | 'selected' | 'focused' | 'highlighted' | 'disabled';
93
+ export interface ChartMarkStyle {
94
+ fill?: string;
95
+ stroke?: string;
96
+ strokeWidth?: number;
97
+ opacity?: number;
98
+ radius?: number;
99
+ }
100
+ export interface ChartPresentation {
101
+ styleSheet?: string;
102
+ styles?: Partial<Record<ChartItemState, ChartMarkStyle>>;
103
+ labels?: {
104
+ visible?: boolean;
105
+ format?: (item: ChartItem) => string;
106
+ };
107
+ formatters?: {
108
+ value?: (value: number, item: ChartItem) => string;
109
+ label?: (item: ChartItem) => string;
110
+ };
111
+ }
112
+ export interface ChartViewState<R extends ItemRef = ItemRef> {
113
+ selection: ReadonlyArray<R>;
114
+ visibility: Record<string, boolean>;
115
+ viewport?: CartesianViewport;
116
+ camera?: CameraState;
117
+ navigation?: NavigationState;
118
+ detail?: {
119
+ level: number;
120
+ groups: ReadonlyArray<ChartKey>;
121
+ };
122
+ playback?: PlaybackState;
123
+ graph?: GraphState;
124
+ brush?: BrushState;
125
+ }
126
+ export interface ChangeMeta {
127
+ origin?: ChangeOrigin;
128
+ }
129
+ export interface CommitMeta extends ChangeMeta {
130
+ requestId?: number;
131
+ }
132
+ export interface StateRequest<S extends ChartViewState = ChartViewState> {
133
+ id: number;
134
+ previous: S;
135
+ current: S;
136
+ origin: ChangeOrigin;
137
+ channel: keyof ChartViewState;
138
+ /** Отклоняет запрос, в том числе после асинхронной проверки приложением. */
139
+ reject: () => void;
140
+ }
141
+ export type StateOptions<S extends ChartViewState = ChartViewState> = {
142
+ mode?: 'uncontrolled';
143
+ initial?: Partial<S>;
144
+ } | {
145
+ mode: 'controlled';
146
+ value: S;
147
+ onRequestChange: (request: StateRequest<S>) => void | false;
148
+ };
149
+ export interface ChartStatus {
150
+ type: 'ready' | 'loading' | 'error';
151
+ message?: string;
152
+ }
153
+ export interface ChartCapabilities {
154
+ kind: ChartKind;
155
+ rows: boolean;
156
+ scales: boolean;
157
+ viewport: boolean;
158
+ camera: boolean;
159
+ drilldown: boolean;
160
+ expansion: boolean;
161
+ layout: boolean;
162
+ detail: boolean;
163
+ playback: boolean;
164
+ selection: boolean;
165
+ export: {
166
+ image: ReadonlyArray<'png' | 'jpeg' | 'webp'>;
167
+ data: ReadonlyArray<'json' | 'csv'>;
168
+ };
169
+ }
170
+ export interface ChartDiagnostics {
171
+ kind: ChartKind;
172
+ status: ChartStatus;
173
+ dataRevision: number;
174
+ stateRevision: number;
175
+ renderedItems: number;
176
+ sourceItems: number;
177
+ renderCount: number;
178
+ pendingRequests: number;
179
+ listeners: number;
180
+ destroyed: boolean;
181
+ phases: Record<string, number>;
182
+ }
183
+ export interface ChartLegendItem {
184
+ id: string;
185
+ label: string;
186
+ color?: string;
187
+ visible: boolean;
188
+ }
189
+ export interface ChartEvent<T> {
190
+ previous: T;
191
+ current: T;
192
+ origin: ChangeOrigin;
193
+ requestId?: number;
194
+ }
195
+ export interface ChartEvents<D, R extends ItemRef = ItemRef> {
196
+ dataChange: ChartEvent<D>;
197
+ optionsChange: ChartEvent<ChartOptions<D>>;
198
+ viewStateChange: ChartEvent<ChartViewState<R>>;
199
+ viewportChange: ChartEvent<CartesianViewport | undefined>;
200
+ cameraChange: ChartEvent<CameraState | undefined>;
201
+ selectionChange: ChartEvent<ReadonlyArray<R>>;
202
+ visibilityChange: ChartEvent<Record<string, boolean>>;
203
+ drilldownChange: ChartEvent<NavigationState | undefined>;
204
+ playbackChange: ChartEvent<PlaybackState | undefined>;
205
+ graphChange: ChartEvent<GraphState | undefined>;
206
+ brushChange: ChartEvent<BrushState | undefined>;
207
+ detailChange: ChartEvent<ChartViewState['detail']>;
208
+ filtersChange: ChartEvent<Record<string, RowFilter<unknown>>>;
209
+ hoverChange: ChartEvent<R | null>;
210
+ focusChange: ChartEvent<R | null>;
211
+ highlightChange: ChartEvent<Record<string, ReadonlyArray<R>>>;
212
+ tooltipChange: ChartEvent<{
213
+ item: R | null;
214
+ visible: boolean;
215
+ }>;
216
+ statusChange: ChartEvent<ChartStatus>;
217
+ destroy: ChartEvent<boolean>;
218
+ error: ChartEvent<unknown>;
219
+ }
220
+ export interface ChartFont {
221
+ family?: string;
222
+ size?: number;
223
+ weight?: 'normal' | 'bold' | '100' | '200' | '300' | '400' | '500' | '600' | '700' | '800' | '900';
224
+ }
225
+ export interface ChartOptions<D, R extends ItemRef = ItemRef> extends ChartPresentation {
226
+ id?: string;
227
+ data: D;
228
+ width?: number;
229
+ height?: number;
230
+ renderer?: 'canvas2d' | 'webgl';
231
+ maxDpr?: number;
232
+ state?: StateOptions<ChartViewState<R>>;
233
+ theme?: 'light' | 'dark';
234
+ palette?: ReadonlyArray<string>;
235
+ locale?: string;
236
+ timezone?: string;
237
+ background?: string;
238
+ font?: ChartFont;
239
+ title?: string;
240
+ description?: string;
241
+ tooltip?: false | {
242
+ format?: (item: ChartItem) => string;
243
+ };
244
+ legend?: false | {
245
+ interactive?: boolean;
246
+ position?: 'top' | 'bottom' | 'left' | 'right';
247
+ };
248
+ motion?: false | {
249
+ duration?: number;
250
+ respectReducedMotion?: boolean;
251
+ };
252
+ interaction?: {
253
+ hover?: boolean;
254
+ selection?: boolean;
255
+ pan?: boolean;
256
+ zoom?: boolean;
257
+ wheel?: 'modified' | 'zoom' | 'pan' | 'none';
258
+ speed?: number;
259
+ preventDefault?: 'handled' | 'always' | 'never';
260
+ };
261
+ accessibility?: false | {
262
+ name: string;
263
+ description?: string;
264
+ keyboard?: boolean;
265
+ maxItems?: number;
266
+ };
267
+ events?: Partial<{
268
+ [K in keyof ChartEvents<D, R>]: (event: ChartEvents<D, R>[K]) => void;
269
+ }>;
270
+ plugins?: ReadonlyArray<ChartPlugin>;
271
+ }
272
+ export interface ChartAttachTarget {
273
+ app: NovaApp;
274
+ surface: NovaSurface<Record<string, unknown>>;
275
+ parent?: NovaNode<Record<string, unknown>>;
276
+ }
277
+ export interface ResizeOptions {
278
+ width?: number;
279
+ height?: number;
280
+ }
281
+ export interface ImageExportOptions {
282
+ format?: 'png' | 'jpeg' | 'webp';
283
+ quality?: number;
284
+ background?: string;
285
+ pixelRatio?: number;
286
+ }
287
+ export interface DataExportOptions {
288
+ format?: 'json' | 'csv';
289
+ scope?: 'source' | 'filtered' | 'visible' | 'selected';
290
+ fields?: ReadonlyArray<string>;
291
+ aggregates?: 'members' | 'bucket' | 'reject';
292
+ }
293
+ export interface ChartHandle<D, R extends ItemRef = ItemRef, T = unknown, O extends ChartOptions<D, R> = ChartOptions<D, R>> {
294
+ readonly id: string;
295
+ readonly kind: ChartKind;
296
+ readonly canvas: HTMLCanvasElement;
297
+ readonly target: HTMLElement | null;
298
+ /** Возвращает исходные данные; фильтрация не меняет source. */
299
+ getData: () => D;
300
+ setData: (data: D, meta?: ChangeMeta) => void;
301
+ getOptions: () => O;
302
+ /** Objects объединяются, arrays заменяются; state меняется через setViewState. */
303
+ setOptions: (patch: Partial<O>, meta?: ChangeMeta) => void;
304
+ /** Объединяет уведомления и invalidation без обещания rollback. */
305
+ batch: <V>(callback: (chart: this) => V) => V;
306
+ resize: (options?: ResizeOptions) => void;
307
+ refresh: () => void;
308
+ setStatus: (status: ChartStatus) => void;
309
+ destroy: () => void;
310
+ getViewState: () => ChartViewState<R>;
311
+ /** Фиксирует принятое состояние; устаревший requestId возвращает false. */
312
+ setViewState: (state: ChartViewState<R>, meta?: CommitMeta) => boolean;
313
+ getCapabilities: () => ChartCapabilities;
314
+ getDiagnostics: () => ChartDiagnostics;
315
+ getItem: (ref: R) => ChartItem<T, R> | null;
316
+ hitTest: (point: Point, options?: {
317
+ radius?: number;
318
+ }) => ChartItem<T, R> | null;
319
+ getSelection: () => ReadonlyArray<R>;
320
+ setSelection: (refs: ReadonlyArray<R>, meta?: ChangeMeta) => void;
321
+ select: (refs: ReadonlyArray<R>, meta?: ChangeMeta) => void;
322
+ unselect: (refs: ReadonlyArray<R>, meta?: ChangeMeta) => void;
323
+ toggleSelection: (ref: R, meta?: ChangeMeta) => void;
324
+ clearSelection: (meta?: ChangeMeta) => void;
325
+ getLegendItems: () => ReadonlyArray<ChartLegendItem>;
326
+ getVisibility: () => Record<string, boolean>;
327
+ setVisibility: (visibility: Record<string, boolean>, meta?: ChangeMeta) => void;
328
+ getHover: () => R | null;
329
+ setHover: (ref: R | null, meta?: ChangeMeta) => void;
330
+ clearHover: (meta?: ChangeMeta) => void;
331
+ getFocus: () => R | null;
332
+ focus: (ref: R | null, meta?: ChangeMeta) => void;
333
+ getHighlights: () => Record<string, ReadonlyArray<R>>;
334
+ highlight: (name: string, refs: ReadonlyArray<R>, meta?: ChangeMeta) => void;
335
+ clearHighlight: (name?: string, meta?: ChangeMeta) => void;
336
+ showTooltip: (ref: R, point?: Point, meta?: ChangeMeta) => void;
337
+ hideTooltip: (meta?: ChangeMeta) => void;
338
+ setTheme: (theme: 'light' | 'dark') => void;
339
+ setPalette: (palette: ReadonlyArray<string>) => void;
340
+ exportChart: (options?: ImageExportOptions) => Promise<Blob>;
341
+ exportData: (options?: DataExportOptions) => Blob;
342
+ getSemanticSnapshot: () => NovaSemanticSnapshot;
343
+ on: <K extends keyof ChartEvents<D, R>>(event: K, listener: (value: ChartEvents<D, R>[K]) => void) => () => void;
344
+ use: (plugin: ChartPlugin) => () => void;
345
+ }
346
+ export interface ChartPluginContext {
347
+ chart: ChartHandle<unknown, ItemRef>;
348
+ /** Overlay использует renderer-neutral schema Nova Core и координаты текущего графика. */
349
+ overlay: (render: () => NovaSchema) => {
350
+ invalidate: () => void;
351
+ dispose: () => void;
352
+ };
353
+ size: () => {
354
+ width: number;
355
+ height: number;
356
+ };
357
+ /** Область данных в координатах графика, без полей осей. */
358
+ plotBounds: () => {
359
+ x: number;
360
+ y: number;
361
+ width: number;
362
+ height: number;
363
+ };
364
+ pointer: (listener: (event: PointerEvent, point: Point) => void) => () => void;
365
+ map: (scale: string, value: number | string) => number;
366
+ invert: (scale: string, pixel: number) => number | string;
367
+ axis: (scale: string) => 'x' | 'y';
368
+ request: (channel: keyof ChartViewState, value: unknown, origin?: ChangeOrigin, transaction?: NovaSyncTransaction) => void | false | Promise<void | false>;
369
+ port: (name: string, port: NovaSyncPort) => () => void;
370
+ notify: (port: string, transaction?: NovaSyncTransaction) => void;
371
+ }
372
+ export interface ChartPlugin {
373
+ readonly id: string;
374
+ attach: (context: ChartPluginContext) => () => void;
375
+ }
376
+ export type RowFilter<T> = {
377
+ type: 'range';
378
+ field: Field<T>;
379
+ min?: number;
380
+ max?: number;
381
+ } | {
382
+ type: 'in';
383
+ field: Field<T>;
384
+ values: ReadonlyArray<unknown>;
385
+ } | {
386
+ type: 'predicate';
387
+ test: (row: T) => boolean;
388
+ };
389
+ export interface RowsApi<T> {
390
+ getRow: (key: ChartKey) => T | undefined;
391
+ appendRows: (rows: ReadonlyArray<T>, options?: {
392
+ maxRows?: number;
393
+ }) => void;
394
+ patchRows: (patches: ReadonlyArray<{
395
+ key: ChartKey;
396
+ changes: Partial<T>;
397
+ }>) => void;
398
+ upsertRows: (rows: ReadonlyArray<T>) => void;
399
+ removeRows: (keys: ReadonlyArray<ChartKey>) => void;
400
+ setFilter: (name: string, filter: RowFilter<T>, meta?: ChangeMeta) => void;
401
+ getFilters: () => Record<string, RowFilter<T>>;
402
+ removeFilter: (name: string, meta?: ChangeMeta) => void;
403
+ clearFilters: (meta?: ChangeMeta) => void;
404
+ }
405
+ export interface ScaleOptions<T> {
406
+ id: string;
407
+ type: 'linear' | 'time' | 'band';
408
+ axis: 'x' | 'y';
409
+ field?: Field<T>;
410
+ domain?: ChartScaleDomain;
411
+ limits?: readonly [number, number];
412
+ minSpan?: number;
413
+ zero?: boolean;
414
+ nice?: boolean;
415
+ visible?: boolean;
416
+ ticks?: ChartScaleTickOptions;
417
+ /** Угол подписей горизонтальной оси в градусах. */
418
+ labelRotation?: 'auto' | number;
419
+ /** Отступы категориальной шкалы в долях шага. */
420
+ paddingInner?: number;
421
+ paddingOuter?: number;
422
+ }
423
+ export interface ScaleApi {
424
+ getType: () => 'linear' | 'time' | 'band';
425
+ getAxis: () => 'x' | 'y';
426
+ getDomain: () => ChartScaleDomain;
427
+ setDomain: (domain: ChartScaleDomain, meta?: ChangeMeta) => void;
428
+ getRange: () => readonly [number, number];
429
+ map: (value: string | number) => number;
430
+ invert: (pixel: number) => string | number;
431
+ getTicks: (options?: ChartScaleTickOptions) => ReadonlyArray<ChartScaleTick>;
432
+ }
433
+ export interface CartesianApi {
434
+ getScale: (id: string) => ScaleApi;
435
+ getSeries: () => ReadonlyArray<{
436
+ id: string;
437
+ type: CartesianKind;
438
+ visible: boolean;
439
+ }>;
440
+ setSeriesVisible: (id: string, visible: boolean, meta?: ChangeMeta) => void;
441
+ getViewport: () => CartesianViewport;
442
+ setViewport: (viewport: CartesianViewport, meta?: ChangeMeta) => void;
443
+ panBy: (delta: Point, meta?: ChangeMeta) => void;
444
+ zoomAt: (factor: number, anchor?: Point, meta?: ChangeMeta) => void;
445
+ fitContent: (meta?: ChangeMeta) => void;
446
+ fitSelection: (meta?: ChangeMeta) => void;
447
+ resetViewport: (meta?: ChangeMeta) => void;
448
+ followTail: (options: {
449
+ scaleId: string;
450
+ span: number;
451
+ } | false, meta?: ChangeMeta) => void;
452
+ }
453
+ export interface CameraApi {
454
+ getCamera: () => CameraState;
455
+ setCamera: (camera: CameraState, meta?: ChangeMeta) => void;
456
+ panBy: (delta: Point, meta?: ChangeMeta) => void;
457
+ zoomAt: (factor: number, anchor?: Point, meta?: ChangeMeta) => void;
458
+ fitContent: (meta?: ChangeMeta) => void;
459
+ fitSelection: (meta?: ChangeMeta) => void;
460
+ resetCamera: (meta?: ChangeMeta) => void;
461
+ }
462
+ export interface NavigationApi {
463
+ getDrilldown: () => ReadonlyArray<ChartKey>;
464
+ drillTo: (key: ChartKey, meta?: ChangeMeta) => void;
465
+ drillUp: (meta?: ChangeMeta) => void;
466
+ resetDrilldown: (meta?: ChangeMeta) => void;
467
+ }
468
+ export interface ExpansionApi {
469
+ expand: (keys: ReadonlyArray<ChartKey>, meta?: ChangeMeta) => void;
470
+ collapse: (keys: ReadonlyArray<ChartKey>, meta?: ChangeMeta) => void;
471
+ expandAll: (meta?: ChangeMeta) => void;
472
+ collapseAll: (meta?: ChangeMeta) => void;
473
+ getExpanded: () => ReadonlyArray<ChartKey>;
474
+ }
475
+ export interface SeriesOptions<T> extends ChartPresentation {
476
+ id: string;
477
+ x: Field<T>;
478
+ y: Field<T>;
479
+ xScaleId?: string;
480
+ yScaleId?: string;
481
+ series?: Field<T>;
482
+ label?: Field<T>;
483
+ size?: Field<T, number>;
484
+ value?: Field<T, number>;
485
+ color?: string | ((row: T) => string);
486
+ visible?: boolean;
487
+ strokeWidth?: number;
488
+ opacity?: number;
489
+ curve?: 'linear' | 'step' | 'smooth';
490
+ fill?: string;
491
+ gradientTo?: string | Record<string, string>;
492
+ gradientSteps?: number;
493
+ radiusRange?: readonly [number, number];
494
+ /** Расстояние от края ячейки Heatmap до границы её полосы, px. */
495
+ gap?: number;
496
+ upColor?: string;
497
+ downColor?: string;
498
+ connectNulls?: boolean;
499
+ defined?: (row: T) => boolean;
500
+ mode?: 'grouped' | 'stacked' | 'percent';
501
+ orientation?: 'vertical' | 'horizontal';
502
+ markers?: boolean;
503
+ baseline?: number;
504
+ sampling?: {
505
+ enabled?: boolean;
506
+ maxPoints?: number;
507
+ minBarWidthPx?: number;
508
+ aggregation?: 'auto' | 'avg' | 'sum' | 'min' | 'max';
509
+ };
510
+ open?: Field<T, number>;
511
+ high?: Field<T, number>;
512
+ low?: Field<T, number>;
513
+ close?: Field<T, number>;
514
+ }
515
+ export interface SeriesDefinition<T> extends SeriesOptions<T> {
516
+ readonly type: CartesianKind;
517
+ }
518
+ export interface CartesianOptions<T> extends ChartOptions<ReadonlyArray<T>, DatumRef | BucketRef>, Omit<SeriesOptions<T>, 'id'> {
519
+ key: Field<T, ChartKey>;
520
+ seriesId?: string;
521
+ scales?: ReadonlyArray<ScaleOptions<T>>;
522
+ axes?: boolean;
523
+ grid?: boolean;
524
+ }
525
+ export type CartesianHandle<T> = ChartHandle<ReadonlyArray<T>, DatumRef | BucketRef, T, CartesianOptions<T>> & RowsApi<T> & CartesianApi;
526
+ export interface ComposedOptions<T> extends ChartOptions<ReadonlyArray<T>, DatumRef | BucketRef> {
527
+ key: Field<T, ChartKey>;
528
+ scales: ReadonlyArray<ScaleOptions<T>>;
529
+ series: ReadonlyArray<SeriesDefinition<NoInfer<T>>>;
530
+ axes?: boolean;
531
+ grid?: boolean;
532
+ }
533
+ export interface CompositionApi<T> {
534
+ addSeries: (series: SeriesDefinition<T>) => void;
535
+ updateSeries: (id: string, patch: Partial<SeriesOptions<T>>) => void;
536
+ removeSeries: (id: string) => void;
537
+ setSeries: (series: ReadonlyArray<SeriesDefinition<T>>) => void;
538
+ }
539
+ export type ComposedHandle<T> = ChartHandle<ReadonlyArray<T>, DatumRef | BucketRef, T, ComposedOptions<T>> & RowsApi<T> & CartesianApi & CompositionApi<T>;
540
+ export interface PartitionOptions<T, R extends ItemRef = DatumRef> extends ChartOptions<ReadonlyArray<T>, R> {
541
+ key: Field<T, ChartKey>;
542
+ category: Field<T>;
543
+ value?: Field<T, number>;
544
+ parent?: Field<T, ChartKey | null>;
545
+ innerRadiusRatio?: number;
546
+ gap?: number;
547
+ maxValue?: number;
548
+ }
549
+ export type PartitionHandle<T, R extends ItemRef = DatumRef> = ChartHandle<ReadonlyArray<T>, R, T, PartitionOptions<T, R>> & RowsApi<T>;
550
+ export type TreeHandle<T> = PartitionHandle<T, NodeRef> & CameraApi & NavigationApi & ExpansionApi;
551
+ export type TreemapHandle<T> = PartitionHandle<T> & CameraApi & NavigationApi & ExpansionApi;
552
+ export interface ChartFactory<O, H> {
553
+ mount: (target: string | HTMLElement, options: O) => H;
554
+ attach: (target: ChartAttachTarget, options: O) => H;
555
+ }
556
+ export interface GraphNode {
557
+ key: ChartKey;
558
+ label?: string;
559
+ group?: string;
560
+ size?: number;
561
+ x?: number;
562
+ y?: number;
563
+ }
564
+ export interface GraphLink {
565
+ key: ChartKey;
566
+ source: ChartKey;
567
+ target: ChartKey;
568
+ label?: string;
569
+ weight?: number;
570
+ }
571
+ export interface GraphData {
572
+ nodes: ReadonlyArray<GraphNode>;
573
+ links: ReadonlyArray<GraphLink>;
574
+ }
575
+ export interface GraphOptions extends ChartOptions<GraphData, NodeRef | EdgeRef> {
576
+ layout?: {
577
+ type?: 'circular' | 'force';
578
+ iterations?: number;
579
+ };
580
+ }
581
+ export interface GraphApi {
582
+ getNode: (key: ChartKey) => GraphNode | undefined;
583
+ getLink: (key: ChartKey) => GraphLink | undefined;
584
+ upsertNodes: (nodes: ReadonlyArray<GraphNode>) => void;
585
+ patchNodes: (patches: ReadonlyArray<{
586
+ key: ChartKey;
587
+ changes: Partial<GraphNode>;
588
+ }>) => void;
589
+ removeNodes: (keys: ReadonlyArray<ChartKey>) => void;
590
+ upsertLinks: (links: ReadonlyArray<GraphLink>) => void;
591
+ patchLinks: (patches: ReadonlyArray<{
592
+ key: ChartKey;
593
+ changes: Partial<GraphLink>;
594
+ }>) => void;
595
+ removeLinks: (keys: ReadonlyArray<ChartKey>) => void;
596
+ getPositions: () => GraphState['positions'];
597
+ setPositions: (positions: GraphState['positions'], meta?: ChangeMeta) => void;
598
+ pin: (keys: ReadonlyArray<ChartKey>, meta?: ChangeMeta) => void;
599
+ unpin: (keys: ReadonlyArray<ChartKey>, meta?: ChangeMeta) => void;
600
+ getPinned: () => ReadonlyArray<ChartKey>;
601
+ runLayout: (options?: {
602
+ iterations?: number;
603
+ signal?: AbortSignal;
604
+ }) => Promise<'applied' | 'cancelled' | 'rejected'>;
605
+ stopLayout: () => void;
606
+ }
607
+ export type GraphHandle = ChartHandle<GraphData, NodeRef | EdgeRef, GraphNode | GraphLink, GraphOptions> & CameraApi & GraphApi;
608
+ export interface AggregationOptions<T> extends ChartOptions<ReadonlyArray<T>, DatumRef | BucketRef> {
609
+ key: Field<T, ChartKey>;
610
+ x: Field<T, number>;
611
+ y: Field<T, number>;
612
+ group: Field<T, ChartKey>;
613
+ detail?: {
614
+ level?: number;
615
+ cellSize?: number;
616
+ };
617
+ }
618
+ export interface AggregationApi {
619
+ getDetail: () => NonNullable<ChartViewState['detail']>;
620
+ setDetail: (level: number, meta?: ChangeMeta) => void;
621
+ getGroups: () => ReadonlyArray<{
622
+ key: ChartKey;
623
+ count: number;
624
+ }>;
625
+ setGroups: (keys: ReadonlyArray<ChartKey>, meta?: ChangeMeta) => void;
626
+ getDrilldown: () => ReadonlyArray<ChartKey>;
627
+ drillTo: (key: ChartKey, meta?: ChangeMeta) => void;
628
+ drillUp: (meta?: ChangeMeta) => void;
629
+ resetDrilldown: (meta?: ChangeMeta) => void;
630
+ }
631
+ export type AggregationHandle<T> = ChartHandle<ReadonlyArray<T>, DatumRef | BucketRef, T, AggregationOptions<T>> & RowsApi<T> & CameraApi & AggregationApi;
632
+ export type MapBackground = {
633
+ type: 'image';
634
+ src: string;
635
+ } | {
636
+ type: 'svg';
637
+ content: string;
638
+ };
639
+ export interface MapRoute {
640
+ key: ChartKey;
641
+ points: ReadonlyArray<Point>;
642
+ label?: string;
643
+ color?: string;
644
+ width?: number;
645
+ }
646
+ export interface MapRegion {
647
+ key: ChartKey;
648
+ label?: string;
649
+ x: number;
650
+ y: number;
651
+ width: number;
652
+ height: number;
653
+ points?: ReadonlyArray<Point>;
654
+ }
655
+ export interface MapWalker {
656
+ key: ChartKey;
657
+ routeKey: ChartKey;
658
+ label?: string;
659
+ color?: string;
660
+ size?: number;
661
+ speed?: number;
662
+ startProgress?: number;
663
+ direction?: 'forward' | 'backward';
664
+ }
665
+ export interface RouteMapData {
666
+ routes: ReadonlyArray<MapRoute>;
667
+ regions: ReadonlyArray<MapRegion>;
668
+ walkers: ReadonlyArray<MapWalker>;
669
+ }
670
+ export interface RouteMapOptions extends ChartOptions<RouteMapData, RouteRef | RegionRef | WalkerRef> {
671
+ viewBox: {
672
+ width: number;
673
+ height: number;
674
+ };
675
+ mapBackground?: MapBackground;
676
+ playback?: {
677
+ duration?: number;
678
+ rate?: number;
679
+ loop?: boolean;
680
+ autoplay?: boolean;
681
+ };
682
+ }
683
+ export interface PlaybackApi {
684
+ getPlayback: () => PlaybackState;
685
+ play: (meta?: ChangeMeta) => void;
686
+ pause: (meta?: ChangeMeta) => void;
687
+ seek: (position: number, meta?: ChangeMeta) => void;
688
+ setPlaybackRate: (rate: number, meta?: ChangeMeta) => void;
689
+ setLoop: (loop: boolean, meta?: ChangeMeta) => void;
690
+ }
691
+ export type RouteMapHandle = ChartHandle<RouteMapData, RouteRef | RegionRef | WalkerRef, MapRoute | MapRegion | MapWalker, RouteMapOptions> & CameraApi & PlaybackApi;
692
+ export type SeatShape = {
693
+ type: 'rect';
694
+ x: number;
695
+ y: number;
696
+ width: number;
697
+ height: number;
698
+ } | {
699
+ type: 'polygon';
700
+ points: ReadonlyArray<Point>;
701
+ } | {
702
+ type: 'path';
703
+ d: string;
704
+ };
705
+ export interface Seat {
706
+ key: ChartKey;
707
+ label?: string;
708
+ status: 'available' | 'occupied' | 'premium';
709
+ shape: SeatShape;
710
+ row?: ChartKey;
711
+ column?: ChartKey;
712
+ section?: ChartKey;
713
+ colors?: Partial<SeatColors>;
714
+ }
715
+ export interface SeatColors {
716
+ available: string;
717
+ occupied: string;
718
+ premium: string;
719
+ selected: string;
720
+ hover: string;
721
+ }
722
+ export interface SeatSelectionRules {
723
+ max?: number;
724
+ allowedStatuses?: ReadonlyArray<Seat['status']>;
725
+ sameSection?: boolean;
726
+ validate?: (seats: ReadonlyArray<Seat>) => boolean;
727
+ }
728
+ export interface SeatMapOptions extends ChartOptions<ReadonlyArray<Seat>, SeatRef> {
729
+ viewBox: {
730
+ width: number;
731
+ height: number;
732
+ };
733
+ mapBackground?: MapBackground;
734
+ colors?: Partial<SeatColors>;
735
+ selection?: SeatSelectionRules;
736
+ }
737
+ export interface SeatMapApi {
738
+ getSelectionRules: () => SeatSelectionRules;
739
+ setSelectionRules: (rules: SeatSelectionRules) => void;
740
+ }
741
+ export type SeatMapPreset = Pick<SeatMapOptions, 'data' | 'viewBox' | 'mapBackground' | 'colors'>;
742
+ export type RouteMapPreset = Pick<RouteMapOptions, 'data' | 'viewBox' | 'mapBackground'>;
743
+ export type SeatMapHandle = ChartHandle<ReadonlyArray<Seat>, SeatRef, Seat, SeatMapOptions> & RowsApi<Seat> & CameraApi & SeatMapApi;