@roottale/cms-renderer-next 0.22.0 → 0.25.0

package/dist/routes.js

@@ -5,6 +5,7 @@ import {
 // src/routes.ts
 import {
   CMS_CLIENT_VERSION,
+  fetchPost,
   fetchPosts,
   generateRssXml,
   rssItemsFromPosts
@@ -79,6 +80,47 @@ function createSitemap(config, staticRoutes = []) {
     return [...staticRoutes, ...postEntries, ...categoryEntries];
   };
 }
+function mdLinkSafe(text) {
+  return text.replace(/[[\]()]/g, "").trim();
+}
+function oneLine(text) {
+  return text.replace(/\s+/g, " ").trim().slice(0, 200);
+}
+function createLlmsTxtRoute(config) {
+  return async function GET() {
+    const siteUrl = trimSlash(config.siteUrl);
+    const blogBase = config.blogBasePath ?? "/blog";
+    const posts = await safeFetchPosts(config, 100);
+    const lines = [`# ${config.title}`];
+    if (config.description) {
+      lines.push("", `> ${oneLine(config.description)}`);
+    }
+    for (const section of config.sections ?? []) {
+      lines.push("", `## ${section.title}`);
+      for (const link of section.links) {
+        const note = link.note ? `: ${oneLine(link.note)}` : "";
+        lines.push(`- [${mdLinkSafe(link.title)}](${link.url})${note}`);
+      }
+    }
+    if (posts.length > 0) {
+      lines.push("", "## \uBE14\uB85C\uADF8");
+      for (const p of posts) {
+        const excerpt = p.excerpt ? `: ${oneLine(p.excerpt)}` : "";
+        lines.push(
+          `- [${mdLinkSafe(p.title)}](${siteUrl}${blogBase}/${p.slug})${excerpt}`
+        );
+      }
+    }
+    lines.push("");
+    return new Response(lines.join("\n"), {
+      headers: {
+        "content-type": "text/plain; charset=utf-8",
+        // feed 와 동일한 30분 캐시 — webhook alsoRevalidate 로 즉시 갱신됨.
+        "cache-control": "public, max-age=1800, s-maxage=1800"
+      }
+    });
+  };
+}
 function pathsFromBody(rawBody) {
   try {
     const body = JSON.parse(rawBody);
@@ -94,6 +136,8 @@ function createRevalidateRoute(config) {
   const alsoRevalidate = config.alsoRevalidate ?? [
     "/feed.xml",
     "/sitemap.xml",
+    // 글 변경 시 AI 크롤러용 llms.txt 인덱스도 함께 갱신 (AEO/GEO).
+    "/llms.txt",
     blogBase,
     `${blogBase}/categories`
   ];
@@ -121,6 +165,15 @@ function createRevalidateRoute(config) {
     });
   };
 }
+function postRedirectPath(post, requestedSlug, blogBasePath = "/blog") {
+  let requested = requestedSlug;
+  try {
+    requested = decodeURIComponent(requestedSlug);
+  } catch {
+  }
+  if (post.slug === requested) return null;
+  return `${trimSlash(blogBasePath)}/${encodeURIComponent(post.slug)}`;
+}
 function createFleetInfoRoute(config = {}) {
   const env = globalThis.process?.env ?? {};
   return async function GET() {
@@ -129,17 +182,130 @@ function createFleetInfoRoute(config = {}) {
         site: config.site ?? env.VERCEL_PROJECT_PRODUCTION_URL ?? null,
         framework: "next",
         cms_client: CMS_CLIENT_VERSION,
-        cms_renderer: true ? "0.22.0" : "dev",
+        cms_renderer: true ? "0.25.0" : "dev",
         build_sha: env.VERCEL_GIT_COMMIT_SHA?.slice(0, 7) ?? null
       },
       { headers: { "cache-control": "public, max-age=300" } }
     );
   };
 }
