@go-wind/admin-react 0.0.0-stage → 0.2.0

package/dist/utils/inference.d.ts

@@ -0,0 +1,111 @@
+/**
+ * 检查传入的值是否为函数。
+ *
+ * @param {unknown} value 要检查的值。
+ * @returns {boolean} 如果值是函数，返回 true，否则返回 false。
+ */
+declare function isFunction(value: unknown): value is (...args: unknown[]) => unknown;
+/**
+ * 检查传入的值是否为对象（不包括 null 和数组）。
+ *
+ * @param {unknown} value 要检查的值。
+ * @returns {boolean} 如果值是对象，返回 true，否则返回 false。
+ */
+declare function isObject(value: unknown): value is Record<string, unknown>;
+/**
+ * 检查传入的值是否为字符串。
+ *
+ * @param {unknown} value 要检查的值。
+ * @returns {boolean} 如果值是字符串，返回 true，否则返回 false。
+ */
+declare function isString(value: unknown): value is string;
+/**
+ * 检查传入的值是否为undefined。
+ *
+ * @param {unknown} value 要检查的值。
+ * @returns {boolean} 如果值是undefined，返回true，否则返回false。
+ */
+declare function isUndefined(value?: unknown): value is undefined;
+/**
+ * 检查传入的值是否为boolean
+ * @param value
+ * @returns 如果值是布尔值，返回true，否则返回false。
+ */
+declare function isBoolean(value: unknown): value is boolean;
+/**
+ * 检查传入的值是否为空。
+ *
+ * 以下情况将被认为是空：
+ * - 值为null。
+ * - 值为undefined。
+ * - 值为一个空字符串。
+ * - 值为一个长度为0的数组。
+ * - 值为一个没有元素的Map或Set。
+ * - 值为一个没有属性的对象。
+ *
+ * @param {T} value 要检查的值。
+ * @returns {boolean} 如果值为空，返回true，否则返回false。
+ */
+declare function isEmpty<T = unknown>(value?: T): value is T;
+/**
+ * 检查传入的字符串是否为有效的HTTP或HTTPS URL。
+ *
+ * @param {string} url 要检查的字符串。
+ * @return {boolean} 如果字符串是有效的HTTP或HTTPS URL，返回true，否则返回false。
+ */
+declare function isHttpUrl(url?: string): boolean;
+/**
+ * 检查传入的值是否为window对象。
+ *
+ * @param {unknown} value 要检查的值。
+ * @returns {boolean} 如果值是window对象，返回true，否则返回false。
+ */
+declare function isWindow(value: unknown): value is Window;
+/**
+ * 检查当前运行环境是否为Mac OS。
+ *
+ * 这个函数通过检查navigator.userAgent字符串来判断当前运行环境。
+ * 如果userAgent字符串中包含"macintosh"或"mac os x"（不区分大小写），则认为当前环境是Mac OS。
+ *
+ * @returns {boolean} 如果当前环境是Mac OS，返回true，否则返回false。
+ */
+declare function isMacOs(): boolean;
+/**
+ * 检查当前运行环境是否为Windows OS。
+ *
+ * 这个函数通过检查navigator.userAgent字符串来判断当前运行环境。
+ * 如果userAgent字符串中包含"windows"或"win32"（不区分大小写），则认为当前环境是Windows OS。
+ *
+ * @returns {boolean} 如果当前环境是Windows OS，返回true，否则返回false。
+ */
+declare function isWindowsOs(): boolean;
+/**
+ * 检查传入的值是否为数字
+ * @param value
+ */
+declare function isNumber(value: unknown): value is number;
+/**
+ * Returns the first value in the provided list that is neither `null` nor `undefined`.
+ *
+ * This function iterates over the input values and returns the first one that is
+ * not strictly equal to `null` or `undefined`. If all values are either `null` or
+ * `undefined`, it returns `undefined`.
+ *
+ * @template T - The type of the input values.
+ * @param {...(T | null | undefined)[]} values - A list of values to evaluate.
+ * @returns {T | undefined} - The first value that is not `null` or `undefined`, or `undefined` if none are found.
+ *
+ * @example
+ * // Returns 42 because it is the first non-null, non-undefined value.
+ * getFirstNonNullOrUndefined(undefined, null, 42, 'hello'); // 42
+ *
+ * @example
+ * // Returns 'hello' because it is the first non-null, non-undefined value.
+ * getFirstNonNullOrUndefined(null, undefined, 'hello', 123); // 'hello'
+ *
+ * @example
+ * // Returns undefined because all values are either null or undefined.
+ * getFirstNonNullOrUndefined(undefined, null); // undefined
+ */
+declare function getFirstNonNullOrUndefined<T>(...values: (null | T | undefined)[]): T | undefined;
+export { getFirstNonNullOrUndefined, isBoolean, isEmpty, isFunction, isHttpUrl, isMacOs, isNumber, isObject, isString, isUndefined, isWindow, isWindowsOs, };

