semiotic 3.12.0 → 3.12.1

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 (256) hide show
  1. package/README.md +50 -46
  2. package/ai/artifact-surface-inventory.json +1 -1
  3. package/ai/behaviorContracts.cjs +1 -1
  4. package/ai/dist/diagnose-operation.js +3 -3
  5. package/ai/dist/mcp-server.js +1 -1
  6. package/ai/reference.md +15 -3
  7. package/ai/schema.json +908 -96
  8. package/ai/surface-manifest.json +1 -1
  9. package/ai/task-packets/compare-category-totals.json +5 -5
  10. package/ai/task-packets/compare-category-totals.md +2 -2
  11. package/ai/task-packets/correct-published-chart.json +5 -5
  12. package/ai/task-packets/correct-published-chart.md +2 -2
  13. package/ai/task-packets/index.json +6 -6
  14. package/ai/task-packets/update-live-chart.json +5 -5
  15. package/ai/task-packets/update-live-chart.md +2 -2
  16. package/dist/c-27DCB5T6.min.js +7 -7
  17. package/dist/c-2CKIGFD2.min.js +1 -1
  18. package/dist/c-3FATLOH4.min.js +1 -0
  19. package/dist/{c-STVM6CBI.min.js → c-4SCJKAWZ.min.js} +200 -200
  20. package/dist/c-5FUOKMH6.min.js +7 -0
  21. package/dist/c-AAIPWVQ5.min.js +6 -6
  22. package/dist/{c-2RG4WOVX.min.js → c-ALLF3Y77.min.js} +1 -1
  23. package/dist/{c-QMKQVCCZ.min.js → c-C5GXUHUO.min.js} +6 -6
  24. package/dist/c-C67QDKTU.min.js +34 -0
  25. package/dist/c-F76M77YC.min.js +1 -0
  26. package/dist/c-FEVXPKQH.min.js +1 -1
  27. package/dist/c-G42WVQO2.min.js +1 -0
  28. package/dist/c-G5A3YWTN.min.js +66 -0
  29. package/dist/c-H4HVKBU3.min.js +1 -0
  30. package/dist/c-HU3ASFKT.min.js +1 -0
  31. package/dist/c-I4FYCVJB.min.js +391 -0
  32. package/dist/{c-5L7JGWQW.min.js → c-IATPZOL7.min.js} +28 -28
  33. package/dist/c-IE5EBBP6.min.js +110 -0
  34. package/dist/c-IGONIKZL.min.js +1 -0
  35. package/dist/c-IKPM53JH.min.js +1 -0
  36. package/dist/c-IU4QZ7Y5.min.js +1 -1
  37. package/dist/{c-2ACLVPKF.min.js → c-K5VE57OI.min.js} +1 -1
  38. package/dist/c-KWJIBJ4R.min.js +1 -0
  39. package/dist/c-LIMFU6RD.min.js +1 -0
  40. package/dist/c-M4T43G76.min.js +1 -0
  41. package/dist/c-M7QUZZCE.min.js +1 -1
  42. package/dist/c-NVSINXE5.min.js +1 -0
  43. package/dist/{c-FAF6EV4E.min.js → c-NWRYV6ZF.min.js} +1 -1
  44. package/dist/c-O5GU2R5W.min.js +1 -0
  45. package/dist/c-OC7GNXGZ.min.js +1 -0
  46. package/dist/c-OV5F3DQP.min.js +1 -0
  47. package/dist/{c-5TAXHW7I.min.js → c-PJ5CAYAW.min.js} +1 -1
  48. package/dist/c-Q5LZRQGD.min.js +1 -0
  49. package/dist/c-QP3PXK3N.min.js +1 -0
  50. package/dist/c-SGZ7ZD2I.min.js +51 -0
  51. package/dist/c-SSKV5JPW.min.js +1 -1
  52. package/dist/c-THWTHWXU.min.js +37 -0
  53. package/dist/c-TRMNDRC4.min.js +41 -0
  54. package/dist/c-UP656CST.min.js +1 -1
  55. package/dist/c-USYOK5OX.min.js +1 -0
  56. package/dist/c-VI753KBO.min.js +1 -0
  57. package/dist/{c-TT4CTEBR.min.js → c-VLAAAFST.min.js} +1 -1
  58. package/dist/c-VSOQPII4.min.js +5 -5
  59. package/dist/c-WGDM4ZRP.min.js +26 -0
  60. package/dist/c-XCV7VUU3.min.js +87 -0
  61. package/dist/c-XGDZPYBI.min.js +1 -0
  62. package/dist/c-XI6CLZII.min.js +1 -0
  63. package/dist/{c-L4Q2YMXO.min.js → c-XLC7PKM7.min.js} +1 -1
  64. package/dist/{c-3YAGKCPU.min.js → c-YEB6Z35F.min.js} +1 -1
  65. package/dist/c-YWZBFG63.min.js +1 -0
  66. package/dist/c-ZMYO3NZU.min.js +2 -0
  67. package/dist/c-ZO36H5VH.min.js +48 -0
  68. package/dist/components/LinkedCharts.d.ts +6 -1
  69. package/dist/components/Tooltip/Tooltip.d.ts +11 -1
  70. package/dist/components/Tooltip/tooltipChrome.d.ts +8 -2
  71. package/dist/components/bundling/semioticVite.d.ts +24 -0
  72. package/dist/components/charts/physics/cruciblePhysics.d.ts +2 -2
  73. package/dist/components/charts/physics/gauntletPhysics.d.ts +2 -6
  74. package/dist/components/charts/physics/physicsHocUtils.d.ts +8 -1
  75. package/dist/components/charts/realtime/RealtimeHistogram.d.ts +2 -0
  76. package/dist/components/charts/shared/chartSize.d.ts +58 -0
  77. package/dist/components/charts/shared/chartSizeDefaults.d.ts +189 -0
  78. package/dist/components/charts/shared/chartSizeDefaultsAtlas.d.ts +9 -0
  79. package/dist/components/charts/shared/chartSizeDefaultsNetwork.d.ts +29 -0
  80. package/dist/components/charts/shared/chartSizeDefaultsOrdinal.d.ts +13 -0
  81. package/dist/components/charts/shared/chartSizeDefaultsPhysics.d.ts +41 -0
  82. package/dist/components/charts/shared/chartSizeDefaultsValue.d.ts +19 -0
  83. package/dist/components/charts/shared/chartSizeDefaultsXY.d.ts +10 -0
  84. package/dist/components/charts/shared/networkPerspectiveWireSchema.d.ts +3 -0
  85. package/dist/components/charts/shared/useChartSetup.d.ts +3 -0
  86. package/dist/components/charts/shared/useCustomChartSetup.d.ts +4 -0
  87. package/dist/components/charts/shared/useNetworkChartSetup.d.ts +2 -0
  88. package/dist/components/charts/shared/withChartWrapper.d.ts +6 -2
  89. package/dist/components/charts/value/BigNumber.d.ts +0 -8
  90. package/dist/components/charts/xy/minimapLayout.d.ts +10 -0
  91. package/dist/components/realtime/BinAccumulator.d.ts +5 -2
  92. package/dist/components/recipes/atlas/dependencyForestChartProps.d.ts +4 -4
  93. package/dist/components/recipes/atlas/flowCircuitChartProps.d.ts +177 -1
  94. package/dist/components/recipes/atlas/flowCircuitLayout.d.ts +3 -0
  95. package/dist/components/recipes/atlas/motifBraidChartProps.d.ts +2 -0
  96. package/dist/components/recipes/atlas/resolution/BoundaryLoomChart.d.ts +3 -0
  97. package/dist/components/recipes/atlas/resolution/ComponentCutaway.d.ts +16 -0
  98. package/dist/components/recipes/atlas/resolution/ResolutionAtlasChart.d.ts +3 -0
  99. package/dist/components/recipes/atlas/resolution/ResolutionGlyphs.d.ts +15 -0
  100. package/dist/components/recipes/atlas/resolution/ResolutionReader.d.ts +5 -0
  101. package/dist/components/recipes/atlas/resolution/appearance.d.ts +58 -0
  102. package/dist/components/recipes/atlas/resolution/boundaryLoomLayout.d.ts +4 -0
  103. package/dist/components/recipes/atlas/resolution/chartProps.d.ts +75 -0
  104. package/dist/components/recipes/atlas/resolution/componentCutawayLayout.d.ts +12 -0
  105. package/dist/components/recipes/atlas/resolution/cutawayContext.d.ts +23 -0
  106. package/dist/components/recipes/atlas/resolution/cutawayGraph.d.ts +4 -0
  107. package/dist/components/recipes/atlas/resolution/cycles.d.ts +7 -0
  108. package/dist/components/recipes/atlas/resolution/evidence.d.ts +43 -0
  109. package/dist/components/recipes/atlas/resolution/glyphs.d.ts +40 -0
  110. package/dist/components/recipes/atlas/resolution/identity.d.ts +4 -0
  111. package/dist/components/recipes/atlas/resolution/indexGraph.d.ts +32 -0
  112. package/dist/components/recipes/atlas/resolution/ownership.d.ts +25 -0
  113. package/dist/components/recipes/atlas/resolution/plan.d.ts +12 -0
  114. package/dist/components/recipes/atlas/resolution/ports.d.ts +44 -0
  115. package/dist/components/recipes/atlas/resolution/prepare.d.ts +4 -0
  116. package/dist/components/recipes/atlas/resolution/project.d.ts +70 -0
  117. package/dist/components/recipes/atlas/resolution/queries.d.ts +23 -0
  118. package/dist/components/recipes/atlas/resolution/resolutionAtlasLayout.d.ts +9 -0
  119. package/dist/components/recipes/atlas/resolution/rules.d.ts +14 -0
  120. package/dist/components/recipes/atlas/resolution/scene.d.ts +52 -0
  121. package/dist/components/recipes/atlas/resolution/selection.d.ts +3 -0
  122. package/dist/components/recipes/atlas/resolution/sets.d.ts +10 -0
  123. package/dist/components/recipes/atlas/resolution/types.d.ts +401 -0
  124. package/dist/components/recipes/atlas/resolution/validate.d.ts +4 -0
  125. package/dist/components/recipes/atlas/resolution/witnesses.d.ts +18 -0
  126. package/dist/components/recipes/atlas/resolution/worker.d.ts +34 -0
  127. package/dist/components/recipes/lineageDag.d.ts +4 -0
  128. package/dist/components/recipes/recipeUtils.d.ts +2 -0
  129. package/dist/components/recipes/transitDiagram.d.ts +2 -61
  130. package/dist/components/recipes/transitDiagramTypes.d.ts +65 -0
  131. package/dist/components/semiotic-ai.d.ts +2 -0
  132. package/dist/components/semiotic-experimental-network-resolution-react.d.ts +12 -0
  133. package/dist/components/semiotic-experimental-network-resolution.d.ts +13 -0
  134. package/dist/components/semiotic-geo.d.ts +1 -1
  135. package/dist/components/semiotic-network-perspective-core.d.ts +6 -0
  136. package/dist/components/semiotic-network.d.ts +1 -1
  137. package/dist/components/semiotic-ordinal.d.ts +1 -1
  138. package/dist/components/semiotic-physics.d.ts +1 -1
  139. package/dist/components/semiotic-realtime-core.d.ts +1 -1
  140. package/dist/components/semiotic-realtime-react.d.ts +2 -0
  141. package/dist/components/semiotic-utils-core.d.ts +3 -1
  142. package/dist/components/semiotic-vite.d.ts +2 -0
  143. package/dist/components/semiotic-xy.d.ts +3 -1
  144. package/dist/components/semiotic.d.ts +3 -1
  145. package/dist/components/server/renderToStaticSVG.d.ts +2 -1
  146. package/dist/components/server/serverChartConfigShared.d.ts +2 -0
  147. package/dist/components/store/LinkedCrosshairStore.d.ts +43 -11
  148. package/dist/components/store/themeCore.d.ts +2 -0
  149. package/dist/components/stream/frameKeyboardNavigation.d.ts +3 -1
  150. package/dist/components/stream/hoverUtils.d.ts +5 -0
  151. package/dist/components/stream/networkCustomLayout.d.ts +3 -0
  152. package/dist/components/stream/networkPerspective.d.ts +2 -0
  153. package/dist/components/stream/networkPerspectiveFit.d.ts +12 -1
  154. package/dist/components/stream/networkPerspectiveSolid.d.ts +1 -1
  155. package/dist/components/stream/networkSceneTypes.d.ts +4 -0
  156. package/dist/components/stream/networkTypes.d.ts +2 -0
  157. package/dist/components/stream/pipelineConfig.d.ts +2 -0
  158. package/dist/components/stream/pipelineDomainResolution.d.ts +4 -1
  159. package/dist/components/stream/types.d.ts +2 -0
  160. package/dist/components/stream/useFrame.d.ts +2 -0
  161. package/dist/components/stream/xySceneBuilders/types.d.ts +2 -0
  162. package/dist/controls.module.min.js +31 -31
  163. package/dist/geo.min.js +150 -150
  164. package/dist/geo.module.min.js +31 -31
  165. package/dist/network.module.min.js +1 -1
  166. package/dist/ordinal.module.min.js +1 -1
  167. package/dist/physics.module.min.js +1 -1
  168. package/dist/rough.module.min.js +1 -1
  169. package/dist/semiotic-ai-core.min.js +1 -1
  170. package/dist/semiotic-ai-core.module.min.js +1 -1
  171. package/dist/semiotic-ai.d.ts +2 -0
  172. package/dist/semiotic-ai.module.min.js +13 -13
  173. package/dist/semiotic-artifact-react.module.min.js +4 -4
  174. package/dist/semiotic-artifact.min.js +1 -1
  175. package/dist/semiotic-artifact.module.min.js +1 -1
  176. package/dist/semiotic-atlas-selection.module.min.js +1 -1
  177. package/dist/semiotic-atlas.module.min.js +10 -12
  178. package/dist/semiotic-client-cjs-shared.min.js +1078 -925
  179. package/dist/semiotic-client-glyph.module.min.js +2 -2
  180. package/dist/semiotic-client-shared.module.min.js +1 -1
  181. package/dist/semiotic-experimental-auxiliary.module.min.js +8 -9
  182. package/dist/semiotic-experimental-network-resolution-react.d.ts +12 -0
  183. package/dist/semiotic-experimental-network-resolution-react.min.js +2 -0
  184. package/dist/semiotic-experimental-network-resolution-react.module.min.js +89 -0
  185. package/dist/semiotic-experimental-network-resolution.d.ts +13 -0
  186. package/dist/semiotic-experimental-network-resolution.min.js +2 -0
  187. package/dist/semiotic-experimental-network-resolution.module.min.js +2 -0
  188. package/dist/semiotic-experimental-node-auxiliary.module.min.js +9 -10
  189. package/dist/semiotic-geo.d.ts +1 -1
  190. package/dist/semiotic-line.module.min.js +1 -1
  191. package/dist/semiotic-network-perspective-core.d.ts +6 -0
  192. package/dist/semiotic-network-perspective-core.min.js +1 -0
  193. package/dist/semiotic-network-perspective-core.module.min.js +1 -0
  194. package/dist/semiotic-network-perspective.module.min.js +1 -1
  195. package/dist/semiotic-network-placement.min.js +4 -0
  196. package/dist/semiotic-network-placement.module.min.js +4 -0
  197. package/dist/semiotic-network-zoom.module.min.js +1 -1
  198. package/dist/semiotic-network.d.ts +1 -1
  199. package/dist/semiotic-ordinal.d.ts +1 -1
  200. package/dist/semiotic-physics.d.ts +1 -1
  201. package/dist/semiotic-realtime-core.d.ts +1 -1
  202. package/dist/semiotic-realtime-core.module.min.js +1 -1
  203. package/dist/semiotic-realtime-react.d.ts +2 -0
  204. package/dist/semiotic-realtime-react.module.min.js +1 -1
  205. package/dist/semiotic-recipes-core-cjs-base.min.js +101 -106
  206. package/dist/semiotic-recipes-core.module.min.js +75 -76
  207. package/dist/semiotic-server-edge-node.module.min.js +391 -392
  208. package/dist/semiotic-server-edge.min.js +387 -388
  209. package/dist/semiotic-server-edge.module.min.js +371 -371
  210. package/dist/semiotic-server-node.min.js +387 -388
  211. package/dist/semiotic-server-node.module.min.js +1 -1
  212. package/dist/semiotic-utils-core.d.ts +3 -1
  213. package/dist/semiotic-utils-core.min.js +12 -11
  214. package/dist/semiotic-utils-core.module.min.js +12 -11
  215. package/dist/semiotic-value.module.min.js +4 -4
  216. package/dist/semiotic-vite.d.ts +2 -0
  217. package/dist/semiotic-vite.min.js +1 -0
  218. package/dist/semiotic-vite.module.min.js +1 -0
  219. package/dist/semiotic-xy.d.ts +3 -1
  220. package/dist/semiotic.d.ts +3 -1
  221. package/dist/semiotic.module.min.js +12 -12
  222. package/dist/server.min.js +387 -388
  223. package/dist/server.module.min.js +1 -1
  224. package/dist/xy.module.min.js +1 -1
  225. package/package.json +42 -13
  226. package/dist/c-2AB65V3L.min.js +0 -1
  227. package/dist/c-2U5JMOPN.min.js +0 -88
  228. package/dist/c-3DCTIRW4.min.js +0 -1
  229. package/dist/c-3OKFRTYM.min.js +0 -1
  230. package/dist/c-3VZHOPFW.min.js +0 -1
  231. package/dist/c-4ZSQIBC7.min.js +0 -1
  232. package/dist/c-5M4RUS7V.min.js +0 -34
  233. package/dist/c-6O5WWP7F.min.js +0 -1
  234. package/dist/c-73TOIYIW.min.js +0 -48
  235. package/dist/c-AE4M7BWH.min.js +0 -1
  236. package/dist/c-AEIK2NFW.min.js +0 -30
  237. package/dist/c-AFQSEIZ4.min.js +0 -4
  238. package/dist/c-BBX7DVVB.min.js +0 -51
  239. package/dist/c-CNYFCSG4.min.js +0 -5
  240. package/dist/c-E6QH2WYE.min.js +0 -1
  241. package/dist/c-GOMQWQJR.min.js +0 -1
  242. package/dist/c-GTYG4PDT.min.js +0 -1
  243. package/dist/c-H23GIKTK.min.js +0 -1
  244. package/dist/c-HQLUUSRJ.min.js +0 -1
  245. package/dist/c-HXUOFDSD.min.js +0 -64
  246. package/dist/c-L3LKYOLK.min.js +0 -1
  247. package/dist/c-MIKDFGKH.min.js +0 -1
  248. package/dist/c-OYSPTIAG.min.js +0 -1
  249. package/dist/c-PWPJNYQP.min.js +0 -1
  250. package/dist/c-QZ5SWKHC.min.js +0 -392
  251. package/dist/c-RXJH4IRX.min.js +0 -41
  252. package/dist/c-SN2D6QMH.min.js +0 -1
  253. package/dist/c-U5YGK6HL.min.js +0 -1
  254. package/dist/c-VIN5ASK2.min.js +0 -37
  255. package/dist/c-XZ3GASUJ.min.js +0 -1
  256. package/dist/c-ZLZZTH4I.min.js +0 -118
