@sfmc-bds/cli 0.1.0 → 0.2.0-beta.0

package/dist/index.js

@@ -1,43 +1,51 @@
-/**
- * sfmc/ public runtime surface (Stage J — minimum entry design)
- *
- * This is the clean API that downstream callers (future sfmc-cil commands,
- * external scripts, CI tooling) consume to manage the runtime stack
- * without re-implementing process lifecycle logic.
- *
- * Design:
- * - Single process tree. sfmc/ does not spawn itself recursively — it spawns
- *   the actual services (db-server, qq-bridge, bds-tools, BDS).
- * - `IS_SEA` / `ROOT` from runtime.ts describe the deployment shape so callers
- *   can adapt (path lookup, config dir).
- * - Service lifecycle goes through ServiceRegistry (start/stop/restart/status).
- * - Module manifest from db-server is exposed via `readModuleManifest()` so
- *   callers can show enabled modules + per-module state.
- *
- * Re-exports are deliberately thin: each item is a stable contract. Internal
- * helpers (LogLine buffers, child-process piping) are NOT re-exported.
- */
-export { ROOT, IS_SEA, spawnService, spawnServiceSync } from "./runtime.js";
-export { SERVICE_NAMES, refreshServices, startAll, stopAll, forceStopAll, serviceStatus, services, START_ORDER, } from "./services.js";
-export { pushLog, onLog, getAllLogs, getRecentLogs } from "./logs.js";
-/**
- * Reads the manifest emitted by the behavior pack build, if present.
- * Returns null when no manifest exists (e.g. behavior pack hasn't been built).
- */
-export async function readModuleManifest() {
-    const fs = await import("node:fs/promises");
-    const path = await import("node:path");
-    const { ROOT } = await import("./runtime.js");
-    const manifestPath = path.join(ROOT, "modules", "_manifests", "module-manifests.json");
-    try {
-        const text = await fs.readFile(manifestPath, "utf8");
-        return JSON.parse(text);
-    }
-    catch {
-        return null;
-    }
-}
-export { startRepl, HELP } from "./repl.js";
-export { runWizard } from "./wizard.js";
-export { cmdModuleList, cmdModuleInstall, cmdModuleUninstall, cmdModuleVerify, cmdModuleInfo } from "./module-commands.js";
-//# sourceMappingURL=index.js.map
+import { ROOT, isMonorepoLayout, isRuntimeInitialized, resolveServiceScript, resolveFetchModule, spawnService, spawnServiceSync } from "./runtime.js";
+import {
+  SERVICE_NAMES,
+  refreshServices,
+  startAll,
+  stopAll,
+  forceStopAll,
+  serviceStatus,
+  services,
+  START_ORDER
+} from "./services.js";
+import { pushLog, onLog, getAllLogs, getRecentLogs } from "./logs.js";
+import { startRepl, getHelp, HELP } from "./repl.js";
+import { t, getLocale, setLocale, initLocale } from "./i18n/index.js";
+import { runWizard } from "./wizard.js";
+import { cmdModuleList, cmdModuleInstall, cmdModuleUninstall, cmdModuleVerify, cmdModuleInfo } from "./module-commands.js";
+export {
+  HELP,
+  ROOT,
+  SERVICE_NAMES,
+  START_ORDER,
+  cmdModuleInfo,
+  cmdModuleInstall,
+  cmdModuleList,
+  cmdModuleUninstall,
+  cmdModuleVerify,
+  forceStopAll,
+  getAllLogs,
+  getHelp,
+  getLocale,
+  getRecentLogs,
+  initLocale,
+  isMonorepoLayout,
+  isRuntimeInitialized,
+  onLog,
+  pushLog,
+  refreshServices,
+  resolveFetchModule,
+  resolveServiceScript,
+  runWizard,
+  serviceStatus,
+  services,
+  setLocale,
+  spawnService,
+  spawnServiceSync,
+  startAll,
+  startRepl,
+  stopAll,
+  t
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1,7 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,gBAAgB,EAAkB,MAAM,cAAc,CAAC;AAE5F,OAAO,EACL,aAAa,EAGb,eAAe,EACf,QAAQ,EACR,OAAO,EACP,YAAY,EACZ,aAAa,EACb,QAAQ,EACR,WAAW,GACZ,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,aAAa,EAAkD,MAAM,WAAW,CAAC;AAEtH;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;IACvC,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,CAAC;IAC9C,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,uBAAuB,CAAC,CAAC;IACvF,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;QACrD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC"}
+{
+  "version": 3,
+  "sources": ["../src/index.ts"],
+  "sourcesContent": ["/**\n * sfmc/ public runtime surface (Stage J \u2014 minimum entry design)\n *\n * This is the clean API that downstream callers (CLI commands,\n * external scripts, CI tooling) consume to manage the runtime stack\n * without re-implementing process lifecycle logic.\n *\n * Design:\n * - Single process tree. sfmc/ does not spawn itself recursively \u2014 it spawns\n *   the actual services (db-server, qq-bridge, bds-tools, BDS).\n * - `ROOT` from runtime.ts describes the deployment root so callers\n *   can adapt (path lookup, config dir).\n * - Service lifecycle goes through ServiceRegistry (start/stop/restart/status).\n *\n * Re-exports are deliberately thin: each item is a stable contract. Internal\n * helpers (LogLine buffers, child-process piping) are NOT re-exported.\n */\n\nexport { ROOT, isMonorepoLayout, isRuntimeInitialized, resolveServiceScript, resolveFetchModule, spawnService, spawnServiceSync, type ServiceId } from \"./runtime.js\";\n\nexport {\n  SERVICE_NAMES,\n  type ServiceName,\n  type ServiceStatus,\n  refreshServices,\n  startAll,\n  stopAll,\n  forceStopAll,\n  serviceStatus,\n  services,\n  START_ORDER,\n} from \"./services.js\";\n\nexport { pushLog, onLog, getAllLogs, getRecentLogs, type UnifiedLog, type LogLevel, type LogSource } from \"./logs.js\";\n\nexport { startRepl, getHelp, HELP } from \"./repl.js\";\nexport { t, getLocale, setLocale, initLocale, type Locale } from \"./i18n/index.js\";\nexport { runWizard } from \"./wizard.js\";\nexport { cmdModuleList, cmdModuleInstall, cmdModuleUninstall, cmdModuleVerify, cmdModuleInfo } from \"./module-commands.js\";\n"],
+  "mappings": "AAkBA,SAAS,MAAM,kBAAkB,sBAAsB,sBAAsB,oBAAoB,cAAc,wBAAwC;AAEvJ;AAAA,EACE;AAAA,EAGA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP,SAAS,SAAS,OAAO,YAAY,qBAAqE;AAE1G,SAAS,WAAW,SAAS,YAAY;AACzC,SAAS,GAAG,WAAW,WAAW,kBAA+B;AACjE,SAAS,iBAAiB;AAC1B,SAAS,eAAe,kBAAkB,oBAAoB,iBAAiB,qBAAqB;",
+  "names": []
+}

package/dist/interactive-prompts.d.ts

@@ -0,0 +1,8 @@
+/** 与 init 向导一致：文本输入或系统文件夹选择器。 */
+export declare function pickDirectory(message: string, defaultDirectory: string): Promise<string>;
+/** Windows 文件夹选择器；非 Windows 或失败时返回 null。 */
+export declare function pickDirectoryDialog(title: string, defaultDirectory: string): string | null;
+export declare function ensureDirectory(directory: string): boolean;
+/** 将用户输入规范为绝对路径（兼容含 # 的 Windows 路径）。 */
+export declare function resolveUserPath(input: string, base?: string): string;
+//# sourceMappingURL=interactive-prompts.d.ts.map

package/dist/interactive-prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive-prompts.d.ts","sourceRoot":"","sources":["../src/interactive-prompts.ts"],"names":[],"mappings":"AAMA,iCAAiC;AACjC,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAa9F;AAED,4CAA4C;AAC5C,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAqB1F;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAO1D;AAED,wCAAwC;AACxC,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,SAAgB,GAAG,MAAM,CAE3E"}

package/dist/interactive-prompts.js

@@ -0,0 +1,57 @@
+import { isCancel, select, text } from "@clack/prompts";
+import { execFileSync } from "node:child_process";
+import fs from "node:fs";
+import path from "node:path";
+import { t } from "./i18n/index.js";
+async function pickDirectory(message, defaultDirectory) {
+  const method = await select({
+    message,
+    options: [
+      { value: "text", label: t("prompt.enterPath"), hint: defaultDirectory },
+      { value: "browse", label: t("prompt.browse"), hint: t("prompt.browseHint") }
+    ]
+  });
+  if (isCancel(method)) return defaultDirectory;
+  if (method === "browse") return pickDirectoryDialog(message, defaultDirectory) ?? defaultDirectory;
+  const selected = await text({ message, initialValue: defaultDirectory });
+  return isCancel(selected) || !selected ? defaultDirectory : selected;
+}
+function pickDirectoryDialog(title, defaultDirectory) {
+  if (process.platform !== "win32") return null;
+  const escape = (value) => value.replace(/'/g, "''");
+  const script = [
+    "Add-Type -AssemblyName System.Windows.Forms",
+    "$dialog = New-Object System.Windows.Forms.FolderBrowserDialog",
+    `$dialog.Description = '${escape(title)}'`,
+    `$dialog.SelectedPath = '${escape(defaultDirectory)}'`,
+    "if ($dialog.ShowDialog() -eq [System.Windows.Forms.DialogResult]::OK) { Write-Output $dialog.SelectedPath }"
+  ].join("; ");
+  try {
+    const output = execFileSync("powershell.exe", ["-NoProfile", "-STA", "-Command", script], {
+      encoding: "utf-8",
+      timeout: 3e4,
+      windowsHide: true
+    });
+    return output.trim() || null;
+  } catch {
+    return null;
+  }
+}
+function ensureDirectory(directory) {
+  try {
+    fs.mkdirSync(directory, { recursive: true });
+    return fs.statSync(directory).isDirectory();
+  } catch {
+    return false;
+  }
+}
+function resolveUserPath(input, base = process.cwd()) {
+  return path.resolve(base, input.trim());
+}
+export {
+  ensureDirectory,
+  pickDirectory,
+  pickDirectoryDialog,
+  resolveUserPath
+};
+//# sourceMappingURL=interactive-prompts.js.map

package/dist/interactive-prompts.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/interactive-prompts.ts"],
+  "sourcesContent": ["import { isCancel, select, text } from \"@clack/prompts\";\nimport { execFileSync } from \"node:child_process\";\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport { t } from \"./i18n/index.js\";\n\n/** \u4E0E init \u5411\u5BFC\u4E00\u81F4\uFF1A\u6587\u672C\u8F93\u5165\u6216\u7CFB\u7EDF\u6587\u4EF6\u5939\u9009\u62E9\u5668\u3002 */\nexport async function pickDirectory(message: string, defaultDirectory: string): Promise<string> {\n  const method = await select({\n    message,\n    options: [\n      { value: \"text\", label: t(\"prompt.enterPath\"), hint: defaultDirectory },\n      { value: \"browse\", label: t(\"prompt.browse\"), hint: t(\"prompt.browseHint\") },\n    ],\n  });\n  if (isCancel(method)) return defaultDirectory;\n  if (method === \"browse\") return pickDirectoryDialog(message, defaultDirectory) ?? defaultDirectory;\n\n  const selected = await text({ message, initialValue: defaultDirectory });\n  return isCancel(selected) || !selected ? defaultDirectory : selected;\n}\n\n/** Windows \u6587\u4EF6\u5939\u9009\u62E9\u5668\uFF1B\u975E Windows \u6216\u5931\u8D25\u65F6\u8FD4\u56DE null\u3002 */\nexport function pickDirectoryDialog(title: string, defaultDirectory: string): string | null {\n  if (process.platform !== \"win32\") return null;\n  const escape = (value: string): string => value.replace(/'/g, \"''\");\n  const script = [\n    \"Add-Type -AssemblyName System.Windows.Forms\",\n    \"$dialog = New-Object System.Windows.Forms.FolderBrowserDialog\",\n    `$dialog.Description = '${escape(title)}'`,\n    `$dialog.SelectedPath = '${escape(defaultDirectory)}'`,\n    \"if ($dialog.ShowDialog() -eq [System.Windows.Forms.DialogResult]::OK) { Write-Output $dialog.SelectedPath }\",\n  ].join(\"; \");\n\n  try {\n    const output = execFileSync(\"powershell.exe\", [\"-NoProfile\", \"-STA\", \"-Command\", script], {\n      encoding: \"utf-8\",\n      timeout: 30_000,\n      windowsHide: true,\n    });\n    return output.trim() || null;\n  } catch {\n    return null;\n  }\n}\n\nexport function ensureDirectory(directory: string): boolean {\n  try {\n    fs.mkdirSync(directory, { recursive: true });\n    return fs.statSync(directory).isDirectory();\n  } catch {\n    return false;\n  }\n}\n\n/** \u5C06\u7528\u6237\u8F93\u5165\u89C4\u8303\u4E3A\u7EDD\u5BF9\u8DEF\u5F84\uFF08\u517C\u5BB9\u542B # \u7684 Windows \u8DEF\u5F84\uFF09\u3002 */\nexport function resolveUserPath(input: string, base = process.cwd()): string {\n  return path.resolve(base, input.trim());\n}\n"],
+  "mappings": "AAAA,SAAS,UAAU,QAAQ,YAAY;AACvC,SAAS,oBAAoB;AAC7B,OAAO,QAAQ;AACf,OAAO,UAAU;AACjB,SAAS,SAAS;AAGlB,eAAsB,cAAc,SAAiB,kBAA2C;AAC9F,QAAM,SAAS,MAAM,OAAO;AAAA,IAC1B;AAAA,IACA,SAAS;AAAA,MACP,EAAE,OAAO,QAAQ,OAAO,EAAE,kBAAkB,GAAG,MAAM,iBAAiB;AAAA,MACtE,EAAE,OAAO,UAAU,OAAO,EAAE,eAAe,GAAG,MAAM,EAAE,mBAAmB,EAAE;AAAA,IAC7E;AAAA,EACF,CAAC;AACD,MAAI,SAAS,MAAM,EAAG,QAAO;AAC7B,MAAI,WAAW,SAAU,QAAO,oBAAoB,SAAS,gBAAgB,KAAK;AAElF,QAAM,WAAW,MAAM,KAAK,EAAE,SAAS,cAAc,iBAAiB,CAAC;AACvE,SAAO,SAAS,QAAQ,KAAK,CAAC,WAAW,mBAAmB;AAC9D;AAGO,SAAS,oBAAoB,OAAe,kBAAyC;AAC1F,MAAI,QAAQ,aAAa,QAAS,QAAO;AACzC,QAAM,SAAS,CAAC,UAA0B,MAAM,QAAQ,MAAM,IAAI;AAClE,QAAM,SAAS;AAAA,IACb;AAAA,IACA;AAAA,IACA,0BAA0B,OAAO,KAAK,CAAC;AAAA,IACvC,2BAA2B,OAAO,gBAAgB,CAAC;AAAA,IACnD;AAAA,EACF,EAAE,KAAK,IAAI;AAEX,MAAI;AACF,UAAM,SAAS,aAAa,kBAAkB,CAAC,cAAc,QAAQ,YAAY,MAAM,GAAG;AAAA,MACxF,UAAU;AAAA,MACV,SAAS;AAAA,MACT,aAAa;AAAA,IACf,CAAC;AACD,WAAO,OAAO,KAAK,KAAK;AAAA,EAC1B,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEO,SAAS,gBAAgB,WAA4B;AAC1D,MAAI;AACF,OAAG,UAAU,WAAW,EAAE,WAAW,KAAK,CAAC;AAC3C,WAAO,GAAG,SAAS,SAAS,EAAE,YAAY;AAAA,EAC5C,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAGO,SAAS,gBAAgB,OAAe,OAAO,QAAQ,IAAI,GAAW;AAC3E,SAAO,KAAK,QAAQ,MAAM,MAAM,KAAK,CAAC;AACxC;",
+  "names": []
+}

package/dist/locale-command.d.ts

@@ -0,0 +1,3 @@
+/** `sfmc locale [zh-CN|en]` — 查看或设置 CLI 语言并写入 runtime.json。 */
+export declare function cmdLocale(args: string[]): string;
+//# sourceMappingURL=locale-command.d.ts.map

package/dist/locale-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale-command.d.ts","sourceRoot":"","sources":["../src/locale-command.ts"],"names":[],"mappings":"AAIA,+DAA+D;AAC/D,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAWhD"}

package/dist/locale-command.js

@@ -0,0 +1,19 @@
+import { getLocale, normalizeLocale, persistLocale, t } from "./i18n/index.js";
+import { ROOT } from "./runtime.js";
+import { c } from "./theme.js";
+function cmdLocale(args) {
+  const raw = args[0];
+  if (!raw) {
+    return c.text(t("locale.current", { locale: getLocale() }));
+  }
+  const locale = normalizeLocale(raw);
+  if (!locale) {
+    return c.red(t("locale.invalid", { value: raw })) + "\n" + c.dim(t("locale.usage"));
+  }
+  persistLocale(ROOT, locale);
+  return c.green(t("locale.set", { locale }));
+}
+export {
+  cmdLocale
+};
+//# sourceMappingURL=locale-command.js.map

package/dist/locale-command.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/locale-command.ts"],
+  "sourcesContent": ["import { getLocale, normalizeLocale, persistLocale, t } from \"./i18n/index.js\";\nimport { ROOT } from \"./runtime.js\";\nimport { c } from \"./theme.js\";\n\n/** `sfmc locale [zh-CN|en]` \u2014 \u67E5\u770B\u6216\u8BBE\u7F6E CLI \u8BED\u8A00\u5E76\u5199\u5165 runtime.json\u3002 */\nexport function cmdLocale(args: string[]): string {\n  const raw = args[0];\n  if (!raw) {\n    return c.text(t(\"locale.current\", { locale: getLocale() }));\n  }\n  const locale = normalizeLocale(raw);\n  if (!locale) {\n    return c.red(t(\"locale.invalid\", { value: raw })) + \"\\n\" + c.dim(t(\"locale.usage\"));\n  }\n  persistLocale(ROOT, locale);\n  return c.green(t(\"locale.set\", { locale }));\n}\n"],
+  "mappings": "AAAA,SAAS,WAAW,iBAAiB,eAAe,SAAS;AAC7D,SAAS,YAAY;AACrB,SAAS,SAAS;AAGX,SAAS,UAAU,MAAwB;AAChD,QAAM,MAAM,KAAK,CAAC;AAClB,MAAI,CAAC,KAAK;AACR,WAAO,EAAE,KAAK,EAAE,kBAAkB,EAAE,QAAQ,UAAU,EAAE,CAAC,CAAC;AAAA,EAC5D;AACA,QAAM,SAAS,gBAAgB,GAAG;AAClC,MAAI,CAAC,QAAQ;AACX,WAAO,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,IAAI,CAAC,CAAC,IAAI,OAAO,EAAE,IAAI,EAAE,cAAc,CAAC;AAAA,EACpF;AACA,gBAAc,MAAM,MAAM;AAC1B,SAAO,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,CAAC,CAAC;AAC5C;",
+  "names": []
+}

