@pwtap/create 0.1.0

package/core-manifest.json

@@ -0,0 +1,50 @@
+{
+  "//": "Core manifest — the base package.json scripts + devDependencies @pwtap/create writes into a new project, plus Playwright browsers to install and extra package.json fields. Single source of truth for the core scaffold; plugins add to this via their own manifests. Example: create reads coreManifest.scripts.test → \"playwright test\".",
+  "scripts": {
+    "test": "playwright test",
+    "test:headed": "playwright test --headed",
+    "test:debug": "playwright test --debug",
+    "test:ui": "playwright test --ui",
+    "test:api": "playwright test --project=api",
+    "report:playwright": "playwright show-report",
+    "codegen": "playwright codegen",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write \"**/*.{ts,js,json,md}\"",
+    "type-check": "tsc --noEmit",
+    "commit": "cz",
+    "prepare": "husky"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.61.1",
+    "@types/node": "^24.13.2",
+    "typescript": "^5.9.3",
+    "allure-playwright": "^3.10.1",
+    "eslint": "^10.5.0",
+    "@typescript-eslint/eslint-plugin": "^8.62.0",
+    "@typescript-eslint/parser": "^8.62.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-playwright": "^2.10.4",
+    "eslint-plugin-prettier": "^5.5.6",
+    "prettier": "^3.8.4",
+    "prettier-plugin-organize-imports": "^4.3.0",
+    "husky": "^9.1.7",
+    "lint-staged": "^17.0.8",
+    "@commitlint/cli": "^21.1.0",
+    "@commitlint/config-conventional": "^21.1.0",
+    "commitizen": "^4.3.2",
+    "cz-conventional-changelog": "^3.3.0"
+  },
+  "browsers": ["chromium"],
+  "packageJson": {
+    "config": {
+      "commitizen": {
+        "path": "cz-conventional-changelog"
+      }
+    },
+    "lint-staged": {
+      "*.{ts,tsx,js}": ["eslint --fix", "prettier --write"],
+      "*.{json,md}": ["prettier --write"]
+    }
+  }
+}

package/dist/commands/add.d.ts

@@ -0,0 +1,8 @@
+export interface AddCommandOptions {
+    clientDir: string;
+    pluginIds: string[];
+    install: boolean;
+}
+/** `create-pwtap add <plugin…>` — install and wire one or more plugins into an existing project. */
+export declare function addCommand(opts: AddCommandOptions): Promise<void>;
+//# sourceMappingURL=add.d.ts.map

package/dist/commands/add.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../src/commands/add.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,oGAAoG;AACpG,wBAAsB,UAAU,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAKvE"}

package/dist/commands/add.js

@@ -0,0 +1,9 @@
+import { addPlugins } from '../plugin-apply.js';
+/** `create-pwtap add <plugin…>` — install and wire one or more plugins into an existing project. */
+export async function addCommand(opts) {
+    if (opts.pluginIds.length === 0) {
+        throw new Error('add: name at least one plugin, e.g. `npx create-pwtap add maestro`');
+    }
+    await addPlugins(opts);
+}
+//# sourceMappingURL=add.js.map

package/dist/commands/add.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.js","sourceRoot":"","sources":["../../src/commands/add.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAQhD,oGAAoG;AACpG,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAuB;IACtD,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;IACxF,CAAC;IACD,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC"}

package/dist/commands/create.d.ts

@@ -0,0 +1,12 @@
+export interface CreateOptions {
+    targetDir: string;
+    yes: boolean;
+    install: boolean;
+    browsers: boolean;
+    selectedPluginIds: string[];
+    templateDir: string;
+    coreManifestPath: string;
+}
+/** Scaffold a new core project (UI + API), then optionally install/inject selected plugins. */
+export declare function createProject(opts: CreateOptions): Promise<void>;
+//# sourceMappingURL=create.d.ts.map

package/dist/commands/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/commands/create.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,OAAO,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,+FAA+F;AAC/F,wBAAsB,aAAa,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAuDtE"}

package/dist/commands/create.js

