@aster-cloud/aster-lang-ts 0.0.1

package/dist/src/cli/utils/error-handler.d.ts

@@ -0,0 +1,4 @@
+import type { Diagnostic } from '../../diagnostics/diagnostics.js';
+export declare function createDiagnosticsError(diagnostics: Diagnostic[]): Error;
+export declare function handleError(error: unknown): void;
+//# sourceMappingURL=error-handler.d.ts.map

package/dist/src/cli/utils/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../../../src/cli/utils/error-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAuEnE,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,KAAK,CAIvE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CA4BhD"}

package/dist/src/cli/utils/error-handler.js

@@ -0,0 +1,91 @@
+import { DiagnosticError } from '../../diagnostics/diagnostics.js';
+import { error as logError, warn as logWarn } from './logger.js';
+function isDiagnosticArray(value) {
+    return Array.isArray(value) && value.every(item => typeof item?.code === 'string');
+}
+function isDiagnosticCarrier(error) {
+    return Boolean(error && typeof error === 'object' && 'diagnostics' in error && isDiagnosticArray(error.diagnostics));
+}
+function isNodeError(error) {
+    return Boolean(error && typeof error === 'object' && 'code' in error && typeof error.code === 'string');
+}
+function classify(code) {
+    if (code.startsWith('R00'))
+        return 'network';
+    if (code.startsWith('V00'))
+        return 'conflict';
+    if (code.startsWith('M00'))
+        return 'manifest';
+    if (code.startsWith('C00'))
+        return 'filesystem';
+    return 'unknown';
+}
+function hintFor(code) {
+    switch (classify(code)) {
+        case 'network':
+            return '网络请求失败，请确认联网状态或切换 --registry=local';
+        case 'conflict':
+            return '依赖版本冲突，请尝试指定更精确的版本范围';
+        case 'manifest':
+            return 'manifest.json 存在格式问题，请按照 schema 修复后重试';
+        case 'filesystem':
+            return '本地缓存或文件权限异常，请检查 .aster 目录权限';
+        default:
+            return null;
+    }
+}
+function printDiagnostics(diags) {
+    for (const diag of diags) {
+        logError(`[${diag.code}] ${diag.message}`);
+        const hint = hintFor(diag.code);
+        if (hint) {
+            logWarn(hint);
+        }
+    }
+}
+function handleNodeError(error) {
+    const code = error.code ?? 'UNKNOWN';
+    switch (code) {
+        case 'EACCES':
+        case 'EPERM':
+            logError(`文件权限不足：${error.message}`);
+            break;
+        case 'ENOENT':
+            logError(`未找到目标文件：${error.message}`);
+            break;
+        default:
+            logError(`文件系统错误(${code})：${error.message}`);
+            break;
+    }
+}
+export function createDiagnosticsError(diagnostics) {
+    const error = new Error('CLI_DIAGNOSTIC_ERROR');
+    error.diagnostics = diagnostics;
+    return error;
+}
+export function handleError(error) {
+    if (error instanceof DiagnosticError) {
+        printDiagnostics([error.diagnostic]);
+        process.exit(1);
+    }
+    if (isDiagnosticCarrier(error)) {
+        printDiagnostics(error.diagnostics ?? []);
+        process.exit(1);
+    }
+    if (isDiagnosticArray(error)) {
+        printDiagnostics(error);
+        process.exit(1);
+    }
+    if (isNodeError(error)) {
+        handleNodeError(error);
+        process.exit(1);
+    }
+    if (error instanceof Error) {
+        logError(error.message);
+    }
+    else {
+        logError('发生未知错误，请重试');
+    }
+    process.exit(1);
+}
+//# sourceMappingURL=error-handler.js.map

package/dist/src/cli/utils/error-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.js","sourceRoot":"","sources":["../../../../src/cli/utils/error-handler.ts"],"names":[],"mappings":"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"}

