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
@@ -1 +1 @@
1
- import{generateFrameSVGs as m,generateFrameSequence as i,generatePhysicsFrameSVGs as o,renderChart as r,renderChartWithEvidence as p,renderDashboard as t,renderGeoToStaticSVG as c,renderNetworkToStaticSVG as j,renderOrdinalToStaticSVG as n,renderPhysicsToAnimatedGif as s,renderToAnimatedGif as C,renderToImage as I,renderToStaticSVG as P,renderXYToStaticSVG as e,resolveTheme as f,serializeSvgPrecision as x,themeStyles as B}from"./c-BYDPC44I.min.js";import"./c-NVPQCIL5.min.js";export{m as generateFrameSVGs,i as generateFrameSequence,o as generatePhysicsFrameSVGs,r as renderChart,p as renderChartWithEvidence,t as renderDashboard,c as renderGeoToStaticSVG,j as renderNetworkToStaticSVG,n as renderOrdinalToStaticSVG,s as renderPhysicsToAnimatedGif,C as renderToAnimatedGif,I as renderToImage,P as renderToStaticSVG,e as renderXYToStaticSVG,f as resolveTheme,x as serializeSvgPrecision,B as themeStyles};
1
+ import{generateFrameSVGs as m,generateFrameSequence as i,generatePhysicsFrameSVGs as o,renderChart as r,renderChartWithEvidence as p,renderDashboard as t,renderGeoToStaticSVG as c,renderNetworkToStaticSVG as j,renderOrdinalToStaticSVG as n,renderPhysicsToAnimatedGif as s,renderToAnimatedGif as G,renderToImage as e,renderToStaticSVG as f,renderXYToStaticSVG as x,resolveTheme as D,serializeSvgPrecision as H,themeStyles as J}from"./c-PYNW54D2.min.js";import"./c-JLGRHXGZ.min.js";export{m as generateFrameSVGs,i as generateFrameSequence,o as generatePhysicsFrameSVGs,r as renderChart,p as renderChartWithEvidence,t as renderDashboard,c as renderGeoToStaticSVG,j as renderNetworkToStaticSVG,n as renderOrdinalToStaticSVG,s as renderPhysicsToAnimatedGif,G as renderToAnimatedGif,e as renderToImage,f as renderToStaticSVG,x as renderXYToStaticSVG,D as resolveTheme,H as serializeSvgPrecision,J as themeStyles};
@@ -1,2 +1,2 @@
1
1
  "use client";
