silvery 0.21.1 → 0.23.0

package/dist/{spinner-Py8_-hn9.mjs → spinner-B50hILqx.mjs}

@@ -1,5 +1,5 @@
-import { f as createStyle, j as createTerminalProfile } from "./src-Oe6x5PrS.mjs";
-import { f as isTTY, i as CURSOR_HIDE, m as write, s as CURSOR_SHOW } from "./ansi-C6Qs1Wn2.mjs";
+import { f as createStyle, j as createTerminalProfile } from "./src-B8lf1kiR.mjs";
+import { f as isTTY, i as CURSOR_HIDE, m as write, s as CURSOR_SHOW } from "./ansi-CLmIMnop.mjs";
 //#region packages/ink/src/chalk.ts
 /**
 * silvery/chalk — Drop-in chalk replacement powered by @silvery/ansi.
@@ -310,4 +310,4 @@ function createSpinner(options) {
 //#endregion
 export { chalk as a, createSpinner as i, SPINNER_INTERVALS as n, Spinner as r, SPINNER_FRAMES as t };
 
-//# sourceMappingURL=spinner-Py8_-hn9.mjs.map
+//# sourceMappingURL=spinner-B50hILqx.mjs.map

package/dist/{spinner-Py8_-hn9.mjs.map → spinner-B50hILqx.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"spinner-Py8_-hn9.mjs","names":[],"sources":["../packages/ink/src/chalk.ts","../packages/ag-react/src/ui/cli/spinner.ts"],"sourcesContent":["/**\n * silvery/chalk — Drop-in chalk replacement powered by @silvery/ansi.\n *\n * ```ts\n * // Before:\n * import chalk from 'chalk'\n *\n * // After:\n * import chalk from 'silvery/chalk'\n * ```\n *\n * The default export is a chainable styling function with chalk-compatible API.\n * Under the hood it uses @silvery/ansi — no chalk dependency.\n *\n * @packageDocumentation\n */\n\nimport { createStyle, createTerminalProfile, type Style, type ColorLevel } from \"@silvery/ansi\"\n\n// =============================================================================\n// Color tier conversion (chalk uses 0-3, silvery uses ColorLevel)\n// =============================================================================\n\ntype ChalkLevel = 0 | 1 | 2 | 3\n\nfunction toChalkLevel(cl: ColorLevel): ChalkLevel {\n  if (cl === \"mono\") return 0\n  if (cl === \"ansi16\") return 1\n  if (cl === \"256\") return 2\n  return 3 // truecolor\n}\n\nfunction fromChalkLevel(level: ChalkLevel): ColorLevel {\n  if (level === 0) return \"mono\"\n  if (level === 1) return \"ansi16\"\n  if (level === 2) return \"256\"\n  return \"truecolor\"\n}\n\n// =============================================================================\n// Default instance (auto-detected)\n// =============================================================================\n\n// Post km-silvery.plateau-delete-legacy-shims (H6): `createTerminalProfile`\n// is the canonical single-source-of-truth entry point, replacing the former\n// `detectColor()` shim. Its `colorLevel` is the resolved tier through the\n// full NO_COLOR > FORCE_COLOR > auto precedence chain.\nconst detectedColor: ColorLevel =\n  typeof process !== \"undefined\" && process.stdout\n    ? createTerminalProfile({ stdout: process.stdout }).colorLevel\n    : \"mono\"\n\n/**\n * Default chalk instance — drop-in replacement for `import chalk from 'chalk'`.\n *\n * Supports the full chainable API: `chalk.bold.red('error')`, `chalk.hex('#ff0')('hi')`, etc.\n * Also supports mutable `chalk.level` for chalk compat (0=none, 1=basic, 2=256, 3=truecolor).\n */\nconst chalk: Style = createStyle({ level: detectedColor })\nexport default chalk\n\n// =============================================================================\n// Named exports (chalk 5.x compatibility)\n// =============================================================================\n\n/**\n * Chalk constructor — creates a new style instance with a specific level.\n * Returns a callable Style (the constructor return overrides `this`).\n *\n * ```ts\n * const instance = new Chalk({ level: 3 })\n * console.log(instance.red('error'))\n * instance.level = 0 // disable colors\n * ```\n */\n// eslint-disable-next-line @typescript-eslint/no-empty-interface\nexport interface Chalk extends Style {}\nexport class Chalk {\n  constructor(options?: { level?: ChalkLevel }) {\n    // chalk compat: validate level is 0-3\n    if (options?.level !== undefined) {\n      const lvl = options.level\n      if (typeof lvl !== \"number\" || !Number.isInteger(lvl) || lvl < 0 || lvl > 3) {\n        throw new Error(\"The `level` option should be an integer from 0 to 3\")\n      }\n    }\n    // Returning an object from a constructor overrides `this` — chalk compat pattern\n    return createStyle({\n      level: fromChalkLevel(options?.level ?? toChalkLevel(detectedColor)),\n    }) as any\n  }\n}\n\nexport type ChalkInstance = Style\n\n/**\n * Color support detection for stdout.\n * Returns false if no color, or an object with the chalk level.\n */\nconst detectedLevel = toChalkLevel(detectedColor)\nexport const supportsColor: false | { level: ChalkLevel } =\n  detectedLevel === 0 ? false : { level: detectedLevel }\n\n/**\n * Color support detection for stderr.\n */\nexport const supportsColorStderr: false | { level: ChalkLevel } = (() => {\n  if (!process?.stderr) return false\n  // stderr gets its own profile pass — a pipe may have different TTY state\n  // than stdout (though in practice they track together). `createTerminalProfile`\n  // accepts any `{ isTTY?: boolean }` structural shape.\n  const level = toChalkLevel(createTerminalProfile({ stdout: process.stderr }).colorLevel)\n  return level === 0 ? false : { level }\n})()\n\n// =============================================================================\n// Chalk name lists (for programmatic access)\n// =============================================================================\n\nexport const modifierNames = [\n  \"reset\",\n  \"bold\",\n  \"dim\",\n  \"italic\",\n  \"underline\",\n  \"overline\",\n  \"inverse\",\n  \"hidden\",\n  \"strikethrough\",\n  \"visible\",\n] as const\n\nexport const foregroundColorNames = [\n  \"black\",\n  \"red\",\n  \"green\",\n  \"yellow\",\n  \"blue\",\n  \"magenta\",\n  \"cyan\",\n  \"white\",\n  \"gray\",\n  \"grey\",\n  \"blackBright\",\n  \"redBright\",\n  \"greenBright\",\n  \"yellowBright\",\n  \"blueBright\",\n  \"magentaBright\",\n  \"cyanBright\",\n  \"whiteBright\",\n] as const\n\nexport const backgroundColorNames = [\n  \"bgBlack\",\n  \"bgRed\",\n  \"bgGreen\",\n  \"bgYellow\",\n  \"bgBlue\",\n  \"bgMagenta\",\n  \"bgCyan\",\n  \"bgWhite\",\n  \"bgGray\",\n  \"bgGrey\",\n  \"bgBlackBright\",\n  \"bgRedBright\",\n  \"bgGreenBright\",\n  \"bgYellowBright\",\n  \"bgBlueBright\",\n  \"bgMagentaBright\",\n  \"bgCyanBright\",\n  \"bgWhiteBright\",\n] as const\n\nexport const colorNames = [...foregroundColorNames, ...backgroundColorNames] as const\n\n// Re-export detection utilities that chalk users often need.\n// Post H6 (km-silvery.plateau-delete-legacy-shims): `detectColor` is gone —\n// chalk users reach for `createTerminalProfile` instead (it's a one-shot\n// call that returns a full TerminalProfile, of which `colorLevel` is one\n// field).\nexport { createTerminalProfile, toChalkLevel, fromChalkLevel }\nexport type { ColorLevel, ChalkLevel }\n","/**\n * CLI Spinner - Animated indeterminate progress indicator\n */\n\nimport chalk from \"@silvery/ink/chalk\"\nimport type { SpinnerOptions, SpinnerStyle } from \"../types.js\"\nimport { CURSOR_HIDE, CURSOR_SHOW, CURSOR_TO_START, CLEAR_LINE_END, write, isTTY } from \"./ansi\"\n\n/** Spinner animation frames by style */\nexport const SPINNER_FRAMES: Record<SpinnerStyle, string[]> = {\n  dots: [\"⠋\", \"⠙\", \"⠹\", \"⠸\", \"⠼\", \"⠴\", \"⠦\", \"⠧\", \"⠇\", \"⠏\"],\n  line: [\"-\", \"\\\\\", \"|\", \"/\"],\n  arc: [\"◜\", \"◠\", \"◝\", \"◞\", \"◡\", \"◟\"],\n  bounce: [\"⠁\", \"⠂\", \"⠄\", \"⠂\"],\n  pulse: [\"█\", \"▓\", \"▒\", \"░\", \"▒\", \"▓\"],\n}\n\n/** Default intervals for each style (ms) */\nexport const SPINNER_INTERVALS: Record<SpinnerStyle, number> = {\n  dots: 80,\n  line: 120,\n  arc: 100,\n  bounce: 120,\n  pulse: 100,\n}\n\n/**\n * Spinner class for CLI progress indication\n *\n * @example\n * ```ts\n * const spinner = new Spinner(\"Loading...\");\n * spinner.start();\n * await doWork();\n * spinner.succeed(\"Done!\");\n * ```\n */\nexport class Spinner {\n  private text: string\n  private style: SpinnerStyle\n  private color: string\n  private stream: NodeJS.WriteStream\n  private hideCursor: boolean\n  private interval: number\n\n  private frameIndex = 0\n  private timer: ReturnType<typeof setInterval> | null = null\n  private isSpinning = false\n\n  constructor(textOrOptions?: string | SpinnerOptions) {\n    const options: SpinnerOptions =\n      typeof textOrOptions === \"string\" ? { text: textOrOptions } : (textOrOptions ?? {})\n\n    this.text = options.text ?? \"\"\n    this.style = options.style ?? \"dots\"\n    this.color = options.color ?? \"cyan\"\n    this.stream = options.stream ?? process.stdout\n    this.hideCursor = options.hideCursor ?? true\n    this.interval = options.interval ?? SPINNER_INTERVALS[this.style]\n  }\n\n  /** Get current spinner text */\n  get currentText(): string {\n    return this.text\n  }\n\n  /** Set spinner text (updates immediately if spinning) */\n  set currentText(value: string) {\n    this.text = value\n    if (this.isSpinning) {\n      this.render()\n    }\n  }\n\n  /** Check if spinner is currently active */\n  get spinning(): boolean {\n    return this.isSpinning\n  }\n\n  /**\n   * Start the spinner animation\n   */\n  start(text?: string): this {\n    if (text !== undefined) {\n      this.text = text\n    }\n\n    if (this.isSpinning) {\n      return this\n    }\n\n    this.isSpinning = true\n    this.frameIndex = 0\n\n    if (this.hideCursor && isTTY(this.stream)) {\n      write(CURSOR_HIDE, this.stream)\n    }\n\n    this.render()\n    this.timer = setInterval(() => {\n      this.frameIndex = (this.frameIndex + 1) % SPINNER_FRAMES[this.style].length\n      this.render()\n    }, this.interval)\n\n    return this\n  }\n\n  /**\n   * Stop the spinner\n   */\n  stop(): this {\n    if (!this.isSpinning) {\n      return this\n    }\n\n    this.isSpinning = false\n\n    if (this.timer) {\n      clearInterval(this.timer)\n      this.timer = null\n    }\n\n    this.clear()\n\n    if (this.hideCursor && isTTY(this.stream)) {\n      write(CURSOR_SHOW, this.stream)\n    }\n\n    return this\n  }\n\n  /**\n   * Stop with success message (green checkmark)\n   */\n  succeed(text?: string): this {\n    return this.stopWithSymbol(chalk.green(\"✔\"), text ?? this.text)\n  }\n\n  /**\n   * Stop with failure message (red X)\n   */\n  fail(text?: string): this {\n    return this.stopWithSymbol(chalk.red(\"✖\"), text ?? this.text)\n  }\n\n  /**\n   * Stop with warning message (yellow warning)\n   */\n  warn(text?: string): this {\n    return this.stopWithSymbol(chalk.yellow(\"⚠\"), text ?? this.text)\n  }\n\n  /**\n   * Stop with info message (blue info)\n   */\n  info(text?: string): this {\n    return this.stopWithSymbol(chalk.blue(\"ℹ\"), text ?? this.text)\n  }\n\n  /**\n   * Clear the spinner line\n   */\n  clear(): this {\n    if (isTTY(this.stream)) {\n      write(`${CURSOR_TO_START}${CLEAR_LINE_END}`, this.stream)\n    }\n    return this\n  }\n\n  private render(): void {\n    const frame = SPINNER_FRAMES[this.style][this.frameIndex]\n    const colorFn = (chalk as unknown as Record<string, (s: string) => string>)[this.color]\n    const coloredFrame = colorFn ? colorFn(frame!) : frame!\n    const output = this.text ? `${coloredFrame} ${this.text}` : coloredFrame\n\n    if (isTTY(this.stream)) {\n      write(`${CURSOR_TO_START}${output}${CLEAR_LINE_END}`, this.stream)\n    }\n  }\n\n  private stopWithSymbol(symbol: string, text: string): this {\n    this.stop()\n    write(`${symbol} ${text}\\n`, this.stream)\n    return this\n  }\n\n  /**\n   * Dispose the spinner (calls stop)\n   */\n  [Symbol.dispose](): void {\n    this.stop()\n  }\n\n  /**\n   * Static helper to quickly start a spinner\n   * Returns a stop function\n   *\n   * @example\n   * ```ts\n   * const stop = Spinner.start(\"Loading...\");\n   * await doWork();\n   * stop();\n   * ```\n   */\n  static start(textOrOptions?: string | SpinnerOptions): () => void {\n    const spinner = new Spinner(textOrOptions)\n    spinner.start()\n    return () => spinner.stop()\n  }\n}\n\n/**\n * Callable spinner interface - call with text to show/update\n *\n * @example\n * ```ts\n * {\n *   using spinner = createSpinner({ style: \"dots\" });\n *   spinner(\"Loading...\");  // Shows spinner with text\n *   spinner(\"Still loading...\");  // Updates text\n * } // Auto-stops via Symbol.dispose\n * ```\n */\nexport interface CallableSpinner extends Disposable {\n  /** Call with text to show/update the spinner */\n  (text: string): void\n  /** Stop the spinner */\n  stop(): void\n  /** Stop with success message (green checkmark) */\n  succeed(text?: string): void\n  /** Stop with failure message (red X) */\n  fail(text?: string): void\n  /** Stop with warning message (yellow warning) */\n  warn(text?: string): void\n  /** Stop with info message (blue info) */\n  info(text?: string): void\n}\n\n/**\n * Create a callable, disposable spinner\n *\n * The spinner is lazy - it won't show anything until you call it with text.\n * Use with `using` for automatic cleanup:\n *\n * @example\n * ```ts\n * {\n *   using spinner = createSpinner({ style: \"dots\" });\n *   // Nothing visible yet\n *\n *   spinner(\"Loading repo...\");  // Now shows spinner\n *   spinner(\"Applying events...\");  // Updates text\n * } // Auto-stops via Symbol.dispose\n * ```\n */\nexport function createSpinner(options?: SpinnerOptions): CallableSpinner {\n  const spinner = new Spinner({ ...options, text: \"\" })\n\n  const callable = ((text: string) => {\n    // Always restart if not spinning (handles initial call and after succeed/fail/etc)\n    if (!spinner.spinning) {\n      spinner.start(text)\n    } else {\n      spinner.currentText = text\n    }\n  }) as CallableSpinner\n\n  callable.stop = () => spinner.stop()\n  callable.succeed = (text) => spinner.succeed(text)\n  callable.fail = (text) => spinner.fail(text)\n  callable.warn = (text) => spinner.warn(text)\n  callable.info = (text) => spinner.info(text)\n  callable[Symbol.dispose] = () => spinner.stop()\n\n  return callable\n}\n"],"mappings":"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"}
+{"version":3,"file":"spinner-B50hILqx.mjs","names":[],"sources":["../packages/ink/src/chalk.ts","../packages/ag-react/src/ui/cli/spinner.ts"],"sourcesContent":["/**\n * silvery/chalk — Drop-in chalk replacement powered by @silvery/ansi.\n *\n * ```ts\n * // Before:\n * import chalk from 'chalk'\n *\n * // After:\n * import chalk from 'silvery/chalk'\n * ```\n *\n * The default export is a chainable styling function with chalk-compatible API.\n * Under the hood it uses @silvery/ansi — no chalk dependency.\n *\n * @packageDocumentation\n */\n\nimport { createStyle, createTerminalProfile, type Style, type ColorLevel } from \"@silvery/ansi\"\n\n// =============================================================================\n// Color tier conversion (chalk uses 0-3, silvery uses ColorLevel)\n// =============================================================================\n\ntype ChalkLevel = 0 | 1 | 2 | 3\n\nfunction toChalkLevel(cl: ColorLevel): ChalkLevel {\n  if (cl === \"mono\") return 0\n  if (cl === \"ansi16\") return 1\n  if (cl === \"256\") return 2\n  return 3 // truecolor\n}\n\nfunction fromChalkLevel(level: ChalkLevel): ColorLevel {\n  if (level === 0) return \"mono\"\n  if (level === 1) return \"ansi16\"\n  if (level === 2) return \"256\"\n  return \"truecolor\"\n}\n\n// =============================================================================\n// Default instance (auto-detected)\n// =============================================================================\n\n// Post km-silvery.plateau-delete-legacy-shims (H6): `createTerminalProfile`\n// is the canonical single-source-of-truth entry point, replacing the former\n// `detectColor()` shim. Its `colorLevel` is the resolved tier through the\n// full FORCE_COLOR > NO_COLOR > auto precedence chain.\nconst detectedColor: ColorLevel =\n  typeof process !== \"undefined\" && process.stdout\n    ? createTerminalProfile({ stdout: process.stdout }).colorLevel\n    : \"mono\"\n\n/**\n * Default chalk instance — drop-in replacement for `import chalk from 'chalk'`.\n *\n * Supports the full chainable API: `chalk.bold.red('error')`, `chalk.hex('#ff0')('hi')`, etc.\n * Also supports mutable `chalk.level` for chalk compat (0=none, 1=basic, 2=256, 3=truecolor).\n */\nconst chalk: Style = createStyle({ level: detectedColor })\nexport default chalk\n\n// =============================================================================\n// Named exports (chalk 5.x compatibility)\n// =============================================================================\n\n/**\n * Chalk constructor — creates a new style instance with a specific level.\n * Returns a callable Style (the constructor return overrides `this`).\n *\n * ```ts\n * const instance = new Chalk({ level: 3 })\n * console.log(instance.red('error'))\n * instance.level = 0 // disable colors\n * ```\n */\n// eslint-disable-next-line @typescript-eslint/no-empty-interface\nexport interface Chalk extends Style {}\nexport class Chalk {\n  constructor(options?: { level?: ChalkLevel }) {\n    // chalk compat: validate level is 0-3\n    if (options?.level !== undefined) {\n      const lvl = options.level\n      if (typeof lvl !== \"number\" || !Number.isInteger(lvl) || lvl < 0 || lvl > 3) {\n        throw new Error(\"The `level` option should be an integer from 0 to 3\")\n      }\n    }\n    // Returning an object from a constructor overrides `this` — chalk compat pattern\n    return createStyle({\n      level: fromChalkLevel(options?.level ?? toChalkLevel(detectedColor)),\n    }) as any\n  }\n}\n\nexport type ChalkInstance = Style\n\n/**\n * Color support detection for stdout.\n * Returns false if no color, or an object with the chalk level.\n */\nconst detectedLevel = toChalkLevel(detectedColor)\nexport const supportsColor: false | { level: ChalkLevel } =\n  detectedLevel === 0 ? false : { level: detectedLevel }\n\n/**\n * Color support detection for stderr.\n */\nexport const supportsColorStderr: false | { level: ChalkLevel } = (() => {\n  if (!process?.stderr) return false\n  // stderr gets its own profile pass — a pipe may have different TTY state\n  // than stdout (though in practice they track together). `createTerminalProfile`\n  // accepts any `{ isTTY?: boolean }` structural shape.\n  const level = toChalkLevel(createTerminalProfile({ stdout: process.stderr }).colorLevel)\n  return level === 0 ? false : { level }\n})()\n\n// =============================================================================\n// Chalk name lists (for programmatic access)\n// =============================================================================\n\nexport const modifierNames = [\n  \"reset\",\n  \"bold\",\n  \"dim\",\n  \"italic\",\n  \"underline\",\n  \"overline\",\n  \"inverse\",\n  \"hidden\",\n  \"strikethrough\",\n  \"visible\",\n] as const\n\nexport const foregroundColorNames = [\n  \"black\",\n  \"red\",\n  \"green\",\n  \"yellow\",\n  \"blue\",\n  \"magenta\",\n  \"cyan\",\n  \"white\",\n  \"gray\",\n  \"grey\",\n  \"blackBright\",\n  \"redBright\",\n  \"greenBright\",\n  \"yellowBright\",\n  \"blueBright\",\n  \"magentaBright\",\n  \"cyanBright\",\n  \"whiteBright\",\n] as const\n\nexport const backgroundColorNames = [\n  \"bgBlack\",\n  \"bgRed\",\n  \"bgGreen\",\n  \"bgYellow\",\n  \"bgBlue\",\n  \"bgMagenta\",\n  \"bgCyan\",\n  \"bgWhite\",\n  \"bgGray\",\n  \"bgGrey\",\n  \"bgBlackBright\",\n  \"bgRedBright\",\n  \"bgGreenBright\",\n  \"bgYellowBright\",\n  \"bgBlueBright\",\n  \"bgMagentaBright\",\n  \"bgCyanBright\",\n  \"bgWhiteBright\",\n] as const\n\nexport const colorNames = [...foregroundColorNames, ...backgroundColorNames] as const\n\n// Re-export detection utilities that chalk users often need.\n// Post H6 (km-silvery.plateau-delete-legacy-shims): `detectColor` is gone —\n// chalk users reach for `createTerminalProfile` instead (it's a one-shot\n// call that returns a full TerminalProfile, of which `colorLevel` is one\n// field).\nexport { createTerminalProfile, toChalkLevel, fromChalkLevel }\nexport type { ColorLevel, ChalkLevel }\n","/**\n * CLI Spinner - Animated indeterminate progress indicator\n */\n\nimport chalk from \"@silvery/ink/chalk\"\nimport type { SpinnerOptions, SpinnerStyle } from \"../types.js\"\nimport { CURSOR_HIDE, CURSOR_SHOW, CURSOR_TO_START, CLEAR_LINE_END, write, isTTY } from \"./ansi\"\n\n/** Spinner animation frames by style */\nexport const SPINNER_FRAMES: Record<SpinnerStyle, string[]> = {\n  dots: [\"⠋\", \"⠙\", \"⠹\", \"⠸\", \"⠼\", \"⠴\", \"⠦\", \"⠧\", \"⠇\", \"⠏\"],\n  line: [\"-\", \"\\\\\", \"|\", \"/\"],\n  arc: [\"◜\", \"◠\", \"◝\", \"◞\", \"◡\", \"◟\"],\n  bounce: [\"⠁\", \"⠂\", \"⠄\", \"⠂\"],\n  pulse: [\"█\", \"▓\", \"▒\", \"░\", \"▒\", \"▓\"],\n}\n\n/** Default intervals for each style (ms) */\nexport const SPINNER_INTERVALS: Record<SpinnerStyle, number> = {\n  dots: 80,\n  line: 120,\n  arc: 100,\n  bounce: 120,\n  pulse: 100,\n}\n\n/**\n * Spinner class for CLI progress indication\n *\n * @example\n * ```ts\n * const spinner = new Spinner(\"Loading...\");\n * spinner.start();\n * await doWork();\n * spinner.succeed(\"Done!\");\n * ```\n */\nexport class Spinner {\n  private text: string\n  private style: SpinnerStyle\n  private color: string\n  private stream: NodeJS.WriteStream\n  private hideCursor: boolean\n  private interval: number\n\n  private frameIndex = 0\n  private timer: ReturnType<typeof setInterval> | null = null\n  private isSpinning = false\n\n  constructor(textOrOptions?: string | SpinnerOptions) {\n    const options: SpinnerOptions =\n      typeof textOrOptions === \"string\" ? { text: textOrOptions } : (textOrOptions ?? {})\n\n    this.text = options.text ?? \"\"\n    this.style = options.style ?? \"dots\"\n    this.color = options.color ?? \"cyan\"\n    this.stream = options.stream ?? process.stdout\n    this.hideCursor = options.hideCursor ?? true\n    this.interval = options.interval ?? SPINNER_INTERVALS[this.style]\n  }\n\n  /** Get current spinner text */\n  get currentText(): string {\n    return this.text\n  }\n\n  /** Set spinner text (updates immediately if spinning) */\n  set currentText(value: string) {\n    this.text = value\n    if (this.isSpinning) {\n      this.render()\n    }\n  }\n\n  /** Check if spinner is currently active */\n  get spinning(): boolean {\n    return this.isSpinning\n  }\n\n  /**\n   * Start the spinner animation\n   */\n  start(text?: string): this {\n    if (text !== undefined) {\n      this.text = text\n    }\n\n    if (this.isSpinning) {\n      return this\n    }\n\n    this.isSpinning = true\n    this.frameIndex = 0\n\n    if (this.hideCursor && isTTY(this.stream)) {\n      write(CURSOR_HIDE, this.stream)\n    }\n\n    this.render()\n    this.timer = setInterval(() => {\n      this.frameIndex = (this.frameIndex + 1) % SPINNER_FRAMES[this.style].length\n      this.render()\n    }, this.interval)\n\n    return this\n  }\n\n  /**\n   * Stop the spinner\n   */\n  stop(): this {\n    if (!this.isSpinning) {\n      return this\n    }\n\n    this.isSpinning = false\n\n    if (this.timer) {\n      clearInterval(this.timer)\n      this.timer = null\n    }\n\n    this.clear()\n\n    if (this.hideCursor && isTTY(this.stream)) {\n      write(CURSOR_SHOW, this.stream)\n    }\n\n    return this\n  }\n\n  /**\n   * Stop with success message (green checkmark)\n   */\n  succeed(text?: string): this {\n    return this.stopWithSymbol(chalk.green(\"✔\"), text ?? this.text)\n  }\n\n  /**\n   * Stop with failure message (red X)\n   */\n  fail(text?: string): this {\n    return this.stopWithSymbol(chalk.red(\"✖\"), text ?? this.text)\n  }\n\n  /**\n   * Stop with warning message (yellow warning)\n   */\n  warn(text?: string): this {\n    return this.stopWithSymbol(chalk.yellow(\"⚠\"), text ?? this.text)\n  }\n\n  /**\n   * Stop with info message (blue info)\n   */\n  info(text?: string): this {\n    return this.stopWithSymbol(chalk.blue(\"ℹ\"), text ?? this.text)\n  }\n\n  /**\n   * Clear the spinner line\n   */\n  clear(): this {\n    if (isTTY(this.stream)) {\n      write(`${CURSOR_TO_START}${CLEAR_LINE_END}`, this.stream)\n    }\n    return this\n  }\n\n  private render(): void {\n    const frame = SPINNER_FRAMES[this.style][this.frameIndex]\n    const colorFn = (chalk as unknown as Record<string, (s: string) => string>)[this.color]\n    const coloredFrame = colorFn ? colorFn(frame!) : frame!\n    const output = this.text ? `${coloredFrame} ${this.text}` : coloredFrame\n\n    if (isTTY(this.stream)) {\n      write(`${CURSOR_TO_START}${output}${CLEAR_LINE_END}`, this.stream)\n    }\n  }\n\n  private stopWithSymbol(symbol: string, text: string): this {\n    this.stop()\n    write(`${symbol} ${text}\\n`, this.stream)\n    return this\n  }\n\n  /**\n   * Dispose the spinner (calls stop)\n   */\n  [Symbol.dispose](): void {\n    this.stop()\n  }\n\n  /**\n   * Static helper to quickly start a spinner\n   * Returns a stop function\n   *\n   * @example\n   * ```ts\n   * const stop = Spinner.start(\"Loading...\");\n   * await doWork();\n   * stop();\n   * ```\n   */\n  static start(textOrOptions?: string | SpinnerOptions): () => void {\n    const spinner = new Spinner(textOrOptions)\n    spinner.start()\n    return () => spinner.stop()\n  }\n}\n\n/**\n * Callable spinner interface - call with text to show/update\n *\n * @example\n * ```ts\n * {\n *   using spinner = createSpinner({ style: \"dots\" });\n *   spinner(\"Loading...\");  // Shows spinner with text\n *   spinner(\"Still loading...\");  // Updates text\n * } // Auto-stops via Symbol.dispose\n * ```\n */\nexport interface CallableSpinner extends Disposable {\n  /** Call with text to show/update the spinner */\n  (text: string): void\n  /** Stop the spinner */\n  stop(): void\n  /** Stop with success message (green checkmark) */\n  succeed(text?: string): void\n  /** Stop with failure message (red X) */\n  fail(text?: string): void\n  /** Stop with warning message (yellow warning) */\n  warn(text?: string): void\n  /** Stop with info message (blue info) */\n  info(text?: string): void\n}\n\n/**\n * Create a callable, disposable spinner\n *\n * The spinner is lazy - it won't show anything until you call it with text.\n * Use with `using` for automatic cleanup:\n *\n * @example\n * ```ts\n * {\n *   using spinner = createSpinner({ style: \"dots\" });\n *   // Nothing visible yet\n *\n *   spinner(\"Loading repo...\");  // Now shows spinner\n *   spinner(\"Applying events...\");  // Updates text\n * } // Auto-stops via Symbol.dispose\n * ```\n */\nexport function createSpinner(options?: SpinnerOptions): CallableSpinner {\n  const spinner = new Spinner({ ...options, text: \"\" })\n\n  const callable = ((text: string) => {\n    // Always restart if not spinning (handles initial call and after succeed/fail/etc)\n    if (!spinner.spinning) {\n      spinner.start(text)\n    } else {\n      spinner.currentText = text\n    }\n  }) as CallableSpinner\n\n  callable.stop = () => spinner.stop()\n  callable.succeed = (text) => spinner.succeed(text)\n  callable.fail = (text) => spinner.fail(text)\n  callable.warn = (text) => spinner.warn(text)\n  callable.info = (text) => spinner.info(text)\n  callable[Symbol.dispose] = () => spinner.stop()\n\n  return callable\n}\n"],"mappings":"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"}

