@starci/eslint-canon-fe 8.0.8 → 8.0.9

package/lib/why.mjs

@@ -1,279 +1,282 @@
 /**
- * The Vietnamese "why" of each rule the HFS catalogue assigns to this canon.
+ * The "why" of each rule the HFS catalogue assigns to this canon.
  *
  * WHERE IT IS SURFACED. An ESLint message is written for the developer at the terminal, in English,
  * and says what is wrong in the vocabulary of the rule. The agent that reads a failed land gate needs
  * the catalogue's sentence instead: the finding code (the key in `modules/kernel/failure-codes.yaml`)
- * and a Vietnamese headline and next step it can quote to the owner. This map is the canon's half of
- * that contract: `code` is the finding code, `vi` the headline with `<file>` / `<what>` placeholders
- * the reader fills from the ESLint location, `fixVi` the one sentence "what do I do now".
+ * and a headline and next step it can quote to the owner. This map is the canon's half of that
+ * contract: `code` is the finding code, `en` the English source of the headline with `<file>` /
+ * `<what>` placeholders the reader fills from the ESLint location, `fix` the one sentence "what do I
+ * do now". The owner reads both in Vietnamese through the declared message catalog: the `en` and
+ * `fix` strings are the keys of `modules/i18n/messages/canon.yaml`, so `translator('vi')(entry.en)` and
+ * `translator('vi')(entry.fix)` hand back the Vietnamese of the same sentence.
  *
- * Every rule that carries a catalogue id (R18, R22, R49-R59, R60-R62, R65-R67) has an entry;
+ * Every rule that carries a catalogue id (R18, R22, R49-R59, R60-R62, R65) has an entry;
  * the twin test refuses a rule of those laws with no entry and an entry for a rule that does not exist.
  */
 
