@warlock.js/core 5.33.0 → 5.34.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (120) hide show
  1. package/CHANGELOG.md +36 -46
  2. package/esm/cli/commands/check/check-command.action.mjs +2 -1
  3. package/esm/cli/commands/check/check-command.action.mjs.map +1 -1
  4. package/esm/cli/commands/check.command.mjs +2 -2
  5. package/esm/cli/commands/check.command.mjs.map +1 -1
  6. package/esm/cli/commands/e2e.command.mjs +63 -0
  7. package/esm/cli/commands/e2e.command.mjs.map +1 -0
  8. package/esm/cli/commands/load-e2e-spec.mjs +47 -0
  9. package/esm/cli/commands/load-e2e-spec.mjs.map +1 -0
  10. package/esm/cli/framework-cli-commands.mjs +2 -0
  11. package/esm/cli/framework-cli-commands.mjs.map +1 -1
  12. package/esm/dev-server/health-checker/checkers/oxlint-health-checker.mjs +1 -1
  13. package/esm/dev-server/health-checker/default-health-checkers.mjs +1 -6
  14. package/esm/dev-server/health-checker/default-health-checkers.mjs.map +1 -1
  15. package/esm/dev-server/health-checker/file-health-checker.contract.d.mts +0 -2
  16. package/esm/dev-server/health-checker/file-health-checker.contract.d.mts.map +1 -1
  17. package/esm/dev-server/health-checker/file-health-result.d.mts +1 -1
  18. package/esm/dev-server/health-checker/file-health-result.mjs.map +1 -1
  19. package/esm/e2e/browser.d.mts +4 -0
  20. package/esm/e2e/browser.d.mts.map +1 -0
  21. package/esm/e2e/browser.mjs +88 -0
  22. package/esm/e2e/browser.mjs.map +1 -0
  23. package/esm/e2e/cdp.d.mts +152 -0
  24. package/esm/e2e/cdp.d.mts.map +1 -0
  25. package/esm/e2e/cdp.mjs +106 -0
  26. package/esm/e2e/cdp.mjs.map +1 -0
  27. package/esm/e2e/fixture.mjs +195 -0
  28. package/esm/e2e/fixture.mjs.map +1 -0
  29. package/esm/e2e/index.d.mts +5 -0
  30. package/esm/e2e/index.mjs +6 -0
  31. package/esm/e2e/owned-process.mjs +193 -0
  32. package/esm/e2e/owned-process.mjs.map +1 -0
  33. package/esm/e2e/page.d.mts +64 -0
  34. package/esm/e2e/page.d.mts.map +1 -0
  35. package/esm/e2e/page.mjs +376 -0
  36. package/esm/e2e/page.mjs.map +1 -0
  37. package/esm/e2e/run-e2e.d.mts +17 -0
  38. package/esm/e2e/run-e2e.d.mts.map +1 -0
  39. package/esm/e2e/run-e2e.mjs +143 -0
  40. package/esm/e2e/run-e2e.mjs.map +1 -0
  41. package/esm/e2e/types.d.mts +123 -0
  42. package/esm/e2e/types.d.mts.map +1 -0
  43. package/esm/e2e/types.mjs +24 -0
  44. package/esm/e2e/types.mjs.map +1 -0
  45. package/esm/generations/features/web.feature.mjs +7 -4
  46. package/esm/generations/features/web.feature.mjs.map +1 -1
  47. package/esm/generations/stubs.mjs +18 -35
  48. package/esm/generations/stubs.mjs.map +1 -1
  49. package/esm/index.d.mts +2 -2
  50. package/esm/secrets/errors.d.mts +1 -1
  51. package/esm/secrets/errors.d.mts.map +1 -1
  52. package/esm/secrets/errors.mjs +2 -0
  53. package/esm/secrets/errors.mjs.map +1 -1
  54. package/esm/secrets/file-backend.mjs +1 -0
  55. package/esm/secrets/file-backend.mjs.map +1 -1
  56. package/esm/secrets/index.d.mts +2 -2
  57. package/esm/secrets/keyring-backend.mjs +1 -0
  58. package/esm/secrets/keyring-backend.mjs.map +1 -1
  59. package/esm/secrets/memory-backend.d.mts +1 -0
  60. package/esm/secrets/memory-backend.d.mts.map +1 -1
  61. package/esm/secrets/memory-backend.mjs +1 -0
  62. package/esm/secrets/memory-backend.mjs.map +1 -1
  63. package/esm/secrets/resolve-driver.mjs +14 -0
  64. package/esm/secrets/resolve-driver.mjs.map +1 -0
  65. package/esm/secrets/secret-store.d.mts +4 -2
  66. package/esm/secrets/secret-store.d.mts.map +1 -1
  67. package/esm/secrets/secret-store.mjs +22 -8
  68. package/esm/secrets/secret-store.mjs.map +1 -1
  69. package/esm/secrets/secrets.d.mts +2 -0
  70. package/esm/secrets/secrets.d.mts.map +1 -1
  71. package/esm/secrets/secrets.mjs +13 -1
  72. package/esm/secrets/secrets.mjs.map +1 -1
  73. package/esm/secrets/types.d.mts +8 -0
  74. package/esm/secrets/types.d.mts.map +1 -1
  75. package/esm/tooling/check/lint-step.d.mts +3 -3
  76. package/esm/tooling/check/lint-step.d.mts.map +1 -1
  77. package/esm/tooling/check/lint-step.mjs +3 -47
  78. package/esm/tooling/check/lint-step.mjs.map +1 -1
  79. package/esm/tooling/check/run-check.d.mts +2 -2
  80. package/esm/tooling/check/run-check.mjs +4 -2
  81. package/esm/tooling/check/run-check.mjs.map +1 -1
  82. package/esm/tooling/problem.d.mts +1 -1
  83. package/esm/tooling/problem.d.mts.map +1 -1
  84. package/esm/tooling/problem.mjs.map +1 -1
  85. package/esm/updater/package-manager.mjs +5 -1
  86. package/esm/updater/package-manager.mjs.map +1 -1
  87. package/esm/upgrade/codemods/index.mjs +2 -1
  88. package/esm/upgrade/codemods/index.mjs.map +1 -1
  89. package/esm/upgrade/codemods/oxc-toolchain.mjs +59 -10
  90. package/esm/upgrade/codemods/oxc-toolchain.mjs.map +1 -1
  91. package/esm/upgrade/codemods/oxlint-rule-schemas.mjs +6 -0
  92. package/esm/upgrade/codemods/oxlint-rule-schemas.mjs.map +1 -0
  93. package/esm/upgrade/codemods/port-eslint-rules.mjs +343 -0
  94. package/esm/upgrade/codemods/port-eslint-rules.mjs.map +1 -0
  95. package/esm/upgrade/codemods/toolchain-templates.mjs +1 -1
  96. package/esm/upgrade/codemods/toolchain-templates.mjs.map +1 -1
  97. package/esm/upgrade/codemods/validate-oxlint-rule.mjs +60 -0
  98. package/esm/upgrade/codemods/validate-oxlint-rule.mjs.map +1 -0
  99. package/esm/upgrade/notes.mjs +14 -7
  100. package/esm/upgrade/notes.mjs.map +1 -1
  101. package/esm/warlock-config/types.d.mts +0 -1
  102. package/esm/warlock-config/types.d.mts.map +1 -1
  103. package/llms-full.txt +269 -44
  104. package/llms.txt +4 -3
  105. package/package.json +19 -20
  106. package/skills/create-module/SKILL.md +2 -2
  107. package/skills/run-app/SKILL.md +3 -3
  108. package/skills/store-secrets/SKILL.md +60 -2
  109. package/skills/test-browser/SKILL.md +119 -0
  110. package/skills/upgrade-from-5-29/SKILL.md +70 -29
  111. package/skills/warlock-check/SKILL.md +3 -3
  112. package/skills/warlock-doctor/SKILL.md +2 -3
  113. package/skills/write-cli-command/SKILL.md +6 -2
  114. package/esm/dev-server/health-checker/checkers/eslint-health-checker.mjs +0 -152
  115. package/esm/dev-server/health-checker/checkers/eslint-health-checker.mjs.map +0 -1
  116. package/esm/dev-server/health-checker/eslint-support.mjs +0 -27
  117. package/esm/dev-server/health-checker/eslint-support.mjs.map +0 -1
  118. package/esm/dev-server/health-checker/workers/eslint-health.worker.d.mts +0 -1
  119. package/esm/dev-server/health-checker/workers/eslint-health.worker.mjs +0 -183
  120. package/esm/dev-server/health-checker/workers/eslint-health.worker.mjs.map +0 -1
