@lingxiao-office/sdk 1.0.0

package/dist/utils/platform.d.ts

@@ -0,0 +1,137 @@
+/**
+ * platform.ts — Cross-platform utilities
+ *
+ * Centralizes platform detection and platform-aware command resolution.
+ * Use these helpers instead of hardcoding OS-specific paths or command names.
+ */
+import { spawnSync } from 'child_process';
+export declare const IS_WINDOWS: boolean;
+export declare const IS_MACOS: boolean;
+export declare const IS_LINUX: boolean;
+type ShellPlatform = NodeJS.Platform;
+type KillFn = typeof process.kill;
+type SpawnSyncFn = typeof spawnSync;
+interface PlatformProbeOptions {
+    platform?: ShellPlatform;
+    env?: NodeJS.ProcessEnv;
+    kill?: KillFn;
+    spawnSync?: SpawnSyncFn;
+}
+interface ProcessSignalOptions extends PlatformProbeOptions {
+    /**
+     * When true, Unix sends to the process group (-pid) first and falls back to
+     * the single pid. Windows maps this to taskkill /T.
+     */
+    tree?: boolean;
+}
+export declare function resolveShell(options?: {
+    platform?: ShellPlatform;
+    env?: NodeJS.ProcessEnv;
+}): {
+    executable: string;
+    args: string[];
+};
+export declare function hiddenSpawnOptsForPlatform(targetPlatform: ShellPlatform): {
+    windowsHide?: boolean;
+};
+/**
+ * Returns the appropriate shell executable and base args for the current platform.
+ *
+ * Windows shell selection (via LINGXIAO_SHELL env var):
+ *   - LINGXIAO_SHELL=pwsh        → pwsh.exe (PowerShell 7+, cross-platform)
+ *   - LINGXIAO_SHELL=powershell  → powershell.exe (Windows PowerShell 5.x)
+ *   - default                    → cmd.exe /d /s /c
+ *
+ * Unix shell selection:
+ *   - $SHELL env var if set, else /bin/sh (POSIX guaranteed everywhere)
+ *
+ * We use /bin/sh not /bin/bash on Unix because:
+ *   - /bin/sh is guaranteed by POSIX on every Unix/Linux/macOS/WSL
+ *   - /bin/bash may not exist on Alpine, Debian minimal, etc.
+ *   - If the user's $SHELL is set, we respect their preference
+ */
+export declare function getShell(): {
+    executable: string;
+    args: string[];
+};
+export declare function getShellCommand(command: string): {
+    executable: string;
+    args: string[];
+};
+export declare function supportsProcessSuspendResume(): boolean;
+/**
+ * Returns the shell executable only (for pty/spawn use cases).
+ */
+export declare function getShellExecutable(): string;
+/**
+ * Returns the Python executable for the current platform.
+ *
+ * Resolution order:
+ *   1. LINGXIAO_PYTHON env var (user override)
+ *   2. `python3` if it exists on PATH
+ *   3. `python` as fallback (Windows default, also works on Unix)
+ */
+export declare function getPythonExecutable(): string;
+/**
+ * Checks whether a command exists on PATH.
+ * Uses `where` on Windows, `command -v` via sh on Unix.
+ */
+export declare function commandExists(cmd: string, options?: PlatformProbeOptions): boolean;
+export declare function resolveCommandPath(cmd: string, options?: PlatformProbeOptions): string | undefined;
+/**
+ * Returns interactive shell args for the current platform.
+ *
+ * - cmd.exe → ['/d', '/s', '/c'] (no special interactive flag needed)
+ * - pwsh.exe / powershell.exe → ['-NoLogo', '-NoExit']
+ * - Unix shells (/bin/sh, /bin/bash, etc.) → ['--interactive']
+ */
+export declare function getInteractiveShellArgs(): string[];
+export declare function resolveInteractiveShell(options?: {
+    platform?: ShellPlatform;
+    env?: NodeJS.ProcessEnv;
+}): {
+    executable: string;
+    args: string[];
+};
+export declare function processExists(pid: number, options?: PlatformProbeOptions): boolean;
+export declare function sendProcessSignal(pid: number, signal?: NodeJS.Signals | 0, options?: ProcessSignalOptions): boolean;
+/**
+ * Cross-platform process termination.
+ *
+ * Windows: process.kill(pid, 'SIGKILL') maps to TerminateProcess in Node.js 22+.
+ *          ESRCH errors (process already gone) are silently ignored.
+ * Unix:    signal='SIGKILL' sends immediately.
+ *          signal='SIGTERM' sends without waiting.
+ *          Default (no signal): SIGTERM first, wait 3s grace, then SIGKILL.
+ */
+export declare function killProcess(pid: number, signal?: NodeJS.Signals, options?: {
+    tree?: boolean;
+    graceMs?: number;
+}): Promise<void>;
+/**
+ * Reads the absolute start time of a live process as epoch milliseconds, or
+ * `null` when it cannot be determined (process dead, platform lacks a probe,
+ * parse failure). Callers compare this against a previously-recorded start time
+ * to detect PID reuse: if the same PID now reports a different start time, a
+ * different process has taken the PID over.
+ *
+ *   Linux:   `/proc/<pid>/stat` field 22 (starttime, jiffies since boot) + btime.
+ *   macOS:   `ps -o lstart= -p <pid>` → parsed absolute timestamp.
+ *   Windows: PowerShell `(Get-Process -Id <pid>).StartTime` → epoch seconds.
+ *
+ * Spawning `ps`/`powershell` is acceptable here: the only callers are
+ * pid-registry pruning and orphan reaping, which fire a handful of times per
+ * process lifetime — never on a hot path.
+ */
+export declare function readProcessStartMs(pid: number, options?: PlatformProbeOptions): number | null;
+/** Reset the internal boot-time cache. Tests only. */
+export declare function _resetProcessStartTimeCacheForTest(): void;
+/**
+ * Returns spawn options with windowsHide to prevent console window flash.
+ * Merge with your existing spawn options.
+ */
+export declare function hiddenSpawnOpts(): {
+    windowsHide?: boolean;
+};
+export {};
+//# sourceMappingURL=platform.d.ts.map

