create-appraisejs 0.3.0 → 0.3.1-alpha.0

package/templates/starter/package.json

@@ -6,6 +6,7 @@
   "scripts": {
     "dev": "next dev",
     "init": "DISABLE_DEVTOOLS=1 NEXT_PUBLIC_DISABLE_DEVTOOLS=1 next dev",
+    "prepare": "simple-git-hooks",
     "build:cucumber-runtime": "tsc -p packages/cucumber-runtime/tsconfig.json",
     "build:locator-picker-companion": "tsc -p packages/locator-picker-companion/tsconfig.json",
     "build": "npm run build:local",
@@ -32,6 +33,19 @@
     "appraisejs:install-step": "npx tsx scripts/install-template-step.ts",
     "test": "cucumber-js",
     "validate": "node --import tsx scripts/run-vitest.ts",
+    "quality:fallow": "fallow --format json --quiet --explain",
+    "quality:fallow:ci": "fallow --format json --quiet --explain --fail-on-issues",
+    "quality:fallow:commit": "node ./scripts/run-fallow-commit.mjs",
+    "quality:react-doctor": "react-doctor . --project appraisejs --offline --full",
+    "quality:react-doctor:ci": "react-doctor . --project appraisejs --offline --full --fail-on error",
+    "quality:react-doctor:commit": "react-doctor . --project appraisejs --offline --staged --fail-on error",
+    "quality:pre-commit": "npm run quality:fallow:commit && npm run quality:react-doctor:commit",
+    "graphify:query": "graphify query --budget 1500",
+    "graphify:path": "graphify path",
+    "graphify:explain": "graphify explain",
+    "graphify:update": "graphify update .",
+    "graphify:wiki": "graphify export wiki",
+    "graphify:benchmark": "graphify benchmark",
     "build:local": "npm run generate-db-client && npm run build:cucumber-runtime && npm run build:locator-picker-companion && next build",
     "generate-db-client": "npx prisma generate --schema prisma/schema.prisma",
     "setup:db": "npm run setup-env && npm run generate-db-client && npm run migrate-db && npm run sync-all",
@@ -46,13 +60,10 @@
     "@codemirror/lang-jinja": "^6.0.0",
     "@faker-js/faker": "^10.2.0",
     "@prisma/client": "^6.2.1",
-    "@radix-ui/react-alert-dialog": "^1.1.14",
-    "@radix-ui/react-avatar": "^1.1.10",
     "@radix-ui/react-checkbox": "^1.3.2",
     "@radix-ui/react-dialog": "^1.1.14",
     "@radix-ui/react-dropdown-menu": "^2.1.15",
     "@radix-ui/react-label": "^2.1.7",
-    "@radix-ui/react-navigation-menu": "^1.2.13",
     "@radix-ui/react-popover": "^1.1.14",
     "@radix-ui/react-progress": "^1.1.8",
     "@radix-ui/react-radio-group": "^1.3.8",
@@ -71,11 +82,11 @@
     "@uiw/react-codemirror": "^4.25.4",
     "@xyflow/react": "^12.4.4",
     "archiver": "^7.0.1",
-    "better-sqlite3": "^12.4.1",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "cmdk": "^1.1.1",
     "date-fns": "^4.1.0",
+    "dotenv": "^17.2.3",
     "lucide-react": "^0.473.0",
     "motion": "^12.23.26",
     "next": "^16.1.6",
@@ -85,16 +96,13 @@
     "react-dom": "^19.2.1",
     "recharts": "^2.15.4",
     "tailwind-merge": "^2.6.0",
-    "tailwindcss-animate": "^1.0.7",
     "winston": "^3.19.0",
     "zod": "^3.24.1"
   },
   "devDependencies": {
     "@babel/traverse": "^7.28.5",
-    "@cucumber/cucumber": "^12.6.0",
-    "@cucumber/pretty-formatter": "^3.0.0",
-    "@cucumber/tag-expressions": "^8.0.0",
-    "@eslint/eslintrc": "^3",
+    "@cucumber/cucumber": "^12.8.3",
+    "@testing-library/dom": "^10.4.1",
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/react": "^16.3.2",
     "@testing-library/user-event": "^14.6.1",
@@ -103,32 +111,33 @@
     "@types/chai": "^5.2.2",
     "@types/chai-as-promised": "^8.0.2",
     "@types/fs-extra": "^11.0.4",
-    "@types/node": "^20.17.16",
+    "@types/node": "^20.19.0",
     "@types/react": "^19.2.7",
     "@types/react-dom": "^19.2.3",
-    "baseline-browser-mapping": "^2.9.3",
-    "chai": "^5.2.1",
-    "chai-as-promised": "^8.0.1",
-    "commander": "^14.0.2",
-    "dotenv": "^17.2.3",
     "eslint": "^9",
     "eslint-config-next": "^16.1.6",
     "execa": "^9.6.0",
+    "fallow": "^2.69.0",
     "glob": "^11.0.3",
-    "globals": "^16.4.0",
-    "jiti": "^2.6.1",
     "jsdom": "^29.0.1",
     "playwright": "^1.58.0",
     "postcss": "^8",
+    "postcss-load-config": "^6.0.1",
     "prettier": "^3.6.2",
     "prettier-plugin-tailwindcss": "^0.6.14",
     "prisma": "^6.2.1",
+    "react-doctor": "^0.1.6",
     "rimraf": "^6.1.2",
+    "simple-git-hooks": "^2.13.1",
     "tailwindcss": "^3.4.1",
+    "tailwindcss-animate": "^1.0.7",
     "ts-node": "^10.9.2",
     "tsx": "^4.20.4",
     "typescript": "^5.7.3",
-    "vitest": "^4.1.1"
+    "vitest": "^4.1.4"
+  },
+  "simple-git-hooks": {
+    "pre-commit": "npm run quality:pre-commit"
   },
   "overrides": {
     "react-is": "^19.2.1",

package/templates/starter/packages/cucumber-runtime/package.json

@@ -1,13 +1,13 @@
-{
-  "name": "@appraise/cucumber-runtime",
-  "private": true,
-  "type": "module",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": "./dist/index.js"
-  },
-  "scripts": {
-    "build": "tsc -p tsconfig.json"
-  }
-}
+{
+  "name": "@appraise/cucumber-runtime",
+  "private": true,
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json"
+  }
+}

