@futdevpro/dynamo-e2e 1.5.0

package/examples/minimal-form/README.md

@@ -0,0 +1,55 @@
+# minimal-form example
+
+A legkisebb projekt-szkeleton, amely a `@futdevpro/dynamo-e2e` form-generator-t
+használja egy 3-mezős login form lefedéséhez.
+
+## Felépítés
+
+```
+minimal-form/
+├── README.md
+├── form-config.json   ← a generator-input
+└── e2e/
+    └── tests/
+        └── generated/
+            └── login-form.spec.ts   ← a generator által kiadott teszt-suite
+```
+
+## Generálás
+
+A package node_modules-ban telepített `dye2e` CLI-vel:
+
+```bash
+npx dye2e generate-form-suite \
+  --config ./examples/minimal-form/form-config.json \
+  --out    ./examples/minimal-form/e2e/tests/generated/login-form.spec.ts
+```
+
+Vagy közvetlenül a Node API-val:
+
+```typescript
+import { DyE2E_FormSuite_Generator } from '@futdevpro/dynamo-e2e/generators';
+import * as fs from 'fs';
+
+const config = JSON.parse(fs.readFileSync('form-config.json', 'utf-8'));
+const spec = DyE2E_FormSuite_Generator.emit(config);
+fs.writeFileSync('e2e/tests/generated/login-form.spec.ts', spec);
+```
+
+## Futtatás
+
+```bash
+npx playwright test e2e/tests/generated/login-form.spec.ts
+```
+
+## Mit fed le a generated suite
+
+A `form-config.json` `formSettings.fields` 3 fieldjéből (email, password,
+rememberMe) **kb. 30-40 teszt-case** generálódik:
+
+- email field: empty, ascii, unicode, emoji, xss-tag, sql-shape, oversize, …
+- password field: empty, ascii, undersize (minLength=8), xss-tag, oversize, …
+- rememberMe checkbox: toggle-once, toggle-twice, required-unchecked, …
+- Form-level: submit-empty, submit-valid, disabled
+
+Plus 3 form-level orchestrator-test.

package/examples/minimal-form/form-config.json

@@ -0,0 +1,38 @@
+{
+  "formSettings": {
+    "key": "login",
+    "label": "Login form",
+    "fields": [
+      {
+        "key": "email",
+        "type": "text",
+        "label": "Email",
+        "required": true,
+        "maxLength": 254,
+        "testId": "login-email"
+      },
+      {
+        "key": "password",
+        "type": "password",
+        "label": "Password",
+        "required": true,
+        "minLength": 8,
+        "maxLength": 128,
+        "testId": "login-password"
+      },
+      {
+        "key": "rememberMe",
+        "type": "checkbox",
+        "label": "Remember me",
+        "required": false,
+        "testId": "login-remember"
+      }
+    ]
+  },
+  "formRoute": "/login",
+  "formSelector": "dynamo-form-new",
+  "suiteSettings": {
+    "runMode": "full",
+    "describePrefix": "Login form (minimal-form example)"
+  }
+}

package/examples/multi-form-app/README.md

