docs: Update GEMINI.md with PR workflow and fix(typescript-build): Resolve syntax error

Author: Seu Nome

GEMINI.md

@@ -0,0 +1,109 @@
+# Contexto do Projeto: Correção da Issue #520 no Repositório `nuxt/typescript`
+
+Este documento resume o trabalho realizado para resolver a [issue #520](https://github.com/nuxt/typescript/issues/520), que reportava uma falha na resolução de aliases de caminho (como `~` ou `@`) em `import()` dinâmicos que utilizam *template literals*.
+
+## Objetivo
+
+O objetivo era corrigir o bug que impedia o Webpack de resolver corretamente caminhos como `` `~/components/${meuComponente}.vue` `` durante o processo de build do Nuxt.
+
+## Processo de Desenvolvimento
+
+1.  **Análise:** A issue foi analisada e o repositório `nuxt/typescript` foi clonado. A investigação do código-fonte, especificamente do pacote `packages/typescript-build`, revelou que o Webpack não estava configurado para lidar com a resolução de aliases dentro de expressões de *template literal*.
+
+2.  **Implementação da Solução:**
+    *   O arquivo `packages/typescript-build/src/index.ts` foi modificado.
+    *   A solução implementada utiliza o `NormalModuleReplacementPlugin` do Webpack. Este plugin intercepta as requisições de módulos que correspondem a um alias do Nuxt e substitui o alias pelo caminho absoluto correspondente antes que o Webpack tente resolver o alias.
+    *   Isso garante que os `imports` dinâmicos com *template literals* funcionem como esperado.
+
+3.  **Tentativa de Verificação (CI):**
+    *   Foi feita uma tentativa de executar os testes de CI locais (`yarn test`) para validar a alteração.
+    *   A instalação das dependências (`npm install` ou `yarn install`) falhou devido a problemas específicos do ambiente de desenvolvimento (Termux no Android).
+    *   Os erros estavam relacionados à compilação de dependências nativas (`@parcel/watcher`), que exigem o Android NDK, cuja configuração não estava disponível.
+    *   Após a correção do código, o `yarn test` falhou novamente com `eslint: not found`, indicando que as dependências não estavam instaladas. A tentativa de `yarn install` confirmou que a compilação do `@parcel/watcher` ainda é um impedimento devido à ausência do Android NDK.
+    *   Tentativas subsequentes de `yarn test` revelaram erros de linting (`defineComponent not found in 'vue'`) e incompatibilidade de versões do Vue (`Vue packages version mismatch`). Foram feitas tentativas de corrigir esses problemas localmente através de ajustes no `.eslintrc.js` e `package.json`, mas a execução local dos testes continua sendo impedida pelo problema persistente do Android NDK.
+
+## Conclusão
+
+A alteração no código é robusta e baseada em mecanismos padrão do Webpack para resolver este tipo de problema. Embora os testes não tenham podido ser executados localmente devido a limitações de ambiente (especificamente a necessidade do Android NDK para compilar dependências), a solução é considerada pronta para ser validada pelo sistema de Integração Contínua (CI) do próprio repositório no GitHub, que opera em um ambiente padronizado.
+
+O próximo passo é submeter um Pull Request com as alterações para que a equipe do Nuxt possa revisar e integrar a correção.
+
+---
+
+## Atualização do Processo de Desenvolvimento (02/07/2025) - CI Test Failures
+
+Os testes de CI para a Pull Request #645 falharam devido a múltiplos erros, principalmente relacionados à resolução de módulos e à cobertura de testes.
+
+### 1. Erros de Módulo Não Encontrado (`@babel/runtime/helpers`)
+
+Os logs do CI indicam falhas na resolução de módulos do `@babel/runtime/helpers`, como `defineProperty`, `slicedToArray`, `asyncToGenerator`, `classCallCheck`, `createClass`, `typeof`, e `toArray`. Os caminhos de erro (`.nuxt/utils.js`, `.nuxt/router.js`, `.nuxt/index.js`, `.nuxt/components`, `.nuxt/client.js`, `.nuxt/App.js`, `.nuxt/mixins/fetch.client.js`, `node_modules/ufo`) sugerem que o Webpack não está conseguindo localizar corretamente esses *helpers*.
+
+A solução proposta anteriormente de adicionar `config.resolve!.alias` para `@babel/runtime/helpers` em `packages/typescript-build/src/index.ts` foi implementada. No entanto, a persistência desses erros no CI sugere que a resolução do `path.resolve(this.options.rootDir!, 'node_modules/@babel/runtime/helpers')` pode estar incorreta no ambiente de CI. É possível que `this.options.rootDir` esteja apontando para um diretório aninhado (`/home/runner/work/typescript/typescript/`) em vez da raiz do repositório (`/home/runner/work/typescript/`), fazendo com que o `node_modules` seja procurado no local errado.
+
+### 2. Falhas na Cobertura de Testes (Jest)
+
+A cobertura global de testes não atingiu os limites esperados:
+*   **Statements:** 97.61% (esperado: 100%)
+*   **Branches:** 91.66% (esperado: 100%)
+*   **Lines:** 97.36% (esperado: 100%)
+*   **Functions:** 90% (esperado: 100%)
+
+### 3. Falhas nos Testes Unitários
+
+Os resultados do Jest indicaram:
+*   **Test Suites:** 1 falhou, 1 passou (2 no total).
+*   **Tests:** 5 falharam, 5 passaram (10 no total).
+
+### 4. Saída de Erro do Workflow
+
+O workflow falhou com a mensagem: `error Command failed with exit code 1.`
+
+### Próximos Passos
+
+A prioridade é investigar e corrigir a falha na resolução dos módulos `@babel/runtime/helpers`. Isso pode envolver ajustar o `path.resolve` no `index.ts` para garantir que ele aponte corretamente para o `node_modules` do projeto na raiz do repositório no ambiente de CI. As falhas de cobertura e testes unitários serão abordadas após a resolução dos problemas de dependência.
+
+## Atualização do Processo de Desenvolvimento (02/07/2025) - Tentativas de Sincronização e Resolução de Conflitos
+
+Após a análise das falhas do CI, foi identificada a necessidade de sincronizar a branch local com o fork remoto e resolver um conflito de merge. As seguintes ações foram tomadas:
+
+1.  **Descarte de Alterações Não Essenciais:** Alterações em `.eslintrc.js`, `package.json`, `yarn.lock` e `package-lock.json` (que não eram diretamente relacionadas à correção do bug principal) foram descartadas para garantir que o commit final contivesse apenas a correção essencial.
+
+2.  **Tentativa de `git pull --rebase`:** Foi tentado um `git pull --rebase my-fork fix-dynamic-import-alias` para integrar as mudanças do fork remoto e aplicar o commit local em cima delas. No entanto, esta operação resultou em um conflito de merge.
+
+3.  **Resolução de Conflito em `packages/typescript-build/src/index.ts`:** O conflito ocorreu na linha que define a expressão regular para o `test` das regras de módulos `.ts` e `.tsx`. A versão correta da expressão regular (`test: new RegExp(`\.${ext}$`),`) foi mantida, e o código duplicado e os marcadores de conflito foram removidos. Esta correção foi aplicada diretamente no arquivo.
+
+4.  **Continuação do Rebase:** Após a resolução manual do conflito, o `git add packages/typescript-build/src/index.ts` foi executado para marcar o conflito como resolvido. Em seguida, `git rebase --continue` foi utilizado para finalizar o rebase. Foi necessário definir a variável de ambiente `GIT_EDITOR=true` para evitar que o Git abrisse um editor interativo durante o processo de rebase.
+
+### Estado Atual
+
+A branch local `fix-dynamic-import-alias` está agora sincronizada com o fork remoto, e o commit contendo a correção da expressão regular em `packages/typescript-build/src/index.ts` foi aplicado com sucesso. O próximo passo é o `git push` para o fork remoto, o que acionará uma nova execução dos testes de CI.
+
+---
+
+## Fluxo de Pull Request (PR)
+
+Para submeter suas alterações como uma Pull Request para o repositório principal do Nuxt, siga estes passos:
+
+1.  **Faça o Push para o seu Fork:**
+    *   Certifique-se de que suas alterações estão commitadas localmente.
+    *   Envie suas alterações para o seu *próprio fork* no GitHub. Use o comando:
+        ```bash
+        git push --set-upstream my-fork fix-dynamic-import-alias
+        ```
+        (Substitua `my-fork` pelo nome do seu remote que aponta para o seu fork, se for diferente).
+    *   Você pode verificar seus remotes com `git remote -v`.
+
+2.  **Crie a Pull Request no GitHub:**
+    *   Após o push, visite a página do seu fork no GitHub (`https://github.com/MaxwellAt/typescript`).
+    *   Você verá um banner ou um botão indicando que sua branch `fix-dynamic-import-alias` tem commits recentes e pode ser comparada e ter uma Pull Request aberta.
+    *   Clique no botão para criar a Pull Request.
+    *   Certifique-se de que a base da PR seja a branch `main` (ou a branch de desenvolvimento apropriada) do repositório `nuxt/typescript` e que a sua branch seja a `fix-dynamic-import-alias` do seu fork.
+
+3.  **Preencha os Detalhes da PR:**
+    *   Forneça um título claro e conciso para a PR.
+    *   Escreva uma descrição detalhada das suas alterações, explicando o problema que você está resolvendo (referenciando a issue #520) e como sua solução funciona.
+    *   Se houver testes de CI que falharam anteriormente, mencione que você espera que esta correção os resolva.
+
+4.  **Aguarde a Revisão:**
+    *   A equipe do Nuxt revisará sua PR. Eles podem pedir alterações ou esclarecimentos.
+    *   Monitore os resultados do CI na sua PR. Se houver falhas, você precisará investigar e corrigir.

packages/typescript-build/src/index.ts

@@ -88,4 +88,6 @@ const tsModule: Module<Options> = function (moduleOptions) {
           }
         }
       ))
-    }
+    }
+  })
+}