/** Em que estado um item do checklist esta. */ export type EstadoDoCriterio = 'feito' | 'aberto' | 'adiado'; /** Um item do `## Tasks`, lido. */ export interface CriterioDeConclusao { readonly estado: EstadoDoCriterio; /** O texto do item, sem a marca e sem a anotacao de adiamento. */ readonly texto: string; /** A linha no arquivo, contada a partir de 1. */ readonly linha: number; /** Por que foi adiado. Presente apenas em `adiado`. */ readonly razao?: string; /** O que comprova, quando quem marcou anexou algo. Apenas em `feito`. */ readonly evidencia?: string; } /** * Le os criterios de conclusao de um arquivo de tarefa. * * ## Por que existe um leitor so * * O `finish` avisa sobre criterios em aberto (task-074) e o `lint` recusa uma * tarefa `done` com item aberto sem justificativa (task-075). Se cada um * tivesse o seu parser, eles divergiriam — e divergir aqui significa o lint * recusar o que o `finish` acabou de aceitar, que e pior que nao ter portao. * * ## O vocabulario * * - `- [x] texto` — **feito**. O que vier depois do texto e tratado como * evidencia: nome de teste, comando, hash de commit. * - `- [ ] texto` — **em aberto**. Bloqueia a conclusao. * - `- [ ] texto — adiado: razao` — **adiado**, com a razao declarada. Nao * bloqueia: fechar com um item que alguem decidiu nao fazer e legitimo, desde * que a decisao esteja escrita. * * Razao vazia nao conta como adiamento. Fosse aceita, escrever `— adiado:` e * nada depois transformaria qualquer item aberto em decisao declarada, e o * portao viraria teatro. * * @param conteudo - O markdown inteiro do arquivo * @returns Os itens do `## Tasks`, em ordem. Vazio quando a secao nao existe — * uma tarefa sem checklist nao tem criterios, e isso nao e erro. * @public */ export declare function lerCriteriosDeConclusao(conteudo: string): CriterioDeConclusao[]; /** * Os criterios que impedem a conclusao: em aberto, e sem razao declarada. * * Feito nao bloqueia, e adiado com razao tambem nao — fechar uma tarefa * decidindo nao fazer um item e legitimo, desde que a decisao esteja escrita. * * @public */ export declare function criteriosEmAberto(conteudo: string): CriterioDeConclusao[]; //# sourceMappingURL=criterios-de-conclusao.d.ts.map