semiotic 3.10.1 → 3.10.2
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.
- package/README.md +67 -62
- package/ai/artifact-surface-inventory.json +4 -1
- package/ai/dist/mcp-server.js +25 -24
- package/ai/examples.md +28 -0
- package/ai/reference.md +6 -1
- package/ai/schema.json +121 -5
- package/ai/surface-manifest.json +3 -2
- package/ai/task-packets/compare-category-totals.json +7 -53
- package/ai/task-packets/compare-category-totals.md +4 -4
- package/ai/task-packets/correct-published-chart.json +7 -53
- package/ai/task-packets/correct-published-chart.md +4 -4
- package/ai/task-packets/index.json +9 -9
- package/ai/task-packets/update-live-chart.json +8 -54
- package/ai/task-packets/update-live-chart.md +4 -4
- package/dist/c-27DCB5T6.min.js +18 -0
- package/dist/c-2MONF2P6.min.js +1 -0
- package/dist/c-2TW5H5PD.min.js +1 -0
- package/dist/c-3AGX252H.min.js +1 -0
- package/dist/c-3B6JZEZT.min.js +1 -0
- package/dist/c-3BYZXCX3.min.js +4 -0
- package/dist/c-3DIPZJDO.min.js +1 -0
- package/dist/c-3FOUMWLR.min.js +1 -0
- package/dist/c-3NA6I656.min.js +2 -0
- package/dist/c-3OFVBWQY.min.js +1 -0
- package/dist/{c-QA3HMQJP.min.js → c-3PFVJFBK.min.js} +1 -1
- package/dist/c-3PPO7ZJF.min.js +4 -0
- package/dist/c-3YEW2PK6.min.js +1 -0
- package/dist/c-4JKDJUYD.min.js +1 -0
- package/dist/c-4LKK5YWB.min.js +1 -0
- package/dist/c-4MD53L2J.min.js +33 -0
- package/dist/c-4V3CD337.min.js +1 -0
- package/dist/c-4XLHPQTP.min.js +1 -0
- package/dist/c-5NYONM6V.min.js +5 -0
- package/dist/c-6IVBV5NO.min.js +1 -0
- package/dist/c-6ZU3QVLB.min.js +100 -0
- package/dist/c-72CBVNYX.min.js +209 -0
- package/dist/c-7APWCEPL.min.js +1 -0
- package/dist/c-7ASK4WBF.min.js +1 -0
- package/dist/{c-ORLEBW72.min.js → c-7FKPPCGN.min.js} +1 -1
- package/dist/c-7LY46QUI.min.js +41 -0
- package/dist/c-ABMGCCLT.min.js +1 -0
- package/dist/c-AINGQGUN.min.js +1 -0
- package/dist/c-AKLBQMQF.min.js +391 -0
- package/dist/c-AXJ2QI3F.min.js +1 -0
- package/dist/c-BQYD7T4E.min.js +1 -0
- package/dist/{c-V4XMSLC3.min.js → c-BYJJ7EMG.min.js} +1 -1
- package/dist/{c-J6DVC236.min.js → c-C4KIXUWU.min.js} +1 -1
- package/dist/c-C4SXYFXL.min.js +1 -0
- package/dist/c-CLDCKFBE.min.js +1 -0
- package/dist/c-CLJCJSFU.min.js +1 -0
- package/dist/c-CLLCX3PT.min.js +2 -0
- package/dist/c-ECHBKW7U.min.js +1 -0
- package/dist/c-EPJWM2UT.min.js +1 -0
- package/dist/c-F2GGJB2S.min.js +31 -0
- package/dist/c-FD2BXSRG.min.js +1 -0
- package/dist/c-FDUQDCBC.min.js +51 -0
- package/dist/c-FOTTQHOO.min.js +1 -0
- package/dist/c-FU7A5KSY.min.js +1 -0
- package/dist/c-G53AVC42.min.js +113 -0
- package/dist/c-GHN6IR4Y.min.js +1 -0
- package/dist/c-GSCO3FWL.min.js +1 -0
- package/dist/c-GYLOSK7M.min.js +1 -0
- package/dist/c-HK4OSLZA.min.js +1 -0
- package/dist/c-HLGTD5SJ.min.js +1 -0
- package/dist/c-HQ27AHMC.min.js +1 -0
- package/dist/{c-D6HAAPTX.min.js → c-IBRLFKWA.min.js} +1 -1
- package/dist/c-IHWZ2C6D.min.js +26 -0
- package/dist/c-IIV73MUW.min.js +1 -0
- package/dist/c-IPYGNVN6.min.js +116 -0
- package/dist/c-JJKRER47.min.js +1 -0
- package/dist/c-JO6AYCU4.min.js +1 -0
- package/dist/c-JWHPG6S2.min.js +1 -0
- package/dist/c-JXVYIXTV.min.js +1 -0
- package/dist/c-K2ZIYDI3.min.js +1 -0
- package/dist/c-K37JAIWA.min.js +4 -0
- package/dist/c-KGROWFT2.min.js +9 -0
- package/dist/c-MOP2NGLH.min.js +1 -0
- package/dist/c-MTX2AO5S.min.js +1 -0
- package/dist/c-N5WT7TXG.min.js +1 -0
- package/dist/c-NATWERHZ.min.js +1 -0
- package/dist/{c-42PLDTX7.min.js → c-O53GOO7H.min.js} +1 -1
- package/dist/c-OVQB75PE.min.js +1 -0
- package/dist/c-P3SKRNZN.min.js +1 -0
- package/dist/c-P5NXQWIM.min.js +1 -0
- package/dist/c-P7BQMVQQ.min.js +1 -0
- package/dist/{c-GNTXRXRN.min.js → c-PDQHLOKU.min.js} +1 -1
- package/dist/c-PKY4JFY5.min.js +1 -0
- package/dist/c-PQOZPM4G.min.js +1 -0
- package/dist/c-PZ3NEGNG.min.js +1 -0
- package/dist/c-QXLDCATV.min.js +1 -0
- package/dist/c-R2HUSWKB.min.js +1 -0
- package/dist/{c-HYW2XA4Q.min.js → c-RHDOOQ4X.min.js} +1 -1
- package/dist/c-RZPP5ERV.min.js +1 -0
- package/dist/c-SG2Y7EBY.min.js +46 -0
- package/dist/{c-WUWXGQYA.min.js → c-SJIB5RNI.min.js} +1 -1
- package/dist/c-SQNEVNWT.min.js +1 -0
- package/dist/c-STHZWF3D.min.js +1 -0
- package/dist/c-TIDKVMMZ.min.js +1 -0
- package/dist/c-TIMGODBG.min.js +1 -0
- package/dist/c-TR7OHUAO.min.js +2 -0
- package/dist/c-TTKWXGAI.min.js +61 -0
- package/dist/c-TVKZC4BY.min.js +1 -0
- package/dist/c-U5XVLSHN.min.js +1 -0
- package/dist/c-U6NLVFN4.min.js +1 -0
- package/dist/{c-VJTDST2R.min.js → c-UBHICVSC.min.js} +1 -1
- package/dist/c-UOPPO26M.min.js +1 -0
- package/dist/c-UUDAON4Z.min.js +1 -0
- package/dist/c-V32TPPY2.min.js +1 -0
- package/dist/c-V5KFJWQQ.min.js +1 -0
- package/dist/{c-P65V6HLO.min.js → c-VN557BQE.min.js} +1 -1
- package/dist/c-VXIYF7V2.min.js +1 -0
- package/dist/c-Y342FJ6K.min.js +1 -0
- package/dist/c-YM6CT4LJ.min.js +1 -0
- package/dist/{c-MVR3RWF3.min.js → c-YMFUIO54.min.js} +1 -1
- package/dist/c-YQVOKPKR.min.js +1 -0
- package/dist/c-YRJ3BJQZ.min.js +1 -0
- package/dist/c-YT5KPVNP.min.js +1 -0
- package/dist/components/ai/audienceProfile.d.ts +18 -1
- package/dist/components/ai/describeChart.d.ts +5 -1
- package/dist/components/ai/intentManifest.d.ts +16 -0
- package/dist/components/ai/intentRegistry.d.ts +12 -0
- package/dist/components/ai/intents.d.ts +6 -6
- package/dist/components/ai/streamSchema.d.ts +19 -0
- package/dist/components/ai/streamingTypes.d.ts +57 -11
- package/dist/components/ai/suggestCharts.d.ts +1 -1
- package/dist/components/ai/suggestStreamCharts.d.ts +43 -8
- package/dist/components/ai/suggestStreamDashboard.d.ts +35 -0
- package/dist/components/ai/variantDiscovery.d.ts +1 -1
- package/dist/components/charts/ordinal/BarChart.streamCapability.d.ts +2 -0
- package/dist/components/charts/ordinal/DonutChart.streamCapability.d.ts +2 -0
- package/dist/components/charts/ordinal/GroupedBarChart.streamCapability.d.ts +2 -0
- package/dist/components/charts/ordinal/PieChart.streamCapability.d.ts +2 -0
- package/dist/components/charts/ordinal/StackedBarChart.streamCapability.d.ts +2 -0
- package/dist/components/charts/realtime/RealtimeAccumulator.d.ts +14 -0
- package/dist/components/charts/realtime/RealtimeHeatmap.d.ts +6 -5
- package/dist/components/charts/realtime/RealtimeHistogram.d.ts +5 -1
- package/dist/components/charts/realtime/RealtimeLineChart.d.ts +2 -161
- package/dist/components/charts/realtime/RealtimeLineChart.types.d.ts +175 -0
- package/dist/components/charts/realtime/RealtimeSwarmChart.d.ts +6 -5
- package/dist/components/charts/realtime/RealtimeWaterfallChart.d.ts +6 -5
- package/dist/components/charts/realtime/aggregate.d.ts +11 -1
- package/dist/components/charts/realtime/resolveWindowSize.d.ts +1 -1
- package/dist/components/charts/shared/DirectLabelLayer.d.ts +25 -0
- package/dist/components/charts/shared/directLabels.d.ts +12 -0
- package/dist/components/charts/shared/knownChartComponents.d.ts +4 -1
- package/dist/components/charts/shared/lineSeriesSsr.d.ts +0 -12
- package/dist/components/charts/shared/useChartSetup.d.ts +2 -0
- package/dist/components/charts/value/BigNumber.streamCapability.d.ts +2 -0
- package/dist/components/charts/value/GaugeChart.streamCapability.d.ts +2 -0
- package/dist/components/charts/xy/BubbleChart.d.ts +4 -1
- package/dist/components/charts/xy/ConnectedScatterplot.d.ts +4 -1
- package/dist/components/charts/xy/LineChart.d.ts +4 -1
- package/dist/components/charts/xy/Scatterplot.d.ts +7 -0
- package/dist/components/realtime/HyperLogLog.d.ts +19 -0
- package/dist/components/realtime/ReorderBuffer.d.ts +2 -2
- package/dist/components/realtime/TDigest.d.ts +22 -0
- package/dist/components/realtime/WindowAccumulator.d.ts +22 -5
- package/dist/components/realtime/applyChangelog.d.ts +38 -0
- package/dist/components/realtime/minHeap.d.ts +3 -0
- package/dist/components/recipes/atlas/flowCircuitChartProps.d.ts +1 -1
- package/dist/components/recipes/layout1d.d.ts +2 -20
- package/dist/components/recipes/minGapPlacement.d.ts +20 -0
- package/dist/components/semiotic-ai-core.d.ts +8 -3
- package/dist/components/semiotic-ai-stream.d.ts +10 -0
- package/dist/components/semiotic-ai.d.ts +4 -6
- package/dist/components/semiotic-realtime-core.d.ts +6 -2
- package/dist/components/semiotic-stream-types.d.ts +14 -0
- package/dist/components/semiotic-xy.d.ts +1 -0
- package/dist/components/semiotic.d.ts +3 -11
- package/dist/components/server/encodeSvgFramesToGif.d.ts +2 -0
- package/dist/components/server/rasterizeSVG.d.ts +2 -0
- package/dist/components/server/registerServerXYPlugins.d.ts +2 -0
- package/dist/components/server/renderEvidence.d.ts +4 -0
- package/dist/components/server/serverChartConfigs.d.ts +5 -0
- package/dist/components/server/serverChartConfigsRealtime.d.ts +6 -0
- package/dist/components/server/serverRealtimeCategoryColors.d.ts +3 -0
- package/dist/components/server/staticAnnotations.d.ts +9 -0
- package/dist/components/stream/SceneGraph.d.ts +3 -3
- package/dist/components/stream/StalenessBadge.d.ts +5 -2
- package/dist/components/stream/pipelinePathJoin.d.ts +27 -0
- package/dist/components/stream/pipelineTransitionTypes.d.ts +43 -0
- package/dist/components/stream/pipelineTransitions.d.ts +5 -35
- package/dist/components/stream/seriesGeometry.d.ts +2 -1
- package/dist/components/stream/streamEncodingTypes.d.ts +9 -0
- package/dist/components/stream/types.d.ts +25 -2
- package/dist/components/text/axisLabelAssessment.d.ts +15 -0
- package/dist/components/text/browserAxisLabelAssessment.d.ts +1 -0
- package/dist/components/text/browserLabelMeasurement.d.ts +3 -0
- package/dist/components/text/labelMeasurement.d.ts +19 -0
- package/dist/components/text/labelPlacement.d.ts +71 -0
- package/dist/components/text/useAxisLabelAssessment.d.ts +6 -0
- package/dist/components/text/useLabelMeasurer.d.ts +3 -0
- package/dist/controls.module.min.js +71 -1
- package/dist/geo.min.js +231 -1
- package/dist/geo.module.min.js +31 -1
- package/dist/network.module.min.js +1 -1
- package/dist/ordinal.module.min.js +1 -1
- package/dist/physics-matter.module.min.js +1 -1
- package/dist/physics-rapier.module.min.js +1 -1
- package/dist/physics.module.min.js +1 -1
- package/dist/rough.min.js +2 -1
- package/dist/rough.module.min.js +2 -1
- package/dist/semiotic-access.module.min.js +1 -1
- package/dist/semiotic-ai-artifact-policy-constants.module.min.js +1 -1
- package/dist/semiotic-ai-core.d.ts +8 -3
- package/dist/semiotic-ai-core.min.js +4 -1
- package/dist/semiotic-ai-core.module.min.js +4 -1
- package/dist/semiotic-ai-hash-primitives.module.min.js +1 -1
- package/dist/semiotic-ai.d.ts +4 -6
- package/dist/semiotic-ai.module.min.js +14 -1
- package/dist/semiotic-artifact-react.min.js +269 -1
- package/dist/semiotic-artifact-react.module.min.js +137 -1
- package/dist/semiotic-artifact.min.js +3 -1
- package/dist/semiotic-artifact.module.min.js +3 -1
- package/dist/semiotic-atlas-core.min.js +2 -1
- package/dist/semiotic-atlas-core.module.min.js +1 -1
- package/dist/semiotic-atlas-selection.module.min.js +1 -1
- package/dist/semiotic-atlas.module.min.js +11 -1
- package/dist/semiotic-client-cjs-shared.min.js +1529 -1
- package/dist/semiotic-client-glyph.module.min.js +3 -1
- package/dist/semiotic-client-responsive.module.min.js +1 -1
- package/dist/semiotic-client-shared.module.min.js +1 -1
- package/dist/semiotic-custom-layout-selection-cjs-shared.min.js +2 -1
- package/dist/semiotic-data.min.js +1 -1
- package/dist/semiotic-data.module.min.js +1 -1
- package/dist/semiotic-evidence.min.js +3 -1
- package/dist/semiotic-evidence.module.min.js +3 -1
- package/dist/semiotic-experimental-auxiliary.module.min.js +8 -1
- package/dist/semiotic-experimental-node-auxiliary.module.min.js +8 -1
- package/dist/semiotic-experimental-react-shared.module.min.js +1 -1
- package/dist/semiotic-experimental-vacp.min.js +1 -1
- package/dist/semiotic-experimental-vacp.module.min.js +1 -1
- package/dist/semiotic-line.module.min.js +1 -1
- package/dist/semiotic-realtime-core.d.ts +6 -2
- package/dist/semiotic-realtime-core.module.min.js +1 -1
- package/dist/semiotic-realtime-react.module.min.js +1 -1
- package/dist/semiotic-recipes-core-cjs-base.min.js +160 -1
- package/dist/semiotic-recipes-core.module.min.js +72 -1
- package/dist/semiotic-recipes-geo-cjs.min.js +1 -1
- package/dist/semiotic-recipes-react.min.js +3 -1
- package/dist/semiotic-server-edge-node.module.min.js +391 -1
- package/dist/semiotic-server-edge.min.js +651 -1
- package/dist/semiotic-server-edge.module.min.js +372 -1
- package/dist/semiotic-server-node.min.js +651 -1
- package/dist/semiotic-server-node.module.min.js +1 -1
- package/dist/semiotic-text.min.js +1 -1
- package/dist/semiotic-text.module.min.js +1 -1
- package/dist/semiotic-themes-core.min.js +1 -1
- package/dist/semiotic-themes-core.module.min.js +1 -1
- package/dist/semiotic-themes.min.js +1 -1
- package/dist/semiotic-themes.module.min.js +1 -1
- package/dist/semiotic-utils-core.min.js +11 -1
- package/dist/semiotic-utils-core.module.min.js +8 -1
- package/dist/semiotic-value.module.min.js +15 -1
- package/dist/semiotic-xy.d.ts +1 -0
- package/dist/semiotic.d.ts +3 -11
- package/dist/semiotic.module.min.js +10 -1
- package/dist/server.min.js +651 -1
- package/dist/server.module.min.js +1 -1
- package/dist/xy.module.min.js +1 -1
- package/package.json +4 -3
- package/dist/c-2N7IU2NY.min.js +0 -1
- package/dist/c-2RL2QPZJ.min.js +0 -1
- package/dist/c-2WK7YJLL.min.js +0 -1
- package/dist/c-45CQWZZ6.min.js +0 -1
- package/dist/c-4BRHKVKV.min.js +0 -1
- package/dist/c-7242NXSG.min.js +0 -1
- package/dist/c-7DVPSB5C.min.js +0 -1
- package/dist/c-7EGHJU2F.min.js +0 -1
- package/dist/c-A7OGOFSL.min.js +0 -1
- package/dist/c-AFBSWT77.min.js +0 -1
- package/dist/c-AH5HWZWS.min.js +0 -1
- package/dist/c-AJ7EC32V.min.js +0 -1
- package/dist/c-AQADQNY7.min.js +0 -1
- package/dist/c-ATM475SA.min.js +0 -1
- package/dist/c-AVO3Q7T7.min.js +0 -1
- package/dist/c-B7GW7IHJ.min.js +0 -1
- package/dist/c-BNFJMDHN.min.js +0 -1
- package/dist/c-BOHCQILI.min.js +0 -1
- package/dist/c-C3TZLTZK.min.js +0 -1
- package/dist/c-CGQAQWBV.min.js +0 -1
- package/dist/c-CPV4N35K.min.js +0 -1
- package/dist/c-DIPEYUOW.min.js +0 -1
- package/dist/c-E4JDJH4I.min.js +0 -1
- package/dist/c-E72OTUZU.min.js +0 -1
- package/dist/c-E7I2L7CU.min.js +0 -1
- package/dist/c-ELDWAO2V.min.js +0 -1
- package/dist/c-EUBTECGM.min.js +0 -1
- package/dist/c-EUMPMDCS.min.js +0 -1
- package/dist/c-EZZT2WAE.min.js +0 -1
- package/dist/c-FHBVFCQB.min.js +0 -1
- package/dist/c-G4HCO2IQ.min.js +0 -1
- package/dist/c-G5VIJEOK.min.js +0 -1
- package/dist/c-GHVOXAYH.min.js +0 -1
- package/dist/c-GXV3C3MO.min.js +0 -1
- package/dist/c-HHTK2R75.min.js +0 -1
- package/dist/c-HLLFJYTY.min.js +0 -1
- package/dist/c-HP4ZFM47.min.js +0 -1
- package/dist/c-HPOYKCCG.min.js +0 -1
- package/dist/c-HYDTS5OP.min.js +0 -1
- package/dist/c-I4QJ6YLM.min.js +0 -1
- package/dist/c-IK33LNZ6.min.js +0 -1
- package/dist/c-IK3PZHRY.min.js +0 -1
- package/dist/c-JIMJF6F6.min.js +0 -1
- package/dist/c-JUKIWTBJ.min.js +0 -1
- package/dist/c-KKPMHAZC.min.js +0 -1
- package/dist/c-L6WNDBHV.min.js +0 -1
- package/dist/c-LDEX5OFW.min.js +0 -1
- package/dist/c-LESEUVC5.min.js +0 -1
- package/dist/c-LYQMZMZQ.min.js +0 -1
- package/dist/c-MB6CV5NC.min.js +0 -1
- package/dist/c-MOKJOIPE.min.js +0 -1
- package/dist/c-N3FXLRNT.min.js +0 -1
- package/dist/c-N5NPTJVJ.min.js +0 -1
- package/dist/c-NHBL4J67.min.js +0 -1
- package/dist/c-ODG6TFSY.min.js +0 -1
- package/dist/c-PRIKOLTE.min.js +0 -1
- package/dist/c-PSKKFZNP.min.js +0 -1
- package/dist/c-PSNI6KAZ.min.js +0 -1
- package/dist/c-QAVFOEUY.min.js +0 -1
- package/dist/c-R2P4RR7Q.min.js +0 -1
- package/dist/c-RFC7UAG7.min.js +0 -1
- package/dist/c-S3AZX5PP.min.js +0 -1
- package/dist/c-SGAURYHG.min.js +0 -1
- package/dist/c-SJMWU6UX.min.js +0 -1
- package/dist/c-STIIGQOD.min.js +0 -1
- package/dist/c-T2ASIJVZ.min.js +0 -1
- package/dist/c-T2V7O2LO.min.js +0 -1
- package/dist/c-TKG2NP7G.min.js +0 -1
- package/dist/c-TX3THUTO.min.js +0 -1
- package/dist/c-TX7XJM3Z.min.js +0 -1
- package/dist/c-UC7SIU2W.min.js +0 -1
- package/dist/c-UMXSJIOV.min.js +0 -1
- package/dist/c-VRSXMLYF.min.js +0 -1
- package/dist/c-VSLWSAN2.min.js +0 -1
- package/dist/c-VXLOLYTO.min.js +0 -1
- package/dist/c-W4ZUKSEQ.min.js +0 -1
- package/dist/c-WCBRPILW.min.js +0 -1
- package/dist/c-WGHT7OCY.min.js +0 -1
- package/dist/c-WWCW3APR.min.js +0 -1
- package/dist/c-XSB27XPS.min.js +0 -1
- package/dist/c-Y6PYUMFU.min.js +0 -1
- package/dist/c-YDECTEUW.min.js +0 -1
- package/dist/c-YF3YKVQI.min.js +0 -1
- package/dist/c-YLZIV3VS.min.js +0 -1
- package/dist/c-ZIVPFTOC.min.js +0 -1
|
@@ -0,0 +1,175 @@
|
|
|
1
|
+
import type { CSSProperties, ReactNode } from "react";
|
|
2
|
+
import type { RealtimeFrameHandle } from "../../realtime/types";
|
|
3
|
+
import type { AnnotationContext, ArrowOfTime, DecayConfig, HoverAnnotationConfig, HoverData, PulseConfig, StalenessConfig, TransitionConfig, WindowMode } from "../../stream/types";
|
|
4
|
+
import type { OnObservationCallback } from "../../store/ObservationStore";
|
|
5
|
+
import type { AutoPlaceAnnotations } from "../../recipes/annotationLayout";
|
|
6
|
+
import type { MobileVisualizationContract } from "../shared/auditMobileVisualization";
|
|
7
|
+
import type { ResponsiveRule } from "../shared/responsiveRules";
|
|
8
|
+
import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
|
|
9
|
+
import type { ChartAccessor, ChartMode, LinkedHoverProp, MobileInteractionProp, SelectionConfig } from "../shared/types";
|
|
10
|
+
import type { Datum } from "../shared/datumTypes";
|
|
11
|
+
import type { StyleRule } from "../shared/styleRules";
|
|
12
|
+
import type { PartialMargin } from "../../types/marginType";
|
|
13
|
+
import type { AggregateConfig } from "./aggregate";
|
|
14
|
+
import type { EventTimeConfig } from "./eventTime";
|
|
15
|
+
import type { RealtimeAccessibilityProps, RealtimeData, RealtimePointIdAccessor, RealtimeTooltipProp } from "./realtimeChartTypes";
|
|
16
|
+
/**
|
|
17
|
+
* Imperative handle for RealtimeLineChart. It extends the shared realtime
|
|
18
|
+
* handle without changing that cross-chart contract: only this chart exposes
|
|
19
|
+
* event-time tail flushing.
|
|
20
|
+
*/
|
|
21
|
+
export interface RealtimeLineChartHandle<TDatum extends Datum = Datum, TReadDatum extends Datum = TDatum> extends RealtimeFrameHandle<TDatum, TReadDatum> {
|
|
22
|
+
/**
|
|
23
|
+
* Release every event still held by `eventTime`, in event-time order.
|
|
24
|
+
* Call this when an input source reaches an asserted end-of-stream or batch
|
|
25
|
+
* boundary. Later newer events remain supported; events older than the
|
|
26
|
+
* flushed frontier follow `latePolicy`.
|
|
27
|
+
*/
|
|
28
|
+
flush(): void;
|
|
29
|
+
}
|
|
30
|
+
export interface RealtimeLineChartProps<TDatum extends Datum = Datum> extends RealtimeAccessibilityProps {
|
|
31
|
+
/** Fit the container width. */
|
|
32
|
+
responsiveWidth?: boolean;
|
|
33
|
+
/** Fit a container with a definite height. */
|
|
34
|
+
responsiveHeight?: boolean;
|
|
35
|
+
/** Display mode: "primary" (full chrome), "context" (compact), "sparkline" (inline) */
|
|
36
|
+
mode?: ChartMode;
|
|
37
|
+
/** Semantic responsive transformations applied before chart-mode defaults. */
|
|
38
|
+
responsiveRules?: ResponsiveRule[];
|
|
39
|
+
/** Phone/mobile contract consumed by audits, recipes, adapters, and agents. */
|
|
40
|
+
mobileSemantics?: MobileVisualizationContract;
|
|
41
|
+
/** Touch-first interaction policy for phone-sized chart slots. */
|
|
42
|
+
mobileInteraction?: MobileInteractionProp;
|
|
43
|
+
/** Chart dimensions as [width, height] */
|
|
44
|
+
size?: [number, number];
|
|
45
|
+
/** Chart width (alternative to size) */
|
|
46
|
+
width?: number;
|
|
47
|
+
/** Chart height (alternative to size) */
|
|
48
|
+
height?: number;
|
|
49
|
+
/** Maximum canvas backing-store DPR; large canvases also use the shared backing-store budget. */
|
|
50
|
+
maxDevicePixelRatio?: number;
|
|
51
|
+
/** Chart margins */
|
|
52
|
+
margin?: PartialMargin;
|
|
53
|
+
/** CSS class name */
|
|
54
|
+
className?: string;
|
|
55
|
+
onObservation?: OnObservationCallback;
|
|
56
|
+
chartId?: string;
|
|
57
|
+
/** Direction time flows */
|
|
58
|
+
arrowOfTime?: ArrowOfTime;
|
|
59
|
+
/** Data retention strategy */
|
|
60
|
+
windowMode?: WindowMode;
|
|
61
|
+
/** Ring buffer capacity */
|
|
62
|
+
windowSize?: number;
|
|
63
|
+
/**
|
|
64
|
+
* Ring-buffer capacity. Alias for `windowSize` — prefer this name when
|
|
65
|
+
* "window" means the aggregation window (`aggregate.window`).
|
|
66
|
+
*/
|
|
67
|
+
capacity?: number;
|
|
68
|
+
/** Alias for `windowMode`. */
|
|
69
|
+
capacityMode?: WindowMode;
|
|
70
|
+
/** Split the line into series. Passed to the frame as `groupAccessor`. */
|
|
71
|
+
seriesAccessor?: ChartAccessor<TDatum, string>;
|
|
72
|
+
/** Controlled data array */
|
|
73
|
+
data?: RealtimeData<TDatum>;
|
|
74
|
+
/** Time value accessor */
|
|
75
|
+
timeAccessor?: ChartAccessor<TDatum, number>;
|
|
76
|
+
/** Value accessor */
|
|
77
|
+
valueAccessor?: ChartAccessor<TDatum, number>;
|
|
78
|
+
/** Fixed time domain */
|
|
79
|
+
timeExtent?: [number, number];
|
|
80
|
+
/** Fixed value domain */
|
|
81
|
+
valueExtent?: [number, number];
|
|
82
|
+
/** Extent padding factor */
|
|
83
|
+
extentPadding?: number;
|
|
84
|
+
/** Line color */
|
|
85
|
+
stroke?: string;
|
|
86
|
+
/** Line width */
|
|
87
|
+
strokeWidth?: number;
|
|
88
|
+
/** Dash pattern (e.g. "4,2") */
|
|
89
|
+
strokeDasharray?: string;
|
|
90
|
+
/** Uniform line opacity (0–1). Pairs with `stroke` / `strokeWidth` for the designer-facing primitive vocabulary. */
|
|
91
|
+
opacity?: number;
|
|
92
|
+
/** Presentation-only CSS cursor for retained marks; does not add click, keyboard, or observation behavior. */
|
|
93
|
+
cursor?: CSSProperties["cursor"];
|
|
94
|
+
/** Ordered data-aware line styling, resolved against the displayed series sample. */
|
|
95
|
+
styleRules?: StyleRule[];
|
|
96
|
+
/** Show canvas-drawn axes */
|
|
97
|
+
showAxes?: boolean;
|
|
98
|
+
/** Background fill color */
|
|
99
|
+
background?: string;
|
|
100
|
+
/** Enable hover interaction */
|
|
101
|
+
enableHover?: boolean | HoverAnnotationConfig;
|
|
102
|
+
/** Custom tooltip renderer */
|
|
103
|
+
tooltipContent?: (d: HoverData) => ReactNode;
|
|
104
|
+
/** Callback on hover */
|
|
105
|
+
onHover?: (d: HoverData | null) => void;
|
|
106
|
+
/** Annotation objects */
|
|
107
|
+
annotations?: Datum[];
|
|
108
|
+
/** Opt into automatic placement for note-like annotations without manual offsets. */
|
|
109
|
+
autoPlaceAnnotations?: AutoPlaceAnnotations;
|
|
110
|
+
/** SVG annotation render function */
|
|
111
|
+
svgAnnotationRules?: (annotation: Datum, index: number, context: AnnotationContext) => ReactNode;
|
|
112
|
+
/** Custom formatter for time axis ticks */
|
|
113
|
+
tickFormatTime?: (value: number) => string;
|
|
114
|
+
/** Custom formatter for value axis ticks */
|
|
115
|
+
tickFormatValue?: (value: number) => string;
|
|
116
|
+
/** Declarative tooltip config or the legacy full-HoverData callback. Pass `"multi"` for hover-anywhere line values. */
|
|
117
|
+
tooltip?: RealtimeTooltipProp;
|
|
118
|
+
/** Configurable opacity decay for older data */
|
|
119
|
+
decay?: DecayConfig;
|
|
120
|
+
/** Flash effect on newly inserted data */
|
|
121
|
+
pulse?: PulseConfig;
|
|
122
|
+
/** Frame-level data liveness indicator */
|
|
123
|
+
staleness?: StalenessConfig;
|
|
124
|
+
/** Smooth position interpolation on data change */
|
|
125
|
+
transition?: TransitionConfig;
|
|
126
|
+
/** Enable linked hover selection events for cross-chart highlighting */
|
|
127
|
+
linkedHover?: LinkedHoverProp;
|
|
128
|
+
/** Consume a named selection — dims unselected elements */
|
|
129
|
+
selection?: SelectionConfig;
|
|
130
|
+
/** Show a loading skeleton placeholder */
|
|
131
|
+
loading?: boolean;
|
|
132
|
+
/** Custom content rendered in place of the default skeleton while `loading` is true. */
|
|
133
|
+
loadingContent?: ReactNode | false;
|
|
134
|
+
/** Custom content to render when data is empty. Set to `false` to disable empty state. */
|
|
135
|
+
emptyContent?: ReactNode | false;
|
|
136
|
+
/** Visual emphasis level for dashboard hierarchy. "primary" spans two columns in ChartGrid. */
|
|
137
|
+
emphasis?: "primary" | "secondary";
|
|
138
|
+
/** Show a legend */
|
|
139
|
+
showLegend?: boolean;
|
|
140
|
+
/** Legend position */
|
|
141
|
+
legendPosition?: LegendPosition;
|
|
142
|
+
/** Legend interaction mode */
|
|
143
|
+
legendInteraction?: LegendInteractionMode;
|
|
144
|
+
/**
|
|
145
|
+
* Stable per-point ID for push-mode `remove()`/`update()`, point annotations,
|
|
146
|
+
* and identity-keyed path transitions. With `transition` on a sliding
|
|
147
|
+
* window, retained vertices slide by this ID instead of interpolating by
|
|
148
|
+
* array index.
|
|
149
|
+
*/
|
|
150
|
+
pointIdAccessor?: RealtimePointIdAccessor<TDatum>;
|
|
151
|
+
/**
|
|
152
|
+
* Opt-in windowed aggregation over event-time. When set, pushed
|
|
153
|
+
* events are reduced into tumbling/hopping/session windows and the
|
|
154
|
+
* chart draws one mark per window (mean/sum/min/max/count) plus an
|
|
155
|
+
* optional ±σ or min–max band — render cost scales with the number of
|
|
156
|
+
* visible windows, not the arrival rate. This is the **aggregation
|
|
157
|
+
* window**, distinct from `windowMode`'s RingBuffer eviction. Changing a
|
|
158
|
+
* structural window field or either accessor rebuilds the accumulator:
|
|
159
|
+
* controlled `data` is reseeded, while push-only input begins a new epoch
|
|
160
|
+
* because raw events are deliberately not retained.
|
|
161
|
+
*/
|
|
162
|
+
aggregate?: AggregateConfig;
|
|
163
|
+
/**
|
|
164
|
+
* Opt-in event-time ingestion. Buffers pushed events for a bounded
|
|
165
|
+
* lateness/grace window and releases them to the chart in event-time
|
|
166
|
+
* order, so out-of-order or merged multi-source streams render
|
|
167
|
+
* monotonically instead of zigzagging. Late events (older than
|
|
168
|
+
* `watermark − lateness`) are dropped or kept per policy and surfaced
|
|
169
|
+
* via `onObservation` as `"late-data"`. Default-off; when unset the
|
|
170
|
+
* push path is byte-for-byte unchanged. Call `ref.current.flush()` at an
|
|
171
|
+
* asserted end-of-stream boundary so the final grace-window events are
|
|
172
|
+
* released in order.
|
|
173
|
+
*/
|
|
174
|
+
eventTime?: EventTimeConfig;
|
|
175
|
+
}
|
|
@@ -3,7 +3,7 @@ import type { ArrowOfTime, WindowMode, Style, HoverAnnotationConfig, HoverData,
|
|
|
3
3
|
import type { RealtimeFrameHandle } from "../../realtime/types";
|
|
4
4
|
import type { CSSProperties, ReactNode } from "react";
|
|
5
5
|
import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
|
|
6
|
-
import type { ChartMode, ChartAccessor, SelectionConfig, MobileInteractionProp } from "../shared/types";
|
|
6
|
+
import type { ChartMode, ChartAccessor, LinkedHoverProp, SelectionConfig, MobileInteractionProp } from "../shared/types";
|
|
7
7
|
import type { OnObservationCallback } from "../../store/ObservationStore";
|
|
8
8
|
import type { Datum } from "../shared/datumTypes";
|
|
9
9
|
import type { AutoPlaceAnnotations } from "../../recipes/annotationLayout";
|
|
@@ -43,6 +43,10 @@ export interface RealtimeSwarmChartProps<TDatum extends Datum = Datum> extends R
|
|
|
43
43
|
arrowOfTime?: ArrowOfTime;
|
|
44
44
|
/** Data retention strategy */
|
|
45
45
|
windowMode?: WindowMode;
|
|
46
|
+
/** Alias for `windowSize` — ring-buffer capacity, not the aggregation window. */
|
|
47
|
+
capacity?: number;
|
|
48
|
+
/** Alias for `windowMode`. */
|
|
49
|
+
capacityMode?: WindowMode;
|
|
46
50
|
/** Ring buffer capacity */
|
|
47
51
|
windowSize?: number;
|
|
48
52
|
/** Controlled data array */
|
|
@@ -112,10 +116,7 @@ export interface RealtimeSwarmChartProps<TDatum extends Datum = Datum> extends R
|
|
|
112
116
|
/** Declarative tooltip config or the legacy full-HoverData callback. */
|
|
113
117
|
tooltip?: RealtimeTooltipProp;
|
|
114
118
|
/** Enable linked hover selection events for cross-chart highlighting */
|
|
115
|
-
linkedHover?:
|
|
116
|
-
name?: string;
|
|
117
|
-
fields: string[];
|
|
118
|
-
};
|
|
119
|
+
linkedHover?: LinkedHoverProp;
|
|
119
120
|
/** Consume a named selection — dims unselected elements */
|
|
120
121
|
selection?: SelectionConfig;
|
|
121
122
|
/** Show a loading skeleton placeholder */
|
|
@@ -3,7 +3,7 @@ import type { ArrowOfTime, WindowMode, HoverAnnotationConfig, HoverData, Annotat
|
|
|
3
3
|
import type { RealtimeFrameHandle } from "../../realtime/types";
|
|
4
4
|
import type { CSSProperties, ReactNode } from "react";
|
|
5
5
|
import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
|
|
6
|
-
import type { ChartMode, ChartAccessor, SelectionConfig, MobileInteractionProp } from "../shared/types";
|
|
6
|
+
import type { ChartMode, ChartAccessor, LinkedHoverProp, SelectionConfig, MobileInteractionProp } from "../shared/types";
|
|
7
7
|
import type { OnObservationCallback } from "../../store/ObservationStore";
|
|
8
8
|
import type { Datum } from "../shared/datumTypes";
|
|
9
9
|
import type { AutoPlaceAnnotations } from "../../recipes/annotationLayout";
|
|
@@ -43,6 +43,10 @@ export interface RealtimeWaterfallChartProps<TDatum extends Datum = Datum> exten
|
|
|
43
43
|
arrowOfTime?: ArrowOfTime;
|
|
44
44
|
/** Data retention strategy */
|
|
45
45
|
windowMode?: WindowMode;
|
|
46
|
+
/** Alias for `windowSize` — ring-buffer capacity, not the aggregation window. */
|
|
47
|
+
capacity?: number;
|
|
48
|
+
/** Alias for `windowMode`. */
|
|
49
|
+
capacityMode?: WindowMode;
|
|
46
50
|
/** Ring buffer capacity */
|
|
47
51
|
windowSize?: number;
|
|
48
52
|
/** Controlled data array */
|
|
@@ -108,10 +112,7 @@ export interface RealtimeWaterfallChartProps<TDatum extends Datum = Datum> exten
|
|
|
108
112
|
/** Declarative tooltip config or the legacy full-HoverData callback. */
|
|
109
113
|
tooltip?: RealtimeTooltipProp;
|
|
110
114
|
/** Enable linked hover selection events for cross-chart highlighting */
|
|
111
|
-
linkedHover?:
|
|
112
|
-
name?: string;
|
|
113
|
-
fields: string[];
|
|
114
|
-
};
|
|
115
|
+
linkedHover?: LinkedHoverProp;
|
|
115
116
|
/** Consume a named selection — dims unselected elements */
|
|
116
117
|
selection?: SelectionConfig;
|
|
117
118
|
/** Show a loading skeleton placeholder */
|
|
@@ -25,8 +25,18 @@ export interface AggregateConfig {
|
|
|
25
25
|
band?: AggregateBand;
|
|
26
26
|
/** Multiplier for the `stddev` band (drawn as value ± sigma·σ). @default 1 */
|
|
27
27
|
sigma?: number;
|
|
28
|
-
/** Keep at most this many most-recent windows. @default unbounded */
|
|
28
|
+
/** Keep at most this many most-recent windows per series. @default unbounded */
|
|
29
29
|
retain?: number;
|
|
30
|
+
/**
|
|
31
|
+
* Quantiles to emit per window (e.g. `[0.5, 0.95, 0.99]`). Structural:
|
|
32
|
+
* changing this rebuilds the accumulator (same as `window` / `size`).
|
|
33
|
+
*/
|
|
34
|
+
percentiles?: ReadonlyArray<number>;
|
|
35
|
+
/**
|
|
36
|
+
* Track an approximate distinct count per window. Structural: changing
|
|
37
|
+
* this rebuilds the accumulator.
|
|
38
|
+
*/
|
|
39
|
+
distinct?: boolean;
|
|
30
40
|
}
|
|
31
41
|
export declare const AGG_TIME = "time";
|
|
32
42
|
export declare const AGG_VALUE = "value";
|
|
@@ -23,4 +23,4 @@ import type { Datum } from "../shared/datumTypes";
|
|
|
23
23
|
* Replaces the historical `windowSize={data.length}` workaround that
|
|
24
24
|
* appeared in our own theming docs and likely consumer code.
|
|
25
25
|
*/
|
|
26
|
-
export declare function resolveRealtimeWindowSize(windowSizeProp: number | undefined, data: Datum[] | undefined): number;
|
|
26
|
+
export declare function resolveRealtimeWindowSize(windowSizeProp: number | undefined, data: Datum[] | undefined, capacityProp?: number): number;
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
import * as React from "react";
|
|
2
|
+
import type { Datum } from "./datumTypes";
|
|
3
|
+
import { type LabelMeasurer } from "../../text/labelMeasurement";
|
|
4
|
+
import { type LabelLayoutEvidence } from "../../text/labelPlacement";
|
|
5
|
+
export interface DirectLabelLayoutContext {
|
|
6
|
+
width: number;
|
|
7
|
+
height: number;
|
|
8
|
+
margin?: {
|
|
9
|
+
left: number;
|
|
10
|
+
right: number;
|
|
11
|
+
};
|
|
12
|
+
scales: {
|
|
13
|
+
x?: (value: number) => number;
|
|
14
|
+
y?: (value: number) => number;
|
|
15
|
+
} | null;
|
|
16
|
+
fontFamily?: string;
|
|
17
|
+
measure?: LabelMeasurer;
|
|
18
|
+
fontVersion?: number;
|
|
19
|
+
renderLabel?: (annotation: Datum, index: number, defaultNode: React.ReactNode) => React.ReactNode;
|
|
20
|
+
}
|
|
21
|
+
/** Generated labels have their own final render pass; author rules/offsets stay intact. */
|
|
22
|
+
export declare function renderDirectLabels(annotations: readonly Datum[], context: DirectLabelLayoutContext): {
|
|
23
|
+
node: React.ReactNode;
|
|
24
|
+
evidence?: LabelLayoutEvidence;
|
|
25
|
+
};
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import type { Datum } from "./datumTypes";
|
|
2
|
+
export interface DirectLabelRequest {
|
|
3
|
+
position: "start" | "end";
|
|
4
|
+
fontSize: number;
|
|
5
|
+
colorBy: string | ((d: Datum) => unknown);
|
|
6
|
+
color: (label: string) => string;
|
|
7
|
+
}
|
|
8
|
+
/** Select semantic endpoints by x, across gaps/forecast segments, before projection. */
|
|
9
|
+
export declare function directLabelAnnotations(rows: readonly Datum[], request: DirectLabelRequest, xAccessor?: string | ((d: Datum) => unknown), yAccessor?: string | ((d: Datum) => unknown)): Datum[];
|
|
10
|
+
export declare function expandDirectLabelRequests(annotations: readonly Datum[], rows?: readonly Datum[], xAccessor?: string, yAccessor?: string): Datum[];
|
|
11
|
+
/** Included in the root SVG description so role=img cannot hide fallback identity. */
|
|
12
|
+
export declare function directLabelDescription(annotations?: readonly Datum[]): string;
|
|
@@ -3,7 +3,10 @@
|
|
|
3
3
|
* Do not edit by hand; run `npm run docs:chart-specs:schema`.
|
|
4
4
|
*
|
|
5
5
|
* This compact registry is intentionally separate from validation metadata:
|
|
6
|
-
* config serialization only
|
|
6
|
+
* config serialization and accessibility auditing only need chart names
|
|
7
|
+
* and the supported text props, not the entire prop-validation catalog.
|
|
7
8
|
*/
|
|
8
9
|
export declare const KNOWN_CHART_COMPONENTS: readonly ["MotifBraidChart", "DependencyForestChart", "FlowCircuitChart", "BarChart", "StackedBarChart", "GroupedBarChart", "SwarmPlot", "BoxPlot", "Histogram", "ViolinPlot", "RidgelinePlot", "DotPlot", "PieChart", "DonutChart", "GaugeChart", "FunnelChart", "RadarChart", "SwimlaneChart", "LikertChart", "LineChart", "BumpChart", "AreaChart", "DifferenceChart", "StackedAreaChart", "Scatterplot", "BubbleChart", "Heatmap", "QuadrantChart", "MultiAxisLineChart", "WaterfallChart", "CandlestickChart", "ConnectedScatterplot", "ScatterplotMatrix", "MinimapChart", "ForceDirectedGraph", "SankeyDiagram", "ProcessSankey", "ChordDiagram", "TreeDiagram", "Treemap", "CirclePack", "OrbitDiagram", "ChoroplethMap", "ProportionalSymbolMap", "FlowMap", "DistanceCartogram", "RealtimeLineChart", "RealtimeHistogram", "TemporalHistogram", "RealtimeSwarmChart", "RealtimeWaterfallChart", "RealtimeHeatmap", "GaltonBoardChart", "EventDropChart", "UnitPileChart", "CollisionSwarmChart", "GauntletChart", "CrucibleChart", "ProcessFlowChart", "PacketFlowChart", "ChainReactionChart", "BigNumber"];
|
|
9
10
|
export declare function isKnownChartComponent(componentName: string): boolean;
|
|
11
|
+
export type AccessibilityTextProp = "title" | "description" | "summary";
|
|
12
|
+
export declare function supportsChartAccessibilityText(componentName: string, prop: AccessibilityTextProp): boolean;
|
|
@@ -1,15 +1,3 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Pure LineChart series-feature prep for the SSR / renderChart path.
|
|
3
|
-
*
|
|
4
|
-
* Mirrors the client HOC orchestration of:
|
|
5
|
-
* - `useSeriesFeatures` (forecast / anomaly via `buildForecast`)
|
|
6
|
-
* - gapStrategy (break / interpolate / zero)
|
|
7
|
-
* - directLabel endpoint annotations
|
|
8
|
-
* - segment-aware lineStyle (createSegmentLineStyle)
|
|
9
|
-
*
|
|
10
|
-
* Client uses lazy dynamic import + React state for these; SSR can call
|
|
11
|
-
* the pure statisticalOverlays entry points synchronously.
|
|
12
|
-
*/
|
|
13
1
|
import type { Datum } from "./datumTypes";
|
|
14
2
|
import { type AnomalyConfig, type ForecastConfig } from "./statisticalOverlays";
|
|
15
3
|
export interface LineSeriesSsrInput {
|
|
@@ -105,6 +105,8 @@ export interface ChartSetupResult {
|
|
|
105
105
|
data: Array<Datum>;
|
|
106
106
|
/** Color scale function, or undefined if no colorBy */
|
|
107
107
|
colorScale: ((v: string) => string) | undefined;
|
|
108
|
+
/** Resolved category colors, including categories discovered in push mode. */
|
|
109
|
+
categoryColorScale: ((v: string) => string) | undefined;
|
|
108
110
|
/** All unique category values from colorBy */
|
|
109
111
|
allCategories: string[];
|
|
110
112
|
/** Legend interaction state (onLegendHover, onLegendClick, highlighted, isolated) */
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import type { Datum } from "../shared/datumTypes";
|
|
2
2
|
import * as React from "react";
|
|
3
|
-
import type { StreamXYFrameProps, MarginalGraphicsConfig } from "../../stream/types";
|
|
3
|
+
import type { StreamXYFrameProps, MarginalGraphicsConfig, DecayConfig, PulseConfig, StalenessConfig } from "../../stream/types";
|
|
4
4
|
import type { RealtimeFrameHandle } from "../../realtime/types";
|
|
5
5
|
import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
|
|
6
6
|
import type { BaseChartProps, AxisConfig, ChartAccessor } from "../shared/types";
|
|
@@ -145,6 +145,9 @@ export interface BubbleChartProps<TDatum extends Datum = Datum> extends BaseChar
|
|
|
145
145
|
* @see https://semiotic.nteract.io/guides/xy-frame
|
|
146
146
|
*/
|
|
147
147
|
frameProps?: Partial<Omit<StreamXYFrameProps, "chartType" | "data" | "size">>;
|
|
148
|
+
pulse?: PulseConfig;
|
|
149
|
+
decay?: DecayConfig;
|
|
150
|
+
staleness?: StalenessConfig;
|
|
148
151
|
}
|
|
149
152
|
/**
|
|
150
153
|
* BubbleChart - Visualize three dimensions of data using x, y, and size
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import type { Datum } from "../shared/datumTypes";
|
|
2
2
|
import * as React from "react";
|
|
3
|
-
import type { StreamXYFrameProps } from "../../stream/types";
|
|
3
|
+
import type { StreamXYFrameProps, DecayConfig, PulseConfig, StalenessConfig } from "../../stream/types";
|
|
4
4
|
import type { RealtimeFrameHandle } from "../../realtime/types";
|
|
5
5
|
import type { BaseChartProps, AxisConfig, ChartAccessor } from "../shared/types";
|
|
6
6
|
import { type TooltipProp } from "../../Tooltip/Tooltip";
|
|
@@ -66,6 +66,9 @@ export interface ConnectedScatterplotProps<TDatum extends Datum = Datum> extends
|
|
|
66
66
|
yExtent?: [number | undefined, number | undefined] | [number];
|
|
67
67
|
/** Additional StreamXYFrame props for advanced customization */
|
|
68
68
|
frameProps?: Partial<Omit<StreamXYFrameProps, "chartType" | "data" | "size">>;
|
|
69
|
+
pulse?: PulseConfig;
|
|
70
|
+
decay?: DecayConfig;
|
|
71
|
+
staleness?: StalenessConfig;
|
|
69
72
|
}
|
|
70
73
|
/**
|
|
71
74
|
* ConnectedScatterplot — points connected in sequence by lines.
|
|
@@ -167,7 +167,10 @@ export interface LineChartProps<TDatum extends Datum = Datum> extends BaseChartP
|
|
|
167
167
|
* Tooltip configuration
|
|
168
168
|
*/
|
|
169
169
|
tooltip?: TooltipProp;
|
|
170
|
-
/**
|
|
170
|
+
/**
|
|
171
|
+
* Stable per-point ID for annotations, push-mode `remove()`/`update()`, and
|
|
172
|
+
* identity-keyed path transitions when `transition` is enabled.
|
|
173
|
+
*/
|
|
171
174
|
pointIdAccessor?: ChartAccessor<TDatum, string>;
|
|
172
175
|
/**
|
|
173
176
|
* Annotation objects to render on the chart
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import type { Datum } from "../shared/datumTypes";
|
|
2
2
|
import * as React from "react";
|
|
3
3
|
import type { StreamXYFrameProps, MarginalGraphicsConfig } from "../../stream/types";
|
|
4
|
+
import type { DecayConfig, PulseConfig, StalenessConfig } from "../../stream/types";
|
|
4
5
|
import type { SymbolName } from "../../stream/symbolPath";
|
|
5
6
|
import type { RealtimeFrameHandle } from "../../realtime/types";
|
|
6
7
|
import type { BaseChartProps, AxisConfig, ChartAccessor } from "../shared/types";
|
|
@@ -115,6 +116,12 @@ export interface ScatterplotProps<TDatum extends Datum = Datum> extends BaseChar
|
|
|
115
116
|
yExtent?: [number | undefined, number | undefined] | [number];
|
|
116
117
|
/** Additional StreamXYFrame props for advanced customization */
|
|
117
118
|
frameProps?: Partial<Omit<StreamXYFrameProps, "chartType" | "data" | "size">>;
|
|
119
|
+
/** Flash newly inserted or updated points. Also reachable via `frameProps.pulse`. */
|
|
120
|
+
pulse?: PulseConfig;
|
|
121
|
+
/** Fade older points by buffer age. Also reachable via `frameProps.decay`. */
|
|
122
|
+
decay?: DecayConfig;
|
|
123
|
+
/** Frame-level liveness badge and dimming. Also reachable via `frameProps.staleness`. */
|
|
124
|
+
staleness?: StalenessConfig;
|
|
118
125
|
}
|
|
119
126
|
/**
|
|
120
127
|
* Scatterplot - Visualize relationships between two continuous variables.
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* HyperLogLog distinct-count sketch. Per-window memory is a fixed
|
|
3
|
+
* register file (default p=10, 1024 registers), so a dashboard can
|
|
4
|
+
* ask "how many distinct customers in this minute?" without retaining ids.
|
|
5
|
+
*/
|
|
6
|
+
export declare class HyperLogLog {
|
|
7
|
+
private readonly p;
|
|
8
|
+
private readonly m;
|
|
9
|
+
private readonly registers;
|
|
10
|
+
private readonly alpha;
|
|
11
|
+
private harmonicSum;
|
|
12
|
+
private zeros;
|
|
13
|
+
constructor(p?: number);
|
|
14
|
+
add(value: string | number): void;
|
|
15
|
+
private updateRegister;
|
|
16
|
+
merge(other: HyperLogLog): void;
|
|
17
|
+
clone(): HyperLogLog;
|
|
18
|
+
count(): number;
|
|
19
|
+
}
|
|
@@ -2,7 +2,7 @@ export type LatePolicy = "drop" | "keep";
|
|
|
2
2
|
export interface ReorderBufferConfig<T> {
|
|
3
3
|
/** Grace window in ms. Events older than `watermark − lateness` are late. */
|
|
4
4
|
lateness: number;
|
|
5
|
-
/** Event-time accessor (ms). */
|
|
5
|
+
/** Event-time accessor (ms), evaluated once when the event is pushed. */
|
|
6
6
|
getTime: (item: T) => number;
|
|
7
7
|
/**
|
|
8
8
|
* What to do with a late event:
|
|
@@ -29,6 +29,7 @@ export declare class ReorderBuffer<T> {
|
|
|
29
29
|
private readonly getTime;
|
|
30
30
|
private readonly latePolicy;
|
|
31
31
|
private held;
|
|
32
|
+
private nextOrder;
|
|
32
33
|
private _watermark;
|
|
33
34
|
private _releasedThrough;
|
|
34
35
|
private _lateCount;
|
|
@@ -45,7 +46,6 @@ export declare class ReorderBuffer<T> {
|
|
|
45
46
|
* stream ends and the remaining grace-window events should be shown.
|
|
46
47
|
*/
|
|
47
48
|
flush(): T[];
|
|
48
|
-
private markReleased;
|
|
49
49
|
clear(): void;
|
|
50
50
|
/** Largest event-time seen, or `-Infinity` if empty. */
|
|
51
51
|
get watermark(): number;
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Compact t-digest (Dunning) for streaming quantiles.
|
|
3
|
+
*
|
|
4
|
+
* Centroids merge under a size bound that is tight in the tails, so p95 /
|
|
5
|
+
* p99 stay accurate without retaining every observation. `push` and
|
|
6
|
+
* `merge` are the only mutating operations a windowed aggregator needs.
|
|
7
|
+
*/
|
|
8
|
+
export declare class TDigest {
|
|
9
|
+
private centroids;
|
|
10
|
+
private total;
|
|
11
|
+
private pending;
|
|
12
|
+
private readonly compression;
|
|
13
|
+
constructor(compression?: number);
|
|
14
|
+
push(value: number): void;
|
|
15
|
+
merge(other: TDigest): void;
|
|
16
|
+
clone(): TDigest;
|
|
17
|
+
/** Quantile in [0, 1], interpolated between centroid centers. Empty returns NaN. */
|
|
18
|
+
quantile(q: number): number;
|
|
19
|
+
get count(): number;
|
|
20
|
+
private compress;
|
|
21
|
+
}
|
|
22
|
+
export declare function percentileKey(q: number): string;
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
/** The Kafka Streams window taxonomy. */
|
|
2
2
|
export type WindowType = "tumbling" | "hopping" | "session";
|
|
3
3
|
/** Which statistic the aggregated series carries as its primary value. */
|
|
4
|
-
export type AggregateStat = "mean" | "sum" | "min" | "max" | "count";
|
|
4
|
+
export type AggregateStat = "mean" | "sum" | "min" | "max" | "count" | "p50" | "p95" | "p99" | "distinct";
|
|
5
5
|
/** Envelope drawn around the aggregated series. */
|
|
6
6
|
export type AggregateBand = "stddev" | "minmax" | "none";
|
|
7
7
|
export interface WindowAccumulatorConfig {
|
|
@@ -32,6 +32,13 @@ export interface WindowAccumulatorConfig {
|
|
|
32
32
|
* unbounded (`Infinity`).
|
|
33
33
|
*/
|
|
34
34
|
retain?: number;
|
|
35
|
+
/**
|
|
36
|
+
* Quantiles to emit per window (e.g. `[0.5, 0.95, 0.99]`). Opt-in so
|
|
37
|
+
* the default path keeps a cheap `RunningStats` only.
|
|
38
|
+
*/
|
|
39
|
+
percentiles?: ReadonlyArray<number>;
|
|
40
|
+
/** Track an approximate distinct count (HyperLogLog) per window. */
|
|
41
|
+
distinct?: boolean;
|
|
35
42
|
}
|
|
36
43
|
/** A closed or still-filling aggregation window. */
|
|
37
44
|
export interface AggregatedWindow {
|
|
@@ -54,6 +61,10 @@ export interface AggregatedWindow {
|
|
|
54
61
|
* half-filled aggregate as final.
|
|
55
62
|
*/
|
|
56
63
|
partial: boolean;
|
|
64
|
+
/** Present when `percentiles` was configured. Keys like `p50`, `p95`. */
|
|
65
|
+
percentiles?: Readonly<Record<string, number>>;
|
|
66
|
+
/** Present when `distinct` was configured. */
|
|
67
|
+
distinct?: number;
|
|
57
68
|
}
|
|
58
69
|
/**
|
|
59
70
|
* Accumulates event-time windowed statistics. Stateful and mutable —
|
|
@@ -65,12 +76,20 @@ export declare class WindowAccumulator {
|
|
|
65
76
|
private readonly hop;
|
|
66
77
|
private readonly gap;
|
|
67
78
|
private readonly retain;
|
|
79
|
+
private readonly percentiles;
|
|
80
|
+
private readonly wantDistinct;
|
|
68
81
|
private windows;
|
|
82
|
+
private starts;
|
|
69
83
|
private sessions;
|
|
70
84
|
private latest;
|
|
71
85
|
constructor(config: WindowAccumulatorConfig);
|
|
72
|
-
|
|
73
|
-
|
|
86
|
+
private newBucket;
|
|
87
|
+
/**
|
|
88
|
+
* Incorporate one event. Non-finite time/value are ignored.
|
|
89
|
+
* `distinctKey` is hashed into the optional HyperLogLog so a latency
|
|
90
|
+
* series can still count distinct customers.
|
|
91
|
+
*/
|
|
92
|
+
push(time: number, value: number, distinctKey?: string | number): void;
|
|
74
93
|
private pushFixed;
|
|
75
94
|
private bump;
|
|
76
95
|
private pushSession;
|
|
@@ -82,8 +101,6 @@ export declare class WindowAccumulator {
|
|
|
82
101
|
* is `partial` while within `gap` of the watermark.
|
|
83
102
|
*/
|
|
84
103
|
emit(): AggregatedWindow[];
|
|
85
|
-
private emitFixed;
|
|
86
|
-
private emitSessions;
|
|
87
104
|
private row;
|
|
88
105
|
/** Number of live windows (or sessions). */
|
|
89
106
|
get windowCount(): number;
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
import type { Datum } from "../charts/shared/datumTypes";
|
|
2
|
+
import type { RealtimeFrameHandle } from "./types";
|
|
3
|
+
export type ChangelogOp<T extends Datum = Datum> = {
|
|
4
|
+
op: "insert" | "upsert";
|
|
5
|
+
row: T;
|
|
6
|
+
id?: string;
|
|
7
|
+
} | {
|
|
8
|
+
op: "update";
|
|
9
|
+
row: T;
|
|
10
|
+
id?: string;
|
|
11
|
+
} | {
|
|
12
|
+
op: "delete" | "retract";
|
|
13
|
+
id?: string;
|
|
14
|
+
row?: T;
|
|
15
|
+
};
|
|
16
|
+
export interface ApplyChangelogOptions<T extends Datum = Datum> {
|
|
17
|
+
/** Identity field or accessor. Must match the chart's `pointIdAccessor`. */
|
|
18
|
+
key: string | ((row: T) => string);
|
|
19
|
+
/** Collapse the batch to the last op per key. Default true. */
|
|
20
|
+
coalesce?: boolean;
|
|
21
|
+
}
|
|
22
|
+
export interface ApplyChangelogResult {
|
|
23
|
+
applied: number;
|
|
24
|
+
upserts: number;
|
|
25
|
+
retracts: number;
|
|
26
|
+
}
|
|
27
|
+
/**
|
|
28
|
+
* Map a Flink / Debezium / Kafka Streams changelog onto a realtime handle.
|
|
29
|
+
*
|
|
30
|
+
* Semantics:
|
|
31
|
+
* • `insert` / `upsert` / `update` — `update` when the id is already in
|
|
32
|
+
* the buffer, otherwise `push`.
|
|
33
|
+
* • `delete` / `retract` — `remove(id)`.
|
|
34
|
+
* • Batches coalesce by key (last op wins) unless `coalesce: false`.
|
|
35
|
+
*
|
|
36
|
+
* The chart must set `pointIdAccessor` to the same identity as `key`.
|
|
37
|
+
*/
|
|
38
|
+
export declare function applyChangelog<T extends Datum = Datum>(handle: Pick<RealtimeFrameHandle<T>, "push" | "pushMany" | "update" | "remove" | "getData">, events: ReadonlyArray<ChangelogOp<T>>, options: ApplyChangelogOptions<T>): ApplyChangelogResult;
|
|
@@ -0,0 +1,3 @@
|
|
|
1
|
+
/** Array-backed heap operations shared by event ordering and window eviction. */
|
|
2
|
+
export declare function heapPush<T>(items: T[], item: T, compare: (a: T, b: T) => number): void;
|
|
3
|
+
export declare function heapPop<T>(items: T[], compare: (a: T, b: T) => number): T | undefined;
|
|
@@ -62,7 +62,7 @@ export declare function flowCircuitChartProps({ width, height, title, descriptio
|
|
|
62
62
|
seriesField?: string;
|
|
63
63
|
} | undefined;
|
|
64
64
|
annotations: import("../../stream/networkColorAccessors").Datum[] | undefined;
|
|
65
|
-
frameProps: Partial<Omit<import("../../semiotic-experimental").UnstableStreamPhysicsFrameProps, "size" | "
|
|
65
|
+
frameProps: Partial<Omit<import("../../semiotic-experimental").UnstableStreamPhysicsFrameProps, "size" | "config" | "initialSpawns" | "initialSpawnPacing">> | undefined;
|
|
66
66
|
paused: boolean;
|
|
67
67
|
title: string;
|
|
68
68
|
description: string;
|
|
@@ -4,26 +4,8 @@
|
|
|
4
4
|
* callers provide relations, silhouettes, and cost functions while the kit
|
|
5
5
|
* owns the guarded search and separation invariants.
|
|
6
6
|
*/
|
|
7
|
-
export
|
|
8
|
-
|
|
9
|
-
desired: readonly number[];
|
|
10
|
-
/** Minimum distance between item i and i + 1. */
|
|
11
|
-
minGaps: readonly number[];
|
|
12
|
-
/** Optional least-squares weight per desired coordinate. */
|
|
13
|
-
weights?: readonly number[];
|
|
14
|
-
/** Optional lower bound for the first coordinate. */
|
|
15
|
-
min?: number;
|
|
16
|
-
/** Optional upper bound for the last coordinate. */
|
|
17
|
-
max?: number;
|
|
18
|
-
}
|
|
19
|
-
/**
|
|
20
|
-
* Least-squares placement with fixed order and per-pair minimum gaps.
|
|
21
|
-
*
|
|
22
|
-
* The gap constraints are removed with cumulative offsets, then weighted
|
|
23
|
-
* isotonic regression (pool-adjacent-violators) solves the remaining
|
|
24
|
-
* non-decreasing placement. Bounds apply to the whole ordered sequence.
|
|
25
|
-
*/
|
|
26
|
-
export declare function placeWithMinGap(options: MinGapPlacementOptions): number[];
|
|
7
|
+
export { placeWithMinGap } from "./minGapPlacement";
|
|
8
|
+
export type { MinGapPlacementOptions } from "./minGapPlacement";
|
|
27
9
|
export interface SilhouetteSample {
|
|
28
10
|
/** Position along the independent axis (time, layer, or another index). */
|
|
29
11
|
at: number;
|