@starci/eslint-canon-fe 6.0.2 → 7.0.0

package/docs/size-growth.md

@@ -24,6 +24,6 @@ A source file over the budget is neither new nor longer than its recorded size.
 
 **Finding code:** `HFS_SIZE_GROWTH`
 
-**Vì sao (why):** `<file>` vượt ngân sách dòng: file mới đã dài quá mức, hoặc file cũ dài hơn bản ở commit cha. Mỗi file phải nhỏ để một người đọc hết và một bài test phủ hết.
+**Why:** `<file>` exceeds the line budget: a new file is already too long, or an old file is longer than its version at the parent commit. Every file must be small enough for one person to read entirely and one test to cover entirely.
 
-**Cách sửa:** Tách phần mới sang file riêng theo trách nhiệm; một file đã vượt ngân sách chỉ được giữ nguyên hoặc ngắn lại.
+**Fix:** Split the new part into its own file by responsibility; a file already over budget may only stay the same or get shorter.

package/docs/status-colors.md

@@ -27,6 +27,6 @@ No class that paints text, an icon or a text decoration with a solid status tone
 
 **Finding code:** `FE_STYLE_TOKEN_ONLY`
 
-**Vì sao (why):** `<file>` tô chữ hoặc icon bằng tông trạng thái đặc (`<what>`, ví dụ `text-success`). Tông đặc là màu nền; dùng làm màu chữ nó đọc dưới 4.5:1 trên nền trang.
+**Why:** `<file>` colours text or an icon with a solid status tone (`<what>`, for example `text-success`). A solid tone is a background colour; used as a text colour it reads below 4.5:1 on the page background.
 
-**Cách sửa:** Đổi thành cặp mềm: `text-<tông>-soft-foreground` (kèm `bg-<tông>-soft` nếu nằm trên nền nhạt); tông đặc chỉ dùng với `bg-<tông>` và `text-<tông>-foreground`.
+**Fix:** Change to the soft pair: `text-<tone>-soft-foreground` (with `bg-<tone>-soft` if it sits on a light background); solid tones are used only with `bg-<tone>` and `text-<tone>-foreground`.

package/docs/translation.md

@@ -49,6 +49,6 @@ A template literal with substitutions is copy when its static parts contain a wo
 
 **Finding code:** `FE_I18N_LITERAL`
 
-**Vì sao (why):** Chữ `"<text>"` ở `<file>:<line>` không đi qua `t()`.
+**Why:** The text `"<text>"` at `<file>:<line>` does not go through `t()`.
 
-**Cách sửa:** Chuyển câu vào `modules/i18n/messages/<locale>.json` và đọc bằng `t("khóa")`; không có ngoại lệ và không có `vn-ok`.
+**Fix:** Move the sentence into `modules/i18n/messages/<locale>.json` and read it with `t("key")`; there is no exception and no `vn-ok`.

package/docs/transport.md

@@ -24,9 +24,9 @@ const r = await client.get(url)
 
 **Finding code:** `FE_TRANSPORT_OWNER`
 
-**Vì sao (why):** `fetch` (hoặc `Request`, `EventSource`, `sendBeacon`, thư viện HTTP khác) ở `<file>` nằm ngoài client duy nhất (`modules/api/client.ts`, hoặc `src/client.ts` của gói api dùng chung). Mỗi repo chỉ có đúng một đường truyền.
+**Why:** `fetch` (or `Request`, `EventSource`, `sendBeacon`, another HTTP library) in `<file>` is outside the single client (`modules/api/client.ts`, or `src/client.ts` of the shared api package). Each repo has exactly one transport path.
 
-**Cách sửa:** Gọi client của repo và nhận `Outcome<T>`; không tự gọi `fetch`.
+**Fix:** Call the repo's client and receive `Outcome<T>`; do not call `fetch` yourself.
 
 ## `starci-fe/client-fetch-has-signal`
 
@@ -46,9 +46,9 @@ fetch(url, { method: "GET", signal: AbortSignal.timeout(8000) })
 
 **Finding code:** `FE_TRANSPORT_OWNER`
 
-**Vì sao (why):** `fetch` ở `<file>` không có `signal`. Client bắt buộc có timeout và `AbortSignal`.
+**Why:** `fetch` in `<file>` has no `signal`. The client must have a timeout and an `AbortSignal`.
 