package/dist/{spinner-CLgzJ_QF.d.mts → spinner-DN10UfF0.d.mts}

@@ -1,4 +1,4 @@
-import { c as SpinnerOptions, u as SpinnerStyle } from "./types-Bx-XZNbE.mjs";
+import { c as SpinnerOptions, u as SpinnerStyle } from "./types-D_E0FbqA.mjs";
 
 //#region packages/ag-react/src/ui/cli/spinner.d.ts
 /** Spinner animation frames by style */
@@ -124,4 +124,4 @@ interface CallableSpinner extends Disposable {
 declare function createSpinner(options?: SpinnerOptions): CallableSpinner;
 //#endregion
 export { createSpinner as i, SPINNER_FRAMES as n, Spinner as r, CallableSpinner as t };
-//# sourceMappingURL=spinner-CLgzJ_QF.d.mts.map
+//# sourceMappingURL=spinner-DN10UfF0.d.mts.map

package/dist/{spinner-CLgzJ_QF.d.mts.map → spinner-DN10UfF0.d.mts.map}

@@ -1 +1 @@
-{"version":3,"file":"spinner-CLgzJ_QF.d.mts","names":[],"sources":["../packages/ag-react/src/ui/cli/spinner.ts"],"mappings":";;;;cASa,cAAA,EAAgB,MAAA,CAAO,YAAA;AA4BpC;;;;;;;;;;;AAAA,cAAa,OAAA;EAAA,QACH,IAAA;EAAA,QACA,KAAA;EAAA,QACA,KAAA;EAAA,QACA,MAAA;EAAA,QACA,UAAA;EAAA,QACA,QAAA;EAAA,QAEA,UAAA;EAAA,QACA,KAAA;EAAA,QACA,UAAA;cAEI,aAAA,YAAyB,cAAA;EAkBrB;EAAA,IALZ,WAAA,CAAA;EAoBJ;EAAA,IAfI,WAAA,CAAY,KAAA;EA2ChB;EAAA,IAnCI,QAAA,CAAA;EA2DI;;;EApDR,KAAA,CAAM,IAAA;EAkED;;;EAtCL,IAAA,CAAA;EA2DQ;;;EAnCR,OAAA,CAAQ,IAAA;EAsED;;;EA/DP,IAAA,CAAK,IAAA;EA+D+C;AAmBtD;;EA3EE,IAAA,CAAK,IAAA;EA2E4C;;;EApEjD,IAAA,CAAK,IAAA;EA0EL;;;EAnEA,KAAA,CAAA;EAAA,QAOQ,MAAA;EAAA,QAWA,cAAA;EAuDR;;;EAAA,CA9CC,MAAA,CAAO,OAAA;EAkEM;;;;;;;;;;;EAAA,OAnDP,KAAA,CAAM,aAAA,YAAyB,cAAA;AAAA;;;;;;;;;;;;;UAmBvB,eAAA,SAAwB,UAAA;;GAEtC,IAAA;;EAED,IAAA;;EAEA,OAAA,CAAQ,IAAA;;EAER,IAAA,CAAK,IAAA;;EAEL,IAAA,CAAK,IAAA;;EAEL,IAAA,CAAK,IAAA;AAAA;;;;;;;;;;;;;;;;;;iBAoBS,aAAA,CAAc,OAAA,GAAU,cAAA,GAAiB,eAAA"}
+{"version":3,"file":"spinner-DN10UfF0.d.mts","names":[],"sources":["../packages/ag-react/src/ui/cli/spinner.ts"],"mappings":";;;;cASa,cAAA,EAAgB,MAAA,CAAO,YAAA;AA4BpC;;;;;;;;;;;AAAA,cAAa,OAAA;EAAA,QACH,IAAA;EAAA,QACA,KAAA;EAAA,QACA,KAAA;EAAA,QACA,MAAA;EAAA,QACA,UAAA;EAAA,QACA,QAAA;EAAA,QAEA,UAAA;EAAA,QACA,KAAA;EAAA,QACA,UAAA;cAEI,aAAA,YAAyB,cAAA;EAkBrB;EAAA,IALZ,WAAA,CAAA;EAoBJ;EAAA,IAfI,WAAA,CAAY,KAAA;EA2ChB;EAAA,IAnCI,QAAA,CAAA;EA2DI;;;EApDR,KAAA,CAAM,IAAA;EAkED;;;EAtCL,IAAA,CAAA;EA2DQ;;;EAnCR,OAAA,CAAQ,IAAA;EAsED;;;EA/DP,IAAA,CAAK,IAAA;EA+D+C;AAmBtD;;EA3EE,IAAA,CAAK,IAAA;EA2E4C;;;EApEjD,IAAA,CAAK,IAAA;EA0EL;;;EAnEA,KAAA,CAAA;EAAA,QAOQ,MAAA;EAAA,QAWA,cAAA;EAuDR;;;EAAA,CA9CC,MAAA,CAAO,OAAA;EAkEM;;;;;;;;;;;EAAA,OAnDP,KAAA,CAAM,aAAA,YAAyB,cAAA;AAAA;;;;;;;;;;;;;UAmBvB,eAAA,SAAwB,UAAA;;GAEtC,IAAA;;EAED,IAAA;;EAEA,OAAA,CAAQ,IAAA;;EAER,IAAA,CAAK,IAAA;;EAEL,IAAA,CAAK,IAAA;;EAEL,IAAA,CAAK,IAAA;AAAA;;;;;;;;;;;;;;;;;;iBAoBS,aAAA,CAAc,OAAA,GAAU,cAAA,GAAiB,eAAA"}

package/dist/{src-Oe6x5PrS.mjs → src-B8lf1kiR.mjs}

@@ -1,4 +1,4 @@
-import { blend, brighten, checkContrast, colorDistance, complement, contrastFg, darken, deltaE, ensureContrast, hexToOklch, hexToRgb as hexToRgb$1, oklchToHex, relativeLuminance } from "@silvery/color";
+import { blend, brighten, checkContrast, colorDistance, complement, contrastFg, darken, deltaE, ensureContrast, hexToOklch, hexToRgb as hexToRgb$1, mixSrgb, oklchToHex, relativeLuminance } from "@silvery/color";
 import "string-width";
 //#region packages/ansi/src/constants.ts
 /**
@@ -12,19 +12,12 @@ import "string-width";
 * Uses colon-separated parameters (ISO 8613-6): \x1b[4:Nm
 */
 const UNDERLINE_CODES = {
-	/** No underline */
 	none: "\x1B[4:0m",
-	/** Standard single underline */
 	single: "\x1B[4:1m",
-	/** Double underline (two parallel lines) */
 	double: "\x1B[4:2m",
-	/** Curly/wavy underline (spell check style) */
 	curly: "\x1B[4:3m",
-	/** Dotted underline */
 	dotted: "\x1B[4:4m",
-	/** Dashed underline */
 	dashed: "\x1B[4:5m",
-	/** Reset extended underline (same as none) */
 	reset: "\x1B[4:0m"
 };
 /** Standard underline on (SGR 4) - works on all terminals */
@@ -253,6 +246,30 @@ const CONTRAST_PAIRS = [
 		bg: "bg-selected",
 		min: AA_RATIO
 	},
+	{
+		rule: "contrast:fg-on-inverse/bg-inverse",
+		fg: "fg-on-inverse",
+		bg: "bg-inverse",
+		min: AA_RATIO
+	},
+	{
+		rule: "contrast:fg-on-inverse/bg-inverse-hover",
+		fg: "fg-on-inverse",
+		bg: "bg-inverse-hover",
+		min: AA_RATIO
+	},
+	{
+		rule: "contrast:fg-on-inverse-muted/bg-inverse",
+		fg: "fg-on-inverse-muted",
+		bg: "bg-inverse",
+		min: 3
+	},
+	{
+		rule: "contrast:fg-on-inverse-muted/bg-inverse-hover",
+		fg: "fg-on-inverse-muted",
+		bg: "bg-inverse-hover",
+		min: 3
+	},
 	{
 		rule: "contrast:fg-cursor/bg-cursor",
 		fg: "fg-cursor",
@@ -807,6 +824,35 @@ function guardTarget(nestedPath, flatPath, rule, inputs, value, against, target,
 	});
 	return finalValue;
 }
