@vijaypjavvadi/pw-emit 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,50 @@
+# pw-emit — CHANGELOG
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+_Nothing yet._
+
+## [1.0.0] — 2026-05-03
+
+First public npm release. Consumed by `@vijaypjavvadi/bdd2pw@1.0.0` from day one;
+`sel2pw` migration tracked separately (still on its own internal copy, byte-identical
+output verified against the shared emitter).
+
+### Added
+- Initial scaffold (configs, CI, tests/, templates/, src/).
+- IR types: `PageObjectIR`, `TestSpecIR`, `LocatorChoice`, `PomMethodIR`,
+  `TestCaseIR`, `HookIR`, `ReviewItem`, `EmitResult`.
+- Naming utilities: `toCamelCase`, `toKebabCase`, `toPascalCase`,
+  `pageObjectFileName`, `testFileName`.
+- `dedentAndIndent` helper (lifted from sel2pw).
+- Locator rendering: `renderLocatorExpr`, `renderFieldDeclaration`,
+  `renderFieldAssignment`.
+- `emitPageObject(ir, opts?)` — IR → TS class string. Supports optional
+  `selfHealingShim` mode.
+- `emitTestSpec(ir)` — IR → TS spec file string. Supports `Background:`-style
+  `beforeEach` and Scenario-Outline parameterised cases via the consumer's IR.
+- `emitProject({ outDir, templatesDir, baseUrl, projectName })` — scaffold a
+  Playwright TS project from templates.
+- Four bundled templates: `package.json`, `playwright.config.ts`,
+  `tsconfig.json`, `gitignore`.
+- Snapshot tests covering `emitPageObject` (5 IRs) and `emitTestSpec` (3 IRs).
+- Unit tests for naming, indent, locator rendering.
+- GitHub Actions CI matrix: Ubuntu/macOS/Windows × Node 18/20/22.
+- Tag-triggered release workflow with `npm publish --provenance`.
+
+### Public API contract
+
+Stable named exports, SemVer-committed:
+
+`emitPageObject`, `emitTestSpec`, `emitProject`,
+`renderLocatorExpr`, `renderFieldDeclaration`, `renderFieldAssignment`,
+`toCamelCase`, `toPascalCase`, `toKebabCase`, `pageObjectFileName`,
+`testFileName`, `dedentAndIndent`,
+plus the IR types listed above.
+
+Breaking changes to any of these will require a major version bump.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vijay P. Javvadi
+
+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,126 @@
+# @vijaypjavvadi/pw-emit
+
+> Shared emitter library that renders Playwright TypeScript Page Objects, spec files, and project scaffolds from a generic IR.
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+Powers both [`@vijaypjavvadi/sel2pw`](https://github.com/javvadivijayprasad/sel2pw) (planned, post-v1.0) and [`@vijaypjavvadi/bdd2pw`](https://github.com/javvadivijayprasad/bdd2pw) (from day one).
+
+## Why this exists
+
+Both `sel2pw` (Selenium Java → Playwright TS) and `bdd2pw` (Gherkin → Playwright TS) need to emit the same shape of Page Objects, spec files, and project scaffolds. Without this package, they'd have two copies of the emitter — and divergence would be inevitable.
+
+`pw-emit` is the **single source of truth** for what a generated Playwright TS file looks like. It does **not** parse Java, does **not** parse Gherkin — its inputs are clean IRs, and it produces TypeScript strings.
+
+## Install
+
+```bash
+npm install @vijaypjavvadi/pw-emit
+```
+
+Peer dep: the **target** project (the one being scaffolded) needs `@playwright/test ≥ 1.40` — but `pw-emit` itself doesn't.
+
+## Quick example
+
+```ts
+import { emitPageObject, type PageObjectIR } from "@vijaypjavvadi/pw-emit";
+
+const ir: PageObjectIR = {
+  className: "LoginPage",
+  fields: [
+    { api: "getByLabel", args: "'Username'", fieldName: "usernameInput" },
+    { api: "getByLabel", args: "'Password'", fieldName: "passwordInput" },
+    { api: "getByRole", args: "'button', { name: 'Sign in' }", fieldName: "signInButton" },
+  ],
+  methods: [
+    {
+      name: "login",
+      params: [{ name: "user", type: "string" }, { name: "pass", type: "string" }],
+      body: "await this.usernameInput.fill(user);\nawait this.passwordInput.fill(pass);\nawait this.signInButton.click();",
+    },
+  ],
+};
+
+const result = emitPageObject(ir);
+console.log(result.contents);
+```
+
+Produces:
+
+```ts
+import { Page, Locator, expect } from "@playwright/test";
+
+export class LoginPage {
+  readonly page: Page;
+  readonly usernameInput: Locator;
+  readonly passwordInput: Locator;
+  readonly signInButton: Locator;
+
+  constructor(page: Page) {
+    this.page = page;
+    this.usernameInput = page.getByLabel("Username");
+    this.passwordInput = page.getByLabel("Password");
+    this.signInButton = page.getByRole("button", { name: "Sign in" });
+  }
+
+  async login(user: string, pass: string): Promise<void> {
+    await this.usernameInput.fill(user);
+    await this.passwordInput.fill(pass);
+    await this.signInButton.click();
+  }
+}
+```
+
+## Public API
+
+### Emitters
+
+```ts
+emitPageObject(ir: PageObjectIR, opts?: { selfHealingShim?: boolean }): EmitResult;
+emitTestSpec(ir: TestSpecIR): EmitResult;
+emitProject(opts: {
+  outDir: string;
+  templatesDir?: string;       // override the built-in templates
+  baseUrl?: string;            // injected into playwright.config.ts
+  projectName?: string;        // injected into package.json
+}): Promise<{ filesWritten: string[]; warnings: ReviewItem[] }>;
+```
+
+### Locator rendering
+
+```ts
+renderLocatorExpr(choice: LocatorChoice, pageVar?: string): string;
+renderFieldDeclaration(choice: LocatorChoice): string;       // "  readonly foo: Locator;"
+renderFieldAssignment(choice: LocatorChoice, pageVar?: string): string;
+```
+
+### Naming + indent
+
+```ts
+toCamelCase(s: string): string;
+toKebabCase(s: string): string;
+toPascalCase(s: string): string;
+pageObjectFileName(className: string): string;   // "LoginPage" → "login.page.ts"
+testFileName(className: string): string;          // "LoginTest" → "login.spec.ts"
+dedentAndIndent(body: string, prefix: string): string;
+```
+
+### IR types
+
+`PageObjectIR`, `PomMethodIR`, `LocatorChoice`, `TestSpecIR`, `TestCaseIR`, `ReviewItem`, `EmitResult` — all exported from the root.
+
+## Design rule that makes this work
+
+**Method bodies arrive pre-rendered.** `pw-emit` does not transform method bodies — it places them inside a class wrapper, indents them correctly, and worries about imports. Each consumer (`sel2pw`, `bdd2pw`) is responsible for producing valid TS body strings from its own input.
+
+This is the single decision that lets `sel2pw` (which rewrites raw Java method bodies) and `bdd2pw` (which assembles bodies from Gherkin step bindings) share an emitter without one having to know about the other's input format.
+
+## SemVer commitments
+
+- **Patch:** bug fixes, additive warnings, formatting tweaks.
+- **Minor:** new exported helpers, new optional input fields (defaulted).
+- **Major:** any change to the **emitted file shape** (POM/spec format), required input fields, or removed exports.
+
+## License
+
+MIT

package/dist/indent.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Trim leading/trailing blank lines and re-indent a method body so it
+ * fits cleanly under a TypeScript class method opening at depth `prefix`.
+ *
+ * Strategy:
+ *   1. Strip purely-blank leading and trailing lines.
+ *   2. Find the minimum indent across non-blank lines.
+ *   3. Subtract that indent from every line, then prepend `prefix`.
+ *
+ * Preserves nested structure (loops, if-blocks) while normalising the
+ * outer indent.
+ *
+ * Lifted as-is from sel2pw v1.0.0 `src/utils/indent.ts`.
+ */
+export declare function dedentAndIndent(body: string, prefix: string): string;

package/dist/indent.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dedentAndIndent = dedentAndIndent;
+/**
+ * Trim leading/trailing blank lines and re-indent a method body so it
+ * fits cleanly under a TypeScript class method opening at depth `prefix`.
+ *
+ * Strategy:
+ *   1. Strip purely-blank leading and trailing lines.
+ *   2. Find the minimum indent across non-blank lines.
+ *   3. Subtract that indent from every line, then prepend `prefix`.
+ *
+ * Preserves nested structure (loops, if-blocks) while normalising the
+ * outer indent.
+ *
+ * Lifted as-is from sel2pw v1.0.0 `src/utils/indent.ts`.
+ */
+function dedentAndIndent(body, prefix) {
+    const lines = body.split("\n");
+    while (lines.length && lines[0].trim() === "")
+        lines.shift();
+    while (lines.length && lines[lines.length - 1].trim() === "")
+        lines.pop();
+    if (lines.length === 0)
+        return "";
+    let minIndent = Infinity;
+    for (const line of lines) {
+        if (line.trim() === "")
+            continue;
+        const m = line.match(/^[\t ]*/);
+        const len = m ? m[0].length : 0;
+        if (len < minIndent)
+            minIndent = len;
+    }
+    if (!isFinite(minIndent))
+        minIndent = 0;
+    return lines
+        .map((line) => (line.trim() === "" ? "" : prefix + line.slice(minIndent)))
+        .join("\n");
+}
+//# sourceMappingURL=indent.js.map

package/dist/indent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indent.js","sourceRoot":"","sources":["../src/indent.ts"],"names":[],"mappings":";;AAcA,0CAmBC;AAjCD;;;;;;;;;;;;;GAaG;AACH,SAAgB,eAAe,CAAC,IAAY,EAAE,MAAc;IAC1D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAE/B,OAAO,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,KAAK,CAAC,KAAK,EAAE,CAAC;IAC7D,OAAO,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,KAAK,CAAC,GAAG,EAAE,CAAC;IAC1E,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAElC,IAAI,SAAS,GAAG,QAAQ,CAAC;IACzB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,SAAS;QACjC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAChC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAChC,IAAI,GAAG,GAAG,SAAS;YAAE,SAAS,GAAG,GAAG,CAAC;IACvC,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;QAAE,SAAS,GAAG,CAAC,CAAC;IAExC,OAAO,KAAK;SACT,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;SACzE,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Public API for `@vijaypjavvadi/pw-emit`.
+ *
+ * Stable named exports, SemVer-committed (see README.md).
+ */
+export { emitPageObject } from "./pageObjectEmitter";
+export type { EmitPageObjectOptions } from "./pageObjectEmitter";
+export { emitTestSpec } from "./testEmitter";
+export { emitProject } from "./projectEmitter";
+export type { EmitProjectOptions, EmitProjectResult } from "./projectEmitter";
+export { renderLocatorExpr, renderFieldDeclaration, renderFieldAssignment, } from "./locatorRender";
+export { toCamelCase, toPascalCase, toKebabCase, pageObjectFileName, testFileName, } from "./naming";
+export { dedentAndIndent } from "./indent";
+export type { LocatorChoice, PageObjectIR, PomMethodIR, TestSpecIR, TestCaseIR, HookIR, ReviewItem, EmitResult, } from "./types";

package/dist/index.js

@@ -0,0 +1,31 @@
+"use strict";
+/**
+ * Public API for `@vijaypjavvadi/pw-emit`.
+ *
+ * Stable named exports, SemVer-committed (see README.md).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dedentAndIndent = exports.testFileName = exports.pageObjectFileName = exports.toKebabCase = exports.toPascalCase = exports.toCamelCase = exports.renderFieldAssignment = exports.renderFieldDeclaration = exports.renderLocatorExpr = exports.emitProject = exports.emitTestSpec = exports.emitPageObject = void 0;
+// Emitters
+var pageObjectEmitter_1 = require("./pageObjectEmitter");
+Object.defineProperty(exports, "emitPageObject", { enumerable: true, get: function () { return pageObjectEmitter_1.emitPageObject; } });
+var testEmitter_1 = require("./testEmitter");
+Object.defineProperty(exports, "emitTestSpec", { enumerable: true, get: function () { return testEmitter_1.emitTestSpec; } });
+var projectEmitter_1 = require("./projectEmitter");
+Object.defineProperty(exports, "emitProject", { enumerable: true, get: function () { return projectEmitter_1.emitProject; } });
+// Locator rendering
+var locatorRender_1 = require("./locatorRender");
+Object.defineProperty(exports, "renderLocatorExpr", { enumerable: true, get: function () { return locatorRender_1.renderLocatorExpr; } });
+Object.defineProperty(exports, "renderFieldDeclaration", { enumerable: true, get: function () { return locatorRender_1.renderFieldDeclaration; } });
+Object.defineProperty(exports, "renderFieldAssignment", { enumerable: true, get: function () { return locatorRender_1.renderFieldAssignment; } });
+// Naming
+var naming_1 = require("./naming");
+Object.defineProperty(exports, "toCamelCase", { enumerable: true, get: function () { return naming_1.toCamelCase; } });
+Object.defineProperty(exports, "toPascalCase", { enumerable: true, get: function () { return naming_1.toPascalCase; } });
+Object.defineProperty(exports, "toKebabCase", { enumerable: true, get: function () { return naming_1.toKebabCase; } });
+Object.defineProperty(exports, "pageObjectFileName", { enumerable: true, get: function () { return naming_1.pageObjectFileName; } });
+Object.defineProperty(exports, "testFileName", { enumerable: true, get: function () { return naming_1.testFileName; } });
+// Indent
+var indent_1 = require("./indent");
+Object.defineProperty(exports, "dedentAndIndent", { enumerable: true, get: function () { return indent_1.dedentAndIndent; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,WAAW;AACX,yDAAqD;AAA5C,mHAAA,cAAc,OAAA;AAEvB,6CAA6C;AAApC,2GAAA,YAAY,OAAA;AACrB,mDAA+C;AAAtC,6GAAA,WAAW,OAAA;AAGpB,oBAAoB;AACpB,iDAIyB;AAHvB,kHAAA,iBAAiB,OAAA;AACjB,uHAAA,sBAAsB,OAAA;AACtB,sHAAA,qBAAqB,OAAA;AAGvB,SAAS;AACT,mCAMkB;AALhB,qGAAA,WAAW,OAAA;AACX,sGAAA,YAAY,OAAA;AACZ,qGAAA,WAAW,OAAA;AACX,4GAAA,kBAAkB,OAAA;AAClB,sGAAA,YAAY,OAAA;AAGd,SAAS;AACT,mCAA2C;AAAlC,yGAAA,eAAe,OAAA"}

package/dist/locatorRender.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Render a `LocatorChoice` as a Playwright TypeScript expression.
+ *
+ * The caller has already decided which API to use and constructed the
+ * `args` string. This module's job is to:
+ *   - prefix the page variable
+ *   - render the field declaration line
+ *   - render the constructor assignment line
+ *
+ * Selenium-specific decision logic (parsing `By.id` / `By.xpath` /
+ * `@FindBy` annotations into a `LocatorChoice`) lives in sel2pw, NOT
+ * here. bdd2pw makes its own `LocatorChoice` decisions from the
+ * Playwright MCP accessibility-tree snapshot.
+ */
+import type { LocatorChoice } from "./types";
+/**
+ * Render the locator expression itself.
+ *
+ *   { api: 'getByRole', args: "'button', { name: 'Sign in' }" }
+ *   → "page.getByRole('button', { name: 'Sign in' })"
+ */
+export declare function renderLocatorExpr(choice: LocatorChoice, pageVar?: string): string;
+/**
+ * Render a class field declaration line.
+ *
+ *   "  readonly usernameInput: Locator;"
+ */
+export declare function renderFieldDeclaration(choice: LocatorChoice): string;
+/**
+ * Render the constructor assignment line.
+ *
+ *   "    this.usernameInput = page.getByLabel('Username');"
+ */
+export declare function renderFieldAssignment(choice: LocatorChoice, pageVar?: string): string;

package/dist/locatorRender.js

@@ -0,0 +1,45 @@
+"use strict";
+/**
+ * Render a `LocatorChoice` as a Playwright TypeScript expression.
+ *
+ * The caller has already decided which API to use and constructed the
+ * `args` string. This module's job is to:
+ *   - prefix the page variable
+ *   - render the field declaration line
+ *   - render the constructor assignment line
+ *
+ * Selenium-specific decision logic (parsing `By.id` / `By.xpath` /
+ * `@FindBy` annotations into a `LocatorChoice`) lives in sel2pw, NOT
+ * here. bdd2pw makes its own `LocatorChoice` decisions from the
+ * Playwright MCP accessibility-tree snapshot.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderLocatorExpr = renderLocatorExpr;
+exports.renderFieldDeclaration = renderFieldDeclaration;
+exports.renderFieldAssignment = renderFieldAssignment;
+/**
+ * Render the locator expression itself.
+ *
+ *   { api: 'getByRole', args: "'button', { name: 'Sign in' }" }
+ *   → "page.getByRole('button', { name: 'Sign in' })"
+ */
+function renderLocatorExpr(choice, pageVar = "page") {
+    return `${pageVar}.${choice.api}(${choice.args})`;
+}
+/**
+ * Render a class field declaration line.
+ *
+ *   "  readonly usernameInput: Locator;"
+ */
+function renderFieldDeclaration(choice) {
+    return `  readonly ${choice.fieldName}: Locator;`;
+}
+/**
+ * Render the constructor assignment line.
+ *
+ *   "    this.usernameInput = page.getByLabel('Username');"
+ */
+function renderFieldAssignment(choice, pageVar = "page") {
+    return `    this.${choice.fieldName} = ${renderLocatorExpr(choice, pageVar)};`;
+}
+//# sourceMappingURL=locatorRender.js.map

package/dist/locatorRender.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locatorRender.js","sourceRoot":"","sources":["../src/locatorRender.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;AAUH,8CAKC;AAOD,wDAEC;AAOD,sDAKC;AAhCD;;;;;GAKG;AACH,SAAgB,iBAAiB,CAC/B,MAAqB,EACrB,UAAkB,MAAM;IAExB,OAAO,GAAG,OAAO,IAAI,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,IAAI,GAAG,CAAC;AACpD,CAAC;AAED;;;;GAIG;AACH,SAAgB,sBAAsB,CAAC,MAAqB;IAC1D,OAAO,cAAc,MAAM,CAAC,SAAS,YAAY,CAAC;AACpD,CAAC;AAED;;;;GAIG;AACH,SAAgB,qBAAqB,CACnC,MAAqB,EACrB,UAAkB,MAAM;IAExB,OAAO,YAAY,MAAM,CAAC,SAAS,MAAM,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC;AACjF,CAAC"}

package/dist/naming.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Naming helpers — pure string transforms. Stable across releases; any
+ * change here is a major version bump because emitted file names depend
+ * on these functions.
+ *
+ * Lifted from sel2pw v1.0.0 `src/utils/naming.ts` minus `javaTypeToTs`
+ * (which is Java-specific and stays in sel2pw).
+ */
+/**
+ * Convert a string in any common case to camelCase.
+ *
+ *   LoginPage              -> loginPage
+ *   CreateReferral_Link    -> createReferralLink
+ *   submit_btn             -> submitBtn
+ *   userInput              -> userInput  (already camelCase, untouched)
+ */
+export declare function toCamelCase(s: string): string;
+/**
+ * Convert a string in any common case to PascalCase.
+ *
+ *   login-page    -> LoginPage
+ *   login_page    -> LoginPage
+ *   loginPage     -> LoginPage
+ */
+export declare function toPascalCase(s: string): string;
+/**
+ * Convert a string in any common case to kebab-case.
+ *
+ *   LoginPage     -> login-page
+ *   submit_btn    -> submit-btn
+ *   userInput     -> user-input
+ */
+export declare function toKebabCase(s: string): string;
+/**
+ * Compute the file name for a Page Object class.
+ *
+ *   LoginPage          -> login.page.ts
+ *   LoginPages         -> login.page.ts
+ *   LoginPageObject    -> login.page.ts
+ *   LoginPageObjects   -> login.page.ts
+ *   LoginScreen        -> login.page.ts        (mobile-style suffix)
+ *   LoginView          -> login.page.ts        (alt convention)
+ *   LoginSection / LoginComponent etc. stay as-is — they describe sub-areas, not pages.
+ */
+export declare function pageObjectFileName(className: string): string;
+/**
+ * Compute the file name for a test class.
+ *
+ *   LoginTest      -> login.spec.ts
+ *   LoginTests     -> login.spec.ts
+ *   LoginTestCase  -> login.spec.ts
+ */
+export declare function testFileName(className: string): string;

package/dist/naming.js

@@ -0,0 +1,87 @@
+"use strict";
+/**
+ * Naming helpers — pure string transforms. Stable across releases; any
+ * change here is a major version bump because emitted file names depend
+ * on these functions.
+ *
+ * Lifted from sel2pw v1.0.0 `src/utils/naming.ts` minus `javaTypeToTs`
+ * (which is Java-specific and stays in sel2pw).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toCamelCase = toCamelCase;
+exports.toPascalCase = toPascalCase;
+exports.toKebabCase = toKebabCase;
+exports.pageObjectFileName = pageObjectFileName;
+exports.testFileName = testFileName;
+/**
+ * Convert a string in any common case to camelCase.
+ *
+ *   LoginPage              -> loginPage
+ *   CreateReferral_Link    -> createReferralLink
+ *   submit_btn             -> submitBtn
+ *   userInput              -> userInput  (already camelCase, untouched)
+ */
+function toCamelCase(s) {
+    if (!s)
+        return s;
+    return (s.charAt(0).toLowerCase() + s.slice(1)).replace(/_+([A-Za-z])/g, (_, c) => c.toUpperCase());
+}
+/**
+ * Convert a string in any common case to PascalCase.
+ *
+ *   login-page    -> LoginPage
+ *   login_page    -> LoginPage
+ *   loginPage     -> LoginPage
+ */
+function toPascalCase(s) {
+    if (!s)
+        return s;
+    const parts = s
+        .replace(/([a-z0-9])([A-Z])/g, "$1 $2")
+        .replace(/[_\-\s]+/g, " ")
+        .trim()
+        .split(/\s+/)
+        .filter(Boolean);
+    return parts
+        .map((p) => p.charAt(0).toUpperCase() + p.slice(1).toLowerCase())
+        .join("");
+}
+/**
+ * Convert a string in any common case to kebab-case.
+ *
+ *   LoginPage     -> login-page
+ *   submit_btn    -> submit-btn
+ *   userInput     -> user-input
+ */
+function toKebabCase(s) {
+    return s
+        .replace(/([a-z0-9])([A-Z])/g, "$1-$2")
+        .replace(/[_\s]+/g, "-")
+        .toLowerCase();
+}
+/**
+ * Compute the file name for a Page Object class.
+ *
+ *   LoginPage          -> login.page.ts
+ *   LoginPages         -> login.page.ts
+ *   LoginPageObject    -> login.page.ts
+ *   LoginPageObjects   -> login.page.ts
+ *   LoginScreen        -> login.page.ts        (mobile-style suffix)
+ *   LoginView          -> login.page.ts        (alt convention)
+ *   LoginSection / LoginComponent etc. stay as-is — they describe sub-areas, not pages.
+ */
+function pageObjectFileName(className) {
+    const stripped = toKebabCase(className).replace(/-(?:page-objects?|pages?|screens?|views?)$/, "");
+    return `${stripped}.page.ts`;
+}
+/**
+ * Compute the file name for a test class.
+ *
+ *   LoginTest      -> login.spec.ts
+ *   LoginTests     -> login.spec.ts
+ *   LoginTestCase  -> login.spec.ts
+ */
+function testFileName(className) {
+    return `${toKebabCase(className).replace(/-tests?(?:-?case)?$/, "")}.spec.ts`;
+}
+//# sourceMappingURL=naming.js.map

package/dist/naming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.js","sourceRoot":"","sources":["../src/naming.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;AAUH,kCAMC;AASD,oCAWC;AASD,kCAKC;AAaD,gDAMC;AASD,oCAEC;AA9ED;;;;;;;GAOG;AACH,SAAgB,WAAW,CAAC,CAAS;IACnC,IAAI,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC;IACjB,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CACrD,eAAe,EACf,CAAC,CAAC,EAAE,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAClC,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,YAAY,CAAC,CAAS;IACpC,IAAI,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC;IACjB,MAAM,KAAK,GAAG,CAAC;SACZ,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC;SACtC,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC;SACzB,IAAI,EAAE;SACN,KAAK,CAAC,KAAK,CAAC;SACZ,MAAM,CAAC,OAAO,CAAC,CAAC;IACnB,OAAO,KAAK;SACT,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;SAChE,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,WAAW,CAAC,CAAS;IACnC,OAAO,CAAC;SACL,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC;SACtC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,WAAW,EAAE,CAAC;AACnB,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,kBAAkB,CAAC,SAAiB;IAClD,MAAM,QAAQ,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC,OAAO,CAC7C,4CAA4C,EAC5C,EAAE,CACH,CAAC;IACF,OAAO,GAAG,QAAQ,UAAU,CAAC;AAC/B,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,YAAY,CAAC,SAAiB;IAC5C,OAAO,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,qBAAqB,EAAE,EAAE,CAAC,UAAU,CAAC;AAChF,CAAC"}

package/dist/pageObjectEmitter.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Render a `PageObjectIR` as a Playwright TypeScript Page Object class.
+ *
+ * Output shape (without `selfHealingShim`):
+ *
+ *   import { Page, Locator, expect } from "@playwright/test";
+ *
+ *   export class LoginPage {
+ *     readonly page: Page;
+ *     readonly usernameInput: Locator;
+ *     readonly passwordInput: Locator;
+ *
+ *     constructor(page: Page) {
+ *       this.page = page;
+ *       this.usernameInput = page.getByLabel("Username");
+ *       this.passwordInput = page.getByLabel("Password");
+ *     }
+ *
+ *     async login(user: string, pass: string): Promise<void> {
+ *       await this.usernameInput.fill(user);
+ *       ...
+ *     }
+ *   }
+ *
+ * With `selfHealingShim: true`, locator initialisation is wrapped so
+ * the converted Page Object integrates with `self-healing-stage-services`
+ * at runtime:
+ *
+ *     this.usernameInput = healOrThrow(page, {
+ *       preferred: page.getByLabel("Username"),
+ *       context: { page: "LoginPage", name: "usernameInput" },
+ *     });
+ *
+ * The `healOrThrow` helper is expected to be provided by
+ * `@platform/sdk-self-healing` in the consuming project.
+ */
+import type { EmitResult, PageObjectIR } from "./types";
+export interface EmitPageObjectOptions {
+    /** Wrap locator initialisers in `healOrThrow(...)`. Defaults to false. */
+    selfHealingShim?: boolean;
+}
+export declare function emitPageObject(ir: PageObjectIR, opts?: EmitPageObjectOptions): EmitResult;

package/dist/pageObjectEmitter.js

@@ -0,0 +1,109 @@
+"use strict";
+/**
+ * Render a `PageObjectIR` as a Playwright TypeScript Page Object class.
+ *
+ * Output shape (without `selfHealingShim`):
+ *
+ *   import { Page, Locator, expect } from "@playwright/test";
+ *
+ *   export class LoginPage {
+ *     readonly page: Page;
+ *     readonly usernameInput: Locator;
+ *     readonly passwordInput: Locator;
+ *
+ *     constructor(page: Page) {
+ *       this.page = page;
+ *       this.usernameInput = page.getByLabel("Username");
+ *       this.passwordInput = page.getByLabel("Password");
+ *     }
+ *
+ *     async login(user: string, pass: string): Promise<void> {
+ *       await this.usernameInput.fill(user);
+ *       ...
+ *     }
+ *   }
+ *
+ * With `selfHealingShim: true`, locator initialisation is wrapped so
+ * the converted Page Object integrates with `self-healing-stage-services`
+ * at runtime:
+ *
+ *     this.usernameInput = healOrThrow(page, {
+ *       preferred: page.getByLabel("Username"),
+ *       context: { page: "LoginPage", name: "usernameInput" },
+ *     });
+ *
+ * The `healOrThrow` helper is expected to be provided by
+ * `@platform/sdk-self-healing` in the consuming project.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.emitPageObject = emitPageObject;
+const locatorRender_1 = require("./locatorRender");
+const indent_1 = require("./indent");
+function emitPageObject(ir, opts = {}) {
+    const warnings = [];
+    const lines = [];
+    // Imports
+    lines.push(`import { Page, Locator, expect } from "@playwright/test";`);
+    if (opts.selfHealingShim) {
+        lines.push(`import { healOrThrow } from "@platform/sdk-self-healing";`);
+    }
+    if (ir.extraImports && ir.extraImports.length) {
+        for (const imp of ir.extraImports)
+            lines.push(imp);
+    }
+    lines.push("");
+    // Class header + field declarations
+    lines.push(`export class ${ir.className} {`);
+    lines.push(`  readonly page: Page;`);
+    for (const f of ir.fields) {
+        lines.push((0, locatorRender_1.renderFieldDeclaration)(f));
+    }
+    lines.push("");
+    // Constructor
+    lines.push(`  constructor(page: Page) {`);
+    lines.push(`    this.page = page;`);
+    for (const f of ir.fields) {
+        if (opts.selfHealingShim) {
+            const preferred = (0, locatorRender_1.renderLocatorExpr)(f, "page");
+            lines.push(`    this.${f.fieldName} = healOrThrow(page, {`);
+            lines.push(`      preferred: ${preferred},`);
+            lines.push(`      context: { page: ${JSON.stringify(ir.className)}, name: ${JSON.stringify(f.fieldName)} },`);
+            lines.push(`    });`);
+        }
+        else {
+            lines.push((0, locatorRender_1.renderFieldAssignment)(f, "page"));
+        }
+    }
+    lines.push(`  }`);
+    // Methods
+    for (const m of ir.methods) {
+        lines.push("");
+        if (m.jsdoc) {
+            for (const docLine of m.jsdoc.split("\n")) {
+                lines.push("  " + docLine);
+            }
+        }
+        const tsParams = m.params.map((p) => `${p.name}: ${p.type}`).join(", ");
+        const ret = m.returnType ?? "Promise<void>";
+        lines.push(`  async ${m.name}(${tsParams}): ${ret} {`);
+        if (m.body && m.body.trim()) {
+            lines.push((0, indent_1.dedentAndIndent)(m.body, "    "));
+        }
+        lines.push(`  }`);
+    }
+    lines.push(`}`);
+    lines.push("");
+    // Lightweight self-checks
+    const seen = new Set();
+    for (const f of ir.fields) {
+        if (seen.has(f.fieldName)) {
+            warnings.push({
+                severity: "warn",
+                message: `Duplicate field name '${f.fieldName}' in ${ir.className}`,
+            });
+        }
+        seen.add(f.fieldName);
+    }
+    return { contents: lines.join("\n"), warnings };
+}
+//# sourceMappingURL=pageObjectEmitter.js.map

package/dist/pageObjectEmitter.js.map

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

package/dist/projectEmitter.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Scaffold a Playwright TypeScript project skeleton into `outDir`.
+ *
+ * Copies the four bundled templates (`package.json`, `playwright.config.ts`,
+ * `tsconfig.json`, `gitignore`), substituting the simple placeholders:
+ *
+ *   {{projectName}}  → opts.projectName ?? "my-playwright-tests"
+ *   {{baseUrl}}      → opts.baseUrl ?? "http://localhost:3000"
+ *
+ * Behaviour:
+ *   - Files that already exist in `outDir` are NOT overwritten — instead
+ *     they're surfaced as warnings. This matches sel2pw's behaviour.
+ *   - The function is idempotent: a second call against an existing repo
+ *     produces zero writes and returns warnings only.
+ *
+ * Lifted with light edits from sel2pw v1.0.0 `src/emitters/projectEmitter.ts`.
+ */
+import type { ReviewItem } from "./types";
+export interface EmitProjectOptions {
+    outDir: string;
+    /** Override the built-in templates directory. */
+    templatesDir?: string;
+    /** Injected as the `baseURL` in `playwright.config.ts`. */
+    baseUrl?: string;
+    /** Injected as the `name` in `package.json`. */
+    projectName?: string;
+}
+export interface EmitProjectResult {
+    filesWritten: string[];
+    warnings: ReviewItem[];
+}
+export declare function emitProject(opts: EmitProjectOptions): Promise<EmitProjectResult>;

package/dist/projectEmitter.js

@@ -0,0 +1,101 @@
+"use strict";
+/**
+ * Scaffold a Playwright TypeScript project skeleton into `outDir`.
+ *
+ * Copies the four bundled templates (`package.json`, `playwright.config.ts`,
+ * `tsconfig.json`, `gitignore`), substituting the simple placeholders:
+ *
+ *   {{projectName}}  → opts.projectName ?? "my-playwright-tests"
+ *   {{baseUrl}}      → opts.baseUrl ?? "http://localhost:3000"
+ *
+ * Behaviour:
+ *   - Files that already exist in `outDir` are NOT overwritten — instead
+ *     they're surfaced as warnings. This matches sel2pw's behaviour.
+ *   - The function is idempotent: a second call against an existing repo
+ *     produces zero writes and returns warnings only.
+ *
+ * Lifted with light edits from sel2pw v1.0.0 `src/emitters/projectEmitter.ts`.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.emitProject = emitProject;
+const fs = __importStar(require("fs-extra"));
+const path = __importStar(require("path"));
+const DEFAULT_TEMPLATES = path.resolve(__dirname, "..", "templates");
+const TEMPLATE_MAPPING = [
+    { src: "package.json.tmpl", dest: "package.json" },
+    { src: "playwright.config.ts.tmpl", dest: "playwright.config.ts" },
+    { src: "tsconfig.json.tmpl", dest: "tsconfig.json" },
+    { src: "gitignore.tmpl", dest: ".gitignore" },
+];
+async function emitProject(opts) {
+    const filesWritten = [];
+    const warnings = [];
+    const templatesDir = opts.templatesDir ?? DEFAULT_TEMPLATES;
+    const projectName = opts.projectName ?? "my-playwright-tests";
+    const baseUrl = opts.baseUrl ?? "http://localhost:3000";
+    await fs.ensureDir(opts.outDir);
+    for (const { src, dest } of TEMPLATE_MAPPING) {
+        const srcPath = path.join(templatesDir, src);
+        const destPath = path.join(opts.outDir, dest);
+        if (!(await fs.pathExists(srcPath))) {
+            warnings.push({
+                severity: "warn",
+                message: `Template not found: ${srcPath} — skipping ${dest}`,
+            });
+            continue;
+        }
+        if (await fs.pathExists(destPath)) {
+            warnings.push({
+                severity: "info",
+                file: destPath,
+                message: `${dest} already exists — left untouched.`,
+            });
+            continue;
+        }
+        let content = await fs.readFile(srcPath, "utf8");
+        content = content
+            .replace(/\{\{projectName\}\}/g, projectName)
+            .replace(/\{\{baseUrl\}\}/g, baseUrl);
+        await fs.writeFile(destPath, content, "utf8");
+        filesWritten.push(destPath);
+    }
+    // Common scaffolded directories
+    for (const dir of ["pages", "tests"]) {
+        await fs.ensureDir(path.join(opts.outDir, dir));
+    }
+    return { filesWritten, warnings };
+}
+//# sourceMappingURL=projectEmitter.js.map

package/dist/projectEmitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectEmitter.js","sourceRoot":"","sources":["../src/projectEmitter.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;GAgBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BH,kCA6CC;AAzED,6CAA+B;AAC/B,2CAA6B;AAkB7B,MAAM,iBAAiB,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;AAErE,MAAM,gBAAgB,GAAiD;IACrE,EAAE,GAAG,EAAE,mBAAmB,EAAE,IAAI,EAAE,cAAc,EAAE;IAClD,EAAE,GAAG,EAAE,2BAA2B,EAAE,IAAI,EAAE,sBAAsB,EAAE;IAClE,EAAE,GAAG,EAAE,oBAAoB,EAAE,IAAI,EAAE,eAAe,EAAE;IACpD,EAAE,GAAG,EAAE,gBAAgB,EAAE,IAAI,EAAE,YAAY,EAAE;CAC9C,CAAC;AAEK,KAAK,UAAU,WAAW,CAAC,IAAwB;IACxD,MAAM,YAAY,GAAa,EAAE,CAAC;IAClC,MAAM,QAAQ,GAAiB,EAAE,CAAC;IAElC,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,IAAI,iBAAiB,CAAC;IAC5D,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,qBAAqB,CAAC;IAC9D,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,uBAAuB,CAAC;IAExD,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEhC,KAAK,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,gBAAgB,EAAE,CAAC;QAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;QAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAE9C,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;YACpC,QAAQ,CAAC,IAAI,CAAC;gBACZ,QAAQ,EAAE,MAAM;gBAChB,OAAO,EAAE,uBAAuB,OAAO,eAAe,IAAI,EAAE;aAC7D,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAClC,QAAQ,CAAC,IAAI,CAAC;gBACZ,QAAQ,EAAE,MAAM;gBAChB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,GAAG,IAAI,mCAAmC;aACpD,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,IAAI,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACjD,OAAO,GAAG,OAAO;aACd,OAAO,CAAC,sBAAsB,EAAE,WAAW,CAAC;aAC5C,OAAO,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;QACxC,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAC9C,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC;IAED,gCAAgC;IAChC,KAAK,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC;QACrC,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;IAClD,CAAC;IAED,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC;AACpC,CAAC"}

package/dist/testEmitter.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Render a `TestSpecIR` as a Playwright TypeScript spec file.
+ *
+ * Output shape:
+ *
+ *   import { test, expect } from "@playwright/test";
+ *   import { LoginPage } from "../pages/login.page";
+ *
+ *   test.describe("User Login", () => {
+ *     test.beforeEach(async ({ page }) => {
+ *       const loginPage = new LoginPage(page);
+ *       await loginPage.goto();
+ *     });
+ *
+ *     test("Successful login", async ({ page }) => {
+ *       const loginPage = new LoginPage(page);
+ *       await loginPage.login("alice@example.com", "secret");
+ *       await expect(loginPage.dashboardHeading).toBeVisible();
+ *     });
+ *   });
+ *
+ * As with `emitPageObject`, method bodies arrive pre-rendered.
+ */
+import type { EmitResult, TestSpecIR } from "./types";
+export declare function emitTestSpec(ir: TestSpecIR): EmitResult;

package/dist/testEmitter.js

@@ -0,0 +1,97 @@
+"use strict";
+/**
+ * Render a `TestSpecIR` as a Playwright TypeScript spec file.
+ *
+ * Output shape:
+ *
+ *   import { test, expect } from "@playwright/test";
+ *   import { LoginPage } from "../pages/login.page";
+ *
+ *   test.describe("User Login", () => {
+ *     test.beforeEach(async ({ page }) => {
+ *       const loginPage = new LoginPage(page);
+ *       await loginPage.goto();
+ *     });
+ *
+ *     test("Successful login", async ({ page }) => {
+ *       const loginPage = new LoginPage(page);
+ *       await loginPage.login("alice@example.com", "secret");
+ *       await expect(loginPage.dashboardHeading).toBeVisible();
+ *     });
+ *   });
+ *
+ * As with `emitPageObject`, method bodies arrive pre-rendered.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.emitTestSpec = emitTestSpec;
+const indent_1 = require("./indent");
+function emitTestSpec(ir) {
+    const warnings = [];
+    const lines = [];
+    // Imports
+    lines.push(`import { test, expect } from "@playwright/test";`);
+    if (ir.pomImports && ir.pomImports.length) {
+        for (const imp of ir.pomImports) {
+            lines.push(`import { ${imp.className} } from "${imp.fromPath}";`);
+        }
+    }
+    if (ir.extraImports && ir.extraImports.length) {
+        for (const imp of ir.extraImports)
+            lines.push(imp);
+    }
+    lines.push("");
+    lines.push(`test.describe(${JSON.stringify(ir.describeName)}, () => {`);
+    // Hooks
+    emitHooks(lines, "test.beforeAll", ir.beforeAll);
+    emitHooks(lines, "test.beforeEach", ir.beforeEach);
+    // Tests
+    for (const t of ir.tests) {
+        lines.push("");
+        if (t.tags && t.tags.length) {
+            for (const tag of t.tags)
+                lines.push(`  // @${tag}`);
+        }
+        if (t.jsdoc) {
+            for (const docLine of t.jsdoc.split("\n")) {
+                lines.push("  " + docLine);
+            }
+        }
+        const fixtures = (t.fixtures && t.fixtures.length ? t.fixtures : ["page"]).join(", ");
+        if (t.fixme) {
+            lines.push(`  test.fixme(${JSON.stringify(t.name)}, async ({ ${fixtures} }) => {`);
+            lines.push(`    // FIXME: ${t.fixme}`);
+        }
+        else {
+            lines.push(`  test(${JSON.stringify(t.name)}, async ({ ${fixtures} }) => {`);
+        }
+        if (t.body && t.body.trim()) {
+            lines.push((0, indent_1.dedentAndIndent)(t.body, "    "));
+        }
+        lines.push(`  });`);
+    }
+    emitHooks(lines, "test.afterEach", ir.afterEach);
+    emitHooks(lines, "test.afterAll", ir.afterAll);
+    lines.push(`});`);
+    lines.push("");
+    if (ir.tests.length === 0) {
+        warnings.push({
+            severity: "warn",
+            message: `Test spec '${ir.describeName}' contains no tests — emitted as an empty describe block.`,
+        });
+    }
+    return { contents: lines.join("\n"), warnings };
+}
+function emitHooks(lines, name, hooks) {
+    if (!hooks || hooks.length === 0)
+        return;
+    for (const hook of hooks) {
+        lines.push("");
+        const fixtures = (hook.fixtures && hook.fixtures.length ? hook.fixtures : ["page"]).join(", ");
+        lines.push(`  ${name}(async ({ ${fixtures} }) => {`);
+        if (hook.body && hook.body.trim()) {
+            lines.push((0, indent_1.dedentAndIndent)(hook.body, "    "));
+        }
+        lines.push(`  });`);
+    }
+}
+//# sourceMappingURL=testEmitter.js.map

package/dist/testEmitter.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Public IR types for `@vijaypjavvadi/pw-emit`.
+ *
+ * These are the shapes that emitters consume. They are intentionally **input
+ * source agnostic** — neither Java/Selenium nor Gherkin idioms leak in.
+ * Consumers (sel2pw, bdd2pw) build these IRs from their own sources.
+ *
+ * Design rule: method bodies and test bodies arrive **pre-rendered** as TS
+ * source strings. This package does NOT rewrite bodies — it places them
+ * inside a class wrapper, indents them, and worries about imports.
+ */
+/**
+ * A locator choice that has already been decided by the caller.
+ * `pw-emit` does not pick locators — it renders the choice.
+ */
+export interface LocatorChoice {
+    /** The Playwright locator API to call. */
+    api: "getByRole" | "getByLabel" | "getByPlaceholder" | "getByTestId" | "getByText" | "locator";
+    /**
+     * The argument expression as it should appear inside the parens, e.g.
+     *   `'button', { name: 'Sign in' }`
+     *   `'#login'`
+     *   `'xpath=//div[@id="x"]'`
+     */
+    args: string;
+    /** camelCase TS field name (e.g. `submitButton`). */
+    fieldName: string;
+}
+export interface PomMethodIR {
+    name: string;
+    params: {
+        name: string;
+        type: string;
+    }[];
+    /**
+     * Pre-rendered TS body. Should already contain `await`s, already use
+     * `this.<field>`, and already be valid TS. `pw-emit` only handles indentation.
+     */
+    body: string;
+    jsdoc?: string;
+    /** Defaults to `Promise<void>`. */
+    returnType?: string;
+}
+export interface PageObjectIR {
+    className: string;
+    fields: LocatorChoice[];
+    methods: PomMethodIR[];
+    /** Optional extra import lines (e.g. shared types). The default
+     *  `import { Page, Locator, expect } from '@playwright/test'` is always emitted. */
+    extraImports?: string[];
+}
+export interface TestCaseIR {
+    name: string;
+    /** Pre-rendered TS body. */
+    body: string;
+    jsdoc?: string;
+    /** Fixtures destructured in the test signature. Defaults to `['page']`. */
+    fixtures?: string[];
+    /** Tags emitted as `// @tag` comments above the test. */
+    tags?: string[];
+    /** When set, emit `test.fixme(...)` instead of `test(...)` with this reason. */
+    fixme?: string;
+}
+export interface HookIR {
+    /** Pre-rendered TS body. */
+    body: string;
+    /** Fixtures destructured in the hook signature. Defaults to `['page']`. */
+    fixtures?: string[];
+}
+export interface TestSpecIR {
+    /** Used as the `test.describe(...)` title. */
+    describeName: string;
+    /** Page Object imports to add at top of file. */
+    pomImports?: {
+        className: string;
+        fromPath: string;
+    }[];
+    beforeAll?: HookIR[];
+    beforeEach?: HookIR[];
+    afterEach?: HookIR[];
+    afterAll?: HookIR[];
+    tests: TestCaseIR[];
+    /** Optional extra import lines. */
+    extraImports?: string[];
+}
+export interface ReviewItem {
+    severity: "info" | "warn" | "error";
+    file?: string;
+    line?: number;
+    message: string;
+    suggestion?: string;
+}
+export interface EmitResult {
+    /** Final TS source. Always ends with a single trailing newline. */
+    contents: string;
+    warnings: ReviewItem[];
+}

package/dist/types.js

@@ -0,0 +1,14 @@
+"use strict";
+/**
+ * Public IR types for `@vijaypjavvadi/pw-emit`.
+ *
+ * These are the shapes that emitters consume. They are intentionally **input
+ * source agnostic** — neither Java/Selenium nor Gherkin idioms leak in.
+ * Consumers (sel2pw, bdd2pw) build these IRs from their own sources.
+ *
+ * Design rule: method bodies and test bodies arrive **pre-rendered** as TS
+ * source strings. This package does NOT rewrite bodies — it places them
+ * inside a class wrapper, indents them, and worries about imports.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@vijaypjavvadi/pw-emit",
+  "version": "1.0.0",
+  "description": "Shared emitter library that renders Playwright TypeScript Page Objects, spec files, and project scaffolds from a generic IR. Powers both @vijaypjavvadi/sel2pw and @vijaypjavvadi/bdd2pw.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "templates",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/javvadivijayprasad/pw-emit.git"
+  },
+  "homepage": "https://github.com/javvadivijayprasad/pw-emit#readme",
+  "bugs": {
+    "url": "https://github.com/javvadivijayprasad/pw-emit/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:cov": "vitest run --coverage",
+    "test:update": "vitest run -u",
+    "verify": "tsc && node scripts/verify.js",
+    "prepublishOnly": "npm run build && npm test",
+    "lint": "eslint . --ext .ts && tsc --noEmit",
+    "format": "prettier --write \"src/**/*.ts\" \"tests/**/*.ts\""
+  },
+  "keywords": [
+    "playwright",
+    "page-object",
+    "code-generation",
+    "emitter",
+    "typescript",
+    "test-automation"
+  ],
+  "author": {
+    "name": "Vijay Prasad",
+    "email": "jvijayprasad@gmail.com",
+    "url": "https://github.com/javvadivijayprasad"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "fs-extra": "^11.2.0"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^20.12.0",
+    "@typescript-eslint/eslint-plugin": "^8.18.0",
+    "@typescript-eslint/parser": "^8.18.0",
+    "@vitest/coverage-v8": "^1.6.0",
+    "eslint": "^8.57.0",
+    "prettier": "^3.2.5",
+    "typescript": "^5.4.5",
+    "vitest": "^1.6.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}

package/templates/gitignore.tmpl

@@ -0,0 +1,10 @@
+node_modules/
+test-results/
+playwright-report/
+playwright/.cache/
+.env
+.env.local
+*.log
+.DS_Store
+.idea/
+.vscode/

package/templates/package.json.tmpl

@@ -0,0 +1,16 @@
+{
+  "name": "{{projectName}}",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "test": "playwright test",
+    "test:headed": "playwright test --headed",
+    "test:debug": "playwright test --debug",
+    "report": "playwright show-report"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.45.0",
+    "@types/node": "^20.0.0",
+    "typescript": "^5.4.5"
+  }
+}

