@spectrabrain/eds 0.3.0 → 0.4.0

package/consumer/align-rules.mjs

@@ -16,10 +16,20 @@ export const conventionsFileName = "FRONTEND_CONVENTIONS.md";
 export const layerOrder = ["app", "pages", "widgets", "features", "entities", "shared"];
 // Layers whose second path segment is a slice (pages/<domain>, widgets/<name>, features/<domain>, entities/<domain>).
 export const slicedLayers = new Set(["pages", "widgets", "features", "entities"]);
-// src/ entries allowed besides the layers: MSW handlers, global declaration files and the file eds sync generates.
-export const auxiliarySourceDirectories = ["mocks", "types", "styles"];
+// Existing auxiliary source directories accepted alongside the FSD layers.
+export const auxiliarySourceDirectories = ["types", "styles"];
 export const allowedSourceRootFiles = ["vite-env.d.ts"];
 export const generatedStylesFileName = "eds-tokens.css";
+export const maximumSupportedViteMajor = 8;
+export const preservedResourceDirectoryNames = [
+  "i18n", "i18next", "intl", "locale", "locales", "lang", "language", "languages", "localization", "localizations",
+  "translation", "translations",
+];
+export const preservedResourceDirectoryPattern = /^(?:i18n(?:ext)?|intl|locales?|languages?|lang|localizations?|translations?)(?:[A-Z][A-Za-z0-9]*|[-_.][^/]+)?$/i;
+export const preservedResourceFilePattern = /^(?:i18n(?:ext)?|intl|locales?|languages?|lang|localizations?|translations?)(?:[A-Z][A-Za-z0-9]*|[-_.][^/]+)?\.(?:[^./]+(?:\.[^./]+)*)$/i;
+export const preservedResourceHookPattern = /^use(?:translation|i18n|locale|language)[A-Za-z0-9_-]*\.[cm]?[jt]sx?$/i;
+export const preservedMockPathPattern = /(?:^|\/)(?:__mocks__|mocks?)(?:\/|$)|(?:^|[._-])mocks?(?:[._-]|$)/i;
+export const preservedMockCamelCaseFilePattern = /(?:^|[a-z0-9])Mocks?(?:[A-Z][A-Za-z0-9_-]*)?(?:\.[^./]+)+$|^[Mm]ock[A-Z][A-Za-z0-9_-]*(?:\.[^./]+)+$/;
 
 export const appEntries = ["main.tsx", "App.tsx", "providers", "router", "styles"];
 export const entitySegments = ["components", "hooks", "services", "stores", "types", "lib"];
