@serveryyswys/node.operit 0.0.0-stage → 0.1.2

package/dist/lib/inflate.js

@@ -0,0 +1,284 @@
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.inflateRaw = inflateRaw;
+exports.crc32 = crc32;
+exports.adler32 = adler32;
+/**
+ * 纯 JS 的 DEFLATE 解压（RFC 1951），以及 zlib / gzip 的包装层校验和。
+ *
+ * 为什么自己实现：运行时注入的 pako 只是 1.5KB 的 shim，只支持
+ * inflate(base64String, { to: 'string' })，既不解字节流也不支持 raw/zlib/gzip 区分。
+ *
+ * 正确性由 test/zlib.test.js 双向对拍保证：
+ *   Node 压的我们能解，我们解出的与原文逐字节相同。
+ */
+const LENGTH_BASE = [
+    3, 4, 5, 6, 7, 8, 9, 10, 11, 13, 15, 17, 19, 23, 27, 31,
+    35, 43, 51, 59, 67, 83, 99, 115, 131, 163, 195, 227, 258
+];
+const LENGTH_EXTRA = [
+    0, 0, 0, 0, 0, 0, 0, 0, 1, 1, 1, 1, 2, 2, 2, 2,
+    3, 3, 3, 3, 4, 4, 4, 4, 5, 5, 5, 5, 0
+];
+const DISTANCE_BASE = [
+    1, 2, 3, 4, 5, 7, 9, 13, 17, 25, 33, 49, 65, 97, 129, 193,
+    257, 385, 513, 769, 1025, 1537, 2049, 3073, 4097, 6145, 8193, 12289, 16385, 24577
+];
+const DISTANCE_EXTRA = [
+    0, 0, 0, 0, 1, 1, 2, 2, 3, 3, 4, 4, 5, 5, 6, 6,
+    7, 7, 8, 8, 9, 9, 10, 10, 11, 11, 12, 12, 13, 13
+];
+/** 动态 Huffman 头里"码长码长"的读取顺序。 */
+const CODE_LENGTH_ORDER = [16, 17, 18, 0, 8, 7, 9, 6, 10, 5, 11, 4, 12, 3, 13, 2, 14, 1, 15];
+function makeReader(data, start, end) {
+    return { data: data, position: start, end: end, bits: 0, bitCount: 0 };
+}
+function readBits(reader, count) {
+    let value = reader.bits;
+    while (reader.bitCount < count) {
+        if (reader.position >= reader.end) {
+            throw new Error('unexpected end of deflate stream');
+        }
+        value |= reader.data[reader.position] << reader.bitCount;
+        reader.position += 1;
+        reader.bitCount += 8;
+    }
+    reader.bits = value >>> count;
+    reader.bitCount -= count;
+    return value & ((1 << count) - 1);
+}
+function alignToByte(reader) {
+    reader.bits = 0;
+    reader.bitCount = 0;
+}
+function readByteAligned(reader) {
+    if (reader.position >= reader.end) {
+        throw new Error('unexpected end of deflate stream');
+    }
+    const value = reader.data[reader.position];
+    reader.position += 1;
+    return value;
+}
+/**
+ * 从码长建规范 Huffman 表。解码用 puff 的 counts/symbols 布局，
+ * 逐位左移即可自动处理"码本身按 MSB 优先"的位序。
+ */
+function buildTable(lengths, count) {
+    const counts = new Int32Array(16);
+    for (let i = 0; i < count; i += 1) {
+        counts[lengths[i]] += 1;
+    }
+    if (counts[0] === count) {
+        // 全零码长：只有一种符号，按 DEFLATE 规定等价于 0 位编码
+        return { counts: counts, symbols: new Int32Array(0) };
+    }
+    counts[0] = 0;
+    const offsets = new Int32Array(16);
+    for (let i = 1; i < 16; i += 1) {
+        offsets[i] = offsets[i - 1] + counts[i - 1];
+    }
+    const symbols = new Int32Array(count);
+    for (let i = 0; i < count; i += 1) {
+        if (lengths[i] !== 0) {
+            symbols[offsets[lengths[i]]] = i;
+            offsets[lengths[i]] += 1;
+        }
+    }
+    return { counts: counts, symbols: symbols };
+}
+function decodeSymbol(reader, table) {
+    let code = 0;
+    let first = 0;
+    let index = 0;
+    for (let length = 1; length <= 15; length += 1) {
+        code |= readBits(reader, 1);
+        const count = table.counts[length];
+        if (code - first < count) {
+            return table.symbols[index + (code - first)];
+        }
+        index += count;
+        first = (first + count) << 1;
+        code <<= 1;
+    }
+    throw new Error('invalid huffman code');
+}
+let FIXED_LITERAL = null;
+let FIXED_DISTANCE = null;
+function fixedTables() {
+    if (FIXED_LITERAL === null || FIXED_DISTANCE === null) {
+        const literalLengths = new Int32Array(288);
+        for (let i = 0; i < 144; i += 1) {
+            literalLengths[i] = 8;
+        }
+        for (let i = 144; i < 256; i += 1) {
+            literalLengths[i] = 9;
+        }
+        for (let i = 256; i < 280; i += 1) {
+            literalLengths[i] = 7;
+        }
+        for (let i = 280; i < 288; i += 1) {
+            literalLengths[i] = 8;
+        }
+        const distanceLengths = new Int32Array(30);
+        for (let i = 0; i < 30; i += 1) {
+            distanceLengths[i] = 5;
+        }
+        FIXED_LITERAL = buildTable(literalLengths, 288);
+        FIXED_DISTANCE = buildTable(distanceLengths, 30);
+    }
+    return { literal: FIXED_LITERAL, distance: FIXED_DISTANCE };
+}
+function ensureCapacity(output, extra) {
+    if (output.length + extra <= output.bytes.length) {
+        return;
+    }
+    let size = output.bytes.length === 0 ? Math.max(64, extra) : output.bytes.length;
+    while (size < output.length + extra) {
+        size *= 2;
+    }
+    const grown = new Uint8Array(size);
+    grown.set(output.bytes.subarray(0, output.length));
+    output.bytes = grown;
+}
+function inflateBlockData(reader, output, literal, distance) {
+    for (;;) {
+        const symbol = decodeSymbol(reader, literal);
+        if (symbol === 256) {
+            return;
+        }
+        if (symbol < 256) {
+            ensureCapacity(output, 1);
+            output.bytes[output.length] = symbol;
+            output.length += 1;
+            continue;
+        }
+        const lengthIndex = symbol - 257;
+        if (lengthIndex >= LENGTH_BASE.length) {
+            throw new Error('invalid length code');
+        }
+        const matchLength = LENGTH_BASE[lengthIndex] + readBits(reader, LENGTH_EXTRA[lengthIndex]);
+        const distanceSymbol = decodeSymbol(reader, distance);
+        if (distanceSymbol >= DISTANCE_BASE.length) {
+            throw new Error('invalid distance code');
+        }
+        const matchDistance = DISTANCE_BASE[distanceSymbol] + readBits(reader, DISTANCE_EXTRA[distanceSymbol]);
+        if (matchDistance > output.length) {
+            throw new Error('distance too far back');
+        }
+        ensureCapacity(output, matchLength);
+        let source = output.length - matchDistance;
+        for (let i = 0; i < matchLength; i += 1) {
+            output.bytes[output.length] = output.bytes[source];
+            output.length += 1;
+            source += 1;
+        }
+    }
+}
+function inflateDynamicTables(reader) {
+    const literalCount = readBits(reader, 5) + 257;
+    const distanceCount = readBits(reader, 5) + 1;
+    const codeLengthCount = readBits(reader, 4) + 4;
+    const codeLengths = new Int32Array(19);
+    for (let i = 0; i < codeLengthCount; i += 1) {
+        codeLengths[CODE_LENGTH_ORDER[i]] = readBits(reader, 3);
+    }
+    const codeLengthTable = buildTable(codeLengths, 19);
+    const lengths = new Int32Array(literalCount + distanceCount);
+    let index = 0;
+    while (index < lengths.length) {
+        const symbol = decodeSymbol(reader, codeLengthTable);
+        if (symbol < 16) {
+            lengths[index] = symbol;
+            index += 1;
+        }
+        else if (symbol === 16) {
+            if (index === 0) {
+                throw new Error('repeat with no previous code length');
+            }
+            const previous = lengths[index - 1];
+            const repeat = readBits(reader, 2) + 3;
+            for (let i = 0; i < repeat; i += 1) {
+                lengths[index] = previous;
+                index += 1;
+            }
+        }
+        else if (symbol === 17) {
+            const repeat = readBits(reader, 3) + 3;
+            index += repeat;
+        }
+        else {
+            const repeat = readBits(reader, 7) + 11;
+            index += repeat;
+        }
+    }
+    const literal = buildTable(lengths.subarray(0, literalCount), literalCount);
+    const distance = buildTable(lengths.subarray(literalCount), distanceCount);
+    return { literal: literal, distance: distance };
+}
+/** 解压 raw DEFLATE 数据。 */
+function inflateRaw(data, start, end) {
+    const reader = makeReader(data, start, end);
+    const output = { bytes: new Uint8Array(Math.max(64, (end - start) * 4)), length: 0 };
+    const fixed = fixedTables();
+    for (;;) {
+        const isFinal = readBits(reader, 1);
+        const blockType = readBits(reader, 2);
+        if (blockType === 0) {
+            alignToByte(reader);
+            const length = readByteAligned(reader) | (readByteAligned(reader) << 8);
+            const inverted = readByteAligned(reader) | (readByteAligned(reader) << 8);
+            if ((length ^ 0xffff) !== inverted) {
+                throw new Error('stored block length mismatch');
+            }
+            ensureCapacity(output, length);
+            for (let i = 0; i < length; i += 1) {
+                output.bytes[output.length] = readByteAligned(reader);
+                output.length += 1;
+            }
+        }
+        else if (blockType === 1) {
+            inflateBlockData(reader, output, fixed.literal, fixed.distance);
+        }
+        else if (blockType === 2) {
+            const tables = inflateDynamicTables(reader);
+            inflateBlockData(reader, output, tables.literal, tables.distance);
+        }
+        else {
+            throw new Error('invalid deflate block type');
+        }
+        if (isFinal === 1) {
+            break;
+        }
+    }
+    return output.bytes.subarray(0, output.length);
+}
+// ------------------------------------------------------------------ 校验和
+const CRC_TABLE = (function buildCrcTable() {
+    const table = new Uint32Array(256);
+    for (let n = 0; n < 256; n += 1) {
+        let c = n;
+        for (let k = 0; k < 8; k += 1) {
+            c = (c & 1) !== 0 ? (0xedb88320 ^ (c >>> 1)) : (c >>> 1);
+        }
+        table[n] = c >>> 0;
+    }
+    return table;
+})();
+/** gzip 的 CRC-32（IEEE 802.3）。 */
+function crc32(data, start, end) {
+    let crc = 0xffffffff;
+    for (let i = start; i < end; i += 1) {
+        crc = CRC_TABLE[(crc ^ data[i]) & 0xff] ^ (crc >>> 8);
+    }
+    return (crc ^ 0xffffffff) >>> 0;
+}
+/** zlib 的 Adler-32。 */
+function adler32(data, start, end) {
+    let a = 1;
+    let b = 0;
+    for (let i = start; i < end; i += 1) {
+        a = (a + data[i]) % 65521;
+        b = (b + a) % 65521;
+    }
+    return ((b << 16) | a) >>> 0;
+}

