@_tc/template-core 0.1.16 → 0.2.0-bate.1

package/model/packages/react/ui/components/table/table.d.ts

@@ -0,0 +1,29 @@
+import * as React from "react";
+type TableFixed = 'left' | 'right';
+type TableFixedCellProps = {
+    fixed?: TableFixed;
+    fixedOffset?: React.CSSProperties['left'];
+    fixedShadow?: boolean;
+    fixedActive?: boolean;
+    fixedZIndex?: React.CSSProperties['zIndex'];
+};
+declare const Table: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLTableElement> & {
+    containerClassName?: string;
+    containerRef?: React.Ref<HTMLDivElement>;
+    onContainerScroll?: React.UIEventHandler<HTMLDivElement>;
+} & React.RefAttributes<HTMLTableElement>>;
+declare const TableHeader: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLTableSectionElement> & React.RefAttributes<HTMLTableSectionElement>>;
+declare const TableBody: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLTableSectionElement> & React.RefAttributes<HTMLTableSectionElement>>;
+declare const TableFooter: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLTableSectionElement> & React.RefAttributes<HTMLTableSectionElement>>;
+declare const TableRow: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLTableRowElement> & React.RefAttributes<HTMLTableRowElement>>;
+declare const TableHead: React.ForwardRefExoticComponent<React.ThHTMLAttributes<HTMLTableCellElement> & {
+    isAction?: boolean;
+    showSeparator?: boolean;
+    hideSeparatorWhenFixedActive?: boolean;
+} & TableFixedCellProps & React.RefAttributes<HTMLTableCellElement>>;
+declare const TableCell: React.ForwardRefExoticComponent<React.TdHTMLAttributes<HTMLTableCellElement> & {
+    isAction?: boolean;
+} & TableFixedCellProps & React.RefAttributes<HTMLTableCellElement>>;
+declare const TableCaption: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLTableCaptionElement> & React.RefAttributes<HTMLTableCaptionElement>>;
+export { Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow };
+export type { TableFixed };

package/model/packages/react/ui/i18n/I18nProvider.d.ts

@@ -0,0 +1,12 @@
+import type { I18nLanguage, I18nResources } from "@tc/common/i18n";
+import { type ReactNode } from "react";
+export interface I18nProviderProps {
+    language?: I18nLanguage;
+    fallbackLanguage?: I18nLanguage;
+    resources?: I18nResources;
+    mergeResources?: boolean;
+    persist?: boolean;
+    storageKey?: string;
+    children: ReactNode;
+}
+export declare function I18nProvider({ language, fallbackLanguage, resources, mergeResources, persist, storageKey, children, }: I18nProviderProps): import("react/jsx-runtime").JSX.Element;

package/model/packages/react/ui/i18n/index.d.ts

@@ -0,0 +1,3 @@
+export * from "@tc/common/i18n";
+export * from "./I18nProvider";
+export * from "./useI18n";

package/model/packages/react/ui/i18n/useI18n.d.ts

@@ -0,0 +1,8 @@
+import type { I18nInterpolationValues, I18nTranslateOptions } from "@tc/common/i18n";
+export declare const useI18nStore: import("../../../../../fe/packages/react/ui/index").StoreHook<{
+    getState: () => import("../../../../../fe/packages/react/ui/index").I18nStore;
+    getInitialState: () => import("../../../../../fe/packages/react/ui/index").I18nStore;
+    setState: (partial: Partial<import("../../../../../fe/packages/react/ui/index").I18nStore> | ((state: import("../../../../../fe/packages/react/ui/index").I18nStore) => Partial<import("../../../../../fe/packages/react/ui/index").I18nStore>)) => void;
+    subscribe: (listener: import("../../../../../fe/packages/react/ui/index").I18nStoreListener) => () => void;
+}>;
+export declare function useI18n(): <T = string>(key: string, fillingData?: I18nInterpolationValues, options?: I18nTranslateOptions) => string | T;

package/model/packages/react/ui/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./components";
+export * from "./i18n";
+export * from "./lib/createStoreHook";
+export * from "./lib/utils";

