@windsland52/maafw-live 0.0.0-stage → 0.4.0

package/lib/interface/hotkey.js

@@ -0,0 +1,142 @@
+/**
+ * hotkey 占位符 → 当前控制器的虚拟按键码（PI v2.8.0+）。
+ *
+ * 协议只给规则、不给表：`{名称}` / `{名称}.primary` / `{名称}.modifier1` / `{名称}.modifier2`
+ * 要替换成"**当前控制器 type** 支持的虚拟按键码"，且"映射规则应与 ClickKey、KeyDown 等动作所用
+ * 键码表一致"（MaaFW 5.14.2 `3.3-ProjectInterfaceV2协议`，pinned commit 8061d5bc）。
+ *
+ * 这里四张表的数值是各 OS **公开的键码常量**，不是谁发明的东西：
+ * - `Win32`  → Windows Virtual-Key Codes（`VK_*`，见 winuser.h）
+ * - `Adb`    → Android `KeyEvent`（`KEYCODE_*`）
+ * - `MacOS`  → Carbon `Events.h`（`kVK_*`，ANSI 键盘物理位置）
+ * - `WlRoots`/`Linux` → Linux `input-event-codes.h`（`KEY_*`/evdev）
+ *
+ * 取值与 MXU 的实现交叉核对过（MXU 是 AGPL-3.0，本仓 MIT：**只核数值，不搬代码**）。
+ * 键名按 MXU 的持久化约定规范化（大写、`+` 连接、末段为主键），因为它就是协议里"人类可读
+ * 快捷键字符串"的实际来源之一。
+ */
+const WIN32 = {
+    BACKSPACE: 0x08, TAB: 0x09, ENTER: 0x0d, SHIFT: 0x10, CTRL: 0x11, ALT: 0x12,
+    META: 0x5b, COMMAND: 0x5b, CMD: 0x5b, PAUSE: 0x13, CAPSLOCK: 0x14, ESC: 0x1b, SPACE: 0x20,
+    PAGEUP: 0x21, PAGEDOWN: 0x22, END: 0x23, HOME: 0x24,
+    LEFT: 0x25, UP: 0x26, RIGHT: 0x27, DOWN: 0x28, INSERT: 0x2d, DELETE: 0x2e,
+    '0': 0x30, '1': 0x31, '2': 0x32, '3': 0x33, '4': 0x34,
+    '5': 0x35, '6': 0x36, '7': 0x37, '8': 0x38, '9': 0x39,
+    A: 0x41, B: 0x42, C: 0x43, D: 0x44, E: 0x45, F: 0x46, G: 0x47, H: 0x48, I: 0x49,
+    J: 0x4a, K: 0x4b, L: 0x4c, M: 0x4d, N: 0x4e, O: 0x4f, P: 0x50, Q: 0x51, R: 0x52,
+    S: 0x53, T: 0x54, U: 0x55, V: 0x56, W: 0x57, X: 0x58, Y: 0x59, Z: 0x5a,
+    F1: 0x70, F2: 0x71, F3: 0x72, F4: 0x73, F5: 0x74, F6: 0x75,
+    F7: 0x76, F8: 0x77, F9: 0x78, F10: 0x79, F11: 0x7a, F12: 0x7b,
+};
+const MACOS = {
+    BACKSPACE: 0x33, TAB: 0x30, ENTER: 0x24, SHIFT: 0x38, CTRL: 0x3b, ALT: 0x3a,
+    META: 0x37, COMMAND: 0x37, CMD: 0x37, CAPSLOCK: 0x39, ESC: 0x35, SPACE: 0x31,
+    PAGEUP: 0x74, PAGEDOWN: 0x79, END: 0x77, HOME: 0x73,
+    LEFT: 0x7b, UP: 0x7e, RIGHT: 0x7c, DOWN: 0x7d, DELETE: 0x75,
+    '0': 0x1d, '1': 0x12, '2': 0x13, '3': 0x14, '4': 0x15,
+    '5': 0x17, '6': 0x16, '7': 0x1a, '8': 0x1c, '9': 0x19,
+    A: 0x00, B: 0x0b, C: 0x08, D: 0x02, E: 0x0e, F: 0x03, G: 0x05, H: 0x04, I: 0x22,
+    J: 0x26, K: 0x28, L: 0x25, M: 0x2e, N: 0x2d, O: 0x1f, P: 0x23, Q: 0x0c, R: 0x0f,
+    S: 0x01, T: 0x11, U: 0x20, V: 0x09, W: 0x0d, X: 0x07, Y: 0x10, Z: 0x06,
+    F1: 0x7a, F2: 0x78, F3: 0x63, F4: 0x76, F5: 0x60, F6: 0x61,
+    F7: 0x62, F8: 0x64, F9: 0x65, F10: 0x6d, F11: 0x67, F12: 0x6f,
+};
+const ADB = {
+    BACKSPACE: 67, TAB: 61, ENTER: 66, SHIFT: 59, CTRL: 113, ALT: 57,
+    META: 117, COMMAND: 117, CMD: 117, SPACE: 62, ESC: 111, DELETE: 112,
+    HOME: 3, END: 123, PAGEUP: 92, PAGEDOWN: 93,
+    LEFT: 21, RIGHT: 22, UP: 19, DOWN: 20,
+    '0': 7, '1': 8, '2': 9, '3': 10, '4': 11, '5': 12, '6': 13, '7': 14, '8': 15, '9': 16,
+    A: 29, B: 30, C: 31, D: 32, E: 33, F: 34, G: 35, H: 36, I: 37, J: 38, K: 39, L: 40,
+    M: 41, N: 42, O: 43, P: 44, Q: 45, R: 46, S: 47, T: 48, U: 49, V: 50, W: 51, X: 52,
+    Y: 53, Z: 54,
+    F1: 131, F2: 132, F3: 133, F4: 134, F5: 135, F6: 136, F7: 137, F8: 138, F9: 139,
+    F10: 140, F11: 141, F12: 142,
+};
+const WLROOTS = {
+    BACKSPACE: 14, TAB: 15, ENTER: 28, SHIFT: 42, CTRL: 29, ALT: 56,
+    META: 125, COMMAND: 125, CMD: 125, SPACE: 57, ESC: 1, DELETE: 111,
+    HOME: 102, END: 107, PAGEUP: 104, PAGEDOWN: 109,
+    LEFT: 105, RIGHT: 106, UP: 103, DOWN: 108,
+    '0': 11, '1': 2, '2': 3, '3': 4, '4': 5, '5': 6, '6': 7, '7': 8, '8': 9, '9': 10,
+    A: 30, B: 48, C: 46, D: 32, E: 18, F: 33, G: 34, H: 35, I: 23, J: 36, K: 37, L: 38,
+    M: 50, N: 49, O: 24, P: 25, Q: 16, R: 19, S: 31, T: 20, U: 22, V: 47, W: 17, X: 45,
+    Y: 21, Z: 44,
+    F1: 59, F2: 60, F3: 61, F4: 62, F5: 63, F6: 64, F7: 65, F8: 66, F9: 67, F10: 68,
+    F11: 87, F12: 88,
+};
+/** 同义键名归一：用户手写的组合键五花八门，认得出就认，认不出会在下面报"未知按键"。 */
+const ALIASES = {
+    CONTROL: 'CTRL', ESCAPE: 'ESC', RETURN: 'ENTER', DEL: 'DELETE', INS: 'INSERT',
+    PGUP: 'PAGEUP', PGDN: 'PAGEDOWN', WIN: 'META', WINDOWS: 'META', SUPER: 'META',
+    SPACEBAR: 'SPACE', CAPS: 'CAPSLOCK', OPTION: 'ALT',
+};
+/** 按控制器 **type** 取表（不是 name）。没有表的类型返回 null——调用方要告警，不能退回 Win32 猜。 */
+export function hotkeyTableFor(controllerType, useWin32VkCode = false) {
+    switch (controllerType) {
+        case 'Win32':
+            return WIN32;
+        case 'Adb':
+            return ADB;
+        case 'MacOS':
+            return MACOS;
+        case 'WlRoots':
+            return WLROOTS;
+        /* Linux 控制器可声明 `linux.use_win32_vk_code`：true 时服务端按 Win32 VK 解释，false 用 evdev */
+        case 'Linux':
+            return useWin32VkCode ? WIN32 : WLROOTS;
+        default:
+            return null;
+    }
+}
+function normalizeKey(name) {
+    const up = name.trim().toUpperCase();
+    return ALIASES[up] ?? up;
+}
+/** "Ctrl+Shift+A" → { primary: "A", modifiers: ["Ctrl","Shift"] }；末段为主键。 */
+export function splitHotkeyCombo(value) {
+    const parts = value.split('+').map((p) => p.trim()).filter(Boolean);
+    if (!parts.length)
+        return { primary: '', modifiers: [] };
+    return { primary: parts[parts.length - 1], modifiers: parts.slice(0, -1) };
+}
+/**
+ * 把一个 hotkey 字段解析成四种占位符的取值。
+ *
+ * 缺修饰键不是错（单键 "E" 本来就没有修饰键），补 0 = 无按键；**主键查不到是错**——
+ * 写个 0 进去等于"按了空键"，任务会静默点不动。
+ */
+export function resolveHotkeyTokens(fieldName, raw, table) {
+    const { primary, modifiers } = splitHotkeyCombo(raw);
+    if (!primary)
+        return { tokens: {}, error: '取值为空' };
+    const code = table[normalizeKey(primary)];
+    if (code === undefined) {
+        return { tokens: {}, error: '主键 ' + primary + ' 不在该控制器的键码表里（' + raw + '）' };
+    }
+    const mod = (name) => {
+        if (!name)
+            return 0;
+        const c = table[normalizeKey(name)];
+        /* 修饰键查不到也按"无"处理会让组合键变成单键——那是静默错，直接报错 */
+        if (c === undefined)
+            throw new Error('修饰键 ' + name + ' 不在该控制器的键码表里（' + raw + '）');
+        return c;
+    };
+    try {
+        const m1 = mod(modifiers[0]);
+        const m2 = mod(modifiers[1]);
+        return {
+            tokens: {
+                [fieldName]: code,
+                [fieldName + '.primary']: code,
+                [fieldName + '.modifier1']: m1,
+                [fieldName + '.modifier2']: m2,
+            },
+        };
+    }
+    catch (e) {
+        return { tokens: {}, error: String(e.message || e) };
+    }
+}
+//# sourceMappingURL=hotkey.js.map