package/dist/src/cli/utils/logger.d.ts

@@ -0,0 +1,8 @@
+/**
+ * CLI 专用日志工具，提供带颜色的统一输出格式。
+ */
+export declare function info(message: string): void;
+export declare function success(message: string): void;
+export declare function warn(message: string): void;
+export declare function error(message: string): void;
+//# sourceMappingURL=logger.d.ts.map

package/dist/src/cli/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../../src/cli/utils/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAgBH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE7C;AAED,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE3C"}

package/dist/src/cli/utils/logger.js

@@ -0,0 +1,20 @@
+/**
+ * CLI 专用日志工具，提供带颜色的统一输出格式。
+ */
+function colorize(symbol, message, color) {
+    return `${color}${symbol}${"\u001B[0m" /* AnsiColor.Reset */} ${message}`;
+}
+// 使用 Unicode 符号满足“绿色✓/红色✗/黄色⚠”的输出规范。
+export function info(message) {
+    console.log(colorize('ℹ', message, "\u001B[36m" /* AnsiColor.Cyan */));
+}
+export function success(message) {
+    console.log(colorize('✓', message, "\u001B[32m" /* AnsiColor.Green */));
+}
+export function warn(message) {
+    console.warn(colorize('⚠', message, "\u001B[33m" /* AnsiColor.Yellow */));
+}
+export function error(message) {
+    console.error(colorize('✗', message, "\u001B[31m" /* AnsiColor.Red */));
+}
+//# sourceMappingURL=logger.js.map

package/dist/src/cli/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../../src/cli/utils/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH,SAAS,QAAQ,CAAC,MAAc,EAAE,OAAe,EAAE,KAAgB;IACjE,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,iCAAe,IAAI,OAAO,EAAE,CAAC;AAC1D,CAAC;AAED,qCAAqC;AAErC,MAAM,UAAU,IAAI,CAAC,OAAe;IAClC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,OAAO,oCAAiB,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,OAAe;IACrC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,OAAO,qCAAkB,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,OAAe;IAClC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,OAAO,sCAAmB,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,OAAe;IACnC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,EAAE,OAAO,mCAAgB,CAAC,CAAC;AACvD,CAAC"}

package/dist/src/config/config-service.d.ts

@@ -0,0 +1,79 @@
+/**
+ * @module config-service
+ *
+ * 统一配置管理服务：集中管理所有环境变量配置。
+ *
+ * **设计目标**：
+ * - 单一数据源：所有配置从 ConfigService 获取，避免散落的 process.env 访问
+ * - 类型安全：提供强类型配置接口，在启动时校验配置有效性
+ * - 可测试性：支持测试环境下重置配置
+ * - 延迟初始化：使用单例模式，首次访问时初始化
+ *
+ * **使用方式**：
+ * ```typescript
+ * import { ConfigService } from './config/config-service.js';
+ *
+ * const config = ConfigService.getInstance();
+ * if (config.effectsEnforce) {
+ *   // 效果系统强制执行逻辑
+ * }
+ * ```
+ */
+import { LogLevel } from '../utils/logger.js';
+/**
+ * 配置服务单例类。
+ *
+ * 在首次调用 getInstance() 时初始化，从环境变量读取所有配置。
+ * 配置项在实例生命周期内保持不变（只读）。
+ */
+export declare class ConfigService {
+    private static instance;
+    /** 是否强制执行效果能力检查（默认 true，设置 ASTER_CAP_EFFECTS_ENFORCE=0 可禁用） */
+    readonly effectsEnforce: boolean;
+    /** 效果配置文件路径（默认 .aster/effects.json） */
+    readonly effectConfigPath: string;
+    /** 缓存实例初始化时使用的效果配置路径，便于检测环境变量变更 */
+    readonly cachedEffectConfigPath: string;
+    /** 日志级别（默认 INFO） */
+    readonly logLevel: LogLevel;
+    /** 能力清单文件路径（可选，用于 LSP 诊断） */
+    readonly capsManifestPath: string | null;
+    /** 是否启用调试类型输出（默认 false，设置 ASTER_DEBUG_TYPES=1 启用） */
+    readonly debugTypes: boolean;
+    /**
+     * 私有构造函数，确保只能通过 getInstance() 创建实例。
+     */
+    private constructor();
+    /**
+     * 解析 LOG_LEVEL 环境变量为 LogLevel 枚举值。
+     *
+     * @param raw - 原始环境变量值
+     * @returns 解析后的 LogLevel，默认 INFO
+     */
+    private parseLogLevel;
+    /**
+     * 校验配置的有效性。
+     *
+     * 当前实现为占位符，未来可添加更多校验逻辑：
+     * - 检查文件路径是否可访问
+     * - 验证配置值的取值范围
+     * - 检查依赖配置的一致性
+     */
+    private validate;
+    /**
+     * 获取 ConfigService 单例实例。
+     *
+     * 首次调用时创建实例，后续调用返回同一实例。
+     *
+     * @returns ConfigService 实例
+     */
+    static getInstance(): ConfigService;
+    /**
+     * 重置单例实例（仅用于测试）。
+     *
+     * **警告**：此方法仅应在测试环境中使用，生产代码不应调用。
+     * 重置后，下次调用 getInstance() 会重新读取环境变量。
+     */
+    static resetForTesting(): void;
+}
+//# sourceMappingURL=config-service.d.ts.map