package/model/packages/react/ui/lib/createStoreHook.d.ts

@@ -0,0 +1,8 @@
+import type { ExtractState, StoreApi } from "zustand/vanilla";
+type ReadonlyStoreApi<T> = Pick<StoreApi<T>, 'getState' | 'getInitialState' | 'subscribe'>;
+export type StoreHook<TStore extends ReadonlyStoreApi<unknown>> = {
+    (): ExtractState<TStore>;
+    <T>(selector: (state: ExtractState<TStore>) => T): T;
+};
+export declare function createStoreHook<TStore extends ReadonlyStoreApi<unknown>>(store: TStore): StoreHook<TStore>;
+export {};

package/model/packages/react/ui/lib/export.d.ts

@@ -0,0 +1,21 @@
+import { type TableColumnDef } from "../../../../../fe/packages/react/ui/components/index";
+export declare const ExportType: {
+    readonly all: 0;
+    readonly current: 1;
+};
+export type ExportType = (typeof ExportType)[keyof typeof ExportType];
+interface ExportExcelParams<T> {
+    fetchData: (pageNum: number, pageSize: number, searchParams?: Record<string, any>) => Promise<{
+        records: T[];
+        total: number;
+    }>;
+    columns: TableColumnDef<T>[];
+    exportType: ExportType;
+    currentPage?: number;
+    pageSize?: number;
+    maxCount?: number;
+    currentPageData?: T[];
+    fileName?: string;
+}
+export declare function exportToExcel<T>(options: ExportExcelParams<T>): Promise<void>;
+export {};

package/model/packages/react/ui/lib/utils.d.ts

@@ -0,0 +1,9 @@
+import { type ClassValue } from "clsx";
+export declare function cn(...inputs: ClassValue[]): string;
+export declare function formatDateTime(date: string | Date | null | undefined | number, format?: string): string;
+export declare function formatDate(date: string | Date | null | undefined): string;
+export declare function formatTime(date: string | Date | null | undefined): string;
+export declare function generateStartEndTime(dates: string[] | Date[] | null | undefined): {
+    start: string;
+    end: string;
+};

package/model/packages/react/ui/stores/breadcrumb.d.ts

@@ -0,0 +1,14 @@
+import type { BreadcrumbItemData } from "../../../../../fe/packages/react/ui/components/breadcrumb/index";
+type State = {
+    items: BreadcrumbItemData[];
+};
+type Actions = {
+    setItems: (items: BreadcrumbItemData[]) => void;
+    addItem: (item: BreadcrumbItemData) => void;
+    removeItem: (id: string | number) => void;
+    clearItems: () => void;
+    setActiveItem: (id: string | number) => void;
+};
+export declare const breadcrumbStore: import("zustand").UseBoundStore<import("zustand").StoreApi<State & Actions>>;
+export declare const useBreadcrumbStore: import("zustand").UseBoundStore<import("zustand").StoreApi<State & Actions>>;
+export {};

package/model/packages/react/ui/stores/language.d.ts

@@ -0,0 +1,3 @@
+export { getLanguage, i18n, t } from "@tc/common/i18n";
+export type { I18nLanguage as Language } from "@tc/common/i18n";
+export { useI18nStore as useLanguages } from "../i18n";

package/model/packages/react/ui/types/index.d.ts

@@ -0,0 +1 @@
+export type MOmit<T, K extends keyof T> = Omit<T, K>;

package/model/typings/type.d.ts

@@ -0,0 +1,4 @@
+export type MOmit<T, K extends keyof T> = Omit<T, K>;
+export type UnionToTuple<T> = [T] extends [never] ? [] : ((t: T) => T) extends (t: infer U) => infer U ? [...UnionToTuple<Exclude<T, U>>, U] : never;
+export type MergeType<T extends unknown[]> = T extends [infer F, ...infer R] ? F & (R extends [] ? MergeType<R> : {}) : {};
+export type GetInstance<T extends (...args: never[]) => unknown> = T extends (...args: never[]) => infer R ? R extends new () => infer C ? C : R extends Promise<infer P> ? P extends new () => infer C2 ? C2 : never : never : never;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@_tc/template-core",
-  "version": "0.1.16",
+  "version": "0.2.0-bate.1",
   "description": "A full-stack TypeScript admin framework powered by Koa, React, and Vite - monorepo root",
   "types": "./types/index.d.ts",
   "exports": {
@@ -24,15 +24,25 @@
       "require": "./fe/frontend/src/index.js",
       "types": "./fe/frontend/src/index.d.ts"
     },