package/templates/starter/packages/cucumber-runtime/src/cache.util.ts

@@ -1,93 +1,93 @@
-import { readFileSync } from 'fs'
-import { globSync } from 'glob'
-import * as path from 'path'
-import { LocatorCollection, LocatorMap } from './types.js'
-import { getAutomationLocatorMapPath, getAutomationLocatorsDir } from './paths.js'
-
-function toGlobPath(targetPath: string): string {
-  return targetPath.split(path.sep).join('/')
-}
-
-export class LocatorCache {
-  private static instance: LocatorCache
-  private data: Record<string, LocatorCollection> = {}
-  private filePaths: Record<string, string> = {}
-  private loadedFiles: Set<string> = new Set()
-
-  private constructor() {
-    globSync(`${toGlobPath(getAutomationLocatorsDir())}/**/*.json`).forEach(file => {
-      const fileName = path.basename(file, path.extname(file))
-      this.filePaths[fileName ?? file] = file
-    })
-  }
-
-  public static getInstance(): LocatorCache {
-    if (!LocatorCache.instance) {
-      LocatorCache.instance = new LocatorCache()
-    }
-    return LocatorCache.instance
-  }
-
-  public get(key: string): LocatorCollection | null {
-    if (!this.loadedFiles.has(key) && this.filePaths[key]) {
-      try {
-        const filePath = this.filePaths[key]
-        const data = JSON.parse(readFileSync(filePath, 'utf8'))
-        this.data[key] = data as LocatorCollection
-        this.loadedFiles.add(key)
-      } catch (error) {
-        console.error(`Error loading locator file for key "${key}":`, error)
-        return null
-      }
-    }
-
-    return this.data[key] ? { ...this.data[key] } : null
-  }
-
-  public preloadAll(): void {
-    Object.keys(this.filePaths).forEach(key => {
-      if (!this.loadedFiles.has(key)) {
-        this.get(key)
-      }
-    })
-  }
-
-  public getAvailableKeys(): string[] {
-    return Object.keys(this.filePaths)
-  }
-
-  public isLoaded(key: string): boolean {
-    return this.loadedFiles.has(key)
-  }
-}
-
-export class LocatorMapCache {
-  private static instance: LocatorMapCache
-  private data: LocatorMap[] = []
-
-  private constructor() {
-    this.data = JSON.parse(readFileSync(getAutomationLocatorMapPath(), 'utf8'))
-  }
-
-  public static getInstance(): LocatorMapCache {
-    if (!LocatorMapCache.instance) {
-      LocatorMapCache.instance = new LocatorMapCache()
-    }
-    return LocatorMapCache.instance
-  }
-
-  public get(key: string): LocatorMap {
-    try {
-      return this.data.find(map => map.path === key) as LocatorMap
-    } catch {
-      return {
-        name: '',
-        path: '',
-      }
-    }
-  }
-
-  public getAll(): LocatorMap[] {
-    return this.data
-  }
-}
+import { readFileSync } from 'fs'
+import { globSync } from 'glob'
+import * as path from 'path'
+import { LocatorCollection, LocatorMap } from './types.js'
+import { getAutomationLocatorMapPath, getAutomationLocatorsDir } from './paths.js'
+
+function toGlobPath(targetPath: string): string {
+  return targetPath.split(path.sep).join('/')
+}
+
+export class LocatorCache {
+  private static instance: LocatorCache
+  private data: Record<string, LocatorCollection> = {}
+  private filePaths: Record<string, string> = {}
+  private loadedFiles: Set<string> = new Set()
+
+  private constructor() {
+    globSync(`${toGlobPath(getAutomationLocatorsDir())}/**/*.json`).forEach(file => {
+      const fileName = path.basename(file, path.extname(file))
+      this.filePaths[fileName ?? file] = file
+    })
+  }
+
+  public static getInstance(): LocatorCache {
+    if (!LocatorCache.instance) {
+      LocatorCache.instance = new LocatorCache()
+    }
+    return LocatorCache.instance
+  }
+
+  public get(key: string): LocatorCollection | null {
+    if (!this.loadedFiles.has(key) && this.filePaths[key]) {
+      try {
+        const filePath = this.filePaths[key]
+        const data = JSON.parse(readFileSync(filePath, 'utf8'))
+        this.data[key] = data as LocatorCollection
+        this.loadedFiles.add(key)
+      } catch (error) {
+        console.error(`Error loading locator file for key "${key}":`, error)
+        return null
+      }
+    }
+
+    return this.data[key] ? { ...this.data[key] } : null
+  }
+
+  public preloadAll(): void {
+    Object.keys(this.filePaths).forEach(key => {
+      if (!this.loadedFiles.has(key)) {
+        this.get(key)
+      }
+    })
+  }
+
+  public getAvailableKeys(): string[] {
+    return Object.keys(this.filePaths)
+  }
+
+  public isLoaded(key: string): boolean {
+    return this.loadedFiles.has(key)
+  }
+}
+
+export class LocatorMapCache {
+  private static instance: LocatorMapCache
+  private data: LocatorMap[] = []
+
+  private constructor() {
+    this.data = JSON.parse(readFileSync(getAutomationLocatorMapPath(), 'utf8'))
+  }
+
+  public static getInstance(): LocatorMapCache {
+    if (!LocatorMapCache.instance) {
+      LocatorMapCache.instance = new LocatorMapCache()
+    }
+    return LocatorMapCache.instance
+  }
+
+  public get(key: string): LocatorMap {
+    try {
+      return this.data.find(map => map.path === key) as LocatorMap
+    } catch {
+      return {
+        name: '',
+        path: '',
+      }
+    }
+  }
+
+  public getAll(): LocatorMap[] {
+    return this.data
+  }
+}