package/dist/src/config/config-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-service.d.ts","sourceRoot":"","sources":["../../../src/config/config-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA8B;IAErD,+DAA+D;IAC/D,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IAEjC,uCAAuC;IACvC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAElC,mCAAmC;IACnC,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IAExC,oBAAoB;IACpB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAE5B,6BAA6B;IAC7B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzC,qDAAqD;IACrD,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAE7B;;OAEG;IACH,OAAO;IAaP;;;;;OAKG;IACH,OAAO,CAAC,aAAa;IAQrB;;;;;;;OAOG;IACH,OAAO,CAAC,QAAQ;IAMhB;;;;;;OAMG;IACH,MAAM,CAAC,WAAW,IAAI,aAAa;IAenC;;;;;OAKG;IACH,MAAM,CAAC,eAAe,IAAI,IAAI;CAG/B"}

package/dist/src/config/config-service.js

@@ -0,0 +1,112 @@
+/**
+ * @module config-service
+ *
+ * 统一配置管理服务：集中管理所有环境变量配置。
+ *
+ * **设计目标**：
+ * - 单一数据源：所有配置从 ConfigService 获取，避免散落的 process.env 访问
+ * - 类型安全：提供强类型配置接口，在启动时校验配置有效性
+ * - 可测试性：支持测试环境下重置配置
+ * - 延迟初始化：使用单例模式，首次访问时初始化
+ *
+ * **使用方式**：
+ * ```typescript
+ * import { ConfigService } from './config/config-service.js';
+ *
+ * const config = ConfigService.getInstance();
+ * if (config.effectsEnforce) {
+ *   // 效果系统强制执行逻辑
+ * }
+ * ```
+ */
+import { LogLevel } from '../utils/logger.js';
+/**
+ * 配置服务单例类。
+ *
+ * 在首次调用 getInstance() 时初始化，从环境变量读取所有配置。
+ * 配置项在实例生命周期内保持不变（只读）。
+ */
+export class ConfigService {
+    static instance = null;
+    /** 是否强制执行效果能力检查（默认 true，设置 ASTER_CAP_EFFECTS_ENFORCE=0 可禁用） */
+    effectsEnforce;
+    /** 效果配置文件路径（默认 .aster/effects.json） */
+    effectConfigPath;
+    /** 缓存实例初始化时使用的效果配置路径，便于检测环境变量变更 */
+    cachedEffectConfigPath;
+    /** 日志级别（默认 INFO） */
+    logLevel;
+    /** 能力清单文件路径（可选，用于 LSP 诊断） */
+    capsManifestPath;
+    /** 是否启用调试类型输出（默认 false，设置 ASTER_DEBUG_TYPES=1 启用） */
+    debugTypes;
+    /**
+     * 私有构造函数，确保只能通过 getInstance() 创建实例。
+     */
+    constructor() {
+        // 读取环境变量并设置默认值
+        this.effectsEnforce = process.env.ASTER_CAP_EFFECTS_ENFORCE !== '0';
+        this.effectConfigPath = process.env.ASTER_EFFECT_CONFIG || '.aster/effects.json';
+        this.cachedEffectConfigPath = this.effectConfigPath;
+        this.logLevel = this.parseLogLevel(process.env.LOG_LEVEL);
+        this.capsManifestPath = process.env.ASTER_CAPS || null;
+        this.debugTypes = process.env.ASTER_DEBUG_TYPES === '1';
+        // 启动时校验配置有效性
+        this.validate();
+    }
+    /**
+     * 解析 LOG_LEVEL 环境变量为 LogLevel 枚举值。
+     *
+     * @param raw - 原始环境变量值
+     * @returns 解析后的 LogLevel，默认 INFO
+     */
+    parseLogLevel(raw) {
+        if (!raw)
+            return LogLevel.INFO;
+        const upper = raw.toUpperCase();
+        return upper in LogLevel
+            ? LogLevel[upper]
+            : LogLevel.INFO;
+    }
+    /**
+     * 校验配置的有效性。
+     *
+     * 当前实现为占位符，未来可添加更多校验逻辑：
+     * - 检查文件路径是否可访问
+     * - 验证配置值的取值范围
+     * - 检查依赖配置的一致性
+     */
+    validate() {
+        // 占位符：未来可添加配置校验逻辑
+        // 例如：检查 effectConfigPath 文件是否存在
+        // 例如：验证 capsManifestPath 格式是否正确
+    }
+    /**
+     * 获取 ConfigService 单例实例。
+     *
+     * 首次调用时创建实例，后续调用返回同一实例。
+     *
+     * @returns ConfigService 实例
+     */
+    static getInstance() {
+        const currentEffectConfigPath = process.env.ASTER_EFFECT_CONFIG || '.aster/effects.json';
+        if (ConfigService.instance !== null &&
+            ConfigService.instance.cachedEffectConfigPath !== currentEffectConfigPath) {
+            ConfigService.instance = null;
+        }
+        if (ConfigService.instance === null) {
+            ConfigService.instance = new ConfigService();
+        }
+        return ConfigService.instance;
+    }
+    /**
+     * 重置单例实例（仅用于测试）。
+     *
+     * **警告**：此方法仅应在测试环境中使用，生产代码不应调用。
+     * 重置后，下次调用 getInstance() 会重新读取环境变量。
+     */
+    static resetForTesting() {
+        ConfigService.instance = null;
+    }
+}
+//# sourceMappingURL=config-service.js.map

