semiotic 3.9.1 → 3.9.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 +102 -48
- package/agent-skill/semiotic-charts/SKILL.md +14 -10
- package/ai/componentMetadata.cjs +13 -3
- package/ai/dist/mcp-server.js +140 -36407
- package/ai/examples.md +109 -6
- package/ai/reference.md +55 -18
- package/ai/schema.json +5964 -1190
- package/ai/surface-manifest.json +51 -7
- package/ai/system-prompt.md +16 -3
- package/dist/c-3SCUN5HI.min.js +1 -0
- package/dist/c-3VVKFA4M.min.js +1 -0
- package/dist/c-43TJZS3F.min.js +1 -0
- package/dist/c-4DTZPSUD.min.js +1 -0
- package/dist/c-4ES5367Y.min.js +1 -0
- package/dist/c-54IRWOGM.min.js +1 -0
- package/dist/c-5D2S4RMI.min.js +1 -0
- package/dist/c-5JWCTX3G.min.js +1 -0
- package/dist/c-6CMMSN6N.min.js +1 -0
- package/dist/c-6HRB2L7H.min.js +1 -0
- package/dist/c-7W4SV36A.min.js +1 -0
- package/dist/c-A4WRGZFX.min.js +1 -0
- package/dist/c-AG7WWVIH.min.js +1 -0
- package/dist/c-AH6J4MTN.min.js +1 -0
- package/dist/c-ALYR5LKK.min.js +1 -0
- package/dist/c-BYDPC44I.min.js +1 -0
- package/dist/c-CFFIU2MW.min.js +1 -0
- package/dist/c-CGNHBHCE.min.js +1 -0
- package/dist/c-CJYSXIFV.min.js +1 -0
- package/dist/c-CKLIFCGN.min.js +1 -0
- package/dist/c-CZF7MV67.min.js +1 -0
- package/dist/c-D53OKBSY.min.js +1 -0
- package/dist/c-DBQ2V7CH.min.js +1 -0
- package/dist/c-DPMVAUAW.min.js +1 -0
- package/dist/c-ECJCKLYY.min.js +1 -0
- package/dist/c-EGATGOWJ.min.js +1 -0
- package/dist/c-EGR6VYBW.min.js +1 -0
- package/dist/c-ENF72HU5.min.js +1 -0
- package/dist/c-ESNR43AN.min.js +1 -0
- package/dist/c-F3LIKINL.min.js +1 -0
- package/dist/c-F5ZB5GJ6.min.js +1 -0
- package/dist/c-G3VYMHKE.min.js +1 -0
- package/dist/c-GR6MOEQC.min.js +1 -0
- package/dist/c-GSVCN34B.min.js +1 -0
- package/dist/c-GYOQCEFP.min.js +1 -0
- package/dist/c-H3DNMTCC.min.js +1 -0
- package/dist/c-I6J3FEZE.min.js +1 -0
- package/dist/c-IGH6MGJ5.min.js +1 -0
- package/dist/c-II2EEAJN.min.js +1 -0
- package/dist/c-J6M4JHRS.min.js +1 -0
- package/dist/c-JM3MGLQV.min.js +1 -0
- package/dist/c-KM3N7F7R.min.js +1 -0
- package/dist/c-LF5BZFNC.min.js +1 -0
- package/dist/c-LKBSGFQC.min.js +1 -0
- package/dist/c-NDJADPIF.min.js +1 -0
- package/dist/c-NVPQCIL5.min.js +1 -0
- package/dist/c-OFWJBEE5.min.js +1 -0
- package/dist/c-OYFHP5F5.min.js +1 -0
- package/dist/c-PGKQGGQ2.min.js +1 -0
- package/dist/c-Q2IPZ3MU.min.js +1 -0
- package/dist/c-QKHMBE2E.min.js +1 -0
- package/dist/c-QMVM3AY6.min.js +1 -0
- package/dist/c-QSGWX53A.min.js +1 -0
- package/dist/c-RJKEKZOO.min.js +1 -0
- package/dist/c-SFDIIU5G.min.js +1 -0
- package/dist/c-SRTBCRVE.min.js +1 -0
- package/dist/c-T6UAIKBH.min.js +1 -0
- package/dist/c-TMCTEVVW.min.js +1 -0
- package/dist/c-TMOSJLT3.min.js +1 -0
- package/dist/c-U6ESPM7V.min.js +1 -0
- package/dist/c-UC5PTTFI.min.js +1 -0
- package/dist/c-VGKUEZBC.min.js +1 -0
- package/dist/c-VN2HG5BS.min.js +1 -0
- package/dist/{c-J5G56TUH.min.js → c-VPZDY5Q4.min.js} +1 -1
- package/dist/c-VRXUB2F2.min.js +1 -0
- package/dist/c-VUBQNQJH.min.js +1 -0
- package/dist/c-VUH4PGZY.min.js +1 -0
- package/dist/c-XDRV7RKW.min.js +1 -0
- package/dist/c-YGZHURXZ.min.js +1 -0
- package/dist/components/Annotation.d.ts +1 -1
- package/dist/components/access/chartAccessCapabilities.generated.d.ts +14 -0
- package/dist/components/access/chartAccessContract.d.ts +90 -0
- package/dist/components/access/chartAccessContractFixtures.d.ts +11 -0
- package/dist/components/ai/aestheticProfileTypes.d.ts +35 -0
- package/dist/components/ai/annotationProvenance.d.ts +2 -7
- package/dist/components/ai/auditVisualHierarchy.d.ts +49 -0
- package/dist/components/ai/builtInChartRecipeLayouts.d.ts +2 -0
- package/dist/components/ai/builtInChartRecipePublic.d.ts +4 -0
- package/dist/components/ai/builtInChartRecipes.d.ts +26 -0
- package/dist/components/ai/chartCapabilities.d.ts +3 -1
- package/dist/components/ai/chartRecipeRegistry.d.ts +2 -1
- package/dist/components/ai/chartRecipes.d.ts +6 -0
- package/dist/components/ai/colorEvidence.d.ts +12 -0
- package/dist/components/ai/evaluateAesthetics.d.ts +47 -0
- package/dist/components/ai/geoNavigation.d.ts +4 -0
- package/dist/components/ai/hierarchyNavigation.d.ts +4 -0
- package/dist/components/ai/navigationTree.d.ts +7 -1
- package/dist/components/ai/qualityFixtures.d.ts +8 -0
- package/dist/components/ai/suggestionPropContracts.d.ts +1 -1
- package/dist/components/ai/useNavigationSync.d.ts +3 -3
- package/dist/components/charts/index.d.ts +4 -0
- package/dist/components/charts/network/ChordDiagram.d.ts +5 -1
- package/dist/components/charts/network/CirclePack.d.ts +8 -1
- package/dist/components/charts/network/OrbitDiagram.d.ts +9 -0
- package/dist/components/charts/network/TreeDiagram.d.ts +8 -1
- package/dist/components/charts/network/Treemap.d.ts +8 -1
- package/dist/components/charts/ordinal/BarChart.d.ts +6 -0
- package/dist/components/charts/ordinal/BoxPlot.d.ts +3 -0
- package/dist/components/charts/ordinal/DonutChart.d.ts +3 -0
- package/dist/components/charts/ordinal/DotPlot.d.ts +3 -0
- package/dist/components/charts/ordinal/FunnelChart.d.ts +3 -0
- package/dist/components/charts/ordinal/GaugeChart.d.ts +3 -0
- package/dist/components/charts/ordinal/Histogram.d.ts +3 -0
- package/dist/components/charts/ordinal/LikertChart.d.ts +3 -0
- package/dist/components/charts/ordinal/PieChart.d.ts +3 -0
- package/dist/components/charts/ordinal/RadarChart.capability.d.ts +2 -0
- package/dist/components/charts/ordinal/RadarChart.d.ts +75 -0
- package/dist/components/charts/ordinal/RidgelinePlot.d.ts +3 -0
- package/dist/components/charts/ordinal/SwarmPlot.d.ts +3 -0
- package/dist/components/charts/ordinal/SwimlaneChart.d.ts +3 -0
- package/dist/components/charts/ordinal/ViolinPlot.d.ts +3 -0
- package/dist/components/charts/physics/GauntletChart.d.ts +1 -5
- package/dist/components/charts/physics/chainReactionTypes.d.ts +3 -0
- package/dist/components/charts/physics/gauntletPhysics.d.ts +1 -0
- package/dist/components/charts/physics/physicsHocUtils.d.ts +7 -1
- package/dist/components/charts/realtime/RealtimeHeatmap.d.ts +10 -1
- package/dist/components/charts/realtime/RealtimeHistogram.d.ts +11 -1
- package/dist/components/charts/realtime/RealtimeLineChart.d.ts +14 -5
- package/dist/components/charts/realtime/RealtimeSwarmChart.d.ts +7 -1
- package/dist/components/charts/realtime/RealtimeWaterfallChart.d.ts +7 -1
- package/dist/components/charts/realtime/aggregate.d.ts +12 -1
- package/dist/components/charts/realtime/realtimeChartRuntime.d.ts +4 -2
- package/dist/components/charts/realtime/realtimeStyleRules.d.ts +4 -0
- package/dist/components/charts/shared/annotationStatusFilter.d.ts +18 -0
- package/dist/components/charts/shared/chartDefinitionPilot.d.ts +5 -4
- package/dist/components/charts/shared/chartSpecCore.d.ts +2 -2
- package/dist/components/charts/shared/heatmapStyleRules.d.ts +13 -0
- package/dist/components/charts/shared/knownChartComponents.d.ts +1 -1
- package/dist/components/charts/shared/networkUtils.d.ts +14 -0
- package/dist/components/charts/shared/selectionUtils.d.ts +3 -1
- package/dist/components/charts/shared/types.d.ts +4 -2
- package/dist/components/charts/shared/useChartLegend.d.ts +2 -1
- package/dist/components/charts/shared/useLikertAggregation.d.ts +8 -2
- package/dist/components/charts/shared/useNetworkChartSetup.d.ts +9 -5
- package/dist/components/charts/shared/useOrdinalPieceStyle.d.ts +1 -1
- package/dist/components/charts/shared/useXYBrush.d.ts +24 -0
- package/dist/components/charts/xy/Heatmap.d.ts +16 -0
- package/dist/components/charts/xy/LineChart.d.ts +9 -0
- package/dist/components/charts/xy/Scatterplot.d.ts +7 -0
- package/dist/components/charts/xy/WaterfallChart.capability.d.ts +2 -0
- package/dist/components/charts/xy/WaterfallChart.d.ts +68 -0
- package/dist/components/evidence/chartEvidenceEnvelope.d.ts +146 -0
- package/dist/components/evidence/evidenceGate.d.ts +28 -0
- package/dist/components/realtime/BinAccumulator.d.ts +5 -1
- package/dist/components/realtime/types.d.ts +16 -7
- package/dist/components/recipes/adjacencyFlow.d.ts +12 -0
- package/dist/components/recipes/adjacencyFlowAggregation.d.ts +72 -0
- package/dist/components/recipes/adjacencyFlowGeometry.d.ts +79 -0
- package/dist/components/recipes/lineageDag.d.ts +17 -0
- package/dist/components/recipes/lineageDagHulls.d.ts +22 -0
- package/dist/components/recipes/transitDiagram.d.ts +75 -0
- package/dist/components/recipes/transitDiagramGeometry.d.ts +47 -0
- package/dist/components/semiotic-access.d.ts +9 -0
- package/dist/components/semiotic-ai-audits.d.ts +17 -0
- package/dist/components/semiotic-ai-core.d.ts +9 -0
- package/dist/components/semiotic-ai.d.ts +5 -17
- package/dist/components/semiotic-evidence.d.ts +10 -0
- package/dist/components/semiotic-line.d.ts +9 -0
- package/dist/components/semiotic-network.d.ts +3 -0
- package/dist/components/semiotic-ordinal.d.ts +2 -0
- package/dist/components/semiotic-realtime-core.d.ts +3 -2
- package/dist/components/semiotic-recipes-core.d.ts +6 -0
- package/dist/components/semiotic-themes-core.d.ts +3 -0
- package/dist/components/semiotic-utils-core.d.ts +5 -0
- package/dist/components/semiotic-xy.d.ts +3 -0
- package/dist/components/semiotic.d.ts +9 -3
- package/dist/components/server/renderDashboard.d.ts +37 -0
- package/dist/components/server/renderEvidence.d.ts +27 -0
- package/dist/components/server/renderToStaticSVG.d.ts +2 -30
- package/dist/components/server/serverChartConfigShared.d.ts +13 -0
- package/dist/components/server/serverChartConfigs.d.ts +9 -0
- package/dist/components/server/serverChartConfigsComposite.d.ts +4 -0
- package/dist/components/server/serverChartConfigsCustom.d.ts +2 -0
- package/dist/components/server/serverChartConfigsGeo.d.ts +1 -0
- package/dist/components/server/serverChartConfigsOrdinal.d.ts +3 -2
- package/dist/components/server/serverChartConfigsXY.d.ts +1 -0
- package/dist/components/server/serverChartConfigsXYExtra.d.ts +3 -0
- package/dist/components/server/serverCompositeChainReaction.d.ts +3 -0
- package/dist/components/server/serverOrdinalGauge.d.ts +3 -0
- package/dist/components/server/serverOrdinalLikert.d.ts +2 -0
- package/dist/components/store/selectionProvenance.d.ts +8 -0
- package/dist/components/store/themeCore.d.ts +5 -1
- package/dist/components/stream/GeoPipelineStore.d.ts +1 -1
- package/dist/components/stream/MarginalGraphics.d.ts +3 -3
- package/dist/components/stream/MarginalGraphicsLazy.d.ts +22 -0
- package/dist/components/stream/NetworkPipelineStore.d.ts +2 -0
- package/dist/components/stream/OrdinalPipelineStore.d.ts +1 -1
- package/dist/components/stream/PipelineStore.d.ts +1 -1
- package/dist/components/stream/SceneToSVG.d.ts +1 -1
- package/dist/components/stream/canvasSetup.d.ts +8 -2
- package/dist/components/stream/customLayoutAttempt.d.ts +21 -0
- package/dist/components/stream/geoTypes.d.ts +1 -1
- package/dist/components/stream/isServerEnvironment.d.ts +6 -0
- package/dist/components/stream/layouts/forceLayoutNodeSize.d.ts +12 -0
- package/dist/components/stream/layouts/forceLayoutPlugin.d.ts +2 -9
- package/dist/components/stream/layouts/forceLayoutWorkerClient.d.ts +2 -21
- package/dist/components/stream/layouts/forceLayoutWorkerPolicy.d.ts +21 -0
- package/dist/components/stream/layouts/index.d.ts +6 -12
- package/dist/components/stream/layouts/missingPlugin.d.ts +7 -0
- package/dist/components/stream/layouts/registerBuiltIn.d.ts +1 -0
- package/dist/components/stream/layouts/registry.d.ts +12 -0
- package/dist/components/stream/marginalConfig.d.ts +3 -0
- package/dist/components/stream/networkCustomLayout.d.ts +7 -0
- package/dist/components/stream/networkCustomLayoutOutput.d.ts +13 -0
- package/dist/components/stream/networkCustomLayoutRunner.d.ts +1 -1
- package/dist/components/stream/networkTypes.d.ts +5 -1
- package/dist/components/stream/ordinalTypes.d.ts +1 -1
- package/dist/components/stream/physics/StreamPhysicsTypes.d.ts +1 -1
- package/dist/components/stream/pipelineDomainResolution.d.ts +6 -0
- package/dist/components/stream/renderers/pointCanvasRenderer.d.ts +4 -0
- package/dist/components/stream/renderers/resolveCSSColor.d.ts +4 -4
- package/dist/components/stream/types.d.ts +8 -1
- package/dist/components/stream/useEnsureCustomXYRenderers.d.ts +18 -0
- package/dist/components/stream/useMarginalValues.d.ts +13 -0
- package/dist/components/stream/xyCanvasRenderers.d.ts +4 -4
- package/dist/components/stream/xyPlugins/areaPlugin.d.ts +2 -0
- package/dist/components/stream/xyPlugins/barPlugin.d.ts +2 -0
- package/dist/components/stream/xyPlugins/candlestickPlugin.d.ts +2 -0
- package/dist/components/stream/xyPlugins/customPlugin.d.ts +6 -0
- package/dist/components/stream/xyPlugins/heatmapPlugin.d.ts +2 -0
- package/dist/components/stream/xyPlugins/lineFamily.d.ts +5 -0
- package/dist/components/stream/xyPlugins/linePlugin.d.ts +2 -0
- package/dist/components/stream/xyPlugins/missingPlugin.d.ts +7 -0
- package/dist/components/stream/xyPlugins/mixedPlugin.d.ts +2 -0
- package/dist/components/stream/xyPlugins/pointPlugin.d.ts +3 -0
- package/dist/components/stream/xyPlugins/registerBuiltIn.d.ts +1 -0
- package/dist/components/stream/xyPlugins/registry.d.ts +31 -0
- package/dist/components/stream/xyPlugins/stackedAreaPlugin.d.ts +2 -0
- package/dist/components/stream/xyPlugins/swarmPlugin.d.ts +2 -0
- package/dist/components/stream/xyPlugins/waterfallPlugin.d.ts +2 -0
- package/dist/forceLayoutWorker.js +1 -1
- package/dist/geo.min.js +1 -1
- package/dist/geo.module.min.js +1 -1
- package/dist/network.module.min.js +1 -1
- package/dist/ordinal.module.min.js +1 -1
- package/dist/physics.module.min.js +1 -1
- package/dist/rough.module.min.js +1 -1
- package/dist/semiotic-access.d.ts +9 -0
- package/dist/semiotic-access.min.js +2 -0
- package/dist/semiotic-access.module.min.js +2 -0
- package/dist/semiotic-ai-core.d.ts +9 -0
- 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 +5 -17
- package/dist/semiotic-ai.module.min.js +1 -1
- package/dist/semiotic-client-cjs-shared.min.js +1 -1
- package/dist/semiotic-client-shared.module.min.js +1 -1
- package/dist/semiotic-evidence.d.ts +10 -0
- package/dist/semiotic-evidence.min.js +1 -0
- package/dist/semiotic-evidence.module.min.js +1 -0
- package/dist/semiotic-experimental-auxiliary.module.min.js +1 -1
- package/dist/semiotic-experimental-node-auxiliary.module.min.js +1 -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.d.ts +9 -0
- package/dist/semiotic-line.min.js +2 -0
- package/dist/semiotic-line.module.min.js +2 -0
- package/dist/semiotic-network.d.ts +3 -0
- package/dist/semiotic-ordinal.d.ts +2 -0
- package/dist/semiotic-realtime-core.d.ts +3 -2
- package/dist/semiotic-realtime-core.module.min.js +1 -1
- package/dist/semiotic-recipes-core-cjs-base.min.js +1 -1
- package/dist/semiotic-recipes-core.d.ts +6 -0
- package/dist/semiotic-recipes-core.module.min.js +1 -1
- package/dist/semiotic-server-edge-node.module.min.js +1 -1
- 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-themes-core.d.ts +3 -0
- 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.d.ts +5 -0
- package/dist/semiotic-utils-core.min.js +1 -1
- package/dist/semiotic-utils-core.module.min.js +1 -1
- package/dist/semiotic-xy.d.ts +3 -0
- package/dist/semiotic.d.ts +9 -3
- 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.module.min.js +1 -1
- package/package.json +39 -60
- package/dist/c-3KZD6AXJ.min.js +0 -1
- package/dist/c-4TWEX5HG.min.js +0 -1
- package/dist/c-5YCIX3VZ.min.js +0 -1
- package/dist/c-6FEKTA3U.min.js +0 -1
- package/dist/c-74HEEZGK.min.js +0 -1
- package/dist/c-BWNB6USU.min.js +0 -1
- package/dist/c-C25ENHIK.min.js +0 -1
- package/dist/c-CDR5AO3R.min.js +0 -1
- package/dist/c-E3JFRRMI.min.js +0 -1
- package/dist/c-EBFPQHHO.min.js +0 -1
- package/dist/c-GIKRQI4X.min.js +0 -1
- package/dist/c-GPYOFETM.min.js +0 -1
- package/dist/c-IDUHYYSI.min.js +0 -1
- package/dist/c-JAZ73J32.min.js +0 -1
- package/dist/c-KG3NXHAL.min.js +0 -1
- package/dist/c-KII3PLZE.min.js +0 -1
- package/dist/c-LIXGXMNS.min.js +0 -1
- package/dist/c-LVEY6D6B.min.js +0 -1
- package/dist/c-M4Y3BHFR.min.js +0 -1
- package/dist/c-MAIICR2Z.min.js +0 -1
- package/dist/c-MG5DM6VE.min.js +0 -1
- package/dist/c-O6U6K4CW.min.js +0 -1
- package/dist/c-OQ7M4AGV.min.js +0 -1
- package/dist/c-OXYMVK7Q.min.js +0 -1
- package/dist/c-QHF5YON3.min.js +0 -1
- package/dist/c-RR3GO5SW.min.js +0 -1
- package/dist/c-S2BXNNJN.min.js +0 -1
- package/dist/c-SUILCHWU.min.js +0 -1
- package/dist/c-US5ZFT6E.min.js +0 -1
- package/dist/c-UUKVD4WB.min.js +0 -1
- package/dist/c-WJCD5EUY.min.js +0 -1
- package/dist/c-YDAY2WFR.min.js +0 -1
- package/dist/c-ZOWWU34K.min.js +0 -1
- /package/dist/{c-COHXCW3Q.min.js → c-YZVRZGX2.min.js} +0 -0
|
@@ -10,6 +10,7 @@ export { CORE_KIND, POSITIVE_KIND, NEGATIVE_KIND } from "./gauntletTypes";
|
|
|
10
10
|
export type { GauntletAccessors, GauntletBodyDatum, GauntletCoreBodyFn, GauntletEffect, GauntletEvent, GauntletEventContext, GauntletEventLogItem, GauntletGate, GauntletLayout, GauntletNegativeReplacementOptions, GauntletPopSpec, GauntletProjectPlacement, GauntletProjectPlacementFn, GauntletProjectState, GauntletPropertyDefinition, GauntletPropertyForceContext, GauntletPropertyWorkPlan, GauntletPropertyWorkPlanOptions, GauntletViabilityFn } from "./gauntletTypes";
|
|
11
11
|
export declare const DEFAULT_WIDTH = 900;
|
|
12
12
|
export declare const DEFAULT_HEIGHT = 520;
|
|
13
|
+
export declare const EMPTY_GAUNTLET_PROPERTIES: readonly GauntletPropertyDefinition[];
|
|
13
14
|
export declare function gauntletWallColliders(layout: Pick<GauntletLayout, "width" | "floorY"> & Partial<Pick<GauntletLayout, "height">>): NonNullable<PhysicsPipelineConfig["colliders"]>;
|
|
14
15
|
export declare function readAccessor<TDatum extends Datum, TValue>(datum: TDatum, index: number, accessor: ChartAccessor<TDatum, TValue> | undefined, fallback: TValue): TValue;
|
|
15
16
|
export declare function propertyLabel(property: GauntletPropertyDefinition | undefined): string;
|
|
@@ -27,7 +27,13 @@ export type PhysicsSharedChartProps = {
|
|
|
27
27
|
selection?: PhysicsChartSelection;
|
|
28
28
|
/** Emit hover into the shared selection store for cross-chart highlighting. */
|
|
29
29
|
linkedHover?: LinkedHoverProp;
|
|
30
|
+
/**
|
|
31
|
+
* Observe the physics pipeline entering or leaving its running/settled
|
|
32
|
+
* states. This composes with chart-owned observation and rerun behavior.
|
|
33
|
+
*/
|
|
34
|
+
onSimulationStateChange?: PhysicsSimulationStateChange;
|
|
30
35
|
};
|
|
36
|
+
export type PhysicsSimulationStateChange = NonNullable<NonNullable<NonNullable<StreamPhysicsFrameProps["config"]>["observation"]>["onSimulationStateChange"]>;
|
|
31
37
|
/**
|
|
32
38
|
* What a physics HOC's `selection` prop accepts.
|
|
33
39
|
*
|
|
@@ -71,7 +77,7 @@ export type PhysicsRerunMS = number | null;
|
|
|
71
77
|
* Remounting is intentional: it replays the chart's deterministic seed,
|
|
72
78
|
* initial bodies, and spawn pacing instead of trying to reverse a live store.
|
|
73
79
|
*/
|
|
74
|
-
export declare function usePhysicsRerun(config: StreamPhysicsFrameProps["config"], rerunMS: PhysicsRerunMS | undefined, paused: boolean | undefined, onRerun?: () => void): {
|
|
80
|
+
export declare function usePhysicsRerun(config: StreamPhysicsFrameProps["config"], rerunMS: PhysicsRerunMS | undefined, paused: boolean | undefined, onRerun?: () => void, externalStateChange?: PhysicsSimulationStateChange): {
|
|
75
81
|
config: StreamPhysicsFrameProps["config"];
|
|
76
82
|
rerunKey: number;
|
|
77
83
|
};
|
|
@@ -11,6 +11,7 @@ import type { MobileVisualizationContract } from "../shared/auditMobileVisualiza
|
|
|
11
11
|
import type { ResponsiveRule } from "../shared/responsiveRules";
|
|
12
12
|
import type { RealtimeAccessibilityProps, RealtimeData, RealtimePointIdAccessor, RealtimeTooltipProp } from "./realtimeChartTypes";
|
|
13
13
|
import type { PartialMargin } from "../../types/marginType";
|
|
14
|
+
import { type StyleRule } from "../shared/styleRules";
|
|
14
15
|
export interface RealtimeHeatmapProps<TDatum extends Datum = Datum> extends RealtimeAccessibilityProps {
|
|
15
16
|
/** Display mode: "primary" (full chrome), "context" (compact), "sparkline" (inline) */
|
|
16
17
|
mode?: ChartMode;
|
|
@@ -26,7 +27,7 @@ export interface RealtimeHeatmapProps<TDatum extends Datum = Datum> extends Real
|
|
|
26
27
|
width?: number;
|
|
27
28
|
/** Chart height (alternative to size) */
|
|
28
29
|
height?: number;
|
|
29
|
-
/** Maximum canvas backing-store DPR;
|
|
30
|
+
/** Maximum canvas backing-store DPR; large canvases also use the shared backing-store budget. */
|
|
30
31
|
maxDevicePixelRatio?: number;
|
|
31
32
|
/** Chart margins */
|
|
32
33
|
margin?: PartialMargin;
|
|
@@ -66,6 +67,11 @@ export interface RealtimeHeatmapProps<TDatum extends Datum = Datum> extends Real
|
|
|
66
67
|
customColorScale?: (value: number) => string;
|
|
67
68
|
/** Presentation-only CSS cursor for retained marks; does not add click, keyboard, or observation behavior. */
|
|
68
69
|
cursor?: CSSProperties["cursor"];
|
|
70
|
+
/**
|
|
71
|
+
* Ordered styling for displayed aggregate cells. Rule `value` is the chosen
|
|
72
|
+
* aggregate; `count`, `sum`, `xCenter`, `yCenter`, and `agg` are fields.
|
|
73
|
+
*/
|
|
74
|
+
styleRules?: StyleRule[];
|
|
69
75
|
/** Show canvas-drawn axes */
|
|
70
76
|
showAxes?: boolean;
|
|
71
77
|
/** Background fill color */
|
|
@@ -158,6 +164,9 @@ export interface RealtimeHeatmapProps<TDatum extends Datum = Datum> extends Real
|
|
|
158
164
|
* ```
|
|
159
165
|
*/
|
|
160
166
|
export declare const RealtimeHeatmap: {
|
|
167
|
+
/** Compatibility overload for refs authored against the loose 3.x handle. */
|
|
161
168
|
<TDatum extends Datum = Datum>(props: RealtimeHeatmapProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
|
|
169
|
+
/** Typed refs retain the authored row through mutation and readback. */
|
|
170
|
+
<TDatum extends Datum = Datum>(props: RealtimeHeatmapProps<TDatum> & React.RefAttributes<RealtimeFrameHandle<TDatum>>): React.ReactElement | null;
|
|
162
171
|
displayName?: string;
|
|
163
172
|
};
|
|
@@ -12,6 +12,7 @@ import type { ResponsiveRule } from "../shared/responsiveRules";
|
|
|
12
12
|
import type { LegendValue } from "../../types/legendTypes";
|
|
13
13
|
import type { PartialMargin } from "../../types/marginType";
|
|
14
14
|
import type { RealtimeAccessibilityProps, RealtimeData, RealtimePointIdAccessor, RealtimeTooltipProp } from "./realtimeChartTypes";
|
|
15
|
+
import { type StyleRule } from "../shared/styleRules";
|
|
15
16
|
export type RealtimeHistogramDirection = "up" | "down";
|
|
16
17
|
export interface RealtimeHistogramProps<TDatum extends Datum = Datum> extends RealtimeAccessibilityProps {
|
|
17
18
|
/** Display mode: "primary" (full chrome), "context" (compact), "sparkline" (inline) */
|
|
@@ -30,7 +31,7 @@ export interface RealtimeHistogramProps<TDatum extends Datum = Datum> extends Re
|
|
|
30
31
|
width?: number;
|
|
31
32
|
/** Chart height (alternative to size) */
|
|
32
33
|
height?: number;
|
|
33
|
-
/** Maximum canvas backing-store DPR;
|
|
34
|
+
/** Maximum canvas backing-store DPR; large canvases also use the shared backing-store budget. */
|
|
34
35
|
maxDevicePixelRatio?: number;
|
|
35
36
|
/** Chart margins */
|
|
36
37
|
margin?: PartialMargin;
|
|
@@ -84,6 +85,11 @@ export interface RealtimeHistogramProps<TDatum extends Datum = Datum> extends Re
|
|
|
84
85
|
opacity?: number;
|
|
85
86
|
/** Presentation-only CSS cursor for retained marks; does not add click, keyboard, or observation behavior. */
|
|
86
87
|
cursor?: CSSProperties["cursor"];
|
|
88
|
+
/**
|
|
89
|
+
* Ordered styling for displayed bins. Rule `value` is `categoryValue` for a
|
|
90
|
+
* stacked segment or `total` for an unstacked bin; `x` is the bin center.
|
|
91
|
+
*/
|
|
92
|
+
styleRules?: StyleRule[];
|
|
87
93
|
/** Gap between bars in pixels */
|
|
88
94
|
gap?: number;
|
|
89
95
|
/** Show canvas-drawn axes */
|
|
@@ -196,7 +202,10 @@ export interface RealtimeHistogramProps<TDatum extends Datum = Datum> extends Re
|
|
|
196
202
|
* ```
|
|
197
203
|
*/
|
|
198
204
|
export declare const RealtimeHistogram: {
|
|
205
|
+
/** Compatibility overload for refs authored against the loose 3.x handle. */
|
|
199
206
|
<TDatum extends Datum = Datum>(props: RealtimeHistogramProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
|
|
207
|
+
/** Typed refs retain the authored row through mutation and readback. */
|
|
208
|
+
<TDatum extends Datum = Datum>(props: RealtimeHistogramProps<TDatum> & React.RefAttributes<RealtimeFrameHandle<TDatum>>): React.ReactElement | null;
|
|
200
209
|
displayName?: string;
|
|
201
210
|
};
|
|
202
211
|
export interface TemporalHistogramProps<TDatum extends Datum = Datum> extends Omit<RealtimeHistogramProps<TDatum>, "data" | "windowSize" | "windowMode"> {
|
|
@@ -217,6 +226,7 @@ export declare namespace TemporalHistogram {
|
|
|
217
226
|
* written before the rename and will be removed in a future major version. */
|
|
218
227
|
export declare const RealtimeTemporalHistogram: {
|
|
219
228
|
<TDatum extends Datum = Datum>(props: RealtimeHistogramProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
|
|
229
|
+
<TDatum extends Datum = Datum>(props: RealtimeHistogramProps<TDatum> & React.RefAttributes<RealtimeFrameHandle<TDatum>>): React.ReactElement | null;
|
|
220
230
|
displayName?: string;
|
|
221
231
|
};
|
|
222
232
|
/** @deprecated Use `RealtimeHistogramProps` instead. Same component, just the
|
|
@@ -9,16 +9,17 @@ 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
|
-
import { type AggregateConfig } from "./aggregate";
|
|
12
|
+
import { type AggregateConfig, type AggregatedRealtimeDatum } from "./aggregate";
|
|
13
13
|
import { type EventTimeConfig } from "./eventTime";
|
|
14
14
|
import type { RealtimeAccessibilityProps, RealtimeData, RealtimePointIdAccessor, RealtimeTooltipProp } from "./realtimeChartTypes";
|
|
15
15
|
import type { PartialMargin } from "../../types/marginType";
|
|
16
|
+
import { type StyleRule } from "../shared/styleRules";
|
|
16
17
|
/**
|
|
17
18
|
* Imperative handle for RealtimeLineChart. It extends the shared realtime
|
|
18
19
|
* handle without changing that cross-chart contract: only this chart exposes
|
|
19
20
|
* event-time tail flushing.
|
|
20
21
|
*/
|
|
21
|
-
export interface RealtimeLineChartHandle extends RealtimeFrameHandle {
|
|
22
|
+
export interface RealtimeLineChartHandle<TDatum extends Datum = Datum, TReadDatum extends Datum = TDatum> extends RealtimeFrameHandle<TDatum, TReadDatum> {
|
|
22
23
|
/**
|
|
23
24
|
* Release every event still held by `eventTime`, in event-time order.
|
|
24
25
|
* Call this when an input source reaches an asserted end-of-stream or batch
|
|
@@ -42,7 +43,7 @@ export interface RealtimeLineChartProps<TDatum extends Datum = Datum> extends Re
|
|
|
42
43
|
width?: number;
|
|
43
44
|
/** Chart height (alternative to size) */
|
|
44
45
|
height?: number;
|
|
45
|
-
/** Maximum canvas backing-store DPR;
|
|
46
|
+
/** Maximum canvas backing-store DPR; large canvases also use the shared backing-store budget. */
|
|
46
47
|
maxDevicePixelRatio?: number;
|
|
47
48
|
/** Chart margins */
|
|
48
49
|
margin?: PartialMargin;
|
|
@@ -78,6 +79,8 @@ export interface RealtimeLineChartProps<TDatum extends Datum = Datum> extends Re
|
|
|
78
79
|
opacity?: number;
|
|
79
80
|
/** Presentation-only CSS cursor for retained marks; does not add click, keyboard, or observation behavior. */
|
|
80
81
|
cursor?: CSSProperties["cursor"];
|
|
82
|
+
/** Ordered data-aware line styling, resolved against the displayed series sample. */
|
|
83
|
+
styleRules?: StyleRule[];
|
|
81
84
|
/** Show canvas-drawn axes */
|
|
82
85
|
showAxes?: boolean;
|
|
83
86
|
/** Background fill color */
|
|
@@ -199,7 +202,13 @@ export interface RealtimeLineChartProps<TDatum extends Datum = Datum> extends Re
|
|
|
199
202
|
export declare const RealtimeLineChart: {
|
|
200
203
|
/** Compatibility overload for refs authored against the shared 3.x handle. */
|
|
201
204
|
<TDatum extends Datum = Datum>(props: RealtimeLineChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
|
|
202
|
-
/**
|
|
203
|
-
<TDatum extends Datum = Datum>(props: RealtimeLineChartProps<TDatum> &
|
|
205
|
+
/** Aggregate mode accepts authored rows but materializes window summaries. */
|
|
206
|
+
<TDatum extends Datum = Datum>(props: Omit<RealtimeLineChartProps<TDatum>, "aggregate"> & {
|
|
207
|
+
aggregate: AggregateConfig;
|
|
208
|
+
} & React.RefAttributes<RealtimeLineChartHandle<TDatum, AggregatedRealtimeDatum>>): React.ReactElement | null;
|
|
209
|
+
/** Typed non-aggregate refs retain the authored row and expose flush(). */
|
|
210
|
+
<TDatum extends Datum = Datum>(props: Omit<RealtimeLineChartProps<TDatum>, "aggregate"> & {
|
|
211
|
+
aggregate?: undefined;
|
|
212
|
+
} & React.RefAttributes<RealtimeLineChartHandle<TDatum>>): React.ReactElement | null;
|
|
204
213
|
displayName?: string;
|
|
205
214
|
};
|
|
@@ -11,6 +11,7 @@ import type { MobileVisualizationContract } from "../shared/auditMobileVisualiza
|
|
|
11
11
|
import type { ResponsiveRule } from "../shared/responsiveRules";
|
|
12
12
|
import type { RealtimeAccessibilityProps, RealtimeData, RealtimePointIdAccessor, RealtimeTooltipProp } from "./realtimeChartTypes";
|
|
13
13
|
import type { PartialMargin } from "../../types/marginType";
|
|
14
|
+
import { type StyleRule } from "../shared/styleRules";
|
|
14
15
|
export interface RealtimeSwarmChartProps<TDatum extends Datum = Datum> extends RealtimeAccessibilityProps {
|
|
15
16
|
/** Display mode: "primary" (full chrome), "context" (compact), "sparkline" (inline) */
|
|
16
17
|
mode?: ChartMode;
|
|
@@ -26,7 +27,7 @@ export interface RealtimeSwarmChartProps<TDatum extends Datum = Datum> extends R
|
|
|
26
27
|
width?: number;
|
|
27
28
|
/** Chart height (alternative to size) */
|
|
28
29
|
height?: number;
|
|
29
|
-
/** Maximum canvas backing-store DPR;
|
|
30
|
+
/** Maximum canvas backing-store DPR; large canvases also use the shared backing-store budget. */
|
|
30
31
|
maxDevicePixelRatio?: number;
|
|
31
32
|
/** Chart margins */
|
|
32
33
|
margin?: PartialMargin;
|
|
@@ -82,6 +83,8 @@ export interface RealtimeSwarmChartProps<TDatum extends Datum = Datum> extends R
|
|
|
82
83
|
pointStyle?: (datum: TDatum) => Style & {
|
|
83
84
|
r?: number;
|
|
84
85
|
};
|
|
86
|
+
/** Ordered data-aware dot styling, applied before `pointStyle`. */
|
|
87
|
+
styleRules?: StyleRule[];
|
|
85
88
|
/** Show canvas-drawn axes */
|
|
86
89
|
showAxes?: boolean;
|
|
87
90
|
/** Background fill color */
|
|
@@ -162,6 +165,9 @@ export interface RealtimeSwarmChartProps<TDatum extends Datum = Datum> extends R
|
|
|
162
165
|
* ```
|
|
163
166
|
*/
|
|
164
167
|
export declare const RealtimeSwarmChart: {
|
|
168
|
+
/** Compatibility overload for refs authored against the loose 3.x handle. */
|
|
165
169
|
<TDatum extends Datum = Datum>(props: RealtimeSwarmChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
|
|
170
|
+
/** Typed refs retain the authored row through mutation and readback. */
|
|
171
|
+
<TDatum extends Datum = Datum>(props: RealtimeSwarmChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle<TDatum>>): React.ReactElement | null;
|
|
166
172
|
displayName?: string;
|
|
167
173
|
};
|
|
@@ -11,6 +11,7 @@ import type { MobileVisualizationContract } from "../shared/auditMobileVisualiza
|
|
|
11
11
|
import type { ResponsiveRule } from "../shared/responsiveRules";
|
|
12
12
|
import type { RealtimeAccessibilityProps, RealtimeData, RealtimePointIdAccessor, RealtimeTooltipProp } from "./realtimeChartTypes";
|
|
13
13
|
import type { PartialMargin } from "../../types/marginType";
|
|
14
|
+
import { type StyleRule } from "../shared/styleRules";
|
|
14
15
|
export interface RealtimeWaterfallChartProps<TDatum extends Datum = Datum> extends RealtimeAccessibilityProps {
|
|
15
16
|
/** Display mode: "primary" (full chrome), "context" (compact), "sparkline" (inline) */
|
|
16
17
|
mode?: ChartMode;
|
|
@@ -26,7 +27,7 @@ export interface RealtimeWaterfallChartProps<TDatum extends Datum = Datum> exten
|
|
|
26
27
|
width?: number;
|
|
27
28
|
/** Chart height (alternative to size) */
|
|
28
29
|
height?: number;
|
|
29
|
-
/** Maximum canvas backing-store DPR;
|
|
30
|
+
/** Maximum canvas backing-store DPR; large canvases also use the shared backing-store budget. */
|
|
30
31
|
maxDevicePixelRatio?: number;
|
|
31
32
|
/** Chart margins */
|
|
32
33
|
margin?: PartialMargin;
|
|
@@ -78,6 +79,8 @@ export interface RealtimeWaterfallChartProps<TDatum extends Datum = Datum> exten
|
|
|
78
79
|
opacity?: number;
|
|
79
80
|
/** Presentation-only CSS cursor for retained marks; does not add click, keyboard, or observation behavior. */
|
|
80
81
|
cursor?: CSSProperties["cursor"];
|
|
82
|
+
/** Ordered data-aware bar styling. Rule `value`/`y` is the displayed delta. */
|
|
83
|
+
styleRules?: StyleRule[];
|
|
81
84
|
/** Show canvas-drawn axes */
|
|
82
85
|
showAxes?: boolean;
|
|
83
86
|
/** Background fill color */
|
|
@@ -157,6 +160,9 @@ export interface RealtimeWaterfallChartProps<TDatum extends Datum = Datum> exten
|
|
|
157
160
|
* ```
|
|
158
161
|
*/
|
|
159
162
|
export declare const RealtimeWaterfallChart: {
|
|
163
|
+
/** Compatibility overload for refs authored against the loose 3.x handle. */
|
|
160
164
|
<TDatum extends Datum = Datum>(props: RealtimeWaterfallChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
|
|
165
|
+
/** Typed refs retain the authored row through mutation and readback. */
|
|
166
|
+
<TDatum extends Datum = Datum>(props: RealtimeWaterfallChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle<TDatum>>): React.ReactElement | null;
|
|
161
167
|
displayName?: string;
|
|
162
168
|
};
|
|
@@ -36,6 +36,17 @@ export declare const AGG_PARTIAL = "__aggPartial";
|
|
|
36
36
|
export declare const AGG_COUNT = "count";
|
|
37
37
|
export declare const AGG_START = "__aggStart";
|
|
38
38
|
export declare const AGG_END = "__aggEnd";
|
|
39
|
+
/** Materialized row returned by RealtimeLineChart in aggregate mode. */
|
|
40
|
+
export interface AggregatedRealtimeDatum extends Datum {
|
|
41
|
+
time: number;
|
|
42
|
+
value: number;
|
|
43
|
+
count: number;
|
|
44
|
+
__aggPartial: boolean;
|
|
45
|
+
__aggStart: number;
|
|
46
|
+
__aggEnd: number;
|
|
47
|
+
__aggLower?: number;
|
|
48
|
+
__aggUpper?: number;
|
|
49
|
+
}
|
|
39
50
|
/**
|
|
40
51
|
* Build a `WindowAccumulator` from a config, parsing duration strings.
|
|
41
52
|
* Returns `null` when the window width is unparseable, so the caller can
|
|
@@ -48,7 +59,7 @@ export declare function createAccumulator(config: AggregateConfig): WindowAccumu
|
|
|
48
59
|
* bounds (when a band is configured), and provenance fields (`count`,
|
|
49
60
|
* partial flag, raw start/end) for tooltips and partial-window styling.
|
|
50
61
|
*/
|
|
51
|
-
export declare function aggregatedRows(acc: WindowAccumulator, config: AggregateConfig):
|
|
62
|
+
export declare function aggregatedRows(acc: WindowAccumulator, config: AggregateConfig): AggregatedRealtimeDatum[];
|
|
52
63
|
/** Whether a config requests a band envelope. */
|
|
53
64
|
export declare function hasBand(config: AggregateConfig): boolean;
|
|
54
65
|
export type { AggregateStat, AggregateBand, WindowType };
|
|
@@ -5,14 +5,16 @@ import type { Datum } from "../shared/datumTypes";
|
|
|
5
5
|
import type { ChartModeInput, ChartModeResult } from "../shared/chartMode";
|
|
6
6
|
import type { LegendInteractionMode, LegendInteractionState } from "../shared/hooks";
|
|
7
7
|
import { type SelectionHookResult } from "../shared/selectionUtils";
|
|
8
|
-
import type { ChartMode, SelectionConfig } from "../shared/types";
|
|
8
|
+
import type { ChartAccessor, ChartMode, SelectionConfig } from "../shared/types";
|
|
9
|
+
/** Read a numeric time/value off a datum via accessor, with a field fallback. */
|
|
10
|
+
export declare function readRealtimeNumber<TDatum extends Datum>(datum: Datum, accessor: ChartAccessor<TDatum, number> | undefined, fallback: string): number | null;
|
|
9
11
|
interface RealtimeModeProps extends Omit<ChartModeInput, "enableHover"> {
|
|
10
12
|
mode?: ChartMode;
|
|
11
13
|
size?: [number, number];
|
|
12
14
|
enableHover?: unknown;
|
|
13
15
|
}
|
|
14
16
|
export declare function useRealtimeChartMode(props: RealtimeModeProps): ChartModeResult;
|
|
15
|
-
export declare function useRealtimeFrameHandle(ref: React.Ref<RealtimeFrameHandle
|
|
17
|
+
export declare function useRealtimeFrameHandle<TDatum extends Datum = Datum>(ref: React.Ref<RealtimeFrameHandle<TDatum>>, frameRef: React.RefObject<StreamXYFrameHandle | null>): void;
|
|
16
18
|
export declare function useRealtimeSelectionStyle<TStyle extends Datum>(baseStyle: ((datum: Datum) => TStyle) | undefined, hooks: readonly (SelectionHookResult | null)[], selection: SelectionConfig | undefined): ((datum: Datum) => TStyle) | undefined;
|
|
17
19
|
export declare function buildRealtimeFrameChromeProps(resolved: ChartModeResult, legend: LegendInteractionState, mode: LegendInteractionMode | undefined): {
|
|
18
20
|
title: string | undefined;
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
import type { Datum } from "../shared/datumTypes";
|
|
2
|
+
import type { StyleRuleContext } from "../shared/styleRules";
|
|
3
|
+
/** Resolve the visible aggregate carried by a realtime histogram segment. */
|
|
4
|
+
export declare function makeHistogramRuleContext(): (datum: Datum) => StyleRuleContext;
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Editorial-status visibility filter, kept free of the rest of the
|
|
3
|
+
* annotation-provenance module so SVG overlays do not pull the AI graph.
|
|
4
|
+
*/
|
|
5
|
+
export interface AnnotationStatusVisibility {
|
|
6
|
+
showRetractedAnnotations?: boolean;
|
|
7
|
+
showSupersededAnnotations?: boolean;
|
|
8
|
+
}
|
|
9
|
+
export type StatusFilterable = {
|
|
10
|
+
provenance?: {
|
|
11
|
+
stableId?: string;
|
|
12
|
+
};
|
|
13
|
+
lifecycle?: {
|
|
14
|
+
status?: string;
|
|
15
|
+
supersedes?: string;
|
|
16
|
+
};
|
|
17
|
+
};
|
|
18
|
+
export declare function filterAnnotationsByStatus<T extends StatusFilterable>(annotations: ReadonlyArray<T>, options?: AnnotationStatusVisibility): T[];
|
|
@@ -5,7 +5,8 @@
|
|
|
5
5
|
* metadata but never React components, frame stores, server renderers, or
|
|
6
6
|
* docs modules. The implementation, server, capability, and example links
|
|
7
7
|
* are strings so hosts can decide what to load. Existing registries remain
|
|
8
|
-
* authoritative while this seven-chart slice proves the boundary
|
|
8
|
+
* authoritative while this seven-chart slice proves the boundary; the AI
|
|
9
|
+
* schema generator now consumes this pilot for its seven component entries.
|
|
9
10
|
*/
|
|
10
11
|
import { type ChartCapabilities, type ChartCategory, type ChartPropSpec, type ChartSpec, type PropType } from "./chartSpecs";
|
|
11
12
|
/** Version of the definition shape, independently from the package version. */
|
|
@@ -120,9 +121,9 @@ export interface ChartDefinition<TChart extends string = string> {
|
|
|
120
121
|
*/
|
|
121
122
|
export declare function createChartDefinitionWireSchema(spec: ChartSpec): ChartDefinitionWireSchema;
|
|
122
123
|
/**
|
|
123
|
-
* One representative per chart family.
|
|
124
|
-
*
|
|
125
|
-
*
|
|
124
|
+
* One representative per chart family. The AI schema projection is the first
|
|
125
|
+
* migrated downstream registry; other consumers remain on their established
|
|
126
|
+
* registries until this boundary has enough evidence to expand.
|
|
126
127
|
*/
|
|
127
128
|
export declare const CHART_DEFINITION_PILOT: Readonly<{
|
|
128
129
|
[TChart in ChartDefinitionPilotId]: ChartDefinition<TChart>;
|
|
@@ -68,8 +68,8 @@ export interface ChartCapabilities {
|
|
|
68
68
|
* pure-synthetic charts (GaugeChart) declare false. */
|
|
69
69
|
supportsPush: boolean;
|
|
70
70
|
/** Renders to a static SVG via `renderChart()` from `semiotic/server`
|
|
71
|
-
* through a registered entry in `serverChartConfigs.ts`.
|
|
72
|
-
* charts
|
|
71
|
+
* through a registered entry in `serverChartConfigs.ts`. Live push-only
|
|
72
|
+
* charts declare false because no bounded static dataset was supplied. */
|
|
73
73
|
supportsSSR: boolean;
|
|
74
74
|
/**
|
|
75
75
|
* How color is consumed by the chart's data marks.
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import type { Datum } from "./datumTypes";
|
|
2
|
+
import { type StyleRuleContext } from "./styleRules";
|
|
3
|
+
/**
|
|
4
|
+
* Heatmap rules operate on two distinct public mark shapes:
|
|
5
|
+
*
|
|
6
|
+
* - ordinary cells retain the caller's row and resolve x/y/value accessors;
|
|
7
|
+
* - aggregated cells expose `{ value, count, sum, xCenter, yCenter, agg }`.
|
|
8
|
+
*
|
|
9
|
+
* The default `value` channel deliberately means the displayed aggregate for
|
|
10
|
+
* a derived cell. Callers can still target `count`, `sum`, or `agg` through a
|
|
11
|
+
* declarative `field`, while `axis: "x"|"y"` resolves the bin center.
|
|
12
|
+
*/
|
|
13
|
+
export declare function makeHeatmapRuleContext(xAccessor: string | ((d: Datum) => unknown) | undefined, yAccessor: string | ((d: Datum) => unknown) | undefined, valueAccessor: string | ((d: Datum) => unknown) | undefined): (datum: Datum) => StyleRuleContext;
|
|
@@ -5,5 +5,5 @@
|
|
|
5
5
|
* This compact registry is intentionally separate from validation metadata:
|
|
6
6
|
* config serialization only needs chart-name membership.
|
|
7
7
|
*/
|
|
8
|
-
export declare const KNOWN_CHART_COMPONENTS: readonly ["BarChart", "StackedBarChart", "GroupedBarChart", "SwarmPlot", "BoxPlot", "Histogram", "ViolinPlot", "RidgelinePlot", "DotPlot", "PieChart", "DonutChart", "GaugeChart", "FunnelChart", "SwimlaneChart", "LikertChart", "LineChart", "BumpChart", "AreaChart", "DifferenceChart", "StackedAreaChart", "Scatterplot", "BubbleChart", "Heatmap", "QuadrantChart", "MultiAxisLineChart", "CandlestickChart", "ConnectedScatterplot", "ScatterplotMatrix", "MinimapChart", "ForceDirectedGraph", "SankeyDiagram", "ProcessSankey", "ChordDiagram", "TreeDiagram", "Treemap", "CirclePack", "OrbitDiagram", "ChoroplethMap", "ProportionalSymbolMap", "FlowMap", "DistanceCartogram", "RealtimeLineChart", "RealtimeHistogram", "TemporalHistogram", "RealtimeSwarmChart", "RealtimeWaterfallChart", "RealtimeHeatmap", "GaltonBoardChart", "EventDropChart", "UnitPileChart", "CollisionSwarmChart", "GauntletChart", "CrucibleChart", "ProcessFlowChart", "PacketFlowChart", "ChainReactionChart", "BigNumber"];
|
|
8
|
+
export declare const KNOWN_CHART_COMPONENTS: readonly ["BarChart", "StackedBarChart", "GroupedBarChart", "SwarmPlot", "BoxPlot", "Histogram", "ViolinPlot", "RidgelinePlot", "DotPlot", "PieChart", "DonutChart", "GaugeChart", "FunnelChart", "RadarChart", "SwimlaneChart", "LikertChart", "LineChart", "BumpChart", "AreaChart", "DifferenceChart", "StackedAreaChart", "Scatterplot", "BubbleChart", "Heatmap", "QuadrantChart", "MultiAxisLineChart", "WaterfallChart", "CandlestickChart", "ConnectedScatterplot", "ScatterplotMatrix", "MinimapChart", "ForceDirectedGraph", "SankeyDiagram", "ProcessSankey", "ChordDiagram", "TreeDiagram", "Treemap", "CirclePack", "OrbitDiagram", "ChoroplethMap", "ProportionalSymbolMap", "FlowMap", "DistanceCartogram", "RealtimeLineChart", "RealtimeHistogram", "TemporalHistogram", "RealtimeSwarmChart", "RealtimeWaterfallChart", "RealtimeHeatmap", "GaltonBoardChart", "EventDropChart", "UnitPileChart", "CollisionSwarmChart", "GauntletChart", "CrucibleChart", "ProcessFlowChart", "PacketFlowChart", "ChainReactionChart", "BigNumber"];
|
|
9
9
|
export declare function isKnownChartComponent(componentName: string): boolean;
|
|
@@ -1,5 +1,19 @@
|
|
|
1
1
|
import type { Datum } from "./datumTypes";
|
|
2
|
+
import type { NetworkMarkStyle } from "../../stream/networkTypes";
|
|
2
3
|
import type { Accessor } from "./types";
|
|
4
|
+
import type { SelectionHookResult, SelectionStyleConfig } from "./selectionUtils";
|
|
5
|
+
/** Apply shared/legend selection to a network node's raw user datum. */
|
|
6
|
+
export declare function wrapNetworkNodeStyleWithSelection(baseStyle: undefined, selectionHook: SelectionHookResult | null, config?: SelectionStyleConfig): undefined;
|
|
7
|
+
export declare function wrapNetworkNodeStyleWithSelection(baseStyle: (datum: Datum) => NetworkMarkStyle, selectionHook: SelectionHookResult | null, config?: SelectionStyleConfig): (datum: Datum) => NetworkMarkStyle;
|
|
8
|
+
export declare function wrapNetworkNodeStyleWithSelection(baseStyle: ((datum: Datum) => NetworkMarkStyle) | undefined, selectionHook: SelectionHookResult | null, config?: SelectionStyleConfig): ((datum: Datum) => NetworkMarkStyle) | undefined;
|
|
9
|
+
/**
|
|
10
|
+
* Apply shared/legend selection to a network edge. When endpoint nodes are
|
|
11
|
+
* available, either endpoint may keep the edge emphasized; otherwise the
|
|
12
|
+
* predicate falls back to the edge payload.
|
|
13
|
+
*/
|
|
14
|
+
export declare function wrapNetworkEdgeStyleWithSelection(baseStyle: undefined, selectionHook: SelectionHookResult | null, config?: SelectionStyleConfig): undefined;
|
|
15
|
+
export declare function wrapNetworkEdgeStyleWithSelection(baseStyle: (datum: Datum) => NetworkMarkStyle, selectionHook: SelectionHookResult | null, config?: SelectionStyleConfig): (datum: Datum) => NetworkMarkStyle;
|
|
16
|
+
export declare function wrapNetworkEdgeStyleWithSelection(baseStyle: ((datum: Datum) => NetworkMarkStyle) | undefined, selectionHook: SelectionHookResult | null, config?: SelectionStyleConfig): ((datum: Datum) => NetworkMarkStyle) | undefined;
|
|
3
17
|
/**
|
|
4
18
|
* Flatten a hierarchical data structure into an array of all nodes
|
|
5
19
|
* by recursively traversing children.
|
|
@@ -75,5 +75,7 @@ export declare const DEFAULT_SELECTION_OPACITY = 0.5;
|
|
|
75
75
|
* or group-dependent styling (`fillArea: string[]`, `resolveStroke(d,
|
|
76
76
|
* group)` in `useXYLineStyle`'s MultiAxisLineChart path) silently
|
|
77
77
|
* drops to its no-group branch whenever a selection is active.
|
|
78
|
+
* `selectionDatum` adapts authored wrappers such as GeoJSON Features to the
|
|
79
|
+
* direct-field shape published by their interactive marks.
|
|
78
80
|
*/
|
|
79
|
-
export declare function wrapStyleWithSelection<TArgs extends unknown[]>(baseStyleFn: (d: Datum, ...args: TArgs) => Datum, selectionHook: SelectionHookResult | null, config?: SelectionStyleConfig): (d: Datum, ...args: TArgs) => Datum;
|
|
81
|
+
export declare function wrapStyleWithSelection<TArgs extends unknown[]>(baseStyleFn: (d: Datum, ...args: TArgs) => Datum, selectionHook: SelectionHookResult | null, config?: SelectionStyleConfig, selectionDatum?: (datum: Datum) => Datum): (d: Datum, ...args: TArgs) => Datum;
|
|
@@ -117,7 +117,8 @@ export interface BaseChartProps {
|
|
|
117
117
|
responsiveHeight?: boolean;
|
|
118
118
|
/**
|
|
119
119
|
* Maximum canvas backing-store pixel ratio. Defaults to 3 on desktop and 2
|
|
120
|
-
* on coarse-pointer/small-screen devices.
|
|
120
|
+
* on coarse-pointer/small-screen devices. Very large canvases are further
|
|
121
|
+
* capped by a shared backing-store budget. Canvas chart families repaint
|
|
121
122
|
* automatically when browser zoom or display density changes.
|
|
122
123
|
*/
|
|
123
124
|
maxDevicePixelRatio?: number;
|
|
@@ -230,7 +231,8 @@ export interface AxisConfig {
|
|
|
230
231
|
export type CategoryFormatFn = (label: string, index?: number) => string | React.ReactNode;
|
|
231
232
|
/**
|
|
232
233
|
* Accessor type - can be a property name or a function
|
|
233
|
-
* @deprecated Use
|
|
234
|
+
* @deprecated Use `ChartAccessor<TDatum, TValue>` for typed chart props.
|
|
235
|
+
* This legacy alias remains for compatibility with existing frame code.
|
|
234
236
|
*/
|
|
235
237
|
export type Accessor<T = DatumValue> = string | ((d: Datum, i?: number) => T);
|
|
236
238
|
/**
|
|
@@ -4,7 +4,8 @@ import type { LegendItem, LegendLayout, LegendValue } from "../../types/legendTy
|
|
|
4
4
|
import { type AxisChromeInput } from "../../legendLayout";
|
|
5
5
|
import type { Datum } from "./datumTypes";
|
|
6
6
|
/**
|
|
7
|
-
* Distinct string-coerced `colorBy` values across `data`, in
|
|
7
|
+
* Distinct non-null, string-coerced `colorBy` values across `data`, in
|
|
8
|
+
* first-seen order.
|
|
8
9
|
* Shared by chart setup hooks that need the category list for a color scale
|
|
9
10
|
* or legend before any scale/legend object is built.
|
|
10
11
|
*/
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import type { RefObject, MutableRefObject } from "react";
|
|
2
2
|
import type { StreamOrdinalFrameHandle } from "../../stream/ordinalTypes";
|
|
3
3
|
import type { Datum } from "./datumTypes";
|
|
4
|
-
export interface AggregatedRow {
|
|
4
|
+
export interface AggregatedRow extends Datum {
|
|
5
5
|
__likertCategory: string;
|
|
6
6
|
/** Stacking key — may be sentinel value for neutral halves */
|
|
7
7
|
__likertLevel: string;
|
|
@@ -11,6 +11,12 @@ export interface AggregatedRow {
|
|
|
11
11
|
__likertPct: number;
|
|
12
12
|
__likertLevelIndex: number;
|
|
13
13
|
}
|
|
14
|
+
export interface LikertAggregationFieldAliases {
|
|
15
|
+
category?: string;
|
|
16
|
+
level?: string;
|
|
17
|
+
count?: string;
|
|
18
|
+
score?: string;
|
|
19
|
+
}
|
|
14
20
|
/** Sentinel level names for the neutral split halves */
|
|
15
21
|
export declare const NEUTRAL_NEG = "__likert_neutral_neg";
|
|
16
22
|
export declare const NEUTRAL_POS = "__likert_neutral_pos";
|
|
@@ -30,7 +36,7 @@ export declare function resolveAccessorFn<T>(accessor: string | ((d: Datum) => T
|
|
|
30
36
|
* Interpolates from red → gray → blue for odd, red → blue for even.
|
|
31
37
|
*/
|
|
32
38
|
export declare function defaultDivergingScheme(n: number, themeDivergingSchemeName?: string): string[];
|
|
33
|
-
export declare function aggregateData(data: Datum[], levels: string[], getCat: (d: Datum) => string, getScore: ((d: Datum) => number) | null, getLevel: ((d: Datum) => string) | null, getCount: ((d: Datum) => number) | null): AggregatedRow[];
|
|
39
|
+
export declare function aggregateData(data: Datum[], levels: string[], getCat: (d: Datum) => string, getScore: ((d: Datum) => number) | null, getLevel: ((d: Datum) => string) | null, getCount: ((d: Datum) => number) | null, fieldAliases?: LikertAggregationFieldAliases): AggregatedRow[];
|
|
34
40
|
export declare function toDivergingValues(rows: AggregatedRow[], levels: string[]): AggregatedRow[];
|
|
35
41
|
export declare function orderForDiverging(rows: AggregatedRow[], levels: string[]): AggregatedRow[];
|
|
36
42
|
interface UseLikertAggregationConfig {
|
|
@@ -6,6 +6,7 @@ import type { OnObservationCallback } from "../../store/ObservationStore";
|
|
|
6
6
|
import type { PartialMargin, MarginType } from "../../types/marginType";
|
|
7
7
|
import { useChartSelection, useChartLegendAndMargin } from "./hooks";
|
|
8
8
|
import type { FrameLegendOverrides, LegendInteractionMode, LegendPosition, LegendInteractionState } from "./hooks";
|
|
9
|
+
import type { SelectionHookResult } from "./selectionUtils";
|
|
9
10
|
export interface NetworkChartSetupInput<TNode extends Datum = Datum, TEdge extends Datum = Datum> {
|
|
10
11
|
/** Raw `nodes` prop (may be undefined). */
|
|
11
12
|
nodes: TNode[] | undefined;
|
|
@@ -94,7 +95,7 @@ export interface NetworkChartSetupResult {
|
|
|
94
95
|
*/
|
|
95
96
|
effectivePalette: string[];
|
|
96
97
|
themeCategorical: string[] | undefined;
|
|
97
|
-
/** Distinct category values from
|
|
98
|
+
/** Distinct category values from bounded data or the live push-mode frame. */
|
|
98
99
|
allCategories: string[];
|
|
99
100
|
legendState: LegendInteractionState;
|
|
100
101
|
legend: ReturnType<typeof useChartLegendAndMargin>["legend"];
|
|
@@ -108,13 +109,16 @@ export interface NetworkChartSetupResult {
|
|
|
108
109
|
/**
|
|
109
110
|
* The full selection-hook output. Most network HOCs only need the
|
|
110
111
|
* resolved hover/click behaviors above, but hierarchy charts
|
|
111
|
-
*
|
|
112
|
-
*
|
|
113
|
-
*
|
|
114
|
-
* a parallel `useChartSelection` call.
|
|
112
|
+
* Custom network layouts can consume the underlying shared selection
|
|
113
|
+
* directly. Built-in charts normally use `effectiveSelectionHook`, which
|
|
114
|
+
* also includes hover and legend interaction.
|
|
115
115
|
*/
|
|
116
116
|
activeSelectionHook: ReturnType<typeof useChartSelection>["activeSelectionHook"];
|
|
117
117
|
hoverSelectionHook: ReturnType<typeof useChartSelection>["hoverSelectionHook"];
|
|
118
|
+
/** Hover, legend, or shared selection in precedence order. */
|
|
119
|
+
effectiveSelectionHook: SelectionHookResult | null;
|
|
120
|
+
/** Selection styling with the active theme's default dim opacity. */
|
|
121
|
+
resolvedSelection: SelectionConfig | undefined;
|
|
118
122
|
crosshairSourceId: ReturnType<typeof useChartSelection>["crosshairSourceId"];
|
|
119
123
|
/** When non-null, render this element instead of the chart. */
|
|
120
124
|
loadingEl: ReactElement | null;
|
|
@@ -86,7 +86,7 @@ export interface OrdinalPieceStyleOptions {
|
|
|
86
86
|
* (typically the chart's `valueAccessor` output). Lets `{ when: { gt: 10 } }`
|
|
87
87
|
* work with no `field` on the threshold.
|
|
88
88
|
*/
|
|
89
|
-
resolveRuleValue?: (d: Datum) => number | undefined;
|
|
89
|
+
resolveRuleValue?: (d: Datum, category?: string) => number | undefined;
|
|
90
90
|
}
|
|
91
91
|
/**
|
|
92
92
|
* Build a memoized `pieceStyle` function that the chart can pass
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
import type { ChartAccessor, LinkedBrushProp } from "./types";
|
|
2
|
+
import type { Datum } from "./datumTypes";
|
|
3
|
+
export type XYBrushExtent = {
|
|
4
|
+
x: [number, number];
|
|
5
|
+
y: [number, number];
|
|
6
|
+
};
|
|
7
|
+
export interface XYBrushInput<TDatum extends Datum = Datum> {
|
|
8
|
+
brush?: boolean;
|
|
9
|
+
onBrush?: (extent: XYBrushExtent | null) => void;
|
|
10
|
+
linkedBrush?: LinkedBrushProp;
|
|
11
|
+
xAccessor?: ChartAccessor<TDatum, unknown>;
|
|
12
|
+
yAccessor?: ChartAccessor<TDatum, unknown>;
|
|
13
|
+
/** Default brush dimension when `brush` is true without a linked config. */
|
|
14
|
+
defaultDimension?: "x" | "y" | "xy";
|
|
15
|
+
}
|
|
16
|
+
export interface XYBrushResult {
|
|
17
|
+
brushStreamProps: {
|
|
18
|
+
brush: {
|
|
19
|
+
dimension: "x" | "y" | "xy";
|
|
20
|
+
};
|
|
21
|
+
onBrush: (extent: XYBrushExtent | null) => void;
|
|
22
|
+
} | Record<string, never>;
|
|
23
|
+
}
|
|
24
|
+
export declare function useXYBrush<TDatum extends Datum = Datum>({ brush, onBrush: onBrushProp, linkedBrush, xAccessor, yAccessor, defaultDimension, }: XYBrushInput<TDatum>): XYBrushResult;
|
|
@@ -6,6 +6,7 @@ import type { GradientLegendValue } from "../../types/legendTypes";
|
|
|
6
6
|
import type { LegendInteractionMode } from "../shared/hooks";
|
|
7
7
|
import type { BaseChartProps, ChartAccessor } from "../shared/types";
|
|
8
8
|
import { type TooltipProp } from "../../Tooltip/Tooltip";
|
|
9
|
+
import { type StyleRule } from "../shared/styleRules";
|
|
9
10
|
/**
|
|
10
11
|
* Heatmap component props
|
|
11
12
|
*/
|
|
@@ -117,6 +118,21 @@ export interface HeatmapProps<TDatum extends Datum = Datum> extends BaseChartPro
|
|
|
117
118
|
* Annotation objects to render on the chart
|
|
118
119
|
*/
|
|
119
120
|
annotations?: Datum[];
|
|
121
|
+
/**
|
|
122
|
+
* Bin continuous x/y into a grid (`count` / `sum` / `mean`). Dense numeric
|
|
123
|
+
* heatmaps (more than 4096 distinct cells) auto-bin even when this is omitted.
|
|
124
|
+
*/
|
|
125
|
+
heatmapAggregation?: "count" | "sum" | "mean";
|
|
126
|
+
/** Number of x bins when aggregating. @default 20 */
|
|
127
|
+
heatmapXBins?: number;
|
|
128
|
+
/** Number of y bins when aggregating. @default 20 */
|
|
129
|
+
heatmapYBins?: number;
|
|
130
|
+
/**
|
|
131
|
+
* Ordered data-aware cell styling. Aggregated cells expose `value`, `count`,
|
|
132
|
+
* `sum`, `xCenter`, `yCenter`, and `agg`; the default rule value is the
|
|
133
|
+
* displayed aggregate and x/y channels are bin centers.
|
|
134
|
+
*/
|
|
135
|
+
styleRules?: StyleRule[];
|
|
120
136
|
/** Fixed x domain `[min, max]` (either bound may be undefined to leave that side data-derived). */
|
|
121
137
|
xExtent?: [number | undefined, number | undefined] | [number];
|
|
122
138
|
/** Fixed y domain `[min, max]` (either bound may be undefined to leave that side data-derived). */
|
|
@@ -130,6 +130,15 @@ export interface LineChartProps<TDatum extends Datum = Datum> extends BaseChartP
|
|
|
130
130
|
* @default true
|
|
131
131
|
*/
|
|
132
132
|
enableHover?: boolean;
|
|
133
|
+
/**
|
|
134
|
+
* Enable an x-axis brush overlay. Also enabled when `linkedBrush` is set.
|
|
135
|
+
*/
|
|
136
|
+
brush?: boolean;
|
|
137
|
+
/** Callback with `{ x, y }` extents, or null when the brush clears. */
|
|
138
|
+
onBrush?: (extent: {
|
|
139
|
+
x: [number, number];
|
|
140
|
+
y: [number, number];
|
|
141
|
+
} | null) => void;
|
|
133
142
|
/**
|
|
134
143
|
* Show grid lines
|
|
135
144
|
* @default false
|
|
@@ -54,6 +54,13 @@ export interface ScatterplotProps<TDatum extends Datum = Datum> extends BaseChar
|
|
|
54
54
|
pointOpacity?: number;
|
|
55
55
|
/** Enable hover annotations @default true */
|
|
56
56
|
enableHover?: boolean;
|
|
57
|
+
/** Enable an xy brush overlay. Also enabled when `linkedBrush` is set. */
|
|
58
|
+
brush?: boolean;
|
|
59
|
+
/** Callback with `{ x, y }` extents, or null when the brush clears. */
|
|
60
|
+
onBrush?: (extent: {
|
|
61
|
+
x: [number, number];
|
|
62
|
+
y: [number, number];
|
|
63
|
+
} | null) => void;
|
|
57
64
|
/** Show grid lines @default false */
|
|
58
65
|
showGrid?: boolean;
|
|
59
66
|
/** Show legend @default true (when colorBy is specified) */
|