copperflow 0.4.0 → 0.4.2

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 (361) hide show
  1. package/README.md +21 -4
  2. package/dist/app/assets/NewPartDialog-PSXlbLR2.js +1 -0
  3. package/dist/app/assets/PackagesDialog-C8ZyWl-g.css +1 -0
  4. package/dist/app/assets/PackagesDialog-DmIT8b2D.js +2 -0
  5. package/dist/app/assets/{VerifyPartDialog-Ey6xpQ_U.js → VerifyPartDialog-KiW1nDnZ.js} +2 -2
  6. package/dist/app/assets/footprint-preview-oJ27yBAB.js +160 -0
  7. package/dist/app/assets/index-CArKmuM_.css +1 -0
  8. package/dist/app/assets/index-Yj6ATP2T.js +20 -0
  9. package/dist/app/assets/texture-worker-e8zKC6dv.js +1 -0
  10. package/dist/app/index.html +2 -2
  11. package/dist/cli-commands.d.ts +2 -0
  12. package/dist/cli-commands.js +45 -0
  13. package/dist/cli-commands.js.map +1 -1
  14. package/dist/cli-graphic.d.ts +9 -0
  15. package/dist/cli-graphic.js +62 -0
  16. package/dist/cli-graphic.js.map +1 -0
  17. package/dist/core/annotations.js +2 -2
  18. package/dist/core/annotations.js.map +1 -1
  19. package/dist/core/board-edits.d.ts +2 -0
  20. package/dist/core/board-edits.js +14 -0
  21. package/dist/core/board-edits.js.map +1 -1
  22. package/dist/core/board-graphic-edits.d.ts +8 -0
  23. package/dist/core/board-graphic-edits.js +88 -0
  24. package/dist/core/board-graphic-edits.js.map +1 -0
  25. package/dist/core/board-items.d.ts +6 -0
  26. package/dist/core/board-items.js +8 -3
  27. package/dist/core/board-items.js.map +1 -1
  28. package/dist/core/board-shape-edit.js +4 -2
  29. package/dist/core/board-shape-edit.js.map +1 -1
  30. package/dist/core/edit.js +17 -1
  31. package/dist/core/edit.js.map +1 -1
  32. package/dist/core/graphic-import.d.ts +43 -0
  33. package/dist/core/graphic-import.js +142 -0
  34. package/dist/core/graphic-import.js.map +1 -0
  35. package/dist/core/html-export.d.ts +37 -0
  36. package/dist/core/html-export.js +139 -0
  37. package/dist/core/html-export.js.map +1 -0
  38. package/dist/core/html-page.d.ts +39 -0
  39. package/dist/core/html-page.js +114 -0
  40. package/dist/core/html-page.js.map +1 -0
  41. package/dist/core/html-style.d.ts +3 -0
  42. package/dist/core/html-style.js +117 -0
  43. package/dist/core/html-style.js.map +1 -0
  44. package/dist/core/model-export.d.ts +33 -0
  45. package/dist/core/model-export.js +36 -0
  46. package/dist/core/model-export.js.map +1 -0
  47. package/dist/core/out-name.d.ts +5 -0
  48. package/dist/core/out-name.js +10 -0
  49. package/dist/core/out-name.js.map +1 -0
  50. package/dist/core/packages.d.ts +22 -0
  51. package/dist/core/packages.js +64 -0
  52. package/dist/core/packages.js.map +1 -0
  53. package/dist/core/pad-lines.d.ts +7 -0
  54. package/dist/core/pad-lines.js +15 -0
  55. package/dist/core/pad-lines.js.map +1 -0
  56. package/dist/core/pour-edits.d.ts +12 -1
  57. package/dist/core/pour-edits.js +6 -6
  58. package/dist/core/pour-edits.js.map +1 -1
  59. package/dist/core/render.d.ts +2 -1
  60. package/dist/core/render.js.map +1 -1
  61. package/dist/core/rules-patch.d.ts +17 -0
  62. package/dist/core/rules-patch.js +102 -0
  63. package/dist/core/rules-patch.js.map +1 -0
  64. package/dist/core/silk-text-edits.d.ts +8 -0
  65. package/dist/core/silk-text-edits.js +72 -0
  66. package/dist/core/silk-text-edits.js.map +1 -0
  67. package/dist/core/step-export.js +3 -0
  68. package/dist/core/step-export.js.map +1 -1
  69. package/dist/core/types.d.ts +55 -3
  70. package/dist/engine/board-graphic.d.ts +49 -0
  71. package/dist/engine/board-graphic.js +175 -0
  72. package/dist/engine/board-graphic.js.map +1 -0
  73. package/dist/engine/checks/copper-clearance.d.ts +1 -1
  74. package/dist/engine/checks/copper-clearance.js +19 -1
  75. package/dist/engine/checks/copper-clearance.js.map +1 -1
  76. package/dist/engine/checks/copper-pieces.d.ts +8 -2
  77. package/dist/engine/checks/copper-pieces.js +23 -2
  78. package/dist/engine/checks/copper-pieces.js.map +1 -1
  79. package/dist/engine/checks/drc-board-graphic.d.ts +10 -0
  80. package/dist/engine/checks/drc-board-graphic.js +95 -0
  81. package/dist/engine/checks/drc-board-graphic.js.map +1 -0
  82. package/dist/engine/checks/drc-parts.js +3 -1
  83. package/dist/engine/checks/drc-parts.js.map +1 -1
  84. package/dist/engine/checks/drc-pours.js +3 -3
  85. package/dist/engine/checks/drc-pours.js.map +1 -1
  86. package/dist/engine/checks/drc-silk-text.d.ts +15 -0
  87. package/dist/engine/checks/drc-silk-text.js +65 -0
  88. package/dist/engine/checks/drc-silk-text.js.map +1 -0
  89. package/dist/engine/checks/fill-point.d.ts +7 -0
  90. package/dist/engine/checks/fill-point.js +58 -0
  91. package/dist/engine/checks/fill-point.js.map +1 -0
  92. package/dist/engine/checks/stranded-copper.d.ts +14 -0
  93. package/dist/engine/checks/stranded-copper.js +43 -0
  94. package/dist/engine/checks/stranded-copper.js.map +1 -0
  95. package/dist/engine/design.js +1 -1
  96. package/dist/engine/design.js.map +1 -1
  97. package/dist/engine/elaborate.d.ts +2 -0
  98. package/dist/engine/elaborate.js +30 -1
  99. package/dist/engine/elaborate.js.map +1 -1
  100. package/dist/engine/engine.d.ts +4 -1
  101. package/dist/engine/engine.js +5 -2
  102. package/dist/engine/engine.js.map +1 -1
  103. package/dist/engine/fab/graphic-objects.d.ts +7 -0
  104. package/dist/engine/fab/graphic-objects.js +24 -0
  105. package/dist/engine/fab/graphic-objects.js.map +1 -0
  106. package/dist/engine/fab/layers.d.ts +9 -0
  107. package/dist/engine/fab/layers.js +60 -8
  108. package/dist/engine/fab/layers.js.map +1 -1
  109. package/dist/engine/fab/silk-text-strokes.d.ts +16 -0
  110. package/dist/engine/fab/silk-text-strokes.js +28 -0
  111. package/dist/engine/fab/silk-text-strokes.js.map +1 -0
  112. package/dist/engine/fab/stroke-font.d.ts +4 -0
  113. package/dist/engine/fab/stroke-font.js +38 -1
  114. package/dist/engine/fab/stroke-font.js.map +1 -1
  115. package/dist/engine/footprints/array.d.ts +4 -0
  116. package/dist/engine/footprints/array.js +51 -0
  117. package/dist/engine/footprints/array.js.map +1 -0
  118. package/dist/engine/footprints/axial.d.ts +6 -0
  119. package/dist/engine/footprints/axial.js +115 -0
  120. package/dist/engine/footprints/axial.js.map +1 -0
  121. package/dist/engine/footprints/catalogue.d.ts +39 -0
  122. package/dist/engine/footprints/catalogue.js +284 -0
  123. package/dist/engine/footprints/catalogue.js.map +1 -0
  124. package/dist/engine/footprints/chip.js +10 -1
  125. package/dist/engine/footprints/chip.js.map +1 -1
  126. package/dist/engine/footprints/connector.d.ts +16 -0
  127. package/dist/engine/footprints/connector.js +31 -0
  128. package/dist/engine/footprints/connector.js.map +1 -0
  129. package/dist/engine/footprints/dcjack.d.ts +3 -0
  130. package/dist/engine/footprints/dcjack.js +46 -0
  131. package/dist/engine/footprints/dcjack.js.map +1 -0
  132. package/dist/engine/footprints/dpak.d.ts +7 -0
  133. package/dist/engine/footprints/dpak.js +172 -0
  134. package/dist/engine/footprints/dpak.js.map +1 -0
  135. package/dist/engine/footprints/dual.d.ts +11 -2
  136. package/dist/engine/footprints/dual.js +113 -12
  137. package/dist/engine/footprints/dual.js.map +1 -1
  138. package/dist/engine/footprints/index.js +46 -3
  139. package/dist/engine/footprints/index.js.map +1 -1
  140. package/dist/engine/footprints/inductor.d.ts +3 -0
  141. package/dist/engine/footprints/inductor.js +32 -0
  142. package/dist/engine/footprints/inductor.js.map +1 -0
  143. package/dist/engine/footprints/known.js +114 -14
  144. package/dist/engine/footprints/known.js.map +1 -1
  145. package/dist/engine/footprints/ledsmd.d.ts +3 -0
  146. package/dist/engine/footprints/ledsmd.js +52 -0
  147. package/dist/engine/footprints/ledsmd.js.map +1 -0
  148. package/dist/engine/footprints/ledth.d.ts +4 -0
  149. package/dist/engine/footprints/ledth.js +45 -0
  150. package/dist/engine/footprints/ledth.js.map +1 -0
  151. package/dist/engine/footprints/melf.d.ts +8 -0
  152. package/dist/engine/footprints/melf.js +56 -0
  153. package/dist/engine/footprints/melf.js.map +1 -0
  154. package/dist/engine/footprints/pad-roles.d.ts +4 -0
  155. package/dist/engine/footprints/pad-roles.js +32 -0
  156. package/dist/engine/footprints/pad-roles.js.map +1 -0
  157. package/dist/engine/footprints/plcc.d.ts +4 -0
  158. package/dist/engine/footprints/plcc.js +117 -0
  159. package/dist/engine/footprints/plcc.js.map +1 -0
  160. package/dist/engine/footprints/resonator.d.ts +3 -0
  161. package/dist/engine/footprints/resonator.js +33 -0
  162. package/dist/engine/footprints/resonator.js.map +1 -0
  163. package/dist/engine/footprints/screw.d.ts +3 -0
  164. package/dist/engine/footprints/screw.js +51 -0
  165. package/dist/engine/footprints/screw.js.map +1 -0
  166. package/dist/engine/footprints/smallsot.d.ts +8 -0
  167. package/dist/engine/footprints/smallsot.js +143 -0
  168. package/dist/engine/footprints/smallsot.js.map +1 -0
  169. package/dist/engine/footprints/smdbox.d.ts +33 -0
  170. package/dist/engine/footprints/smdbox.js +76 -0
  171. package/dist/engine/footprints/smdbox.js.map +1 -0
  172. package/dist/engine/footprints/smdcan.d.ts +3 -0
  173. package/dist/engine/footprints/smdcan.js +61 -0
  174. package/dist/engine/footprints/smdcan.js.map +1 -0
  175. package/dist/engine/footprints/smdip.d.ts +4 -0
  176. package/dist/engine/footprints/smdip.js +58 -0
  177. package/dist/engine/footprints/smdip.js.map +1 -0
  178. package/dist/engine/footprints/socket.d.ts +8 -0
  179. package/dist/engine/footprints/socket.js +21 -0
  180. package/dist/engine/footprints/socket.js.map +1 -0
  181. package/dist/engine/footprints/sod.d.ts +6 -0
  182. package/dist/engine/footprints/sod.js +63 -6
  183. package/dist/engine/footprints/sod.js.map +1 -1
  184. package/dist/engine/footprints/sot.d.ts +1 -1
  185. package/dist/engine/footprints/sot.js +17 -2
  186. package/dist/engine/footprints/sot.js.map +1 -1
  187. package/dist/engine/footprints/tact.d.ts +3 -0
  188. package/dist/engine/footprints/tact.js +65 -0
  189. package/dist/engine/footprints/tact.js.map +1 -0
  190. package/dist/engine/footprints/tantalum.d.ts +7 -0
  191. package/dist/engine/footprints/tantalum.js +91 -0
  192. package/dist/engine/footprints/tantalum.js.map +1 -0
  193. package/dist/engine/footprints/to92inline.d.ts +14 -0
  194. package/dist/engine/footprints/to92inline.js +21 -0
  195. package/dist/engine/footprints/to92inline.js.map +1 -0
  196. package/dist/engine/footprints/topower.d.ts +7 -0
  197. package/dist/engine/footprints/topower.js +119 -0
  198. package/dist/engine/footprints/topower.js.map +1 -0
  199. package/dist/engine/footprints/usb.d.ts +32 -0
  200. package/dist/engine/footprints/usb.js +109 -0
  201. package/dist/engine/footprints/usb.js.map +1 -0
  202. package/dist/engine/footprints/xtal.d.ts +4 -0
  203. package/dist/engine/footprints/xtal.js +61 -0
  204. package/dist/engine/footprints/xtal.js.map +1 -0
  205. package/dist/engine/graphic-place.d.ts +34 -0
  206. package/dist/engine/graphic-place.js +132 -0
  207. package/dist/engine/graphic-place.js.map +1 -0
  208. package/dist/engine/graphics/curves.d.ts +18 -0
  209. package/dist/engine/graphics/curves.js +75 -0
  210. package/dist/engine/graphics/curves.js.map +1 -0
  211. package/dist/engine/graphics/dxf-entities.d.ts +20 -0
  212. package/dist/engine/graphics/dxf-entities.js +184 -0
  213. package/dist/engine/graphics/dxf-entities.js.map +1 -0
  214. package/dist/engine/graphics/dxf-pairs.d.ts +22 -0
  215. package/dist/engine/graphics/dxf-pairs.js +77 -0
  216. package/dist/engine/graphics/dxf-pairs.js.map +1 -0
  217. package/dist/engine/graphics/dxf.d.ts +5 -0
  218. package/dist/engine/graphics/dxf.js +110 -0
  219. package/dist/engine/graphics/dxf.js.map +1 -0
  220. package/dist/engine/graphics/index.d.ts +9 -0
  221. package/dist/engine/graphics/index.js +30 -0
  222. package/dist/engine/graphics/index.js.map +1 -0
  223. package/dist/engine/graphics/path-data.d.ts +12 -0
  224. package/dist/engine/graphics/path-data.js +162 -0
  225. package/dist/engine/graphics/path-data.js.map +1 -0
  226. package/dist/engine/graphics/rings.d.ts +7 -0
  227. package/dist/engine/graphics/rings.js +93 -0
  228. package/dist/engine/graphics/rings.js.map +1 -0
  229. package/dist/engine/graphics/shapes.d.ts +47 -0
  230. package/dist/engine/graphics/shapes.js +85 -0
  231. package/dist/engine/graphics/shapes.js.map +1 -0
  232. package/dist/engine/graphics/svg-attributes.d.ts +26 -0
  233. package/dist/engine/graphics/svg-attributes.js +116 -0
  234. package/dist/engine/graphics/svg-attributes.js.map +1 -0
  235. package/dist/engine/graphics/svg.d.ts +5 -0
  236. package/dist/engine/graphics/svg.js +118 -0
  237. package/dist/engine/graphics/svg.js.map +1 -0
  238. package/dist/engine/graphics/transform.d.ts +21 -0
  239. package/dist/engine/graphics/transform.js +88 -0
  240. package/dist/engine/graphics/transform.js.map +1 -0
  241. package/dist/engine/graphics/xml.d.ts +10 -0
  242. package/dist/engine/graphics/xml.js +130 -0
  243. package/dist/engine/graphics/xml.js.map +1 -0
  244. package/dist/engine/model.d.ts +55 -0
  245. package/dist/engine/model.js.map +1 -1
  246. package/dist/engine/pcb-place/grow.d.ts +12 -0
  247. package/dist/engine/pcb-place/grow.js +100 -0
  248. package/dist/engine/pcb-place/grow.js.map +1 -0
  249. package/dist/engine/pcb.d.ts +5 -1
  250. package/dist/engine/pcb.js +2 -0
  251. package/dist/engine/pcb.js.map +1 -1
  252. package/dist/engine/pour/cache.js +1 -0
  253. package/dist/engine/pour/cache.js.map +1 -1
  254. package/dist/engine/pour/obstacles.js +18 -1
  255. package/dist/engine/pour/obstacles.js.map +1 -1
  256. package/dist/engine/router/route-board.d.ts +2 -0
  257. package/dist/engine/router/route-board.js +7 -2
  258. package/dist/engine/router/route-board.js.map +1 -1
  259. package/dist/engine/router/unplaced.d.ts +18 -0
  260. package/dist/engine/router/unplaced.js +27 -0
  261. package/dist/engine/router/unplaced.js.map +1 -0
  262. package/dist/engine/rules/rotations.d.ts +12 -3
  263. package/dist/engine/rules/rotations.js +77 -2
  264. package/dist/engine/rules/rotations.js.map +1 -1
  265. package/dist/engine/silk-text.d.ts +40 -0
  266. package/dist/engine/silk-text.js +85 -0
  267. package/dist/engine/silk-text.js.map +1 -0
  268. package/dist/engine/solid/heights-smd.d.ts +3 -0
  269. package/dist/engine/solid/heights-smd.js +81 -0
  270. package/dist/engine/solid/heights-smd.js.map +1 -0
  271. package/dist/engine/solid/heights-through.d.ts +7 -0
  272. package/dist/engine/solid/heights-through.js +93 -0
  273. package/dist/engine/solid/heights-through.js.map +1 -0
  274. package/dist/engine/solid/heights-uno.d.ts +2 -0
  275. package/dist/engine/solid/heights-uno.js +15 -0
  276. package/dist/engine/solid/heights-uno.js.map +1 -0
  277. package/dist/engine/solid/heights.d.ts +2 -0
  278. package/dist/engine/solid/heights.js +43 -18
  279. package/dist/engine/solid/heights.js.map +1 -1
  280. package/dist/library/attach-datasheet.d.ts +2 -0
  281. package/dist/library/attach-datasheet.js +1 -1
  282. package/dist/library/attach-datasheet.js.map +1 -1
  283. package/dist/library/part-fields.d.ts +23 -0
  284. package/dist/library/part-fields.js +55 -0
  285. package/dist/library/part-fields.js.map +1 -0
  286. package/dist/mcp/batch-steps.d.ts +33 -0
  287. package/dist/mcp/batch-steps.js +211 -0
  288. package/dist/mcp/batch-steps.js.map +1 -0
  289. package/dist/mcp/batch.d.ts +16 -0
  290. package/dist/mcp/batch.js +18 -5
  291. package/dist/mcp/batch.js.map +1 -1
  292. package/dist/mcp/board-import-tool.d.ts +1 -1
  293. package/dist/mcp/board-import-tool.js +1 -1
  294. package/dist/mcp/board-import-tool.js.map +1 -1
  295. package/dist/mcp/board-summary.d.ts +1 -1
  296. package/dist/mcp/board-summary.js +32 -1
  297. package/dist/mcp/board-summary.js.map +1 -1
  298. package/dist/mcp/board-tool.d.ts +36 -0
  299. package/dist/mcp/board-tool.js +109 -0
  300. package/dist/mcp/board-tool.js.map +1 -0
  301. package/dist/mcp/copper-summary.d.ts +2 -0
  302. package/dist/mcp/copper-summary.js +10 -2
  303. package/dist/mcp/copper-summary.js.map +1 -1
  304. package/dist/mcp/copper-tools.d.ts +1 -1
  305. package/dist/mcp/copper-tools.js +1 -1
  306. package/dist/mcp/copper-tools.js.map +1 -1
  307. package/dist/mcp/create-part.js +2 -2
  308. package/dist/mcp/create-part.js.map +1 -1
  309. package/dist/mcp/graphic-tool.d.ts +34 -0
  310. package/dist/mcp/graphic-tool.js +29 -0
  311. package/dist/mcp/graphic-tool.js.map +1 -0
  312. package/dist/mcp/guide.d.ts +3 -1
  313. package/dist/mcp/guide.js +15 -4
  314. package/dist/mcp/guide.js.map +1 -1
  315. package/dist/mcp/html-tool.d.ts +28 -0
  316. package/dist/mcp/html-tool.js +21 -0
  317. package/dist/mcp/html-tool.js.map +1 -0
  318. package/dist/mcp/model-tool.d.ts +31 -0
  319. package/dist/mcp/model-tool.js +27 -0
  320. package/dist/mcp/model-tool.js.map +1 -0
  321. package/dist/mcp/new-circuit.d.ts +1 -1
  322. package/dist/mcp/new-circuit.js +10 -11
  323. package/dist/mcp/new-circuit.js.map +1 -1
  324. package/dist/mcp/part-tools.d.ts +20 -0
  325. package/dist/mcp/part-tools.js +40 -0
  326. package/dist/mcp/part-tools.js.map +1 -0
  327. package/dist/mcp/place-tools.d.ts +1 -1
  328. package/dist/mcp/place-tools.js +11 -5
  329. package/dist/mcp/place-tools.js.map +1 -1
  330. package/dist/mcp/project-tools.js +2 -0
  331. package/dist/mcp/project-tools.js.map +1 -1
  332. package/dist/mcp/render-tool.d.ts +2 -0
  333. package/dist/mcp/render-tool.js +32 -1
  334. package/dist/mcp/render-tool.js.map +1 -1
  335. package/dist/mcp/route-tools.d.ts +1 -1
  336. package/dist/mcp/route-tools.js +3 -1
  337. package/dist/mcp/route-tools.js.map +1 -1
  338. package/dist/mcp/rules-tool.d.ts +19 -0
  339. package/dist/mcp/rules-tool.js +73 -0
  340. package/dist/mcp/rules-tool.js.map +1 -0
  341. package/dist/mcp/server.js +53 -17
  342. package/dist/mcp/server.js.map +1 -1
  343. package/dist/mcp/text-tool.d.ts +34 -0
  344. package/dist/mcp/text-tool.js +37 -0
  345. package/dist/mcp/text-tool.js.map +1 -0
  346. package/dist/render/render.js +2335 -389
  347. package/dist/studio/server.js +32 -0
  348. package/dist/studio/server.js.map +1 -1
  349. package/dist/version.d.ts +1 -1
  350. package/dist/version.js +1 -1
  351. package/package.json +2 -1
  352. package/skills/copperflow/SKILL.md +8 -8
  353. package/skills/copperflow/references/copper.md +9 -1
  354. package/skills/copperflow/references/design-rules.md +36 -7
  355. package/skills/copperflow/references/editable-subset.md +18 -8
  356. package/skills/copperflow/references/parts-library.md +19 -1
  357. package/skills/copperflow/references/writing-circuits.md +71 -0
  358. package/dist/app/assets/NewPartDialog-BBJaZFCo.js +0 -160
  359. package/dist/app/assets/index-BKoIKo22.css +0 -1
  360. package/dist/app/assets/index-DPmr2dR1.js +0 -20
  361. package/dist/app/assets/texture-worker-CyI_g_XZ.js +0 -1
