semiotic 3.9.2 → 3.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (452) hide show
  1. package/README.md +99 -74
  2. package/agent-skill/semiotic-charts/SKILL.md +13 -7
  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/dist/mcp-server.js +68 -68
  8. package/ai/examples.md +1 -1
  9. package/ai/reference.md +31 -14
  10. package/ai/schema.json +1868 -438
  11. package/ai/surface-manifest.json +11 -4
  12. package/ai/system-prompt.md +2 -0
  13. package/ai/task-packets/compare-category-totals.json +301 -0
  14. package/ai/task-packets/compare-category-totals.md +188 -0
  15. package/ai/task-packets/correct-published-chart.json +271 -0
  16. package/ai/task-packets/correct-published-chart.md +597 -0
  17. package/ai/task-packets/index.json +40 -0
  18. package/ai/task-packets/update-live-chart.json +289 -0
  19. package/ai/task-packets/update-live-chart.md +424 -0
  20. package/dist/c-2N7IU2NY.min.js +1 -0
  21. package/dist/c-2WK7YJLL.min.js +1 -0
  22. package/dist/c-33QOXEUG.min.js +1 -0
  23. package/dist/c-42PLDTX7.min.js +1 -0
  24. package/dist/c-447VIMRO.min.js +1 -0
  25. package/dist/c-4FN7Q6VQ.min.js +1 -0
  26. package/dist/c-553QUDKA.min.js +1 -0
  27. package/dist/c-55BAJ333.min.js +1 -0
  28. package/dist/c-7242NXSG.min.js +1 -0
  29. package/dist/c-7EGHJU2F.min.js +1 -0
  30. package/dist/c-7HP7MB2I.min.js +1 -0
  31. package/dist/c-7NBU5ZKS.min.js +1 -0
  32. package/dist/c-AFBSWT77.min.js +1 -0
  33. package/dist/c-AJ7EC32V.min.js +1 -0
  34. package/dist/c-AQADQNY7.min.js +1 -0
  35. package/dist/c-ATM475SA.min.js +1 -0
  36. package/dist/c-AVO3Q7T7.min.js +1 -0
  37. package/dist/c-AZKPVBOC.min.js +1 -0
  38. package/dist/c-BNFJMDHN.min.js +1 -0
  39. package/dist/c-BNG5ECK5.min.js +1 -0
  40. package/dist/c-BOHCQILI.min.js +1 -0
  41. package/dist/c-CCTGN5CK.min.js +1 -0
  42. package/dist/c-CPSPZH6A.min.js +1 -0
  43. package/dist/c-CPV4N35K.min.js +1 -0
  44. package/dist/c-D6HAAPTX.min.js +1 -0
  45. package/dist/c-DE5Q3U2X.min.js +1 -0
  46. package/dist/c-DK662R77.min.js +1 -0
  47. package/dist/c-DY2676CR.min.js +1 -0
  48. package/dist/c-E32M6XW5.min.js +1 -0
  49. package/dist/c-E4JDJH4I.min.js +1 -0
  50. package/dist/c-E7I2L7CU.min.js +1 -0
  51. package/dist/c-EBOQ7ER7.min.js +1 -0
  52. package/dist/c-ELDWAO2V.min.js +1 -0
  53. package/dist/c-EUBTECGM.min.js +1 -0
  54. package/dist/c-GNTXRXRN.min.js +1 -0
  55. package/dist/c-GSZRZRD6.min.js +1 -0
  56. package/dist/c-GWX7JGMF.min.js +1 -0
  57. package/dist/c-GXV3C3MO.min.js +1 -0
  58. package/dist/c-HHTK2R75.min.js +1 -0
  59. package/dist/c-HLLFJYTY.min.js +1 -0
  60. package/dist/c-HPOYKCCG.min.js +1 -0
  61. package/dist/c-HXDKPIKR.min.js +1 -0
  62. package/dist/c-I4QJ6YLM.min.js +1 -0
  63. package/dist/c-IDJV3CZK.min.js +1 -0
  64. package/dist/c-ITKX3RC5.min.js +1 -0
  65. package/dist/c-JG2JCQLP.min.js +1 -0
  66. package/dist/c-JLGRHXGZ.min.js +1 -0
  67. package/dist/c-JO2UGTCP.min.js +1 -0
  68. package/dist/c-JUKIWTBJ.min.js +1 -0
  69. package/dist/c-KCRJGUHP.min.js +1 -0
  70. package/dist/c-LMGSSD2E.min.js +1 -0
  71. package/dist/c-LYQMZMZQ.min.js +1 -0
  72. package/dist/c-LYVKDBQJ.min.js +1 -0
  73. package/dist/c-MVR3RWF3.min.js +1 -0
  74. package/dist/c-MXCP7GNZ.min.js +1 -0
  75. package/dist/c-NG7BLZTR.min.js +1 -0
  76. package/dist/c-NYZ2QNAM.min.js +1 -0
  77. package/dist/c-OO5QLMJC.min.js +1 -0
  78. package/dist/c-OOVX2JPQ.min.js +1 -0
  79. package/dist/c-ORLEBW72.min.js +1 -0
  80. package/dist/c-P65V6HLO.min.js +1 -0
  81. package/dist/c-PP6VY3QU.min.js +1 -0
  82. package/dist/c-PRIKOLTE.min.js +1 -0
  83. package/dist/c-PSNI6KAZ.min.js +1 -0
  84. package/dist/c-PYNW54D2.min.js +1 -0
  85. package/dist/c-QA3HMQJP.min.js +1 -0
  86. package/dist/c-ROEHCIGV.min.js +1 -0
  87. package/dist/c-S3AZX5PP.min.js +1 -0
  88. package/dist/c-T2V7O2LO.min.js +1 -0
  89. package/dist/c-TIXX5CAU.min.js +1 -0
  90. package/dist/c-TKG2NP7G.min.js +1 -0
  91. package/dist/c-VJTDST2R.min.js +1 -0
  92. package/dist/c-VXLOLYTO.min.js +1 -0
  93. package/dist/c-W4ZUKSEQ.min.js +1 -0
  94. package/dist/c-WH2O53VI.min.js +1 -0
  95. package/dist/c-WNGH47HF.min.js +1 -0
  96. package/dist/c-WUWXGQYA.min.js +1 -0
  97. package/dist/c-XDQKXPX4.min.js +1 -0
  98. package/dist/{c-CKLIFCGN.min.js → c-XSB27XPS.min.js} +1 -1
  99. package/dist/c-YDECTEUW.min.js +1 -0
  100. package/dist/c-YF3YKVQI.min.js +1 -0
  101. package/dist/c-YLZIV3VS.min.js +1 -0
  102. package/dist/c-ZYPXQF7B.min.js +1 -0
  103. package/dist/components/Annotation.d.ts +2 -1
  104. package/dist/components/ai/chartRecipeRegistry.d.ts +6 -1
  105. package/dist/components/ai/chartRecipes.d.ts +4 -0
  106. package/dist/components/ai/describePhysicsProjection.d.ts +18 -0
  107. package/dist/components/ai/describePhysicsSource.d.ts +13 -0
  108. package/dist/components/artifact/ArtifactInspector.d.ts +26 -0
  109. package/dist/components/artifact/ArtifactInspectorContextSections.d.ts +18 -0
  110. package/dist/components/artifact/artifactContractDiff.d.ts +8 -0
  111. package/dist/components/artifact/artifactInspectorSummary.d.ts +53 -0
  112. package/dist/components/artifact/artifactRevision.d.ts +54 -0
  113. package/dist/components/artifact/artifactTestFixtures.d.ts +17 -0
  114. package/dist/components/artifact/attachmentAudit.d.ts +13 -0
  115. package/dist/components/artifact/claimCorrections.d.ts +3 -0
  116. package/dist/components/artifact/claimGraph.d.ts +5 -0
  117. package/dist/components/artifact/claimLifecycle.d.ts +32 -0
  118. package/dist/components/artifact/claims.d.ts +24 -0
  119. package/dist/components/artifact/collection.d.ts +10 -0
  120. package/dist/components/artifact/collectionCorrectionScope.d.ts +4 -0
  121. package/dist/components/artifact/collectionImpact.d.ts +11 -0
  122. package/dist/components/artifact/collectionLineage.d.ts +3 -0
  123. package/dist/components/artifact/collectionOperations.d.ts +8 -0
  124. package/dist/components/artifact/collectionPolicy.d.ts +22 -0
  125. package/dist/components/artifact/collectionTypes.d.ts +117 -0
  126. package/dist/components/artifact/configurationRepair.d.ts +8 -0
  127. package/dist/components/artifact/contract.d.ts +30 -0
  128. package/dist/components/artifact/evaluateArtifact.d.ts +12 -0
  129. package/dist/components/artifact/evaluateArtifactTypes.d.ts +78 -0
  130. package/dist/components/artifact/evaluationPresentation.d.ts +9 -0
  131. package/dist/components/artifact/evidenceSample.d.ts +8 -0
  132. package/dist/components/artifact/exportPaths.d.ts +8 -0
  133. package/dist/components/artifact/fieldPolicies.d.ts +12 -0
  134. package/dist/components/artifact/fingerprint.d.ts +36 -0
  135. package/dist/components/artifact/grounding.d.ts +51 -0
  136. package/dist/components/artifact/groundingBudget.d.ts +38 -0
  137. package/dist/components/artifact/hostTransfer.d.ts +13 -0
  138. package/dist/components/artifact/identity.d.ts +19 -0
  139. package/dist/components/artifact/inheritance.d.ts +48 -0
  140. package/dist/components/artifact/inheritanceIntegrity.d.ts +3 -0
  141. package/dist/components/artifact/jsonCompatibility.d.ts +2 -0
  142. package/dist/components/artifact/obligations.d.ts +3 -0
  143. package/dist/components/artifact/policies.d.ts +45 -0
  144. package/dist/components/artifact/policyRelations.d.ts +3 -0
  145. package/dist/components/artifact/recordProjection.d.ts +7 -0
  146. package/dist/components/artifact/representation.d.ts +50 -0
  147. package/dist/components/artifact/serialization.d.ts +40 -0
  148. package/dist/components/artifact/temporal.d.ts +32 -0
  149. package/dist/components/artifact/temporalAdapters.d.ts +75 -0
  150. package/dist/components/artifact/temporalAuditHelpers.d.ts +12 -0
  151. package/dist/components/artifact/temporalPresentation.d.ts +8 -0
  152. package/dist/components/artifact/types.d.ts +341 -0
  153. package/dist/components/artifact/validation.d.ts +13 -0
  154. package/dist/components/artifact/validationFieldStatus.d.ts +7 -0
  155. package/dist/components/artifact/validationPrimitives.d.ts +24 -0
  156. package/dist/components/artifact/validationSurfaces.d.ts +7 -0
  157. package/dist/components/artifact/validationTemporal.d.ts +3 -0
  158. package/dist/components/charts/geo/FlowMap.d.ts +7 -0
  159. package/dist/components/charts/geo/flowMapLineStyle.d.ts +18 -0
  160. package/dist/components/charts/ordinal/DonutChart.d.ts +2 -0
  161. package/dist/components/charts/ordinal/FunnelChart.d.ts +2 -0
  162. package/dist/components/charts/ordinal/GroupedBarChart.d.ts +6 -0
  163. package/dist/components/charts/ordinal/PieChart.d.ts +2 -0
  164. package/dist/components/charts/ordinal/RadarChart.d.ts +2 -0
  165. package/dist/components/charts/ordinal/StackedBarChart.d.ts +6 -0
  166. package/dist/components/charts/physics/CollisionSwarmChart.d.ts +1 -1
  167. package/dist/components/charts/physics/EventDropChart.d.ts +3 -1
  168. package/dist/components/charts/physics/GaltonBoardChart.d.ts +4 -2
  169. package/dist/components/charts/physics/ProcessFlowChart.d.ts +6 -0
  170. package/dist/components/charts/physics/UnitPileChart.d.ts +2 -1
  171. package/dist/components/charts/physics/collisionSwarmPacking.d.ts +14 -0
  172. package/dist/components/charts/physics/collisionSwarmPhysics.d.ts +1 -0
  173. package/dist/components/charts/physics/eventDropAdmission.d.ts +32 -0
  174. package/dist/components/charts/physics/eventDropPhysics.d.ts +22 -1
  175. package/dist/components/charts/physics/galtonBoardPhysics.d.ts +2 -9
  176. package/dist/components/charts/physics/physicsChartReconcile.d.ts +4 -0
  177. package/dist/components/charts/physics/physicsChartUtils.d.ts +1 -1
  178. package/dist/components/charts/physics/physicsGaltonData.d.ts +10 -0
  179. package/dist/components/charts/physics/physicsHocHandle.d.ts +2 -0
  180. package/dist/components/charts/physics/physicsPileData.d.ts +11 -0
  181. package/dist/components/charts/physics/physicsPilePhysics.d.ts +5 -12
  182. package/dist/components/charts/physics/physicsProjectionOverlays.d.ts +1 -1
  183. package/dist/components/charts/physics/physicsSourceRows.d.ts +8 -0
  184. package/dist/components/charts/physics/usePhysicsChartData.d.ts +19 -0
  185. package/dist/components/charts/realtime/RealtimeHeatmap.d.ts +4 -0
  186. package/dist/components/charts/realtime/RealtimeHistogram.d.ts +14 -6
  187. package/dist/components/charts/realtime/RealtimeLineChart.d.ts +4 -0
  188. package/dist/components/charts/realtime/RealtimeSwarmChart.d.ts +4 -0
  189. package/dist/components/charts/realtime/RealtimeWaterfallChart.d.ts +4 -0
  190. package/dist/components/charts/realtime/realtimeAccessors.d.ts +4 -0
  191. package/dist/components/charts/realtime/realtimeChartRuntime.d.ts +8 -7
  192. package/dist/components/charts/realtime/realtimeChartTypes.d.ts +7 -0
  193. package/dist/components/charts/realtime/temporalHistogramConfig.d.ts +17 -11
  194. package/dist/components/charts/shared/GaugeReadout.d.ts +9 -0
  195. package/dist/components/charts/shared/ThresholdAnnotation.d.ts +18 -0
  196. package/dist/components/charts/shared/ThresholdEndCap.d.ts +7 -0
  197. package/dist/components/charts/shared/auditAccessibilityText.d.ts +4 -2
  198. package/dist/components/charts/shared/numericTickFormatter.d.ts +2 -0
  199. package/dist/components/charts/shared/radialCenterContent.d.ts +10 -0
  200. package/dist/components/charts/shared/tooltipUtils.d.ts +1 -1
  201. package/dist/components/charts/shared/useChartLegend.d.ts +4 -0
  202. package/dist/components/charts/shared/useXYPointStyle.d.ts +2 -0
  203. package/dist/components/charts/xy/BubbleChart.d.ts +7 -0
  204. package/dist/components/charts/xy/CandlestickChart.d.ts +7 -0
  205. package/dist/components/charts/xy/DifferenceChart.d.ts +7 -0
  206. package/dist/components/charts/xy/MinimapChart.d.ts +7 -0
  207. package/dist/components/charts/xy/MultiAxisLineChart.d.ts +7 -0
  208. package/dist/components/charts/xy/ScatterplotMatrix.d.ts +6 -0
  209. package/dist/components/charts/xy/WaterfallChart.d.ts +8 -0
  210. package/dist/components/charts/xy/differenceMarkStyle.d.ts +28 -0
  211. package/dist/components/charts/xy/multiAxisFields.d.ts +23 -0
  212. package/dist/components/charts/xy/scatterplotMatrixCells.d.ts +50 -0
  213. package/dist/components/evidence/chartEvidenceEnvelope.d.ts +16 -8
  214. package/dist/components/evidence/evidenceEnvelopeInput.d.ts +8 -0
  215. package/dist/components/evidence/evidenceEnvelopeValidation.d.ts +11 -0
  216. package/dist/components/evidence/evidenceGate.d.ts +3 -1
  217. package/dist/components/evidence/renderedSceneHash.d.ts +23 -0
  218. package/dist/components/evidence/stableJsonHash.d.ts +4 -0
  219. package/dist/components/export/chartConfig.d.ts +40 -5
  220. package/dist/components/export/chartConfigArtifact.d.ts +6 -0
  221. package/dist/components/legendLayout.d.ts +18 -0
  222. package/dist/components/legendStyles.d.ts +4 -0
  223. package/dist/components/recipes/firstAvailableTrack.d.ts +17 -0
  224. package/dist/components/recipes/intervals.d.ts +1 -1
  225. package/dist/components/semiotic-ai-core.d.ts +33 -22
  226. package/dist/components/semiotic-ai.d.ts +15 -3
  227. package/dist/components/semiotic-artifact-react.d.ts +10 -0
  228. package/dist/components/semiotic-artifact.d.ts +23 -0
  229. package/dist/components/semiotic-experimental.d.ts +1 -1
  230. package/dist/components/semiotic-physics.d.ts +4 -4
  231. package/dist/components/semiotic-text.d.ts +2 -0
  232. package/dist/components/semiotic-utils-core.d.ts +18 -18
  233. package/dist/components/semiotic.d.ts +3 -3
  234. package/dist/components/server/renderEvidence.d.ts +12 -0
  235. package/dist/components/server/renderToStaticSVG.d.ts +3 -0
  236. package/dist/components/server/staticSVGChrome.d.ts +1 -4
  237. package/dist/components/server/staticXYAxisTicks.d.ts +2 -38
  238. package/dist/components/server/staticXYGrid.d.ts +1 -1
  239. package/dist/components/server/svgSizing.d.ts +6 -0
  240. package/dist/components/shared/svgRoot.d.ts +17 -0
  241. package/dist/components/store/selectionProvenance.d.ts +6 -0
  242. package/dist/components/stream/GeoSVGOverlay.d.ts +4 -0
  243. package/dist/components/stream/NetworkSVGOverlay.d.ts +4 -0
  244. package/dist/components/stream/OrdinalSVGOverlay.d.ts +4 -0
  245. package/dist/components/stream/SVGOverlay.d.ts +4 -0
  246. package/dist/components/stream/SceneToSVG.d.ts +4 -19
  247. package/dist/components/stream/SceneToSVGXY.d.ts +13 -0
  248. package/dist/components/stream/StreamGeoFrame.d.ts +1 -2
  249. package/dist/components/stream/StreamOrdinalFrame.d.ts +1 -2
  250. package/dist/components/stream/XYGrid.d.ts +11 -0
  251. package/dist/components/stream/axisTickUtils.d.ts +0 -1
  252. package/dist/components/stream/hitTestUtils.d.ts +2 -0
  253. package/dist/components/stream/overlayAccessibleText.d.ts +18 -0
  254. package/dist/components/stream/physics/PhysicsControllers.d.ts +1 -1
  255. package/dist/components/stream/physics/PhysicsKernel.d.ts +9 -0
  256. package/dist/components/stream/physics/PhysicsPipelineStore.d.ts +5 -4
  257. package/dist/components/stream/physics/PhysicsPipelineTypes.d.ts +9 -0
  258. package/dist/components/stream/physics/StreamPhysicsTypes.d.ts +3 -0
  259. package/dist/components/stream/physics/physicsCanvasCoordinates.d.ts +5 -0
  260. package/dist/components/stream/physics/physicsFixedPosition.d.ts +16 -0
  261. package/dist/components/stream/physics/physicsKernelCloning.d.ts +6 -0
  262. package/dist/components/stream/physics/physicsPipelineObservations.d.ts +2 -0
  263. package/dist/components/stream/physics/physicsPipelineSettle.d.ts +15 -9
  264. package/dist/components/stream/physics/physicsRegionRuntime.d.ts +8 -17
  265. package/dist/components/stream/physics/physicsSemanticUI.d.ts +9 -0
  266. package/dist/components/stream/pipelineConfig.d.ts +4 -0
  267. package/dist/components/stream/pipelineStoreUpdateResults.d.ts +1 -1
  268. package/dist/components/stream/resolveXYAxes.d.ts +13 -0
  269. package/dist/components/stream/sceneToSVGShared.d.ts +2 -1
  270. package/dist/components/stream/seriesGeometry.d.ts +13 -0
  271. package/dist/components/stream/streamEncodingTypes.d.ts +53 -0
  272. package/dist/components/stream/types.d.ts +4 -53
  273. package/dist/components/stream/useGeoFrameHandle.d.ts +16 -0
  274. package/dist/components/stream/useOrdinalFrameHandle.d.ts +15 -0
  275. package/dist/components/stream/useXYFrameHandle.d.ts +15 -0
  276. package/dist/components/stream/xyAxisTicks.d.ts +25 -0
  277. package/dist/components/stream/xyDateTicks.d.ts +3 -2
  278. package/dist/components/stream/xyFrameAxisTypes.d.ts +2 -0
  279. package/dist/components/stream/xySceneBuilders/ribbonScene.d.ts +1 -1
  280. package/dist/components/stream/xySceneBuilders/types.d.ts +1 -0
  281. package/dist/components/text/annotationTextLayout.d.ts +28 -0
  282. package/dist/components/text/pretextAnnotationLayout.d.ts +29 -0
  283. package/dist/components/text/usePretextAnnotations.d.ts +12 -0
  284. package/dist/controls.module.min.js +1 -1
  285. package/dist/geo.min.js +1 -1
  286. package/dist/geo.module.min.js +1 -1
  287. package/dist/network.module.min.js +1 -1
  288. package/dist/ordinal.module.min.js +1 -1
  289. package/dist/physics-matter.min.js +1 -1
  290. package/dist/physics-matter.module.min.js +1 -1
  291. package/dist/physics-rapier.min.js +1 -1
  292. package/dist/physics-rapier.module.min.js +1 -1
  293. package/dist/physics.module.min.js +1 -1
  294. package/dist/physicsWorker.js +1 -1
  295. package/dist/processSankeyLayoutWorker.js +1 -1
  296. package/dist/rough.min.js +1 -1
  297. package/dist/rough.module.min.js +1 -1
  298. package/dist/semiotic-access.module.min.js +1 -1
  299. package/dist/semiotic-ai-artifact-policy-constants.module.min.js +2 -0
  300. package/dist/semiotic-ai-core.d.ts +33 -22
  301. package/dist/semiotic-ai-core.min.js +1 -1
  302. package/dist/semiotic-ai-core.module.min.js +1 -1
  303. package/dist/semiotic-ai-hash-primitives.module.min.js +2 -0
  304. package/dist/semiotic-ai.d.ts +15 -3
  305. package/dist/semiotic-ai.module.min.js +1 -1
  306. package/dist/semiotic-artifact-react.d.ts +10 -0
  307. package/dist/semiotic-artifact-react.min.js +2 -0
  308. package/dist/semiotic-artifact-react.module.min.js +2 -0
  309. package/dist/semiotic-artifact.d.ts +23 -0
  310. package/dist/semiotic-artifact.min.js +1 -0
  311. package/dist/semiotic-artifact.module.min.js +1 -0
  312. package/dist/semiotic-client-cjs-shared.min.js +1 -1
  313. package/dist/semiotic-client-glyph.module.min.js +1 -1
  314. package/dist/semiotic-client-responsive.module.min.js +1 -1
  315. package/dist/semiotic-client-shared.module.min.js +1 -1
  316. package/dist/semiotic-custom-layout-selection-cjs-shared.min.js +1 -1
  317. package/dist/semiotic-data.min.js +1 -1
  318. package/dist/semiotic-data.module.min.js +1 -1
  319. package/dist/semiotic-evidence.min.js +1 -1
  320. package/dist/semiotic-evidence.module.min.js +1 -1
  321. package/dist/semiotic-experimental-auxiliary.module.min.js +1 -1
  322. package/dist/semiotic-experimental-node-auxiliary.module.min.js +1 -1
  323. package/dist/semiotic-experimental-react-shared.module.min.js +1 -1
  324. package/dist/semiotic-experimental-vacp.min.js +1 -1
  325. package/dist/semiotic-experimental-vacp.module.min.js +1 -1
  326. package/dist/semiotic-experimental.d.ts +1 -1
  327. package/dist/semiotic-line.module.min.js +1 -1
  328. package/dist/semiotic-physics.d.ts +4 -4
  329. package/dist/semiotic-realtime-core.module.min.js +1 -1
  330. package/dist/semiotic-realtime-react.module.min.js +1 -1
  331. package/dist/semiotic-recipes-core-cjs-base.min.js +1 -1
  332. package/dist/semiotic-recipes-core.module.min.js +1 -1
  333. package/dist/semiotic-recipes-geo-cjs.min.js +1 -1
  334. package/dist/semiotic-recipes-react.min.js +1 -1
  335. package/dist/semiotic-server-edge-node.module.min.js +1 -1
  336. package/dist/semiotic-server-edge.min.js +1 -1
  337. package/dist/semiotic-server-edge.module.min.js +1 -1
  338. package/dist/semiotic-server-node.min.js +1 -1
  339. package/dist/semiotic-server-node.module.min.js +1 -1
  340. package/dist/semiotic-text.d.ts +2 -0
  341. package/dist/semiotic-text.min.js +2 -0
  342. package/dist/semiotic-text.module.min.js +2 -0
  343. package/dist/semiotic-themes-core.min.js +1 -1
  344. package/dist/semiotic-themes-core.module.min.js +1 -1
  345. package/dist/semiotic-themes.min.js +1 -1
  346. package/dist/semiotic-themes.module.min.js +1 -1
  347. package/dist/semiotic-utils-core.d.ts +18 -18
  348. package/dist/semiotic-utils-core.min.js +1 -1
  349. package/dist/semiotic-utils-core.module.min.js +1 -1
  350. package/dist/semiotic-value.module.min.js +1 -1
  351. package/dist/semiotic.d.ts +3 -3
  352. package/dist/semiotic.module.min.js +1 -1
  353. package/dist/server.min.js +1 -1
  354. package/dist/server.module.min.js +1 -1
  355. package/dist/xy.module.min.js +1 -1
  356. package/package.json +55 -14
  357. package/spec/README.md +8 -3
  358. package/spec/v0.1/artifact-contract.schema.json +2299 -0
  359. package/spec/v0.1/examples/artifact-contract-full.json +369 -0
  360. package/spec/v0.1/examples/artifact-contract-unknown-state.json +46 -0
  361. package/dist/c-3BLJEQNG.min.js +0 -1
  362. package/dist/c-3SCUN5HI.min.js +0 -1
  363. package/dist/c-3VVKFA4M.min.js +0 -1
  364. package/dist/c-43TJZS3F.min.js +0 -1
  365. package/dist/c-4DTZPSUD.min.js +0 -1
  366. package/dist/c-4ES5367Y.min.js +0 -1
  367. package/dist/c-52TEGIUJ.min.js +0 -1
  368. package/dist/c-54IRWOGM.min.js +0 -1
  369. package/dist/c-5D2S4RMI.min.js +0 -1
  370. package/dist/c-5JWCTX3G.min.js +0 -1
  371. package/dist/c-6CMMSN6N.min.js +0 -1
  372. package/dist/c-6HRB2L7H.min.js +0 -1
  373. package/dist/c-6O5EVOPH.min.js +0 -1
  374. package/dist/c-7W4SV36A.min.js +0 -1
  375. package/dist/c-A4WRGZFX.min.js +0 -1
  376. package/dist/c-AG7WWVIH.min.js +0 -1
  377. package/dist/c-AH6J4MTN.min.js +0 -1
  378. package/dist/c-AKAF6JAD.min.js +0 -1
  379. package/dist/c-ALYR5LKK.min.js +0 -1
  380. package/dist/c-BBKITSXB.min.js +0 -1
  381. package/dist/c-BYDPC44I.min.js +0 -1
  382. package/dist/c-CFFIU2MW.min.js +0 -1
  383. package/dist/c-CGNHBHCE.min.js +0 -1
  384. package/dist/c-CJYSXIFV.min.js +0 -1
  385. package/dist/c-CZF7MV67.min.js +0 -1
  386. package/dist/c-D53OKBSY.min.js +0 -1
  387. package/dist/c-DADXPJXV.min.js +0 -1
  388. package/dist/c-DBQ2V7CH.min.js +0 -1
  389. package/dist/c-DPMVAUAW.min.js +0 -1
  390. package/dist/c-ECJCKLYY.min.js +0 -1
  391. package/dist/c-EGATGOWJ.min.js +0 -1
  392. package/dist/c-EGR6VYBW.min.js +0 -1
  393. package/dist/c-ESNR43AN.min.js +0 -1
  394. package/dist/c-F3LIKINL.min.js +0 -1
  395. package/dist/c-F5ZB5GJ6.min.js +0 -1
  396. package/dist/c-G36WS6LN.min.js +0 -1
  397. package/dist/c-G3VYMHKE.min.js +0 -1
  398. package/dist/c-GGISSW5E.min.js +0 -1
  399. package/dist/c-GR6MOEQC.min.js +0 -1
  400. package/dist/c-GSVCN34B.min.js +0 -1
  401. package/dist/c-GYOQCEFP.min.js +0 -1
  402. package/dist/c-H3DNMTCC.min.js +0 -1
  403. package/dist/c-I6J3FEZE.min.js +0 -1
  404. package/dist/c-IGH6MGJ5.min.js +0 -1
  405. package/dist/c-II2EEAJN.min.js +0 -1
  406. package/dist/c-IUHFPMHD.min.js +0 -1
  407. package/dist/c-J6M4JHRS.min.js +0 -1
  408. package/dist/c-JM3MGLQV.min.js +0 -1
  409. package/dist/c-KM3N7F7R.min.js +0 -1
  410. package/dist/c-LF5BZFNC.min.js +0 -1
  411. package/dist/c-LKBSGFQC.min.js +0 -1
  412. package/dist/c-MNF2S4AA.min.js +0 -1
  413. package/dist/c-MT3WBK7M.min.js +0 -1
  414. package/dist/c-NDJADPIF.min.js +0 -1
  415. package/dist/c-NVPQCIL5.min.js +0 -1
  416. package/dist/c-NY3JWV2K.min.js +0 -1
  417. package/dist/c-OFWJBEE5.min.js +0 -1
  418. package/dist/c-OYFHP5F5.min.js +0 -1
  419. package/dist/c-PGKQGGQ2.min.js +0 -1
  420. package/dist/c-PPWDL5ZI.min.js +0 -1
  421. package/dist/c-Q2IPZ3MU.min.js +0 -1
  422. package/dist/c-QKHMBE2E.min.js +0 -1
  423. package/dist/c-QMVM3AY6.min.js +0 -1
  424. package/dist/c-QSGWX53A.min.js +0 -1
  425. package/dist/c-RJKEKZOO.min.js +0 -1
  426. package/dist/c-RSVIHIQ4.min.js +0 -1
  427. package/dist/c-S6U5CGT5.min.js +0 -1
  428. package/dist/c-SFDIIU5G.min.js +0 -1
  429. package/dist/c-SLGMUBUL.min.js +0 -1
  430. package/dist/c-SRTBCRVE.min.js +0 -1
  431. package/dist/c-T6UAIKBH.min.js +0 -1
  432. package/dist/c-TMCTEVVW.min.js +0 -1
  433. package/dist/c-TMOSJLT3.min.js +0 -1
  434. package/dist/c-TZW3JGJ5.min.js +0 -1
  435. package/dist/c-U6ESPM7V.min.js +0 -1
  436. package/dist/c-UC5PTTFI.min.js +0 -1
  437. package/dist/c-USFMFKIH.min.js +0 -1
  438. package/dist/c-VGKUEZBC.min.js +0 -1
  439. package/dist/c-VGW3VG3I.min.js +0 -1
  440. package/dist/c-VN2HG5BS.min.js +0 -1
  441. package/dist/c-VPZDY5Q4.min.js +0 -1
  442. package/dist/c-VRXUB2F2.min.js +0 -1
  443. package/dist/c-VUBQNQJH.min.js +0 -1
  444. package/dist/c-VUH4PGZY.min.js +0 -1
  445. package/dist/c-W3CE4A4S.min.js +0 -1
  446. package/dist/c-X5UBGU2V.min.js +0 -1
  447. package/dist/c-XDRV7RKW.min.js +0 -1
  448. package/dist/c-YGZHURXZ.min.js +0 -1
  449. package/dist/c-YZVRZGX2.min.js +0 -1
  450. /package/dist/{c-N4G2L7ID.min.js → c-HYW2XA4Q.min.js} +0 -0
  451. /package/dist/{c-ENF72HU5.min.js → c-QAVFOEUY.min.js} +0 -0
  452. /package/dist/{c-OCI56QF2.min.js → c-V4XMSLC3.min.js} +0 -0
