@nmakarov/cli-toolkit 0.80.0 → 0.81.0

package/dist/index.cjs

@@ -1018,6 +1018,30 @@ var init_ui_elements = __esm({
   }
 });
 
+// src/screen/follow-scroll.js
+function clampScroll(scrollTop, maxScroll) {
+  const max = Math.max(0, Number(maxScroll) || 0);
+  const top = Number(scrollTop) || 0;
+  return Math.min(Math.max(0, top), max);
+}
+function isScrolledToBottom(scrollTop, maxScroll) {
+  return clampScroll(scrollTop, maxScroll) >= Math.max(0, Number(maxScroll) || 0);
+}
+function nextScrollAfterUserMove(scrollTop, maxScroll, delta) {
+  const next = clampScroll((Number(scrollTop) || 0) + (Number(delta) || 0), maxScroll);
+  return { scrollTop: next, following: isScrolledToBottom(next, maxScroll) };
+}
+function nextScrollAfterContentChange({ following, scrollTop, maxScroll }) {
+  const max = Math.max(0, Number(maxScroll) || 0);
+  if (following) return { scrollTop: max, following: true };
+  const next = clampScroll(scrollTop, max);
+  return { scrollTop: next, following: isScrolledToBottom(next, max) };
+}
+var init_follow_scroll = __esm({
+  "src/screen/follow-scroll.js"() {
+  }
+});
+
 // src/screen/scrollable-text.js
 function wrapTextLines(text, cols) {
   const w = Math.max(1, Math.floor(Number(cols) || 1));
@@ -1050,9 +1074,11 @@ function ScrollableText({
   showScrollbar = true,
   showStatus = true,
   bindKeys = true,
-  header = null
+  header = null,
+  followBottom = false
 }) {
   const [scrollTop, setScrollTop] = (0, import_react5.useState)(0);
+  const [following, setFollowing] = (0, import_react5.useState)(() => !!followBottom);
   const [, bump] = (0, import_react5.useState)(0);
   const termRows = process.stdout.rows || 24;
   const viewportRows = Math.max(
@@ -1071,39 +1097,40 @@ function ScrollableText({
   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);
+  const scrollTopRef = (0, import_react5.useRef)(scrollTop);
+  const followingRef = (0, import_react5.useRef)(following);
   maxScrollRef.current = maxScroll;
   pageSizeRef.current = viewportRows;
+  scrollTopRef.current = scrollTop;
+  followingRef.current = following;
+  (0, import_react5.useEffect)(() => {
+    const next = nextScrollAfterContentChange({
+      following: followBottom && followingRef.current,
+      scrollTop: scrollTopRef.current,
+      maxScroll
+    });
+    if (next.scrollTop !== scrollTopRef.current) setScrollTop(next.scrollTop);
+    if (followBottom && next.following !== followingRef.current) setFollowing(next.following);
+  }, [maxScroll, followBottom]);
+  const applyUserScroll = (delta) => {
+    const next = nextScrollAfterUserMove(scrollTopRef.current, maxScrollRef.current, delta);
+    setScrollTop(next.scrollTop);
+    if (followBottom) setFollowing(next.following);
+    bump((n) => n + 1);
+    ctx?.update?.();
+  };
   (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?.();
-    });
+    ctx.setAction("scrollUp", () => applyUserScroll(-1));
+    ctx.setAction("scrollDown", () => applyUserScroll(1));
+    ctx.setAction("pageUp", () => applyUserScroll(-pageSizeRef.current));
+    ctx.setAction("pageDown", () => applyUserScroll(pageSizeRef.current));
     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" : "");
+  }, [ctx, bindKeys, followBottom]);
+  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" : "") + (followBottom && following ? " \xB7 follow" : followBottom ? " \xB7 follow off" : "");
   const rowNodes = visible.map((line, i) => {
     const body = padEndVisible(line, textWidth);
     const glyph = bar ? bar[i] ?? BAR_TRACK : showScrollbar ? " " : "";
@@ -1143,6 +1170,7 @@ var init_scrollable_text = __esm({
     import_ink5 = require("ink");
     init_components();
     init_scrollbar();
+    init_follow_scroll();
     init_scrollbar();
     h5 = import_react5.createElement;
     SCROLL_KEYS = [
@@ -1298,6 +1326,7 @@ var init_screen = __esm({
     init_components();
     init_ui_elements();
     init_scrollable_text();
+    init_follow_scroll();
     init_scrollbar();
     init_key_bindings();
     init_utils();
@@ -1377,6 +1406,7 @@ __export(src_exports, {
   buildDetailBreadcrumb: () => buildDetailBreadcrumb,
   buildFooter: () => buildFooter,
   bumpPatchVersion: () => bumpPatchVersion,
+  clampScroll: () => clampScroll,
   cloneRepo: () => cloneRepo,
   coerceRuntimeValue: () => coerceRuntimeValue,
   controlLaneTaskNames: () => controlLaneTaskNames,
@@ -1414,6 +1444,7 @@ __export(src_exports, {
   ipcFileLogsTableNameForSourceResource: () => ipcFileLogsTableNameForSourceResource,
   isFreshOnline: () => isFreshOnline,
   isPidAlive: () => isPidAlive,
+  isScrolledToBottom: () => isScrolledToBottom,
   joiEdateType: () => joiEdateType,
   joiStringArrayType: () => joiStringArrayType,
   listAliveRunnerHeartbeats: () => listServicesRegistry,
@@ -1427,6 +1458,8 @@ __export(src_exports, {
   memo: () => import_react6.memo,
   mergeAllowedTasksWithServiceTasks: () => mergeAllowedTasksWithServiceTasks,
   mergeRuntimeParamSpecs: () => mergeRuntimeParamSpecs,
+  nextScrollAfterContentChange: () => nextScrollAfterContentChange,
+  nextScrollAfterUserMove: () => nextScrollAfterUserMove,
   nextTimeMatch: () => nextTimeMatch,
   normalizeAllowedTasks: () => normalizeAllowedTasks,
   npmEnv: () => npmEnv,
@@ -10351,6 +10384,7 @@ var TasksManager = class _TasksManager {
   buildDetailBreadcrumb,
   buildFooter,
   bumpPatchVersion,
+  clampScroll,
   cloneRepo,
   coerceRuntimeValue,
   controlLaneTaskNames,
@@ -10388,6 +10422,7 @@ var TasksManager = class _TasksManager {
   ipcFileLogsTableNameForSourceResource,
   isFreshOnline,
   isPidAlive,
+  isScrolledToBottom,
   joiEdateType,
   joiStringArrayType,
   listAliveRunnerHeartbeats,
@@ -10401,6 +10436,8 @@ var TasksManager = class _TasksManager {
   memo,
   mergeAllowedTasksWithServiceTasks,
   mergeRuntimeParamSpecs,
+  nextScrollAfterContentChange,
+  nextScrollAfterUserMove,
   nextTimeMatch,
   normalizeAllowedTasks,
   npmEnv,