2
- import{DEFAULT_HIT_RADIUS as m,hitTargetPoint as i,hitTargetRect as r}from"./c-3BLJEQNG.min.js";import{registerBuiltInXYPlugins as o}from"./c-VUH4PGZY.min.js";import{AreaChart as t,BubbleChart as p,BumpChart as s,CandlestickChart as c,ConnectedScatterplot as j,DifferenceChart as n,Heatmap as G,MinimapChart as E,MultiAxisLineChart as S,QuadrantChart as B,Scatterplot as H,ScatterplotMatrix as M,StackedAreaChart as V,WaterfallChart as I,XYCustomChart as R,rankBumpData as J}from"./c-ESNR43AN.min.js";import"./c-IGH6MGJ5.min.js";import{LineChart as Q}from"./c-YGZHURXZ.min.js";import"./c-SLGMUBUL.min.js";import"./c-U6ESPM7V.min.js";import"./c-RSVIHIQ4.min.js";import"./c-F5ZB5GJ6.min.js";import"./c-A4WRGZFX.min.js";import"./c-VUBQNQJH.min.js";import"./c-I6J3FEZE.min.js";import{StreamXYFrame_default as U}from"./c-J6M4JHRS.min.js";import"./c-W3CE4A4S.min.js";import"./c-5D2S4RMI.min.js";import"./c-ENF72HU5.min.js";import"./c-TMOSJLT3.min.js";import"./c-AH6J4MTN.min.js";import"./c-CZF7MV67.min.js";import"./c-G3VYMHKE.min.js";import"./c-SRTBCRVE.min.js";import"./c-RJKEKZOO.min.js";import"./c-F3LIKINL.min.js";import"./c-VGKUEZBC.min.js";import"./c-T6UAIKBH.min.js";import"./c-OCI56QF2.min.js";import"./c-5JWCTX3G.min.js";import"./c-54IRWOGM.min.js";import"./c-GSVCN34B.min.js";import"./c-AG7WWVIH.min.js";import{useCustomLayoutSelection as W}from"./c-G36WS6LN.min.js";import"./c-MT3WBK7M.min.js";import"./c-UC5PTTFI.min.js";import"./c-DBQ2V7CH.min.js";import"./c-QSGWX53A.min.js";import{MultiLineTooltip as C,MultiPointTooltip as F,Tooltip as N,TooltipRoot as K,composeStyleRules as T,makeRuleValueResolver as Z,makeXYRuleContext as f,markTooltipChrome as A,matchesThreshold as L,resolveResponsiveRules as O,resolveStyleRules as X,responsiveRuleMatches as Y,ruleMatches as P}from"./c-VN2HG5BS.min.js";import"./c-GR6MOEQC.min.js";import"./c-VRXUB2F2.min.js";import"./c-GGISSW5E.min.js";import"./c-EGR6VYBW.min.js";import"./c-PGKQGGQ2.min.js";import{glyphExtent as a,glyphPlacement as e,hatchFillId as D,hatchPatternDef as x,isHatchFill as b,resolveSvgFill as d}from"./c-QKHMBE2E.min.js";export{t as AreaChart,p as BubbleChart,s as BumpChart,c as CandlestickChart,j as ConnectedScatterplot,m as DEFAULT_HIT_RADIUS,n as DifferenceChart,G as Heatmap,Q as LineChart,E as MinimapChart,S as MultiAxisLineChart,C as MultiLineTooltip,F as MultiPointTooltip,B as QuadrantChart,H as Scatterplot,M as ScatterplotMatrix,V as StackedAreaChart,U as StreamXYFrame,N as Tooltip,K as TooltipRoot,I as WaterfallChart,R as XYCustomChart,T as composeStyleRules,a as glyphExtent,e as glyphPlacement,D as hatchFillId,x as hatchPatternDef,i as hitTargetPoint,r as hitTargetRect,b as isHatchFill,Z as makeRuleValueResolver,f as makeXYRuleContext,A as markTooltipChrome,L as matchesThreshold,J as rankBumpData,o as registerBuiltInXYPlugins,O as resolveResponsiveRules,X as resolveStyleRules,d as resolveSvgFill,Y as responsiveRuleMatches,P as ruleMatches,W as useCustomLayoutSelection};
2
+ import{DEFAULT_HIT_RADIUS as m,hitTargetPoint as i,hitTargetRect as r}from"./c-HLLFJYTY.min.js";import{registerBuiltInXYPlugins as o}from"./c-7NBU5ZKS.min.js";import{AreaChart as t,BubbleChart as p,BumpChart as s,CandlestickChart as c,ConnectedScatterplot as j,DifferenceChart as n,Heatmap as O,MinimapChart as K,MultiAxisLineChart as N,QuadrantChart as P,Scatterplot as V,ScatterplotMatrix as C,StackedAreaChart as G,WaterfallChart as L,XYCustomChart as Q,rankBumpData as A}from"./c-AZKPVBOC.min.js";import"./c-VXLOLYTO.min.js";import{LineChart as T}from"./c-GSZRZRD6.min.js";import"./c-GNTXRXRN.min.js";import"./c-55BAJ333.min.js";import"./c-D6HAAPTX.min.js";import"./c-KCRJGUHP.min.js";import"./c-JO2UGTCP.min.js";import"./c-33QOXEUG.min.js";import"./c-WNGH47HF.min.js";import{StreamXYFrame_default as X}from"./c-MXCP7GNZ.min.js";import"./c-ZYPXQF7B.min.js";import"./c-P65V6HLO.min.js";import"./c-ORLEBW72.min.js";import"./c-QAVFOEUY.min.js";import"./c-CPSPZH6A.min.js";import"./c-NYZ2QNAM.min.js";import"./c-DK662R77.min.js";import"./c-ROEHCIGV.min.js";import"./c-AVO3Q7T7.min.js";import"./c-BNG5ECK5.min.js";import"./c-TKG2NP7G.min.js";import"./c-OO5QLMJC.min.js";import"./c-V4XMSLC3.min.js";import"./c-HXDKPIKR.min.js";import"./c-4FN7Q6VQ.min.js";import"./c-2N7IU2NY.min.js";import"./c-YLZIV3VS.min.js";import"./c-ITKX3RC5.min.js";import{useCustomLayoutSelection as E}from"./c-YDECTEUW.min.js";import"./c-W4ZUKSEQ.min.js";import{MultiLineTooltip as H,MultiPointTooltip as R,Tooltip as U,TooltipRoot as Y,composeStyleRules as Z,makeRuleValueResolver as S,makeXYRuleContext as f,markTooltipChrome as D,matchesThreshold as J,resolveResponsiveRules as B,resolveStyleRules as F,responsiveRuleMatches as I,ruleMatches as M}from"./c-LMGSSD2E.min.js";import"./c-CPV4N35K.min.js";import"./c-ELDWAO2V.min.js";import"./c-JUKIWTBJ.min.js";import"./c-T2V7O2LO.min.js";import"./c-QA3HMQJP.min.js";import{glyphExtent as W,glyphPlacement as a,hatchFillId as e,hatchPatternDef as x,isHatchFill as b,resolveSvgFill as d}from"./c-553QUDKA.min.js";export{t as AreaChart,p as BubbleChart,s as BumpChart,c as CandlestickChart,j as ConnectedScatterplot,m as DEFAULT_HIT_RADIUS,n as DifferenceChart,O as Heatmap,T as LineChart,K as MinimapChart,N as MultiAxisLineChart,H as MultiLineTooltip,R as MultiPointTooltip,P as QuadrantChart,V as Scatterplot,C as ScatterplotMatrix,G as StackedAreaChart,X as StreamXYFrame,U as Tooltip,Y as TooltipRoot,L as WaterfallChart,Q as XYCustomChart,Z as composeStyleRules,W as glyphExtent,a as glyphPlacement,e as hatchFillId,x as hatchPatternDef,i as hitTargetPoint,r as hitTargetRect,b as isHatchFill,S as makeRuleValueResolver,f as makeXYRuleContext,D as markTooltipChrome,J as matchesThreshold,A as rankBumpData,o as registerBuiltInXYPlugins,B as resolveResponsiveRules,F as resolveStyleRules,d as resolveSvgFill,I as responsiveRuleMatches,M as ruleMatches,E as useCustomLayoutSelection};
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "semiotic",
3
- "version": "3.9.2",
3
+ "version": "3.10.0",
4
4
  "mcpName": "io.github.nteract/semiotic",
