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
|
@@ -6,7 +6,7 @@ import type { ActiveTransition } from "./pipelineTransitionUtils";
|
|
|
6
6
|
import type { Datum } from "../charts/shared/datumTypes";
|
|
7
7
|
import type { GeoLayoutResult } from "./geoCustomLayout";
|
|
8
8
|
import type { CustomLayoutSelection } from "./customLayoutSelection";
|
|
9
|
-
import {
|
|
9
|
+
import type { CustomLayoutFailureDiagnostic } from "./customLayoutFailure";
|
|
10
10
|
import { GeoPipelineUpdateResults } from "./geoPipelineUpdateResults";
|
|
11
11
|
import { type UpdateResult, type UpdateResultStore } from "./pipelineUpdateStore";
|
|
12
12
|
export declare class GeoPipelineStore implements UpdateResultStore {
|
|
@@ -1,6 +1,8 @@
|
|
|
1
1
|
import * as React from "react";
|
|
2
2
|
import type { ScaleLinear } from "d3-scale";
|
|
3
|
-
import type { MarginalConfig
|
|
3
|
+
import type { MarginalConfig } from "./types";
|
|
4
|
+
import { normalizeMarginalConfig } from "./marginalConfig";
|
|
5
|
+
export { normalizeMarginalConfig };
|
|
4
6
|
export type MarginalOrient = "top" | "bottom" | "left" | "right";
|
|
5
7
|
export interface MarginalGraphicsProps {
|
|
6
8
|
orient: MarginalOrient;
|
|
@@ -14,6 +16,4 @@ export interface MarginalGraphicsProps {
|
|
|
14
16
|
/** Chart width (top/bottom) or height (left/right) */
|
|
15
17
|
length: number;
|
|
16
18
|
}
|
|
17
|
-
/** Resolve a string shorthand or full config into a MarginalConfig */
|
|
18
|
-
export declare function normalizeMarginalConfig(input: MarginalConfig | MarginalType): MarginalConfig;
|
|
19
19
|
export declare function MarginalGraphics({ orient, config: rawConfig, values, scale, size, length }: MarginalGraphicsProps): React.JSX.Element | null;
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Lazy wrapper for MarginalGraphics.
|
|
3
|
+
*
|
|
4
|
+
* d3-array binning is unused on charts that never set `marginalGraphics`,
|
|
5
|
+
* so keep that graph off the default LineChart cold path. Charts that do
|
|
6
|
+
* request marginals (Scatterplot, BubbleChart) call
|
|
7
|
+
* {@link provideMarginalGraphics} with a value import so SSR and the
|
|
8
|
+
* hydration SVG pass can paint immediately.
|
|
9
|
+
*/
|
|
10
|
+
import * as React from "react";
|
|
11
|
+
import type { Datum } from "../charts/shared/datumTypes";
|
|
12
|
+
import type { MarginalGraphicsProps } from "./MarginalGraphics";
|
|
13
|
+
import { normalizeMarginalConfig } from "./marginalConfig";
|
|
14
|
+
export { normalizeMarginalConfig };
|
|
15
|
+
type MarginalComponent = React.ComponentType<MarginalGraphicsProps>;
|
|
16
|
+
/** Eagerly install the painter. Call from HOCs that expose `marginalGraphics`. */
|
|
17
|
+
export declare function provideMarginalGraphics(Comp: MarginalComponent): void;
|
|
18
|
+
export declare function collectMarginalValues(data: readonly Datum[], xAccessor: unknown, yAccessor: unknown): {
|
|
19
|
+
xValues: number[];
|
|
20
|
+
yValues: number[];
|
|
21
|
+
};
|
|
22
|
+
export declare function MarginalGraphicsLazy(props: MarginalGraphicsProps): React.JSX.Element | null;
|
|
@@ -38,6 +38,8 @@ export declare class NetworkPipelineStore implements UpdateResultStore {
|
|
|
38
38
|
sceneNodes: NetworkSceneNode[];
|
|
39
39
|
sceneEdges: NetworkSceneEdge[];
|
|
40
40
|
labels: NetworkLabel[];
|
|
41
|
+
/** Backgrounds returned from customNetworkLayout (consumed by StreamNetworkFrame). */
|
|
42
|
+
customLayoutBackgrounds: import("react").ReactNode;
|
|
41
43
|
/** Overlays returned from customNetworkLayout (consumed by StreamNetworkFrame). */
|
|
42
44
|
customLayoutOverlays: import("react").ReactNode;
|
|
43
45
|
/** Most recent custom layout result for host readback (`getCustomLayout()`).
|
|
@@ -22,7 +22,7 @@ import type { Changeset, PointSceneNode } from "./types";
|
|
|
22
22
|
import type { ActiveTransition } from "./pipelineTransitionUtils";
|
|
23
23
|
import type { OrdinalLayoutResult } from "./ordinalCustomLayout";
|
|
24
24
|
import type { CustomLayoutSelection } from "./customLayoutSelection";
|
|
25
|
-
import {
|
|
25
|
+
import type { CustomLayoutFailureDiagnostic } from "./customLayoutFailure";
|
|
26
26
|
import { type UpdateResult, type UpdateResultStore } from "./pipelineUpdateStore";
|
|
27
27
|
import { OrdinalPipelineUpdateResults } from "./ordinalPipelineUpdateResults";
|
|
28
28
|
export declare class OrdinalPipelineStore implements UpdateResultStore {
|
|
@@ -23,7 +23,7 @@ import { type ActiveTransition } from "./pipelineTransitionUtils";
|
|
|
23
23
|
import type { ResolvedRibbon } from "./xySceneBuilders/ribbonScene";
|
|
24
24
|
import type { LayoutResult } from "./customLayout";
|
|
25
25
|
import type { CustomLayoutSelection } from "./customLayoutSelection";
|
|
26
|
-
import {
|
|
26
|
+
import type { CustomLayoutFailureDiagnostic } from "./customLayoutFailure";
|
|
27
27
|
import { type PipelineConfig } from "./pipelineConfig";
|
|
28
28
|
import type { UpdateResult } from "./pipelineUpdateContract";
|
|
29
29
|
import { type UpdateResultStore } from "./pipelineUpdateStore";
|
|
@@ -21,4 +21,4 @@ export declare function xySceneNodeToSVG(node: SceneNode, i: number, idPrefix?:
|
|
|
21
21
|
* Returns true when running in a true server/Node.js context where
|
|
22
22
|
* window and document are not available.
|
|
23
23
|
*/
|
|
24
|
-
export
|
|
24
|
+
export { isServerEnvironment } from "./isServerEnvironment";
|
|
@@ -10,6 +10,8 @@ export interface CanvasMargin {
|
|
|
10
10
|
bottom: number;
|
|
11
11
|
left: number;
|
|
12
12
|
}
|
|
13
|
+
/** Repaint canvas text after an asynchronously loaded web font becomes usable. */
|
|
14
|
+
export declare function subscribeToCanvasFontInvalidation(listener: () => void): () => void;
|
|
13
15
|
/**
|
|
14
16
|
* Keep a canvas's backing store and CSS box aligned with the frame size.
|
|
15
17
|
* This is separate from context preparation so an idle interaction layer can
|
|
@@ -33,9 +35,13 @@ export declare function prepareCanvas(canvas: HTMLCanvasElement, size: [number,
|
|
|
33
35
|
* Get the effective canvas devicePixelRatio, defaulting to 1 in non-browser
|
|
34
36
|
* environments. By default, mobile/coarse-pointer screens are capped at 2x to
|
|
35
37
|
* avoid allocating very large backing stores on high-density phones and
|
|
36
|
-
* desktop is capped at 3x. `maxDevicePixelRatio` overrides that ceiling.
|
|
38
|
+
* desktop is capped at 3x. `maxDevicePixelRatio` overrides that DPR ceiling.
|
|
39
|
+
* When `size` is supplied, very large canvases receive an additional backing-
|
|
40
|
+
* store cap so full repaints do not allocate or clear tens of megapixels and
|
|
41
|
+
* DPR scaling does not push a physical side beyond the broadly supported 16K
|
|
42
|
+
* range.
|
|
37
43
|
*/
|
|
38
|
-
export declare function getDevicePixelRatio(maxDevicePixelRatio?: number): number;
|
|
44
|
+
export declare function getDevicePixelRatio(maxDevicePixelRatio?: number, size?: readonly [number, number]): number;
|
|
39
45
|
/**
|
|
40
46
|
* Subscribe to browser pixel-density changes (page zoom, display migration,
|
|
41
47
|
* or OS display-scale changes). A normal ResizeObserver is insufficient:
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
import { type CustomLayoutFamily, type CustomLayoutFailureDiagnostic } from "./customLayoutFailure";
|
|
2
|
+
export type CustomLayoutAttemptResult<T> = {
|
|
3
|
+
kind: "success";
|
|
4
|
+
result: T;
|
|
5
|
+
} | {
|
|
6
|
+
kind: "failure";
|
|
7
|
+
diagnostic: CustomLayoutFailureDiagnostic;
|
|
8
|
+
preservedLastGoodScene: boolean;
|
|
9
|
+
};
|
|
10
|
+
/**
|
|
11
|
+
* Shared custom-layout try/catch + diagnostic + onLayoutError boundary.
|
|
12
|
+
* Each family store still applies its own success/failure scene recovery.
|
|
13
|
+
*/
|
|
14
|
+
export declare function runCustomLayoutAttempt<T>(options: {
|
|
15
|
+
family: CustomLayoutFamily;
|
|
16
|
+
logLabel: string;
|
|
17
|
+
revision: number;
|
|
18
|
+
hasPreviousResult: boolean;
|
|
19
|
+
onLayoutError?: (diagnostic: CustomLayoutFailureDiagnostic) => void;
|
|
20
|
+
run: () => T;
|
|
21
|
+
}): CustomLayoutAttemptResult<T>;
|
|
@@ -206,7 +206,7 @@ export interface StreamGeoFrameProps<T = Datum> {
|
|
|
206
206
|
};
|
|
207
207
|
className?: string;
|
|
208
208
|
background?: string;
|
|
209
|
-
/** Maximum canvas backing-store DPR;
|
|
209
|
+
/** Maximum canvas backing-store DPR; large canvases also use the shared backing-store budget. */
|
|
210
210
|
maxDevicePixelRatio?: number;
|
|
211
211
|
runtimeMode?: "bounded" | "streaming";
|
|
212
212
|
/** Maximum retained points and lines after imperative streaming begins. @default 500 */
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import type { Datum } from "../../charts/shared/datumTypes";
|
|
2
|
+
import type { RealtimeNode } from "../networkTypes";
|
|
3
|
+
/**
|
|
4
|
+
* Build a function that returns a node radius. If `nodeSize` is a number,
|
|
5
|
+
* use it directly. If it is a string accessor, look up `node.data[nodeSize]`
|
|
6
|
+
* and scale the result to `nodeSizeRange`. If it is a function, call it.
|
|
7
|
+
* Falls back to a default radius of 8.
|
|
8
|
+
*
|
|
9
|
+
* Lives outside `forceLayoutPlugin` so the force worker client can serialize
|
|
10
|
+
* radii without importing d3-force.
|
|
11
|
+
*/
|
|
12
|
+
export declare function resolveNodeSizeFn(nodeSize: number | string | ((d: Datum) => number) | undefined, nodeSizeRange: [number, number] | undefined, allNodes: RealtimeNode[]): (node: RealtimeNode) => number;
|
|
@@ -1,10 +1,3 @@
|
|
|
1
|
-
import type { NetworkLayoutPlugin
|
|
2
|
-
import type { Datum } from "../../charts/shared/datumTypes";
|
|
1
|
+
import type { NetworkLayoutPlugin } from "../networkTypes";
|
|
3
2
|
export declare const forceLayoutPlugin: NetworkLayoutPlugin;
|
|
4
|
-
|
|
5
|
-
* Build a function that returns a node radius. If `nodeSize` is a number,
|
|
6
|
-
* use it directly. If it is a string accessor, look up `node.data[nodeSize]`
|
|
7
|
-
* and scale the result to `nodeSizeRange`. If it is a function, call it.
|
|
8
|
-
* Falls back to a default radius of 8.
|
|
9
|
-
*/
|
|
10
|
-
export declare function resolveNodeSizeFn(nodeSize: number | string | ((d: Datum) => number) | undefined, nodeSizeRange: [number, number] | undefined, allNodes: RealtimeNode[]): (node: RealtimeNode) => number;
|
|
3
|
+
export { resolveNodeSizeFn } from "./forceLayoutNodeSize";
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import type { GraphEdge, GraphNode, Point } from "../../recipes/networkAnalysis";
|
|
2
2
|
import type { ForceLayoutOptions } from "../../recipes/forceLayout";
|
|
3
|
-
import
|
|
4
|
-
export type ForceLayoutExecution
|
|
3
|
+
import { type FrameForceWorkerRequest } from "./forceLayoutWorkerPolicy";
|
|
4
|
+
export { canUseForceWorker, createFrameForceWorkerRequest, DEFAULT_FORCE_WORKER_THRESHOLD, shouldUseForceWorker, type ForceLayoutExecution, type FrameForceWorkerRequest, } from "./forceLayoutWorkerPolicy";
|
|
5
5
|
export interface NormalizedForceWorkerRequest {
|
|
6
6
|
kind: "normalized";
|
|
7
7
|
nodes: GraphNode[];
|
|
@@ -9,30 +9,11 @@ export interface NormalizedForceWorkerRequest {
|
|
|
9
9
|
options: Omit<ForceLayoutOptions, "nodeRadius">;
|
|
10
10
|
nodeRadii?: Record<string, number>;
|
|
11
11
|
}
|
|
12
|
-
export interface FrameForceWorkerRequest {
|
|
13
|
-
kind: "frame";
|
|
14
|
-
nodes: RealtimeNode[];
|
|
15
|
-
edges: RealtimeEdge[];
|
|
16
|
-
config: {
|
|
17
|
-
chartType: "force";
|
|
18
|
-
iterations?: number;
|
|
19
|
-
forceStrength?: number;
|
|
20
|
-
seed?: number;
|
|
21
|
-
};
|
|
22
|
-
size: [number, number];
|
|
23
|
-
}
|
|
24
12
|
export type ForceWorkerRequest = NormalizedForceWorkerRequest | FrameForceWorkerRequest;
|
|
25
13
|
export interface ForceWorkerResponse {
|
|
26
14
|
positions: Record<string, Point>;
|
|
27
15
|
}
|
|
28
|
-
export declare const DEFAULT_FORCE_WORKER_THRESHOLD = 40000;
|
|
29
|
-
export declare function shouldUseForceWorker(execution: ForceLayoutExecution, nodeCount: number, edgeCount: number, iterations: number, threshold?: number): boolean;
|
|
30
|
-
export declare function canUseForceWorker(): boolean;
|
|
31
16
|
export declare function createForceLayoutWorker(): Worker;
|
|
32
|
-
export declare function createFrameForceWorkerRequest(nodes: RealtimeNode[], edges: RealtimeEdge[], config: NetworkPipelineConfig, size: [number, number], previousPositions?: Map<string, {
|
|
33
|
-
x: number;
|
|
34
|
-
y: number;
|
|
35
|
-
}> | null): FrameForceWorkerRequest;
|
|
36
17
|
/**
|
|
37
18
|
* Long-lived force-layout worker session. Built on {@link ModuleWorkerSession}
|
|
38
19
|
* so request-id / abort / terminate plumbing is shared with ProcessSankey.
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
import type { NetworkPipelineConfig, RealtimeEdge, RealtimeNode } from "../networkTypes";
|
|
2
|
+
export type ForceLayoutExecution = "auto" | "worker" | "sync";
|
|
3
|
+
export interface FrameForceWorkerRequest {
|
|
4
|
+
kind: "frame";
|
|
5
|
+
nodes: RealtimeNode[];
|
|
6
|
+
edges: RealtimeEdge[];
|
|
7
|
+
config: {
|
|
8
|
+
chartType: "force";
|
|
9
|
+
iterations?: number;
|
|
10
|
+
forceStrength?: number;
|
|
11
|
+
seed?: number;
|
|
12
|
+
};
|
|
13
|
+
size: [number, number];
|
|
14
|
+
}
|
|
15
|
+
export declare const DEFAULT_FORCE_WORKER_THRESHOLD = 40000;
|
|
16
|
+
export declare function shouldUseForceWorker(execution: ForceLayoutExecution, nodeCount: number, edgeCount: number, iterations: number, threshold?: number): boolean;
|
|
17
|
+
export declare function canUseForceWorker(): boolean;
|
|
18
|
+
export declare function createFrameForceWorkerRequest(nodes: RealtimeNode[], edges: RealtimeEdge[], config: NetworkPipelineConfig, size: [number, number], previousPositions?: Map<string, {
|
|
19
|
+
x: number;
|
|
20
|
+
y: number;
|
|
21
|
+
}> | null): FrameForceWorkerRequest;
|
|
@@ -1,12 +1,6 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
/**
|
|
8
|
-
* Registry mapping network chart types to their layout plugins.
|
|
9
|
-
*/
|
|
10
|
-
export declare const networkLayoutRegistry: Record<NetworkChartType, NetworkLayoutPlugin>;
|
|
11
|
-
export declare function getLayoutPlugin(chartType: NetworkChartType): NetworkLayoutPlugin | undefined;
|
|
12
|
-
export { sankeyLayoutPlugin, forceLayoutPlugin, chordLayoutPlugin, hierarchyLayoutPlugin, orbitLayoutPlugin };
|
|
1
|
+
export { getLayoutPlugin, registerLayoutPlugin } from "./registry";
|
|
2
|
+
export { sankeyLayoutPlugin } from "./sankeyLayoutPlugin";
|
|
3
|
+
export { forceLayoutPlugin } from "./forceLayoutPlugin";
|
|
4
|
+
export { chordLayoutPlugin } from "./chordLayoutPlugin";
|
|
5
|
+
export { hierarchyLayoutPlugin } from "./hierarchyLayoutPlugin";
|
|
6
|
+
export { orbitLayoutPlugin } from "./orbitLayoutPlugin";
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
import type { NetworkChartType } from "../networkTypes";
|
|
2
|
+
/**
|
|
3
|
+
* Direct StreamNetworkFrame usage no longer loads every layout. Warn once in
|
|
4
|
+
* development when a chartType has no registered plugin so the empty scene is
|
|
5
|
+
* not silent.
|
|
6
|
+
*/
|
|
7
|
+
export declare function warnIfLayoutPluginMissing(chartType: NetworkChartType): void;
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export declare function registerBuiltInNetworkLayouts(): void;
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import type { NetworkChartType, NetworkLayoutPlugin } from "../networkTypes";
|
|
2
|
+
/**
|
|
3
|
+
* Register a network layout plugin. Call this with a value import of the
|
|
4
|
+
* plugin — `package.json` has `"sideEffects": false`, so a bare
|
|
5
|
+
* `import "./sankeyLayoutPlugin"` may be dropped by consumer bundlers.
|
|
6
|
+
*
|
|
7
|
+
* Chart HOCs register only the plugin they need. Direct StreamNetworkFrame
|
|
8
|
+
* users should import the matching plugin or call
|
|
9
|
+
* {@link registerBuiltInNetworkLayouts} from `semiotic/network`.
|
|
10
|
+
*/
|
|
11
|
+
export declare function registerLayoutPlugin(chartType: NetworkChartType, plugin: NetworkLayoutPlugin): void;
|
|
12
|
+
export declare function getLayoutPlugin(chartType: NetworkChartType): NetworkLayoutPlugin | undefined;
|
|
@@ -135,6 +135,13 @@ export interface NetworkLayoutResult {
|
|
|
135
135
|
sceneEdges?: NetworkSceneEdge[];
|
|
136
136
|
/** Optional labels placed at arbitrary plot-relative positions. */
|
|
137
137
|
labels?: NetworkLabel[];
|
|
138
|
+
/**
|
|
139
|
+
* SVG graphics composited below the canvas scene. Use for layout-derived
|
|
140
|
+
* regions and enclosures that must sit behind edges and nodes while sharing
|
|
141
|
+
* their fitted plot coordinates. Backgrounds are non-interactive and are
|
|
142
|
+
* included in live, hydrated, and static SVG rendering.
|
|
143
|
+
*/
|
|
144
|
+
backgrounds?: ReactNode;
|
|
138
145
|
/** SVG overlays composited above the canvas. */
|
|
139
146
|
overlays?: ReactNode;
|
|
140
147
|
/**
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import type { ReactNode } from "react";
|
|
2
|
+
import type { NetworkHtmlMark, NetworkLayoutResult } from "./networkCustomLayout";
|
|
3
|
+
/** Mutable custom-layout output fields owned by NetworkPipelineStore. */
|
|
4
|
+
export interface NetworkCustomLayoutOutputTarget {
|
|
5
|
+
customLayoutBackgrounds: ReactNode;
|
|
6
|
+
customLayoutOverlays: ReactNode;
|
|
7
|
+
customLayoutHtmlMarks: NetworkHtmlMark[];
|
|
8
|
+
lastCustomLayoutResult: NetworkLayoutResult | null;
|
|
9
|
+
}
|
|
10
|
+
/** Apply the non-scene output from one successful custom-layout result atomically. */
|
|
11
|
+
export declare function applyNetworkCustomLayoutOutput(target: NetworkCustomLayoutOutputTarget, result: NetworkLayoutResult): void;
|
|
12
|
+
/** Clear every non-scene custom-layout output when its owning layout is gone. */
|
|
13
|
+
export declare function clearNetworkCustomLayoutOutput(target: NetworkCustomLayoutOutputTarget): void;
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import type { NetworkLayoutResult } from "./networkCustomLayout";
|
|
2
|
-
import {
|
|
2
|
+
import type { CustomLayoutFailureDiagnostic } from "./customLayoutFailure";
|
|
3
3
|
import type { NetworkPipelineConfig, RealtimeEdge, RealtimeNode } from "./networkTypes";
|
|
4
4
|
interface NetworkCustomLayoutRunInput {
|
|
5
5
|
config: NetworkPipelineConfig;
|
|
@@ -614,7 +614,7 @@ export interface StreamNetworkFrameProps<T = Datum> extends StreamNetworkInterac
|
|
|
614
614
|
};
|
|
615
615
|
className?: string;
|
|
616
616
|
background?: string;
|
|
617
|
-
/** Maximum canvas backing-store DPR;
|
|
617
|
+
/** Maximum canvas backing-store DPR; large canvases also use the shared backing-store budget. */
|
|
618
618
|
maxDevicePixelRatio?: number;
|
|
619
619
|
legend?: LegendValue;
|
|
620
620
|
legendPosition?: "right" | "left" | "top" | "bottom";
|
|
@@ -627,6 +627,10 @@ export interface StreamNetworkFrameProps<T = Datum> extends StreamNetworkInterac
|
|
|
627
627
|
}) => void;
|
|
628
628
|
legendHighlightedCategory?: string | null;
|
|
629
629
|
legendIsolatedCategories?: Set<string>;
|
|
630
|
+
/** Internal push-mode category discovery accessor used by chart HOCs. */
|
|
631
|
+
legendCategoryAccessor?: string | ((d: T) => string | number);
|
|
632
|
+
/** Receives the current pushed-node category domain. */
|
|
633
|
+
onCategoriesChange?: (categories: string[]) => void;
|
|
630
634
|
title?: string | ReactNode;
|
|
631
635
|
/** SVG above the canvas. Network layouts have no shared scale object, so callback `scales` is null. */
|
|
632
636
|
foregroundGraphics?: FrameGraphicsProp<null>;
|
|
@@ -330,7 +330,7 @@ export interface StreamOrdinalFrameProps<T = Datum> {
|
|
|
330
330
|
bottom?: number;
|
|
331
331
|
left?: number;
|
|
332
332
|
};
|
|
333
|
-
/** Maximum canvas backing-store DPR;
|
|
333
|
+
/** Maximum canvas backing-store DPR; large canvases also use the shared backing-store budget. */
|
|
334
334
|
maxDevicePixelRatio?: number;
|
|
335
335
|
barPadding?: number;
|
|
336
336
|
roundedTop?: BarCornerRadius;
|
|
@@ -179,7 +179,7 @@ export interface StreamPhysicsFrameProps {
|
|
|
179
179
|
* to composite over siblings (same contract as StreamXYFrame).
|
|
180
180
|
*/
|
|
181
181
|
background?: string;
|
|
182
|
-
/** Maximum canvas backing-store DPR;
|
|
182
|
+
/** Maximum canvas backing-store DPR; large canvases also use the shared backing-store budget. */
|
|
183
183
|
maxDevicePixelRatio?: number;
|
|
184
184
|
backgroundGraphics?: FrameGraphicsProp;
|
|
185
185
|
/**
|
|
@@ -36,6 +36,12 @@ export declare function resolveStackedAreaYDomain(options: {
|
|
|
36
36
|
};
|
|
37
37
|
export declare function resolveBarBinYDomain(buffer: RingBuffer<Datum>, getX: (d: Datum) => number, getY: (d: Datum) => number, binSize: number, getCategory: ((d: Datum) => string) | undefined, extentPadding: number, exactMode: boolean): [number, number];
|
|
38
38
|
export declare function resolveWaterfallYDomain(buffer: RingBuffer<Datum>, getY: (d: Datum) => number, extentPadding: number, exactMode: boolean): [number, number];
|
|
39
|
+
/**
|
|
40
|
+
* Waterfall x values identify bar centers, so the automatic domain needs half
|
|
41
|
+
* of the neighboring interval beyond each edge datum. User-specified bounds
|
|
42
|
+
* remain authoritative, including partial extents.
|
|
43
|
+
*/
|
|
44
|
+
export declare function resolveWaterfallXDomain(data: Datum[], getX: (d: Datum) => number, dataDomain: [number, number], userExtent: [number | undefined, number | undefined] | [number] | undefined, xScaleType: PipelineConfig["xScaleType"]): [number, number];
|
|
39
45
|
export declare function expandYDomainWithRibbons(yDomain: [number, number], bufferArray: Datum[], ribbons: ResolvedRibbon[]): [number, number];
|
|
40
46
|
export declare function padYDomain(yDomain: [number, number], options: {
|
|
41
47
|
exactMode: boolean;
|
|
@@ -4,5 +4,9 @@ import type { StreamRendererFn } from "./types";
|
|
|
4
4
|
* Renders PointSceneNode as circles. Used by Scatterplot, BubbleChart, SwarmChart,
|
|
5
5
|
* and showPoints on LineChart, AreaChart, and StackedAreaChart.
|
|
6
6
|
* Supports pulse glow effect via _pulseIntensity/_pulseColor fields.
|
|
7
|
+
*
|
|
8
|
+
* Opaque same-style points that are contiguous in data order share one path.
|
|
9
|
+
* Translucent points, hatches/patterns, and pulses stay per-mark so overlap
|
|
10
|
+
* compositing and z-order match the unbatched painter.
|
|
7
11
|
*/
|
|
8
12
|
export declare const pointCanvasRenderer: StreamRendererFn;
|
|
@@ -13,10 +13,10 @@
|
|
|
13
13
|
* media-query changes that bypass React).
|
|
14
14
|
*/
|
|
15
15
|
/**
|
|
16
|
-
* Repaint subscription for settled canvases whose CSS cascade
|
|
17
|
-
* a ThemeStore update
|
|
18
|
-
*
|
|
19
|
-
*
|
|
16
|
+
* Repaint subscription for settled canvases whose CSS cascade or loaded fonts
|
|
17
|
+
* change without a ThemeStore update. CSS mutation notifications are scoped
|
|
18
|
+
* to the subscribed element's DOM branch; font completion is document-wide.
|
|
19
|
+
* requestAnimationFrame coalescing remains owned by the frame.
|
|
20
20
|
*/
|
|
21
21
|
export declare function subscribeToCSSColorInvalidation(getElement: () => Element | null, listener: () => void): () => void;
|
|
22
22
|
export declare function resolveCSSColor(ctx: CanvasRenderingContext2D, value: string | undefined): string | undefined;
|
|
@@ -586,6 +586,12 @@ export interface BandConfig<T = Datum> {
|
|
|
586
586
|
interactive?: boolean;
|
|
587
587
|
}
|
|
588
588
|
export interface StreamXYFrameProps<T = Datum> extends StreamSemanticInteractionProps<HoverData> {
|
|
589
|
+
/**
|
|
590
|
+
* Built-in mark set. HOCs register the plugin they need. Direct
|
|
591
|
+
* StreamXYFrame loads other built-ins on first client paint. Call
|
|
592
|
+
* `registerBuiltInXYPlugins()` from `semiotic/xy` or
|
|
593
|
+
* `semiotic/realtime/core` for SSR / first-frame marks.
|
|
594
|
+
*/
|
|
589
595
|
chartType: StreamChartType;
|
|
590
596
|
runtimeMode?: RuntimeMode;
|
|
591
597
|
data?: T[];
|
|
@@ -713,7 +719,8 @@ export interface StreamXYFrameProps<T = Datum> extends StreamSemanticInteraction
|
|
|
713
719
|
background?: string;
|
|
714
720
|
/**
|
|
715
721
|
* Maximum canvas backing-store pixel ratio. Defaults to 3 on desktop and 2
|
|
716
|
-
* on coarse-pointer/small-screen devices
|
|
722
|
+
* on coarse-pointer/small-screen devices; very large canvases are further
|
|
723
|
+
* capped by a shared backing-store budget. Increase this when mark crispness
|
|
717
724
|
* at high browser zoom is more important than canvas memory/paint cost.
|
|
718
725
|
*/
|
|
719
726
|
maxDevicePixelRatio?: number;
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
import { type MutableRefObject } from "react";
|
|
2
|
+
import type { StreamChartType } from "./types";
|
|
3
|
+
/**
|
|
4
|
+
* Keep LineChart's static graph free of candlestick/heatmap/bar, while
|
|
5
|
+
* restoring two Frame contracts that cannot live on that graph:
|
|
6
|
+
*
|
|
7
|
+
* - `customLayout` can emit any node type — load the full painter set
|
|
8
|
+
* in a split chunk when a custom layout is actually present.
|
|
9
|
+
* - Direct `<StreamXYFrame chartType="line" />` used to work with no
|
|
10
|
+
* prior register call. If this chartType has no plugin yet, load
|
|
11
|
+
* every built-in in a split chunk (HOCs that already registered skip
|
|
12
|
+
* this path).
|
|
13
|
+
*
|
|
14
|
+
* The paint loop only redraws when `dirtyRef` is set (or a
|
|
15
|
+
* transition/restyle/pulse/resolution change). `scheduleRender` alone
|
|
16
|
+
* after the first frame is not enough.
|
|
17
|
+
*/
|
|
18
|
+
export declare function useEnsureXYPlugins(chartType: StreamChartType, customLayout: unknown, dirtyRef: MutableRefObject<boolean>, scheduleRender: () => void): void;
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import { type RefObject } from "react";
|
|
2
|
+
import type { Datum } from "../charts/shared/datumTypes";
|
|
3
|
+
import type { MarginalGraphicsConfig } from "./types";
|
|
4
|
+
type MarginalStore = {
|
|
5
|
+
getData(): readonly Datum[];
|
|
6
|
+
};
|
|
7
|
+
/** Keep React-owned marginal SVG values synchronized with the retained store. */
|
|
8
|
+
export declare function useMarginalValues(storeRef: RefObject<MarginalStore | null>, marginalGraphics: MarginalGraphicsConfig | undefined, data: readonly Datum[], xAccessor: unknown, yAccessor: unknown): {
|
|
9
|
+
marginalXValues: number[];
|
|
10
|
+
marginalYValues: number[];
|
|
11
|
+
refreshMarginalValues: (data?: readonly Datum[]) => void;
|
|
12
|
+
};
|
|
13
|
+
export {};
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* Chart-type → canvas renderer dispatch for StreamXYFrame.
|
|
3
|
-
*
|
|
3
|
+
*
|
|
4
|
+
* Renderers now live on XY plugins (`xyPlugins/`). This module re-exports
|
|
5
|
+
* the lookup so existing imports keep working.
|
|
4
6
|
*/
|
|
5
|
-
|
|
6
|
-
import type { StreamRendererFn } from "./renderers/types";
|
|
7
|
-
export declare const XY_CANVAS_RENDERERS: Record<StreamChartType, StreamRendererFn[]>;
|
|
7
|
+
export { getXYCanvasRenderers } from "./xyPlugins/registry";
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
import type { StreamChartType } from "../types";
|
|
2
|
+
/**
|
|
3
|
+
* SSR cannot wait for the client built-in chunk. Warn once per chartType
|
|
4
|
+
* when a plugin is still missing on the server so an empty scene is not
|
|
5
|
+
* silent. Client frames load built-ins asynchronously instead.
|
|
6
|
+
*/
|
|
7
|
+
export declare function warnIfXYPluginMissing(chartType: StreamChartType): void;
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export declare function registerBuiltInXYPlugins(): void;
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
import type { Datum } from "../../charts/shared/datumTypes";
|
|
2
|
+
import type { StreamChartType, StreamLayout, SceneNode } from "../types";
|
|
3
|
+
import type { StreamRendererFn } from "../renderers/types";
|
|
4
|
+
import type { XYSceneContext } from "../xySceneBuilders/types";
|
|
5
|
+
import type { BarSceneResult } from "../xySceneBuilders/barScene";
|
|
6
|
+
/**
|
|
7
|
+
* Register XY scene + canvas plugins with a value import of the plugin.
|
|
8
|
+
* `package.json` has `"sideEffects": false`, so a bare
|
|
9
|
+
* `import "./linePlugin"` may be dropped by consumer bundlers.
|
|
10
|
+
*
|
|
11
|
+
* Chart HOCs register only the plugin they need. Direct StreamXYFrame
|
|
12
|
+
* users should import the matching plugin or call
|
|
13
|
+
* {@link registerBuiltInXYPlugins} from `semiotic/xy`.
|
|
14
|
+
*/
|
|
15
|
+
export type XYSceneBuildResult = SceneNode[] | BarSceneResult;
|
|
16
|
+
export type XYSceneBuilder = (ctx: XYSceneContext, data: Datum[], layout: StreamLayout) => XYSceneBuildResult;
|
|
17
|
+
export interface XYChartPlugin {
|
|
18
|
+
chartType: StreamChartType;
|
|
19
|
+
buildScene: XYSceneBuilder;
|
|
20
|
+
canvasRenderers: StreamRendererFn[];
|
|
21
|
+
}
|
|
22
|
+
export declare function registerXYPlugin(plugin: XYChartPlugin): void;
|
|
23
|
+
/** Test-only: drop every plugin so HOC registration can be asserted in isolation. */
|
|
24
|
+
export declare function resetXYPluginRegistry(): void;
|
|
25
|
+
export declare function getXYPlugin(chartType: StreamChartType): XYChartPlugin | undefined;
|
|
26
|
+
export declare function getXYSceneBuilder(chartType: StreamChartType): XYSceneBuilder | undefined;
|
|
27
|
+
export declare function getXYCanvasRenderers(chartType: StreamChartType, customLayout?: boolean): StreamRendererFn[];
|
|
28
|
+
export declare function unwrapXYScene(result: XYSceneBuildResult): {
|
|
29
|
+
nodes: SceneNode[];
|
|
30
|
+
binBoundaries: number[];
|
|
31
|
+
};
|