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

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

@@ -0,0 +1,20 @@
+import type { ChangeEvent, TextareaHTMLAttributes } from "react";
+export type TextareaProps = Omit<TextareaHTMLAttributes<HTMLTextAreaElement>, "value" | "onChange" | "defaultValue"> & {
+    value?: string;
+    onChange?: (v: string, e: ChangeEvent<HTMLTextAreaElement>) => void;
+    defaultValue?: string;
+    maxLength?: number;
+    showCount?: boolean;
+    placeholder?: string;
+    textareaClassName?: string;
+};
+declare const Textarea: import("react").ForwardRefExoticComponent<Omit<TextareaHTMLAttributes<HTMLTextAreaElement>, "value" | "defaultValue" | "onChange"> & {
+    value?: string;
+    onChange?: (v: string, e: ChangeEvent<HTMLTextAreaElement>) => void;
+    defaultValue?: string;
+    maxLength?: number;
+    showCount?: boolean;
+    placeholder?: string;
+    textareaClassName?: string;
+} & import("react").RefAttributes<HTMLTextAreaElement>>;
+export { Textarea };

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

@@ -0,0 +1 @@
+export * from "./Textarea";

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

@@ -0,0 +1,8 @@
+export interface TooltipProps {
+    content: React.ReactNode;
+    children: React.ReactElement;
+    placement?: "top" | "bottom" | "left" | "right";
+    visible?: boolean;
+    className?: string;
+}
+export declare function Tooltip({ content, children, placement, visible, className, }: TooltipProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1 @@
+export * from "./Tooltip";

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

@@ -0,0 +1,18 @@
+export interface TreeNode {
+    id: string | number;
+    name: string;
+    desctext?: string;
+    children?: TreeNode[];
+}
+export interface TreeSelectProps {
+    data: TreeNode[];
+    value?: (string | number)[];
+    onChange?: (keys: {
+        checked: (string | number)[];
+        indeterminate: (string | number)[];
+    }) => void;
+    labelField?: 'name' | 'desctext';
+    checkable?: boolean;
+    className?: string;
+}
+export declare function TreeSelect({ data, value, onChange, labelField, checkable, className, }: TreeSelectProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1 @@
+export * from "./TreeSelect";

package/model/packages/react/ui/components/Upload/ImageUpload.d.ts

@@ -0,0 +1,8 @@
+export interface ImageUploadProps {
+    accept?: string;
+    maxCount?: number;
+    value?: string[];
+    onChange?: (urls: string[]) => void;
+    beforeChange?: (file: File) => boolean | void;
+}
+export declare function ImageUpload({ accept, maxCount, value, onChange, beforeChange }: ImageUploadProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,13 @@
+import type { ChangeEvent, ReactNode, RefObject } from "react";
+export interface FileUploadProps {
+    inputRef?: RefObject<HTMLInputElement | null>;
+    accept?: string;
+    multiple?: boolean;
+    onChange?: (event: ChangeEvent<HTMLInputElement>) => void;
+    selectLabel: ReactNode;
+    labelClassName?: string;
+    showClear?: boolean;
+    onClear?: () => void;
+    clearLabel?: ReactNode;
+}
+export declare function FileUpload({ inputRef, accept, multiple, onChange, selectLabel, labelClassName, showClear, onClear, clearLabel, }: FileUploadProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,2 @@
+export * from "./ImageUpload";
+export * from "./Upload";

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

@@ -0,0 +1,34 @@
+declare const Breadcrumb: import("react").ForwardRefExoticComponent<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLElement>, HTMLElement>, "ref"> & {
+    separator?: React.ReactNode;
+} & import("react").RefAttributes<HTMLElement>>;
+declare const BreadcrumbList: import("react").ForwardRefExoticComponent<Omit<import("react").DetailedHTMLProps<import("react").OlHTMLAttributes<HTMLOListElement>, HTMLOListElement>, "ref"> & import("react").RefAttributes<HTMLOListElement>>;
+declare const BreadcrumbItem: import("react").ForwardRefExoticComponent<Omit<import("react").DetailedHTMLProps<import("react").LiHTMLAttributes<HTMLLIElement>, HTMLLIElement>, "ref"> & import("react").RefAttributes<HTMLLIElement>>;
+declare const BreadcrumbLink: import("react").ForwardRefExoticComponent<Omit<import("react").DetailedHTMLProps<import("react").AnchorHTMLAttributes<HTMLAnchorElement>, HTMLAnchorElement>, "ref"> & {
+    asChild?: boolean;
+} & import("react").RefAttributes<HTMLAnchorElement>>;
+declare const BreadcrumbPage: import("react").ForwardRefExoticComponent<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLSpanElement>, HTMLSpanElement>, "ref"> & {
+    active?: boolean;
+    onClose?: () => void;
+    closable?: boolean;
+} & import("react").RefAttributes<HTMLSpanElement>>;
+declare const BreadcrumbSeparator: {
+    ({ children, className, ...props }: React.ComponentProps<"li">): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+declare const BreadcrumbEllipsis: {
+    ({ className, ...props }: React.ComponentProps<"span">): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+export { Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator, };
+export interface BreadcrumbItemData {
+    label: string;
+    desctext?: string;
+    id: string | number;
+    path?: string;
+    active?: boolean;
+    closable?: boolean;
+}
+export interface SimpleBreadcrumbProps {
+    className?: string;
+}
+export declare function SimpleBreadcrumb({ className }: SimpleBreadcrumbProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1 @@
+export * from "./breadcrumb";

package/model/packages/react/ui/components/hooks/useDropdownPositioning.d.ts

@@ -0,0 +1,42 @@
+import type { RefObject } from "react";
+export type DropdownPlacement = "bottom-end" | "bottom-start" | "left-start" | "top-end" | "top-start" | "right-start" | "right-end";
+export type DropdownPosition = {
+    top: number;
+    left?: number;
+    right?: number;
+    width?: number;
+};
+export type DropdownPositioningContext = {
+    anchorRect: DOMRect;
+    contentRect?: DOMRect;
+    containerRect?: DOMRect;
+    viewportWidth: number;
+    viewportHeight: number;
+    placement: DropdownPlacement;
+    offset: number;
+    matchAnchorWidth: boolean;
+};
+export type DropdownPositioningStrategy = (context: DropdownPositioningContext) => DropdownPosition;
+export type UseDropdownPositioningOptions = {
+    open: boolean;
+    anchorRef: RefObject<HTMLElement | null>;
+    contentRef: RefObject<HTMLElement | null>;
+    placement?: DropdownPlacement;
+    offset?: number;
+    matchAnchorWidth?: boolean;
+    strategy?: DropdownPositioningStrategy;
+    estimateSize?: () => {
+        width?: number;
+        height?: number;
+    };
+    watchDeps?: readonly unknown[];
+    containerRef?: RefObject<HTMLElement | null>;
+    positionMode?: "fixed" | "absolute";
+};
+export type UseDropdownPositioningResult = {
+    position: DropdownPosition;
+    ready: boolean;
+    updatePosition: () => void;
+};
+export declare const getDefaultDropdownPosition: DropdownPositioningStrategy;
+export declare function useDropdownPositioning({ open, anchorRef, contentRef, placement, offset, matchAnchorWidth, strategy, estimateSize, watchDeps, containerRef, positionMode, }: UseDropdownPositioningOptions): UseDropdownPositioningResult;

package/model/packages/react/ui/components/hooks/useInputController.d.ts

@@ -0,0 +1,20 @@
+interface IParams<T> {
+    ref: React.ForwardedRef<T>;
+    defaultValue?: string;
+    controlledValue?: string;
+    disabled?: boolean;
+}
+export declare const useInputController: <T>(params: IParams<T>) => {
+    setRefs: (node: T | null) => void;
+    setIsFocused: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    setInternalValue: import("react").Dispatch<import("react").SetStateAction<string>>;
+    controllerRef: import("react").RefObject<T | null>;
+    isControlledRef: import("react").RefObject<boolean>;
+    isControlled: boolean;
+    isFocused: boolean;
+    currentLength: number;
+    hasValue: boolean;
+    internalValue: string;
+    value: string | undefined;
+};
+export {};

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

@@ -0,0 +1,35 @@
+export * from "./breadcrumb";
+export * from "./Button";
+export * from "./Card";
+export * from "./Checkbox";
+export * from "./ConfirmDialog";
+export * from "./DataTable";
+export * from "./Drawer";
+export * from "./Dropdown";
+export * from "./Popup";
+export * from "./Form";
+export * from "./hooks/useDropdownPositioning";
+export * from "./ImagePreview";
+export * from "./Input";
+export * from "./InputNumber";
+export * from "./Label";
+export * from "./Layout";
+export * from "./Loading";
+export * from "./Menu";
+export * from "./Message";
+export * from "./Modal";
+export * from "./Notification";
+export * from "./Overlay";
+export * from "./Pagination";
+export * from "./Radio";
+export * from "./Search";
+export * from "./Select";
+export * from "./Skeleton";
+export * from "./Switch";
+export * from "./table";
+export * from "./TableSearch";
+export * from "./Tabs";
+export * from "./Textarea";
+export * from "./Tooltip";
+export * from "./TreeSelect";
+export * from "./Upload";

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

@@ -0,0 +1 @@
+export * from "./table";

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,37 +1,95 @@
 {
   "name": "@_tc/template-core",
-  "version": "0.0.1-bate.6",
-  "description": "A TypeScript Koa framework template - Monorepo root",
-  "main": "./index.js",
-  "types": "./index.d.ts",
+  "version": "0.0.1-bate.61",
+  "description": "A full-stack TypeScript admin framework powered by Koa, React, and Vite - monorepo root",
+  "types": "./types/index.d.ts",
   "exports": {
-    "./vite": {
-      "import": "./app/vite/index.js",
-      "require": "./app/vite/index.js",
-      "types": "./app/vite/index.d.ts"
+    ".": {
+      "import": "./esm/index.js",
+      "require": "./cjs/index.js",
+      "types": "./types/index.d.ts"
+    },
+    "./bundler": {
+      "import": "./esm/bundler/index.js",
+      "require": "./cjs/bundler/index.js",
+      "types": "./types/bundler/index.d.ts"
+    },
+    "./fe/main": {
+      "import": "./fe/frontend/src/main.js",
+      "require": "./fe/frontend/src/main.js",
+      "types": "./fe/frontend/src/main.d.ts"
+    },
+    "./fe": {
+      "import": "./fe/frontend/src/index.js",
+      "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/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/react/ui/*",
+      "require": "./fe/packages/react/ui/*",
+      "types": "./fe/packages/react/ui/*"
+    },
+    "./fe/*": {
+      "import": "./fe/frontend/src/*",
+      "require": "./fe/frontend/src/*",
+      "types": "./fe/frontend/src/*"
+    },
+    "./fe/tailwind_ui.css": "./fe/frontend/src/main.css",
+    "./model": {
+      "types": "./model/model/index.d.ts"
     }
   },
   "dependencies": {
-    "ajv": "^8.18.0",
-    "glob": "^10.3.10",
-    "knex": "^3.2.3",
-    "koa-bodyparser": "^4.4.1",
-    "koa-compress": "^5.2.1",
-    "koa-nunjucks-2": "^3.0.2",
-    "koa-static": "^5.0.0",
-    "log4js": "^6.9.1",
-    "md5": "^2.3.0",
-    "nunjucks": "^3.2.4",
-    "superagent": "^7.1.0",
-    "vite": "^8.0.8",
-    "vite-plugin-html": "^3.2.2"
+    "@tailwindcss/vite": "4.2.4",
+    "ajv": "8.18.0",
+    "chokidar": "4.0.3",
+    "glob": "10.5.0",
+    "immer": "11.1.7",
+    "koa-bodyparser": "4.4.1",
+    "koa-compress": "5.2.1",
+    "koa-static": "5.0.0",
+    "log4js": "6.9.1",
+    "md5": "2.3.0",
+    "nunjucks": "3.2.4",
+    "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",
     "koa": "^2.15.0",
-    "koa-nunjucks-2": "^3.0.2",
     "koa-router": "^12.0.1",
-    "lodash": "^4.17.21"
+    "lodash": "^4.17.21",
+    "lucide-react": "^0.468.0",
+    "rc-field-form": "^1.44.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "react-router-dom": "^6.28.0",
+    "tailwind-merge": "^2.4.0",
+    "vite": "8.0.10",
+    "xlsx": "^0.18.5",
+    "zustand": "^5.0.0"
   },
   "keywords": [
     "koa",

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

@@ -0,0 +1,12 @@
+import type { Ctx, KoaApp } from "../type";
+declare const getBaseController: (app: KoaApp) => {
+    new (): {
+        readonly app: KoaApp;
+        readonly config: KoaApp["config"];
+        get service(): import("../../packages/core/index").FrameworkAugment.IServiceAugmented;
+        success(ctx: Ctx, data: unknown): void;
+        fail(ctx: Ctx, code: number, message: string): void;
+        sendData(ctx: Ctx, data?: unknown, code?: number, message?: string | null, status?: number): void;
+    };
+};
+export default getBaseController;

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

@@ -0,0 +1,22 @@
+import type { Ctx, KoaApp } from "../type";
+export interface IProjectController {
+    getModelList(ctx: Ctx): Promise<void>;
+    getProjectList(ctx: Ctx): Promise<void>;
+    getProject(ctx: Ctx): Promise<void>;
+    success(ctx: Ctx, data: unknown): void;
+    fail(ctx: Ctx, code: number, message: string): void;
+}
+declare const getProjectController: (app: KoaApp) => {
+    new (): {
+        getModelList: (ctx: Ctx) => Promise<void>;
+        getProjectList: (ctx: Ctx) => Promise<void>;
+        getProject: (ctx: Ctx) => Promise<void>;
+        readonly app: KoaApp;
+        readonly config: KoaApp["config"];
+        get service(): import("../../packages/core/index").FrameworkAugment.IServiceAugmented;
+        success(ctx: Ctx, data: unknown): void;
+        fail(ctx: Ctx, code: number, message: string): void;
+        sendData(ctx: Ctx, data?: unknown, code?: number, message?: string | null, status?: number): void;
+    };
+};
+export default getProjectController;

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

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

package/types/app/extend/$fetch.d.ts

@@ -0,0 +1,8 @@
+import type { RequestConfig } from "../../packages/common/http/index";
+import type { KoaApp } from "../type";
+import { FetchAxios } from "../../packages/common/http/index";
+export interface NodeFetch extends FetchAxios {
+    create: (config?: RequestConfig) => FetchAxios;
+}
+declare const _default: (_app: KoaApp) => NodeFetch;
+export default _default;

package/types/app/extend/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;