@sfmc-bds/cli 0.2.0-beta.5 → 0.2.0-beta.7

package/dist/argv-parse.d.ts

@@ -0,0 +1,13 @@
+export type ParsedArgv = {
+    packsMode: boolean;
+    /** 规范化后的位置参数（已去掉 -p/--packs） */
+    args: string[];
+};
+export declare function parseGlobalArgv(raw: string[]): ParsedArgv;
+/** packs 子命令短别名 */
+export declare function mapPacksSubAlias(sub: string | undefined): string | undefined;
+/** 是否为顶层模块短命令（install / uninstall / search …） */
+export declare function isModuleInstallShorthand(cmd: string | undefined): boolean;
+/** @deprecated 使用 resolveModuleTopShorthand；保留别名避免外部破坏 */
+export declare function resolveModuleShorthandSub(cmd: string | undefined): string | undefined;
+//# sourceMappingURL=argv-parse.d.ts.map

package/dist/argv-parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"argv-parse.d.ts","sourceRoot":"","sources":["../src/argv-parse.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,UAAU,GAAG;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,gCAAgC;IAChC,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,CAAC;AAIF,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,UAAU,CAWzD;AAED,mBAAmB;AACnB,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAI5E;AAED,iDAAiD;AACjD,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAEzE;AAED,0DAA0D;AAC1D,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAErF"}

package/dist/argv-parse.js

@@ -0,0 +1,32 @@
+import { resolveModuleTopShorthand } from "./command-surface.js";
+const PACKS_FLAGS = /* @__PURE__ */ new Set(["-p", "--packs"]);
+function parseGlobalArgv(raw) {
+  const args = [];
+  let packsMode = false;
+  for (const a of raw) {
+    if (PACKS_FLAGS.has(a)) {
+      packsMode = true;
+      continue;
+    }
+    args.push(a);
+  }
+  return { packsMode, args };
+}
+function mapPacksSubAlias(sub) {
+  if (!sub) return sub;
+  if (sub === "i") return "install";
+  return sub;
+}
+function isModuleInstallShorthand(cmd) {
+  return resolveModuleTopShorthand(cmd) !== void 0;
+}
+function resolveModuleShorthandSub(cmd) {
+  return resolveModuleTopShorthand(cmd);
+}
+export {
+  isModuleInstallShorthand,
+  mapPacksSubAlias,
+  parseGlobalArgv,
+  resolveModuleShorthandSub
+};
+//# sourceMappingURL=argv-parse.js.map

package/dist/argv-parse.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/argv-parse.ts"],
+  "sourcesContent": ["/**\n * argv-parse.ts \u2014 \u5916\u90E8 CLI \u5168\u5C40\u65D7\u6807\u4E0E\u77ED\u547D\u4EE4\u9884\u89E3\u6790\uFF08DRY\uFF09\n *\n * - `-p` / `--packs`\uFF1A\u8D44\u6E90\u5305\u4E0A\u4E0B\u6587\uFF08\u517C\u5BB9\uFF1B\u5E2E\u52A9\u4F18\u5148\u63A8\u8350 `sfmc packs <sub>`\uFF09\n * - \u9876\u5C42\u6A21\u5757\u77ED\u547D\u4EE4\uFF1A\u89C1 command-surface#MODULE_TOP_SHORTHAND / resolveModuleTopShorthand\n * - packs \u4E0A\u4E0B\u6587\u4E0B `i` \u2192 `install`\n */\nimport { resolveModuleTopShorthand } from \"./command-surface.js\";\n\nexport type ParsedArgv = {\n  packsMode: boolean;\n  /** \u89C4\u8303\u5316\u540E\u7684\u4F4D\u7F6E\u53C2\u6570\uFF08\u5DF2\u53BB\u6389 -p/--packs\uFF09 */\n  args: string[];\n};\n\nconst PACKS_FLAGS = new Set([\"-p\", \"--packs\"]);\n\nexport function parseGlobalArgv(raw: string[]): ParsedArgv {\n  const args: string[] = [];\n  let packsMode = false;\n  for (const a of raw) {\n    if (PACKS_FLAGS.has(a)) {\n      packsMode = true;\n      continue;\n    }\n    args.push(a);\n  }\n  return { packsMode, args };\n}\n\n/** packs \u5B50\u547D\u4EE4\u77ED\u522B\u540D */\nexport function mapPacksSubAlias(sub: string | undefined): string | undefined {\n  if (!sub) return sub;\n  if (sub === \"i\") return \"install\";\n  return sub;\n}\n\n/** \u662F\u5426\u4E3A\u9876\u5C42\u6A21\u5757\u77ED\u547D\u4EE4\uFF08install / uninstall / search \u2026\uFF09 */\nexport function isModuleInstallShorthand(cmd: string | undefined): boolean {\n  return resolveModuleTopShorthand(cmd) !== undefined;\n}\n\n/** @deprecated \u4F7F\u7528 resolveModuleTopShorthand\uFF1B\u4FDD\u7559\u522B\u540D\u907F\u514D\u5916\u90E8\u7834\u574F */\nexport function resolveModuleShorthandSub(cmd: string | undefined): string | undefined {\n  return resolveModuleTopShorthand(cmd);\n}\n"],
+  "mappings": "AAOA,SAAS,iCAAiC;AAQ1C,MAAM,cAAc,oBAAI,IAAI,CAAC,MAAM,SAAS,CAAC;AAEtC,SAAS,gBAAgB,KAA2B;AACzD,QAAM,OAAiB,CAAC;AACxB,MAAI,YAAY;AAChB,aAAW,KAAK,KAAK;AACnB,QAAI,YAAY,IAAI,CAAC,GAAG;AACtB,kBAAY;AACZ;AAAA,IACF;AACA,SAAK,KAAK,CAAC;AAAA,EACb;AACA,SAAO,EAAE,WAAW,KAAK;AAC3B;AAGO,SAAS,iBAAiB,KAA6C;AAC5E,MAAI,CAAC,IAAK,QAAO;AACjB,MAAI,QAAQ,IAAK,QAAO;AACxB,SAAO;AACT;AAGO,SAAS,yBAAyB,KAAkC;AACzE,SAAO,0BAA0B,GAAG,MAAM;AAC5C;AAGO,SAAS,0BAA0B,KAA6C;AACrF,SAAO,0BAA0B,GAAG;AACtC;",
+  "names": []
+}