+var OG_IMAGE_SIZE = { width: 1200, height: 630 };
+var OG_IMAGE_CONTENT_TYPE = "image/png";
+async function loadKoreanFontSubset(text) {
+  try {
+    const unique = Array.from(new Set(Array.from(text))).join("");
+    const cssUrl = `https://fonts.googleapis.com/css2?family=Noto+Sans+KR:wght@700&text=${encodeURIComponent(unique)}`;
+    const cssRes = await fetch(cssUrl, {
+      headers: { "user-agent": "Mozilla/5.0 (Windows NT 6.1; rv:10.0)" }
+    });
+    if (!cssRes.ok) return null;
+    const css = await cssRes.text();
+    const match = css.match(
+      /src:\s*url\(([^)]+)\)\s*format\(['"](?:truetype|opentype)['"]\)/
+    );
+    if (!match?.[1]) return null;
+    const fontRes = await fetch(match[1]);
+    if (!fontRes.ok) return null;
+    return await fontRes.arrayBuffer();
+  } catch (err) {
+    console.error("[@roottale/cms-renderer-next/routes] OG \uD3F0\uD2B8 \uB85C\uB529 \uC2E4\uD328:", err);
+    return null;
+  }
+}
+function createPostOgImage(config, deps) {
+  const background = config.backgroundColor ?? "#10172a";
+  const foreground = config.foregroundColor ?? "#f8fafc";
+  const accent = config.accentColor ?? "#38bdf8";
+  const brand = config.brandLabel ?? config.title;
+  return async function OgImage(props) {
+    const { slug } = await props.params;
+    let title = config.title;
+    let dateLabel = null;
+    try {
+      const post = await fetchPost({
+        apiKey: config.apiKey,
+        baseUrl: config.apiBase,
+        slugOrId: slug
+      });
+      if (post) {
+        title = post.title;
+        dateLabel = new Intl.DateTimeFormat("ko-KR", { dateStyle: "long" }).format(
+          new Date(post.publishedAt)
+        );
+      }
+    } catch (err) {
+      console.error("[@roottale/cms-renderer-next/routes] OG fetchPost \uC2E4\uD328:", err);
+    }
+    const display = title.length > 64 ? `${title.slice(0, 63)}\u2026` : title;
+    const fontData = await loadKoreanFontSubset(`${display}${brand}${dateLabel ?? ""}`);
+    const { createElement: h } = await import("react");
+    const element = h(
+      "div",
+      {
+        style: {
+          width: "100%",
+          height: "100%",
+          display: "flex",
+          flexDirection: "column",
+          justifyContent: "space-between",
+          padding: "72px 80px",
+          backgroundColor: background,
+          backgroundImage: `linear-gradient(135deg, ${background} 60%, rgba(56,189,248,0.25))`,
+          color: foreground,
+          fontFamily: fontData ? "NotoSansKR" : "sans-serif"
+        }
+      },
+      h("div", {
+        style: { width: 96, height: 10, backgroundColor: accent, borderRadius: 5 }
+      }),
+      h(
+        "div",
+        {
+          style: {
+            display: "flex",
+            fontSize: display.length > 36 ? 56 : 68,
+            fontWeight: 700,
+            lineHeight: 1.25,
+            letterSpacing: "-0.02em",
+            wordBreak: "keep-all"
+          }
+        },
+        display
+      ),
+      h(
+        "div",
+        {
+          style: {
+            display: "flex",
+            justifyContent: "space-between",
+            alignItems: "center",
+            fontSize: 28
+          }
+        },
+        h("div", { style: { display: "flex", color: accent, fontWeight: 700 } }, brand),
+        h(
+          "div",
+          { style: { display: "flex", color: "rgba(248,250,252,0.72)" } },
+          dateLabel ?? trimSlash(config.siteUrl).replace(/^https?:\/\//, "")
+        )
+      )
+    );
+    return new deps.ImageResponse(element, {
+      width: OG_IMAGE_SIZE.width,
+      height: OG_IMAGE_SIZE.height,
+      ...fontData ? { fonts: [{ name: "NotoSansKR", data: fontData, weight: 700, style: "normal" }] } : {}
+    });
+  };
+}
 export {
+  OG_IMAGE_CONTENT_TYPE,
+  OG_IMAGE_SIZE,
   createFeedRoute,
   createFleetInfoRoute,
+  createLlmsTxtRoute,
+  createPostOgImage,
   createRevalidateRoute,
-  createSitemap
+  createSitemap,
+  postRedirectPath
 };
 //# sourceMappingURL=routes.js.map

package/dist/routes.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/routes.ts"],"sourcesContent":["/**\n * `@roottale/cms-renderer-next/routes` — Next.js App Router 통합 라우트 팩토리.\n *\n * 외부 고객사 사이트가 매번 직접 작성하던 공통 라우트(RSS feed / sitemap /\n * revalidate webhook)를 1줄 팩토리로 표준화. 블로그 조회와 *동일한* 단일\n * customer API key(`ROOTTALE_API_KEY`)를 사용한다.\n *\n * 설계 원칙:\n * - feed/sitemap 은 `fetchPosts` 실패를 swallow → 라우트가 *항상 200* (빌드 시\n *   정적 생성이 throw 해서 404 나는 사고 방지).\n * - revalidate 는 admin(mysite.roottale.com)에서 글/카테고리/미디어 변경 시 보내는\n *   서명 webhook 을 검증하고, 본문 paths + 파생 경로(feed·sitemap·블로그 인덱스)를\n *   모두 revalidate → 각 사이트에 자동 반영.\n * - `next` 에 직접 의존하지 않음: revalidate 콜백(`revalidatePath`)을 주입받는다.\n *\n * 사용 예는 roottale-docs `services/external-site-integration.md` 참조.\n */\n\nimport {\n  CMS_CLIENT_VERSION,\n  fetchPosts,\n  generateRssXml,\n  rssItemsFromPosts,\n  type CmsPostContent,\n} from \"@roottale/cms-client/server\";\nimport {\n  verifyRootTaleWebhook,\n  type VerifyRootTaleWebhookResult,\n} from \"@roottale/cms-client/webhook\";\nimport { collectCategories } from \"./blog-filter.js\";\n\nexport interface RootTaleSiteConfig {\n  /** `rtlk_cust_*` — 블로그 조회와 같은 키. 서버에서만(절대 브라우저 금지). */\n  apiKey: string;\n  /** API base 오버라이드. 기본 `https://api.roottale.com`. */\n  apiBase?: string;\n  /** 사이트 절대 URL (뒤 슬래시 없이). 예: `https://kjmtax.roottale.app`. */\n  siteUrl: string;\n  /** 피드/사이트 제목. */\n  title: string;\n  description?: string;\n  /** 기본 \"ko-KR\". */\n  language?: string;\n  /** 블로그 base path. 기본 \"/blog\". */\n  blogBasePath?: string;\n}\n\nfunction trimSlash(u: string): string {\n  return u.replace(/\\/+$/, \"\");\n}\n\nasync function safeFetchPosts(\n  config: RootTaleSiteConfig,\n  limit: number,\n): Promise<CmsPostContent[]> {\n  try {\n    const page = await fetchPosts({\n      apiKey: config.apiKey,\n      baseUrl: config.apiBase,\n      type: \"post\",\n      limit,\n    });\n    return page.items;\n  } catch (err) {\n    // 빌드/런타임 fetch 실패 시 빈 목록 — 라우트는 항상 정상 응답(404 방지).\n    console.error(\"[@roottale/cms-renderer-next/routes] fetchPosts 실패:\", err);\n    return [];\n  }\n}\n\n/**\n * `app/feed.xml/route.ts` 용 GET 핸들러. RSS 2.0.\n *\n * ```ts\n * import { createFeedRoute } from \"@roottale/cms-renderer-next/routes\";\n * export const dynamic = \"force-dynamic\";\n * export const GET = createFeedRoute({\n *   apiKey: process.env.ROOTTALE_API_KEY!,\n *   siteUrl: \"https://example.com\",\n *   title: \"Example 블로그\",\n *   description: \"...\",\n * });\n * ```\n */\nexport function createFeedRoute(\n  config: RootTaleSiteConfig,\n): () => Promise<Response> {\n  return async function GET(): Promise<Response> {\n    const siteUrl = trimSlash(config.siteUrl);\n    const blogBase = config.blogBasePath ?? \"/blog\";\n    const posts = await safeFetchPosts(config, 50);\n    const xml = generateRssXml({\n      title: config.title,\n      link: `${siteUrl}${blogBase}`,\n      feedUrl: `${siteUrl}/feed.xml`,\n      description: config.description,\n      language: config.language,\n      items: rssItemsFromPosts(posts, {\n        postUrl: (p) => `${siteUrl}${blogBase}/${p.slug}`,\n      }),\n    });\n    return new Response(xml, {\n      headers: {\n        \"content-type\": \"application/rss+xml; charset=utf-8\",\n        \"cache-control\": \"public, max-age=1800, s-maxage=1800\",\n      },\n    });\n  };\n}\n\n/** Next `MetadataRoute.Sitemap[number]` 와 구조 호환(타입 결합 회피). */\nexport interface SitemapEntry {\n  url: string;\n  lastModified?: string | Date;\n  changeFrequency?:\n    | \"always\"\n    | \"hourly\"\n    | \"daily\"\n    | \"weekly\"\n    | \"monthly\"\n    | \"yearly\"\n    | \"never\";\n  priority?: number;\n}\n\n/**\n * `app/sitemap.ts` default export. 정적 경로 + 글 경로를 합친다.\n *\n * ```ts\n * import { createSitemap } from \"@roottale/cms-renderer-next/routes\";\n * export default createSitemap(\n *   { apiKey: process.env.ROOTTALE_API_KEY!, siteUrl: \"https://example.com\", title: \"...\" },\n *   [{ url: \"https://example.com\", changeFrequency: \"weekly\", priority: 1 }],\n * );\n * ```\n */\nexport function createSitemap(\n  config: RootTaleSiteConfig,\n  staticRoutes: SitemapEntry[] = [],\n): () => Promise<SitemapEntry[]> {\n  return async function sitemap(): Promise<SitemapEntry[]> {\n    const siteUrl = trimSlash(config.siteUrl);\n    const blogBase = config.blogBasePath ?? \"/blog\";\n    const posts = await safeFetchPosts(config, 200);\n    const postEntries: SitemapEntry[] = posts.map((p) => ({\n      url: `${siteUrl}${blogBase}/${p.slug}`,\n      lastModified: p.updatedAt ?? p.publishedAt ?? undefined,\n      changeFrequency: \"weekly\",\n      priority: 0.6,\n    }));\n    const categories = collectCategories(posts);\n    const categoryEntries: SitemapEntry[] = categories.length\n      ? [\n          {\n            url: `${siteUrl}${blogBase}/categories`,\n            changeFrequency: \"weekly\",\n            priority: 0.5,\n          },\n          ...categories.map((category) => ({\n            url: `${siteUrl}${blogBase}/categories/${category.slug}`,\n            changeFrequency: \"weekly\" as const,\n            priority: 0.5,\n          })),\n        ]\n      : [];\n    return [...staticRoutes, ...postEntries, ...categoryEntries];\n  };\n}\n\nexport interface RevalidateRouteConfig {\n  /** `rtlk_cust_*` — 블로그 조회/webhook 검증 공통 키. */\n  apiKey: string;\n  apiBase?: string;\n  /** Next 의 `revalidatePath` (또는 동등 콜백) 주입. */\n  revalidate: (path: string) => void | Promise<void>;\n  /** 블로그 base path. 기본 \"/blog\". */\n  blogBasePath?: string;\n  /**\n   * 모든 글/분류/미디어 변경에 대해 *항상 함께* revalidate 할 파생 경로.\n   * 피드·사이트맵·블로그 인덱스처럼 \"글 목록\"에 의존하는 경로 — admin 변경이\n   * 자동 반영되려면 필수. 기본: [\"/feed.xml\", \"/sitemap.xml\", blogBase].\n   */\n  alsoRevalidate?: string[];\n  /** (옵션) jti replay 방지 hook (cms-client verify 로 전달). */\n  consumeJti?: (jti: string, exp: number) => Promise<\"new\" | \"seen\">;\n}\n\n/** webhook 본문에서 paths[] 추출(서명 검증 후 호출 — body_hash 가 binding). */\nfunction pathsFromBody(rawBody: string): string[] {\n  try {\n    const body = JSON.parse(rawBody) as { paths?: unknown };\n    if (Array.isArray(body.paths)) {\n      return body.paths.filter((p): p is string => typeof p === \"string\");\n    }\n  } catch {\n    /* 비-JSON 본문 — 파생 경로만 revalidate */\n  }\n  return [];\n}\n\n/**\n * `app/api/revalidate/route.ts` 용 POST 핸들러.\n *\n * admin(mysite.roottale.com)이 글/카테고리/미디어 변경 시 보내는 서명 webhook 을\n * 검증하고, 본문 paths + 파생 경로(feed·sitemap·블로그 인덱스)를 revalidate.\n *\n * ```ts\n * import { revalidatePath } from \"next/cache\";\n * import { createRevalidateRoute } from \"@roottale/cms-renderer-next/routes\";\n * export const POST = createRevalidateRoute({\n *   apiKey: process.env.ROOTTALE_API_KEY!,\n *   revalidate: revalidatePath,\n * });\n * ```\n */\nexport function createRevalidateRoute(\n  config: RevalidateRouteConfig,\n): (req: Request) => Promise<Response> {\n  const blogBase = config.blogBasePath ?? \"/blog\";\n  const alsoRevalidate = config.alsoRevalidate ?? [\n    \"/feed.xml\",\n    \"/sitemap.xml\",\n    blogBase,\n    `${blogBase}/categories`,\n  ];\n\n  return async function POST(req: Request): Promise<Response> {\n    const rawBody = await req.text();\n    const result: VerifyRootTaleWebhookResult = await verifyRootTaleWebhook({\n      rawBody,\n      headers: req.headers,\n      apiKey: config.apiKey,\n      apiBase: config.apiBase,\n      consumeJti: config.consumeJti,\n    });\n    if (!result.ok) {\n      return Response.json({ ok: false, reason: result.reason }, { status: 401 });\n    }\n\n    // 본문 paths + 파생 경로(항상) — 중복 제거.\n    const paths = [...new Set([...pathsFromBody(rawBody), ...alsoRevalidate])];\n    for (const p of paths) {\n      await config.revalidate(p);\n    }\n\n    return Response.json({\n      ok: true,\n      event: result.event,\n      deliveryId: result.deliveryId,\n      revalidated: paths,\n    });\n  };\n}\n\n// ── fleet well-known (사이트 버전 노출 컨벤션) ───────────────────────────────\n\ndeclare const __CMS_RENDERER_VERSION__: string | undefined;\n\nexport interface FleetInfoRouteConfig {\n  /** 사이트 식별 라벨 (선택 — 기본 Vercel project URL 또는 null). */\n  site?: string;\n}\n\n/**\n * `GET /.well-known/roottale.json` — fleet 가시성 컨벤션 라우트.\n *\n * 플랫폼 internal fleet API 의 `?probe=1` 이 본 엔드포인트를 읽어 \"배포된\"\n * 패키지 버전을 트래픽 없이도 확인한다 (런타임 check-in 의 보조 신호).\n * 노출은 의도적으로 최소: 패키지 버전 + 짧은 build sha — 비밀 없음.\n *\n * 사용 (Next App Router):\n * ```ts\n * // app/.well-known/roottale.json/route.ts\n * import { createFleetInfoRoute } from \"@roottale/cms-renderer-next/routes\";\n * export const GET = createFleetInfoRoute();\n * ```\n */\nexport function createFleetInfoRoute(\n  config: FleetInfoRouteConfig = {},\n): () => Promise<Response> {\n  // dts 빌드는 node types 없이 돈다 — process 는 globalThis 경유로 안전 접근.\n  const env =\n    (globalThis as { process?: { env?: Record<string, string | undefined> } })\n      .process?.env ?? {};\n  return async function GET(): Promise<Response> {\n    return Response.json(\n      {\n        site: config.site ?? env.VERCEL_PROJECT_PRODUCTION_URL ?? null,\n        framework: \"next\",\n        cms_client: CMS_CLIENT_VERSION,\n        cms_renderer:\n          typeof __CMS_RENDERER_VERSION__ === \"string\"\n            ? __CMS_RENDERER_VERSION__\n            : \"dev\",\n        build_sha: env.VERCEL_GIT_COMMIT_SHA?.slice(0, 7) ?? null,\n      },\n      { headers: { \"cache-control\": \"public, max-age=300\" } },\n    );\n  };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/routes.ts"],"sourcesContent":["/**\n * `@roottale/cms-renderer-next/routes` — Next.js App Router 통합 라우트 팩토리.\n *\n * 외부 고객사 사이트가 매번 직접 작성하던 공통 라우트(RSS feed / sitemap /\n * revalidate webhook)를 1줄 팩토리로 표준화. 블로그 조회와 *동일한* 단일\n * customer API key(`ROOTTALE_API_KEY`)를 사용한다.\n *\n * 설계 원칙:\n * - feed/sitemap 은 `fetchPosts` 실패를 swallow → 라우트가 *항상 200* (빌드 시\n *   정적 생성이 throw 해서 404 나는 사고 방지).\n * - revalidate 는 admin(mysite.roottale.com)에서 글/카테고리/미디어 변경 시 보내는\n *   서명 webhook 을 검증하고, 본문 paths + 파생 경로(feed·sitemap·블로그 인덱스)를\n *   모두 revalidate → 각 사이트에 자동 반영.\n * - `next` 에 직접 의존하지 않음: revalidate 콜백(`revalidatePath`)을 주입받는다.\n *\n * 사용 예는 roottale-docs `services/external-site-integration.md` 참조.\n */\n\nimport {\n  CMS_CLIENT_VERSION,\n  fetchPost,\n  fetchPosts,\n  generateRssXml,\n  rssItemsFromPosts,\n  type CmsPostContent,\n} from \"@roottale/cms-client/server\";\nimport {\n  verifyRootTaleWebhook,\n  type VerifyRootTaleWebhookResult,\n} from \"@roottale/cms-client/webhook\";\nimport { collectCategories } from \"./blog-filter.js\";\n\nexport interface RootTaleSiteConfig {\n  /** `rtlk_cust_*` — 블로그 조회와 같은 키. 서버에서만(절대 브라우저 금지). */\n  apiKey: string;\n  /** API base 오버라이드. 기본 `https://api.roottale.com`. */\n  apiBase?: string;\n  /** 사이트 절대 URL (뒤 슬래시 없이). 예: `https://kjmtax.roottale.app`. */\n  siteUrl: string;\n  /** 피드/사이트 제목. */\n  title: string;\n  description?: string;\n  /** 기본 \"ko-KR\". */\n  language?: string;\n  /** 블로그 base path. 기본 \"/blog\". */\n  blogBasePath?: string;\n}\n\nfunction trimSlash(u: string): string {\n  return u.replace(/\\/+$/, \"\");\n}\n\nasync function safeFetchPosts(\n  config: RootTaleSiteConfig,\n  limit: number,\n): Promise<CmsPostContent[]> {\n  try {\n    const page = await fetchPosts({\n      apiKey: config.apiKey,\n      baseUrl: config.apiBase,\n      type: \"post\",\n      limit,\n    });\n    return page.items;\n  } catch (err) {\n    // 빌드/런타임 fetch 실패 시 빈 목록 — 라우트는 항상 정상 응답(404 방지).\n    console.error(\"[@roottale/cms-renderer-next/routes] fetchPosts 실패:\", err);\n    return [];\n  }\n}\n\n/**\n * `app/feed.xml/route.ts` 용 GET 핸들러. RSS 2.0.\n *\n * ```ts\n * import { createFeedRoute } from \"@roottale/cms-renderer-next/routes\";\n * export const dynamic = \"force-dynamic\";\n * export const GET = createFeedRoute({\n *   apiKey: process.env.ROOTTALE_API_KEY!,\n *   siteUrl: \"https://example.com\",\n *   title: \"Example 블로그\",\n *   description: \"...\",\n * });\n * ```\n */\nexport function createFeedRoute(\n  config: RootTaleSiteConfig,\n): () => Promise<Response> {\n  return async function GET(): Promise<Response> {\n    const siteUrl = trimSlash(config.siteUrl);\n    const blogBase = config.blogBasePath ?? \"/blog\";\n    const posts = await safeFetchPosts(config, 50);\n    const xml = generateRssXml({\n      title: config.title,\n      link: `${siteUrl}${blogBase}`,\n      feedUrl: `${siteUrl}/feed.xml`,\n      description: config.description,\n      language: config.language,\n      items: rssItemsFromPosts(posts, {\n        postUrl: (p) => `${siteUrl}${blogBase}/${p.slug}`,\n      }),\n    });\n    return new Response(xml, {\n      headers: {\n        \"content-type\": \"application/rss+xml; charset=utf-8\",\n        \"cache-control\": \"public, max-age=1800, s-maxage=1800\",\n      },\n    });\n  };\n}\n\n/** Next `MetadataRoute.Sitemap[number]` 와 구조 호환(타입 결합 회피). */\nexport interface SitemapEntry {\n  url: string;\n  lastModified?: string | Date;\n  changeFrequency?:\n    | \"always\"\n    | \"hourly\"\n    | \"daily\"\n    | \"weekly\"\n    | \"monthly\"\n    | \"yearly\"\n    | \"never\";\n  priority?: number;\n}\n\n/**\n * `app/sitemap.ts` default export. 정적 경로 + 글 경로를 합친다.\n *\n * ```ts\n * import { createSitemap } from \"@roottale/cms-renderer-next/routes\";\n * export default createSitemap(\n *   { apiKey: process.env.ROOTTALE_API_KEY!, siteUrl: \"https://example.com\", title: \"...\" },\n *   [{ url: \"https://example.com\", changeFrequency: \"weekly\", priority: 1 }],\n * );\n * ```\n */\nexport function createSitemap(\n  config: RootTaleSiteConfig,\n  staticRoutes: SitemapEntry[] = [],\n): () => Promise<SitemapEntry[]> {\n  return async function sitemap(): Promise<SitemapEntry[]> {\n    const siteUrl = trimSlash(config.siteUrl);\n    const blogBase = config.blogBasePath ?? \"/blog\";\n    const posts = await safeFetchPosts(config, 200);\n    const postEntries: SitemapEntry[] = posts.map((p) => ({\n      url: `${siteUrl}${blogBase}/${p.slug}`,\n      lastModified: p.updatedAt ?? p.publishedAt ?? undefined,\n      changeFrequency: \"weekly\",\n      priority: 0.6,\n    }));\n    const categories = collectCategories(posts);\n    const categoryEntries: SitemapEntry[] = categories.length\n      ? [\n          {\n            url: `${siteUrl}${blogBase}/categories`,\n            changeFrequency: \"weekly\",\n            priority: 0.5,\n          },\n          ...categories.map((category) => ({\n            url: `${siteUrl}${blogBase}/categories/${category.slug}`,\n            changeFrequency: \"weekly\" as const,\n            priority: 0.5,\n          })),\n        ]\n      : [];\n    return [...staticRoutes, ...postEntries, ...categoryEntries];\n  };\n}\n\n// ── llms.txt (AEO/GEO — AI 검색·생성엔진용 마크다운 인덱스) ──────────────────\n\n/** llms.txt 정적 섹션의 링크 1개. */\nexport interface LlmsTxtLink {\n  title: string;\n  url: string;\n  /** 링크 뒤 \": {note}\" 로 붙는 한 줄 설명 (선택). */\n  note?: string;\n}\n\n/** llms.txt 의 정적 페이지 링크 그룹 — 블로그 목록 앞에 출력. */\nexport interface LlmsTxtSection {\n  title: string;\n  links: LlmsTxtLink[];\n}\n\nexport type LlmsTxtRouteConfig = RootTaleSiteConfig & {\n  /** (선택) 서비스 소개 등 정적 페이지 링크 그룹. */\n  sections?: LlmsTxtSection[];\n};\n\n/** 마크다운 링크 텍스트를 깨뜨리는 문자([, ], (, )) 제거. */\nfunction mdLinkSafe(text: string): string {\n  return text.replace(/[[\\]()]/g, \"\").trim();\n}\n\n/** excerpt 를 1줄로 — 개행·연속 공백을 공백 1개로 정리 후 200자 절단. */\nfunction oneLine(text: string): string {\n  return text.replace(/\\s+/g, \" \").trim().slice(0, 200);\n}\n\n/**\n * `app/llms.txt/route.ts` 용 GET 핸들러 — AEO/GEO(AI 검색·생성엔진 최적화).\n *\n * AI 크롤러(ChatGPT/Claude/Perplexity 등)가 사이트 구조·콘텐츠를 빠르게\n * 파악하도록 llms.txt 스펙(https://llmstxt.org)의 마크다운 인덱스를 제공한다.\n * 발행 글 최대 100개를 \"## 블로그\" 섹션으로 자동 포함 — feed/sitemap 처럼\n * fetch 실패도 swallow 하여 *항상 200* (헤더 부분만 출력).\n *\n * ```ts\n * import { createLlmsTxtRoute } from \"@roottale/cms-renderer-next/routes\";\n * export const dynamic = \"force-dynamic\";\n * export const GET = createLlmsTxtRoute({\n *   apiKey: process.env.ROOTTALE_API_KEY!,\n *   siteUrl: \"https://example.com\",\n *   title: \"Example\",\n *   description: \"...\",\n *   sections: [{ title: \"주요 페이지\", links: [{ title: \"서비스\", url: \"https://example.com/services\" }] }],\n * });\n * ```\n */\nexport function createLlmsTxtRoute(\n  config: LlmsTxtRouteConfig,\n): () => Promise<Response> {\n  return async function GET(): Promise<Response> {\n    const siteUrl = trimSlash(config.siteUrl);\n    const blogBase = config.blogBasePath ?? \"/blog\";\n    const posts = await safeFetchPosts(config, 100);\n\n    const lines: string[] = [`# ${config.title}`];\n    if (config.description) {\n      lines.push(\"\", `> ${oneLine(config.description)}`);\n    }\n    for (const section of config.sections ?? []) {\n      lines.push(\"\", `## ${section.title}`);\n      for (const link of section.links) {\n        const note = link.note ? `: ${oneLine(link.note)}` : \"\";\n        lines.push(`- [${mdLinkSafe(link.title)}](${link.url})${note}`);\n      }\n    }\n    if (posts.length > 0) {\n      lines.push(\"\", \"## 블로그\");\n      for (const p of posts) {\n        const excerpt = p.excerpt ? `: ${oneLine(p.excerpt)}` : \"\";\n        lines.push(\n          `- [${mdLinkSafe(p.title)}](${siteUrl}${blogBase}/${p.slug})${excerpt}`,\n        );\n      }\n    }\n    lines.push(\"\");\n\n    return new Response(lines.join(\"\\n\"), {\n      headers: {\n        \"content-type\": \"text/plain; charset=utf-8\",\n        // feed 와 동일한 30분 캐시 — webhook alsoRevalidate 로 즉시 갱신됨.\n        \"cache-control\": \"public, max-age=1800, s-maxage=1800\",\n      },\n    });\n  };\n}\n\nexport interface RevalidateRouteConfig {\n  /** `rtlk_cust_*` — 블로그 조회/webhook 검증 공통 키. */\n  apiKey: string;\n  apiBase?: string;\n  /** Next 의 `revalidatePath` (또는 동등 콜백) 주입. */\n  revalidate: (path: string) => void | Promise<void>;\n  /** 블로그 base path. 기본 \"/blog\". */\n  blogBasePath?: string;\n  /**\n   * 모든 글/분류/미디어 변경에 대해 *항상 함께* revalidate 할 파생 경로.\n   * 피드·사이트맵·블로그 인덱스처럼 \"글 목록\"에 의존하는 경로 — admin 변경이\n   * 자동 반영되려면 필수.\n   * 기본: [\"/feed.xml\", \"/sitemap.xml\", \"/llms.txt\", blogBase, `${blogBase}/categories`].\n   */\n  alsoRevalidate?: string[];\n  /** (옵션) jti replay 방지 hook (cms-client verify 로 전달). */\n  consumeJti?: (jti: string, exp: number) => Promise<\"new\" | \"seen\">;\n}\n\n/** webhook 본문에서 paths[] 추출(서명 검증 후 호출 — body_hash 가 binding). */\nfunction pathsFromBody(rawBody: string): string[] {\n  try {\n    const body = JSON.parse(rawBody) as { paths?: unknown };\n    if (Array.isArray(body.paths)) {\n      return body.paths.filter((p): p is string => typeof p === \"string\");\n    }\n  } catch {\n    /* 비-JSON 본문 — 파생 경로만 revalidate */\n  }\n  return [];\n}\n\n/**\n * `app/api/revalidate/route.ts` 용 POST 핸들러.\n *\n * admin(mysite.roottale.com)이 글/카테고리/미디어 변경 시 보내는 서명 webhook 을\n * 검증하고, 본문 paths + 파생 경로(feed·sitemap·블로그 인덱스)를 revalidate.\n *\n * ```ts\n * import { revalidatePath } from \"next/cache\";\n * import { createRevalidateRoute } from \"@roottale/cms-renderer-next/routes\";\n * export const POST = createRevalidateRoute({\n *   apiKey: process.env.ROOTTALE_API_KEY!,\n *   revalidate: revalidatePath,\n * });\n * ```\n */\nexport function createRevalidateRoute(\n  config: RevalidateRouteConfig,\n): (req: Request) => Promise<Response> {\n  const blogBase = config.blogBasePath ?? \"/blog\";\n  const alsoRevalidate = config.alsoRevalidate ?? [\n    \"/feed.xml\",\n    \"/sitemap.xml\",\n    // 글 변경 시 AI 크롤러용 llms.txt 인덱스도 함께 갱신 (AEO/GEO).\n    \"/llms.txt\",\n    blogBase,\n    `${blogBase}/categories`,\n  ];\n\n  return async function POST(req: Request): Promise<Response> {\n    const rawBody = await req.text();\n    const result: VerifyRootTaleWebhookResult = await verifyRootTaleWebhook({\n      rawBody,\n      headers: req.headers,\n      apiKey: config.apiKey,\n      apiBase: config.apiBase,\n      consumeJti: config.consumeJti,\n    });\n    if (!result.ok) {\n      return Response.json({ ok: false, reason: result.reason }, { status: 401 });\n    }\n\n    // 본문 paths + 파생 경로(항상) — 중복 제거.\n    const paths = [...new Set([...pathsFromBody(rawBody), ...alsoRevalidate])];\n    for (const p of paths) {\n      await config.revalidate(p);\n    }\n\n    return Response.json({\n      ok: true,\n      event: result.event,\n      deliveryId: result.deliveryId,\n      revalidated: paths,\n    });\n  };\n}\n\n// ── slug 변경 301 (WP permalink 패리티) ─────────────────────────────────────\n\n/**\n * 옛 slug → 현재 slug 301 redirect 판단 (순수 함수, `next` 비의존).\n *\n * Public API 는 slug 변경 후에도 옛 slug 로 글을 찾아 *현재* slug 를 응답한다\n * (post_slug_history fallback). 요청 slug 와 응답 slug 가 다르면 새 경로를\n * 반환 — 페이지에서 `permanentRedirect()` 로 301 처리한다:\n *\n * ```ts\n * import { permanentRedirect, notFound } from \"next/navigation\";\n * import { postRedirectPath } from \"@roottale/cms-renderer-next/routes\";\n *\n * const post = await getPost(slug);\n * if (!post) notFound();\n * const redirect = postRedirectPath(post, slug);\n * if (redirect) permanentRedirect(redirect);\n * ```\n *\n * Next App Router 의 `params` 는 percent-encoding 된 채 들어올 수 있어\n * (한글 slug) 디코딩 후 비교한다. redirect 가 불필요하면 null.\n */\nexport function postRedirectPath(\n  post: { slug: string },\n  requestedSlug: string,\n  blogBasePath = \"/blog\",\n): string | null {\n  let requested = requestedSlug;\n  try {\n    requested = decodeURIComponent(requestedSlug);\n  } catch {\n    /* 잘못된 escape — 원본 그대로 비교 */\n  }\n  if (post.slug === requested) return null;\n  // blogBasePath \"/\" 또는 \"\" = 루트 배치 → \"/{slug}\".\n  return `${trimSlash(blogBasePath)}/${encodeURIComponent(post.slug)}`;\n}\n\n// ── fleet well-known (사이트 버전 노출 컨벤션) ───────────────────────────────\n\ndeclare const __CMS_RENDERER_VERSION__: string | undefined;\n\nexport interface FleetInfoRouteConfig {\n  /** 사이트 식별 라벨 (선택 — 기본 Vercel project URL 또는 null). */\n  site?: string;\n}\n\n/**\n * `GET /.well-known/roottale.json` — fleet 가시성 컨벤션 라우트.\n *\n * 플랫폼 internal fleet API 의 `?probe=1` 이 본 엔드포인트를 읽어 \"배포된\"\n * 패키지 버전을 트래픽 없이도 확인한다 (런타임 check-in 의 보조 신호).\n * 노출은 의도적으로 최소: 패키지 버전 + 짧은 build sha — 비밀 없음.\n *\n * 사용 (Next App Router):\n * ```ts\n * // app/.well-known/roottale.json/route.ts\n * import { createFleetInfoRoute } from \"@roottale/cms-renderer-next/routes\";\n * export const GET = createFleetInfoRoute();\n * ```\n */\nexport function createFleetInfoRoute(\n  config: FleetInfoRouteConfig = {},\n): () => Promise<Response> {\n  // dts 빌드는 node types 없이 돈다 — process 는 globalThis 경유로 안전 접근.\n  const env =\n    (globalThis as { process?: { env?: Record<string, string | undefined> } })\n      .process?.env ?? {};\n  return async function GET(): Promise<Response> {\n    return Response.json(\n      {\n        site: config.site ?? env.VERCEL_PROJECT_PRODUCTION_URL ?? null,\n        framework: \"next\",\n        cms_client: CMS_CLIENT_VERSION,\n        cms_renderer:\n          typeof __CMS_RENDERER_VERSION__ === \"string\"\n            ? __CMS_RENDERER_VERSION__\n            : \"dev\",\n        build_sha: env.VERCEL_GIT_COMMIT_SHA?.slice(0, 7) ?? null,\n      },\n      { headers: { \"cache-control\": \"public, max-age=300\" } },\n    );\n  };\n}\n\n// ── 동적 OG 이미지 (글별 1200×630) ──────────────────────────────────────────\n\n/** Next `opengraph-image` export 컨벤션과 호환되는 크기 상수. */\nexport const OG_IMAGE_SIZE = { width: 1200, height: 630 } as const;\nexport const OG_IMAGE_CONTENT_TYPE = \"image/png\";\n\nexport interface OgImageRouteConfig extends RootTaleSiteConfig {\n  /** 배경색. 기본 진네이비 그라데이션 베이스. */\n  backgroundColor?: string;\n  /** 본문 텍스트 색. 기본 흰색. */\n  foregroundColor?: string;\n  /** 상단 액센트 바 + 브랜드 라벨 색. 기본 하늘색. */\n  accentColor?: string;\n  /** 하단 브랜드 라벨. 기본 = `title`. */\n  brandLabel?: string;\n}\n\n/** `next/og` 의 ImageResponse 와 구조 호환(직접 의존 회피 — revalidate 콜백 주입과 동일 원칙). */\nexport interface ImageResponseLike {\n  new (\n    element: unknown,\n    options?: {\n      width?: number;\n      height?: number;\n      fonts?: { name: string; data: ArrayBuffer; weight?: number; style?: \"normal\" }[];\n    },\n  ): Response;\n}\n\n/**\n * 제목에 쓰인 글자만 부분셋(subset)으로 받아 한글을 렌더 — satori 기본 폰트는\n * 한글 글리프가 없다. 구형 UA 로 css2 를 호출하면 TTF(satori 호환) URL 을 준다.\n * 실패 시 null — 폰트 없이도 이미지는 생성(라틴 fallback).\n */\nasync function loadKoreanFontSubset(text: string): Promise<ArrayBuffer | null> {\n  try {\n    const unique = Array.from(new Set(Array.from(text))).join(\"\");\n    const cssUrl = `https://fonts.googleapis.com/css2?family=Noto+Sans+KR:wght@700&text=${encodeURIComponent(unique)}`;\n    const cssRes = await fetch(cssUrl, {\n      headers: { \"user-agent\": \"Mozilla/5.0 (Windows NT 6.1; rv:10.0)\" },\n    });\n    if (!cssRes.ok) return null;\n    const css = await cssRes.text();\n    const match = css.match(\n      /src:\\s*url\\(([^)]+)\\)\\s*format\\(['\"](?:truetype|opentype)['\"]\\)/,\n    );\n    if (!match?.[1]) return null;\n    const fontRes = await fetch(match[1]);\n    if (!fontRes.ok) return null;\n    return await fontRes.arrayBuffer();\n  } catch (err) {\n    console.error(\"[@roottale/cms-renderer-next/routes] OG 폰트 로딩 실패:\", err);\n    return null;\n  }\n}\n\n/**\n * `app/blog/[slug]/opengraph-image.tsx` 용 동적 OG 이미지 (1200×630).\n *\n * `next/og` 의 ImageResponse 를 주입받는다 — 본 패키지는 `next` 에 직접\n * 의존하지 않는다. 글이 없거나 fetch 실패면 사이트 제목만으로 fail-soft 렌더\n * (소셜 크롤러에 빈 카드 대신 브랜드 카드).\n *\n * ```tsx\n * // app/blog/[slug]/opengraph-image.tsx\n * import { ImageResponse } from \"next/og\";\n * import {\n *   createPostOgImage,\n *   OG_IMAGE_SIZE,\n *   OG_IMAGE_CONTENT_TYPE,\n * } from \"@roottale/cms-renderer-next/routes\";\n * import { roottale } from \"@/lib/roottale\"; // RootTaleSiteConfig\n *\n * export const size = OG_IMAGE_SIZE;\n * export const contentType = OG_IMAGE_CONTENT_TYPE;\n * export default createPostOgImage(roottale, { ImageResponse });\n * ```\n */\nexport function createPostOgImage(\n  config: OgImageRouteConfig,\n  deps: { ImageResponse: ImageResponseLike },\n): (props: { params: Promise<{ slug: string }> | { slug: string } }) => Promise<Response> {\n  const background = config.backgroundColor ?? \"#10172a\";\n  const foreground = config.foregroundColor ?? \"#f8fafc\";\n  const accent = config.accentColor ?? \"#38bdf8\";\n  const brand = config.brandLabel ?? config.title;\n\n  return async function OgImage(props): Promise<Response> {\n    const { slug } = await props.params;\n\n    let title = config.title;\n    let dateLabel: string | null = null;\n    try {\n      const post = await fetchPost({\n        apiKey: config.apiKey,\n        baseUrl: config.apiBase,\n        slugOrId: slug,\n      });\n      if (post) {\n        title = post.title;\n        dateLabel = new Intl.DateTimeFormat(\"ko-KR\", { dateStyle: \"long\" }).format(\n          new Date(post.publishedAt),\n        );\n      }\n    } catch (err) {\n      console.error(\"[@roottale/cms-renderer-next/routes] OG fetchPost 실패:\", err);\n    }\n\n    // satori 줄바꿈에 맡기되 3줄을 넘는 초장문 제목만 자른다.\n    const display = title.length > 64 ? `${title.slice(0, 63)}…` : title;\n    const fontData = await loadKoreanFontSubset(`${display}${brand}${dateLabel ?? \"\"}`);\n\n    const { createElement: h } = await import(\"react\");\n    const element = h(\n      \"div\",\n      {\n        style: {\n          width: \"100%\",\n          height: \"100%\",\n          display: \"flex\",\n          flexDirection: \"column\",\n          justifyContent: \"space-between\",\n          padding: \"72px 80px\",\n          backgroundColor: background,\n          backgroundImage: `linear-gradient(135deg, ${background} 60%, rgba(56,189,248,0.25))`,\n          color: foreground,\n          fontFamily: fontData ? \"NotoSansKR\" : \"sans-serif\",\n        },\n      },\n      h(\"div\", {\n        style: { width: 96, height: 10, backgroundColor: accent, borderRadius: 5 },\n      }),\n      h(\n        \"div\",\n        {\n          style: {\n            display: \"flex\",\n            fontSize: display.length > 36 ? 56 : 68,\n            fontWeight: 700,\n            lineHeight: 1.25,\n            letterSpacing: \"-0.02em\",\n            wordBreak: \"keep-all\",\n          },\n        },\n        display,\n      ),\n      h(\n        \"div\",\n        {\n          style: {\n            display: \"flex\",\n            justifyContent: \"space-between\",\n            alignItems: \"center\",\n            fontSize: 28,\n          },\n        },\n        h(\"div\", { style: { display: \"flex\", color: accent, fontWeight: 700 } }, brand),\n        h(\n          \"div\",\n          { style: { display: \"flex\", color: \"rgba(248,250,252,0.72)\" } },\n          dateLabel ?? trimSlash(config.siteUrl).replace(/^https?:\\/\\//, \"\"),\n        ),\n      ),\n    );\n\n    return new deps.ImageResponse(element, {\n      width: OG_IMAGE_SIZE.width,\n      height: OG_IMAGE_SIZE.height,\n      ...(fontData\n        ? { fonts: [{ name: \"NotoSansKR\", data: fontData, weight: 700 as const, style: \"normal\" as const }] }\n        : {}),\n    });\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/server.js

@@ -15,7 +15,7 @@ import {
   renderBlock,
   renderBlocks,
   renderBoundBlocks
-} from "./chunk-DCTKVXWE.js";
+} from "./chunk-RJGHU6IL.js";
 import {
   collectCategories,
   collectCategoriesWithCounts,

package/dist/templates.css

@@ -15,7 +15,7 @@
 :where([data-roottale-tpl]) {
   padding-block: clamp(3rem, 8vw, 6rem);
   background: var(--rt-color-background, transparent);
-  color: var(--rt-color-foreground, #111827);
+  color: var(--rt-color-foreground, #06162f);
   font-family: var(--rt-font-body, system-ui, -apple-system, sans-serif);
 }
 
@@ -34,7 +34,7 @@
 }
 
 [data-roottale-tpl] :where(.rt-tpl-section-desc) {
-  color: var(--rt-color-muted-foreground, #6b7280);
+  color: var(--rt-color-muted-foreground, #6e6e6e);
   max-inline-size: 46rem;
   margin-block: -0.75rem 2rem;
 }
@@ -57,7 +57,7 @@
 }
 
 [data-roottale-tpl] :where(.rt-tpl-btn--primary) {
-  background: var(--rt-color-primary, #4f46e5);
+  background: var(--rt-color-primary, #06162f);
   color: var(--rt-color-primary-foreground, #ffffff);
 }
 
@@ -95,7 +95,7 @@
 }
 
 [data-roottale-tpl] :where(.rt-tpl-hero-eyebrow) {
-  color: var(--rt-color-primary, #4f46e5);
+  color: var(--rt-color-primary, #06162f);
   font-weight: 800;
   letter-spacing: 0.04em;
   margin: 0 0 0.75rem;
@@ -115,7 +115,7 @@
 
 [data-roottale-tpl] :where(.rt-tpl-hero-desc) {
   font-size: 1.125rem;
-  color: var(--rt-color-muted-foreground, #6b7280);
+  color: var(--rt-color-muted-foreground, #6e6e6e);
   max-inline-size: 40rem;
   margin: 0 0 2rem;
 }
@@ -149,7 +149,7 @@
 }
 
 [data-roottale-tpl] :where(.rt-tpl-services-item) {
-  border: 1px solid var(--rt-color-border, #e5e7eb);
+  border: 1px solid var(--rt-color-border, #dceef3);
   border-radius: var(--rt-radius-md, 0.5rem);
   padding: 1.5rem;
   background: var(--rt-color-background, #ffffff);
@@ -161,8 +161,8 @@
 [data-roottale-tpl] :where(.rt-tpl-services-item:hover) {
   border-color: color-mix(
     in srgb,
-    var(--rt-color-primary, #4f46e5) 40%,
-    var(--rt-color-border, #e5e7eb)
+    var(--rt-color-primary, #06162f) 40%,
+    var(--rt-color-border, #dceef3)
   );
   transform: translateY(-2px);
 }
@@ -181,7 +181,7 @@
 }
 
 [data-roottale-tpl] :where(.rt-tpl-services-desc) {
-  color: var(--rt-color-muted-foreground, #6b7280);
+  color: var(--rt-color-muted-foreground, #6e6e6e);
   font-size: 0.9375rem;
   margin: 0;
 }
@@ -195,7 +195,7 @@
 }
 
 [data-roottale-tpl] :where(.rt-tpl-faq-item) {
-  border: 1px solid var(--rt-color-border, #e5e7eb);
+  border: 1px solid var(--rt-color-border, #dceef3);
   border-radius: var(--rt-radius-md, 0.5rem);
   padding: 1rem 1.25rem;
   background: var(--rt-color-background, #ffffff);
@@ -208,12 +208,12 @@
 }
 
 [data-roottale-tpl] :where(.rt-tpl-faq-item[open] .rt-tpl-faq-q) {
-  color: var(--rt-color-primary, #4f46e5);
+  color: var(--rt-color-primary, #06162f);
 }
 
 [data-roottale-tpl] :where(.rt-tpl-faq-a) {
   margin: 0.75rem 0 0;
-  color: var(--rt-color-muted-foreground, #6b7280);
+  color: var(--rt-color-muted-foreground, #6e6e6e);
 }
 
 /* ── cta-banner ───────────────────────────────────────────────────────────── */
@@ -228,10 +228,10 @@
   border-radius: var(--rt-radius-md, 0.5rem);
   background: color-mix(
     in srgb,
-    var(--rt-color-primary, #4f46e5) 8%,
+    var(--rt-color-primary, #06162f) 8%,
     var(--rt-color-background, #ffffff)
   );
-  border: 1px solid var(--rt-color-border, #e5e7eb);
+  border: 1px solid var(--rt-color-border, #dceef3);
 }
 
 [data-roottale-tpl] :where(.rt-tpl-cta-banner-title) {
@@ -242,7 +242,7 @@
 }
 
 [data-roottale-tpl] :where(.rt-tpl-cta-banner-desc) {
-  color: var(--rt-color-muted-foreground, #6b7280);
+  color: var(--rt-color-muted-foreground, #6e6e6e);
   margin: 0;
   max-inline-size: 40rem;
 }
@@ -250,11 +250,11 @@
 /* ── placeholder (admin preview 의 customSections skeleton) ──────────────── */
 
 [data-roottale-tpl] :where(.rt-tpl-placeholder-box) {
-  border: 2px dashed var(--rt-color-border, #e5e7eb);
+  border: 2px dashed var(--rt-color-border, #dceef3);
   border-radius: var(--rt-radius-md, 0.5rem);
   padding: 2.5rem;
   text-align: center;
-  color: var(--rt-color-muted-foreground, #6b7280);
+  color: var(--rt-color-muted-foreground, #6e6e6e);
   font-family: ui-monospace, monospace;
   font-size: 0.875rem;
 }

package/dist/templates.js

@@ -1,7 +1,7 @@
 import {
   RootTaleBlogList,
   RootTaleLeadForm
-} from "./chunk-DCTKVXWE.js";
+} from "./chunk-RJGHU6IL.js";
 import "./chunk-QWBFHYB6.js";
 
 // src/templates/site-config.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@roottale/cms-renderer-next",
-  "version": "0.22.0",
+  "version": "0.25.0",
   "type": "module",
   "description": "RootTale CMS public-render React/Next.js Server Components. SSR-only RSC components (RootTaleBlogList / RootTaleBlogPost / RootTaleLeadForm) for external customer sites. Companion of @roottale/cms-renderer-astro (ADR-0034 §1.5 amended).",
   "main": "./dist/index.js",
@@ -42,7 +42,7 @@
   ],
   "dependencies": {
     "zod": "^3.23.8",
-    "@roottale/cms-client": "^0.20.0",
+    "@roottale/cms-client": "^0.25.0",
     "@roottale/cms-core": "^0.18.0"
   },
   "peerDependencies": {