fcdev 0.0.0-stage → 0.2.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 (294) hide show
  1. package/LICENSE +201 -0
  2. package/README.md +82 -2
  3. package/bin/fcdev.mjs +17 -0
  4. package/package.json +38 -4
  5. package/src/api/header-parser.mjs +78 -0
  6. package/src/api/index.mjs +128 -0
  7. package/src/build/bank-link-config.mjs +74 -0
  8. package/src/build/build-plan.mjs +92 -0
  9. package/src/build/dependency-file.mjs +24 -0
  10. package/src/build/disk-builder.mjs +36 -0
  11. package/src/build/index.mjs +32 -0
  12. package/src/build/program-builder.mjs +212 -0
  13. package/src/build/source-collector.mjs +54 -0
  14. package/src/build/tool-arguments.mjs +83 -0
  15. package/src/cli/args-parser.mjs +84 -0
  16. package/src/cli/commands/api-command.mjs +62 -0
  17. package/src/cli/commands/build-command.mjs +34 -0
  18. package/src/cli/commands/debug-command.mjs +70 -0
  19. package/src/cli/commands/disasm-command.mjs +65 -0
  20. package/src/cli/commands/disk-command.mjs +34 -0
  21. package/src/cli/commands/info-command.mjs +33 -0
  22. package/src/cli/commands/project-info.mjs +57 -0
  23. package/src/cli/commands/run-command.mjs +68 -0
  24. package/src/cli/commands/sync-command.mjs +85 -0
  25. package/src/cli/index.mjs +103 -0
  26. package/src/config/config-loader.mjs +132 -0
  27. package/src/config/index.mjs +9 -0
  28. package/src/disasm/analysis.mjs +97 -0
  29. package/src/disasm/cdl.mjs +35 -0
  30. package/src/disasm/disassembler.mjs +114 -0
  31. package/src/disasm/index.mjs +16 -0
  32. package/src/disasm/info-writer.mjs +72 -0
  33. package/src/disasm/loaders.mjs +69 -0
  34. package/src/disasm/opcode-table.mjs +268 -0
  35. package/src/disasm/roundtrip.mjs +69 -0
  36. package/src/disasm/symbols.mjs +30 -0
  37. package/src/disasm/trace.mjs +25 -0
  38. package/src/emulator/debug-client.mjs +125 -0
  39. package/src/emulator/emulator-launcher.mjs +80 -0
  40. package/src/emulator/emulator-locator.mjs +62 -0
  41. package/src/emulator/index.mjs +11 -0
  42. package/src/packagers/fat-floppy.mjs +22 -0
  43. package/src/packagers/fat12-image.mjs +245 -0
  44. package/src/packagers/flat-binary.mjs +53 -0
  45. package/src/packagers/index.mjs +54 -0
  46. package/src/packagers/ines.mjs +38 -0
  47. package/src/shared/errors.mjs +25 -0
  48. package/src/shared/fs-utils.mjs +66 -0
  49. package/src/shared/index.mjs +11 -0
  50. package/src/shared/process.mjs +50 -0
  51. package/src/targets/index.mjs +17 -0
  52. package/src/targets/name-rules.mjs +33 -0
  53. package/src/targets/target-registry.mjs +225 -0
  54. package/src/toolchain/index.mjs +16 -0
  55. package/src/toolchain/toolchain-locator.mjs +104 -0
  56. package/targets/nes/asminc/fcnes.inc +16 -0
  57. package/targets/nes/chr/ascii-8x8.chr +0 -0
  58. package/targets/nes/chr/font8x8_basic.h +152 -0
  59. package/targets/nes/include/fcnes.h +45 -0
  60. package/targets/nes/lib/fcnes.lib +0 -0
  61. package/targets/nes/lib/nes-font.o +0 -0
  62. package/targets/nes/lib-build.json +9 -0
  63. package/targets/nes/src/fcnes.s +91 -0
  64. package/targets/nes/src/nes-font.s +12 -0
  65. package/targets/nes/target.json +27 -0
  66. package/targets/sb2000/api-reference.md +3295 -0
  67. package/targets/sb2000/api-unwrapped.json +36 -0
  68. package/targets/sb2000/asminc/sb2000.inc +418 -0
  69. package/targets/sb2000/include/sb2000-bank.h +74 -0
  70. package/targets/sb2000/include/sb2000-clock.h +68 -0
  71. package/targets/sb2000/include/sb2000-disk.h +141 -0
  72. package/targets/sb2000/include/sb2000-display.h +352 -0
  73. package/targets/sb2000/include/sb2000-file.h +273 -0
  74. package/targets/sb2000/include/sb2000-ime.h +158 -0
  75. package/targets/sb2000/include/sb2000-input.h +192 -0
  76. package/targets/sb2000/include/sb2000-math.h +228 -0
  77. package/targets/sb2000/include/sb2000-memory.h +115 -0
  78. package/targets/sb2000/include/sb2000-printer.h +116 -0
  79. package/targets/sb2000/include/sb2000-sound.h +134 -0
  80. package/targets/sb2000/include/sb2000-symbols.h +776 -0
  81. package/targets/sb2000/include/sb2000-system.h +219 -0
  82. package/targets/sb2000/include/sb2000-text.h +99 -0
  83. package/targets/sb2000/include/sb2000.h +45 -0
  84. package/targets/sb2000/lib/crt0.o +0 -0
  85. package/targets/sb2000/lib/sb2000.lib +0 -0
  86. package/targets/sb2000/lib-build.json +8 -0
  87. package/targets/sb2000/link-banked.cfg +42 -0
  88. package/targets/sb2000/link.cfg +35 -0
  89. package/targets/sb2000/src/crt0.s +122 -0
  90. package/targets/sb2000/src/lib/bank/sb-bank-current.c +18 -0
  91. package/targets/sb2000/src/lib/bank/sb-bank-select.c +21 -0
  92. package/targets/sb2000/src/lib/bank/sbi-bank-trampoline.s +46 -0
  93. package/targets/sb2000/src/lib/clock/sb-clock-get-date.c +17 -0
  94. package/targets/sb2000/src/lib/clock/sb-clock-get-time.c +17 -0
  95. package/targets/sb2000/src/lib/clock/sb-clock-set-date.c +21 -0
  96. package/targets/sb2000/src/lib/clock/sb-clock-set-time.c +17 -0
  97. package/targets/sb2000/src/lib/clock/sbi-date-from-fat.c +20 -0
  98. package/targets/sb2000/src/lib/clock/sbi-date-to-fat.c +24 -0
  99. package/targets/sb2000/src/lib/clock/sbi-time-from-fat.c +20 -0
  100. package/targets/sb2000/src/lib/clock/sbi-time-to-fat.c +19 -0
  101. package/targets/sb2000/src/lib/disk/sb-disk-format-track.c +18 -0
  102. package/targets/sb2000/src/lib/disk/sb-disk-free-bytes.c +38 -0
  103. package/targets/sb2000/src/lib/disk/sb-disk-init.c +16 -0
  104. package/targets/sb2000/src/lib/disk/sb-disk-read-sector.c +24 -0
  105. package/targets/sb2000/src/lib/disk/sb-disk-read-sectors.c +17 -0
  106. package/targets/sb2000/src/lib/disk/sb-disk-scan-track.c +27 -0
  107. package/targets/sb2000/src/lib/disk/sb-disk-start.c +16 -0
  108. package/targets/sb2000/src/lib/disk/sb-disk-stop.c +16 -0
  109. package/targets/sb2000/src/lib/disk/sb-disk-write-sector.c +19 -0
  110. package/targets/sb2000/src/lib/disk/sb-disk-write-sectors.c +17 -0
  111. package/targets/sb2000/src/lib/disk/sbi-disk-batch.c +23 -0
  112. package/targets/sb2000/src/lib/disk/sbi-disk-call.c +17 -0
  113. package/targets/sb2000/src/lib/disk/sbi-disk-set-position.c +18 -0
  114. package/targets/sb2000/src/lib/display/sb-cell-address.c +20 -0
  115. package/targets/sb2000/src/lib/display/sb-cells-copy.c +27 -0
  116. package/targets/sb2000/src/lib/display/sb-cells-fill.c +25 -0
  117. package/targets/sb2000/src/lib/display/sb-cells-rect.c +20 -0
  118. package/targets/sb2000/src/lib/display/sb-display-mode.c +16 -0
  119. package/targets/sb2000/src/lib/display/sb-glyph-address.c +28 -0
  120. package/targets/sb2000/src/lib/display/sb-image-fill-rect.c +26 -0
  121. package/targets/sb2000/src/lib/display/sb-image-load-raw.c +22 -0
  122. package/targets/sb2000/src/lib/display/sb-image-show-full.c +20 -0
  123. package/targets/sb2000/src/lib/display/sb-image-show.c +25 -0
  124. package/targets/sb2000/src/lib/display/sb-image-unpack-map.c +28 -0
  125. package/targets/sb2000/src/lib/display/sb-image-unpack-tiles.c +20 -0
  126. package/targets/sb2000/src/lib/display/sb-image-unpack-to-memory.c +22 -0
  127. package/targets/sb2000/src/lib/display/sb-palette-write.c +20 -0
  128. package/targets/sb2000/src/lib/display/sb-screen-clear.c +19 -0
  129. package/targets/sb2000/src/lib/display/sb-screen-flush.c +16 -0
  130. package/targets/sb2000/src/lib/display/sb-text-draw.c +22 -0
  131. package/targets/sb2000/src/lib/display/sb-text-field-ascii.c +25 -0
  132. package/targets/sb2000/src/lib/display/sb-text-field.c +25 -0
  133. package/targets/sb2000/src/lib/display/sb-text-to-memory.c +27 -0
  134. package/targets/sb2000/src/lib/display/sb-vram-bank.c +17 -0
  135. package/targets/sb2000/src/lib/display/sb-vram-fill.c +21 -0
  136. package/targets/sb2000/src/lib/display/sb-vram-load.c +21 -0
  137. package/targets/sb2000/src/lib/display/sb-window-compact.c +16 -0
  138. package/targets/sb2000/src/lib/display/sb-window-init.c +16 -0
  139. package/targets/sb2000/src/lib/display/sb-window-restore.c +17 -0
  140. package/targets/sb2000/src/lib/display/sb-window-save.c +21 -0
  141. package/targets/sb2000/src/lib/file/sb-dir-change.c +21 -0
  142. package/targets/sb2000/src/lib/file/sb-dir-current.c +27 -0
  143. package/targets/sb2000/src/lib/file/sb-dir-make.c +21 -0
  144. package/targets/sb2000/src/lib/file/sb-dir-open.c +61 -0
  145. package/targets/sb2000/src/lib/file/sb-dir-read.c +87 -0
  146. package/targets/sb2000/src/lib/file/sb-dir-remove.c +21 -0
  147. package/targets/sb2000/src/lib/file/sb-file-close.c +21 -0
  148. package/targets/sb2000/src/lib/file/sb-file-delete.c +21 -0
  149. package/targets/sb2000/src/lib/file/sb-file-get-attr.c +25 -0
  150. package/targets/sb2000/src/lib/file/sb-file-get-date.c +25 -0
  151. package/targets/sb2000/src/lib/file/sb-file-get-time.c +25 -0
  152. package/targets/sb2000/src/lib/file/sb-file-load.c +50 -0
  153. package/targets/sb2000/src/lib/file/sb-file-open.c +26 -0
  154. package/targets/sb2000/src/lib/file/sb-file-read.c +52 -0
  155. package/targets/sb2000/src/lib/file/sb-file-rename.c +30 -0
  156. package/targets/sb2000/src/lib/file/sb-file-save.c +31 -0
  157. package/targets/sb2000/src/lib/file/sb-file-set-attr.c +22 -0
  158. package/targets/sb2000/src/lib/file/sb-file-set-date.c +25 -0
  159. package/targets/sb2000/src/lib/file/sb-file-set-time.c +22 -0
  160. package/targets/sb2000/src/lib/file/sb-file-size.c +27 -0
  161. package/targets/sb2000/src/lib/file/sb-file-write-all.c +32 -0
  162. package/targets/sb2000/src/lib/file/sb-file-write.c +60 -0
  163. package/targets/sb2000/src/lib/file/sbi-dir-state.c +15 -0
  164. package/targets/sb2000/src/lib/file/sbi-dos-call.c +17 -0
  165. package/targets/sb2000/src/lib/file/sbi-load-sector.c +18 -0
  166. package/targets/sb2000/src/lib/file/sbi-select-handle.c +20 -0
  167. package/targets/sb2000/src/lib/file/sbi-set-path.c +26 -0
  168. package/targets/sb2000/src/lib/ime/sb-ime-get-method.c +17 -0
  169. package/targets/sb2000/src/lib/ime/sb-ime-get-state.c +18 -0
  170. package/targets/sb2000/src/lib/ime/sb-ime-hex.c +20 -0
  171. package/targets/sb2000/src/lib/ime/sb-ime-init.c +26 -0
  172. package/targets/sb2000/src/lib/ime/sb-ime-key-wait.c +19 -0
  173. package/targets/sb2000/src/lib/ime/sb-ime-key.c +19 -0
  174. package/targets/sb2000/src/lib/ime/sb-ime-parse.c +23 -0
  175. package/targets/sb2000/src/lib/ime/sb-ime-resume.c +16 -0
  176. package/targets/sb2000/src/lib/ime/sb-ime-select.c +19 -0
  177. package/targets/sb2000/src/lib/ime/sb-ime-set-state.c +18 -0
  178. package/targets/sb2000/src/lib/ime/sb-ime-set-width.c +16 -0
  179. package/targets/sb2000/src/lib/ime/sb-ime-suspend.c +16 -0
  180. package/targets/sb2000/src/lib/input/sb-break-disable.c +16 -0
  181. package/targets/sb2000/src/lib/input/sb-break-enable.c +16 -0
  182. package/targets/sb2000/src/lib/input/sb-key-count.c +17 -0
  183. package/targets/sb2000/src/lib/input/sb-key-flush.c +16 -0
  184. package/targets/sb2000/src/lib/input/sb-key-init.c +16 -0
  185. package/targets/sb2000/src/lib/input/sb-key-modifiers.c +16 -0
  186. package/targets/sb2000/src/lib/input/sb-key-poll.c +17 -0
  187. package/targets/sb2000/src/lib/input/sb-key-wait.c +17 -0
  188. package/targets/sb2000/src/lib/input/sb-keyboard-reset.c +17 -0
  189. package/targets/sb2000/src/lib/input/sb-mouse-buttons.c +21 -0
  190. package/targets/sb2000/src/lib/input/sb-mouse-position.c +18 -0
  191. package/targets/sb2000/src/lib/input/sb-mouse-reset.c +17 -0
  192. package/targets/sb2000/src/lib/input/sb-mouse-set-double-click.c +17 -0
  193. package/targets/sb2000/src/lib/input/sb-mouse-set-limits.c +26 -0
  194. package/targets/sb2000/src/lib/input/sb-mouse-set-position.c +18 -0
  195. package/targets/sb2000/src/lib/input/sb-pad-init.c +17 -0
  196. package/targets/sb2000/src/lib/input/sb-pad-poll.c +17 -0
  197. package/targets/sb2000/src/lib/input/sb-pad-state.c +16 -0
  198. package/targets/sb2000/src/lib/input/sb-pad-wait.c +17 -0
  199. package/targets/sb2000/src/lib/math/sb-float-add.c +19 -0
  200. package/targets/sb2000/src/lib/math/sb-float-div.c +19 -0
  201. package/targets/sb2000/src/lib/math/sb-float-from-text.c +18 -0
  202. package/targets/sb2000/src/lib/math/sb-float-mul.c +19 -0
  203. package/targets/sb2000/src/lib/math/sb-float-sub.c +19 -0
  204. package/targets/sb2000/src/lib/math/sb-float-to-text.c +19 -0
  205. package/targets/sb2000/src/lib/math/sb-int24-add.c +21 -0
  206. package/targets/sb2000/src/lib/math/sb-int24-div.c +26 -0
  207. package/targets/sb2000/src/lib/math/sb-int24-mul.c +20 -0
  208. package/targets/sb2000/src/lib/math/sb-int24-sub.c +21 -0
  209. package/targets/sb2000/src/lib/math/sb-int40-from-text.c +19 -0
  210. package/targets/sb2000/src/lib/math/sb-int40-to-text.c +27 -0
  211. package/targets/sb2000/src/lib/math/sb-line-step.c +21 -0
  212. package/targets/sb2000/src/lib/math/sb-math-div16.c +27 -0
  213. package/targets/sb2000/src/lib/math/sb-math-time-text.c +21 -0
  214. package/targets/sb2000/src/lib/math/sb-random-next.c +20 -0
  215. package/targets/sb2000/src/lib/math/sb-random-seed.c +19 -0
  216. package/targets/sb2000/src/lib/math/sb-random-warm-up.c +16 -0
  217. package/targets/sb2000/src/lib/math/sbi-peek.c +20 -0
  218. package/targets/sb2000/src/lib/math/sbi-poke.c +20 -0
  219. package/targets/sb2000/src/lib/memory/sb-address-to-far.c +20 -0
  220. package/targets/sb2000/src/lib/memory/sb-far-read-byte.c +17 -0
  221. package/targets/sb2000/src/lib/memory/sb-far-read.c +36 -0
  222. package/targets/sb2000/src/lib/memory/sb-far-write-byte.c +17 -0
  223. package/targets/sb2000/src/lib/memory/sb-far-write.c +36 -0
  224. package/targets/sb2000/src/lib/memory/sb-page-alloc.c +19 -0
  225. package/targets/sb2000/src/lib/memory/sb-page-free.c +19 -0
  226. package/targets/sb2000/src/lib/memory/sb-page-largest-free.c +17 -0
  227. package/targets/sb2000/src/lib/memory/sb-window-map-group.c +17 -0
  228. package/targets/sb2000/src/lib/memory/sb-window-map.c +18 -0
  229. package/targets/sb2000/src/lib/memory/sbi-far-copy-in.s +17 -0
  230. package/targets/sb2000/src/lib/memory/sbi-far-copy-out.s +17 -0
  231. package/targets/sb2000/src/lib/memory/sbi-far-read-byte.s +19 -0
  232. package/targets/sb2000/src/lib/memory/sbi-far-write-byte.s +17 -0
  233. package/targets/sb2000/src/lib/printer/sb-printer-carriage-return.c +16 -0
  234. package/targets/sb2000/src/lib/printer/sb-printer-feed.c +17 -0
  235. package/targets/sb2000/src/lib/printer/sb-printer-graphics-mode.c +16 -0
  236. package/targets/sb2000/src/lib/printer/sb-printer-home.c +16 -0
  237. package/targets/sb2000/src/lib/printer/sb-printer-init-port.c +16 -0
  238. package/targets/sb2000/src/lib/printer/sb-printer-page-left.c +16 -0
  239. package/targets/sb2000/src/lib/printer/sb-printer-page-length.c +17 -0
  240. package/targets/sb2000/src/lib/printer/sb-printer-position.c +18 -0
  241. package/targets/sb2000/src/lib/printer/sb-printer-reset.c +16 -0
  242. package/targets/sb2000/src/lib/printer/sb-printer-send-byte.c +18 -0
  243. package/targets/sb2000/src/lib/printer/sb-printer-text.c +29 -0
  244. package/targets/sb2000/src/lib/sb-internal.h +111 -0
  245. package/targets/sb2000/src/lib/sound/sb-sound-effect-from.c +19 -0
  246. package/targets/sb2000/src/lib/sound/sb-sound-play-from.c +18 -0
  247. package/targets/sb2000/src/lib/sound/sb-sound-play-wav-from.c +18 -0
  248. package/targets/sb2000/src/lib/sound/sb-sound-play-wav.c +16 -0
  249. package/targets/sb2000/src/lib/sound/sb-sound-repeat-wav-from.c +19 -0
  250. package/targets/sb2000/src/lib/sound/sb-sound-status.c +17 -0
  251. package/targets/sb2000/src/lib/sound/sb-sound-stop.c +16 -0
  252. package/targets/sb2000/src/lib/sound/sb-sound-tempo.c +17 -0
  253. package/targets/sb2000/src/lib/sound/sb-sound-transpose.c +17 -0
  254. package/targets/sb2000/src/lib/sound/sb-speech-off.c +16 -0
  255. package/targets/sb2000/src/lib/sound/sb-speech-send-entry-from.c +21 -0
  256. package/targets/sb2000/src/lib/sound/sb-speech-send-from.c +19 -0
  257. package/targets/sb2000/src/lib/sound/sb-speech-send.c +16 -0
  258. package/targets/sb2000/src/lib/system/sb-call-banked.c +19 -0
  259. package/targets/sb2000/src/lib/system/sb-context-restore.c +16 -0
  260. package/targets/sb2000/src/lib/system/sb-context-save.c +19 -0
  261. package/targets/sb2000/src/lib/system/sb-display-off.c +16 -0
  262. package/targets/sb2000/src/lib/system/sb-display-on.c +16 -0
  263. package/targets/sb2000/src/lib/system/sb-display-option.c +18 -0
  264. package/targets/sb2000/src/lib/system/sb-exec.c +22 -0
  265. package/targets/sb2000/src/lib/system/sb-irq-enable.c +19 -0
  266. package/targets/sb2000/src/lib/system/sb-irq-hook-reset.c +20 -0
  267. package/targets/sb2000/src/lib/system/sb-irq-hook-set.c +39 -0
  268. package/targets/sb2000/src/lib/system/sb-irq-mask.c +19 -0
  269. package/targets/sb2000/src/lib/system/sb-jump-banked.s +25 -0
  270. package/targets/sb2000/src/lib/system/sb-nmi-disable.c +16 -0
  271. package/targets/sb2000/src/lib/system/sb-nmi-enable.c +16 -0
  272. package/targets/sb2000/src/lib/system/sb-nmi-hook-reset.c +20 -0
  273. package/targets/sb2000/src/lib/system/sb-nmi-hook-set.c +33 -0
  274. package/targets/sb2000/src/lib/system/sb-nmi-service.c +19 -0
  275. package/targets/sb2000/src/lib/system/sb-stack-pointer.s +18 -0
  276. package/targets/sb2000/src/lib/system/sb-system-init.c +16 -0
  277. package/targets/sb2000/src/lib/system/sb-system-state.c +20 -0
  278. package/targets/sb2000/src/lib/system/sb-wait-frames.s +19 -0
  279. package/targets/sb2000/src/lib/system/sbi-exec-run.s +43 -0
  280. package/targets/sb2000/src/lib/system/sbi-interrupts-off.s +19 -0
  281. package/targets/sb2000/src/lib/system/sbi-interrupts-restore.s +17 -0
  282. package/targets/sb2000/src/lib/text/sb-beep.c +16 -0
  283. package/targets/sb2000/src/lib/text/sb-cursor-column.c +16 -0
  284. package/targets/sb2000/src/lib/text/sb-cursor-left.c +16 -0
  285. package/targets/sb2000/src/lib/text/sb-cursor-right.c +16 -0
  286. package/targets/sb2000/src/lib/text/sb-cursor-row.c +16 -0
  287. package/targets/sb2000/src/lib/text/sb-cursor-set-column.c +18 -0
  288. package/targets/sb2000/src/lib/text/sb-cursor-up.c +16 -0
  289. package/targets/sb2000/src/lib/text/sb-print-hex.c +22 -0
  290. package/targets/sb2000/src/lib/text/sb-print-uint.c +25 -0
  291. package/targets/sb2000/src/lib/text/sb-print.c +35 -0
  292. package/targets/sb2000/src/lib/text/sb-putc.c +26 -0
  293. package/targets/sb2000/src/sb2000.s +64 -0
  294. package/targets/sb2000/target.json +42 -0
