@saeroon/cli 0.2.3 → 0.2.5

package/README.md

@@ -54,6 +54,7 @@ npx @saeroon/cli deploy --target production
 | `add` | schema.json에 블록 추가 (기본 props + 부모 children 자동 연결) |
 | `upload` | 이미지를 Saeroon CDN에 업로드. `--replace-in`으로 경로 자동 교체 |
 | `generate` | AI로 사이트 스키마 생성 (`--ref` URL 분석 / `--prompt` 텍스트) |
+| `analyze` | 레퍼런스 URL 분석 (스크린샷 + DOM/CSS + 비디오 감지 + Pexels 스톡 매칭) |
 | `compare` | 레퍼런스 ↔ 프리뷰 시각 비교 (Playwright 스크린샷 diff) |
 
 ### Deployment
@@ -89,9 +90,9 @@ init ──→ preview ──→ validate ──→ deploy --target staging
 ### AI-Assisted Creation
 
 ```
-generate --ref <url> ──→ validate --local ──→ add <블록> ──→ preview
-        or                                                      │
-generate --prompt <text>                              upload ./assets/
+analyze <url> ──→ generate --ref <url> ──→ validate --local ──→ preview
+  (스크린샷 +      or                                              │
+   비디오 매칭)   generate --prompt <text>              upload ./assets/
                                                       --replace-in schema.json
                                                                 │
                                                           compare --ref ──→ deploy
@@ -197,6 +198,10 @@ npx @saeroon/cli deploy --dry-run
 ~/.saeroon/config.json     ← API 키, 기본 설정 (login으로 생성)
 ./saeroon.config.json      ← 프로젝트별 siteId, templateId (init으로 생성)
 ./schema.json              ← 사이트 스키마 정의
+
+# 환경변수
+SAEROON_API_KEY            ← Saeroon API Key
+PEXELS_API_KEY             ← Pexels API Key (비디오 스톡 검색, 무료 — pexels.com/api)
 ```
 
 ## Block Scaffolding
@@ -214,6 +219,19 @@ npx @saeroon/cli add image-block --parent root --after hero-1
 npx @saeroon/cli add content-showcase --id insights --parent main --page about
 ```
 
+## Reference Analysis
+
+```bash
+# 레퍼런스 URL 분석 (스크린샷 4장 + DOM/CSS + 비디오 감지)
+npx @saeroon/cli analyze https://example.com
+
+# 업종 지정 (비디오 검색 키워드에 사용)
+npx @saeroon/cli analyze https://example.com --industry cafe
+
+# Pexels API Key 설정 시 비디오 자동 매칭 (video-stock-map.json 생성)
+# 설정: PEXELS_API_KEY 환경변수 또는 .saeroon/config.json의 pexelsApiKey
+```
+
 ## AI Generation
 
 ```bash

package/dist/index.js

@@ -98,6 +98,12 @@ async function getApiBaseUrl() {
   const url = config.apiBaseUrl || DEFAULT_API_BASE_URL;
   return validateApiBaseUrl(url);
 }