-/** @typedef {{ code: string, vi: string, fixVi: string }} Why */
+/** @typedef {{ code: string, en: string, fix: string }} Why */
 
 /** @type {Record<string, Why>} */
 export const why = {
   "no-env-outside-config": {
     code: "FE_ENV_OWNER",
-    vi: "`<file>` đọc biến môi trường. Chỉ `modules/config` được đọc env.",
-    fixVi: "Đọc giá trị từ export có kiểu của `modules/config` thay vì `process.env`.",
+    en: "`<file>` reads an environment variable. Only `modules/config` may read env.",
+    fix: "Read the value from a typed export of `modules/config` instead of `process.env`.",
   },
   "no-hardcoded-endpoint-fallback": {
     code: "FE_ENV_OWNER",
-    vi: "`<file>` có giá trị dự phòng cứng cho địa chỉ hoặc bí mật (`?? \"http://localhost…\"`). Thiếu biến ở production phải ném lỗi khi nạp cấu hình, không được lặng lẽ trỏ về máy dev.",
-    fixVi: "Xóa giá trị dự phòng; để `modules/config` ném lỗi khi thiếu biến ở production.",
+    en: "`<file>` carries a hardcoded fallback for an address or a secret (`?? \"http://localhost…\"`). A variable missing in production must throw at config load, not silently point at a dev machine.",
+    fix: "Delete the fallback; let `modules/config` throw when a variable is missing in production.",
   },
   "fetch-only-in-api-client": {
     code: "FE_TRANSPORT_OWNER",
-    vi: "`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.",
-    fixVi: "Gọi client của repo và nhận `Outcome<T>`; không tự gọi `fetch`.",
+    en: "`fetch` (or `Request`, `EventSource`, `sendBeacon`, another HTTP library) in `<file>` sits outside the one client (`modules/api/client.ts`, or `src/client.ts` of the shared api package). A repo has exactly one transport.",
+    fix: "Call the repo's client and receive `Outcome<T>`; do not call `fetch` yourself.",
   },
   "client-fetch-has-signal": {
     code: "FE_TRANSPORT_OWNER",
-    vi: "`fetch` ở `<file>` không có `signal`. Client bắt buộc có timeout và `AbortSignal`.",
-    fixVi: "Truyền `signal` (`AbortSignal.timeout(...)` kết hợp với tín hiệu của người gọi).",
+    en: "`fetch` in `<file>` has no `signal`. The client must carry a timeout and an `AbortSignal`.",
+    fix: "Pass `signal` (`AbortSignal.timeout(...)` combined with the caller's signal).",
   },
   "no-shared-transport-state": {
     code: "FE_TRANSPORT_OWNER",
-    vi: "`<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.",
-    fixVi: "Truyền credential và locale bằng tham số hoặc context.",
+    en: "`<file>` holds shared state as `let`/`var` in the API layer. Token and locale must not sit in a singleton.",
+    fix: "Pass credential and locale as parameters or through context.",
   },
   "client-maps-auth-to-refused": {
     code: "FE_HTTP_STATUS_COLLAPSE",
-    vi: "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.",
-    fixVi: "Thêm nhánh `response.status === 401 || response.status === 403` trả `{ ok: false, kind: \"refused\" }` ngay trong client.",
+    en: "The client in `<file>` has no branch comparing `response.status` with 401 and 403 and returning `{ kind: \"refused\" }`, so the \"sign-in required\" state is never reached.",
+    fix: "Add a `response.status === 401 || response.status === 403` branch returning `{ ok: false, kind: \"refused\" }` right inside the client.",
   },
   "no-failure-collapse": {
     code: "FE_HTTP_STATUS_COLLAPSE",
-    vi: "`<file>` gộp mọi thất bại (phản hồi HTTP lỗi hoặc `Outcome` thất bại) thành một nhánh hoặc một giá trị rỗng, nên lý do bị mất.",
-    fixVi: "Giữ lý do: với `Outcome` thì rẽ nhánh theo mã lý do; với phản hồi HTTP thì đổi mã trạng thái thành `Outcome` (`refused` cho 401/403, `not-found`, `invalid`, `unavailable`). Không dùng nguyên văn lỗi của server làm lý do.",
+    en: "`<file>` merges every failure (an error HTTP response or a failed `Outcome`) into one branch or one empty value, so the reason is lost.",
+    fix: "Keep the reason: for an `Outcome` branch on the reason code; for an HTTP response turn the status code into an `Outcome` (`refused` for 401/403, `not-found`, `invalid`, `unavailable`). Do not use the server's raw error as the reason.",
   },
   "no-hand-typed-wire": {
     code: "FE_WIRE_GENERATED",
-    vi: "`<file>` tự gõ kiểu wire hoặc ép kiểu phản hồi. Dùng kiểu sinh từ `be/contracts/`.",
-    fixVi: "Chạy codegen từ ảnh chụp hợp đồng của be (`be/contracts/`) và nhập kiểu sinh ra; đưa tài liệu GraphQL vào tệp `.graphql`.",
+    en: "`<file>` hand-types a wire type or casts a response. Use the types generated from `be/contracts/`.",
+    fix: "Run codegen from the be contract snapshot (`be/contracts/`) and import the generated types; put GraphQL documents in `.graphql` files.",
   },
   "use-client-only-at-boundary": {
     code: "FE_CLIENT_BOUNDARY",
-    vi: "`\"use client\"` ở `<file>` (`<slot>` không được là client component).",
-    fixVi: "Đặt `\"use client\"` ở `index.tsx` của block có tương tác, leaf, hoặc `error.tsx`/`global-error.tsx`; giữ layout và page là server component.",
+    en: "`\"use client\"` in `<file>` (`<slot>` may not be a client component).",
+    fix: "Put `\"use client\"` on the `index.tsx` of an interactive block, a leaf, or `error.tsx`/`global-error.tsx`; keep layout and page as server components.",
   },
   "hooks-folder-holds-hooks-only": {
     code: "FE_HOOKS_ARE_HOOKS",
-    vi: "`<file>` trong `hooks/` không phải React hook. Reader server về `modules/api`, helper về `<domain>.shared.ts`.",
-    fixVi: "Mỗi tệp `use*.ts` một hook; helper dùng chung vào `<domain>.shared.ts`; reader server vào `modules/api/<domain>/read-*.ts`.",
+    en: "`<file>` inside `hooks/` is not a React hook. A server reader goes to `modules/api`, a helper to `<domain>.shared.ts`.",
+    fix: "One hook per `use*.ts` file; a shared helper goes in `<domain>.shared.ts`; a server reader goes in `modules/api/<domain>/read-*.ts`.",
   },
   "no-middleware-file": {
     code: "FE_NEXT_CONVENTIONS",
-    vi: "`<file>` dùng tên `middleware`. Từ Next 16 bộ chặn request là `proxy.ts` và xuất `proxy`.",
-    fixVi: "Đổi tên tệp thành `proxy.ts` và đổi export thành `proxy`.",
+    en: "`<file>` uses the name `middleware`. From Next 16 the request gate is `proxy.ts` exporting `proxy`.",
+    fix: "Rename the file to `proxy.ts` and rename the export to `proxy`.",
   },
   "locale-segment-is-locale": {
     code: "FE_I18N_PLACEMENT",
-    vi: "Tệp `<file>` nằm dưới segment ngôn ngữ không phải `[locale]`. Chỉ có một mẫu: `next-intl`, `[locale]`, mặc định `vi`.",
-    fixVi: "Đổi tên thư mục segment thành `[locale]`.",
+    en: "File `<file>` sits under a locale segment that is not `[locale]`. There is one pattern: `next-intl`, `[locale]`, default `vi`.",
+    fix: "Rename the segment directory to `[locale]`.",
   },
   "no-second-i18n-stack": {
     code: "FE_I18N_PLACEMENT",
-    vi: "`<file>` nhập một thư viện i18n thứ hai. App chỉ dùng `next-intl` qua `modules/i18n`.",
-    fixVi: "Chuyển sang `next-intl`; xóa thư viện còn lại.",
+    en: "`<file>` imports a second i18n library. The app uses only `next-intl` through `modules/i18n`.",
+    fix: "Switch to `next-intl`; delete the other library.",
   },
   "html-lang-from-locale": {
     code: "FE_I18N_LITERAL",
-    vi: "`<html lang>` ở `<file>` là chữ cứng. Thuộc tính `lang` phải lấy từ segment `[locale]`.",
-    fixVi: "Dùng `lang={locale}` từ tham số của layout `[locale]`.",
+    en: "`<html lang>` in `<file>` is a hardcoded string. The `lang` attribute must come from the `[locale]` segment.",
+    fix: "Use `lang={locale}` from the parameter of the `[locale]` layout.",
   },
   "no-hardcoded-copy": {
     code: "FE_I18N_LITERAL",
-    vi: "Chữ `\"<text>\"` ở `<file>:<line>` không đi qua `t()`.",
-    fixVi: "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`.",
+    en: "The text `\"<text>\"` in `<file>:<line>` does not go through `t()`.",
+    fix: "Move the sentence into `modules/i18n/messages/<locale>.json` and read it with `t(\"key\")`; no exceptions and no `vn-ok`.",
   },
   "no-raw-brand-value": {
     code: "FE_STYLE_TOKEN_ONLY",
-    vi: "`<file>` dùng giá trị màu/độ dài thô (`<what>`). Màu và khoảng cách chỉ đến từ token grammar; màu thương hiệu chỉ ở `brand.css`.",
-    fixVi: "Dùng lớp hoặc biến token của grammar; giá trị màu chỉ khai trong `modules/brand/brand.css`.",
+    en: "`<file>` uses a raw colour/length value (`<what>`). Colour and spacing come only from grammar tokens; brand colour lives only in `brand.css`.",
+    fix: "Use a grammar token class or variable; a colour value is declared only in `modules/brand/brand.css`.",
   },
   "status-text-uses-soft-foreground": {
     code: "FE_STYLE_TOKEN_ONLY",
-    vi: "`<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.",
-    fixVi: "Đổ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`.",
+    en: "`<file>` paints text or an icon with a solid status tone (`<what>`, e.g. `text-success`). A solid tone is a background colour; used as a text colour it reads below 4.5:1 on the page background.",
+    fix: "Switch to the soft pair: `text-<tone>-soft-foreground` (with `bg-<tone>-soft` when it sits on a light surface); a solid tone is used only with `bg-<tone>` and `text-<tone>-foreground`.",
   },
   "no-native-form-control": {
     code: "FE_NATIVE_FORM_CONTROL",
-    vi: "`<tag>` thô ở `<file>`. Dùng renderer của grammar.",
-    fixVi: "Thay bằng thành phần của grammar; nếu chưa có, thêm vào grammar thay vì vẽ tại chỗ.",
+    en: "Raw `<tag>` in `<file>`. Use the grammar renderer.",
+    fix: "Replace it with the grammar component; if none exists yet, add it to grammar instead of drawing it in place.",
   },
   "component-line-budget": {
     code: "FE_SIZE_AND_STATE_BUDGET",
-    vi: "`<file>` dài `<n>` dòng, vượt ngưỡng 300 dòng của một component.",
-    fixVi: "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.",
+    en: "`<file>` is `<n>` lines long, over the 300-line budget of a component.",
+    fix: "Split the drawing part from the data part and each area into its own unit.",
   },
   "unit-hook-budget": {
     code: "FE_SIZE_AND_STATE_BUDGET",
-    vi: "`<unit>` có `<n>` hook dữ liệu / `<m>` useState, vượt ngưỡng 6.",
-    fixVi: "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.",
+    en: "`<unit>` has `<n>` data hooks / `<m>` useState, over the budget of 6.",
+    fix: "Fold state that changes together into a reducer or a dedicated hook; split each data area into its own connection block.",
   },
   "no-hand-rolled-polling": {
     code: "FE_SIZE_AND_STATE_BUDGET",
-    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ế.",
+    en: "`<unit>` hand-writes a poll loop (`setInterval` or a self-rescheduling `setTimeout`).",
+    fix: "Refresh through a data hook (`refreshInterval`) or a socket, one mechanism per resource.",
   },
   "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.",
-    fixVi: "Xóa `eslint-disable`, `@ts-ignore`, `@ts-expect-error` hoặc `vn-ok` và sửa nguyên nhân.",
+    en: "A comment disabling a rule sits at `<file>:<line>`. HFS does not allow in-place suppression - fix the code, or propose a rule change.",
+    fix: "Remove `eslint-disable`, `@ts-ignore`, `@ts-expect-error` or `vn-ok` and fix the cause.",
   },
   "no-double-cast": {
     code: "FE_TYPE_ESCAPE",
-    vi: "`<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.",
-    fixVi: "Thu hẹp từ `unknown` bằng type guard hoặc parser; không ép kiểu.",
+    en: "`<file>` casts through `unknown` (`as unknown as T`): the compiler forgets everything it knows right where the data enters.",
+    fix: "Narrow from `unknown` with a type guard or a parser; do not cast.",
   },
   "no-type-assertion": {
     code: "FE_TYPE_ESCAPE",
-    vi: "`<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.",
-    fixVi: "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.",
+    en: "`<file>` uses `as T` or `<T>x`: an assertion the compiler cannot check. If it is wrong, the error lands in the user's browser.",
+    fix: "Narrow with a type guard, `in`, a discriminant or a parser where the data enters; use `satisfies` when you only mean to check a literal.",
   },
   "no-non-null-assertion": {
     code: "FE_TYPE_ESCAPE",
-    vi: "`<file>` dùng `x!`: khẳng định giá trị có mặt mà không chứng minh.",
-    fixVi: "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.",
+    en: "`<file>` uses `x!`: asserting a value is present without proving it.",
+    fix: "Handle the absent branch (`if`, `??`, an early return) or fix the type so the value cannot be absent.",
   },
   "no-explicit-any": {
     code: "FE_TYPE_ESCAPE",
-    vi: "`<file>` dùng `any`: tắt kiểm kiểu cho giá trị đó và mọi thứ suy ra từ nó.",
-    fixVi: "Dùng kiểu thật, generic, hoặc `unknown` rồi thu hẹp tại chỗ dùng.",
+    en: "`<file>` uses `any`: it switches off type checking for that value and for everything inferred from it.",
+    fix: "Use a real type, a generic, or `unknown` narrowed at the use site.",
   },
   "list-item-has-key": {
     code: "FE_LIST_KEY",
-    vi: "Phần tử trả từ `.map` ở `<file>` không có `key`, nên React nhận diện hàng theo vị trí và hàng bị đổi state khi xoá hoặc sắp xếp lại.",
-    fixVi: "Thêm `key` lấy từ id của dữ liệu; với fragment dùng `<Fragment key={...}>`.",
+    en: "An element returned from `.map` in `<file>` has no `key`, so React identifies the row by position and the row loses state on delete or reorder.",
+    fix: "Add a `key` taken from the data's id; for a fragment use `<Fragment key={...}>`.",
   },
   "no-index-key": {
     code: "FE_LIST_KEY",
-    vi: "`key` ở `<file>` lấy từ chỉ số của `.map` hoặc giá trị sinh ngẫu nhiên; chỉ số là vị trí, không phải danh tính.",
-    fixVi: "Dùng id mà dữ liệu mang (`key={row.id}`); không dùng index, `Math.random`, `Date.now`.",
+    en: "A `key` in `<file>` comes from the `.map` index or a randomly generated value; an index is a position, not an identity.",
+    fix: "Use the id the data carries (`key={row.id}`); never the index, `Math.random`, `Date.now`.",
   },
   "no-inline-literal-prop-in-list": {
     code: "FE_LIST_KEY",
-    vi: "Component trong `.map` ở `<file>` nhận object hoặc array literal làm prop: mỗi hàng mỗi lần render một giá trị mới, memo không bao giờ trúng.",
-    fixVi: "Nâng hằng số ra ngoài component hoặc dựng một lần trước `.map`.",
+    en: "A component in a `.map` in `<file>` receives an object or array literal as a prop: every row gets a new value every render, so memo never hits.",
+    fix: "Hoist the constant outside the component or build it once before `.map`.",
   },
   "effect-subscription-needs-cleanup": {
     code: "FE_EFFECT_CLEANUP",
-    vi: "`<what>` ở `<file>` (timer, frame, listener, observer, socket hoặc subscription) được effect hoặc `subscribe` khởi động nhưng cleanup trả về không giải phóng đúng handle/target/listener đó.",
-    fixVi: "Giữ handle và trả cleanup gọi `clearTimeout(id)`, `cancelAnimationFrame(id)`, `removeEventListener` cùng type và listener, `.disconnect()`, `.close()` hoặc `.unsubscribe()` trên đúng đối tượng.",
+    en: "`<what>` in `<file>` (timer, frame, listener, observer, socket or subscription) is started by an effect or `subscribe` but the returned cleanup does not release that same handle/target/listener.",
+    fix: "Keep the handle and return a cleanup calling `clearTimeout(id)`, `cancelAnimationFrame(id)`, `removeEventListener` with the same type and listener, `.disconnect()`, `.close()` or `.unsubscribe()` on the right object.",
   },
   "no-data-fetch-in-effect": {
     code: "FE_EFFECT_FETCH",
-    vi: "`useEffect` ở `<file>` khởi động một promise (`await`, `fetch`, `.then`, `void load()`, `mutate()`/`refresh()` gọi thẳng): không cache, không gộp request, không trạng thái loading/lỗi, không huỷ. Độ tươi của dữ liệu đến từ key của SWR, không đến từ effect.",
-    fixVi: "Đọc phía client bằng SWR gọi client của app (`hooks/`) với key theo thứ thay đổi; gọi `mutate()` từ sự kiện làm dữ liệu đổi (handler, message socket); phía route dùng server reader `modules/api/<domain>/read-*.ts`.",
+    en: "`useEffect` in `<file>` starts a promise (`await`, `fetch`, `.then`, `void load()`, `mutate()`/`refresh()` called directly): no cache, no request merging, no loading/error state, no abort. Freshness of data comes from the SWR key, not from an effect.",
+    fix: "Read on the client with SWR calling the app's client (`hooks/`) keyed by what changes; call `mutate()` from the event that changes the data (handler, socket message); on the route use the server reader `modules/api/<domain>/read-*.ts`.",
   },
   "no-empty-catch": {
     code: "FE_SWALLOWED_ERROR",
-    vi: "`catch` hoặc `.catch` ở `<file>` không làm gì: lỗi biến mất, không thông báo, không dấu vết.",
-    fixVi: "Trả một outcome có kiểu mang nguyên nhân, hiển thị trạng thái lỗi, hoặc ném lại.",
+    en: "A `catch` or `.catch` in `<file>` does nothing: the error vanishes, no notice, no trace.",
+    fix: "Return a typed outcome carrying the cause, show an error state, or rethrow.",
   },
   "no-console": {
     code: "FE_CONSOLE_CALL",
-    vi: "`console.<method>` ở `<file>`: không vào pipeline log nào và lộ chi tiết nội bộ cho người dùng.",
-    fixVi: "Trả outcome có kiểu, hiển thị trạng thái lỗi, hoặc để lỗi tới `error.tsx`.",
+    en: "`console.<method>` in `<file>`: it reaches no log pipeline and leaks internal detail to the user.",
+    fix: "Return a typed outcome, show an error state, or let the error reach `error.tsx`.",
   },
   "page-exports-metadata": {
     code: "FE_PAGE_METADATA_MISSING",
-    vi: "`<file>` là `page.tsx` nhưng không export `metadata` hoặc `generateMetadata`; mọi trang trong nhánh mang cùng một tiêu đề.",
-    fixVi: "Export `metadata` (hoặc `generateMetadata` khi tiêu đề lấy từ dữ liệu) với tiêu đề và mô tả lấy từ catalog thông điệp.",
+    en: "`<file>` is `page.tsx` but exports no `metadata` or `generateMetadata`; every page in the branch carries the same title.",
+    fix: "Export `metadata` (or `generateMetadata` when the title comes from data) with a title and description taken from the message catalog.",
   },
   "no-null-suspense-fallback": {
     code: "FE_SUSPENSE_NULL_FALLBACK",
-    vi: "`<Suspense>` ở `<file>` có `fallback` rỗng: người dùng thấy khoảng trống thay vì trạng thái đang tải.",
-    fixVi: "Truyền skeleton (trạng thái loading) của đúng thứ đang tải làm `fallback`.",
+    en: "`<Suspense>` in `<file>` has an empty `fallback`: the user sees a blank instead of a loading state.",
+    fix: "Pass the skeleton (loading state) of the very thing loading as the `fallback`.",
   },
   "navigation-from-intl": {
     code: "FE_I18N_NAVIGATION",
-    vi: "`<file>` nhập `Link`, `useRouter`, `usePathname` hoặc `redirect` từ Next, không biết locale: đường dẫn mất tiền tố `[locale]`.",
-    fixVi: "Nhập từ `modules/i18n/navigation`, được next-intl dựng từ `routing.ts`.",
+    en: "`<file>` imports `Link`, `useRouter`, `usePathname` or `redirect` from Next, which does not know the locale: the path loses the `[locale]` prefix.",
+    fix: "Import from `modules/i18n/navigation`, built by next-intl from `routing.ts`.",
   },
   "no-native-anchor": {
     code: "FE_I18N_NAVIGATION",
-    vi: "`<a>` ở `<file>` trỏ route nội bộ (tải lại cả trang, mất locale, mất prefetch) hoặc mở tab mới mà không có `rel`.",
-    fixVi: "Dùng `Link` từ `modules/i18n/navigation` với href dựng bởi `modules/routes`; liên kết `_blank` thêm `rel=\"noopener noreferrer\"`.",
+    en: "`<a>` in `<file>` points at an internal route (reloads the whole page, loses the locale, loses prefetch) or opens a new tab without `rel`.",
+    fix: "Use `Link` from `modules/i18n/navigation` with an href built by `modules/routes`; a `_blank` link adds `rel=\"noopener noreferrer\"`.",
   },
   "use-intl-formatter": {
     code: "FE_I18N_FORMATTER",
-    vi: "`<file>` định dạng số, tiền hoặc ngày bằng `toLocale*String`, `new Intl.*`, `toFixed`, ký hiệu tiền dán vào template hoặc thư viện ngày, thay vì formatter của next-intl.",
-    fixVi: "Dùng `useFormatter()` (hoặc `getFormatter()` ở server): `number(...)`, `dateTime(...)`, `relativeTime(...)`.",
+    en: "`<file>` formats a number, money or a date with `toLocale*String`, `new Intl.*`, `toFixed`, a currency sign pasted into a template or a date library, instead of the next-intl formatter.",
+    fix: "Use `useFormatter()` (or `getFormatter()` on the server): `number(...)`, `dateTime(...)`, `relativeTime(...)`.",
   },
   "no-hardcoded-route": {
     code: "FE_ROUTE_HARDCODED",
-    vi: "`<file>` viết thẳng đường dẫn route ở nơi gọi; route đổi chỗ thì bản sao trỏ vào 404.",
-    fixVi: "Dựng href bằng hàm của `modules/routes` và dùng đúng hàm đó ở mọi nơi.",
+    en: "`<file>` writes a route path inline at the call site; when the route moves, the copy points at a 404.",
+    fix: "Build the href with a function of `modules/routes` and use that same function everywhere.",
   },
   "client-no-server-import": {
     code: "FE_CLIENT_SERVER_IMPORT",
-    vi: "Client component ở `<file>` nhập mã chỉ tồn tại ở server (`server-only`, `next/headers`, module Node, server reader).",
-    fixVi: "Đọc dữ liệu ở server component hoặc server reader rồi truyền xuống bằng props; hoặc dùng SWR gọi client của app.",
+    en: "A client component in `<file>` imports code that exists only on the server (`server-only`, `next/headers`, a Node module, a server reader).",
+    fix: "Read the data in a server component or a server reader and pass it down as props; or use SWR calling the app's client.",
   },
   "server-module-marks-server-only": {
     code: "FE_SERVER_ONLY_MARK",
-    vi: "Module `<file>` nhập API chỉ có ở server (`next/headers`, `next/server`, `next-intl/server`, module Node hoặc module đã là server-only) nhưng không mở đầu bằng `import \"server-only\"`.",
-    fixVi: "Đặt `import \"server-only\"` làm câu lệnh đầu tiên của tệp; tệp route (`page`, `layout`, `route`, `proxy`) là server component sẵn nên không cần.",
+    en: "Module `<file>` imports a server-only API (`next/headers`, `next/server`, `next-intl/server`, a Node module or an already server-only module) but does not open with `import \"server-only\"`.",
+    fix: "Make `import \"server-only\"` the file's first statement; route files (`page`, `layout`, `route`, `proxy`) are server components already and need none.",
   },
   "web-storage-only-in-modules": {
     code: "FE_STORAGE_OUTSIDE_MODULES",
-    vi: "`<file>` dùng `localStorage`/`sessionStorage` ngoài `modules/`; storage không có ở server và ném lỗi khi đầy hạn mức.",
-    fixVi: "Đặt đọc/ghi sau một hook hoặc module trong `modules/` có bảo vệ (`typeof window`, try/catch) rồi gọi từ block.",
+    en: "`<file>` uses `localStorage`/`sessionStorage` outside `modules/`; storage does not exist on the server and throws when over quota.",
+    fix: "Put the read/write behind a hook or a module in `modules/` with a guard (`typeof window`, try/catch) and call it from the block.",
   },
   "no-dangerous-html": {
     code: "FE_DANGEROUS_HTML",
-    vi: "`dangerouslySetInnerHTML` trên `<tag>` ở `<file>`: chuỗi bất kỳ trở thành HTML chạy được.",
-    fixVi: "Render nội dung thành phần tử; chỉ `<script>` mang JSON-LD hoặc mã theme từ hằng số của app mới được dùng.",
+    en: "`dangerouslySetInnerHTML` on `<tag>` in `<file>`: any string becomes runnable HTML.",
+    fix: "Render content as elements; only a `<script>` carrying JSON-LD or theme code from an app constant may use it.",
   },
   "response-cookie-attributes": {
     code: "FE_COOKIE_ATTRIBUTES",
-    vi: "`<file>` ghi cookie qua cookie phản hồi của Next mà không nêu `httpOnly` cố định, thiếu `secure` hoặc `sameSite` không phải `lax`/`strict`.",
-    fixVi: "Truyền một hằng số options `as const` của module sở hữu cookie: `httpOnly: true` (chỉ `false` cho cookie tùy chọn script cần đọc), `secure` từ `modules/config`, `sameSite: \"lax\"` hoặc `\"strict\"`.",
+    en: "`<file>` writes a cookie through the Next response cookie without stating fixed `httpOnly`, missing `secure` or a `sameSite` that is not `lax`/`strict`.",
+    fix: "Pass one `as const` options constant of the module owning the cookie: `httpOnly: true` (`false` only for a cookie an optional script must read), `secure` from `modules/config`, `sameSite: \"lax\"` or `\"strict\"`.",
   },
   "props-fields-readonly": {
     code: "FE_PROPS_MUTABLE",
-    vi: "Kiểu props của component ở `<file>` có field hoặc collection không `readonly`, nên component có thể ghi vào thứ nó được truyền.",
-    fixVi: "Đánh dấu `readonly` cho mọi field và index signature, viết collection là `readonly T[]`, `readonly [A, B]` hoặc `ReadonlyArray<T>`.",
+    en: "A props type of a component in `<file>` has a field or collection that is not `readonly`, so the component could write into what it is passed.",
+    fix: "Mark every field and index signature `readonly`, and write collections as `readonly T[]`, `readonly [A, B]` or `ReadonlyArray<T>`.",
   },
   "no-native-img": {
     code: "FE_NATIVE_IMAGE",
-    vi: "`<img>` thô ở `<file>`: tải ảnh gốc, không giữ chỗ nên trang nhảy khi ảnh tải xong.",
-    fixVi: "Dùng `Image` của `next/image` với `width` và `height` (hoặc `fill` và `sizes`) và `alt` từ catalog.",
+    en: "Raw `<img>` in `<file>`: it loads the original image and holds no space, so the page jumps when the image arrives.",
+    fix: "Use `Image` of `next/image` with `width` and `height` (or `fill` and `sizes`) and an `alt` from the catalog.",
   },
   "image-has-size": {
     code: "FE_NATIVE_IMAGE",
-    vi: "`Image` ở `<file>` thiếu `width` và `height` (hoặc `fill` mà thiếu `sizes`): trình duyệt không giữ chỗ được.",
-    fixVi: "Cho đủ `width` và `height`, hoặc `fill` trong khung có kích thước kèm `sizes`.",
+    en: "`Image` in `<file>` lacks `width` and `height` (or has `fill` without `sizes`): the browser cannot hold the space.",
+    fix: "Give both `width` and `height`, or `fill` inside a sized frame with `sizes`.",
   },
   "outcome-kinds-exhaustive": {
     code: "FE_OUTCOME_KIND_UNHANDLED",
-    vi: "`switch` trên `kind` ở `<file>` có nhánh `ok` nhưng thiếu một trong refused, invalid, not-found, unavailable.",
-    fixVi: "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`.",
+    en: "A `switch` on `kind` in `<file>` has an `ok` branch but misses one of refused, invalid, not-found, unavailable.",
+    fix: "Write all five branches of `Outcome<T>`, one screen each; do not lean on `default`.",
   },
   "one-outcome-union": {
     code: "FE_HTTP_STATUS_COLLAPSE",
-    vi: "`<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>`.",
-    fixVi: "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.",
+    en: "`<file>` declares another result union (`ok` or `kind`) outside `outcome.ts`. A repo has only one `Outcome<T>`.",
+    fix: "Use `Outcome<T>` of `modules/api/outcome.ts` (or the shared api package); add business detail through the second parameter instead of declaring a new union.",
   },
   "i18n-stack-in-one-module": {
     code: "FE_I18N_PLACEMENT",
-    vi: "`<file>` tự dựng một tầng của stack next-intl (`defineRouting`, `createNavigation`, `getRequestConfig`, `createMiddleware`). Stack chỉ được viết một lần cho cả repo.",
-    fixVi: "Gọi factory `createAppI18n` của gói i18n dùng chung trong `modules/i18n/index.ts` và nhập kết quả; repo một app thì chỉ viết stack trong `modules/i18n` của app đó.",
+    en: "`<file>` builds a layer of the next-intl stack itself (`defineRouting`, `createNavigation`, `getRequestConfig`, `createMiddleware`). The stack is written once for the whole repo.",
+    fix: "Call the `createAppI18n` factory of the shared i18n package inside `modules/i18n/index.ts` and import the result; a single-app repo writes the stack only in that app's `modules/i18n`.",
   },
   "no-raw-structural-element": {
     code: "FE_NATIVE_FORM_CONTROL",
-    vi: "`<tag>` thô ở `<file>`. Cấu trúc trang và chữ được ghép từ component của grammar, không viết HTML thô.",
-    fixVi: "Thay bằng component grammar tương ứng (`Heading`, `Text`, `SurfaceCard`, ...); nếu grammar chưa có, thêm vào grammar hoặc gói ui thay vì vẽ tại chỗ.",
+    en: "Raw `<tag>` in `<file>`. Page structure and text are composed from grammar components, not hand-written HTML.",
+    fix: "Replace it with the matching grammar component (`Heading`, `Text`, `SurfaceCard`, ...); if grammar lacks it, add it to grammar or the ui package instead of drawing it in place.",
   },
   "file-size-growth": {
     code: "HFS_SIZE_GROWTH",
-    vi: "`<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.",
-    fixVi: "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.",
+    en: "`<file>` exceeds the line budget: a new file already too long, or an existing file longer than at the parent commit. Every file must be small enough for one person to read through and one test to cover.",
+    fix: "Split the new part into its own file by responsibility; a file already over budget may only stay or shrink.",
   },
 }

