@_tc/template-core 0.0.1-bate.46 → 0.0.1-bate.48

package/{fe/frontend/widgets/common/CRUD/CRUD.d.ts → types/packages/common/http/index.d.ts}

@@ -1,35 +1,52 @@
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'HEAD' | 'OPTIONS';
+export type HttpHeaders = Record<string, string>;
+export type RequestCredentials = 'omit' | 'same-origin' | 'include';
+export type RequestCache = 'default' | 'force-cache' | 'no-cache' | 'no-store' | 'only-if-cached' | 'reload';
+export type RequestRedirect = 'error' | 'follow' | 'manual';
+export type ReferrerPolicy = '' | 'no-referrer' | 'no-referrer-when-downgrade' | 'origin' | 'origin-when-cross-origin' | 'same-origin' | 'strict-origin' | 'strict-origin-when-cross-origin' | 'unsafe-url';
+export interface HeadersLike {
+    forEach(callback: (value: string, key: string) => void): void;
+    has(name: string): boolean;
+    set(name: string, value: string): void;
+}
+export interface ProgressEventLike {
+    loaded?: number;
+    total?: number;
+    lengthComputable?: boolean;
+}
+export type RequestBodyLike = string | ArrayBuffer | ArrayBufferView | object;
 export interface RequestConfig<D = unknown> {
     url?: string;
-    method?: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'HEAD' | 'OPTIONS';
+    method?: HttpMethod;
     baseURL?: string;
-    headers?: Record<string, string>;
+    headers?: HttpHeaders;
     params?: Record<string, string | number | boolean | undefined | null>;
     data?: D;
     timeout?: number;
-    signal?: AbortSignal;
+    signal?: unknown;
     credentials?: RequestCredentials;
     cache?: RequestCache;
     redirect?: RequestRedirect;
     referrer?: string;
     referrerPolicy?: ReferrerPolicy;
-    transformRequest?: ((data: D, headers: Headers) => D | string | ArrayBuffer | Blob) | ((data: D, headers: Headers) => D | string | ArrayBuffer | Blob)[];
+    transformRequest?: ((data: D, headers: HeadersLike) => D | RequestBodyLike) | ((data: D, headers: HeadersLike) => D | RequestBodyLike)[];
     transformResponse?: ((data: unknown) => unknown) | ((data: unknown) => unknown)[];
     validateStatus?: (status: number) => boolean;
-    onUploadProgress?: (progress: ProgressEvent) => void;
-    onDownloadProgress?: (progress: ProgressEvent) => void;
+    onUploadProgress?: (progress: ProgressEventLike) => void;
+    onDownloadProgress?: (progress: ProgressEventLike) => void;
 }
 export interface ResponseConfig<T = unknown, D = unknown> {
     data: T;
     status: number;
     statusText: string;
-    headers: Record<string, string>;
+    headers: HttpHeaders;
     config: RequestConfig<D>;
-    request?: Request;
+    request?: unknown;
 }
 export interface AxiosError<T = unknown, D = unknown> extends Error {
     config: RequestConfig<D>;
     code?: string;
-    request?: Request;
+    request?: unknown;
     response?: ResponseConfig<T, D>;
     isAxiosError: boolean;
 }
@@ -54,6 +71,9 @@ export declare class FetchAxios {
     };
     constructor(config?: RequestConfig);
     private request;
+    private applyRequestInterceptors;
+    private applyResponseInterceptors;
+    private applyResponseErrorInterceptors;
     private _doRequest;
     private createError;
     get<T = unknown, D = unknown>(url: string, config?: RequestConfig<D>): Promise<ResponseConfig<T, D>>;
