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 e deliberadamente incompleto: cortar um paragrafo no meio pode perder informacao. A tarefa e perceber a limitacao, criar um teste para ela e escolher a proxima melhoria com evidencia, em vez de esconder a decisao.