@@ -0,0 +1,34 @@
1
+ import type { PreparedNetworkAtlas } from "../types";
2
+ import type { PrepareResult, PreparedNetworkResolution, ResolutionBindings, ResolutionSpec } from "./types";
3
+ export interface ResolutionRequestIdentity {
4
+ requestId: string;
5
+ generation: number;
6
+ baseRevision: string;
7
+ sourceRevision: string;
8
+ graphRef: string;
9
+ specHash: string;
10
+ inputHash: string;
11
+ evidencePolicyId: string;
12
+ }
13
+ export interface ResolutionWorkerRequest extends ResolutionRequestIdentity {
14
+ kind: "prepare-resolution/v1";
15
+ atlas: PreparedNetworkAtlas;
16
+ spec: ResolutionSpec;
17
+ bindings: ResolutionBindings;
18
+ }
19
+ export interface ResolutionWorkerResponse extends ResolutionRequestIdentity {
20
+ kind: "prepared-resolution/v1";
21
+ result: PrepareResult;
22
+ }
23
+ export interface ResolutionPublication {
24
+ pending?: ResolutionRequestIdentity;
25
+ value?: PreparedNetworkResolution;
26
+ generation: number;
27
+ }
28
+ export declare function createResolutionRequest(atlas: PreparedNetworkAtlas, spec: ResolutionSpec, bindings: ResolutionBindings, requestId: string, generation: number): ResolutionWorkerRequest;
29
+ /** Run in a host worker or upstream process. Synchronous preparation never runs on hover. */
30
+ export declare function handleResolutionRequest(request: ResolutionWorkerRequest): ResolutionWorkerResponse;
31
+ export declare function beginResolutionRequest(store: ResolutionPublication, request: ResolutionWorkerRequest): boolean;
32
+ export declare function cancelResolutionRequest(store: ResolutionPublication, requestId: string): void;
33
+ /** Compare every identity field. Cancellation and supersession retain the last coherent value. */
34
+ export declare function publishResolutionResponse(store: ResolutionPublication, response: ResolutionWorkerResponse): boolean;
@@ -26,6 +26,10 @@ export interface LineageDagConfig {
26
26
  minGapY?: number;
27
27
  /** Force a level of detail; `"auto"` derives it from the fitted glyph size. @default "auto" */
28
28
  lod?: LineageLod | "auto";
29
+ /** Draw direction arrows on edges. @default true */
30
+ showArrowheads?: boolean;
31
+ /** Place card content upright or print it on its projected slab. @default "upright" */
32
+ chromePlacement?: "upright" | "ground";
29
33
  /**
30
34
  * Caller-supplied "reachable" set. When present, nodes/edges **outside**
31
35
  * it dim to `dimOpacity`. This is the controlled-dimming channel: the host
@@ -183,3 +183,5 @@ export declare function mean(values: readonly number[]): number;
183
183
  * is returned unchanged so it composes with CSS-var / `rgb()` colors.
184
184
  */
185
185
  export declare function withAlpha(color: string, alpha: number): string;
186
+ /** Stable UTF-16 ordering, independent of host locale and ICU version. */
187
+ export declare function compareRecipeIds(a: string, b: string): number;
@@ -1,66 +1,7 @@
1
- import { type ReactNode } from "react";
2
- import type { Datum } from "../charts/shared/datumTypes";
3
1
  import type { NetworkCustomLayout } from "../stream/networkCustomLayout";
4
2
  import { computeTransitDiagramPositions, octilinearRoute, offsetTransitPath, roundedTransitPath } from "./transitDiagramGeometry";
5
- export interface TransitDiagramLineDescriptor {
6
- id: string;
7
- color?: string;
8
- label?: string;
9
- }
10
- export type TransitDiagramLineValue = string | number | TransitDiagramLineDescriptor | ReadonlyArray<string | number | TransitDiagramLineDescriptor>;
11
- export type TransitDiagramMode = "primary" | "compact" | "minimap";
12
- export interface TransitDiagramStationRenderInfo {
13
- /** Raw station datum supplied to the chart. */
14
- station: Datum;
15
- /** Fitted center in plot coordinates. */
16
- x: number;
17
- /** Fitted center in plot coordinates. */
18
- y: number;
19
- /** Radius resolved for the active detail mode. */
20
- radius: number;
21
- /** Ordered line ids that pass through this station. */
22
- lineIds: readonly string[];
23
- interchange: boolean;
24
- mode: Exclude<TransitDiagramMode, "minimap">;
25
- }
26
- export interface TransitDiagramConfig {
27
- /** Complete authored x/y positions win by default; otherwise use topology. */
28
- layoutMode?: "auto" | "authored" | "automatic";
29
- /** Station and track level of detail. @default "primary" */
30
- mode?: TransitDiagramMode;
31
- xAccessor?: string | ((d: Datum) => number | undefined);
32
- yAccessor?: string | ((d: Datum) => number | undefined);
33
- labelAccessor?: string | ((d: Datum) => string);
34
- lineAccessor?: string | ((d: Datum) => TransitDiagramLineValue | undefined);
35
- lineColorAccessor?: string | ((d: Datum) => string | undefined);
36
- /** Derive one line per source node and propagate it through a directed DAG. */
37
- lineMode?: "source-rooted";
38
- /** Source-node color used by source-rooted lines. Defaults to `color`. */
39
- sourceColorAccessor?: string | ((d: Datum) => string);
40
- lineColors?: Record<string, string>;
41
- /** Preferred global order for parallel lines. Remaining lines sort by id. */
42
- lineOrder?: string[];
43
- /** Field containing authored intermediate `{x,y}` points. @default "points" */
44
- pointsAccessor?: string;
45
- padding?: number;
46
- componentGap?: number;
47
- /** Preferred endpoint for the automatic topology layout. */
48
- rootId?: string;
49
- direction?: "left-to-right" | "right-to-left";
50
- lineWidth?: number;
51
- lineGap?: number;
52
- cornerRadius?: number;
53
- stationRadius?: number;
54
- interchangeRadius?: number;
55
- stationFill?: string;
56
- stationStroke?: string;
57
- /** Replace primary/compact station circles with SVG rendered above the tracks. */
58
- renderStation?: (info: TransitDiagramStationRenderInfo) => ReactNode;
59
- showLabels?: boolean;
60
- labelFontSize?: number;
61
- labelColor?: string;
62
- dimOpacity?: number;
63
- }
3
+ import type { TransitDiagramConfig } from "./transitDiagramTypes";
4
+ export type { TransitDiagramLineDescriptor, TransitDiagramLineValue, TransitDiagramMode, TransitDiagramStationRenderInfo, TransitDiagramConfig } from "./transitDiagramTypes";
64
5
  /**
65
6
  * Transit-diagram renderer for authored maps and plain directed graphs.
66
7
  *
@@ -0,0 +1,65 @@
1
+ import type { ReactNode } from "react";
2
+ import type { Datum } from "../charts/shared/datumTypes";
3
+ export interface TransitDiagramLineDescriptor {
4
+ id: string;
5
+ color?: string;
6
+ label?: string;
7
+ }
8
+ export type TransitDiagramLineValue = string | number | TransitDiagramLineDescriptor | ReadonlyArray<string | number | TransitDiagramLineDescriptor>;
9
+ export type TransitDiagramMode = "primary" | "compact" | "minimap";
10
+ export interface TransitDiagramStationRenderInfo {
11
+ /** Raw station datum supplied to the chart. */
12
+ station: Datum;
13
+ /** Fitted center in plot coordinates. */
14
+ x: number;
15
+ /** Fitted center in plot coordinates. */
16
+ y: number;
17
+ /** Radius resolved for the active detail mode. */
18
+ radius: number;
19
+ /** Ordered line ids that pass through this station. */
20
+ lineIds: readonly string[];
21
+ interchange: boolean;
22
+ mode: Exclude<TransitDiagramMode, "minimap">;
23
+ }
24
+ export interface TransitDiagramConfig {
25
+ /** Complete authored x/y positions win by default; otherwise use topology. */
26
+ layoutMode?: "auto" | "authored" | "automatic";
27
+ /** Station and track level of detail. @default "primary" */
28
+ mode?: TransitDiagramMode;
29
+ xAccessor?: string | ((d: Datum) => number | undefined);
30
+ yAccessor?: string | ((d: Datum) => number | undefined);
31
+ labelAccessor?: string | ((d: Datum) => string);
32
+ lineAccessor?: string | ((d: Datum) => TransitDiagramLineValue | undefined);
33
+ lineColorAccessor?: string | ((d: Datum) => string | undefined);
34
+ /** Derive one line per source node and propagate it through a directed DAG. */
35
+ lineMode?: "source-rooted";
36
+ /** Source-node color used by source-rooted lines. Defaults to `color`. */
37
+ sourceColorAccessor?: string | ((d: Datum) => string);
38
+ lineColors?: Record<string, string>;
39
+ /** Preferred global order for parallel lines. Remaining lines sort by id. */
40
+ lineOrder?: string[];
41
+ /** Field containing authored intermediate `{x,y}` points. @default "points" */
42
+ pointsAccessor?: string;
43
+ padding?: number;
44
+ componentGap?: number;
45
+ /** Preferred endpoint for the automatic topology layout. */
46
+ rootId?: string;
47
+ direction?: "left-to-right" | "right-to-left";
48
+ lineWidth?: number;
49
+ lineGap?: number;
50
+ cornerRadius?: number;
51
+ stationRadius?: number;
52
+ interchangeRadius?: number;
53
+ stationFill?: string;
54
+ stationStroke?: string;
55
+ /** Replace primary/compact station circles with SVG rendered above the tracks. */
56
+ renderStation?: (info: TransitDiagramStationRenderInfo) => ReactNode;
57
+ /** Place custom station content upright or on the projected ground. @default "upright" */
58
+ chromePlacement?: "upright" | "ground";
59
+ /** Screen extents [left, right, top, bottom] around custom station content; defaults to radius on each side. */
60
+ stationBounds?: (info: TransitDiagramStationRenderInfo) => readonly [number, number, number, number];
61
+ showLabels?: boolean;
62
+ labelFontSize?: number;
63
+ labelColor?: string;
64
+ dimOpacity?: number;
65
+ }
@@ -186,3 +186,5 @@ export { annotationStableId } from "./charts/shared/annotationActivation";
186
186
  export type { ChartAnnotation, AnnotationActivationEvent, OnAnnotationActivateCallback } from "./charts/shared/annotationActivation";
