@_tc/template-core 0.1.15 → 0.2.0-bate.0

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;
+};

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

@@ -0,0 +1,174 @@
+import type { Alias, LibraryFormats, Plugin, PluginOption } from "vite";
+export type ImportPolicy = 'error' | 'skip';
+export type BuildFormat = LibraryFormats;
+export type OutputStructure = 'preserve' | 'bundle';
+export type ExtensionConfig = {
+    input?: string[];
+    mergeDefault?: boolean;
+};
+export type IgnoreConfig = {
+    input?: string[];
+    importPolicy?: ImportPolicy;
+};
+export type CopyConfig = {
+    input?: string[];
+    ignore?: {
+        input?: string[];
+    };
+    extensions?: ExtensionConfig;
+    onlyConfiguredExtensions?: boolean;
+};
+export type PluginsConfig = {
+    input?: PluginOption[];
+    mergeDefault?: boolean;
+};
+export type FilePluginOutput = {
+    type: 'copy';
+    fileName?: string;
+    sourcePath: string;
+} | {
+    type: 'emit';
+    fileName?: string;
+    content: string;
+};
+export type FilePluginContext = {
+    filePath: string;
+    relativePath: string;
+    rootDir: string;
+    outDir: string;
+    format: BuildFormat;
+    read: () => Promise<string>;
+};
+export type BuildEntriesFilePluginOptions = {
+    name?: string;
+    apply?: 'build' | 'serve';
+    enforce?: 'pre' | 'post';
+    kind?: 'copy';
+    allowMissing?: boolean;
+    onlyConfiguredExtensions?: boolean;
+    input?: string[];
+    rootDir?: string;
+    ignore?: {
+        input?: string[];
+    };
+    extensions?: ExtensionConfig;
+    copyExtensions?: ExtensionConfig;
+    test?: (filePath: string) => boolean;
+    rename?: (relativePath: string, filePath: string) => string;
+    transform?: (context: FilePluginContext) => Promise<FilePluginOutput | FilePluginOutput[] | void> | FilePluginOutput | FilePluginOutput[] | void;
+};
+export type BuildEntriesFilePlugin = {
+    name: string;
+    apply?: 'build' | 'serve';
+    enforce?: 'pre' | 'post';
+    kind?: 'copy';
+    __buildEntriesFilePlugin: BuildEntriesFilePluginOptions;
+};
+export type InternalPlugin = Plugin & Partial<BuildEntriesFilePlugin>;
+export type StringAlias = Alias & {
+    find: string;
+};
+export type BuildEntriesConfig = {
+    input?: string[];
+    format?: BuildFormat | BuildFormat[];
+    outputStructure?: OutputStructure;
+    formatOutDir?: Partial<Record<BuildFormat, string>>;
+    alias?: Record<string, string> | Alias[];
+    external?: ExternalOption;
+    externalNodeBuiltins?: boolean;
+    bundleDependencies?: boolean;
+    externalPackages?: boolean;
+    allowMissingInput?: boolean;
+    ignore?: IgnoreConfig;
+    copy?: CopyConfig;
+    minify?: boolean;
+    dtsOnly?: boolean;
+    preserveSideEffectStyleImports?: boolean;
+    extensions?: ExtensionConfig;
+    nonCodeExtensions?: ExtensionConfig;
+    plugins?: PluginOption[] | PluginsConfig;
+    dts?: boolean | {
+        enabled?: boolean;
+        outDir?: string;
+        tsconfig?: string;
+        tempDir?: string;
+        rewriteAliases?: boolean;
+        rewriteAliasMode?: 'source' | 'declaration';
+        rewriteAlias?: Record<string, string> | Alias[];
+        useInputFiles?: boolean;
+        clean?: boolean;
+    };
+    outDir?: string;
+    rootDir?: string;
+};
+export type ExternalMatcher = string | RegExp | ((id: string, importer?: string) => boolean);
+export type ExternalOption = ExternalMatcher | ExternalMatcher[];
+export type BuildEntriesResult = {
+    alias: Alias[];
+    formats: BuildFormat[];
+    outputStructure: OutputStructure;
+    bundleDependencies: boolean;
+    extensions: string[];
+    files: string[];
+    ignore: Required<IgnoreConfig>;
+    copy: NormalizedCopyConfig;
+    plugins: string[];
+    outputs: Record<string, string>;
+    dts: {
+        enabled: boolean;
+        outDir?: string;
+    };
+};
+export type PluginFileHandler = {
+    test: (filePath: string) => boolean;
+    transform: (context: FilePluginContext) => Promise<FilePluginOutput | FilePluginOutput[] | void> | FilePluginOutput | FilePluginOutput[] | void;
+};
+export type CollectedPluginFile = {
+    filePath: string;
+    plugin: PluginFileHandler;
+};
+export type BuildContext = {
+    inputPaths: string[];
+    rootDir: string;
+    ignorePaths: string[];
+    extensions: string[];
+    allowMissingInput: boolean;
+    outDir: string;
+    format: BuildFormat;
+};
+export type NormalizedCopyConfig = {
+    input?: string[];
+    ignore?: {
+        input?: string[];
+    };
+    extensions: ExtensionConfig;
+    onlyConfiguredExtensions: boolean;
+};
+export type RunBuildOptions = {
+    format: BuildFormat;
+    outDir: string;
+    entry: Record<string, string>;
+    outputStructure: OutputStructure;
+    emptyOutDir: boolean;
+    minify?: boolean;
+    rootDir: string;
+    preserveSideEffectStyleImports?: boolean;
+    plugins: Plugin[];
+    aliases: Alias[];
+    external: (id: string, importer?: string) => boolean;
+};
+export type NormalizedDtsConfig = {
+    enabled: boolean;
+    outDir: string;
+    tsconfig?: string;
+    tempDir?: string;
+    rewriteAliases: boolean;
+    rewriteAliasMode: 'source' | 'declaration';
+    rewriteAlias?: Record<string, string> | Alias[];
+    useInputFiles: boolean;
+    clean: boolean;
+};
+export type AliasRewriteRule = {
+    find: string;
+    replacement: string;
+};

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

