create-appraisejs 0.3.0 → 0.3.1-alpha.1

package/dist/prompts.test.js

@@ -0,0 +1,58 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest'
+import path from 'path'
+import fs from 'fs'
+import os from 'os'
+import { runPrompts } from './prompts.js'
+vi.mock('@inquirer/prompts', () => ({
+  input: vi.fn(),
+  select: vi.fn(),
+  confirm: vi.fn(),
+}))
+async function getMocks() {
+  const { input, select, confirm } = await import('@inquirer/prompts')
+  return { input: input, select: select, confirm: confirm }
+}
+describe('runPrompts', () => {
+  let cwd
+  let tempDir
+  beforeEach(() => {
+    cwd = process.cwd()
+    tempDir = path.join(os.tmpdir(), `create-appraisejs-prompts-${Date.now()}`)
+  })
+  afterEach(async () => {
+    if (tempDir && fs.existsSync(tempDir)) {
+      fs.rmSync(tempDir, { recursive: true, force: true })
+    }
+    vi.clearAllMocks()
+  })
+  it('returns directory, packageManager, and runInstall from mocked prompts', async () => {
+    fs.mkdirSync(tempDir, { recursive: true })
+    const { input, select, confirm } = await getMocks()
+    input.mockResolvedValue(tempDir)
+    select.mockResolvedValue('pnpm')
+    confirm.mockResolvedValue(false)
+    const result = await runPrompts(cwd)
+    expect(result.directory).toBe(path.resolve(cwd, tempDir))
+    expect(result.packageManager).toBe('pnpm')
+    expect(result.runInstall).toBe(false)
+  })
+  it('throws when target directory exists and is non-empty', async () => {
+    fs.mkdirSync(tempDir, { recursive: true })
+    fs.writeFileSync(path.join(tempDir, 'file.txt'), 'x')
+    const { input } = await getMocks()
+    input.mockResolvedValue(tempDir)
+    await expect(runPrompts(cwd)).rejects.toThrow(/Directory must be empty/)
+  })
+  it('accepts when target directory does not exist', async () => {
+    const newPath = path.join(tempDir, 'new-app')
+    const { input, select, confirm } = await getMocks()
+    input.mockResolvedValue(newPath)
+    select.mockResolvedValue('npm')
+    confirm.mockResolvedValue(true)
+    const result = await runPrompts(cwd)
+    expect(result.directory).toBe(path.resolve(cwd, newPath))
+    expect(result.packageManager).toBe('npm')
+    expect(result.runInstall).toBe(true)
+  })
+})
+//# sourceMappingURL=prompts.test.js.map

package/dist/prompts.test.js.map

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

package/dist/sync-templates-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sync-templates-utils.d.ts","sourceRoot":"","sources":["../src/sync-templates-utils.ts"],"names":[],"mappings":"AAWA,wBAAgB,gCAAgC,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAS9E"}
+{"version":3,"file":"sync-templates-utils.d.ts","sourceRoot":"","sources":["../src/sync-templates-utils.ts"],"names":[],"mappings":"AAOA,wBAAgB,gCAAgC,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAS9E"}

package/dist/sync-templates-utils.js