package/dist/cli-gate.d.ts

@@ -0,0 +1,11 @@
+/**
+ * cli-gate.ts — 将 command-surface 拒绝原因格式化为用户文案（DRY）
+ */
+import { type CanRunFailReason, type CommandMode, type CommandSpec } from "./command-surface.js";
+export declare function formatGateFailure(reason: CanRunFailReason, hintCmd?: string): string;
+export declare function gateSpec(spec: CommandSpec | undefined, mode: CommandMode, hintCmd?: string): string | null;
+/** 顶层命令门禁；未知命令返回 null（由调用方报 unknown）。 */
+export declare function gateTopLevel(cmd: string | undefined, mode: CommandMode): string | null;
+export declare function gateModuleSub(sub: string | undefined, mode: CommandMode): string | null;
+export declare function gatePacksSub(sub: string | undefined, mode: CommandMode): string | null;
+//# sourceMappingURL=cli-gate.d.ts.map

package/dist/cli-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-gate.d.ts","sourceRoot":"","sources":["../src/cli-gate.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAML,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,WAAW,EACjB,MAAM,sBAAsB,CAAC;AAI9B,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAapF;AAED,wBAAgB,QAAQ,CACtB,IAAI,EAAE,WAAW,GAAG,SAAS,EAC7B,IAAI,EAAE,WAAW,EACjB,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,GAAG,IAAI,CAKf;AAED,yCAAyC;AACzC,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAItF;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAIvF;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAItF"}

package/dist/cli-gate.js

@@ -0,0 +1,48 @@
+import {
+  canRunCommand,
+  findModuleSubSpec,
+  findPacksSubSpec,
+  findTopLevelSpec,
+  isCliTty
+} from "./command-surface.js";
+import { t } from "./i18n/index.js";
+import { c } from "./theme.js";
+function formatGateFailure(reason, hintCmd) {
+  switch (reason) {
+    case "externalOnly":
+      return c.yellow(t("cli.externalOnly", { cmd: hintCmd ?? "" })) + "\n" + c.dim(t("cli.externalOnly.hint", { cmd: hintCmd || "\u2026" }));
+    case "replOnly":
+      return c.yellow(t("cli.replOnly", { cmd: hintCmd ?? "" })) + "\n" + c.dim(t("cli.replOnly.hint"));
+    case "needTty":
+      return c.yellow(t("cli.needTty", { cmd: hintCmd ?? "" }));
+  }
+}
+function gateSpec(spec, mode, hintCmd) {
+  if (!spec) return null;
+  const result = canRunCommand(spec, { mode, isTty: isCliTty() });
+  if (result.ok) return null;
+  return formatGateFailure(result.reason, hintCmd ?? spec.id);
+}
+function gateTopLevel(cmd, mode) {
+  const spec = findTopLevelSpec(cmd);
+  if (!spec) return null;
+  return gateSpec(spec, mode, cmd);
+}
+function gateModuleSub(sub, mode) {
+  const spec = findModuleSubSpec(sub);
+  if (!spec) return null;
+  return gateSpec(spec, mode, `module ${sub}`);
+}
+function gatePacksSub(sub, mode) {
+  const spec = findPacksSubSpec(sub);
+  if (!spec) return null;
+  return gateSpec(spec, mode, `packs ${sub}`);
+}
+export {
+  formatGateFailure,
+  gateModuleSub,
+  gatePacksSub,
+  gateSpec,
+  gateTopLevel
+};
+//# sourceMappingURL=cli-gate.js.map

