copperflow 0.3.4 → 0.4.1

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 (411) hide show
  1. package/README.md +117 -14
  2. package/dist/app/THIRD_PARTY_LICENSES.txt +5 -0
  3. package/dist/app/assets/NewPartDialog-ZQ4Y3m45.js +1 -0
  4. package/dist/app/assets/PackagesDialog-C8ZyWl-g.css +1 -0
  5. package/dist/app/assets/PackagesDialog-vEzilmpR.js +2 -0
  6. package/dist/app/assets/VerifyPartDialog-BHLqD_WJ.css +1 -0
  7. package/dist/app/assets/VerifyPartDialog-DYr1UIds.js +2 -0
  8. package/dist/app/assets/footprint-preview-Nyk2poiN.js +160 -0
  9. package/dist/app/assets/index-BUjGdMvr.js +20 -0
  10. package/dist/app/assets/index-CF7-tL4t.css +1 -0
  11. package/dist/app/assets/texture-worker-CyI_g_XZ.js +1 -0
  12. package/dist/app/index.html +2 -2
  13. package/dist/cli-commands.js +141 -16
  14. package/dist/cli-commands.js.map +1 -1
  15. package/dist/cli-impedance.d.ts +4 -0
  16. package/dist/cli-impedance.js +56 -0
  17. package/dist/cli-impedance.js.map +1 -0
  18. package/dist/cli-simulate.d.ts +3 -0
  19. package/dist/cli-simulate.js +54 -0
  20. package/dist/cli-simulate.js.map +1 -0
  21. package/dist/core/analyze.js +5 -2
  22. package/dist/core/analyze.js.map +1 -1
  23. package/dist/core/bom.d.ts +6 -1
  24. package/dist/core/bom.js +23 -4
  25. package/dist/core/bom.js.map +1 -1
  26. package/dist/core/case-results.d.ts +4 -0
  27. package/dist/core/case-results.js +9 -0
  28. package/dist/core/case-results.js.map +1 -0
  29. package/dist/core/change-files.d.ts +31 -0
  30. package/dist/core/change-files.js +67 -0
  31. package/dist/core/change-files.js.map +1 -0
  32. package/dist/core/change-render.d.ts +18 -0
  33. package/dist/core/change-render.js +48 -0
  34. package/dist/core/change-render.js.map +1 -0
  35. package/dist/core/change-view.d.ts +33 -0
  36. package/dist/core/change-view.js +73 -0
  37. package/dist/core/change-view.js.map +1 -0
  38. package/dist/core/change-words.d.ts +39 -0
  39. package/dist/core/change-words.js +214 -0
  40. package/dist/core/change-words.js.map +1 -0
  41. package/dist/core/checklist-text.d.ts +21 -0
  42. package/dist/core/checklist-text.js +59 -0
  43. package/dist/core/checklist-text.js.map +1 -0
  44. package/dist/core/edit.js +5 -2
  45. package/dist/core/edit.js.map +1 -1
  46. package/dist/core/fabrication.d.ts +9 -2
  47. package/dist/core/fabrication.js +29 -10
  48. package/dist/core/fabrication.js.map +1 -1
  49. package/dist/core/library.d.ts +46 -0
  50. package/dist/core/library.js +54 -16
  51. package/dist/core/library.js.map +1 -1
  52. package/dist/core/model-export.d.ts +33 -0
  53. package/dist/core/model-export.js +33 -0
  54. package/dist/core/model-export.js.map +1 -0
  55. package/dist/core/modules.d.ts +1 -0
  56. package/dist/core/modules.js +17 -0
  57. package/dist/core/modules.js.map +1 -1
  58. package/dist/core/order-report.d.ts +10 -0
  59. package/dist/core/order-report.js +93 -0
  60. package/dist/core/order-report.js.map +1 -0
  61. package/dist/core/packages.d.ts +18 -0
  62. package/dist/core/packages.js +49 -0
  63. package/dist/core/packages.js.map +1 -0
  64. package/dist/core/pin-header.d.ts +5 -0
  65. package/dist/core/pin-header.js +77 -0
  66. package/dist/core/pin-header.js.map +1 -0
  67. package/dist/core/pin-map.d.ts +46 -0
  68. package/dist/core/pin-map.js +101 -0
  69. package/dist/core/pin-map.js.map +1 -0
  70. package/dist/core/render.d.ts +26 -5
  71. package/dist/core/render.js +16 -6
  72. package/dist/core/render.js.map +1 -1
  73. package/dist/core/sheet-card.d.ts +4 -0
  74. package/dist/core/sheet-card.js +46 -1
  75. package/dist/core/sheet-card.js.map +1 -1
  76. package/dist/core/sheet-files.js +10 -3
  77. package/dist/core/sheet-files.js.map +1 -1
  78. package/dist/core/simulate.d.ts +19 -0
  79. package/dist/core/simulate.js +72 -0
  80. package/dist/core/simulate.js.map +1 -0
  81. package/dist/core/step-export.d.ts +17 -0
  82. package/dist/core/step-export.js +35 -0
  83. package/dist/core/step-export.js.map +1 -0
  84. package/dist/core/supplier-prop.d.ts +6 -0
  85. package/dist/core/supplier-prop.js +21 -0
  86. package/dist/core/supplier-prop.js.map +1 -0
  87. package/dist/core/workspace.d.ts +2 -1
  88. package/dist/core/workspace.js +2 -1
  89. package/dist/core/workspace.js.map +1 -1
  90. package/dist/engine/board.js +3 -1
  91. package/dist/engine/board.js.map +1 -1
  92. package/dist/engine/checks/fast-lines.d.ts +60 -0
  93. package/dist/engine/checks/fast-lines.js +209 -0
  94. package/dist/engine/checks/fast-lines.js.map +1 -0
  95. package/dist/engine/checks/index.js +2 -0
  96. package/dist/engine/checks/index.js.map +1 -1
  97. package/dist/engine/design-diff.d.ts +120 -0
  98. package/dist/engine/design-diff.js +249 -0
  99. package/dist/engine/design-diff.js.map +1 -0
  100. package/dist/engine/design.d.ts +3 -0
  101. package/dist/engine/design.js +7 -2
  102. package/dist/engine/design.js.map +1 -1
  103. package/dist/engine/fab/export.d.ts +17 -1
  104. package/dist/engine/fab/export.js +26 -4
  105. package/dist/engine/fab/export.js.map +1 -1
  106. package/dist/engine/fab/names.d.ts +2 -2
  107. package/dist/engine/fab/names.js +4 -2
  108. package/dist/engine/fab/names.js.map +1 -1
  109. package/dist/engine/fab/picture/board-picture.d.ts +52 -0
  110. package/dist/engine/fab/picture/board-picture.js +102 -0
  111. package/dist/engine/fab/picture/board-picture.js.map +1 -0
  112. package/dist/engine/fab/picture/board-view.d.ts +20 -0
  113. package/dist/engine/fab/picture/board-view.js +50 -0
  114. package/dist/engine/fab/picture/board-view.js.map +1 -0
  115. package/dist/engine/fab/picture/compose.d.ts +50 -0
  116. package/dist/engine/fab/picture/compose.js +208 -0
  117. package/dist/engine/fab/picture/compose.js.map +1 -0
  118. package/dist/engine/fab/picture/layer-images.d.ts +9 -0
  119. package/dist/engine/fab/picture/layer-images.js +67 -0
  120. package/dist/engine/fab/picture/layer-images.js.map +1 -0
  121. package/dist/engine/fab/picture/looks.d.ts +152 -0
  122. package/dist/engine/fab/picture/looks.js +53 -0
  123. package/dist/engine/fab/picture/looks.js.map +1 -0
  124. package/dist/engine/fab/picture/png.d.ts +31 -0
  125. package/dist/engine/fab/picture/png.js +47 -0
  126. package/dist/engine/fab/picture/png.js.map +1 -0
  127. package/dist/engine/fab/picture/raster.d.ts +46 -0
  128. package/dist/engine/fab/picture/raster.js +170 -0
  129. package/dist/engine/fab/picture/raster.js.map +1 -0
  130. package/dist/engine/fab/zip.d.ts +2 -1
  131. package/dist/engine/fab/zip.js +1 -1
  132. package/dist/engine/fab/zip.js.map +1 -1
  133. package/dist/engine/footprints/array.d.ts +4 -0
  134. package/dist/engine/footprints/array.js +51 -0
  135. package/dist/engine/footprints/array.js.map +1 -0
  136. package/dist/engine/footprints/axial.d.ts +6 -0
  137. package/dist/engine/footprints/axial.js +115 -0
  138. package/dist/engine/footprints/axial.js.map +1 -0
  139. package/dist/engine/footprints/catalogue.d.ts +39 -0
  140. package/dist/engine/footprints/catalogue.js +284 -0
  141. package/dist/engine/footprints/catalogue.js.map +1 -0
  142. package/dist/engine/footprints/chip.js +10 -1
  143. package/dist/engine/footprints/chip.js.map +1 -1
  144. package/dist/engine/footprints/connector.d.ts +16 -0
  145. package/dist/engine/footprints/connector.js +31 -0
  146. package/dist/engine/footprints/connector.js.map +1 -0
  147. package/dist/engine/footprints/dcjack.d.ts +3 -0
  148. package/dist/engine/footprints/dcjack.js +46 -0
  149. package/dist/engine/footprints/dcjack.js.map +1 -0
  150. package/dist/engine/footprints/dpak.d.ts +7 -0
  151. package/dist/engine/footprints/dpak.js +172 -0
  152. package/dist/engine/footprints/dpak.js.map +1 -0
  153. package/dist/engine/footprints/dual.d.ts +11 -2
  154. package/dist/engine/footprints/dual.js +113 -12
  155. package/dist/engine/footprints/dual.js.map +1 -1
  156. package/dist/engine/footprints/index.js +46 -3
  157. package/dist/engine/footprints/index.js.map +1 -1
  158. package/dist/engine/footprints/inductor.d.ts +3 -0
  159. package/dist/engine/footprints/inductor.js +32 -0
  160. package/dist/engine/footprints/inductor.js.map +1 -0
  161. package/dist/engine/footprints/known.js +114 -14
  162. package/dist/engine/footprints/known.js.map +1 -1
  163. package/dist/engine/footprints/ledsmd.d.ts +3 -0
  164. package/dist/engine/footprints/ledsmd.js +52 -0
  165. package/dist/engine/footprints/ledsmd.js.map +1 -0
  166. package/dist/engine/footprints/ledth.d.ts +4 -0
  167. package/dist/engine/footprints/ledth.js +45 -0
  168. package/dist/engine/footprints/ledth.js.map +1 -0
  169. package/dist/engine/footprints/melf.d.ts +8 -0
  170. package/dist/engine/footprints/melf.js +56 -0
  171. package/dist/engine/footprints/melf.js.map +1 -0
  172. package/dist/engine/footprints/plcc.d.ts +4 -0
  173. package/dist/engine/footprints/plcc.js +117 -0
  174. package/dist/engine/footprints/plcc.js.map +1 -0
  175. package/dist/engine/footprints/resonator.d.ts +3 -0
  176. package/dist/engine/footprints/resonator.js +33 -0
  177. package/dist/engine/footprints/resonator.js.map +1 -0
  178. package/dist/engine/footprints/screw.d.ts +3 -0
  179. package/dist/engine/footprints/screw.js +51 -0
  180. package/dist/engine/footprints/screw.js.map +1 -0
  181. package/dist/engine/footprints/smallsot.d.ts +8 -0
  182. package/dist/engine/footprints/smallsot.js +143 -0
  183. package/dist/engine/footprints/smallsot.js.map +1 -0
  184. package/dist/engine/footprints/smdbox.d.ts +33 -0
  185. package/dist/engine/footprints/smdbox.js +76 -0
  186. package/dist/engine/footprints/smdbox.js.map +1 -0
  187. package/dist/engine/footprints/smdcan.d.ts +3 -0
  188. package/dist/engine/footprints/smdcan.js +61 -0
  189. package/dist/engine/footprints/smdcan.js.map +1 -0
  190. package/dist/engine/footprints/smdip.d.ts +4 -0
  191. package/dist/engine/footprints/smdip.js +58 -0
  192. package/dist/engine/footprints/smdip.js.map +1 -0
  193. package/dist/engine/footprints/socket.d.ts +8 -0
  194. package/dist/engine/footprints/socket.js +21 -0
  195. package/dist/engine/footprints/socket.js.map +1 -0
  196. package/dist/engine/footprints/sod.d.ts +6 -0
  197. package/dist/engine/footprints/sod.js +63 -6
  198. package/dist/engine/footprints/sod.js.map +1 -1
  199. package/dist/engine/footprints/sot.d.ts +1 -1
  200. package/dist/engine/footprints/sot.js +17 -2
  201. package/dist/engine/footprints/sot.js.map +1 -1
  202. package/dist/engine/footprints/tact.d.ts +3 -0
  203. package/dist/engine/footprints/tact.js +65 -0
  204. package/dist/engine/footprints/tact.js.map +1 -0
  205. package/dist/engine/footprints/tantalum.d.ts +7 -0
  206. package/dist/engine/footprints/tantalum.js +91 -0
  207. package/dist/engine/footprints/tantalum.js.map +1 -0
  208. package/dist/engine/footprints/to92inline.d.ts +14 -0
  209. package/dist/engine/footprints/to92inline.js +21 -0
  210. package/dist/engine/footprints/to92inline.js.map +1 -0
  211. package/dist/engine/footprints/topower.d.ts +7 -0
  212. package/dist/engine/footprints/topower.js +119 -0
  213. package/dist/engine/footprints/topower.js.map +1 -0
  214. package/dist/engine/footprints/usb.d.ts +32 -0
  215. package/dist/engine/footprints/usb.js +109 -0
  216. package/dist/engine/footprints/usb.js.map +1 -0
  217. package/dist/engine/footprints/xtal.d.ts +4 -0
  218. package/dist/engine/footprints/xtal.js +61 -0
  219. package/dist/engine/footprints/xtal.js.map +1 -0
  220. package/dist/engine/impedance.d.ts +72 -0
  221. package/dist/engine/impedance.js +133 -0
  222. package/dist/engine/impedance.js.map +1 -0
  223. package/dist/engine/line-length.d.ts +15 -0
  224. package/dist/engine/line-length.js +116 -0
  225. package/dist/engine/line-length.js.map +1 -0
  226. package/dist/engine/model.d.ts +2 -0
  227. package/dist/engine/model.js.map +1 -1
  228. package/dist/engine/pcb-place/roles.d.ts +3 -1
  229. package/dist/engine/pcb-place/roles.js +5 -0
  230. package/dist/engine/pcb-place/roles.js.map +1 -1
  231. package/dist/engine/rules/impedance-widths.d.ts +20 -0
  232. package/dist/engine/rules/impedance-widths.js +57 -0
  233. package/dist/engine/rules/impedance-widths.js.map +1 -0
  234. package/dist/engine/rules/load.js +11 -2
  235. package/dist/engine/rules/load.js.map +1 -1
  236. package/dist/engine/rules/pairs.d.ts +27 -0
  237. package/dist/engine/rules/pairs.js +86 -0
  238. package/dist/engine/rules/pairs.js.map +1 -0
  239. package/dist/engine/rules/profiles.js +16 -0
  240. package/dist/engine/rules/profiles.js.map +1 -1
  241. package/dist/engine/rules/rotations.d.ts +12 -3
  242. package/dist/engine/rules/rotations.js +77 -2
  243. package/dist/engine/rules/rotations.js.map +1 -1
  244. package/dist/engine/rules/schema.d.ts +44 -0
  245. package/dist/engine/rules/schema.js +16 -1
  246. package/dist/engine/rules/schema.js.map +1 -1
  247. package/dist/engine/sim/answer.d.ts +13 -0
  248. package/dist/engine/sim/answer.js +101 -0
  249. package/dist/engine/sim/answer.js.map +1 -0
  250. package/dist/engine/sim/cases.d.ts +29 -0
  251. package/dist/engine/sim/cases.js +63 -0
  252. package/dist/engine/sim/cases.js.map +1 -0
  253. package/dist/engine/sim/devices.d.ts +109 -0
  254. package/dist/engine/sim/devices.js +137 -0
  255. package/dist/engine/sim/devices.js.map +1 -0
  256. package/dist/engine/sim/elements.d.ts +49 -0
  257. package/dist/engine/sim/elements.js +2 -0
  258. package/dist/engine/sim/elements.js.map +1 -0
  259. package/dist/engine/sim/from-circuit.d.ts +52 -0
  260. package/dist/engine/sim/from-circuit.js +354 -0
  261. package/dist/engine/sim/from-circuit.js.map +1 -0
  262. package/dist/engine/sim/limits.d.ts +12 -0
  263. package/dist/engine/sim/limits.js +79 -0
  264. package/dist/engine/sim/limits.js.map +1 -0
  265. package/dist/engine/sim/linear.d.ts +2 -0
  266. package/dist/engine/sim/linear.js +49 -0
  267. package/dist/engine/sim/linear.js.map +1 -0
  268. package/dist/engine/sim/model-schema.d.ts +246 -0
  269. package/dist/engine/sim/model-schema.js +115 -0
  270. package/dist/engine/sim/model-schema.js.map +1 -0
  271. package/dist/engine/sim/part-models.d.ts +47 -0
  272. package/dist/engine/sim/part-models.js +102 -0
  273. package/dist/engine/sim/part-models.js.map +1 -0
  274. package/dist/engine/sim/run.d.ts +14 -0
  275. package/dist/engine/sim/run.js +13 -0
  276. package/dist/engine/sim/run.js.map +1 -0
  277. package/dist/engine/sim/solve.d.ts +42 -0
  278. package/dist/engine/sim/solve.js +294 -0
  279. package/dist/engine/sim/solve.js.map +1 -0
  280. package/dist/engine/sim/spice.d.ts +5 -0
  281. package/dist/engine/sim/spice.js +66 -0
  282. package/dist/engine/sim/spice.js.map +1 -0
  283. package/dist/engine/sim/values.d.ts +4 -0
  284. package/dist/engine/sim/values.js +40 -0
  285. package/dist/engine/sim/values.js.map +1 -0
  286. package/dist/engine/solid/heights-smd.d.ts +3 -0
  287. package/dist/engine/solid/heights-smd.js +81 -0
  288. package/dist/engine/solid/heights-smd.js.map +1 -0
  289. package/dist/engine/solid/heights-through.d.ts +7 -0
  290. package/dist/engine/solid/heights-through.js +93 -0
  291. package/dist/engine/solid/heights-through.js.map +1 -0
  292. package/dist/engine/solid/heights-uno.d.ts +2 -0
  293. package/dist/engine/solid/heights-uno.js +15 -0
  294. package/dist/engine/solid/heights-uno.js.map +1 -0
  295. package/dist/engine/solid/heights.d.ts +31 -0
  296. package/dist/engine/solid/heights.js +112 -0
  297. package/dist/engine/solid/heights.js.map +1 -0
  298. package/dist/engine/solid/limits.d.ts +7 -0
  299. package/dist/engine/solid/limits.js +20 -0
  300. package/dist/engine/solid/limits.js.map +1 -0
  301. package/dist/engine/solid/model.d.ts +54 -0
  302. package/dist/engine/solid/model.js +147 -0
  303. package/dist/engine/solid/model.js.map +1 -0
  304. package/dist/engine/solid/step.d.ts +5 -0
  305. package/dist/engine/solid/step.js +164 -0
  306. package/dist/engine/solid/step.js.map +1 -0
  307. package/dist/engine/solid/thickness.d.ts +11 -0
  308. package/dist/engine/solid/thickness.js +10 -0
  309. package/dist/engine/solid/thickness.js.map +1 -0
  310. package/dist/library/kicad/board.d.ts +26 -0
  311. package/dist/library/kicad/board.js +96 -0
  312. package/dist/library/kicad/board.js.map +1 -0
  313. package/dist/library/kicad/copper.d.ts +44 -0
  314. package/dist/library/kicad/copper.js +106 -0
  315. package/dist/library/kicad/copper.js.map +1 -0
  316. package/dist/library/kicad/footprints.d.ts +62 -0
  317. package/dist/library/kicad/footprints.js +184 -0
  318. package/dist/library/kicad/footprints.js.map +1 -0
  319. package/dist/library/kicad/geometry.d.ts +36 -0
  320. package/dist/library/kicad/geometry.js +84 -0
  321. package/dist/library/kicad/geometry.js.map +1 -0
  322. package/dist/library/kicad/import.d.ts +58 -0
  323. package/dist/library/kicad/import.js +240 -0
  324. package/dist/library/kicad/import.js.map +1 -0
  325. package/dist/library/kicad/plan.d.ts +40 -0
  326. package/dist/library/kicad/plan.js +139 -0
  327. package/dist/library/kicad/plan.js.map +1 -0
  328. package/dist/library/kicad/read.d.ts +30 -0
  329. package/dist/library/kicad/read.js +105 -0
  330. package/dist/library/kicad/read.js.map +1 -0
  331. package/dist/library/kicad/sexpr.d.ts +36 -0
  332. package/dist/library/kicad/sexpr.js +153 -0
  333. package/dist/library/kicad/sexpr.js.map +1 -0
  334. package/dist/library/kicad/tally.d.ts +32 -0
  335. package/dist/library/kicad/tally.js +55 -0
  336. package/dist/library/kicad/tally.js.map +1 -0
  337. package/dist/library/kicad/write.d.ts +37 -0
  338. package/dist/library/kicad/write.js +146 -0
  339. package/dist/library/kicad/write.js.map +1 -0
  340. package/dist/library/new-part.d.ts +2 -0
  341. package/dist/library/new-part.js +1 -0
  342. package/dist/library/new-part.js.map +1 -1
  343. package/dist/mcp/board-import-tool.d.ts +1 -1
  344. package/dist/mcp/board-import-tool.js +14 -4
  345. package/dist/mcp/board-import-tool.js.map +1 -1
  346. package/dist/mcp/copper-summary.d.ts +2 -0
  347. package/dist/mcp/copper-summary.js +4 -2
  348. package/dist/mcp/copper-summary.js.map +1 -1
  349. package/dist/mcp/create-part.d.ts +23 -0
  350. package/dist/mcp/create-part.js +1 -0
  351. package/dist/mcp/create-part.js.map +1 -1
  352. package/dist/mcp/fast-summary.d.ts +3 -0
  353. package/dist/mcp/fast-summary.js +46 -0
  354. package/dist/mcp/fast-summary.js.map +1 -0
  355. package/dist/mcp/guide.d.ts +3 -1
  356. package/dist/mcp/guide.js +15 -4
  357. package/dist/mcp/guide.js.map +1 -1
  358. package/dist/mcp/model-tool.d.ts +31 -0
  359. package/dist/mcp/model-tool.js +27 -0
  360. package/dist/mcp/model-tool.js.map +1 -0
  361. package/dist/mcp/render-tool.d.ts +33 -2
  362. package/dist/mcp/render-tool.js +21 -5
  363. package/dist/mcp/render-tool.js.map +1 -1
  364. package/dist/mcp/server.js +20 -8
  365. package/dist/mcp/server.js.map +1 -1
  366. package/dist/mcp/sheet-card-tools.d.ts +3 -1
  367. package/dist/mcp/sheet-card-tools.js +3 -1
  368. package/dist/mcp/sheet-card-tools.js.map +1 -1
  369. package/dist/mcp/simulate-tool.d.ts +10 -0
  370. package/dist/mcp/simulate-tool.js +12 -0
  371. package/dist/mcp/simulate-tool.js.map +1 -0
  372. package/dist/render/render.js +11327 -1645
  373. package/dist/studio/change-route.d.ts +18 -0
  374. package/dist/studio/change-route.js +24 -0
  375. package/dist/studio/change-route.js.map +1 -0
  376. package/dist/studio/http-error.d.ts +5 -0
  377. package/dist/studio/http-error.js +9 -0
  378. package/dist/studio/http-error.js.map +1 -0
  379. package/dist/studio/live.d.ts +2 -0
  380. package/dist/studio/live.js.map +1 -1
  381. package/dist/studio/server.js +43 -15
  382. package/dist/studio/server.js.map +1 -1
  383. package/dist/studio/verify-routes.d.ts +42 -0
  384. package/dist/studio/verify-routes.js +110 -0
  385. package/dist/studio/verify-routes.js.map +1 -0
  386. package/dist/version.d.ts +1 -1
  387. package/dist/version.js +1 -1
  388. package/library/modules/CanNode/CanNode.sheet.tsx +1 -1
  389. package/library/modules/CanNode/parts/MCP2515-I-SO/MCP2515_I_SO.tsx +1 -0
  390. package/library/modules/CanNode/parts/MCP2515-I-SO/part.yaml +2 -0
  391. package/library/modules/CanNode/parts/MCP2515-I-SO/verification.md +2 -1
  392. package/library/modules/CanNode/parts/TJA1051T-3/TJA1051T_3.tsx +1 -0
  393. package/library/modules/CanNode/parts/TJA1051T-3/part.yaml +2 -0
  394. package/library/modules/CanNode/parts/TJA1051T-3/verification.md +2 -1
  395. package/library/modules/DigitalInput24V/DigitalInput24V.sheet.tsx +7 -7
  396. package/library/modules/RelayDriver/RelayDriver.sheet.tsx +3 -3
  397. package/library/modules/RelayDriver/parts/AO3400A/part.yaml +34 -0
  398. package/library/modules/RelayDriver/parts/AO3400A/verification.md +11 -1
  399. package/library/modules/RelayDriver/parts/SRD-12VDC-SL-C/SRD_12VDC_SL_C.tsx +1 -0
  400. package/library/modules/RelayDriver/parts/SRD-12VDC-SL-C/part.yaml +14 -0
  401. package/library/modules/RelayDriver/parts/SRD-12VDC-SL-C/verification.md +4 -1
  402. package/package.json +2 -1
  403. package/skills/copperflow/references/copper.md +8 -0
  404. package/skills/copperflow/references/design-rules.md +57 -6
  405. package/skills/copperflow/references/editable-subset.md +18 -8
  406. package/skills/copperflow/references/modules.md +26 -0
  407. package/skills/copperflow/references/parts-library.md +2 -1
  408. package/skills/copperflow/references/writing-circuits.md +9 -0
  409. package/dist/app/assets/NewPartDialog-C4sKWnGI.js +0 -160
  410. package/dist/app/assets/index-BgzJedaB.css +0 -1
  411. package/dist/app/assets/index-C_U9me2P.js +0 -19
