@kb-labs/shared-cli-ui 2.46.0 → 2.53.0

package/dist/index.d.cts

@@ -859,9 +859,18 @@ interface SideBorderBoxOptions {
     status?: 'success' | 'error' | 'warning' | 'info';
     timing?: number;
 }
+interface RichSectionItem {
+    text: string;
+    /** Render text in muted/dim color */
+    dim?: boolean;
+    /** Hard-truncate to N visible chars instead of wrapping */
+    truncate?: number;
+}
+/** A section item — either a plain string or a rich descriptor */
+type SectionItem = string | RichSectionItem;
 interface SectionContent {
     header?: string;
-    items: string[];
+    items: SectionItem[];
 }
 /**
  * Create a side-bordered box with modern design
@@ -879,6 +888,16 @@ declare function metricsList(metrics: Record<string, string | number>): string[]
  * Format status line for footer
  */
 declare function statusLine(status: 'success' | 'error' | 'warning' | 'info', timing?: number): string;
+/**
+ * Convert an Error or raw string into clean display lines for sideBorderBox items.
+ * Splits on newlines, removes blank lines, and caps at maxLines with a "… N more" hint.
+ *
+ * @example
+ * items: formatError(err, { maxLines: 6 })
+ */
+declare function formatError(err: Error | string, opts?: {
+    maxLines?: number;
+}): string[];
 /**
  * Format command help in modern side-border style
  *
@@ -1036,4 +1055,4 @@ declare function infoResult(title: string, data?: {
     timing?: number;
 }): CommandOutput;
 
-export { type AnalyticsConfig, type ArtifactDisplayOptions, type ArtifactInfo, type BaseFlagSpec, type BooleanFlagSpec, type CLIPackage, type CommandContext, type CommandDiscovery, type CommandExecutionResult, type CommandInfo, type CommandManifest, type CommandOutput, type CommandPresenter, type CommandRegistry, type CommandResult, type CommandResultParams, type CommandRunnerOptions, type CommandSuggestion, DynamicCommandDiscovery, type EnvDefinition, type EnvSchema, type FlagDefinition, type FlagSpec, type FlagType, type FlagsDefinition, type FlagsSchema, type FormatTimestampOptions, type InferFlagsType, type KeyValueOptions, Loader, type LoaderOptions, type ManifestLoader, type MultiCLIContext, MultiCLISuggestions, type NumberFlagSpec, type RuntimeLike, type SafeKeyValueOptions, type SectionContent, type SideBorderBoxOptions, StaticCommandDiscovery, type StringFlagSpec, type TableColumn, type TableOptions, TimingTracker, accentLabel, box, bulletList, colors, createCommandDiscovery, createCommandRegistry, createCommandRunner, createDetailedResult, createKBLabsCommandDiscovery, createProgressBar, createSimpleResult, createSpinner, defineEnv, defineFlags, discoverArtifacts, displayArtifacts, displayArtifactsCompact, displaySingleArtifact, errorResult, extractCommandGroups, extractCommandIds, findCommandById, findCommandsByGroup, formatCommandHelp, formatCommandOutput, formatCommandResult, formatKeyValueTable, formatRelativeTime, formatSize, formatTable, formatTimestamp, formatTiming, formatTimingBreakdown, generateDevlinkSuggestions, generateGroupSuggestions, generateQuickActions, getCommandInfo, getContextCwd, hasAnsi, headline, indent, infoResult, isCommandAvailable, isJsonMode, keyValue, mergeFlags, metricsList, muted, pad, parseBoolean, parseEnvFromRuntime, parseFlagsFromInput, parseNumber, parseNumberFlag, parseString, safeColors, safeKeyValue, safeSymbols, section, sectionHeader, setJsonMode, showError, showLoading, showSuccess, sideBorderBox, statusLine, stripAnsi, successResult, supportsColor, symbols, table, toPosixPath, truncate, useLoader, validateSuggestions, warningResult };
+export { type AnalyticsConfig, type ArtifactDisplayOptions, type ArtifactInfo, type BaseFlagSpec, type BooleanFlagSpec, type CLIPackage, type CommandContext, type CommandDiscovery, type CommandExecutionResult, type CommandInfo, type CommandManifest, type CommandOutput, type CommandPresenter, type CommandRegistry, type CommandResult, type CommandResultParams, type CommandRunnerOptions, type CommandSuggestion, DynamicCommandDiscovery, type EnvDefinition, type EnvSchema, type FlagDefinition, type FlagSpec, type FlagType, type FlagsDefinition, type FlagsSchema, type FormatTimestampOptions, type InferFlagsType, type KeyValueOptions, Loader, type LoaderOptions, type ManifestLoader, type MultiCLIContext, MultiCLISuggestions, type NumberFlagSpec, type RichSectionItem, type RuntimeLike, type SafeKeyValueOptions, type SectionContent, type SectionItem, type SideBorderBoxOptions, StaticCommandDiscovery, type StringFlagSpec, type TableColumn, type TableOptions, TimingTracker, accentLabel, box, bulletList, colors, createCommandDiscovery, createCommandRegistry, createCommandRunner, createDetailedResult, createKBLabsCommandDiscovery, createProgressBar, createSimpleResult, createSpinner, defineEnv, defineFlags, discoverArtifacts, displayArtifacts, displayArtifactsCompact, displaySingleArtifact, errorResult, extractCommandGroups, extractCommandIds, findCommandById, findCommandsByGroup, formatCommandHelp, formatCommandOutput, formatCommandResult, formatError, formatKeyValueTable, formatRelativeTime, formatSize, formatTable, formatTimestamp, formatTiming, formatTimingBreakdown, generateDevlinkSuggestions, generateGroupSuggestions, generateQuickActions, getCommandInfo, getContextCwd, hasAnsi, headline, indent, infoResult, isCommandAvailable, isJsonMode, keyValue, mergeFlags, metricsList, muted, pad, parseBoolean, parseEnvFromRuntime, parseFlagsFromInput, parseNumber, parseNumberFlag, parseString, safeColors, safeKeyValue, safeSymbols, section, sectionHeader, setJsonMode, showError, showLoading, showSuccess, sideBorderBox, statusLine, stripAnsi, successResult, supportsColor, symbols, table, toPosixPath, truncate, useLoader, validateSuggestions, warningResult };

package/dist/index.d.ts

@@ -859,9 +859,18 @@ interface SideBorderBoxOptions {
     status?: 'success' | 'error' | 'warning' | 'info';
     timing?: number;
 }
+interface RichSectionItem {
+    text: string;
+    /** Render text in muted/dim color */
+    dim?: boolean;
+    /** Hard-truncate to N visible chars instead of wrapping */
+    truncate?: number;
+}
+/** A section item — either a plain string or a rich descriptor */
+type SectionItem = string | RichSectionItem;
 interface SectionContent {
     header?: string;
-    items: string[];
+    items: SectionItem[];
 }
 /**
  * Create a side-bordered box with modern design
@@ -879,6 +888,16 @@ declare function metricsList(metrics: Record<string, string | number>): string[]
  * Format status line for footer
  */
 declare function statusLine(status: 'success' | 'error' | 'warning' | 'info', timing?: number): string;
