create-playwright-ts-framework 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 create-playwright-ts-framework contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,66 @@
+# Playwright + TypeScript Automation Framework Scaffold
+
+`create-playwright-ts-framework` is an interactive, composable CLI generator for strict TypeScript Playwright projects. It can generate BDD (`playwright-bdd`) or standard Playwright Test projects with UI, API, or combined automation, environment-specific data, optional Allure reporting, and optional GitHub Actions.
+
+> The package name is provisional. This repository is prepared for publication but has not been published.
+
+## Requirements
+
+Node.js 22 or newer and npm 10 or newer are recommended for developing and packaging the generator.
+
+## Local CLI usage
+
+```bash
+npm install
+npm run build
+npm link
+create-playwright-ts-framework
+```
+
+Or test without linking:
+
+```bash
+node dist/cli/index.js
+```
+
+The prompts choose project name, framework style, test type, Allure, GitHub Actions, and automatic dependency installation. Every project includes smoke and UAT data; runtime selection is centralized in `config/run.config.json` rather than asked during generation.
+
+## Generator architecture
+
+```text
+src/
+├── cli/                 prompts, presentation, process orchestration
+├── generators/          conditional project composition
+├── utils/               validation and filesystem utilities
+├── templates/
+│   ├── common/          config, fixtures, data, scripts, docs
+│   ├── bdd/             Gherkin, steps, playwright-bdd config
+│   ├── non-bdd/         standard Playwright specs
+│   ├── ui/              Page Object layer
+│   ├── api/             request/client/service/model/validator layers
+│   ├── allure/          runtime metadata
+│   └── github/          CI workflow
+└── types.ts
+```
+
+Templates are copied and composed based on the selected capabilities; unused test layers are removed. Placeholder substitution is limited to configuration values and small conditional source fragments—project files remain individually maintainable templates.
+
+## Development
+
+```bash
+npm run build
+npm run typecheck
+npm run lint
+npm test
+npm run format:check
+```
+
+Generator tests create all six BDD/non-BDD × UI/API/UI+API combinations in temporary directories and assert inclusion/exclusion rules. See the README generated inside each project for framework commands, architecture, test data, secrets, Allure, and CI guidance.
+
+## Publishing checklist
+
+Before a future release: confirm the final npm name, update repository/author metadata, run `npm pack --dry-run`, choose and tag a release version, authenticate with npm, and publish. Publishing is deliberately outside this phase.
+
+## License
+
+MIT

package/dist/cli/generator.d.ts

@@ -0,0 +1,2 @@
+import type { GeneratorOptions } from '../types.js';
+export declare function runGenerator(options: GeneratorOptions): Promise<void>;

package/dist/cli/generator.js

