@lakestoneai/dev-config 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,33 @@
-# Temporary Holding Version
+# @lakestoneai/dev-config
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Lakestone's house defaults for code config. Each client repo imports these and keeps only its own exceptions; a fix here reaches every repo as a Renovate bump PR that the repo's own CI proves.
+
+Claude Code tooling lives in [`lakestoneai/claude-tools`](https://github.com/lakestoneai/claude-tools), not here. This package is for config that CI, Vercel and every developer machine read.
+
+## Playwright
+
+```ts
+// playwright.config.ts
+import { defineConfig } from '@playwright/test'
+import { playwrightDefaults } from '@lakestoneai/dev-config/playwright'
+
+export default defineConfig(playwrightDefaults, {
+  // this repo's own settings: testDir, webServer, projects, baseURL…
+})
+```
+
+| Setting | Value | Playwright's own default |
+|---|---|---|
+| `use.actionTimeout` | 10 s | 0 (wait forever) |
+| `use.navigationTimeout` | 30 s | 0 (wait forever) |
+
+Defaults go first: `defineConfig` merges `use` and `expect` key by key, so anything the repo sets wins, at config level or per project. A slow page needs a longer cap: set `actionTimeout` in that repo's `use`, that project's `use`, or one spec's `test.use()`.
+
+Why: with no `actionTimeout`, a click on a missing element waits forever. A normal test run is still capped by the test timeout (with a vague "Test timeout exceeded" error); Playwright's planner/generator/healer agents and scripted runs have no test timeout and hang.
+
+## Release
+
+1. Bump `version` in `package.json`, merge to `main`.
+2. Create a GitHub release tagged `v<version>`. `publish.yml` runs the tests, then publishes to npm with provenance via trusted publishing.
+
+`bun run test` proves the defaults and both override paths against a real browser.

package/package.json

@@ -1,6 +1,36 @@
 {
   "name": "@lakestoneai/dev-config",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Lakestone house defaults for code config (Playwright first). Repos import these and keep only their own exceptions.",
+  "license": "MIT",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lakestoneai/dev-config.git"
+  },
+  "exports": {
+    "./playwright": {
+      "types": "./playwright.d.ts",
+      "default": "./playwright.js"
+    }
+  },
+  "files": ["playwright.js", "playwright.d.ts"],
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@playwright/test": ">=1.40"
+  },
+  "peerDependenciesMeta": {
+    "@playwright/test": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "test": "playwright test -c test/playwright.config.ts && playwright test -c test/repo-override.config.ts"
+  },
+  "packageManager": "bun@1.4.4",
+  "devDependencies": {
+    "@playwright/test": "1.63.0"
+  }
+}

package/playwright.d.ts

@@ -0,0 +1,2 @@
+import type { PlaywrightTestConfig } from '@playwright/test'
+export declare const playwrightDefaults: PlaywrightTestConfig

package/playwright.js

@@ -0,0 +1,13 @@
+// Lakestone Playwright defaults. Merge first, repo config second:
+//   export default defineConfig(playwrightDefaults, { ...this repo's settings })
+// defineConfig shallow-merges `use` and `expect`, so a repo keeps these unless it sets the same key.
+// Playwright's own default for both timeouts is 0 = wait forever, which hangs agents and scripted runs
+// (they have no per-test timeout).
+
+/** @type {import('@playwright/test').PlaywrightTestConfig} */
+export const playwrightDefaults = {
+  use: {
+    actionTimeout: 10_000, // one click/fill/etc.
+    navigationTimeout: 30_000, // goto, waitForURL, reload
+  },
+}