copperflow 0.3.3 → 0.4.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 (466) hide show
  1. package/README.md +142 -12
  2. package/dist/app/THIRD_PARTY_LICENSES.txt +5 -0
  3. package/dist/app/assets/NewPartDialog-BBJaZFCo.js +160 -0
  4. package/dist/app/assets/VerifyPartDialog-BHLqD_WJ.css +1 -0
  5. package/dist/app/assets/VerifyPartDialog-Ey6xpQ_U.js +2 -0
  6. package/dist/app/assets/index-BKoIKo22.css +1 -0
  7. package/dist/app/assets/index-DPmr2dR1.js +20 -0
  8. package/dist/app/assets/texture-worker-CyI_g_XZ.js +1 -0
  9. package/dist/app/index.html +2 -2
  10. package/dist/cli-commands.js +170 -23
  11. package/dist/cli-commands.js.map +1 -1
  12. package/dist/cli-impedance.d.ts +4 -0
  13. package/dist/cli-impedance.js +56 -0
  14. package/dist/cli-impedance.js.map +1 -0
  15. package/dist/cli-library.d.ts +5 -0
  16. package/dist/cli-library.js +58 -0
  17. package/dist/cli-library.js.map +1 -0
  18. package/dist/cli-modules.d.ts +6 -0
  19. package/dist/cli-modules.js +33 -0
  20. package/dist/cli-modules.js.map +1 -0
  21. package/dist/cli-simulate.d.ts +3 -0
  22. package/dist/cli-simulate.js +54 -0
  23. package/dist/cli-simulate.js.map +1 -0
  24. package/dist/cli-studio.d.ts +1 -0
  25. package/dist/cli-studio.js +27 -0
  26. package/dist/cli-studio.js.map +1 -0
  27. package/dist/core/analyze.js +5 -2
  28. package/dist/core/analyze.js.map +1 -1
  29. package/dist/core/board-import.d.ts +39 -0
  30. package/dist/core/board-import.js +114 -0
  31. package/dist/core/board-import.js.map +1 -0
  32. package/dist/core/board-shape-edit.d.ts +13 -0
  33. package/dist/core/board-shape-edit.js +134 -0
  34. package/dist/core/board-shape-edit.js.map +1 -0
  35. package/dist/core/bom.d.ts +6 -1
  36. package/dist/core/bom.js +23 -4
  37. package/dist/core/bom.js.map +1 -1
  38. package/dist/core/case-results.d.ts +4 -0
  39. package/dist/core/case-results.js +9 -0
  40. package/dist/core/case-results.js.map +1 -0
  41. package/dist/core/change-files.d.ts +31 -0
  42. package/dist/core/change-files.js +67 -0
  43. package/dist/core/change-files.js.map +1 -0
  44. package/dist/core/change-render.d.ts +18 -0
  45. package/dist/core/change-render.js +48 -0
  46. package/dist/core/change-render.js.map +1 -0
  47. package/dist/core/change-view.d.ts +33 -0
  48. package/dist/core/change-view.js +73 -0
  49. package/dist/core/change-view.js.map +1 -0
  50. package/dist/core/change-words.d.ts +39 -0
  51. package/dist/core/change-words.js +214 -0
  52. package/dist/core/change-words.js.map +1 -0
  53. package/dist/core/checklist-text.d.ts +21 -0
  54. package/dist/core/checklist-text.js +59 -0
  55. package/dist/core/checklist-text.js.map +1 -0
  56. package/dist/core/edit.js +12 -3
  57. package/dist/core/edit.js.map +1 -1
  58. package/dist/core/fabrication.d.ts +9 -2
  59. package/dist/core/fabrication.js +29 -10
  60. package/dist/core/fabrication.js.map +1 -1
  61. package/dist/core/git.d.ts +16 -0
  62. package/dist/core/git.js +51 -0
  63. package/dist/core/git.js.map +1 -0
  64. package/dist/core/home.d.ts +2 -0
  65. package/dist/core/home.js +10 -0
  66. package/dist/core/home.js.map +1 -0
  67. package/dist/core/index.d.ts +1 -0
  68. package/dist/core/index.js +1 -0
  69. package/dist/core/index.js.map +1 -1
  70. package/dist/core/instance-copper.d.ts +25 -0
  71. package/dist/core/instance-copper.js +142 -0
  72. package/dist/core/instance-copper.js.map +1 -0
  73. package/dist/core/instance-move.d.ts +23 -0
  74. package/dist/core/instance-move.js +59 -0
  75. package/dist/core/instance-move.js.map +1 -0
  76. package/dist/core/instance-requests.d.ts +3 -2
  77. package/dist/core/instance-requests.js +17 -3
  78. package/dist/core/instance-requests.js.map +1 -1
  79. package/dist/core/library-modules.d.ts +29 -0
  80. package/dist/core/library-modules.js +324 -0
  81. package/dist/core/library-modules.js.map +1 -0
  82. package/dist/core/library-sources.d.ts +33 -0
  83. package/dist/core/library-sources.js +179 -0
  84. package/dist/core/library-sources.js.map +1 -0
  85. package/dist/core/library.d.ts +46 -0
  86. package/dist/core/library.js +54 -16
  87. package/dist/core/library.js.map +1 -1
  88. package/dist/core/modules.d.ts +45 -0
  89. package/dist/core/modules.js +301 -0
  90. package/dist/core/modules.js.map +1 -0
  91. package/dist/core/new-circuit-sheets.d.ts +11 -2
  92. package/dist/core/new-circuit-sheets.js +35 -6
  93. package/dist/core/new-circuit-sheets.js.map +1 -1
  94. package/dist/core/order-report.d.ts +10 -0
  95. package/dist/core/order-report.js +93 -0
  96. package/dist/core/order-report.js.map +1 -0
  97. package/dist/core/pin-header.d.ts +5 -0
  98. package/dist/core/pin-header.js +77 -0
  99. package/dist/core/pin-header.js.map +1 -0
  100. package/dist/core/pin-map.d.ts +46 -0
  101. package/dist/core/pin-map.js +101 -0
  102. package/dist/core/pin-map.js.map +1 -0
  103. package/dist/core/placement-write.d.ts +2 -0
  104. package/dist/core/placement-write.js +12 -6
  105. package/dist/core/placement-write.js.map +1 -1
  106. package/dist/core/plain-sheet.d.ts +12 -0
  107. package/dist/core/plain-sheet.js +169 -0
  108. package/dist/core/plain-sheet.js.map +1 -0
  109. package/dist/core/render.d.ts +24 -4
  110. package/dist/core/render.js +16 -6
  111. package/dist/core/render.js.map +1 -1
  112. package/dist/core/sheet-card.d.ts +37 -0
  113. package/dist/core/sheet-card.js +163 -0
  114. package/dist/core/sheet-card.js.map +1 -0
  115. package/dist/core/sheet-files.js +10 -3
  116. package/dist/core/sheet-files.js.map +1 -1
  117. package/dist/core/simulate.d.ts +19 -0
  118. package/dist/core/simulate.js +72 -0
  119. package/dist/core/simulate.js.map +1 -0
  120. package/dist/core/step-export.d.ts +17 -0
  121. package/dist/core/step-export.js +35 -0
  122. package/dist/core/step-export.js.map +1 -0
  123. package/dist/core/supplier-prop.d.ts +6 -0
  124. package/dist/core/supplier-prop.js +21 -0
  125. package/dist/core/supplier-prop.js.map +1 -0
  126. package/dist/core/types.d.ts +20 -0
  127. package/dist/core/workspace.d.ts +6 -1
  128. package/dist/core/workspace.js +15 -3
  129. package/dist/core/workspace.js.map +1 -1
  130. package/dist/engine/board.js +3 -1
  131. package/dist/engine/board.js.map +1 -1
  132. package/dist/engine/checks/drc-parts.js +7 -7
  133. package/dist/engine/checks/drc-parts.js.map +1 -1
  134. package/dist/engine/checks/erc.js +35 -3
  135. package/dist/engine/checks/erc.js.map +1 -1
  136. package/dist/engine/checks/fast-lines.d.ts +60 -0
  137. package/dist/engine/checks/fast-lines.js +209 -0
  138. package/dist/engine/checks/fast-lines.js.map +1 -0
  139. package/dist/engine/checks/index.js +2 -0
  140. package/dist/engine/checks/index.js.map +1 -1
  141. package/dist/engine/component.d.ts +2 -0
  142. package/dist/engine/component.js +18 -1
  143. package/dist/engine/component.js.map +1 -1
  144. package/dist/engine/design-diff.d.ts +120 -0
  145. package/dist/engine/design-diff.js +249 -0
  146. package/dist/engine/design-diff.js.map +1 -0
  147. package/dist/engine/design.d.ts +3 -0
  148. package/dist/engine/design.js +7 -2
  149. package/dist/engine/design.js.map +1 -1
  150. package/dist/engine/dxf/board.d.ts +42 -0
  151. package/dist/engine/dxf/board.js +218 -0
  152. package/dist/engine/dxf/board.js.map +1 -0
  153. package/dist/engine/dxf/index.d.ts +2 -0
  154. package/dist/engine/dxf/index.js +3 -0
  155. package/dist/engine/dxf/index.js.map +1 -0
  156. package/dist/engine/dxf/reader.d.ts +43 -0
  157. package/dist/engine/dxf/reader.js +142 -0
  158. package/dist/engine/dxf/reader.js.map +1 -0
  159. package/dist/engine/elaborate.js +14 -4
  160. package/dist/engine/elaborate.js.map +1 -1
  161. package/dist/engine/fab/designator-places.d.ts +101 -0
  162. package/dist/engine/fab/designator-places.js +259 -0
  163. package/dist/engine/fab/designator-places.js.map +1 -0
  164. package/dist/engine/fab/designators.d.ts +26 -14
  165. package/dist/engine/fab/designators.js +320 -70
  166. package/dist/engine/fab/designators.js.map +1 -1
  167. package/dist/engine/fab/export.d.ts +17 -1
  168. package/dist/engine/fab/export.js +26 -4
  169. package/dist/engine/fab/export.js.map +1 -1
  170. package/dist/engine/fab/layers.js +6 -6
  171. package/dist/engine/fab/layers.js.map +1 -1
  172. package/dist/engine/fab/names.d.ts +2 -2
  173. package/dist/engine/fab/names.js +4 -2
  174. package/dist/engine/fab/names.js.map +1 -1
  175. package/dist/engine/fab/picture/board-picture.d.ts +52 -0
  176. package/dist/engine/fab/picture/board-picture.js +102 -0
  177. package/dist/engine/fab/picture/board-picture.js.map +1 -0
  178. package/dist/engine/fab/picture/board-view.d.ts +20 -0
  179. package/dist/engine/fab/picture/board-view.js +50 -0
  180. package/dist/engine/fab/picture/board-view.js.map +1 -0
  181. package/dist/engine/fab/picture/compose.d.ts +50 -0
  182. package/dist/engine/fab/picture/compose.js +208 -0
  183. package/dist/engine/fab/picture/compose.js.map +1 -0
  184. package/dist/engine/fab/picture/layer-images.d.ts +9 -0
  185. package/dist/engine/fab/picture/layer-images.js +67 -0
  186. package/dist/engine/fab/picture/layer-images.js.map +1 -0
  187. package/dist/engine/fab/picture/looks.d.ts +152 -0
  188. package/dist/engine/fab/picture/looks.js +53 -0
  189. package/dist/engine/fab/picture/looks.js.map +1 -0
  190. package/dist/engine/fab/picture/png.d.ts +31 -0
  191. package/dist/engine/fab/picture/png.js +47 -0
  192. package/dist/engine/fab/picture/png.js.map +1 -0
  193. package/dist/engine/fab/picture/raster.d.ts +46 -0
  194. package/dist/engine/fab/picture/raster.js +170 -0
  195. package/dist/engine/fab/picture/raster.js.map +1 -0
  196. package/dist/engine/fab/stroke-font.d.ts +2 -2
  197. package/dist/engine/fab/stroke-font.js +7 -6
  198. package/dist/engine/fab/stroke-font.js.map +1 -1
  199. package/dist/engine/fab/zip.d.ts +2 -1
  200. package/dist/engine/fab/zip.js +1 -1
  201. package/dist/engine/fab/zip.js.map +1 -1
  202. package/dist/engine/impedance.d.ts +72 -0
  203. package/dist/engine/impedance.js +133 -0
  204. package/dist/engine/impedance.js.map +1 -0
  205. package/dist/engine/line-length.d.ts +15 -0
  206. package/dist/engine/line-length.js +116 -0
  207. package/dist/engine/line-length.js.map +1 -0
  208. package/dist/engine/model.d.ts +17 -1
  209. package/dist/engine/model.js.map +1 -1
  210. package/dist/engine/pcb-place/block-board.d.ts +9 -0
  211. package/dist/engine/pcb-place/block-board.js +256 -0
  212. package/dist/engine/pcb-place/block-board.js.map +1 -0
  213. package/dist/engine/pcb-place/blocks.d.ts +31 -6
  214. package/dist/engine/pcb-place/blocks.js +37 -8
  215. package/dist/engine/pcb-place/blocks.js.map +1 -1
  216. package/dist/engine/pcb-place/constructive.d.ts +3 -2
  217. package/dist/engine/pcb-place/constructive.js +14 -2
  218. package/dist/engine/pcb-place/constructive.js.map +1 -1
  219. package/dist/engine/pcb-place/index.d.ts +8 -0
  220. package/dist/engine/pcb-place/index.js +7 -0
  221. package/dist/engine/pcb-place/index.js.map +1 -1
  222. package/dist/engine/pcb-place/roles.d.ts +3 -1
  223. package/dist/engine/pcb-place/roles.js +5 -0
  224. package/dist/engine/pcb-place/roles.js.map +1 -1
  225. package/dist/engine/pcb-place/scope.js +6 -1
  226. package/dist/engine/pcb-place/scope.js.map +1 -1
  227. package/dist/engine/pcb.d.ts +6 -0
  228. package/dist/engine/pcb.js +12 -1
  229. package/dist/engine/pcb.js.map +1 -1
  230. package/dist/engine/router/replicate.js +4 -0
  231. package/dist/engine/router/replicate.js.map +1 -1
  232. package/dist/engine/router/route-board.d.ts +2 -0
  233. package/dist/engine/router/route-board.js +27 -1
  234. package/dist/engine/router/route-board.js.map +1 -1
  235. package/dist/engine/rules/impedance-widths.d.ts +20 -0
  236. package/dist/engine/rules/impedance-widths.js +57 -0
  237. package/dist/engine/rules/impedance-widths.js.map +1 -0
  238. package/dist/engine/rules/load.js +11 -2
  239. package/dist/engine/rules/load.js.map +1 -1
  240. package/dist/engine/rules/pairs.d.ts +27 -0
  241. package/dist/engine/rules/pairs.js +86 -0
  242. package/dist/engine/rules/pairs.js.map +1 -0
  243. package/dist/engine/rules/profiles.js +16 -0
  244. package/dist/engine/rules/profiles.js.map +1 -1
  245. package/dist/engine/rules/schema.d.ts +44 -0
  246. package/dist/engine/rules/schema.js +16 -1
  247. package/dist/engine/rules/schema.js.map +1 -1
  248. package/dist/engine/sheet-ports.d.ts +17 -1
  249. package/dist/engine/sheet-ports.js +38 -1
  250. package/dist/engine/sheet-ports.js.map +1 -1
  251. package/dist/engine/sim/answer.d.ts +13 -0
  252. package/dist/engine/sim/answer.js +101 -0
  253. package/dist/engine/sim/answer.js.map +1 -0
  254. package/dist/engine/sim/cases.d.ts +29 -0
  255. package/dist/engine/sim/cases.js +63 -0
  256. package/dist/engine/sim/cases.js.map +1 -0
  257. package/dist/engine/sim/devices.d.ts +109 -0
  258. package/dist/engine/sim/devices.js +137 -0
  259. package/dist/engine/sim/devices.js.map +1 -0
  260. package/dist/engine/sim/elements.d.ts +49 -0
  261. package/dist/engine/sim/elements.js +2 -0
  262. package/dist/engine/sim/elements.js.map +1 -0
  263. package/dist/engine/sim/from-circuit.d.ts +52 -0
  264. package/dist/engine/sim/from-circuit.js +354 -0
  265. package/dist/engine/sim/from-circuit.js.map +1 -0
  266. package/dist/engine/sim/limits.d.ts +12 -0
  267. package/dist/engine/sim/limits.js +79 -0
  268. package/dist/engine/sim/limits.js.map +1 -0
  269. package/dist/engine/sim/linear.d.ts +2 -0
  270. package/dist/engine/sim/linear.js +49 -0
  271. package/dist/engine/sim/linear.js.map +1 -0
  272. package/dist/engine/sim/model-schema.d.ts +246 -0
  273. package/dist/engine/sim/model-schema.js +115 -0
  274. package/dist/engine/sim/model-schema.js.map +1 -0
  275. package/dist/engine/sim/part-models.d.ts +47 -0
  276. package/dist/engine/sim/part-models.js +102 -0
  277. package/dist/engine/sim/part-models.js.map +1 -0
  278. package/dist/engine/sim/run.d.ts +14 -0
  279. package/dist/engine/sim/run.js +13 -0
  280. package/dist/engine/sim/run.js.map +1 -0
  281. package/dist/engine/sim/solve.d.ts +42 -0
  282. package/dist/engine/sim/solve.js +294 -0
  283. package/dist/engine/sim/solve.js.map +1 -0
  284. package/dist/engine/sim/spice.d.ts +5 -0
  285. package/dist/engine/sim/spice.js +66 -0
  286. package/dist/engine/sim/spice.js.map +1 -0
  287. package/dist/engine/sim/values.d.ts +4 -0
  288. package/dist/engine/sim/values.js +40 -0
  289. package/dist/engine/sim/values.js.map +1 -0
  290. package/dist/engine/solid/heights.d.ts +29 -0
  291. package/dist/engine/solid/heights.js +87 -0
  292. package/dist/engine/solid/heights.js.map +1 -0
  293. package/dist/engine/solid/limits.d.ts +7 -0
  294. package/dist/engine/solid/limits.js +20 -0
  295. package/dist/engine/solid/limits.js.map +1 -0
  296. package/dist/engine/solid/model.d.ts +54 -0
  297. package/dist/engine/solid/model.js +147 -0
  298. package/dist/engine/solid/model.js.map +1 -0
  299. package/dist/engine/solid/step.d.ts +5 -0
  300. package/dist/engine/solid/step.js +164 -0
  301. package/dist/engine/solid/step.js.map +1 -0
  302. package/dist/engine/solid/thickness.d.ts +11 -0
  303. package/dist/engine/solid/thickness.js +10 -0
  304. package/dist/engine/solid/thickness.js.map +1 -0
  305. package/dist/library/kicad/board.d.ts +26 -0
  306. package/dist/library/kicad/board.js +96 -0
  307. package/dist/library/kicad/board.js.map +1 -0
  308. package/dist/library/kicad/copper.d.ts +44 -0
  309. package/dist/library/kicad/copper.js +106 -0
  310. package/dist/library/kicad/copper.js.map +1 -0
  311. package/dist/library/kicad/footprints.d.ts +62 -0
  312. package/dist/library/kicad/footprints.js +184 -0
  313. package/dist/library/kicad/footprints.js.map +1 -0
  314. package/dist/library/kicad/geometry.d.ts +36 -0
  315. package/dist/library/kicad/geometry.js +84 -0
  316. package/dist/library/kicad/geometry.js.map +1 -0
  317. package/dist/library/kicad/import.d.ts +58 -0
  318. package/dist/library/kicad/import.js +240 -0
  319. package/dist/library/kicad/import.js.map +1 -0
  320. package/dist/library/kicad/plan.d.ts +40 -0
  321. package/dist/library/kicad/plan.js +139 -0
  322. package/dist/library/kicad/plan.js.map +1 -0
  323. package/dist/library/kicad/read.d.ts +30 -0
  324. package/dist/library/kicad/read.js +105 -0
  325. package/dist/library/kicad/read.js.map +1 -0
  326. package/dist/library/kicad/sexpr.d.ts +36 -0
  327. package/dist/library/kicad/sexpr.js +153 -0
  328. package/dist/library/kicad/sexpr.js.map +1 -0
  329. package/dist/library/kicad/tally.d.ts +32 -0
  330. package/dist/library/kicad/tally.js +55 -0
  331. package/dist/library/kicad/tally.js.map +1 -0
  332. package/dist/library/kicad/write.d.ts +37 -0
  333. package/dist/library/kicad/write.js +146 -0
  334. package/dist/library/kicad/write.js.map +1 -0
  335. package/dist/library/new-part.d.ts +2 -0
  336. package/dist/library/new-part.js +1 -0
  337. package/dist/library/new-part.js.map +1 -1
  338. package/dist/mcp/batch.d.ts +2 -2
  339. package/dist/mcp/batch.js +12 -12
  340. package/dist/mcp/batch.js.map +1 -1
  341. package/dist/mcp/board-import-tool.d.ts +25 -0
  342. package/dist/mcp/board-import-tool.js +35 -0
  343. package/dist/mcp/board-import-tool.js.map +1 -0
  344. package/dist/mcp/board-summary.d.ts +1 -1
  345. package/dist/mcp/board-summary.js +1 -1
  346. package/dist/mcp/board-summary.js.map +1 -1
  347. package/dist/mcp/copper-summary.d.ts +2 -0
  348. package/dist/mcp/copper-summary.js +4 -2
  349. package/dist/mcp/copper-summary.js.map +1 -1
  350. package/dist/mcp/copper-tools.d.ts +4 -4
  351. package/dist/mcp/copper-tools.js +19 -19
  352. package/dist/mcp/copper-tools.js.map +1 -1
  353. package/dist/mcp/create-part.d.ts +24 -1
  354. package/dist/mcp/create-part.js +9 -8
  355. package/dist/mcp/create-part.js.map +1 -1
  356. package/dist/mcp/datasheet-tools.d.ts +1 -1
  357. package/dist/mcp/datasheet-tools.js +4 -4
  358. package/dist/mcp/datasheet-tools.js.map +1 -1
  359. package/dist/mcp/fast-summary.d.ts +3 -0
  360. package/dist/mcp/fast-summary.js +46 -0
  361. package/dist/mcp/fast-summary.js.map +1 -0
  362. package/dist/mcp/fillet-tools.d.ts +2 -2
  363. package/dist/mcp/fillet-tools.js +6 -6
  364. package/dist/mcp/fillet-tools.js.map +1 -1
  365. package/dist/mcp/guide.d.ts +1 -1
  366. package/dist/mcp/guide.js +4 -3
  367. package/dist/mcp/guide.js.map +1 -1
  368. package/dist/mcp/import-part.d.ts +1 -1
  369. package/dist/mcp/import-part.js +4 -4
  370. package/dist/mcp/import-part.js.map +1 -1
  371. package/dist/mcp/make-sheet.d.ts +1 -1
  372. package/dist/mcp/make-sheet.js +6 -6
  373. package/dist/mcp/make-sheet.js.map +1 -1
  374. package/dist/mcp/module-tools.d.ts +4 -0
  375. package/dist/mcp/module-tools.js +21 -0
  376. package/dist/mcp/module-tools.js.map +1 -0
  377. package/dist/mcp/new-circuit.d.ts +13 -2
  378. package/dist/mcp/new-circuit.js +30 -28
  379. package/dist/mcp/new-circuit.js.map +1 -1
  380. package/dist/mcp/open-studio.d.ts +30 -0
  381. package/dist/mcp/open-studio.js +97 -0
  382. package/dist/mcp/open-studio.js.map +1 -0
  383. package/dist/mcp/place-tools.d.ts +2 -2
  384. package/dist/mcp/place-tools.js +14 -11
  385. package/dist/mcp/place-tools.js.map +1 -1
  386. package/dist/mcp/pour-tools.d.ts +4 -4
  387. package/dist/mcp/pour-tools.js +18 -18
  388. package/dist/mcp/pour-tools.js.map +1 -1
  389. package/dist/mcp/project-tools.d.ts +3 -3
  390. package/dist/mcp/project-tools.js +8 -8
  391. package/dist/mcp/project-tools.js.map +1 -1
  392. package/dist/mcp/render-tool.d.ts +33 -2
  393. package/dist/mcp/render-tool.js +23 -7
  394. package/dist/mcp/render-tool.js.map +1 -1
  395. package/dist/mcp/route-tools.d.ts +2 -2
  396. package/dist/mcp/route-tools.js +10 -10
  397. package/dist/mcp/route-tools.js.map +1 -1
  398. package/dist/mcp/server.js +60 -34
  399. package/dist/mcp/server.js.map +1 -1
  400. package/dist/mcp/sheet-card-tools.d.ts +30 -0
  401. package/dist/mcp/sheet-card-tools.js +47 -0
  402. package/dist/mcp/sheet-card-tools.js.map +1 -0
  403. package/dist/mcp/simulate-tool.d.ts +10 -0
  404. package/dist/mcp/simulate-tool.js +12 -0
  405. package/dist/mcp/simulate-tool.js.map +1 -0
  406. package/dist/render/render.js +8178 -118
  407. package/dist/studio/change-route.d.ts +18 -0
  408. package/dist/studio/change-route.js +24 -0
  409. package/dist/studio/change-route.js.map +1 -0
  410. package/dist/studio/http-error.d.ts +5 -0
  411. package/dist/studio/http-error.js +9 -0
  412. package/dist/studio/http-error.js.map +1 -0
  413. package/dist/studio/idle.d.ts +7 -0
  414. package/dist/studio/idle.js +34 -0
  415. package/dist/studio/idle.js.map +1 -0
  416. package/dist/studio/live.d.ts +2 -0
  417. package/dist/studio/live.js.map +1 -1
  418. package/dist/studio/place-runner.js +1 -1
  419. package/dist/studio/place-runner.js.map +1 -1
  420. package/dist/studio/run-studio.d.ts +21 -0
  421. package/dist/studio/run-studio.js +68 -0
  422. package/dist/studio/run-studio.js.map +1 -0
  423. package/dist/studio/server.d.ts +5 -0
  424. package/dist/studio/server.js +66 -16
  425. package/dist/studio/server.js.map +1 -1
  426. package/dist/studio/studio-control.d.ts +6 -0
  427. package/dist/studio/studio-control.js +14 -0
  428. package/dist/studio/studio-control.js.map +1 -0
  429. package/dist/studio/studio-note.d.ts +33 -0
  430. package/dist/studio/studio-note.js +130 -0
  431. package/dist/studio/studio-note.js.map +1 -0
  432. package/dist/studio/verify-routes.d.ts +42 -0
  433. package/dist/studio/verify-routes.js +110 -0
  434. package/dist/studio/verify-routes.js.map +1 -0
  435. package/dist/version.d.ts +1 -1
  436. package/dist/version.js +1 -1
  437. package/library/modules/CanNode/CanNode.sheet.tsx +65 -0
  438. package/library/modules/CanNode/module.json +4 -0
  439. package/library/modules/CanNode/parts/MCP2515-I-SO/MCP2515_I_SO.tsx +11 -0
  440. package/library/modules/CanNode/parts/MCP2515-I-SO/part.yaml +66 -0
  441. package/library/modules/CanNode/parts/MCP2515-I-SO/verification.md +43 -0
  442. package/library/modules/CanNode/parts/TJA1051T-3/TJA1051T_3.tsx +11 -0
  443. package/library/modules/CanNode/parts/TJA1051T-3/part.yaml +36 -0
  444. package/library/modules/CanNode/parts/TJA1051T-3/verification.md +29 -0
  445. package/library/modules/DigitalInput24V/DigitalInput24V.sheet.tsx +24 -0
  446. package/library/modules/DigitalInput24V/module.json +4 -0
  447. package/library/modules/RelayDriver/RelayDriver.sheet.tsx +39 -0
  448. package/library/modules/RelayDriver/module.json +4 -0
  449. package/library/modules/RelayDriver/parts/AO3400A/AO3400A.tsx +11 -0
  450. package/library/modules/RelayDriver/parts/AO3400A/part.yaml +55 -0
  451. package/library/modules/RelayDriver/parts/AO3400A/verification.md +34 -0
  452. package/library/modules/RelayDriver/parts/SRD-12VDC-SL-C/SRD_12VDC_SL_C.tsx +12 -0
  453. package/library/modules/RelayDriver/parts/SRD-12VDC-SL-C/footprint.yaml +70 -0
  454. package/library/modules/RelayDriver/parts/SRD-12VDC-SL-C/part.yaml +45 -0
  455. package/library/modules/RelayDriver/parts/SRD-12VDC-SL-C/verification.md +40 -0
  456. package/package.json +2 -1
  457. package/skills/copperflow/SKILL.md +16 -16
  458. package/skills/copperflow/references/copper.md +89 -6
  459. package/skills/copperflow/references/design-rules.md +48 -0
  460. package/skills/copperflow/references/modules.md +106 -0
  461. package/skills/copperflow/references/planning.md +55 -11
  462. package/skills/copperflow/references/writing-circuits.md +32 -3
  463. package/skills/copperflow-plan/SKILL.md +7 -4
  464. package/dist/app/assets/NewPartDialog-B_cnPuI-.js +0 -160
  465. package/dist/app/assets/index-CSWIIMFE.css +0 -1
  466. package/dist/app/assets/index-CjN3tctq.js +0 -19