@@ -0,0 +1,35 @@
+import type { Alias } from "vite";
+import type { StringAlias } from "./types.ts";
+/**
+ * 检查路径是否存在
+ * @param targetPath - 目标路径
+ * @returns 路径是否存在
+ */
+export declare function pathExists(targetPath: string): Promise<boolean>;
+/**
+ * 将路径转换为 POSIX 格式（使用正斜杠）
+ * 确保跨平台路径一致性
+ * @param value - 输入路径
+ * @returns POSIX 格式路径
+ */
+export declare function toPosixPath(value: string): string;
+/**
+ * 确保相对导入路径格式正确
+ * 为不以点开头的相对路径添加 './' 前缀
+ * @param value - 相对路径
+ * @returns 格式化后的相对导入路径
+ */
+export declare function ensureRelativeImportPath(value: string): string;
+/**
+ * 将值转换为数组
+ * @param value - 输入值（单个值、数组、null 或 undefined）
+ * @returns 数组
+ */
+export declare function toArray<T>(value: T | T[] | null | undefined): T[];
+/**
+ * 判断别名是否为字符串类型别名
+ * 用于区分字符串别名和正则别名
+ * @param alias - Vite Alias 对象
+ * @returns 是否为字符串别名
+ */
+export declare function isStringAlias(alias: Alias): alias is StringAlias;

package/cjs/app/middleware/api-params-verify.js

@@ -1 +0,0 @@
-const e=require(`../../_virtual/_rolldown/runtime.js`);let t=require(`ajv`);t=e.__toESM(t);var n=new t.default,r=`http://json-schema.org/draft-07/schema#`,i=(e,t,i)=>{if(t[e]&&i[e]){i[e].$schema=r;let a=n.compile(i[e]);return[a(t[e]),a]}},a=e=>async(t,r)=>{let{path:a,method:o}=t;if(a.indexOf(`/api`)<0)return r();let s=e.currentUseRouter,c;for(let e of s){let t=e.match(a,`get`);if(t){c=t;break}}let l=c?.path[0]?.path;if(l){let r=e.extends.parsingParamsOnUrl(l,a),{body:s,query:c,headers:u}=t.request,d={params:r,body:s,query:c,headers:u};e.extends.logger?.info(`--[api params verify] [${o} ${a}] body: ${JSON.stringify(s)}--`),e.extends.logger?.info(`--[api params verify] [${o} ${a}] query: ${JSON.stringify(c)}--`),e.extends.logger?.info(`--[api params verify] [${o} ${a}] params: ${JSON.stringify(r)}--`),e.extends.logger?.info(`--[api params verify] [${o} ${a}] headers: ${JSON.stringify(u)}--`);let f=e.routerSchema[l]?.[o.toLowerCase()];if(f){let t=!0,r,a=[`headers`,`body`,`query`,`params`];for(let e=0;e<a.length;e++){let n=a[e];if(t){let e=i(n,{...d},f);t=e?.[0]??!0,r=e?.[1]}}if(!t){let t=`request vaidate fail: ${n.errorsText(r?.errors)}`;e.extends.logger?.error(`--[api valid error] message: ${t}--`),e.extends.generateErrorMessage(t,{showError:!0,code:442})}}}return r()};module.exports=a;

