@pwtap/create 0.1.0

package/dist/injectors/pwConfig.js

@@ -0,0 +1,40 @@
+import path from 'node:path';
+import { readText, writeText } from '../util/fs.js';
+import { addToRegion, hasRegion, removeFromRegion } from '../util/markers.js';
+function configPath(clientDir) {
+    return path.join(clientDir, 'playwright.config.ts');
+}
+/**
+ * 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 function applyProject(clientDir, m) {
+    const pp = m.playwrightProject;
+    if (!pp) {
+        return true;
+    }
+    const file = configPath(clientDir);
+    let src = readText(file);
+    if (!hasRegion(src, 'plugins:gates') || !hasRegion(src, 'plugins:projects')) {
+        return false;
+    }
+    src = addToRegion(src, 'plugins:gates', pp.gate, pp.gateVar);
+    const projectLine = `    ${pp.project.replace(/,\s*$/, '')},`;
+    src = addToRegion(src, 'plugins:projects', projectLine, pp.gateVar);
+    writeText(file, src);
+    return true;
+}
+/** Reverse applyProject (matches on the gate variable name). */
+export function removeProject(clientDir, m) {
+    const pp = m.playwrightProject;
+    if (!pp) {
+        return;
+    }
+    const file = configPath(clientDir);
+    let src = readText(file);
+    src = removeFromRegion(src, 'plugins:gates', pp.gateVar);
+    src = removeFromRegion(src, 'plugins:projects', pp.gateVar);
+    writeText(file, src);
+}
+//# sourceMappingURL=pwConfig.js.map

package/dist/injectors/pwConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pwConfig.js","sourceRoot":"","sources":["../../src/injectors/pwConfig.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE9E,SAAS,UAAU,CAAC,SAAiB;IACnC,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,sBAAsB,CAAC,CAAC;AACtD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,SAAiB,EAAE,CAAiB;IAC/D,MAAM,EAAE,GAAG,CAAC,CAAC,iBAAiB,CAAC;IAC/B,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,IAAI,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;IACnC,IAAI,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IACzB,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,kBAAkB,CAAC,EAAE,CAAC;QAC5E,OAAO,KAAK,CAAC;IACf,CAAC;IACD,GAAG,GAAG,WAAW,CAAC,GAAG,EAAE,eAAe,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC;IAC7D,MAAM,WAAW,GAAG,OAAO,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC;IAC9D,GAAG,GAAG,WAAW,CAAC,GAAG,EAAE,kBAAkB,EAAE,WAAW,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC;IACpE,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACrB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,aAAa,CAAC,SAAiB,EAAE,CAAiB;IAChE,MAAM,EAAE,GAAG,CAAC,CAAC,iBAAiB,CAAC;IAC/B,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,OAAO;IACT,CAAC;IACD,MAAM,IAAI,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;IACnC,IAAI,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IACzB,GAAG,GAAG,gBAAgB,CAAC,GAAG,EAAE,eAAe,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC;IACzD,GAAG,GAAG,gBAAgB,CAAC,GAAG,EAAE,kBAAkB,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC;IAC5D,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AACvB,CAAC"}

package/dist/manifest.d.ts

