semiotic 3.10.1 → 3.10.3
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 +64 -63
- package/ai/artifact-surface-inventory.json +4 -1
- package/ai/behaviorContracts.cjs +1 -1
- package/ai/dist/mcp-server.js +25 -24
- package/ai/examples.md +28 -0
- package/ai/reference.md +9 -4
- package/ai/schema.json +121 -5
- package/ai/surface-manifest.json +3 -2
- package/ai/system-prompt.md +1 -1
- 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-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-43XNOQNQ.min.js +391 -0
- package/dist/c-4JKDJUYD.min.js +1 -0
- package/dist/c-4LKK5YWB.min.js +1 -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-5PIKBUMF.min.js +1 -0
- package/dist/c-6IVBV5NO.min.js +1 -0
- package/dist/c-7APWCEPL.min.js +1 -0
- package/dist/{c-ORLEBW72.min.js → c-7FKPPCGN.min.js} +1 -1
- package/dist/c-ABMGCCLT.min.js +1 -0
- package/dist/c-AINGQGUN.min.js +1 -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-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-CO4NDAD6.min.js +51 -0
- package/dist/c-ECHBKW7U.min.js +1 -0
- package/dist/c-EPJWM2UT.min.js +1 -0
- package/dist/c-FD2BXSRG.min.js +1 -0
- package/dist/c-FHNY57SO.min.js +209 -0
- package/dist/c-FMCUQ6JX.min.js +1 -0
- package/dist/c-FOTTQHOO.min.js +1 -0
- package/dist/c-FU7A5KSY.min.js +1 -0
- package/dist/c-GHN6IR4Y.min.js +1 -0
- package/dist/{c-J6DVC236.min.js → c-GK263BF4.min.js} +1 -1
- 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-HNHKIMIV.min.js +61 -0
- package/dist/{c-D6HAAPTX.min.js → c-IBRLFKWA.min.js} +1 -1
- package/dist/c-IIV73MUW.min.js +1 -0
- package/dist/c-IJCZGUG6.min.js +31 -0
- package/dist/c-ISA6IJ6V.min.js +41 -0
- package/dist/c-JC76YAHB.min.js +33 -0
- package/dist/c-JJKRER47.min.js +1 -0
- package/dist/c-JO6AYCU4.min.js +1 -0
- package/dist/c-JOPGDP6N.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-KXH7LFIL.min.js +26 -0
- package/dist/c-M43PK7K4.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-PITYSOPK.min.js +1 -0
- package/dist/c-QPO24R7Q.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-SAP5KY6R.min.js +9 -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-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-UMGHCBH5.min.js +114 -0
- 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-VEMCBQZZ.min.js +100 -0
- package/dist/{c-P65V6HLO.min.js → c-VN557BQE.min.js} +1 -1
- package/dist/c-WD2RL76M.min.js +116 -0
- package/dist/c-Y342FJ6K.min.js +1 -0
- package/dist/c-YL7HJL5J.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/c-Z6GRGS53.min.js +1 -0
- package/dist/c-ZVOFLE2P.min.js +46 -0
- package/dist/components/CategoryColors.d.ts +7 -0
- package/dist/components/LinkedCharts.d.ts +2 -1
- 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 +3 -1
- package/dist/components/charts/shared/useNetworkChartSetup.d.ts +1 -1
- 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/data/transforms.d.ts +1 -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/physicsWorker.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 +1530 -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 +8 -7
- 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
|
@@ -1,8 +1,30 @@
|
|
|
1
1
|
import type { StreamChartCapability, StreamSchema, StreamSuggestion } from "./streamingTypes";
|
|
2
|
-
import {
|
|
2
|
+
import type { ChartFamily } from "./chartCapabilityTypes";
|
|
3
|
+
import type { IntentId } from "./intents";
|
|
4
|
+
import { type AudienceProfile } from "./audienceProfile";
|
|
3
5
|
export declare function registerStreamChartCapability(capability: StreamChartCapability): void;
|
|
4
6
|
export declare function unregisterStreamChartCapability(component: string): void;
|
|
5
7
|
export declare function getStreamCapabilities(): ReadonlyArray<StreamChartCapability>;
|
|
8
|
+
export interface RejectedStreamCapability {
|
|
9
|
+
component: string;
|
|
10
|
+
family: ChartFamily;
|
|
11
|
+
importPath: string;
|
|
12
|
+
/** Human-readable reason this chart can't render this schema. */
|
|
13
|
+
reason: string;
|
|
14
|
+
}
|
|
15
|
+
export interface StreamStretchSuggestion {
|
|
16
|
+
suggestion: StreamSuggestion;
|
|
17
|
+
replacing?: string;
|
|
18
|
+
rationale: string;
|
|
19
|
+
familiarity: number;
|
|
20
|
+
/** Set by `suggestStreamDashboard` to bind the stretch to a schema. */
|
|
21
|
+
schemaIndex?: number;
|
|
22
|
+
}
|
|
23
|
+
export interface SuggestStreamChartsResult {
|
|
24
|
+
suggestions: StreamSuggestion[];
|
|
25
|
+
excluded: ReadonlyArray<RejectedStreamCapability>;
|
|
26
|
+
stretchSuggestions: StreamStretchSuggestion[];
|
|
27
|
+
}
|
|
6
28
|
export interface SuggestStreamChartsOptions {
|
|
7
29
|
intent?: IntentId | IntentId[];
|
|
8
30
|
allow?: ReadonlyArray<string>;
|
|
@@ -10,17 +32,25 @@ export interface SuggestStreamChartsOptions {
|
|
|
10
32
|
maxResults?: number;
|
|
11
33
|
minScore?: number;
|
|
12
34
|
capabilities?: ReadonlyArray<StreamChartCapability>;
|
|
35
|
+
audience?: AudienceProfile;
|
|
36
|
+
maxStretchResults?: number;
|
|
13
37
|
}
|
|
14
38
|
/**
|
|
15
|
-
* Suggest
|
|
39
|
+
* Suggest charts for a stream schema, ranked by intent.
|
|
16
40
|
*
|
|
17
41
|
* Parallel to `suggestCharts` but operates on a `StreamSchema` (fields +
|
|
18
|
-
* throughput/retention hints) rather than row data. Use for live
|
|
19
|
-
* monitoring views, anywhere events arrive over time rather
|
|
20
|
-
* table.
|
|
42
|
+
* throughput/retention/shape hints) rather than row data. Use for live
|
|
43
|
+
* dashboards, monitoring views, anywhere events arrive over time rather
|
|
44
|
+
* than as a bounded table.
|
|
45
|
+
*
|
|
46
|
+
* Returns `{ suggestions, excluded, stretchSuggestions }`. `excluded`
|
|
47
|
+
* lists every registered capability whose `fits()` rejected the schema
|
|
48
|
+
* so a suggestion panel can say why a chart is missing. Pass `audience`
|
|
49
|
+
* to apply familiarity/target bias and (when `exposureLevel !== 0`) fill
|
|
50
|
+
* `stretchSuggestions`.
|
|
21
51
|
*
|
|
22
52
|
* @example
|
|
23
|
-
* const suggestions = suggestStreamCharts({
|
|
53
|
+
* const { suggestions } = suggestStreamCharts({
|
|
24
54
|
* fields: [
|
|
25
55
|
* { name: "ts", kind: "date" },
|
|
26
56
|
* { name: "latency_ms", kind: "numeric" },
|
|
@@ -29,6 +59,11 @@ export interface SuggestStreamChartsOptions {
|
|
|
29
59
|
* throughput: "high",
|
|
30
60
|
* retention: "windowed",
|
|
31
61
|
* }, { intent: "trend" })
|
|
32
|
-
* // → [
|
|
62
|
+
* // → suggestions[0] is RealtimeHeatmap or RealtimeWaterfallChart
|
|
63
|
+
*/
|
|
64
|
+
export declare function suggestStreamCharts(schema: StreamSchema, options?: SuggestStreamChartsOptions): SuggestStreamChartsResult;
|
|
65
|
+
/**
|
|
66
|
+
* Like `suggestStreamCharts`, but named for diagnostic panels that care
|
|
67
|
+
* about the excluded list. Same result object.
|
|
33
68
|
*/
|
|
34
|
-
export declare function
|
|
69
|
+
export declare function explainStreamCapabilityFit(schema: StreamSchema, options?: SuggestStreamChartsOptions): SuggestStreamChartsResult;
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
import { type StreamStretchSuggestion } from "./suggestStreamCharts";
|
|
2
|
+
import type { StreamSchema, StreamSuggestion } from "./streamingTypes";
|
|
3
|
+
import type { IntentId } from "./intents";
|
|
4
|
+
import type { AudienceProfile } from "./audienceProfile";
|
|
5
|
+
export interface StreamDashboardPanel {
|
|
6
|
+
intent: IntentId;
|
|
7
|
+
suggestion: StreamSuggestion;
|
|
8
|
+
/** Index into `schemas` for the stream this panel's props bind to. */
|
|
9
|
+
schemaIndex: number;
|
|
10
|
+
}
|
|
11
|
+
export interface StreamDashboardSuggestion {
|
|
12
|
+
panels: StreamDashboardPanel[];
|
|
13
|
+
intentsCovered: IntentId[];
|
|
14
|
+
intentsMissing: IntentId[];
|
|
15
|
+
stretchPanels: StreamStretchSuggestion[];
|
|
16
|
+
schemas: ReadonlyArray<StreamSchema>;
|
|
17
|
+
}
|
|
18
|
+
export interface SuggestStreamDashboardOptions {
|
|
19
|
+
intent?: IntentId | IntentId[];
|
|
20
|
+
intents?: ReadonlyArray<IntentId>;
|
|
21
|
+
audience?: AudienceProfile;
|
|
22
|
+
budget?: number;
|
|
23
|
+
allow?: ReadonlyArray<string>;
|
|
24
|
+
deny?: ReadonlyArray<string>;
|
|
25
|
+
diversifyByFamily?: boolean;
|
|
26
|
+
maxStretchPanels?: number;
|
|
27
|
+
}
|
|
28
|
+
/**
|
|
29
|
+
* Compose a multi-panel dashboard from one or more stream schemas.
|
|
30
|
+
*
|
|
31
|
+
* Parallel to `suggestDashboard`, but schema-based. Audience layout
|
|
32
|
+
* policy (`dashboard.cellBudget`, `leadFamilies`, `windowPreference`)
|
|
33
|
+
* is first-class: pass it on `AudienceProfile.dashboard`.
|
|
34
|
+
*/
|
|
35
|
+
export declare function suggestStreamDashboard(schemas: StreamSchema | ReadonlyArray<StreamSchema>, options?: SuggestStreamDashboardOptions): StreamDashboardSuggestion;
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import type { ChartCapability, ChartDataProfile, ChartRubric, ChartVariant } from "./chartCapabilityTypes";
|
|
2
|
-
import {
|
|
2
|
+
import type { IntentId } from "./intents";
|
|
3
3
|
import { type AudienceProfile } from "./audienceProfile";
|
|
4
4
|
/**
|
|
5
5
|
* Where a proposal came from. Used by scoring + ranking to weight
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import type { Datum } from "../shared/datumTypes";
|
|
2
|
+
import type { ChartAccessor } from "../shared/types";
|
|
3
|
+
import { type AggregateConfig, type AggregatedRealtimeDatum } from "./aggregate";
|
|
4
|
+
export declare const AGG_SERIES = "__aggSeries";
|
|
5
|
+
/** One independent aggregation history per authored series, shared by React and SSR. */
|
|
6
|
+
export declare class RealtimeAccumulator {
|
|
7
|
+
private readonly config;
|
|
8
|
+
private readonly seriesAccessor?;
|
|
9
|
+
private readonly groups;
|
|
10
|
+
constructor(config: AggregateConfig, seriesAccessor?: ChartAccessor<Datum, string> | undefined);
|
|
11
|
+
push(row: Datum, timeAccessor?: ChartAccessor<Datum, number>, valueAccessor?: ChartAccessor<Datum, number>): void;
|
|
12
|
+
emit(config: AggregateConfig): AggregatedRealtimeDatum[];
|
|
13
|
+
clear(): void;
|
|
14
|
+
}
|
|
@@ -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";
|
|
@@ -45,6 +45,10 @@ export interface RealtimeHeatmapProps<TDatum extends Datum = Datum> extends Real
|
|
|
45
45
|
windowMode?: WindowMode;
|
|
46
46
|
/** Ring buffer capacity */
|
|
47
47
|
windowSize?: number;
|
|
48
|
+
/** Alias for `windowSize` — ring-buffer capacity, not the aggregation window. */
|
|
49
|
+
capacity?: number;
|
|
50
|
+
/** Alias for `windowMode`. */
|
|
51
|
+
capacityMode?: WindowMode;
|
|
48
52
|
/** Controlled data array */
|
|
49
53
|
data?: RealtimeData<TDatum>;
|
|
50
54
|
/** Time/x value accessor */
|
|
@@ -105,10 +109,7 @@ export interface RealtimeHeatmapProps<TDatum extends Datum = Datum> extends Real
|
|
|
105
109
|
/** Declarative tooltip config or the legacy full-HoverData callback. */
|
|
106
110
|
tooltip?: RealtimeTooltipProp;
|
|
107
111
|
/** Enable linked hover selection events for cross-chart highlighting */
|
|
108
|
-
linkedHover?:
|
|
109
|
-
name?: string;
|
|
110
|
-
fields: string[];
|
|
111
|
-
};
|
|
112
|
+
linkedHover?: LinkedHoverProp;
|
|
112
113
|
/** Consume a named selection — dims unselected elements */
|
|
113
114
|
selection?: SelectionConfig;
|
|
114
115
|
/** Show a loading skeleton placeholder */
|
|
@@ -48,6 +48,10 @@ export interface RealtimeHistogramProps<TDatum extends Datum = Datum> extends Re
|
|
|
48
48
|
arrowOfTime?: ArrowOfTime;
|
|
49
49
|
/** Data retention strategy */
|
|
50
50
|
windowMode?: WindowMode;
|
|
51
|
+
/** Alias for `windowSize` — ring-buffer capacity, not the aggregation window. */
|
|
52
|
+
capacity?: number;
|
|
53
|
+
/** Alias for `windowMode`. */
|
|
54
|
+
capacityMode?: WindowMode;
|
|
51
55
|
/** Ring buffer capacity */
|
|
52
56
|
windowSize?: number;
|
|
53
57
|
/** Controlled data array */
|
|
@@ -216,7 +220,7 @@ export declare const RealtimeHistogram: {
|
|
|
216
220
|
<TDatum extends Datum = Datum>(props: RealtimeHistogramProps<TDatum> & React.RefAttributes<RealtimeFrameHandle<TDatum>>): React.ReactElement | null;
|
|
217
221
|
displayName?: string;
|
|
218
222
|
};
|
|
219
|
-
export interface TemporalHistogramProps<TDatum extends Datum = Datum> extends Omit<RealtimeHistogramProps<TDatum>, "data" | "
|
|
223
|
+
export interface TemporalHistogramProps<TDatum extends Datum = Datum> extends Omit<RealtimeHistogramProps<TDatum>, "data" | "windowMode" | "windowSize"> {
|
|
220
224
|
/** Static data array for a bounded temporal histogram. */
|
|
221
225
|
data: TDatum[];
|
|
222
226
|
}
|
|
@@ -1,168 +1,9 @@
|
|
|
1
1
|
import * as React from "react";
|
|
2
|
-
import type { ArrowOfTime, WindowMode, HoverAnnotationConfig, HoverData, AnnotationContext, DecayConfig, PulseConfig, StalenessConfig, TransitionConfig } from "../../stream/types";
|
|
3
2
|
import type { RealtimeFrameHandle } from "../../realtime/types";
|
|
4
|
-
import type { CSSProperties, ReactNode } from "react";
|
|
5
|
-
import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
|
|
6
|
-
import type { ChartMode, ChartAccessor, SelectionConfig, MobileInteractionProp } from "../shared/types";
|
|
7
|
-
import type { OnObservationCallback } from "../../store/ObservationStore";
|
|
8
3
|
import type { Datum } from "../shared/datumTypes";
|
|
9
|
-
import type { AutoPlaceAnnotations } from "../../recipes/annotationLayout";
|
|
10
|
-
import type { MobileVisualizationContract } from "../shared/auditMobileVisualization";
|
|
11
|
-
import type { ResponsiveRule } from "../shared/responsiveRules";
|
|
12
4
|
import { type AggregateConfig, type AggregatedRealtimeDatum } from "./aggregate";
|
|
13
|
-
import { type
|
|
14
|
-
|
|
15
|
-
import type { PartialMargin } from "../../types/marginType";
|
|
16
|
-
import { type StyleRule } from "../shared/styleRules";
|
|
17
|
-
/**
|
|
18
|
-
* Imperative handle for RealtimeLineChart. It extends the shared realtime
|
|
19
|
-
* handle without changing that cross-chart contract: only this chart exposes
|
|
20
|
-
* event-time tail flushing.
|
|
21
|
-
*/
|
|
22
|
-
export interface RealtimeLineChartHandle<TDatum extends Datum = Datum, TReadDatum extends Datum = TDatum> extends RealtimeFrameHandle<TDatum, TReadDatum> {
|
|
23
|
-
/**
|
|
24
|
-
* Release every event still held by `eventTime`, in event-time order.
|
|
25
|
-
* Call this when an input source reaches an asserted end-of-stream or batch
|
|
26
|
-
* boundary. Later newer events remain supported; events older than the
|
|
27
|
-
* flushed frontier follow `latePolicy`.
|
|
28
|
-
*/
|
|
29
|
-
flush(): void;
|
|
30
|
-
}
|
|
31
|
-
export interface RealtimeLineChartProps<TDatum extends Datum = Datum> extends RealtimeAccessibilityProps {
|
|
32
|
-
/** Fit the container width. */
|
|
33
|
-
responsiveWidth?: boolean;
|
|
34
|
-
/** Fit a container with a definite height. */
|
|
35
|
-
responsiveHeight?: boolean;
|
|
36
|
-
/** Display mode: "primary" (full chrome), "context" (compact), "sparkline" (inline) */
|
|
37
|
-
mode?: ChartMode;
|
|
38
|
-
/** Semantic responsive transformations applied before chart-mode defaults. */
|
|
39
|
-
responsiveRules?: ResponsiveRule[];
|
|
40
|
-
/** Phone/mobile contract consumed by audits, recipes, adapters, and agents. */
|
|
41
|
-
mobileSemantics?: MobileVisualizationContract;
|
|
42
|
-
/** Touch-first interaction policy for phone-sized chart slots. */
|
|
43
|
-
mobileInteraction?: MobileInteractionProp;
|
|
44
|
-
/** Chart dimensions as [width, height] */
|
|
45
|
-
size?: [number, number];
|
|
46
|
-
/** Chart width (alternative to size) */
|
|
47
|
-
width?: number;
|
|
48
|
-
/** Chart height (alternative to size) */
|
|
49
|
-
height?: number;
|
|
50
|
-
/** Maximum canvas backing-store DPR; large canvases also use the shared backing-store budget. */
|
|
51
|
-
maxDevicePixelRatio?: number;
|
|
52
|
-
/** Chart margins */
|
|
53
|
-
margin?: PartialMargin;
|
|
54
|
-
/** CSS class name */
|
|
55
|
-
className?: string;
|
|
56
|
-
onObservation?: OnObservationCallback;
|
|
57
|
-
chartId?: string;
|
|
58
|
-
/** Direction time flows */
|
|
59
|
-
arrowOfTime?: ArrowOfTime;
|
|
60
|
-
/** Data retention strategy */
|
|
61
|
-
windowMode?: WindowMode;
|
|
62
|
-
/** Ring buffer capacity */
|
|
63
|
-
windowSize?: number;
|
|
64
|
-
/** Controlled data array */
|
|
65
|
-
data?: RealtimeData<TDatum>;
|
|
66
|
-
/** Time value accessor */
|
|
67
|
-
timeAccessor?: ChartAccessor<TDatum, number>;
|
|
68
|
-
/** Value accessor */
|
|
69
|
-
valueAccessor?: ChartAccessor<TDatum, number>;
|
|
70
|
-
/** Fixed time domain */
|
|
71
|
-
timeExtent?: [number, number];
|
|
72
|
-
/** Fixed value domain */
|
|
73
|
-
valueExtent?: [number, number];
|
|
74
|
-
/** Extent padding factor */
|
|
75
|
-
extentPadding?: number;
|
|
76
|
-
/** Line color */
|
|
77
|
-
stroke?: string;
|
|
78
|
-
/** Line width */
|
|
79
|
-
strokeWidth?: number;
|
|
80
|
-
/** Dash pattern (e.g. "4,2") */
|
|
81
|
-
strokeDasharray?: string;
|
|
82
|
-
/** Uniform line opacity (0–1). Pairs with `stroke` / `strokeWidth` for the designer-facing primitive vocabulary. */
|
|
83
|
-
opacity?: number;
|
|
84
|
-
/** Presentation-only CSS cursor for retained marks; does not add click, keyboard, or observation behavior. */
|
|
85
|
-
cursor?: CSSProperties["cursor"];
|
|
86
|
-
/** Ordered data-aware line styling, resolved against the displayed series sample. */
|
|
87
|
-
styleRules?: StyleRule[];
|
|
88
|
-
/** Show canvas-drawn axes */
|
|
89
|
-
showAxes?: boolean;
|
|
90
|
-
/** Background fill color */
|
|
91
|
-
background?: string;
|
|
92
|
-
/** Enable hover interaction */
|
|
93
|
-
enableHover?: boolean | HoverAnnotationConfig;
|
|
94
|
-
/** Custom tooltip renderer */
|
|
95
|
-
tooltipContent?: (d: HoverData) => ReactNode;
|
|
96
|
-
/** Callback on hover */
|
|
97
|
-
onHover?: (d: HoverData | null) => void;
|
|
98
|
-
/** Annotation objects */
|
|
99
|
-
annotations?: Datum[];
|
|
100
|
-
/** Opt into automatic placement for note-like annotations without manual offsets. */
|
|
101
|
-
autoPlaceAnnotations?: AutoPlaceAnnotations;
|
|
102
|
-
/** SVG annotation render function */
|
|
103
|
-
svgAnnotationRules?: (annotation: Datum, index: number, context: AnnotationContext) => ReactNode;
|
|
104
|
-
/** Custom formatter for time axis ticks */
|
|
105
|
-
tickFormatTime?: (value: number) => string;
|
|
106
|
-
/** Custom formatter for value axis ticks */
|
|
107
|
-
tickFormatValue?: (value: number) => string;
|
|
108
|
-
/** Declarative tooltip config or the legacy full-HoverData callback. Pass `"multi"` for hover-anywhere line values. */
|
|
109
|
-
tooltip?: RealtimeTooltipProp;
|
|
110
|
-
/** Configurable opacity decay for older data */
|
|
111
|
-
decay?: DecayConfig;
|
|
112
|
-
/** Flash effect on newly inserted data */
|
|
113
|
-
pulse?: PulseConfig;
|
|
114
|
-
/** Frame-level data liveness indicator */
|
|
115
|
-
staleness?: StalenessConfig;
|
|
116
|
-
/** Smooth position interpolation on data change */
|
|
117
|
-
transition?: TransitionConfig;
|
|
118
|
-
/** Enable linked hover selection events for cross-chart highlighting */
|
|
119
|
-
linkedHover?: boolean | string | {
|
|
120
|
-
name?: string;
|
|
121
|
-
fields: string[];
|
|
122
|
-
};
|
|
123
|
-
/** Consume a named selection — dims unselected elements */
|
|
124
|
-
selection?: SelectionConfig;
|
|
125
|
-
/** Show a loading skeleton placeholder */
|
|
126
|
-
loading?: boolean;
|
|
127
|
-
/** Custom content rendered in place of the default skeleton while `loading` is true. */
|
|
128
|
-
loadingContent?: React.ReactNode | false;
|
|
129
|
-
/** Custom content to render when data is empty. Set to `false` to disable empty state. */
|
|
130
|
-
emptyContent?: ReactNode | false;
|
|
131
|
-
/** Visual emphasis level for dashboard hierarchy. "primary" spans two columns in ChartGrid. */
|
|
132
|
-
emphasis?: "primary" | "secondary";
|
|
133
|
-
/** Show a legend */
|
|
134
|
-
showLegend?: boolean;
|
|
135
|
-
/** Legend position */
|
|
136
|
-
legendPosition?: LegendPosition;
|
|
137
|
-
/** Legend interaction mode */
|
|
138
|
-
legendInteraction?: LegendInteractionMode;
|
|
139
|
-
/** ID accessor for remove()/update() on the push API */
|
|
140
|
-
pointIdAccessor?: RealtimePointIdAccessor<TDatum>;
|
|
141
|
-
/**
|
|
142
|
-
* Opt-in windowed aggregation over event-time. When set, pushed
|
|
143
|
-
* events are reduced into tumbling/hopping/session windows and the
|
|
144
|
-
* chart draws one mark per window (mean/sum/min/max/count) plus an
|
|
145
|
-
* optional ±σ or min–max band — render cost scales with the number of
|
|
146
|
-
* visible windows, not the arrival rate. This is the **aggregation
|
|
147
|
-
* window**, distinct from `windowMode`'s RingBuffer eviction. Changing a
|
|
148
|
-
* structural window field or either accessor rebuilds the accumulator:
|
|
149
|
-
* controlled `data` is reseeded, while push-only input begins a new epoch
|
|
150
|
-
* because raw events are deliberately not retained.
|
|
151
|
-
*/
|
|
152
|
-
aggregate?: AggregateConfig;
|
|
153
|
-
/**
|
|
154
|
-
* Opt-in event-time ingestion. Buffers pushed events for a bounded
|
|
155
|
-
* lateness/grace window and releases them to the chart in event-time
|
|
156
|
-
* order, so out-of-order or merged multi-source streams render
|
|
157
|
-
* monotonically instead of zigzagging. Late events (older than
|
|
158
|
-
* `watermark − lateness`) are dropped or kept per policy and surfaced
|
|
159
|
-
* via `onObservation` as `"late-data"`. Default-off; when unset the
|
|
160
|
-
* push path is byte-for-byte unchanged. Call `ref.current.flush()` at an
|
|
161
|
-
* asserted end-of-stream boundary so the final grace-window events are
|
|
162
|
-
* released in order.
|
|
163
|
-
*/
|
|
164
|
-
eventTime?: EventTimeConfig;
|
|
165
|
-
}
|
|
5
|
+
import { type RealtimeLineChartHandle, type RealtimeLineChartProps } from "./RealtimeLineChart.types";
|
|
6
|
+
export type { RealtimeLineChartHandle, RealtimeLineChartProps };
|
|
166
7
|
/**
|
|
167
8
|
* RealtimeLineChart - Simplified wrapper for streaming line charts.
|
|
168
9
|
*
|
|
@@ -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;
|