187
187
  export { MobileAnnotationCalloutList } from "./MobileAnnotationCalloutList";
188
188
  export type { MobileAnnotationCalloutListProps } from "./MobileAnnotationCalloutList";
189
+ export { useLinkedCrosshair, useCrosshairPosition } from "./store/LinkedCrosshairStore";
190
+ export type { CrosshairPosition, CrosshairPositionInput, LinkedCrosshairConfig, UseLinkedCrosshairResult } from "./store/LinkedCrosshairStore";
@@ -0,0 +1,12 @@
1
+ export { NodeResolutionStrip, EdgeWitnessGlyph } from "./recipes/atlas/resolution/ResolutionGlyphs";
2
+ /** Experimental Network Resolution readers; import explicitly to opt into their runtime. */
3
+ export { ResolutionAtlasChart } from "./recipes/atlas/resolution/ResolutionAtlasChart";
4
+ export { BoundaryLoomChart } from "./recipes/atlas/resolution/BoundaryLoomChart";
5
+ export { ComponentCutaway } from "./recipes/atlas/resolution/ComponentCutaway";
6
+ export type { ComponentCutawayProps } from "./recipes/atlas/resolution/ComponentCutaway";
7
+ export { resolutionChartProps } from "./recipes/atlas/resolution/chartProps";
8
+ export type { ResolutionChartProps } from "./recipes/atlas/resolution/chartProps";
9
+ export { resolutionAtlasLayout } from "./recipes/atlas/resolution/resolutionAtlasLayout";
10
+ export { boundaryLoomLayout } from "./recipes/atlas/resolution/boundaryLoomLayout";
11
+ export { componentCutawayLayout } from "./recipes/atlas/resolution/componentCutawayLayout";
12
+ export type { ResolutionAppearance, ResolutionMarkRole, ResolutionStyleContext } from "./recipes/atlas/resolution/appearance";
@@ -0,0 +1,13 @@
1
+ /** Experimental, browser-independent Network Resolution analysis and evidence. */
2
+ export { projectNodeResolutionStrip, projectEdgeWitnessGlyph, compareResolutionPolicies } from "./recipes/atlas/resolution/glyphs";
3
+ export { prepareNetworkResolution } from "./recipes/atlas/resolution/prepare";
4
+ export { projectResolutionView, defaultResolutionView, resolutionRowOrder } from "./recipes/atlas/resolution/project";
5
+ export type { ResolutionProjection, ResolutionMark } from "./recipes/atlas/resolution/project";
6
+ export { getEdgeHistory, getCycleLedger, explainGroup, listBoundaryEdges, expandSourceSet } from "./recipes/atlas/resolution/queries";
7
+ export { traceComponentPort, projectComponentCutaway } from "./recipes/atlas/resolution/ports";
8
+ export { getEdgeAlternative } from "./recipes/atlas/resolution/witnesses";
9
+ export { exportResolutionEvidence } from "./recipes/atlas/resolution/evidence";
10
+ export { resolutionSelectionFields } from "./recipes/atlas/resolution/selection";
11
+ export { createResolutionRequest, handleResolutionRequest, beginResolutionRequest, cancelResolutionRequest, publishResolutionResponse } from "./recipes/atlas/resolution/worker";
12
+ export type { ResolutionWorkerRequest, ResolutionWorkerResponse, ResolutionPublication } from "./recipes/atlas/resolution/worker";
13
+ export type { PreparedNetworkResolution, ResolutionSpec, ResolutionBindings, ResolutionPage, ResolutionGroup, ResolutionViewSpec, EdgeHistory, PortPathQuery, PortPathResult, EdgeSemantics, PrepareResult as PrepareResolutionResult, CanonicalSelection as CanonicalResolutionSelection, SemanticTarget as ResolutionSemanticTarget } from "./recipes/atlas/resolution/types";
@@ -5,7 +5,7 @@
5
5
  import StreamGeoFrame from "./stream/StreamGeoFrame";