package/naming.mjs

@@ -111,13 +111,13 @@ export const noDirectConstAlias = {
 // -- NAMING-3 --------------------------------------------------------------------------------------
 
 /** Letters that exist in Vietnamese and not in English, in the forms a path can carry. */
-const SECOND_LANGUAGE_PATH = /[àáâãèéêìíòóôõùúýăđĩũơưạảấầẩẫậắằẳẵặẹẻẽếềểễệỉịọỏốồổỗộớờởỡợụủứừửữựỳỵỷỹ]/i
+const SECOND_LANGUAGE_PATH = /[\u00e0\u00e1\u00e2\u00e3\u00e8\u00e9\u00ea\u00ec\u00ed\u00f2\u00f3\u00f4\u00f5\u00f9\u00fa\u00fd\u0103\u0111\u0129\u0169\u01a1\u01b0\u1ea1\u1ea3\u1ea5\u1ea7\u1ea9\u1eab\u1ead\u1eaf\u1eb1\u1eb3\u1eb5\u1eb7\u1eb9\u1ebb\u1ebd\u1ebf\u1ec1\u1ec3\u1ec5\u1ec7\u1ec9\u1ecb\u1ecd\u1ecf\u1ed1\u1ed3\u1ed5\u1ed7\u1ed9\u1edb\u1edd\u1edf\u1ee1\u1ee3\u1ee5\u1ee7\u1ee9\u1eeb\u1eed\u1eef\u1ef1\u1ef3\u1ef5\u1ef7\u1ef9]/i
 
 /**
  * Second-language words spelled in ASCII, as a route or folder segment writes them.
  *
- * A path cannot carry diacritics, so `cấp phát` reaches the filesystem as `cap-phat` and every
- * accent-based check passes it. The segments below are the ones this product actually produced.
+ * A path cannot carry diacritics, so a name written with them reaches the filesystem unaccented
+ * (`cap-phat` below) and every accent-based check passes it. The segments below are the ones this product actually produced.
  * A list is the honest instrument here: guessing at Vietnamese-shaped ASCII would refuse `dang`
  * in `dangerous` and `cap` in `capacity`, and a rule that fires on English words is one a
  * repository turns off.
@@ -145,7 +145,7 @@ const segmentsOf = (filename) =>
  * quotes, so this is not only an authoring question: the product's own URLs stop being readable to
  * anybody outside one language.
  */
-export const noSecondLanguageInPath = {
+const noSecondLanguageInPath = {
   meta: {
     type: "problem",
     docs: { description: "File and route names are written in the repository's one shared language." },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@starci/eslint-canon-fe",
-  "version": "8.0.8",
+  "version": "8.0.9",
   "description": "The StarCi front-end lint canon: every rule its laws publish, gathered as one flat-config plugin and attached by one factory.",
   "type": "module",
   "license": "UNLICENSED",
@@ -31,6 +31,8 @@
     "access": "public"
   },
   "scripts": {
+    "prepack": "node ../../hfs/prep-runtime.mjs",
+    "pretest": "node ../../hfs/prep-runtime.mjs",
     "test": "node --test \"*.spec.mjs\""
   },
   "keywords": [

package/project-graph.mjs

@@ -4,7 +4,7 @@
  * One graph per lint run: `scripts/hfs/project-graph.mjs` (a byte copy in this package's runtime/) builds the machine's module
  * graph and slot manifest once for the repository, caches it, and each rule below reports the findings of its own codes on
  * the file ESLint is visiting, on the line the machine names. There is no second graph and no second judge: the list of
- * rules and their codes is `LINT_ENFORCERS` of the machine (scripts/hfs/architecture/surface.mjs); `hfs check` keeps the
+ * rules and their codes is `LINT_ENFORCERS` of the machine (scripts/hfs/architecture/surface.mjs); `starci app check` keeps the
  * findings that have no TypeScript file to sit on. A graph that cannot be built stops the run with the machine's message.
  */
 import { LINT_ENFORCERS } from "./runtime/scripts/hfs/architecture/surface.mjs"