copperflow 0.3.3 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (466) hide show
  1. package/README.md +142 -12
  2. package/dist/app/THIRD_PARTY_LICENSES.txt +5 -0
  3. package/dist/app/assets/NewPartDialog-BBJaZFCo.js +160 -0
  4. package/dist/app/assets/VerifyPartDialog-BHLqD_WJ.css +1 -0
  5. package/dist/app/assets/VerifyPartDialog-Ey6xpQ_U.js +2 -0
  6. package/dist/app/assets/index-BKoIKo22.css +1 -0
  7. package/dist/app/assets/index-DPmr2dR1.js +20 -0
  8. package/dist/app/assets/texture-worker-CyI_g_XZ.js +1 -0
  9. package/dist/app/index.html +2 -2
  10. package/dist/cli-commands.js +170 -23
  11. package/dist/cli-commands.js.map +1 -1
  12. package/dist/cli-impedance.d.ts +4 -0
  13. package/dist/cli-impedance.js +56 -0
  14. package/dist/cli-impedance.js.map +1 -0
  15. package/dist/cli-library.d.ts +5 -0
  16. package/dist/cli-library.js +58 -0
  17. package/dist/cli-library.js.map +1 -0
  18. package/dist/cli-modules.d.ts +6 -0
  19. package/dist/cli-modules.js +33 -0
  20. package/dist/cli-modules.js.map +1 -0
  21. package/dist/cli-simulate.d.ts +3 -0
  22. package/dist/cli-simulate.js +54 -0
  23. package/dist/cli-simulate.js.map +1 -0
  24. package/dist/cli-studio.d.ts +1 -0
  25. package/dist/cli-studio.js +27 -0
  26. package/dist/cli-studio.js.map +1 -0
  27. package/dist/core/analyze.js +5 -2
  28. package/dist/core/analyze.js.map +1 -1
  29. package/dist/core/board-import.d.ts +39 -0
  30. package/dist/core/board-import.js +114 -0
  31. package/dist/core/board-import.js.map +1 -0
  32. package/dist/core/board-shape-edit.d.ts +13 -0
  33. package/dist/core/board-shape-edit.js +134 -0
  34. package/dist/core/board-shape-edit.js.map +1 -0
  35. package/dist/core/bom.d.ts +6 -1
  36. package/dist/core/bom.js +23 -4
  37. package/dist/core/bom.js.map +1 -1
  38. package/dist/core/case-results.d.ts +4 -0
  39. package/dist/core/case-results.js +9 -0
  40. package/dist/core/case-results.js.map +1 -0
  41. package/dist/core/change-files.d.ts +31 -0
  42. package/dist/core/change-files.js +67 -0
  43. package/dist/core/change-files.js.map +1 -0
  44. package/dist/core/change-render.d.ts +18 -0
  45. package/dist/core/change-render.js +48 -0
  46. package/dist/core/change-render.js.map +1 -0
  47. package/dist/core/change-view.d.ts +33 -0
  48. package/dist/core/change-view.js +73 -0
  49. package/dist/core/change-view.js.map +1 -0
  50. package/dist/core/change-words.d.ts +39 -0
  51. package/dist/core/change-words.js +214 -0
  52. package/dist/core/change-words.js.map +1 -0
  53. package/dist/core/checklist-text.d.ts +21 -0
  54. package/dist/core/checklist-text.js +59 -0
  55. package/dist/core/checklist-text.js.map +1 -0
  56. package/dist/core/edit.js +12 -3
  57. package/dist/core/edit.js.map +1 -1
  58. package/dist/core/fabrication.d.ts +9 -2
  59. package/dist/core/fabrication.js +29 -10
  60. package/dist/core/fabrication.js.map +1 -1
  61. package/dist/core/git.d.ts +16 -0
  62. package/dist/core/git.js +51 -0
  63. package/dist/core/git.js.map +1 -0
  64. package/dist/core/home.d.ts +2 -0
  65. package/dist/core/home.js +10 -0
  66. package/dist/core/home.js.map +1 -0
  67. package/dist/core/index.d.ts +1 -0
  68. package/dist/core/index.js +1 -0
  69. package/dist/core/index.js.map +1 -1
  70. package/dist/core/instance-copper.d.ts +25 -0
  71. package/dist/core/instance-copper.js +142 -0
  72. package/dist/core/instance-copper.js.map +1 -0
  73. package/dist/core/instance-move.d.ts +23 -0
  74. package/dist/core/instance-move.js +59 -0
  75. package/dist/core/instance-move.js.map +1 -0
  76. package/dist/core/instance-requests.d.ts +3 -2
  77. package/dist/core/instance-requests.js +17 -3
  78. package/dist/core/instance-requests.js.map +1 -1
  79. package/dist/core/library-modules.d.ts +29 -0
  80. package/dist/core/library-modules.js +324 -0
  81. package/dist/core/library-modules.js.map +1 -0
  82. package/dist/core/library-sources.d.ts +33 -0
  83. package/dist/core/library-sources.js +179 -0
  84. package/dist/core/library-sources.js.map +1 -0
  85. package/dist/core/library.d.ts +46 -0
  86. package/dist/core/library.js +54 -16
  87. package/dist/core/library.js.map +1 -1
  88. package/dist/core/modules.d.ts +45 -0
  89. package/dist/core/modules.js +301 -0
  90. package/dist/core/modules.js.map +1 -0
  91. package/dist/core/new-circuit-sheets.d.ts +11 -2
  92. package/dist/core/new-circuit-sheets.js +35 -6
  93. package/dist/core/new-circuit-sheets.js.map +1 -1
  94. package/dist/core/order-report.d.ts +10 -0
  95. package/dist/core/order-report.js +93 -0
  96. package/dist/core/order-report.js.map +1 -0
  97. package/dist/core/pin-header.d.ts +5 -0
  98. package/dist/core/pin-header.js +77 -0
  99. package/dist/core/pin-header.js.map +1 -0
  100. package/dist/core/pin-map.d.ts +46 -0
  101. package/dist/core/pin-map.js +101 -0
  102. package/dist/core/pin-map.js.map +1 -0
  103. package/dist/core/placement-write.d.ts +2 -0
  104. package/dist/core/placement-write.js +12 -6
  105. package/dist/core/placement-write.js.map +1 -1
  106. package/dist/core/plain-sheet.d.ts +12 -0
  107. package/dist/core/plain-sheet.js +169 -0
  108. package/dist/core/plain-sheet.js.map +1 -0
  109. package/dist/core/render.d.ts +24 -4
  110. package/dist/core/render.js +16 -6
  111. package/dist/core/render.js.map +1 -1
  112. package/dist/core/sheet-card.d.ts +37 -0
  113. package/dist/core/sheet-card.js +163 -0
  114. package/dist/core/sheet-card.js.map +1 -0
  115. package/dist/core/sheet-files.js +10 -3
  116. package/dist/core/sheet-files.js.map +1 -1
  117. package/dist/core/simulate.d.ts +19 -0
  118. package/dist/core/simulate.js +72 -0
  119. package/dist/core/simulate.js.map +1 -0
  120. package/dist/core/step-export.d.ts +17 -0
  121. package/dist/core/step-export.js +35 -0
  122. package/dist/core/step-export.js.map +1 -0
  123. package/dist/core/supplier-prop.d.ts +6 -0
  124. package/dist/core/supplier-prop.js +21 -0
  125. package/dist/core/supplier-prop.js.map +1 -0
  126. package/dist/core/types.d.ts +20 -0
  127. package/dist/core/workspace.d.ts +6 -1
  128. package/dist/core/workspace.js +15 -3
  129. package/dist/core/workspace.js.map +1 -1
  130. package/dist/engine/board.js +3 -1
  131. package/dist/engine/board.js.map +1 -1
  132. package/dist/engine/checks/drc-parts.js +7 -7
  133. package/dist/engine/checks/drc-parts.js.map +1 -1
  134. package/dist/engine/checks/erc.js +35 -3
  135. package/dist/engine/checks/erc.js.map +1 -1
  136. package/dist/engine/checks/fast-lines.d.ts +60 -0
  137. package/dist/engine/checks/fast-lines.js +209 -0
  138. package/dist/engine/checks/fast-lines.js.map +1 -0
  139. package/dist/engine/checks/index.js +2 -0
  140. package/dist/engine/checks/index.js.map +1 -1
  141. package/dist/engine/component.d.ts +2 -0
  142. package/dist/engine/component.js +18 -1
  143. package/dist/engine/component.js.map +1 -1
  144. package/dist/engine/design-diff.d.ts +120 -0
  145. package/dist/engine/design-diff.js +249 -0
  146. package/dist/engine/design-diff.js.map +1 -0
  147. package/dist/engine/design.d.ts +3 -0
  148. package/dist/engine/design.js +7 -2
  149. package/dist/engine/design.js.map +1 -1
  150. package/dist/engine/dxf/board.d.ts +42 -0
  151. package/dist/engine/dxf/board.js +218 -0
  152. package/dist/engine/dxf/board.js.map +1 -0
  153. package/dist/engine/dxf/index.d.ts +2 -0
  154. package/dist/engine/dxf/index.js +3 -0
  155. package/dist/engine/dxf/index.js.map +1 -0
  156. package/dist/engine/dxf/reader.d.ts +43 -0
  157. package/dist/engine/dxf/reader.js +142 -0
  158. package/dist/engine/dxf/reader.js.map +1 -0
  159. package/dist/engine/elaborate.js +14 -4
  160. package/dist/engine/elaborate.js.map +1 -1
  161. package/dist/engine/fab/designator-places.d.ts +101 -0
  162. package/dist/engine/fab/designator-places.js +259 -0
  163. package/dist/engine/fab/designator-places.js.map +1 -0
  164. package/dist/engine/fab/designators.d.ts +26 -14
  165. package/dist/engine/fab/designators.js +320 -70
  166. package/dist/engine/fab/designators.js.map +1 -1
  167. package/dist/engine/fab/export.d.ts +17 -1
  168. package/dist/engine/fab/export.js +26 -4
  169. package/dist/engine/fab/export.js.map +1 -1
  170. package/dist/engine/fab/layers.js +6 -6
  171. package/dist/engine/fab/layers.js.map +1 -1
  172. package/dist/engine/fab/names.d.ts +2 -2
  173. package/dist/engine/fab/names.js +4 -2
  174. package/dist/engine/fab/names.js.map +1 -1
  175. package/dist/engine/fab/picture/board-picture.d.ts +52 -0
  176. package/dist/engine/fab/picture/board-picture.js +102 -0
  177. package/dist/engine/fab/picture/board-picture.js.map +1 -0
  178. package/dist/engine/fab/picture/board-view.d.ts +20 -0
  179. package/dist/engine/fab/picture/board-view.js +50 -0
  180. package/dist/engine/fab/picture/board-view.js.map +1 -0
  181. package/dist/engine/fab/picture/compose.d.ts +50 -0
  182. package/dist/engine/fab/picture/compose.js +208 -0
  183. package/dist/engine/fab/picture/compose.js.map +1 -0
  184. package/dist/engine/fab/picture/layer-images.d.ts +9 -0
  185. package/dist/engine/fab/picture/layer-images.js +67 -0
  186. package/dist/engine/fab/picture/layer-images.js.map +1 -0
  187. package/dist/engine/fab/picture/looks.d.ts +152 -0
  188. package/dist/engine/fab/picture/looks.js +53 -0
  189. package/dist/engine/fab/picture/looks.js.map +1 -0
  190. package/dist/engine/fab/picture/png.d.ts +31 -0
  191. package/dist/engine/fab/picture/png.js +47 -0
  192. package/dist/engine/fab/picture/png.js.map +1 -0
  193. package/dist/engine/fab/picture/raster.d.ts +46 -0
  194. package/dist/engine/fab/picture/raster.js +170 -0
  195. package/dist/engine/fab/picture/raster.js.map +1 -0
  196. package/dist/engine/fab/stroke-font.d.ts +2 -2
  197. package/dist/engine/fab/stroke-font.js +7 -6
  198. package/dist/engine/fab/stroke-font.js.map +1 -1
  199. package/dist/engine/fab/zip.d.ts +2 -1
  200. package/dist/engine/fab/zip.js +1 -1
  201. package/dist/engine/fab/zip.js.map +1 -1
  202. package/dist/engine/impedance.d.ts +72 -0
  203. package/dist/engine/impedance.js +133 -0
  204. package/dist/engine/impedance.js.map +1 -0
  205. package/dist/engine/line-length.d.ts +15 -0
  206. package/dist/engine/line-length.js +116 -0
  207. package/dist/engine/line-length.js.map +1 -0
  208. package/dist/engine/model.d.ts +17 -1
  209. package/dist/engine/model.js.map +1 -1
  210. package/dist/engine/pcb-place/block-board.d.ts +9 -0
  211. package/dist/engine/pcb-place/block-board.js +256 -0
  212. package/dist/engine/pcb-place/block-board.js.map +1 -0
  213. package/dist/engine/pcb-place/blocks.d.ts +31 -6
  214. package/dist/engine/pcb-place/blocks.js +37 -8
  215. package/dist/engine/pcb-place/blocks.js.map +1 -1
  216. package/dist/engine/pcb-place/constructive.d.ts +3 -2
  217. package/dist/engine/pcb-place/constructive.js +14 -2
  218. package/dist/engine/pcb-place/constructive.js.map +1 -1
  219. package/dist/engine/pcb-place/index.d.ts +8 -0
  220. package/dist/engine/pcb-place/index.js +7 -0
  221. package/dist/engine/pcb-place/index.js.map +1 -1
  222. package/dist/engine/pcb-place/roles.d.ts +3 -1
  223. package/dist/engine/pcb-place/roles.js +5 -0
  224. package/dist/engine/pcb-place/roles.js.map +1 -1
  225. package/dist/engine/pcb-place/scope.js +6 -1
  226. package/dist/engine/pcb-place/scope.js.map +1 -1
  227. package/dist/engine/pcb.d.ts +6 -0
  228. package/dist/engine/pcb.js +12 -1
  229. package/dist/engine/pcb.js.map +1 -1
  230. package/dist/engine/router/replicate.js +4 -0
  231. package/dist/engine/router/replicate.js.map +1 -1
  232. package/dist/engine/router/route-board.d.ts +2 -0
  233. package/dist/engine/router/route-board.js +27 -1
  234. package/dist/engine/router/route-board.js.map +1 -1
  235. package/dist/engine/rules/impedance-widths.d.ts +20 -0
  236. package/dist/engine/rules/impedance-widths.js +57 -0
  237. package/dist/engine/rules/impedance-widths.js.map +1 -0
  238. package/dist/engine/rules/load.js +11 -2
  239. package/dist/engine/rules/load.js.map +1 -1
  240. package/dist/engine/rules/pairs.d.ts +27 -0
  241. package/dist/engine/rules/pairs.js +86 -0
  242. package/dist/engine/rules/pairs.js.map +1 -0
  243. package/dist/engine/rules/profiles.js +16 -0
  244. package/dist/engine/rules/profiles.js.map +1 -1
  245. package/dist/engine/rules/schema.d.ts +44 -0
  246. package/dist/engine/rules/schema.js +16 -1
  247. package/dist/engine/rules/schema.js.map +1 -1
  248. package/dist/engine/sheet-ports.d.ts +17 -1
  249. package/dist/engine/sheet-ports.js +38 -1
  250. package/dist/engine/sheet-ports.js.map +1 -1
  251. package/dist/engine/sim/answer.d.ts +13 -0
  252. package/dist/engine/sim/answer.js +101 -0
  253. package/dist/engine/sim/answer.js.map +1 -0
  254. package/dist/engine/sim/cases.d.ts +29 -0
  255. package/dist/engine/sim/cases.js +63 -0
  256. package/dist/engine/sim/cases.js.map +1 -0
  257. package/dist/engine/sim/devices.d.ts +109 -0
  258. package/dist/engine/sim/devices.js +137 -0
  259. package/dist/engine/sim/devices.js.map +1 -0
  260. package/dist/engine/sim/elements.d.ts +49 -0
  261. package/dist/engine/sim/elements.js +2 -0
  262. package/dist/engine/sim/elements.js.map +1 -0
  263. package/dist/engine/sim/from-circuit.d.ts +52 -0
  264. package/dist/engine/sim/from-circuit.js +354 -0
  265. package/dist/engine/sim/from-circuit.js.map +1 -0
  266. package/dist/engine/sim/limits.d.ts +12 -0
  267. package/dist/engine/sim/limits.js +79 -0
  268. package/dist/engine/sim/limits.js.map +1 -0
  269. package/dist/engine/sim/linear.d.ts +2 -0
  270. package/dist/engine/sim/linear.js +49 -0
  271. package/dist/engine/sim/linear.js.map +1 -0
  272. package/dist/engine/sim/model-schema.d.ts +246 -0
  273. package/dist/engine/sim/model-schema.js +115 -0
  274. package/dist/engine/sim/model-schema.js.map +1 -0
  275. package/dist/engine/sim/part-models.d.ts +47 -0
  276. package/dist/engine/sim/part-models.js +102 -0
  277. package/dist/engine/sim/part-models.js.map +1 -0
  278. package/dist/engine/sim/run.d.ts +14 -0
  279. package/dist/engine/sim/run.js +13 -0
  280. package/dist/engine/sim/run.js.map +1 -0
  281. package/dist/engine/sim/solve.d.ts +42 -0
  282. package/dist/engine/sim/solve.js +294 -0
  283. package/dist/engine/sim/solve.js.map +1 -0
  284. package/dist/engine/sim/spice.d.ts +5 -0
  285. package/dist/engine/sim/spice.js +66 -0
  286. package/dist/engine/sim/spice.js.map +1 -0
  287. package/dist/engine/sim/values.d.ts +4 -0
  288. package/dist/engine/sim/values.js +40 -0
  289. package/dist/engine/sim/values.js.map +1 -0
  290. package/dist/engine/solid/heights.d.ts +29 -0
  291. package/dist/engine/solid/heights.js +87 -0
  292. package/dist/engine/solid/heights.js.map +1 -0
  293. package/dist/engine/solid/limits.d.ts +7 -0
  294. package/dist/engine/solid/limits.js +20 -0
  295. package/dist/engine/solid/limits.js.map +1 -0
  296. package/dist/engine/solid/model.d.ts +54 -0
  297. package/dist/engine/solid/model.js +147 -0
  298. package/dist/engine/solid/model.js.map +1 -0
  299. package/dist/engine/solid/step.d.ts +5 -0
  300. package/dist/engine/solid/step.js +164 -0
  301. package/dist/engine/solid/step.js.map +1 -0
  302. package/dist/engine/solid/thickness.d.ts +11 -0
  303. package/dist/engine/solid/thickness.js +10 -0
  304. package/dist/engine/solid/thickness.js.map +1 -0
  305. package/dist/library/kicad/board.d.ts +26 -0
  306. package/dist/library/kicad/board.js +96 -0
  307. package/dist/library/kicad/board.js.map +1 -0
  308. package/dist/library/kicad/copper.d.ts +44 -0
  309. package/dist/library/kicad/copper.js +106 -0
  310. package/dist/library/kicad/copper.js.map +1 -0
  311. package/dist/library/kicad/footprints.d.ts +62 -0
  312. package/dist/library/kicad/footprints.js +184 -0
  313. package/dist/library/kicad/footprints.js.map +1 -0
  314. package/dist/library/kicad/geometry.d.ts +36 -0
  315. package/dist/library/kicad/geometry.js +84 -0
  316. package/dist/library/kicad/geometry.js.map +1 -0
  317. package/dist/library/kicad/import.d.ts +58 -0
  318. package/dist/library/kicad/import.js +240 -0
  319. package/dist/library/kicad/import.js.map +1 -0
  320. package/dist/library/kicad/plan.d.ts +40 -0
  321. package/dist/library/kicad/plan.js +139 -0
  322. package/dist/library/kicad/plan.js.map +1 -0
  323. package/dist/library/kicad/read.d.ts +30 -0
  324. package/dist/library/kicad/read.js +105 -0
  325. package/dist/library/kicad/read.js.map +1 -0
  326. package/dist/library/kicad/sexpr.d.ts +36 -0
  327. package/dist/library/kicad/sexpr.js +153 -0
  328. package/dist/library/kicad/sexpr.js.map +1 -0
  329. package/dist/library/kicad/tally.d.ts +32 -0
  330. package/dist/library/kicad/tally.js +55 -0
  331. package/dist/library/kicad/tally.js.map +1 -0
  332. package/dist/library/kicad/write.d.ts +37 -0
  333. package/dist/library/kicad/write.js +146 -0
  334. package/dist/library/kicad/write.js.map +1 -0
  335. package/dist/library/new-part.d.ts +2 -0
  336. package/dist/library/new-part.js +1 -0
  337. package/dist/library/new-part.js.map +1 -1
  338. package/dist/mcp/batch.d.ts +2 -2
  339. package/dist/mcp/batch.js +12 -12
  340. package/dist/mcp/batch.js.map +1 -1
  341. package/dist/mcp/board-import-tool.d.ts +25 -0
  342. package/dist/mcp/board-import-tool.js +35 -0
  343. package/dist/mcp/board-import-tool.js.map +1 -0
  344. package/dist/mcp/board-summary.d.ts +1 -1
  345. package/dist/mcp/board-summary.js +1 -1
  346. package/dist/mcp/board-summary.js.map +1 -1
  347. package/dist/mcp/copper-summary.d.ts +2 -0
  348. package/dist/mcp/copper-summary.js +4 -2
  349. package/dist/mcp/copper-summary.js.map +1 -1
  350. package/dist/mcp/copper-tools.d.ts +4 -4
  351. package/dist/mcp/copper-tools.js +19 -19
  352. package/dist/mcp/copper-tools.js.map +1 -1
  353. package/dist/mcp/create-part.d.ts +24 -1
  354. package/dist/mcp/create-part.js +9 -8
  355. package/dist/mcp/create-part.js.map +1 -1
  356. package/dist/mcp/datasheet-tools.d.ts +1 -1
  357. package/dist/mcp/datasheet-tools.js +4 -4
  358. package/dist/mcp/datasheet-tools.js.map +1 -1
  359. package/dist/mcp/fast-summary.d.ts +3 -0
  360. package/dist/mcp/fast-summary.js +46 -0
  361. package/dist/mcp/fast-summary.js.map +1 -0
  362. package/dist/mcp/fillet-tools.d.ts +2 -2
  363. package/dist/mcp/fillet-tools.js +6 -6
  364. package/dist/mcp/fillet-tools.js.map +1 -1
  365. package/dist/mcp/guide.d.ts +1 -1
  366. package/dist/mcp/guide.js +4 -3
  367. package/dist/mcp/guide.js.map +1 -1
  368. package/dist/mcp/import-part.d.ts +1 -1
  369. package/dist/mcp/import-part.js +4 -4
  370. package/dist/mcp/import-part.js.map +1 -1
  371. package/dist/mcp/make-sheet.d.ts +1 -1
  372. package/dist/mcp/make-sheet.js +6 -6
  373. package/dist/mcp/make-sheet.js.map +1 -1
  374. package/dist/mcp/module-tools.d.ts +4 -0
  375. package/dist/mcp/module-tools.js +21 -0
  376. package/dist/mcp/module-tools.js.map +1 -0
  377. package/dist/mcp/new-circuit.d.ts +13 -2
  378. package/dist/mcp/new-circuit.js +30 -28
  379. package/dist/mcp/new-circuit.js.map +1 -1
  380. package/dist/mcp/open-studio.d.ts +30 -0
  381. package/dist/mcp/open-studio.js +97 -0
  382. package/dist/mcp/open-studio.js.map +1 -0
  383. package/dist/mcp/place-tools.d.ts +2 -2
  384. package/dist/mcp/place-tools.js +14 -11
  385. package/dist/mcp/place-tools.js.map +1 -1
  386. package/dist/mcp/pour-tools.d.ts +4 -4
  387. package/dist/mcp/pour-tools.js +18 -18
  388. package/dist/mcp/pour-tools.js.map +1 -1
  389. package/dist/mcp/project-tools.d.ts +3 -3
  390. package/dist/mcp/project-tools.js +8 -8
  391. package/dist/mcp/project-tools.js.map +1 -1
  392. package/dist/mcp/render-tool.d.ts +33 -2
  393. package/dist/mcp/render-tool.js +23 -7
  394. package/dist/mcp/render-tool.js.map +1 -1
  395. package/dist/mcp/route-tools.d.ts +2 -2
  396. package/dist/mcp/route-tools.js +10 -10
  397. package/dist/mcp/route-tools.js.map +1 -1
  398. package/dist/mcp/server.js +60 -34
  399. package/dist/mcp/server.js.map +1 -1
  400. package/dist/mcp/sheet-card-tools.d.ts +30 -0
  401. package/dist/mcp/sheet-card-tools.js +47 -0
  402. package/dist/mcp/sheet-card-tools.js.map +1 -0
  403. package/dist/mcp/simulate-tool.d.ts +10 -0
  404. package/dist/mcp/simulate-tool.js +12 -0
  405. package/dist/mcp/simulate-tool.js.map +1 -0
  406. package/dist/render/render.js +8178 -118
  407. package/dist/studio/change-route.d.ts +18 -0
  408. package/dist/studio/change-route.js +24 -0
  409. package/dist/studio/change-route.js.map +1 -0
  410. package/dist/studio/http-error.d.ts +5 -0
  411. package/dist/studio/http-error.js +9 -0
  412. package/dist/studio/http-error.js.map +1 -0
  413. package/dist/studio/idle.d.ts +7 -0
  414. package/dist/studio/idle.js +34 -0
  415. package/dist/studio/idle.js.map +1 -0
  416. package/dist/studio/live.d.ts +2 -0
  417. package/dist/studio/live.js.map +1 -1
  418. package/dist/studio/place-runner.js +1 -1
  419. package/dist/studio/place-runner.js.map +1 -1
  420. package/dist/studio/run-studio.d.ts +21 -0
  421. package/dist/studio/run-studio.js +68 -0
  422. package/dist/studio/run-studio.js.map +1 -0
  423. package/dist/studio/server.d.ts +5 -0
  424. package/dist/studio/server.js +66 -16
  425. package/dist/studio/server.js.map +1 -1
  426. package/dist/studio/studio-control.d.ts +6 -0
  427. package/dist/studio/studio-control.js +14 -0
  428. package/dist/studio/studio-control.js.map +1 -0
  429. package/dist/studio/studio-note.d.ts +33 -0
  430. package/dist/studio/studio-note.js +130 -0
  431. package/dist/studio/studio-note.js.map +1 -0
  432. package/dist/studio/verify-routes.d.ts +42 -0
  433. package/dist/studio/verify-routes.js +110 -0
  434. package/dist/studio/verify-routes.js.map +1 -0
  435. package/dist/version.d.ts +1 -1
  436. package/dist/version.js +1 -1
  437. package/library/modules/CanNode/CanNode.sheet.tsx +65 -0
  438. package/library/modules/CanNode/module.json +4 -0
  439. package/library/modules/CanNode/parts/MCP2515-I-SO/MCP2515_I_SO.tsx +11 -0
  440. package/library/modules/CanNode/parts/MCP2515-I-SO/part.yaml +66 -0
  441. package/library/modules/CanNode/parts/MCP2515-I-SO/verification.md +43 -0
  442. package/library/modules/CanNode/parts/TJA1051T-3/TJA1051T_3.tsx +11 -0
  443. package/library/modules/CanNode/parts/TJA1051T-3/part.yaml +36 -0
  444. package/library/modules/CanNode/parts/TJA1051T-3/verification.md +29 -0
  445. package/library/modules/DigitalInput24V/DigitalInput24V.sheet.tsx +24 -0
  446. package/library/modules/DigitalInput24V/module.json +4 -0
  447. package/library/modules/RelayDriver/RelayDriver.sheet.tsx +39 -0
  448. package/library/modules/RelayDriver/module.json +4 -0
  449. package/library/modules/RelayDriver/parts/AO3400A/AO3400A.tsx +11 -0
  450. package/library/modules/RelayDriver/parts/AO3400A/part.yaml +55 -0
  451. package/library/modules/RelayDriver/parts/AO3400A/verification.md +34 -0
  452. package/library/modules/RelayDriver/parts/SRD-12VDC-SL-C/SRD_12VDC_SL_C.tsx +12 -0
  453. package/library/modules/RelayDriver/parts/SRD-12VDC-SL-C/footprint.yaml +70 -0
  454. package/library/modules/RelayDriver/parts/SRD-12VDC-SL-C/part.yaml +45 -0
  455. package/library/modules/RelayDriver/parts/SRD-12VDC-SL-C/verification.md +40 -0
  456. package/package.json +2 -1
  457. package/skills/copperflow/SKILL.md +16 -16
  458. package/skills/copperflow/references/copper.md +89 -6
  459. package/skills/copperflow/references/design-rules.md +48 -0
  460. package/skills/copperflow/references/modules.md +106 -0
  461. package/skills/copperflow/references/planning.md +55 -11
  462. package/skills/copperflow/references/writing-circuits.md +32 -3
  463. package/skills/copperflow-plan/SKILL.md +7 -4
  464. package/dist/app/assets/NewPartDialog-B_cnPuI-.js +0 -160
  465. package/dist/app/assets/index-CSWIIMFE.css +0 -1
  466. package/dist/app/assets/index-CjN3tctq.js +0 -19
