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.
Files changed (566) hide show
  1. package/README.md +137 -58
  2. package/agent-skill/semiotic-charts/SKILL.md +27 -17
  3. package/ai/artifact-contract-reference.md +408 -0
  4. package/ai/artifact-surface-inventory.json +5586 -0
  5. package/ai/behaviorContracts.cjs +24 -2
  6. package/ai/cli.js +480 -56
  7. package/ai/componentMetadata.cjs +13 -3
  8. package/ai/dist/mcp-server.js +140 -36407
  9. package/ai/examples.md +110 -7
  10. package/ai/reference.md +82 -28
  11. package/ai/schema.json +7675 -1471
  12. package/ai/surface-manifest.json +60 -9
  13. package/ai/system-prompt.md +18 -3
  14. package/ai/task-packets/compare-category-totals.json +301 -0
  15. package/ai/task-packets/compare-category-totals.md +188 -0
  16. package/ai/task-packets/correct-published-chart.json +271 -0
  17. package/ai/task-packets/correct-published-chart.md +597 -0
  18. package/ai/task-packets/index.json +40 -0
  19. package/ai/task-packets/update-live-chart.json +289 -0
  20. package/ai/task-packets/update-live-chart.md +424 -0
  21. package/dist/c-2N7IU2NY.min.js +1 -0
  22. package/dist/c-2WK7YJLL.min.js +1 -0
  23. package/dist/c-33QOXEUG.min.js +1 -0
  24. package/dist/c-42PLDTX7.min.js +1 -0
  25. package/dist/c-447VIMRO.min.js +1 -0
  26. package/dist/c-4FN7Q6VQ.min.js +1 -0
  27. package/dist/c-553QUDKA.min.js +1 -0
  28. package/dist/c-55BAJ333.min.js +1 -0
  29. package/dist/c-7242NXSG.min.js +1 -0
  30. package/dist/c-7EGHJU2F.min.js +1 -0
  31. package/dist/c-7HP7MB2I.min.js +1 -0
  32. package/dist/c-7NBU5ZKS.min.js +1 -0
  33. package/dist/c-AFBSWT77.min.js +1 -0
  34. package/dist/c-AJ7EC32V.min.js +1 -0
  35. package/dist/c-AQADQNY7.min.js +1 -0
  36. package/dist/c-ATM475SA.min.js +1 -0
  37. package/dist/c-AVO3Q7T7.min.js +1 -0
  38. package/dist/c-AZKPVBOC.min.js +1 -0
  39. package/dist/c-BNFJMDHN.min.js +1 -0
  40. package/dist/c-BNG5ECK5.min.js +1 -0
  41. package/dist/c-BOHCQILI.min.js +1 -0
  42. package/dist/c-CCTGN5CK.min.js +1 -0
  43. package/dist/c-CPSPZH6A.min.js +1 -0
  44. package/dist/c-CPV4N35K.min.js +1 -0
  45. package/dist/c-D6HAAPTX.min.js +1 -0
  46. package/dist/c-DE5Q3U2X.min.js +1 -0
  47. package/dist/c-DK662R77.min.js +1 -0
  48. package/dist/c-DY2676CR.min.js +1 -0
  49. package/dist/c-E32M6XW5.min.js +1 -0
  50. package/dist/c-E4JDJH4I.min.js +1 -0
  51. package/dist/c-E7I2L7CU.min.js +1 -0
  52. package/dist/c-EBOQ7ER7.min.js +1 -0
  53. package/dist/c-ELDWAO2V.min.js +1 -0
  54. package/dist/c-EUBTECGM.min.js +1 -0
  55. package/dist/c-GNTXRXRN.min.js +1 -0
  56. package/dist/c-GSZRZRD6.min.js +1 -0
  57. package/dist/c-GWX7JGMF.min.js +1 -0
  58. package/dist/c-GXV3C3MO.min.js +1 -0
  59. package/dist/c-HHTK2R75.min.js +1 -0
  60. package/dist/c-HLLFJYTY.min.js +1 -0
  61. package/dist/c-HPOYKCCG.min.js +1 -0
  62. package/dist/c-HXDKPIKR.min.js +1 -0
  63. package/dist/c-I4QJ6YLM.min.js +1 -0
  64. package/dist/c-IDJV3CZK.min.js +1 -0
  65. package/dist/c-ITKX3RC5.min.js +1 -0
  66. package/dist/c-JG2JCQLP.min.js +1 -0
  67. package/dist/c-JLGRHXGZ.min.js +1 -0
  68. package/dist/c-JO2UGTCP.min.js +1 -0
  69. package/dist/c-JUKIWTBJ.min.js +1 -0
  70. package/dist/c-KCRJGUHP.min.js +1 -0
  71. package/dist/c-LMGSSD2E.min.js +1 -0
  72. package/dist/c-LYQMZMZQ.min.js +1 -0
  73. package/dist/c-LYVKDBQJ.min.js +1 -0
  74. package/dist/c-MVR3RWF3.min.js +1 -0
  75. package/dist/c-MXCP7GNZ.min.js +1 -0
  76. package/dist/c-NG7BLZTR.min.js +1 -0
  77. package/dist/c-NYZ2QNAM.min.js +1 -0
  78. package/dist/c-OO5QLMJC.min.js +1 -0
  79. package/dist/c-OOVX2JPQ.min.js +1 -0
  80. package/dist/c-ORLEBW72.min.js +1 -0
  81. package/dist/c-P65V6HLO.min.js +1 -0
  82. package/dist/c-PP6VY3QU.min.js +1 -0
  83. package/dist/c-PRIKOLTE.min.js +1 -0
  84. package/dist/c-PSNI6KAZ.min.js +1 -0
  85. package/dist/c-PYNW54D2.min.js +1 -0
  86. package/dist/c-QA3HMQJP.min.js +1 -0
  87. package/dist/c-QAVFOEUY.min.js +1 -0
  88. package/dist/c-ROEHCIGV.min.js +1 -0
  89. package/dist/c-S3AZX5PP.min.js +1 -0
  90. package/dist/c-T2V7O2LO.min.js +1 -0
  91. package/dist/c-TIXX5CAU.min.js +1 -0
  92. package/dist/c-TKG2NP7G.min.js +1 -0
  93. package/dist/c-VJTDST2R.min.js +1 -0
  94. package/dist/c-VXLOLYTO.min.js +1 -0
  95. package/dist/c-W4ZUKSEQ.min.js +1 -0
  96. package/dist/c-WH2O53VI.min.js +1 -0
  97. package/dist/c-WNGH47HF.min.js +1 -0
  98. package/dist/c-WUWXGQYA.min.js +1 -0
  99. package/dist/c-XDQKXPX4.min.js +1 -0
  100. package/dist/c-XSB27XPS.min.js +1 -0
  101. package/dist/c-YDECTEUW.min.js +1 -0
  102. package/dist/c-YF3YKVQI.min.js +1 -0
  103. package/dist/c-YLZIV3VS.min.js +1 -0
  104. package/dist/c-ZYPXQF7B.min.js +1 -0
  105. package/dist/components/Annotation.d.ts +3 -2
  106. package/dist/components/access/chartAccessCapabilities.generated.d.ts +14 -0
  107. package/dist/components/access/chartAccessContract.d.ts +90 -0
  108. package/dist/components/access/chartAccessContractFixtures.d.ts +11 -0
  109. package/dist/components/ai/aestheticProfileTypes.d.ts +35 -0
  110. package/dist/components/ai/annotationProvenance.d.ts +2 -7
  111. package/dist/components/ai/auditVisualHierarchy.d.ts +49 -0
  112. package/dist/components/ai/builtInChartRecipeLayouts.d.ts +2 -0
  113. package/dist/components/ai/builtInChartRecipePublic.d.ts +4 -0
  114. package/dist/components/ai/builtInChartRecipes.d.ts +26 -0
  115. package/dist/components/ai/chartCapabilities.d.ts +3 -1
  116. package/dist/components/ai/chartRecipeRegistry.d.ts +7 -1
  117. package/dist/components/ai/chartRecipes.d.ts +10 -0
  118. package/dist/components/ai/colorEvidence.d.ts +12 -0
  119. package/dist/components/ai/describePhysicsProjection.d.ts +18 -0
  120. package/dist/components/ai/describePhysicsSource.d.ts +13 -0
  121. package/dist/components/ai/evaluateAesthetics.d.ts +47 -0
  122. package/dist/components/ai/geoNavigation.d.ts +4 -0
  123. package/dist/components/ai/hierarchyNavigation.d.ts +4 -0
  124. package/dist/components/ai/navigationTree.d.ts +7 -1
  125. package/dist/components/ai/qualityFixtures.d.ts +8 -0
  126. package/dist/components/ai/suggestionPropContracts.d.ts +1 -1
  127. package/dist/components/ai/useNavigationSync.d.ts +3 -3
  128. package/dist/components/artifact/ArtifactInspector.d.ts +26 -0
  129. package/dist/components/artifact/ArtifactInspectorContextSections.d.ts +18 -0
  130. package/dist/components/artifact/artifactContractDiff.d.ts +8 -0
  131. package/dist/components/artifact/artifactInspectorSummary.d.ts +53 -0
  132. package/dist/components/artifact/artifactRevision.d.ts +54 -0
  133. package/dist/components/artifact/artifactTestFixtures.d.ts +17 -0
  134. package/dist/components/artifact/attachmentAudit.d.ts +13 -0
  135. package/dist/components/artifact/claimCorrections.d.ts +3 -0
  136. package/dist/components/artifact/claimGraph.d.ts +5 -0
  137. package/dist/components/artifact/claimLifecycle.d.ts +32 -0
  138. package/dist/components/artifact/claims.d.ts +24 -0
  139. package/dist/components/artifact/collection.d.ts +10 -0
  140. package/dist/components/artifact/collectionCorrectionScope.d.ts +4 -0
  141. package/dist/components/artifact/collectionImpact.d.ts +11 -0
  142. package/dist/components/artifact/collectionLineage.d.ts +3 -0
  143. package/dist/components/artifact/collectionOperations.d.ts +8 -0
  144. package/dist/components/artifact/collectionPolicy.d.ts +22 -0
  145. package/dist/components/artifact/collectionTypes.d.ts +117 -0
  146. package/dist/components/artifact/configurationRepair.d.ts +8 -0
  147. package/dist/components/artifact/contract.d.ts +30 -0
  148. package/dist/components/artifact/evaluateArtifact.d.ts +12 -0
  149. package/dist/components/artifact/evaluateArtifactTypes.d.ts +78 -0
  150. package/dist/components/artifact/evaluationPresentation.d.ts +9 -0
  151. package/dist/components/artifact/evidenceSample.d.ts +8 -0
  152. package/dist/components/artifact/exportPaths.d.ts +8 -0
  153. package/dist/components/artifact/fieldPolicies.d.ts +12 -0
  154. package/dist/components/artifact/fingerprint.d.ts +36 -0
  155. package/dist/components/artifact/grounding.d.ts +51 -0
  156. package/dist/components/artifact/groundingBudget.d.ts +38 -0
  157. package/dist/components/artifact/hostTransfer.d.ts +13 -0
  158. package/dist/components/artifact/identity.d.ts +19 -0
  159. package/dist/components/artifact/inheritance.d.ts +48 -0
  160. package/dist/components/artifact/inheritanceIntegrity.d.ts +3 -0
  161. package/dist/components/artifact/jsonCompatibility.d.ts +2 -0
  162. package/dist/components/artifact/obligations.d.ts +3 -0
  163. package/dist/components/artifact/policies.d.ts +45 -0
  164. package/dist/components/artifact/policyRelations.d.ts +3 -0
  165. package/dist/components/artifact/recordProjection.d.ts +7 -0
  166. package/dist/components/artifact/representation.d.ts +50 -0
  167. package/dist/components/artifact/serialization.d.ts +40 -0
  168. package/dist/components/artifact/temporal.d.ts +32 -0
  169. package/dist/components/artifact/temporalAdapters.d.ts +75 -0
  170. package/dist/components/artifact/temporalAuditHelpers.d.ts +12 -0
  171. package/dist/components/artifact/temporalPresentation.d.ts +8 -0
  172. package/dist/components/artifact/types.d.ts +341 -0
  173. package/dist/components/artifact/validation.d.ts +13 -0
  174. package/dist/components/artifact/validationFieldStatus.d.ts +7 -0
  175. package/dist/components/artifact/validationPrimitives.d.ts +24 -0
  176. package/dist/components/artifact/validationSurfaces.d.ts +7 -0
  177. package/dist/components/artifact/validationTemporal.d.ts +3 -0
  178. package/dist/components/charts/geo/FlowMap.d.ts +7 -0
  179. package/dist/components/charts/geo/flowMapLineStyle.d.ts +18 -0
  180. package/dist/components/charts/index.d.ts +4 -0
  181. package/dist/components/charts/network/ChordDiagram.d.ts +5 -1
  182. package/dist/components/charts/network/CirclePack.d.ts +8 -1
  183. package/dist/components/charts/network/OrbitDiagram.d.ts +9 -0
  184. package/dist/components/charts/network/TreeDiagram.d.ts +8 -1
  185. package/dist/components/charts/network/Treemap.d.ts +8 -1
  186. package/dist/components/charts/ordinal/BarChart.d.ts +6 -0
  187. package/dist/components/charts/ordinal/BoxPlot.d.ts +3 -0
  188. package/dist/components/charts/ordinal/DonutChart.d.ts +5 -0
  189. package/dist/components/charts/ordinal/DotPlot.d.ts +3 -0
  190. package/dist/components/charts/ordinal/FunnelChart.d.ts +5 -0
  191. package/dist/components/charts/ordinal/GaugeChart.d.ts +3 -0
  192. package/dist/components/charts/ordinal/GroupedBarChart.d.ts +6 -0
  193. package/dist/components/charts/ordinal/Histogram.d.ts +3 -0
  194. package/dist/components/charts/ordinal/LikertChart.d.ts +3 -0
  195. package/dist/components/charts/ordinal/PieChart.d.ts +5 -0
  196. package/dist/components/charts/ordinal/RadarChart.capability.d.ts +2 -0
  197. package/dist/components/charts/ordinal/RadarChart.d.ts +77 -0
  198. package/dist/components/charts/ordinal/RidgelinePlot.d.ts +3 -0
  199. package/dist/components/charts/ordinal/StackedBarChart.d.ts +6 -0
  200. package/dist/components/charts/ordinal/SwarmPlot.d.ts +3 -0
  201. package/dist/components/charts/ordinal/SwimlaneChart.d.ts +3 -0
  202. package/dist/components/charts/ordinal/ViolinPlot.d.ts +3 -0
  203. package/dist/components/charts/physics/CollisionSwarmChart.d.ts +1 -1
  204. package/dist/components/charts/physics/EventDropChart.d.ts +3 -1
  205. package/dist/components/charts/physics/GaltonBoardChart.d.ts +4 -2
  206. package/dist/components/charts/physics/GauntletChart.d.ts +1 -5
  207. package/dist/components/charts/physics/ProcessFlowChart.d.ts +6 -0
  208. package/dist/components/charts/physics/UnitPileChart.d.ts +2 -1
  209. package/dist/components/charts/physics/chainReactionTypes.d.ts +3 -0
  210. package/dist/components/charts/physics/collisionSwarmPacking.d.ts +14 -0
  211. package/dist/components/charts/physics/collisionSwarmPhysics.d.ts +1 -0
  212. package/dist/components/charts/physics/eventDropAdmission.d.ts +32 -0
  213. package/dist/components/charts/physics/eventDropPhysics.d.ts +22 -1
  214. package/dist/components/charts/physics/galtonBoardPhysics.d.ts +2 -9
  215. package/dist/components/charts/physics/gauntletPhysics.d.ts +1 -0
  216. package/dist/components/charts/physics/physicsChartReconcile.d.ts +4 -0
  217. package/dist/components/charts/physics/physicsChartUtils.d.ts +1 -1
  218. package/dist/components/charts/physics/physicsGaltonData.d.ts +10 -0
  219. package/dist/components/charts/physics/physicsHocHandle.d.ts +2 -0
  220. package/dist/components/charts/physics/physicsHocUtils.d.ts +7 -1
  221. package/dist/components/charts/physics/physicsPileData.d.ts +11 -0
  222. package/dist/components/charts/physics/physicsPilePhysics.d.ts +5 -12
  223. package/dist/components/charts/physics/physicsProjectionOverlays.d.ts +1 -1
  224. package/dist/components/charts/physics/physicsSourceRows.d.ts +8 -0
  225. package/dist/components/charts/physics/usePhysicsChartData.d.ts +19 -0
  226. package/dist/components/charts/realtime/RealtimeHeatmap.d.ts +14 -1
  227. package/dist/components/charts/realtime/RealtimeHistogram.d.ts +25 -7
  228. package/dist/components/charts/realtime/RealtimeLineChart.d.ts +18 -5
  229. package/dist/components/charts/realtime/RealtimeSwarmChart.d.ts +11 -1
  230. package/dist/components/charts/realtime/RealtimeWaterfallChart.d.ts +11 -1
  231. package/dist/components/charts/realtime/aggregate.d.ts +12 -1
  232. package/dist/components/charts/realtime/realtimeAccessors.d.ts +4 -0
  233. package/dist/components/charts/realtime/realtimeChartRuntime.d.ts +8 -5
  234. package/dist/components/charts/realtime/realtimeChartTypes.d.ts +7 -0
  235. package/dist/components/charts/realtime/realtimeStyleRules.d.ts +4 -0
  236. package/dist/components/charts/realtime/temporalHistogramConfig.d.ts +17 -11
  237. package/dist/components/charts/shared/GaugeReadout.d.ts +9 -0
  238. package/dist/components/charts/shared/ThresholdAnnotation.d.ts +18 -0
  239. package/dist/components/charts/shared/ThresholdEndCap.d.ts +7 -0
  240. package/dist/components/charts/shared/annotationStatusFilter.d.ts +18 -0
  241. package/dist/components/charts/shared/auditAccessibilityText.d.ts +4 -2
  242. package/dist/components/charts/shared/chartDefinitionPilot.d.ts +5 -4
  243. package/dist/components/charts/shared/chartSpecCore.d.ts +2 -2
  244. package/dist/components/charts/shared/heatmapStyleRules.d.ts +13 -0
  245. package/dist/components/charts/shared/knownChartComponents.d.ts +1 -1
  246. package/dist/components/charts/shared/networkUtils.d.ts +14 -0
  247. package/dist/components/charts/shared/numericTickFormatter.d.ts +2 -0
  248. package/dist/components/charts/shared/radialCenterContent.d.ts +10 -0
  249. package/dist/components/charts/shared/selectionUtils.d.ts +3 -1
  250. package/dist/components/charts/shared/tooltipUtils.d.ts +1 -1
  251. package/dist/components/charts/shared/types.d.ts +4 -2
  252. package/dist/components/charts/shared/useChartLegend.d.ts +6 -1
  253. package/dist/components/charts/shared/useLikertAggregation.d.ts +8 -2
  254. package/dist/components/charts/shared/useNetworkChartSetup.d.ts +9 -5
  255. package/dist/components/charts/shared/useOrdinalPieceStyle.d.ts +1 -1
  256. package/dist/components/charts/shared/useXYBrush.d.ts +24 -0
  257. package/dist/components/charts/shared/useXYPointStyle.d.ts +2 -0
  258. package/dist/components/charts/xy/BubbleChart.d.ts +7 -0
  259. package/dist/components/charts/xy/CandlestickChart.d.ts +7 -0
  260. package/dist/components/charts/xy/DifferenceChart.d.ts +7 -0
  261. package/dist/components/charts/xy/Heatmap.d.ts +16 -0
  262. package/dist/components/charts/xy/LineChart.d.ts +9 -0
  263. package/dist/components/charts/xy/MinimapChart.d.ts +7 -0
  264. package/dist/components/charts/xy/MultiAxisLineChart.d.ts +7 -0
  265. package/dist/components/charts/xy/Scatterplot.d.ts +7 -0
  266. package/dist/components/charts/xy/ScatterplotMatrix.d.ts +6 -0
  267. package/dist/components/charts/xy/WaterfallChart.capability.d.ts +2 -0
  268. package/dist/components/charts/xy/WaterfallChart.d.ts +76 -0
  269. package/dist/components/charts/xy/differenceMarkStyle.d.ts +28 -0
  270. package/dist/components/charts/xy/multiAxisFields.d.ts +23 -0
  271. package/dist/components/charts/xy/scatterplotMatrixCells.d.ts +50 -0
  272. package/dist/components/evidence/chartEvidenceEnvelope.d.ts +154 -0
  273. package/dist/components/evidence/evidenceEnvelopeInput.d.ts +8 -0
  274. package/dist/components/evidence/evidenceEnvelopeValidation.d.ts +11 -0
  275. package/dist/components/evidence/evidenceGate.d.ts +30 -0
  276. package/dist/components/evidence/renderedSceneHash.d.ts +23 -0
  277. package/dist/components/evidence/stableJsonHash.d.ts +4 -0
  278. package/dist/components/export/chartConfig.d.ts +40 -5
  279. package/dist/components/export/chartConfigArtifact.d.ts +6 -0
  280. package/dist/components/legendLayout.d.ts +18 -0
  281. package/dist/components/legendStyles.d.ts +4 -0
  282. package/dist/components/realtime/BinAccumulator.d.ts +5 -1
  283. package/dist/components/realtime/types.d.ts +16 -7
  284. package/dist/components/recipes/adjacencyFlow.d.ts +12 -0
  285. package/dist/components/recipes/adjacencyFlowAggregation.d.ts +72 -0
  286. package/dist/components/recipes/adjacencyFlowGeometry.d.ts +79 -0
  287. package/dist/components/recipes/firstAvailableTrack.d.ts +17 -0
  288. package/dist/components/recipes/intervals.d.ts +1 -1
  289. package/dist/components/recipes/lineageDag.d.ts +17 -0
  290. package/dist/components/recipes/lineageDagHulls.d.ts +22 -0
  291. package/dist/components/recipes/transitDiagram.d.ts +75 -0
  292. package/dist/components/recipes/transitDiagramGeometry.d.ts +47 -0
  293. package/dist/components/semiotic-access.d.ts +9 -0
  294. package/dist/components/semiotic-ai-audits.d.ts +17 -0
  295. package/dist/components/semiotic-ai-core.d.ts +38 -18
  296. package/dist/components/semiotic-ai.d.ts +20 -20
  297. package/dist/components/semiotic-artifact-react.d.ts +10 -0
  298. package/dist/components/semiotic-artifact.d.ts +23 -0
  299. package/dist/components/semiotic-evidence.d.ts +10 -0
  300. package/dist/components/semiotic-experimental.d.ts +1 -1
  301. package/dist/components/semiotic-line.d.ts +9 -0
  302. package/dist/components/semiotic-network.d.ts +3 -0
  303. package/dist/components/semiotic-ordinal.d.ts +2 -0
  304. package/dist/components/semiotic-physics.d.ts +4 -4
  305. package/dist/components/semiotic-realtime-core.d.ts +3 -2
  306. package/dist/components/semiotic-recipes-core.d.ts +6 -0
  307. package/dist/components/semiotic-text.d.ts +2 -0
  308. package/dist/components/semiotic-themes-core.d.ts +3 -0
  309. package/dist/components/semiotic-utils-core.d.ts +19 -14
  310. package/dist/components/semiotic-xy.d.ts +3 -0
  311. package/dist/components/semiotic.d.ts +11 -5
  312. package/dist/components/server/renderDashboard.d.ts +37 -0
  313. package/dist/components/server/renderEvidence.d.ts +39 -0
  314. package/dist/components/server/renderToStaticSVG.d.ts +5 -30
  315. package/dist/components/server/serverChartConfigShared.d.ts +13 -0
  316. package/dist/components/server/serverChartConfigs.d.ts +9 -0
  317. package/dist/components/server/serverChartConfigsComposite.d.ts +4 -0
  318. package/dist/components/server/serverChartConfigsCustom.d.ts +2 -0
  319. package/dist/components/server/serverChartConfigsGeo.d.ts +1 -0
  320. package/dist/components/server/serverChartConfigsOrdinal.d.ts +3 -2
  321. package/dist/components/server/serverChartConfigsXY.d.ts +1 -0
  322. package/dist/components/server/serverChartConfigsXYExtra.d.ts +3 -0
  323. package/dist/components/server/serverCompositeChainReaction.d.ts +3 -0
  324. package/dist/components/server/serverOrdinalGauge.d.ts +3 -0
  325. package/dist/components/server/serverOrdinalLikert.d.ts +2 -0
  326. package/dist/components/server/staticSVGChrome.d.ts +1 -4
  327. package/dist/components/server/staticXYAxisTicks.d.ts +2 -38
  328. package/dist/components/server/staticXYGrid.d.ts +1 -1
  329. package/dist/components/server/svgSizing.d.ts +6 -0
  330. package/dist/components/shared/svgRoot.d.ts +17 -0
  331. package/dist/components/store/selectionProvenance.d.ts +14 -0
  332. package/dist/components/store/themeCore.d.ts +5 -1
  333. package/dist/components/stream/GeoPipelineStore.d.ts +1 -1
  334. package/dist/components/stream/GeoSVGOverlay.d.ts +4 -0
  335. package/dist/components/stream/MarginalGraphics.d.ts +3 -3
  336. package/dist/components/stream/MarginalGraphicsLazy.d.ts +22 -0
  337. package/dist/components/stream/NetworkPipelineStore.d.ts +2 -0
  338. package/dist/components/stream/NetworkSVGOverlay.d.ts +4 -0
  339. package/dist/components/stream/OrdinalPipelineStore.d.ts +1 -1
  340. package/dist/components/stream/OrdinalSVGOverlay.d.ts +4 -0
  341. package/dist/components/stream/PipelineStore.d.ts +1 -1
  342. package/dist/components/stream/SVGOverlay.d.ts +4 -0
  343. package/dist/components/stream/SceneToSVG.d.ts +4 -19
  344. package/dist/components/stream/SceneToSVGXY.d.ts +13 -0
  345. package/dist/components/stream/StreamGeoFrame.d.ts +1 -2
  346. package/dist/components/stream/StreamOrdinalFrame.d.ts +1 -2
  347. package/dist/components/stream/XYGrid.d.ts +11 -0
  348. package/dist/components/stream/axisTickUtils.d.ts +0 -1
  349. package/dist/components/stream/canvasSetup.d.ts +8 -2
  350. package/dist/components/stream/customLayoutAttempt.d.ts +21 -0
  351. package/dist/components/stream/geoTypes.d.ts +1 -1
  352. package/dist/components/stream/hitTestUtils.d.ts +2 -0
  353. package/dist/components/stream/isServerEnvironment.d.ts +6 -0
  354. package/dist/components/stream/layouts/forceLayoutNodeSize.d.ts +12 -0
  355. package/dist/components/stream/layouts/forceLayoutPlugin.d.ts +2 -9
  356. package/dist/components/stream/layouts/forceLayoutWorkerClient.d.ts +2 -21
  357. package/dist/components/stream/layouts/forceLayoutWorkerPolicy.d.ts +21 -0
  358. package/dist/components/stream/layouts/index.d.ts +6 -12
  359. package/dist/components/stream/layouts/missingPlugin.d.ts +7 -0
  360. package/dist/components/stream/layouts/registerBuiltIn.d.ts +1 -0
  361. package/dist/components/stream/layouts/registry.d.ts +12 -0
  362. package/dist/components/stream/marginalConfig.d.ts +3 -0
  363. package/dist/components/stream/networkCustomLayout.d.ts +7 -0
  364. package/dist/components/stream/networkCustomLayoutOutput.d.ts +13 -0
  365. package/dist/components/stream/networkCustomLayoutRunner.d.ts +1 -1
  366. package/dist/components/stream/networkTypes.d.ts +5 -1
  367. package/dist/components/stream/ordinalTypes.d.ts +1 -1
  368. package/dist/components/stream/overlayAccessibleText.d.ts +18 -0
  369. package/dist/components/stream/physics/PhysicsControllers.d.ts +1 -1
  370. package/dist/components/stream/physics/PhysicsKernel.d.ts +9 -0
  371. package/dist/components/stream/physics/PhysicsPipelineStore.d.ts +5 -4
  372. package/dist/components/stream/physics/PhysicsPipelineTypes.d.ts +9 -0
  373. package/dist/components/stream/physics/StreamPhysicsTypes.d.ts +4 -1
  374. package/dist/components/stream/physics/physicsCanvasCoordinates.d.ts +5 -0
  375. package/dist/components/stream/physics/physicsFixedPosition.d.ts +16 -0
  376. package/dist/components/stream/physics/physicsKernelCloning.d.ts +6 -0
  377. package/dist/components/stream/physics/physicsPipelineObservations.d.ts +2 -0
  378. package/dist/components/stream/physics/physicsPipelineSettle.d.ts +15 -9
  379. package/dist/components/stream/physics/physicsRegionRuntime.d.ts +8 -17
  380. package/dist/components/stream/physics/physicsSemanticUI.d.ts +9 -0
  381. package/dist/components/stream/pipelineConfig.d.ts +4 -0
  382. package/dist/components/stream/pipelineDomainResolution.d.ts +6 -0
  383. package/dist/components/stream/pipelineStoreUpdateResults.d.ts +1 -1
  384. package/dist/components/stream/renderers/pointCanvasRenderer.d.ts +4 -0
  385. package/dist/components/stream/renderers/resolveCSSColor.d.ts +4 -4
  386. package/dist/components/stream/resolveXYAxes.d.ts +13 -0
  387. package/dist/components/stream/sceneToSVGShared.d.ts +2 -1
  388. package/dist/components/stream/seriesGeometry.d.ts +13 -0
  389. package/dist/components/stream/streamEncodingTypes.d.ts +53 -0
  390. package/dist/components/stream/types.d.ts +12 -54
  391. package/dist/components/stream/useEnsureCustomXYRenderers.d.ts +18 -0
  392. package/dist/components/stream/useGeoFrameHandle.d.ts +16 -0
  393. package/dist/components/stream/useMarginalValues.d.ts +13 -0
  394. package/dist/components/stream/useOrdinalFrameHandle.d.ts +15 -0
  395. package/dist/components/stream/useXYFrameHandle.d.ts +15 -0
  396. package/dist/components/stream/xyAxisTicks.d.ts +25 -0
  397. package/dist/components/stream/xyCanvasRenderers.d.ts +4 -4
  398. package/dist/components/stream/xyDateTicks.d.ts +3 -2
  399. package/dist/components/stream/xyFrameAxisTypes.d.ts +2 -0
  400. package/dist/components/stream/xyPlugins/areaPlugin.d.ts +2 -0
  401. package/dist/components/stream/xyPlugins/barPlugin.d.ts +2 -0
  402. package/dist/components/stream/xyPlugins/candlestickPlugin.d.ts +2 -0
  403. package/dist/components/stream/xyPlugins/customPlugin.d.ts +6 -0
  404. package/dist/components/stream/xyPlugins/heatmapPlugin.d.ts +2 -0
  405. package/dist/components/stream/xyPlugins/lineFamily.d.ts +5 -0
  406. package/dist/components/stream/xyPlugins/linePlugin.d.ts +2 -0
  407. package/dist/components/stream/xyPlugins/missingPlugin.d.ts +7 -0
  408. package/dist/components/stream/xyPlugins/mixedPlugin.d.ts +2 -0
  409. package/dist/components/stream/xyPlugins/pointPlugin.d.ts +3 -0
  410. package/dist/components/stream/xyPlugins/registerBuiltIn.d.ts +1 -0
  411. package/dist/components/stream/xyPlugins/registry.d.ts +31 -0
  412. package/dist/components/stream/xyPlugins/stackedAreaPlugin.d.ts +2 -0
  413. package/dist/components/stream/xyPlugins/swarmPlugin.d.ts +2 -0
  414. package/dist/components/stream/xyPlugins/waterfallPlugin.d.ts +2 -0
  415. package/dist/components/stream/xySceneBuilders/ribbonScene.d.ts +1 -1
  416. package/dist/components/stream/xySceneBuilders/types.d.ts +1 -0
  417. package/dist/components/text/annotationTextLayout.d.ts +28 -0
  418. package/dist/components/text/pretextAnnotationLayout.d.ts +29 -0
  419. package/dist/components/text/usePretextAnnotations.d.ts +12 -0
  420. package/dist/controls.module.min.js +1 -1
  421. package/dist/forceLayoutWorker.js +1 -1
  422. package/dist/geo.min.js +1 -1
  423. package/dist/geo.module.min.js +1 -1
  424. package/dist/network.module.min.js +1 -1
  425. package/dist/ordinal.module.min.js +1 -1
  426. package/dist/physics-matter.min.js +1 -1
  427. package/dist/physics-matter.module.min.js +1 -1
  428. package/dist/physics-rapier.min.js +1 -1
  429. package/dist/physics-rapier.module.min.js +1 -1
  430. package/dist/physics.module.min.js +1 -1
  431. package/dist/physicsWorker.js +1 -1
  432. package/dist/processSankeyLayoutWorker.js +1 -1
  433. package/dist/rough.min.js +1 -1
  434. package/dist/rough.module.min.js +1 -1
  435. package/dist/semiotic-access.d.ts +9 -0
  436. package/dist/semiotic-access.min.js +2 -0
  437. package/dist/semiotic-access.module.min.js +2 -0
  438. package/dist/semiotic-ai-artifact-policy-constants.module.min.js +2 -0
  439. package/dist/semiotic-ai-core.d.ts +38 -18
  440. package/dist/semiotic-ai-core.min.js +1 -1
  441. package/dist/semiotic-ai-core.module.min.js +1 -1
  442. package/dist/semiotic-ai-hash-primitives.module.min.js +2 -0
  443. package/dist/semiotic-ai.d.ts +20 -20
  444. package/dist/semiotic-ai.module.min.js +1 -1
  445. package/dist/semiotic-artifact-react.d.ts +10 -0
  446. package/dist/semiotic-artifact-react.min.js +2 -0
  447. package/dist/semiotic-artifact-react.module.min.js +2 -0
  448. package/dist/semiotic-artifact.d.ts +23 -0
  449. package/dist/semiotic-artifact.min.js +1 -0
  450. package/dist/semiotic-artifact.module.min.js +1 -0
  451. package/dist/semiotic-client-cjs-shared.min.js +1 -1
  452. package/dist/semiotic-client-glyph.module.min.js +1 -1
  453. package/dist/semiotic-client-responsive.module.min.js +1 -1
  454. package/dist/semiotic-client-shared.module.min.js +1 -1
  455. package/dist/semiotic-custom-layout-selection-cjs-shared.min.js +1 -1
  456. package/dist/semiotic-data.min.js +1 -1
  457. package/dist/semiotic-data.module.min.js +1 -1
  458. package/dist/semiotic-evidence.d.ts +10 -0
  459. package/dist/semiotic-evidence.min.js +1 -0
  460. package/dist/semiotic-evidence.module.min.js +1 -0
  461. package/dist/semiotic-experimental-auxiliary.module.min.js +1 -1
  462. package/dist/semiotic-experimental-node-auxiliary.module.min.js +1 -1
  463. package/dist/semiotic-experimental-react-shared.module.min.js +1 -1
  464. package/dist/semiotic-experimental-vacp.min.js +1 -1
  465. package/dist/semiotic-experimental-vacp.module.min.js +1 -1
  466. package/dist/semiotic-experimental.d.ts +1 -1
  467. package/dist/semiotic-line.d.ts +9 -0
  468. package/dist/semiotic-line.min.js +2 -0
  469. package/dist/semiotic-line.module.min.js +2 -0
  470. package/dist/semiotic-network.d.ts +3 -0
  471. package/dist/semiotic-ordinal.d.ts +2 -0
  472. package/dist/semiotic-physics.d.ts +4 -4
  473. package/dist/semiotic-realtime-core.d.ts +3 -2
  474. package/dist/semiotic-realtime-core.module.min.js +1 -1
  475. package/dist/semiotic-realtime-react.module.min.js +1 -1
  476. package/dist/semiotic-recipes-core-cjs-base.min.js +1 -1
  477. package/dist/semiotic-recipes-core.d.ts +6 -0
  478. package/dist/semiotic-recipes-core.module.min.js +1 -1
  479. package/dist/semiotic-recipes-geo-cjs.min.js +1 -1
  480. package/dist/semiotic-recipes-react.min.js +1 -1
  481. package/dist/semiotic-server-edge-node.module.min.js +1 -1
  482. package/dist/semiotic-server-edge.min.js +1 -1
  483. package/dist/semiotic-server-edge.module.min.js +1 -1
  484. package/dist/semiotic-server-node.min.js +1 -1
  485. package/dist/semiotic-server-node.module.min.js +1 -1
  486. package/dist/semiotic-text.d.ts +2 -0
  487. package/dist/semiotic-text.min.js +2 -0
  488. package/dist/semiotic-text.module.min.js +2 -0
  489. package/dist/semiotic-themes-core.d.ts +3 -0
  490. package/dist/semiotic-themes-core.min.js +1 -1
  491. package/dist/semiotic-themes-core.module.min.js +1 -1
  492. package/dist/semiotic-themes.min.js +1 -1
  493. package/dist/semiotic-themes.module.min.js +1 -1
  494. package/dist/semiotic-utils-core.d.ts +19 -14
  495. package/dist/semiotic-utils-core.min.js +1 -1
  496. package/dist/semiotic-utils-core.module.min.js +1 -1
  497. package/dist/semiotic-value.module.min.js +1 -1
  498. package/dist/semiotic-xy.d.ts +3 -0
  499. package/dist/semiotic.d.ts +11 -5
  500. package/dist/semiotic.module.min.js +1 -1
  501. package/dist/server.min.js +1 -1
  502. package/dist/server.module.min.js +1 -1
  503. package/dist/xy.module.min.js +1 -1
  504. package/package.json +91 -71
  505. package/spec/README.md +8 -3
  506. package/spec/v0.1/artifact-contract.schema.json +2299 -0
  507. package/spec/v0.1/examples/artifact-contract-full.json +369 -0
  508. package/spec/v0.1/examples/artifact-contract-unknown-state.json +46 -0
  509. package/dist/c-3BLJEQNG.min.js +0 -1
  510. package/dist/c-3KZD6AXJ.min.js +0 -1
  511. package/dist/c-4TWEX5HG.min.js +0 -1
  512. package/dist/c-52TEGIUJ.min.js +0 -1
  513. package/dist/c-5YCIX3VZ.min.js +0 -1
  514. package/dist/c-6FEKTA3U.min.js +0 -1
  515. package/dist/c-6O5EVOPH.min.js +0 -1
  516. package/dist/c-74HEEZGK.min.js +0 -1
  517. package/dist/c-AKAF6JAD.min.js +0 -1
  518. package/dist/c-BBKITSXB.min.js +0 -1
  519. package/dist/c-BWNB6USU.min.js +0 -1
  520. package/dist/c-C25ENHIK.min.js +0 -1
  521. package/dist/c-CDR5AO3R.min.js +0 -1
  522. package/dist/c-COHXCW3Q.min.js +0 -1
  523. package/dist/c-DADXPJXV.min.js +0 -1
  524. package/dist/c-E3JFRRMI.min.js +0 -1
  525. package/dist/c-EBFPQHHO.min.js +0 -1
  526. package/dist/c-G36WS6LN.min.js +0 -1
  527. package/dist/c-GGISSW5E.min.js +0 -1
  528. package/dist/c-GIKRQI4X.min.js +0 -1
  529. package/dist/c-GPYOFETM.min.js +0 -1
  530. package/dist/c-IDUHYYSI.min.js +0 -1
  531. package/dist/c-IUHFPMHD.min.js +0 -1
  532. package/dist/c-J5G56TUH.min.js +0 -1
  533. package/dist/c-JAZ73J32.min.js +0 -1
  534. package/dist/c-KG3NXHAL.min.js +0 -1
  535. package/dist/c-KII3PLZE.min.js +0 -1
  536. package/dist/c-LIXGXMNS.min.js +0 -1
  537. package/dist/c-LVEY6D6B.min.js +0 -1
  538. package/dist/c-M4Y3BHFR.min.js +0 -1
  539. package/dist/c-MAIICR2Z.min.js +0 -1
  540. package/dist/c-MG5DM6VE.min.js +0 -1
  541. package/dist/c-MNF2S4AA.min.js +0 -1
  542. package/dist/c-MT3WBK7M.min.js +0 -1
  543. package/dist/c-NY3JWV2K.min.js +0 -1
  544. package/dist/c-O6U6K4CW.min.js +0 -1
  545. package/dist/c-OQ7M4AGV.min.js +0 -1
  546. package/dist/c-OXYMVK7Q.min.js +0 -1
  547. package/dist/c-PPWDL5ZI.min.js +0 -1
  548. package/dist/c-QHF5YON3.min.js +0 -1
  549. package/dist/c-RR3GO5SW.min.js +0 -1
  550. package/dist/c-RSVIHIQ4.min.js +0 -1
  551. package/dist/c-S2BXNNJN.min.js +0 -1
  552. package/dist/c-S6U5CGT5.min.js +0 -1
  553. package/dist/c-SLGMUBUL.min.js +0 -1
  554. package/dist/c-SUILCHWU.min.js +0 -1
  555. package/dist/c-TZW3JGJ5.min.js +0 -1
  556. package/dist/c-US5ZFT6E.min.js +0 -1
  557. package/dist/c-USFMFKIH.min.js +0 -1
  558. package/dist/c-UUKVD4WB.min.js +0 -1
  559. package/dist/c-VGW3VG3I.min.js +0 -1
  560. package/dist/c-W3CE4A4S.min.js +0 -1
  561. package/dist/c-WJCD5EUY.min.js +0 -1
  562. package/dist/c-X5UBGU2V.min.js +0 -1
  563. package/dist/c-YDAY2WFR.min.js +0 -1
  564. package/dist/c-ZOWWU34K.min.js +0 -1
  565. /package/dist/{c-N4G2L7ID.min.js → c-HYW2XA4Q.min.js} +0 -0
  566. /package/dist/{c-OCI56QF2.min.js → c-V4XMSLC3.min.js} +0 -0