+/**
+ * Convert an Error or raw string into clean display lines for sideBorderBox items.
+ * Splits on newlines, removes blank lines, and caps at maxLines with a "… N more" hint.
+ *
+ * @example
+ * items: formatError(err, { maxLines: 6 })
+ */
+declare function formatError(err: Error | string, opts?: {
+    maxLines?: number;
+}): string[];
 /**
  * Format command help in modern side-border style
  *
@@ -1036,4 +1055,4 @@ declare function infoResult(title: string, data?: {
     timing?: number;
 }): CommandOutput;
 
-export { type AnalyticsConfig, type ArtifactDisplayOptions, type ArtifactInfo, type BaseFlagSpec, type BooleanFlagSpec, type CLIPackage, type CommandContext, type CommandDiscovery, type CommandExecutionResult, type CommandInfo, type CommandManifest, type CommandOutput, type CommandPresenter, type CommandRegistry, type CommandResult, type CommandResultParams, type CommandRunnerOptions, type CommandSuggestion, DynamicCommandDiscovery, type EnvDefinition, type EnvSchema, type FlagDefinition, type FlagSpec, type FlagType, type FlagsDefinition, type FlagsSchema, type FormatTimestampOptions, type InferFlagsType, type KeyValueOptions, Loader, type LoaderOptions, type ManifestLoader, type MultiCLIContext, MultiCLISuggestions, type NumberFlagSpec, type RuntimeLike, type SafeKeyValueOptions, type SectionContent, type SideBorderBoxOptions, StaticCommandDiscovery, type StringFlagSpec, type TableColumn, type TableOptions, TimingTracker, accentLabel, box, bulletList, colors, createCommandDiscovery, createCommandRegistry, createCommandRunner, createDetailedResult, createKBLabsCommandDiscovery, createProgressBar, createSimpleResult, createSpinner, defineEnv, defineFlags, discoverArtifacts, displayArtifacts, displayArtifactsCompact, displaySingleArtifact, errorResult, extractCommandGroups, extractCommandIds, findCommandById, findCommandsByGroup, formatCommandHelp, formatCommandOutput, formatCommandResult, formatKeyValueTable, formatRelativeTime, formatSize, formatTable, formatTimestamp, formatTiming, formatTimingBreakdown, generateDevlinkSuggestions, generateGroupSuggestions, generateQuickActions, getCommandInfo, getContextCwd, hasAnsi, headline, indent, infoResult, isCommandAvailable, isJsonMode, keyValue, mergeFlags, metricsList, muted, pad, parseBoolean, parseEnvFromRuntime, parseFlagsFromInput, parseNumber, parseNumberFlag, parseString, safeColors, safeKeyValue, safeSymbols, section, sectionHeader, setJsonMode, showError, showLoading, showSuccess, sideBorderBox, statusLine, stripAnsi, successResult, supportsColor, symbols, table, toPosixPath, truncate, useLoader, validateSuggestions, warningResult };
+export { type AnalyticsConfig, type ArtifactDisplayOptions, type ArtifactInfo, type BaseFlagSpec, type BooleanFlagSpec, type CLIPackage, type CommandContext, type CommandDiscovery, type CommandExecutionResult, type CommandInfo, type CommandManifest, type CommandOutput, type CommandPresenter, type CommandRegistry, type CommandResult, type CommandResultParams, type CommandRunnerOptions, type CommandSuggestion, DynamicCommandDiscovery, type EnvDefinition, type EnvSchema, type FlagDefinition, type FlagSpec, type FlagType, type FlagsDefinition, type FlagsSchema, type FormatTimestampOptions, type InferFlagsType, type KeyValueOptions, Loader, type LoaderOptions, type ManifestLoader, type MultiCLIContext, MultiCLISuggestions, type NumberFlagSpec, type RichSectionItem, type RuntimeLike, type SafeKeyValueOptions, type SectionContent, type SectionItem, type SideBorderBoxOptions, StaticCommandDiscovery, type StringFlagSpec, type TableColumn, type TableOptions, TimingTracker, accentLabel, box, bulletList, colors, createCommandDiscovery, createCommandRegistry, createCommandRunner, createDetailedResult, createKBLabsCommandDiscovery, createProgressBar, createSimpleResult, createSpinner, defineEnv, defineFlags, discoverArtifacts, displayArtifacts, displayArtifactsCompact, displaySingleArtifact, errorResult, extractCommandGroups, extractCommandIds, findCommandById, findCommandsByGroup, formatCommandHelp, formatCommandOutput, formatCommandResult, formatError, formatKeyValueTable, formatRelativeTime, formatSize, formatTable, formatTimestamp, formatTiming, formatTimingBreakdown, generateDevlinkSuggestions, generateGroupSuggestions, generateQuickActions, getCommandInfo, getContextCwd, hasAnsi, headline, indent, infoResult, isCommandAvailable, isJsonMode, keyValue, mergeFlags, metricsList, muted, pad, parseBoolean, parseEnvFromRuntime, parseFlagsFromInput, parseNumber, parseNumberFlag, parseString, safeColors, safeKeyValue, safeSymbols, section, sectionHeader, setJsonMode, showError, showLoading, showSuccess, sideBorderBox, statusLine, stripAnsi, successResult, supportsColor, symbols, table, toPosixPath, truncate, useLoader, validateSuggestions, warningResult };

package/dist/index.js

@@ -2263,6 +2263,8 @@ function toPosixPath(input) {
 function sideBorderBox(options) {
   const { title, sections, footer, status, timing } = options;
   const lines = [];
+  const terminalWidth = typeof process !== "undefined" && process.stdout?.columns ? process.stdout.columns : 80;
+  const itemMaxWidth = Math.max(40, terminalWidth - 4);
   const titleLine = `${safeSymbols.topLeft}${safeSymbols.separator.repeat(2)} ${safeColors.primary(safeColors.bold(title))}`;
   lines.push(titleLine);
   lines.push(safeSymbols.border);
@@ -2274,8 +2276,20 @@ function sideBorderBox(options) {
     if (section2.header) {
       lines.push(`${safeSymbols.border} ${safeColors.bold(section2.header)}`);
     }
-    for (const item of section2.items) {
-      lines.push(`${safeSymbols.border}  ${item}`);
+    for (const rawItem of section2.items) {
+      const item = typeof rawItem === "string" ? { text: rawItem } : rawItem;
+      let displayLines;
+      if (item.truncate !== void 0) {
+        const vis = stripAnsi(item.text);
+        const truncated = vis.length > item.truncate ? vis.slice(0, item.truncate - 1) + "\u2026" : vis;
+        displayLines = [item.dim ? safeColors.muted(truncated) : truncated];
+      } else {
+        const wrapped = wrapText(item.text, itemMaxWidth);
+        displayLines = item.dim ? wrapped.map((l) => safeColors.muted(l)) : wrapped;
+      }
+      for (const dl of displayLines) {
+        lines.push(`${safeSymbols.border}  ${dl}`);
+      }
     }
     if (i < sections.length - 1) {
       lines.push(safeSymbols.border);
@@ -2367,6 +2381,51 @@ function getStatusColor(status) {
       return safeColors.info;
   }
 }
+function wrapText(text, maxWidth) {
+  const result = [];
+  const rawLines = text.split("\n");
+  for (const rawLine of rawLines) {
+    const line = rawLine.trimEnd();
+    if (stripAnsi(line).length <= maxWidth) {
+      result.push(line);
+      continue;
+    }
+    const words = line.split(/(\s+)/);
+    let current = "";
+    for (const word of words) {
+      const test = current + word;
+      if (stripAnsi(test).length <= maxWidth) {
+        current = test;
+      } else {
+        if (current.trimEnd()) {
+          result.push(current.trimEnd());
+        }
+        const wordLen = stripAnsi(word).length;
+        if (wordLen > maxWidth) {
+          result.push(stripAnsi(word).slice(0, maxWidth - 1) + "\u2026");
+          current = "";
+        } else {
+          current = word;
+        }
+      }
+    }
+    if (current.trimEnd()) {
+      result.push(current.trimEnd());
+    }
+  }
+  return result.length > 0 ? result : [""];
+}
+function formatError(err, opts) {
+  const raw = err instanceof Error ? err.message : String(err);
+  const allLines = raw.split("\n").map((l) => l.trimEnd()).filter((l) => l.length > 0);
+  const max = opts?.maxLines ?? 8;
+  if (allLines.length <= max) {
+    return allLines;
+  }
+  const shown = allLines.slice(0, max - 1);
+  shown.push(safeColors.muted(`\u2026 ${allLines.length - max + 1} more lines`));
+  return shown;
+}
 function formatCommandHelp(options) {
   const { title, description, longDescription, examples, flags, aliases } = options;
   const sections = [];
@@ -2522,6 +2581,6 @@ function infoResult(title, data) {
   });
 }
 
-export { DebugOutput, DebugSection, DebugTrace, DebugTree, DynamicCommandDiscovery, Loader, MultiCLISuggestions, StaticCommandDiscovery, TimingTracker, accentLabel, box, bulletList, colors, createCommandDiscovery, createCommandRegistry, createCommandRunner, createDebugTree, createDetailedResult, createKBLabsCommandDiscovery, createProgressBar, createSimpleResult, createSpinner, defineEnv, defineFlags, describeEntriesAI, describeEntriesHuman, describeEntriesTimeline, discoverArtifacts, displayArtifacts, displayArtifactsCompact, displaySingleArtifact, errorResult, exportDebugEntries, exportToChromeFormat, exportToJSON, exportToPlainText, extractCommandGroups, extractCommandIds, filterByLevel, filterByNamespace, filterByTimeRange, filterDebugEntries, findCommandById, findCommandsByGroup, formatCommandHelp, formatCommandOutput, formatCommandResult, formatDebugEntriesAI, formatDebugEntriesHuman, formatDebugEntryAI, formatDebugEntryHuman, formatDebugOutput, formatDebugOutputs, formatKeyValueTable, formatRelativeTime, formatSize, formatTable, formatTimeline, formatTimelineNode, formatTimelineWithSummary, formatTimestamp, formatTiming, formatTimingBreakdown, generateDevlinkSuggestions, generateGroupSuggestions, generateQuickActions, getCommandInfo, getContextCwd, groupByGroup, groupByNamespace, hasAnsi, headline, indent, infoResult, isCommandAvailable, isJsonMode, keyValue, mergeFlags, metricsList, muted, pad, parseBoolean, parseEnvFromRuntime, parseFlagsFromInput, parseNumber, parseNumberFlag, parseString, safeColors, safeKeyValue, safeSymbols, searchInLogs, section, sectionHeader, setJsonMode, shouldUseAIFormat, showError, showLoading, showSuccess, sideBorderBox, statusLine, stripAnsi, successResult, supportsColor, symbols, table, toPosixPath, truncate, useLoader, validateSuggestions, warningResult };
+export { DebugOutput, DebugSection, DebugTrace, DebugTree, DynamicCommandDiscovery, Loader, MultiCLISuggestions, StaticCommandDiscovery, TimingTracker, accentLabel, box, bulletList, colors, createCommandDiscovery, createCommandRegistry, createCommandRunner, createDebugTree, createDetailedResult, createKBLabsCommandDiscovery, createProgressBar, createSimpleResult, createSpinner, defineEnv, defineFlags, describeEntriesAI, describeEntriesHuman, describeEntriesTimeline, discoverArtifacts, displayArtifacts, displayArtifactsCompact, displaySingleArtifact, errorResult, exportDebugEntries, exportToChromeFormat, exportToJSON, exportToPlainText, extractCommandGroups, extractCommandIds, filterByLevel, filterByNamespace, filterByTimeRange, filterDebugEntries, findCommandById, findCommandsByGroup, formatCommandHelp, formatCommandOutput, formatCommandResult, formatDebugEntriesAI, formatDebugEntriesHuman, formatDebugEntryAI, formatDebugEntryHuman, formatDebugOutput, formatDebugOutputs, formatError, formatKeyValueTable, formatRelativeTime, formatSize, formatTable, formatTimeline, formatTimelineNode, formatTimelineWithSummary, formatTimestamp, formatTiming, formatTimingBreakdown, generateDevlinkSuggestions, generateGroupSuggestions, generateQuickActions, getCommandInfo, getContextCwd, groupByGroup, groupByNamespace, hasAnsi, headline, indent, infoResult, isCommandAvailable, isJsonMode, keyValue, mergeFlags, metricsList, muted, pad, parseBoolean, parseEnvFromRuntime, parseFlagsFromInput, parseNumber, parseNumberFlag, parseString, safeColors, safeKeyValue, safeSymbols, searchInLogs, section, sectionHeader, setJsonMode, shouldUseAIFormat, showError, showLoading, showSuccess, sideBorderBox, statusLine, stripAnsi, successResult, supportsColor, symbols, table, toPosixPath, truncate, useLoader, validateSuggestions, warningResult };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map