package/dist/lib/path-types.d.ts

@@ -0,0 +1,37 @@
+/**
+ * path 模块的公开类型。
+ *
+ * 独立成文件的原因：path.ts 用 `export =` 导出模块本体，无法再导出类型；
+ * 类型放在这里既能让 index.ts 聚合时"能命名"，也能让消费者引用。
+ */
+export interface FormatInputPathObject {
+    root?: string;
+    dir?: string;
+    base?: string;
+    ext?: string;
+    name?: string;
+}
+export interface ParsedPath {
+    root: string;
+    dir: string;
+    base: string;
+    ext: string;
+    name: string;
+}
+export interface PathModule {
+    resolve(...paths: string[]): string;
+    normalize(path: string): string;
+    isAbsolute(path: string): boolean;
+    join(...paths: string[]): string;
+    relative(from: string, to: string): string;
+    toNamespacedPath(path: string): string;
+    dirname(path: string): string;
+    basename(path: string, ext?: string): string;
+    extname(path: string): string;
+    format(pathObject: FormatInputPathObject): string;
+    parse(path: string): ParsedPath;
+    sep: string;
+    delimiter: string;
+    win32: PathModule;
+    posix: PathModule;
+}

package/dist/lib/path-types.js

@@ -0,0 +1,2 @@
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/lib/paths.d.ts