5
5
  "description": "Verified generative visualization for React and agents, with deterministic chart validation, repair, rendering evidence, and MCP.",
6
6
  "main": "dist/semiotic.min.js",
@@ -109,6 +109,18 @@
109
109
  "require": "./dist/semiotic-ai.min.js",
110
110
  "default": "./dist/semiotic-ai.module.min.js"
111
111
  },
112
+ "./artifact": {
113
+ "types": "./dist/semiotic-artifact.d.ts",
114
+ "import": "./dist/semiotic-artifact.module.min.js",
115
+ "require": "./dist/semiotic-artifact.min.js",
116
+ "default": "./dist/semiotic-artifact.module.min.js"
117
+ },
118
+ "./artifact/react": {
119
+ "types": "./dist/semiotic-artifact-react.d.ts",
120
+ "import": "./dist/semiotic-artifact-react.module.min.js",
121
+ "require": "./dist/semiotic-artifact-react.min.js",
122
+ "default": "./dist/semiotic-artifact-react.module.min.js"
123
+ },
112
124
  "./access": {
113
125
  "types": "./dist/semiotic-access.d.ts",
114
126
  "import": "./dist/semiotic-access.module.min.js",
@@ -139,6 +151,12 @@
139
151
  "require": "./dist/geo.min.js",
140
152
  "default": "./dist/geo.module.min.js"
141
153
  },
154
+ "./text": {
155
+ "types": "./dist/semiotic-text.d.ts",
156
+ "import": "./dist/semiotic-text.module.min.js",
157
+ "require": "./dist/semiotic-text.min.js",
158
+ "default": "./dist/semiotic-text.module.min.js"
159
+ },
142
160
  "./rough": {
143
161
  "types": "./dist/semiotic-rough.d.ts",
144
162
  "import": "./dist/rough.module.min.js",
@@ -238,6 +256,8 @@
238
256
  "dist/processSankeyLayoutWorker.js",
239
257
  "ai/schema.json",
240
258
  "ai/surface-manifest.json",
259
+ "ai/artifact-contract-reference.md",
260
+ "ai/artifact-surface-inventory.json",
241
261
  "ai/reference.md",
242
262
  "ai/system-prompt.md",
243
263
  "ai/examples.md",
@@ -249,7 +269,8 @@
249
269
  "agent-skill/semiotic-charts/SKILL.md",
250
270
  "spec/**/*",
251
271
  "README.md",
252
- "LICENSE"
272
+ "LICENSE",
273
+ "ai/task-packets/**/*"
253
274
  ],
