@testspectra/cli 1.1.7 → 1.1.8-rc.2

package/dist/config/schema.js

@@ -25,22 +25,12 @@ export const DEFAULT_CONFIG_DATA = {
         maxConcurrentSessions: '1',
         headless: true,
         implicitWait: '5000',
-        pageLoadTimeout: '30000',
-        scriptTimeout: '30000',
         parallelizationMode: 'testcase',
     },
-    browsers: [
-        {
-            id: 'chrome-desktop',
-            type: 'chrome',
-            mobileEmulation: false,
-        },
-    ],
     androidConfig: {
         driverServer: 'http://127.0.0.1:4800',
         appPackage: '',
         appActivity: '',
-        autoGrantPermissions: true,
         noReset: false,
         implicitWait: 10000,
         parallelizationMode: 'suite',
@@ -71,17 +61,11 @@ export const DEFAULT_CONFIG_DATA = {
             },
         ],
     },
-    loadConfig: {
-        virtualUsers: '10',
-        duration: '1m',
-    },
-    loadStages: [],
-    thresholds: [],
     executionConfig: {
         networkMonitoringEnabled: true,
         fastResponseTime: '200',
         normalResponseTime: '1000',
         monitoredDomains: [],
-        environmentVariables: [],
+        environmentVariables: {},
     },
 };

package/dist/generator/__tests__/tsconfig-isolation.test.js

@@ -261,7 +261,7 @@ describe('Platform TSConfigs & Type Isolation (docs/v2/cli/tsconfig-platform-iso
         expect(threw).toBe(true);
         expect(errorMessage).toContain("Cannot find name 'AuthLoginPage'");
     });
