@futdevpro/dynamo-e2e

End-to-end testing engine for the Dynamo + FDP ecosystem.

What

A Dynamo bedrock-package that turns Forms v2 Settings POJOs into Playwright test suites — auto-generated, typed, overridable, diffable.

Three layers in one package:

1. Form-coverage — every field-type has a pre-curated positive + negative input matrix; the generator emits ~20-50 tests per form from a single Settings POJO.
2. Viewport matrix (Wave-2) — auto-fan-out tests over 7 standard viewports + overflow/touch-target a11y detection.
3. Core Web Vitals diagnostics (Wave-3) — synthetic LCP / CLS / INP / TTFB measurement + percentile aggregation + attribution.

Status

Wave-1..4 + MP-10/MP-11 (2026-06-10) — Layer A contracts, Layer B generators (form-suite + viewport-suite + CWV-suite), Layer C runtime fixtures + page-objects, Overseer CICD pipeline registered, 75%+ test coverage gate active (statements 97.84%, branches 87.13%, functions 98.55%, lines 97.84%). 104 specs, 0 failures.

Plan-net: __documentations/plans/dynamo-e2e-foundation/HYPERPLAN.md (11 MPs, 4900+ LOC planning).

Install

pnpm add -D @futdevpro/dynamo-e2e @playwright/test

@futdevpro/fsm-dynamo is a peer-dep — bring your own (or no Settings POJO source if you only use the runtime presets).

Quick start

import { DyFM_TextFieldNew_Settings } from '@futdevpro/fsm-dynamo/ngx-models';
import { DyE2E_FormSuite_Generator } from '@futdevpro/dynamo-e2e/generators';

const settings = new DyFM_FormNew_Settings({
  key: 'login',
  fields: [
    new DyFM_TextFieldNew_Settings({ key: 'email', /* ... */ }),
  ],
});

const specSource = DyE2E_FormSuite_Generator.emit({
  formSettings: settings,
  formRoute: '/login',
  formSelector: 'dynamo-form-new',
});

// → write specSource to `e2e/tests/generated/login-form.spec.ts`

Sub-exports

• @futdevpro/dynamo-e2e/contracts — POJO types
• @futdevpro/dynamo-e2e/generators — Node-only emission engine
• @futdevpro/dynamo-e2e/runtime — Playwright fixtures + page-objects (Wave-4)
• @futdevpro/dynamo-e2e/presets — pre-built suites
• @futdevpro/dynamo-e2e/cwv — Core Web Vitals (Wave-3)