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.
- package/LICENSE +201 -0
- package/README.md +82 -2
- package/bin/fcdev.mjs +17 -0
- package/package.json +38 -4
- package/src/api/header-parser.mjs +78 -0
- package/src/api/index.mjs +128 -0
- package/src/build/bank-link-config.mjs +74 -0
- package/src/build/build-plan.mjs +92 -0
- package/src/build/dependency-file.mjs +24 -0
- package/src/build/disk-builder.mjs +36 -0
- package/src/build/index.mjs +32 -0
- package/src/build/program-builder.mjs +212 -0
- package/src/build/source-collector.mjs +54 -0
- package/src/build/tool-arguments.mjs +83 -0
- package/src/cli/args-parser.mjs +84 -0
- package/src/cli/commands/api-command.mjs +62 -0
- package/src/cli/commands/build-command.mjs +34 -0
- package/src/cli/commands/debug-command.mjs +70 -0
- package/src/cli/commands/disasm-command.mjs +65 -0
- package/src/cli/commands/disk-command.mjs +34 -0
- package/src/cli/commands/info-command.mjs +33 -0
- package/src/cli/commands/project-info.mjs +57 -0
- package/src/cli/commands/run-command.mjs +68 -0
- package/src/cli/commands/sync-command.mjs +85 -0
- package/src/cli/index.mjs +103 -0
- package/src/config/config-loader.mjs +132 -0
- package/src/config/index.mjs +9 -0
- package/src/disasm/analysis.mjs +97 -0
- package/src/disasm/cdl.mjs +35 -0
- package/src/disasm/disassembler.mjs +114 -0
- package/src/disasm/index.mjs +16 -0
- package/src/disasm/info-writer.mjs +72 -0
- package/src/disasm/loaders.mjs +69 -0
- package/src/disasm/opcode-table.mjs +268 -0
- package/src/disasm/roundtrip.mjs +69 -0
- package/src/disasm/symbols.mjs +30 -0
- package/src/disasm/trace.mjs +25 -0
- package/src/emulator/debug-client.mjs +125 -0
- package/src/emulator/emulator-launcher.mjs +80 -0
- package/src/emulator/emulator-locator.mjs +62 -0
- package/src/emulator/index.mjs +11 -0
- package/src/packagers/fat-floppy.mjs +22 -0
- package/src/packagers/fat12-image.mjs +245 -0
- package/src/packagers/flat-binary.mjs +53 -0
- package/src/packagers/index.mjs +54 -0
- package/src/packagers/ines.mjs +38 -0
- package/src/shared/errors.mjs +25 -0
- package/src/shared/fs-utils.mjs +66 -0
- package/src/shared/index.mjs +11 -0
- package/src/shared/process.mjs +50 -0
- package/src/targets/index.mjs +17 -0
- package/src/targets/name-rules.mjs +33 -0
- package/src/targets/target-registry.mjs +225 -0
- package/src/toolchain/index.mjs +16 -0
- package/src/toolchain/toolchain-locator.mjs +104 -0
- package/targets/nes/asminc/fcnes.inc +16 -0
- package/targets/nes/chr/ascii-8x8.chr +0 -0
- package/targets/nes/chr/font8x8_basic.h +152 -0
- package/targets/nes/include/fcnes.h +45 -0
- package/targets/nes/lib/fcnes.lib +0 -0
- package/targets/nes/lib/nes-font.o +0 -0
- package/targets/nes/lib-build.json +9 -0
- package/targets/nes/src/fcnes.s +91 -0
- package/targets/nes/src/nes-font.s +12 -0
- package/targets/nes/target.json +27 -0
- package/targets/sb2000/api-reference.md +3295 -0
- package/targets/sb2000/api-unwrapped.json +36 -0
- package/targets/sb2000/asminc/sb2000.inc +418 -0
- package/targets/sb2000/include/sb2000-bank.h +74 -0
- package/targets/sb2000/include/sb2000-clock.h +68 -0
- package/targets/sb2000/include/sb2000-disk.h +141 -0
- package/targets/sb2000/include/sb2000-display.h +352 -0
- package/targets/sb2000/include/sb2000-file.h +273 -0
- package/targets/sb2000/include/sb2000-ime.h +158 -0
- package/targets/sb2000/include/sb2000-input.h +192 -0
- package/targets/sb2000/include/sb2000-math.h +228 -0
- package/targets/sb2000/include/sb2000-memory.h +115 -0
- package/targets/sb2000/include/sb2000-printer.h +116 -0
- package/targets/sb2000/include/sb2000-sound.h +134 -0
- package/targets/sb2000/include/sb2000-symbols.h +776 -0
- package/targets/sb2000/include/sb2000-system.h +219 -0
- package/targets/sb2000/include/sb2000-text.h +99 -0
- package/targets/sb2000/include/sb2000.h +45 -0
- package/targets/sb2000/lib/crt0.o +0 -0
- package/targets/sb2000/lib/sb2000.lib +0 -0
- package/targets/sb2000/lib-build.json +8 -0
- package/targets/sb2000/link-banked.cfg +42 -0
- package/targets/sb2000/link.cfg +35 -0
- package/targets/sb2000/src/crt0.s +122 -0
- package/targets/sb2000/src/lib/bank/sb-bank-current.c +18 -0
- package/targets/sb2000/src/lib/bank/sb-bank-select.c +21 -0
- package/targets/sb2000/src/lib/bank/sbi-bank-trampoline.s +46 -0
- package/targets/sb2000/src/lib/clock/sb-clock-get-date.c +17 -0
- package/targets/sb2000/src/lib/clock/sb-clock-get-time.c +17 -0
- package/targets/sb2000/src/lib/clock/sb-clock-set-date.c +21 -0
- package/targets/sb2000/src/lib/clock/sb-clock-set-time.c +17 -0
- package/targets/sb2000/src/lib/clock/sbi-date-from-fat.c +20 -0
- package/targets/sb2000/src/lib/clock/sbi-date-to-fat.c +24 -0
- package/targets/sb2000/src/lib/clock/sbi-time-from-fat.c +20 -0
- package/targets/sb2000/src/lib/clock/sbi-time-to-fat.c +19 -0
- package/targets/sb2000/src/lib/disk/sb-disk-format-track.c +18 -0
- package/targets/sb2000/src/lib/disk/sb-disk-free-bytes.c +38 -0
- package/targets/sb2000/src/lib/disk/sb-disk-init.c +16 -0
- package/targets/sb2000/src/lib/disk/sb-disk-read-sector.c +24 -0
- package/targets/sb2000/src/lib/disk/sb-disk-read-sectors.c +17 -0
- package/targets/sb2000/src/lib/disk/sb-disk-scan-track.c +27 -0
- package/targets/sb2000/src/lib/disk/sb-disk-start.c +16 -0
- package/targets/sb2000/src/lib/disk/sb-disk-stop.c +16 -0
- package/targets/sb2000/src/lib/disk/sb-disk-write-sector.c +19 -0
- package/targets/sb2000/src/lib/disk/sb-disk-write-sectors.c +17 -0
- package/targets/sb2000/src/lib/disk/sbi-disk-batch.c +23 -0
- package/targets/sb2000/src/lib/disk/sbi-disk-call.c +17 -0
- package/targets/sb2000/src/lib/disk/sbi-disk-set-position.c +18 -0
- package/targets/sb2000/src/lib/display/sb-cell-address.c +20 -0
- package/targets/sb2000/src/lib/display/sb-cells-copy.c +27 -0
- package/targets/sb2000/src/lib/display/sb-cells-fill.c +25 -0
- package/targets/sb2000/src/lib/display/sb-cells-rect.c +20 -0
- package/targets/sb2000/src/lib/display/sb-display-mode.c +16 -0
- package/targets/sb2000/src/lib/display/sb-glyph-address.c +28 -0
- package/targets/sb2000/src/lib/display/sb-image-fill-rect.c +26 -0
- package/targets/sb2000/src/lib/display/sb-image-load-raw.c +22 -0
- package/targets/sb2000/src/lib/display/sb-image-show-full.c +20 -0
- package/targets/sb2000/src/lib/display/sb-image-show.c +25 -0
- package/targets/sb2000/src/lib/display/sb-image-unpack-map.c +28 -0
- package/targets/sb2000/src/lib/display/sb-image-unpack-tiles.c +20 -0
- package/targets/sb2000/src/lib/display/sb-image-unpack-to-memory.c +22 -0
- package/targets/sb2000/src/lib/display/sb-palette-write.c +20 -0
- package/targets/sb2000/src/lib/display/sb-screen-clear.c +19 -0
- package/targets/sb2000/src/lib/display/sb-screen-flush.c +16 -0
- package/targets/sb2000/src/lib/display/sb-text-draw.c +22 -0
- package/targets/sb2000/src/lib/display/sb-text-field-ascii.c +25 -0
- package/targets/sb2000/src/lib/display/sb-text-field.c +25 -0
- package/targets/sb2000/src/lib/display/sb-text-to-memory.c +27 -0
- package/targets/sb2000/src/lib/display/sb-vram-bank.c +17 -0
- package/targets/sb2000/src/lib/display/sb-vram-fill.c +21 -0
- package/targets/sb2000/src/lib/display/sb-vram-load.c +21 -0
- package/targets/sb2000/src/lib/display/sb-window-compact.c +16 -0
- package/targets/sb2000/src/lib/display/sb-window-init.c +16 -0
- package/targets/sb2000/src/lib/display/sb-window-restore.c +17 -0
- package/targets/sb2000/src/lib/display/sb-window-save.c +21 -0
- package/targets/sb2000/src/lib/file/sb-dir-change.c +21 -0
- package/targets/sb2000/src/lib/file/sb-dir-current.c +27 -0
- package/targets/sb2000/src/lib/file/sb-dir-make.c +21 -0
- package/targets/sb2000/src/lib/file/sb-dir-open.c +61 -0
- package/targets/sb2000/src/lib/file/sb-dir-read.c +87 -0
- package/targets/sb2000/src/lib/file/sb-dir-remove.c +21 -0
- package/targets/sb2000/src/lib/file/sb-file-close.c +21 -0
- package/targets/sb2000/src/lib/file/sb-file-delete.c +21 -0
- package/targets/sb2000/src/lib/file/sb-file-get-attr.c +25 -0
- package/targets/sb2000/src/lib/file/sb-file-get-date.c +25 -0
- package/targets/sb2000/src/lib/file/sb-file-get-time.c +25 -0
- package/targets/sb2000/src/lib/file/sb-file-load.c +50 -0
- package/targets/sb2000/src/lib/file/sb-file-open.c +26 -0
- package/targets/sb2000/src/lib/file/sb-file-read.c +52 -0
- package/targets/sb2000/src/lib/file/sb-file-rename.c +30 -0
- package/targets/sb2000/src/lib/file/sb-file-save.c +31 -0
- package/targets/sb2000/src/lib/file/sb-file-set-attr.c +22 -0
- package/targets/sb2000/src/lib/file/sb-file-set-date.c +25 -0
- package/targets/sb2000/src/lib/file/sb-file-set-time.c +22 -0
- package/targets/sb2000/src/lib/file/sb-file-size.c +27 -0
- package/targets/sb2000/src/lib/file/sb-file-write-all.c +32 -0
- package/targets/sb2000/src/lib/file/sb-file-write.c +60 -0
- package/targets/sb2000/src/lib/file/sbi-dir-state.c +15 -0
- package/targets/sb2000/src/lib/file/sbi-dos-call.c +17 -0
- package/targets/sb2000/src/lib/file/sbi-load-sector.c +18 -0
- package/targets/sb2000/src/lib/file/sbi-select-handle.c +20 -0
- package/targets/sb2000/src/lib/file/sbi-set-path.c +26 -0
- package/targets/sb2000/src/lib/ime/sb-ime-get-method.c +17 -0
- package/targets/sb2000/src/lib/ime/sb-ime-get-state.c +18 -0
- package/targets/sb2000/src/lib/ime/sb-ime-hex.c +20 -0
- package/targets/sb2000/src/lib/ime/sb-ime-init.c +26 -0
- package/targets/sb2000/src/lib/ime/sb-ime-key-wait.c +19 -0
- package/targets/sb2000/src/lib/ime/sb-ime-key.c +19 -0
- package/targets/sb2000/src/lib/ime/sb-ime-parse.c +23 -0
- package/targets/sb2000/src/lib/ime/sb-ime-resume.c +16 -0
- package/targets/sb2000/src/lib/ime/sb-ime-select.c +19 -0
- package/targets/sb2000/src/lib/ime/sb-ime-set-state.c +18 -0
- package/targets/sb2000/src/lib/ime/sb-ime-set-width.c +16 -0
- package/targets/sb2000/src/lib/ime/sb-ime-suspend.c +16 -0
- package/targets/sb2000/src/lib/input/sb-break-disable.c +16 -0
- package/targets/sb2000/src/lib/input/sb-break-enable.c +16 -0
- package/targets/sb2000/src/lib/input/sb-key-count.c +17 -0
- package/targets/sb2000/src/lib/input/sb-key-flush.c +16 -0
- package/targets/sb2000/src/lib/input/sb-key-init.c +16 -0
- package/targets/sb2000/src/lib/input/sb-key-modifiers.c +16 -0
- package/targets/sb2000/src/lib/input/sb-key-poll.c +17 -0
- package/targets/sb2000/src/lib/input/sb-key-wait.c +17 -0
- package/targets/sb2000/src/lib/input/sb-keyboard-reset.c +17 -0
- package/targets/sb2000/src/lib/input/sb-mouse-buttons.c +21 -0
- package/targets/sb2000/src/lib/input/sb-mouse-position.c +18 -0
- package/targets/sb2000/src/lib/input/sb-mouse-reset.c +17 -0
- package/targets/sb2000/src/lib/input/sb-mouse-set-double-click.c +17 -0
- package/targets/sb2000/src/lib/input/sb-mouse-set-limits.c +26 -0
- package/targets/sb2000/src/lib/input/sb-mouse-set-position.c +18 -0
- package/targets/sb2000/src/lib/input/sb-pad-init.c +17 -0
- package/targets/sb2000/src/lib/input/sb-pad-poll.c +17 -0
- package/targets/sb2000/src/lib/input/sb-pad-state.c +16 -0
- package/targets/sb2000/src/lib/input/sb-pad-wait.c +17 -0
- package/targets/sb2000/src/lib/math/sb-float-add.c +19 -0
- package/targets/sb2000/src/lib/math/sb-float-div.c +19 -0
- package/targets/sb2000/src/lib/math/sb-float-from-text.c +18 -0
- package/targets/sb2000/src/lib/math/sb-float-mul.c +19 -0
- package/targets/sb2000/src/lib/math/sb-float-sub.c +19 -0
- package/targets/sb2000/src/lib/math/sb-float-to-text.c +19 -0
- package/targets/sb2000/src/lib/math/sb-int24-add.c +21 -0
- package/targets/sb2000/src/lib/math/sb-int24-div.c +26 -0
- package/targets/sb2000/src/lib/math/sb-int24-mul.c +20 -0
- package/targets/sb2000/src/lib/math/sb-int24-sub.c +21 -0
- package/targets/sb2000/src/lib/math/sb-int40-from-text.c +19 -0
- package/targets/sb2000/src/lib/math/sb-int40-to-text.c +27 -0
- package/targets/sb2000/src/lib/math/sb-line-step.c +21 -0
- package/targets/sb2000/src/lib/math/sb-math-div16.c +27 -0
- package/targets/sb2000/src/lib/math/sb-math-time-text.c +21 -0
- package/targets/sb2000/src/lib/math/sb-random-next.c +20 -0
- package/targets/sb2000/src/lib/math/sb-random-seed.c +19 -0
- package/targets/sb2000/src/lib/math/sb-random-warm-up.c +16 -0
- package/targets/sb2000/src/lib/math/sbi-peek.c +20 -0
- package/targets/sb2000/src/lib/math/sbi-poke.c +20 -0
- package/targets/sb2000/src/lib/memory/sb-address-to-far.c +20 -0
- package/targets/sb2000/src/lib/memory/sb-far-read-byte.c +17 -0
- package/targets/sb2000/src/lib/memory/sb-far-read.c +36 -0
- package/targets/sb2000/src/lib/memory/sb-far-write-byte.c +17 -0
- package/targets/sb2000/src/lib/memory/sb-far-write.c +36 -0
- package/targets/sb2000/src/lib/memory/sb-page-alloc.c +19 -0
- package/targets/sb2000/src/lib/memory/sb-page-free.c +19 -0
- package/targets/sb2000/src/lib/memory/sb-page-largest-free.c +17 -0
- package/targets/sb2000/src/lib/memory/sb-window-map-group.c +17 -0
- package/targets/sb2000/src/lib/memory/sb-window-map.c +18 -0
- package/targets/sb2000/src/lib/memory/sbi-far-copy-in.s +17 -0
- package/targets/sb2000/src/lib/memory/sbi-far-copy-out.s +17 -0
- package/targets/sb2000/src/lib/memory/sbi-far-read-byte.s +19 -0
- package/targets/sb2000/src/lib/memory/sbi-far-write-byte.s +17 -0
- package/targets/sb2000/src/lib/printer/sb-printer-carriage-return.c +16 -0
- package/targets/sb2000/src/lib/printer/sb-printer-feed.c +17 -0
- package/targets/sb2000/src/lib/printer/sb-printer-graphics-mode.c +16 -0
- package/targets/sb2000/src/lib/printer/sb-printer-home.c +16 -0
- package/targets/sb2000/src/lib/printer/sb-printer-init-port.c +16 -0
- package/targets/sb2000/src/lib/printer/sb-printer-page-left.c +16 -0
- package/targets/sb2000/src/lib/printer/sb-printer-page-length.c +17 -0
- package/targets/sb2000/src/lib/printer/sb-printer-position.c +18 -0
- package/targets/sb2000/src/lib/printer/sb-printer-reset.c +16 -0
- package/targets/sb2000/src/lib/printer/sb-printer-send-byte.c +18 -0
- package/targets/sb2000/src/lib/printer/sb-printer-text.c +29 -0
- package/targets/sb2000/src/lib/sb-internal.h +111 -0
- package/targets/sb2000/src/lib/sound/sb-sound-effect-from.c +19 -0
- package/targets/sb2000/src/lib/sound/sb-sound-play-from.c +18 -0
- package/targets/sb2000/src/lib/sound/sb-sound-play-wav-from.c +18 -0
- package/targets/sb2000/src/lib/sound/sb-sound-play-wav.c +16 -0
- package/targets/sb2000/src/lib/sound/sb-sound-repeat-wav-from.c +19 -0
- package/targets/sb2000/src/lib/sound/sb-sound-status.c +17 -0
- package/targets/sb2000/src/lib/sound/sb-sound-stop.c +16 -0
- package/targets/sb2000/src/lib/sound/sb-sound-tempo.c +17 -0
- package/targets/sb2000/src/lib/sound/sb-sound-transpose.c +17 -0
- package/targets/sb2000/src/lib/sound/sb-speech-off.c +16 -0
- package/targets/sb2000/src/lib/sound/sb-speech-send-entry-from.c +21 -0
- package/targets/sb2000/src/lib/sound/sb-speech-send-from.c +19 -0
- package/targets/sb2000/src/lib/sound/sb-speech-send.c +16 -0
- package/targets/sb2000/src/lib/system/sb-call-banked.c +19 -0
- package/targets/sb2000/src/lib/system/sb-context-restore.c +16 -0
- package/targets/sb2000/src/lib/system/sb-context-save.c +19 -0
- package/targets/sb2000/src/lib/system/sb-display-off.c +16 -0
- package/targets/sb2000/src/lib/system/sb-display-on.c +16 -0
- package/targets/sb2000/src/lib/system/sb-display-option.c +18 -0
- package/targets/sb2000/src/lib/system/sb-exec.c +22 -0
- package/targets/sb2000/src/lib/system/sb-irq-enable.c +19 -0
- package/targets/sb2000/src/lib/system/sb-irq-hook-reset.c +20 -0
- package/targets/sb2000/src/lib/system/sb-irq-hook-set.c +39 -0
- package/targets/sb2000/src/lib/system/sb-irq-mask.c +19 -0
- package/targets/sb2000/src/lib/system/sb-jump-banked.s +25 -0
- package/targets/sb2000/src/lib/system/sb-nmi-disable.c +16 -0
- package/targets/sb2000/src/lib/system/sb-nmi-enable.c +16 -0
- package/targets/sb2000/src/lib/system/sb-nmi-hook-reset.c +20 -0
- package/targets/sb2000/src/lib/system/sb-nmi-hook-set.c +33 -0
- package/targets/sb2000/src/lib/system/sb-nmi-service.c +19 -0
- package/targets/sb2000/src/lib/system/sb-stack-pointer.s +18 -0
- package/targets/sb2000/src/lib/system/sb-system-init.c +16 -0
- package/targets/sb2000/src/lib/system/sb-system-state.c +20 -0
- package/targets/sb2000/src/lib/system/sb-wait-frames.s +19 -0
- package/targets/sb2000/src/lib/system/sbi-exec-run.s +43 -0
- package/targets/sb2000/src/lib/system/sbi-interrupts-off.s +19 -0
- package/targets/sb2000/src/lib/system/sbi-interrupts-restore.s +17 -0
- package/targets/sb2000/src/lib/text/sb-beep.c +16 -0
- package/targets/sb2000/src/lib/text/sb-cursor-column.c +16 -0
- package/targets/sb2000/src/lib/text/sb-cursor-left.c +16 -0
- package/targets/sb2000/src/lib/text/sb-cursor-right.c +16 -0
- package/targets/sb2000/src/lib/text/sb-cursor-row.c +16 -0
- package/targets/sb2000/src/lib/text/sb-cursor-set-column.c +18 -0
- package/targets/sb2000/src/lib/text/sb-cursor-up.c +16 -0
- package/targets/sb2000/src/lib/text/sb-print-hex.c +22 -0
- package/targets/sb2000/src/lib/text/sb-print-uint.c +25 -0
- package/targets/sb2000/src/lib/text/sb-print.c +35 -0
- package/targets/sb2000/src/lib/text/sb-putc.c +26 -0
- package/targets/sb2000/src/sb2000.s +64 -0
- package/targets/sb2000/target.json +42 -0
|
@@ -0,0 +1,92 @@
|
|
|
1
|
+
// ------------------------------------------------------------------------
|
|
2
|
+
// 名称:build-plan.mjs
|
|
3
|
+
// 说明:把命令行的构建路径解析成构建计划:确定项目配置、目标、源文件、程序名与输出位置。
|
|
4
|
+
// 作者:sungbin
|
|
5
|
+
// 邮箱:sungbin@3578.cn
|
|
6
|
+
// 日期:2026-11-10
|
|
7
|
+
// 备注:规则见 docs/02-命令行与构建.md 第 2 节:无参数为当前目录;目录整体构成一个程序;文件单独构成一个程序。
|
|
8
|
+
// ------------------------------------------------------------------------
|
|
9
|
+
import { statSync } from 'node:fs';
|
|
10
|
+
import path from 'node:path';
|
|
11
|
+
import { loadProjectConfig } from '../config/index.mjs';
|
|
12
|
+
import { FcdevError } from '../shared/index.mjs';
|
|
13
|
+
import { applyNameRule, loadTarget, resolveTargetOptions } from '../targets/index.mjs';
|
|
14
|
+
import { collectSources, getSourceLanguage } from './source-collector.mjs';
|
|
15
|
+
|
|
16
|
+
/**
|
|
17
|
+
* @typedef {object} BuildPlan
|
|
18
|
+
* @property {'file'|'directory'} mode 构建单位
|
|
19
|
+
* @property {string} sourceBase 源文件的公共根目录,用于生成中间文件名
|
|
20
|
+
* @property {string[]} sources 源文件的绝对路径
|
|
21
|
+
* @property {string} programName 程序名(中间文件目录用)
|
|
22
|
+
* @property {string} outputFile 最终产物的绝对路径
|
|
23
|
+
* @property {string} objectDir 中间文件目录
|
|
24
|
+
* @property {import('../targets/index.mjs').Target} target 目标
|
|
25
|
+
* @property {Record<string, unknown>} targetOptions 合并后的目标专用选项
|
|
26
|
+
* @property {import('../config/index.mjs').ProjectConfig} config 项目配置
|
|
27
|
+
*/
|
|
28
|
+
|
|
29
|
+
/**
|
|
30
|
+
* 读取路径信息,不存在时给出明确的错误。
|
|
31
|
+
* @param {string} target 绝对路径
|
|
32
|
+
* @returns {import('node:fs').Stats} 路径信息
|
|
33
|
+
*/
|
|
34
|
+
function statOrFail(target) {
|
|
35
|
+
try {
|
|
36
|
+
return statSync(target);
|
|
37
|
+
} catch (error) {
|
|
38
|
+
if (error.code === 'ENOENT') throw new FcdevError(`找不到 ${target}`, { code: 'PATH_NOT_FOUND' });
|
|
39
|
+
throw error;
|
|
40
|
+
}
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
/**
|
|
44
|
+
* 解析构建路径,生成构建计划。
|
|
45
|
+
* @param {{pathArg?: string, cwd: string, targetOverride?: string, targetsDir?: string}} input pathArg 为命令行路径,缺省为当前目录;cwd 为终端当前目录
|
|
46
|
+
* @returns {BuildPlan} 构建计划
|
|
47
|
+
* @throws {FcdevError} 路径不存在、没有指定目标、文件不是源文件等
|
|
48
|
+
*/
|
|
49
|
+
export function createBuildPlan({ pathArg = '.', cwd, targetOverride, targetsDir }) {
|
|
50
|
+
const absolute = path.resolve(cwd, pathArg);
|
|
51
|
+
const info = statOrFail(absolute);
|
|
52
|
+
const config = loadProjectConfig(info.isDirectory() ? absolute : path.dirname(absolute), cwd);
|
|
53
|
+
|
|
54
|
+
const targetName = targetOverride ?? config.target;
|
|
55
|
+
if (!targetName) {
|
|
56
|
+
throw new FcdevError('没有指定目标', { code: 'TARGET_MISSING', hint: '在 fcdev.json 里写 "target",或用 --target <名> 指定' });
|
|
57
|
+
}
|
|
58
|
+
const target = loadTarget(targetName, targetsDir);
|
|
59
|
+
const targetOptions = resolveTargetOptions(target, config.targetOptions);
|
|
60
|
+
|
|
61
|
+
let mode;
|
|
62
|
+
let sourceBase;
|
|
63
|
+
let sources;
|
|
64
|
+
let programName;
|
|
65
|
+
if (info.isDirectory()) {
|
|
66
|
+
mode = 'directory';
|
|
67
|
+
sourceBase = absolute;
|
|
68
|
+
sources = collectSources(absolute, [config.outDir]);
|
|
69
|
+
programName = config.name ?? path.basename(absolute);
|
|
70
|
+
} else {
|
|
71
|
+
if (!getSourceLanguage(absolute)) {
|
|
72
|
+
throw new FcdevError(`${absolute} 不是 .c、.s 或 .asm 源文件`, { code: 'NOT_A_SOURCE' });
|
|
73
|
+
}
|
|
74
|
+
mode = 'file';
|
|
75
|
+
sourceBase = path.dirname(absolute);
|
|
76
|
+
sources = [absolute];
|
|
77
|
+
programName = path.basename(absolute, path.extname(absolute));
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
const outputName = applyNameRule(programName, target.nameRule);
|
|
81
|
+
return {
|
|
82
|
+
mode,
|
|
83
|
+
sourceBase,
|
|
84
|
+
sources,
|
|
85
|
+
programName,
|
|
86
|
+
outputFile: path.join(config.outDir, target.name, `${outputName}${target.extension}`),
|
|
87
|
+
objectDir: path.join(config.outDir, 'obj', target.name, programName),
|
|
88
|
+
target,
|
|
89
|
+
targetOptions,
|
|
90
|
+
config,
|
|
91
|
+
};
|
|
92
|
+
}
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
// ------------------------------------------------------------------------
|
|
2
|
+
// 名称:dependency-file.mjs
|
|
3
|
+
// 说明:解析 cc65、ca65 用 --create-dep 生成的依赖文件(make 格式)。
|
|
4
|
+
// 作者:sungbin
|
|
5
|
+
// 邮箱:sungbin@3578.cn
|
|
6
|
+
// 日期:2026-11-10
|
|
7
|
+
// 备注:路径里的空格用反斜杠转义;Windows 路径里的反斜杠分隔符保持原样。
|
|
8
|
+
// ------------------------------------------------------------------------
|
|
9
|
+
|
|
10
|
+
/**
|
|
11
|
+
* 取出依赖文件里第一条规则的依赖项。
|
|
12
|
+
* @param {string} text 依赖文件内容
|
|
13
|
+
* @returns {string[]} 依赖文件路径;没有规则时为空数组
|
|
14
|
+
*/
|
|
15
|
+
export function parseDependencyFile(text) {
|
|
16
|
+
const joined = text.replace(/\\\r?\n/g, ' ');
|
|
17
|
+
const firstRule = joined.split(/\r?\n/).find((line) => line.trim() !== '');
|
|
18
|
+
if (!firstRule) return [];
|
|
19
|
+
// 规则的冒号后面一定是空白;盘符的冒号后面是路径分隔符,不会被误判
|
|
20
|
+
const separator = firstRule.search(/:(\s|$)/);
|
|
21
|
+
if (separator < 0) return [];
|
|
22
|
+
const dependencies = firstRule.slice(separator + 1).match(/(?:\\ |\S)+/g) ?? [];
|
|
23
|
+
return dependencies.map((item) => item.replaceAll('\\ ', ' '));
|
|
24
|
+
}
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
// ------------------------------------------------------------------------
|
|
2
|
+
// 名称:disk-builder.mjs
|
|
3
|
+
// 说明:把构建出的程序放进磁盘镜像:按目标声明的磁盘打包器生成镜像文件。
|
|
4
|
+
// 作者:sungbin
|
|
5
|
+
// 邮箱:sungbin@3578.cn
|
|
6
|
+
// 日期:2026-11-10
|
|
7
|
+
// 备注:镜像里只放这一次构建的程序;镜像放在程序产物旁边,文件名与程序名相同。
|
|
8
|
+
// ------------------------------------------------------------------------
|
|
9
|
+
import { readFileSync, statSync } from 'node:fs';
|
|
10
|
+
import path from 'node:path';
|
|
11
|
+
import { getDiskPackager } from '../packagers/index.mjs';
|
|
12
|
+
import { FcdevError } from '../shared/index.mjs';
|
|
13
|
+
|
|
14
|
+
/** 镜像卷标 */
|
|
15
|
+
const DISK_LABEL = 'FCDEV';
|
|
16
|
+
|
|
17
|
+
/**
|
|
18
|
+
* 生成包含这次构建的程序的磁盘镜像。
|
|
19
|
+
* @param {import('./build-plan.mjs').BuildPlan} plan 构建计划
|
|
20
|
+
* @param {import('./program-builder.mjs').BuildResult} result 构建结果
|
|
21
|
+
* @returns {{imageFile: string, size: number}} 镜像路径与大小
|
|
22
|
+
* @throws {FcdevError} 目标不支持磁盘镜像,或程序名不符合镜像文件名规则
|
|
23
|
+
*/
|
|
24
|
+
export function buildDiskImage(plan, result) {
|
|
25
|
+
if (!plan.target.disk) {
|
|
26
|
+
throw new FcdevError(`目标 ${plan.target.name} 不支持磁盘镜像`, { code: 'TARGET_NO_DISK' });
|
|
27
|
+
}
|
|
28
|
+
const outputName = path.basename(result.outputFile);
|
|
29
|
+
const imageFile = path.join(path.dirname(result.outputFile), `${path.basename(outputName, path.extname(outputName))}.img`);
|
|
30
|
+
const packaged = getDiskPackager(plan.target.disk.packager)({
|
|
31
|
+
files: [{ name: outputName, data: readFileSync(result.outputFile), mtime: statSync(result.outputFile).mtime }],
|
|
32
|
+
outputFile: imageFile,
|
|
33
|
+
options: { label: DISK_LABEL },
|
|
34
|
+
});
|
|
35
|
+
return { imageFile: packaged.outputFile, size: packaged.size };
|
|
36
|
+
}
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
// ------------------------------------------------------------------------
|
|
2
|
+
// 名称:index.mjs
|
|
3
|
+
// 说明:build 目录的对外入口:解析构建路径并构建程序。
|
|
4
|
+
// 作者:sungbin
|
|
5
|
+
// 邮箱:sungbin@3578.cn
|
|
6
|
+
// 日期:2026-11-10
|
|
7
|
+
// 备注:无
|
|
8
|
+
// ------------------------------------------------------------------------
|
|
9
|
+
import { locateToolchain } from '../toolchain/index.mjs';
|
|
10
|
+
import { createBuildPlan } from './build-plan.mjs';
|
|
11
|
+
import { buildProgram } from './program-builder.mjs';
|
|
12
|
+
|
|
13
|
+
export { createBuildPlan } from './build-plan.mjs';
|
|
14
|
+
export { expandBankedLinkConfig, getBankCount, resolveLinkSetup } from './bank-link-config.mjs';
|
|
15
|
+
export { parseDependencyFile } from './dependency-file.mjs';
|
|
16
|
+
export { buildDiskImage } from './disk-builder.mjs';
|
|
17
|
+
export { buildProgram } from './program-builder.mjs';
|
|
18
|
+
export { collectSources, getSourceLanguage } from './source-collector.mjs';
|
|
19
|
+
export { buildAssemblerArguments, buildCompilerArguments, buildLinkerArguments } from './tool-arguments.mjs';
|
|
20
|
+
|
|
21
|
+
/**
|
|
22
|
+
* 解析路径并构建。
|
|
23
|
+
* @param {{pathArg?: string, cwd: string, targetOverride?: string, targetsDir?: string, env?: NodeJS.ProcessEnv}} input 构建路径、终端目录与目标覆盖
|
|
24
|
+
* @param {import('./program-builder.mjs').Reporter} [reporter] 汇报器
|
|
25
|
+
* @returns {Promise<{plan: import('./build-plan.mjs').BuildPlan, result: import('./program-builder.mjs').BuildResult}>} 计划与结果
|
|
26
|
+
*/
|
|
27
|
+
export async function buildPath(input, reporter) {
|
|
28
|
+
const plan = createBuildPlan(input);
|
|
29
|
+
const toolchain = locateToolchain({ configured: plan.config.toolchain, env: input.env });
|
|
30
|
+
const result = await buildProgram(plan, toolchain, reporter);
|
|
31
|
+
return { plan, result };
|
|
32
|
+
}
|
|
@@ -0,0 +1,212 @@
|
|
|
1
|
+
// ------------------------------------------------------------------------
|
|
2
|
+
// 名称:program-builder.mjs
|
|
3
|
+
// 说明:构建一个程序:逐个编译与汇编源文件,链接,再交给打包器;支持增量构建。
|
|
4
|
+
// 作者:sungbin
|
|
5
|
+
// 邮箱:sungbin@3578.cn
|
|
6
|
+
// 日期:2026-11-10
|
|
7
|
+
// 备注:某个目标文件比源文件和依赖文件新就不重编;目标、选项、fcdev 或工具链版本变化时全部重编(指纹存在 stamp.json)。
|
|
8
|
+
// ------------------------------------------------------------------------
|
|
9
|
+
import { createHash } from 'node:crypto';
|
|
10
|
+
import { readFileSync, rmSync, writeFileSync } from 'node:fs';
|
|
11
|
+
import path from 'node:path';
|
|
12
|
+
import { fileURLToPath } from 'node:url';
|
|
13
|
+
import { ensureDirectory, FcdevError, getModifiedTime, readJsonFile } from '../shared/index.mjs';
|
|
14
|
+
import { getPackager } from '../packagers/index.mjs';
|
|
15
|
+
import { resolveTargetPath } from '../targets/index.mjs';
|
|
16
|
+
import { getToolchainVersion, runTool } from '../toolchain/index.mjs';
|
|
17
|
+
import { resolveLinkSetup } from './bank-link-config.mjs';
|
|
18
|
+
import { parseDependencyFile } from './dependency-file.mjs';
|
|
19
|
+
import { getSourceLanguage } from './source-collector.mjs';
|
|
20
|
+
import { buildAssemblerArguments, buildCompilerArguments, buildLinkerArguments } from './tool-arguments.mjs';
|
|
21
|
+
|
|
22
|
+
/** 主包自身的 package.json,用于取版本号 */
|
|
23
|
+
const PACKAGE_JSON_FILE = fileURLToPath(new URL('../../package.json', import.meta.url));
|
|
24
|
+
|
|
25
|
+
/**
|
|
26
|
+
* @typedef {object} Reporter
|
|
27
|
+
* @property {(message: string) => void} log 进度信息
|
|
28
|
+
* @property {(text: string) => void} write 工具的原始输出,原样透传
|
|
29
|
+
*/
|
|
30
|
+
|
|
31
|
+
/**
|
|
32
|
+
* @typedef {object} BuildResult
|
|
33
|
+
* @property {string} programName 程序名
|
|
34
|
+
* @property {string} outputFile 产物路径
|
|
35
|
+
* @property {number} size 产物大小
|
|
36
|
+
* @property {number} compiled 本次重新编译的源文件数
|
|
37
|
+
* @property {number} reused 沿用上次结果的源文件数
|
|
38
|
+
*/
|
|
39
|
+
|
|
40
|
+
/** 不输出任何信息的汇报器 */
|
|
41
|
+
const SILENT_REPORTER = { log() {}, write() {} };
|
|
42
|
+
|
|
43
|
+
/**
|
|
44
|
+
* 计算增量构建的指纹。
|
|
45
|
+
* @param {import('./build-plan.mjs').BuildPlan} plan 构建计划
|
|
46
|
+
* @param {string} toolchainVersion 工具链版本
|
|
47
|
+
* @returns {string} 指纹
|
|
48
|
+
*/
|
|
49
|
+
function computeFingerprint(plan, toolchainVersion) {
|
|
50
|
+
const fcdevVersion = readJsonFile(PACKAGE_JSON_FILE).version;
|
|
51
|
+
const content = {
|
|
52
|
+
fcdevVersion,
|
|
53
|
+
toolchainVersion,
|
|
54
|
+
target: plan.target,
|
|
55
|
+
targetOptions: plan.targetOptions,
|
|
56
|
+
optimize: plan.config.optimize,
|
|
57
|
+
define: plan.config.define,
|
|
58
|
+
include: plan.config.include,
|
|
59
|
+
sources: plan.sources.map((source) => path.relative(plan.sourceBase, source)),
|
|
60
|
+
};
|
|
61
|
+
return createHash('sha256').update(JSON.stringify(content)).digest('hex');
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
/**
|
|
65
|
+
* 读取上次构建记录的指纹。
|
|
66
|
+
* @param {string} stampFile 指纹文件
|
|
67
|
+
* @returns {string|null} 指纹;没有记录或文件损坏时为 null
|
|
68
|
+
*/
|
|
69
|
+
function readStamp(stampFile) {
|
|
70
|
+
try {
|
|
71
|
+
return JSON.parse(readFileSync(stampFile, 'utf8')).fingerprint ?? null;
|
|
72
|
+
} catch {
|
|
73
|
+
return null;
|
|
74
|
+
}
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
/**
|
|
78
|
+
* 判断目标文件是否比源文件和依赖文件都新。
|
|
79
|
+
* @param {string} objectFile 目标文件
|
|
80
|
+
* @param {string} sourceFile 源文件
|
|
81
|
+
* @param {string} dependencyFile 依赖文件
|
|
82
|
+
* @returns {boolean} 不需要重编时为 true
|
|
83
|
+
*/
|
|
84
|
+
function isUpToDate(objectFile, sourceFile, dependencyFile) {
|
|
85
|
+
const objectTime = getModifiedTime(objectFile);
|
|
86
|
+
const dependencyText = getModifiedTime(dependencyFile) === null ? null : readFileSync(dependencyFile, 'utf8');
|
|
87
|
+
if (objectTime === null || dependencyText === null) return false;
|
|
88
|
+
const inputs = [sourceFile, ...parseDependencyFile(dependencyText)];
|
|
89
|
+
return inputs.every((input) => {
|
|
90
|
+
const time = getModifiedTime(input);
|
|
91
|
+
return time !== null && time <= objectTime;
|
|
92
|
+
});
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
/**
|
|
96
|
+
* 运行一个工具;失败时透传输出并抛错。
|
|
97
|
+
* @param {import('../toolchain/index.mjs').Toolchain} toolchain 工具链
|
|
98
|
+
* @param {string} tool 工具名
|
|
99
|
+
* @param {string[]} args 参数
|
|
100
|
+
* @param {Reporter} reporter 汇报器
|
|
101
|
+
* @param {string} failureMessage 失败时的说明
|
|
102
|
+
* @returns {Promise<import('../shared/index.mjs').ProcessResult>} 运行结果
|
|
103
|
+
* @throws {FcdevError} 工具以非零退出码结束
|
|
104
|
+
*/
|
|
105
|
+
async function runChecked(toolchain, tool, args, reporter, failureMessage) {
|
|
106
|
+
const result = await runTool(toolchain, tool, args);
|
|
107
|
+
const text = `${result.stdout}${result.stderr}`;
|
|
108
|
+
if (text !== '') reporter.write(text.endsWith('\n') ? text : `${text}\n`);
|
|
109
|
+
if (result.code !== 0) throw new FcdevError(failureMessage, { code: 'TOOL_FAILED', hint: describeToolFailure(text) });
|
|
110
|
+
return result;
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
/**
|
|
114
|
+
* 根据链接器的输出给出常见问题的提示。
|
|
115
|
+
* @param {string} output 工具输出
|
|
116
|
+
* @returns {string} 提示;没有可提示的内容时为空
|
|
117
|
+
*/
|
|
118
|
+
function describeToolFailure(output) {
|
|
119
|
+
if (/Unresolved external[^\w]*_?main\b/i.test(output)) return '没有找到 main:C 程序要定义 main,汇编程序要 .export _main';
|
|
120
|
+
if (/Duplicate external identifier[^\w]*_?main\b/i.test(output)) return '目录里有多个 main;若要单独构建一个程序,请指定文件名';
|
|
121
|
+
if (/Missing memory area assignment for segment .BANK\d+/.test(output)) return '库页个数不够:在 fcdev.json 的 targetOptions.banks 里加大库页个数';
|
|
122
|
+
return '';
|
|
123
|
+
}
|
|
124
|
+
|
|
125
|
+
/**
|
|
126
|
+
* 编译或汇编一个源文件,得到目标文件。
|
|
127
|
+
* @param {object} context 构建上下文
|
|
128
|
+
* @param {string} source 源文件
|
|
129
|
+
* @param {string} objectFile 目标文件
|
|
130
|
+
* @returns {Promise<void>}
|
|
131
|
+
*/
|
|
132
|
+
async function compileSource(context, source, objectFile) {
|
|
133
|
+
const { toolchain, settings, reporter } = context;
|
|
134
|
+
const base = objectFile.slice(0, -'.o'.length);
|
|
135
|
+
if (getSourceLanguage(source) === 'c') {
|
|
136
|
+
const asmFile = `${base}.s`;
|
|
137
|
+
await runChecked(toolchain, 'cc65', buildCompilerArguments(settings, { source, output: asmFile, dependencyFile: `${base}.d` }), reporter, `编译失败:${source}`);
|
|
138
|
+
await runChecked(toolchain, 'ca65', buildAssemblerArguments(settings, { source: asmFile, output: objectFile, dependencyFile: `${base}.asm.d` }), reporter, `汇编失败:${asmFile}`);
|
|
139
|
+
} else {
|
|
140
|
+
await runChecked(toolchain, 'ca65', buildAssemblerArguments(settings, { source, output: objectFile, dependencyFile: `${base}.d` }), reporter, `汇编失败:${source}`);
|
|
141
|
+
}
|
|
142
|
+
}
|
|
143
|
+
|
|
144
|
+
/**
|
|
145
|
+
* 构建一个程序。
|
|
146
|
+
* @param {import('./build-plan.mjs').BuildPlan} plan 构建计划
|
|
147
|
+
* @param {import('../toolchain/index.mjs').Toolchain} toolchain 工具链
|
|
148
|
+
* @param {Reporter} [reporter] 汇报器
|
|
149
|
+
* @returns {Promise<BuildResult>} 构建结果
|
|
150
|
+
* @throws {FcdevError} 编译、链接或打包失败
|
|
151
|
+
*/
|
|
152
|
+
export async function buildProgram(plan, toolchain, reporter = SILENT_REPORTER) {
|
|
153
|
+
const { target, config } = plan;
|
|
154
|
+
const toTargetPaths = (values) => values.map((value) => resolveTargetPath(target, value, toolchain.home));
|
|
155
|
+
const settings = {
|
|
156
|
+
cc65Target: target.cc65Target,
|
|
157
|
+
cpu: target.cpu,
|
|
158
|
+
optimize: config.optimize,
|
|
159
|
+
includeDirs: [...toTargetPaths(target.include), ...config.include, plan.sourceBase],
|
|
160
|
+
asmIncludeDirs: [...toTargetPaths(target.asminclude), ...config.include, plan.sourceBase],
|
|
161
|
+
defines: { ...target.defines, ...config.define },
|
|
162
|
+
};
|
|
163
|
+
|
|
164
|
+
ensureDirectory(plan.objectDir);
|
|
165
|
+
ensureDirectory(path.dirname(plan.outputFile));
|
|
166
|
+
|
|
167
|
+
const stampFile = path.join(plan.objectDir, 'stamp.json');
|
|
168
|
+
const fingerprint = computeFingerprint(plan, await getToolchainVersion(toolchain));
|
|
169
|
+
if (readStamp(stampFile) !== fingerprint) {
|
|
170
|
+
// 指纹变了:删掉旧的中间文件再重编
|
|
171
|
+
rmSync(plan.objectDir, { recursive: true, force: true });
|
|
172
|
+
ensureDirectory(plan.objectDir);
|
|
173
|
+
}
|
|
174
|
+
|
|
175
|
+
const context = { toolchain, settings, reporter };
|
|
176
|
+
const objects = [];
|
|
177
|
+
let compiled = 0;
|
|
178
|
+
let reused = 0;
|
|
179
|
+
for (const source of plan.sources) {
|
|
180
|
+
const relative = path.relative(plan.sourceBase, source);
|
|
181
|
+
const objectName = `${relative.slice(0, relative.length - path.extname(relative).length).split(path.sep).join('__')}.o`;
|
|
182
|
+
const objectFile = path.join(plan.objectDir, objectName);
|
|
183
|
+
objects.push(objectFile);
|
|
184
|
+
if (isUpToDate(objectFile, source, `${objectFile.slice(0, -2)}.d`)) {
|
|
185
|
+
reused += 1;
|
|
186
|
+
continue;
|
|
187
|
+
}
|
|
188
|
+
reporter.log(`编译 ${relative}`);
|
|
189
|
+
await compileSource(context, source, objectFile);
|
|
190
|
+
compiled += 1;
|
|
191
|
+
}
|
|
192
|
+
|
|
193
|
+
const binaryFile = path.join(plan.objectDir, `${plan.programName}.bin`);
|
|
194
|
+
const optionObjects = Object.entries(plan.targetOptions)
|
|
195
|
+
.filter(([key, value]) => value === true && target.options[key])
|
|
196
|
+
.flatMap(([key]) => target.options[key].links);
|
|
197
|
+
reporter.log('链接');
|
|
198
|
+
const linkSetup = resolveLinkSetup(plan, toolchain.home);
|
|
199
|
+
await runChecked(toolchain, 'ld65', buildLinkerArguments({
|
|
200
|
+
linkConfig: linkSetup.linkConfig,
|
|
201
|
+
binaryFile,
|
|
202
|
+
mapFile: path.join(plan.objectDir, `${plan.programName}.map`),
|
|
203
|
+
debugFile: path.join(plan.objectDir, `${plan.programName}.dbg`),
|
|
204
|
+
objects: [...toTargetPaths(target.startup), ...objects, ...toTargetPaths(optionObjects)],
|
|
205
|
+
libraries: toTargetPaths(target.libraries),
|
|
206
|
+
forceImports: target.forceImports,
|
|
207
|
+
}), reporter, `链接失败:${plan.programName}`);
|
|
208
|
+
|
|
209
|
+
const packaged = getPackager(target.packager)({ binaryFile, outputFile: plan.outputFile, options: linkSetup.packagerOptions });
|
|
210
|
+
writeFileSync(stampFile, JSON.stringify({ fingerprint }));
|
|
211
|
+
return { programName: plan.programName, outputFile: packaged.outputFile, size: packaged.size, compiled, reused };
|
|
212
|
+
}
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
// ------------------------------------------------------------------------
|
|
2
|
+
// 名称:source-collector.mjs
|
|
3
|
+
// 说明:收集目录下的源文件,以及判断源文件的语言。
|
|
4
|
+
// 作者:sungbin
|
|
5
|
+
// 邮箱:sungbin@3578.cn
|
|
6
|
+
// 日期:2026-11-10
|
|
7
|
+
// 备注:递归收集 .c、.s、.asm;跳过输出目录 build、node_modules 与以 . 开头的目录。
|
|
8
|
+
// ------------------------------------------------------------------------
|
|
9
|
+
import { readdirSync } from 'node:fs';
|
|
10
|
+
import path from 'node:path';
|
|
11
|
+
import { FcdevError } from '../shared/index.mjs';
|
|
12
|
+
|
|
13
|
+
/** 递归收集时跳过的目录名 */
|
|
14
|
+
const SKIPPED_DIRECTORIES = new Set(['build', 'node_modules']);
|
|
15
|
+
|
|
16
|
+
/**
|
|
17
|
+
* 判断源文件的语言。
|
|
18
|
+
* @param {string} file 文件路径
|
|
19
|
+
* @returns {'c'|'asm'|null} c、asm,或不是源文件时为 null
|
|
20
|
+
*/
|
|
21
|
+
export function getSourceLanguage(file) {
|
|
22
|
+
const extension = path.extname(file).toLowerCase();
|
|
23
|
+
if (extension === '.c') return 'c';
|
|
24
|
+
if (extension === '.s' || extension === '.asm') return 'asm';
|
|
25
|
+
return null;
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
/**
|
|
29
|
+
* 递归收集目录下的全部源文件。
|
|
30
|
+
* @param {string} dir 目录的绝对路径
|
|
31
|
+
* @param {string[]} [excludedDirs] 额外跳过的目录(绝对路径,如配置的输出目录)
|
|
32
|
+
* @returns {string[]} 源文件的绝对路径,按相对路径排序
|
|
33
|
+
* @throws {FcdevError} 目录下没有任何源文件
|
|
34
|
+
*/
|
|
35
|
+
export function collectSources(dir, excludedDirs = []) {
|
|
36
|
+
const excluded = new Set(excludedDirs.map((item) => path.resolve(item)));
|
|
37
|
+
const found = [];
|
|
38
|
+
const walk = (current) => {
|
|
39
|
+
for (const entry of readdirSync(current, { withFileTypes: true })) {
|
|
40
|
+
const full = path.join(current, entry.name);
|
|
41
|
+
if (entry.isDirectory()) {
|
|
42
|
+
if (!SKIPPED_DIRECTORIES.has(entry.name) && !entry.name.startsWith('.') && !excluded.has(full)) walk(full);
|
|
43
|
+
} else if (getSourceLanguage(entry.name)) {
|
|
44
|
+
found.push(full);
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
};
|
|
48
|
+
walk(dir);
|
|
49
|
+
found.sort((left, right) => path.relative(dir, left).localeCompare(path.relative(dir, right)));
|
|
50
|
+
if (found.length === 0) {
|
|
51
|
+
throw new FcdevError(`目录 ${dir} 下没有 .c、.s 或 .asm 源文件`, { code: 'NO_SOURCES' });
|
|
52
|
+
}
|
|
53
|
+
return found;
|
|
54
|
+
}
|
|
@@ -0,0 +1,83 @@
|
|
|
1
|
+
// ------------------------------------------------------------------------
|
|
2
|
+
// 名称:tool-arguments.mjs
|
|
3
|
+
// 说明:生成 cc65、ca65、ld65 的命令行参数:只拼参数,不运行,便于测试。
|
|
4
|
+
// 作者:sungbin
|
|
5
|
+
// 邮箱:sungbin@3578.cn
|
|
6
|
+
// 日期:2026-11-10
|
|
7
|
+
// 备注:一律带 -g 输出调试信息;依赖文件用 --create-dep 生成,供增量构建判断。
|
|
8
|
+
// ------------------------------------------------------------------------
|
|
9
|
+
|
|
10
|
+
/**
|
|
11
|
+
* 预定义宏转成 -D 参数。
|
|
12
|
+
* @param {Record<string, string|number>} defines 宏表
|
|
13
|
+
* @returns {string[]} 参数列表
|
|
14
|
+
*/
|
|
15
|
+
function defineArguments(defines) {
|
|
16
|
+
return Object.entries(defines).flatMap(([name, value]) => ['-D', `${name}=${value}`]);
|
|
17
|
+
}
|
|
18
|
+
|
|
19
|
+
/**
|
|
20
|
+
* @typedef {object} CompileSettings
|
|
21
|
+
* @property {string} cc65Target 目标名
|
|
22
|
+
* @property {string} cpu CPU 型号
|
|
23
|
+
* @property {boolean} optimize 是否优化
|
|
24
|
+
* @property {string[]} includeDirs C 头文件目录
|
|
25
|
+
* @property {string[]} asmIncludeDirs 汇编引入目录
|
|
26
|
+
* @property {Record<string, string|number>} defines 预定义宏
|
|
27
|
+
*/
|
|
28
|
+
|
|
29
|
+
/**
|
|
30
|
+
* cc65 编译一个 C 文件的参数。
|
|
31
|
+
* @param {CompileSettings} settings 编译设置
|
|
32
|
+
* @param {{source: string, output: string, dependencyFile: string}} files 源文件、输出的汇编文件与依赖文件
|
|
33
|
+
* @returns {string[]} 参数列表
|
|
34
|
+
*/
|
|
35
|
+
export function buildCompilerArguments(settings, files) {
|
|
36
|
+
return [
|
|
37
|
+
'-t', settings.cc65Target,
|
|
38
|
+
'--cpu', settings.cpu,
|
|
39
|
+
'-g',
|
|
40
|
+
...(settings.optimize ? ['-Oirs'] : []),
|
|
41
|
+
...settings.includeDirs.flatMap((dir) => ['-I', dir]),
|
|
42
|
+
...defineArguments(settings.defines),
|
|
43
|
+
'--create-dep', files.dependencyFile,
|
|
44
|
+
'-o', files.output,
|
|
45
|
+
files.source,
|
|
46
|
+
];
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
/**
|
|
50
|
+
* ca65 汇编一个文件的参数。
|
|
51
|
+
* @param {CompileSettings} settings 编译设置
|
|
52
|
+
* @param {{source: string, output: string, dependencyFile: string}} files 源文件、输出的目标文件与依赖文件
|
|
53
|
+
* @returns {string[]} 参数列表
|
|
54
|
+
*/
|
|
55
|
+
export function buildAssemblerArguments(settings, files) {
|
|
56
|
+
return [
|
|
57
|
+
'-t', settings.cc65Target,
|
|
58
|
+
'--cpu', settings.cpu,
|
|
59
|
+
'-g',
|
|
60
|
+
...settings.asmIncludeDirs.flatMap((dir) => ['-I', dir, '--bin-include-dir', dir]),
|
|
61
|
+
...defineArguments(settings.defines),
|
|
62
|
+
'--create-dep', files.dependencyFile,
|
|
63
|
+
'-o', files.output,
|
|
64
|
+
files.source,
|
|
65
|
+
];
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
/**
|
|
69
|
+
* ld65 链接的参数。
|
|
70
|
+
* @param {{linkConfig: string, binaryFile: string, mapFile: string, debugFile: string, objects: string[], libraries: string[], forceImports?: string[]}} input 链接配置、输出文件、目标文件、库与强制引入的符号
|
|
71
|
+
* @returns {string[]} 参数列表
|
|
72
|
+
*/
|
|
73
|
+
export function buildLinkerArguments(input) {
|
|
74
|
+
return [
|
|
75
|
+
'-C', input.linkConfig,
|
|
76
|
+
'-m', input.mapFile,
|
|
77
|
+
'--dbgfile', input.debugFile,
|
|
78
|
+
'-o', input.binaryFile,
|
|
79
|
+
...(input.forceImports ?? []).flatMap((symbol) => ['-u', symbol]),
|
|
80
|
+
...input.objects,
|
|
81
|
+
...input.libraries,
|
|
82
|
+
];
|
|
83
|
+
}
|
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
// ------------------------------------------------------------------------
|
|
2
|
+
// 名称:args-parser.mjs
|
|
3
|
+
// 说明:解析命令行参数:命令、位置参数与通用选项。
|
|
4
|
+
// 作者:sungbin
|
|
5
|
+
// 邮箱:sungbin@3578.cn
|
|
6
|
+
// 日期:2026-11-10
|
|
7
|
+
// 备注:debug 命令把命令名之后的全部参数原样交给调试服务,不再解析选项。
|
|
8
|
+
// ------------------------------------------------------------------------
|
|
9
|
+
import { FcdevError } from '../shared/index.mjs';
|
|
10
|
+
|
|
11
|
+
/** 不解析选项、参数原样传递的命令 */
|
|
12
|
+
const RAW_COMMANDS = new Set(['debug']);
|
|
13
|
+
|
|
14
|
+
/** 带一个字符串值的选项:选项名到 options 里的字段 */
|
|
15
|
+
const VALUE_OPTIONS = {
|
|
16
|
+
'--format': 'format',
|
|
17
|
+
'--base': 'base',
|
|
18
|
+
'--cdl': 'cdl',
|
|
19
|
+
'--trace': 'trace',
|
|
20
|
+
'--symbols': 'symbols',
|
|
21
|
+
'--out': 'out',
|
|
22
|
+
};
|
|
23
|
+
|
|
24
|
+
/**
|
|
25
|
+
* @typedef {object} ParsedArguments
|
|
26
|
+
* @property {string|null} command 命令名;没有给命令时为 null
|
|
27
|
+
* @property {string[]} positionals 位置参数
|
|
28
|
+
* @property {{target?: string, port?: number, debug: boolean, verbose: boolean, json: boolean, help: boolean, version: boolean, format?: string, base?: string, cdl?: string, trace?: string, symbols?: string, out?: string, entries: string[]}} options 选项
|
|
29
|
+
*/
|
|
30
|
+
|
|
31
|
+
/**
|
|
32
|
+
* 解析 process.argv 去掉前两项之后的参数。
|
|
33
|
+
* @param {string[]} argv 命令行参数
|
|
34
|
+
* @returns {ParsedArguments} 解析结果
|
|
35
|
+
* @throws {FcdevError} 出现未知选项,或选项缺少值
|
|
36
|
+
*/
|
|
37
|
+
export function parseArguments(argv) {
|
|
38
|
+
const options = { debug: false, verbose: false, json: false, help: false, version: false, entries: [] };
|
|
39
|
+
const positionals = [];
|
|
40
|
+
let command = null;
|
|
41
|
+
for (let index = 0; index < argv.length; index += 1) {
|
|
42
|
+
const token = argv[index];
|
|
43
|
+
if (command !== null && RAW_COMMANDS.has(command)) {
|
|
44
|
+
positionals.push(token);
|
|
45
|
+
} else if (token === '--help' || token === '-h') {
|
|
46
|
+
options.help = true;
|
|
47
|
+
} else if (token === '--version' || token === '-v') {
|
|
48
|
+
options.version = true;
|
|
49
|
+
} else if (token === '--verbose') {
|
|
50
|
+
options.verbose = true;
|
|
51
|
+
} else if (token === '--json') {
|
|
52
|
+
options.json = true;
|
|
53
|
+
} else if (token === '--debug') {
|
|
54
|
+
options.debug = true;
|
|
55
|
+
} else if (token === '--entry' || token.startsWith('--entry=')) {
|
|
56
|
+
const value = token === '--entry' ? argv[(index += 1)] : token.slice('--entry='.length);
|
|
57
|
+
if (!value) throw new FcdevError('--entry 缺少地址', { code: 'ARGUMENT_INVALID' });
|
|
58
|
+
options.entries.push(value);
|
|
59
|
+
} else if (VALUE_OPTIONS[token.split('=')[0]]) {
|
|
60
|
+
const name = token.split('=')[0];
|
|
61
|
+
const value = token.includes('=') ? token.slice(name.length + 1) : argv[(index += 1)];
|
|
62
|
+
if (!value) throw new FcdevError(`${name} 缺少值`, { code: 'ARGUMENT_INVALID' });
|
|
63
|
+
options[VALUE_OPTIONS[name]] = value;
|
|
64
|
+
} else if (token === '--port' || token.startsWith('--port=')) {
|
|
65
|
+
const value = token === '--port' ? argv[(index += 1)] : token.slice('--port='.length);
|
|
66
|
+
const port = Number(value);
|
|
67
|
+
if (!Number.isInteger(port) || port < 1 || port > 65535) {
|
|
68
|
+
throw new FcdevError(`--port 需要 1 到 65535 之间的整数,实际为“${value ?? ''}”`, { code: 'ARGUMENT_INVALID' });
|
|
69
|
+
}
|
|
70
|
+
options.port = port;
|
|
71
|
+
} else if (token === '--target' || token.startsWith('--target=')) {
|
|
72
|
+
const value = token === '--target' ? argv[(index += 1)] : token.slice('--target='.length);
|
|
73
|
+
if (!value) throw new FcdevError('--target 缺少目标名', { code: 'ARGUMENT_INVALID' });
|
|
74
|
+
options.target = value;
|
|
75
|
+
} else if (token.startsWith('-')) {
|
|
76
|
+
throw new FcdevError(`未知的选项:${token}`, { code: 'ARGUMENT_INVALID', hint: '用 fcdev --help 查看可用的选项' });
|
|
77
|
+
} else if (command === null) {
|
|
78
|
+
command = token;
|
|
79
|
+
} else {
|
|
80
|
+
positionals.push(token);
|
|
81
|
+
}
|
|
82
|
+
}
|
|
83
|
+
return { command, positionals, options };
|
|
84
|
+
}
|