@haneinfo/report-engine 0.0.0-stage → 0.1.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 (516) hide show
  1. package/LICENSE +14 -0
  2. package/README.md +862 -2
  3. package/agent-guide.md +31 -0
  4. package/dist/client/reportPdf.d.ts +15 -0
  5. package/dist/client/reportPdf.d.ts.map +1 -0
  6. package/dist/client/reportPdf.js +47 -0
  7. package/dist/client/reportPdf.js.map +1 -0
  8. package/dist/compiler/bandLayout.d.ts +7 -0
  9. package/dist/compiler/bandLayout.d.ts.map +1 -0
  10. package/dist/compiler/bandLayout.js +65 -0
  11. package/dist/compiler/bandLayout.js.map +1 -0
  12. package/dist/compiler/bandPipeline.d.ts +12 -0
  13. package/dist/compiler/bandPipeline.d.ts.map +1 -0
  14. package/dist/compiler/bandPipeline.js +47 -0
  15. package/dist/compiler/bandPipeline.js.map +1 -0
  16. package/dist/compiler/evaluator.d.ts +7 -0
  17. package/dist/compiler/evaluator.d.ts.map +1 -0
  18. package/dist/compiler/evaluator.js +13 -0
  19. package/dist/compiler/evaluator.js.map +1 -0
  20. package/dist/compiler/formatters.d.ts +3 -0
  21. package/dist/compiler/formatters.d.ts.map +1 -0
  22. package/dist/compiler/formatters.js +121 -0
  23. package/dist/compiler/formatters.js.map +1 -0
  24. package/dist/compiler/grouping.d.ts +16 -0
  25. package/dist/compiler/grouping.d.ts.map +1 -0
  26. package/dist/compiler/grouping.js +55 -0
  27. package/dist/compiler/grouping.js.map +1 -0
  28. package/dist/compiler/pdfCompiler.d.ts +9 -0
  29. package/dist/compiler/pdfCompiler.d.ts.map +1 -0
  30. package/dist/compiler/pdfCompiler.js +82 -0
  31. package/dist/compiler/pdfCompiler.js.map +1 -0
  32. package/dist/components/data/DataSourceEditor.d.ts +2 -0
  33. package/dist/components/data/DataSourceEditor.d.ts.map +1 -0
  34. package/dist/components/data/DataSourceEditor.js +80 -0
  35. package/dist/components/data/DataSourceEditor.js.map +1 -0
  36. package/dist/components/designer/BandCanvas.d.ts +4 -0
  37. package/dist/components/designer/BandCanvas.d.ts.map +1 -0
  38. package/dist/components/designer/BandCanvas.js +630 -0
  39. package/dist/components/designer/BandCanvas.js.map +1 -0
  40. package/dist/components/designer/Navbar.d.ts +3 -0
  41. package/dist/components/designer/Navbar.d.ts.map +1 -0
  42. package/dist/components/designer/Navbar.js +93 -0
  43. package/dist/components/designer/Navbar.js.map +1 -0
  44. package/dist/components/designer/PropertyPanel.d.ts +3 -0
  45. package/dist/components/designer/PropertyPanel.d.ts.map +1 -0
  46. package/dist/components/designer/PropertyPanel.js +65 -0
  47. package/dist/components/designer/PropertyPanel.js.map +1 -0
  48. package/dist/components/designer/Toolbox.d.ts +3 -0
  49. package/dist/components/designer/Toolbox.d.ts.map +1 -0
  50. package/dist/components/designer/Toolbox.js +236 -0
  51. package/dist/components/designer/Toolbox.js.map +1 -0
  52. package/dist/components/designer/properties/BandPropertiesSection.d.ts +12 -0
  53. package/dist/components/designer/properties/BandPropertiesSection.d.ts.map +1 -0
  54. package/dist/components/designer/properties/BandPropertiesSection.js +30 -0
  55. package/dist/components/designer/properties/BandPropertiesSection.js.map +1 -0
  56. package/dist/components/designer/properties/ColorPickerField.d.ts +14 -0
  57. package/dist/components/designer/properties/ColorPickerField.d.ts.map +1 -0
  58. package/dist/components/designer/properties/ColorPickerField.js +10 -0
  59. package/dist/components/designer/properties/ColorPickerField.js.map +1 -0
  60. package/dist/components/designer/properties/ConditionalPrintSection.d.ts +6 -0
  61. package/dist/components/designer/properties/ConditionalPrintSection.d.ts.map +1 -0
  62. package/dist/components/designer/properties/ConditionalPrintSection.js +112 -0
  63. package/dist/components/designer/properties/ConditionalPrintSection.js.map +1 -0
  64. package/dist/components/designer/properties/ControlSpecificInspector.d.ts +11 -0
  65. package/dist/components/designer/properties/ControlSpecificInspector.d.ts.map +1 -0
  66. package/dist/components/designer/properties/ControlSpecificInspector.js +52 -0
  67. package/dist/components/designer/properties/ControlSpecificInspector.js.map +1 -0
  68. package/dist/components/designer/properties/FieldSelectInput.d.ts +14 -0
  69. package/dist/components/designer/properties/FieldSelectInput.d.ts.map +1 -0
  70. package/dist/components/designer/properties/FieldSelectInput.js +13 -0
  71. package/dist/components/designer/properties/FieldSelectInput.js.map +1 -0
  72. package/dist/components/designer/properties/GeometrySection.d.ts +9 -0
  73. package/dist/components/designer/properties/GeometrySection.d.ts.map +1 -0
  74. package/dist/components/designer/properties/GeometrySection.js +9 -0
  75. package/dist/components/designer/properties/GeometrySection.js.map +1 -0
  76. package/dist/components/designer/properties/GlobalReportSettings.d.ts +3 -0
  77. package/dist/components/designer/properties/GlobalReportSettings.d.ts.map +1 -0
  78. package/dist/components/designer/properties/GlobalReportSettings.js +37 -0
  79. package/dist/components/designer/properties/GlobalReportSettings.js.map +1 -0
  80. package/dist/components/designer/properties/TypographySection.d.ts +10 -0
  81. package/dist/components/designer/properties/TypographySection.d.ts.map +1 -0
  82. package/dist/components/designer/properties/TypographySection.js +41 -0
  83. package/dist/components/designer/properties/TypographySection.js.map +1 -0
  84. package/dist/components/diagnostics/ReportPreflightPanel.d.ts +2 -0
  85. package/dist/components/diagnostics/ReportPreflightPanel.d.ts.map +1 -0
  86. package/dist/components/diagnostics/ReportPreflightPanel.js +39 -0
  87. package/dist/components/diagnostics/ReportPreflightPanel.js.map +1 -0
  88. package/dist/components/formula/CalculatedFieldsPanel.d.ts +2 -0
  89. package/dist/components/formula/CalculatedFieldsPanel.d.ts.map +1 -0
  90. package/dist/components/formula/CalculatedFieldsPanel.js +79 -0
  91. package/dist/components/formula/CalculatedFieldsPanel.js.map +1 -0
  92. package/dist/components/formula/ControlFormulaEditor.d.ts +7 -0
  93. package/dist/components/formula/ControlFormulaEditor.d.ts.map +1 -0
  94. package/dist/components/formula/ControlFormulaEditor.js +31 -0
  95. package/dist/components/formula/ControlFormulaEditor.js.map +1 -0
  96. package/dist/components/formula/FormulaEditor.d.ts +16 -0
  97. package/dist/components/formula/FormulaEditor.d.ts.map +1 -0
  98. package/dist/components/formula/FormulaEditor.js +93 -0
  99. package/dist/components/formula/FormulaEditor.js.map +1 -0
  100. package/dist/components/formula/useFormulaData.d.ts +8 -0
  101. package/dist/components/formula/useFormulaData.d.ts.map +1 -0
  102. package/dist/components/formula/useFormulaData.js +25 -0
  103. package/dist/components/formula/useFormulaData.js.map +1 -0
  104. package/dist/components/parameters/ParameterEditor.d.ts +3 -0
  105. package/dist/components/parameters/ParameterEditor.d.ts.map +1 -0
  106. package/dist/components/parameters/ParameterEditor.js +123 -0
  107. package/dist/components/parameters/ParameterEditor.js.map +1 -0
  108. package/dist/components/parameters/ParameterPanel.d.ts +6 -0
  109. package/dist/components/parameters/ParameterPanel.d.ts.map +1 -0
  110. package/dist/components/parameters/ParameterPanel.js +172 -0
  111. package/dist/components/parameters/ParameterPanel.js.map +1 -0
  112. package/dist/components/schema/SchemaViewer.d.ts +3 -0
  113. package/dist/components/schema/SchemaViewer.d.ts.map +1 -0
  114. package/dist/components/schema/SchemaViewer.js +61 -0
  115. package/dist/components/schema/SchemaViewer.js.map +1 -0
  116. package/dist/components/ui/badge.d.ts +7 -0
  117. package/dist/components/ui/badge.d.ts.map +1 -0
  118. package/dist/components/ui/badge.js +7 -0
  119. package/dist/components/ui/badge.js.map +1 -0
  120. package/dist/components/ui/badgeVariants.d.ts +4 -0
  121. package/dist/components/ui/badgeVariants.d.ts.map +1 -0
  122. package/dist/components/ui/badgeVariants.js +15 -0
  123. package/dist/components/ui/badgeVariants.js.map +1 -0
  124. package/dist/components/ui/button.d.ts +7 -0
  125. package/dist/components/ui/button.d.ts.map +1 -0
  126. package/dist/components/ui/button.js +9 -0
  127. package/dist/components/ui/button.js.map +1 -0
  128. package/dist/components/ui/buttonVariants.d.ts +5 -0
  129. package/dist/components/ui/buttonVariants.d.ts.map +1 -0
  130. package/dist/components/ui/buttonVariants.js +24 -0
  131. package/dist/components/ui/buttonVariants.js.map +1 -0
  132. package/dist/components/ui/checkbox.d.ts +5 -0
  133. package/dist/components/ui/checkbox.d.ts.map +1 -0
  134. package/dist/components/ui/checkbox.js +9 -0
  135. package/dist/components/ui/checkbox.js.map +1 -0
  136. package/dist/components/ui/date-input.d.ts +7 -0
  137. package/dist/components/ui/date-input.d.ts.map +1 -0
  138. package/dist/components/ui/date-input.js +41 -0
  139. package/dist/components/ui/date-input.js.map +1 -0
  140. package/dist/components/ui/input.d.ts +7 -0
  141. package/dist/components/ui/input.d.ts.map +1 -0
  142. package/dist/components/ui/input.js +10 -0
  143. package/dist/components/ui/input.js.map +1 -0
  144. package/dist/components/ui/label.d.ts +6 -0
  145. package/dist/components/ui/label.d.ts.map +1 -0
  146. package/dist/components/ui/label.js +7 -0
  147. package/dist/components/ui/label.js.map +1 -0
  148. package/dist/components/ui/native-select.d.ts +3 -0
  149. package/dist/components/ui/native-select.d.ts.map +1 -0
  150. package/dist/components/ui/native-select.js +8 -0
  151. package/dist/components/ui/native-select.js.map +1 -0
  152. package/dist/components/viewer/ReportViewer.d.ts +2 -0
  153. package/dist/components/viewer/ReportViewer.d.ts.map +1 -0
  154. package/dist/components/viewer/ReportViewer.js +103 -0
  155. package/dist/components/viewer/ReportViewer.js.map +1 -0
  156. package/dist/constants/labels.d.ts +14 -0
  157. package/dist/constants/labels.d.ts.map +1 -0
  158. package/dist/constants/labels.js +53 -0
  159. package/dist/constants/labels.js.map +1 -0
  160. package/dist/controls/barcodeUtils.d.ts +27 -0
  161. package/dist/controls/barcodeUtils.d.ts.map +1 -0
  162. package/dist/controls/barcodeUtils.js +93 -0
  163. package/dist/controls/barcodeUtils.js.map +1 -0
  164. package/dist/controls/pdfRegistry.d.ts +10 -0
  165. package/dist/controls/pdfRegistry.d.ts.map +1 -0
  166. package/dist/controls/pdfRegistry.js +204 -0
  167. package/dist/controls/pdfRegistry.js.map +1 -0
  168. package/dist/controls/plugins/BarcodeControl.d.ts +3 -0
  169. package/dist/controls/plugins/BarcodeControl.d.ts.map +1 -0
  170. package/dist/controls/plugins/BarcodeControl.js +34 -0
  171. package/dist/controls/plugins/BarcodeControl.js.map +1 -0
  172. package/dist/controls/plugins/CheckBoxControl.d.ts +3 -0
  173. package/dist/controls/plugins/CheckBoxControl.d.ts.map +1 -0
  174. package/dist/controls/plugins/CheckBoxControl.js +34 -0
  175. package/dist/controls/plugins/CheckBoxControl.js.map +1 -0
  176. package/dist/controls/plugins/ExpressionControl.d.ts +3 -0
  177. package/dist/controls/plugins/ExpressionControl.d.ts.map +1 -0
  178. package/dist/controls/plugins/ExpressionControl.js +28 -0
  179. package/dist/controls/plugins/ExpressionControl.js.map +1 -0
  180. package/dist/controls/plugins/FieldControl.d.ts +3 -0
  181. package/dist/controls/plugins/FieldControl.d.ts.map +1 -0
  182. package/dist/controls/plugins/FieldControl.js +30 -0
  183. package/dist/controls/plugins/FieldControl.js.map +1 -0
  184. package/dist/controls/plugins/ImageControl.d.ts +3 -0
  185. package/dist/controls/plugins/ImageControl.d.ts.map +1 -0
  186. package/dist/controls/plugins/ImageControl.js +29 -0
  187. package/dist/controls/plugins/ImageControl.js.map +1 -0
  188. package/dist/controls/plugins/LabelControl.d.ts +3 -0
  189. package/dist/controls/plugins/LabelControl.d.ts.map +1 -0
  190. package/dist/controls/plugins/LabelControl.js +32 -0
  191. package/dist/controls/plugins/LabelControl.js.map +1 -0
  192. package/dist/controls/plugins/LineControl.d.ts +3 -0
  193. package/dist/controls/plugins/LineControl.d.ts.map +1 -0
  194. package/dist/controls/plugins/LineControl.js +31 -0
  195. package/dist/controls/plugins/LineControl.js.map +1 -0
  196. package/dist/controls/plugins/PanelControl.d.ts +3 -0
  197. package/dist/controls/plugins/PanelControl.d.ts.map +1 -0
  198. package/dist/controls/plugins/PanelControl.js +35 -0
  199. package/dist/controls/plugins/PanelControl.js.map +1 -0
  200. package/dist/controls/plugins/QRCodeControl.d.ts +3 -0
  201. package/dist/controls/plugins/QRCodeControl.d.ts.map +1 -0
  202. package/dist/controls/plugins/QRCodeControl.js +43 -0
  203. package/dist/controls/plugins/QRCodeControl.js.map +1 -0
  204. package/dist/controls/plugins/SubReportControl.d.ts +3 -0
  205. package/dist/controls/plugins/SubReportControl.d.ts.map +1 -0
  206. package/dist/controls/plugins/SubReportControl.js +58 -0
  207. package/dist/controls/plugins/SubReportControl.js.map +1 -0
  208. package/dist/controls/registry.d.ts +18 -0
  209. package/dist/controls/registry.d.ts.map +1 -0
  210. package/dist/controls/registry.js +59 -0
  211. package/dist/controls/registry.js.map +1 -0
  212. package/dist/controls/styleUtils.d.ts +11 -0
  213. package/dist/controls/styleUtils.d.ts.map +1 -0
  214. package/dist/controls/styleUtils.js +63 -0
  215. package/dist/controls/styleUtils.js.map +1 -0
  216. package/dist/controls/types.d.ts +31 -0
  217. package/dist/controls/types.d.ts.map +1 -0
  218. package/dist/controls/types.js +2 -0
  219. package/dist/controls/types.js.map +1 -0
  220. package/dist/data/schema.d.ts +10 -0
  221. package/dist/data/schema.d.ts.map +1 -0
  222. package/dist/data/schema.js +117 -0
  223. package/dist/data/schema.js.map +1 -0
  224. package/dist/data/schemaField.d.ts +3 -0
  225. package/dist/data/schemaField.d.ts.map +1 -0
  226. package/dist/data/schemaField.js +9 -0
  227. package/dist/data/schemaField.js.map +1 -0
  228. package/dist/designer/DesignerView.d.ts +5 -0
  229. package/dist/designer/DesignerView.d.ts.map +1 -0
  230. package/dist/designer/DesignerView.js +51 -0
  231. package/dist/designer/DesignerView.js.map +1 -0
  232. package/dist/designer/EditorToolbar.d.ts +4 -0
  233. package/dist/designer/EditorToolbar.d.ts.map +1 -0
  234. package/dist/designer/EditorToolbar.js +23 -0
  235. package/dist/designer/EditorToolbar.js.map +1 -0
  236. package/dist/designer/ReportDesigner.d.ts +21 -0
  237. package/dist/designer/ReportDesigner.d.ts.map +1 -0
  238. package/dist/designer/ReportDesigner.js +98 -0
  239. package/dist/designer/ReportDesigner.js.map +1 -0
  240. package/dist/designer/ReportViewer.d.ts +5 -0
  241. package/dist/designer/ReportViewer.d.ts.map +1 -0
  242. package/dist/designer/ReportViewer.js +7 -0
  243. package/dist/designer/ReportViewer.js.map +1 -0
  244. package/dist/designer/parameterDateTime.d.ts +4 -0
  245. package/dist/designer/parameterDateTime.d.ts.map +1 -0
  246. package/dist/designer/parameterDateTime.js +15 -0
  247. package/dist/designer/parameterDateTime.js.map +1 -0
  248. package/dist/designer/previewData.d.ts +21 -0
  249. package/dist/designer/previewData.d.ts.map +1 -0
  250. package/dist/designer/previewData.js +85 -0
  251. package/dist/designer/previewData.js.map +1 -0
  252. package/dist/designer/services.d.ts +28 -0
  253. package/dist/designer/services.d.ts.map +1 -0
  254. package/dist/designer/services.js +8 -0
  255. package/dist/designer/services.js.map +1 -0
  256. package/dist/formula/engine.d.ts +23 -0
  257. package/dist/formula/engine.d.ts.map +1 -0
  258. package/dist/formula/engine.js +310 -0
  259. package/dist/formula/engine.js.map +1 -0
  260. package/dist/formula/parser.d.ts +5 -0
  261. package/dist/formula/parser.d.ts.map +1 -0
  262. package/dist/formula/parser.js +197 -0
  263. package/dist/formula/parser.js.map +1 -0
  264. package/dist/formula/presentation.d.ts +9 -0
  265. package/dist/formula/presentation.d.ts.map +1 -0
  266. package/dist/formula/presentation.js +40 -0
  267. package/dist/formula/presentation.js.map +1 -0
  268. package/dist/formula/registry.d.ts +83 -0
  269. package/dist/formula/registry.d.ts.map +1 -0
  270. package/dist/formula/registry.js +365 -0
  271. package/dist/formula/registry.js.map +1 -0
  272. package/dist/formula/report.d.ts +23 -0
  273. package/dist/formula/report.d.ts.map +1 -0
  274. package/dist/formula/report.js +400 -0
  275. package/dist/formula/report.js.map +1 -0
  276. package/dist/formula/types.d.ts +119 -0
  277. package/dist/formula/types.d.ts.map +1 -0
  278. package/dist/formula/types.js +27 -0
  279. package/dist/formula/types.js.map +1 -0
  280. package/dist/formula/values.d.ts +17 -0
  281. package/dist/formula/values.d.ts.map +1 -0
  282. package/dist/formula/values.js +125 -0
  283. package/dist/formula/values.js.map +1 -0
  284. package/dist/i18n/config.d.ts +5 -0
  285. package/dist/i18n/config.d.ts.map +1 -0
  286. package/dist/i18n/config.js +7 -0
  287. package/dist/i18n/config.js.map +1 -0
  288. package/dist/i18n/index.d.ts +18 -0
  289. package/dist/i18n/index.d.ts.map +1 -0
  290. package/dist/i18n/index.js +26 -0
  291. package/dist/i18n/index.js.map +1 -0
  292. package/dist/i18n/messages/en.d.ts +3 -0
  293. package/dist/i18n/messages/en.d.ts.map +1 -0
  294. package/dist/i18n/messages/en.js +420 -0
  295. package/dist/i18n/messages/en.js.map +1 -0
  296. package/dist/i18n/messages/index.d.ts +5 -0
  297. package/dist/i18n/messages/index.d.ts.map +1 -0
  298. package/dist/i18n/messages/index.js +7 -0
  299. package/dist/i18n/messages/index.js.map +1 -0
  300. package/dist/i18n/messages/zh-TW.d.ts +425 -0
  301. package/dist/i18n/messages/zh-TW.d.ts.map +1 -0
  302. package/dist/i18n/messages/zh-TW.js +420 -0
  303. package/dist/i18n/messages/zh-TW.js.map +1 -0
  304. package/dist/inspector/layoutInspector.d.ts +22 -0
  305. package/dist/inspector/layoutInspector.d.ts.map +1 -0
  306. package/dist/inspector/layoutInspector.js +317 -0
  307. package/dist/inspector/layoutInspector.js.map +1 -0
  308. package/dist/inspector/measureBand.d.ts +4 -0
  309. package/dist/inspector/measureBand.d.ts.map +1 -0
  310. package/dist/inspector/measureBand.js +19 -0
  311. package/dist/inspector/measureBand.js.map +1 -0
  312. package/dist/lib/required.d.ts +3 -0
  313. package/dist/lib/required.d.ts.map +1 -0
  314. package/dist/lib/required.js +7 -0
  315. package/dist/lib/required.js.map +1 -0
  316. package/dist/lib/utils.d.ts +3 -0
  317. package/dist/lib/utils.d.ts.map +1 -0
  318. package/dist/lib/utils.js +6 -0
  319. package/dist/lib/utils.js.map +1 -0
  320. package/dist/mcp/changeTools.d.ts +294 -0
  321. package/dist/mcp/changeTools.d.ts.map +1 -0
  322. package/dist/mcp/changeTools.js +262 -0
  323. package/dist/mcp/changeTools.js.map +1 -0
  324. package/dist/mcp/contracts.d.ts +48 -0
  325. package/dist/mcp/contracts.d.ts.map +1 -0
  326. package/dist/mcp/contracts.js +2 -0
  327. package/dist/mcp/contracts.js.map +1 -0
  328. package/dist/mcp/formulaTools.d.ts +13 -0
  329. package/dist/mcp/formulaTools.d.ts.map +1 -0
  330. package/dist/mcp/formulaTools.js +148 -0
  331. package/dist/mcp/formulaTools.js.map +1 -0
  332. package/dist/mcp/index.d.ts +3 -0
  333. package/dist/mcp/index.d.ts.map +1 -0
  334. package/dist/mcp/index.js +42 -0
  335. package/dist/mcp/index.js.map +1 -0
  336. package/dist/mcp/results.d.ts +16 -0
  337. package/dist/mcp/results.d.ts.map +1 -0
  338. package/dist/mcp/results.js +83 -0
  339. package/dist/mcp/results.js.map +1 -0
  340. package/dist/mcp/server.d.ts +9 -0
  341. package/dist/mcp/server.d.ts.map +1 -0
  342. package/dist/mcp/server.js +410 -0
  343. package/dist/mcp/server.js.map +1 -0
  344. package/dist/mcp/stdio.d.ts +16 -0
  345. package/dist/mcp/stdio.d.ts.map +1 -0
  346. package/dist/mcp/stdio.js +51 -0
  347. package/dist/mcp/stdio.js.map +1 -0
  348. package/dist/mcp/tools.d.ts +11 -0
  349. package/dist/mcp/tools.d.ts.map +1 -0
  350. package/dist/mcp/tools.js +346 -0
  351. package/dist/mcp/tools.js.map +1 -0
  352. package/dist/mock/mockDataSource.d.ts +29 -0
  353. package/dist/mock/mockDataSource.d.ts.map +1 -0
  354. package/dist/mock/mockDataSource.js +350 -0
  355. package/dist/mock/mockDataSource.js.map +1 -0
  356. package/dist/mock/sampleReport.d.ts +4 -0
  357. package/dist/mock/sampleReport.d.ts.map +1 -0
  358. package/dist/mock/sampleReport.js +1001 -0
  359. package/dist/mock/sampleReport.js.map +1 -0
  360. package/dist/public/core.d.ts +22 -0
  361. package/dist/public/core.d.ts.map +1 -0
  362. package/dist/public/core.js +16 -0
  363. package/dist/public/core.js.map +1 -0
  364. package/dist/public/designer.d.ts +11 -0
  365. package/dist/public/designer.d.ts.map +1 -0
  366. package/dist/public/designer.js +5 -0
  367. package/dist/public/designer.js.map +1 -0
  368. package/dist/public/mcp.d.ts +8 -0
  369. package/dist/public/mcp.d.ts.map +1 -0
  370. package/dist/public/mcp.js +4 -0
  371. package/dist/public/mcp.js.map +1 -0
  372. package/dist/public/pdf.d.ts +6 -0
  373. package/dist/public/pdf.d.ts.map +1 -0
  374. package/dist/public/pdf.js +5 -0
  375. package/dist/public/pdf.js.map +1 -0
  376. package/dist/public/registry.d.ts +3 -0
  377. package/dist/public/registry.d.ts.map +1 -0
  378. package/dist/public/registry.js +2 -0
  379. package/dist/public/registry.js.map +1 -0
  380. package/dist/registry/adapter.d.ts +27 -0
  381. package/dist/registry/adapter.d.ts.map +1 -0
  382. package/dist/registry/adapter.js +143 -0
  383. package/dist/registry/adapter.js.map +1 -0
  384. package/dist/report/conflict.d.ts +4 -0
  385. package/dist/report/conflict.d.ts.map +1 -0
  386. package/dist/report/conflict.js +6 -0
  387. package/dist/report/conflict.js.map +1 -0
  388. package/dist/report/dataPath.d.ts +3 -0
  389. package/dist/report/dataPath.d.ts.map +1 -0
  390. package/dist/report/dataPath.js +11 -0
  391. package/dist/report/dataPath.js.map +1 -0
  392. package/dist/report/dataSchema.d.ts +4 -0
  393. package/dist/report/dataSchema.d.ts.map +1 -0
  394. package/dist/report/dataSchema.js +10 -0
  395. package/dist/report/dataSchema.js.map +1 -0
  396. package/dist/report/defaultSubReport.d.ts +6 -0
  397. package/dist/report/defaultSubReport.d.ts.map +1 -0
  398. package/dist/report/defaultSubReport.js +224 -0
  399. package/dist/report/defaultSubReport.js.map +1 -0
  400. package/dist/report/diagnostics.d.ts +7 -0
  401. package/dist/report/diagnostics.d.ts.map +1 -0
  402. package/dist/report/diagnostics.js +43 -0
  403. package/dist/report/diagnostics.js.map +1 -0
  404. package/dist/report/document.d.ts +58 -0
  405. package/dist/report/document.d.ts.map +1 -0
  406. package/dist/report/document.js +71 -0
  407. package/dist/report/document.js.map +1 -0
  408. package/dist/report/geometry.d.ts +14 -0
  409. package/dist/report/geometry.d.ts.map +1 -0
  410. package/dist/report/geometry.js +21 -0
  411. package/dist/report/geometry.js.map +1 -0
  412. package/dist/report/layoutDiagnostics.d.ts +5 -0
  413. package/dist/report/layoutDiagnostics.d.ts.map +1 -0
  414. package/dist/report/layoutDiagnostics.js +70 -0
  415. package/dist/report/layoutDiagnostics.js.map +1 -0
  416. package/dist/report/operations.d.ts +12 -0
  417. package/dist/report/operations.d.ts.map +1 -0
  418. package/dist/report/operations.js +81 -0
  419. package/dist/report/operations.js.map +1 -0
  420. package/dist/report/pagination.d.ts +5 -0
  421. package/dist/report/pagination.d.ts.map +1 -0
  422. package/dist/report/pagination.js +5 -0
  423. package/dist/report/pagination.js.map +1 -0
  424. package/dist/report/parameters.d.ts +14 -0
  425. package/dist/report/parameters.d.ts.map +1 -0
  426. package/dist/report/parameters.js +223 -0
  427. package/dist/report/parameters.js.map +1 -0
  428. package/dist/report/preflight.d.ts +75 -0
  429. package/dist/report/preflight.d.ts.map +1 -0
  430. package/dist/report/preflight.js +160 -0
  431. package/dist/report/preflight.js.map +1 -0
  432. package/dist/report/presentationCapabilities.d.ts +3 -0
  433. package/dist/report/presentationCapabilities.d.ts.map +1 -0
  434. package/dist/report/presentationCapabilities.js +13 -0
  435. package/dist/report/presentationCapabilities.js.map +1 -0
  436. package/dist/report/schema.d.ts +91 -0
  437. package/dist/report/schema.d.ts.map +1 -0
  438. package/dist/report/schema.js +168 -0
  439. package/dist/report/schema.js.map +1 -0
  440. package/dist/report/subReport.d.ts +7 -0
  441. package/dist/report/subReport.d.ts.map +1 -0
  442. package/dist/report/subReport.js +37 -0
  443. package/dist/report/subReport.js.map +1 -0
  444. package/dist/report/validateDocument.d.ts +8 -0
  445. package/dist/report/validateDocument.d.ts.map +1 -0
  446. package/dist/report/validateDocument.js +99 -0
  447. package/dist/report/validateDocument.js.map +1 -0
  448. package/dist/server/atomicFile.d.ts +11 -0
  449. package/dist/server/atomicFile.d.ts.map +1 -0
  450. package/dist/server/atomicFile.js +24 -0
  451. package/dist/server/atomicFile.js.map +1 -0
  452. package/dist/server/documentRepository.d.ts +26 -0
  453. package/dist/server/documentRepository.d.ts.map +1 -0
  454. package/dist/server/documentRepository.js +78 -0
  455. package/dist/server/documentRepository.js.map +1 -0
  456. package/dist/server/pdfService.d.ts +12 -0
  457. package/dist/server/pdfService.d.ts.map +1 -0
  458. package/dist/server/pdfService.js +117 -0
  459. package/dist/server/pdfService.js.map +1 -0
  460. package/dist/server/pdfWorker.d.ts +2 -0
  461. package/dist/server/pdfWorker.d.ts.map +1 -0
  462. package/dist/server/pdfWorker.js +101 -0
  463. package/dist/server/pdfWorker.js.map +1 -0
  464. package/dist/server/renderSafety.d.ts +26 -0
  465. package/dist/server/renderSafety.d.ts.map +1 -0
  466. package/dist/server/renderSafety.js +89 -0
  467. package/dist/server/renderSafety.js.map +1 -0
  468. package/dist/server/reportApi.d.ts +6 -0
  469. package/dist/server/reportApi.d.ts.map +1 -0
  470. package/dist/server/reportApi.js +114 -0
  471. package/dist/server/reportApi.js.map +1 -0
  472. package/dist/server/reportRepository.d.ts +17 -0
  473. package/dist/server/reportRepository.d.ts.map +1 -0
  474. package/dist/server/reportRepository.js +72 -0
  475. package/dist/server/reportRepository.js.map +1 -0
  476. package/dist/server/requestSchema.d.ts +73 -0
  477. package/dist/server/requestSchema.d.ts.map +1 -0
  478. package/dist/server/requestSchema.js +47 -0
  479. package/dist/server/requestSchema.js.map +1 -0
  480. package/dist/store/useReportStore.d.ts +62 -0
  481. package/dist/store/useReportStore.d.ts.map +1 -0
  482. package/dist/store/useReportStore.js +470 -0
  483. package/dist/store/useReportStore.js.map +1 -0
  484. package/dist/sync/reportSync.d.ts +34 -0
  485. package/dist/sync/reportSync.d.ts.map +1 -0
  486. package/dist/sync/reportSync.js +167 -0
  487. package/dist/sync/reportSync.js.map +1 -0
  488. package/dist/sync/useReportSync.d.ts +11 -0
  489. package/dist/sync/useReportSync.d.ts.map +1 -0
  490. package/dist/sync/useReportSync.js +58 -0
  491. package/dist/sync/useReportSync.js.map +1 -0
  492. package/dist/types/datasource.d.ts +44 -0
  493. package/dist/types/datasource.d.ts.map +1 -0
  494. package/dist/types/datasource.js +6 -0
  495. package/dist/types/datasource.js.map +1 -0
  496. package/dist/types/diagnostics.d.ts +28 -0
  497. package/dist/types/diagnostics.d.ts.map +1 -0
  498. package/dist/types/diagnostics.js +2 -0
  499. package/dist/types/diagnostics.js.map +1 -0
  500. package/dist/types/document.d.ts +35 -0
  501. package/dist/types/document.d.ts.map +1 -0
  502. package/dist/types/document.js +2 -0
  503. package/dist/types/document.js.map +1 -0
  504. package/dist/types/parameters.d.ts +39 -0
  505. package/dist/types/parameters.d.ts.map +1 -0
  506. package/dist/types/parameters.js +2 -0
  507. package/dist/types/parameters.js.map +1 -0
  508. package/dist/types/render.d.ts +21 -0
  509. package/dist/types/render.d.ts.map +1 -0
  510. package/dist/types/render.js +2 -0
  511. package/dist/types/render.js.map +1 -0
  512. package/dist/types/report.d.ts +108 -0
  513. package/dist/types/report.d.ts.map +1 -0
  514. package/dist/types/report.js +13 -0
  515. package/dist/types/report.js.map +1 -0
  516. package/package.json +112 -3