@@ -24,7 +24,19 @@ export interface FabricationProfile {
24
24
  * for the parts whose footprint is that part's footprint file; the profiles leave it out (0 then).
25
25
  */
26
26
  placementRotations?: PlacementRotations;
27
+ /** The finished board's thickness, in mm: what a via adds to a length, and on 2 layers the dielectric with the copper. */
28
+ boardThickness?: number;
29
+ /** The dielectric's relative permittivity, for impedance. */
30
+ permittivity?: number;
31
+ /** The outer copper's thickness, in mm, for impedance. */
32
+ copperThickness?: number;
33
+ /** Whether solder mask covers the outer tracks (the impedance estimate does not count it; it says so). */
34
+ solderMask?: boolean;
35
+ /** The dielectric under an outer track, in mm; on 2 layers the board minus its two coppers when left out. */
36
+ dielectricHeight?: number;
27
37
  }
38
+ /** A pair rule: two-net pairs by name, or "by-name" for nets whose names differ only by a pair ending. */
39
+ export type PairRule = "by-name" | [string, string][];
28
40
  export interface NetClass {
29
41
  name: string;
30
42
  trackWidth: number;
@@ -35,6 +47,24 @@ export interface NetClass {
35
47
  };
36
48
  /** Net name patterns with `*` and `?`. */
37
49
  patterns: string[];
50
+ /** Single-line impedance, in ohm. */
51
+ impedance?: number;
52
+ /** The pairs of this class. */
53
+ pair?: PairRule;
54
+ /** Differential impedance of its pairs, in ohm. */
55
+ differentialImpedance?: number;
56
+ /** The gap between the two tracks of a pair, in mm. */
57
+ gap?: number;
58
+ /** The most the two nets of a pair may differ in length, in mm. */
59
+ maxSkew?: number;
60
+ maxLength?: number;
61
+ /** Nets that must be the same length; `maxSpread` is the most longest and shortest may differ, in mm. */
62
+ matchGroup?: string;
63
+ maxSpread?: number;
64
+ /** The share of a pair's length, in percent, that must run side by side; 80 when left out. */
65
+ minCoupled?: number;
66
+ /** Set when trackWidth (and gap) came from the impedance: "50 ohm single" or "90 ohm differential at a 0.2 mm gap". */
67
+ widthFrom?: string;
38
68
  }
