@roottale/cms-renderer-next 0.52.0 → 0.53.1

package/CHANGELOG.md

@@ -1,5 +1,58 @@
 # @roottale/cms-renderer-next
 
+## 0.53.1
+
+### Patch Changes
+
+- 1efecbb: 페이지·글·정보의 콘텐츠 모델 공개 계약과 `modelKey` 조회를 추가합니다. 개발자가 선언한 슬롯에서만 배너·팝업을 조회하고 접근성 있게 렌더하는 API, client, renderer, 예제 문서를 함께 제공합니다. 기존 collections와 collectionKey 계약은 유지합니다.
+- 800a797: CMS 글 목록 API가 일시적으로 실패해도 `RootTaleBlogList`와 `RootTaleBlogCategories`가 빈 상태를 렌더하도록 바꿉니다. 신규 사이트의 최초 빌드와 공개 목록 페이지가 CMS 장애 때문에 전체 500으로 중단되지 않습니다.
+- 5cd0e3b: 주소 이동 middleware가 API 장애 시 stale 규칙을 계속 사용하고, 순환 규칙은 브라우저를 왕복시키지 않도록 통과처리합니다. Site Materializer 납품물에 middleware와 회귀 검증 파일을 필수로 포함합니다.
+- cf84636: ChatGPT 등에서 만든 완전한 HTML 문서의 태그 구조, class·id·`data-*`, inline style·`<style>` CSS와 반응형 레이아웃을 `importedHtml` 블록에 보존합니다. 본문의 `h1`은 글 제목과 충돌하지 않도록 `h2`로 바꾸되 원래 `h1` CSS 선택자는 변환된 제목에 이어서 적용합니다. 안전한 `!important`도 유지합니다. CSS는 블록별 고유 범위로 격리하며 스크립트·이벤트 속성·외부 CSS 로드·화면을 덮는 CSS만 제거합니다.
+
+  `html`·`body` 속성, SVG, `picture`·`srcset`, keyframes와 미러링한 CSS 이미지·woff/woff2 폰트도 보존합니다. 가져온 블록별로 문서 루트, animation과 font 이름을 격리해 다른 본문이나 사이트 UI와 충돌하지 않게 합니다.
+
+- Updated dependencies [6df15b6]
+- Updated dependencies [1efecbb]
+- Updated dependencies [cf84636]
+  - @roottale/cms-client@0.53.1
+  - @roottale/cms-core@0.53.1
+
+## 0.53.0
+
+### Minor Changes
+
+- a133f27: 블로그 상세 글의 작성·출력 기준을 하나로 맞췄습니다.
+  - 이미지 대체 텍스트를 한 줄, 최대 160자로 정규화하는 공용 계약을 추가했습니다.
+  - 상세 글 위에 카테고리를 연결하고, 발행일과 실제로 다른 수정일을 구분해 표시합니다.
+  - 본문의 공식 출처 블록을 제목과 목록이 있는 시맨틱 구간으로 렌더합니다.
+  - 블로그 전용 SEO 점검에서 목차, 외부 링크가 있는 공식 출처, 내용이 채워진 FAQ를 확인합니다.
+  - Next.js 상세 라우트가 글을 먼저 조회한 뒤 `notFound()`를 호출해야 실제 404가 된다는 통합 예제를 보강했습니다.
+
+- e3e7ba8: 블로그 상세 상단에 CMS에서 기록한 내용 검토일과 검토자를 표시합니다.
+- 7d1a551: 글 메타데이터가 OG 이미지 대체 텍스트와 Google의 큰 이미지 미리보기 지시자를 함께 출력합니다.
+- 3dc6e1d: 공개 CMS runtime에서 RootTale의 private 마케팅 섹션 공장을 분리했습니다.
+  - `templates`, `templates/styles`, `validate`, `templates/seo-checks` 공개 subpath를 제거했습니다.
+  - 글·페이지 본문, 테마 bridge, 문의, feed·sitemap·webhook runtime은 그대로 유지합니다.
+  - `section` 노드는 공개 renderer가 자동으로 해석하지 않으며, 내부 제작 경로가 명시적으로 renderer를 등록해야 합니다.
+  - 같은 릴리스 묶음의 `@roottale/cms-core` 변경과 함께 배포해야 합니다.
+
+### Patch Changes
+
+- 2eb82d3: 블로그 작성자 프로필의 기준을 글에 지정된 사이트 작성자 한 곳으로 통합했습니다.
+  - 작성자가 없는 글은 전역 설정으로 작성자 카드가 만들어지지 않습니다.
+  - 작성자 이름·사진·소개는 글 응답의 작성자 프로필만 사용합니다.
+  - 레거시 전역 작성자 응답 필드는 호환을 위해 남지만 항상 `null`입니다.
+
+- 3ab5570: RSS 생성기에 선택적인 WebSub `atom:hub` 링크를 추가했다. `createFeedRoute`는
+  `webSubHubUrl`을 받아 이를 피드에 전달하며, 값을 주지 않은 기존 사이트의 출력은
+  바뀌지 않는다. Site Kit은 Google WebSub hub를 기본 연결하고 IndexNow 소유권 확인용
+  `/indexnow-key.txt` 라우트를 제공한다.
+- Updated dependencies [a133f27]
+- Updated dependencies [f743a06]
+- Updated dependencies [3ab5570]
+  - @roottale/cms-core@0.53.0
+  - @roottale/cms-client@0.53.0
+
 ## 0.52.0
 
 ### Minor Changes

package/README.md