+    "./fe/common/request": {
+      "import": "./fe/frontend/src/common/request.js",
+      "require": "./fe/frontend/src/common/request.js",
+      "types": "./fe/frontend/src/common/request.d.ts"
+    },
     "./fe/rc": {
-      "import": "./fe/packages/ui/react/index.js",
-      "require": "./fe/packages/ui/react/index.js",
-      "types": "./fe/packages/ui/react/index.d.ts"
+      "import": "./fe/packages/react/ui/index.js",
+      "require": "./fe/packages/react/ui/index.js",
+      "types": "./fe/packages/react/ui/index.d.ts"
+    },
+    "./fe/rc/hooks/*": {
+      "import": "./fe/packages/react/hooks/*",
+      "require": "./fe/packages/react/hooks/*",
+      "types": "./fe/packages/react/hooks/*"
     },
     "./fe/rc/*": {
-      "import": "./fe/packages/ui/react/*",
-      "require": "./fe/packages/ui/react/*",
-      "types": "./fe/packages/ui/react/*"
+      "import": "./fe/packages/react/ui/*",
+      "require": "./fe/packages/react/ui/*",
+      "types": "./fe/packages/react/ui/*"
     },
     "./fe/*": {
       "import": "./fe/frontend/src/*",
@@ -41,7 +51,7 @@
     },
     "./fe/tailwind_ui.css": "./fe/frontend/src/main.css",
     "./model": {
-      "types": "./model/index.d.ts"
+      "types": "./model/model/index.d.ts"
     }
   },
   "dependencies": {
@@ -59,7 +69,12 @@
     "tailwindcss": "4.2.4"
   },
   "peerDependencies": {
-    "@types/node": ">=18.0.0",
+    "@types/json-schema": "7.0.15",
+    "@types/md5": "2.3.6",
+    "@types/node": "20.19.39",
+    "@types/nunjucks": "3.2.6",
+    "@types/koa-router": "7.4.9",
+    "@types/koa": "2.15.0",
     "@vitejs/plugin-react": "6.0.1",
     "clsx": "^2.1.0",
     "date-fns": "^3.6.0",

package/types/app/controller/view.d.ts

@@ -1,7 +1,8 @@
+import type Koa from "koa";
 import type { Ctx, KoaApp } from "../type";
 declare const getViewController: (app: KoaApp) => {
     new (): {
-        renderPage(ctx: Ctx): Promise<void>;
+        renderPage(ctx: Ctx, next: Koa.Next): Promise<void>;
     };
 };
 export default getViewController;

package/types/app/extends/crypto.d.ts

@@ -0,0 +1,64 @@
+import type { KoaApp } from "../type";
+export type CryptoHashAlgorithm = 'sha256' | 'sha384' | 'sha512';
+export interface HmacSignOptions {
+    secret?: string;
+    algorithm?: CryptoHashAlgorithm;
+}
+export interface SignedPayloadOptions extends HmacSignOptions {
+    separator?: string;
+}
+export interface VerifySignedPayloadOptions extends HmacSignOptions {
+    separator?: string;
+}
+export interface CryptoExtend {
+    /**
+     * 将 UTF-8 字符串或二进制数据编码为 base64url 字符串。
+     *
+     * base64url 不包含 `+`、`/` 和结尾 `=`，适合放在 URL、Cookie、Header 或 token 片段中。
+     */
+    base64urlEncode: (value: string | Buffer | Uint8Array) => string;
+    /**
+     * 将 base64url 字符串解码为 UTF-8 字符串。
+     *
+     * 常用于还原 token payload；如果原始内容不是 UTF-8 文本，请使用 `base64urlDecodeToBuffer`。
+     */
+    base64urlDecode: (value: string) => string;
+    /**
+     * 将 base64url 字符串解码为 Buffer。
+     *
+     * 适合处理二进制 payload，避免 UTF-8 字符串转换造成数据损坏。
+     */
+    base64urlDecodeToBuffer: (value: string) => Buffer;
+    /**
+     * 使用 HMAC 对文本内容签名，并返回 base64url 签名。
+     *
+     * 默认使用 `app.config.signKey` 作为密钥、`sha256` 作为算法；可通过 options 覆盖。
+     */
+    hmacSign: (payload: string, options?: HmacSignOptions) => string;
+    /**
+     * 常量时间比较两个字符串是否相等。
+     *
+     * 用于比较密码、签名、token 等敏感值，降低普通字符串比较带来的计时攻击风险。
+     */
+    safeEqual: (left: string, right: string) => boolean;
+    /**
+     * 创建带签名的 payload 字符串。
+     *
+     * 返回格式默认为 `${base64url(JSON.stringify(payload))}.${hmacSign(encodedPayload)}`，
+     * 适合生成轻量登录 token 或一次性校验串。
+     */
+    createSignedPayload: <T>(payload: T, options?: SignedPayloadOptions) => string;
+    /**
+     * 验证带签名的 payload 字符串并还原原始对象。
+     *
+     * 签名不匹配、格式错误或 JSON 解析失败时返回 null，不向外抛出解析异常。
+     */
+    verifySignedPayload: <T = unknown>(signedPayload: string | null | undefined, options?: VerifySignedPayloadOptions) => T | null;
+}
+/**
+ * 创建框架加密扩展对象。
+ *
+ * 该扩展会挂载到 `app.extends.crypto`，用于复用 base64url 编码、HMAC 签名、签名 payload 和安全比较能力。
+ */
+declare const _default: (app: KoaApp) => CryptoExtend;
+export default _default;

package/types/app/extends/localCacheHtmlEtag.d.ts

@@ -0,0 +1,10 @@
+/**
+ * htmlEtag本地储存
+ */
+declare const localCacheHtmlEtag: (app: import("../../packages/core/index").KoaApp) => {
+    keepFreshFEBuildKey: () => void;
+    hasEtag: (key: string) => boolean;
+    getEtag: (key: string) => string | null;
+    setEtag: (key: string, value: string) => void;
+};
+export default localCacheHtmlEtag;

package/types/app/extends/render-view.d.ts

@@ -0,0 +1,7 @@
+import type { Ctx, KoaApp } from "../type";
+/**
+ * 挂载模板资源地址 默认是 public/dist 目录
+ *
+ */
+declare const _default: (app: KoaApp) => (viewPath: string, ctx: Ctx, context?: Record<string, unknown>) => string;
+export default _default;

package/types/app/middlewares/project-handler.d.ts

@@ -0,0 +1,4 @@
+import type Koa from "koa";
+import type { Ctx, KoaApp } from "../type";
+declare const _default: (app: KoaApp) => (ctx: Ctx, next: Koa.Next) => Promise<void>;
+export default _default;

package/types/app/middlewares/request-parameter-parsing.d.ts

@@ -0,0 +1,7 @@
+/**
+ * - 统一处理请求参数获取
+ * - 除了params  因为params 必须经过router才会有
+ * - 而当前中间件是在 router之前追加，router params 仍然从 ctx.params 获取
+ */
+declare const requestParameterParsing: (app: import("../../packages/core/index").KoaApp) => (ctx: import("app/type").Ctx, next: import("koa").Next) => Promise<void>;
+export default requestParameterParsing;

package/types/app/router/project.d.ts

@@ -1,4 +1,4 @@
-import type { KoaApp } from "../type";
 import type Router from "koa-router";
+import type { KoaApp } from "../type";
 declare const _default: (app: KoaApp, router: Router) => void;
 export default _default;

package/types/app/service/base.d.ts

@@ -3,7 +3,7 @@ declare const getBaseService: (app: KoaApp) => {
     new (): {
         get app(): KoaApp;
         get config(): KoaApp["config"];
-        get curl(): import("../extend/$fetch").NodeFetch;
+        get curl(): import("../extends/$fetch").NodeFetch;
     };
 };
 export default getBaseService;

package/types/app/service/project.d.ts

@@ -51,7 +51,7 @@ declare const getProjectService: (app: KoaApp) => {
         getProject: (projectKey: string) => ProjectItem | null;
         get app(): KoaApp;
         get config(): KoaApp["config"];
-        get curl(): import("../extend/$fetch").NodeFetch;
+        get curl(): import("../extends/$fetch").NodeFetch;
     };
 };
 export default getProjectService;

