xshell 1.2.67 → 1.2.69

package/file.d.ts

@@ -20,9 +20,12 @@ export declare const print_info_options: {
         readonly files: false;
     };
 };
+export declare const binary_encoding: {
+    readonly encoding: "binary";
+};
 export declare const ramdisk: boolean;
 /** fp 所指向的 文件/ 文件夹 是否存在
-    Does the file/folder pointed to by fp exist?  */
+    - print?: `true` */
 export declare function fexists(fp: string, { print }?: {
     print?: boolean;
 }): boolean;

package/file.js

@@ -11,9 +11,10 @@ export const encodings = ['utf-8', 'gb18030', 'shift-jis', 'utf-16le'];
 export const print_files = { info: true, files: true };
 export const print_info = { info: true, files: false };
 export const print_info_options = { print: print_info };
+export const binary_encoding = { encoding: 'binary' };
 export const ramdisk = fexists('T:/TEMP/', noprint);
 /** fp 所指向的 文件/ 文件夹 是否存在
-    Does the file/folder pointed to by fp exist?  */
+    - print?: `true` */
 export function fexists(fp, { print = true } = {}) {
     const exists = fs.existsSync(fp);
     if (print)

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "xshell",
-    "version": "1.2.67",
+    "version": "1.2.69",
     "type": "module",
     "main": "./index.js",
     "bin": {
@@ -101,11 +101,11 @@
         "@types/babel__traverse": "^7.20.7",
         "@types/eslint": "^9.6.1",
         "@types/estree": "^1.0.8",
-        "@types/koa": "^2.15.0",
+        "@types/koa": "^3.0.0",
         "@types/koa-compress": "^4.0.6",
         "@types/mime-types": "^3.0.1",
         "@types/node": "^24.0.12",
-        "@types/react": "^19.1.8",
+        "@types/react": "^19.1.9",
         "@types/tough-cookie": "^4.0.5",
         "@types/ua-parser-js": "^0.7.39",
         "@types/vscode": "^1.102.0",

package/prototype.common.d.ts

@@ -23,6 +23,7 @@ declare global {
         }): string;
         to_regexp(this: string, preservations?: string, flags?: string): RegExp;
         to_snake_case(this: string): string;
+        to_space_case(this: string): string;
         /** 字符串模式替换
             - pattern: 匹配部分的格式
             - pattern_: 替换后的格式
@@ -148,13 +149,17 @@ declare global {
         /** 格式化为 早上 09:00:00 这样的十二小时制可读友好的时间
             - ms?: `false` 显示到 ms */
         to_time_str(this: Date, ms?: boolean): string;
-        /** 格式化为 17.00.00 这样的时间 */
+        /** 格式化为 17.00.00 这样的时间
+            - ms?: `false` */
         to_dot_time_str(this: Date, ms?: boolean): string;
-        /** 格式化为 2024.01.01 17.00.00 这样的时间 */
+        /** 格式化为 2024.01.01 17.00.00 这样的时间
+            - ms?: `false` */
         to_dot_str(this: Date, ms?: boolean): string;
-        /** 格式化为 17:00:00 这样的时间 */
+        /** 格式化为 17:00:00 这样的时间
+            - ms?: `false` */
         to_formal_time_str(this: Date, ms?: boolean): string;
-        /** 格式化为 2024.01.01 17:00:00 这样的时间 */
+        /** 格式化为 2024.01.01 17:00:00 这样的时间
+            - ms?: `false` */
         to_formal_str(this: Date, ms?: boolean): string;
     }
     interface Number {
@@ -228,6 +233,7 @@ export declare const is_key_type: IsKeyType;
 type IsKeyType = (key: any) => key is string | number | symbol;
 export declare function rethrow(error: Error): void;
 export declare function to_snake_case(str: string): string;
+export declare function to_space_case(str: string): string;
 export declare function to_method_property_descriptors(methods: {
     [name: string]: Function;
 }): PropertyDescriptorMap;

package/prototype.common.js

@@ -18,6 +18,12 @@ export function to_snake_case(str) {
         .replace('-', '_')
         .strip_if_start('_');
 }
+export function to_space_case(str) {
+    return str.replace(/([A-Z])/g, ' $1')
+        .toLowerCase()
+        .replaceAll('_', ' ')
+        .strip_if_start(' ');
+}
 export function to_method_property_descriptors(methods) {
     return Object.fromEntries(Object.entries(methods)
         .map(([name, value]) => ([name, {
@@ -75,6 +81,9 @@ if (!globalThis.my_prototype_defined) {
             to_snake_case() {
                 return to_snake_case(this);
             },
+            to_space_case() {
+                return to_space_case(this);
+            },
             refmt(pattern, pattern_, preservations = '', flags = '', transformer = (name, value) => value || '', pattern_placeholder = /\{.*?\}/g) {
                 // --- 转换 pattern 为 pattern_regx
                 let last_end = 0;

package/utils.browser.d.ts

@@ -20,3 +20,6 @@ export declare function concat(arrays: ArrayBufferView[]): Uint8Array<ArrayBuffe
     action 返回 trusy 值时认为成功，返回 action 的结果
     如果次数用尽仍然失败，返回 null */
 export declare function poll<TResult>(duration: number, times: number, action: (breaker: () => void) => Promise<TResult>): Promise<TResult>;
+/** 比较两个 buffer 内容是否相同，第二个可以传入 string 自动编码转换后比较，
+    高频调用时建议提前编码 right 并缓存 */
+export declare function buffer_equals(left: Uint8Array, right: Uint8Array | string): boolean;

package/utils.browser.js

@@ -109,4 +109,16 @@ export async function poll(duration, times, action) {
     }
     return null;
 }
+/** 比较两个 buffer 内容是否相同，第二个可以传入 string 自动编码转换后比较，
+    高频调用时建议提前编码 right 并缓存 */
+export function buffer_equals(left, right) {
+    if (typeof right === 'string')
+        right = encode(right);
+    if (left.length !== right.length)
+        return false;
+    for (let i = 0; i < left.length; i++)
+        if (left[i] !== right[i])
+            return false;
+    return true;
+}
 //# sourceMappingURL=utils.browser.js.map

package/utils.d.ts

@@ -90,3 +90,6 @@ export declare function decode_buffer_hex_string(str: string): string;
     action 返回 trusy 值时认为成功，返回 action 的结果
     如果次数用尽仍然失败，返回 null */
 export declare function poll<TResult>(duration: number, times: number, action: (breaker: () => void) => Promise<TResult>): Promise<TResult>;
+/** 比较两个 buffer 内容是否相同，第二个可以传入 string 自动编码转换后比较，
+    高频调用时建议提前编码 right 并缓存 */
+export declare function buffer_equals(left: Uint8Array, right: Uint8Array | string): boolean;

package/utils.js

@@ -1,6 +1,6 @@
 import { Stream, Writable, Transform } from 'stream';
 import util from 'util';
-import crypto from 'crypto';
+import ncrypto from 'crypto';
 import timers from 'timers/promises';
 import "./prototype.js";
 import { assert, decode, defer, TimeoutError } from "./utils.common.js";
@@ -119,10 +119,10 @@ export async function timeout(milliseconds, action, on_timeout, print = true) {
     });
 }
 export function sha256(data) {
-    return crypto.hash('sha256', data);
+    return ncrypto.hash('sha256', data);
 }
 export function sha1(data) {
-    return crypto.hash('sha1', data);
+    return ncrypto.hash('sha1', data);
 }
 /** 将字符串简单的编码为 utf-8 的 buffer (Uint8Array)。高频使用或者在流式处理时，考虑使用 TextEncoder 的 encodeInto 方法 */
 export function encode(str) {
@@ -395,4 +395,16 @@ export async function poll(duration, times, action) {
     }
     return null;
 }
+/** 比较两个 buffer 内容是否相同，第二个可以传入 string 自动编码转换后比较，
+    高频调用时建议提前编码 right 并缓存 */
+export function buffer_equals(left, right) {
+    if (typeof right === 'string')
+        right = encode(right);
+    if (left.length !== right.length)
+        return false;
+    for (let i = 0; i < left.length; i++)
+        if (left[i] !== right[i])
+            return false;
+    return true;
+}
 //# sourceMappingURL=utils.js.map