@fc/arquivos-calc
Tudo o que descreve o arquivo de cálculo: como ele se chama e como evolui de versão.
- Política de nomes — monta e interpreta o nome dos arquivos
.calcbaixados pelo usuário, com uma única fonte para prefixos e formato. Na exportação, o basename usa Unicode NFC, evita dispositivos reservados do Windows, preserva a extensão dentro do teto de 255 bytes UTF-8 e resolve colisões sem distinguir caixa; o título persistido não é alterado. - Tipos versionados e pipeline de migração — um arquivo salvo em qualquer versão anterior é lido e convertido, passo a passo, até o formato atual.
- Remoção de vínculo online — um
.calcexportado é sempre uma cópia offline independente; a política garante isso na saída e na entrada. - Nome da cópia baixada — o conteúdo exportado recebe o título atual do cálculo online, para reabrir com o mesmo nome, preservando o documento de origem. A mesma preparação atende downloads individuais e ZIPs, com datas civis preservadas na serialização.
Isomórfico e TypeScript puro, com dependências de @fc/comum, @fc/utils e @fc/parsers. Roda em navegador, Node e Vitest — é consumido tanto pelas calculadoras quanto por rotas de servidor que validam e convertem arquivos.
A sessão de cálculo no navegador (workspaces por aba, rascunhos, IndexedDB) não faz parte deste pacote: vive na camada Nuxt de persistência de cálculos, que orquestra o mecanismo junto da política online.
Instalação (monorepo)
jsonc
// package.json
{ "dependencies": { "@fc/arquivos-calc": "workspace:*" } }Os packages/ exportam TypeScript puro direto de src/ — sem step de compilação.
Como consumir
O pacote não tem barrel raiz: @fc/arquivos-calc não resolve. Cada módulo é publicado por subpath (@fc/arquivos-calc/exportacao/*, @fc/arquivos-calc/migracao/*, @fc/arquivos-calc/nomes/* e @fc/arquivos-calc/importacao/*), e o consumidor importa o arquivo que declara o símbolo.
| Subpath | O que exporta |
|---|---|
@fc/arquivos-calc/exportacao/serializarCopiaArquivoCalc | serializarCopiaArquivoCalc — serializa a cópia com título atual, sem vínculo online e com datas civis preservadas |
@fc/arquivos-calc/migracao/migrarChaveCompetenciaLegada | migrarChaveCompetenciaLegada — passa a chave de competência gravada em formato antigo a aaaa-mm |
@fc/arquivos-calc/migracao/migrarRegistroPorCompetencia | migrarRegistroPorCompetencia — reescreve um registro indexado por competência no formato aaaa-mm |
@fc/arquivos-calc/migracao/migrarParametroLegado | migrarParametroLegado — traduz o ordinal ou texto legado de um parâmetro pela tabela congelada |
@fc/arquivos-calc/migracao/PipelineMigracao | PipelineMigracao |
@fc/arquivos-calc/migracao/removerVinculoOnline | removerVinculoOnline |
@fc/arquivos-calc/migracao/tipos | ArquivoVersionado, Migrador, AtributoArquivoOnline |
@fc/arquivos-calc/nomes/constantes | EXTENSAO_CALC, CARACTERES_PROIBIDOS_NOME_ARQUIVO, PADRAO_CARACTERES_PROIBIDOS_NOME_ARQUIVO |
@fc/arquivos-calc/nomes/normalizarNomeArquivoCalc | normalizarNomeArquivoCalc |
@fc/arquivos-calc/nomes/atualizarNomeCalculoNoArquivo | atualizarNomeCalculoNoArquivo — alinha o nome no conteúdo da cópia ao título atual |
@fc/arquivos-calc/nomes/criarGeradorNomesArquivosUnicos | criarGeradorNomesArquivosUnicos |
@fc/arquivos-calc/nomes/substituirCaracteresControle | substituirCaracteresControle |
@fc/arquivos-calc/nomes/temCaractereDeControle | temCaractereDeControle |
ts
import type { ArquivoVersionado, Migrador } from '@fc/arquivos-calc/migracao/tipos'
import { PipelineMigracao } from '@fc/arquivos-calc/migracao/PipelineMigracao'
import { removerVinculoOnline } from '@fc/arquivos-calc/migracao/removerVinculoOnline'
import { EXTENSAO_CALC } from '@fc/arquivos-calc/nomes/constantes'
import { normalizarNomeArquivoCalc } from '@fc/arquivos-calc/nomes/normalizarNomeArquivoCalc'migracao/versaoIgualOuAnterior e nomes/portabilidadeNomeArquivo são detalhes de implementação de PipelineMigracao e da política de nomes: os wildcards os expõem, mas nenhum consumidor deve importá-los.
Testes
bash
pnpm --filter @fc/arquivos-calc test:runReconhecimento no importador
importacao/PluginArquivoCalc e importacao/constantes publicam PluginArquivoCalc e ARQUIVO_CALC. O plugin reconhece somente o envelope de cálculo existente, com JSON.parse sem reviver: datas permanecem textuais e origem desconhecida pode aparecer no resumo. JSON inválido não é reconhecido. Reconhecimento não significa autorização para abrir: a calculadora de destino continua conferindo origem, migrando e validando o conteúdo.