package/dist/utils/merge.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 深度合并对象
+ * @param target - 目标对象
+ * @param source - 源对象
+ * @returns 合并后的新对象
+ */
+export declare function merge<T extends Record<string, any>, U extends Record<string, any>>(target: T, source: U): T & U;
+/**
+ * 创建自定义合并函数
+ * @param customizer - 自定义处理函数
+ * @returns 合并函数
+ */
+export declare function createMerge(customizer?: (obj: Record<string, any>, key: string, value: any) => boolean | void): <T extends Record<string, any>, U extends Record<string, any>>(target: T, source: U) => T & U;
+/**
+ * 带数组覆盖功能的合并函数
+ */
+export declare const mergeWithArrayOverride: <T extends Record<string, any>, U extends Record<string, any>>(target: T, source: U) => T & U;

package/dist/utils/nprogress.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 开始显示进度条。
+ * 此函数首先加载NProgress库，然后调用NProgress的start方法开始显示进度条。
+ */
+declare function startProgress(): Promise<void>;
+/**
+ * 停止显示进度条，并隐藏进度条。
+ * 此函数首先加载NProgress库，然后调用NProgress的done方法停止并隐藏进度条。
+ */
+declare function stopProgress(): Promise<void>;
+export { startProgress, stopProgress };

package/dist/utils/tree.d.ts

@@ -0,0 +1,27 @@
+interface TreeConfigOptions {
+    childProps: string;
+}
+/**
+ * @zh_CN 遍历树形结构，并返回所有节点中指定的值。
+ * @param tree 树形结构数组
+ * @param getValue 获取节点值的函数
+ * @param options 作为子节点数组的可选属性名称。
+ * @returns 所有节点中指定的值的数组
+ */
+declare function traverseTreeValues<T, V>(tree: T[], getValue: (node: T) => V, options?: TreeConfigOptions): V[];
+/**
+ * 根据条件过滤给定树结构的节点，并以原有顺序返回所有匹配节点的数组。
+ * @param tree 要过滤的树结构的根节点数组。
+ * @param filter 用于匹配每个节点的条件。
+ * @param options 作为子节点数组的可选属性名称。
+ * @returns 包含所有匹配节点的数组。
+ */
+declare function filterTree<T extends Record<string, any>>(tree: T[], filter: (node: T) => boolean, options?: TreeConfigOptions): T[];
+/**
+ * 根据条件重新映射给定树结构的节
+ * @param tree 要过滤的树结构的根节点数组。
+ * @param mapper 用于map每个节点的条件。
+ * @param options 作为子节点数组的可选属性名称。
+ */
+declare function mapTree<T, V extends Record<string, any>>(tree: T[], mapper: (node: T) => V, options?: TreeConfigOptions): V[];
+export { filterTree, mapTree, traverseTreeValues };

package/dist/utils/url.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 获取url中的全部参数
+ * @param search - url参数
+ */
+export declare function getUrlAllParam(search: string): Record<string, string>;
+/**
+ * 获取url中参数某个值
+ * @param search - url参数
+ * @param key - 搜索值
+ */
+export declare function getUrlParam(search: string, key: string): string;