package/dist/cli-gate.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/cli-gate.ts"],
+  "sourcesContent": ["/**\n * cli-gate.ts \u2014 \u5C06 command-surface \u62D2\u7EDD\u539F\u56E0\u683C\u5F0F\u5316\u4E3A\u7528\u6237\u6587\u6848\uFF08DRY\uFF09\n */\nimport {\n  canRunCommand,\n  findModuleSubSpec,\n  findPacksSubSpec,\n  findTopLevelSpec,\n  isCliTty,\n  type CanRunFailReason,\n  type CommandMode,\n  type CommandSpec,\n} from \"./command-surface.js\";\nimport { t } from \"./i18n/index.js\";\nimport { c } from \"./theme.js\";\n\nexport function formatGateFailure(reason: CanRunFailReason, hintCmd?: string): string {\n  switch (reason) {\n    case \"externalOnly\":\n      return (\n        c.yellow(t(\"cli.externalOnly\", { cmd: hintCmd ?? \"\" })) +\n        \"\\n\" +\n        c.dim(t(\"cli.externalOnly.hint\", { cmd: hintCmd || \"\u2026\" }))\n      );\n    case \"replOnly\":\n      return c.yellow(t(\"cli.replOnly\", { cmd: hintCmd ?? \"\" })) + \"\\n\" + c.dim(t(\"cli.replOnly.hint\"));\n    case \"needTty\":\n      return c.yellow(t(\"cli.needTty\", { cmd: hintCmd ?? \"\" }));\n  }\n}\n\nexport function gateSpec(\n  spec: CommandSpec | undefined,\n  mode: CommandMode,\n  hintCmd?: string\n): string | null {\n  if (!spec) return null;\n  const result = canRunCommand(spec, { mode, isTty: isCliTty() });\n  if (result.ok) return null;\n  return formatGateFailure(result.reason, hintCmd ?? spec.id);\n}\n\n/** \u9876\u5C42\u547D\u4EE4\u95E8\u7981\uFF1B\u672A\u77E5\u547D\u4EE4\u8FD4\u56DE null\uFF08\u7531\u8C03\u7528\u65B9\u62A5 unknown\uFF09\u3002 */\nexport function gateTopLevel(cmd: string | undefined, mode: CommandMode): string | null {\n  const spec = findTopLevelSpec(cmd);\n  if (!spec) return null;\n  return gateSpec(spec, mode, cmd);\n}\n\nexport function gateModuleSub(sub: string | undefined, mode: CommandMode): string | null {\n  const spec = findModuleSubSpec(sub);\n  if (!spec) return null;\n  return gateSpec(spec, mode, `module ${sub}`);\n}\n\nexport function gatePacksSub(sub: string | undefined, mode: CommandMode): string | null {\n  const spec = findPacksSubSpec(sub);\n  if (!spec) return null;\n  return gateSpec(spec, mode, `packs ${sub}`);\n}\n"],
+  "mappings": "AAGA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAIK;AACP,SAAS,SAAS;AAClB,SAAS,SAAS;AAEX,SAAS,kBAAkB,QAA0B,SAA0B;AACpF,UAAQ,QAAQ;AAAA,IACd,KAAK;AACH,aACE,EAAE,OAAO,EAAE,oBAAoB,EAAE,KAAK,WAAW,GAAG,CAAC,CAAC,IACtD,OACA,EAAE,IAAI,EAAE,yBAAyB,EAAE,KAAK,WAAW,SAAI,CAAC,CAAC;AAAA,IAE7D,KAAK;AACH,aAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,KAAK,WAAW,GAAG,CAAC,CAAC,IAAI,OAAO,EAAE,IAAI,EAAE,mBAAmB,CAAC;AAAA,IAClG,KAAK;AACH,aAAO,EAAE,OAAO,EAAE,eAAe,EAAE,KAAK,WAAW,GAAG,CAAC,CAAC;AAAA,EAC5D;AACF;AAEO,SAAS,SACd,MACA,MACA,SACe;AACf,MAAI,CAAC,KAAM,QAAO;AAClB,QAAM,SAAS,cAAc,MAAM,EAAE,MAAM,OAAO,SAAS,EAAE,CAAC;AAC9D,MAAI,OAAO,GAAI,QAAO;AACtB,SAAO,kBAAkB,OAAO,QAAQ,WAAW,KAAK,EAAE;AAC5D;AAGO,SAAS,aAAa,KAAyB,MAAkC;AACtF,QAAM,OAAO,iBAAiB,GAAG;AACjC,MAAI,CAAC,KAAM,QAAO;AAClB,SAAO,SAAS,MAAM,MAAM,GAAG;AACjC;AAEO,SAAS,cAAc,KAAyB,MAAkC;AACvF,QAAM,OAAO,kBAAkB,GAAG;AAClC,MAAI,CAAC,KAAM,QAAO;AAClB,SAAO,SAAS,MAAM,MAAM,UAAU,GAAG,EAAE;AAC7C;AAEO,SAAS,aAAa,KAAyB,MAAkC;AACtF,QAAM,OAAO,iBAAiB,GAAG;AACjC,MAAI,CAAC,KAAM,QAAO;AAClB,SAAO,SAAS,MAAM,MAAM,SAAS,GAAG,EAAE;AAC5C;",
+  "names": []
+}

package/dist/cmd-remote.d.ts