@@ -78,9 +88,43 @@ export const requiredDevDependencies = [
 // Vite 8 moved Babel out of @vitejs/plugin-react; the React Compiler then runs through this plugin.
 export const rolldownBabelPackage = "@rolldown/plugin-babel";
 export const minimumMajors = { react: 19, "@tanstack/react-query": 5, tailwindcss: 4 };
+export const minimumVersions = {
+  vite: "5.2.0",
+  nodeForVite8: "22.12.0",
+  pluginReactForVite5: "4.2.1",
+  pluginReactForVite6: "4.4.0",
+  pluginReactForVite7: "4.7.0",
+  pluginReactForVite8: "6.0.1",
+  tailwindViteForVite7: "4.2.0",
+  tailwindViteForVite8: "4.3.2",
+  babelCoreForVite8: "7.29.0",
+  rolldownPluginForVite8: "0.1.7",
+  reactCompilerForVite8: "1.0.0",
+};
+
+export function minimumPluginReactVersion(viteMajor) {
+  if (viteMajor === 8) {
+    return minimumVersions.pluginReactForVite8;
+  }
+  if (viteMajor !== null && viteMajor > maximumSupportedViteMajor) {
+    return null;
+  }
+  if (viteMajor === 7) return minimumVersions.pluginReactForVite7;
+  if (viteMajor === 6) return minimumVersions.pluginReactForVite6;
+  return minimumVersions.pluginReactForVite5;
+}
+
+export function minimumTailwindViteVersion(viteMajor) {
+  if (viteMajor === 7) return minimumVersions.tailwindViteForVite7;
+  if (viteMajor === 8) {
+    return minimumVersions.tailwindViteForVite8;
+  }
+  return null;
+}
 
 // Install ranges the templates are written against. Packages without a range install at their latest version.
 export const installRanges = {
+  vite: "^5.2.0",
   eslint: "^9.22",
   "@eslint/js": "^9.22",
   "typescript-eslint": "^8",
@@ -90,6 +134,8 @@ export const installRanges = {
   "babel-plugin-react-compiler": "^1",
   tailwindcss: "^4",
   "@tailwindcss/vite": "^4",
+  "@babel/core": "^7.29.0",
+  "@rolldown/plugin-babel": "^0.2.0",
   "@types/react": "^19",
   "@types/react-dom": "^19",
   "@tanstack/react-query": "^5",
@@ -106,20 +152,20 @@ export const templateToolMinimums = {
   "eslint-plugin-react-refresh": "0.4.20",
 };
 // Installed with the tooling step although no check requires them: the templates reference them.
-export const templateDevDependencies = ["vite-plugin-svgr", "terser", "tw-animate-css", "msw"];
+export const templateDevDependencies = ["vite-plugin-svgr", "terser", "tw-animate-css"];
 // The lucide-react version EDS depends on: a consumer that imports lucide-react directly declares the same one, so the
 // icon code is bundled once.
 export const edsLucideVersion = JSON.parse(fs.readFileSync(path.join(path.dirname(fileURLToPath(import.meta.url)), "..", "package.json"), "utf8")).dependencies?.["lucide-react"] ?? null;
-// Installed in step 6 only when the app calls a REST API that gets MSW handlers.
-export const mockDevDependencies = ["@faker-js/faker"];
-
-// Tests are outside the conventions: a prototype's test policy may change at any time. eds align neither requires,
-// replaces nor lists test tooling, and leaves test files, test directories and test setup files where they are.
-export const testDirectoryNames = ["test", "tests", "__tests__", "__mocks__"];
-export const testFilePattern = /\.(?:test|spec)\.[cm]?[jt]sx?$/;
-export const testSetupFilePattern = /^(?:setupTests|setup-tests|testSetup|test-setup|vitest\.setup|jest\.setup)\.[cm]?[jt]sx?$/;
+// Recognize these paths only to keep existing test files and settings unchanged.
+export const testDirectoryNames = ["test", "tests", "testing", "test-utils", "testutils", "test-helpers", "testhelpers", "spec", "specs", "__tests__", "__mocks__", "__snapshots__", "__fixtures__", "cypress", "e2e", "e2e-tests", "playwright"];
+export const testFilePattern = /\.(?:test|spec|cy|e2e)\.[cm]?[jt]sx?$/i;
+export const testSupportFilePattern = /^(?:test[-_.][^/]+|[^/]+[-_.](?:test|tests|spec|specs|cy|e2e))\.[cm]?[jt]sx?$/i;
+export const testHelperFilePattern = /^(?:[Tt]est[A-Z][A-Za-z0-9_-]*|testutils|testhelpers|testsetup)\.[cm]?[jt]sx?$/;
+export const testSetupFilePattern = /^(?:setupTests|setup-tests|testSetup|test-setup|vitest\.setup|jest\.setup)\.[cm]?[jt]sx?$/i;
+export const testConfigFilePattern = /^(?:(?:vitest|jest|cypress|playwright|mocha|karma)(?:-[^/]+)?\.config\.[cm]?[jt]sx?|tsconfig(?:[-.](?:test|tests|spec|specs|e2e|cypress|playwright|vitest|jest))\.json)$/i;
 export const testToolingPattern =
-  /^(?:jest|jest-.+|@jest\/.+|ts-jest|babel-jest|vitest|@vitest\/.+|@testing-library\/.+|cypress|@cypress\/.+|playwright|@playwright\/.+|happy-dom|jsdom|enzyme|enzyme-.+|identity-obj-proxy|mocha|chai|sinon|nock|supertest)$/;
+  /^(?:jest|jest-.+|@jest\/.+|ts-jest|babel-jest|vitest|vitest-.+|@vitest\/.+|@testing-library\/.+|cypress|@cypress\/.+|playwright|playwright-.+|@playwright\/.+|@storybook\/(?:test|test-runner|testing-library|addon-test|addon-vitest)|@axe-core\/.+|jest-axe|happy-dom|jsdom|enzyme|enzyme-.+|identity-obj-proxy|react-test-renderer|mocha|chai|sinon|nock|supertest|karma|karma-.+|jasmine|jasmine-core)$/;
+export const preservedResourceDependencyPattern = /i18n|i18next|localization|translation|intl|formatjs|lingui|messageformat|msw|mock|mirage|faker/i;
 
 // Libraries a prototype often brings and the EVA standard that replaces each category.
 export const replacementRules = [
@@ -241,7 +287,6 @@ export const replacementRules = [
   { category: "toast", target: "sonner", packages: ["react-toastify", "react-hot-toast", "notistack"] },
   { category: "date", target: "date-fns", packages: ["moment", "moment-timezone", "dayjs", "luxon"] },
   { category: "virtual-list", target: "react-virtuoso", packages: ["react-window", "react-virtualized", "@tanstack/react-virtual"] },
-  { category: "api-mock", target: "msw", packages: ["miragejs"] },
   {
     category: "lint-format",
     target: "ESLint flat config + Prettier",
@@ -402,7 +447,7 @@ export const backendScriptPattern =
 // Lockfiles at the repository root change when a workspace package installs dependencies.
 export const rootLockfiles = ["package-lock.json", "npm-shrinkwrap.json", "pnpm-lock.yaml", "yarn.lock", "bun.lock", "bun.lockb"];
 
-export const testSupportHint = "테스트 코드는 정렬 대상이 아니므로 그대로 둡니다";
+export const preservedSourceHint = "기존 파일과 설정을 그대로 둡니다";
 
 // Where the usual prototype directories go. Keys are src/ top-level names (lower case).
 export const structureHints = {
@@ -449,20 +494,11 @@ export const structureHints = {
   config: "shared/lib/ · entities/<domain>/types/enums.ts",
   constants: "shared/lib/ · entities/<domain>/types/enums.ts",
   consts: "shared/lib/ · entities/<domain>/types/enums.ts",
-  i18n: "shared/lib/ (기존 i18n 설정은 지우지 않고 옮깁니다. 새 문구는 「UI 문구」를 따릅니다)",
-  locales: "shared/lib/ (기존 번역 파일은 지우지 않고 옮깁니다)",
-  lang: "shared/lib/ (기존 번역 파일은 지우지 않고 옮깁니다)",
-  translations: "shared/lib/ (기존 번역 파일은 지우지 않고 옮깁니다)",
-  mocks: "mocks/<domain>/index.ts",
   integrations: "shared/api/ (backend client SDK)",
   "app.tsx": "app/App.tsx",
   "app.jsx": "app/App.tsx",
   "main.tsx": "app/main.tsx",
   "main.jsx": "app/main.tsx",
-  "i18n.ts": "shared/lib/i18n.ts (기존 i18n 설정은 지우지 않고 옮깁니다)",
-  "i18n.tsx": "shared/lib/i18n.ts (기존 i18n 설정은 지우지 않고 옮깁니다)",
-  "i18n.js": "shared/lib/i18n.ts (기존 i18n 설정은 지우지 않고 옮깁니다)",
-  "i18n.jsx": "shared/lib/i18n.ts (기존 i18n 설정은 지우지 않고 옮깁니다)",
   "index.tsx": "app/main.tsx",
   "index.jsx": "app/main.tsx",
   "index.css": "app/styles/index.css",