254
275
  "scripts": {
255
276
  "start": "vite --config vite.docs.config.mjs --host 127.0.0.1 --port 3000",
@@ -288,7 +309,7 @@
288
309
  "check:browser-baseline": "node scripts/browser-baseline.mjs --check",
289
310
  "print:browser-baseline": "node scripts/browser-baseline.mjs --print",
290
311
  "test:browser-baseline": "node --test scripts/browser-baseline.test.mjs",
291
- "test:release-infrastructure": "node --test scripts/bench-manifest.test.mjs scripts/bench-results.test.mjs scripts/browser-baseline.test.mjs scripts/check-docs-entry-contract.test.mjs scripts/machine-baseline.test.mjs scripts/prerender-determinism.test.mjs scripts/risk-weighted-coverage.test.mjs",
312
+ "test:release-infrastructure": "node --test scripts/bench-manifest.test.mjs scripts/bench-results.test.mjs scripts/browser-baseline.test.mjs scripts/check-docs-entry-contract.test.mjs scripts/machine-baseline.test.mjs scripts/npm-trusted-publisher.test.mjs scripts/prerender-determinism.test.mjs scripts/risk-weighted-coverage.test.mjs",
292
313
  "baseline:stream-file-sizes": "node scripts/stream-file-size-ratchet.mjs --write",
293
314
  "report:stream-file-sizes": "node scripts/stream-file-size-ratchet.mjs",
294
315
  "test:stream-file-size-ratchet": "node --test scripts/stream-file-size-ratchet.test.mjs",
@@ -352,15 +373,24 @@
352
373
  "docs:ai-instructions": "node scripts/sync-ai-instructions.mjs",
353
374
  "docs:ai-surface": "node scripts/generate-ai-surface-manifest.mjs",
354
375
  "check:ai-reference-coverage": "node scripts/check-ai-reference-coverage.js",
355
- "check:context7": "node scripts/check-context7.mjs",
376
+ "check:context7": "node --test scripts/context7-subpaths.test.mjs && node scripts/check-context7.mjs",
356
377
  "check:mcp-registry": "node scripts/check-mcp-registry.mjs",
357
378
  "check:mcp-registry-live": "node scripts/check-mcp-registry-live.mjs",
358
379
  "check:surface": "node scripts/check-surface-parity.js",
359
380
  "check:package-surface": "node scripts/generate-package-surface-manifest.mjs --check && node --test scripts/public-entrypoints.test.mjs && node scripts/check-public-entrypoints.mjs && node scripts/check-d3-packaging.mjs",
360
- "check:ai-surface": "node scripts/generate-ai-surface-manifest.mjs --check && node --test scripts/ai-surface-manifest.test.mjs",
381
+ "check:ai-surface-manifest": "node scripts/generate-ai-surface-manifest.mjs --check",
382
+ "check:ai-surface": "npm run check:ai-surface-manifest && node --test scripts/ai-surface-manifest.test.mjs",
383
+ "check:artifact-schema": "node scripts/generate-artifact-contract-reference.mjs --check && node --import tsx --test scripts/artifact-contract-schema.test.mjs scripts/artifact-field-policies.test.mjs",
384
+ "check:artifact-inventory": "node scripts/generate-artifact-surface-inventory.mjs --check && node --test scripts/artifact-surface-inventory.test.mjs",
385
+ "eval:artifact-contract": "node --import tsx scripts/artifact-contract-benchmark.ts",
386
+ "check:artifact-benchmark": "node --import tsx scripts/artifact-contract-benchmark.ts --check && node --import tsx --test scripts/artifact-contract-benchmark.test.mjs",
387
+ "check:artifact-contract": "npm run check:artifact-schema && npm run check:artifact-inventory && npm run check:artifact-benchmark",
388
+ "test:artifact-cli": "npm run dist:prod && node --test scripts/artifact-cli.test.mjs",
389
+ "test:artifact-cli:from-dist": "node --test scripts/artifact-cli.test.mjs",
361
390
  "check:agent-skill": "node scripts/check-agent-skill.mjs",
362
391
  "eval:ai": "node scripts/run-ai-evals.mjs",
363
392
  "eval:ai:openai": "node scripts/run-openai-ai-evals.mjs",
393
+ "eval:ai:orcarouter": "node scripts/run-openai-ai-evals.mjs --provider=orcarouter",
364
394
  "eval:ai:trials": "node scripts/summarize-openai-ai-eval-trials.mjs",
365
395
  "test:ai-evals": "node --test scripts/ai-eval-scoring.test.mjs scripts/ai-eval-report-summary.test.mjs scripts/run-openai-ai-evals.test.mjs scripts/summarize-openai-ai-eval-trials.test.mjs",
366
396
  "test:ai:openai": "node --test scripts/run-openai-ai-evals.test.mjs",
@@ -405,7 +435,7 @@
405
435
  "check:cold-consumer": "node scripts/measure-cold-consumer.mjs --check",
406
436
  "check:d3-packaging": "node scripts/check-d3-packaging.mjs",
407
437
  "measure:d3-packaging": "node scripts/measure-d3-packaging.mjs",
408
- "check:preflight": "npm run check:router-alignment && npm run check:playwright-alignment && npm run lint && npm run check:custom-lints && npm run check:file-size && npm run check:test-quality && npm run check:chart-specs && npm run check:capabilities && npm run check:visual-baseline-capabilities && npm run check:docs-coverage && npm run check:docs-example-integrity && npm run check:docs-prop-tables && npm run check:docs-playground-controls && npm run check:llms && npm run check:blog-entries && npm run check:ai-reference-coverage && npm run check:context7 && npm run check:mcp-registry && npm run check:surface && npm run check:ai-surface && npm run check:ai-contracts && npm run check:ai-instructions && npm run check:ssr && npm run check:jsdoc-coverage && npm run check:ai-examples-coverage && npm run check:protected-doc-boundaries",
438
+ "check:preflight": "npm run check:router-alignment && npm run check:playwright-alignment && npm run lint && npm run check:custom-lints && npm run check:file-size && npm run check:test-quality && npm run check:chart-specs && npm run check:artifact-contract && npm run check:capabilities && npm run check:visual-baseline-capabilities && npm run check:docs-coverage && npm run check:docs-example-integrity && npm run check:docs-prop-tables && npm run check:docs-playground-controls && npm run check:llms && npm run check:blog-entries && npm run check:ai-reference-coverage && npm run check:context7 && npm run check:mcp-registry && npm run check:surface && npm run check:ai-surface && npm run check:ai-contracts && npm run check:ai-instructions && npm run check:ssr && npm run check:jsdoc-coverage && npm run check:ai-examples-coverage && npm run check:protected-doc-boundaries",
409
439
  "check:package-contracts:from-dist": "npm run check:package-surface && npm run check:bundle-sizes && npm run check:cold-consumer && npm run size",
410
440
  "check:package-contracts": "npm run dist:prod && npm run check:api-surface && npm run check:package-contracts:from-dist",
411
441
  "check:fast": "npm run check:preflight && npm run check:package-contracts",
@@ -415,9 +445,15 @@
415
445
  "check:readme-dashboard": "npx tsx scripts/generate-readme-dashboard.tsx --check",
416
446
  "check:release-version-alignment": "node scripts/check-release-version-alignment.mjs",
417
447
  "check:typedoc": "typedoc --emit none",
418
- "release:check": "npm run test:examples:source && npm run check:release-version-alignment && npm run check:playwright-alignment && npm run lint && npm run check:file-size && npm run typescript && npm run typescript:tests && npm run build:declarations && npm run typescript:mcp && npm run check:mcp-bundle && npm run build:mcp && npm run test:coverage && npm run test:protected-doc-boundaries && npm run test:release-infrastructure && npm run check:chart-specs && npm run check:ai-schema && npm run check:capabilities && npm run check:visual-baseline-capabilities && npm run check:capability-coverage && npm run check:docs-coverage && npm run check:docs-example-integrity && npm run check:docs-prop-tables && npm run check:docs-playground-controls && npm run check:llms && npm run check:blog-entries && npm run check:ai-reference-coverage && npm run check:context7 && npm run check:mcp-registry && npm run test:mcp-registry-live && npm run check:surface && npm run check:ai-surface && npm run check:agent-skill && npm run check:ai-contracts && npm run check:ai-instructions && npm run check:ssr && npm run check:test-quality && npm run check:jsdoc-coverage && npm run check:ai-examples-coverage && npm run check:typedoc && npm run check:website-build && npm run check:package-surface && npm run check:api-surface && npm run check:api-compat && npm run check:protected-doc-boundaries && npm run check:readme-dashboard && npm run check:bundle-sizes && npm run check:cold-consumer && npm run size && npm run check:pack && npm run check:machine-baseline && npm run check:browser-baseline && npm pack --dry-run",
419
- "prepublishOnly": "npm run test:examples:source && npm run check:release-version-alignment && npm run check:playwright-alignment && npm run lint && npm run check:file-size && npm run typescript && npm run typescript:tests && npm run build:declarations && npm run typescript:mcp && npm run check:mcp-bundle && npm run build:mcp && npm run test:coverage && npm run test:protected-doc-boundaries && npm run test:release-infrastructure && npm run check:chart-specs && npm run check:ai-schema && npm run check:capabilities && npm run check:visual-baseline-capabilities && npm run check:capability-coverage && npm run check:docs-coverage && npm run check:docs-example-integrity && npm run check:docs-prop-tables && npm run check:llms && npm run check:blog-entries && npm run check:ai-reference-coverage && npm run check:context7 && npm run check:mcp-registry && npm run test:mcp-registry-live && npm run check:surface && npm run check:ai-surface && npm run check:agent-skill && npm run check:ai-contracts && npm run check:ai-instructions && npm run check:ssr && npm run check:test-quality && npm run check:jsdoc-coverage && npm run check:ai-examples-coverage && npm run check:typedoc && rm -rf dist && npm run check:website-build && npm run check:package-surface && npm run check:api-surface && npm run check:api-compat && npm run check:protected-doc-boundaries && npm run check:readme-dashboard && npm run check:bundle-sizes && npm run size && npm run check:machine-baseline && npm run check:browser-baseline",
420
- "check:router-alignment": "node scripts/check-router-alignment.mjs"
448
+ "release:check": "npm run test:examples:source && npm run check:release-version-alignment && npm run check:playwright-alignment && npm run lint && npm run check:file-size && npm run typescript && npm run typescript:tests && npm run build:declarations && npm run typescript:mcp && npm run check:mcp-bundle && npm run build:mcp && npm run test:coverage && npm run test:artifact-cli:from-dist && npm run test:protected-doc-boundaries && npm run test:release-infrastructure && npm run check:chart-specs && npm run check:artifact-contract && npm run check:ai-schema && npm run check:capabilities && npm run check:capability-coverage && npm run check:docs-coverage && npm run check:docs-example-integrity && npm run check:docs-prop-tables && npm run check:docs-playground-controls && npm run check:llms && npm run check:blog-entries && npm run check:ai-reference-coverage && npm run check:context7 && npm run check:mcp-registry && npm run test:mcp-registry-live && npm run check:surface && npm run check:ai-surface && npm run check:agent-skill && npm run check:ai-tasks && npm run test:adoption-evals && npm run check:adoption-evals && npm run check:ai-contracts && npm run check:ai-instructions && npm run check:ssr && npm run check:test-quality && npm run check:jsdoc-coverage && npm run check:ai-examples-coverage && npm run check:typedoc && npm run check:website-build && npm run check:package-surface && npm run check:api-surface && npm run check:api-compat && npm run check:protected-doc-boundaries && npm run check:readme-dashboard && npm run check:bundle-sizes && npm run size && npm run check:pack && npm pack --dry-run",
449
+ "prepublishOnly": "npm run test:examples:source && npm run check:release-version-alignment && npm run check:playwright-alignment && npm run lint && npm run check:file-size && npm run typescript && npm run typescript:tests && npm run build:declarations && npm run typescript:mcp && npm run check:mcp-bundle && npm run build:mcp && npm run test:coverage && npm run test:artifact-cli:from-dist && npm run test:protected-doc-boundaries && npm run test:release-infrastructure && npm run check:chart-specs && npm run check:artifact-contract && npm run check:ai-schema && npm run check:capabilities && npm run check:capability-coverage && npm run check:docs-coverage && npm run check:docs-example-integrity && npm run check:docs-prop-tables && npm run check:llms && npm run check:blog-entries && npm run check:ai-reference-coverage && npm run check:context7 && npm run check:mcp-registry && npm run test:mcp-registry-live && npm run check:surface && npm run check:ai-surface && npm run check:agent-skill && npm run check:ai-tasks && npm run check:ai-contracts && npm run check:ai-instructions && npm run check:ssr && npm run check:test-quality && npm run check:jsdoc-coverage && npm run check:ai-examples-coverage && npm run check:typedoc && rm -rf dist && npm run check:website-build && npm run check:package-surface && npm run check:api-surface && npm run check:api-compat && npm run check:protected-doc-boundaries && npm run check:readme-dashboard && npm run check:bundle-sizes && npm run size",
450
+ "check:router-alignment": "node scripts/check-router-alignment.mjs",
451
+ "docs:ai-tasks": "node scripts/generate-ai-task-packets.mjs",
452
+ "check:ai-tasks": "node --test scripts/ai-task-packets.test.mjs && node scripts/generate-ai-task-packets.mjs --check",
453
+ "verify:ai-tasks": "node scripts/verify-ai-tasks.mjs",
454
+ "prepare:adoption-evals": "node scripts/prepare-adoption-evals.mjs",
455
+ "check:adoption-evals": "node scripts/prepare-adoption-evals.mjs --check",
456
+ "test:adoption-evals": "node --test scripts/prepare-adoption-evals.test.mjs"
421
457
  },
