Function outputToon

packages/cli/src/output.ts:165–185

(data: unknown, options?: { showEfficiencyHint?: boolean })

 * @see https://toonformat.dev/
 */
export function outputToon(data: unknown, options?: { showEfficiencyHint?: boolean }): void {
  const toonOutput = toonEncode(data)
  console.log(toonOutput)

  // Show efficiency hint if enabled and not in quiet mode
  if (options?.showEfficiencyHint && !currentConfig.quiet) {
    // Pass pre-encoded toonOutput to avoid re-encoding
    const { savingsPercent, toonRecommended } = analyzeToonEfficiency(data, toonOutput)

    if (!toonRecommended) {
      const hint =
        savingsPercent <= 0
          ? `Hint: JSON would be ${Math.abs(savingsPercent).toFixed(0)}% smaller for this data. ` +
            'Consider --output json for better compatibility.'
          : `Hint: TOON only saves ${savingsPercent.toFixed(0)}% over JSON for this data. ` +
            'TOON works best with uniform arrays of objects (30-60% typical savings).'

      console.error(cliChalk.dim(hint))
    }
  }
}