@@ -1,8 +1,4 @@
-const EXCLUDED_TEMPLATE_PATH_PREFIXES = [
-    'automation/features/',
-    'automation/locators/',
-    'automation/reports/',
-];
+const EXCLUDED_TEMPLATE_PATH_PREFIXES = ['automation/features/', 'automation/locators/', 'automation/reports/'];
 const EXCLUDED_TEMPLATE_FILENAMES = new Set(['.DS_Store']);
 function toPosixPath(value) {
     return value.replace(/\\/g, '/');

package/dist/sync-templates-utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"sync-templates-utils.js","sourceRoot":"","sources":["../src/sync-templates-utils.ts"],"names":[],"mappings":"AAAA,MAAM,+BAA+B,GAAG;IACtC,sBAAsB;IACtB,sBAAsB;IACtB,qBAAqB;CACb,CAAA;AACV,MAAM,2BAA2B,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAA;AAE1D,SAAS,WAAW,CAAC,KAAa;IAChC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;AAClC,CAAC;AAED,MAAM,UAAU,gCAAgC,CAAC,YAAoB;IACnE,MAAM,cAAc,GAAG,WAAW,CAAC,YAAY,CAAC,CAAA;IAChD,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IACvC,OAAO,CACL,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,2BAA2B,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzD,+BAA+B,CAAC,IAAI,CAClC,MAAM,CAAC,EAAE,CAAC,cAAc,KAAK,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,cAAc,CAAC,UAAU,CAAC,MAAM,CAAC,CACtF,CACF,CAAA;AACH,CAAC"}
+{"version":3,"file":"sync-templates-utils.js","sourceRoot":"","sources":["../src/sync-templates-utils.ts"],"names":[],"mappings":"AAAA,MAAM,+BAA+B,GAAG,CAAC,sBAAsB,EAAE,sBAAsB,EAAE,qBAAqB,CAAU,CAAA;AACxH,MAAM,2BAA2B,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAA;AAE1D,SAAS,WAAW,CAAC,KAAa;IAChC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;AAClC,CAAC;AAED,MAAM,UAAU,gCAAgC,CAAC,YAAoB;IACnE,MAAM,cAAc,GAAG,WAAW,CAAC,YAAY,CAAC,CAAA;IAChD,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IACvC,OAAO,CACL,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,2BAA2B,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzD,+BAA+B,CAAC,IAAI,CAClC,MAAM,CAAC,EAAE,CAAC,cAAc,KAAK,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,cAAc,CAAC,UAAU,CAAC,MAAM,CAAC,CACtF,CACF,CAAA;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-appraisejs",
-  "version": "0.3.0",
+  "version": "0.3.1-alpha.1",
   "description": "Scaffold a new AppraiseJS app in your directory",
   "license": "Apache-2.0",
   "author": "Hasnat Jamil",
@@ -66,15 +66,12 @@
     "@types/cli-progress": "^3.11.6",
     "@types/cross-spawn": "^6.0.6",
     "@types/fs-extra": "^11.0.4",
-    "@types/node": "^20.17.16",
+    "@types/node": "^20.19.0",
     "tsx": "^4.20.4",
     "typescript": "^5.7.3",
-    "vitest": "^2.1.8"
+    "vitest": "^4.1.4"
   },
   "engines": {
     "node": ">=18"
-  },
-  "overrides": {
-    "esbuild": "^0.25.0"
   }
 }

package/templates/blank/.editorconfig

@@ -0,0 +1,11 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+indent_style = space
+indent_size = 2
+
+[*.md]
+trim_trailing_whitespace = false

package/templates/blank/.env.example

@@ -1,2 +1,2 @@
-# Database configuration for local development
-DATABASE_URL="file:./dev.db"
+# Database configuration for local development
+DATABASE_URL="file:./dev.db"

package/templates/blank/.gitattributes

@@ -0,0 +1,21 @@
+# Line endings: LF in Git (matches .editorconfig, .prettierrc endOfLine=lf).
+# Run `npm run setup:git` on Windows so local core.autocrlf does not fight this file.
+
+* text=auto eol=lf
+
+*.{ts,tsx,js,mjs,cjs,jsx,json,md,mdx,yml,yaml,css,scss,html,prisma,sql,feature} text eol=lf
+
+*.bat text eol=crlf
+*.cmd text eol=crlf
+*.ps1 text eol=crlf
+
+*.ico binary
+*.png binary
+*.jpg binary
+*.jpeg binary
+*.gif binary
+*.pdf binary
+*.woff binary
+*.woff2 binary
+*.ttf binary
+*.eot binary

package/templates/blank/.gitconfig.appraise

@@ -0,0 +1,14 @@
+# AppraiseJS repository Git defaults (LF). Applied via:
+#   npm run setup:git
+# which runs: git config --local include.path ../.gitconfig.appraise
+#
+# Keeps index and working-tree diffs aligned with .gitattributes (eol=lf) on Windows.
+
+[core]
+	autocrlf = false
+	eol = lf
+	safecrlf = warn
+
+[diff]
+	# Ignore CRLF-only noise when comparing index to working tree (safety net).
+	ignoreCrAtEol = true

package/templates/blank/.prettierrc