39
69
  export interface ClassClearance {
40
70
  a: string;
@@ -63,6 +93,11 @@ export declare const RulesFileSchema: z.ZodObject<{
63
93
  filletRadius: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>>;
64
94
  maskExpansion: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>>;
65
95
  pasteReduction: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>>;
96
+ boardThickness: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>>;
97
+ permittivity: z.ZodOptional<z.ZodNumber>;
98
+ copperThickness: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>>;
99
+ solderMask: z.ZodOptional<z.ZodBoolean>;
100
+ dielectricHeight: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>>;
66
101
  placementRotations: z.ZodOptional<z.ZodObject<{
67
102
  parts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
68
103
  }, z.core.$strict>>;
@@ -75,6 +110,15 @@ export declare const RulesFileSchema: z.ZodObject<{
75
110
  diameter: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>>;
76
111
  }, z.core.$strict>>;
77
112
  nets: z.ZodArray<z.ZodString>;
113
+ impedance: z.ZodOptional<z.ZodNumber>;
114
+ differentialImpedance: z.ZodOptional<z.ZodNumber>;
115
+ pair: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"by-name">, z.ZodArray<z.ZodTuple<[z.ZodString, z.ZodString], null>>]>>;
116
+ gap: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>>;
117
+ maxSkew: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>>;
118
+ maxLength: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>>;
119
+ matchGroup: z.ZodOptional<z.ZodString>;
120
+ maxSpread: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>>;
121
+ minCoupled: z.ZodOptional<z.ZodNumber>;
78
122
  }, z.core.$strict>>>;