@@ -0,0 +1,51 @@
1
+ import type { Datum } from "../charts/shared/datumTypes";
2
+ import { type ChartReaderGrounding } from "../ai/readerGrounding";
3
+ import type { ArtifactContract, Claim, CorrectionRecord, EvidenceRef, ReceptionChannel, TemporalContext } from "./types";
4
+ export interface BuildArtifactGroundingOptions {
5
+ channel: ReceptionChannel;
6
+ tokenBudget?: number;
7
+ disclosureLevel?: "summary" | "standard" | "detailed";
8
+ includeRawData?: boolean;
9
+ maxNavigationLeaves?: number;
10
+ }
11
+ export type GroundedClaim = Claim;
12
+ export type GroundedEvidence = EvidenceRef;
13
+ export type { ArtifactGroundingBudget } from "./groundingBudget";
14
+ export interface ArtifactGrounding {
15
+ groundingVersion: "0.1";
16
+ artifact: {
17
+ id: string;
18
+ kind: ArtifactContract["artifact"]["kind"];
19
+ component?: string;
20
+ title?: string;
21
+ revision?: string;
22
+ };
23
+ channel: ReceptionChannel;
24
+ disclosureLevel: "summary" | "standard" | "detailed";
25
+ purpose: ArtifactContract["purpose"];
26
+ claims: GroundedClaim[];
27
+ evidence: GroundedEvidence[];
28
+ time?: TemporalContext;
29
+ form?: ArtifactContract["form"];
30
+ contestability?: ArtifactContract["contestability"];
31
+ accountability?: ArtifactContract["accountability"];
32
+ uncertainty: string[];
33
+ corrections: CorrectionRecord[];
34
+ chart?: ChartReaderGrounding;
35
+ security: {
36
+ contentClassification: "untrusted-data";
37
+ instructionBoundary: string;
38
+ rawDataIncluded: boolean;
39
+ evidenceSamplesIncluded: boolean;
40
+ };
41
+ budget: import("./groundingBudget").ArtifactGroundingBudget;
42
+ omittedPaths: string[];
43
+ truncated: boolean;
44
+ text: string;
45
+ }
46
+ /**
47
+ * Project common contract evidence into a channel-specific reading. Source
48
+ * labels, annotations, and claim prose are always marked as untrusted data,
49
+ * never executable instructions.
50
+ */
51
+ export declare function buildArtifactGrounding(component: string, props: Datum, contract: ArtifactContract, options: BuildArtifactGroundingOptions): ArtifactGrounding;
@@ -0,0 +1,38 @@
1
+ import type { ArtifactContract, TemporalContext } from "./types";
2
+ import type { ArtifactGrounding, GroundedClaim, GroundedEvidence } from "./grounding";
3
+ export interface ArtifactGroundingBudget {
4
+ /** Budget requested by the caller or reception channel. */
5
+ requestedTokens: number;
6
+ /**
7
+ * Applied upper bound using the documented four-serialized-characters per
8
+ * token approximation. A 256-token minimum retains identity, safety, and
9
+ * omission metadata even when the requested budget is smaller.
10
+ */
11
+ effectiveTokens: number;
12
+ /** Exact JSON.stringify length of this grounding payload. */
13
+ serializedCharacters: number;
14
+ minimumEnvelopeApplied: boolean;
15
+ }
16
+ export declare const MINIMUM_GROUNDING_TOKENS = 256;
17
+ export declare function buildGroundingText(input: {
18
+ artifact: ArtifactGrounding["artifact"];
19
+ purpose: ArtifactContract["purpose"];
20
+ claims: GroundedClaim[];
21
+ evidence: GroundedEvidence[];
22
+ time?: TemporalContext;
23
+ form?: ArtifactContract["form"];
24
+ uncertainty: string[];
25
+ contestability?: ArtifactContract["contestability"];
26
+ accountability?: ArtifactContract["accountability"];
27
+ }): string;
28
+ /**
29
+ * Bound the complete serialized payload, not only its readable text. The
30
+ * requested budget uses a deterministic four-character token approximation.
31
+ * Very small requests retain a fixed 256-token identity, safety, and omission
32
+ * envelope; `budget` reports both the requested and effective limits.
33
+ *
34
+ * Reductions remove whole semantic sections or optional record details. Claim
35
+ * and evidence graphs are removed together, so a bounded result never leaves
36
+ * dangling support references. Values are never shortened into new facts.
37
+ */
38
+ export declare function applyGroundingBudget(grounding: ArtifactGrounding, tokenBudget: number): ArtifactGrounding;
@@ -0,0 +1,13 @@
1
+ import { type ArtifactPacket } from "./inheritance";
2
+ export type ArtifactSidecarFormat = "png-sidecar" | "notebook" | "static-package";
3
+ export interface AdjacentArtifactSidecar {
4
+ format: ArtifactSidecarFormat;
5
+ hostPath: string;
6
+ sidecarPath: string;
7
+ mediaType: "application/json";
8
+ content: string;
9
+ }
10
+ /** Embed a complete SVG-format packet as machine-readable XML metadata. */
11
+ export declare function embedArtifactPacketInSvg(svg: string, packet: ArtifactPacket): string;
12
+ /** Prepare an inspectable JSON file to be written beside a static host. */
13
+ export declare function createAdjacentArtifactSidecar(packet: ArtifactPacket, hostPath: string): AdjacentArtifactSidecar;
@@ -0,0 +1,19 @@
1
+ import type { Datum } from "../charts/shared/datumTypes";
2
+ import type { ArtifactContract, EvidenceRef } from "./types";
3
+ /** Select the data-bearing props used by artifact identity checks. */
4
+ export declare function artifactDataValue(props: Datum): unknown;
5
+ /**
6
+ * Bind data identity to declared transformations as well as input values.
7
+ * Evidence order does not affect the result, but changing a transformation's
8
+ * inputs, parameters, assumptions, or implementation does.
9
+ */
10
+ export declare function artifactDataFingerprint(data: unknown, evidence?: ReadonlyArray<EvidenceRef>): string | undefined;
11
+ /** Select serializable configuration props without embedding chart rows. */
12
+ export declare function artifactConfigurationValue(props: Datum): Datum;
13
+ export interface ArtifactIdentityBinding {
14
+ status: "match" | "mismatch" | "unknown";
15
+ mismatchPaths: string[];
16
+ unknownPaths: string[];
17
+ }
18
+ /** Compare declared artifact identity with one concrete component/config/data input. */
19
+ export declare function compareArtifactIdentity(contract: ArtifactContract, props: Datum, component?: string, suppliedData?: unknown): ArtifactIdentityBinding;
@@ -0,0 +1,48 @@
1
+ import type { ArtifactContract, Claim, CorrectionRecord, EvidenceRef, PreservationClass, TemporalContext } from "./types";
2
+ export type ArtifactTransferFormat = "semiotic-config" | "portable-recipe" | "vega-lite" | "html" | "svg" | "png-sidecar" | "notebook" | "static-package" | "mcp";
3
+ export interface ArtifactTransferReport {
4
+ format: ArtifactTransferFormat;
5
+ preservation: PreservationClass;
6
+ preservedPaths: string[];
7
+ omittedPaths: string[];
8
+ warnings: string[];
9
+ }
10
+ export interface ArtifactPacket {
11
+ packetVersion: "0.1";
12
+ artifactId: string;
13
+ contractFingerprint: string;
14
+ transferFingerprint: string;
15
+ contract: ArtifactContract;
16
+ transfer: ArtifactTransferReport;
17
+ }
18
+ export interface ArtifactPacketValidation {
19
+ valid: boolean;
20
+ errors: string[];
21
+ packet?: ArtifactPacket;
22
+ }
23
+ export interface CreateArtifactPacketOptions {
24
+ format?: ArtifactTransferFormat;
25
+ includeEvidenceSamples?: boolean;
26
+ maxEvidenceRecords?: number;
27
+ maxClaims?: number;
28
+ }
29
+ export declare function createArtifactPacket(contract: ArtifactContract, options?: CreateArtifactPacketOptions): ArtifactPacket;
30
+ export declare function validateArtifactPacket(value: unknown): ArtifactPacketValidation;
31
+ export { diffArtifactContracts, type ArtifactContractChange } from "./artifactContractDiff";
32
+ export interface CompactInheritancePacket {
33
+ artifact: ArtifactContract["artifact"];
34
+ purpose: ArtifactContract["purpose"];
35
+ claims: Claim[];
36
+ evidence: EvidenceRef[];
37
+ time?: TemporalContext;
38
+ corrections?: CorrectionRecord[];
39
+ accountability?: ArtifactContract["accountability"];
40
+ inheritance?: ArtifactContract["inheritance"];
41
+ fieldStatus?: ArtifactContract["fieldStatus"];
42
+ omittedPaths: string[];
43
+ }
44
+ export declare function compactInheritancePacket(contract: ArtifactContract, options?: {
45
+ maxClaims?: number;
46
+ maxEvidence?: number;
47
+ }): CompactInheritancePacket;
48
+ export declare function artifactContractScriptTag(packet: ArtifactPacket): string;
@@ -0,0 +1,3 @@
1
+ import type { ArtifactContract } from "./types";
2
+ /** Return blocking semantic findings before an artifact changes format. */
3
+ export declare function semanticContractErrors(contract: ArtifactContract): string[];
@@ -0,0 +1,2 @@
1
+ /** Find values that cannot survive a strict JSON round trip unchanged. */
2
+ export declare function nonJsonValuePaths(value: unknown, path?: string, ancestors?: Set<object>): string[];
@@ -0,0 +1,3 @@
1
+ import type { ObligationResult, ObligationSummary } from "./types";
2
+ export declare function summarizeObligations(findings: ReadonlyArray<ObligationResult>): ObligationSummary;
3
+ export declare function formatObligations(findings: ReadonlyArray<ObligationResult>): string;
@@ -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;