@@ -0,0 +1,8 @@
+export declare function pluginConfigDir(packageId?: string): string;
+/** 当前包名：由 getPluginConfigDir('') 的返回路径反推。 */
+export declare function packageName(): string;
+export declare function downloadDir(): string;
+export declare function cleanOnExitDir(): string;
+export declare function appContext(): unknown;
+export declare function filesDir(): string;
+export declare function cacheDir(): string;

package/dist/lib/paths.js

@@ -0,0 +1,106 @@
+'use strict';
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pluginConfigDir = pluginConfigDir;
+exports.packageName = packageName;
+exports.downloadDir = downloadDir;
+exports.cleanOnExitDir = cleanOnExitDir;
+exports.appContext = appContext;
+exports.filesDir = filesDir;
+exports.cacheDir = cacheDir;
+/**
+ * 运行时路径根的来源。只使用 Operit 已经声明的全局与本库的 bridge 层。
+ *
+ * 公开面（Operit 的 types/index.d.ts 已声明）：
+ *   getPluginConfigDir(id) -> /sdcard/Download/Operit/plugins/<id>
+ *   OPERIT_DOWNLOAD_DIR / OPERIT_CLEAN_ON_EXIT_DIR
+ * 内部面（源码里真实存在、d.ts 未声明）：
+ *   getPluginConfigDir('') 会回落到当前 call 的包名 —— packageName() 依赖这一行为。
+ *   该依赖集中在本模块，若将来失效只需改这一处。
+ */
+const pathModule = require("../path");
+const bridge = __importStar(require("./bridge"));
+const errors_1 = require("./errors");
+function resolvePluginConfigDir(packageId) {
+    if (typeof getPluginConfigDir !== 'function') {
+        throw (0, errors_1.onjError)('ONJ_MISSING_HOST', '全局 getPluginConfigDir 不可用。');
+    }
+    const dir = getPluginConfigDir(packageId);
+    if (typeof dir !== 'string' || dir.length === 0) {
+        throw (0, errors_1.onjError)('ONJ_MISSING_HOST', 'getPluginConfigDir(' + (packageId.length > 0 ? packageId : '<当前包>') + ') 返回空。');
+    }
+    return dir;
+}
+function pluginConfigDir(packageId) {
+    return resolvePluginConfigDir(packageId === undefined ? '' : String(packageId));
+}
+let cachedPackageName = null;
+/** 当前包名：由 getPluginConfigDir('') 的返回路径反推。 */
+function packageName() {
+    if (cachedPackageName === null) {
+        cachedPackageName = pathModule.basename(pluginConfigDir());
+    }
+    return cachedPackageName;
+}
+function downloadDir() {
+    if (typeof OPERIT_DOWNLOAD_DIR === 'string' && OPERIT_DOWNLOAD_DIR.length > 0) {
+        return OPERIT_DOWNLOAD_DIR;
+    }
+    throw (0, errors_1.onjError)('ONJ_MISSING_HOST', '全局 OPERIT_DOWNLOAD_DIR 不可用。');
+}
+function cleanOnExitDir() {
+    if (typeof OPERIT_CLEAN_ON_EXIT_DIR === 'string' && OPERIT_CLEAN_ON_EXIT_DIR.length > 0) {
+        return OPERIT_CLEAN_ON_EXIT_DIR;
+    }
+    throw (0, errors_1.onjError)('ONJ_MISSING_HOST', '全局 OPERIT_CLEAN_ON_EXIT_DIR 不可用。');
+}
+function appContext() {
+    return bridge.getApplicationContext();
+}
+function contextDir(methodName) {
+    const context = bridge.getApplicationContext();
+    const dir = bridge.callInstance(context, methodName, []);
+    const absolute = bridge.callInstance(dir, 'getAbsolutePath', []);
+    if (typeof absolute !== 'string' || absolute.length === 0) {
+        throw (0, errors_1.onjError)('ONJ_BRIDGE_PROTOCOL', 'Context.' + methodName + '() 未返回可用路径。');
+    }
+    return absolute;
+}
+function filesDir() {
+    return contextDir('getFilesDir');
+}
+function cacheDir() {
+    return contextDir('getCacheDir');
+}