@@ -0,0 +1,114 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { loadCoreManifest } from '../manifest.js';
+import { addPlugins } from '../plugin-apply.js';
+import { Prompter } from '../prompts.js';
+import { KNOWN_PLUGINS } from '../registry.js';
+import { copyDir, exists, isEmptyDir, sortObject, writeJson } from '../util/fs.js';
+import { log } from '../util/log.js';
+import { run } from '../util/run.js';
+/** Scaffold a new core project (UI + API), then optionally install/inject selected plugins. */
+export async function createProject(opts) {
+    const { targetDir, templateDir, coreManifestPath } = opts;
+    if (!isEmptyDir(targetDir)) {
+        throw new Error(`Target directory is not empty: ${targetDir}`);
+    }
+    fs.mkdirSync(targetDir, { recursive: true });
+    log.step(`Scaffolding Playwright Test Automation Platform into ${targetDir}`);
+    // 1. Copy the core template verbatim, then reveal the shipped gitignore as .gitignore.
+    copyDir(templateDir, targetDir);
+    const shippedGitignore = path.join(targetDir, 'templates', 'gitignore');
+    if (exists(shippedGitignore)) {
+        fs.renameSync(shippedGitignore, path.join(targetDir, '.gitignore'));
+        fs.rmSync(path.join(targetDir, 'templates'), { recursive: true, force: true });
+    }
+    // 2. Gather project name + plugin choices.
+    const prompter = new Prompter(opts.yes);
+    let name;
+    let selectedIds;
+    try {
+        name = await prompter.text('Project name', path.basename(targetDir));
+        selectedIds =
+            opts.selectedPluginIds.length > 0
+                ? opts.selectedPluginIds
+                : await prompter.selectPlugins(KNOWN_PLUGINS);
+    }
+    finally {
+        prompter.close();
+    }
+    // 3. Write the base package.json from the core manifest.
+    writeBasePackageJson(targetDir, name, coreManifestPath);
+    // 4. git init + husky hooks so commit hygiene (lint-staged + commitlint) activates on install.
+    await initGit(targetDir);
+    writeHuskyHooks(targetDir);
+    // 5. Install core deps, then plugins (install + inject), then browsers.
+    if (opts.install) {
+        log.step('Installing dependencies');
+        await run('npm', ['install'], { cwd: targetDir });
+    }
+    if (selectedIds.length > 0) {
+        await addPlugins({ clientDir: targetDir, pluginIds: selectedIds, install: opts.install });
+    }
+    if (opts.browsers) {
+        const core = loadCoreManifest(coreManifestPath);
+        log.step(`Installing Playwright browsers: ${core.browsers.join(', ')}`);
+        await run('npx', ['playwright', 'install', ...core.browsers], { cwd: targetDir }).catch(err => log.warn(`playwright install skipped: ${err instanceof Error ? err.message : String(err)}`));
+    }
+    printNextSteps(targetDir, name);
+}
+function writeBasePackageJson(targetDir, name, coreManifestPath) {
+    const core = loadCoreManifest(coreManifestPath);
+    writeJson(path.join(targetDir, 'package.json'), {
+        name,
+        version: '0.1.0',
+        private: true,
+        type: 'module',
+        scripts: sortObject(core.scripts),
+        devDependencies: sortObject(core.devDependencies),
+        ...(core.packageJson ?? {}),
+    });
+}
+async function initGit(targetDir) {
+    // git init so husky's `prepare` can wire hooks during npm install (husky needs a .git dir).
+    try {
+        await run('git', ['init', '-q'], { cwd: targetDir });
+    }
+    catch {
+        log.warn('git not available — run `git init` later so husky hooks activate.');
+    }
+}
+function writeHuskyHooks(targetDir) {
+    // Hook files activated by the generated project's `prepare: husky` on install: lint-staged before
+    // each commit, commitlint on the message.
+    const dir = path.join(targetDir, '.husky');
+    fs.mkdirSync(dir, { recursive: true });
+    const hooks = {
+        'pre-commit': 'npx lint-staged\n',
+        'commit-msg': 'npx --no -- commitlint --edit "$1"\n',
+    };
+    for (const [hookName, body] of Object.entries(hooks)) {
+        const hookPath = path.join(dir, hookName);
+        fs.writeFileSync(hookPath, body);
+        try {
+            fs.chmodSync(hookPath, 0o755);
+        }
+        catch {
+            // Ignore chmod failures (e.g. on Windows).
+        }
+    }
+}
+function printNextSteps(targetDir, name) {
+    const rel = path.relative(process.cwd(), targetDir) || '.';
+    log.done(`Created ${name}`);
+    log.info([
+        '',
+        'Next steps:',
+        `  cd ${rel}`,
+        '  cp env/environments.example.json env/environments.json   # set BASE_URL / API_BASE_URL',
+        '  cp testData/users.example.json testData/users.json       # add login sessions (optional)',
+        '  npm test                                                 # runs chromium + api',
+        '',
+        'Add a plugin later:  npx create-pwtap add <maestro|appium|...>',
+    ].join('\n'));
+}
+//# sourceMappingURL=create.js.map

