@a9s/cli 1.0.9 → 1.1.0

package/dist/src/App.js

@@ -26,8 +26,22 @@ import { AVAILABLE_COMMANDS } from "./constants/commands.js";
 import { buildHelpTabs, triggerToString } from "./constants/keybindings.js";
 import { useTheme } from "./contexts/ThemeContext.js";
 import { saveConfig } from "./utils/config.js";
+import { readFile } from "fs/promises";
+import { runAwsJsonAsync } from "./utils/aws.js";
+import { debugLog } from "./utils/debugLogger.js";
 import { currentlySelectedServiceAtom, selectedRegionAtom, selectedProfileAtom, revealSecretsAtom, themeNameAtom, } from "./state/atoms.js";
 const INITIAL_AWS_PROFILE = process.env.AWS_PROFILE;
+/** Convert a theme color to a hex string for OSC 11. Named colors → hex. */
+function toOscColor(color) {
+    if (color.startsWith('#'))
+        return color;
+    const named = {
+        black: '#000000', white: '#ffffff', red: '#cc0000',
+        green: '#00cc00', blue: '#0000cc', cyan: '#00cccc',
+        magenta: '#cc00cc', yellow: '#cccc00', gray: '#808080',
+    };
+    return named[color] ?? '#000000';
+}
 export function App({ initialService, endpointUrl }) {
     const { exit } = useApp();
     const { columns: termCols, rows: termRows } = useScreenSize();
@@ -37,6 +51,13 @@ export function App({ initialService, endpointUrl }) {
     const [revealSecrets, setRevealSecrets] = useAtom(revealSecretsAtom);
     const [themeName, setThemeName] = useAtom(themeNameAtom);
     const THEME = useTheme();
+    // Paint the terminal's default background so uncolored cells (border chars, gaps) inherit the theme
+    useEffect(() => {
+        process.stdout.write(`\x1b]11;${toOscColor(THEME.global.mainBg)}\x07`);
+        return () => {
+            process.stdout.write(`\x1b]111\x07`); // restore original background on unmount
+        };
+    }, [THEME.global.mainBg]);
     // Live theme preview: refs to restore original when picker is cancelled
     const themeNameRef = useRef(themeName);
     themeNameRef.current = themeName; // always in sync, not a dep
@@ -46,7 +67,7 @@ export function App({ initialService, endpointUrl }) {
     const availableRegions = useAwsRegions(selectedRegion, selectedProfile);
     const availableProfiles = useAwsProfiles();
     const { reset: resetHierarchy, updateCurrentFilter, pushLevel, popLevel } = useHierarchyState();
-    const { state, actions } = useAppController();
+    const { state, actions, yankFeedbackMessage } = useAppController();
     useEffect(() => {
         if (selectedProfile === "$default") {
             if (INITIAL_AWS_PROFILE === undefined) {
@@ -291,16 +312,14 @@ export function App({ initialService, endpointUrl }) {
             setPanelScrollOffset(0);
             void (async () => {
                 try {
-                    const { readFile } = await import("fs/promises");
                     const newContent = await readFile(state.uploadPending.filePath, "utf-8");
                     // Try to get old value from adapter (current value from AWS)
                     let oldContent = "";
                     const meta = state.uploadPending.metadata;
+                    const regionArgs = selectedRegion ? ["--region", selectedRegion] : [];
                     // For Secrets Manager fields: fetch the current field value
                     if (meta.fieldKey && meta.secretArn) {
                         try {
-                            const { runAwsJsonAsync } = await import("./utils/aws.js");
-                            const regionArgs = selectedRegion ? ["--region", selectedRegion] : [];
                             const secretData = await runAwsJsonAsync([
                                 "secretsmanager",
                                 "get-secret-value",
@@ -324,15 +343,13 @@ export function App({ initialService, endpointUrl }) {
                                 }
                             }
                         }
-                        catch {
-                            // Failed to fetch
+                        catch (err) {
+                            debugLog("App", "upload preview fetch failed (field)", err);
                         }
                     }
                     // For whole secrets: fetch current secret value
                     else if (meta.secretArn && !meta.fieldKey) {
                         try {
-                            const { runAwsJsonAsync } = await import("./utils/aws.js");
-                            const regionArgs = selectedRegion ? ["--region", selectedRegion] : [];
                             const secretData = await runAwsJsonAsync([
                                 "secretsmanager",
                                 "get-secret-value",
@@ -342,13 +359,14 @@ export function App({ initialService, endpointUrl }) {
                             ]);
                             oldContent = secretData.SecretString || "";
                         }
-                        catch {
-                            // Failed to fetch
+                        catch (err) {
+                            debugLog("App", "upload preview fetch failed (secret)", err);
                         }
                     }
                     setUploadPreview({ old: oldContent, new: newContent });
                 }
-                catch {
+                catch (err) {
+                    debugLog("App", "upload preview load failed", err);
                     setUploadPreview({ old: "", new: "[Unable to load preview]" });
                 }
             })();
@@ -504,5 +522,5 @@ export function App({ initialService, endpointUrl }) {
     });
     useMainInput(inputDispatch);
     const activePickerFilter = pickers.activePicker?.filter ?? state.filterText;
-    return (_jsx(FullscreenBox, { children: _jsxs(Box, { flexDirection: "column", width: termCols, height: termRows, backgroundColor: THEME.global.mainBg, children: [_jsx(HUD, { serviceLabel: adapter.label, hudColor: THEME.serviceColors[adapter.id] ?? adapter.hudColor, path: path, accountName: accountName, accountId: accountId, awsProfile: awsProfile, currentIdentity: currentIdentity, region: region, terminalWidth: termCols, loading: isLoading || Boolean(state.describeState?.loading) }), _jsx(Box, { flexDirection: "row", width: "100%", flexGrow: 1, children: _jsx(AppMainView, { helpPanel: helpPanel, helpTabs: helpTabs, pickers: pickers, error: error, describeState: state.describeState, isLoading: isLoading, filteredRows: filteredRows, columns: columns, selectedIndex: navigation.selectedIndex, scrollOffset: navigation.scrollOffset, filterText: state.filterText, adapter: adapter, termCols: termCols, tableHeight: tableHeight, yankHelpOpen: state.yankHelpOpen, yankOptions: yankOptions, yankHelpRow: selectedRow, uploadPending: state.uploadPending, uploadPreview: uploadPreview, panelScrollOffset: panelScrollOffset, ...(yankHeaderMarkers ? { headerMarkers: yankHeaderMarkers } : {}) }) }), !helpPanel.helpOpen && state.yankFeedbackMessage && (_jsx(Box, { paddingX: 1, children: _jsx(Text, { color: THEME.feedback.successText, children: state.yankFeedbackMessage }) })), state.pendingAction && state.pendingAction.effect.type === "prompt" && (_jsxs(Box, { paddingX: 1, children: [_jsxs(Text, { color: THEME.feedback.promptText, children: [state.pendingAction.effect.label, " "] }), _jsx(AdvancedTextInput, { value: state.pendingAction.inputValue, onChange: (value) => actions.setPendingInputValue(value), onSubmit: () => submitPendingAction(state.pendingAction, true), focus: true })] })), state.pendingAction && state.pendingAction.effect.type === "confirm" && (_jsx(Box, { paddingX: 1, children: _jsxs(Text, { color: THEME.feedback.confirmText, children: [state.pendingAction.effect.message, " (y/n)"] }) })), _jsx(ModeBar, { mode: state.mode, filterText: activePickerFilter, commandText: state.commandText, commandCursorToEndToken: state.commandCursorToEndToken, hintOverride: bottomHint, pickerSearchActive: pickers.activePicker?.pickerMode === "search", onFilterChange: handleFilterChange, onCommandChange: actions.setCommandText, onFilterSubmit: handleFilterSubmit, onCommandSubmit: handleCommandSubmit })] }) }));
+    return (_jsx(FullscreenBox, { backgroundColor: THEME.global.mainBg, children: _jsxs(Box, { flexDirection: "column", width: termCols, height: termRows, backgroundColor: THEME.global.mainBg, children: [_jsx(HUD, { serviceLabel: adapter.label, hudColor: THEME.serviceColors[adapter.id] ?? adapter.hudColor, path: path, accountName: accountName, accountId: accountId, awsProfile: awsProfile, currentIdentity: currentIdentity, region: region, terminalWidth: termCols, loading: isLoading || Boolean(state.describeState?.loading) }), _jsx(Box, { flexDirection: "row", width: "100%", flexGrow: 1, backgroundColor: THEME.global.mainBg, children: _jsx(AppMainView, { helpPanel: helpPanel, helpTabs: helpTabs, pickers: pickers, error: error, describeState: state.describeState, isLoading: isLoading, filteredRows: filteredRows, columns: columns, selectedIndex: navigation.selectedIndex, scrollOffset: navigation.scrollOffset, filterText: state.filterText, adapter: adapter, termCols: termCols, tableHeight: tableHeight, yankHelpOpen: state.yankHelpOpen, yankOptions: yankOptions, yankHelpRow: selectedRow, uploadPending: state.uploadPending, uploadPreview: uploadPreview, panelScrollOffset: panelScrollOffset, ...(yankHeaderMarkers ? { headerMarkers: yankHeaderMarkers } : {}) }) }), !helpPanel.helpOpen && yankFeedbackMessage && (_jsx(Box, { paddingX: 1, children: _jsx(Text, { color: THEME.feedback.successText, children: yankFeedbackMessage }) })), state.pendingAction && state.pendingAction.effect.type === "prompt" && (_jsxs(Box, { paddingX: 1, children: [_jsxs(Text, { color: THEME.feedback.promptText, children: [state.pendingAction.effect.label, " "] }), _jsx(AdvancedTextInput, { value: state.pendingAction.inputValue, onChange: (value) => actions.setPendingInputValue(value), onSubmit: () => submitPendingAction(state.pendingAction, true), focus: true })] })), state.pendingAction && state.pendingAction.effect.type === "confirm" && (_jsx(Box, { paddingX: 1, children: _jsxs(Text, { color: THEME.feedback.confirmText, children: [state.pendingAction.effect.message, " (y/n)"] }) })), _jsx(ModeBar, { mode: state.mode, filterText: activePickerFilter, commandText: state.commandText, commandCursorToEndToken: state.commandCursorToEndToken, hintOverride: bottomHint, pickerSearchActive: pickers.activePicker?.pickerMode === "search", onFilterChange: handleFilterChange, onCommandChange: actions.setCommandText, onFilterSubmit: handleFilterSubmit, onCommandSubmit: handleCommandSubmit })] }) }));
 }

package/dist/src/adapters/backStackUtils.js

@@ -0,0 +1,14 @@
+/** Create `canGoBack` and `goBack` helpers for adapters that use a level + back-stack pattern. */
+export function createBackStackHelpers(getLevel, setLevel, getBackStack, setBackStack) {
+    const canGoBack = () => getBackStack().length > 0;
+    const goBack = () => {
+        const backStack = getBackStack();
+        if (backStack.length > 0) {
+            const newStack = backStack.slice(0, -1);
+            const frame = backStack[backStack.length - 1];
+            setBackStack(newStack);
+            setLevel(frame.level);
+        }
+    };
+    return { canGoBack, goBack };
+}

package/dist/src/components/DetailPanel.js

@@ -1,14 +1,12 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { Box, Text } from "ink";
 import { useTheme } from "../contexts/ThemeContext.js";
+import { clampScrollOffset, scrollIndicators } from "../utils/scrollUtils.js";
 export function DetailPanel({ title, fields, isLoading, scrollOffset, visibleLines, }) {
     const THEME = useTheme();
     const labelWidth = Math.max(...fields.map((f) => f.label.length), 12);
-    // Clamp scrollOffset to valid range
-    const clampedOffset = Math.max(0, Math.min(scrollOffset, Math.max(0, fields.length - visibleLines)));
-    // Show visible fields only
+    const clampedOffset = clampScrollOffset(scrollOffset, fields.length, visibleLines);
     const visibleFields = fields.slice(clampedOffset, clampedOffset + visibleLines);
-    const hasMoreAbove = clampedOffset > 0;
-    const hasMoreBelow = clampedOffset + visibleLines < fields.length;
+    const { hasMoreAbove, hasMoreBelow } = scrollIndicators(clampedOffset, fields.length, visibleLines);
     return (_jsxs(Box, { flexDirection: "column", paddingX: 1, paddingY: 1, children: [_jsx(Text, { bold: true, color: THEME.panel.panelTitleText, children: title }), _jsx(Text, { color: THEME.panel.panelDividerText, children: "─".repeat(40) }), isLoading ? (_jsx(Text, { color: THEME.panel.panelHintText, children: "Loading..." })) : (_jsxs(_Fragment, { children: [hasMoreAbove && (_jsxs(Text, { color: THEME.panel.panelHintText, dimColor: true, children: ["\u2191 ", clampedOffset, " more above"] })), visibleFields.map((f) => (_jsxs(Box, { children: [_jsx(Text, { color: THEME.panel.detailFieldLabelText, children: f.label.padEnd(labelWidth + 2) }), _jsx(Text, { children: f.value })] }, f.label))), hasMoreBelow && (_jsxs(Text, { color: THEME.panel.panelHintText, dimColor: true, children: ["\u2193 ", fields.length - clampedOffset - visibleLines, " more below"] }))] })), _jsx(Text, { color: THEME.panel.panelDividerText, children: "─".repeat(40) }), _jsx(Text, { color: THEME.panel.panelHintText, children: "j/k scroll \u2022 Esc close" })] }));
 }

package/dist/src/components/DiffViewer.js

@@ -1,18 +1,16 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Box, Text } from "ink";
 import { useTheme } from "../contexts/ThemeContext.js";
+import { clampScrollOffset, scrollIndicators } from "../utils/scrollUtils.js";
 export function DiffViewer({ oldValue, newValue, scrollOffset, visibleLines }) {
     const THEME = useTheme();
     const oldLines = oldValue.split("\n");
     const newLines = newValue.split("\n");
     const maxLines = Math.max(oldLines.length, newLines.length);
-    // Clamp scrollOffset to valid range
-    const clampedOffset = Math.max(0, Math.min(scrollOffset, Math.max(0, maxLines - visibleLines)));
-    // Show visible lines only
+    const clampedOffset = clampScrollOffset(scrollOffset, maxLines, visibleLines);
     const oldDisplay = oldLines.slice(clampedOffset, clampedOffset + visibleLines).join("\n");
     const newDisplay = newLines.slice(clampedOffset, clampedOffset + visibleLines).join("\n");
-    const hasMoreAbove = clampedOffset > 0;
-    const hasMoreBelow = clampedOffset + visibleLines < maxLines;
+    const { hasMoreAbove, hasMoreBelow } = scrollIndicators(clampedOffset, maxLines, visibleLines);
     // Calculate column width
     const colWidth = 35;
     return (_jsxs(Box, { flexDirection: "column", gap: 0, children: [_jsxs(Box, { gap: 2, children: [_jsx(Box, { width: colWidth, children: _jsx(Text, { color: THEME.diff.originalHeaderText, bold: true, children: "Original" }) }), _jsx(Box, { children: _jsx(Text, { color: THEME.diff.updatedHeaderText, bold: true, children: "Updated" }) })] }), _jsxs(Box, { gap: 2, children: [_jsx(Box, { width: colWidth, children: _jsx(Text, { color: THEME.diff.diffDividerText, children: "-".repeat(30) }) }), _jsx(Text, { color: THEME.diff.diffDividerText, children: "-".repeat(30) })] }), _jsxs(Box, { gap: 2, flexDirection: "column", children: [hasMoreAbove && (_jsxs(Box, { gap: 2, children: [_jsx(Box, { width: colWidth, children: _jsxs(Text, { color: THEME.diff.diffDividerText, dimColor: true, children: ["\u2191 ", clampedOffset, " lines above"] }) }), _jsxs(Text, { color: THEME.diff.diffDividerText, dimColor: true, children: ["\u2191 ", clampedOffset, " lines above"] })] })), _jsxs(Box, { gap: 2, children: [_jsx(Box, { width: colWidth, children: _jsx(Text, { children: oldDisplay }) }), _jsx(Box, { children: _jsx(Text, { children: newDisplay }) })] }), hasMoreBelow && (_jsxs(Box, { gap: 2, children: [_jsx(Box, { width: colWidth, children: _jsxs(Text, { color: THEME.diff.diffDividerText, dimColor: true, children: ["\u2193 ", maxLines - clampedOffset - visibleLines, " more lines"] }) }), _jsxs(Text, { color: THEME.diff.diffDividerText, dimColor: true, children: ["\u2193 ", maxLines - clampedOffset - visibleLines, " more lines"] })] }))] })] }));

package/dist/src/components/ErrorStatePanel.js

@@ -3,5 +3,5 @@ import { Box, Text } from "ink";
 import { useTheme } from "../contexts/ThemeContext.js";
 export function ErrorStatePanel({ title, message, hint }) {
     const THEME = useTheme();
-    return (_jsx(Box, { width: "100%", borderStyle: "round", borderColor: THEME.error.errorBorderText, children: _jsxs(Box, { flexDirection: "column", paddingX: 1, children: [_jsx(Text, { bold: true, color: THEME.error.errorTitleText, children: title }), _jsx(Text, { children: message }), hint ? _jsx(Text, { color: THEME.error.errorHintText, children: hint }) : null] }) }));
+    return (_jsx(Box, { width: "100%", borderStyle: "round", borderColor: THEME.error.errorBorderText, backgroundColor: THEME.global.mainBg, children: _jsxs(Box, { flexDirection: "column", paddingX: 1, children: [_jsx(Text, { bold: true, color: THEME.error.errorTitleText, children: title }), _jsx(Text, { children: message }), hint ? _jsx(Text, { color: THEME.error.errorHintText, children: hint }) : null] }) }));
 }

package/dist/src/components/HUD.js

@@ -2,6 +2,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import React from "react";
 import { Box, Text } from "ink";
 import { useTheme } from "../contexts/ThemeContext.js";
+import { truncateNoPad } from "../utils/textUtils.js";
 export function HUD({ serviceLabel, hudColor, path, accountName, accountId, awsProfile, currentIdentity, region, terminalWidth, loading = false, }) {
     const THEME = useTheme();
     const SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
@@ -16,7 +17,6 @@ export function HUD({ serviceLabel, hudColor, path, accountName, accountId, awsP
         }, 120);
         return () => clearInterval(timer);
     }, [loading]);
-    const truncate = (value, max) => value.length > max ? `${value.slice(0, Math.max(1, max - 1))}…` : value;
     const nameMaxLen = Math.max(8, terminalWidth - 44);
     const compactName = accountName.length > nameMaxLen ? `${accountName.slice(0, nameMaxLen - 1)}…` : accountName;
     const idPart = `(${accountId})`;
@@ -24,7 +24,7 @@ export function HUD({ serviceLabel, hudColor, path, accountName, accountId, awsP
     const leftTopRaw = `${compactName}${idPart}·${region}·${profilePart}`;
     const spinnerWidth = loading ? 1 : 0;
     const topPadLen = Math.max(0, terminalWidth - leftTopRaw.length - spinnerWidth);
-    const identityLine = truncate(currentIdentity || "-", Math.max(1, terminalWidth));
+    const identityLine = truncateNoPad(currentIdentity || "-", Math.max(1, terminalWidth));
     const identityPadLen = Math.max(0, terminalWidth - identityLine.length);
     const label = ` ${serviceLabel.toUpperCase()} `;
     const pathDisplay = ` ${path} `;

package/dist/src/components/HelpPanel.js

@@ -1,13 +1,7 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Box, Text } from "ink";
 import { useTheme } from "../contexts/ThemeContext.js";
-function truncate(text, maxLen) {
-    if (text.length <= maxLen)
-        return text;
-    if (maxLen <= 1)
-        return "…";
-    return `${text.slice(0, maxLen - 1)}…`;
-}
+import { truncateNoPad } from "../utils/textUtils.js";
 export function HelpPanel({ title, scopeLabel, tabs, activeTab, terminalWidth, maxRows, scrollOffset, }) {
     const THEME = useTheme();
     const currentTab = tabs[activeTab] ?? tabs[0];
@@ -17,7 +11,7 @@ export function HelpPanel({ title, scopeLabel, tabs, activeTab, terminalWidth, m
     const tabRow = [];
     let rowWidth = 0;
     for (let idx = 0; idx < tabs.length; idx += 1) {
-        const shortTitle = truncate(tabs[idx]?.title ?? "Tab", 10);
+        const shortTitle = truncateNoPad(tabs[idx]?.title ?? "Tab", 10);
         const label = ` ${idx + 1}:${shortTitle} `;
         if (rowWidth + label.length > maxTabRowWidth)
             break;
@@ -31,5 +25,5 @@ export function HelpPanel({ title, scopeLabel, tabs, activeTab, terminalWidth, m
                     return (_jsx(Text, { ...(isActive
                             ? { backgroundColor: THEME.panel.activeTabBg, color: THEME.panel.activeTabText }
                             : { color: THEME.panel.inactiveTabText }), bold: isActive, children: chip.label }, `chip-${chip.idx}`));
-                }) }), _jsx(Box, { flexDirection: "column", flexGrow: 1, children: visibleItems.map((item, idx) => (_jsxs(Box, { children: [_jsx(Text, { color: THEME.panel.keyText, bold: true, children: truncate(item.key, keyColWidth).padEnd(keyColWidth) }), _jsx(Text, { children: truncate(item.description, descColWidth) })] }, `${item.key}-${scrollOffset + idx}`))) })] }));
+                }) }), _jsx(Box, { flexDirection: "column", flexGrow: 1, children: visibleItems.map((item, idx) => (_jsxs(Box, { children: [_jsx(Text, { color: THEME.panel.keyText, bold: true, children: truncateNoPad(item.key, keyColWidth).padEnd(keyColWidth) }), _jsx(Text, { children: truncateNoPad(item.description, descColWidth) })] }, `${item.key}-${scrollOffset + idx}`))) })] }));
 }

