autosnippet 3.2.21 → 3.3.0

package/dist/lib/service/snippet/SnippetInstaller.js

@@ -1,276 +0,0 @@
-/**
- * SnippetInstaller — Codec 驱动的 Snippet 安装器
- *
- * 支持:
- *   - Xcode: 每个 snippet 一个 .codesnippet 文件
- *   - VSCode: 所有 snippets 合并为单个 .code-snippets JSON 文件
- *
- * 行为由注入的 SnippetCodec 决定。
- */
-import { existsSync, mkdirSync, readdirSync, readFileSync, unlinkSync, writeFileSync, } from 'node:fs';
-import { join } from 'node:path';
-export class SnippetInstaller {
-    #codec;
-    #snippetFactory;
-    #snippetsDirOverride;
-    /**
-     * @param options.codec IDE codec
-     * @param [options.snippetsDir] 覆盖 codec 默认目录
-     */
-    constructor(options = {}) {
-        this.#codec = options.codec || null;
-        this.#snippetFactory = options.snippetFactory || null;
-        this.#snippetsDirOverride = options.snippetsDir || null;
-    }
-    /** codec ID ('xcode' | 'vscode') */
-    get target() {
-        return this.#codec?.id || 'unknown';
-    }
-    /** 当前安装目录 */
-    get snippetsDir() {
-        return this.#snippetsDirOverride || this.#codec?.getInstallDir(process.cwd()) || '';
-    }
-    setSnippetFactory(factory) {
-        this.#snippetFactory = factory;
-    }
-    setCodec(codec) {
-        this.#codec = codec;
-    }
-    // ─────────────── 安装 ───────────────
-    /**
-     * 安装单个 snippet spec
-     * @param spec SnippetSpec
-     * @param [projectRoot] VSCode 需要 projectRoot 确定 .vscode/ 路径
-     * @returns }
-     */
-    install(spec, projectRoot) {
-        this.#assertCodec();
-        const codec = this.#codec;
-        try {
-            const dir = this.#resolveDir(projectRoot);
-            this.#ensureDir(dir);
-            const bundleFilename = codec.getBundleFilename();
-            if (bundleFilename) {
-                // Bundle 模式 (VSCode): merge into single JSON file
-                return this.#installToBundle(spec, dir, bundleFilename);
-            }
-            // Per-file 模式 (Xcode): 每个 snippet 一个文件
-            const content = codec.generate(spec);
-            const filename = `${spec.identifier}${codec.fileExtension}`;
-            const filePath = join(dir, filename);
-            writeFileSync(filePath, content);
-            return { success: true, path: filePath, message: `Installed: ${filename}` };
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            return { success: false, path: '', message };
-        }
-    }
-    /**
-     * 从 Recipe 批量安装
-     * @returns }
-     */
-    installFromRecipes(recipes, projectRoot) {
-        this.#assertCodec();
-        this.#assertFactory();
-        const codec = this.#codec;
-        const factory = this.#snippetFactory;
-        const dir = this.#resolveDir(projectRoot);
-        this.#ensureDir(dir);
-        const specs = recipes.map((r) => factory.fromRecipe(r));
-        const bundleFilename = codec.getBundleFilename();
-        if (bundleFilename) {
-            // Bundle 模式: 一次性写入整个 bundle
-            return this.#installBundleFromSpecs(specs, dir, bundleFilename, recipes.length);
-        }
-        // Per-file 模式
-        const details = [];
-        let successCount = 0;
-        let errorCount = 0;
-        for (const spec of specs) {
-            const result = this.install(spec, projectRoot);
-            details.push(result);
-            if (result.success) {
-                successCount++;
-            }
-            else {
-                errorCount++;
-            }
-        }
-        return { success: errorCount === 0, count: recipes.length, successCount, errorCount, details };
-    }
-    // ─────────────── 查询 ───────────────
-    /**
-     * 列出已安装的 AutoSnippet 管理的 snippet
-     * @returns >}
-     */
-    listInstalled(projectRoot) {
-        const dir = this.#resolveDir(projectRoot);
-        if (!existsSync(dir)) {
-            return [];
-        }
-        const bundleFilename = this.#codec?.getBundleFilename();
-        if (bundleFilename) {
-            // VSCode: 检查 bundle 文件是否存在
-            const bundlePath = join(dir, bundleFilename);
-            if (!existsSync(bundlePath)) {
-                return [];
-            }
-            try {
-                const content = JSON.parse(readFileSync(bundlePath, 'utf-8'));
-                return Object.keys(content).map((key) => ({
-                    filename: key,
-                    path: bundlePath,
-                }));
-            }
-            catch {
-                return [];
-            }
-        }
-        // Xcode: 列出 com.autosnippet.*.codesnippet 文件
-        return readdirSync(dir)
-            .filter((f) => f.startsWith('com.autosnippet.') &&
-            f.endsWith(this.#codec?.fileExtension || '.codesnippet'))
-            .map((f) => ({ filename: f, path: join(dir, f) }));
-    }
-    // ─────────────── 卸载 ───────────────
-    /**
-     * 卸载指定 snippet
-     * @returns }
-     */
-    uninstall(identifier, projectRoot) {
-        const dir = this.#resolveDir(projectRoot);
-        const bundleFilename = this.#codec?.getBundleFilename();
-        if (bundleFilename) {
-            // VSCode: 从 bundle JSON 中移除对应 key
-            return this.#removeFromBundle(identifier, dir, bundleFilename);
-        }
-        // Xcode: 删除单个文件
-        const ext = this.#codec?.fileExtension || '.codesnippet';
-        const filename = identifier.endsWith(ext) ? identifier : `${identifier}${ext}`;
-        const filePath = join(dir, filename);
-        if (!existsSync(filePath)) {
-            return { success: false, message: `Not found: ${filename}` };
-        }
-        unlinkSync(filePath);
-        return { success: true, message: `Uninstalled: ${filename}` };
-    }
-    /**
-     * 清除所有 AutoSnippet 管理的 snippet
-     * @returns }
-     */
-    cleanAll(projectRoot) {
-        const dir = this.#resolveDir(projectRoot);
-        const bundleFilename = this.#codec?.getBundleFilename();
-        if (bundleFilename) {
-            // VSCode: 删除整个 bundle 文件
-            const bundlePath = join(dir, bundleFilename);
-            if (existsSync(bundlePath)) {
-                unlinkSync(bundlePath);
-                return { success: true, removed: 1 };
-            }
-            return { success: true, removed: 0 };
-        }
-        // Xcode: 删除所有 com.autosnippet.* 文件
-        const installed = this.listInstalled(projectRoot);
-        let removed = 0;
-        for (const { path: filePath } of installed) {
-            try {
-                unlinkSync(filePath);
-                removed++;
-            }
-            catch {
-                /* ignore */
-            }
-        }
-        return { success: true, removed };
-    }
-    // ─────────────── Private ───────────────
-    #assertCodec() {
-        if (!this.#codec) {
-            throw new Error('SnippetCodec not set');
-        }
-    }
-    #assertFactory() {
-        if (!this.#snippetFactory) {
-            throw new Error('SnippetFactory not set');
-        }
-    }
-    #resolveDir(projectRoot) {
-        if (this.#snippetsDirOverride) {
-            return this.#snippetsDirOverride;
-        }
-        return this.#codec?.getInstallDir(projectRoot || process.cwd()) || '';
-    }
-    #ensureDir(dir) {
-        if (!existsSync(dir)) {
-            mkdirSync(dir, { recursive: true });
-        }
-    }
-    /** VSCode bundle: 将单个 spec 追加/更新到 bundle JSON */
-    #installToBundle(spec, dir, bundleFilename) {
-        const bundlePath = join(dir, bundleFilename);
-        let bundle = {};
-        if (existsSync(bundlePath)) {
-            try {
-                bundle = JSON.parse(readFileSync(bundlePath, 'utf-8'));
-            }
-            catch {
-                bundle = {};
-            }
-        }
-        const key = `Recipe: ${spec.title || spec.identifier}`;
-        const content = JSON.parse(this.#codec.generate(spec));
-        const entryKey = Object.keys(content)[0];
-        bundle[key] = content[entryKey];
-        writeFileSync(bundlePath, `${JSON.stringify(bundle, null, 2)}\n`);
-        return { success: true, path: bundlePath, message: `Installed: ${key}` };
-    }
-    /** VSCode bundle: 一次性写入完整 bundle */
-    #installBundleFromSpecs(specs, dir, bundleFilename, totalCount) {
-        try {
-            const content = this.#codec.generateBundle(specs);
-            const bundlePath = join(dir, bundleFilename);
-            writeFileSync(bundlePath, typeof content === 'string' ? content : JSON.stringify(content, null, 2));
-            return {
-                success: true,
-                count: totalCount,
-                successCount: totalCount,
-                errorCount: 0,
-                details: [{ success: true, path: bundlePath, message: `Bundle: ${totalCount} snippets` }],
-            };
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            return {
-                success: false,
-                count: totalCount,
-                successCount: 0,
-                errorCount: totalCount,
-                details: [{ success: false, path: '', message }],
-            };
-        }
-    }
-    /** VSCode bundle: 从 JSON 中移除一个 snippet */
-    #removeFromBundle(identifier, dir, bundleFilename) {
-        const bundlePath = join(dir, bundleFilename);
-        if (!existsSync(bundlePath)) {
-            return { success: false, message: `Bundle not found: ${bundleFilename}` };
-        }
-        try {
-            const bundle = JSON.parse(readFileSync(bundlePath, 'utf-8'));
-            // 按 identifier 或 title 匹配
-            const keyToRemove = Object.keys(bundle).find((k) => k.includes(identifier) || k === `Recipe: ${identifier}`);
-            if (!keyToRemove) {
-                return { success: false, message: `Snippet not found in bundle: ${identifier}` };
-            }
-            delete bundle[keyToRemove];
-            writeFileSync(bundlePath, `${JSON.stringify(bundle, null, 2)}\n`);
-            return { success: true, message: `Uninstalled: ${keyToRemove}` };
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            return { success: false, message };
-        }
-    }
-}