package/dist/src/config/config-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-service.js","sourceRoot":"","sources":["../../../src/config/config-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C;;;;;GAKG;AACH,MAAM,OAAO,aAAa;IAChB,MAAM,CAAC,QAAQ,GAAyB,IAAI,CAAC;IAErD,+DAA+D;IACtD,cAAc,CAAU;IAEjC,uCAAuC;IAC9B,gBAAgB,CAAS;IAElC,mCAAmC;IAC1B,sBAAsB,CAAS;IAExC,oBAAoB;IACX,QAAQ,CAAW;IAE5B,6BAA6B;IACpB,gBAAgB,CAAgB;IAEzC,qDAAqD;IAC5C,UAAU,CAAU;IAE7B;;OAEG;IACH;QACE,eAAe;QACf,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,yBAAyB,KAAK,GAAG,CAAC;QACpE,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,qBAAqB,CAAC;QACjF,IAAI,CAAC,sBAAsB,GAAG,IAAI,CAAC,gBAAgB,CAAC;QACpD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC1D,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,IAAI,CAAC;QACvD,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,KAAK,GAAG,CAAC;QAExD,aAAa;QACb,IAAI,CAAC,QAAQ,EAAE,CAAC;IAClB,CAAC;IAED;;;;;OAKG;IACK,aAAa,CAAC,GAAuB;QAC3C,IAAI,CAAC,GAAG;YAAE,OAAO,QAAQ,CAAC,IAAI,CAAC;QAC/B,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;QAChC,OAAO,KAAK,IAAI,QAAQ;YACtB,CAAC,CAAE,QAAQ,CAAC,KAA8B,CAAc;YACxD,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;IACpB,CAAC;IAED;;;;;;;OAOG;IACK,QAAQ;QACd,kBAAkB;QAClB,gCAAgC;QAChC,gCAAgC;IAClC,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,WAAW;QAChB,MAAM,uBAAuB,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,qBAAqB,CAAC;QACzF,IACE,aAAa,CAAC,QAAQ,KAAK,IAAI;YAC/B,aAAa,CAAC,QAAQ,CAAC,sBAAsB,KAAK,uBAAuB,EACzE,CAAC;YACD,aAAa,CAAC,QAAQ,GAAG,IAAI,CAAC;QAChC,CAAC;QAED,IAAI,aAAa,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;YACpC,aAAa,CAAC,QAAQ,GAAG,IAAI,aAAa,EAAE,CAAC;QAC/C,CAAC;QACD,OAAO,aAAa,CAAC,QAAQ,CAAC;IAChC,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,eAAe;QACpB,aAAa,CAAC,QAAQ,GAAG,IAAI,CAAC;IAChC,CAAC"}

