xshell 0.0.18 → 0.0.20

package/file.js

@@ -188,10 +188,9 @@ async function frename(fp, fp_, { fpd, print = true, overwrite = true } = {}) {
 }
 exports.frename = frename;
 async function fmkdir(fpd, options = {}) {
-    var _a;
     if (!upath_1.default.isAbsolute(fpd))
         throw new Error('fpd must be absolute path');
-    (_a = options.print) !== null && _a !== void 0 ? _a : (options.print = true);
+    options.print ?? (options.print = true);
     if (fpd.fexists)
         if (fpd.is_dir) {
             if (options.print && !options.suppress_existence)

package/file.js.map

@@ -1 +1 @@
-{"version":3,"file":"file.js","sourceRoot":"","sources":["file.ts"],"names":[],"mappings":"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","sourcesContent":["import { promises as fsp, watch } from 'fs'\nimport type fs from 'fs'\n\nimport path from 'upath'\nimport iconv from 'iconv-lite'\nimport { readdirAsync } from 'readdir-enhanced'\nimport fse from 'fs-extra'\nimport rimraf from 'rimraf'\n\nimport debounce from 'lodash/debounce'\n\n\nimport MFS from 'memfs'\ndeclare module 'memfs' {\n    interface IFs {\n        join: typeof path.join\n    }\n}\n\nimport { to_json } from './prototype'\nimport { dedent } from './utils'\nexport * from './ufs'\n\nexport { MFS }\n\nexport type Encoding = 'utf-8' | 'gb18030' | 'shift-jis' | 'binary'\n\n\nexport function create_mfs () {\n    return mfs = Object.assign(\n        MFS.createFsFromVolume(\n            new MFS.Volume()\n        ), \n        { join: path.join.bind(path) }\n    )\n}\n\nexport let mfs: MFS.IFs & { join: typeof path.join }\n\n\nexport async function fread (fp: string): Promise<string>\nexport async function fread (fp: string, { dir, encoding, print }?: { dir?: string, encoding: 'binary', print?: boolean }): Promise<Buffer>\nexport async function fread (fp: string, { dir, encoding, print }?: { dir?: string, encoding?: Encoding | 'auto', print?: boolean }): Promise<string>\nexport async function fread (fp: string, {\n    dir, \n    encoding = 'utf-8', \n    print = true\n}: {\n    dir?: string\n    encoding?: Encoding | 'auto'\n    print?: boolean } = { }\n) {\n    if (dir)\n        fp = path.join(dir, fp)\n    else if (!path.isAbsolute(fp))\n        throw new Error('fp must be absolute path, or pass in \"dir\" parameter')\n    \n    if (print)\n        console.log(`read: ${fp}`)\n        \n    const buffer = await fsp.readFile(fp)\n    \n    if (encoding === 'binary')\n        return buffer\n    \n    if (encoding === 'utf-8')\n        return buffer.toString('utf8')\n    \n    if (encoding === 'auto') {\n        const { detect } = await import('chardet')\n        encoding = detect(buffer) as any\n        if (print)\n            console.log(`${fp} probably has encoding: ${encoding.toLowerCase()}`)\n    }\n    \n    return iconv.decode(buffer, encoding)\n}\n\nexport async function fread_lines (fp: string, options: { dir?: string, encoding?: Exclude<Encoding, 'binary'> | 'auto', print?: boolean } = { }) {\n    return (await fread(fp, options))\n        .split_lines()\n}\n\nexport async function fread_json <T = any> (fp: string, options: { dir?: string, encoding?: Encoding, print?: boolean } = { }): Promise<T> {\n    return JSON.parse(\n        await fread(fp, options)\n    )\n}\n\n\nexport async function fwrite (fp: string, data: Buffer, options?: { dir?: string, print?: boolean }): Promise<void>\nexport async function fwrite (fp: string, data: any, options?: { dir?: string, encoding?: Encoding, print?: boolean }): Promise<void>\nexport async function fwrite (fp: string, data: any, { dir, encoding = 'utf-8', print = true }: { dir?: string, encoding?: Encoding, print?: boolean } = { }) {\n    if (dir)\n        fp = path.join(dir, fp)\n    else if (!path.isAbsolute(fp))\n        throw new Error('fp must be absolute path, or pass in \"dir\" parameter')\n    \n    if (print)\n        console.log('write:', fp)\n    \n    if (encoding === 'gb18030')\n        data = iconv.encode(data, encoding)\n    \n    if (!Buffer.isBuffer(data) && typeof data !== 'string')\n        data = to_json(data)\n    \n    await fsp.writeFile(fp, data)\n}\n\nexport async function fappend (fp: string, data: any, { dir, print = true }: { dir?: string, print?: boolean } = { }) {\n    if (dir)\n        fp = path.join(dir, fp)\n    else if (!path.isAbsolute(fp))\n        throw new Error('fp must be absolute path, or pass in \"dir\" parameter')\n    \n    if (print)\n        console.log('append:', fp)\n        \n    if (!Buffer.isBuffer(data) && typeof data !== 'string')\n        throw new Error('data is not Buffer or string')\n        \n    await fsp.appendFile(fp, data)\n}\n\n\n/**\n    - fpd: absolute path of directory\n    - optoins?:\n        - deep?: `false` recursively\n        - absolute?: `false` return absolute path\n        - print?: `true`\n        - filter?: `true`  RegExp | (fp: string) => any\n*/\nexport async function flist (fpd: string, {\n    filter, \n    deep = false, \n    absolute = false,\n    print = true\n}: {\n    filter?: RegExp | ((fp: string) => any)\n    deep?: boolean\n    absolute?: boolean\n    print?: boolean\n} = { }) {\n    if (!path.isAbsolute(fpd))\n        throw new Error('fpd must be absolute path')\n    \n    let fps = await readdirAsync(fpd, {\n        ...(absolute ? { basePath: fpd } : { }),\n        deep,\n        stats: false,\n    })\n    \n    fps = fps.map( fp => {\n        fp = path.normalize(fp)\n        if (print)\n            console.log(fp)\n        return fp\n    })\n    \n    if (filter instanceof RegExp)\n        return fps.filter( fp => filter.test(fp))\n    else if (filter)\n        return fps.filter(filter)\n    else\n        return fps\n}\n\n\n/** delete file or directory (use rimraf to delete directory fast)  \n    - fp: path\n    - options?:\n        - print?: `true` (effective only delete single file)\n*/\nexport async function fdelete (fp: string, { print = true, fast = false }: { print?: boolean, fast?: boolean } = { }) {\n    if (fp.length < 6) throw new Error(`${fp} too short`)\n    if (!path.isAbsolute(fp))\n        throw new Error('fpd must be absolute path')\n    \n    if (fp.is_dir) {\n        if (print)\n            console.log(`delete directory: ${fp}`.red)\n        await new Promise<void>((resolve, reject) => {\n            rimraf(fp, { glob: false, disableGlob: true }, error => {\n                if (error)\n                    reject(error)\n                else\n                    resolve()\n            })\n        })\n    } else {\n        if (print)\n            console.log('delete:', fp)\n        await fsp.unlink(fp)\n    }\n}\n\n\n/** copy file or direcotry\n    - src: src file/directory absolute path\n    - dst: dst file/directory absolute path\n    @example\n    fcopy('d:/temp/camera/', 'd:/camera/')\n*/\nexport async function fcopy (src: string, dst: string, {\n    print = true,\n    overwrite = true,\n}: {\n    print?: boolean\n    overwrite?: boolean\n} = { }) {\n    if (src.endsWith('/') !== dst.endsWith('/')) throw new Error('src and dst must be both file path or directory path')\n    if (!path.isAbsolute(src) || !path.isAbsolute(dst)) throw new Error('src and dst must be absolute path')\n    if (print)\n        console.log(`copy: ${src} → ${dst}`)\n    await fse.copy(src, dst, { overwrite, errorOnExist: true })\n}\n\n\n/** move file or direcotry\n    - src: src file/directory absolute path\n    - dst: dst file/directory absolute path\n    @example\n    fmove('d:/temp/camera/', 'd:/camera/')\n*/\nexport async function fmove (src: string, dst: string, {\n    overwrite = false,\n    print = true\n}: {\n    overwrite?: boolean\n    print?: boolean\n} = { }) {\n    if (src.endsWith('/') !== dst.endsWith('/')) throw new Error('src and dst must be both file path or directory path')\n    if (!path.isAbsolute(src) || !path.isAbsolute(dst)) throw new Error('src and dst must be absolute path')\n    if (print)\n        console.log(`move: ${src} → ${dst}`)\n    await fse.move(src, dst, { overwrite })\n}\n\n\n/** rename file  \n    - fp:  current filename/path\n    - fp_: new filename/path\n    - options?:\n        - fpd?: fp and fp_ is in same directory\n        - print?: `true`\n        - overwrite?: `true`  better performance without check\n */\nexport async function frename (\n    fp: string, \n    fp_: string,\n    {\n        fpd,\n        print = true,\n        overwrite = true\n    }: {\n        fpd?: string\n        print?: boolean\n        overwrite?: boolean\n    } = { }\n) {\n    if (fpd) {\n        fp = path.join(fpd, fp)\n        fp_ = path.join(fpd, fp_)\n    } else if (!path.isAbsolute(fp) || !path.isAbsolute(fp_))\n        throw new Error('fp and fp_ must be absolute path')\n    \n    if (print)\n        console.log('rename:', fp, '→', fp_)\n    \n    if (!overwrite && fp_.fexists)\n        throw new Error(`file already exists：${fp_}`)\n    \n    await fsp.rename(fp, fp_)\n}\n\n\nexport async function fmkdir (fpd: string, options: fs.MakeDirectoryOptions & { print?: boolean, suppress_existence?: boolean } = { }) {\n    if (!path.isAbsolute(fpd))\n        throw new Error('fpd must be absolute path')\n    \n    options.print ??= true\n    \n    if (fpd.fexists)\n        if (fpd.is_dir) {\n            if (options.print && !options.suppress_existence)\n                console.log('directory already exists:', fpd)\n            return\n        } else throw new Error(`file with same name already exists, cannot create directory: ${fpd}`)\n    else if (options.print)\n        console.log('create new directory:', fpd)\n    \n    await fsp.mkdir(fpd, { recursive: true })\n}\n\n\n/** - link: can be file path or directory path */\nexport async function flink (\n    fp_real: string, \n    fp_link: string, \n    {\n        junction = false,\n        print = true \n    }: { \n        junction?: boolean\n        print?: boolean\n} = { }) {\n    if (!path.isAbsolute(fp_real) || !path.isAbsolute(fp_link))\n        throw new Error('fpd must be absolute path')\n    \n    if (fp_link.fexists)\n        if (fp_link.is_dir)\n            fp_link = path.join(fp_link, fp_real.fname)\n        else if ( (await fsp.lstat(fp_link)).isSymbolicLink() ) {\n            console.log('link already exists:', fp_link)\n            return\n        } else\n            throw new Error('file with same name already exists, cannot create new link')\n        \n    \n    if (print)\n        console.log(`source file ${fp_real} linked to ${fp_link}`)\n    \n    if (junction)\n        fsp.symlink(fp_real, fp_link, 'junction')\n    else\n        fsp.symlink(fp_real, fp_link, fp_real.is_dir ? 'dir' : 'file')\n}\n\n\nexport function link_shortcut (target: string, name: string, { args }: { args?: string[] } = { }) {\n    const cmd = dedent`\n        $wsh_shell                 = New-Object -comObject WScript.Shell\n        $shortcut                  = $wsh_shell.CreateShortcut(\"d:/links/#{name}.lnk\")\n        $shortcut.TargetPath       = '${target}'\n        $shortcut.Arguments        = \"${args || ''}\"\n        $shortcut.WorkingDirectory = '${target.fdir}'\n        ${ target.is_dir ? '$shortcut.IconLocation = \"%SystemRoot%\\\\System32\\\\SHELL32.dll,3\"' : '' }\n        $shortcut.Save()\n    `\n    console.log(cmd)\n    // await psh(cmd)\n}\n\n\nexport let fwatchers: Record<string, fs.FSWatcher> = { }\n\n/**\n    - fp: path of file or directory\n    - callback: called when modified\n    - exec: call callback when watch is executed\n    save fs.FSWatcher in watchers, subsequent call will auto close existing watcher for the same fp\n    \n    https://nodejs.org/dist/latest-v15.x/docs/api/fs.html#fs_fs_watch_filename_options_listener  \n    The listener callback gets two arguments (event, filename). \n        event is either 'rename' or 'change', and filename is the name of the file which triggered the event.\n        On most platforms, 'rename' is emitted whenever a filename appears or disappears in the directory.\n    \n    The listener callback is attached to the 'change' event fired by fs.FSWatcher, but it is not the same thing as the 'change' value of event.  \n    \n*/\nexport async function fwatch (\n    fp: string, \n    onchange: (event: string, filename: string) => any,\n    { exec = true }: { exec?: boolean } = { }\n) {\n    if (!path.isAbsolute(fp)) throw new Error('fp must be absolute path')\n    \n    const _watcher = fwatchers[fp]\n    if (_watcher)\n        _watcher.close()\n    \n    if (exec)\n        await onchange('change', fp)\n    \n    const debounced_onchange = debounce((event, filename) => {\n        console.log(`file changed (${event}): ${filename}`)\n        onchange(event, path.normalize(filename))\n    }, 500, { leading: false, trailing: true })\n    const watcher = watch(fp, debounced_onchange)\n    watcher.on('error', error => { console.error(error) })\n    return fwatchers[fp] = watcher\n}\n\n\n/** open a file and replace certain pattern */\nexport async function freplace (fp: string, pattern: string | RegExp, replacement: string) {\n    await fwrite(\n        fp,\n        (await fread(fp))\n            .replaceAll(pattern, replacement)\n    )\n}\n\n/** convert file encoding to UTF-8\n    - fp: file absolute path\n    - options?:\n        - dryrun?: `true`\n        - encoding?: `'auto'`\n*/\nexport async function f2utf8 (fp: string, {\n    dryrun = true,\n    encoding = 'auto',\n}: {\n    dryrun?: boolean\n    encoding?: Encoding | 'auto'\n} = { }) {\n    const text = await fread(fp, { encoding })\n    if (dryrun) {\n        console.log(text.slice(0, 10000))\n        return\n    }\n    \n    const fp_bak = `${fp.fdir}${fp.fname.replace(/(.*?)(\\.[^.]+)?$/, '$1.bak$2')}`\n    if (!fp_bak.fexists)\n        await fcopy(fp, fp_bak)\n    \n    await fwrite(fp, text)\n}\n\n"]}
+{"version":3,"file":"file.js","sourceRoot":"","sources":["file.ts"],"names":[],"mappings":"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","sourcesContent":["import { promises as fsp, watch } from 'fs'\nimport type fs from 'fs'\n\nimport path from 'upath'\nimport iconv from 'iconv-lite'\nimport { readdirAsync } from 'readdir-enhanced'\nimport fse from 'fs-extra'\nimport rimraf from 'rimraf'\n\nimport debounce from 'lodash/debounce'\n\n\nimport MFS from 'memfs'\ndeclare module 'memfs' {\n    interface IFs {\n        join: typeof path.join\n    }\n}\n\nimport { to_json } from './prototype'\nimport { dedent } from './utils'\nexport * from './ufs'\n\nexport { MFS }\n\nexport type Encoding = 'utf-8' | 'gb18030' | 'shift-jis' | 'binary'\n\n\nexport function create_mfs () {\n    return mfs = Object.assign(\n        MFS.createFsFromVolume(\n            new MFS.Volume()\n        ), \n        { join: path.join.bind(path) }\n    )\n}\n\nexport let mfs: MFS.IFs & { join: typeof path.join }\n\n\nexport async function fread (fp: string): Promise<string>\nexport async function fread (fp: string, { dir, encoding, print }?: { dir?: string, encoding: 'binary', print?: boolean }): Promise<Buffer>\nexport async function fread (fp: string, { dir, encoding, print }?: { dir?: string, encoding?: Encoding | 'auto', print?: boolean }): Promise<string>\nexport async function fread (fp: string, {\n    dir, \n    encoding = 'utf-8', \n    print = true\n}: {\n    dir?: string\n    encoding?: Encoding | 'auto'\n    print?: boolean } = { }\n) {\n    if (dir)\n        fp = path.join(dir, fp)\n    else if (!path.isAbsolute(fp))\n        throw new Error('fp must be absolute path, or pass in \"dir\" parameter')\n    \n    if (print)\n        console.log(`read: ${fp}`)\n        \n    const buffer = await fsp.readFile(fp)\n    \n    if (encoding === 'binary')\n        return buffer\n    \n    if (encoding === 'utf-8')\n        return buffer.toString('utf8')\n    \n    if (encoding === 'auto') {\n        const { detect } = await import('chardet')\n        encoding = detect(buffer) as any\n        if (print)\n            console.log(`${fp} probably has encoding: ${encoding.toLowerCase()}`)\n    }\n    \n    return iconv.decode(buffer, encoding)\n}\n\nexport async function fread_lines (fp: string, options: { dir?: string, encoding?: Exclude<Encoding, 'binary'> | 'auto', print?: boolean } = { }) {\n    return (await fread(fp, options))\n        .split_lines()\n}\n\nexport async function fread_json <T = any> (fp: string, options: { dir?: string, encoding?: Encoding, print?: boolean } = { }): Promise<T> {\n    return JSON.parse(\n        await fread(fp, options)\n    )\n}\n\n\nexport async function fwrite (fp: string, data: Buffer, options?: { dir?: string, print?: boolean }): Promise<void>\nexport async function fwrite (fp: string, data: any, options?: { dir?: string, encoding?: Encoding, print?: boolean }): Promise<void>\nexport async function fwrite (fp: string, data: any, { dir, encoding = 'utf-8', print = true }: { dir?: string, encoding?: Encoding, print?: boolean } = { }) {\n    if (dir)\n        fp = path.join(dir, fp)\n    else if (!path.isAbsolute(fp))\n        throw new Error('fp must be absolute path, or pass in \"dir\" parameter')\n    \n    if (print)\n        console.log('write:', fp)\n    \n    if (encoding === 'gb18030')\n        data = iconv.encode(data, encoding)\n    \n    if (!Buffer.isBuffer(data) && typeof data !== 'string')\n        data = to_json(data)\n    \n    await fsp.writeFile(fp, data)\n}\n\nexport async function fappend (fp: string, data: any, { dir, print = true }: { dir?: string, print?: boolean } = { }) {\n    if (dir)\n        fp = path.join(dir, fp)\n    else if (!path.isAbsolute(fp))\n        throw new Error('fp must be absolute path, or pass in \"dir\" parameter')\n    \n    if (print)\n        console.log('append:', fp)\n        \n    if (!Buffer.isBuffer(data) && typeof data !== 'string')\n        throw new Error('data is not Buffer or string')\n        \n    await fsp.appendFile(fp, data)\n}\n\n\n/**\n    - fpd: absolute path of directory\n    - optoins?:\n        - deep?: `false` recursively\n        - absolute?: `false` return absolute path\n        - print?: `true`\n        - filter?: `true`  RegExp | (fp: string) => any\n*/\nexport async function flist (fpd: string, {\n    filter, \n    deep = false, \n    absolute = false,\n    print = true\n}: {\n    filter?: RegExp | ((fp: string) => any)\n    deep?: boolean\n    absolute?: boolean\n    print?: boolean\n} = { }) {\n    if (!path.isAbsolute(fpd))\n        throw new Error('fpd must be absolute path')\n    \n    let fps = await readdirAsync(fpd, {\n        ...(absolute ? { basePath: fpd } : { }),\n        deep,\n        stats: false,\n    })\n    \n    fps = fps.map( fp => {\n        fp = path.normalize(fp)\n        if (print)\n            console.log(fp)\n        return fp\n    })\n    \n    if (filter instanceof RegExp)\n        return fps.filter( fp => filter.test(fp))\n    else if (filter)\n        return fps.filter(filter)\n    else\n        return fps\n}\n\n\n/** delete file or directory (use rimraf to delete directory fast)  \n    - fp: path\n    - options?:\n        - print?: `true` (effective only delete single file)\n*/\nexport async function fdelete (fp: string, { print = true, fast = false }: { print?: boolean, fast?: boolean } = { }) {\n    if (fp.length < 6) throw new Error(`${fp} too short`)\n    if (!path.isAbsolute(fp))\n        throw new Error('fpd must be absolute path')\n    \n    if (fp.is_dir) {\n        if (print)\n            console.log(`delete directory: ${fp}`.red)\n        await new Promise<void>((resolve, reject) => {\n            rimraf(fp, { glob: false, disableGlob: true }, error => {\n                if (error)\n                    reject(error)\n                else\n                    resolve()\n            })\n        })\n    } else {\n        if (print)\n            console.log('delete:', fp)\n        await fsp.unlink(fp)\n    }\n}\n\n\n/** copy file or direcotry\n    - src: src file/directory absolute path\n    - dst: dst file/directory absolute path\n    @example\n    fcopy('d:/temp/camera/', 'd:/camera/')\n*/\nexport async function fcopy (src: string, dst: string, {\n    print = true,\n    overwrite = true,\n}: {\n    print?: boolean\n    overwrite?: boolean\n} = { }) {\n    if (src.endsWith('/') !== dst.endsWith('/')) throw new Error('src and dst must be both file path or directory path')\n    if (!path.isAbsolute(src) || !path.isAbsolute(dst)) throw new Error('src and dst must be absolute path')\n    if (print)\n        console.log(`copy: ${src} → ${dst}`)\n    await fse.copy(src, dst, { overwrite, errorOnExist: true })\n}\n\n\n/** move file or direcotry\n    - src: src file/directory absolute path\n    - dst: dst file/directory absolute path\n    @example\n    fmove('d:/temp/camera/', 'd:/camera/')\n*/\nexport async function fmove (src: string, dst: string, {\n    overwrite = false,\n    print = true\n}: {\n    overwrite?: boolean\n    print?: boolean\n} = { }) {\n    if (src.endsWith('/') !== dst.endsWith('/')) throw new Error('src and dst must be both file path or directory path')\n    if (!path.isAbsolute(src) || !path.isAbsolute(dst)) throw new Error('src and dst must be absolute path')\n    if (print)\n        console.log(`move: ${src} → ${dst}`)\n    await fse.move(src, dst, { overwrite })\n}\n\n\n/** rename file  \n    - fp:  current filename/path\n    - fp_: new filename/path\n    - options?:\n        - fpd?: fp and fp_ is in same directory\n        - print?: `true`\n        - overwrite?: `true`  better performance without check\n */\nexport async function frename (\n    fp: string, \n    fp_: string,\n    {\n        fpd,\n        print = true,\n        overwrite = true\n    }: {\n        fpd?: string\n        print?: boolean\n        overwrite?: boolean\n    } = { }\n) {\n    if (fpd) {\n        fp = path.join(fpd, fp)\n        fp_ = path.join(fpd, fp_)\n    } else if (!path.isAbsolute(fp) || !path.isAbsolute(fp_))\n        throw new Error('fp and fp_ must be absolute path')\n    \n    if (print)\n        console.log('rename:', fp, '→', fp_)\n    \n    if (!overwrite && fp_.fexists)\n        throw new Error(`file already exists：${fp_}`)\n    \n    await fsp.rename(fp, fp_)\n}\n\n\nexport async function fmkdir (fpd: string, options: fs.MakeDirectoryOptions & { print?: boolean, suppress_existence?: boolean } = { }) {\n    if (!path.isAbsolute(fpd))\n        throw new Error('fpd must be absolute path')\n    \n    options.print ??= true\n    \n    if (fpd.fexists)\n        if (fpd.is_dir) {\n            if (options.print && !options.suppress_existence)\n                console.log('directory already exists:', fpd)\n            return\n        } else throw new Error(`file with same name already exists, cannot create directory: ${fpd}`)\n    else if (options.print)\n        console.log('create new directory:', fpd)\n    \n    await fsp.mkdir(fpd, { recursive: true })\n}\n\n\n/** - link: can be file path or directory path */\nexport async function flink (\n    fp_real: string, \n    fp_link: string, \n    {\n        junction = false,\n        print = true \n    }: { \n        junction?: boolean\n        print?: boolean\n} = { }) {\n    if (!path.isAbsolute(fp_real) || !path.isAbsolute(fp_link))\n        throw new Error('fpd must be absolute path')\n    \n    if (fp_link.fexists)\n        if (fp_link.is_dir)\n            fp_link = path.join(fp_link, fp_real.fname)\n        else if ( (await fsp.lstat(fp_link)).isSymbolicLink() ) {\n            console.log('link already exists:', fp_link)\n            return\n        } else\n            throw new Error('file with same name already exists, cannot create new link')\n        \n    \n    if (print)\n        console.log(`source file ${fp_real} linked to ${fp_link}`)\n    \n    if (junction)\n        fsp.symlink(fp_real, fp_link, 'junction')\n    else\n        fsp.symlink(fp_real, fp_link, fp_real.is_dir ? 'dir' : 'file')\n}\n\n\nexport function link_shortcut (target: string, name: string, { args }: { args?: string[] } = { }) {\n    const cmd = dedent`\n        $wsh_shell                 = New-Object -comObject WScript.Shell\n        $shortcut                  = $wsh_shell.CreateShortcut(\"d:/links/#{name}.lnk\")\n        $shortcut.TargetPath       = '${target}'\n        $shortcut.Arguments        = \"${args || ''}\"\n        $shortcut.WorkingDirectory = '${target.fdir}'\n        ${ target.is_dir ? '$shortcut.IconLocation = \"%SystemRoot%\\\\System32\\\\SHELL32.dll,3\"' : '' }\n        $shortcut.Save()\n    `\n    console.log(cmd)\n    // await psh(cmd)\n}\n\n\nexport let fwatchers: Record<string, fs.FSWatcher> = { }\n\n/**\n    - fp: path of file or directory\n    - callback: called when modified\n    - exec: call callback when watch is executed\n    save fs.FSWatcher in watchers, subsequent call will auto close existing watcher for the same fp\n    \n    https://nodejs.org/dist/latest-v15.x/docs/api/fs.html#fs_fs_watch_filename_options_listener  \n    The listener callback gets two arguments (event, filename). \n        event is either 'rename' or 'change', and filename is the name of the file which triggered the event.\n        On most platforms, 'rename' is emitted whenever a filename appears or disappears in the directory.\n    \n    The listener callback is attached to the 'change' event fired by fs.FSWatcher, but it is not the same thing as the 'change' value of event.  \n    \n*/\nexport async function fwatch (\n    fp: string, \n    onchange: (event: string, filename: string) => any,\n    { exec = true }: { exec?: boolean } = { }\n) {\n    if (!path.isAbsolute(fp)) throw new Error('fp must be absolute path')\n    \n    const _watcher = fwatchers[fp]\n    if (_watcher)\n        _watcher.close()\n    \n    if (exec)\n        await onchange('change', fp)\n    \n    const debounced_onchange = debounce((event, filename) => {\n        console.log(`file changed (${event}): ${filename}`)\n        onchange(event, path.normalize(filename))\n    }, 500, { leading: false, trailing: true })\n    const watcher = watch(fp, debounced_onchange)\n    watcher.on('error', error => { console.error(error) })\n    return fwatchers[fp] = watcher\n}\n\n\n/** open a file and replace certain pattern */\nexport async function freplace (fp: string, pattern: string | RegExp, replacement: string) {\n    await fwrite(\n        fp,\n        (await fread(fp))\n            .replaceAll(pattern, replacement)\n    )\n}\n\n/** convert file encoding to UTF-8\n    - fp: file absolute path\n    - options?:\n        - dryrun?: `true`\n        - encoding?: `'auto'`\n*/\nexport async function f2utf8 (fp: string, {\n    dryrun = true,\n    encoding = 'auto',\n}: {\n    dryrun?: boolean\n    encoding?: Encoding | 'auto'\n} = { }) {\n    const text = await fread(fp, { encoding })\n    if (dryrun) {\n        console.log(text.slice(0, 10000))\n        return\n    }\n    \n    const fp_bak = `${fp.fdir}${fp.fname.replace(/(.*?)(\\.[^.]+)?$/, '$1.bak$2')}`\n    if (!fp_bak.fexists)\n        await fcopy(fp, fp_bak)\n    \n    await fwrite(fp, text)\n}\n\n"]}

package/i18n/README.md

@@ -0,0 +1,283 @@
+# xshell/i18n
+
+## TL;DR
+npm i xshell/i18n
+```typescript
+import I18N from 'xshell/i18n'
+
+const i18n = new I18N({
+    '你好，世界！': {
+        en: 'Hello, world!',
+        ja: 'こんにちは世界！',
+        ko: '안녕하세요！'
+    }
+}, /* 浏览器中可不传，会自动判断 */ 'ja')
+
+console.log(i18n.t('你好，世界！'))
+```
+
+## 功能
+- 动态翻译字段: `i18n.r(field)`
+
+- 静态翻译文本: `i18n.t('文本')`
+
+- 作为 NodeJS 中间件处理请求 (Koa, Express, Egg.js, ...)，解析语言，提供 request scope 的翻译函数
+
+- React Trans 组件:
+```html
+<Trans count={count} tOptions={{ context: 'asdf' }}>
+    Hello <strong title="this is your name">{{name}}</strong>, you have {{count}} unread message(s). <a href="/msgs">Go to messages</a>.
+</Trans>
+```
+
+- 扫描代码中的词条: `i18n-scan -i "src/**/*.{ts,tsx,js,jsx,ejs}"`
+
+- 自动标记中文词条
+
+
+## 特性
+- 基于 i18next, react-i18next 封装，支持单复数，context, 变量插值 等
+
+- 按照一定的优先级自动解析用户首选语言和国内／国际来源，可同时在浏览器环境和 NodeJS 中使用
+
+- 翻译语言缺失自动 fallback: ja/ko -> en -> zh -> key
+
+- 可手工编辑的词典文件格式
+
+## API
+```typescript
+class I18N {
+    /** (ISO 639-1 标准语言代码) 可能取 zh, en, ja, ko */
+    language: 'zh' | 'en' | 'ja' | 'ko'
+    
+    /** 标记静态文本，以便扫描词条，并在运行时根据当前语言获取翻译 */
+    t : (text: string, options?: { language?: Language, context?: string, count?: number, [key: string]: any }) => string
+    
+    /** render: 翻译配置字段 */
+    r : (field: Item | undefined | null) => string
+    
+    /** hostname shortcuts */
+    hosts: Hosts
+    
+    /** url prefix shortcuts */
+    roots: Roots
+}
+
+/** 配置字段 */
+interface Item {
+    zh?: string
+    en?: string
+    ja?: string
+    ko?: string
+}
+```
+
+## 使用方法
+### 一、NodeJS 中使用
+```typescript
+const _dict = require('<project>/i18n/dict.json')  // 项目词典文件
+
+new I18N(_dict, 'en')
+```
+
+
+### 二、浏览器中使用
+```typescript
+import { I18N, Trans } from 'xshell/i18n'
+import _dict from '<project>/i18n/dict.json'  // 项目词典文件
+
+export let i18n = new I18N(_dict /* , language 浏览器中可不传 language 参数，会自动判断 */)
+
+const { t, r, Trans, intl } = i18n
+
+// 可用于判断是否为国际站
+i18n.intl === true
+
+i18n.t('文本') === t('文本') === '文本翻译'
+
+i18n.language = 'en'  // 所有方法已绑定在 i18n 上，修改语言后函数会使用新设置的语言
+t('文本')  === '根据新的 i18n.language 翻译'
+
+
+// 高级用法
+// 单复数
+t('共有 {{count}} 个人', { context: 'button', count: 3 })
+
+// 变量插值
+t('{{minutes}}分 {{seconds}}秒 内完成支付', { minutes: 3, seconds: 40 })
+
+
+// 翻译特定格式的配置字段
+if (obj === { zh: '中文', en: 'english', ja: '日本語', ko: '...' })
+    i18n.r(obj) === '根据 i18n.language 输出翻译结果'
+```
+
+
+#### Trans 组件
+```jsx
+import { I18N, Trans } from 'xshell/i18n'
+
+// import _dict from '<project>/i18n/dict.json'
+const _dict = {
+    "阅读更多": {
+        "en": "Read more",
+        "ja": "もっとご覧になる",
+        "ko": "더 읽어보기"
+    },
+    "',\",<,>为非法字符,请重新输入!": {
+        "en": ", \", <, and > are invalid characters. Please enter again.",
+    },
+    "书": {
+        "ja": "{{count}}冊の本",
+        "en": "{{count}} book",
+    },
+    "书_plural": {
+        "en": "{{count}} books",
+    },
+    "test_key": {
+        "en": "Hello <1>{{name}}</1>, you have {{count}} unread message. <5>Go to message</5>.",
+        "zh": "你好 <1>{{name}}</1>, you have {{count}} unread message. <5>Go to message</5>.",
+    },
+    "test_key_plural": {
+        "en": "Hello <1>{{name}}</1>, you have {{count}} unread messages.  <5>Go to messages</5>.",
+    },
+}
+
+// init <Trans> by side effects
+let i18n = new I18N(_dict)
+
+
+function TestTrans () {
+    const count = 3
+    const name  = 'hongfeishen'
+    
+    return (<div>
+        <Trans count={count} tOptions={{ lng: 'zh' }}>Hello <strong title="this is your name">{{name}}</strong>, you have {{count}} unread message(s). <a href="/msgs">Go to messages</a>.</Trans><br/>
+        <Trans>联系我们</Trans><br/>
+        <Trans tOptions={{ language: 'ko' }}>阅读更多</Trans><br/>
+        <Trans tOptions={{ context: 'pricecenter' }}>阅读更多</Trans><br/>
+        <Trans tOptions={{ context: 'pricecenter', lng: 'ja' }}>阅读更多</Trans><br/>
+        <Trans count={0}>书</Trans><br/>
+        <Trans count={1}>书</Trans><br/>
+        <Trans count={2}>书</Trans><br/>
+    </div>)
+}
+```
+
+更多 Trans 组件用法请参考 [react-i18next 文档](https://react.i18next.com/guides/quick-start)
+
+
+## 词条扫描以及更新翻译的方法
+### 整体流程
+![i18n-arch.png](https://cos.shenhongfei.com/assets/i18n-arch.png)
+
+### 词条标记
+#### 词条标记文档  
+https://react.i18next.com/guides/quick-start
+
+
+#### 使用 ESLint 的 fix 功能自动标记代码中的中文词条
+```shell
+npm i eslint eslint-plugin-i18n --save-dev
+```
+
+安装完后在项目的 `.eslintrc.json` 中加入以下配置启用 i18n 规则 (完整配置可参考本项目中的 .eslintrc.json)
+```json
+{
+    "parser": "@typescript-eslint/parser",
+    "plugins": [
+        ...
+        "i18n"
+    ],
+    "rules": {
+        ...
+        "i18n/no-chinese-character": "error",
+    }
+}
+```
+
+### 词条扫描
+可扫描代码中的 `t` 静态标记以及 `Trans 组件`，支持 .js, .jsx, .ts, .tsx, .ejs 文件
+
+请升级 NodeJS 到最新版本，并确保含有 `Trans 组件` 所在的文件后缀为 `.jsx` 或 `.tsx`，否则 `Trans 组件` 不会被扫描到
+
+### 扫描流程
+1. 在项目中安装 xshell 后，会生成 i18n-scan 命令
+
+2. 在项目 package.json 的 scripts 中加入脚本：`"scan": "i18n-scan --input \"src/**/*.{ts,tsx,js,jsx,ejs}\" --output i18n/",`
+
+3. 使用 `npm run scan` 扫描词条，会创建或修改 `./i18n/` 下的:  
+   ① `scanneds.json` 代码中扫描到的词条及其翻译 (仅本次 --input 所包含代码中的词条及翻译)  
+   ② `source/zh.json`, `source/en.json`, ... (`scanneds.json` 对应的 tea 词条格式，可提交到翻译仓库交由翻译团队翻译)  
+   ③ `dict.json` 完整的词典文件 (历史所有词条词条及翻译，会被打包到代码中在运行时决定词条翻译)  
+
+4. 补齐 `scanneds.json` 中的翻译，可以选择下面两种方法之一补充翻译：
+    - 【方法一】交由翻译团队翻译：将 `source/zh.json` 等文件提交到翻译仓库 https://git.woa.com/intl-platform/intl-console-translation ，并创建 TAPD 单，待 `en.json`, 等翻译返回后放到 `source/` 中覆盖原来的文件  
+        - 自动化提交翻译词条配置可以参考文档 http://tapd.oa.com/tcp_access/markdown_wikis/show/#1220399462000786583  
+        - 配置完成后先运行 `npm run dict-pull` 拉取仓库中的词条翻译到本地  
+        - 再运行 `npm run scan` 生成待翻译词条  
+        - 最后运行 `npm run dict-push -- --lang en` 上传待翻译词条到仓库，提交 TAPD 单等待翻译团队翻译词条  
+        - 翻译团队完成翻译后再将词条拉取到本地 `npm run dict-pull`  
+    - 【方法二】手动补充词条翻译：手动补全扫描结果 `scanneds.json` 中未翻译的词条  
+
+5. 通过以上 `"4."` 步骤补充翻译后重新运行扫描 `npm run scan`，这次扫描会自动根据 `source/en.json` 以及 `scanneds.json` 更新 `dict.json`。最终构建时 `dict.json` 内的词条会被打包进 js, 通过 i18n.init(<dict.json>) 加载
+
+![i18n-scan.png](https://cos.shenhongfei.com/assets/i18n-scan.png)
+
+
+### 词典文件 dict.json 格式
+新增词条可在文件尾部加入，已有词条可直接补充翻译
+```ts
+{
+    // 词条 key
+    "已有词条": {
+        "zh": "xxxxx", // 一般不需要设置中文翻译，默认为词条 key 使用中文
+        // 在此加入 "en" 和 "ja" 等翻译，暂时没有对应语言的词条可跳过，无需设置空字符串
+    },
+    
+    ...
+    
+    "阅读更多": {
+        "en": "Read more",
+        "ja": "もっとご覧になる",
+        "ko": "더 읽어보기"
+    },
+    
+    ...
+    
+    // _plural 后缀表示单复数形式, 用来区分相同短语的单复数形式，并通过 i18n.t('书', { count: 3 }) 调用自动选择正确的单复数形式
+    "书": {
+        "ja": "{{count}}冊の本",
+        "en": "{{count}} book",
+    },
+    "书_plural": {
+        "en": "{{count}} books",
+    },
+    
+    ...
+    
+    // _button 后缀表示 context, 用来区分相同中文短语的不同使用场合的词条，并通过 i18n.t('提交', { context: 'button' }) 调用选择正确的翻译
+    "提交_button": {
+        "ja": "",
+        "en": "{{count}} book",
+    },
+    "提交": {
+        "ja": "{{count}}冊の本",
+        "en": "{{count}} book",
+    },
+}
+
+```
+
+## Runtime Dependencies
+- i18next
+- js-cookie
+- qs
+- 使用 Trans 组件时
+    - react
+    - react-i18next
+
+
+## 作者
+ShenHongFei (沈鸿飞)
+

package/i18n/dict.d.ts

@@ -0,0 +1,30 @@
+import { Language } from './index';
+export declare class Dict {
+    _dict: _Dict;
+    constructor(_dict?: _Dict);
+    get(key: string): Item | undefined;
+    get(key: string, language: Language): string | '';
+    to_resources(): {
+        zh: {
+            translation: {};
+        };
+        en: {
+            translation: {};
+        };
+        ja: {
+            translation: {};
+        };
+        ko: {
+            translation: {};
+        };
+    };
+}
+/** 配置字段 */
+export declare type Item = {
+    [language in Language]?: string;
+};
+/** JSON.parse(词典文件.json) 得到的对象 */
+export interface _Dict {
+    [key: string]: Item;
+}
+export default Dict;

package/i18n/dict.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Dict = void 0;
+class Dict {
+    constructor(_dict = {}) {
+        this._dict = _dict;
+    }
+    get(key, language) {
+        if (!key)
+            return '';
+        const item = this._dict[key];
+        if (!item || !language)
+            return item || '';
+        return item[language] || '';
+    }
+    to_resources() {
+        return Object.entries(this._dict).reduce((acc, [key, item]) => {
+            Object.entries(item).forEach(([language, translation]) => {
+                if (!translation || !acc[language])
+                    return;
+                acc[language].translation[key] = translation;
+            });
+            return acc;
+        }, {
+            zh: { translation: {} },
+            en: { translation: {} },
+            ja: { translation: {} },
+            ko: { translation: {} },
+        });
+    }
+}
+exports.Dict = Dict;
+exports.default = Dict;
+//# sourceMappingURL=dict.js.map

package/i18n/dict.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dict.js","sourceRoot":"","sources":["dict.ts"],"names":[],"mappings":";;;AAEA,MAAa,IAAI;IAGb,YAAa,QAAe,EAAE;QAC1B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;IACtB,CAAC;IAID,GAAG,CAAE,GAAW,EAAE,QAAmB;QACjC,IAAI,CAAC,GAAG;YAAE,OAAO,EAAE,CAAA;QACnB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QAC5B,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,IAAI,EAAE,CAAA;QACzC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAA;IAC/B,CAAC;IAED,YAAY;QACR,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAE,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE;YAC3D,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,CAAE,CAAC,CAAE,QAAQ,EAAE,WAAW,CAAE,EAAE,EAAE;gBACxD,IAAI,CAAC,WAAW,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC;oBAAE,OAAM;gBAC1C,GAAG,CAAC,QAAQ,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,WAAW,CAAA;YAChD,CAAC,CAAC,CAAA;YACF,OAAO,GAAG,CAAA;QACd,CAAC,EAAE;YACC,EAAE,EAAE,EAAE,WAAW,EAAE,EAAG,EAAE;YACxB,EAAE,EAAE,EAAE,WAAW,EAAE,EAAG,EAAE;YACxB,EAAE,EAAE,EAAE,WAAW,EAAE,EAAG,EAAE;YACxB,EAAE,EAAE,EAAE,WAAW,EAAE,EAAG,EAAE;SAC3B,CAAC,CAAA;IACN,CAAC;CACJ;AA9BD,oBA8BC;AAeD,kBAAe,IAAI,CAAA","sourcesContent":["import { Language } from './index'\n\nexport class Dict {\n    _dict: _Dict\n    \n    constructor (_dict: _Dict = {}) {\n        this._dict = _dict\n    }\n    \n    get (key: string): Item | undefined\n    get (key: string, language: Language): string | ''\n    get (key: string, language?: Language) {\n        if (!key) return ''\n        const item = this._dict[key]\n        if (!item || !language) return item || ''\n        return item[language] || ''\n    }\n    \n    to_resources () {\n        return Object.entries(this._dict).reduce( (acc, [key, item]) => {\n            Object.entries(item).forEach( ([ language, translation ]) => {\n                if (!translation || !acc[language]) return\n                acc[language].translation[key] = translation\n            })\n            return acc\n        }, {\n            zh: { translation: { } },\n            en: { translation: { } },\n            ja: { translation: { } },\n            ko: { translation: { } },\n        })\n    }\n}\n\n\n/** 配置字段 */\nexport type Item = {\n    [language in Language]?: string\n}\n\n\n/** JSON.parse(词典文件.json) 得到的对象 */\nexport interface _Dict {\n    [key: string]: Item\n}\n\n\nexport default Dict\n"]}

package/i18n/i18n-scan.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/i18n/i18n-scan.js

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const upath_1 = (0, tslib_1.__importDefault)(require("upath"));
+const commander_1 = require("commander");
+const scanner_1 = (0, tslib_1.__importDefault)(require("./scanner"));
+const utils_1 = require("./utils");
+commander_1.program.name('i18n-scan')
+    .option('-r, --rootdir [rootdir]', '根目录：默认为当前工作目录', upath_1.default.normalize(process.cwd()))
+    .option('-i, --input [input]', '扫描 pattern：多个 pattern 用分号分割，采用 glob pattern 匹配，如 `src/**/*.{js,jsx,ts,tsx}`', v => v.split(';'))
+    .option('-o, --output [output]', 'i18n 目录：默认为 <rootdir>/i18n/')
+    .option('-c, --config [config]', '自定义配置文件，默认为 <rootdir>/i18n/config.js ，可参考默认配置 xshell/i18n/index.ts 以及 https://github.com/i18next/i18next-scanner', 'i18n/config.js')
+    .parse(process.argv);
+const { rootdir, config, input, output } = commander_1.program.opts();
+(0, scanner_1.default)(rootdir, {
+    ...(0, utils_1.try_require)(upath_1.default.resolve(rootdir, config)),
+    ...input ? { input } : {},
+    ...output ? { output } : {},
+});
+//# sourceMappingURL=i18n-scan.js.map

package/i18n/i18n-scan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n-scan.js","sourceRoot":"","sources":["i18n-scan.ts"],"names":[],"mappings":";;;;AAEA,+DAAwB;AACxB,yCAAmC;AAEnC,qEAA+B;AAC/B,mCAAqC;AAErC,mBAAO,CAAC,IAAI,CAAC,WAAW,CAAC;KACpB,MAAM,CAAC,yBAAyB,EAAK,eAAe,EAAE,eAAI,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;KACpF,MAAM,CAAC,qBAAqB,EAAS,6EAA6E,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;KACtI,MAAM,CAAC,uBAAuB,EAAO,6BAA6B,CAAC;KACnE,MAAM,CAAC,uBAAuB,EAAO,kHAAkH,EAAE,gBAAgB,CAAC;KAC1K,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;AAExB,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,mBAAO,CAAC,IAAI,EAAE,CAAA;AACzD,IAAA,iBAAO,EAAC,OAAO,EAAE;IACb,GAAI,IAAA,mBAAW,EAAE,eAAI,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAE;IAChD,GAAI,KAAK,CAAE,CAAC,CAAE,EAAE,KAAK,EAAE,CAAG,CAAC,CAAE,EAAG;IAChC,GAAI,MAAM,CAAC,CAAC,CAAE,EAAE,MAAM,EAAE,CAAE,CAAC,CAAE,EAAG;CACnC,CAAC,CAAA","sourcesContent":["#!/usr/bin/env node\n\nimport path from 'upath'\nimport { program } from 'commander'\n\nimport scanner from './scanner'\nimport { try_require } from './utils'\n\nprogram.name('i18n-scan')\n    .option('-r, --rootdir [rootdir]'   , '根目录：默认为当前工作目录', path.normalize(process.cwd()))\n    .option('-i, --input [input]'       , '扫描 pattern：多个 pattern 用分号分割，采用 glob pattern 匹配，如 `src/**/*.{js,jsx,ts,tsx}`', v => v.split(';'))\n    .option('-o, --output [output]'     , 'i18n 目录：默认为 <rootdir>/i18n/')\n    .option('-c, --config [config]'     , '自定义配置文件，默认为 <rootdir>/i18n/config.js ，可参考默认配置 xshell/i18n/index.ts 以及 https://github.com/i18next/i18next-scanner', 'i18n/config.js')\n    .parse(process.argv)\n\nconst { rootdir, config, input, output } = program.opts()\nscanner(rootdir, {\n    ... try_require( path.resolve(rootdir, config) ),\n    ... input  ?  { input }   :  { },\n    ... output ?  { output }  :  { },\n})\n"]}

package/i18n/index.d.ts

@@ -0,0 +1,65 @@
+import type { i18n as I18Next } from 'i18next';
+import type { Trans } from 'react-i18next';
+import type { _Dict, Item } from './dict';
+export declare type Language = 'zh' | 'en' | 'ja' | 'ko';
+export declare const LANGUAGES: readonly ["zh", "en", "ja", "ko"];
+declare global {
+    interface Window {
+        language: Language;
+    }
+}
+/**
+    提供翻译文本功能，在浏览器环境下自动解析当前语言、国际/国内用户
+    @see https://github.com/ShenHongFei/xshell/i18n/
+*/
+export declare class I18N {
+    static LANGUAGE_REGEXP: RegExp;
+    /** (ISO 639-1 标准语言代码) 可能取 zh, en, ja, ko */
+    language: Language;
+    /** hostname shortcuts */
+    hosts: Hosts;
+    /** url prefix shortcuts */
+    roots: Roots;
+    /** 标记静态文本，以便扫描词条，并在运行时根据当前语言获取翻译 */
+    t: (text: string, options?: {
+        language?: Language;
+        context?: string;
+        count?: number;
+        [key: string]: any;
+    }) => string;
+    /** render: 翻译配置字段 */
+    r: (field: Item | undefined | null) => string;
+    i18next: I18Next;
+    /** react-i18next <Trans/> 组件 */
+    Trans: typeof Trans;
+    /** ```ts
+        import dict from './dict.json'  // { "添加": { "en": "Add", "ja": "追加", "ko": "추가" } }
+        
+        const i18n = new I18N(dict, 'zh')  // 创建实例，传入词典 dict 并指定语言（NodeJS 环境），
+        const i18n = new I18N(dict)        // 创建实例，传入词典 dict 并自动判断当前语言（浏览器环境），
+        const i18n = new I18N({ })         // 创建实例，传入空词典
+        ```
+        @see https://github.com/ShenHongFei/xshell/i18n/
+    */
+    constructor(_dict: _Dict, language?: Language);
+    /** 加载词典文件 (需要将这两行单独放一个文件里，以保证在 import 其他文件之前执行)
+        
+        @example
+        import dict from './dict.json'  // { "添加": { "en": "Add", "ja": "追加", "ko": "추가" } }
+        i18n.init(dict)
+    */
+    init(dict: _Dict): void;
+    toJSON(): {
+        language: Language;
+    };
+}
+export interface Hosts {
+}
+export interface Roots {
+}
+export type { _Dict, Item };
+export interface I18NBasic {
+    intl: boolean;
+    language: Language;
+}
+export default I18N;