package/templates/playwright.config.ts.tmpl

@@ -0,0 +1,24 @@
+import { defineConfig, devices } from "@playwright/test";
+
+/**
+ * Generated by @vijaypjavvadi/pw-emit.
+ * https://playwright.dev/docs/test-configuration
+ */
+export default defineConfig({
+  testDir: "./tests",
+  fullyParallel: true,
+  forbidOnly: !!process.env.CI,
+  retries: process.env.CI ? 2 : 0,
+  workers: process.env.CI ? 1 : undefined,
+  reporter: [["html", { open: "never" }], ["list"]],
+  use: {
+    baseURL: process.env.BASE_URL ?? "{{baseUrl}}",
+    trace: "on-first-retry",
+    screenshot: "only-on-failure",
+  },
+  projects: [
+    { name: "chromium", use: { ...devices["Desktop Chrome"] } },
+    { name: "firefox", use: { ...devices["Desktop Firefox"] } },
+    { name: "webkit", use: { ...devices["Desktop Safari"] } },
+  ],
+});

package/templates/tsconfig.json.tmpl

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "commonjs",
+    "lib": ["ES2022", "DOM"],
+    "strict": true,
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "skipLibCheck": true,
+    "resolveJsonModule": true,
+    "moduleResolution": "node"
+  },
+  "include": ["pages/**/*.ts", "tests/**/*.ts", "fixtures/**/*.ts"],
+  "exclude": ["node_modules"]
+}