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

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

@@ -0,0 +1,91 @@
+/**
+ * UI 组件库默认中文语言资源。
+ *
+ * 这里只放组件内置文案，业务项目可以通过 I18nProvider.resources 覆盖或追加。
+ */
+export declare const defaultLanguageResources: {
+    readonly common: {
+        readonly tip: "提示";
+        readonly confirm: "确认";
+        readonly cancel: "取消";
+        readonly close: "关闭";
+        readonly submit: "提交";
+        readonly reset: "重置";
+    };
+    readonly components: {
+        readonly breadcrumb: {
+            readonly close: "关闭";
+        };
+        readonly confirmDialog: {
+            readonly title: "提示";
+            readonly okText: "确认";
+            readonly cancelText: "取消";
+        };
+        readonly dataTable: {
+            readonly noData: "暂无数据";
+        };
+        readonly date: {
+            readonly placeholder: "请选择日期";
+            readonly placeholderDateTime: "请选择日期时间";
+            readonly placeholderRange: "选择日期范围";
+            readonly placeholderDateTimeRange: "选择日期时间范围";
+            readonly weekDays: readonly ["日", "一", "二", "三", "四", "五", "六"];
+            readonly selectTime: "选择时间";
+            readonly startTime: "开始时间";
+            readonly endTime: "结束时间";
+            readonly confirm: "确认";
+            readonly monthFormat: "yyyy年 M月";
+            readonly quickRanges: "快速选择";
+            readonly quickRangeToday: "今天";
+            readonly quickRangeYesterday: "昨天";
+            readonly quickRangeLast7Days: "近7天";
+            readonly quickRangeLast30Days: "近30天";
+            readonly quickRangeThisMonth: "本月";
+            readonly quickRangeLastYear: "最近一年";
+            readonly clear: "清除";
+        };
+        readonly form: {
+            readonly submit: "提交";
+            readonly cancel: "取消";
+        };
+        readonly imagePreview: {
+            readonly closePreview: "关闭预览";
+            readonly previousImage: "上一张";
+            readonly nextImage: "下一张";
+            readonly zoomOut: "缩小";
+            readonly zoomIn: "放大";
+            readonly reset: "重置";
+            readonly rotateLeft: "左旋转";
+            readonly rotateRight: "右旋转";
+            readonly flipHorizontal: "左右镜像";
+            readonly flipVertical: "上下镜像";
+            readonly previewImage: "预览第{index}张";
+        };
+        readonly modal: {
+            readonly close: "关闭";
+            readonly confirmTitle: "提示";
+            readonly okText: "确认";
+            readonly cancelText: "取消";
+        };
+        readonly message: {
+            readonly close: "关闭";
+        };
+        readonly select: {
+            readonly empty: "暂无选项";
+        };
+        readonly tableSearch: {
+            readonly reset: "重置";
+            readonly search: "查询";
+            readonly export: "导出Excel";
+            readonly expand: "展开";
+            readonly collapse: "收起";
+            readonly exportCurrentPage: "当前页";
+            readonly exportCurrentQuery: "当前查询条件";
+        };
+        readonly upload: {
+            readonly deleteImage: "删除图片";
+            readonly upload: "上传";
+        };
+    };
+};
+export type DefaultLanguageResources = typeof defaultLanguageResources;

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