422
458
  "repository": {
423
459
  "type": "git",
@@ -453,6 +489,7 @@
453
489
  ],
454
490
  "license": "Apache-2.0",
455
491
  "devDependencies": {
492
+ "@chenglou/pretext": "0.0.9",
456
493
  "@axe-core/playwright": "^4.12.1",
457
494
  "@eslint/compat": "^2.1.0",
458
495
  "@eslint/js": "^9.39.5",
@@ -481,13 +518,13 @@
481
518
  "@types/topojson-client": "^3.1.5",
482
519
  "@typescript-eslint/eslint-plugin": "^8.63.0",
483
520
  "@typescript-eslint/parser": "^8.63.0",
484
- "@vitejs/plugin-react": "^6.0.3",
521
+ "@vitejs/plugin-react": "^6.1.1",
485
522
  "@vitest/coverage-v8": "^4.1.10",
486
523
  "@vitest/ui": "^4.1.10",
487
524
  "ajv": "^8.20.0",
488
525
  "d3-dsv": "^3.0.1",
489
526
  "d3-flextree-v4": "^1.0.1",
490
- "esbuild": "0.28.1",
527
+ "esbuild": "0.28.2",
491
528
  "eslint": "^10.8.1",
492
529
  "eslint-plugin-react": "^7.37.5",
493
530
  "eslint-plugin-react-hooks": "^7.1.1",
@@ -506,7 +543,7 @@
506
543
  "roughjs": "^4.6.6",
507
544
  "seedrandom": "^3.0.5",
508
545
  "size-limit": "^12.1.0",
509
- "terser": "^5.49.0",
546
+ "terser": "^5.51.2",
510
547
  "tsup": "^8.5.1",
511
548
  "tsx": "^4.23.1",
512
549
  "typedoc": "^0.28.20",
@@ -517,6 +554,7 @@
517
554
  "world-atlas": "^2.0.2"
518
555
  },