package/dist/src/config/effect_config.d.ts

@@ -0,0 +1,111 @@
+/**
+ * @module config/effect_config
+ *
+ * 效果推断配置模块：支持从配置文件加载自定义效果推断规则。
+ *
+ * **功能**：
+ * - 定义可配置的效果推断模式
+ * - 支持细粒度资源分类（io.http, io.sql, io.files 等）
+ * - 提供默认配置保证向后兼容
+ * - 支持环境变量 ASTER_EFFECT_CONFIG 自定义配置路径
+ *
+ * **设计原则**：
+ * - 配置文件可选，默认行为与硬编码前缀一致
+ * - 模块级缓存避免重复 I/O
+ * - 配置加载失败时静默降级到默认配置
+ */
+/**
+ * 效果推断配置接口。
+ *
+ * 定义了如何根据函数调用前缀推断效果类型。
+ * 支持细粒度分类和自定义模式扩展。
+ */
+export interface EffectInferenceConfig {
+    /**
+     * 效果推断模式配置。
+     *
+     * 每个效果类型包含一组前缀模式，当函数调用匹配这些前缀时，
+     * 推断为对应的效果。
+     */
+    patterns: {
+        /**
+         * IO 效果的细粒度分类。
+         */
+        io: {
+            /** HTTP 网络请求前缀（如 'Http.', 'fetch.'） */
+            http: string[];
+            /** SQL 数据库操作前缀（如 'Db.', 'Sql.'） */
+            sql: string[];
+            /** 文件系统操作前缀（如 'Files.', 'Fs.'） */
+            files: string[];
+            /** 密钥/凭证访问前缀（如 'Secrets.', 'vault.'） */
+            secrets: string[];
+            /** 时间相关操作前缀（如 'Time.', 'Date.'） */
+            time: string[];
+        };
+        /** CPU 密集型计算前缀（如 'Math.', 'crypto.hash'） */
+        cpu: string[];
+        /** AI 模型调用前缀（如 'AI.', 'OpenAI.'） */
+        ai: string[];
+    };
+}
+/**
+ * 配置快照结构。
+ *
+ * 记录最近一次成功加载的配置内容与文件元数据，便于后续失效检测。
+ */
+export interface EffectConfigSnapshot {
+    /** 最近一次加载的配置内容 */
+    config: EffectInferenceConfig;
+    /** 解析时使用的配置文件路径 */
+    filePath: string;
+    /** 文件最近修改时间（毫秒） */
+    mtimeMs: number;
+    /** 文件大小（字节） */
+    size: number;
+}
+/**
+ * 重置配置缓存（仅用于测试）。
+ *
+ * **警告**：此方法仅应在测试环境中使用，生产代码不应调用。
+ * 重置后，下次调用 loadEffectConfig() 会重新读取配置文件。
+ */
+export declare function resetConfigForTesting(): void;
+export declare function loadEffectConfig(): EffectInferenceConfig;
+/**
+ * 重新加载效果配置缓存。
+ *
+ * @param force - 传入 true 时先清空缓存后再加载，确保读取最新文件
+ * @returns 最新的效果推断配置
+ */
+export declare function reloadEffectConfig(force?: boolean): EffectInferenceConfig;
+/**
+ * 获取所有 IO 效果前缀（向后兼容）。
+ *
+ * 合并配置中所有 IO 子分类的前缀，返回统一数组。
+ * 等价于原 IO_PREFIXES 常量的功能。
+ *
+ * @returns IO 前缀数组
+ *
+ * @example
+ * ```typescript
+ * const ioPrefixes = getIOPrefixes();
+ * // ['Http.', 'AuthRepo.', 'ProfileSvc.', 'FeedSvc.', 'Db.', 'UUID.randomUUID']
+ * ```
+ */
+export declare function getIOPrefixes(): readonly string[];
+/**
+ * 获取所有 CPU 效果前缀（向后兼容）。
+ *
+ * 等价于原 CPU_PREFIXES 常量的功能。
+ *
+ * @returns CPU 前缀数组
+ *
+ * @example
+ * ```typescript
+ * const cpuPrefixes = getCPUPrefixes();
+ * // [] (当前默认为空)
+ * ```
+ */
+export declare function getCPUPrefixes(): readonly string[];
+//# sourceMappingURL=effect_config.d.ts.map

