xshell 1.1.25 → 1.1.26

package/utils.d.ts

@@ -5,6 +5,7 @@ import type Vinyl from 'vinyl';
 import { type Mapper } from './prototype.ts';
 /** `180` 输出字符宽度 */
 export declare const output_width = 180;
+export declare const url_width = 52;
 export declare function set_inspect_options(colors?: boolean): void;
 export declare function assert<T>(assertion: T, message?: string): T;
 /** 做参数校验，逻辑检查 */
@@ -35,7 +36,9 @@ export declare function map_values<TValue, TNewValue>(obj: {
 };
 /** 过滤对象中的 keys, 返回新对象 */
 export declare function filter_keys<TObj>(obj: TObj, filter: (key: string) => any): TObj;
-/** 过滤对象中的 values, 返回新对象 */
+/** 过滤对象中的 values, 返回新对象
+    - obj
+    - filter?: `not_empty` */
 export declare function filter_values<TObj extends Record<string, any>>(obj: TObj, filter?: (value: TObj[string]) => any): TObj;
 /** 忽略对象中的 keys, 返回新对象 */
 export declare function omit<TObj>(obj: TObj, omit_keys: string[]): TObj;
@@ -48,6 +51,7 @@ export declare function vercmp(l: string, r: string, loose?: boolean): number;
 /** 过滤符合 pattern 的行 */
 export declare function grep(str: string, pattern: string | RegExp): string;
 /** 模糊过滤字符串列表或对象列表，常用于根据用户输入补全或搜索过滤
+    如果有完全匹配的，只返回那一项的数组
     - query: 查询字符串，要求为全小写
     - list: 要过滤的列表
     - list_lower?: 要过滤的列表对应的全小写字符串列表形式，传入时可复用缓存，加快搜索速度 */
@@ -56,7 +60,7 @@ 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<ArrayBuffer>;
+export declare function concat(arrays: ArrayBufferView[]): Buffer<ArrayBuffer>;
 export declare function typed_array_to_buffer(view: ArrayBufferView): Buffer<ArrayBufferLike>;
 /** 时间间隔 (milliseconds) 格式化 */
 export declare function delta2str(delta: number): string;
@@ -141,8 +145,8 @@ export declare class Lock<TResource = void> {
         在 signal aborted 时抛出错误结束等待，且由内部实现自动释放资源 */
     request<TResult>(action: LockedAction<TResource, TResult>, signal?: AbortSignal): Promise<TResult>;
 }
-/** 将字符串简单的编码为 utf-8 的 buffer (Uint8Array)。高频使用或者在流式处理时，考虑使用 TextEncoder 的 encodeInto 方法 */
-export declare function encode(str: string): Uint8Array<ArrayBufferLike>;
+export declare function encode(str: string): Buffer<ArrayBuffer>;
+export declare function encode_into(str: string, buf: Uint8Array): TextEncoderEncodeIntoResult;
 /** 将 utf-8 buffer (Uint8Array) 简单的解码为 string。
     在流式处理 (buffer 可能不完整) 时，应使用独立的 TextDecoder 实例调用 decode(buffer, { stream: true }) */
 export declare function decode(buffer: Uint8Array): string;
@@ -204,3 +208,5 @@ export declare function consume_stream(stream: Readable, ignore_error?: boolean)
     - range: 取值为逗号分割的多个可用值或值区间 (不能含有空格)，比如：`8321,8322,8300-8310,11000-11999`
     - reverse?: `false` 在 range 内从后往前生成 */
 export declare function range_to_numbers(range: string, reverse?: boolean): Generator<number, void, unknown>;
+/** 大于 n 的最小的 2 的幂次 */
+export declare function ceil2(n: number): number;

package/utils.js

@@ -5,6 +5,7 @@ import { t } from "./i18n/instance.js";
 import { build_mapper, not_empty, is_key_type, noop, ident } from "./prototype.js";
 /** `180` 输出字符宽度 */
 export const output_width = 180;
+export const url_width = 52;
 export function set_inspect_options(colors = true) {
     util.inspect.defaultOptions.maxArrayLength = 40;
     util.inspect.defaultOptions.maxStringLength = 10000;
@@ -95,7 +96,9 @@ export function filter_keys(obj, filter) {
     return Object.fromEntries(Object.entries(obj)
         .filter(([key]) => filter(key)));
 }
-/** 过滤对象中的 values, 返回新对象 */
+/** 过滤对象中的 values, 返回新对象
+    - obj
+    - filter?: `not_empty` */
 export function filter_values(obj, filter = not_empty) {
     return Object.fromEntries(Object.entries(obj)
         .filter(([, value]) => filter(value)));
@@ -141,6 +144,7 @@ export function grep(str, pattern) {
         .join_lines();
 }
 /** 模糊过滤字符串列表或对象列表，常用于根据用户输入补全或搜索过滤
+    如果有完全匹配的，只返回那一项的数组
     - query: 查询字符串，要求为全小写
     - list: 要过滤的列表
     - list_lower?: 要过滤的列表对应的全小写字符串列表形式，传入时可复用缓存，加快搜索速度 */
@@ -151,11 +155,14 @@ export function fuzzyfilter(query, list, mapper = ident, list_lower, single_char
         mapper = build_mapper(mapper);
     mapper ??= ident;
     list_lower ??= list.map(item => mapper(item).toLowerCase());
+    const query_lower = query.toLowerCase();
+    let ifullmatch;
+    if ((ifullmatch = list_lower.indexOf(query_lower)) !== -1)
+        return [list[ifullmatch]];
     if (single_char_startswith && query.length === 1) {
         const c = query[0];
         return list.filter((_, i) => list_lower[i].startsWith(c));
     }
-    const query_lower = query.toLowerCase();
     return list.filter((_, i) => {
         const str_lower = list_lower[i];
         let j = 0;
@@ -188,7 +195,7 @@ export function concat(arrays) {
     let length = 0;
     for (const a of arrays)
         length += a.byteLength;
-    let buf = new Uint8Array(length);
+    let buf = Buffer.allocUnsafe(length);
     let offset = 0;
     for (const a of arrays) {
         const uint8view = new Uint8Array(a.buffer, a.byteOffset, a.byteLength);
@@ -419,9 +426,13 @@ export class Lock {
 }
 // ------------ text
 let encoder = new TextEncoder();
-/** 将字符串简单的编码为 utf-8 的 buffer (Uint8Array)。高频使用或者在流式处理时，考虑使用 TextEncoder 的 encodeInto 方法 */
 export function encode(str) {
-    return encoder.encode(str);
+    // 用 Buffer.from 是因为可以利用 buffer pool，避免 encoder.encode 创建大量小且独立的 array buffer
+    return Buffer.from(str);
+}
+export function encode_into(str, buf) {
+    // 这个是直接用 v8 String::WriteUtf8 最高效的方法了
+    return encoder.encodeInto(str, buf);
 }
 let decoder = new TextDecoder();
 /** 将 utf-8 buffer (Uint8Array) 简单的解码为 string。
@@ -676,4 +687,11 @@ export function* range_to_numbers(range, reverse = false) {
                 yield i;
     }
 }
+/** 大于 n 的最小的 2 的幂次 */
+export function ceil2(n) {
+    let power = 1;
+    for (; power <= n; power <<= 1)
+        ;
+    return power;
+}
 //# sourceMappingURL=utils.js.map