@reasonabletech/config-playwright 0.1.0

package/dist/index.js

@@ -0,0 +1,253 @@
+import { devices } from '@playwright/test';
+
+// src/index.ts
+
+// src/cross-app.ts
+var EMPTY_CONFIG = {};
+var crossAppConfig = {
+  testDir: "./tests/acceptance/cross-app",
+  testMatch: "**/*.{test,spec}.{ts,js}",
+  use: {
+    // Extended timeout for cross-app navigation
+    actionTimeout: 1e4,
+    navigationTimeout: 15e3,
+    // Cross-domain configuration
+    extraHTTPHeaders: {
+      Accept: "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8"
+    },
+    // Authentication state for cross-app flows
+    storageState: "tests/fixtures/auth/cross-app-authenticated.json",
+    // Enable video for complex cross-app debugging
+    video: "retain-on-failure",
+    trace: "retain-on-failure"
+  }
+};
+function createCrossAppConfig(options) {
+  const { environments, customConfig = EMPTY_CONFIG } = options;
+  const environment = process.env.TEST_ENV ?? "development";
+  const envConfig = environments[environment];
+  if (envConfig === void 0) {
+    throw new Error(
+      `Unknown test environment "${environment}". Available environments: ${Object.keys(environments).join(", ")}`
+    );
+  }
+  const defaultBaseUrl = Object.values(envConfig.baseUrls).at(0);
+  if (defaultBaseUrl === void 0) {
+    throw new Error(
+      `Environment "${environment}" must define at least one base URL`
+    );
+  }
+  return {
+    ...baseConfig,
+    ...crossAppConfig,
+    ...customConfig,
+    use: {
+      ...baseConfig.use,
+      ...crossAppConfig.use,
+      ...customConfig.use,
+      // Set base URL to the first entry in baseUrls (typically the landing page)
+      baseURL: defaultBaseUrl
+    },
+    projects: [
+      // Desktop browsers for cross-app flows
+      {
+        name: "cross-app-chromium",
+        testDir: "./tests/acceptance/cross-app",
+        use: {
+          ...baseConfig.projects?.[0]?.use,
+          // Cross-app specific browser settings
+          viewport: { width: 1920, height: 1080 }
+        }
+      },
+      {
+        name: "cross-app-firefox",
+        testDir: "./tests/acceptance/cross-app",
+        use: {
+          ...baseConfig.projects?.[1]?.use,
+          viewport: { width: 1920, height: 1080 }
+        }
+      },
+      {
+        name: "cross-app-webkit",
+        testDir: "./tests/acceptance/cross-app",
+        use: {
+          ...baseConfig.projects?.[2]?.use,
+          viewport: { width: 1920, height: 1080 }
+        }
+      }
+    ]
+  };
+}
+var EMPTY_CONFIG2 = {};
+({
+  projects: [
+    {
+      name: "chromium",
+      use: { ...devices["Desktop Chrome"] }
+    },
+    {
+      name: "firefox",
+      use: { ...devices["Desktop Firefox"] }
+    },
+    {
+      name: "webkit",
+      use: { ...devices["Desktop Safari"] }
+    }
+  ]
+});
+({
+  projects: [
+    {
+      name: "Mobile Chrome",
+      use: { ...devices["Pixel 5"] }
+    },
+    {
+      name: "Mobile Safari",
+      use: { ...devices["iPhone 12"] }
+    }
+  ]
+});
+({
+  projects: [
+    {
+      name: "chromium",
+      use: { ...devices["Desktop Chrome"] }
+    }
+  ]
+});
+function createBaseConfig(customConfig = EMPTY_CONFIG2) {
+  return {
+    ...baseConfig,
+    ...customConfig,
+    use: {
+      ...baseConfig.use,
+      ...customConfig.use,
+      // Single-app specific settings
+      storageState: void 0
+      // No cross-app auth state by default
+    },
+    projects: customConfig.projects ?? baseConfig.projects
+  };
+}
+
+// src/index.ts
+var EMPTY_CONFIG3 = {};
+var baseConfig = {
+  // Test discovery and execution
+  testDir: "./tests/acceptance",
+  testMatch: "**/*.{test,spec}.{ts,js}",
+  // Global test settings
+  fullyParallel: true,
+  forbidOnly: Boolean(process.env.CI),
+  retries: process.env.CI !== void 0 ? 2 : 0,
+  workers: process.env.CI !== void 0 ? 4 : void 0,
+  // Test execution timeouts
+  timeout: 30 * 1e3,
+  // 30 seconds for individual tests
+  expect: {
+    timeout: 5 * 1e3
+    // 5 seconds for assertions
+  },
+  // Reporter configuration for different environments
+  reporter: [
+    ["html", { outputFolder: "./generated/playwright/reports" }],
+    ["json", { outputFile: "./generated/playwright/results.json" }],
+    process.env.CI !== void 0 ? ["github"] : ["list"]
+  ],
+  // Output folder for test results
+  outputDir: "./generated/playwright/test-results",
+  // Global test options
+  use: {
+    // Browser context settings
+    viewport: { width: 1280, height: 720 },
+    ignoreHTTPSErrors: true,
+    headless: true,
+    // Always headless by default (use --headed flag to override)
+    // Action timeouts
+    actionTimeout: 10 * 1e3,
+    // 10 seconds for actions
+    navigationTimeout: 30 * 1e3,
+    // 30 seconds for navigation
+    // Debugging and artifact collection - sensible defaults
+    trace: "on-first-retry",
+    video: "retain-on-failure",
+    screenshot: "only-on-failure",
+    // No authentication state by default (apps can override)
+    storageState: void 0
+  },
+  // Browser and device matrix
+  // Local dev: Chromium only for speed
+  // CI: Full browser matrix for compatibility testing
+  projects: process.env.CI !== void 0 ? [
+    // Desktop browsers
+    {
+      name: "chromium",
+      use: { ...devices["Desktop Chrome"] }
+    },
+    {
+      name: "firefox",
+      use: { ...devices["Desktop Firefox"] }
+    },
+    {
+      name: "webkit",
+      use: { ...devices["Desktop Safari"] }
+    },
+    // Mobile devices
+    {
+      name: "Mobile Chrome",
+      use: { ...devices["Pixel 5"] }
+    },
+    {
+      name: "Mobile Safari",
+      use: { ...devices["iPhone 12"] }
+    },
+    // Tablet devices
+    {
+      name: "iPad",
+      use: { ...devices["iPad Pro"] }
+    }
+  ] : [
+    // Local development: Chromium only for fast iteration
+    {
+      name: "chromium",
+      use: { ...devices["Desktop Chrome"] }
+    }
+  ],
+  // Development server integration - common defaults for web apps
+  webServer: process.env.CI !== void 0 ? void 0 : {
+    command: "pnpm dev",
+    reuseExistingServer: true,
+    timeout: 120 * 1e3
+    // 2 minutes to start
+  }
+};
+function createPlaywrightConfig(customConfig = EMPTY_CONFIG3) {
+  return {
+    ...baseConfig,
+    ...customConfig,
+    use: {
+      ...baseConfig.use,
+      ...customConfig.use
+    },
+    projects: customConfig.projects ?? baseConfig.projects
+  };
+}
+function createCIConfig(customConfig = EMPTY_CONFIG3) {
+  return createPlaywrightConfig({
+    ...customConfig,
+    fullyParallel: true,
+    retries: 3,
+    workers: 4,
+    use: {
+      ...customConfig.use,
+      trace: "retain-on-failure",
+      video: "retain-on-failure",
+      screenshot: "only-on-failure"
+    }
+  });
+}
+var index_default = createPlaywrightConfig;
+
+export { baseConfig, createBaseConfig, createCIConfig, createCrossAppConfig, createPlaywrightConfig, index_default as default };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cross-app.ts","../src/base.ts","../src/index.ts"],"names":["EMPTY_CONFIG","devices"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Cross-app Playwright configuration for multi-frontend testing\n * @module @reasonabletech/config-playwright/cross-app\n */\n\nimport { type PlaywrightTestConfig } from \"@playwright/test\";\nimport {\n  baseConfig,\n  type PlaywrightConfig,\n  type TestEnvironmentConfig,\n} from \"./index.js\";\n\n// Empty readonly config for default parameters\nconst EMPTY_CONFIG = {} as const satisfies PlaywrightConfig;\n\n/**\n * Cross-app specific configuration options\n */\nexport const crossAppConfig: PlaywrightTestConfig = {\n  testDir: \"./tests/acceptance/cross-app\",\n  testMatch: \"**/*.{test,spec}.{ts,js}\",\n\n  use: {\n    // Extended timeout for cross-app navigation\n    actionTimeout: 10000,\n    navigationTimeout: 15000,\n\n    // Cross-domain configuration\n    extraHTTPHeaders: {\n      Accept: \"text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8\",\n    },\n\n    // Authentication state for cross-app flows\n    storageState: \"tests/fixtures/auth/cross-app-authenticated.json\",\n\n    // Enable video for complex cross-app debugging\n    video: \"retain-on-failure\",\n    trace: \"retain-on-failure\",\n  },\n};\n\n/**\n * Accessibility testing configuration with axe-core\n */\nexport const accessibilityConfig: PlaywrightTestConfig = {\n  testDir: \"./tests/acceptance/accessibility\",\n  testMatch: \"**/*.{test,spec}.{ts,js}\",\n\n  use: {\n    // Slower execution for accessibility checks\n    actionTimeout: 15000,\n    navigationTimeout: 20000,\n  },\n};\n\n/**\n * Performance testing configuration for Lighthouse integration\n */\nexport const performanceConfig: PlaywrightTestConfig = {\n  testDir: \"./tests/acceptance/performance\",\n  testMatch: \"**/*.{test,spec}.{ts,js}\",\n\n  // Sequential execution for accurate performance measurements\n  fullyParallel: false,\n  workers: 1,\n\n  use: {\n    // Extended timeouts for performance measurements\n    actionTimeout: 30000,\n    navigationTimeout: 45000,\n\n    // Minimal interference for accurate measurements\n    video: \"off\",\n    screenshot: \"off\",\n    trace: \"off\",\n  },\n};\n\n/**\n * Options for creating a cross-domain authentication workflow configuration.\n */\nexport interface AuthWorkflowOptions {\n  /** The cookie domain (e.g. \".example.com\"). */\n  domain: string;\n  /**\n   * List of subdomains where authentication cookies should persist\n   * (e.g. [\"accounts.example.com\", \"app.example.com\"]).\n   */\n  expectedPersistence: readonly string[];\n}\n\n/**\n * Configuration shape returned by {@link createAuthWorkflowConfig}.\n */\nexport interface AuthWorkflowConfig {\n  /**\n   * Cookie settings used for cross-domain authentication.\n   */\n  readonly cookieConfig: {\n    readonly domain: string;\n    readonly secure: true;\n    readonly httpOnly: true;\n    readonly sameSite: \"lax\";\n  };\n  /**\n   * Subdomains where authentication should remain valid.\n   */\n  readonly expectedPersistence: readonly string[];\n}\n\n/**\n * Creates a cross-domain authentication configuration for the given domain.\n * @param options - Domain and persistence settings\n * @returns An authentication workflow config object\n */\nexport function createAuthWorkflowConfig(\n  options: AuthWorkflowOptions,\n): AuthWorkflowConfig {\n  return {\n    cookieConfig: {\n      domain: options.domain,\n      secure: true,\n      httpOnly: true,\n      sameSite: \"lax\" as const,\n    },\n    expectedPersistence: options.expectedPersistence,\n  } as const;\n}\n\n/**\n * Options for creating a cross-app Playwright configuration.\n */\nexport interface CrossAppConfigOptions {\n  /**\n   * Map of environment names to their configuration.\n   * The key used is determined by the `TEST_ENV` environment variable,\n   * falling back to `\"development\"`.\n   */\n  environments: Readonly<Record<string, TestEnvironmentConfig | undefined>>;\n  /** Additional Playwright configuration overrides. */\n  customConfig?: PlaywrightConfig;\n}\n\n/**\n * Creates a Playwright configuration for cross-app workflows.\n *\n * Consumers must supply their own environment map so that base URLs are not\n * hardcoded in this shared package.\n * @param options - Environments map and optional custom config overrides\n * @returns A Playwright configuration optimized for cross-app testing\n */\nexport function createCrossAppConfig(\n  options: CrossAppConfigOptions,\n): PlaywrightTestConfig {\n  const { environments, customConfig = EMPTY_CONFIG } = options;\n\n  const environment = process.env.TEST_ENV ?? \"development\";\n  const envConfig = environments[environment];\n\n  if (envConfig === undefined) {\n    throw new Error(\n      `Unknown test environment \"${environment}\". Available environments: ${Object.keys(environments).join(\", \")}`,\n    );\n  }\n\n  const defaultBaseUrl = Object.values(envConfig.baseUrls).at(0);\n\n  if (defaultBaseUrl === undefined) {\n    throw new Error(\n      `Environment \"${environment}\" must define at least one base URL`,\n    );\n  }\n\n  return {\n    ...baseConfig,\n    ...crossAppConfig,\n    ...customConfig,\n    use: {\n      ...baseConfig.use,\n      ...crossAppConfig.use,\n      ...(customConfig as PlaywrightTestConfig).use,\n      // Set base URL to the first entry in baseUrls (typically the landing page)\n      baseURL: defaultBaseUrl,\n    },\n    projects: [\n      // Desktop browsers for cross-app flows\n      {\n        name: \"cross-app-chromium\",\n        testDir: \"./tests/acceptance/cross-app\",\n        use: {\n          ...baseConfig.projects?.[0]?.use,\n          // Cross-app specific browser settings\n          viewport: { width: 1920, height: 1080 },\n        },\n      },\n      {\n        name: \"cross-app-firefox\",\n        testDir: \"./tests/acceptance/cross-app\",\n        use: {\n          ...baseConfig.projects?.[1]?.use,\n          viewport: { width: 1920, height: 1080 },\n        },\n      },\n      {\n        name: \"cross-app-webkit\",\n        testDir: \"./tests/acceptance/cross-app\",\n        use: {\n          ...baseConfig.projects?.[2]?.use,\n          viewport: { width: 1920, height: 1080 },\n        },\n      },\n    ],\n  };\n}\n\n/**\n * Creates a configuration for accessibility testing with axe-core\n * @param customConfig - Additional configuration options\n * @returns A Playwright configuration with accessibility testing setup\n */\nexport function createAccessibilityConfig(\n  customConfig: PlaywrightConfig = EMPTY_CONFIG,\n): PlaywrightTestConfig {\n  return {\n    ...baseConfig,\n    ...accessibilityConfig,\n    ...customConfig,\n    use: {\n      ...baseConfig.use,\n      ...accessibilityConfig.use,\n      ...(customConfig as PlaywrightTestConfig).use,\n    },\n    projects: [\n      {\n        name: \"accessibility-chromium\",\n        testDir: \"./tests/acceptance/accessibility\",\n        use: {\n          ...baseConfig.projects?.[0]?.use,\n          viewport: { width: 1280, height: 720 },\n        },\n      },\n    ],\n  };\n}\n\n/**\n * Creates a configuration for performance testing with Lighthouse\n * @param customConfig - Additional configuration options\n * @returns A Playwright configuration with performance testing setup\n */\nexport function createPerformanceConfig(\n  customConfig: PlaywrightConfig = EMPTY_CONFIG,\n): PlaywrightTestConfig {\n  return {\n    ...baseConfig,\n    ...performanceConfig,\n    ...customConfig,\n    use: {\n      ...baseConfig.use,\n      ...performanceConfig.use,\n      ...(customConfig as PlaywrightTestConfig).use,\n    },\n    projects: [\n      {\n        name: \"performance-chromium\",\n        testDir: \"./tests/acceptance/performance\",\n        use: {\n          ...baseConfig.projects?.[0]?.use,\n          viewport: { width: 1920, height: 1080 },\n        },\n      },\n    ],\n  };\n}\n\n/**\n * Creates a configuration optimized for authentication workflow testing\n * @param options - Cross-app config options (environments map and optional custom config)\n * @returns A Playwright configuration for auth workflow testing\n */\nexport function createAuthTestConfig(\n  options: CrossAppConfigOptions,\n): PlaywrightTestConfig {\n  const { environments, customConfig = EMPTY_CONFIG } = options;\n  return createCrossAppConfig({\n    environments,\n    customConfig: {\n      ...customConfig,\n      testDir: \"./tests/acceptance/auth\",\n      use: {\n        ...(customConfig as PlaywrightTestConfig).use,\n        // No pre-authenticated state for auth tests\n        storageState: undefined,\n      },\n    },\n  });\n}\n\nexport default createCrossAppConfig;\n","/**\n * Base browser configuration for Playwright testing\n * @module @reasonabletech/config-playwright/base\n */\n\nimport { type PlaywrightTestConfig, devices } from \"@playwright/test\";\nimport { baseConfig, type PlaywrightConfig } from \"./index.js\";\n\n// Empty readonly config for default parameters\nconst EMPTY_CONFIG = {} as const satisfies PlaywrightConfig;\n\n/**\n * Desktop-only browser configuration\n */\nexport const desktopConfig: PlaywrightTestConfig = {\n  projects: [\n    {\n      name: \"chromium\",\n      use: { ...devices[\"Desktop Chrome\"] },\n    },\n    {\n      name: \"firefox\",\n      use: { ...devices[\"Desktop Firefox\"] },\n    },\n    {\n      name: \"webkit\",\n      use: { ...devices[\"Desktop Safari\"] },\n    },\n  ],\n};\n\n/**\n * Mobile-only browser configuration\n */\nexport const mobileConfig: PlaywrightTestConfig = {\n  projects: [\n    {\n      name: \"Mobile Chrome\",\n      use: { ...devices[\"Pixel 5\"] },\n    },\n    {\n      name: \"Mobile Safari\",\n      use: { ...devices[\"iPhone 12\"] },\n    },\n  ],\n};\n\n/**\n * Chromium-only configuration for faster development testing\n */\nexport const chromiumOnlyConfig: PlaywrightTestConfig = {\n  projects: [\n    {\n      name: \"chromium\",\n      use: { ...devices[\"Desktop Chrome\"] },\n    },\n  ],\n};\n\n/**\n * Creates a base Playwright configuration for single-app testing\n * @param customConfig - Additional configuration options\n * @returns A Playwright configuration for standard single-app testing\n */\nexport function createBaseConfig(\n  customConfig: PlaywrightConfig = EMPTY_CONFIG,\n): PlaywrightTestConfig {\n  return {\n    ...baseConfig,\n    ...customConfig,\n    use: {\n      ...baseConfig.use,\n      ...customConfig.use,\n      // Single-app specific settings\n      storageState: undefined, // No cross-app auth state by default\n    },\n    projects: customConfig.projects ?? baseConfig.projects,\n  };\n}\n\n/**\n * Creates a desktop-only configuration for faster testing cycles\n * @param customConfig - Additional configuration options\n * @returns A Playwright configuration for desktop browsers only\n */\nexport function createDesktopConfig(\n  customConfig: PlaywrightConfig = EMPTY_CONFIG,\n): PlaywrightTestConfig {\n  return createBaseConfig({\n    ...customConfig,\n    projects: desktopConfig.projects,\n  });\n}\n\n/**\n * Creates a mobile-only configuration for mobile-specific testing\n * @param customConfig - Additional configuration options\n * @returns A Playwright configuration for mobile browsers only\n */\nexport function createMobileConfig(\n  customConfig: PlaywrightConfig = EMPTY_CONFIG,\n): PlaywrightTestConfig {\n  return createBaseConfig({\n    ...customConfig,\n    projects: mobileConfig.projects,\n  });\n}\n\n/**\n * Creates a Chromium-only configuration for development\n * @param customConfig - Additional configuration options\n * @returns A Playwright configuration for Chromium browser only\n */\nexport function createChromiumConfig(\n  customConfig: PlaywrightConfig = EMPTY_CONFIG,\n): PlaywrightTestConfig {\n  return createBaseConfig({\n    ...customConfig,\n    projects: chromiumOnlyConfig.projects,\n    workers: 1, // Single worker for development\n  });\n}\n\nexport default createBaseConfig;\n","/**\n * Base Playwright configuration for all applications\n * @module @reasonabletech/config-playwright\n */\n\nimport { type PlaywrightTestConfig, devices } from \"@playwright/test\";\n\n/**\n * Recursively makes all properties of `T` readonly.\n *\n * Useful for configuration objects defined with `as const`, ensuring callers\n * don't accidentally mutate shared config.\n */\nexport type DeepReadonly<T> = {\n  readonly [P in keyof T]: T[P] extends ReadonlyArray<infer U>\n    ? ReadonlyArray<DeepReadonly<U>>\n    : T[P] extends Array<infer U>\n      ? ReadonlyArray<DeepReadonly<U>>\n      : T[P] extends object\n        ? DeepReadonly<T[P]>\n        : T[P];\n};\n\n/**\n * Immutable Playwright config type accepted by config helpers.\n */\nexport type PlaywrightConfig = DeepReadonly<PlaywrightTestConfig>;\n\n// Empty readonly config for default parameters\nconst EMPTY_CONFIG = {} as const satisfies PlaywrightConfig;\n\n/**\n * Service configuration for a test environment.\n */\nexport interface TestEnvironmentServices {\n  /** Whether to use real backend services instead of mocks. */\n  useRealServices: boolean;\n  /** Whether to mock external (third-party) API calls. */\n  mockExternalAPIs: boolean;\n}\n\n/**\n * Configuration for a single test environment (e.g. development, staging, production).\n *\n * Consumers define their own environment map and pass it to helpers like\n * {@link createCrossAppConfig} in `cross-app.ts`.\n */\nexport interface TestEnvironmentConfig {\n  /** Map of application names to their base URLs. */\n  baseUrls: Record<string, string>;\n  /** Service-layer settings for this environment. */\n  services: TestEnvironmentServices;\n  /** When true, only smoke tests should run (e.g. in production). */\n  smokeTestsOnly?: boolean;\n}\n\n/**\n * Base configuration options that apply to all acceptance test environments\n */\nexport const baseConfig: PlaywrightTestConfig = {\n  // Test discovery and execution\n  testDir: \"./tests/acceptance\",\n  testMatch: \"**/*.{test,spec}.{ts,js}\",\n\n  // Global test settings\n  fullyParallel: true,\n  forbidOnly: Boolean(process.env.CI),\n  retries: process.env.CI !== undefined ? 2 : 0,\n  workers: process.env.CI !== undefined ? 4 : undefined,\n\n  // Test execution timeouts\n  timeout: 30 * 1000, // 30 seconds for individual tests\n  expect: {\n    timeout: 5 * 1000, // 5 seconds for assertions\n  },\n\n  // Reporter configuration for different environments\n  reporter: [\n    [\"html\", { outputFolder: \"./generated/playwright/reports\" }],\n    [\"json\", { outputFile: \"./generated/playwright/results.json\" }],\n    process.env.CI !== undefined ? [\"github\"] : [\"list\"],\n  ],\n\n  // Output folder for test results\n  outputDir: \"./generated/playwright/test-results\",\n\n  // Global test options\n  use: {\n    // Browser context settings\n    viewport: { width: 1280, height: 720 },\n    ignoreHTTPSErrors: true,\n    headless: true, // Always headless by default (use --headed flag to override)\n\n    // Action timeouts\n    actionTimeout: 10 * 1000, // 10 seconds for actions\n    navigationTimeout: 30 * 1000, // 30 seconds for navigation\n\n    // Debugging and artifact collection - sensible defaults\n    trace: \"on-first-retry\",\n    video: \"retain-on-failure\",\n    screenshot: \"only-on-failure\",\n\n    // No authentication state by default (apps can override)\n    storageState: undefined,\n  },\n\n  // Browser and device matrix\n  // Local dev: Chromium only for speed\n  // CI: Full browser matrix for compatibility testing\n  projects:\n    process.env.CI !== undefined\n      ? [\n          // Desktop browsers\n          {\n            name: \"chromium\",\n            use: { ...devices[\"Desktop Chrome\"] },\n          },\n          {\n            name: \"firefox\",\n            use: { ...devices[\"Desktop Firefox\"] },\n          },\n          {\n            name: \"webkit\",\n            use: { ...devices[\"Desktop Safari\"] },\n          },\n\n          // Mobile devices\n          {\n            name: \"Mobile Chrome\",\n            use: { ...devices[\"Pixel 5\"] },\n          },\n          {\n            name: \"Mobile Safari\",\n            use: { ...devices[\"iPhone 12\"] },\n          },\n\n          // Tablet devices\n          {\n            name: \"iPad\",\n            use: { ...devices[\"iPad Pro\"] },\n          },\n        ]\n      : [\n          // Local development: Chromium only for fast iteration\n          {\n            name: \"chromium\",\n            use: { ...devices[\"Desktop Chrome\"] },\n          },\n        ],\n\n  // Development server integration - common defaults for web apps\n  webServer:\n    process.env.CI !== undefined\n      ? undefined\n      : {\n          command: \"pnpm dev\",\n          reuseExistingServer: true,\n          timeout: 120 * 1000, // 2 minutes to start\n        },\n};\n\n/**\n * Creates a merged configuration from the base and any custom options\n * @param customConfig - Additional configuration options\n * @returns A merged Playwright configuration\n */\nexport function createPlaywrightConfig(\n  customConfig: PlaywrightConfig = EMPTY_CONFIG,\n): PlaywrightTestConfig {\n  return {\n    ...baseConfig,\n    ...customConfig,\n    use: {\n      ...baseConfig.use,\n      ...customConfig.use,\n    },\n    projects: customConfig.projects ?? baseConfig.projects,\n  };\n}\n\n/**\n * Creates a configuration optimized for CI/CD environments\n * @param customConfig - Additional configuration options\n * @returns A Playwright configuration optimized for CI/CD\n */\nexport function createCIConfig(\n  customConfig: PlaywrightConfig = EMPTY_CONFIG,\n): PlaywrightTestConfig {\n  return createPlaywrightConfig({\n    ...customConfig,\n    fullyParallel: true,\n    retries: 3,\n    workers: 4,\n    use: {\n      ...customConfig.use,\n      trace: \"retain-on-failure\",\n      video: \"retain-on-failure\",\n      screenshot: \"only-on-failure\",\n    },\n  });\n}\n\n// Re-export for convenience\nexport { createCrossAppConfig } from \"./cross-app.js\";\nexport { createBaseConfig } from \"./base.js\";\n\nexport default createPlaywrightConfig;\n"]}