package/dist/src/config/effect_config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect_config.d.ts","sourceRoot":"","sources":["../../../src/config/effect_config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AASH;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;OAKG;IACH,QAAQ,EAAE;QACR;;WAEG;QACH,EAAE,EAAE;YACF,uCAAuC;YACvC,IAAI,EAAE,MAAM,EAAE,CAAC;YACf,mCAAmC;YACnC,GAAG,EAAE,MAAM,EAAE,CAAC;YACd,kCAAkC;YAClC,KAAK,EAAE,MAAM,EAAE,CAAC;YAChB,wCAAwC;YACxC,OAAO,EAAE,MAAM,EAAE,CAAC;YAClB,mCAAmC;YACnC,IAAI,EAAE,MAAM,EAAE,CAAC;SAChB,CAAC;QACF,4CAA4C;QAC5C,GAAG,EAAE,MAAM,EAAE,CAAC;QACd,oCAAoC;QACpC,EAAE,EAAE,MAAM,EAAE,CAAC;KACd,CAAC;CACH;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,kBAAkB;IAClB,MAAM,EAAE,qBAAqB,CAAC;IAC9B,mBAAmB;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,mBAAmB;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AA4CD;;;;;GAKG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AA+GD,wBAAgB,gBAAgB,IAAI,qBAAqB,CAiCxD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,UAAQ,GAAG,qBAAqB,CAKvE;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,IAAI,SAAS,MAAM,EAAE,CASjD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,IAAI,SAAS,MAAM,EAAE,CAGlD"}