@maiyunnet/kebab 9.2.1 → 9.2.2

package/doc/kebab-rag.md

@@ -1360,7 +1360,7 @@ index/variables/VER.md
 
 # Variable: VER
 
-> `const` **VER**: `"9.2.1"` = `'9.2.1'`
+> `const` **VER**: `"9.2.2"` = `'9.2.2'`
 
 Defined in: [index.ts:10](https://github.com/maiyunnet/kebab/blob/master/index.ts#L10)
 
@@ -10514,7 +10514,7 @@ Defined in: [lib/net/formdata.ts:37](https://github.com/maiyunnet/kebab/blob/mas
 
 > **new FormData**(`options?`): `FormData`
 
-Defined in: node\_modules/@types/node/stream.d.ts:99
+Defined in: node\_modules/@types/node/stream.d.ts:80
 
 #### Parameters
 
@@ -15691,6 +15691,72 @@ lib/ssh/shell/index.md
 
 - [Connection](classes/Connection.md)
 
+lib/text/functions/getFileExt.md
+---
+
+[**Documents for @maiyunnet/kebab**](../../../index.md)
+
+***
+
+[Documents for @maiyunnet/kebab](../../../index.md) / [lib/text](../index.md) / getFileExt
+
+# Function: getFileExt()
+
+> **getFileExt**(`path`): `string`
+
+Defined in: [lib/text.ts:527](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L527)
+
+获取文件后缀
+
+## Parameters
+
+### path
+
+`string`
+
+文件路径
+
+## Returns
+
+`string`
+
+lib/text/functions/getFileNameExt.md
+---
+
+[**Documents for @maiyunnet/kebab**](../../../index.md)
+
+***
+
+[Documents for @maiyunnet/kebab](../../../index.md) / [lib/text](../index.md) / getFileNameExt
+
+# Function: getFileNameExt()
+
+> **getFileNameExt**(`path`): `object`
+
+Defined in: [lib/text.ts:540](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L540)
+
+获取文件名和后缀
+
+## Parameters
+
+### path
+
+`string`
+
+文件路径
+
+## Returns
+
+`object`
+
+### ext
+
+> **ext**: `string`
+
+### name
+
+> **name**: `string`
+
 lib/text/functions/getFilename.md
 ---
 
@@ -15702,9 +15768,9 @@ lib/text/functions/getFilename.md
 
 # Function: getFilename()
 
-> **getFilename**(`path`): `string`
+> **getFilename**(`path`, `ext?`): `string`
 
-Defined in: [lib/text.ts:506](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L506)
+Defined in: [lib/text.ts:507](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L507)
 
 获取文件名
 
@@ -15716,6 +15782,12 @@ Defined in: [lib/text.ts:506](https://github.com/maiyunnet/kebab/blob/master/lib
 
 文件路径
 
+### ext?
+
+`boolean` = `true`
+
+是否包含后缀，默认包含
+
 ## Returns
 
 `string`
@@ -15762,7 +15834,7 @@ lib/text/functions/int2str.md
 
 > **int2str**(`int`, `digits?`, `decimal?`): `string`
 
-Defined in: [lib/text.ts:697](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L697)
+Defined in: [lib/text.ts:740](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L740)
 
 为解决精度问题，将整数转换为小数字符串
 以下几个示例都是当 digits 为 3、decimal 为 2 时
@@ -15895,7 +15967,7 @@ lib/text/functions/isFalsy.md
 
 > **isFalsy**(`val`): `val is TFalsy`
 
-Defined in: [lib/text.ts:648](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L648)
+Defined in: [lib/text.ts:691](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L691)
 
 判断一个值是否是虚假的（为 null/undefined/空字符串/false/0）
 
@@ -16065,7 +16137,7 @@ lib/text/functions/isTruthy.md
 
 > **isTruthy**\<`T`\>(`val`): `val is Exclude<T, TFalsy>`
 
-Defined in: [lib/text.ts:656](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L656)
+Defined in: [lib/text.ts:699](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L699)
 
 判断一个值是否是真实的（不为 null/undefined/空字符串/false/0）
 
@@ -16100,7 +16172,7 @@ lib/text/functions/logicalOr.md
 
 > **logicalOr**\<`T`, `T2`\>(`v1`, `v2`): `T` *extends* [`TFalsy`](../type-aliases/TFalsy.md) ? `T2` : `T`
 
-Defined in: [lib/text.ts:665](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L665)
+Defined in: [lib/text.ts:708](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L708)
 
 类似 || 运算符的效果
 
@@ -16285,7 +16357,7 @@ lib/text/functions/parseJson.md
 
 > **parseJson**\<`T`\>(`str`): `false` \| `T`
 
-Defined in: [lib/text.ts:559](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L559)
+Defined in: [lib/text.ts:602](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L602)
 
 将字符串解析为对象，返回 false 代表解析失败，支持 BigInt
 
@@ -16484,7 +16556,7 @@ lib/text/functions/str2int.md
 
 > **str2int**(`str`, `digits?`): `number`
 
-Defined in: [lib/text.ts:679](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L679)
+Defined in: [lib/text.ts:722](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L722)
 
 为解决精度问题，将字符串数字转换为整数显示
 以下几个示例都是当 digits 为 2 时
@@ -16524,7 +16596,7 @@ lib/text/functions/stringifyBuffer.md
 
 > **stringifyBuffer**(`buf`): `string`
 
-Defined in: [lib/text.ts:602](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L602)
+Defined in: [lib/text.ts:645](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L645)
 
 输出文本格式的 buffer
 
@@ -16553,7 +16625,7 @@ lib/text/functions/stringifyJson.md
 
 > **stringifyJson**(`obj`, `space?`): `string`
 
-Defined in: [lib/text.ts:589](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L589)
+Defined in: [lib/text.ts:632](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L632)
 
 将对象转换为 json 字符串，返回 false 代表解析失败，支持 BigInt
 
@@ -16588,7 +16660,7 @@ lib/text/functions/stringifyResult.md
 
 > **stringifyResult**(`rtn`): `string`
 
-Defined in: [lib/text.ts:519](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L519)
+Defined in: [lib/text.ts:562](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L562)
 
 将普通的返回 JSON 对象序列化为字符串
 
@@ -16617,7 +16689,7 @@ lib/text/functions/trimJson.md
 
 > **trimJson**(`json`): `any`
 
-Defined in: [lib/text.ts:610](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L610)
+Defined in: [lib/text.ts:653](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L653)
 
 递归删除 json 中的字符串首尾空格，会返回一个新的对象
 
@@ -16724,7 +16796,9 @@ lib/text/index.md
 
 ## Functions
 
+- [getFileExt](functions/getFileExt.md)
 - [getFilename](functions/getFilename.md)
+- [getFileNameExt](functions/getFileNameExt.md)
 - [htmlescape](functions/htmlescape.md)
 - [int2str](functions/int2str.md)
 - [isAscii](functions/isAscii.md)
@@ -16815,7 +16889,7 @@ lib/text/type-aliases/TFalsy.md
 
 > **TFalsy** = `false` \| `""` \| `0` \| `null` \| `undefined` \| *typeof* `NaN`
 
-Defined in: [lib/text.ts:642](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L642)
+Defined in: [lib/text.ts:685](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L685)
 
 虚假值类型
 
@@ -17389,7 +17463,7 @@ Defined in: [lib/undici/formdata.ts:37](https://github.com/maiyunnet/kebab/blob/
 
 > **new FormData**(`options?`): `FormData`
 
-Defined in: node\_modules/@types/node/stream.d.ts:99
+Defined in: node\_modules/@types/node/stream.d.ts:80
 
 #### Parameters
 

package/index.d.ts

@@ -5,7 +5,7 @@
  * --- 本文件用来定义每个目录实体地址的常量 ---
  */
 /** --- 当前系统版本号 --- */
-export declare const VER = "9.2.1";
+export declare const VER = "9.2.2";
 /** --- 框架根目录，以 / 结尾  --- */
 export declare const ROOT_PATH: string;
 /** --- 框架的 LIB，以 / 结尾 --- */

package/index.js

@@ -6,7 +6,7 @@
  * --- 本文件用来定义每个目录实体地址的常量 ---
  */
 /** --- 当前系统版本号 --- */
-export const VER = '9.2.1';
+export const VER = '9.2.2';
 // --- 服务端用的路径 ---
 const imu = decodeURIComponent(import.meta.url).replace('file://', '').replace(/^\/(\w:)/, '$1');
 /** --- /xxx/xxx --- */

package/lib/text.d.ts

@@ -136,8 +136,22 @@ export declare function isRealPath(path: string): boolean;
 /**
  * --- 获取文件名 ---
  * @param path 文件路径
+ * @param ext 是否包含后缀，默认包含
  */
-export declare function getFilename(path: string): string;
+export declare function getFilename(path: string, ext?: boolean): string;
+/**
+ * --- 获取文件后缀 ---
+ * @param path 文件路径
+ */
+export declare function getFileExt(path: string): string;
+/**
+ * --- 获取文件名和后缀 ---
+ * @param path 文件路径
+ */
+export declare function getFileNameExt(path: string): {
+    name: string;
+    ext: string;
+};
 /**
  * --- 将普通的返回 JSON 对象序列化为字符串 ---
  * @param rtn 返回 JSON 对象

package/lib/text.js

@@ -439,14 +439,52 @@ export function isRealPath(path) {
 /**
  * --- 获取文件名 ---
  * @param path 文件路径
+ * @param ext 是否包含后缀，默认包含
  */
-export function getFilename(path) {
+export function getFilename(path, ext = true) {
     path = path.replace(/\\/g, '/');
     const lio = path.lastIndexOf('/');
-    if (lio === -1) {
+    if (lio !== -1) {
+        path = path.slice(lio + 1);
+    }
+    if (ext) {
+        return path;
+    }
+    const dot = path.lastIndexOf('.');
+    if (dot === -1) {
         return path;
     }
-    return path.slice(lio + 1);
+    return path.slice(0, dot);
+}
+/**
+ * --- 获取文件后缀 ---
+ * @param path 文件路径
+ */
+export function getFileExt(path) {
+    const filename = getFilename(path);
+    const dot = filename.lastIndexOf('.');
+    if (dot === -1) {
+        return '';
+    }
+    return filename.slice(dot + 1).toLowerCase();
+}
+/**
+ * --- 获取文件名和后缀 ---
+ * @param path 文件路径
+ */
+export function getFileNameExt(path) {
+    const filename = getFilename(path);
+    const dot = filename.lastIndexOf('.');
+    if (dot === -1) {
+        return {
+            'name': filename,
+            'ext': ''
+        };
+    }
+    return {
+        'name': filename.slice(0, dot),
+        'ext': filename.slice(dot + 1).toLowerCase()
+    };
 }
 /**
  * --- 将普通的返回 JSON 对象序列化为字符串 ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maiyunnet/kebab",
-  "version": "9.2.1",
+  "version": "9.2.2",
   "description": "Simple, easy-to-use, and fully-featured Node.js framework that is ready-to-use out of the box.",
   "type": "module",
   "keywords": [
@@ -22,48 +22,48 @@
     "#kebab/*": "./*"
   },
   "dependencies": {
-    "@aws-sdk/client-s3": "^3.1014.0",
-    "@aws-sdk/lib-storage": "^3.1014.0",
+    "@aws-sdk/client-s3": "^3.1034.0",
+    "@aws-sdk/lib-storage": "^3.1034.0",
     "@litert/http-client": "^1.1.2",
     "@litert/mime": "^0.1.3",
-    "@litert/redis": "^3.2.0",
+    "@litert/redis": "^3.2.1",
     "@litert/websocket": "^0.2.8",
     "@radix-ui/react-checkbox": "^1.3.3",
     "@radix-ui/react-label": "^2.1.8",
     "@radix-ui/react-slot": "^1.2.4",
     "@radix-ui/react-switch": "^1.2.6",
-    "@tailwindcss/cli": "^4.2.2",
+    "@tailwindcss/cli": "^4.2.4",
     "@types/ssh2": "^1.15.5",
-    "@zilliz/milvus2-sdk-node": "^2.6.11",
+    "@zilliz/milvus2-sdk-node": "^2.6.13",
     "ajv": "^8.18.0",
     "ajv-formats": "^3.0.1",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "ejs": "^5.0.1",
-    "esbuild": "^0.27.4",
+    "ejs": "^5.0.2",
+    "esbuild": "^0.28.0",
     "jszip": "^3.10.1",
-    "mysql2": "^3.20.0",
+    "mysql2": "^3.22.2",
     "node-cron": "^4.2.1",
-    "openai": "^6.32.0",
+    "openai": "^6.34.0",
     "pg": "^8.20.0",
-    "react": "^19.2.4",
-    "react-dom": "^19.2.4",
-    "react-router-dom": "^7.13.1",
+    "react": "^19.2.5",
+    "react-dom": "^19.2.5",
+    "react-router-dom": "^7.14.2",
     "ssh2": "^1.17.0",
     "svg-captcha": "^1.4.0",
     "tailwind-merge": "^3.5.0",
-    "tencentcloud-sdk-nodejs": "^4.1.199",
+    "tencentcloud-sdk-nodejs": "^4.1.219",
     "undici": "^8.1.0"
   },
   "devDependencies": {
     "@litert/eslint-plugin-rules": "^0.3.1",
     "@types/ejs": "^3.1.5",
-    "@types/node": "^25.5.0",
+    "@types/node": "^25.6.0",
     "@types/pg": "^8.20.0",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
-    "typedoc": "^0.28.17",
+    "typedoc": "^0.28.19",
     "typedoc-plugin-markdown": "^4.11.0",
-    "typescript": "^5.9.3"
+    "typescript": "^6.0.3"
   }
 }

package/www/example/stc/view/react.page.js

@@ -136,9 +136,7 @@ export default function ReactPage({ title, serverTime, node, _urlBase, _urlStc,
             setIsFetching(false);
         });
     }
-    return (
-    // --- 组件渲染完整 HTML 文档，无需外部 EJS 模板 ---
-    _jsxs("html", { lang: "en", children: [_jsxs("head", { children: [_jsx("meta", { charSet: "UTF-8" }), _jsx("meta", { name: "viewport", content: "width=device-width, initial-scale=1.0" }), _jsx("title", { children: title }), _jsx("link", { href: `${_urlStc}view/react.page.css?v=${_staticVer}`, rel: "stylesheet" })] }), _jsx("body", { className: "bg-slate-50 min-h-screen font-sans", children: _jsxs("div", { className: "max-w-3xl mx-auto px-4 py-10 space-y-6", children: [_jsxs("div", { children: [_jsxs("div", { className: "flex gap-2 mb-2", children: [_jsx(Badge, { children: "SSR \u00B7 Kebab" }), _jsx(Badge, { variant: hydrated ? 'success' : 'warn', children: hydrated ? 'Hydrated ✓' : 'Rendering...' })] }), _jsx("h1", { className: "text-2xl font-bold text-slate-900", children: title }), _jsxs("p", { className: "text-slate-500 text-sm mt-1", children: [serverTime, " \u00B7 ", node] })] }), _jsx("div", { className: "flex gap-1 bg-slate-100 p-1 rounded-lg w-fit", children: ['overview', 'routing', 'fetch', 'shadcn'].map(t => (_jsx("button", { onClick: () => setTab(t), className: [
+    return (_jsxs("html", { lang: "en", children: [_jsxs("head", { children: [_jsx("meta", { charSet: "UTF-8" }), _jsx("meta", { name: "viewport", content: "width=device-width, initial-scale=1.0" }), _jsx("title", { children: title }), _jsx("link", { href: `${_urlStc}view/react.page.css?v=${_staticVer}`, rel: "stylesheet" })] }), _jsx("body", { className: "bg-slate-50 min-h-screen font-sans", children: _jsxs("div", { className: "max-w-3xl mx-auto px-4 py-10 space-y-6", children: [_jsxs("div", { children: [_jsxs("div", { className: "flex gap-2 mb-2", children: [_jsx(Badge, { children: "SSR \u00B7 Kebab" }), _jsx(Badge, { variant: hydrated ? 'success' : 'warn', children: hydrated ? 'Hydrated ✓' : 'Rendering...' })] }), _jsx("h1", { className: "text-2xl font-bold text-slate-900", children: title }), _jsxs("p", { className: "text-slate-500 text-sm mt-1", children: [serverTime, " \u00B7 ", node] })] }), _jsx("div", { className: "flex gap-1 bg-slate-100 p-1 rounded-lg w-fit", children: ['overview', 'routing', 'fetch', 'shadcn'].map(t => (_jsx("button", { onClick: () => setTab(t), className: [
                                     'px-4 py-2 rounded-md text-sm font-medium transition-colors cursor-pointer',
                                     tab === t ? 'bg-white shadow text-slate-900' : 'text-slate-500 hover:text-slate-900',
                                 ].join(' '), children: t.charAt(0).toUpperCase() + t.slice(1) }, t))) }), tab === 'overview' && (_jsxs("div", { className: "space-y-4", children: [_jsxs(Card, { children: [_jsx("h2", { className: "font-semibold text-slate-900 mb-1", children: "Counter\uFF08useState + hydration\uFF09" }), _jsx("p", { className: "text-slate-500 text-xs mb-4", children: "SSR renders with initial value 0; props are serialized as inline JSON. After hydration the state becomes interactive \u2014 click the buttons to test:" }), _jsxs("div", { className: "flex items-center gap-4", children: [_jsx("button", { onClick: () => setCount(c => c - 1), className: "w-10 h-10 rounded-lg border border-slate-300 hover:bg-slate-50 font-bold text-slate-700 text-xl cursor-pointer", children: "\u2212" }), _jsx("span", { className: "text-3xl font-bold text-slate-900 w-10 text-center tabular-nums", children: count }), _jsx("button", { onClick: () => setCount(c => c + 1), className: "w-10 h-10 rounded-lg bg-blue-500 hover:bg-blue-600 text-white font-bold text-xl cursor-pointer", children: "+" })] })] }), _jsxs(Card, { children: [_jsx("h2", { className: "font-semibold text-slate-900 mb-3", children: "Server Props (from Ctr method)" }), _jsxs("p", { className: "text-slate-500 text-xs mb-3", children: ["Passed via", ' ', _jsx("code", { className: "bg-slate-100 px-1 rounded", children: "_loadReactPage(path, props)" }), ". The framework auto-injects constants like _urlBase and serializes all props as inline JSON, reused directly during client hydration \u2014 no extra request needed."] }), _jsx("div", { className: "space-y-2", children: [
@@ -155,13 +153,7 @@ export default function ReactPage({ title, serverTime, node, _urlBase, _urlStc,
       checkbox.tsx      # shadcn Checkbox
       switch.tsx        # shadcn Switch
   view/
-    react-page.tsx      # Page component (import + compose)` }), _jsxs("p", { className: "text-slate-500 text-xs mt-3", children: ["Mirrors the shadcn/ui ", _jsx("code", { className: "bg-slate-100 px-1 rounded", children: "components/ui/" }), " convention. In dev mode, the framework auto-scans imports \u2014 no manual import map configuration needed."] })] })] })), tab === 'routing' && (
-                        /*
-                          MemoryRouter：路由状态保存在内存中，服务端 SSR 和客户端水合均可运行，
-                          无需服务端配置 catch-all 路由，适合在页面内嵌入独立的路由演示。
-                          若要整页接管 URL，改用 BrowserRouter（需服务端对所有子路径返回同一页面）。
-                        */
-                        _jsxs(MemoryRouter, { children: [_jsxs(Card, { children: [_jsx("h2", { className: "font-semibold text-slate-900 mb-1", children: "React Router Demo" }), _jsxs("p", { className: "text-slate-500 text-xs mb-4", children: ["Uses ", _jsx("code", { className: "bg-slate-100 px-1 rounded", children: "MemoryRouter" }), ' ', "to demonstrate route navigation, dynamic params (useParams), and programmatic navigation (useNavigate). Works on both server SSR and client hydration with no extra server configuration."] }), _jsxs(Routes, { children: [_jsx(Route, { path: "/", element: _jsx(RouterHome, {}) }), _jsx(Route, { path: "/about", element: _jsx(RouterAbout, {}) }), _jsx(Route, { path: "/user/:id", element: _jsx(RouterUser, {}) })] })] }), _jsxs(Card, { className: "mt-4", children: [_jsx("h2", { className: "font-semibold text-slate-900 mb-2", children: "Full-Page BrowserRouter Setup" }), _jsx("p", { className: "text-slate-500 text-xs mb-3", children: "To let React Router manage the real URL (e.g. /app, /app/about), replace MemoryRouter with BrowserRouter and route all sub-paths to the same Ctr method on the server:" }), _jsx("pre", { className: "bg-slate-50 border border-slate-200 rounded-lg p-4 text-xs overflow-auto leading-relaxed text-slate-700", children: `// 1. route.json: 将所有子路径路由到同一 Ctr 方法
+    react-page.tsx      # Page component (import + compose)` }), _jsxs("p", { className: "text-slate-500 text-xs mt-3", children: ["Mirrors the shadcn/ui ", _jsx("code", { className: "bg-slate-100 px-1 rounded", children: "components/ui/" }), " convention. In dev mode, the framework auto-scans imports \u2014 no manual import map configuration needed."] })] })] })), tab === 'routing' && (_jsxs(MemoryRouter, { children: [_jsxs(Card, { children: [_jsx("h2", { className: "font-semibold text-slate-900 mb-1", children: "React Router Demo" }), _jsxs("p", { className: "text-slate-500 text-xs mb-4", children: ["Uses ", _jsx("code", { className: "bg-slate-100 px-1 rounded", children: "MemoryRouter" }), ' ', "to demonstrate route navigation, dynamic params (useParams), and programmatic navigation (useNavigate). Works on both server SSR and client hydration with no extra server configuration."] }), _jsxs(Routes, { children: [_jsx(Route, { path: "/", element: _jsx(RouterHome, {}) }), _jsx(Route, { path: "/about", element: _jsx(RouterAbout, {}) }), _jsx(Route, { path: "/user/:id", element: _jsx(RouterUser, {}) })] })] }), _jsxs(Card, { className: "mt-4", children: [_jsx("h2", { className: "font-semibold text-slate-900 mb-2", children: "Full-Page BrowserRouter Setup" }), _jsx("p", { className: "text-slate-500 text-xs mb-3", children: "To let React Router manage the real URL (e.g. /app, /app/about), replace MemoryRouter with BrowserRouter and route all sub-paths to the same Ctr method on the server:" }), _jsx("pre", { className: "bg-slate-50 border border-slate-200 rounded-lg p-4 text-xs overflow-auto leading-relaxed text-slate-700", children: `// 1. route.json: 将所有子路径路由到同一 Ctr 方法
 {
   "app":   "ctr/app@reactPage",
   "app\\/.*": "ctr/app@reactPage"