package/templates/starter/packages/cucumber-runtime/src/cli.ts

@@ -1,68 +1,68 @@
-import { Command, Option, OptionValues } from 'commander'
-import parseTagExpression from '@cucumber/tag-expressions'
-import { getAllEnvironments } from './environment.util.js'
-import { BrowserName } from './types.js'
-
-export interface CliOptions extends OptionValues {
-  environment: string
-  tags: string
-  parallel: number
-  browser: BrowserName
-  headless: 'true' | 'false'
-}
-
-const BROWSER_CHOICES = ['chromium', 'firefox', 'webkit'] as const
-const HEADLESS_CHOICES = ['true', 'false'] as const
-const DEFAULT_PARALLEL_WORKERS = 1
-const DEFAULT_BROWSER: BrowserName = 'chromium'
-const DEFAULT_HEADLESS = 'true'
-
-const program = new Command()
-
-let environmentNames: string[] = []
-try {
-  environmentNames = Object.keys(getAllEnvironments())
-} catch (error) {
-  console.error('Failed to load environments:', error instanceof Error ? error.message : 'Unknown error')
-  process.exit(1)
-}
-
-function parsePositiveInt(value: string): number {
-  const parsed = Number(value)
-  if (!Number.isInteger(parsed) || parsed <= 0) {
-    throw new Error(`--parallel must be a positive integer, got "${value}"`)
-  }
-  return parsed
-}
-
-function validateCucumberTagExpression(value: string): string {
-  try {
-    parseTagExpression(value)
-    return value
-  } catch (error) {
-    throw new Error(`Invalid tag expression: ${error instanceof Error ? error.message : 'Unknown error'}`)
-  }
-}
-
-program
-  .name('cucumber-runtime')
-  .description('CLI for running Appraise cucumber automation')
-  .version('1.0.0')
-  .addOption(
-    new Option('-e, --environment <environment>', 'The environment to run the tests on')
-      .choices(environmentNames)
-      .makeOptionMandatory(),
-  )
-  .addOption(
-    new Option('-t, --tags <tags>', 'The tags to run the tests on')
-      .argParser(validateCucumberTagExpression)
-      .makeOptionMandatory(),
-  )
-  .option('-p, --parallel <parallel>', 'The number of parallel workers to run', parsePositiveInt, DEFAULT_PARALLEL_WORKERS)
-  .addOption(new Option('-b, --browser <browser>', 'The browser to run').choices(BROWSER_CHOICES).default(DEFAULT_BROWSER))
-  .addOption(new Option('--headless <headless>', 'Whether to run headless').choices(HEADLESS_CHOICES).default(DEFAULT_HEADLESS))
-
-export function startCli(): CliOptions {
-  program.parse()
-  return program.opts() as CliOptions
-}
+import { Command, Option, OptionValues } from 'commander'
+import parseTagExpression from '@cucumber/tag-expressions'
+import { getAllEnvironments } from './environment.util.js'
+import { BrowserName } from './types.js'
+
+export interface CliOptions extends OptionValues {
+  environment: string
+  tags: string
+  parallel: number
+  browser: BrowserName
+  headless: 'true' | 'false'
+}
+
+const BROWSER_CHOICES = ['chromium', 'firefox', 'webkit'] as const
+const HEADLESS_CHOICES = ['true', 'false'] as const
+const DEFAULT_PARALLEL_WORKERS = 1
+const DEFAULT_BROWSER: BrowserName = 'chromium'
+const DEFAULT_HEADLESS = 'true'
+
+const program = new Command()
+
+let environmentNames: string[] = []
+try {
+  environmentNames = Object.keys(getAllEnvironments())
+} catch (error) {
+  console.error('Failed to load environments:', error instanceof Error ? error.message : 'Unknown error')
+  process.exit(1)
+}
+
+function parsePositiveInt(value: string): number {
+  const parsed = Number(value)
+  if (!Number.isInteger(parsed) || parsed <= 0) {
+    throw new Error(`--parallel must be a positive integer, got "${value}"`)
+  }
+  return parsed
+}
+
+function validateCucumberTagExpression(value: string): string {
+  try {
+    parseTagExpression(value)
+    return value
+  } catch (error) {
+    throw new Error(`Invalid tag expression: ${error instanceof Error ? error.message : 'Unknown error'}`)
+  }
+}
+
+program
+  .name('cucumber-runtime')
+  .description('CLI for running Appraise cucumber automation')
+  .version('1.0.0')
+  .addOption(
+    new Option('-e, --environment <environment>', 'The environment to run the tests on')
+      .choices(environmentNames)
+      .makeOptionMandatory(),
+  )
+  .addOption(
+    new Option('-t, --tags <tags>', 'The tags to run the tests on')
+      .argParser(validateCucumberTagExpression)
+      .makeOptionMandatory(),
+  )
+  .option('-p, --parallel <parallel>', 'The number of parallel workers to run', parsePositiveInt, DEFAULT_PARALLEL_WORKERS)
+  .addOption(new Option('-b, --browser <browser>', 'The browser to run').choices(BROWSER_CHOICES).default(DEFAULT_BROWSER))
+  .addOption(new Option('--headless <headless>', 'Whether to run headless').choices(HEADLESS_CHOICES).default(DEFAULT_HEADLESS))
+
+export function startCli(): CliOptions {
+  program.parse()
+  return program.opts() as CliOptions
+}