@@ -0,0 +1,45 @@
1
+ import type { ArtifactRelation, ArtifactStakes } from "./types";
2
+ export type BuiltInArtifactPolicyId = "exploratory" | "operational-streaming" | "editorial" | "public-civic" | "agent-generated";
3
+ export interface ArtifactPolicyRules {
4
+ /** Require at least one active (not superseded or retracted) claim. */
5
+ requireClaims: boolean;
6
+ requireEvidenceIdentity: boolean;
7
+ requireReviewForModelClaims: boolean;
8
+ /** Require evidence emitted by an actual renderer before release. */
9
+ requireRenderEvidence: boolean;
10
+ requireSettledTime: boolean;
11
+ requireFreshnessForLive: boolean;
12
+ refuseUnsupportedClaims: boolean;
13
+ refuseUnknownClaims: boolean;
14
+ refuseCriticalAccessibilityFailures: boolean;
15
+ refuseChartErrors: boolean;
16
+ refuseUnknownTime: boolean;
17
+ /** Allow conditional results with open manual checks, not automatic release. */
18
+ allowManualChecks: boolean;
19
+ allowExceptions: boolean;
20
+ }
21
+ export interface ArtifactPolicy {
22
+ id: BuiltInArtifactPolicyId | (string & {});
23
+ version: string;
24
+ label: string;
25
+ description: string;
26
+ minimumStakes?: ArtifactStakes;
27
+ rules: ArtifactPolicyRules;
28
+ requiredRelations: ArtifactRelation[];
29
+ }
30
+ export interface ArtifactPolicyException {
31
+ rule: keyof ArtifactPolicyRules | (string & {});
32
+ rationale: string;
33
+ owner: string;
34
+ expiresAt?: string;
35
+ reviewAt?: string;
36
+ }
37
+ /** Versioned, inspectable policy packs built only from deterministic evidence. */
38
+ export declare const ARTIFACT_POLICIES: Readonly<Record<BuiltInArtifactPolicyId, ArtifactPolicy>>;
39
+ export type ArtifactPolicyInput = BuiltInArtifactPolicyId | ArtifactPolicy | undefined;
40
+ export declare function resolveArtifactPolicy(policy: ArtifactPolicyInput): ArtifactPolicy;
41
+ export declare function activePolicyRules(policy: ArtifactPolicy, exceptions?: ReadonlyArray<ArtifactPolicyException>, now?: string): {
42
+ rules: ArtifactPolicyRules;
43
+ appliedExceptions: ArtifactPolicyException[];
44
+ rejectedExceptions: ArtifactPolicyException[];
45
+ };
@@ -0,0 +1,3 @@
1
+ import type { ArtifactContract, ArtifactRelation } from "./types";
2
+ export declare function hasActiveArtifactClaims(contract: ArtifactContract): boolean;
3
+ export declare function artifactDeclaresRelation(contract: ArtifactContract, relation: ArtifactRelation): boolean;
@@ -0,0 +1,7 @@
1
+ import type { Claim, EvidenceRef } from "./types";
2
+ export declare function projectContractRecords(claims: ReadonlyArray<Claim>, evidence: ReadonlyArray<EvidenceRef>, maxClaims: number, maxEvidence: number): {
3
+ claims: Claim[];
4
+ evidence: EvidenceRef[];
5
+ unresolvedClaims: boolean;
6
+ unresolvedEvidence: boolean;
7
+ };
@@ -0,0 +1,50 @@
1
+ import type { Datum } from "../charts/shared/datumTypes";
2
+ import type { AudienceProfile } from "../ai/audienceProfile";
3
+ import type { IntentId } from "../ai/intents";
4
+ import { type ArtifactPolicyException, type ArtifactPolicyInput } from "./policies";
5
+ import type { ArtifactContract } from "./types";
6
+ export type RepresentationKind = "chart" | "custom-recipe" | "table" | "text" | "small-multiples" | "collect-more-data" | "wait-for-settlement" | "no-comparison" | "no-claim" | "no-action";
7
+ export interface RepresentationCandidate {
8
+ id: string;
9
+ kind: RepresentationKind;
10
+ label: string;
11
+ component?: string;
12
+ props?: Record<string, unknown>;
13
+ score?: number;
14
+ reasons: string[];
15
+ caveats?: string[];
16
+ }
17
+ export interface RejectedRepresentation extends RepresentationCandidate {
18
+ rejectedBecause: string;
19
+ }
20
+ export interface RecommendRepresentationOptions {
21
+ policy?: ArtifactPolicyInput;
22
+ /** Accountable, time-bounded exceptions evaluated against the reference clock. */
23
+ exceptions?: ReadonlyArray<ArtifactPolicyException>;
24
+ /** Explicit reference clock for review, freshness, and expiry checks. */
25
+ now?: string;
26
+ intent?: IntentId | IntentId[];
27
+ audience?: AudienceProfile;
28
+ preferredComponent?: string;
29
+ maxChartCandidates?: number;
30
+ identifiers?: ReadonlyArray<string>;
31
+ }
32
+ export interface RepresentationRecommendation {
33
+ status: "recommended" | "conditional" | "refuse";
34
+ selected: RepresentationCandidate;
35
+ alternatives: RepresentationCandidate[];
36
+ rejected: RejectedRepresentation[];
37
+ policy: {
38
+ id: string;
39
+ version: string;
40
+ appliedExceptions?: ArtifactPolicyException[];
41
+ rejectedExceptions?: ArtifactPolicyException[];
42
+ };
43
+ reasons: string[];
44
+ }
45
+ /**
46
+ * Choose among charts and non-chart outcomes. Hard evidence and time gates run
47
+ * before chart scores, so a polished candidate cannot outweigh an unsupported
48
+ * comparison or an unsettled operational window.
49
+ */
50
+ export declare function recommendRepresentation(data: ReadonlyArray<Datum> | null | undefined, contract: ArtifactContract, options?: RecommendRepresentationOptions): RepresentationRecommendation;
@@ -0,0 +1,40 @@
1
+ import { ARTIFACT_CONTRACT_VERSION, type ArtifactContract, type JsonObject } from "./types";
2
+ export interface UnknownArtifactContract extends JsonObject {
3
+ contractVersion: string;
4
+ }
5
+ export type PortableArtifactContract = ArtifactContract | UnknownArtifactContract;
6
+ export interface ArtifactTransferStatus {
7
+ status: "preserved" | "unsupported-version" | "invalid" | "excluded";
8
+ omittedPaths: string[];
9
+ warnings: string[];
10
+ }
11
+ export interface SerializedArtifactContract {
12
+ contract?: PortableArtifactContract;
13
+ transfer: ArtifactTransferStatus;
14
+ }
15
+ export interface SerializeArtifactContractOptions {
16
+ /** Remove bounded evidence samples while preserving their identities. */
17
+ excludeEvidenceSamples?: boolean;
18
+ }
19
+ export interface ArtifactContractMigrationResult {
20
+ status: "current" | "unsupported-version" | "invalid";
21
+ fromVersion?: string;
22
+ toVersion: typeof ARTIFACT_CONTRACT_VERSION;
23
+ contract?: PortableArtifactContract;
24
+ changes: string[];
25
+ warnings: string[];
26
+ }
27
+ /**
28
+ * Clone an untrusted contract through deterministic JSON. Forward versions are
29
+ * cloned without interpreting unknown fields and clearly marked unsupported.
30
+ * Explicit evidence-sample exclusion remains privacy-first for every version.
31
+ */
32
+ export declare function serializeArtifactContract(value: unknown, options?: SerializeArtifactContractOptions): SerializedArtifactContract;
33
+ export declare function requireSerializableArtifactContract(value: ArtifactContract): SerializedArtifactContract & {
34
+ contract: ArtifactContract;
35
+ };
36
+ /**
37
+ * Version-aware migration entry point. Version 0.1 is already current;
38
+ * unknown versions are preserved but never guessed into a different shape.
39
+ */
40
+ export declare function migrateArtifactContract(value: unknown): ArtifactContractMigrationResult;
@@ -0,0 +1,32 @@
1
+ import type { Claim, CorrectionRecord, ObligationResult, ObligationSummary, TemporalContext } from "./types";
2
+ export * from "./temporalAdapters";
3
+ export { eventTimePresentationFinding } from "./temporalPresentation";
4
+ export interface TemporalAuditOptions {
5
+ /**
6
+ * Explicit instant used for expiry and age checks. The audit never reads the
7
+ * ambient clock, which keeps replay and server rendering deterministic.
8
+ */
9
+ referenceTime?: string;
10
+ /** Maximum permitted age of a quality result relative to `referenceTime`. */
11
+ maxQualityAgeMs?: number;
12
+ /** Claims included when checking whether a correction was propagated. */
13
+ claims?: ReadonlyArray<Claim>;
14
+ /** Correction records available for binding a revised temporal state. */
15
+ corrections?: ReadonlyArray<CorrectionRecord>;
16
+ /** Treat an unknown or unsettled window as a failed requirement. */
17
+ requireSettled?: boolean;
18
+ /** Treat missing, stale, or unsupported live freshness as a failure. */
19
+ requireFreshnessForLive?: boolean;
20
+ }
21
+ export interface TemporalAudit {
22
+ ok: boolean;
23
+ sources: number;
24
+ summary: ObligationSummary;
25
+ findings: ObligationResult[];
26
+ }
27
+ /**
28
+ * Audit whether temporal claims are explicit and internally coherent. This is
29
+ * structural evidence by default. Optional policy requirements can escalate
30
+ * missing freshness or settlement, while unknown states remain explicit.
31
+ */
32
+ export declare function auditTemporalContext(context: TemporalContext | undefined, options?: TemporalAuditOptions): TemporalAudit;
@@ -0,0 +1,75 @@
1
+ import type { TemporalContext, TimeField } from "./types";
2
+ export type TemporalFreshness = NonNullable<TemporalContext["freshness"]>;
3
+ export type TemporalCompleteness = NonNullable<TemporalContext["completeness"]>;
4
+ export type TemporalWatermark = NonNullable<TemporalContext["watermark"]>;
5
+ export type TemporalWindow = NonNullable<TemporalContext["window"]>;
6
+ export type TemporalRevision = NonNullable<TemporalContext["revision"]>;
7
+ export type TemporalPresentationState = NonNullable<NonNullable<TemporalContext["presentation"]>["state"]>;
8
+ export interface TemporalMetadataBase {
9
+ id: string;
10
+ label?: string;
11
+ version?: string;
12
+ timezone?: string;
13
+ granularity?: string;
14
+ freshness?: TemporalFreshness;
15
+ completeness?: TemporalCompleteness;
16
+ }
17
+ /** Vendor-neutral metadata for a live stream or topic. */
18
+ export interface StreamTopicMetadata extends TemporalMetadataBase {
19
+ eventTime?: TimeField;
20
+ observedAt?: string;
21
+ ingestedAt?: string;
22
+ watermark?: TemporalWatermark;
23
+ window?: TemporalWindow;
24
+ revision?: TemporalRevision;
25
+ presentationLabel?: string;
26
+ }
27
+ /** Vendor-neutral metadata for a processing job or statement. */
28
+ export interface ProcessingJobMetadata extends TemporalMetadataBase {
29
+ eventTime?: TimeField;
30
+ observedAt?: string;
31
+ processedAt?: string;
32
+ watermark?: TemporalWatermark;
33
+ window?: TemporalWindow;
34
+ revision?: TemporalRevision;
35
+ presentationState?: TemporalPresentationState;
36
+ presentationLabel?: string;
37
+ }
38
+ /**
39
+ * Temporal facts about a quality check. The check's pass/fail result belongs in
40
+ * quality-check evidence; this adapter records only when that result applies
41
+ * and whether the result itself is current.
42
+ */
43
+ export interface QualityCheckMetadata extends TemporalMetadataBase {
44
+ checkedAt?: string;
45
+ appliesToObservedAt?: string;
46
+ heartbeatAt?: string;
47
+ expiresAt?: string;
48
+ basis?: string;
49
+ }
50
+ /** Vendor-neutral metadata for a materialized historical snapshot. */
51
+ export interface HistoricalSnapshotMetadata extends TemporalMetadataBase {
52
+ snapshotAt?: string;
53
+ dataObservedAt?: string;
54
+ format?: NonNullable<TemporalContext["snapshot"]>["format"];
55
+ schemaVersion?: string;
56
+ catalogRef?: string;
57
+ revision?: TemporalRevision;
58
+ presentationLabel?: string;
59
+ }
60
+ /** Convert stream/topic metadata without assuming freshness or settlement. */
61
+ export declare function adaptStreamTopicMetadata(metadata: StreamTopicMetadata): TemporalContext;
62
+ /** Convert processing-job metadata while keeping its clock distinct. */
63
+ export declare function adaptProcessingJobMetadata(metadata: ProcessingJobMetadata): TemporalContext;
64
+ /** Convert quality-check timing without treating schema or test success as truth. */
65
+ export declare function adaptQualityCheckMetadata(metadata: QualityCheckMetadata): TemporalContext;
66
+ /** Convert snapshot metadata without assuming that materialization is settled. */
67
+ export declare function adaptHistoricalSnapshotMetadata(metadata: HistoricalSnapshotMetadata): TemporalContext;
68
+ /**
69
+ * Merge contexts in precedence order. Later defined fields win, source records
70
+ * are upserted by kind and id, and output source order is stable. Combining a
71
+ * stream and snapshot is always labeled `mixed` so neither state is hidden.
72
+ */
73
+ export declare function mergeTemporalContexts(...contexts: ReadonlyArray<TemporalContext | undefined>): TemporalContext;
74
+ /** Apply one immutable, deterministic update to a temporal context. */
75
+ export declare function updateTemporalContext(current: TemporalContext, update: TemporalContext): TemporalContext;
@@ -0,0 +1,12 @@
1
+ import type { ObligationResult, TemporalContext } from "./types";
2
+ export interface ParsedClock {
3
+ name: string;
4
+ path: string;
5
+ value: string;
6
+ time: number;
7
+ }
8
+ export declare function parseClock(name: string, path: string, value: string | undefined, findings: ObligationResult[]): ParsedClock | undefined;
9
+ export declare function parseFixedDurationMs(value: string): number;
10
+ export declare function normalizedTimezone(value: string): string;
11
+ export declare function normalizedGranularity(value: string): string;
12
+ export declare function finalPresentation(context: TemporalContext): boolean;
@@ -0,0 +1,8 @@
1
+ import type { ObligationResult, TemporalContext } from "./types";
2
+ export declare function parseAbsoluteTime(value: string): number;
3
+ /**
4
+ * Detect presentation language that turns an older event-time fact into a
5
+ * claim about the wall-clock present. The comparison uses only declared
6
+ * clocks, so the result is deterministic and replayable.
7
+ */
8
+ export declare function eventTimePresentationFinding(context: TemporalContext, referenceTime?: string): ObligationResult | undefined;
@@ -0,0 +1,341 @@
1
+ import type { Datum } from "../charts/shared/datumTypes";
2
+ /** Current wire version for the portable interpretation sidecar. */
3
+ export declare const ARTIFACT_CONTRACT_VERSION: "0.1";
4
+ export type ArtifactContractVersion = typeof ARTIFACT_CONTRACT_VERSION;
5
+ export type JsonPrimitive = string | number | boolean | null;
6
+ export type JsonValue = JsonPrimitive | JsonObject | JsonValue[];
7
+ export interface JsonObject {
8
+ [key: string]: JsonValue;
9
+ }
10
+ export type ArtifactKind = "chart" | "dashboard" | "story" | "alert" | "agent-answer";
11
+ export type ArtifactStakes = "exploratory" | "informational" | "operational" | "high";
12
+ export type FieldKnowledgeStatus = "known" | "unknown" | "manual" | "not-applicable";
13
+ export type ObligationStatus = "pass" | "fail" | "warn" | "manual" | "unknown" | "not-applicable";
14
+ export type ArtifactRelation = "claim-support" | "representation-fit" | "reception" | "time" | "challenge-and-correction" | "accountability" | "abstention" | "preservation";
15
+ export interface ArtifactFieldState {
16
+ status: FieldKnowledgeStatus;
17
+ reason?: string;
18
+ suppliedBy?: "author" | "system" | "model-proposal" | "import";
19
+ derived?: boolean;
20
+ reviewedBy?: string;
21
+ }
22
+ export interface ArtifactIdentity {
23
+ id: string;
24
+ kind: ArtifactKind;
25
+ component?: string;
26
+ title?: string;
27
+ createdAt?: string;
28
+ configFingerprint?: string;
29
+ dataFingerprint?: string;
30
+ revision?: string;
31
+ }
32
+ export interface PurposeIntent {
33
+ id: string;
34
+ strength?: "primary" | "secondary";
35
+ source?: "author" | "derived" | "model-proposal" | "import";
36
+ rationale?: string;
37
+ }
38
+ export interface PurposeContract {
39
+ intents: PurposeIntent[];
40
+ communicativeAct?: string;
41
+ decisionContext?: string;
42
+ stakes?: ArtifactStakes;
43
+ allowedUses?: string[];
44
+ prohibitedUses?: string[];
45
+ }
46
+ export type ClaimKind = "description" | "observation" | "aggregation" | "inference" | "forecast" | "simulation" | "alert" | "recommendation" | "normative";
47
+ export type ClaimStatus = "supported" | "provisional" | "disputed" | "superseded" | "retracted" | "unsupported" | "unknown";
48
+ export interface ActorRef {
49
+ id?: string;
50
+ name?: string;
51
+ kind: "human" | "agent" | "watcher" | "system" | (string & {});
52
+ }
53
+ export interface ClaimReview {
54
+ status: "proposed" | "reviewed" | "approved" | "rejected";
55
+ reviewer?: ActorRef;
56
+ reviewedAt?: string;
57
+ rationale?: string;
58
+ }
59
+ export interface ClaimUncertainty {
60
+ kind: "interval" | "distribution" | "qualitative" | "unknown";
61
+ lower?: number;
62
+ upper?: number;
63
+ confidence?: number;
64
+ unit?: string;
65
+ description?: string;
66
+ }
67
+ export interface Claim {
68
+ id: string;
69
+ text?: string;
70
+ kind: ClaimKind;
71
+ status: ClaimStatus;
72
+ evidenceIds: string[];
73
+ scope?: JsonObject;
74
+ uncertainty?: ClaimUncertainty;
75
+ asOf?: string;
76
+ supersedes?: string[];
77
+ authoredBy?: ActorRef;
78
+ review?: ClaimReview;
79
+ tags?: string[];
80
+ }
81
+ export type EvidenceRole = "source-data" | "external-source" | "transformation" | "statistical-test" | "model-output" | "human-observation" | "policy-rule" | "quality-check";
82
+ export interface EvidenceSource {
83
+ name?: string;
84
+ uri?: string;
85
+ version?: string;
86
+ retrievedAt?: string;
87
+ publisher?: string;
88
+ }
89
+ export type TransformationKind = "aggregation" | "filter" | "normalization" | "binning" | "join" | "smoothing" | "forecasting" | "simulation" | "other";
90
+ export interface TransformationRecord {
91
+ id: string;
92
+ kind: TransformationKind;
93
+ description?: string;
94
+ inputEvidenceIds: string[];
95
+ parameters?: JsonObject;
96
+ assumptions?: string[];
97
+ implementation?: string;
98
+ performedAt?: string;
99
+ performedBy?: ActorRef;
100
+ }
101
+ export interface BoundedEvidenceSample {
102
+ rowCount?: number;
103
+ fields?: string[];
104
+ values?: JsonValue[];
105
+ truncated?: boolean;
106
+ }
107
+ export interface EvidenceRef {
108
+ id: string;
109
+ role: EvidenceRole;
110
+ label?: string;
111
+ source?: EvidenceSource;
112
+ fingerprint?: string;
113
+ dataVersion?: string;
114
+ observedAt?: string;
115
+ scope?: JsonObject;
116
+ sample?: BoundedEvidenceSample;
117
+ transformation?: TransformationRecord;
118
+ generatedClaimId?: string;
119
+ relationship?: "descriptive" | "correlational" | "causal" | "unknown";
120
+ }
121
+ export interface TimeField {
122
+ field?: string;
123
+ value?: string;
124
+ timezone?: string;
125
+ granularity?: string;
126
+ }
127
+ export type WindowStatus = "open" | "provisional" | "settled" | "reopened" | "corrected";
128
+ export interface TemporalSourceState {
129
+ id: string;
130
+ kind: "stream" | "processing-job" | "quality-check" | "snapshot" | "publication";
131
+ label?: string;
132
+ observedAt?: string;
133
+ version?: string;
134
+ timezone?: string;
135
+ granularity?: string;
136
+ freshness?: "fresh" | "stale" | "unknown";
137
+ completeness?: "partial" | "provisional" | "settled" | "unknown";
138
+ }
139
+ export interface TemporalContext {
140
+ eventTime?: TimeField;
141
+ observedAt?: string;
142
+ ingestedAt?: string;
143
+ processedAt?: string;
144
+ publishedAt?: string;
145
+ snapshotAt?: string;
146
+ presentation?: {
147
+ state?: "live" | "historical" | "mixed";
148
+ label?: string;
149
+ };
150
+ freshness?: {
151
+ status: "fresh" | "stale" | "unknown";
152
+ checkedAt?: string;
153
+ heartbeatAt?: string;
154
+ expiresAt?: string;
155
+ basis?: string;
156
+ };
157
+ watermark?: {
158
+ value: string;
159
+ policy?: string;
160
+ allowedLateness?: string;
161
+ };
162
+ window?: {
163
+ start: string;
164
+ end: string;
165
+ status: WindowStatus;
166
+ };
167
+ completeness?: {
168
+ status: "partial" | "provisional" | "settled" | "unknown";
169
+ basis?: string;
170
+ };
171
+ revision?: {
172
+ status: "original" | "backfilled" | "corrected" | "superseded";
173
+ previousArtifactId?: string;
174
+ correctionId?: string;
175
+ reason?: string;
176
+ };
177
+ snapshot?: {
178
+ id?: string;
179
+ format?: "iceberg" | "delta" | "other";
180
+ schemaVersion?: string;
181
+ catalogRef?: string;
182
+ };
183
+ sources?: TemporalSourceState[];
184
+ }
185
+ export type ReceptionChannel = "visual" | "screen-reader" | "sonified" | "agent" | "print" | "low-bandwidth";
186
+ export interface ReceptionChannelContract {
187
+ channel: ReceptionChannel;
188
+ disclosure?: "summary" | "standard" | "detailed";
189
+ navigation?: boolean;
190
+ interactionInstructions?: boolean;
191
+ rawData?: "deny" | "bounded" | "allow";
192
+ tokenBudget?: number;
193
+ privacyNotes?: string[];
194
+ }
195
+ export interface ReceptionContract {
196
+ channels: ReceptionChannelContract[];
197
+ audience?: string;
198
+ strengths?: string[];
199
+ risks?: string[];
200
+ scaffolds?: string[];
201
+ description?: string;
202
+ dataFallback?: boolean;
203
+ manualChecks?: string[];
204
+ }
205
+ export interface DesignContract {
206
+ chartFamily?: string;
207
+ whyThisForm?: string;
208
+ rejectedAlternatives?: Array<{
209
+ representation: string;
210
+ reason: string;
211
+ }>;
212
+ risks?: string[];
213
+ misuse?: string[];
214
+ }
215
+ export interface ClaimChallenge {
216
+ id: string;
217
+ claimId: string;
218
+ status: "open" | "accepted" | "declined" | "resolved";
219
+ reason: string;
220
+ raisedBy?: ActorRef;
221
+ raisedAt?: string;
222
+ counterclaimId?: string;
223
+ resolution?: string;
224
+ }
225
+ export interface CorrectionRecord {
226
+ id: string;
227
+ affectedClaimIds: string[];
228
+ replacementClaimIds?: string[];
229
+ reason: string;
230
+ createdAt?: string;
231
+ createdBy?: ActorRef;
232
+ }
233
+ export interface ContestabilityContract {
234
+ sourceRequestsAllowed?: boolean;
235
+ alternativeViews?: Array<{
236
+ id: string;
237
+ label: string;
238
+ rationale?: string;
239
+ }>;
240
+ challenges?: ClaimChallenge[];
241
+ corrections?: CorrectionRecord[];
242
+ editorialExceptions?: Array<{
243
+ ruleId: string;
244
+ rationale: string;
245
+ owner?: string;
246
+ reviewAt?: string;
247
+ }>;
248
+ }
249
+ export interface ReviewRecord {
250
+ id: string;
251
+ status: "pending" | "approved" | "changes-requested" | "rejected";
252
+ reviewer?: ActorRef;
253
+ reviewedAt?: string;
254
+ rationale?: string;
255
+ policyId?: string;
256
+ }
257
+ export interface ActionRecord {
258
+ id: string;
259
+ action: string;
260
+ actor?: ActorRef;
261
+ actedAt?: string;
262
+ claimIds: string[];
263
+ artifactId?: string;
264
+ artifactRevision?: string;
265
+ policyId?: string;
266
+ status?: "proposed" | "taken" | "reversed" | "invalidated";
267
+ invalidatedByClaimId?: string;
268
+ }
269
+ export interface AccountabilityContract {
270
+ authors?: ActorRef[];
271
+ generatedBy?: string;
272
+ dataSources?: string[];
273
+ codeRef?: string;
274
+ reviews?: ReviewRecord[];
275
+ actions?: ActionRecord[];
276
+ }
277
+ export type PreservationClass = "full-fidelity" | "claim-evidence-preserved" | "visual-only" | "lossy" | "unknown";
278
+ export interface InheritanceContract {
279
+ requiredPaths?: string[];
280
+ prohibitedExports?: string[];
281
+ privacy?: "public" | "restricted" | "confidential" | "unknown";
282
+ rawDataDefault?: "exclude" | "bounded" | "include";
283
+ preservation?: PreservationClass;
284
+ sourceArtifactIds?: string[];
285
+ }
286
+ export interface ArtifactContract {
287
+ contractVersion: ArtifactContractVersion;
288
+ artifact: ArtifactIdentity;
289
+ purpose: PurposeContract;
290
+ claims: Claim[];
291
+ evidence: EvidenceRef[];
292
+ time?: TemporalContext;
293
+ reception?: ReceptionContract;
294
+ form?: DesignContract;
295
+ contestability?: ContestabilityContract;
296
+ accountability?: AccountabilityContract;
297
+ inheritance?: InheritanceContract;
298
+ fieldStatus?: Record<string, ArtifactFieldState>;
299
+ extensions?: JsonObject;
300
+ }
301
+ export interface ObligationResult {
302
+ id: string;
303
+ relation: ArtifactRelation;
304
+ status: ObligationStatus;
305
+ message: string;
306
+ path?: string;
307
+ repair?: string;
308
+ evidenceIds?: string[];
309
+ }
310
+ export interface ObligationSummary {
311
+ pass: number;
312
+ fail: number;
313
+ warn: number;
314
+ manual: number;
315
+ unknown: number;
316
+ notApplicable: number;
317
+ }
318
+ export interface ArtifactContractInput {
319
+ id?: string;
320
+ kind?: ArtifactKind;
321
+ title?: string;
322
+ createdAt?: string;
323
+ revision?: string;
324
+ purpose?: Partial<PurposeContract>;
325
+ intents?: string | string[] | PurposeIntent[];
326
+ claims?: Claim[];
327
+ evidence?: EvidenceRef[];
328
+ time?: TemporalContext;
329
+ reception?: ReceptionContract;
330
+ form?: DesignContract;
331
+ contestability?: ContestabilityContract;
332
+ accountability?: AccountabilityContract;
333
+ inheritance?: InheritanceContract;
334
+ fieldStatus?: Record<string, ArtifactFieldState>;
335
+ extensions?: JsonObject;
336
+ }
337
+ export interface ArtifactBuildInput {
338
+ component: string;
339
+ props?: Datum;
340
+ contract?: ArtifactContractInput;
341
+ }
@@ -0,0 +1,13 @@
1
+ export interface ArtifactContractValidation {
2
+ valid: boolean;
3
+ errors: Array<{
4
+ path: string;
5
+ message: string;
6
+ }>;
7
+ warnings: Array<{
8
+ path: string;
9
+ message: string;
10
+ }>;
11
+ }
12
+ /** Dependency-free structural validation for untrusted contract payloads. */
13
+ export declare function validateArtifactContract(value: unknown): ArtifactContractValidation;
@@ -0,0 +1,7 @@
1
+ type ValidationError = {
2
+ path: string;
3
+ message: string;
4
+ };
5
+ /** Validate declared knowledge state against the field supplier registry. */
6
+ export declare function validateArtifactFieldStatus(value: unknown, errors: ValidationError[]): void;
7
+ export {};
@@ -0,0 +1,24 @@
1
+ export type ValidationIssue = {
2
+ path: string;
3
+ message: string;
4
+ };
5
+ export interface StringFieldRule {
6
+ required?: boolean;
7
+ values?: ReadonlyArray<string>;
8
+ }
9
+ /** Validate a closed string-valued record from one ordered field definition. */
10
+ export declare function validateStringFields(record: Record<string, unknown>, fields: Record<string, StringFieldRule>, path: string, errors: ValidationIssue[]): void;
11
+ export declare function isRecord(value: unknown): value is Record<string, unknown>;
12
+ export declare function numberIfPresent(record: Record<string, unknown>, key: string, path: string, errors: ValidationIssue[]): void;
13
+ export declare function booleanIfPresent(record: Record<string, unknown>, key: string, path: string, errors: ValidationIssue[]): void;
14
+ export declare function jsonObjectIfPresent(record: Record<string, unknown>, key: string, path: string, errors: ValidationIssue[]): void;
15
+ export declare function jsonValuesAreValid(values: ReadonlyArray<unknown>): boolean;
16
+ export declare function rejectUnknownKeys(record: Record<string, unknown>, allowed: ReadonlyArray<string>, path: string, errors: ValidationIssue[]): void;
17
+ export declare function requiredString(record: Record<string, unknown>, key: string, path: string, errors: ValidationIssue[]): void;
18
+ export declare function enumString(record: Record<string, unknown>, key: string, path: string, allowed: ReadonlyArray<string>, errors: ValidationIssue[]): void;
19
+ export declare function optionalRecord(record: Record<string, unknown>, key: string, path: string, errors: ValidationIssue[]): Record<string, unknown> | undefined;
20
+ export declare function optionalArray(record: Record<string, unknown>, key: string, path: string, errors: ValidationIssue[]): unknown[] | undefined;
21
+ export declare function validateStringArray(value: unknown[] | undefined, path: string, errors: ValidationIssue[]): void;
22
+ export declare function enumStringIfPresent(record: Record<string, unknown>, key: string, path: string, allowed: ReadonlyArray<string>, errors: ValidationIssue[]): void;
23
+ export declare function stringIfPresent(record: Record<string, unknown>, key: string, path: string, errors: ValidationIssue[]): void;
24
+ export declare function validateActor(value: unknown, path: string, errors: ValidationIssue[]): void;