@cementic/cementic-test 0.2.3 → 0.2.5

package/dist/templates/student-framework/pages/DashboardPage.js

@@ -0,0 +1,16 @@
+import { BasePage } from './BasePage.js';
+
+export class DashboardPage extends BasePage {
+  /**
+   * @param {import('@playwright/test').Page} page
+   */
+  constructor(page) {
+    super(page);
+    this.heading = page.getByRole('heading', { name: /dashboard/i });
+    this.navigation = page.getByRole('navigation');
+  }
+
+  async goto() {
+    await super.goto('/dashboard');
+  }
+}

package/dist/templates/student-framework/pages/FormPage.js

@@ -0,0 +1,24 @@
+import { BasePage } from './BasePage.js';
+
+export class FormPage extends BasePage {
+  /**
+   * @param {import('@playwright/test').Page} page
+   */
+  constructor(page) {
+    super(page);
+    this.nameInput = page.getByLabel('name');
+    this.emailInput = page.getByLabel('email');
+    this.submitButton = page.getByRole('button', { name: /submit|save/i });
+    this.statusMessage = page.getByRole('status');
+  }
+
+  async goto() {
+    await super.goto('/form');
+  }
+
+  async submit(values) {
+    if (values.name) await this.nameInput.fill(values.name);
+    if (values.email) await this.emailInput.fill(values.email);
+    await this.submitButton.click();
+  }
+}

package/dist/templates/student-framework/pages/LoginPage.js

@@ -0,0 +1,24 @@
+import { BasePage } from './BasePage.js';
+
+export class LoginPage extends BasePage {
+  /**
+   * @param {import('@playwright/test').Page} page
+   */
+  constructor(page) {
+    super(page);
+    this.emailInput = page.getByLabel('email');
+    this.passwordInput = page.getByLabel('password');
+    this.signInButton = page.getByRole('button', { name: /sign in|log in/i });
+    this.errorAlert = page.getByRole('alert');
+  }
+
+  async goto() {
+    await super.goto('/login');
+  }
+
+  async login(email, password) {
+    await this.emailInput.fill(email);
+    await this.passwordInput.fill(password);
+    await this.signInButton.click();
+  }
+}

package/dist/templates/student-framework/tests/dashboard.spec.js

@@ -0,0 +1,14 @@
+import { expect, test } from '@playwright/test';
+import { DashboardPage } from '../pages/DashboardPage.js';
+
+test.describe('Dashboard shell', () => {
+  test('renders the main heading and navigation', async ({ page }) => {
+    const dashboardPage = new DashboardPage(page);
+
+    await dashboardPage.goto();
+    await dashboardPage.waitForLoad();
+
+    await expect(dashboardPage.heading).toBeVisible();
+    await expect(dashboardPage.navigation).toBeVisible();
+  });
+});

package/dist/templates/student-framework/tests/login.spec.js

@@ -0,0 +1,14 @@
+import { expect, test } from '@playwright/test';
+import { LoginPage } from '../pages/LoginPage.js';
+
+test.describe('Login flow', () => {
+  test('shows an error for invalid credentials', async ({ page }) => {
+    const loginPage = new LoginPage(page);
+
+    await loginPage.goto();
+    await loginPage.login('bad@example.com', 'wrong-password');
+
+    await expect(loginPage.errorAlert).toBeVisible();
+    await expect(page).toHaveURL(/login/);
+  });
+});

package/dist/templates/student-framework-ts/README.md

@@ -0,0 +1,20 @@
+# CementicTest TypeScript Template
+
+This scaffold provides a minimal Playwright + Page Object Model project in TypeScript.
+
+## Commands
+
+```bash
+npm test
+npx playwright test --headed
+npx playwright show-report
+```
+
+## Structure
+
+```text
+pages/
+tests/
+playwright.config.ts
+tsconfig.json
+```

