@_tc/template-core 0.0.1-bate.6 → 0.0.1-bate.61

package/types/packages/core/types.d.ts

@@ -0,0 +1,145 @@
+import Koa from "koa";
+import type Router from "koa-router";
+import type { EnvReturn } from "./env";
+import type { AppPathInfo } from "./paths";
+export interface IService {
+    [key: string]: unknown;
+}
+export interface IController {
+    [key: string]: unknown;
+}
+export interface IExtends {
+    [key: string]: unknown;
+}
+export interface IMiddlewares {
+    [key: string]: unknown;
+}
+export declare namespace FrameworkAugment {
+    interface IServiceAugmented {
+    }
+    interface IControllerAugmented {
+    }
+    interface IExtendsAugmented {
+    }
+    interface IMiddlewaresAugmented {
+    }
+    interface AppConfigAugmented {
+    }
+}
+export type ICTX = Parameters<Router.IMiddleware<any, {}>>[0];
+export interface KoaAppExtensions {
+    /**
+     *  框架路径 .root
+     */
+    frameBaseDir: string;
+    /**
+     * 框架跟路径 .root/app
+     */
+    frameAppPath: string;
+    /**
+     *  使用方根路径 .root
+     */
+    baseDir: string;
+    /**
+     * 使用方 .root/app
+     */
+    businessAppPath: string;
+    /**
+     * 存着 框架 以及业务方的 app路径
+     */
+    paths: AppPathInfo[];
+    /**
+     * 服务生命周期
+     */
+    hooks: {
+        /**
+         *
+         * 服务初始化完成
+         */
+        inited?: () => void;
+        /**
+         *
+         * 服务开始初始化
+         */
+        initing?: () => void;
+    };
+    envs: EnvReturn;
+    config: FrameworkAugment.AppConfigAugmented;
+    extends: FrameworkAugment.IExtendsAugmented;
+    controller: FrameworkAugment.IControllerAugmented;
+    service: FrameworkAugment.IServiceAugmented;
+    middlewares: FrameworkAugment.IMiddlewaresAugmented;
+    model: unknown[];
+    routerSchema: Record<string, unknown>;
+    currentUseRouter: KoaRouter[];
+    options: AppOptions;
+    logger?: {
+        info: (...args: unknown[]) => void;
+        error: (...args: unknown[]) => void;
+        warn: (...args: unknown[]) => void;
+    };
+    [key: string]: unknown;
+}
+export interface AppConfigBase {
+    port?: number;
+    host?: string;
+    env?: string;
+}
+export interface AppConfig extends AppConfigBase {
+    [key: string]: unknown;
+}
+export interface StartOptions {
+    /**
+     * 写入 html.title
+     */
+    name?: string;
+    /**
+     * - 配置时，当找不到模板文件时 重定向的路径
+     * @default '/'
+     */
+    homePage?: string;
+    frameBaseDir?: string;
+    /**
+     * 如果不设置 默认为 运行目录
+     * @default process.cwd()
+     */
+    baseDir?: string;
+    /**
+     * - 可配置的 资源路径(不要输入相对路径)
+     * - 主要是配合 buildFE 修改了输出路径时使用
+     */
+    additionalPublicPaths?: string | string[];
+    /**
+     * API 访问前缀。
+     * 为空或空字符串时会使用默认值 `/api`。
+     * 配置后会影响内置项目 API 路由，以及 API 参数校验、签名校验、项目处理等中间件的路径匹配。
+     * @default '/api'
+     */
+    apiPrefix?: string;
+    /**
+     * - 页面访问前缀 默认为 /
+     * @default '/'
+     * @example
+     * - 配置 '/test'
+     * - 所有前端页面的路径以 /test开头
+     * - 如： '/test/dash'
+     *
+     */
+    pageBasePage?: string;
+}
+export interface AppOptions extends StartOptions {
+    overwriteOriginalLogs?: boolean;
+    [key: string]: unknown;
+}
+export type KoaApp = Koa & KoaAppExtensions;
+export type KoaRouter = Router & {
+    /**
+     * 路由插入层级 默认为 0
+     * 数值越小越靠前
+     */
+    level?: number;
+};
+export type KoaMiddleware = Koa.Middleware;
+export type { EnvKeys, EnvType } from "./env";
+/** 文件处理回调函数 */
+export type ProcessingFileCallbackFN = <T extends Record<string, unknown>>(fileName: string, filePath: string, isDir: boolean, tempData: T) => T | undefined;