@@ -0,0 +1,63 @@
+# multi-form-app example
+
+Bemutatja: form-coverage + viewport-audit + CWV-diag egy app-ban, egy bootstrap
+scripten keresztül.
+
+## Felépítés
+
+```
+multi-form-app/
+├── README.md
+├── bootstrap.ts            ← egyetlen Node-script ami mind a 3 generatort futtatja
+├── settings/
+│   ├── login-form.json
+│   └── profile-form.json
+├── viewport-config.json
+├── cwv-config.json
+└── e2e/tests/generated/
+    ├── login-form.spec.ts
+    ├── profile-form.spec.ts
+    ├── viewport-audit.spec.ts
+    └── cwv-diag.spec.ts
+```
+
+## bootstrap.ts (programmatic API minta)
+
+```typescript
+import { DyE2E_FormSuite_Generator } from '@futdevpro/dynamo-e2e/generators';
+import { DyE2E_ViewportSuite_Generator } from '@futdevpro/dynamo-e2e/generators';
+import { DyE2E_CWVSuite_Generator } from '@futdevpro/dynamo-e2e/cwv';
+import * as fs from 'fs';
+import * as path from 'path';
+
+const SETTINGS_DIR: string = path.join(__dirname, 'settings');
+const OUT_DIR: string = path.join(__dirname, 'e2e/tests/generated');
+fs.mkdirSync(OUT_DIR, { recursive: true });
+
+// 1) Form-coverage per Settings POJO
+for (const file of fs.readdirSync(SETTINGS_DIR)) {
+  const cfg = JSON.parse(fs.readFileSync(path.join(SETTINGS_DIR, file), 'utf-8'));
+  const spec = DyE2E_FormSuite_Generator.emit(cfg);
+  const baseName: string = file.replace(/\.json$/, '');
+  fs.writeFileSync(path.join(OUT_DIR, `${baseName}.spec.ts`), spec);
+}
+
+// 2) Viewport audit
+const vCfg = JSON.parse(fs.readFileSync(path.join(__dirname, 'viewport-config.json'), 'utf-8'));
+fs.writeFileSync(path.join(OUT_DIR, 'viewport-audit.spec.ts'), DyE2E_ViewportSuite_Generator.emit(vCfg));
+
+// 3) CWV diagnostics
+const cwvCfg = JSON.parse(fs.readFileSync(path.join(__dirname, 'cwv-config.json'), 'utf-8'));
+fs.writeFileSync(path.join(OUT_DIR, 'cwv-diag.spec.ts'), DyE2E_CWVSuite_Generator.emit(cwvCfg));
+
+console.log('[bootstrap] generated', fs.readdirSync(OUT_DIR).length, 'spec files');
+```
+
+## Futtatás
+
+```bash
+ts-node bootstrap.ts
+npx playwright test
+```
+
+A teljes generation `<1s` még 5-form + 7-viewport + 5-route konfiguráción is.

package/examples/multi-form-app/cwv-config.json

@@ -0,0 +1,14 @@
+{
+  "routes": [
+    { "key": "home", "label": "Home", "path": "/" },
+    { "key": "login", "label": "Login", "path": "/login" }
+  ],
+  "iterationsPerRoute": 5,
+  "thresholds": {
+    "lcp_p75_ms": 2500,
+    "cls_p75": 0.1,
+    "fcp_p75_ms": 1800,
+    "ttfb_p75_ms": 800
+  },
+  "reportDir": "e2e/cwv-report"
+}

package/examples/multi-form-app/settings/login-form.json

@@ -0,0 +1,11 @@
+{
+  "formSettings": {
+    "key": "login",
+    "fields": [
+      { "key": "email", "type": "text", "required": true, "maxLength": 254 },
+      { "key": "password", "type": "password", "required": true, "minLength": 8 }
+    ]
+  },
+  "formRoute": "/login",
+  "formSelector": "dynamo-form-new"
+}

package/examples/multi-form-app/settings/profile-form.json

@@ -0,0 +1,25 @@
+{
+  "formSettings": {
+    "key": "profile",
+    "fields": [
+      { "key": "displayName", "type": "text", "required": true, "minLength": 2, "maxLength": 64 },
+      { "key": "bio", "type": "textarea", "maxLength": 500 },
+      { "key": "age", "type": "number", "min": 13, "max": 120 },
+      { "key": "birthDate", "type": "date" },
+      { "key": "preferredContactTime", "type": "dateTime" },
+      { "key": "notificationsEnabled", "type": "checkbox" },
+      {
+        "key": "plan",
+        "type": "radioSelect",
+        "required": true,
+        "options": [
+          { "label": "Free", "value": "free" },
+          { "label": "Pro", "value": "pro" },
+          { "label": "Enterprise", "value": "enterprise", "disabled": true }
+        ]
+      }
+    ]
+  },
+  "formRoute": "/profile",
+  "formSelector": "dynamo-form-new"
+}

package/examples/multi-form-app/viewport-config.json

@@ -0,0 +1,12 @@
+{
+  "routes": [
+    { "key": "home", "label": "Home page", "path": "/" },
+    { "key": "login", "label": "Login", "path": "/login" },
+    { "key": "profile", "label": "Profile", "path": "/profile" }
+  ],
+  "themes": ["dark", "light"],
+  "checkOverflow": true,
+  "checkTouchTargets": true,
+  "takeScreenshot": true,
+  "screenshotDir": "e2e/screenshots"
+}

package/package.json