package/dist/logs.d.ts

@@ -5,6 +5,11 @@
  * 保持向后兼容的 pushLog / onLog / getAllLogs / getRecentLogs API
  * (services.ts 捕获子进程 stdout 后调用 pushLog 汇聚到此)。
  *
+ * 落盘策略(与子进程自写文件分工,避免重复):
+ *   - db / qq / update → 子进程已写 `.sfmc/logs/{db,qq,bds-update}.log`,此处跳过
+ *   - bds / llbot → `.sfmc/logs/{bds,llbot}.log`(外部进程无自带 file sink)
+ *   - 其余(system / pack / …) → `.sfmc/logs/sfmc.log`
+ *
  * formatLog 保留 theme.ts (chalk) 配色,比共享包的纯 ANSI 版本视觉更丰富。
  */
 import { type LogEntry, type LogLevel as SharedLogLevel } from "@sfmc-bds/sdk/logs";
@@ -12,7 +17,7 @@ export type LogLevel = SharedLogLevel;
 export type LogSource = string;
 export interface UnifiedLog extends LogEntry {
 }
-/** 推送一条日志到内存缓冲 (services.ts 捕获子进程 stdout 后调用) */
+/** 推送一条日志到内存缓冲,并按策略落盘 */
 export declare function pushLog(text: string, source: LogSource, level: LogLevel): void;
 /** 订阅新日志事件,返回取消订阅函数 */
 export declare function onLog(fn: (log: UnifiedLog) => void): () => void;