package/dist/src/components/Table/index.js

@@ -3,20 +3,7 @@ import React, { useMemo } from "react";
 import { Box, Text } from "ink";
 import { computeColumnWidths } from "./widths.js";
 import { useTheme } from "../../contexts/ThemeContext.js";
-function truncate(str, maxLen) {
-    if (str.length <= maxLen)
-        return str.padEnd(maxLen);
-    return str.slice(0, maxLen - 1) + "…";
-}
-function truncateNoPad(str, maxLen) {
-    if (maxLen <= 0)
-        return "";
-    if (str.length <= maxLen)
-        return str;
-    if (maxLen === 1)
-        return "…";
-    return str.slice(0, maxLen - 1) + "…";
-}
+import { truncate, truncateNoPad } from "../../utils/textUtils.js";
 function highlightMatch(text, filter, isSelected, theme) {
     if (!filter || !text)
         return [text];

package/dist/src/components/TableSkeleton.js

@@ -3,14 +3,10 @@ import React from "react";
 import { Box, Text } from "ink";
 import { computeColumnWidths } from "./Table/widths.js";
 import { useTheme } from "../contexts/ThemeContext.js";
+import { truncate } from "../utils/textUtils.js";
 function fill(len, ch = "░") {
     return ch.repeat(Math.max(1, len));
 }
-function truncate(str, maxLen) {
-    if (str.length <= maxLen)
-        return str.padEnd(maxLen);
-    return str.slice(0, Math.max(1, maxLen - 1)) + "…";
-}
 export function TableSkeleton({ columns, terminalWidth, rows = 8, contextLabel, }) {
     const THEME = useTheme();
     const FRAMES = ["░", "▒", "▓"];

package/dist/src/components/YankHelpPanel.js

@@ -1,7 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useEffect, useState } from "react";
 import { Box, Text } from "ink";
-import { Alert, Badge, StatusMessage, UnorderedList } from "@inkjs/ui";
 import { triggerToString } from "../constants/keybindings.js";
 import { useTheme } from "../contexts/ThemeContext.js";
 export function YankHelpPanel({ options, row }) {
@@ -39,7 +38,17 @@ export function YankHelpPanel({ options, row }) {
             isActive = false;
         };
     }, [options, row]);
