semiotic 3.10.0 → 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 +73 -72
- package/ai/artifact-surface-inventory.json +4 -1
- package/ai/componentMetadata.cjs +3 -1
- package/ai/dist/mcp-server.js +47 -46
- package/ai/examples.md +95 -0
- package/ai/reference.md +80 -1
- package/ai/schema.json +7304 -1990
- package/ai/surface-manifest.json +26 -4
- 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-JO2UGTCP.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/chartDataProps.d.ts +3 -0
- package/dist/components/charts/shared/chartSpecAtlasSchemas.d.ts +5 -0
- package/dist/components/charts/shared/chartSpecCore.d.ts +4 -0
- package/dist/components/charts/shared/chartSpecsAtlas.d.ts +2 -0
- package/dist/components/charts/shared/directLabels.d.ts +12 -0
- package/dist/components/charts/shared/hooks.d.ts +3 -1
- package/dist/components/charts/shared/knownChartComponents.d.ts +5 -2
- 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/DependencyForestChart.d.ts +20 -0
- package/dist/components/recipes/atlas/DependencyMatrix.d.ts +7 -0
- package/dist/components/recipes/atlas/FlowCircuitChart.d.ts +20 -0
- package/dist/components/recipes/atlas/MotifBraidChart.d.ts +17 -0
- package/dist/components/recipes/atlas/atlasChartOptions.d.ts +11 -0
- package/dist/components/recipes/atlas/braid.d.ts +62 -0
- package/dist/components/recipes/atlas/capsules.d.ts +18 -0
- package/dist/components/recipes/atlas/compare.d.ts +4 -0
- package/dist/components/recipes/atlas/completeness.d.ts +2 -0
- package/dist/components/recipes/atlas/dependencyForest.d.ts +32 -0
- package/dist/components/recipes/atlas/dependencyForestChartProps.d.ts +58 -0
- package/dist/components/recipes/atlas/dependencyForestLayout.d.ts +17 -0
- package/dist/components/recipes/atlas/dependencyQueries.d.ts +20 -0
- package/dist/components/recipes/atlas/dependencyTypes.d.ts +21 -0
- package/dist/components/recipes/atlas/directedGraph.d.ts +9 -0
- package/dist/components/recipes/atlas/entityCounts.d.ts +3 -0
- package/dist/components/recipes/atlas/flowCircuit.d.ts +32 -0
- package/dist/components/recipes/atlas/flowCircuitChartProps.d.ts +72 -0
- package/dist/components/recipes/atlas/flowCircuitChrome.d.ts +18 -0
- package/dist/components/recipes/atlas/flowCircuitGeometry.d.ts +11 -0
- package/dist/components/recipes/atlas/flowCircuitLayout.d.ts +20 -0
- package/dist/components/recipes/atlas/flowCircuitSemantics.d.ts +26 -0
- package/dist/components/recipes/atlas/flowCircuitTape.d.ts +22 -0
- package/dist/components/recipes/atlas/flowCircuitTypes.d.ts +144 -0
- package/dist/components/recipes/atlas/forests.d.ts +11 -0
- package/dist/components/recipes/atlas/ids.d.ts +6 -0
- package/dist/components/recipes/atlas/index.d.ts +26 -0
- package/dist/components/recipes/atlas/ledger.d.ts +7 -0
- package/dist/components/recipes/atlas/motifBraidChartProps.d.ts +51 -0
- package/dist/components/recipes/atlas/motifBraidGeometry.d.ts +5 -0
- package/dist/components/recipes/atlas/motifBraidLayout.d.ts +11 -0
- package/dist/components/recipes/atlas/motifs.d.ts +3 -0
- package/dist/components/recipes/atlas/prefixForest.d.ts +9 -0
- package/dist/components/recipes/atlas/prepare.d.ts +14 -0
- package/dist/components/recipes/atlas/prepareAsync.d.ts +7 -0
- package/dist/components/recipes/atlas/profile.d.ts +19 -0
- package/dist/components/recipes/atlas/publish.d.ts +10 -0
- package/dist/components/recipes/atlas/queries.d.ts +34 -0
- package/dist/components/recipes/atlas/requiredPaths.d.ts +9 -0
- package/dist/components/recipes/atlas/rootedForest.d.ts +4 -0
- package/dist/components/recipes/atlas/sections.d.ts +3 -0
- package/dist/components/recipes/atlas/support.d.ts +7 -0
- package/dist/components/recipes/atlas/types.d.ts +278 -0
- package/dist/components/recipes/atlas/validate.d.ts +12 -0
- 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-atlas-core.d.ts +20 -0
- package/dist/components/semiotic-atlas.d.ts +8 -0
- package/dist/components/semiotic-realtime-core.d.ts +6 -2
- package/dist/components/semiotic-recipes-core.d.ts +9 -0
- 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 +8 -0
- package/dist/components/server/serverChartConfigsAtlas.d.ts +4 -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/NetworkPipelineStore.d.ts +1 -0
- package/dist/components/stream/SceneGraph.d.ts +3 -3
- package/dist/components/stream/StalenessBadge.d.ts +5 -2
- package/dist/components/stream/canvasSetup.d.ts +1 -2
- package/dist/components/stream/fontLoading.d.ts +4 -0
- package/dist/components/stream/networkCustomLayout.d.ts +8 -0
- package/dist/components/stream/networkCustomLayoutCache.d.ts +12 -0
- package/dist/components/stream/networkPipelineConfig.d.ts +0 -7
- package/dist/components/stream/physics/physicsSemanticUI.d.ts +2 -0
- package/dist/components/stream/physics/usePhysicsCanvasPointer.d.ts +3 -1
- package/dist/components/stream/physics/usePhysicsSemanticNavigation.d.ts +2 -0
- 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/shallowEqual.d.ts +2 -0
- package/dist/components/stream/streamEncodingTypes.d.ts +9 -0
- package/dist/components/stream/types.d.ts +25 -2
- package/dist/components/stream/useEnsureCustomXYRenderers.d.ts +4 -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.d.ts +20 -0
- package/dist/semiotic-atlas-core.min.js +2 -0
- package/dist/semiotic-atlas-core.module.min.js +1 -0
- package/dist/semiotic-atlas-selection.module.min.js +2 -0
- package/dist/semiotic-atlas.d.ts +8 -0
- package/dist/semiotic-atlas.min.js +2 -0
- package/dist/semiotic-atlas.module.min.js +12 -0
- 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.d.ts +9 -0
- 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 +19 -3
- package/dist/c-2N7IU2NY.min.js +0 -1
- package/dist/c-2WK7YJLL.min.js +0 -1
- package/dist/c-33QOXEUG.min.js +0 -1
- package/dist/c-447VIMRO.min.js +0 -1
- package/dist/c-4FN7Q6VQ.min.js +0 -1
- package/dist/c-553QUDKA.min.js +0 -1
- package/dist/c-55BAJ333.min.js +0 -1
- package/dist/c-7242NXSG.min.js +0 -1
- package/dist/c-7EGHJU2F.min.js +0 -1
- package/dist/c-7HP7MB2I.min.js +0 -1
- package/dist/c-7NBU5ZKS.min.js +0 -1
- package/dist/c-AFBSWT77.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-AZKPVBOC.min.js +0 -1
- package/dist/c-BNFJMDHN.min.js +0 -1
- package/dist/c-BNG5ECK5.min.js +0 -1
- package/dist/c-BOHCQILI.min.js +0 -1
- package/dist/c-CCTGN5CK.min.js +0 -1
- package/dist/c-CPSPZH6A.min.js +0 -1
- package/dist/c-CPV4N35K.min.js +0 -1
- package/dist/c-DE5Q3U2X.min.js +0 -1
- package/dist/c-DK662R77.min.js +0 -1
- package/dist/c-DY2676CR.min.js +0 -1
- package/dist/c-E32M6XW5.min.js +0 -1
- package/dist/c-E4JDJH4I.min.js +0 -1
- package/dist/c-E7I2L7CU.min.js +0 -1
- package/dist/c-EBOQ7ER7.min.js +0 -1
- package/dist/c-ELDWAO2V.min.js +0 -1
- package/dist/c-EUBTECGM.min.js +0 -1
- package/dist/c-GSZRZRD6.min.js +0 -1
- package/dist/c-GWX7JGMF.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-HPOYKCCG.min.js +0 -1
- package/dist/c-HXDKPIKR.min.js +0 -1
- package/dist/c-I4QJ6YLM.min.js +0 -1
- package/dist/c-IDJV3CZK.min.js +0 -1
- package/dist/c-ITKX3RC5.min.js +0 -1
- package/dist/c-JG2JCQLP.min.js +0 -1
- package/dist/c-JLGRHXGZ.min.js +0 -1
- package/dist/c-JUKIWTBJ.min.js +0 -1
- package/dist/c-KCRJGUHP.min.js +0 -1
- package/dist/c-LMGSSD2E.min.js +0 -1
- package/dist/c-LYQMZMZQ.min.js +0 -1
- package/dist/c-LYVKDBQJ.min.js +0 -1
- package/dist/c-MXCP7GNZ.min.js +0 -1
- package/dist/c-NG7BLZTR.min.js +0 -1
- package/dist/c-NYZ2QNAM.min.js +0 -1
- package/dist/c-OO5QLMJC.min.js +0 -1
- package/dist/c-OOVX2JPQ.min.js +0 -1
- package/dist/c-PP6VY3QU.min.js +0 -1
- package/dist/c-PRIKOLTE.min.js +0 -1
- package/dist/c-PSNI6KAZ.min.js +0 -1
- package/dist/c-PYNW54D2.min.js +0 -1
- package/dist/c-QAVFOEUY.min.js +0 -1
- package/dist/c-ROEHCIGV.min.js +0 -1
- package/dist/c-S3AZX5PP.min.js +0 -1
- package/dist/c-T2V7O2LO.min.js +0 -1
- package/dist/c-TIXX5CAU.min.js +0 -1
- package/dist/c-TKG2NP7G.min.js +0 -1
- package/dist/c-VXLOLYTO.min.js +0 -1
- package/dist/c-W4ZUKSEQ.min.js +0 -1
- package/dist/c-WH2O53VI.min.js +0 -1
- package/dist/c-WNGH47HF.min.js +0 -1
- package/dist/c-XDQKXPX4.min.js +0 -1
- package/dist/c-XSB27XPS.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-ZYPXQF7B.min.js +0 -1
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import type { ChartRubric } from "./chartCapabilityTypes";
|
|
1
|
+
import type { ChartFamily, ChartRubric } from "./chartCapabilityTypes";
|
|
2
2
|
import type { AccessibilityAuditResult } from "../charts/shared/auditAccessibility";
|
|
3
3
|
/**
|
|
4
4
|
* The channel an audience receives a chart through. Orthogonal to familiarity:
|
|
@@ -13,6 +13,21 @@ import type { AccessibilityAuditResult } from "../charts/shared/auditAccessibili
|
|
|
13
13
|
* "is the meaning recoverable without pixels?" question.
|
|
14
14
|
*/
|
|
15
15
|
export type ReceptionModality = "visual" | "screen-reader" | "sonified" | "agent";
|
|
16
|
+
/**
|
|
17
|
+
* Layout policy for a dashboard generated for this audience. Cell budget,
|
|
18
|
+
* lead families, density, and stream window preference sit next to
|
|
19
|
+
* familiarity so `suggestDashboard` / `suggestStreamDashboard` can honor
|
|
20
|
+
* the same profile the ranking engine already consumes.
|
|
21
|
+
*/
|
|
22
|
+
export interface DashboardLayoutPolicy {
|
|
23
|
+
/** Maximum panels. Overrides the suggester's default budget. */
|
|
24
|
+
cellBudget?: number;
|
|
25
|
+
/** Preferred families for the lead (first) panel. */
|
|
26
|
+
leadFamilies?: ReadonlyArray<ChartFamily>;
|
|
27
|
+
density?: "sparse" | "comfortable" | "dense";
|
|
28
|
+
/** Default retention when a stream schema omits it. */
|
|
29
|
+
windowPreference?: "windowed" | "cumulative";
|
|
30
|
+
}
|
|
16
31
|
/**
|
|
17
32
|
* A serializable description of who's reading the charts and what the
|
|
18
33
|
* organization is trying to grow.
|
|
@@ -68,6 +83,8 @@ export interface AudienceProfile {
|
|
|
68
83
|
* See {@link receivabilityBias}.
|
|
69
84
|
*/
|
|
70
85
|
receptionModality?: ReceptionModality;
|
|
86
|
+
/** Dashboard composition policy for this audience. */
|
|
87
|
+
dashboard?: DashboardLayoutPolicy;
|
|
71
88
|
}
|
|
72
89
|
export interface AudienceTarget {
|
|
73
90
|
direction: "increase" | "decrease";
|
|
@@ -98,7 +98,11 @@ export interface DescribeChartOptions {
|
|
|
98
98
|
/** Include declared recipe risks/caveats in the structured result. */
|
|
99
99
|
includeCaveats?: boolean;
|
|
100
100
|
}
|
|
101
|
-
/**
|
|
101
|
+
/**
|
|
102
|
+
* The communicative act an intent implies. Built-in intents map directly.
|
|
103
|
+
* Registered composed intents resolve through the heaviest child in
|
|
104
|
+
* `composes` (highest `weights` entry, default 1), then recurse.
|
|
105
|
+
*/
|
|
102
106
|
export declare function communicativeActForIntent(intent: IntentId): CommunicativeAct | undefined;
|
|
103
107
|
/**
|
|
104
108
|
* Resolve the communicative act for a chart from (in priority order) an explicit
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import type { ChartRecipe } from "./chartRecipes";
|
|
2
|
+
import type { DashboardLayoutPolicy } from "./audienceProfile";
|
|
2
3
|
export interface IntentManifest {
|
|
3
4
|
ididVersion: string;
|
|
4
5
|
chartId: string;
|
|
@@ -50,6 +51,21 @@ export interface IntentManifest {
|
|
|
50
51
|
annotationStatus?: string;
|
|
51
52
|
};
|
|
52
53
|
}
|
|
54
|
+
export interface DashboardIntentManifest {
|
|
55
|
+
ididVersion: string;
|
|
56
|
+
dashboardId: string;
|
|
57
|
+
title?: string;
|
|
58
|
+
audience?: IntentManifest["audience"];
|
|
59
|
+
layout?: DashboardLayoutPolicy;
|
|
60
|
+
panels: IntentManifest[];
|
|
61
|
+
}
|
|
62
|
+
export declare function dashboardIntentManifest(input: {
|
|
63
|
+
id: string;
|
|
64
|
+
title?: string;
|
|
65
|
+
audience?: IntentManifest["audience"];
|
|
66
|
+
layout?: DashboardLayoutPolicy;
|
|
67
|
+
panels: IntentManifest[];
|
|
68
|
+
}): DashboardIntentManifest;
|
|
53
69
|
export declare function summarizeIntentManifest(manifest: IntentManifest): string;
|
|
54
70
|
export interface IntentManifestFromRecipeOptions {
|
|
55
71
|
chartId: string;
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import type { IntentId, IntentDescriptor } from "./intents";
|
|
2
|
+
interface IntentRegistryStore {
|
|
3
|
+
intents: Map<IntentId, IntentDescriptor>;
|
|
4
|
+
}
|
|
5
|
+
export declare function intentRegistryStore(): IntentRegistryStore;
|
|
6
|
+
/**
|
|
7
|
+
* Materialize requested composed intent scores over a capability's existing
|
|
8
|
+
* scores. Only requested ids are added: registering an intent cannot silently
|
|
9
|
+
* change no-intent/default ranking by adding another value to its mean.
|
|
10
|
+
*/
|
|
11
|
+
export declare function expandComposedIntentScores(scores: Readonly<Partial<Record<IntentId, number>>>, requested: ReadonlyArray<IntentId>): Partial<Record<IntentId, number>>;
|
|
12
|
+
export {};
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
export { expandComposedIntentScores } from "./intentRegistry";
|
|
1
2
|
/**
|
|
2
3
|
* Canonical intent taxonomy for chart suggestion / interrogation.
|
|
3
4
|
*
|
|
@@ -23,6 +24,11 @@ export type IntentFieldKind = "numeric" | "categorical" | "date" | "boolean" | "
|
|
|
23
24
|
*/
|
|
24
25
|
export interface IntentSignals {
|
|
25
26
|
fieldNames?: ReadonlyArray<string>;
|
|
27
|
+
/**
|
|
28
|
+
* Natural-language phrases scored in `inferIntent` prose / combined mode.
|
|
29
|
+
* Matched as whole phrases (case-insensitive), not field-name tokens.
|
|
30
|
+
*/
|
|
31
|
+
phrases?: ReadonlyArray<string>;
|
|
26
32
|
minimumFieldMatches?: number;
|
|
27
33
|
dataShape?: {
|
|
28
34
|
minNumericFields?: number;
|
|
@@ -59,11 +65,5 @@ export declare function listIntents(): IntentDescriptor[];
|
|
|
59
65
|
* replaces the descriptor.
|
|
60
66
|
*/
|
|
61
67
|
export declare function registerIntent(intent: IntentDescriptor): void;
|
|
62
|
-
/**
|
|
63
|
-
* Materialize requested composed intent scores over a capability's existing
|
|
64
|
-
* scores. Only requested ids are added: registering an intent cannot silently
|
|
65
|
-
* change no-intent/default ranking by adding another value to its mean.
|
|
66
|
-
*/
|
|
67
|
-
export declare function expandComposedIntentScores(scores: Readonly<Partial<Record<IntentId, number>>>, requested: ReadonlyArray<IntentId>): Partial<Record<IntentId, number>>;
|
|
68
68
|
/** Sentinel set used by capability authors to opt out of an intent without misspelling. */
|
|
69
69
|
export declare const BUILT_IN_INTENT_IDS: ReadonlySet<BuiltInIntentId>;
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
import type { StreamFieldSchema, StreamSchema, StreamShape, StreamThroughputBand, StreamThroughputThresholds } from "./streamingTypes";
|
|
2
|
+
/** Names that should not be plotted as measures when no value role is set. */
|
|
3
|
+
export declare function isIdLikeFieldName(name: string): boolean;
|
|
4
|
+
/** Identity columns: explicit `keyFields` unioned with `role: "key"`. */
|
|
5
|
+
export declare function streamKeyFields(schema: StreamSchema): string[];
|
|
6
|
+
/**
|
|
7
|
+
* Resolve changelog semantics. Explicit `shape` wins; otherwise a schema
|
|
8
|
+
* with identity columns is keyed, and everything else is append-only.
|
|
9
|
+
*/
|
|
10
|
+
export declare function resolveStreamShape(schema: StreamSchema): StreamShape;
|
|
11
|
+
export declare function streamThroughputBand(schema: StreamSchema, thresholds?: StreamThroughputThresholds): StreamThroughputBand | undefined;
|
|
12
|
+
export declare function pickTimeField(schema: StreamSchema): StreamFieldSchema | undefined;
|
|
13
|
+
export declare function pickValueField(schema: StreamSchema): StreamFieldSchema | undefined;
|
|
14
|
+
export declare function pickCategoryField(schema: StreamSchema): StreamFieldSchema | undefined;
|
|
15
|
+
export declare function pickSeriesField(schema: StreamSchema): StreamFieldSchema | undefined;
|
|
16
|
+
export declare function hasNumericValue(schema: StreamSchema): boolean;
|
|
17
|
+
export declare function hasTimeField(schema: StreamSchema): boolean;
|
|
18
|
+
export declare function hasCategoryField(schema: StreamSchema): boolean;
|
|
19
|
+
export declare function hasSeriesField(schema: StreamSchema): boolean;
|
|
@@ -1,20 +1,47 @@
|
|
|
1
|
-
import type { ChartRubric } from "./chartCapabilityTypes";
|
|
1
|
+
import type { ChartFamily, ChartRubric } from "./chartCapabilityTypes";
|
|
2
2
|
import type { IntentId } from "./intents";
|
|
3
3
|
/**
|
|
4
4
|
* Streaming chart selection has a different shape than static. We don't have
|
|
5
5
|
* rows yet — we have a *schema*: which fields will arrive, what types, plus
|
|
6
|
-
* environment hints (throughput, retention).
|
|
6
|
+
* environment hints (throughput, retention, changelog shape).
|
|
7
7
|
*
|
|
8
8
|
* Rather than overloading `profileData` (which is row-statistics-centric) we
|
|
9
9
|
* model streams as a parallel API. The two share the intent vocabulary —
|
|
10
10
|
* "trend" still means trend — but the suitability logic is its own thing.
|
|
11
11
|
*/
|
|
12
12
|
export type StreamFieldKind = "numeric" | "categorical" | "date" | "boolean";
|
|
13
|
+
export type StreamFieldRole = "x" | "y" | "value" | "category" | "series" | "size" | "key";
|
|
14
|
+
/**
|
|
15
|
+
* Changelog semantics for a stream. First-class so capabilities can reason
|
|
16
|
+
* about identity without encoding "keyed" as `role: "category"` plus
|
|
17
|
+
* `retention: "cumulative"`.
|
|
18
|
+
*
|
|
19
|
+
* • `"append"` — append-only event stream (default)
|
|
20
|
+
* • `"keyed"` — keyed table / changelog (insert, update, retract)
|
|
21
|
+
* • `"aggregate"` — single-row aggregate (one current value)
|
|
22
|
+
*/
|
|
23
|
+
export type StreamShape = "append" | "keyed" | "aggregate";
|
|
24
|
+
/**
|
|
25
|
+
* Event-rate hint. A number is rows per second; capabilities convert it to
|
|
26
|
+
* a band with {@link streamThroughputBand}. String bands keep the original
|
|
27
|
+
* qualitative API:
|
|
28
|
+
* • "low" — < 1 event/sec
|
|
29
|
+
* • "medium" — ~1-100 events/sec
|
|
30
|
+
* • "high" — > 100 events/sec
|
|
31
|
+
*/
|
|
32
|
+
export type StreamThroughput = "low" | "medium" | "high" | number;
|
|
33
|
+
export type StreamThroughputBand = "low" | "medium" | "high";
|
|
34
|
+
export interface StreamThroughputThresholds {
|
|
35
|
+
/** Inclusive lower bound for "medium", default 1. */
|
|
36
|
+
medium?: number;
|
|
37
|
+
/** Inclusive lower bound for "high", default 100. */
|
|
38
|
+
high?: number;
|
|
39
|
+
}
|
|
13
40
|
export interface StreamFieldSchema {
|
|
14
41
|
name: string;
|
|
15
42
|
kind: StreamFieldKind;
|
|
16
43
|
/** Optional role hint — overrides the engine's inference. */
|
|
17
|
-
role?:
|
|
44
|
+
role?: StreamFieldRole;
|
|
18
45
|
}
|
|
19
46
|
/**
|
|
20
47
|
* Schema describing what a stream emits. No data, just shape + environment hints.
|
|
@@ -24,17 +51,25 @@ export interface StreamSchema {
|
|
|
24
51
|
/**
|
|
25
52
|
* Hint about expected event rate. Affects chart selection — heatmaps and
|
|
26
53
|
* waterfalls amortize high-throughput streams better than line charts do.
|
|
27
|
-
*
|
|
28
|
-
* • "medium" — ~1-100 events/sec
|
|
29
|
-
* • "high" — > 100 events/sec, prefer aggregating visualizations
|
|
54
|
+
* A number is rows per second; string bands are qualitative.
|
|
30
55
|
*/
|
|
31
|
-
throughput?:
|
|
56
|
+
throughput?: StreamThroughput;
|
|
32
57
|
/**
|
|
33
58
|
* Hint about how long events are kept in view.
|
|
34
59
|
* • "windowed" — only recent events visible (default)
|
|
35
60
|
* • "cumulative" — all events accumulate
|
|
36
61
|
*/
|
|
37
62
|
retention?: "windowed" | "cumulative";
|
|
63
|
+
/**
|
|
64
|
+
* Changelog semantics. When omitted, inferred from `keyFields` /
|
|
65
|
+
* `role: "key"` (keyed) and otherwise treated as append-only.
|
|
66
|
+
*/
|
|
67
|
+
shape?: StreamShape;
|
|
68
|
+
/**
|
|
69
|
+
* Identity columns for keyed tables. Unioned with fields whose role is
|
|
70
|
+
* `"key"` by {@link streamKeyFields}.
|
|
71
|
+
*/
|
|
72
|
+
keyFields?: ReadonlyArray<string>;
|
|
38
73
|
}
|
|
39
74
|
/**
|
|
40
75
|
* Stream capability descriptor — parallel to ChartCapability but operates on
|
|
@@ -42,7 +77,18 @@ export interface StreamSchema {
|
|
|
42
77
|
*/
|
|
43
78
|
export interface StreamChartCapability {
|
|
44
79
|
component: string;
|
|
45
|
-
|
|
80
|
+
/**
|
|
81
|
+
* Import specifier for generated code. Built-ins use family subpaths
|
|
82
|
+
* (`semiotic/realtime`, `semiotic/ordinal`, `semiotic/value`); wrappers
|
|
83
|
+
* may declare any string (e.g. `"@iris/charts"`).
|
|
84
|
+
*/
|
|
85
|
+
importPath: string;
|
|
86
|
+
/**
|
|
87
|
+
* Chart family for ranking and dashboard diversification.
|
|
88
|
+
* Omitted descriptors default to `"realtime"` so 3.10 custom
|
|
89
|
+
* capabilities remain assignable.
|
|
90
|
+
*/
|
|
91
|
+
family?: ChartFamily;
|
|
46
92
|
/** True when this chart consumes an event stream and has no static render proof. */
|
|
47
93
|
requiresLiveData?: boolean;
|
|
48
94
|
rubric: ChartRubric;
|
|
@@ -54,8 +100,8 @@ export interface StreamChartCapability {
|
|
|
54
100
|
export type StreamIntentScorer = number | ((schema: StreamSchema) => number);
|
|
55
101
|
export interface StreamSuggestion {
|
|
56
102
|
component: string;
|
|
57
|
-
family:
|
|
58
|
-
importPath:
|
|
103
|
+
family: ChartFamily;
|
|
104
|
+
importPath: string;
|
|
59
105
|
/** Whether the recommendation must receive live event data rather than a bounded array. */
|
|
60
106
|
requiresLiveData?: boolean;
|
|
61
107
|
score: number;
|
|
@@ -63,6 +109,6 @@ export interface StreamSuggestion {
|
|
|
63
109
|
rubric: ChartRubric;
|
|
64
110
|
reasons: ReadonlyArray<string>;
|
|
65
111
|
caveats: ReadonlyArray<string>;
|
|
66
|
-
/** Props ready to spread into the matching
|
|
112
|
+
/** Props ready to spread into the matching chart. */
|
|
67
113
|
props: Record<string, unknown>;
|
|
68
114
|
}
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import type { Datum } from "../charts/shared/datumTypes";
|
|
2
2
|
import { type ProfileDataOptions } from "./profileData";
|
|
3
3
|
import type { ChartCapability, ChartDataProfile, ScoreChartResult, ScaledSuggestionGroups, Suggestion } from "./chartCapabilityTypes";
|
|
4
|
-
import {
|
|
4
|
+
import type { IntentId } from "./intents";
|
|
5
5
|
import { type AudienceProfile, type ReceptionModality } from "./audienceProfile";
|
|
6
6
|
import { type DataQualityProfile, type DataScaleProfile } from "./dataScaleProfile";
|
|
7
7
|
export interface SuggestChartsOptions extends ProfileDataOptions {
|
|
@@ -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
|
*
|