@@ -6,7 +6,9 @@ Drop-in `<RootTaleBlogList>` / `<RootTaleBlogPost>` / `<RootTaleLeadForm>` for N
 
 Pair with [`@roottale/cms-client`](https://www.npmjs.com/package/@roottale/cms-client) (the fetch client) and the RootTale CMS admin (`mysite.roottale.com`) where you author the content.
 
-Astro counterpart: [`@roottale/cms-renderer-astro`](https://www.npmjs.com/package/@roottale/cms-renderer-astro) — equivalent surface (ADR-0034 §1.5).
+이 public package는 글·페이지 본문과 CMS 연동 runtime만 제공한다. RootTale의
+전문직·B2B 마케팅 섹션, variants와 `SectionSchema`는 private 제작 공장에 있으며
+고객 사이트에는 선택된 결과만 local source로 전달한다.
 
 ## Install
 
@@ -146,7 +148,9 @@ export default async function CategoryPage({
 ## Blog post — `app/blog/[slug]/page.tsx`
 
 ```tsx
+import { fetchPost } from "@roottale/cms-client/server";
 import { RootTaleBlogPost } from "@roottale/cms-renderer-next/server";
+import { notFound } from "next/navigation";
 
 export default async function PostPage({
   params,
@@ -154,13 +158,21 @@ export default async function PostPage({
   params: Promise<{ slug: string }>;
 }) {
   const { slug } = await params;
+  const post = await fetchPost({
+    apiKey: process.env.ROOTTALE_API_KEY!,
+    slugOrId: slug,
+  });
+  if (!post) notFound();
+
   return (
     <main>
       <RootTaleBlogPost
         apiKey={process.env.ROOTTALE_API_KEY!}
-        slugOrId={slug}
+        slugOrId={post.id}
         showTableOfContents
         tableOfContentsTitle="목차"
+        breadcrumb={{ siteUrl: process.env.NEXT_PUBLIC_SITE_URL }}
+        relatedPostsCount={3}
       />
     </main>
   );
@@ -171,6 +183,15 @@ export default async function PostPage({
 already renders that title, pass `showTitle={false}` to avoid a duplicate
 heading. The excerpt, post metadata, and body remain visible.
 
+Fetch the post in the route and call Next.js `notFound()` before rendering, as
+shown above. `notFoundElement` only changes the component fallback; it cannot
+turn a successful route response into an HTTP 404.
+
+When present, category links render above the `<h1>`. The metadata row labels
+the published date and displays a separate modified date only when its calendar
+date differs. Body images always receive a one-line alt value capped at 160
+characters.
+
 ## Lead form — `app/contact/page.tsx`
 
 ```tsx
@@ -206,7 +227,7 @@ The form submits via HTML POST (no custom JS). In a Next.js site, point `action`
 
 | Export | Use |
 |---|---|
-| `RootTaleBlogList` | RSC — fetches `/v1/cms/public/posts?type=post` and renders an `<ul>`. |
+| `RootTaleBlogList` | RSC — fetches `/v1/cms/public/posts?type=post`; renders an `<ul>` or a fail-soft empty state. |
 | `RootTaleBlogPost` | RSC — fetches one post, renders Tiptap doc + optional TOC. |
 | `RootTaleLeadForm` | RSC — HTML form for `/v1/public/inquiries` forward routes. |
 | `RootTalePostCard` | Single card primitive (used internally by `RootTaleBlogList`). |
@@ -218,7 +239,15 @@ The form submits via HTML POST (no custom JS). In a Next.js site, point `action`
 ## Security model
 
 - `@roottale/cms-client` throws if you import it into a browser bundle (`assertServer()`). Never expose `rtlk_cust_*` to the client.
-- Block JSON is server-rendered with hardcoded mark/node mappings — no `dangerouslySetInnerHTML` from authored content. Links pass an `isSafeHref()` allowlist (http/https/mailto/tel/root-relative/fragment/query).
+- Block JSON is server-rendered with hardcoded mark/node mappings. The `importedHtml`
+  node is the only authored raw-HTML boundary: the renderer sanitizes its semantic
+  markup and imported CSS again before `dangerouslySetInnerHTML`. Imported selectors
+  are isolated to a per-block scope. Body `h1` elements become `h2` so the page title
+  remains the only `h1`; original `h1` selectors are mapped to the converted heading.
+  `data-*` selectors and safe `!important` declarations are preserved. Scripts, event
+  handlers, unsafe URL schemes, external CSS loads, and layout-overlay CSS are removed.
+  Links in ordinary Tiptap nodes pass an `isSafeHref()` allowlist
+  (http/https/mailto/tel/root-relative/fragment/query).
 - The default `target="_blank"` on link marks gets `rel="noopener noreferrer"`.
 
 ## Compatibility

package/dist/chunk-GVKENK6H.js

@@ -0,0 +1,75 @@
+"use client";
+
+// src/exposure-client.tsx
+import { useEffect, useRef, useState, useSyncExternalStore } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+function storageKey(campaign) {
+  return `rt-exposure-dismissed:${campaign.id}`;
+}
+function wasDismissed(campaign) {
+  if (campaign.repeat === "always") return false;
+  try {
+    const storage = campaign.repeat === "session" ? sessionStorage : localStorage;
+    const value = storage.getItem(storageKey(campaign));
+    if (!value) return false;
+    if (campaign.repeat === "day") return Date.now() - Number(value) < 864e5;
+    return true;
+  } catch {
+    return false;
+  }
+}
+function rememberDismissal(campaign) {
+  if (campaign.repeat === "always") return;
+  try {
+    const storage = campaign.repeat === "session" ? sessionStorage : localStorage;
+    storage.setItem(storageKey(campaign), String(Date.now()));
+  } catch {
+  }
+}
+function RootTaleExposure({
+  campaign,
+  allowedVariants
+}) {
+  const [dismissed, setDismissed] = useState(false);
+  const closeRef = useRef(null);
+  const knownVariant = allowedVariants.includes(campaign.content.variant);
+  const eligible = useSyncExternalStore(
+    () => () => void 0,
+    () => !wasDismissed(campaign),
+    () => false
+  );
+  const visible = knownVariant && eligible && !dismissed;
+  useEffect(() => {
+    if (!visible || campaign.kind !== "popup") return;
+    closeRef.current?.focus();
+    const onKeyDown = (event) => {
+      if (event.key === "Escape") dismiss();
+    };
+    window.addEventListener("keydown", onKeyDown);
+    return () => window.removeEventListener("keydown", onKeyDown);
+  });
+  function dismiss() {
+    rememberDismissal(campaign);
+    setDismissed(true);
+  }
+  if (!knownVariant || !visible) return null;
+  const body = /* @__PURE__ */ jsxs("div", { className: "rt-exposure__body", children: [
+    campaign.content.assetUrl ? /* @__PURE__ */ jsx("img", { className: "rt-exposure__asset", src: campaign.content.assetUrl, alt: campaign.content.assetAlt ?? "" }) : null,
+    /* @__PURE__ */ jsxs("div", { className: "rt-exposure__copy", children: [
+      campaign.content.eyebrow ? /* @__PURE__ */ jsx("p", { className: "rt-exposure__eyebrow", children: campaign.content.eyebrow }) : null,
+      /* @__PURE__ */ jsx("h2", { className: "rt-exposure__title", children: campaign.content.title }),
+      campaign.content.description ? /* @__PURE__ */ jsx("p", { className: "rt-exposure__description", children: campaign.content.description }) : null,
+      campaign.content.linkUrl && campaign.content.linkLabel ? /* @__PURE__ */ jsx("a", { className: "rt-exposure__link", href: campaign.content.linkUrl, children: campaign.content.linkLabel }) : null
+    ] }),
+    /* @__PURE__ */ jsx("button", { ref: closeRef, type: "button", className: "rt-exposure__close", "aria-label": "\uB2EB\uAE30", onClick: dismiss, children: "\xD7" })
+  ] });
+  if (campaign.kind === "banner") {
+    return /* @__PURE__ */ jsx("aside", { className: `rt-exposure rt-exposure--banner rt-exposure--${campaign.content.variant}`, "aria-label": "\uC548\uB0B4", children: body });
+  }
+  return /* @__PURE__ */ jsx("div", { className: "rt-exposure-backdrop", role: "presentation", children: /* @__PURE__ */ jsx("section", { className: `rt-exposure rt-exposure--popup rt-exposure--${campaign.content.variant}`, role: "dialog", "aria-modal": "true", "aria-label": campaign.content.title, children: body }) });
+}
+
+export {
+  RootTaleExposure
+};
+//# sourceMappingURL=chunk-GVKENK6H.js.map

package/dist/chunk-GVKENK6H.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/exposure-client.tsx"],"sourcesContent":["\"use client\";\n\nimport { useEffect, useRef, useState, useSyncExternalStore } from \"react\";\n\nimport type { CmsExposureCampaign } from \"@roottale/cms-client/server\";\n\nfunction storageKey(campaign: CmsExposureCampaign): string {\n  return `rt-exposure-dismissed:${campaign.id}`;\n}\n\nfunction wasDismissed(campaign: CmsExposureCampaign): boolean {\n  if (campaign.repeat === \"always\") return false;\n  try {\n    const storage = campaign.repeat === \"session\" ? sessionStorage : localStorage;\n    const value = storage.getItem(storageKey(campaign));\n    if (!value) return false;\n    if (campaign.repeat === \"day\") return Date.now() - Number(value) < 86_400_000;\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nfunction rememberDismissal(campaign: CmsExposureCampaign): void {\n  if (campaign.repeat === \"always\") return;\n  try {\n    const storage = campaign.repeat === \"session\" ? sessionStorage : localStorage;\n    storage.setItem(storageKey(campaign), String(Date.now()));\n  } catch {\n    // 저장소 차단 환경에서는 현재 화면에서만 닫는다.\n  }\n}\n\nexport function RootTaleExposure({\n  campaign,\n  allowedVariants,\n}: {\n  readonly campaign: CmsExposureCampaign;\n  readonly allowedVariants: readonly string[];\n}) {\n  const [dismissed, setDismissed] = useState(false);\n  const closeRef = useRef<HTMLButtonElement>(null);\n  const knownVariant = allowedVariants.includes(campaign.content.variant);\n  const eligible = useSyncExternalStore(\n    () => () => undefined,\n    () => !wasDismissed(campaign),\n    () => false,\n  );\n  const visible = knownVariant && eligible && !dismissed;\n\n  useEffect(() => {\n    if (!visible || campaign.kind !== \"popup\") return;\n    closeRef.current?.focus();\n    const onKeyDown = (event: KeyboardEvent) => {\n      if (event.key === \"Escape\") dismiss();\n    };\n    window.addEventListener(\"keydown\", onKeyDown);\n    return () => window.removeEventListener(\"keydown\", onKeyDown);\n  });\n\n  function dismiss() {\n    rememberDismissal(campaign);\n    setDismissed(true);\n  }\n\n  if (!knownVariant || !visible) return null;\n  const body = <div className=\"rt-exposure__body\">\n    {campaign.content.assetUrl ? <img className=\"rt-exposure__asset\" src={campaign.content.assetUrl} alt={campaign.content.assetAlt ?? \"\"} /> : null}\n    <div className=\"rt-exposure__copy\">\n      {campaign.content.eyebrow ? <p className=\"rt-exposure__eyebrow\">{campaign.content.eyebrow}</p> : null}\n      <h2 className=\"rt-exposure__title\">{campaign.content.title}</h2>\n      {campaign.content.description ? <p className=\"rt-exposure__description\">{campaign.content.description}</p> : null}\n      {campaign.content.linkUrl && campaign.content.linkLabel ? <a className=\"rt-exposure__link\" href={campaign.content.linkUrl}>{campaign.content.linkLabel}</a> : null}\n    </div>\n    <button ref={closeRef} type=\"button\" className=\"rt-exposure__close\" aria-label=\"닫기\" onClick={dismiss}>×</button>\n  </div>;\n\n  if (campaign.kind === \"banner\") {\n    return <aside className={`rt-exposure rt-exposure--banner rt-exposure--${campaign.content.variant}`} aria-label=\"안내\">{body}</aside>;\n  }\n  return <div className=\"rt-exposure-backdrop\" role=\"presentation\">\n    <section className={`rt-exposure rt-exposure--popup rt-exposure--${campaign.content.variant}`} role=\"dialog\" aria-modal=\"true\" aria-label={campaign.content.title}>\n      {body}\n    </section>\n  </div>;\n}\n"],"mappings":";AAEA,SAAS,WAAW,QAAQ,UAAU,4BAA4B;AAiEjC,cAC7B,YAD6B;AA7DjC,SAAS,WAAW,UAAuC;AACzD,SAAO,yBAAyB,SAAS,EAAE;AAC7C;AAEA,SAAS,aAAa,UAAwC;AAC5D,MAAI,SAAS,WAAW,SAAU,QAAO;AACzC,MAAI;AACF,UAAM,UAAU,SAAS,WAAW,YAAY,iBAAiB;AACjE,UAAM,QAAQ,QAAQ,QAAQ,WAAW,QAAQ,CAAC;AAClD,QAAI,CAAC,MAAO,QAAO;AACnB,QAAI,SAAS,WAAW,MAAO,QAAO,KAAK,IAAI,IAAI,OAAO,KAAK,IAAI;AACnE,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEA,SAAS,kBAAkB,UAAqC;AAC9D,MAAI,SAAS,WAAW,SAAU;AAClC,MAAI;AACF,UAAM,UAAU,SAAS,WAAW,YAAY,iBAAiB;AACjE,YAAQ,QAAQ,WAAW,QAAQ,GAAG,OAAO,KAAK,IAAI,CAAC,CAAC;AAAA,EAC1D,QAAQ;AAAA,EAER;AACF;AAEO,SAAS,iBAAiB;AAAA,EAC/B;AAAA,EACA;AACF,GAGG;AACD,QAAM,CAAC,WAAW,YAAY,IAAI,SAAS,KAAK;AAChD,QAAM,WAAW,OAA0B,IAAI;AAC/C,QAAM,eAAe,gBAAgB,SAAS,SAAS,QAAQ,OAAO;AACtE,QAAM,WAAW;AAAA,IACf,MAAM,MAAM;AAAA,IACZ,MAAM,CAAC,aAAa,QAAQ;AAAA,IAC5B,MAAM;AAAA,EACR;AACA,QAAM,UAAU,gBAAgB,YAAY,CAAC;AAE7C,YAAU,MAAM;AACd,QAAI,CAAC,WAAW,SAAS,SAAS,QAAS;AAC3C,aAAS,SAAS,MAAM;AACxB,UAAM,YAAY,CAAC,UAAyB;AAC1C,UAAI,MAAM,QAAQ,SAAU,SAAQ;AAAA,IACtC;AACA,WAAO,iBAAiB,WAAW,SAAS;AAC5C,WAAO,MAAM,OAAO,oBAAoB,WAAW,SAAS;AAAA,EAC9D,CAAC;AAED,WAAS,UAAU;AACjB,sBAAkB,QAAQ;AAC1B,iBAAa,IAAI;AAAA,EACnB;AAEA,MAAI,CAAC,gBAAgB,CAAC,QAAS,QAAO;AACtC,QAAM,OAAO,qBAAC,SAAI,WAAU,qBACzB;AAAA,aAAS,QAAQ,WAAW,oBAAC,SAAI,WAAU,sBAAqB,KAAK,SAAS,QAAQ,UAAU,KAAK,SAAS,QAAQ,YAAY,IAAI,IAAK;AAAA,IAC5I,qBAAC,SAAI,WAAU,qBACZ;AAAA,eAAS,QAAQ,UAAU,oBAAC,OAAE,WAAU,wBAAwB,mBAAS,QAAQ,SAAQ,IAAO;AAAA,MACjG,oBAAC,QAAG,WAAU,sBAAsB,mBAAS,QAAQ,OAAM;AAAA,MAC1D,SAAS,QAAQ,cAAc,oBAAC,OAAE,WAAU,4BAA4B,mBAAS,QAAQ,aAAY,IAAO;AAAA,MAC5G,SAAS,QAAQ,WAAW,SAAS,QAAQ,YAAY,oBAAC,OAAE,WAAU,qBAAoB,MAAM,SAAS,QAAQ,SAAU,mBAAS,QAAQ,WAAU,IAAO;AAAA,OAChK;AAAA,IACA,oBAAC,YAAO,KAAK,UAAU,MAAK,UAAS,WAAU,sBAAqB,cAAW,gBAAK,SAAS,SAAS,kBAAC;AAAA,KACzG;AAEA,MAAI,SAAS,SAAS,UAAU;AAC9B,WAAO,oBAAC,WAAM,WAAW,gDAAgD,SAAS,QAAQ,OAAO,IAAI,cAAW,gBAAM,gBAAK;AAAA,EAC7H;AACA,SAAO,oBAAC,SAAI,WAAU,wBAAuB,MAAK,gBAChD,8BAAC,aAAQ,WAAW,+CAA+C,SAAS,QAAQ,OAAO,IAAI,MAAK,UAAS,cAAW,QAAO,cAAY,SAAS,QAAQ,OACzJ,gBACH,GACF;AACF;","names":[]}

package/dist/{chunk-U2IM6OCQ.js → chunk-HM5VP7SR.js}

@@ -101,4 +101,4 @@ export {
   resolvePostCollection2 as resolvePostCollection,
   resolvePostUrl2 as resolvePostUrl
 };
-//# sourceMappingURL=chunk-U2IM6OCQ.js.map
+//# sourceMappingURL=chunk-HM5VP7SR.js.map

package/dist/{chunk-U2IM6OCQ.js.map → chunk-HM5VP7SR.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/blog-filter.ts","../src/routes-shared.ts"],"sourcesContent":["/**\n * `RootTaleBlogList` 카테고리 필터 — 순수 헬퍼(서버 필터, client JS 불요).\n *\n * SSR-only 정책 유지: 필터는 `?category=<slug>` URL 파라미터로 동작하고(칩 =\n * 서버 렌더 `<a>` 링크), consumer 가 searchParams 의 category 를 `activeCategory`\n * 로 주입한다. hydration 없이 SEO 친화 + 공유 가능한 URL.\n */\n\nimport type { CmsPostContent, CmsTermRef } from \"@roottale/cms-client/server\";\n\nexport interface BlogCategory {\n  name: string;\n  slug: string;\n}\n\nexport interface BlogCategoryWithCount extends BlogCategory {\n  count: number;\n}\n\nfunction categoryTerms(post: CmsPostContent): CmsTermRef[] {\n  return (post.terms ?? []).filter((t) => t.taxonomy === \"category\");\n}\n\n/**\n * 글 목록에 등장하는 카테고리를 slug 기준 unique 로 수집. 서버가 보내는 정렬\n * (category → name asc)을 보존하기 위해 처음 등장 순서를 유지한다.\n */\nexport function collectCategories(posts: CmsPostContent[]): BlogCategory[] {\n  return collectCategoriesWithCounts(posts).map(({ name, slug }) => ({\n    name,\n    slug,\n  }));\n}\n\nexport function collectCategoriesWithCounts(\n  posts: CmsPostContent[],\n): BlogCategoryWithCount[] {\n  const bySlug = new Map<string, BlogCategoryWithCount>();\n  const out: BlogCategoryWithCount[] = [];\n  for (const post of posts) {\n    for (const t of categoryTerms(post)) {\n      const current = bySlug.get(t.slug);\n      if (current) {\n        current.count += 1;\n      } else {\n        const category = { name: t.name, slug: t.slug, count: 1 };\n        bySlug.set(t.slug, category);\n        out.push(category);\n      }\n    }\n  }\n  return out;\n}\n\n/** activeSlug 가 비면 전체 반환. 아니면 그 카테고리를 가진 글만. */\nexport function filterPostsByCategory(\n  posts: CmsPostContent[],\n  activeSlug: string | null | undefined,\n): CmsPostContent[] {\n  if (!activeSlug) return posts;\n  return posts.filter((p) => categoryTerms(p).some((t) => t.slug === activeSlug));\n}\n\n/** 기본 카테고리 링크: 전체 → `/blog`, 특정 → `/blog/categories/<slug>`. */\nexport function defaultCategoryHref(slug: string | null): string {\n  return slug ? `/blog/categories/${encodeURIComponent(slug)}` : \"/blog\";\n}\n\n// ── Collections (ADR-0060) — cms-core 라우팅 프리미티브 재export + 렌더 헬퍼 ──────\n//\n// 라우팅 코어(RouteCollection/resolvePostCollection/resolvePostUrl/postsForCollection/\n// validateCollections)는 `@roottale/cms-core` 에 있어 next/astro 가 공유한다\n// (ADR-0029 parity — codex consult `019ef577` 반영). 여기서는 next 소비자 편의를\n// 위해 재export + CmsPostContent 기반 스트림 스코프 카테고리 집계만 추가한다.\nimport {\n  type RouteCollection,\n  postsForCollection,\n} from \"@roottale/cms-core\";\n\nexport {\n  type RouteCollection,\n  type RoutablePost,\n  isInCollectionMode,\n  resolvePostCollection,\n  resolvePostUrl,\n  postsForCollection,\n  postsInAnyCollection,\n  validateCollections,\n} from \"@roottale/cms-core\";\n\n/**\n * 특정 collection 안에서 등장하는 카테고리 집계 — 그 스트림의 카테고리 칩/아카이브용.\n * **전체 정렬 리스트로 first-wins 해석**해 그 스트림에 최종 귀속된 글만 대상(한 글이\n * 여러 스트림 리스트에 중복되는 것을 방지 — codex 지적).\n */\nexport function collectCollectionCategories(\n  posts: CmsPostContent[],\n  collections: readonly RouteCollection[],\n  key: string,\n): BlogCategoryWithCount[] {\n  const owned = postsForCollection(posts, collections, key);\n  const collection = collections.find((c) => c.key === key);\n  const allowed = new Set(collection?.categories ?? []);\n  return collectCategoriesWithCounts(owned).filter((c) => allowed.has(c.slug));\n}\n","/**\n * `routes` 공통 — config 타입, collections resolve, fetch 헬퍼. feed/sitemap/llms/\n * revalidate/og 모듈이 공유한다(순환 import 회피). 공개 표면은 `routes.ts` 배럴.\n */\n\nimport { fetchPosts, type CmsPostContent } from \"@roottale/cms-client/server\";\nimport type { RouteCollection } from \"@roottale/cms-core\";\n\nexport type { RouteCollection };\n// 소비자 가드용 재export (`/blog/[slug]` 에서 스트림 누출 차단 등) — ADR-0060.\nexport { resolvePostCollection, resolvePostUrl } from \"@roottale/cms-core\";\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\". 레거시 단일 스트림 — `collections` 미사용 시. */\n  blogBasePath?: string;\n  /**\n   * 다중 스트림 라우팅 (ADR-0060). **길이 > 0 이면 collection 모드** — feed/sitemap/\n   * llms.txt 가 글을 소속 스트림 basePath 로 라우팅하고, 어느 스트림에도 안 속한 글은\n   * 제외한다. 비우거나 미전달 = 레거시 단일 `blogBasePath`(/blog) 동작(하위호환).\n   * 선언 순서 = 우선순위(first-wins).\n   *\n   * 배열 또는 **async resolver**(`() => Promise<RouteCollection[]>`)를 받는다 — 후자는\n   * 사이트가 `@roottale/cms-client` `fetchCollections()` 로 admin 설정을 가져올 때 쓴다.\n   * resolver 가 throw 하면 fail-soft(레거시 단일 /blog).\n   */\n  collections?: CollectionsInput;\n}\n\n/** collections 입력 — 정적 배열 또는 async resolver(admin 설정 fetch 용). */\nexport type CollectionsInput =\n  | RouteCollection[]\n  | (() => RouteCollection[] | Promise<RouteCollection[]>);\n\n/** resolve 결과 — `failed` 로 \"resolver throw\" 를 \"collections 미설정\" 과 구분한다. */\nexport async function resolveCollectionsResult(\n  input: CollectionsInput | undefined,\n): Promise<{ collections: RouteCollection[] | undefined; failed: boolean }> {\n  if (typeof input === \"function\") {\n    try {\n      return { collections: await input(), failed: false };\n    } catch (err) {\n      console.error(\n        \"[@roottale/cms-renderer-next/routes] collections resolver 실패:\",\n        err,\n      );\n      return { collections: undefined, failed: true };\n    }\n  }\n  return { collections: input, failed: false };\n}\n\n/**\n * resolver 면 호출(실패 시 undefined → 레거시), 배열이면 그대로. GET 팩토리(feed/\n * sitemap/llms)는 always-200 철학상 실패를 레거시 /blog 로 흡수 — revalidate 만\n * `resolveCollectionsResult` 로 실패를 구분해 under-invalidation 을 막는다.\n */\nexport async function resolveCollections(\n  input: CollectionsInput | undefined,\n): Promise<RouteCollection[] | undefined> {\n  return (await resolveCollectionsResult(input)).collections;\n}\n\nexport function trimSlash(u: string): string {\n  return u.replace(/\\/+$/, \"\");\n}\n\nexport async 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"],"mappings":";AA0EA;AAAA,EAEE;AAAA,OACK;AAEP;AAAA,EAGE;AAAA,EACA;AAAA,EACA;AAAA,EACA,sBAAAA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AArEP,SAAS,cAAc,MAAoC;AACzD,UAAQ,KAAK,SAAS,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,aAAa,UAAU;AACnE;AAMO,SAAS,kBAAkB,OAAyC;AACzE,SAAO,4BAA4B,KAAK,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,OAAO;AAAA,IACjE;AAAA,IACA;AAAA,EACF,EAAE;AACJ;AAEO,SAAS,4BACd,OACyB;AACzB,QAAM,SAAS,oBAAI,IAAmC;AACtD,QAAM,MAA+B,CAAC;AACtC,aAAW,QAAQ,OAAO;AACxB,eAAW,KAAK,cAAc,IAAI,GAAG;AACnC,YAAM,UAAU,OAAO,IAAI,EAAE,IAAI;AACjC,UAAI,SAAS;AACX,gBAAQ,SAAS;AAAA,MACnB,OAAO;AACL,cAAM,WAAW,EAAE,MAAM,EAAE,MAAM,MAAM,EAAE,MAAM,OAAO,EAAE;AACxD,eAAO,IAAI,EAAE,MAAM,QAAQ;AAC3B,YAAI,KAAK,QAAQ;AAAA,MACnB;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;AAGO,SAAS,sBACd,OACA,YACkB;AAClB,MAAI,CAAC,WAAY,QAAO;AACxB,SAAO,MAAM,OAAO,CAAC,MAAM,cAAc,CAAC,EAAE,KAAK,CAAC,MAAM,EAAE,SAAS,UAAU,CAAC;AAChF;AAGO,SAAS,oBAAoB,MAA6B;AAC/D,SAAO,OAAO,oBAAoB,mBAAmB,IAAI,CAAC,KAAK;AACjE;AA6BO,SAAS,4BACd,OACA,aACA,KACyB;AACzB,QAAM,QAAQ,mBAAmB,OAAO,aAAa,GAAG;AACxD,QAAM,aAAa,YAAY,KAAK,CAAC,MAAM,EAAE,QAAQ,GAAG;AACxD,QAAM,UAAU,IAAI,IAAI,YAAY,cAAc,CAAC,CAAC;AACpD,SAAO,4BAA4B,KAAK,EAAE,OAAO,CAAC,MAAM,QAAQ,IAAI,EAAE,IAAI,CAAC;AAC7E;;;ACnGA,SAAS,kBAAuC;AAKhD,SAAS,yBAAAC,wBAAuB,kBAAAC,uBAAsB;AAmCtD,eAAsB,yBACpB,OAC0E;AAC1E,MAAI,OAAO,UAAU,YAAY;AAC/B,QAAI;AACF,aAAO,EAAE,aAAa,MAAM,MAAM,GAAG,QAAQ,MAAM;AAAA,IACrD,SAAS,KAAK;AACZ,cAAQ;AAAA,QACN;AAAA,QACA;AAAA,MACF;AACA,aAAO,EAAE,aAAa,QAAW,QAAQ,KAAK;AAAA,IAChD;AAAA,EACF;AACA,SAAO,EAAE,aAAa,OAAO,QAAQ,MAAM;AAC7C;AAOA,eAAsB,mBACpB,OACwC;AACxC,UAAQ,MAAM,yBAAyB,KAAK,GAAG;AACjD;AAEO,SAAS,UAAU,GAAmB;AAC3C,SAAO,EAAE,QAAQ,QAAQ,EAAE;AAC7B;AAEA,eAAsB,eACpB,QACA,OAC2B;AAC3B,MAAI;AACF,UAAM,OAAO,MAAM,WAAW;AAAA,MAC5B,QAAQ,OAAO;AAAA,MACf,SAAS,OAAO;AAAA,MAChB,MAAM;AAAA,MACN;AAAA,IACF,CAAC;AACD,WAAO,KAAK;AAAA,EACd,SAAS,KAAK;AAEZ,YAAQ,MAAM,iEAAuD,GAAG;AACxE,WAAO,CAAC;AAAA,EACV;AACF;","names":["postsForCollection","resolvePostCollection","resolvePostUrl"]}
+{"version":3,"sources":["../src/blog-filter.ts","../src/routes-shared.ts"],"sourcesContent":["/**\n * `RootTaleBlogList` 카테고리 필터 — 순수 헬퍼(서버 필터, client JS 불요).\n *\n * SSR-only 정책 유지: 필터는 `?category=<slug>` URL 파라미터로 동작하고(칩 =\n * 서버 렌더 `<a>` 링크), consumer 가 searchParams 의 category 를 `activeCategory`\n * 로 주입한다. hydration 없이 SEO 친화 + 공유 가능한 URL.\n */\n\nimport type { CmsPostContent, CmsTermRef } from \"@roottale/cms-client/server\";\n\nexport interface BlogCategory {\n  name: string;\n  slug: string;\n}\n\nexport interface BlogCategoryWithCount extends BlogCategory {\n  count: number;\n}\n\nfunction categoryTerms(post: CmsPostContent): CmsTermRef[] {\n  return (post.terms ?? []).filter((t) => t.taxonomy === \"category\");\n}\n\n/**\n * 글 목록에 등장하는 카테고리를 slug 기준 unique 로 수집. 서버가 보내는 정렬\n * (category → name asc)을 보존하기 위해 처음 등장 순서를 유지한다.\n */\nexport function collectCategories(posts: CmsPostContent[]): BlogCategory[] {\n  return collectCategoriesWithCounts(posts).map(({ name, slug }) => ({\n    name,\n    slug,\n  }));\n}\n\nexport function collectCategoriesWithCounts(\n  posts: CmsPostContent[],\n): BlogCategoryWithCount[] {\n  const bySlug = new Map<string, BlogCategoryWithCount>();\n  const out: BlogCategoryWithCount[] = [];\n  for (const post of posts) {\n    for (const t of categoryTerms(post)) {\n      const current = bySlug.get(t.slug);\n      if (current) {\n        current.count += 1;\n      } else {\n        const category = { name: t.name, slug: t.slug, count: 1 };\n        bySlug.set(t.slug, category);\n        out.push(category);\n      }\n    }\n  }\n  return out;\n}\n\n/** activeSlug 가 비면 전체 반환. 아니면 그 카테고리를 가진 글만. */\nexport function filterPostsByCategory(\n  posts: CmsPostContent[],\n  activeSlug: string | null | undefined,\n): CmsPostContent[] {\n  if (!activeSlug) return posts;\n  return posts.filter((p) => categoryTerms(p).some((t) => t.slug === activeSlug));\n}\n\n/** 기본 카테고리 링크: 전체 → `/blog`, 특정 → `/blog/categories/<slug>`. */\nexport function defaultCategoryHref(slug: string | null): string {\n  return slug ? `/blog/categories/${encodeURIComponent(slug)}` : \"/blog\";\n}\n\n// ── Collections (ADR-0060) — cms-core 라우팅 프리미티브 재export + 렌더 헬퍼 ──────\n//\n// 라우팅 코어(RouteCollection/resolvePostCollection/resolvePostUrl/postsForCollection/\n// validateCollections)는 `@roottale/cms-core` 에 있어 next/astro 가 공유한다\n// (ADR-0029 parity — codex consult `019ef577` 반영). 여기서는 next 소비자 편의를\n// 위해 재export + CmsPostContent 기반 스트림 스코프 카테고리 집계만 추가한다.\nimport {\n  type RouteCollection,\n  postsForCollection,\n} from \"@roottale/cms-core\";\n\nexport {\n  type RouteCollection,\n  type RoutablePost,\n  isInCollectionMode,\n  resolvePostCollection,\n  resolvePostUrl,\n  postsForCollection,\n  postsInAnyCollection,\n  validateCollections,\n} from \"@roottale/cms-core\";\n\n/**\n * 특정 collection 안에서 등장하는 카테고리 집계 — 그 스트림의 카테고리 칩/아카이브용.\n * **전체 정렬 리스트로 first-wins 해석**해 그 스트림에 최종 귀속된 글만 대상(한 글이\n * 여러 스트림 리스트에 중복되는 것을 방지 — codex 지적).\n */\nexport function collectCollectionCategories(\n  posts: CmsPostContent[],\n  collections: readonly RouteCollection[],\n  key: string,\n): BlogCategoryWithCount[] {\n  const owned = postsForCollection(posts, collections, key);\n  const collection = collections.find((c) => c.key === key);\n  const allowed = new Set(collection?.categories ?? []);\n  return collectCategoriesWithCounts(owned).filter((c) => allowed.has(c.slug));\n}\n","/**\n * `routes` 공통 — config 타입, collections resolve, fetch 헬퍼. feed/sitemap/llms/\n * revalidate/og 모듈이 공유한다(순환 import 회피). 공개 표면은 `routes.ts` 배럴.\n */\n\nimport { fetchPosts, type CmsPostContent } from \"@roottale/cms-client/server\";\nimport type { RouteCollection } from \"@roottale/cms-core\";\n\nexport type { RouteCollection };\n// 소비자 가드용 재export (`/blog/[slug]` 에서 스트림 누출 차단 등) — ADR-0060.\nexport { resolvePostCollection, resolvePostUrl } from \"@roottale/cms-core\";\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  /** RSS의 WebSub discovery link. 미지정이면 기존 RSS 출력 유지. */\n  webSubHubUrl?: string;\n  /** 블로그 base path. 기본 \"/blog\". 레거시 단일 스트림 — `collections` 미사용 시. */\n  blogBasePath?: string;\n  /**\n   * 다중 스트림 라우팅 (ADR-0060). **길이 > 0 이면 collection 모드** — feed/sitemap/\n   * llms.txt 가 글을 소속 스트림 basePath 로 라우팅하고, 어느 스트림에도 안 속한 글은\n   * 제외한다. 비우거나 미전달 = 레거시 단일 `blogBasePath`(/blog) 동작(하위호환).\n   * 선언 순서 = 우선순위(first-wins).\n   *\n   * 배열 또는 **async resolver**(`() => Promise<RouteCollection[]>`)를 받는다 — 후자는\n   * 사이트가 `@roottale/cms-client` `fetchCollections()` 로 admin 설정을 가져올 때 쓴다.\n   * resolver 가 throw 하면 fail-soft(레거시 단일 /blog).\n   */\n  collections?: CollectionsInput;\n}\n\n/** collections 입력 — 정적 배열 또는 async resolver(admin 설정 fetch 용). */\nexport type CollectionsInput =\n  | RouteCollection[]\n  | (() => RouteCollection[] | Promise<RouteCollection[]>);\n\n/** resolve 결과 — `failed` 로 \"resolver throw\" 를 \"collections 미설정\" 과 구분한다. */\nexport async function resolveCollectionsResult(\n  input: CollectionsInput | undefined,\n): Promise<{ collections: RouteCollection[] | undefined; failed: boolean }> {\n  if (typeof input === \"function\") {\n    try {\n      return { collections: await input(), failed: false };\n    } catch (err) {\n      console.error(\n        \"[@roottale/cms-renderer-next/routes] collections resolver 실패:\",\n        err,\n      );\n      return { collections: undefined, failed: true };\n    }\n  }\n  return { collections: input, failed: false };\n}\n\n/**\n * resolver 면 호출(실패 시 undefined → 레거시), 배열이면 그대로. GET 팩토리(feed/\n * sitemap/llms)는 always-200 철학상 실패를 레거시 /blog 로 흡수 — revalidate 만\n * `resolveCollectionsResult` 로 실패를 구분해 under-invalidation 을 막는다.\n */\nexport async function resolveCollections(\n  input: CollectionsInput | undefined,\n): Promise<RouteCollection[] | undefined> {\n  return (await resolveCollectionsResult(input)).collections;\n}\n\nexport function trimSlash(u: string): string {\n  return u.replace(/\\/+$/, \"\");\n}\n\nexport async 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"],"mappings":";AA0EA;AAAA,EAEE;AAAA,OACK;AAEP;AAAA,EAGE;AAAA,EACA;AAAA,EACA;AAAA,EACA,sBAAAA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AArEP,SAAS,cAAc,MAAoC;AACzD,UAAQ,KAAK,SAAS,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,aAAa,UAAU;AACnE;AAMO,SAAS,kBAAkB,OAAyC;AACzE,SAAO,4BAA4B,KAAK,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,OAAO;AAAA,IACjE;AAAA,IACA;AAAA,EACF,EAAE;AACJ;AAEO,SAAS,4BACd,OACyB;AACzB,QAAM,SAAS,oBAAI,IAAmC;AACtD,QAAM,MAA+B,CAAC;AACtC,aAAW,QAAQ,OAAO;AACxB,eAAW,KAAK,cAAc,IAAI,GAAG;AACnC,YAAM,UAAU,OAAO,IAAI,EAAE,IAAI;AACjC,UAAI,SAAS;AACX,gBAAQ,SAAS;AAAA,MACnB,OAAO;AACL,cAAM,WAAW,EAAE,MAAM,EAAE,MAAM,MAAM,EAAE,MAAM,OAAO,EAAE;AACxD,eAAO,IAAI,EAAE,MAAM,QAAQ;AAC3B,YAAI,KAAK,QAAQ;AAAA,MACnB;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;AAGO,SAAS,sBACd,OACA,YACkB;AAClB,MAAI,CAAC,WAAY,QAAO;AACxB,SAAO,MAAM,OAAO,CAAC,MAAM,cAAc,CAAC,EAAE,KAAK,CAAC,MAAM,EAAE,SAAS,UAAU,CAAC;AAChF;AAGO,SAAS,oBAAoB,MAA6B;AAC/D,SAAO,OAAO,oBAAoB,mBAAmB,IAAI,CAAC,KAAK;AACjE;AA6BO,SAAS,4BACd,OACA,aACA,KACyB;AACzB,QAAM,QAAQ,mBAAmB,OAAO,aAAa,GAAG;AACxD,QAAM,aAAa,YAAY,KAAK,CAAC,MAAM,EAAE,QAAQ,GAAG;AACxD,QAAM,UAAU,IAAI,IAAI,YAAY,cAAc,CAAC,CAAC;AACpD,SAAO,4BAA4B,KAAK,EAAE,OAAO,CAAC,MAAM,QAAQ,IAAI,EAAE,IAAI,CAAC;AAC7E;;;ACnGA,SAAS,kBAAuC;AAKhD,SAAS,yBAAAC,wBAAuB,kBAAAC,uBAAsB;AAqCtD,eAAsB,yBACpB,OAC0E;AAC1E,MAAI,OAAO,UAAU,YAAY;AAC/B,QAAI;AACF,aAAO,EAAE,aAAa,MAAM,MAAM,GAAG,QAAQ,MAAM;AAAA,IACrD,SAAS,KAAK;AACZ,cAAQ;AAAA,QACN;AAAA,QACA;AAAA,MACF;AACA,aAAO,EAAE,aAAa,QAAW,QAAQ,KAAK;AAAA,IAChD;AAAA,EACF;AACA,SAAO,EAAE,aAAa,OAAO,QAAQ,MAAM;AAC7C;AAOA,eAAsB,mBACpB,OACwC;AACxC,UAAQ,MAAM,yBAAyB,KAAK,GAAG;AACjD;AAEO,SAAS,UAAU,GAAmB;AAC3C,SAAO,EAAE,QAAQ,QAAQ,EAAE;AAC7B;AAEA,eAAsB,eACpB,QACA,OAC2B;AAC3B,MAAI;AACF,UAAM,OAAO,MAAM,WAAW;AAAA,MAC5B,QAAQ,OAAO;AAAA,MACf,SAAS,OAAO;AAAA,MAChB,MAAM;AAAA,MACN;AAAA,IACF,CAAC;AACD,WAAO,KAAK;AAAA,EACd,SAAS,KAAK;AAEZ,YAAQ,MAAM,iEAAuD,GAAG;AACxE,WAAO,CAAC;AAAA,EACV;AACF;","names":["postsForCollection","resolvePostCollection","resolvePostUrl"]}

package/dist/chunk-KSPPYX22.js

@@ -0,0 +1,14 @@
+// src/section-render-context.ts
+var sectionNodeRenderer = null;
+function setSectionNodeRenderer(renderer) {
+  sectionNodeRenderer = renderer;
+}
+function getSectionNodeRenderer() {
+  return sectionNodeRenderer;
+}
+
+export {
+  setSectionNodeRenderer,
+  getSectionNodeRenderer
+};
+//# sourceMappingURL=chunk-KSPPYX22.js.map

package/dist/chunk-KSPPYX22.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/section-render-context.ts"],"sourcesContent":["/**\n * 섹션 렌더러 주입 지점 — ADR-0040 P2 단방향 계약(코어 ◄ site-sections).\n *\n * 본문(tiptap) 안의 `section` 노드는 비공개 `site-sections` 컴포넌트로 그리지만,\n * 공개 코어가 비공개 패키지를 직접 import 하면 순환·번들\n * 오염이 된다(dependency-cruiser `no-renderer-core-to-templates`). 그래서 코어는\n * \"섹션을 그리는 함수\" 의 자리만 비워두고, private\n * `@roottale/site-sections`를 import 하는 내부 제작 경로에서만 채운다.\n *\n * 등록 없이 `section` 노드를 만나면 dev 경고 후 skip — 미지 섹션 타입을 만났을\n * 때와 같은 fail-soft 동작이다.\n */\nimport type { ReactElement, ReactNode } from \"react\";\nimport type { CmsPostContent } from \"@roottale/cms-client/server\";\n\n/** 발행 API 호출에 필요한 최소 컨텍스트(공개 키 + 베이스 URL). */\nexport type CmsBoundContext = { apiKey: string; baseUrl?: string };\n\nexport type BlogListProps = {\n  apiKey: string;\n  baseUrl?: string;\n  limit?: number;\n  emptyMessage?: string;\n  postHref?: (post: CmsPostContent) => string;\n};\n\nexport type SectionRenderContext = {\n  cms: CmsBoundContext | null;\n  renderBlogList: (props: BlogListProps) => ReactNode;\n  isDev: () => boolean;\n};\n\n/** `section` 노드 하나를 그리는 함수 — templates 쪽 구현이 주입된다. */\nexport type SectionNodeRenderer = (\n  node: { type?: string; attrs?: Record<string, unknown> },\n  key: number,\n  context: SectionRenderContext,\n) => ReactElement | null;\n\nlet sectionNodeRenderer: SectionNodeRenderer | null = null;\n\n/**\n * private 섹션 공장이 로드되며 호출한다. 공개 CMS runtime만 쓰는 고객 FRONT는\n * 이 함수를 호출하지 않으며 `section` 노드를 마케팅 페이지 구조로 사용하지 않는다.\n */\nexport function setSectionNodeRenderer(renderer: SectionNodeRenderer): void {\n  sectionNodeRenderer = renderer;\n}\n\nexport function getSectionNodeRenderer(): SectionNodeRenderer | null {\n  return sectionNodeRenderer;\n}\n"],"mappings":";AAuCA,IAAI,sBAAkD;AAM/C,SAAS,uBAAuB,UAAqC;AAC1E,wBAAsB;AACxB;AAEO,SAAS,yBAAqD;AACnE,SAAO;AACT;","names":[]}

