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
@@ -70,6 +70,67 @@ The person can do what `create_part` does in the Studio: Library → New part…
70
70
  the part's pins and package and writes the same part.yaml. When a part needs a photo of the
71
71
  datasheet or a choice only they can make, suggest that instead.
72
72
 
73
+ ## Drawings, pages and corners
74
+
75
+ These `edit_circuit` keys write what the Studio's editor writes; each is one step of the batch, and
76
+ a wrong shape is answered with the right one. Sheet units on a schematic page, mm on the board.
77
+
78
+ - `add_drawing` `{ shape?, page?, name?, …props }`: `shape` is `"text"` (default: `text, x, y,
79
+ fontSize?, anchor?` left/center/right), `"line"` (`points`), `"rect"` (`x, y, width, height,
80
+ filled?`), `"circle"` (`x, y, radius, filled?`), `"arc"` (`x, y, radius, startAngle, endAngle`),
81
+ `"junction"` (`x, y`) or `"bus"` (`name` such as `"D[0:7]"`, `points`). Lines take `strokeWidth`,
82
+ `lineStyle` (solid, dashed, dotted) and `color` (`"#000080"`). Without a name it is `G<n>`, and
83
+ the answer says which: `{ "add_drawing": { "text": "5 V in", "x": 2, "y": 1.5, "page": "Power" } }`.
84
+ The common note is one `add_text` call: `{ file, text, x, y, page?, fontSize? }`.
85
+ - `set_drawing` `{ id, …props }` moves or changes one (`name` renames it); `remove_drawing` `{ id }`.
86
+ - `add_page` `{ name }`, `rename_page` `{ from, to }`, `remove_page` `{ name }` (refused while a part is on it; "Main" keeps its name).
87
+ - `wire_corners` `{ from, to, corners: [{ x, y }] }` sets the corners of the trace's schematic wire,
88
+ to straighten one that crosses a label or symbol (`[]` removes them); `connect` takes `corners` too.
89
+ The wire runs straight from the pin through each corner to the end, so a right angle needs a corner
90
+ level with the pin: `render` the page afterwards and look.
91
+ A net label, GND or power flag is such a wire to `net.NAME` with one corner: its symbol is drawn at
92
+ the corner, picked from the net's name. Junction dots where wires meet are drawn by themselves;
93
+ no-connect marks are `set_props` `noConnect: "pin3"`.
94
+ - `rename_parts` `{ "R7": "R1", "R1": "R7" }` (Annotate): every reference follows, copper keeps its
95
+ nets. It goes alone in its call.
96
+ - In a `.sheet.tsx` file: `rename_port` `{ from, to }` and `sheet_size` `{ width?, height? }` (null:
97
+ the ports decide). Instances in other files that name the old port must be updated with `set_connections`.
98
+ - `set_pour` `{ id, net?, layer?, outline?, priority?, clearance?, minWidth?, thermal?, thermalWidth?,
99
+ thermalGap? }` (null removes a prop; outline null fills the board) and `set_hole` `{ id, x?, y?,
100
+ diameter? }`, e.g. `{ "set_pour": { "id": "copperpour:1", "clearance": 0.4 } }`.
101
+
102
+ Text on the board's silkscreen (its name, a version, a connector's legend) is `<silkscreentext text="IO-8 v1"
103
+ x={0} y={9} layer="top" height={1.5} rotation={0} />` inside `<board>`, centred on x, y in mm; `layer="bottom"`
104
+ is mirrored so it reads from below. Write it with `add_text` `{ file, text, x, y, layer, height?, rotation? }`
105
+ or `add_drawing` with a `layer`; the answer names its id (`silkscreentext:1`) for `set_drawing` (`text`, `x`,
106
+ `y`, `layer`, `height`, `rotation`, `name`; null removes height, rotation or name) and `remove_drawing`, and
107
+ `board_summary` lists every one. Limits: one line, at most 100 characters, height 0.8 to 20 mm (default
108
+ 1.5), and only the characters the lettering draws: A-Z a-z 0-9, space and `- _ + . / ~ ( ) # : % = , !`.
109
+ `check_circuit` reports text over a pad or hole (`silk-on-pad`) and text off the board (`silk-off-board`).
110
+
111
+ A drawing (a logo, a mark, a legend, a shape) from an SVG or DXF file is `<boardgraphic file="graphics/logo.svg"
112
+ layer="top-silkscreen" x={0} y={-6} width={10} rotation={0} fill={false} name="logo" />` inside `<board>`: the file
113
+ stays in the project's `graphics/` folder (only `graphics/<name>.svg|dxf` is read), centred on x, y in mm, `width`
114
+ in mm keeping its aspect (or `scale`; its own size when neither), turned `rotation` degrees. `layer` is
115
+ `top-silkscreen`, `bottom-silkscreen` (ink; the bottom is mirrored to read from below), `top-mask` or `bottom-mask`
116
+ (an opening in the solder mask: copper or bare board shows through), or a copper layer as pours name them (`top`,
117
+ `bottom`, `inner1`, `inner2`; inner ones on a 4-layer board only). On copper a drawing belongs to no net (`net` is
118
+ refused): the router goes round it, pours keep clear of it, and `check_circuit` reports any copper closer than the
119
+ clearance (`copper-clearance`, "boardgraphic:1 touches the track t0007 of GND"), the board edge (`copper-edge`), a
120
+ `<hole>` (`copper-hole`) and lines thinner than the minimum track width (`drawing-width`); thin parts of a filled shape
121
+ are not measured. A bare-copper logo is the same drawing on `top` and on `top-mask`. At most 5000 triangles on copper:
122
+ simplify a larger drawing. Write the SVG yourself with your file tools, then `import_graphic` `{ file, source, layer, x?, y?, width?,
123
+ scale?, rotation?, fill?, name? }` (source elsewhere in the project is copied into `graphics/`; no x, y: the board's
124
+ centre); the answer names its id (`boardgraphic:1`), its size in mm and what the reader left out (text, images).
125
+ Colour is not read: every filled shape is ink, so white details over black come out solid unless they are holes in
126
+ one `<path>` (fill-rule). SVG lines keep their `stroke-width`; a DXF has lines of no width (they print at 0.15 mm)
127
+ and fills only from SOLID or HATCH, so give `fill: true` to fill its closed outlines. Move, resize, re-layer or
128
+ remove it with `set_drawing` (`file`, `layer`, `x`, `y`, `width`, `scale`, `rotation`, `fill`, `name`) and
129
+ `remove_drawing`; `board_summary` lists it. A bad or missing file is a build warning and the drawing is left out.
130
+ `check_circuit` reports silkscreen ink over a pad or hole (`silk-on-pad`), off the board (`silk-off-board`) and
131
+ lines thinner than a board house prints (`silk-too-thin`). The CLI is `copperflow graphic <file> <drawing> --layer …`.
132
+ `redo_change` `{ id? }` brings back a change you undid by mistake; it never redoes a human's undo.
133
+
73
134
  ## Export