+/** Whether a foreground clears `target` against every supplied surface. */
+function clearsEverySurface(value, surfaces, target) {
+	return surfaces.every((surface) => checkAA("contrast-bounded mix", value, surface, target) === null);
+}
+/**
+* Preserve an alpha-like sRGB mix as far as its readability budget allows.
+*
+* `maxMix` is the desired amount of `toward` color. When that exact mix falls
+* below the contrast floor on either surface, binary-search back toward the
+* readable foreground and return the most-deemphasized passing hex. This keeps
+* muted text on the same color line instead of allowing a generic contrast
+* repair to flip it to the opposite light/dark pole.
+*/
+function mixSrgbWithContrastFloor(foreground, toward, maxMix, surfaces, target) {
+	const desired = mixSrgb(foreground, toward, maxMix);
+	if (clearsEverySurface(desired, surfaces, target)) return desired;
+	let passingMix = 0;
+	let failingMix = maxMix;
+	let best = foreground;
+	for (let step = 0; step < 16; step++) {
+		const candidateMix = (passingMix + failingMix) / 2;
+		const candidate = mixSrgb(foreground, toward, candidateMix);
+		if (clearsEverySurface(candidate, surfaces, target)) {
+			passingMix = candidateMix;
+			best = candidate;
+		} else failingMix = candidateMix;
+	}
+	return best;
+}
 /**
 * Derive a Theme's nested roles from a ColorScheme. Guardrails applied.
 */
