autosnippet 3.2.16 → 3.2.17

package/dist/lib/platform/ios/spm/SpmHelper.d.ts

@@ -22,15 +22,13 @@ export declare class SpmHelper {
     load(): Promise<any>;
     /**
      * BFS 检查包级可达性（V1 _canReachPackage 等价）
-     * @param {string} fromPkgPath 起始包的 Package.swift 路径
-     * @param {string} toPkgPath 目标包的 Package.swift 路径
-     * @returns {boolean}
+     * @param fromPkgPath 起始包的 Package.swift 路径
+     * @param toPkgPath 目标包的 Package.swift 路径
      */
     _canReachPackage(fromPkgPath: string, toPkgPath: string): boolean;
     /**
      * 获取 target 所属包信息（V1 spmmap 等价）
-     * @param {string} targetName
-     * @returns {{ packageName: string, packagePath: string } | null}
+     * @returns | null}
      */
     getPackageForTarget(targetName: string): any;
     /**
@@ -39,15 +37,14 @@ export declare class SpmHelper {
      * - off:     不检查、不提示
      * - suggest: 仅提示（直接插入、提示操作插入按钮，无自动修复）
      * - fix:     完整4按钮（直接插入、提示操作插入、自动修复依赖、取消操作）
-     * @returns {'off'|'suggest'|'fix'}
      */
     getFixMode(): "suggest" | "off" | "fix";
     /**
      * 确保依赖存在: 如果不存在则评估是否可以添加
      * 支持跨包循环检测：如果 from 和 to 在不同包内，额外检查包级依赖图
-     * @param {string} from 源 target
-     * @param {string} to 目标 target
-     * @returns {{ exists: boolean, canAdd: boolean, reason?: string, crossPackage?: boolean }}
+     * @param from 源 target
+     * @param to 目标 target
+     * @returns }
      */
     ensureDependency(from: string, to: string): {
         exists: boolean;
@@ -76,9 +73,9 @@ export declare class SpmHelper {
      * 同包 target → 添加 "TargetName" 到 dependencies
      * 跨包 target → 添加 .product(name: "X", package: "Y") + 确保 .package(path: "...") 声明
      *
-     * @param {string} from 源 target
-     * @param {string} to 目标 target
-     * @returns {{ ok: boolean, changed: boolean, file?: string, error?: string, crossPackage?: boolean }}
+     * @param from 源 target
+     * @param to 目标 target
+     * @returns }
      */
     addDependency(from: string, to: string): {
         ok: boolean;
@@ -98,9 +95,8 @@ export declare class SpmHelper {
      *
      * 从文件到 Package.swift 所在目录的相对路径中，反向匹配已知 target 名。
      * 如果文件不在任何 SPM target 的源码目录中（如 Xcode 主 App target），返回 null。
-     * @param {string} filePath 源文件绝对路径
-     * @returns {string|null} target 名称，未匹配返回 null
+     * @param filePath 源文件绝对路径
+     * @returns target 名称，未匹配返回 null
      */
     resolveCurrentTarget(filePath: string): string | null;
 }
-//# sourceMappingURL=SpmHelper.d.ts.map

package/dist/lib/platform/ios/spm/SpmHelper.js

@@ -17,15 +17,9 @@ export class SpmHelper {
     #policy;
     #logger;
     #projectRoot;
-    /**
-     * target → { packageName, packagePath } 映射（V1 spmmap 等价）
-     * @type {Map<string, {packageName: string, packagePath: string}>}
-     */
+    /** target → { packageName, packagePath } 映射（V1 spmmap 等价） */
     #targetPackageMap;
-    /**
-     * 包级依赖图：packagePath → Set<packagePath>（用于跨包循环检测）
-     * @type {Map<string, Set<string>>}
-     */
+    /** 包级依赖图：packagePath → Set<packagePath>（用于跨包循环检测） */
     #packageDepGraph;
     /** @type {GraphCache} 磁盘缓存层 */
     #graphCache;
@@ -108,8 +102,7 @@ export class SpmHelper {
     }
     /**
      * 多包加载（从 load() 拆出）
-     * @param {string[]} allPaths Package.swift 路径数组
-     * @returns {object|null}
+     * @param allPaths Package.swift 路径数组
      */
     #loadMultiPackage(allPaths) {
         this.#logger.info(`[SpmHelper] 发现 ${allPaths.length} 个 Package.swift，逐一解析...`);
@@ -151,9 +144,7 @@ export class SpmHelper {
             path: this.#projectRoot,
         };
     }
-    /**
-     * 将当前内存状态序列化到缓存
-     */
+    /** 将当前内存状态序列化到缓存 */
     #saveToCache(contentHash, parsedResult) {
         const graphJSON = this.#graph.toJSON();
         const targetPackageEntries = [...this.#targetPackageMap.entries()];
@@ -166,9 +157,7 @@ export class SpmHelper {
             packageDepGraph: packageDepEntries,
         }, { contentHash });
     }
-    /**
-     * 从缓存数据恢复内存状态
-     */
+    /** 从缓存数据恢复内存状态 */
     #restoreFromCache(data) {
         // 恢复 DependencyGraph
         this.#graph.clear();
@@ -227,9 +216,8 @@ export class SpmHelper {
     }
     /**
      * BFS 检查包级可达性（V1 _canReachPackage 等价）
-     * @param {string} fromPkgPath 起始包的 Package.swift 路径
-     * @param {string} toPkgPath 目标包的 Package.swift 路径
-     * @returns {boolean}
+     * @param fromPkgPath 起始包的 Package.swift 路径
+     * @param toPkgPath 目标包的 Package.swift 路径
      */
     _canReachPackage(fromPkgPath, toPkgPath) {
         if (fromPkgPath === toPkgPath) {
@@ -258,8 +246,7 @@ export class SpmHelper {
     // ─────────────── 公共查询 API ───────────────
     /**
      * 获取 target 所属包信息（V1 spmmap 等价）
-     * @param {string} targetName
-     * @returns {{ packageName: string, packagePath: string } | null}
+     * @returns | null}
      */
     getPackageForTarget(targetName) {
         return this.#targetPackageMap.get(targetName) || null;
@@ -270,7 +257,6 @@ export class SpmHelper {
      * - off:     不检查、不提示
      * - suggest: 仅提示（直接插入、提示操作插入按钮，无自动修复）
      * - fix:     完整4按钮（直接插入、提示操作插入、自动修复依赖、取消操作）
-     * @returns {'off'|'suggest'|'fix'}
      */
     getFixMode() {
         const env = (process.env.ASD_FIX_SPM_DEPS_MODE || '').toLowerCase().trim();
@@ -282,9 +268,9 @@ export class SpmHelper {
     /**
      * 确保依赖存在: 如果不存在则评估是否可以添加
      * 支持跨包循环检测：如果 from 和 to 在不同包内，额外检查包级依赖图
-     * @param {string} from 源 target
-     * @param {string} to 目标 target
-     * @returns {{ exists: boolean, canAdd: boolean, reason?: string, crossPackage?: boolean }}
+     * @param from 源 target
+     * @param to 目标 target
+     * @returns }
      */
     ensureDependency(from, to) {
         if (this.#graph.isReachable(from, to)) {
@@ -322,9 +308,9 @@ export class SpmHelper {
      * 同包 target → 添加 "TargetName" 到 dependencies
      * 跨包 target → 添加 .product(name: "X", package: "Y") + 确保 .package(path: "...") 声明
      *
-     * @param {string} from 源 target
-     * @param {string} to 目标 target
-     * @returns {{ ok: boolean, changed: boolean, file?: string, error?: string, crossPackage?: boolean }}
+     * @param from 源 target
+     * @param to 目标 target
+     * @returns }
      */
     addDependency(from, to) {
         // 安全检查
@@ -404,10 +390,10 @@ export class SpmHelper {
     }
     /**
      * 确保 Package.swift 中有对目标包的 .package(path: "...") 声明
-     * @param {string} content - Package.swift 内容
-     * @param {string} fromPkgPath 当前包的 Package.swift 路径
+     * @param content Package.swift 内容
+     * @param fromPkgPath 当前包的 Package.swift 路径
      * @param {{ packageName: string, packagePath: string }} toPkg 目标包信息
-     * @returns {{ changed: boolean, content: string }}
+     * @returns }
      */
     #ensurePackageDependency(content, fromPkgPath, toPkg) {
         const fromDir = dirname(fromPkgPath);
@@ -444,8 +430,8 @@ export class SpmHelper {
      *
      * 从文件到 Package.swift 所在目录的相对路径中，反向匹配已知 target 名。
      * 如果文件不在任何 SPM target 的源码目录中（如 Xcode 主 App target），返回 null。
-     * @param {string} filePath 源文件绝对路径
-     * @returns {string|null} target 名称，未匹配返回 null
+     * @param filePath 源文件绝对路径
+     * @returns target 名称，未匹配返回 null
      */
     resolveCurrentTarget(filePath) {
         try {
@@ -476,4 +462,3 @@ export class SpmHelper {
         }
     }
 }
-//# sourceMappingURL=SpmHelper.js.map

package/dist/lib/{infrastructure/paths → platform/ios/xcode}/HeaderResolver.d.ts

@@ -2,9 +2,7 @@
  * HeaderResolver — ObjC/Swift #import 头文件路径解析
  * 解析 import 语句，定位头文件相对路径
  */
-/**
- * 解析单行 import 语句
- */
+/** 解析单行 import 语句 */
 export declare function parseImportLine(headerStr: string): {
     moduleName: string;
     headerName: string;
@@ -12,24 +10,15 @@ export declare function parseImportLine(headerStr: string): {
     moduleName: null;
     headerName: string;
 } | null;
-/**
- * 解析单个 import 的相对路径
- */
+/** 解析单个 import 的相对路径 */
 export declare function resolveHeaderRelativePath(headerStr: string, targetRootDir: string): Promise<string | undefined>;
-/**
- * 从文件路径和 Package 信息推断模块名
- */
+/** 从文件路径和 Package 信息推断模块名 */
 export declare function determineModuleNameFromPath(filePath: string, packageInfo: {
     path: string;
     targets?: string[];
     name?: string;
 }): string | null;
-/**
- * 综合解析：从路径+文本提取 headers、headerPaths、moduleName
- * @param {string} projectRoot
- * @param {string} relativePath
- * @param {string} text
- */
+/** 综合解析：从路径+文本提取 headers、headerPaths、moduleName */
 export declare function resolveHeadersForText(projectRoot: string, relativePath: string, text: string): Promise<{
     headers: string[];
     headerPaths: (string | undefined)[];
@@ -42,4 +31,3 @@ declare const _default: {
     determineModuleNameFromPath: typeof determineModuleNameFromPath;
 };
 export default _default;
-//# sourceMappingURL=HeaderResolver.d.ts.map

package/dist/lib/{infrastructure/paths → platform/ios/xcode}/HeaderResolver.js

@@ -1,13 +1,11 @@
 import fs from 'node:fs';
 import path from 'node:path';
-import * as PathFinder from './PathFinder.js';
+import * as PathFinder from '../spm/PathFinder.js';
 /**
  * HeaderResolver — ObjC/Swift #import 头文件路径解析
  * 解析 import 语句，定位头文件相对路径
  */
-/**
- * 解析单行 import 语句
- */
+/** 解析单行 import 语句 */
 export function parseImportLine(headerStr) {
     const s = String(headerStr || '').trim();
     const angle = s.match(/#import\s+<([^>]+)>/);
@@ -25,9 +23,7 @@ export function parseImportLine(headerStr) {
     }
     return null;
 }
-/**
- * 解析单个 import 的相对路径
- */
+/** 解析单个 import 的相对路径 */
 export async function resolveHeaderRelativePath(headerStr, targetRootDir) {
     if (!targetRootDir) {
         return undefined;
@@ -43,9 +39,7 @@ export async function resolveHeaderRelativePath(headerStr, targetRootDir) {
     }
     return path.relative(targetRootDir, headerPath);
 }
-/**
- * 从文件路径和 Package 信息推断模块名
- */
+/** 从文件路径和 Package 信息推断模块名 */
 export function determineModuleNameFromPath(filePath, packageInfo) {
     const relativePath = path.relative(packageInfo.path, filePath);
     const segments = relativePath.split(path.sep);
@@ -56,12 +50,7 @@ export function determineModuleNameFromPath(filePath, packageInfo) {
     }
     return packageInfo.targets?.[0] || packageInfo.name || null;
 }
-/**
- * 综合解析：从路径+文本提取 headers、headerPaths、moduleName
- * @param {string} projectRoot
- * @param {string} relativePath
- * @param {string} text
- */
+/** 综合解析：从路径+文本提取 headers、headerPaths、moduleName */
 export async function resolveHeadersForText(projectRoot, relativePath, text) {
     const fullPath = path.resolve(projectRoot, (relativePath || '').trim());
     if (!relativePath || !fs.existsSync(fullPath)) {
@@ -99,4 +88,3 @@ export default {
     resolveHeaderRelativePath,
     determineModuleNameFromPath,
 };
-//# sourceMappingURL=HeaderResolver.js.map

package/dist/lib/platform/ios/xcode/SaveEventFilter.d.ts

@@ -26,15 +26,15 @@ declare class SaveEventFilter {
      * 标记 AutoSnippet 即将写入某个文件
      * 在 fs.writeFile / writeFileSync 之前调用本方法
      *
-     * @param {string} filePath 绝对路径
+     * @param filePath 绝对路径
      */
     markSelfWrite(filePath: string): void;
     /**
      * 判断是否应该处理该文件的变更事件
      *
-     * @param {string} filePath 绝对路径
-     * @param {string} content  文件当前的完整内容
-     * @returns {{ process: boolean, reason: string }}
+     * @param filePath 绝对路径
+     * @param content 文件当前的完整内容
+     * @returns }
      */
     shouldProcess(filePath: string, content: string): {
         process: boolean;
@@ -44,21 +44,19 @@ declare class SaveEventFilter {
      * 处理完成后更新内容哈希
      * 在文件指令处理完毕后调用
      *
-     * @param {string} filePath 绝对路径
-     * @param {string} content 处理后的文件内容
+     * @param filePath 绝对路径
+     * @param content 处理后的文件内容
      */
     updateHash(filePath: string, content: string): void;
     /**
      * 在 handler 写文件之前同时标记 self-write + 更新哈希
      * 方便一步完成
      *
-     * @param {string} filePath 绝对路径
-     * @param {string} newContent 即将写入的新内容
+     * @param filePath 绝对路径
+     * @param newContent 即将写入的新内容
      */
     markWrite(filePath: string, newContent: string): void;
-    /**
-     * 清除某文件的所有状态（通常不需要调用）
-     */
+    /** 清除某文件的所有状态（通常不需要调用） */
     clear(filePath: string): void;
     _hash(content: string): string;
     _cleanup(): void;
@@ -66,4 +64,3 @@ declare class SaveEventFilter {
 /** 单例 */
 export declare const saveEventFilter: SaveEventFilter;
 export default saveEventFilter;
-//# sourceMappingURL=SaveEventFilter.d.ts.map

package/dist/lib/platform/ios/xcode/SaveEventFilter.js

@@ -50,7 +50,7 @@ class SaveEventFilter {
      * 标记 AutoSnippet 即将写入某个文件
      * 在 fs.writeFile / writeFileSync 之前调用本方法
      *
-     * @param {string} filePath 绝对路径
+     * @param filePath 绝对路径
      */
     markSelfWrite(filePath) {
         this._selfWrites.set(filePath, Date.now());
@@ -58,9 +58,9 @@ class SaveEventFilter {
     /**
      * 判断是否应该处理该文件的变更事件
      *
-     * @param {string} filePath 绝对路径
-     * @param {string} content  文件当前的完整内容
-     * @returns {{ process: boolean, reason: string }}
+     * @param filePath 绝对路径
+     * @param content 文件当前的完整内容
+     * @returns }
      */
     shouldProcess(filePath, content) {
         if (!isFilterEnabled()) {
@@ -95,8 +95,8 @@ class SaveEventFilter {
      * 处理完成后更新内容哈希
      * 在文件指令处理完毕后调用
      *
-     * @param {string} filePath 绝对路径
-     * @param {string} content 处理后的文件内容
+     * @param filePath 绝对路径
+     * @param content 处理后的文件内容
      */
     updateHash(filePath, content) {
         this._contentHashes.set(filePath, this._hash(content));
@@ -105,16 +105,14 @@ class SaveEventFilter {
      * 在 handler 写文件之前同时标记 self-write + 更新哈希
      * 方便一步完成
      *
-     * @param {string} filePath 绝对路径
-     * @param {string} newContent 即将写入的新内容
+     * @param filePath 绝对路径
+     * @param newContent 即将写入的新内容
      */
     markWrite(filePath, newContent) {
         this.markSelfWrite(filePath);
         this._contentHashes.set(filePath, this._hash(newContent));
     }
-    /**
-     * 清除某文件的所有状态（通常不需要调用）
-     */
+    /** 清除某文件的所有状态（通常不需要调用） */
     clear(filePath) {
         this._selfWrites.delete(filePath);
         this._contentHashes.delete(filePath);
@@ -142,4 +140,3 @@ class SaveEventFilter {
 /** 单例 */
 export const saveEventFilter = new SaveEventFilter();
 export default saveEventFilter;
-//# sourceMappingURL=SaveEventFilter.js.map

package/dist/lib/platform/ios/xcode/XcodeAutomation.d.ts

@@ -7,21 +7,17 @@
  * 所有操作都带超时保护（OSASCRIPT_TIMEOUT），Xcode 未运行时安全跳过。
  * 仅支持 macOS。
  */
-/**
- * 检查 Xcode 是否正在运行（不会启动 Xcode）
- */
+/** 检查 Xcode 是否正在运行（不会启动 Xcode） */
 export declare function isXcodeRunning(): boolean;
-/**
- * 检查 Xcode 是否为当前前台应用
- */
+/** 检查 Xcode 是否为当前前台应用 */
 export declare function isXcodeFrontmost(): boolean;
 /**
  * 跳转到指定行
  *
  * 按键序列：Cmd+L → 输入行号 → Return
  *
- * @param {number} lineNumber 1-based 行号
- * @returns {boolean} 是否成功
+ * @param lineNumber 1-based 行号
+ * @returns 是否成功
  */
 export declare function jumpToLineInXcode(lineNumber: number): boolean;
 /**
@@ -29,8 +25,8 @@ export declare function jumpToLineInXcode(lineNumber: number): boolean;
  *
  * 按键序列：Cmd+L 跳转 → Cmd+← 行首 → Cmd+Shift+→ 选到行尾 → Cmd+X 剪切
  *
- * @param {number} lineNumber 1-based 行号
- * @returns {boolean} 是否成功
+ * @param lineNumber 1-based 行号
+ * @returns 是否成功
  */
 export declare function cutLineInXcode(lineNumber: number): boolean;
 /**
@@ -38,15 +34,15 @@ export declare function cutLineInXcode(lineNumber: number): boolean;
  *
  * 按键序列：Cmd+L 跳转 → Cmd+← 行首 → Cmd+Shift+→ 选到行尾 → Delete
  *
- * @param {number} lineNumber 1-based 行号
- * @returns {boolean} 是否成功
+ * @param lineNumber 1-based 行号
+ * @returns 是否成功
  */
 export declare function deleteLineContentInXcode(lineNumber: number): boolean;
 /**
  * 执行粘贴（Cmd+V）
  *
  * 调用前须确保剪贴板已写入目标内容。
- * @returns {boolean} 是否成功
+ * @returns 是否成功
  */
 export declare function pasteInXcode(): boolean;
 /**
@@ -55,7 +51,7 @@ export declare function pasteInXcode(): boolean;
  * 假设光标已在目标行（通常由 jumpToLineInXcode 定位后调用）。
  * 按键序列：Cmd+← 行首 → Cmd+Shift+→ 选到行尾 → Cmd+V 粘贴替换
  *
- * @returns {boolean} 是否成功
+ * @returns 是否成功
  */
 export declare function selectAndPasteInXcode(): boolean;
 /**
@@ -64,13 +60,12 @@ export declare function selectAndPasteInXcode(): boolean;
  * 用于在 import 区域插入新行。
  * 按键序列：Cmd+L → 输入行号 → Return → Cmd+← 行首 → Cmd+V 粘贴
  *
- * @param {number} lineNumber 1-based 行号
- * @returns {boolean} 是否成功
+ * @param lineNumber 1-based 行号
+ * @returns 是否成功
  */
 export declare function insertAtLineStartInXcode(lineNumber: number): boolean;
 /**
  * 保存 Xcode 当前活动文档（Cmd+S）
- * @returns {boolean} 是否成功
+ * @returns 是否成功
  */
 export declare function saveActiveDocumentInXcode(): boolean;
-//# sourceMappingURL=XcodeAutomation.d.ts.map

package/dist/lib/platform/ios/xcode/XcodeAutomation.js

@@ -14,16 +14,15 @@ const OSASCRIPT_TIMEOUT = 5000;
 // ─────────────────────────────────────────────
 /**
  * 将行号限制为有效正整数（最小值 1）
- * @param {number} n 原始行号
- * @returns {number} 安全的 1-based 行号
+ * @param n 原始行号
+ * @returns 安全的 1-based 行号
  */
 function _safeLine(n) {
     return Number.isFinite(n) && n > 0 ? n : 1;
 }
 /**
  * 执行 osascript 并返回是否成功
- * @param {string[]} args  osascript 参数数组（每对 `-e`, `script`）
- * @returns {boolean}
+ * @param args osascript 参数数组（每对 `-e`, `script`）
  */
 function _run(args) {
     try {
@@ -37,9 +36,7 @@ function _run(args) {
 // ─────────────────────────────────────────────
 // 状态查询
 // ─────────────────────────────────────────────
-/**
- * 检查 Xcode 是否正在运行（不会启动 Xcode）
- */
+/** 检查 Xcode 是否正在运行（不会启动 Xcode） */
 export function isXcodeRunning() {
     if (process.platform !== 'darwin') {
         return false;
@@ -56,9 +53,7 @@ export function isXcodeRunning() {
         return false;
     }
 }
-/**
- * 检查 Xcode 是否为当前前台应用
- */
+/** 检查 Xcode 是否为当前前台应用 */
 export function isXcodeFrontmost() {
     if (!isXcodeRunning()) {
         return false;
@@ -79,8 +74,8 @@ export function isXcodeFrontmost() {
  *
  * 按键序列：Cmd+L → 输入行号 → Return
  *
- * @param {number} lineNumber 1-based 行号
- * @returns {boolean} 是否成功
+ * @param lineNumber 1-based 行号
+ * @returns 是否成功
  */
 export function jumpToLineInXcode(lineNumber) {
     if (!isXcodeRunning()) {
@@ -113,8 +108,8 @@ export function jumpToLineInXcode(lineNumber) {
  *
  * 按键序列：Cmd+L 跳转 → Cmd+← 行首 → Cmd+Shift+→ 选到行尾 → Cmd+X 剪切
  *
- * @param {number} lineNumber 1-based 行号
- * @returns {boolean} 是否成功
+ * @param lineNumber 1-based 行号
+ * @returns 是否成功
  */
 export function cutLineInXcode(lineNumber) {
     if (!isXcodeRunning()) {
@@ -159,8 +154,8 @@ export function cutLineInXcode(lineNumber) {
  *
  * 按键序列：Cmd+L 跳转 → Cmd+← 行首 → Cmd+Shift+→ 选到行尾 → Delete
  *
- * @param {number} lineNumber 1-based 行号
- * @returns {boolean} 是否成功
+ * @param lineNumber 1-based 行号
+ * @returns 是否成功
  */
 export function deleteLineContentInXcode(lineNumber) {
     if (!isXcodeRunning()) {
@@ -209,7 +204,7 @@ export function deleteLineContentInXcode(lineNumber) {
  * 执行粘贴（Cmd+V）
  *
  * 调用前须确保剪贴板已写入目标内容。
- * @returns {boolean} 是否成功
+ * @returns 是否成功
  */
 export function pasteInXcode() {
     if (!isXcodeRunning()) {
@@ -234,7 +229,7 @@ export function pasteInXcode() {
  * 假设光标已在目标行（通常由 jumpToLineInXcode 定位后调用）。
  * 按键序列：Cmd+← 行首 → Cmd+Shift+→ 选到行尾 → Cmd+V 粘贴替换
  *
- * @returns {boolean} 是否成功
+ * @returns 是否成功
  */
 export function selectAndPasteInXcode() {
     if (!isXcodeRunning()) {
@@ -267,8 +262,8 @@ export function selectAndPasteInXcode() {
  * 用于在 import 区域插入新行。
  * 按键序列：Cmd+L → 输入行号 → Return → Cmd+← 行首 → Cmd+V 粘贴
  *
- * @param {number} lineNumber 1-based 行号
- * @returns {boolean} 是否成功
+ * @param lineNumber 1-based 行号
+ * @returns 是否成功
  */
 export function insertAtLineStartInXcode(lineNumber) {
     if (!isXcodeRunning()) {
@@ -311,7 +306,7 @@ export function insertAtLineStartInXcode(lineNumber) {
 // ─────────────────────────────────────────────
 /**
  * 保存 Xcode 当前活动文档（Cmd+S）
- * @returns {boolean} 是否成功
+ * @returns 是否成功
  */
 export function saveActiveDocumentInXcode() {
     if (!isXcodeRunning()) {
@@ -330,4 +325,3 @@ export function saveActiveDocumentInXcode() {
         'end tell',
     ]);
 }
-//# sourceMappingURL=XcodeAutomation.js.map

package/dist/lib/platform/ios/xcode/XcodeImportResolver.d.ts

@@ -67,15 +67,13 @@ export declare function parseHeaderString(header: string): {
  *   2. 从项目根目录递归查找（最多深度 6 层，优先 Sources/ 下）
  *   3. 找到后计算相对于当前文件目录的路径
  *
- * @param {string} headerName 头文件名 (如 "Foo.h")
- * @param {string} currentFilePath 当前正在编辑的文件绝对路径
- * @param {string} [projectRoot] 项目根目录
- * @returns {string|null} 相对路径 (如 "Foo.h" 或 "../SubDir/Foo.h")，null 表示未找到
+ * @param headerName 头文件名 (如 "Foo.h")
+ * @param currentFilePath 当前正在编辑的文件绝对路径
+ * @param [projectRoot] 项目根目录
+ * @returns 相对路径 (如 "Foo.h" 或 "../SubDir/Foo.h")，null 表示未找到
  */
 export declare function findHeaderRelativePath(headerName: string, currentFilePath: string, projectRoot: string | null): string | null;
-/**
- * 递归查找文件（限最大深度）
- */
+/** 递归查找文件（限最大深度） */
 export declare function findFileRecursive(dir: string, fileName: string, maxDepth: number): string | null;
 /**
  * 根据当前文件 target 和 header 的 module 关系，生成正确格式的 import 行
@@ -86,14 +84,14 @@ export declare function findFileRecursive(dir: string, fileName: string, maxDept
  *   ObjC 跨 target:  `#import <Module/Header.h>` (angle-bracket format)
  *   @import 格式保持原样
  *
- * @param {string} rawHeader  原始 header 字符串
- * @param {object} ctx        { currentTarget, headerModuleName, isSwift, fullPath, projectRoot }
+ * @param rawHeader 原始 header 字符串
+ * @param ctx { currentTarget, headerModuleName, isSwift, fullPath, projectRoot }
  *   - currentTarget:    当前文件所属的 target 名
  *   - headerModuleName: header 所属的 module/target 名（来自 recipe.moduleName 或推断）
  *   - isSwift:          目标文件是否是 Swift
  *   - fullPath:         当前编辑文件的绝对路径（用于计算同 target 相对路径）
  *   - projectRoot:      项目根目录（用于搜索头文件物理位置）
- * @returns {string} 格式化后的完整 import 行
+ * @returns 格式化后的完整 import 行
  */
 export declare function resolveHeaderFormat(rawHeader: string, ctx: {
     currentTarget: string | null;
@@ -102,13 +100,9 @@ export declare function resolveHeaderFormat(rawHeader: string, ctx: {
     fullPath: string;
     projectRoot: string | null;
 }): string;
-/**
- * 从文件中收集已有的 import 语句
- */
+/** 从文件中收集已有的 import 语句 */
 export declare function collectImportsFromFile(filePath: string, isSwift: boolean): string[];
-/**
- * 收集 .m 文件对应 .h 文件中的 imports（ObjC 接口/实现配对去重）
- */
+/** 收集 .m 文件对应 .h 文件中的 imports（ObjC 接口/实现配对去重） */
 export declare function collectImportsFromHeaderFile(sourcePath: string, importArray: string[]): void;
 /**
  * 三级 import 去重检查
@@ -117,9 +111,8 @@ export declare function collectImportsFromHeaderFile(sourcePath: string, importA
  *   hasModule        模块级匹配（同模块不同头文件，或 @import）
  *   hasSimilarHeader 文件名 case-insensitive 匹配
  *
- * @param {string[]} importArray 已有的 import 行
- * @param {string}   headerLine 待插入的 import 行
- * @param {boolean}  isSwift
+ * @param importArray 已有的 import 行
+ * @param headerLine 待插入的 import 行
  */
 export declare function checkImportStatus(importArray: string[], headerLine: string, isSwift: boolean): {
     hasHeader: boolean;
@@ -135,4 +128,3 @@ export declare function checkImportStatus(importArray: string[], headerLine: str
  *   #import "Local.h"          → null
  */
 export declare function inferModulesFromHeaders(headers: string[]): string[];
-//# sourceMappingURL=XcodeImportResolver.d.ts.map