package/types/packages/utils/getAllFilesInFolder.d.ts

@@ -0,0 +1,9 @@
+export interface GetAllFilesInFolder {
+    /**
+     *
+     * @param paths
+     * @returns filesPath
+     */
+    getAllFilesInFolder(...paths: string[]): string[];
+}
+export declare const getAllFilesInFolder: (...paths: string[]) => string[];

package/types/packages/utils/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./path";
+export * from "./loadFile";
+export * from "./getAllFilesInFolder";
+export * from "./runFileFn";

package/types/packages/utils/loadFile.d.ts

@@ -0,0 +1,20 @@
+export type PreProcessingFileCallbackFN = <T extends Record<string, any>>(filePath: string, result: T) => any;
+export type ProcessingFileCallbackFN = <T extends Record<string, any>>(fileName: string, filePath: string, isDir: boolean, tempData: T) => T | undefined;
+export type LoadFileCallbackFN = (filePath: string) => any;
+export interface LoadFileCallbackOptions {
+    loadFileCallback?: LoadFileCallbackFN;
+    processingFileCallback?: ProcessingFileCallbackFN;
+    preProcessingFileCallback?: PreProcessingFileCallbackFN;
+}
+/**
+ *
+ * @param baseDir
+ * @param key
+ * @param callbackOpt
+ */
+declare function loadFileFn<T extends Record<string, unknown>>(baseDir: string, key: string, callbackOpt?: LoadFileCallbackOptions): T;
+export { loadFileFn };
+declare const _default: {
+    loadFileFn: typeof loadFileFn;
+};
+export default _default;

package/types/packages/utils/path.d.ts

@@ -0,0 +1,24 @@
+export interface SplicingOptions {
+    /**
+     * @default '/''
+     */
+    symbol?: string;
+    /**
+     * @default before
+     */
+    position?: "after" | "before";
+}
+/**
+ *  splicing('path') : /path
+ */
+export declare function splicing(str: string, opt?: SplicingOptions): string;
+/**
+ *
+ * @param paths
+ * @description input [a,b,c] -> out a/b/c
+ *
+ * window: input [a,b,c] -> out a\b\c
+ *
+ * 拼接路径
+ */
+export declare function resolve(...paths: string[]): string;

package/types/packages/utils/runFileFn.d.ts

@@ -0,0 +1,7 @@
+type AnyFun = (...p: any[]) => any;
+type DefaultExport<T> = {
+    default?: T;
+};
+export declare function runFileFn<T = AnyFun>(file: string): T;
+export declare function runFileFn<T = AnyFun>(fileModule: DefaultExport<T> | T): T;
+export {};

package/types/scripts/vite-build/build.d.ts

@@ -0,0 +1,24 @@
+import type { BuildEntriesConfig, BuildEntriesResult } from "./types.ts";
+/**
+ * 构建库入口文件的主函数
+ * 支持多格式输出（ESM/CJS）、类型声明文件生成、路径别名、文件复制等功能
+ * @param config - 构建配置选项
+ * @param config.input - 入口文件或目录列表
+ * @param config.format - 输出格式，默认 ['es', 'cjs']
+ * @param config.outputStructure - 输出结构，'preserve' 保留源路径，'bundle' 合并输出
+ * @param config.alias - 路径别名配置
+ * @param config.external - 外部依赖配置
+ * @param config.externalNodeBuiltins - 是否将 Node.js 内置模块视为外部依赖，默认 true
+ * @param config.bundleDependencies - 是否将 npm 依赖打进产物，默认兼容 externalPackages
+ * @param config.externalPackages - 兼容旧配置：是否将所有 npm 包视为外部依赖
+ * @param config.ignore - 忽略文件配置
+ * @param config.copy - 复制文件配置
+ * @param config.extensions - 需要处理的文件扩展名
+ * @param config.nonCodeExtensions - 非代码文件扩展名
+ * @param config.plugins - Vite 插件配置
+ * @param config.dts - 类型声明文件配置
+ * @param config.outDir - 输出根目录，默认 'dist'
+ * @param config.rootDir - 项目根目录，默认当前工作目录
+ * @returns 构建结果信息
+ */
+export declare function buildEntries(config?: BuildEntriesConfig): Promise<BuildEntriesResult>;

package/types/scripts/vite-build/collect.d.ts