@@ -0,0 +1,13 @@
+{
+  "semi": false,
+  "singleQuote": true,
+  "trailingComma": "all",
+  "arrowParens": "avoid",
+  "printWidth": 120,
+  "tabWidth": 2,
+  "useTabs": false,
+  "bracketSpacing": true,
+  "bracketSameLine": false,
+  "endOfLine": "lf",
+  "plugins": ["prettier-plugin-tailwindcss"]
+}

package/templates/blank/.vscode/settings.json

@@ -1,4 +1,6 @@
 {
+  "files.eol": "\n",
+  "git.autocrlf": false,
   "cucumber.features": ["automation/features/**/*.feature"],
   "cucumber.glue": ["automation/steps/**/*.ts"],
   "prisma.pinToPrisma6": true,

package/templates/blank/README.md

@@ -32,18 +32,18 @@ npm run start
 
 ## Scripts
 
-| Script | Description |
-| --- | --- |
-| `npm run setup` | Install deps, create `.env`, and build the cucumber runtime plus the local production app |
-| `npm run build:local` | Build the cucumber runtime and the local production app |
-| `npm run start` | Start the local production server |
-| `npm run dev` | Start the Next.js development server |
-| `npm run install-playwright -- <browser...>` | Install selected Playwright browsers |
-| `npm run setup:db` | Recreate the local SQLite database from migrations and rerun `sync-all` |
-| `npm run setup:full` | Reinstall dependencies, rebuild the DB, rerun `sync-all`, and rebuild the production app |
-| `npm run sync-all` | Sync all starter entities from the bundled automation workspace into the database |
-| `npm run appraisejs:sync` | Alias for `sync-all` |
-| `npm run appraisejs:install-step -- --payload-file <path>` | Internal script used by `npx appraisejs@latest add step ...` |
+| Script                                                     | Description                                                                               |
+| ---------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
+| `npm run setup`                                            | Install deps, create `.env`, and build the cucumber runtime plus the local production app |
+| `npm run build:local`                                      | Build the cucumber runtime and the local production app                                   |
+| `npm run start`                                            | Start the local production server                                                         |
+| `npm run dev`                                              | Start the Next.js development server                                                      |
+| `npm run install-playwright -- <browser...>`               | Install selected Playwright browsers                                                      |
+| `npm run setup:db`                                         | Recreate the local SQLite database from migrations and rerun `sync-all`                   |
+| `npm run setup:full`                                       | Reinstall dependencies, rebuild the DB, rerun `sync-all`, and rebuild the production app  |
+| `npm run sync-all`                                         | Sync all starter entities from the bundled automation workspace into the database         |
+| `npm run appraisejs:sync`                                  | Alias for `sync-all`                                                                      |
+| `npm run appraisejs:install-step -- --payload-file <path>` | Internal script used by `npx appraisejs@latest add step ...`                              |
 
 ## Configuration
 

package/templates/blank/e2e/README.md

@@ -0,0 +1,56 @@
+# AppraiseJS E2E tests
+
+Playwright UI tests run against a local Next.js server with an isolated SQLite database. Data is reset and seeded before each test via Prisma helpers in `e2e/helpers/test-data.ts`.
+
+## Commands
+
+- `npm run validate:e2e` — full suite (used in CI)
+- `npm run validate:e2e:smoke` — smoke gate only (`@smoke` tag)
+- `E2E_GREP=@crud npx playwright test` — run a tagged subset locally
+
+## CI and parallelism
+
+GitHub Actions runs `npm run validate:e2e` after `npm run build` with `DATABASE_URL=file:./e2e.db`
+and `CI=true`. The Playwright web server starts via `e2e/start-server.mjs`, which recreates the
+E2E database and applies migrations before serving the production build.
+
+Keep `workers: 1` and `fullyParallel: false` in `playwright.config.ts` until each worker gets an
+isolated database. Spec files reset and seed the same SQLite file in `beforeEach`, so parallel
+workers cause unique-constraint and foreign-key failures in CI and locally.
+
+## Layout
+
+| File | Purpose |
+| --- | --- |
+| `appraise-smoke.spec.ts` | Fast regression gate |
+| `navigation.spec.ts` | Route matrix and dashboard attention links |
+| `crud-configuration.spec.ts` | Configuration entity CRUD |
+| `crud-tests.spec.ts` | Suites, cases, template-based create |
+| `authoring.spec.ts` | Inline dialogs, flow panel, authoring |
+| `runs-and-reports.spec.ts` | Seeded runs, reports, create form (no execution) |
+| `settings-sync.spec.ts` | Per-script sync buttons |
+
+Helpers live under `e2e/helpers/` (`ui`, `navigation`, `table`, `forms`, `test-data`).
+
+## Seed model
+
+`seedCoreData()` provisions modules, environments, tags, locators, template steps, a test case and suite, a completed run with report, and dashboard metric variants (failed, queued, running runs; attention metrics for drawer links).
+
+Seeded IDs are exported as `seededIds` for deep-link tests.
+
+## Scope boundaries
+
+**In scope:** UI flows with deterministic Prisma seed data.
+
+**Out of scope (covered elsewhere):**
+
+- Live `cucumber-js` execution and report JSON ingestion during E2E
+- Locator picker companion / external browser extension flows
+- Bidirectional feature sync CLI unless exposed in Settings UI
+
+## Debugging
+
+- Traces: `trace: 'on-first-retry'` in `playwright.config.ts`
+- Videos/screenshots retained on failure
+- Run a single file: `npx playwright test e2e/navigation.spec.ts`
+- UI mode: `npx playwright test --ui`

package/templates/blank/e2e/apply-migrations.mjs

@@ -0,0 +1,76 @@
+import { createHash, randomUUID } from 'node:crypto'
+import { existsSync, readFileSync, readdirSync } from 'node:fs'
+import { isAbsolute, join, resolve } from 'node:path'
+import { DatabaseSync } from 'node:sqlite'
+
+function sqlitePathFromDatabaseUrl(value) {
+  if (!value?.startsWith('file:')) {
+    throw new Error(`E2E SQLite setup expects a file: DATABASE_URL, received ${value || '<empty>'}`)
+  }
+
+  const sqlitePath = value.replace(/^file:/, '')
+  return isAbsolute(sqlitePath) ? sqlitePath : resolve(process.cwd(), 'prisma', sqlitePath)
+}
+
+const databaseUrl = process.env.DATABASE_URL ?? 'file:./e2e.db'
+const databasePath = sqlitePathFromDatabaseUrl(databaseUrl)
+const migrationsDir = resolve(process.cwd(), 'prisma', 'migrations')
+const db = new DatabaseSync(databasePath)
+
+db.exec(`
+  CREATE TABLE IF NOT EXISTS "_prisma_migrations" (
+    "id"                    TEXT PRIMARY KEY NOT NULL,
+    "checksum"              TEXT NOT NULL,
+    "finished_at"           DATETIME,
+    "migration_name"        TEXT NOT NULL,
+    "logs"                  TEXT,
+    "rolled_back_at"        DATETIME,
+    "started_at"            DATETIME NOT NULL DEFAULT current_timestamp,
+    "applied_steps_count"   INTEGER UNSIGNED NOT NULL DEFAULT 0
+  );
+`)
+
+const appliedRows = db.prepare('SELECT migration_name FROM "_prisma_migrations"').all()
+const appliedMigrations = new Set(appliedRows.map(row => row.migration_name))
+const insertMigration = db.prepare(`
+  INSERT INTO "_prisma_migrations" (
+    id,
+    checksum,
+    finished_at,
+    migration_name,
+    logs,
+    rolled_back_at,
+    applied_steps_count
+  ) VALUES (?, ?, current_timestamp, ?, NULL, NULL, 1)
+`)
+
+const migrationNames = readdirSync(migrationsDir, { withFileTypes: true })
+  .filter(entry => entry.isDirectory())
+  .map(entry => entry.name)
+  .sort()
+
+for (const migrationName of migrationNames) {
+  if (appliedMigrations.has(migrationName)) {
+    continue
+  }
+
+  const migrationPath = join(migrationsDir, migrationName, 'migration.sql')
+  if (!existsSync(migrationPath)) {
+    continue
+  }
+
+  const sql = readFileSync(migrationPath, 'utf8')
+  const checksum = createHash('sha256').update(sql).digest('hex')
+
+  db.exec('BEGIN')
+  try {
+    db.exec(sql)
+    insertMigration.run(randomUUID(), checksum, migrationName)
+    db.exec('COMMIT')
+  } catch (error) {
+    db.exec('ROLLBACK')
+    throw error
+  }
+}
+
+db.close()

package/templates/blank/e2e/appraise-smoke.spec.ts

@@ -0,0 +1,78 @@
+import { test, expect } from '@playwright/test'
+
+import {
+  disconnectPrisma,
+  findModuleByName,
+  generateSeededFeature,
+  readGeneratedFeature,
+  resetE2eData,
+  seedCoreData,
+  seededIds,
+} from './helpers/test-data'
+import { createModule, expectPageHeading } from './helpers/ui'
+
+test.describe('Smoke @smoke', () => {
+  test.beforeEach(async () => {
+    await resetE2eData()
+    await seedCoreData()
+  })
+
+  test.afterAll(async () => {
+    await disconnectPrisma()
+  })
+
+  test('dashboard renders seeded entity metrics', async ({ page }) => {
+    await page.goto('/')
+    await expectPageHeading(page, 'Dashboard')
+    await expect(page.getByText('Test Cases')).toBeVisible()
+    await expect(page.getByText('Test Suites')).toBeVisible()
+    await expect(page.getByText('Template Steps')).toBeVisible()
+    await expect(page.getByText('Attention Needed')).toBeVisible()
+  })
+
+  test('module CRUD path creates edits and deletes a module', async ({ page }) => {
+    const moduleName = 'E2E Smoke Module'
+    const editedModuleName = 'E2E Smoke Module Edited'
+
+    await createModule(page, moduleName)
+    const createdModule = await findModuleByName(moduleName)
+    expect(createdModule).not.toBeNull()
+
+    await page.goto(`/modules/modify/${createdModule?.id}`)
+    await page.getByLabel('Name').fill(editedModuleName)
+    await page.getByRole('button', { name: /^Save$/ }).click()
+    await expect(page).toHaveURL(/\/modules$/)
+    await expect(page.getByText(editedModuleName, { exact: true }).first()).toBeVisible()
+  })
+
+  test('seeded completed run opens report summary', async ({ page }) => {
+    await page.goto(`/test-runs/${seededIds.testRun}`)
+    await expectPageHeading(page, 'Test Run Details')
+    await expect(page.getByText('E2E Completed Run')).toBeVisible()
+
+    await page.getByRole('link', { name: /View Report/ }).click()
+    await expectPageHeading(page, /Test Run Report:/)
+    await expect(page.getByText('E2E seeded login works')).toBeVisible()
+  })
+
+  test('settings sync all completes without a fatal error', async ({ page }) => {
+    test.setTimeout(120_000)
+
+    await page.goto('/settings')
+    await expectPageHeading(page, 'Settings')
+    await page.getByRole('button', { name: 'Sync All' }).click()
+    await expect(page.getByText(/Sync completed|Sync failed/).first()).toBeVisible({ timeout: 90_000 })
+    await expect(page.getByText(/fatal|uncaught/i)).toHaveCount(0)
+  })
+
+  test('feature generation writes suite-backed feature output', async () => {
+    const featurePath = await generateSeededFeature()
+    const featureContent = readGeneratedFeature()
+
+    expect(featurePath.replaceAll('\\', '/')).toContain('automation/features/E2E Auth/e2e-auth-suite.feature')
+    expect(featureContent).toContain('Feature: Seeded suite for E2E feature generation')
+    expect(featureContent).toContain('@e2e-smoke')
+    expect(featureContent).toContain('Scenario: [E2E seeded login works] Seeded login smoke case')
+    expect(featureContent).toContain('Given I open the seeded page')
+  })
+})

package/templates/blank/e2e/authoring.spec.ts

@@ -0,0 +1,53 @@
+import { test, expect } from '@playwright/test'
+
+import { disconnectPrisma, resetE2eData, seedCoreData, seededIds } from './helpers/test-data'
+import { createTestCaseWithSeededStep } from './helpers/forms'
+import { expectPageHeading } from './helpers/ui'
+
+test.describe('Test authoring @authoring', () => {
+  test.beforeEach(async () => {
+    await resetE2eData()
+    await seedCoreData()
+  })
+
+  test.afterAll(async () => {
+    await disconnectPrisma()
+  })
+
+  test('inline tag and test suite dialogs add selectable records', async ({ page }) => {
+    await page.goto('/test-cases/create')
+    await expectPageHeading(page, 'Create New Test Case')
+    await page.getByRole('textbox', { name: 'Title' }).fill('E2E Inline Dialog Case')
+
+    await page.getByRole('button', { name: 'Create filter tag' }).click()
+    await page.getByRole('textbox', { name: 'Name', exact: true }).fill('E2E Inline Tag')
+    await page.getByRole('textbox', { name: 'Tag Expression', exact: true }).fill('@e2e-inline')
+    await page.getByRole('button', { name: /^Save$/ }).click()
+    await expect(page.getByRole('button', { name: 'E2E Inline Tag' })).toBeVisible()
+
+    await page.getByRole('button', { name: 'Create test suite' }).click()
+    await page.getByLabel('Name').fill('E2E Inline Suite')
+    await page.getByLabel('Module').click()
+    await page.getByRole('option', { name: 'E2E Auth' }).click()
+    await page.getByRole('button', { name: /^Save$/ }).click()
+    await expect(page.getByRole('button', { name: 'E2E Inline Suite' })).toBeVisible()
+  })
+
+  test('flow panel mounts on modify page and scenario preview shows seeded steps', async ({ page }) => {
+    await page.goto(`/test-cases/modify/${seededIds.testCase}`)
+    await expectPageHeading(page, 'Modify Test Case')
+    await page.getByRole('button', { name: /Continue/ }).click()
+    await expect(page.getByText('Test Case Flow', { exact: true }).first()).toBeVisible()
+    await expect(page.getByRole('button', { name: 'Search nodes' })).toBeVisible()
+
+    await page.getByRole('button', { name: 'Show test scenario preview' }).click()
+    await expect(page.getByText('Test Scenario(Preview)')).toBeVisible()
+    await expect(page.getByText('Given I open the seeded page')).toBeVisible()
+  })
+
+  test('full create flow adds a template-backed step before saving', async ({ page }) => {
+    await createTestCaseWithSeededStep(page, 'E2E Authored Case')
+    await page.goto('/test-cases')
+    await expect(page.getByText('E2E Authored Case', { exact: true }).first()).toBeVisible()
+  })
+})

package/templates/blank/e2e/crud-configuration.spec.ts

@@ -0,0 +1,138 @@
+import { test, expect } from '@playwright/test'
+
+import {
+  disconnectPrisma,
+  findEnvironmentByName,
+  findModuleByName,
+  findTagByName,
+  resetE2eData,
+  seedCoreData,
+  seededIds,
+} from './helpers/test-data'
+import {
+  createLocator,
+  createLocatorGroup,
+  createTemplateStep,
+  createTemplateStepGroup,
+  createTemplateTestCase,
+  editEnvironment,
+  editTag,
+} from './helpers/forms'
+import { createEnvironment, createModule, createTag, expectPageHeading, saveForm } from './helpers/ui'
+import { deleteRowByName, editRowByName, expectRowHidden, filterTableByName } from './helpers/table'
+
+test.describe('Configuration CRUD @crud', () => {
+  test.beforeEach(async () => {
+    await resetE2eData()
+    await seedCoreData()
+  })
+
+  test.afterAll(async () => {
+    await disconnectPrisma()
+  })
+
+  test('environment tag and locator entities support create edit and delete', async ({ page }) => {
+    const environmentName = 'E2E Config Environment'
+    const editedEnvironmentName = 'E2E Config Environment Edited'
+    const tagName = 'E2E Config Tag'
+    const editedTagName = 'E2E Config Tag Edited'
+    const locatorGroupName = 'E2E Config Locator Group'
+    const locatorName = 'E2E Config Locator'
+
+    await createEnvironment(page, environmentName)
+    const createdEnvironment = await findEnvironmentByName(environmentName)
+    expect(createdEnvironment).not.toBeNull()
+    await editEnvironment(page, createdEnvironment!.id, editedEnvironmentName)
+    await expect(page.getByText(editedEnvironmentName, { exact: true }).first()).toBeVisible()
+
+    await createTag(page, tagName, '@e2e-config')
+    const createdTag = await findTagByName(tagName)
+    expect(createdTag).not.toBeNull()
+    await editTag(page, createdTag!.id, editedTagName, '@e2e-config-edited')
+    await expect(page.getByText(editedTagName, { exact: true }).first()).toBeVisible()
+
+    await createLocatorGroup(page, locatorGroupName, 'E2E Auth', '/config-login')
+    await createLocator(page, locatorName, 'text=Config button', locatorGroupName)
+
+    await page.goto(`/locators/modify/${seededIds.locator}`)
+    await expect(page.getByRole('button', { name: 'Update Locator' })).toBeVisible()
+    await page.getByLabel('Locator Name').fill('E2E Sign In Button Edited')
+    await page.getByRole('button', { name: 'Update Locator' }).click()
+    await expect(page).toHaveURL(/\/locators$/)
+    await expect(page.getByText('E2E Sign In Button Edited', { exact: true }).first()).toBeVisible()
+
+    await deleteRowByName(page, locatorName)
+    await page.reload()
+    await expectRowHidden(page, locatorName)
+
+    await page.goto('/locator-groups')
+    await deleteRowByName(page, locatorGroupName)
+    await page.reload()
+    await expectRowHidden(page, locatorGroupName)
+
+    await page.goto('/tags')
+    await deleteRowByName(page, editedTagName)
+    await page.reload()
+    await expectRowHidden(page, editedTagName)
+
+    await page.goto('/environments')
+    await deleteRowByName(page, editedEnvironmentName)
+    await page.reload()
+    await expectRowHidden(page, editedEnvironmentName)
+  })
+
+  test('template catalog entities support create edit and delete', async ({ page }) => {
+    const groupName = 'E2E Config Template Group'
+    const stepName = 'E2E Config Template Step'
+    const templateCaseName = 'E2E Config Template Case'
+
+    await createTemplateStepGroup(page, groupName)
+    await createTemplateStep(page, stepName, groupName)
+    await createTemplateTestCase(page, templateCaseName)
+
+    await page.goto('/template-step-groups')
+    await editRowByName(page, groupName)
+    await page.getByLabel('Name').fill(`${groupName} Edited`)
+    await saveForm(page)
+    await expect(page.getByText(`${groupName} Edited`, { exact: true }).first()).toBeVisible()
+
+    await page.goto('/template-steps')
+    await editRowByName(page, stepName)
+    await page.getByLabel('Name').fill(`${stepName} Edited`)
+    await page.getByRole('button', { name: /^Save$/ }).click()
+    await expect(page.getByText(`${stepName} Edited`, { exact: true }).first()).toBeVisible()
+
+    await page.goto('/template-test-cases')
+    await deleteRowByName(page, templateCaseName)
+    await page.reload()
+    await expectRowHidden(page, templateCaseName)
+
+    await page.goto('/template-steps')
+    await deleteRowByName(page, `${stepName} Edited`)
+    await page.reload()
+    await expectRowHidden(page, `${stepName} Edited`)
+
+    await page.goto('/template-step-groups')
+    await deleteRowByName(page, `${groupName} Edited`)
+    await page.reload()
+    await expectRowHidden(page, `${groupName} Edited`)
+  })
+
+  test('module create edit delete remains available for configuration flows', async ({ page }) => {
+    const moduleName = 'E2E Config Module'
+    const editedModuleName = 'E2E Config Module Edited'
+
+    await createModule(page, moduleName)
+    const createdModule = await findModuleByName(moduleName)
+    expect(createdModule).not.toBeNull()
+
+    await page.goto(`/modules/modify/${createdModule?.id}`)
+    await page.getByLabel('Name').fill(editedModuleName)
+    await saveForm(page)
+    await expect(page.getByText(editedModuleName, { exact: true }).first()).toBeVisible()
+
+    await deleteRowByName(page, editedModuleName)
+    await page.reload()
+    await expectRowHidden(page, editedModuleName)
+  })
+})