@@ -0,0 +1,43 @@
+import ora from 'ora';
+import { spawn } from 'node:child_process';
+import { generateProject } from '../generators/project.generator.js';
+function install(cwd) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(process.platform === 'win32' ? 'npm.cmd' : 'npm', ['install'], { cwd, stdio: 'inherit' });
+        const timeout = setTimeout(() => {
+            child.kill();
+            reject(new Error('npm install timed out after 3 minutes. The framework files were created; run npm install inside the project when network access is available.'));
+        }, 180_000);
+        child.on('error', error => { clearTimeout(timeout); reject(error); });
+        child.on('exit', code => {
+            clearTimeout(timeout);
+            if (code === 0)
+                resolve();
+            else
+                reject(new Error(`npm install exited with code ${String(code)}. The framework files were created; run npm install inside the project to retry.`));
+        });
+    });
+}
+export async function runGenerator(options) {
+    const spinner = ora('Creating framework').start();
+    try {
+        await generateProject(options);
+        spinner.succeed('Framework files created');
+    }
+    catch (error) {
+        spinner.fail('Framework creation failed');
+        throw error;
+    }
+    if (options.installDependencies) {
+        spinner.start('Installing dependencies (this may take a few minutes on the first run)');
+        try {
+            await install(options.destination);
+            spinner.succeed('Dependencies installed');
+        }
+        catch (error) {
+            spinner.fail('Dependency installation failed');
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=generator.js.map

package/dist/cli/generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../src/cli/generator.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAErE,SAAS,OAAO,CAAC,GAAW;IAC1B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,SAAS,CAAC,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QAC9G,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;YAC9B,KAAK,CAAC,IAAI,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,KAAK,CAAC,+IAA+I,CAAC,CAAC,CAAC;QACrK,CAAC,EAAE,OAAO,CAAC,CAAC;QACZ,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACtE,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE;YACtB,YAAY,CAAC,OAAO,CAAC,CAAC;YACtB,IAAI,IAAI,KAAK,CAAC;gBAAE,OAAO,EAAE,CAAC;;gBACrB,MAAM,CAAC,IAAI,KAAK,CAAC,gCAAgC,MAAM,CAAC,IAAI,CAAC,kFAAkF,CAAC,CAAC,CAAC;QACzJ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAyB;IAC1D,MAAM,OAAO,GAAG,GAAG,CAAC,oBAAoB,CAAC,CAAC,KAAK,EAAE,CAAC;IAClD,IAAI,CAAC;QACH,MAAM,eAAe,CAAC,OAAO,CAAC,CAAC;QAC/B,OAAO,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;QAC1C,MAAM,KAAK,CAAC;IACd,CAAC;IACD,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;QAChC,OAAO,CAAC,KAAK,CAAC,wEAAwE,CAAC,CAAC;QACxF,IAAI,CAAC;YAAC,MAAM,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;YAAC,OAAO,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAC;QAAC,CAAC;QACtF,OAAO,KAAK,EAAE,CAAC;YAAC,OAAO,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;YAAC,MAAM,KAAK,CAAC;QAAC,CAAC;IAChF,CAAC;AACH,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli/index.js

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+import { collectOptions } from './prompts.js';
+import { runGenerator } from './generator.js';
+import { logger } from './logger.js';
+async function main() {
+    if (Number.parseInt(process.versions.node.split('.')[0] ?? '0', 10) < 20)
+        throw new Error('Node.js 20 or newer is required.');
+    logger.heading();
+    const options = await collectOptions();
+    await runGenerator(options);
+    logger.success('Framework successfully created.');
+    console.log(`\nNext:\n  cd ${options.projectName}\n  npm run test:smoke`);
+}
+main().catch((error) => {
+    logger.error(error instanceof Error ? error.message : String(error));
+    if (process.env.DEBUG && error instanceof Error)
+        console.error(error.stack);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,KAAK,UAAU,IAAI;IACjB,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IAC9H,MAAM,CAAC,OAAO,EAAE,CAAC;IACjB,MAAM,OAAO,GAAG,MAAM,cAAc,EAAE,CAAC;IACvC,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;IAC5B,MAAM,CAAC,OAAO,CAAC,iCAAiC,CAAC,CAAC;IAClD,OAAO,CAAC,GAAG,CAAC,iBAAiB,OAAO,CAAC,WAAW,wBAAwB,CAAC,CAAC;AAC5E,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,MAAM,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACrE,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,KAAK,YAAY,KAAK;QAAE,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC5E,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}

package/dist/cli/logger.d.ts

@@ -0,0 +1,6 @@
+export declare const logger: {
+    heading: () => void;
+    info: (message: string) => void;
+    success: (message: string) => void;
+    error: (message: string) => void;
+};

package/dist/cli/logger.js

@@ -0,0 +1,8 @@
+import chalk from 'chalk';
+export const logger = {
+    heading: () => console.log(chalk.bold.cyan('\n🚀 Playwright TypeScript Framework Generator\n')),
+    info: (message) => console.log(chalk.blue('ℹ'), message),
+    success: (message) => console.log(chalk.green('✔'), message),
+    error: (message) => console.error(chalk.red('✖'), message),
+};
+//# sourceMappingURL=logger.js.map

package/dist/cli/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/cli/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,OAAO,EAAE,GAAS,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;IACrG,IAAI,EAAE,CAAC,OAAe,EAAQ,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;IACtE,OAAO,EAAE,CAAC,OAAe,EAAQ,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;IAC1E,KAAK,EAAE,CAAC,OAAe,EAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;CACzE,CAAC"}

package/dist/cli/prompts.d.ts

@@ -0,0 +1,2 @@
+import type { GeneratorOptions } from '../types.js';
+export declare function collectOptions(cwd?: string): Promise<GeneratorOptions>;

package/dist/cli/prompts.js

@@ -0,0 +1,13 @@
+import { confirm, input, select } from '@inquirer/prompts';
+import { resolve } from 'node:path';
+import { validateProjectName } from '../utils/project-name.js';
+export async function collectOptions(cwd = process.cwd()) {
+    const projectName = await input({ message: 'Project name:', default: 'my-playwright-framework', validate: validateProjectName });
+    const framework = await select({ message: 'Select framework style:', choices: [{ name: 'BDD', value: 'bdd' }, { name: 'Non-BDD', value: 'non-bdd' }] });
+    const testingType = await select({ message: 'Select testing type:', choices: [{ name: 'UI', value: 'ui' }, { name: 'API', value: 'api' }, { name: 'UI + API', value: 'ui-api' }] });
+    const allure = await confirm({ message: 'Include Allure reporting?', default: true });
+    const githubActions = await confirm({ message: 'Include GitHub Actions?', default: true });
+    const installDependencies = await confirm({ message: 'Install dependencies automatically?', default: true });
+    return { projectName, destination: resolve(cwd, projectName), framework, testingType, allure, githubActions, installDependencies };
+}
+//# sourceMappingURL=prompts.js.map

package/dist/cli/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/cli/prompts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;IACtD,MAAM,WAAW,GAAG,MAAM,KAAK,CAAC,EAAE,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,yBAAyB,EAAE,QAAQ,EAAE,mBAAmB,EAAE,CAAC,CAAC;IACjI,MAAM,SAAS,GAAG,MAAM,MAAM,CAAiB,EAAE,OAAO,EAAE,yBAAyB,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC;IACxK,MAAM,WAAW,GAAG,MAAM,MAAM,CAAc,EAAE,OAAO,EAAE,sBAAsB,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;IACjM,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,EAAE,OAAO,EAAE,2BAA2B,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACtF,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC,EAAE,OAAO,EAAE,yBAAyB,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3F,MAAM,mBAAmB,GAAG,MAAM,OAAO,CAAC,EAAE,OAAO,EAAE,qCAAqC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7G,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,CAAC,GAAG,EAAE,WAAW,CAAC,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,mBAAmB,EAAE,CAAC;AACrI,CAAC"}

package/dist/generators/project.generator.d.ts

@@ -0,0 +1,2 @@
+import type { GeneratorOptions } from '../types.js';
+export declare function generateProject(options: GeneratorOptions): Promise<void>;

package/dist/generators/project.generator.js

@@ -0,0 +1,84 @@
+import { access, mkdir, rm } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { copyTemplate, replaceTokens } from '../utils/files.js';
+import { validateProjectName } from '../utils/project-name.js';
+const templateRoot = join(dirname(fileURLToPath(import.meta.url)), '..', 'templates');
+const environments = ['smoke', 'uat'];
+const hasUi = (type) => type !== 'api';
+const hasApi = (type) => type !== 'ui';
+export async function generateProject(options) {
+    const validity = validateProjectName(options.projectName);
+    if (validity !== true)
+        throw new Error(validity);
+    if (!['bdd', 'non-bdd'].includes(options.framework))
+        throw new Error(`Unsupported framework style: ${String(options.framework)}`);
+    if (!['ui', 'api', 'ui-api'].includes(options.testingType))
+        throw new Error(`Unsupported testing type: ${String(options.testingType)}`);
+    try {
+        await access(options.destination);
+        throw new Error(`Destination already exists: ${options.destination}\nChoose a different project name or remove that existing folder first.`);
+    }
+    catch (error) {
+        if (error instanceof Error && error.message.startsWith('Destination already exists'))
+            throw error;
+        if (!(error instanceof Error) || !('code' in error) || error.code !== 'ENOENT')
+            throw error;
+    }
+    await mkdir(options.destination, { recursive: false });
+    try {
+        await copyTemplate(join(templateRoot, 'common'), options.destination);
+        await copyTemplate(join(templateRoot, options.framework), options.destination);
+        if (hasUi(options.testingType))
+            await copyTemplate(join(templateRoot, 'ui'), options.destination);
+        if (hasApi(options.testingType))
+            await copyTemplate(join(templateRoot, 'api'), options.destination);
+        if (options.allure)
+            await copyTemplate(join(templateRoot, 'allure'), options.destination);
+        if (options.githubActions)
+            await copyTemplate(join(templateRoot, 'github'), options.destination);
+        if (!hasUi(options.testingType)) {
+            await rm(join(options.destination, options.framework === 'bdd' ? 'features/ui' : 'tests/ui'), { recursive: true, force: true });
+            await rm(join(options.destination, 'steps/ui'), { recursive: true, force: true });
+        }
+        if (!hasApi(options.testingType)) {
+            await rm(join(options.destination, options.framework === 'bdd' ? 'features/api' : 'tests/api'), { recursive: true, force: true });
+            await rm(join(options.destination, 'steps/api'), { recursive: true, force: true });
+        }
+        for (const env of environments) {
+            const environmentData = join(options.destination, 'test-data', env);
+            await copyTemplate(join(templateRoot, 'common', 'test-data', '__ENV__'), environmentData);
+            await replaceTokens(environmentData, { ENV_NAME: env });
+        }
+        await rm(join(options.destination, 'test-data', '__ENV__'), { recursive: true, force: true });
+        const envUnion = environments.map(value => `'${value}'`).join(' | ');
+        await replaceTokens(options.destination, {
+            PROJECT_NAME: options.projectName,
+            FRAMEWORK: options.framework,
+            TESTING_TYPE: options.testingType,
+            ENVIRONMENTS_JSON: JSON.stringify(environments),
+            ENVIRONMENT_TYPE: envUnion,
+            DEFAULT_ENV: 'smoke',
+            SCOPE_SCRIPTS: `${hasUi(options.testingType) ? ',\n    "test:ui": "cross-env TEST_SCOPE=ui npm test"' : ''}${hasApi(options.testingType) ? ',\n    "test:api": "cross-env TEST_SCOPE=api npm test"' : ''}`,
+            ALLURE_REPORTER: options.allure ? ", ['allure-playwright', { outputFolder: 'allure-results' }]" : '',
+            ALLURE_DEPS: options.allure ? ',\n    "allure-commandline": "^2.43.0",\n    "allure-playwright": "^3.12.1"' : '',
+            ALLURE_SCRIPTS: options.allure ? ',\n    "allure": "allure generate allure-results --clean -o allure-report",\n    "allure:open": "allure open allure-report",\n    "allure:report": "allure generate allure-results --clean --single-file -o reports && node scripts/rename-allure-report.mjs"' : '',
+            BDD_DEPS: options.framework === 'bdd' ? ',\n    "playwright-bdd": "^9.2.1"' : '',
+            BDD_SCRIPT: options.framework === 'bdd' ? ',\n    "bddgen": "bddgen"' : '',
+            PREPARE_ALLURE: options.allure ? "spawnSync(process.execPath, ['scripts/prepare-allure.mjs'], { stdio: 'inherit', env });\n" : '',
+            BDD_CONFIG_IMPORT: options.framework === 'bdd' ? "import { testDir } from './bdd.config.js';" : '',
+            TEST_DIR: options.framework === 'bdd' ? 'testDir' : "'./tests'",
+            BDD_PRE: options.framework === 'bdd' ? "const pre = spawnSync(runner, ['bddgen'], { stdio: 'inherit', env });\nif (pre.status !== 0) process.exit(pre.status ?? 1);\n" : '',
+            ENV_IMPORT: hasApi(options.testingType) ? "import { getEnvironmentConfig } from '../utils/EnvConfig.js';" : '',
+            BASE_TEST_IMPORT: options.framework === 'bdd' ? "import { test as base } from 'playwright-bdd';" : "import { test as base } from '@playwright/test';",
+            FIXTURE_IMPORTS: `${hasUi(options.testingType) ? "import { LoginPage } from '../pages/LoginPage.js';\n" : ''}${hasApi(options.testingType) ? "import { ApiClient } from '../api/clients/ApiClient.js';\nimport { UserService } from '../api/services/UserService.js';\n" : ''}`,
+            FIXTURE_TYPES: `${hasUi(options.testingType) ? '  app: { loginPage: LoginPage };\n' : ''}${hasApi(options.testingType) ? '  api: { userService: UserService };\n' : ''}`,
+            FIXTURE_VALUES: `${hasUi(options.testingType) ? "  app: async ({ page }, use) => { await use({ loginPage: new LoginPage(page) }); },\n" : ''}${hasApi(options.testingType) ? "  api: async ({ playwright }, use) => {\n    const context = await playwright.request.newContext({ baseURL: getEnvironmentConfig().apiBaseUrl });\n    await use({ userService: new UserService(new ApiClient(context)) });\n    await context.dispose();\n  },\n" : ''}`,
+        });
+    }
+    catch (error) {
+        await rm(options.destination, { recursive: true, force: true });
+        throw new Error(`Could not create framework: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
+    }
+}
+//# sourceMappingURL=project.generator.js.map

package/dist/generators/project.generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.generator.js","sourceRoot":"","sources":["../../src/generators/project.generator.ts"],"names":[],"mappings":"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"}

package/dist/templates/allure/scripts/prepare-allure.mjs

@@ -0,0 +1,9 @@
+import { mkdir, writeFile } from 'node:fs/promises';
+const properties = {
+  Environment: process.env.TEST_ENV ?? '{{DEFAULT_ENV}}', Browser: process.env.BROWSER ?? 'chromium',
+  Framework: 'Playwright-TypeScript ({{FRAMEWORK}})', 'Test-Type': '{{TESTING_TYPE}}',
+  'Node-Version': process.version, Execution: process.env.GITHUB_ACTIONS ? 'GitHub Actions' : 'Local',
+  'Execution-Date': new Date().toISOString(), ...(process.env.GITHUB_RUN_ID ? { 'CI-Run-ID': process.env.GITHUB_RUN_ID } : {}),
+};
+await mkdir('allure-results', { recursive: true });
+await writeFile('allure-results/environment.properties', Object.entries(properties).map(([key, value]) => `${key}=${value}`).join('\n'));

package/dist/templates/allure/scripts/rename-allure-report.mjs

@@ -0,0 +1,2 @@
+import { rename } from 'node:fs/promises';
+await rename('reports/index.html', 'reports/allure-report.html');

package/dist/templates/api/api/builders/RequestBuilder.ts

@@ -0,0 +1,15 @@
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+export interface RequestDefinition { method: HttpMethod; headers: Record<string, string>; query: Record<string, string | number | boolean>; body?: unknown; form?: Record<string, string>; }
+
+export class RequestBuilder {
+  private request: RequestDefinition = { method: 'GET', headers: {}, query: {} };
+  public withMethod(method: HttpMethod): this { this.request.method = method; return this; }
+  public withHeader(name: string, value: string): this { this.request.headers[name] = value; return this; }
+  public withHeaders(headers: Record<string, string>): this { Object.assign(this.request.headers, headers); return this; }
+  public withQueryParam(name: string, value: string | number | boolean): this { this.request.query[name] = value; return this; }
+  public withQueryParams(query: Record<string, string | number | boolean>): this { Object.assign(this.request.query, query); return this; }
+  public withBody(body: unknown): this { this.request.body = body; delete this.request.form; return this; }
+  public withFormBody(form: Record<string, string>): this { this.request.form = form; delete this.request.body; return this; }
+  public withBearerToken(token: string): this { return this.withHeader('Authorization', `Bearer ${token}`); }
+  public build(): Readonly<RequestDefinition> { return structuredClone(this.request); }
+}

package/dist/templates/api/api/clients/ApiClient.ts

@@ -0,0 +1,26 @@
+import type { APIRequestContext } from '@playwright/test';
+import type { RequestDefinition } from '../builders/RequestBuilder.js';
+
+export interface ActualResponse<T> { status: number; headers: Record<string, string>; body: T; responseTimeMs: number; }
+
+export class ApiClient {
+  public constructor(private readonly context: APIRequestContext) {}
+  public async execute<T>(path: string, request: Readonly<RequestDefinition>): Promise<ActualResponse<T>> {
+    const started = performance.now();
+    const response = await this.context.fetch(path, {
+      method: request.method, headers: request.headers, params: request.query,
+      ...(request.body !== undefined ? { data: request.body } : {}),
+      ...(request.form !== undefined ? { form: request.form } : {}),
+    });
+    const text = await response.text();
+    const contentType = response.headers()['content-type'] ?? '';
+    let parsed: unknown;
+    if (!text) parsed = undefined;
+    else if (contentType.includes('json')) {
+      try { parsed = JSON.parse(text) as unknown; }
+      catch (error) { throw new Error(`API response declared JSON but could not be parsed: ${error instanceof Error ? error.message : String(error)}`, { cause: error }); }
+    } else parsed = text;
+    const body = parsed as T;
+    return { status: response.status(), headers: response.headers(), body, responseTimeMs: performance.now() - started };
+  }
+}

package/dist/templates/api/api/models/requests/UserRequest.ts

@@ -0,0 +1 @@
+export interface UserRequest { name: string; email: string; }

package/dist/templates/api/api/models/responses/UserResponse.ts

@@ -0,0 +1 @@
+export interface UserResponse { id: number; name: string; email: string; }

package/dist/templates/api/api/services/UserService.ts

@@ -0,0 +1,11 @@
+import type { ActualResponse, ApiClient } from '../clients/ApiClient.js';
+import { RequestBuilder } from '../builders/RequestBuilder.js';
+import type { UserRequest } from '../models/requests/UserRequest.js';
+import type { UserResponse } from '../models/responses/UserResponse.js';
+
+export class UserService {
+  public constructor(private readonly client: ApiClient) {}
+  public getUsers(): Promise<ActualResponse<UserResponse[]>> { return this.client.execute('/users', new RequestBuilder().withMethod('GET').build()); }
+  public getUser(id: number): Promise<ActualResponse<UserResponse>> { return this.client.execute(`/users/${id}`, new RequestBuilder().withMethod('GET').build()); }
+  public createUser(user: UserRequest): Promise<ActualResponse<UserResponse>> { return this.client.execute('/users', new RequestBuilder().withMethod('POST').withBody(user).build()); }
+}

package/dist/templates/api/api/validators/ApiResponseValidator.ts

@@ -0,0 +1,13 @@
+import { expect } from '@playwright/test';
+import type { ActualResponse } from '../clients/ApiClient.js';
+
+export class ApiResponseValidator {
+  public static status(response: ActualResponse<unknown>, expected: number): void { expect(response.status).toBe(expected); }
+  public static notEmpty(value: unknown): void { expect(value).not.toBeNull(); expect(value).not.toEqual(''); }
+  public static propertyExists(value: unknown, property: string): void { expect(typeof value).toBe('object'); expect(value).toHaveProperty(property); }
+  public static propertyEquals(value: unknown, property: string, expected: unknown): void { expect(value).toHaveProperty(property, expected); }
+  public static array(value: unknown): asserts value is unknown[] { expect(Array.isArray(value)).toBe(true); }
+  public static responseTime(response: ActualResponse<unknown>, maximumMs: number): void { expect(response.responseTimeMs).toBeLessThanOrEqual(maximumMs); }
+  public static errorMessage(response: ActualResponse<unknown>, message: string): void { expect(response.body).toHaveProperty('message', message); }
+  public static unauthorized(response: ActualResponse<unknown>): void { expect(response.status).toBe(401); }
+}

package/dist/templates/bdd/bdd.config.ts

@@ -0,0 +1,6 @@
+import { defineBddConfig } from 'playwright-bdd';
+export const testDir = defineBddConfig({
+  features: 'features/**/*.feature',
+  steps: ['steps/**/*.ts', 'fixtures/testFixture.ts'],
+  outputDir: '.features-gen',
+});

package/dist/templates/bdd/features/api/users.feature

@@ -0,0 +1,4 @@
+Feature: Users API
+  Scenario: Retrieve users
+    When I request the users collection
+    Then the users response is successful

package/dist/templates/bdd/features/ui/login.feature

@@ -0,0 +1,5 @@
+Feature: Login
+  Scenario: Successful login
+    Given I navigate to the application
+    When I login with valid credentials
+    Then I should see the inventory page

package/dist/templates/bdd/steps/api/users.steps.ts

@@ -0,0 +1,17 @@
+import { createBdd } from 'playwright-bdd';
+import type { ActualResponse } from '../../api/clients/ApiClient.js';
+import type { UserResponse } from '../../api/models/responses/UserResponse.js';
+import { ApiResponseValidator } from '../../api/validators/ApiResponseValidator.js';
+import { test } from '../../fixtures/testFixture.js';
+import { getTestData } from '../../utils/TestData.js';
+import { getEnvironment } from '../../utils/EnvConfig.js';
+const { When, Then } = createBdd(test);
+let response: ActualResponse<UserResponse[]>;
+When('I request the users collection', async ({ api }) => { response = await api.userService.getUsers(); });
+Then('the users response is successful', () => {
+  const data = getTestData<{ environment: string; apiExpectedStatus: number }>();
+  if (data.environment !== getEnvironment()) throw new Error(`Loaded test data for ${data.environment}, expected ${getEnvironment()}.`);
+  ApiResponseValidator.status(response, data.apiExpectedStatus);
+  ApiResponseValidator.array(response.body);
+  ApiResponseValidator.notEmpty(response.body);
+});

package/dist/templates/bdd/steps/ui/login.steps.ts

@@ -0,0 +1,13 @@
+import { createBdd } from 'playwright-bdd';
+import { test, expect } from '../../fixtures/testFixture.js';
+import { getTestData } from '../../utils/TestData.js';
+import { getEnvironment } from '../../utils/EnvConfig.js';
+const { Given, When, Then } = createBdd(test);
+interface LoginData { environment: string; validUser: { username: string; password: string }; }
+Given('I navigate to the application', async ({ app }) => { await app.loginPage.open(); });
+When('I login with valid credentials', async ({ app }) => {
+  const data = getTestData<LoginData>();
+  expect(data.environment).toBe(getEnvironment());
+  await app.loginPage.login(data.validUser.username, data.validUser.password);
+});
+Then('I should see the inventory page', async ({ app }) => { await expect(app.loginPage.inventoryHeading).toBeVisible(); });

package/dist/templates/common/.env.example

@@ -0,0 +1,6 @@
+TEST_ENV={{DEFAULT_ENV}}
+APP_USERNAME=
+APP_PASSWORD=
+CLIENT_ID=
+CLIENT_SECRET=
+API_TOKEN=

package/dist/templates/common/.nvmrc

@@ -0,0 +1 @@
+22

package/dist/templates/common/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 {{PROJECT_NAME}} contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/templates/common/README.md.template

@@ -0,0 +1,120 @@
+# Playwright TypeScript Framework Scaffold
+
+A generated **{{FRAMEWORK}}** framework for **{{TESTING_TYPE}}** automation. It uses strict TypeScript, Playwright-native UI/API tooling, environment-aware test data, reusable fixtures, and optional Allure/CI integration.
+
+## Features
+
+- Page Objects and API service/client layers
+- Typed fixtures, request builders, responses, and validators
+- Central `config/run.config.json` for environment, timeouts, headless mode, retries, workers, and parallel execution
+- Automatically selected smoke/UAT JSON test data
+- Cross-platform scripts, ESLint, Prettier, and strict TypeScript
+- Secrets loaded from environment variables—never test-data JSON
+
+## Requirements
+
+Node.js 22 or newer. Install Playwright's browser once with `npx playwright install`. Allure Commandline 2 report generation also requires a Java runtime (Java 8 or newer; a current LTS such as Java 17 or 21 is recommended).
+
+## Installation
+
+```bash
+npm install
+npx playwright install
+```
+
+## Create a Framework
+
+This directory was produced by `create-playwright-ts-framework`. Re-run the generator in a different parent directory to create another framework.
+
+## BDD Framework
+
+BDD projects keep Gherkin in `features/`, bindings in `steps/`, and use `playwright-bdd`. Run `npm run bddgen` explicitly when inspecting generated specs; `npm test` runs it automatically.
+
+## Non-BDD Framework
+
+Non-BDD projects use standard Playwright specs under `tests/ui` and/or `tests/api`.
+
+## UI Automation
+
+Page Objects live in `pages/`. `BasePage` owns common browser operations and concrete pages contain locators and business actions. Assertions remain in tests or steps.
+
+## API Automation
+
+Tests call `UserService`; services build requests, `ApiClient` executes them, and `ApiResponseValidator` verifies typed `ActualResponse<T>` values. `RequestBuilder` supports all common HTTP verbs, headers, bearer tokens, query parameters, JSON, and form bodies.
+
+## Project Structure
+
+```text
+config/        environment and framework configuration
+fixtures/      typed Playwright fixtures
+test-data/     environment-specific non-secret data
+utils/         data, JSON, date, logging, and constants
+pages/         UI Page Objects (when selected)
+api/           API client/service architecture (when selected)
+features/steps BDD scenarios and bindings (BDD)
+tests/         Playwright specs (Non-BDD)
+```
+
+## Environment Configuration
+
+Edit `config/run.config.json` to choose the default environment and execution settings. Override it with `npm run test -- --env=smoke`, `TEST_ENV=uat npm test`, or the cross-platform named scripts. Unknown environments produce a list of valid values. URLs are centralized in `config/environments.ts`.
+
+## Test Data Management
+
+`getTestData<T>()` automatically loads `test-data/<active-environment>/testdata.json`; callers never pass an environment. Smoke execution reads `test-data/smoke/testdata.json`, while UAT reads `test-data/uat/testdata.json`. For named collections, use `getKeyedTestData<T>('Appointment')`, which returns `Record<string, T>`.
+
+## Running Tests
+
+```bash
+npm test
+npm run test:smoke
+npm run test:uat
+npm run test:ui
+npm run test:api
+npm run typecheck
+npm run lint
+```
+
+## Allure Reporting
+
+When enabled, tests write metadata and results to `allure-results/`. `npm run allure` creates `allure-report/`; `npm run allure:open` serves it. `npm run allure:report` uses Allure 2's supported `--single-file` mode and writes the portable `reports/allure-report.html`.
+
+## GitHub Actions
+
+The optional workflow supports manual environment selection, runs tests, generates reports with `if: always()`, and uploads available artifacts. The commented cron example uses UTC.
+
+## Secrets
+
+Copy `.env.example` to `.env` locally. Keep usernames, passwords, tokens, and OAuth credentials out of JSON and source control. Configure the matching GitHub repository secrets for CI. Authorization headers are not logged.
+
+## Adding Page Objects
+
+Extend `BasePage`, use role/label/test-id locators, expose business actions, and add the page to `fixtures/testFixture.ts`.
+
+## Adding API Services
+
+Create typed models, build requests with `RequestBuilder`, execute via `ApiClient`, and expose the service through the API fixture.
+
+## Adding Test Data
+
+Add the same schema to every selected environment folder, then load it through a typed interface. Put secret values in environment variables instead.
+
+## Architecture
+
+BDD: `Feature → Step Definition → Fixture → Page Object/API Service → Playwright → Validator → Allure`  
+Non-BDD: `Test Spec → Fixture → Page Object/API Service → Playwright → Validator → Allure`
+
+## Troubleshooting
+
+- Browser missing: run `npx playwright install`.
+- Unknown environment: choose one listed in the error.
+- No Allure results: run tests first. If report generation says no Java runtime is available, install a current Java LTS and retry.
+- CI failure: download the Playwright/Allure artifacts and inspect traces and HTML output.
+
+## Contributing
+
+Run `npm run typecheck`, `npm run lint`, and `npm test` before opening a pull request. Keep additions typed and cross-platform.
+
+## License
+
+MIT

package/dist/templates/common/config/environments.ts

@@ -0,0 +1,13 @@
+export type Environment = {{ENVIRONMENT_TYPE}};
+
+export interface EnvironmentConfig {
+  baseUrl: string;
+  apiBaseUrl: string;
+}
+
+export const environments: Record<Environment, EnvironmentConfig> = Object.fromEntries(
+  ({{ENVIRONMENTS_JSON}} as Environment[]).map(environment => [environment, {
+    baseUrl: 'https://www.saucedemo.com',
+    apiBaseUrl: 'https://jsonplaceholder.typicode.com',
+  }]),
+) as Record<Environment, EnvironmentConfig>;

package/dist/templates/common/config/framework.config.ts

@@ -0,0 +1,5 @@
+export const frameworkConfig = {
+  framework: '{{FRAMEWORK}}',
+  testingType: '{{TESTING_TYPE}}',
+  timeout: 30_000,
+} as const;

package/dist/templates/common/config/run.config.json

@@ -0,0 +1,11 @@
+{
+  "environment": "smoke",
+  "timeout": 30000,
+  "actionTimeout": 10000,
+  "navigationTimeout": 30000,
+  "headless": true,
+  "retries": 0,
+  "ciRetries": 2,
+  "fullyParallel": true,
+  "workers": null
+}

package/dist/templates/common/eslint.config.js

@@ -0,0 +1,8 @@
+import eslint from '@eslint/js';
+import tseslint from 'typescript-eslint';
+export default tseslint.config(
+  { ignores: ['allure-*', 'reports', 'playwright-report', 'test-results', 'scripts/*.mjs', 'eslint.config.js'] },
+  eslint.configs.recommended,
+  ...tseslint.configs.recommendedTypeChecked,
+  { languageOptions: { parserOptions: { projectService: true, tsconfigRootDir: import.meta.dirname } } },
+);

package/dist/templates/common/fixtures/testFixture.ts

@@ -0,0 +1,9 @@
+{{BASE_TEST_IMPORT}}
+{{ENV_IMPORT}}
+{{FIXTURE_IMPORTS}}
+interface FrameworkFixtures {
+{{FIXTURE_TYPES}}}
+
+export const test = base.extend<FrameworkFixtures>({
+{{FIXTURE_VALUES}}});
+export { expect } from '@playwright/test';

package/dist/templates/common/package.json.template

@@ -0,0 +1,27 @@
+{
+  "name": "{{PROJECT_NAME}}",
+  "version": "1.0.0",
+  "private": true,
+  "type": "module",
+  "engines": { "node": ">=22" },
+  "scripts": {
+    "test": "node scripts/run-tests.mjs",
+    "test:smoke": "cross-env TEST_ENV=smoke npm test",
+    "test:uat": "cross-env TEST_ENV=uat npm test"{{SCOPE_SCRIPTS}},
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "format": "prettier --write .",
+    "clean": "node scripts/clean.mjs"{{BDD_SCRIPT}}{{ALLURE_SCRIPTS}}
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.0",
+    "@playwright/test": "^1.63.0",
+    "@types/node": "^22.18.3",
+    "cross-env": "^7.0.3",
+    "dotenv": "^17.2.2",
+    "eslint": "^10.0.0",
+    "prettier": "^3.6.2",
+    "typescript": "^5.9.2",
+    "typescript-eslint": "^8.70.0"{{BDD_DEPS}}{{ALLURE_DEPS}}
+  }
+}

package/dist/templates/common/playwright.config.ts

@@ -0,0 +1,26 @@
+import { defineConfig } from '@playwright/test';
+import { getEnvironmentConfig, getRunConfig } from './utils/EnvConfig.js';
+{{BDD_CONFIG_IMPORT}}
+
+const environment = getEnvironmentConfig();
+const runConfig = getRunConfig();
+const scope = process.env.TEST_SCOPE;
+
+export default defineConfig({
+  testDir: {{TEST_DIR}},
+  testMatch: scope ? `**/${scope}/**/*.spec.*` : '**/*.spec.*',
+  timeout: runConfig.timeout,
+  fullyParallel: runConfig.fullyParallel,
+  retries: process.env.CI ? runConfig.ciRetries : runConfig.retries,
+  ...(process.env.CI ? { workers: 1 } : runConfig.workers === null ? {} : { workers: runConfig.workers }),
+  reporter: [['html', { open: 'never' }], ['list']{{ALLURE_REPORTER}}],
+  use: {
+    baseURL: environment.baseUrl,
+    headless: process.env.HEADLESS === undefined ? runConfig.headless : process.env.HEADLESS !== 'false',
+    actionTimeout: runConfig.actionTimeout,
+    navigationTimeout: runConfig.navigationTimeout,
+    screenshot: 'only-on-failure',
+    video: 'retain-on-failure',
+    trace: 'on-first-retry',
+  },
+});

package/dist/templates/common/scripts/clean.mjs

@@ -0,0 +1,2 @@
+import { rm } from 'node:fs/promises';
+for (const path of ['playwright-report', 'test-results', 'allure-results', 'allure-report', 'reports', '.features-gen']) await rm(path, { recursive: true, force: true });

package/dist/templates/common/scripts/run-tests.mjs

@@ -0,0 +1,10 @@
+import { spawnSync } from 'node:child_process';
+const args = process.argv.slice(2);
+const envArg = args.find(value => value.startsWith('--env='));
+const filtered = args.filter(value => value !== envArg);
+const env = { ...process.env, ...(envArg ? { TEST_ENV: envArg.slice(6) } : {}) };
+{{PREPARE_ALLURE}}
+const runner = process.platform === 'win32' ? 'npx.cmd' : 'npx';
+{{BDD_PRE}}
+const result = spawnSync(runner, ['playwright', 'test', ...filtered], { stdio: 'inherit', env });
+process.exit(result.status ?? 1);

package/dist/templates/common/test-data/__ENV__/testdata.json

@@ -0,0 +1,9 @@
+{
+  "environment": "{{ENV_NAME}}",
+  "apiExpectedStatus": 200,
+  "baseUrl": "https://www.saucedemo.com",
+  "validUser": { "username": "standard_user", "password": "secret_sauce" },
+  "Appointment": {
+    "GP": { "product-category": "GP", "product-identifier": "001", "procedure-identifier": "CONSULTATION" }
+  }
+}

package/dist/templates/common/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "strict": true,
+    "noUncheckedIndexedAccess": true,
+    "exactOptionalPropertyTypes": true,
+    "resolveJsonModule": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "types": ["node"]
+  },
+  "include": ["**/*.ts"]
+}

package/dist/templates/common/utils/Constants.ts

@@ -0,0 +1,2 @@
+export const DEFAULT_TIMEOUT = 30_000;
+export const CONTENT_TYPE_JSON = 'application/json';

package/dist/templates/common/utils/DateHelper.ts

@@ -0,0 +1,2 @@
+export function formatDate(date: Date, locale = 'en-GB'): string { return new Intl.DateTimeFormat(locale).format(date); }
+export function isoDate(date = new Date()): string { return date.toISOString().slice(0, 10); }

package/dist/templates/common/utils/EnvConfig.ts

@@ -0,0 +1,49 @@
+import 'dotenv/config';
+import { environments, type Environment, type EnvironmentConfig } from '../config/environments.js';
+import runConfigJson from '../config/run.config.json' with { type: 'json' };
+
+export interface RunConfig {
+  environment: Environment;
+  timeout: number;
+  actionTimeout: number;
+  navigationTimeout: number;
+  headless: boolean;
+  retries: number;
+  ciRetries: number;
+  fullyParallel: boolean;
+  workers: number | null;
+}
+
+function loadRunConfig(value: unknown): RunConfig {
+  if (typeof value !== 'object' || value === null) throw new Error('config/run.config.json must contain a JSON object.');
+  const config = value as Record<string, unknown>;
+  const numericKeys = ['timeout', 'actionTimeout', 'navigationTimeout', 'retries', 'ciRetries'] as const;
+  for (const key of numericKeys) {
+    if (typeof config[key] !== 'number' || config[key] < 0) throw new Error(`run.config.json: "${key}" must be a non-negative number.`);
+  }
+  if (typeof config.headless !== 'boolean' || typeof config.fullyParallel !== 'boolean') throw new Error('run.config.json: "headless" and "fullyParallel" must be boolean values.');
+  if (config.workers !== null && (typeof config.workers !== 'number' || config.workers < 1)) throw new Error('run.config.json: "workers" must be null or a positive number.');
+  if (typeof config.environment !== 'string' || !(config.environment in environments)) throw new Error(`run.config.json: unknown environment "${String(config.environment)}".`);
+  return config as unknown as RunConfig;
+}
+
+const runConfig = loadRunConfig(runConfigJson);
+
+const available = Object.keys(environments) as Environment[];
+
+export function getEnvironment(): Environment {
+  const argument = process.argv.find(value => value.startsWith('--env='))?.slice('--env='.length);
+  const requested = argument ?? process.env.TEST_ENV ?? runConfig.environment;
+  if (!available.includes(requested as Environment)) {
+    throw new Error(`Unknown TEST_ENV "${requested}".\n\nAvailable environments:\n${available.map(value => `- ${value}`).join('\n')}`);
+  }
+  return requested as Environment;
+}
+
+export function getRunConfig(): Readonly<RunConfig> {
+  return runConfig;
+}
+
+export function getEnvironmentConfig(): EnvironmentConfig {
+  return environments[getEnvironment()];
+}

package/dist/templates/common/utils/JsonHelper.ts

@@ -0,0 +1,7 @@
+export function getValue<T>(value: unknown, path: string): T {
+  const result = path.split('.').reduce<unknown>((current, key) => {
+    if (typeof current !== 'object' || current === null || !(key in current)) throw new Error(`JSON path not found: ${path}`);
+    return (current as Record<string, unknown>)[key];
+  }, value);
+  return result as T;
+}

package/dist/templates/common/utils/Logger.ts

@@ -0,0 +1,10 @@
+type Level = 'INFO' | 'WARN' | 'ERROR' | 'API' | 'UI';
+const write = (level: Level, message: string): void => console.log(`[${level}] ${message}`);
+export const logger = {
+  info: (message: string): void => write('INFO', message),
+  warn: (message: string): void => write('WARN', message),
+  error: (message: string): void => write('ERROR', message),
+  api: (message: string): void => write('API', message),
+  ui: (message: string): void => write('UI', message),
+};
+export function maskSecret(value: string): string { return value.length < 5 ? '****' : `${value.slice(0, 2)}***${value.slice(-2)}`; }

package/dist/templates/common/utils/TestData.ts

@@ -0,0 +1,16 @@
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { getEnvironment } from './EnvConfig.js';
+
+export function getTestData<T>(): T {
+  const path = resolve(process.cwd(), 'test-data', getEnvironment(), 'testdata.json');
+  try { return JSON.parse(readFileSync(path, 'utf8')) as T; }
+  catch (error) { throw new Error(`Unable to load test data from ${path}: ${error instanceof Error ? error.message : String(error)}`, { cause: error }); }
+}
+
+export function getKeyedTestData<T>(group: string): Record<string, T> {
+  const data = getTestData<Record<string, unknown>>();
+  const value = data[group];
+  if (!value || typeof value !== 'object' || Array.isArray(value)) throw new Error(`Test-data group "${group}" was not found.`);
+  return value as Record<string, T>;
+}

package/dist/templates/github/.github/workflows/playwright.yml

@@ -0,0 +1,45 @@
+name: Playwright tests
+on:
+  push:
+  pull_request:
+  workflow_dispatch:
+    inputs:
+      environment:
+        description: Environment
+        required: true
+        default: smoke
+        type: choice
+        options: [smoke, uat]
+  # schedule:
+  #   - cron: '0 6 * * 1' # UTC; customise for your project.
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    env:
+      TEST_ENV: ${{ inputs.environment || 'smoke' }}
+      APP_USERNAME: ${{ secrets.APP_USERNAME }}
+      APP_PASSWORD: ${{ secrets.APP_PASSWORD }}
+      CLIENT_ID: ${{ secrets.CLIENT_ID }}
+      CLIENT_SECRET: ${{ secrets.CLIENT_SECRET }}
+      API_TOKEN: ${{ secrets.API_TOKEN }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with: { node-version: 22, cache: npm }
+      - run: npm ci
+      - run: npx playwright install --with-deps
+      - run: npm run test
+      - name: Generate Allure reports
+        if: always()
+        run: npm run allure:report --if-present
+      - name: Upload test artifacts
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: playwright-reports-${{ env.TEST_ENV }}
+          if-no-files-found: ignore
+          path: |
+            playwright-report/
+            allure-results/
+            allure-report/
+            reports/allure-report.html

package/dist/templates/non-bdd/tests/api/users.spec.ts

@@ -0,0 +1,13 @@
+import { test, expect } from '../../fixtures/testFixture.js';
+import { ApiResponseValidator } from '../../api/validators/ApiResponseValidator.js';
+import { getTestData } from '../../utils/TestData.js';
+import { getEnvironment } from '../../utils/EnvConfig.js';
+interface ApiTestData { environment: string; apiExpectedStatus: number; }
+test('users can be retrieved through the service layer', async ({ api }) => {
+  const data = getTestData<ApiTestData>();
+  expect(data.environment).toBe(getEnvironment());
+  const response = await api.userService.getUsers();
+  ApiResponseValidator.status(response, data.apiExpectedStatus);
+  ApiResponseValidator.array(response.body);
+  ApiResponseValidator.notEmpty(response.body);
+});

package/dist/templates/non-bdd/tests/ui/login.spec.ts

@@ -0,0 +1,11 @@
+import { test, expect } from '../../fixtures/testFixture.js';
+import { getTestData } from '../../utils/TestData.js';
+import { getEnvironment } from '../../utils/EnvConfig.js';
+interface LoginData { environment: string; validUser: { username: string; password: string }; }
+test('user can log in', async ({ app }) => {
+  const data = getTestData<LoginData>();
+  expect(data.environment).toBe(getEnvironment());
+  await app.loginPage.open();
+  await app.loginPage.login(data.validUser.username, data.validUser.password);
+  await expect(app.loginPage.inventoryHeading).toBeVisible();
+});

package/dist/templates/ui/pages/BasePage.ts

@@ -0,0 +1,11 @@
+import type { Locator, Page } from '@playwright/test';
+
+export class BasePage {
+  public constructor(protected readonly page: Page) {}
+  public async navigate(path = '/'): Promise<void> { await this.page.goto(path); }
+  public async click(locator: Locator): Promise<void> { await locator.click(); }
+  public async fill(locator: Locator, value: string): Promise<void> { await locator.fill(value); }
+  public async getText(locator: Locator): Promise<string> { return (await locator.textContent()) ?? ''; }
+  public async waitForElement(locator: Locator): Promise<void> { await locator.waitFor({ state: 'visible' }); }
+  public async isVisible(locator: Locator): Promise<boolean> { return locator.isVisible(); }
+}

package/dist/templates/ui/pages/LoginPage.ts

@@ -0,0 +1,23 @@
+import type { Locator, Page } from '@playwright/test';
+import { BasePage } from './BasePage.js';
+
+export class LoginPage extends BasePage {
+  private readonly username: Locator;
+  private readonly password: Locator;
+  private readonly loginButton: Locator;
+  public readonly inventoryHeading: Locator;
+
+  public constructor(page: Page) {
+    super(page);
+    this.username = page.getByPlaceholder('Username');
+    this.password = page.getByPlaceholder('Password');
+    this.loginButton = page.getByRole('button', { name: 'Login' });
+    this.inventoryHeading = page.getByText('Products', { exact: true });
+  }
+  public async open(): Promise<void> { await this.navigate('/'); }
+  public async login(username: string, password: string): Promise<void> {
+    await this.fill(this.username, username);
+    await this.fill(this.password, password);
+    await this.click(this.loginButton);
+  }
+}

package/dist/types.d.ts

@@ -0,0 +1,11 @@
+export type FrameworkStyle = 'bdd' | 'non-bdd';
+export type TestingType = 'ui' | 'api' | 'ui-api';
+export interface GeneratorOptions {
+    projectName: string;
+    destination: string;
+    framework: FrameworkStyle;
+    testingType: TestingType;
+    allure: boolean;
+    githubActions: boolean;
+    installDependencies: boolean;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils/files.d.ts

@@ -0,0 +1,2 @@
+export declare function copyTemplate(source: string, destination: string): Promise<void>;
+export declare function replaceTokens(root: string, tokens: Record<string, string>): Promise<void>;

package/dist/utils/files.js

@@ -0,0 +1,25 @@
+import { cp, mkdir, readdir, readFile, rename, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+export async function copyTemplate(source, destination) {
+    await mkdir(destination, { recursive: true });
+    await cp(source, destination, { recursive: true, force: true });
+}
+export async function replaceTokens(root, tokens) {
+    for (const entry of await readdir(root, { withFileTypes: true })) {
+        let target = join(root, entry.name);
+        if (entry.name.endsWith('.template')) {
+            const renamed = target.slice(0, -'.template'.length);
+            await rename(target, renamed);
+            target = renamed;
+        }
+        if (entry.isDirectory())
+            await replaceTokens(target, tokens);
+        else {
+            let content = await readFile(target, 'utf8');
+            for (const [token, value] of Object.entries(tokens))
+                content = content.replaceAll(`{{${token}}}`, value);
+            await writeFile(target, content);
+        }
+    }
+}
+//# sourceMappingURL=files.js.map

package/dist/utils/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../../src/utils/files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACnF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAc,EAAE,WAAmB;IACpE,MAAM,KAAK,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,MAAM,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAY,EAAE,MAA8B;IAC9E,KAAK,MAAM,KAAK,IAAI,MAAM,OAAO,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACjE,IAAI,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YACrC,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YACrD,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAC9B,MAAM,GAAG,OAAO,CAAC;QACnB,CAAC;QACD,IAAI,KAAK,CAAC,WAAW,EAAE;YAAE,MAAM,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;aACxD,CAAC;YACJ,IAAI,OAAO,GAAG,MAAM,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAC7C,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;gBAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,KAAK,IAAI,EAAE,KAAK,CAAC,CAAC;YACzG,MAAM,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/utils/project-name.d.ts

@@ -0,0 +1 @@
+export declare function validateProjectName(name: string): true | string;

package/dist/utils/project-name.js

@@ -0,0 +1,9 @@
+const PACKAGE_NAME = /^[a-z0-9][a-z0-9._-]*$/;
+export function validateProjectName(name) {
+    if (!name.trim())
+        return 'Project name is required.';
+    if (!PACKAGE_NAME.test(name))
+        return 'Use a lowercase npm-compatible project name without spaces or path separators.';
+    return true;
+}
+//# sourceMappingURL=project-name.js.map

package/dist/utils/project-name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-name.js","sourceRoot":"","sources":["../../src/utils/project-name.ts"],"names":[],"mappings":"AAAA,MAAM,YAAY,GAAG,wBAAwB,CAAC;AAE9C,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;QAAE,OAAO,2BAA2B,CAAC;IACrD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,gFAAgF,CAAC;IACtH,OAAO,IAAI,CAAC;AACd,CAAC"}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "create-playwright-ts-framework",
+  "version": "0.1.0",
+  "description": "Interactive generator for production-ready Playwright TypeScript test frameworks",
+  "type": "module",
+  "bin": { "create-playwright-ts-framework": "dist/cli/index.js" },
+  "files": ["dist", "README.md", "LICENSE"],
+  "engines": { "node": ">=22" },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && node scripts/copy-templates.mjs",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "test": "vitest run",
+    "prepack": "npm run build && npm test"
+  },
+  "keywords": ["playwright", "typescript", "testing", "bdd", "scaffold", "cli"],
+  "license": "MIT",
+  "dependencies": {
+    "@inquirer/prompts": "^7.8.4",
+    "chalk": "^5.6.2",
+    "ora": "^8.2.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.0",
+    "@types/node": "^22.18.3",
+    "eslint": "^10.0.0",
+    "prettier": "^3.6.2",
+    "typescript": "^5.9.2",
+    "typescript-eslint": "^8.70.0",
+    "vitest": "^5.0.0"
+  }
+}