-    return (_jsxs(Box, { flexDirection: "column", paddingX: 1, children: [_jsx(Alert, { variant: "info", title: "Yank Options", children: "Press key to copy, Esc or ? to close" }), _jsx(Box, { height: 1 }), !row && _jsx(StatusMessage, { variant: "warning", children: "No row selected" }), _jsx(UnorderedList, { children: options.map((option) => (_jsx(UnorderedList.Item, { children: _jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { children: [_jsx(Badge, { color: THEME.panel.keyText, children: triggerToString(option.trigger) }), _jsxs(Text, { children: [" ", option.label] })] }), _jsx(Text, { color: THEME.panel.panelHintText, children: row
-                                    ? `  -> ${resolvedValues[`${option.label}-${triggerToString(option.trigger)}`] ?? "(loading...)"}`
-                                    : "  -> (no value)" })] }) }, `${option.label}-${triggerToString(option.trigger)}`))) })] }));
+    const MAX_VALUE_LEN = 45;
+    return (_jsxs(Box, { flexDirection: "column", paddingX: 1, paddingY: 0, flexGrow: 1, children: [_jsxs(Box, { gap: 2, children: [_jsx(Text, { bold: true, color: THEME.panel.panelTitleText, children: "Yank" }), _jsx(Text, { color: THEME.panel.panelDividerText, children: "Press key to copy \u00B7 Esc to close" })] }), _jsx(Text, { color: THEME.panel.panelDividerText, children: "─".repeat(36) }), !row && _jsx(Text, { color: THEME.error.errorTitleText, children: "No row selected" }), options.map((option) => {
+                const id = `${option.label}-${triggerToString(option.trigger)}`;
+                const raw = resolvedValues[id];
+                const displayValue = row
+                    ? raw != null
+                        ? raw.length > MAX_VALUE_LEN
+                            ? raw.slice(0, MAX_VALUE_LEN - 1) + "…"
+                            : raw
+                        : "(loading…)"
+                    : "(no value)";
+                return (_jsxs(Box, { children: [_jsx(Text, { color: THEME.panel.keyText, bold: true, children: triggerToString(option.trigger).padEnd(5) }), _jsx(Text, { color: THEME.panel.panelHintText, children: option.label.padEnd(16) }), _jsx(Text, { color: THEME.panel.panelDividerText, children: "→ " }), _jsx(Text, { children: displayValue })] }, id));
+            })] }));
 }

