semiotic 3.9.2 → 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 +99 -74
- package/agent-skill/semiotic-charts/SKILL.md +13 -7
- 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/dist/mcp-server.js +68 -68
- package/ai/examples.md +1 -1
- package/ai/reference.md +31 -14
- package/ai/schema.json +1868 -438
- package/ai/surface-manifest.json +11 -4
- package/ai/system-prompt.md +2 -0
- 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-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-CKLIFCGN.min.js → c-XSB27XPS.min.js} +1 -1
- 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 +2 -1
- package/dist/components/ai/chartRecipeRegistry.d.ts +6 -1
- package/dist/components/ai/chartRecipes.d.ts +4 -0
- package/dist/components/ai/describePhysicsProjection.d.ts +18 -0
- package/dist/components/ai/describePhysicsSource.d.ts +13 -0
- 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/ordinal/DonutChart.d.ts +2 -0
- package/dist/components/charts/ordinal/FunnelChart.d.ts +2 -0
- package/dist/components/charts/ordinal/GroupedBarChart.d.ts +6 -0
- package/dist/components/charts/ordinal/PieChart.d.ts +2 -0
- package/dist/components/charts/ordinal/RadarChart.d.ts +2 -0
- package/dist/components/charts/ordinal/StackedBarChart.d.ts +6 -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/ProcessFlowChart.d.ts +6 -0
- package/dist/components/charts/physics/UnitPileChart.d.ts +2 -1
- 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/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/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 +4 -0
- package/dist/components/charts/realtime/RealtimeHistogram.d.ts +14 -6
- package/dist/components/charts/realtime/RealtimeLineChart.d.ts +4 -0
- package/dist/components/charts/realtime/RealtimeSwarmChart.d.ts +4 -0
- package/dist/components/charts/realtime/RealtimeWaterfallChart.d.ts +4 -0
- package/dist/components/charts/realtime/realtimeAccessors.d.ts +4 -0
- package/dist/components/charts/realtime/realtimeChartRuntime.d.ts +8 -7
- package/dist/components/charts/realtime/realtimeChartTypes.d.ts +7 -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/auditAccessibilityText.d.ts +4 -2
- 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/tooltipUtils.d.ts +1 -1
- package/dist/components/charts/shared/useChartLegend.d.ts +4 -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/MinimapChart.d.ts +7 -0
- package/dist/components/charts/xy/MultiAxisLineChart.d.ts +7 -0
- package/dist/components/charts/xy/ScatterplotMatrix.d.ts +6 -0
- package/dist/components/charts/xy/WaterfallChart.d.ts +8 -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 +16 -8
- 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 +3 -1
- 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/recipes/firstAvailableTrack.d.ts +17 -0
- package/dist/components/recipes/intervals.d.ts +1 -1
- package/dist/components/semiotic-ai-core.d.ts +33 -22
- package/dist/components/semiotic-ai.d.ts +15 -3
- package/dist/components/semiotic-artifact-react.d.ts +10 -0
- package/dist/components/semiotic-artifact.d.ts +23 -0
- package/dist/components/semiotic-experimental.d.ts +1 -1
- package/dist/components/semiotic-physics.d.ts +4 -4
- package/dist/components/semiotic-text.d.ts +2 -0
- package/dist/components/semiotic-utils-core.d.ts +18 -18
- package/dist/components/semiotic.d.ts +3 -3
- package/dist/components/server/renderEvidence.d.ts +12 -0
- package/dist/components/server/renderToStaticSVG.d.ts +3 -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 +6 -0
- package/dist/components/stream/GeoSVGOverlay.d.ts +4 -0
- package/dist/components/stream/NetworkSVGOverlay.d.ts +4 -0
- package/dist/components/stream/OrdinalSVGOverlay.d.ts +4 -0
- 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/hitTestUtils.d.ts +2 -0
- 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 +3 -0
- 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/pipelineStoreUpdateResults.d.ts +1 -1
- 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 +4 -53
- package/dist/components/stream/useGeoFrameHandle.d.ts +16 -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/xyDateTicks.d.ts +3 -2
- package/dist/components/stream/xyFrameAxisTypes.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/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.module.min.js +1 -1
- package/dist/semiotic-ai-artifact-policy-constants.module.min.js +2 -0
- package/dist/semiotic-ai-core.d.ts +33 -22
- 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 +15 -3
- 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.min.js +1 -1
- package/dist/semiotic-evidence.module.min.js +1 -1
- 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.module.min.js +1 -1
- package/dist/semiotic-physics.d.ts +4 -4
- 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.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.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 +18 -18
- 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.d.ts +3 -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 +55 -14
- 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-3SCUN5HI.min.js +0 -1
- package/dist/c-3VVKFA4M.min.js +0 -1
- package/dist/c-43TJZS3F.min.js +0 -1
- package/dist/c-4DTZPSUD.min.js +0 -1
- package/dist/c-4ES5367Y.min.js +0 -1
- package/dist/c-52TEGIUJ.min.js +0 -1
- package/dist/c-54IRWOGM.min.js +0 -1
- package/dist/c-5D2S4RMI.min.js +0 -1
- package/dist/c-5JWCTX3G.min.js +0 -1
- package/dist/c-6CMMSN6N.min.js +0 -1
- package/dist/c-6HRB2L7H.min.js +0 -1
- package/dist/c-6O5EVOPH.min.js +0 -1
- package/dist/c-7W4SV36A.min.js +0 -1
- package/dist/c-A4WRGZFX.min.js +0 -1
- package/dist/c-AG7WWVIH.min.js +0 -1
- package/dist/c-AH6J4MTN.min.js +0 -1
- package/dist/c-AKAF6JAD.min.js +0 -1
- package/dist/c-ALYR5LKK.min.js +0 -1
- package/dist/c-BBKITSXB.min.js +0 -1
- package/dist/c-BYDPC44I.min.js +0 -1
- package/dist/c-CFFIU2MW.min.js +0 -1
- package/dist/c-CGNHBHCE.min.js +0 -1
- package/dist/c-CJYSXIFV.min.js +0 -1
- package/dist/c-CZF7MV67.min.js +0 -1
- package/dist/c-D53OKBSY.min.js +0 -1
- package/dist/c-DADXPJXV.min.js +0 -1
- package/dist/c-DBQ2V7CH.min.js +0 -1
- package/dist/c-DPMVAUAW.min.js +0 -1
- package/dist/c-ECJCKLYY.min.js +0 -1
- package/dist/c-EGATGOWJ.min.js +0 -1
- package/dist/c-EGR6VYBW.min.js +0 -1
- package/dist/c-ESNR43AN.min.js +0 -1
- package/dist/c-F3LIKINL.min.js +0 -1
- package/dist/c-F5ZB5GJ6.min.js +0 -1
- package/dist/c-G36WS6LN.min.js +0 -1
- package/dist/c-G3VYMHKE.min.js +0 -1
- package/dist/c-GGISSW5E.min.js +0 -1
- package/dist/c-GR6MOEQC.min.js +0 -1
- package/dist/c-GSVCN34B.min.js +0 -1
- package/dist/c-GYOQCEFP.min.js +0 -1
- package/dist/c-H3DNMTCC.min.js +0 -1
- package/dist/c-I6J3FEZE.min.js +0 -1
- package/dist/c-IGH6MGJ5.min.js +0 -1
- package/dist/c-II2EEAJN.min.js +0 -1
- package/dist/c-IUHFPMHD.min.js +0 -1
- package/dist/c-J6M4JHRS.min.js +0 -1
- package/dist/c-JM3MGLQV.min.js +0 -1
- package/dist/c-KM3N7F7R.min.js +0 -1
- package/dist/c-LF5BZFNC.min.js +0 -1
- package/dist/c-LKBSGFQC.min.js +0 -1
- package/dist/c-MNF2S4AA.min.js +0 -1
- package/dist/c-MT3WBK7M.min.js +0 -1
- package/dist/c-NDJADPIF.min.js +0 -1
- package/dist/c-NVPQCIL5.min.js +0 -1
- package/dist/c-NY3JWV2K.min.js +0 -1
- package/dist/c-OFWJBEE5.min.js +0 -1
- package/dist/c-OYFHP5F5.min.js +0 -1
- package/dist/c-PGKQGGQ2.min.js +0 -1
- package/dist/c-PPWDL5ZI.min.js +0 -1
- package/dist/c-Q2IPZ3MU.min.js +0 -1
- package/dist/c-QKHMBE2E.min.js +0 -1
- package/dist/c-QMVM3AY6.min.js +0 -1
- package/dist/c-QSGWX53A.min.js +0 -1
- package/dist/c-RJKEKZOO.min.js +0 -1
- package/dist/c-RSVIHIQ4.min.js +0 -1
- package/dist/c-S6U5CGT5.min.js +0 -1
- package/dist/c-SFDIIU5G.min.js +0 -1
- package/dist/c-SLGMUBUL.min.js +0 -1
- package/dist/c-SRTBCRVE.min.js +0 -1
- package/dist/c-T6UAIKBH.min.js +0 -1
- package/dist/c-TMCTEVVW.min.js +0 -1
- package/dist/c-TMOSJLT3.min.js +0 -1
- package/dist/c-TZW3JGJ5.min.js +0 -1
- package/dist/c-U6ESPM7V.min.js +0 -1
- package/dist/c-UC5PTTFI.min.js +0 -1
- package/dist/c-USFMFKIH.min.js +0 -1
- package/dist/c-VGKUEZBC.min.js +0 -1
- package/dist/c-VGW3VG3I.min.js +0 -1
- package/dist/c-VN2HG5BS.min.js +0 -1
- package/dist/c-VPZDY5Q4.min.js +0 -1
- package/dist/c-VRXUB2F2.min.js +0 -1
- package/dist/c-VUBQNQJH.min.js +0 -1
- package/dist/c-VUH4PGZY.min.js +0 -1
- package/dist/c-W3CE4A4S.min.js +0 -1
- package/dist/c-X5UBGU2V.min.js +0 -1
- package/dist/c-XDRV7RKW.min.js +0 -1
- package/dist/c-YGZHURXZ.min.js +0 -1
- package/dist/c-YZVRZGX2.min.js +0 -1
- /package/dist/{c-N4G2L7ID.min.js → c-HYW2XA4Q.min.js} +0 -0
- /package/dist/{c-ENF72HU5.min.js → c-QAVFOEUY.min.js} +0 -0
- /package/dist/{c-OCI56QF2.min.js → c-V4XMSLC3.min.js} +0 -0
|
@@ -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;
|
|
@@ -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 {};
|
|
@@ -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;
|
|
@@ -700,6 +649,8 @@ export interface StreamXYFrameProps<T = Datum> extends StreamSemanticInteraction
|
|
|
700
649
|
yScaleType?: "linear" | "log" | "symlog";
|
|
701
650
|
xExtent?: [number | undefined, number | undefined] | [number];
|
|
702
651
|
yExtent?: [number | undefined, number | undefined] | [number];
|
|
652
|
+
/** Reverse the resolved y domain, including domains derived from pushed data. */
|
|
653
|
+
invertY?: boolean;
|
|
703
654
|
extentPadding?: number;
|
|
704
655
|
/** Pixel inset on scale ranges to prevent glyph clipping at chart edges. Default 0. */
|
|
705
656
|
scalePadding?: number;
|
|
@@ -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,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 {};
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import { type MutableRefObject, type Ref } from "react";
|
|
2
|
+
import type { DataSourceAdapter } from "./DataSourceAdapter";
|
|
3
|
+
import type { PipelineStore } from "./PipelineStore";
|
|
4
|
+
import type { HoverData, StreamXYFrameHandle } from "./types";
|
|
5
|
+
interface XYFrameHandleOptions {
|
|
6
|
+
storeRef: MutableRefObject<PipelineStore | 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 useXYFrameHandle(ref: Ref<StreamXYFrameHandle>, { storeRef, adapterRef, dirtyRef, scheduleRender, hoverRef, setHoverPoint }: XYFrameHandleOptions): void;
|
|
15
|
+
export {};
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
import type { ReactNode } from "react";
|
|
2
|
+
import { type AxisExtentMode } from "../charts/shared/axisExtent";
|
|
3
|
+
import type { AxisTickFormatter, XYFrameAxisConfig } from "./xyFrameAxisTypes";
|
|
4
|
+
export interface AxisTick {
|
|
5
|
+
value: number | Date;
|
|
6
|
+
pixel: number;
|
|
7
|
+
label: ReactNode;
|
|
8
|
+
}
|
|
9
|
+
type AxisScale = {
|
|
10
|
+
(value: number | Date): number;
|
|
11
|
+
domain(): (number | Date)[];
|
|
12
|
+
ticks(count?: number): (number | Date)[];
|
|
13
|
+
};
|
|
14
|
+
/** Use actual neighboring gaps: log scales and explicit ticks need not fill the axis. */
|
|
15
|
+
export declare function axisTicksNeedRotation(ticks: AxisTick[]): boolean;
|
|
16
|
+
/** Shared tick selection for live axes, canvas underlays, and static exports. */
|
|
17
|
+
export declare function generateXYTicks(options: {
|
|
18
|
+
scale: AxisScale;
|
|
19
|
+
axis?: XYFrameAxisConfig;
|
|
20
|
+
size: number;
|
|
21
|
+
horizontal?: boolean;
|
|
22
|
+
format?: AxisTickFormatter;
|
|
23
|
+
axisExtent?: AxisExtentMode;
|
|
24
|
+
}): AxisTick[];
|
|
25
|
+
export {};
|
|
@@ -2,8 +2,9 @@
|
|
|
2
2
|
* Auto date tick formatting for StreamXYFrame time scales.
|
|
3
3
|
* UTC getters keep SSR and client labels identical across timezones.
|
|
4
4
|
*/
|
|
5
|
+
export declare function formatDateMonthDay(value: number | Date | string): string;
|
|
5
6
|
/**
|
|
6
7
|
* Build a tick formatter for a numeric time domain (ms since epoch).
|
|
7
|
-
* Span-based resolution: hours → day-month → month-year → year.
|
|
8
|
+
* Span-based resolution: milliseconds → seconds → hours → day-month → month-year → year.
|
|
8
9
|
*/
|
|
9
|
-
export declare function makeDateTickFormatter(domain: [number, number]): (v: number) => string;
|
|
10
|
+
export declare function makeDateTickFormatter(domain: [number, number]): (v: number | Date | string) => string;
|
|
@@ -23,6 +23,8 @@ export interface AxisLineStyle {
|
|
|
23
23
|
*/
|
|
24
24
|
export interface XYFrameAxisConfig {
|
|
25
25
|
orient: "left" | "right" | "top" | "bottom";
|
|
26
|
+
/** Hide this axis, including baseline, ticks, and label. Grid is independent. */
|
|
27
|
+
visible?: boolean;
|
|
26
28
|
label?: string;
|
|
27
29
|
ticks?: number;
|
|
28
30
|
/** Compatibility alias for `ticks`; `ticks` wins when both are supplied. */
|
|
@@ -64,7 +64,7 @@ export interface ResolvedRibbon {
|
|
|
64
64
|
*
|
|
65
65
|
* Iterates the data once, evaluates `getTop`/`getBottom` per datum, and
|
|
66
66
|
* collects coordinate pairs. Any datum with non-finite x, top, or bottom
|
|
67
|
-
* is
|
|
67
|
+
* is omitted. Remaining vertices stay connected; this is not a gap break.
|
|
68
68
|
* Returns `null` when fewer than two valid points remain (a single
|
|
69
69
|
* point can't form a visible ribbon).
|
|
70
70
|
*/
|
|
@@ -84,6 +84,7 @@ export interface XYSceneConfig {
|
|
|
84
84
|
showValues?: boolean;
|
|
85
85
|
heatmapValueFormat?: (v: number) => string;
|
|
86
86
|
heatmapColorScale?: (value: number) => string;
|
|
87
|
+
trackHoverRows?: boolean;
|
|
87
88
|
binSize?: number;
|
|
88
89
|
barColors?: Record<string, string>;
|
|
89
90
|
/** Bar fill/stroke/strokeWidth/gap. Threaded through from RealtimeHistogram. */
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
/** Internal bridge: the optional text entry supplies this callback to notes. */
|
|
2
|
+
export interface AnnotationNoteText {
|
|
3
|
+
label?: string;
|
|
4
|
+
title?: string;
|
|
5
|
+
wrap?: number;
|
|
6
|
+
noWrap?: boolean;
|
|
7
|
+
_noteLayout?: (note: AnnotationNoteText) => AnnotationNoteLayout | undefined;
|
|
8
|
+
}
|
|
9
|
+
export interface AnnotationNoteLayout {
|
|
10
|
+
labelLines: string[];
|
|
11
|
+
titleLines: string[];
|
|
12
|
+
width: number;
|
|
13
|
+
height: number;
|
|
14
|
+
textProps: {
|
|
15
|
+
"data-text-layout": string;
|
|
16
|
+
fontFamily: string;
|
|
17
|
+
fontSize: number;
|
|
18
|
+
fontWeight: string | number;
|
|
19
|
+
fontStyle: "normal";
|
|
20
|
+
};
|
|
21
|
+
lineHeight: number;
|
|
22
|
+
titleFontWeight: string | number;
|
|
23
|
+
}
|
|
24
|
+
/** Project frame annotations into the common live/static note renderer. */
|
|
25
|
+
export declare function annotationNote(note: AnnotationNoteText): AnnotationNoteText;
|
|
26
|
+
export declare function measureAnnotationNote(note: AnnotationNoteText): AnnotationNoteLayout | undefined;
|
|
27
|
+
/** Shared fallback for rendering and placement, retaining their existing estimates. */
|
|
28
|
+
export declare function wrapAnnotationText(text: string | undefined, wrap: number, charWidth: number): string[];
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
import type { AnnotationNoteText } from "./annotationTextLayout";
|
|
2
|
+
/** Typography for opt-in, browser-measured SVG annotation notes. */
|
|
3
|
+
export interface PretextAnnotationOptions {
|
|
4
|
+
/** Turn measurement off while preserving the annotations. Default true. */
|
|
5
|
+
enabled?: boolean;
|
|
6
|
+
/** Use a named font for consistent canvas/SVG metrics. Default "Arial, sans-serif". */
|
|
7
|
+
fontFamily?: string;
|
|
8
|
+
/** Note text size in CSS pixels. Default 12. */
|
|
9
|
+
fontSize?: number;
|
|
10
|
+
/** Baseline spacing in CSS pixels. Default max(16, fontSize * 1.35). */
|
|
11
|
+
lineHeight?: number;
|
|
12
|
+
/** Body weight. Default 400. */
|
|
13
|
+
fontWeight?: string | number;
|
|
14
|
+
/** Title weight, measured separately from the body. Default 700. */
|
|
15
|
+
titleFontWeight?: string | number;
|
|
16
|
+
}
|
|
17
|
+
export declare function resolvePretextOptions(options: PretextAnnotationOptions): {
|
|
18
|
+
fontFamily: string;
|
|
19
|
+
fontSize: number;
|
|
20
|
+
lineHeight: number;
|
|
21
|
+
fontWeight: string | number;
|
|
22
|
+
titleFontWeight: string | number;
|
|
23
|
+
};
|
|
24
|
+
type Typography = ReturnType<typeof resolvePretextOptions>;
|
|
25
|
+
export declare function pretextFonts(options: Typography): [string, string];
|
|
26
|
+
/** Reacquire fonts after loading, including WebKit's retained canvas font state. */
|
|
27
|
+
export declare function resetPretextFonts(): void;
|
|
28
|
+
export declare function createPretextNoteMeasurer(options: Typography): NonNullable<AnnotationNoteText["_noteLayout"]> | undefined;
|
|
29
|
+
export {};
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import type { Datum } from "../charts/shared/datumTypes";
|
|
2
|
+
import { type PretextAnnotationOptions } from "./pretextAnnotationLayout";
|
|
3
|
+
/**
|
|
4
|
+
* Opt in to Pretext wrapping for label, callout, and bracket annotation notes.
|
|
5
|
+
* Pass the returned array to a chart's `annotations`. Rendering and automatic
|
|
6
|
+
* placement use the same measured lines. Other annotation types pass through.
|
|
7
|
+
*
|
|
8
|
+
* Measurement starts after mounting and font loading. SSR, hydration, disabled
|
|
9
|
+
* measurement, and browsers without Intl.Segmenter retain the normal renderer.
|
|
10
|
+
* This React hook is not a formatter or option for serialized chart configs.
|
|
11
|
+
*/
|
|
12
|
+
export declare function usePretextAnnotations<T extends Datum>(annotations: readonly T[], options?: PretextAnnotationOptions): T[];
|