@@ -0,0 +1,65 @@
+/**
+ * The authoritative manifest a plugin ships (compiled to `dist/manifest.js`, exported via the
+ * package's `"./manifest"` entry). @pwtap/create loads it AFTER installing the plugin to know what
+ * to inject into the client project.
+ *
+ * @example
+ * export const manifest: PluginManifest = {
+ *   id: 'maestro', name: '@pwtap/plugin-maestro',
+ *   devDependencies: {}, scripts: { 'test:maestro': 'MAESTRO=1 playwright test --project=maestro' },
+ *   envKeys: { MOBILE_PLATFORM: 'android' },
+ *   fixture: { importFrom: '@pwtap/plugin-maestro', test: { alias: 'maestroTest' } },
+ * };
+ */
+export interface PluginManifest {
+    id: string;
+    name: string;
+    devDependencies: Record<string, string>;
+    scripts: Record<string, string>;
+    envKeys: Record<string, string>;
+    fixture?: {
+        importFrom: string;
+        /** Composable test object merged via mergeTests. Omit for matcher-only plugins (e.g. ai-judge). */
+        test?: {
+            export?: string;
+            alias: string;
+        };
+        /** Custom-matcher `expect` merged via mergeExpects. Omit for fixture-only plugins (e.g. maestro). */
+        expect?: {
+            export?: string;
+            alias: string;
+        };
+    };
+    playwrightProject?: {
+        gateVar: string;
+        gate: string;
+        project: string;
+        globalTeardown?: string;
+    };
+    examples?: Array<{
+        src: string;
+        dest: string;
+    }>;
+    docs?: Array<{
+        src: string;
+        dest: string;
+    }>;
+    readmeSection?: string;
+    /** Package-relative path to a compiled module exporting `async ensure(): Promise<void>` (advisory). */
+    ensure?: string;
+}
+/** The base package.json scripts/devDeps and Playwright browsers the core scaffold writes. */
+export interface CoreManifest {
+    scripts: Record<string, string>;
+    devDependencies: Record<string, string>;
+    browsers: string[];
+    /** Extra fields merged verbatim into the generated package.json (e.g. lint-staged, commitizen config). */
+    packageJson?: Record<string, unknown>;
+}
+export declare function loadCoreManifest(coreManifestPath: string): CoreManifest;
+/**
+ * Load an installed plugin's manifest by resolving `<pkg>/manifest` from the client's node_modules.
+ * Returns `null` when the package or its manifest export can't be resolved (caller warns and skips).
+ */
+export declare function loadPluginManifest(clientDir: string, pkg: string): Promise<PluginManifest | null>;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE;QACR,UAAU,EAAE,MAAM,CAAC;QACnB,mGAAmG;QACnG,IAAI,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;QAC1C,qGAAqG;QACrG,MAAM,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;KAC7C,CAAC;IACF,iBAAiB,CAAC,EAAE;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChD,IAAI,CAAC,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uGAAuG;IACvG,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,8FAA8F;AAC9F,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,0GAA0G;IAC1G,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED,wBAAgB,gBAAgB,CAAC,gBAAgB,EAAE,MAAM,GAAG,YAAY,CAEvE;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAShC"}

package/dist/manifest.js