package/cjs/app/middleware/api-sign-verify.js

@@ -1 +0,0 @@
-const e=require(`../../_virtual/_rolldown/runtime.js`);let t=require(`md5`);t=e.__toESM(t);var n=1e3*60*10,r=e=>async(r,i)=>{let{path:a,method:o}=r;if(a.includes(`api`)&&!e.config?.apiSignVerify?.whiteList?.includes(a)){e.extends.logger?.info(`--[api-sign-verify]--`);let{s_sign:i,s_t:s}=r.request.header,{signKey:c}=e.config,l=(0,t.default)(`${c}_${s}`);e.extends.logger?.info(`[${o} ${a}] signature: ${l}`),(!s||!i||i.toLowerCase()!==l||Date.now()-Number(s)>n)&&e.extends.generateErrorMessage(`signature not correct or api timeout`,{showError:!0,code:100014})}await i()};module.exports=r;

package/cjs/app/middleware/project-handler.js

@@ -1 +0,0 @@
-var e=()=>async(e,t)=>{let n=e.headers.projk,{path:r}=e;if(r.indexOf(`/api/proj/`)!==-1&&(!n||[`undefined`,`null`].includes(n))){e.status=200,e.body={code:110,data:null,message:`请求不合法`};return}e.extInfo={key:n},await t()};module.exports=e;

package/esm/app/middleware/project-handler.js

@@ -1,15 +0,0 @@
-//#region app/middleware/project-handler.ts
-var e = () => async (e, t) => {
-	let n = e.headers.projk, { path: r } = e;
-	if (r.indexOf("/api/proj/") !== -1 && (!n || ["undefined", "null"].includes(n))) {
-		e.status = 200, e.body = {
-			code: 110,
-			data: null,
-			message: "请求不合法"
-		};
-		return;
-	}
-	e.extInfo = { key: n }, await t();
-};
-//#endregion
-export { e as default };

package/fe/model/types/data/button.js

@@ -1,16 +0,0 @@
-export {};
-// & {
-// 	/**
-// 	 * 按钮事件名
-// 	 */
-// 	eventKey: 'romve' | 'showComponent';
-// 	/**
-// 	 * 事件配置 (参数配置)
-// 	 */
-// 	params: {
-// 		/**
-// 		 *  @example user_id: '$schema::tableKey' | '123' | 123
-// 		 */
-// 		[paramKey: string]: ParamsValueData;
-// 	};
-// };

package/fe/model/types/data/component.js

@@ -1,11 +0,0 @@
-export {};
-// type DynamicSelect = {
-// 	comType: 'dynamicSelect';
-// 	/**
-// 	 * 请求动态列表地址
-// 	 */
-// 	api: string;
-// } & SelectProps;
-// type DateRange = {
-// 	comType: 'dateRange';
-// };

package/fe/model/types/data/schema.js

@@ -1 +0,0 @@
-export {};

package/fe/model/types/data/search.js

@@ -1 +0,0 @@
-export {};

package/fe/model/types/menuType.js

@@ -1 +0,0 @@
-export {};

package/fe/model/types/model.js

@@ -1 +0,0 @@
-export {};

package/fe/packages/common/array/index.js

@@ -1,40 +0,0 @@
-import { isNonNullable } from "../guards";
-export function toArray(value) {
-    if (value === null || value === undefined)
-        return [];
-    return Array.isArray(value) ? [...value] : [value];
-}
-export const compact = (items) => {
-    return items.filter(isNonNullable);
-};
-export const uniqueBy = (items, getKey) => {
-    const keys = new Set();
-    const result = [];
-    for (const item of items) {
-        const key = getKey(item);
-        if (keys.has(key))
-            continue;
-        keys.add(key);
-        result.push(item);
-    }
-    return result;
-};
-export const groupBy = (items, getKey) => {
-    const result = {};
-    for (const item of items) {
-        const key = getKey(item);
-        result[key] = result[key] ?? [];
-        result[key].push(item);
-    }
-    return result;
-};
-export const chunk = (items, size) => {
-    if (!Number.isInteger(size) || size <= 0) {
-        throw new RangeError("chunk size must be a positive integer");
-    }
-    const result = [];
-    for (let index = 0; index < items.length; index += size) {
-        result.push(items.slice(index, index + size));
-    }
-    return result;
-};

package/fe/packages/common/i18n/types.js

@@ -1 +0,0 @@
-export {};