Files
clean-architecture-frontend…/eslint.config.ts
T
DongHyeonka fc303d89bc refactor(contracts): 폐기 별칭 import를 새 이름으로 옮기고 lint로 막는다 (07-01)
문제
MappingResult라는 이름이 두 모양을 가리킨다. external-contract-runtime.ts의
MappingResult({ ok:false, error:{ kind, code } })는 주석이 "정본"이라고
부르지만 테스트 말고 쓰는 곳이 없다. boundary-mapper.ts는
{ ok:false, code } 모양을 BoundaryMappingResult로 이름 붙이고 같은 이름
MappingResult를 @deprecated 별칭으로 남겼는데, 실행 경로가 그 별칭을
요구한다(feature-http-binding mapSuccess, client.ts, resource-mapper,
참조 mapper, boundary-mapper 자신의 helper 반환 타입). 그래서 별칭의 제거
조건("이 파일에서 MappingResult를 import하는 모듈이 없을 때")이 충족될 수
없다. ApiFailure 별칭도 포트 2개와 참조 기능을 포함해 7개 파일이 쓴다.
eslint 설정에 폐기 검사가 없다.

고른 방법 (리뷰 최소 개선 (1)·(4)와 lint, 공개 이름은 그대로)
- boundary-mapper의 BoundaryMapper.map, mapWithBoundaryRegistry,
  mappingSuccess, mappingFailure와 바인딩 mapSuccess가
  BoundaryMappingResult를 반환한다. 참조 mapper·client·resource-mapper도
  옮겼다. ApiFailure를 쓰던 파일은 AppFailure를 쓴다. 타입이 같아서
  런타임과 공개 시그니처는 바뀌지 않는다.
- D-15 주석을 실제와 맞췄다. 기능 mapper와 HTTP 바인딩은
  BoundaryMappingResult(닫힌 실패 코드)를 반환하고, 계약 패키지 쪽 결과가
  필요하면 toContractMappingResult로 바꾼다. 참조 기능 README의 "ApiFailure는
  같은 type의 alias" 문장도 고쳤다.
- 폐기 검사: 이 repo의 ESLint는 babel 파서라 타입 정보가 없어
  @typescript-eslint/no-deprecated를 쓸 수 없다. 대신 core
  no-restricted-imports의 patterns.importNames로 boundary-mapper의
  MappingResult와 errors의 ApiFailure import를 src·tests 전체에서 막는다.
  층별 no-restricted-imports 설정이 같은 규칙을 덮어쓰므로
  restrictedImports()가 별칭 패턴을 항상 덧붙이고, 층 규칙이 없는 파일은
  그 앞에 둔 공통 블록이 받는다.

버린 대안
- 별칭 export 삭제와 정본 이름을 ContractMappingResult로 바꾸기(리뷰 (2)
  후반·(3)): 다운스트림 import를 깨는 공개 이름 변경이다. 이번 묶음 규칙상
  공개 시그니처를 깨는 변경은 하지 않는다. 별칭 주석에 "repo 안 사용 0,
  lint로 강제, 제거는 minor 릴리스 + CHANGELOG [계약] 행"을 적었다.
- typescript-eslint 도입 후 no-deprecated: 새 의존성과 type-aware lint
  설정(속도·설정 범위)이 필요하다.
- 바인딩이 정본 모양을 받게 바꾸기(리뷰 C): 실패 코드가 닫힌 3종에서 자유
  문자열로 넓어져 계약이 약해진다.

위험·한계
- 이름 MappingResult는 여전히 두 파일에서 export된다(한쪽은 폐기 별칭).
  리뷰 완료 기준("MappingResult export 하나, grep 0건")은 별칭을 지워야
  충족된다. 제거 시점은 릴리스 결정으로 남긴다.
- 다운스트림이 eslint.config.ts를 동기화하면 그쪽의 별칭 import가 lint
  오류가 된다. 이름만 바꾸면 된다(tech-log는 mappingSuccess를 쓰는데,
  반환 타입은 같은 모양이라 영향 없음).
- adapters/http의 client.ts·feature-http-binding.ts는 타입 이름만 바꿨다.
  같은 파일을 고치는 다른 수정과 합칠 때 줄 단위 충돌이 날 수 있다.

검증
- RED: 규칙만 먼저 넣고 eslint src tests -> 9개 파일 11 errors
  ("'MappingResult' import from '../../contracts/boundary-mapper.ts' is
  restricted ... deprecated alias: import BoundaryMappingResult", ApiFailure
  같은 꼴).