@@ -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":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAA2B,MAAM,gBAAgB,CAAA;AAoF7F,gCAAgC;AAEhC,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;IACxE,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,CAAA;IACjC,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,GAAG,CAAC;QAAE,OAAO,MAAM,CAAA;IACrD,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,MAAM,CAAC,KAAK,CAAC,uDAAuD,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAA;IACpI,OAAO,CAAC,CAAC,KAAK,CAAA;AAChB,CAAC,CAAC,CAAA;AAEF,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;IACnF,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,CAAA;IACjC,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,IAAI,CAAC;QAAE,OAAO,MAAM,CAAA;IACtD,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,MAAM,CAAC,KAAK,CAAC,0DAA0D,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAA;IACvI,OAAO,CAAC,CAAC,KAAK,CAAA;AAChB,CAAC,CAAC,CAAA;AAEF,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,CAAA;AAEnC,MAAM,iBAAiB,GAAG,CAAC;KACxB,MAAM,CAAC;IACN,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,aAAa,EAAE,MAAM,CAAC,QAAQ,EAAE;IAChC,YAAY,EAAE,MAAM,CAAC,QAAQ,EAAE;IAC/B,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE;IAC3B,cAAc,EAAE,MAAM,CAAC,QAAQ,EAAE;IACjC,kBAAkB,EAAE,MAAM,CAAC,QAAQ,EAAE;IACrC,aAAa,EAAE,MAAM,CAAC,QAAQ,EAAE;IAChC,YAAY,EAAE,MAAM,CAAC,QAAQ,EAAE;IAC/B,YAAY,EAAE,MAAM,CAAC,QAAQ,EAAE;IAC/B,aAAa,EAAE,iBAAiB,CAAC,QAAQ,EAAE;IAC3C,cAAc,EAAE,iBAAiB,CAAC,QAAQ,EAAE;IAC5C,cAAc,EAAE,MAAM,CAAC,QAAQ,EAAE;IACjC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,mDAAmD,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,uCAAuC,CAAC,CAAC,QAAQ,EAAE;IAChJ,eAAe,EAAE,MAAM,CAAC,QAAQ,EAAE;IAClC,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAClC,gBAAgB,EAAE,MAAM,CAAC,QAAQ,EAAE;IACnC,kBAAkB,EAAE,CAAC;SAClB,MAAM,CAAC;QACN,GAAG,MAAM,CAAC,WAAW,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QACvF,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,eAAe,EAAE,mCAAmC,CAAC,EAAE,OAAO,CAAC,CAAC,QAAQ,EAAE;KAC5G,CAAC;SACD,MAAM,EAAE;SACR,QAAQ,EAAE;CACd,CAAC;KACD,MAAM,EAAE,CAAA;AAEX,MAAM,cAAc,GAAG,CAAC;KACrB,MAAM,CAAC;IACN,UAAU,EAAE,MAAM,CAAC,QAAQ,EAAE;IAC7B,SAAS,EAAE,MAAM,CAAC,QAAQ,EAAE;IAC5B,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5F,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAChC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,iCAAiC,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,iCAAiC,CAAC,CAAC,QAAQ,EAAE;IACvH,qBAAqB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,6CAA6C,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,6CAA6C,CAAC,CAAC,QAAQ,EAAE;IAC3J,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC1G,GAAG,EAAE,MAAM,CAAC,QAAQ,EAAE;IACtB,OAAO,EAAE,iBAAiB,CAAC,QAAQ,EAAE;IACrC,SAAS,EAAE,MAAM,CAAC,QAAQ,EAAE;IAC5B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACxC,SAAS,EAAE,iBAAiB,CAAC,QAAQ,EAAE;IACvC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,yBAAyB,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,yBAAyB,CAAC,CAAC,QAAQ,EAAE;CACxG,CAAC;KACD,MAAM,EAAE;KACR,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,SAAS,IAAI,CAAC,CAAC,UAAU,KAAK,SAAS,EAAE,EAAE,OAAO,EAAE,8BAA8B,EAAE,IAAI,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,CAAA;AAE3I,yDAAyD;AACzD,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC;KAC7B,MAAM,CAAC;IACN,WAAW,EAAE,iBAAiB,CAAC,QAAQ,EAAE;IACzC,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,cAAc,CAAC,CAAC,QAAQ,EAAE;IAC3D,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC7E,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CAClD,CAAC;KACD,MAAM,EAAE,CAAA"}
@@ -1,6 +1,15 @@
1
1
  import { type CfElement } from "./jsx-runtime.js";