@@ -0,0 +1,13 @@
+export type CmdRemoteOptions = {
+    /**
+     * enroll 成功后是否挂起进程（外壳 `sfmc remote enroll` 守护）。
+     * REPL 内应为 false，只启动 agent 后返回。
+     */
+    daemonAfterEnroll?: boolean;
+};
+/**
+ * 执行 remote 子命令；返回要打印的文本。
+ * enroll+daemon 时本函数不返回（进程挂起）。
+ */
+export declare function cmdRemote(args: string[], opts?: CmdRemoteOptions): Promise<string>;
+//# sourceMappingURL=cmd-remote.d.ts.map

package/dist/cmd-remote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cmd-remote.d.ts","sourceRoot":"","sources":["../src/cmd-remote.ts"],"names":[],"mappings":"AAYA,MAAM,MAAM,gBAAgB,GAAG;IAC7B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B,CAAC;AAEF;;;GAGG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,GAAE,gBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CAyB5F"}

package/dist/cmd-remote.js

@@ -0,0 +1,38 @@
+import { t } from "./i18n/index.js";
+import {
+  disableRemoteAgent,
+  enrollRemoteAgent,
+  remoteStatus,
+  startRemoteAgent,
+  stopRemoteAgent
+} from "./remote-agent.js";
+async function cmdRemote(args, opts = {}) {
+  const [subcommand, ...remoteArgs] = args;
+  if (subcommand === "enroll" && remoteArgs[0] && remoteArgs[1]) {
+    const name = remoteArgs[2] ?? process.env.COMPUTERNAME ?? "sfmc-agent";
+    const agentId = await enrollRemoteAgent(remoteArgs[0], remoteArgs[1], name);
+    startRemoteAgent();
+    if (opts.daemonAfterEnroll) {
+      const exit = () => {
+        stopRemoteAgent();
+        process.exit(0);
+      };
+      process.once("SIGINT", exit);
+      process.once("SIGTERM", exit);
+      await new Promise(() => void 0);
+    }
+    return t("remote.enrolled", { id: agentId });
+  }
+  if (subcommand === "status") {
+    return JSON.stringify(remoteStatus(), null, 2);
+  }
+  if (subcommand === "disable") {
+    disableRemoteAgent();
+    return t("remote.disabled");
+  }
+  return t("remote.usage");
+}
+export {
+  cmdRemote
+};
+//# sourceMappingURL=cmd-remote.js.map

package/dist/cmd-remote.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/cmd-remote.ts"],
+  "sourcesContent": ["/**\n * cmd-remote.ts \u2014 remote \u5B50\u547D\u4EE4\u8C03\u5EA6\uFF08main / REPL \u5171\u7528\uFF0C\u907F\u514D\u4E24\u5904\u590D\u5236\uFF09\n */\nimport { t } from \"./i18n/index.js\";\nimport {\n  disableRemoteAgent,\n  enrollRemoteAgent,\n  remoteStatus,\n  startRemoteAgent,\n  stopRemoteAgent,\n} from \"./remote-agent.js\";\n\nexport type CmdRemoteOptions = {\n  /**\n   * enroll \u6210\u529F\u540E\u662F\u5426\u6302\u8D77\u8FDB\u7A0B\uFF08\u5916\u58F3 `sfmc remote enroll` \u5B88\u62A4\uFF09\u3002\n   * REPL \u5185\u5E94\u4E3A false\uFF0C\u53EA\u542F\u52A8 agent \u540E\u8FD4\u56DE\u3002\n   */\n  daemonAfterEnroll?: boolean;\n};\n\n/**\n * \u6267\u884C remote \u5B50\u547D\u4EE4\uFF1B\u8FD4\u56DE\u8981\u6253\u5370\u7684\u6587\u672C\u3002\n * enroll+daemon \u65F6\u672C\u51FD\u6570\u4E0D\u8FD4\u56DE\uFF08\u8FDB\u7A0B\u6302\u8D77\uFF09\u3002\n */\nexport async function cmdRemote(args: string[], opts: CmdRemoteOptions = {}): Promise<string> {\n  const [subcommand, ...remoteArgs] = args;\n  if (subcommand === \"enroll\" && remoteArgs[0] && remoteArgs[1]) {\n    const name = remoteArgs[2] ?? process.env.COMPUTERNAME ?? \"sfmc-agent\";\n    const agentId = await enrollRemoteAgent(remoteArgs[0]!, remoteArgs[1]!, name);\n    startRemoteAgent();\n    if (opts.daemonAfterEnroll) {\n      const exit = (): void => {\n        stopRemoteAgent();\n        process.exit(0);\n      };\n      process.once(\"SIGINT\", exit);\n      process.once(\"SIGTERM\", exit);\n      await new Promise(() => undefined);\n    }\n    return t(\"remote.enrolled\", { id: agentId });\n  }\n  if (subcommand === \"status\") {\n    return JSON.stringify(remoteStatus(), null, 2);\n  }\n  if (subcommand === \"disable\") {\n    disableRemoteAgent();\n    return t(\"remote.disabled\");\n  }\n  return t(\"remote.usage\");\n}\n"],
+  "mappings": "AAGA,SAAS,SAAS;AAClB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAcP,eAAsB,UAAU,MAAgB,OAAyB,CAAC,GAAoB;AAC5F,QAAM,CAAC,YAAY,GAAG,UAAU,IAAI;AACpC,MAAI,eAAe,YAAY,WAAW,CAAC,KAAK,WAAW,CAAC,GAAG;AAC7D,UAAM,OAAO,WAAW,CAAC,KAAK,QAAQ,IAAI,gBAAgB;AAC1D,UAAM,UAAU,MAAM,kBAAkB,WAAW,CAAC,GAAI,WAAW,CAAC,GAAI,IAAI;AAC5E,qBAAiB;AACjB,QAAI,KAAK,mBAAmB;AAC1B,YAAM,OAAO,MAAY;AACvB,wBAAgB;AAChB,gBAAQ,KAAK,CAAC;AAAA,MAChB;AACA,cAAQ,KAAK,UAAU,IAAI;AAC3B,cAAQ,KAAK,WAAW,IAAI;AAC5B,YAAM,IAAI,QAAQ,MAAM,MAAS;AAAA,IACnC;AACA,WAAO,EAAE,mBAAmB,EAAE,IAAI,QAAQ,CAAC;AAAA,EAC7C;AACA,MAAI,eAAe,UAAU;AAC3B,WAAO,KAAK,UAAU,aAAa,GAAG,MAAM,CAAC;AAAA,EAC/C;AACA,MAAI,eAAe,WAAW;AAC5B,uBAAmB;AACnB,WAAO,EAAE,iBAAiB;AAAA,EAC5B;AACA,SAAO,EAAE,cAAc;AACzB;",
+  "names": []
+}