@@ -0,0 +1,103 @@
+{
+  "name": "@futdevpro/dynamo-e2e",
+  "version": "01.05.0",
+  "description": "End-to-end testing engine for the Dynamo + FDP ecosystem — auto-generated form-coverage tests, viewport audit matrix, CWV diagnostics. Settings-POJO-first.",
+  "DyBu_settings": {
+    "packageType": "core-package",
+    "tgzFolderName": "dynamo-e2e",
+    "systemName": "dynamo",
+    "aiNotes": "POJO contracts + Node generators emit Playwright spec.ts files. Settings POJO source of truth = @futdevpro/fsm-dynamo. NO Angular runtime."
+  },
+  "author": "Future Development Program Ltd.",
+  "license": "ISC",
+  "homepage": "futdevpro.hu/projects/dynamo",
+  "bugs": {
+    "url": "https://github.com/futdevpro/dynamo-e2e/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/futdevpro/dynamo-e2e.git"
+  },
+  "keywords": [
+    "typescript",
+    "e2e",
+    "playwright",
+    "test-generator",
+    "dynamo",
+    "fdp"
+  ],
+  "scripts": {
+    "prep": "npm i -g pnpm rimraf jasmine && pnpm i",
+    "start": "npm run prep && nodemon",
+    "deploy": "npm run build",
+    "build": "pnpm run build-base && jasmine && npm publish",
+    "build-tgz": "pnpm run build-base && jasmine && pnpm pack && move ./*.tgz ../tgz-collection/dynamo-e2e",
+    "build-tgz-cheap": "pnpm i && npx tsc && pnpm pack && move ./*.tgz ../tgz-collection/dynamo-e2e",
+    "build-all": "pnpm run build-tgz && pnpm run build",
+    "build-base": "rimraf ./build && npx tsc",
+    "build-clean": "pnpm run clean && pnpm run build-base",
+    "build-simple": "npx tsc && jasmine",
+    "build-n-test": "pnpm i && npm run build-tgz",
+    "clean": "pnpm run prep && rimraf ./build && rimraf package-lock.json && rimraf pnpm-lock.yaml && rimraf ./node_modules",
+    "test": "pnpm run build-base && jasmine",
+    "test:coverage": "pnpm run build-base && c8 jasmine",
+    "coverage:report": "c8 report --reporter=text-summary --reporter=html",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint src --ext .ts --fix"
+  },
+  "main": "./build/index.js",
+  "module": "./build/index.js",
+  "types": "./build/index.d.ts",
+  "typings": "./build/index.d.ts",
+  "bin": {
+    "dye2e": "./bin/dye2e.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./build/index.d.ts",
+      "typings": "./build/index.d.ts",
+      "module": "./build/index.js",
+      "default": "./build/index.js"
+    },
+    "./contracts": {
+      "default": "./build/_modules/contracts/index.js",
+      "module": "./build/_modules/contracts/index.js",
+      "types": "./build/_modules/contracts/index.d.ts",
+      "typings": "./build/_modules/contracts/index.d.ts"
+    },
+    "./generators": {
+      "default": "./build/_modules/generators/index.js",
+      "module": "./build/_modules/generators/index.js",
+      "types": "./build/_modules/generators/index.d.ts",
+      "typings": "./build/_modules/generators/index.d.ts"
+    },
+    "./runtime": {
+      "default": "./build/_modules/runtime/index.js",
+      "module": "./build/_modules/runtime/index.js",
+      "types": "./build/_modules/runtime/index.d.ts",
+      "typings": "./build/_modules/runtime/index.d.ts"
+    },
+    "./presets": {
+      "default": "./build/_modules/presets/index.js",
+      "module": "./build/_modules/presets/index.js",
+      "types": "./build/_modules/presets/index.d.ts",
+      "typings": "./build/_modules/presets/index.d.ts"
+    },
+    "./cwv": {
+      "default": "./build/_modules/cwv/index.js",
+      "module": "./build/_modules/cwv/index.js",
+      "types": "./build/_modules/cwv/index.d.ts",
+      "typings": "./build/_modules/cwv/index.d.ts"
+    }
+  },
+  "devDependencies": {
+    "@playwright/test": "1.48.2",
+    "@types/jasmine": "5.1.4",
+    "@types/node": "20.14.10",
+    "c8": "10.1.2",
+    "jasmine": "5.2.0",
+    "jasmine-spec-reporter": "7.0.0",
+    "rimraf": "5.0.9",
+    "typescript": "5.5.4"
+  }
+}