@@ -856,6 +902,7 @@ function deriveRoles(scheme, opts) {
 		fg: guard("muted.fg", "fg-muted", "blend(fg, bg, 0.4)", [fg, bg], blend(fg, bg, .4), mutedBg, 3),
 		bg: mutedBg
 	};
+	const faint = { fg: guard("faint.fg", "fg-faint", "blend(fg, bg, 0.55)", [fg, bg], blend(fg, bg, .55), mutedBg, 1.5) };
 	const fgForSurfaceLift = ensureContrast(fg, blend(bg, fg, .08), WCAG_AA);
 	const surfaceDefault = guard("surface.default", "bg-surface-default", "scheme.background", [bg], bg);
 	const surface = {
@@ -885,9 +932,19 @@ function deriveRoles(scheme, opts) {
 		hover: { bg: guard("selected.hover.bg", "bg-selected-hover", `OKLCH ${shiftLabel(selectedBg)} ${selectedDeltaH.hover}L on selected.bg`, [selectedBg], shiftL(selectedBg, selectedDeltaH.hover)) }
 	};
 	const inverseBg = guard("inverse.bg", "bg-inverse", "blend(fg, bg, 0.1)", [fg, bg], blend(fg, bg, .1));
+	const inverseFgOn = guard("inverse.fgOn", "fg-on-inverse", "contrast-pick(scheme.fg/bg/BW)", [inverseBg], pickFgOn(inverseBg, scheme), inverseBg);
+	const inverseHoverBg = guard("inverse.hover.bg", "bg-inverse-hover", "mixSrgb(inverse.bg, inverse.fgOn, 0.1)", [inverseBg, inverseFgOn], mixSrgb(inverseBg, inverseFgOn, .1), inverseFgOn);
+	const inverseMutedCandidate = mixSrgbWithContrastFloor(inverseFgOn, inverseBg, .35, [inverseBg, inverseHoverBg], 3);
+	const inverseMutedFgOn = guard("inverse.muted.fgOn", "fg-on-inverse-muted", "mixSrgb(inverse.fgOn, inverse.bg, ≤0.35), bounded to ≥3:1 on inverse surfaces", [
+		inverseFgOn,
+		inverseBg,
+		inverseHoverBg
+	], inverseMutedCandidate, inverseBg, 3);
 	const inverse = {
 		bg: inverseBg,
-		fgOn: guard("inverse.fgOn", "fg-on-inverse", "contrast-pick(scheme.fg/bg/BW)", [inverseBg], pickFgOn(inverseBg, scheme), inverseBg)
+		fgOn: inverseFgOn,
+		hover: { bg: inverseHoverBg },
+		muted: { fgOn: inverseMutedFgOn }
 	};
 	const link = { fg: guard("link.fg", "fg-link", mode === "dark" ? "scheme.brightBlue" : "scheme.blue", [mode === "dark" ? scheme.brightBlue : scheme.blue], mode === "dark" ? scheme.brightBlue : scheme.blue, bg) };
 	const fgDisabledRaw = blend(surfaceDefault, fg, .38);
@@ -901,6 +958,7 @@ function deriveRoles(scheme, opts) {
 			warning,
 			error,
 			muted,
+			faint,
 			surface,
 			border,
 			cursor,
@@ -1215,6 +1273,8 @@ function inlineSterlingTokens(theme, scheme) {
 		setIfAbsent("fg-muted", m.fg);
 		setIfAbsent("bg-muted", m.bg);
 	}
+	const ft = roles.faint;
+	if (ft) setIfAbsent("fg-faint", ft.fg);
 	const sel = roles.selected;
 	if (sel) {
 		setIfAbsent("bg-selected", sel.bg);
@@ -1225,6 +1285,8 @@ function inlineSterlingTokens(theme, scheme) {
 	if (inv) {
 		setIfAbsent("bg-inverse", inv.bg);
 		setIfAbsent("fg-on-inverse", inv.fgOn);
+		setIfAbsent("bg-inverse-hover", inv.hover.bg);
+		setIfAbsent("fg-on-inverse-muted", inv.muted.fgOn);
 	}
 	const lnk = roles.link;
 	if (lnk) setIfAbsent("fg-link", lnk.fg);
@@ -2532,8 +2594,8 @@ function pickColorLevelWalk(obj, tier) {
 * Build a {@link TerminalProfile} from the current environment.
 *
 * Priority for the final `colorLevel` (highest wins):
-*   1. `NO_COLOR` env var → `"mono"`
-*   2. `FORCE_COLOR` env var → `0/false → mono, 1 → ansi16, 2 → 256, 3 → truecolor`
+*   1. `FORCE_COLOR` env var → `0/false → mono, 1 → ansi16, 2 → 256, 3 → truecolor`
+*   2. `NO_COLOR` env var → `"mono"`
 *   3. `options.colorLevel` (caller-supplied explicit tier)
 *   4. `options.caps.colorLevel` (base caps' pre-detected tier)
 *   5. Auto-detected tier from env (TERM, COLORTERM, TERM_PROGRAM, …)
@@ -2556,7 +2618,7 @@ function pickColorLevelWalk(obj, tier) {
 * const profile = createTerminalProfile()
 * console.log(profile.colorLevel) // "truecolor" on Ghostty
 *
-* // Force a tier (still honors NO_COLOR / FORCE_COLOR env precedence)
+* // Force a tier (still honors FORCE_COLOR / NO_COLOR env precedence)
 * const forced = createTerminalProfile({ colorLevel: "256" })
 *
 * // Term path — base caps already detected, just resolve color tier.
@@ -2705,15 +2767,8 @@ async function probeTerminalProfile(options = {}) {
 * `process.env` twice.
 */
 function detectColorFromEnv(env, stdout) {
-	if (env.NO_COLOR !== void 0) return "mono";
-	const forceColor = env.FORCE_COLOR;
-	if (forceColor !== void 0) {
-		if (forceColor === "0" || forceColor === "false") return "mono";
-		if (forceColor === "1") return "ansi16";
-		if (forceColor === "2") return "256";
-		if (forceColor === "3") return "truecolor";
-		return "ansi16";
-	}
+	const envTier = envColorTier(env);
+	if (envTier !== void 0) return envTier;
 	if (!stdout.isTTY) return "mono";
 	if (env.TERM === "dumb") return "mono";
 	const colorTerm = env.COLORTERM;
@@ -2736,7 +2791,6 @@ function detectColorFromEnv(env, stdout) {
 * env always beats caller-supplied overrides.
 */
 function envColorTier(env) {
-	if (env.NO_COLOR !== void 0) return "mono";
 	const force = env.FORCE_COLOR;
 	if (force !== void 0) {
 		if (force === "0" || force === "false") return "mono";
@@ -2745,6 +2799,7 @@ function envColorTier(env) {
 		if (force === "3") return "truecolor";
 		return "ansi16";
 	}
+	if (env.NO_COLOR !== void 0) return "mono";
 }
 /**
 * Deterministic env-based detection of the full two-layer profile
@@ -2760,7 +2815,7 @@ function detectTerminalProfileFromEnv(env, stdout) {
 	const TERM = env.TERM ?? "";
 	const noColor = env.NO_COLOR !== void 0;
 	const isAppleTerminal = programLower === "apple_terminal";
-	const colorLevel = noColor ? "mono" : detectColorFromEnv(env, stdout);
+	const colorLevel = detectColorFromEnv(env, stdout);
 	const isKitty = TERM === "xterm-kitty";
 	const isITerm = programLower === "iterm.app";
 	const isGhostty = programLower === "ghostty";
@@ -2820,7 +2875,7 @@ function detectTerminalProfileFromEnv(env, stdout) {
 			sixel: !isDumb && (isFoot || isWezTerm),
 			osc52: isModern || !isDumb && isAlacritty,
 			hyperlinks: isModern || !isDumb && isAlacritty,
-			notifications: isITerm || isKitty,
+			notifications: isDumb ? false : isKitty ? "osc99" : isITerm ? "osc9" : isGhostty || isWezTerm || isFoot ? "osc777" : false,
 			syncOutput: isModern || !isDumb && isAlacritty,
 			maybeDarkBackground,
 			maybeNerdFont,
@@ -2990,6 +3045,7 @@ function warnOnce(id, emit) {
 * | `accent.fg`                  | `fg-accent`                 |
 * | `accent.bg`                  | `bg-accent`                 |
 * | `accent.fgOn`                | `fg-on-accent`              |
+* | `inverse.muted.fgOn`         | `fg-on-inverse-muted`       |
 * | `accent.border`              | `border-accent`             |
 * | `accent.hover.bg`            | `bg-accent-hover`           |
 * | `accent.active.fg`           | `fg-accent-active`          |
@@ -3012,7 +3068,10 @@ const defaultFlattenRule = (path) => {
 	const role = path[0];
 	const last = path[path.length - 1];
 	const mid = path.slice(1, -1);
-	if (last === "fgOn") return `fg-on-${role}`;
+	if (last === "fgOn") {
+		const state = mid.length > 0 ? mid.join("-") : void 0;
+		return state ? `fg-on-${role}-${state}` : `fg-on-${role}`;
+	}
 	if (last === "fg" || last === "bg" || last === "border") {
 		const state = mid.length > 0 ? mid.join("-") : void 0;
 		return state ? `${last}-${role}-${state}` : `${last}-${role}`;
@@ -3825,6 +3884,8 @@ const DEFAULT_MONO_ATTRS = {
 	"bg-selected-hover": ["inverse"],
 	"bg-inverse": ["inverse"],
 	"fg-on-inverse": [],
+	"bg-inverse-hover": ["inverse"],
+	"fg-on-inverse-muted": ["dim"],
 	"fg-link": ["underline"]
 };
 /**
@@ -4124,6 +4185,107 @@ async function detectSchemeTheme(opts = {}) {
 	return theme;
 }
 //#endregion
+//#region packages/ansi/src/sterling/flat-tokens.ts
+const STERLING_FLAT_TOKENS = [
+	"bg-surface-default",
+	"bg-surface-subtle",
+	"bg-surface-raised",
+	"bg-surface-overlay",
+	"bg-surface-hover",
+	"border-default",
+	"border-focus",
+	"border-muted",
+	"fg-cursor",
+	"bg-cursor",
+	"fg-muted",
+	"bg-muted",
+	"fg-faint",
+	"fg-accent",
+	"bg-accent",
+	"fg-on-accent",
+	"fg-accent-hover",
+	"bg-accent-hover",
+	"fg-accent-active",
+	"bg-accent-active",
+	"border-accent",
+	"fg-info",
+	"bg-info",
+	"fg-on-info",
+	"bg-info-hover",
+	"bg-info-active",
+	"fg-success",
+	"bg-success",
+	"fg-on-success",
+	"bg-success-hover",
+	"bg-success-active",
+	"fg-warning",
+	"bg-warning",
+	"fg-on-warning",
+	"bg-warning-hover",
+	"bg-warning-active",
+	"fg-error",
+	"bg-error",
+	"fg-on-error",
+	"bg-error-hover",
+	"bg-error-active",
+	"bg-selected",
+	"fg-on-selected",
+	"bg-selected-hover",
+	"bg-inverse",
+	"fg-on-inverse",
+	"bg-inverse-hover",
+	"fg-on-inverse-muted",
+	"fg-link",
+	"fg-disabled",
+	"bg-disabled",
+	"border-disabled",
+	"bg-backdrop",
+	"fg-default",
+	"bg-default"
+];
+new Set([
+	"bg",
+	"fg",
+	"muted",
+	"mutedbg",
+	"surface",
+	"surfacebg",
+	"popover",
+	"popoverbg",
+	"cursor",
+	"cursorbg",
+	"primary",
+	"primaryfg",
+	"secondary",
+	"secondaryfg",
+	"accent",
+	"accentfg",
+	"error",
+	"errorfg",
+	"warning",
+	"warningfg",
+	"success",
+	"successfg",
+	"info",
+	"infofg",
+	"border",
+	"inputborder",
+	"focusborder",
+	"disabledfg",
+	"palette",
+	"name",
+	"brand",
+	"brand-hover",
+	"brand-active",
+	"primary-hover",
+	"primary-active",
+	"accent-hover",
+	"accent-active",
+	"fg-hover",
+	"fg-active",
+	...STERLING_FLAT_TOKENS
+]);
+//#endregion
 //#region packages/ansi/src/theme/tokens.ts
 /**
 * Runtime constant — the 12 built-in variant names shipped by silvery.
@@ -4240,62 +4402,6 @@ function generateTheme(primary, dark) {
 	};
 }
 //#endregion
-//#region packages/ansi/src/sterling/flat-tokens.ts
-const STERLING_FLAT_TOKENS = [
-	"bg-surface-default",
-	"bg-surface-subtle",
-	"bg-surface-raised",
-	"bg-surface-overlay",
-	"bg-surface-hover",
-	"border-default",
-	"border-focus",
-	"border-muted",
-	"fg-cursor",
-	"bg-cursor",
-	"fg-muted",
-	"bg-muted",
-	"fg-accent",
-	"bg-accent",
-	"fg-on-accent",
-	"fg-accent-hover",
-	"bg-accent-hover",
-	"fg-accent-active",
-	"bg-accent-active",
-	"border-accent",
-	"fg-info",
-	"bg-info",
-	"fg-on-info",
-	"bg-info-hover",
-	"bg-info-active",
-	"fg-success",
-	"bg-success",
-	"fg-on-success",
-	"bg-success-hover",
-	"bg-success-active",
-	"fg-warning",
-	"bg-warning",
-	"fg-on-warning",
-	"bg-warning-hover",
-	"bg-warning-active",
-	"fg-error",
-	"bg-error",
-	"fg-on-error",
-	"bg-error-hover",
-	"bg-error-active",
-	"bg-selected",
-	"fg-on-selected",
-	"bg-selected-hover",
-	"bg-inverse",
-	"fg-on-inverse",
-	"fg-link",
-	"fg-disabled",
-	"bg-disabled",
-	"border-disabled",
-	"bg-backdrop",
-	"fg-default",
-	"bg-default"
-];
-//#endregion
 //#region packages/ansi/src/sterling/defaults.ts
 /**
 * A hand-tuned neutral dark scheme — not a copy of any catalog palette, but
@@ -4457,6 +4563,7 @@ const STERLING_SHAPE = {
 		"warning",
 		"error",
 		"muted",
+		"faint",
 		"surface",
 		"border",
 		"cursor",
@@ -4616,6 +4723,6 @@ function seedRule(role) {
 	}
 }
 //#endregion
-export { queryMultiplePaletteColors as $, fgColorCode as A, detectColorScheme as B, enableBracketedPaste as C, defaultFlattenRule as D, bakeFlat as E, pickColorLevel as F, resetCursorColor as G, queryCursorColor as H, quantizeHex as I, setCursorColor as J, resetForegroundColor as K, detectTerminalScheme as L, detectColorFromEnv as M, probeTerminalProfile as N, warnOnce as O, ANSI16_SLOT_HEX as P, parsePaletteResponse as Q, detectTheme as R, disableMouse as S, enableMouse as T, queryForegroundColor as U, queryBackgroundColor as V, resetBackgroundColor as W, ProtocolError as X, setForegroundColor as Y, isProtocolError as Z, kittyDeleteAllScrimPlacements as _, generateTheme as a, deriveRoles as at, disableBracketedPaste as b, detectSchemeTheme as c, WCAG_AA as ct, createMixedStyle as d, deriveFields as dt, queryPaletteColor as et, createStyle as f, defaultCaps as ft, cupTo as g, buildScrimPixels as h, STERLING_FLAT_TOKENS as i, deriveTheme as it, createTerminalProfile as j, bgColorCode as k, COLOR_SCHEME_FIELDS as l, autoLift as lt, backdropPlacementId as m, defineDesignSystem as n, ansi16DarkTheme as nt, KNOWN_VARIANTS as o, deriveTheme$1 as ot, resolveThemeColor as p, setBackgroundColor as q, defaultScheme as r, ansi16LightTheme as rt, detectScheme as s, ContrastError as st, sterling as t, setPaletteColor as tt, monoAttrsForColorString as u, checkAA as ut, kittyPlaceAt as v, enableKittyKeyboard as w, disableKittyKeyboard as x, kittyUploadScrimImage as y, probeColors as z };
+export { setForegroundColor as $, fgColorCode as A, rgbToAnsi256 as B, enableBracketedPaste as C, defaultFlattenRule as D, bakeFlat as E, bgFromRgb as F, queryBackgroundColor as G, detectTheme as H, fgFromRgb as I, resetBackgroundColor as J, queryCursorColor as K, nearestAnsi16 as L, detectColorFromEnv as M, probeTerminalProfile as N, warnOnce as O, ANSI16_SLOT_HEX as P, setCursorColor as Q, pickColorLevel as R, disableMouse as S, enableMouse as T, probeColors as U, detectTerminalScheme as V, detectColorScheme as W, resetForegroundColor as X, resetCursorColor as Y, setBackgroundColor as Z, kittyDeleteAllScrimPlacements as _, KNOWN_VARIANTS as a, setPaletteColor as at, disableBracketedPaste as b, detectSchemeTheme as c, deriveTheme as ct, createMixedStyle as d, ContrastError as dt, ProtocolError as et, createStyle as f, WCAG_AA as ft, cupTo as g, defaultCaps as gt, buildScrimPixels as h, deriveFields as ht, generateTheme as i, queryPaletteColor as it, createTerminalProfile as j, bgColorCode as k, COLOR_SCHEME_FIELDS as l, deriveRoles as lt, backdropPlacementId as m, checkAA as mt, defineDesignSystem as n, parsePaletteResponse as nt, STERLING_FLAT_TOKENS as o, ansi16DarkTheme as ot, resolveThemeColor as p, autoLift as pt, queryForegroundColor as q, defaultScheme as r, queryMultiplePaletteColors as rt, detectScheme as s, ansi16LightTheme as st, sterling as t, isProtocolError as tt, monoAttrsForColorString as u, deriveTheme$1 as ut, kittyPlaceAt as v, enableKittyKeyboard as w, disableKittyKeyboard as x, kittyUploadScrimImage as y, quantizeHex as z };
 
-//# sourceMappingURL=src-Oe6x5PrS.mjs.map
+//# sourceMappingURL=src-B8lf1kiR.mjs.map