package/dist/utils/utils.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Sums the passed percentage to the R, G or B of a HEX color
+ * @param {string} color The color to change
+ * @param {number} amount The amount to change the color by
+ * @returns {string} The processed part of the color
+ */
+export declare function addLight(color: string, amount: number): string;
+/**
+ * Lightens a 6 char HEX color according to the passed percentage
+ * @param {string} color The color to change
+ * @param {number} amount The amount to change the color by
+ * @returns {string} The processed color represented as HEX
+ */
+export declare function lighten(color: string, amount: number): string;
+/**
+ * 绑定实例方法
+ * @param instance 实例
+ */
+export declare function bindMethods<T extends object>(instance: T): void;
+/**
+ * 滚动到顶部
+ */
+export declare function scrollToTop(): void;
+/**
+ * 滚动到底部
+ */
+export declare function scrollToBottom(): void;
+/**
+ * 滚动到指定元素
+ * @param element 目标元素
+ */
+export declare function scrollTo(element: HTMLElement): void;
+/**
+ * 金额格式化3000->3,000
+ * @param amount - 金额
+ */
+export declare function amountFormatter(amount: number): string;

package/package.json

@@ -1,6 +1,80 @@
 {
   "name": "@go-wind/admin-react",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "description": "React 19 admin shell mechanisms extracted from go-wind-admin: axios transport (token rotation/captcha headers), SSE client, auth store with injectable AuthGateway, route factory (frontend/backend access modes), access control, i18n engine, theme/preferences, query client, generic hooks & utils.",
+  "type": "module",
+  "license": "MIT",
+  "keywords": [
+    "react",
+    "admin",
+    "auth",
+    "router",
+    "i18n",
+    "theme",
+    "antd"
+  ],
+  "files": [
+    "dist"
+  ],
+  "module": "./dist/admin-react.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/admin-react.js"
+    },
+    "./style.css": "./dist/admin-react.css"
+  },
+  "peerDependencies": {
+    "@ant-design/icons": ">=5.6.0",
+    "@ant-design/pro-components": ">=2.8.0",
+    "@tanstack/react-query": ">=5.0.0",
+    "antd": ">=6.0.0",
+    "i18next": ">=25.0.0",
+    "react": ">=19.0.0",
+    "react-dom": ">=19.0.0",
+    "react-i18next": ">=17.0.0",
+    "react-router-dom": ">=6.26.0",
+    "zustand": ">=5.0.0"
+  },
+  "dependencies": {
+    "@microsoft/fetch-event-source": "^2.0.1",
+    "axios": "^1.16.1",
+    "dayjs": "^1.11.20",
+    "echarts": "^6.1.0",
+    "lodash": "^4.17.21",
+    "nprogress": "^0.2.0"
+  },
+  "devDependencies": {
+    "@ant-design/icons": "^5.6.1",
+    "@ant-design/pro-components": "^2.8.10",
+    "@tanstack/react-query": "^5.100.11",
+    "@testing-library/react": "^16.3.2",
+    "@types/lodash": "^4.17.21",
+    "@types/nprogress": "^0.2.3",
+    "@types/react": "^19.2.15",
+    "@types/react-dom": "^19.2.3",
+    "@vitejs/plugin-react": "^5.1.2",
+    "antd": "^6.4.3",
+    "i18next": "^26.2.0",
+    "jsdom": "^29.1.1",
+    "less": "^4.6.4",
+    "react": "^19.2.6",
+    "react-dom": "^19.2.6",
+    "react-i18next": "^17.0.8",
+    "react-router-dom": "^6.26.0",
+    "typescript": "^5.9.3",
+    "vite": "^8.0.0",
+    "vitest": "^4.1.6",
+    "zustand": "^5.0.13"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "vite build && tsc -p tsconfig.build.json && node ../../scripts/flatten-dts.mjs",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  }
 }