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
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
import type { Datum } from "../charts/shared/datumTypes";
|
|
2
|
+
import type { SemioticTheme } from "../store/themeCore";
|
|
3
|
+
import type { AestheticFeatureId, AestheticProfile, AestheticThresholds } from "./aestheticProfileTypes";
|
|
4
|
+
export type AestheticFeatureStatus = "pass" | "warn" | "manual" | "disabled";
|
|
5
|
+
export interface AestheticFeatureResult {
|
|
6
|
+
readonly id: AestheticFeatureId;
|
|
7
|
+
readonly label: string;
|
|
8
|
+
readonly status: AestheticFeatureStatus;
|
|
9
|
+
/** Normalized machine evidence score from 0..1. */
|
|
10
|
+
readonly score: number;
|
|
11
|
+
/** Resolved organizational importance. Zero disables the feature. */
|
|
12
|
+
readonly weight: number;
|
|
13
|
+
/** `score * weight`, retained so the aggregate is fully reconstructable. */
|
|
14
|
+
readonly contribution: number;
|
|
15
|
+
readonly message: string;
|
|
16
|
+
readonly rationale?: string;
|
|
17
|
+
readonly evidence: Readonly<Record<string, string | number | boolean>>;
|
|
18
|
+
}
|
|
19
|
+
export interface EvaluateAestheticsOptions {
|
|
20
|
+
/** Resolved chart theme. Its `aesthetics` profile is used unless `profile` overrides it. */
|
|
21
|
+
readonly theme?: SemioticTheme;
|
|
22
|
+
/** One-off policy override; useful for comparing organizational profiles. */
|
|
23
|
+
readonly profile?: AestheticProfile;
|
|
24
|
+
}
|
|
25
|
+
export interface AestheticEvaluationResult {
|
|
26
|
+
readonly component: string;
|
|
27
|
+
readonly profile: string;
|
|
28
|
+
readonly ok: boolean;
|
|
29
|
+
/** Weighted 0..100 result, or null when every feature weight is zero. */
|
|
30
|
+
readonly score: number | null;
|
|
31
|
+
readonly minimumScore: number;
|
|
32
|
+
readonly weightedPoints: number;
|
|
33
|
+
readonly totalWeight: number;
|
|
34
|
+
readonly features: ReadonlyArray<AestheticFeatureResult>;
|
|
35
|
+
readonly method: "weighted-machine-visible-features";
|
|
36
|
+
}
|
|
37
|
+
export declare const DEFAULT_AESTHETIC_WEIGHTS: Readonly<Record<AestheticFeatureId, number>>;
|
|
38
|
+
export declare const DEFAULT_AESTHETIC_THRESHOLDS: Readonly<Required<AestheticThresholds>>;
|
|
39
|
+
export declare const DEFAULT_AESTHETIC_PROFILE: Readonly<AestheticProfile>;
|
|
40
|
+
export declare const AESTHETICS_OFF_PROFILE: Readonly<AestheticProfile>;
|
|
41
|
+
/**
|
|
42
|
+
* Evaluate the machine-visible portion of an organization's aesthetic policy.
|
|
43
|
+
* The aggregate is a transparent weighted quality function, not a universal
|
|
44
|
+
* beauty prediction. Human validation can be collected separately with a
|
|
45
|
+
* validated instrument such as BeauVis.
|
|
46
|
+
*/
|
|
47
|
+
export declare function evaluateAesthetics(component: string, props: Datum, options?: EvaluateAestheticsOptions): AestheticEvaluationResult;
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
import type { Datum } from "../charts/shared/datumTypes";
|
|
2
|
+
import type { NavTreeNode } from "./navigationTree";
|
|
3
|
+
/** Build region/value and route/location readings for geographic charts. */
|
|
4
|
+
export declare function buildGeoNavigationTree(component: string, props: Datum, maxLeaves: number, fmtNum: (number: number) => string): NavTreeNode;
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
import type { Datum } from "../charts/shared/datumTypes";
|
|
2
|
+
import type { NavTreeNode } from "./navigationTree";
|
|
3
|
+
/** Build the authored parent/child reading used by hierarchy chart navigation. */
|
|
4
|
+
export declare function buildHierarchyNavigationTree(component: string, props: Datum, maxLeaves: number, fmtNum: (number: number) => string): NavTreeNode;
|
|
@@ -23,7 +23,7 @@ export interface NavTreeNode {
|
|
|
23
23
|
level: number;
|
|
24
24
|
/** Measure value, for datum leaves. */
|
|
25
25
|
value?: number;
|
|
26
|
-
/** Raw datum
|
|
26
|
+
/** Raw authored datum for any actionable mark node, including hierarchy parents. */
|
|
27
27
|
datum?: Datum | null;
|
|
28
28
|
children?: NavTreeNode[];
|
|
29
29
|
}
|
|
@@ -34,6 +34,12 @@ export interface BuildNavigationTreeOptions {
|
|
|
34
34
|
/** Explicit recipe; otherwise props/registry dispatch is used. */
|
|
35
35
|
recipe?: ChartRecipe;
|
|
36
36
|
}
|
|
37
|
+
/**
|
|
38
|
+
* Whether the runtime navigation builder owns a datum-level structure for the
|
|
39
|
+
* supplied chart. This is the authoritative capability check used by
|
|
40
|
+
* ChartAccessContract; callers should not maintain a parallel chart-name set.
|
|
41
|
+
*/
|
|
42
|
+
export declare function supportsStructuredNavigation(component: string, props?: Datum, options?: Pick<BuildNavigationTreeOptions, "recipe">): boolean;
|
|
37
43
|
/**
|
|
38
44
|
* Build a structured navigation tree for a chart config. Full trees for XY,
|
|
39
45
|
* bar, part-to-whole, distribution, network, hierarchy, and geo families;
|
|
@@ -1,2 +1,10 @@
|
|
|
1
1
|
import type { ScorecardFixture } from "./qualityScorecard";
|
|
2
|
+
/**
|
|
3
|
+
* Semiotic's internal deterministic recommendation benchmark corpus.
|
|
4
|
+
*
|
|
5
|
+
* @deprecated This test corpus remains exported from `semiotic/ai` for 3.x
|
|
6
|
+
* compatibility, but application and evaluation code should own its
|
|
7
|
+
* `ScorecardFixture` inputs. It is intentionally absent from
|
|
8
|
+
* `semiotic/ai/core` and is planned for removal from the public API in 4.0.
|
|
9
|
+
*/
|
|
2
10
|
export declare const CANONICAL_FIXTURES: ReadonlyArray<ScorecardFixture>;
|
|
@@ -9,7 +9,7 @@
|
|
|
9
9
|
* common defaults that otherwise tend to leak across component families.
|
|
10
10
|
*/
|
|
11
11
|
export interface SuggestionPropContract {
|
|
12
|
-
readonly componentKind: "chart-hoc" | "value-component";
|
|
12
|
+
readonly componentKind: "chart-hoc" | "chart-recipe" | "value-component";
|
|
13
13
|
readonly commonChartProps: "supported" | "component-specific";
|
|
14
14
|
readonly headingProp: string;
|
|
15
15
|
readonly modeValues: ReadonlyArray<string>;
|
|
@@ -21,7 +21,7 @@ import type { Datum } from "../charts/shared/datumTypes";
|
|
|
21
21
|
export interface UseNavigationSyncOptions {
|
|
22
22
|
/** The navigation tree (from `buildNavigationTree`). */
|
|
23
23
|
tree: NavTreeNode;
|
|
24
|
-
/** `chartId` set on the chart, so its hover/click can be matched back to a
|
|
24
|
+
/** `chartId` set on the chart, so its hover/click can be matched back to a semantic node. */
|
|
25
25
|
chartId?: string;
|
|
26
26
|
/**
|
|
27
27
|
* Fields that identify a datum for highlighting + matching. Defaults to the
|
|
@@ -64,12 +64,12 @@ export interface UseNavigationSyncResult {
|
|
|
64
64
|
onObservation: (observation: ChartObservation) => void;
|
|
65
65
|
/** Alias of `onObservation` for composing an externally supplied handler. */
|
|
66
66
|
handleObservation: (observation: ChartObservation) => void;
|
|
67
|
-
/** Nav-tree
|
|
67
|
+
/** Nav-tree datum-node ids that an annotation anchors to — mark these as "has a note". */
|
|
68
68
|
annotatedIds: Set<string>;
|
|
69
69
|
/**
|
|
70
70
|
* Move the tree (and canvas highlight) to an annotation's anchored node.
|
|
71
71
|
* Accepts an annotation object or its index in `annotations`. Returns `true`
|
|
72
|
-
* if the anchor resolved to a
|
|
72
|
+
* if the anchor resolved to a datum node. The reader lands on the anchor.
|
|
73
73
|
*/
|
|
74
74
|
focusAnnotation: (annotation: Datum | number) => boolean;
|
|
75
75
|
}
|
|
@@ -35,6 +35,8 @@ export { MultiAxisLineChart } from "./xy/MultiAxisLineChart";
|
|
|
35
35
|
export type { MultiAxisLineChartProps, MultiAxisSeriesConfig } from "./xy/MultiAxisLineChart";
|
|
36
36
|
export { CandlestickChart } from "./xy/CandlestickChart";
|
|
37
37
|
export type { CandlestickChartProps } from "./xy/CandlestickChart";
|
|
38
|
+
export { WaterfallChart } from "./xy/WaterfallChart";
|
|
39
|
+
export type { WaterfallChartProps } from "./xy/WaterfallChart";
|
|
38
40
|
export { XYCustomChart } from "./custom/XYCustomChart";
|
|
39
41
|
export type { XYCustomChartProps } from "./custom/XYCustomChart";
|
|
40
42
|
export { NetworkCustomChart } from "./custom/NetworkCustomChart";
|
|
@@ -59,6 +61,8 @@ export { RidgelinePlot } from "./ordinal/RidgelinePlot";
|
|
|
59
61
|
export type { RidgelinePlotProps } from "./ordinal/RidgelinePlot";
|
|
60
62
|
export { FunnelChart } from "./ordinal/FunnelChart";
|
|
61
63
|
export type { FunnelChartProps } from "./ordinal/FunnelChart";
|
|
64
|
+
export { RadarChart } from "./ordinal/RadarChart";
|
|
65
|
+
export type { RadarChartProps } from "./ordinal/RadarChart";
|
|
62
66
|
export { DotPlot } from "./ordinal/DotPlot";
|
|
63
67
|
export type { DotPlotProps } from "./ordinal/DotPlot";
|
|
64
68
|
export { PieChart } from "./ordinal/PieChart";
|
|
@@ -4,7 +4,7 @@ import type { StreamNetworkFrameProps } from "../../stream/networkTypes";
|
|
|
4
4
|
import type { RealtimeFrameHandle } from "../../realtime/types";
|
|
5
5
|
import type { BaseChartProps, ChartAccessor } from "../shared/types";
|
|
6
6
|
import { type TooltipProp } from "../../Tooltip/Tooltip";
|
|
7
|
-
import type { LegendInteractionMode } from "../shared/hooks";
|
|
7
|
+
import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
|
|
8
8
|
import { type StyleRule } from "../shared/styleRules";
|
|
9
9
|
/**
|
|
10
10
|
* ChordDiagram component props
|
|
@@ -32,6 +32,10 @@ export interface ChordDiagramProps<TNode extends Datum = Datum, TEdge extends Da
|
|
|
32
32
|
nodeLabel?: ChartAccessor<TNode, string>;
|
|
33
33
|
showLabels?: boolean;
|
|
34
34
|
enableHover?: boolean;
|
|
35
|
+
/** Show a swatch + label legend. Defaults to `true` when `colorBy` is set. */
|
|
36
|
+
showLegend?: boolean;
|
|
37
|
+
/** Legend position. Default `"right"`. */
|
|
38
|
+
legendPosition?: LegendPosition;
|
|
35
39
|
legendInteraction?: LegendInteractionMode;
|
|
36
40
|
edgeOpacity?: number;
|
|
37
41
|
tooltip?: TooltipProp;
|
|
@@ -3,7 +3,8 @@ import * as React from "react";
|
|
|
3
3
|
import type { StreamNetworkFrameProps } from "../../stream/networkTypes";
|
|
4
4
|
import type { BaseChartProps, ChartAccessor } from "../shared/types";
|
|
5
5
|
import { type TooltipProp } from "../../Tooltip/Tooltip";
|
|
6
|
-
import type { LegendInteractionMode } from "../shared/hooks";
|
|
6
|
+
import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
|
|
7
|
+
import { type StyleRule } from "../shared/styleRules";
|
|
7
8
|
/**
|
|
8
9
|
* CirclePack component props
|
|
9
10
|
*/
|
|
@@ -15,11 +16,17 @@ export interface CirclePackProps<TNode extends Datum = Datum> extends BaseChartP
|
|
|
15
16
|
colorBy?: ChartAccessor<TNode, string | number>;
|
|
16
17
|
colorScheme?: string | string[] | Record<string, string>;
|
|
17
18
|
colorByDepth?: boolean;
|
|
19
|
+
/** Ordered data-aware node styling. Rules see the authored hierarchy node. */
|
|
20
|
+
styleRules?: StyleRule[];
|
|
18
21
|
showLabels?: boolean;
|
|
19
22
|
nodeLabel?: ChartAccessor<TNode, string>;
|
|
20
23
|
circleOpacity?: number;
|
|
21
24
|
padding?: number;
|
|
22
25
|
enableHover?: boolean;
|
|
26
|
+
/** Show a swatch + label legend. Defaults to `true` when `colorBy` is set. */
|
|
27
|
+
showLegend?: boolean;
|
|
28
|
+
/** Legend position. Default `"right"`. */
|
|
29
|
+
legendPosition?: LegendPosition;
|
|
23
30
|
legendInteraction?: LegendInteractionMode;
|
|
24
31
|
tooltip?: TooltipProp;
|
|
25
32
|
frameProps?: Partial<Omit<StreamNetworkFrameProps, "edges" | "size">>;
|
|
@@ -3,6 +3,8 @@ import * as React from "react";
|
|
|
3
3
|
import type { StreamNetworkFrameProps } from "../../stream/networkTypes";
|
|
4
4
|
import type { BaseChartProps } from "../shared/types";
|
|
5
5
|
import { type TooltipProp } from "../../Tooltip/Tooltip";
|
|
6
|
+
import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
|
|
7
|
+
import { type StyleRule } from "../shared/styleRules";
|
|
6
8
|
export interface OrbitNode {
|
|
7
9
|
datum: Datum;
|
|
8
10
|
x: number;
|
|
@@ -28,6 +30,8 @@ export interface OrbitDiagramProps<TDatum extends Datum = Datum> extends BaseCha
|
|
|
28
30
|
colorScheme?: string | string[] | Record<string, string>;
|
|
29
31
|
/** Color by hierarchy depth instead of field @default false */
|
|
30
32
|
colorByDepth?: boolean;
|
|
33
|
+
/** Ordered data-aware node styling. Rules see the authored hierarchy node. */
|
|
34
|
+
styleRules?: StyleRule[];
|
|
31
35
|
/**
|
|
32
36
|
* Ring arrangement mode:
|
|
33
37
|
* - "flat": all children in one ring
|
|
@@ -66,6 +70,11 @@ export interface OrbitDiagramProps<TDatum extends Datum = Datum> extends BaseCha
|
|
|
66
70
|
tooltip?: TooltipProp;
|
|
67
71
|
/** Enable hover @default true */
|
|
68
72
|
enableHover?: boolean;
|
|
73
|
+
/** Show a swatch + label legend. Defaults to `true` when `colorBy` is set. */
|
|
74
|
+
showLegend?: boolean;
|
|
75
|
+
/** Legend position. Default `"right"`. */
|
|
76
|
+
legendPosition?: LegendPosition;
|
|
77
|
+
legendInteraction?: LegendInteractionMode;
|
|
69
78
|
/** Annotation objects */
|
|
70
79
|
annotations?: Array<Datum>;
|
|
71
80
|
/** Additional SVG content */
|
|
@@ -3,7 +3,8 @@ import * as React from "react";
|
|
|
3
3
|
import type { StreamNetworkFrameProps } from "../../stream/networkTypes";
|
|
4
4
|
import type { BaseChartProps, ChartAccessor } from "../shared/types";
|
|
5
5
|
import { type TooltipProp } from "../../Tooltip/Tooltip";
|
|
6
|
-
import type { LegendInteractionMode } from "../shared/hooks";
|
|
6
|
+
import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
|
|
7
|
+
import { type StyleRule } from "../shared/styleRules";
|
|
7
8
|
/**
|
|
8
9
|
* TreeDiagram component props
|
|
9
10
|
*/
|
|
@@ -17,11 +18,17 @@ export interface TreeDiagramProps<TNode extends Datum = Datum> extends BaseChart
|
|
|
17
18
|
colorBy?: ChartAccessor<TNode, string | number>;
|
|
18
19
|
colorScheme?: string | string[] | Record<string, string>;
|
|
19
20
|
colorByDepth?: boolean;
|
|
21
|
+
/** Ordered data-aware node styling. Rules see the authored hierarchy node. */
|
|
22
|
+
styleRules?: StyleRule[];
|
|
20
23
|
edgeStyle?: "line" | "curve";
|
|
21
24
|
nodeLabel?: ChartAccessor<TNode, string>;
|
|
22
25
|
showLabels?: boolean;
|
|
23
26
|
nodeSize?: number;
|
|
24
27
|
enableHover?: boolean;
|
|
28
|
+
/** Show a swatch + label legend. Defaults to `true` when `colorBy` is set. */
|
|
29
|
+
showLegend?: boolean;
|
|
30
|
+
/** Legend position. Default `"right"`. */
|
|
31
|
+
legendPosition?: LegendPosition;
|
|
25
32
|
legendInteraction?: LegendInteractionMode;
|
|
26
33
|
tooltip?: TooltipProp;
|
|
27
34
|
frameProps?: Partial<Omit<StreamNetworkFrameProps, "edges" | "size">>;
|
|
@@ -4,7 +4,8 @@ import * as React from "react";
|
|
|
4
4
|
import type { StreamNetworkFrameProps } from "../../stream/networkTypes";
|
|
5
5
|
import type { BaseChartProps, ChartAccessor } from "../shared/types";
|
|
6
6
|
import { type TooltipProp } from "../../Tooltip/Tooltip";
|
|
7
|
-
import type { LegendInteractionMode } from "../shared/hooks";
|
|
7
|
+
import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
|
|
8
|
+
import { type StyleRule } from "../shared/styleRules";
|
|
8
9
|
/**
|
|
9
10
|
* Treemap component props
|
|
10
11
|
*/
|
|
@@ -16,6 +17,8 @@ export interface TreemapProps<TNode extends Datum = Datum> extends BaseChartProp
|
|
|
16
17
|
colorBy?: ChartAccessor<TNode, string | number>;
|
|
17
18
|
colorScheme?: string | string[] | Record<string, string>;
|
|
18
19
|
colorByDepth?: boolean;
|
|
20
|
+
/** Ordered data-aware node styling. Rules see the authored hierarchy node. */
|
|
21
|
+
styleRules?: StyleRule[];
|
|
19
22
|
showLabels?: boolean;
|
|
20
23
|
labelMode?: "leaf" | "parent" | "all";
|
|
21
24
|
nodeLabel?: ChartAccessor<TNode, string>;
|
|
@@ -30,6 +33,10 @@ export interface TreemapProps<TNode extends Datum = Datum> extends BaseChartProp
|
|
|
30
33
|
*/
|
|
31
34
|
nodeStyle?: (d: Datum) => NetworkMarkStyle;
|
|
32
35
|
enableHover?: boolean;
|
|
36
|
+
/** Show a swatch + label legend. Defaults to `true` when `colorBy` is set. */
|
|
37
|
+
showLegend?: boolean;
|
|
38
|
+
/** Legend position. Default `"right"`. */
|
|
39
|
+
legendPosition?: LegendPosition;
|
|
33
40
|
legendInteraction?: LegendInteractionMode;
|
|
34
41
|
tooltip?: TooltipProp;
|
|
35
42
|
frameProps?: Partial<Omit<StreamNetworkFrameProps, "edges" | "size">>;
|
|
@@ -106,6 +106,12 @@ export interface BarChartProps<TDatum extends Datum = Datum> extends BaseChartPr
|
|
|
106
106
|
legendPosition?: "right" | "left" | "top" | "bottom";
|
|
107
107
|
tooltip?: TooltipProp;
|
|
108
108
|
annotations?: Datum[];
|
|
109
|
+
/** Enable a value-axis brush overlay. Also enabled when `linkedBrush` is set. */
|
|
110
|
+
brush?: boolean;
|
|
111
|
+
/** Callback with `{ r: [min, max] }` or null when the brush clears. */
|
|
112
|
+
onBrush?: (extent: {
|
|
113
|
+
r: [number, number];
|
|
114
|
+
} | null) => void;
|
|
109
115
|
/**
|
|
110
116
|
* Overlay a regression line through the bar tops. Accepts `true`
|
|
111
117
|
* (linear), a method name (`"linear"` | `"polynomial"` | `"loess"`),
|
|
@@ -5,6 +5,7 @@ import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
|
|
|
5
5
|
import type { BaseChartProps, ChartAccessor, CategoryFormatFn } from "../shared/types";
|
|
6
6
|
import { type TooltipProp } from "../../Tooltip/Tooltip";
|
|
7
7
|
import type { RealtimeFrameHandle } from "../../realtime/types";
|
|
8
|
+
import { type StyleRule } from "../shared/styleRules";
|
|
8
9
|
export interface BoxPlotProps<TDatum extends Datum = Datum> extends BaseChartProps {
|
|
9
10
|
data?: TDatum[];
|
|
10
11
|
categoryAccessor?: ChartAccessor<TDatum, string>;
|
|
@@ -15,6 +16,8 @@ export interface BoxPlotProps<TDatum extends Datum = Datum> extends BaseChartPro
|
|
|
15
16
|
valueFormat?: (d: number | string) => string;
|
|
16
17
|
colorBy?: ChartAccessor<TDatum, string>;
|
|
17
18
|
colorScheme?: string | string[] | Record<string, string>;
|
|
19
|
+
/** Ordered summary styling; fieldless thresholds use each category's median. Statistical fields include `n`, `min`, `q1`, `median`, `q3`, `max`, and `mean`. */
|
|
20
|
+
styleRules?: StyleRule[];
|
|
18
21
|
showOutliers?: boolean;
|
|
19
22
|
outlierRadius?: number;
|
|
20
23
|
categoryPadding?: number;
|
|
@@ -4,6 +4,7 @@ import type { StreamOrdinalFrameProps } from "../../stream/ordinalTypes";
|
|
|
4
4
|
import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
|
|
5
5
|
import type { BaseChartProps, ChartAccessor } from "../shared/types";
|
|
6
6
|
import { type TooltipProp } from "../../Tooltip/Tooltip";
|
|
7
|
+
import { type StyleRule } from "../shared/styleRules";
|
|
7
8
|
import type { RealtimeFrameHandle } from "../../realtime/types";
|
|
8
9
|
export interface DonutChartProps<TDatum extends Datum = Datum> extends BaseChartProps {
|
|
9
10
|
data?: TDatum[];
|
|
@@ -13,6 +14,8 @@ export interface DonutChartProps<TDatum extends Datum = Datum> extends BaseChart
|
|
|
13
14
|
centerContent?: React.ReactNode;
|
|
14
15
|
colorBy?: ChartAccessor<TDatum, string>;
|
|
15
16
|
colorScheme?: string | string[] | Record<string, string>;
|
|
17
|
+
/** Ordered data-aware wedge styling; fieldless thresholds use absolute wedge magnitude. */
|
|
18
|
+
styleRules?: StyleRule[];
|
|
16
19
|
startAngle?: number;
|
|
17
20
|
/** Rounded corner radius on wedge arcs */
|
|
18
21
|
cornerRadius?: number;
|
|
@@ -6,6 +6,7 @@ import type { BaseChartProps, ChartAccessor, CategoryFormatFn } from "../shared/
|
|
|
6
6
|
import { type TooltipProp } from "../../Tooltip/Tooltip";
|
|
7
7
|
import type { RealtimeFrameHandle } from "../../realtime/types";
|
|
8
8
|
import { type RegressionProp } from "../shared/regressionUtils";
|
|
9
|
+
import { type StyleRule } from "../shared/styleRules";
|
|
9
10
|
export interface DotPlotProps<TDatum extends Datum = Datum> extends BaseChartProps {
|
|
10
11
|
data?: TDatum[];
|
|
11
12
|
categoryAccessor?: ChartAccessor<TDatum, string>;
|
|
@@ -16,6 +17,8 @@ export interface DotPlotProps<TDatum extends Datum = Datum> extends BaseChartPro
|
|
|
16
17
|
valueFormat?: (d: number | string) => string;
|
|
17
18
|
colorBy?: ChartAccessor<TDatum, string>;
|
|
18
19
|
colorScheme?: string | string[] | Record<string, string>;
|
|
20
|
+
/** Ordered data-aware dot styling; fieldless thresholds use `valueAccessor`. */
|
|
21
|
+
styleRules?: StyleRule[];
|
|
19
22
|
/** Category ordering. Default (`undefined`) resolves to `"auto"`, which
|
|
20
23
|
* preserves insertion order while streaming and falls through to
|
|
21
24
|
* value-desc on static data — the recommended choice when using the
|
|
@@ -5,6 +5,7 @@ import type { LegendInteractionMode } from "../shared/hooks";
|
|
|
5
5
|
import type { BaseChartProps, ChartAccessor, CategoryFormatFn } from "../shared/types";
|
|
6
6
|
import { type TooltipProp } from "../../Tooltip/Tooltip";
|
|
7
7
|
import type { RealtimeFrameHandle } from "../../realtime/types";
|
|
8
|
+
import { type StyleRule } from "../shared/styleRules";
|
|
8
9
|
/**
|
|
9
10
|
* FunnelChart component props
|
|
10
11
|
*/
|
|
@@ -18,6 +19,8 @@ export interface FunnelChartProps<TDatum extends Datum = Datum> extends BaseChar
|
|
|
18
19
|
categoryAccessor?: ChartAccessor<TDatum, string>;
|
|
19
20
|
colorBy?: ChartAccessor<TDatum, string>;
|
|
20
21
|
colorScheme?: string | string[] | Record<string, string>;
|
|
22
|
+
/** Ordered data-aware step styling; fieldless thresholds use step value. */
|
|
23
|
+
styleRules?: StyleRule[];
|
|
21
24
|
/**
|
|
22
25
|
* Funnel orientation.
|
|
23
26
|
*
|
|
@@ -5,6 +5,7 @@ import type { BaseChartProps } from "../shared/types";
|
|
|
5
5
|
import { type TooltipProp } from "../../Tooltip/Tooltip";
|
|
6
6
|
import type { RealtimeFrameHandle } from "../../realtime/types";
|
|
7
7
|
import { type GaugeGradientFill } from "../shared/gaugeGradient";
|
|
8
|
+
import { type StyleRule } from "../shared/styleRules";
|
|
8
9
|
export interface GaugeThreshold {
|
|
9
10
|
/** Upper bound of this zone (value, not percentage) */
|
|
10
11
|
value: number;
|
|
@@ -61,6 +62,8 @@ export interface GaugeChartProps extends BaseChartProps {
|
|
|
61
62
|
fillZones?: boolean;
|
|
62
63
|
/** Enable tooltip on arc segments */
|
|
63
64
|
tooltip?: TooltipProp;
|
|
65
|
+
/** Ordered styling for rendered gauge segments. Rules see the synthetic segment fields (`category`, `value`, `_zone`, `_isFill`). */
|
|
66
|
+
styleRules?: StyleRule[];
|
|
64
67
|
/** Annotations — supports threshold markers via standard annotation system */
|
|
65
68
|
annotations?: Datum[];
|
|
66
69
|
/** Enable hover interaction (default true) */
|
|
@@ -5,6 +5,7 @@ import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
|
|
|
5
5
|
import type { BaseChartProps, ChartAccessor, CategoryFormatFn } from "../shared/types";
|
|
6
6
|
import { type TooltipProp } from "../../Tooltip/Tooltip";
|
|
7
7
|
import type { RealtimeFrameHandle } from "../../realtime/types";
|
|
8
|
+
import { type StyleRule } from "../shared/styleRules";
|
|
8
9
|
/**
|
|
9
10
|
* Histogram component props
|
|
10
11
|
*/
|
|
@@ -52,6 +53,8 @@ export interface HistogramProps<TDatum extends Datum = Datum> extends BaseChartP
|
|
|
52
53
|
valueFormat?: (d: number | string) => string;
|
|
53
54
|
colorBy?: ChartAccessor<TDatum, string>;
|
|
54
55
|
colorScheme?: string | string[] | Record<string, string>;
|
|
56
|
+
/** Ordered bin styling; fieldless thresholds use displayed bin `count`. Rules can also target `bin`, `range`, and `category`. */
|
|
57
|
+
styleRules?: StyleRule[];
|
|
55
58
|
categoryPadding?: number;
|
|
56
59
|
enableHover?: boolean;
|
|
57
60
|
showGrid?: boolean;
|
|
@@ -5,6 +5,7 @@ import type { LegendInteractionMode } from "../shared/hooks";
|
|
|
5
5
|
import type { BaseChartProps, ChartAccessor, CategoryFormatFn } from "../shared/types";
|
|
6
6
|
import { type TooltipProp } from "../../Tooltip/Tooltip";
|
|
7
7
|
import type { RealtimeFrameHandle } from "../../realtime/types";
|
|
8
|
+
import type { StyleRule } from "../shared/styleRules";
|
|
8
9
|
/**
|
|
9
10
|
* LikertChart — visualize Likert scale survey responses.
|
|
10
11
|
*
|
|
@@ -73,6 +74,8 @@ export interface LikertChartProps<TDatum extends Datum = Datum> extends BaseChar
|
|
|
73
74
|
* For diverging orientation, use a diverging palette (red→neutral→blue).
|
|
74
75
|
*/
|
|
75
76
|
colorScheme?: string[];
|
|
77
|
+
/** Ordered data-aware segment styling; fieldless thresholds use the displayed signed proportion. */
|
|
78
|
+
styleRules?: StyleRule[];
|
|
76
79
|
categoryLabel?: string;
|
|
77
80
|
valueLabel?: string;
|
|
78
81
|
valueFormat?: (d: number | string) => string;
|
|
@@ -5,6 +5,7 @@ import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
|
|
|
5
5
|
import type { BaseChartProps, ChartAccessor } from "../shared/types";
|
|
6
6
|
import { type TooltipProp } from "../../Tooltip/Tooltip";
|
|
7
7
|
import type { RealtimeFrameHandle } from "../../realtime/types";
|
|
8
|
+
import { type StyleRule } from "../shared/styleRules";
|
|
8
9
|
/**
|
|
9
10
|
* PieChart component props
|
|
10
11
|
*/
|
|
@@ -42,6 +43,8 @@ export interface PieChartProps<TDatum extends Datum = Datum> extends BaseChartPr
|
|
|
42
43
|
* theme's categorical palette when omitted.
|
|
43
44
|
*/
|
|
44
45
|
colorScheme?: string | string[] | Record<string, string>;
|
|
46
|
+
/** Ordered data-aware wedge styling; fieldless thresholds use absolute wedge magnitude. */
|
|
47
|
+
styleRules?: StyleRule[];
|
|
45
48
|
/**
|
|
46
49
|
* Rotation in **degrees** applied to the first wedge. `0` starts at 12
|
|
47
50
|
* o'clock and proceeds clockwise; `90` starts at 3 o'clock, `180` at 6
|
|
@@ -0,0 +1,75 @@
|
|
|
1
|
+
import type { Datum } from "../shared/datumTypes";
|
|
2
|
+
import * as React from "react";
|
|
3
|
+
import type { StreamOrdinalFrameProps } from "../../stream/ordinalTypes";
|
|
4
|
+
import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
|
|
5
|
+
import type { BaseChartProps, ChartAccessor, CategoryFormatFn } from "../shared/types";
|
|
6
|
+
import { type TooltipProp } from "../../Tooltip/Tooltip";
|
|
7
|
+
import type { RealtimeFrameHandle } from "../../realtime/types";
|
|
8
|
+
import { type StyleRule } from "../shared/styleRules";
|
|
9
|
+
export interface RadarChartProps<TDatum extends Datum = Datum> extends BaseChartProps {
|
|
10
|
+
data?: TDatum[];
|
|
11
|
+
/** Axis around the radar (the variables being compared). @default "attribute" */
|
|
12
|
+
categoryAccessor?: ChartAccessor<TDatum, string>;
|
|
13
|
+
/** Magnitude along each axis. @default "value" */
|
|
14
|
+
valueAccessor?: ChartAccessor<TDatum, number>;
|
|
15
|
+
/**
|
|
16
|
+
* Series identity — points with the same series are connected into a
|
|
17
|
+
* polygon. Defaults to `colorBy` when that is a string.
|
|
18
|
+
*/
|
|
19
|
+
seriesAccessor?: ChartAccessor<TDatum, string>;
|
|
20
|
+
colorBy?: ChartAccessor<TDatum, string>;
|
|
21
|
+
colorScheme?: string | string[] | Record<string, string>;
|
|
22
|
+
/** Ordered data-aware point styling; fieldless thresholds use `valueAccessor`. */
|
|
23
|
+
styleRules?: StyleRule[];
|
|
24
|
+
pointRadius?: number;
|
|
25
|
+
/** Fixed value-axis domain. Defaults to `[0, data-max]`. */
|
|
26
|
+
valueExtent?: [number | undefined, number | undefined] | [number];
|
|
27
|
+
enableHover?: boolean;
|
|
28
|
+
showGrid?: boolean;
|
|
29
|
+
showLegend?: boolean;
|
|
30
|
+
legendInteraction?: LegendInteractionMode;
|
|
31
|
+
legendPosition?: LegendPosition;
|
|
32
|
+
tooltip?: TooltipProp;
|
|
33
|
+
annotations?: Datum[];
|
|
34
|
+
categoryFormat?: CategoryFormatFn;
|
|
35
|
+
frameProps?: Partial<Omit<StreamOrdinalFrameProps, "data" | "size">>;
|
|
36
|
+
}
|
|
37
|
+
/**
|
|
38
|
+
* RadarChart — multivariate comparison on a shared radial axis.
|
|
39
|
+
*
|
|
40
|
+
* Each category is an axis around the circle; each series is a connected
|
|
41
|
+
* polygon. Data should be long-form: one row per (series, attribute).
|
|
42
|
+
*
|
|
43
|
+
* @example
|
|
44
|
+
* ```tsx
|
|
45
|
+
* <RadarChart
|
|
46
|
+
* data={[
|
|
47
|
+
* { name: "A", attribute: "speed", value: 80 },
|
|
48
|
+
* { name: "A", attribute: "power", value: 40 },
|
|
49
|
+
* { name: "B", attribute: "speed", value: 55 },
|
|
50
|
+
* { name: "B", attribute: "power", value: 70 },
|
|
51
|
+
* ]}
|
|
52
|
+
* categoryAccessor="attribute"
|
|
53
|
+
* valueAccessor="value"
|
|
54
|
+
* seriesAccessor="name"
|
|
55
|
+
* colorBy="name"
|
|
56
|
+
* />
|
|
57
|
+
* ```
|
|
58
|
+
*
|
|
59
|
+
* @example
|
|
60
|
+
* ```tsx
|
|
61
|
+
* // A single profile with function accessors and an explicit description.
|
|
62
|
+
* <RadarChart
|
|
63
|
+
* data={skills}
|
|
64
|
+
* categoryAccessor={(skill) => skill.label}
|
|
65
|
+
* valueAccessor={(skill) => skill.score}
|
|
66
|
+
* title="Engineering skills profile"
|
|
67
|
+
* description="Scores across six self-assessed engineering skills."
|
|
68
|
+
* pieceStyle={{ fill: "#2563eb", stroke: "#1d4ed8" }}
|
|
69
|
+
* />
|
|
70
|
+
* ```
|
|
71
|
+
*/
|
|
72
|
+
export declare const RadarChart: {
|
|
73
|
+
<TDatum extends Datum = Datum>(props: RadarChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
|
|
74
|
+
displayName?: string;
|
|
75
|
+
};
|
|
@@ -5,6 +5,7 @@ import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
|
|
|
5
5
|
import type { BaseChartProps, ChartAccessor, CategoryFormatFn } from "../shared/types";
|
|
6
6
|
import { type TooltipProp } from "../../Tooltip/Tooltip";
|
|
7
7
|
import type { RealtimeFrameHandle } from "../../realtime/types";
|
|
8
|
+
import { type StyleRule } from "../shared/styleRules";
|
|
8
9
|
export interface RidgelinePlotProps<TDatum extends Datum = Datum> extends BaseChartProps {
|
|
9
10
|
data?: TDatum[];
|
|
10
11
|
categoryAccessor?: ChartAccessor<TDatum, string>;
|
|
@@ -18,6 +19,8 @@ export interface RidgelinePlotProps<TDatum extends Datum = Datum> extends BaseCh
|
|
|
18
19
|
valueFormat?: (d: number | string) => string;
|
|
19
20
|
colorBy?: ChartAccessor<TDatum, string>;
|
|
20
21
|
colorScheme?: string | string[] | Record<string, string>;
|
|
22
|
+
/** Ordered summary styling; fieldless thresholds use each category's median. Statistical fields include `n`, `min`, `q1`, `median`, `q3`, `max`, and `mean`. */
|
|
23
|
+
styleRules?: StyleRule[];
|
|
21
24
|
categoryPadding?: number;
|
|
22
25
|
enableHover?: boolean;
|
|
23
26
|
showGrid?: boolean;
|
|
@@ -6,6 +6,7 @@ import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
|
|
|
6
6
|
import type { BaseChartProps, ChartAccessor, CategoryFormatFn } from "../shared/types";
|
|
7
7
|
import { type TooltipProp } from "../../Tooltip/Tooltip";
|
|
8
8
|
import type { RealtimeFrameHandle } from "../../realtime/types";
|
|
9
|
+
import { type StyleRule } from "../shared/styleRules";
|
|
9
10
|
export interface SwarmPlotProps<TDatum extends Datum = Datum> extends BaseChartProps {
|
|
10
11
|
data?: TDatum[];
|
|
11
12
|
categoryAccessor?: ChartAccessor<TDatum, string>;
|
|
@@ -16,6 +17,8 @@ export interface SwarmPlotProps<TDatum extends Datum = Datum> extends BaseChartP
|
|
|
16
17
|
valueFormat?: (d: number | string) => string;
|
|
17
18
|
colorBy?: ChartAccessor<TDatum, string>;
|
|
18
19
|
colorScheme?: string | string[] | Record<string, string>;
|
|
20
|
+
/** Ordered data-aware point styling; fieldless thresholds use `valueAccessor`. */
|
|
21
|
+
styleRules?: StyleRule[];
|
|
19
22
|
sizeBy?: ChartAccessor<TDatum, number>;
|
|
20
23
|
sizeRange?: [number, number];
|
|
21
24
|
/** Field name or function → glyph **shape**: each point renders as a d3-shape
|
|
@@ -6,6 +6,7 @@ import type { BaseChartProps, ChartAccessor, CategoryFormatFn } from "../shared/
|
|
|
6
6
|
import { type TooltipProp } from "../../Tooltip/Tooltip";
|
|
7
7
|
import type { RealtimeFrameHandle } from "../../realtime/types";
|
|
8
8
|
import { type GradientInput } from "../shared/gradient";
|
|
9
|
+
import { type StyleRule } from "../shared/styleRules";
|
|
9
10
|
export interface SwimlaneChartProps<TDatum extends Datum = Datum> extends BaseChartProps {
|
|
10
11
|
/** Data array. Omit for push API mode. */
|
|
11
12
|
data?: TDatum[];
|
|
@@ -27,6 +28,8 @@ export interface SwimlaneChartProps<TDatum extends Datum = Datum> extends BaseCh
|
|
|
27
28
|
colorBy?: ChartAccessor<TDatum, string>;
|
|
28
29
|
/** Color scheme for subcategories */
|
|
29
30
|
colorScheme?: string | string[] | Record<string, string>;
|
|
31
|
+
/** Ordered data-aware piece styling; fieldless thresholds use `valueAccessor`. */
|
|
32
|
+
styleRules?: StyleRule[];
|
|
30
33
|
/** Padding between lanes in pixels */
|
|
31
34
|
barPadding?: number;
|
|
32
35
|
/** Enable hover annotations */
|
|
@@ -5,6 +5,7 @@ import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
|
|
|
5
5
|
import type { BaseChartProps, ChartAccessor, CategoryFormatFn } from "../shared/types";
|
|
6
6
|
import { type TooltipProp } from "../../Tooltip/Tooltip";
|
|
7
7
|
import type { RealtimeFrameHandle } from "../../realtime/types";
|
|
8
|
+
import { type StyleRule } from "../shared/styleRules";
|
|
8
9
|
export interface ViolinPlotProps<TDatum extends Datum = Datum> extends BaseChartProps {
|
|
9
10
|
data?: TDatum[];
|
|
10
11
|
categoryAccessor?: ChartAccessor<TDatum, string>;
|
|
@@ -18,6 +19,8 @@ export interface ViolinPlotProps<TDatum extends Datum = Datum> extends BaseChart
|
|
|
18
19
|
valueFormat?: (d: number | string) => string;
|
|
19
20
|
colorBy?: ChartAccessor<TDatum, string>;
|
|
20
21
|
colorScheme?: string | string[] | Record<string, string>;
|
|
22
|
+
/** Ordered summary styling; fieldless thresholds use each category's median. Statistical fields include `n`, `min`, `q1`, `median`, `q3`, `max`, and `mean`. */
|
|
23
|
+
styleRules?: StyleRule[];
|
|
21
24
|
categoryPadding?: number;
|
|
22
25
|
enableHover?: boolean;
|
|
23
26
|
showGrid?: boolean;
|
|
@@ -24,17 +24,13 @@ export * from "./gauntletPublic";
|
|
|
24
24
|
* events={[{ id: "done", gateId: "review", time: 2, effects: [{ popNegative: ["risk"] }] }]}
|
|
25
25
|
* showProjection />
|
|
26
26
|
* ```
|
|
27
|
-
*
|
|
28
27
|
* Compose timed gates, capacity controls, staggered starts, and projections through the corresponding props.
|
|
29
28
|
*/
|
|
30
29
|
export declare const GauntletChart: {
|
|
31
30
|
<TDatum extends Datum = Datum>(props: GauntletChartProps<TDatum> & React.RefAttributes<PhysicsFrameHandle>): React.ReactElement | null;
|
|
32
31
|
displayName?: string;
|
|
33
32
|
};
|
|
34
|
-
/**
|
|
35
|
-
* @deprecated Typo alias of {@link GauntletChart}. Use `GauntletChart` instead.
|
|
36
|
-
* Removed in the next major version.
|
|
37
|
-
*/
|
|
33
|
+
/** @deprecated Typo alias. Use {@link GauntletChart}; removed next major. */
|
|
38
34
|
export declare const GuantletChart: {
|
|
39
35
|
<TDatum extends Datum = Datum>(props: GauntletChartProps<TDatum> & React.RefAttributes<PhysicsFrameHandle>): React.ReactElement | null;
|
|
40
36
|
displayName?: string;
|
|
@@ -2,6 +2,7 @@ import type { Datum } from "../shared/datumTypes";
|
|
|
2
2
|
import type { TooltipProp } from "../../Tooltip/Tooltip";
|
|
3
3
|
import type { AccessibleTableProp } from "../../stream/accessibleTableTypes";
|
|
4
4
|
import type { BlockerAmplification, DependencyAccessor, DependencyTaskStatus } from "./dependencyMachine";
|
|
5
|
+
import type { PhysicsSimulationStateChange } from "./physicsHocUtils";
|
|
5
6
|
export type ChainReactionMode = "snapshot" | "replay" | "mechanical";
|
|
6
7
|
export type ChainReactionInsight = "none" | "blocker-amplification";
|
|
7
8
|
export type ChainReactionControl = "play" | "pause" | "step" | "reset" | "settle";
|
|
@@ -85,6 +86,8 @@ export interface ChainReactionChartProps<TDatum extends Datum = Datum> {
|
|
|
85
86
|
selectedTaskIDs?: readonly string[];
|
|
86
87
|
onSelectionChange?: (ids: string[]) => void;
|
|
87
88
|
onObservation?: (event: ChainReactionObservation<TDatum>) => void;
|
|
89
|
+
/** Observe the underlying physics pipeline entering running/settled states. */
|
|
90
|
+
onSimulationStateChange?: PhysicsSimulationStateChange;
|
|
88
91
|
reducedMotion?: "settle";
|
|
89
92
|
seed?: number;
|
|
90
93
|
width?: number;
|