@@ -150,7 +150,7 @@ export default defineConfig({
150
150
 
151
151
  - **`watch.include` / `watch.exclude`** — globs piped into the file watcher. Override when you have non-`.ts(x)` files driving reloads (e.g. SQL fixtures), or to exclude a generated folder.
152
152
  - **`generateTypings`** — turn off if you're committing generated typings and don't want them rewritten on every boot. The `--skip-typings` flag is the per-run version.
153
- - **`healthCheckers`** — built-in switches (`{ typescript?, eslint?, oxlint? }`), custom file health checker contracts, or `false` to disable. The `--skip-health` flag disables all checkers for that run. TypeScript runs by default. ESLint uses core's dependency and requires only an app-root flat config; Oxlint requires its package installed in the app plus a config. ESLint is disabled by default; explicitly set `eslint: true` to retain it until removal in 5.34.0. Enabling it prints one deprecation warning and the Oxc migration command.
153
+ - **`healthCheckers`** — built-in switches (`{ typescript?, oxlint? }`), custom checker arrays, or `false`. TypeScript and installed/configured Oxlint run by default. `--skip-health` disables checks for one run. ESLint support was removed in 5.34.0; use `npx warlock upgrade --from 5.33 --to 5.34.0` to remove stale options.
154
154
  - **`transpileCacheDebug`** — diagnostic only. Names `.warlock/transpile/*.js` files `<slug>.<hash>.js` and appends `// @source <path>` markers so you can eyeball which cache entry came from which source. Leave off in normal use.
155
155
  - **`checkForUpdates`** — on `warlock dev` start, check npm for a newer `@warlock.js/core` and print a one-line notice if one exists. Best-effort and non-blocking; auto-skipped in CI and non-TTY shells. In an interactive terminal the notice arms a **`u` shortcut** that updates every `@warlock.js/*` package, installs, and restarts the server; elsewhere it prints `npx warlock update` instead. The registry answer is cached for 24h in `.warlock/update-check.json`, so a day of restarts costs one lookup. See the `update-packages` topic.
156
156
  - **`restartOnConfigChange`** — restart the dev server when `warlock.config.ts` or any `.env*` changes (default `true`). Set `false` to get a warning instead and restart by hand. Neither file can be hot-reloaded, so without a restart the running services keep the old values.
@@ -173,12 +173,12 @@ import { defineConfig } from "@warlock.js/core";
173
173
 
174
174
  export default defineConfig({
175
175
  devServer: {
176
- healthCheckers: { typescript: true, eslint: false, oxlint: true },
176
+ healthCheckers: { typescript: true, oxlint: true },
177
177
  },
178
178
  });
179
179
  ```
180
180
 
181
- Omit the switches to run TypeScript and installed/configured Oxlint; ESLint is off by default and requires `eslint: true`; `true` still requires the linter's config, and Oxlint also requires its app-installed package. Set `oxlint: false` to disable only Oxlint while leaving other defaults intact. A custom checker array replaces the built-in list. Config discovery also accepts `.oxlintrc.jsonc`, `oxlint.config.ts` and `oxlint.config.mts`; use JSON/JSONC on Node 22.15 because current Oxlint TypeScript configs need Node 22.18 or newer.
181
+ Omit switches to run TypeScript and installed/configured Oxlint. Set `oxlint: false` to disable only Oxlint. A custom checker array replaces the built-in list. JSON/JSONC configs work on Node 22.15; current Oxlint TypeScript configs require Node 22.18 or newer.
182
182
 
183
183
  ## `warlock build` — production bundle
184
184
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: store-secrets
3
- description: "Store app credentials with secrets.get/set/remove/has and environmentName; lazy optional OS keychain, read-only scoped environment variables, encrypted file fallback, typed SecretStoreError and memory-backed secretsFake. Use for provider keys and OAuth credentials the app must read back. Skip user passwords (hash-password) and encrypted database columns (encrypt-data)."
3
+ description: "Store app credentials with secrets.get/set/remove/has, backend() and environmentName; lazy optional OS keychain, read-only scoped environment variables, encrypted file fallback, typed SecretStoreError and memory-backed secretsFake. Use for provider keys and OAuth credentials the app must read back. Skip user passwords (hash-password) and encrypted database columns (encrypt-data)."
4
4
  ---
5
5
 
6
6
  # Application secret store
@@ -16,6 +16,7 @@ const token = await secrets.get("vendor-token"); // string | undefined
16
16
  const exists = await secrets.has("vendor-token"); // boolean; true for ""
17
17
  const removed = await secrets.remove("vendor-token"); // boolean
18
18
  const variable = secrets.environmentName("vendor-token"); // variable name, not value
19
+ const backend = await secrets.backend(); // "keychain" | "file" | "memory"; no credentials
19
20
 
20
21
  try {
21
22
  await secrets.remove("vendor-token");
@@ -32,6 +33,23 @@ Names are case-sensitive, nonempty strings of at most 256 UTF-16 code units. Val
32
33
 
33
34
  ## Configuration and backend decisions
34
35
 
36
+ Use `await secrets.backend()` or `await store.backend()` to inspect active storage.
37
+ The exported `SecretBackendType` is `"keychain" | "file" | "memory"`. Inspection
38
+ triggers core's own lazy selection and shares the memoized keychain probe with
39
+ credential operations, including concurrent calls; never run an independent probe.
40
+ It returns the selected backend, not the source of an individual secret. Scoped
41
+ environment reads do not change it. File selection does not create files or verify
42
+ the encryption key/filesystem. A later locked keychain remains `"keychain"` and
43
+ credential operations fail safely instead of silently changing selection.
44
+
45
+ Resolved `secrets.driver` overrides `SECRETS_DRIVER`: memory reports `"memory"`;
46
+ auto reports `"keychain"` after a successful initial probe or `"file"` after failure.
47
+ `secretsFake` and explicit `MemorySecretBackend` report `"memory"` without probing.
48
+ Explicit backends bypass driver configuration. Custom `SecretBackend` implementations
49
+ may declare readonly `type: SecretBackendType`; omitted metadata reports `"memory"`
50
+ for compatibility with isolated injected test backends. Core file/keychain instances
51
+ declare their own type.
52
+
35
53
  - Default namespace: app name plus the SHA-256 hash of the absolute project root. For changing release directories, configure a stable unique namespace including the deployment environment.
36
54
  - Reads: OS keychain → exact scoped environment variable → encrypted file.
37
55
  - Optional peer: `npm install @napi-rs/keyring`. Core lazily uses its 2.1.1 `AsyncEntry` API. Linux requires `secret-service` for persistence; it does not use the memory-only keyutils fallback. Sources: [official README](https://github.com/Brooooooklyn/keyring-node#readme), [published declarations](https://www.npmjs.com/package/@napi-rs/keyring?activeTab=code), verified 2026-10-19.
@@ -84,6 +102,7 @@ import type { SecretBackend, SecretStoreOptions } from "@warlock.js/core/secrets
84
102
  const backend: SecretBackend = new MemorySecretBackend();
85
103
  const options: SecretStoreOptions = { namespace: "test-app", backend };
86
104
  const store = new SecretStore(options);
105
+ await store.backend(); // "memory"
87
106
  await store.set("vendor-token", "test-credential");
88
107
  await store.get("vendor-token");
89
108
  await store.has("vendor-token");
@@ -97,6 +116,45 @@ Options also allow a `directory` and `encryptionKey` (string or lazy callback);
97
116
 
98
117
  ## Error and logging contract
99
118
 
100
- `SecretStoreError.code` is `INVALID_NAME`, `INVALID_VALUE`, `INVALID_NAMESPACE`, `READ_ONLY`, `KEY_REQUIRED`, `UNAVAILABLE`, `UNSAFE_FILE` or `CORRUPT_FILE`. Errors never include names, values, paths or vendor causes. `KEY_REQUIRED` means provision/fix the app encryption key; `CORRUPT_FILE` means wrong key, invalid format or failed authentication. Never replace an unreadable store with an empty one.
119
+ `SecretStoreError.code` is `INVALID_DRIVER`, `MEMORY_IN_PRODUCTION`, `INVALID_NAME`, `INVALID_VALUE`, `INVALID_NAMESPACE`, `READ_ONLY`, `KEY_REQUIRED`, `UNAVAILABLE`, `UNSAFE_FILE` or `CORRUPT_FILE`. Errors never include names, values, paths or vendor causes. `KEY_REQUIRED` means provision/fix the app encryption key; `CORRUPT_FILE` means wrong key, invalid format or failed authentication. Never replace an unreadable store with an empty one.
101
120
 
102
121
  The store never logs credentials. It registers encountered names and literal values with `@warlock.js/logger` for process-lifetime masking, including old/removed/failed-write values, interpolated messages, Error text/causes, and channel error reports. Keys and exact values stay protected even with permissive custom censors. Registration retains values in memory. It cannot mask direct console/third-party logging, earlier logs, transformed/encoded values, or credentials never encountered by the store. Keep secrets out of logs even with masking enabled. Fake assertion errors do not print values.
122
+
123
+ ## Built-app tests with the memory driver
124
+
125
+ Run the built server with `SECRETS_DRIVER=memory`, or select the driver in
126
+ `src/config/secrets.ts`. Explicit config takes precedence over the environment;
127
+ `"auto"` (the default) keeps keychain/environment/file behavior. Unknown driver
128
+ names fail with `SecretStoreError.code === "INVALID_DRIVER"`.
129
+
130
+ ```ts title="src/config/secrets.ts"
131
+ import type { SecretsConfigurations } from "@warlock.js/core";
132
+
133
+ export default {
134
+ namespace: "browser-test-server",
135
+ driver: "memory",
136
+ allowMemoryInProduction: true,
137
+ } satisfies SecretsConfigurations;
138
+ ```
139
+
140
+ `allowMemoryInProduction: true` is required only when the test server runs with
141
+ `NODE_ENV=production`. Without it, memory selection fails closed with
142
+ `MEMORY_IN_PRODUCTION`; a built bundle does not bypass this check. Set this
143
+ option explicitly in the test deployment configuration. `SecretStore` accepts
144
+ the same `driver` and `allowMemoryInProduction` options for standalone stores.
145
+
146
+ The selected memory driver bypasses keychain, scoped environment secrets and
147
+ files, and still registers values for log masking. Values are isolated by app
148
+ namespace, lost on process exit, and never shared across workers or with a
149
+ separate browser-test process. Seed fixtures through application startup or a
150
+ test-only endpoint in the server process using the normal `secrets.set()` API:
151
+
152
+ ```ts
153
+ import { secrets } from "@warlock.js/core";
154
+
155
+ await secrets.set("vendor-token", "browser-test-credential");
156
+ const token = await secrets.get("vendor-token");
157
+ ```
158
+
159
+ The normal test harness still installs `secretsFake`; explicit `backend`
160
+ instances and that fake continue to bypass configured backend selection.
@@ -0,0 +1,119 @@
1
+ ---
2
+ name: test-browser
3
+ description: Write or repair browser e2e specs using warlock e2e and @warlock.js/core/e2e, with owned app fixtures, direct CDP interaction, responsive screenshots and run evidence. Use for real browser flows, click races or viewport overflow; use test-http for API-only tests.
4
+ ---
5
+
6
+ # Browser e2e
7
+
8
+ Use `@warlock.js/core/e2e`, a Node-only subpath, and default-export `defineE2E` from
9
+ `e2e/*.e2e.ts`. Run `npx warlock e2e`. The CLI loads TypeScript itself; no Vitest
10
+ bootstrap, Playwright, Puppeteer or external browser server is needed.
11
+
12
+ Every run copies the app into a temporary directory, excludes dotenv files and
13
+ symlinks, links installed dependencies for reads, seeds its own environment and
14
+ owns the app/browser process groups. Keep foreground commands in the fixture;
15
+ never use a shared dev server or daemonize. Map the disposable `dataRoot` into the
16
+ app's actual storage/database config. The harness cannot infer that mapping.
17
+ `prepare` is where seeds and fake executables belong; `app.path` is relative to the
18
+ copied app. Do not install dependencies through the shared `node_modules` link.
19
+
20
+ ## Complete standalone spec
21
+
22
+ This spec creates its own small app; it can be pasted into an existing project
23
+ with core installed and run with `npx warlock e2e`.
24
+
25
+ ```ts
26
+ import { mkdir, writeFile } from "node:fs/promises";
27
+ import { join } from "node:path";
28
+ import { defineE2E } from "@warlock.js/core/e2e";
29
+
30
+ export default defineE2E({
31
+ app: {
32
+ start: [process.execPath, "form-fixture.mjs"],
33
+ portFromFile: true,
34
+ path: ["fake-bin"],
35
+ env: ({ dataRoot }) => ({ FORM_DATA: dataRoot }),
36
+ prepare: async ({ directory, dataRoot }) => {
37
+ await mkdir(join(directory, "fake-bin"));
38
+ await writeFile(join(dataRoot, "prefix.txt"), "Saved");
39
+ await writeFile(
40
+ join(directory, "form-fixture.mjs"),
41
+ `
42
+ import { createServer } from 'node:http';
43
+ import { readFileSync, writeFileSync } from 'node:fs';
44
+ import { join } from 'node:path';
45
+ const prefix = readFileSync(join(process.env.FORM_DATA, 'prefix.txt'), 'utf8');
46
+ const server = createServer((request, response) => {
47
+ if (request.url === '/favicon.ico') { response.writeHead(204); response.end(); return; }
48
+ response.setHeader('Content-Type', 'text/html');
49
+ response.end('<!doctype html><meta name="viewport" content="width=device-width,initial-scale=1">'
50
+ + '<input id="name"><button id="save"><span>Save</span></button><h1 id="result">Ready</h1>'
51
+ + '<script>document.querySelector("#save").onclick=()=>{history.pushState({},"","/saved");document.querySelector("#result").textContent='
52
+ + JSON.stringify(prefix) + '+" "+document.querySelector("#name").value}</script>');
53
+ });
54
+ server.listen(0, '127.0.0.1', () => writeFileSync(process.env.WARLOCK_E2E_PORT_FILE, String(server.address().port)));
55
+ `,
56
+ );
57
+ },
58
+ },
59
+ run: async ({ page, step }) => {
60
+ await page.goto("/");
61
+ await step("save the form", async () => {
62
+ await page.fill("#name", "Ada");
63
+ await page.type("#name", " Lovelace");
64
+ await page.waitForNavigation(() => page.click("#save"), { url: "/saved" });
65
+ await page.waitFor({ selector: "#result", text: "Saved Ada Lovelace" });
66
+ });
67
+ await page.captureViewports("saved");
68
+ },
69
+ });
70
+ ```
71
+
72
+ For an existing app, replace `prepare` and `start`; default start is
73
+ `[process.execPath, "dist/app.js"]`. Optional
74
+ `build: [process.execPath, "node_modules/@warlock.js/core/bin/warlock.js", "build"]`
75
+ builds inside the copy. Supply app-specific test service variables via `env` and
76
+ exclude production data directories with `exclude: ["storage", "data"]`.
77
+ By default the fixture supplies an OS-assigned `PORT`/`HTTP_PORT`. Prefer the
78
+ port-file handshake above when the app supports binding `0` itself.
79
+
80
+ ## Interaction and evidence
81
+
82
+ - Use `page.click` for scrolling, settled boxes and hit testing, including a fresh
83
+ check after hover. Do not replace it with `element.click()` or fixed sleeps.
84
+ - `fill` clears editable content, then sends CDP text input; `type` appends Unicode
85
+ text. Values do not appear in step names. `type` does not simulate shortcuts.
86
+ - `waitFor({ selector, text, url, timeoutMs })` combines conditions. Arm navigation
87
+ **before** clicking with `waitForNavigation(() => page.click(...))`.
88
+ - `setViewport({ name, width, height, mobile })`, `assertViewport()` and
89
+ `screenshot(name)` are available independently. `captureViewports(name)` checks
90
+ and captures 1280×800 desktop and 390×844 phone by default, restoring the
91
+ original viewport. `viewports` overrides the list. Final captures are automatic.
92
+ - Overflow compares document/body scrollWidth **and innerWidth** against the
93
+ requested width, so a phone that expands to 448 px fails. Keep the viewport meta
94
+ tag; inspect the reported widest element IDs, classes and dimensions.
95
+ - Health requires zero console errors, exceptions, HTTP statuses >=400 and failed
96
+ loads (including cancellation). Narrow exceptions use
97
+ `allowConsoleErrors: [/^Expected warning$/]` and
98
+ `allowNetworkFailures: [{ url: "/missing", status: 404 }]`. Canceled-request rules
99
+ can match `errorText`. Strings match substrings; regexps are also accepted.
100
+ - `allowPendingRequests: ["/events"]` exempts an intentional stream from network
101
+ idle, without allowing its errors. `waitForNetworkIdle()` remains available.
102
+ - `page.evaluate<T>(expression)` is an escape hatch for assertions in the main
103
+ document. Selector helpers do not enter frames or closed shadow roots.
104
+
105
+ Use `--browser /path/to/chrome` or `WARLOCK_E2E_BROWSER` if discovery fails.
106
+ `browser: { args: ["--no-sandbox"] }` is an explicit option for controlled root
107
+ containers; it is not a default. On Windows, command arrays should invoke JS tools
108
+ through `process.execPath`, avoiding `.cmd` executables that require a shell.
109
+
110
+ Read `.warlock/e2e/run-*/evidence.json` and the PNGs/logs on failure. Evidence keeps
111
+ allowed errors, step timings, viewport dimensions and recorded process identities.
112
+ `--out` changes the evidence parent; `--path ./fake-bin,./engine-bin` prepends fake
113
+ binary paths. `runE2E(spec, { outputDirectory, browser, path, signal })` is the
114
+ programmatic runner; `E2ERunError.result` exposes evidence on failure.
115
+
116
+ Cleanup verifies the unique supervisor command line before stopping only its
117
+ recorded process group (Windows: verified PID tree). It retains disposable files
118
+ if ownership verification fails and reports the failure in evidence. Do not add
119
+ process-name or port-based kills to a spec.
@@ -441,51 +441,92 @@ The CLI preserves incremental state and changed-file filtering. Development
441
441
  health checks keep one native compiler session and update its snapshots. Syntax
442
442
  analysis uses OXC. `warlock upgrade` still parses/transforms with ts-morph's own
443
443
  bundled TypeScript, without using it as the app's compiler. New scaffolds default
444
- to Oxlint/Oxfmt (`--lint=oxc`). Explicit `--lint=eslint` pins the app's compiler to
445
- TypeScript **6.0.3** because typescript-eslint requires the old JavaScript API
446
- and supports `>=4.8.4 <6.1.0`. Keep ESLint apps on 6.0.3 until switching tools:
447
-
448
- ```bash
449
- npm install --save-dev --save-exact typescript@6.0.3
450
- npx tsc --noEmit
451
- ```
452
-
453
- The same tsconfig cleanups work with TS6. Starting in 5.33, ESLint mode prints
454
- a deprecation warning naming removal in 5.34.0 and the Oxc migration command.
444
+ to Oxlint/Oxfmt (`--lint=oxc`) with TypeScript 7.0.2. ESLint support was
445
+ removed in 5.34.0; migrate legacy apps using the steps below.
455
446
 
456
447
  ## 5.32 to 5.33
457
448
 
458
- **BREAKING:** ESLint background health checking and automatic ESLint selection
459
- in `warlock check` are disabled by default. Oxlint/Oxfmt replace ESLint/Prettier
460
- as the default toolchain. Legacy support is deprecated now and removed in
461
- 5.34.0. Temporary opt-ins are `devServer.healthCheckers: { eslint: true }`,
462
- `warlock check --lint eslint`, and `create-warlock --lint=eslint`; each warns
463
- about removal and migration. The legacy scaffold stays on TypeScript 6.0.3;
464
- Oxc apps use TypeScript 7.0.2.
465
-
466
- ESLint + Prettier are deprecated in 5.33.0 and will be removed in **5.34.0**.
467
- New apps should use `--lint=oxc`. To migrate an existing app, install the new
468
- core release and `ts-morph`, then run:
449
+ The original `oxc-toolchain` codemod remains available:
469
450
 
470
451
  ```bash
471
452
  npx warlock upgrade --from 5.32 --to 5.33.0 --dry-run
472
453
  npx warlock upgrade --from 5.32 --to 5.33.0
454
+ ```
455
+
456
+ ## 5.33 to 5.34 toolchain removal
457
+
458
+ **BREAKING:** ESLint and Prettier support was removed in **5.34.0**. Oxlint/Oxfmt is the only
459
+ supported toolchain. `--lint eslint` and `healthCheckers.eslint` are removed.
460
+ Install the new core release and `ts-morph`, then migrate an existing app:
461
+
462
+ ```bash
463
+ npm install --save-dev ts-morph
464
+ npx warlock upgrade --from 5.33 --to 5.34.0 --dry-run
465
+ npx warlock upgrade --from 5.33 --to 5.34.0
473
466
  npm install
474
467
  npm run format
475
468
  npm run lint:check
476
469
  npx warlock check
477
470
  ```
478
471
 
479
- Review every reported `file:line`: customized configs are preserved and need
480
- manual translation before removal. The codemod installs the template's Oxlint
481
- and Oxfmt versions and pins TypeScript to 7.0.2. It replaces standard lint/format
482
- scripts, removes legacy dependencies, and deletes only recognized generated
483
- configs. A generated `.prettierignore` becomes `.oxfmtignore`. Existing Oxc
484
- configs are preserved. `--dry-run --json` reports the same planned changes
485
- without writing files.
472
+ The `oxc-toolchain-removal` step reapplies the preserved 5.33 `oxc-toolchain`
473
+ migration when legacy configs, scripts or dependencies remain. Apps upgrading
474
+ from 5.32 can still use `npx warlock upgrade --from 5.32 --to 5.33.0` first.
475
+ It replaces standard scripts/dependencies, pins TypeScript 7.0.2, updates generated
476
+ editor settings, removes `healthCheckers.eslint` and selects Oxlint. A generated
477
+ `.prettierignore` becomes `.oxfmtignore`; Oxfmt scripts read it explicitly.
486
478
 
487
479
  The `oxc-toolchain` codemod also updates generated VS Code settings and literal
488
480
  ESLint/Oxlint health-check switches. Custom editor settings, checker arrays,
489
481
  computed options and nonstandard scripts require review. Oxc diagnostics keep
490
482
  framework conventions in `warlock check`. Re-run the migration after addressing
491
483
  manual findings if needed; an app with only Oxc tooling is a no-op for this codemod.
484
+
485
+ ## 5.33 to 5.34 plain object validation
486
+
487
+ **BREAKING:** Seal `v.object()` rejects arrays, dates, maps, sets, class instances
488
+ and objects with custom prototypes, including under `.allowUnknown()` and
489
+ `.stripUnknown()`. Plain and null-prototype dictionaries remain accepted. There
490
+ is no permissive opt-in: choose an array/instance validator or construct a plain
491
+ DTO explicitly before validation.
492
+
493
+ ```ts
494
+ import { v } from "@warlock.js/seal";
495
+
496
+ class User {
497
+ name = "Ada";
498
+ }
499
+ const instance = new User();
500
+ const user = v.object({ name: v.string() });
501
+ await v.validate(user, { name: instance.name });
502
+ const names = v.array(v.string());
503
+ await v.validate(names, ["Ada"]);
504
+ ```
505
+
506
+ `v.record(valueValidator)` remains supported. To validate dictionary keys, use
507
+ `v.record(keyValidator, valueValidator)`; malformed arguments now fail while
508
+ defining the schema. Literal-key records infer partial dictionaries because
509
+ only present keys are checked.
510
+ Literal custom rules are translated without executing the config. Per-folder
511
+ `no-restricted-imports` and `no-restricted-exports` become Oxlint overrides with
512
+ file/exclusion patterns. Supported `@typescript-eslint/*` rules become native
513
+ `typescript/*` rules (or native base rules). Options are checked against the
514
+ pinned Oxlint 1.88.0 schema. Type-aware equivalents enable `options.typeAware`
515
+ and add `oxlint-tsgolint@7.0.2004` to the app's dev dependencies.
516
+ `unused-imports/no-unused-imports` uses `no-unused-vars` with safe import fixes;
517
+ Oxlint shares the severity for imports and variables, so differing active
518
+ severities are reported for review.
519
+
520
+ Only unsupported rules/options, computed or imported settings, selectors such
521
+ as `no-restricted-syntax`, and conflicting existing Oxc rules need manual review.
522
+ Each finding names its source `file:line`, rule and affected file patterns.
523
+ Fully ported lint configs are removed; configs with findings remain for reference
524
+ until those findings are addressed. Existing Oxc rules are kept on conflict.
525
+ `--dry-run --json` reports the same plan without writes. Customized formatting,
526
+ editor settings and nonstandard scripts can also require review.
527
+
528
+ **Upgrading:** new and migrated template configs enable
529
+ `"categories": { "correctness": "error" }`. Address the additional diagnostics;
530
+ existing Oxc configs retain their categories. A real lockfile beside a workspace
531
+ marker determines the installer: `package-lock.json` plus `pnpm-workspace.yaml`
532
+ without `pnpm-lock.yaml` now produces `npm install`.
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: warlock-check
3
- description: 'Verify a change with one command: `warlock check [--changed] [--json]` runs an incremental typecheck, the app''s ESLint/oxlint, the tests affected by the change and framework convention checks, and reports one JSON object per problem `{ code, category, severity, source, file, line, column, message, hint, skill, docs, rule }` with exit 1 for problems in your code and 2 for problems with this machine (missing Redis/DB, busy port, Node version, missing tool). Also `warlock typecheck [--changed]`, `warlock explain <CODE>` and the stable `WL` error codes (`errorCodeOf`, `WarlockError`). Triggers: `warlock check`, `warlock typecheck`, `warlock explain`, `--changed`, `--base`, `runCheck`, `runTypecheck`, `CHECK_EXIT_CODES`, `ToolingProblem`, `WL7101`, `WL8003`, `errorCodeOf`, `explainErrorCode`, `WarlockError`, "verify my change", "run the checks", "is this failure my code or the machine", "what does WL3001 mean", "typecheck only changed files". Skip: app diagnostics at boot — the `warlock-doctor` topic; reading the app''s routes/models — the `warlock-inspect` topic; writing tests — the `test-http` / `test-service` topics.'
3
+ description: 'Verify a change with one command: `warlock check [--changed] [--json]` runs an incremental typecheck, the app''s Oxlint, the tests affected by the change and framework convention checks, and reports one JSON object per problem `{ code, category, severity, source, file, line, column, message, hint, skill, docs, rule }` with exit 1 for problems in your code and 2 for problems with this machine (missing Redis/DB, busy port, Node version, missing tool). Also `warlock typecheck [--changed]`, `warlock explain <CODE>` and the stable `WL` error codes (`errorCodeOf`, `WarlockError`). Triggers: `warlock check`, `warlock typecheck`, `warlock explain`, `--changed`, `--base`, `runCheck`, `runTypecheck`, `CHECK_EXIT_CODES`, `ToolingProblem`, `WL7101`, `WL8003`, `errorCodeOf`, `explainErrorCode`, `WarlockError`, "verify my change", "run the checks", "is this failure my code or the machine", "what does WL3001 mean", "typecheck only changed files". Skip: app diagnostics at boot — the `warlock-doctor` topic; reading the app''s routes/models — the `warlock-inspect` topic; writing tests — the `test-http` / `test-service` topics.'
4
4
  ---
5
5
 
6
6
  # Warlock — `warlock check`, `typecheck`, `explain`
@@ -120,10 +120,10 @@ const types = runTypecheck({ files: ["src/app/posts/services/publish.service.ts"
120
120
  ## Gotchas
121
121
 
122
122
  - `check` boots nothing — no config, no connection, no port — so it runs the same with or without services; only tests that need them fail, and those report `WL8003`/`WL8004`.
123
- - Lint defaults to Oxlint (an app-root config + the app-installed package). No Oxlint config skips lint. A missing package reports `WL8002`. ESLint requires `--lint eslint` (or `runCheck({ lint: "eslint" })`); its flat config alone never enables it. This deprecated selection prints one warning on stderr and is removed in 5.34.0.
123
+ - Lint defaults to Oxlint (an app-root config + the app-installed package). No Oxlint config skips lint. A missing package reports `WL8002`. ESLint support was removed in 5.34.0; see `upgrade-from-5-29`.
124
124
  - Tests use the app's own vitest (`vitest run`, or `vitest related <files> --run` with `--changed`). Test files without vitest installed → `WL8002`.
125
125
  - The typecheck runs in a child `warlock typecheck` process; running out of memory is reported as `WL8007` instead of ending the run.
126
- - The convention checks are the framework's own and run the same with ESLint, Oxlint or no linter. A deliberate exception gets `// warlock-check-ignore WL9006 -- why` on the problem's line or the line above (no code = every code on that line).
126
+ - The convention checks are the framework's own and run the same with Oxlint or no linter. A deliberate exception gets `// warlock-check-ignore WL9006 -- why` on the problem's line or the line above (no code = every code on that line).
127
127
 
128
128
  ## See also
129
129
 
@@ -174,7 +174,6 @@ A `⚠ routes: 0 routes registered` line is the tell that a route module threw o
174
174
 
175
175
  `warlock doctor` checks application wiring and HTTP health probes. Use
176
176
  `npx warlock check` for source lint diagnostics and `npm run format:check` for
177
- formatting. In 5.33, Oxlint/Oxfmt are the defaults; ESLint requires
178
- `warlock check --lint eslint` or `devServer.healthCheckers.eslint: true` for
179
- background checks. ESLint/Prettier are deprecated and removed in 5.34.0.
177
+ formatting. Oxlint/Oxfmt are the only supported tools in 5.34.0. Use the
178
+ `oxc-toolchain-removal` upgrade step to migrate remaining legacy configs.
180
179
  Migrate with `npx warlock upgrade --from 5.32 --to 5.33.0` (preview with `--dry-run`).
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: write-cli-command
3
- description: 'Author a custom `warlock <my-cmd>` command via the `command()` factory — name, description, action, options, preload, then register in `warlock.config.ts > cli.commands` or drop in `src/app/<module>/commands/`. Also covers built-in `warlock add` feature scaffolding, including the Web starter and `index.register.ts`. Triggers: `command`, `CLICommand`, `CLICommandPreload`, `CLICommandOption`, `preload`, `preAction`, `persistent`, `colors`, `warlock add`, `warlock add bull-board`, `index.register.ts`; "write a custom warlock command", "one-off maintenance task", "ship a CLI from a package", "framework built-in commands"; typical import `import { command } from "@warlock.js/core"`. Skip: framework dev/build/start — the `run-app` topic; warlock.config.ts wiring — the `configure-app` topic; competing libs `commander`, `yargs`, `oclif`.'
3
+ description: 'Author a custom `warlock <my-cmd>` command via the `command()` factory — name, description, action, options, preload, then register in `warlock.config.ts > cli.commands` or drop in `src/app/<module>/commands/`. Also covers built-in `warlock add` feature scaffolding, including the Web starter and `index.setup.ts`. Triggers: `command`, `CLICommand`, `CLICommandPreload`, `CLICommandOption`, `preload`, `preAction`, `persistent`, `colors`, `warlock add`, `warlock add bull-board`, `index.setup.ts`; "write a custom warlock command", "one-off maintenance task", "ship a CLI from a package", "framework built-in commands"; typical import `import { command } from "@warlock.js/core"`. Skip: framework dev/build/start — the `run-app` topic; warlock.config.ts wiring — the `configure-app` topic; competing libs `commander`, `yargs`, `oclif`.'
4
4
  ---
5
5
 
6
6
  # Warlock — write a CLI command
@@ -230,7 +230,11 @@ Run `warlock add --list` to see what's currently registered. Pass `--packageMana
230
230
  is loaded automatically by `warlock dev` when installed, and is omitted from a
231
231
  production install with dev dependencies excluded.
232
232
 
233
- The Web starter keeps the page's universal non-component setup in `src/web/index.register.ts`, while `src/web/index.page.tsx` re-exports `register`. Warlock still discovers and runs the hook from the page namespace in both SSR and the browser, but editing the page component remains inside React's Fast Refresh boundary. Do not move the `register()` declaration inline beside the component: React Refresh treats that non-component export as incompatible and reloads the page, losing component state.
233
+ `warlock add web` creates `root.tsx` + `root.setup.ts` and `index.page.tsx` +
234
+ `index.setup.ts`. Setup files own configuration and universal `register()`
235
+ logic; UI files own components. Warlock composes the pairs on the server and
236
+ projects browser-safe registration to the client, preserving the component
237
+ Fast Refresh boundary.
234
238
 
235
239
  ### AI input measurement
236
240
 
@@ -1,152 +0,0 @@
1
- import { hasEslint, warnEslintDeprecation } from "../eslint-support.mjs";
2
- import { BaseHealthChecker } from "./base-health-checker.mjs";
3
- import { colors } from "@mongez/copper";
4
- import { ESLint } from "eslint";
5
-
6
- //#region ../../packages/core/src/dev-server/health-checker/checkers/eslint-health-checker.ts
7
- /** @deprecated Use OxlintHealthChecker. ESLint support is removed in 5.34.0. */
8
- var EslintHealthChecker = class extends BaseHealthChecker {
9
- constructor() {
10
- super();
11
- this.eslint = null;
12
- this.name = "ESLint";
13
- this.workerPath = "./workers/eslint-health.worker";
14
- this.initialized = false;
15
- warnEslintDeprecation();
16
- }
17
- /**
18
- * Check if file is a lintable file
19
- */
20
- isLintableFile(filePath) {
21
- const ext = filePath.toLowerCase();
22
- return ext.endsWith(".ts") || ext.endsWith(".tsx") || ext.endsWith(".js") || ext.endsWith(".jsx");
23
- }
24
- /**
25
- * Initialize the health checker
26
- */
27
- initialize() {
28
- try {
29
- if (!hasEslint(process.cwd())) {
30
- this.initialized = true;
31
- return this;
32
- }
33
- this.eslint = new ESLint({ cwd: process.cwd() });
34
- this.initialized = true;
35
- } catch (error) {
36
- console.warn("ESLint Health Checker: Failed to initialize:", error);
37
- this.initialized = true;
38
- }
39
- return this;
40
- }
41
- /**
42
- * Display health check results in a pretty format
43
- */
44
- displayResults(file, result) {
45
- const stats = result.getStats();
46
- if (stats.errors === 0 && stats.warnings === 0) return;
47
- const fileName = file.relativePath.replace(/\\/g, "/");
48
- const errorCount = stats.errors;
49
- const warningCount = stats.warnings;
50
- const sourceLines = file.source ? file.source.split("\n") : [];
51
- if (errorCount > 0) {
52
- const errorMessages = result.messages.filter((m) => m.type === "error");
53
- for (const error of errorMessages) {
54
- const icon = colors.redBright("✖");
55
- const level = colors.redBright(colors.bold("ERROR"));
56
- console.log(`\n${icon} ${level} ${colors.dim("in")} ${colors.cyanBright(fileName)}${colors.dim(`(${error.lineNumber},${error.columnNumber})`)}`);
57
- const ruleId = error.ruleId || "eslint";
58
- console.log(` ${colors.magentaBright(ruleId)} ${colors.dim("→")} ${colors.red(error.message)}`);
59
- if (sourceLines.length > 0 && error.lineNumber > 0 && error.lineNumber <= sourceLines.length) {
60
- const lineContent = sourceLines[error.lineNumber - 1];
61
- const lineNum = error.lineNumber.toString().padStart(4, " ");
62
- const errorLength = error.length || 1;
63
- const columnIndex = error.columnNumber - 1;
64
- console.log(` ${colors.dim(lineNum)} ${colors.dim("│")} ${lineContent || ""}`);
65
- const prefixPadding = lineNum.length + 3;
66
- const columnPadding = " ".repeat(columnIndex);
67
- const underline = colors.redBright("~".repeat(Math.max(1, errorLength)));
68
- console.log(` ${colors.dim(" ".repeat(prefixPadding))}${columnPadding}${underline}`);
69
- }
70
- }
71
- }
72
- if (warningCount > 0) {
73
- const warningMessages = result.messages.filter((m) => m.type === "warning");
74
- for (const warning of warningMessages) {
75
- const icon = colors.yellowBright("⚠");
76
- const level = colors.yellowBright(colors.bold("WARNING"));
77
- console.log(`\n${icon} ${level} ${colors.dim("in")} ${colors.cyanBright(fileName)}${colors.dim(`(${warning.lineNumber},${warning.columnNumber})`)}`);
78
- const ruleId = warning.ruleId || "eslint";
79
- console.log(` ${colors.magentaBright(ruleId)} ${colors.dim("→")} ${colors.yellow(warning.message)}`);
80
- if (sourceLines.length > 0 && warning.lineNumber > 0 && warning.lineNumber <= sourceLines.length) {
81
- const lineContent = sourceLines[warning.lineNumber - 1];
82
- const lineNum = warning.lineNumber.toString().padStart(4, " ");
83
- const warningLength = warning.length || 1;
84
- const columnIndex = warning.columnNumber - 1;
85
- console.log(` ${colors.dim(lineNum)} ${colors.dim("│")} ${lineContent || ""}`);
86
- const prefixPadding = lineNum.length + 3;
87
- const columnPadding = " ".repeat(columnIndex);
88
- const underline = colors.yellowBright("~".repeat(Math.max(1, warningLength)));
89
- console.log(` ${colors.dim(" ".repeat(prefixPadding))}${columnPadding}${underline}`);
90
- }
91
- }
92
- }
93
- const summary = [];
94
- if (errorCount > 0) summary.push(colors.red(`${errorCount} error${errorCount > 1 ? "s" : ""}`));
95
- if (warningCount > 0) summary.push(colors.yellow(`${warningCount} warning${warningCount > 1 ? "s" : ""}`));
96
- }
97
- /**
98
- * Validate the health of the file
99
- */
100
- async validate(file, result) {
101
- if (!this.isLintableFile(file.absolutePath)) {
102
- result.markAsHealthy();
103
- return result;
104
- }
105
- if (!this.eslint) {
106
- result.markAsHealthy();
107
- return result;
108
- }
109
- try {
110
- const lintResult = (await this.eslint.lintText(file.source, { filePath: file.absolutePath }))[0];
111
- if (!lintResult) {
112
- console.log("No lint results", file.relativePath);
113
- result.markAsHealthy();
114
- return result;
115
- }
116
- const errors = [];
117
- const warnings = [];
118
- for (const message of lintResult.messages) {
119
- const isError = message.severity === 2;
120
- const isWarning = message.severity === 1;
121
- if (isError) errors.push({
122
- message: message.message,
123
- type: "error",
124
- lineNumber: message.line || 1,
125
- columnNumber: message.column || 1,
126
- length: message.endColumn && message.column ? message.endColumn - message.column : 1,
127
- ruleId: message.ruleId || void 0
128
- });
129
- else if (isWarning) warnings.push({
130
- message: message.message,
131
- type: "warning",
132
- lineNumber: message.line || 1,
133
- columnNumber: message.column || 1,
134
- length: message.endColumn && message.column ? message.endColumn - message.column : 1,
135
- ruleId: message.ruleId || void 0
136
- });
137
- }
138
- if (errors.length > 0) result.addErrors(errors);
139
- if (warnings.length > 0) result.addWarnings(warnings);
140
- if (errors.length === 0 && warnings.length === 0) result.markAsHealthy();
141
- else this.displayResults(file, result);
142
- } catch (error) {
143
- console.log("ESlint Error:", error);
144
- result.markAsHealthy();
145
- }
146
- return result;
147
- }
148
- };
149
-
150
- //#endregion
151
- export { EslintHealthChecker };
152
- //# sourceMappingURL=eslint-health-checker.mjs.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"eslint-health-checker.mjs","names":[],"sources":["../../../../../../../../../../packages/core/src/dev-server/health-checker/checkers/eslint-health-checker.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport { ESLint } from \"eslint\";\nimport { hasEslint, warnEslintDeprecation } from \"../eslint-support\";\nimport type { FileManager } from \"../../file-manager\";\nimport type { FileHealthCheckerContract } from \"../file-health-checker.contract\";\nimport { FileHealthResult } from \"../file-health-result\";\nimport { BaseHealthChecker } from \"./base-health-checker\";\n\n/** @deprecated Use OxlintHealthChecker. ESLint support is removed in 5.34.0. */\nexport class EslintHealthChecker extends BaseHealthChecker implements FileHealthCheckerContract {\n public constructor() {\n super();\n // Construction happens on the main thread for both inline and worker checking.\n warnEslintDeprecation();\n }\n\n /**\n * ESLint instance (using new ESLint v9 API with flat config)\n */\n private eslint: ESLint | null = null;\n\n /**\n * Health checker name\n */\n public name: string = \"ESLint\";\n\n /**\n * Path to dedicated worker file for ESLint checking\n * Runs in a separate thread to avoid blocking the main dev server\n */\n public workerPath: string = \"./workers/eslint-health.worker\";\n\n /**\n * Whether checker is initialized\n */\n private initialized: boolean = false;\n\n /**\n * Check if file is a lintable file\n */\n private isLintableFile(filePath: string): boolean {\n const ext = filePath.toLowerCase();\n return (\n ext.endsWith(\".ts\") || ext.endsWith(\".tsx\") || ext.endsWith(\".js\") || ext.endsWith(\".jsx\")\n );\n }\n\n /**\n * Initialize the health checker\n */\n public initialize(): EslintHealthChecker {\n try {\n const hasFlatConfig = hasEslint(process.cwd());\n\n if (!hasFlatConfig) {\n // No flat config found, skip initialization\n this.initialized = true;\n return this;\n }\n\n // Use new ESLint v9 API with flat config\n // ESLint will automatically find eslint.config.js in the project root\n this.eslint = new ESLint({\n cwd: process.cwd(),\n });\n\n this.initialized = true;\n } catch (error) {\n // Handle any errors during initialization gracefully\n console.warn(\"ESLint Health Checker: Failed to initialize:\", error);\n this.initialized = true; // Mark as initialized to prevent retries\n }\n\n return this;\n }\n\n /**\n * Display health check results in a pretty format\n */\n private displayResults(file: FileManager, result: FileHealthResult): void {\n const stats = result.getStats();\n\n // Only display if there are errors or warnings\n if (stats.errors === 0 && stats.warnings === 0) {\n return;\n }\n\n const fileName = file.relativePath.replace(/\\\\/g, \"/\");\n const errorCount = stats.errors;\n const warningCount = stats.warnings;\n const sourceLines = file.source ? file.source.split(\"\\n\") : [];\n\n // Display errors\n if (errorCount > 0) {\n const errorMessages = result.messages.filter((m) => m.type === \"error\");\n for (const error of errorMessages) {\n const icon = colors.redBright(\"✖\");\n const level = colors.redBright(colors.bold(\"ERROR\"));\n console.log(\n `\\n${icon} ${level} ${colors.dim(\"in\")} ${colors.cyanBright(fileName)}${colors.dim(`(${error.lineNumber},${error.columnNumber})`)}`,\n );\n // Get rule ID from the error if available\n const ruleId = error.ruleId || \"eslint\";\n console.log(\n ` ${colors.magentaBright(ruleId)} ${colors.dim(\"→\")} ${colors.red(error.message)}`,\n );\n\n // Display code line with underline indicator\n if (\n sourceLines.length > 0 &&\n error.lineNumber > 0 &&\n error.lineNumber <= sourceLines.length\n ) {\n const lineIndex = error.lineNumber - 1; // Convert to 0-based index\n const lineContent = sourceLines[lineIndex];\n const lineNum = error.lineNumber.toString().padStart(4, \" \");\n const errorLength = error.length || 1;\n const columnIndex = error.columnNumber - 1; // Convert to 0-based index\n\n // Display the line with normal color (not all red)\n console.log(` ${colors.dim(lineNum)} ${colors.dim(\"│\")} ${lineContent || \"\"}`);\n\n // Display underline indicator\n // Padding accounts for: lineNum.length + 1 space + 1 (│) + 1 space = lineNum.length + 3\n // (The initial 2 spaces indent is already in the console.log)\n const prefixPadding = lineNum.length + 3;\n const columnPadding = \" \".repeat(columnIndex);\n const underline = colors.redBright(\"~\".repeat(Math.max(1, errorLength)));\n console.log(` ${colors.dim(\" \".repeat(prefixPadding))}${columnPadding}${underline}`);\n }\n }\n }\n\n // Display warnings\n if (warningCount > 0) {\n const warningMessages = result.messages.filter((m) => m.type === \"warning\");\n for (const warning of warningMessages) {\n const icon = colors.yellowBright(\"⚠\");\n const level = colors.yellowBright(colors.bold(\"WARNING\"));\n console.log(\n `\\n${icon} ${level} ${colors.dim(\"in\")} ${colors.cyanBright(fileName)}${colors.dim(`(${warning.lineNumber},${warning.columnNumber})`)}`,\n );\n // Get rule ID from the warning if available\n const ruleId = warning.ruleId || \"eslint\";\n console.log(\n ` ${colors.magentaBright(ruleId)} ${colors.dim(\"→\")} ${colors.yellow(warning.message)}`,\n );\n\n // Display code line with underline indicator\n if (\n sourceLines.length > 0 &&\n warning.lineNumber > 0 &&\n warning.lineNumber <= sourceLines.length\n ) {\n const lineIndex = warning.lineNumber - 1; // Convert to 0-based index\n const lineContent = sourceLines[lineIndex];\n const lineNum = warning.lineNumber.toString().padStart(4, \" \");\n const warningLength = warning.length || 1;\n const columnIndex = warning.columnNumber - 1; // Convert to 0-based index\n\n // Display the line with normal color (not all yellow)\n console.log(` ${colors.dim(lineNum)} ${colors.dim(\"│\")} ${lineContent || \"\"}`);\n\n // Display underline indicator\n // Padding accounts for: lineNum.length + 1 space + 1 (│) + 1 space = lineNum.length + 3\n // (The initial 2 spaces indent is already in the console.log)\n const prefixPadding = lineNum.length + 3;\n const columnPadding = \" \".repeat(columnIndex);\n const underline = colors.yellowBright(\"~\".repeat(Math.max(1, warningLength)));\n console.log(` ${colors.dim(\" \".repeat(prefixPadding))}${columnPadding}${underline}`);\n }\n }\n }\n\n // Display summary\n const summary = [];\n if (errorCount > 0) {\n summary.push(colors.red(`${errorCount} error${errorCount > 1 ? \"s\" : \"\"}`));\n }\n if (warningCount > 0) {\n summary.push(colors.yellow(`${warningCount} warning${warningCount > 1 ? \"s\" : \"\"}`));\n }\n }\n\n /**\n * Validate the health of the file\n */\n public async validate(file: FileManager, result: FileHealthResult): Promise<FileHealthResult> {\n // Early exit: skip non-lintable files\n if (!this.isLintableFile(file.absolutePath)) {\n result.markAsHealthy();\n return result;\n }\n\n // Early exit: check if ESLint is available\n if (!this.eslint) {\n result.markAsHealthy();\n return result;\n }\n\n try {\n // Use lintText to lint the source code directly from FileManager\n // This ensures we always use the latest content\n const lintResults = await this.eslint.lintText(file.source, {\n filePath: file.absolutePath,\n });\n\n const lintResult = lintResults[0];\n if (!lintResult) {\n console.log(\"No lint results\", file.relativePath);\n result.markAsHealthy();\n return result;\n }\n\n // Convert ESLint messages to FileHealthResult format\n const errors: Array<{\n message: string;\n type: \"error\";\n lineNumber: number;\n columnNumber: number;\n length: number;\n ruleId?: string;\n }> = [];\n const warnings: Array<{\n message: string;\n type: \"warning\";\n lineNumber: number;\n columnNumber: number;\n length: number;\n ruleId?: string;\n }> = [];\n\n for (const message of lintResult.messages) {\n const isError = message.severity === 2;\n const isWarning = message.severity === 1;\n\n if (isError) {\n errors.push({\n message: message.message,\n type: \"error\",\n lineNumber: message.line || 1,\n columnNumber: message.column || 1,\n length: message.endColumn && message.column ? message.endColumn - message.column : 1,\n ruleId: message.ruleId || undefined,\n });\n } else if (isWarning) {\n warnings.push({\n message: message.message,\n type: \"warning\",\n lineNumber: message.line || 1,\n columnNumber: message.column || 1,\n length: message.endColumn && message.column ? message.endColumn - message.column : 1,\n ruleId: message.ruleId || undefined,\n });\n }\n }\n\n // Add errors and warnings to result\n if (errors.length > 0) {\n result.addErrors(errors);\n }\n\n if (warnings.length > 0) {\n result.addWarnings(warnings);\n }\n\n // If no errors or warnings, mark as healthy\n if (errors.length === 0 && warnings.length === 0) {\n result.markAsHealthy();\n } else {\n // Display results if there are errors or warnings\n this.displayResults(file, result);\n }\n } catch (error) {\n // Handle any errors during validation gracefully\n console.log(\"ESlint Error:\", error);\n result.markAsHealthy(); // Return healthy on error to avoid blocking\n }\n\n return result;\n }\n}\n"],"mappings":"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"}