@@ -0,0 +1,91 @@
+/**
+ * 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";
+        readonly confirm: "Confirm";
+        readonly cancel: "Cancel";
+        readonly close: "Close";
+        readonly submit: "Submit";
+        readonly reset: "Reset";
+    };
+    readonly components: {
+        readonly breadcrumb: {
+            readonly close: "Close";
+        };
+        readonly confirmDialog: {
+            readonly title: "Prompt";
+            readonly okText: "Confirm";
+            readonly cancelText: "Cancel";
+        };
+        readonly dataTable: {
+            readonly noData: "No Data";
+        };
+        readonly date: {
+            readonly placeholder: "Select date";
+            readonly placeholderDateTime: "Select date and time";
+            readonly placeholderRange: "Select date range";
+            readonly placeholderDateTimeRange: "Select date and time range";
+            readonly weekDays: readonly ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"];
+            readonly selectTime: "Select time";
+            readonly startTime: "Start time";
+            readonly endTime: "End time";
+            readonly confirm: "Confirm";
+            readonly monthFormat: "MMM yyyy";
+            readonly quickRanges: "Quick ranges";
+            readonly quickRangeToday: "Today";
+            readonly quickRangeYesterday: "Yesterday";
+            readonly quickRangeLast7Days: "Last 7 days";
+            readonly quickRangeLast30Days: "Last 30 days";
+            readonly quickRangeThisMonth: "This month";
+            readonly quickRangeLastYear: "Last year";
+            readonly clear: "Clear";
+        };
+        readonly form: {
+            readonly submit: "Submit";
+            readonly cancel: "Cancel";
+        };
+        readonly imagePreview: {
+            readonly closePreview: "Close preview";
+            readonly previousImage: "Previous image";
+            readonly nextImage: "Next image";
+            readonly zoomOut: "Zoom out";
+            readonly zoomIn: "Zoom in";
+            readonly reset: "Reset";
+            readonly rotateLeft: "Rotate left";
+            readonly rotateRight: "Rotate right";
+            readonly flipHorizontal: "Flip horizontal";
+            readonly flipVertical: "Flip vertical";
+            readonly previewImage: "Preview image {index}";
+        };
+        readonly modal: {
+            readonly close: "Close";
+            readonly confirmTitle: "Prompt";
+            readonly okText: "Confirm";
+            readonly cancelText: "Cancel";
+        };
+        readonly message: {
+            readonly close: "Close";
+        };
+        readonly select: {
+            readonly empty: "No options";
+        };
+        readonly tableSearch: {
+            readonly reset: "Reset";
+            readonly search: "Search";
+            readonly export: "Export Excel";
+            readonly expand: "Expand";
+            readonly collapse: "Collapse";
+            readonly exportCurrentPage: "Current Page";
+            readonly exportCurrentQuery: "Current Filters";
+        };
+        readonly upload: {
+            readonly deleteImage: "Delete image";
+            readonly upload: "Upload";
+        };
+    };
+};
+export type DefaultEnglishResources = typeof defaultEnglishResources;

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

@@ -0,0 +1,42 @@
+import type { I18nDictionary, I18nInterpolationValues, I18nMessage, I18nResources, I18nStore, I18nStoreListener, I18nTranslateOptions, I18nTranslateState } from "./types";
+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;
+    getInitialState: () => 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/locales.d.ts

@@ -0,0 +1,7 @@
+import type { I18nResources } from "./types";
+export declare const defaultLanguage: "zh-CN";
+export declare const languageLocalKey = "tc_language";
+export declare const translations: I18nResources;
+export type Language = keyof typeof translations | (string & {});
+export * from "./default";
+export * from "./en-US";

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

@@ -0,0 +1,70 @@
+export type I18nLanguage = string;
+export type I18nPrimitive = string | number | boolean | null | undefined;
+export type I18nMessage = I18nPrimitive | I18nMessage[] | readonly I18nMessage[] | I18nDictionary;
+export interface I18nDictionary {
+    [key: string]: I18nMessage;
+}
+export type I18nResources<Language extends I18nLanguage = I18nLanguage> = Partial<Record<Language, I18nDictionary>>;
+export type I18nInterpolationValues = Record<string, I18nPrimitive>;
+export interface I18nTranslateState {
+    language: I18nLanguage;
+    fallbackLanguage: I18nLanguage;
+    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;
+export type I18nStoreListener = (state: I18nStore, previousState: I18nStore) => void;
+export interface I18nStoreApi {
+    getState: () => I18nStore;
+    getInitialState: () => I18nStore;
+    setState: (partial: Partial<I18nStore> | ((state: I18nStore) => Partial<I18nStore>)) => void;
+    subscribe: (listener: I18nStoreListener) => () => void;
+}

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

@@ -0,0 +1,10 @@
+export * from "./array";
+export * from "./cache";
+export * from "./guards";
+export * from "./http";
+export * from "./i18n";
+export * from "./log";
+export * from "./number";
+export * from "./object";
+export * from "./string";
+export * from "./types";

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

@@ -0,0 +1,32 @@
+export declare const ANSI_RESET = "\u001B[0m";
+export declare const ansiColors: {
+    readonly black: "\u001B[30m";
+    readonly red: "\u001B[31m";
+    readonly green: "\u001B[32m";
+    readonly yellow: "\u001B[33m";
+    readonly blue: "\u001B[34m";
+    readonly magenta: "\u001B[35m";
+    readonly pink: "\u001B[95m";
+    readonly cyan: "\u001B[36m";
+    readonly white: "\u001B[37m";
+    readonly gray: "\u001B[90m";
+};
+export type LogColor = keyof typeof ansiColors;
+export type ColorLogOptions = {
+    color?: LogColor;
+    prefix?: string;
+    suffix?: string;
+};
+export type ColorLogAffixes = Omit<ColorLogOptions, 'color'>;
+export declare const colorize: (message: unknown, color?: LogColor) => string;
+export declare const joinColorized: (...messages: readonly unknown[]) => string;
+export declare const logJoinColorized: (...messages: readonly unknown[]) => void;
+export declare function colorLog(color: LogColor, ...data: unknown[]): void;
+export declare function colorLog(...data: unknown[]): void;
+export declare const logColor: (color: LogColor, ...data: unknown[]) => void;
+export declare const logColorized: (...messages: readonly unknown[]) => void;
+export declare const logGreen: (...data: unknown[]) => void;
+export declare const logYellow: (...data: unknown[]) => void;
+export declare const logPink: (...data: unknown[]) => void;
+export declare const logWhite: (...data: unknown[]) => void;
+export declare const logRed: (...data: unknown[]) => void;

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

@@ -0,0 +1,2 @@
+export declare const clamp: (value: number, min: number, max: number) => number;
+export declare const toFiniteNumber: (value: unknown, fallback?: number) => number;

package/types/packages/common/object/filterEmpty.d.ts

@@ -0,0 +1,2 @@
+export declare function filterEmpty<T>(data: T): T | undefined;
+export declare const filtereEmpty: typeof filterEmpty;

package/types/packages/common/object/filtereEmpty.d.ts

@@ -0,0 +1 @@
+export { filterEmpty, filtereEmpty } from "./filterEmpty";

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

@@ -0,0 +1,4 @@
+export * from "./filterEmpty";
+export declare const pick: <T extends object, K extends keyof T>(target: T, keys: readonly K[]) => Pick<T, K>;
+export declare const omit: <T extends object, K extends keyof T>(target: T, keys: readonly K[]) => Omit<T, K>;
+export declare const mapValues: <T extends object, TResult>(target: T, mapper: <K extends keyof T>(value: T[K], key: K) => TResult) => { [K in keyof T]: TResult; };

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

@@ -0,0 +1,3 @@
+export declare const isBlank: (value: string | null | undefined) => boolean;
+export declare const capitalize: (value: string) => string;
+export declare const kebabCase: (value: string) => string;

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

@@ -0,0 +1,3 @@
+export type Maybe<T> = T | null | undefined;
+export type Primitive = string | number | boolean | bigint | symbol | null | undefined;
+export type Dictionary<T = unknown> = Record<string, T>;

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

@@ -0,0 +1,15 @@
+export type EnvType = {
+    local: 'local' | string;
+    bate: 'bate' | string;
+    prod: 'prod' | string;
+};
+export type EnvKeys = keyof EnvType;
+export interface EnvReturn {
+    isLocal(): boolean;
+    isBate(): boolean;
+    isProd(): boolean;
+    get(): EnvType[keyof EnvType];
+    getEnvKeys(): EnvType;
+}
+declare const _default: () => EnvReturn;
+export default _default;

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

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

@@ -0,0 +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

@@ -0,0 +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

@@ -0,0 +1,8 @@
+import type { KoaApp } from "../types";
+/**
+ *  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

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

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

@@ -0,0 +1,36 @@
+import { KoaApp } from "../types";
+/**
+ *  xx/model/* ->
+ *  [
+ *      {
+ *          model:{
+ *              key: '',
+ *              ...model.config
+ *          }
+ *          project: {
+ *              [projectKey]: {
+ *                  ...project.config,
+ *                  key:string,
+ *              }
+ *          }
+ *      }
+ *  ]
+ *
+ */
+export interface ModelItem {
+    model: {
+        key: string;
+        [k: string]: any;
+    };
+    project: {
+        key: string;
+        [k: string]: any;
+    };
+}
+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

@@ -0,0 +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

@@ -0,0 +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

@@ -0,0 +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

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