create-appraisejs 0.3.1-alpha.0 → 0.3.1-alpha.1

package/templates/default/packages/locator-picker-companion/dist/session-file.d.ts

@@ -1,22 +1,30 @@
-import type { CompanionSessionFile } from './types.js';
-export declare function getLocatorPickerRootDir(repoRoot?: string): string;
-export declare function getLocatorPickerSessionsDir(repoRoot?: string): string;
-export declare function getLocatorPickerProfilesDir(repoRoot?: string): string;
-export declare function getLocatorPickerLogsDir(repoRoot?: string): string;
-export declare function getLocatorPickerProfileDir(sessionId: string, repoRoot?: string): string;
-export declare function getLocatorPickerRuntimeDir(repoRoot?: string): string;
-export declare function getLocatorPickerRuntimeHomeDir(repoRoot?: string): string;
-export declare function getLocatorPickerRuntimeEnv(repoRoot?: string, baseEnv?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
-export declare function getLocatorPickerSessionFilePath(sessionId: string, repoRoot?: string): string;
-export declare function getLocatorPickerCrashLogPath(sessionId: string, repoRoot?: string): string;
-export declare function removeLocatorPickerProfileDir(sessionId: string, repoRoot?: string): Promise<void>;
-export declare function removeLocatorPickerSessionFile(sessionId: string, repoRoot?: string): Promise<void>;
-export declare function clearLocatorPickerCrashLogs(repoRoot?: string): Promise<void>;
-export declare function createLocatorPickerCrashLog(logFilePath: string): Promise<void>;
-export declare function appendLocatorPickerCrashLog(logFilePath: string, message: string): Promise<void>;
-export declare function ensureLocatorPickerDirectories(repoRoot?: string): Promise<void>;
-export declare function readLocatorPickerSessionFile(sessionFilePath: string): Promise<CompanionSessionFile | null>;
-export declare function writeLocatorPickerSessionFile(sessionFilePath: string, session: Omit<CompanionSessionFile, 'updatedAt'> & {
-    updatedAt?: string;
-}): Promise<CompanionSessionFile>;
-export declare function patchLocatorPickerSessionFile(sessionFilePath: string, patch: Partial<CompanionSessionFile> | ((current: CompanionSessionFile) => Partial<CompanionSessionFile> | CompanionSessionFile)): Promise<CompanionSessionFile | null>;
+import type { CompanionSessionFile } from './types.js'
+export declare function getLocatorPickerRootDir(repoRoot?: string): string
+export declare function getLocatorPickerSessionsDir(repoRoot?: string): string
+export declare function getLocatorPickerProfilesDir(repoRoot?: string): string
+export declare function getLocatorPickerLogsDir(repoRoot?: string): string
+export declare function getLocatorPickerProfileDir(sessionId: string, repoRoot?: string): string
+export declare function getLocatorPickerRuntimeDir(repoRoot?: string): string
+export declare function getLocatorPickerRuntimeHomeDir(repoRoot?: string): string
+export declare function getLocatorPickerRuntimeEnv(repoRoot?: string, baseEnv?: NodeJS.ProcessEnv): NodeJS.ProcessEnv
+export declare function getLocatorPickerSessionFilePath(sessionId: string, repoRoot?: string): string
+export declare function getLocatorPickerCrashLogPath(sessionId: string, repoRoot?: string): string
+export declare function removeLocatorPickerProfileDir(sessionId: string, repoRoot?: string): Promise<void>
+export declare function removeLocatorPickerSessionFile(sessionId: string, repoRoot?: string): Promise<void>
+export declare function clearLocatorPickerCrashLogs(repoRoot?: string): Promise<void>
+export declare function createLocatorPickerCrashLog(logFilePath: string): Promise<void>
+export declare function appendLocatorPickerCrashLog(logFilePath: string, message: string): Promise<void>
+export declare function ensureLocatorPickerDirectories(repoRoot?: string): Promise<void>
+export declare function readLocatorPickerSessionFile(sessionFilePath: string): Promise<CompanionSessionFile | null>
+export declare function writeLocatorPickerSessionFile(
+  sessionFilePath: string,
+  session: Omit<CompanionSessionFile, 'updatedAt'> & {
+    updatedAt?: string
+  },
+): Promise<CompanionSessionFile>
+export declare function patchLocatorPickerSessionFile(
+  sessionFilePath: string,
+  patch:
+    | Partial<CompanionSessionFile>
+    | ((current: CompanionSessionFile) => Partial<CompanionSessionFile> | CompanionSessionFile),
+): Promise<CompanionSessionFile | null>

package/templates/default/packages/locator-picker-companion/dist/session-file.js

@@ -1,150 +1,162 @@
-import { randomUUID } from 'crypto';
-import { access, appendFile, mkdir, readFile, rename, rm, unlink, writeFile } from 'fs/promises';
-import path from 'path';
-const sessionFileOperationQueue = new Map();
+import { randomUUID } from 'crypto'
+import { access, appendFile, mkdir, readFile, rename, rm, unlink, writeFile } from 'fs/promises'
+import path from 'path'
+const sessionFileOperationQueue = new Map()
 function withTimestamp(session) {
-    var _a;
-    return Object.assign(Object.assign({}, session), { updatedAt: (_a = session.updatedAt) !== null && _a !== void 0 ? _a : new Date().toISOString() });
+  var _a
+  return Object.assign(Object.assign({}, session), {
+    updatedAt: (_a = session.updatedAt) !== null && _a !== void 0 ? _a : new Date().toISOString(),
+  })
 }
 export function getLocatorPickerRootDir(repoRoot = process.cwd()) {
-    return path.join(repoRoot, '.tmp', 'locator-picker');
+  return path.join(repoRoot, '.tmp', 'locator-picker')
 }
 export function getLocatorPickerSessionsDir(repoRoot = process.cwd()) {
-    return path.join(getLocatorPickerRootDir(repoRoot), 'sessions');
+  return path.join(getLocatorPickerRootDir(repoRoot), 'sessions')
 }
 export function getLocatorPickerProfilesDir(repoRoot = process.cwd()) {
-    return path.join(getLocatorPickerRootDir(repoRoot), 'profiles');
+  return path.join(getLocatorPickerRootDir(repoRoot), 'profiles')
 }
 export function getLocatorPickerLogsDir(repoRoot = process.cwd()) {
-    return path.join(getLocatorPickerRootDir(repoRoot), 'logs');
+  return path.join(getLocatorPickerRootDir(repoRoot), 'logs')
 }
 export function getLocatorPickerProfileDir(sessionId, repoRoot = process.cwd()) {
-    return path.join(getLocatorPickerProfilesDir(repoRoot), sessionId);
+  return path.join(getLocatorPickerProfilesDir(repoRoot), sessionId)
 }
 export function getLocatorPickerRuntimeDir(repoRoot = process.cwd()) {
-    return path.join(getLocatorPickerRootDir(repoRoot), 'runtime');
+  return path.join(getLocatorPickerRootDir(repoRoot), 'runtime')
 }
 export function getLocatorPickerRuntimeHomeDir(repoRoot = process.cwd()) {
-    return path.join(getLocatorPickerRuntimeDir(repoRoot), 'home');
+  return path.join(getLocatorPickerRuntimeDir(repoRoot), 'home')
 }
 export function getLocatorPickerRuntimeEnv(repoRoot = process.cwd(), baseEnv = process.env) {
-    const runtimeDir = getLocatorPickerRuntimeDir(repoRoot);
-    const runtimeHomeDir = getLocatorPickerRuntimeHomeDir(repoRoot);
-    const tempDir = path.join(runtimeDir, 'tmp');
-    const configDir = path.join(runtimeDir, 'config');
-    const cacheDir = path.join(runtimeDir, 'cache');
-    const appDataDir = path.join(runtimeDir, 'appdata');
-    const localAppDataDir = path.join(runtimeDir, 'localappdata');
-    return Object.assign(Object.assign({}, baseEnv), { HOME: runtimeHomeDir, USERPROFILE: runtimeHomeDir, APPDATA: appDataDir, LOCALAPPDATA: localAppDataDir, XDG_CONFIG_HOME: configDir, XDG_CACHE_HOME: cacheDir, TMPDIR: tempDir, TMP: tempDir, TEMP: tempDir });
+  const runtimeDir = getLocatorPickerRuntimeDir(repoRoot)
+  const runtimeHomeDir = getLocatorPickerRuntimeHomeDir(repoRoot)
+  const tempDir = path.join(runtimeDir, 'tmp')
+  const configDir = path.join(runtimeDir, 'config')
+  const cacheDir = path.join(runtimeDir, 'cache')
+  const appDataDir = path.join(runtimeDir, 'appdata')
+  const localAppDataDir = path.join(runtimeDir, 'localappdata')
+  return Object.assign(Object.assign({}, baseEnv), {
+    HOME: runtimeHomeDir,
+    USERPROFILE: runtimeHomeDir,
+    APPDATA: appDataDir,
+    LOCALAPPDATA: localAppDataDir,
+    XDG_CONFIG_HOME: configDir,
+    XDG_CACHE_HOME: cacheDir,
+    TMPDIR: tempDir,
+    TMP: tempDir,
+    TEMP: tempDir,
+  })
 }
 export function getLocatorPickerSessionFilePath(sessionId, repoRoot = process.cwd()) {
-    return path.join(getLocatorPickerSessionsDir(repoRoot), `${sessionId}.json`);
+  return path.join(getLocatorPickerSessionsDir(repoRoot), `${sessionId}.json`)
 }
 export function getLocatorPickerCrashLogPath(sessionId, repoRoot = process.cwd()) {
-    return path.join(getLocatorPickerLogsDir(repoRoot), `${sessionId}.log`);
+  return path.join(getLocatorPickerLogsDir(repoRoot), `${sessionId}.log`)
 }
 export async function removeLocatorPickerProfileDir(sessionId, repoRoot = process.cwd()) {
-    await rm(getLocatorPickerProfileDir(sessionId, repoRoot), {
-        force: true,
-        recursive: true,
-    }).catch(() => undefined);
+  await rm(getLocatorPickerProfileDir(sessionId, repoRoot), {
+    force: true,
+    recursive: true,
+  }).catch(() => undefined)
 }
 export async function removeLocatorPickerSessionFile(sessionId, repoRoot = process.cwd()) {
-    await unlink(getLocatorPickerSessionFilePath(sessionId, repoRoot)).catch(() => undefined);
+  await unlink(getLocatorPickerSessionFilePath(sessionId, repoRoot)).catch(() => undefined)
 }
 export async function clearLocatorPickerCrashLogs(repoRoot = process.cwd()) {
-    await rm(getLocatorPickerLogsDir(repoRoot), {
-        force: true,
-        recursive: true,
-    }).catch(() => console.error('Failed to clear locator picker crash logs.'));
-    await mkdir(getLocatorPickerLogsDir(repoRoot), { recursive: true });
+  await rm(getLocatorPickerLogsDir(repoRoot), {
+    force: true,
+    recursive: true,
+  }).catch(() => console.error('Failed to clear locator picker crash logs.'))
+  await mkdir(getLocatorPickerLogsDir(repoRoot), { recursive: true })
 }
 export async function createLocatorPickerCrashLog(logFilePath) {
-    await mkdir(path.dirname(logFilePath), { recursive: true });
-    await writeFile(logFilePath, '', 'utf8');
+  await mkdir(path.dirname(logFilePath), { recursive: true })
+  await writeFile(logFilePath, '', 'utf8')
 }
 export async function appendLocatorPickerCrashLog(logFilePath, message) {
-    try {
-        await access(logFilePath);
-    }
-    catch (_a) {
-        return;
-    }
-    await appendFile(logFilePath, `[${new Date().toISOString()}] ${message}\n`, 'utf8');
+  try {
+    await access(logFilePath)
+  } catch (_a) {
+    return
+  }
+  await appendFile(logFilePath, `[${new Date().toISOString()}] ${message}\n`, 'utf8')
 }
 export async function ensureLocatorPickerDirectories(repoRoot = process.cwd()) {
-    const runtimeDir = getLocatorPickerRuntimeDir(repoRoot);
-    const runtimeHomeDir = getLocatorPickerRuntimeHomeDir(repoRoot);
-    const tempDir = path.join(runtimeDir, 'tmp');
-    const configDir = path.join(runtimeDir, 'config');
-    const cacheDir = path.join(runtimeDir, 'cache');
-    const appDataDir = path.join(runtimeDir, 'appdata');
-    const localAppDataDir = path.join(runtimeDir, 'localappdata');
-    await mkdir(getLocatorPickerSessionsDir(repoRoot), { recursive: true });
-    await mkdir(getLocatorPickerProfilesDir(repoRoot), { recursive: true });
-    await mkdir(getLocatorPickerLogsDir(repoRoot), { recursive: true });
-    await mkdir(runtimeHomeDir, { recursive: true });
-    await mkdir(tempDir, { recursive: true });
-    await mkdir(configDir, { recursive: true });
-    await mkdir(cacheDir, { recursive: true });
-    await mkdir(appDataDir, { recursive: true });
-    await mkdir(localAppDataDir, { recursive: true });
+  const runtimeDir = getLocatorPickerRuntimeDir(repoRoot)
+  const runtimeHomeDir = getLocatorPickerRuntimeHomeDir(repoRoot)
+  const tempDir = path.join(runtimeDir, 'tmp')
+  const configDir = path.join(runtimeDir, 'config')
+  const cacheDir = path.join(runtimeDir, 'cache')
+  const appDataDir = path.join(runtimeDir, 'appdata')
+  const localAppDataDir = path.join(runtimeDir, 'localappdata')
+  await mkdir(getLocatorPickerSessionsDir(repoRoot), { recursive: true })
+  await mkdir(getLocatorPickerProfilesDir(repoRoot), { recursive: true })
+  await mkdir(getLocatorPickerLogsDir(repoRoot), { recursive: true })
+  await mkdir(runtimeHomeDir, { recursive: true })
+  await mkdir(tempDir, { recursive: true })
+  await mkdir(configDir, { recursive: true })
+  await mkdir(cacheDir, { recursive: true })
+  await mkdir(appDataDir, { recursive: true })
+  await mkdir(localAppDataDir, { recursive: true })
 }
 export async function readLocatorPickerSessionFile(sessionFilePath) {
-    try {
-        const raw = await readFile(sessionFilePath, 'utf8');
-        return JSON.parse(raw);
-    }
-    catch (_a) {
-        return null;
-    }
+  try {
+    const raw = await readFile(sessionFilePath, 'utf8')
+    return JSON.parse(raw)
+  } catch (_a) {
+    return null
+  }
 }
 async function enqueueSessionFileOperation(sessionFilePath, operation) {
-    var _a;
-    const previousOperation = (_a = sessionFileOperationQueue.get(sessionFilePath)) !== null && _a !== void 0 ? _a : Promise.resolve();
-    const nextOperation = previousOperation.catch(() => undefined).then(operation);
-    sessionFileOperationQueue.set(sessionFilePath, nextOperation);
-    try {
-        return await nextOperation;
-    }
-    finally {
-        if (sessionFileOperationQueue.get(sessionFilePath) === nextOperation) {
-            sessionFileOperationQueue.delete(sessionFilePath);
-        }
+  var _a
+  const previousOperation =
+    (_a = sessionFileOperationQueue.get(sessionFilePath)) !== null && _a !== void 0 ? _a : Promise.resolve()
+  const nextOperation = previousOperation.catch(() => undefined).then(operation)
+  sessionFileOperationQueue.set(sessionFilePath, nextOperation)
+  try {
+    return await nextOperation
+  } finally {
+    if (sessionFileOperationQueue.get(sessionFilePath) === nextOperation) {
+      sessionFileOperationQueue.delete(sessionFilePath)
     }
+  }
 }
 async function writeLocatorPickerSessionFileImmediate(sessionFilePath, session) {
-    await mkdir(path.dirname(sessionFilePath), { recursive: true });
-    const normalized = withTimestamp(session);
-    const serialized = `${JSON.stringify(normalized, null, 2)}\n`;
-    const tempFilePath = `${sessionFilePath}.${process.pid}.${randomUUID()}.tmp`;
-    try {
-        await writeFile(tempFilePath, serialized, 'utf8');
-        await rename(tempFilePath, sessionFilePath);
-    }
-    catch (error) {
-        await unlink(tempFilePath).catch(() => undefined);
-        const code = error instanceof Error && 'code' in error ? String(error.code) : '';
-        if (process.platform === 'win32' || code === 'EPERM' || code === 'EACCES' || code === 'ENOENT') {
-            await writeFile(sessionFilePath, serialized, 'utf8');
-        }
-        else {
-            throw error;
-        }
+  await mkdir(path.dirname(sessionFilePath), { recursive: true })
+  const normalized = withTimestamp(session)
+  const serialized = `${JSON.stringify(normalized, null, 2)}\n`
+  const tempFilePath = `${sessionFilePath}.${process.pid}.${randomUUID()}.tmp`
+  try {
+    await writeFile(tempFilePath, serialized, 'utf8')
+    await rename(tempFilePath, sessionFilePath)
+  } catch (error) {
+    await unlink(tempFilePath).catch(() => undefined)
+    const code = error instanceof Error && 'code' in error ? String(error.code) : ''
+    if (process.platform === 'win32' || code === 'EPERM' || code === 'EACCES' || code === 'ENOENT') {
+      await writeFile(sessionFilePath, serialized, 'utf8')
+    } else {
+      throw error
     }
-    return normalized;
+  }
+  return normalized
 }
 export async function writeLocatorPickerSessionFile(sessionFilePath, session) {
-    return enqueueSessionFileOperation(sessionFilePath, () => writeLocatorPickerSessionFileImmediate(sessionFilePath, session));
+  return enqueueSessionFileOperation(sessionFilePath, () =>
+    writeLocatorPickerSessionFileImmediate(sessionFilePath, session),
+  )
 }
 export async function patchLocatorPickerSessionFile(sessionFilePath, patch) {
-    return enqueueSessionFileOperation(sessionFilePath, async () => {
-        const current = await readLocatorPickerSessionFile(sessionFilePath);
-        if (!current) {
-            return null;
-        }
-        const nextPatch = typeof patch === 'function' ? patch(current) : patch;
-        const nextSession = Object.assign(Object.assign(Object.assign({}, current), nextPatch), { updatedAt: new Date().toISOString() });
-        return writeLocatorPickerSessionFileImmediate(sessionFilePath, nextSession);
-    });
+  return enqueueSessionFileOperation(sessionFilePath, async () => {
+    const current = await readLocatorPickerSessionFile(sessionFilePath)
+    if (!current) {
+      return null
+    }
+    const nextPatch = typeof patch === 'function' ? patch(current) : patch
+    const nextSession = Object.assign(Object.assign(Object.assign({}, current), nextPatch), {
+      updatedAt: new Date().toISOString(),
+    })
+    return writeLocatorPickerSessionFileImmediate(sessionFilePath, nextSession)
+  })
 }

package/templates/default/packages/locator-picker-companion/dist/types.d.ts

@@ -1,31 +1,31 @@
-export type CompanionSessionStatus = 'starting' | 'ready' | 'picked' | 'saving' | 'closed' | 'error';
-export type CompanionPickedLocatorStrategy = 'test-id' | 'role' | 'label' | 'placeholder' | 'id' | 'css' | 'xpath';
+export type CompanionSessionStatus = 'starting' | 'ready' | 'picked' | 'saving' | 'closed' | 'error'
+export type CompanionPickedLocatorStrategy = 'test-id' | 'role' | 'label' | 'placeholder' | 'id' | 'css' | 'xpath'
 export interface CompanionLaunchSource {
-    environmentId?: string;
-    environmentName?: string;
-    url: string;
+  environmentId?: string
+  environmentName?: string
+  url: string
 }
 export interface CompanionPickedLocatorPayload {
-    selector: string;
-    currentUrl: string;
-    pathname: string;
-    pageTitle: string;
-    tagName: string;
-    text?: string;
-    accessibleName?: string;
-    strategy?: CompanionPickedLocatorStrategy;
+  selector: string
+  currentUrl: string
+  pathname: string
+  pageTitle: string
+  tagName: string
+  text?: string
+  accessibleName?: string
+  strategy?: CompanionPickedLocatorStrategy
 }
 export interface CompanionSessionFile {
-    sessionId: string;
-    status: CompanionSessionStatus;
-    launchSource: CompanionLaunchSource;
-    currentUrl: string;
-    currentPathname: string;
-    pageTitle: string;
-    companionPid: number | null;
-    crashLogPath?: string;
-    pickedLocator?: CompanionPickedLocatorPayload;
-    error?: string;
-    startedAt: string;
-    updatedAt: string;
+  sessionId: string
+  status: CompanionSessionStatus
+  launchSource: CompanionLaunchSource
+  currentUrl: string
+  currentPathname: string
+  pageTitle: string
+  companionPid: number | null
+  crashLogPath?: string
+  pickedLocator?: CompanionPickedLocatorPayload
+  error?: string
+  startedAt: string
+  updatedAt: string
 }

package/templates/default/packages/locator-picker-companion/dist/types.js

@@ -1 +1 @@
-export {};
+export {}

package/templates/starter/.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/starter/.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/starter/.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/starter/.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/starter/.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/starter/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/starter/automation/steps/actions/click.step.ts

@@ -1,59 +1,57 @@
 import { When, Then, CustomWorld, expect, SelectorName, resolveLocator, getEnvironment, generateRandomData, RandomDataType } from '../../../packages/cucumber-runtime/src/index.js'
-/**
- * @name click
- * @description Template step for handling element click
- * @type ACTION
- */
-
-// This file is generated automatically. Add template steps to this group to generate content.
-
-/**
- * @name click
- * @description Template step for clicking on an element
- * @icon MOUSE
- */
-When('the user clicks on the {string} element', async function (this: CustomWorld, elementName: SelectorName) {
-  const selector = await resolveLocator(this.page, elementName)
-  if (!selector) {
-    throw new Error(`Selector ${elementName} not found. Current url: ${this.page.url()}`)
-  }
-  try {
-    await this.page.locator(selector).click()
-  } catch (error) {
-    throw new Error(`Failed to click on the ${elementName} element: ${error}`)
-  }
-})
-
-/**
- * @name double click
- * @description Template step for double clicking on an element
- * @icon MOUSE
- */
-When('the user double clicks on the {string} element', async function (this: CustomWorld, elementName: SelectorName) {
-  const selector = await resolveLocator(this.page, elementName)
-  if (!selector) {
-    throw new Error(`Selector ${elementName} not found. Current url: ${this.page.url()}`)
-  }
-  try {
-    await this.page.locator(selector).dblclick()
-  } catch (error) {
-    throw new Error(`Failed to double click on the ${elementName} element: ${error}`)
-  }
-})
-
-/**
- * @name right click
- * @description Template step for right clicking on an element
- * @icon MOUSE
- */
-When('the user right clicks on the {string} element', async function (this: CustomWorld, elementName: SelectorName) {
-  const selector = await resolveLocator(this.page, elementName)
-  if (!selector) {
-    throw new Error(`Selector ${elementName} not found. Current url: ${this.page.url()}`)
-  }
-  try {
-    await this.page.locator(selector).click({ button: 'right' })
-  } catch (error) {
-    throw new Error(`Failed to right click on the ${elementName} element: ${error}`)
-  }
-})
+/**
+ * @name click
+ * @description Template step for handling element click
+ * @type ACTION
+ */
+
+/**
+ * @name click
+ * @description Template step for clicking on an element
+ * @icon MOUSE
+ */
+When('the user clicks on the {string} element', async function (this: CustomWorld, elementName: SelectorName) {
+  const selector = await resolveLocator(this.page, elementName)
+  if (!selector) {
+    throw new Error(`Selector ${elementName} not found. Current url: ${this.page.url()}`)
+  }
+  try {
+    await this.page.locator(selector).click()
+  } catch (error) {
+    throw new Error(`Failed to click on the ${elementName} element: ${error}`)
+  }
+})
+
+/**
+ * @name double click
+ * @description Template step for double clicking on an element
+ * @icon MOUSE
+ */
+When('the user double clicks on the {string} element', async function (this: CustomWorld, elementName: SelectorName) {
+  const selector = await resolveLocator(this.page, elementName)
+  if (!selector) {
+    throw new Error(`Selector ${elementName} not found. Current url: ${this.page.url()}`)
+  }
+  try {
+    await this.page.locator(selector).dblclick()
+  } catch (error) {
+    throw new Error(`Failed to double click on the ${elementName} element: ${error}`)
+  }
+})
+
+/**
+ * @name right click
+ * @description Template step for right clicking on an element
+ * @icon MOUSE
+ */
+When('the user right clicks on the {string} element', async function (this: CustomWorld, elementName: SelectorName) {
+  const selector = await resolveLocator(this.page, elementName)
+  if (!selector) {
+    throw new Error(`Selector ${elementName} not found. Current url: ${this.page.url()}`)
+  }
+  try {
+    await this.page.locator(selector).click({ button: 'right' })
+  } catch (error) {
+    throw new Error(`Failed to right click on the ${elementName} element: ${error}`)
+  }
+})