6
6
  export { StreamGeoFrame };
7
7
  export { Tooltip, TooltipRoot, MultiLineTooltip, hasOwnTooltipChrome, hasTooltipContent, markTooltipChrome } from "./Tooltip/Tooltip";
8
- export type { TooltipProp, TooltipConfig, TooltipField, MultiLineTooltipConfig, MultiTooltipConfig, TooltipRootProps, TooltipChromeMode, } from "./Tooltip/Tooltip";
8
+ export type { TooltipProp, TooltipConfig, TooltipField, MultiLineTooltipConfig, MultiTooltipConfig, CustomTooltipConfig, TooltipRootProps, TooltipChromeMode, } from "./Tooltip/Tooltip";
9
9
  export { ChoroplethMap } from "./charts/geo/ChoroplethMap";
10
10
  export { ProportionalSymbolMap } from "./charts/geo/ProportionalSymbolMap";
11
11
  export { FlowMap } from "./charts/geo/FlowMap";
@@ -0,0 +1,6 @@
1
+ export { NetworkPerspectiveGround, NetworkPerspectiveBillboard } from "./stream/networkPerspectivePlacement";
2
+ export type { NetworkPerspectiveHeight } from "./stream/networkPerspectivePlacement";
3
+ export { resolveNetworkPerspective } from "./stream/networkPerspective";
4
+ export { createNetworkPerspectiveFrame, getNetworkPerspectiveSize } from "./stream/networkPerspectiveFit";
5
+ export { useNetworkPerspective } from "./stream/networkPerspectiveContext";
6
+ export type { NetworkPerspective, NetworkPerspectiveBound, NetworkPerspectiveConfig, NetworkPerspectiveFrame, NetworkPerspectiveName } from "./stream/networkPerspective";
@@ -6,7 +6,7 @@ import StreamNetworkFrame from "./stream/StreamNetworkFrame";
6
6
  export { StreamNetworkFrame };
