semiotic 3.9.2 → 3.10.1

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 (537) hide show
  1. package/README.md +97 -76
  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/componentMetadata.cjs +3 -1
  8. package/ai/dist/mcp-server.js +68 -68
  9. package/ai/examples.md +68 -1
  10. package/ai/reference.md +105 -14
  11. package/ai/schema.json +6646 -18
  12. package/ai/surface-manifest.json +34 -6
  13. package/ai/system-prompt.md +2 -0
  14. package/ai/task-packets/compare-category-totals.json +301 -0
  15. package/ai/task-packets/compare-category-totals.md +188 -0
  16. package/ai/task-packets/correct-published-chart.json +271 -0
  17. package/ai/task-packets/correct-published-chart.md +597 -0
  18. package/ai/task-packets/index.json +40 -0
  19. package/ai/task-packets/update-live-chart.json +289 -0
  20. package/ai/task-packets/update-live-chart.md +424 -0
  21. package/dist/c-2N7IU2NY.min.js +1 -0
  22. package/dist/c-2RL2QPZJ.min.js +1 -0
  23. package/dist/c-2WK7YJLL.min.js +1 -0
  24. package/dist/c-42PLDTX7.min.js +1 -0
  25. package/dist/c-45CQWZZ6.min.js +1 -0
  26. package/dist/c-4BRHKVKV.min.js +1 -0
  27. package/dist/c-7242NXSG.min.js +1 -0
  28. package/dist/c-7DVPSB5C.min.js +1 -0
  29. package/dist/c-7EGHJU2F.min.js +1 -0
  30. package/dist/c-A7OGOFSL.min.js +1 -0
  31. package/dist/c-AFBSWT77.min.js +1 -0
  32. package/dist/c-AH5HWZWS.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-B7GW7IHJ.min.js +1 -0
  38. package/dist/c-BNFJMDHN.min.js +1 -0
  39. package/dist/c-BOHCQILI.min.js +1 -0
  40. package/dist/c-C3TZLTZK.min.js +1 -0
  41. package/dist/c-CGQAQWBV.min.js +1 -0
  42. package/dist/c-CPV4N35K.min.js +1 -0
  43. package/dist/c-D6HAAPTX.min.js +1 -0
  44. package/dist/c-DIPEYUOW.min.js +1 -0
  45. package/dist/c-E4JDJH4I.min.js +1 -0
  46. package/dist/c-E72OTUZU.min.js +1 -0
  47. package/dist/c-E7I2L7CU.min.js +1 -0
  48. package/dist/c-ELDWAO2V.min.js +1 -0
  49. package/dist/c-EUBTECGM.min.js +1 -0
  50. package/dist/c-EUMPMDCS.min.js +1 -0
  51. package/dist/c-EZZT2WAE.min.js +1 -0
  52. package/dist/c-FHBVFCQB.min.js +1 -0
  53. package/dist/c-G4HCO2IQ.min.js +1 -0
  54. package/dist/c-G5VIJEOK.min.js +1 -0
  55. package/dist/c-GHVOXAYH.min.js +1 -0
  56. package/dist/c-GNTXRXRN.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-HP4ZFM47.min.js +1 -0
  61. package/dist/c-HPOYKCCG.min.js +1 -0
  62. package/dist/c-HYDTS5OP.min.js +1 -0
  63. package/dist/c-I4QJ6YLM.min.js +1 -0
  64. package/dist/c-IK33LNZ6.min.js +1 -0
  65. package/dist/c-IK3PZHRY.min.js +1 -0
  66. package/dist/c-J6DVC236.min.js +1 -0
  67. package/dist/c-JIMJF6F6.min.js +1 -0
  68. package/dist/c-JUKIWTBJ.min.js +1 -0
  69. package/dist/c-KKPMHAZC.min.js +1 -0
  70. package/dist/c-L6WNDBHV.min.js +1 -0
  71. package/dist/c-LDEX5OFW.min.js +1 -0
  72. package/dist/c-LESEUVC5.min.js +1 -0
  73. package/dist/c-LYQMZMZQ.min.js +1 -0
  74. package/dist/c-MB6CV5NC.min.js +1 -0
  75. package/dist/c-MOKJOIPE.min.js +1 -0
  76. package/dist/c-MVR3RWF3.min.js +1 -0
  77. package/dist/c-N3FXLRNT.min.js +1 -0
  78. package/dist/c-N5NPTJVJ.min.js +1 -0
  79. package/dist/c-NHBL4J67.min.js +1 -0
  80. package/dist/c-ODG6TFSY.min.js +1 -0
  81. package/dist/c-ORLEBW72.min.js +1 -0
  82. package/dist/c-P65V6HLO.min.js +1 -0
  83. package/dist/c-PRIKOLTE.min.js +1 -0
  84. package/dist/c-PSKKFZNP.min.js +1 -0
  85. package/dist/c-PSNI6KAZ.min.js +1 -0
  86. package/dist/c-QA3HMQJP.min.js +1 -0
  87. package/dist/c-R2P4RR7Q.min.js +1 -0
  88. package/dist/c-RFC7UAG7.min.js +1 -0
  89. package/dist/c-S3AZX5PP.min.js +1 -0
  90. package/dist/c-SGAURYHG.min.js +1 -0
  91. package/dist/c-SJMWU6UX.min.js +1 -0
  92. package/dist/c-STIIGQOD.min.js +1 -0
  93. package/dist/c-T2ASIJVZ.min.js +1 -0
  94. package/dist/c-T2V7O2LO.min.js +1 -0
  95. package/dist/c-TKG2NP7G.min.js +1 -0
  96. package/dist/c-TX3THUTO.min.js +1 -0
  97. package/dist/c-TX7XJM3Z.min.js +1 -0
  98. package/dist/c-UC7SIU2W.min.js +1 -0
  99. package/dist/c-UMXSJIOV.min.js +1 -0
  100. package/dist/c-VJTDST2R.min.js +1 -0
  101. package/dist/c-VRSXMLYF.min.js +1 -0
  102. package/dist/c-VSLWSAN2.min.js +1 -0
  103. package/dist/c-VXLOLYTO.min.js +1 -0
  104. package/dist/c-W4ZUKSEQ.min.js +1 -0
  105. package/dist/c-WCBRPILW.min.js +1 -0
  106. package/dist/c-WGHT7OCY.min.js +1 -0
  107. package/dist/c-WUWXGQYA.min.js +1 -0
  108. package/dist/c-WWCW3APR.min.js +1 -0
  109. package/dist/{c-CKLIFCGN.min.js → c-XSB27XPS.min.js} +1 -1
  110. package/dist/c-Y6PYUMFU.min.js +1 -0
  111. package/dist/c-YDECTEUW.min.js +1 -0
  112. package/dist/c-YF3YKVQI.min.js +1 -0
  113. package/dist/c-YLZIV3VS.min.js +1 -0
  114. package/dist/c-ZIVPFTOC.min.js +1 -0
  115. package/dist/components/Annotation.d.ts +2 -1
  116. package/dist/components/ai/chartRecipeRegistry.d.ts +6 -1
  117. package/dist/components/ai/chartRecipes.d.ts +4 -0
  118. package/dist/components/ai/describePhysicsProjection.d.ts +18 -0
  119. package/dist/components/ai/describePhysicsSource.d.ts +13 -0
  120. package/dist/components/artifact/ArtifactInspector.d.ts +26 -0
  121. package/dist/components/artifact/ArtifactInspectorContextSections.d.ts +18 -0
  122. package/dist/components/artifact/artifactContractDiff.d.ts +8 -0
  123. package/dist/components/artifact/artifactInspectorSummary.d.ts +53 -0
  124. package/dist/components/artifact/artifactRevision.d.ts +54 -0
  125. package/dist/components/artifact/artifactTestFixtures.d.ts +17 -0
  126. package/dist/components/artifact/attachmentAudit.d.ts +13 -0
  127. package/dist/components/artifact/claimCorrections.d.ts +3 -0
  128. package/dist/components/artifact/claimGraph.d.ts +5 -0
  129. package/dist/components/artifact/claimLifecycle.d.ts +32 -0
  130. package/dist/components/artifact/claims.d.ts +24 -0
  131. package/dist/components/artifact/collection.d.ts +10 -0
  132. package/dist/components/artifact/collectionCorrectionScope.d.ts +4 -0
  133. package/dist/components/artifact/collectionImpact.d.ts +11 -0
  134. package/dist/components/artifact/collectionLineage.d.ts +3 -0
  135. package/dist/components/artifact/collectionOperations.d.ts +8 -0
  136. package/dist/components/artifact/collectionPolicy.d.ts +22 -0
  137. package/dist/components/artifact/collectionTypes.d.ts +117 -0
  138. package/dist/components/artifact/configurationRepair.d.ts +8 -0
  139. package/dist/components/artifact/contract.d.ts +30 -0
  140. package/dist/components/artifact/evaluateArtifact.d.ts +12 -0
  141. package/dist/components/artifact/evaluateArtifactTypes.d.ts +78 -0
  142. package/dist/components/artifact/evaluationPresentation.d.ts +9 -0
  143. package/dist/components/artifact/evidenceSample.d.ts +8 -0
  144. package/dist/components/artifact/exportPaths.d.ts +8 -0
  145. package/dist/components/artifact/fieldPolicies.d.ts +12 -0
  146. package/dist/components/artifact/fingerprint.d.ts +36 -0
  147. package/dist/components/artifact/grounding.d.ts +51 -0
  148. package/dist/components/artifact/groundingBudget.d.ts +38 -0
  149. package/dist/components/artifact/hostTransfer.d.ts +13 -0
  150. package/dist/components/artifact/identity.d.ts +19 -0
  151. package/dist/components/artifact/inheritance.d.ts +48 -0
  152. package/dist/components/artifact/inheritanceIntegrity.d.ts +3 -0
  153. package/dist/components/artifact/jsonCompatibility.d.ts +2 -0
  154. package/dist/components/artifact/obligations.d.ts +3 -0
  155. package/dist/components/artifact/policies.d.ts +45 -0
  156. package/dist/components/artifact/policyRelations.d.ts +3 -0
  157. package/dist/components/artifact/recordProjection.d.ts +7 -0
  158. package/dist/components/artifact/representation.d.ts +50 -0
  159. package/dist/components/artifact/serialization.d.ts +40 -0
  160. package/dist/components/artifact/temporal.d.ts +32 -0
  161. package/dist/components/artifact/temporalAdapters.d.ts +75 -0
  162. package/dist/components/artifact/temporalAuditHelpers.d.ts +12 -0
  163. package/dist/components/artifact/temporalPresentation.d.ts +8 -0
  164. package/dist/components/artifact/types.d.ts +341 -0
  165. package/dist/components/artifact/validation.d.ts +13 -0
  166. package/dist/components/artifact/validationFieldStatus.d.ts +7 -0
  167. package/dist/components/artifact/validationPrimitives.d.ts +24 -0
  168. package/dist/components/artifact/validationSurfaces.d.ts +7 -0
  169. package/dist/components/artifact/validationTemporal.d.ts +3 -0
  170. package/dist/components/charts/geo/FlowMap.d.ts +7 -0
  171. package/dist/components/charts/geo/flowMapLineStyle.d.ts +18 -0
  172. package/dist/components/charts/ordinal/DonutChart.d.ts +2 -0
  173. package/dist/components/charts/ordinal/FunnelChart.d.ts +2 -0
  174. package/dist/components/charts/ordinal/GroupedBarChart.d.ts +6 -0
  175. package/dist/components/charts/ordinal/PieChart.d.ts +2 -0
  176. package/dist/components/charts/ordinal/RadarChart.d.ts +2 -0
  177. package/dist/components/charts/ordinal/StackedBarChart.d.ts +6 -0
  178. package/dist/components/charts/physics/CollisionSwarmChart.d.ts +1 -1
  179. package/dist/components/charts/physics/EventDropChart.d.ts +3 -1
  180. package/dist/components/charts/physics/GaltonBoardChart.d.ts +4 -2
  181. package/dist/components/charts/physics/ProcessFlowChart.d.ts +6 -0
  182. package/dist/components/charts/physics/UnitPileChart.d.ts +2 -1
  183. package/dist/components/charts/physics/collisionSwarmPacking.d.ts +14 -0
  184. package/dist/components/charts/physics/collisionSwarmPhysics.d.ts +1 -0
  185. package/dist/components/charts/physics/eventDropAdmission.d.ts +32 -0
  186. package/dist/components/charts/physics/eventDropPhysics.d.ts +22 -1
  187. package/dist/components/charts/physics/galtonBoardPhysics.d.ts +2 -9
  188. package/dist/components/charts/physics/physicsChartReconcile.d.ts +4 -0
  189. package/dist/components/charts/physics/physicsChartUtils.d.ts +1 -1
  190. package/dist/components/charts/physics/physicsGaltonData.d.ts +10 -0
  191. package/dist/components/charts/physics/physicsHocHandle.d.ts +2 -0
  192. package/dist/components/charts/physics/physicsPileData.d.ts +11 -0
  193. package/dist/components/charts/physics/physicsPilePhysics.d.ts +5 -12
  194. package/dist/components/charts/physics/physicsProjectionOverlays.d.ts +1 -1
  195. package/dist/components/charts/physics/physicsSourceRows.d.ts +8 -0
  196. package/dist/components/charts/physics/usePhysicsChartData.d.ts +19 -0
  197. package/dist/components/charts/realtime/RealtimeHeatmap.d.ts +4 -0
  198. package/dist/components/charts/realtime/RealtimeHistogram.d.ts +14 -6
  199. package/dist/components/charts/realtime/RealtimeLineChart.d.ts +4 -0
  200. package/dist/components/charts/realtime/RealtimeSwarmChart.d.ts +4 -0
  201. package/dist/components/charts/realtime/RealtimeWaterfallChart.d.ts +4 -0
  202. package/dist/components/charts/realtime/realtimeAccessors.d.ts +4 -0
  203. package/dist/components/charts/realtime/realtimeChartRuntime.d.ts +8 -7
  204. package/dist/components/charts/realtime/realtimeChartTypes.d.ts +7 -0
  205. package/dist/components/charts/realtime/temporalHistogramConfig.d.ts +17 -11
  206. package/dist/components/charts/shared/GaugeReadout.d.ts +9 -0
  207. package/dist/components/charts/shared/ThresholdAnnotation.d.ts +18 -0
  208. package/dist/components/charts/shared/ThresholdEndCap.d.ts +7 -0
  209. package/dist/components/charts/shared/auditAccessibilityText.d.ts +4 -2
  210. package/dist/components/charts/shared/chartDataProps.d.ts +3 -0
  211. package/dist/components/charts/shared/chartSpecAtlasSchemas.d.ts +5 -0
  212. package/dist/components/charts/shared/chartSpecCore.d.ts +4 -0
  213. package/dist/components/charts/shared/chartSpecsAtlas.d.ts +2 -0
  214. package/dist/components/charts/shared/hooks.d.ts +3 -1
  215. package/dist/components/charts/shared/knownChartComponents.d.ts +1 -1
  216. package/dist/components/charts/shared/numericTickFormatter.d.ts +2 -0
  217. package/dist/components/charts/shared/radialCenterContent.d.ts +10 -0
  218. package/dist/components/charts/shared/tooltipUtils.d.ts +1 -1
  219. package/dist/components/charts/shared/useChartLegend.d.ts +4 -0
  220. package/dist/components/charts/shared/useXYPointStyle.d.ts +2 -0
  221. package/dist/components/charts/xy/BubbleChart.d.ts +7 -0
  222. package/dist/components/charts/xy/CandlestickChart.d.ts +7 -0
  223. package/dist/components/charts/xy/DifferenceChart.d.ts +7 -0
  224. package/dist/components/charts/xy/MinimapChart.d.ts +7 -0
  225. package/dist/components/charts/xy/MultiAxisLineChart.d.ts +7 -0
  226. package/dist/components/charts/xy/ScatterplotMatrix.d.ts +6 -0
  227. package/dist/components/charts/xy/WaterfallChart.d.ts +8 -0
  228. package/dist/components/charts/xy/differenceMarkStyle.d.ts +28 -0
  229. package/dist/components/charts/xy/multiAxisFields.d.ts +23 -0
  230. package/dist/components/charts/xy/scatterplotMatrixCells.d.ts +50 -0
  231. package/dist/components/evidence/chartEvidenceEnvelope.d.ts +16 -8
  232. package/dist/components/evidence/evidenceEnvelopeInput.d.ts +8 -0
  233. package/dist/components/evidence/evidenceEnvelopeValidation.d.ts +11 -0
  234. package/dist/components/evidence/evidenceGate.d.ts +3 -1
  235. package/dist/components/evidence/renderedSceneHash.d.ts +23 -0
  236. package/dist/components/evidence/stableJsonHash.d.ts +4 -0
  237. package/dist/components/export/chartConfig.d.ts +40 -5
  238. package/dist/components/export/chartConfigArtifact.d.ts +6 -0
  239. package/dist/components/legendLayout.d.ts +18 -0
  240. package/dist/components/legendStyles.d.ts +4 -0
  241. package/dist/components/recipes/atlas/DependencyForestChart.d.ts +20 -0
  242. package/dist/components/recipes/atlas/DependencyMatrix.d.ts +7 -0
  243. package/dist/components/recipes/atlas/FlowCircuitChart.d.ts +20 -0
  244. package/dist/components/recipes/atlas/MotifBraidChart.d.ts +17 -0
  245. package/dist/components/recipes/atlas/atlasChartOptions.d.ts +11 -0
  246. package/dist/components/recipes/atlas/braid.d.ts +62 -0
  247. package/dist/components/recipes/atlas/capsules.d.ts +18 -0
  248. package/dist/components/recipes/atlas/compare.d.ts +4 -0
  249. package/dist/components/recipes/atlas/completeness.d.ts +2 -0
  250. package/dist/components/recipes/atlas/dependencyForest.d.ts +32 -0
  251. package/dist/components/recipes/atlas/dependencyForestChartProps.d.ts +58 -0
  252. package/dist/components/recipes/atlas/dependencyForestLayout.d.ts +17 -0
  253. package/dist/components/recipes/atlas/dependencyQueries.d.ts +20 -0
  254. package/dist/components/recipes/atlas/dependencyTypes.d.ts +21 -0
  255. package/dist/components/recipes/atlas/directedGraph.d.ts +9 -0
  256. package/dist/components/recipes/atlas/entityCounts.d.ts +3 -0
  257. package/dist/components/recipes/atlas/flowCircuit.d.ts +32 -0
  258. package/dist/components/recipes/atlas/flowCircuitChartProps.d.ts +72 -0
  259. package/dist/components/recipes/atlas/flowCircuitChrome.d.ts +18 -0
  260. package/dist/components/recipes/atlas/flowCircuitGeometry.d.ts +11 -0
  261. package/dist/components/recipes/atlas/flowCircuitLayout.d.ts +20 -0
  262. package/dist/components/recipes/atlas/flowCircuitSemantics.d.ts +26 -0
  263. package/dist/components/recipes/atlas/flowCircuitTape.d.ts +22 -0
  264. package/dist/components/recipes/atlas/flowCircuitTypes.d.ts +144 -0
  265. package/dist/components/recipes/atlas/forests.d.ts +11 -0
  266. package/dist/components/recipes/atlas/ids.d.ts +6 -0
  267. package/dist/components/recipes/atlas/index.d.ts +26 -0
  268. package/dist/components/recipes/atlas/ledger.d.ts +7 -0
  269. package/dist/components/recipes/atlas/motifBraidChartProps.d.ts +51 -0
  270. package/dist/components/recipes/atlas/motifBraidGeometry.d.ts +5 -0
  271. package/dist/components/recipes/atlas/motifBraidLayout.d.ts +11 -0
  272. package/dist/components/recipes/atlas/motifs.d.ts +3 -0
  273. package/dist/components/recipes/atlas/prefixForest.d.ts +9 -0
  274. package/dist/components/recipes/atlas/prepare.d.ts +14 -0
  275. package/dist/components/recipes/atlas/prepareAsync.d.ts +7 -0
  276. package/dist/components/recipes/atlas/profile.d.ts +19 -0
  277. package/dist/components/recipes/atlas/publish.d.ts +10 -0
  278. package/dist/components/recipes/atlas/queries.d.ts +34 -0
  279. package/dist/components/recipes/atlas/requiredPaths.d.ts +9 -0
  280. package/dist/components/recipes/atlas/rootedForest.d.ts +4 -0
  281. package/dist/components/recipes/atlas/sections.d.ts +3 -0
  282. package/dist/components/recipes/atlas/support.d.ts +7 -0
  283. package/dist/components/recipes/atlas/types.d.ts +278 -0
  284. package/dist/components/recipes/atlas/validate.d.ts +12 -0
  285. package/dist/components/recipes/firstAvailableTrack.d.ts +17 -0
  286. package/dist/components/recipes/intervals.d.ts +1 -1
  287. package/dist/components/semiotic-ai-core.d.ts +33 -22
  288. package/dist/components/semiotic-ai.d.ts +15 -3
  289. package/dist/components/semiotic-artifact-react.d.ts +10 -0
  290. package/dist/components/semiotic-artifact.d.ts +23 -0
  291. package/dist/components/semiotic-atlas-core.d.ts +20 -0
  292. package/dist/components/semiotic-atlas.d.ts +8 -0
  293. package/dist/components/semiotic-experimental.d.ts +1 -1
  294. package/dist/components/semiotic-physics.d.ts +4 -4
  295. package/dist/components/semiotic-recipes-core.d.ts +9 -0
  296. package/dist/components/semiotic-text.d.ts +2 -0
  297. package/dist/components/semiotic-utils-core.d.ts +18 -18
  298. package/dist/components/semiotic.d.ts +3 -3
  299. package/dist/components/server/renderEvidence.d.ts +12 -0
  300. package/dist/components/server/renderToStaticSVG.d.ts +3 -0
  301. package/dist/components/server/serverChartConfigs.d.ts +3 -0
  302. package/dist/components/server/serverChartConfigsAtlas.d.ts +4 -0
  303. package/dist/components/server/staticSVGChrome.d.ts +1 -4
  304. package/dist/components/server/staticXYAxisTicks.d.ts +2 -38
  305. package/dist/components/server/staticXYGrid.d.ts +1 -1
  306. package/dist/components/server/svgSizing.d.ts +6 -0
  307. package/dist/components/shared/svgRoot.d.ts +17 -0
  308. package/dist/components/store/selectionProvenance.d.ts +6 -0
  309. package/dist/components/stream/GeoSVGOverlay.d.ts +4 -0
  310. package/dist/components/stream/NetworkPipelineStore.d.ts +1 -0
  311. package/dist/components/stream/NetworkSVGOverlay.d.ts +4 -0
  312. package/dist/components/stream/OrdinalSVGOverlay.d.ts +4 -0
  313. package/dist/components/stream/SVGOverlay.d.ts +4 -0
  314. package/dist/components/stream/SceneToSVG.d.ts +4 -19
  315. package/dist/components/stream/SceneToSVGXY.d.ts +13 -0
  316. package/dist/components/stream/StreamGeoFrame.d.ts +1 -2
  317. package/dist/components/stream/StreamOrdinalFrame.d.ts +1 -2
  318. package/dist/components/stream/XYGrid.d.ts +11 -0
  319. package/dist/components/stream/axisTickUtils.d.ts +0 -1
  320. package/dist/components/stream/canvasSetup.d.ts +1 -2
  321. package/dist/components/stream/fontLoading.d.ts +4 -0
  322. package/dist/components/stream/hitTestUtils.d.ts +2 -0
  323. package/dist/components/stream/networkCustomLayout.d.ts +8 -0
  324. package/dist/components/stream/networkCustomLayoutCache.d.ts +12 -0
  325. package/dist/components/stream/networkPipelineConfig.d.ts +0 -7
  326. package/dist/components/stream/overlayAccessibleText.d.ts +18 -0
  327. package/dist/components/stream/physics/PhysicsControllers.d.ts +1 -1
  328. package/dist/components/stream/physics/PhysicsKernel.d.ts +9 -0
  329. package/dist/components/stream/physics/PhysicsPipelineStore.d.ts +5 -4
  330. package/dist/components/stream/physics/PhysicsPipelineTypes.d.ts +9 -0
  331. package/dist/components/stream/physics/StreamPhysicsTypes.d.ts +3 -0
  332. package/dist/components/stream/physics/physicsCanvasCoordinates.d.ts +5 -0
  333. package/dist/components/stream/physics/physicsFixedPosition.d.ts +16 -0
  334. package/dist/components/stream/physics/physicsKernelCloning.d.ts +6 -0
  335. package/dist/components/stream/physics/physicsPipelineObservations.d.ts +2 -0
  336. package/dist/components/stream/physics/physicsPipelineSettle.d.ts +15 -9
  337. package/dist/components/stream/physics/physicsRegionRuntime.d.ts +8 -17
  338. package/dist/components/stream/physics/physicsSemanticUI.d.ts +11 -0
  339. package/dist/components/stream/physics/usePhysicsCanvasPointer.d.ts +3 -1
  340. package/dist/components/stream/physics/usePhysicsSemanticNavigation.d.ts +2 -0
  341. package/dist/components/stream/pipelineConfig.d.ts +4 -0
  342. package/dist/components/stream/pipelineStoreUpdateResults.d.ts +1 -1
  343. package/dist/components/stream/resolveXYAxes.d.ts +13 -0
  344. package/dist/components/stream/sceneToSVGShared.d.ts +2 -1
  345. package/dist/components/stream/seriesGeometry.d.ts +13 -0
  346. package/dist/components/stream/shallowEqual.d.ts +2 -0
  347. package/dist/components/stream/streamEncodingTypes.d.ts +53 -0
  348. package/dist/components/stream/types.d.ts +4 -53
  349. package/dist/components/stream/useEnsureCustomXYRenderers.d.ts +4 -2
  350. package/dist/components/stream/useGeoFrameHandle.d.ts +16 -0
  351. package/dist/components/stream/useOrdinalFrameHandle.d.ts +15 -0
  352. package/dist/components/stream/useXYFrameHandle.d.ts +15 -0
  353. package/dist/components/stream/xyAxisTicks.d.ts +25 -0
  354. package/dist/components/stream/xyDateTicks.d.ts +3 -2
  355. package/dist/components/stream/xyFrameAxisTypes.d.ts +2 -0
  356. package/dist/components/stream/xySceneBuilders/ribbonScene.d.ts +1 -1
  357. package/dist/components/stream/xySceneBuilders/types.d.ts +1 -0
  358. package/dist/components/text/annotationTextLayout.d.ts +28 -0
  359. package/dist/components/text/pretextAnnotationLayout.d.ts +29 -0
  360. package/dist/components/text/usePretextAnnotations.d.ts +12 -0
  361. package/dist/controls.module.min.js +1 -1
  362. package/dist/geo.min.js +1 -1
  363. package/dist/geo.module.min.js +1 -1
  364. package/dist/network.module.min.js +1 -1
  365. package/dist/ordinal.module.min.js +1 -1
  366. package/dist/physics-matter.min.js +1 -1
  367. package/dist/physics-matter.module.min.js +1 -1
  368. package/dist/physics-rapier.min.js +1 -1
  369. package/dist/physics-rapier.module.min.js +1 -1
  370. package/dist/physics.module.min.js +1 -1
  371. package/dist/physicsWorker.js +1 -1
  372. package/dist/processSankeyLayoutWorker.js +1 -1
  373. package/dist/rough.min.js +1 -1
  374. package/dist/rough.module.min.js +1 -1
  375. package/dist/semiotic-access.module.min.js +1 -1
  376. package/dist/semiotic-ai-artifact-policy-constants.module.min.js +2 -0
  377. package/dist/semiotic-ai-core.d.ts +33 -22
  378. package/dist/semiotic-ai-core.min.js +1 -1
  379. package/dist/semiotic-ai-core.module.min.js +1 -1
  380. package/dist/semiotic-ai-hash-primitives.module.min.js +2 -0
  381. package/dist/semiotic-ai.d.ts +15 -3
  382. package/dist/semiotic-ai.module.min.js +1 -1
  383. package/dist/semiotic-artifact-react.d.ts +10 -0
  384. package/dist/semiotic-artifact-react.min.js +2 -0
  385. package/dist/semiotic-artifact-react.module.min.js +2 -0
  386. package/dist/semiotic-artifact.d.ts +23 -0
  387. package/dist/semiotic-artifact.min.js +1 -0
  388. package/dist/semiotic-artifact.module.min.js +1 -0
  389. package/dist/semiotic-atlas-core.d.ts +20 -0
  390. package/dist/semiotic-atlas-core.min.js +1 -0
  391. package/dist/semiotic-atlas-core.module.min.js +1 -0
  392. package/dist/semiotic-atlas-selection.module.min.js +2 -0
  393. package/dist/semiotic-atlas.d.ts +8 -0
  394. package/dist/semiotic-atlas.min.js +2 -0
  395. package/dist/semiotic-atlas.module.min.js +2 -0
  396. package/dist/semiotic-client-cjs-shared.min.js +1 -1
  397. package/dist/semiotic-client-glyph.module.min.js +1 -1
  398. package/dist/semiotic-client-responsive.module.min.js +1 -1
  399. package/dist/semiotic-client-shared.module.min.js +1 -1
  400. package/dist/semiotic-custom-layout-selection-cjs-shared.min.js +1 -1
  401. package/dist/semiotic-data.min.js +1 -1
  402. package/dist/semiotic-data.module.min.js +1 -1
  403. package/dist/semiotic-evidence.min.js +1 -1
  404. package/dist/semiotic-evidence.module.min.js +1 -1
  405. package/dist/semiotic-experimental-auxiliary.module.min.js +1 -1
  406. package/dist/semiotic-experimental-node-auxiliary.module.min.js +1 -1
  407. package/dist/semiotic-experimental-react-shared.module.min.js +1 -1
  408. package/dist/semiotic-experimental-vacp.min.js +1 -1
  409. package/dist/semiotic-experimental-vacp.module.min.js +1 -1
  410. package/dist/semiotic-experimental.d.ts +1 -1
  411. package/dist/semiotic-line.module.min.js +1 -1
  412. package/dist/semiotic-physics.d.ts +4 -4
  413. package/dist/semiotic-realtime-core.module.min.js +1 -1
  414. package/dist/semiotic-realtime-react.module.min.js +1 -1
  415. package/dist/semiotic-recipes-core-cjs-base.min.js +1 -1
  416. package/dist/semiotic-recipes-core.d.ts +9 -0
  417. package/dist/semiotic-recipes-core.module.min.js +1 -1
  418. package/dist/semiotic-recipes-geo-cjs.min.js +1 -1
  419. package/dist/semiotic-recipes-react.min.js +1 -1
  420. package/dist/semiotic-server-edge-node.module.min.js +1 -1
  421. package/dist/semiotic-server-edge.min.js +1 -1
  422. package/dist/semiotic-server-edge.module.min.js +1 -1
  423. package/dist/semiotic-server-node.min.js +1 -1
  424. package/dist/semiotic-server-node.module.min.js +1 -1
  425. package/dist/semiotic-text.d.ts +2 -0
  426. package/dist/semiotic-text.min.js +2 -0
  427. package/dist/semiotic-text.module.min.js +2 -0
  428. package/dist/semiotic-themes-core.min.js +1 -1
  429. package/dist/semiotic-themes-core.module.min.js +1 -1
  430. package/dist/semiotic-themes.min.js +1 -1
  431. package/dist/semiotic-themes.module.min.js +1 -1
  432. package/dist/semiotic-utils-core.d.ts +18 -18
  433. package/dist/semiotic-utils-core.min.js +1 -1
  434. package/dist/semiotic-utils-core.module.min.js +1 -1
  435. package/dist/semiotic-value.module.min.js +1 -1
  436. package/dist/semiotic.d.ts +3 -3
  437. package/dist/semiotic.module.min.js +1 -1
  438. package/dist/server.min.js +1 -1
  439. package/dist/server.module.min.js +1 -1
  440. package/dist/xy.module.min.js +1 -1
  441. package/package.json +70 -14
  442. package/spec/README.md +8 -3
  443. package/spec/v0.1/artifact-contract.schema.json +2299 -0
  444. package/spec/v0.1/examples/artifact-contract-full.json +369 -0
  445. package/spec/v0.1/examples/artifact-contract-unknown-state.json +46 -0
  446. package/dist/c-3BLJEQNG.min.js +0 -1
  447. package/dist/c-3SCUN5HI.min.js +0 -1
  448. package/dist/c-3VVKFA4M.min.js +0 -1
  449. package/dist/c-43TJZS3F.min.js +0 -1
  450. package/dist/c-4DTZPSUD.min.js +0 -1
  451. package/dist/c-4ES5367Y.min.js +0 -1
  452. package/dist/c-52TEGIUJ.min.js +0 -1
  453. package/dist/c-54IRWOGM.min.js +0 -1
  454. package/dist/c-5D2S4RMI.min.js +0 -1
  455. package/dist/c-5JWCTX3G.min.js +0 -1
  456. package/dist/c-6CMMSN6N.min.js +0 -1
  457. package/dist/c-6HRB2L7H.min.js +0 -1
  458. package/dist/c-6O5EVOPH.min.js +0 -1
  459. package/dist/c-7W4SV36A.min.js +0 -1
  460. package/dist/c-A4WRGZFX.min.js +0 -1
  461. package/dist/c-AG7WWVIH.min.js +0 -1
  462. package/dist/c-AH6J4MTN.min.js +0 -1
  463. package/dist/c-AKAF6JAD.min.js +0 -1
  464. package/dist/c-ALYR5LKK.min.js +0 -1
  465. package/dist/c-BBKITSXB.min.js +0 -1
  466. package/dist/c-BYDPC44I.min.js +0 -1
  467. package/dist/c-CFFIU2MW.min.js +0 -1
  468. package/dist/c-CGNHBHCE.min.js +0 -1
  469. package/dist/c-CJYSXIFV.min.js +0 -1
  470. package/dist/c-CZF7MV67.min.js +0 -1
  471. package/dist/c-D53OKBSY.min.js +0 -1
  472. package/dist/c-DADXPJXV.min.js +0 -1
  473. package/dist/c-DBQ2V7CH.min.js +0 -1
  474. package/dist/c-DPMVAUAW.min.js +0 -1
  475. package/dist/c-ECJCKLYY.min.js +0 -1
  476. package/dist/c-EGATGOWJ.min.js +0 -1
  477. package/dist/c-EGR6VYBW.min.js +0 -1
  478. package/dist/c-ESNR43AN.min.js +0 -1
  479. package/dist/c-F3LIKINL.min.js +0 -1
  480. package/dist/c-F5ZB5GJ6.min.js +0 -1
  481. package/dist/c-G36WS6LN.min.js +0 -1
  482. package/dist/c-G3VYMHKE.min.js +0 -1
  483. package/dist/c-GGISSW5E.min.js +0 -1
  484. package/dist/c-GR6MOEQC.min.js +0 -1
  485. package/dist/c-GSVCN34B.min.js +0 -1
  486. package/dist/c-GYOQCEFP.min.js +0 -1
  487. package/dist/c-H3DNMTCC.min.js +0 -1
  488. package/dist/c-I6J3FEZE.min.js +0 -1
  489. package/dist/c-IGH6MGJ5.min.js +0 -1
  490. package/dist/c-II2EEAJN.min.js +0 -1
  491. package/dist/c-IUHFPMHD.min.js +0 -1
  492. package/dist/c-J6M4JHRS.min.js +0 -1
  493. package/dist/c-JM3MGLQV.min.js +0 -1
  494. package/dist/c-KM3N7F7R.min.js +0 -1
  495. package/dist/c-LF5BZFNC.min.js +0 -1
  496. package/dist/c-LKBSGFQC.min.js +0 -1
  497. package/dist/c-MNF2S4AA.min.js +0 -1
  498. package/dist/c-MT3WBK7M.min.js +0 -1
  499. package/dist/c-NDJADPIF.min.js +0 -1
  500. package/dist/c-NVPQCIL5.min.js +0 -1
  501. package/dist/c-NY3JWV2K.min.js +0 -1
  502. package/dist/c-OFWJBEE5.min.js +0 -1
  503. package/dist/c-OYFHP5F5.min.js +0 -1
  504. package/dist/c-PGKQGGQ2.min.js +0 -1
  505. package/dist/c-PPWDL5ZI.min.js +0 -1
  506. package/dist/c-Q2IPZ3MU.min.js +0 -1
  507. package/dist/c-QKHMBE2E.min.js +0 -1
  508. package/dist/c-QMVM3AY6.min.js +0 -1
  509. package/dist/c-QSGWX53A.min.js +0 -1
  510. package/dist/c-RJKEKZOO.min.js +0 -1
  511. package/dist/c-RSVIHIQ4.min.js +0 -1
  512. package/dist/c-S6U5CGT5.min.js +0 -1
  513. package/dist/c-SFDIIU5G.min.js +0 -1
  514. package/dist/c-SLGMUBUL.min.js +0 -1
  515. package/dist/c-SRTBCRVE.min.js +0 -1
  516. package/dist/c-T6UAIKBH.min.js +0 -1
  517. package/dist/c-TMCTEVVW.min.js +0 -1
  518. package/dist/c-TMOSJLT3.min.js +0 -1
  519. package/dist/c-TZW3JGJ5.min.js +0 -1
  520. package/dist/c-U6ESPM7V.min.js +0 -1
  521. package/dist/c-UC5PTTFI.min.js +0 -1
  522. package/dist/c-USFMFKIH.min.js +0 -1
  523. package/dist/c-VGKUEZBC.min.js +0 -1
  524. package/dist/c-VGW3VG3I.min.js +0 -1
  525. package/dist/c-VN2HG5BS.min.js +0 -1
  526. package/dist/c-VPZDY5Q4.min.js +0 -1
  527. package/dist/c-VRXUB2F2.min.js +0 -1
  528. package/dist/c-VUBQNQJH.min.js +0 -1
  529. package/dist/c-VUH4PGZY.min.js +0 -1
  530. package/dist/c-W3CE4A4S.min.js +0 -1
  531. package/dist/c-X5UBGU2V.min.js +0 -1
  532. package/dist/c-XDRV7RKW.min.js +0 -1
  533. package/dist/c-YGZHURXZ.min.js +0 -1
  534. package/dist/c-YZVRZGX2.min.js +0 -1
  535. /package/dist/{c-N4G2L7ID.min.js → c-HYW2XA4Q.min.js} +0 -0
  536. /package/dist/{c-ENF72HU5.min.js → c-QAVFOEUY.min.js} +0 -0
  537. /package/dist/{c-OCI56QF2.min.js → c-V4XMSLC3.min.js} +0 -0
