Sobre o projeto

docx é uma biblioteca open-source JavaScript/TypeScript para criar e modificar documentos .docx (Microsoft Word). Seu README apresenta uma API declarativa: você descreve a estrutura do documento com objetos como Document, Paragraph, Header e Table, e a biblioteca produz um arquivo .docx. Afirma-se que funciona tanto em Node quanto no navegador. A documentação e os exemplos ficam em docx.js.org, e o repositório inclui uma pasta demo. O README aponta para demos no navegador no CodePen e JSFiddle, exemplos de frameworks para Angular, React e Vue.js no StackBlitz, e exemplos em Node no RunKit cobrindo parágrafos simples e avançados, marcadores, tabelas, imagens, margens, orientação paisagem e cabeçalhos e rodapés. Um exemplo é descrito como um CV gerado com docx. Além do pacote principal, o README documenta pontos de entrada opcionais: docx/shapes para formas, grupos de formas e diagramas com conectores; docx/watermarks para marcas d'água; e docx/charts para gráficos nativos do Word. Eles são mantidos fora do pacote principal para que documentos que não os utilizam não carreguem seu código. Um exemplo de código mostra a importação de ChartRun, ShapeRun e TextWatermark e seu uso dentro de um Document com seções, cabeçalhos e parágrafos. Para páginas sem bundler, o README diz para carregar dist/shapes.umd.cjs, dist/watermarks.umd.cjs ou dist/charts.umd.cjs após dist/index.umd.cjs, que adicionam os globais docxShapes, docxWatermarks e docxCharts. O README também aponta para o Docx.js Editor, um playground interativo para codificar e visualizar resultados em tempo real, e para as diretrizes de contribuição. Ele lista várias empresas e produtos como usuários da biblioteca, e inclui badges para versão npm, downloads mensais, status do fluxo de trabalho do GitHub Actions, vulnerabilidades conhecidas, status de boas-vindas a pull requests e cobertura de código. O projeto é distribuído via npm sob o nome de pacote docx.