이미지 최적화 및 변환 작업 개선

메인: 홈 배경 WebP 추가 및 CSS 이미지 경로 전환

기술 역량: 솔루션 04 오브젝트 이미지 교체, 배치 설정 정리 및 썸네일 재생성

도구: WebP 누락 파일 우선 처리, 진행 표시, 파일명 필터와 강제 덮어쓰기 옵션 추가

scripts/generate-capability-webp.mjs

@@ -1,5 +1,5 @@
 // 기술 역량 원본 이미지를 웹 전송용 WebP로 변환합니다.
-// 실행: node scripts/generate-capability-webp.mjs [--force]
+// 실행: node scripts/generate-capability-webp.mjs [파일명 일부] [--force]
 import fs from "node:fs";
 import path from "node:path";
 import vm from "node:vm";
@@ -8,6 +8,7 @@ import { fileURLToPath } from "node:url";
 
 const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
 const force = process.argv.includes("--force");
+const filters = process.argv.slice(2).filter((argument) => !argument.startsWith("--"));
 const context = { window: {} };
 vm.runInNewContext(fs.readFileSync(path.join(root, "js", "capabilities-data.js"), "utf8"), context);
 
@@ -34,21 +35,31 @@ function optimizedPath(source) {
     .replace(/\.(?:png|jpe?g)$/i, ".webp");
 }
 
-let sourceBytes = 0;
-let outputBytes = 0;
-let generated = 0;
-
-for (const [relativeSource, type] of sources) {
+const assets = Array.from(sources, ([relativeSource, type]) => {
   const source = path.join(root, relativeSource);
   const target = path.join(root, optimizedPath(relativeSource));
   const sourceStat = fs.statSync(source);
-  sourceBytes += sourceStat.size;
-  fs.mkdirSync(path.dirname(target), { recursive: true });
+  const targetStat = fs.existsSync(target) ? fs.statSync(target) : null;
+  return { relativeSource, type, source, target, sourceStat, targetStat };
+}).filter(({ relativeSource }) =>
+  !filters.length || filters.some((filter) => relativeSource.includes(filter)));
 
-  if (!force && fs.existsSync(target) && fs.statSync(target).mtimeMs >= sourceStat.mtimeMs) {
-    outputBytes += fs.statSync(target).size;
-    continue;
-  }
+if (!assets.length) {
+  throw new Error(`일치하는 기술 역량 이미지가 없습니다: ${filters.join(", ")}`);
+}
+
+// 삭제된 결과물을 먼저 복구하고, 나머지는 데이터에 정의된 순서대로 처리합니다.
+assets.sort((a, b) => Number(Boolean(a.targetStat)) - Number(Boolean(b.targetStat)));
+
+const pending = assets.filter(({ sourceStat, targetStat }) =>
+  force || !targetStat || targetStat.mtimeMs < sourceStat.mtimeMs);
+let sourceBytes = assets.reduce((total, { sourceStat }) => total + sourceStat.size, 0);
+let outputBytes = assets.reduce((total, asset) =>
+  pending.includes(asset) ? total : total + asset.targetStat.size, 0);
+
+for (const [index, { relativeSource, type, source, target }] of pending.entries()) {
+  fs.mkdirSync(path.dirname(target), { recursive: true });
+  console.log(`[${index + 1}/${pending.length}] ${relativeSource}`);
 
   const { width, height } = dimensions(source);
   const maxWidth = type === "background" ? 2560 : 2400;
@@ -61,11 +72,10 @@ for (const [relativeSource, type] of sources) {
   args.push(source, "-o", target);
   execFileSync("cwebp", args, { stdio: "inherit" });
   outputBytes += fs.statSync(target).size;
-  generated += 1;
 }
 
 const savedPercent = Math.round((1 - outputBytes / sourceBytes) * 100);
 console.log(
-  `${generated ? `Generated ${generated}` : "Checked"} WebP assets: ` +
+  `${pending.length ? `Generated ${pending.length}` : "Checked"} WebP assets: ` +
   `${(sourceBytes / 1048576).toFixed(1)}MB -> ${(outputBytes / 1048576).toFixed(1)}MB (${savedPercent}% reduction)`,
 );