Skip to content

@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 .calc baixados 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 .calc exportado é 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.

SubpathO que exporta
@fc/arquivos-calc/exportacao/serializarCopiaArquivoCalcserializarCopiaArquivoCalc — serializa a cópia com título atual, sem vínculo online e com datas civis preservadas
@fc/arquivos-calc/migracao/migrarChaveCompetenciaLegadamigrarChaveCompetenciaLegada — passa a chave de competência gravada em formato antigo a aaaa-mm
@fc/arquivos-calc/migracao/migrarRegistroPorCompetenciamigrarRegistroPorCompetencia — reescreve um registro indexado por competência no formato aaaa-mm
@fc/arquivos-calc/migracao/migrarParametroLegadomigrarParametroLegado — traduz o ordinal ou texto legado de um parâmetro pela tabela congelada
@fc/arquivos-calc/migracao/PipelineMigracaoPipelineMigracao
@fc/arquivos-calc/migracao/removerVinculoOnlineremoverVinculoOnline
@fc/arquivos-calc/migracao/tiposArquivoVersionado, Migrador, AtributoArquivoOnline
@fc/arquivos-calc/nomes/constantesEXTENSAO_CALC, CARACTERES_PROIBIDOS_NOME_ARQUIVO, PADRAO_CARACTERES_PROIBIDOS_NOME_ARQUIVO
@fc/arquivos-calc/nomes/normalizarNomeArquivoCalcnormalizarNomeArquivoCalc
@fc/arquivos-calc/nomes/atualizarNomeCalculoNoArquivoatualizarNomeCalculoNoArquivo — alinha o nome no conteúdo da cópia ao título atual
@fc/arquivos-calc/nomes/criarGeradorNomesArquivosUnicoscriarGeradorNomesArquivosUnicos
@fc/arquivos-calc/nomes/substituirCaracteresControlesubstituirCaracteresControle
@fc/arquivos-calc/nomes/temCaractereDeControletemCaractereDeControle
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:run

Reconhecimento 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.