@nmakarov/cli-toolkit 0.66.0 → 0.68.0

package/dist/cli-runner.cjs

@@ -493,6 +493,59 @@ var init_list_components = __esm({
   }
 });
 
+// src/screen/key-bindings.js
+function bindingIdentity(b) {
+  return [
+    String(b?.key ?? ""),
+    b?.meta ? "m" : "",
+    b?.ctrl ? "c" : "",
+    b?.shift ? "s" : ""
+  ].join("|");
+}
+function bindingMatchesInput(binding, input, key) {
+  if (!binding?.key) return false;
+  let keyMatches = false;
+  if (key?.[binding.key]) {
+    keyMatches = true;
+  } else if (input === binding.key) {
+    keyMatches = true;
+  } else if (key?.name === binding.key) {
+    keyMatches = true;
+  }
+  if (!keyMatches) return false;
+  const modOk = (flag, pressed) => {
+    if (flag === true) return !!pressed;
+    if (flag === false) return !pressed;
+    return !pressed;
+  };
+  if (!modOk(binding.meta, key?.meta)) return false;
+  if (!modOk(binding.ctrl, key?.ctrl)) return false;
+  if (binding.shift !== void 0 && !!key?.shift !== !!binding.shift) return false;
+  return true;
+}
+function formatBindingKey(binding) {
+  let label = KEY_LABELS[binding.key] || binding.key;
+  if (binding.shift) label = `\u21E7${label}`;
+  if (binding.ctrl) label = `^${label}`;
+  if (binding.meta) label = `\u2325${label}`;
+  return label;
+}
+var KEY_LABELS;
+var init_key_bindings = __esm({
+  "src/screen/key-bindings.js"() {
+    KEY_LABELS = {
+      escape: "esc",
+      leftArrow: "\u2190",
+      rightArrow: "\u2192",
+      upArrow: "\u2191",
+      downArrow: "\u2193",
+      return: "enter",
+      pageUp: "PgUp",
+      pageDown: "PgDn"
+    };
+  }
+});
+
 // src/screen/screens.js
 function groupKeyBindings(bindings) {
   const groups = {};
@@ -506,7 +559,7 @@ function groupKeyBindings(bindings) {
         order: binding.order || 999
       };
     }
-    groups[caption].keys.push(binding.key);
+    groups[caption].keys.push(formatBindingKey(binding));
   });
   return Object.values(groups);
 }
@@ -546,12 +599,14 @@ function formatKeyBindings(bindings, mode = "long") {
 }
 function formatKeys(keys) {
   const keyMap = {
-    "escape": "esc",
-    "leftArrow": "\u2190",
-    "rightArrow": "\u2192",
-    "upArrow": "\u2191",
-    "downArrow": "\u2193",
-    "return": "enter"
+    escape: "esc",
+    leftArrow: "\u2190",
+    rightArrow: "\u2192",
+    upArrow: "\u2191",
+    downArrow: "\u2193",
+    return: "enter",
+    pageUp: "PgUp",
+    pageDown: "PgDn"
   };
   return keys.map((k) => keyMap[k] || k).join("/");
 }