package/dist/lib/service/snippet/codecs/SnippetCodec.d.ts

@@ -1,44 +0,0 @@
-/**
- * SnippetCodec — IDE Snippet 格式抽象接口
- *
- * 子类实现:
- *   - XcodeCodec  (.codesnippet plist XML)
- *   - VSCodeCodec (.code-snippets JSON, 兼容 Cursor)
- *
- * SnippetSpec 结构 (IDE 无关中间表示):
- *   { identifier, title, completion, summary, code, language }
- */
-export interface SnippetSpec {
-    identifier: string;
-    title?: string;
-    completion?: string;
-    trigger?: string;
-    summary?: string;
-    code?: string | string[];
-    language?: string;
-    [key: string]: unknown;
-}
-export declare class SnippetCodec {
-    /** @returns codec 标识 ('xcode' | 'vscode') */
-    get id(): string;
-    /** 输出文件的扩展名 ('.codesnippet' | '.code-snippets') */
-    get fileExtension(): string;
-    /** 单个 SnippetSpec → IDE 格式字符串 */
-    generate(spec: SnippetSpec): string;
-    /**
-     * 批量 specs → IDE 格式输出
-     *   Xcode:  返回 Array<{ filename, content }>（每个 snippet 一个文件）
-     *   VSCode: 返回 string（单个 JSON bundle 文件内容）
-     * @returns >}
-     */
-    generateBundle(specs: SnippetSpec[]): string | Array<{
-        filename: string;
-        content: string;
-    }>;
-    /** 目标 snippet 安装目录路径 */
-    getInstallDir(projectRoot?: string): string;
-    /** AutoSnippet 语言标识 → IDE 语言标识映射 */
-    mapLanguage(lang: string): string;
-    /** 获取 bundle 文件名 (VSCode = 'autosnippet.code-snippets', Xcode = per-file) */
-    getBundleFilename(): string | null;
-}

