copperflow 0.0.0-stage → 0.3.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 (767) hide show
  1. package/LICENSE +202 -0
  2. package/NOTICE +5 -0
  3. package/README.md +265 -2
  4. package/dist/app/THIRD_PARTY_LICENSES.txt +118 -0
  5. package/dist/app/assets/NewPartDialog-Qb7NwhBb.js +160 -0
  6. package/dist/app/assets/index-CSWIIMFE.css +1 -0
  7. package/dist/app/assets/index-C_TXwo-N.js +19 -0
  8. package/dist/app/index.html +15 -0
  9. package/dist/app/theme-boot.js +3 -0
  10. package/dist/cli-commands.d.ts +14 -0
  11. package/dist/cli-commands.js +285 -0
  12. package/dist/cli-commands.js.map +1 -0
  13. package/dist/cli.d.ts +2 -0
  14. package/dist/cli.js +24 -0
  15. package/dist/cli.js.map +1 -0
  16. package/dist/core/analyze.d.ts +29 -0
  17. package/dist/core/analyze.js +284 -0
  18. package/dist/core/analyze.js.map +1 -0
  19. package/dist/core/annotations.d.ts +77 -0
  20. package/dist/core/annotations.js +138 -0
  21. package/dist/core/annotations.js.map +1 -0
  22. package/dist/core/board-edits.d.ts +8 -0
  23. package/dist/core/board-edits.js +56 -0
  24. package/dist/core/board-edits.js.map +1 -0
  25. package/dist/core/board-items.d.ts +40 -0
  26. package/dist/core/board-items.js +95 -0
  27. package/dist/core/board-items.js.map +1 -0
  28. package/dist/core/bom.d.ts +35 -0
  29. package/dist/core/bom.js +146 -0
  30. package/dist/core/bom.js.map +1 -0
  31. package/dist/core/check.d.ts +42 -0
  32. package/dist/core/check.js +91 -0
  33. package/dist/core/check.js.map +1 -0
  34. package/dist/core/checks-line.d.ts +7 -0
  35. package/dist/core/checks-line.js +8 -0
  36. package/dist/core/checks-line.js.map +1 -0
  37. package/dist/core/connection-names.d.ts +2 -0
  38. package/dist/core/connection-names.js +16 -0
  39. package/dist/core/connection-names.js.map +1 -0
  40. package/dist/core/design-source.d.ts +6 -0
  41. package/dist/core/design-source.js +14 -0
  42. package/dist/core/design-source.js.map +1 -0
  43. package/dist/core/drawing-edits.d.ts +19 -0
  44. package/dist/core/drawing-edits.js +158 -0
  45. package/dist/core/drawing-edits.js.map +1 -0
  46. package/dist/core/drawing-identity.d.ts +12 -0
  47. package/dist/core/drawing-identity.js +32 -0
  48. package/dist/core/drawing-identity.js.map +1 -0
  49. package/dist/core/drawing-names.d.ts +10 -0
  50. package/dist/core/drawing-names.js +30 -0
  51. package/dist/core/drawing-names.js.map +1 -0
  52. package/dist/core/drawing-scan.d.ts +41 -0
  53. package/dist/core/drawing-scan.js +82 -0
  54. package/dist/core/drawing-scan.js.map +1 -0
  55. package/dist/core/edit-error.d.ts +5 -0
  56. package/dist/core/edit-error.js +9 -0
  57. package/dist/core/edit-error.js.map +1 -0
  58. package/dist/core/edit-text.d.ts +28 -0
  59. package/dist/core/edit-text.js +89 -0
  60. package/dist/core/edit-text.js.map +1 -0
  61. package/dist/core/edit.d.ts +13 -0
  62. package/dist/core/edit.js +341 -0
  63. package/dist/core/edit.js.map +1 -0
  64. package/dist/core/fabrication.d.ts +39 -0
  65. package/dist/core/fabrication.js +94 -0
  66. package/dist/core/fabrication.js.map +1 -0
  67. package/dist/core/file-writes.d.ts +18 -0
  68. package/dist/core/file-writes.js +81 -0
  69. package/dist/core/file-writes.js.map +1 -0
  70. package/dist/core/fs-utils.d.ts +13 -0
  71. package/dist/core/fs-utils.js +51 -0
  72. package/dist/core/fs-utils.js.map +1 -0
  73. package/dist/core/history.d.ts +80 -0
  74. package/dist/core/history.js +161 -0
  75. package/dist/core/history.js.map +1 -0
  76. package/dist/core/index.d.ts +21 -0
  77. package/dist/core/index.js +22 -0
  78. package/dist/core/index.js.map +1 -0
  79. package/dist/core/instance-edits.d.ts +15 -0
  80. package/dist/core/instance-edits.js +69 -0
  81. package/dist/core/instance-edits.js.map +1 -0
  82. package/dist/core/instance-locks.d.ts +10 -0
  83. package/dist/core/instance-locks.js +16 -0
  84. package/dist/core/instance-locks.js.map +1 -0
  85. package/dist/core/instance-requests.d.ts +45 -0
  86. package/dist/core/instance-requests.js +93 -0
  87. package/dist/core/instance-requests.js.map +1 -0
  88. package/dist/core/layout-edits.d.ts +51 -0
  89. package/dist/core/layout-edits.js +82 -0
  90. package/dist/core/layout-edits.js.map +1 -0
  91. package/dist/core/layout-file.d.ts +80 -0
  92. package/dist/core/layout-file.js +209 -0
  93. package/dist/core/layout-file.js.map +1 -0
  94. package/dist/core/layout-locks.d.ts +38 -0
  95. package/dist/core/layout-locks.js +39 -0
  96. package/dist/core/layout-locks.js.map +1 -0
  97. package/dist/core/layout-records.d.ts +72 -0
  98. package/dist/core/layout-records.js +146 -0
  99. package/dist/core/layout-records.js.map +1 -0
  100. package/dist/core/library.d.ts +128 -0
  101. package/dist/core/library.js +378 -0
  102. package/dist/core/library.js.map +1 -0
  103. package/dist/core/literals.d.ts +19 -0
  104. package/dist/core/literals.js +106 -0
  105. package/dist/core/literals.js.map +1 -0
  106. package/dist/core/make-sheet.d.ts +44 -0
  107. package/dist/core/make-sheet.js +130 -0
  108. package/dist/core/make-sheet.js.map +1 -0
  109. package/dist/core/netlist.d.ts +41 -0
  110. package/dist/core/netlist.js +147 -0
  111. package/dist/core/netlist.js.map +1 -0
  112. package/dist/core/new-circuit-sheets.d.ts +35 -0
  113. package/dist/core/new-circuit-sheets.js +146 -0
  114. package/dist/core/new-circuit-sheets.js.map +1 -0
  115. package/dist/core/new-circuit.d.ts +65 -0
  116. package/dist/core/new-circuit.js +83 -0
  117. package/dist/core/new-circuit.js.map +1 -0
  118. package/dist/core/page-edits.d.ts +25 -0
  119. package/dist/core/page-edits.js +180 -0
  120. package/dist/core/page-edits.js.map +1 -0
  121. package/dist/core/pin-types.d.ts +8 -0
  122. package/dist/core/pin-types.js +10 -0
  123. package/dist/core/pin-types.js.map +1 -0
  124. package/dist/core/place.d.ts +30 -0
  125. package/dist/core/place.js +77 -0
  126. package/dist/core/place.js.map +1 -0
  127. package/dist/core/placement-write.d.ts +56 -0
  128. package/dist/core/placement-write.js +222 -0
  129. package/dist/core/placement-write.js.map +1 -0
  130. package/dist/core/pour-edits.d.ts +20 -0
  131. package/dist/core/pour-edits.js +241 -0
  132. package/dist/core/pour-edits.js.map +1 -0
  133. package/dist/core/project-text.d.ts +15 -0
  134. package/dist/core/project-text.js +58 -0
  135. package/dist/core/project-text.js.map +1 -0
  136. package/dist/core/project.d.ts +23 -0
  137. package/dist/core/project.js +63 -0
  138. package/dist/core/project.js.map +1 -0
  139. package/dist/core/rename-designators.d.ts +23 -0
  140. package/dist/core/rename-designators.js +83 -0
  141. package/dist/core/rename-designators.js.map +1 -0
  142. package/dist/core/rename-parts.d.ts +12 -0
  143. package/dist/core/rename-parts.js +129 -0
  144. package/dist/core/rename-parts.js.map +1 -0
  145. package/dist/core/rules-edit.d.ts +7 -0
  146. package/dist/core/rules-edit.js +56 -0
  147. package/dist/core/rules-edit.js.map +1 -0
  148. package/dist/core/selectors.d.ts +11 -0
  149. package/dist/core/selectors.js +33 -0
  150. package/dist/core/selectors.js.map +1 -0
  151. package/dist/core/sheet-cut-layout.d.ts +13 -0
  152. package/dist/core/sheet-cut-layout.js +62 -0
  153. package/dist/core/sheet-cut-layout.js.map +1 -0
  154. package/dist/core/sheet-cut-text.d.ts +23 -0
  155. package/dist/core/sheet-cut-text.js +129 -0
  156. package/dist/core/sheet-cut-text.js.map +1 -0
  157. package/dist/core/sheet-cut.d.ts +55 -0
  158. package/dist/core/sheet-cut.js +204 -0
  159. package/dist/core/sheet-cut.js.map +1 -0
  160. package/dist/core/sheet-edits.d.ts +12 -0
  161. package/dist/core/sheet-edits.js +107 -0
  162. package/dist/core/sheet-edits.js.map +1 -0
  163. package/dist/core/sheet-files.d.ts +31 -0
  164. package/dist/core/sheet-files.js +134 -0
  165. package/dist/core/sheet-files.js.map +1 -0
  166. package/dist/core/sheet-layout.d.ts +27 -0
  167. package/dist/core/sheet-layout.js +60 -0
  168. package/dist/core/sheet-layout.js.map +1 -0
  169. package/dist/core/summary.d.ts +10 -0
  170. package/dist/core/summary.js +79 -0
  171. package/dist/core/summary.js.map +1 -0
  172. package/dist/core/track-split.d.ts +22 -0
  173. package/dist/core/track-split.js +24 -0
  174. package/dist/core/track-split.js.map +1 -0
  175. package/dist/core/types.d.ts +309 -0
  176. package/dist/core/types.js +2 -0
  177. package/dist/core/types.js.map +1 -0
  178. package/dist/core/unroute.d.ts +56 -0
  179. package/dist/core/unroute.js +87 -0
  180. package/dist/core/unroute.js.map +1 -0
  181. package/dist/core/workspace.d.ts +94 -0
  182. package/dist/core/workspace.js +376 -0
  183. package/dist/core/workspace.js.map +1 -0
  184. package/dist/engine/autoplace.d.ts +18 -0
  185. package/dist/engine/autoplace.js +68 -0
  186. package/dist/engine/autoplace.js.map +1 -0
  187. package/dist/engine/board.d.ts +12 -0
  188. package/dist/engine/board.js +60 -0
  189. package/dist/engine/board.js.map +1 -0
  190. package/dist/engine/checks/copper-clearance.d.ts +7 -0
  191. package/dist/engine/checks/copper-clearance.js +116 -0
  192. package/dist/engine/checks/copper-clearance.js.map +1 -0
  193. package/dist/engine/checks/copper-notes.d.ts +11 -0
  194. package/dist/engine/checks/copper-notes.js +17 -0
  195. package/dist/engine/checks/copper-notes.js.map +1 -0
  196. package/dist/engine/checks/copper-pieces.d.ts +26 -0
  197. package/dist/engine/checks/copper-pieces.js +42 -0
  198. package/dist/engine/checks/copper-pieces.js.map +1 -0
  199. package/dist/engine/checks/copper-violation.d.ts +9 -0
  200. package/dist/engine/checks/copper-violation.js +11 -0
  201. package/dist/engine/checks/copper-violation.js.map +1 -0
  202. package/dist/engine/checks/drc-copper.d.ts +14 -0
  203. package/dist/engine/checks/drc-copper.js +139 -0
  204. package/dist/engine/checks/drc-copper.js.map +1 -0
  205. package/dist/engine/checks/drc-pads.d.ts +8 -0
  206. package/dist/engine/checks/drc-pads.js +172 -0
  207. package/dist/engine/checks/drc-pads.js.map +1 -0
  208. package/dist/engine/checks/drc-parts.d.ts +5 -0
  209. package/dist/engine/checks/drc-parts.js +208 -0
  210. package/dist/engine/checks/drc-parts.js.map +1 -0
  211. package/dist/engine/checks/drc-pours.d.ts +6 -0
  212. package/dist/engine/checks/drc-pours.js +240 -0
  213. package/dist/engine/checks/drc-pours.js.map +1 -0
  214. package/dist/engine/checks/erc.d.ts +6 -0
  215. package/dist/engine/checks/erc.js +94 -0
  216. package/dist/engine/checks/erc.js.map +1 -0
  217. package/dist/engine/checks/fillet-guard.d.ts +29 -0
  218. package/dist/engine/checks/fillet-guard.js +75 -0
  219. package/dist/engine/checks/fillet-guard.js.map +1 -0
  220. package/dist/engine/checks/geometry.d.ts +25 -0
  221. package/dist/engine/checks/geometry.js +182 -0
  222. package/dist/engine/checks/geometry.js.map +1 -0
  223. package/dist/engine/checks/grid-index.d.ts +24 -0
  224. package/dist/engine/checks/grid-index.js +57 -0
  225. package/dist/engine/checks/grid-index.js.map +1 -0
  226. package/dist/engine/checks/index.d.ts +16 -0
  227. package/dist/engine/checks/index.js +55 -0
  228. package/dist/engine/checks/index.js.map +1 -0
  229. package/dist/engine/checks/limits.d.ts +7 -0
  230. package/dist/engine/checks/limits.js +10 -0
  231. package/dist/engine/checks/limits.js.map +1 -0
  232. package/dist/engine/checks/unplaced-parts.d.ts +4 -0
  233. package/dist/engine/checks/unplaced-parts.js +29 -0
  234. package/dist/engine/checks/unplaced-parts.js.map +1 -0
  235. package/dist/engine/checks/violation.d.ts +14 -0
  236. package/dist/engine/checks/violation.js +7 -0
  237. package/dist/engine/checks/violation.js.map +1 -0
  238. package/dist/engine/component.d.ts +34 -0
  239. package/dist/engine/component.js +125 -0
  240. package/dist/engine/component.js.map +1 -0
  241. package/dist/engine/copper.d.ts +63 -0
  242. package/dist/engine/copper.js +276 -0
  243. package/dist/engine/copper.js.map +1 -0
  244. package/dist/engine/design.d.ts +21 -0
  245. package/dist/engine/design.js +63 -0
  246. package/dist/engine/design.js.map +1 -0
  247. package/dist/engine/diagnostics.d.ts +2 -0
  248. package/dist/engine/diagnostics.js +6 -0
  249. package/dist/engine/diagnostics.js.map +1 -0
  250. package/dist/engine/drawing-ids.d.ts +23 -0
  251. package/dist/engine/drawing-ids.js +45 -0
  252. package/dist/engine/drawing-ids.js.map +1 -0
  253. package/dist/engine/drawing-kinds.d.ts +18 -0
  254. package/dist/engine/drawing-kinds.js +102 -0
  255. package/dist/engine/drawing-kinds.js.map +1 -0
  256. package/dist/engine/drawing-reader.d.ts +42 -0
  257. package/dist/engine/drawing-reader.js +97 -0
  258. package/dist/engine/drawing-reader.js.map +1 -0
  259. package/dist/engine/drawings.d.ts +35 -0
  260. package/dist/engine/drawings.js +94 -0
  261. package/dist/engine/drawings.js.map +1 -0
  262. package/dist/engine/elaborate.d.ts +8 -0
  263. package/dist/engine/elaborate.js +490 -0
  264. package/dist/engine/elaborate.js.map +1 -0
  265. package/dist/engine/engine-worker.d.ts +1 -0
  266. package/dist/engine/engine-worker.js +17 -0
  267. package/dist/engine/engine-worker.js.map +1 -0
  268. package/dist/engine/engine.d.ts +41 -0
  269. package/dist/engine/engine.js +95 -0
  270. package/dist/engine/engine.js.map +1 -0
  271. package/dist/engine/evaluate.d.ts +10 -0
  272. package/dist/engine/evaluate.js +125 -0
  273. package/dist/engine/evaluate.js.map +1 -0
  274. package/dist/engine/fab/bom-csv.d.ts +5 -0
  275. package/dist/engine/fab/bom-csv.js +16 -0
  276. package/dist/engine/fab/bom-csv.js.map +1 -0
  277. package/dist/engine/fab/csv.d.ts +4 -0
  278. package/dist/engine/fab/csv.js +11 -0
  279. package/dist/engine/fab/csv.js.map +1 -0
  280. package/dist/engine/fab/designators.d.ts +42 -0
  281. package/dist/engine/fab/designators.js +109 -0
  282. package/dist/engine/fab/designators.js.map +1 -0
  283. package/dist/engine/fab/excellon.d.ts +23 -0
  284. package/dist/engine/fab/excellon.js +82 -0
  285. package/dist/engine/fab/excellon.js.map +1 -0
  286. package/dist/engine/fab/export.d.ts +33 -0
  287. package/dist/engine/fab/export.js +105 -0
  288. package/dist/engine/fab/export.js.map +1 -0
  289. package/dist/engine/fab/gerber.d.ts +53 -0
  290. package/dist/engine/fab/gerber.js +151 -0
  291. package/dist/engine/fab/gerber.js.map +1 -0
  292. package/dist/engine/fab/layers.d.ts +26 -0
  293. package/dist/engine/fab/layers.js +162 -0
  294. package/dist/engine/fab/layers.js.map +1 -0
  295. package/dist/engine/fab/names.d.ts +20 -0
  296. package/dist/engine/fab/names.js +58 -0
  297. package/dist/engine/fab/names.js.map +1 -0
  298. package/dist/engine/fab/pick-and-place.d.ts +5 -0
  299. package/dist/engine/fab/pick-and-place.js +36 -0
  300. package/dist/engine/fab/pick-and-place.js.map +1 -0
  301. package/dist/engine/fab/stroke-font.d.ts +8 -0
  302. package/dist/engine/fab/stroke-font.js +83 -0
  303. package/dist/engine/fab/stroke-font.js.map +1 -0
  304. package/dist/engine/fab/zip.d.ts +14 -0
  305. package/dist/engine/fab/zip.js +93 -0
  306. package/dist/engine/fab/zip.js.map +1 -0
  307. package/dist/engine/fillet-plan.d.ts +39 -0
  308. package/dist/engine/fillet-plan.js +87 -0
  309. package/dist/engine/fillet-plan.js.map +1 -0
  310. package/dist/engine/fillet.d.ts +54 -0
  311. package/dist/engine/fillet.js +175 -0
  312. package/dist/engine/fillet.js.map +1 -0
  313. package/dist/engine/footprints/bga.d.ts +14 -0
  314. package/dist/engine/footprints/bga.js +122 -0
  315. package/dist/engine/footprints/bga.js.map +1 -0
  316. package/dist/engine/footprints/chip.d.ts +3 -0
  317. package/dist/engine/footprints/chip.js +52 -0
  318. package/dist/engine/footprints/chip.js.map +1 -0
  319. package/dist/engine/footprints/crystal.d.ts +4 -0
  320. package/dist/engine/footprints/crystal.js +47 -0
  321. package/dist/engine/footprints/crystal.js.map +1 -0
  322. package/dist/engine/footprints/dfn.d.ts +13 -0
  323. package/dist/engine/footprints/dfn.js +52 -0
  324. package/dist/engine/footprints/dfn.js.map +1 -0
  325. package/dist/engine/footprints/dip.d.ts +8 -0
  326. package/dist/engine/footprints/dip.js +65 -0
  327. package/dist/engine/footprints/dip.js.map +1 -0
  328. package/dist/engine/footprints/dual.d.ts +14 -0
  329. package/dist/engine/footprints/dual.js +171 -0
  330. package/dist/engine/footprints/dual.js.map +1 -0
  331. package/dist/engine/footprints/exposed.d.ts +27 -0
  332. package/dist/engine/footprints/exposed.js +50 -0
  333. package/dist/engine/footprints/exposed.js.map +1 -0
  334. package/dist/engine/footprints/file.d.ts +65 -0
  335. package/dist/engine/footprints/file.js +141 -0
  336. package/dist/engine/footprints/file.js.map +1 -0
  337. package/dist/engine/footprints/ic.d.ts +34 -0
  338. package/dist/engine/footprints/ic.js +31 -0
  339. package/dist/engine/footprints/ic.js.map +1 -0
  340. package/dist/engine/footprints/index.d.ts +17 -0
  341. package/dist/engine/footprints/index.js +104 -0
  342. package/dist/engine/footprints/index.js.map +1 -0
  343. package/dist/engine/footprints/ipc7251.d.ts +30 -0
  344. package/dist/engine/footprints/ipc7251.js +44 -0
  345. package/dist/engine/footprints/ipc7251.js.map +1 -0
  346. package/dist/engine/footprints/ipc7351.d.ts +179 -0
  347. package/dist/engine/footprints/ipc7351.js +194 -0
  348. package/dist/engine/footprints/ipc7351.js.map +1 -0
  349. package/dist/engine/footprints/jedec.d.ts +24 -0
  350. package/dist/engine/footprints/jedec.js +148 -0
  351. package/dist/engine/footprints/jedec.js.map +1 -0
  352. package/dist/engine/footprints/known.d.ts +6 -0
  353. package/dist/engine/footprints/known.js +76 -0
  354. package/dist/engine/footprints/known.js.map +1 -0
  355. package/dist/engine/footprints/molded.d.ts +8 -0
  356. package/dist/engine/footprints/molded.js +76 -0
  357. package/dist/engine/footprints/molded.js.map +1 -0
  358. package/dist/engine/footprints/outline.d.ts +64 -0
  359. package/dist/engine/footprints/outline.js +187 -0
  360. package/dist/engine/footprints/outline.js.map +1 -0
  361. package/dist/engine/footprints/parse.d.ts +32 -0
  362. package/dist/engine/footprints/parse.js +68 -0
  363. package/dist/engine/footprints/parse.js.map +1 -0
  364. package/dist/engine/footprints/pinrow.d.ts +11 -0
  365. package/dist/engine/footprints/pinrow.js +102 -0
  366. package/dist/engine/footprints/pinrow.js.map +1 -0
  367. package/dist/engine/footprints/quad.d.ts +7 -0
  368. package/dist/engine/footprints/quad.js +135 -0
  369. package/dist/engine/footprints/quad.js.map +1 -0
  370. package/dist/engine/footprints/radial.d.ts +7 -0
  371. package/dist/engine/footprints/radial.js +62 -0
  372. package/dist/engine/footprints/radial.js.map +1 -0
  373. package/dist/engine/footprints/sod.d.ts +8 -0
  374. package/dist/engine/footprints/sod.js +60 -0
  375. package/dist/engine/footprints/sod.js.map +1 -0
  376. package/dist/engine/footprints/sot.d.ts +4 -0
  377. package/dist/engine/footprints/sot.js +72 -0
  378. package/dist/engine/footprints/sot.js.map +1 -0
  379. package/dist/engine/footprints/sotpower.d.ts +4 -0
  380. package/dist/engine/footprints/sotpower.js +98 -0
  381. package/dist/engine/footprints/sotpower.js.map +1 -0
  382. package/dist/engine/footprints/to220.d.ts +4 -0
  383. package/dist/engine/footprints/to220.js +49 -0
  384. package/dist/engine/footprints/to220.js.map +1 -0
  385. package/dist/engine/footprints/to92.d.ts +4 -0
  386. package/dist/engine/footprints/to92.js +43 -0
  387. package/dist/engine/footprints/to92.js.map +1 -0
  388. package/dist/engine/footprints/types.d.ts +50 -0
  389. package/dist/engine/footprints/types.js +3 -0
  390. package/dist/engine/footprints/types.js.map +1 -0
  391. package/dist/engine/hole.d.ts +15 -0
  392. package/dist/engine/hole.js +28 -0
  393. package/dist/engine/hole.js.map +1 -0
  394. package/dist/engine/index.d.ts +6 -0
  395. package/dist/engine/index.js +6 -0
  396. package/dist/engine/index.js.map +1 -0
  397. package/dist/engine/instance-anchor.d.ts +16 -0
  398. package/dist/engine/instance-anchor.js +45 -0
  399. package/dist/engine/instance-anchor.js.map +1 -0
  400. package/dist/engine/jsx-runtime.d.ts +26 -0
  401. package/dist/engine/jsx-runtime.js +49 -0
  402. package/dist/engine/jsx-runtime.js.map +1 -0
  403. package/dist/engine/keepout.d.ts +9 -0
  404. package/dist/engine/keepout.js +50 -0
  405. package/dist/engine/keepout.js.map +1 -0
  406. package/dist/engine/kinds.d.ts +34 -0
  407. package/dist/engine/kinds.js +134 -0
  408. package/dist/engine/kinds.js.map +1 -0
  409. package/dist/engine/model.d.ts +310 -0
  410. package/dist/engine/model.js +5 -0
  411. package/dist/engine/model.js.map +1 -0
  412. package/dist/engine/nets.d.ts +6 -0
  413. package/dist/engine/nets.js +49 -0
  414. package/dist/engine/nets.js.map +1 -0
  415. package/dist/engine/no-connect.d.ts +28 -0
  416. package/dist/engine/no-connect.js +36 -0
  417. package/dist/engine/no-connect.js.map +1 -0
  418. package/dist/engine/order.d.ts +7 -0
  419. package/dist/engine/order.js +25 -0
  420. package/dist/engine/order.js.map +1 -0
  421. package/dist/engine/pad-text.d.ts +20 -0
  422. package/dist/engine/pad-text.js +26 -0
  423. package/dist/engine/pad-text.js.map +1 -0
  424. package/dist/engine/part-labels.d.ts +29 -0
  425. package/dist/engine/part-labels.js +28 -0
  426. package/dist/engine/part-labels.js.map +1 -0
  427. package/dist/engine/pcb-place/blocks.d.ts +46 -0
  428. package/dist/engine/pcb-place/blocks.js +186 -0
  429. package/dist/engine/pcb-place/blocks.js.map +1 -0
  430. package/dist/engine/pcb-place/constructive.d.ts +73 -0
  431. package/dist/engine/pcb-place/constructive.js +515 -0
  432. package/dist/engine/pcb-place/constructive.js.map +1 -0
  433. package/dist/engine/pcb-place/edge.d.ts +7 -0
  434. package/dist/engine/pcb-place/edge.js +78 -0
  435. package/dist/engine/pcb-place/edge.js.map +1 -0
  436. package/dist/engine/pcb-place/fit-board.d.ts +22 -0
  437. package/dist/engine/pcb-place/fit-board.js +48 -0
  438. package/dist/engine/pcb-place/fit-board.js.map +1 -0
  439. package/dist/engine/pcb-place/geometry.d.ts +45 -0
  440. package/dist/engine/pcb-place/geometry.js +158 -0
  441. package/dist/engine/pcb-place/geometry.js.map +1 -0
  442. package/dist/engine/pcb-place/index.d.ts +81 -0
  443. package/dist/engine/pcb-place/index.js +98 -0
  444. package/dist/engine/pcb-place/index.js.map +1 -0
  445. package/dist/engine/pcb-place/refine.d.ts +32 -0
  446. package/dist/engine/pcb-place/refine.js +220 -0
  447. package/dist/engine/pcb-place/refine.js.map +1 -0
  448. package/dist/engine/pcb-place/roles.d.ts +37 -0
  449. package/dist/engine/pcb-place/roles.js +127 -0
  450. package/dist/engine/pcb-place/roles.js.map +1 -0
  451. package/dist/engine/pcb-place/scope.d.ts +80 -0
  452. package/dist/engine/pcb-place/scope.js +107 -0
  453. package/dist/engine/pcb-place/scope.js.map +1 -0
  454. package/dist/engine/pcb-place/score.d.ts +40 -0
  455. package/dist/engine/pcb-place/score.js +140 -0
  456. package/dist/engine/pcb-place/score.js.map +1 -0
  457. package/dist/engine/pcb.d.ts +72 -0
  458. package/dist/engine/pcb.js +153 -0
  459. package/dist/engine/pcb.js.map +1 -0
  460. package/dist/engine/pour/build.d.ts +32 -0
  461. package/dist/engine/pour/build.js +108 -0
  462. package/dist/engine/pour/build.js.map +1 -0
  463. package/dist/engine/pour/cache.d.ts +8 -0
  464. package/dist/engine/pour/cache.js +55 -0
  465. package/dist/engine/pour/cache.js.map +1 -0
  466. package/dist/engine/pour/clip.d.ts +50 -0
  467. package/dist/engine/pour/clip.js +72 -0
  468. package/dist/engine/pour/clip.js.map +1 -0
  469. package/dist/engine/pour/fill.d.ts +22 -0
  470. package/dist/engine/pour/fill.js +112 -0
  471. package/dist/engine/pour/fill.js.map +1 -0
  472. package/dist/engine/pour/islands.d.ts +8 -0
  473. package/dist/engine/pour/islands.js +19 -0
  474. package/dist/engine/pour/islands.js.map +1 -0
  475. package/dist/engine/pour/joins.d.ts +18 -0
  476. package/dist/engine/pour/joins.js +74 -0
  477. package/dist/engine/pour/joins.js.map +1 -0
  478. package/dist/engine/pour/obstacles.d.ts +45 -0
  479. package/dist/engine/pour/obstacles.js +85 -0
  480. package/dist/engine/pour/obstacles.js.map +1 -0
  481. package/dist/engine/pour/resolve.d.ts +21 -0
  482. package/dist/engine/pour/resolve.js +19 -0
  483. package/dist/engine/pour/resolve.js.map +1 -0
  484. package/dist/engine/pour/shapes.d.ts +9 -0
  485. package/dist/engine/pour/shapes.js +62 -0
  486. package/dist/engine/pour/shapes.js.map +1 -0
  487. package/dist/engine/pour/thermal.d.ts +16 -0
  488. package/dist/engine/pour/thermal.js +38 -0
  489. package/dist/engine/pour/thermal.js.map +1 -0
  490. package/dist/engine/project-files.d.ts +18 -0
  491. package/dist/engine/project-files.js +58 -0
  492. package/dist/engine/project-files.js.map +1 -0
  493. package/dist/engine/ratsnest.d.ts +16 -0
  494. package/dist/engine/ratsnest.js +69 -0
  495. package/dist/engine/ratsnest.js.map +1 -0
  496. package/dist/engine/read-props.d.ts +22 -0
  497. package/dist/engine/read-props.js +74 -0
  498. package/dist/engine/read-props.js.map +1 -0
  499. package/dist/engine/router/astar.d.ts +74 -0
  500. package/dist/engine/router/astar.js +231 -0
  501. package/dist/engine/router/astar.js.map +1 -0
  502. package/dist/engine/router/blockers.d.ts +4 -0
  503. package/dist/engine/router/blockers.js +69 -0
  504. package/dist/engine/router/blockers.js.map +1 -0
  505. package/dist/engine/router/cleanup.d.ts +21 -0
  506. package/dist/engine/router/cleanup.js +157 -0
  507. package/dist/engine/router/cleanup.js.map +1 -0
  508. package/dist/engine/router/clear.d.ts +18 -0
  509. package/dist/engine/router/clear.js +39 -0
  510. package/dist/engine/router/clear.js.map +1 -0
  511. package/dist/engine/router/congestion.d.ts +79 -0
  512. package/dist/engine/router/congestion.js +212 -0
  513. package/dist/engine/router/congestion.js.map +1 -0
  514. package/dist/engine/router/connect.d.ts +79 -0
  515. package/dist/engine/router/connect.js +174 -0
  516. package/dist/engine/router/connect.js.map +1 -0
  517. package/dist/engine/router/ends.d.ts +25 -0
  518. package/dist/engine/router/ends.js +135 -0
  519. package/dist/engine/router/ends.js.map +1 -0
  520. package/dist/engine/router/grid.d.ts +131 -0
  521. package/dist/engine/router/grid.js +297 -0
  522. package/dist/engine/router/grid.js.map +1 -0
  523. package/dist/engine/router/keep-clear.d.ts +10 -0
  524. package/dist/engine/router/keep-clear.js +60 -0
  525. package/dist/engine/router/keep-clear.js.map +1 -0
  526. package/dist/engine/router/obstacles.d.ts +18 -0
  527. package/dist/engine/router/obstacles.js +66 -0
  528. package/dist/engine/router/obstacles.js.map +1 -0
  529. package/dist/engine/router/path.d.ts +34 -0
  530. package/dist/engine/router/path.js +41 -0
  531. package/dist/engine/router/path.js.map +1 -0
  532. package/dist/engine/router/pour-rounds.d.ts +17 -0
  533. package/dist/engine/router/pour-rounds.js +124 -0
  534. package/dist/engine/router/pour-rounds.js.map +1 -0
  535. package/dist/engine/router/replicate.d.ts +32 -0
  536. package/dist/engine/router/replicate.js +143 -0
  537. package/dist/engine/router/replicate.js.map +1 -0
  538. package/dist/engine/router/rip-up.d.ts +5 -0
  539. package/dist/engine/router/rip-up.js +95 -0
  540. package/dist/engine/router/rip-up.js.map +1 -0
  541. package/dist/engine/router/route-board.d.ts +109 -0
  542. package/dist/engine/router/route-board.js +223 -0
  543. package/dist/engine/router/route-board.js.map +1 -0
  544. package/dist/engine/rules/classes.d.ts +14 -0
  545. package/dist/engine/rules/classes.js +50 -0
  546. package/dist/engine/rules/classes.js.map +1 -0
  547. package/dist/engine/rules/load.d.ts +14 -0
  548. package/dist/engine/rules/load.js +146 -0
  549. package/dist/engine/rules/load.js.map +1 -0
  550. package/dist/engine/rules/profiles.d.ts +5 -0
  551. package/dist/engine/rules/profiles.js +53 -0
  552. package/dist/engine/rules/profiles.js.map +1 -0
  553. package/dist/engine/rules/rotations.d.ts +31 -0
  554. package/dist/engine/rules/rotations.js +124 -0
  555. package/dist/engine/rules/rotations.js.map +1 -0
  556. package/dist/engine/rules/schema.d.ts +82 -0
  557. package/dist/engine/rules/schema.js +59 -0
  558. package/dist/engine/rules/schema.js.map +1 -0
  559. package/dist/engine/rules/track-defaults.d.ts +23 -0
  560. package/dist/engine/rules/track-defaults.js +26 -0
  561. package/dist/engine/rules/track-defaults.js.map +1 -0
  562. package/dist/engine/schematic-astar.d.ts +37 -0
  563. package/dist/engine/schematic-astar.js +202 -0
  564. package/dist/engine/schematic-astar.js.map +1 -0
  565. package/dist/engine/schematic-geometry.d.ts +23 -0
  566. package/dist/engine/schematic-geometry.js +49 -0
  567. package/dist/engine/schematic-geometry.js.map +1 -0
  568. package/dist/engine/schematic-grid.d.ts +60 -0
  569. package/dist/engine/schematic-grid.js +150 -0
  570. package/dist/engine/schematic-grid.js.map +1 -0
  571. package/dist/engine/schematic-nets.d.ts +38 -0
  572. package/dist/engine/schematic-nets.js +157 -0
  573. package/dist/engine/schematic-nets.js.map +1 -0
  574. package/dist/engine/schematic-pages.d.ts +9 -0
  575. package/dist/engine/schematic-pages.js +52 -0
  576. package/dist/engine/schematic-pages.js.map +1 -0
  577. package/dist/engine/schematic-place-chains.d.ts +22 -0
  578. package/dist/engine/schematic-place-chains.js +111 -0
  579. package/dist/engine/schematic-place-chains.js.map +1 -0
  580. package/dist/engine/schematic-place-plan.d.ts +43 -0
  581. package/dist/engine/schematic-place-plan.js +155 -0
  582. package/dist/engine/schematic-place-plan.js.map +1 -0
  583. package/dist/engine/schematic-place-units.d.ts +38 -0
  584. package/dist/engine/schematic-place-units.js +101 -0
  585. package/dist/engine/schematic-place-units.js.map +1 -0
  586. package/dist/engine/schematic-place.d.ts +5 -0
  587. package/dist/engine/schematic-place.js +268 -0
  588. package/dist/engine/schematic-place.js.map +1 -0
  589. package/dist/engine/schematic-route.d.ts +37 -0
  590. package/dist/engine/schematic-route.js +288 -0
  591. package/dist/engine/schematic-route.js.map +1 -0
  592. package/dist/engine/schematic-sheets.d.ts +22 -0
  593. package/dist/engine/schematic-sheets.js +104 -0
  594. package/dist/engine/schematic-sheets.js.map +1 -0
  595. package/dist/engine/schematic.d.ts +64 -0
  596. package/dist/engine/schematic.js +200 -0
  597. package/dist/engine/schematic.js.map +1 -0
  598. package/dist/engine/selectors.d.ts +25 -0
  599. package/dist/engine/selectors.js +28 -0
  600. package/dist/engine/selectors.js.map +1 -0
  601. package/dist/engine/sheet-ports.d.ts +44 -0
  602. package/dist/engine/sheet-ports.js +126 -0
  603. package/dist/engine/sheet-ports.js.map +1 -0
  604. package/dist/engine/sheet-symbol.d.ts +52 -0
  605. package/dist/engine/sheet-symbol.js +92 -0
  606. package/dist/engine/sheet-symbol.js.map +1 -0
  607. package/dist/engine/sheets.d.ts +79 -0
  608. package/dist/engine/sheets.js +159 -0
  609. package/dist/engine/sheets.js.map +1 -0
  610. package/dist/engine/symbols/box.d.ts +8 -0
  611. package/dist/engine/symbols/box.js +83 -0
  612. package/dist/engine/symbols/box.js.map +1 -0
  613. package/dist/engine/symbols/index.d.ts +8 -0
  614. package/dist/engine/symbols/index.js +58 -0
  615. package/dist/engine/symbols/index.js.map +1 -0
  616. package/dist/engine/symbols/passives.d.ts +16 -0
  617. package/dist/engine/symbols/passives.js +58 -0
  618. package/dist/engine/symbols/passives.js.map +1 -0
  619. package/dist/engine/symbols/power.d.ts +5 -0
  620. package/dist/engine/symbols/power.js +10 -0
  621. package/dist/engine/symbols/power.js.map +1 -0
  622. package/dist/engine/symbols/semis.d.ts +10 -0
  623. package/dist/engine/symbols/semis.js +62 -0
  624. package/dist/engine/symbols/semis.js.map +1 -0
  625. package/dist/engine/symbols/types.d.ts +83 -0
  626. package/dist/engine/symbols/types.js +61 -0
  627. package/dist/engine/symbols/types.js.map +1 -0
  628. package/dist/engine/traces.d.ts +29 -0
  629. package/dist/engine/traces.js +102 -0
  630. package/dist/engine/traces.js.map +1 -0
  631. package/dist/engine/units.d.ts +4 -0
  632. package/dist/engine/units.js +31 -0
  633. package/dist/engine/units.js.map +1 -0
  634. package/dist/engine/worker-env.d.ts +9 -0
  635. package/dist/engine/worker-env.js +12 -0
  636. package/dist/engine/worker-env.js.map +1 -0
  637. package/dist/library/attach-datasheet.d.ts +20 -0
  638. package/dist/library/attach-datasheet.js +61 -0
  639. package/dist/library/attach-datasheet.js.map +1 -0
  640. package/dist/library/easyeda-footprint.d.ts +41 -0
  641. package/dist/library/easyeda-footprint.js +255 -0
  642. package/dist/library/easyeda-footprint.js.map +1 -0
  643. package/dist/library/easyeda-path.d.ts +13 -0
  644. package/dist/library/easyeda-path.js +133 -0
  645. package/dist/library/easyeda-path.js.map +1 -0
  646. package/dist/library/easyeda-symbol.d.ts +20 -0
  647. package/dist/library/easyeda-symbol.js +53 -0
  648. package/dist/library/easyeda-symbol.js.map +1 -0
  649. package/dist/library/import-lcsc.d.ts +30 -0
  650. package/dist/library/import-lcsc.js +155 -0
  651. package/dist/library/import-lcsc.js.map +1 -0
  652. package/dist/library/lcsc-part.d.ts +40 -0
  653. package/dist/library/lcsc-part.js +153 -0
  654. package/dist/library/lcsc-part.js.map +1 -0
  655. package/dist/library/new-part.d.ts +50 -0
  656. package/dist/library/new-part.js +160 -0
  657. package/dist/library/new-part.js.map +1 -0
  658. package/dist/library/pin-table.d.ts +23 -0
  659. package/dist/library/pin-table.js +92 -0
  660. package/dist/library/pin-table.js.map +1 -0
  661. package/dist/mcp/batch.d.ts +111 -0
  662. package/dist/mcp/batch.js +241 -0
  663. package/dist/mcp/batch.js.map +1 -0
  664. package/dist/mcp/board-summary.d.ts +19 -0
  665. package/dist/mcp/board-summary.js +144 -0
  666. package/dist/mcp/board-summary.js.map +1 -0
  667. package/dist/mcp/compact-sheets.d.ts +31 -0
  668. package/dist/mcp/compact-sheets.js +63 -0
  669. package/dist/mcp/compact-sheets.js.map +1 -0
  670. package/dist/mcp/compact-tool-list.d.ts +8 -0
  671. package/dist/mcp/compact-tool-list.js +42 -0
  672. package/dist/mcp/compact-tool-list.js.map +1 -0
  673. package/dist/mcp/compact.d.ts +33 -0
  674. package/dist/mcp/compact.js +189 -0
  675. package/dist/mcp/compact.js.map +1 -0
  676. package/dist/mcp/copper-summary.d.ts +26 -0
  677. package/dist/mcp/copper-summary.js +122 -0
  678. package/dist/mcp/copper-summary.js.map +1 -0
  679. package/dist/mcp/copper-tools.d.ts +93 -0
  680. package/dist/mcp/copper-tools.js +228 -0
  681. package/dist/mcp/copper-tools.js.map +1 -0
  682. package/dist/mcp/copper-under.d.ts +16 -0
  683. package/dist/mcp/copper-under.js +46 -0
  684. package/dist/mcp/copper-under.js.map +1 -0
  685. package/dist/mcp/create-part.d.ts +71 -0
  686. package/dist/mcp/create-part.js +31 -0
  687. package/dist/mcp/create-part.js.map +1 -0
  688. package/dist/mcp/datasheet-tools.d.ts +14 -0
  689. package/dist/mcp/datasheet-tools.js +15 -0
  690. package/dist/mcp/datasheet-tools.js.map +1 -0
  691. package/dist/mcp/fillet-tools.d.ts +24 -0
  692. package/dist/mcp/fillet-tools.js +52 -0
  693. package/dist/mcp/fillet-tools.js.map +1 -0
  694. package/dist/mcp/guide.d.ts +37 -0
  695. package/dist/mcp/guide.js +78 -0
  696. package/dist/mcp/guide.js.map +1 -0
  697. package/dist/mcp/import-part.d.ts +13 -0
  698. package/dist/mcp/import-part.js +20 -0
  699. package/dist/mcp/import-part.js.map +1 -0
  700. package/dist/mcp/make-sheet.d.ts +18 -0
  701. package/dist/mcp/make-sheet.js +29 -0
  702. package/dist/mcp/make-sheet.js.map +1 -0
  703. package/dist/mcp/new-circuit.d.ts +77 -0
  704. package/dist/mcp/new-circuit.js +114 -0
  705. package/dist/mcp/new-circuit.js.map +1 -0
  706. package/dist/mcp/place-tools.d.ts +46 -0
  707. package/dist/mcp/place-tools.js +121 -0
  708. package/dist/mcp/place-tools.js.map +1 -0
  709. package/dist/mcp/pour-tools.d.ts +126 -0
  710. package/dist/mcp/pour-tools.js +105 -0
  711. package/dist/mcp/pour-tools.js.map +1 -0
  712. package/dist/mcp/project-tools.d.ts +36 -0
  713. package/dist/mcp/project-tools.js +115 -0
  714. package/dist/mcp/project-tools.js.map +1 -0
  715. package/dist/mcp/route-by-ref.d.ts +20 -0
  716. package/dist/mcp/route-by-ref.js +70 -0
  717. package/dist/mcp/route-by-ref.js.map +1 -0
  718. package/dist/mcp/route-tools.d.ts +54 -0
  719. package/dist/mcp/route-tools.js +173 -0
  720. package/dist/mcp/route-tools.js.map +1 -0
  721. package/dist/mcp/server.d.ts +9 -0
  722. package/dist/mcp/server.js +290 -0
  723. package/dist/mcp/server.js.map +1 -0
  724. package/dist/skill-install.d.ts +13 -0
  725. package/dist/skill-install.js +28 -0
  726. package/dist/skill-install.js.map +1 -0
  727. package/dist/studio/fit-board.d.ts +11 -0
  728. package/dist/studio/fit-board.js +15 -0
  729. package/dist/studio/fit-board.js.map +1 -0
  730. package/dist/studio/layout-schema.d.ts +157 -0
  731. package/dist/studio/layout-schema.js +32 -0
  732. package/dist/studio/layout-schema.js.map +1 -0
  733. package/dist/studio/live.d.ts +79 -0
  734. package/dist/studio/live.js +187 -0
  735. package/dist/studio/live.js.map +1 -0
  736. package/dist/studio/place-events.d.ts +60 -0
  737. package/dist/studio/place-events.js +42 -0
  738. package/dist/studio/place-events.js.map +1 -0
  739. package/dist/studio/place-runner.d.ts +62 -0
  740. package/dist/studio/place-runner.js +205 -0
  741. package/dist/studio/place-runner.js.map +1 -0
  742. package/dist/studio/place-worker.d.ts +1 -0
  743. package/dist/studio/place-worker.js +23 -0
  744. package/dist/studio/place-worker.js.map +1 -0
  745. package/dist/studio/route-events.d.ts +64 -0
  746. package/dist/studio/route-events.js +61 -0
  747. package/dist/studio/route-events.js.map +1 -0
  748. package/dist/studio/route-runner.d.ts +90 -0
  749. package/dist/studio/route-runner.js +272 -0
  750. package/dist/studio/route-runner.js.map +1 -0
  751. package/dist/studio/router-worker.d.ts +1 -0
  752. package/dist/studio/router-worker.js +17 -0
  753. package/dist/studio/router-worker.js.map +1 -0
  754. package/dist/studio/server.d.ts +32 -0
  755. package/dist/studio/server.js +610 -0
  756. package/dist/studio/server.js.map +1 -0
  757. package/dist/version.d.ts +1 -0
  758. package/dist/version.js +2 -0
  759. package/dist/version.js.map +1 -0
  760. package/package.json +64 -4
  761. package/skills/copperflow/SKILL.md +199 -0
  762. package/skills/copperflow/references/copper.md +82 -0
  763. package/skills/copperflow/references/design-rules.md +163 -0
  764. package/skills/copperflow/references/design-workflow.md +199 -0
  765. package/skills/copperflow/references/editable-subset.md +83 -0
  766. package/skills/copperflow/references/parts-library.md +83 -0
  767. package/skills/copperflow/references/writing-circuits.md +62 -0