@@ -591,7 +646,10 @@ async function showScreen(config2) {
         setKeyBinding: (bindingOrBindings) => {
           const bindingsToSet = Array.isArray(bindingOrBindings) ? bindingOrBindings : [bindingOrBindings];
           bindingsToSet.forEach((binding) => {
-            const existingIndex = keyBindings.findIndex((b) => b.key === binding.key);
+            const id = bindingIdentity(binding);
+            const existingIndex = keyBindings.findIndex(
+              (b) => bindingIdentity(b) === id
+            );
             if (existingIndex >= 0) {
               const existing = keyBindings[existingIndex];
               if (existing.protected) {
@@ -615,7 +673,10 @@ async function showScreen(config2) {
           });
         },
         updateKeyBinding: (keyName, updates) => {
-          const index = keyBindings.findIndex((b) => b.key === keyName);
+          const id = updates && (updates.meta != null || updates.ctrl != null || updates.shift != null) ? bindingIdentity({ key: keyName, ...updates }) : null;
+          const index = keyBindings.findIndex(
+            (b) => id ? bindingIdentity(b) === id : b.key === keyName
+          );
           if (index >= 0) {
             keyBindings[index] = {
               ...keyBindings[index],
@@ -623,11 +684,13 @@ async function showScreen(config2) {
             };
           }
         },
-        removeKeyBinding: (keyName) => {
-          const index = keyBindings.findIndex((b) => b.key === keyName);
+        removeKeyBinding: (keyNameOrBinding) => {
+          const index = typeof keyNameOrBinding === "object" && keyNameOrBinding ? keyBindings.findIndex(
+            (b) => bindingIdentity(b) === bindingIdentity(keyNameOrBinding)
+          ) : keyBindings.findIndex((b) => b.key === keyNameOrBinding);
           if (index >= 0) {
             if (keyBindings[index].protected) {
-              console.warn(`Cannot remove protected key: ${keyName}`);
+              console.warn(`Cannot remove protected key: ${keyNameOrBinding}`);
               return;
             }
             keyBindings.splice(index, 1);
@@ -668,24 +731,11 @@ async function showScreen(config2) {
         }
         let matchedBinding = null;
         for (const binding of keyBindings) {
-          let keyMatches = false;
-          if (key[binding.key]) {
-            keyMatches = true;
-          } else if (input === binding.key) {
-            keyMatches = true;
-          } else if (key?.name === binding.key) {
-            keyMatches = true;
-          }
-          if (keyMatches) {
-            if (binding.enabled === false) {
-              continue;
-            }
-            if (binding.condition && !binding.condition(context)) {
-              continue;
-            }
-            matchedBinding = binding;
-            break;
-          }
+          if (binding.enabled === false) continue;
+          if (!bindingMatchesInput(binding, input, key)) continue;
+          if (binding.condition && !binding.condition(context)) continue;
+          matchedBinding = binding;
+          break;
         }
         if (matchedBinding && actions[matchedBinding.action]) {
           actions[matchedBinding.action]({
@@ -823,6 +873,7 @@ var init_screens = __esm({
     import_ink3 = require("ink");
     init_components();
     init_list_components();
+    init_key_bindings();
     showMenuScreen = showListScreen;
     showWordGridScreen = showMultiColumnListScreen;
   }
@@ -913,6 +964,157 @@ var init_ui_elements = __esm({
   }
 });
 
+// src/screen/scrollable-text.js
+function wrapTextLines(text, cols) {
+  const w = Math.max(1, Math.floor(Number(cols) || 1));
+  const out = [];
+  for (const raw of String(text ?? "").split("\n")) {
+    if (raw.length === 0) {
+      out.push("");
+      continue;
+    }
+    let rest = raw;
+    while (rest.length > w) {
+      out.push(rest.slice(0, w));
+      rest = rest.slice(w);
+    }
+    if (rest.length > 0) out.push(rest);
+  }
+  return out;
+}
+function scrollbarGlyphs(viewportRows, totalLines, scrollTop) {
+  const view = Math.max(1, Math.floor(viewportRows));
+  const total = Math.max(0, Math.floor(totalLines));
+  if (total <= view) return null;
+  const maxScroll = total - view;
+  const thumbSize = Math.max(1, Math.round(view / total * view));
+  const travel = Math.max(0, view - thumbSize);
+  const s = Math.min(Math.max(0, Math.floor(scrollTop)), maxScroll);
+  const thumbStart = maxScroll === 0 ? 0 : Math.round(s / maxScroll * travel);
+  const glyphs = [];
+  for (let i = 0; i < view; i++) {
+    glyphs.push(i >= thumbStart && i < thumbStart + thumbSize ? "\u2588" : "\u2502");
+  }
+  return glyphs;
+}
+function padEndVisible(s, w) {
+  const t = String(s ?? "");
+  if (t.length >= w) return t.slice(0, w);
+  return t + " ".repeat(w - t.length);
+}
+function ScrollableText({
+  ctx,
+  text = "",
+  lines: linesProp,
+  maxHeight,
+  wrap = true,
+  showScrollbar = true,
+  showStatus = true,
+  bindKeys = true,
+  header = null
+}) {
+  const [scrollTop, setScrollTop] = (0, import_react5.useState)(0);
+  const [, bump] = (0, import_react5.useState)(0);
+  const termCols = process.stdout.columns || 80;
+  const termRows = process.stdout.rows || 24;
+  const viewportRows = Math.max(
+    4,
+    maxHeight != null ? Math.floor(maxHeight) : Math.max(8, termRows - 8)
+  );
+  const provisionalBar = showScrollbar ? 1 : 0;
+  const wrapCols = Math.max(8, termCols - provisionalBar);
+  const allLines = (0, import_react5.useMemo)(() => {
+    if (Array.isArray(linesProp)) return linesProp.map((l) => String(l ?? ""));
+    return wrap ? wrapTextLines(text, wrapCols) : String(text ?? "").split("\n");
+  }, [linesProp, text, wrap, wrapCols]);
+  const needsBar = showScrollbar && allLines.length > viewportRows;
+  const textWidth = Math.max(8, termCols - (needsBar ? 1 : 0));
+  const maxScroll = Math.max(0, allLines.length - viewportRows);
+  const clamped = Math.min(Math.max(0, scrollTop), maxScroll);
+  const visible = allLines.slice(clamped, clamped + viewportRows);
+  const bar = needsBar ? scrollbarGlyphs(viewportRows, allLines.length, clamped) : null;
+  (0, import_react5.useEffect)(() => {
+    setScrollTop((s) => Math.min(s, maxScroll));
+  }, [maxScroll]);
+  const maxScrollRef = (0, import_react5.useRef)(maxScroll);
+  const pageSizeRef = (0, import_react5.useRef)(viewportRows);
+  maxScrollRef.current = maxScroll;
+  pageSizeRef.current = viewportRows;
+  (0, import_react5.useEffect)(() => {
+    if (!ctx || !bindKeys) return void 0;
+    ctx.setKeyBinding(SCROLL_KEYS);
+    ctx.setAction("scrollUp", () => {
+      setScrollTop((s) => Math.max(0, s - 1));
+      bump((n) => n + 1);
+      ctx.update?.();
+    });
+    ctx.setAction("scrollDown", () => {
+      setScrollTop((s) => Math.min(maxScrollRef.current, s + 1));
+      bump((n) => n + 1);
+      ctx.update?.();
+    });
+    ctx.setAction("pageUp", () => {
+      setScrollTop((s) => Math.max(0, s - pageSizeRef.current));
+      bump((n) => n + 1);
+      ctx.update?.();
+    });
+    ctx.setAction("pageDown", () => {
+      setScrollTop((s) => Math.min(maxScrollRef.current, s + pageSizeRef.current));
+      bump((n) => n + 1);
+      ctx.update?.();
+    });
+    return void 0;
+  }, [ctx, bindKeys]);
+  const status = allLines.length === 0 ? "empty" : `lines ${clamped + 1}-${Math.min(clamped + visible.length, allLines.length)} of ${allLines.length}` + (needsBar ? " \xB7 \u2325\u2191/\u2193 or PgUp/Dn page" : "");
+  const rowNodes = visible.map((line, i) => {
+    const body = padEndVisible(line, textWidth);
+    const glyph = bar ? bar[i] ?? "\u2502" : "";
+    return h5(
+      import_ink5.Box,
+      { key: `L${clamped + i}`, flexDirection: "row" },
+      h5(import_ink5.Text, {}, body),
+      glyph ? h5(import_ink5.Text, { color: bar[i] === "\u2588" ? "cyan" : "gray" }, glyph) : null
+    );
+  });
+  if (bar && visible.length < viewportRows) {
+    for (let i = visible.length; i < viewportRows; i++) {
+      rowNodes.push(
+        h5(
+          import_ink5.Box,
+          { key: `pad${i}`, flexDirection: "row" },
+          h5(import_ink5.Text, {}, padEndVisible("", textWidth)),
+          h5(import_ink5.Text, { color: bar[i] === "\u2588" ? "cyan" : "gray" }, bar[i] ?? "\u2502")
+        )
+      );
+    }
+  }
+  return h5(
+    import_ink5.Box,
+    { flexDirection: "column" },
+    header == null ? null : typeof header === "string" ? h5(import_ink5.Text, { color: "gray" }, header) : header,
+    showStatus ? h5(import_ink5.Text, { color: "gray" }, status) : null,
+    ...rowNodes
+  );
+}
+var import_react5, import_ink5, h5, SCROLL_KEYS;
+var init_scrollable_text = __esm({
+  "src/screen/scrollable-text.js"() {
+    import_react5 = require("react");
+    import_ink5 = require("ink");
+    h5 = import_react5.createElement;
+    SCROLL_KEYS = [
+      { key: "upArrow", caption: "scroll", action: "scrollUp", order: 0 },
+      { key: "downArrow", caption: "scroll", action: "scrollDown", order: 0 },
+      { key: "upArrow", meta: true, caption: "page", action: "pageUp", order: 0 },
+      { key: "downArrow", meta: true, caption: "page", action: "pageDown", order: 0 },
+      { key: "upArrow", ctrl: true, caption: "page", action: "pageUp", order: 0 },
+      { key: "downArrow", ctrl: true, caption: "page", action: "pageDown", order: 0 },
+      { key: "pageUp", caption: "page", action: "pageUp", order: 0 },
+      { key: "pageDown", caption: "page", action: "pageDown", order: 0 }
+    ];
+  }
+});
+
 // src/screen/utils.js
 function buildBreadcrumb(parts) {
   if (parts.length === 0) return "";
@@ -1044,7 +1246,7 @@ var init_footer_builder = __esm({
 // src/screen/index.js
 var screen_exports = {};
 __export(screen_exports, {
-  Box: () => import_ink5.Box,
+  Box: () => import_ink6.Box,
   Divider: () => Divider,
   FooterPresets: () => FooterPresets,
   GridCell: () => GridCell,
@@ -1053,35 +1255,41 @@ __export(screen_exports, {
   ListItem: () => ListItem,
   MultiColumnListComponent: () => MultiColumnListComponent,
   MultiColumnListWithPreviewComponent: () => MultiColumnListWithPreviewComponent,
-  React: () => import_react5.default,
+  React: () => import_react6.default,
   ScreenBody: () => ScreenBody,
   ScreenContainer: () => ScreenContainer,
   ScreenDivider: () => ScreenDivider,
   ScreenFooter: () => ScreenFooter,
   ScreenRow: () => ScreenRow,
   ScreenTitle: () => ScreenTitle,
-  Text: () => import_ink5.Text,
+  ScrollableText: () => ScrollableText,
+  Text: () => import_ink6.Text,
   TextBlock: () => TextBlock,
+  bindingIdentity: () => bindingIdentity,
+  bindingMatchesInput: () => bindingMatchesInput,
   buildBreadcrumb: () => buildBreadcrumb,
   buildDetailBreadcrumb: () => buildDetailBreadcrumb,
   buildFooter: () => buildFooter,
-  h: () => import_react5.createElement,
+  formatBindingKey: () => formatBindingKey,
+  h: () => import_react6.createElement,
   load: () => load,
-  memo: () => import_react5.memo,
+  memo: () => import_react6.memo,
   organizeFooterMessages: () => organizeFooterMessages,
+  scrollbarGlyphs: () => scrollbarGlyphs,
   showListScreen: () => showListScreen,
   showMenuScreen: () => showMenuScreen,
   showMultiColumnListScreen: () => showMultiColumnListScreen,
   showMultiColumnListWithPreviewScreen: () => showMultiColumnListWithPreviewScreen,
   showScreen: () => showScreen,
   showWordGridScreen: () => showWordGridScreen,
-  useCallback: () => import_react5.useCallback,
-  useEffect: () => import_react5.useEffect,
-  useInput: () => import_ink5.useInput,
-  useLayoutEffect: () => import_react5.useLayoutEffect,
-  useMemo: () => import_react5.useMemo,
-  useRef: () => import_react5.useRef,
-  useState: () => import_react5.useState
+  useCallback: () => import_react6.useCallback,
+  useEffect: () => import_react6.useEffect,
+  useInput: () => import_ink6.useInput,
+  useLayoutEffect: () => import_react6.useLayoutEffect,
+  useMemo: () => import_react6.useMemo,
+  useRef: () => import_react6.useRef,
+  useState: () => import_react6.useState,
+  wrapTextLines: () => wrapTextLines
 });
 async function load() {
   if (loadPromise) return loadPromise;
@@ -1092,15 +1300,17 @@ async function load() {
   });
   return loadPromise;
 }
-var import_react5, import_ink5, loadPromise;
+var import_react6, import_ink6, loadPromise;
 var init_screen = __esm({
   "src/screen/index.js"() {
-    import_react5 = __toESM(require("react"), 1);
-    import_ink5 = require("ink");
+    import_react6 = __toESM(require("react"), 1);
+    import_ink6 = require("ink");
     init_screens();
     init_list_components();
     init_components();
     init_ui_elements();
+    init_scrollable_text();
+    init_key_bindings();
     init_utils();
     init_footer_builder();
     loadPromise = null;
@@ -6334,8 +6544,18 @@ var LOGGER_RUNTIME_KEYS = [
   "progressThrottleMs"
 ];
 var CONTROL_LANE_TASK_NAMES = ["stopRunner", "stop", "setRuntimeParam", "setRunnerParam"];
-function controlLaneTaskNames() {
-  return [...CONTROL_LANE_TASK_NAMES];
+function controlLaneTaskNames(extra) {
+  const names = [...CONTROL_LANE_TASK_NAMES];
+  if (extra == null || extra === "") return names;
+  const more = Array.isArray(extra) ? extra : String(extra).split(",");
+  const seen = new Set(names);
+  for (const raw of more) {
+    const n = String(raw ?? "").trim();
+    if (!n || seen.has(n)) continue;
+    seen.add(n);
+    names.push(n);
+  }
+  return names;
 }
 function asPositiveInt(value, key, { min = 1 } = {}) {
   const n = Number(value);
@@ -6936,6 +7156,7 @@ async function runTasksLoop(context, options) {
   const queueName = options.queueName ?? "tasks";
   const target = options.target;
   const allowedTasks = normalizeAllowedTasks(options.allowedTasks);
+  const controlLaneNames = controlLaneTaskNames(options.controlLaneTasks);
   const registry = normalizeRegistry(options.registry);
   const { tasksTable, historyTable } = queueToTableNames(queueName);
   if (!target) throw new Error("runTasksLoop: target is required");
@@ -7006,7 +7227,7 @@ async function runTasksLoop(context, options) {
           target,
           registry,
           10,
-          controlLaneTaskNames(),
+          controlLaneNames,
           runnerIdentity
         );
         if (claimedControlTask) {