@@ -0,0 +1,22 @@
+import { createRequire } from 'node:module';
+import { pathToFileURL } from 'node:url';
+import { readJson } from './util/fs.js';
+export function loadCoreManifest(coreManifestPath) {
+    return readJson(coreManifestPath);
+}
+/**
+ * Load an installed plugin's manifest by resolving `<pkg>/manifest` from the client's node_modules.
+ * Returns `null` when the package or its manifest export can't be resolved (caller warns and skips).
+ */
+export async function loadPluginManifest(clientDir, pkg) {
+    try {
+        const require = createRequire(`${clientDir}/`);
+        const resolved = require.resolve(`${pkg}/manifest`, { paths: [clientDir] });
+        const mod = (await import(pathToFileURL(resolved).href));
+        return mod.manifest ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAkDxC,MAAM,UAAU,gBAAgB,CAAC,gBAAwB;IACvD,OAAO,QAAQ,CAAe,gBAAgB,CAAC,CAAC;AAClD,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,SAAiB,EACjB,GAAW;IAEX,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,SAAS,GAAG,CAAC,CAAC;QAC/C,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,GAAG,WAAW,EAAE,EAAE,KAAK,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAC5E,MAAM,GAAG,GAAG,CAAC,MAAM,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAkC,CAAC;QAC1F,OAAO,GAAG,CAAC,QAAQ,IAAI,IAAI,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/plugin-apply.d.ts

@@ -0,0 +1,13 @@
+export interface AddOptions {
+    clientDir: string;
+    pluginIds: string[];
+    install: boolean;
+}
+export declare function addPlugins({ clientDir, pluginIds, install }: AddOptions): Promise<void>;
+export interface RemoveOptions {
+    clientDir: string;
+    pluginIds: string[];
+    uninstall?: boolean;
+}
+export declare function removePlugins({ clientDir, pluginIds, uninstall, }: RemoveOptions): Promise<void>;
+//# sourceMappingURL=plugin-apply.d.ts.map

package/dist/plugin-apply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-apply.d.ts","sourceRoot":"","sources":["../src/plugin-apply.ts"],"names":[],"mappings":"AAwDA,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,wBAAsB,UAAU,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAuB7F;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,wBAAsB,aAAa,CAAC,EAClC,SAAS,EACT,SAAS,EACT,SAAgB,GACjB,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAiB/B"}

package/dist/plugin-apply.js

@@ -0,0 +1,89 @@
+import { copyDocs, copyExamples } from './injectors/assets.js';
+import { mergePluginEnv, removePluginEnv } from './injectors/envJson.js';
+import { applyFixture, removeFixture } from './injectors/fixturesBarrel.js';
+import { mergePluginPackageJson, removePluginPackageJson } from './injectors/packageJson.js';
+import { applyProject, removeProject } from './injectors/pwConfig.js';
+import { loadPluginManifest } from './manifest.js';
+import { findKnownPlugin } from './registry.js';
+import { log } from './util/log.js';
+import { run } from './util/run.js';
+/** Resolve plugin ids/packages to npm package names via the known-plugins registry. */
+function toPackages(pluginIds) {
+    return pluginIds
+        .map(id => findKnownPlugin(id)?.package ?? (id.startsWith('@') ? id : undefined))
+        .filter((p) => Boolean(p));
+}
+/** Run all injectors for one plugin manifest. Warns (does not throw) when a marker is missing. */
+function injectManifest(clientDir, m) {
+    mergePluginPackageJson(clientDir, m);
+    mergePluginEnv(clientDir, m);
+    copyExamples(clientDir, m);
+    copyDocs(clientDir, m);
+    if (applyFixture(clientDir, m) === false) {
+        log.warn(`fixtures/index.ts is missing a pwtap marker — wire ${m.name} into the barrel manually ` +
+            `(import from '${m.fixture?.importFrom}' and add to mergeTests/mergeExpects).`);
+    }
+    if (applyProject(clientDir, m) === false) {
+        log.warn(`playwright.config.ts is missing a pwtap marker — add this project manually:\n  ${m.playwrightProject?.gate}`);
+    }
+}
+/** Best-effort post-install host check (advisory — never throws). */
+async function runEnsure(clientDir, m) {
+    if (!m.ensure) {
+        return;
+    }
+    try {
+        const { createRequire } = await import('node:module');
+        const { pathToFileURL } = await import('node:url');
+        const require = createRequire(`${clientDir}/`);
+        const resolved = require.resolve(`${m.name}/${m.ensure}`, { paths: [clientDir] });
+        const mod = (await import(pathToFileURL(resolved).href));
+        await mod.ensure?.();
+    }
+    catch (err) {
+        log.warn(`${m.name} ensure() check skipped: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+export async function addPlugins({ clientDir, pluginIds, install }) {
+    const packages = toPackages(pluginIds);
+    if (packages.length === 0) {
+        return;
+    }
+    if (install) {
+        log.step(`Installing plugin${packages.length > 1 ? 's' : ''}: ${packages.join(', ')}`);
+        await run('npm', ['install', '-D', ...packages], { cwd: clientDir });
+    }
+    for (const pkg of packages) {
+        const m = await loadPluginManifest(clientDir, pkg);
+        if (!m) {
+            log.warn(`Could not load manifest for ${pkg} — is it installed? Skipping.`);
+            continue;
+        }
+        injectManifest(clientDir, m);
+        await runEnsure(clientDir, m);
+        log.done(`Added ${pkg}`);
+    }
+    // Reconcile: install any devDependencies the plugin manifests added to package.json.
+    if (install) {
+        await run('npm', ['install'], { cwd: clientDir });
+    }
+}
+export async function removePlugins({ clientDir, pluginIds, uninstall = true, }) {
+    const packages = toPackages(pluginIds);
+    for (const pkg of packages) {
+        const m = await loadPluginManifest(clientDir, pkg);
+        if (!m) {
+            log.warn(`Could not load manifest for ${pkg} — skipping (already removed?).`);
+            continue;
+        }
+        removeFixture(clientDir, m);
+        removeProject(clientDir, m);
+        removePluginEnv(clientDir, m);
+        removePluginPackageJson(clientDir, m);
+        log.done(`Removed ${pkg}`);
+    }
+    if (uninstall && packages.length > 0) {
+        await run('npm', ['uninstall', ...packages], { cwd: clientDir });
+    }
+}
+//# sourceMappingURL=plugin-apply.js.map

package/dist/plugin-apply.js.map

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

package/dist/prompts.d.ts

@@ -0,0 +1,22 @@
+import type { KnownPlugin } from './registry.js';
+/**
+ * Tiny zero-dependency prompter. In non-interactive mode (no TTY or `--yes`) every prompt resolves
+ * to its default immediately, so CI and `npm init @pwtap dir -y` never hang.
+ *
+ * @example
+ * const p = new Prompter(false);
+ * const name = await p.text('Project name', 'my-tests');
+ * p.close();
+ */
+export declare class Prompter {
+    private readonly interactive;
+    private rl?;
+    constructor(yes: boolean);
+    private io;
+    text(question: string, def: string): Promise<string>;
+    confirm(question: string, def: boolean): Promise<boolean>;
+    /** Present selectable plugins (coming-soon shown but not selectable); returns chosen ids. */
+    selectPlugins(plugins: KnownPlugin[]): Promise<string[]>;
+    close(): void;
+}
+//# sourceMappingURL=prompts.d.ts.map

package/dist/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD;;;;;;;;GAQG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAU;IACtC,OAAO,CAAC,EAAE,CAAC,CAAqB;gBAEpB,GAAG,EAAE,OAAO;IAIxB,OAAO,CAAC,EAAE;IAOJ,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQpD,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAY/D,6FAA6F;IACvF,aAAa,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAqB9D,KAAK,IAAI,IAAI;CAGd"}

package/dist/prompts.js

@@ -0,0 +1,65 @@
+import { stdin, stdout } from 'node:process';
+import readline from 'node:readline/promises';
+/**
+ * Tiny zero-dependency prompter. In non-interactive mode (no TTY or `--yes`) every prompt resolves
+ * to its default immediately, so CI and `npm init @pwtap dir -y` never hang.
+ *
+ * @example
+ * const p = new Prompter(false);
+ * const name = await p.text('Project name', 'my-tests');
+ * p.close();
+ */
+export class Prompter {
+    interactive;
+    rl;
+    constructor(yes) {
+        this.interactive = Boolean(stdin.isTTY) && !yes;
+    }
+    io() {
+        if (!this.rl) {
+            this.rl = readline.createInterface({ input: stdin, output: stdout });
+        }
+        return this.rl;
+    }
+    async text(question, def) {
+        if (!this.interactive) {
+            return def;
+        }
+        const answer = (await this.io().question(`${question} (${def}): `)).trim();
+        return answer || def;
+    }
+    async confirm(question, def) {
+        if (!this.interactive) {
+            return def;
+        }
+        const hint = def ? 'Y/n' : 'y/N';
+        const answer = (await this.io().question(`${question} (${hint}): `)).trim().toLowerCase();
+        if (!answer) {
+            return def;
+        }
+        return answer === 'y' || answer === 'yes';
+    }
+    /** Present selectable plugins (coming-soon shown but not selectable); returns chosen ids. */
+    async selectPlugins(plugins) {
+        const selectable = plugins.filter(p => p.status !== 'coming-soon');
+        if (!this.interactive || selectable.length === 0) {
+            return plugins.filter(p => p.defaultSelected && p.status !== 'coming-soon').map(p => p.id);
+        }
+        stdout.write('\nOptional plugins (comma-separated numbers, blank for none):\n');
+        plugins.forEach((p, i) => {
+            const n = p.status === 'coming-soon' ? '  -' : ` ${String(i + 1).padStart(2)}`;
+            const tag = p.status === 'coming-soon' ? ' [coming soon]' : '';
+            stdout.write(`${n}. [${p.category}] ${p.package} — ${p.description}${tag}\n`);
+        });
+        const answer = await this.io().question('> ');
+        const picked = new Set(answer
+            .split(',')
+            .map(s => Number(s.trim()))
+            .filter(n => Number.isInteger(n)));
+        return plugins.filter((p, i) => picked.has(i + 1) && p.status !== 'coming-soon').map(p => p.id);
+    }
+    close() {
+        this.rl?.close();
+    }
+}
+//# sourceMappingURL=prompts.js.map

package/dist/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,QAAQ,MAAM,wBAAwB,CAAC;AAI9C;;;;;;;;GAQG;AACH,MAAM,OAAO,QAAQ;IACF,WAAW,CAAU;IAC9B,EAAE,CAAsB;IAEhC,YAAY,GAAY;QACtB,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;IAClD,CAAC;IAEO,EAAE;QACR,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YACb,IAAI,CAAC,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QACvE,CAAC;QACD,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,QAAgB,EAAE,GAAW;QACtC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,OAAO,GAAG,CAAC;QACb,CAAC;QACD,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,QAAQ,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC3E,OAAO,MAAM,IAAI,GAAG,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,QAAgB,EAAE,GAAY;QAC1C,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,OAAO,GAAG,CAAC;QACb,CAAC;QACD,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;QACjC,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,QAAQ,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC1F,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,GAAG,CAAC;QACb,CAAC;QACD,OAAO,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,KAAK,CAAC;IAC5C,CAAC;IAED,6FAA6F;IAC7F,KAAK,CAAC,aAAa,CAAC,OAAsB;QACxC,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,aAAa,CAAC,CAAC;QACnE,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjD,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,eAAe,IAAI,CAAC,CAAC,MAAM,KAAK,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC7F,CAAC;QACD,MAAM,CAAC,KAAK,CAAC,iEAAiE,CAAC,CAAC;QAChF,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACvB,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/E,MAAM,GAAG,GAAG,CAAC,CAAC,MAAM,KAAK,aAAa,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/D,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,OAAO,MAAM,CAAC,CAAC,WAAW,GAAG,GAAG,IAAI,CAAC,CAAC;QAChF,CAAC,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,IAAI,GAAG,CACpB,MAAM;aACH,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;aAC1B,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CACpC,CAAC;QACF,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAClG,CAAC;IAED,KAAK;QACH,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC;IACnB,CAAC;CACF"}

package/dist/registry.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Curated, pre-install plugin registry. Ships inside @pwtap/create so the interactive menu can be
+ * built BEFORE any plugin is installed. The authoritative injection metadata travels with each
+ * plugin (see PluginManifest); this only drives menu rendering and `--flag` resolution.
+ *
+ * @example
+ * const chosen = KNOWN_PLUGINS.filter(p => selectedIds.includes(p.id)).map(p => p.package);
+ */
+export interface KnownPlugin {
+    /** Stable slug — used for dirs, markers, and the Playwright project name. */
+    id: string;
+    /** npm package to install (e.g. '@pwtap/plugin-maestro'). */
+    package: string;
+    /** Menu grouping label. */
+    category: string;
+    /** One-line menu description. */
+    description: string;
+    /** Non-interactive selection flag (e.g. '--maestro'). */
+    flag: string;
+    defaultSelected: boolean;
+    status?: 'stable' | 'coming-soon';
+}
+export declare const KNOWN_PLUGINS: KnownPlugin[];
+/** Find a known plugin by id or package name. */
+export declare function findKnownPlugin(idOrPackage: string): KnownPlugin | undefined;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,WAAW;IAC1B,6EAA6E;IAC7E,EAAE,EAAE,MAAM,CAAC;IACX,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,OAAO,CAAC;IACzB,MAAM,CAAC,EAAE,QAAQ,GAAG,aAAa,CAAC;CACnC;AAED,eAAO,MAAM,aAAa,EAAE,WAAW,EA4BtC,CAAC;AAEF,iDAAiD;AACjD,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAE5E"}

package/dist/registry.js

@@ -0,0 +1,34 @@
+export const KNOWN_PLUGINS = [
+    {
+        id: 'maestro',
+        package: '@pwtap/plugin-maestro',
+        category: 'mobile',
+        description: 'Mobile testing with Maestro flows (Android + iOS)',
+        flag: '--maestro',
+        defaultSelected: false,
+        status: 'coming-soon',
+    },
+    {
+        id: 'appium',
+        package: '@pwtap/plugin-appium',
+        category: 'mobile',
+        description: 'Mobile testing with Appium (iOS XCUITest, Android UiAutomator2)',
+        flag: '--appium',
+        defaultSelected: false,
+        status: 'coming-soon',
+    },
+    {
+        id: 'ai-judge',
+        package: '@pwtap/plugin-ai-judge',
+        category: 'ai',
+        description: 'AI/LLM judge matchers (toPassRubric, toScoreAtLeast, toMatchImage)',
+        flag: '--ai-judge',
+        defaultSelected: false,
+        status: 'stable',
+    },
+];
+/** Find a known plugin by id or package name. */
+export function findKnownPlugin(idOrPackage) {
+    return KNOWN_PLUGINS.find(p => p.id === idOrPackage || p.package === idOrPackage);
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAuBA,MAAM,CAAC,MAAM,aAAa,GAAkB;IAC1C;QACE,EAAE,EAAE,SAAS;QACb,OAAO,EAAE,uBAAuB;QAChC,QAAQ,EAAE,QAAQ;QAClB,WAAW,EAAE,mDAAmD;QAChE,IAAI,EAAE,WAAW;QACjB,eAAe,EAAE,KAAK;QACtB,MAAM,EAAE,aAAa;KACtB;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,OAAO,EAAE,sBAAsB;QAC/B,QAAQ,EAAE,QAAQ;QAClB,WAAW,EAAE,iEAAiE;QAC9E,IAAI,EAAE,UAAU;QAChB,eAAe,EAAE,KAAK;QACtB,MAAM,EAAE,aAAa;KACtB;IACD;QACE,EAAE,EAAE,UAAU;QACd,OAAO,EAAE,wBAAwB;QACjC,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,oEAAoE;QACjF,IAAI,EAAE,YAAY;QAClB,eAAe,EAAE,KAAK;QACtB,MAAM,EAAE,QAAQ;KACjB;CACF,CAAC;AAEF,iDAAiD;AACjD,MAAM,UAAU,eAAe,CAAC,WAAmB;IACjD,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,WAAW,IAAI,CAAC,CAAC,OAAO,KAAK,WAAW,CAAC,CAAC;AACpF,CAAC"}

package/dist/util/fs.d.ts

@@ -0,0 +1,13 @@
+/** Recursively copy a directory tree (Node 20's fs.cpSync). */
+export declare function copyDir(src: string, dest: string): void;
+export declare function exists(p: string): boolean;
+export declare function readText(p: string): string;
+export declare function writeText(p: string, content: string): void;
+export declare function readJson<T>(p: string): T;
+export declare function writeJson(p: string, data: unknown): void;
+export declare function ensureDir(p: string): void;
+/** True when `p` is absent or an empty directory (used to guard scaffolding into a fresh dir). */
+export declare function isEmptyDir(p: string): boolean;
+/** Sort an object's keys (stable package.json output). */
+export declare function sortObject<T extends Record<string, unknown>>(obj: T): T;
+//# sourceMappingURL=fs.d.ts.map

package/dist/util/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/util/fs.ts"],"names":[],"mappings":"AAEA,+DAA+D;AAC/D,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAEvD;AAED,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAEzC;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE1C;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1D;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,CAAC,CAExC;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAExD;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAEzC;AAED,kGAAkG;AAClG,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAE7C;AAED,0DAA0D;AAC1D,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAEvE"}

package/dist/util/fs.js

@@ -0,0 +1,32 @@
+import fs from 'node:fs';
+/** Recursively copy a directory tree (Node 20's fs.cpSync). */
+export function copyDir(src, dest) {
+    fs.cpSync(src, dest, { recursive: true });
+}
+export function exists(p) {
+    return fs.existsSync(p);
+}
+export function readText(p) {
+    return fs.readFileSync(p, 'utf8');
+}
+export function writeText(p, content) {
+    fs.writeFileSync(p, content);
+}
+export function readJson(p) {
+    return JSON.parse(fs.readFileSync(p, 'utf8'));
+}
+export function writeJson(p, data) {
+    fs.writeFileSync(p, `${JSON.stringify(data, null, 2)}\n`);
+}
+export function ensureDir(p) {
+    fs.mkdirSync(p, { recursive: true });
+}
+/** True when `p` is absent or an empty directory (used to guard scaffolding into a fresh dir). */
+export function isEmptyDir(p) {
+    return !fs.existsSync(p) || fs.readdirSync(p).length === 0;
+}
+/** Sort an object's keys (stable package.json output). */
+export function sortObject(obj) {
+    return Object.fromEntries(Object.entries(obj).sort(([a], [b]) => a.localeCompare(b)));
+}
+//# sourceMappingURL=fs.js.map

package/dist/util/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../src/util/fs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzB,+DAA+D;AAC/D,MAAM,UAAU,OAAO,CAAC,GAAW,EAAE,IAAY;IAC/C,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,CAAS;IAC9B,OAAO,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,CAAS;IAChC,OAAO,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,CAAS,EAAE,OAAe;IAClD,EAAE,CAAC,aAAa,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,QAAQ,CAAI,CAAS;IACnC,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAM,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,CAAS,EAAE,IAAa;IAChD,EAAE,CAAC,aAAa,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,CAAS;IACjC,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AACvC,CAAC;AAED,kGAAkG;AAClG,MAAM,UAAU,UAAU,CAAC,CAAS;IAClC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;AAC7D,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,UAAU,CAAoC,GAAM;IAClE,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAM,CAAC;AAC7F,CAAC"}

package/dist/util/log.d.ts

@@ -0,0 +1,8 @@
+export declare const log: {
+    info: (msg: string) => void;
+    warn: (msg: string) => void;
+    error: (msg: string) => void;
+    step: (msg: string) => void;
+    done: (msg: string) => void;
+};
+//# sourceMappingURL=log.d.ts.map

package/dist/util/log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../src/util/log.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,GAAG;gBACF,MAAM,KAAG,IAAI;gBACb,MAAM,KAAG,IAAI;iBACZ,MAAM,KAAG,IAAI;gBACd,MAAM,KAAG,IAAI;gBACb,MAAM,KAAG,IAAI;CAC1B,CAAC"}

package/dist/util/log.js

@@ -0,0 +1,9 @@
+/* Minimal console logger for the scaffolder. */
+export const log = {
+    info: (msg) => console.info(msg),
+    warn: (msg) => console.warn(`⚠ ${msg}`),
+    error: (msg) => console.error(`✖ ${msg}`),
+    step: (msg) => console.info(`\n▸ ${msg}`),
+    done: (msg) => console.info(`✓ ${msg}`),
+};
+//# sourceMappingURL=log.js.map

package/dist/util/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../../src/util/log.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,IAAI,EAAE,CAAC,GAAW,EAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC;IAC9C,IAAI,EAAE,CAAC,GAAW,EAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;IACrD,KAAK,EAAE,CAAC,GAAW,EAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC;IACvD,IAAI,EAAE,CAAC,GAAW,EAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;IACvD,IAAI,EAAE,CAAC,GAAW,EAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;CACtD,CAAC"}

package/dist/util/markers.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Managed-region editing for generated files. A region is a pair of line comments
+ * `// pwtap:<key>` … `// pwtap:<key>:end`; `add`/`remove` splice lines between them idempotently.
+ * If a marker is missing (a user deleted it) `locate` throws a `MarkerError` so the caller can print
+ * a paste-block instead of making a half-edit.
+ *
+ * @example
+ * let src = addToRegion(barrel, 'plugins:tests', '  maestroTest,', 'maestroTest');
+ * src = removeFromRegion(src, 'plugins:tests', 'maestroTest');
+ */
+export declare class MarkerError extends Error {
+    readonly key: string;
+    constructor(key: string);
+}
+export declare function hasRegion(source: string, key: string): boolean;
+/** Insert `line` before the end marker of `key`, unless `uniq` already appears in the region. */
+export declare function addToRegion(source: string, key: string, line: string, uniq: string): string;
+/** Remove every line inside `key`'s region that contains `uniq`. */
+export declare function removeFromRegion(source: string, key: string, uniq: string): string;
+//# sourceMappingURL=markers.d.ts.map

package/dist/util/markers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markers.d.ts","sourceRoot":"","sources":["../../src/util/markers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,qBAAa,WAAY,SAAQ,KAAK;aACR,GAAG,EAAE,MAAM;gBAAX,GAAG,EAAE,MAAM;CAIxC;AAeD,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED,iGAAiG;AACjG,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAQ3F;AAED,oEAAoE;AACpE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAMlF"}

package/dist/util/markers.js

@@ -0,0 +1,51 @@
+/**
+ * Managed-region editing for generated files. A region is a pair of line comments
+ * `// pwtap:<key>` … `// pwtap:<key>:end`; `add`/`remove` splice lines between them idempotently.
+ * If a marker is missing (a user deleted it) `locate` throws a `MarkerError` so the caller can print
+ * a paste-block instead of making a half-edit.
+ *
+ * @example
+ * let src = addToRegion(barrel, 'plugins:tests', '  maestroTest,', 'maestroTest');
+ * src = removeFromRegion(src, 'plugins:tests', 'maestroTest');
+ */
+export class MarkerError extends Error {
+    key;
+    constructor(key) {
+        super(`[pwtap] managed region '${key}' markers not found`);
+        this.key = key;
+        this.name = 'MarkerError';
+    }
+}
+const startMarker = (key) => `// pwtap:${key}`;
+const endMarker = (key) => `// pwtap:${key}:end`;
+function locate(source, key) {
+    const lines = source.split('\n');
+    const start = lines.findIndex(l => l.trim() === startMarker(key));
+    const end = lines.findIndex(l => l.trim() === endMarker(key));
+    if (start === -1 || end === -1 || end < start) {
+        throw new MarkerError(key);
+    }
+    return { start, end, lines };
+}
+export function hasRegion(source, key) {
+    return source.includes(startMarker(key)) && source.includes(endMarker(key));
+}
+/** Insert `line` before the end marker of `key`, unless `uniq` already appears in the region. */
+export function addToRegion(source, key, line, uniq) {
+    const { start, end, lines } = locate(source, key);
+    const region = lines.slice(start + 1, end);
+    if (region.some(l => l.includes(uniq))) {
+        return source; // already present — idempotent
+    }
+    lines.splice(end, 0, line);
+    return lines.join('\n');
+}
+/** Remove every line inside `key`'s region that contains `uniq`. */
+export function removeFromRegion(source, key, uniq) {
+    const { start, end, lines } = locate(source, key);
+    const before = lines.slice(0, start + 1);
+    const inside = lines.slice(start + 1, end).filter(l => !l.includes(uniq));
+    const after = lines.slice(end);
+    return [...before, ...inside, ...after].join('\n');
+}
+//# sourceMappingURL=markers.js.map

package/dist/util/markers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markers.js","sourceRoot":"","sources":["../../src/util/markers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,OAAO,WAAY,SAAQ,KAAK;IACR;IAA5B,YAA4B,GAAW;QACrC,KAAK,CAAC,2BAA2B,GAAG,qBAAqB,CAAC,CAAC;QADjC,QAAG,GAAH,GAAG,CAAQ;QAErC,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED,MAAM,WAAW,GAAG,CAAC,GAAW,EAAU,EAAE,CAAC,YAAY,GAAG,EAAE,CAAC;AAC/D,MAAM,SAAS,GAAG,CAAC,GAAW,EAAU,EAAE,CAAC,YAAY,GAAG,MAAM,CAAC;AAEjE,SAAS,MAAM,CAAC,MAAc,EAAE,GAAW;IACzC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACjC,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;IAClE,MAAM,GAAG,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9D,IAAI,KAAK,KAAK,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,GAAG,GAAG,KAAK,EAAE,CAAC;QAC9C,MAAM,IAAI,WAAW,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,MAAc,EAAE,GAAW;IACnD,OAAO,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;AAC9E,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,WAAW,CAAC,MAAc,EAAE,GAAW,EAAE,IAAY,EAAE,IAAY;IACjF,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;IAC3C,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QACvC,OAAO,MAAM,CAAC,CAAC,+BAA+B;IAChD,CAAC;IACD,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;IAC3B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,gBAAgB,CAAC,MAAc,EAAE,GAAW,EAAE,IAAY;IACxE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1E,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/B,OAAO,CAAC,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACrD,CAAC"}

package/dist/util/run.d.ts

@@ -0,0 +1,8 @@
+export interface RunOptions {
+    cwd?: string;
+    /** Silence child stdio (default false — inherit, so npm/playwright output is visible). */
+    silent?: boolean;
+}
+/** Run a command to completion; rejects on non-zero exit or spawn error. */
+export declare function run(cmd: string, args: string[], opts?: RunOptions): Promise<void>;
+//# sourceMappingURL=run.d.ts.map

package/dist/util/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/util/run.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,0FAA0F;IAC1F,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,4EAA4E;AAC5E,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,GAAE,UAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAerF"}