semiotic 3.9.2 → 3.10.1
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 +97 -76
- 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/componentMetadata.cjs +3 -1
- package/ai/dist/mcp-server.js +68 -68
- package/ai/examples.md +68 -1
- package/ai/reference.md +105 -14
- package/ai/schema.json +6646 -18
- package/ai/surface-manifest.json +34 -6
- 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-2RL2QPZJ.min.js +1 -0
- package/dist/c-2WK7YJLL.min.js +1 -0
- package/dist/c-42PLDTX7.min.js +1 -0
- package/dist/c-45CQWZZ6.min.js +1 -0
- package/dist/c-4BRHKVKV.min.js +1 -0
- package/dist/c-7242NXSG.min.js +1 -0
- package/dist/c-7DVPSB5C.min.js +1 -0
- package/dist/c-7EGHJU2F.min.js +1 -0
- package/dist/c-A7OGOFSL.min.js +1 -0
- package/dist/c-AFBSWT77.min.js +1 -0
- package/dist/c-AH5HWZWS.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-B7GW7IHJ.min.js +1 -0
- package/dist/c-BNFJMDHN.min.js +1 -0
- package/dist/c-BOHCQILI.min.js +1 -0
- package/dist/c-C3TZLTZK.min.js +1 -0
- package/dist/c-CGQAQWBV.min.js +1 -0
- package/dist/c-CPV4N35K.min.js +1 -0
- package/dist/c-D6HAAPTX.min.js +1 -0
- package/dist/c-DIPEYUOW.min.js +1 -0
- package/dist/c-E4JDJH4I.min.js +1 -0
- package/dist/c-E72OTUZU.min.js +1 -0
- package/dist/c-E7I2L7CU.min.js +1 -0
- package/dist/c-ELDWAO2V.min.js +1 -0
- package/dist/c-EUBTECGM.min.js +1 -0
- package/dist/c-EUMPMDCS.min.js +1 -0
- package/dist/c-EZZT2WAE.min.js +1 -0
- package/dist/c-FHBVFCQB.min.js +1 -0
- package/dist/c-G4HCO2IQ.min.js +1 -0
- package/dist/c-G5VIJEOK.min.js +1 -0
- package/dist/c-GHVOXAYH.min.js +1 -0
- package/dist/c-GNTXRXRN.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-HP4ZFM47.min.js +1 -0
- package/dist/c-HPOYKCCG.min.js +1 -0
- package/dist/c-HYDTS5OP.min.js +1 -0
- package/dist/c-I4QJ6YLM.min.js +1 -0
- package/dist/c-IK33LNZ6.min.js +1 -0
- package/dist/c-IK3PZHRY.min.js +1 -0
- package/dist/c-J6DVC236.min.js +1 -0
- package/dist/c-JIMJF6F6.min.js +1 -0
- package/dist/c-JUKIWTBJ.min.js +1 -0
- package/dist/c-KKPMHAZC.min.js +1 -0
- package/dist/c-L6WNDBHV.min.js +1 -0
- package/dist/c-LDEX5OFW.min.js +1 -0
- package/dist/c-LESEUVC5.min.js +1 -0
- package/dist/c-LYQMZMZQ.min.js +1 -0
- package/dist/c-MB6CV5NC.min.js +1 -0
- package/dist/c-MOKJOIPE.min.js +1 -0
- package/dist/c-MVR3RWF3.min.js +1 -0
- package/dist/c-N3FXLRNT.min.js +1 -0
- package/dist/c-N5NPTJVJ.min.js +1 -0
- package/dist/c-NHBL4J67.min.js +1 -0
- package/dist/c-ODG6TFSY.min.js +1 -0
- package/dist/c-ORLEBW72.min.js +1 -0
- package/dist/c-P65V6HLO.min.js +1 -0
- package/dist/c-PRIKOLTE.min.js +1 -0
- package/dist/c-PSKKFZNP.min.js +1 -0
- package/dist/c-PSNI6KAZ.min.js +1 -0
- package/dist/c-QA3HMQJP.min.js +1 -0
- package/dist/c-R2P4RR7Q.min.js +1 -0
- package/dist/c-RFC7UAG7.min.js +1 -0
- package/dist/c-S3AZX5PP.min.js +1 -0
- package/dist/c-SGAURYHG.min.js +1 -0
- package/dist/c-SJMWU6UX.min.js +1 -0
- package/dist/c-STIIGQOD.min.js +1 -0
- package/dist/c-T2ASIJVZ.min.js +1 -0
- package/dist/c-T2V7O2LO.min.js +1 -0
- package/dist/c-TKG2NP7G.min.js +1 -0
- package/dist/c-TX3THUTO.min.js +1 -0
- package/dist/c-TX7XJM3Z.min.js +1 -0
- package/dist/c-UC7SIU2W.min.js +1 -0
- package/dist/c-UMXSJIOV.min.js +1 -0
- package/dist/c-VJTDST2R.min.js +1 -0
- package/dist/c-VRSXMLYF.min.js +1 -0
- package/dist/c-VSLWSAN2.min.js +1 -0
- package/dist/c-VXLOLYTO.min.js +1 -0
- package/dist/c-W4ZUKSEQ.min.js +1 -0
- package/dist/c-WCBRPILW.min.js +1 -0
- package/dist/c-WGHT7OCY.min.js +1 -0
- package/dist/c-WUWXGQYA.min.js +1 -0
- package/dist/c-WWCW3APR.min.js +1 -0
- package/dist/{c-CKLIFCGN.min.js → c-XSB27XPS.min.js} +1 -1
- package/dist/c-Y6PYUMFU.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-ZIVPFTOC.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/chartDataProps.d.ts +3 -0
- package/dist/components/charts/shared/chartSpecAtlasSchemas.d.ts +5 -0
- package/dist/components/charts/shared/chartSpecCore.d.ts +4 -0
- package/dist/components/charts/shared/chartSpecsAtlas.d.ts +2 -0
- package/dist/components/charts/shared/hooks.d.ts +3 -1
- package/dist/components/charts/shared/knownChartComponents.d.ts +1 -1
- 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/atlas/DependencyForestChart.d.ts +20 -0
- package/dist/components/recipes/atlas/DependencyMatrix.d.ts +7 -0
- package/dist/components/recipes/atlas/FlowCircuitChart.d.ts +20 -0
- package/dist/components/recipes/atlas/MotifBraidChart.d.ts +17 -0
- package/dist/components/recipes/atlas/atlasChartOptions.d.ts +11 -0
- package/dist/components/recipes/atlas/braid.d.ts +62 -0
- package/dist/components/recipes/atlas/capsules.d.ts +18 -0
- package/dist/components/recipes/atlas/compare.d.ts +4 -0
- package/dist/components/recipes/atlas/completeness.d.ts +2 -0
- package/dist/components/recipes/atlas/dependencyForest.d.ts +32 -0
- package/dist/components/recipes/atlas/dependencyForestChartProps.d.ts +58 -0
- package/dist/components/recipes/atlas/dependencyForestLayout.d.ts +17 -0
- package/dist/components/recipes/atlas/dependencyQueries.d.ts +20 -0
- package/dist/components/recipes/atlas/dependencyTypes.d.ts +21 -0
- package/dist/components/recipes/atlas/directedGraph.d.ts +9 -0
- package/dist/components/recipes/atlas/entityCounts.d.ts +3 -0
- package/dist/components/recipes/atlas/flowCircuit.d.ts +32 -0
- package/dist/components/recipes/atlas/flowCircuitChartProps.d.ts +72 -0
- package/dist/components/recipes/atlas/flowCircuitChrome.d.ts +18 -0
- package/dist/components/recipes/atlas/flowCircuitGeometry.d.ts +11 -0
- package/dist/components/recipes/atlas/flowCircuitLayout.d.ts +20 -0
- package/dist/components/recipes/atlas/flowCircuitSemantics.d.ts +26 -0
- package/dist/components/recipes/atlas/flowCircuitTape.d.ts +22 -0
- package/dist/components/recipes/atlas/flowCircuitTypes.d.ts +144 -0
- package/dist/components/recipes/atlas/forests.d.ts +11 -0
- package/dist/components/recipes/atlas/ids.d.ts +6 -0
- package/dist/components/recipes/atlas/index.d.ts +26 -0
- package/dist/components/recipes/atlas/ledger.d.ts +7 -0
- package/dist/components/recipes/atlas/motifBraidChartProps.d.ts +51 -0
- package/dist/components/recipes/atlas/motifBraidGeometry.d.ts +5 -0
- package/dist/components/recipes/atlas/motifBraidLayout.d.ts +11 -0
- package/dist/components/recipes/atlas/motifs.d.ts +3 -0
- package/dist/components/recipes/atlas/prefixForest.d.ts +9 -0
- package/dist/components/recipes/atlas/prepare.d.ts +14 -0
- package/dist/components/recipes/atlas/prepareAsync.d.ts +7 -0
- package/dist/components/recipes/atlas/profile.d.ts +19 -0
- package/dist/components/recipes/atlas/publish.d.ts +10 -0
- package/dist/components/recipes/atlas/queries.d.ts +34 -0
- package/dist/components/recipes/atlas/requiredPaths.d.ts +9 -0
- package/dist/components/recipes/atlas/rootedForest.d.ts +4 -0
- package/dist/components/recipes/atlas/sections.d.ts +3 -0
- package/dist/components/recipes/atlas/support.d.ts +7 -0
- package/dist/components/recipes/atlas/types.d.ts +278 -0
- package/dist/components/recipes/atlas/validate.d.ts +12 -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-atlas-core.d.ts +20 -0
- package/dist/components/semiotic-atlas.d.ts +8 -0
- package/dist/components/semiotic-experimental.d.ts +1 -1
- package/dist/components/semiotic-physics.d.ts +4 -4
- package/dist/components/semiotic-recipes-core.d.ts +9 -0
- 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/serverChartConfigs.d.ts +3 -0
- package/dist/components/server/serverChartConfigsAtlas.d.ts +4 -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/NetworkPipelineStore.d.ts +1 -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/canvasSetup.d.ts +1 -2
- package/dist/components/stream/fontLoading.d.ts +4 -0
- package/dist/components/stream/hitTestUtils.d.ts +2 -0
- package/dist/components/stream/networkCustomLayout.d.ts +8 -0
- package/dist/components/stream/networkCustomLayoutCache.d.ts +12 -0
- package/dist/components/stream/networkPipelineConfig.d.ts +0 -7
- 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 +11 -0
- package/dist/components/stream/physics/usePhysicsCanvasPointer.d.ts +3 -1
- package/dist/components/stream/physics/usePhysicsSemanticNavigation.d.ts +2 -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/shallowEqual.d.ts +2 -0
- package/dist/components/stream/streamEncodingTypes.d.ts +53 -0
- package/dist/components/stream/types.d.ts +4 -53
- package/dist/components/stream/useEnsureCustomXYRenderers.d.ts +4 -2
- 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-atlas-core.d.ts +20 -0
- package/dist/semiotic-atlas-core.min.js +1 -0
- package/dist/semiotic-atlas-core.module.min.js +1 -0
- package/dist/semiotic-atlas-selection.module.min.js +2 -0
- package/dist/semiotic-atlas.d.ts +8 -0
- package/dist/semiotic-atlas.min.js +2 -0
- package/dist/semiotic-atlas.module.min.js +2 -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.d.ts +9 -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.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 +70 -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
|
@@ -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[];
|
|
@@ -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,13 +2,24 @@
|
|
|
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";
|
|
8
9
|
export declare const SR_ONLY_STYLE: React.CSSProperties;
|
|
10
|
+
/** Announce hover or focus once, outside the frame's atomic role="img". */
|
|
11
|
+
export declare function renderPhysicsAnnouncements(items: PhysicsSemanticItem[], focusedSemanticItem: PhysicsSemanticItem | null, hoverData: PhysicsHoverData | null, liveRegionId: string): React.JSX.Element;
|
|
9
12
|
declare function physicsHoverData(body: PhysicsBodyState): PhysicsHoverData;
|
|
10
13
|
declare function createBodySemanticItems(bodies: readonly PhysicsBodyState[], simulationState: PhysicsSimulationState, bodySemanticItems: StreamPhysicsFrameProps["bodySemanticItems"], limit: number): PhysicsSemanticItem[];
|
|
11
14
|
declare function semanticItemsChanged(previous: readonly PhysicsSemanticItem[], next: readonly PhysicsSemanticItem[]): boolean;
|
|
15
|
+
export declare function renderPhysicsTooltip({ enableHover, hoverData, tooltipContent, plotWidth, plotHeight, margin }: {
|
|
16
|
+
enableHover: boolean;
|
|
17
|
+
hoverData: PhysicsHoverData | null;
|
|
18
|
+
tooltipContent: StreamPhysicsFrameProps["tooltipContent"];
|
|
19
|
+
plotWidth: number;
|
|
20
|
+
plotHeight: number;
|
|
21
|
+
margin: FrameMargin;
|
|
22
|
+
}): React.ReactElement | null;
|
|
12
23
|
declare function DefaultPhysicsTooltip({ hover }: {
|
|
13
24
|
hover: PhysicsHoverData;
|
|
14
25
|
}): React.ReactElement;
|
|
@@ -6,11 +6,13 @@ import type { PhysicsHoverData, StreamPhysicsFrameProps } from "./StreamPhysicsT
|
|
|
6
6
|
import type { PhysicsFrameObservationPayload } from "./physicsFrameObservations";
|
|
7
7
|
type PhysicsFrameObservationEmitter = (type: "hover", payload: PhysicsFrameObservationPayload) => void;
|
|
8
8
|
interface PhysicsCanvasPointerOptions {
|
|
9
|
+
resolveSemanticBody?: (body: PhysicsBodyState) => PhysicsBodyState;
|
|
9
10
|
canvasRef: React.RefObject<HTMLCanvasElement | null>;
|
|
10
11
|
clearHover: () => void;
|
|
11
12
|
emitObservation: PhysicsFrameObservationEmitter;
|
|
12
13
|
enableHover: boolean;
|
|
13
14
|
hoverRadius: number;
|
|
15
|
+
hoverDataRef: React.MutableRefObject<PhysicsHoverData | null>;
|
|
14
16
|
onBodyHover: StreamPhysicsFrameProps["onBodyHover"];
|
|
15
17
|
setHoverData: React.Dispatch<React.SetStateAction<PhysicsHoverData | null>>;
|
|
16
18
|
storeRef: React.RefObject<PhysicsPipelineStore | null>;
|
|
@@ -22,7 +24,7 @@ export interface PhysicsBodyCursorCollection {
|
|
|
22
24
|
}
|
|
23
25
|
declare function collectPhysicsBodyCursor(collection: PhysicsBodyCursorCollection, body: PhysicsBodyState, style: Style, customRenderer: boolean): void;
|
|
24
26
|
/** Owns canvas hit-testing that is shared by physics hover and authored cursors. */
|
|
25
|
-
export declare function usePhysicsCanvasPointer({ canvasRef, clearHover, emitObservation, enableHover, hoverRadius, onBodyHover, setHoverData, storeRef }: PhysicsCanvasPointerOptions): {
|
|
27
|
+
export declare function usePhysicsCanvasPointer({ resolveSemanticBody, canvasRef, clearHover, emitObservation, enableHover, hoverRadius, hoverDataRef, onBodyHover, setHoverData, storeRef }: PhysicsCanvasPointerOptions): {
|
|
26
28
|
begin: () => PhysicsBodyCursorCollection;
|
|
27
29
|
collect: typeof collectPhysicsBodyCursor;
|
|
28
30
|
handlePointerLeave: (event: React.PointerEvent<HTMLCanvasElement>) => void;
|
|
@@ -21,11 +21,13 @@ interface PhysicsSemanticNavigationOptions {
|
|
|
21
21
|
storeRef: MutableRefObject<PhysicsPipelineStore | null>;
|
|
22
22
|
}
|
|
23
23
|
export interface PhysicsSemanticNavigationResult {
|
|
24
|
+
resolveSemanticBody: (body: PhysicsBodyState) => PhysicsBodyState;
|
|
24
25
|
clearHover: () => void;
|
|
25
26
|
focusedBodyIdRef: MutableRefObject<string | null>;
|
|
26
27
|
focusedSemanticItem: PhysicsSemanticItem | null;
|
|
27
28
|
handleCanvasPointerDown: (event: PointerEvent<HTMLCanvasElement>) => void;
|
|
28
29
|
hoverData: PhysicsHoverData | null;
|
|
30
|
+
hoverDataRef: MutableRefObject<PhysicsHoverData | null>;
|
|
29
31
|
onKeyDown: (event: KeyboardEvent<HTMLDivElement>) => void;
|
|
30
32
|
setFocusedSemanticItem: Dispatch<SetStateAction<PhysicsSemanticItem | null>>;
|
|
31
33
|
setHoverData: Dispatch<SetStateAction<PhysicsHoverData | null>>;
|
|
@@ -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;
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { type MutableRefObject } from "react";
|
|
1
|
+
import { type MutableRefObject, type RefObject } from "react";
|
|
2
2
|
import type { StreamChartType } from "./types";
|
|
3
3
|
/**
|
|
4
4
|
* Keep LineChart's static graph free of candlestick/heatmap/bar, while
|
|
@@ -15,4 +15,6 @@ import type { StreamChartType } from "./types";
|
|
|
15
15
|
* transition/restyle/pulse/resolution change). `scheduleRender` alone
|
|
16
16
|
* after the first frame is not enough.
|
|
17
17
|
*/
|
|
18
|
-
export declare function useEnsureXYPlugins(chartType: StreamChartType, customLayout: unknown, dirtyRef: MutableRefObject<boolean>, scheduleRender: () => void
|
|
18
|
+
export declare function useEnsureXYPlugins(chartType: StreamChartType, customLayout: unknown, dirtyRef: MutableRefObject<boolean>, scheduleRender: () => void, storeRef: RefObject<{
|
|
19
|
+
markStylePaintPending(): void;
|
|
20
|
+
} | null>): 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,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. */
|