@@ -22,14 +27,27 @@ export declare function getAllLogs(): UnifiedLog[];
 export declare function getRecentLogs(n: number, levels: LogLevel[], sources: LogSource[]): UnifiedLog[];
 /** 从原始文本推断日志级别 (委托共享包) */
 export declare function inferLevel(text: string): LogLevel;
+export interface SourceMeta {
+    value: string;
+    /** 显示名,尽量 8 宽对齐 */
+    name: string;
+    paint: (s: string) => string;
+}
+export declare const SOURCE_META: SourceMeta[];
+export declare function formatSourceTag(source: string): string;
 /** 格式化日志用于 REPL 展示 (用 theme.ts chalk 配色) */
 export declare function formatLog(l: UnifiedLog): string;
 /** 字符串在终端的可见宽度 (strip ANSI 后按 CJK 宽度累加) */
 export declare function visibleWidth(s: string): number;
 /**
- * 按终端可见宽度换行,后续行左侧缩进 indent 个空格。
- * 保留 ANSI 颜色码:换行时先 reset 避免缩进空格带色,新行恢复颜色状态。
- * 宽字符(CJK)按 2 列计算,避免中文行换行位置偏后。
+ * 日志前缀可见宽度(时间 + 源 + 级别 + 尾空格),供悬挂缩进对齐正文起点。
+ * 与 formatLog 拼接顺序保持一致。
+ */
+export declare function logPrefixWidth(l: UnifiedLog): number;
+/**
+ * 按终端可见宽度换行;显式 \\n 与软换行的后续行一律左侧缩进 indent 列。
+ * 保留 ANSI:换行时 reset,新行恢复当前颜色状态(可多层叠加)。
+ * 宽字符(CJK)按 2 列;cols 预留 1 列,避免 Windows Terminal 边界再软折到第 0 列。
  */
 export declare function wrapLogLine(s: string, indent: number): string;
 //# sourceMappingURL=logs.d.ts.map