package/dist/templates/student-framework-ts/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "cementic-test-template-ts",
+  "version": "1.0.0",
+  "description": "Scaffolded TypeScript project from CementicTest",
+  "type": "module",
+  "scripts": {
+    "test": "npx playwright test",
+    "test:debug": "npx playwright test --debug",
+    "test:headed": "npx playwright test --headed",
+    "report": "npx playwright show-report"
+  },
+  "keywords": [
+    "playwright",
+    "automation",
+    "testing",
+    "typescript"
+  ],
+  "license": "Apache-2.0",
+  "devDependencies": {
+    "@playwright/test": "^1.57.0",
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.3"
+  }
+}

package/dist/templates/student-framework-ts/pages/LandingPage.ts

@@ -0,0 +1,15 @@
+import type { Locator, Page } from '@playwright/test';
+
+export class LandingPage {
+  readonly page: Page;
+  readonly newArrivalsText: Locator;
+
+  constructor(page: Page) {
+    this.page = page;
+    this.newArrivalsText = page.getByText('New Arrivals Just In!');
+  }
+
+  async goto(): Promise<void> {
+    await this.page.goto('/');
+  }
+}

package/dist/templates/student-framework-ts/playwright.config.ts

@@ -0,0 +1,29 @@
+import { defineConfig, devices } from '@playwright/test';
+
+const isCI = !!process.env.GITHUB_ACTIONS;
+
+export default defineConfig({
+  testDir: './tests',
+  timeout: 30_000,
+  expect: { timeout: 5_000 },
+  retries: isCI ? 2 : 0,
+  fullyParallel: true,
+  workers: isCI ? 2 : '100%',
+  outputDir: 'test-results',
+  reporter: [['html', { open: 'never' }]],
+  use: {
+    viewport: { width: 1440, height: 900 },
+    actionTimeout: 10_000,
+    navigationTimeout: 20_000,
+    trace: isCI ? 'retain-on-failure' : 'on-first-retry',
+    screenshot: 'only-on-failure',
+    video: 'retain-on-failure',
+    baseURL: 'https://mini-shop.testamplify.com/',
+  },
+  projects: [
+    {
+      name: 'chromium',
+      use: { ...devices['Desktop Chrome'] },
+    },
+  ],
+});

package/dist/templates/{student-framework/tests/landing.spec.js → student-framework-ts/tests/landing.spec.ts}

@@ -1,4 +1,4 @@
-import { test, expect } from '@playwright/test';
+import { expect, test } from '@playwright/test';
 import { LandingPage } from '../pages/LandingPage';
 
 test.describe('Mini Shop Landing Page', () => {

package/dist/templates/student-framework-ts/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "types": [
+      "node",
+      "@playwright/test"
+    ]
+  },
+  "include": [
+    "pages/**/*.ts",
+    "tests/**/*.ts",
+    "playwright.config.ts"
+  ]
+}

package/dist/templates/student-framework-ts/workflows/playwright.yml