package/dist/src/base.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Base browser configuration for Playwright testing
+ * @module @reasonabletech/config-playwright/base
+ */
+import { type PlaywrightTestConfig } from "@playwright/test";
+import { type PlaywrightConfig } from "./index.js";
+/**
+ * Desktop-only browser configuration
+ */
+export declare const desktopConfig: PlaywrightTestConfig;
+/**
+ * Mobile-only browser configuration
+ */
+export declare const mobileConfig: PlaywrightTestConfig;
+/**
+ * Chromium-only configuration for faster development testing
+ */
+export declare const chromiumOnlyConfig: PlaywrightTestConfig;
+/**
+ * Creates a base Playwright configuration for single-app testing
+ * @param customConfig - Additional configuration options
+ * @returns A Playwright configuration for standard single-app testing
+ */
+export declare function createBaseConfig(customConfig?: PlaywrightConfig): PlaywrightTestConfig;
+/**
+ * Creates a desktop-only configuration for faster testing cycles
+ * @param customConfig - Additional configuration options
+ * @returns A Playwright configuration for desktop browsers only
+ */
+export declare function createDesktopConfig(customConfig?: PlaywrightConfig): PlaywrightTestConfig;
+/**
+ * Creates a mobile-only configuration for mobile-specific testing
+ * @param customConfig - Additional configuration options
+ * @returns A Playwright configuration for mobile browsers only
+ */
+export declare function createMobileConfig(customConfig?: PlaywrightConfig): PlaywrightTestConfig;
+/**
+ * Creates a Chromium-only configuration for development
+ * @param customConfig - Additional configuration options
+ * @returns A Playwright configuration for Chromium browser only
+ */
+export declare function createChromiumConfig(customConfig?: PlaywrightConfig): PlaywrightTestConfig;
+export default createBaseConfig;
+//# sourceMappingURL=base.d.ts.map

