semiotic 3.9.1 → 3.10.0
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 +137 -58
- package/agent-skill/semiotic-charts/SKILL.md +27 -17
- package/ai/artifact-contract-reference.md +408 -0
- package/ai/artifact-surface-inventory.json +5586 -0
- package/ai/behaviorContracts.cjs +24 -2
- package/ai/cli.js +480 -56
- package/ai/componentMetadata.cjs +13 -3
- package/ai/dist/mcp-server.js +140 -36407
- package/ai/examples.md +110 -7
- package/ai/reference.md +82 -28
- package/ai/schema.json +7675 -1471
- package/ai/surface-manifest.json +60 -9
- package/ai/system-prompt.md +18 -3
- package/ai/task-packets/compare-category-totals.json +301 -0
- package/ai/task-packets/compare-category-totals.md +188 -0
- package/ai/task-packets/correct-published-chart.json +271 -0
- package/ai/task-packets/correct-published-chart.md +597 -0
- package/ai/task-packets/index.json +40 -0
- package/ai/task-packets/update-live-chart.json +289 -0
- package/ai/task-packets/update-live-chart.md +424 -0
- package/dist/c-2N7IU2NY.min.js +1 -0
- package/dist/c-2WK7YJLL.min.js +1 -0
- package/dist/c-33QOXEUG.min.js +1 -0
- package/dist/c-42PLDTX7.min.js +1 -0
- package/dist/c-447VIMRO.min.js +1 -0
- package/dist/c-4FN7Q6VQ.min.js +1 -0
- package/dist/c-553QUDKA.min.js +1 -0
- package/dist/c-55BAJ333.min.js +1 -0
- package/dist/c-7242NXSG.min.js +1 -0
- package/dist/c-7EGHJU2F.min.js +1 -0
- package/dist/c-7HP7MB2I.min.js +1 -0
- package/dist/c-7NBU5ZKS.min.js +1 -0
- package/dist/c-AFBSWT77.min.js +1 -0
- package/dist/c-AJ7EC32V.min.js +1 -0
- package/dist/c-AQADQNY7.min.js +1 -0
- package/dist/c-ATM475SA.min.js +1 -0
- package/dist/c-AVO3Q7T7.min.js +1 -0
- package/dist/c-AZKPVBOC.min.js +1 -0
- package/dist/c-BNFJMDHN.min.js +1 -0
- package/dist/c-BNG5ECK5.min.js +1 -0
- package/dist/c-BOHCQILI.min.js +1 -0
- package/dist/c-CCTGN5CK.min.js +1 -0
- package/dist/c-CPSPZH6A.min.js +1 -0
- package/dist/c-CPV4N35K.min.js +1 -0
- package/dist/c-D6HAAPTX.min.js +1 -0
- package/dist/c-DE5Q3U2X.min.js +1 -0
- package/dist/c-DK662R77.min.js +1 -0
- package/dist/c-DY2676CR.min.js +1 -0
- package/dist/c-E32M6XW5.min.js +1 -0
- package/dist/c-E4JDJH4I.min.js +1 -0
- package/dist/c-E7I2L7CU.min.js +1 -0
- package/dist/c-EBOQ7ER7.min.js +1 -0
- package/dist/c-ELDWAO2V.min.js +1 -0
- package/dist/c-EUBTECGM.min.js +1 -0
- package/dist/c-GNTXRXRN.min.js +1 -0
- package/dist/c-GSZRZRD6.min.js +1 -0
- package/dist/c-GWX7JGMF.min.js +1 -0
- package/dist/c-GXV3C3MO.min.js +1 -0
- package/dist/c-HHTK2R75.min.js +1 -0
- package/dist/c-HLLFJYTY.min.js +1 -0
- package/dist/c-HPOYKCCG.min.js +1 -0
- package/dist/c-HXDKPIKR.min.js +1 -0
- package/dist/c-I4QJ6YLM.min.js +1 -0
- package/dist/c-IDJV3CZK.min.js +1 -0
- package/dist/c-ITKX3RC5.min.js +1 -0
- package/dist/c-JG2JCQLP.min.js +1 -0
- package/dist/c-JLGRHXGZ.min.js +1 -0
- package/dist/c-JO2UGTCP.min.js +1 -0
- package/dist/c-JUKIWTBJ.min.js +1 -0
- package/dist/c-KCRJGUHP.min.js +1 -0
- package/dist/c-LMGSSD2E.min.js +1 -0
- package/dist/c-LYQMZMZQ.min.js +1 -0
- package/dist/c-LYVKDBQJ.min.js +1 -0
- package/dist/c-MVR3RWF3.min.js +1 -0
- package/dist/c-MXCP7GNZ.min.js +1 -0
- package/dist/c-NG7BLZTR.min.js +1 -0
- package/dist/c-NYZ2QNAM.min.js +1 -0
- package/dist/c-OO5QLMJC.min.js +1 -0
- package/dist/c-OOVX2JPQ.min.js +1 -0
- package/dist/c-ORLEBW72.min.js +1 -0
- package/dist/c-P65V6HLO.min.js +1 -0
- package/dist/c-PP6VY3QU.min.js +1 -0
- package/dist/c-PRIKOLTE.min.js +1 -0
- package/dist/c-PSNI6KAZ.min.js +1 -0
- package/dist/c-PYNW54D2.min.js +1 -0
- package/dist/c-QA3HMQJP.min.js +1 -0
- package/dist/c-QAVFOEUY.min.js +1 -0
- package/dist/c-ROEHCIGV.min.js +1 -0
- package/dist/c-S3AZX5PP.min.js +1 -0
- package/dist/c-T2V7O2LO.min.js +1 -0
- package/dist/c-TIXX5CAU.min.js +1 -0
- package/dist/c-TKG2NP7G.min.js +1 -0
- package/dist/c-VJTDST2R.min.js +1 -0
- package/dist/c-VXLOLYTO.min.js +1 -0
- package/dist/c-W4ZUKSEQ.min.js +1 -0
- package/dist/c-WH2O53VI.min.js +1 -0
- package/dist/c-WNGH47HF.min.js +1 -0
- package/dist/c-WUWXGQYA.min.js +1 -0
- package/dist/c-XDQKXPX4.min.js +1 -0
- package/dist/c-XSB27XPS.min.js +1 -0
- package/dist/c-YDECTEUW.min.js +1 -0
- package/dist/c-YF3YKVQI.min.js +1 -0
- package/dist/c-YLZIV3VS.min.js +1 -0
- package/dist/c-ZYPXQF7B.min.js +1 -0
- package/dist/components/Annotation.d.ts +3 -2
- 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 +7 -1
- package/dist/components/ai/chartRecipes.d.ts +10 -0
- package/dist/components/ai/colorEvidence.d.ts +12 -0
- package/dist/components/ai/describePhysicsProjection.d.ts +18 -0
- package/dist/components/ai/describePhysicsSource.d.ts +13 -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/artifact/ArtifactInspector.d.ts +26 -0
- package/dist/components/artifact/ArtifactInspectorContextSections.d.ts +18 -0
- package/dist/components/artifact/artifactContractDiff.d.ts +8 -0
- package/dist/components/artifact/artifactInspectorSummary.d.ts +53 -0
- package/dist/components/artifact/artifactRevision.d.ts +54 -0
- package/dist/components/artifact/artifactTestFixtures.d.ts +17 -0
- package/dist/components/artifact/attachmentAudit.d.ts +13 -0
- package/dist/components/artifact/claimCorrections.d.ts +3 -0
- package/dist/components/artifact/claimGraph.d.ts +5 -0
- package/dist/components/artifact/claimLifecycle.d.ts +32 -0
- package/dist/components/artifact/claims.d.ts +24 -0
- package/dist/components/artifact/collection.d.ts +10 -0
- package/dist/components/artifact/collectionCorrectionScope.d.ts +4 -0
- package/dist/components/artifact/collectionImpact.d.ts +11 -0
- package/dist/components/artifact/collectionLineage.d.ts +3 -0
- package/dist/components/artifact/collectionOperations.d.ts +8 -0
- package/dist/components/artifact/collectionPolicy.d.ts +22 -0
- package/dist/components/artifact/collectionTypes.d.ts +117 -0
- package/dist/components/artifact/configurationRepair.d.ts +8 -0
- package/dist/components/artifact/contract.d.ts +30 -0
- package/dist/components/artifact/evaluateArtifact.d.ts +12 -0
- package/dist/components/artifact/evaluateArtifactTypes.d.ts +78 -0
- package/dist/components/artifact/evaluationPresentation.d.ts +9 -0
- package/dist/components/artifact/evidenceSample.d.ts +8 -0
- package/dist/components/artifact/exportPaths.d.ts +8 -0
- package/dist/components/artifact/fieldPolicies.d.ts +12 -0
- package/dist/components/artifact/fingerprint.d.ts +36 -0
- package/dist/components/artifact/grounding.d.ts +51 -0
- package/dist/components/artifact/groundingBudget.d.ts +38 -0
- package/dist/components/artifact/hostTransfer.d.ts +13 -0
- package/dist/components/artifact/identity.d.ts +19 -0
- package/dist/components/artifact/inheritance.d.ts +48 -0
- package/dist/components/artifact/inheritanceIntegrity.d.ts +3 -0
- package/dist/components/artifact/jsonCompatibility.d.ts +2 -0
- package/dist/components/artifact/obligations.d.ts +3 -0
- package/dist/components/artifact/policies.d.ts +45 -0
- package/dist/components/artifact/policyRelations.d.ts +3 -0
- package/dist/components/artifact/recordProjection.d.ts +7 -0
- package/dist/components/artifact/representation.d.ts +50 -0
- package/dist/components/artifact/serialization.d.ts +40 -0
- package/dist/components/artifact/temporal.d.ts +32 -0
- package/dist/components/artifact/temporalAdapters.d.ts +75 -0
- package/dist/components/artifact/temporalAuditHelpers.d.ts +12 -0
- package/dist/components/artifact/temporalPresentation.d.ts +8 -0
- package/dist/components/artifact/types.d.ts +341 -0
- package/dist/components/artifact/validation.d.ts +13 -0
- package/dist/components/artifact/validationFieldStatus.d.ts +7 -0
- package/dist/components/artifact/validationPrimitives.d.ts +24 -0
- package/dist/components/artifact/validationSurfaces.d.ts +7 -0
- package/dist/components/artifact/validationTemporal.d.ts +3 -0
- package/dist/components/charts/geo/FlowMap.d.ts +7 -0
- package/dist/components/charts/geo/flowMapLineStyle.d.ts +18 -0
- 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 +5 -0
- package/dist/components/charts/ordinal/DotPlot.d.ts +3 -0
- package/dist/components/charts/ordinal/FunnelChart.d.ts +5 -0
- package/dist/components/charts/ordinal/GaugeChart.d.ts +3 -0
- package/dist/components/charts/ordinal/GroupedBarChart.d.ts +6 -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 +5 -0
- package/dist/components/charts/ordinal/RadarChart.capability.d.ts +2 -0
- package/dist/components/charts/ordinal/RadarChart.d.ts +77 -0
- package/dist/components/charts/ordinal/RidgelinePlot.d.ts +3 -0
- package/dist/components/charts/ordinal/StackedBarChart.d.ts +6 -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/CollisionSwarmChart.d.ts +1 -1
- package/dist/components/charts/physics/EventDropChart.d.ts +3 -1
- package/dist/components/charts/physics/GaltonBoardChart.d.ts +4 -2
- package/dist/components/charts/physics/GauntletChart.d.ts +1 -5
- package/dist/components/charts/physics/ProcessFlowChart.d.ts +6 -0
- package/dist/components/charts/physics/UnitPileChart.d.ts +2 -1
- package/dist/components/charts/physics/chainReactionTypes.d.ts +3 -0
- package/dist/components/charts/physics/collisionSwarmPacking.d.ts +14 -0
- package/dist/components/charts/physics/collisionSwarmPhysics.d.ts +1 -0
- package/dist/components/charts/physics/eventDropAdmission.d.ts +32 -0
- package/dist/components/charts/physics/eventDropPhysics.d.ts +22 -1
- package/dist/components/charts/physics/galtonBoardPhysics.d.ts +2 -9
- package/dist/components/charts/physics/gauntletPhysics.d.ts +1 -0
- package/dist/components/charts/physics/physicsChartReconcile.d.ts +4 -0
- package/dist/components/charts/physics/physicsChartUtils.d.ts +1 -1
- package/dist/components/charts/physics/physicsGaltonData.d.ts +10 -0
- package/dist/components/charts/physics/physicsHocHandle.d.ts +2 -0
- package/dist/components/charts/physics/physicsHocUtils.d.ts +7 -1
- package/dist/components/charts/physics/physicsPileData.d.ts +11 -0
- package/dist/components/charts/physics/physicsPilePhysics.d.ts +5 -12
- package/dist/components/charts/physics/physicsProjectionOverlays.d.ts +1 -1
- package/dist/components/charts/physics/physicsSourceRows.d.ts +8 -0
- package/dist/components/charts/physics/usePhysicsChartData.d.ts +19 -0
- package/dist/components/charts/realtime/RealtimeHeatmap.d.ts +14 -1
- package/dist/components/charts/realtime/RealtimeHistogram.d.ts +25 -7
- package/dist/components/charts/realtime/RealtimeLineChart.d.ts +18 -5
- package/dist/components/charts/realtime/RealtimeSwarmChart.d.ts +11 -1
- package/dist/components/charts/realtime/RealtimeWaterfallChart.d.ts +11 -1
- package/dist/components/charts/realtime/aggregate.d.ts +12 -1
- package/dist/components/charts/realtime/realtimeAccessors.d.ts +4 -0
- package/dist/components/charts/realtime/realtimeChartRuntime.d.ts +8 -5
- package/dist/components/charts/realtime/realtimeChartTypes.d.ts +7 -0
- package/dist/components/charts/realtime/realtimeStyleRules.d.ts +4 -0
- package/dist/components/charts/realtime/temporalHistogramConfig.d.ts +17 -11
- package/dist/components/charts/shared/GaugeReadout.d.ts +9 -0
- package/dist/components/charts/shared/ThresholdAnnotation.d.ts +18 -0
- package/dist/components/charts/shared/ThresholdEndCap.d.ts +7 -0
- package/dist/components/charts/shared/annotationStatusFilter.d.ts +18 -0
- package/dist/components/charts/shared/auditAccessibilityText.d.ts +4 -2
- 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/numericTickFormatter.d.ts +2 -0
- package/dist/components/charts/shared/radialCenterContent.d.ts +10 -0
- package/dist/components/charts/shared/selectionUtils.d.ts +3 -1
- package/dist/components/charts/shared/tooltipUtils.d.ts +1 -1
- package/dist/components/charts/shared/types.d.ts +4 -2
- package/dist/components/charts/shared/useChartLegend.d.ts +6 -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/shared/useXYPointStyle.d.ts +2 -0
- package/dist/components/charts/xy/BubbleChart.d.ts +7 -0
- package/dist/components/charts/xy/CandlestickChart.d.ts +7 -0
- package/dist/components/charts/xy/DifferenceChart.d.ts +7 -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/MinimapChart.d.ts +7 -0
- package/dist/components/charts/xy/MultiAxisLineChart.d.ts +7 -0
- package/dist/components/charts/xy/Scatterplot.d.ts +7 -0
- package/dist/components/charts/xy/ScatterplotMatrix.d.ts +6 -0
- package/dist/components/charts/xy/WaterfallChart.capability.d.ts +2 -0
- package/dist/components/charts/xy/WaterfallChart.d.ts +76 -0
- package/dist/components/charts/xy/differenceMarkStyle.d.ts +28 -0
- package/dist/components/charts/xy/multiAxisFields.d.ts +23 -0
- package/dist/components/charts/xy/scatterplotMatrixCells.d.ts +50 -0
- package/dist/components/evidence/chartEvidenceEnvelope.d.ts +154 -0
- package/dist/components/evidence/evidenceEnvelopeInput.d.ts +8 -0
- package/dist/components/evidence/evidenceEnvelopeValidation.d.ts +11 -0
- package/dist/components/evidence/evidenceGate.d.ts +30 -0
- package/dist/components/evidence/renderedSceneHash.d.ts +23 -0
- package/dist/components/evidence/stableJsonHash.d.ts +4 -0
- package/dist/components/export/chartConfig.d.ts +40 -5
- package/dist/components/export/chartConfigArtifact.d.ts +6 -0
- package/dist/components/legendLayout.d.ts +18 -0
- package/dist/components/legendStyles.d.ts +4 -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/firstAvailableTrack.d.ts +17 -0
- package/dist/components/recipes/intervals.d.ts +1 -1
- 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 +38 -18
- package/dist/components/semiotic-ai.d.ts +20 -20
- package/dist/components/semiotic-artifact-react.d.ts +10 -0
- package/dist/components/semiotic-artifact.d.ts +23 -0
- package/dist/components/semiotic-evidence.d.ts +10 -0
- package/dist/components/semiotic-experimental.d.ts +1 -1
- 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-physics.d.ts +4 -4
- package/dist/components/semiotic-realtime-core.d.ts +3 -2
- package/dist/components/semiotic-recipes-core.d.ts +6 -0
- package/dist/components/semiotic-text.d.ts +2 -0
- package/dist/components/semiotic-themes-core.d.ts +3 -0
- package/dist/components/semiotic-utils-core.d.ts +19 -14
- package/dist/components/semiotic-xy.d.ts +3 -0
- package/dist/components/semiotic.d.ts +11 -5
- package/dist/components/server/renderDashboard.d.ts +37 -0
- package/dist/components/server/renderEvidence.d.ts +39 -0
- package/dist/components/server/renderToStaticSVG.d.ts +5 -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/server/staticSVGChrome.d.ts +1 -4
- package/dist/components/server/staticXYAxisTicks.d.ts +2 -38
- package/dist/components/server/staticXYGrid.d.ts +1 -1
- package/dist/components/server/svgSizing.d.ts +6 -0
- package/dist/components/shared/svgRoot.d.ts +17 -0
- package/dist/components/store/selectionProvenance.d.ts +14 -0
- package/dist/components/store/themeCore.d.ts +5 -1
- package/dist/components/stream/GeoPipelineStore.d.ts +1 -1
- package/dist/components/stream/GeoSVGOverlay.d.ts +4 -0
- 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/NetworkSVGOverlay.d.ts +4 -0
- package/dist/components/stream/OrdinalPipelineStore.d.ts +1 -1
- package/dist/components/stream/OrdinalSVGOverlay.d.ts +4 -0
- package/dist/components/stream/PipelineStore.d.ts +1 -1
- package/dist/components/stream/SVGOverlay.d.ts +4 -0
- package/dist/components/stream/SceneToSVG.d.ts +4 -19
- package/dist/components/stream/SceneToSVGXY.d.ts +13 -0
- package/dist/components/stream/StreamGeoFrame.d.ts +1 -2
- package/dist/components/stream/StreamOrdinalFrame.d.ts +1 -2
- package/dist/components/stream/XYGrid.d.ts +11 -0
- package/dist/components/stream/axisTickUtils.d.ts +0 -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/hitTestUtils.d.ts +2 -0
- 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/overlayAccessibleText.d.ts +18 -0
- package/dist/components/stream/physics/PhysicsControllers.d.ts +1 -1
- package/dist/components/stream/physics/PhysicsKernel.d.ts +9 -0
- package/dist/components/stream/physics/PhysicsPipelineStore.d.ts +5 -4
- package/dist/components/stream/physics/PhysicsPipelineTypes.d.ts +9 -0
- package/dist/components/stream/physics/StreamPhysicsTypes.d.ts +4 -1
- package/dist/components/stream/physics/physicsCanvasCoordinates.d.ts +5 -0
- package/dist/components/stream/physics/physicsFixedPosition.d.ts +16 -0
- package/dist/components/stream/physics/physicsKernelCloning.d.ts +6 -0
- package/dist/components/stream/physics/physicsPipelineObservations.d.ts +2 -0
- package/dist/components/stream/physics/physicsPipelineSettle.d.ts +15 -9
- package/dist/components/stream/physics/physicsRegionRuntime.d.ts +8 -17
- package/dist/components/stream/physics/physicsSemanticUI.d.ts +9 -0
- package/dist/components/stream/pipelineConfig.d.ts +4 -0
- package/dist/components/stream/pipelineDomainResolution.d.ts +6 -0
- package/dist/components/stream/pipelineStoreUpdateResults.d.ts +1 -1
- package/dist/components/stream/renderers/pointCanvasRenderer.d.ts +4 -0
- package/dist/components/stream/renderers/resolveCSSColor.d.ts +4 -4
- package/dist/components/stream/resolveXYAxes.d.ts +13 -0
- package/dist/components/stream/sceneToSVGShared.d.ts +2 -1
- package/dist/components/stream/seriesGeometry.d.ts +13 -0
- package/dist/components/stream/streamEncodingTypes.d.ts +53 -0
- package/dist/components/stream/types.d.ts +12 -54
- package/dist/components/stream/useEnsureCustomXYRenderers.d.ts +18 -0
- package/dist/components/stream/useGeoFrameHandle.d.ts +16 -0
- package/dist/components/stream/useMarginalValues.d.ts +13 -0
- package/dist/components/stream/useOrdinalFrameHandle.d.ts +15 -0
- package/dist/components/stream/useXYFrameHandle.d.ts +15 -0
- package/dist/components/stream/xyAxisTicks.d.ts +25 -0
- package/dist/components/stream/xyCanvasRenderers.d.ts +4 -4
- package/dist/components/stream/xyDateTicks.d.ts +3 -2
- package/dist/components/stream/xyFrameAxisTypes.d.ts +2 -0
- 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/components/stream/xySceneBuilders/ribbonScene.d.ts +1 -1
- package/dist/components/stream/xySceneBuilders/types.d.ts +1 -0
- package/dist/components/text/annotationTextLayout.d.ts +28 -0
- package/dist/components/text/pretextAnnotationLayout.d.ts +29 -0
- package/dist/components/text/usePretextAnnotations.d.ts +12 -0
- package/dist/controls.module.min.js +1 -1
- package/dist/forceLayoutWorker.js +1 -1
- package/dist/geo.min.js +1 -1
- package/dist/geo.module.min.js +1 -1
- package/dist/network.module.min.js +1 -1
- package/dist/ordinal.module.min.js +1 -1
- package/dist/physics-matter.min.js +1 -1
- package/dist/physics-matter.module.min.js +1 -1
- package/dist/physics-rapier.min.js +1 -1
- package/dist/physics-rapier.module.min.js +1 -1
- package/dist/physics.module.min.js +1 -1
- package/dist/physicsWorker.js +1 -1
- package/dist/processSankeyLayoutWorker.js +1 -1
- package/dist/rough.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-artifact-policy-constants.module.min.js +2 -0
- package/dist/semiotic-ai-core.d.ts +38 -18
- package/dist/semiotic-ai-core.min.js +1 -1
- package/dist/semiotic-ai-core.module.min.js +1 -1
- package/dist/semiotic-ai-hash-primitives.module.min.js +2 -0
- package/dist/semiotic-ai.d.ts +20 -20
- package/dist/semiotic-ai.module.min.js +1 -1
- package/dist/semiotic-artifact-react.d.ts +10 -0
- package/dist/semiotic-artifact-react.min.js +2 -0
- package/dist/semiotic-artifact-react.module.min.js +2 -0
- package/dist/semiotic-artifact.d.ts +23 -0
- package/dist/semiotic-artifact.min.js +1 -0
- package/dist/semiotic-artifact.module.min.js +1 -0
- package/dist/semiotic-client-cjs-shared.min.js +1 -1
- package/dist/semiotic-client-glyph.module.min.js +1 -1
- package/dist/semiotic-client-responsive.module.min.js +1 -1
- package/dist/semiotic-client-shared.module.min.js +1 -1
- package/dist/semiotic-custom-layout-selection-cjs-shared.min.js +1 -1
- package/dist/semiotic-data.min.js +1 -1
- package/dist/semiotic-data.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-experimental.d.ts +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-physics.d.ts +4 -4
- package/dist/semiotic-realtime-core.d.ts +3 -2
- package/dist/semiotic-realtime-core.module.min.js +1 -1
- package/dist/semiotic-realtime-react.module.min.js +1 -1
- package/dist/semiotic-recipes-core-cjs-base.min.js +1 -1
- package/dist/semiotic-recipes-core.d.ts +6 -0
- package/dist/semiotic-recipes-core.module.min.js +1 -1
- package/dist/semiotic-recipes-geo-cjs.min.js +1 -1
- package/dist/semiotic-recipes-react.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-text.d.ts +2 -0
- package/dist/semiotic-text.min.js +2 -0
- package/dist/semiotic-text.module.min.js +2 -0
- 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 +19 -14
- package/dist/semiotic-utils-core.min.js +1 -1
- package/dist/semiotic-utils-core.module.min.js +1 -1
- package/dist/semiotic-value.module.min.js +1 -1
- package/dist/semiotic-xy.d.ts +3 -0
- package/dist/semiotic.d.ts +11 -5
- 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 +91 -71
- package/spec/README.md +8 -3
- package/spec/v0.1/artifact-contract.schema.json +2299 -0
- package/spec/v0.1/examples/artifact-contract-full.json +369 -0
- package/spec/v0.1/examples/artifact-contract-unknown-state.json +46 -0
- package/dist/c-3BLJEQNG.min.js +0 -1
- package/dist/c-3KZD6AXJ.min.js +0 -1
- package/dist/c-4TWEX5HG.min.js +0 -1
- package/dist/c-52TEGIUJ.min.js +0 -1
- package/dist/c-5YCIX3VZ.min.js +0 -1
- package/dist/c-6FEKTA3U.min.js +0 -1
- package/dist/c-6O5EVOPH.min.js +0 -1
- package/dist/c-74HEEZGK.min.js +0 -1
- package/dist/c-AKAF6JAD.min.js +0 -1
- package/dist/c-BBKITSXB.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-COHXCW3Q.min.js +0 -1
- package/dist/c-DADXPJXV.min.js +0 -1
- package/dist/c-E3JFRRMI.min.js +0 -1
- package/dist/c-EBFPQHHO.min.js +0 -1
- package/dist/c-G36WS6LN.min.js +0 -1
- package/dist/c-GGISSW5E.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-IUHFPMHD.min.js +0 -1
- package/dist/c-J5G56TUH.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-MNF2S4AA.min.js +0 -1
- package/dist/c-MT3WBK7M.min.js +0 -1
- package/dist/c-NY3JWV2K.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-PPWDL5ZI.min.js +0 -1
- package/dist/c-QHF5YON3.min.js +0 -1
- package/dist/c-RR3GO5SW.min.js +0 -1
- package/dist/c-RSVIHIQ4.min.js +0 -1
- package/dist/c-S2BXNNJN.min.js +0 -1
- package/dist/c-S6U5CGT5.min.js +0 -1
- package/dist/c-SLGMUBUL.min.js +0 -1
- package/dist/c-SUILCHWU.min.js +0 -1
- package/dist/c-TZW3JGJ5.min.js +0 -1
- package/dist/c-US5ZFT6E.min.js +0 -1
- package/dist/c-USFMFKIH.min.js +0 -1
- package/dist/c-UUKVD4WB.min.js +0 -1
- package/dist/c-VGW3VG3I.min.js +0 -1
- package/dist/c-W3CE4A4S.min.js +0 -1
- package/dist/c-WJCD5EUY.min.js +0 -1
- package/dist/c-X5UBGU2V.min.js +0 -1
- package/dist/c-YDAY2WFR.min.js +0 -1
- package/dist/c-ZOWWU34K.min.js +0 -1
- /package/dist/{c-N4G2L7ID.min.js → c-HYW2XA4Q.min.js} +0 -0
- /package/dist/{c-OCI56QF2.min.js → c-V4XMSLC3.min.js} +0 -0
|
@@ -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;
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Shared accessible `<title>` / `<desc>` text for frame SVG overlays.
|
|
3
|
+
*
|
|
4
|
+
* Live overlays historically copied XY fallbacks (including Geo naming maps
|
|
5
|
+
* "XY Chart") and ignored `description`. Keep family-specific fallbacks here
|
|
6
|
+
* so canvas aria-labels, overlay chrome, and static SVG stay aligned.
|
|
7
|
+
*/
|
|
8
|
+
export declare function overlayAccessibleTitle(title: unknown, fallback: string): string;
|
|
9
|
+
export declare function overlayAccessibleDescription(title: unknown, description: unknown, options: {
|
|
10
|
+
familyPhrase: string;
|
|
11
|
+
fallback: string;
|
|
12
|
+
}): string;
|
|
13
|
+
/** Instance-local `<title>` / `<desc>` ids so two charts on one page do not collide. */
|
|
14
|
+
export declare function overlayAccessibleIds(idPrefix: string): {
|
|
15
|
+
titleId: string;
|
|
16
|
+
descId: string;
|
|
17
|
+
labelledBy: string;
|
|
18
|
+
};
|
|
@@ -57,7 +57,7 @@ export interface ComposedPhysicsControllers {
|
|
|
57
57
|
}
|
|
58
58
|
/**
|
|
59
59
|
* Compose controllers into a single continuous flag, bodyForce, and onTick.
|
|
60
|
-
* Call onTick from StreamPhysicsFrame after each
|
|
60
|
+
* Call onTick from StreamPhysicsFrame after each fixed simulation step; `ctx.dt`
|
|
61
61
|
* accounts for every fixed substep completed by that tick.
|
|
62
62
|
*/
|
|
63
63
|
export declare function composePhysicsControllers(controllers: readonly PhysicsController[] | undefined | null): ComposedPhysicsControllers | null;
|
|
@@ -55,6 +55,11 @@ export interface PhysicsBodySpec {
|
|
|
55
55
|
friction?: number;
|
|
56
56
|
/** Disable body-body contacts for visual/tethered satellite marks. */
|
|
57
57
|
bodyCollisions?: boolean;
|
|
58
|
+
/** Hold either coordinate exactly, allowing motion on the other axis. */
|
|
59
|
+
fixedPosition?: {
|
|
60
|
+
x?: number;
|
|
61
|
+
y?: number;
|
|
62
|
+
};
|
|
58
63
|
shape: PhysicsBodyShape;
|
|
59
64
|
datum?: unknown;
|
|
60
65
|
}
|
|
@@ -69,6 +74,10 @@ export interface PhysicsBodyState {
|
|
|
69
74
|
angle: number;
|
|
70
75
|
mass: number;
|
|
71
76
|
bodyCollisions?: boolean;
|
|
77
|
+
fixedPosition?: {
|
|
78
|
+
x?: number;
|
|
79
|
+
y?: number;
|
|
80
|
+
};
|
|
72
81
|
shape: PhysicsBodyShape;
|
|
73
82
|
sleeping: boolean;
|
|
74
83
|
datum?: unknown;
|
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
import { type PhysicsBodyState, type PhysicsColliderSpec, type PhysicsKernelEvent, type PhysicsSpringSpec } from "./PhysicsKernel";
|
|
2
2
|
import { type PhysicsSedimentBinSnapshot, type PhysicsSedimentColumn, type PhysicsSedimentHeightfieldOptions, type PhysicsSedimentTotals } from "./PhysicsSediment";
|
|
3
3
|
import { type PhysicsBodyBudgetDecision } from "./PhysicsBodyBudget";
|
|
4
|
-
import type { PhysicsObservationEvent, PhysicsObservationRecord, PhysicsPipelineConfig, PhysicsPipelineControlSurface, PhysicsPipelineSnapshot, PhysicsPipelineTickResult, PhysicsQueuedSpawn, PhysicsSpawnPacingOptions } from "./PhysicsPipelineTypes";
|
|
4
|
+
import type { PhysicsObservationEvent, PhysicsObservationRecord, PhysicsPipelineConfig, PhysicsPipelineExecution, PhysicsPipelineControlSurface, PhysicsPipelineSnapshot, PhysicsPipelineTickResult, PhysicsQueuedSpawn, PhysicsSpawnPacingOptions } from "./PhysicsPipelineTypes";
|
|
5
5
|
import { type UpdateResult } from "../pipelineUpdateContract";
|
|
6
6
|
import { type PhysicsBodyHitTestOptions } from "./PhysicsBodySpatialIndex";
|
|
7
|
-
export type { PhysicsPlotBounds, PhysicsBoundsColliderOptions, PhysicsXBinColliderOptions, PhysicsSpawnSpringSpec, PhysicsQueuedSpawn, PhysicsSpawnPacing, PhysicsSpawnTimeAccessor, PhysicsSpawnPacingOptions, PhysicsPipelineQueuedSpawnSnapshot, PhysicsObservationEventType, PhysicsSimulationState, PhysicsObservationEvent, PhysicsObservationRecord, PhysicsSensorObservationConfig, PhysicsPipelineObservationOptions, PhysicsPipelineConfig, PhysicsPipelineTickResult, PhysicsPipelineSnapshot, PhysicsPipelineControlSurface } from "./PhysicsPipelineTypes";
|
|
7
|
+
export type { PhysicsPlotBounds, PhysicsBoundsColliderOptions, PhysicsXBinColliderOptions, PhysicsSpawnSpringSpec, PhysicsQueuedSpawn, PhysicsSpawnPacing, PhysicsSpawnTimeAccessor, PhysicsSpawnPacingOptions, PhysicsPipelineQueuedSpawnSnapshot, PhysicsObservationEventType, PhysicsSimulationState, PhysicsObservationEvent, PhysicsObservationRecord, PhysicsSensorObservationConfig, PhysicsPipelineObservationOptions, PhysicsPipelineConfig, PhysicsPipelineExecution, PhysicsPipelineTickResult, PhysicsPipelineSnapshot, PhysicsPipelineControlSurface } from "./PhysicsPipelineTypes";
|
|
8
8
|
export { schedulePhysicsSpawns, collidersFromPlotBounds, collidersFromXScaleBins } from "./physicsPipelineHelpers";
|
|
9
9
|
export type { ChangeSet, Invalidation, RevisionSet, UpdateResult } from "../pipelineUpdateContract";
|
|
10
10
|
export declare class PhysicsPipelineStore {
|
|
@@ -49,10 +49,11 @@ export declare class PhysicsPipelineStore {
|
|
|
49
49
|
*/
|
|
50
50
|
materializeDueSpawns(): string[];
|
|
51
51
|
clear(): void;
|
|
52
|
-
tick(deltaSeconds: number): PhysicsPipelineTickResult;
|
|
52
|
+
tick(deltaSeconds: number, execution?: PhysicsPipelineExecution): PhysicsPipelineTickResult;
|
|
53
53
|
/** Steps-only settle. Kernel/sensor transitions are stepped but not observed. */
|
|
54
54
|
settle(maxSteps?: number): number;
|
|
55
|
-
settleWithObservations(maxSteps?: number): PhysicsPipelineTickResult;
|
|
55
|
+
settleWithObservations(maxSteps?: number, execution?: PhysicsPipelineExecution): PhysicsPipelineTickResult;
|
|
56
|
+
private stepObserver;
|
|
56
57
|
/** Bind this store to the shared settle loop (see physicsPipelineSettle). */
|
|
57
58
|
private settleHost;
|
|
58
59
|
/**
|
|
@@ -141,6 +141,15 @@ export interface PhysicsPipelineTickResult {
|
|
|
141
141
|
spawned: string[];
|
|
142
142
|
steps: number;
|
|
143
143
|
}
|
|
144
|
+
/** Optional fixed-step execution for authored forces and process controllers. */
|
|
145
|
+
export interface PhysicsPipelineExecution {
|
|
146
|
+
/** Called once after admitting due bodies (steps=0), then after each fixed step.
|
|
147
|
+
* Each result contains only that boundary's events and admissions. */
|
|
148
|
+
onStep: (result: PhysicsPipelineTickResult) => void;
|
|
149
|
+
/** Keep a bounded settle advancing while semantic work remains at physical rest.
|
|
150
|
+
* The configured or supplied step limit still applies. */
|
|
151
|
+
continueWhile?: () => boolean;
|
|
152
|
+
}
|
|
144
153
|
export interface PhysicsPipelineSnapshot {
|
|
145
154
|
accumulator: number;
|
|
146
155
|
activeSensorPairs: string[];
|
|
@@ -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
|
/**
|
|
@@ -294,6 +294,9 @@ export interface StreamPhysicsFrameProps {
|
|
|
294
294
|
onBodyHover?: (body: PhysicsBodyState | null, hover: PhysicsHoverData | null) => void;
|
|
295
295
|
onSemanticItemActivate?: (item: PhysicsSemanticItem) => void;
|
|
296
296
|
onSemanticItemFocus?: (item: PhysicsSemanticItem | null) => void;
|
|
297
|
+
/** Runs at admission (steps=0) and after each fixed simulation step (steps=1),
|
|
298
|
+
* including reduced-motion and imperative settles. Respect elapsedSeconds or
|
|
299
|
+
* steps for time-based work. Callback-driven execution uses the sync engine. */
|
|
297
300
|
onTick?: (result: PhysicsPipelineTickResult, controls: PhysicsPipelineControlSurface) => void;
|
|
298
301
|
/** Uniform opacity for bodies when `bodyStyle` does not set `opacity`. */
|
|
299
302
|
opacity?: number;
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
import type { PhysicsBodyState } from "./PhysicsKernel";
|
|
2
|
+
/** Fixed coordinates take precedence over forces, impulses, and contacts. */
|
|
3
|
+
export declare function enforceFixedPosition(body: PhysicsBodyState): void;
|
|
4
|
+
export declare function cloneFixedPosition(fixed: PhysicsBodyState["fixedPosition"]): {
|
|
5
|
+
x: number | undefined;
|
|
6
|
+
y: number | undefined;
|
|
7
|
+
} | undefined;
|
|
8
|
+
/**
|
|
9
|
+
* Contact separation along the remaining free axis. A radial circle normal
|
|
10
|
+
* cannot separate two equal-x circles horizontally when x encodes a value.
|
|
11
|
+
*/
|
|
12
|
+
export declare function fixedAxisContact(a: PhysicsBodyState, b: PhysicsBodyState, fixedAxis: "x" | "y"): {
|
|
13
|
+
nx: number;
|
|
14
|
+
ny: number;
|
|
15
|
+
penetration: number;
|
|
16
|
+
};
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
import type { PhysicsBodyShape, PhysicsColliderShape, PhysicsColliderBodyFilter, PhysicsKernelSnapshotBody, PhysicsKernelSnapshotCollider } from "./PhysicsKernel";
|
|
2
|
+
export declare function cloneShape(shape: PhysicsBodyShape): PhysicsBodyShape;
|
|
3
|
+
export declare function cloneColliderShape(shape: PhysicsColliderShape): PhysicsColliderShape;
|
|
4
|
+
export declare function cloneBody(body: PhysicsKernelSnapshotBody): PhysicsKernelSnapshotBody;
|
|
5
|
+
export declare function cloneColliderBodyFilter(filter: PhysicsColliderBodyFilter | undefined): PhysicsColliderBodyFilter | undefined;
|
|
6
|
+
export declare function cloneCollider(collider: PhysicsKernelSnapshotCollider): PhysicsKernelSnapshotCollider;
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import type { PhysicsBodyBudgetDecision } from "./PhysicsBodyBudget";
|
|
1
2
|
import type { PhysicsEngineAdapter } from "./PhysicsEngineAdapter";
|
|
2
3
|
import type { PhysicsKernelEvent } from "./PhysicsKernel";
|
|
3
4
|
import type { PhysicsObservationEvent, PhysicsSimulationState } from "./PhysicsPipelineTypes";
|
|
@@ -12,3 +13,4 @@ export declare function observePhysicsSensorTransitions(world: PhysicsEngineAdap
|
|
|
12
13
|
export declare function removePhysicsSensorPairsForBodies(pairs: Set<string>, bodyIds: ReadonlySet<string>): void;
|
|
13
14
|
export declare function resolvePhysicsSimulationState(paused: boolean, visible: boolean, hasQueuedBodies: boolean, atRest: boolean): PhysicsSimulationState;
|
|
14
15
|
export declare function emitPhysicsSimulationStateTransition(previous: PhysicsSimulationState, next: PhysicsSimulationState, context: PhysicsObservationContext): void;
|
|
16
|
+
export declare function emitPhysicsBodyBudgetObservation(decision: PhysicsBodyBudgetDecision, context: PhysicsObservationContext): void;
|
|
@@ -1,18 +1,16 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* The shared
|
|
2
|
+
* The shared fixed-step loop behind live ticks and both of
|
|
3
3
|
* `PhysicsPipelineStore`'s settle entry points.
|
|
4
4
|
*
|
|
5
|
-
*
|
|
6
|
-
*
|
|
7
|
-
*
|
|
8
|
-
*
|
|
9
|
-
* finish on the reduced-motion / snapshot path instead of freezing at the first
|
|
10
|
-
* spawn instant. Both entry points run this one loop so they cannot drift apart.
|
|
5
|
+
* Each step advances simulated time and admits due arrivals. An observed run
|
|
6
|
+
* can also execute authored behavior at that boundary. The step limit bounds
|
|
7
|
+
* the work; reaching it does not prove that every arrival or process completed.
|
|
8
|
+
* Both entry points use this loop so pacing cannot drift between them.
|
|
11
9
|
*/
|
|
12
10
|
import type { PhysicsBodyBudgetDecision } from "./PhysicsBodyBudget";
|
|
13
11
|
import type { PhysicsKernelEvent } from "./PhysicsKernel";
|
|
14
12
|
import type { PhysicsPipelineEvictionResult } from "./physicsPipelineHelpers";
|
|
15
|
-
import type { PhysicsObservationEvent } from "./PhysicsPipelineTypes";
|
|
13
|
+
import type { PhysicsObservationEvent, PhysicsPipelineExecution, PhysicsPipelineTickResult } from "./PhysicsPipelineTypes";
|
|
16
14
|
/**
|
|
17
15
|
* The slice of store behavior the loop drives. Passed explicitly (rather than
|
|
18
16
|
* reaching into the store) so the loop stays independently testable.
|
|
@@ -49,4 +47,12 @@ export interface PhysicsSettleRun {
|
|
|
49
47
|
steps: number;
|
|
50
48
|
budget?: PhysicsBodyBudgetDecision;
|
|
51
49
|
}
|
|
52
|
-
|
|
50
|
+
/** Deliver each admission/event exactly once, while retaining the aggregate
|
|
51
|
+
* result for the caller of tick or settleWithObservations. */
|
|
52
|
+
export declare function createPhysicsStepObserver(execution: PhysicsPipelineExecution | undefined, readResult: (steps: number) => PhysicsPipelineTickResult): (() => void) | undefined;
|
|
53
|
+
export declare function runPhysicsSettleSteps(host: PhysicsSettleHost, maxSteps: number, sink: PhysicsSettleSink, options?: {
|
|
54
|
+
stopAtRest?: boolean;
|
|
55
|
+
shouldStop?: () => boolean;
|
|
56
|
+
continueWhile?: () => boolean;
|
|
57
|
+
afterStep?: () => void;
|
|
58
|
+
}): PhysicsSettleRun;
|
|
@@ -35,23 +35,14 @@ export interface PhysicsPostTickOutcome {
|
|
|
35
35
|
snapshot: ReturnType<PhysicsPipelineStore["snapshot"]>;
|
|
36
36
|
result: PhysicsPipelineTickResult;
|
|
37
37
|
}
|
|
38
|
-
/**
|
|
39
|
-
*
|
|
40
|
-
*
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
* The reduced-motion / snapshot render pass.
|
|
47
|
-
*
|
|
48
|
-
* Reduced motion never schedules a second frame, so any work a settle hands to
|
|
49
|
-
* `onTick` — an event tape spawning gate bodies, a capacity controller
|
|
50
|
-
* releasing queued items — would be enqueued and never simulated. Settle
|
|
51
|
-
* repeatedly while the store still reports pending work so the scene reaches
|
|
52
|
-
* the same end state an animated run would.
|
|
53
|
-
*/
|
|
54
|
-
export declare function runPhysicsReducedMotionPasses(store: PhysicsPipelineStore, postTick: (result: PhysicsPipelineTickResult) => Omit<PhysicsPostTickOutcome, "result">, maxPasses?: number): PhysicsPostTickOutcome;
|
|
38
|
+
/** Run authored behavior at every fixed step, including during bounded settles.
|
|
39
|
+
* An omitted delta selects settling; the step limit is a budget, not a claim
|
|
40
|
+
* that a continuous process has finished. */
|
|
41
|
+
export declare function runPhysicsObservedSteps(store: PhysicsPipelineStore, postTick: (result: PhysicsPipelineTickResult) => Omit<PhysicsPostTickOutcome, "result">, options?: {
|
|
42
|
+
deltaSeconds?: number;
|
|
43
|
+
maxSteps?: number;
|
|
44
|
+
continueWhile?: () => boolean;
|
|
45
|
+
}): PhysicsPostTickOutcome;
|
|
55
46
|
/**
|
|
56
47
|
* Shared post-tick pipeline: region forces → body forces → controllers → onTick.
|
|
57
48
|
* Used by the main RAF path and the worker-fallback path (DRY + one snapshot).
|
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
* Physics frame semantic items, default tooltip, and accessible data table.
|
|
3
3
|
*/
|
|
4
4
|
import * as React from "react";
|
|
5
|
+
import type { FrameMargin } from "../useFrame";
|
|
5
6
|
import type { PhysicsBodyState } from "./PhysicsKernel";
|
|
6
7
|
import type { PhysicsSimulationState } from "./PhysicsPipelineStore";
|
|
7
8
|
import type { PhysicsHoverData, PhysicsSemanticItem, StreamPhysicsFrameProps } from "./StreamPhysicsTypes";
|
|
@@ -9,6 +10,14 @@ export declare const SR_ONLY_STYLE: React.CSSProperties;
|
|
|
9
10
|
declare function physicsHoverData(body: PhysicsBodyState): PhysicsHoverData;
|
|
10
11
|
declare function createBodySemanticItems(bodies: readonly PhysicsBodyState[], simulationState: PhysicsSimulationState, bodySemanticItems: StreamPhysicsFrameProps["bodySemanticItems"], limit: number): PhysicsSemanticItem[];
|
|
11
12
|
declare function semanticItemsChanged(previous: readonly PhysicsSemanticItem[], next: readonly PhysicsSemanticItem[]): boolean;
|
|
13
|
+
export declare function renderPhysicsTooltip({ enableHover, hoverData, tooltipContent, plotWidth, plotHeight, margin }: {
|
|
14
|
+
enableHover: boolean;
|
|
15
|
+
hoverData: PhysicsHoverData | null;
|
|
16
|
+
tooltipContent: StreamPhysicsFrameProps["tooltipContent"];
|
|
17
|
+
plotWidth: number;
|
|
18
|
+
plotHeight: number;
|
|
19
|
+
margin: FrameMargin;
|
|
20
|
+
}): React.ReactElement | null;
|
|
12
21
|
declare function DefaultPhysicsTooltip({ hover }: {
|
|
13
22
|
hover: PhysicsHoverData;
|
|
14
23
|
}): React.ReactElement;
|
|
@@ -61,6 +61,8 @@ export interface PipelineConfig {
|
|
|
61
61
|
yScaleType?: "linear" | "log" | "symlog";
|
|
62
62
|
xExtent?: [number | undefined, number | undefined] | [number];
|
|
63
63
|
yExtent?: [number | undefined, number | undefined] | [number];
|
|
64
|
+
/** Reverse the resolved y domain, including domains derived from pushed data. */
|
|
65
|
+
invertY?: boolean;
|
|
64
66
|
sizeRange?: [number, number];
|
|
65
67
|
binSize?: number;
|
|
66
68
|
normalize?: boolean;
|
|
@@ -87,6 +89,8 @@ export interface PipelineConfig {
|
|
|
87
89
|
color: string;
|
|
88
90
|
opacity?: number;
|
|
89
91
|
}>;
|
|
92
|
+
/** Retain source rows for aggregate hover emission even without selection styling. */
|
|
93
|
+
trackHoverRows?: boolean;
|
|
90
94
|
lineStyle?: Style | ((d: Datum, group?: string) => Style);
|
|
91
95
|
pointStyle?: (d: Datum) => Style & {
|
|
92
96
|
r?: number;
|
|
@@ -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;
|
|
@@ -28,6 +28,6 @@ export declare class PipelineStoreUpdateResults {
|
|
|
28
28
|
recordData(kind: DataChangeKind, count?: number): UpdateResult;
|
|
29
29
|
recordNoop(kind: DataChangeKind | "restyle"): UpdateResult;
|
|
30
30
|
recordRestyle(hasCustomRestyle: boolean): UpdateResult;
|
|
31
|
-
recordConfig(keys: readonly string[]): UpdateResult;
|
|
31
|
+
recordConfig(keys: readonly string[], rebuildGeometry?: boolean): UpdateResult;
|
|
32
32
|
}
|
|
33
33
|
export {};
|
|
@@ -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;
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
/** Resolve the same primary axes in live chrome, static SVG, and margin layout. */
|
|
2
|
+
export declare function resolveXYAxes<T extends {
|
|
3
|
+
orient?: string;
|
|
4
|
+
}>(axes?: readonly T[]): {
|
|
5
|
+
bottomAxis: T | undefined;
|
|
6
|
+
topAxis: T | undefined;
|
|
7
|
+
leftAxis: T | undefined;
|
|
8
|
+
rightAxis: T | undefined;
|
|
9
|
+
xAxis: T | undefined;
|
|
10
|
+
yAxis: T | undefined;
|
|
11
|
+
xOrient: "top" | "bottom";
|
|
12
|
+
yOrient: "left" | "right";
|
|
13
|
+
};
|
|
@@ -8,7 +8,7 @@ import * as React from "react";
|
|
|
8
8
|
import type { DefaultArcObject } from "d3-shape";
|
|
9
9
|
import { type HatchFill } from "../charts/shared/hatchFill";
|
|
10
10
|
import type { GlyphDef } from "./glyphDef";
|
|
11
|
-
import type { RectSceneNode, Style, SymbolSceneNode } from "./types";
|
|
11
|
+
import type { PointSceneNode, RectSceneNode, Style, SymbolSceneNode } from "./types";
|
|
12
12
|
import type { GradientStop } from "../charts/shared/gradient";
|
|
13
13
|
/**
|
|
14
14
|
* Sentinel arg for d3-shape arc generators that have all four
|
|
@@ -76,3 +76,4 @@ export declare function perCornerSvgPath(n: RectSceneNode): string;
|
|
|
76
76
|
* unfilled in SSR too).
|
|
77
77
|
*/
|
|
78
78
|
export declare function symbolSceneNodeToSVG(n: SymbolSceneNode, i: number, idPrefix?: string): React.ReactNode;
|
|
79
|
+
export declare function pointOrRectSceneNodeToSVG(n: PointSceneNode | RectSceneNode, i: number, idPrefix?: string): React.ReactNode;
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import type { Datum } from "../charts/shared/datumTypes";
|
|
2
|
+
import type { StreamScales } from "./types";
|
|
3
|
+
/**
|
|
4
|
+
* Project, filter, and sort vertices with their source rows as one operation.
|
|
5
|
+
* Lines, areas, and ribbons must share this invariant: datum[i] describes the
|
|
6
|
+
* same observation as path[i], including with descending scales.
|
|
7
|
+
*/
|
|
8
|
+
export declare function buildSeriesGeometry(data: Datum[], scales: StreamScales, xGet: (d: Datum) => number, yGet: (d: Datum) => number, bottomGet?: (d: Datum) => number): {
|
|
9
|
+
topPath: [number, number][];
|
|
10
|
+
bottomPath: [number, number][];
|
|
11
|
+
rawValues: number[];
|
|
12
|
+
datum: Datum[];
|
|
13
|
+
};
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
export interface DecayConfig {
|
|
2
|
+
type: "linear" | "exponential" | "step";
|
|
3
|
+
/** Exponential: half-life in buffer positions (default: bufferSize/2) */
|
|
4
|
+
halfLife?: number;
|
|
5
|
+
/** Minimum opacity floor (default: 0.1) */
|
|
6
|
+
minOpacity?: number;
|
|
7
|
+
/** Step: positions from newest before fading (default: bufferSize*0.5) */
|
|
8
|
+
stepThreshold?: number;
|
|
9
|
+
}
|
|
10
|
+
export interface PulseConfig {
|
|
11
|
+
/** Duration of the pulse glow in ms (default: 500) */
|
|
12
|
+
duration?: number;
|
|
13
|
+
/** Glow color (default: "rgba(255,255,255,0.6)") */
|
|
14
|
+
color?: string;
|
|
15
|
+
/** Extra px radius for glow ring on points (default: 4) */
|
|
16
|
+
glowRadius?: number;
|
|
17
|
+
}
|
|
18
|
+
export interface TransitionConfig {
|
|
19
|
+
/** Animation duration in ms (default: 300) */
|
|
20
|
+
duration?: number;
|
|
21
|
+
/** Easing function (default: "ease-out") */
|
|
22
|
+
easing?: "ease-out" | "linear";
|
|
23
|
+
}
|
|
24
|
+
export interface StalenessConfig {
|
|
25
|
+
/**
|
|
26
|
+
* ms without data before "stale" (default: 5000). In graded mode this
|
|
27
|
+
* is the base TTL the lifecycle bands are measured against — `aging`
|
|
28
|
+
* begins here, `stale` at 1.5×, `expired` at 3× (overridable).
|
|
29
|
+
*/
|
|
30
|
+
threshold?: number;
|
|
31
|
+
/** Canvas alpha when stale, binary mode (default: 0.5) */
|
|
32
|
+
dimOpacity?: number;
|
|
33
|
+
/** Render LIVE/STALE badge (default: false) */
|
|
34
|
+
showBadge?: boolean;
|
|
35
|
+
/** Badge position (default: "top-right") */
|
|
36
|
+
badgePosition?: "top-left" | "top-right" | "bottom-left" | "bottom-right";
|
|
37
|
+
/**
|
|
38
|
+
* Opt into graded (banded) staleness. Instead of a single live→stale
|
|
39
|
+
* flip at `threshold`, frames that support graded staleness dim
|
|
40
|
+
* progressively through fresh → aging → stale → expired as idle time
|
|
41
|
+
* crosses multiples of `threshold`, sharing one schedule with per-datum
|
|
42
|
+
* decay and annotation freshness. (Currently honored by `StreamXYFrame`,
|
|
43
|
+
* which backs the realtime XY charts; other frames treat it as binary.)
|
|
44
|
+
* `true` uses the default per-band opacities; pass an object to override
|
|
45
|
+
* the band thresholds or opacities.
|
|
46
|
+
*/
|
|
47
|
+
graded?: boolean | {
|
|
48
|
+
/** Multiples of `threshold` marking each band edge (see LifecycleBandThresholds). */
|
|
49
|
+
thresholds?: import("../realtime/lifecycleBands").LifecycleBandThresholds;
|
|
50
|
+
/** Per-band canvas alpha override. Missing bands use the defaults. */
|
|
51
|
+
opacities?: Partial<Record<import("../realtime/lifecycleBands").LifecycleBand, number>>;
|
|
52
|
+
};
|
|
53
|
+
}
|
|
@@ -17,61 +17,10 @@ import type { AccessibleTableProp } from "./accessibleTableTypes";
|
|
|
17
17
|
export type { SceneRenderBackend, SceneRenderMode } from "./sceneRenderBackendTypes";
|
|
18
18
|
export type { ThemeSemanticColors } from "./streamThemeTypes";
|
|
19
19
|
export type { AxisTickFormat, AxisTickFormatter, XYFrameAxisConfig } from "./xyFrameAxisTypes";
|
|
20
|
+
import type { DecayConfig, PulseConfig, StalenessConfig, TransitionConfig } from "./streamEncodingTypes";
|
|
21
|
+
export type { DecayConfig, PulseConfig, StalenessConfig, TransitionConfig } from "./streamEncodingTypes";
|
|
20
22
|
export type SceneDatum = Datum | null;
|
|
21
23
|
export type SeriesDatum = Datum[] | null;
|
|
22
|
-
export interface DecayConfig {
|
|
23
|
-
type: "linear" | "exponential" | "step";
|
|
24
|
-
/** Exponential: half-life in buffer positions (default: bufferSize/2) */
|
|
25
|
-
halfLife?: number;
|
|
26
|
-
/** Minimum opacity floor (default: 0.1) */
|
|
27
|
-
minOpacity?: number;
|
|
28
|
-
/** Step: positions from newest before fading (default: bufferSize*0.5) */
|
|
29
|
-
stepThreshold?: number;
|
|
30
|
-
}
|
|
31
|
-
export interface PulseConfig {
|
|
32
|
-
/** Duration of the pulse glow in ms (default: 500) */
|
|
33
|
-
duration?: number;
|
|
34
|
-
/** Glow color (default: "rgba(255,255,255,0.6)") */
|
|
35
|
-
color?: string;
|
|
36
|
-
/** Extra px radius for glow ring on points (default: 4) */
|
|
37
|
-
glowRadius?: number;
|
|
38
|
-
}
|
|
39
|
-
export interface TransitionConfig {
|
|
40
|
-
/** Animation duration in ms (default: 300) */
|
|
41
|
-
duration?: number;
|
|
42
|
-
/** Easing function (default: "ease-out") */
|
|
43
|
-
easing?: "ease-out" | "linear";
|
|
44
|
-
}
|
|
45
|
-
export interface StalenessConfig {
|
|
46
|
-
/**
|
|
47
|
-
* ms without data before "stale" (default: 5000). In graded mode this
|
|
48
|
-
* is the base TTL the lifecycle bands are measured against — `aging`
|
|
49
|
-
* begins here, `stale` at 1.5×, `expired` at 3× (overridable).
|
|
50
|
-
*/
|
|
51
|
-
threshold?: number;
|
|
52
|
-
/** Canvas alpha when stale, binary mode (default: 0.5) */
|
|
53
|
-
dimOpacity?: number;
|
|
54
|
-
/** Render LIVE/STALE badge (default: false) */
|
|
55
|
-
showBadge?: boolean;
|
|
56
|
-
/** Badge position (default: "top-right") */
|
|
57
|
-
badgePosition?: "top-left" | "top-right" | "bottom-left" | "bottom-right";
|
|
58
|
-
/**
|
|
59
|
-
* Opt into graded (banded) staleness. Instead of a single live→stale
|
|
60
|
-
* flip at `threshold`, frames that support graded staleness dim
|
|
61
|
-
* progressively through fresh → aging → stale → expired as idle time
|
|
62
|
-
* crosses multiples of `threshold`, sharing one schedule with per-datum
|
|
63
|
-
* decay and annotation freshness. (Currently honored by `StreamXYFrame`,
|
|
64
|
-
* which backs the realtime XY charts; other frames treat it as binary.)
|
|
65
|
-
* `true` uses the default per-band opacities; pass an object to override
|
|
66
|
-
* the band thresholds or opacities.
|
|
67
|
-
*/
|
|
68
|
-
graded?: boolean | {
|
|
69
|
-
/** Multiples of `threshold` marking each band edge (see LifecycleBandThresholds). */
|
|
70
|
-
thresholds?: import("../realtime/lifecycleBands").LifecycleBandThresholds;
|
|
71
|
-
/** Per-band canvas alpha override. Missing bands use the defaults. */
|
|
72
|
-
opacities?: Partial<Record<import("../realtime/lifecycleBands").LifecycleBand, number>>;
|
|
73
|
-
};
|
|
74
|
-
}
|
|
75
24
|
export type MarginalType = "histogram" | "violin" | "ridgeline" | "boxplot";
|
|
76
25
|
export interface MarginalConfig {
|
|
77
26
|
type: MarginalType;
|
|
@@ -586,6 +535,12 @@ export interface BandConfig<T = Datum> {
|
|
|
586
535
|
interactive?: boolean;
|
|
587
536
|
}
|
|
588
537
|
export interface StreamXYFrameProps<T = Datum> extends StreamSemanticInteractionProps<HoverData> {
|
|
538
|
+
/**
|
|
539
|
+
* Built-in mark set. HOCs register the plugin they need. Direct
|
|
540
|
+
* StreamXYFrame loads other built-ins on first client paint. Call
|
|
541
|
+
* `registerBuiltInXYPlugins()` from `semiotic/xy` or
|
|
542
|
+
* `semiotic/realtime/core` for SSR / first-frame marks.
|
|
543
|
+
*/
|
|
589
544
|
chartType: StreamChartType;
|
|
590
545
|
runtimeMode?: RuntimeMode;
|
|
591
546
|
data?: T[];
|
|
@@ -694,6 +649,8 @@ export interface StreamXYFrameProps<T = Datum> extends StreamSemanticInteraction
|
|
|
694
649
|
yScaleType?: "linear" | "log" | "symlog";
|
|
695
650
|
xExtent?: [number | undefined, number | undefined] | [number];
|
|
696
651
|
yExtent?: [number | undefined, number | undefined] | [number];
|
|
652
|
+
/** Reverse the resolved y domain, including domains derived from pushed data. */
|
|
653
|
+
invertY?: boolean;
|
|
697
654
|
extentPadding?: number;
|
|
698
655
|
/** Pixel inset on scale ranges to prevent glyph clipping at chart edges. Default 0. */
|
|
699
656
|
scalePadding?: number;
|
|
@@ -713,7 +670,8 @@ export interface StreamXYFrameProps<T = Datum> extends StreamSemanticInteraction
|
|
|
713
670
|
background?: string;
|
|
714
671
|
/**
|
|
715
672
|
* Maximum canvas backing-store pixel ratio. Defaults to 3 on desktop and 2
|
|
716
|
-
* on coarse-pointer/small-screen devices
|
|
673
|
+
* on coarse-pointer/small-screen devices; very large canvases are further
|
|
674
|
+
* capped by a shared backing-store budget. Increase this when mark crispness
|
|
717
675
|
* at high browser zoom is more important than canvas memory/paint cost.
|
|
718
676
|
*/
|
|
719
677
|
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,16 @@
|
|
|
1
|
+
import { type MutableRefObject, type Ref } from "react";
|
|
2
|
+
import { type ZoomBehavior, type ZoomTransform } from "d3-zoom";
|
|
3
|
+
import type { GeoPipelineStore } from "./GeoPipelineStore";
|
|
4
|
+
import type { StreamGeoFrameHandle } from "./geoTypes";
|
|
5
|
+
import type { GeoZoomControlBehavior } from "./geoFrameHelpers";
|
|
6
|
+
interface GeoFrameHandleOptions {
|
|
7
|
+
storeRef: MutableRefObject<GeoPipelineStore | null>;
|
|
8
|
+
dirtyRef: MutableRefObject<boolean>;
|
|
9
|
+
scheduleRender: () => void;
|
|
10
|
+
zoomTransformRef: MutableRefObject<ZoomTransform>;
|
|
11
|
+
containerRef: MutableRefObject<HTMLDivElement | null>;
|
|
12
|
+
zoomBehaviorRef: MutableRefObject<ZoomBehavior<HTMLDivElement, unknown> | GeoZoomControlBehavior | null>;
|
|
13
|
+
}
|
|
14
|
+
/** Imperative data and zoom controls, independent of canvas rendering. */
|
|
15
|
+
export declare function useGeoFrameHandle(ref: Ref<StreamGeoFrameHandle>, { storeRef, dirtyRef, scheduleRender, zoomTransformRef, containerRef, zoomBehaviorRef }: GeoFrameHandleOptions): void;
|
|
16
|
+
export {};
|
|
@@ -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 {};
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import { type MutableRefObject, type Ref } from "react";
|
|
2
|
+
import type { DataSourceAdapter } from "./DataSourceAdapter";
|
|
3
|
+
import type { OrdinalPipelineStore } from "./OrdinalPipelineStore";
|
|
4
|
+
import type { HoverData, StreamOrdinalFrameHandle } from "./ordinalTypes";
|
|
5
|
+
interface OrdinalFrameHandleOptions {
|
|
6
|
+
storeRef: MutableRefObject<OrdinalPipelineStore | null>;
|
|
7
|
+
adapterRef: MutableRefObject<DataSourceAdapter | null>;
|
|
8
|
+
dirtyRef: MutableRefObject<boolean>;
|
|
9
|
+
scheduleRender: () => void;
|
|
10
|
+
hoverRef: MutableRefObject<HoverData | null>;
|
|
11
|
+
setHoverPoint: (hover: HoverData | null) => void;
|
|
12
|
+
}
|
|
13
|
+
/** Keep imperative data mutations separate from the frame's render lifecycle. */
|
|
14
|
+
export declare function useOrdinalFrameHandle(ref: Ref<StreamOrdinalFrameHandle>, { storeRef, adapterRef, dirtyRef, scheduleRender, hoverRef, setHoverPoint }: OrdinalFrameHandleOptions): void;
|
|
15
|
+
export {};
|