package/dist/lib/service/snippet/codecs/SnippetCodec.js

@@ -1,35 +0,0 @@
-export class SnippetCodec {
-    /** @returns codec 标识 ('xcode' | 'vscode') */
-    get id() {
-        throw new Error('SnippetCodec.id is abstract');
-    }
-    /** 输出文件的扩展名 ('.codesnippet' | '.code-snippets') */
-    get fileExtension() {
-        throw new Error('SnippetCodec.fileExtension is abstract');
-    }
-    /** 单个 SnippetSpec → IDE 格式字符串 */
-    generate(spec) {
-        throw new Error('SnippetCodec.generate() is abstract');
-    }
-    /**
-     * 批量 specs → IDE 格式输出
-     *   Xcode:  返回 Array<{ filename, content }>（每个 snippet 一个文件）
-     *   VSCode: 返回 string（单个 JSON bundle 文件内容）
-     * @returns >}
-     */
-    generateBundle(specs) {
-        throw new Error('SnippetCodec.generateBundle() is abstract');
-    }
-    /** 目标 snippet 安装目录路径 */
-    getInstallDir(projectRoot) {
-        throw new Error('SnippetCodec.getInstallDir() is abstract');
-    }
-    /** AutoSnippet 语言标识 → IDE 语言标识映射 */
-    mapLanguage(lang) {
-        throw new Error('SnippetCodec.mapLanguage() is abstract');
-    }
-    /** 获取 bundle 文件名 (VSCode = 'autosnippet.code-snippets', Xcode = per-file) */
-    getBundleFilename() {
-        return null;
-    }
-}