@@ -67,4 +87,3 @@ export declare class FetchAxios {
 export declare const axios: FetchAxios;
 export declare const createInstance: (defaultConfig: RequestConfig) => FetchAxios;
 export default FetchAxios;
-//# sourceMappingURL=CRUD.d.ts.map

package/types/packages/common/i18n/default.d.ts

@@ -1,3 +1,8 @@
+/**
+ * UI 组件库默认中文语言资源。
+ *
+ * 这里只放组件内置文案，业务项目可以通过 I18nProvider.resources 覆盖或追加。
+ */
 export declare const defaultLanguageResources: {
     readonly common: {
         readonly tip: "提示";

package/types/packages/common/i18n/en-US.d.ts

@@ -1,3 +1,8 @@
+/**
+ * UI component library default English language resources.
+ *
+ * Only built-in component copy belongs here. Applications can override or extend it with I18nProvider.resources.
+ */
 export declare const defaultEnglishResources: {
     readonly common: {
         readonly tip: "Prompt";

package/types/packages/common/i18n/index.d.ts

@@ -2,10 +2,30 @@ import type { I18nDictionary, I18nInterpolationValues, I18nMessage, I18nResource
 export * from "./types";
 export * from "./locales";
 export declare const isPlainI18nDictionary: (value: I18nMessage) => value is I18nDictionary;
+/**
+ * 深合并单个语言包。
+ * 嵌套对象递归合并，字符串、数组、数字等叶子节点直接以 patch 覆盖 base。
+ */
 export declare const mergeI18nDictionary: (base?: I18nDictionary, patch?: I18nDictionary) => I18nDictionary;
+/**
+ * 合并多语言资源。
+ * 结构示例：{ 'zh-CN': { common: { ok: '确定' } }, 'en-US': { common: { ok: 'OK' } } }
+ */
 export declare const mergeI18nResources: (base?: I18nResources, patch?: I18nResources) => I18nResources;
+/**
+ * 根据点分 key 从语言包中取值。
+ * 例如 common.submit 会读取 resources[language].common.submit。
+ */
 export declare const getI18nPathValue: (dictionary: I18nDictionary | undefined, key: string) => I18nMessage | undefined;
+/**
+ * 替换文案中的插值占位符。
+ * 例如 "Hello, {name}" + { name: "Tom" } => "Hello, Tom"。
+ */
 export declare const interpolateI18nMessage: (value: string, data?: I18nInterpolationValues) => string;
+/**
+ * 纯翻译函数：只依赖传入的 state。
+ * 优先级：指定语言 -> 兜底语言 -> options.fallback -> 原 key。
+ */
 export declare const translate: <T = string>(state: I18nTranslateState, key: string, fillingData?: I18nInterpolationValues, options?: I18nTranslateOptions) => T | string;
 export declare const i18nStore: {
     getState: () => I18nStore;
@@ -13,6 +33,10 @@ export declare const i18nStore: {
     setState: (partial: Partial<I18nStore> | ((state: I18nStore) => Partial<I18nStore>)) => void;
     subscribe: (listener: I18nStoreListener) => () => void;
 };
+/**
+ * 对外使用的 i18n 函数。
+ * 每次调用都会读取最新 state，适合在非 React 代码中直接使用。
+ */
 export declare const i18n: <T = string>(key: string, fillingData?: I18nInterpolationValues, options?: I18nTranslateOptions) => string | T;
 export declare const t: <T = string>(key: string, fillingData?: I18nInterpolationValues, options?: I18nTranslateOptions) => string | T;
 export declare const getLanguage: <T = string>(key: string, fillingData?: I18nInterpolationValues, options?: I18nTranslateOptions) => string | T;

package/types/packages/common/i18n/types.d.ts

@@ -12,28 +12,52 @@ export interface I18nTranslateState {
     resources: I18nResources;
 }
 export interface I18nState extends I18nTranslateState {
+    /** 持久化语言时使用的 localStorage key。 */
     storageKey: string;
+    /** 是否把 setLanguage 的结果写入 localStorage。 */
     persist: boolean;
 }
 export interface I18nTranslateOptions {
+    /**
+     * 指定本次翻译使用的语言，不传则使用全局 language。
+     */
     language?: I18nLanguage;
+    /**
+     * 当前语言未命中时使用的兜底语言，不传则使用全局 fallbackLanguage。
+     */
     fallbackLanguage?: I18nLanguage;
+    /**
+     * 当前语言和兜底语言都未命中时返回的兜底值。
+     */
     fallback?: I18nMessage;
 }
 export interface I18nSetResourcesOptions {
+    /**
+     * 是否和现有资源深合并。默认 false，直接替换 resources。
+     */
     merge?: boolean;
 }
 export interface I18nAddResourcesOptions {
+    /**
+     * 是否和当前语言资源深合并。默认 true。
+     */
     merge?: boolean;
 }
 export type I18nTranslator = <T = string>(key: string, fillingData?: I18nInterpolationValues, options?: I18nTranslateOptions) => T | string;
 export interface I18nActions {
+    /** 设置当前展示语言。 */
     setLanguage: (language: I18nLanguage) => void;
+    /** 设置兜底语言。 */
     setFallbackLanguage: (language: I18nLanguage) => void;
+    /** 批量设置多语言资源，可选择替换或合并。 */
     setResources: (resources: I18nResources, options?: I18nSetResourcesOptions) => void;
+    /** 为指定语言追加资源，默认和已有资源深合并。 */
     addResources: (language: I18nLanguage, messages: I18nDictionary, options?: I18nAddResourcesOptions) => void;
+    /** 配置存储行为，主要由 I18nProvider 同步外部 props 使用。 */
     configureI18n: (config: Partial<Pick<I18nState, 'storageKey' | 'persist'>>) => void;
+    /** 重置为默认语言、默认资源和默认存储配置。 */
     resetI18n: () => void;
+    /** 挂在 store 上的翻译函数，方便直接读取。 */
     t: I18nTranslator;
 }
 export type I18nStore = I18nState & I18nActions;

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

@@ -1,6 +1,7 @@
 export * from "./array";
 export * from "./cache";
 export * from "./guards";
+export * from "./http";
 export * from "./i18n";
 export * from "./log";
 export * from "./number";

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

@@ -1,6 +1,6 @@
-import "./types";
 import "../../app/typings";
+import "./types";
 import type { KoaApp, StartOptions } from "./types";
 export declare const loaderModel: (app: KoaApp) => import("./loader/model").ModelConfig;
-export type { AppConfig, AppOptions, StartOptions, KoaMiddleware, ProcessingFileCallbackFN, IService, IController, IExtends, IMiddlewares, KoaApp, KoaRouter, KoaAppExtensions, FrameworkAugment, } from "./types";
-export declare const start: (options?: StartOptions) => KoaApp;
+export type { AppConfig, AppOptions, FrameworkAugment, IController, IExtends, IMiddlewares, IService, KoaApp, KoaAppExtensions, KoaMiddleware, KoaRouter, ProcessingFileCallbackFN, StartOptions, } from "./types";
+export declare const start: (options?: StartOptions) => Promise<KoaApp>;

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

@@ -1,3 +1,9 @@
 import type { KoaApp } from "../types";
+/**
+ * config loader 只处理一级
+ *
+ * @param app 加载 xx/config/ 下的文件
+ *  config/config.default.(js|ts)
+ */
 declare const _default: (app: KoaApp) => void;
 export default _default;

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

@@ -1,3 +1,17 @@
 import type { KoaApp } from "../types";
+/**
+* 加载 xx/app/controller 文件夹下所有文件，可通过'app.controller.$｛目录｝.＇｝，访问
+*
+例子：
+    app/controller
+
+        |-- cuStom-moduLe
+
+        |-- custom-midd Leware.(js|ts)
+
+    => app.controller.customModule. customMiddleware
+ *
+ * @param app
+ */
 declare const _default: (app: KoaApp) => void;
 export default _default;

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

@@ -1,3 +1,8 @@
 import type { KoaApp } from "../types";
-declare const _default: (app: KoaApp) => void;
+/**
+ *  extend loader  扩展  koa app属性  只加载一级
+ *
+ *  加载 xx/app/extend 文件，可通过 'app.extends.${文件}' 访问
+ */
+declare const _default: (app: KoaApp) => Promise<void>;
 export default _default;

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

@@ -1,3 +1,11 @@
 import type { KoaApp } from "../types";
+/**
+ *
+ *  middleware loader
+ *
+ * @param app
+ *
+ *  加载 xx/app/middleware 文件夹下所有文件，可通过 'app.middleware.${目录}.${文件}' 访问
+ */
 declare const _default: (app: KoaApp) => void;
 export default _default;

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

@@ -1,4 +1,22 @@
 import { KoaApp } from "../types";
+/**
+ *  xx/model/* ->
+ *  [
+ *      {
+ *          model:{
+ *              key: '',
+ *              ...model.config
+ *          }
+ *          project: {
+ *              [projectKey]: {
+ *                  ...project.config,
+ *                  key:string,
+ *              }
+ *          }
+ *      }
+ *  ]
+ *
+ */
 export interface ModelItem {
     model: {
         key: string;
@@ -10,5 +28,9 @@ export interface ModelItem {
     };
 }
 export type ModelConfig = ModelItem[];
+/**
+ * 获取使用方的 跟路径下的 model文件夹
+ * @param app
+ */
 declare const modelLoader: (app: KoaApp) => ModelConfig;
 export default modelLoader;

package/types/packages/core/loader/router-schema.d.ts

@@ -1,3 +1,18 @@
 import { KoaApp } from "../types";
+/**
+ *
+ *  router-schema loader 只处理一级
+ *
+ * @param app
+ *
+ * xx/app/router-schema/**.(js|ts)
+ *
+ * 输出：
+ *  app.routerSchema = {
+ *      [api1]: jsonSchema
+ *  }
+ *
+ *
+ */
 declare const _default: (app: KoaApp) => void;
 export default _default;

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

@@ -1,3 +1,8 @@
 import type { KoaApp } from "../types";
+/**
+ * reouter loader
+ *
+ * 解析 xx/app/router/下的所有文件 加载到 koa-router上
+ */
 declare const _default: (app: KoaApp) => void;
 export default _default;

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

@@ -1,3 +1,17 @@
 import type { KoaApp } from "../types";
+/**
+* 加载 xx/app/service 文件夹下所有文件 可通过'app.service.$｛目录｝.．｝，访问
+*
+例子：
+    app/service
+
+        |-- cuStom-moduLe
+
+        |-- custom-midd Leware.(js|ts)
+
+    => app.service.customModule. customMiddleware
+ *
+ * @param app
+ */
 declare const _default: (app: KoaApp) => void;
 export default _default;

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

@@ -1,11 +1,14 @@
-export type AppPathType = "frame" | "business";
+import type { KoaApp } from "app/typings";
+export type AppPathType = 'frame' | 'business';
 export interface AppPathInfo {
     type: AppPathType;
     path: string;
 }
-export declare function getAppPath(app: {
-    paths?: AppPathInfo[];
-}, type: AppPathType): string | undefined;
-export declare function getAppPaths(app: {
-    paths?: AppPathInfo[];
-}): string[];
+/**
+ * 获取制定类型的app目录
+ */
+export declare function getAppPath(app: KoaApp, type: AppPathType): string | undefined;
+/**
+ * 获取所有app目录
+ */
+export declare function getAppPaths(app: KoaApp): string[];

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

@@ -28,13 +28,39 @@ export declare namespace FrameworkAugment {
 }
 export type ICTX = Parameters<Router.IMiddleware<any, {}>>[0];
 export interface KoaAppExtensions {
+    /**
+     *  框架路径 .root
+     */
     frameBaseDir: string;
-    framePath: string;
+    /**
+     * 框架跟路径 .root/app
+     */
+    frameAppPath: string;
+    /**
+     *  使用方根路径 .root
+     */
     baseDir: string;
-    businessPath: string;
+    /**
+     * 使用方 .root/app
+     */
+    businessAppPath: string;
+    /**
+     * 存着 框架 以及业务方的 app路径
+     */
     paths: AppPathInfo[];
+    /**
+     * 服务生命周期
+     */
     hooks: {
+        /**
+         *
+         * 服务初始化完成
+         */
         inited?: () => void;
+        /**
+         *
+         * 服务开始初始化
+         */
         initing?: () => void;
     };
     envs: EnvReturn;
@@ -63,10 +89,42 @@ 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 {
@@ -75,8 +133,13 @@ export interface AppOptions extends StartOptions {
 }
 export type KoaApp = Koa & KoaAppExtensions;
 export type KoaRouter = Router & {
+    /**
+     * 路由插入层级 默认为 0
+     * 数值越小越靠前
+     */
     level?: number;
 };
 export type KoaMiddleware = Koa.Middleware;
-export type { EnvType, EnvKeys } from "./env";
+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

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

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

@@ -6,6 +6,12 @@ export interface LoadFileCallbackOptions {
     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: {

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

@@ -1,6 +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/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>;