semiotic 3.8.9 → 3.9.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +55 -81
- package/agent-skill/semiotic-charts/SKILL.md +11 -2
- package/ai/behaviorContracts.cjs +33 -3
- package/ai/cli.js +53 -2
- package/ai/componentMetadata.cjs +15 -0
- package/ai/dist/mcp-server.js +1530 -611
- package/ai/examples.md +48 -42
- package/{CLAUDE.md → ai/reference.md} +43 -22
- package/ai/schema.json +10603 -986
- package/ai/surface-manifest.json +643 -2
- package/ai/system-prompt.md +83 -130
- package/dist/c-3BLJEQNG.min.js +1 -0
- package/dist/c-3KZD6AXJ.min.js +1 -0
- package/dist/c-4TWEX5HG.min.js +1 -0
- package/dist/c-52TEGIUJ.min.js +1 -0
- package/dist/c-5YCIX3VZ.min.js +1 -0
- package/dist/c-6FEKTA3U.min.js +1 -0
- package/dist/c-6O5EVOPH.min.js +1 -0
- package/dist/c-74HEEZGK.min.js +1 -0
- package/dist/c-AKAF6JAD.min.js +1 -0
- package/dist/c-BBKITSXB.min.js +1 -0
- package/dist/c-BWNB6USU.min.js +1 -0
- package/dist/c-C25ENHIK.min.js +1 -0
- package/dist/c-CDR5AO3R.min.js +1 -0
- package/dist/c-COHXCW3Q.min.js +1 -0
- package/dist/{chunk-scatterplotMatrixBrushOverlay-SDIZSN66.module.min.js → c-DADXPJXV.min.js} +0 -1
- package/dist/c-E3JFRRMI.min.js +1 -0
- package/dist/c-EBFPQHHO.min.js +1 -0
- package/dist/c-G36WS6LN.min.js +1 -0
- package/dist/c-GIKRQI4X.min.js +1 -0
- package/dist/c-GPYOFETM.min.js +1 -0
- package/dist/c-IDUHYYSI.min.js +1 -0
- package/dist/{chunk-chunk-FQPKOAIH.module.min.js → c-IUHFPMHD.min.js} +0 -1
- package/dist/c-J5G56TUH.min.js +1 -0
- package/dist/c-JAZ73J32.min.js +1 -0
- package/dist/c-KG3NXHAL.min.js +1 -0
- package/dist/c-KII3PLZE.min.js +1 -0
- package/dist/c-LIXGXMNS.min.js +1 -0
- package/dist/c-LVEY6D6B.min.js +1 -0
- package/dist/c-M4Y3BHFR.min.js +1 -0
- package/dist/c-MAIICR2Z.min.js +1 -0
- package/dist/c-MG5DM6VE.min.js +1 -0
- package/dist/{chunk-minimapBrushOverlay-JU57U7NM.module.min.js → c-MNF2S4AA.min.js} +0 -1
- package/dist/c-MT3WBK7M.min.js +1 -0
- package/dist/c-NY3JWV2K.min.js +1 -0
- package/dist/c-O6U6K4CW.min.js +1 -0
- package/dist/c-OCI56QF2.min.js +1 -0
- package/dist/c-OQ7M4AGV.min.js +1 -0
- package/dist/c-OXYMVK7Q.min.js +1 -0
- package/dist/c-PPWDL5ZI.min.js +1 -0
- package/dist/c-QHF5YON3.min.js +1 -0
- package/dist/c-RR3GO5SW.min.js +1 -0
- package/dist/{chunk-chunk-J5QD4RAM.module.min.js → c-RSVIHIQ4.min.js} +0 -1
- package/dist/{chunk-chunk-EMO5NUGE.module.min.js → c-S2BXNNJN.min.js} +0 -1
- package/dist/{chunk-chunk-YCQYG6J5.module.min.js → c-SLGMUBUL.min.js} +0 -1
- package/dist/c-SUILCHWU.min.js +1 -0
- package/dist/c-TZW3JGJ5.min.js +1 -0
- package/dist/c-US5ZFT6E.min.js +1 -0
- package/dist/{chunk-chunk-RZH7VZYS.module.min.js → c-USFMFKIH.min.js} +0 -1
- package/dist/c-UUKVD4WB.min.js +1 -0
- package/dist/{chunk-chunk-SV4XAZ3Q.module.min.js → c-VGW3VG3I.min.js} +0 -1
- package/dist/c-W3CE4A4S.min.js +1 -0
- package/dist/{chunk-chunk-2NVFEB7P.module.min.js → c-WJCD5EUY.min.js} +0 -1
- package/dist/{chunk-chunk-2JGJ5GUG.module.min.js → c-X5UBGU2V.min.js} +0 -1
- package/dist/c-YDAY2WFR.min.js +1 -0
- package/dist/c-ZOWWU34K.min.js +1 -0
- package/dist/components/AccessibleNavTree.d.ts +1 -1
- package/dist/components/CategoryColors.d.ts +1 -1
- package/dist/components/GradientLegend.d.ts +14 -0
- package/dist/components/Legend.d.ts +2 -7
- package/dist/components/LinkedCharts.d.ts +1 -1
- package/dist/components/MobileAnnotationCalloutList.d.ts +1 -1
- package/dist/components/ObservationReadout.d.ts +45 -0
- package/dist/components/ThemeProvider.d.ts +4 -4
- package/dist/components/Tooltip/FlippingTooltip.d.ts +5 -7
- package/dist/components/Tooltip/Tooltip.d.ts +30 -5
- package/dist/components/Tooltip/tooltipChrome.d.ts +43 -0
- package/dist/components/ai/chartCapabilityTypes.d.ts +86 -2
- package/dist/components/ai/chartClinic.d.ts +2 -0
- package/dist/components/ai/deriveProfileFields.d.ts +40 -0
- package/dist/components/ai/evaluateChart.d.ts +85 -0
- package/dist/components/ai/fieldPolicy.d.ts +7 -0
- package/dist/components/ai/fieldRoles.d.ts +24 -0
- package/dist/components/ai/generativeChart.d.ts +18 -2
- package/dist/components/ai/inferIntent.d.ts +26 -2
- package/dist/components/ai/intents.d.ts +35 -0
- package/dist/components/ai/navigationTree.d.ts +2 -2
- package/dist/components/ai/observedSceneAudit.d.ts +2 -1
- package/dist/components/ai/profileData.d.ts +11 -0
- package/dist/components/ai/repairChartConfig.d.ts +2 -3
- package/dist/components/ai/semanticEvidence.d.ts +4 -0
- package/dist/components/ai/semanticViability.d.ts +11 -0
- package/dist/components/ai/semanticViabilityRegistry.d.ts +5 -0
- package/dist/components/ai/streamingTypes.d.ts +4 -0
- package/dist/components/ai/suggestCharts.d.ts +5 -6
- package/dist/components/ai/suggestDashboard.d.ts +2 -3
- package/dist/components/ai/suggestStreamCharts.d.ts +1 -1
- package/dist/components/ai/suggestStretchCharts.d.ts +2 -3
- package/dist/components/ai/suggestionPropContracts.d.ts +20 -0
- package/dist/components/ai/variantDiscovery.d.ts +3 -1
- package/dist/components/charts/custom/NetworkCustomChart.d.ts +3 -0
- package/dist/components/charts/custom/OrdinalCustomChart.d.ts +3 -0
- package/dist/components/charts/custom/XYCustomChart.d.ts +1 -1
- package/dist/components/charts/geo/ChoroplethMap.d.ts +3 -1
- package/dist/components/charts/geo/DistanceCartogram.d.ts +2 -7
- package/dist/components/charts/geo/cartogramOverlay.d.ts +28 -0
- package/dist/components/charts/index.d.ts +4 -3
- package/dist/components/charts/network/ProcessSankey.d.ts +2 -136
- package/dist/components/charts/network/ProcessSankeyProps.d.ts +139 -0
- package/dist/components/charts/network/Treemap.d.ts +2 -1
- package/dist/components/charts/network/processSankey/boundaryHubOrdering.d.ts +23 -0
- package/dist/components/charts/network/processSankey/layoutGeometry.d.ts +2 -0
- package/dist/components/charts/network/processSankey/ordering.d.ts +3 -41
- package/dist/components/charts/network/processSankey/orderingTypes.d.ts +32 -0
- package/dist/components/charts/network/processSankey/packing.d.ts +1 -1
- package/dist/components/charts/network/processSankey/packingCache.d.ts +1 -1
- package/dist/components/charts/network/processSankey/packingOptimization.d.ts +72 -0
- package/dist/components/charts/ordinal/BarChart.d.ts +4 -3
- package/dist/components/charts/ordinal/FunnelChart.d.ts +2 -0
- package/dist/components/charts/ordinal/GroupedBarChart.d.ts +3 -2
- package/dist/components/charts/ordinal/StackedBarChart.d.ts +4 -3
- package/dist/components/charts/ordinal/SwimlaneChart.d.ts +2 -2
- package/dist/components/charts/physics/GaltonBoardChart.d.ts +2 -9
- package/dist/components/charts/physics/GauntletChart.d.ts +10 -41
- package/dist/components/charts/physics/ProcessFlowChart.d.ts +1 -1
- package/dist/components/charts/physics/chainReactionAccessibleTable.d.ts +9 -0
- package/dist/components/charts/physics/chainReactionRuntime.d.ts +2 -1
- package/dist/components/charts/physics/chainReactionTypes.d.ts +5 -1
- package/dist/components/charts/physics/crucibleBodyRenderers.d.ts +2 -2
- package/dist/components/charts/physics/crucibleClone.d.ts +6 -0
- package/dist/components/charts/physics/crucibleEffects.d.ts +1 -2
- package/dist/components/charts/physics/crucibleRecord.d.ts +7 -0
- package/dist/components/charts/physics/gauntletChrome.d.ts +4 -4
- package/dist/components/charts/physics/gauntletPhysics.d.ts +1 -0
- package/dist/components/charts/physics/gauntletPublic.d.ts +4 -0
- package/dist/components/charts/physics/packetFlowOverlay.d.ts +7 -0
- package/dist/components/charts/physics/physicsChartLayout.d.ts +8 -0
- package/dist/components/charts/physics/physicsChartShared.d.ts +3 -1
- package/dist/components/charts/physics/physicsChartUtils.d.ts +1 -1
- package/dist/components/charts/physics/physicsHocUtils.d.ts +25 -12
- package/dist/components/charts/physics/physicsProjectionOverlays.d.ts +24 -0
- package/dist/components/charts/physics/processFlowOverlays.d.ts +9 -0
- package/dist/components/charts/realtime/RealtimeHeatmap.d.ts +15 -12
- package/dist/components/charts/realtime/RealtimeHistogram.d.ts +10 -7
- package/dist/components/charts/realtime/RealtimeLineChart.d.ts +35 -14
- package/dist/components/charts/realtime/RealtimeSwarmChart.d.ts +21 -14
- package/dist/components/charts/realtime/RealtimeWaterfallChart.d.ts +20 -13
- package/dist/components/charts/realtime/aggregate.d.ts +4 -1
- package/dist/components/charts/realtime/eventTime.d.ts +4 -0
- package/dist/components/charts/realtime/realtimeChartRuntime.d.ts +27 -0
- package/dist/components/charts/realtime/realtimeChartTypes.d.ts +30 -0
- package/dist/components/charts/realtime/useRealtimeCategoryColors.d.ts +30 -0
- package/dist/components/charts/shared/FrameTextAnnotationSVG.d.ts +10 -0
- package/dist/components/charts/shared/annotationActivation.d.ts +3 -7
- package/dist/components/charts/shared/annotationBandFill.d.ts +6 -0
- package/dist/components/charts/shared/annotationDispatch.d.ts +31 -0
- package/dist/components/charts/shared/annotationIdentity.d.ts +8 -0
- package/dist/components/charts/shared/annotationRules.d.ts +1 -15
- package/dist/components/charts/shared/boundedCategoryRegistry.d.ts +8 -0
- package/dist/components/charts/shared/chainReactionChartSpec.d.ts +3 -0
- package/dist/components/charts/shared/chartMode.d.ts +3 -2
- package/dist/components/charts/shared/chartSpecCore.d.ts +1 -0
- package/dist/components/charts/shared/frameTextAnnotation.d.ts +63 -0
- package/dist/components/charts/shared/gradient.d.ts +16 -0
- package/dist/components/charts/shared/hatchFill.d.ts +15 -0
- package/dist/components/charts/shared/hooks.d.ts +4 -4
- package/dist/components/charts/shared/legendUtils.d.ts +1 -0
- package/dist/components/charts/shared/streamPropsHelpers.d.ts +2 -1
- package/dist/components/charts/shared/styleRules.d.ts +9 -2
- package/dist/components/charts/shared/styleRulesWireSchema.d.ts +353 -0
- package/dist/components/charts/shared/types.d.ts +18 -9
- package/dist/components/charts/shared/useChartLegend.d.ts +43 -9
- package/dist/components/charts/shared/useChartSetup.d.ts +3 -1
- package/dist/components/charts/shared/useCustomChartSetup.d.ts +5 -2
- package/dist/components/charts/shared/useNetworkChartSetup.d.ts +5 -1
- package/dist/components/charts/shared/useOrdinalBrush.d.ts +3 -3
- package/dist/components/charts/shared/useStreamingLegend.d.ts +6 -1
- package/dist/components/charts/value/types.d.ts +1 -1
- package/dist/components/charts/xy/BubbleChart.d.ts +1 -1
- package/dist/components/charts/xy/BumpChart.capability.d.ts +14 -1
- package/dist/components/charts/xy/BumpChart.d.ts +13 -73
- package/dist/components/charts/xy/BumpChart.semanticViability.d.ts +5 -0
- package/dist/components/charts/xy/CandlestickChart.d.ts +2 -2
- package/dist/components/charts/xy/LineChart.d.ts +2 -2
- package/dist/components/charts/xy/Scatterplot.d.ts +1 -1
- package/dist/components/charts/xy/bumpData.d.ts +44 -0
- package/dist/components/charts/xy/bumpIdentity.d.ts +2 -0
- package/dist/components/charts/xy/bumpLayout.d.ts +45 -0
- package/dist/components/charts/xy/bumpTooltip.d.ts +20 -0
- package/dist/components/legendLayout.d.ts +131 -4
- package/dist/components/realtime/ReorderBuffer.d.ts +2 -0
- package/dist/components/realtime/types.d.ts +10 -1
- package/dist/components/recipes/balanceSnapshotsToFlows.d.ts +42 -0
- package/dist/components/recipes/directedReachability.d.ts +14 -0
- package/dist/components/recipes/gofishDisplayListFixtures.generated.d.ts +6 -6
- package/dist/components/recipes/gridObservatory.d.ts +1 -1
- package/dist/components/recipes/networkAnalysis.d.ts +1 -18
- package/dist/components/recipes/physics.d.ts +7 -4
- package/dist/components/recipes/processPhysics.d.ts +0 -1
- package/dist/components/recipes/waffle.d.ts +7 -4
- package/dist/components/semiotic-ai-core.d.ts +13 -4
- package/dist/components/semiotic-ai-observations.d.ts +3 -0
- package/dist/components/semiotic-ai.d.ts +16 -9
- package/dist/components/semiotic-client-shared.d.ts +10 -0
- package/dist/components/semiotic-experimental.d.ts +1 -1
- package/dist/components/semiotic-geo.d.ts +4 -1
- package/dist/components/semiotic-network.d.ts +7 -4
- package/dist/components/semiotic-ordinal.d.ts +4 -1
- package/dist/components/semiotic-physics.d.ts +11 -4
- package/dist/components/semiotic-realtime-core.d.ts +11 -4
- package/dist/components/semiotic-realtime-react.d.ts +4 -3
- package/dist/components/semiotic-realtime.d.ts +3 -1
- package/dist/components/semiotic-recipes-core.d.ts +7 -5
- package/dist/components/semiotic-server-edge.d.ts +3 -2
- package/dist/components/semiotic-server.d.ts +3 -2
- package/dist/components/semiotic-themes-core.d.ts +5 -48
- package/dist/components/semiotic-utils-core.d.ts +10 -5
- package/dist/components/semiotic-utils-react.d.ts +2 -0
- package/dist/components/semiotic-utils.d.ts +1 -1
- package/dist/components/semiotic-xy.d.ts +4 -1
- package/dist/components/semiotic.d.ts +68 -26
- package/dist/components/server/animatedGif.d.ts +1 -1
- package/dist/components/server/renderEvidence.d.ts +25 -2
- package/dist/components/server/renderToStaticSVG.d.ts +15 -7
- package/dist/components/server/serverChartConfigShared.d.ts +8 -1
- package/dist/components/server/serverChartConfigs.d.ts +1 -0
- package/dist/components/server/serverChartConfigsNetwork.d.ts +3 -3
- package/dist/components/server/serverChartConfigsNetworkChord.d.ts +2 -0
- package/dist/components/server/serverChartConfigsNetworkForce.d.ts +2 -0
- package/dist/components/server/serverChartConfigsNetworkHierarchy.d.ts +3 -0
- package/dist/components/server/serverChartConfigsXY.d.ts +3 -3
- package/dist/components/server/serverChartConfigsXYBubble.d.ts +5 -0
- package/dist/components/server/serverChartConfigsXYBump.d.ts +7 -0
- package/dist/components/server/serverChartConfigsXYScatter.d.ts +5 -0
- package/dist/components/server/staticAnnotationFallbacks.d.ts +10 -0
- package/dist/components/server/staticAnnotations.d.ts +28 -1
- package/dist/components/server/staticAxisTickLabel.d.ts +13 -0
- package/dist/components/server/staticLegend.d.ts +1 -1
- package/dist/components/server/staticLegendMargin.d.ts +41 -0
- package/dist/components/server/staticOrdinal.d.ts +8 -2
- package/dist/components/server/staticPhysics.d.ts +13 -1
- package/dist/components/server/staticPhysicsChrome.d.ts +20 -0
- package/dist/components/server/staticRawLegend.d.ts +15 -0
- package/dist/components/server/staticSVGChrome.d.ts +16 -55
- package/dist/components/server/staticXYAxes.d.ts +27 -0
- package/dist/components/server/staticXYAxisTicks.d.ts +39 -0
- package/dist/components/server/staticXYGrid.d.ts +11 -0
- package/dist/components/server/themeResolver.d.ts +5 -1
- package/dist/components/store/ThemeStore.d.ts +2 -98
- package/dist/components/store/designTokens.d.ts +1 -1
- package/dist/components/store/themeCSSVariables.d.ts +10 -0
- package/dist/components/store/themeCore.d.ts +91 -0
- package/dist/components/store/themePresets.d.ts +81 -0
- package/dist/components/store/themeSerialization.d.ts +2 -1
- package/dist/components/stream/AccessibleDataTable.d.ts +12 -14
- package/dist/components/stream/AccessibleTablePortalImpl.d.ts +6 -0
- package/dist/components/stream/GeoTileRenderer.d.ts +2 -0
- package/dist/components/stream/NetworkCanvasHitTester.d.ts +3 -1
- package/dist/components/stream/NetworkSSRFrame.d.ts +2 -1
- package/dist/components/stream/NetworkSVGOverlay.d.ts +3 -31
- package/dist/components/stream/OrdinalCanvasHitTester.d.ts +2 -0
- package/dist/components/stream/SVGChartTitle.d.ts +9 -0
- package/dist/components/stream/SVGOverlay.d.ts +1 -21
- package/dist/components/stream/SVGUnderlay.d.ts +24 -0
- package/dist/components/stream/SceneToSVG.d.ts +1 -1
- package/dist/components/stream/StreamGeoFrame.d.ts +1 -1
- package/dist/components/stream/StreamOrdinalFrame.d.ts +1 -1
- package/dist/components/stream/StreamXYFrame.d.ts +1 -1
- package/dist/components/stream/accessibleDataRows.d.ts +11 -0
- package/dist/components/stream/accessibleDataTableModel.d.ts +40 -0
- package/dist/components/stream/accessibleTableTypes.d.ts +11 -0
- package/dist/components/stream/axisTickUtils.d.ts +19 -0
- package/dist/components/stream/canvasBackground.d.ts +10 -0
- package/dist/components/stream/canvasSetup.d.ts +9 -0
- package/dist/components/stream/frameCursorInteraction.d.ts +25 -0
- package/dist/components/stream/frameDefaultMargins.d.ts +37 -0
- package/dist/components/stream/frameGraphics.d.ts +18 -0
- package/dist/components/stream/frameGraphicsSubscription.d.ts +26 -0
- package/dist/components/stream/frameLegendOptions.d.ts +18 -0
- package/dist/components/stream/geoFrameCursorInteraction.d.ts +9 -0
- package/dist/components/stream/geoFrameHelpers.d.ts +29 -1
- package/dist/components/stream/geoTypes.d.ts +10 -11
- package/dist/components/stream/hitTarget.d.ts +61 -2
- package/dist/components/stream/moduleWorkerSession.d.ts +6 -0
- package/dist/components/stream/networkAnnotationAnchors.d.ts +37 -0
- package/dist/components/stream/networkCustomLayout.d.ts +2 -2
- package/dist/components/stream/networkFrameCursorInteraction.d.ts +12 -0
- package/dist/components/stream/networkFrameInteraction.d.ts +2 -0
- package/dist/components/stream/networkFramePaint.d.ts +7 -0
- package/dist/components/stream/networkPipelineConfig.d.ts +1 -1
- package/dist/components/stream/networkTypes.d.ts +30 -32
- package/dist/components/stream/normalizeXYData.d.ts +7 -0
- package/dist/components/stream/ordinalFrameCursorInteraction.d.ts +7 -0
- package/dist/components/stream/ordinalFrameInteraction.d.ts +29 -0
- package/dist/components/stream/ordinalSceneSVG.d.ts +10 -0
- package/dist/components/stream/ordinalTypes.d.ts +10 -4
- package/dist/components/stream/physics/PhysicsBodySpatialIndex.d.ts +9 -1
- package/dist/components/stream/physics/PhysicsCanvasTheme.d.ts +25 -0
- package/dist/components/stream/physics/PhysicsControllers.d.ts +0 -3
- package/dist/components/stream/physics/PhysicsPipelineStore.d.ts +4 -1
- package/dist/components/stream/physics/PhysicsSVGOverlay.d.ts +3 -24
- package/dist/components/stream/physics/PhysicsSettledSVG.d.ts +9 -21
- package/dist/components/stream/physics/PhysicsSettledSVGElement.d.ts +37 -0
- package/dist/components/stream/physics/PhysicsSettledScene.d.ts +7 -3
- package/dist/components/stream/physics/StreamPhysicsFrame.d.ts +1 -1
- package/dist/components/stream/physics/StreamPhysicsTypes.d.ts +23 -4
- package/dist/components/stream/physics/physicsAnnotationContext.d.ts +19 -0
- package/dist/components/stream/physics/physicsBodyCanvas.d.ts +4 -0
- package/dist/components/stream/physics/physicsSettledChrome.d.ts +7 -0
- package/dist/components/stream/physics/usePhysicsCanvasPointer.d.ts +32 -0
- package/dist/components/stream/physics/usePhysicsSemanticNavigation.d.ts +36 -0
- package/dist/components/stream/pipelineConfig.d.ts +6 -17
- package/dist/components/stream/pipelineDomainResolution.d.ts +1 -1
- package/dist/components/stream/renderBackend.d.ts +2 -0
- package/dist/components/stream/renderers/canvasRenderHelpers.d.ts +13 -2
- package/dist/components/stream/renderers/resolveCSSColor.d.ts +7 -0
- package/dist/components/stream/responsiveSize.d.ts +17 -0
- package/dist/components/stream/sceneCursor.d.ts +41 -0
- package/dist/components/stream/sceneRevisionDiagnostics.d.ts +1 -1
- package/dist/components/stream/svgOverlayUtils.d.ts +22 -1
- package/dist/components/stream/types.d.ts +25 -12
- package/dist/components/stream/useCanvasFrameHost.d.ts +3 -1
- package/dist/components/stream/useFrame.d.ts +24 -1
- package/dist/components/stream/useResponsiveSize.d.ts +6 -1
- package/dist/components/stream/useStalenessCheck.d.ts +1 -1
- package/dist/components/stream/xyFrameAxisTypes.d.ts +15 -4
- package/dist/components/stream/xyFrameCursorInteraction.d.ts +6 -0
- package/dist/components/stream/xySceneBuilders/swarmScene.d.ts +1 -1
- package/dist/components/stream/xySceneBuilders/types.d.ts +6 -26
- package/dist/components/types/legendTypes.d.ts +6 -0
- package/dist/components/types/marginType.d.ts +7 -8
- package/dist/controls.min.js +1 -1
- package/dist/controls.module.min.js +1 -1
- package/dist/forceLayoutWorker.js +1 -1
- package/dist/geo.min.js +1 -1
- package/dist/geo.module.min.js +1 -1
- package/dist/network.min.js +1 -1
- package/dist/network.module.min.js +1 -1
- package/dist/ordinal.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.min.js +1 -1
- package/dist/physics.module.min.js +1 -1
- package/dist/physicsWorker.js +1 -1
- package/dist/processSankeyLayoutWorker.js +1 -1
- package/dist/realtime.min.js +1 -1
- package/dist/realtime.module.min.js +1 -1
- package/dist/rough.min.js +1 -1
- package/dist/rough.module.min.js +1 -1
- package/dist/semiotic-ai-core.d.ts +13 -4
- package/dist/semiotic-ai-core.min.js +1 -1
- package/dist/semiotic-ai-core.module.min.js +1 -1
- package/dist/semiotic-ai.d.ts +16 -9
- package/dist/semiotic-ai.min.js +1 -1
- package/dist/semiotic-ai.module.min.js +1 -1
- package/dist/semiotic-client-cjs-shared.min.js +1 -0
- package/dist/semiotic-client-glyph.module.min.js +2 -0
- package/dist/semiotic-client-responsive.module.min.js +2 -0
- package/dist/semiotic-client-shared.module.min.js +2 -0
- package/dist/semiotic-custom-layout-selection-cjs-shared.min.js +2 -0
- package/dist/semiotic-data.min.js +1 -1
- package/dist/semiotic-data.module.min.js +1 -1
- package/dist/semiotic-experimental-auxiliary.module.min.js +2 -0
- package/dist/semiotic-experimental-node-auxiliary.module.min.js +2 -0
- package/dist/semiotic-experimental-node.module.min.js +2 -0
- package/dist/semiotic-experimental-react-shared.module.min.js +2 -0
- package/dist/semiotic-experimental-vacp.min.js +1 -1
- package/dist/semiotic-experimental-vacp.module.min.js +1 -1
- package/dist/semiotic-experimental.d.ts +1 -1
- package/dist/semiotic-experimental.min.js +1 -1
- package/dist/semiotic-experimental.module.min.js +1 -1
- package/dist/semiotic-geo.d.ts +4 -1
- package/dist/semiotic-network.d.ts +7 -4
- package/dist/semiotic-ordinal.d.ts +4 -1
- package/dist/semiotic-physics.d.ts +11 -4
- package/dist/semiotic-realtime-core.d.ts +11 -4
- package/dist/semiotic-realtime-core.min.js +2 -1
- package/dist/semiotic-realtime-core.module.min.js +2 -1
- package/dist/semiotic-realtime-react.d.ts +4 -3
- package/dist/semiotic-realtime-react.min.js +1 -1
- package/dist/semiotic-realtime-react.module.min.js +1 -1
- package/dist/semiotic-realtime.d.ts +3 -1
- package/dist/semiotic-recipes-core-cjs-base.min.js +1 -0
- package/dist/semiotic-recipes-core.d.ts +7 -5
- package/dist/semiotic-recipes-core.min.js +9 -1
- package/dist/semiotic-recipes-core.module.min.js +1 -1
- package/dist/semiotic-recipes-geo-cjs.min.js +1 -0
- package/dist/semiotic-recipes-react.min.js +1 -1
- package/dist/semiotic-recipes-react.module.min.js +1 -1
- package/dist/semiotic-recipes.min.js +7 -1
- package/dist/semiotic-recipes.module.min.js +2 -1
- package/dist/semiotic-server-edge-node.module.min.js +1 -0
- package/dist/semiotic-server-edge.d.ts +3 -2
- package/dist/semiotic-server-edge.min.js +1 -1
- package/dist/semiotic-server-edge.module.min.js +1 -1
- package/dist/semiotic-server-node.min.js +1 -1
- package/dist/semiotic-server-node.module.min.js +1 -1
- package/dist/semiotic-server.d.ts +3 -2
- package/dist/semiotic-themes-core.d.ts +5 -48
- package/dist/semiotic-themes-core.min.js +1 -1
- package/dist/semiotic-themes-core.module.min.js +1 -1
- package/dist/semiotic-themes-react.min.js +1 -1
- package/dist/semiotic-themes-react.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.d.ts +10 -5
- package/dist/semiotic-utils-core.min.js +1 -1
- package/dist/semiotic-utils-core.module.min.js +1 -1
- package/dist/semiotic-utils-react.d.ts +2 -0
- package/dist/semiotic-utils-react.min.js +1 -1
- package/dist/semiotic-utils-react.module.min.js +1 -1
- package/dist/semiotic-utils.d.ts +1 -1
- package/dist/semiotic-utils.min.js +2 -1
- package/dist/semiotic-utils.module.min.js +2 -1
- package/dist/semiotic-value.min.js +1 -1
- package/dist/semiotic-value.module.min.js +1 -1
- package/dist/semiotic-xy.d.ts +4 -1
- package/dist/semiotic.d.ts +68 -26
- package/dist/semiotic.min.js +1 -1
- package/dist/semiotic.module.min.js +1 -1
- package/dist/server.min.js +1 -1
- package/dist/server.module.min.js +1 -1
- package/dist/xy.min.js +1 -1
- package/dist/xy.module.min.js +1 -1
- package/package.json +53 -19
- package/dist/__tests__/scenarios/mcpProtocolTypes.d.ts +0 -20
- package/dist/chunk-OrdinalBrushOverlay-PXHQYDB2.module.min.js +0 -2
- package/dist/chunk-XYBrushOverlay-ECZJJLAJ.module.min.js +0 -1
- package/dist/chunk-XYBrushOverlay-EP2SV3UI.module.min.js +0 -2
- package/dist/chunk-chartContainerDataAudit-IQ3NBN3Q.module.min.js +0 -2
- package/dist/chunk-chunk-2B3AIKUZ.module.min.js +0 -2
- package/dist/chunk-chunk-2CXCXRB4.module.min.js +0 -1
- package/dist/chunk-chunk-2X3FJCME.module.min.js +0 -1
- package/dist/chunk-chunk-2ZHHWZQM.module.min.js +0 -2
- package/dist/chunk-chunk-4ITOQRXM.module.min.js +0 -2
- package/dist/chunk-chunk-5UKL5W76.module.min.js +0 -2
- package/dist/chunk-chunk-5VVNW5AZ.module.min.js +0 -1
- package/dist/chunk-chunk-5ZON5NMV.module.min.js +0 -2
- package/dist/chunk-chunk-66PCWJUG.module.min.js +0 -1
- package/dist/chunk-chunk-6S3YGYW7.module.min.js +0 -1
- package/dist/chunk-chunk-6V5VQVCT.module.min.js +0 -2
- package/dist/chunk-chunk-7C5EDZ3Z.module.min.js +0 -2
- package/dist/chunk-chunk-A3I4HBD5.module.min.js +0 -1
- package/dist/chunk-chunk-ACLDBMRH.module.min.js +0 -2
- package/dist/chunk-chunk-AFQHURLO.module.min.js +0 -2
- package/dist/chunk-chunk-DDB4TLQG.module.min.js +0 -2
- package/dist/chunk-chunk-DTH3SUOU.module.min.js +0 -2
- package/dist/chunk-chunk-DTSNLGRK.module.min.js +0 -2
- package/dist/chunk-chunk-DVCWU7MT.module.min.js +0 -2
- package/dist/chunk-chunk-FEPXDKJP.module.min.js +0 -1
- package/dist/chunk-chunk-FJ76HWQZ.module.min.js +0 -1
- package/dist/chunk-chunk-FSIHAW6L.module.min.js +0 -2
- package/dist/chunk-chunk-G2RGVEYY.module.min.js +0 -2
- package/dist/chunk-chunk-G75OPF5N.module.min.js +0 -2
- package/dist/chunk-chunk-HADHLMY5.module.min.js +0 -1
- package/dist/chunk-chunk-HAJVODLO.module.min.js +0 -2
- package/dist/chunk-chunk-HBFA4NN6.module.min.js +0 -1
- package/dist/chunk-chunk-HIV7AW2V.module.min.js +0 -2
- package/dist/chunk-chunk-IY7RYD4S.module.min.js +0 -1
- package/dist/chunk-chunk-J3QOW4OE.module.min.js +0 -0
- package/dist/chunk-chunk-J3XWETBJ.module.min.js +0 -2
- package/dist/chunk-chunk-JZAMMSQQ.module.min.js +0 -2
- package/dist/chunk-chunk-KTWEBFMX.module.min.js +0 -2
- package/dist/chunk-chunk-LSJUXBMF.module.min.js +0 -1
- package/dist/chunk-chunk-MXMRXSCI.module.min.js +0 -2
- package/dist/chunk-chunk-MXVBXFKW.module.min.js +0 -2
- package/dist/chunk-chunk-NWIGA3UK.module.min.js +0 -1
- package/dist/chunk-chunk-OFAP623Y.module.min.js +0 -2
- package/dist/chunk-chunk-OHLRAEQZ.module.min.js +0 -2
- package/dist/chunk-chunk-OZK46A5U.module.min.js +0 -1
- package/dist/chunk-chunk-PMR47KRY.module.min.js +0 -2
- package/dist/chunk-chunk-PRNXOCYZ.module.min.js +0 -2
- package/dist/chunk-chunk-Q2YADC2V.module.min.js +0 -2
- package/dist/chunk-chunk-RLKZVJMQ.module.min.js +0 -2
- package/dist/chunk-chunk-ROP4HI7H.module.min.js +0 -2
- package/dist/chunk-chunk-SK2TQMG4.module.min.js +0 -2
- package/dist/chunk-chunk-SKLYXNYW.module.min.js +0 -2
- package/dist/chunk-chunk-TCMHJWFJ.module.min.js +0 -1
- package/dist/chunk-chunk-TSCFL235.module.min.js +0 -1
- package/dist/chunk-chunk-U4NZCU5T.module.min.js +0 -2
- package/dist/chunk-chunk-U66USBWU.module.min.js +0 -1
- package/dist/chunk-chunk-UOQRPGPK.module.min.js +0 -2
- package/dist/chunk-chunk-VKL6DI43.module.min.js +0 -2
- package/dist/chunk-chunk-W62673ZE.module.min.js +0 -1
- package/dist/chunk-chunk-WFHZHWT7.module.min.js +0 -1
- package/dist/chunk-chunk-XCC25CZZ.module.min.js +0 -2
- package/dist/chunk-chunk-XECNOUZY.module.min.js +0 -2
- package/dist/chunk-chunk-XYZDTYAF.module.min.js +0 -2
- package/dist/chunk-chunk-YHNZCPOZ.module.min.js +0 -2
- package/dist/chunk-chunk-YWZB3KPI.module.min.js +0 -2
- package/dist/chunk-statisticalOverlays-HMYYSGPE.module.min.js +0 -2
- package/dist/components/stream/test-utils/frameScheduler.d.ts +0 -12
- package/dist/components/stream/test-utils/revisionConsumption.d.ts +0 -13
- package/dist/test-utils/canvasMock.d.ts +0 -86
- package/dist/test-utils/capturedFrameProps.d.ts +0 -67
- package/dist/test-utils/frameMock.d.ts +0 -81
- package/dist/test-utils/ordinalFixtures.d.ts +0 -48
- /package/dist/{chunk-chunk-JJ2OOIET.module.min.js → c-GGISSW5E.min.js} +0 -0
- /package/dist/{chunk-chunk-SIRIJ3DY.module.min.js → c-N4G2L7ID.min.js} +0 -0
- /package/dist/{chunk-chunk-CA3YDW6F.module.min.js → c-S6U5CGT5.min.js} +0 -0
- /package/dist/components/recipes/{mobileAnnotationStrategy.d.ts → mobileAnnotationBehavior.d.ts} +0 -0
|
@@ -5,6 +5,7 @@ import { type TooltipProp } from "../../Tooltip/Tooltip";
|
|
|
5
5
|
import type { Datum } from "../shared/datumTypes";
|
|
6
6
|
import type { BaseChartProps, ChartMode, LinkedHoverProp, SelectionConfig } from "../shared/types";
|
|
7
7
|
import { type ChartModeResult } from "../shared/hooks";
|
|
8
|
+
export { physicsMarginForMode } from "./physicsChartLayout";
|
|
8
9
|
export type PhysicsHocFrameProps<TOmitted extends keyof StreamPhysicsFrameProps = never> = Partial<Omit<StreamPhysicsFrameProps, "initialSpawns" | "initialSpawnPacing" | "size" | TOmitted>>;
|
|
9
10
|
/**
|
|
10
11
|
* Chrome / AI / annotation contracts HOCs forward to StreamPhysicsFrame.
|
|
@@ -86,13 +87,6 @@ export declare function resolvePhysicsModes(options: {
|
|
|
86
87
|
chartMode: ChartMode | undefined;
|
|
87
88
|
simulationMode: PhysicsSimulationMode;
|
|
88
89
|
};
|
|
89
|
-
/** Physics fills its box; only compact ChartModes get non-zero chrome padding. */
|
|
90
|
-
export declare function physicsMarginForMode(compactMode: boolean, mode?: ChartMode): {
|
|
91
|
-
top: number;
|
|
92
|
-
right: number;
|
|
93
|
-
bottom: number;
|
|
94
|
-
left: number;
|
|
95
|
-
};
|
|
96
90
|
export declare function resolvePhysicsChartSize(size: [number, number] | undefined, width: number | undefined, height: number | undefined, fallback: [number, number]): [number, number];
|
|
97
91
|
export type PhysicsChartModeProps = {
|
|
98
92
|
width?: number;
|
|
@@ -100,7 +94,7 @@ export type PhysicsChartModeProps = {
|
|
|
100
94
|
title?: string;
|
|
101
95
|
description?: string;
|
|
102
96
|
summary?: string;
|
|
103
|
-
accessibleTable?:
|
|
97
|
+
accessibleTable?: BaseChartProps["accessibleTable"];
|
|
104
98
|
/** Frame-level hover; HOCs may pass via tooltip or frameProps. */
|
|
105
99
|
enableHover?: boolean;
|
|
106
100
|
mobileInteraction?: BaseChartProps["mobileInteraction"];
|
|
@@ -109,6 +103,8 @@ export type PhysicsChartModeProps = {
|
|
|
109
103
|
mode?: ChartMode | PhysicsSimulationMode;
|
|
110
104
|
simulationMode?: PhysicsSimulationMode;
|
|
111
105
|
size?: [number, number];
|
|
106
|
+
responsiveWidth?: boolean;
|
|
107
|
+
responsiveHeight?: boolean;
|
|
112
108
|
showProjection?: boolean;
|
|
113
109
|
showChrome?: boolean;
|
|
114
110
|
tooltip?: TooltipProp;
|
|
@@ -119,6 +115,9 @@ export interface PhysicsChartModeResult {
|
|
|
119
115
|
simulationMode: PhysicsSimulationMode;
|
|
120
116
|
resolved: ChartModeResult;
|
|
121
117
|
chartSize: [number, number];
|
|
118
|
+
responsiveContainerRef: React.RefObject<HTMLDivElement | null>;
|
|
119
|
+
responsiveWidth: boolean;
|
|
120
|
+
responsiveHeight: boolean;
|
|
122
121
|
margin: {
|
|
123
122
|
top: number;
|
|
124
123
|
right: number;
|
|
@@ -131,7 +130,7 @@ export interface PhysicsChartModeResult {
|
|
|
131
130
|
title: string | undefined;
|
|
132
131
|
description: string | undefined;
|
|
133
132
|
summary: string | undefined;
|
|
134
|
-
accessibleTable:
|
|
133
|
+
accessibleTable: BaseChartProps["accessibleTable"];
|
|
135
134
|
className: string | undefined;
|
|
136
135
|
compactMode: boolean;
|
|
137
136
|
mobileInteraction: ChartModeResult["mobileInteraction"];
|
|
@@ -145,6 +144,18 @@ export interface PhysicsChartModeResult {
|
|
|
145
144
|
export declare function usePhysicsChartMode(props: PhysicsChartModeProps, primaryFallback: [number, number], options?: {
|
|
146
145
|
hasSimulationMode?: boolean;
|
|
147
146
|
}): PhysicsChartModeResult;
|
|
147
|
+
export interface PhysicsResponsiveSizeResult {
|
|
148
|
+
containerRef: React.RefObject<HTMLDivElement | null>;
|
|
149
|
+
size: [number, number];
|
|
150
|
+
responsiveWidth: boolean;
|
|
151
|
+
responsiveHeight: boolean;
|
|
152
|
+
}
|
|
153
|
+
/**
|
|
154
|
+
* Measure the host that owns a physics layout. Stock Physics HOCs use the
|
|
155
|
+
* resolved dimensions to rebuild bodies, colliders, projections, and chrome
|
|
156
|
+
* together instead of resizing only the child canvas.
|
|
157
|
+
*/
|
|
158
|
+
export declare function usePhysicsResponsiveSize(baseSize: [number, number], responsiveWidth?: boolean, responsiveHeight?: boolean): PhysicsResponsiveSizeResult;
|
|
148
159
|
export declare function renderPhysicsChartState<TDatum extends Datum>(options: {
|
|
149
160
|
data?: TDatum[] | null;
|
|
150
161
|
emptyContent?: BaseChartProps["emptyContent"];
|
|
@@ -152,9 +163,11 @@ export declare function renderPhysicsChartState<TDatum extends Datum>(options: {
|
|
|
152
163
|
loadingContent?: BaseChartProps["loadingContent"];
|
|
153
164
|
size: [number, number];
|
|
154
165
|
}): React.ReactElement | null;
|
|
155
|
-
export declare function renderPhysicsFrame(componentName: string, size: [number, number], children: React.ReactNode): React.ReactElement;
|
|
166
|
+
export declare function renderPhysicsFrame(componentName: string, size: [number, number], children: React.ReactNode, responsiveLayout?: Pick<PhysicsChartModeResult, "responsiveContainerRef" | "responsiveHeight" | "responsiveWidth">): React.ReactElement;
|
|
156
167
|
export declare function composePhysicsFrameGraphics(first: FrameGraphicsProp | undefined, second: FrameGraphicsProp | undefined): FrameGraphicsProp | undefined;
|
|
157
|
-
export declare function resolvePhysicsTooltipProps(tooltip: TooltipProp | undefined, frameProps?: Partial<StreamPhysicsFrameProps
|
|
168
|
+
export declare function resolvePhysicsTooltipProps(tooltip: TooltipProp | undefined, frameProps?: Partial<StreamPhysicsFrameProps>, options?: {
|
|
169
|
+
unwrapSourceDatum?: boolean;
|
|
170
|
+
}): Pick<StreamPhysicsFrameProps, "enableHover" | "tooltipContent">;
|
|
158
171
|
/**
|
|
159
172
|
* HOC → StreamPhysicsFrame shared Semiotic contracts: a11y, observation,
|
|
160
173
|
* click, chrome (title/legend/annotations), primitive styling, emphasis.
|
|
@@ -176,7 +189,7 @@ export declare function resolvePhysicsFrameSharedProps(props: Pick<BaseChartProp
|
|
|
176
189
|
title?: string;
|
|
177
190
|
description?: string;
|
|
178
191
|
summary?: string;
|
|
179
|
-
accessibleTable?:
|
|
192
|
+
accessibleTable?: BaseChartProps["accessibleTable"];
|
|
180
193
|
enableHover?: boolean;
|
|
181
194
|
margin?: StreamPhysicsFrameProps["margin"];
|
|
182
195
|
}): Partial<StreamPhysicsFrameProps>;
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
import * as React from "react";
|
|
2
|
+
import type { StreamPhysicsFrameProps } from "../../stream/physics/StreamPhysicsTypes";
|
|
3
|
+
import { type CollisionSwarmProjectionMetadata, type EventDropProjectionMetadata, type GaltonBoardProjectionMetadata } from "./physicsChartUtils";
|
|
4
|
+
type ValueProjectionRow = {
|
|
5
|
+
label: string;
|
|
6
|
+
value: number;
|
|
7
|
+
};
|
|
8
|
+
type EventProjectionRow = ValueProjectionRow & {
|
|
9
|
+
secondary?: number;
|
|
10
|
+
};
|
|
11
|
+
export interface GaltonBoardReferenceLine {
|
|
12
|
+
value: number;
|
|
13
|
+
label?: React.ReactNode;
|
|
14
|
+
color?: string;
|
|
15
|
+
className?: string;
|
|
16
|
+
strokeDasharray?: string;
|
|
17
|
+
strokeWidth?: number;
|
|
18
|
+
labelPosition?: "top" | "bottom";
|
|
19
|
+
}
|
|
20
|
+
export declare function galtonBoardOverlay(rows: ValueProjectionRow[], bins: number, enabled: boolean | undefined, metadata: GaltonBoardProjectionMetadata | undefined, referenceLines: GaltonBoardReferenceLine | GaltonBoardReferenceLine[] | undefined): StreamPhysicsFrameProps["foregroundGraphics"] | undefined;
|
|
21
|
+
export declare function eventDropOverlay(rows: EventProjectionRow[], metadata: EventDropProjectionMetadata | undefined, enabled: boolean | undefined): StreamPhysicsFrameProps["foregroundGraphics"] | undefined;
|
|
22
|
+
export declare function pileProjectionOverlay(rows: ValueProjectionRow[], ballRadius: number, enabled: boolean | undefined): StreamPhysicsFrameProps["foregroundGraphics"] | undefined;
|
|
23
|
+
export declare function collisionSwarmProjectionOverlay(metadata: CollisionSwarmProjectionMetadata | undefined, enabled: boolean | undefined): StreamPhysicsFrameProps["foregroundGraphics"] | undefined;
|
|
24
|
+
export {};
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
import type { CapacityQueueSnapshot } from "../../stream/physics/PhysicsControllers";
|
|
2
|
+
import type { StreamPhysicsFrameProps } from "../../stream/physics/StreamPhysicsTypes";
|
|
3
|
+
import { type ProcessChromeOptions } from "../../recipes/processChrome";
|
|
4
|
+
import { type ProcessFlowProjectionMetadata } from "./physicsChartUtils";
|
|
5
|
+
export declare function processFlowChrome(metadata: ProcessFlowProjectionMetadata | undefined, enabled: boolean | undefined, capacityByRegion?: Record<string, CapacityQueueSnapshot>, chromeOptions?: ProcessChromeOptions): StreamPhysicsFrameProps["backgroundGraphics"] | undefined;
|
|
6
|
+
export declare function processFlowProjectionOverlay(rows: Array<{
|
|
7
|
+
label: string;
|
|
8
|
+
value: number;
|
|
9
|
+
}>, metadata: ProcessFlowProjectionMetadata | undefined, enabled: boolean | undefined): StreamPhysicsFrameProps["foregroundGraphics"] | undefined;
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import * as React from "react";
|
|
2
2
|
import type { ArrowOfTime, WindowMode, HoverAnnotationConfig, HoverData, AnnotationContext, DecayConfig, PulseConfig, StalenessConfig } from "../../stream/types";
|
|
3
3
|
import type { RealtimeFrameHandle } from "../../realtime/types";
|
|
4
|
-
import type { ReactNode } from "react";
|
|
4
|
+
import type { CSSProperties, ReactNode } from "react";
|
|
5
5
|
import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
|
|
6
6
|
import type { ChartMode, ChartAccessor, SelectionConfig, MobileInteractionProp } from "../shared/types";
|
|
7
7
|
import type { OnObservationCallback } from "../../store/ObservationStore";
|
|
@@ -9,7 +9,9 @@ import type { Datum } from "../shared/datumTypes";
|
|
|
9
9
|
import type { AutoPlaceAnnotations } from "../../recipes/annotationLayout";
|
|
10
10
|
import type { MobileVisualizationContract } from "../shared/auditMobileVisualization";
|
|
11
11
|
import type { ResponsiveRule } from "../shared/responsiveRules";
|
|
12
|
-
|
|
12
|
+
import type { RealtimeAccessibilityProps, RealtimeData, RealtimePointIdAccessor, RealtimeTooltipProp } from "./realtimeChartTypes";
|
|
13
|
+
import type { PartialMargin } from "../../types/marginType";
|
|
14
|
+
export interface RealtimeHeatmapProps<TDatum extends Datum = Datum> extends RealtimeAccessibilityProps {
|
|
13
15
|
/** Display mode: "primary" (full chrome), "context" (compact), "sparkline" (inline) */
|
|
14
16
|
mode?: ChartMode;
|
|
15
17
|
/** Semantic responsive transformations applied before chart-mode defaults. */
|
|
@@ -27,12 +29,7 @@ export interface RealtimeHeatmapProps<TDatum extends Datum = Datum> {
|
|
|
27
29
|
/** Maximum canvas backing-store DPR; defaults to the environment cap. */
|
|
28
30
|
maxDevicePixelRatio?: number;
|
|
29
31
|
/** Chart margins */
|
|
30
|
-
margin?:
|
|
31
|
-
top?: number;
|
|
32
|
-
right?: number;
|
|
33
|
-
bottom?: number;
|
|
34
|
-
left?: number;
|
|
35
|
-
};
|
|
32
|
+
margin?: PartialMargin;
|
|
36
33
|
/** CSS class name */
|
|
37
34
|
className?: string;
|
|
38
35
|
onObservation?: OnObservationCallback;
|
|
@@ -44,7 +41,7 @@ export interface RealtimeHeatmapProps<TDatum extends Datum = Datum> {
|
|
|
44
41
|
/** Ring buffer capacity */
|
|
45
42
|
windowSize?: number;
|
|
46
43
|
/** Controlled data array */
|
|
47
|
-
data?:
|
|
44
|
+
data?: RealtimeData<TDatum>;
|
|
48
45
|
/** Time/x value accessor */
|
|
49
46
|
timeAccessor?: ChartAccessor<TDatum, number>;
|
|
50
47
|
/** Value/y accessor */
|
|
@@ -63,6 +60,12 @@ export interface RealtimeHeatmapProps<TDatum extends Datum = Datum> {
|
|
|
63
60
|
heatmapYBins?: number;
|
|
64
61
|
/** Aggregation mode: "count", "sum", or "mean" (default: "count") */
|
|
65
62
|
aggregation?: "count" | "sum" | "mean";
|
|
63
|
+
/** Sequential color scheme for aggregated cell values. */
|
|
64
|
+
colorScheme?: "blues" | "reds" | "greens" | "viridis" | "oranges" | "purples" | "greys" | "plasma" | "inferno" | "magma" | "cividis" | "turbo" | "custom" | (string & {});
|
|
65
|
+
/** Custom value-to-color function used when colorScheme is "custom". */
|
|
66
|
+
customColorScale?: (value: number) => string;
|
|
67
|
+
/** Presentation-only CSS cursor for retained marks; does not add click, keyboard, or observation behavior. */
|
|
68
|
+
cursor?: CSSProperties["cursor"];
|
|
66
69
|
/** Show canvas-drawn axes */
|
|
67
70
|
showAxes?: boolean;
|
|
68
71
|
/** Background fill color */
|
|
@@ -89,8 +92,8 @@ export interface RealtimeHeatmapProps<TDatum extends Datum = Datum> {
|
|
|
89
92
|
pulse?: PulseConfig;
|
|
90
93
|
/** Frame-level data liveness indicator */
|
|
91
94
|
staleness?: StalenessConfig;
|
|
92
|
-
/**
|
|
93
|
-
tooltip?:
|
|
95
|
+
/** Declarative tooltip config or the legacy full-HoverData callback. */
|
|
96
|
+
tooltip?: RealtimeTooltipProp;
|
|
94
97
|
/** Enable linked hover selection events for cross-chart highlighting */
|
|
95
98
|
linkedHover?: boolean | string | {
|
|
96
99
|
name?: string;
|
|
@@ -113,7 +116,7 @@ export interface RealtimeHeatmapProps<TDatum extends Datum = Datum> {
|
|
|
113
116
|
/** Legend interaction mode */
|
|
114
117
|
legendInteraction?: LegendInteractionMode;
|
|
115
118
|
/** ID accessor for remove()/update() on the push API */
|
|
116
|
-
pointIdAccessor?:
|
|
119
|
+
pointIdAccessor?: RealtimePointIdAccessor<TDatum>;
|
|
117
120
|
}
|
|
118
121
|
/**
|
|
119
122
|
* RealtimeHeatmap - Streaming heatmap with 2D grid binning.
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import * as React from "react";
|
|
2
2
|
import type { ArrowOfTime, WindowMode, HoverAnnotationConfig, HoverData, AnnotationContext, DecayConfig, PulseConfig, StalenessConfig, TransitionConfig } from "../../stream/types";
|
|
3
3
|
import type { RealtimeFrameHandle } from "../../realtime/types";
|
|
4
|
-
import type { ReactNode } from "react";
|
|
4
|
+
import type { CSSProperties, ReactNode } from "react";
|
|
5
5
|
import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
|
|
6
6
|
import type { ChartMode, ChartAccessor, SelectionConfig, MobileInteractionProp } from "../shared/types";
|
|
7
7
|
import type { OnObservationCallback } from "../../store/ObservationStore";
|
|
@@ -11,8 +11,9 @@ import type { MobileVisualizationContract } from "../shared/auditMobileVisualiza
|
|
|
11
11
|
import type { ResponsiveRule } from "../shared/responsiveRules";
|
|
12
12
|
import type { LegendValue } from "../../types/legendTypes";
|
|
13
13
|
import type { PartialMargin } from "../../types/marginType";
|
|
14
|
+
import type { RealtimeAccessibilityProps, RealtimeData, RealtimePointIdAccessor, RealtimeTooltipProp } from "./realtimeChartTypes";
|
|
14
15
|
export type RealtimeHistogramDirection = "up" | "down";
|
|
15
|
-
export interface RealtimeHistogramProps<TDatum extends Datum = Datum> {
|
|
16
|
+
export interface RealtimeHistogramProps<TDatum extends Datum = Datum> extends RealtimeAccessibilityProps {
|
|
16
17
|
/** Display mode: "primary" (full chrome), "context" (compact), "sparkline" (inline) */
|
|
17
18
|
mode?: ChartMode;
|
|
18
19
|
/** Semantic responsive transformations applied before chart-mode defaults. */
|
|
@@ -44,7 +45,7 @@ export interface RealtimeHistogramProps<TDatum extends Datum = Datum> {
|
|
|
44
45
|
/** Ring buffer capacity */
|
|
45
46
|
windowSize?: number;
|
|
46
47
|
/** Controlled data array */
|
|
47
|
-
data?:
|
|
48
|
+
data?: RealtimeData<TDatum>;
|
|
48
49
|
/** Time value accessor */
|
|
49
50
|
timeAccessor?: ChartAccessor<TDatum, number>;
|
|
50
51
|
/** Value accessor */
|
|
@@ -73,7 +74,7 @@ export interface RealtimeHistogramProps<TDatum extends Datum = Datum> {
|
|
|
73
74
|
* Keys also determine stack order (listed keys first, then alphabetical).
|
|
74
75
|
*/
|
|
75
76
|
colors?: Record<string, string>;
|
|
76
|
-
/** Bar fill color
|
|
77
|
+
/** Bar fill color, or fallback for categories missing from `colors`. */
|
|
77
78
|
fill?: string;
|
|
78
79
|
/** Bar stroke color */
|
|
79
80
|
stroke?: string;
|
|
@@ -81,6 +82,8 @@ export interface RealtimeHistogramProps<TDatum extends Datum = Datum> {
|
|
|
81
82
|
strokeWidth?: number;
|
|
82
83
|
/** Uniform bar opacity (0–1). Pairs with `color` / `stroke` / `strokeWidth` for the designer-facing primitive vocabulary. */
|
|
83
84
|
opacity?: number;
|
|
85
|
+
/** Presentation-only CSS cursor for retained marks; does not add click, keyboard, or observation behavior. */
|
|
86
|
+
cursor?: CSSProperties["cursor"];
|
|
84
87
|
/** Gap between bars in pixels */
|
|
85
88
|
gap?: number;
|
|
86
89
|
/** Show canvas-drawn axes */
|
|
@@ -103,8 +106,8 @@ export interface RealtimeHistogramProps<TDatum extends Datum = Datum> {
|
|
|
103
106
|
tickFormatTime?: (value: number) => string;
|
|
104
107
|
/** Custom formatter for value axis ticks */
|
|
105
108
|
tickFormatValue?: (value: number) => string;
|
|
106
|
-
/**
|
|
107
|
-
tooltip?:
|
|
109
|
+
/** Declarative tooltip config or the legacy full-HoverData callback. */
|
|
110
|
+
tooltip?: RealtimeTooltipProp;
|
|
108
111
|
/** Enable linked hover selection events for cross-chart highlighting */
|
|
109
112
|
linkedHover?: boolean | string | {
|
|
110
113
|
name?: string;
|
|
@@ -157,7 +160,7 @@ export interface RealtimeHistogramProps<TDatum extends Datum = Datum> {
|
|
|
157
160
|
/** Legend interaction mode */
|
|
158
161
|
legendInteraction?: LegendInteractionMode;
|
|
159
162
|
/** ID accessor for remove()/update() on the push API */
|
|
160
|
-
pointIdAccessor?:
|
|
163
|
+
pointIdAccessor?: RealtimePointIdAccessor<TDatum>;
|
|
161
164
|
}
|
|
162
165
|
/**
|
|
163
166
|
* RealtimeHistogram - Streaming temporal histogram.
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import * as React from "react";
|
|
2
2
|
import type { ArrowOfTime, WindowMode, HoverAnnotationConfig, HoverData, AnnotationContext, DecayConfig, PulseConfig, StalenessConfig, TransitionConfig } from "../../stream/types";
|
|
3
3
|
import type { RealtimeFrameHandle } from "../../realtime/types";
|
|
4
|
-
import type { ReactNode } from "react";
|
|
4
|
+
import type { CSSProperties, ReactNode } from "react";
|
|
5
5
|
import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
|
|
6
6
|
import type { ChartMode, ChartAccessor, SelectionConfig, MobileInteractionProp } from "../shared/types";
|
|
7
7
|
import type { OnObservationCallback } from "../../store/ObservationStore";
|
|
@@ -11,7 +11,23 @@ import type { MobileVisualizationContract } from "../shared/auditMobileVisualiza
|
|
|
11
11
|
import type { ResponsiveRule } from "../shared/responsiveRules";
|
|
12
12
|
import { type AggregateConfig } from "./aggregate";
|
|
13
13
|
import { type EventTimeConfig } from "./eventTime";
|
|
14
|
-
|
|
14
|
+
import type { RealtimeAccessibilityProps, RealtimeData, RealtimePointIdAccessor, RealtimeTooltipProp } from "./realtimeChartTypes";
|
|
15
|
+
import type { PartialMargin } from "../../types/marginType";
|
|
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 extends RealtimeFrameHandle {
|
|
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 {
|
|
15
31
|
/** Display mode: "primary" (full chrome), "context" (compact), "sparkline" (inline) */
|
|
16
32
|
mode?: ChartMode;
|
|
17
33
|
/** Semantic responsive transformations applied before chart-mode defaults. */
|
|
@@ -29,12 +45,7 @@ export interface RealtimeLineChartProps<TDatum extends Datum = Datum> {
|
|
|
29
45
|
/** Maximum canvas backing-store DPR; defaults to the environment cap. */
|
|
30
46
|
maxDevicePixelRatio?: number;
|
|
31
47
|
/** Chart margins */
|
|
32
|
-
margin?:
|
|
33
|
-
top?: number;
|
|
34
|
-
right?: number;
|
|
35
|
-
bottom?: number;
|
|
36
|
-
left?: number;
|
|
37
|
-
};
|
|
48
|
+
margin?: PartialMargin;
|
|
38
49
|
/** CSS class name */
|
|
39
50
|
className?: string;
|
|
40
51
|
onObservation?: OnObservationCallback;
|
|
@@ -46,7 +57,7 @@ export interface RealtimeLineChartProps<TDatum extends Datum = Datum> {
|
|
|
46
57
|
/** Ring buffer capacity */
|
|
47
58
|
windowSize?: number;
|
|
48
59
|
/** Controlled data array */
|
|
49
|
-
data?:
|
|
60
|
+
data?: RealtimeData<TDatum>;
|
|
50
61
|
/** Time value accessor */
|
|
51
62
|
timeAccessor?: ChartAccessor<TDatum, number>;
|
|
52
63
|
/** Value accessor */
|
|
@@ -65,6 +76,8 @@ export interface RealtimeLineChartProps<TDatum extends Datum = Datum> {
|
|
|
65
76
|
strokeDasharray?: string;
|
|
66
77
|
/** Uniform line opacity (0–1). Pairs with `stroke` / `strokeWidth` for the designer-facing primitive vocabulary. */
|
|
67
78
|
opacity?: number;
|
|
79
|
+
/** Presentation-only CSS cursor for retained marks; does not add click, keyboard, or observation behavior. */
|
|
80
|
+
cursor?: CSSProperties["cursor"];
|
|
68
81
|
/** Show canvas-drawn axes */
|
|
69
82
|
showAxes?: boolean;
|
|
70
83
|
/** Background fill color */
|
|
@@ -85,8 +98,8 @@ export interface RealtimeLineChartProps<TDatum extends Datum = Datum> {
|
|
|
85
98
|
tickFormatTime?: (value: number) => string;
|
|
86
99
|
/** Custom formatter for value axis ticks */
|
|
87
100
|
tickFormatValue?: (value: number) => string;
|
|
88
|
-
/**
|
|
89
|
-
tooltip?:
|
|
101
|
+
/** Declarative tooltip config or the legacy full-HoverData callback. Pass `"multi"` for hover-anywhere line values. */
|
|
102
|
+
tooltip?: RealtimeTooltipProp;
|
|
90
103
|
/** Configurable opacity decay for older data */
|
|
91
104
|
decay?: DecayConfig;
|
|
92
105
|
/** Flash effect on newly inserted data */
|
|
@@ -117,14 +130,17 @@ export interface RealtimeLineChartProps<TDatum extends Datum = Datum> {
|
|
|
117
130
|
/** Legend interaction mode */
|
|
118
131
|
legendInteraction?: LegendInteractionMode;
|
|
119
132
|
/** ID accessor for remove()/update() on the push API */
|
|
120
|
-
pointIdAccessor?:
|
|
133
|
+
pointIdAccessor?: RealtimePointIdAccessor<TDatum>;
|
|
121
134
|
/**
|
|
122
135
|
* Opt-in windowed aggregation over event-time. When set, pushed
|
|
123
136
|
* events are reduced into tumbling/hopping/session windows and the
|
|
124
137
|
* chart draws one mark per window (mean/sum/min/max/count) plus an
|
|
125
138
|
* optional ±σ or min–max band — render cost scales with the number of
|
|
126
139
|
* visible windows, not the arrival rate. This is the **aggregation
|
|
127
|
-
* window**, distinct from `windowMode`'s RingBuffer eviction.
|
|
140
|
+
* window**, distinct from `windowMode`'s RingBuffer eviction. Changing a
|
|
141
|
+
* structural window field or either accessor rebuilds the accumulator:
|
|
142
|
+
* controlled `data` is reseeded, while push-only input begins a new epoch
|
|
143
|
+
* because raw events are deliberately not retained.
|
|
128
144
|
*/
|
|
129
145
|
aggregate?: AggregateConfig;
|
|
130
146
|
/**
|
|
@@ -134,7 +150,9 @@ export interface RealtimeLineChartProps<TDatum extends Datum = Datum> {
|
|
|
134
150
|
* monotonically instead of zigzagging. Late events (older than
|
|
135
151
|
* `watermark − lateness`) are dropped or kept per policy and surfaced
|
|
136
152
|
* via `onObservation` as `"late-data"`. Default-off; when unset the
|
|
137
|
-
* push path is byte-for-byte unchanged.
|
|
153
|
+
* push path is byte-for-byte unchanged. Call `ref.current.flush()` at an
|
|
154
|
+
* asserted end-of-stream boundary so the final grace-window events are
|
|
155
|
+
* released in order.
|
|
138
156
|
*/
|
|
139
157
|
eventTime?: EventTimeConfig;
|
|
140
158
|
}
|
|
@@ -179,6 +197,9 @@ export interface RealtimeLineChartProps<TDatum extends Datum = Datum> {
|
|
|
179
197
|
* ```
|
|
180
198
|
*/
|
|
181
199
|
export declare const RealtimeLineChart: {
|
|
200
|
+
/** Compatibility overload for refs authored against the shared 3.x handle. */
|
|
182
201
|
<TDatum extends Datum = Datum>(props: RealtimeLineChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
|
|
202
|
+
/** Specific overload keeps ElementRef/ComponentRef aware of flush(). */
|
|
203
|
+
<TDatum extends Datum = Datum>(props: RealtimeLineChartProps<TDatum> & React.RefAttributes<RealtimeLineChartHandle>): React.ReactElement | null;
|
|
183
204
|
displayName?: string;
|
|
184
205
|
};
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import * as React from "react";
|
|
2
|
-
import type { ArrowOfTime, WindowMode, Style, HoverAnnotationConfig, HoverData, AnnotationContext } from "../../stream/types";
|
|
2
|
+
import type { ArrowOfTime, WindowMode, Style, HoverAnnotationConfig, HoverData, AnnotationContext, DecayConfig, PulseConfig, StalenessConfig, TransitionConfig } from "../../stream/types";
|
|
3
3
|
import type { RealtimeFrameHandle } from "../../realtime/types";
|
|
4
|
-
import type { ReactNode } from "react";
|
|
4
|
+
import type { CSSProperties, ReactNode } from "react";
|
|
5
5
|
import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
|
|
6
6
|
import type { ChartMode, ChartAccessor, SelectionConfig, MobileInteractionProp } from "../shared/types";
|
|
7
7
|
import type { OnObservationCallback } from "../../store/ObservationStore";
|
|
@@ -9,7 +9,9 @@ import type { Datum } from "../shared/datumTypes";
|
|
|
9
9
|
import type { AutoPlaceAnnotations } from "../../recipes/annotationLayout";
|
|
10
10
|
import type { MobileVisualizationContract } from "../shared/auditMobileVisualization";
|
|
11
11
|
import type { ResponsiveRule } from "../shared/responsiveRules";
|
|
12
|
-
|
|
12
|
+
import type { RealtimeAccessibilityProps, RealtimeData, RealtimePointIdAccessor, RealtimeTooltipProp } from "./realtimeChartTypes";
|
|
13
|
+
import type { PartialMargin } from "../../types/marginType";
|
|
14
|
+
export interface RealtimeSwarmChartProps<TDatum extends Datum = Datum> extends RealtimeAccessibilityProps {
|
|
13
15
|
/** Display mode: "primary" (full chrome), "context" (compact), "sparkline" (inline) */
|
|
14
16
|
mode?: ChartMode;
|
|
15
17
|
/** Semantic responsive transformations applied before chart-mode defaults. */
|
|
@@ -27,12 +29,7 @@ export interface RealtimeSwarmChartProps<TDatum extends Datum = Datum> {
|
|
|
27
29
|
/** Maximum canvas backing-store DPR; defaults to the environment cap. */
|
|
28
30
|
maxDevicePixelRatio?: number;
|
|
29
31
|
/** Chart margins */
|
|
30
|
-
margin?:
|
|
31
|
-
top?: number;
|
|
32
|
-
right?: number;
|
|
33
|
-
bottom?: number;
|
|
34
|
-
left?: number;
|
|
35
|
-
};
|
|
32
|
+
margin?: PartialMargin;
|
|
36
33
|
/** CSS class name */
|
|
37
34
|
className?: string;
|
|
38
35
|
onObservation?: OnObservationCallback;
|
|
@@ -44,7 +41,7 @@ export interface RealtimeSwarmChartProps<TDatum extends Datum = Datum> {
|
|
|
44
41
|
/** Ring buffer capacity */
|
|
45
42
|
windowSize?: number;
|
|
46
43
|
/** Controlled data array */
|
|
47
|
-
data?:
|
|
44
|
+
data?: RealtimeData<TDatum>;
|
|
48
45
|
/** Time value accessor */
|
|
49
46
|
timeAccessor?: ChartAccessor<TDatum, number>;
|
|
50
47
|
/** Value accessor */
|
|
@@ -57,13 +54,21 @@ export interface RealtimeSwarmChartProps<TDatum extends Datum = Datum> {
|
|
|
57
54
|
yScaleType?: "linear" | "log" | "symlog";
|
|
58
55
|
/** Extent padding factor */
|
|
59
56
|
extentPadding?: number;
|
|
57
|
+
/** Age-based opacity decay for streaming marks. */
|
|
58
|
+
decay?: DecayConfig;
|
|
59
|
+
/** Arrival pulse for newly pushed marks. */
|
|
60
|
+
pulse?: PulseConfig;
|
|
61
|
+
/** Dim or badge stale streaming values. */
|
|
62
|
+
staleness?: StalenessConfig;
|
|
63
|
+
/** Mark transition configuration. */
|
|
64
|
+
transition?: TransitionConfig;
|
|
60
65
|
/** Category accessor for color-coding dots */
|
|
61
66
|
categoryAccessor?: ChartAccessor<TDatum, string>;
|
|
62
67
|
/** Category-to-color map */
|
|
63
68
|
colors?: Record<string, string>;
|
|
64
69
|
/** Dot radius */
|
|
65
70
|
radius?: number;
|
|
66
|
-
/** Dot fill color
|
|
71
|
+
/** Dot fill color, or fallback for categories missing from `colors`. */
|
|
67
72
|
fill?: string;
|
|
68
73
|
/** Dot opacity */
|
|
69
74
|
opacity?: number;
|
|
@@ -71,6 +76,8 @@ export interface RealtimeSwarmChartProps<TDatum extends Datum = Datum> {
|
|
|
71
76
|
stroke?: string;
|
|
72
77
|
/** Dot stroke width */
|
|
73
78
|
strokeWidth?: number;
|
|
79
|
+
/** Presentation-only CSS cursor for retained marks; does not add click, keyboard, or observation behavior. */
|
|
80
|
+
cursor?: CSSProperties["cursor"];
|
|
74
81
|
/** Per-datum dot style. Returned values override the top-level dot primitives and category color. */
|
|
75
82
|
pointStyle?: (datum: TDatum) => Style & {
|
|
76
83
|
r?: number;
|
|
@@ -95,8 +102,8 @@ export interface RealtimeSwarmChartProps<TDatum extends Datum = Datum> {
|
|
|
95
102
|
tickFormatTime?: (value: number) => string;
|
|
96
103
|
/** Custom formatter for value axis ticks */
|
|
97
104
|
tickFormatValue?: (value: number) => string;
|
|
98
|
-
/**
|
|
99
|
-
tooltip?:
|
|
105
|
+
/** Declarative tooltip config or the legacy full-HoverData callback. */
|
|
106
|
+
tooltip?: RealtimeTooltipProp;
|
|
100
107
|
/** Enable linked hover selection events for cross-chart highlighting */
|
|
101
108
|
linkedHover?: boolean | string | {
|
|
102
109
|
name?: string;
|
|
@@ -119,7 +126,7 @@ export interface RealtimeSwarmChartProps<TDatum extends Datum = Datum> {
|
|
|
119
126
|
/** Legend interaction mode */
|
|
120
127
|
legendInteraction?: LegendInteractionMode;
|
|
121
128
|
/** ID accessor for remove()/update() on the push API */
|
|
122
|
-
pointIdAccessor?:
|
|
129
|
+
pointIdAccessor?: RealtimePointIdAccessor<TDatum>;
|
|
123
130
|
}
|
|
124
131
|
/**
|
|
125
132
|
* RealtimeSwarmChart - Simplified wrapper for streaming dot/swarm charts.
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import * as React from "react";
|
|
2
|
-
import type { ArrowOfTime, WindowMode, HoverAnnotationConfig, HoverData, AnnotationContext } from "../../stream/types";
|
|
2
|
+
import type { ArrowOfTime, WindowMode, HoverAnnotationConfig, HoverData, AnnotationContext, DecayConfig, PulseConfig, StalenessConfig, TransitionConfig } from "../../stream/types";
|
|
3
3
|
import type { RealtimeFrameHandle } from "../../realtime/types";
|
|
4
|
-
import type { ReactNode } from "react";
|
|
4
|
+
import type { CSSProperties, ReactNode } from "react";
|
|
5
5
|
import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
|
|
6
6
|
import type { ChartMode, ChartAccessor, SelectionConfig, MobileInteractionProp } from "../shared/types";
|
|
7
7
|
import type { OnObservationCallback } from "../../store/ObservationStore";
|
|
@@ -9,7 +9,9 @@ import type { Datum } from "../shared/datumTypes";
|
|
|
9
9
|
import type { AutoPlaceAnnotations } from "../../recipes/annotationLayout";
|
|
10
10
|
import type { MobileVisualizationContract } from "../shared/auditMobileVisualization";
|
|
11
11
|
import type { ResponsiveRule } from "../shared/responsiveRules";
|
|
12
|
-
|
|
12
|
+
import type { RealtimeAccessibilityProps, RealtimeData, RealtimePointIdAccessor, RealtimeTooltipProp } from "./realtimeChartTypes";
|
|
13
|
+
import type { PartialMargin } from "../../types/marginType";
|
|
14
|
+
export interface RealtimeWaterfallChartProps<TDatum extends Datum = Datum> extends RealtimeAccessibilityProps {
|
|
13
15
|
/** Display mode: "primary" (full chrome), "context" (compact), "sparkline" (inline) */
|
|
14
16
|
mode?: ChartMode;
|
|
15
17
|
/** Semantic responsive transformations applied before chart-mode defaults. */
|
|
@@ -27,12 +29,7 @@ export interface RealtimeWaterfallChartProps<TDatum extends Datum = Datum> {
|
|
|
27
29
|
/** Maximum canvas backing-store DPR; defaults to the environment cap. */
|
|
28
30
|
maxDevicePixelRatio?: number;
|
|
29
31
|
/** Chart margins */
|
|
30
|
-
margin?:
|
|
31
|
-
top?: number;
|
|
32
|
-
right?: number;
|
|
33
|
-
bottom?: number;
|
|
34
|
-
left?: number;
|
|
35
|
-
};
|
|
32
|
+
margin?: PartialMargin;
|
|
36
33
|
/** CSS class name */
|
|
37
34
|
className?: string;
|
|
38
35
|
onObservation?: OnObservationCallback;
|
|
@@ -44,7 +41,7 @@ export interface RealtimeWaterfallChartProps<TDatum extends Datum = Datum> {
|
|
|
44
41
|
/** Ring buffer capacity */
|
|
45
42
|
windowSize?: number;
|
|
46
43
|
/** Controlled data array */
|
|
47
|
-
data?:
|
|
44
|
+
data?: RealtimeData<TDatum>;
|
|
48
45
|
/** Time value accessor */
|
|
49
46
|
timeAccessor?: ChartAccessor<TDatum, number>;
|
|
50
47
|
/** Value accessor (positive = gain, negative = loss) */
|
|
@@ -55,6 +52,14 @@ export interface RealtimeWaterfallChartProps<TDatum extends Datum = Datum> {
|
|
|
55
52
|
valueExtent?: [number, number];
|
|
56
53
|
/** Extent padding factor */
|
|
57
54
|
extentPadding?: number;
|
|
55
|
+
/** Age-based opacity decay for streaming bars. */
|
|
56
|
+
decay?: DecayConfig;
|
|
57
|
+
/** Arrival pulse for newly pushed bars. */
|
|
58
|
+
pulse?: PulseConfig;
|
|
59
|
+
/** Dim or badge stale streaming values. */
|
|
60
|
+
staleness?: StalenessConfig;
|
|
61
|
+
/** Mark transition configuration. */
|
|
62
|
+
transition?: TransitionConfig;
|
|
58
63
|
/** Color for positive (gain) bars */
|
|
59
64
|
positiveColor?: string;
|
|
60
65
|
/** Color for negative (loss) bars */
|
|
@@ -71,6 +76,8 @@ export interface RealtimeWaterfallChartProps<TDatum extends Datum = Datum> {
|
|
|
71
76
|
strokeWidth?: number;
|
|
72
77
|
/** Uniform bar opacity (0–1). */
|
|
73
78
|
opacity?: number;
|
|
79
|
+
/** Presentation-only CSS cursor for retained marks; does not add click, keyboard, or observation behavior. */
|
|
80
|
+
cursor?: CSSProperties["cursor"];
|
|
74
81
|
/** Show canvas-drawn axes */
|
|
75
82
|
showAxes?: boolean;
|
|
76
83
|
/** Background fill color */
|
|
@@ -91,8 +98,8 @@ export interface RealtimeWaterfallChartProps<TDatum extends Datum = Datum> {
|
|
|
91
98
|
tickFormatTime?: (value: number) => string;
|
|
92
99
|
/** Custom formatter for value axis ticks */
|
|
93
100
|
tickFormatValue?: (value: number) => string;
|
|
94
|
-
/**
|
|
95
|
-
tooltip?:
|
|
101
|
+
/** Declarative tooltip config or the legacy full-HoverData callback. */
|
|
102
|
+
tooltip?: RealtimeTooltipProp;
|
|
96
103
|
/** Enable linked hover selection events for cross-chart highlighting */
|
|
97
104
|
linkedHover?: boolean | string | {
|
|
98
105
|
name?: string;
|
|
@@ -115,7 +122,7 @@ export interface RealtimeWaterfallChartProps<TDatum extends Datum = Datum> {
|
|
|
115
122
|
/** Legend interaction mode */
|
|
116
123
|
legendInteraction?: LegendInteractionMode;
|
|
117
124
|
/** ID accessor for remove()/update() on the push API */
|
|
118
|
-
pointIdAccessor?:
|
|
125
|
+
pointIdAccessor?: RealtimePointIdAccessor<TDatum>;
|
|
119
126
|
}
|
|
120
127
|
/**
|
|
121
128
|
* RealtimeWaterfallChart - Simplified wrapper for streaming waterfall charts.
|
|
@@ -5,7 +5,10 @@ import type { Datum } from "../shared/datumTypes";
|
|
|
5
5
|
* set, pushed events are reduced into event-time windows and the chart
|
|
6
6
|
* draws one mark per window (mean / sum / min / max / count) plus an
|
|
7
7
|
* optional ±σ or min–max envelope — bounded render cost regardless of
|
|
8
|
-
* arrival rate.
|
|
8
|
+
* arrival rate. Structural window changes start a new accumulator epoch:
|
|
9
|
+
* controlled `data` is replayed, while push-only history resets because the
|
|
10
|
+
* transform intentionally does not retain every raw event. `stat`, `band`,
|
|
11
|
+
* and `sigma` are readout-only and update existing windows in place.
|
|
9
12
|
*/
|
|
10
13
|
export interface AggregateConfig {
|
|
11
14
|
/** Window kind. @default "tumbling" */
|
|
@@ -4,6 +4,10 @@ import type { Datum } from "../shared/datumTypes";
|
|
|
4
4
|
* Opt-in event-time ingestion for realtime XY charts. Reorders pushed
|
|
5
5
|
* events within a bounded grace window so out-of-order arrivals render
|
|
6
6
|
* in event-time order, at the cost of delaying display by `lateness`.
|
|
7
|
+
* RealtimeLineChart's chart-specific handle exposes `flush()` to release
|
|
8
|
+
* the final grace-window tail at an asserted end-of-stream boundary. A live
|
|
9
|
+
* config or time-accessor change drains the prior tail before the new policy
|
|
10
|
+
* begins, rather than abandoning buffered events.
|
|
7
11
|
*/
|
|
8
12
|
export interface EventTimeConfig {
|
|
9
13
|
/**
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
import * as React from "react";
|
|
2
|
+
import type { RealtimeFrameHandle } from "../../realtime/types";
|
|
3
|
+
import type { StreamXYFrameHandle } from "../../stream/types";
|
|
4
|
+
import type { Datum } from "../shared/datumTypes";
|
|
5
|
+
import type { ChartModeInput, ChartModeResult } from "../shared/chartMode";
|
|
6
|
+
import type { LegendInteractionMode, LegendInteractionState } from "../shared/hooks";
|
|
7
|
+
import { type SelectionHookResult } from "../shared/selectionUtils";
|
|
8
|
+
import type { ChartMode, SelectionConfig } from "../shared/types";
|
|
9
|
+
interface RealtimeModeProps extends Omit<ChartModeInput, "enableHover"> {
|
|
10
|
+
mode?: ChartMode;
|
|
11
|
+
size?: [number, number];
|
|
12
|
+
enableHover?: unknown;
|
|
13
|
+
}
|
|
14
|
+
export declare function useRealtimeChartMode(props: RealtimeModeProps): ChartModeResult;
|
|
15
|
+
export declare function useRealtimeFrameHandle(ref: React.Ref<RealtimeFrameHandle>, frameRef: React.RefObject<StreamXYFrameHandle | null>): void;
|
|
16
|
+
export declare function useRealtimeSelectionStyle<TStyle extends Datum>(baseStyle: ((datum: Datum) => TStyle) | undefined, hooks: readonly (SelectionHookResult | null)[], selection: SelectionConfig | undefined): ((datum: Datum) => TStyle) | undefined;
|
|
17
|
+
export declare function buildRealtimeFrameChromeProps(resolved: ChartModeResult, legend: LegendInteractionState, mode: LegendInteractionMode | undefined): {
|
|
18
|
+
title: string | undefined;
|
|
19
|
+
description: string | undefined;
|
|
20
|
+
summary: string | undefined;
|
|
21
|
+
accessibleTable: import("../../stream/accessibleTableTypes").AccessibleTableProp | undefined;
|
|
22
|
+
legendHoverBehavior: (item: import("../../semiotic-geo").LegendItem | null) => void;
|
|
23
|
+
legendClickBehavior: (item: import("../../semiotic-geo").LegendItem) => void;
|
|
24
|
+
legendHighlightedCategory: string | null;
|
|
25
|
+
legendIsolatedCategories: Set<string> | undefined;
|
|
26
|
+
};
|
|
27
|
+
export {};
|