7
7
  export { registerBuiltInNetworkLayouts } from "./stream/layouts/registerBuiltIn";
8
8
  export { Tooltip, TooltipRoot, MultiLineTooltip, hasOwnTooltipChrome, hasTooltipContent, markTooltipChrome } from "./Tooltip/Tooltip";
9
- export type { TooltipProp, TooltipConfig, TooltipField, MultiLineTooltipConfig, MultiTooltipConfig, TooltipRootProps, TooltipChromeMode, } from "./Tooltip/Tooltip";
9
+ export type { TooltipProp, TooltipConfig, TooltipField, MultiLineTooltipConfig, MultiTooltipConfig, CustomTooltipConfig, TooltipRootProps, TooltipChromeMode, } from "./Tooltip/Tooltip";
10
10
  export { ForceDirectedGraph } from "./charts/network/ForceDirectedGraph";
11
11
  export { useForceLayout } from "./charts/network/useForceLayout";
12
12
  export type { ForceLayoutStatus, UseForceLayoutResult } from "./charts/network/useForceLayout";
@@ -5,7 +5,7 @@
5
5
  import StreamOrdinalFrame from "./stream/StreamOrdinalFrame";
6
6
  export { StreamOrdinalFrame };
7
7
  export { Tooltip, TooltipRoot, MultiLineTooltip, hasOwnTooltipChrome, hasTooltipContent, markTooltipChrome } from "./Tooltip/Tooltip";
8
- export type { TooltipProp, TooltipConfig, TooltipField, MultiLineTooltipConfig, MultiTooltipConfig, TooltipRootProps, TooltipChromeMode, } from "./Tooltip/Tooltip";
8
+ export type { TooltipProp, TooltipConfig, TooltipField, MultiLineTooltipConfig, MultiTooltipConfig, CustomTooltipConfig, TooltipRootProps, TooltipChromeMode, } from "./Tooltip/Tooltip";
9
9
  export { BarChart } from "./charts/ordinal/BarChart";
10
10
  export { StackedBarChart } from "./charts/ordinal/StackedBarChart";
11
11
  export { GroupedBarChart } from "./charts/ordinal/GroupedBarChart";
@@ -29,7 +29,7 @@ import { processChrome } from "./recipes/processChrome";
29
29
  import { absorbRegion, aggregateRegionCounts, arrivalReplay, bodyGroupSpec, capacitatedRegion, chargeGateRegion, collidersFromScales, createProcessJourneyLedger, forceFieldRegion, galtonPegs, groupCompletionRows, comparePhysicsTrace, membraneRegion, portalRegion, pressureFieldRegion, processLaneWalls, processJourneyRows, processStageLayout, describePhysicsStageGeography, physicsChargePoint, physicsDestination, physicsStageColliders, physicsStageGeography, processStageRegions, processVolumePolygons, physicsReferenceEnvelope, regionCountsToProjectionRows, routeSurfaceRegion, sedimentBake, spawnFromTokens, stageTargetInVolume, updateProcessJourney } from "./recipes/physics";
30
30
  export { BuiltInPhysicsEngineAdapter, CollisionSwarmChart, EventDropChart, GauntletChart, GaltonBoardChart, GuantletChart, PacketFlowChart, PhysicalFlowChart, PhysicsCustomChart, PhysicsPileChart, UnitPileChart, Tooltip, TooltipRoot, MultiLineTooltip, hasOwnTooltipChrome, hasTooltipContent, markTooltipChrome, PhysicsPipelineStore, PhysicsSedimentAccumulator, ProcessFlowChart, absorbRegion, aggregateRegionCounts, arrivalReplay, bodyGroupSpec, buildCollisionSwarmPhysics, buildEventDropPhysics, readEventDropOccupancy, buildGaltonBoardPhysics, buildPhysicalFlowPhysics, buildPhysicsPile, buildProcessFlowPhysics, capacitatedRegion, chargeGateRegion, collidersFromScales, compilePhysicsEncoding, composePhysicsControllers, createCapacityQueueController, createDependencyGateController, createDefaultPhysicsEngineAdapter, createPortalController, createPhysicsEncodingLayout, createServiceLevelController, createServiceResourcePoolController, createProcessJourneyLedger, evaluatePhysicsBodyBudget, processChrome, forceFieldRegion, galtonPegs, groupCompletionRows, comparePhysicsTrace, planGauntletPropertyWork, membraneRegion, physicsProcessBoundaryColliders, physicsProcessGroupSemanticItems, physicsProcessRegionSemanticItem, physicsProcessStageSemanticItems, portalRegion, pressureFieldRegion, processLaneWalls, processJourneyRows, processStageLayout, describePhysicsStageGeography, physicsChargePoint, physicsDestination, physicsStageColliders, physicsStageGeography, processStageRegions, processVolumePolygons, physicsReferenceEnvelope, regionCountsToProjectionRows, replaceGauntletNegative, resolveGauntletTerminalState, resolveGauntletTerminalStates, routeSurfaceRegion, sedimentBake, sedimentHeightfield, spawnFromTokens, stageTargetInVolume, updateProcessJourney, NamedStreamPhysicsFrame as StreamPhysicsFrame };
31
31
  export default StreamPhysicsFrame;
32
- export type { TooltipProp, TooltipConfig, TooltipField, MultiLineTooltipConfig, MultiTooltipConfig, TooltipRootProps, TooltipChromeMode } from "./Tooltip/Tooltip";
32
+ export type { TooltipProp, TooltipConfig, TooltipField, MultiLineTooltipConfig, MultiTooltipConfig, CustomTooltipConfig, TooltipRootProps, TooltipChromeMode } from "./Tooltip/Tooltip";
33
33
  export type { CollisionSwarmChartProps } from "./charts/physics/CollisionSwarmChart";
34
34
  export type { EventDropChartProps } from "./charts/physics/EventDropChart";
35
35
  export * from "./charts/physics/CrucibleChart";
@@ -25,7 +25,7 @@ import { RealtimeHeatmap } from "./charts/realtime/RealtimeHeatmap";
25
25
  export { registerBuiltInXYPlugins } from "./stream/xyPlugins/registerBuiltIn";