package/dist/lib/perf-hooks-types.d.ts

@@ -0,0 +1,18 @@
+/**
+ * perf_hooks 的公开类型。
+ *
+ * 独立成文件的原因与其他 types 文件相同：perf_hooks.ts 用 `export =` 导出模块本体，
+ * 无法再导出类型，而 index.ts 聚合时要求这些名字是"可命名"的。
+ */
+export interface PerformanceEntryLike {
+    name: string;
+    entryType: string;
+    startTime: number;
+    duration: number;
+    detail?: unknown;
+}
+export interface MeasureOptions {
+    start?: string | number;
+    end?: string | number;
+    detail?: unknown;
+}

package/dist/lib/perf-hooks-types.js

@@ -0,0 +1,2 @@
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/lib/process-driver.d.ts

@@ -0,0 +1,31 @@
+export interface ProcessRunOptions {
+    cwd?: string;
+    env?: Record<string, string>;
+}
+export interface ProcessRunResult {
+    pid: number;
+    status: number | null;
+    stdout: string;
+    stderr: string;
+}
+export interface ProcessDriver {
+    /** 按 argv 起进程并等待结束；输出按 UTF-8 解码成文本。 */
+    run(argv: readonly string[], options: ProcessRunOptions): ProcessRunResult;
+}
+/** 宿主注入点：桌面测试用，传 null 恢复为 Operit Java 驱动。 */
+export declare function setDriver(next: ProcessDriver | null): void;
+export declare function getDriver(): ProcessDriver;
+/**
+ * 基于 java.lang.ProcessBuilder 的驱动。
+ *
+ * 两处刻意的选择：
+ *   - argv 用 JS 数组直接传：bridge 的 convertArg 对 `wrapper.isArray` 与 Collection 目标
+ *     都能把 JS 数组转成 Java 数组 / List，因此不需要手工拼命令行字符串；
+ *   - 输出用 java.util.Scanner 读成 String：InputStream.readAllBytes() 是 Java 9，
+ *     在 Android 8~12 上不可用；Scanner 在所有 API 级别都在。
+ *     代价是输出按 UTF-8 解码，二进制输出会有损（已在 README 写明）。
+ *
+ * 已知限制：先读 stdout 再读 stderr，若子进程往 stderr 写超过管道缓冲（约 64KB）
+ * 会与我们的读取形成死锁。Node 用事件循环规避这一点，同步实现做不到。
+ */
+export declare function createJavaDriver(): ProcessDriver;

