Exemplo guiado em TypeScript

type Chunk = {
  source: string;
  chunkIndex: number;
  content: string;
  metadata: { format: "txt" | "markdown" };
};

export function chunkText(
  source: string,
  content: string,
  maxChars: number,
  format: "txt" | "markdown",
): Chunk[] {
  const paragraphs = content.split(/\n\s*\n/).filter(Boolean);

  return paragraphs.map((paragraph, chunkIndex) => ({
    source,
    chunkIndex,
    content: paragraph.slice(0, maxChars),
    metadata: { format },
  }));
}

Este exemplo é deliberadamente incompleto: cortar um parágrafo no meio pode perder informação. A tarefa é perceber a limitação, criar um teste para ela e escolher a próxima melhoria com evidência, em vez de esconder a decisão.