package/templates/starter/packages/cucumber-runtime/src/environment.util.ts

@@ -1,21 +1,21 @@
-import { readFileSync } from 'fs'
-import { getAutomationEnvironmentsFilePath } from './paths.js'
-
-interface EnvironmentConfig {
-  baseUrl: string
-  apiBaseUrl: string
-  email: string
-  password: string
-}
-
-export function getEnvironment(environment: string): EnvironmentConfig {
-  const environmentConfig: Record<string, EnvironmentConfig> = JSON.parse(
-    readFileSync(getAutomationEnvironmentsFilePath(), 'utf8'),
-  )
-
-  return environmentConfig[environment.toLowerCase()] as EnvironmentConfig
-}
-
-export function getAllEnvironments(): Record<string, EnvironmentConfig> {
-  return JSON.parse(readFileSync(getAutomationEnvironmentsFilePath(), 'utf8'))
-}
+import { readFileSync } from 'fs'
+import { getAutomationEnvironmentsFilePath } from './paths.js'
+
+interface EnvironmentConfig {
+  baseUrl: string
+  apiBaseUrl: string
+  email: string
+  password: string
+}
+
+export function getEnvironment(environment: string): EnvironmentConfig {
+  const environmentConfig: Record<string, EnvironmentConfig> = JSON.parse(
+    readFileSync(getAutomationEnvironmentsFilePath(), 'utf8'),
+  )
+
+  return environmentConfig[environment.toLowerCase()] as EnvironmentConfig
+}
+
+export function getAllEnvironments(): Record<string, EnvironmentConfig> {
+  return JSON.parse(readFileSync(getAutomationEnvironmentsFilePath(), 'utf8'))
+}