519
556
  "peerDependencies": {
557
+ "@chenglou/pretext": "0.0.9",
520
558
  "@dimforge/rapier2d-compat": "^0.19.3",
521
559
  "matter-js": "^0.20.0",
522
560
  "react": "^18.1.0 || ^19.0.0",
@@ -525,6 +563,9 @@
525
563
  "world-atlas": "^2.0.2"
526
564
  },
527
565
  "peerDependenciesMeta": {
566
+ "@chenglou/pretext": {
567
+ "optional": true
568
+ },
528
569
  "@dimforge/rapier2d-compat": {
529
570
  "optional": true
530
571
  },
@@ -541,7 +582,7 @@
541
582
  "optionalDependencies": {
542
583
  "gifenc": "^1.0.3",
543
584
  "jsdom": "^29.0.2",
544
- "sharp": "^0.35.3"
585
+ "sharp": "^0.35.4"
545
586
  },
546
587
  "dependencies": {
547
588
  "d3-array": "^3.2.4",
@@ -578,7 +619,7 @@
578
619
  "node": "22.22.1"
579
620
  },
580
621
  "overrides": {
581
- "esbuild": "0.28.1",
622
+ "esbuild": "0.28.2",
582
623
  "flatted": "3.4.2",
583
624
  "minimatch": ">=9.0.7"
584
625
  }
package/spec/README.md CHANGED
@@ -1,15 +1,18 @@
1
1
  # The IDID Portability Spec
2
2
 
3
- **Version 0.1 — library-neutral JSON Schemas for three chart-metadata primitives.**
3
+ **Version 0.1 — library-neutral JSON Schemas for four information-artifact
4
+ contracts.**
4
5
 
5
- These schemas describe three pieces of metadata that make a chart *legible to an agent* and
6
- *receivable by a real audience*, independent of any rendering library:
6
+ These schemas describe portable metadata that makes a chart inspectable by
7
+ software and understandable by its intended audience, independent of any
8
+ rendering library:
7
9
 
8
10
  | Primitive | Schema | Answers |
9
11
  |---|---|---|
10
12
  | **Chart Capability** | [`v0.1/chart-capability.schema.json`](./v0.1/chart-capability.schema.json) | *What is this chart good at, and how does it survive mobile?* — declaratively, so a heuristic or an LLM can rank it against a dataset, goal, audience, and phone viewport without running a chart library. |
11
13
  | **Audience Profile** | [`v0.1/audience-profile.schema.json`](./v0.1/audience-profile.schema.json) | *Who is reading, and what is the org trying to grow?* — so a suggestion is calibrated to a real audience, not a generic baseline. |
12
14
  | **Annotation Provenance & Lifecycle** | [`v0.1/annotation-provenance.schema.json`](./v0.1/annotation-provenance.schema.json) | *Where did this note come from, how much do we trust it, and how does it age?* — so a claim *on* a chart carries its own evidence and expiry. |
15
+ | **Artifact Contract** | [`v0.1/artifact-contract.schema.json`](./v0.1/artifact-contract.schema.json) | *What does this artifact claim, what supports it, when is it valid, and what must survive transfer?* — so charts, dashboards, alerts, stories, and agent answers retain explicit interpretation and review requirements. |
13
16
 
14
17
  ## Why a spec, and not just a library API
15
18
 
@@ -103,6 +106,7 @@ The exact npm resource paths are:
103
106
  semiotic/spec/v0.1/chart-capability.schema.json
104
107
  semiotic/spec/v0.1/audience-profile.schema.json
105
108
  semiotic/spec/v0.1/annotation-provenance.schema.json
109
+ semiotic/spec/v0.1/artifact-contract.schema.json
106
110
  semiotic/spec/v0.1/examples/<example-name>.json
107
111
  semiotic/spec/bindings/vega-lite.mjs
108
112
  ```
@@ -139,6 +143,7 @@ dependency-free structural validator.
139
143
  | Chart Capability | [`chart-capability-bar-comparison.json`](./v0.1/examples/chart-capability-bar-comparison.json) — a familiar categorical comparison with a ranked variant and mobile contract | [`chart-capability-service-flow.json`](./v0.1/examples/chart-capability-service-flow.json) — an operational flow view with accessible interaction alternatives and a namespaced domain extension |
140
144
  | Audience Profile | [`audience-profile-executive-review.json`](./v0.1/examples/audience-profile-executive-review.json) — visual executive readers with inspectable adoption targets | [`audience-profile-incident-operators.json`](./v0.1/examples/audience-profile-incident-operators.json) — screen-reader reception plus namespaced role, literacy, and decision context |
141
145
  | Annotation Provenance & Lifecycle | [`annotation-provenance-watcher-threshold.json`](./v0.1/examples/annotation-provenance-watcher-threshold.json) — a proposed watcher threshold with semantic anchoring | [`annotation-provenance-reviewed-revision.json`](./v0.1/examples/annotation-provenance-reviewed-revision.json) — a human-reviewed accepted note that supersedes an earlier claim |
146
+ | Artifact Contract | [`artifact-contract-full.json`](./v0.1/examples/artifact-contract-full.json) — a complete chart contract with claims, evidence, review, and transfer requirements | [`artifact-contract-unknown-state.json`](./v0.1/examples/artifact-contract-unknown-state.json) — an explicit record of unknown, manual, and not-applicable fields |
142
147
 
143
148
  ## The Vega-Lite binding (carrying IDID metadata on a portable spec)
144
149