package/lib/interface/index.js

@@ -0,0 +1,12 @@
+/**
+ * 项目声明（interface.json / ProjectInterface v2）的窄解析与连接规划。
+ *
+ * 这是"认识项目"的唯一一份实现：控制器声明 → daemon connect 参数、
+ * 资源声明 → resource 目录、task 声明 → run 入口解析、
+ * option/preset → pipeline_override 四级合并链。
+ */
+export { parseJsonc } from './jsonc.js';
+export { loadInterface, findInterfaceFile, } from './load.js';
+export { planController, resolveResourcePaths, } from './plan.js';
+export { computePipelineOverride, appendOverride } from './override.js';
+//# sourceMappingURL=index.js.map

package/lib/interface/jsonc.js

@@ -0,0 +1,95 @@
+/**
+ * 容错 JSON：真实项目的 interface.json 带 `//` 注释（官方解析器基于 meojson），
+ * strict JSON.parse 会直接拒绝，因此先做最小脱敏——字符串外的注释与尾随逗号去掉。
+ *
+ * 取舍：只做这两件**最小**的事，不做单引号 / 无引号键 / 多行字符串那类扩展——
+ * 越是"看起来像 JSON"的输入，越容易被静默改写成作者没写的意思。
+ * 另：开头的 BOM（Windows 记事本等会写）先剥掉，它会让 JSON.parse 报 "Unexpected token"。
+ */
+export function parseJsonc(text) {
+    const noBom = text.charCodeAt(0) === 0xFEFF ? text.slice(1) : text;
+    return JSON.parse(stripTrailingCommas(stripComments(noBom)));
+}
+function stripComments(s) {
+    let out = '';
+    let i = 0;
+    let inStr = false;
+    while (i < s.length) {
+        const ch = s[i];
+        if (inStr) {
+            out += ch;
+            if (ch === '\\' && i + 1 < s.length) {
+                out += s[i + 1];
+                i += 2;
+                continue;
+            }
+            if (ch === '"')
+                inStr = false;
+            i++;
+            continue;
+        }
+        if (ch === '"') {
+            inStr = true;
+            out += ch;
+            i++;
+            continue;
+        }
+        if (ch === '/' && s[i + 1] === '/') {
+            while (i < s.length && s[i] !== '\n')
+                i++;
+            continue;
+        }
+        if (ch === '/' && s[i + 1] === '*') {
+            i += 2;
+            while (i < s.length && !(s[i] === '*' && s[i + 1] === '/'))
+                i++;
+            i += 2;
+            continue;
+        }
+        out += ch;
+        i++;
+    }
+    return out;
+}
+function stripTrailingCommas(s) {
+    let out = '';
+    let i = 0;
+    let inStr = false;
+    while (i < s.length) {
+        const ch = s[i];
+        if (inStr) {
+            out += ch;
+            if (ch === '\\' && i + 1 < s.length) {
+                out += s[i + 1];
+                i += 2;
+                continue;
+            }
+            if (ch === '"')
+                inStr = false;
+            i++;
+            continue;
+        }
+        if (ch === '"') {
+            inStr = true;
+            out += ch;
+            i++;
+            continue;
+        }
+        if (ch === ',') {
+            let j = i + 1;
+            while (j < s.length && isSpace(s[j]))
+                j++;
+            if (s[j] === '}' || s[j] === ']') {
+                i++;
+                continue;
+            }
+        }
+        out += ch;
+        i++;
+    }
+    return out;
+}
+function isSpace(c) {
+    return c === ' ' || c === '\t' || c === '\n' || c === '\r';
+}
+//# sourceMappingURL=jsonc.js.map

