xshell 1.0.59 → 1.0.61

package/.eslintrc.json

@@ -51,6 +51,9 @@
         
         "xlint/keep-indent": "error",
         
+        // 函数使用 function 来声明而不是 const foo = () => { }
+        "xlint/func-style": "error",
+        
         
         "@typescript-eslint/semi": ["error", "never"],
         "@typescript-eslint/no-extra-semi": "error",
@@ -170,6 +173,14 @@
         
         "@typescript-eslint/prefer-includes": "error",
         
-        "@typescript-eslint/prefer-regexp-exec": "error"
+        "@typescript-eslint/prefer-regexp-exec": "error",
+        
+        // 禁止使用 export default
+        "no-restricted-exports": ["error", { "restrictDefaultExports": { "direct": true, "named": true, "defaultFrom": true, "namedFrom": true, "namespaceFrom": true } }],
+        
+        "@typescript-eslint/consistent-type-imports": ["error", { "fixStyle": "inline-type-imports", "disallowTypeAnnotations": false }],
+        
+        // () => { 返回 void 的表达式 }
+        "@typescript-eslint/no-confusing-void-expression": "error"
     }
 }

package/Terminal.d.ts

@@ -0,0 +1,15 @@
+import 'xterm/css/xterm.css';
+import { Terminal as XTermTerminal } from 'xterm';
+import { Model } from 'react-object-model';
+import type { Remote } from './net.browser.js';
+export declare function Terminal({ font }: {
+    font: string;
+}): import("react/jsx-runtime").JSX.Element;
+declare class TerminalModel extends Model<TerminalModel> {
+    term: XTermTerminal;
+    stdio_id: number;
+    subscribe_stdio(remote: Remote): Promise<void>;
+    unsubscribe_stdio(remote: Remote): Promise<void>;
+}
+export declare let terminal: TerminalModel;
+export {};

package/Terminal.js

@@ -0,0 +1,81 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import 'xterm/css/xterm.css';
+import { useEffect, useRef } from 'react';
+import { Terminal as XTermTerminal } from 'xterm';
+import { FitAddon } from 'xterm-addon-fit';
+import { WebglAddon } from 'xterm-addon-webgl';
+import { Model } from 'react-object-model';
+import { assert, genid } from './utils.browser.js';
+export function Terminal({ font }) {
+    let rterminal = useRef();
+    useEffect(() => {
+        (async () => {
+            await document.fonts.ready;
+            let term = new XTermTerminal({
+                fontFamily: font,
+                fontSize: 16,
+                cursorStyle: 'bar',
+                disableStdin: true,
+                convertEol: true,
+                allowProposedApi: true,
+                theme: {
+                    ...myscheme,
+                    magenta: myscheme.purple,
+                    brightMagenta: myscheme.brightPurple,
+                }
+            });
+            const fit_addon = new FitAddon();
+            term.loadAddon(fit_addon);
+            term.open(rterminal.current);
+            term.loadAddon(new WebglAddon());
+            fit_addon.fit();
+            terminal.set({ term });
+        })();
+    }, []);
+    return _jsx("div", { className: 'term', ref: rterminal });
+}
+class TerminalModel extends Model {
+    term;
+    stdio_id = 0;
+    async subscribe_stdio(remote) {
+        assert(!this.stdio_id);
+        const id = this.stdio_id = genid();
+        remote.handlers.set(id, ({ data: [chunk] }) => {
+            this.term.write(chunk);
+        });
+        await remote.send({ id, func: 'subscribe_stdio' });
+    }
+    async unsubscribe_stdio(remote) {
+        let { stdio_id } = this;
+        assert(stdio_id);
+        await remote.call('unsubscribe_stdio', [stdio_id]);
+        remote.handlers.delete(stdio_id);
+        this.stdio_id = 0;
+    }
+}
+export let terminal = new TerminalModel();
+/** winterm.json */
+const myscheme = {
+    background: '#FFFFFF',
+    black: '#000000',
+    blue: '#0070C0',
+    brightBlack: '#444444',
+    brightBlue: '#0000FF',
+    brightCyan: '#008080',
+    brightGreen: '#718C00',
+    brightPurple: '#8959A8',
+    brightRed: '#DF0000',
+    brightWhite: '#AAAAAA',
+    brightYellow: '#FF81FF',
+    cursorColor: '#000000',
+    cyan: '#821717',
+    foreground: '#000000',
+    green: '#008000',
+    name: 'myscheme',
+    purple: '#800080',
+    red: '#C82829',
+    selectionBackground: '#ADD6FF',
+    white: '#888888',
+    yellow: '#EC7600'
+};
+//# sourceMappingURL=Terminal.js.map

package/file.d.ts

@@ -5,6 +5,7 @@ import { promises as fsp, default as fs } from 'fs';
 type FileHandle = fsp.FileHandle & {
     fp: string;
 };