@@ -0,0 +1,155 @@
1
+ // Imports one part by its LCSC number: fetches its symbol, footprint and attributes from EasyEDA's public part
2
+ // endpoint, converts them and writes parts/<id>/ (part.yaml, footprint.yaml, the component, verification.md and
3
+ // source.md). Only on the person's request, one part at a time; nothing is cached. The part is never verified.
4
+ // The terms of the data are in docs/licences.md.
5
+ import { access, rm } from "node:fs/promises";
6
+ import { join } from "node:path";
7
+ import { createPart, PARTS_DIR, partDir, validatePartId } from "../core/library.js";
8
+ import { writeFileAtomic } from "../core/fs-utils.js";
9
+ import { convertLcscAnswer, lcscNumber, SOURCE_LINKS, SOURCE_NAME } from "./lcsc-part.js";
10
+ /** EasyEDA's endpoint for one part's symbol, footprint and attributes. */
11
+ export const lcscEndpoint = (lcsc) => `https://easyeda.com/api/products/${encodeURIComponent(lcsc)}/components?version=6.4.19.5`;
12
+ /** How long the fetch may take before the importer gives up. */
13
+ const FETCH_TIMEOUT_MS = 20_000;
14
+ /** The largest answer the importer reads; a part's documents are a few hundred kB at most. */
15
+ export const MAX_ANSWER_BYTES = 4 * 1024 * 1024;
16
+ /** Said with every import: what the source's terms allow (docs/licences.md). */
17
+ export const COMMERCIAL_NOTE = "Imported for personal, non-commercial use only, as EasyEDA's terms allow; for a commercial design, draw the part from the datasheet or get permission from JLCEDA/EasyEDA (see source.md).";
18
+ /** Imports the part; throws with a message for the person when it cannot, and then writes nothing. */
19
+ export async function importLcscPart(root, lcscText, options) {
20
+ const lcsc = lcscNumber(lcscText);
21
+ if (options.id !== undefined)
22
+ await refuseExisting(root, validatePartId(options.id), options.replace);
23
+ const answer = await fetchAnswer(lcsc, options.fetch ?? fetch);
24
+ const converted = convert(answer, lcsc, options.now.slice(0, 10));
25
+ const id = options.id ?? converted.suggestedId;
26
+ await refuseExisting(root, id, options.replace);
27
+ const files = await writePart(root, id, converted, options);
28
+ return { id, lcsc, part: converted.part, files, pads: converted.footprint.pads.length, notes: converted.notes };
29
+ }
30
+ /**
31
+ * Writes the part and its source.md. When either fails, a folder this import made is removed, so nothing is left;
32
+ * a part being replaced may be left partly written, and the message says so.
33
+ */
34
+ async function writePart(root, id, converted, options) {
35
+ const dir = partDir(root, id);
36
+ const existed = await access(dir).then(() => true, () => false);
37
+ try {
38
+ const created = await createPart(root, id, converted.part, { replace: options.replace === true, footprintFile: converted.footprint, now: options.now, notes: converted.notes });
39
+ await writeFileAtomic(join(dir, "source.md"), sourceText(id, converted, options.now.slice(0, 10)));
40
+ return [...created.files, `${PARTS_DIR}/${id}/source.md`];
41
+ }
42
+ catch (error) {
43
+ if (!existed) {
44
+ await rm(dir, { recursive: true, force: true });
45
+ throw new Error(`Cannot import ${converted.lcsc}: ${error.message}. Nothing was written.`);
46
+ }
47
+ throw new Error(`Cannot import ${converted.lcsc}: ${error.message}. ${PARTS_DIR}/${id} may be partly written; import it again or restore it.`);
48
+ }
49
+ }
50
+ /** A few lines saying what was written, for the CLI, the MCP tool and the Studio. */
51
+ export function formatImport(result) {
52
+ const pins = Object.keys(result.part.pins).length;
53
+ return [
54
+ `Imported ${result.lcsc} as ${result.id}: ${result.part.title}, ${pins} pin${pins === 1 ? "" : "s"}, ${result.pads} pad${result.pads === 1 ? "" : "s"}.`,
55
+ `Wrote ${result.files.join(", ")}.`,
56
+ ...result.notes.map((note) => `Note: ${note}`),
57
+ `It is NOT verified: check every pin and pad in ${PARTS_DIR}/${result.id}/verification.md against the datasheet.`,
58
+ COMMERCIAL_NOTE,
59
+ ].join("\n");
60
+ }
61
+ async function refuseExisting(root, id, replace) {
62
+ if (replace)
63
+ return;
64
+ const exists = await access(join(partDir(root, id), "part.yaml")).then(() => true, () => false);
65
+ if (exists)
66
+ throw new Error(`Part ${id} already exists; import again with replace (--replace) to overwrite it, or choose another id`);
67
+ }
68
+ async function fetchAnswer(lcsc, get) {
69
+ let response;
70
+ try {
71
+ response = await get(lcscEndpoint(lcsc), { headers: { accept: "application/json" }, signal: AbortSignal.timeout(FETCH_TIMEOUT_MS) });
72
+ }
73
+ catch (error) {
74
+ throw new Error(unreachable(lcsc, error));
75
+ }
76
+ // EasyEDA answers an unknown part with 404 and a JSON body that says so; the conversion reports it.
77
+ if (!response.ok && response.status !== 404)
78
+ throw new Error(`easyeda.com answered ${response.status} for ${lcsc}; nothing was written. Try again later.`);
79
+ let text;
80
+ try {
81
+ text = await boundedText(response);
82
+ }
83
+ catch (error) {
84
+ if (isTimeout(error))
85
+ throw new Error(unreachable(lcsc, error));
86
+ throw new Error(`easyeda.com's answer for ${lcsc} could not be read (${reason(error)}); nothing was written.`);
87
+ }
88
+ try {
89
+ return JSON.parse(text);
90
+ }
91
+ catch (error) {
92
+ throw new Error(`easyeda.com's answer for ${lcsc} could not be read (${reason(error)}); nothing was written.`);
93
+ }
94
+ }
95
+ /** The message for a fetch that failed: a slow server is not an offline machine. */
96
+ function unreachable(lcsc, error) {
97
+ if (isTimeout(error))
98
+ return `easyeda.com did not answer within ${FETCH_TIMEOUT_MS / 1000} s for ${lcsc}; nothing was written. Try again later.`;
99
+ return `Could not reach easyeda.com to fetch ${lcsc} (${reason(error)}). Importing needs an internet connection; nothing was written.`;
100
+ }
101
+ function isTimeout(error) {
102
+ return error?.name === "TimeoutError";
103
+ }
104
+ /** The body as text, refused when it is larger than MAX_ANSWER_BYTES (stated or as read). */
105
+ async function boundedText(response) {
106
+ const tooLarge = () => new Error(`larger than ${MAX_ANSWER_BYTES / (1024 * 1024)} MB`);
107
+ if (Number(response.headers.get("content-length") ?? 0) > MAX_ANSWER_BYTES)
108
+ throw tooLarge();
109
+ if (!response.body)
110
+ return "";
111
+ const reader = response.body.getReader();
112
+ const chunks = [];
113
+ let size = 0;
114
+ for (;;) {
115
+ const { done, value } = await reader.read();
116
+ if (done)
117
+ break;
118
+ size += value.byteLength;
119
+ if (size > MAX_ANSWER_BYTES) {
120
+ await reader.cancel();
121
+ throw tooLarge();
122
+ }
123
+ chunks.push(value);
124
+ }
125
+ return Buffer.concat(chunks).toString("utf8");
126
+ }
127
+ function convert(answer, lcsc, today) {
128
+ try {
129
+ return convertLcscAnswer(answer, lcsc, today);
130
+ }
131
+ catch (error) {
132
+ throw new Error(`Cannot import ${lcsc}: ${error.message}. Nothing was written.`);
133
+ }
134
+ }
135
+ function reason(error) {
136
+ const cause = error.cause;
137
+ return cause?.code ?? cause?.message ?? error.message ?? String(error);
138
+ }
139
+ /** source.md: where the part came from, the source's notice exactly as its documents carried it, and what it allows. */
140
+ function sourceText(id, converted, today) {
141
+ const quoted = converted.notices.length === 0 ? ["The documents carried no notice."] : converted.notices.flatMap((notice) => [...notice.split(/\r?\n/).map((line) => `> ${line}`.trimEnd()), ""]);
142
+ return [
143
+ `# Source of ${id}`,
144
+ "",
145
+ `Imported by copperflow on ${today} from LCSC part ${converted.lcsc}, out of the ${SOURCE_NAME}: ${SOURCE_LINKS.join(" and ")}.`,
146
+ "",
147
+ "The data's own notice, as EasyEDA's documents carry it:",
148
+ "",
149
+ ...quoted,
150
+ "copperflow converted the symbol and footprint into this folder for this project only. " + COMMERCIAL_NOTE.replace(" (see source.md)", ""),
151
+ "Do not remove this file or the origin in part.yaml. copperflow's reading of the terms is in its docs/licences.md.",
152
+ "",
153
+ ].join("\n");
154
+ }
155
+ //# sourceMappingURL=import-lcsc.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"import-lcsc.js","sourceRoot":"","sources":["../../src/library/import-lcsc.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,40 @@
1
+ import type { FootprintFile } from "../engine/footprints/file.js";
2
+ import { type Part } from "../core/library.js";
3
+ import { type ConvertedPad } from "./easyeda-footprint.js";
4
+ import { type SymbolPin } from "./easyeda-symbol.js";
5
+ /** What the source asks every use of its data to name, with both links. */
6
+ export declare const SOURCE_NAME = "JLCEDA/EasyEDA Official Library";
7
+ export declare const SOURCE_LINKS: readonly ["https://lceda.cn/", "https://easyeda.com"];
8
+ /**
9
+ * EasyEDA draws dual packages with their rows horizontal and pin 1 at the bottom left (quad packages as JLCPCB places them), its assembly orientation
10
+ * (so pick-and-place needs no correction, `file: 0`) and copperflow's generated convention turned +90°.
11
+ */
12
+ export declare const ORIENTATION_NOTE = "The footprint keeps the source's orientation; place at pcbRotation -90 to match a generated footprint of the same package.";
13
+ /** The part copperflow writes for one LCSC number. */
14
+ export interface LcscPart {
15
+ lcsc: string;
16
+ /** The part id to use when the person names none: the MPN made into an id. */
17
+ suggestedId: string;
18
+ part: Part;
19
+ footprint: FootprintFile;
20
+ /** What the conversion approximated or changed, for the person to check. */
21
+ notes: string[];
22
+ /** The notices the documents carried, exactly as written (usually one, shared by symbol and footprint). */
23
+ notices: string[];
24
+ }
25
+ /** The LCSC number as EasyEDA writes it (C and digits), or an error that says what one looks like. */
26
+ export declare function lcscNumber(text: string): string;
27
+ /** Throws when EasyEDA's answer says the part does not exist or is not the part asked for. */
28
+ export declare function convertLcscAnswer(answer: unknown, lcsc: string, today: string): LcscPart;
29
+ interface MatchedPins {
30
+ pins: Part["pins"];
31
+ pads: FootprintFile["pads"];
32
+ notes: string[];
33
+ }
34
+ /**
35
+ * The part's pins from the symbol, matched to the footprint's pads by number. A pad numbered other than with digits
36
+ * (EP, MP, none) becomes a new pin after the last; a pad no symbol pin names becomes a passive pin; a symbol pin
37
+ * without a pad becomes no_connect. Every such change is a note.
38
+ */
39
+ export declare function matchPins(symbol: readonly SymbolPin[], pads: readonly ConvertedPad[]): MatchedPins;
40
+ export {};
@@ -0,0 +1,153 @@
1
+ // EasyEDA's answer for one LCSC part (symbol, footprint and attributes) as a copperflow part: part.yaml's content,
2
+ // footprint.yaml's content and the notes a person checks. Pure; the importer fetches and writes.
3
+ import { z } from "zod";
4
+ import { FOOTPRINT_FILE, validatePartId } from "../core/library.js";
5
+ import { convertFootprint } from "./easyeda-footprint.js";
6
+ import { pinName, pinType, symbolPins } from "./easyeda-symbol.js";
7
+ /** What the source asks every use of its data to name, with both links. */
8
+ export const SOURCE_NAME = "JLCEDA/EasyEDA Official Library";
9
+ export const SOURCE_LINKS = ["https://lceda.cn/", "https://easyeda.com"];
10
+ /**
11
+ * EasyEDA draws dual packages with their rows horizontal and pin 1 at the bottom left (quad packages as JLCPCB places them), its assembly orientation
12
+ * (so pick-and-place needs no correction, `file: 0`) and copperflow's generated convention turned +90°.
13
+ */
14
+ export const ORIENTATION_NOTE = "The footprint keeps the source's orientation; place at pcbRotation -90 to match a generated footprint of the same package.";
15
+ const LCSC_NUMBER = /^C[1-9][0-9]{0,9}$/;
16
+ const PIN_NUMBER = /^[1-9][0-9]*$/;
17
+ const DocumentSchema = z.object({
18
+ head: z.object({ x: z.union([z.number(), z.string()]).optional(), y: z.union([z.number(), z.string()]).optional(), c_para: z.record(z.string(), z.string()).optional(), license: z.string().optional() }).loose(),
19
+ shape: z.array(z.string()),
20
+ });
21
+ const AnswerSchema = z.object({
22
+ success: z.boolean(),
23
+ result: z
24
+ .object({
25
+ title: z.string().optional(),
26
+ lcsc: z.object({ number: z.string().optional(), url: z.string().optional() }).loose().optional(),
27
+ dataStr: DocumentSchema,
28
+ packageDetail: z.object({ dataStr: DocumentSchema }).loose(),
29
+ })
30
+ .loose()
31
+ .nullish(),
32
+ });
33
+ /** The LCSC number as EasyEDA writes it (C and digits), or an error that says what one looks like. */
34
+ export function lcscNumber(text) {
35
+ const number = text.trim().toUpperCase();
36
+ if (!LCSC_NUMBER.test(number))
37
+ throw new Error(`"${text}" is not an LCSC part number: it looks like C9657 (C and digits)`);
38
+ return number;
39
+ }
40
+ /** Throws when EasyEDA's answer says the part does not exist or is not the part asked for. */
41
+ export function convertLcscAnswer(answer, lcsc, today) {
42
+ const parsed = AnswerSchema.safeParse(answer);
43
+ if (!parsed.success)
44
+ throw new Error(`EasyEDA's answer for ${lcsc} is not a part with a symbol and a footprint`);
45
+ const result = parsed.data.result;
46
+ if (!parsed.data.success || !result)
47
+ throw new Error(`EasyEDA has no part ${lcsc}`);
48
+ const attributes = result.dataStr.head.c_para ?? {};
49
+ const answered = (result.lcsc?.number ?? attributes["Supplier Part"] ?? lcsc).trim().toUpperCase();
50
+ if (answered !== lcsc)
51
+ throw new Error(`EasyEDA answered with part ${answered} when asked for ${lcsc}`);
52
+ const footprint = convertFootprint(result.packageDetail.dataStr);
53
+ const pins = matchPins(symbolPins(result.dataStr.shape), footprint.pads);
54
+ const name = oneLine(attributes.name ?? result.title ?? lcsc);
55
+ const mpn = oneLine(attributes["Manufacturer Part"] ?? name);
56
+ const manufacturer = withoutNonAscii(attributes.Manufacturer ?? "");
57
+ const packageName = oneLine(attributes.package ?? result.packageDetail.dataStr.head.c_para?.package ?? "");
58
+ const part = {
59
+ title: limit(packageName ? `${name}, ${packageName}` : name, 200),
60
+ description: `From the ${SOURCE_NAME} (${SOURCE_LINKS.join(", ")}), LCSC ${lcsc}; copyright JLCEDA/EasyEDA. Imported for personal, non-commercial use only; see source.md.`,
61
+ ...(manufacturer ? { manufacturer: limit(manufacturer, 200) } : {}),
62
+ ...(mpn ? { mpn: limit(mpn, 100) } : {}),
63
+ origin: `lcsc ${lcsc}, imported ${today}`,
64
+ footprint: FOOTPRINT_FILE,
65
+ pins: pins.pins,
66
+ suppliers: { lcsc },
67
+ datasheet: { url: `https://www.lcsc.com/datasheet/${lcsc}.pdf` },
68
+ };
69
+ const file = {
70
+ pads: pins.pads,
71
+ courtyard: footprint.courtyard,
72
+ ...(footprint.silkscreen.length > 0 ? { silkscreen: footprint.silkscreen } : {}),
73
+ ...(footprint.body ? { body: footprint.body } : {}),
74
+ };
75
+ const notices = [...new Set([result.dataStr.head.license, result.packageDetail.dataStr.head.license].filter((n) => !!n?.trim()))];
76
+ return { lcsc, suggestedId: suggestedId(mpn, lcsc), part, footprint: file, notes: [...footprint.notes, ...pins.notes, ORIENTATION_NOTE], notices };
77
+ }
78
+ /**
79
+ * The part's pins from the symbol, matched to the footprint's pads by number. A pad numbered other than with digits
80
+ * (EP, MP, none) becomes a new pin after the last; a pad no symbol pin names becomes a passive pin; a symbol pin
81
+ * without a pad becomes no_connect. Every such change is a note.
82
+ */
83
+ export function matchPins(symbol, pads) {
84
+ if (symbol.length === 0)
85
+ throw new Error("the symbol has no pins");
86
+ const odd = symbol.find((pin) => !PIN_NUMBER.test(pin.number));
87
+ if (odd)
88
+ throw new Error(`the symbol numbers a pin "${odd.number}"; copperflow numbers pins 1, 2, 3 …, so draw this part with the part wizard instead`);
89
+ const notes = [];
90
+ const pins = {};
91
+ for (const pin of symbol) {
92
+ if (pins[pin.number]) {
93
+ notes.push(`The symbol has pin ${pin.number} twice; the first (${pin.label}) is kept.`);
94
+ continue;
95
+ }
96
+ const name = pinName(pin.label, pin.number);
97
+ pins[pin.number] = { name, type: pinType(pin), ...(name !== pin.label && !/^\d*$/.test(pin.label.trim()) ? { description: limit(`EasyEDA name: ${oneLine(pin.label)}`, 200) } : {}) };
98
+ }
99
+ let next = Math.max(...Object.keys(pins).map(Number), ...pads.filter((p) => PIN_NUMBER.test(p.number)).map((p) => Number(p.number))) + 1;
100
+ const extra = new Map();
101
+ const renumbered = pads.map((pad) => {
102
+ if (PIN_NUMBER.test(pad.number))
103
+ return pad;
104
+ const label = pad.number || "(no number)";
105
+ let number = extra.get(label);
106
+ if (!number) {
107
+ number = String(next++);
108
+ extra.set(label, number);
109
+ const name = pad.number ? pinName(pad.number, number) : `pad${number}`;
110
+ pins[number] = { name, type: "passive", description: limit(`EasyEDA pad ${oneLine(label)}`, 200) };
111
+ notes.push(`Pad ${label} became pin ${number} (${name}, passive): footprint.yaml numbers pads with digits.`);
112
+ }
113
+ return { ...pad, number };
114
+ });
115
+ for (const number of [...new Set(renumbered.map((pad) => pad.number))]) {
116
+ if (pins[number])
117
+ continue;
118
+ pins[number] = { name: `pad${number}`, type: "passive" };
119
+ notes.push(`Pad ${number} has no pin in the symbol; it became pin ${number} (pad${number}, passive).`);
120
+ }
121
+ const padNumbers = new Set(renumbered.map((pad) => pad.number));
122
+ for (const [number, pin] of Object.entries(pins)) {
123
+ if (padNumbers.has(number))
124
+ continue;
125
+ pins[number] = { ...pin, type: "no_connect" };
126
+ notes.push(`Pin ${number} (${pin.name}) has no pad in the footprint; it is marked no_connect.`);
127
+ }
128
+ return { pins: sortedPins(pins), pads: renumbered, notes };
129
+ }
130
+ function sortedPins(pins) {
131
+ return Object.fromEntries(Object.entries(pins).sort(([a], [b]) => Number(a) - Number(b)));
132
+ }
133
+ /** The MPN as a part id (letters, digits, ".", "_" and "-", starting with a letter), or the LCSC number. */
134
+ function suggestedId(mpn, lcsc) {
135
+ const base = mpn.replace(/[^A-Za-z0-9._-]+/g, "_").replace(/_+/g, "_").replace(/\.{2,}/g, ".").slice(0, 60).replace(/[^A-Za-z0-9]+$/, "");
136
+ try {
137
+ return validatePartId(base);
138
+ }
139
+ catch {
140
+ return lcsc;
141
+ }
142
+ }
143
+ /** A manufacturer without the bracketed name in another script that EasyEDA adds after it ("onsemi(…)" is "onsemi"). */
144
+ function withoutNonAscii(text) {
145
+ return oneLine(text.replace(/[((][^))]*[^\x00-\x7f][^))]*[))]/g, "").replace(/[^\x20-\x7e]/g, ""));
146
+ }
147
+ function oneLine(text) {
148
+ return text.replace(/[\x00-\x1f\x7f]+/g, " ").replace(/\s+/g, " ").trim();
149
+ }
150
+ function limit(text, max) {
151
+ return text.length <= max ? text : `${text.slice(0, max - 1)}…`;
152
+ }
153
+ //# sourceMappingURL=lcsc-part.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lcsc-part.js","sourceRoot":"","sources":["../../src/library/lcsc-part.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,50 @@
1
+ import { FOOTPRINT_FILE, type Part } from "../core/library.js";
2
+ import { type FootprintFile } from "../engine/footprints/file.js";
3
+ import { type PinRow } from "./pin-table.js";
4
+ /** A footprint string such as "soic8" or "qfn32_5x5_p0.5", or the part's own footprint.yaml. */
5
+ export type PackageChoice = string | {
6
+ file: typeof FOOTPRINT_FILE;
7
+ };
8
+ export interface NewPartInput {
9
+ id: string;
10
+ title: string;
11
+ description?: string;
12
+ manufacturer?: string;
13
+ mpn?: string;
14
+ package: PackageChoice;
15
+ /** Rows, part.yaml's record, or a table pasted from the datasheet (see pin-table.ts). */
16
+ pins: readonly PinRow[] | Part["pins"] | string;
17
+ suppliers?: Record<string, string>;
18
+ datasheet?: {
19
+ url?: string;
20
+ file?: string;
21
+ };
22
+ /** With package { file }: the pads transcribed from the datasheet. Without them footprint.yaml is a placeholder. */
23
+ footprintFile?: FootprintFile;
24
+ }
25
+ export interface NewPartResult {
26
+ id: string;
27
+ part: Part;
28
+ files: string[];
29
+ /** What the person still has to do, also in verification.md. */
30
+ notes: string[];
31
+ /** The checklist's path in the project. */
32
+ verification: string;
33
+ /** verification.md as written. */
34
+ checklist: string;
35
+ }
36
+ export declare const PLACEHOLDER_NOTE = "footprint.yaml is a placeholder (pads 2.54 mm apart, in one row up to four pins and in two rows 7.62 mm apart above that): draw every pad from the datasheet's recommended land pattern, then delete \"placeholder: true\". Until then the checks report an error for each use of the part on the board, fabrication files are not written and the part cannot be verified; the schematic works. A footprint file goes into pick-and-place at its own orientation: drawn as copperflow draws (pin 1 top left, rows vertical), a SOIC- or SOP-like part needs fabrication.placementRotations.parts.<id>: 270 in rules.yaml; check it in JLCPCB's assembly preview.";
37
+ export declare const REMEMBERED_OUTLINE_NOTE = "Compare the pads with the land pattern in the maker's datasheet; this package's outline was not taken from the drawing.";
38
+ /** Writes the part; throws with one message for the person when it cannot, and then writes nothing. */
39
+ export declare function writeNewPart(root: string, input: NewPartInput, options: {
40
+ now: string;
41
+ replace?: boolean;
42
+ }): Promise<NewPartResult>;
43
+ /** A few lines saying what was written, for create_part and the Studio. */
44
+ export declare function formatNewPart(result: NewPartResult): string;
45
+ /**
46
+ * A footprint.yaml for the person to replace with the land pattern: up to four pins one pad per pin in a row, centred;
47
+ * more in two rows as a dual in-line outline (2.54 mm pitch, rows 7.62 mm apart), pin 1 at the top of the left row,
48
+ * down the left row and back up the right one, the extra pin of an odd count in the left row.
49
+ */
50
+ export declare function stubFootprint(pins: Part["pins"]): FootprintFile;
@@ -0,0 +1,160 @@
1
+ // A library part written from a datasheet by a person (Library → New part…) or the agent (create_part): part.yaml with
2
+ // origin "written", the component and verification.md, through the core's createPart. Never verified.
3
+ // Replacing a part that has its own footprint.yaml without giving pads keeps that file; an imported part then keeps its
4
+ // origin and source.md too. Replacing an imported part's footprint removes the imported data.
5
+ import { access, readFile, rm } from "node:fs/promises";
6
+ import { join } from "node:path";
7
+ import { parse } from "yaml";
8
+ import { createPart, FOOTPRINT_FILE, isPlaceholder, isWritten, PARTS_DIR, partDir, readPart, validatePartId } from "../core/library.js";
9
+ import { outlineFromMemory } from "../engine/footprints/dual.js";
10
+ import { generateFootprint } from "../engine/footprints/index.js";
11
+ import { FootprintFileSchema, pinErrors } from "../engine/footprints/file.js";
12
+ import { ORIENTATION_NOTE } from "./lcsc-part.js";
13
+ import { parsePinTable } from "./pin-table.js";
14
+ /** Spacing of the placeholder footprint's pads, in mm: 0.1 inch apart, in one row up to four pins, else two rows. */
15
+ const STUB_PITCH = 2.54;
16
+ const STUB_PAD = { width: 1.2, height: 1.8 };
17
+ const STUB_SINGLE_ROW_MAX = 4;
18
+ const STUB_ROW_SPACING = 7.62;
19
+ export const PLACEHOLDER_NOTE = 'footprint.yaml is a placeholder (pads 2.54 mm apart, in one row up to four pins and in two rows 7.62 mm apart above that): draw every pad from the datasheet\'s recommended land pattern, then delete "placeholder: true". Until then the checks report an error for each use of the part on the board, fabrication files are not written and the part cannot be verified; the schematic works. A footprint file goes into pick-and-place at its own orientation: drawn as copperflow draws (pin 1 top left, rows vertical), a SOIC- or SOP-like part needs fabrication.placementRotations.parts.<id>: 270 in rules.yaml; check it in JLCPCB\'s assembly preview.';
20
+ export const REMEMBERED_OUTLINE_NOTE = "Compare the pads with the land pattern in the maker's datasheet; this package's outline was not taken from the drawing.";
21
+ /** Writes the part; throws with one message for the person when it cannot, and then writes nothing. */
22
+ export async function writeNewPart(root, input, options) {
23
+ const id = validatePartId(input.id);
24
+ const pins = pinsOf(input.pins);
25
+ const fromFile = typeof input.package !== "string";
26
+ if (input.footprintFile && !fromFile)
27
+ throw new Error(`Footprint pads are given only with package { file: "${FOOTPRINT_FILE}" }`);
28
+ if (!fromFile)
29
+ checkPackage(input.package, pins);
30
+ const dir = partDir(root, id);
31
+ const previous = options.replace === true ? await previousPart(dir, root, id) : {};
32
+ const kept = fromFile && !input.footprintFile ? previous.footprint : undefined;
33
+ const imported = previous.origin !== undefined && !isWritten(previous.origin);
34
+ const footprintFile = fromFile ? (input.footprintFile ?? kept ?? stubFootprint(pins)) : undefined;
35
+ const remembered = !fromFile && outlineFromMemory(input.package) ? [REMEMBERED_OUTLINE_NOTE] : [];
36
+ const notes = [...replaceNotes({ fromFile, given: !!input.footprintFile, kept: !!kept, imported, origin: previous.origin }), ...remembered];
37
+ const part = {
38
+ title: input.title,
39
+ ...(input.description ? { description: input.description } : {}),
40
+ ...(input.manufacturer ? { manufacturer: input.manufacturer } : {}),
41
+ ...(input.mpn ? { mpn: input.mpn } : {}),
42
+ origin: kept && imported ? previous.origin : `written ${options.now.slice(0, 10)}`,
43
+ footprint: fromFile ? FOOTPRINT_FILE : input.package,
44
+ pins,
45
+ ...(input.suppliers && Object.keys(input.suppliers).length > 0 ? { suppliers: input.suppliers } : {}),
46
+ ...(input.datasheet && (input.datasheet.url || input.datasheet.file) ? { datasheet: input.datasheet } : {}),
47
+ };
48
+ const existed = await access(dir).then(() => true, () => false);
49
+ try {
50
+ const created = await createPart(root, id, part, { replace: options.replace === true, now: options.now, notes, ...(footprintFile ? { footprintFile } : {}) });
51
+ // The imported data goes only once the part that no longer uses it is written.
52
+ if (imported && !kept)
53
+ await removeImport(dir, fromFile);
54
+ const checklist = await readFile(join(dir, "verification.md"), "utf8");
55
+ return { id, part: created.part, files: created.files, notes, verification: `${PARTS_DIR}/${id}/verification.md`, checklist };
56
+ }
57
+ catch (error) {
58
+ // createPart checks everything before it writes; a folder this call made is removed when a write fails.
59
+ if (!existed)
60
+ await rm(dir, { recursive: true, force: true });
61
+ throw error;
62
+ }
63
+ }
64
+ /** What a replace may keep from the part already in the folder; nothing when there is none or it cannot be read. */
65
+ async function previousPart(dir, root, id) {
66
+ const origin = await readPart(root, id).then((part) => part.origin, () => undefined);
67
+ const text = await readFile(join(dir, FOOTPRINT_FILE), "utf8").catch(() => undefined);
68
+ const parsed = text === undefined || isPlaceholder(text) ? undefined : FootprintFileSchema.safeParse(parse(text));
69
+ return { ...(origin ? { origin } : {}), ...(parsed?.success ? { footprint: parsed.data } : {}) };
70
+ }
71
+ /** What the answer and verification.md say about the footprint: kept, a placeholder, or the import removed. */
72
+ function replaceNotes(state) {
73
+ if (state.kept && state.imported)
74
+ return [`Kept ${FOOTPRINT_FILE}, the origin (${state.origin}) and source.md from the import: the part still uses EasyEDA's footprint.`, ORIENTATION_NOTE];
75
+ if (state.kept)
76
+ return [`Kept ${FOOTPRINT_FILE}: its pads were drawn before and none were given.`];
77
+ const notes = state.fromFile && !state.given ? [PLACEHOLDER_NOTE] : [];
78
+ if (!state.imported)
79
+ return notes;
80
+ const footprint = state.fromFile ? `replaced the imported ${FOOTPRINT_FILE}` : `the imported ${FOOTPRINT_FILE}`;
81
+ return [...notes, `Removed source.md and ${footprint}: the part no longer uses EasyEDA's data.`];
82
+ }
83
+ /** Removes an imported part's source.md and, when the part no longer names it, its footprint.yaml. */
84
+ async function removeImport(dir, fromFile) {
85
+ await rm(join(dir, "source.md"), { force: true });
86
+ if (!fromFile)
87
+ await rm(join(dir, FOOTPRINT_FILE), { force: true });
88
+ }
89
+ /** A few lines saying what was written, for create_part and the Studio. */
90
+ export function formatNewPart(result) {
91
+ const pins = Object.keys(result.part.pins).length;
92
+ return [
93
+ `Created ${result.id}: ${result.part.title}, ${pins} pin${pins === 1 ? "" : "s"}, footprint ${result.part.footprint}.`,
94
+ `Wrote ${result.files.join(", ")}.`,
95
+ ...result.notes.map((note) => `Note: ${note}`),
96
+ `It is NOT verified: check every pin and the footprint in ${result.verification} against the datasheet.`,
97
+ ].join("\n");
98
+ }
99
+ /**
100
+ * A footprint.yaml for the person to replace with the land pattern: up to four pins one pad per pin in a row, centred;
101
+ * more in two rows as a dual in-line outline (2.54 mm pitch, rows 7.62 mm apart), pin 1 at the top of the left row,
102
+ * down the left row and back up the right one, the extra pin of an odd count in the left row.
103
+ */
104
+ export function stubFootprint(pins) {
105
+ const numbers = Object.keys(pins).sort((a, b) => Number(a) - Number(b));
106
+ if (numbers.length > STUB_SINGLE_ROW_MAX)
107
+ return { placeholder: true, pads: dualStubPads(numbers) };
108
+ const offset = ((numbers.length - 1) * STUB_PITCH) / 2;
109
+ return {
110
+ placeholder: true,
111
+ pads: numbers.map((number, index) => ({ number, shape: "rect", x: round(index * STUB_PITCH - offset), y: 0, ...STUB_PAD })),
112
+ };
113
+ }
114
+ function dualStubPads(numbers) {
115
+ const left = Math.ceil(numbers.length / 2);
116
+ const top = ((left - 1) * STUB_PITCH) / 2;
117
+ const pad = { shape: "rect", width: STUB_PAD.height, height: STUB_PAD.width };
118
+ return numbers.map((number, index) => {
119
+ const inLeft = index < left;
120
+ // The right row runs back up from the bottom position of the left row.
121
+ const step = inLeft ? index : left - 1 - (index - left);
122
+ return { number, x: (inLeft ? -1 : 1) * (STUB_ROW_SPACING / 2), y: round(top - step * STUB_PITCH), ...pad };
123
+ });
124
+ }
125
+ /** The pins as part.yaml's record, in number order; a pasted table with problems is refused with every line's. */
126
+ function pinsOf(pins) {
127
+ const rows = typeof pins === "string" ? tableRows(pins) : Array.isArray(pins) ? pins : undefined;
128
+ const record = rows ? recordOf(rows) : pins;
129
+ if (Object.keys(record).length === 0)
130
+ throw new Error("The part has no pins: give at least one, by number with a name and a type");
131
+ return Object.fromEntries(Object.entries(record).sort(([a], [b]) => Number(a) - Number(b)));
132
+ }
133
+ function recordOf(rows) {
134
+ const record = {};
135
+ for (const { number, ...pin } of rows) {
136
+ if (record[number])
137
+ throw new Error(`Pin ${number} is given twice`);
138
+ record[number] = pin;
139
+ }
140
+ return record;
141
+ }
142
+ function tableRows(text) {
143
+ const table = parsePinTable(text);
144
+ if (table.errors.length > 0)
145
+ throw new Error(`The pin table has problems: ${table.errors.map((error) => error.message).join("; ")}`);
146
+ return table.pins;
147
+ }
148
+ /** Throws unless copperflow can make the footprint string and its pads are the part's pins. */
149
+ function checkPackage(text, pins) {
150
+ if (text === FOOTPRINT_FILE)
151
+ throw new Error(`Package "${text}" is not a footprint string: for the part's own footprint file pass package { "file": "${FOOTPRINT_FILE}" }`);
152
+ const footprint = generateFootprint(text);
153
+ if ("error" in footprint)
154
+ throw new Error(`Package "${text}": ${footprint.error}`);
155
+ const problems = pinErrors(footprint, { pins });
156
+ if (problems.length > 0)
157
+ throw new Error(`Package "${text}" does not fit the pins: ${problems.join("; ")}`);
158
+ }
159
+ const round = (value) => Math.round(value * 1000) / 1000;
160
+ //# sourceMappingURL=new-part.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"new-part.js","sourceRoot":"","sources":["../../src/library/new-part.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,23 @@
1
+ import { type PinType } from "../core/pin-types.js";
2
+ export interface PinRow {
3
+ number: string;
4
+ name: string;
5
+ type: PinType;
6
+ description?: string;
7
+ }
8
+ export interface PinTableError {
9
+ /** 1-based, counting blank lines, so it matches the pasted text. */
10
+ line: number;
11
+ text: string;
12
+ message: string;
13
+ }
14
+ export interface PinTable {
15
+ pins: PinRow[];
16
+ errors: PinTableError[];
17
+ }
18
+ /** The pins of the table and a message per line that is not a pin; the first line is skipped when it is a header. */
19
+ export declare function parsePinTable(text: string): PinTable;
20
+ /** The rows as a tab-separated table, the form the paste area shows and reads back. */
21
+ export declare function pinTableText(rows: readonly PinRow[]): string;
22
+ /** A name copperflow accepts made from a datasheet's ("+3V3" becomes "_3V3"); a suggestion, never applied by itself. */
23
+ export declare function suggestedPinName(text: string): string;