Function generateKittyImageSequence

cli/src/utils/terminal-images.ts:120–170

* Generate Kitty graphics protocol escape sequence * @param base64Data - Base64 encoded image data * @param options - Display options

(
  base64Data: string,
  options: {
    width?: number // cells
    height?: number // cells
    id?: number
  } = {},
)

 * @param options - Display options
 */
function generateKittyImageSequence(
  base64Data: string,
  options: {
    width?: number // cells
    height?: number // cells
    id?: number
  } = {},
): string {
  const { width, height, id } = options

  // Build key-value pairs for the control data
  const kvPairs: string[] = [
    'a=T', // action: transmit and display
    'f=100', // format: PNG (100) - let Kitty auto-detect
    't=d', // transmission: direct (data follows)
  ]

  if (width) {
    kvPairs.push(`c=${width}`) // columns
  }

  if (height) {
    kvPairs.push(`r=${height}`) // rows
  }

  if (id) {
    kvPairs.push(`i=${id}`) // image id
  }

  const controlData = kvPairs.join(',')

  // Kitty requires chunked transmission for large images
  // For simplicity, we'll send in one chunk if small enough
  const CHUNK_SIZE = 4096

  if (base64Data.length <= CHUNK_SIZE) {
    // Single chunk: ESC _ G <control> ; <data> ESC \
    return `\x1b_G${controlData};${base64Data}\x1b\\`
  }

  // Multi-chunk transmission
  const chunks: string[] = []
  for (let i = 0; i < base64Data.length; i += CHUNK_SIZE) {
    const chunk = base64Data.slice(i, i + CHUNK_SIZE)
    const isLast = i + CHUNK_SIZE >= base64Data.length
    const chunkControl = isLast ? controlData : `${controlData},m=1` // m=1 means more chunks coming
    chunks.push(`\x1b_G${chunkControl};${chunk}\x1b\\`)
  }

  return chunks.join('')
}

/**
 * Render an image inline in the terminal