@@ -0,0 +1,410 @@
1
+ import { definitionPermission } from '@haneinfo/plugin-api';
2
+ import { ReportConflictError } from '../report/conflict.js';
3
+ import { parseReportDocument, sampleDataSource } from '../report/document.js';
4
+ import { conditionalStylesByControl } from '../report/presentationCapabilities.js';
5
+ import { sanitizeValues, validateReportImages } from '../server/renderSafety.js';
6
+ import { handleChangeTool } from './changeTools.js';
7
+ import { normalizeToolReply, toolFailure, toolReply } from './results.js';
8
+ /**
9
+ * Report Engine MCP Server (Pixel-Level Banded Architecture)
10
+ * Exposes Agent-Native Pixel-Level Layout Tools via Model Context Protocol (MCP).
11
+ * Compatible with Cursor, Claude Desktop, Antigravity, and other MCP clients.
12
+ */
13
+ import { parseDataSource } from '../data/schema.js';
14
+ import { getFormulaCatalog } from '../formula/registry.js';
15
+ import { inspectReportLayout, renderReportToSvg } from '../inspector/layoutInspector.js';
16
+ import { childSchema } from '../report/dataSchema.js';
17
+ import { getPageGeometry } from '../report/geometry.js';
18
+ import { deleteControl, patchControl, updateReportBand, updateReportScope, } from '../report/operations.js';
19
+ import { parseReport } from '../report/schema.js';
20
+ import { validateReportDocument } from '../report/validateDocument.js';
21
+ import { renderReportPdf } from '../server/pdfService.js';
22
+ import { handleFormulaTool } from './formulaTools.js';
23
+ import { mutatingReportTools, reportTools } from './tools.js';
24
+ function describeChildren(report, schema, parentPath = []) {
25
+ return report.bands.flatMap((band) => band.controls.flatMap((control) => {
26
+ if (!control.subReportDefinition)
27
+ return [];
28
+ const fields = childSchema(control, schema);
29
+ if (!fields)
30
+ throw new Error('Subreport data schema missing');
31
+ const controlPath = [...parentPath, control.id];
32
+ return [
33
+ {
34
+ subReportControlId: control.id,
35
+ controlPath,
36
+ calculatedFields: control.subReportDefinition.calculatedFields ?? [],
37
+ detailFields: fields.detailFields,
38
+ },
39
+ ...describeChildren(control.subReportDefinition, fields, controlPath),
40
+ ];
41
+ }));
42
+ }
43
+ /** Creates an unconnected MCP adapter. Importing this module does not open files or transports. */
44
+ export function createReportMcpServer(options) {
45
+ // Handle tool execution
46
+ const execute = async (request, snapshot, storage, context) => {
47
+ // Keep the returned version tied to the data actually read or written by this request.
48
+ const repository = {
49
+ read: async (code) => {
50
+ const value = await storage.read(code);
51
+ snapshot.version = value.version;
52
+ return value;
53
+ },
54
+ write: async (code, document, version) => {
55
+ const parsed = validateReportDocument(document);
56
+ validateReportImages(parsed.report);
57
+ sanitizeValues(parsed.sampleData);
58
+ const value = await storage.write(code, parsed, version);
59
+ snapshot.version = value.version;
60
+ return value;
61
+ },
62
+ };
63
+ const { name, arguments: rawArgs } = request.params;
64
+ const { code: documentCode, requestId: _requestId, ...args } = rawArgs;
65
+ const code = documentCode;
66
+ const changed = await handleChangeTool(name, rawArgs, repository);
67
+ if (changed)
68
+ return changed;
69
+ if (name === 'reset_report_layout') {
70
+ if (args?.expectedVersion !== undefined && typeof args.expectedVersion !== 'string')
71
+ throw new Error('expectedVersion must be a string');
72
+ await repository.write(code, await options.initialDocument(code, context), args?.expectedVersion);
73
+ return {
74
+ content: [{ type: 'text', text: 'Report and data source reset.' }],
75
+ };
76
+ }
77
+ const current = await repository.read(code);
78
+ const { version: _version, mtime: _mtime, legacy: _legacy, ...currentDocument } = current;
79
+ if (args?.expectedVersion !== undefined) {
80
+ if (typeof args.expectedVersion !== 'string')
81
+ throw new Error('expectedVersion must be a string');
82
+ if (current.version !== args.expectedVersion)
83
+ throw new ReportConflictError();
84
+ }
85
+ let currentReport = current.report;
86
+ const source = sampleDataSource(current);
87
+ const saveCurrentReport = (report) => repository.write(code, {
88
+ formatVersion: 2,
89
+ report,
90
+ dataSource: current.dataSource,
91
+ sampleData: current.sampleData,
92
+ parameters: current.parameters,
93
+ }, current.version);
94
+ const formulaResult = await handleFormulaTool(name, args, currentReport, source, saveCurrentReport, currentDocument);
95
+ if (formulaResult !== undefined)
96
+ return {
97
+ content: [{ type: 'text', text: JSON.stringify(formulaResult) }],
98
+ };
99
+ switch (name) {
100
+ case 'get_report_layout': {
101
+ const { printableWidth } = getPageGeometry(currentReport.pageSettings);
102
+ return {
103
+ content: [
104
+ {
105
+ type: 'text',
106
+ text: JSON.stringify({
107
+ version: current.version,
108
+ pageInfo: {
109
+ size: currentReport.pageSettings.size,
110
+ orientation: currentReport.pageSettings.orientation,
111
+ margins: currentReport.pageSettings.margins,
112
+ printableWidth,
113
+ },
114
+ report: currentReport,
115
+ }, null, 2),
116
+ },
117
+ ],
118
+ };
119
+ }
120
+ case 'get_report_data_source':
121
+ return {
122
+ content: [
123
+ {
124
+ type: 'text',
125
+ text: JSON.stringify({
126
+ dataSource: source,
127
+ version: current.version,
128
+ }),
129
+ },
130
+ ],
131
+ };
132
+ case 'set_report_data_source': {
133
+ const dataSource = parseDataSource(args?.dataSource);
134
+ const report = args?.report === undefined ? currentReport : parseReport(args.report);
135
+ const saved = await repository.write(code, {
136
+ ...parseReportDocument({ formatVersion: 1, report, dataSource }),
137
+ parameters: current.parameters,
138
+ }, current.version);
139
+ return {
140
+ content: [
141
+ {
142
+ type: 'text',
143
+ text: JSON.stringify({
144
+ success: true,
145
+ version: saved.version,
146
+ rowCount: dataSource.data.items.length,
147
+ }),
148
+ },
149
+ ],
150
+ };
151
+ }
152
+ case 'get_available_data_fields': {
153
+ const fieldMeta = {
154
+ conditionalPrinting: {
155
+ visibleWhen: 'Boolean expression on bands or controls; null means hidden. Hidden bands collapse space. Hiding rows does not filter aggregate data.',
156
+ styleRules: 'Ordered matching rules merge; later rules win. Hidden controls skip style/content execution.',
157
+ stylesByControl: conditionalStylesByControl,
158
+ },
159
+ changeWorkflow: ['preflight_report', 'preview_report_changes', 'apply_report_changes'],
160
+ dataSourceId: source.id,
161
+ dataSourceName: source.name,
162
+ parameters: source.schema.parameters || [],
163
+ detailFields: source.schema.detailFields || [],
164
+ aggregateFormulas: getFormulaCatalog({ category: 'aggregate' }).functions,
165
+ formulaCatalogTool: 'get_formula_catalog',
166
+ calculatedFields: currentReport.calculatedFields ?? [],
167
+ calculatedReference: 'calc.<name>',
168
+ childCalculatedFields: describeChildren(currentReport, source.schema),
169
+ systemVariables: getFormulaCatalog().systemVariables,
170
+ sampleParameters: source.data.parameters,
171
+ sampleDetailRecord: source.data.items[0],
172
+ };
173
+ return {
174
+ content: [
175
+ {
176
+ type: 'text',
177
+ text: JSON.stringify(fieldMeta, null, 2),
178
+ },
179
+ ],
180
+ };
181
+ }
182
+ case 'add_control':
183
+ case 'update_control':
184
+ case 'delete_control':
185
+ case 'set_band_height':
186
+ case 'set_band_controls': {
187
+ const input = args;
188
+ if (!input || typeof input.bandId !== 'string')
189
+ throw new Error('bandId is required');
190
+ currentReport = updateReportScope(currentReport, (scope) => {
191
+ switch (name) {
192
+ case 'add_control': {
193
+ if (!input.control)
194
+ throw new Error('control is required');
195
+ const control = {
196
+ ...input.control,
197
+ id: input.control.id || `ctl-${crypto.randomUUID()}`,
198
+ };
199
+ return updateReportBand(scope, input.bandId, (band) => ({
200
+ ...band,
201
+ controls: [...band.controls, control],
202
+ }));
203
+ }
204
+ case 'update_control':
205
+ if (!input.patch || !input.controlId)
206
+ throw new Error('controlId and patch are required');
207
+ return patchControl(scope, input.bandId, input.controlId, input.patch);
208
+ case 'delete_control':
209
+ if (!input.controlId)
210
+ throw new Error('controlId is required');
211
+ return deleteControl(scope, input.bandId, input.controlId);
212
+ case 'set_band_height': {
213
+ if (typeof input.height !== 'number')
214
+ throw new Error('height is required');
215
+ const height = input.height;
216
+ return updateReportBand(scope, input.bandId, (band) => ({
217
+ ...band,
218
+ height,
219
+ }));
220
+ }
221
+ case 'set_band_controls': {
222
+ if (!Array.isArray(input.controls))
223
+ throw new Error('controls must be an array');
224
+ const controls = input.controls;
225
+ return updateReportBand(scope, input.bandId, (band) => ({
226
+ ...band,
227
+ controls,
228
+ }));
229
+ }
230
+ default:
231
+ return scope;
232
+ }
233
+ }, input.subReportControlId);
234
+ await saveCurrentReport(currentReport);
235
+ return {
236
+ content: [{ type: 'text', text: `${name} completed: ${input.bandId}` }],
237
+ };
238
+ }
239
+ case 'batch_update_controls': {
240
+ const updates = args?.updates;
241
+ if (!Array.isArray(updates) || updates.length === 0)
242
+ throw new Error('updates must be a nonempty array');
243
+ // Apply every patch in order and persist only when the whole batch succeeds.
244
+ for (const update of updates) {
245
+ if (!update.patch || !update.bandId || !update.controlId)
246
+ throw new Error('Invalid control update');
247
+ currentReport = updateReportScope(currentReport, (scope) => patchControl(scope, update.bandId, update.controlId, update.patch), update.subReportControlId);
248
+ }
249
+ await saveCurrentReport(currentReport);
250
+ return {
251
+ content: [
252
+ {
253
+ type: 'text',
254
+ text: `Updated ${updates.length} controls.`,
255
+ },
256
+ ],
257
+ };
258
+ }
259
+ case 'update_page_settings': {
260
+ const input = args;
261
+ currentReport = {
262
+ ...currentReport,
263
+ pageSettings: {
264
+ ...currentReport.pageSettings,
265
+ ...input,
266
+ margins: {
267
+ ...currentReport.pageSettings.margins,
268
+ ...input?.margins,
269
+ },
270
+ },
271
+ };
272
+ await saveCurrentReport(currentReport);
273
+ const { printableWidth } = getPageGeometry(currentReport.pageSettings);
274
+ return {
275
+ content: [
276
+ {
277
+ type: 'text',
278
+ text: `Page settings updated. Printable width: ${printableWidth.toFixed(1)} pt.`,
279
+ },
280
+ ],
281
+ };
282
+ }
283
+ case 'set_full_report': {
284
+ const report = parseReport(args?.report);
285
+ await saveCurrentReport(report);
286
+ return {
287
+ content: [
288
+ {
289
+ type: 'text',
290
+ text: `整份報表定義已成功替換,目前包含 ${report.bands.length} 個 Bands。`,
291
+ },
292
+ ],
293
+ };
294
+ }
295
+ case 'export_pdf': {
296
+ const { recordCount = source.data.items.length } = args;
297
+ if (!Number.isInteger(recordCount) || recordCount < 0 || recordCount > 10000)
298
+ throw new Error('recordCount must be an integer between 0 and 10000');
299
+ const pdfBuffer = await renderReportPdf({
300
+ document: currentDocument,
301
+ dataSource: {
302
+ ...source,
303
+ data: { ...source.data, items: source.data.items.slice(0, recordCount) },
304
+ },
305
+ }, options.pdf);
306
+ const reference = await options.publishArtifact({ code, mediaType: 'application/pdf', bytes: pdfBuffer, name: 'report.pdf' }, context);
307
+ return {
308
+ content: [{ type: 'text', text: JSON.stringify({ reference, bytes: pdfBuffer.length }) }],
309
+ };
310
+ }
311
+ case 'inspect_and_preview_layout': {
312
+ validateReportImages(currentReport);
313
+ sanitizeValues(source.data);
314
+ const inspection = inspectReportLayout(currentReport);
315
+ const pdfBuffer = await renderReportPdf({ document: currentDocument, dataSource: source }, options.pdf);
316
+ const svgContent = renderReportToSvg(currentReport, source.data.items, source.data.parameters);
317
+ const svgPath = JSON.stringify(await options.publishArtifact({
318
+ code,
319
+ mediaType: 'image/svg+xml',
320
+ bytes: new TextEncoder().encode(svgContent),
321
+ name: 'preview.svg',
322
+ }, context));
323
+ const pdfPath = JSON.stringify(await options.publishArtifact({ code, mediaType: 'application/pdf', bytes: pdfBuffer, name: 'preview.pdf' }, context));
324
+ const pdfStats = { size: pdfBuffer.length };
325
+ // 3. Construct structured diagnosis report
326
+ let reportText = `## 📊 報表排版幾何健檢與視覺快照\n\n`;
327
+ reportText += `- **總結判定**: ${inspection.isValid ? '✅ 通過 (無破版錯誤)' : '🚨 發現破版錯誤 (需調整控制項座標)'}\n`;
328
+ reportText += `- **紙張規格**: ${inspection.pageSize} (可繪製寬度: ${inspection.printableWidth.toFixed(1)} pt)\n`;
329
+ reportText += `- **結構規模**: ${inspection.totalBands} 個 Bands,共 ${inspection.totalControls} 個像素級控制項\n`;
330
+ reportText += `- **SVG 向量預覽圖**: \`${svgPath}\`\n`;
331
+ reportText += `- **即時 PDF 檔案**: \`${pdfPath}\` (${(pdfStats.size / 1024).toFixed(1)} KB)\n\n`;
332
+ if (inspection.diagnostics.length > 0) {
333
+ reportText += `### ⚠️ 幾何診斷問題清單 (${inspection.diagnostics.length} 項):\n`;
334
+ inspection.diagnostics.forEach((d, idx) => {
335
+ const icon = d.severity === 'error' ? '🚨 [錯誤]' : '⚠️ [警告]';
336
+ reportText += `${idx + 1}. ${icon} **[${d.category.toUpperCase()}]** (${d.bandType}): ${d.message}\n`;
337
+ });
338
+ reportText += '\n';
339
+ }
340
+ else {
341
+ reportText += `### ✨ 幾何診斷:完全零溢出、零重疊、表格欄位 100% 精準垂直對齊!\n\n`;
342
+ }
343
+ reportText += `### 🗺️ 當前版面區塊輪廓圖 (ASCII Wireframe):\n\`\`\`text\n${inspection.asciiWireframe}\n\`\`\`\n`;
344
+ return {
345
+ content: [
346
+ {
347
+ type: 'text',
348
+ text: reportText,
349
+ },
350
+ ],
351
+ };
352
+ }
353
+ default:
354
+ throw new Error(`未知的工具名稱: ${name}`);
355
+ }
356
+ };
357
+ const tools = reportTools.map((tool) => {
358
+ const mutates = mutatingReportTools.has(tool.name);
359
+ const requiredScopes = [
360
+ definitionPermission(options.kind, 'read'),
361
+ ...(mutates ? [definitionPermission(options.kind, 'write')] : []),
362
+ ];
363
+ return {
364
+ ...tool,
365
+ description: `${tool.description} ${options.userContentNotice ?? ''}`.trim(),
366
+ requiredScopes,
367
+ ...(mutates ? { mutates: true } : {}),
368
+ handler: async (raw, rawContext) => {
369
+ const snapshot = {};
370
+ const context = rawContext;
371
+ let result;
372
+ try {
373
+ if (!context?.actingUserId ||
374
+ !requiredScopes.every((scope) => context.scopes?.includes(scope)))
375
+ throw Object.assign(new Error('An acting user and the required scopes are required'), {
376
+ code: 'FORBIDDEN',
377
+ });
378
+ const args = tool.inputSchema.parse(raw);
379
+ const call = { name: tool.name, arguments: args };
380
+ const storage = typeof options.repository === 'function'
381
+ ? await options.repository(context, call)
382
+ : options.repository;
383
+ const replayed = mutates ? await storage.replay?.() : undefined;
384
+ result = replayed
385
+ ? toolReply({
386
+ success: true,
387
+ code: 'OK',
388
+ tool: tool.name,
389
+ version: replayed.version,
390
+ diagnostics: [],
391
+ data: { applied: true, replayed: true },
392
+ })
393
+ : normalizeToolReply(tool.name, await execute({ params: call }, snapshot, storage, context), snapshot.version);
394
+ }
395
+ catch (error) {
396
+ result = toolFailure(tool.name, error, snapshot.version);
397
+ }
398
+ return options.protectResult(result);
399
+ },
400
+ };
401
+ });
402
+ return {
403
+ tools,
404
+ registerInto(target) {
405
+ for (const tool of tools)
406
+ target.registerTool(tool);
407
+ },
408
+ };
409
+ }
410
+ //# sourceMappingURL=server.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,16 @@
1
+ import { McpServer } from '@modelcontextprotocol/server';
2
+ import type { ReportDocumentInput, ReportDocumentRepository } from '../types/document.js';
3
+ import type { ReportMcpCallContext, ReportMcpOptions } from './contracts.js';
4
+ export { StdioServerTransport } from '@modelcontextprotocol/server/stdio';
5
+ export { createDocumentRepository } from '../server/documentRepository.js';
6
+ /** Explicit code-to-file allowlist. Never interpret an agent's code as a path. */
7
+ export declare function createFileReportRepository(files: Record<string, {
8
+ path: string;
9
+ initialDocument: ReportDocumentInput;
10
+ }>): ReportDocumentRepository;
11
+ export declare function createDirectoryArtifactPublisher(directory: string): (artifact: Parameters<ReportMcpOptions["publishArtifact"]>[0]) => Promise<{
12
+ path: string;
13
+ }>;
14
+ /** SDK v2 transport boundary. Hosts normally register ./mcp tools in their own registry. */
15
+ export declare function createReportMcpTransportServer(options: ReportMcpOptions, context: ReportMcpCallContext): McpServer;
16
+ //# sourceMappingURL=stdio.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"stdio.d.ts","sourceRoot":"","sources":["../../src/mcp/stdio.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAEzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAC1F,OAAO,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAG7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAE3E,kFAAkF;AAClF,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,mBAAmB,CAAA;CAAE,CAAC,GAC5E,wBAAwB,CAmB1B;AAED,wBAAgB,gCAAgC,CAAC,SAAS,EAAE,MAAM,IAElD,UAAU,UAAU,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC;;GAS3E;AAED,4FAA4F;AAC5F,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,oBAAoB,aAe9B"}
@@ -0,0 +1,51 @@
1
+ import { randomUUID } from 'node:crypto';
2
+ import fs from 'node:fs';
3
+ import path from 'node:path';
4
+ import { McpServer } from '@modelcontextprotocol/server';
5
+ import { createDocumentRepository } from '../server/documentRepository.js';
6
+ import { createReportMcpServer } from './server.js';
7
+ export { StdioServerTransport } from '@modelcontextprotocol/server/stdio';
8
+ export { createDocumentRepository } from '../server/documentRepository.js';
9
+ /** Explicit code-to-file allowlist. Never interpret an agent's code as a path. */
10
+ export function createFileReportRepository(files) {
11
+ const repositories = new Map(Object.entries(files).map(([code, value]) => {
12
+ if (!path.isAbsolute(value.path))
13
+ throw new Error('An absolute report file path is required');
14
+ const repository = createDocumentRepository(value.path, value.initialDocument);
15
+ repository.initialize();
16
+ return [code, repository];
17
+ }));
18
+ const get = (code) => {
19
+ const value = repositories.get(code);
20
+ if (!value)
21
+ throw Object.assign(new Error('Report not found'), { code: 'DEFINITION_NOT_FOUND' });
22
+ return value;
23
+ };
24
+ return {
25
+ read: (code) => get(code).read(),
26
+ write: (code, document, expectedVersion) => get(code).write(document, expectedVersion),
27
+ };
28
+ }
29
+ export function createDirectoryArtifactPublisher(directory) {
30
+ if (!path.isAbsolute(directory))
31
+ throw new Error('An absolute artifact directory is required');
32
+ return async (artifact) => {
33
+ fs.mkdirSync(directory, { recursive: true });
34
+ const file = path.join(directory, `${randomUUID()}.${artifact.mediaType === 'application/pdf' ? 'pdf' : 'svg'}`);
35
+ fs.writeFileSync(file, artifact.bytes);
36
+ return { path: file };
37
+ };
38
+ }
39
+ /** SDK v2 transport boundary. Hosts normally register ./mcp tools in their own registry. */
40
+ export function createReportMcpTransportServer(options, context) {
41
+ const server = new McpServer({ name: 'report-engine-mcp', version: '2.0.0' });
42
+ for (const tool of createReportMcpServer(options).tools) {
43
+ server.registerTool(tool.name, {
44
+ description: tool.description,
45
+ inputSchema: tool.inputSchema,
46
+ annotations: { readOnlyHint: !tool.mutates, destructiveHint: !!tool.mutates },
47
+ }, async (args) => tool.handler(args, context));
48
+ }
49
+ return server;
50
+ }
51
+ //# sourceMappingURL=stdio.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"stdio.js","sourceRoot":"","sources":["../../src/mcp/stdio.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,11 @@
1
+ import { z } from 'zod';
2
+ export declare const mutatingReportTools: Set<string>;
3
+ export declare const reportTools: {
4
+ name: string;
5
+ description: string;
6
+ inputSchema: z.ZodIntersection<z.ZodObject<{
7
+ requestId?: z.ZodString | undefined;
8
+ code: z.ZodString;
9
+ }, z.core.$loose>, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
10
+ }[];
11
+ //# sourceMappingURL=tools.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAyUxB,eAAO,MAAM,mBAAmB,aAa9B,CAAC;AACH,eAAO,MAAM,WAAW;;;;;;;GA0BtB,CAAC"}