2
- import type { Diagnostic, SheetSize, Side, SourceRef } from "./model.js";
2
+ import type { Diagnostic, PinType, SheetCard, SheetSize, Side, SourceRef } from "./model.js";
3
3
  export declare const PORT_SIDES: readonly Side[];
4
+ /** The pin types a port may be: the instance's pin is of that type. */
5
+ export declare const PORT_TYPES: readonly PinType[];
6
+ /** The longest `does`, `carries` and source a card holds, and how many sources. */
7
+ export declare const CARD_LIMITS: {
8
+ readonly does: 160;
9
+ readonly carries: 80;
10
+ readonly source: 200;
11
+ readonly sources: 8;
12
+ };
4
13
  /** One `<port>` as written. `side` and `order` are absent when not written (or written badly). */
5
14
  export interface WrittenPort {
6
15
  name: string;
@@ -8,6 +17,8 @@ export interface WrittenPort {
8
17
  order?: number;
9
18
  /** A bus port: its name is a bus name ("D[0:7]" or a plain net name) and it joins the bus's members by name. */
10
19
  bus: boolean;
20
+ type?: PinType;
21
+ carries?: string;
11
22
  }
12
23
  /** A port with its place on the symbol: the side, and the 1-based slot along it, from the top or from the left. */
13
24
  export interface PlacedPortSpec extends WrittenPort {
@@ -20,6 +31,11 @@ export declare function portNameOk(name: unknown, bus: boolean): name is string;
20
31
  export declare const portMembers: (port: Pick<WrittenPort, "name" | "bus">) => string[];
21
32
  /** The side a port goes to when it writes none: ground at the bottom, outputs right, inputs and power left. */
22
33
  export declare function defaultPortSide(name: string): Side;
34
+ /** What a `<sheet does sources>` says of itself; a bad one is an error and left out. */
35
+ export declare function readSheetCard(props: Readonly<Record<string, unknown>>, sheet: string, at: SourceRef): {
36
+ card: SheetCard;
37
+ diagnostics: Diagnostic[];
38
+ };
23
39
  /**
24
40
  * The `<port>` elements of a sheet in the order written, each name once, with their diagnostics. Components inside
25
41
  * are not entered. A bad port is an error and left out.
@@ -7,6 +7,10 @@ import { isElement } from "./jsx-runtime.js";
7
7
  import { labelStyle } from "./schematic-nets.js";
8
8
  import { NET_NAME } from "./selectors.js";
9
9
  export const PORT_SIDES = ["left", "right", "top", "bottom"];
10
+ /** The pin types a port may be: the instance's pin is of that type. */
11
+ export const PORT_TYPES = ["power_in", "power_out", "ground", "input", "output", "bidirectional", "passive"];
12
+ /** The longest `does`, `carries` and source a card holds, and how many sources. */
13
+ export const CARD_LIMITS = { does: 160, carries: 80, source: 200, sources: 8 };
10
14
  const WHOLE_NET_NAME = new RegExp(`^${NET_NAME.source}$`);
11
15
  /** A name an output is known by: OUT, VOUT, DOUT, OUT1, TX_OUT. */
12
16
  const OUTPUT_NAME = /OUT/i;
@@ -25,7 +29,7 @@ export function defaultPortSide(name) {
25
29
  return OUTPUT_NAME.test(name) ? "right" : "left";
26
30
  }
27
31
  function readOne(element, at, found) {
28
- const { name, side, order, bus } = element.props;
32
+ const { name, side, order, bus, type, carries } = element.props;
29
33
  const isBus = bus === true;
30
34
  const bad = (what, item) => found.push(diagnostic("bad-value", "error", what, [item], at));
31
35
  if (bus !== undefined && typeof bus !== "boolean")
@@ -48,8 +52,41 @@ function readOne(element, at, found) {
48
52
  else
49
53
  bad(`Port ${name}: order must be a whole number above 0; the next free place is used`, `${name}.order`);
50
54
  }
55
+ if (type !== undefined) {
56
+ if (typeof type === "string" && PORT_TYPES.includes(type))
57
+ port.type = type;
58
+ else
59
+ bad(`Port ${name}: type must be one of ${PORT_TYPES.join(", ")}; it is read as passive`, `${name}.type`);
60
+ }
61
+ if (carries !== undefined) {
62
+ if (typeof carries === "string" && carries.trim() !== "" && carries.length <= CARD_LIMITS.carries)
63
+ port.carries = carries;
64
+ else
65
+ bad(`Port ${name}: carries must be a text of at most ${CARD_LIMITS.carries} characters; it is ignored`, `${name}.carries`);
66
+ }
51
67
  return port;
52
68
  }
69
+ /** What a `<sheet does sources>` says of itself; a bad one is an error and left out. */
70
+ export function readSheetCard(props, sheet, at) {
71
+ const card = {};
72
+ const diagnostics = [];
73
+ const bad = (what, item) => diagnostics.push(diagnostic("bad-value", "error", `${sheet}: <sheet> ${what}; it is ignored`, [`${sheet}.${item}`], at));
74
+ const { does, sources } = props;
75
+ if (does !== undefined) {
76
+ if (typeof does === "string" && does.trim() !== "" && does.length <= CARD_LIMITS.does)
77
+ card.does = does;
78
+ else
79
+ bad(`does must be a text of at most ${CARD_LIMITS.does} characters`, "does");
80
+ }
81
+ if (sources !== undefined) {
82
+ const ok = (item) => typeof item === "string" && item.trim() !== "" && item.length <= CARD_LIMITS.source;
83
+ if (Array.isArray(sources) && sources.length <= CARD_LIMITS.sources && sources.every(ok))
84
+ card.sources = [...sources];
85
+ else
86
+ bad(`sources must be a list of at most ${CARD_LIMITS.sources} texts of at most ${CARD_LIMITS.source} characters`, "sources");
87
+ }
88
+ return { card, diagnostics };
89
+ }
53
90
  /**
54
91
  * The `<port>` elements of a sheet in the order written, each name once, with their diagnostics. Components inside
55
92
  * are not entered. A bad port is an error and left out.
@@ -1 +1 @@
1
- {"version":3,"file":"sheet-ports.js","sourceRoot":"","sources":["../../src/engine/sheet-ports.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"sheet-ports.js","sourceRoot":"","sources":["../../src/engine/sheet-ports.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;