@aksp/opencrew 1.9.0 → 1.10.0

package/templates/_opencrew/core/scripts/entrega/leiame.mjs

@@ -5,7 +5,7 @@
 // (ressalvas, a cópia e "Sobre esta pasta"), no repositório do OpenCrew.
 import { CANAIS, EDITAVEIS, OUTROS } from './canais.mjs';
 import { frasesDePendencia } from './pendencias.mjs';
-import { passosDe } from './passos.mjs';
+import { NAO_EDITE_O_WORD, passosDe } from './passos.mjs';
 
 export const TEXTO = {
   vaiPublicar: 'Esta crew publica este canal sozinha. Antes de postar à mão, confira se já saiu.',
@@ -64,7 +64,8 @@ function secaoDoCanal(d, pasta) {
   // Na cópia, o canal que não foi copiado traz só a situação e o que falta.
   if (d.ehCopia && pendencias.length) return secao(CANAIS[pasta], [situacao, ...bloco('Pendências:', pendencias)]);
   const arquivos = d.arquivos.filter((a) => a.pasta === pasta);
-  const passos = passosDe(pasta, arquivos, pendencias.length > 0, d.ressalvas.has(pasta)).map((p, i) => `${i + 1}. ${p}`);
+  const daPasta = passosDe(pasta, arquivos, pendencias.length > 0, d.ressalvas.has(pasta));
+  const passos = daPasta.filter((p) => !d.ehCopia || p !== NAO_EDITE_O_WORD).map((p, i) => `${i + 1}. ${p}`);
   return secao(CANAIS[pasta], [
     ...(d.vaiPublicar.includes(pasta) ? [TEXTO.vaiPublicar] : []),
     situacao,

package/templates/_opencrew/core/scripts/entrega/passos.mjs

@@ -7,7 +7,9 @@
 export const ANTES_DE_POSTAR = 'Antes de postar, resolva o que está em Pendências. Corrija no arquivo de origem e peça para montar a entrega de novo: o que você mudar nesta pasta se perde.';
 /** O primeiro passo do canal entregue com ressalva. */
 export const CONFIRA_AS_RESSALVAS = 'Antes de postar, confira as ressalvas em "Antes de usar".';
-const MARKDOWN = 'Este texto está em markdown: se o seu editor não aceitar, ajuste títulos, negrito e links depois de colar.';
+/** O passo de `documentos` que só vale na pasta da entrega (a cópia não é refeita). Spec: fase-u3b-documento-word.md, §6. */
+export const NAO_EDITE_O_WORD = 'Não edite o Word dentro desta pasta: ela é refeita a cada entrega. Para mexer, copie o arquivo para outra pasta do projeto.';
+const MARKDOWN ='Este texto está em markdown: se o seu editor não aceitar, ajuste títulos, negrito e links depois de colar.';
 
 // Cada passo: [o que o faz aparecer, o texto]. null = sempre que o canal tem arquivo; um tipo de
 // arquivo = só quando a entrega tem arquivo desse tipo no canal; `tipo:um` e `tipo:varios` = só
@@ -58,6 +60,12 @@ const PASSOS = {
     [null, 'Confira e publique.'],
   ],
   youtube: [['roteiro', '`youtube/{arquivo}` é o roteiro para gravar: não é texto para colar.']],
+  documentos: [
+    ['documento', 'Abra `documentos/{arquivo}` no Word e confira: cabeçalho, páginas, tabelas e assinaturas.'],
+    ['documento', NAO_EDITE_O_WORD],
+    ['documento', 'Para ter um PDF: abra o documento no Word e use Arquivo → Salvar como → PDF.'],
+    ['documento', 'O Word é uma cópia do texto. O que você mudar nele não volta sozinho: altere o texto e gere de novo.'],
+  ],
 };
 // "texto": o roteiro e o arquivo que foi inteiro (carrossel em texto, peça não encontrada).
 const TIPOS = { texto: ['roteiro', 'inteiro'] };
@@ -100,5 +108,7 @@ function doQuadro(pasta, arquivos) {
 export function passosDe(pasta, arquivos, comPendencia = false, comRessalva = false) {
   const passos = doQuadro(pasta, arquivos);
   const antes = comPendencia ? ANTES_DE_POSTAR : comRessalva ? CONFIRA_AS_RESSALVAS : null;
-  return antes && passos.length ? [antes, ...passos] : passos;
+  // Documento não se posta: imprime-se, assina-se, protocola-se.
+  const frase = pasta === 'documentos' ? antes?.replace('Antes de postar', 'Antes de usar') : antes;
+  return frase && passos.length ? [frase, ...passos] : passos;
 }

package/templates/_opencrew/core/scripts/entrega/separar.mjs

@@ -6,6 +6,7 @@ import path from 'node:path';
 import { lerItem } from '../verificar/arquivos.mjs';
 import { semFrontmatter } from '../verificar/leitura.mjs';
 import { EDITAVEIS, OUTROS } from './canais.mjs';
+import { DOCUMENTOS, tipoDoDocumento } from './documentos.mjs';
 import { avisoDeFora, blocosFora } from './fora.mjs';
 import { PRINCIPAL, hashtagsSoltas, pecasDoLeitor } from './leitor.mjs';
 import { pecasDoBlog, pecasDoEmail, pecasDoWhatsapp, tweetsDaThread } from './longas.mjs';
@@ -82,6 +83,8 @@ async function separarItem(item, itens, p) {
     p.avisos.push({ pasta: OUTROS, tela: MSG.semCanal(item.rel) });
     return p.copias.push(copia(item, OUTROS, 'copia'));
   }
+  // Documento oficial: vai inteiro, sem procura de peças; `documentos.mjs` converte o texto em Word.
+  if (item.canal === DOCUMENTOS) return p.copias.push(copia(item, DOCUMENTOS, tipoDoDocumento(item.abs)));
   const lido = ['.md', '.txt'].includes(extensao(item)) ? await lerItem(item.abs) : null;
   if (lido?.tipo !== 'texto') return p.copias.push(copia(item, item.canal, ehImagem(item) ? 'imagem' : 'copia'));
   const texto = emLf(lido.texto);

package/templates/_opencrew/core/scripts/entregar.mjs

@@ -11,6 +11,8 @@
 //   --aceitar-pendencias: as pendências deste momento viram ressalvas ("entregar assim mesmo"); a
 //     ressalva vale enquanto a pendência dela existir: a que some sai do `ressalvas.json`.
 //   --vai-publicar: canal que a crew publica sozinha (pode repetir); o LEIA-ME avisa.
+// Item de formato com a plataforma `documento` (`.md` ou `.txt`) sai em `entrega/documentos/`, em
+// Word, com o perfil de documento oficial do projeto (fase-u3b-documento-word.md, regra 12).
 // Grava em crews/<crew>/output/<run>/: a pasta `entrega/` (refeita do zero a cada chamada, montada
 // em `entrega.tmp/`), `verificacao-entrega.md`, `ressalvas.json` (as pendências aceitas que ainda
 // existem) e `copia.json` (o retrato do que foi copiado, para a comparação seguinte). Fora
@@ -29,6 +31,7 @@ import { formatarRelatorio, verificar } from './verificar.mjs';
 import { USO, lerArgs, lerLista, limpar, runValido } from './entrega/argumentos.mjs';
 import { CANAIS, canalDoFormato, ehCanal, ehDeServico } from './entrega/canais.mjs';
 import { MSG as DESTINO, escolherDestino, validarDestino } from './entrega/destino.mjs';
+import { DOCUMENTOS, converterDocumentos, naoConferidoDoWord } from './entrega/documentos.mjs';
 import { MSG as COPIA, guardar } from './entrega/guardar.mjs';
 import { gravarEntrega } from './entrega/gravar.mjs';
 import { montarLeiame } from './entrega/leiame.mjs';
@@ -84,15 +87,18 @@ async function classificar(raiz, pedidos) {
 async function montar(raiz, args, itens, aceitas) {
   const arquivosDaLista = itens.map((i) => (i.formato ? { arquivo: i.arquivo, formato: i.formato } : i.arquivo));
   const verificacao = await verificar({ raiz, crew: args.crew, arquivos: arquivosDaLista, semPadraoDeBlog: true });
-  const { arquivos, avisos } = nomear(await separar(itens));
+  const separados = await converterDocumentos(raiz, await separar(itens), args.gerarDocx);
+  const { arquivos, avisos } = nomear(separados.produtos);
   const todas = pendenciasPorPasta(raiz, itens, verificacao);
+  // O texto que não virou Word é pendência de `documentos` (fase-u3b-documento-word.md, regra 12).
+  if (separados.pendencias.length) todas.set(DOCUMENTOS, [...(todas.get(DOCUMENTOS) ?? []), ...separados.pendencias]);
   const presentes = new Set([...arquivos.map((a) => a.pasta), ...todas.keys()]);
   const dados = {
     crew: path.basename(path.resolve(raiz, args.crew)), run: args.run, arquivos, avisos,
     ...separarPendencias(todas, aceitas, args.aceitar),
     pastas: Object.keys(CANAIS).filter((c) => presentes.has(c)),
     alertas: await alertasDeTamanho(raiz, itens, arquivos, verificacao),
-    naoConferido: naoConferido(raiz, itens, verificacao),
+    naoConferido: [...naoConferido(raiz, itens, verificacao), ...naoConferidoDoWord(arquivos)],
     vaiPublicar: args.vaiPublicar,
   };
   return { dados, relatorio: `${formatarRelatorio(verificacao)}\n` };
@@ -137,12 +143,13 @@ async function entregar(raiz, args, itens, escrever) {
 
 /**
  * @param {string[]} argv
- * @param {object} [deps] `cwd` (a pasta do projeto) e `escrever`
+ * @param {object} [deps] `cwd` (a pasta do projeto), `escrever` e `gerarDocx` (quem monta o Word
+ *   de um documento oficial; sem ele, o do `documento.mjs`)
  * @returns {Promise<number>} 0 = a linha `ENTREGA:` saiu (ou `--ajuda`) · 1 = erro de uso, ou erro
  *   que impediu a entrega inteira (uma linha em PT-BR, sem linha `ENTREGA:`, nada escrito)
  */
-export async function main(argv, { cwd = process.cwd(), escrever = (s) => process.stdout.write(`${s}\n`) } = {}) {
-  const args = lerArgs(argv);
+export async function main(argv, { cwd = process.cwd(), escrever = (s) => process.stdout.write(`${s}\n`), gerarDocx } = {}) {
+  const args = { ...lerArgs(argv), gerarDocx };
   const sair = (...linhas) => linhas.forEach((l) => escrever(l)) ?? 1;
   if (args.ajuda) return sair(USO) && 0;
   const pedidos = lerLista(args.arquivos);