@starci/eslint-canon-fe 6.0.1 → 7.0.0

package/docs/size-and-state-budget.md

@@ -24,9 +24,9 @@ A component file has at most 300 lines.
 
 **Finding code:** `FE_SIZE_AND_STATE_BUDGET`
 
-**Vì sao (why):** `<file>` dài `<n>` dòng, vượt ngưỡng 300 dòng của một component.
+**Why:** `<file>` is `<n>` lines long, over the 300-line limit for a component.
 
-**Cách sửa:** Tách phần vẽ khỏi phần dữ liệu và tách từng khu vực thành đơn vị riêng.
+**Fix:** Separate rendering from data and split each region into its own unit.
 
 ## `starci-fe/unit-hook-budget`
 
@@ -46,9 +46,9 @@ const Feed = () => { /* up to 6 x useState and 6 data hooks */ }
 
 **Finding code:** `FE_SIZE_AND_STATE_BUDGET`
 
-**Vì sao (why):** `<unit>` có `<n>` hook dữ liệu / `<m>` useState, vượt ngưỡng 6.
+**Why:** `<unit>` has `<n>` data hooks / `<m>` useState, over the limit of 6.
 
-**Cách sửa:** Gom trạng thái đổi cùng nhau vào reducer hoặc hook riêng; tách mỗi vùng dữ liệu thành block kết nối riêng.
+**Fix:** Group state that changes together into a reducer or a dedicated hook; split each data region into its own connected block.
 
 ## `starci-fe/no-hand-rolled-polling`
 
@@ -68,6 +68,6 @@ const d = useQueryFeedSwr({ refreshInterval: 5000 })
 
 **Finding code:** `FE_SIZE_AND_STATE_BUDGET`
 
-**Vì sao (why):** `<unit>` tự viết vòng poll (`setInterval` hoặc `setTimeout` tự gọi lại).
+**Why:** `<unit>` writes its own poll loop (`setInterval` or a self-calling `setTimeout`).
 
-**Cách sửa:** Làm tươi qua hook dữ liệu (`refreshInterval`) hoặc socket, mỗi resource đúng một cơ chế.
+**Fix:** Refresh through a data hook (`refreshInterval`) or a socket, exactly one mechanism per resource.

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")