@@ -0,0 +1,20 @@
+name: Playwright Tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+      - run: npm ci
+      - run: npx playwright install --with-deps
+      - run: npx playwright test

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@cementic/cementic-test",
-  "version": "0.2.3",
-  "description": "CementicTest CLI (ct): normalize cases → generate Playwright tests",
+  "version": "0.2.5",
+  "description": "CementicTest CLI (ct): capture pages, normalize cases, generate Playwright tests",
   "type": "module",
   "license": "Apache-2.0",
   "bin": {
@@ -16,6 +16,7 @@
   "scripts": {
     "build": "tsup && node scripts/copy-templates.cjs",
     "dev": "tsup --watch",
+    "test": "npm run build && node --test test/*.test.mjs",
     "lint": "echo \"(add linter later)\"",
     "prepublishOnly": "npm run build"
   },

package/dist/chunk-J63TUHIV.js

@@ -1,80 +0,0 @@
-#!/usr/bin/env node
-
-// src/commands/gen.ts
-import { Command } from "commander";
-import fg from "fast-glob";
-import { readFileSync, mkdirSync, writeFileSync } from "fs";
-import { join, basename, relative, resolve } from "path";
-function buildTestTitle(norm) {
-  const idPart = norm.id ? norm.id : "";
-  const cleanTitle = norm.title || "Untitled";
-  const tagSuffix = (norm.tags ?? []).map((t) => `@${t}`).join(" ");
-  return [idPart, cleanTitle, tagSuffix].filter(Boolean).join(" ").trim();
-}
-function buildTestBody(norm, relPomImport) {
-  const title = buildTestTitle(norm);
-  const stepsComment = (norm.steps ?? []).map((s) => `- ${s}`).join("\n  // ");
-  const expectations = (norm.expected ?? []).map(
-    (e) => `  // expect: ${e}
-  // TODO: map this to a real assertion using LoginPage`
-  ).join("\n\n");
-  let importPath = relPomImport.replace(/\\/g, "/");
-  if (!importPath.startsWith(".")) {
-    importPath = `./${importPath}`;
-  }
-  return `import { test, expect } from '@playwright/test';
-import { LandingPage } from '${importPath}';
-
-test('${title}', async ({ page }) => {
-  const pageObj = new LandingPage(page);
-
-  // Steps inferred from case:
-  // ${stepsComment || "TODO: no steps detected"}
-
-  // Example flow (replace with real mapping later):
-  await pageObj.goto();
-  // await pageObj.login('user@example.com', 'password');
-
-${expectations || "  // TODO: add assertions with LandingPage"}
-});
-`;
-}
-async function gen(opts) {
-  if (opts.lang !== "ts" && opts.lang !== "js") {
-    console.error("MVP supports --lang ts and --lang js only for now.");
-    process.exit(1);
-  }
-  const normalized = await fg([".cementic/normalized/*.json", "!.cementic/normalized/_index.json"]);
-  mkdirSync(opts.out, { recursive: true });
-  const projectRoot = process.cwd();
-  const pagesDir = join(projectRoot, "pages");
-  const outDir = resolve(projectRoot, opts.out);
-  const relPathToPages = relative(outDir, pagesDir);
-  const relPomImport = join(relPathToPages, "LandingPage");
-  for (const f of normalized) {
-    const norm = JSON.parse(readFileSync(f, "utf8"));
-    const stem = basename(f).replace(/\.json$/, "");
-    const fileStem = stem.replace(/[^\w-]+/g, "-");
-    const body = buildTestBody(norm, relPomImport);
-    const ext = opts.lang === "js" ? "spec.js" : "spec.ts";
-    const outFile = join(opts.out, `${fileStem}.${ext}`);
-    writeFileSync(outFile, body);
-  }
-  console.log(`\u2705 Generated ${normalized.length} POM-style test file(s) \u2192 ${opts.out}`);
-}
-function genCmd() {
-  const cmd = new Command("gen").description("Generate Playwright test files from normalized JSON cases").addHelpText("after", `
-Examples:
-  $ ct gen --lang ts
-  $ ct gen --lang js --out tests/e2e
-`).option("--lang <lang>", "Target language for test files (ts|js)", "ts").option("--out <dir>", "Output directory for generated tests", "tests/generated").action(async (opts) => {
-    await gen({ lang: opts.lang, out: opts.out });
-  });
-  return cmd;
-}
-
-export {
-  gen,
-  genCmd
-};
-//# sourceMappingURL=chunk-J63TUHIV.js.map

package/dist/chunk-J63TUHIV.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/commands/gen.ts"],"sourcesContent":["import { Command } from 'commander';\nimport fg from 'fast-glob';\nimport { readFileSync, mkdirSync, writeFileSync } from 'node:fs';\nimport { join, basename, relative, resolve } from 'node:path';\n\ntype NormalizedCase = {\n  id?: string;\n  title: string;\n  tags?: string[];\n  steps?: string[];\n  expected?: string[];\n  needs_review?: boolean;\n  source?: string;\n};\n\nfunction buildTestTitle(norm: NormalizedCase): string {\n  const idPart = norm.id ? norm.id : '';\n  const cleanTitle = norm.title || 'Untitled';\n  const tagSuffix = (norm.tags ?? []).map(t => `@${t}`).join(' ');\n  return [idPart, cleanTitle, tagSuffix].filter(Boolean).join(' ').trim();\n}\n\nfunction buildTestBody(norm: NormalizedCase, relPomImport: string): string {\n  const title = buildTestTitle(norm);\n  const stepsComment = (norm.steps ?? []).map(s => `- ${s}`).join('\\n  // ');\n  const expectations = (norm.expected ?? []).map(\n    e => `  // expect: ${e}\\n  // TODO: map this to a real assertion using LoginPage`\n  ).join('\\n\\n');\n\n  // Ensure import path starts with ./ or ../\n  let importPath = relPomImport.replace(/\\\\/g, '/');\n  if (!importPath.startsWith('.')) {\n    importPath = `./${importPath}`;\n  }\n\n  return `import { test, expect } from '@playwright/test';\nimport { LandingPage } from '${importPath}';\n\ntest('${title}', async ({ page }) => {\n  const pageObj = new LandingPage(page);\n\n  // Steps inferred from case:\n  // ${stepsComment || 'TODO: no steps detected'}\n\n  // Example flow (replace with real mapping later):\n  await pageObj.goto();\n  // await pageObj.login('user@example.com', 'password');\n\n${expectations || '  // TODO: add assertions with LandingPage'}\n});\n`;\n}\n\nexport async function gen(opts: { lang: string; out: string }) {\n  if (opts.lang !== 'ts' && opts.lang !== 'js') {\n    console.error('MVP supports --lang ts and --lang js only for now.');\n    process.exit(1);\n  }\n\n  const normalized = await fg(['.cementic/normalized/*.json', '!.cementic/normalized/_index.json']);\n  mkdirSync(opts.out, { recursive: true });\n\n  // Calculate relative path from output dir to 'pages/LandingPage'\n  // Assumption: project root has 'pages/'\n  const projectRoot = process.cwd();\n  const pagesDir = join(projectRoot, 'pages');\n  const outDir = resolve(projectRoot, opts.out);\n  \n  // path.relative(from, to)\n  const relPathToPages = relative(outDir, pagesDir);\n  const relPomImport = join(relPathToPages, 'LandingPage');\n\n  for (const f of normalized) {\n    const norm = JSON.parse(readFileSync(f, 'utf8')) as NormalizedCase;\n    const stem = basename(f).replace(/\\.json$/, '');\n    const fileStem = stem.replace(/[^\\w-]+/g, '-');\n\n    const body = buildTestBody(norm, relPomImport);\n    const ext = opts.lang === 'js' ? 'spec.js' : 'spec.ts';\n    const outFile = join(opts.out, `${fileStem}.${ext}`);\n    writeFileSync(outFile, body);\n  }\n\n  console.log(`✅ Generated ${normalized.length} POM-style test file(s) → ${opts.out}`);\n}\n\nexport function genCmd() {\n  const cmd = new Command('gen')\n    .description('Generate Playwright test files from normalized JSON cases')\n    .addHelpText('after', `\nExamples:\n  $ ct gen --lang ts\n  $ ct gen --lang js --out tests/e2e\n`)\n    .option('--lang <lang>', 'Target language for test files (ts|js)', 'ts')\n    .option('--out <dir>', 'Output directory for generated tests', 'tests/generated')\n    .action(async (opts) => {\n      await gen({ lang: opts.lang, out: opts.out });\n    });\n  return cmd;\n}"],"mappings":";;;AAAA,SAAS,eAAe;AACxB,OAAO,QAAQ;AACf,SAAS,cAAc,WAAW,qBAAqB;AACvD,SAAS,MAAM,UAAU,UAAU,eAAe;AAYlD,SAAS,eAAe,MAA8B;AACpD,QAAM,SAAS,KAAK,KAAK,KAAK,KAAK;AACnC,QAAM,aAAa,KAAK,SAAS;AACjC,QAAM,aAAa,KAAK,QAAQ,CAAC,GAAG,IAAI,OAAK,IAAI,CAAC,EAAE,EAAE,KAAK,GAAG;AAC9D,SAAO,CAAC,QAAQ,YAAY,SAAS,EAAE,OAAO,OAAO,EAAE,KAAK,GAAG,EAAE,KAAK;AACxE;AAEA,SAAS,cAAc,MAAsB,cAA8B;AACzE,QAAM,QAAQ,eAAe,IAAI;AACjC,QAAM,gBAAgB,KAAK,SAAS,CAAC,GAAG,IAAI,OAAK,KAAK,CAAC,EAAE,EAAE,KAAK,SAAS;AACzE,QAAM,gBAAgB,KAAK,YAAY,CAAC,GAAG;AAAA,IACzC,OAAK,gBAAgB,CAAC;AAAA;AAAA,EACxB,EAAE,KAAK,MAAM;AAGb,MAAI,aAAa,aAAa,QAAQ,OAAO,GAAG;AAChD,MAAI,CAAC,WAAW,WAAW,GAAG,GAAG;AAC/B,iBAAa,KAAK,UAAU;AAAA,EAC9B;AAEA,SAAO;AAAA,+BACsB,UAAU;AAAA;AAAA,QAEjC,KAAK;AAAA;AAAA;AAAA;AAAA,OAIN,gBAAgB,yBAAyB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAM9C,gBAAgB,4CAA4C;AAAA;AAAA;AAG9D;AAEA,eAAsB,IAAI,MAAqC;AAC7D,MAAI,KAAK,SAAS,QAAQ,KAAK,SAAS,MAAM;AAC5C,YAAQ,MAAM,oDAAoD;AAClE,YAAQ,KAAK,CAAC;AAAA,EAChB;AAEA,QAAM,aAAa,MAAM,GAAG,CAAC,+BAA+B,mCAAmC,CAAC;AAChG,YAAU,KAAK,KAAK,EAAE,WAAW,KAAK,CAAC;AAIvC,QAAM,cAAc,QAAQ,IAAI;AAChC,QAAM,WAAW,KAAK,aAAa,OAAO;AAC1C,QAAM,SAAS,QAAQ,aAAa,KAAK,GAAG;AAG5C,QAAM,iBAAiB,SAAS,QAAQ,QAAQ;AAChD,QAAM,eAAe,KAAK,gBAAgB,aAAa;AAEvD,aAAW,KAAK,YAAY;AAC1B,UAAM,OAAO,KAAK,MAAM,aAAa,GAAG,MAAM,CAAC;AAC/C,UAAM,OAAO,SAAS,CAAC,EAAE,QAAQ,WAAW,EAAE;AAC9C,UAAM,WAAW,KAAK,QAAQ,YAAY,GAAG;AAE7C,UAAM,OAAO,cAAc,MAAM,YAAY;AAC7C,UAAM,MAAM,KAAK,SAAS,OAAO,YAAY;AAC7C,UAAM,UAAU,KAAK,KAAK,KAAK,GAAG,QAAQ,IAAI,GAAG,EAAE;AACnD,kBAAc,SAAS,IAAI;AAAA,EAC7B;AAEA,UAAQ,IAAI,oBAAe,WAAW,MAAM,kCAA6B,KAAK,GAAG,EAAE;AACrF;AAEO,SAAS,SAAS;AACvB,QAAM,MAAM,IAAI,QAAQ,KAAK,EAC1B,YAAY,2DAA2D,EACvE,YAAY,SAAS;AAAA;AAAA;AAAA;AAAA,CAIzB,EACI,OAAO,iBAAiB,0CAA0C,IAAI,EACtE,OAAO,eAAe,wCAAwC,iBAAiB,EAC/E,OAAO,OAAO,SAAS;AACtB,UAAM,IAAI,EAAE,MAAM,KAAK,MAAM,KAAK,KAAK,IAAI,CAAC;AAAA,EAC9C,CAAC;AACH,SAAO;AACT;","names":[]}

package/dist/templates/student-framework/pages/LandingPage.js

@@ -1,18 +0,0 @@
-export class LandingPage {
-  /**
-   * @param {import('@playwright/test').Page} page
-   */
-  constructor(page) {
-    this.page = page;
-    this.newArrivalsText = page.getByText('New Arrivals Just In!');
-  }
-
-  async goto() {
-    await this.page.goto('/');
-  }
-
-  async verifyNewArrivals() {
-    await this.newArrivalsText.waitFor();
-    return await this.newArrivalsText.isVisible();
-  }
-}