autosnippet 3.2.21 → 3.3.0

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

@@ -1,90 +0,0 @@
-import fs from 'node:fs';
-import path from 'node:path';
-import * as PathFinder from '../spm/PathFinder.js';
-/**
- * HeaderResolver — ObjC/Swift #import 头文件路径解析
- * 解析 import 语句，定位头文件相对路径
- */
-/** 解析单行 import 语句 */
-export function parseImportLine(headerStr) {
-    const s = String(headerStr || '').trim();
-    const angle = s.match(/#import\s+<([^>]+)>/);
-    if (angle) {
-        const part = angle[1].trim();
-        const slash = part.indexOf('/');
-        if (slash !== -1) {
-            return { moduleName: part.slice(0, slash), headerName: path.basename(part, '.h') };
-        }
-        return { moduleName: null, headerName: path.basename(part, '.h') };
-    }
-    const quote = s.match(/#import\s+"([^"]+)"/);
-    if (quote) {
-        return { moduleName: null, headerName: path.basename(quote[1], '.h') };
-    }
-    return null;
-}
-/** 解析单个 import 的相对路径 */
-export async function resolveHeaderRelativePath(headerStr, targetRootDir) {
-    if (!targetRootDir) {
-        return undefined;
-    }
-    const parsed = parseImportLine(headerStr);
-    if (!parsed) {
-        return undefined;
-    }
-    const { moduleName, headerName } = parsed;
-    const headerPath = await PathFinder.findSubHeaderPath(targetRootDir, headerName, moduleName);
-    if (!headerPath) {
-        return undefined;
-    }
-    return path.relative(targetRootDir, headerPath);
-}
-/** 从文件路径和 Package 信息推断模块名 */
-export function determineModuleNameFromPath(filePath, packageInfo) {
-    const relativePath = path.relative(packageInfo.path, filePath);
-    const segments = relativePath.split(path.sep);
-    for (let i = segments.length - 1; i >= 0; i--) {
-        if (packageInfo.targets?.includes(segments[i])) {
-            return segments[i];
-        }
-    }
-    return packageInfo.targets?.[0] || packageInfo.name || null;
-}
-/** 综合解析：从路径+文本提取 headers、headerPaths、moduleName */
-export async function resolveHeadersForText(projectRoot, relativePath, text) {
-    const fullPath = path.resolve(projectRoot, (relativePath || '').trim());
-    if (!relativePath || !fs.existsSync(fullPath)) {
-        return { headers: [], headerPaths: [], moduleName: null };
-    }
-    const targetRootDir = await PathFinder.findTargetRootDir(fullPath);
-    let moduleName = targetRootDir ? path.basename(targetRootDir) : null;
-    const importRegex = /^(?:#import|import)\s+.*$/gm;
-    let headers = (text.match(importRegex) || []).filter(Boolean);
-    let headerPaths = targetRootDir
-        ? await Promise.all(headers.map((h) => resolveHeaderRelativePath(h, targetRootDir)))
-        : [];
-    // 如果 .m/.mm 无 import，尝试推断同名 .h
-    const ext = path.extname(fullPath).toLowerCase();
-    if (targetRootDir && headers.length === 0 && (ext === '.m' || ext === '.mm')) {
-        const headerNameWithoutExt = path.basename(fullPath, ext);
-        const packagePath = await PathFinder.findPackageSwiftPath(fullPath);
-        const packageInfo = packagePath ? await PathFinder.parsePackageSwift(packagePath) : null;
-        if (packageInfo) {
-            moduleName = determineModuleNameFromPath(fullPath, packageInfo);
-        }
-        const headerPath = await PathFinder.findSubHeaderPath(targetRootDir, headerNameWithoutExt, moduleName);
-        if (headerPath) {
-            headers = [
-                `#import <${moduleName || path.basename(targetRootDir)}/${headerNameWithoutExt}.h>`,
-            ];
-            headerPaths = [path.relative(targetRootDir, headerPath)];
-        }
-    }
-    return { headers, headerPaths, moduleName };
-}
-export default {
-    resolveHeadersForText,
-    parseImportLine,
-    resolveHeaderRelativePath,
-    determineModuleNameFromPath,
-};

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

@@ -1,66 +0,0 @@
-/**
- * SaveEventFilter - 区分用户保存与 Xcode 自动保存
- *
- * 三层过滤策略：
- * 1. Self-write 冷却期：AutoSnippet 自身写入的文件在冷却期内忽略变更
- * 2. 内容哈希去重：文件内容未变时跳过处理
- * 3. Xcode 焦点检测：Xcode 不是前台应用时跳过（典型的切窗口自动保存场景）
- *
- * 使用方式：
- *   import { saveEventFilter } from './SaveEventFilter.js';
- *
- *   // 在 handler 写文件时标记
- *   saveEventFilter.markSelfWrite(filePath);
- *   fs.writeFileSync(filePath, content);
- *
- *   // 在 FileWatcher 处理前判断
- *   const verdict = saveEventFilter.shouldProcess(filePath, content);
- *   if (!verdict.process) { console.log(verdict.reason); return; }
- */
-declare class SaveEventFilter {
-    _cleanupInterval: ReturnType<typeof setInterval>;
-    _contentHashes: Map<string, string>;
-    _selfWrites: Map<string, number>;
-    constructor();
-    /**
-     * 标记 AutoSnippet 即将写入某个文件
-     * 在 fs.writeFile / writeFileSync 之前调用本方法
-     *
-     * @param filePath 绝对路径
-     */
-    markSelfWrite(filePath: string): void;
-    /**
-     * 判断是否应该处理该文件的变更事件
-     *
-     * @param filePath 绝对路径
-     * @param content 文件当前的完整内容
-     * @returns }
-     */
-    shouldProcess(filePath: string, content: string): {
-        process: boolean;
-        reason: string;
-    };
-    /**
-     * 处理完成后更新内容哈希
-     * 在文件指令处理完毕后调用
-     *
-     * @param filePath 绝对路径
-     * @param content 处理后的文件内容
-     */
-    updateHash(filePath: string, content: string): void;
-    /**
-     * 在 handler 写文件之前同时标记 self-write + 更新哈希
-     * 方便一步完成
-     *
-     * @param filePath 绝对路径
-     * @param newContent 即将写入的新内容
-     */
-    markWrite(filePath: string, newContent: string): void;
-    /** 清除某文件的所有状态（通常不需要调用） */
-    clear(filePath: string): void;
-    _hash(content: string): string;
-    _cleanup(): void;
-}
-/** 单例 */
-export declare const saveEventFilter: SaveEventFilter;
-export default saveEventFilter;

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

@@ -1,142 +0,0 @@
-/**
- * SaveEventFilter - 区分用户保存与 Xcode 自动保存
- *
- * 三层过滤策略：
- * 1. Self-write 冷却期：AutoSnippet 自身写入的文件在冷却期内忽略变更
- * 2. 内容哈希去重：文件内容未变时跳过处理
- * 3. Xcode 焦点检测：Xcode 不是前台应用时跳过（典型的切窗口自动保存场景）
- *
- * 使用方式：
- *   import { saveEventFilter } from './SaveEventFilter.js';
- *
- *   // 在 handler 写文件时标记
- *   saveEventFilter.markSelfWrite(filePath);
- *   fs.writeFileSync(filePath, content);
- *
- *   // 在 FileWatcher 处理前判断
- *   const verdict = saveEventFilter.shouldProcess(filePath, content);
- *   if (!verdict.process) { console.log(verdict.reason); return; }
- */
-import { createHash } from 'node:crypto';
-import { isXcodeFrontmost } from './XcodeAutomation.js';
-/* ────────── 配置 ────────── */
-/** Self-write 冷却期（ms） */
-const SELF_WRITE_COOLDOWN = 2000;
-/** 是否启用 Xcode 焦点过滤（可通过 ASD_SAVE_FILTER=0 关闭） */
-function isFilterEnabled() {
-    return process.env.ASD_SAVE_FILTER !== '0';
-}
-/** 是否启用 Xcode 焦点检测（可通过 ASD_XCODE_FOCUS_CHECK=0 单独关闭） */
-function isFocusCheckEnabled() {
-    return process.env.ASD_XCODE_FOCUS_CHECK !== '0';
-}
-/* ────────── SaveEventFilter ────────── */
-class SaveEventFilter {
-    _cleanupInterval;
-    _contentHashes;
-    _selfWrites;
-    constructor() {
-        /** filePath → 最后一次 self-write 的时间戳 */
-        this._selfWrites = new Map();
-        /** filePath → 上次处理时的内容 MD5 哈希 */
-        this._contentHashes = new Map();
-        // 定期清理过期条目，防止内存泄漏
-        this._cleanupInterval = setInterval(() => this._cleanup(), 60_000);
-        if (this._cleanupInterval.unref) {
-            this._cleanupInterval.unref();
-        }
-    }
-    /**
-     * 标记 AutoSnippet 即将写入某个文件
-     * 在 fs.writeFile / writeFileSync 之前调用本方法
-     *
-     * @param filePath 绝对路径
-     */
-    markSelfWrite(filePath) {
-        this._selfWrites.set(filePath, Date.now());
-    }
-    /**
-     * 判断是否应该处理该文件的变更事件
-     *
-     * @param filePath 绝对路径
-     * @param content 文件当前的完整内容
-     * @returns }
-     */
-    shouldProcess(filePath, content) {
-        if (!isFilterEnabled()) {
-            return { process: true, reason: 'filter-disabled' };
-        }
-        // ── Layer 1: Self-write 冷却期 ──
-        const lastSelfWrite = this._selfWrites.get(filePath);
-        if (lastSelfWrite && Date.now() - lastSelfWrite < SELF_WRITE_COOLDOWN) {
-            if (process.env.ASD_DEBUG === '1') {
-            }
-            return { process: false, reason: 'self-write-cooldown' };
-        }
-        // ── Layer 2: 内容哈希去重 ──
-        const hash = this._hash(content);
-        const prevHash = this._contentHashes.get(filePath);
-        if (prevHash && prevHash === hash) {
-            if (process.env.ASD_DEBUG === '1') {
-            }
-            return { process: false, reason: 'content-unchanged' };
-        }
-        // ── Layer 3: Xcode 焦点检测 ──
-        if (process.platform === 'darwin' && isFocusCheckEnabled()) {
-            if (!isXcodeFrontmost()) {
-                if (process.env.ASD_DEBUG === '1') {
-                }
-                return { process: false, reason: 'xcode-not-frontmost' };
-            }
-        }
-        return { process: true, reason: 'ok' };
-    }
-    /**
-     * 处理完成后更新内容哈希
-     * 在文件指令处理完毕后调用
-     *
-     * @param filePath 绝对路径
-     * @param content 处理后的文件内容
-     */
-    updateHash(filePath, content) {
-        this._contentHashes.set(filePath, this._hash(content));
-    }
-    /**
-     * 在 handler 写文件之前同时标记 self-write + 更新哈希
-     * 方便一步完成
-     *
-     * @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);
-    }
-    /* ────────── 内部方法 ────────── */
-    _hash(content) {
-        return createHash('md5').update(content).digest('hex');
-    }
-    _cleanup() {
-        const now = Date.now();
-        const expiry = 10 * 60 * 1000; // 10 分钟
-        for (const [k, ts] of this._selfWrites) {
-            if (now - ts > expiry) {
-                this._selfWrites.delete(k);
-            }
-        }
-        // 内容哈希保留更长时间，只清理明显过期的
-        // （文件仍被监听期间不应清理，所以这里保守处理）
-        if (this._contentHashes.size > 1000) {
-            // 超过 1000 个文件说明有泄漏，全部清理
-            this._contentHashes.clear();
-        }
-    }
-}
-/** 单例 */
-export const saveEventFilter = new SaveEventFilter();
-export default saveEventFilter;

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

@@ -1,71 +0,0 @@
-/**
- * XcodeAutomation — Xcode AppleScript 自动化
- *
- * 通过 osascript 向 Xcode 发送键盘事件，实现行级操作：
- *   跳转行、选中行内容、剪切行、粘贴、在行首插入、删除行内容、保存文档。
- *
- * 所有操作都带超时保护（OSASCRIPT_TIMEOUT），Xcode 未运行时安全跳过。
- * 仅支持 macOS。
- */
-/** 检查 Xcode 是否正在运行（不会启动 Xcode） */
-export declare function isXcodeRunning(): boolean;
-/** 检查 Xcode 是否为当前前台应用 */
-export declare function isXcodeFrontmost(): boolean;
-/**
- * 跳转到指定行
- *
- * 按键序列：Cmd+L → 输入行号 → Return
- *
- * @param lineNumber 1-based 行号
- * @returns 是否成功
- */
-export declare function jumpToLineInXcode(lineNumber: number): boolean;
-/**
- * 剪切指定行的文本内容（不含换行符）
- *
- * 按键序列：Cmd+L 跳转 → Cmd+← 行首 → Cmd+Shift+→ 选到行尾 → Cmd+X 剪切
- *
- * @param lineNumber 1-based 行号
- * @returns 是否成功
- */
-export declare function cutLineInXcode(lineNumber: number): boolean;
-/**
- * 删除指定行的文本内容（保留空行，不删除行本身）
- *
- * 按键序列：Cmd+L 跳转 → Cmd+← 行首 → Cmd+Shift+→ 选到行尾 → Delete
- *
- * @param lineNumber 1-based 行号
- * @returns 是否成功
- */
-export declare function deleteLineContentInXcode(lineNumber: number): boolean;
-/**
- * 执行粘贴（Cmd+V）
- *
- * 调用前须确保剪贴板已写入目标内容。
- * @returns 是否成功
- */
-export declare function pasteInXcode(): boolean;
-/**
- * 选中当前行内容后粘贴替换
- *
- * 假设光标已在目标行（通常由 jumpToLineInXcode 定位后调用）。
- * 按键序列：Cmd+← 行首 → Cmd+Shift+→ 选到行尾 → Cmd+V 粘贴替换
- *
- * @returns 是否成功
- */
-export declare function selectAndPasteInXcode(): boolean;
-/**
- * 跳转到指定行行首并粘贴剪贴板内容
- *
- * 用于在 import 区域插入新行。
- * 按键序列：Cmd+L → 输入行号 → Return → Cmd+← 行首 → Cmd+V 粘贴
- *
- * @param lineNumber 1-based 行号
- * @returns 是否成功
- */
-export declare function insertAtLineStartInXcode(lineNumber: number): boolean;
-/**
- * 保存 Xcode 当前活动文档（Cmd+S）
- * @returns 是否成功
- */
-export declare function saveActiveDocumentInXcode(): boolean;

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

@@ -1,327 +0,0 @@
-/**
- * XcodeAutomation — Xcode AppleScript 自动化
- *
- * 通过 osascript 向 Xcode 发送键盘事件，实现行级操作：
- *   跳转行、选中行内容、剪切行、粘贴、在行首插入、删除行内容、保存文档。
- *
- * 所有操作都带超时保护（OSASCRIPT_TIMEOUT），Xcode 未运行时安全跳过。
- * 仅支持 macOS。
- */
-import { execSync, spawnSync } from 'node:child_process';
-const OSASCRIPT_TIMEOUT = 5000;
-// ─────────────────────────────────────────────
-// 内部辅助
-// ─────────────────────────────────────────────
-/**
- * 将行号限制为有效正整数（最小值 1）
- * @param n 原始行号
- * @returns 安全的 1-based 行号
- */
-function _safeLine(n) {
-    return Number.isFinite(n) && n > 0 ? n : 1;
-}
-/**
- * 执行 osascript 并返回是否成功
- * @param args osascript 参数数组（每对 `-e`, `script`）
- */
-function _run(args) {
-    try {
-        const res = spawnSync('osascript', args, { stdio: 'ignore', timeout: OSASCRIPT_TIMEOUT });
-        return res.status === 0;
-    }
-    catch {
-        return false;
-    }
-}
-// ─────────────────────────────────────────────
-// 状态查询
-// ─────────────────────────────────────────────
-/** 检查 Xcode 是否正在运行（不会启动 Xcode） */
-export function isXcodeRunning() {
-    if (process.platform !== 'darwin') {
-        return false;
-    }
-    try {
-        const result = execSync('pgrep -x Xcode', {
-            encoding: 'utf8',
-            timeout: 2000,
-            stdio: 'pipe',
-        });
-        return result.trim().length > 0;
-    }
-    catch {
-        return false;
-    }
-}
-/** 检查 Xcode 是否为当前前台应用 */
-export function isXcodeFrontmost() {
-    if (!isXcodeRunning()) {
-        return false;
-    }
-    try {
-        const result = execSync('osascript -e \'tell application "System Events" to get name of first process whose frontmost is true\'', { encoding: 'utf8', timeout: OSASCRIPT_TIMEOUT, stdio: 'pipe' });
-        return result.trim() === 'Xcode';
-    }
-    catch {
-        return false;
-    }
-}
-// ─────────────────────────────────────────────
-// 行操作
-// ─────────────────────────────────────────────
-/**
- * 跳转到指定行
- *
- * 按键序列：Cmd+L → 输入行号 → Return
- *
- * @param lineNumber 1-based 行号
- * @returns 是否成功
- */
-export function jumpToLineInXcode(lineNumber) {
-    if (!isXcodeRunning()) {
-        return false;
-    }
-    const n = _safeLine(lineNumber);
-    return _run([
-        '-e',
-        'tell application "Xcode" to activate',
-        '-e',
-        'delay 0.2',
-        '-e',
-        'tell application "System Events"',
-        '-e',
-        '  keystroke "l" using command down',
-        '-e',
-        '  delay 0.2',
-        '-e',
-        `  keystroke "${String(n)}"`,
-        '-e',
-        '  delay 0.2',
-        '-e',
-        '  key code 36',
-        '-e',
-        'end tell',
-    ]);
-}
-/**
- * 剪切指定行的文本内容（不含换行符）
- *
- * 按键序列：Cmd+L 跳转 → Cmd+← 行首 → Cmd+Shift+→ 选到行尾 → Cmd+X 剪切
- *
- * @param lineNumber 1-based 行号
- * @returns 是否成功
- */
-export function cutLineInXcode(lineNumber) {
-    if (!isXcodeRunning()) {
-        return false;
-    }
-    const n = _safeLine(lineNumber);
-    return _run([
-        '-e',
-        'tell application "Xcode" to activate',
-        '-e',
-        'delay 0.5',
-        '-e',
-        'tell application "System Events"',
-        '-e',
-        '  keystroke "l" using command down', // Cmd+L: Go to Line
-        '-e',
-        '  delay 0.5',
-        '-e',
-        `  keystroke "${String(n)}"`, // 输入行号
-        '-e',
-        '  delay 0.5',
-        '-e',
-        '  key code 36', // Return
-        '-e',
-        '  delay 0.5',
-        '-e',
-        '  key code 123 using command down', // Cmd+← 行首
-        '-e',
-        '  delay 0.5',
-        '-e',
-        '  key code 124 using {command down, shift down}', // Cmd+Shift+→ 选到行尾
-        '-e',
-        '  delay 0.5',
-        '-e',
-        '  keystroke "x" using command down', // Cmd+X
-        '-e',
-        'end tell',
-    ]);
-}
-/**
- * 删除指定行的文本内容（保留空行，不删除行本身）
- *
- * 按键序列：Cmd+L 跳转 → Cmd+← 行首 → Cmd+Shift+→ 选到行尾 → Delete
- *
- * @param lineNumber 1-based 行号
- * @returns 是否成功
- */
-export function deleteLineContentInXcode(lineNumber) {
-    if (!isXcodeRunning()) {
-        return false;
-    }
-    const n = _safeLine(lineNumber);
-    return _run([
-        '-e',
-        'tell application "Xcode" to activate',
-        '-e',
-        'delay 0.3',
-        '-e',
-        'tell application "System Events"',
-        '-e',
-        '  keystroke "l" using command down',
-        '-e',
-        '  delay 0.3',
-        '-e',
-        `  keystroke "${String(n)}"`,
-        '-e',
-        '  delay 0.3',
-        '-e',
-        '  key code 36',
-        '-e',
-        '  delay 0.3',
-        '-e',
-        '  key code 123 using command down', // Cmd+← 行首
-        '-e',
-        '  delay 0.2',
-        '-e',
-        '  key code 124 using {command down, shift down}', // Cmd+Shift+→ 选到行尾
-        '-e',
-        '  delay 0.2',
-        '-e',
-        '  key code 51', // Delete 键
-        '-e',
-        '  delay 0.3',
-        '-e',
-        'end tell',
-    ]);
-}
-// ─────────────────────────────────────────────
-// 粘贴操作
-// ─────────────────────────────────────────────
-/**
- * 执行粘贴（Cmd+V）
- *
- * 调用前须确保剪贴板已写入目标内容。
- * @returns 是否成功
- */
-export function pasteInXcode() {
-    if (!isXcodeRunning()) {
-        return false;
-    }
-    return _run([
-        '-e',
-        'tell application "Xcode" to activate',
-        '-e',
-        'delay 0.2',
-        '-e',
-        'tell application "System Events"',
-        '-e',
-        '  keystroke "v" using command down',
-        '-e',
-        'end tell',
-    ]);
-}
-/**
- * 选中当前行内容后粘贴替换
- *
- * 假设光标已在目标行（通常由 jumpToLineInXcode 定位后调用）。
- * 按键序列：Cmd+← 行首 → Cmd+Shift+→ 选到行尾 → Cmd+V 粘贴替换
- *
- * @returns 是否成功
- */
-export function selectAndPasteInXcode() {
-    if (!isXcodeRunning()) {
-        return false;
-    }
-    return _run([
-        '-e',
-        'tell application "Xcode" to activate',
-        '-e',
-        'delay 0.5',
-        '-e',
-        'tell application "System Events"',
-        '-e',
-        '  key code 123 using command down', // Cmd+← 行首
-        '-e',
-        '  delay 0.1',
-        '-e',
-        '  key code 124 using {command down, shift down}', // Cmd+Shift+→ 选到行尾
-        '-e',
-        '  delay 0.2',
-        '-e',
-        '  keystroke "v" using command down', // Cmd+V 粘贴替换
-        '-e',
-        'end tell',
-    ]);
-}
-/**
- * 跳转到指定行行首并粘贴剪贴板内容
- *
- * 用于在 import 区域插入新行。
- * 按键序列：Cmd+L → 输入行号 → Return → Cmd+← 行首 → Cmd+V 粘贴
- *
- * @param lineNumber 1-based 行号
- * @returns 是否成功
- */
-export function insertAtLineStartInXcode(lineNumber) {
-    if (!isXcodeRunning()) {
-        return false;
-    }
-    const n = _safeLine(lineNumber);
-    return _run([
-        '-e',
-        'tell application "Xcode" to activate',
-        '-e',
-        'delay 0.3',
-        '-e',
-        'tell application "System Events"',
-        '-e',
-        '  keystroke "l" using command down', // Cmd+L: Go to Line
-        '-e',
-        '  delay 0.3',
-        '-e',
-        `  keystroke "${String(n)}"`, // 输入行号
-        '-e',
-        '  delay 0.3',
-        '-e',
-        '  key code 36', // Return
-        '-e',
-        '  delay 0.3',
-        '-e',
-        '  key code 123 using command down', // Cmd+← 行首
-        '-e',
-        '  delay 0.2',
-        '-e',
-        '  keystroke "v" using command down', // Cmd+V 粘贴
-        '-e',
-        '  delay 0.3',
-        '-e',
-        'end tell',
-    ]);
-}
-// ─────────────────────────────────────────────
-// 文档操作
-// ─────────────────────────────────────────────
-/**
- * 保存 Xcode 当前活动文档（Cmd+S）
- * @returns 是否成功
- */
-export function saveActiveDocumentInXcode() {
-    if (!isXcodeRunning()) {
-        return false;
-    }
-    return _run([
-        '-e',
-        'tell application "Xcode" to activate',
-        '-e',
-        'delay 0.1',
-        '-e',
-        'tell application "System Events"',
-        '-e',
-        '  keystroke "s" using command down',
-        '-e',
-        'end tell',
-    ]);
-}