@@ -0,0 +1,142 @@
1
+ // Import a drawing: an SVG or DXF file placed on the board as a `<boardgraphic>`. The file is kept in the project's
2
+ // graphics/ folder (copied there when it is elsewhere in the project, or written there when the Studio sends the file
3
+ // a person picked), then the element is written as one history entry. The agent's import_graphic, the CLI's
4
+ // `copperflow graphic` and the Studio's File → Import a drawing all call importGraphic and show formatGraphicImport.
5
+ import { lstat, mkdir, readFile, realpath, rm } from "node:fs/promises";
6
+ import { basename, dirname, resolve } from "node:path";
7
+ import { GRAPHIC_FILE, graphicLayerProblem, leftOut, graphicScaleProblem, graphicWidthProblem, MAX_GRAPHIC_SIZE } from "../engine/board-graphic.js";
8
+ import { graphicKind, parseGraphic } from "../engine/graphics/index.js";
9
+ import { newBoardItemId } from "./board-items.js";
10
+ import { EditError } from "./edit-error.js";
11
+ import { applyEdits } from "./edit.js";
12
+ import { isInside } from "./file-writes.js";
13
+ import { writeFileAtomic } from "./fs-utils.js";
14
+ import { editCircuit, loadCircuit, projectPath, resolveInRoot } from "./workspace.js";
15
+ /** The most numbered names tried for a file whose name is taken by a different drawing. */
16
+ const MAX_RENAMES = 100;
17
+ /** The largest drawing file read, in bytes. */
18
+ export const MAX_GRAPHIC_FILE_BYTES = 4 * 1024 * 1024;
19
+ /** The real path of a project file, refused when it is missing, not a plain file, too large, or (through a link) outside the project. */
20
+ async function realSource(root, source) {
21
+ const path = resolveInRoot(root, source);
22
+ const missing = () => new EditError("not_found", `There is no file ${source} in the project folder; write the drawing there first`);
23
+ const found = await lstat(path).catch((error) => {
24
+ if (error.code === "ENOENT")
25
+ throw missing();
26
+ throw error;
27
+ });
28
+ const real = await realpath(path);
29
+ if (!isInside(await realpath(resolve(root)), real))
30
+ throw new EditError("invalid", `${source} leads outside the project folder; copy the drawing into the project`);
31
+ const target = found.isSymbolicLink() ? await lstat(real) : found;
32
+ if (!target.isFile())
33
+ throw new EditError("invalid", `${source} is not a file; give the path of an .svg or .dxf file`);
34
+ if (target.size > MAX_GRAPHIC_FILE_BYTES)
35
+ throw new EditError("invalid", `${source} is larger than ${MAX_GRAPHIC_FILE_BYTES / 1024 / 1024} MB; simplify the drawing`);
36
+ return real;
37
+ }
38
+ async function sourceText(root, source) {
39
+ if (typeof source !== "string")
40
+ return source;
41
+ const inProject = projectPath(root, source);
42
+ return { name: inProject, text: await readFile(await realSource(root, source), "utf8"), inProject };
43
+ }
44
+ const readIfThere = (path) => readFile(path, "utf8").catch(() => undefined);
45
+ /** Where the drawing is kept: where it is when already in graphics/, else graphics/<its name>, numbered when that holds another drawing. */
46
+ async function keptAt(root, drawing) {
47
+ if (drawing.inProject !== undefined && GRAPHIC_FILE.test(drawing.inProject))
48
+ return drawing.inProject;
49
+ const clean = basename(drawing.name.replaceAll("\\", "/")).replace(/[^A-Za-z0-9._ -]/g, "-");
50
+ const dot = clean.lastIndexOf(".");
51
+ const [stem, ext] = [clean.slice(0, dot) || "drawing", clean.slice(dot).toLowerCase()];
52
+ for (let n = 1; n <= MAX_RENAMES; n++) {
53
+ const candidate = `graphics/${stem}${n === 1 ? "" : `-${n}`}${ext}`;
54
+ const there = await readIfThere(resolveInRoot(root, candidate));
55
+ if (there === undefined || there === drawing.text)
56
+ return candidate;
57
+ }
58
+ throw new EditError("invalid", `graphics/ already holds ${MAX_RENAMES} drawings named ${stem}; rename the file`);
59
+ }
60
+ /** Refuses what the build would leave out, before anything is written. */
61
+ function checkOptions(options, shapes) {
62
+ const problem = graphicLayerProblem(options.layer) ??
63
+ (options.width !== undefined && options.scale !== undefined ? "give width or scale, not both" : undefined) ??
64
+ (options.width === undefined ? undefined : graphicWidthProblem(options.width)) ??
65
+ (options.scale === undefined ? undefined : graphicScaleProblem(options.scale));
66
+ if (problem)
67
+ throw new EditError("invalid", `${problem}. Nothing was written.`);
68
+ const scale = options.scale ?? (options.width === undefined ? 1 : options.width / shapes.width);
69
+ if (Math.max(shapes.width, shapes.height) * scale > MAX_GRAPHIC_SIZE) {
70
+ throw new EditError("invalid", `At this size the drawing is ${(shapes.width * scale).toFixed(1)} x ${(shapes.height * scale).toFixed(1)} mm, larger than ${MAX_GRAPHIC_SIZE} mm; give a width. Nothing was written.`);
71
+ }
72
+ return scale;
73
+ }
74
+ /** Writes the drawing to graphics/ when it is not there yet; true when this call created it. */
75
+ async function keepFile(root, kept, text) {
76
+ const path = resolveInRoot(root, kept);
77
+ if ((await readIfThere(path)) !== undefined)
78
+ return false;
79
+ await mkdir(dirname(path), { recursive: true });
80
+ await writeFileAtomic(path, text);
81
+ return true;
82
+ }
83
+ /** Reads the drawing, keeps it in graphics/ and writes the `<boardgraphic>` placing it, as one history entry. */
84
+ export async function importGraphic(root, file, options, meta) {
85
+ const drawing = await sourceText(root, options.source);
86
+ const kind = graphicKind(drawing.name);
87
+ if (!kind)
88
+ throw new EditError("invalid", `${basename(drawing.name)} is not a drawing: give an .svg or .dxf file`);
89
+ const shapes = parseGraphic(drawing.text, kind);
90
+ if ("error" in shapes)
91
+ throw new EditError("invalid", `${basename(drawing.name)}: ${shapes.error}. Nothing was written.`);
92
+ if (shapes.fills.length === 0 && shapes.strokes.length === 0)
93
+ throw new EditError("invalid", `${basename(drawing.name)}: the drawing has nothing to draw${leftOut(shapes.skipped)}. Nothing was written.`);
94
+ const scale = checkOptions(options, shapes);
95
+ const loaded = await loadCircuit(root, file);
96
+ const box = loaded.model.boardBox;
97
+ const at = { x: options.x ?? (box ? (box.minX + box.maxX) / 2 : 0), y: options.y ?? (box ? (box.minY + box.maxY) / 2 : 0) };
98
+ const kept = await keptAt(root, drawing);
99
+ const id = newBoardItemId(loaded.model.boardItems ?? [], "boardgraphic");
100
+ const edit = {
101
+ kind: "addBoardGraphic",
102
+ file: kept,
103
+ layer: options.layer,
104
+ ...at,
105
+ ...(options.width === undefined ? {} : { width: options.width }),
106
+ ...(options.scale === undefined ? {} : { scale: options.scale }),
107
+ ...(options.rotation === undefined ? {} : { rotation: options.rotation }),
108
+ ...(options.fill === undefined ? {} : { fill: options.fill }),
109
+ ...(options.name === undefined ? {} : { name: options.name }),
110
+ };
111
+ // Every refusal the edit itself makes (a centre off the board, a bad prop) comes before the drawing is copied.
112
+ const locked = new Set(loaded.annotations.locks.map((lock) => lock.part));
113
+ try {
114
+ applyEdits(loaded.source, [edit], locked);
115
+ }
116
+ catch (error) {
117
+ throw new EditError("invalid", `${error.message.replace(/\.$/, "")}. Nothing was written.`);
118
+ }
119
+ const created = await keepFile(root, kept, drawing.text);
120
+ const result = await editCircuit(root, loaded.file, [edit], { author: meta.author, summary: `add ${id} from ${kept} on the ${options.layer}`, ...(meta.engine ? { engine: meta.engine } : {}) }).catch(async (error) => {
121
+ if (created)
122
+ await rm(resolveInRoot(root, kept), { force: true });
123
+ throw error;
124
+ });
125
+ return { entry: result.entry, id, file: kept, layer: options.layer, at, size: { width: shapes.width * scale, height: shapes.height * scale }, skipped: shapes.skipped };
126
+ }
127
+ const mm = (n) => String(Math.round(n * 1e3) / 1e3);
128
+ /** The answer's lines: what was placed, where and how large, and what the reader left out. */
129
+ export function formatGraphicImport(result) {
130
+ const lines = [
131
+ `Change ${result.entry.id}: ${result.id} from ${result.file} on the ${result.layer}, ${mm(result.size.width)} x ${mm(result.size.height)} mm, centred at (${mm(result.at.x)}, ${mm(result.at.y)})`,
132
+ ];
133
+ lines.push(result.skipped.length === 0 ? "Nothing in the file was left out." : `Left out of the file: ${result.skipped.join("; ")}`);
134
+ lines.push(`The drawing is kept as ${result.file}; it stays there if the change is undone.`);
135
+ if (["top", "bottom", "inner1", "inner2"].includes(result.layer)) {
136
+ lines.push("On copper it belongs to no net: every net keeps clear of it. Its lines are checked against the minimum track width; thin parts of its filled shapes are not.");
137
+ }
138
+ lines.push("Colour is not read: every filled shape is ink (or an opening); white details over black come out solid unless drawn as holes in one path.");
139
+ lines.push(`Move, resize or remove it with edit_circuit set_drawing / remove_drawing { "id": "${result.id}" }.`);
140
+ return lines;
141
+ }
142
+ //# sourceMappingURL=graphic-import.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"graphic-import.js","sourceRoot":"","sources":["../../src/core/graphic-import.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,37 @@
1
+ import { type CanvasLoader } from "../engine/fab/picture/png.js";
2
+ import { type LookRequest } from "../engine/fab/picture/looks.js";
3
+ import { type DesignSource } from "./design-source.js";
4
+ import { type Renderer } from "./render.js";
5
+ /** Picture widths in pixels: wide enough to read on a laptop and to print. */
6
+ export declare const SHEET_WIDTH = 1600;
7
+ export declare const MODEL_WIDTH = 1200;
8
+ export interface HtmlOptions {
9
+ engine?: DesignSource;
10
+ /** A project path ending in .html; `<name>.html` beside the circuit when left out. */
11
+ out?: string;
12
+ look?: LookRequest;
13
+ /** The day the page names and the fabrication files carry; the same date gives the same bytes. Now when left out. */
14
+ date?: Date;
15
+ /** Loads the renderer; tests pass the source module. Without it the bundled dist/render/render.js is loaded. */
16
+ renderer?: () => Promise<Renderer>;
17
+ canvas?: CanvasLoader;
18
+ }
19
+ export interface HtmlExport {
20
+ /** The file written, relative to the project root with "/" between folders. */
21
+ file: string;
22
+ bytes: number;
23
+ /** What the page holds, in one line. */
24
+ what: string;
25
+ /** The sizes of the embedded parts, in bytes. */
26
+ split: {
27
+ pictures: number;
28
+ zip: number;
29
+ glb: number;
30
+ step: number;
31
+ };
32
+ }
33
+ export { refuseStreamName } from "./out-name.js";
34
+ /** Builds the circuit and writes its web page to `out` or beside the circuit. */
35
+ export declare function exportHtml(root: string, file: string, options?: HtmlOptions): Promise<HtmlExport>;
36
+ /** "Wrote io-8.html (2100 kB): the design as one page: ..." and what opens it. */
37
+ export declare function formatHtmlExport(result: HtmlExport): string;
@@ -0,0 +1,139 @@
1
+ // Writes a circuit's design as one web page (copperflow html, export_html): every schematic page, the board, the 3D
2
+ // view and the bill of materials, with the fabrication files, the 3D models and the BOM inside it as downloads.
3
+ // `<name>.html` beside the circuit, or the project file given. A design with errors is still written, since the page
4
+ // is a look at the design, not an order; it then carries no fabrication files and says why.
5
+ import { refuseStreamName } from "./out-name.js";
6
+ import { mkdir } from "node:fs/promises";
7
+ import { writeFileAtomic } from "./fs-utils.js";
8
+ import { dirname, join, relative, sep } from "node:path";
9
+ import { fabricationSet, withPictures } from "../engine/fab/export.js";
10
+ import { designName } from "../engine/fab/names.js";
11
+ import { exportPictures } from "../engine/fab/picture/png.js";
12
+ import { resolveLook } from "../engine/fab/picture/looks.js";
13
+ import { MAIN_PAGE } from "../engine/model.js";
14
+ import { solidModel } from "../engine/solid/model.js";
15
+ import { stepText } from "../engine/solid/step.js";
16
+ import { VERSION } from "../version.js";
17
+ import { buildBom, formatBomCsv } from "./bom.js";
18
+ import { buildWith } from "./design-source.js";
19
+ import { assertLandsInProject } from "./fabrication.js";
20
+ import { inProjectQueue } from "./file-writes.js";
21
+ import { htmlPage } from "./html-page.js";
22
+ import { orderReportLines } from "./order-report.js";
23
+ import { renderCircuit } from "./render.js";
24
+ import { resolveCircuit, resolveInRoot } from "./workspace.js";
25
+ /** Picture widths in pixels: wide enough to read on a laptop and to print. */
26
+ export const SHEET_WIDTH = 1600;
27
+ export const MODEL_WIDTH = 1200;
28
+ const ANGLES = ["iso", "top", "bottom"];
29
+ /** The tab each 3D view gets on the page. */
30
+ const ANGLE_TITLES = { iso: "From an angle", top: "From above", bottom: "From below" };
31
+ /** How many of the export's reasons the page names when it carries no fabrication files. */
32
+ const REASONS_SHOWN = 3;
33
+ const REPORT_PREFIXES = ["Board:", "Ready for ", "Not verified:"];
34
+ function drawer(root, circuit, design, options) {
35
+ const renderOptions = { design, ...(options.renderer ? { renderer: options.renderer } : {}), ...(options.canvas ? { canvas: options.canvas } : {}) };
36
+ return async (request) => {
37
+ const rendered = await renderCircuit(root, circuit, request, renderOptions);
38
+ return { png: rendered.png, width: rendered.width, height: rendered.height, alt: rendered.what };
39
+ };
40
+ }
41
+ const pageNames = (design) => {
42
+ const pages = design.schematic.pages?.map((page) => page.name) ?? [];
43
+ return pages.length > 0 ? pages : [MAIN_PAGE];
44
+ };
45
+ async function pictures(draw, design, look) {
46
+ const schematic = [];
47
+ for (const page of pageNames(design))
48
+ schematic.push({ page, picture: await draw({ view: "schematic", page, width: SHEET_WIDTH }) });
49
+ const board = [
50
+ { ...(await draw({ view: "pcb", width: SHEET_WIDTH })), title: "PCB view" },
51
+ { ...(await draw({ view: "board", side: "top", look, width: SHEET_WIDTH })), title: "Top, as made" },
52
+ { ...(await draw({ view: "board", side: "bottom", look, width: SHEET_WIDTH })), title: "Bottom, as made" },
53
+ ];
54
+ const threeD = [];
55
+ for (const angle of ANGLES)
56
+ threeD.push({ ...(await draw({ view: "3d", angle, look, width: MODEL_WIDTH })), title: ANGLE_TITLES[angle] });
57
+ return { schematic, board, threeD };
58
+ }
59
+ /** The fabrication zip as `copperflow export` makes it, built in memory; or why the export refuses the design. */
60
+ async function fabricationZip(design, bom, date, canvas) {
61
+ const set = fabricationSet(design, bom, date);
62
+ if (!set.ok) {
63
+ const more = set.errors.length > REASONS_SHOWN ? ` and ${set.errors.length - REASONS_SHOWN} more` : "";
64
+ return { missing: `the export refuses this design until its errors are fixed: ${set.errors.slice(0, REASONS_SHOWN).join("; ")}${more}.` };
65
+ }
66
+ const boardPictures = await exportPictures(design, canvas);
67
+ const full = boardPictures === undefined ? set : withPictures(set, boardPictures, date);
68
+ const contents = `Gerbers, drills, pick-and-place, BOM, STEP${boardPictures === undefined ? "" : ", board pictures"}`;
69
+ return { zip: { name: set.zip, mime: "application/zip", label: `Download the fabrication files (${contents})`, bytes: full.zipData } };
70
+ }
71
+ async function downloads(design, bom, options) {
72
+ const name = designName(design.file);
73
+ const fab = await fabricationZip(design, bom, options.date, options.canvas);
74
+ const renderer = await (options.renderer ?? bundledRenderer)();
75
+ const glb = renderer.modelGlb(design, options.look ? { look: options.look } : {}).glb;
76
+ const step = new TextEncoder().encode(stepText(solidModel(design), name));
77
+ const files = [
78
+ ...("zip" in fab ? [fab.zip] : []),
79
+ { name: `${name}.glb`, mime: "model/gltf-binary", label: "Download the 3D model (GLB)", bytes: glb },
80
+ { name: `${name}.step`, mime: "model/step", label: "Download the 3D model for CAD (STEP, parts as boxes)", bytes: step },
81
+ { name: `${name}-bom.csv`, mime: "text/csv", label: "Download the bill of materials (CSV)", bytes: new TextEncoder().encode(formatBomCsv(bom)) },
82
+ ];
83
+ return { files, ...("missing" in fab ? { missing: fab.missing } : {}), sizes: { zip: "zip" in fab ? fab.zip.bytes.length : 0, glb: glb.length, step: step.length } };
84
+ }
85
+ /** The bundle sits beside dist/core: dist/render/render.js. Its path is built at run time, so tsc leaves it alone. */
86
+ const bundledRenderer = () => import(new URL("../render/render.js", import.meta.url).href);
87
+ /** Everything the page shows, gathered from one build. */
88
+ async function gather(root, circuit, design, options) {
89
+ const look = options.look ?? {};
90
+ resolveLook(look);
91
+ const bom = await buildBom(root, circuit, { design });
92
+ const drawn = await pictures(drawer(root, circuit, design, options), design, look);
93
+ const files = await downloads(design, bom, options);
94
+ const data = {
95
+ name: designName(circuit),
96
+ version: VERSION,
97
+ date: options.date.toISOString().slice(0, 10),
98
+ report: orderReportLines(design, bom).filter((line) => REPORT_PREFIXES.some((prefix) => line.startsWith(prefix))),
99
+ ...drawn,
100
+ bom,
101
+ downloads: files.files,
102
+ ...(files.missing !== undefined ? { fabricationMissing: files.missing } : {}),
103
+ };
104
+ const pictureBytes = [...drawn.schematic.map((s) => s.picture), ...drawn.board, ...drawn.threeD].reduce((sum, p) => sum + p.png.length, 0);
105
+ return { data, split: { pictures: pictureBytes, ...files.sizes } };
106
+ }
107
+ const plural = (n, word) => `${n} ${word}${n === 1 ? "" : "s"}`;
108
+ function whatLine(data) {
109
+ const files = data.downloads.map((file) => file.name).join(", ");
110
+ const fab = data.fabricationMissing === undefined ? "" : "; no fabrication files: the design has errors";
111
+ return `the design as one page: ${plural(data.schematic.length, "schematic page")}, the board (PCB view, top and bottom as made), 3D from ${ANGLES.length} angles, the BOM (${plural(data.bom.length, "line")}); files inside: ${files}${fab}`;
112
+ }
113
+ export { refuseStreamName } from "./out-name.js";
114
+ /** Builds the circuit and writes its web page to `out` or beside the circuit. */
115
+ export function exportHtml(root, file, options = {}) {
116
+ if (options.out !== undefined && !options.out.toLowerCase().endsWith(".html"))
117
+ throw new Error(`--out takes a file ending in .html (got ${options.out})`);
118
+ if (options.out !== undefined)
119
+ refuseStreamName(options.out);
120
+ return inProjectQueue(root, async () => {
121
+ const { file: circuit } = await resolveCircuit(root, file);
122
+ const path = resolveInRoot(root, options.out ?? join(dirname(circuit), `${designName(circuit)}.html`));
123
+ await assertLandsInProject(root, path);
124
+ const design = await buildWith(root, circuit, options.engine);
125
+ const { data, split } = await gather(root, circuit, design, { ...options, date: options.date ?? new Date() });
126
+ const text = htmlPage(data);
127
+ await mkdir(dirname(path), { recursive: true });
128
+ await writeFileAtomic(path, text);
129
+ return { file: relative(root, path).split(sep).join("/"), bytes: Buffer.byteLength(text, "utf8"), what: whatLine(data), split };
130
+ });
131
+ }
132
+ /** "Wrote io-8.html (2100 kB): the design as one page: ..." and what opens it. */
133
+ export function formatHtmlExport(result) {
134
+ return [
135
+ `Wrote ${result.file} (${Math.max(1, Math.round(result.bytes / 1000))} kB): ${result.what}`,
136
+ "Any web browser opens it from disk, with no network; it is a look at the design and its files, not an editor.",
137
+ ].join("\n");
138
+ }
139
+ //# sourceMappingURL=html-export.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"html-export.js","sourceRoot":"","sources":["../../src/core/html-export.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,39 @@
1
+ import type { BomLine } from "./bom.js";
2
+ export interface PagePicture {
3
+ png: Uint8Array;
4
+ width: number;
5
+ height: number;
6
+ /** What the picture shows: its own caption line. */
7
+ alt: string;
8
+ /** A short name for the view's tab ("Top, as made"); the page numbers the views when left out. */
9
+ title?: string;
10
+ }
11
+ export interface PageDownload {
12
+ /** The file name the browser saves it as. */
13
+ name: string;
14
+ mime: string;
15
+ label: string;
16
+ bytes: Uint8Array;
17
+ }
18
+ export interface PageData {
19
+ name: string;
20
+ version: string;
21
+ /** The day written on the page, "YYYY-MM-DD". */
22
+ date: string;
23
+ /** The order report's lines the header carries. */
24
+ report: string[];
25
+ schematic: {
26
+ page: string;
27
+ picture: PagePicture;
28
+ }[];
29
+ board: PagePicture[];
30
+ threeD: PagePicture[];
31
+ bom: BomLine[];
32
+ downloads: PageDownload[];
33
+ /** Why the fabrication files are not in the page, when they are not. */
34
+ fabricationMissing?: string;
35
+ }
36
+ /** Text made safe for HTML content and quoted attributes. */
37
+ export declare const escapeHtml: (text: string) => string;
38
+ /** The whole page as one HTML string; the same data gives the same text. */
39
+ export declare function htmlPage(data: PageData): string;
@@ -0,0 +1,114 @@
1
+ import { PAGE_SCRIPT, PAGE_STYLE } from "./html-style.js";
2
+ const ESCAPES = { "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&#39;" };
3
+ /** Text made safe for HTML content and quoted attributes. */
4
+ export const escapeHtml = (text) => text.replace(/[&<>"']/g, (c) => ESCAPES[c]);
5
+ const base64 = (bytes) => Buffer.from(bytes).toString("base64");
6
+ const kilobytes = (bytes) => `${Math.max(1, Math.round(bytes / 1000))} kB`;
7
+ const SECTIONS = [
8
+ ["files", "Files"],
9
+ ["schematic", "Schematic"],
10
+ ["board", "Board"],
11
+ ["three-d", "3D"],
12
+ ["bom", "Bill of materials"],
13
+ ];
14
+ /** Pictures at least this many times wider than tall keep a readable width on a phone and pan sideways. */
15
+ const WIDE = 1.5;
16
+ function figure(picture, caption = picture.alt) {
17
+ const alt = escapeHtml(picture.alt);
18
+ const wide = picture.width >= picture.height * WIDE ? " wide" : "";
19
+ return [
20
+ `<figure class="sheet${wide}">`,
21
+ `<div class="pan"><img src="data:image/png;base64,${base64(picture.png)}" width="${picture.width}" height="${picture.height}" alt="${alt}"></div>`,
22
+ `<figcaption>${escapeHtml(caption)}</figcaption>`,
23
+ "</figure>",
24
+ ].join("\n");
25
+ }
26
+ /** Several views in one frame, chosen with radio buttons (no script needed); one view is just its figure. */
27
+ function views(id, pictures) {
28
+ if (pictures.length < 2)
29
+ return pictures.map((picture) => figure(picture)).join("\n");
30
+ const name = `${id}-view`;
31
+ const inputs = pictures.map((_, i) => `<input type="radio" name="${name}" id="${name}-${i}"${i === 0 ? " checked" : ""}>`);
32
+ const labels = pictures.map((picture, i) => `<label for="${name}-${i}">${escapeHtml(picture.title ?? `View ${i + 1}`)}</label>`);
33
+ return ['<div class="views">', ...inputs, `<div class="tabs">${labels.join("")}</div>`, ...pictures.map((picture) => figure(picture)), "</div>"].join("\n");
34
+ }
35
+ /** A report line's mark: a "Ready for ...: yes" line is good news, a "...: no" one is not. */
36
+ const reportMark = (line) => (/^Ready for [^:]*: yes/.test(line) ? ' class="yes"' : /^Ready for [^:]*: no/.test(line) ? ' class="no"' : "");
37
+ function header(data) {
38
+ const contents = SECTIONS.map(([id, title]) => `<a href="#${id}">${title}</a>`).join("");
39
+ return [
40
+ '<header class="title-block">',
41
+ `<div class="tb-name"><p class="tb-label">Design</p><h1>${escapeHtml(data.name)}</h1></div>`,
42
+ `<dl class="tb-fields"><div><dt>Date</dt><dd>${escapeHtml(data.date)}</dd></div><div><dt>Tool</dt><dd>made with copperflow ${escapeHtml(data.version)}</dd></div></dl>`,
43
+ `<ul class="report">${data.report.map((line) => `<li${reportMark(line)}>${escapeHtml(line)}</li>`).join("")}</ul>`,
44
+ "</header>",
45
+ `<nav aria-label="Contents">${contents}</nav>`,
46
+ ].join("\n");
47
+ }
48
+ function filesSection(data) {
49
+ const links = data.downloads.map((file) => `<a class="button" href="data:${file.mime};base64,${base64(file.bytes)}" download="${escapeHtml(file.name)}"><span class="file-name">${escapeHtml(file.name)}</span><span class="file-size">${kilobytes(file.bytes.length)}</span><span class="file-what">${escapeHtml(file.label)}</span></a>`);
50
+ return [
51
+ '<section id="files">',
52
+ "<h2>Files</h2>",
53
+ `<div class="files">${links.join("\n")}</div>`,
54
+ ...(data.fabricationMissing === undefined ? [] : [`<p class="note">No fabrication files: ${escapeHtml(data.fabricationMissing)}</p>`]),
55
+ '<p class="note">The files are inside this page; nothing is fetched.</p>',
56
+ "</section>",
57
+ ].join("\n");
58
+ }
59
+ function schematicSection(data) {
60
+ const pages = data.schematic.map(({ page, picture }) => [`<h3>${escapeHtml(page)}</h3>`, figure(picture)].join("\n"));
61
+ return ['<section id="schematic">', "<h2>Schematic</h2>", ...pages, "</section>"].join("\n");
62
+ }
63
+ function picturesSection(id, title, pictures) {
64
+ return [`<section id="${id}">`, `<h2>${title}</h2>`, views(id, pictures), "</section>"].join("\n");
65
+ }
66
+ const BOM_COLUMNS = ["Designators", "Quantity", "Kind", "Value", "Footprint", "Supplier number", "Library part"];
67
+ function bomRow(line) {
68
+ const status = line.libraryPart === undefined ? "" : `${escapeHtml(line.libraryPart)}${line.verified === true ? "" : ' <span class="unverified">(not verified)</span>'}`;
69
+ const cells = [line.designators.join(", "), line.kind, line.value, line.footprint, line.supplier].map(escapeHtml);
70
+ return `<tr><td class="designators">${cells[0]}</td><td class="number">${line.quantity}</td><td>${cells[1]}</td><td>${cells[2]}</td><td>${cells[3]}</td><td>${cells[4]}</td><td>${status}</td></tr>`;
71
+ }
72
+ function bomSection(data) {
73
+ const unverified = data.bom.filter((line) => line.libraryPart !== undefined && line.verified !== true).flatMap((line) => line.designators);
74
+ const note = unverified.length > 0 ? `<p class="note">Not verified against their datasheets: ${escapeHtml(unverified.join(", "))}.</p>` : "";
75
+ return [
76
+ '<section id="bom">',
77
+ "<h2>Bill of materials</h2>",
78
+ '<div class="table"><table>',
79
+ `<thead><tr>${BOM_COLUMNS.map((column) => `<th scope="col"${column === "Quantity" ? ' class="number"' : ""}>${column}</th>`).join("")}</tr></thead>`,
80
+ `<tbody>${data.bom.map(bomRow).join("\n")}</tbody>`,
81
+ "</table></div>",
82
+ note,
83
+ "</section>",
84
+ ].join("\n");
85
+ }
86
+ /** The whole page as one HTML string; the same data gives the same text. */
87
+ export function htmlPage(data) {
88
+ return [
89
+ "<!doctype html>",
90
+ '<html lang="en">',
91
+ "<head>",
92
+ '<meta charset="utf-8">',
93
+ '<meta name="viewport" content="width=device-width, initial-scale=1">',
94
+ `<meta name="generator" content="copperflow ${escapeHtml(data.version)}">`,
95
+ `<title>${escapeHtml(data.name)}</title>`,
96
+ `<style>${PAGE_STYLE}</style>`,
97
+ "</head>",
98
+ "<body>",
99
+ "<main>",
100
+ header(data),
101
+ filesSection(data),
102
+ schematicSection(data),
103
+ picturesSection("board", "Board", data.board),
104
+ picturesSection("three-d", "3D", data.threeD),
105
+ bomSection(data),
106
+ `<footer>${escapeHtml(data.name)}, ${escapeHtml(data.date)}. The pictures and the files are inside this page.</footer>`,
107
+ "</main>",
108
+ `<script>${PAGE_SCRIPT}</script>`,
109
+ "</body>",
110
+ "</html>",
111
+ "",
112
+ ].join("\n");
113
+ }
114
+ //# sourceMappingURL=html-page.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"html-page.js","sourceRoot":"","sources":["../../src/core/html-page.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ export declare const PAGE_STYLE: string;
2
+ /** A click on a picture opens it larger in place; a second click or Escape closes it. */
3
+ export declare const PAGE_SCRIPT = "\ndocument.addEventListener(\"click\", function (event) {\n var figure = event.target.closest && event.target.closest(\"figure\");\n if (figure) figure.classList.toggle(\"open\");\n});\ndocument.addEventListener(\"keydown\", function (event) {\n if (event.key !== \"Escape\") return;\n document.querySelectorAll(\"figure.open\").forEach(function (figure) { figure.classList.remove(\"open\"); });\n});\n";