package/types/app/type.d.ts

@@ -1,5 +1,35 @@
+import type { IncomingHttpHeaders } from "http";
+import type Koa from "koa";
+import type Router from "koa-router";
+import type { ParsedUrlQuery } from "querystring";
 export type KoaApp = import('./typings').KoaApp;
 export type KoaRouter = import('./typings').KoaRouter;
-export type Ctx = KoaApp['context'];
+export type CtxParams = Router.IRouterParamContext['params'];
+export interface CtxReqData {
+    /**
+     * URL query 参数。
+     */
+    query: ParsedUrlQuery;
+    /**
+     * bodyparser 解析后的请求 body。
+     */
+    body: unknown;
+    /**
+     * 原始请求 headers。
+     */
+    headers: IncomingHttpHeaders;
+    /**
+     * 便捷合并层：当前中间件会按 query -> body 的顺序合并。
+     * 字段有冲突时，后面的来源会覆盖前面的来源；需要精确来源时请使用 query/body/headers。
+     */
+    data: Record<string, unknown>;
+}
+export type Ctx = Router.RouterContext<Koa.DefaultState, Koa.DefaultContext> & {
+    params: CtxParams;
+    reqData?: CtxReqData;
+};
+export type ExtendFN<T extends object = object> = (app: KoaApp) => T;
+export type MiddlewareFN = (app: KoaApp) => (ctx: Ctx, next: Koa.Next) => Promise<void>;
+export type RouterFN = (app: KoaApp, router: KoaRouter) => void;
 export type ControllerFN<T extends object = object> = (app: KoaApp) => new () => T;
 export type ServiceFN<T extends object = object> = (app: KoaApp) => new () => T;