package/templates/starter/packages/cucumber-runtime/src/executor.ts

@@ -1,32 +1,32 @@
-import { execa } from 'execa'
-import { config } from 'dotenv'
-import { startCli } from './cli.js'
-
-async function bootstrap(): Promise<void> {
-  config()
-
-  try {
-    const { environment, tags, parallel, browser, headless } = startCli()
-
-    process.env.ENVIRONMENT = environment
-    process.env.HEADLESS = headless
-    process.env.BROWSER = browser
-
-    const cucumberArgs: string[] = ['cucumber-js', '-t', tags]
-    if (parallel > 1) {
-      cucumberArgs.push('--parallel', parallel.toString())
-    }
-
-    const subprocess = execa('npx', cucumberArgs, {
-      stdio: 'inherit',
-    })
-
-    const result = await subprocess
-    process.exit(result.exitCode ?? 0)
-  } catch (error) {
-    console.error(error instanceof Error ? error.message : 'Unknown error')
-    process.exit(1)
-  }
-}
-
-bootstrap()
+import { execa } from 'execa'
+import { config } from 'dotenv'
+import { startCli } from './cli.js'
+
+async function bootstrap(): Promise<void> {
+  config()
+
+  try {
+    const { environment, tags, parallel, browser, headless } = startCli()
+
+    process.env.ENVIRONMENT = environment
+    process.env.HEADLESS = headless
+    process.env.BROWSER = browser
+
+    const cucumberArgs: string[] = ['cucumber-js', '-t', tags]
+    if (parallel > 1) {
+      cucumberArgs.push('--parallel', parallel.toString())
+    }
+
+    const subprocess = execa('npx', cucumberArgs, {
+      stdio: 'inherit',
+    })
+
+    const result = await subprocess
+    process.exit(result.exitCode ?? 0)
+  } catch (error) {
+    console.error(error instanceof Error ? error.message : 'Unknown error')
+    process.exit(1)
+  }
+}
+
+bootstrap()

package/templates/starter/packages/cucumber-runtime/src/index.ts

@@ -1,17 +1,17 @@
-export {
-  After,
-  AfterAll,
-  AfterStep,
-  Before,
-  BeforeAll,
-  Given,
-  Then,
-  When,
-  defineParameterType,
-  setDefaultTimeout,
-} from '@cucumber/cucumber'
-export { CustomWorld, expect } from './world.js'
-export { getEnvironment, getAllEnvironments } from './environment.util.js'
-export { resolveLocator, retry, waitForRouteSettled } from './locator.util.js'
-export { generateRandomData, RandomDataType } from './random-data.util.js'
-export type { BrowserName, Locator, LocatorCollection, LocatorMap, Selector, SelectorName } from './types.js'
+export {
+  After,
+  AfterAll,
+  AfterStep,
+  Before,
+  BeforeAll,
+  Given,
+  Then,
+  When,
+  defineParameterType,
+  setDefaultTimeout,
+} from '@cucumber/cucumber'
+export { CustomWorld, expect } from './world.js'
+export { getEnvironment, getAllEnvironments } from './environment.util.js'
+export { resolveLocator, retry, waitForRouteSettled } from './locator.util.js'
+export { generateRandomData, RandomDataType } from './random-data.util.js'
+export type { BrowserName, Locator, LocatorCollection, LocatorMap, Selector, SelectorName } from './types.js'