package/dist/src/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/base.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,KAAK,oBAAoB,EAAW,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAc,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAK/D;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,oBAe3B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,oBAW1B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,oBAOhC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,YAAY,GAAE,gBAA+B,GAC5C,oBAAoB,CAYtB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,GAAE,gBAA+B,GAC5C,oBAAoB,CAKtB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,GAAE,gBAA+B,GAC5C,oBAAoB,CAKtB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,GAAE,gBAA+B,GAC5C,oBAAoB,CAMtB;AAED,eAAe,gBAAgB,CAAC"}

package/dist/src/cross-app.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Cross-app Playwright configuration for multi-frontend testing
+ * @module @reasonabletech/config-playwright/cross-app
+ */
+import { type PlaywrightTestConfig } from "@playwright/test";
+import { type PlaywrightConfig, type TestEnvironmentConfig } from "./index.js";
+/**
+ * Cross-app specific configuration options
+ */
+export declare const crossAppConfig: PlaywrightTestConfig;
+/**
+ * Accessibility testing configuration with axe-core
+ */
+export declare const accessibilityConfig: PlaywrightTestConfig;
+/**
+ * Performance testing configuration for Lighthouse integration
+ */
+export declare const performanceConfig: PlaywrightTestConfig;
+/**
+ * Options for creating a cross-domain authentication workflow configuration.
+ */
+export interface AuthWorkflowOptions {
+    /** The cookie domain (e.g. ".example.com"). */
+    domain: string;
+    /**
+     * List of subdomains where authentication cookies should persist
+     * (e.g. ["accounts.example.com", "app.example.com"]).
+     */
+    expectedPersistence: readonly string[];
+}
+/**
+ * Configuration shape returned by {@link createAuthWorkflowConfig}.
+ */
+export interface AuthWorkflowConfig {
+    /**
+     * Cookie settings used for cross-domain authentication.
+     */
+    readonly cookieConfig: {
+        readonly domain: string;
+        readonly secure: true;
+        readonly httpOnly: true;
+        readonly sameSite: "lax";
+    };
+    /**
+     * Subdomains where authentication should remain valid.
+     */
+    readonly expectedPersistence: readonly string[];
+}
+/**
+ * Creates a cross-domain authentication configuration for the given domain.
+ * @param options - Domain and persistence settings
+ * @returns An authentication workflow config object
+ */
+export declare function createAuthWorkflowConfig(options: AuthWorkflowOptions): AuthWorkflowConfig;
+/**
+ * Options for creating a cross-app Playwright configuration.
+ */
+export interface CrossAppConfigOptions {
+    /**
+     * Map of environment names to their configuration.
+     * The key used is determined by the `TEST_ENV` environment variable,
+     * falling back to `"development"`.
+     */
+    environments: Readonly<Record<string, TestEnvironmentConfig | undefined>>;
+    /** Additional Playwright configuration overrides. */
+    customConfig?: PlaywrightConfig;
+}
+/**
+ * Creates a Playwright configuration for cross-app workflows.
+ *
+ * Consumers must supply their own environment map so that base URLs are not
+ * hardcoded in this shared package.
+ * @param options - Environments map and optional custom config overrides
+ * @returns A Playwright configuration optimized for cross-app testing
+ */
+export declare function createCrossAppConfig(options: CrossAppConfigOptions): PlaywrightTestConfig;
+/**
+ * Creates a configuration for accessibility testing with axe-core
+ * @param customConfig - Additional configuration options
+ * @returns A Playwright configuration with accessibility testing setup
+ */
+export declare function createAccessibilityConfig(customConfig?: PlaywrightConfig): PlaywrightTestConfig;
+/**
+ * Creates a configuration for performance testing with Lighthouse
+ * @param customConfig - Additional configuration options
+ * @returns A Playwright configuration with performance testing setup
+ */
+export declare function createPerformanceConfig(customConfig?: PlaywrightConfig): PlaywrightTestConfig;
+/**
+ * Creates a configuration optimized for authentication workflow testing
+ * @param options - Cross-app config options (environments map and optional custom config)
+ * @returns A Playwright configuration for auth workflow testing
+ */
+export declare function createAuthTestConfig(options: CrossAppConfigOptions): PlaywrightTestConfig;
+export default createCrossAppConfig;
+//# sourceMappingURL=cross-app.d.ts.map