26
26
  export { StreamXYFrame, StreamNetworkFrame, RingBuffer, IncrementalExtent, RunningStats, WindowAccumulator, statValue, bandBounds, TDigest, HyperLogLog, applyChangelog, parseWindowDuration, ReorderBuffer, RealtimeLineChart, RealtimeHistogram, TemporalHistogram, RealtimeSwarmChart, RealtimeWaterfallChart, RealtimeHeatmap };
27
27
  export { Tooltip, TooltipRoot, MultiLineTooltip, MultiPointTooltip, hasOwnTooltipChrome, hasTooltipContent, markTooltipChrome, } from "./Tooltip/Tooltip";
28
- export type { TooltipProp, TooltipConfig, TooltipField, MultiLineTooltipConfig, MultiTooltipConfig, TooltipRootProps, TooltipChromeMode, } from "./Tooltip/Tooltip";
28
+ export type { TooltipProp, TooltipConfig, TooltipField, MultiLineTooltipConfig, MultiTooltipConfig, CustomTooltipConfig, TooltipRootProps, TooltipChromeMode, } from "./Tooltip/Tooltip";
29
29
  export type { WindowType, AggregateStat, AggregateBand, WindowAccumulatorConfig, AggregatedWindow, } from "./realtime/WindowAccumulator";
30
30
  export type { ChangelogOp, ApplyChangelogOptions, ApplyChangelogResult, } from "./realtime/applyChangelog";
31
31
  export type { AggregateConfig, AggregatedRealtimeDatum } from "./charts/realtime/aggregate";
@@ -9,3 +9,5 @@ export { useStreamStatus } from "./charts/shared/useStreamStatus";
9
9
  export type { StreamStatus, StreamStatusOptions, StreamStatusResult, } from "./charts/shared/useStreamStatus";
10
10
  export { useSyncedPushData, syncPushBuffer } from "./charts/shared/useSyncedPushData";
11
11
  export type { SyncedPushHandle, SyncedPushDataOptions, PushIdAccessor, } from "./charts/shared/useSyncedPushData";
12
+ export { useLinkedCrosshair, useCrosshairPosition } from "./store/LinkedCrosshairStore";
13
+ export type { CrosshairPosition, CrosshairPositionInput, LinkedCrosshairConfig, UseLinkedCrosshairResult } from "./store/LinkedCrosshairStore";
@@ -14,6 +14,8 @@ export { adaptiveTimeTicks, smartTickFormat } from "./charts/shared/formatUtils"
14
14
  export type { AdaptiveTimeTickOptions, TimeGranularity } from "./charts/shared/formatUtils";
15
15
  export { resolveResponsiveDimension } from "./stream/responsiveSize";
16
16
  export type { ResponsiveSizeOptions } from "./stream/responsiveSize";
17
+ export { resolveChartSize } from "./charts/shared/chartSize";
18
+ export type { ChartSize, ChartSizeOptions, SizedChartName, BigNumberSize, BigNumberSizeOptions } from "./charts/shared/chartSize";
17
19
  export { darkenColor, lightenColor } from "./charts/shared/colorManipulation";
18
20
  export { createHatchPattern } from "./charts/shared/hatchPattern";
19
21
  export type { HatchPatternOptions } from "./charts/shared/hatchPattern";
@@ -61,6 +63,6 @@ export type { VegaLiteSpec, VegaLiteEncoding } from "./data/fromVegaLite";
61
63
  export { RingBuffer } from "./realtime/RingBuffer";
62
64
  export { IncrementalExtent } from "./realtime/IncrementalExtent";
63
65
  export { Tooltip, TooltipRoot, MultiLineTooltip, MultiPointTooltip, normalizeTooltip, resolveTooltipContent, resolveMultiCapableTooltip, isMultiTooltip, hasOwnTooltipChrome, hasTooltipContent, markTooltipChrome } from "./Tooltip/Tooltip";
64
- export type { TooltipProp, TooltipConfig, TooltipField, MultiLineTooltipConfig, MultiTooltipConfig, TooltipRootProps, TooltipChromeMode } from "./Tooltip/Tooltip";
66
+ export type { TooltipProp, TooltipConfig, TooltipField, MultiLineTooltipConfig, MultiTooltipConfig, CustomTooltipConfig, TooltipRootProps, TooltipChromeMode } from "./Tooltip/Tooltip";
65
67
  export { sweepToAngles, valueToAngle, computeArcBoundingBox } from "./charts/shared/radialGeometry";
66
68
  export type { SweepAngles, ArcBoundingBox } from "./charts/shared/radialGeometry";
@@ -0,0 +1,2 @@
1
+ /** Build-time integration; safe to import from vite.config.ts. */
2
+ export { semioticVite } from "./bundling/semioticVite";
@@ -6,7 +6,7 @@ import StreamXYFrame from "./stream/StreamXYFrame";
6
6
  export { StreamXYFrame };
7
7
  export { registerBuiltInXYPlugins } from "./stream/xyPlugins/registerBuiltIn";
8
8
  export { Tooltip, TooltipRoot, MultiLineTooltip, MultiPointTooltip, hasOwnTooltipChrome, hasTooltipContent, markTooltipChrome, } from "./Tooltip/Tooltip";
9
- export type { TooltipProp, TooltipConfig, TooltipField, MultiLineTooltipConfig, MultiTooltipConfig, TooltipRootProps, TooltipChromeMode, } from "./Tooltip/Tooltip";
9
+ export type { TooltipProp, TooltipConfig, TooltipField, MultiLineTooltipConfig, MultiTooltipConfig, CustomTooltipConfig, TooltipRootProps, TooltipChromeMode, } from "./Tooltip/Tooltip";
10
10
  export { LineChart } from "./charts/xy/LineChart";
11
11
  export { BumpChart, rankBumpData } from "./charts/xy/BumpChart";
12
12
  export { AreaChart } from "./charts/xy/AreaChart";
