fix(cli): avoid tsconfig paths/baseUrl conflict in workspace setup

Co-authored-by: EtienneLescot <215859519+EtienneLescot@users.noreply.github.com>

Author: Copilot

packages/cli/src/core/assets/n8n-workflows.d.ts

@@ -7,7 +7,7 @@
  * Provides TypeScript types for .workflow.ts files without requiring
  * a local installation of @n8n-as-code/transformer.
  *
- * Mapped as the @n8n-as-code/transformer module via tsconfig "paths".
+ * Exposes @n8n-as-code/transformer as an ambient module declaration.
  */
 
 // =========================================================================
@@ -160,6 +160,7 @@ export declare function node(options: NodeDecoratorOptions): PropertyDecorator;
 export declare function links(): MethodDecorator;
 
 
+declare module '@n8n-as-code/transformer' {
     // =========================================================================
     // WORKFLOW SETTINGS
     // =========================================================================

packages/cli/src/core/services/workspace-setup-service.ts

@@ -57,10 +57,6 @@ const TSCONFIG_CONTENT = JSON.stringify(
             target: 'ES2022',
             module: 'ESNext',
             moduleResolution: 'node',
-            paths: {
-                '*': ['./*'],
-                '@n8n-as-code/transformer': ['./n8n-workflows.d.ts'],
-            },
             experimentalDecorators: true,
             emitDecoratorMetadata: false,
             strict: false,

packages/cli/tests/unit/workspace-setup-service.test.ts

@@ -14,7 +14,7 @@ afterEach(() => {
 });
 
 describe('WorkspaceSetupService', () => {
-    it('writes a minimal tsconfig without baseUrl and with wildcard paths mapping', () => {
+    it('writes a minimal tsconfig without baseUrl and paths mapping', () => {
         const workflowDir = fs.mkdtempSync(path.join(os.tmpdir(), 'n8nac-workspace-'));
         tempDirs.push(workflowDir);
 
@@ -25,7 +25,19 @@ describe('WorkspaceSetupService', () => {
 
         const tsconfig = JSON.parse(fs.readFileSync(tsconfigPath, 'utf-8'));
         expect(tsconfig.compilerOptions.baseUrl).toBeUndefined();
-        expect(tsconfig.compilerOptions.paths['*']).toEqual(['./*']);
-        expect(tsconfig.compilerOptions.paths['@n8n-as-code/transformer']).toEqual(['./n8n-workflows.d.ts']);
+        expect(tsconfig.compilerOptions.paths).toBeUndefined();
+    });
+
+    it('writes declaration file with ambient module for @n8n-as-code/transformer', () => {
+        const workflowDir = fs.mkdtempSync(path.join(os.tmpdir(), 'n8nac-workspace-'));
+        tempDirs.push(workflowDir);
+
+        WorkspaceSetupService.ensureWorkspaceFiles(workflowDir);
+
+        const declarationPath = path.join(workflowDir, 'n8n-workflows.d.ts');
+        expect(fs.existsSync(declarationPath)).toBe(true);
+
+        const declaration = fs.readFileSync(declarationPath, 'utf-8');
+        expect(declaration).toContain("declare module '@n8n-as-code/transformer' {");
     });
 });