79
123
  classClearance: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodString, z.ZodString, z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>], null>>>;
80
124
  globalNets: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -30,6 +30,11 @@ const FabricationSchema = z
30
30
  filletRadius: length.optional(),
31
31
  maskExpansion: nonNegativeLength.optional(),
32
32
  pasteReduction: nonNegativeLength.optional(),
33
+ boardThickness: length.optional(),
34
+ permittivity: z.number().min(1, "a relative permittivity of 1 or more, such as 4.6").max(20, "a relative permittivity of at most 20").optional(),
35
+ copperThickness: length.optional(),
36
+ solderMask: z.boolean().optional(),
37
+ dielectricHeight: length.optional(),
33
38
  placementRotations: z
34
39
  .object({
35
40
  ...Object.fromEntries(FOOTPRINT_FAMILIES.map((family) => [family, degrees.optional()])),
@@ -45,8 +50,18 @@ const NetClassSchema = z
45
50
  clearance: length.optional(),
46
51
  via: z.object({ drill: length.optional(), diameter: length.optional() }).strict().optional(),
47
52
  nets: z.array(z.string().min(1)),
53
+ impedance: z.number().min(10, "an impedance from 10 to 200 ohm").max(200, "an impedance from 10 to 200 ohm").optional(),
54
+ differentialImpedance: z.number().min(20, "a differential impedance from 20 to 300 ohm").max(300, "a differential impedance from 20 to 300 ohm").optional(),
55
+ pair: z.union([z.literal("by-name"), z.array(z.tuple([z.string().min(1), z.string().min(1)]))]).optional(),
56
+ gap: length.optional(),
57
+ maxSkew: nonNegativeLength.optional(),
58
+ maxLength: length.optional(),
59
+ matchGroup: z.string().min(1).optional(),
60
+ maxSpread: nonNegativeLength.optional(),
61
+ minCoupled: z.number().min(0, "a share from 0 to 100 %").max(100, "a share from 0 to 100 %").optional(),
48
62
  })
