/**
 * Shared TUI formatting primitives for Pisces extension notify surfaces.
 *
 * Rules:
 *  - Use `─` (U+2500) for all dividers — never `═` (U+2550).
 *  - SYM entries are the single source-of-truth for status symbols.
 *  - `check()` always emits two spaces between the symbol and the text so
 *    all check lines align regardless of which symbol is used.
 */

export const SYM = { ok: "✓", fail: "✗", warn: "⚠", skip: "·" } as const;
export type SymKey = keyof typeof SYM;

export const SEP = "─".repeat(40);

/** A single check-list line: `<sym>  <text>[  ← <hint>]` */
export function check(state: SymKey, text: string, hint?: string): string {
  return `${SYM[state]}  ${text}${hint ? `  ← ${hint}` : ""}`;
}

/** A key-value row with a 12-char padded label: `<Label>:    <value>` */
export function row(label: string, value: string): string {
  return `${(label + ":").padEnd(12)} ${value}`;
}

/**
 * Formats an ordered list of skill names as a two-column grid.
 * Each entry is prefixed with `/skill:` and columns are padded to COL_W chars.
 */
export function skillsList(skills: readonly string[]): string {
  const COL_W = 22;
  const lines: string[] = [];
  for (let i = 0; i < skills.length; i += 2) {
    const left = `/skill:${skills[i]}`.padEnd(COL_W);
    const right = skills[i + 1] ? `/skill:${skills[i + 1]}` : "";
    lines.push(`  ${left}${right}`);
  }
  return lines.join("\n");
}