@@ -0,0 +1,341 @@
1
+ import type { Datum } from "../charts/shared/datumTypes";
2
+ /** Current wire version for the portable interpretation sidecar. */
3
+ export declare const ARTIFACT_CONTRACT_VERSION: "0.1";
4
+ export type ArtifactContractVersion = typeof ARTIFACT_CONTRACT_VERSION;
5
+ export type JsonPrimitive = string | number | boolean | null;
6
+ export type JsonValue = JsonPrimitive | JsonObject | JsonValue[];
7
+ export interface JsonObject {
8
+ [key: string]: JsonValue;
9
+ }
10
+ export type ArtifactKind = "chart" | "dashboard" | "story" | "alert" | "agent-answer";
11
+ export type ArtifactStakes = "exploratory" | "informational" | "operational" | "high";
12
+ export type FieldKnowledgeStatus = "known" | "unknown" | "manual" | "not-applicable";
13
+ export type ObligationStatus = "pass" | "fail" | "warn" | "manual" | "unknown" | "not-applicable";
14
+ export type ArtifactRelation = "claim-support" | "representation-fit" | "reception" | "time" | "challenge-and-correction" | "accountability" | "abstention" | "preservation";
15
+ export interface ArtifactFieldState {
16
+ status: FieldKnowledgeStatus;
17
+ reason?: string;
18
+ suppliedBy?: "author" | "system" | "model-proposal" | "import";
19
+ derived?: boolean;
20
+ reviewedBy?: string;
21
+ }
22
+ export interface ArtifactIdentity {
23
+ id: string;
24
+ kind: ArtifactKind;
25
+ component?: string;
26
+ title?: string;
27
+ createdAt?: string;
28
+ configFingerprint?: string;
29
+ dataFingerprint?: string;
30
+ revision?: string;
31
+ }
32
+ export interface PurposeIntent {
33
+ id: string;
34
+ strength?: "primary" | "secondary";
35
+ source?: "author" | "derived" | "model-proposal" | "import";
36
+ rationale?: string;
37
+ }
38
+ export interface PurposeContract {
39
+ intents: PurposeIntent[];
40
+ communicativeAct?: string;
41
+ decisionContext?: string;
42
+ stakes?: ArtifactStakes;
43
+ allowedUses?: string[];
44
+ prohibitedUses?: string[];
45
+ }
46
+ export type ClaimKind = "description" | "observation" | "aggregation" | "inference" | "forecast" | "simulation" | "alert" | "recommendation" | "normative";
47
+ export type ClaimStatus = "supported" | "provisional" | "disputed" | "superseded" | "retracted" | "unsupported" | "unknown";
48
+ export interface ActorRef {
49
+ id?: string;
50
+ name?: string;
51
+ kind: "human" | "agent" | "watcher" | "system" | (string & {});
52
+ }
53
+ export interface ClaimReview {
54
+ status: "proposed" | "reviewed" | "approved" | "rejected";
55
+ reviewer?: ActorRef;
56
+ reviewedAt?: string;
57
+ rationale?: string;
58
+ }
59
+ export interface ClaimUncertainty {
60
+ kind: "interval" | "distribution" | "qualitative" | "unknown";
61
+ lower?: number;
62
+ upper?: number;
63
+ confidence?: number;
64
+ unit?: string;
65
+ description?: string;
66
+ }
67
+ export interface Claim {
68
+ id: string;
69
+ text?: string;
70
+ kind: ClaimKind;
71
+ status: ClaimStatus;
72
+ evidenceIds: string[];
73
+ scope?: JsonObject;
74
+ uncertainty?: ClaimUncertainty;
75
+ asOf?: string;
76
+ supersedes?: string[];
77
+ authoredBy?: ActorRef;
78
+ review?: ClaimReview;
79
+ tags?: string[];
80
+ }
81
+ export type EvidenceRole = "source-data" | "external-source" | "transformation" | "statistical-test" | "model-output" | "human-observation" | "policy-rule" | "quality-check";
82
+ export interface EvidenceSource {
83
+ name?: string;
84
+ uri?: string;
85
+ version?: string;
86
+ retrievedAt?: string;
87
+ publisher?: string;
88
+ }
89
+ export type TransformationKind = "aggregation" | "filter" | "normalization" | "binning" | "join" | "smoothing" | "forecasting" | "simulation" | "other";
90
+ export interface TransformationRecord {
91
+ id: string;
92
+ kind: TransformationKind;
93
+ description?: string;
94
+ inputEvidenceIds: string[];
95
+ parameters?: JsonObject;
96
+ assumptions?: string[];
97
+ implementation?: string;
98
+ performedAt?: string;
99
+ performedBy?: ActorRef;
100
+ }
101
+ export interface BoundedEvidenceSample {
102
+ rowCount?: number;
103
+ fields?: string[];
104
+ values?: JsonValue[];
105
+ truncated?: boolean;
106
+ }
107
+ export interface EvidenceRef {
108
+ id: string;
109
+ role: EvidenceRole;
110
+ label?: string;
111
+ source?: EvidenceSource;
112
+ fingerprint?: string;
113
+ dataVersion?: string;
114
+ observedAt?: string;
115
+ scope?: JsonObject;
116
+ sample?: BoundedEvidenceSample;
117
+ transformation?: TransformationRecord;
118
+ generatedClaimId?: string;
119
+ relationship?: "descriptive" | "correlational" | "causal" | "unknown";
120
+ }
121
+ export interface TimeField {
122
+ field?: string;
123
+ value?: string;
124
+ timezone?: string;
125
+ granularity?: string;
126
+ }
127
+ export type WindowStatus = "open" | "provisional" | "settled" | "reopened" | "corrected";
128
+ export interface TemporalSourceState {
129
+ id: string;
130
+ kind: "stream" | "processing-job" | "quality-check" | "snapshot" | "publication";
131
+ label?: string;
132
+ observedAt?: string;
133
+ version?: string;
134
+ timezone?: string;
135
+ granularity?: string;
136
+ freshness?: "fresh" | "stale" | "unknown";
137
+ completeness?: "partial" | "provisional" | "settled" | "unknown";
138
+ }
139
+ export interface TemporalContext {
140
+ eventTime?: TimeField;
141
+ observedAt?: string;
142
+ ingestedAt?: string;
143
+ processedAt?: string;
144
+ publishedAt?: string;
145
+ snapshotAt?: string;
146
+ presentation?: {
147
+ state?: "live" | "historical" | "mixed";
148
+ label?: string;
149
+ };
150
+ freshness?: {
151
+ status: "fresh" | "stale" | "unknown";
152
+ checkedAt?: string;
153
+ heartbeatAt?: string;
154
+ expiresAt?: string;
155
+ basis?: string;
156
+ };
157
+ watermark?: {
158
+ value: string;
159
+ policy?: string;
160
+ allowedLateness?: string;
161
+ };
162
+ window?: {
163
+ start: string;
164
+ end: string;
165
+ status: WindowStatus;
166
+ };
167
+ completeness?: {
168
+ status: "partial" | "provisional" | "settled" | "unknown";
169
+ basis?: string;
170
+ };
171
+ revision?: {
172
+ status: "original" | "backfilled" | "corrected" | "superseded";
173
+ previousArtifactId?: string;
174
+ correctionId?: string;
175
+ reason?: string;
176
+ };
177
+ snapshot?: {
178
+ id?: string;
179
+ format?: "iceberg" | "delta" | "other";
180
+ schemaVersion?: string;
181
+ catalogRef?: string;
182
+ };
183
+ sources?: TemporalSourceState[];
184
+ }
185
+ export type ReceptionChannel = "visual" | "screen-reader" | "sonified" | "agent" | "print" | "low-bandwidth";
186
+ export interface ReceptionChannelContract {
187
+ channel: ReceptionChannel;
188
+ disclosure?: "summary" | "standard" | "detailed";
189
+ navigation?: boolean;
190
+ interactionInstructions?: boolean;
191
+ rawData?: "deny" | "bounded" | "allow";
192
+ tokenBudget?: number;
193
+ privacyNotes?: string[];
194
+ }
195
+ export interface ReceptionContract {
196
+ channels: ReceptionChannelContract[];
197
+ audience?: string;
198
+ strengths?: string[];
199
+ risks?: string[];
200
+ scaffolds?: string[];
201
+ description?: string;
202
+ dataFallback?: boolean;
203
+ manualChecks?: string[];
204
+ }
205
+ export interface DesignContract {
206
+ chartFamily?: string;
207
+ whyThisForm?: string;
208
+ rejectedAlternatives?: Array<{
209
+ representation: string;
210
+ reason: string;
211
+ }>;
212
+ risks?: string[];
213
+ misuse?: string[];
214
+ }
215
+ export interface ClaimChallenge {
216
+ id: string;
217
+ claimId: string;
218
+ status: "open" | "accepted" | "declined" | "resolved";
219
+ reason: string;
220
+ raisedBy?: ActorRef;
221
+ raisedAt?: string;
222
+ counterclaimId?: string;
223
+ resolution?: string;
224
+ }
225
+ export interface CorrectionRecord {
226
+ id: string;
227
+ affectedClaimIds: string[];
228
+ replacementClaimIds?: string[];
229
+ reason: string;
230
+ createdAt?: string;
231
+ createdBy?: ActorRef;
232
+ }
233
+ export interface ContestabilityContract {
234
+ sourceRequestsAllowed?: boolean;
235
+ alternativeViews?: Array<{
236
+ id: string;
237
+ label: string;
238
+ rationale?: string;
239
+ }>;
240
+ challenges?: ClaimChallenge[];
241
+ corrections?: CorrectionRecord[];
242
+ editorialExceptions?: Array<{
243
+ ruleId: string;
244
+ rationale: string;
245
+ owner?: string;
246
+ reviewAt?: string;
247
+ }>;
248
+ }
249
+ export interface ReviewRecord {
250
+ id: string;
251
+ status: "pending" | "approved" | "changes-requested" | "rejected";
252
+ reviewer?: ActorRef;
253
+ reviewedAt?: string;
254
+ rationale?: string;
255
+ policyId?: string;
256
+ }
257
+ export interface ActionRecord {
258
+ id: string;
259
+ action: string;
260
+ actor?: ActorRef;
261
+ actedAt?: string;
262
+ claimIds: string[];
263
+ artifactId?: string;
264
+ artifactRevision?: string;
265
+ policyId?: string;
266
+ status?: "proposed" | "taken" | "reversed" | "invalidated";
267
+ invalidatedByClaimId?: string;
268
+ }
269
+ export interface AccountabilityContract {
270
+ authors?: ActorRef[];
271
+ generatedBy?: string;
272
+ dataSources?: string[];
273
+ codeRef?: string;
274
+ reviews?: ReviewRecord[];
275
+ actions?: ActionRecord[];
276
+ }
277
+ export type PreservationClass = "full-fidelity" | "claim-evidence-preserved" | "visual-only" | "lossy" | "unknown";
278
+ export interface InheritanceContract {
279
+ requiredPaths?: string[];
280
+ prohibitedExports?: string[];
281
+ privacy?: "public" | "restricted" | "confidential" | "unknown";
282
+ rawDataDefault?: "exclude" | "bounded" | "include";
283
+ preservation?: PreservationClass;
284
+ sourceArtifactIds?: string[];
285
+ }
286
+ export interface ArtifactContract {
287
+ contractVersion: ArtifactContractVersion;
288
+ artifact: ArtifactIdentity;
289
+ purpose: PurposeContract;
290
+ claims: Claim[];
291
+ evidence: EvidenceRef[];
292
+ time?: TemporalContext;
293
+ reception?: ReceptionContract;
294
+ form?: DesignContract;
295
+ contestability?: ContestabilityContract;
296
+ accountability?: AccountabilityContract;
297
+ inheritance?: InheritanceContract;
298
+ fieldStatus?: Record<string, ArtifactFieldState>;
299
+ extensions?: JsonObject;
300
+ }
301
+ export interface ObligationResult {
302
+ id: string;
303
+ relation: ArtifactRelation;
304
+ status: ObligationStatus;
305
+ message: string;
306
+ path?: string;
307
+ repair?: string;
308
+ evidenceIds?: string[];
309
+ }
310
+ export interface ObligationSummary {
311
+ pass: number;
312
+ fail: number;
313
+ warn: number;
314
+ manual: number;
315
+ unknown: number;
316
+ notApplicable: number;
317
+ }
318
+ export interface ArtifactContractInput {
319
+ id?: string;
320
+ kind?: ArtifactKind;
321
+ title?: string;
322
+ createdAt?: string;
323
+ revision?: string;
324
+ purpose?: Partial<PurposeContract>;
325
+ intents?: string | string[] | PurposeIntent[];
326
+ claims?: Claim[];
327
+ evidence?: EvidenceRef[];
328
+ time?: TemporalContext;
329
+ reception?: ReceptionContract;
330
+ form?: DesignContract;
331
+ contestability?: ContestabilityContract;
332
+ accountability?: AccountabilityContract;
333
+ inheritance?: InheritanceContract;
334
+ fieldStatus?: Record<string, ArtifactFieldState>;
335
+ extensions?: JsonObject;
336
+ }
337
+ export interface ArtifactBuildInput {
338
+ component: string;
339
+ props?: Datum;
340
+ contract?: ArtifactContractInput;
341
+ }
@@ -0,0 +1,13 @@
1
+ export interface ArtifactContractValidation {
2
+ valid: boolean;
3
+ errors: Array<{
4
+ path: string;
5
+ message: string;
6
+ }>;
7
+ warnings: Array<{
8
+ path: string;
9
+ message: string;
10
+ }>;
11
+ }
12
+ /** Dependency-free structural validation for untrusted contract payloads. */
13
+ export declare function validateArtifactContract(value: unknown): ArtifactContractValidation;
@@ -0,0 +1,7 @@
1
+ type ValidationError = {
2
+ path: string;
3
+ message: string;
4
+ };
5
+ /** Validate declared knowledge state against the field supplier registry. */
6
+ export declare function validateArtifactFieldStatus(value: unknown, errors: ValidationError[]): void;
7
+ export {};
@@ -0,0 +1,24 @@
1
+ export type ValidationIssue = {
2
+ path: string;
3
+ message: string;
4
+ };
5
+ export interface StringFieldRule {
6
+ required?: boolean;
7
+ values?: ReadonlyArray<string>;
8
+ }
9
+ /** Validate a closed string-valued record from one ordered field definition. */
10
+ export declare function validateStringFields(record: Record<string, unknown>, fields: Record<string, StringFieldRule>, path: string, errors: ValidationIssue[]): void;
11
+ export declare function isRecord(value: unknown): value is Record<string, unknown>;
12
+ export declare function numberIfPresent(record: Record<string, unknown>, key: string, path: string, errors: ValidationIssue[]): void;
13
+ export declare function booleanIfPresent(record: Record<string, unknown>, key: string, path: string, errors: ValidationIssue[]): void;
14
+ export declare function jsonObjectIfPresent(record: Record<string, unknown>, key: string, path: string, errors: ValidationIssue[]): void;
15
+ export declare function jsonValuesAreValid(values: ReadonlyArray<unknown>): boolean;
16
+ export declare function rejectUnknownKeys(record: Record<string, unknown>, allowed: ReadonlyArray<string>, path: string, errors: ValidationIssue[]): void;
17
+ export declare function requiredString(record: Record<string, unknown>, key: string, path: string, errors: ValidationIssue[]): void;
18
+ export declare function enumString(record: Record<string, unknown>, key: string, path: string, allowed: ReadonlyArray<string>, errors: ValidationIssue[]): void;
19
+ export declare function optionalRecord(record: Record<string, unknown>, key: string, path: string, errors: ValidationIssue[]): Record<string, unknown> | undefined;
20
+ export declare function optionalArray(record: Record<string, unknown>, key: string, path: string, errors: ValidationIssue[]): unknown[] | undefined;
21
+ export declare function validateStringArray(value: unknown[] | undefined, path: string, errors: ValidationIssue[]): void;
22
+ export declare function enumStringIfPresent(record: Record<string, unknown>, key: string, path: string, allowed: ReadonlyArray<string>, errors: ValidationIssue[]): void;
23
+ export declare function stringIfPresent(record: Record<string, unknown>, key: string, path: string, errors: ValidationIssue[]): void;
24
+ export declare function validateActor(value: unknown, path: string, errors: ValidationIssue[]): void;
@@ -0,0 +1,7 @@
1
+ type ValidationIssue = {
2
+ path: string;
3
+ message: string;
4
+ };
5
+ /** Validate optional public contract surfaces that are independent of claims. */
6
+ export declare function validateArtifactSurfaces(value: Record<string, unknown>, errors: ValidationIssue[]): void;
7
+ export {};
@@ -0,0 +1,3 @@
1
+ import { type ValidationIssue } from "./validationPrimitives";
2
+ /** Validate nested clock and source shapes used by the deterministic audit. */
3
+ export declare function validateTemporalStructure(value: Record<string, unknown>, errors: ValidationIssue[]): void;
@@ -8,6 +8,7 @@ import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
8
8
  import type { Style } from "../../stream/types";