@@ -0,0 +1,57 @@
+import type { CollectedPluginFile, PluginFileHandler } from "./types.ts";
+/**
+ * 递归收集 TypeScript 源文件
+ * 遍历目录树，收集符合扩展名要求且未被忽略的文件
+ * @param entryPath - 入口路径（文件或目录）
+ * @param collected - 收集到的文件路径集合
+ * @param isIgnored - 判断路径是否被忽略的函数
+ * @param extensionsSet - 需要收集的文件扩展名集合
+ */
+export declare function collectTsFiles(entryPath: string, collected: Set<string>, isIgnored: (targetPath: string) => boolean, extensionsSet: Set<string>, allowMissing?: boolean): Promise<void>;
+/**
+ * 递归收集需要由插件处理的文件
+ * 根据插件的 test 函数判断文件是否需要处理
+ * @param entryPath - 入口路径（文件或目录）
+ * @param collected - 收集到的文件信息数组
+ * @param isIgnored - 判断路径是否被忽略的函数
+ * @param plugins - 插件处理器列表
+ */
+export declare function collectPluginFiles(entryPath: string, collected: CollectedPluginFile[], isIgnored: (targetPath: string) => boolean, plugins: PluginFileHandler[], allowMissing?: boolean): Promise<void>;
+/**
+ * 递归收集指定扩展名的文件
+ * 用于收集特定类型的文件（如 .d.ts 文件）
+ * @param entryPath - 入口路径（文件或目录）
+ * @param collected - 收集到的文件路径集合
+ * @param extensionsSet - 需要收集的文件扩展名集合
+ */
+export declare function collectFilesWithExtensions(entryPath: string, collected: Set<string>, extensionsSet: Set<string>): Promise<void>;
+/**
+ * 确保并返回有效的输入文件列表
+ * 处理多个输入路径，过滤忽略的文件，验证是否有匹配的源文件
+ * @param inputPaths - 输入路径列表
+ * @param rootDir - 项目根目录
+ * @param ignorePaths - 需要忽略的路径列表
+ * @param extensions - 需要处理的文件扩展名
+ * @returns 排序后的文件绝对路径数组
+ * @throws 如果没有找到匹配的源文件
+ */
+export declare function ensureInputFiles(inputPaths: string[], rootDir: string, ignorePaths: string[], extensions: string[], allowMissing?: boolean): Promise<string[]>;
+/**
+ * 确保并返回需要插件处理的文件列表
+ * 收集所有匹配插件 test 函数的文件
+ * @param inputPaths - 输入路径列表
+ * @param rootDir - 项目根目录
+ * @param ignorePaths - 需要忽略的路径列表
+ * @param plugins - 插件处理器列表
+ * @returns 排序后的文件信息数组
+ */
+export declare function ensurePluginFiles(inputPaths: string[], rootDir: string, ignorePaths: string[], plugins: PluginFileHandler[], allowMissing?: boolean): Promise<CollectedPluginFile[]>;
+/**
+ * 将文件路径列表转换为 Vite 入口映射对象
+ * 键为相对于根目录的路径（不含扩展名），值为绝对路径
+ * @param files - 文件绝对路径列表
+ * @param rootDir - 项目根目录
+ * @param extensions - 需要移除的文件扩展名列表
+ * @returns 入口映射对象 { [entryName]: absolutePath }
+ */
+export declare function toEntryMap(files: string[], rootDir: string, extensions: string[]): Record<string, string>;

package/types/scripts/vite-build/constants.d.ts

@@ -0,0 +1,6 @@
+export declare const DEFAULT_EXTENSIONS: readonly [".ts", ".tsx", ".mts", ".cts", ".js"];
+export declare const DEFAULT_FORMATS: readonly ["es", "cjs"];
+export declare const COMMON_NON_CODE_EXTENSIONS: Set<string>;
+export declare const FORMAT_OUTPUT_DIR: Record<string, string>;
+export declare const DEFAULT_NON_CODE_EXTENSIONS: string[];
+export declare const BUILTIN_MODULES: Set<string>;

package/types/scripts/vite-build/dts.d.ts