package/dist/src/cross-app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-app.d.ts","sourceRoot":"","sources":["../../src/cross-app.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,KAAK,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC3B,MAAM,YAAY,CAAC;AAKpB;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,oBAqB5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,oBASjC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,oBAkB/B,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE;QACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;QACtB,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;QACxB,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC;KAC1B,CAAC;IACF;;OAEG;IACH,QAAQ,CAAC,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAC;CACjD;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,mBAAmB,GAC3B,kBAAkB,CAUpB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,qBAAqB,GAAG,SAAS,CAAC,CAAC,CAAC;IAC1E,qDAAqD;IACrD,YAAY,CAAC,EAAE,gBAAgB,CAAC;CACjC;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,qBAAqB,GAC7B,oBAAoB,CA4DtB;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,YAAY,GAAE,gBAA+B,GAC5C,oBAAoB,CAqBtB;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,YAAY,GAAE,gBAA+B,GAC5C,oBAAoB,CAqBtB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,qBAAqB,GAC7B,oBAAoB,CActB;AAED,eAAe,oBAAoB,CAAC"}

package/dist/src/index.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Base Playwright configuration for all applications
+ * @module @reasonabletech/config-playwright
+ */
+import { type PlaywrightTestConfig } from "@playwright/test";
+/**
+ * Recursively makes all properties of `T` readonly.
+ *
+ * Useful for configuration objects defined with `as const`, ensuring callers
+ * don't accidentally mutate shared config.
+ */
+export type DeepReadonly<T> = {
+    readonly [P in keyof T]: T[P] extends ReadonlyArray<infer U> ? ReadonlyArray<DeepReadonly<U>> : T[P] extends Array<infer U> ? ReadonlyArray<DeepReadonly<U>> : T[P] extends object ? DeepReadonly<T[P]> : T[P];
+};
+/**
+ * Immutable Playwright config type accepted by config helpers.
+ */
+export type PlaywrightConfig = DeepReadonly<PlaywrightTestConfig>;
+/**
+ * Service configuration for a test environment.
+ */
+export interface TestEnvironmentServices {
+    /** Whether to use real backend services instead of mocks. */
+    useRealServices: boolean;
+    /** Whether to mock external (third-party) API calls. */
+    mockExternalAPIs: boolean;
+}
+/**
+ * Configuration for a single test environment (e.g. development, staging, production).
+ *
+ * Consumers define their own environment map and pass it to helpers like
+ * {@link createCrossAppConfig} in `cross-app.ts`.
+ */
+export interface TestEnvironmentConfig {
+    /** Map of application names to their base URLs. */
+    baseUrls: Record<string, string>;
+    /** Service-layer settings for this environment. */
+    services: TestEnvironmentServices;
+    /** When true, only smoke tests should run (e.g. in production). */
+    smokeTestsOnly?: boolean;
+}
+/**
+ * Base configuration options that apply to all acceptance test environments
+ */
+export declare const baseConfig: PlaywrightTestConfig;
+/**
+ * Creates a merged configuration from the base and any custom options
+ * @param customConfig - Additional configuration options
+ * @returns A merged Playwright configuration
+ */
+export declare function createPlaywrightConfig(customConfig?: PlaywrightConfig): PlaywrightTestConfig;
+/**
+ * Creates a configuration optimized for CI/CD environments
+ * @param customConfig - Additional configuration options
+ * @returns A Playwright configuration optimized for CI/CD
+ */
+export declare function createCIConfig(customConfig?: PlaywrightConfig): PlaywrightTestConfig;
+export { createCrossAppConfig } from "./cross-app.js";
+export { createBaseConfig } from "./base.js";
+export default createPlaywrightConfig;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,KAAK,oBAAoB,EAAW,MAAM,kBAAkB,CAAC;AAEtE;;;;;GAKG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI;IAC5B,QAAQ,EAAE,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,aAAa,CAAC,MAAM,CAAC,CAAC,GACxD,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,GAC9B,CAAC,CAAC,CAAC,CAAC,SAAS,KAAK,CAAC,MAAM,CAAC,CAAC,GACzB,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,GAC9B,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GACjB,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAClB,CAAC,CAAC,CAAC,CAAC;CACb,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,YAAY,CAAC,oBAAoB,CAAC,CAAC;AAKlE;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,6DAA6D;IAC7D,eAAe,EAAE,OAAO,CAAC;IACzB,wDAAwD;IACxD,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,mDAAmD;IACnD,QAAQ,EAAE,uBAAuB,CAAC;IAClC,mEAAmE;IACnE,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,oBAoGxB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,GAAE,gBAA+B,GAC5C,oBAAoB,CAUtB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,YAAY,GAAE,gBAA+B,GAC5C,oBAAoB,CAatB;AAGD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE7C,eAAe,sBAAsB,CAAC"}

package/docs/README.md

@@ -0,0 +1,31 @@
+# @reasonabletech/config-playwright Documentation
+
+Reference documentation for shared Playwright configuration in the core-utils monorepo.
+
+## Start Here
+
+- [Usage Guide](./guides/usage-guide.md)
+
+## API Reference
+
+- [API Reference](./api/api-reference.md) — Factory functions, options, and preset configs
+
+## Quick Example
+
+```ts
+// playwright.config.ts
+import { createPlaywrightConfig } from "@reasonabletech/config-playwright";
+
+export default createPlaywrightConfig({
+  use: {
+    baseURL: "http://localhost:3000",
+  },
+});
+```
+
+## Monorepo Context
+
+- [Package README](../README.md)
+- [Architecture](../../../docs/architecture.md) — How packages relate
+- [Tooling](../../../docs/tooling.md) — Turbo, Changesets, Playwright details
+- [Contributing](../../../CONTRIBUTING.md)