package/dist/logs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../src/logs.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAGL,KAAK,QAAQ,EACb,KAAK,QAAQ,IAAI,cAAc,EAChC,MAAM,oBAAoB,CAAC;AAI5B,MAAM,MAAM,QAAQ,GAAG,cAAc,CAAC;AACtC,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAC/B,MAAM,WAAW,UAAW,SAAQ,QAAQ;CAAG;AAI/C,iDAAiD;AACjD,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,GAAG,IAAI,CAE9E;AAED,uBAAuB;AACvB,wBAAgB,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,GAAG,MAAM,IAAI,CAE/D;AAED,qBAAqB;AACrB,wBAAgB,UAAU,IAAI,UAAU,EAAE,CAEzC;AAED,oCAAoC;AACpC,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,UAAU,EAAE,CAE/F;AAED,0BAA0B;AAC1B,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAEjD;AAuCD,4CAA4C;AAC5C,wBAAgB,SAAS,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CAgC/C;AAmDD,2CAA2C;AAC3C,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAK9C;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAoC7D"}
+{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../src/logs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAML,KAAK,QAAQ,EACb,KAAK,QAAQ,IAAI,cAAc,EAChC,MAAM,oBAAoB,CAAC;AAK5B,MAAM,MAAM,QAAQ,GAAG,cAAc,CAAC;AACtC,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAC/B,MAAM,WAAW,UAAW,SAAQ,QAAQ;CAAG;AA+B/C,yBAAyB;AACzB,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,GAAG,IAAI,CAU9E;AAED,uBAAuB;AACvB,wBAAgB,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,GAAG,MAAM,IAAI,CAE/D;AAED,qBAAqB;AACrB,wBAAgB,UAAU,IAAI,UAAU,EAAE,CAEzC;AAED,oCAAoC;AACpC,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,UAAU,EAAE,CAE/F;AAED,0BAA0B;AAC1B,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAEjD;AAMD,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;CAC9B;AAED,eAAO,MAAM,WAAW,EAAE,UAAU,EASnC,CAAC;AAEF,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAItD;AAiCD,4CAA4C;AAC5C,wBAAgB,SAAS,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CAoB/C;AAuCD,2CAA2C;AAC3C,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAK9C;AAkBD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CAiBpD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAa7D"}