@@ -0,0 +1,53 @@
+import type { Alias } from "vite";
+import type { AliasRewriteRule, NormalizedDtsConfig } from "./types.ts";
+/**
+ * 使用 TypeScript 编译器生成类型声明文件
+ * 创建临时 tsconfig 并调用 tsc 生成 .d.ts 文件
+ * @param files - 需要生成声明文件的源文件列表
+ * @param rootDir - 项目根目录
+ * @param aliases - 路径别名配置
+ * @param outDir - 声明文件输出目录
+ * @throws 如果找不到 TypeScript CLI 或编译失败
+ */
+export declare function buildDeclarations(files: string[], rootDir: string, aliases: Alias[], dts: NormalizedDtsConfig): Promise<void>;
+/**
+ * 创建别名重写规则列表
+ * 用于在声明文件中将路径别名转换为相对路径
+ * @param rootDir - 项目根目录
+ * @param aliases - Vite 路径别名配置
+ * @returns 按别名长度降序排列的重写规则数组
+ */
+export declare function createAliasRewriteRules(rootDir: string, aliases: Alias[]): AliasRewriteRule[];
+/**
+ * 解析别名导入对应的声明文件路径
+ * 将别名路径解析为实际的 .d.ts 文件路径
+ * @param specifier - 导入标识符（可能包含别名）
+ * @param rootDir - 项目根目录
+ * @param aliases - 路径别名配置
+ * @param extensions - 需要处理的文件扩展名
+ * @param outDir - 声明文件输出目录
+ * @returns 对应的 .d.ts 文件路径，如果无法解析则返回 null
+ */
+export declare function resolveAliasedDeclarationTarget(specifier: string, rootDir: string, aliases: Alias[], extensions: string[], outDir: string): Promise<string | null>;
+/**
+ * 重写声明文件中的别名导入标识符
+ * 将别名路径转换为相对于声明文件的相对路径
+ * @param specifier - 原始导入标识符
+ * @param declarationFilePath - 当前声明文件的绝对路径
+ * @param rootDir - 项目根目录
+ * @param outDir - 声明文件输出目录
+ * @param aliases - 路径别名配置
+ * @param rules - 别名重写规则
+ * @param extensions - 需要处理的文件扩展名
+ * @returns 重写后的导入标识符
+ */
+export declare function rewriteAliasedSpecifier(specifier: string, declarationFilePath: string, rootDir: string, outDir: string, aliases: Alias[], rules: AliasRewriteRule[], extensions: string[], mode: 'source' | 'declaration'): Promise<string>;
+/**
+ * 重写输出目录中所有声明文件的别名导入
+ * 处理静态导入、动态导入和模块声明中的别名路径
+ * @param outDir - 声明文件输出目录
+ * @param rootDir - 项目根目录
+ * @param aliases - 路径别名配置
+ * @param extensions - 需要处理的文件扩展名
+ */
+export declare function rewriteDeclarationAliases(outDir: string, rootDir: string, aliases: Alias[], extensions: string[], mode?: 'source' | 'declaration'): Promise<void>;

package/types/scripts/vite-build/index.d.ts

@@ -0,0 +1,2 @@
+export { buildEntries } from "./build.ts";
+export { createCopyPlugin, createFilePlugin } from "./plugins.ts";

package/types/scripts/vite-build/normalize.d.ts