49
- .strict();
63
+ .strict()
64
+ .refine((c) => c.maxSpread === undefined || c.matchGroup !== undefined, { message: "maxSpread needs a matchGroup", path: ["maxSpread"] });
50
65
  /** What rules.yaml may hold; unknown keys are errors. */
51
66
  export const RulesFileSchema = z
52
67
  .object({
@@ -1 +1 @@
1
- {"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/engine/rules/schema.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/engine/rules/schema.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,13 @@
1
+ import type { Built } from "./from-circuit.js";
2
+ import type { NotConverged, Solved } from "./solve.js";
3
+ export declare const ANSWER_LINES = 40;
4
+ /** The one line a person or agent reads first: what this is and what it does not know. */
5
+ export declare const HONEST_LINE = "DC operating point from ideal sources and simple models: no time, no frequency, no temperature, no tolerance; chips are not modelled.";
6
+ /** Every net name's voltage (NaN when floating) and each part's figures: R1.i, R1.v, R1.p, Q1.vgs, K1.coil.i. */
7
+ export declare function figureValues(built: Built, solved: Solved): Map<string, number>;
8
+ /** The answer for a solved circuit. `all` shows the nets that have no name too. */
9
+ export declare function formatAnswer(built: Built, solved: Solved, options?: {
10
+ all?: boolean;
11
+ }): string;
12
+ /** The answer when Newton's method and source stepping both failed: the nodes that moved most, and no figures. */
13
+ export declare function formatNotConverged(result: NotConverged): string;
@@ -0,0 +1,101 @@
1
+ // The simulator's answer: at most 40 lines. The nets, the sources and the power drawn, then what a designer needs to
2
+ // see first (parts beyond a limit), then each part's voltage, current and power, largest power first, cut at the
3
+ // limit with the count left out. Also the figures a case can expect, by name.
4
+ import { naturalCompare } from "../order.js";
5
+ import { limitLines } from "./limits.js";
6
+ import { formatQuantity } from "./values.js";
7
+ export const ANSWER_LINES = 40;
8
+ const WIDTH = 110;
9
+ /** The one line a person or agent reads first: what this is and what it does not know. */
10
+ export const HONEST_LINE = "DC operating point from ideal sources and simple models: no time, no frequency, no temperature, no tolerance; chips are not modelled.";
11
+ const V = (value) => formatQuantity(value, "V");
12
+ const A = (value) => formatQuantity(value, "A");
13
+ const W = (value) => formatQuantity(value, "W");
14
+ /** Items after a prefix, wrapped into lines of about WIDTH characters. */
15
+ function wrapped(prefix, items, separator = ", ") {
16
+ const lines = [];
17
+ let line = prefix;
18
+ for (const item of items) {
19
+ const joined = line === prefix ? `${line}${item}` : `${line}${separator}${item}`;
20
+ if (joined.length > WIDTH && line !== prefix) {
21
+ lines.push(`${line}${separator.trimEnd()}`);
22
+ line = ` ${item}`;
23
+ }
24
+ else
25
+ line = joined;
26
+ }
27
+ lines.push(line);
28
+ return lines;
29
+ }
30
+ /** Every net name's voltage (NaN when floating) and each part's figures: R1.i, R1.v, R1.p, Q1.vgs, K1.coil.i. */
31
+ export function figureValues(built, solved) {
32
+ const values = new Map();
33
+ for (const [name, node] of built.netNodes)
34
+ values.set(name, built.floating.has(node) ? Number.NaN : (solved.volts[node] ?? 0));
35
+ for (const part of built.parts) {
36
+ const main = solved.elements[part.main];
37
+ if (!main)
38
+ continue;
39
+ const power = part.elements.reduce((sum, index) => sum + (solved.elements[index]?.p ?? 0), 0);
40
+ const stem = part.kind === "relay" ? `${part.name}.coil` : part.name;
41
+ values.set(`${stem}.v`, main.v);
42
+ values.set(`${stem}.i`, main.i);
43
+ values.set(`${stem}.p`, power);
44
+ if (part.kind === "relay")
45
+ for (const key of ["v", "i", "p"])
46
+ values.set(`${part.name}.${key}`, values.get(`${stem}.${key}`) ?? 0);
47
+ if (main.control !== undefined)
48
+ values.set(`${part.name}.${part.kind === "nmos" || part.kind === "pmos" ? "vgs" : "vbe"}`, main.control);
49
+ }
50
+ return values;
51
+ }
52
+ /** A MOSFET as a designer reads a switch: off, on (with its Vds), or between off and on. */
53
+ function switchState(main, f) {
54
+ const vgs = main.control ?? 0;
55
+ if (vgs < (f.vth ?? 0))
56
+ return "off";
57
+ if (vgs >= (f.rdsonAt ?? Number.POSITIVE_INFINITY) && main.region === "linear")
58
+ return `on (Vds ${V(Math.abs(main.v))})`;
59
+ return "between off and on";
60
+ }
61
+ function partLine(solved, part) {
62
+ const main = solved.elements[part.main];
63
+ const power = part.elements.reduce((sum, index) => sum + (solved.elements[index]?.p ?? 0), 0);
64
+ const what = part.kind === "relay" ? "relay coil" : part.kind;
65
+ const extra = main?.control === undefined ? "" : part.kind === "nmos" || part.kind === "pmos" ? `, gate ${V(main.control)}, ${switchState(main, part.figures)}` : `, base ${V(main.control)}`;
66
+ return { power, line: ` ${part.name} ${what} ${V(main?.v ?? 0)} ${A(main?.i ?? 0)} ${W(power)}${extra}` };
67
+ }
68
+ /** The answer for a solved circuit. `all` shows the nets that have no name too. */
69
+ export function formatAnswer(built, solved, options = {}) {
70
+ const shown = new Map();
71
+ for (const [name, node] of [...built.netNodes].sort(([a], [b]) => naturalCompare(a, b))) {
72
+ const named = !name.startsWith("net.") && !name.startsWith("net:");
73
+ if ((named || options.all) && !shown.has(node))
74
+ shown.set(node, name.replace(/^net[.:]/, ""));
75
+ }
76
+ const nets = [...shown].map(([node, name]) => `${name} ${built.floating.has(node) ? "floating" : V(solved.volts[node] ?? 0)}`);
77
+ const drawn = solved.sources.reduce((sum, source) => sum + source.volts * source.amps, 0);
78
+ const sources = solved.sources.map((source) => `${source.name} gives ${A(source.amps)} (${W(source.volts * source.amps)})`);
79
+ const limits = limitLines(built, solved);
80
+ const unmodelled = built.unmodelled.map((u) => (u.power.length === 0 ? u.part : `${u.part} (${u.power.map((p) => `${p.pin} ${built.floating.has(p.node) ? "floating" : V(solved.volts[p.node] ?? 0)}`).join(", ")})`));
81
+ const assumed = built.parts.filter((part) => part.assumed.length > 0).map((part) => `${part.name} ${part.assumed.join(", ")}`);
82
+ const head = [
83
+ HONEST_LINE,
84
+ ...wrapped("Nets: ", nets),
85
+ ...wrapped("Sources: ", [...sources, `total drawn ${W(drawn)}`]),
86
+ ...(limits.length === 0 ? ["Beyond a limit: none"] : ["Beyond a limit:", ...limits.map((line) => ` ${line}`)]),
87
+ ];
88
+ const tail = [...(unmodelled.length > 0 ? wrapped("Not modelled, their pins draw nothing: ", unmodelled, "; ") : []), ...(assumed.length > 0 ? wrapped("Assumed, not from a datasheet: ", assumed, "; ") : [])];
89
+ const parts = built.parts.map((part) => partLine(solved, part)).sort((a, b) => b.power - a.power);
90
+ const room = ANSWER_LINES - head.length - tail.length - 1;
91
+ const kept = parts.length <= room ? parts : parts.slice(0, Math.max(0, room - 1));
92
+ const left = parts.length - kept.length;
93
+ const body = parts.length === 0 ? [] : ["Parts, largest power first:", ...kept.map((part) => part.line), ...(left > 0 ? [` … ${left} more part${left === 1 ? "" : "s"}`] : [])];
94
+ return [...head, ...body, ...tail].slice(0, ANSWER_LINES).join("\n");
95
+ }
96
+ /** The answer when Newton's method and source stepping both failed: the nodes that moved most, and no figures. */
97
+ export function formatNotConverged(result) {
98
+ const moved = result.moved.map((m) => `${m.node} by ${V(Math.abs(m.delta))}`).join(", ");
99
+ return [HONEST_LINE, `Did not converge, even with the sources raised in steps; the nodes that moved most in the last step: ${moved}. No figures are given.`].join("\n");
100
+ }
101
+ //# sourceMappingURL=answer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"answer.js","sourceRoot":"","sources":["../../../src/engine/sim/answer.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,29 @@
1
+ import { z } from "zod";
2
+ import type { Circuit } from "../model.js";
3
+ import type { Model } from "./model-schema.js";
4
+ /** The most cases one sheet holds. */
5
+ export declare const CASE_LIMIT = 12;
6
+ export declare const CaseSchema: z.ZodObject<{
7
+ name: z.ZodString;
8
+ set: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"open">]>>;
9
+ closed: z.ZodOptional<z.ZodArray<z.ZodString>>;
10
+ coil: z.ZodOptional<z.ZodArray<z.ZodString>>;
11
+ expect: z.ZodRecord<z.ZodString, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
12
+ }, z.core.$strict>;
13
+ export type SimCase = z.infer<typeof CaseSchema>;
14
+ export declare const CasesSchema: z.ZodArray<z.ZodObject<{
15
+ name: z.ZodString;
16
+ set: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"open">]>>;
17
+ closed: z.ZodOptional<z.ZodArray<z.ZodString>>;
18
+ coil: z.ZodOptional<z.ZodArray<z.ZodString>>;
19
+ expect: z.ZodRecord<z.ZodString, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
20
+ }, z.core.$strict>>;
21
+ export interface CaseLine {
22
+ name: string;
23
+ passed: boolean;
24
+ text: string;
25
+ }
26
+ /** Runs each case on the circuit: "passed: <name>", or each figure that missed and its range. */
27
+ export declare function runCases(circuit: Circuit, models: ReadonlyMap<string, Model>, cases: readonly SimCase[]): CaseLine[];
28
+ /** `"24 V in": IN=24, GND=0; expects OUT 3.2 to 3.6` */
29
+ export declare function caseText(one: SimCase): string;
@@ -0,0 +1,63 @@
1
+ // A sheet's cases: named sets of sources with the ranges the module's figures must fall in. Written on the sheet's
2
+ // card (`<sheet cases={[…]}>`) as plain literals, run by simulate, one line each. Passing cases is not a person's
3
+ // verification of the module and is never shown as one.
4
+ import { z } from "zod";
5
+ import { simulateCircuit } from "./run.js";
6
+ import { formatQuantity } from "./values.js";
7
+ /** The most cases one sheet holds. */
8
+ export const CASE_LIMIT = 12;
9
+ const Range = z.tuple([z.number(), z.number()]).refine(([low, high]) => low <= high, "a range is [low, high] with low <= high");
10
+ export const CaseSchema = z
11
+ .object({
12
+ name: z.string().min(1).max(60).regex(/^[^\r\n]*$/, "one line"),
13
+ set: z.record(z.string(), z.union([z.number(), z.literal("open")])),
14
+ closed: z.array(z.string()).optional(),
15
+ coil: z.array(z.string()).optional(),
16
+ /** Net name or part figure (R1.i, R1.v, R1.p, Q1.vgs, K1.coil.i) to its [low, high] range. */
17
+ expect: z.record(z.string(), Range),
18
+ })
19
+ .strict();
20
+ export const CasesSchema = z.array(CaseSchema).max(CASE_LIMIT);
21
+ /** The unit of a figure by its name: amps for .i, watts for .p, volts for the rest. */
22
+ function unitOf(figure) {
23
+ if (figure.endsWith(".i"))
24
+ return "A";
25
+ if (figure.endsWith(".p"))
26
+ return "W";
27
+ return "V";
28
+ }
29
+ /** What a figure missed by, or undefined when it is in its range. */
30
+ function missOf(figure, [low, high], value) {
31
+ if (value === undefined)
32
+ return `${figure} is no net or figure of this circuit`;
33
+ const unit = unitOf(figure);
34
+ const wanted = `wanted ${formatQuantity(low, unit)} to ${formatQuantity(high, unit)}`;
35
+ if (Number.isNaN(value))
36
+ return `${figure} is floating, ${wanted}`;
37
+ return value < low || value > high ? `${figure} ${formatQuantity(value, unit)}, ${wanted}` : undefined;
38
+ }
39
+ /** Runs each case on the circuit: "passed: <name>", or each figure that missed and its range. */
40
+ export function runCases(circuit, models, cases) {
41
+ return cases.map((one) => {
42
+ const run = simulateCircuit(circuit, models, { set: one.set, ...(one.closed ? { closed: one.closed } : {}), ...(one.coil ? { coil: one.coil } : {}) });
43
+ if (!run.ok) {
44
+ const why = run.text.split("\n").slice(1).join(" ").replace(/\s+/g, " ").trim();
45
+ return { name: one.name, passed: false, text: `NOT RUN: ${one.name}: ${why}` };
46
+ }
47
+ const misses = Object.entries(one.expect).flatMap(([figure, range]) => {
48
+ const missed = missOf(figure, range, run.figures.get(figure));
49
+ return missed === undefined ? [] : [missed];
50
+ });
51
+ if (misses.length > 0)
52
+ return { name: one.name, passed: false, text: `MISSED: ${one.name}: ${misses.join("; ")}` };
53
+ return { name: one.name, passed: true, text: `passed: ${one.name}` };
54
+ });
55
+ }
56
+ /** `"24 V in": IN=24, GND=0; expects OUT 3.2 to 3.6` */
57
+ export function caseText(one) {
58
+ const set = Object.entries(one.set).map(([net, volts]) => `${net}=${volts}`);
59
+ const switches = [...(one.closed ?? []).map((name) => `${name} closed`), ...(one.coil ?? []).map((name) => `${name} energised`)];
60
+ const expects = Object.entries(one.expect).map(([figure, [low, high]]) => `${figure} ${low} to ${high}`);
61
+ return `"${one.name}": ${[...set, ...switches].join(", ")}; expects ${expects.join(", ")}`;
62
+ }
63
+ //# sourceMappingURL=cases.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cases.js","sourceRoot":"","sources":["../../../src/engine/sim/cases.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,109 @@
1
+ /** The thermal voltage kT/q at 300 K (27 °C), in volts. */
2
+ export declare const VT = 0.025852;
3
+ /** A diode's breakdown: `iz` flows at a reverse voltage of `vz`, rising e-fold every `nvt` volts beyond it. */
4
+ export interface Breakdown {
5
+ vz: number;
6
+ iz: number;
7
+ nvt: number;
8
+ }
9
+ /** A junction diode: Shockley's equation i = is (e^(v / (n VT)) - 1) behind a series resistance `rs`. */
10
+ export interface DiodeModel {
11
+ is: number;
12
+ n: number;
13
+ rs: number;
14
+ breakdown?: Breakdown;
15
+ }
16
+ export interface Curve {
17
+ i: number;
18
+ g: number;
19
+ }
20
+ /** The junction's current and slope at the junction voltage `v` (anode minus cathode, without `rs`). */
21
+ export declare function diodeCurve(model: DiodeModel, v: number): Curve;
22
+ /**
23
+ * The emission coefficient n and saturation current is from one point (vf at if, n given) or two (n from their
24
+ * slope). The series resistance rs, when given, is taken off each point first: the fitted curve meets every point.
25
+ */
26
+ export declare function fitDiode(figures: {
27
+ vf: number;
28
+ vfAt: number;
29
+ vf2?: number;
30
+ vf2At?: number;
31
+ rs?: number;
32
+ n: number;
33
+ }): {
34
+ is: number;
35
+ n: number;
36
+ rs: number;
37
+ };
38
+ /** A MOSFET's square law, fitted so that the on-resistance at the datasheet's gate voltage is the datasheet's. */
39
+ export interface MosModel {
40
+ /** The threshold, as a positive voltage for either channel. */
41
+ vth: number;
42
+ /** The square law's factor k in A/V²: id = k ((vgs - vth) vds - vds² / 2) below saturation. */
43
+ k: number;
44
+ /** The gate voltage at which the datasheet gives its on-resistance: at or above it the switch is fully on. */
45
+ vgsOn: number;
46
+ body: DiodeModel;
47
+ }
48
+ /** k from rds(on) at vgs: in the linear region near vds = 0 the channel's resistance is 1 / (k (vgs - vth)). */
49
+ export declare function fitMos(figures: {
50
+ vth: number;
51
+ rdson: number;
52
+ rdsonAt: number;
53
+ }): number;
54
+ export interface MosPoint {
55
+ id: number;
56
+ /** d id / d vgs and d id / d vds. */
57
+ gm: number;
58
+ gds: number;
59
+ region: "off" | "linear" | "saturation";
60
+ }
61
+ /** The drain current of an N channel (positive voltages) at vgs and vds >= 0. */
62
+ export declare function mosCurve(model: MosModel, vgs: number, vds: number): MosPoint;
63
+ /** A bipolar transistor in the Ebers-Moll transport form, with saturation current is and gains bf and br. */
64
+ export interface BjtModel {
65
+ is: number;
66
+ bf: number;
67
+ br: number;
68
+ }
69
+ export interface BjtPoint {
70
+ ic: number;
71
+ ib: number;
72
+ /** Partial derivatives of ic and ib by vbe and vbc. */
73
+ dic: {
74
+ be: number;
75
+ bc: number;
76
+ };
77
+ dib: {
78
+ be: number;
79
+ bc: number;
80
+ };
81
+ }
82
+ /** NPN currents into the collector and the base at vbe and vbc. */
83
+ export declare function bjtCurve(model: BjtModel, vbe: number, vbc: number): BjtPoint;
84
+ /** The forced gain at which a datasheet usually states vce(sat): ic / ib = 10. */
85
+ export declare const FORCED_GAIN = 10;
86
+ /** vce(sat) of the transport model at the forced gain: VT ln((1 / alphaR + forced / br) / (1 - forced / bf)). */
87
+ export declare function vceSat(bf: number, br: number, forced?: number): number;
88
+ /**
89
+ * is from vbe at ic (the transport current, n = 1), bf = hfe, and br found by bisection so that vce(sat) at the
90
+ * forced gain is the datasheet's; without vcesat, br = 1.
91
+ */
92
+ export declare function fitBjt(figures: {
93
+ hfe: number;
94
+ vbe: number;
95
+ vbeAt: number;
96
+ vcesat?: number;
97
+ }): BjtModel;
98
+ /** The junction voltage beyond which a step is limited: n VT ln(n VT / (√2 is)). */
99
+ export declare function criticalVoltage(model: {
100
+ is: number;
101
+ n: number;
102
+ }): number;
103
+ /**
104
+ * The step of a junction voltage from `previous` to `next` with large forward steps taken on a logarithm, as the
105
+ * textbook's limiting does, so Newton's method does not overshoot an exponential.
106
+ */
107
+ export declare function limitJunction(next: number, previous: number, nvt: number, critical: number): number;
108
+ /** The largest change of a MOSFET's gate voltage in one Newton step. */
109
+ export declare const GATE_STEP = 1;
@@ -0,0 +1,137 @@
1
+ // The device equations of the DC solver and how each is fitted to datasheet figures. The method is the textbook's:
2
+ // F. N. Najm, "Circuit Simulation", Wiley 2010 (ch. 2 for nodal analysis, ch. 3 for Newton's method and the limiting
3
+ // of junction voltage steps). Every model is a static curve i = f(v) with its slope, evaluated at 300 K.
4
+ /** The thermal voltage kT/q at 300 K (27 °C), in volts. */
5
+ export const VT = 0.025852;
6
+ /** Above this exponent a junction's exponential is continued as a straight line, so nothing overflows. */
7
+ const EXP_LIMIT = 60;
8
+ /** e^x and its slope, continued linearly above EXP_LIMIT. */
9
+ function expLimited(x) {
10
+ if (x <= EXP_LIMIT) {
11
+ const value = Math.exp(x);
12
+ return { value, slope: value };
13
+ }
14
+ const top = Math.exp(EXP_LIMIT);
15
+ return { value: top * (1 + x - EXP_LIMIT), slope: top };
16
+ }
17
+ /** The junction's current and slope at the junction voltage `v` (anode minus cathode, without `rs`). */
18
+ export function diodeCurve(model, v) {
19
+ const nvt = model.n * VT;
20
+ const forward = expLimited(v / nvt);
21
+ let i = model.is * (forward.value - 1);
22
+ let g = (model.is * forward.slope) / nvt;
23
+ const b = model.breakdown;
24
+ if (b) {
25
+ // Zero at 0 V and exactly iz at -vz: the offset e^(-vz / nvt) is taken out and the rest scaled back.
26
+ const floor = Math.exp(-b.vz / b.nvt);
27
+ const reverse = expLimited((-v - b.vz) / b.nvt);
28
+ const scale = b.iz / (1 - floor);
29
+ i -= scale * (reverse.value - floor);
30
+ g += (scale * reverse.slope) / b.nvt;
31
+ }
32
+ return { i, g: g + 1e-15 };
33
+ }
34
+ /**
35
+ * The emission coefficient n and saturation current is from one point (vf at if, n given) or two (n from their
36
+ * slope). The series resistance rs, when given, is taken off each point first: the fitted curve meets every point.
37
+ */
38
+ export function fitDiode(figures) {
39
+ const rs = figures.rs ?? 0;
40
+ const v1 = figures.vf - figures.vfAt * rs;
41
+ let n = figures.n;
42
+ if (figures.vf2 !== undefined && figures.vf2At !== undefined) {
43
+ const v2 = figures.vf2 - figures.vf2At * rs;
44
+ n = (v2 - v1) / (VT * Math.log(figures.vf2At / figures.vfAt));
45
+ }
46
+ if (!(n > 0) || !Number.isFinite(n))
47
+ throw new Error("the two forward points do not rise together; check vf, vfAt, vf2 and vf2At");
48
+ const is = figures.vfAt / Math.expm1(v1 / (n * VT));
49
+ return { is, n, rs };
50
+ }
51
+ /** k from rds(on) at vgs: in the linear region near vds = 0 the channel's resistance is 1 / (k (vgs - vth)). */
52
+ export function fitMos(figures) {
53
+ const overdrive = figures.rdsonAt - figures.vth;
54
+ if (!(overdrive > 0))
55
+ throw new Error(`rdsonAt (${figures.rdsonAt} V) must be above vth (${figures.vth} V)`);
56
+ return 1 / (figures.rdson * overdrive);
57
+ }
58
+ /** The drain current of an N channel (positive voltages) at vgs and vds >= 0. */
59
+ export function mosCurve(model, vgs, vds) {
60
+ const over = vgs - model.vth;
61
+ if (over <= 0)
62
+ return { id: 0, gm: 0, gds: 0, region: "off" };
63
+ if (vds < over)
64
+ return { id: model.k * (over * vds - (vds * vds) / 2), gm: model.k * vds, gds: model.k * (over - vds), region: "linear" };
65
+ return { id: (model.k / 2) * over * over, gm: model.k * over, gds: 0, region: "saturation" };
66
+ }
67
+ /** NPN currents into the collector and the base at vbe and vbc. */
68
+ export function bjtCurve(model, vbe, vbc) {
69
+ const fe = expLimited(vbe / VT);
70
+ const fc = expLimited(vbc / VT);
71
+ const transport = model.is * (fe.value - fc.value);
72
+ const ibe = (model.is / model.bf) * (fe.value - 1);
73
+ const ibc = (model.is / model.br) * (fc.value - 1);
74
+ const gbe = (model.is * fe.slope) / VT;
75
+ const gbc = (model.is * fc.slope) / VT;
76
+ return {
77
+ ic: transport - ibc,
78
+ ib: ibe + ibc,
79
+ dic: { be: gbe, bc: -gbc - gbc / model.br },
80
+ dib: { be: gbe / model.bf, bc: gbc / model.br },
81
+ };
82
+ }
83
+ /** The forced gain at which a datasheet usually states vce(sat): ic / ib = 10. */
84
+ export const FORCED_GAIN = 10;
85
+ /** vce(sat) of the transport model at the forced gain: VT ln((1 / alphaR + forced / br) / (1 - forced / bf)). */
86
+ export function vceSat(bf, br, forced = FORCED_GAIN) {
87
+ const alphaR = br / (1 + br);
88
+ return VT * Math.log((1 / alphaR + forced / br) / (1 - forced / bf));
89
+ }
90
+ /**
91
+ * is from vbe at ic (the transport current, n = 1), bf = hfe, and br found by bisection so that vce(sat) at the
92
+ * forced gain is the datasheet's; without vcesat, br = 1.
93
+ */
94
+ export function fitBjt(figures) {
95
+ if (!(figures.hfe > FORCED_GAIN))
96
+ throw new Error(`hfe must be above ${FORCED_GAIN}`);
97
+ const is = figures.vbeAt / Math.exp(figures.vbe / VT);
98
+ if (figures.vcesat === undefined)
99
+ return { is, bf: figures.hfe, br: 1 };
100
+ // vce(sat) falls as br rises; search br on a log scale between 0.01 and 1000.
101
+ let low = Math.log(0.01);
102
+ let high = Math.log(1000);
103
+ const at = (logBr) => vceSat(figures.hfe, Math.exp(logBr));
104
+ if (figures.vcesat >= at(low))
105
+ return { is, bf: figures.hfe, br: 0.01 };
106
+ if (figures.vcesat <= at(high))
107
+ return { is, bf: figures.hfe, br: 1000 };
108
+ for (let step = 0; step < 80; step++) {
109
+ const mid = (low + high) / 2;
110
+ if (at(mid) > figures.vcesat)
111
+ low = mid;
112
+ else
113
+ high = mid;
114
+ }
115
+ return { is, bf: figures.hfe, br: Math.exp((low + high) / 2) };
116
+ }
117
+ /** The junction voltage beyond which a step is limited: n VT ln(n VT / (√2 is)). */
118
+ export function criticalVoltage(model) {
119
+ const nvt = model.n * VT;
120
+ return nvt * Math.log(nvt / (Math.SQRT2 * model.is));
121
+ }
122
+ /**
123
+ * The step of a junction voltage from `previous` to `next` with large forward steps taken on a logarithm, as the
124
+ * textbook's limiting does, so Newton's method does not overshoot an exponential.
125
+ */
126
+ export function limitJunction(next, previous, nvt, critical) {
127
+ if (next <= critical || Math.abs(next - previous) <= 2 * nvt)
128
+ return next;
129
+ if (previous > 0) {
130
+ const arg = 1 + (next - previous) / nvt;
131
+ return arg > 0 ? previous + nvt * Math.log(arg) : critical;
132
+ }
133
+ return nvt * Math.log(next / nvt);
134
+ }
135
+ /** The largest change of a MOSFET's gate voltage in one Newton step. */
136
+ export const GATE_STEP = 1;
137
+ //# sourceMappingURL=devices.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"devices.js","sourceRoot":"","sources":["../../../src/engine/sim/devices.ts"],"names":[],"mappings":"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"}