xshell 1.1.8 → 1.1.10

package/prototype.browser.js

@@ -1,11 +1,10 @@
 /** 在浏览器端修改 prototype，需要更加小心 */
-import byte_size from 'byte-size';
 import EmojiRegex from 'emoji-regex';
 import { t } from "./i18n/instance.js";
 export const emoji_regex = EmojiRegex();
 export const noop = () => { };
 export const ident = (x) => x;
-export const build_selector = (key) => (obj) => obj[key];
+export const build_mapper = (key) => (obj) => obj[key];
 /** value 不为 null 或 undefined */
 export const not_empty = (value) => value !== null && value !== undefined;
 export const empty = (value) => value === undefined || value === null;
@@ -43,16 +42,6 @@ export const brackets = {
     fat: ['【', '】'],
     tortoise_shell: ['〔', '〕'],
 };
-function to_fp(str) {
-    if (!str)
-        return str;
-    const fp = str.replaceAll('\\', '/');
-    // 转换小写盘符开头的路径
-    return fp[1] === ':' && 'a' <= fp[0] && fp[0] <= 'z' ?
-        fp[0].toUpperCase() + fp.slice(1)
-        :
-            fp;
-}
 // ------------------------------------ String.prototype
 Object.defineProperties(String.prototype, {
     ...to_getter_property_descriptors({
@@ -224,6 +213,15 @@ Object.defineProperties(String.prototype, {
             return Object.fromEntries(Object.entries($placeholders)
                 .map(([name, $i]) => [name, matches[$i] || '']));
         },
+        /** 查找子串或字符出现的次数 */
+        count(search) {
+            if (!search)
+                throw new Error('count 的 search 不能为空');
+            let count = 0;
+            for (let i = 0; (i = this.indexOf(search, i)) !== -1; i += search.length)
+                count++;
+            return count;
+        },
         quote(type = 'single') {
             if (type === 'psh')
                 return `& ${this.quote()}`;
@@ -313,9 +311,9 @@ Object.defineProperties(String.prototype, {
                 .replace(/(["']+)\s*(.+?)\s*(["']+)/g, '$1$2$3')
                 .replace(new RegExp(cjk + '([\\+\\-\\*\\/=&\\\\\\|<>])([A-Za-z0-9])', 'g'), '$1 $2 $3')
                 .replace(new RegExp('([A-Za-z0-9])([\\+\\-\\*\\/=&\\\\\\|<>])' + cjk, 'g'), '$1 $2 $3');
-            const textBak = text_;
+            const text_bak = text_;
             text_ = text_.replace(new RegExp(cjk + '([\\(\\[\\{<\u201c]+(.*?)[\\)\\]\\}>\u201d]+)' + cjk, 'g'), '$1 $2 $4');
-            if (text_ === textBak)
+            if (text_ === text_bak)
                 text_ = text_
                     .replace(new RegExp(cjk + '([\\(\\[\\{<\u201c>])', 'g'), '$1 $2')
                     .replace(new RegExp('([\\)\\]\\}>\u201d<])' + cjk, 'g'), '$1 $2');
@@ -324,7 +322,7 @@ Object.defineProperties(String.prototype, {
                 .replace(new RegExp(cjk + '([~!;:,\\.\\?\u2026])([A-Za-z0-9])', 'g'), '$1$2 $3')
                 .replace(new RegExp(cjk + '([A-Za-z0-9`\\$%\\^&\\*\\-=\\+\\\\\\|\\/@\u00a1-\u00ff\u2022\u2027\u2150-\u218f])', 'g'), '$1 $2')
                 .replace(new RegExp('([A-Za-z0-9`\\$%\\^&\\*\\-=\\+\\\\\\|\\/@\u00a1-\u00ff\u2022\u2027\u2150-\u218f])' + cjk, 'g'), '$1 $2');
-        },
+        }
     }),
     // ------------ 文件路径操作
     ...to_getter_property_descriptors({
@@ -332,30 +330,43 @@ Object.defineProperties(String.prototype, {
             return this.endsWith('/');
         },
         fp() {
-            return to_fp(this);
-        },
-        fpd() {
             if (!this)
                 return this;
-            const fp = to_fp(this);
+            const fp = this.replaceAll('\\', '/');
+            // 转换小写盘符开头的路径
+            return fp[1] === ':' && 'a' <= fp[0] && fp[0] <= 'z'
+                ? fp[0].toUpperCase() + fp.slice(1)
+                : fp;
+        },
+        fpd() {
+            const { fp } = this;
             return fp.endsWith('/') ? fp : `${fp}/`;
         },
         fdir() {
-            const fname = (this.endsWith('/') ? this.slice(0, -1) : this).split('/').at(-1);
-            return this.slice(0, this.length - (fname.length + (this.endsWith('/') ? 1 : 0)));
+            return this.strip_end(this.fname);
         },
         fname() {
-            const fname = (this.endsWith('/') ? this.slice(0, -1) : this).split('/').at(-1);
-            if (fname)
-                return `${fname}${this.endsWith('/') ? '/' : ''}`;
-            else
-                return '';
+            const ilast = this.lastIndexOf('/');
+            if (ilast === -1)
+                return this; // 没有斜杠时返回整个字符串
+            // 以斜杠结尾的情况
+            if (ilast === this.length - 1) {
+                const iprev = this.lastIndexOf('/', ilast - 1);
+                return iprev === -1
+                    ? this // 只有一个斜杠且在末尾
+                    : this.slice(iprev + 1);
+            }
+            // 返回最后一个斜杠后的内容
+            return this.slice(ilast + 1);
         },
         fext() {
-            const index = this.lastIndexOf('.');
-            return index === -1 ? '' : this.slice(index);
-        },
-    }),
+            const { fname } = this;
+            const index = fname.lastIndexOf('.');
+            return index <= 0
+                ? ''
+                : fname.slice(index + 1);
+        }
+    })
 });
 // ------------------------------------ Date.prototype
 Object.defineProperties(Date.prototype, to_method_property_descriptors({
@@ -411,16 +422,14 @@ function get_time_str(date, hour, ms, splitter) {
     return String(hour).padStart(2, '0') + splitter +
         String(date.getMinutes()).padStart(2, '0') + splitter +
         String(date.getSeconds()).padStart(2, '0') +
-        (ms ?
-            '.' + String(date.getMilliseconds()).padStart(3, '0')
-            :
-                '');
+        (ms
+            ? '.' + String(date.getMilliseconds()).padStart(3, '0')
+            : '');
 }
 // ------------------------------------ Number.prototype
 Object.defineProperties(Number.prototype, to_method_property_descriptors({
-    to_fsize_str(units = 'iec') {
-        const { value, unit } = byte_size(this, { units });
-        return `${value} ${unit.replace('i', '')}`;
+    to_fsize_str() {
+        return byte_size(this);
     },
     to_bin_str() {
         return `0b${this.toString(2)}`;
@@ -467,20 +476,27 @@ Object.defineProperties(Array.prototype, {
             const indent = character.repeat(width);
             return this.map(line => indent + line);
         },
-        sum() {
-            return this.length
-                ? this.reduce((acc, x) => acc + x)
-                : undefined;
-        },
-        max(selector = ident) {
+        sum(mapper) {
             if (!this.length)
                 return undefined;
-            if (typeof selector === 'string')
-                selector = build_selector(selector);
-            let max = selector(this[0]);
+            // 快捷路径
+            const first = this[0];
+            if ((typeof first === 'number' || typeof first === 'bigint') && !mapper)
+                return this.reduce((acc, x) => acc + x, first);
+            if (is_key_type(mapper))
+                mapper = build_mapper(mapper);
+            mapper ??= ident;
+            return this.reduce((acc, x) => acc + mapper(x), mapper(first));
+        },
+        max(mapper = ident) {
+            if (!this.length)
+                return undefined;
+            if (is_key_type(mapper))
+                mapper = build_mapper(mapper);
+            let max = mapper(this[0]);
             let imax = 0;
             for (let i = 0; i < this.length; i++) {
-                const value = selector(this[i]);
+                const value = mapper(this[i]);
                 if (value > max) {
                     max = value;
                     imax = i;
@@ -488,15 +504,15 @@ Object.defineProperties(Array.prototype, {
             }
             return this[imax];
         },
-        min(selector = ident) {
+        min(mapper = ident) {
             if (!this.length)
                 return undefined;
-            if (typeof selector === 'string')
-                selector = build_selector(selector);
-            let min = selector(this[0]);
+            if (is_key_type(mapper))
+                mapper = build_mapper(mapper);
+            let min = mapper(this[0]);
             let imin = 0;
             for (let i = 0; i < this.length; i++) {
-                const value = selector(this[i]);
+                const value = mapper(this[i]);
                 if (value < min) {
                     min = value;
                     imin = i;
@@ -504,14 +520,14 @@ Object.defineProperties(Array.prototype, {
             }
             return this[imin];
         },
-        unique(selector) {
-            if (!selector)
+        unique(mapper) {
+            if (!mapper)
                 return [...new Set(this)];
-            if (is_key_type(selector))
-                selector = build_selector(selector);
+            if (is_key_type(mapper))
+                mapper = build_mapper(mapper);
             let map = new Map();
             for (const x of this)
-                map.set(selector(x), x);
+                map.set(mapper(x), x);
             return [...map.values()];
         },
         join_lines(append = true) {
@@ -520,6 +536,9 @@ Object.defineProperties(Array.prototype, {
     })
 });
 Object.defineProperties(BigInt.prototype, to_method_property_descriptors({
+    to_fsize_str() {
+        return byte_size(this);
+    },
     toJSON() {
         return this.toString();
     }
@@ -583,4 +602,17 @@ export function is_codepoint_fullwidth(codepoint) {
             // cjk unified ideographs extension b .. tertiary ideographic plane
             (0x20000 <= codepoint && codepoint <= 0x3fffd)));
 }
+const units = ['b', 'kb', 'mb', 'gb', 'tb', 'pb', 'eb', 'zb', 'yb'];
+const bytes_table = units.map((unit, i) => ({
+    start: i === 0 ? 0 : 2 ** (i * 10),
+    end: 2 ** ((i + 1) * 10),
+    unit
+}));
+export function byte_size(bytes) {
+    bytes = Number(bytes);
+    const sign = bytes < 0 ? '-' : '';
+    bytes = Math.abs(bytes);
+    const { unit, start } = bytes_table.find(range => bytes >= range.start && bytes < range.end);
+    return `${sign}${start === 0 ? bytes : (bytes / start).toFixed()} ${unit}`;
+}
 //# sourceMappingURL=prototype.browser.js.map

package/prototype.d.ts

@@ -59,6 +59,8 @@ declare global {
             - flags?: `''` 正则匹配选项
             - pattern_placeholder?: `/\{.*?\}/g` */
         find(this: string, pattern: string, preservations?: string, flags?: string, pattern_placeholder?: RegExp): Record<string, string>;
+        /** 查找子串或字符出现的次数 */
+        count(this: string, search: string): number;
         /** - type?: `'single'` 引号类型 */
         quote(this: string, type?: keyof typeof quotes | 'psh'): string;
         /** - type?: `'single'` 引号类型 */
@@ -69,8 +71,7 @@ declare global {
         surround_tag(this: string, tag_name: string): string;
         to_lf(this: string): string;
         /** 'xxx'.replace(/pattern/g, '')
-            如果 pattern 是 string 则在创建 RegExp 时自动加上 flags (默认 'g'), 否则忽略 flags
-        */
+            如果 pattern 是 string 则在创建 RegExp 时自动加上 flags (默认 'g'), 否则忽略 flags */
         rm(this: string, pattern: string | RegExp, flags?: string): string;
         readonly red: string;
         readonly red_: string;
@@ -125,17 +126,25 @@ declare global {
         slice_to(this: string, search: string, options?: SliceOptions): string;
         /** 等价于 .endsWith('/') */
         isdir: boolean;
-        /** 以 `/` 分割的路径，可能以 / 结尾 */
+        /** 转换为以 `/` 分割的路径，可能以 / 结尾 */
         fp: string;
-        /** 以 `/` 分割的文件夹路径，一定以 / 结尾 */
+        /** 转换为以 `/` 分割的文件夹路径，一定以 / 结尾 */
         fpd: string;
-        /** 父文件夹路径 (path.dirname)，一定以 `/` 结尾 */
+        /** 父文件夹路径，一定以 `/` 结尾，或为空
+            特殊情况:
+            - '/'.fdir === ''
+            - 'D:/'.fdir === '' */
         fdir: string;
-        /** 文件名 (path.basename 的结果), 保留结尾的 /，如:
+        /** 文件或文件夹名, 保留结尾的 /
+            常规情况:
             - D:/0/aaa.txt -> aaa.txt
-            - D:/aaa/ -> aaa/ */
+            - D:/aaa/ -> aaa/
+            特殊情况:
+            - '/'.fname === '/'
+            - 'D:/'.fname === 'D:/' */
         fname: string;
-        /** .txt */
+        /** 文件后缀名，不带点，如: txt, zip，没有后缀时返回空字符串
+            特殊情况: .aaa 的 fext 为 '' */
         fext: string;
         to_backslash(this: string): string;
     }
@@ -157,8 +166,8 @@ declare global {
         to_formal_str(this: Date, ms?: boolean): string;
     }
     interface Number {
-        /** 12.4 KB (1 KB = 1024 B) */
-        to_fsize_str(this: number, units?: 'iec' | 'metric'): string;
+        /** 12.4 kb (1 kb = 1024 b) */
+        to_fsize_str(this: number): string;
         to_bin_str(this: number): string;
         /** 转换为 0x???? 这样的十六进制形式
             - length?: 位数自动对齐到 4 的倍数 */
@@ -171,15 +180,15 @@ declare global {
         log(this: string[], limit?: number): void;
         indent(this: string[], width?: number, c?: string): string[];
         indent2to4(this: string[]): string[];
-        /** 对数组中所有元素求和 (+), 返回结果 */
-        sum(this: T[]): T;
-        /** 查找数组中最大的元素，可传入 selector 选择某个属性，或者计算出某个值，用作大小比较 */
-        max(this: T[], selector?: keyof T | KeySelector<T>): T;
-        /** 查找数组中最小的元素，可传入 selector 选择某个属性，或者计算出某个值，用作大小比较 */
-        min(this: T[], selector?: keyof T | KeySelector<T>): T;
-        /** 去除重复元素（可按 selector 去重），重复值保留最后出现的那个
-            - selector?: 可以是 key (string, number, symbol) 或 (obj: any) => any */
-        unique(this: T[], selector?: keyof T | KeySelector<T>): T[];
+        /** 对数组中所有元素求和 (+), 返回结果，可传入 mapper 计算出某个值，用作求和 */
+        sum<TReturn = T>(this: T[], mapper?: keyof T | Mapper<T>): TReturn;
+        /** 查找数组中最大的元素，可传入 mapper 计算出某个值，用作大小比较 */
+        max(this: T[], mapper?: keyof T | Mapper<T>): T;
+        /** 查找数组中最小的元素，可传入 mapper 计算出某个值，用作大小比较 */
+        min(this: T[], mapper?: keyof T | Mapper<T>): T;
+        /** 去除重复元素（可按 mapper 选择或计算某个值来去重），重复值保留最后出现的那个
+            - mapper?: 可以是 key (string, number, symbol) 或 (obj: any) => any */
+        unique(this: T[], mapper?: keyof T | Mapper<T>): T[];
         /**
             - trim_line?: `true`
             - rm_empty_lines?: `true`
@@ -199,26 +208,26 @@ declare global {
         join_lines(append?: boolean): string;
     }
     interface BigInt {
+        /** 12.4 kb (1 kb = 1024 b) */
+        to_fsize_str(this: bigint): string;
         toJSON(this: bigint): string;
     }
     interface Error {
         toJSON(this: Error): string;
     }
     interface Set<T> {
-        map<TResult>(mapfn: (value: T, index: number) => TResult): TResult[];
+        map<TResult>(mapper: (value: T, index: number) => TResult): TResult[];
     }
 }
 interface SliceOptions {
     include?: boolean;
     last?: boolean;
 }
-import chalk from 'chalk';
 export declare const emoji_regex: RegExp;
-export { chalk };
 export declare const noop: () => void;
 export declare const ident: <T>(x: T) => T;
-export declare const build_selector: <TObj>(key: keyof TObj) => (obj: TObj) => TObj[keyof TObj];
-export type KeySelector<TObj = any, TKey extends keyof TObj = keyof TObj> = (key: TObj) => TObj[TKey];
+export declare const build_mapper: <TObj>(key: keyof TObj) => (obj: TObj) => TObj[keyof TObj];
+export type Mapper<TObj = any, TKey extends keyof TObj = keyof TObj> = (obj: TObj) => TObj[TKey];
 /** value 不为 null 或 undefined */
 export declare const not_empty: (value: any) => boolean;
 export declare const empty: (value: any) => boolean;
@@ -248,3 +257,5 @@ export declare const brackets: {
 export declare function to_json(obj: any, replacer?: any): string;
 export declare function to_json_safely(obj: any, replacer?: any): string;
 export declare function is_codepoint_fullwidth(codepoint: number): boolean;
+export declare function byte_size(bytes: number | bigint): string;
+export {};

package/prototype.js

@@ -1,15 +1,11 @@
-import byte_size from 'byte-size';
+import util from 'util';
 import EmojiRegex from 'emoji-regex';
+export const emoji_regex = EmojiRegex();
 import strip_ansi from 'strip-ansi';
-import chalk from 'chalk';
-import { to_fp, dirname, basename, extname } from "./path.js";
 import { t } from "./i18n/instance.js";
-chalk.level = 2;
-export const emoji_regex = EmojiRegex();
-export { chalk };
 export const noop = () => { };
 export const ident = (x) => x;
-export const build_selector = (key) => (obj) => obj[key];
+export const build_mapper = (key) => (obj) => obj[key];
 /** value 不为 null 或 undefined */
 export const not_empty = (value) => value !== null && value !== undefined;
 export const empty = (value) => value === undefined || value === null;
@@ -47,7 +43,6 @@ export const brackets = {
     fat: ['【', '】'],
     tortoise_shell: ['〔', '〕'],
 };
-const color_map = Object.fromEntries(['red_', 'green_', 'yellow_', 'blue_', 'magenta_', 'cyan_'].map(color => [color, `${color.slice(0, -1)}Bright`]));
 if (!globalThis.my_prototype_defined) {
     // ------------------------------------ String.prototype
     Object.defineProperties(String.prototype, {
@@ -222,6 +217,15 @@ if (!globalThis.my_prototype_defined) {
                 return Object.fromEntries(Object.entries($placeholders)
                     .map(([name, $i]) => [name, matches[$i] || '']));
             },
+            /** 查找子串或字符出现的次数 */
+            count(search) {
+                if (!search)
+                    throw new Error('count 的 search 不能为空');
+                let count = 0;
+                for (let i = 0; (i = this.indexOf(search, i)) !== -1; i += search.length)
+                    count++;
+                return count;
+            },
             quote(type = 'single') {
                 if (type === 'psh')
                     return `& ${this.quote()}`;
@@ -242,9 +246,6 @@ if (!globalThis.my_prototype_defined) {
             to_lf() {
                 return this.replace(/\r\n/g, '\n');
             },
-            to_crlf() {
-                return this.replace(/\n/g, '\r\n');
-            },
             rm(pattern, flags = 'g') {
                 if (typeof pattern === 'string')
                     pattern = new RegExp(pattern, flags);
@@ -345,45 +346,68 @@ if (!globalThis.my_prototype_defined) {
                     .replace(new RegExp('([A-Za-z0-9`\\$%\\^&\\*\\-=\\+\\\\\\|\\/@\u00a1-\u00ff\u2022\u2027\u2150-\u218f])' + cjk, 'g'), '$1 $2');
             }
         }),
-        // ------------ chalk colors
+        // ------------ colors
         ...Object.fromEntries([
             'red', 'green', 'yellow', 'blue', 'magenta', 'cyan', 'grey',
             'red_', 'green_', 'yellow_', 'blue_', 'magenta_', 'cyan_',
             'underline',
-        ].map(color => ([color, {
-                configurable: true,
-                get() {
-                    return chalk[color_map[color] || color](this);
-                }
-            }]))),
+        ].map(color => {
+            const style = color.endsWith('_') ? `${color.slice(0, -1)}Bright` : color;
+            return [color, {
+                    configurable: true,
+                    get() {
+                        // @ts-ignore
+                        return util.styleText(style, this, { validateStream: false });
+                    }
+                }];
+        })),
         // ------------ 文件路径操作
         ...to_getter_property_descriptors({
             isdir() {
                 return this.endsWith('/');
             },
             fp() {
-                return to_fp(this);
+                if (!this)
+                    return this;
+                const fp = this.replaceAll('\\', '/');
+                // 转换小写盘符开头的路径
+                return fp[1] === ':' && 'a' <= fp[0] && fp[0] <= 'z'
+                    ? fp[0].toUpperCase() + fp.slice(1)
+                    : fp;
             },
             fpd() {
-                const fp = to_fp(this);
+                const { fp } = this;
                 return fp.endsWith('/') ? fp : `${fp}/`;
             },
             fdir() {
-                const fpd = dirname(this);
-                // 有可能 fpd 是 '/'
-                return fpd.endsWith('/') ? fpd : `${fpd}/`;
+                return this.strip_end(this.fname);
             },
             fname() {
-                return `${basename(this)}${this.endsWith('/') ? '/' : ''}`;
+                const ilast = this.lastIndexOf('/');
+                if (ilast === -1)
+                    return this; // 没有斜杠时返回整个字符串
+                // 以斜杠结尾的情况
+                if (ilast === this.length - 1) {
+                    const iprev = this.lastIndexOf('/', ilast - 1);
+                    return iprev === -1
+                        ? this // 只有一个斜杠且在末尾
+                        : this.slice(iprev + 1);
+                }
+                // 返回最后一个斜杠后的内容
+                return this.slice(ilast + 1);
             },
             fext() {
-                return extname(this);
-            },
+                const { fname } = this;
+                const index = fname.lastIndexOf('.');
+                return index <= 0
+                    ? ''
+                    : fname.slice(index + 1);
+            }
         }),
         ...to_method_property_descriptors({
             to_backslash() {
                 return this.replaceAll('/', '\\');
-            },
+            }
         })
     });
     // ------------------------------------ Date.prototype
@@ -440,16 +464,14 @@ if (!globalThis.my_prototype_defined) {
         return String(hour).padStart(2, '0') + splitter +
             String(date.getMinutes()).padStart(2, '0') + splitter +
             String(date.getSeconds()).padStart(2, '0') +
-            (ms ?
-                '.' + String(date.getMilliseconds()).padStart(3, '0')
-                :
-                    '');
+            (ms
+                ? '.' + String(date.getMilliseconds()).padStart(3, '0')
+                : '');
     }
     // ------------------------------------ Number.prototype
     Object.defineProperties(Number.prototype, to_method_property_descriptors({
-        to_fsize_str(units = 'iec') {
-            const { value, unit } = byte_size(this, { units });
-            return `${value} ${unit.replace('i', '')}`;
+        to_fsize_str() {
+            return byte_size(this);
         },
         to_bin_str() {
             return `0b${this.toString(2)}`;
@@ -520,20 +542,27 @@ if (!globalThis.my_prototype_defined) {
                 return this.split_indents()
                     .map(line => ' '.repeat(line.indent * 2) + line.text);
             },
-            sum() {
-                return this.length
-                    ? this.reduce((acc, x) => acc + x)
-                    : undefined;
-            },
-            max(selector = ident) {
+            sum(mapper) {
                 if (!this.length)
                     return undefined;
-                if (is_key_type(selector))
-                    selector = build_selector(selector);
-                let max = selector(this[0]);
+                // 快捷路径
+                const first = this[0];
+                if ((typeof first === 'number' || typeof first === 'bigint') && !mapper)
+                    return this.reduce((acc, x) => acc + x, first);
+                if (is_key_type(mapper))
+                    mapper = build_mapper(mapper);
+                mapper ??= ident;
+                return this.reduce((acc, x) => acc + mapper(x), mapper(first));
+            },
+            max(mapper = ident) {
+                if (!this.length)
+                    return undefined;
+                if (is_key_type(mapper))
+                    mapper = build_mapper(mapper);
+                let max = mapper(this[0]);
                 let imax = 0;
                 for (let i = 0; i < this.length; i++) {
-                    const value = selector(this[i]);
+                    const value = mapper(this[i]);
                     if (value > max) {
                         max = value;
                         imax = i;
@@ -541,15 +570,15 @@ if (!globalThis.my_prototype_defined) {
                 }
                 return this[imax];
             },
-            min(selector = ident) {
+            min(mapper = ident) {
                 if (!this.length)
                     return undefined;
-                if (is_key_type(selector))
-                    selector = build_selector(selector);
-                let min = selector(this[0]);
+                if (is_key_type(mapper))
+                    mapper = build_mapper(mapper);
+                let min = mapper(this[0]);
                 let imin = 0;
                 for (let i = 0; i < this.length; i++) {
-                    const value = selector(this[i]);
+                    const value = mapper(this[i]);
                     if (value < min) {
                         min = value;
                         imin = i;
@@ -557,14 +586,14 @@ if (!globalThis.my_prototype_defined) {
                 }
                 return this[imin];
             },
-            unique(selector) {
-                if (!selector)
+            unique(mapper) {
+                if (!mapper)
                     return [...new Set(this)];
-                if (is_key_type(selector))
-                    selector = build_selector(selector);
+                if (is_key_type(mapper))
+                    mapper = build_mapper(mapper);
                 let map = new Map();
                 for (const x of this)
-                    map.set(selector(x), x);
+                    map.set(mapper(x), x);
                 return [...map.values()];
             },
             join_lines(append = true) {
@@ -573,6 +602,9 @@ if (!globalThis.my_prototype_defined) {
         })
     });
     Object.defineProperties(BigInt.prototype, to_method_property_descriptors({
+        to_fsize_str() {
+            return byte_size(this);
+        },
         toJSON() {
             return this.toString();
         }
@@ -643,4 +675,17 @@ export function is_codepoint_fullwidth(codepoint) {
             // cjk unified ideographs extension b .. tertiary ideographic plane
             (0x20000 <= codepoint && codepoint <= 0x3fffd)));
 }
+const units = ['b', 'kb', 'mb', 'gb', 'tb', 'pb', 'eb', 'zb', 'yb'];
+const bytes_table = units.map((unit, i) => ({
+    start: i === 0 ? 0 : 2 ** (i * 10),
+    end: 2 ** ((i + 1) * 10),
+    unit
+}));
+export function byte_size(bytes) {
+    bytes = Number(bytes);
+    const sign = bytes < 0 ? '-' : '';
+    bytes = Math.abs(bytes);
+    const { unit, start } = bytes_table.find(range => bytes >= range.start && bytes < range.end);
+    return `${sign}${start === 0 ? bytes : (bytes / start).toFixed()} ${unit}`;
+}
 //# sourceMappingURL=prototype.js.map