@@ -0,0 +1,66 @@
+import type { Alias } from "vite";
+import type { BuildEntriesConfig, BuildFormat, CopyConfig, ExtensionConfig, IgnoreConfig, NormalizedCopyConfig, NormalizedDtsConfig } from "./types.ts";
+/**
+ * 标准化文件扩展名配置
+ * 合并默认扩展名和自定义扩展名，确保扩展名以点开头
+ * @param extensionOptions - 扩展名配置，包含 input 数组和 mergeDefault 标志
+ * @returns 标准化后的扩展名数组（去重）
+ */
+export declare function normalizeExtensions(extensionOptions?: ExtensionConfig): string[];
+/**
+ * 标准化忽略配置
+ * 提供默认值确保返回完整的配置对象
+ * @param ignoreOptions - 忽略配置
+ * @returns 包含 input 和 importPolicy 的完整配置对象
+ */
+export declare function normalizeIgnore(ignoreOptions?: IgnoreConfig): Required<IgnoreConfig>;
+/**
+ * 标准化路径别名配置
+ * 支持对象格式和数组格式，将相对路径转换为绝对路径
+ * @param aliasOptions - 别名配置（对象或数组格式）
+ * @param rootDir - 项目根目录
+ * @returns Vite Alias 数组
+ */
+export declare function normalizeAlias(aliasOptions: BuildEntriesConfig['alias'], rootDir: string): Alias[];
+/**
+ * 标准化非代码文件扩展名配置
+ * 用于识别需要复制而非编译的资源文件
+ * @param extensionOptions - 扩展名配置
+ * @returns 标准化后的扩展名数组（去重）
+ */
+export declare function normalizeNonCodeExtensions(extensionOptions?: ExtensionConfig): string[];
+/**
+ * 标准化输出格式配置
+ * 确保返回有效的格式数组
+ * @param formatOptions - 格式配置（单个格式或数组）
+ * @returns 格式数组，默认 ['es', 'cjs']
+ */
+export declare function normalizeFormats(formatOptions?: BuildFormat | BuildFormat[]): BuildFormat[];
+/**
+ * 标准化类型声明文件配置
+ * 支持布尔值、对象配置或 undefined
+ * @param dtsOptions - DTS 配置选项
+ * @param outputRoot - 输出根目录
+ * @returns 标准化的 DTS 配置对象
+ */
+export declare function normalizeDtsConfig(dtsOptions: BuildEntriesConfig['dts'], outputRoot: string): NormalizedDtsConfig;
+/**
+ * 标准化格式输出目录映射
+ * 默认保持历史行为：es -> esm, cjs -> cjs
+ */
+export declare function normalizeFormatOutDir(formatOutDir: BuildEntriesConfig['formatOutDir']): Partial<Record<BuildFormat, string>>;
+/**
+ * 检查并阻止将资源文件扩展名添加到代码扩展名列表
+ * 防止将 .css、.svg 等文件当作代码编译
+ * @param extensions - 代码文件扩展名列表
+ * @param nonCodeExtensions - 非代码文件扩展名列表
+ * @throws 如果发现资源文件扩展名混入代码扩展名列表
+ */
+export declare function assertNoCommonAssetExtensions(extensions: string[], nonCodeExtensions: string[]): void;
+/**
+ * 标准化复制文件配置
+ * 配置需要原样复制的资源文件
+ * @param copyOptions - 复制配置
+ * @returns 标准化的复制配置对象
+ */
+export declare function normalizeCopy(copyOptions?: CopyConfig): NormalizedCopyConfig;

package/types/scripts/vite-build/plugins.d.ts

@@ -0,0 +1,67 @@
+import type { Plugin, PluginOption } from "vite";
+import type { BuildContext, BuildEntriesFilePlugin, BuildEntriesFilePluginOptions, InternalPlugin } from "./types.ts";
+/**
+ * 创建构建文件插件的基础工厂函数
+ * 用于创建可以处理文件复制或转换的 Vite 插件
+ * @param pluginOptions - 插件配置选项
+ * @returns BuildEntriesFilePlugin 对象
+ */
+export declare function createBuildEntriesFilePlugin(pluginOptions?: BuildEntriesFilePluginOptions): BuildEntriesFilePlugin;
+/**
+ * 创建文件复制插件
+ * 用于将非代码文件原样复制到输出目录
+ * @param options - 插件配置选项
+ * @param options.rename - 可选的重命名函数
+ * @returns BuildEntriesFilePlugin 对象，kind 为 'copy'
+ */
+export declare function createCopyPlugin(options?: BuildEntriesFilePluginOptions): BuildEntriesFilePlugin;
+/**
+ * 创建文件转换插件
+ * 用于对文件内容进行自定义转换处理
+ * @param options - 插件配置选项
+ * @param options.transform - 文件转换函数
+ * @returns BuildEntriesFilePlugin 对象
+ */
+export declare function createFilePlugin(options?: BuildEntriesFilePluginOptions): BuildEntriesFilePlugin;
+/**
+ * 将 BuildEntriesFilePlugin 转换为实际的 Vite 插件
+ * 在 writeBundle 阶段处理文件并输出到目标目录
+ * @param plugin - BuildEntriesFilePlugin 实例
+ * @param buildContext - 构建上下文信息
+ * @returns Vite Plugin 对象
+ */
+export declare function hydrateFilePlugin(plugin: BuildEntriesFilePlugin, buildContext: BuildContext): Plugin;
+/**
+ * 准备 Vite 插件列表
+ * 将内部插件格式转换为标准 Vite 插件
+ * @param plugins - 内部插件列表
+ * @param buildContext - 构建上下文信息
+ * @returns 标准 Vite 插件数组
+ */
+export declare function prepareVitePlugins(plugins: InternalPlugin[], buildContext: BuildContext): Plugin[];
+/**
+ * 标准化插件配置
+ * 支持多种配置格式：数组、对象配置或 undefined
+ * @param pluginOptions - 插件配置
+ * @param defaultPlugins - 默认插件列表
+ * @returns 标准化的内部插件数组
+ */
+export declare function normalizePlugins(pluginOptions: {
+    input?: PluginOption[];
+    mergeDefault?: boolean;
+} | PluginOption[] | undefined, defaultPlugins?: InternalPlugin[]): InternalPlugin[];
+/**
+ * 合并默认插件和用户插件
+ * 如果用户提供了自定义复制插件，则移除默认的复制插件
+ * @param defaultPlugins - 默认插件列表
+ * @param inputPlugins - 用户插件列表
+ * @returns 合并后的插件数组
+ */
+export declare function mergePlugins(defaultPlugins: InternalPlugin[], inputPlugins: InternalPlugin[]): InternalPlugin[];
+/**
+ * 扁平化插件选项数组
+ * 递归处理嵌套数组，过滤空值
+ * @param pluginOptions - 可能包含嵌套的插件选项数组
+ * @returns 扁平化的内部插件数组
+ */
+export declare function flattenPluginOptions(pluginOptions: PluginOption[]): InternalPlugin[];