package/dist/lib/service/snippet/codecs/VSCodeCodec.d.ts

@@ -1,27 +0,0 @@
-/**
- * VSCodeCodec — VSCode .code-snippets (JSON) 生成器
- *
- * 特性:
- *   - 项目级 .vscode/autosnippet.code-snippets 单 bundle 文件
- *   - 兼容 Cursor (100% VSCode snippet 格式)
- *   - Xcode 占位符 <#…#> 自动转换为 VSCode ${N:…}
- *   - 多语言 scope 自动映射
- */
-import type { SnippetSpec } from './SnippetCodec.js';
-import { SnippetCodec } from './SnippetCodec.js';
-export declare class VSCodeCodec extends SnippetCodec {
-    #private;
-    get id(): string;
-    get fileExtension(): string;
-    /** 单个 SnippetSpec → JSON 字符串 */
-    generate(spec: SnippetSpec): string;
-    /**
-     * VSCode: 所有 snippets 合并为单个 JSON bundle 文件
-     * @returns JSON 字符串
-     */
-    generateBundle(specs: SnippetSpec[]): string;
-    /** VSCode snippets 安装目录 = 项目级 .vscode/ */
-    getInstallDir(projectRoot: string): string;
-    mapLanguage(lang: string): string;
-    getBundleFilename(): string;
-}

package/dist/lib/service/snippet/codecs/VSCodeCodec.js

@@ -1,82 +0,0 @@
-/**
- * VSCodeCodec — VSCode .code-snippets (JSON) 生成器
- *
- * 特性:
- *   - 项目级 .vscode/autosnippet.code-snippets 单 bundle 文件
- *   - 兼容 Cursor (100% VSCode snippet 格式)
- *   - Xcode 占位符 <#…#> 自动转换为 VSCode ${N:…}
- *   - 多语言 scope 自动映射
- */
-import { join } from 'node:path';
-import { PlaceholderConverter } from '#platform/ios/snippet/PlaceholderConverter.js';
-import { SnippetCodec } from './SnippetCodec.js';
-/** AutoSnippet language → VSCode snippet scope */
-const VSCODE_LANGUAGE_MAP = {
-    swift: 'swift',
-    'objective-c': 'objective-c',
-    objc: 'objective-c',
-    c: 'c',
-    'c++': 'cpp',
-    go: 'go',
-    python: 'python',
-    java: 'java',
-    kotlin: 'kotlin',
-    javascript: 'javascript,javascriptreact',
-    typescript: 'typescript,typescriptreact',
-    rust: 'rust',
-    ruby: 'ruby',
-};
-const BUNDLE_FILENAME = 'autosnippet.code-snippets';
-export class VSCodeCodec extends SnippetCodec {
-    get id() {
-        return 'vscode';
-    }
-    get fileExtension() {
-        return '.code-snippets';
-    }
-    /** 单个 SnippetSpec → JSON 字符串 */
-    generate(spec) {
-        const entry = this.#specToEntry(spec);
-        return JSON.stringify({ [spec.title || spec.identifier]: entry }, null, 2);
-    }
-    /**
-     * VSCode: 所有 snippets 合并为单个 JSON bundle 文件
-     * @returns JSON 字符串
-     */
-    generateBundle(specs) {
-        const bundle = {};
-        for (const spec of specs) {
-            const key = `Recipe: ${spec.title || spec.identifier}`;
-            bundle[key] = this.#specToEntry(spec);
-        }
-        return `${JSON.stringify(bundle, null, 2)}\n`;
-    }
-    /** VSCode snippets 安装目录 = 项目级 .vscode/ */
-    getInstallDir(projectRoot) {
-        return join(projectRoot, '.vscode');
-    }
-    mapLanguage(lang) {
-        return VSCODE_LANGUAGE_MAP[lang?.toLowerCase()] || '';
-    }
-    getBundleFilename() {
-        return BUNDLE_FILENAME;
-    }
-    /** SnippetSpec → VSCode snippet entry */
-    #specToEntry(spec) {
-        const code = Array.isArray(spec.code) ? spec.code.join('\n') : spec.code || '';
-        // 自动将 Xcode 占位符转为 VSCode 格式
-        const converted = PlaceholderConverter.xcodeToVSCode(code);
-        const body = converted.split('\n');
-        const entry = {
-            prefix: spec.completion || spec.trigger || spec.identifier,
-            body,
-            description: spec.summary || '',
-        };
-        // 添加语言 scope (空字符串 = 所有语言)
-        const scope = this.mapLanguage(spec.language || '');
-        if (scope) {
-            entry.scope = scope;
-        }
-        return entry;
-    }
-}