- GREEN: lint 전체 범위(src scripts tests recipes .storybook 설정 파일)
  --max-warnings=0 rc=0. src에서 별칭을 쓰는 곳은 정의 줄뿐(git grep).
- 회귀: tsc app/test/node rc=0. run-vitest tests/architecture tests/unit
  tests/features tests/platform tests/component tests/contract
  tests/runtime-schema tests/integration(pnpm·corepack을 띄우는 4파일 제외)
  273 files / 3136 tests 중 3135 통과. 실패 1건은
  provider-guardian-transaction(guardian exit=126, 단독 실행도 같음, 이
  변경과 무관한 scripts/lib 프로세스 테스트).
  check-registries PASS, verify-documentation-readiness PASS_SCOPED,
  check-adapter-inventory PASS.
- 미실행: check:architecture(pnpm 필요). depcruise 직접 실행은 0 modules로
  사실상 미검증.

Refs: docs/reviews/2026-11-01-maturity-review/07-contracts.md
2026-11-01 22:35:54 +09:00

975 lines
27 KiB
TypeScript

import babelParser from "@babel/eslint-parser";
import eslint from "@eslint/js";
import reactHooks from "eslint-plugin-react-hooks";
import globals from "globals";
import type { Rule } from "eslint";
const sourceExtensions = "{ts,tsx,mts,cts}";
// 12-09. Editor-time aid only: these patterns show a layer violation while
// typing. The layer rules themselves live in .dependency-cruiser.json and are
// enforced by check:architecture, which resolves every import. Change a rule
// there first; these lists cover a subset and may lag behind it.
const layerPatterns = {
domain: [
"**/application/**",
"**/presentation/**",
"**/adapters/**",
"**/bootstrap/**",
"react",
"react-dom",
"@tanstack/**",
],
application: [
"**/presentation/**",
"**/adapters/**",
"**/bootstrap/**",
"react",
"react-dom",
"@tanstack/**",
],
presentation: [
"**/adapters/**",
"**/bootstrap/**",
"**/application/ports/out/**",
"@tanstack/**",
],
adapters: ["**/presentation/**", "**/bootstrap/**"],
};
// 12-11. Each pattern group carries the reason and the way out; the default
// message only named the pattern.
const layerMessages = {
domain:
"domain stays framework-neutral (.dependency-cruiser.json domain-is-framework-neutral). Move the code to application or pass the value in.",
application:
"application declares ports and never imports UI, adapters or bootstrap (application-does-not-know-concrete-runtime). Add a port under application/ports; bootstrap passes the adapter.",
presentation:
"presentation reaches the runtime through the application API (presentation-does-not-know-adapters). Use the application facade; bootstrap composes adapters.",
adapters:
"an adapter implements an application port and never imports UI or bootstrap (adapters-do-not-know-presentation). Pass what it needs through the port.",
} as const;
// 07-01. Deprecated aliases stay exported for downstream projects until they
// are removed, but nothing in this repository imports them. The ESLint parser
// here has no type information, so this stands in for a no-deprecated rule.
const deprecatedAliasImports = [
{
group: ["**/contracts/boundary-mapper.ts", "**/contracts/boundary-mapper"],
importNames: ["MappingResult"],
message:
"deprecated alias: import BoundaryMappingResult. The contract-side MappingResult lives in external-contract-runtime.ts.",
},
{
group: ["**/contracts/errors.ts", "**/contracts/errors"],
importNames: ["ApiFailure"],
message: "deprecated alias: import AppFailure.",
},
];
function restrictedImports(patterns: readonly string[], message: string) {
return [
"error",
{ patterns: [{ group: [...patterns], message }, ...deprecatedAliasImports] },
];
}
const restrictedBrowserDataProperties = [
"error",
...(["globalThis", "window", "self"] as const).flatMap((object) =>
[
"BroadcastChannel",
"localStorage",
"sessionStorage",
"indexedDB",
"caches",
"navigator",
"File",
"Blob",
"FileSystemFileHandle",
"FileSystemDirectoryHandle",
"showOpenFilePicker",
"showSaveFilePicker",
"URL",
].map((property) => ({
object,
property,
message:
"Browser file/storage APIs are adapter-owned; use the policy port.",
})),
),
{
object: "navigator",
property: "storage",
message: "StorageManager and OPFS access are adapter-owned.",
},
{
object: "URL",
property: "createObjectURL",
message: "Object URL allocation is owned by the preview/download adapter.",
},
{
object: "URL",
property: "revokeObjectURL",
message: "Object URL revocation is owned by the preview/download adapter.",
},
] as const;
const browserCapabilityRoots = new Set([
"globalThis",
"window",
"self",
"navigator",
"URL",
]);
const browserCapabilityProperties = new Set([
"BroadcastChannel",
"localStorage",
"sessionStorage",
"indexedDB",
"caches",
"navigator",
"storage",
"File",
"Blob",
"FileSystemFileHandle",
"FileSystemDirectoryHandle",
"showOpenFilePicker",
"showSaveFilePicker",
"URL",
"createObjectURL",
"revokeObjectURL",
]);
/**
* no-restricted-properties only recognizes the literal object identifier.
* This rule follows local aliases of browser roots so `const host =
* globalThis; host.indexedDB` cannot bypass the owned-adapter boundary.
*/
const noBrowserCapabilityAliasRule: Rule.RuleModule = {
meta: {
type: "problem",
schema: [],
messages: {
owned:
"Browser file/storage capabilities are owned by the approved common adapters.",
},
},
create(context) {
const aliases = new Set<string>();
const unwrap = (input: any): any => {
let node = input;
while (
node &&
[
"ChainExpression",
"TSAsExpression",
"TSNonNullExpression",
"TSTypeAssertion",
].includes(node.type)
) {
node = node.expression;
}
return node;
};
const propertyName = (input: any): string | null => {
const node = unwrap(input);
if (!node) return null;
if (!node.computed && node.property?.type === "Identifier") {
return node.property.name;
}
if (
node.computed &&
node.property?.type === "Literal" &&
typeof node.property.value === "string"
) {
return node.property.value;
}
if (
node.computed &&
node.property?.type === "StringLiteral"
) {
return node.property.value;
}
return null;
};
const isRootAlias = (input: any): boolean => {
const node = unwrap(input);
if (!node) return false;
if (node.type === "Identifier") {
return browserCapabilityRoots.has(node.name) ||
aliases.has(node.name);
}
if (node.type === "MemberExpression") {
return isRootAlias(node.object);
}
if (node.type === "LogicalExpression") {
return isRootAlias(node.left) || isRootAlias(node.right);
}
if (node.type === "ConditionalExpression") {
return (
isRootAlias(node.consequent) ||
isRootAlias(node.alternate)
);
}
if (node.type === "SequenceExpression") {
return node.expressions.some(isRootAlias);
}
return false;
};
const isBareRootAlias = (input: any): boolean => {
const node = unwrap(input);
if (!node) return false;
if (node.type === "Identifier") {
return browserCapabilityRoots.has(node.name) ||
aliases.has(node.name);
}
if (node.type === "LogicalExpression") {
return (
isBareRootAlias(node.left) ||
isBareRootAlias(node.right)
);
}
if (node.type === "ConditionalExpression") {
return (
isBareRootAlias(node.consequent) ||
isBareRootAlias(node.alternate)
);
}
if (node.type === "SequenceExpression") {
return node.expressions.some(isBareRootAlias);
}
return false;
};
const isDirectBrowserRoot = (input: any): boolean => {
const node = unwrap(input);
return (
node?.type === "Identifier" &&
browserCapabilityRoots.has(node.name)
);
};
const safeMethodThisBinding = (
call: any,
argumentIndex: number,
): boolean => {
if (argumentIndex !== 0) return false;
const callee = unwrap(call.callee);
if (
callee?.type !== "MemberExpression" ||
propertyName(callee) !== "bind"
) {
return false;
}
const target = unwrap(callee.object);
const targetName =
target?.type === "MemberExpression"
? propertyName(target)
: null;
return (
targetName !== null &&
!browserCapabilityProperties.has(targetName) &&
isRootAlias(target.object)
);
};
const rememberPattern = (patternInput: any, source: any): void => {
const pattern = unwrap(patternInput);
if (!pattern || !isRootAlias(source)) return;
if (pattern.type === "Identifier") {
aliases.add(pattern.name);
return;
}
if (pattern.type !== "ObjectPattern") return;
for (const property of pattern.properties ?? []) {
if (property.type !== "Property") continue;
const name =
property.computed
? property.key?.value
: property.key?.name ?? property.key?.value;
if (
typeof name === "string" &&
browserCapabilityProperties.has(name)
) {
context.report({ node: property, messageId: "owned" });
}
}
};
return {
VariableDeclarator(node: any) {
rememberPattern(node.id, node.init);
},
AssignmentExpression(node: any) {
rememberPattern(node.left, node.right);
const target = unwrap(node.left);
if (
target?.type !== "Identifier" &&
target?.type !== "ObjectPattern" &&
isBareRootAlias(node.right)
) {
context.report({ node: node.right, messageId: "owned" });
}
},
AssignmentPattern(node: any) {
rememberPattern(node.left, node.right);
},
PropertyDefinition(node: any) {
if (isBareRootAlias(node.value)) {
context.report({ node: node.value, messageId: "owned" });
}
},
MemberExpression(node: any) {
const name = propertyName(node);
if (
isRootAlias(node.object) &&
((name !== null &&
browserCapabilityProperties.has(name)) ||
(name === null && node.computed))
) {
context.report({ node, messageId: "owned" });
}
},
CallExpression(node: any) {
for (const [index, argument] of (
node.arguments ?? []
).entries()) {
const candidate =
argument.type === "SpreadElement"
? argument.argument
: argument;
if (
isDirectBrowserRoot(candidate) &&
!safeMethodThisBinding(node, index)
) {
context.report({ node: argument, messageId: "owned" });
}
}
const callee = unwrap(node.callee);
if (
callee?.type !== "MemberExpression" ||
propertyName(callee) !== "get" ||
unwrap(callee.object)?.type !== "Identifier" ||
unwrap(callee.object).name !== "Reflect" ||
!isRootAlias(node.arguments?.[0])
) {
return;
}
const key = unwrap(node.arguments?.[1]);
if (
(key?.type === "Literal" ||
key?.type === "StringLiteral") &&
typeof key.value === "string" &&
browserCapabilityProperties.has(key.value)
) {
context.report({ node, messageId: "owned" });
}
},
NewExpression(node: any) {
for (const argument of node.arguments ?? []) {
const candidate =
argument.type === "SpreadElement"
? argument.argument
: argument;
if (isBareRootAlias(candidate)) {
context.report({ node: argument, messageId: "owned" });
}
}
},
Property(node: any) {
if (
node.parent?.type === "ObjectExpression" &&
isBareRootAlias(node.value)
) {
context.report({ node: node.value, messageId: "owned" });
}
},
ArrayExpression(node: any) {
for (const element of node.elements ?? []) {
if (isBareRootAlias(element)) {
context.report({ node: element, messageId: "owned" });
}
}
},
ReturnStatement(node: any) {
if (isBareRootAlias(node.argument)) {
context.report({ node: node.argument, messageId: "owned" });
}
},
ArrowFunctionExpression(node: any) {
if (
node.expression === true &&
isBareRootAlias(node.body)
) {
context.report({ node: node.body, messageId: "owned" });
}
},
};
},
};
const browserDataBoundaryPlugin = {
rules: {
"no-capability-alias": noBrowserCapabilityAliasRule,
},
};
const commonLanguageOptions = {
ecmaVersion: "latest",
sourceType: "module",
globals: {
...globals.browser,
...globals.node,
},
};
const commonSecurityRules = {
"no-eval": "error",
"no-new-func": "error",
"no-script-url": "error",
"no-restricted-syntax": [
"error",
{
selector: "JSXAttribute[name.name='dangerouslySetInnerHTML']",
message: "Raw HTML injection is prohibited by FE-OC-019.",
},
{
selector:
"CallExpression[callee.object.name='document'][callee.property.name='createElement'][arguments.0.value='script']",
message: "Runtime script construction is prohibited by FE-OC-019.",
},
],
};
const hookRules = {
"react-hooks/rules-of-hooks": "error",
"react-hooks/exhaustive-deps": "error",
};
export default [
{
ignores: [
"dist/**",
"node_modules/**",
"artifacts/**",
"tests/fixtures/typecheck/**",
"tests/fixtures/architecture/forbidden/**",
"tests/fixtures/diagnostics/forbidden/**",
"tests/fixtures/i18n/forbidden/**",
"tests/fixtures/security/forbidden/**",
"tests/fixtures/optional-recipes/**",
"tests/fixtures/browser-file-storage-boundaries/**",
],
},
eslint.configs.recommended,
{
files: [`**/*.${sourceExtensions}`],
languageOptions: {
...commonLanguageOptions,
parserOptions: {
ecmaFeatures: { jsx: true },
},
},
plugins: {
"react-hooks": reactHooks,
},
rules: {
...commonSecurityRules,
...hookRules,
},
},
{
files: ["**/*.{ts,mts,cts}"],
languageOptions: {
...commonLanguageOptions,
parser: babelParser,
parserOptions: {
requireConfigFile: false,
babelOptions: {
plugins: [
["@babel/plugin-syntax-typescript", { isTSX: false }],
],
},
},
},
rules: {
"no-undef": "off",
"no-unused-vars": "off",
},
},
{
files: ["**/*.d.ts"],
languageOptions: {
...commonLanguageOptions,
parser: babelParser,
parserOptions: {
requireConfigFile: false,
babelOptions: {
plugins: [
["@babel/plugin-syntax-typescript", { dts: true }],
],
},
},
},
rules: {
"no-undef": "off",
"no-unused-vars": "off",
},
},
{
files: ["**/*.tsx"],
languageOptions: {
...commonLanguageOptions,
parser: babelParser,
parserOptions: {
requireConfigFile: false,
babelOptions: {
plugins: [
[
"@babel/plugin-syntax-typescript",
{ allExtensions: true, isTSX: true },
],
"@babel/plugin-syntax-jsx",
],
},
},
},
rules: {
"no-undef": "off",
"no-unused-vars": "off",
},
},
{
files: [
`src/domain/**/*.${sourceExtensions}`,
`src/application/**/*.${sourceExtensions}`,
`src/presentation/**/*.${sourceExtensions}`,
`src/bootstrap/**/*.${sourceExtensions}`,
`src/features/**/*.${sourceExtensions}`,
`src/adapters/**/*.${sourceExtensions}`,
],
ignores: [
`src/adapters/browser-file-storage/**/*.${sourceExtensions}`,
`src/adapters/browser-files/**/*.${sourceExtensions}`,
`src/adapters/browser-transfer/**/*.${sourceExtensions}`,
`src/adapters/cache-storage/**/*.${sourceExtensions}`,
`src/adapters/cross-context-invalidation/**/*.${sourceExtensions}`,
`src/adapters/service-worker/**/*.${sourceExtensions}`,
`src/bootstrap/register-service-worker.ts`,
`src/adapters/platform/browser-lifecycle.ts`,
`src/adapters/storage/**/*.${sourceExtensions}`,
`src/adapters/storage/indexeddb/**/*.${sourceExtensions}`,
`src/adapters/storage/opfs/**/*.${sourceExtensions}`,
],
plugins: {
"browser-data-boundary": browserDataBoundaryPlugin,
},
rules: {
"browser-data-boundary/no-capability-alias": "error",
},
},
{
// 07-01. Every file outside a layer rule; the layer rules below replace
// this entry and carry the same aliases through restrictedImports.
files: [`src/**/*.${sourceExtensions}`, `tests/**/*.${sourceExtensions}`],
rules: {
"no-restricted-imports": ["error", { patterns: deprecatedAliasImports }],
},
},
{
files: [`src/domain/**/*.${sourceExtensions}`],
rules: {
"no-restricted-imports": restrictedImports(layerPatterns.domain, layerMessages.domain),
"no-restricted-properties": restrictedBrowserDataProperties,
"no-restricted-globals": [
"error",
"window",
"document",
"BroadcastChannel",
"localStorage",
"sessionStorage",
"fetch",
"indexedDB",
"caches",
"navigator",
"File",
"Blob",
"FileSystemFileHandle",
"FileSystemDirectoryHandle",
"showOpenFilePicker",
"showSaveFilePicker",
],
},
},
{
files: [`src/application/**/*.${sourceExtensions}`],
rules: {
"no-restricted-imports": restrictedImports(layerPatterns.application, layerMessages.application),
"no-restricted-properties": restrictedBrowserDataProperties,
"no-restricted-globals": [
"error",
"window",
"document",
"BroadcastChannel",
"localStorage",
"sessionStorage",
"fetch",
"indexedDB",
"caches",
"navigator",
"File",
"Blob",
"FileSystemFileHandle",
"FileSystemDirectoryHandle",
"showOpenFilePicker",
"showSaveFilePicker",
],
},
},
{
files: [`src/presentation/**/*.${sourceExtensions}`],
rules: {
"no-restricted-imports": restrictedImports(layerPatterns.presentation, layerMessages.presentation),
"no-restricted-properties": restrictedBrowserDataProperties,
"no-restricted-globals": [
"error",
"fetch",
"BroadcastChannel",
"localStorage",
"sessionStorage",
"indexedDB",
"caches",
"File",
"Blob",
"FileSystemFileHandle",
"FileSystemDirectoryHandle",
"showOpenFilePicker",
"showSaveFilePicker",
],
},
},
{
files: [
`src/presentation/adapters/query/**/*.${sourceExtensions}`,
],
rules: {
"no-restricted-imports": restrictedImports(
[
"**/adapters/http/**",
"**/adapters/storage/**",
"**/adapters/auth/**",
"**/bootstrap/**",
"**/application/ports/out/**",
],
"the TanStack Query binding may import @tanstack only; reach adapters through application ports (presentation-does-not-know-adapters).",
),
},
},
{
files: [`src/presentation/templates/**/*.${sourceExtensions}`],
rules: {
"no-restricted-imports": restrictedImports(
[
"**/application/**",
"**/adapters/**",
"**/bootstrap/**",
"@tanstack/**",
],
"page templates own layout only (page-templates-own-layout-only). Take data and actions as props from the page.",
),
},
},
{
files: [
`src/bootstrap/**/*.${sourceExtensions}`,
`src/features/installed-feature-*.${sourceExtensions}`,
],
rules: {
"no-restricted-properties": restrictedBrowserDataProperties,
"no-restricted-globals": [
"error",
"BroadcastChannel",
"localStorage",
"sessionStorage",
"indexedDB",
"caches",
"File",
"Blob",
"FileSystemFileHandle",
"FileSystemDirectoryHandle",
"showOpenFilePicker",
"showSaveFilePicker",
],
},
},
{
files: [`src/adapters/**/*.${sourceExtensions}`],
rules: {
"no-restricted-imports": restrictedImports(layerPatterns.adapters, layerMessages.adapters),
"no-restricted-properties": restrictedBrowserDataProperties,
"no-restricted-globals": [
"error",
"BroadcastChannel",
"localStorage",
"sessionStorage",
"indexedDB",
"caches",
"navigator",
"File",
"Blob",
"FileSystemFileHandle",
"FileSystemDirectoryHandle",
"showOpenFilePicker",
"showSaveFilePicker",
],
},
},
{
files: [
`src/adapters/browser-file-storage/**/*.${sourceExtensions}`,
`src/adapters/browser-files/**/*.${sourceExtensions}`,
`src/adapters/browser-transfer/**/*.${sourceExtensions}`,
`src/adapters/cache-storage/**/*.${sourceExtensions}`,
`src/adapters/cross-context-invalidation/**/*.${sourceExtensions}`,
`src/adapters/service-worker/**/*.${sourceExtensions}`,
`src/bootstrap/register-service-worker.ts`,
`src/adapters/platform/browser-lifecycle.ts`,
`src/adapters/storage/**/*.${sourceExtensions}`,
`src/adapters/storage/indexeddb/**/*.${sourceExtensions}`,
`src/adapters/storage/opfs/**/*.${sourceExtensions}`,
],
rules: {
"no-restricted-properties": "off",
"no-restricted-globals": "off",
},
},
{
files: [`src/features/*/domain/**/*.${sourceExtensions}`],
rules: {
"no-restricted-imports": restrictedImports(layerPatterns.domain, layerMessages.domain),
"no-restricted-properties": restrictedBrowserDataProperties,
"no-restricted-globals": [
"error",
"window",
"document",
"BroadcastChannel",
"localStorage",
"sessionStorage",
"fetch",
"indexedDB",
"caches",
"navigator",
"File",
"Blob",
"FileSystemFileHandle",
"FileSystemDirectoryHandle",
"showOpenFilePicker",
"showSaveFilePicker",
],
},
},
{
files: [`src/features/*/application/**/*.${sourceExtensions}`],
rules: {
"no-restricted-imports": restrictedImports(layerPatterns.application, layerMessages.application),
"no-restricted-properties": restrictedBrowserDataProperties,
"no-restricted-globals": [
"error",
"window",
"document",
"BroadcastChannel",
"localStorage",
"sessionStorage",
"fetch",
"indexedDB",
"caches",
"navigator",
"File",
"Blob",
"FileSystemFileHandle",
"FileSystemDirectoryHandle",
"showOpenFilePicker",
"showSaveFilePicker",
],
},
},
{
files: [`src/features/*/presentation/**/*.${sourceExtensions}`],
rules: {
"no-restricted-imports": restrictedImports(
[
"**/features/*/adapters/**",
"**/adapters/http/**",
"**/adapters/storage/**",
"**/adapters/auth/**",
"**/bootstrap/**",
"**/application/ports/out/**",
"@tanstack/**",
],
"feature presentation calls its application API (feature-presentation-does-not-know-outbound-adapters). Bootstrap wires the adapters.",
),
"no-restricted-properties": restrictedBrowserDataProperties,
"no-restricted-globals": [
"error",
"fetch",
"BroadcastChannel",
"localStorage",
"sessionStorage",
"indexedDB",
"caches",
"File",
"Blob",
"FileSystemFileHandle",
"FileSystemDirectoryHandle",
"showOpenFilePicker",
"showSaveFilePicker",
],
},
},
{
files: [`src/features/*/adapters/**/*.${sourceExtensions}`],
rules: {
"no-restricted-imports": restrictedImports(
[
"**/presentation/**",
"**/bootstrap/**",
"@tanstack/**",
],
"a feature adapter implements the feature's ports and never imports UI or bootstrap (feature-adapters-do-not-know-presentation).",
),
"no-restricted-properties": restrictedBrowserDataProperties,
"no-restricted-globals": [
"error",
"BroadcastChannel",
"localStorage",
"sessionStorage",
"indexedDB",
"caches",
"navigator",
"File",
"Blob",
"FileSystemFileHandle",
"FileSystemDirectoryHandle",
"showOpenFilePicker",
"showSaveFilePicker",
],
},
},
{
files: [`tests/**/*.${sourceExtensions}`],
languageOptions: {
globals: {
...globals.browser,
...globals.node,
},
},
},
{
files: [`tests/support/browser/**/*.${sourceExtensions}`],
rules: {
"react-hooks/rules-of-hooks": "off",
},
},
{
files: [
`tests/fixtures/architecture/forbidden/**/*.${sourceExtensions}`,
],
rules: {
"no-restricted-imports": restrictedImports(
[
"**/adapters/**",
"**/application/ports/out/**",
"@tanstack/**",
"react",
"react-dom",
"**/application/**",
],
"forbidden architecture fixture: this import must be rejected.",
),
"no-restricted-globals": [
"error",
"fetch",
"localStorage",
"sessionStorage",
],
},
},
{
files: [
`tests/fixtures/browser-file-storage-boundaries/forbidden/**/*.${sourceExtensions}`,
],
plugins: {
"browser-data-boundary": browserDataBoundaryPlugin,
},
rules: {
"browser-data-boundary/no-capability-alias": "error",
"no-restricted-properties": restrictedBrowserDataProperties,
"no-restricted-globals": [
"error",
"BroadcastChannel",
"localStorage",
"sessionStorage",
"indexedDB",
"caches",
"File",
"Blob",
"FileSystemFileHandle",
"FileSystemDirectoryHandle",
"showOpenFilePicker",
"showSaveFilePicker",
],
},
},
{
// 13-06. Vite inlines every loaded VITE_* value into the bundle wherever
// code references the whole `import.meta.env` object, including values no
// code reads. Keyed reads are replaced one by one.
files: [`src/**/*.${sourceExtensions}`],
plugins: {
"build-env": {
rules: {
"no-whole-import-meta-env": {
meta: {
type: "problem",
schema: [],
messages: {
whole:
"Read build variables by key (import.meta.env.VITE_NAME). Referencing import.meta or import.meta.env as a whole bundles every VITE_* value (13-06).",
},
},
create(context: any) {
const isMember = (node: any) =>
node?.type === "MemberExpression" ||
node?.type === "OptionalMemberExpression";
return {
MetaProperty(node: any) {
if (node.meta?.name !== "import") return;
const member = node.parent;
if (!isMember(member) || member.object !== node || member.computed) {
context.report({ node, messageId: "whole" });
return;
}
if (member.property?.name !== "env") return;
const read = member.parent;
if (isMember(read) && read.object === member && !read.computed) {
return;
}
context.report({ node: member, messageId: "whole" });
},
};
},
},
},
},
},
rules: {
"build-env/no-whole-import-meta-env": "error",
},
},
];