package/dist/cms-public.css

@@ -23,6 +23,21 @@
   list-style: none;
 }
 
+.rt-sr-only { position: absolute; inline-size: 1px; block-size: 1px; padding: 0; margin: -1px; overflow: hidden; clip: rect(0, 0, 0, 0); white-space: nowrap; border: 0; }
+.rt-exposure { color: var(--rt-color-foreground, #111827); background: var(--rt-color-background, #fff); border: 1px solid var(--rt-color-border, #e5e7eb); }
+.rt-exposure__body { position: relative; display: grid; gap: 1rem; padding: 1rem; }
+.rt-exposure__asset { max-inline-size: 100%; block-size: auto; border-radius: .5rem; }
+.rt-exposure__copy { display: grid; gap: .5rem; }
+.rt-exposure__eyebrow, .rt-exposure__title, .rt-exposure__description { margin: 0; }
+.rt-exposure__eyebrow { font-size: .75rem; font-weight: 700; }
+.rt-exposure__title { font-size: 1.25rem; line-height: 1.3; }
+.rt-exposure__link { inline-size: fit-content; font-weight: 700; color: var(--rt-color-primary, #1d4ed8); }
+.rt-exposure__close { position: absolute; inset-block-start: .5rem; inset-inline-end: .5rem; inline-size: 2.75rem; block-size: 2.75rem; border: 0; border-radius: 999px; background: color-mix(in srgb, var(--rt-color-background, #fff) 85%, transparent); color: inherit; cursor: pointer; font-size: 1.5rem; }
+.rt-exposure-backdrop { position: fixed; inset: 0; z-index: 9999; display: grid; place-items: center; padding: 1rem; background: rgb(0 0 0 / .55); }
+.rt-exposure--popup { inline-size: min(100%, 34rem); max-block-size: calc(100dvh - 2rem); overflow: auto; border-radius: 1rem; box-shadow: 0 1.5rem 4rem rgb(0 0 0 / .25); }
+@media (min-width: 40rem) { .rt-exposure--banner .rt-exposure__body { grid-template-columns: minmax(0, 12rem) 1fr; align-items: center; } }
+@media (prefers-reduced-motion: reduce) { .rt-exposure, .rt-exposure-backdrop { scroll-behavior: auto; animation: none !important; transition: none !important; } }
+
 /* Category filter — chips are <a> links (/blog/categories/slug), SSR-only, no JS. */
 [data-roottale-cms] :where(.rt-cms-filter) {
   display: flex;
@@ -370,6 +385,18 @@
   overflow-wrap: anywhere;
 }
 
+/* 외부 게시판 HTML 가져오기. 원문의 안전한 inline style은 유지하되,
+   넓은 표·이미지가 본문 measure 밖으로 페이지를 밀지 않게 경계를 둔다. */
+[data-roottale-cms] :where(.rt-imported-html) {
+  min-inline-size: 0;
+  overflow-x: auto;
+}
+
+[data-roottale-cms] :where(.rt-imported-html img) {
+  max-inline-size: 100%;
+  block-size: auto;
+}
+
 /* 시각 브레드크럼 (avcd 구조, opt-in — RootTaleBlogPost `breadcrumb` prop). */
 [data-roottale-cms] :where(.rt-cms-breadcrumb) {
   max-inline-size: var(--rt-cms-measure, 42.5rem);
@@ -426,6 +453,27 @@
   border-block-end: 1px solid color-mix(in srgb, var(--rt-color-border, #dceef3) 72%, transparent);
 }
 
+[data-roottale-cms] :where(.rt-cms-post-categories) {
+  display: flex;
+  flex-wrap: wrap;
+  gap: var(--rt-spacing-2, 0.5rem);
+  margin-block-end: var(--rt-spacing-3, 0.75rem);
+}
+
+[data-roottale-cms] :where(.rt-cms-post-category) {
+  display: inline-flex;
+  align-items: center;
+  min-block-size: 1.75rem;
+  padding-inline: 0.625rem;
+  border-radius: 999px;
+  background: color-mix(in srgb, var(--rt-color-primary, #06162f) 9%, transparent);
+  color: var(--rt-color-primary, #06162f);
+  font-size: var(--rt-font-size-sm, 0.8125rem);
+  font-weight: var(--rt-font-weight-bold, 700);
+  line-height: 1.2;
+  text-decoration: none;
+}
+
 [data-roottale-cms] :where(.rt-cms-post-header .rt-cms-title) {
   font-size: clamp(1.75rem, 1.35rem + 1.9vw, 2.375rem);
   font-weight: var(--rt-font-weight-bold, 800);
@@ -837,6 +885,23 @@
   font-weight: 600;
 }
 
+/* 공식 출처 — 일반 목록과 구분되는 근거 묶음. */
+[data-roottale-cms] :where(.rt-cms-references) {
+  padding: var(--rt-spacing-5, 1.25rem);
+  border: 1px solid color-mix(in srgb, var(--rt-color-border, #dceef3) 88%, transparent);
+  border-radius: var(--rt-radius-md, 0.5rem);
+  background: color-mix(in srgb, var(--rt-color-muted, #f7f8f7) 34%, transparent);
+}
+
+[data-roottale-cms] :where(.rt-cms-references .rt-cms-references__title) {
+  margin: 0 0 var(--rt-spacing-3, 0.75rem);
+  font-size: var(--rt-font-size-xl, 1.375rem);
+}
+
+[data-roottale-cms] :where(.rt-cms-references > ul) {
+  margin: 0;
+}
+
 /* 글 하단 고정 CTA — 본문 끝 리드 전환 블록. */
 [data-roottale-cms] :where(.rt-cms-post-cta) {
   max-inline-size: var(--rt-cms-measure, 42.5rem);

package/dist/exposure-client.d.ts

@@ -0,0 +1,9 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { CmsExposureCampaign } from '@roottale/cms-client/server';
+
+declare function RootTaleExposure({ campaign, allowedVariants, }: {
+    readonly campaign: CmsExposureCampaign;
+    readonly allowedVariants: readonly string[];
+}): react_jsx_runtime.JSX.Element | null;
+
+export { RootTaleExposure };

package/dist/exposure-client.js

@@ -0,0 +1,8 @@
+"use client";
+import {
+  RootTaleExposure
+} from "./chunk-GVKENK6H.js";
+export {
+  RootTaleExposure
+};
+//# sourceMappingURL=exposure-client.js.map

package/dist/routes.d.ts

@@ -20,6 +20,8 @@ interface RootTaleSiteConfig {
     description?: string;
     /** 기본 "ko-KR". */
     language?: string;
+    /** RSS의 WebSub discovery link. 미지정이면 기존 RSS 출력 유지. */
+    webSubHubUrl?: string;
     /** 블로그 base path. 기본 "/blog". 레거시 단일 스트림 — `collections` 미사용 시. */
     blogBasePath?: string;
     /**
@@ -387,7 +389,7 @@ declare function normalizeRedirectPath(path: string): string;
  * 매칭하지 않는다. 절대 URL 도착지는 체인 종단(다른 origin 위임). 상태 코드는
  * 실제 요청 경로에 매칭된 첫 규칙을 따른다. null = 해당 없음.
  */
-declare function matchRedirect(redirects: readonly RootTaleRedirect[], pathname: string): {
+declare function matchRedirect(redirects: readonly RootTaleRedirect[], pathname: string, origin?: string): {
     toTarget: string;
     statusCode: 301 | 302;
 } | null;
@@ -422,6 +424,8 @@ interface PostSeoOverrides {
     canonical?: string;
     /** OG 이미지 — 비면 글 대표 이미지 사용. */
     ogImage?: string;
+    /** OG 이미지 대체 텍스트 — 비면 글 제목 사용. */
+    ogImageAlt?: string;
     /** 색인 제외. */
     noindex?: boolean;
     /** 링크 추적 제외. */
@@ -523,6 +527,11 @@ interface PostLocaleOptions {
 interface RobotsMeta {
     index: boolean;
     follow: boolean;
+    googleBot?: {
+        index: boolean;
+        follow: boolean;
+        "max-image-preview": "large";
+    };
 }
 /**
  * noindex/nofollow 플래그 → `Metadata.robots`. **글과 아카이브가 공유하는 단

package/dist/routes.js

@@ -7,7 +7,7 @@ import {
   resolvePostUrl,
   safeFetchPosts,
   trimSlash
-} from "./chunk-U2IM6OCQ.js";
+} from "./chunk-HM5VP7SR.js";
 
 // src/routes.ts
 import { CMS_CLIENT_VERSION } from "@roottale/cms-client/server";
@@ -56,7 +56,9 @@ function buildPostMetadata(post, options = {}) {
   if (post.section) openGraph.section = post.section;
   if (post.tags && post.tags.length > 0) openGraph.tags = [...post.tags];
   if (post.authors && post.authors.length > 0) openGraph.authors = [...post.authors];
-  if (ogImage) openGraph.images = [{ url: ogImage, alt: title }];
+  if (ogImage) {
+    openGraph.images = [{ url: ogImage, alt: seo?.ogImageAlt || title }];
+  }
   const meta = { title, openGraph };
   if (description) meta.description = description;
   if (canonical) {
@@ -80,11 +82,21 @@ function buildPostMetadata(post, options = {}) {
       }
     };
   }
-  const robots = resolveRobotsMeta({
+  const baseRobots = resolveRobotsMeta({
     ...seo?.noindex !== void 0 && { noindex: seo.noindex },
     ...seo?.nofollow !== void 0 && { nofollow: seo.nofollow }
   });
-  if (robots) meta.robots = robots;
+  const index = baseRobots?.index ?? true;
+  const follow = baseRobots?.follow ?? true;
+  meta.robots = {
+    index,
+    follow,
+    googleBot: {
+      index,
+      follow,
+      "max-image-preview": "large"
+    }
+  };
   if (post.id) meta.other = { "rt:content-id": post.id };
   const twitter = { card: "summary_large_image", title };
   if (description) twitter.description = description;
@@ -405,6 +417,7 @@ function createFeedRoute(config) {
       feedUrl: `${siteUrl}/feed.xml`,
       description: config.description,
       language: config.language,
+      hubUrl: config.webSubHubUrl,
       items: rssItemsFromPosts(posts, {
         postUrl: (p) => inCollectionMode ? resolvePostUrl3(siteUrl, p, collections) ?? `${siteUrl}${blogBase}/${p.slug}` : `${siteUrl}${blogBase}/${p.slug}`
       })
@@ -778,7 +791,17 @@ function normalizeRedirectPath(path) {
 function isAbsoluteUrl(target) {
   return /^https?:\/\//i.test(target);
 }
-function matchRedirect(redirects, pathname) {
+function internalTargetPath(target, origin) {
+  if (!isAbsoluteUrl(target)) return normalizeRedirectPath(target);
+  if (!origin) return null;
+  try {
+    const url = new URL(target);
+    return url.origin === origin ? normalizeRedirectPath(url.pathname) : null;
+  } catch {
+    return null;
+  }
+}
+function matchRedirect(redirects, pathname, origin) {
   const byFrom = /* @__PURE__ */ new Map();
   for (const r of redirects) {
     const key = normalizeRedirectPath(r.fromPath);
@@ -789,21 +812,18 @@ function matchRedirect(redirects, pathname) {
   let current = start;
   let finalTarget = null;
   let firstStatus = null;
-  for (let hop = 0; hop < 10; hop++) {
+  for (; ; ) {
     const rule = byFrom.get(current);
     if (!rule) break;
-    if (hop === 0) firstStatus = rule.statusCode;
-    if (isAbsoluteUrl(rule.toTarget)) {
+    if (firstStatus === null) firstStatus = rule.statusCode;
+    const nextPath = internalTargetPath(rule.toTarget, origin);
+    if (nextPath === null) {
       finalTarget = rule.toTarget;
       break;
     }
-    const nextPath = normalizeRedirectPath(rule.toTarget);
-    if (nextPath === start) {
-      if (hop === 0) return null;
-      break;
-    }
+    if (nextPath === start) return null;
     finalTarget = rule.toTarget;
-    if (visited.has(nextPath)) break;
+    if (visited.has(nextPath)) return null;
     visited.add(nextPath);
     current = nextPath;
   }
@@ -847,7 +867,7 @@ function createRedirectMiddleware(config) {
     }
     const now = Date.now();
     const redirects = await loadRedirects(now);
-    const hit = matchRedirect(redirects, pathname);
+    const hit = matchRedirect(redirects, pathname, origin);
     if (!hit) return null;
     const dest = new URL(hit.toTarget, origin);
     if (dest.origin === origin && normalizeRedirectPath(dest.pathname) === normalizeRedirectPath(pathname)) {
@@ -875,7 +895,7 @@ function createFleetInfoRoute(config = {}) {
         site: config.site ?? env.VERCEL_PROJECT_PRODUCTION_URL ?? null,
         framework: "next",
         cms_client: CMS_CLIENT_VERSION,
-        cms_renderer: true ? "0.52.0" : "dev",
+        cms_renderer: true ? "0.53.1" : "dev",
         build_sha: env.VERCEL_GIT_COMMIT_SHA?.slice(0, 7) ?? null
       },
       { headers: { "cache-control": "public, max-age=300" } }