package/dist/src/features/AppMainView.integration.test.js

@@ -128,7 +128,7 @@ describe("AppMainView integration", () => {
                     resolve: async () => "x",
                 },
             ], yankHelpRow: { id: "row", cells: { name: textCell("item") } } }));
-        expect(lastFrame()).toContain("Yank Options");
+        expect(lastFrame()).toContain("Yank");
         expect(lastFrame()).toContain("copy name");
     });
 });

package/dist/src/features/AppMainView.js

@@ -67,7 +67,7 @@ export function AppMainView({ helpPanel, helpTabs, pickers, error, describeState
         error,
     ]);
     if (helpPanel.helpOpen) {
-        return (_jsx(Box, { width: "100%", borderStyle: "round", borderColor: THEME.panel.helpPanelBorderText, children: _jsx(HelpPanel, { title: "Keyboard Help", scopeLabel: "All modes reference", tabs: helpTabs, activeTab: helpPanel.helpTabIndex, terminalWidth: termCols, maxRows: helpPanel.helpVisibleRows, scrollOffset: helpPanel.helpScrollOffset }) }));
+        return (_jsx(Box, { width: "100%", borderStyle: "round", borderColor: THEME.panel.helpPanelBorderText, backgroundColor: THEME.global.mainBg, children: _jsx(HelpPanel, { title: "Keyboard Help", scopeLabel: "All modes reference", tabs: helpTabs, activeTab: helpPanel.helpTabIndex, terminalWidth: termCols, maxRows: helpPanel.helpVisibleRows, scrollOffset: helpPanel.helpScrollOffset }) }));
     }
     if (pickers.activePicker) {
         const ap = pickers.activePicker;
@@ -75,17 +75,17 @@ export function AppMainView({ helpPanel, helpTabs, pickers, error, describeState
         return (_jsx(Table, { rows: ap.filteredRows, columns: ap.columns, selectedIndex: ap.selectedIndex, filterText: ap.filter, terminalWidth: termCols, maxHeight: tableHeight, scrollOffset: ap.scrollOffset, contextLabel: ap.contextLabel }));
     }
     if (yankHelpOpen) {
-        return (_jsx(Box, { width: "100%", borderStyle: "round", borderColor: THEME.panel.yankPanelBorderText, children: _jsx(YankHelpPanel, { options: yankOptions, row: yankHelpRow }) }));
+        return (_jsx(Box, { width: "100%", borderStyle: "round", borderColor: THEME.panel.yankPanelBorderText, backgroundColor: THEME.global.mainBg, children: _jsx(YankHelpPanel, { options: yankOptions, row: yankHelpRow }) }));
     }
     if (uploadPending) {
         // Overhead: border 2 + header 4 + separators 2 + DiffViewer header+divider 2 = 10
         const diffVisibleLines = Math.max(1, tableHeight - 10);
-        return (_jsxs(Box, { width: "100%", borderStyle: "round", borderColor: THEME.upload.uploadBorderText, flexDirection: "column", children: [_jsxs(Box, { paddingX: 1, paddingY: 1, flexDirection: "column", children: [_jsx(Text, { bold: true, color: THEME.upload.uploadTitleText, children: "\u26A0 Overwrite Secret on AWS?" }), _jsx(Text, { color: THEME.upload.uploadSubtitleText, children: "This will update the secret permanently." })] }), _jsx(Box, { paddingX: 1, paddingY: 1, borderTop: true, borderColor: THEME.upload.uploadDiffDividerText, children: uploadPreview ? (_jsx(DiffViewer, { oldValue: uploadPreview.old, newValue: uploadPreview.new, scrollOffset: panelScrollOffset, visibleLines: diffVisibleLines })) : (_jsx(Text, { color: THEME.upload.uploadLoadingText, children: "Loading preview..." })) }), _jsx(Box, { paddingX: 1, paddingY: 1, borderTop: true, borderColor: THEME.upload.uploadConfirmPromptText, children: _jsxs(Text, { children: ["Press", " ", _jsx(Text, { bold: true, color: THEME.upload.uploadConfirmKeyText, children: "y" }), " ", "to confirm or", " ", _jsx(Text, { bold: true, color: THEME.upload.uploadCancelKeyText, children: "n" }), " ", "to cancel"] }) })] }));
+        return (_jsxs(Box, { width: "100%", borderStyle: "round", borderColor: THEME.upload.uploadBorderText, backgroundColor: THEME.global.mainBg, flexDirection: "column", children: [_jsxs(Box, { paddingX: 1, paddingY: 1, flexDirection: "column", children: [_jsx(Text, { bold: true, color: THEME.upload.uploadTitleText, children: "\u26A0 Overwrite Secret on AWS?" }), _jsx(Text, { color: THEME.upload.uploadSubtitleText, children: "This will update the secret permanently." })] }), _jsx(Box, { paddingX: 1, paddingY: 1, borderTop: true, borderColor: THEME.upload.uploadDiffDividerText, children: uploadPreview ? (_jsx(DiffViewer, { oldValue: uploadPreview.old, newValue: uploadPreview.new, scrollOffset: panelScrollOffset, visibleLines: diffVisibleLines })) : (_jsx(Text, { color: THEME.upload.uploadLoadingText, children: "Loading preview..." })) }), _jsx(Box, { paddingX: 1, paddingY: 1, borderTop: true, borderColor: THEME.upload.uploadConfirmPromptText, children: _jsxs(Text, { children: ["Press", " ", _jsx(Text, { bold: true, color: THEME.upload.uploadConfirmKeyText, children: "y" }), " ", "to confirm or", " ", _jsx(Text, { bold: true, color: THEME.upload.uploadCancelKeyText, children: "n" }), " ", "to cancel"] }) })] }));
     }
     if (describeState) {
         // Overhead: border 2 + title 1 + separator 1 + footer 2 = 6
         const detailVisibleLines = Math.max(1, tableHeight - 6);
-        return (_jsx(Box, { width: "100%", borderStyle: "round", borderColor: THEME.panel.detailPanelBorderText, children: _jsx(DetailPanel, { title: getCellValue(describeState.row.cells.name) ?? describeState.row.id, fields: describeState.fields ?? [], isLoading: describeState.loading, scrollOffset: panelScrollOffset, visibleLines: detailVisibleLines }) }));
+        return (_jsx(Box, { width: "100%", borderStyle: "round", borderColor: THEME.panel.detailPanelBorderText, backgroundColor: THEME.global.mainBg, children: _jsx(DetailPanel, { title: getCellValue(describeState.row.cells.name) ?? describeState.row.id, fields: describeState.fields ?? [], isLoading: describeState.loading, scrollOffset: panelScrollOffset, visibleLines: detailVisibleLines }) }));
     }
     if (isLoading) {
         return (_jsx(TableSkeleton, { columns: columns, terminalWidth: termCols, rows: 1, contextLabel: adapter.getContextLabel?.() ?? "" }));

package/dist/src/hooks/useAppController.js

@@ -1,4 +1,5 @@
-import { useCallback, useEffect, useMemo, useReducer, useRef } from "react";
+import { useMemo, useReducer } from "react";
+import { useTimedFeedback } from "./useTimedFeedback.js";
 export const initialAppControllerState = {
     mode: "navigate",
     filterText: "",
@@ -7,7 +8,6 @@ export const initialAppControllerState = {
     commandCursorToEndToken: 0,
     yankMode: false,
     yankHelpOpen: false,
-    yankFeedbackMessage: null,
     uploadPending: null,
     describeState: null,
     pendingAction: null,
@@ -31,8 +31,6 @@ export function appControllerReducer(state, action) {
             return { ...state, yankMode: action.value };
         case "setYankHelpOpen":
             return { ...state, yankHelpOpen: action.value };
-        case "setYankFeedback":
-            return { ...state, yankFeedbackMessage: action.value };
         case "setUploadPending":
             return { ...state, uploadPending: action.value };
         case "setDescribeState":
@@ -58,18 +56,7 @@ export function appControllerReducer(state, action) {
 }
 export function useAppController() {
     const [state, dispatch] = useReducer(appControllerReducer, initialAppControllerState);
-    const feedbackTimerRef = useRef(null);
-    const clearFeedbackTimer = useCallback(() => {
-        if (feedbackTimerRef.current) {
-            clearTimeout(feedbackTimerRef.current);
-            feedbackTimerRef.current = null;
-        }
-    }, []);
-    useEffect(() => {
-        return () => {
-            clearFeedbackTimer();
-        };
-    }, [clearFeedbackTimer]);
+    const { feedback: yankFeedbackMessage, pushFeedback, clearFeedback } = useTimedFeedback(1500);
     const actions = useMemo(() => ({
         setMode: (mode) => dispatch({ type: "setMode", mode }),
         setFilterText: (value) => dispatch({ type: "setFilterText", value }),
@@ -82,21 +69,12 @@ export function useAppController() {
         setDescribeState: (value) => dispatch({ type: "setDescribeState", value }),
         setPendingAction: (value) => dispatch({ type: "setPendingAction", value }),
         setPendingInputValue: (value) => dispatch({ type: "setPendingInputValue", value }),
-        clearFeedback: () => {
-            clearFeedbackTimer();
-            dispatch({ type: "setYankFeedback", value: null });
-        },
-        pushFeedback: (message, durationMs = 1500) => {
-            clearFeedbackTimer();
-            dispatch({ type: "setYankFeedback", value: message });
-            feedbackTimerRef.current = setTimeout(() => {
-                dispatch({ type: "setYankFeedback", value: null });
-                feedbackTimerRef.current = null;
-            }, durationMs);
-        },
-    }), [clearFeedbackTimer]);
+        clearFeedback,
+        pushFeedback,
+    }), [clearFeedback, pushFeedback]);
     return {
         state,
         actions,
+        yankFeedbackMessage,
     };
 }

package/dist/src/hooks/useAppData.js

@@ -4,6 +4,7 @@ import { useServiceView } from "./useServiceView.js";
 import { useNavigation } from "./useNavigation.js";
 import { usePickerManager } from "./usePickerManager.js";
 import { debugLog } from "../utils/debugLogger.js";
+import { filterRowsByText } from "../utils/rowUtils.js";
 export function useAppData({ currentService, endpointUrl, selectedRegion, tableHeight, filterText, availableRegions, availableProfiles, }) {
     const adapter = useMemo(() => {
         debugLog(currentService, `useAppData: adapter created`);
@@ -17,15 +18,7 @@ export function useAppData({ currentService, endpointUrl, selectedRegion, tableH
             "state.adapterId": rows.length > 0 ? "has-data" : "empty",
         });
     }, [rows.length, isLoading, adapter.id]);
-    const filteredRows = useMemo(() => {
-        if (!filterText)
-            return rows;
-        const lowerFilter = filterText.toLowerCase();
-        return rows.filter((row) => Object.values(row.cells).some((cell) => {
-            const value = typeof cell === "string" ? cell : cell.displayName;
-            return value.toLowerCase().includes(lowerFilter);
-        }));
-    }, [filterText, rows]);
+    const filteredRows = useMemo(() => filterRowsByText(rows, filterText), [filterText, rows]);
     const navigation = useNavigation(filteredRows.length, tableHeight);
     const selectedRow = filteredRows[navigation.selectedIndex] ?? null;
     const pickers = usePickerManager({ tableHeight, availableRegions, availableProfiles });

package/dist/src/hooks/useHelpPanel.js

@@ -4,14 +4,18 @@ export function useHelpPanel(helpTabs, helpContainerHeight) {
     const [helpTabIndex, setHelpTabIndex] = useState(0);
     const [helpScrollOffset, setHelpScrollOffset] = useState(0);
     const helpTabsCount = helpTabs.length;
+    // Rows reserved for header/footer chrome above the list
+    const SCROLL_RESERVE_ROWS = 3;
+    // Extra row for the scroll position indicator line
+    const SCROLL_INDICATOR_ROW = 1;
     // Compute visible rows from container height and current tab
-    const baseHelpVisibleRows = Math.max(1, helpContainerHeight - 3);
+    const baseHelpVisibleRows = Math.max(1, helpContainerHeight - SCROLL_RESERVE_ROWS);
     const activeHelpItemsCount = helpTabs[helpTabIndex]?.items.length ?? 0;
     const overflowRows = Math.max(0, activeHelpItemsCount - baseHelpVisibleRows);
-    const scrollReserveRows = Math.min(3, overflowRows);
+    const scrollReserveRows = Math.min(SCROLL_RESERVE_ROWS, overflowRows);
     const helpVisibleRows = overflowRows > 0
-        ? Math.max(1, baseHelpVisibleRows - scrollReserveRows - 1)
-        : Math.max(1, baseHelpVisibleRows - 1);
+        ? Math.max(1, baseHelpVisibleRows - scrollReserveRows - SCROLL_INDICATOR_ROW)
+        : Math.max(1, baseHelpVisibleRows - SCROLL_INDICATOR_ROW);
     const clampTab = useCallback((idx) => ((idx % helpTabsCount) + helpTabsCount) % helpTabsCount, [helpTabsCount]);
     const open = useCallback(() => {
         setHelpScrollOffset(0);

package/dist/src/hooks/usePickerManager.js

@@ -99,15 +99,7 @@ export function usePickerManager({ tableHeight, availableRegions, availableProfi
         ...theme,
         ...themeTable,
     };
-    const activePicker = regionEntry.open
-        ? regionEntry
-        : profileEntry.open
-            ? profileEntry
-            : resourceEntry.open
-                ? resourceEntry
-                : themeEntry.open
-                    ? themeEntry
-                    : null;
+    const activePicker = [regionEntry, profileEntry, resourceEntry, themeEntry].find((e) => e.open) ?? null;
     const getEntry = (id) => {
         switch (id) {
             case "region":

package/dist/src/hooks/usePickerTable.js

@@ -1,15 +1,8 @@
 import { useMemo } from "react";
 import { useNavigation } from "./useNavigation.js";
+import { filterRowsByText } from "../utils/rowUtils.js";
 export function usePickerTable({ rows, filterText, maxHeight }) {
-    const filteredRows = useMemo(() => {
-        if (!filterText)
-            return rows;
-        const lower = filterText.toLowerCase();
-        return rows.filter((row) => Object.values(row.cells).some((cell) => {
-            const value = typeof cell === "string" ? cell : cell.displayName;
-            return value.toLowerCase().includes(lower);
-        }));
-    }, [filterText, rows]);
+    const filteredRows = useMemo(() => filterRowsByText(rows, filterText), [filterText, rows]);
     const nav = useNavigation(filteredRows.length, maxHeight);
     const selectedRow = filteredRows[nav.selectedIndex] ?? null;
     return {

package/dist/src/hooks/useTimedFeedback.js

@@ -0,0 +1,31 @@
+import { useState, useCallback, useEffect, useRef } from "react";
+/** Manage a self-clearing feedback message with a configurable display duration. */
+export function useTimedFeedback(defaultDuration = 1500) {
+    const [feedback, setFeedback] = useState(null);
+    const timerRef = useRef(null);
+    useEffect(() => {
+        return () => {
+            if (timerRef.current)
+                clearTimeout(timerRef.current);
+        };
+    }, []);
+    const clearFeedback = useCallback(() => {
+        if (timerRef.current) {
+            clearTimeout(timerRef.current);
+            timerRef.current = null;
+        }
+        setFeedback(null);
+    }, []);
+    const pushFeedback = useCallback((message, durationMs = defaultDuration) => {
+        if (timerRef.current) {
+            clearTimeout(timerRef.current);
+            timerRef.current = null;
+        }
+        setFeedback(message);
+        timerRef.current = setTimeout(() => {
+            setFeedback(null);
+            timerRef.current = null;
+        }, durationMs);
+    }, [defaultDuration]);
+    return { feedback, pushFeedback, clearFeedback };
+}

package/dist/src/hooks/useYankMode.js

@@ -1,23 +1,14 @@
-import { useState, useCallback, useEffect } from "react";
+import { useState } from "react";
+import { useTimedFeedback } from "./useTimedFeedback.js";
 export function useYankMode() {
     const [yankMode, setYankMode] = useState(false);
-    const [yankFeedback, setYankFeedback] = useState(null);
-    useEffect(() => {
-        return () => {
-            if (yankFeedback?.timer)
-                clearTimeout(yankFeedback.timer);
-        };
-    }, [yankFeedback]);
-    const pushYankFeedback = useCallback((message, durationMs = 1500) => {
-        const timer = setTimeout(() => setYankFeedback(null), durationMs);
-        setYankFeedback({ message, timer });
-    }, []);
-    const clearYankFeedback = useCallback(() => setYankFeedback(null), []);
+    const { feedback, pushFeedback: pushYankFeedback, clearFeedback: clearYankFeedback } = useTimedFeedback(1500);
+    // Expose feedback in the same shape callers might expect
+    const yankFeedback = feedback ? { message: feedback } : null;
     return {
         yankMode,
         setYankMode,
         yankFeedback,
-        setYankFeedback,
         pushYankFeedback,
         clearYankFeedback,
     };

package/dist/src/utils/aws.js

@@ -1,6 +1,10 @@
 import { execFile } from "node:child_process";
 import { promisify } from "node:util";
 const execFileAsync = promisify(execFile);
+/** Build optional --region args for AWS CLI calls. */
+export function buildRegionArgs(region) {
+    return region ? ["--region", region] : [];
+}
 /**
  * Run an AWS CLI command asynchronously. Returns stdout or null on error/timeout.
  */

package/dist/src/utils/errorHelpers.js

@@ -0,0 +1,11 @@
+export function toErrorMessage(error) {
+    if (error instanceof Error)
+        return error.message;
+    return String(error);
+}
+export function hasCode(error, code) {
+    return Boolean(typeof error === "object" &&
+        error !== null &&
+        "code" in error &&
+        error.code === code);
+}

package/dist/src/utils/rowUtils.js

@@ -0,0 +1,10 @@
+/** Filter rows by case-insensitive substring match across all cell values. */
+export function filterRowsByText(rows, filterText) {
+    if (!filterText)
+        return rows;
+    const lower = filterText.toLowerCase();
+    return rows.filter((row) => Object.values(row.cells).some((cell) => {
+        const value = typeof cell === "string" ? cell : cell.displayName;
+        return value.toLowerCase().includes(lower);
+    }));
+}

package/dist/src/utils/scrollUtils.js

@@ -0,0 +1,11 @@
+/** Clamp a scroll offset to a valid range given total items and visible count. */
+export function clampScrollOffset(offset, totalItems, visibleCount) {
+    return Math.max(0, Math.min(offset, Math.max(0, totalItems - visibleCount)));
+}
+/** Derive scroll indicator booleans from clamped offset, total, and visible count. */
+export function scrollIndicators(offset, totalItems, visibleCount) {
+    return {
+        hasMoreAbove: offset > 0,
+        hasMoreBelow: offset + visibleCount < totalItems,
+    };
+}