autosnippet 3.2.21 → 3.3.0

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

@@ -1,190 +0,0 @@
-/**
- * XcodeWriteUtils — Xcode 写入与插入工具函数
- *
- * 从 XcodeIntegration.js 拆分，负责：
- *   - 通用工具函数（sleep, withAutoSnippetNote）
- *   - SPM 依赖决策逻辑
- *   - Xcode osascript 写入
- *   - 文件写入回退
- *   - 粘贴行号偏移计算
- */
-import { existsSync, readFileSync, writeFileSync } from 'node:fs';
-import { saveEventFilter } from './SaveEventFilter.js';
-export function sleep(ms) {
-    return new Promise((resolve) => setTimeout(resolve, ms));
-}
-/** 在 import 行末尾附加来源标记注释 */
-export function withAutoSnippetNote(importLine) {
-    if (!importLine) {
-        return importLine;
-    }
-    const note = '// AutoSnippet: 自动插入';
-    if (importLine.includes(note)) {
-        return importLine;
-    }
-    return `${importLine} ${note}`;
-}
-/**
- * 将 SpmHelper.ensureDependency 返回值映射为三种动作：
- *   continue — 依赖已存在
- *   block    — 循环/反向依赖，禁止插入
- *   review   — 依赖缺失但可添加，需用户确认
- */
-export function evaluateDepResult(ensureResult, from, to) {
-    if (ensureResult.exists) {
-        return { action: 'continue' };
-    }
-    if (!ensureResult.canAdd) {
-        return { action: 'block', reason: ensureResult.reason || 'cycleBlocked', from, to };
-    }
-    return { action: 'review', reason: ensureResult.reason || 'missingDependency', from, to };
-}
-/**
- * 公共依赖审查弹窗逻辑（insertHeaders 和 _preflightDeps 共享）
- *
- * @param ctx { spmService, currentTarget, mod, ensureResult, NU, depWarnings, label }
- * @returns }
- */
-export function handleDepReview(ctx) {
-    const { spmService, currentTarget, mod, ensureResult, NU, depWarnings, label = '' } = ctx;
-    const fixMode = spmService.getFixMode();
-    const buttons = fixMode === 'fix'
-        ? ['直接插入（信任架构）', '提示操作插入', '自动修复依赖', '取消操作']
-        : ['直接插入（信任架构）', '提示操作插入', '取消操作'];
-    const crossTag = ensureResult.crossPackage ? ' (跨包)' : '';
-    const prefix = label ? `[${label}] ` : '';
-    const userChoice = NU.promptWithButtons(`检测到依赖缺失：${currentTarget} -> ${mod}${crossTag}\n\n请选择处理方式：`, buttons, 'AutoSnippet SPM 依赖决策');
-    if (userChoice === '取消操作' ||
-        (!userChoice && !['直接插入（信任架构）', '提示操作插入', '自动修复依赖'].includes(userChoice))) {
-        return { blocked: true };
-    }
-    if (userChoice === '提示操作插入') {
-        depWarnings.set(mod, `${currentTarget} -> ${mod}`);
-    }
-    if (userChoice === '自动修复依赖') {
-        const fixResult = spmService.addDependency(currentTarget, mod);
-        if (fixResult.ok) {
-            NU.notify(`已补齐依赖：${currentTarget} -> ${mod}`, 'AutoSnippet SPM');
-        }
-        else {
-            console.warn(`  ⚠️ ${prefix}自动修复失败: ${fixResult.error}，继续插入`);
-            depWarnings.set(mod, `${currentTarget} -> ${mod}`);
-        }
-    }
-    return { blocked: false };
-}
-// ═══════════════════════════════════════════════════════════════
-// Xcode osascript 单条 import 写入
-// ═══════════════════════════════════════════════════════════════
-/**
- * 通过 Xcode 自动化插入一条 import，保持 Xcode Undo 可用。
- *
- * 流程：保存剪贴板 → 写入 import 内容 → osascript 跳转+粘贴 → 恢复剪贴板
- *
- * @param importLine 完整的 import 文本
- * @param insertLine 1-based 行号
- * @param XA XcodeAutomation 模块
- * @param CM ClipboardManager 模块
- */
-export function writeImportLineXcode(importLine, insertLine, XA, CM) {
-    if (!XA.isXcodeRunning()) {
-        return false;
-    }
-    try {
-        const contentToWrite = `${String(importLine).trim()}\n`;
-        const previousClipboard = CM.read();
-        CM.write(contentToWrite);
-        const ok = XA.insertAtLineStartInXcode(insertLine);
-        // 始终恢复剪贴板
-        if (typeof previousClipboard === 'string') {
-            CM.write(previousClipboard);
-        }
-        return ok;
-    }
-    catch {
-        return false;
-    }
-}
-// ═══════════════════════════════════════════════════════════════
-// 文件写入回退
-// ═══════════════════════════════════════════════════════════════
-/**
- * 纯文件写入插入单条 import。
- * Xcode 会因文件变更而自动 reload。
- */
-export function writeImportLineFile(filePath, importLine, isSwift) {
-    try {
-        const content = readFileSync(filePath, 'utf8');
-        const lines = content.split('\n');
-        let lastImportIdx = -1;
-        for (let i = 0; i < lines.length; i++) {
-            const t = lines[i].trim();
-            if (isSwift) {
-                if (t.startsWith('import ') && !t.startsWith('import (')) {
-                    lastImportIdx = i;
-                }
-            }
-            else {
-                if (t.startsWith('#import ') || t.startsWith('#include ') || t.startsWith('@import ')) {
-                    lastImportIdx = i;
-                }
-            }
-        }
-        const insertAt = lastImportIdx >= 0 ? lastImportIdx + 1 : 0;
-        lines.splice(insertAt, 0, importLine);
-        const newContent = lines.join('\n');
-        saveEventFilter.markWrite(filePath, newContent);
-        writeFileSync(filePath, newContent, 'utf8');
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-// ═══════════════════════════════════════════════════════════════
-// 粘贴行号偏移计算
-// ═══════════════════════════════════════════════════════════════
-/** 查找文件中最后一个 import 行的行号（1-based，0 表示无 import） */
-export function getLastImportLine(filePath) {
-    try {
-        if (!existsSync(filePath)) {
-            return 0;
-        }
-        const content = readFileSync(filePath, 'utf8');
-        const lines = content.split(/\r?\n/);
-        let lastIdx = -1;
-        for (let i = 0; i < lines.length; i++) {
-            const t = lines[i].trim();
-            if (t.startsWith('#import ') ||
-                t.startsWith('@import ') ||
-                t.startsWith('#include ') ||
-                t.startsWith('import ')) {
-                lastIdx = i;
-            }
-        }
-        return lastIdx >= 0 ? lastIdx + 1 : 0;
-    }
-    catch {
-        return 0;
-    }
-}
-/**
- * 计算代码粘贴行号
- *
- * 如果 headers 插入在 trigger 行之前（import 区），trigger 行号需要向下偏移。
- */
-export function computePasteLineNumber(triggerLineNumber, headerInsertCount, filePath, options = {}) {
-    const expectedCount = Number.isFinite(options.expectedHeaderCount)
-        ? options.expectedHeaderCount
-        : headerInsertCount;
-    if (expectedCount > 0) {
-        if (options.forceOffset) {
-            return triggerLineNumber + expectedCount;
-        }
-        const headerInsertPosition = getLastImportLine(filePath);
-        if (headerInsertPosition > 0 && headerInsertPosition < triggerLineNumber) {
-            return triggerLineNumber + expectedCount;
-        }
-    }
-    return triggerLineNumber;
-}

package/dist/lib/service/automation/ActionPipeline.d.ts

@@ -1,34 +0,0 @@
-/**
- * ActionPipeline — 自动化动作管线
- * 按顺序执行注册的 action handlers
- */
-export declare class ActionPipeline {
-    #private;
-    constructor();
-    /**
-     * 注册动作处理器
-     * @param type 触发类型
-     * @param handler async (trigger, context) => result
-     */
-    register(type: string, handler: (trigger: Record<string, unknown>, context: Record<string, unknown>) => Promise<unknown>): void;
-    /**
-     * 执行管线
-     * @param trigger
-     * @returns >}
-     */
-    execute(trigger: {
-        type: string;
-        name?: string;
-        params?: Record<string, unknown>;
-    }, context: Record<string, unknown>): Promise<{
-        success: boolean;
-        result: unknown;
-        error?: undefined;
-    } | {
-        success: boolean;
-        error: string;
-        result?: undefined;
-    }>;
-    /** 获取已注册的动作类型 */
-    getRegisteredTypes(): any[];
-}

package/dist/lib/service/automation/ActionPipeline.js

@@ -1,53 +0,0 @@
-/**
- * ActionPipeline — 自动化动作管线
- * 按顺序执行注册的 action handlers
- */
-import Logger from '../../infrastructure/logging/Logger.js';
-export class ActionPipeline {
-    #actions; // Map<type, handler>
-    #logger;
-    constructor() {
-        this.#actions = new Map();
-        this.#logger = Logger.getInstance();
-    }
-    /**
-     * 注册动作处理器
-     * @param type 触发类型
-     * @param handler async (trigger, context) => result
-     */
-    register(type, handler) {
-        this.#actions.set(type, handler);
-    }
-    /**
-     * 执行管线
-     * @param trigger
-     * @returns >}
-     */
-    async execute(trigger, context) {
-        const handler = this.#actions.get(trigger.type);
-        if (!handler) {
-            // 尝试通用 handler
-            const fallback = this.#actions.get('*');
-            if (fallback) {
-                return this.#runHandler(fallback, trigger, context);
-            }
-            this.#logger.warn(`[ActionPipeline] 未找到 handler: ${trigger.type}`);
-            return { success: false, error: `未知触发类型: ${trigger.type}` };
-        }
-        return this.#runHandler(handler, trigger, context);
-    }
-    /** 获取已注册的动作类型 */
-    getRegisteredTypes() {
-        return [...this.#actions.keys()];
-    }
-    async #runHandler(handler, trigger, context) {
-        try {
-            const result = await handler(trigger, context);
-            return { success: true, result };
-        }
-        catch (err) {
-            this.#logger.error(`[ActionPipeline] handler 异常:`, err.message);
-            return { success: false, error: err.message };
-        }
-    }
-}

package/dist/lib/service/automation/AutomationOrchestrator.d.ts

@@ -1,86 +0,0 @@
-/**
- * AutomationOrchestrator — 自动化编排器
- * 整合 TriggerResolver + ContextCollector + ActionPipeline
- */
-import { ActionPipeline } from './ActionPipeline.js';
-import { ContextCollector } from './ContextCollector.js';
-import { TriggerResolver } from './TriggerResolver.js';
-export declare class AutomationOrchestrator {
-    #private;
-    constructor(options?: {
-        triggerResolver?: TriggerResolver;
-        contextCollector?: ContextCollector;
-        pipeline?: ActionPipeline;
-    });
-    /**
-     * 执行自动化流程
-     * @param trigger 原始触发
-     * @param context 原始上下文
-     * @returns >}
-     */
-    run(trigger: string | Record<string, unknown>, context?: Record<string, unknown>): Promise<{
-        resolvedTrigger: {
-            type: string;
-            name: string;
-            params: {
-                option: string;
-            };
-            raw: string;
-        } | {
-            type: string;
-            name: string;
-            params: {
-                option?: undefined;
-            };
-            raw: string;
-        } | {
-            type: string;
-            name: string;
-            params: Record<string, unknown>;
-            raw: Record<string, unknown>;
-        } | {
-            type: string;
-            raw: never;
-            name?: undefined;
-            params?: undefined;
-        };
-        success: boolean;
-        result: unknown;
-        error?: undefined;
-    } | {
-        resolvedTrigger: {
-            type: string;
-            name: string;
-            params: {
-                option: string;
-            };
-            raw: string;
-        } | {
-            type: string;
-            name: string;
-            params: {
-                option?: undefined;
-            };
-            raw: string;
-        } | {
-            type: string;
-            name: string;
-            params: Record<string, unknown>;
-            raw: Record<string, unknown>;
-        } | {
-            type: string;
-            raw: never;
-            name?: undefined;
-            params?: undefined;
-        };
-        success: boolean;
-        error: string;
-        result?: undefined;
-    }>;
-    /** 注册动作处理器 */
-    registerAction(type: string, handler: (trigger: Record<string, unknown>, context: Record<string, unknown>) => Promise<unknown>): void;
-    /** 获取执行历史 */
-    getHistory(): Record<string, unknown>[];
-    /** 获取管线 */
-    getPipeline(): ActionPipeline;
-}

package/dist/lib/service/automation/AutomationOrchestrator.js

@@ -1,57 +0,0 @@
-/**
- * AutomationOrchestrator — 自动化编排器
- * 整合 TriggerResolver + ContextCollector + ActionPipeline
- */
-import Logger from '../../infrastructure/logging/Logger.js';
-import { ActionPipeline } from './ActionPipeline.js';
-import { ContextCollector } from './ContextCollector.js';
-import { TriggerResolver } from './TriggerResolver.js';
-export class AutomationOrchestrator {
-    #triggerResolver;
-    #contextCollector;
-    #pipeline;
-    #logger;
-    #history;
-    constructor(options = {}) {
-        this.#triggerResolver = options.triggerResolver || new TriggerResolver();
-        this.#contextCollector = options.contextCollector || new ContextCollector();
-        this.#pipeline = options.pipeline || new ActionPipeline();
-        this.#logger = Logger.getInstance();
-        this.#history = [];
-    }
-    /**
-     * 执行自动化流程
-     * @param trigger 原始触发
-     * @param context 原始上下文
-     * @returns >}
-     */
-    async run(trigger, context = {}) {
-        const resolvedTrigger = this.#triggerResolver.resolve(trigger);
-        const collectedContext = this.#contextCollector.collect(context);
-        this.#logger.info(`[AutomationOrchestrator] run type=${resolvedTrigger.type} name=${resolvedTrigger.name || ''}`);
-        const pipelineResult = await this.#pipeline.execute(resolvedTrigger, collectedContext);
-        const record = {
-            trigger: resolvedTrigger,
-            context: { filePath: collectedContext.filePath, language: collectedContext.language },
-            result: pipelineResult,
-            timestamp: new Date().toISOString(),
-        };
-        this.#history.push(record);
-        if (this.#history.length > 200) {
-            this.#history = this.#history.slice(-200);
-        }
-        return { ...pipelineResult, resolvedTrigger };
-    }
-    /** 注册动作处理器 */
-    registerAction(type, handler) {
-        this.#pipeline.register(type, handler);
-    }
-    /** 获取执行历史 */
-    getHistory() {
-        return [...this.#history];
-    }
-    /** 获取管线 */
-    getPipeline() {
-        return this.#pipeline;
-    }
-}

package/dist/lib/service/automation/ContextCollector.d.ts

@@ -1,24 +0,0 @@
-/**
- * ContextCollector — 自动化上下文收集器
- * 收集并规范化自动化执行所需的上下文信息
- */
-export declare class ContextCollector {
-    #private;
-    /**
-     * 收集上下文
-     * @param rawContext 原始上下文
-     * @returns 规范化的上下文
-     */
-    collect(rawContext?: Record<string, unknown>): {
-        filePath: {} | null;
-        content: {} | null;
-        language: {} | null;
-        projectRoot: {} | null;
-        user: {};
-        timestamp: string;
-        environment: {
-            platform: NodeJS.Platform;
-            nodeVersion: string;
-        };
-    };
-}

package/dist/lib/service/automation/ContextCollector.js

@@ -1,35 +0,0 @@
-/**
- * ContextCollector — 自动化上下文收集器
- * 收集并规范化自动化执行所需的上下文信息
- */
-import { LanguageService } from '../../shared/LanguageService.js';
-export class ContextCollector {
-    /**
-     * 收集上下文
-     * @param rawContext 原始上下文
-     * @returns 规范化的上下文
-     */
-    collect(rawContext = {}) {
-        return {
-            ...rawContext,
-            filePath: rawContext.filePath || null,
-            content: rawContext.content || null,
-            language: rawContext.language ||
-                this.#detectLanguage(rawContext.filePath),
-            projectRoot: rawContext.projectRoot || null,
-            user: rawContext.user || 'default',
-            timestamp: new Date().toISOString(),
-            environment: {
-                platform: process.platform,
-                nodeVersion: process.version,
-            },
-        };
-    }
-    #detectLanguage(filePath) {
-        if (!filePath) {
-            return null;
-        }
-        const lang = LanguageService.inferLang(filePath);
-        return lang === 'unknown' ? null : lang;
-    }
-}

package/dist/lib/service/automation/DirectiveDetector.d.ts

@@ -1,51 +0,0 @@
-/**
- * DirectiveDetector - 文件内指令检测器
- *
- * 检测 // as:c（创建）、// as:s（搜索）、// as:a（审计）等指令
- * V2 ESM 版本，对应 V1 DirectiveDetector.js
- */
-/** 指令标记常量 */
-export declare const MARKS: {
-    HEADER_INCLUDE: string;
-    HEADER_IMPORT: string;
-    HEADER_INCLUDE_SHORT: string;
-    HEADER_IMPORT_SHORT: string;
-    CREATE_SHORT: string;
-    CREATE_ALIAS: string;
-    AUDIT_SHORT: string;
-    AUDIT_ALIAS: string;
-    SEARCH_SHORT: string;
-    SEARCH_LONG: string;
-    SEARCH_ALIAS: string;
-    ALINK: string;
-};
-/** 正则表达式 */
-export declare const REGEX: {
-    CREATE_LINE: RegExp;
-    CREATE_REMOVE: RegExp;
-    HEADER_OBJC: RegExp;
-    HEADER_SWIFT: RegExp;
-    IMPORT_OBJC: RegExp;
-    IMPORT_SWIFT: RegExp;
-    SEARCH_MARK: RegExp;
-};
-/**
- * 检测文件内容中的所有触发指令
- *
- * @param data 文件内容
- * @param filename 文件名
- * @returns {{ importArray: string[], headerLine: string|null, alinkLine: string|null,
- *             createLine: string|null, createOption: string|null,
- *             guardLine: string|null, searchLine: string|null, isSwift: boolean, language: string }}
- */
-export declare function detectTriggers(data: string, filename: string): {
-    importArray: string[];
-    headerLine: string | null;
-    alinkLine: string | null;
-    createLine: string | null;
-    createOption: string | null;
-    guardLine: string | null;
-    searchLine: string | null;
-    isSwift: boolean;
-    language: string;
-};

package/dist/lib/service/automation/DirectiveDetector.js

@@ -1,112 +0,0 @@
-/**
- * DirectiveDetector - 文件内指令检测器
- *
- * 检测 // as:c（创建）、// as:s（搜索）、// as:a（审计）等指令
- * V2 ESM 版本，对应 V1 DirectiveDetector.js
- */
-import { stripTriggerPrefix, TRIGGER_SYMBOL } from '../../infrastructure/config/TriggerSymbol.js';
-import { LanguageService } from '../../shared/LanguageService.js';
-/** 指令标记常量 */
-export const MARKS = {
-    HEADER_INCLUDE: '// autosnippet:include ',
-    HEADER_IMPORT: '// autosnippet:import ',
-    HEADER_INCLUDE_SHORT: '// as:include ',
-    HEADER_IMPORT_SHORT: '// as:import ',
-    CREATE_SHORT: '// as:create',
-    CREATE_ALIAS: '// as:c',
-    AUDIT_SHORT: '// as:audit',
-    AUDIT_ALIAS: '// as:a',
-    SEARCH_SHORT: '// as:search',
-    SEARCH_LONG: '// autosnippet:search',
-    SEARCH_ALIAS: '// as:s',
-    ALINK: 'alink',
-};
-/** 正则表达式 */
-export const REGEX = {
-    CREATE_LINE: /^\/\/\s*as:(?:create|c)(?:\s+(-[cf]))?\s*$/,
-    CREATE_REMOVE: /^@?\s*\/\/\s*as:(?:create|c)(?:\s+-[cf])?\s*\r?\n?/gm,
-    HEADER_OBJC: /^@?\/\/\s*(?:autosnippet|as):include\s+(?:<([A-Za-z0-9_]+)\/([A-Za-z0-9_+.-]+\.h)>|"([A-Za-z0-9_+./-]+\.h)")(\s+.+)?$/,
-    HEADER_SWIFT: /^@?\/\/\s*(?:autosnippet|as):import\s+\w+$/,
-    IMPORT_OBJC: /^#import\s*<[A-Za-z0-9_]+\/[A-Za-z0-9_+.-]+\.h>$/,
-    IMPORT_SWIFT: /^import\s*\w+$/,
-    SEARCH_MARK: /\/\/\s*(?:autosnippet|as):(?:search|s)(\s|$)/,
-};
-/** 推断文件语言 —— 委托给 LanguageService */
-function _inferLanguage(filename) {
-    return LanguageService.inferLang(filename);
-}
-/**
- * 检测文件内容中的所有触发指令
- *
- * @param data 文件内容
- * @param filename 文件名
- * @returns {{ importArray: string[], headerLine: string|null, alinkLine: string|null,
- *             createLine: string|null, createOption: string|null,
- *             guardLine: string|null, searchLine: string|null, isSwift: boolean, language: string }}
- */
-export function detectTriggers(data, filename) {
-    const language = _inferLanguage(filename);
-    const isSwift = language === 'swift';
-    // Import/header 自动插入目前仅支持 ObjC/Swift（Xcode 工作流）
-    const isApple = isSwift || language === 'objectivec';
-    const currImportReg = isSwift ? REGEX.IMPORT_SWIFT : REGEX.IMPORT_OBJC;
-    const _currHeaderReg = isSwift ? REGEX.HEADER_SWIFT : REGEX.HEADER_OBJC;
-    const triggers = {
-        importArray: [],
-        headerLine: null,
-        alinkLine: null,
-        createLine: null,
-        createOption: null,
-        guardLine: null,
-        searchLine: null,
-        isSwift, // backward compat
-        language, // v3.1 多语言标识
-    };
-    const lines = data.split('\n');
-    for (const line of lines) {
-        const lineVal = line.trim();
-        const normalizedLineVal = stripTriggerPrefix(lineVal);
-        // import 收集（仅 ObjC/Swift — Xcode 头文件工作流）
-        if (isApple && currImportReg.test(lineVal)) {
-            triggers.importArray.push(lineVal);
-        }
-        // header 指令
-        if (_isHeaderDirective(normalizedLineVal)) {
-            triggers.headerLine = normalizedLineVal;
-        }
-        // alink 指令
-        if (lineVal.startsWith(TRIGGER_SYMBOL) && lineVal.endsWith(TRIGGER_SYMBOL + MARKS.ALINK)) {
-            triggers.alinkLine = lineVal;
-        }
-        // create 指令
-        const createMatch = normalizedLineVal.match(REGEX.CREATE_LINE);
-        if (createMatch) {
-            triggers.createLine = lineVal;
-            triggers.createOption = createMatch[1] === '-c' ? 'c' : createMatch[1] === '-f' ? 'f' : null;
-        }
-        // guard/audit 指令
-        if (_isGuardDirective(normalizedLineVal)) {
-            triggers.guardLine = normalizedLineVal;
-        }
-        // search 指令
-        if (_isSearchDirective(normalizedLineVal)) {
-            triggers.searchLine = normalizedLineVal;
-        }
-    }
-    return triggers;
-}
-function _isHeaderDirective(line) {
-    return (line.startsWith(MARKS.HEADER_INCLUDE) ||
-        line.startsWith(MARKS.HEADER_IMPORT) ||
-        line.startsWith(MARKS.HEADER_INCLUDE_SHORT) ||
-        line.startsWith(MARKS.HEADER_IMPORT_SHORT));
-}
-function _isGuardDirective(line) {
-    // 精确匹配: // as:audit 或 // as:a，后面只能是空格或行尾
-    return /^\/\/\s*as:(?:audit|a)(?:\s|$)/.test(line);
-}
-function _isSearchDirective(line) {
-    return (line.startsWith(MARKS.SEARCH_SHORT) ||
-        line.startsWith(MARKS.SEARCH_LONG) ||
-        line.startsWith(MARKS.SEARCH_ALIAS));
-}