package/types/scripts/vite-build/resolve.d.ts

@@ -0,0 +1,61 @@
+import type { Alias } from "vite";
+import type { ExternalMatcher, ExternalOption, ExtensionConfig } from "./types.ts";
+/**
+ * 解析导入路径的实际文件位置
+ * 处理相对路径、路径别名和扩展名补全
+ * @param importer - 导入文件的绝对路径
+ * @param source - 导入标识符
+ * @param extensions - 需要尝试的文件扩展名
+ * @param aliases - 路径别名配置
+ * @returns 解析后的文件绝对路径
+ */
+export declare function resolveImportPath(importer: string, source: string, extensions: string[], aliases: Alias[]): Promise<string>;
+/**
+ * 创建路径忽略判断函数
+ * 用于检查给定路径是否在忽略列表中
+ * @param ignorePaths - 需要忽略的路径列表（相对或绝对）
+ * @param rootDir - 项目根目录
+ * @returns 判断函数，接收路径返回是否应被忽略
+ */
+export declare function createIgnoreMatcher(ignorePaths: string[], rootDir: string): (targetPath: string) => boolean;
+/**
+ * 检查模块标识符是否匹配某个别名
+ * @param id - 模块标识符
+ * @param aliases - 路径别名配置
+ * @returns 是否匹配别名
+ */
+export declare function matchesAlias(id: string, aliases: Alias[]): boolean;
+/**
+ * 判断导入是否为裸模块导入（npm 包）
+ * @param id - 模块标识符
+ * @returns 是否为裸模块导入
+ */
+export declare function isBareImport(id: string): boolean;
+/**
+ * 检查模块是否匹配外部依赖规则
+ * @param id - 模块标识符
+ * @param importer - 导入者文件路径
+ * @param matcher - 匹配器（字符串、正则或函数）
+ * @returns 是否匹配外部依赖规则
+ */
+export declare function matchesExternalRule(id: string, importer: string | undefined, matcher: ExternalMatcher): boolean;
+/**
+ * 创建外部依赖判断函数
+ * 用于判断模块是否应该被视为外部依赖（不打包）
+ * @param aliases - 路径别名配置
+ * @param externalOption - 外部依赖配置
+ * @param externalNodeBuiltins - 是否将 Node.js 内置模块视为外部依赖，默认 true
+ * @param externalPackages - 是否将所有 npm 包视为外部依赖，默认 false
+ * @returns 外部依赖判断函数
+ */
+export declare function createExternalPredicate(aliases: Alias[], externalOption?: ExternalOption, externalNodeBuiltins?: boolean, externalPackages?: boolean): (id: string, importer?: string) => boolean;
+/**
+ * 创建扩展名匹配器
+ * 用于快速判断文件是否具有指定的扩展名
+ * @param extensionOptions - 扩展名配置
+ * @returns 包含扩展名数组和测试函数的对象
+ */
+export declare function createExtensionMatcher(extensionOptions?: ExtensionConfig): {
+    extensions: string[];
+    test: (filePath: string) => boolean;
+};