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,10 @@
1
+ /**
2
+ * React inspection surface for Semiotic artifact contracts.
3
+ *
4
+ * Import from `semiotic/artifact/react` to keep the renderer-independent
5
+ * `semiotic/artifact` entry free of React.
6
+ */
7
+ export { ArtifactInspector } from "./components/artifact/ArtifactInspector";
8
+ export type { ArtifactInspectorProps, ArtifactInspectorSection } from "./components/artifact/ArtifactInspector";
9
+ export { summarizeArtifactInspection } from "./components/artifact/artifactInspectorSummary";
10
+ export type { ArtifactInspectionSummary, ArtifactInspectorEvaluation, ArtifactInspectorOutcome } from "./components/artifact/artifactInspectorSummary";
@@ -0,0 +1,2 @@
1
+ "use client";
2
+ function e(e){return[...new Set(e.filter(Boolean))]}function n(e){return"acceptable"===e?"Acceptable under the active policy":"conditional"===e?"Conditional — follow-up is required":"refuse"===e?"Refused by the active policy":"Not evaluated — policy outcome is unknown"}function s(e){const n=e.time;if(!n){const n=Object.entries(e.fieldStatus??{}).find(([e])=>"time"===e||e.startsWith("time."))?.[1];return{status:n?.status??"unknown",label:n?.reason??"Unknown — no time context is declared"}}const s=n.window?.status??n.completeness?.status??n.freshness?.status??n.presentation?.state??"unknown";if(n.presentation?.label)return{status:s,label:n.presentation.label};if(n.window)return{status:s,label:`${n.window.start} through ${n.window.end}`};if(n.eventTime?.value)return{status:s,label:"Event time "+n.eventTime.value};const i=n.snapshotAt??n.publishedAt??n.observedAt??n.processedAt;return i?{status:s,label:"Recorded at "+i}:{status:s,label:"Unknown — time context has no readable timestamp"}}function i(i,t){const r=i.claims.filter(({status:e})=>"superseded"!==e&&"retracted"!==e),l=new Set(i.claims.flatMap(({evidenceIds:e})=>e)),a=new Set(i.evidence.map(({id:e})=>e)),d=e([...i.reception?.manualChecks??[],...Object.entries(i.fieldStatus??{}).flatMap(([e,n])=>"manual"===n.status?[n.reason??e+" requires manual review"]:[]),...t?.manualChecks??[],...t?.obligations.flatMap(e=>"manual"===e.status?[e.message]:[])??[]]),c=e([...Object.entries(i.fieldStatus??{}).flatMap(([e,n])=>"unknown"===n.status?[n.reason??e+" is unknown"]:[]),...t?.obligations.flatMap(e=>"unknown"===e.status?[e.message]:[])??[],...i.claims.flatMap(e=>"unknown"===e.status?[`Claim ${e.id} has unknown status`]:[])]),o=t?.status??"unknown";return{outcome:o,outcomeLabel:n(o),time:s(i),claims:{total:i.claims.length,active:r.length,supported:r.filter(({status:e})=>"supported"===e).length,unresolved:r.filter(({status:e})=>!w.has(e)).length},evidence:{total:i.evidence.length,referenced:i.evidence.filter(({id:e})=>l.has(e)).length,unreferenced:i.evidence.filter(({id:e})=>!l.has(e)).length,missingReferences:[...l].filter(e=>!a.has(e)).length},policy:t?{status:"known",label:`${t.policy.id}@${t.policy.version}`}:{status:"unknown",label:"Unknown — no evaluation was supplied"},review:{status:d.length>0?"required":t?"clear":"unknown",count:d.length,items:d},unknowns:{count:c.length+(t?0:1),items:t?c:[...c,"Policy evaluation has not been supplied"]}}}function t({contract:e,fallbackLabel:n,open:s,onToggle:i}){const t=e.time;return(0,f.jsxs)("details",{open:s,onToggle:i,children:[(0,f.jsx)("summary",{children:"Time and as-of state"}),t?(0,f.jsxs)(f.Fragment,{children:[(0,f.jsxs)("dl",{children:[(0,f.jsxs)("div",{children:[(0,f.jsx)("dt",{children:"Presentation"}),(0,f.jsx)("dd",{children:t.presentation?.label??t.presentation?.state??"Unknown — no presentation state is declared"})]}),(0,f.jsxs)("div",{children:[(0,f.jsx)("dt",{children:"Event time"}),(0,f.jsxs)("dd",{children:[t.eventTime?.value??t.eventTime?.field??"Unknown — no event-time value or field is declared",t.eventTime?.timezone?" · "+t.eventTime.timezone:"",t.eventTime?.granularity?" · "+t.eventTime.granularity:""]})]}),(0,f.jsxs)("div",{children:[(0,f.jsx)("dt",{children:"Window"}),(0,f.jsx)("dd",{children:t.window?`${t.window.start} through ${t.window.end} · ${t.window.status}`:"Unknown — no reporting window is declared"})]}),(0,f.jsxs)("div",{children:[(0,f.jsx)("dt",{children:"Observed"}),(0,f.jsx)("dd",{children:t.observedAt??"Unknown"})]}),(0,f.jsxs)("div",{children:[(0,f.jsx)("dt",{children:"Ingested"}),(0,f.jsx)("dd",{children:t.ingestedAt??"Unknown"})]}),(0,f.jsxs)("div",{children:[(0,f.jsx)("dt",{children:"Processed"}),(0,f.jsx)("dd",{children:t.processedAt??"Unknown"})]}),(0,f.jsxs)("div",{children:[(0,f.jsx)("dt",{children:"Published"}),(0,f.jsx)("dd",{children:t.publishedAt??"Unknown"})]}),(0,f.jsxs)("div",{children:[(0,f.jsx)("dt",{children:"Snapshot"}),(0,f.jsx)("dd",{children:t.snapshotAt??"Unknown"})]}),(0,f.jsxs)("div",{children:[(0,f.jsx)("dt",{children:"Freshness"}),(0,f.jsx)("dd",{children:t.freshness?`${t.freshness.status}${t.freshness.basis?" · "+t.freshness.basis:""}`:"Unknown — no freshness check is declared"})]}),(0,f.jsxs)("div",{children:[(0,f.jsx)("dt",{children:"Completeness"}),(0,f.jsx)("dd",{children:t.completeness?`${t.completeness.status}${t.completeness.basis?" · "+t.completeness.basis:""}`:"Unknown — no completeness state is declared"})]}),(0,f.jsxs)("div",{children:[(0,f.jsx)("dt",{children:"Watermark"}),(0,f.jsx)("dd",{children:t.watermark?`${t.watermark.value}${t.watermark.allowedLateness?" · allowed lateness "+t.watermark.allowedLateness:""}`:"Not declared"})]})]}),t.sources?.length?(0,f.jsxs)(f.Fragment,{children:[(0,f.jsx)("p",{children:(0,f.jsx)("strong",{children:"Source clocks"})}),(0,f.jsx)("ul",{children:t.sources.map(e=>(0,f.jsxs)("li",{children:[(0,f.jsx)("strong",{children:e.label??e.id})," · ",e.kind,e.observedAt?" · "+e.observedAt:""," · freshness ",e.freshness??"unknown"," · completeness"," ",e.completeness??"unknown"]},e.id))})]}):null]}):(0,f.jsxs)("p",{children:[n,"."]})]})}function r({contract:e,open:n,onToggle:s}){return(0,f.jsxs)("details",{open:n,onToggle:s,children:[(0,f.jsx)("summary",{children:"Corrections and history"}),e.time?.revision?(0,f.jsxs)("p",{children:["Revision state: ",(0,f.jsx)("strong",{children:e.time.revision.status}),e.time.revision.reason?" · "+e.time.revision.reason:"",e.time.revision.previousArtifactId?" · previous artifact "+e.time.revision.previousArtifactId:""]}):(0,f.jsx)("p",{children:"Unknown — no temporal revision state is declared."}),e.contestability?.corrections?.length?(0,f.jsx)("ul",{children:e.contestability.corrections.map(e=>(0,f.jsxs)("li",{children:[(0,f.jsx)("strong",{children:e.id})," · ",e.reason," · affected"," ",e.affectedClaimIds.join(", ")||"no named claims",e.replacementClaimIds?.length?" · replacements "+e.replacementClaimIds.join(", "):"",e.createdAt?" · "+e.createdAt:""]},e.id))}):(0,f.jsx)("p",{children:"No correction history is declared."}),e.contestability?.challenges?.length?(0,f.jsxs)(f.Fragment,{children:[(0,f.jsx)("p",{children:(0,f.jsx)("strong",{children:"Challenges"})}),(0,f.jsx)("ul",{children:e.contestability.challenges.map(e=>(0,f.jsxs)("li",{children:[(0,f.jsx)("strong",{children:e.status})," · claim ",e.claimId," ","· ",e.reason]},e.id))})]}):null,e.accountability?.reviews?.length?(0,f.jsxs)(f.Fragment,{children:[(0,f.jsx)("p",{children:(0,f.jsx)("strong",{children:"Reviews"})}),(0,f.jsx)("ul",{children:e.accountability.reviews.map(e=>(0,f.jsxs)("li",{children:[(0,f.jsx)("strong",{children:e.status}),e.reviewer?.name?" · "+e.reviewer.name:"",e.reviewedAt?" · "+e.reviewedAt:"",e.rationale?" · "+e.rationale:""]},e.id))})]}):null,e.accountability?.actions?.length?(0,f.jsxs)(f.Fragment,{children:[(0,f.jsx)("p",{children:(0,f.jsx)("strong",{children:"Recorded actions"})}),(0,f.jsx)("ul",{children:e.accountability.actions.map(e=>(0,f.jsxs)("li",{children:[(0,f.jsx)("strong",{children:e.status??"recorded"})," · ",e.action,e.claimIds.length?" · claims "+e.claimIds.join(", "):"",e.actedAt?" · "+e.actedAt:""]},e.id))})]}):null]})}function l({contract:e,evaluation:n,open:s,onToggle:i}){return(0,f.jsxs)("details",{open:s,onToggle:i,children:[(0,f.jsx)("summary",{children:"Alternative views"}),(0,f.jsxs)("dl",{children:[(0,f.jsxs)("div",{children:[(0,f.jsx)("dt",{children:"Selected form"}),(0,f.jsx)("dd",{children:e.form?.chartFamily??"Unknown — no chart family is declared"})]}),(0,f.jsxs)("div",{children:[(0,f.jsx)("dt",{children:"Why this form"}),(0,f.jsx)("dd",{children:e.form?.whyThisForm??"Unknown — no representation rationale is declared"})]})]}),e.contestability?.alternativeViews?.length?(0,f.jsx)("ul",{children:e.contestability.alternativeViews.map(e=>(0,f.jsxs)("li",{children:[(0,f.jsx)("strong",{children:e.label}),e.rationale?" · "+e.rationale:""]},e.id))}):(0,f.jsx)("p",{children:"No named alternative views are declared."}),n?.alternatives?.length?(0,f.jsxs)(f.Fragment,{children:[(0,f.jsx)("p",{children:(0,f.jsx)("strong",{children:"Evaluation alternatives"})}),(0,f.jsx)("ul",{children:n.alternatives.map(e=>(0,f.jsxs)("li",{children:[(0,f.jsx)("strong",{children:e.label}),e.reasons?.length?" · "+e.reasons.join(" "):""]},e.id))})]}):null,e.form?.rejectedAlternatives?.length?(0,f.jsxs)(f.Fragment,{children:[(0,f.jsx)("p",{children:(0,f.jsx)("strong",{children:"Considered but not selected"})}),(0,f.jsx)("ul",{children:e.form.rejectedAlternatives.map(e=>(0,f.jsxs)("li",{children:[(0,f.jsx)("strong",{children:e.representation})," ·"," ",e.reason]},`${e.representation}:${e.reason}`))})]}):null]})}function a(e){return e.text??`Structured ${e.kind} claim ${e.id}`}function d(e){return e.label??e.source?.name??e.id}function c(e,n=new Set){if(null===e||"object"!=typeof e)return"bigint"==typeof e?""+e:e;if(n.has(e))return"[Circular]";n.add(e);try{return Array.isArray(e)?e.map(e=>c(e,n)):Object.fromEntries(Object.entries(e).filter(([,e])=>!["undefined","function","symbol"].includes(typeof e)).sort(([e],[n])=>n>e?-1:e>n?1:0).map(([e,s])=>[e,c(s,n)]))}finally{n.delete(e)}}function o(e,n){return JSON.stringify(c({contract:e,evaluation:n?{alternatives:n.alternatives??[],manualChecks:n.manualChecks??[],obligations:n.obligations,policy:n.policy,status:n.status}:{reason:"No policy evaluation was supplied",status:"unknown"},format:"semiotic-artifact-inspection/v1"}),null,2)}function h(e,n){return e?e.includes(n):void 0}function u({contract:e,evaluation:n,title:s="Artifact details",headingLevel:c=2,expandedSections:u,onDisclosureChange:j,className:m,...x}){const p=i(e,n),v="h"+c,g=["semiotic-artifact-inspector",m].filter(Boolean).join(" "),w=e=>j?n=>{n.target===n.currentTarget&&j(e,n.currentTarget.open)}:void 0,f="required"===p.review.status?`${p.review.count} manual review item${1===p.review.count?"":"s"}`:"clear"===p.review.status?"No manual review items reported":"Manual review state is unknown";return(0,b.jsxs)("section",{...x,className:g,"aria-label":x["aria-label"]??(x["aria-labelledby"]?void 0:s),"data-outcome":p.outcome,children:[(0,b.jsxs)("header",{className:"semiotic-artifact-inspector__header",children:[(0,b.jsx)(v,{children:s}),e.artifact.title?(0,b.jsx)("p",{children:e.artifact.title}):null,(0,b.jsx)("p",{role:"status","aria-live":"polite","aria-atomic":"true",children:(0,b.jsx)("strong",{children:p.outcomeLabel})})]}),(0,b.jsxs)("dl",{className:"semiotic-artifact-inspector__summary",children:[(0,b.jsxs)("div",{"data-signal":"status",children:[(0,b.jsx)("dt",{children:"Status"}),(0,b.jsx)("dd",{children:p.outcome})]}),(0,b.jsxs)("div",{"data-signal":"time","data-state":p.time.status,children:[(0,b.jsx)("dt",{children:"Time"}),(0,b.jsxs)("dd",{children:[p.time.label," (",p.time.status,")"]})]}),(0,b.jsxs)("div",{"data-signal":"claims",children:[(0,b.jsx)("dt",{children:"Claims"}),(0,b.jsxs)("dd",{children:[p.claims.supported," supported · ",p.claims.unresolved," ","unresolved · ",p.claims.total," total"]})]}),(0,b.jsxs)("div",{"data-signal":"evidence",children:[(0,b.jsx)("dt",{children:"Evidence"}),(0,b.jsxs)("dd",{children:[p.evidence.referenced," referenced ·"," ",p.evidence.unreferenced," unreferenced ·"," ",p.evidence.missingReferences," missing reference",1===p.evidence.missingReferences?"":"s"]})]}),(0,b.jsxs)("div",{"data-signal":"policy","data-state":p.policy.status,children:[(0,b.jsx)("dt",{children:"Policy"}),(0,b.jsx)("dd",{children:p.policy.label})]}),(0,b.jsxs)("div",{"data-signal":"review","data-state":p.review.status,children:[(0,b.jsx)("dt",{children:"Review"}),(0,b.jsx)("dd",{children:f})]})]}),(0,b.jsxs)("details",{className:"semiotic-artifact-inspector__details",open:h(u,"details"),onToggle:w("details"),children:[(0,b.jsx)("summary",{children:"Inspect claims, evidence, policy, and machine-readable detail"}),(0,b.jsxs)("details",{open:h(u,"claims"),onToggle:w("claims"),children:[(0,b.jsxs)("summary",{children:["Claims (",e.claims.length,")"]}),e.claims.length>0?(0,b.jsx)("ol",{children:e.claims.map(e=>(0,b.jsxs)("li",{"data-status":e.status,children:[(0,b.jsx)("strong",{children:a(e)}),(0,b.jsxs)("dl",{children:[(0,b.jsxs)("div",{children:[(0,b.jsx)("dt",{children:"Status"}),(0,b.jsx)("dd",{children:e.status})]}),(0,b.jsxs)("div",{children:[(0,b.jsx)("dt",{children:"Kind"}),(0,b.jsx)("dd",{children:e.kind})]}),(0,b.jsxs)("div",{children:[(0,b.jsx)("dt",{children:"Evidence"}),(0,b.jsx)("dd",{children:e.evidenceIds.length>0?e.evidenceIds.join(", "):"Unknown — no evidence reference is declared"})]}),e.uncertainty?(0,b.jsxs)("div",{children:[(0,b.jsx)("dt",{children:"Uncertainty"}),(0,b.jsx)("dd",{children:e.uncertainty.description??e.uncertainty.kind})]}):null]})]},e.id))}):(0,b.jsx)("p",{children:"Unknown — no claims are declared."})]}),(0,b.jsx)(t,{contract:e,fallbackLabel:p.time.label,open:h(u,"time"),onToggle:w("time")}),(0,b.jsx)(r,{contract:e,open:h(u,"history"),onToggle:w("history")}),(0,b.jsx)(l,{contract:e,evaluation:n,open:h(u,"alternatives"),onToggle:w("alternatives")}),(0,b.jsxs)("details",{open:h(u,"evidence"),onToggle:w("evidence"),children:[(0,b.jsxs)("summary",{children:["Evidence (",e.evidence.length,")"]}),e.evidence.length>0?(0,b.jsx)("ul",{children:e.evidence.map(e=>(0,b.jsxs)("li",{children:[(0,b.jsx)("strong",{children:d(e)}),(0,b.jsxs)("dl",{children:[(0,b.jsxs)("div",{children:[(0,b.jsx)("dt",{children:"Identifier"}),(0,b.jsx)("dd",{children:e.id})]}),(0,b.jsxs)("div",{children:[(0,b.jsx)("dt",{children:"Role"}),(0,b.jsx)("dd",{children:e.role})]}),(0,b.jsxs)("div",{children:[(0,b.jsx)("dt",{children:"Source"}),(0,b.jsx)("dd",{children:e.source?.uri??e.source?.name??"Unknown — no source is declared"})]}),(0,b.jsxs)("div",{children:[(0,b.jsx)("dt",{children:"Fingerprint"}),(0,b.jsx)("dd",{children:e.fingerprint??"Unknown — no fingerprint is declared"})]})]})]},e.id))}):(0,b.jsx)("p",{children:"Unknown — no evidence records are declared."})]}),(0,b.jsxs)("details",{open:h(u,"policy"),onToggle:w("policy"),children:[(0,b.jsx)("summary",{children:"Policy and review"}),n?(0,b.jsxs)(b.Fragment,{children:[(0,b.jsxs)("p",{children:[n.policy.id,"@",n.policy.version," ·"," ",(y=n.obligations,["fail","warn","manual","unknown","pass","not-applicable"].flatMap(e=>{const n=y.filter(n=>n.status===e).length;return n>0?[[e,n]]:[]})).map(([e,n])=>`${n} ${e}`).join(" · ")||"No obligations reported"]}),n.obligations.length>0?(0,b.jsx)("ul",{children:n.obligations.map(e=>(0,b.jsxs)("li",{"data-status":e.status,children:[(0,b.jsx)("strong",{children:e.status})," ·"," ",e.message,e.repair?(0,b.jsxs)("span",{children:[" Suggested repair: ",e.repair]}):null]},e.id))}):null]}):(0,b.jsx)("p",{children:"Unknown — no policy evaluation was supplied."}),(0,b.jsx)("p",{children:(0,b.jsx)("strong",{children:"Manual review"})}),p.review.items.length>0?(0,b.jsx)("ul",{children:p.review.items.map(e=>(0,b.jsx)("li",{children:e},e))}):(0,b.jsxs)("p",{children:[f,"."]}),(0,b.jsx)("p",{children:(0,b.jsx)("strong",{children:"Unknown signals"})}),p.unknowns.items.length>0?(0,b.jsx)("ul",{children:p.unknowns.items.map(e=>(0,b.jsx)("li",{children:e},e))}):(0,b.jsx)("p",{children:"No unknown signals were reported."})]}),(0,b.jsxs)("details",{open:h(u,"machine"),onToggle:w("machine"),children:[(0,b.jsx)("summary",{children:"Machine-readable JSON"}),(0,b.jsx)("pre",{"aria-label":"Machine-readable artifact inspection",tabIndex:0,children:(0,b.jsx)("code",{children:o(e,n)})})]})]})]});var y}var j,m=Object.defineProperty,x=Object.getOwnPropertyDescriptor,p=Object.getOwnPropertyNames,v=Object.prototype.hasOwnProperty,g={};((e,n)=>{for(var s in n)m(e,s,{get:n[s],enumerable:!0})})(g,{ArtifactInspector:()=>u,summarizeArtifactInspection:()=>i}),module.exports=(j=g,((e,n,s,i)=>{if(n)for(let s of p(n))v.call(e,s)||void 0===s||m(e,s,{get:()=>n[s],enumerable:!(i=x(n,s))||i.enumerable});return e})(m({},"__esModule",{value:!0}),j));var w=new Set(["supported","superseded","retracted"]),f=require("react/jsx-runtime"),b=require("react/jsx-runtime");
@@ -0,0 +1,2 @@
1
+ "use client";
2
+ function e(e){return[...new Set(e.filter(Boolean))]}function n(e){return"acceptable"===e?"Acceptable under the active policy":"conditional"===e?"Conditional — follow-up is required":"refuse"===e?"Refused by the active policy":"Not evaluated — policy outcome is unknown"}function i(e){let n=e.time;if(!n){let n=Object.entries(e.fieldStatus??{}).find(([e])=>"time"===e||e.startsWith("time."))?.[1];return{status:n?.status??"unknown",label:n?.reason??"Unknown — no time context is declared"}}let i=n.window?.status??n.completeness?.status??n.freshness?.status??n.presentation?.state??"unknown";if(n.presentation?.label)return{status:i,label:n.presentation.label};if(n.window)return{status:i,label:`${n.window.start} through ${n.window.end}`};if(n.eventTime?.value)return{status:i,label:"Event time "+n.eventTime.value};let t=n.snapshotAt??n.publishedAt??n.observedAt??n.processedAt;return t?{status:i,label:"Recorded at "+t}:{status:i,label:"Unknown — time context has no readable timestamp"}}function t(t,l){let r=t.claims.filter(({status:e})=>"superseded"!==e&&"retracted"!==e),a=new Set(t.claims.flatMap(({evidenceIds:e})=>e)),d=new Set(t.evidence.map(({id:e})=>e)),s=e([...t.reception?.manualChecks??[],...Object.entries(t.fieldStatus??{}).flatMap(([e,n])=>"manual"===n.status?[n.reason??e+" requires manual review"]:[]),...l?.manualChecks??[],...l?.obligations.flatMap(e=>"manual"===e.status?[e.message]:[])??[]]),c=e([...Object.entries(t.fieldStatus??{}).flatMap(([e,n])=>"unknown"===n.status?[n.reason??e+" is unknown"]:[]),...l?.obligations.flatMap(e=>"unknown"===e.status?[e.message]:[])??[],...t.claims.flatMap(e=>"unknown"===e.status?[`Claim ${e.id} has unknown status`]:[])]),o=l?.status??"unknown";return{outcome:o,outcomeLabel:n(o),time:i(t),claims:{total:t.claims.length,active:r.length,supported:r.filter(({status:e})=>"supported"===e).length,unresolved:r.filter(({status:e})=>!m.has(e)).length},evidence:{total:t.evidence.length,referenced:t.evidence.filter(({id:e})=>a.has(e)).length,unreferenced:t.evidence.filter(({id:e})=>!a.has(e)).length,missingReferences:[...a].filter(e=>!d.has(e)).length},policy:l?{status:"known",label:`${l.policy.id}@${l.policy.version}`}:{status:"unknown",label:"Unknown — no evaluation was supplied"},review:{status:s.length>0?"required":l?"clear":"unknown",count:s.length,items:s},unknowns:{count:c.length+(l?0:1),items:l?c:[...c,"Policy evaluation has not been supplied"]}}}function l({contract:e,fallbackLabel:n,open:i,onToggle:t}){let l=e.time;return g("details",{open:i,onToggle:t,children:[v("summary",{children:"Time and as-of state"}),l?g(p,{children:[g("dl",{children:[g("div",{children:[v("dt",{children:"Presentation"}),v("dd",{children:l.presentation?.label??l.presentation?.state??"Unknown — no presentation state is declared"})]}),g("div",{children:[v("dt",{children:"Event time"}),g("dd",{children:[l.eventTime?.value??l.eventTime?.field??"Unknown — no event-time value or field is declared",l.eventTime?.timezone?" · "+l.eventTime.timezone:"",l.eventTime?.granularity?" · "+l.eventTime.granularity:""]})]}),g("div",{children:[v("dt",{children:"Window"}),v("dd",{children:l.window?`${l.window.start} through ${l.window.end} · ${l.window.status}`:"Unknown — no reporting window is declared"})]}),g("div",{children:[v("dt",{children:"Observed"}),v("dd",{children:l.observedAt??"Unknown"})]}),g("div",{children:[v("dt",{children:"Ingested"}),v("dd",{children:l.ingestedAt??"Unknown"})]}),g("div",{children:[v("dt",{children:"Processed"}),v("dd",{children:l.processedAt??"Unknown"})]}),g("div",{children:[v("dt",{children:"Published"}),v("dd",{children:l.publishedAt??"Unknown"})]}),g("div",{children:[v("dt",{children:"Snapshot"}),v("dd",{children:l.snapshotAt??"Unknown"})]}),g("div",{children:[v("dt",{children:"Freshness"}),v("dd",{children:l.freshness?`${l.freshness.status}${l.freshness.basis?" · "+l.freshness.basis:""}`:"Unknown — no freshness check is declared"})]}),g("div",{children:[v("dt",{children:"Completeness"}),v("dd",{children:l.completeness?`${l.completeness.status}${l.completeness.basis?" · "+l.completeness.basis:""}`:"Unknown — no completeness state is declared"})]}),g("div",{children:[v("dt",{children:"Watermark"}),v("dd",{children:l.watermark?`${l.watermark.value}${l.watermark.allowedLateness?" · allowed lateness "+l.watermark.allowedLateness:""}`:"Not declared"})]})]}),l.sources?.length?g(p,{children:[v("p",{children:v("strong",{children:"Source clocks"})}),v("ul",{children:l.sources.map(e=>g("li",{children:[v("strong",{children:e.label??e.id})," · ",e.kind,e.observedAt?" · "+e.observedAt:""," · freshness ",e.freshness??"unknown"," · completeness"," ",e.completeness??"unknown"]},e.id))})]}):null]}):g("p",{children:[n,"."]})]})}function r({contract:e,open:n,onToggle:i}){return g("details",{open:n,onToggle:i,children:[v("summary",{children:"Corrections and history"}),e.time?.revision?g("p",{children:["Revision state: ",v("strong",{children:e.time.revision.status}),e.time.revision.reason?" · "+e.time.revision.reason:"",e.time.revision.previousArtifactId?" · previous artifact "+e.time.revision.previousArtifactId:""]}):v("p",{children:"Unknown — no temporal revision state is declared."}),e.contestability?.corrections?.length?v("ul",{children:e.contestability.corrections.map(e=>g("li",{children:[v("strong",{children:e.id})," · ",e.reason," · affected"," ",e.affectedClaimIds.join(", ")||"no named claims",e.replacementClaimIds?.length?" · replacements "+e.replacementClaimIds.join(", "):"",e.createdAt?" · "+e.createdAt:""]},e.id))}):v("p",{children:"No correction history is declared."}),e.contestability?.challenges?.length?g(p,{children:[v("p",{children:v("strong",{children:"Challenges"})}),v("ul",{children:e.contestability.challenges.map(e=>g("li",{children:[v("strong",{children:e.status})," · claim ",e.claimId," ","· ",e.reason]},e.id))})]}):null,e.accountability?.reviews?.length?g(p,{children:[v("p",{children:v("strong",{children:"Reviews"})}),v("ul",{children:e.accountability.reviews.map(e=>g("li",{children:[v("strong",{children:e.status}),e.reviewer?.name?" · "+e.reviewer.name:"",e.reviewedAt?" · "+e.reviewedAt:"",e.rationale?" · "+e.rationale:""]},e.id))})]}):null,e.accountability?.actions?.length?g(p,{children:[v("p",{children:v("strong",{children:"Recorded actions"})}),v("ul",{children:e.accountability.actions.map(e=>g("li",{children:[v("strong",{children:e.status??"recorded"})," · ",e.action,e.claimIds.length?" · claims "+e.claimIds.join(", "):"",e.actedAt?" · "+e.actedAt:""]},e.id))})]}):null]})}function a({contract:e,evaluation:n,open:i,onToggle:t}){return g("details",{open:i,onToggle:t,children:[v("summary",{children:"Alternative views"}),g("dl",{children:[g("div",{children:[v("dt",{children:"Selected form"}),v("dd",{children:e.form?.chartFamily??"Unknown — no chart family is declared"})]}),g("div",{children:[v("dt",{children:"Why this form"}),v("dd",{children:e.form?.whyThisForm??"Unknown — no representation rationale is declared"})]})]}),e.contestability?.alternativeViews?.length?v("ul",{children:e.contestability.alternativeViews.map(e=>g("li",{children:[v("strong",{children:e.label}),e.rationale?" · "+e.rationale:""]},e.id))}):v("p",{children:"No named alternative views are declared."}),n?.alternatives?.length?g(p,{children:[v("p",{children:v("strong",{children:"Evaluation alternatives"})}),v("ul",{children:n.alternatives.map(e=>g("li",{children:[v("strong",{children:e.label}),e.reasons?.length?" · "+e.reasons.join(" "):""]},e.id))})]}):null,e.form?.rejectedAlternatives?.length?g(p,{children:[v("p",{children:v("strong",{children:"Considered but not selected"})}),v("ul",{children:e.form.rejectedAlternatives.map(e=>g("li",{children:[v("strong",{children:e.representation})," ·"," ",e.reason]},`${e.representation}:${e.reason}`))})]}):null]})}function d(e){return e.text??`Structured ${e.kind} claim ${e.id}`}function s(e){return e.label??e.source?.name??e.id}function c(e,n=new Set){if(null===e||"object"!=typeof e)return"bigint"==typeof e?""+e:e;if(n.has(e))return"[Circular]";n.add(e);try{return Array.isArray(e)?e.map(e=>c(e,n)):Object.fromEntries(Object.entries(e).filter(([,e])=>!["undefined","function","symbol"].includes(typeof e)).sort(([e],[n])=>n>e?-1:e>n?1:0).map(([e,i])=>[e,c(i,n)]))}finally{n.delete(e)}}function o(e,n){return JSON.stringify(c({contract:e,evaluation:n?{alternatives:n.alternatives??[],manualChecks:n.manualChecks??[],obligations:n.obligations,policy:n.policy,status:n.status}:{reason:"No policy evaluation was supplied",status:"unknown"},format:"semiotic-artifact-inspection/v1"}),null,2)}function h(e,n){return e?e.includes(n):void 0}function u({contract:e,evaluation:n,title:i="Artifact details",headingLevel:c=2,expandedSections:u,onDisclosureChange:m,className:p,...v}){let g=t(e,n),y="h"+c,k=["semiotic-artifact-inspector",p].filter(Boolean).join(" "),T=e=>m?n=>{n.target===n.currentTarget&&m(e,n.currentTarget.open)}:void 0,A="required"===g.review.status?`${g.review.count} manual review item${1===g.review.count?"":"s"}`:"clear"===g.review.status?"No manual review items reported":"Manual review state is unknown";return b("section",{...v,className:k,"aria-label":v["aria-label"]??(v["aria-labelledby"]?void 0:i),"data-outcome":g.outcome,children:[b("header",{className:"semiotic-artifact-inspector__header",children:[f(y,{children:i}),e.artifact.title?f("p",{children:e.artifact.title}):null,f("p",{role:"status","aria-live":"polite","aria-atomic":"true",children:f("strong",{children:g.outcomeLabel})})]}),b("dl",{className:"semiotic-artifact-inspector__summary",children:[b("div",{"data-signal":"status",children:[f("dt",{children:"Status"}),f("dd",{children:g.outcome})]}),b("div",{"data-signal":"time","data-state":g.time.status,children:[f("dt",{children:"Time"}),b("dd",{children:[g.time.label," (",g.time.status,")"]})]}),b("div",{"data-signal":"claims",children:[f("dt",{children:"Claims"}),b("dd",{children:[g.claims.supported," supported · ",g.claims.unresolved," ","unresolved · ",g.claims.total," total"]})]}),b("div",{"data-signal":"evidence",children:[f("dt",{children:"Evidence"}),b("dd",{children:[g.evidence.referenced," referenced ·"," ",g.evidence.unreferenced," unreferenced ·"," ",g.evidence.missingReferences," missing reference",1===g.evidence.missingReferences?"":"s"]})]}),b("div",{"data-signal":"policy","data-state":g.policy.status,children:[f("dt",{children:"Policy"}),f("dd",{children:g.policy.label})]}),b("div",{"data-signal":"review","data-state":g.review.status,children:[f("dt",{children:"Review"}),f("dd",{children:A})]})]}),b("details",{className:"semiotic-artifact-inspector__details",open:h(u,"details"),onToggle:T("details"),children:[f("summary",{children:"Inspect claims, evidence, policy, and machine-readable detail"}),b("details",{open:h(u,"claims"),onToggle:T("claims"),children:[b("summary",{children:["Claims (",e.claims.length,")"]}),e.claims.length>0?f("ol",{children:e.claims.map(e=>b("li",{"data-status":e.status,children:[f("strong",{children:d(e)}),b("dl",{children:[b("div",{children:[f("dt",{children:"Status"}),f("dd",{children:e.status})]}),b("div",{children:[f("dt",{children:"Kind"}),f("dd",{children:e.kind})]}),b("div",{children:[f("dt",{children:"Evidence"}),f("dd",{children:e.evidenceIds.length>0?e.evidenceIds.join(", "):"Unknown — no evidence reference is declared"})]}),e.uncertainty?b("div",{children:[f("dt",{children:"Uncertainty"}),f("dd",{children:e.uncertainty.description??e.uncertainty.kind})]}):null]})]},e.id))}):f("p",{children:"Unknown — no claims are declared."})]}),f(l,{contract:e,fallbackLabel:g.time.label,open:h(u,"time"),onToggle:T("time")}),f(r,{contract:e,open:h(u,"history"),onToggle:T("history")}),f(a,{contract:e,evaluation:n,open:h(u,"alternatives"),onToggle:T("alternatives")}),b("details",{open:h(u,"evidence"),onToggle:T("evidence"),children:[b("summary",{children:["Evidence (",e.evidence.length,")"]}),e.evidence.length>0?f("ul",{children:e.evidence.map(e=>b("li",{children:[f("strong",{children:s(e)}),b("dl",{children:[b("div",{children:[f("dt",{children:"Identifier"}),f("dd",{children:e.id})]}),b("div",{children:[f("dt",{children:"Role"}),f("dd",{children:e.role})]}),b("div",{children:[f("dt",{children:"Source"}),f("dd",{children:e.source?.uri??e.source?.name??"Unknown — no source is declared"})]}),b("div",{children:[f("dt",{children:"Fingerprint"}),f("dd",{children:e.fingerprint??"Unknown — no fingerprint is declared"})]})]})]},e.id))}):f("p",{children:"Unknown — no evidence records are declared."})]}),b("details",{open:h(u,"policy"),onToggle:T("policy"),children:[f("summary",{children:"Policy and review"}),n?b(w,{children:[b("p",{children:[n.policy.id,"@",n.policy.version," ·"," ",(U=n.obligations,["fail","warn","manual","unknown","pass","not-applicable"].flatMap(e=>{let n=U.filter(n=>n.status===e).length;return n>0?[[e,n]]:[]})).map(([e,n])=>`${n} ${e}`).join(" · ")||"No obligations reported"]}),n.obligations.length>0?f("ul",{children:n.obligations.map(e=>b("li",{"data-status":e.status,children:[f("strong",{children:e.status})," ·"," ",e.message,e.repair?b("span",{children:[" Suggested repair: ",e.repair]}):null]},e.id))}):null]}):f("p",{children:"Unknown — no policy evaluation was supplied."}),f("p",{children:f("strong",{children:"Manual review"})}),g.review.items.length>0?f("ul",{children:g.review.items.map(e=>f("li",{children:e},e))}):b("p",{children:[A,"."]}),f("p",{children:f("strong",{children:"Unknown signals"})}),g.unknowns.items.length>0?f("ul",{children:g.unknowns.items.map(e=>f("li",{children:e},e))}):f("p",{children:"No unknown signals were reported."})]}),b("details",{open:h(u,"machine"),onToggle:T("machine"),children:[f("summary",{children:"Machine-readable JSON"}),f("pre",{"aria-label":"Machine-readable artifact inspection",tabIndex:0,children:f("code",{children:o(e,n)})})]})]})]});var U}var m=new Set(["supported","superseded","retracted"]);import{Fragment as p,jsx as v,jsxs as g}from"react/jsx-runtime";import{Fragment as w,jsx as f,jsxs as b}from"react/jsx-runtime";export{u as ArtifactInspector,t as summarizeArtifactInspection};
@@ -0,0 +1,23 @@
1
+ /**
2
+ * Semiotic artifact contracts — renderer-independent interpretation,
3
+ * provenance, time, policy, evaluation, and transfer utilities.
4
+ *
5
+ * Import from `semiotic/artifact` when a chart, dashboard, service, or agent
6
+ * needs to carry the meaning and limits of an information artifact without
7
+ * importing React.
8
+ */
9
+ export * from "./components/artifact/types";
10
+ export * from "./components/artifact/fingerprint";
11
+ export * from "./components/artifact/contract";
12
+ export * from "./components/artifact/claims";
13
+ export * from "./components/artifact/temporal";
14
+ export * from "./components/artifact/policies";
15
+ export * from "./components/artifact/representation";
16
+ export * from "./components/artifact/evaluateArtifact";
17
+ export * from "./components/artifact/grounding";
18
+ export * from "./components/artifact/collection";
19
+ export * from "./components/artifact/inheritance";
20
+ export * from "./components/artifact/hostTransfer";
21
+ export * from "./components/artifact/serialization";
22
+ export * from "./components/artifact/obligations";
23
+ export * from "./components/artifact/artifactRevision";