+export { fsp };
 export type Encoding = 'utf-8' | 'gb18030' | 'shift-jis' | 'utf-16le';
 export declare const encodings: readonly ["utf-8", "gb18030", "shift-jis", "utf-16le"];
 /** fp 所指向的 文件/ 文件夹 是否存在
@@ -85,8 +86,8 @@ export interface FListOptions {
         - deep?: `false` 递归遍历 recursively
         - absolute?: `false` 返回、打印完整路径而不是相对路径，为 false 时返回的 FStats.fp 也会被修改 Return, print full path instead of relative path, FStats.fp returned when false will also be modified
         - print?: `true`
-        - filter?: `true`  RegExp | (fp: string) => any 注意当 deep = true 时被 filter 过滤掉的目录及目录中的文件不会包含在结果中
-                    Note that when deep = true, directories and files in directories that are filtered out by the filter will not be included in the results
+        - filter?: `() => true`  RegExp | (fp: string) => any
+            注意当 deep = true 时被 filter 过滤掉的目录及目录中的文件不会包含在结果中
         - stats?: `false` 启用后返回 FStats 列表
                    Returns the FStats list when enabled */
 export declare function flist(fpd: string): Promise<string[]>;
@@ -115,12 +116,14 @@ export declare function fdelete(fp: string, { print }?: {
     - options?:
         - print?: `true`
         - overwrite?: `true`
-    
+        - filter?: 当 fp_src 为文件夹时选择性复制里面的部分内容，和 flist 的 filter 选项一样，但只支持文件夹中第一层的文件
+        
     @example
     fcopy('D:/temp/camera/', 'D:/camera/') */
-export declare function fcopy(fp_src: string, fp_dst: string, { print, overwrite, }?: {
+export declare function fcopy(fp_src: string, fp_dst: string, { print, overwrite, filter, }?: {
     print?: boolean;
     overwrite?: boolean;
+    filter?: FListOptions['filter'];
 }): Promise<void>;
 /** 移动文件或文件夹
     相同分区 / 文件系统下使用 rename, 否则 fallback 到复制后删除源文件
@@ -177,4 +180,3 @@ export declare function ftail(fp: string, handler: (lines: string[]) => void | P
 export declare function freplace(fp: string, pattern: string | RegExp, replacement: string, { print }?: {
     print?: boolean;
 }): Promise<void>;
-export {};

package/file.js

@@ -4,6 +4,7 @@ import { path } from './path.js';
 import { t } from './i18n/instance.js';
 import { to_json } from './prototype.js';
 import { assert, Lock } from './utils.js';
+export { fsp };
 export const encodings = ['utf-8', 'gb18030', 'shift-jis', 'utf-16le'];
 /** fp 所指向的 文件/ 文件夹 是否存在
     Does the file/folder pointed to by fp exist?  */
@@ -225,22 +226,31 @@ export async function fdelete(fp, { print = true } = {}) {
     - options?:
         - print?: `true`
         - overwrite?: `true`
-    
+        - filter?: 当 fp_src 为文件夹时选择性复制里面的部分内容，和 flist 的 filter 选项一样，但只支持文件夹中第一层的文件
+        
     @example
     fcopy('D:/temp/camera/', 'D:/camera/') */
-export async function fcopy(fp_src, fp_dst, { print = true, overwrite = true, } = {}) {
+export async function fcopy(fp_src, fp_dst, { print = true, overwrite = true, filter, } = {}) {
     const { isdir } = fp_src;
     assert(isdir === fp_dst.isdir, t('fp_src 和 fp_dst 必须同为文件路径或文件夹路径'));
     assert(path.isAbsolute(fp_src) && path.isAbsolute(fp_dst), t('fp_src 和 fp_dst 必须为完整路径'));
+    if (!isdir && filter)
+        throw new Error(t('filter 选项只适用于 fp_src 为文件夹'));
     if (print)
         console.log(t('复制'), fp_src, '->', fp_dst);
     if (isdir)
-        await fsp.cp(fp_src, fp_dst, {
-            recursive: true,
-            force: overwrite,
-            errorOnExist: !overwrite,
-            mode: overwrite ? 0 : fs.constants.COPYFILE_EXCL,
-        });
+        if (filter) {
+            await fmkdir(fp_dst, { print });
+            await Promise.all((await flist(fp_src, { filter, print: false }))
+                .map(async (fname) => fcopy(fp_src + fname, fp_dst + fname, { print, overwrite })));
+        }
+        else
+            await fsp.cp(fp_src, fp_dst, {
+                recursive: true,
+                force: overwrite,
+                errorOnExist: !overwrite,
+                mode: overwrite ? 0 : fs.constants.COPYFILE_EXCL,
+            });
     else
         try {
             await fsp.copyFile(fp_src, fp_dst, overwrite ? 0 : fs.constants.COPYFILE_EXCL);
@@ -269,14 +279,14 @@ export async function fmove(fp_src, fp_dst, { overwrite = false, print = true }
     assert(path.isAbsolute(fp_src) && path.isAbsolute(fp_dst), t('fp_src 和 fp_dst 必须为完整路径'));
     if (print)
         console.log(t('移动'), fp_src, '->', fp_dst);
-    if (!overwrite && fexists(fp_dst))
+    if (!overwrite && fexists(fp_dst, { print: false }))
         throw new Error(`${t('已存在')} ${fp_dst}`);
     await fmkdir(fp_dst.fdir, { print: false });
     async function copy_and_delete() {
-        await fcopy(fp_src, fp_dst, { overwrite, print });
-        await fdelete(fp_src, { print });
+        await fcopy(fp_src, fp_dst, { overwrite, print: false });
+        await fdelete(fp_src, { print: false });
     }
-    if (fp_src[0] !== fp_dst[0])
+    if (fp_src[0] !== fp_dst[0] || overwrite)
         await copy_and_delete();
     else
         try {
@@ -305,7 +315,7 @@ export async function frename(fp, fp_, { fpd, print = true, overwrite = true } =
     assert(path.isAbsolute(fp) && path.isAbsolute(fp_), t('fp 和 fp_ 必须是绝对路径'));
     if (print)
         console.log(t('重命名'), fp, '->', fp_);
-    if (!overwrite && fexists(fp_))
+    if (!overwrite && fexists(fp_, { print: false }))
         throw new Error(`${t('已存在')} ${fp}`);
     await fsp.rename(fp, fp_);
 }
@@ -349,9 +359,9 @@ export async function flink(fp_real, fp_link, { junction = false, print = true }
     const is_fpd_link = fp_link.isdir;
     assert(is_fpd_real === is_fpd_link, t('fp_real 和 fp_link 必须同为文件路径或文件夹路径'));
     if (fexists(fp_link))
-        throw new Error(t('存在同名') + (is_fpd_link ? t('文件夹') : t('文件')) + ': ' + fp_link + t('，无法创建链接'));
+        throw new Error(`${t('存在同名')}${is_fpd_link ? t('文件夹') : t('文件')}: ${fp_link}${t('，无法创建链接')}`);
     if (print)
-        console.log(t('已将源文件 ') + fp_real + t(' 链接到 ') + fp_link);
+        console.log(`${t('已将源文件 ')}${fp_real}${t(' 链接到 ')}${fp_link}`);
     if (junction)
         fsp.symlink(fp_real, fp_link, 'junction');
     else

package/i18n/dict.json

@@ -346,5 +346,8 @@
     },
     "flstat: 参数 fp: '{{fp}}' 必须是绝对路径": {
         "en": "flstat: parameter fp: '{{fp}}' must be an absolute path"
+    },
+    "filter 选项只适用于 fp_src 为文件夹": {
+        "en": "filter option only applies to fp_src for folders"
     }
 }

package/i18n/scanner/index.js

@@ -18,7 +18,7 @@ const DEFAULT_CONFIG = {
     debug: false,
     input: [
         // 'src/**/*.{js,jsx,ts,tsx}',
-        '!i18n/**',
+        '!i18n/**', // Use ! to filter out files or directories
         '!node_modules/**',
         '!**/*.d.ts',
     ],
@@ -35,7 +35,7 @@ const DEFAULT_CONFIG = {
         extensions: [], // 避免在 transform 中执行原生的 parseFuncFromString
     },
     trans: {
-        extensions: [],
+        extensions: [], // 避免在 transform 中执行原生的 parseTransFromString
         fallbackKey: true,
         babylon: {
             sourceType: 'module',
@@ -74,22 +74,22 @@ const DEFAULT_CONFIG = {
         }
     },
     // 禁用 : 和 . 作为 seperator
-    keySeparator: false,
-    nsSeparator: false,
+    keySeparator: false, // char to separate keys
+    nsSeparator: false, // char to split namespace from key
     // Context Form
-    context: true,
-    contextFallback: true,
-    contextSeparator: '_',
+    context: true, // whether to add context form key
+    contextFallback: true, // whether to add a fallback key as well as the context form key
+    contextSeparator: '_', // char to split context from key
     // Plural
     // whether to add plural form key
     plural(language, ns, key, options /** Config */) {
         return language === 'en';
     },
-    pluralFallback: true,
-    pluralSeparator: '_',
+    pluralFallback: true, // whether to add a fallback key as well as the plural form key
+    pluralSeparator: '_', // char to split plural from key
     // interpolation options
     interpolation: {
-        prefix: '{{',
+        prefix: '{{', // prefix for interpolation
         suffix: '}}' // suffix for interpolation
     }
 };

package/net.js

@@ -87,7 +87,7 @@ export async function request(url, { method, queries, headers: _headers, body, t
     // --- headers, http/2 开始都用小写的 headers
     let headers = new Headers({
         'accept-language': 'zh-CN,zh;q=0.9,en-US;q=0.8,en;q=0.7,ja-JP;q=0.6,ja;q=0.5',
-        'user-agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/117.0.0.0 Safari/537.36',
+        'user-agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/119.0.0.0 Safari/537.36',
         'sec-ch-ua-platform': '"Windows"',
         'sec-ch-ua-platform-version': '"15.0.0"',
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xshell",
-  "version": "1.0.59",
+  "version": "1.0.61",
   "type": "module",
   "main": "./index.js",
   "bin": {
@@ -16,7 +16,7 @@
     "interactive programming"
   ],
   "engines": {
-    "node": ">=20.6.1",
+    "node": ">=21.3.0",
     "vscode": ">=1.81.0"
   },
   "author": "ShenHongFei <shen.hongfei@outlook.com> (https://github.com/ShenHongFei)",
@@ -45,23 +45,23 @@
     ]
   },
   "dependencies": {
-    "@babel/core": "^7.22.17",
-    "@babel/parser": "^7.22.16",
-    "@babel/traverse": "^7.22.17",
+    "@babel/core": "^7.23.5",
+    "@babel/parser": "^7.23.5",
+    "@babel/traverse": "^7.23.5",
     "@koa/cors": "^4.0.0",
-    "@types/ws": "^8.5.5",
+    "@types/ws": "^8.5.10",
     "byte-size": "^8.1.1",
     "chalk": "^5.3.0",
-    "chardet": "^1.6.0",
+    "chardet": "^2.0.0",
     "cli-table3": "^0.6.3",
-    "cli-truncate": "^3.1.0",
+    "cli-truncate": "^4.0.0",
     "colors": "^1.4.0",
-    "commander": "^11.0.0",
-    "emoji-regex": "^10.2.1",
+    "commander": "^11.1.0",
+    "emoji-regex": "^10.3.0",
     "fetch-cookie": "^2.1.0",
     "gulp-sort": "^2.0.0",
     "hash-string": "^1.0.0",
-    "i18next": "^23.5.1",
+    "i18next": "^23.7.7",
     "i18next-scanner": "^4.4.0",
     "js-cookie": "^3.0.5",
     "koa": "^2.14.2",
@@ -71,42 +71,47 @@
     "mime-types": "^2.1.35",
     "ora": "^7.0.1",
     "react": "^18.2.0",
-    "react-i18next": "^13.2.2",
+    "react-i18next": "^13.5.0",
+    "react-object-model": "^1.2.0",
     "resolve-path": "^1.4.0",
     "strip-ansi": "^7.1.0",
     "through2": "^4.0.2",
     "tough-cookie": "^4.1.3",
     "tslib": "^2.6.2",
-    "typescript": "^5.2.2",
+    "typescript": "^5.3.2",
     "ua-parser-js": "2.0.0-alpha.2",
-    "undici": "^5.24.0",
+    "undici": "^5.28.2",
     "vinyl": "^3.0.0",
     "vinyl-fs": "^4.0.0",
-    "ws": "^8.14.1"
+    "ws": "^8.14.2",
+    "xterm": "^5.3.0",
+    "xterm-addon-fit": "^0.8.0",
+    "xterm-addon-web-links": "^0.9.0",
+    "xterm-addon-webgl": "^0.16.0"
   },
   "devDependencies": {
-    "@babel/types": "^7.22.17",
-    "@types/babel__traverse": "^7.20.1",
-    "@types/byte-size": "^8.1.0",
-    "@types/chardet": "^0.8.1",
-    "@types/gulp-sort": "2.0.1",
-    "@types/js-cookie": "^3.0.3",
-    "@types/koa": "^2.13.8",
-    "@types/koa-compress": "^4.0.3",
-    "@types/lodash": "^4.14.198",
-    "@types/mime-types": "^2.1.1",
-    "@types/node": "^20.6.0",
-    "@types/react": "^18.2.21",
-    "@types/through2": "^2.0.39",
-    "@types/tough-cookie": "^4.0.3",
-    "@types/ua-parser-js": "^0.7.37",
-    "@types/vinyl-fs": "^3.0.2",
-    "@types/vscode": "^1.82.0",
-    "@typescript-eslint/eslint-plugin": "^6.7.0",
-    "@typescript-eslint/parser": "^6.7.0",
-    "eslint": "^8.49.0",
+    "@babel/types": "^7.23.5",
+    "@types/babel__traverse": "^7.20.4",
+    "@types/byte-size": "^8.1.2",
+    "@types/chardet": "^0.8.3",
+    "@types/gulp-sort": "2.0.4",
+    "@types/js-cookie": "^3.0.6",
+    "@types/koa": "^2.13.12",
+    "@types/koa-compress": "^4.0.6",
+    "@types/lodash": "^4.14.202",
+    "@types/mime-types": "^2.1.4",
+    "@types/node": "^20.10.3",
+    "@types/react": "^18.2.41",
+    "@types/through2": "^2.0.41",
+    "@types/tough-cookie": "^4.0.5",
+    "@types/ua-parser-js": "^0.7.39",
+    "@types/vinyl-fs": "^3.0.5",
+    "@types/vscode": "^1.84.2",
+    "@typescript-eslint/eslint-plugin": "^6.13.1",
+    "@typescript-eslint/parser": "^6.13.1",
+    "eslint": "^8.55.0",
     "eslint-plugin-react": "^7.33.2",
-    "eslint-plugin-xlint": "^1.0.8"
+    "eslint-plugin-xlint": "^1.0.10"
   },
   "scripts": {
     "start": "node --title=xshell --inspect=0.0.0.0:8420 ./xshell.js",

package/patches/{@types__byte-size@8.1.0.patch → @types__byte-size@8.1.2.patch}

@@ -1,14 +1,14 @@
 # 用来修复 `byte_size()` 函数的 ts 类型报错
 
 diff --git a/package.json b/package.json
-index 4160984ea87736c65ad63d123c7d68cae96dfc1d..f9b14147ceae6c881e7f3829aca6876be317b15f 100644
+index dd8ed66fcb8b1ab93f0a3a015bad95bc31d3b18d..6a3753f42610451163fd7d502a93779fe3dca8db 100644
 --- a/package.json
 +++ b/package.json
 @@ -11,6 +11,7 @@
-             "githubUsername": "lntel"
+             "url": "https://github.com/lntel"
          }
      ],
 +    "type": "module",
      "main": "",
      "types": "index.d.ts",
-     "repository": {
+     "repository": {

package/process.d.ts

@@ -9,8 +9,8 @@ export declare const exe_nodejs: string;
 interface StartOptions {
     /** `继承当前工作目录 process.cwd()` 子进程的工作目录  `inherit the cwd` cwd of the child process. */
     cwd?: string;
-    /** `process.env` 覆盖/添加到 process.env 的环境变量  overwrite/add to process.env */
-    env?: Record<string, string>;
+    /** `process.env` 覆盖/添加到 process.env 的环境变量 */
+    envs?: Record<string, string>;
     /** `'utf-8'` 子进程输出编码  child output encoding */
     encoding?: Encoding | 'binary';
     /** `true` print 选项，支持设置细项  print option (with details) */
@@ -18,6 +18,7 @@ interface StartOptions {
         stdout: boolean;
         stderr: boolean;
         command: boolean;
+        /** 进程执行成功的消息 */
         code: boolean;
     };
     /** `'pipe'` 设置为 'ignore' 时忽略 stdio 处理  when 'ignore' then ignore stdio processing */
@@ -41,13 +42,13 @@ interface StartOptions {
     - args: `[]` 参数列表  arguments list
     - options
         - cwd?: `继承当前工作目录 process.cwd()` 子进程的工作目录  `inherit the cwd` cwd of the child process.
-        - env?: `process.env` 覆盖／添加到 process.env 的环境变量  overwrite/add to process.env
+        - envs?: `process.env` 覆盖／添加到 process.env 的环境变量
         - encoding?: `'utf-8'` 子进程输出编码  child output encoding
         - print?: `true` print 选项，支持设置细项  print option (with details)
         - stdio?: `'pipe'` 设置为 'ignore' 时忽略 stdio 处理  when 'ignore' then ignore stdio processing
         - detached?: `false` 是否断开和 child 的关系 (ignore stdio, unref)  whether to break the connection with child (ignore stdio, unref)
 */
-export declare function start(exe: string, args?: string[], { cwd, encoding, print, stdio, detached, env, window: _window, }?: StartOptions): Promise<ChildProcess>;
+export declare function start(exe: string, args?: string[], { cwd, encoding, print, stdio, detached, envs, window: _window, }?: StartOptions): Promise<ChildProcess>;
 export declare function start_nodejs(js: string, args?: string[], options?: StartOptions): Promise<ChildProcess>;
 export interface CallOptions extends StartOptions {
     throw_code?: boolean;
@@ -67,7 +68,7 @@ export interface CallResult<TOutput extends string | Buffer = string> {
     - args: `[]` 参数列表  arguments list
     - options?:
         - cwd?: `process.cwd()`
-        - env?: `process.env` 覆盖／添加到 process.env 的环境变量  overwrite/add to process.env
+        - envs?: `process.env` 覆盖／添加到 process.env 的环境变量  overwrite/add to process.env
         - encoding?: `'utf-8'` 子进程输出编码, 设置为 binary 时返回 stdout, stderr 类型为 Buffer; 否则是 string
             child output encoding. When set to binary, return stdout, stderr is of type Buffer; otherwise it is string
         - print?: `true` print 选项，支持设置细项  print option (with details)
@@ -80,18 +81,22 @@ export declare function call(exe: string, args?: string[], options?: CallOptions
     encoding: 'binary';
 }): Promise<CallResult<Buffer>>;
 export declare function call(exe: string, args?: string[], options?: CallOptions): Promise<CallResult<string>>;
+export interface CallNodeJsOptions extends CallOptions {
+    inspect?: number;
+    break?: boolean;
+}
 /** call node <js> for result
     - js: .js 路径 (相对路径根据 cwd 解析)  path (relative path will resolve based on cwd)
     - args: `[]` 参数列表  arguments list
     - options
         - cwd?: `process.cwd()`
-        - env?: `process.env` 覆盖／添加到 process.env 的环境变量  overwrite/add to process.env
+        - envs?: `process.env` 覆盖／添加到 process.env 的环境变量  overwrite/add to process.env
         - encoding?: `'utf-8'` 子进程输出编码  child process output encoding
         - print?: `true` print 选项，支持设置细项  print option (with details)
         - stdio?: `'pipe'` 设置为 'ignore' 时忽略 stdio 处理  when 'ignore' then ignore stdio processing
         - detached?: `false` 是否断开和 child 的关系 (ignore stdio, unref)  whether to break the connection with child (ignore stdio, unref)
         - throw_code?: `true` code 不为 0 时是否抛出异常  whether to throw Error when code is not 0 */
-export declare function call_nodejs(js: string, args?: string[], options?: CallOptions): Promise<CallResult<string>>;
+export declare function call_nodejs(js: string, args?: string[], { inspect, break: _break, ...options }?: CallNodeJsOptions): Promise<CallResult<string>>;
 export interface TermOptions {
     /** `process.cwd()` */
     cwd?: string;

package/process.js

@@ -9,20 +9,20 @@ export const exe_nodejs = process.execPath.fp;
     - args: `[]` 参数列表  arguments list
     - options
         - cwd?: `继承当前工作目录 process.cwd()` 子进程的工作目录  `inherit the cwd` cwd of the child process.
-        - env?: `process.env` 覆盖／添加到 process.env 的环境变量  overwrite/add to process.env
+        - envs?: `process.env` 覆盖／添加到 process.env 的环境变量
         - encoding?: `'utf-8'` 子进程输出编码  child output encoding
         - print?: `true` print 选项，支持设置细项  print option (with details)
         - stdio?: `'pipe'` 设置为 'ignore' 时忽略 stdio 处理  when 'ignore' then ignore stdio processing
         - detached?: `false` 是否断开和 child 的关系 (ignore stdio, unref)  whether to break the connection with child (ignore stdio, unref)
 */
-export async function start(exe, args = [], { cwd, encoding = 'utf-8', print = true, stdio = 'pipe', detached = false, env, window: _window = true, } = {}) {
+export async function start(exe, args = [], { cwd, encoding = 'utf-8', print = true, stdio = 'pipe', detached = false, envs, window: _window = true, } = {}) {
     const options = {
         cwd,
         shell: false,
         windowsHide: !_window,
         stdio,
-        ...env ? {
-            env: { ...process.env, ...env }
+        ...envs ? {
+            env: { ...process.env, ...envs }
         } : {},
     };
     if (typeof print === 'boolean')
@@ -169,14 +169,20 @@ export async function call(exe, args = [], options = {}) {
     - args: `[]` 参数列表  arguments list
     - options
         - cwd?: `process.cwd()`
-        - env?: `process.env` 覆盖／添加到 process.env 的环境变量  overwrite/add to process.env
+        - envs?: `process.env` 覆盖／添加到 process.env 的环境变量  overwrite/add to process.env
         - encoding?: `'utf-8'` 子进程输出编码  child process output encoding
         - print?: `true` print 选项，支持设置细项  print option (with details)
         - stdio?: `'pipe'` 设置为 'ignore' 时忽略 stdio 处理  when 'ignore' then ignore stdio processing
         - detached?: `false` 是否断开和 child 的关系 (ignore stdio, unref)  whether to break the connection with child (ignore stdio, unref)
         - throw_code?: `true` code 不为 0 时是否抛出异常  whether to throw Error when code is not 0 */
-export async function call_nodejs(js, args = [], options) {
-    return call(exe_nodejs, [js, ...args], options);
+export async function call_nodejs(js, args = [], { inspect, break: _break, ...options } = {}) {
+    return call(exe_nodejs, [
+        ...inspect ? [
+            _break ? `--inspect-brk=localhost:${inspect}` : `--inspect=localhost:${inspect}`
+        ] : [],
+        js,
+        ...args
+    ], options);
 }
 export const exe_winterm = `C:/Users/${userInfo().username}/AppData/Local/Microsoft/WindowsApps/wt.exe`;
 /** 新建 terminal 窗口执行进程  New Terminal window execution process

package/prototype.browser.js

@@ -309,7 +309,7 @@ Object.defineProperties(String.prototype, {
         },
         fext() {
             const index = this.lastIndexOf('.');
-            return index === -1 ? '' : this.slice(index + 1);
+            return index === -1 ? '' : this.slice(index);
         },
     }),
 });

package/server.d.ts

@@ -63,11 +63,25 @@ export declare class Server {
     _router(ctx: Context, next: Next): Promise<void>;
     /** 被子类重写以自定义处理逻辑 */
     router(ctx: Context): Promise<boolean>;
+    /** 重定向 ctx 到 url (可以是完整 url 也可以是路径)，设置 status code 为 code */
+    redirect(ctx: Context, url: string, code?: 301 | 302): void;
     logger(ctx: Context): void;
     process_ua(ctx: Context): string;
     format_ua(headers: IncomingHttpHeaders | IncomingHttp2Headers): string;
     proxy(ctx: Context, url: string | URL, headers_?: Record<string, string>, redirect?: RequestOptions['redirect']): Promise<void>;
     static filter_response_headers(headers: Headers): {};
+    /** 提供静态文件
+        @example
+        const prefix_docs = '/zh/'
+        if (path.startsWith(prefix_docs)) {
+            await this.try_send(
+                ctx,
+                `T:/t/docs${prefix_docs}`,
+                (path.endsWith('/') ? `${path}index.html` : path).slice(prefix_docs.length),
+                true
+            )
+            return
+        } */
     try_send(ctx: Context, fpd_root: string, fp: string, log_404: boolean): Promise<boolean>;
     /** 将 body 设置为 fp 所指文件的 ReadStream
         检查 fp 是否合法，设置对应的 content-type，支持缓存，支持分块下载

package/server.js

@@ -70,7 +70,8 @@ export class Server {
             this.server_ws = new WebSocketServer({
                 noServer: true,
                 skipUTF8Validation: true,
-                perMessageDeflate: true
+                perMessageDeflate: true,
+                maxPayload: 2 ** 30 // 1 GB
             });
             this.server_ws.on('connection', (ws, request) => {
                 ws.addEventListener('message', ({ data }) => {
@@ -170,10 +171,18 @@ export class Server {
     async router(ctx) {
         return false;
     }
+    /** 重定向 ctx 到 url (可以是完整 url 也可以是路径)，设置 status code 为 code */
+    redirect(ctx, url, code = 301) {
+        const { request: { _path } } = ctx;
+        let { response } = ctx;
+        response.redirect(url);
+        response.status = code;
+        console.log(`${code} 重定向  ${_path} -> ${url}`.yellow);
+    }
     logger(ctx) {
         const { colors } = this;
         const { request } = ctx;
-        const { query, body, path, _path, protocol, host, req: { httpVersion: http_version }, ip, } = request;
+        const { query, body, path, _path, protocol, host, req: { httpVersion: http_version }, ip, headers, } = request;
         let { method } = request;
         let s = '';
         // 时间
@@ -200,6 +209,16 @@ export class Server {
                 return colors ? path.yellow : path;
             return path;
         })();
+        // range
+        let range = headers.range;
+        if (headers.range) {
+            let [, start, end] = /(\d*)-(\d*)/.exec(range) || [];
+            if (start)
+                start = Number(start).to_fsize_str();
+            if (end)
+                end = Number(end).to_fsize_str();
+            s += ` (${start} - ${end || ''})`;
+        }
         // query
         if (Object.keys(query).length) {
             let t = inspect(query, { compact: true })
@@ -310,6 +329,18 @@ export class Server {
                 headers_[key] = value;
         return headers_;
     }
+    /** 提供静态文件
+        @example
+        const prefix_docs = '/zh/'
+        if (path.startsWith(prefix_docs)) {
+            await this.try_send(
+                ctx,
+                `T:/t/docs${prefix_docs}`,
+                (path.endsWith('/') ? `${path}index.html` : path).slice(prefix_docs.length),
+                true
+            )
+            return
+        } */
     async try_send(ctx, fpd_root, fp, log_404) {
         const { request: { _path, path, method }, response, } = ctx;
         if (response.body !== undefined || response.status !== 404)
@@ -342,7 +373,7 @@ export class Server {
             - download?: `undefined` 在 response.headers 中加上 content-disposition: attachment 指示浏览器下载文件 */
     async fsend(ctx, fp, { root, absolute, download, } = {}) {
         assert(absolute || root?.isdir, t('fsend 必须传 absolute 选项或 root 文件夹'));
-        const { request } = ctx;
+        const { request, request: { method } } = ctx;
         let { response } = ctx;
         if (!absolute) {
             if (fp.startsWith(root))
@@ -372,34 +403,44 @@ export class Server {
             error.message = `fs.stat 出错: ${error.message}`;
             throw error;
         }
+        // 上面的 fstat 异步操作之后有可能 socket 已经关闭，那么这里什么都不做，直接结束吧
+        // 如果不这么做，后续 createReadStream 打开的流会赋给 response.body，但是 response.res 不再触发 finish, close 事件，
+        // 打开的流永远不会关闭，最终导致资源泄露，文件句柄一直打开
+        if (!response.socket) {
+            response.res.end();
+            return fp;
+        }
         // https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Ranges
         // advertise server support of partial requests
         response.set('accept-ranges', 'bytes');
+        // https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Cache-Control#up-to-date_contents_always
         if (!response.get('cache-control'))
-            response.set('cache-control', 'max-age=0, must-revalidate');
+            response.set('cache-control', 'no-cache');
+        const last_modified_str = stats.mtime.toUTCString();
         if (!response.get('last-modified'))
-            response.set('last-modified', stats.mtime.toUTCString());
+            response.set('last-modified', last_modified_str);
         if (download)
             response.set('content-disposition', `attachment; filename="${encodeURIComponent(fp.fname)}"`);
         if (!response.get('content-type')) {
             const { contentType: get_content_type } = await import('mime-types');
-            const fext = fp.fext;
-            response.set('content-type', (this.js_exts.has(fext) ? 'text/javascript; chatset=utf-8' : get_content_type(fp.fext))
+            const { fext } = fp;
+            response.set('content-type', (this.js_exts.has(fext) ? 'text/javascript; chatset=utf-8' : get_content_type(fext))
                 || 'application/octet-stream');
         }
-        if (request.fresh) {
+        const modified_since_str = request.get('if-modified-since');
+        if ((method === 'GET' || method === 'HEAD') && modified_since_str === last_modified_str) {
             response.status = 304;
             // 以上会自动设置 response.body = null
             return fp;
         }
-        if (request.headers.range)
+        const range_header = request.headers.range;
+        if (range_header)
             try {
-                const range_header = request.headers.range;
                 const range_value = /=(.*)$/.exec(range_header)[1];
                 const range = /^[\w]*?(\d*)-(\d*)$/.exec(range_value);
                 assert(stats.size <= Number.MAX_SAFE_INTEGER);
-                let start = range[1] ? parseInt(range[1]) : undefined;
-                let end = range[2] ? parseInt(range[2]) : Number(stats.size) - 1;
+                let start = range[1] ? Number(range[1]) : undefined;
+                let end = range[2] ? Number(range[2]) : Number(stats.size) - 1;
                 if (start === undefined) {
                     start = Number(stats.size) - end;
                     end = Number(stats.size) - 1;

package/utils.browser.d.ts

@@ -52,7 +52,10 @@ export declare class Lock<TResource = void> {
 export declare function pause(milliseconds?: number): Promise<void>;
 /** 字符串字典序比较 */
 export declare function strcmp(l: string, r: string): 0 | 1 | -1;
+/** 比较 1.10.02 这种版本号 */
+export declare function vercmp(l: string, r: string): number;
 export declare function get<TReturn = any>(obj: any, keypath: string): TReturn;
+export declare function global_get<TReturn = any>(keypath: string): TReturn;
 export declare function invoke<TReturn = any>(obj: any, funcpath: string, args: any[]): TReturn;
 /** 拼接 TypedArrays 生成一个完整的 Uint8Array */
 export declare function concat(arrays: ArrayBufferView[]): Uint8Array;
@@ -71,3 +74,4 @@ export declare class Timer {
     getstr(): string;
     print(): void;
 }
+export declare function lowercase_first_letter(str: string): string;

package/utils.browser.js

@@ -130,12 +130,29 @@ export function strcmp(l, r) {
         return -1;
     return 1;
 }
+/** 比较 1.10.02 这种版本号 */
+export function vercmp(l, r) {
+    const lparts = l.split('.').map(x => Number(x));
+    const rparts = r.split('.').map(x => Number(x));
+    assert(lparts.length === rparts.length, '传入 vercmp 的两个版本号应该格式一致');
+    for (let i = 0; i < lparts.length; i++) {
+        const l = lparts[i];
+        const r = rparts[i];
+        assert(!isNaN(l) && !isNaN(r), '传入 vercmp 的版本非法');
+        if (l !== r)
+            return l - r;
+    }
+    return 0;
+}
 export function get(obj, keypath) {
     let obj_ = obj;
     for (const key of keypath.split('.'))
         obj_ = obj_[key];
     return obj_;
 }
+export function global_get(keypath) {
+    return get(globalThis, keypath);
+}
 export function invoke(obj, funcpath, args) {
     const paths = funcpath.split('.');
     let obj_ = obj;
@@ -197,4 +214,7 @@ export class Timer {
         console.log(this.getstr());
     }
 }
+export function lowercase_first_letter(str) {
+    return str[0].toLowerCase() + str.slice(1);
+}
 //# sourceMappingURL=utils.browser.js.map

package/utils.d.ts

@@ -23,7 +23,10 @@ export declare function unique<T>(iterable: T[] | Iterable<T>, selector?: string
 export declare function sort_keys<T>(obj: T): T;
 /** 字符串字典序比较 */
 export declare function strcmp(l: string, r: string): 0 | 1 | -1;
+/** 比较 1.10.02 这种版本号 */
+export declare function vercmp(l: string, r: string): number;
 export declare function get<TReturn = any>(obj: any, keypath: string): TReturn;
+export declare function global_get<TReturn = any>(keypath: string): TReturn;
 export declare function invoke<TReturn = any>(obj: any, funcpath: string, args: any[]): TReturn;
 /** 拼接 TypedArrays 生成一个完整的 Uint8Array */
 export declare function concat(arrays: ArrayBufferView[]): Uint8Array;
@@ -93,6 +96,7 @@ export declare class Lock<TResource = void> {
 }
 export declare function has_chinese(str: string): boolean;
 export declare function escape_line_feed(str: string): string;
+export declare function lowercase_first_letter(str: string): string;
 /** util.inspect(obj)
     - options
         - limit?: `10000`  传 0 时不限制

package/utils.js

@@ -90,12 +90,29 @@ export function strcmp(l, r) {
         return -1;
     return 1;
 }
+/** 比较 1.10.02 这种版本号 */
+export function vercmp(l, r) {
+    const lparts = l.split('.').map(x => Number(x));
+    const rparts = r.split('.').map(x => Number(x));
+    assert(lparts.length === rparts.length, '传入 vercmp 的两个版本号应该格式一致');
+    for (let i = 0; i < lparts.length; i++) {
+        const l = lparts[i];
+        const r = rparts[i];
+        assert(!isNaN(l) && !isNaN(r), '传入 vercmp 的版本非法');
+        if (l !== r)
+            return l - r;
+    }
+    return 0;
+}
 export function get(obj, keypath) {
     let obj_ = obj;
     for (const key of keypath.split('.'))
         obj_ = obj_[key];
     return obj_;
 }
+export function global_get(keypath) {
+    return get(globalThis, keypath);
+}
 export function invoke(obj, funcpath, args) {
     const paths = funcpath.split('.');
     let obj_ = obj;
@@ -275,6 +292,9 @@ export function has_chinese(str) {
 export function escape_line_feed(str) {
     return str.replace(/\n/g, '\\n');
 }
+export function lowercase_first_letter(str) {
+    return str[0].toLowerCase() + str.slice(1);
+}
 /** util.inspect(obj)
     - options
         - limit?: `10000`  传 0 时不限制