-    it('E2E: compiles the full Nx monorepo template via tsc -b with 0 errors', () => {
+    it('E2E: compiles the full Nx monorepo template via tsc -b with 0 errors', async () => {
         let root = process.cwd();
         while (root && root !== path.dirname(root)) {
             if (fs.existsSync(path.join(root, 'pnpm-workspace.yaml')))
@@ -269,8 +269,12 @@ describe('Platform TSConfigs & Type Isolation (docs/v2/cli/tsconfig-platform-iso
             root = path.dirname(root);
         }
         const nxTemplateDir = path.join(root, 'cli', 'templates', 'nx');
-        // Generate latest ambient types for the nx template
+        // Generate latest ambient types for the nx template, including env.d.ts (a separate async
+        // step — see TypeGenerator.syncEnvDeclaration — since spectra.config.ts's
+        // executionConfig.environmentVariables is what the template's EnvironmentConfig suite
+        // exercises via the typed Env global).
         TypeGenerator.generateAll(nxTemplateDir);
+        await TypeGenerator.syncEnvDeclaration(nxTemplateDir);
         expect(() => {
             execSync(`npx tsc -b ${nxTemplateDir}`, { stdio: 'pipe' });
         }).not.toThrow();

package/dist/generator/__tests__/type-generator.test.js

@@ -52,7 +52,7 @@ describe('TypeGenerator Engine (docs/v2/cli/ambient-types-generator.md)', () =>
         fs.writeFileSync(path.join(poDir, 'web.ts'), 'export default class LoginPage {\n  static username = "#user";\n  static async login() {}\n}');
         const stepDir = path.join(tmpDir, 'support', 'steps', 'loginAsAdmin');
         fs.mkdirSync(stepDir, { recursive: true });
-        fs.writeFileSync(path.join(stepDir, 'web.step.ts'), 'export default async function loginAsAdmin(role?: string) {}');
+        fs.writeFileSync(path.join(stepDir, 'web.step.ts'), 'export default async function (role?: string) {}');
         const fixDir = path.join(tmpDir, 'fixtures');
         fs.mkdirSync(fixDir, { recursive: true });
         fs.writeFileSync(path.join(fixDir, 'users.json'), JSON.stringify({ admin: { id: 101, email: 'admin@test.local' } }));

package/dist/generator/tsconfig-generator.js

@@ -31,7 +31,7 @@ export class TsConfigGenerator {
     static getStemExcludes(prefix, stems) {
         const excludes = [];
         for (const stem of stems) {
-            excludes.push(`${prefix}/**/page-objects/**/${stem}.ts`, `${prefix}/**/pageobjects/**/${stem}.ts`, `${prefix}/**/support/**/${stem}.*`, `${prefix}/**/global-hooks/**/${stem}.*`, `${prefix}/**/specs/**/hooks/**/${stem}.*`, `${prefix}/**/specs/**/${stem}.test.ts`, `${prefix}/**/${stem}.ts`, `${prefix}/**/${stem}.*`, `${prefix}/**/${stem}.*.ts`, `${prefix}/**/*.${stem}.ts`, `${prefix}/**/*.${stem}.*`, `${prefix}/**/*.${stem}.*.ts`);
+            excludes.push(`${prefix}/**/page-objects/**/${stem}.ts`, `${prefix}/**/support/**/${stem}.*`, `${prefix}/**/global-hooks/**/${stem}.*`, `${prefix}/**/specs/**/hooks/**/${stem}.*`, `${prefix}/**/specs/**/${stem}.test.ts`, `${prefix}/**/${stem}.ts`, `${prefix}/**/${stem}.*`, `${prefix}/**/${stem}.*.ts`, `${prefix}/**/*.${stem}.ts`, `${prefix}/**/*.${stem}.*`, `${prefix}/**/*.${stem}.*.ts`);
         }
         return excludes;
     }
@@ -41,21 +41,28 @@ export class TsConfigGenerator {
                 target: 'ES2022',
                 module: 'NodeNext',
                 moduleResolution: 'NodeNext',
+                jsx: 'react-jsx',
                 composite: true,
                 noEmit: true,
                 skipLibCheck: true,
                 strict: true,
-                types: ['node', '@wdio/globals/types', '@wdio/mocha-framework'],
+                types: ['node'],
             },
             include: [
                 '../types/web.d.ts',
                 '../types/fixtures.d.ts',
                 '../../**/specs/**/*.ts',
+                '../../**/specs/**/*.tsx',
                 '../../**/page-objects/**/*.ts',
-                '../../**/pageobjects/**/*.ts',
+                '../../**/page-objects/**/*.tsx',
                 '../../**/support/**/*.ts',
+                '../../**/support/**/*.tsx',
                 '../../**/global-hooks/**/*.ts',
+                '../../**/global-hooks/**/*.tsx',
                 '../../**/fixtures/**/*.ts',
+                '../../**/fixtures/**/*.json',
+                '../../**/src/**/*.ts',
+                '../../**/src/**/*.tsx',
                 '../../spectra.config.ts',
             ],
             exclude: [
@@ -74,21 +81,28 @@ export class TsConfigGenerator {
                 target: 'ES2022',
                 module: 'NodeNext',
                 moduleResolution: 'NodeNext',
+                jsx: 'react-jsx',
                 composite: true,
                 noEmit: true,
                 skipLibCheck: true,
                 strict: true,
-                types: ['node', '@wdio/globals/types', '@wdio/mocha-framework'],
+                types: ['node'],
             },
             include: [
                 '../types/mobile.d.ts',
                 '../types/fixtures.d.ts',
                 '../../**/specs/**/*.ts',
+                '../../**/specs/**/*.tsx',
                 '../../**/page-objects/**/*.ts',
-                '../../**/pageobjects/**/*.ts',
+                '../../**/page-objects/**/*.tsx',
                 '../../**/support/**/*.ts',
+                '../../**/support/**/*.tsx',
                 '../../**/global-hooks/**/*.ts',
+                '../../**/global-hooks/**/*.tsx',
                 '../../**/fixtures/**/*.ts',
+                '../../**/fixtures/**/*.json',
+                '../../**/src/**/*.ts',
+                '../../**/src/**/*.tsx',
                 '../../spectra.config.ts',
             ],
             exclude: [
@@ -107,21 +121,28 @@ export class TsConfigGenerator {
                 target: 'ES2022',
                 module: 'NodeNext',
                 moduleResolution: 'NodeNext',
+                jsx: 'react-jsx',
                 composite: true,
                 noEmit: true,
                 skipLibCheck: true,
                 strict: true,
-                types: ['node', '@wdio/globals/types', '@wdio/mocha-framework'],
+                types: ['node'],
             },
             include: [
                 '../types/android.d.ts',
                 '../types/fixtures.d.ts',
                 '../../**/specs/**/*.ts',
+                '../../**/specs/**/*.tsx',
                 '../../**/page-objects/**/*.ts',
-                '../../**/pageobjects/**/*.ts',
+                '../../**/page-objects/**/*.tsx',
                 '../../**/support/**/*.ts',
+                '../../**/support/**/*.tsx',
                 '../../**/global-hooks/**/*.ts',
+                '../../**/global-hooks/**/*.tsx',
                 '../../**/fixtures/**/*.ts',
+                '../../**/fixtures/**/*.json',
+                '../../**/src/**/*.ts',
+                '../../**/src/**/*.tsx',
                 '../../spectra.config.ts',
             ],
             exclude: [
@@ -140,21 +161,28 @@ export class TsConfigGenerator {
                 target: 'ES2022',
                 module: 'NodeNext',
                 moduleResolution: 'NodeNext',
+                jsx: 'react-jsx',
                 composite: true,
                 noEmit: true,
                 skipLibCheck: true,
                 strict: true,
-                types: ['node', '@wdio/globals/types', '@wdio/mocha-framework'],
+                types: ['node'],
             },
             include: [
                 '../types/ios.d.ts',
                 '../types/fixtures.d.ts',
                 '../../**/specs/**/*.ts',
+                '../../**/specs/**/*.tsx',
                 '../../**/page-objects/**/*.ts',
-                '../../**/pageobjects/**/*.ts',
+                '../../**/page-objects/**/*.tsx',
                 '../../**/support/**/*.ts',
+                '../../**/support/**/*.tsx',
                 '../../**/global-hooks/**/*.ts',
+                '../../**/global-hooks/**/*.tsx',
                 '../../**/fixtures/**/*.ts',
+                '../../**/fixtures/**/*.json',
+                '../../**/src/**/*.ts',
+                '../../**/src/**/*.tsx',
                 '../../spectra.config.ts',
             ],
             exclude: [
@@ -173,21 +201,23 @@ export class TsConfigGenerator {
                 target: 'ES2022',
                 module: 'NodeNext',
                 moduleResolution: 'NodeNext',
+                jsx: 'react-jsx',
                 composite: true,
                 noEmit: true,
                 skipLibCheck: true,
                 strict: true,
-                types: ['node', '@wdio/globals/types', '@wdio/mocha-framework'],
+                types: ['node'],
             },
             include: [
                 '../types/common.d.ts',
                 '../types/fixtures.d.ts',
                 '../../**/page-objects/**/common.ts',
-                '../../**/pageobjects/**/common.ts',
+                '../../**/page-objects/**/common.tsx',
                 '../../**/support/**/common.*',
                 '../../**/global-hooks/**/common.*',
                 '../../**/specs/**/hooks/**/common.*',
                 '../../**/specs/**/common.test.ts',
+                '../../**/specs/**/common.test.tsx',
                 '../../spectra.config.ts',
             ],
             exclude: [
@@ -215,7 +245,7 @@ export class TsConfigGenerator {
         const relCache = path.relative(subConfigDir, path.join(options.cwd, '.testspectra', 'cache')).replace(/\\/g, '/');
         const platformDts = `${relTypesDir}/${platform}.d.ts`;
         const fixturesDts = `${relTypesDir}/fixtures.d.ts`;
-        const include = [platformDts, fixturesDts, `${relScope}/**/*.ts`, relSpectraConfig];
+        const include = [platformDts, fixturesDts, `${relScope}/**/*.ts`, `${relScope}/**/*.tsx`, relSpectraConfig];
         const baseExcludes = [relNodeModules, relDist, relReports, relRuns, relCache];
         const stemMap = {
             web: ['android', 'ios', 'mobile'],
@@ -234,7 +264,7 @@ export class TsConfigGenerator {
                 noEmit: true,
                 skipLibCheck: true,
                 strict: true,
-                types: ['node', '@wdio/globals/types', '@wdio/mocha-framework'],
+                types: ['node'],
             },
             include,
             exclude: [...baseExcludes, ...platformExcludes],
@@ -269,9 +299,7 @@ export class TsConfigGenerator {
         const sharedScope = scopes.find((s) => s.isShared);
         const featureScopes = scopes.filter((s) => !s.isShared);
         const hasScopes = Boolean(sharedScope || featureScopes.length > 0);
-        const hasRootEntities = fs.existsSync(path.join(cwd, 'specs')) ||
-            fs.existsSync(path.join(cwd, 'page-objects')) ||
-            fs.existsSync(path.join(cwd, 'pageobjects'));
+        const hasRootEntities = fs.existsSync(path.join(cwd, 'specs')) || fs.existsSync(path.join(cwd, 'page-objects'));
         if (!hasScopes || hasRootEntities) {
             for (const filename of Object.keys(platformConfigs)) {
                 references.push({ path: `./tsconfig/${filename}` });

package/dist/generator/type-generator.d.ts

@@ -18,11 +18,23 @@ export interface EntityScope {
  *    - Directory with page-objects/support/fixtures and NO specs => Shared Scope
  */
 export declare function discoverEntityScopes(cwd: string): EntityScope[];
+/**
+ * Detects a component-testing project (`@testspectra/react`'s Vitest browser-mode runner), via
+ * the same signal `cli/src/commands/test.ts` uses to gate `spectra test` itself. Used to augment
+ * the generated `Spectra` ambient type with `.mount()`, which only exists in that runtime.
+ */
+export declare function isComponentTestingProject(cwd: string): boolean;
 export declare class TypeGenerator {
     /**
      * Main entry point to generate all ambient type declarations.
      */
     static generateAll(cwd: string): void;
+    /**
+     * Reloads `spectra.config.ts` and refreshes `.testspectra/types/env.d.ts` with the current
+     * `executionConfig.environmentVariables`. Separate from `writeDeclarationFiles`/`generateAll`
+     * (which must stay synchronous) because reading the config file is unavoidably async.
+     */
+    static syncEnvDeclaration(cwd: string): Promise<void>;
     /**
      * Discovers all feature directories and shared library directories.
      * Returns a map of scope -> base directory
@@ -30,7 +42,18 @@ export declare class TypeGenerator {
     static getEntityScopes(cwd: string): EntityScope[];
     static getPageObjectsDirsForScope(scopeDir: string, sharedDir?: string): string[];
     static getEntityDirsForScope(entityType: 'actions' | 'steps' | 'fixtures', scopeDir: string, sharedDir?: string): string[];
-    static generateDeclarationsForScope(cwd: string, outputTypesDir: string, scopeDir: string, sharedDir?: string): Record<PlatformTarget, string>;
+    static generateDeclarationsForScope(cwd: string, outputTypesDir: string, scopeDir: string, sharedDir?: string, rootTypesDir?: string): Record<PlatformTarget, string>;
     static generateFixturesDeclarationForScope(cwd: string, outputTypesDir: string, scopeDir: string, sharedDir?: string): string;
+    /**
+     * Generates the typed `Spectra.env` ambient declaration from `spectra.config.ts`'s
+     * `executionConfig.environmentVariables` — mirrors `generateFixturesDeclarationForScope`, but
+     * env vars come from a single project-level config rather than a scanned directory.
+     *
+     * Emits a bare global `interface SpectraEnv { readonly KEY: string; ... }`, which TypeScript
+     * interface-merges with the empty `SpectraEnv` shipped by `@testspectra/matchers` (the same
+     * mechanism `@types/node` uses for projects to augment `NodeJS.ProcessEnv`) — so `Spectra.env.KEY`
+     * resolves to `string`, never `string | undefined` like raw `process.env.KEY`.
+     */
+    static generateEnvDeclaration(environmentVariables: Record<string, string>): string;
     static writeDeclarationFiles(cwd: string): void;
 }

package/dist/generator/type-generator.js

@@ -1,5 +1,6 @@
 import fs from 'fs';
 import path from 'path';
+import { ConfigLoader } from '../config/loader.js';
 import { TsConfigGenerator } from './tsconfig-generator.js';
 export const PLATFORM_HIERARCHY = {
     web: ['web', 'common'],
@@ -180,6 +181,23 @@ export function discoverEntityScopes(cwd) {
     fallbackScan(cwd, 5);
     return scopes;
 }
+/**
+ * Detects a component-testing project (`@testspectra/react`'s Vitest browser-mode runner), via
+ * the same signal `cli/src/commands/test.ts` uses to gate `spectra test` itself. Used to augment
+ * the generated `Spectra` ambient type with `.mount()`, which only exists in that runtime.
+ */
+export function isComponentTestingProject(cwd) {
+    try {
+        const pkgPath = path.join(cwd, 'package.json');
+        if (!fs.existsSync(pkgPath))
+            return false;
+        const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+        return Boolean(pkg.dependencies?.['@testspectra/react'] || pkg.devDependencies?.['@testspectra/react']);
+    }
+    catch {
+        return false;
+    }
+}
 export class TypeGenerator {
     /**
      * Main entry point to generate all ambient type declarations.
@@ -188,6 +206,24 @@ export class TypeGenerator {
         this.writeDeclarationFiles(cwd);
         TsConfigGenerator.scaffoldConfigs(cwd);
     }
+    /**
+     * Reloads `spectra.config.ts` and refreshes `.testspectra/types/env.d.ts` with the current
+     * `executionConfig.environmentVariables`. Separate from `writeDeclarationFiles`/`generateAll`
+     * (which must stay synchronous) because reading the config file is unavoidably async.
+     */
+    static async syncEnvDeclaration(cwd) {
+        const rootTypesDir = path.join(cwd, '.testspectra', 'types');
+        if (!fs.existsSync(rootTypesDir)) {
+            fs.mkdirSync(rootTypesDir, { recursive: true });
+        }
+        let environmentVariables = {};
+        try {
+            const config = await ConfigLoader.loadConfig(cwd);
+            environmentVariables = config.executionConfig?.environmentVariables ?? {};
+        }
+        catch { }
+        fs.writeFileSync(path.join(rootTypesDir, 'env.d.ts'), this.generateEnvDeclaration(environmentVariables), 'utf-8');
+    }
     /**
      * Discovers all feature directories and shared library directories.
      * Returns a map of scope -> base directory
@@ -267,10 +303,11 @@ export class TypeGenerator {
         }
         return dirs;
     }
-    static generateDeclarationsForScope(cwd, outputTypesDir, scopeDir, sharedDir) {
+    static generateDeclarationsForScope(cwd, outputTypesDir, scopeDir, sharedDir, rootTypesDir) {
         const poDirs = this.getPageObjectsDirsForScope(scopeDir, sharedDir);
         const actionsDirs = this.getEntityDirsForScope('actions', scopeDir, sharedDir);
         const stepsDirs = this.getEntityDirsForScope('steps', scopeDir, sharedDir);
+        const isComponentTesting = isComponentTestingProject(cwd);
         const platforms = ['web', 'android', 'ios', 'mobile', 'common'];
         const results = {
             web: '',
@@ -279,14 +316,39 @@ export class TypeGenerator {
             mobile: '',
             common: '',
         };
+        // `env.d.ts` always lives at the workspace root types dir (env vars come from a single
+        // `spectra.config.ts`, unlike per-scope fixtures/page-objects), so a shared/feature scope's
+        // own declarations reference it via a relative path back up to the root.
+        let envRefPath = './env.d.ts';
+        if (rootTypesDir && rootTypesDir !== outputTypesDir) {
+            envRefPath = path.relative(outputTypesDir, path.join(rootTypesDir, 'env.d.ts')).replace(/\\/g, '/');
+            if (!envRefPath.startsWith('.'))
+                envRefPath = `./${envRefPath}`;
+        }
         for (const platform of platforms) {
             const hierarchy = PLATFORM_HIERARCHY[platform];
             let content = `// Auto-generated ambient declarations for TestSpectra [${platform.toUpperCase()}]\n`;
             content += `// Managed automatically by TestSpectra Language Service Plugin.\n\n`;
-            content += `/// <reference types="@wdio/globals/types" />\n`;
-            content += `/// <reference types="@wdio/mocha-framework" />\n`;
+            // TestSpectra's Rust-native orchestrator worker (core/orchestrator/src/worker/bdd_runner.ts)
+            // registers its own `it`/`test`/lifecycle-hook globals directly — there is no WDIO or Mocha
+            // runtime involved at all (not just for component testing; this is true across every
+            // platform). `describe` is intentionally NOT declared here even though the runtime has a
+            // transparent no-op implementation of it — spec-schema-linter's no-describe-block rule
+            // forbids authoring it, so leaving it undeclared makes that a compile error too, not just a
+            // lint error.
+            content += `declare function it(title: string, fn: () => Promise<void> | void): void;\n`;
+            if (isComponentTesting) {
+                // Vitest's own `expect` global (test.globals: true in tools/react/vitest.config.ts) — the
+                // one thing component specs legitimately need beyond the Spectra.* DSL, for asserting
+                // plain closure/callback state (e.g. "was this onClick handler invoked") that has no DOM
+                // element to target. Reuses @testspectra/react's own re-exported `ExpectStatic` type
+                // rather than hand-duplicating Vitest's expect API surface. Not declared for E2E projects
+                // — the Rust orchestrator's BDD runtime has no `expect` global at all.
+                content += `declare const expect: import('@testspectra/react').ExpectStatic;\n`;
+            }
             content += `/// <reference types="@testspectra/matchers" />\n`;
-            content += `/// <reference path="./fixtures.d.ts" />\n\n`;
+            content += `/// <reference path="./fixtures.d.ts" />\n`;
+            content += `/// <reference path="${envRefPath}" />\n\n`;
             // 1. Page Objects Global Declarations
             const declaredPOMs = new Set();
             for (const poDir of poDirs) {
@@ -423,7 +485,10 @@ export class TypeGenerator {
                 }
             }
             content += `}\n`;
-            content += `type TestSpectraActions = import('@testspectra/matchers').SpectraStatic & TestSpectraCustomActions;\n`;
+            // Reuses @testspectra/react's own exported `mount` type rather than hand-duplicating its
+            // signature here — stays in sync automatically if that signature ever changes.
+            const mountAugment = isComponentTesting ? ` & { mount: typeof import('@testspectra/react').mount }` : '';
+            content += `type TestSpectraActions = import('@testspectra/matchers').SpectraStatic & TestSpectraCustomActions${mountAugment};\n`;
             content += `declare const Spectra: TestSpectraActions;\n\n`;
             // 3. Built-in Steps Declaration
             content += `interface TestSpectraSteps {\n`;
@@ -543,11 +608,42 @@ export class TypeGenerator {
         content += `declare const Fixture: TestSpectraFixtures;\n`;
         return content;
     }
+    /**
+     * Generates the typed `Spectra.env` ambient declaration from `spectra.config.ts`'s
+     * `executionConfig.environmentVariables` — mirrors `generateFixturesDeclarationForScope`, but
+     * env vars come from a single project-level config rather than a scanned directory.
+     *
+     * Emits a bare global `interface SpectraEnv { readonly KEY: string; ... }`, which TypeScript
+     * interface-merges with the empty `SpectraEnv` shipped by `@testspectra/matchers` (the same
+     * mechanism `@types/node` uses for projects to augment `NodeJS.ProcessEnv`) — so `Spectra.env.KEY`
+     * resolves to `string`, never `string | undefined` like raw `process.env.KEY`.
+     */
+    static generateEnvDeclaration(environmentVariables) {
+        let content = `// Auto-generated ambient Spectra.env declarations for TestSpectra\n`;
+        content += `// Managed automatically by TestSpectra Language Service Plugin.\n\n`;
+        content += `interface SpectraEnv {\n`;
+        for (const key of Object.keys(environmentVariables)) {
+            content += `  readonly ${JSON.stringify(key)}: string;\n`;
+        }
+        content += `}\n`;
+        return content;
+    }
     static writeDeclarationFiles(cwd) {
         const rootTypesDir = path.join(cwd, '.testspectra', 'types');
         if (!fs.existsSync(rootTypesDir)) {
             fs.mkdirSync(rootTypesDir, { recursive: true });
         }
+        // env.d.ts always lives at the root, regardless of Nx scopes — a single spectra.config.ts's
+        // executionConfig.environmentVariables applies workspace-wide (see generateEnvDeclaration).
+        // Reading spectra.config.ts itself is unavoidably async (ESM dynamic import), which would ripple
+        // an async signature through every caller of this long-standing sync method — instead, this only
+        // guarantees env.d.ts *exists* (so the reference below never points at a missing file) and
+        // leaves it accurate as of the last real sync. `syncEnvDeclaration` (called at the actual
+        // execution entry points: run/watch/sync-types) is what keeps its content up to date.
+        const envDtsPath = path.join(rootTypesDir, 'env.d.ts');
+        if (!fs.existsSync(envDtsPath)) {
+            fs.writeFileSync(envDtsPath, this.generateEnvDeclaration({}), 'utf-8');
+        }
         const scopes = this.getEntityScopes(cwd);
         const sharedScope = scopes.find((s) => s.isShared);
         const featureScopes = scopes.filter((s) => !s.isShared);
@@ -561,7 +657,7 @@ export class TypeGenerator {
         if (!hasScopes || hasRootEntities) {
             const rootFixtures = this.generateFixturesDeclarationForScope(cwd, rootTypesDir, cwd);
             fs.writeFileSync(path.join(rootTypesDir, 'fixtures.d.ts'), rootFixtures, 'utf-8');
-            const rootDeclarations = this.generateDeclarationsForScope(cwd, rootTypesDir, cwd);
+            const rootDeclarations = this.generateDeclarationsForScope(cwd, rootTypesDir, cwd, undefined, rootTypesDir);
             for (const [platform, content] of Object.entries(rootDeclarations)) {
                 fs.writeFileSync(path.join(rootTypesDir, `${platform}.d.ts`), content, 'utf-8');
             }
@@ -587,7 +683,7 @@ export class TypeGenerator {
                 fs.mkdirSync(sharedTypesDir, { recursive: true });
             const sharedFixtures = this.generateFixturesDeclarationForScope(cwd, sharedTypesDir, sharedScope.dir);
             fs.writeFileSync(path.join(sharedTypesDir, 'fixtures.d.ts'), sharedFixtures, 'utf-8');
-            const sharedDeclarations = this.generateDeclarationsForScope(cwd, sharedTypesDir, sharedScope.dir);
+            const sharedDeclarations = this.generateDeclarationsForScope(cwd, sharedTypesDir, sharedScope.dir, undefined, rootTypesDir);
             for (const [platform, content] of Object.entries(sharedDeclarations)) {
                 fs.writeFileSync(path.join(sharedTypesDir, `${platform}.d.ts`), content, 'utf-8');
             }
@@ -609,7 +705,7 @@ export class TypeGenerator {
                 fs.mkdirSync(featureTypesDir, { recursive: true });
             const featureFixtures = this.generateFixturesDeclarationForScope(cwd, featureTypesDir, feature.dir, sharedScope?.dir);
             fs.writeFileSync(path.join(featureTypesDir, 'fixtures.d.ts'), featureFixtures, 'utf-8');
-            const featureDeclarations = this.generateDeclarationsForScope(cwd, featureTypesDir, feature.dir, sharedScope?.dir);
+            const featureDeclarations = this.generateDeclarationsForScope(cwd, featureTypesDir, feature.dir, sharedScope?.dir, rootTypesDir);
             for (const [platform, content] of Object.entries(featureDeclarations)) {
                 fs.writeFileSync(path.join(featureTypesDir, `${platform}.d.ts`), content, 'utf-8');
             }

package/dist/index.d.ts

@@ -2,9 +2,9 @@ import { Command } from 'commander';
 export * from './config/schema.js';
 export * from './config/loader.js';
 export * from './generator/index.js';
-export * from './lifecycle/index.js';
 export * from './refactor/index.js';
 export * from './mobile/index.js';
+export * from './linter/index.js';
 export * from './types/generator.js';
 export * from '@testspectra/matchers';
 export declare function createCliProgram(): Command;