9
9
  import type { GeoParticleStyle } from "../../stream/GeoParticlePool";
10
10
  import { type AreasProp } from "../../geo/useReferenceAreas";
11
+ import { type StyleRule } from "../shared/styleRules";
11
12
  export interface FlowMapProps<TDatum extends Datum = Datum> extends BaseChartProps {
12
13
  /** Flow edges with source/target/value */
13
14
  flows?: Array<Datum & {
@@ -49,6 +50,12 @@ export interface FlowMapProps<TDatum extends Datum = Datum> extends BaseChartPro
49
50
  edgeLinecap?: "butt" | "round" | "square";
50
51
  /** Color scheme for edges @default "category10" */
51
52
  colorScheme?: string | string[] | Record<string, string>;
53
+ /**
54
+ * Declarative, threshold-aware flow-edge styling. `ctx.value` is the
55
+ * `valueAccessor` magnitude so `{ gte: 1000 }` restyles heavy flows.
56
+ * Last applicable rule wins per property. Layers over `edgeColorBy`.
57
+ */
58
+ styleRules?: StyleRule[];
52
59
  /** Show animated particles along flow lines */
53
60
  showParticles?: boolean;
54
61
  /** Particle appearance and behavior */
@@ -0,0 +1,18 @@
1
+ import type { Datum } from "../shared/datumTypes";
2
+ import type { Style } from "../../stream/types";
3
+ import { type StyleRule } from "../shared/styleRules";
4
+ /** Map a flow value onto `edgeWidthRange`, collapsing non-finite inputs to min. */
5
+ export declare function flowMapEdgeWidth(value: unknown, domain: [number, number] | undefined, range: [number, number]): number;
6
+ /**
7
+ * Shared FlowMap edge style for the client HOC and `renderChart`. `fillOpacity: 0`
8
+ * is load-bearing: the line renderer treats fillOpacity &gt; 0 as area fill.
9
+ */
10
+ export declare function buildFlowMapLineStyle(options: {
11
+ valueAccessor: string;
12
+ valueDomain: [number, number] | undefined;
13
+ edgeWidthRange: [number, number];
14
+ resolveStroke: (d: Datum) => string;
15
+ edgeOpacity: number;
16
+ edgeLinecap: "butt" | "round" | "square";
17
+ styleRules?: ReadonlyArray<StyleRule>;
18
+ }): (d: Datum) => Style;
@@ -16,6 +16,8 @@ export interface DonutChartProps<TDatum extends Datum = Datum> extends BaseChart
16
16
  colorScheme?: string | string[] | Record<string, string>;
17
17
  /** Ordered data-aware wedge styling; fieldless thresholds use absolute wedge magnitude. */
18
18
  styleRules?: StyleRule[];
19
+ /** Formatter for the default tooltip value. */
20
+ valueFormat?: (d: number | string) => string;
19
21
  startAngle?: number;
20
22
  /** Rounded corner radius on wedge arcs */
21
23
  cornerRadius?: number;
@@ -45,6 +45,8 @@ export interface FunnelChartProps<TDatum extends Datum = Datum> extends BaseChar
45
45
  annotations?: Datum[];
46
46
  /** Custom formatter for category tick labels */
47
47
  categoryFormat?: CategoryFormatFn;
48
+ /** Formatter for the default tooltip and vertical-funnel value axis. */
49
+ valueFormat?: (d: number | string) => string;
48
50
  frameProps?: Partial<Omit<StreamOrdinalFrameProps, "data" | "size">>;
49
51
  }
50
52
  /**
@@ -45,6 +45,12 @@ export interface GroupedBarChartProps<TDatum extends Datum = Datum> extends Base
45
45
  legendPosition?: "right" | "left" | "top" | "bottom";
46
46
  tooltip?: TooltipProp;
47
47
  annotations?: Datum[];
48
+ /** Enable a value-axis brush overlay. Also enabled when `linkedBrush` is set. */
49
+ brush?: boolean;
50
+ /** Callback with `{ r: [min, max] }` or null when the brush clears. */
51
+ onBrush?: (extent: {
52
+ r: [number, number];
53
+ } | null) => void;
48
54
  /** Custom formatter for category tick labels */
49
55
  categoryFormat?: CategoryFormatFn;
50
56
  /** Fixed value-axis domain `[min, max]`. Either bound may be `undefined` to leave that side data-derived. */
@@ -45,6 +45,8 @@ export interface PieChartProps<TDatum extends Datum = Datum> extends BaseChartPr
45
45
  colorScheme?: string | string[] | Record<string, string>;
46
46
  /** Ordered data-aware wedge styling; fieldless thresholds use absolute wedge magnitude. */
47
47
  styleRules?: StyleRule[];
48
+ /** Formatter for the default tooltip value. */
49
+ valueFormat?: (d: number | string) => string;
48
50
  /**
49
51
  * Rotation in **degrees** applied to the first wedge. `0` starts at 12
50
52
  * o'clock and proceeds clockwise; `90` starts at 3 o'clock, `180` at 6
@@ -24,6 +24,8 @@ export interface RadarChartProps<TDatum extends Datum = Datum> extends BaseChart
24
24
  pointRadius?: number;
25
25
  /** Fixed value-axis domain. Defaults to `[0, data-max]`. */
26
26
  valueExtent?: [number | undefined, number | undefined] | [number];
27
+ /** Formatter for axis ticks and the default tooltip. */
28
+ valueFormat?: (d: number | string) => string;
27
29
  enableHover?: boolean;
28
30
  showGrid?: boolean;
29
31
  showLegend?: boolean;
@@ -46,6 +46,12 @@ export interface StackedBarChartProps<TDatum extends Datum = Datum> extends Base
46
46
  legendPosition?: "right" | "left" | "top" | "bottom";
47
47
  tooltip?: TooltipProp;
48
48
  annotations?: Datum[];
49
+ /** Enable a value-axis brush overlay. Also enabled when `linkedBrush` is set. */
50
+ brush?: boolean;
51
+ /** Callback with `{ r: [min, max] }` or null when the brush clears. */
52
+ onBrush?: (extent: {
53
+ r: [number, number];
54
+ } | null) => void;
49
55
  /** Custom formatter for category tick labels */
50
56
  categoryFormat?: CategoryFormatFn;
51
57
  /** Fixed value-axis domain `[min, max]`. Either bound may be `undefined` to leave that side data-derived. Stacked bars auto-extend the value domain to cover the cumulative stack unless `valueExtent` is fully specified. */
@@ -2,7 +2,7 @@ import * as React from "react";
2
2
  import type { Datum } from "../shared/datumTypes";
3
3
  import type { BaseChartProps, ChartAccessor } from "../shared/types";
4
4
  import type { StyleRule } from "../shared/styleRules";
5
- import { type PhysicsFrameHandle } from "./physicsHocHandle";
5
+ import type { PhysicsFrameHandle } from "./physicsHocHandle";
6
6
  import { type PhysicsHocFrameProps, type PhysicsRerunMS, type PhysicsSharedChartProps, type TooltipProp } from "./physicsHocUtils";
7
7
  export interface CollisionSwarmChartProps<TDatum extends Datum = Datum> extends Omit<BaseChartProps, "margin" | "selection">, PhysicsSharedChartProps {
8
8
  data?: TDatum[];
@@ -3,7 +3,7 @@ import type { Datum } from "../shared/datumTypes";
3
3
  import type { BaseChartProps, ChartAccessor } from "../shared/types";
4
4
  import { type EventDropWindowOptions } from "./physicsChartUtils";
5
5
  import type { StyleRule } from "../shared/styleRules";
6
- import { type PhysicsFrameHandle } from "./physicsHocHandle";
6
+ import type { PhysicsFrameHandle } from "./physicsHocHandle";
7
7
  import { type PhysicsHocFrameProps, type PhysicsRerunMS, type PhysicsSharedChartProps, type TooltipProp } from "./physicsHocUtils";
8
8
  export interface EventDropChartProps<TDatum extends Datum = Datum> extends Omit<BaseChartProps, "margin" | "selection">, PhysicsSharedChartProps {
9
9
  data?: TDatum[];
@@ -15,6 +15,8 @@ export interface EventDropChartProps<TDatum extends Datum = Datum> extends Omit<
15
15
  delay?: number;
16
16
  value?: number;
17
17
  } | ((latestEventTime: number) => number);
18
+ /** Recorded watermark for each arrival; later closure changes preserve this decision. */
19
+ watermarkAtArrivalAccessor?: ChartAccessor<TDatum, number>;
18
20
  ballRadius?: number;
19
21
  colorBy?: ChartAccessor<TDatum, string>;
20
22
  /**
@@ -2,7 +2,7 @@ import * as React from "react";
2
2
  import type { Datum } from "../shared/datumTypes";
3
3
  import type { BaseChartProps, ChartAccessor } from "../shared/types";
4
4
  import type { StyleRule } from "../shared/styleRules";
5
- import { type PhysicsFrameHandle } from "./physicsHocHandle";
5
+ import type { PhysicsFrameHandle } from "./physicsHocHandle";
6
6
  import { type PhysicsHocFrameProps, type PhysicsRerunMS, type PhysicsSharedChartProps, type PhysicsSimulationMode, type TooltipProp } from "./physicsHocUtils";
7
7
  import type { ChartMode } from "../shared/types";
8
8
  import { type GaltonBoardReferenceLine } from "./physicsProjectionOverlays";
@@ -46,7 +46,9 @@ export interface GaltonBoardChartProps<TDatum extends Datum = Datum> extends Omi
46
46
  frameProps?: PhysicsHocFrameProps<"config">;
47
47
  }
48
48
  /**
49
- * Physics-backed Galton board chart that drops values through seeded pegs into a settled distribution.
49
+ * Physics-backed distribution drop: values enter preassigned bins and settle into piles.
50
+ * Mechanical mode generates seeded Bernoulli samples before the physical replay;
51
+ * the apparatus does not simulate peg collisions.
50
52
  *
51
53
  * @example
52
54
  * ```tsx
@@ -4,6 +4,7 @@ import { type CapacityQueueSnapshot } from "../../stream/physics/PhysicsControll
4
4
  import type { ProcessChromeOptions } from "../../recipes/processChrome";
5
5
  import type { Datum } from "../shared/datumTypes";
6
6
  import type { BaseChartProps, ChartAccessor } from "../shared/types";
7
+ import type { StyleRule } from "../shared/styleRules";
7
8
  import { type ProcessFlowProjectionMetadata, type ProcessFlowStageDef } from "./physicsChartUtils";
8
9
  import { type PhysicsFrameHandle } from "./physicsHocHandle";
9
10
  import { type PhysicsHocFrameProps, type PhysicsRerunMS, type PhysicsSharedChartProps, type TooltipProp } from "./physicsHocUtils";
@@ -20,6 +21,11 @@ export interface ProcessFlowChartProps<TDatum extends Datum = Datum> extends Omi
20
21
  radiusAccessor?: ChartAccessor<TDatum, number>;
21
22
  ballRadius?: number;
22
23
  colorBy?: ChartAccessor<TDatum, string>;
24
+ /**
25
+ * Declarative, threshold-aware body styling. `ctx.value` is `workAccessor`
26
+ * when set. Last applicable rule wins per property.
27
+ */
28
+ styleRules?: StyleRule[];
23
29
  seed?: number;
24
30
  route?: "horizontal";
25
31
  groupCompletion?: "allAbsorbed" | "none";
@@ -2,7 +2,7 @@ import * as React from "react";
2
2
  import type { Datum } from "../shared/datumTypes";
3
3
  import type { BaseChartProps, ChartAccessor, ChartMode } from "../shared/types";
4
4
  import type { StyleRule } from "../shared/styleRules";
5
- import { type PhysicsFrameHandle } from "./physicsHocHandle";
5
+ import type { PhysicsFrameHandle } from "./physicsHocHandle";
6
6
  import { type PhysicsHocFrameProps, type PhysicsRerunMS, type PhysicsSharedChartProps, type PhysicsSimulationMode, type TooltipProp } from "./physicsHocUtils";
7
7
  export interface UnitPileChartProps<TDatum extends Datum = Datum> extends Omit<BaseChartProps, "margin" | "mode" | "selection">, PhysicsSharedChartProps {
8
8
  data?: TDatum[];
@@ -17,6 +17,7 @@ export interface UnitPileChartProps<TDatum extends Datum = Datum> extends Omit<B
17
17
  simulationMode?: PhysicsSimulationMode;
18
18
  mechanicalCount?: number;
19
19
  mechanicalCategories?: readonly string[];
20
+ /** Quantity per full circle; a record's remainder uses proportional area. */
20
21
  unitValue?: number;
21
22
  ballRadius?: number;
22
23
  colorBy?: ChartAccessor<TDatum, string>;
@@ -0,0 +1,14 @@
1
+ interface SwarmPoint {
2
+ x: number;
3
+ radius: number;
4
+ }
5
+ /**
6
+ * Find readable vertical targets without changing quantitative x or radius.
7
+ * If this greedy packing cannot fit, disclose overlap and retain every mark.
8
+ */
9
+ export declare function packSwarmLane(points: readonly SwarmPoint[], top: number, bottom: number, random: () => number): {
10
+ positions: number[];
11
+ overlapping: boolean;
12
+ entryOffset: number;
13
+ };
14
+ export {};
@@ -21,6 +21,7 @@ export interface CollisionSwarmProjectionMetadata {
21
21
  label: string;
22
22
  y: number;
23
23
  count: number;
24
+ overlapping?: boolean;
24
25
  }>;
25
26
  plot: PhysicsChartArea["plot"];
26
27
  }
@@ -0,0 +1,32 @@
1
+ import type { Datum } from "../shared/datumTypes";
2
+ import type { ChartAccessor } from "../shared/types";
3
+ export interface EventDropAdmissionOptions<TDatum extends Datum = Datum> {
4
+ data: readonly TDatum[];
5
+ timeAccessor: ChartAccessor<TDatum, number>;
6
+ arrivalAccessor: ChartAccessor<TDatum, number>;
7
+ windowSize: number;
8
+ watermark?: {
9
+ delay?: number;
10
+ value?: number;
11
+ } | ((latestEventTime: number) => number);
12
+ /** Recorded admission thresholds; independent of the current closure watermark. */
13
+ watermarkAtArrivalAccessor?: ChartAccessor<TDatum, number>;
14
+ }
15
+ /**
16
+ * Replay admissions in arrival order. Equal arrival times retain source order.
17
+ * A delay/function watermark advances monotonically with the greatest event
18
+ * time seen so far. An explicit value describes one fixed admission policy.
19
+ * Recorded per-event thresholds take precedence over either policy, so later
20
+ * watermark advances cannot relabel previously accepted events.
21
+ */
22
+ export declare function resolveEventDropAdmissions<TDatum extends Datum>(options: EventDropAdmissionOptions<TDatum>): {
23
+ events: {
24
+ datum: TDatum;
25
+ index: number;
26
+ eventTime: number;
27
+ arrivalTime: number;
28
+ watermarkAtArrival: number;
29
+ late: boolean;
30
+ }[];
31
+ watermarkValue: number;
32
+ };