package/dist/commands/create.js.map

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

package/dist/commands/remove.d.ts

@@ -0,0 +1,7 @@
+export interface RemoveCommandOptions {
+    clientDir: string;
+    pluginIds: string[];
+}
+/** `create-pwtap remove <plugin…>` — reverse every injection and uninstall the plugin package(s). */
+export declare function removeCommand(opts: RemoveCommandOptions): Promise<void>;
+//# sourceMappingURL=remove.d.ts.map

package/dist/commands/remove.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove.d.ts","sourceRoot":"","sources":["../../src/commands/remove.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,qGAAqG;AACrG,wBAAsB,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAK7E"}

package/dist/commands/remove.js

@@ -0,0 +1,9 @@
+import { removePlugins } from '../plugin-apply.js';
+/** `create-pwtap remove <plugin…>` — reverse every injection and uninstall the plugin package(s). */
+export async function removeCommand(opts) {
+    if (opts.pluginIds.length === 0) {
+        throw new Error('remove: name at least one plugin, e.g. `npx create-pwtap remove maestro`');
+    }
+    await removePlugins({ clientDir: opts.clientDir, pluginIds: opts.pluginIds });
+}
+//# sourceMappingURL=remove.js.map

package/dist/commands/remove.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove.js","sourceRoot":"","sources":["../../src/commands/remove.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAOnD,qGAAqG;AACrG,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAA0B;IAC5D,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,0EAA0E,CAAC,CAAC;IAC9F,CAAC;IACD,MAAM,aAAa,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;AAChF,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,55 @@
+#!/usr/bin/env node
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { addCommand } from './commands/add.js';
+import { createProject } from './commands/create.js';
+import { removeCommand } from './commands/remove.js';
+import { KNOWN_PLUGINS } from './registry.js';
+import { log } from './util/log.js';
+// Package root (this file compiles to dist/index.js). template/ and core-manifest.json are bundled
+// alongside dist/ at prepack, so both live at the package root.
+const pkgRoot = fileURLToPath(new URL('..', import.meta.url));
+const templateDir = path.join(pkgRoot, 'template');
+const coreManifestPath = path.join(pkgRoot, 'core-manifest.json');
+/** True if `--flag` is on argv, or npm surfaced it via `npm_config_<flag>` (so `npm init` flags work). */
+function flagPresent(argv, flag) {
+    if (argv.includes(flag)) {
+        return true;
+    }
+    const key = `npm_config_${flag.replace(/^--/, '').replace(/-/g, '_')}`;
+    const value = process.env[key];
+    return value !== undefined && value !== '' && value !== 'false';
+}
+async function main() {
+    const argv = process.argv.slice(2);
+    const positional = argv.filter(a => !a.startsWith('-'));
+    const command = positional[0] === 'add' || positional[0] === 'remove' ? positional[0] : 'create';
+    const yes = flagPresent(argv, '--yes') || argv.includes('-y');
+    const install = !flagPresent(argv, '--no-install');
+    const browsers = !flagPresent(argv, '--no-browsers');
+    const pluginIdsFromFlags = KNOWN_PLUGINS.filter(p => flagPresent(argv, p.flag)).map(p => p.id);
+    if (command === 'add') {
+        const ids = positional.slice(1).length > 0 ? positional.slice(1) : pluginIdsFromFlags;
+        await addCommand({ clientDir: process.cwd(), pluginIds: ids, install });
+        return;
+    }
+    if (command === 'remove') {
+        await removeCommand({ clientDir: process.cwd(), pluginIds: positional.slice(1) });
+        return;
+    }
+    const targetDir = path.resolve(process.cwd(), positional[0] ?? '.');
+    await createProject({
+        targetDir,
+        yes,
+        install,
+        browsers,
+        selectedPluginIds: pluginIdsFromFlags,
+        templateDir,
+        coreManifestPath,
+    });
+}
+main().catch(err => {
+    log.error(err instanceof Error ? err.message : String(err));
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/injectors/assets.d.ts

@@ -0,0 +1,6 @@
+import type { PluginManifest } from '../manifest.js';
+/** Copy a plugin's example tests/flows into the client once — never overwriting existing files. */
+export declare function copyExamples(clientDir: string, m: PluginManifest): void;
+/** Copy a plugin's docs into the client (e.g. docs/MAESTRO.md). */
+export declare function copyDocs(clientDir: string, m: PluginManifest): void;
+//# sourceMappingURL=assets.d.ts.map

package/dist/injectors/assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../../src/injectors/assets.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AA0BrD,mGAAmG;AACnG,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,cAAc,GAAG,IAAI,CAEvE;AAED,mEAAmE;AACnE,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,cAAc,GAAG,IAAI,CAEnE"}

package/dist/injectors/assets.js

@@ -0,0 +1,53 @@
+import { createRequire } from 'node:module';
+import path from 'node:path';
+import { copyDir, ensureDir, exists } from '../util/fs.js';
+/** Absolute root of an installed package, or null when it can't be resolved from the client. */
+function packageRoot(clientDir, pkg) {
+    try {
+        const require = createRequire(`${clientDir}/`);
+        // Resolve the package's main entry (always allowed by "exports"), then walk up to its package.json.
+        // Resolving `${pkg}/package.json` directly fails when a package restricts subpaths via "exports".
+        let dir = path.dirname(require.resolve(pkg, { paths: [clientDir] }));
+        for (let i = 0; i < 8; i++) {
+            if (exists(path.join(dir, 'package.json'))) {
+                return dir;
+            }
+            const parent = path.dirname(dir);
+            if (parent === dir) {
+                break;
+            }
+            dir = parent;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Copy a plugin's example tests/flows into the client once — never overwriting existing files. */
+export function copyExamples(clientDir, m) {
+    copyAssets(clientDir, m, m.examples);
+}
+/** Copy a plugin's docs into the client (e.g. docs/MAESTRO.md). */
+export function copyDocs(clientDir, m) {
+    copyAssets(clientDir, m, m.docs);
+}
+function copyAssets(clientDir, m, assets) {
+    if (!assets?.length) {
+        return;
+    }
+    const root = packageRoot(clientDir, m.name);
+    if (!root) {
+        return;
+    }
+    for (const { src, dest } of assets) {
+        const from = path.join(root, src);
+        const to = path.join(clientDir, dest);
+        if (!exists(from) || exists(to)) {
+            continue; // skip missing sources and never overwrite user files
+        }
+        ensureDir(path.dirname(to));
+        copyDir(from, to);
+    }
+}
+//# sourceMappingURL=assets.js.map

package/dist/injectors/assets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.js","sourceRoot":"","sources":["../../src/injectors/assets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE3D,gGAAgG;AAChG,SAAS,WAAW,CAAC,SAAiB,EAAE,GAAW;IACjD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,SAAS,GAAG,CAAC,CAAC;QAC/C,oGAAoG;QACpG,kGAAkG;QAClG,IAAI,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;QACrE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3B,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC;gBAC3C,OAAO,GAAG,CAAC;YACb,CAAC;YACD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACjC,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;gBACnB,MAAM;YACR,CAAC;YACD,GAAG,GAAG,MAAM,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,YAAY,CAAC,SAAiB,EAAE,CAAiB;IAC/D,UAAU,CAAC,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC;AACvC,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,QAAQ,CAAC,SAAiB,EAAE,CAAiB;IAC3D,UAAU,CAAC,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,UAAU,CACjB,SAAiB,EACjB,CAAiB,EACjB,MAAwD;IAExD,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;QACpB,OAAO;IACT,CAAC;IACD,MAAM,IAAI,GAAG,WAAW,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IAC5C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO;IACT,CAAC;IACD,KAAK,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,MAAM,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAClC,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;YAChC,SAAS,CAAC,sDAAsD;QAClE,CAAC;QACD,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5B,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACpB,CAAC;AACH,CAAC"}

package/dist/injectors/envJson.d.ts

@@ -0,0 +1,6 @@
+import type { PluginManifest } from '../manifest.js';
+/** Add a plugin's env keys under `common` (loadEnv flattens them into process.env). Skips existing keys. */
+export declare function mergePluginEnv(clientDir: string, m: PluginManifest): void;
+/** Reverse mergePluginEnv: drop the plugin's env keys from `common`. */
+export declare function removePluginEnv(clientDir: string, m: PluginManifest): void;
+//# sourceMappingURL=envJson.d.ts.map

package/dist/injectors/envJson.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envJson.d.ts","sourceRoot":"","sources":["../../src/injectors/envJson.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAiBrD,4GAA4G;AAC5G,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,cAAc,GAAG,IAAI,CAczE;AAED,wEAAwE;AACxE,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,cAAc,GAAG,IAAI,CAW1E"}

package/dist/injectors/envJson.js

@@ -0,0 +1,39 @@
+import path from 'node:path';
+import { exists, readJson, writeJson } from '../util/fs.js';
+/** Both env files if present — the tracked example and the gitignored real one. */
+function envFiles(clientDir) {
+    return [
+        path.join(clientDir, 'env', 'environments.json'),
+        path.join(clientDir, 'env', 'environments.example.json'),
+    ].filter(exists);
+}
+/** Add a plugin's env keys under `common` (loadEnv flattens them into process.env). Skips existing keys. */
+export function mergePluginEnv(clientDir, m) {
+    if (Object.keys(m.envKeys).length === 0) {
+        return;
+    }
+    for (const file of envFiles(clientDir)) {
+        const cfg = readJson(file);
+        cfg.common = { ...(cfg.common ?? {}) };
+        for (const [key, value] of Object.entries(m.envKeys)) {
+            if (!(key in cfg.common)) {
+                cfg.common[key] = value;
+            }
+        }
+        writeJson(file, cfg);
+    }
+}
+/** Reverse mergePluginEnv: drop the plugin's env keys from `common`. */
+export function removePluginEnv(clientDir, m) {
+    for (const file of envFiles(clientDir)) {
+        const cfg = readJson(file);
+        if (!cfg.common) {
+            continue;
+        }
+        for (const key of Object.keys(m.envKeys)) {
+            delete cfg.common[key];
+        }
+        writeJson(file, cfg);
+    }
+}
+//# sourceMappingURL=envJson.js.map

package/dist/injectors/envJson.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"envJson.js","sourceRoot":"","sources":["../../src/injectors/envJson.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAQ5D,mFAAmF;AACnF,SAAS,QAAQ,CAAC,SAAiB;IACjC,OAAO;QACL,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,mBAAmB,CAAC;QAChD,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,2BAA2B,CAAC;KACzD,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AACnB,CAAC;AAED,4GAA4G;AAC5G,MAAM,UAAU,cAAc,CAAC,SAAiB,EAAE,CAAiB;IACjE,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxC,OAAO;IACT,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACvC,MAAM,GAAG,GAAG,QAAQ,CAAU,IAAI,CAAC,CAAC;QACpC,GAAG,CAAC,MAAM,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,CAAC;QACvC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;YACrD,IAAI,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBACzB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YAC1B,CAAC;QACH,CAAC;QACD,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,eAAe,CAAC,SAAiB,EAAE,CAAiB;IAClE,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACvC,MAAM,GAAG,GAAG,QAAQ,CAAU,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;YAChB,SAAS;QACX,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;YACzC,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC;QACD,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/injectors/fixturesBarrel.d.ts

@@ -0,0 +1,11 @@
+import type { PluginManifest } from '../manifest.js';
+/**
+ * Splice a plugin's fixture into fixtures/index.ts: its import plus a `mergeTests` arg (if it ships a
+ * test object) and/or a `mergeExpects` arg (if it ships matchers). Independent — a matcher-only plugin
+ * touches only imports+expects. Returns false if a needed managed marker is missing so the caller can
+ * print a paste block instead of half-editing.
+ */
+export declare function applyFixture(clientDir: string, m: PluginManifest): boolean;
+/** Reverse applyFixture. */
+export declare function removeFixture(clientDir: string, m: PluginManifest): void;
+//# sourceMappingURL=fixturesBarrel.d.ts.map

package/dist/injectors/fixturesBarrel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixturesBarrel.d.ts","sourceRoot":"","sources":["../../src/injectors/fixturesBarrel.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAqBrD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,cAAc,GAAG,OAAO,CAyB1E;AAED,4BAA4B;AAC5B,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,cAAc,GAAG,IAAI,CAexE"}

package/dist/injectors/fixturesBarrel.js

@@ -0,0 +1,66 @@
+import path from 'node:path';
+import { readText, writeText } from '../util/fs.js';
+import { addToRegion, hasRegion, removeFromRegion } from '../util/markers.js';
+function barrelPath(clientDir) {
+    return path.join(clientDir, 'fixtures', 'index.ts');
+}
+function importLine(f) {
+    const parts = [];
+    if (f.test) {
+        parts.push(`${f.test.export ?? 'test'} as ${f.test.alias}`);
+    }
+    if (f.expect) {
+        parts.push(`${f.expect.export ?? 'expect'} as ${f.expect.alias}`);
+    }
+    return `import { ${parts.join(', ')} } from '${f.importFrom}';`;
+}
+/**
+ * Splice a plugin's fixture into fixtures/index.ts: its import plus a `mergeTests` arg (if it ships a
+ * test object) and/or a `mergeExpects` arg (if it ships matchers). Independent — a matcher-only plugin
+ * touches only imports+expects. Returns false if a needed managed marker is missing so the caller can
+ * print a paste block instead of half-editing.
+ */
+export function applyFixture(clientDir, m) {
+    const f = m.fixture;
+    if (!f) {
+        return true;
+    }
+    const file = barrelPath(clientDir);
+    let src = readText(file);
+    if (!hasRegion(src, 'plugins:imports')) {
+        return false;
+    }
+    if (f.test && !hasRegion(src, 'plugins:tests')) {
+        return false;
+    }
+    if (f.expect && !hasRegion(src, 'plugins:expects')) {
+        return false;
+    }
+    src = addToRegion(src, 'plugins:imports', importLine(f), f.importFrom);
+    if (f.test) {
+        src = addToRegion(src, 'plugins:tests', `  ${f.test.alias},`, `${f.test.alias},`);
+    }
+    if (f.expect) {
+        src = addToRegion(src, 'plugins:expects', `  ${f.expect.alias},`, `${f.expect.alias},`);
+    }
+    writeText(file, src);
+    return true;
+}
+/** Reverse applyFixture. */
+export function removeFixture(clientDir, m) {
+    const f = m.fixture;
+    if (!f) {
+        return;
+    }
+    const file = barrelPath(clientDir);
+    let src = readText(file);
+    src = removeFromRegion(src, 'plugins:imports', f.importFrom);
+    if (f.test) {
+        src = removeFromRegion(src, 'plugins:tests', `${f.test.alias},`);
+    }
+    if (f.expect) {
+        src = removeFromRegion(src, 'plugins:expects', `${f.expect.alias},`);
+    }
+    writeText(file, src);
+}
+//# sourceMappingURL=fixturesBarrel.js.map

package/dist/injectors/fixturesBarrel.js.map

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

package/dist/injectors/packageJson.d.ts

@@ -0,0 +1,6 @@
+import type { PluginManifest } from '../manifest.js';
+/** Merge a plugin's scripts + devDependencies into the client package.json (never clobbering user keys wins — plugin values overwrite only same-named keys). */
+export declare function mergePluginPackageJson(clientDir: string, m: PluginManifest): void;
+/** Reverse mergePluginPackageJson: drop the plugin's scripts/devDeps and the plugin package itself. */
+export declare function removePluginPackageJson(clientDir: string, m: PluginManifest): void;
+//# sourceMappingURL=packageJson.d.ts.map

package/dist/injectors/packageJson.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packageJson.d.ts","sourceRoot":"","sources":["../../src/injectors/packageJson.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAUrD,gKAAgK;AAChK,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,cAAc,GAAG,IAAI,CAMjF;AAED,uGAAuG;AACvG,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,cAAc,GAAG,IAAI,CAYlF"}

package/dist/injectors/packageJson.js

@@ -0,0 +1,25 @@
+import path from 'node:path';
+import { readJson, sortObject, writeJson } from '../util/fs.js';
+/** Merge a plugin's scripts + devDependencies into the client package.json (never clobbering user keys wins — plugin values overwrite only same-named keys). */
+export function mergePluginPackageJson(clientDir, m) {
+    const file = path.join(clientDir, 'package.json');
+    const pkg = readJson(file);
+    pkg.scripts = sortObject({ ...(pkg.scripts ?? {}), ...m.scripts });
+    pkg.devDependencies = sortObject({ ...(pkg.devDependencies ?? {}), ...m.devDependencies });
+    writeJson(file, pkg);
+}
+/** Reverse mergePluginPackageJson: drop the plugin's scripts/devDeps and the plugin package itself. */
+export function removePluginPackageJson(clientDir, m) {
+    const file = path.join(clientDir, 'package.json');
+    const pkg = readJson(file);
+    for (const key of Object.keys(m.scripts)) {
+        delete pkg.scripts?.[key];
+    }
+    for (const key of Object.keys(m.devDependencies)) {
+        delete pkg.devDependencies?.[key];
+    }
+    delete pkg.devDependencies?.[m.name];
+    delete pkg.dependencies?.[m.name];
+    writeJson(file, pkg);
+}
+//# sourceMappingURL=packageJson.js.map

package/dist/injectors/packageJson.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"packageJson.js","sourceRoot":"","sources":["../../src/injectors/packageJson.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAShE,gKAAgK;AAChK,MAAM,UAAU,sBAAsB,CAAC,SAAiB,EAAE,CAAiB;IACzE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;IAClD,MAAM,GAAG,GAAG,QAAQ,CAAc,IAAI,CAAC,CAAC;IACxC,GAAG,CAAC,OAAO,GAAG,UAAU,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IACnE,GAAG,CAAC,eAAe,GAAG,UAAU,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,eAAe,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC;IAC3F,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AACvB,CAAC;AAED,uGAAuG;AACvG,MAAM,UAAU,uBAAuB,CAAC,SAAiB,EAAE,CAAiB;IAC1E,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;IAClD,MAAM,GAAG,GAAG,QAAQ,CAAc,IAAI,CAAC,CAAC;IACxC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;QACzC,OAAO,GAAG,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,EAAE,CAAC;QACjD,OAAO,GAAG,CAAC,eAAe,EAAE,CAAC,GAAG,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,GAAG,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACrC,OAAO,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAClC,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AACvB,CAAC"}

package/dist/injectors/pwConfig.d.ts

@@ -0,0 +1,10 @@
+import type { PluginManifest } from '../manifest.js';
+/**
+ * Splice a plugin's env gate and project spread into playwright.config.ts. Returns false if a managed
+ * marker is missing (caller then prints a paste block). Each project is env-gated so a bare
+ * `npm test` stays UI + API only.
+ */
+export declare function applyProject(clientDir: string, m: PluginManifest): boolean;
+/** Reverse applyProject (matches on the gate variable name). */
+export declare function removeProject(clientDir: string, m: PluginManifest): void;
+//# sourceMappingURL=pwConfig.d.ts.map

package/dist/injectors/pwConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pwConfig.d.ts","sourceRoot":"","sources":["../../src/injectors/pwConfig.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAQrD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,cAAc,GAAG,OAAO,CAe1E;AAED,gEAAgE;AAChE,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,cAAc,GAAG,IAAI,CAUxE"}