package/dist/scripts/build-native-ui.d.ts

@@ -1,3 +0,0 @@
-#!/usr/bin/env node
-/** 在 macOS 上构建 native-ui 辅助程序（可选） */
-export {};

package/dist/scripts/build-native-ui.js

@@ -1,62 +0,0 @@
-#!/usr/bin/env node
-/** 在 macOS 上构建 native-ui 辅助程序（可选） */
-const __dirname = import.meta.dirname;
-import { execSync } from 'node:child_process';
-import fs from 'node:fs';
-import path from 'node:path';
-import { PACKAGE_ROOT } from '../lib/shared/package-root.js';
-if (process.platform !== 'darwin') {
-    process.exit(0);
-}
-const root = PACKAGE_ROOT;
-const src = path.join(root, 'resources', 'native-ui', 'main.swift');
-const combinedSrc = path.join(root, 'resources', 'native-ui', 'combined-window.swift');
-const out = path.join(root, 'resources', 'native-ui', 'native-ui');
-// 检查是否在发布流程中（npm publish 会设置 npm_lifecycle_event）
-const isPublishing = process.env.npm_lifecycle_event === 'prepublishOnly';
-try {
-    // 编译 native-ui（包含所有源文件）
-    execSync(`swiftc "${src}" "${combinedSrc}" -o "${out}" -framework AppKit`, {
-        cwd: root,
-        stdio: 'pipe',
-    });
-    // 验证构建结果
-    if (fs.existsSync(out)) {
-    }
-}
-catch (_err) {
-    // 如果在发布流程中构建失败，应该报错
-    if (isPublishing) {
-        console.error('❌ Native UI 构建失败（发布流程中）');
-        console.error('请确保：');
-        console.error('  1. 当前系统是 macOS');
-        console.error('  2. 已安装 Xcode Command Line Tools: xcode-select --install');
-        console.error('  3. Swift 编译器可用: which swiftc');
-        process.exit(1);
-    }
-    // 在用户安装时，如果已有预编译的二进制文件，静默跳过
-    if (fs.existsSync(out)) {
-    }
-    else {
-    }
-}
-// ── 发布流程：最终校验二进制必须存在 ──
-if (isPublishing) {
-    if (!fs.existsSync(out)) {
-        console.error('❌ 发布中止：native-ui 二进制不存在于', out);
-        console.error('   prepublishOnly 编译步骤可能被跳过或失败');
-        process.exit(1);
-    }
-    const stat = fs.statSync(out);
-    if (stat.size < 10_000) {
-        console.error('❌ 发布中止：native-ui 二进制异常（仅', stat.size, '字节）');
-        process.exit(1);
-    }
-    // 确保有执行权限
-    try {
-        fs.chmodSync(out, 0o755);
-    }
-    catch {
-        /* ignore */
-    }
-}

package/dist/scripts/init-snippets.d.ts

@@ -1,30 +0,0 @@
-#!/usr/bin/env node
-/**
- * Snippet 统一初始化脚本
- *
- * 为 AutoSnippet 生成快速触发 Snippet（ass/asc/asa）到目标 IDE:
- *   - Xcode: ~/Library/Developer/Xcode/UserData/CodeSnippets/*.codesnippet
- *   - VSCode: .vscode/autosnippet-triggers.code-snippets (项目级)
- *
- * 用法:
- *   node scripts/init-snippets.js [init|list|remove] [--target xcode|vscode|all]
- *   npm run init:snippets
- */
-export declare class SnippetInitializer {
-    vscode: any;
-    xcode: any;
-    constructor(projectRoot: any);
-    /**
-     * 初始化 snippet 到指定目标
-     * @param target — 'xcode' | 'vscode' | 'all'
-     * @returns }
-     */
-    initialize(target?: string): Promise<any>;
-    list(target?: string): any;
-    remove(target?: string): any;
-}
-declare const _default: {
-    SnippetInitializer: typeof SnippetInitializer;
-    initialize: (projectRoot: any, target: any) => Promise<any>;
-};
-export default _default;