deco-migrate template: css/fonts/meta/previewWrapper não estão em SiteSetupOptions

Gap encontrado: portal-davinci migration run (2026-08-20)

Fase

migrate-script → geração de src/setup.ts

Problema

O template em @decocms/blocks-cli/scripts/migrate/templates/setup.ts gera setup.ts com campos que não existem na interface SiteSetupOptions do @decocms/blocks:

• css: appCss
• fonts: []
• meta: () => import(...)
• previewWrapper: PreviewProviders

Isso resulta em 3+ erros TypeScript na fase build-green:

• error TS2353: Object literal may only specify known properties, and 'meta' does not exist in type 'SiteSetupOptions'
• error TS2578: Unused '@ts-expect-error' directive (o template usa @ts-ignore mas o generate usa @ts-expect-error)

Workaround usado nesta run

Cast do objeto para as any.

Fix necessário

Escolher um dos dois:

1. Adicionar os campos css, fonts, previewWrapper, meta à SiteSetupOptions em @decocms/blocks
2. Remover esses campos do template e usar setPreviewWrapper(PreviewProviders) separado + documentar como registrar CSS

Referências

• node_modules/@decocms/blocks/src/setup.ts — interface atual sem esses campos
• node_modules/@decocms/blocks-cli/scripts/migrate/templates/setup.ts — template que os gera

Transferida de decocms/parity#235 (bug de template do deco-migrate / @decocms/blocks-cli, fora do escopo do repo parity).

Start with node_modules/@decocms/blocks/src/setup.ts and the @decocms/blocks-cli/scripts/migrate/templates/setup.ts template. Compare the generated fields with SiteSetupOptions and resolve whether the interface or template should own them. Re-run the migration and build-green checks to confirm the generated setup.ts has no TypeScript errors.