package/types/app/typings.d.ts

@@ -1,15 +1,17 @@
 import type { FrameworkAugment, KoaApp, KoaAppExtensions, KoaRouter } from "../packages/core/index";
-import { GetInstance } from "typings/type";
 import type { DefaultAppConfig } from "../config/config.default";
 import type getProjectController from "./controller/project";
 import type getViewController from "./controller/view";
-import type getFetch from "./extend/$fetch";
-import type getDB from "./extend/db";
-import type generateErrorMessage from "./extend/generateErrorMessage";
-import type getLogger from "./extend/logger";
-import type parsingParamsOnUrl from "./extend/parsingParamsOnUrl";
-import renderView from "./extend/render-view";
+import type getFetch from "./extends/$fetch";
+import type getCrypto from "./extends/crypto";
+import type getDB from "./extends/db";
+import type generateErrorMessage from "./extends/generateErrorMessage";
+import type localCacheHtmlEtag from "./extends/localCacheHtmlEtag";
+import type getLogger from "./extends/logger";
+import type parsingParamsOnUrl from "./extends/parsingParamsOnUrl";
+import type renderView from "./extends/render-view";
 import type getProjectService from "./service/project";
+import { GetInstance } from "typings/type";
 type UnwrapPromise<T> = T extends Promise<infer U> ? U : T;
 declare module '../packages/core/index' {
     namespace FrameworkAugment {
@@ -21,6 +23,7 @@ declare module '../packages/core/index' {
             view: GetInstance<typeof getViewController>;
         }
         interface IExtendsAugmented {
+            crypto: ReturnType<typeof getCrypto>;
             db: UnwrapPromise<ReturnType<typeof getDB>>;
             logger: UnwrapPromise<ReturnType<typeof getLogger>>;
             generateErrorMessage: ReturnType<typeof generateErrorMessage>;
@@ -28,11 +31,13 @@ declare module '../packages/core/index' {
             $fetch: ReturnType<typeof getFetch>;
             nunjucksEnv: import('nunjucks').Environment;
             renderView: ReturnType<typeof renderView>;
+            localCacheHtmlEtag: ReturnType<typeof localCacheHtmlEtag>;
         }
         interface IMiddlewaresAugmented {
             errorHandle: import('koa').Middleware;
             apiSignVerify: import('koa').Middleware;
             apiParamsVerify: import('koa').Middleware;
+            requestParameterParsing: import('koa').Middleware;
             projectHandler: import('koa').Middleware;
         }
         interface AppConfigAugmented extends Partial<DefaultAppConfig> {

package/types/bundler/buildBE.d.ts

@@ -0,0 +1,13 @@
+import type { Alias } from "vite";
+import type { BuildEntriesConfig, BuildEntriesResult, BuildFormat } from "../scripts/vite-build/types";
+export type BuildBEAlias = Record<string, string> | Alias[];
+export type BuildBEFormat = BuildFormat;
+export type BuildBEOptions = Omit<BuildEntriesConfig, 'input' | 'format' | 'outDir' | 'rootDir' | 'alias'> & {
+    rootDir?: string;
+    input?: string[];
+    outDir?: string;
+    format?: BuildBEFormat | BuildBEFormat[];
+    alias?: BuildBEAlias;
+};
+export type BuildBEResult = BuildEntriesResult;
+export declare function buildBE(options?: BuildBEOptions): Promise<BuildBEResult>;

package/types/bundler/defaultRouteGuard.d.ts

@@ -0,0 +1,2 @@
+declare const _default: {};
+export default _default;

package/types/bundler/index.d.ts

@@ -1,2 +1,4 @@
 import type { BuildFEOptions } from "./state";
-export declare const buildFE: (mode: "dev" | "prod", options?: BuildFEOptions) => void;
+export { buildBE } from "./buildBE";
+export type { BuildBEAlias, BuildBEFormat, BuildBEOptions, BuildBEResult } from "./buildBE";
+export declare const buildFE: (mode: "dev" | "prod", options?: BuildFEOptions) => Promise<void>;

package/types/bundler/state.d.ts

@@ -11,6 +11,10 @@ export interface BuildFEOptions {
      *   - Maybe you really do not need it.
      */
     output?: 'frame' | 'run' | (() => string);
+    /**
+     * Compress the html content emitted by Vite before writing final `.tpl` / `.html` files.
+     */
+    minifyHtml?: boolean;
 }
 export declare const buildFESharedState: {
     options: BuildFEOptions;

package/types/bundler/utils.d.ts

@@ -1,3 +1,4 @@
+import { Plugin } from "vite";
 /**
  *
  * 寻找 frontend\/**\/*.entry.[j|t]s(x)?
@@ -6,4 +7,8 @@
 export declare function entries(): Record<string, string>;
 export declare function outDir(): string;
 export declare const watchFiles: (callback?: () => Promise<any>) => Promise<void>;
+/**
+ * 打包完成后触发
+ */
+export declare function generateBuildKeyPlugin(): Plugin;
 export declare const VBuildFE: (input: Record<string, string>, OperatingEnv?: "dev" | "prod") => Promise<void>;

package/types/config/config.default.d.ts

@@ -40,6 +40,32 @@ export interface DefaultAppConfig {
     viewsPath?: string;
     nunjucks?: import('nunjucks').ConfigureOptions;
     notFoundRedirectCount?: number;
+    /**
+     * 登陆验证相关
+     */
+    auth?: {
+        /**
+         * 短token 获取的key
+         * @default 'Authorization'
+         */
+        ATKey?: string;
+        /**
+         * 长token 获取的key
+         * @default 'RT'
+         */
+        RTKey?: string;
+    };
 }
-declare const _default: DefaultAppConfig;
+declare const _default: {
+    frameName: string;
+    signKey: string;
+    apiSignVerify: {
+        whiteList: never[];
+    };
+    auth: {
+        ATKey: string;
+        RTKey: string;
+    };
+    notFoundRedirectCount: number;
+};
 export default _default;

package/types/index.d.ts

@@ -3,8 +3,9 @@ import type Router from "koa-router";
 import "./app/typings";
 import { MOmit } from "./typings/type";
 export type { FrameworkAugment, KoaApp } from "./packages/core/index";
-export type { ControllerFN, Ctx, ServiceFN } from "./app/type";
-export type { DB, DBDataOptions, DBDataRecord, DBFactory, DBRunResult, FrameworkDB, ListDBDataOptions, SQLiteParams, SQLiteValue, } from "./app/extend/db";
+export type { CryptoExtend, CryptoHashAlgorithm, HmacSignOptions, SignedPayloadOptions, VerifySignedPayloadOptions, } from "./app/extends/crypto";
+export type { DB, DBDataOptions, DBDataRecord, DBFactory, DBRunResult, FrameworkDB, ListDBDataOptions, SQLiteParams, SQLiteValue, } from "./app/extends/db";
+export type { ControllerFN, Ctx, MiddlewareFN, RouterFN, ServiceFN } from "./app/type";
 export type { Router };
 export declare const serverStart: (options?: MOmit<StartOptions, "frameBaseDir">) => Promise<import("./packages/core/index").KoaApp>;
 export declare const baseFn: {
@@ -22,7 +23,7 @@ export declare const baseFn: {
         new (): {
             get app(): import("./app/type").KoaApp;
             get config(): import("./app/type").KoaApp["config"];
-            get curl(): import("./app/extend/$fetch").NodeFetch;
+            get curl(): import("./app/extends/$fetch").NodeFetch;
         };
     };
 };

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

@@ -1,3 +1,19 @@
 export declare const isBlank: (value: string | null | undefined) => boolean;
 export declare const capitalize: (value: string) => string;
 export declare const kebabCase: (value: string) => string;
+type JoinStrValue = string | number | boolean | null | undefined;
+type JoinStrConditionalValue = readonly [condition: unknown, value: JoinStrValue];
+type JoinStrInput = JoinStrValue | JoinStrConditionalValue;
+type JoinStrOptions = {
+    separator?: string;
+};
+type JoinStrArgs = readonly JoinStrInput[] | readonly [...JoinStrInput[], JoinStrOptions];
+/**
+ * 拼接字符串片段，自动跳过空值和不满足条件的片段。
+ *
+ * @example
+ * joinStr('btn', isActive && 'active', [disabled, 'disabled'], { separator: ' ' })
+ * // => 'btn active disabled'
+ */
+export declare const joinStr: (...strings: JoinStrArgs) => string;
+export {};

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

@@ -2,7 +2,7 @@ import type { KoaApp } from "../types";
 /**
  * config loader 只处理一级
  *
- * @param app 加载 xx/config/ 下的文件
+ * @param app 加载 xx/config/ 下的文件 也就是根目录下的
  *  config/config.default.(js|ts)
  */
 declare const _default: (app: KoaApp) => void;

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

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

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

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

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

@@ -48,6 +48,10 @@ export interface KoaAppExtensions {
      * 存着 框架 以及业务方的 app路径
      */
     paths: AppPathInfo[];
+    /**
+     * 静态资源目录列表
+     */
+    publicsPath: string[];
     /**
      * 服务生命周期
      */
@@ -109,6 +113,13 @@ export interface StartOptions {
      * - 主要是配合 buildFE 修改了输出路径时使用
      */
     additionalPublicPaths?: string | string[];
+    /**
+     * API 访问前缀。
+     * 为空或空字符串时会使用默认值 `/api`。
+     * 配置后会影响内置项目 API 路由，以及 API 参数校验、签名校验、项目处理等中间件的路径匹配。
+     * @default '/api'
+     */
+    apiPrefix?: string;
     /**
      * - 页面访问前缀 默认为 /
      * @default '/'

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