package/lib/interface/load.js

@@ -0,0 +1,397 @@
+/**
+ * 载入项目 interface.json（ProjectInterface v2）。
+ *
+ * 解析面就是本工具真正消费的那部分：控制器（连接规划）、资源（路径解析）、任务入口
+ * （run --project）、option / preset / global_option（pipeline_override 四级链）、
+ * agent 与 pretask（子进程相关）、import（v2.2.0 合并规则）。
+ *
+ * 明确**不**解析、不消费的：task 级 pipeline_override（本工具只合成 option 链，任务级写死的
+ * 覆盖要由 Client 应用）、i18n（languages 与 `$` 键——当前不输出人类标签）、group / setting /
+ * telemetry、resource.hash（v2.6.0 的一致性校验，未实现）。
+ * 全过程不抛异常：问题进 problems[]，由调用方决定怎么呈现。
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { parseJsonc } from './jsonc.js';
+/** 找 interface.json：项目根优先，其次 assets/（部分项目把声明放资源目录下）。 */
+const REL_CANDIDATES = ['interface.json', 'assets/interface.json'];
+export function findInterfaceFile(dir) {
+    const base = resolve(dir);
+    for (const rel of REL_CANDIDATES) {
+        const p = join(base, rel);
+        if (existsSync(p))
+            return p;
+    }
+    return null;
+}
+function str(v) {
+    return typeof v === 'string' && v.trim() ? v : undefined;
+}
+function num(v) {
+    return typeof v === 'number' && Number.isFinite(v) ? v : undefined;
+}
+function strList(v) {
+    if (typeof v === 'string')
+        return [v];
+    if (Array.isArray(v))
+        return v.filter((x) => typeof x === 'string' && x.length > 0);
+    return [];
+}
+function obj(v) {
+    return v && typeof v === 'object' && !Array.isArray(v) ? v : null;
+}
+export function loadInterface(dir) {
+    const file = findInterfaceFile(dir);
+    const base = {
+        file,
+        dir: file ? dirname(file) : null,
+        version: null,
+        projectVersion: null,
+        name: null,
+        controllers: [],
+        resources: [],
+        tasks: [],
+        options: {},
+        presets: [],
+        globalOption: [],
+        pretask: [],
+        agents: [],
+        problems: [],
+    };
+    if (!file) {
+        return { ...base, problems: [{ message: '未找到 interface.json（找过 ' + REL_CANDIDATES.join(' / ') + '）' }] };
+    }
+    let raw;
+    try {
+        raw = parseJsonc(readFileSync(file, 'utf8'));
+    }
+    catch (e) {
+        return { ...base, problems: [{ message: 'interface.json 解析失败：' + String(e.message) }] };
+    }
+    const o = obj(raw);
+    if (!o)
+        return { ...base, problems: [{ message: 'interface.json 顶层必须是对象' }] };
+    const problems = [];
+    const version = num(o.interface_version);
+    if (version === undefined)
+        problems.push({ message: '缺少 interface_version（ProjectInterface v2 应为 2）' });
+    else if (version !== 2)
+        problems.push({ message: 'interface_version=' + version + '；本工具按 v2 解析，可能有出入' });
+    const controllers = [];
+    for (const item of Array.isArray(o.controller) ? o.controller : []) {
+        const c = obj(item);
+        const name = c ? str(c.name) : undefined;
+        const type = c ? str(c.type) : undefined;
+        if (!c || !name || !type) {
+            problems.push({ message: 'controller 项缺少 name 或 type，已跳过' });
+            continue;
+        }
+        const display = {};
+        const ss = num(c.display_short_side);
+        if (ss !== undefined)
+            display.shortSide = ss;
+        const ls = num(c.display_long_side);
+        if (ls !== undefined)
+            display.longSide = ls;
+        if (c.display_raw === true)
+            display.raw = true;
+        if (Array.isArray(c.display_expand) && c.display_expand.length === 2) {
+            const a = num(c.display_expand[0]);
+            const b = num(c.display_expand[1]);
+            if (a !== undefined && b !== undefined)
+                display.expand = [a, b];
+        }
+        const w = obj(c.win32);
+        const g = obj(c.gamepad);
+        const mo = obj(c.macos);
+        const linuxDecl = obj(c.linux);
+        controllers.push({
+            name,
+            type,
+            raw: c,
+            display: Object.keys(display).length ? display : undefined,
+            macos: mo
+                ? {
+                    titleRegex: str(mo.title_regex),
+                    screencap: str(mo.screencap),
+                    input: str(mo.input),
+                }
+                : undefined,
+            win32: w
+                ? {
+                    classRegex: str(w.class_regex),
+                    windowRegex: str(w.window_regex),
+                    screencap: str(w.screencap),
+                    mouse: str(w.mouse),
+                    keyboard: str(w.keyboard),
+                }
+                : undefined,
+            gamepad: g
+                ? {
+                    classRegex: str(g.class_regex),
+                    windowRegex: str(g.window_regex),
+                    gamepadType: str(g.gamepad_type),
+                    screencap: str(g.screencap),
+                }
+                : undefined,
+            attachResourcePath: strList(c.attach_resource_path),
+            option: strList(c.option),
+            ...(linuxDecl
+                ? {
+                    linux: {
+                        ...(linuxDecl.use_win32_vk_code === true ? { useWin32VkCode: true } : {}),
+                        ...(str(linuxDecl.screencap) ? { screencap: str(linuxDecl.screencap) } : {}),
+                        ...(str(linuxDecl.input) ? { input: str(linuxDecl.input) } : {}),
+                        ...(str(linuxDecl.pipewire_source) ? { pipewireSource: str(linuxDecl.pipewire_source) } : {}),
+                    },
+                }
+                : {}),
+            ...(c.permission_required === true ? { permissionRequired: true } : {}),
+        });
+    }
+    if (!controllers.length)
+        problems.push({ message: 'controller[] 为空：项目没有声明任何控制器' });
+    const resources = [];
+    for (const item of Array.isArray(o.resource) ? o.resource : []) {
+        const r = obj(item);
+        const name = r ? str(r.name) : undefined;
+        const paths = r ? strList(r.path) : [];
+        if (!r || !name || !paths.length) {
+            problems.push({ message: 'resource 项缺少 name 或 path，已跳过' });
+            continue;
+        }
+        resources.push({
+            name, paths, controllers: strList(r.controller), option: strList(r.option),
+            ...(r.hash !== undefined ? { hash: str(r.hash) } : {}), raw: r,
+        });
+    }
+    const tasks = [];
+    const options = {};
+    const presets = [];
+    const globalOption = [];
+    const pretask = [];
+    const agents = [];
+    const readAgents = (list) => {
+        for (const item of Array.isArray(list) ? list : (list !== undefined ? [list] : [])) {
+            const a = obj(item);
+            const exec = a ? str(a.child_exec) : undefined;
+            if (!a || !exec)
+                continue;
+            agents.push({ exec, args: strList(a.child_args), ...(str(a.identifier) !== undefined ? { identifier: str(a.identifier) } : {}) });
+        }
+    };
+    const readTasks = (list, src) => {
+        for (const item of Array.isArray(list) ? list : []) {
+            const t = obj(item);
+            const name = t ? str(t.name) : undefined;
+            if (!t || !name) {
+                problems.push({ message: 'task 项缺少 name，已跳过（' + src + '）' });
+                continue;
+            }
+            const po = obj(t.pipeline_override);
+            tasks.push({
+                name,
+                entry: str(t.entry),
+                controller: strList(t.controller),
+                resource: strList(t.resource),
+                option: strList(t.option),
+                ...(po ? { pipelineOverride: po } : {}),
+            });
+        }
+    };
+    const readOptions = (dict, src) => {
+        const d = obj(dict);
+        if (!d) {
+            if (dict !== undefined)
+                problems.push({ message: 'option 应为对象（键=配置项名），已忽略（' + src + '）' });
+            return;
+        }
+        for (const [key, val] of Object.entries(d)) {
+            const v = obj(val);
+            /* type 缺省按 select（上游 PI 文档与 Types.h:212 的默认）；仍记 problem，
+             * 因为它大概率是漏写而非有意缺省——警告可见，行为对齐上游。 */
+            const type = v ? (str(v.type) ?? 'select') : undefined;
+            if (!v || !type) {
+                problems.push({ message: 'option ' + key + ' 缺少 type，已跳过（' + src + '）' });
+                continue;
+            }
+            const cases = [];
+            for (const cs of Array.isArray(v.cases) ? v.cases : []) {
+                const c2 = obj(cs);
+                const cname = c2 ? str(c2.name) : undefined;
+                if (!c2 || !cname)
+                    continue;
+                const po = obj(c2.pipeline_override);
+                cases.push({
+                    name: cname,
+                    ...(po ? { pipelineOverride: po } : {}),
+                    option: strList(c2.option),
+                });
+            }
+            const tpl = obj(v.pipeline_override);
+            const inputs = [];
+            for (const it of Array.isArray(v.inputs) ? v.inputs : []) {
+                const f = obj(it);
+                const fname = f ? str(f.name) : undefined;
+                if (!f || !fname)
+                    continue;
+                const pwd = f.password === true;
+                inputs.push({
+                    name: fname,
+                    ...(str(f.default) !== undefined && !pwd ? { default: str(f.default) } : {}),
+                    ...(str(f.pipeline_type) !== undefined ? { pipelineType: str(f.pipeline_type) } : {}),
+                    ...(str(f.verify) !== undefined ? { verify: str(f.verify) } : {}),
+                    ...(pwd ? { password: true } : {}),
+                });
+                if (pwd && str(f.default) !== undefined) {
+                    problems.push({ message: 'option ' + key + ' 的输入字段 ' + fname + '：password=true 时规范禁止同时设 default，default 已忽略' });
+                }
+            }
+            const hotkeys = [];
+            for (const it of Array.isArray(v.hotkeys) ? v.hotkeys : []) {
+                const f = obj(it);
+                const fname = f ? str(f.name) : undefined;
+                if (!f || !fname)
+                    continue;
+                hotkeys.push({ name: fname, ...(str(f.default) !== undefined ? { default: str(f.default) } : {}) });
+            }
+            const minC = num(v.min_count);
+            const maxC = num(v.max_count);
+            if (type === 'checkbox') {
+                if (minC !== undefined && maxC !== undefined && minC > maxC) {
+                    problems.push({ message: 'option ' + key + '：min_count=' + minC + ' > max_count=' + maxC + '，约束自相矛盾' });
+                }
+                if (minC !== undefined && cases.length && minC > cases.length) {
+                    problems.push({ message: 'option ' + key + '：min_count=' + minC + ' 超过声明的 case 数 ' + cases.length + '，永远选不够' });
+                }
+            }
+            options[key] = {
+                name: key,
+                type,
+                cases,
+                ...(tpl ? { pipelineOverride: tpl } : {}),
+                ...(inputs.length ? { inputs } : {}),
+                ...(hotkeys.length ? { hotkeys } : {}),
+                ...(v.default_case !== undefined ? { defaultCase: v.default_case } : {}),
+                controller: strList(v.controller),
+                resource: strList(v.resource),
+                ...(type === 'checkbox' && minC !== undefined ? { minCount: minC } : {}),
+                ...(type === 'checkbox' && maxC !== undefined ? { maxCount: maxC } : {}),
+            };
+        }
+    };
+    const readPresets = (list) => {
+        for (const item of Array.isArray(list) ? list : []) {
+            const p = obj(item);
+            const name = p ? str(p.name) : undefined;
+            if (!p || !name)
+                continue;
+            const tlist = [];
+            for (const tp of Array.isArray(p.task) ? p.task : []) {
+                const t2 = obj(tp);
+                const tname = t2 ? str(t2.name) : undefined;
+                if (!t2 || !tname)
+                    continue;
+                const pv = obj(t2.option);
+                tlist.push({ name: tname, enabled: t2.enabled !== false, ...(pv ? { option: pv } : {}) });
+            }
+            presets.push({ name, task: tlist });
+        }
+    };
+    readTasks(o.task, '主文件');
+    readOptions(o.option, '主文件');
+    readPresets(o.preset);
+    readAgents(o.agent);
+    for (const g of strList(o.global_option))
+        if (!globalOption.includes(g))
+            globalOption.push(g);
+    /* pretask：`exec` 必填；`args` / `option` / 过滤列表缺省为空。单条也可写成对象而不是数组。 */
+    const readPretasks = (list, src) => {
+        for (const pt of Array.isArray(list) ? list : (list !== undefined ? [list] : [])) {
+            const p2 = obj(pt);
+            const exec = p2 ? str(p2.exec) : undefined;
+            if (!p2)
+                continue;
+            if (!exec) {
+                problems.push({ message: 'pretask 缺少 exec，已跳过（' + src + '）' });
+                continue;
+            }
+            pretask.push({
+                ...(str(p2.name) !== undefined ? { name: str(p2.name) } : {}),
+                exec,
+                args: strList(p2.args),
+                option: strList(p2.option),
+                ...(strList(p2.controller).length ? { controller: strList(p2.controller) } : {}),
+                ...(strList(p2.resource).length ? { resource: strList(p2.resource) } : {}),
+            });
+        }
+    };
+    readPretasks(o.pretask, '主文件');
+    /* import 合并（v2.2.0）：只合 task/option/preset/global_option/pretask（及 group/setting，本工具不消费）。
+     * controller/resource 不可导入——子文件声明了也忽略并记 problems。循环导入用 visited 集合挡住。
+     *
+     * 上游口径（MaaFW 5.14.2 @ 8061d5b，逐条核过）：
+     *  - 被 import 的文件由 tools/interface_import.schema.json 约束（描述原文："用于 interface.json 的
+     *    import 字段引用的文件"），顶层只有 task/option/pretask/global_option/setting/preset，且
+     *    `additionalProperties: false` → **`import` 不可嵌套**、`agent` 也不在其中；
+     *  - 协议文档 3.3 的 import 节把 `group` 列进可导入字段（v2.4.0，合并表里也有 group 行），
+     *    而 5.14.2 的 import schema 顶层**没有 group** → 文档与 schema 不一致（上游漂移）。
+     *    **后续：上游已就这条提 PR，结论是"改 schema"**（即 import 文件将来可以合法带 group）。
+     *    我们的行为不变——group 本工具不消费，因此既不合并也不报错；真要用到 UI 分组时再说。
+     *  - `agent` 不在 import schema 里，但本工具**宽容读取**（下面的 readAgents）：这是超出协议的扩展，
+     *    只影响"文件结构校验收紧的工具"与我们的行为差异，实现上进 candidates 前仍会如实报 problems。 */
+    const seen = new Set([file]);
+    const imports = strList(o.import);
+    for (const rel of imports) {
+        const childFile = join(dirname(file), rel);
+        if (seen.has(childFile)) {
+            problems.push({ message: 'import 循环引用，已跳过：' + rel });
+            continue;
+        }
+        seen.add(childFile);
+        let child = null;
+        try {
+            child = obj(parseJsonc(readFileSync(childFile, 'utf8')));
+        }
+        catch (e) {
+            problems.push({ message: 'import 文件读取/解析失败：' + rel + '（' + String(e.message) + '）' });
+            continue;
+        }
+        if (!child)
+            continue;
+        if (child.controller !== undefined || child.resource !== undefined) {
+            problems.push({ message: 'import 文件 ' + rel + ' 声明了 controller/resource：协议不可导入，已忽略' });
+        }
+        /* import 不可嵌套：被引用的文件由 interface_import.schema.json 约束（MaaFW 5.14.2，
+         * 顶层只有 task/option/pretask/global_option/setting/preset 且 additionalProperties: false，
+         * 文档 3.3 的 import 节也没有嵌套写法）。静默吞掉会让"二级文件"整份消失得无影无踪，
+         * 所以这里记一条 problem——它通常意味着拆分方式需要改成平铺。 */
+        if (child.import !== undefined) {
+            problems.push({ message: 'import 文件 ' + rel + ' 里还有 import：import 不可嵌套（该文件的 schema 顶层没有 import 字段），其引用的文件已忽略' });
+        }
+        readTasks(child.task, rel);
+        readOptions(child.option, rel);
+        readPresets(child.preset);
+        readAgents(child.agent);
+        for (const g of strList(child.global_option))
+            if (!globalOption.includes(g))
+                globalOption.push(g);
+        readPretasks(child.pretask, rel);
+    }
+    return {
+        ...base,
+        version: version ?? null,
+        projectVersion: str(o.version) ?? null,
+        name: str(o.name) ?? null,
+        controllers,
+        resources,
+        tasks,
+        options,
+        presets,
+        globalOption,
+        pretask,
+        agents,
+        problems,
+    };
+}
+//# sourceMappingURL=load.js.map