+async function resolvePexelsApiKey() {
+  const envKey = process.env.PEXELS_API_KEY;
+  if (envKey) return envKey;
+  const config = await loadConfig();
+  return config.pexelsApiKey ?? null;
+}
 var PRIVATE_IP_PATTERNS = [
   /^10\./,
   /^172\.(1[6-9]|2\d|3[01])\./,
@@ -2468,6 +2474,51 @@ async function commandPreview(schemaPath, options) {
 import chalk8 from "chalk";
 
 // src/lib/local-validator.ts
+var ELEMENT_TYPE_PROPS = {
+  "heading-block.level": {
+    validValues: /* @__PURE__ */ new Set(["h1", "h2", "h3", "h4", "h5", "h6"]),
+    coerce: (v) => typeof v === "number" && v >= 1 && v <= 6 ? `h${v}` : null
+  },
+  "container.semanticTag": {
+    validValues: /* @__PURE__ */ new Set([
+      "section",
+      "article",
+      "aside",
+      "figure",
+      "figcaption",
+      "ul",
+      "ol",
+      "li",
+      "dl",
+      "dt",
+      "dd",
+      "table",
+      "thead",
+      "tbody",
+      "tfoot",
+      "tr",
+      "td",
+      "th",
+      "details",
+      "summary",
+      "dialog",
+      "form",
+      "fieldset",
+      "legend",
+      "nav",
+      "main",
+      "header",
+      "footer",
+      "address",
+      "blockquote",
+      "pre",
+      "code",
+      "progress",
+      "meter"
+    ]),
+    coerce: () => null
+  }
+};
 var VALID_BLOCK_TYPES = /* @__PURE__ */ new Set([
   // Primitives (10)
   "container",
@@ -2593,6 +2644,42 @@ function validateSchemaLocal(schema) {
           step: 2
         });
       }
+      const props = block.props;
+      if (props) {
+        for (const [key, rule] of Object.entries(ELEMENT_TYPE_PROPS)) {
+          const [targetType, propName] = key.split(".");
+          if (blockType !== targetType) continue;
+          const value = props[propName];
+          if (value == null) continue;
+          if (typeof value === "string") {
+            if (!rule.validValues.has(value)) {
+              errors.push({
+                severity: "error",
+                message: `\uBE14\uB85D "${blockId}": ${propName} \uAC12 "${value}"\uC774(\uAC00) \uC720\uD6A8\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. \uD5C8\uC6A9: ${[...rule.validValues].join(", ")}`,
+                path: `${blockPath}.props.${propName}`,
+                step: 2
+              });
+            }
+          } else {
+            const coerced = rule.coerce?.(value);
+            if (coerced && rule.validValues.has(coerced)) {
+              errors.push({
+                severity: "warning",
+                message: `\uBE14\uB85D "${blockId}": ${propName} \uAC12 ${JSON.stringify(value)}\uC740(\uB294) \uBB38\uC790\uC5F4\uC774\uC5B4\uC57C \uD569\uB2C8\uB2E4. "${coerced}"\uB85C \uBCC0\uD658\uD558\uC138\uC694. (\uB80C\uB354\uB9C1 \uD06C\uB798\uC2DC \uC704\uD5D8)`,
+                path: `${blockPath}.props.${propName}`,
+                step: 2
+              });
+            } else {
+              errors.push({
+                severity: "error",
+                message: `\uBE14\uB85D "${blockId}": ${propName} \uAC12 ${JSON.stringify(value)}\uC740(\uB294) \uC720\uD6A8\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. \uBB38\uC790\uC5F4\uC774\uC5B4\uC57C \uD558\uBA70 \uD5C8\uC6A9: ${[...rule.validValues].join(", ")}`,
+                path: `${blockPath}.props.${propName}`,
+                step: 2
+              });
+            }
+          }
+        }
+      }
       if (block.children && Array.isArray(block.children)) {
         for (const childId of block.children) {
           if (typeof childId === "string" && !blocks[childId]) {
@@ -3827,7 +3914,7 @@ async function commandGenerate(options) {
 // src/commands/analyze.ts
 import chalk15 from "chalk";
 import { resolve as resolve13, join as join2 } from "path";
-import { mkdir as mkdir4 } from "fs/promises";
+import { mkdir as mkdir4, writeFile as writeFile8 } from "fs/promises";
 
 // src/scripts/analyze-reference.ts
 import { spawnSync } from "child_process";
@@ -4153,12 +4240,94 @@ var EXTRACTION_SCRIPT = `
     });
   });
 
-  // \u2500\u2500 5. Gaps (V2 \uBE14\uB85D\uC73C\uB85C \uB9E4\uD551 \uBD88\uAC00\uB2A5\uD55C \uAE30\uB2A5) \u2500\u2500
+  // \u2500\u2500 5. Videos \u2500\u2500
+  const videoEls = document.querySelectorAll('video, iframe[src*="youtube"], iframe[src*="youtu.be"], iframe[src*="vimeo"], iframe[data-src*="youtube"], iframe[data-src*="vimeo"]');
+  const videos = [];
+
+  videoEls.forEach(el => {
+    const tag = el.tagName.toLowerCase();
+    let src = '';
+    let type = 'inline';
+    let platform = 'unknown';
+    let autoplay = false;
+    let loop = false;
+    let muted = false;
+    let posterSrc = '';
+
+    if (tag === 'video') {
+      src = el.src || el.querySelector('source')?.src || el.dataset.src || '';
+      posterSrc = el.poster || '';
+      autoplay = el.hasAttribute('autoplay');
+      loop = el.hasAttribute('loop');
+      muted = el.hasAttribute('muted');
+      platform = 'direct';
+
+      // background \uBE44\uB514\uC624 \uD310\uC815: autoplay+muted+loop \uB610\uB294 CSS\uB85C \uBC30\uACBD \uCC98\uB9AC\uB41C \uACBD\uC6B0
+      if ((autoplay && muted) || el.closest('[class*=hero], [class*=banner], [class*=bg-video], [class*=video-bg], [class*=background]')) {
+        type = 'background';
+      }
+    } else if (tag === 'iframe') {
+      src = el.src || el.dataset.src || '';
+      if (/youtube.com|youtu.be/.test(src)) {
+        platform = 'youtube';
+        type = 'embed';
+        // YouTube autoplay \uD30C\uB77C\uBBF8\uD130 \uAC10\uC9C0
+        autoplay = /autoplay=1/.test(src);
+        muted = /mute=1/.test(src);
+        loop = /loop=1/.test(src);
+        // YouTube thumbnail \uCD94\uCD9C
+        const ytMatch = src.match(/(?:embed\\/|v=|youtu\\.be\\/)([a-zA-Z0-9_-]{11})/);
+        if (ytMatch) posterSrc = 'https://img.youtube.com/vi/' + ytMatch[1] + '/hqdefault.jpg';
+      } else if (/vimeo.com/.test(src)) {
+        platform = 'vimeo';
+        type = 'embed';
+        autoplay = /autoplay=1/.test(src);
+        muted = /muted=1/.test(src);
+        loop = /loop=1/.test(src);
+      }
+    }
+
+    if (!src) return;
+
+    const rect = el.getBoundingClientRect();
+    const width = Math.round(rect.width) || 0;
+    const height = Math.round(rect.height) || 0;
+
+    // \uBD80\uBAA8 \uC139\uC158 \uC5ED\uD560 \uCD94\uB860
+    const parentSection = el.closest('section, header, footer, main, [class*=hero], [class*=banner]');
+    const position = parentSection ? inferSectionRole(parentSection) : 'unknown';
+
+    // \uC8FC\uBCC0 \uD14D\uC2A4\uD2B8\uC5D0\uC11C \uB9E5\uB77D \uCD94\uCD9C
+    const nearby = (el.parentElement?.textContent || '').trim().slice(0, 150);
+    const title = el.getAttribute('title') || el.getAttribute('aria-label') || '';
+    const context = (title || nearby).slice(0, 150);
+
+    // background \uBE44\uB514\uC624 \uC911 full-width\uC778 \uACBD\uC6B0 \uBCF4\uAC15
+    if (type === 'inline' && width > window.innerWidth * 0.9 && height > 300) {
+      type = 'background';
+    }
+
+    videos.push({
+      src: src.slice(0, 500),
+      type,
+      platform,
+      aspectRatio: guessAspectRatio(width, height),
+      posterSrc: posterSrc.slice(0, 500),
+      position,
+      context: context.slice(0, 150),
+      autoplay,
+      loop,
+      muted,
+    });
+  });
+
+  // \u2500\u2500 6. Gaps (V2 \uBE14\uB85D\uC73C\uB85C \uB9E4\uD551 \uBD88\uAC00\uB2A5\uD55C \uAE30\uB2A5) \u2500\u2500
   const gaps = [];
 
-  // video background
-  if (document.querySelector('video[autoplay], video[muted]')) {
-    gaps.push('video-background-autoplay: \uC790\uB3D9 \uC7AC\uC0DD \uBE44\uB514\uC624 \uBC30\uACBD');
+  // video background (\uBE44\uB514\uC624 \uAC10\uC9C0\uB294 \uC139\uC158 5\uC5D0\uC11C \uCC98\uB9AC, gap\uC5D0\uB294 \uBBF8\uC9C0\uC6D0 \uD328\uD134\uB9CC \uAE30\uB85D)
+  const hasScrollScrubVideo = document.querySelector('video[data-scroll-scrub], [class*=scroll-video]');
+  if (hasScrollScrubVideo) {
+    gaps.push('video-scroll-scrub: \uC2A4\uD06C\uB864 \uC5F0\uB3D9 \uBE44\uB514\uC624 \uC7AC\uC0DD (scroll scrub)');
   }
   // canvas / WebGL
   if (document.querySelector('canvas')) {
@@ -4240,6 +4409,7 @@ var EXTRACTION_SCRIPT = `
       detectedTransitions: [...transitionProps].slice(0, 20),
     },
     images,
+    videos,
     gaps,
   };
 })()
@@ -4371,10 +4541,144 @@ function createFallbackData() {
       detectedTransitions: []
     },
     images: [],
+    videos: [],
     gaps: []
   };
 }
 