package/dist/lib/process-driver.js

@@ -0,0 +1,102 @@
+'use strict';
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setDriver = setDriver;
+exports.getDriver = getDriver;
+exports.createJavaDriver = createJavaDriver;
+/**
+ * child_process 的宿主驱动层：把「怎么起进程」与「Node 的 child_process 语义」分开。
+ * 与 fs-driver 同一套思路 —— 桌面测试可以注入基于 Node child_process 的驱动，
+ * 从而把 child_process.ts 的语义与 Node 对拍，Java 相关的假设只收敛在一处。
+ *
+ * 实现一律是**同步**的：Java bridge 只有同步通道，没有真异步。
+ */
+const bridge = __importStar(require("./bridge"));
+let driver = null;
+/** 宿主注入点：桌面测试用，传 null 恢复为 Operit Java 驱动。 */
+function setDriver(next) {
+    driver = next;
+}
+function getDriver() {
+    if (driver === null) {
+        driver = createJavaDriver();
+    }
+    return driver;
+}
+/**
+ * 基于 java.lang.ProcessBuilder 的驱动。
+ *
+ * 两处刻意的选择：
+ *   - argv 用 JS 数组直接传：bridge 的 convertArg 对 `wrapper.isArray` 与 Collection 目标
+ *     都能把 JS 数组转成 Java 数组 / List，因此不需要手工拼命令行字符串；
+ *   - 输出用 java.util.Scanner 读成 String：InputStream.readAllBytes() 是 Java 9，
+ *     在 Android 8~12 上不可用；Scanner 在所有 API 级别都在。
+ *     代价是输出按 UTF-8 解码，二进制输出会有损（已在 README 写明）。
+ *
+ * 已知限制：先读 stdout 再读 stderr，若子进程往 stderr 写超过管道缓冲（约 64KB）
+ * 会与我们的读取形成死锁。Node 用事件循环规避这一点，同步实现做不到。
+ */
+function createJavaDriver() {
+    function readAll(stream) {
+        const scanner = bridge.newInstance('java.util.Scanner', [stream, 'UTF-8']);
+        try {
+            if (!bridge.normalizeBoolean(bridge.callInstance(scanner, 'hasNext', []))) {
+                return '';
+            }
+            return String(bridge.callInstance(scanner, 'next', []));
+        }
+        finally {
+            bridge.callInstance(scanner, 'close', []);
+        }
+    }
+    return {
+        run(argv, options) {
+            const builder = bridge.newInstance('java.lang.ProcessBuilder', [argv.slice()]);
+            if (options.cwd !== undefined) {
+                bridge.callInstance(builder, 'directory', [bridge.newInstance('java.io.File', [options.cwd])]);
+            }
+            if (options.env !== undefined) {
+                const environment = bridge.callInstance(builder, 'environment', []);
+                bridge.callInstance(environment, 'putAll', [options.env]);
+            }
+            const process = bridge.callInstance(builder, 'start', []);
+            const stdout = readAll(bridge.callInstance(process, 'getInputStream', []));
+            const stderr = readAll(bridge.callInstance(process, 'getErrorStream', []));
+            const status = Number(bridge.callInstance(process, 'waitFor', []));
+            const pid = Number(bridge.callInstance(process, 'pid', [])) || 0;
+            return { pid: pid, status: status, stdout: stdout, stderr: stderr };
+        }
+    };
+}

package/dist/lib/punycode.d.ts

@@ -0,0 +1,8 @@
+/** 把一段 Unicode 字符串编成 punycode（不含 xn-- 前缀）。 */
+export declare function encode(input: string): string;
+/** 把 punycode（不含 xn-- 前缀）解回 Unicode 字符串。非法输入抛错。 */
+export declare function decode(input: string): string;
+/** 域名 -> ASCII（xn--）。纯 ASCII 输入原样返回（已小写化由调用方负责）。 */
+export declare function toASCII(domain: string): string;
+/** 域名 -> Unicode。xn-- 标签解回 Unicode，其余原样。 */
+export declare function toUnicode(domain: string): string;