@@ -57,3 +57,5 @@ export { resolveStyleRules, matchesThreshold, ruleMatches, makeRuleValueResolver
57
57
  export type { StyleRule, StyleRuleStyle, StyleRuleThreshold, StyleRuleContext, StyleRulePredicate } from "./charts/shared/styleRules";
58
58
  export { isHatchFill, hatchPatternDef, resolveSvgFill, hatchFillId } from "./charts/shared/hatchFill";
59
59
  export type { HatchFill } from "./charts/shared/hatchFill";
60
+ export { useLinkedCrosshair, useCrosshairPosition } from "./store/LinkedCrosshairStore";
61
+ export type { CrosshairPosition, CrosshairPositionInput, LinkedCrosshairConfig, UseLinkedCrosshairResult } from "./store/LinkedCrosshairStore";
@@ -152,7 +152,7 @@ export type { AnnotationLabelBackground, AnnotationLabelBackgroundConfig, Annota
152
152
  export { smartTickFormat, adaptiveTimeTicks } from "./charts/shared/formatUtils";
153
153
  export type { AdaptiveTimeTickOptions, TimeGranularity } from "./charts/shared/formatUtils";
154
154
  export { darkenColor, lightenColor } from "./charts/shared/colorManipulation";
155
- export type { TooltipProp, TooltipConfig, TooltipField, MultiLineTooltipConfig, MultiTooltipConfig, TooltipRootProps, TooltipChromeMode } from "./Tooltip/Tooltip";
155
+ export type { TooltipProp, TooltipConfig, TooltipField, MultiLineTooltipConfig, MultiTooltipConfig, CustomTooltipConfig, TooltipRootProps, TooltipChromeMode } from "./Tooltip/Tooltip";
156
156
  export { smartTooltipEntries } from "./charts/shared/tooltipUtils";
157
157
  export type { SmartTooltipEntry, SmartTooltipResult } from "./charts/shared/tooltipUtils";
158
158
  export * from "./semiotic-stream-types";
@@ -161,3 +161,5 @@ export { MobileAnnotationCalloutList } from "./MobileAnnotationCalloutList";
161
161
  export type { MobileAnnotationCalloutListProps } from "./MobileAnnotationCalloutList";
162
162
  export { compileMotionEncoding, resolveMotionAccessor, resolveMotionAge, opacityFromAge, resolveMotionVector, deriveMotionVector } from "./charts/shared/motionEncoding";
163
163
  export type { MotionEncodingConstant, MotionEncodingAccessor, MotionTimeBasis, MotionTimeUnit, MotionCoordinateSpace, MotionTimeEncoding, MotionPlacementEncoding, MotionKinematicsEncoding, MotionProcessEncoding, MotionAccessibleEncoding, MotionEncoding, ResolvedMotionEncodingRow, MotionEncodingCompilation, CompileMotionEncodingOptions, ResolveMotionAgeOptions, ResolvedMotionAge, MotionAgeOpacityType, MotionAgeOpacityOptions, MotionPoint, ResolvedMotionVector } from "./charts/shared/motionEncoding";
164
+ export { useLinkedCrosshair, useCrosshairPosition } from "./store/LinkedCrosshairStore";
165
+ export type { CrosshairPosition, CrosshairPositionInput, LinkedCrosshairConfig, UseLinkedCrosshairResult } from "./store/LinkedCrosshairStore";
@@ -27,7 +27,8 @@ export interface RenderChartOptions {
27
27
  * Decimal places for SVG geometry serialization. This opt-in postprocess
28
28
  * rounds numeric SVG attributes, path data, transforms, and point lists;
29
29
  * text nodes, IDs, and arbitrary CSS/style strings are left untouched.
30
- * Values are clamped to the practical 0–8 range.
30
+ * Values are clamped to the practical 0–8 range. Transform coefficients
31
+ * and angles retain at least 8 decimals to prevent distance-dependent drift.
31
32
  */
32
33
  precision?: number;
33
34
  /** Preserve an interpretation contract in machine-readable render evidence. */
@@ -34,6 +34,8 @@ export interface ServerChartOverlayContext {
34
34
  }
35
35
  export interface ChartConfig {
36
36
  frameType: FrameType;
37
+ /** Effective renderer for compositions that choose a frame from their props. */
38
+ resolveFrameType?: (frameProps: Datum) => FrameType;
37
39
  layout?: ServerChartLayoutDefaults;
38
40
  /** Build frame props from HOC-level props */
39
41
  buildProps: (data: ServerChartData, colorBy: ServerAccessor | undefined, colorScheme: ServerColorScheme, common: Datum, rest: Datum) => Datum;
@@ -1,15 +1,47 @@
1
+ import * as React from "react";
2
+ /** A linked crosshair in data-space x coordinates (epoch milliseconds for time). */
3
+ export interface CrosshairPosition {
4
+ xValue: number;
5
+ sourceId: string;
6
+ locked?: boolean;
7
+ }
8
+ /** External positions may omit sourceId so the crosshair appears on every chart. */
9
+ export type CrosshairPositionInput = Omit<CrosshairPosition, "sourceId"> & {
10
+ sourceId?: string;
11
+ };
12
+ /** Control or observe one named x-position group inside LinkedCharts. */
13
+ export interface LinkedCrosshairConfig {
14
+ name: string;
15
+ /** undefined selects internal state; null controls an inactive crosshair. */
16
+ position?: CrosshairPositionInput | null;
17
+ /** Hover, leave, click, Escape, and hook actions request a new position here. */
18
+ onPositionChange?: (position: CrosshairPosition | null) => void;
19
+ }
20
+ /** Provider owned by LinkedCharts; isolates names between dashboards. */
21
+ export declare function LinkedCrosshairProvider({ children, control }: {
22
+ children: React.ReactNode;
23
+ control?: LinkedCrosshairConfig;
24
+ }): React.JSX.Element;
25
+ /** Internal scoped actions shared by chart event handlers and overlays. */
26
+ export declare function useCrosshairActions(): {
27
+ handlesEscape: boolean;
28
+ setPosition: (name: string, input: CrosshairPositionInput | null) => void;
29
+ setCrosshairPosition(name: string, xValue: number, sourceId: string): void;
30
+ clearCrosshairPosition(name: string, sourceId: string): void;
31
+ toggleCrosshairLock(name: string, xValue: number, sourceId: string): boolean;
32
+ unlockCrosshair(name: string, sourceId?: string): void;
33
+ releaseCrosshair(name: string, sourceId: string): void;
34
+ };
35
+ /** Read a named crosshair; inactive names return null. */
36
+ export declare function useCrosshairPosition(name: string | undefined): CrosshairPosition | null;
37
+ export interface UseLinkedCrosshairResult {
38
+ position: CrosshairPosition | null;
39
+ /** Replace the position, including lock state; null clears even a locked crosshair. */
40
+ setPosition: (position: CrosshairPositionInput | null) => void;
41
+ }
42
+ /** Read and update the same crosshair as charts, from a table or other React UI. */
43
+ export declare function useLinkedCrosshair(name: string): UseLinkedCrosshairResult;
1
44
  export declare function setCrosshairPosition(name: string, xValue: number, sourceId: string): void;
2
45
  export declare function clearCrosshairPosition(name: string, sourceId: string): void;
3
- /** Toggle lock: if unlocked, lock at xValue; if locked, unlock and clear. Returns new locked state. */
4
46
  export declare function toggleCrosshairLock(name: string, xValue: number, sourceId: string): boolean;
5
- /** Force-unlock a crosshair by name. When sourceId is provided, only unlocks if it matches (safe for multi-chart unmount). */
6
47
  export declare function unlockCrosshair(name: string, sourceId?: string): void;
7
- /**
8
- * Hook to read a specific crosshair position by name.
9
- * Returns the X value, sourceId, and locked state, or null if no crosshair is active.
10
- */
11
- export declare function useCrosshairPosition(name: string | undefined): {
12
- xValue: number;
13
- sourceId: string;
14
- locked?: boolean;
15
- } | null;
@@ -58,6 +58,8 @@ export interface SemioticTheme {
58
58
  titleFontWeight?: string | number;
59
59
  };
60
60
  tooltip?: {
61
+ /** Default chrome for custom tooltip renderers; chart configs can override it. */
62
+ chrome?: "default" | "none";
61
63
  background?: string;
62
64
  text?: string;
63
65
  borderRadius?: string;
@@ -21,6 +21,8 @@ interface KeyboardInteractionParams<Store, Node = unknown> {
21
21
  customHoverBehavior?: SemanticHoverBehavior<HoverData>;
22
22
  customClickBehavior?: SemanticClickBehavior<HoverData>;
23
23
  scheduleRender: () => void;
24
+ /** Cancel queued pointer hit testing when keyboard interaction dismisses hover. */
25
+ clearPointerHover?: () => void;
24
26
  }
25
27
  interface XYKeyboardParams extends KeyboardInteractionParams<PipelineStore, SceneNode> {
26
28
  /** Adds frame-owned context, such as multi-series rows, to a focused point's hover. */
@@ -43,7 +45,7 @@ export declare function useOrdinalKeyboardNavigation({ chartType, oAccessor, rAc
43
45
  onKeyDown: (event: KeyboardEvent) => void;
44
46
  refreshKeyboardFocus: () => void;
45
47
  };
46
- export declare function useGeoKeyboardNavigation({ storeRef, hoverRef, hoveredNodeRef, setHoverPoint, customHoverBehavior, customClickBehavior, scheduleRender }: KeyboardInteractionParams<GeoPipelineStore, GeoSceneNode>): {
48
+ export declare function useGeoKeyboardNavigation({ clearPointerHover, storeRef, hoverRef, hoveredNodeRef, setHoverPoint, customHoverBehavior, customClickBehavior, scheduleRender }: KeyboardInteractionParams<GeoPipelineStore, GeoSceneNode>): {
47
49
  kbFocusIndexRef: import("react").RefObject<number>;
48
50
  focusedNavPointRef: import("react").RefObject<NavPoint | null>;
49
51
  onKeyDown: (event: KeyboardEvent) => void;
@@ -33,3 +33,8 @@ export declare function normalizeHoverDatum(rawDatum: RawHoverDatum): Datum | nu
33
33
  * `nodeOrEdge`, `xValue`, etc. — is layered in via `extra`.
34
34
  */
35
35
  export declare function buildHoverData(rawDatum: RawHoverDatum, x: number, y: number, extra?: Partial<HoverData>): HoverData;
36
+ /**
37
+ * Temporal histogram producers use bin boundaries, independent of clipping or
38
+ * pixel-rounding. Other charts may author these fields and must keep their x.
39
+ */
40
+ export declare function resolveHistogramHoverXValue(datum: Datum | null | undefined, fallback: HoverData["xValue"]): HoverData["xValue"];
@@ -73,6 +73,9 @@ export interface NetworkLayoutContext<C extends object = Record<string, unknown>
73
73
  theme: {
74
74
  semantic: ThemeSemanticColors;
75
75
  categorical: string[];
76
+ /** Active ThemeProvider's sequential scheme and selection dimming. */
77
+ sequential?: string;
78
+ selectionOpacity?: number;
76
79
  };
77
80
  /**
78
81
  * Resolves a stable color for a given key (typically a node id or
@@ -138,6 +138,8 @@ export interface NetworkPerspectiveConfig {
138
138
  * cast a shadow. `0` draws flat pieces. @default 6
139
139
  */
140
140
  thickness?: number;
141
+ /** Token side walls: shaded facets or a single flat rim for compact SVG exports. @default "faceted" */
142
+ tokenRim?: "faceted" | "flat";
141
143
  /** Shadow under every edge, `thickness` below it. @default true when `thickness` > 0 */
142
144
  edgeShadow?: boolean | {
143
145
  color?: string;
@@ -1,4 +1,4 @@
1
- import { type NetworkPerspective, type NetworkPerspectiveAccessor, type NetworkPerspectiveFrame, type ResolvedNetworkPerspective } from "./networkPerspective";
1
+ import { type NetworkPerspective, type NetworkPerspectiveBound, type NetworkPerspectiveAccessor, type NetworkPerspectiveFrame, type ResolvedNetworkPerspective } from "./networkPerspective";
2
2
  /**
3
3
  * Collects projected sample points plus fixed (unscaled) screen extents so a
4
4
  * `contain` fit can solve for the largest scale that keeps every mark inside
@@ -24,6 +24,17 @@ export declare function fitNetworkPerspectiveFrame(resolved: ResolvedNetworkPers
24
24
  * points into `size` the same way the frame does.
25
25
  */
26
26
  export declare function createNetworkPerspectiveFrame(perspective: NetworkPerspective | null | undefined, size: readonly [number, number], points?: ReadonlyArray<readonly [number, number] | readonly [number, number, number]>): NetworkPerspectiveFrame;
27
+ /**
28
+ * Screen size needed to project a ground rectangle at scale 1, including piece
29
+ * thickness, fitPadding and optional decoration bounds. Use the returned size
30
+ * for the canvas while keeping the layout's ground dimensions unchanged.
31
+ * Requires `fit: "contain"` (the default) for projected views; `fit: "none"`
32
+ * positions around the canvas origin and cannot guarantee contained bounds.
33
+ * Declare token radii/custom chrome as fixed `extent` bounds; this helper does
34
+ * not infer mark geometry, elevation accessors, labels, or regions from data.
35
+ * @throws {RangeError} For invalid ground dimensions or a projected `fit: "none"`.
36
+ */
37
+ export declare function getNetworkPerspectiveSize(perspective: NetworkPerspective | null | undefined, groundSize: readonly [number, number], bounds?: readonly NetworkPerspectiveBound[]): [number, number];
27
38
  /** The raw user datum behind a scene datum (`node.data ?? node`). */
28
39
  export declare function rawPerspectiveDatum(datum: unknown): Record<string, unknown> | null;
29
40
  /** Read an accessor as a number (NaN when missing). Constants return themselves. */
@@ -16,5 +16,5 @@ export declare function samplePolygon(segs: readonly NormalizedPathSegment[], st
16
16
  * lighter than right-facing ones. Neighboring walls with the same shade merge
17
17
  * into one strip, painted far to near.
18
18
  */
19
- export declare function extrudeOutline(top: readonly Pt[], drop: number): NetworkPerspectiveFace[];
19
+ export declare function extrudeOutline(top: readonly Pt[], drop: number, rim?: "faceted" | "flat"): NetworkPerspectiveFace[];
20
20
  export {};
@@ -126,6 +126,8 @@ export interface NetworkSymbolNode {
126
126
  _pulseGlowRadius?: number;
127
127
  /** Visible side walls of a perspective token, painted before the symbol. */
128
128
  faces?: NetworkPerspectiveFace[];
129
+ /** @internal Projected token outline, including tokens with no side walls. */
130
+ _perspectiveToken?: boolean;
129
131
  }
130
132
  /**
131
133
  * Glyph node — the composite-pictogram channel for network scenes: a
@@ -173,6 +175,8 @@ export interface NetworkGlyphNode {
173
175
  * hit testing with `interactive: false`.
174
176
  */
175
177
  interface NetworkEdgeMetadata extends SceneAccessibilityMetadata {
178
+ /** @internal Semantic SVG export role assigned by the perspective stage. */
179
+ _perspectivePart?: string;
176
180
  id?: string;
177
181
  label?: string;
178
182
  interactive?: boolean;
@@ -279,6 +279,8 @@ export interface NetworkPipelineConfig {
279
279
  colorScheme?: string | string[] | Record<string, string>;
280
280
  /** Theme categorical palette — used as fallback when colorScheme is not an explicit array */
281
281
  themeCategorical?: string[];
282
+ themeSequential?: string;
283
+ themeSelectionOpacity?: number;
282
284
  /** Theme-resolved semantic role colors — default fallback before hardcoded hex. See `ThemeSemanticColors` in ./types. */
283
285
  themeSemantic?: ThemeSemanticColors;
284
286
  edgeColorBy?: "source" | "target" | "gradient" | ((d: Datum) => string);
@@ -65,6 +65,8 @@ export interface PipelineConfig {
65
65
  invertY?: boolean;
66
66
  sizeRange?: [number, number];
67
67
  binSize?: number;
68
+ /** Zero-anchored time bins start at, or surround, each grid timestamp. */
69
+ binAlign?: "start" | "center";
68
70
  normalize?: boolean;
69
71
  /** Stacked area baseline mode. Only consulted by stackedarea chart type. */
70
72
  baseline?: "zero" | "wiggle" | "silhouette" | "diverging";
@@ -4,6 +4,7 @@
4
4
  */
5
5
  import { type ScaleLinear } from "d3-scale";
6
6
  import type { Datum } from "../charts/shared/datumTypes";
7
+ import type { BinAlign } from "../realtime/BinAccumulator";
7
8
  import type { PipelineConfig } from "./pipelineConfig";
8
9
  import type { ArrowOfTime, StreamScales } from "./types";
9
10
  import type { ResolvedRibbon } from "./xySceneBuilders/ribbonScene";
@@ -34,7 +35,9 @@ export declare function resolveStackedAreaYDomain(options: {
34
35
  yDomain: [number, number];
35
36
  stackExtentCache: StackExtentCache;
36
37
  };
37
- export declare function resolveBarBinYDomain(buffer: RingBuffer<Datum>, getX: (d: Datum) => number, getY: (d: Datum) => number, binSize: number, getCategory: ((d: Datum) => string) | undefined, extentPadding: number, exactMode: boolean): [number, number];
38
+ export declare function resolveBarBinYDomain(buffer: RingBuffer<Datum>, getX: (d: Datum) => number, getY: (d: Datum) => number, binSize: number, getCategory: ((d: Datum) => string) | undefined, extentPadding: number, exactMode: boolean, binAlign?: BinAlign): [number, number];
39
+ /** Cover whole centered edge bins automatically, preserving explicit bounds. */
40
+ export declare function resolveCenteredBinXDomain(dataDomain: [number, number], binSize: number, userExtent: PipelineConfig["xExtent"]): [number, number];
38
41
  export declare function resolveWaterfallYDomain(buffer: RingBuffer<Datum>, getY: (d: Datum) => number, extentPadding: number, exactMode: boolean): [number, number];
39
42
  /**
40
43
  * Waterfall x values identify bar centers, so the automatic domain needs half
@@ -685,6 +685,8 @@ export interface StreamXYFrameProps<T = Datum> extends StreamSemanticInteraction
685
685
  closeAccessor?: string | ((d: T) => number);
686
686
  candlestickStyle?: CandlestickStyle;
687
687
  binSize?: number;
688
+ /** Zero-anchored time bins start at, or surround, each grid timestamp. */
689
+ binAlign?: "start" | "center";
688
690
  valueAccessor?: string | ((d: T) => number);
689
691
  arrowOfTime?: ArrowOfTime;
690
692
  windowMode?: WindowMode;
@@ -166,6 +166,8 @@ export interface UseFrameResult {
166
166
  clientY: number;
167
167
  pointerType?: string;
168
168
  }) => void;
169
+ /** Process a queued move before a newer synchronous activation changes state. */
170
+ flushPointerMove: () => void;
169
171
  /** Stable callback to attach to canvas's onPointerLeave (or onMouseLeave).
170
172
  * Cancels any pending hover rAF and invokes hoverLeaveRef. */
171
173
  onPointerLeave: () => void;