-**Cách sửa:** Truyền `signal` (`AbortSignal.timeout(...)` kết hợp với tín hiệu của người gọi).
+**Fix:** Pass a `signal` (`AbortSignal.timeout(...)` combined with the caller's signal).
 
 ## `starci-fe/no-shared-transport-state`
 
@@ -68,9 +68,9 @@ export const request = (token: string) => token
 
 **Finding code:** `FE_TRANSPORT_OWNER`
 
-**Vì sao (why):** `<file>` giữ trạng thái dùng chung dạng `let`/`var` trong tầng API. Token và locale không được nằm trong singleton.
+**Why:** `<file>` keeps shared `let`/`var` state in the API layer. Tokens and locale must not live in a singleton.
 
-**Cách sửa:** Truyền credential và locale bằng tham số hoặc context.
+**Fix:** Pass credentials and locale as parameters or context.
 
 ## `starci-fe/client-maps-auth-to-refused`
 
@@ -91,9 +91,9 @@ if (r.status === 401 || r.status === 403) return { ok: false, kind: "refused" }
 
 **Finding code:** `FE_HTTP_STATUS_COLLAPSE`
 
-**Vì sao (why):** Client ở `<file>` không có nhánh so sánh `response.status` với 401 và 403 rồi trả `{ kind: "refused" }`, nên trạng thái "cần đăng nhập" không bao giờ đạt được.
+**Why:** The client in `<file>` has no branch comparing `response.status` with 401 and 403 and returning `{ kind: "refused" }`, so the "sign-in required" state can never be reached.
 
-**Cách sửa:** Thêm nhánh `response.status === 401 || response.status === 403` trả `{ ok: false, kind: "refused" }` ngay trong client.
+**Fix:** Add a branch `response.status === 401 || response.status === 403` returning `{ ok: false, kind: "refused" }` inside the client.
 
 ## `starci-fe/no-http-status-collapse`
 
@@ -113,9 +113,9 @@ if (!res.ok) return toOutcome(res.status)
 
 **Finding code:** `FE_HTTP_STATUS_COLLAPSE`
 
-**Vì sao (why):** `<file>` gộp mọi mã HTTP thành một nhánh (hoặc trả null khi phản hồi lỗi). 401/403 phải thành `refused`.
+**Why:** `<file>` collapses every HTTP code into one branch (or returns null on an error response). 401/403 must become `refused`.
 
-**Cách sửa:** Trả `Outcome` theo mã: `refused` (401/403), `not-found`, `invalid`, `unavailable`; không trả nguyên văn lỗi của server làm lý do.
+**Fix:** Return an `Outcome` by code: `refused` (401/403), `not-found`, `invalid`, `unavailable`; do not return the server's raw error as the reason.
 
 ## `starci-fe/no-hand-typed-wire`
 
@@ -137,9 +137,9 @@ const x: CourseQuery = parse(raw)
 
 **Finding code:** `FE_WIRE_GENERATED`
 
-**Vì sao (why):** `<file>` tự gõ kiểu wire hoặc ép kiểu phản hồi. Dùng kiểu sinh từ `contract/`.
+**Why:** `<file>` hand-types a wire type or casts a response. Use types generated from `contract/`.
 
-**Cách sửa:** Chạy codegen từ bản sao hợp đồng ở `modules/api/contract/` và nhập kiểu sinh ra; đưa tài liệu GraphQL vào tệp `.graphql`.
+**Fix:** Run codegen from the contract copy at `modules/api/contract/` and import the generated types; put GraphQL documents in `.graphql` files.
 
 ## `starci-fe/outcome-kinds-exhaustive`
 
@@ -165,9 +165,9 @@ switch (outcome.kind) {
 
 **Finding code:** `FE_OUTCOME_KIND_UNHANDLED`
 
-**Vì sao (why):** `switch` trên `kind` ở `<file>` có nhánh `ok` nhưng thiếu một trong refused, invalid, not-found, unavailable.
+**Why:** The `switch` on `kind` in `<file>` has an `ok` branch but lacks one of refused, invalid, not-found, unavailable.
 
-**Cách sửa:** Viết đủ năm nhánh của `Outcome<T>`, mỗi nhánh một màn; không dựa vào `default`.
+**Fix:** Write all five branches of `Outcome<T>`, one screen per branch; do not rely on `default`.
 
 ## `starci-fe/one-outcome-union`
 
@@ -190,6 +190,6 @@ export type InviteOutcome = Outcome<{ id: string }>
 
 **Finding code:** `FE_HTTP_STATUS_COLLAPSE`
 
-**Vì sao (why):** `<file>` khai báo thêm một union kết quả (`ok` hoặc `kind`) ngoài `outcome.ts`. Repo chỉ có một `Outcome<T>`.
+**Why:** `<file>` declares another result union (`ok` or `kind`) outside `outcome.ts`. A repo has only one `Outcome<T>`.
 
-**Cách sửa:** Dùng `Outcome<T>` của `modules/api/outcome.ts` (hoặc gói api dùng chung); thêm chi tiết nghiệp vụ qua tham số thứ hai thay vì khai báo union mới.
+**Fix:** Use `Outcome<T>` from `modules/api/outcome.ts` (or the shared api package); add business detail through a second parameter instead of declaring a new union.

package/docs/type-safety.md

@@ -24,9 +24,9 @@ const row = parseCourseRow(payload)
 
 **Finding code:** `FE_TYPE_ESCAPE`
 
-**Vì sao (why):** `<file>` ép kiểu qua `unknown` (`as unknown as T`): trình biên dịch quên mọi thứ nó biết ngay tại chỗ dữ liệu đi vào.
+**Why:** `<file>` casts through `unknown` (`as unknown as T`): the compiler forgets everything it knows exactly where the data enters.
 
-**Cách sửa:** Thu hẹp từ `unknown` bằng type guard hoặc parser; không ép kiểu.
+**Fix:** Narrow from `unknown` with a type guard or parser; do not cast.
 
 ## `starci-fe/no-type-assertion`
 
@@ -46,9 +46,9 @@ const row = isCourseRow(payload) ? payload : null
 
 **Finding code:** `FE_TYPE_ESCAPE`
 
-**Vì sao (why):** `<file>` dùng `as T` hoặc `<T>x`: một lời khẳng định trình biên dịch không kiểm được. Sai thì lỗi rơi vào trình duyệt của người dùng.
+**Why:** `<file>` uses `as T` or `<T>x`: an assertion the compiler cannot check. If wrong, the error lands in the user's browser.
 
-**Cách sửa:** Thu hẹp bằng type guard, `in`, discriminant hoặc parser tại nơi dữ liệu đi vào; dùng `satisfies` nếu chỉ muốn kiểm một literal.
+**Fix:** Narrow with a type guard, `in`, a discriminant or a parser where the data enters; use `satisfies` if you only want to check a literal.
 
 ## `starci-fe/no-non-null-assertion`
 
@@ -68,9 +68,9 @@ const first = rows[0] ?? fallbackRow
 
 **Finding code:** `FE_TYPE_ESCAPE`
 
-**Vì sao (why):** `<file>` dùng `x!`: khẳng định giá trị có mặt mà không chứng minh.
+**Why:** `<file>` uses `x!`: it asserts a value is present without proving it.
 
-**Cách sửa:** Xử lý nhánh vắng mặt (`if`, `??`, return sớm) hoặc sửa kiểu để giá trị không thể vắng.
+**Fix:** Handle the absent branch (`if`, `??`, early return) or fix the type so the value cannot be absent.
 
 ## `starci-fe/no-explicit-any`
 
@@ -90,6 +90,6 @@ const parse = (value: unknown) => (isCourseRow(value) ? value.id : null)
 
 **Finding code:** `FE_TYPE_ESCAPE`
 
-**Vì sao (why):** `<file>` dùng `any`: tắt kiểm kiểu cho giá trị đó và mọi thứ suy ra từ nó.
+**Why:** `<file>` uses `any`: it turns off type checking for that value and everything inferred from it.
 
-**Cách sửa:** Dùng kiểu thật, generic, hoặc `unknown` rồi thu hẹp tại chỗ dùng.
+**Fix:** Use a real type, a generic, or `unknown` and then narrow at the point of use.

package/env-owner.mjs

@@ -12,7 +12,7 @@
  * shape that makes it provable: one reader, and no literal fallback next to it.
  */
 
-import { isConfigModule, isSpecFile } from "./lib/scope.mjs"
+import { isConfigModule } from "./lib/scope.mjs"
 
 /** `process.env`, or `import.meta.env`. */
 const isEnvObject = (node) => {
@@ -67,7 +67,7 @@ export const noEnvOutsideConfig = {
   },
   create(context) {
     const filename = context.filename || context.getFilename()
-    if (isConfigModule(context) || isSpecFile(filename)) return {}
+    if (isConfigModule(context)) return {}
     return {
       MemberExpression(node) {
         if (isEnvObject(node)) context.report({ node, messageId: "env" })
@@ -101,7 +101,6 @@ export const noHardcodedEndpointFallback = {
     },
   },
   create(context) {
-    if (isSpecFile(context.filename || context.getFilename())) return {}
     return {
       LogicalExpression(node) {
         if (node.operator !== "??" && node.operator !== "||") return

package/file-layout.mjs

@@ -13,7 +13,7 @@
  */
 
 import { hfsOf } from "./lib/hfs.mjs"
-import { classOf, fileOf, inSlot, isComponentFile, isSpecFile, kindOfFile, roleOfFile, tierOfFile } from "./lib/scope.mjs"
+import { classOf, fileOf, inSlot, isComponentFile, kindOfFile, roleOfFile, tierOfFile } from "./lib/scope.mjs"
 
 /** The path segments of the linted file below the folder of its owner (the slot's `root`), directories only. */
 const dirsBelowRoot = (context) => {
@@ -55,9 +55,9 @@ const surfaceFolder = (context) => {
   return { tier: kind, name: bindings.name, rest: below.join("/") }
 }
 
-/** A file a surface folder may hold: one of the slot's roles (entry, drawing, styles) or a `.spec.` twin, directly in the folder. */
+/** A file a surface folder may hold: one of the slot's roles (entry, drawing, styles), directly in the folder. */
 const belongsInSurfaceFolder = (context, folder) =>
-  !folder.rest.includes("/") && (roleOfFile(context) !== null || (isSpecFile(folder.rest) && folder.rest.includes(".spec.")))
+  !folder.rest.includes("/") && roleOfFile(context) !== null
 
 // -- FILE-2 --------------------------------------------------------------------------------------
 
@@ -252,19 +252,6 @@ export const monorepoTierBelongsToItsSide = {
 
 // -- FILE-6 --------------------------------------------------------------------------------------
 
-/**
- * A test sitting beside the thing it tests.
- *
- * EXEMPT, because a test is not a component and cannot become the second page this rule exists to
- * prevent - it ships in no bundle and no route renders it. Refusing it would push route tests out of
- * the one directory where the next reader looks for them, which is the opposite of the twin-test
- * habit every other tier here follows.
- *
- * The name is deliberately not required to match `page` or `layout`. A route's tests split by
- * CONCERN - what the screen renders, who may reach it, where the boundary sits - and forcing them
- * into one `page.spec.tsx` would buy nothing but a longer file. A spec is named `.spec.` by the slot
- * definitions themselves, so that stays a file-name test.
- */
 /**
  * A file under `app/` names which page renders at which URL, and does nothing else.
  *
@@ -374,32 +361,6 @@ export const noShellTier = {
   },
 }
 
-// -- FILE-9 --------------------------------------------------------------------------------------
-
-/** Frontend units are `.spec.` twins beside the source they exercise. */
-export const unitTestColocated = {
-  meta: {
-    type: "problem",
-    docs: { description: "Frontend unit tests are colocated `.spec.` files; frontend owns no separate test tree." },
-    schema: [],
-    messages: {
-      suffix: "`{{name}}` uses the generic `.test.` suffix. A frontend unit is a colocated `.spec.` twin beside its production owner.",
-      bucket: "`{{path}}` files a frontend unit in a separate test bucket. Move the cases beside their production owner; only backend E2E owns a separate test tree.",
-    },
-  },
-  create(context) {
-    const file = fileOf(context)
-    if (!isSpecFile(file)) return {}
-    const name = file.slice(Math.max(file.lastIndexOf("/"), file.lastIndexOf("\\")) + 1)
-    return {
-      Program(node) {
-        if (name.includes(".test.")) context.report({ node, messageId: "suffix", data: { name } })
-        if (tierOfFile(context) === "e2e") context.report({ node, messageId: "bucket", data: { path: hfsOf(context).relative(file) } })
-      },
-    }
-  },
-}
-
 /**
  * The component a route slot mounts takes the slot's own name.
  *
@@ -494,7 +455,6 @@ export const rules = {
   "export-matches-folder": exportMatchesFolder,
   "no-runtime-namespace": noRuntimeNamespace,
   "monorepo-tier-belongs-to-its-side": monorepoTierBelongsToItsSide,
-  "unit-test-colocated": unitTestColocated,
 }
 
 /**

package/formatting.mjs

@@ -14,7 +14,7 @@
  * `modules/i18n/**` is exempt: it is where the formatters are configured.
  */
 
-import { fileOf, inSlot, isSpecFile } from "./lib/scope.mjs"
+import { fileOf, inSlot } from "./lib/scope.mjs"
 
 /** The locale-sensitive `Date` and `Number` methods. */
 const LOCALE_METHODS = new Set(["toLocaleString", "toLocaleDateString", "toLocaleTimeString"])
@@ -57,7 +57,7 @@ export const useIntlFormatter = {
     },
   },
   create(context) {
-    if (isSpecFile(fileOf(context)) || inSlot(context, "fe.modules.i18n")) return {}
+    if (inSlot(context, "fe.modules.i18n")) return {}
     return {
       ImportDeclaration(node) {
         const source = String(node.source.value)

package/grammar-boundary.mjs

@@ -18,7 +18,6 @@
  */
 
 import { hfsOf } from "./lib/hfs.mjs"
-import { isSpecFile } from "./lib/scope.mjs"
 
 /**
  * The intrinsic elements of page structure and text, each with the grammar components that render it.
@@ -72,7 +71,7 @@ export const noRawStructuralElement = {
   },
   create(context) {
     const file = context.filename || context.getFilename()
-    if (isSpecFile(file) || !composesGrammar(context, file)) return {}
+    if (!composesGrammar(context, file)) return {}
     return {
       JSXOpeningElement(node) {
         if (node.name.type !== "JSXIdentifier") return

package/hooks-folder.mjs

@@ -16,7 +16,7 @@
  */
 
 import { hfsOf } from "./lib/hfs.mjs"
-import { baseName, classOf, fileOf, inSlot, isSpecFile } from "./lib/scope.mjs"
+import { baseName, classOf, fileOf, inSlot } from "./lib/scope.mjs"
 
 /** Names that mark a hook. */
 const isHookName = (name) => /^use[A-Z0-9]/.test(name)
@@ -68,15 +68,14 @@ export const hooksFolderHoldsHooksOnly = {
     // A file directly in `hooks/` is its own root: the slot binds the file name as the `domain`.
     const directlyInHooks = hfsOf(context).relative(file) === found.root
     const name = baseName(file)
-    const spec = isSpecFile(file)
-    const subject = spec ? name.replace(/\.(?:test|spec)\.(?:ts|tsx)$/, ".ts") : name
+    const subject = name
     const domain = found.bindings.domain
     const isHookFile = /^use[A-Z0-9]\w*\.ts$/.test(subject)
     // The slot names the domain's entry (`index.ts`, role `entry`) and its shared helper file (`<domain>.shared.ts`, role `shared`).
     // Both sit directly in the domain folder: a nested `x/index.ts` is a file the slot does not name.
     const directlyInDomain = hfsOf(context).relative(file) === `${found.root}/${name}`
-    const isEntryFile = directlyInDomain && (found.role === "entry" || (spec && subject === "index.ts"))
-    const isSharedFile = directlyInDomain && (found.role === "shared" || (spec && subject === `${domain}.shared.ts`))
+    const isEntryFile = directlyInDomain && (found.role === "entry")
+    const isSharedFile = directlyInDomain && (found.role === "shared")
 
     return {
       Program(program) {
@@ -84,12 +83,12 @@ export const hooksFolderHoldsHooksOnly = {
         if (!isHookFile && !isSharedFile && !isEntryFile) context.report({ node: program, messageId: "notHook", data: { name } })
       },
       ImportDeclaration(node) {
-        if (SERVER_ONLY.test(String(node.source.value)) && !spec) {
+        if (SERVER_ONLY.test(String(node.source.value))) {
           context.report({ node, messageId: "server", data: { source: node.source.value } })
         }
       },
       "Program:exit"(program) {
-        if (spec || directlyInHooks || (!isHookFile && !isSharedFile)) return
+        if (directlyInHooks || (!isHookFile && !isSharedFile)) return
         const exported = program.body
           .filter((node) => node.type === "ExportNamedDeclaration" || node.type === "ExportDefaultDeclaration")
           .flatMap((node) => exportedNames(node).map((exportedName) => ({ node, name: exportedName })))

package/index.mjs

@@ -19,7 +19,6 @@ import { recommended as brandValuesRecommended, rules as brandValuesRules } from
 import { recommended as clientBoundaryRecommended, rules as clientBoundaryRules } from "./client-boundary.mjs"
 import { recommended as commentsRecommended, rules as commentsRules } from "./comments.mjs"
 import { recommended as classNamesRecommended, rules as classNamesRules } from "./class-names.mjs"
-import { recommended as e2eShapeRecommended, rules as e2eShapeRules, scope as e2eShapeScope } from "./e2e-shape.mjs"
 import { recommended as envOwnerRecommended, rules as envOwnerRules } from "./env-owner.mjs"
 import { recommended as fileLayoutRecommended, rules as fileLayoutRules } from "./file-layout.mjs"
 import { recommended as grammarBoundaryRecommended, rules as grammarBoundaryRules } from "./grammar-boundary.mjs"
@@ -39,7 +38,6 @@ import { recommended as servedLocaleRecommended, rules as servedLocaleRules } fr
 import { recommended as shapeSlotRecommended, rules as shapeSlotRules } from "./shape-slot.mjs"
 import { recommended as sizeBudgetRecommended, rules as sizeBudgetRules } from "./size-and-state-budget.mjs"
 import { recommended as sizeGrowthRecommended, rules as sizeGrowthRules } from "./size-growth.mjs"
-import { recommended as specQualityRecommended, rules as specQualityRules } from "./spec-quality.mjs"
 import { recommended as statusColorsRecommended, rules as statusColorsRules } from "./status-colors.mjs"
 import { recommended as splitRecommended, rules as splitRules } from "./the-split.mjs"
 import { recommended as tokensRecommended, rules as tokensRules } from "./tokens.mjs"
@@ -61,7 +59,6 @@ const CONTRIBUTIONS = [
     rules: classNamesRules,
     recommended: classNamesRecommended,
   },
-  { law: "e2e-shape", rules: e2eShapeRules, recommended: e2eShapeRecommended, scope: e2eShapeScope },
   { law: "env-owner", rules: envOwnerRules, recommended: envOwnerRecommended },
   { law: "file-layout", rules: fileLayoutRules, recommended: fileLayoutRecommended },
   { law: "grammar-boundary", rules: grammarBoundaryRules, recommended: grammarBoundaryRecommended },
@@ -81,7 +78,6 @@ const CONTRIBUTIONS = [
   { law: "shape-slot", rules: shapeSlotRules, recommended: shapeSlotRecommended },
   { law: "size-and-state-budget", rules: sizeBudgetRules, recommended: sizeBudgetRecommended },
   { law: "size-growth", rules: sizeGrowthRules, recommended: sizeGrowthRecommended },
-  { law: "spec-quality", rules: specQualityRules, recommended: specQualityRecommended },
   { law: "status-colors", rules: statusColorsRules, recommended: statusColorsRecommended },
   { law: "the-split", rules: splitRules, recommended: splitRecommended },
   { law: "tokens", rules: tokensRules, recommended: tokensRecommended },
@@ -138,24 +134,6 @@ export const recommended = Object.fromEntries(
   CONTRIBUTIONS.flatMap((entry) => Object.entries(entry.recommended)),
 )
 
-/** Which tree each law governs: `src` unless the law says otherwise. */
-const scopeOf = (entry) => entry.scope ?? "src"
-
-/**
- * The levels the source rules ask for: every law except the e2e one.
- *
- * The audit compares a printed config of a PRODUCTION probe file with a map, so the map must hold
- * only the rules that reach that file. The e2e rules govern another tree and are absent from it.
- */
-export const sourceRecommended = Object.fromEntries(
-  CONTRIBUTIONS.filter((entry) => scopeOf(entry) === "src").flatMap((entry) => Object.entries(entry.recommended)),
-)
-
-/** The levels the e2e rules ask for; they reach `e2e/**` and `playwright.config.*` only. */
-export const e2eRecommended = Object.fromEntries(
-  CONTRIBUTIONS.filter((entry) => scopeOf(entry) === "e2e").flatMap((entry) => Object.entries(entry.recommended)),
-)
-
 /** Flat-config options that make inline directives ineffective rather than merely forbidden. */
 export { linterOptions } from "./lib/config.mjs"
 export { loadHfs } from "./lib/hfs.mjs"
@@ -228,12 +206,12 @@ export const reactHooksRules = (reactHooks) => {
  * The whole flat config of a front end: `export default starciFeConfig({ hfs: loadHfs(import.meta.url) })`.
  *
  * It owns nothing the repository could choose: which files are linted comes from the HFS profile (every app's and every
- * workspace package's `src/`, and the e2e tree), not which rules are on, not their level, not whether an inline comment may
+ * workspace package's `src/`), not which rules are on, not their level, not whether an inline comment may
  * switch one off. NO RULE IS OFF - the factory throws rather than emit a block in which a published rule is missing or
  * below error, so a rule added to this package reaches every repository or the build of this package fails.
  *
  * @param {{ hfs: object }} input - The HFS view of the repository (`loadHfs(import.meta.url)`).
- * @returns {object[]} The flat config: ignores, the typed source block, the e2e block.
+ * @returns {object[]} The flat config: ignores and the typed source block.
  */
 export const starciFeConfig = ({ hfs } = {}) => {
   const published = Object.keys(rules).map((name) => `starci-fe/${name}`)
@@ -246,8 +224,6 @@ export const starciFeConfig = ({ hfs } = {}) => {
     hfs,
     plugin,
     reactHooks,
-    source: { ...sourceRecommended, ...reactHooksRules(reactHooks) },
-    // The escape-hatch fence is a source rule that must also cover the e2e tree.
-    e2e: { ...e2eRecommended, "starci-fe/no-inline-lint-config": "error" },
+    source: { ...recommended, ...reactHooksRules(reactHooks) },
   })
 }

package/lib/config.mjs

@@ -6,8 +6,7 @@
  *     import { loadHfs, starciFeConfig } from "@starci/eslint-canon-fe"
  *     export default starciFeConfig({ hfs: loadHfs(import.meta.url) })
  *
- * The factory owns everything else: which files are linted (the source of every app and every workspace package, and the
- * e2e tree), typed linting on the source (`parserOptions.projectService`, so a rule asks what a node IS rather than what
+ * The factory owns everything else: which files are linted (the source of every app and every workspace package), typed linting on the source (`parserOptions.projectService`, so a rule asks what a node IS rather than what
  * it is called), the ignores, the linter options that make a disable comment impossible, every canon rule at `error`,
  * the React Hooks rules at `error`, and `settings.starci.hfs` - the slot view each path-scoped rule asks instead of a path
  * pattern. It takes no rule overrides, globs or ignores: there is no parameter through which a repository could weaken
@@ -21,9 +20,6 @@ export const linterOptions = Object.freeze({ noInlineConfig: true, reportUnusedD
 /** The product source of a front end: every app's `src/` and every workspace package's `src/` (slots fe.* and repo.packages). */
 export const SOURCE_FILES = Object.freeze(["apps/*/src/**/*.{ts,tsx}", "packages/*/src/**/*.{ts,tsx}"])
 
-/** The e2e tree (slots fe.e2e, fe.e2e-support) and the Playwright config beside it. */
-export const E2E_FILES = Object.freeze(["e2e/**/*.{ts,tsx}", "playwright.config.ts"])
-
 /** Build output, installed packages, generated wire types and the harness's report directory are never linted. */
 export const IGNORED = Object.freeze(["**/node_modules/**", "**/.next/**", "**/dist/**", "**/coverage/**", "**/__generated__/**", ".starci/**"])
 
@@ -36,20 +32,17 @@ const levelOf = (setting) => (Array.isArray(setting) ? setting[0] : setting)
  * @param {object} input.hfs - The HFS view of the repository (`loadHfs(import.meta.url)`).
  * @param {object} input.plugin - The canon plugin.
  * @param {Record<string, unknown>} input.source - The source-tree levels (canon rules plus the React Hooks rules).
- * @param {Record<string, unknown>} input.e2e - The e2e-tree levels.
  * @param {object} input.reactHooks - The React Hooks plugin.
- * @returns {Array<object>} The flat config: one ignore block, one typed source block and one e2e block.
+ * @returns {Array<object>} The flat config: one ignore block and one typed source block.
  */
-export const buildFeConfig = ({ hfs, plugin, source, e2e, reactHooks }) => {
+export const buildFeConfig = ({ hfs, plugin, source, reactHooks }) => {
   if (!hfs || typeof hfs.slotOf !== "function" || typeof hfs.repoRoot !== "string") {
     throw new Error("starciFeConfig needs { hfs: loadHfs(import.meta.url) } - the rules read the repository's slots through it")
   }
   if (hfs.profile !== "fe") throw new Error(`starciFeConfig lints a front end; hfs.json declares profile ${hfs.profile}`)
-  for (const [tree, levels] of [["source", source], ["e2e", e2e]]) {
-    if (Object.keys(levels).length === 0) throw new Error(`starciFeConfig received an empty ${tree} recommendation - a config with no rules is not adoption`)
-    const weak = Object.entries(levels).filter(([, setting]) => levelOf(setting) !== "error").map(([name]) => name)
-    if (weak.length > 0) throw new Error(`starciFeConfig refuses ${tree} rules not at error: ${weak.join(", ")}`)
-  }
+  if (Object.keys(source).length === 0) throw new Error("starciFeConfig received an empty source recommendation - a config with no rules is not adoption")
+  const weak = Object.entries(source).filter(([, setting]) => levelOf(setting) !== "error").map(([name]) => name)
+  if (weak.length > 0) throw new Error(`starciFeConfig refuses source rules not at error: ${weak.join(", ")}`)
   const settings = { starci: { hfs } }
   return [
     { ignores: [...IGNORED] },
@@ -66,14 +59,5 @@ export const buildFeConfig = ({ hfs, plugin, source, e2e, reactHooks }) => {
       settings,
       rules: { ...source },
     },
-    {
-      // The e2e tree is typed by tsconfig.e2e.json, which the project service does not open; its rules read syntax only.
-      files: [...E2E_FILES],
-      languageOptions: { parser: tsParser, ecmaVersion: "latest", sourceType: "module" },
-      linterOptions: { ...linterOptions },
-      plugins: { "starci-fe": plugin },
-      settings,
-      rules: { ...e2e },
-    },
   ]
 }

package/lib/scope.mjs

@@ -33,7 +33,7 @@ export const fileOf = (context) => context.filename || context.getFilename()
 /** The classification of the linted file from the slot view: `{ slot, root, bindings, kind?, role? }` or a no-slot status. */
 export const classOf = (context) => hfsOf(context).classify(fileOf(context))
 
-/** The tier of the linted file in the import direction matrix (`route`, `feature`, `components`, `hooks`, `foundation`, `modules`, `transport`, `e2e`, `package`, `none`), or null when no slot owns it. */
+/** The tier of the linted file in the import direction matrix (`route`, `feature`, `components`, `hooks`, `foundation`, `modules`, `transport`, `package`, `none`), or null when no slot owns it. */
 export const tierOfFile = (context) => hfsOf(context).tierOf(fileOf(context))
 
 /** The folder kind the slot reports for the linted file (a component layer, a feature kind), or null. */
@@ -42,17 +42,11 @@ export const kindOfFile = (context) => classOf(context).kind ?? null
 /** The role the slot reports for the linted file (`entry`, `drawing`, `styles`, `shared`, `page`, `layout`, ...), or null. */
 export const roleOfFile = (context) => classOf(context).role ?? null
 
-/**
- * A spec or test file - it asserts about production shapes rather than being one. The slots define a spec by its name
- * (`allows: "*.spec.tsx"`), so this stays a file-name test.
- */
-export const isSpecFile = (filename) => /\.(?:test|spec)\.[cm]?[jt]sx?$/.test(normalizePath(filename))
-
 /** The tiers of product source: everything a slot places in an app's route, feature, component, hook or module tiers and in a shared package. */
 const PRODUCT_TIERS = new Set(["route", "feature", "components", "hooks", "foundation", "modules", "transport", "package"])
 
-/** Product source: a file of a product tier, and not a spec. */
-export const isProductSource = (context) => PRODUCT_TIERS.has(tierOfFile(context)) && !isSpecFile(fileOf(context))
+/** Product source: a file of a product tier. */
+export const isProductSource = (context) => PRODUCT_TIERS.has(tierOfFile(context))
 
 /** A file of a component tier: slot `fe.components` or `fe.package.ui`, inside one of its layer folders (blocks, composites, branches, leaves). */
 export const isComponentFile = (context) => inSlot(context, "fe.components", "fe.package.ui") && kindOfFile(context) !== null
@@ -63,9 +57,6 @@ export const isComponentPath = (context, file) => {
   return (found.slot === "fe.components" || found.slot === "fe.package.ui") && found.kind !== undefined
 }
 
-/** The e2e tree (tier `e2e`: `fe.e2e`, `fe.e2e-support`) and the Playwright config (role `playwright` of `fe.tool-config`). */
-export const isE2eSource = (context) => tierOfFile(context) === "e2e" || roleOfFile(context) === "playwright"
-
 /** The one place that may read the environment: slot `fe.modules.config`. */
 export const isConfigModule = (context) => inSlot(context, "fe.modules.config")
 

package/lib/why.mjs

@@ -121,71 +121,6 @@ export const why = {
     vi: "`<unit>` tự viết vòng poll (`setInterval` hoặc `setTimeout` tự gọi lại).",
     fixVi: "Làm tươi qua hook dữ liệu (`refreshInterval`) hoặc socket, mỗi resource đúng một cơ chế.",
   },
-  "e2e-spec-location": {
-    code: "FE_E2E_SHAPE",
-    vi: "Spec e2e `<file>` không nằm ở `e2e/<area>/<name>.e2e-spec.ts`.",
-    fixVi: "Đưa spec vào `e2e/<area>/` với hậu tố `.e2e-spec.ts`; helper vào `e2e/support/` hoặc `e2e/fixtures/`.",
-  },
-  "e2e-no-absolute-path": {
-    code: "FE_E2E_SHAPE",
-    vi: "Spec e2e `<file>` dùng đường dẫn tuyệt đối.",
-    fixVi: "Dựng đường dẫn từ cấu hình hoặc thư mục của chính spec.",
-  },
-  "e2e-no-docker": {
-    code: "FE_E2E_SHAPE",
-    vi: "Spec e2e `<file>` phụ thuộc vào docker.",
-    fixVi: "Trỏ suite tới một URL từ cấu hình; môi trường tự cung cấp stack.",
-  },
-  "e2e-no-cross-repo-write": {
-    code: "FE_E2E_SHAPE",
-    vi: "Spec e2e `<file>` ghi ra ngoài repo của app (đường dẫn tuyệt đối hoặc `..`).",
-    fixVi: "Chỉ ghi vào thư mục kết quả của chính repo này.",
-  },
-  "e2e-no-skip": {
-    code: "FE_E2E_SHAPE",
-    vi: "Spec e2e `<file>` bỏ qua test (`test.skip`/`fixme`) — thiếu môi trường phải làm suite đỏ, không được xanh.",
-    fixVi: "Sửa môi trường hoặc xóa test; không bỏ qua có điều kiện.",
-  },
-  "e2e-typed-helpers": {
-    code: "FE_E2E_SHAPE",
-    vi: "Helper e2e ở `<file>` có tham số không kiểu hoặc dùng `any`.",
-    fixVi: "Khai kiểu cho mọi tham số của helper; thay `any` bằng kiểu thật hoặc `unknown` kèm kiểm tra.",
-  },
-  "playwright-viewports": {
-    code: "FE_E2E_SHAPE",
-    vi: "`playwright.config` không khai đúng ba viewport 1440x900, 768x1024, 390x844.",
-    fixVi: "Mỗi project khai một viewport; đủ ba, không thêm cỡ thứ tư.",
-  },
-  "no-class-string-in-spec": {
-    code: "FE_SPEC_QUALITY",
-    vi: "Spec `<file>` ghim chuỗi class. Spec kiểm hành vi, không kiểm stylesheet.",
-    fixVi: "Assert theo role, tên, trạng thái hoặc chữ hiển thị.",
-  },
-  "spec-tests-its-neighbour": {
-    code: "FE_SPEC_QUALITY",
-    vi: "Spec `<file>` không import chủ thể nằm cạnh nó.",
-    fixVi: "Đưa spec về cạnh chủ thể, hoặc test đúng đơn vị nằm cạnh.",
-  },
-  "no-barrel-spec": {
-    code: "FE_SPEC_QUALITY",
-    vi: "Spec `<file>` đặt cạnh một `index` chỉ có import và re-export (barrel). Barrel không có hành vi để test.",
-    fixVi: "Xóa spec; test từng đơn vị mà barrel xuất lại, cạnh chính đơn vị đó.",
-  },
-  "no-double-cast-in-spec": {
-    code: "FE_SPEC_QUALITY",
-    vi: "Spec `<file>` ép kiểu hai lần (`as unknown as`).",
-    fixVi: "Dựng giá trị bằng factory có kiểu (`mock<T>()` hoặc fixture builder).",
-  },
-  "connected-spec-has-axe": {
-    code: "FE_SPEC_QUALITY",
-    vi: "Spec `<file>` của màn hình kết nối không có assert axe.",
-    fixVi: "Thêm `expect(await axe(container)).toHaveNoViolations()`.",
-  },
-  "no-mocked-translations": {
-    code: "FE_I18N_CATALOG",
-    vi: "Spec `<file>` giả lập `next-intl`, nên chỉ kiểm khóa chứ không kiểm catalog thật.",
-    fixVi: "Component client: render trong `NextIntlClientProvider` với `messages/<locale>.json` thật. Helper server (`next-intl/server`): factory của mock dựng translator từ catalog thật (`createTranslator` với `modules/i18n/messages/<locale>.json`).",
-  },
   "no-inline-lint-config": {
     code: "HFS_INLINE_SUPPRESSION",
     vi: "Có chú thích tắt luật ở `<file>:<line>`. HFS không cho tắt tại chỗ — sửa code, hoặc đề xuất đổi luật.",