semiotic 3.9.1 → 3.10.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +137 -58
- package/agent-skill/semiotic-charts/SKILL.md +27 -17
- package/ai/artifact-contract-reference.md +408 -0
- package/ai/artifact-surface-inventory.json +5586 -0
- package/ai/behaviorContracts.cjs +24 -2
- package/ai/cli.js +480 -56
- package/ai/componentMetadata.cjs +13 -3
- package/ai/dist/mcp-server.js +140 -36407
- package/ai/examples.md +110 -7
- package/ai/reference.md +82 -28
- package/ai/schema.json +7675 -1471
- package/ai/surface-manifest.json +60 -9
- package/ai/system-prompt.md +18 -3
- package/ai/task-packets/compare-category-totals.json +301 -0
- package/ai/task-packets/compare-category-totals.md +188 -0
- package/ai/task-packets/correct-published-chart.json +271 -0
- package/ai/task-packets/correct-published-chart.md +597 -0
- package/ai/task-packets/index.json +40 -0
- package/ai/task-packets/update-live-chart.json +289 -0
- package/ai/task-packets/update-live-chart.md +424 -0
- package/dist/c-2N7IU2NY.min.js +1 -0
- package/dist/c-2WK7YJLL.min.js +1 -0
- package/dist/c-33QOXEUG.min.js +1 -0
- package/dist/c-42PLDTX7.min.js +1 -0
- package/dist/c-447VIMRO.min.js +1 -0
- package/dist/c-4FN7Q6VQ.min.js +1 -0
- package/dist/c-553QUDKA.min.js +1 -0
- package/dist/c-55BAJ333.min.js +1 -0
- package/dist/c-7242NXSG.min.js +1 -0
- package/dist/c-7EGHJU2F.min.js +1 -0
- package/dist/c-7HP7MB2I.min.js +1 -0
- package/dist/c-7NBU5ZKS.min.js +1 -0
- package/dist/c-AFBSWT77.min.js +1 -0
- package/dist/c-AJ7EC32V.min.js +1 -0
- package/dist/c-AQADQNY7.min.js +1 -0
- package/dist/c-ATM475SA.min.js +1 -0
- package/dist/c-AVO3Q7T7.min.js +1 -0
- package/dist/c-AZKPVBOC.min.js +1 -0
- package/dist/c-BNFJMDHN.min.js +1 -0
- package/dist/c-BNG5ECK5.min.js +1 -0
- package/dist/c-BOHCQILI.min.js +1 -0
- package/dist/c-CCTGN5CK.min.js +1 -0
- package/dist/c-CPSPZH6A.min.js +1 -0
- package/dist/c-CPV4N35K.min.js +1 -0
- package/dist/c-D6HAAPTX.min.js +1 -0
- package/dist/c-DE5Q3U2X.min.js +1 -0
- package/dist/c-DK662R77.min.js +1 -0
- package/dist/c-DY2676CR.min.js +1 -0
- package/dist/c-E32M6XW5.min.js +1 -0
- package/dist/c-E4JDJH4I.min.js +1 -0
- package/dist/c-E7I2L7CU.min.js +1 -0
- package/dist/c-EBOQ7ER7.min.js +1 -0
- package/dist/c-ELDWAO2V.min.js +1 -0
- package/dist/c-EUBTECGM.min.js +1 -0
- package/dist/c-GNTXRXRN.min.js +1 -0
- package/dist/c-GSZRZRD6.min.js +1 -0
- package/dist/c-GWX7JGMF.min.js +1 -0
- package/dist/c-GXV3C3MO.min.js +1 -0
- package/dist/c-HHTK2R75.min.js +1 -0
- package/dist/c-HLLFJYTY.min.js +1 -0
- package/dist/c-HPOYKCCG.min.js +1 -0
- package/dist/c-HXDKPIKR.min.js +1 -0
- package/dist/c-I4QJ6YLM.min.js +1 -0
- package/dist/c-IDJV3CZK.min.js +1 -0
- package/dist/c-ITKX3RC5.min.js +1 -0
- package/dist/c-JG2JCQLP.min.js +1 -0
- package/dist/c-JLGRHXGZ.min.js +1 -0
- package/dist/c-JO2UGTCP.min.js +1 -0
- package/dist/c-JUKIWTBJ.min.js +1 -0
- package/dist/c-KCRJGUHP.min.js +1 -0
- package/dist/c-LMGSSD2E.min.js +1 -0
- package/dist/c-LYQMZMZQ.min.js +1 -0
- package/dist/c-LYVKDBQJ.min.js +1 -0
- package/dist/c-MVR3RWF3.min.js +1 -0
- package/dist/c-MXCP7GNZ.min.js +1 -0
- package/dist/c-NG7BLZTR.min.js +1 -0
- package/dist/c-NYZ2QNAM.min.js +1 -0
- package/dist/c-OO5QLMJC.min.js +1 -0
- package/dist/c-OOVX2JPQ.min.js +1 -0
- package/dist/c-ORLEBW72.min.js +1 -0
- package/dist/c-P65V6HLO.min.js +1 -0
- package/dist/c-PP6VY3QU.min.js +1 -0
- package/dist/c-PRIKOLTE.min.js +1 -0
- package/dist/c-PSNI6KAZ.min.js +1 -0
- package/dist/c-PYNW54D2.min.js +1 -0
- package/dist/c-QA3HMQJP.min.js +1 -0
- package/dist/c-QAVFOEUY.min.js +1 -0
- package/dist/c-ROEHCIGV.min.js +1 -0
- package/dist/c-S3AZX5PP.min.js +1 -0
- package/dist/c-T2V7O2LO.min.js +1 -0
- package/dist/c-TIXX5CAU.min.js +1 -0
- package/dist/c-TKG2NP7G.min.js +1 -0
- package/dist/c-VJTDST2R.min.js +1 -0
- package/dist/c-VXLOLYTO.min.js +1 -0
- package/dist/c-W4ZUKSEQ.min.js +1 -0
- package/dist/c-WH2O53VI.min.js +1 -0
- package/dist/c-WNGH47HF.min.js +1 -0
- package/dist/c-WUWXGQYA.min.js +1 -0
- package/dist/c-XDQKXPX4.min.js +1 -0
- package/dist/c-XSB27XPS.min.js +1 -0
- package/dist/c-YDECTEUW.min.js +1 -0
- package/dist/c-YF3YKVQI.min.js +1 -0
- package/dist/c-YLZIV3VS.min.js +1 -0
- package/dist/c-ZYPXQF7B.min.js +1 -0
- package/dist/components/Annotation.d.ts +3 -2
- package/dist/components/access/chartAccessCapabilities.generated.d.ts +14 -0
- package/dist/components/access/chartAccessContract.d.ts +90 -0
- package/dist/components/access/chartAccessContractFixtures.d.ts +11 -0
- package/dist/components/ai/aestheticProfileTypes.d.ts +35 -0
- package/dist/components/ai/annotationProvenance.d.ts +2 -7
- package/dist/components/ai/auditVisualHierarchy.d.ts +49 -0
- package/dist/components/ai/builtInChartRecipeLayouts.d.ts +2 -0
- package/dist/components/ai/builtInChartRecipePublic.d.ts +4 -0
- package/dist/components/ai/builtInChartRecipes.d.ts +26 -0
- package/dist/components/ai/chartCapabilities.d.ts +3 -1
- package/dist/components/ai/chartRecipeRegistry.d.ts +7 -1
- package/dist/components/ai/chartRecipes.d.ts +10 -0
- package/dist/components/ai/colorEvidence.d.ts +12 -0
- package/dist/components/ai/describePhysicsProjection.d.ts +18 -0
- package/dist/components/ai/describePhysicsSource.d.ts +13 -0
- package/dist/components/ai/evaluateAesthetics.d.ts +47 -0
- package/dist/components/ai/geoNavigation.d.ts +4 -0
- package/dist/components/ai/hierarchyNavigation.d.ts +4 -0
- package/dist/components/ai/navigationTree.d.ts +7 -1
- package/dist/components/ai/qualityFixtures.d.ts +8 -0
- package/dist/components/ai/suggestionPropContracts.d.ts +1 -1
- package/dist/components/ai/useNavigationSync.d.ts +3 -3
- package/dist/components/artifact/ArtifactInspector.d.ts +26 -0
- package/dist/components/artifact/ArtifactInspectorContextSections.d.ts +18 -0
- package/dist/components/artifact/artifactContractDiff.d.ts +8 -0
- package/dist/components/artifact/artifactInspectorSummary.d.ts +53 -0
- package/dist/components/artifact/artifactRevision.d.ts +54 -0
- package/dist/components/artifact/artifactTestFixtures.d.ts +17 -0
- package/dist/components/artifact/attachmentAudit.d.ts +13 -0
- package/dist/components/artifact/claimCorrections.d.ts +3 -0
- package/dist/components/artifact/claimGraph.d.ts +5 -0
- package/dist/components/artifact/claimLifecycle.d.ts +32 -0
- package/dist/components/artifact/claims.d.ts +24 -0
- package/dist/components/artifact/collection.d.ts +10 -0
- package/dist/components/artifact/collectionCorrectionScope.d.ts +4 -0
- package/dist/components/artifact/collectionImpact.d.ts +11 -0
- package/dist/components/artifact/collectionLineage.d.ts +3 -0
- package/dist/components/artifact/collectionOperations.d.ts +8 -0
- package/dist/components/artifact/collectionPolicy.d.ts +22 -0
- package/dist/components/artifact/collectionTypes.d.ts +117 -0
- package/dist/components/artifact/configurationRepair.d.ts +8 -0
- package/dist/components/artifact/contract.d.ts +30 -0
- package/dist/components/artifact/evaluateArtifact.d.ts +12 -0
- package/dist/components/artifact/evaluateArtifactTypes.d.ts +78 -0
- package/dist/components/artifact/evaluationPresentation.d.ts +9 -0
- package/dist/components/artifact/evidenceSample.d.ts +8 -0
- package/dist/components/artifact/exportPaths.d.ts +8 -0
- package/dist/components/artifact/fieldPolicies.d.ts +12 -0
- package/dist/components/artifact/fingerprint.d.ts +36 -0
- package/dist/components/artifact/grounding.d.ts +51 -0
- package/dist/components/artifact/groundingBudget.d.ts +38 -0
- package/dist/components/artifact/hostTransfer.d.ts +13 -0
- package/dist/components/artifact/identity.d.ts +19 -0
- package/dist/components/artifact/inheritance.d.ts +48 -0
- package/dist/components/artifact/inheritanceIntegrity.d.ts +3 -0
- package/dist/components/artifact/jsonCompatibility.d.ts +2 -0
- package/dist/components/artifact/obligations.d.ts +3 -0
- package/dist/components/artifact/policies.d.ts +45 -0
- package/dist/components/artifact/policyRelations.d.ts +3 -0
- package/dist/components/artifact/recordProjection.d.ts +7 -0
- package/dist/components/artifact/representation.d.ts +50 -0
- package/dist/components/artifact/serialization.d.ts +40 -0
- package/dist/components/artifact/temporal.d.ts +32 -0
- package/dist/components/artifact/temporalAdapters.d.ts +75 -0
- package/dist/components/artifact/temporalAuditHelpers.d.ts +12 -0
- package/dist/components/artifact/temporalPresentation.d.ts +8 -0
- package/dist/components/artifact/types.d.ts +341 -0
- package/dist/components/artifact/validation.d.ts +13 -0
- package/dist/components/artifact/validationFieldStatus.d.ts +7 -0
- package/dist/components/artifact/validationPrimitives.d.ts +24 -0
- package/dist/components/artifact/validationSurfaces.d.ts +7 -0
- package/dist/components/artifact/validationTemporal.d.ts +3 -0
- package/dist/components/charts/geo/FlowMap.d.ts +7 -0
- package/dist/components/charts/geo/flowMapLineStyle.d.ts +18 -0
- package/dist/components/charts/index.d.ts +4 -0
- package/dist/components/charts/network/ChordDiagram.d.ts +5 -1
- package/dist/components/charts/network/CirclePack.d.ts +8 -1
- package/dist/components/charts/network/OrbitDiagram.d.ts +9 -0
- package/dist/components/charts/network/TreeDiagram.d.ts +8 -1
- package/dist/components/charts/network/Treemap.d.ts +8 -1
- package/dist/components/charts/ordinal/BarChart.d.ts +6 -0
- package/dist/components/charts/ordinal/BoxPlot.d.ts +3 -0
- package/dist/components/charts/ordinal/DonutChart.d.ts +5 -0
- package/dist/components/charts/ordinal/DotPlot.d.ts +3 -0
- package/dist/components/charts/ordinal/FunnelChart.d.ts +5 -0
- package/dist/components/charts/ordinal/GaugeChart.d.ts +3 -0
- package/dist/components/charts/ordinal/GroupedBarChart.d.ts +6 -0
- package/dist/components/charts/ordinal/Histogram.d.ts +3 -0
- package/dist/components/charts/ordinal/LikertChart.d.ts +3 -0
- package/dist/components/charts/ordinal/PieChart.d.ts +5 -0
- package/dist/components/charts/ordinal/RadarChart.capability.d.ts +2 -0
- package/dist/components/charts/ordinal/RadarChart.d.ts +77 -0
- package/dist/components/charts/ordinal/RidgelinePlot.d.ts +3 -0
- package/dist/components/charts/ordinal/StackedBarChart.d.ts +6 -0
- package/dist/components/charts/ordinal/SwarmPlot.d.ts +3 -0
- package/dist/components/charts/ordinal/SwimlaneChart.d.ts +3 -0
- package/dist/components/charts/ordinal/ViolinPlot.d.ts +3 -0
- package/dist/components/charts/physics/CollisionSwarmChart.d.ts +1 -1
- package/dist/components/charts/physics/EventDropChart.d.ts +3 -1
- package/dist/components/charts/physics/GaltonBoardChart.d.ts +4 -2
- package/dist/components/charts/physics/GauntletChart.d.ts +1 -5
- package/dist/components/charts/physics/ProcessFlowChart.d.ts +6 -0
- package/dist/components/charts/physics/UnitPileChart.d.ts +2 -1
- package/dist/components/charts/physics/chainReactionTypes.d.ts +3 -0
- package/dist/components/charts/physics/collisionSwarmPacking.d.ts +14 -0
- package/dist/components/charts/physics/collisionSwarmPhysics.d.ts +1 -0
- package/dist/components/charts/physics/eventDropAdmission.d.ts +32 -0
- package/dist/components/charts/physics/eventDropPhysics.d.ts +22 -1
- package/dist/components/charts/physics/galtonBoardPhysics.d.ts +2 -9
- package/dist/components/charts/physics/gauntletPhysics.d.ts +1 -0
- package/dist/components/charts/physics/physicsChartReconcile.d.ts +4 -0
- package/dist/components/charts/physics/physicsChartUtils.d.ts +1 -1
- package/dist/components/charts/physics/physicsGaltonData.d.ts +10 -0
- package/dist/components/charts/physics/physicsHocHandle.d.ts +2 -0
- package/dist/components/charts/physics/physicsHocUtils.d.ts +7 -1
- package/dist/components/charts/physics/physicsPileData.d.ts +11 -0
- package/dist/components/charts/physics/physicsPilePhysics.d.ts +5 -12
- package/dist/components/charts/physics/physicsProjectionOverlays.d.ts +1 -1
- package/dist/components/charts/physics/physicsSourceRows.d.ts +8 -0
- package/dist/components/charts/physics/usePhysicsChartData.d.ts +19 -0
- package/dist/components/charts/realtime/RealtimeHeatmap.d.ts +14 -1
- package/dist/components/charts/realtime/RealtimeHistogram.d.ts +25 -7
- package/dist/components/charts/realtime/RealtimeLineChart.d.ts +18 -5
- package/dist/components/charts/realtime/RealtimeSwarmChart.d.ts +11 -1
- package/dist/components/charts/realtime/RealtimeWaterfallChart.d.ts +11 -1
- package/dist/components/charts/realtime/aggregate.d.ts +12 -1
- package/dist/components/charts/realtime/realtimeAccessors.d.ts +4 -0
- package/dist/components/charts/realtime/realtimeChartRuntime.d.ts +8 -5
- package/dist/components/charts/realtime/realtimeChartTypes.d.ts +7 -0
- package/dist/components/charts/realtime/realtimeStyleRules.d.ts +4 -0
- package/dist/components/charts/realtime/temporalHistogramConfig.d.ts +17 -11
- package/dist/components/charts/shared/GaugeReadout.d.ts +9 -0
- package/dist/components/charts/shared/ThresholdAnnotation.d.ts +18 -0
- package/dist/components/charts/shared/ThresholdEndCap.d.ts +7 -0
- package/dist/components/charts/shared/annotationStatusFilter.d.ts +18 -0
- package/dist/components/charts/shared/auditAccessibilityText.d.ts +4 -2
- package/dist/components/charts/shared/chartDefinitionPilot.d.ts +5 -4
- package/dist/components/charts/shared/chartSpecCore.d.ts +2 -2
- package/dist/components/charts/shared/heatmapStyleRules.d.ts +13 -0
- package/dist/components/charts/shared/knownChartComponents.d.ts +1 -1
- package/dist/components/charts/shared/networkUtils.d.ts +14 -0
- package/dist/components/charts/shared/numericTickFormatter.d.ts +2 -0
- package/dist/components/charts/shared/radialCenterContent.d.ts +10 -0
- package/dist/components/charts/shared/selectionUtils.d.ts +3 -1
- package/dist/components/charts/shared/tooltipUtils.d.ts +1 -1
- package/dist/components/charts/shared/types.d.ts +4 -2
- package/dist/components/charts/shared/useChartLegend.d.ts +6 -1
- package/dist/components/charts/shared/useLikertAggregation.d.ts +8 -2
- package/dist/components/charts/shared/useNetworkChartSetup.d.ts +9 -5
- package/dist/components/charts/shared/useOrdinalPieceStyle.d.ts +1 -1
- package/dist/components/charts/shared/useXYBrush.d.ts +24 -0
- package/dist/components/charts/shared/useXYPointStyle.d.ts +2 -0
- package/dist/components/charts/xy/BubbleChart.d.ts +7 -0
- package/dist/components/charts/xy/CandlestickChart.d.ts +7 -0
- package/dist/components/charts/xy/DifferenceChart.d.ts +7 -0
- package/dist/components/charts/xy/Heatmap.d.ts +16 -0
- package/dist/components/charts/xy/LineChart.d.ts +9 -0
- package/dist/components/charts/xy/MinimapChart.d.ts +7 -0
- package/dist/components/charts/xy/MultiAxisLineChart.d.ts +7 -0
- package/dist/components/charts/xy/Scatterplot.d.ts +7 -0
- package/dist/components/charts/xy/ScatterplotMatrix.d.ts +6 -0
- package/dist/components/charts/xy/WaterfallChart.capability.d.ts +2 -0
- package/dist/components/charts/xy/WaterfallChart.d.ts +76 -0
- package/dist/components/charts/xy/differenceMarkStyle.d.ts +28 -0
- package/dist/components/charts/xy/multiAxisFields.d.ts +23 -0
- package/dist/components/charts/xy/scatterplotMatrixCells.d.ts +50 -0
- package/dist/components/evidence/chartEvidenceEnvelope.d.ts +154 -0
- package/dist/components/evidence/evidenceEnvelopeInput.d.ts +8 -0
- package/dist/components/evidence/evidenceEnvelopeValidation.d.ts +11 -0
- package/dist/components/evidence/evidenceGate.d.ts +30 -0
- package/dist/components/evidence/renderedSceneHash.d.ts +23 -0
- package/dist/components/evidence/stableJsonHash.d.ts +4 -0
- package/dist/components/export/chartConfig.d.ts +40 -5
- package/dist/components/export/chartConfigArtifact.d.ts +6 -0
- package/dist/components/legendLayout.d.ts +18 -0
- package/dist/components/legendStyles.d.ts +4 -0
- package/dist/components/realtime/BinAccumulator.d.ts +5 -1
- package/dist/components/realtime/types.d.ts +16 -7
- package/dist/components/recipes/adjacencyFlow.d.ts +12 -0
- package/dist/components/recipes/adjacencyFlowAggregation.d.ts +72 -0
- package/dist/components/recipes/adjacencyFlowGeometry.d.ts +79 -0
- package/dist/components/recipes/firstAvailableTrack.d.ts +17 -0
- package/dist/components/recipes/intervals.d.ts +1 -1
- package/dist/components/recipes/lineageDag.d.ts +17 -0
- package/dist/components/recipes/lineageDagHulls.d.ts +22 -0
- package/dist/components/recipes/transitDiagram.d.ts +75 -0
- package/dist/components/recipes/transitDiagramGeometry.d.ts +47 -0
- package/dist/components/semiotic-access.d.ts +9 -0
- package/dist/components/semiotic-ai-audits.d.ts +17 -0
- package/dist/components/semiotic-ai-core.d.ts +38 -18
- package/dist/components/semiotic-ai.d.ts +20 -20
- package/dist/components/semiotic-artifact-react.d.ts +10 -0
- package/dist/components/semiotic-artifact.d.ts +23 -0
- package/dist/components/semiotic-evidence.d.ts +10 -0
- package/dist/components/semiotic-experimental.d.ts +1 -1
- package/dist/components/semiotic-line.d.ts +9 -0
- package/dist/components/semiotic-network.d.ts +3 -0
- package/dist/components/semiotic-ordinal.d.ts +2 -0
- package/dist/components/semiotic-physics.d.ts +4 -4
- package/dist/components/semiotic-realtime-core.d.ts +3 -2
- package/dist/components/semiotic-recipes-core.d.ts +6 -0
- package/dist/components/semiotic-text.d.ts +2 -0
- package/dist/components/semiotic-themes-core.d.ts +3 -0
- package/dist/components/semiotic-utils-core.d.ts +19 -14
- package/dist/components/semiotic-xy.d.ts +3 -0
- package/dist/components/semiotic.d.ts +11 -5
- package/dist/components/server/renderDashboard.d.ts +37 -0
- package/dist/components/server/renderEvidence.d.ts +39 -0
- package/dist/components/server/renderToStaticSVG.d.ts +5 -30
- package/dist/components/server/serverChartConfigShared.d.ts +13 -0
- package/dist/components/server/serverChartConfigs.d.ts +9 -0
- package/dist/components/server/serverChartConfigsComposite.d.ts +4 -0
- package/dist/components/server/serverChartConfigsCustom.d.ts +2 -0
- package/dist/components/server/serverChartConfigsGeo.d.ts +1 -0
- package/dist/components/server/serverChartConfigsOrdinal.d.ts +3 -2
- package/dist/components/server/serverChartConfigsXY.d.ts +1 -0
- package/dist/components/server/serverChartConfigsXYExtra.d.ts +3 -0
- package/dist/components/server/serverCompositeChainReaction.d.ts +3 -0
- package/dist/components/server/serverOrdinalGauge.d.ts +3 -0
- package/dist/components/server/serverOrdinalLikert.d.ts +2 -0
- package/dist/components/server/staticSVGChrome.d.ts +1 -4
- package/dist/components/server/staticXYAxisTicks.d.ts +2 -38
- package/dist/components/server/staticXYGrid.d.ts +1 -1
- package/dist/components/server/svgSizing.d.ts +6 -0
- package/dist/components/shared/svgRoot.d.ts +17 -0
- package/dist/components/store/selectionProvenance.d.ts +14 -0
- package/dist/components/store/themeCore.d.ts +5 -1
- package/dist/components/stream/GeoPipelineStore.d.ts +1 -1
- package/dist/components/stream/GeoSVGOverlay.d.ts +4 -0
- package/dist/components/stream/MarginalGraphics.d.ts +3 -3
- package/dist/components/stream/MarginalGraphicsLazy.d.ts +22 -0
- package/dist/components/stream/NetworkPipelineStore.d.ts +2 -0
- package/dist/components/stream/NetworkSVGOverlay.d.ts +4 -0
- package/dist/components/stream/OrdinalPipelineStore.d.ts +1 -1
- package/dist/components/stream/OrdinalSVGOverlay.d.ts +4 -0
- package/dist/components/stream/PipelineStore.d.ts +1 -1
- package/dist/components/stream/SVGOverlay.d.ts +4 -0
- package/dist/components/stream/SceneToSVG.d.ts +4 -19
- package/dist/components/stream/SceneToSVGXY.d.ts +13 -0
- package/dist/components/stream/StreamGeoFrame.d.ts +1 -2
- package/dist/components/stream/StreamOrdinalFrame.d.ts +1 -2
- package/dist/components/stream/XYGrid.d.ts +11 -0
- package/dist/components/stream/axisTickUtils.d.ts +0 -1
- package/dist/components/stream/canvasSetup.d.ts +8 -2
- package/dist/components/stream/customLayoutAttempt.d.ts +21 -0
- package/dist/components/stream/geoTypes.d.ts +1 -1
- package/dist/components/stream/hitTestUtils.d.ts +2 -0
- package/dist/components/stream/isServerEnvironment.d.ts +6 -0
- package/dist/components/stream/layouts/forceLayoutNodeSize.d.ts +12 -0
- package/dist/components/stream/layouts/forceLayoutPlugin.d.ts +2 -9
- package/dist/components/stream/layouts/forceLayoutWorkerClient.d.ts +2 -21
- package/dist/components/stream/layouts/forceLayoutWorkerPolicy.d.ts +21 -0
- package/dist/components/stream/layouts/index.d.ts +6 -12
- package/dist/components/stream/layouts/missingPlugin.d.ts +7 -0
- package/dist/components/stream/layouts/registerBuiltIn.d.ts +1 -0
- package/dist/components/stream/layouts/registry.d.ts +12 -0
- package/dist/components/stream/marginalConfig.d.ts +3 -0
- package/dist/components/stream/networkCustomLayout.d.ts +7 -0
- package/dist/components/stream/networkCustomLayoutOutput.d.ts +13 -0
- package/dist/components/stream/networkCustomLayoutRunner.d.ts +1 -1
- package/dist/components/stream/networkTypes.d.ts +5 -1
- package/dist/components/stream/ordinalTypes.d.ts +1 -1
- package/dist/components/stream/overlayAccessibleText.d.ts +18 -0
- package/dist/components/stream/physics/PhysicsControllers.d.ts +1 -1
- package/dist/components/stream/physics/PhysicsKernel.d.ts +9 -0
- package/dist/components/stream/physics/PhysicsPipelineStore.d.ts +5 -4
- package/dist/components/stream/physics/PhysicsPipelineTypes.d.ts +9 -0
- package/dist/components/stream/physics/StreamPhysicsTypes.d.ts +4 -1
- package/dist/components/stream/physics/physicsCanvasCoordinates.d.ts +5 -0
- package/dist/components/stream/physics/physicsFixedPosition.d.ts +16 -0
- package/dist/components/stream/physics/physicsKernelCloning.d.ts +6 -0
- package/dist/components/stream/physics/physicsPipelineObservations.d.ts +2 -0
- package/dist/components/stream/physics/physicsPipelineSettle.d.ts +15 -9
- package/dist/components/stream/physics/physicsRegionRuntime.d.ts +8 -17
- package/dist/components/stream/physics/physicsSemanticUI.d.ts +9 -0
- package/dist/components/stream/pipelineConfig.d.ts +4 -0
- package/dist/components/stream/pipelineDomainResolution.d.ts +6 -0
- package/dist/components/stream/pipelineStoreUpdateResults.d.ts +1 -1
- package/dist/components/stream/renderers/pointCanvasRenderer.d.ts +4 -0
- package/dist/components/stream/renderers/resolveCSSColor.d.ts +4 -4
- package/dist/components/stream/resolveXYAxes.d.ts +13 -0
- package/dist/components/stream/sceneToSVGShared.d.ts +2 -1
- package/dist/components/stream/seriesGeometry.d.ts +13 -0
- package/dist/components/stream/streamEncodingTypes.d.ts +53 -0
- package/dist/components/stream/types.d.ts +12 -54
- package/dist/components/stream/useEnsureCustomXYRenderers.d.ts +18 -0
- package/dist/components/stream/useGeoFrameHandle.d.ts +16 -0
- package/dist/components/stream/useMarginalValues.d.ts +13 -0
- package/dist/components/stream/useOrdinalFrameHandle.d.ts +15 -0
- package/dist/components/stream/useXYFrameHandle.d.ts +15 -0
- package/dist/components/stream/xyAxisTicks.d.ts +25 -0
- package/dist/components/stream/xyCanvasRenderers.d.ts +4 -4
- package/dist/components/stream/xyDateTicks.d.ts +3 -2
- package/dist/components/stream/xyFrameAxisTypes.d.ts +2 -0
- package/dist/components/stream/xyPlugins/areaPlugin.d.ts +2 -0
- package/dist/components/stream/xyPlugins/barPlugin.d.ts +2 -0
- package/dist/components/stream/xyPlugins/candlestickPlugin.d.ts +2 -0
- package/dist/components/stream/xyPlugins/customPlugin.d.ts +6 -0
- package/dist/components/stream/xyPlugins/heatmapPlugin.d.ts +2 -0
- package/dist/components/stream/xyPlugins/lineFamily.d.ts +5 -0
- package/dist/components/stream/xyPlugins/linePlugin.d.ts +2 -0
- package/dist/components/stream/xyPlugins/missingPlugin.d.ts +7 -0
- package/dist/components/stream/xyPlugins/mixedPlugin.d.ts +2 -0
- package/dist/components/stream/xyPlugins/pointPlugin.d.ts +3 -0
- package/dist/components/stream/xyPlugins/registerBuiltIn.d.ts +1 -0
- package/dist/components/stream/xyPlugins/registry.d.ts +31 -0
- package/dist/components/stream/xyPlugins/stackedAreaPlugin.d.ts +2 -0
- package/dist/components/stream/xyPlugins/swarmPlugin.d.ts +2 -0
- package/dist/components/stream/xyPlugins/waterfallPlugin.d.ts +2 -0
- package/dist/components/stream/xySceneBuilders/ribbonScene.d.ts +1 -1
- package/dist/components/stream/xySceneBuilders/types.d.ts +1 -0
- package/dist/components/text/annotationTextLayout.d.ts +28 -0
- package/dist/components/text/pretextAnnotationLayout.d.ts +29 -0
- package/dist/components/text/usePretextAnnotations.d.ts +12 -0
- package/dist/controls.module.min.js +1 -1
- package/dist/forceLayoutWorker.js +1 -1
- package/dist/geo.min.js +1 -1
- package/dist/geo.module.min.js +1 -1
- package/dist/network.module.min.js +1 -1
- package/dist/ordinal.module.min.js +1 -1
- package/dist/physics-matter.min.js +1 -1
- package/dist/physics-matter.module.min.js +1 -1
- package/dist/physics-rapier.min.js +1 -1
- package/dist/physics-rapier.module.min.js +1 -1
- package/dist/physics.module.min.js +1 -1
- package/dist/physicsWorker.js +1 -1
- package/dist/processSankeyLayoutWorker.js +1 -1
- package/dist/rough.min.js +1 -1
- package/dist/rough.module.min.js +1 -1
- package/dist/semiotic-access.d.ts +9 -0
- package/dist/semiotic-access.min.js +2 -0
- package/dist/semiotic-access.module.min.js +2 -0
- package/dist/semiotic-ai-artifact-policy-constants.module.min.js +2 -0
- package/dist/semiotic-ai-core.d.ts +38 -18
- package/dist/semiotic-ai-core.min.js +1 -1
- package/dist/semiotic-ai-core.module.min.js +1 -1
- package/dist/semiotic-ai-hash-primitives.module.min.js +2 -0
- package/dist/semiotic-ai.d.ts +20 -20
- package/dist/semiotic-ai.module.min.js +1 -1
- package/dist/semiotic-artifact-react.d.ts +10 -0
- package/dist/semiotic-artifact-react.min.js +2 -0
- package/dist/semiotic-artifact-react.module.min.js +2 -0
- package/dist/semiotic-artifact.d.ts +23 -0
- package/dist/semiotic-artifact.min.js +1 -0
- package/dist/semiotic-artifact.module.min.js +1 -0
- package/dist/semiotic-client-cjs-shared.min.js +1 -1
- package/dist/semiotic-client-glyph.module.min.js +1 -1
- package/dist/semiotic-client-responsive.module.min.js +1 -1
- package/dist/semiotic-client-shared.module.min.js +1 -1
- package/dist/semiotic-custom-layout-selection-cjs-shared.min.js +1 -1
- package/dist/semiotic-data.min.js +1 -1
- package/dist/semiotic-data.module.min.js +1 -1
- package/dist/semiotic-evidence.d.ts +10 -0
- package/dist/semiotic-evidence.min.js +1 -0
- package/dist/semiotic-evidence.module.min.js +1 -0
- package/dist/semiotic-experimental-auxiliary.module.min.js +1 -1
- package/dist/semiotic-experimental-node-auxiliary.module.min.js +1 -1
- package/dist/semiotic-experimental-react-shared.module.min.js +1 -1
- package/dist/semiotic-experimental-vacp.min.js +1 -1
- package/dist/semiotic-experimental-vacp.module.min.js +1 -1
- package/dist/semiotic-experimental.d.ts +1 -1
- package/dist/semiotic-line.d.ts +9 -0
- package/dist/semiotic-line.min.js +2 -0
- package/dist/semiotic-line.module.min.js +2 -0
- package/dist/semiotic-network.d.ts +3 -0
- package/dist/semiotic-ordinal.d.ts +2 -0
- package/dist/semiotic-physics.d.ts +4 -4
- package/dist/semiotic-realtime-core.d.ts +3 -2
- package/dist/semiotic-realtime-core.module.min.js +1 -1
- package/dist/semiotic-realtime-react.module.min.js +1 -1
- package/dist/semiotic-recipes-core-cjs-base.min.js +1 -1
- package/dist/semiotic-recipes-core.d.ts +6 -0
- package/dist/semiotic-recipes-core.module.min.js +1 -1
- package/dist/semiotic-recipes-geo-cjs.min.js +1 -1
- package/dist/semiotic-recipes-react.min.js +1 -1
- package/dist/semiotic-server-edge-node.module.min.js +1 -1
- package/dist/semiotic-server-edge.min.js +1 -1
- package/dist/semiotic-server-edge.module.min.js +1 -1
- package/dist/semiotic-server-node.min.js +1 -1
- package/dist/semiotic-server-node.module.min.js +1 -1
- package/dist/semiotic-text.d.ts +2 -0
- package/dist/semiotic-text.min.js +2 -0
- package/dist/semiotic-text.module.min.js +2 -0
- package/dist/semiotic-themes-core.d.ts +3 -0
- package/dist/semiotic-themes-core.min.js +1 -1
- package/dist/semiotic-themes-core.module.min.js +1 -1
- package/dist/semiotic-themes.min.js +1 -1
- package/dist/semiotic-themes.module.min.js +1 -1
- package/dist/semiotic-utils-core.d.ts +19 -14
- package/dist/semiotic-utils-core.min.js +1 -1
- package/dist/semiotic-utils-core.module.min.js +1 -1
- package/dist/semiotic-value.module.min.js +1 -1
- package/dist/semiotic-xy.d.ts +3 -0
- package/dist/semiotic.d.ts +11 -5
- package/dist/semiotic.module.min.js +1 -1
- package/dist/server.min.js +1 -1
- package/dist/server.module.min.js +1 -1
- package/dist/xy.module.min.js +1 -1
- package/package.json +91 -71
- package/spec/README.md +8 -3
- package/spec/v0.1/artifact-contract.schema.json +2299 -0
- package/spec/v0.1/examples/artifact-contract-full.json +369 -0
- package/spec/v0.1/examples/artifact-contract-unknown-state.json +46 -0
- package/dist/c-3BLJEQNG.min.js +0 -1
- package/dist/c-3KZD6AXJ.min.js +0 -1
- package/dist/c-4TWEX5HG.min.js +0 -1
- package/dist/c-52TEGIUJ.min.js +0 -1
- package/dist/c-5YCIX3VZ.min.js +0 -1
- package/dist/c-6FEKTA3U.min.js +0 -1
- package/dist/c-6O5EVOPH.min.js +0 -1
- package/dist/c-74HEEZGK.min.js +0 -1
- package/dist/c-AKAF6JAD.min.js +0 -1
- package/dist/c-BBKITSXB.min.js +0 -1
- package/dist/c-BWNB6USU.min.js +0 -1
- package/dist/c-C25ENHIK.min.js +0 -1
- package/dist/c-CDR5AO3R.min.js +0 -1
- package/dist/c-COHXCW3Q.min.js +0 -1
- package/dist/c-DADXPJXV.min.js +0 -1
- package/dist/c-E3JFRRMI.min.js +0 -1
- package/dist/c-EBFPQHHO.min.js +0 -1
- package/dist/c-G36WS6LN.min.js +0 -1
- package/dist/c-GGISSW5E.min.js +0 -1
- package/dist/c-GIKRQI4X.min.js +0 -1
- package/dist/c-GPYOFETM.min.js +0 -1
- package/dist/c-IDUHYYSI.min.js +0 -1
- package/dist/c-IUHFPMHD.min.js +0 -1
- package/dist/c-J5G56TUH.min.js +0 -1
- package/dist/c-JAZ73J32.min.js +0 -1
- package/dist/c-KG3NXHAL.min.js +0 -1
- package/dist/c-KII3PLZE.min.js +0 -1
- package/dist/c-LIXGXMNS.min.js +0 -1
- package/dist/c-LVEY6D6B.min.js +0 -1
- package/dist/c-M4Y3BHFR.min.js +0 -1
- package/dist/c-MAIICR2Z.min.js +0 -1
- package/dist/c-MG5DM6VE.min.js +0 -1
- package/dist/c-MNF2S4AA.min.js +0 -1
- package/dist/c-MT3WBK7M.min.js +0 -1
- package/dist/c-NY3JWV2K.min.js +0 -1
- package/dist/c-O6U6K4CW.min.js +0 -1
- package/dist/c-OQ7M4AGV.min.js +0 -1
- package/dist/c-OXYMVK7Q.min.js +0 -1
- package/dist/c-PPWDL5ZI.min.js +0 -1
- package/dist/c-QHF5YON3.min.js +0 -1
- package/dist/c-RR3GO5SW.min.js +0 -1
- package/dist/c-RSVIHIQ4.min.js +0 -1
- package/dist/c-S2BXNNJN.min.js +0 -1
- package/dist/c-S6U5CGT5.min.js +0 -1
- package/dist/c-SLGMUBUL.min.js +0 -1
- package/dist/c-SUILCHWU.min.js +0 -1
- package/dist/c-TZW3JGJ5.min.js +0 -1
- package/dist/c-US5ZFT6E.min.js +0 -1
- package/dist/c-USFMFKIH.min.js +0 -1
- package/dist/c-UUKVD4WB.min.js +0 -1
- package/dist/c-VGW3VG3I.min.js +0 -1
- package/dist/c-W3CE4A4S.min.js +0 -1
- package/dist/c-WJCD5EUY.min.js +0 -1
- package/dist/c-X5UBGU2V.min.js +0 -1
- package/dist/c-YDAY2WFR.min.js +0 -1
- package/dist/c-ZOWWU34K.min.js +0 -1
- /package/dist/{c-N4G2L7ID.min.js → c-HYW2XA4Q.min.js} +0 -0
- /package/dist/{c-OCI56QF2.min.js → c-V4XMSLC3.min.js} +0 -0
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
export type AestheticFeatureId = "mark-scaffold-hierarchy" | "palette-authorship" | "palette-economy" | "typographic-hierarchy" | "theme-coherence" | "editorial-emphasis";
|
|
2
|
+
export type AestheticFeatureWeights = Partial<Record<AestheticFeatureId, number>>;
|
|
3
|
+
export interface AestheticThresholds {
|
|
4
|
+
/** Minimum data-mark contrast relative to scaffold contrast. Default 2. */
|
|
5
|
+
hierarchyRatio?: number;
|
|
6
|
+
/** Lowest useful scaffold/background contrast. Default 1.1. */
|
|
7
|
+
scaffoldContrastMin?: number;
|
|
8
|
+
/** Highest subordinate scaffold/background contrast. Default 2. */
|
|
9
|
+
scaffoldContrastMax?: number;
|
|
10
|
+
/** Desired title-size / tick-size ratio. Default 1.25. */
|
|
11
|
+
titleScaleRatio?: number;
|
|
12
|
+
/** Maximum categorical colors before economy declines. Default 7. */
|
|
13
|
+
categoricalColorMax?: number;
|
|
14
|
+
/** Smallest authored focal share treated as deliberate. Default 0.05. */
|
|
15
|
+
emphasisRatioMin?: number;
|
|
16
|
+
/** Largest focal share treated as selective. Default 0.35. */
|
|
17
|
+
emphasisRatioMax?: number;
|
|
18
|
+
}
|
|
19
|
+
/**
|
|
20
|
+
* An organization's explicit, serializable policy for machine-visible
|
|
21
|
+
* presentation features. Values are priorities, not claims of universal taste.
|
|
22
|
+
* Set a weight to 0 to remove that feature from the score.
|
|
23
|
+
*/
|
|
24
|
+
export interface AestheticProfile {
|
|
25
|
+
/** Name surfaced in reports so a score always names whose taste it encodes. */
|
|
26
|
+
name?: string;
|
|
27
|
+
/** Non-negative relative importance per feature. */
|
|
28
|
+
weights?: AestheticFeatureWeights;
|
|
29
|
+
/** Optional boundary tuning for the measurable feature formulas. */
|
|
30
|
+
thresholds?: AestheticThresholds;
|
|
31
|
+
/** Organizational rationale surfaced beside a feature's measured evidence. */
|
|
32
|
+
rationales?: Partial<Record<AestheticFeatureId, string>>;
|
|
33
|
+
/** Weighted score needed for `ok: true`. Default 70. */
|
|
34
|
+
minimumScore?: number;
|
|
35
|
+
}
|
|
@@ -1,3 +1,5 @@
|
|
|
1
|
+
import { filterAnnotationsByStatus } from "../charts/shared/annotationStatusFilter";
|
|
2
|
+
export { filterAnnotationsByStatus };
|
|
1
3
|
/**
|
|
2
4
|
* Where an annotation came from and how confident we should be in it.
|
|
3
5
|
* Lives on `annotation.provenance`.
|
|
@@ -318,13 +320,6 @@ export interface AnnotationStatusTreatment extends AnnotationStatusVisibility {
|
|
|
318
320
|
*/
|
|
319
321
|
labelSuffix?: Partial<Record<AnnotationStatus, string>>;
|
|
320
322
|
}
|
|
321
|
-
/**
|
|
322
|
-
* Apply the default editorial visibility contract without changing annotation
|
|
323
|
-
* styling. Retracted notes and notes replaced by a present revision are hidden
|
|
324
|
-
* unless explicitly requested. Shared by visual treatment, chart descriptions,
|
|
325
|
-
* and navigation trees so they expose the same current set.
|
|
326
|
-
*/
|
|
327
|
-
export declare function filterAnnotationsByStatus<T>(annotations: ReadonlyArray<Annotated<T>>, options?: AnnotationStatusVisibility): Annotated<T>[];
|
|
328
323
|
/**
|
|
329
324
|
* Apply the editorial-status visual treatment (M7) — the orthogonal companion
|
|
330
325
|
* to {@link applyAnnotationLifecycle}'s temporal-freshness treatment. The two
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
export type VisualHierarchyStatus = "pass" | "warn" | "manual";
|
|
2
|
+
export interface VisualHierarchyInput {
|
|
3
|
+
/** The chart field's resolved solid background color. */
|
|
4
|
+
readonly backgroundColor: string;
|
|
5
|
+
/** Resolved colors used by the primary data marks. */
|
|
6
|
+
readonly dataColors: ReadonlyArray<string>;
|
|
7
|
+
/** Resolved color used by grids, guides, or other reference scaffolding. */
|
|
8
|
+
readonly scaffoldColor: string;
|
|
9
|
+
/** Scaffold opacity before compositing over the background. Default 1. */
|
|
10
|
+
readonly scaffoldOpacity?: number;
|
|
11
|
+
/** Minimum mark/scaffold contrast ratio. Default 2. */
|
|
12
|
+
readonly minimumHierarchyRatio?: number;
|
|
13
|
+
/** Lowest useful scaffold/background contrast. Default 1.1. */
|
|
14
|
+
readonly minimumScaffoldContrast?: number;
|
|
15
|
+
/** Highest subordinate scaffold/background contrast. Default 2. */
|
|
16
|
+
readonly maximumScaffoldContrast?: number;
|
|
17
|
+
}
|
|
18
|
+
export interface VisualHierarchyFinding {
|
|
19
|
+
readonly code: "SCAFFOLD_DOMINANCE" | "SCAFFOLD_VISIBILITY" | "VISUAL_HIERARCHY_MANUAL";
|
|
20
|
+
readonly status: VisualHierarchyStatus;
|
|
21
|
+
readonly message: string;
|
|
22
|
+
readonly fix?: string;
|
|
23
|
+
}
|
|
24
|
+
export interface VisualHierarchyAuditResult {
|
|
25
|
+
readonly ok: boolean;
|
|
26
|
+
readonly status: VisualHierarchyStatus;
|
|
27
|
+
readonly finding: VisualHierarchyFinding;
|
|
28
|
+
readonly evidence?: {
|
|
29
|
+
readonly weakestDataContrast: number;
|
|
30
|
+
readonly scaffoldContrast: number;
|
|
31
|
+
readonly hierarchyRatio: number;
|
|
32
|
+
};
|
|
33
|
+
readonly method: "mark-to-scaffold-contrast";
|
|
34
|
+
}
|
|
35
|
+
/**
|
|
36
|
+
* Audit one intentionally narrow presentation boundary: primary data marks
|
|
37
|
+
* should lead and reference scaffolding should recede.
|
|
38
|
+
*
|
|
39
|
+
* This is deliberately not a universal beauty score. Aesthetic preferences
|
|
40
|
+
* vary, but research supports bounding grids to a visible-yet-unobtrusive
|
|
41
|
+
* range rather than claiming an ideal style:
|
|
42
|
+
* https://www.tableau.com/research/publications/whisper-dont-scream-grids-and-transparency
|
|
43
|
+
*
|
|
44
|
+
* The guardrail combines familiar non-text contrast (data marks >= 3:1) with
|
|
45
|
+
* a conservative scaffold ceiling (<= 2:1) and requires the marks to carry at
|
|
46
|
+
* least twice the scaffold's contrast. These are Semiotic lint boundaries,
|
|
47
|
+
* not thresholds reported verbatim by that study.
|
|
48
|
+
*/
|
|
49
|
+
export declare function auditVisualHierarchy(input: VisualHierarchyInput): VisualHierarchyAuditResult;
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
export { ChartRecipe } from "./ChartRecipe";
|
|
2
|
+
export type { ChartRecipeProps } from "./ChartRecipe";
|
|
3
|
+
export { BUILT_IN_CHART_RECIPES, CALENDAR_HEATMAP_CONFIG_SCHEMA, CALENDAR_HEATMAP_LAYOUT_ID, CALENDAR_HEATMAP_RECIPE_ID, PARALLEL_COORDINATES_CONFIG_SCHEMA, PARALLEL_COORDINATES_LAYOUT_ID, PARALLEL_COORDINATES_RECIPE_ID, calendarHeatmapRecipe, parallelCoordinatesRecipe, registerBuiltInChartRecipeManifests, } from "./builtInChartRecipes";
|
|
4
|
+
export { registerBuiltInChartRecipeLayouts } from "./builtInChartRecipeLayouts";
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
import type { Datum } from "../charts/shared/datumTypes";
|
|
2
|
+
import { type ChartRecipe, type SerializableSchema } from "./chartRecipes";
|
|
3
|
+
export declare const PARALLEL_COORDINATES_RECIPE_ID = "ParallelCoordinatesRecipe";
|
|
4
|
+
export declare const CALENDAR_HEATMAP_RECIPE_ID = "CalendarHeatmapRecipe";
|
|
5
|
+
export declare const PARALLEL_COORDINATES_LAYOUT_ID = "semiotic.parallel-coordinates";
|
|
6
|
+
export declare const CALENDAR_HEATMAP_LAYOUT_ID = "semiotic.calendar-heatmap";
|
|
7
|
+
export declare const PARALLEL_COORDINATES_CONFIG_SCHEMA: SerializableSchema;
|
|
8
|
+
export declare const CALENDAR_HEATMAP_CONFIG_SCHEMA: SerializableSchema;
|
|
9
|
+
export declare const parallelCoordinatesRecipe: ChartRecipe<Datum, Record<string, unknown>>;
|
|
10
|
+
export declare const calendarHeatmapRecipe: ChartRecipe<Datum, Record<string, unknown>>;
|
|
11
|
+
export declare const BUILT_IN_CHART_RECIPES: readonly [ChartRecipe<Datum, Record<string, unknown>>, ChartRecipe<Datum, Record<string, unknown>>];
|
|
12
|
+
export declare function registerBuiltInChartRecipeManifests(): void;
|
|
13
|
+
interface RecipeSchemaFunction {
|
|
14
|
+
name: string;
|
|
15
|
+
description: string;
|
|
16
|
+
parameters: SerializableSchema;
|
|
17
|
+
"x-semiotic-kind": "recipe";
|
|
18
|
+
"x-semiotic-renderer": "ChartRecipe";
|
|
19
|
+
"x-semiotic-layout": ChartRecipe["layout"];
|
|
20
|
+
}
|
|
21
|
+
export interface BuiltInRecipeSchemaTool {
|
|
22
|
+
type: "function";
|
|
23
|
+
function: RecipeSchemaFunction;
|
|
24
|
+
}
|
|
25
|
+
export declare function generateBuiltInRecipeSchemaTools(): BuiltInRecipeSchemaTool[];
|
|
26
|
+
export {};
|
|
@@ -12,6 +12,7 @@ import { MinimapChartCapability } from "../charts/xy/MinimapChart.capability";
|
|
|
12
12
|
import { DifferenceChartCapability } from "../charts/xy/DifferenceChart.capability";
|
|
13
13
|
import { CandlestickChartCapability } from "../charts/xy/CandlestickChart.capability";
|
|
14
14
|
import { HeatmapCapability } from "../charts/xy/Heatmap.capability";
|
|
15
|
+
import { WaterfallChartCapability } from "../charts/xy/WaterfallChart.capability";
|
|
15
16
|
import { BarChartCapability } from "../charts/ordinal/BarChart.capability";
|
|
16
17
|
import { GroupedBarChartCapability } from "../charts/ordinal/GroupedBarChart.capability";
|
|
17
18
|
import { StackedBarChartCapability } from "../charts/ordinal/StackedBarChart.capability";
|
|
@@ -19,6 +20,7 @@ import { DotPlotCapability } from "../charts/ordinal/DotPlot.capability";
|
|
|
19
20
|
import { PieChartCapability } from "../charts/ordinal/PieChart.capability";
|
|
20
21
|
import { DonutChartCapability } from "../charts/ordinal/DonutChart.capability";
|
|
21
22
|
import { FunnelChartCapability } from "../charts/ordinal/FunnelChart.capability";
|
|
23
|
+
import { RadarChartCapability } from "../charts/ordinal/RadarChart.capability";
|
|
22
24
|
import { GaugeChartCapability } from "../charts/ordinal/GaugeChart.capability";
|
|
23
25
|
import { LikertChartCapability } from "../charts/ordinal/LikertChart.capability";
|
|
24
26
|
import { SwimlaneChartCapability } from "../charts/ordinal/SwimlaneChart.capability";
|
|
@@ -62,4 +64,4 @@ export declare function unregisterChartCapability(component: string): void;
|
|
|
62
64
|
export declare function getCapabilities(): ReadonlyArray<ChartCapability>;
|
|
63
65
|
/** Look up a capability by component name. */
|
|
64
66
|
export declare function getCapability(component: string): ChartCapability | undefined;
|
|
65
|
-
export { LineChartCapability, AreaChartCapability, BumpChartCapability, StackedAreaChartCapability, ScatterplotCapability, ConnectedScatterplotCapability, BubbleChartCapability, QuadrantChartCapability, MultiAxisLineChartCapability, MinimapChartCapability, DifferenceChartCapability, CandlestickChartCapability, HeatmapCapability, BarChartCapability, GroupedBarChartCapability, StackedBarChartCapability, DotPlotCapability, PieChartCapability, DonutChartCapability, FunnelChartCapability, GaugeChartCapability, LikertChartCapability, SwimlaneChartCapability, HistogramCapability, BoxPlotCapability, SwarmPlotCapability, ViolinPlotCapability, RidgelinePlotCapability, ForceDirectedGraphCapability, SankeyDiagramCapability, ChordDiagramCapability, ProcessSankeyCapability, TreeDiagramCapability, TreemapCapability, CirclePackCapability, OrbitDiagramCapability, ChoroplethMapCapability, ProportionalSymbolMapCapability, FlowMapCapability, DistanceCartogramCapability, GaltonBoardChartCapability, EventDropChartCapability, UnitPileChartCapability, CollisionSwarmChartCapability, PacketFlowChartCapability, ProcessFlowChartCapability, GauntletChartCapability, CrucibleChartCapability, ChainReactionChartCapability };
|
|
67
|
+
export { LineChartCapability, AreaChartCapability, BumpChartCapability, StackedAreaChartCapability, ScatterplotCapability, ConnectedScatterplotCapability, BubbleChartCapability, QuadrantChartCapability, MultiAxisLineChartCapability, MinimapChartCapability, DifferenceChartCapability, CandlestickChartCapability, HeatmapCapability, WaterfallChartCapability, BarChartCapability, GroupedBarChartCapability, StackedBarChartCapability, DotPlotCapability, PieChartCapability, DonutChartCapability, FunnelChartCapability, RadarChartCapability, GaugeChartCapability, LikertChartCapability, SwimlaneChartCapability, HistogramCapability, BoxPlotCapability, SwarmPlotCapability, ViolinPlotCapability, RidgelinePlotCapability, ForceDirectedGraphCapability, SankeyDiagramCapability, ChordDiagramCapability, ProcessSankeyCapability, TreeDiagramCapability, TreemapCapability, CirclePackCapability, OrbitDiagramCapability, ChoroplethMapCapability, ProportionalSymbolMapCapability, FlowMapCapability, DistanceCartogramCapability, GaltonBoardChartCapability, EventDropChartCapability, UnitPileChartCapability, CollisionSwarmChartCapability, PacketFlowChartCapability, ProcessFlowChartCapability, GauntletChartCapability, CrucibleChartCapability, ChainReactionChartCapability };
|
|
@@ -1,5 +1,10 @@
|
|
|
1
1
|
import type { ChartCapability } from "./chartCapabilityTypes";
|
|
2
|
+
import type { Datum } from "../charts/shared/datumTypes";
|
|
2
3
|
import type { ChartRecipe, CustomLayoutFunction } from "./chartRecipes";
|
|
4
|
+
export interface RecipeLayoutIdentity {
|
|
5
|
+
version: string;
|
|
6
|
+
fingerprint?: string;
|
|
7
|
+
}
|
|
3
8
|
/** Register or replace a named recipe and its capability adapter. */
|
|
4
9
|
export declare function registerChartRecipe(recipe: ChartRecipe): void;
|
|
5
10
|
export declare function unregisterChartRecipe(recipeId: string): void;
|
|
@@ -8,7 +13,8 @@ export declare function listChartRecipes(): ChartRecipe[];
|
|
|
8
13
|
export declare function getRegisteredRecipeCapabilities(): ReadonlyArray<ChartCapability>;
|
|
9
14
|
export declare function hasRegisteredRecipeCapabilities(): boolean;
|
|
10
15
|
/** Register a known runtime implementation used by portable recipe manifests. */
|
|
11
|
-
export declare function registerRecipeLayout(layoutId: string, layout: CustomLayoutFunction): void;
|
|
16
|
+
export declare function registerRecipeLayout<TDatum extends Datum = Datum, TConfig extends object = Record<string, unknown>>(layoutId: string, layout: CustomLayoutFunction<TDatum, TConfig>, identity?: RecipeLayoutIdentity): void;
|
|
12
17
|
export declare function unregisterRecipeLayout(layoutId: string): void;
|
|
13
18
|
export declare function getRecipeLayout(layoutId: string): CustomLayoutFunction | undefined;
|
|
19
|
+
export declare function getRecipeLayoutIdentity(layoutId: string): RecipeLayoutIdentity | undefined;
|
|
14
20
|
export declare function resolveChartRecipe(value: unknown): ChartRecipe | undefined;
|
|
@@ -35,6 +35,10 @@ export type CustomLayoutFunction<TDatum extends Datum = Datum, TConfig extends o
|
|
|
35
35
|
*/
|
|
36
36
|
export interface RegisteredRecipeLayout {
|
|
37
37
|
id: string;
|
|
38
|
+
/** Stable executable-layout version used by portable config handoffs. */
|
|
39
|
+
version?: string;
|
|
40
|
+
/** Optional package- or author-supplied content identity. */
|
|
41
|
+
fingerprint?: string;
|
|
38
42
|
importPath?: string;
|
|
39
43
|
exportName?: string;
|
|
40
44
|
}
|
|
@@ -51,6 +55,12 @@ export interface DataRoleDefinition {
|
|
|
51
55
|
description?: string;
|
|
52
56
|
/** Which input collection owns the field for multi-table/network/geo recipes. */
|
|
53
57
|
source?: "data" | "nodes" | "edges" | "areas" | "points" | "lines" | string;
|
|
58
|
+
/** Resolve this role to an ordered field list instead of one field. */
|
|
59
|
+
multiple?: boolean;
|
|
60
|
+
/** Minimum number of resolved fields required for a multi-field role. */
|
|
61
|
+
minimum?: number;
|
|
62
|
+
/** Maximum number of fields emitted for a multi-field role. */
|
|
63
|
+
maximum?: number;
|
|
54
64
|
}
|
|
55
65
|
export type EncodingChannel = "position" | "count" | "color" | "size" | "shape" | "length" | "area" | "angle" | "connection" | "order" | "texture" | "motion" | "label" | string;
|
|
56
66
|
export interface EncodingDefinition {
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
export interface ColorEvidenceRGBA {
|
|
2
|
+
readonly r: number;
|
|
3
|
+
readonly g: number;
|
|
4
|
+
readonly b: number;
|
|
5
|
+
readonly a: number;
|
|
6
|
+
}
|
|
7
|
+
/** Parse the deterministic solid-color subset accepted by theme tokens. */
|
|
8
|
+
export declare function parseColorEvidence(value: unknown): ColorEvidenceRGBA | null;
|
|
9
|
+
export declare function compositeColorEvidence(foreground: ColorEvidenceRGBA, background: ColorEvidenceRGBA): ColorEvidenceRGBA | null;
|
|
10
|
+
export declare function colorEvidenceToHex(color: ColorEvidenceRGBA): string | null;
|
|
11
|
+
/** Canonical identity for authored/theme vocabulary comparisons. */
|
|
12
|
+
export declare function canonicalColorEvidence(value: unknown): string | undefined;
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
import type { Datum } from "../charts/shared/datumTypes";
|
|
2
|
+
import type { DescribeLevel } from "./describeChart";
|
|
3
|
+
import type { describePhysicsSource } from "./describePhysicsSource";
|
|
4
|
+
interface PhysicsProjectionRow {
|
|
5
|
+
label: string;
|
|
6
|
+
count: number;
|
|
7
|
+
secondary?: number;
|
|
8
|
+
secondaryLabel?: string;
|
|
9
|
+
observed?: number;
|
|
10
|
+
}
|
|
11
|
+
export declare function physicsProjectionRows(props: Datum, fmtNum: (n: number) => string): PhysicsProjectionRow[] | null;
|
|
12
|
+
export declare function applyPhysicsLevels(component: string, kind: string, rows: PhysicsProjectionRow[] | null, levels: {
|
|
13
|
+
l1?: string;
|
|
14
|
+
l2?: string;
|
|
15
|
+
l3?: string;
|
|
16
|
+
l4?: string;
|
|
17
|
+
}, want: Set<DescribeLevel>, fmtNum: (n: number) => string, source?: ReturnType<typeof describePhysicsSource>): void;
|
|
18
|
+
export {};
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import type { Datum } from "../charts/shared/datumTypes";
|
|
2
|
+
type SourceProjectionRow = {
|
|
3
|
+
label: string;
|
|
4
|
+
value: number;
|
|
5
|
+
secondary?: number;
|
|
6
|
+
secondaryLabel?: string;
|
|
7
|
+
};
|
|
8
|
+
/** Source statistics only: no world allocation, stepping, or implied process completion. */
|
|
9
|
+
export declare function describePhysicsSource(component: string, props: Datum): {
|
|
10
|
+
rows: SourceProjectionRow[];
|
|
11
|
+
generated: boolean;
|
|
12
|
+
} | null;
|
|
13
|
+
export {};
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
import type { Datum } from "../charts/shared/datumTypes";
|
|
2
|
+
import type { SemioticTheme } from "../store/themeCore";
|
|
3
|
+
import type { AestheticFeatureId, AestheticProfile, AestheticThresholds } from "./aestheticProfileTypes";
|
|
4
|
+
export type AestheticFeatureStatus = "pass" | "warn" | "manual" | "disabled";
|
|
5
|
+
export interface AestheticFeatureResult {
|
|
6
|
+
readonly id: AestheticFeatureId;
|
|
7
|
+
readonly label: string;
|
|
8
|
+
readonly status: AestheticFeatureStatus;
|
|
9
|
+
/** Normalized machine evidence score from 0..1. */
|
|
10
|
+
readonly score: number;
|
|
11
|
+
/** Resolved organizational importance. Zero disables the feature. */
|
|
12
|
+
readonly weight: number;
|
|
13
|
+
/** `score * weight`, retained so the aggregate is fully reconstructable. */
|
|
14
|
+
readonly contribution: number;
|
|
15
|
+
readonly message: string;
|
|
16
|
+
readonly rationale?: string;
|
|
17
|
+
readonly evidence: Readonly<Record<string, string | number | boolean>>;
|
|
18
|
+
}
|
|
19
|
+
export interface EvaluateAestheticsOptions {
|
|
20
|
+
/** Resolved chart theme. Its `aesthetics` profile is used unless `profile` overrides it. */
|
|
21
|
+
readonly theme?: SemioticTheme;
|
|
22
|
+
/** One-off policy override; useful for comparing organizational profiles. */
|
|
23
|
+
readonly profile?: AestheticProfile;
|
|
24
|
+
}
|
|
25
|
+
export interface AestheticEvaluationResult {
|
|
26
|
+
readonly component: string;
|
|
27
|
+
readonly profile: string;
|
|
28
|
+
readonly ok: boolean;
|
|
29
|
+
/** Weighted 0..100 result, or null when every feature weight is zero. */
|
|
30
|
+
readonly score: number | null;
|
|
31
|
+
readonly minimumScore: number;
|
|
32
|
+
readonly weightedPoints: number;
|
|
33
|
+
readonly totalWeight: number;
|
|
34
|
+
readonly features: ReadonlyArray<AestheticFeatureResult>;
|
|
35
|
+
readonly method: "weighted-machine-visible-features";
|
|
36
|
+
}
|
|
37
|
+
export declare const DEFAULT_AESTHETIC_WEIGHTS: Readonly<Record<AestheticFeatureId, number>>;
|
|
38
|
+
export declare const DEFAULT_AESTHETIC_THRESHOLDS: Readonly<Required<AestheticThresholds>>;
|
|
39
|
+
export declare const DEFAULT_AESTHETIC_PROFILE: Readonly<AestheticProfile>;
|
|
40
|
+
export declare const AESTHETICS_OFF_PROFILE: Readonly<AestheticProfile>;
|
|
41
|
+
/**
|
|
42
|
+
* Evaluate the machine-visible portion of an organization's aesthetic policy.
|
|
43
|
+
* The aggregate is a transparent weighted quality function, not a universal
|
|
44
|
+
* beauty prediction. Human validation can be collected separately with a
|
|
45
|
+
* validated instrument such as BeauVis.
|
|
46
|
+
*/
|
|
47
|
+
export declare function evaluateAesthetics(component: string, props: Datum, options?: EvaluateAestheticsOptions): AestheticEvaluationResult;
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
import type { Datum } from "../charts/shared/datumTypes";
|
|
2
|
+
import type { NavTreeNode } from "./navigationTree";
|
|
3
|
+
/** Build region/value and route/location readings for geographic charts. */
|
|
4
|
+
export declare function buildGeoNavigationTree(component: string, props: Datum, maxLeaves: number, fmtNum: (number: number) => string): NavTreeNode;
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
import type { Datum } from "../charts/shared/datumTypes";
|
|
2
|
+
import type { NavTreeNode } from "./navigationTree";
|
|
3
|
+
/** Build the authored parent/child reading used by hierarchy chart navigation. */
|
|
4
|
+
export declare function buildHierarchyNavigationTree(component: string, props: Datum, maxLeaves: number, fmtNum: (number: number) => string): NavTreeNode;
|
|
@@ -23,7 +23,7 @@ export interface NavTreeNode {
|
|
|
23
23
|
level: number;
|
|
24
24
|
/** Measure value, for datum leaves. */
|
|
25
25
|
value?: number;
|
|
26
|
-
/** Raw datum
|
|
26
|
+
/** Raw authored datum for any actionable mark node, including hierarchy parents. */
|
|
27
27
|
datum?: Datum | null;
|
|
28
28
|
children?: NavTreeNode[];
|
|
29
29
|
}
|
|
@@ -34,6 +34,12 @@ export interface BuildNavigationTreeOptions {
|
|
|
34
34
|
/** Explicit recipe; otherwise props/registry dispatch is used. */
|
|
35
35
|
recipe?: ChartRecipe;
|
|
36
36
|
}
|
|
37
|
+
/**
|
|
38
|
+
* Whether the runtime navigation builder owns a datum-level structure for the
|
|
39
|
+
* supplied chart. This is the authoritative capability check used by
|
|
40
|
+
* ChartAccessContract; callers should not maintain a parallel chart-name set.
|
|
41
|
+
*/
|
|
42
|
+
export declare function supportsStructuredNavigation(component: string, props?: Datum, options?: Pick<BuildNavigationTreeOptions, "recipe">): boolean;
|
|
37
43
|
/**
|
|
38
44
|
* Build a structured navigation tree for a chart config. Full trees for XY,
|
|
39
45
|
* bar, part-to-whole, distribution, network, hierarchy, and geo families;
|
|
@@ -1,2 +1,10 @@
|
|
|
1
1
|
import type { ScorecardFixture } from "./qualityScorecard";
|
|
2
|
+
/**
|
|
3
|
+
* Semiotic's internal deterministic recommendation benchmark corpus.
|
|
4
|
+
*
|
|
5
|
+
* @deprecated This test corpus remains exported from `semiotic/ai` for 3.x
|
|
6
|
+
* compatibility, but application and evaluation code should own its
|
|
7
|
+
* `ScorecardFixture` inputs. It is intentionally absent from
|
|
8
|
+
* `semiotic/ai/core` and is planned for removal from the public API in 4.0.
|
|
9
|
+
*/
|
|
2
10
|
export declare const CANONICAL_FIXTURES: ReadonlyArray<ScorecardFixture>;
|
|
@@ -9,7 +9,7 @@
|
|
|
9
9
|
* common defaults that otherwise tend to leak across component families.
|
|
10
10
|
*/
|
|
11
11
|
export interface SuggestionPropContract {
|
|
12
|
-
readonly componentKind: "chart-hoc" | "value-component";
|
|
12
|
+
readonly componentKind: "chart-hoc" | "chart-recipe" | "value-component";
|
|
13
13
|
readonly commonChartProps: "supported" | "component-specific";
|
|
14
14
|
readonly headingProp: string;
|
|
15
15
|
readonly modeValues: ReadonlyArray<string>;
|
|
@@ -21,7 +21,7 @@ import type { Datum } from "../charts/shared/datumTypes";
|
|
|
21
21
|
export interface UseNavigationSyncOptions {
|
|
22
22
|
/** The navigation tree (from `buildNavigationTree`). */
|
|
23
23
|
tree: NavTreeNode;
|
|
24
|
-
/** `chartId` set on the chart, so its hover/click can be matched back to a
|
|
24
|
+
/** `chartId` set on the chart, so its hover/click can be matched back to a semantic node. */
|
|
25
25
|
chartId?: string;
|
|
26
26
|
/**
|
|
27
27
|
* Fields that identify a datum for highlighting + matching. Defaults to the
|
|
@@ -64,12 +64,12 @@ export interface UseNavigationSyncResult {
|
|
|
64
64
|
onObservation: (observation: ChartObservation) => void;
|
|
65
65
|
/** Alias of `onObservation` for composing an externally supplied handler. */
|
|
66
66
|
handleObservation: (observation: ChartObservation) => void;
|
|
67
|
-
/** Nav-tree
|
|
67
|
+
/** Nav-tree datum-node ids that an annotation anchors to — mark these as "has a note". */
|
|
68
68
|
annotatedIds: Set<string>;
|
|
69
69
|
/**
|
|
70
70
|
* Move the tree (and canvas highlight) to an annotation's anchored node.
|
|
71
71
|
* Accepts an annotation object or its index in `annotations`. Returns `true`
|
|
72
|
-
* if the anchor resolved to a
|
|
72
|
+
* if the anchor resolved to a datum node. The reader lands on the anchor.
|
|
73
73
|
*/
|
|
74
74
|
focusAnnotation: (annotation: Datum | number) => boolean;
|
|
75
75
|
}
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
import type { ComponentPropsWithoutRef } from "react";
|
|
2
|
+
import type { ArtifactContract } from "./types";
|
|
3
|
+
import { type ArtifactInspectorEvaluation } from "./artifactInspectorSummary";
|
|
4
|
+
export type ArtifactInspectorSection = "details" | "claims" | "evidence" | "time" | "history" | "alternatives" | "policy" | "machine";
|
|
5
|
+
export interface ArtifactInspectorProps extends Omit<ComponentPropsWithoutRef<"section">, "children"> {
|
|
6
|
+
/** Complete interpretation sidecar to inspect. */
|
|
7
|
+
contract: ArtifactContract;
|
|
8
|
+
/** Optional result from `evaluateArtifact`; absence is shown as unknown. */
|
|
9
|
+
evaluation?: ArtifactInspectorEvaluation;
|
|
10
|
+
/** Accessible heading for the surface. */
|
|
11
|
+
title?: string;
|
|
12
|
+
/** Heading depth used when embedding the inspector in a page. */
|
|
13
|
+
headingLevel?: 2 | 3 | 4 | 5 | 6;
|
|
14
|
+
/** Controlled native disclosure state. Omit to let each `details` element manage itself. */
|
|
15
|
+
expandedSections?: ReadonlyArray<ArtifactInspectorSection>;
|
|
16
|
+
/** Observe disclosure changes for analytics or controlled hosts. */
|
|
17
|
+
onDisclosureChange?: (section: ArtifactInspectorSection, expanded: boolean) => void;
|
|
18
|
+
}
|
|
19
|
+
/**
|
|
20
|
+
* Accessible, progressively disclosed view of an artifact contract.
|
|
21
|
+
*
|
|
22
|
+
* The always-visible summary distinguishes verified signals from unknown and
|
|
23
|
+
* manual-review states. Native `details` elements keep the deeper contract and
|
|
24
|
+
* evaluation readable without requiring JavaScript-managed disclosure state.
|
|
25
|
+
*/
|
|
26
|
+
export declare function ArtifactInspector({ contract, evaluation, title, headingLevel, expandedSections, onDisclosureChange, className, ...sectionProps }: ArtifactInspectorProps): import("react").JSX.Element;
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
import type { ReactEventHandler } from "react";
|
|
2
|
+
import type { ArtifactContract } from "./types";
|
|
3
|
+
import type { ArtifactInspectorEvaluation } from "./artifactInspectorSummary";
|
|
4
|
+
interface DisclosureSectionProps {
|
|
5
|
+
contract: ArtifactContract;
|
|
6
|
+
open: boolean | undefined;
|
|
7
|
+
onToggle: ReactEventHandler<HTMLDetailsElement> | undefined;
|
|
8
|
+
}
|
|
9
|
+
interface TimeSectionProps extends DisclosureSectionProps {
|
|
10
|
+
fallbackLabel: string;
|
|
11
|
+
}
|
|
12
|
+
export declare function ArtifactInspectorTimeSection({ contract, fallbackLabel, open, onToggle }: TimeSectionProps): import("react").JSX.Element;
|
|
13
|
+
export declare function ArtifactInspectorHistorySection({ contract, open, onToggle }: DisclosureSectionProps): import("react").JSX.Element;
|
|
14
|
+
interface AlternativesSectionProps extends DisclosureSectionProps {
|
|
15
|
+
evaluation: ArtifactInspectorEvaluation | undefined;
|
|
16
|
+
}
|
|
17
|
+
export declare function ArtifactInspectorAlternativesSection({ contract, evaluation, open, onToggle }: AlternativesSectionProps): import("react").JSX.Element;
|
|
18
|
+
export {};
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
import type { ArtifactContract } from "./types";
|
|
2
|
+
export interface ArtifactContractChange {
|
|
3
|
+
path: string;
|
|
4
|
+
kind: "added" | "removed" | "changed";
|
|
5
|
+
before?: unknown;
|
|
6
|
+
after?: unknown;
|
|
7
|
+
}
|
|
8
|
+
export declare function diffArtifactContracts(before: ArtifactContract, after: ArtifactContract): ArtifactContractChange[];
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
import type { ArtifactContract, ObligationResult } from "./types";
|
|
2
|
+
export type ArtifactInspectorOutcome = "acceptable" | "conditional" | "refuse" | "unknown";
|
|
3
|
+
/** The evaluation fields consumed by the inspector. Full evaluations fit this shape. */
|
|
4
|
+
export interface ArtifactInspectorEvaluation {
|
|
5
|
+
status: "acceptable" | "conditional" | "refuse";
|
|
6
|
+
policy: {
|
|
7
|
+
id: string;
|
|
8
|
+
version: string;
|
|
9
|
+
};
|
|
10
|
+
obligations: ReadonlyArray<ObligationResult>;
|
|
11
|
+
manualChecks?: ReadonlyArray<string>;
|
|
12
|
+
alternatives?: ReadonlyArray<{
|
|
13
|
+
id: string;
|
|
14
|
+
label: string;
|
|
15
|
+
reasons?: ReadonlyArray<string>;
|
|
16
|
+
caveats?: ReadonlyArray<string>;
|
|
17
|
+
}>;
|
|
18
|
+
}
|
|
19
|
+
export interface ArtifactInspectionSummary {
|
|
20
|
+
outcome: ArtifactInspectorOutcome;
|
|
21
|
+
outcomeLabel: string;
|
|
22
|
+
time: {
|
|
23
|
+
status: string;
|
|
24
|
+
label: string;
|
|
25
|
+
};
|
|
26
|
+
claims: {
|
|
27
|
+
total: number;
|
|
28
|
+
active: number;
|
|
29
|
+
supported: number;
|
|
30
|
+
unresolved: number;
|
|
31
|
+
};
|
|
32
|
+
evidence: {
|
|
33
|
+
total: number;
|
|
34
|
+
referenced: number;
|
|
35
|
+
unreferenced: number;
|
|
36
|
+
missingReferences: number;
|
|
37
|
+
};
|
|
38
|
+
policy: {
|
|
39
|
+
status: "known" | "unknown";
|
|
40
|
+
label: string;
|
|
41
|
+
};
|
|
42
|
+
review: {
|
|
43
|
+
status: "required" | "clear" | "unknown";
|
|
44
|
+
count: number;
|
|
45
|
+
items: string[];
|
|
46
|
+
};
|
|
47
|
+
unknowns: {
|
|
48
|
+
count: number;
|
|
49
|
+
items: string[];
|
|
50
|
+
};
|
|
51
|
+
}
|
|
52
|
+
/** Build the concise, deterministic signals rendered above the disclosures. */
|
|
53
|
+
export declare function summarizeArtifactInspection(contract: ArtifactContract, evaluation?: ArtifactInspectorEvaluation): ArtifactInspectionSummary;
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
import type { Datum } from "../charts/shared/datumTypes";
|
|
2
|
+
import { type ArtifactGrounding, type BuildArtifactGroundingOptions } from "./grounding";
|
|
3
|
+
import type { ArtifactEvaluation, EvaluateArtifactOptions } from "./evaluateArtifactTypes";
|
|
4
|
+
import type { ArtifactContract, Claim, CorrectionRecord, EvidenceRef, ReceptionChannel, TemporalContext } from "./types";
|
|
5
|
+
export type ArtifactClaimTransition = {
|
|
6
|
+
action: "supersede";
|
|
7
|
+
previousClaimId: string;
|
|
8
|
+
replacement: Claim;
|
|
9
|
+
correction: Omit<CorrectionRecord, "affectedClaimIds" | "replacementClaimIds">;
|
|
10
|
+
} | {
|
|
11
|
+
action: "retract";
|
|
12
|
+
claimId: string;
|
|
13
|
+
correction: Omit<CorrectionRecord, "affectedClaimIds" | "replacementClaimIds">;
|
|
14
|
+
};
|
|
15
|
+
export interface ArtifactRevisionPresentation {
|
|
16
|
+
title?: string;
|
|
17
|
+
description?: string;
|
|
18
|
+
summary?: string;
|
|
19
|
+
}
|
|
20
|
+
export interface PrepareArtifactRevisionOptions extends Omit<EvaluateArtifactOptions, "data"> {
|
|
21
|
+
/** Required stable revision label for the resulting artifact. */
|
|
22
|
+
revision: string;
|
|
23
|
+
/** Optional new artifact id; the prior id is retained in source lineage. */
|
|
24
|
+
artifactId?: string;
|
|
25
|
+
/** Explicit replacement for the primary `data` prop. */
|
|
26
|
+
data?: ReadonlyArray<Datum>;
|
|
27
|
+
/** Other configuration or data-bearing prop updates. */
|
|
28
|
+
propUpdates?: Datum;
|
|
29
|
+
/** Complete evidence ledger for the revised data and claims. */
|
|
30
|
+
evidence?: ReadonlyArray<EvidenceRef>;
|
|
31
|
+
/** Temporal changes applied together with claims and presentation text. */
|
|
32
|
+
time: TemporalContext;
|
|
33
|
+
presentation?: ArtifactRevisionPresentation;
|
|
34
|
+
claimTransitions?: ReadonlyArray<ArtifactClaimTransition>;
|
|
35
|
+
groundingChannels?: ReadonlyArray<ReceptionChannel>;
|
|
36
|
+
grounding?: Omit<BuildArtifactGroundingOptions, "channel">;
|
|
37
|
+
}
|
|
38
|
+
export interface PreparedArtifactRevision {
|
|
39
|
+
/** True only for an acceptable evaluation; conditional results need review. */
|
|
40
|
+
publishable: boolean;
|
|
41
|
+
component: string;
|
|
42
|
+
props: Datum;
|
|
43
|
+
contract: ArtifactContract;
|
|
44
|
+
evaluation: ArtifactEvaluation;
|
|
45
|
+
grounding: Partial<Record<ReceptionChannel, ArtifactGrounding>>;
|
|
46
|
+
changedClaimIds: string[];
|
|
47
|
+
}
|
|
48
|
+
/**
|
|
49
|
+
* Prepare one immutable artifact revision. Data, claims, visible text, time,
|
|
50
|
+
* identities, evaluation, and channel grounding all derive from the same
|
|
51
|
+
* snapshot. Conditional and refused results return `publishable: false`;
|
|
52
|
+
* this helper cannot discharge manual checks or authorize publication.
|
|
53
|
+
*/
|
|
54
|
+
export declare function prepareArtifactRevision(component: string, currentProps: Datum, currentContract: ArtifactContract, options: PrepareArtifactRevisionOptions): PreparedArtifactRevision;
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import type { ArtifactContract, Claim } from "./types";
|
|
2
|
+
export declare const rows: {
|
|
3
|
+
month: number;
|
|
4
|
+
value: number;
|
|
5
|
+
}[];
|
|
6
|
+
export declare const props: {
|
|
7
|
+
data: {
|
|
8
|
+
month: number;
|
|
9
|
+
value: number;
|
|
10
|
+
}[];
|
|
11
|
+
xAccessor: string;
|
|
12
|
+
yAccessor: string;
|
|
13
|
+
title: string;
|
|
14
|
+
description: string;
|
|
15
|
+
summary: string;
|
|
16
|
+
};
|
|
17
|
+
export declare function contractWithClaim(id?: string, claim?: Partial<Claim>): ArtifactContract;
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import type { ArtifactIdentityBinding } from "./identity";
|
|
2
|
+
import type { ArtifactTransferStatus } from "./serialization";
|
|
3
|
+
export interface ArtifactAttachmentIssue {
|
|
4
|
+
id: string;
|
|
5
|
+
status: "fail" | "unknown";
|
|
6
|
+
message: string;
|
|
7
|
+
}
|
|
8
|
+
/** Shared judgments for identity and transfer reports attached to evidence. */
|
|
9
|
+
export declare function artifactAttachmentIssues(attachment: {
|
|
10
|
+
contract?: unknown;
|
|
11
|
+
transfer?: ArtifactTransferStatus;
|
|
12
|
+
binding?: ArtifactIdentityBinding;
|
|
13
|
+
}): ArtifactAttachmentIssue[];
|
|
@@ -0,0 +1,3 @@
|
|
|
1
|
+
import type { ArtifactContract, ObligationResult } from "./types";
|
|
2
|
+
/** Audit correction references and their corresponding claim lifecycle states. */
|
|
3
|
+
export declare function auditClaimCorrections(contract: Pick<ArtifactContract, "claims" | "contestability">): ObligationResult[];
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
import type { Claim, EvidenceRef } from "./types";
|
|
2
|
+
export declare function supersessionCycles(claims: ReadonlyArray<Claim>): string[][];
|
|
3
|
+
export declare function transformationCycles(evidence: ReadonlyArray<EvidenceRef>): string[][];
|
|
4
|
+
export declare function evidenceUsedByClaims(claims: ReadonlyArray<Claim>, evidenceById: ReadonlyMap<string, EvidenceRef>): Set<string>;
|
|
5
|
+
export declare function hasIndependentEvidenceBasis(ids: ReadonlyArray<string>, evidenceById: ReadonlyMap<string, EvidenceRef>, active?: Set<string>): boolean;
|