From 3d34da115aa0b8574faa2a16ff19eb82d35ad84a Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Fri, 13 Nov 2026 18:40:13 +0900 Subject: [PATCH] =?UTF-8?q?perf(styles):=20Tailwind=EA=B0=80=20src=20?= =?UTF-8?q?=EB=B0=96=20=ED=8C=8C=EC=9D=BC=EC=9D=98=20=EB=82=B1=EB=A7=90?= =?UTF-8?q?=EB=A1=9C=20=EC=9C=A0=ED=8B=B8=EB=A6=AC=ED=8B=B0=EB=A5=BC=20?= =?UTF-8?q?=EB=A7=8C=EB=93=A4=EC=A7=80=20=EC=95=8A=EB=8A=94=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit `src/presentation/styles/theme.css`의 `@import "tailwindcss";`에 `source()`가 없어 Tailwind v4가 `.gitignore` 밖 파일을 모두 훑는다. 템플릿 TSX는 유틸리티 class를 쓰지 않고 `@apply`만 쓰는데, 빌드 CSS의 `@layer utilities`에 docs· tests·scripts의 낱말에서 나온 규칙 35~40개(`.shadow\/canary`, `.sepia`, `.cursor-not-allowed`, `.\!relative` 등)가 실린다. 모든 페이지가 기다리는 CSS가 약 0.7~0.9 KB gzip 커지고, 문서나 시험만 고친 release도 CSS 이름이 바뀌어 재방문자가 CSS를 다시 받는다. 고른 방법: `@import "tailwindcss" source("../../");`로 훑는 범위를 `src/`로 좁힌다. 제품이 `src/` 안의 className에 유틸리티를 쓰면 그대로 생긴다. 버린 대안: `source(none)`(제품이 유틸리티 class를 쓸 수 없어진다. 디자인 시스템 계약을 바꾸는 일이다). 위험·한계: 유틸리티 class를 `src/` 밖(예: `index.html`)에만 쓴 제품은 그 규칙을 잃는다. 템플릿에는 그런 곳이 없다. 검증: `tests/unit/design-system-initial-chunk.test.ts`의 새 사례가 src 밖 fixture(`tests/fixtures/tailwind-source/outside-src.txt`의 `outline-[3.21px]`)가 빌드 CSS에 없음을 본다. 고치기 전에 실패하고 고친 뒤 통과한다. 시각 골든은 FE-GATE-008이 본다(desktop, PR 본문). Refs: 1112/06-03 --- src/presentation/styles/theme.css | 4 +- .../fixtures/tailwind-source/outside-src.txt | 4 ++ .../unit/design-system-initial-chunk.test.ts | 50 ++++++++++++++----- 3 files changed, 45 insertions(+), 13 deletions(-) create mode 100644 tests/fixtures/tailwind-source/outside-src.txt diff --git a/src/presentation/styles/theme.css b/src/presentation/styles/theme.css index c0df5bc5..da311588 100644 --- a/src/presentation/styles/theme.css +++ b/src/presentation/styles/theme.css @@ -1,4 +1,6 @@ -@import "tailwindcss"; +/* Tailwind takes class names from src/ only (1112/06-03): words in docs, tests + and scripts must not add rules to the stylesheet every page waits for. */ +@import "tailwindcss" source("../../"); @import "../design-system/tokens/primitive.css"; @import "../design-system/tokens/semantic.css"; @import "../design-system/tokens/component.css"; diff --git a/tests/fixtures/tailwind-source/outside-src.txt b/tests/fixtures/tailwind-source/outside-src.txt new file mode 100644 index 00000000..90026325 --- /dev/null +++ b/tests/fixtures/tailwind-source/outside-src.txt @@ -0,0 +1,4 @@ +A Tailwind utility written outside src/ (1112/06-03). The production +stylesheet must not contain it: Tailwind scans only src/ for class names. + +outline-[3.21px] diff --git a/tests/unit/design-system-initial-chunk.test.ts b/tests/unit/design-system-initial-chunk.test.ts index 4495208a..41167d03 100644 --- a/tests/unit/design-system-initial-chunk.test.ts +++ b/tests/unit/design-system-initial-chunk.test.ts @@ -38,19 +38,30 @@ afterAll(async () => { await Promise.all(roots.map((root) => rm(root, { recursive: true, force: true }))); }); +let built: Promise | undefined; + +/** One production build for the file's tests. */ +function build(): Promise { + built ??= (async () => { + const outDir = await mkdtemp(path.join(tmpdir(), "design-system-chunk-")); + roots.push(outDir); + const environment = Object.fromEntries( + Object.entries(process.env).filter(([name]) => !name.startsWith("VITE_")), + ); + const run = spawnSync( + path.resolve("node_modules/.bin/vite"), + ["build", "--outDir", outDir, "--emptyOutDir", "--logLevel", "error"], + { encoding: "utf8", env: environment }, + ); + expect(run.stderr).toBe(""); + expect(run.status).toBe(0); + return outDir; + })(); + return built; +} + async function initialJavascript(): Promise { - const outDir = await mkdtemp(path.join(tmpdir(), "design-system-chunk-")); - roots.push(outDir); - const environment = Object.fromEntries( - Object.entries(process.env).filter(([name]) => !name.startsWith("VITE_")), - ); - const run = spawnSync( - path.resolve("node_modules/.bin/vite"), - ["build", "--outDir", outDir, "--emptyOutDir", "--logLevel", "error"], - { encoding: "utf8", env: environment }, - ); - expect(run.stderr).toBe(""); - expect(run.status).toBe(0); + const outDir = await build(); const manifest = JSON.parse( await readFile(path.join(outDir, ".vite/manifest.json"), "utf8"), ) as Parameters[0]; @@ -73,6 +84,21 @@ describe("design-system code in the initial JavaScript (1101/08-08)", () => { expect(LAZY_ONLY_CLASSES.filter((name) => renders(code, name))).toEqual([]); }, childProcessTimeout(4_556)); + // 1112/06-03. Tailwind scans the files it is pointed at for class names. + // Words in docs, tests and scripts must not add rules to the stylesheet + // every page blocks on (tests/fixtures/tailwind-source/outside-src.txt). + it("generates utilities from src only, not from docs, tests or scripts", async () => { + const outDir = await build(); + const assets = path.join(outDir, "assets"); + const stylesheets = (await readdir(assets)).filter((file) => file.endsWith(".css")); + const css = ( + await Promise.all(stylesheets.map((file) => readFile(path.join(assets, file), "utf8"))) + ).join("\n"); + + expect(css).toContain(".ui-button"); + expect(css).not.toContain("3.21px"); + }, childProcessTimeout(4_556)); + // vite.config.ts declares these modules free of side effects, so the bundler // drops a module none of whose exports is used. An import kept only for its // effect (a stylesheet, a polyfill, a registration) would vanish with it.