+// src/lib/pexels-client.ts
+var PexelsClient = class {
+  apiKey;
+  baseUrl = "https://api.pexels.com/videos";
+  constructor(apiKey) {
+    this.apiKey = apiKey;
+  }
+  /**
+   * 키워드로 비디오를 검색합니다.
+   */
+  async searchVideos(options) {
+    const params = new URLSearchParams({
+      query: options.query,
+      per_page: String(options.perPage ?? 1)
+    });
+    if (options.orientation) params.set("orientation", options.orientation);
+    if (options.minDuration) params.set("min_duration", String(options.minDuration));
+    if (options.maxDuration) params.set("max_duration", String(options.maxDuration));
+    const url = `${this.baseUrl}/search?${params}`;
+    const res = await fetch(url, {
+      headers: { Authorization: this.apiKey }
+    });
+    if (!res.ok) {
+      if (res.status === 429) {
+        throw new Error("Pexels API rate limit \uCD08\uACFC. \uC7A0\uC2DC \uD6C4 \uB2E4\uC2DC \uC2DC\uB3C4\uD558\uC138\uC694.");
+      }
+      throw new Error(`Pexels API \uC624\uB958: ${res.status} ${res.statusText}`);
+    }
+    return res.json();
+  }
+  /**
+   * 키워드로 비디오를 검색하여 최적의 파일 URL을 반환합니다.
+   *
+   * 선택 기준:
+   * 1. HD 품질 우선 (sd < hd < uhd)
+   * 2. mp4 파일 타입 우선
+   * 3. 가로형(landscape) 기본 선호
+   */
+  async findVideo(options) {
+    const response = await this.searchVideos(options);
+    if (response.videos.length === 0) return null;
+    const video = response.videos[0];
+    const file = pickBestFile(video.video_files);
+    if (!file) return null;
+    return {
+      src: file.link,
+      poster: video.image,
+      pexelsUrl: video.url,
+      width: file.width,
+      height: file.height,
+      duration: video.duration
+    };
+  }
+  /**
+   * 여러 키워드를 순차적으로 시도하여 첫 번째 매칭되는 비디오를 반환합니다.
+   * 업종 키워드 → 일반 키워드 순으로 fallback.
+   */
+  async findVideoWithFallback(queries, options) {
+    for (const query of queries) {
+      const result = await this.findVideo({ ...options, query });
+      if (result) return result;
+    }
+    return null;
+  }
+};
+var QUALITY_RANK = { sd: 0, hd: 1, uhd: 2 };
+function pickBestFile(files) {
+  const mp4Files = files.filter((f) => f.file_type === "video/mp4");
+  const pool = mp4Files.length > 0 ? mp4Files : files;
+  return pool.sort((a, b) => {
+    const qualityDiff = (QUALITY_RANK[b.quality] ?? 0) - (QUALITY_RANK[a.quality] ?? 0);
+    if (qualityDiff !== 0) return qualityDiff;
+    if (a.quality === "uhd" && b.quality !== "uhd") return 1;
+    if (b.quality === "uhd" && a.quality !== "uhd") return -1;
+    return b.width * b.height - a.width * a.height;
+  })[0];
+}
+function buildVideoSearchQueries(industry, sectionRole, videoType) {
+  const queries = [];
+  const industryKeywords = {
+    // 외식
+    cafe: ["cafe interior", "coffee shop", "barista coffee"],
+    restaurant: ["restaurant kitchen", "dining food", "chef cooking"],
+    bakery: ["bakery bread", "pastry baking", "fresh bread"],
+    bar: ["cocktail bar", "bartender mixing", "bar nightlife"],
+    // 뷰티/건강
+    salon: ["hair salon", "beauty salon", "hairdresser styling"],
+    spa: ["spa massage", "wellness relaxation", "spa treatment"],
+    gym: ["fitness gym", "workout training", "gym exercise"],
+    clinic: ["medical clinic", "healthcare professional", "doctor clinic"],
+    dental: ["dental clinic", "dentist office", "dental care"],
+    dermatology: ["skincare treatment", "dermatology clinic", "skin care"],
+    // 전문 서비스
+    law: ["law office", "legal professional", "law firm"],
+    accounting: ["accounting office", "financial planning", "business meeting"],
+    consulting: ["business consulting", "corporate meeting", "professional office"],
+    realestate: ["real estate", "property tour", "house interior"],
+    // 교육
+    academy: ["classroom learning", "education study", "student learning"],
+    kindergarten: ["children playing", "kids education", "nursery school"],
+    // 소매/서비스
+    shop: ["retail store", "shopping", "product display"],
+    flower: ["flower arrangement", "florist shop", "floral bouquet"],
+    pet: ["pet grooming", "pet care", "cute animals"],
+    cleaning: ["cleaning service", "professional cleaning", "clean home"],
+    moving: ["moving service", "packing boxes", "new home"],
+    // 테크
+    tech: ["technology innovation", "digital workspace", "coding computer"],
+    saas: ["software dashboard", "digital technology", "cloud computing"],
+    startup: ["startup team", "innovation workspace", "creative office"]
+  };
+  const keywords = industryKeywords[industry] ?? [`${industry} professional`, `${industry} business`];
+  if (videoType === "background") {
+    queries.push(...keywords);
+    if (sectionRole === "hero") {
+      queries.push(`${industry} aerial`, `${industry} cinematic`);
+    }
+    queries.push("abstract background loop", "minimal background");
+  } else {
+    if (sectionRole === "hero") {
+      queries.push(...keywords);
+    } else if (sectionRole === "features" || sectionRole === "gallery") {
+      queries.push(...keywords.slice(0, 2));
+    } else if (sectionRole === "testimonials") {
+      queries.push("people talking", "customer interview");
+    } else {
+      queries.push(...keywords.slice(0, 1));
+    }
+    queries.push(`${industry} video`);
+  }
+  return queries;
+}
+
 // src/commands/analyze.ts
 async function commandAnalyze(url, options) {
   console.log(chalk15.bold("\n\uB808\uD37C\uB7F0\uC2A4 \uBD84\uC11D (Reference Analysis)\n"));
@@ -4447,6 +4751,42 @@ async function commandAnalyze(url, options) {
     Object.entries(roleCount).forEach(([role, count]) => {
       console.log(chalk15.dim(`    ${role}: ${count}\uAC1C`));
     });
+    console.log("");
+    console.log(chalk15.bold("\uBE44\uB514\uC624"));
+    if (analysis.videos.length > 0) {
+      const typeCount = {};
+      analysis.videos.forEach((v) => {
+        typeCount[v.type] = (typeCount[v.type] || 0) + 1;
+      });
+      console.log(chalk15.dim(`  \uCD1D ${analysis.videos.length}\uAC1C \uAC10\uC9C0`));
+      Object.entries(typeCount).forEach(([type, count]) => {
+        console.log(chalk15.dim(`    ${type}: ${count}\uAC1C`));
+      });
+      const pexelsApiKey = await resolvePexelsApiKey();
+      if (pexelsApiKey) {
+        const videoSpinner = spinner("Pexels\uC5D0\uC11C \uC2A4\uD1A1 \uBE44\uB514\uC624 \uAC80\uC0C9 \uC911...");
+        try {
+          const pexels = new PexelsClient(pexelsApiKey);
+          const industry = options.industry ?? inferIndustry(analysis);
+          const resolved = await resolveVideos(pexels, analysis.videos, industry);
+          videoSpinner.stop(chalk15.green(`  ${resolved.length}/${analysis.videos.length}\uAC1C \uC2A4\uD1A1 \uBE44\uB514\uC624 \uB9E4\uCE6D \uC644\uB8CC`));
+          resolved.forEach(({ video, stock }) => {
+            console.log(chalk15.dim(`    [${video.type}] ${video.position} \u2192 ${stock.src.slice(0, 80)}...`));
+          });
+          const videoMapPath = join2(outputDir, "video-stock-map.json");
+          await writeFile8(videoMapPath, JSON.stringify(resolved, null, 2), "utf-8");
+          console.log(chalk15.dim(`  \uB9E4\uCE6D \uACB0\uACFC: ${videoMapPath}`));
+        } catch (error) {
+          videoSpinner.stop(chalk15.yellow("  Pexels \uAC80\uC0C9 \uC2E4\uD328 (\uBE44\uB514\uC624\uB294 \uC218\uB3D9 \uAD50\uCCB4 \uD544\uC694)"));
+          console.log(chalk15.dim(`    ${error instanceof Error ? error.message : String(error)}`));
+        }
+      } else {
+        console.log(chalk15.dim("  PEXELS_API_KEY \uBBF8\uC124\uC815 \u2192 \uC2A4\uD1A1 \uBE44\uB514\uC624 \uC790\uB3D9 \uB9E4\uCE6D \uAC74\uB108\uB700"));
+        console.log(chalk15.dim("  \uC124\uC815: PEXELS_API_KEY \uD658\uACBD\uBCC0\uC218 \uB610\uB294 .saeroon/config.json\uC758 pexelsApiKey"));
+      }
+    } else {
+      console.log(chalk15.dim("  \uBE44\uB514\uC624 \uC5C6\uC74C"));
+    }
     if (analysis.gaps.length > 0) {
       console.log("");
       console.log(chalk15.bold(chalk15.yellow("Gap \uAC10\uC9C0")));
@@ -4474,10 +4814,59 @@ ${error instanceof Error ? error.message : String(error)}`));
     process.exit(1);
   }
 }
+async function resolveVideos(pexels, videos, industry) {
+  const results = [];
+  for (const video of videos) {
+    const queries = buildVideoSearchQueries(industry, video.position, video.type);
+    const orientation = video.type === "background" ? "landscape" : void 0;
+    const maxDuration = video.type === "background" ? 30 : 60;
+    const stock = await pexels.findVideoWithFallback(queries, {
+      orientation,
+      maxDuration
+    });
+    if (stock) {
+      results.push({ video, stock });
+    }
+  }
+  return results;
+}
+function inferIndustry(analysis) {
+  const text = analysis.structure.headingHierarchy.join(" ").toLowerCase();
+  const roles = analysis.structure.sections.map((s) => s.role).join(" ");
+  const combined = text + " " + roles;
+  const industryPatterns = [
+    [/카페|coffee|cafe|커피/, "cafe"],
+    [/레스토랑|restaurant|맛집|음식점|식당/, "restaurant"],
+    [/베이커리|bakery|빵|제과/, "bakery"],
+    [/바|bar|칵테일|cocktail|pub/, "bar"],
+    [/미용|salon|헤어|hair|뷰티|beauty/, "salon"],
+    [/스파|spa|마사지|massage|웰니스/, "spa"],
+    [/피트니스|gym|헬스|fitness|운동/, "gym"],
+    [/병원|clinic|의원|진료|medical/, "clinic"],
+    [/치과|dental|dentist/, "dental"],
+    [/피부|derma|skin|에스테틱/, "dermatology"],
+    [/법률|law|변호사|attorney|법무/, "law"],
+    [/회계|accounting|세무|tax/, "accounting"],
+    [/컨설팅|consulting|자문/, "consulting"],
+    [/부동산|real\s*estate|property|공인중개/, "realestate"],
+    [/학원|academy|교육|education|학습/, "academy"],
+    [/어린이집|유치원|kindergarten|nursery/, "kindergarten"],
+    [/꽃|flower|florist|플라워/, "flower"],
+    [/반려|pet|동물|animal/, "pet"],
+    [/청소|cleaning|클리닝/, "cleaning"],
+    [/이사|moving|포장이사/, "moving"],
+    [/saas|software|플랫폼|platform/, "saas"],
+    [/startup|스타트업/, "startup"]
+  ];
+  for (const [pattern, industry] of industryPatterns) {
+    if (pattern.test(combined)) return industry;
+  }
+  return "business";
+}
 
 // src/commands/compare.ts
 import chalk16 from "chalk";
-import { writeFile as writeFile8, mkdir as mkdir5 } from "fs/promises";
+import { writeFile as writeFile9, mkdir as mkdir5 } from "fs/promises";
 import { resolve as resolve14, join as join3 } from "path";
 import { execSync as execSync2, spawnSync as spawnSync2 } from "child_process";
 async function commandCompare(options) {
@@ -4565,7 +4954,7 @@ async function runMultiViewportCompare(options) {
     overallDiffPercentage: Math.round(overallDiff * 10) / 10
   };
   const reportPath = join3(outputDir, "comparison-report.json");
-  await writeFile8(reportPath, JSON.stringify(report, null, 2), "utf-8");
+  await writeFile9(reportPath, JSON.stringify(report, null, 2), "utf-8");
   console.log("");
   console.log(chalk16.bold("\uBE44\uAD50 \uC694\uC57D"));
   for (const r of results) {
@@ -5460,7 +5849,7 @@ program.command("add-pattern").description("\uC2A4\uD0A4\uB9C8\uC5D0 \uD328\uD13
 program.command("fork-pattern").description("\uACF5\uAC1C \uD328\uD134\uC744 \uB0B4 \uC0AC\uC774\uD2B8\uB85C \uD3EC\uD06C").argument("<pattern-id>", "\uD3EC\uD06C\uD560 \uACF5\uAC1C \uD328\uD134 ID").requiredOption("--site-id <id>", "\uB300\uC0C1 \uC0AC\uC774\uD2B8 ID").action(commandForkPattern);
 program.command("add").description("schema.json\uC5D0 \uBE14\uB85D \uCD94\uAC00 (\uAE30\uBCF8 props \uD3EC\uD568)").argument("<block-type>", "\uCD94\uAC00\uD560 \uBE14\uB85D \uD0C0\uC785 (e.g., heading-block, image-block)").option("--id <id>", "\uBE14\uB85D ID (\uBBF8\uC9C0\uC815 \uC2DC \uC790\uB3D9 \uC0DD\uC131)").option("--parent <parentId>", "\uBD80\uBAA8 \uBE14\uB85D ID").option("--after <siblingId>", "\uC0BD\uC785 \uC704\uCE58 (\uD615\uC81C \uBE14\uB85D \uB4A4)").option("--page <pageId>", "\uB300\uC0C1 \uD398\uC774\uC9C0 ID").action(commandAdd);
 program.command("generate").description("AI\uB85C \uC0AC\uC774\uD2B8 \uC2A4\uD0A4\uB9C8 \uC0DD\uC131").option("--ref <url>", "\uB808\uD37C\uB7F0\uC2A4 URL (\uC0AC\uC774\uD2B8\uB97C \uBD84\uC11D\uD558\uC5EC \uC720\uC0AC\uD55C \uC2A4\uD0A4\uB9C8 \uC0DD\uC131)").option("--prompt <text>", "\uD504\uB86C\uD504\uD2B8 \uD14D\uC2A4\uD2B8 (\uC124\uBA85 \uAE30\uBC18 \uC0DD\uC131)").option("--output <file>", "\uCD9C\uB825 \uD30C\uC77C \uACBD\uB85C", "schema.json").option("--api-key <key>", "API Key").action(commandGenerate);
-program.command("analyze").description("\uB808\uD37C\uB7F0\uC2A4 URL \uBD84\uC11D (\uC2A4\uD06C\uB9B0\uC0F7 4\uC7A5 + DOM/CSS \uCD94\uCD9C + \uC778\uD130\uB799\uC158 \uAC10\uC9C0)").argument("<url>", "\uBD84\uC11D\uD560 \uB808\uD37C\uB7F0\uC2A4 URL").option("--output-dir <dir>", "\uBD84\uC11D \uACB0\uACFC \uCD9C\uB825 \uB514\uB809\uD1A0\uB9AC").option("--timeout <ms>", "\uD398\uC774\uC9C0 \uB85C\uB4DC \uD0C0\uC784\uC544\uC6C3 (ms)", "30000").action(commandAnalyze);
+program.command("analyze").description("\uB808\uD37C\uB7F0\uC2A4 URL \uBD84\uC11D (\uC2A4\uD06C\uB9B0\uC0F7 4\uC7A5 + DOM/CSS \uCD94\uCD9C + \uBE44\uB514\uC624 \uAC10\uC9C0 + \uC778\uD130\uB799\uC158 \uAC10\uC9C0)").argument("<url>", "\uBD84\uC11D\uD560 \uB808\uD37C\uB7F0\uC2A4 URL").option("--output-dir <dir>", "\uBD84\uC11D \uACB0\uACFC \uCD9C\uB825 \uB514\uB809\uD1A0\uB9AC").option("--timeout <ms>", "\uD398\uC774\uC9C0 \uB85C\uB4DC \uD0C0\uC784\uC544\uC6C3 (ms)", "30000").option("--industry <type>", "\uC5C5\uC885 (cafe, restaurant, salon, law \uB4F1 \u2014 \uBE44\uB514\uC624 \uAC80\uC0C9 \uD0A4\uC6CC\uB4DC\uC5D0 \uC0AC\uC6A9)").action(commandAnalyze);
 program.command("compare").description("\uB808\uD37C\uB7F0\uC2A4 \u2194 \uD504\uB9AC\uBDF0 \uC2DC\uAC01 \uBE44\uAD50 (Playwright \uC2A4\uD06C\uB9B0\uC0F7)").option("--ref <url>", "\uB808\uD37C\uB7F0\uC2A4 URL").option("--preview <url>", "\uD504\uB9AC\uBDF0 URL").option("--output <file>", "\uCD9C\uB825 \uD30C\uC77C \uACBD\uB85C (\uB2E8\uC77C \uBDF0\uD3EC\uD2B8)", "compare-result.png").option("--output-dir <dir>", "\uCD9C\uB825 \uB514\uB809\uD1A0\uB9AC (\uBA40\uD2F0 \uBDF0\uD3EC\uD2B8)").option("--width <px>", "\uBDF0\uD3EC\uD2B8 \uB108\uBE44 (\uB2E8\uC77C \uBAA8\uB4DC)", "1280").option("--height <px>", "\uBDF0\uD3EC\uD2B8 \uB192\uC774 (\uB2E8\uC77C \uBAA8\uB4DC)", "800").option("--viewports <list>", "\uBE44\uAD50 \uBDF0\uD3EC\uD2B8: all | mobile,tablet,laptop,desktop").action(commandCompare);
 program.command("upload").description("\uC774\uBBF8\uC9C0\uB97C Saeroon CDN\uC5D0 \uC5C5\uB85C\uB4DC").argument("<path>", "\uC5C5\uB85C\uB4DC\uD560 \uD30C\uC77C \uB610\uB294 \uB514\uB809\uD1A0\uB9AC \uACBD\uB85C").option("--replace-in <file>", "\uC5C5\uB85C\uB4DC \uD6C4 \uD30C\uC77C \uB0B4 \uB85C\uCEEC \uACBD\uB85C\uB97C CDN URL\uB85C \uAD50\uCCB4").option("--site-id <id>", "\uC0AC\uC774\uD2B8 ID").option("--api-key <key>", "API Key").action(commandUpload);
 program.command("deploy").description("\uC0AC\uC774\uD2B8\uC5D0 \uC2A4\uD0A4\uB9C8 \uBC30\uD3EC").option("--api-key <key>", "API Key").option("--target <target>", "\uBC30\uD3EC \uB300\uC0C1: staging|production", "staging").option("--dry-run", "\uC2E4\uC81C \uC5C5\uB85C\uB4DC/\uBC30\uD3EC \uC5C6\uC774 \uC5D0\uC14B \uB9AC\uD3EC\uD2B8\uB9CC \uCD9C\uB825").option("--sync-template", "Production \uBC30\uD3EC \uD6C4 \uB9C8\uCF13\uD50C\uB808\uC774\uC2A4 \uD15C\uD50C\uB9BF \uBC84\uC804 \uC790\uB3D9 \uB3D9\uAE30\uD654").action(commandDeploy);

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "@saeroon/cli",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "description": "Saeroon Hosting developer CLI — preview, validate, and deploy sites & templates",
   "private": false,
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "bin": {
-    "saeroon": "dist/index.js"
+    "saeroon": "dist/index.js",
+    "saeroon-cli": "dist/index.js"
   },
   "license": "MIT",
   "publishConfig": {