74
135
 
75
136
  `export_fabrication` `{ file, out? }` writes into the circuit's folder, or into the project
@@ -82,6 +143,16 @@ plated and non-plated drills, pick-and-place and the BOM into `<name>-fab/` and
82
143
  supplier part number and how to add one) and `export_fabrication` with its two verdicts;
83
144
  `export_package` also writes `pins.md` and a `<part>_pins.h` per library chip, the pin map for the firmware.
84
145
 
146
+ `export_model` `{ file, format, out?, look? }` writes one 3D model file beside the circuit, for a
147
+ design that still has errors too: `format: "step"` is the STEP file for mechanical CAD (the board
148
+ and each part as a box), `format: "glb"` a GLB file a 3D viewer turns (the board as made, in the
149
+ `look` asked for, and the parts as simple shapes, not their real models). Its answer names the parts
150
+ whose height is typical or assumed; pass that on when the person will fit an enclosure around it.
151
+
152
+ `export_html` `{ file, out?, look? }` writes `<name>.html`: the whole design as one web page (every
153
+ schematic page, the board, 3D, the BOM, and the fabrication zip, GLB, STEP and BOM CSV inside as
154
+ downloads). Use it to hand the design to a person as one file; it opens offline.
155
+
85
156
  Export only a clean board: `check_circuit` with 0 errors and no `unrouted` warning. With
86
157
  connections still unrouted the files are written with a warning, but the board is not finished
87
158
  and must not be ordered: say so, then route them with `route_track` by reference