@@ -0,0 +1,22 @@
1
+ // ------------------------------------------------------------------------
2
+ // 名称:fat-floppy.mjs
3
+ // 说明:磁盘镜像打包器 fat-floppy:把程序文件放进 1.44MB 的 FAT12 软盘镜像的根目录。
4
+ // 作者:sungbin
5
+ // 邮箱:sungbin@3578.cn
6
+ // 日期:2026-11-10
7
+ // 备注:磁盘打包器与程序打包器不同:输入是一组文件,输出是一个镜像文件。
8
+ // ------------------------------------------------------------------------
9
+ import { writeFileSync } from 'node:fs';
10
+ import { buildFat12Image } from './fat12-image.mjs';
11
+
12
+ /**
13
+ * 生成软盘镜像并写到文件。
14
+ * @param {{files: {name: string, data: Buffer, mtime?: Date}[], outputFile: string, options?: {label?: string}}} input 要放进镜像的文件、镜像路径与卷标
15
+ * @returns {{outputFile: string, size: number}} 镜像路径与大小
16
+ * @throws {import('../shared/index.mjs').FcdevError} 文件名不符合 8.3,或空间不足
17
+ */
18
+ export function packFatFloppy({ files, outputFile, options = {} }) {
19
+ const image = buildFat12Image(files, { label: options.label });
20
+ writeFileSync(outputFile, image);
21
+ return { outputFile, size: image.length };
22
+ }
@@ -0,0 +1,245 @@
1
+ // ------------------------------------------------------------------------
2
+ // 名称:fat12-image.mjs
3
+ // 说明:构建与读取 1.44MB 的 FAT12 软盘镜像(512 字节扇区、2 面、80 磁道、每磁道 18 扇区)。
4
+ // 作者:sungbin
5
+ // 邮箱:sungbin@3578.cn
6
+ // 日期:2026-11-10
7
+ // 备注:几何参数与模拟器的软驱控制器一致(LBA = 磁道*36 + 磁头*18 + 扇区-1,共 2880 个扇区)。
8
+ // 文件只写在根目录,每簇 1 个扇区,不支持子目录。
9
+ // ------------------------------------------------------------------------
10
+ import { FcdevError } from '../shared/index.mjs';
11
+
12
+ /** 1.44MB 软盘的固定参数 */
13
+ export const GEOMETRY = Object.freeze({
14
+ bytesPerSector: 512,
15
+ sectorsPerCluster: 1,
16
+ reservedSectors: 1,
17
+ fatCount: 2,
18
+ rootEntries: 224,
19
+ totalSectors: 2880,
20
+ mediaDescriptor: 0xf0,
21
+ sectorsPerFat: 9,
22
+ sectorsPerTrack: 18,
23
+ heads: 2,
24
+ });
25
+
26
+ /** 目录项大小 */
27
+ const ENTRY_SIZE = 32;
28
+
29
+ /** FAT12 的簇链结束标记 */
30
+ const END_OF_CHAIN = 0xfff;
31
+
32
+ /** 卷标属性位 */
33
+ const ATTR_VOLUME = 0x08;
34
+
35
+ /** 8.3 名字里允许的字符 */
36
+ const NAME_PART = /^[A-Z0-9_$~!#%&\-{}()@'`^]+$/;
37
+
38
+ /**
39
+ * 把文件名转成 11 字节的 8.3 目录项名字。
40
+ * @param {string} fileName 例如 "edit.exe"
41
+ * @returns {string} 11 个字符,不足补空格
42
+ * @throws {FcdevError} 文件名不符合 8.3 规则
43
+ */
44
+ export function toShortName(fileName) {
45
+ const upper = fileName.toUpperCase();
46
+ const dot = upper.lastIndexOf('.');
47
+ const base = dot < 0 ? upper : upper.slice(0, dot);
48
+ const ext = dot < 0 ? '' : upper.slice(dot + 1);
49
+ if (base.length < 1 || base.length > 8 || ext.length > 3 || !NAME_PART.test(base) || (ext && !NAME_PART.test(ext))) {
50
+ throw new FcdevError(`文件名不符合 8.3 规则:${fileName}`, { code: 'DISK_NAME_INVALID' });
51
+ }
52
+ return base.padEnd(8, ' ') + ext.padEnd(3, ' ');
53
+ }
54
+
55
+ /**
56
+ * 把 11 字节目录项名字还原成 NAME.EXT。
57
+ * @param {string} raw 11 个字符
58
+ * @returns {string} 文件名
59
+ */
60
+ function fromShortName(raw) {
61
+ const base = raw.slice(0, 8).trimEnd();
62
+ const ext = raw.slice(8, 11).trimEnd();
63
+ return ext ? `${base}.${ext}` : base;
64
+ }
65
+
66
+ /**
67
+ * 编码 DOS 日期与时间。
68
+ * @param {Date} date 日期时间
69
+ * @returns {{date: number, time: number}} 目录项里的日期与时间字段
70
+ */
71
+ function dosDateTime(date) {
72
+ const year = Math.min(Math.max(date.getFullYear(), 1980), 2107);
73
+ return {
74
+ date: ((year - 1980) << 9) | ((date.getMonth() + 1) << 5) | date.getDate(),
75
+ time: (date.getHours() << 11) | (date.getMinutes() << 5) | (date.getSeconds() >> 1),
76
+ };
77
+ }
78
+
79
+ /**
80
+ * 写入 FAT12 的一个 12 位条目。
81
+ * @param {Buffer} fat FAT 表
82
+ * @param {number} cluster 簇号
83
+ * @param {number} value 条目值
84
+ */
85
+ function setFatEntry(fat, cluster, value) {
86
+ const offset = Math.floor((cluster * 3) / 2);
87
+ if (cluster % 2 === 0) {
88
+ fat[offset] = value & 0xff;
89
+ fat[offset + 1] = (fat[offset + 1] & 0xf0) | ((value >> 8) & 0x0f);
90
+ } else {
91
+ fat[offset] = (fat[offset] & 0x0f) | ((value & 0x0f) << 4);
92
+ fat[offset + 1] = (value >> 4) & 0xff;
93
+ }
94
+ }
95
+
96
+ /**
97
+ * 读取 FAT12 的一个 12 位条目。
98
+ * @param {Buffer} fat FAT 表
99
+ * @param {number} cluster 簇号
100
+ * @returns {number} 条目值
101
+ */
102
+ function getFatEntry(fat, cluster) {
103
+ const offset = Math.floor((cluster * 3) / 2);
104
+ const pair = fat[offset] | (fat[offset + 1] << 8);
105
+ return cluster % 2 === 0 ? pair & 0x0fff : pair >> 4;
106
+ }
107
+
108
+ /**
109
+ * 生成引导扇区(含 BIOS 参数块与 55 AA 签名,不含启动代码)。
110
+ * @param {string} [label] 卷标
111
+ * @returns {Buffer} 512 字节
112
+ */
113
+ function buildBootSector(label) {
114
+ const g = GEOMETRY;
115
+ const sector = Buffer.alloc(g.bytesPerSector);
116
+ sector.set([0xeb, 0x3c, 0x90], 0);
117
+ sector.write('FCDEV ', 3, 'ascii');
118
+ sector.writeUInt16LE(g.bytesPerSector, 11);
119
+ sector.writeUInt8(g.sectorsPerCluster, 13);
120
+ sector.writeUInt16LE(g.reservedSectors, 14);
121
+ sector.writeUInt8(g.fatCount, 16);
122
+ sector.writeUInt16LE(g.rootEntries, 17);
123
+ sector.writeUInt16LE(g.totalSectors, 19);
124
+ sector.writeUInt8(g.mediaDescriptor, 21);
125
+ sector.writeUInt16LE(g.sectorsPerFat, 22);
126
+ sector.writeUInt16LE(g.sectorsPerTrack, 24);
127
+ sector.writeUInt16LE(g.heads, 26);
128
+ sector.writeUInt8(0x29, 38);
129
+ sector.writeUInt32LE(0x20261110, 39);
130
+ sector.write((label ?? 'NO NAME').toUpperCase().padEnd(11, ' ').slice(0, 11), 43, 'ascii');
131
+ sector.write('FAT12 ', 54, 'ascii');
132
+ sector.writeUInt16LE(0xaa55, 510);
133
+ return sector;
134
+ }
135
+
136
+ /**
137
+ * 构建 FAT12 软盘镜像。
138
+ * @param {{name: string, data: Buffer, mtime?: Date}[]} files 要写入根目录的文件
139
+ * @param {{label?: string}} [options] 卷标
140
+ * @returns {Buffer} 1474560 字节的镜像
141
+ * @throws {FcdevError} 文件名不符合 8.3、空间不足或根目录项过多
142
+ */
143
+ export function buildFat12Image(files, options = {}) {
144
+ const g = GEOMETRY;
145
+ const image = Buffer.alloc(g.totalSectors * g.bytesPerSector);
146
+ const fatBytes = g.sectorsPerFat * g.bytesPerSector;
147
+ const rootSectors = (g.rootEntries * ENTRY_SIZE) / g.bytesPerSector;
148
+ const fatStart = g.reservedSectors * g.bytesPerSector;
149
+ const rootStart = fatStart + g.fatCount * fatBytes;
150
+ const dataStart = rootStart + rootSectors * g.bytesPerSector;
151
+ const clusterBytes = g.sectorsPerCluster * g.bytesPerSector;
152
+ const clusterCount = Math.floor((image.length - dataStart) / clusterBytes);
153
+
154
+ buildBootSector(options.label).copy(image, 0);
155
+
156
+ const fat = Buffer.alloc(fatBytes);
157
+ setFatEntry(fat, 0, 0xf00 | g.mediaDescriptor);
158
+ setFatEntry(fat, 1, 0xfff);
159
+
160
+ const entries = [];
161
+ if (options.label) {
162
+ const labelEntry = Buffer.alloc(ENTRY_SIZE);
163
+ labelEntry.write(options.label.toUpperCase().padEnd(11, ' ').slice(0, 11), 0, 'ascii');
164
+ labelEntry.writeUInt8(ATTR_VOLUME, 11);
165
+ entries.push(labelEntry);
166
+ }
167
+
168
+ let nextCluster = 2;
169
+ for (const file of files) {
170
+ const need = Math.max(1, Math.ceil(file.data.length / clusterBytes));
171
+ if (file.data.length > 0 && nextCluster - 2 + need > clusterCount) {
172
+ throw new FcdevError(`软盘空间不足,放不下:${file.name}`, { code: 'DISK_FULL' });
173
+ }
174
+ const entry = Buffer.alloc(ENTRY_SIZE);
175
+ entry.write(toShortName(file.name), 0, 'ascii');
176
+ entry.writeUInt8(0x20, 11);
177
+ const stamp = dosDateTime(file.mtime ?? new Date(1998, 0, 1));
178
+ entry.writeUInt16LE(stamp.time, 22);
179
+ entry.writeUInt16LE(stamp.date, 24);
180
+ entry.writeUInt32LE(file.data.length, 28);
181
+
182
+ if (file.data.length > 0) {
183
+ entry.writeUInt16LE(nextCluster, 26);
184
+ for (let index = 0; index < need; index += 1) {
185
+ const cluster = nextCluster + index;
186
+ setFatEntry(fat, cluster, index === need - 1 ? END_OF_CHAIN : cluster + 1);
187
+ file.data.subarray(index * clusterBytes, (index + 1) * clusterBytes).copy(image, dataStart + (cluster - 2) * clusterBytes);
188
+ }
189
+ nextCluster += need;
190
+ }
191
+ entries.push(entry);
192
+ }
193
+
194
+ if (entries.length > g.rootEntries) throw new FcdevError('根目录项过多', { code: 'DISK_FULL' });
195
+ entries.forEach((entry, index) => entry.copy(image, rootStart + index * ENTRY_SIZE));
196
+ for (let copy = 0; copy < g.fatCount; copy += 1) fat.copy(image, fatStart + copy * fatBytes);
197
+ return image;
198
+ }
199
+
200
+ /**
201
+ * 列出镜像根目录里的文件。
202
+ * @param {Buffer} image FAT12 镜像
203
+ * @returns {{name: string, size: number, startCluster: number}[]} 文件列表
204
+ */
205
+ export function listFat12(image) {
206
+ const g = GEOMETRY;
207
+ const rootStart = (g.reservedSectors + g.fatCount * g.sectorsPerFat) * g.bytesPerSector;
208
+ const result = [];
209
+ for (let index = 0; index < g.rootEntries; index += 1) {
210
+ const at = rootStart + index * ENTRY_SIZE;
211
+ const first = image[at];
212
+ if (first === 0x00) break;
213
+ if (first === 0xe5 || (image[at + 11] & ATTR_VOLUME) !== 0) continue;
214
+ result.push({
215
+ name: fromShortName(image.toString('ascii', at, at + 11)),
216
+ size: image.readUInt32LE(at + 28),
217
+ startCluster: image.readUInt16LE(at + 26),
218
+ });
219
+ }
220
+ return result;
221
+ }
222
+
223
+ /**
224
+ * 读取镜像中一个文件的内容。
225
+ * @param {Buffer} image FAT12 镜像
226
+ * @param {{size: number, startCluster: number}} entry listFat12 返回的目录项
227
+ * @returns {Buffer} 文件内容
228
+ */
229
+ export function readFat12File(image, entry) {
230
+ const g = GEOMETRY;
231
+ const fatStart = g.reservedSectors * g.bytesPerSector;
232
+ const fat = image.subarray(fatStart, fatStart + g.sectorsPerFat * g.bytesPerSector);
233
+ const dataStart = (g.reservedSectors + g.fatCount * g.sectorsPerFat) * g.bytesPerSector + g.rootEntries * ENTRY_SIZE;
234
+ const clusterBytes = g.sectorsPerCluster * g.bytesPerSector;
235
+ const chunks = [];
236
+ let cluster = entry.startCluster;
237
+ let remaining = entry.size;
238
+ while (remaining > 0 && cluster >= 2 && cluster < 0xff8) {
239
+ const start = dataStart + (cluster - 2) * clusterBytes;
240
+ chunks.push(image.subarray(start, start + Math.min(clusterBytes, remaining)));
241
+ remaining -= clusterBytes;
242
+ cluster = getFatEntry(fat, cluster);
243
+ }
244
+ return Buffer.concat(chunks);
245
+ }
@@ -0,0 +1,53 @@
1
+ // ------------------------------------------------------------------------
2
+ // 名称:flat-binary.mjs
3
+ // 说明:平铺映像打包器:校验链接输出的文件头与大小,写成目标要求的程序文件。
4
+ // 作者:sungbin
5
+ // 邮箱:sungbin@3578.cn
6
+ // 日期:2026-11-10
7
+ // 备注:选项 header 为十六进制字符串,?? 表示任意字节;maxSize 为映像大小上限(字节)。
8
+ // ------------------------------------------------------------------------
9
+ import { readFileSync, writeFileSync } from 'node:fs';
10
+ import { FcdevError } from '../shared/index.mjs';
11
+
12
+ /**
13
+ * 把十六进制模式拆成字节列表,null 表示通配。
14
+ * @param {string} pattern 如 "4C????AA55"
15
+ * @returns {(number|null)[]} 字节列表
16
+ * @throws {FcdevError} 模式不合法
17
+ */
18
+ export function parseHeaderPattern(pattern) {
19
+ if (typeof pattern !== 'string' || pattern.length % 2 !== 0 || !/^([0-9A-Fa-f]{2}|\?\?)*$/.test(pattern)) {
20
+ throw new FcdevError(`header 选项“${pattern}”不是合法的十六进制模式`, { code: 'PACKAGER_OPTION_INVALID' });
21
+ }
22
+ const bytes = [];
23
+ for (let index = 0; index < pattern.length; index += 2) {
24
+ const pair = pattern.slice(index, index + 2);
25
+ bytes.push(pair === '??' ? null : Number.parseInt(pair, 16));
26
+ }
27
+ return bytes;
28
+ }
29
+
30
+ /**
31
+ * 校验并写出平铺映像。
32
+ * @param {{binaryFile: string, outputFile: string, options: {header?: string, maxSize?: number}}} input 链接输出、产物路径与打包选项
33
+ * @returns {{outputFile: string, size: number}} 产物路径与大小
34
+ * @throws {FcdevError} 文件头不符或超过大小上限
35
+ */
36
+ export function packFlatBinary({ binaryFile, outputFile, options }) {
37
+ const image = readFileSync(binaryFile);
38
+ if (options.header !== undefined) {
39
+ const expected = parseHeaderPattern(options.header);
40
+ const matches = image.length >= expected.length && expected.every((byte, index) => byte === null || image[index] === byte);
41
+ if (!matches) {
42
+ throw new FcdevError(`程序文件头不符:应为 ${options.header},实际为 ${image.subarray(0, expected.length).toString('hex').toUpperCase()}`, {
43
+ code: 'PACKAGE_HEADER_MISMATCH',
44
+ hint: '检查启动代码是否放在映像最前面',
45
+ });
46
+ }
47
+ }
48
+ if (options.maxSize !== undefined && image.length > options.maxSize) {
49
+ throw new FcdevError(`程序大小 ${image.length} 字节,超过上限 ${options.maxSize} 字节`, { code: 'PACKAGE_TOO_LARGE' });
50
+ }
51
+ writeFileSync(outputFile, image);
52
+ return { outputFile, size: image.length };
53
+ }
@@ -0,0 +1,54 @@
1
+ // ------------------------------------------------------------------------
2
+ // 名称:index.mjs
3
+ // 说明:packagers 目录的对外入口:按名称取打包器。
4
+ // 作者:sungbin
5
+ // 邮箱:sungbin@3578.cn
6
+ // 日期:2026-11-10
7
+ // 备注:新增打包器时在 PACKAGERS 里登记;每个打包器接收 { binaryFile, outputFile, options } 并返回 { outputFile, size }。
8
+ // ------------------------------------------------------------------------
9
+ import { FcdevError } from '../shared/index.mjs';
10
+ import { packFatFloppy } from './fat-floppy.mjs';
11
+ import { packFlatBinary } from './flat-binary.mjs';
12
+ import { packInes } from './ines.mjs';
13
+
14
+ export { listFat12, readFat12File } from './fat12-image.mjs';
15
+ export { parseHeaderPattern } from './flat-binary.mjs';
16
+
17
+ /** 已登记的程序打包器 */
18
+ const PACKAGERS = {
19
+ 'flat-exe': packFlatBinary,
20
+ ines: packInes,
21
+ };
22
+
23
+ /** 已登记的磁盘打包器:输入一组文件,输出一个镜像 */
24
+ const DISK_PACKAGERS = {
25
+ 'fat-floppy': packFatFloppy,
26
+ };
27
+
28
+ /**
29
+ * 按名称取打包器。
30
+ * @param {string} name 打包器名
31
+ * @returns {(input: {binaryFile: string, outputFile: string, options: Record<string, unknown>}) => {outputFile: string, size: number}} 打包函数
32
+ * @throws {FcdevError} 打包器没有登记
33
+ */
34
+ export function getPackager(name) {
35
+ const packager = PACKAGERS[name];
36
+ if (!packager) {
37
+ throw new FcdevError(`未知的打包器:${name}`, { code: 'PACKAGER_UNKNOWN', hint: `可用的打包器:${Object.keys(PACKAGERS).join('、')}` });
38
+ }
39
+ return packager;
40
+ }
41
+
42
+ /**
43
+ * 按名称取磁盘打包器。
44
+ * @param {string} name 打包器名
45
+ * @returns {(input: {files: {name: string, data: Buffer, mtime?: Date}[], outputFile: string, options?: Record<string, unknown>}) => {outputFile: string, size: number}} 打包函数
46
+ * @throws {FcdevError} 打包器没有登记
47
+ */
48
+ export function getDiskPackager(name) {
49
+ const packager = DISK_PACKAGERS[name];
50
+ if (!packager) {
51
+ throw new FcdevError(`未知的磁盘打包器:${name}`, { code: 'PACKAGER_UNKNOWN', hint: `可用的磁盘打包器:${Object.keys(DISK_PACKAGERS).join('、')}` });
52
+ }
53
+ return packager;
54
+ }
@@ -0,0 +1,38 @@
1
+ // ------------------------------------------------------------------------
2
+ // 名称:ines.mjs
3
+ // 说明:iNES 打包器:校验链接输出以 iNES 文件头开头,写成 .nes 文件。
4
+ // 作者:sungbin
5
+ // 邮箱:sungbin@3578.cn
6
+ // 日期:2026-11-10
7
+ // 备注:iNES 头由 cc65 的 nes.cfg 生成,这里只校验,不改写内容。
8
+ // ------------------------------------------------------------------------
9
+ import { readFileSync, writeFileSync } from 'node:fs';
10
+ import { FcdevError } from '../shared/index.mjs';
11
+
12
+ /** iNES 文件头的前 4 个字节:“NES”加 $1A */
13
+ const INES_MAGIC = Buffer.from([0x4e, 0x45, 0x53, 0x1a]);
14
+
15
+ /** iNES 文件头的长度 */
16
+ const INES_HEADER_SIZE = 16;
17
+
18
+ /**
19
+ * 校验并写出 .nes 文件。
20
+ * @param {{binaryFile: string, outputFile: string}} input 链接输出与产物路径
21
+ * @returns {{outputFile: string, size: number}} 产物路径与大小
22
+ * @throws {FcdevError} 文件头不是 iNES,或文件长度与头里声明的不符
23
+ */
24
+ export function packInes({ binaryFile, outputFile }) {
25
+ const image = readFileSync(binaryFile);
26
+ if (image.length < INES_HEADER_SIZE || !image.subarray(0, 4).equals(INES_MAGIC)) {
27
+ throw new FcdevError('链接输出不是 iNES 格式(缺少 “NES” 文件头)', {
28
+ code: 'PACKAGE_HEADER_MISMATCH',
29
+ hint: '检查链接配置是否生成 iNES 头',
30
+ });
31
+ }
32
+ const expectedSize = INES_HEADER_SIZE + image[4] * 0x4000 + image[5] * 0x2000;
33
+ if (image.length !== expectedSize) {
34
+ throw new FcdevError(`iNES 文件长度 ${image.length} 字节,与文件头声明的 ${expectedSize} 字节不符`, { code: 'PACKAGE_SIZE_MISMATCH' });
35
+ }
36
+ writeFileSync(outputFile, image);
37
+ return { outputFile, size: image.length };
38
+ }
@@ -0,0 +1,25 @@
1
+ // ------------------------------------------------------------------------
2
+ // 名称:errors.mjs
3
+ // 说明:fcdev 的统一错误类型:带错误码与下一步建议,命令行据此给用户输出可操作的提示。
4
+ // 作者:sungbin
5
+ // 邮箱:sungbin@3578.cn
6
+ // 日期:2026-11-10
7
+ // 备注:无
8
+ // ------------------------------------------------------------------------
9
+
10
+ /**
11
+ * 可预期的使用错误(配置有误、找不到工具、构建失败等)。
12
+ * 程序自身的缺陷不用这个类,直接抛出原始异常。
13
+ */
14
+ export class FcdevError extends Error {
15
+ /**
16
+ * @param {string} message 说明发生了什么
17
+ * @param {{code?: string, hint?: string, cause?: unknown}} [options] code 为错误码;hint 为下一步怎么做;cause 为原始原因
18
+ */
19
+ constructor(message, { code = 'FCDEV_ERROR', hint = '', cause } = {}) {
20
+ super(message, cause === undefined ? undefined : { cause });
21
+ this.name = 'FcdevError';
22
+ this.code = code;
23
+ this.hint = hint;
24
+ }
25
+ }
@@ -0,0 +1,66 @@
1
+ // ------------------------------------------------------------------------
2
+ // 名称:fs-utils.mjs
3
+ // 说明:文件系统小工具:读 JSON、取修改时间、递归创建目录。
4
+ // 作者:sungbin
5
+ // 邮箱:sungbin@3578.cn
6
+ // 日期:2026-11-10
7
+ // 备注:无
8
+ // ------------------------------------------------------------------------
9
+ import { mkdirSync, readFileSync, statSync } from 'node:fs';
10
+ import { FcdevError } from './errors.mjs';
11
+
12
+ /**
13
+ * 读取并解析 JSON 文件。
14
+ * @param {string} file 文件路径
15
+ * @returns {unknown} 解析后的值
16
+ * @throws {FcdevError} 文件不存在或内容不是合法的 JSON
17
+ */
18
+ export function readJsonFile(file) {
19
+ let text;
20
+ try {
21
+ text = readFileSync(file, 'utf8');
22
+ } catch (error) {
23
+ throw new FcdevError(`无法读取文件 ${file}`, { code: 'FILE_READ_FAILED', cause: error });
24
+ }
25
+ try {
26
+ return JSON.parse(text);
27
+ } catch (error) {
28
+ throw new FcdevError(`${file} 不是合法的 JSON`, { code: 'JSON_INVALID', cause: error });
29
+ }
30
+ }
31
+
32
+ /**
33
+ * 取文件的修改时间。
34
+ * @param {string} file 文件路径
35
+ * @returns {number|null} 毫秒时间戳;文件不存在时为 null
36
+ */
37
+ export function getModifiedTime(file) {
38
+ try {
39
+ return statSync(file).mtimeMs;
40
+ } catch (error) {
41
+ if (error.code === 'ENOENT') return null;
42
+ throw error;
43
+ }
44
+ }
45
+
46
+ /**
47
+ * 判断路径是否是已存在的目录。
48
+ * @param {string} target 路径
49
+ * @returns {boolean} 是目录时为 true;不存在时为 false
50
+ */
51
+ export function isDirectory(target) {
52
+ try {
53
+ return statSync(target).isDirectory();
54
+ } catch (error) {
55
+ if (error.code === 'ENOENT') return false;
56
+ throw error;
57
+ }
58
+ }
59
+
60
+ /**
61
+ * 递归创建目录,已存在时不报错。
62
+ * @param {string} dir 目录路径
63
+ */
64
+ export function ensureDirectory(dir) {
65
+ mkdirSync(dir, { recursive: true });
66
+ }
@@ -0,0 +1,11 @@
1
+ // ------------------------------------------------------------------------
2
+ // 名称:index.mjs
3
+ // 说明:shared 目录的对外入口。
4
+ // 作者:sungbin
5
+ // 邮箱:sungbin@3578.cn
6
+ // 日期:2026-11-10
7
+ // 备注:其他目录只能经这个文件引用 shared。
8
+ // ------------------------------------------------------------------------
9
+ export { FcdevError } from './errors.mjs';
10
+ export { DEFAULT_TOOL_TIMEOUT_MS, runProcess } from './process.mjs';
11
+ export { ensureDirectory, getModifiedTime, isDirectory, readJsonFile } from './fs-utils.mjs';
@@ -0,0 +1,50 @@
1
+ // ------------------------------------------------------------------------
2
+ // 名称:process.mjs
3
+ // 说明:启动外部程序并收集输出:不经过 shell,参数逐个传递,带超时。
4
+ // 作者:sungbin
5
+ // 邮箱:sungbin@3578.cn
6
+ // 日期:2026-11-10
7
+ // 备注:编译、链接这类工具的输出原样保留,供上层透传给用户或问题匹配器。
8
+ // ------------------------------------------------------------------------
9
+ import { spawn } from 'node:child_process';
10
+ import { FcdevError } from './errors.mjs';
11
+
12
+ /** 外部工具默认的超时时间,单位毫秒 */
13
+ export const DEFAULT_TOOL_TIMEOUT_MS = 120_000;
14
+
15
+ /**
16
+ * @typedef {object} ProcessResult
17
+ * @property {number} code 退出码
18
+ * @property {string} stdout 标准输出
19
+ * @property {string} stderr 标准错误
20
+ */
21
+
22
+ /**
23
+ * 运行外部程序并等待结束。
24
+ * @param {string} file 可执行文件路径
25
+ * @param {string[]} args 参数列表
26
+ * @param {{cwd?: string, env?: NodeJS.ProcessEnv, timeoutMs?: number}} [options] 工作目录、环境变量与超时
27
+ * @returns {Promise<ProcessResult>} 程序以非零退出码结束时不抛错,由调用者判断
28
+ * @throws {FcdevError} 程序无法启动或超时
29
+ */
30
+ export function runProcess(file, args, { cwd, env, timeoutMs = DEFAULT_TOOL_TIMEOUT_MS } = {}) {
31
+ return new Promise((resolve, reject) => {
32
+ const child = spawn(file, args, { cwd, env, windowsHide: true, stdio: ['ignore', 'pipe', 'pipe'] });
33
+ const stdout = [];
34
+ const stderr = [];
35
+ const timer = setTimeout(() => {
36
+ child.kill();
37
+ reject(new FcdevError(`${file} 运行超过 ${timeoutMs} 毫秒,已终止`, { code: 'PROCESS_TIMEOUT' }));
38
+ }, timeoutMs);
39
+ child.stdout.on('data', (chunk) => stdout.push(chunk));
40
+ child.stderr.on('data', (chunk) => stderr.push(chunk));
41
+ child.on('error', (error) => {
42
+ clearTimeout(timer);
43
+ reject(new FcdevError(`无法启动 ${file}`, { code: 'PROCESS_START_FAILED', cause: error }));
44
+ });
45
+ child.on('close', (code) => {
46
+ clearTimeout(timer);
47
+ resolve({ code: code ?? -1, stdout: Buffer.concat(stdout).toString('utf8'), stderr: Buffer.concat(stderr).toString('utf8') });
48
+ });
49
+ });
50
+ }
@@ -0,0 +1,17 @@
1
+ // ------------------------------------------------------------------------
2
+ // 名称:index.mjs
3
+ // 说明:targets 目录的对外入口。
4
+ // 作者:sungbin
5
+ // 邮箱:sungbin@3578.cn
6
+ // 日期:2026-11-10
7
+ // 备注:无
8
+ // ------------------------------------------------------------------------
9
+ export { applyNameRule } from './name-rules.mjs';
10
+ export {
11
+ BUILTIN_TARGETS_DIR,
12
+ listTargetNames,
13
+ loadTarget,
14
+ parseTarget,
15
+ resolveTargetOptions,
16
+ resolveTargetPath,
17
+ } from './target-registry.mjs';
@@ -0,0 +1,33 @@
1
+ // ------------------------------------------------------------------------
2
+ // 名称:name-rules.mjs
3
+ // 说明:程序名规则:按目标声明的规则校验并规范化程序名。
4
+ // 作者:sungbin
5
+ // 邮箱:sungbin@3578.cn
6
+ // 日期:2026-11-10
7
+ // 备注:目前只有 DOS 8.3 一条规则;超长或含非法字符时报错,不静默截断。
8
+ // ------------------------------------------------------------------------
9
+ import { FcdevError } from '../shared/index.mjs';
10
+
11
+ /** DOS 8.3 的主名:1 到 8 个字母、数字、下划线或连字符 */
12
+ const DOS_BASE_NAME = /^[A-Za-z0-9_-]{1,8}$/;
13
+
14
+ /**
15
+ * 按目标的程序名规则校验并规范化程序名。
16
+ * @param {string} name 程序名(不含扩展名)
17
+ * @param {string|null} rule 目标声明的规则;null 表示不限制
18
+ * @returns {string} 规范化后的程序名
19
+ * @throws {FcdevError} 程序名不符合规则
20
+ */
21
+ export function applyNameRule(name, rule) {
22
+ if (rule === null) return name;
23
+ if (rule === 'dos-8.3') {
24
+ if (!DOS_BASE_NAME.test(name)) {
25
+ throw new FcdevError(`程序名“${name}”不符合 DOS 8.3 规则:主名为 1 到 8 个字母、数字、下划线或连字符`, {
26
+ code: 'NAME_INVALID',
27
+ hint: '在 fcdev.json 里用 name 指定程序名,或改文件名',
28
+ });
29
+ }
30
+ return name.toUpperCase();
31
+ }
32
+ throw new FcdevError(`未知的程序名规则:${rule}`, { code: 'TARGET_INVALID' });
33
+ }