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,53 @@
1
+ import type { ArtifactContract, ObligationResult } from "./types";
2
+ export type ArtifactInspectorOutcome = "acceptable" | "conditional" | "refuse" | "unknown";
3
+ /** The evaluation fields consumed by the inspector. Full evaluations fit this shape. */
4
+ export interface ArtifactInspectorEvaluation {
5
+ status: "acceptable" | "conditional" | "refuse";
6
+ policy: {
7
+ id: string;
8
+ version: string;
9
+ };
10
+ obligations: ReadonlyArray<ObligationResult>;
11
+ manualChecks?: ReadonlyArray<string>;
12
+ alternatives?: ReadonlyArray<{
13
+ id: string;
14
+ label: string;
15
+ reasons?: ReadonlyArray<string>;
16
+ caveats?: ReadonlyArray<string>;
17
+ }>;
18
+ }
19
+ export interface ArtifactInspectionSummary {
20
+ outcome: ArtifactInspectorOutcome;
21
+ outcomeLabel: string;
22
+ time: {
23
+ status: string;
24
+ label: string;
25
+ };
26
+ claims: {
27
+ total: number;
28
+ active: number;
29
+ supported: number;
30
+ unresolved: number;
31
+ };
32
+ evidence: {
33
+ total: number;
34
+ referenced: number;
35
+ unreferenced: number;
36
+ missingReferences: number;
37
+ };
38
+ policy: {
39
+ status: "known" | "unknown";
40
+ label: string;
41
+ };
42
+ review: {
43
+ status: "required" | "clear" | "unknown";
44
+ count: number;
45
+ items: string[];
46
+ };
47
+ unknowns: {
48
+ count: number;
49
+ items: string[];
50
+ };
51
+ }
52
+ /** Build the concise, deterministic signals rendered above the disclosures. */
53
+ export declare function summarizeArtifactInspection(contract: ArtifactContract, evaluation?: ArtifactInspectorEvaluation): ArtifactInspectionSummary;
@@ -0,0 +1,54 @@
1
+ import type { Datum } from "../charts/shared/datumTypes";
2
+ import { type ArtifactGrounding, type BuildArtifactGroundingOptions } from "./grounding";
3
+ import type { ArtifactEvaluation, EvaluateArtifactOptions } from "./evaluateArtifactTypes";
4
+ import type { ArtifactContract, Claim, CorrectionRecord, EvidenceRef, ReceptionChannel, TemporalContext } from "./types";
5
+ export type ArtifactClaimTransition = {
6
+ action: "supersede";
7
+ previousClaimId: string;
8
+ replacement: Claim;
9
+ correction: Omit<CorrectionRecord, "affectedClaimIds" | "replacementClaimIds">;
10
+ } | {
11
+ action: "retract";
12
+ claimId: string;
13
+ correction: Omit<CorrectionRecord, "affectedClaimIds" | "replacementClaimIds">;
14
+ };
15
+ export interface ArtifactRevisionPresentation {
16
+ title?: string;
17
+ description?: string;
18
+ summary?: string;
19
+ }
20
+ export interface PrepareArtifactRevisionOptions extends Omit<EvaluateArtifactOptions, "data"> {
21
+ /** Required stable revision label for the resulting artifact. */
22
+ revision: string;
23
+ /** Optional new artifact id; the prior id is retained in source lineage. */
24
+ artifactId?: string;
25
+ /** Explicit replacement for the primary `data` prop. */
26
+ data?: ReadonlyArray<Datum>;
27
+ /** Other configuration or data-bearing prop updates. */
28
+ propUpdates?: Datum;
29
+ /** Complete evidence ledger for the revised data and claims. */
30
+ evidence?: ReadonlyArray<EvidenceRef>;
31
+ /** Temporal changes applied together with claims and presentation text. */
32
+ time: TemporalContext;
33
+ presentation?: ArtifactRevisionPresentation;
34
+ claimTransitions?: ReadonlyArray<ArtifactClaimTransition>;
35
+ groundingChannels?: ReadonlyArray<ReceptionChannel>;
36
+ grounding?: Omit<BuildArtifactGroundingOptions, "channel">;
37
+ }
38
+ export interface PreparedArtifactRevision {
39
+ /** True only for an acceptable evaluation; conditional results need review. */
40
+ publishable: boolean;
41
+ component: string;
42
+ props: Datum;
43
+ contract: ArtifactContract;
44
+ evaluation: ArtifactEvaluation;
45
+ grounding: Partial<Record<ReceptionChannel, ArtifactGrounding>>;
46
+ changedClaimIds: string[];
47
+ }
48
+ /**
49
+ * Prepare one immutable artifact revision. Data, claims, visible text, time,
50
+ * identities, evaluation, and channel grounding all derive from the same
51
+ * snapshot. Conditional and refused results return `publishable: false`;
52
+ * this helper cannot discharge manual checks or authorize publication.
53
+ */
54
+ export declare function prepareArtifactRevision(component: string, currentProps: Datum, currentContract: ArtifactContract, options: PrepareArtifactRevisionOptions): PreparedArtifactRevision;
@@ -0,0 +1,17 @@
1
+ import type { ArtifactContract, Claim } from "./types";
2
+ export declare const rows: {
3
+ month: number;
4
+ value: number;
5
+ }[];
6
+ export declare const props: {
7
+ data: {
8
+ month: number;
9
+ value: number;
10
+ }[];
11
+ xAccessor: string;
12
+ yAccessor: string;
13
+ title: string;
14
+ description: string;
15
+ summary: string;
16
+ };
17
+ export declare function contractWithClaim(id?: string, claim?: Partial<Claim>): ArtifactContract;
@@ -0,0 +1,13 @@
1
+ import type { ArtifactIdentityBinding } from "./identity";
2
+ import type { ArtifactTransferStatus } from "./serialization";
3
+ export interface ArtifactAttachmentIssue {
4
+ id: string;
5
+ status: "fail" | "unknown";
6
+ message: string;
7
+ }
8
+ /** Shared judgments for identity and transfer reports attached to evidence. */
9
+ export declare function artifactAttachmentIssues(attachment: {
10
+ contract?: unknown;
11
+ transfer?: ArtifactTransferStatus;
12
+ binding?: ArtifactIdentityBinding;
13
+ }): ArtifactAttachmentIssue[];
@@ -0,0 +1,3 @@
1
+ import type { ArtifactContract, ObligationResult } from "./types";
2
+ /** Audit correction references and their corresponding claim lifecycle states. */
3
+ export declare function auditClaimCorrections(contract: Pick<ArtifactContract, "claims" | "contestability">): ObligationResult[];
@@ -0,0 +1,5 @@
1
+ import type { Claim, EvidenceRef } from "./types";
2
+ export declare function supersessionCycles(claims: ReadonlyArray<Claim>): string[][];
3
+ export declare function transformationCycles(evidence: ReadonlyArray<EvidenceRef>): string[][];
4
+ export declare function evidenceUsedByClaims(claims: ReadonlyArray<Claim>, evidenceById: ReadonlyMap<string, EvidenceRef>): Set<string>;
5
+ export declare function hasIndependentEvidenceBasis(ids: ReadonlyArray<string>, evidenceById: ReadonlyMap<string, EvidenceRef>, active?: Set<string>): boolean;
@@ -0,0 +1,32 @@
1
+ import type { DescribeChartResult, DescribeLevel } from "../ai/describeChart";
2
+ import type { Datum } from "../charts/shared/datumTypes";
3
+ import type { ActorRef, ArtifactContract, Claim, ClaimChallenge, ClaimKind, CorrectionRecord, EvidenceRef } from "./types";
4
+ export interface DescriptionClaimOptions {
5
+ prefix?: string;
6
+ evidenceIds?: Partial<Record<DescribeLevel, ReadonlyArray<string>>>;
7
+ asOf?: string;
8
+ authoredBy?: ActorRef;
9
+ }
10
+ export interface AnnotationClaimProjection {
11
+ claims: Claim[];
12
+ evidence: EvidenceRef[];
13
+ unknownAnnotationIndexes: number[];
14
+ }
15
+ export interface AnnotationClaimOptions {
16
+ prefix?: string;
17
+ defaultKind?: ClaimKind;
18
+ }
19
+ /**
20
+ * Lift existing annotation origin and lifecycle blocks into artifact-wide
21
+ * claim and evidence records. Missing source facts remain unknown, and model
22
+ * output is recorded without allowing it to support the claim it generated.
23
+ */
24
+ export declare function claimsFromAnnotations(annotations: ReadonlyArray<Datum>, options?: AnnotationClaimOptions): AnnotationClaimProjection;
25
+ /** Turn layered generated descriptions into traceable claim records. */
26
+ export declare function claimsFromDescription(description: DescribeChartResult, options?: DescriptionClaimOptions): Claim[];
27
+ /** Preserve the old claim and append a replacement linked by stable id. */
28
+ export declare function supersedeClaim(contract: ArtifactContract, previousClaimId: string, replacement: Claim, correction?: Omit<CorrectionRecord, "affectedClaimIds" | "replacementClaimIds">): ArtifactContract;
29
+ /** Retract a claim without deleting its text, evidence, or revision history. */
30
+ export declare function retractClaim(contract: ArtifactContract, claimId: string, correction: Omit<CorrectionRecord, "affectedClaimIds">): ArtifactContract;
31
+ /** Attach an attributable challenge and expose the claim as disputed. */
32
+ export declare function challengeClaim(contract: ArtifactContract, challenge: ClaimChallenge): ArtifactContract;
@@ -0,0 +1,24 @@
1
+ import type { Datum } from "../charts/shared/datumTypes";
2
+ import { type ArtifactContract, type ObligationResult, type ObligationSummary } from "./types";
3
+ export { challengeClaim, claimsFromAnnotations, claimsFromDescription, retractClaim, supersedeClaim, type AnnotationClaimOptions, type AnnotationClaimProjection, type DescriptionClaimOptions } from "./claimLifecycle";
4
+ export interface ClaimAuditOptions {
5
+ /** Require source/version/fingerprint answerability for every used evidence ref. */
6
+ requireEvidenceIdentity?: boolean;
7
+ /** Escalate unreviewed model-authored supported claims from warning to failure. */
8
+ requireReviewForModelClaims?: boolean;
9
+ /** Optional rows for scoped checks such as category overlap. */
10
+ data?: ReadonlyArray<Datum>;
11
+ /** Explicit reference clock used to reject impossible future reviews. */
12
+ now?: string;
13
+ /** Allowed clock skew for review timestamps. Defaults to five minutes. */
14
+ maxFutureReviewSkewMs?: number;
15
+ }
16
+ export interface ClaimAudit {
17
+ ok: boolean;
18
+ claims: number;
19
+ evidence: number;
20
+ summary: ObligationSummary;
21
+ findings: ObligationResult[];
22
+ }
23
+ /** Audit referential integrity and the boundary between evidence and prose. */
24
+ export declare function auditClaims(contract: Pick<ArtifactContract, "claims" | "evidence" | "contestability" | "accountability"> & Partial<Pick<ArtifactContract, "artifact">>, options?: ClaimAuditOptions): ClaimAudit;
@@ -0,0 +1,10 @@
1
+ import { type ArtifactCollectionAuditOptions } from "./collectionPolicy";
2
+ import type { ArtifactCollectionContract, ArtifactCollectionAudit } from "./collectionTypes";
3
+ export type * from "./collectionTypes";
4
+ /** Audit failures that only become visible when individually valid views meet. */
5
+ export declare function auditArtifactCollection(collection: ArtifactCollectionContract, options?: ArtifactCollectionAuditOptions): ArtifactCollectionAudit;
6
+ export declare const auditDashboard: typeof auditArtifactCollection;
7
+ /** Stable identity for collection state and portable export comparisons. */
8
+ export declare function fingerprintArtifactCollection(collection: ArtifactCollectionContract): string;
9
+ export { applyCollectionCorrection, buildArtifactCollectionLineage, serializeArtifactCollection, validateArtifactCollection } from "./collectionOperations";
10
+ export { affectedCollectionClaims } from "./collectionImpact";
@@ -0,0 +1,4 @@
1
+ import type { ArtifactCollectionContract, CollectionClaimReference, CollectionCorrectionRecord } from "./collection";
2
+ export declare function claimReferenceKey(reference: CollectionClaimReference): string;
3
+ export declare function scopedCorrectionReferences(collection: ArtifactCollectionContract, correction: CollectionCorrectionRecord, kind: "affected" | "replacement"): CollectionClaimReference[];
4
+ export declare function correctionScopeIsValid(collection: ArtifactCollectionContract, correction: CollectionCorrectionRecord): boolean;
@@ -0,0 +1,11 @@
1
+ import type { ArtifactCollectionContract, CollectionEvidenceReference } from "./collection";
2
+ /**
3
+ * Identify dependent claims using artifact-qualified evidence references.
4
+ * Legacy string IDs are accepted when unique across the collection; ambiguous
5
+ * IDs throw instead of invalidating unrelated panels. Unknown legacy IDs are
6
+ * ignored, while explicit references must identify existing evidence.
7
+ */
8
+ export declare function affectedCollectionClaims(collection: ArtifactCollectionContract, changedEvidenceIds: ReadonlyArray<string | CollectionEvidenceReference>): Array<{
9
+ artifactId: string;
10
+ claimId: string;
11
+ }>;
@@ -0,0 +1,3 @@
1
+ import type { ArtifactCollectionContract, ArtifactCollectionLineage } from "./collection";
2
+ /** Build a portable dependency graph from the collection's declared records. */
3
+ export declare function buildArtifactCollectionLineage(collection: ArtifactCollectionContract): ArtifactCollectionLineage;
@@ -0,0 +1,8 @@
1
+ import type { ArtifactCollectionContract, ArtifactCollectionValidation, CollectionCorrectionRecord, SerializedArtifactCollection } from "./collection";
2
+ /** Dependency-free validation for untrusted collection payloads. */
3
+ export declare function validateArtifactCollection(value: unknown): ArtifactCollectionValidation;
4
+ /** Preserve a collection as deterministic JSON and report validation loss. */
5
+ export declare function serializeArtifactCollection(value: unknown): SerializedArtifactCollection;
6
+ /** Apply a collection correction without deleting the previous claim state. */
7
+ export declare function applyCollectionCorrection(collection: ArtifactCollectionContract, correction: CollectionCorrectionRecord): ArtifactCollectionContract;
8
+ export { buildArtifactCollectionLineage } from "./collectionLineage";
@@ -0,0 +1,22 @@
1
+ import { type ArtifactPolicy } from "./policies";
2
+ import type { ArtifactCollectionContract } from "./collection";
3
+ import type { RenderEvidence } from "../server/renderEvidence";
4
+ import type { ObligationResult } from "./types";
5
+ /** The bounded renderer fields a collection policy consumes for each artifact. */
6
+ export type ArtifactCollectionRenderEvidence = Pick<RenderEvidence, "component" | "status" | "empty" | "markCount" | "semanticStatus">;
7
+ export interface ArtifactCollectionAuditOptions {
8
+ /** Explicit reference clock for review, freshness, and expiry checks. */
9
+ now?: string;
10
+ /**
11
+ * Renderer results keyed by artifact ID. The audit reads at most one own
12
+ * entry for each artifact in the collection and never adds this input to the
13
+ * portable collection contract.
14
+ */
15
+ renderEvidenceByArtifactId?: Readonly<Record<string, ArtifactCollectionRenderEvidence>>;
16
+ }
17
+ export interface ArtifactCollectionPolicyAudit {
18
+ policy?: Pick<ArtifactPolicy, "id" | "version">;
19
+ findings: ObligationResult[];
20
+ }
21
+ /** Apply collection policy rules without changing structural validation. */
22
+ export declare function auditArtifactCollectionPolicy(collection: ArtifactCollectionContract, options?: ArtifactCollectionAuditOptions): ArtifactCollectionPolicyAudit;
@@ -0,0 +1,117 @@
1
+ import type { ActionRecord, ArtifactContract, CorrectionRecord, JsonObject, JsonValue, ObligationResult, ObligationSummary } from "./types";
2
+ export interface MetricDefinition {
3
+ id: string;
4
+ label: string;
5
+ definition: string;
6
+ unit?: string;
7
+ denominator?: string;
8
+ version?: string;
9
+ }
10
+ export interface CollectionFilterState {
11
+ id: string;
12
+ label?: string;
13
+ value?: JsonValue;
14
+ appliesToArtifactIds: string[];
15
+ }
16
+ export interface ArtifactViewState {
17
+ artifactId: string;
18
+ metricIds?: string[];
19
+ filterIds?: string[];
20
+ selectionFingerprint?: string;
21
+ summarySelectionFingerprint?: string;
22
+ status?: "ready" | "stale" | "failed" | "unknown";
23
+ }
24
+ export interface ClaimDependency {
25
+ claimId: string;
26
+ artifactId: string;
27
+ evidenceIds: string[];
28
+ sourceIds?: string[];
29
+ }
30
+ /** An artifact-qualified claim reference for collection-wide records. */
31
+ export interface CollectionClaimReference {
32
+ artifactId: string;
33
+ claimId: string;
34
+ }
35
+ /** Evidence IDs are artifact-local, even when panels share a collection. */
36
+ export interface CollectionEvidenceReference {
37
+ artifactId: string;
38
+ evidenceId: string;
39
+ }
40
+ /**
41
+ * Optional exact targets for a correction whose claim identifiers are not
42
+ * unique across a collection. The unqualified CorrectionRecord fields remain
43
+ * available for compatibility with existing artifact-local records.
44
+ */
45
+ export interface CollectionCorrectionScope {
46
+ affectedClaims?: CollectionClaimReference[];
47
+ replacementClaims?: CollectionClaimReference[];
48
+ }
49
+ export interface CollectionCorrectionRecord extends CorrectionRecord {
50
+ scope?: CollectionCorrectionScope;
51
+ }
52
+ export interface ArtifactCollectionContract {
53
+ collectionVersion: "0.1";
54
+ id: string;
55
+ title?: string;
56
+ artifacts: ArtifactContract[];
57
+ metrics?: MetricDefinition[];
58
+ policyId?: string;
59
+ filters?: CollectionFilterState[];
60
+ views?: ArtifactViewState[];
61
+ sourceRegistry?: Array<{
62
+ id: string;
63
+ label?: string;
64
+ version?: string;
65
+ fingerprint?: string;
66
+ }>;
67
+ claimDependencies?: ClaimDependency[];
68
+ actions?: ActionRecord[];
69
+ corrections?: CollectionCorrectionRecord[];
70
+ extensions?: JsonObject;
71
+ }
72
+ export interface ArtifactCollectionAudit {
73
+ ok: boolean;
74
+ policy?: {
75
+ id: string;
76
+ version: string;
77
+ };
78
+ summary: ObligationSummary;
79
+ findings: ObligationResult[];
80
+ }
81
+ export type { ArtifactCollectionAuditOptions } from "./collectionPolicy";
82
+ export interface ArtifactCollectionTransfer {
83
+ status: "preserved" | "unsupported-version" | "invalid";
84
+ omittedPaths: string[];
85
+ warnings: string[];
86
+ }
87
+ export interface SerializedArtifactCollection {
88
+ collection?: ArtifactCollectionContract | JsonObject;
89
+ transfer: ArtifactCollectionTransfer;
90
+ }
91
+ export interface ArtifactCollectionValidation {
92
+ valid: boolean;
93
+ errors: Array<{
94
+ path: string;
95
+ message: string;
96
+ }>;
97
+ warnings: Array<{
98
+ path: string;
99
+ message: string;
100
+ }>;
101
+ }
102
+ export type ArtifactLineageNodeKind = "source" | "schema" | "processing-job" | "quality-check" | "snapshot" | "artifact" | "evidence" | "claim" | "action";
103
+ export interface ArtifactLineageNode {
104
+ id: string;
105
+ kind: ArtifactLineageNodeKind;
106
+ label?: string;
107
+ artifactId?: string;
108
+ }
109
+ export interface ArtifactLineageEdge {
110
+ source: string;
111
+ target: string;
112
+ relation: "produces" | "supports" | "contains" | "acts-on" | "supersedes";
113
+ }
114
+ export interface ArtifactCollectionLineage {
115
+ nodes: ArtifactLineageNode[];
116
+ edges: ArtifactLineageEdge[];
117
+ }
@@ -0,0 +1,8 @@
1
+ import type { Datum } from "../charts/shared/datumTypes";
2
+ import type { ArtifactRepairLedgerEntry } from "./evaluateArtifactTypes";
3
+ /**
4
+ * Project deterministic chart-fit advice into the artifact repair ledger.
5
+ * Alternative components remain proposals: changing form can change emphasis,
6
+ * so the fit engine alone cannot establish semantic equivalence.
7
+ */
8
+ export declare function configurationRepairLedgerEntries(component: string, props: Datum, data: ReadonlyArray<Datum> | null | undefined, intents: ReadonlyArray<string>): ArtifactRepairLedgerEntry[];
@@ -0,0 +1,30 @@
1
+ import type { Datum } from "../charts/shared/datumTypes";
2
+ import type { IntentManifest } from "../ai/intentManifest";
3
+ import { type ArtifactContract, type ArtifactContractInput } from "./types";
4
+ export { ARTIFACT_FIELD_POLICIES, type ArtifactFieldPolicy } from "./fieldPolicies";
5
+ export { validateArtifactContract, type ArtifactContractValidation } from "./validation";
6
+ /**
7
+ * Build the optional interpretation sidecar for a chart. Only configuration
8
+ * and data identities are inferred automatically; purpose, stakes, evidence,
9
+ * time, review, and approval remain unknown unless a caller supplies them.
10
+ */
11
+ export declare function buildArtifactContract(component: string, props?: Datum, input?: ArtifactContractInput): ArtifactContract;
12
+ export interface IntentManifestProjection {
13
+ manifest: IntentManifest;
14
+ omittedPaths: string[];
15
+ }
16
+ /** Adapt the earlier intent manifest into the broader artifact contract. */
17
+ export declare function fromIntentManifest(manifest: IntentManifest): ArtifactContract;
18
+ /**
19
+ * Project a contract back to the earlier manifest format and report the richer
20
+ * paths that format cannot carry.
21
+ */
22
+ export declare function toIntentManifest(contract: ArtifactContract): IntentManifestProjection;
23
+ export interface FormatArtifactContractOptions {
24
+ /** Include explicit unknown, manual, and not-applicable field states. */
25
+ includeFieldStatus?: boolean;
26
+ /** Override the separator used between output lines. */
27
+ lineSeparator?: string;
28
+ }
29
+ /** Compact text for logs, CLI output, and progressive disclosure headers. */
30
+ export declare function formatArtifactContract(contract: ArtifactContract, options?: FormatArtifactContractOptions): string;
@@ -0,0 +1,12 @@
1
+ import type { Datum } from "../charts/shared/datumTypes";
2
+ import type { ArtifactContract } from "./types";
3
+ import type { ArtifactEvaluation, ArtifactRepairResult, EvaluateArtifactOptions, RepairArtifactOptions } from "./evaluateArtifactTypes";
4
+ export type { ArtifactEvaluation, ArtifactRepairLedgerEntry, ArtifactRepairResult, EvaluateArtifactOptions, RepairArtifactOptions, RepairProposal } from "./evaluateArtifactTypes";
5
+ export { explainArtifactRefusal } from "./evaluationPresentation";
6
+ /**
7
+ * Compose chart, claim, time, accessibility, and policy evidence without
8
+ * flattening them into a single aggregate score.
9
+ */
10
+ export declare function evaluateArtifact(component: string, props: Datum, contract: ArtifactContract, options?: EvaluateArtifactOptions): ArtifactEvaluation;
11
+ /** Apply deterministic repairs without inventing evidence, review, or claims. */
12
+ export declare function repairArtifact(component: string, props: Datum, contract: ArtifactContract, options?: RepairArtifactOptions): ArtifactRepairResult;
@@ -0,0 +1,78 @@
1
+ import type { Datum } from "../charts/shared/datumTypes";
2
+ import type { EvaluateChartOptions, EvaluateChartResult } from "../ai/evaluateChart";
3
+ import type { ArtifactPolicyException, ArtifactPolicyInput } from "./policies";
4
+ import type { RepresentationCandidate, RepresentationRecommendation } from "./representation";
5
+ import type { ClaimAudit } from "./claims";
6
+ import type { TemporalAudit } from "./temporal";
7
+ import type { ArtifactContractValidation } from "./contract";
8
+ import type { ArtifactContract, ObligationResult } from "./types";
9
+ export interface RepairProposal {
10
+ id: string;
11
+ category?: "identity" | "configuration" | "contract";
12
+ path?: string;
13
+ action: string;
14
+ reason: string;
15
+ changesClaim: boolean;
16
+ }
17
+ export interface EvaluateArtifactOptions extends EvaluateChartOptions {
18
+ data?: ReadonlyArray<Datum>;
19
+ policy?: ArtifactPolicyInput;
20
+ exceptions?: ReadonlyArray<ArtifactPolicyException>;
21
+ now?: string;
22
+ recommendRepresentation?: boolean;
23
+ }
24
+ export interface ArtifactEvaluation {
25
+ /** Conditional results retain open work and are not publication approval. */
26
+ status: "acceptable" | "conditional" | "refuse";
27
+ policy: {
28
+ id: string;
29
+ version: string;
30
+ appliedExceptions: ArtifactPolicyException[];
31
+ rejectedExceptions: ArtifactPolicyException[];
32
+ };
33
+ validation: {
34
+ artifact: ArtifactContractValidation;
35
+ chart: EvaluateChartResult["validation"];
36
+ };
37
+ data: EvaluateChartResult["data"];
38
+ claims: ClaimAudit;
39
+ temporal: TemporalAudit;
40
+ accessibility: EvaluateChartResult["accessibility"];
41
+ design: EvaluateChartResult["deception"];
42
+ render?: EvaluateChartResult["evidence"];
43
+ obligations: ObligationResult[];
44
+ recommendation?: RepresentationRecommendation;
45
+ alternatives: RepresentationCandidate[];
46
+ repairs: RepairProposal[];
47
+ manualChecks: string[];
48
+ }
49
+ export interface ArtifactRepairLedgerEntry {
50
+ id: string;
51
+ /** Distinguishes render/configuration work from contract and identity work. */
52
+ category?: "identity" | "configuration" | "contract";
53
+ path: string;
54
+ action: string;
55
+ reason: string;
56
+ applied: boolean;
57
+ changesClaim: boolean;
58
+ /** Ranked replacement from the deterministic chart-fit repair engine. */
59
+ suggestedComponent?: string;
60
+ suggestedVariant?: string;
61
+ }
62
+ export interface RepairArtifactOptions extends EvaluateArtifactOptions {
63
+ /**
64
+ * Fill absent identity fields only; never overwrite an existing binding.
65
+ * Mismatches require an explicit revision and claim reassessment.
66
+ * Defaults to proposal-only.
67
+ */
68
+ applySafeIdentityRepairs?: boolean;
69
+ }
70
+ export interface ArtifactRepairResult {
71
+ status: "unchanged" | "repaired" | "requires-input";
72
+ component: string;
73
+ props: Datum;
74
+ contract: ArtifactContract;
75
+ before: ArtifactEvaluation;
76
+ after: ArtifactEvaluation;
77
+ ledger: ArtifactRepairLedgerEntry[];
78
+ }
@@ -0,0 +1,9 @@
1
+ import type { EvaluateChartResult } from "../ai/evaluateChart";
2
+ import type { ArtifactEvaluation, RepairProposal } from "./evaluateArtifactTypes";
3
+ import type { ObligationResult } from "./types";
4
+ export declare function chartObligations(chart: EvaluateChartResult): ObligationResult[];
5
+ export declare function renderEvidenceObligations(chart: EvaluateChartResult, required: boolean): ObligationResult[];
6
+ export declare function repairProposals(obligations: ReadonlyArray<ObligationResult>): RepairProposal[];
7
+ export declare function hasCriticalAccessibilityFailure(chart: EvaluateChartResult): boolean;
8
+ /** Explain a policy refusal in stable, user-facing language. */
9
+ export declare function explainArtifactRefusal(evaluation: ArtifactEvaluation): string;
@@ -0,0 +1,8 @@
1
+ import type { EvidenceRef } from "./types";
2
+ /** Bound rows, fields, names, and total payload size as one consistent unit. */
3
+ export declare function boundEvidenceSample(sample: NonNullable<EvidenceRef["sample"]>, options?: {
4
+ maxRows?: number;
5
+ maxFields?: number;
6
+ maxFieldLength?: number;
7
+ maxCharacters?: number;
8
+ }): NonNullable<EvidenceRef["sample"]>;
@@ -0,0 +1,8 @@
1
+ export interface ArtifactPathSegment {
2
+ key: string;
3
+ each: boolean;
4
+ }
5
+ export declare function artifactPathContains(parent: string, child: string): boolean;
6
+ export declare function artifactPathsOverlap(left: string, right: string): boolean;
7
+ export declare function parseArtifactExportPath(path: string): ArtifactPathSegment[] | undefined;
8
+ export declare function deleteArtifactExportPath(value: unknown, segments: ReadonlyArray<ArtifactPathSegment>, index?: number): boolean;
@@ -0,0 +1,12 @@
1
+ export interface ArtifactFieldPolicy {
2
+ suppliedBy: ReadonlyArray<"author" | "system" | "model-proposal" | "import">;
3
+ derivable: boolean;
4
+ modelMayPropose: boolean;
5
+ humanReview: "never" | "policy-dependent" | "required";
6
+ }
7
+ /**
8
+ * Field authorship rules for the contract's externally meaningful values.
9
+ * A model may suggest prose and decisions, but cannot manufacture source,
10
+ * version, clock, review, or approval facts.
11
+ */
12
+ export declare const ARTIFACT_FIELD_POLICIES: Readonly<Record<string, ArtifactFieldPolicy>>;
@@ -0,0 +1,36 @@
1
+ import type { JsonValue } from "./types";
2
+ export interface CanonicalJsonResult {
3
+ value: JsonValue;
4
+ text: string;
5
+ excludedPaths: string[];
6
+ }
7
+ export interface ValueFingerprint extends CanonicalJsonResult {
8
+ algorithm: "sha256";
9
+ digest: string;
10
+ fingerprint: string;
11
+ }
12
+ /**
13
+ * Convert a value to deterministic JSON by sorting object keys and recording
14
+ * values that cannot be represented. Array positions are retained as null so
15
+ * removal cannot silently shift later evidence.
16
+ */
17
+ export declare function canonicalJson(input: unknown): CanonicalJsonResult;
18
+ /**
19
+ * Produce a stable SHA-256 content identity. The digest is suitable for cache
20
+ * keys, revision comparisons, and evidence binding; without a trusted signing
21
+ * process it does not prove authorship or tamper resistance.
22
+ */
23
+ export declare function fingerprintValue(input: unknown): ValueFingerprint;
24
+ /** Build a bounded, privacy-conscious evidence sample from row data. */
25
+ export declare function boundedEvidenceSample(rows: ReadonlyArray<unknown>, options?: {
26
+ maxRows?: number;
27
+ maxFields?: number;
28
+ maxFieldLength?: number;
29
+ maxCharacters?: number;
30
+ fields?: ReadonlyArray<string>;
31
+ }): {
32
+ rowCount: number;
33
+ fields: string[];
34
+ values: JsonValue[];
35
+ truncated: boolean;
36
+ };