package/dist/command-palette.d.ts

@@ -0,0 +1,61 @@
+import { type PaletteNode } from "./command-surface.js";
+/** 每列固定总宽（含左边条 + 正文 + 右侧 ›） */
+export declare const PANEL_WIDTH = 28;
+export type PaletteColumn = {
+    items: PaletteNode[];
+    selected: number;
+    scroll: number;
+};
+export type PaletteView = {
+    columns: PaletteColumn[];
+    /** 可导航列 = 最右列 */
+    active: number;
+    committed: string[];
+    partial: string;
+    trailingSpace: boolean;
+    /** 自由参数输入中：不展示面板 */
+    hidden: boolean;
+};
+export type SlashParse = {
+    committed: string[];
+    partial: string;
+    trailingSpace: boolean;
+};
+/** 解析 `/` 后的输入 */
+export declare function parseSlashLine(line: string): SlashParse;
+export declare function clipPad(s: string, width: number): string;
+/** 在 text 中找 query 的首次出现（忽略大小写；label 带 / 时也试去前缀） */
+export declare function findMatchRange(text: string, q: string): {
+    start: number;
+    end: number;
+} | null;
+/** 匹配权重：越大越靠前；无查询时保持原序（同分） */
+export declare function matchWeight(n: PaletteNode, q: string): number;
+/** 按权重稳定排序：匹配项置顶，不删除任何项 */
+export declare function rankItems(items: readonly PaletteNode[], q: string): PaletteNode[];
+export declare function clampPaletteSelection(selected: number, len: number): number;
+export declare function ensurePaletteScroll(selected: number, scroll: number, len: number): number;
+/**
+ * 命令路径是否已到末尾（无更多固定子参可选）→ 应关闭面板。
+ * 末尾 = 精确匹配到无 children 的节点，或已进入 freeArgs 正文。
+ */
+export declare function isCommandAtEnd(committed: string[], partial: string, trailingSpace: boolean): boolean;
+/**
+ * 仅由输入行推导列；列内始终保留全量项，partial 只调整排序权重。
+ * 子列出现条件：已提交上一参数（将要输入下一参数）。
+ */
+export declare function resolvePaletteView(line: string, sels: number[], scrolls: number[]): PaletteView;
+export declare function formatPaletteCascadeLines(view: PaletteView, indentCols: number): string[];
+export declare function activeNode(view: PaletteView): PaletteNode | undefined;
+/** 灰字：选中项相对当前半词的后缀 */
+export declare function paletteGhost(view: PaletteView): string;
+/**
+ * 回车写入选中项；有子参或自由参则补尾空格。
+ * 若行已是该叶节点完整内容 → submit。
+ */
+export declare function commitSelection(line: string, view: PaletteView): {
+    line: string;
+    submit: boolean;
+};
+export declare function promptSlashColumn(prompt: string): number;
+//# sourceMappingURL=command-palette.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"command-palette.d.ts","sourceRoot":"","sources":["../src/command-palette.ts"],"names":[],"mappings":"AAIA,OAAO,EAAoB,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAM1E,+BAA+B;AAC/B,eAAO,MAAM,WAAW,KAAK,CAAC;AAc9B,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,iBAAiB;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,OAAO,CAAC;IACvB,oBAAoB;IACpB,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,kBAAkB;AAClB,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAOvD;AAWD,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAQxD;AAED,oDAAoD;AACpD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAW7F;AAoGD,8BAA8B;AAC9B,wBAAgB,WAAW,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAiB7D;AAED,2BAA2B;AAC3B,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,WAAW,EAAE,CAMjF;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAK3E;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CASzF;AAuCD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,GAAG,OAAO,CAepG;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,WAAW,CA4D/F;AAkCD,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAmBzF;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,WAAW,GAAG,WAAW,GAAG,SAAS,CAKrE;AAED,sBAAsB;AACtB,wBAAgB,YAAY,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAUtD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAyBlG;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAExD"}

