@pokit/terminal 0.2.0

package/src/reporter/symbols.ts

@@ -0,0 +1,78 @@
+/**
+ * Symbol Sets for CLI Output
+ *
+ * Provides Unicode and ASCII symbol sets for terminal output.
+ * The appropriate set is selected based on OutputConfig.
+ */
+
+import type { OutputConfig } from '@pokit/core';
+
+/**
+ * Complete set of symbols used in CLI output
+ */
+export type SymbolSet = {
+  /** Success indicator (e.g., checkmark) */
+  success: string;
+  /** Error indicator (e.g., X mark) */
+  error: string;
+  /** Warning indicator */
+  warning: string;
+  /** Info indicator */
+  info: string;
+  /** Step/progress indicator */
+  step: string;
+  /** Group start (e.g., top-left corner) */
+  groupStart: string;
+  /** Group end (e.g., bottom-left corner) */
+  groupEnd: string;
+  /** Group line (e.g., vertical bar) */
+  groupLine: string;
+  /** Done message */
+  done: string;
+  /** Failed message */
+  failed: string;
+};
+
+/**
+ * Unicode symbols for rich terminal output
+ * Used when unicode support is detected
+ */
+export const UNICODE_SYMBOLS: SymbolSet = {
+  success: '\u25C7', // ◇
+  error: '\u25A0', // ■
+  warning: '\u25B2', // ▲
+  info: '\u25CF', // ●
+  step: '\u25C7', // ◇
+  groupStart: '\u250C', // ┌
+  groupEnd: '\u2514', // └
+  groupLine: '\u2502', // │
+  done: '\u2714', // ✔
+  failed: '\u2718', // ✘
+};
+
+/**
+ * ASCII symbols for plain text output
+ * Used in CI environments or when unicode is not supported
+ */
+export const ASCII_SYMBOLS: SymbolSet = {
+  success: '[OK]',
+  error: '[ERR]',
+  warning: '[WARN]',
+  info: '[INFO]',
+  step: '-',
+  groupStart: '[',
+  groupEnd: ']',
+  groupLine: '|',
+  done: 'Done',
+  failed: 'Failed',
+};
+
+/**
+ * Get the appropriate symbol set based on output configuration
+ *
+ * @param config - Output configuration
+ * @returns Symbol set to use
+ */
+export function getSymbols(config: OutputConfig): SymbolSet {
+  return config.unicode ? UNICODE_SYMBOLS : ASCII_SYMBOLS;
+}

package/src/screen.ts

@@ -0,0 +1,53 @@
+/**
+ * Shared terminal screen state.
+ *
+ * The terminal UI is a single screen owner. Loading indicators (spinners) are
+ * created here rather than ad-hoc inside individual prompts, so the prompter
+ * does not spawn its own competing clack spinners for dynamic selects. The
+ * reporter adapter and the prompter both belong to the same terminal UI and
+ * share this screen.
+ */
+
+import * as p from '@clack/prompts';
+import type { OutputConfig } from '@pokit/core';
+
+export interface Screen {
+  /**
+   * Run `fn` while showing a loading indicator. The indicator is the single
+   * screen-owned spinner; the prompter never creates its own.
+   */
+  withLoading<T>(message: string, fn: (signal: AbortSignal) => Promise<T>): Promise<T>;
+}
+
+function canUseInteractiveUI(outputConfig: OutputConfig): boolean {
+  return outputConfig.unicode && outputConfig.interactive;
+}
+
+/**
+ * Create the shared screen for a terminal UI instance.
+ */
+export function createScreen(outputConfig: OutputConfig): Screen {
+  const interactive = canUseInteractiveUI(outputConfig);
+
+  return {
+    async withLoading<T>(message: string, fn: (signal: AbortSignal) => Promise<T>): Promise<T> {
+      const controller = new AbortController();
+
+      if (!interactive) {
+        return fn(controller.signal);
+      }
+
+      const spinner = p.spinner();
+      spinner.start(message);
+      try {
+        const result = await fn(controller.signal);
+        spinner.stop(message);
+        return result;
+      } catch (error) {
+        controller.abort();
+        spinner.stop('Failed to load');
+        throw error;
+      }
+    },
+  };
+}