package/dist/utils/platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../src/utils/platform.ts"],"names":[],"mappings":"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"}

package/dist/utils/platform.js

@@ -0,0 +1,374 @@
+/**
+ * platform.ts — Cross-platform utilities
+ *
+ * Centralizes platform detection and platform-aware command resolution.
+ * Use these helpers instead of hardcoding OS-specific paths or command names.
+ */
+import { platform } from 'os';
+import { spawnSync } from 'child_process';
+import { readFileSync } from 'fs';
+export const IS_WINDOWS = platform() === 'win32';
+export const IS_MACOS = platform() === 'darwin';
+export const IS_LINUX = platform() === 'linux';
+function errorCode(error) {
+    return typeof error === 'object' && error !== null && 'code' in error
+        ? String(error.code)
+        : undefined;
+}
+function isMissingProcessError(error) {
+    const code = errorCode(error);
+    return code === 'ESRCH';
+}
+function isPermissionError(error) {
+    const code = errorCode(error);
+    return code === 'EPERM' || code === 'EACCES';
+}
+function assertValidPid(pid) {
+    if (!Number.isInteger(pid) || pid <= 0) {
+        throw new Error(`Invalid pid: ${pid}`);
+    }
+}
+export function resolveShell(options) {
+    const currentPlatform = options?.platform ?? platform();
+    const env = options?.env ?? process.env;
+    if (currentPlatform === 'win32') {
+        const shellPref = (env.LINGXIAO_SHELL || '').toLowerCase().trim();
+        if (shellPref === 'pwsh') {
+            return { executable: 'pwsh.exe', args: ['-NoProfile', '-NonInteractive', '-Command'] };
+        }
+        if (shellPref === 'powershell') {
+            return { executable: 'powershell.exe', args: ['-NoProfile', '-NonInteractive', '-Command'] };
+        }
+        return { executable: 'cmd.exe', args: ['/d', '/s', '/c'] };
+    }
+    const shell = env.SHELL || '/bin/sh';
+    const base = shell === '/bin/sh' ? ['-c'] : ['-lc'];
+    return { executable: shell, args: base };
+}
+export function hiddenSpawnOptsForPlatform(targetPlatform) {
+    return targetPlatform === 'win32' ? { windowsHide: true } : {};
+}
+/**
+ * Returns the appropriate shell executable and base args for the current platform.
+ *
+ * Windows shell selection (via LINGXIAO_SHELL env var):
+ *   - LINGXIAO_SHELL=pwsh        → pwsh.exe (PowerShell 7+, cross-platform)
+ *   - LINGXIAO_SHELL=powershell  → powershell.exe (Windows PowerShell 5.x)
+ *   - default                    → cmd.exe /d /s /c
+ *
+ * Unix shell selection:
+ *   - $SHELL env var if set, else /bin/sh (POSIX guaranteed everywhere)
+ *
+ * We use /bin/sh not /bin/bash on Unix because:
+ *   - /bin/sh is guaranteed by POSIX on every Unix/Linux/macOS/WSL
+ *   - /bin/bash may not exist on Alpine, Debian minimal, etc.
+ *   - If the user's $SHELL is set, we respect their preference
+ */
+export function getShell() {
+    return resolveShell();
+}
+export function getShellCommand(command) {
+    const shell = getShell();
+    return { executable: shell.executable, args: [...shell.args, command] };
+}
+export function supportsProcessSuspendResume() {
+    return !IS_WINDOWS;
+}
+/**
+ * Returns the shell executable only (for pty/spawn use cases).
+ */
+export function getShellExecutable() {
+    return getShell().executable;
+}
+/**
+ * Returns the Python executable for the current platform.
+ *
+ * Resolution order:
+ *   1. LINGXIAO_PYTHON env var (user override)
+ *   2. `python3` if it exists on PATH
+ *   3. `python` as fallback (Windows default, also works on Unix)
+ */
+export function getPythonExecutable() {
+    if (process.env.LINGXIAO_PYTHON)
+        return process.env.LINGXIAO_PYTHON;
+    // Check python3 first (standard on Linux/macOS)
+    const p3 = spawnSync('python3', ['--version'], { encoding: 'utf8', timeout: 3000 });
+    if (p3.status === 0)
+        return 'python3';
+    // Fallback: python (Windows default, also available on some Unix)
+    return 'python';
+}
+/**
+ * Checks whether a command exists on PATH.
+ * Uses `where` on Windows, `command -v` via sh on Unix.
+ */
+export function commandExists(cmd, options) {
+    return resolveCommandPath(cmd, options) !== undefined;
+}
+export function resolveCommandPath(cmd, options) {
+    if (!/^[A-Za-z0-9._+/@:-]+$/.test(cmd))
+        return undefined;
+    const currentPlatform = options?.platform ?? platform();
+    const spawn = options?.spawnSync ?? spawnSync;
+    if (currentPlatform === 'win32') {
+        const r = spawn('where.exe', [cmd], {
+            encoding: 'utf8',
+            timeout: 5000,
+            windowsHide: true,
+            env: options?.env,
+        });
+        if (r.status !== 0)
+            return undefined;
+        return (r.stdout || '').split(/\r?\n/).map((line) => line.trim()).find(Boolean);
+    }
+    const r = spawn('sh', ['-c', 'command -v "$1"', 'sh', cmd], {
+        encoding: 'utf8',
+        timeout: 5000,
+        env: options?.env,
+    });
+    if (r.status !== 0)
+        return undefined;
+    return (r.stdout || '').trim() || undefined;
+}
+/**
+ * Returns interactive shell args for the current platform.
+ *
+ * - cmd.exe → ['/d', '/s', '/c'] (no special interactive flag needed)
+ * - pwsh.exe / powershell.exe → ['-NoLogo', '-NoExit']
+ * - Unix shells (/bin/sh, /bin/bash, etc.) → ['--interactive']
+ */
+export function getInteractiveShellArgs() {
+    return resolveInteractiveShell().args;
+}
+export function resolveInteractiveShell(options) {
+    const shell = resolveShell(options);
+    const { executable } = shell;
+    const lower = executable.toLowerCase();
+    if (lower.includes('cmd.exe')) {
+        return { executable, args: ['/d'] };
+    }
+    if (lower.includes('pwsh') || lower.includes('powershell')) {
+        return { executable, args: ['-NoLogo', '-NoExit'] };
+    }
+    return { executable, args: ['-i'] };
+}
+export function processExists(pid, options) {
+    if (!Number.isInteger(pid) || pid <= 0)
+        return false;
+    const currentPlatform = options?.platform ?? platform();
+    const kill = options?.kill ?? process.kill;
+    try {
+        kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        if (isPermissionError(error))
+            return true;
+        if (isMissingProcessError(error))
+            return false;
+        if (currentPlatform !== 'win32')
+            return false;
+    }
+    // Windows fallback for environments where process.kill(pid, 0) is less
+    // informative. tasklist is available on supported Windows hosts.
+    const spawn = options?.spawnSync ?? spawnSync;
+    const r = spawn('tasklist.exe', ['/FI', `PID eq ${pid}`, '/FO', 'CSV', '/NH'], {
+        encoding: 'utf8',
+        timeout: 5000,
+        windowsHide: true,
+        env: options?.env,
+    });
+    if (r.status !== 0)
+        return false;
+    return new RegExp(`,"${pid}",|,${pid},|^"[^"]+","${pid}",`).test(r.stdout || '');
+}
+export function sendProcessSignal(pid, signal = 'SIGTERM', options) {
+    assertValidPid(pid);
+    if (signal === 0) {
+        return processExists(pid, options);
+    }
+    const currentPlatform = options?.platform ?? platform();
+    const kill = options?.kill ?? process.kill;
+    if (currentPlatform === 'win32') {
+        const signalName = String(signal);
+        if (signalName === 'SIGTERM' || signalName === 'SIGKILL') {
+            const args = ['/PID', String(pid)];
+            if (options?.tree !== false)
+                args.push('/T');
+            if (signalName === 'SIGKILL')
+                args.push('/F');
+            const spawn = options?.spawnSync ?? spawnSync;
+            const result = spawn('taskkill.exe', args, {
+                encoding: 'utf8',
+                timeout: 10_000,
+                windowsHide: true,
+                env: options?.env,
+            });
+            if (result.status === 0)
+                return true;
+            try {
+                kill(pid, signalName === 'SIGTERM' ? 'SIGTERM' : 'SIGKILL');
+                return true;
+            }
+            catch (error) {
+                return isMissingProcessError(error);
+            }
+        }
+    }
+    const targets = options?.tree ? [-pid, pid] : [pid];
+    let sawPermission = false;
+    for (const target of targets) {
+        try {
+            kill(target, signal);
+            return true;
+        }
+        catch (error) {
+            if (isPermissionError(error))
+                sawPermission = true;
+            if (!isMissingProcessError(error) && !isPermissionError(error))
+                throw error;
+        }
+    }
+    return sawPermission;
+}
+/**
+ * Cross-platform process termination.
+ *
+ * Windows: process.kill(pid, 'SIGKILL') maps to TerminateProcess in Node.js 22+.
+ *          ESRCH errors (process already gone) are silently ignored.
+ * Unix:    signal='SIGKILL' sends immediately.
+ *          signal='SIGTERM' sends without waiting.
+ *          Default (no signal): SIGTERM first, wait 3s grace, then SIGKILL.
+ */
+export function killProcess(pid, signal, options) {
+    return new Promise((resolve) => {
+        try {
+            assertValidPid(pid);
+        }
+        catch { /* swallowed: unhandled error */
+            resolve();
+            return;
+        }
+        if (signal) {
+            sendProcessSignal(pid, signal, { tree: options?.tree });
+            resolve();
+            return;
+        }
+        sendProcessSignal(pid, 'SIGTERM', { tree: options?.tree });
+        setTimeout(() => {
+            try {
+                sendProcessSignal(pid, 'SIGKILL', { tree: options?.tree });
+            }
+            catch { /* process may already be gone */ }
+            resolve();
+        }, options?.graceMs ?? 3000);
+    });
+}
+/**
+ * Reads the absolute start time of a live process as epoch milliseconds, or
+ * `null` when it cannot be determined (process dead, platform lacks a probe,
+ * parse failure). Callers compare this against a previously-recorded start time
+ * to detect PID reuse: if the same PID now reports a different start time, a
+ * different process has taken the PID over.
+ *
+ *   Linux:   `/proc/<pid>/stat` field 22 (starttime, jiffies since boot) + btime.
+ *   macOS:   `ps -o lstart= -p <pid>` → parsed absolute timestamp.
+ *   Windows: PowerShell `(Get-Process -Id <pid>).StartTime` → epoch seconds.
+ *
+ * Spawning `ps`/`powershell` is acceptable here: the only callers are
+ * pid-registry pruning and orphan reaping, which fire a handful of times per
+ * process lifetime — never on a hot path.
+ */
+export function readProcessStartMs(pid, options) {
+    if (!Number.isInteger(pid) || pid <= 0)
+        return null;
+    const currentPlatform = options?.platform ?? platform();
+    const run = options?.spawnSync ?? spawnSync;
+    if (currentPlatform === 'linux')
+        return readLinuxProcStartMs(pid);
+    if (currentPlatform === 'darwin')
+        return readMacProcStartMs(pid, run);
+    if (currentPlatform === 'win32')
+        return readWindowsProcStartMs(pid, run, options?.env);
+    return null;
+}
+// Linux boot time (seconds) read once from /proc/stat; constant for a boot.
+let _linuxBtimeSec = undefined; // undefined = unread, null = read failed
+function readLinuxBootTimeSec() {
+    if (_linuxBtimeSec !== undefined)
+        return _linuxBtimeSec;
+    try {
+        const stat = readFileSync('/proc/stat', 'utf-8');
+        const m = stat.match(/^btime\s+(\d+)/m);
+        _linuxBtimeSec = m ? Number(m[1]) : null;
+    }
+    catch {
+        _linuxBtimeSec = null;
+    }
+    return _linuxBtimeSec;
+}
+// Linux CLK_TCK (jiffies/sec). Node has no sysconf binding; virtually every
+// production kernel is 100 Hz, and the 5s comparison tolerance absorbs drift.
+const LINUX_CLK_TCK = 100;
+function readLinuxProcStartMs(pid) {
+    try {
+        const raw = readFileSync(`/proc/${pid}/stat`, 'utf-8');
+        // `comm` may contain spaces and parens — slice after the LAST ')' so field
+        // counting is stable. starttime is field 22 → tail index 19.
+        const rparen = raw.lastIndexOf(')');
+        if (rparen < 0)
+            return null;
+        const tail = raw.slice(rparen + 2).split(' ');
+        const starttimeJiffies = Number(tail[19]);
+        if (!Number.isFinite(starttimeJiffies))
+            return null;
+        const btimeSec = readLinuxBootTimeSec();
+        if (btimeSec === null)
+            return null;
+        return (btimeSec + starttimeJiffies / LINUX_CLK_TCK) * 1000;
+    }
+    catch {
+        return null;
+    }
+}
+function readMacProcStartMs(pid, run) {
+    try {
+        const r = run('ps', ['-o', 'lstart=', '-p', String(pid)], { encoding: 'utf8', timeout: 5000 });
+        const out = (r.stdout || '').trim();
+        if (!out)
+            return null;
+        const ms = Date.parse(out);
+        return Number.isFinite(ms) ? ms : null;
+    }
+    catch {
+        return null;
+    }
+}
+function readWindowsProcStartMs(pid, run, env) {
+    try {
+        // Get-Date -UFormat %s emits unix epoch seconds (UTC) for the piped StartTime.
+        // powershell.exe ships on every supported Windows; wmic was removed in Win11.
+        const r = run('powershell.exe', ['-NoProfile', '-NonInteractive', '-Command',
+            `(Get-Process -Id ${pid} -ErrorAction SilentlyContinue).StartTime | Get-Date -UFormat %s`], { encoding: 'utf8', timeout: 5000, windowsHide: true, env });
+        const out = (r.stdout || '').trim();
+        if (!out)
+            return null;
+        const ms = Math.round(Number(out) * 1000);
+        return Number.isFinite(ms) ? ms : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Reset the internal boot-time cache. Tests only. */
+export function _resetProcessStartTimeCacheForTest() {
+    _linuxBtimeSec = undefined;
+}
+/**
+ * Returns spawn options with windowsHide to prevent console window flash.
+ * Merge with your existing spawn options.
+ */
+export function hiddenSpawnOpts() {
+    return hiddenSpawnOptsForPlatform(platform());
+}
+//# sourceMappingURL=platform.js.map

package/dist/utils/platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.js","sourceRoot":"","sources":["../../src/utils/platform.ts"],"names":[],"mappings":"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"}

package/dist/utils/sleep.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 异步 sleep 工具：避免每个调用方各自写 `new Promise(r => setTimeout(r, ms))`。
+ *
+ * 注意：底层 timer 默认会保活事件循环，长 idle 进程不需要这种行为时调用方应自行 unref。
+ * 此处不在 utils 里隐式 unref —— 让调用方按场景决定。
+ */
+export declare const sleep: (ms: number) => Promise<void>;
+//# sourceMappingURL=sleep.d.ts.map

package/dist/utils/sleep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.d.ts","sourceRoot":"","sources":["../../src/utils/sleep.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,KAAK,GAAI,IAAI,MAAM,KAAG,OAAO,CAAC,IAAI,CAG3C,CAAC"}

package/dist/utils/sleep.js

@@ -0,0 +1,10 @@
+/**
+ * 异步 sleep 工具：避免每个调用方各自写 `new Promise(r => setTimeout(r, ms))`。
+ *
+ * 注意：底层 timer 默认会保活事件循环，长 idle 进程不需要这种行为时调用方应自行 unref。
+ * 此处不在 utils 里隐式 unref —— 让调用方按场景决定。
+ */
+export const sleep = (ms) => new Promise((resolve) => {
+    setTimeout(resolve, ms);
+});
+//# sourceMappingURL=sleep.js.map

package/dist/utils/sleep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.js","sourceRoot":"","sources":["../../src/utils/sleep.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,EAAU,EAAiB,EAAE,CACjD,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;IAC5B,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAC1B,CAAC,CAAC,CAAC"}

package/dist/utils/textTable.d.ts

@@ -0,0 +1,27 @@
+/**
+ * textTable — 宽字符感知的等宽文本表格。
+ *
+ * 终端按「显示列宽」对齐，而中文/全角字符占 2 列、emoji 占 2 列。
+ * 手工 `str.padEnd(n)` 用的是字符数,遇到中文就会错位。本模块用 string-width
+ * 计算真实显示宽度来 pad,保证列对齐。用于 /stats /logs /traces 等文本报告。
+ */
+export interface TableColumn {
+    /** 列标题 */
+    header: string;
+    /** 列最大宽度（显示列），超出截断加 … */
+    width: number;
+    /** 对齐方式，默认左对齐 */
+    align?: 'left' | 'right';
+}
+/** 按显示宽度截断字符串到 maxWidth（含 … 标记） */
+export declare function truncateToWidth(text: string, maxWidth: number): string;
+/** 按显示宽度 pad 到 targetWidth（不足补空格，超出截断） */
+export declare function padToWidth(text: string, targetWidth: number, align?: 'left' | 'right'): string;
+/** 渲染一行（按列定义 pad + 对齐），列间以 1 空格分隔 */
+export declare function renderRow(cells: string[], columns: TableColumn[], gap?: number): string;
+/**
+ * 渲染完整表格（表头 + 数据行）。
+ * @param indent 每行前缀缩进（空格数）
+ */
+export declare function renderTable(columns: TableColumn[], rows: string[][], indent?: number): string[];
+//# sourceMappingURL=textTable.d.ts.map

package/dist/utils/textTable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"textTable.d.ts","sourceRoot":"","sources":["../../src/utils/textTable.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,WAAW,WAAW;IAC1B,UAAU;IACV,MAAM,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB;IACjB,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED,mCAAmC;AACnC,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAatE;AAED,0CAA0C;AAC1C,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,GAAG,OAAgB,GAAG,MAAM,CAKtG;AAED,qCAAqC;AACrC,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,GAAG,SAAI,GAAG,MAAM,CAMlF;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,SAAI,GAAG,MAAM,EAAE,CAQ1F"}

package/dist/utils/textTable.js

@@ -0,0 +1,55 @@
+/**
+ * textTable — 宽字符感知的等宽文本表格。
+ *
+ * 终端按「显示列宽」对齐，而中文/全角字符占 2 列、emoji 占 2 列。
+ * 手工 `str.padEnd(n)` 用的是字符数,遇到中文就会错位。本模块用 string-width
+ * 计算真实显示宽度来 pad,保证列对齐。用于 /stats /logs /traces 等文本报告。
+ */
+import stringWidth from 'string-width';
+/** 按显示宽度截断字符串到 maxWidth（含 … 标记） */
+export function truncateToWidth(text, maxWidth) {
+    if (maxWidth <= 0)
+        return '';
+    if (stringWidth(text) <= maxWidth)
+        return text;
+    // 逐字符累加直到放不下，预留 1 列给 …
+    let out = '';
+    let w = 0;
+    for (const ch of text) {
+        const cw = stringWidth(ch);
+        if (w + cw > maxWidth - 1)
+            break;
+        out += ch;
+        w += cw;
+    }
+    return out + '…';
+}
+/** 按显示宽度 pad 到 targetWidth（不足补空格，超出截断） */
+export function padToWidth(text, targetWidth, align = 'left') {
+    const truncated = truncateToWidth(text, targetWidth);
+    const pad = Math.max(0, targetWidth - stringWidth(truncated));
+    const spaces = ' '.repeat(pad);
+    return align === 'right' ? spaces + truncated : truncated + spaces;
+}
+/** 渲染一行（按列定义 pad + 对齐），列间以 1 空格分隔 */
+export function renderRow(cells, columns, gap = 1) {
+    const sep = ' '.repeat(gap);
+    return columns
+        .map((col, i) => padToWidth(cells[i] ?? '', col.width, col.align))
+        .join(sep)
+        .replace(/\s+$/, ''); // 去尾随空格,终端更干净
+}
+/**
+ * 渲染完整表格（表头 + 数据行）。
+ * @param indent 每行前缀缩进（空格数）
+ */
+export function renderTable(columns, rows, indent = 2) {
+    const pad = ' '.repeat(indent);
+    const lines = [];
+    lines.push(pad + renderRow(columns.map((c) => c.header), columns));
+    for (const row of rows) {
+        lines.push(pad + renderRow(row, columns));
+    }
+    return lines;
+}
+//# sourceMappingURL=textTable.js.map

package/dist/utils/textTable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"textTable.js","sourceRoot":"","sources":["../../src/utils/textTable.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,WAAW,MAAM,cAAc,CAAC;AAWvC,mCAAmC;AACnC,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,QAAgB;IAC5D,IAAI,QAAQ,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IAC7B,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC/C,uBAAuB;IACvB,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,KAAK,MAAM,EAAE,IAAI,IAAI,EAAE,CAAC;QACtB,MAAM,EAAE,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC;QAC3B,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,GAAG,CAAC;YAAE,MAAM;QACjC,GAAG,IAAI,EAAE,CAAC;QACV,CAAC,IAAI,EAAE,CAAC;IACV,CAAC;IACD,OAAO,GAAG,GAAG,GAAG,CAAC;AACnB,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,WAAmB,EAAE,QAA0B,MAAM;IAC5F,MAAM,SAAS,GAAG,eAAe,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACrD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC;IAC9D,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC/B,OAAO,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,SAAS,GAAG,MAAM,CAAC;AACrE,CAAC;AAED,qCAAqC;AACrC,MAAM,UAAU,SAAS,CAAC,KAAe,EAAE,OAAsB,EAAE,GAAG,GAAG,CAAC;IACxE,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC5B,OAAO,OAAO;SACX,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;SACjE,IAAI,CAAC,GAAG,CAAC;SACT,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc;AACxC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,OAAsB,EAAE,IAAgB,EAAE,MAAM,GAAG,CAAC;IAC9E,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC/B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IACnE,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,SAAS,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}