package/dist/command-palette.js

@@ -0,0 +1,352 @@
+import chalk from "chalk";
+import { listPaletteRoots } from "./command-surface.js";
+import { t } from "./i18n/index.js";
+import { visibleWidth } from "./logs.js";
+import { T } from "./theme.js";
+const PAGE = 10;
+const PANEL_WIDTH = 28;
+const PANEL_GAP = " ";
+const MARKER_W = 1;
+const CHEVRON_W = 1;
+const INNER_WIDTH = PANEL_WIDTH - MARKER_W - CHEVRON_W;
+const LEVEL_BG = [T.surface, T.panel, "#1a1d23", T.subtle];
+const LEVEL_SEL = [T.surfaceHi, "#4a5160", "#3a404c", "#5a6270"];
+const LEVEL_BG_DIM = ["#22252c", "#1a1d22", "#14161b", "#2e333c"];
+const LEVEL_SEL_DIM = ["#2a2e36", "#262a32", "#1e2228", "#343a44"];
+const MATCH_FG = T.cyan;
+function parseSlashLine(line) {
+  const body = line.startsWith("/") ? line.slice(1) : line;
+  const trailingSpace = body.length > 0 && /\s$/.test(body);
+  const raw = body.trim() ? body.trim().split(/\s+/) : [];
+  if (trailingSpace) return { committed: raw, partial: "", trailingSpace: true };
+  if (raw.length === 0) return { committed: [], partial: "", trailingSpace: false };
+  return { committed: raw.slice(0, -1), partial: raw[raw.length - 1], trailingSpace: false };
+}
+function descOf(n) {
+  if (!n.descKey) return "";
+  try {
+    return t(n.descKey);
+  } catch {
+    return "";
+  }
+}
+function clipPad(s, width) {
+  let out = "";
+  for (const ch of s) {
+    if (visibleWidth(out + ch) > width) break;
+    out += ch;
+  }
+  while (visibleWidth(out) < width) out += " ";
+  return out;
+}
+function findMatchRange(text, q) {
+  if (!q) return null;
+  const lq = q.toLowerCase();
+  const lower = text.toLowerCase();
+  let i = lower.indexOf(lq);
+  if (i >= 0) return { start: i, end: i + q.length };
+  if (text.startsWith("/")) {
+    i = lower.slice(1).indexOf(lq);
+    if (i >= 0) return { start: i + 1, end: i + 1 + q.length };
+  }
+  return null;
+}
+function cellStyle(selected, level, activeCol) {
+  const i = level % LEVEL_BG.length;
+  if (activeCol) {
+    return {
+      bg: selected ? LEVEL_SEL[i] ?? T.surfaceHi : LEVEL_BG[i] ?? T.surface,
+      fg: selected ? T.text : T.muted,
+      match: MATCH_FG,
+      desc: selected ? T.muted : T.subtle
+    };
+  }
+  return {
+    bg: selected ? LEVEL_SEL_DIM[i] ?? T.surface : LEVEL_BG_DIM[i] ?? T.panel,
+    fg: selected ? T.muted : T.subtle,
+    match: T.subtle,
+    desc: T.subtle
+  };
+}
+function paintSeg(bg, fg, text) {
+  if (!text) return "";
+  return chalk.bgHex(bg).hex(fg)(text);
+}
+function paintClipped(bg, fg, text, maxW) {
+  let plain = "";
+  let painted = "";
+  for (const ch of text) {
+    if (visibleWidth(plain + ch) > maxW) break;
+    plain += ch;
+    painted += paintSeg(bg, fg, ch);
+  }
+  return { painted, used: visibleWidth(plain) };
+}
+function paintInner(n, query, style) {
+  const label = n.label;
+  const desc = descOf(n);
+  const range = findMatchRange(label, query);
+  let out = "";
+  let used = 0;
+  for (let i = 0; i < label.length; i++) {
+    const ch = label[i];
+    const cw = visibleWidth(ch);
+    if (used + cw > INNER_WIDTH) break;
+    const inMatch = range !== null && i >= range.start && i < range.end;
+    out += paintSeg(style.bg, inMatch ? style.match : style.fg, ch);
+    used += cw;
+  }
+  if (desc && used + 1 < INNER_WIDTH) {
+    out += paintSeg(style.bg, style.desc, " ");
+    used += 1;
+    const room = INNER_WIDTH - used;
+    const d = paintClipped(style.bg, style.desc, desc, room);
+    out += d.painted;
+    used += d.used;
+  }
+  if (used < INNER_WIDTH) {
+    out += paintSeg(style.bg, style.fg, " ".repeat(INNER_WIDTH - used));
+  }
+  return out;
+}
+function paintCell(n, selected, level, activeCol, query) {
+  const style = cellStyle(selected, level, activeCol);
+  const marker = selected ? "\u258C" : " ";
+  const hasKids = Boolean(n.children?.length);
+  const chevron = hasKids ? "\u203A" : " ";
+  const q = activeCol ? query : "";
+  return paintSeg(style.bg, selected && activeCol ? MATCH_FG : style.fg, marker) + paintInner(n, q, style) + paintSeg(style.bg, style.fg, chevron);
+}
+function blankCell(level, activeCol) {
+  const style = cellStyle(false, level, activeCol);
+  return chalk.bgHex(style.bg)(" ".repeat(PANEL_WIDTH));
+}
+function matchWeight(n, q) {
+  if (!q) return 0;
+  const lq = q.toLowerCase();
+  const token = n.token.toLowerCase();
+  const label = n.label.toLowerCase();
+  const desc = descOf(n).toLowerCase();
+  if (token === lq || label === `/${lq}` || label === lq) return 100;
+  if (token.startsWith(lq)) return 80 + Math.round(lq.length / Math.max(token.length, 1) * 15);
+  if (label.startsWith(lq) || label.startsWith(`/${lq}`)) {
+    const base = label.startsWith("/") ? label.slice(1) : label;
+    return 70 + Math.round(lq.length / Math.max(base.length, 1) * 15);
+  }
+  if (token.includes(lq)) return 50;
+  if (label.includes(lq)) return 40;
+  if (desc.includes(lq)) return 20;
+  return 0;
+}
+function rankItems(items, q) {
+  if (!q) return [...items];
+  return items.map((n, i) => ({ n, i, w: matchWeight(n, q) })).sort((a, b) => b.w - a.w || a.i - b.i).map((x) => x.n);
+}
+function clampPaletteSelection(selected, len) {
+  if (len <= 0) return 0;
+  if (selected < 0) return 0;
+  if (selected >= len) return len - 1;
+  return selected;
+}
+function ensurePaletteScroll(selected, scroll, len) {
+  let s = scroll;
+  if (len <= 0) return 0;
+  if (selected < s) s = selected;
+  if (selected >= s + PAGE) s = selected - PAGE + 1;
+  const maxScroll = Math.max(0, len - PAGE);
+  if (s > maxScroll) s = maxScroll;
+  if (s < 0) s = 0;
+  return s;
+}
+function pageSlice(items, selected, scroll) {
+  const sel = clampPaletteSelection(selected, items.length);
+  const sc = ensurePaletteScroll(sel, scroll, items.length);
+  const end = Math.min(items.length, sc + PAGE);
+  const rows = [];
+  for (let i = sc; i < end; i++) rows.push({ node: items[i], index: i });
+  return { rows, above: sc, below: items.length - end };
+}
+function findRoot(token) {
+  return listPaletteRoots("repl").find((n) => n.token === token);
+}
+function findChild(parent, token) {
+  return parent?.children?.find((n) => n.token === token);
+}
+function inFreeArgTail(committed) {
+  let node;
+  for (let i = 0; i < committed.length; i++) {
+    const next = i === 0 ? findRoot(committed[i]) : findChild(node, committed[i]);
+    if (!next) {
+      return Boolean(node?.freeArgs && !node.children?.length);
+    }
+    node = next;
+  }
+  return Boolean(node?.freeArgs && !node.children?.length);
+}
+function isCommandAtEnd(committed, partial, trailingSpace) {
+  if (inFreeArgTail(committed)) return true;
+  const path = trailingSpace ? committed : partial ? [...committed, partial] : committed;
+  if (path.length === 0) return false;
+  let node;
+  for (let i = 0; i < path.length; i++) {
+    const next = i === 0 ? findRoot(path[i]) : findChild(node, path[i]);
+    if (!next) return false;
+    node = next;
+  }
+  if (!node || (node.children?.length ?? 0) > 0) return false;
+  return path[path.length - 1] === node.token;
+}
+function resolvePaletteView(line, sels, scrolls) {
+  const { committed, partial, trailingSpace } = parseSlashLine(line);
+  const roots = listPaletteRoots("repl");
+  if (isCommandAtEnd(committed, partial, trailingSpace)) {
+    return { columns: [], active: 0, committed, partial, trailingSpace, hidden: true };
+  }
+  const columns = [];
+  const onRoot = committed.length === 0;
+  const mainQuery = onRoot ? partial : "";
+  const mainItems = rankItems(roots, mainQuery);
+  let mainSel = clampPaletteSelection(sels[0] ?? 0, mainItems.length);
+  if (!onRoot) {
+    const idx = mainItems.findIndex((n) => n.token === committed[0]);
+    if (idx >= 0) mainSel = idx;
+  } else if (partial) {
+    mainSel = clampPaletteSelection(sels[0] ?? 0, mainItems.length);
+  }
+  columns.push({
+    items: mainItems,
+    selected: mainSel,
+    scroll: ensurePaletteScroll(mainSel, scrolls[0] ?? 0, mainItems.length)
+  });
+  let parent = onRoot ? void 0 : findRoot(committed[0]);
+  for (let d = 1; parent?.children?.length && committed.length >= d; d++) {
+    const pathTok = committed[d];
+    const q = committed.length > d ? "" : trailingSpace ? "" : partial;
+    const childItems = rankItems(parent.children, q);
+    let sel = clampPaletteSelection(sels[d] ?? 0, childItems.length);
+    if (pathTok) {
+      const idx = childItems.findIndex((n) => n.token === pathTok);
+      if (idx >= 0) sel = idx;
+    }
+    columns.push({
+      items: childItems,
+      selected: sel,
+      scroll: ensurePaletteScroll(sel, scrolls[d] ?? 0, childItems.length)
+    });
+    parent = pathTok && committed.length > d ? findChild(parent, pathTok) : childItems[sel];
+    if (committed.length === d && !trailingSpace) break;
+    if (!parent?.children?.length) break;
+  }
+  return {
+    columns,
+    active: Math.max(0, columns.length - 1),
+    committed,
+    partial,
+    trailingSpace,
+    hidden: false
+  };
+}
+function formatColumnLines(col, level, activeCol, query) {
+  const lines = [];
+  const style = cellStyle(false, level, activeCol);
+  if (col.items.length === 0) {
+    lines.push(
+      paintSeg(style.bg, style.fg, " ") + paintSeg(style.bg, style.fg, clipPad(t("repl.palette.empty"), INNER_WIDTH)) + paintSeg(style.bg, style.fg, " ")
+    );
+    return lines;
+  }
+  const { rows, above, below } = pageSlice(col.items, col.selected, col.scroll);
+  if (above > 0) {
+    lines.push(
+      paintSeg(style.bg, style.fg, " ") + paintSeg(style.bg, style.fg, clipPad(`\u2191${above}\u2026`, INNER_WIDTH)) + paintSeg(style.bg, style.fg, " ")
+    );
+  }
+  for (const { node, index } of rows) {
+    lines.push(paintCell(node, index === col.selected, level, activeCol, query));
+  }
+  if (below > 0) {
+    lines.push(
+      paintSeg(style.bg, style.fg, " ") + paintSeg(style.bg, style.fg, clipPad(`\u2193${below}\u2026`, INNER_WIDTH)) + paintSeg(style.bg, style.fg, " ")
+    );
+  }
+  return lines;
+}
+function formatPaletteCascadeLines(view, indentCols) {
+  if (view.hidden || view.columns.length === 0) return [];
+  const indent = " ".repeat(Math.max(0, indentCols));
+  const colLines = view.columns.map(
+    (col, i) => formatColumnLines(col, i, i === view.active, i === view.active ? view.partial : "")
+  );
+  const height = Math.max(1, ...colLines.map((l) => l.length));
+  const out = [];
+  for (let r = 0; r < height; r++) {
+    const parts = [];
+    for (let cidx = 0; cidx < view.columns.length; cidx++) {
+      const activeCol = cidx === view.active;
+      const cell = colLines[cidx][r] ?? blankCell(cidx, activeCol);
+      const plainW = visibleWidth(cell);
+      parts.push(plainW < PANEL_WIDTH ? cell + " ".repeat(PANEL_WIDTH - plainW) : cell);
+    }
+    out.push(indent + parts.join(PANEL_GAP));
+  }
+  return out;
+}
+function activeNode(view) {
+  if (view.hidden) return void 0;
+  const col = view.columns[view.active];
+  if (!col || col.items.length === 0) return void 0;
+  return col.items[clampPaletteSelection(col.selected, col.items.length)];
+}
+function paletteGhost(view) {
+  const node = activeNode(view);
+  if (!node || view.hidden) return "";
+  if (view.committed.length > view.active) return "";
+  const p = view.partial;
+  const tok = node.token;
+  if (!p) return tok;
+  if (tok.toLowerCase().startsWith(p.toLowerCase())) return tok.slice(p.length);
+  return "";
+}
+function commitSelection(line, view) {
+  if (view.hidden || view.columns.length === 0) {
+    return { line, submit: true };
+  }
+  const node = activeNode(view);
+  if (!node) return { line, submit: true };
+  const { committed, partial, trailingSpace, active } = view;
+  const isLeaf = !node.children?.length && !node.freeArgs;
+  if (isLeaf && !trailingSpace) {
+    if (committed.length === active && partial === node.token) {
+      return { line: "/" + [...committed, node.token].join(" "), submit: true };
+    }
+    if (committed.length === active + 1 && committed[active] === node.token && !partial) {
+      return { line, submit: true };
+    }
+  }
+  const tokens = committed.slice(0, active);
+  tokens.push(node.token);
+  let next = "/" + tokens.join(" ");
+  if (node.children?.length || node.freeArgs) next += " ";
+  return { line: next, submit: false };
+}
+function promptSlashColumn(prompt) {
+  return visibleWidth(prompt);
+}
+export {
+  PANEL_WIDTH,
+  activeNode,
+  clampPaletteSelection,
+  clipPad,
+  commitSelection,
+  ensurePaletteScroll,
+  findMatchRange,
+  formatPaletteCascadeLines,
+  isCommandAtEnd,
+  matchWeight,
+  paletteGhost,
+  parseSlashLine,
+  promptSlashColumn,
+  rankItems,
+  resolvePaletteView
+};
+//# sourceMappingURL=command-palette.js.map