@@ -0,0 +1,139 @@
1
+ // What a read KiCad board becomes in copperflow: designators and net names copperflow accepts, each part's pins, and
2
+ // one library part per distinct land pattern, pin list and value (the value is the part's title, which the BOM reads).
3
+ import { PART_NAME, NET_NAME } from "../../core/netlist.js";
4
+ import { PIN_NAME, PIN_NUMBER, PIN_TYPES } from "../../core/pin-types.js";
5
+ /** A net KiCad named itself, from a pad (`Net-(R1-Pad1)`) or for a pad on no net (`unconnected-(U1-Pad3)`). */
6
+ export const isMadeUpName = (name) => /^(Net-\(|unconnected-\(|Net-\/)/.test(name);
7
+ /** A name made of letters, digits and _ that starts as `first` allows. */
8
+ function cleaned(name, first, prefix, extra = "") {
9
+ const body = name.replace(new RegExp(`[^A-Za-z0-9_${extra}]`, "g"), "_");
10
+ return first.test(body) ? body : `${prefix}${body}`;
11
+ }
12
+ /** The net name copperflow writes for a KiCad net name: "+5V" is P5V, "-12V" N12V, "/sense" sense. */
13
+ export function circuitNetName(name) {
14
+ const plain = name.replace(/^\//, "").replace(/^\+/, "P").replace(/^-(?=\d)/, "N");
15
+ const result = cleaned(plain, /^[A-Za-z_]/, "N", "-");
16
+ return NET_NAME.test(result) ? result : "N";
17
+ }
18
+ /** Gives each name a form `make` turns it into, unique among them: a second "A" is A_2. */
19
+ function uniqueNames(names, make, used = new Set()) {
20
+ const result = new Map();
21
+ for (const name of names) {
22
+ const base = make(name);
23
+ let candidate = base;
24
+ for (let n = 2; used.has(candidate.toLowerCase()); n++)
25
+ candidate = `${base}_${n}`;
26
+ used.add(candidate.toLowerCase());
27
+ result.set(name, candidate);
28
+ }
29
+ return result;
30
+ }
31
+ /** Which nets get a name and which are connections without one, from the pins on each; a net on no pin gets nothing. */
32
+ export function planNets(pinsOn) {
33
+ const names = [];
34
+ const unnamed = new Set();
35
+ const single = new Set();
36
+ for (const [net, pins] of pinsOn) {
37
+ if (pins.length < 2 && (isMadeUpName(net) || pins.length === 0))
38
+ single.add(net);
39
+ else if (isMadeUpName(net))
40
+ unnamed.add(net);
41
+ else
42
+ names.push(net);
43
+ }
44
+ return { names: uniqueNames(names, circuitNetName), unnamed, single };
45
+ }
46
+ /** Each part's designator as copperflow writes it: R1 stays R1, "#FL1" is P_FL1, a repeat gets _2. */
47
+ export function planDesignators(parts) {
48
+ const used = new Set();
49
+ return parts.map((part) => {
50
+ const base = cleaned(part.ref || "P", /^[A-Za-z]/, "P").slice(0, 28);
51
+ let name = PART_NAME.test(base) ? base : "P";
52
+ for (let n = 2; used.has(name.toLowerCase()); n++)
53
+ name = `${base.slice(0, 28)}_${n}`;
54
+ used.add(name.toLowerCase());
55
+ return name;
56
+ });
57
+ }
58
+ const TYPES = new Set(PIN_TYPES);
59
+ function pinType(pad) {
60
+ const type = (pad.type ?? "passive").replace(/\+no_connect$/, "");
61
+ if (type === "no_connect")
62
+ return pad.net ? "passive" : "no_connect";
63
+ return TYPES.has(type) ? type : "passive";
64
+ }
65
+ /** A pin name from the pad's function ("~{RESET}" is RESET), else from its number. */
66
+ function pinName(pad, number) {
67
+ const fn = pad.function?.replace(/[~{}]/g, "").trim();
68
+ if (fn) {
69
+ const name = cleaned(fn, /^[A-Za-z_]/, "P");
70
+ if (PIN_NAME.test(name))
71
+ return name;
72
+ }
73
+ if (pad.number !== "" && !PIN_NUMBER.test(pad.number))
74
+ return cleaned(pad.number, /^[A-Za-z_]/, "P");
75
+ return pad.number === "" ? "MP" : `pin${number}`;
76
+ }
77
+ /**
78
+ * The pins of a part: a pad numbered 1, 2, … is that pin; a pad named otherwise ("A1", "SH") or unnamed gets the next
79
+ * number after the highest, and pads of one name are one pin. A name used twice gets the pin number added: GND_4.
80
+ */
81
+ export function planPins(part) {
82
+ const numeric = part.pads.flatMap((pad) => (PIN_NUMBER.test(pad.number) ? [Number(pad.number)] : []));
83
+ let next = Math.max(0, ...numeric) + 1;
84
+ const byName = new Map();
85
+ const padPins = part.pads.map((pad) => {
86
+ if (PIN_NUMBER.test(pad.number))
87
+ return Number(pad.number);
88
+ if (pad.number === "")
89
+ return next++;
90
+ const known = byName.get(pad.number);
91
+ if (known !== undefined)
92
+ return known;
93
+ byName.set(pad.number, next);
94
+ return next++;
95
+ });
96
+ const pins = {};
97
+ const taken = new Set();
98
+ part.pads.forEach((pad, index) => {
99
+ const number = padPins[index];
100
+ if (String(number) in pins)
101
+ return;
102
+ let name = pinName(pad, number);
103
+ if (taken.has(name.toLowerCase()))
104
+ name = `${name}_${number}`;
105
+ taken.add(name.toLowerCase());
106
+ pins[String(number)] = { name, type: pinType(pad) };
107
+ });
108
+ return { padPins, pins };
109
+ }
110
+ const round = (v) => Math.round(v * 10_000) / 10_000 || 0;
111
+ /** The land pattern of a part, with its pads numbered as pins. */
112
+ export function footprintFileOf(part, pins) {
113
+ return {
114
+ pads: part.pads.map((pad, index) => ({
115
+ number: String(pins.padPins[index]),
116
+ shape: pad.shape,
117
+ x: round(pad.x),
118
+ y: round(pad.y),
119
+ width: pad.width,
120
+ height: pad.height,
121
+ ...(pad.rotation !== 0 ? { rotation: pad.rotation } : {}),
122
+ ...(pad.layers === "through" ? { layers: "through" } : {}),
123
+ ...(pad.drill !== undefined ? { drill: pad.drill } : {}),
124
+ })),
125
+ };
126
+ }
127
+ /** What makes two parts one library part: the same land pattern, pin list and value. */
128
+ export function partKey(part, pins) {
129
+ return JSON.stringify([footprintFileOf(part, pins), pins.pins, part.value]);
130
+ }
131
+ /** A library part id from a footprint's library name: "Resistor_SMD:R_0603" is R_0603. */
132
+ export function baseId(footprint, value) {
133
+ const item = footprint.split(":").pop() || value || "part";
134
+ const id = item.replace(/[^A-Za-z0-9._-]/g, "_").replace(/^[^A-Za-z]+/, "").replace(/[^A-Za-z0-9]+$/, "").slice(0, 50);
135
+ return id === "" ? "part" : id;
136
+ }
137
+ /** The value as an id suffix: "10k" stays, "4.7 µF" is 4.7__F. */
138
+ export const valueSuffix = (value) => value.replace(/[^A-Za-z0-9._-]/g, "_").replace(/[^A-Za-z0-9]+$/, "").slice(0, 12);
139
+ //# sourceMappingURL=plan.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"plan.js","sourceRoot":"","sources":["../../../src/library/kicad/plan.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,30 @@
1
+ import type { BoardFromDrawing } from "../../engine/dxf/index.js";
2
+ import { KicadError } from "./board.js";
3
+ import { type KicadPour, type KicadTrack, type KicadVia } from "./copper.js";
4
+ import { type KicadPart } from "./footprints.js";
5
+ import { Tally } from "./tally.js";
6
+ export { KicadError };
7
+ export interface KicadBoard {
8
+ version: number;
9
+ board: BoardFromDrawing;
10
+ parts: KicadPart[];
11
+ /** Footprints that held only unplated holes, now board holes. */
12
+ holeOnly: string[];
13
+ tracks: KicadTrack[];
14
+ vias: KicadVia[];
15
+ pours: KicadPour[];
16
+ held: {
17
+ footprints: number;
18
+ segments: number;
19
+ arcs: number;
20
+ arcPieces: number;
21
+ vias: number;
22
+ zones: number;
23
+ nets: number;
24
+ };
25
+ left: Tally;
26
+ }
27
+ /** Reads a KiCad board's text; throws KicadError with a sentence for the person. */
28
+ export declare function readKicadBoard(text: string, options?: {
29
+ origin?: "centre" | "keep";
30
+ }): KicadBoard;
@@ -0,0 +1,105 @@
1
+ import { boardOf, checkHeader, copperLayers, edgeEntity, KicadError, onEdge } from "./board.js";
2
+ import { readCopper } from "./copper.js";
3
+ import { readFootprints } from "./footprints.js";
4
+ import { moved, tidy } from "./geometry.js";
5
+ import { children, head, isList, numberAt, readSexpr, SexprError, textAt } from "./sexpr.js";
6
+ import { Tally } from "./tally.js";
7
+ export { KicadError };
8
+ /** Top-level items that carry nothing copperflow keeps. */
9
+ const QUIET = new Set(["version", "generator", "generator_version", "general", "paper", "page", "title_block", "layers", "embedded_fonts", "embedded_files", "group", "generated", "uuid", "property", "net", "footprint", "segment", "arc", "via", "zone"]);
10
+ const GRAPHICS = new Set(["gr_line", "gr_arc", "gr_circle", "gr_rect", "gr_poly", "gr_curve", "gr_bezier"]);
11
+ const TEXTS = new Set(["gr_text", "gr_text_box", "table"]);
12
+ /** The board's (net 3 "GND") table, which files before KiCad 10 point to by number. */
13
+ function netTable(top) {
14
+ const table = new Map();
15
+ for (const net of children(top, "net")) {
16
+ const number = numberAt(net, 1);
17
+ const name = textAt(net, 2);
18
+ if (number !== undefined && name !== undefined)
19
+ table.set(number, name);
20
+ }
21
+ return table;
22
+ }
23
+ /** Edge.Cuts shapes and the tally of the other top-level items. */
24
+ function topLevel(top, tally) {
25
+ const edges = [];
26
+ const skipped = {};
27
+ for (const node of top.list.slice(1)) {
28
+ if (!isList(node))
29
+ continue;
30
+ const name = head(node) ?? "(list)";
31
+ if (GRAPHICS.has(name)) {
32
+ if (!onEdge(node))
33
+ tally.add("drawings");
34
+ else {
35
+ const entity = edgeEntity(node);
36
+ if (entity)
37
+ edges.push(entity);
38
+ else
39
+ skipped[name] = (skipped[name] ?? 0) + 1;
40
+ }
41
+ }
42
+ else if (TEXTS.has(name))
43
+ tally.add("texts");
44
+ else if (name === "dimension")
45
+ tally.add("dimensions");
46
+ else if (name === "setup" || name === "net_class")
47
+ tally.add("rules");
48
+ else if (!QUIET.has(name))
49
+ tally.skip(name);
50
+ }
51
+ return { edges, skipped };
52
+ }
53
+ const movedPart = (part, offset) => ({
54
+ ...part,
55
+ at: moved(part.at, offset),
56
+ pads: part.pads.map((pad) => ({ ...pad, world: moved(pad.world, offset) })),
57
+ });
58
+ /** The nets the file names, counted once each: those its pads, tracks, vias and zones use. */
59
+ function netCount(parts, copper) {
60
+ const names = new Set();
61
+ for (const part of parts)
62
+ for (const pad of part.pads)
63
+ if (pad.net)
64
+ names.add(pad.net);
65
+ for (const item of [...copper.tracks, ...copper.vias, ...copper.pours])
66
+ if (item.net)
67
+ names.add(item.net);
68
+ return names.size;
69
+ }
70
+ /** Reads a KiCad board's text; throws KicadError with a sentence for the person. */
71
+ export function readKicadBoard(text, options = {}) {
72
+ let top;
73
+ try {
74
+ top = readSexpr(text);
75
+ }
76
+ catch (error) {
77
+ if (error instanceof SexprError)
78
+ throw new KicadError(`This is not a KiCad board, or it is damaged: ${error.message}`);
79
+ throw error;
80
+ }
81
+ const version = checkHeader(top);
82
+ copperLayers(top);
83
+ const tally = new Tally();
84
+ const nets = netTable(top);
85
+ const { edges, skipped } = topLevel(top, tally);
86
+ const footprints = readFootprints(top, nets, tally);
87
+ const copper = readCopper(top, footprints.zones, nets, tally);
88
+ const board = boardOf([...edges, ...footprints.edges], skipped, options.origin);
89
+ for (const line of board.notUsed)
90
+ tally.add("edgeLeft", Number(/^\d+/.exec(line)?.[0] ?? 1), line);
91
+ const offset = board.offset;
92
+ const holes = footprints.holes.map((hole) => ({ ...moved(hole, offset), diameter: tidy(hole.diameter) }));
93
+ return {
94
+ version,
95
+ board: { ...board, holes: [...board.holes, ...holes], keepouts: [...board.keepouts, ...copper.keepouts.map((k) => k.map((p) => moved(p, offset)))] },
96
+ parts: footprints.parts.map((part) => movedPart(part, offset)),
97
+ holeOnly: footprints.holeOnly,
98
+ tracks: copper.tracks.map((t) => ({ ...t, points: t.points.map((p) => moved(p, offset)) })),
99
+ vias: copper.vias.map((v) => ({ ...v, at: moved(v.at, offset) })),
100
+ pours: copper.pours.map((p) => ({ ...p, outline: p.outline.map((q) => moved(q, offset)) })),
101
+ held: { footprints: children(top, "footprint").length, ...copper.held, nets: netCount(footprints.parts, copper) },
102
+ left: tally,
103
+ };
104
+ }
105
+ //# sourceMappingURL=read.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"read.js","sourceRoot":"","sources":["../../../src/library/kicad/read.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,36 @@
1
+ /** A symbol, a number or a string as written; `quoted` for a string. */
2
+ export interface SAtom {
3
+ atom: string;
4
+ quoted: boolean;
5
+ }
6
+ export interface SList {
7
+ list: SNode[];
8
+ /** The line the list opened on. */
9
+ line: number;
10
+ }
11
+ export type SNode = SAtom | SList;
12
+ export declare class SexprError extends Error {
13
+ }
14
+ /** The deepest nesting read; KiCad's boards nest about a dozen lists deep. */
15
+ export declare const MAX_DEPTH = 100;
16
+ /** The most atoms and lists read: far beyond a board of thousands of parts. */
17
+ export declare const MAX_NODES = 8000000;
18
+ /** Reads the file's one top-level list. */
19
+ export declare function readSexpr(text: string): SList;
20
+ export declare const isList: (node: SNode | undefined) => node is SList;
21
+ /** The text of an atom; undefined for a list or nothing. */
22
+ export declare function atomText(node: SNode | undefined): string | undefined;
23
+ /** The symbol a list starts with, e.g. "footprint"; undefined when it starts with a list or a string. */
24
+ export declare function head(list: SList): string | undefined;
25
+ /** The lists inside `list` that start with `name`. */
26
+ export declare function children(list: SList, name: string): SList[];
27
+ /** The first list inside `list` that starts with `name`. */
28
+ export declare function child(list: SList, name: string): SList | undefined;
29
+ /** The number at `index` of a list; undefined when it is missing, quoted or not a number. */
30
+ export declare function numberAt(list: SList | undefined, index: number): number | undefined;
31
+ /** The text of the atom at `index`, quoted or not. */
32
+ export declare function textAt(list: SList | undefined, index: number): string | undefined;
33
+ /** The texts of every atom after the head, e.g. the names in (layers "F.Cu" "B.Cu"). */
34
+ export declare function texts(list: SList | undefined): string[];
35
+ /** The yes/no value of a child such as (hide yes), or a bare flag such as `hide` in older files. */
36
+ export declare function flag(list: SList, name: string): boolean;
@@ -0,0 +1,153 @@
1
+ // A reader for the s-expression text KiCad saves its boards in, written from the format's public description: lists in
2
+ // brackets, symbols and numbers separated by white space, strings in double quotes with backslash escapes. A line whose
3
+ // first character (after spaces) is `#` is a comment, so a person can note why a hand-written file is as it is.
4
+ // Iterative, with limits, so a huge or hostile file cannot run the program out of stack or memory.
5
+ export class SexprError extends Error {
6
+ }
7
+ /** The deepest nesting read; KiCad's boards nest about a dozen lists deep. */
8
+ export const MAX_DEPTH = 100;
9
+ /** The most atoms and lists read: far beyond a board of thousands of parts. */
10
+ export const MAX_NODES = 8_000_000;
11
+ const ESCAPES = { n: "\n", t: "\t", r: "\r", "\\": "\\", '"': '"' };
12
+ const isSpace = (c) => c === " " || c === "\t" || c === "\n" || c === "\r" || c === "\f";
13
+ /** Reads one quoted string starting at `start` (the quote); answers its text and the index after the closing quote. */
14
+ function readString(text, start, line) {
15
+ let value = "";
16
+ let lines = 0;
17
+ for (let i = start + 1; i < text.length; i++) {
18
+ const c = text[i];
19
+ if (c === '"')
20
+ return { value, end: i + 1, lines };
21
+ if (c === "\\" && i + 1 < text.length) {
22
+ const next = text[++i];
23
+ value += ESCAPES[next] ?? next;
24
+ continue;
25
+ }
26
+ if (c === "\n")
27
+ lines++;
28
+ value += c;
29
+ }
30
+ throw new SexprError(`A string opened on line ${line} is not closed`);
31
+ }
32
+ /** Whether the line starting at `i` (after its spaces) is a comment line. */
33
+ function commentEnd(text, i, atLineStart) {
34
+ if (!atLineStart || text[i] !== "#")
35
+ return undefined;
36
+ const end = text.indexOf("\n", i);
37
+ return end < 0 ? text.length : end;
38
+ }
39
+ /** Reads the file's one top-level list. */
40
+ export function readSexpr(text) {
41
+ const stack = [];
42
+ let top;
43
+ let line = 1;
44
+ let atLineStart = true;
45
+ let nodes = 0;
46
+ const add = (node) => {
47
+ if (++nodes > MAX_NODES)
48
+ throw new SexprError(`The file has more than ${MAX_NODES} items, more than copperflow reads`);
49
+ const parent = stack[stack.length - 1];
50
+ if (parent)
51
+ parent.list.push(node);
52
+ else if (top)
53
+ throw new SexprError(`Line ${line} has more after the end of the file's list`);
54
+ else
55
+ throw new SexprError("The file does not start with a list");
56
+ };
57
+ for (let i = 0; i < text.length;) {
58
+ const c = text[i];
59
+ if (isSpace(c)) {
60
+ if (c === "\n") {
61
+ line++;
62
+ atLineStart = true;
63
+ }
64
+ i++;
65
+ continue;
66
+ }
67
+ const comment = commentEnd(text, i, atLineStart);
68
+ if (comment !== undefined) {
69
+ i = comment;
70
+ continue;
71
+ }
72
+ atLineStart = false;
73
+ if (c === "(") {
74
+ if (top && stack.length === 0)
75
+ throw new SexprError(`Line ${line} has more after the end of the file's list`);
76
+ if (stack.length >= MAX_DEPTH)
77
+ throw new SexprError(`Line ${line} is nested deeper than ${MAX_DEPTH} lists, more than a board has`);
78
+ const list = { list: [], line };
79
+ if (stack.length > 0)
80
+ add(list);
81
+ else
82
+ top = list;
83
+ stack.push(list);
84
+ i++;
85
+ }
86
+ else if (c === ")") {
87
+ if (stack.length === 0)
88
+ throw new SexprError(`Line ${line} closes a list that was never opened`);
89
+ stack.pop();
90
+ i++;
91
+ }
92
+ else if (c === '"') {
93
+ const read = readString(text, i, line);
94
+ add({ atom: read.value, quoted: true });
95
+ line += read.lines;
96
+ i = read.end;
97
+ }
98
+ else {
99
+ let end = i;
100
+ while (end < text.length && !isSpace(text[end]) && text[end] !== "(" && text[end] !== ")" && text[end] !== '"')
101
+ end++;
102
+ add({ atom: text.slice(i, end), quoted: false });
103
+ i = end;
104
+ }
105
+ }
106
+ if (stack.length > 0)
107
+ throw new SexprError(`The file ends before every list is closed: the list opened on line ${stack[stack.length - 1].line} is not closed`);
108
+ if (!top)
109
+ throw new SexprError(text.trim() === "" ? "The file is empty" : "The file does not start with a list");
110
+ return top;
111
+ }
112
+ export const isList = (node) => node !== undefined && "list" in node;
113
+ /** The text of an atom; undefined for a list or nothing. */
114
+ export function atomText(node) {
115
+ return node !== undefined && "atom" in node ? node.atom : undefined;
116
+ }
117
+ /** The symbol a list starts with, e.g. "footprint"; undefined when it starts with a list or a string. */
118
+ export function head(list) {
119
+ const first = list.list[0];
120
+ return first !== undefined && "atom" in first && !first.quoted ? first.atom : undefined;
121
+ }
122
+ /** The lists inside `list` that start with `name`. */
123
+ export function children(list, name) {
124
+ return list.list.filter((node) => isList(node) && head(node) === name);
125
+ }
126
+ /** The first list inside `list` that starts with `name`. */
127
+ export function child(list, name) {
128
+ return list.list.find((node) => isList(node) && head(node) === name);
129
+ }
130
+ /** The number at `index` of a list; undefined when it is missing, quoted or not a number. */
131
+ export function numberAt(list, index) {
132
+ const node = list?.list[index];
133
+ if (node === undefined || !("atom" in node) || node.quoted || node.atom === "")
134
+ return undefined;
135
+ const value = Number(node.atom);
136
+ return Number.isFinite(value) ? value : undefined;
137
+ }
138
+ /** The text of the atom at `index`, quoted or not. */
139
+ export function textAt(list, index) {
140
+ return atomText(list?.list[index]);
141
+ }
142
+ /** The texts of every atom after the head, e.g. the names in (layers "F.Cu" "B.Cu"). */
143
+ export function texts(list) {
144
+ return (list?.list.slice(1) ?? []).flatMap((node) => ("atom" in node ? [node.atom] : []));
145
+ }
146
+ /** The yes/no value of a child such as (hide yes), or a bare flag such as `hide` in older files. */
147
+ export function flag(list, name) {
148
+ const found = child(list, name);
149
+ if (found)
150
+ return textAt(found, 1) !== "no";
151
+ return list.list.some((node) => "atom" in node && !node.quoted && node.atom === name);
152
+ }
153
+ //# sourceMappingURL=sexpr.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sexpr.js","sourceRoot":"","sources":["../../../src/library/kicad/sexpr.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,32 @@
1
+ export declare const LEFT_KINDS: {
2
+ readonly drawings: "silkscreen and fabrication drawings";
3
+ readonly texts: "texts";
4
+ readonly dimensions: "dimensions";
5
+ readonly models: "3D models";
6
+ readonly rules: "net classes and design rules";
7
+ readonly keepouts: "keepout zones with rules copperflow has no like for (kept clear on every layer instead)";
8
+ readonly teardrops: "teardrops";
9
+ readonly approximated: "pads with a shape copperflow does not draw, drawn as the nearest shape it has";
10
+ readonly innerTracks: "tracks on inner layers";
11
+ readonly innerVias: "vias that do not join the top and the bottom";
12
+ readonly farPads: "pads on the far side of their part (left out)";
13
+ readonly emptyZones: "copper zones on no net";
14
+ readonly unnamedPours: "pours on a connection without a name (left out)";
15
+ readonly otherZones: "zones on no copper layer";
16
+ readonly edgeLeft: "Edge.Cuts shapes not used for the board";
17
+ readonly padless: "footprints without copper pads (logos and drawings)";
18
+ readonly locked: "locks (copperflow's locks are set by a person in copperflow)";
19
+ };
20
+ export type LeftKind = keyof typeof LEFT_KINDS;
21
+ export declare class Tally {
22
+ readonly counts: Map<"approximated" | "dimensions" | "drawings" | "edgeLeft" | "emptyZones" | "farPads" | "innerTracks" | "innerVias" | "keepouts" | "locked" | "models" | "otherZones" | "padless" | "rules" | "teardrops" | "texts" | "unnamedPours", number>;
23
+ readonly details: Map<"approximated" | "dimensions" | "drawings" | "edgeLeft" | "emptyZones" | "farPads" | "innerTracks" | "innerVias" | "keepouts" | "locked" | "models" | "otherZones" | "padless" | "rules" | "teardrops" | "texts" | "unnamedPours", string[]>;
24
+ readonly unknown: Map<string, number>;
25
+ add(kind: LeftKind, n?: number, detail?: string): void;
26
+ /** A token the reader does not know, counted by name. */
27
+ skip(token: string): void;
28
+ /** "12 silkscreen and fabrication drawings", …, then "not understood: 2 (foo), 1 (bar)"; one line each. */
29
+ lines(): string[];
30
+ }
31
+ /** Up to 20 items, then how many more. */
32
+ export declare function listed(items: readonly string[]): string;
@@ -0,0 +1,55 @@
1
+ // What an import of a KiCad board did not bring over, by kind and count, so the answer can say it: nothing is dropped
2
+ // silently. The kinds are the words the answer uses.
3
+ export const LEFT_KINDS = {
4
+ drawings: "silkscreen and fabrication drawings",
5
+ texts: "texts",
6
+ dimensions: "dimensions",
7
+ models: "3D models",
8
+ rules: "net classes and design rules",
9
+ keepouts: "keepout zones with rules copperflow has no like for (kept clear on every layer instead)",
10
+ teardrops: "teardrops",
11
+ approximated: "pads with a shape copperflow does not draw, drawn as the nearest shape it has",
12
+ innerTracks: "tracks on inner layers",
13
+ innerVias: "vias that do not join the top and the bottom",
14
+ farPads: "pads on the far side of their part (left out)",
15
+ emptyZones: "copper zones on no net",
16
+ unnamedPours: "pours on a connection without a name (left out)",
17
+ otherZones: "zones on no copper layer",
18
+ edgeLeft: "Edge.Cuts shapes not used for the board",
19
+ padless: "footprints without copper pads (logos and drawings)",
20
+ locked: "locks (copperflow's locks are set by a person in copperflow)",
21
+ };
22
+ export class Tally {
23
+ counts = new Map();
24
+ details = new Map();
25
+ unknown = new Map();
26
+ add(kind, n = 1, detail) {
27
+ if (n <= 0)
28
+ return;
29
+ this.counts.set(kind, (this.counts.get(kind) ?? 0) + n);
30
+ if (detail !== undefined)
31
+ this.details.set(kind, [...(this.details.get(kind) ?? []), detail]);
32
+ }
33
+ /** A token the reader does not know, counted by name. */
34
+ skip(token) {
35
+ this.unknown.set(token, (this.unknown.get(token) ?? 0) + 1);
36
+ }
37
+ /** "12 silkscreen and fabrication drawings", …, then "not understood: 2 (foo), 1 (bar)"; one line each. */
38
+ lines() {
39
+ const known = Object.keys(LEFT_KINDS).flatMap((kind) => {
40
+ const n = this.counts.get(kind);
41
+ if (n === undefined)
42
+ return [];
43
+ const details = this.details.get(kind);
44
+ return [`${n} ${LEFT_KINDS[kind]}${details ? `: ${listed(details)}` : ""}`];
45
+ });
46
+ const unknown = [...this.unknown].sort(([a], [b]) => (a < b ? -1 : 1)).map(([token, n]) => `(${token}) ${n} time${n === 1 ? "" : "s"}`);
47
+ return [...known, ...(unknown.length > 0 ? [`not understood, skipped: ${unknown.join(", ")}`] : [])];
48
+ }
49
+ }
50
+ /** Up to 20 items, then how many more. */
51
+ export function listed(items) {
52
+ const shown = items.slice(0, 20).join(", ");
53
+ return items.length > 20 ? `${shown} … and ${items.length - 20} more` : shown;
54
+ }
55
+ //# sourceMappingURL=tally.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tally.js","sourceRoot":"","sources":["../../../src/library/kicad/tally.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,37 @@
1
+ import type { Author } from "../../core/history.js";
2
+ import { type PartPins, type PlannedNets } from "./plan.js";
3
+ import type { KicadBoard } from "./read.js";
4
+ export interface LibraryPart {
5
+ id: string;
6
+ key: string;
7
+ /** The designators that use it, in natural order (R2 before R10). */
8
+ used: string[];
9
+ /** The files of the part, project-relative; empty when the library already had it, exactly. */
10
+ files: {
11
+ file: string;
12
+ text: string;
13
+ }[];
14
+ written: boolean;
15
+ }
16
+ export interface PlannedImport {
17
+ /** Designator per part, in the board's order. */
18
+ names: string[];
19
+ pins: PartPins[];
20
+ nets: PlannedNets;
21
+ parts: LibraryPart[];
22
+ /** Library part id per part, in the board's order. */
23
+ partOf: string[];
24
+ circuit: string;
25
+ layout: string;
26
+ }
27
+ /** What the project's library already holds: each part id with its files' texts, to reuse or step around. */
28
+ export type Library = ReadonlyMap<string, ReadonlyMap<string, string>>;
29
+ /** Each file net with its pins as selectors (R1.pin2), each pin once, in the board's order. */
30
+ export declare function netPins(board: KicadBoard, names: readonly string[], pins: readonly PartPins[]): Map<string, string[]>;
31
+ /** Every text the import writes, planned against the library the project has. */
32
+ export declare function planImport(board: KicadBoard, options: {
33
+ source: string;
34
+ file: string;
35
+ library: Library;
36
+ author: Author;
37
+ }): PlannedImport;