@roottale/cms-renderer-next 0.41.1 → 0.42.0

package/dist/cms-public.css

@@ -323,9 +323,13 @@
   order: -1; /* 좁은 화면: 목차를 본문 위로 */
 }
 @container rt-cms-article (min-width: 60rem) {
+  /* 본문 컬럼+사이드바 유닛을 통째로 중앙 정렬 — 본문 컬럼만 measure 로 캡하면
+     유닛 전체가 페이지 왼쪽으로 쏠려 보인다. */
   [data-roottale-cms] :where(.rt-cms-layout--toc-side) {
     grid-template-columns: minmax(0, 1fr) 15rem;
     align-items: start;
+    max-inline-size: calc(var(--rt-cms-measure, 42.5rem) + 15rem + var(--rt-spacing-6, 1.5rem));
+    margin-inline: auto;
   }
   [data-roottale-cms] :where(.rt-cms-layout--toc-side .rt-cms-toc-side) {
     order: 0; /* 넓은 화면: 오른쪽 컬럼 */
@@ -345,8 +349,11 @@
 [data-roottale-cms] :where([data-roottale-cms="body"]) {
   min-inline-size: 0;
   font-family: var(--rt-font-body, system-ui, sans-serif);
-  font-size: var(--rt-font-size-base, 1rem);
-  line-height: 1.7;
+  /* 읽기 표면 전용 스케일 — 네이버 프리미엄콘텐츠 기준 18px 기본, 테마 base 에
+     비례(테마가 base 를 키우면 본문도 같이 커진다). */
+  font-size: var(--rt-cms-body-size, calc(var(--rt-font-size-base, 1rem) * 1.125));
+  line-height: 1.8;
+  letter-spacing: -0.01em; /* 한글 본문 대활자 자간 보정 */
   color: var(--rt-color-foreground, #06162f);
   /* 한글 조판 — 어절 단위 줄바꿈. 긴 URL·토큰만 anywhere 로 넘침 방지.
      에디터(admin globals .tiptap-content)와 1:1 파리티. astro 는 rt-cms-body
@@ -355,54 +362,54 @@
   overflow-wrap: anywhere;
 }
 
+/* 네이버 프리미엄콘텐츠 류 크롬리스 헤더 — 장식 카드 대신 타이포+헤어라인. */
 [data-roottale-cms] :where(.rt-cms-post-header) {
-  position: relative;
-  overflow: hidden;
-  border: 1px solid color-mix(in srgb, var(--rt-color-border, #dceef3) 78%, transparent);
-  border-radius: calc(var(--rt-radius-md, 0.5rem) * 1.5);
-  background:
-    linear-gradient(135deg, rgb(255 255 255 / 0.92), color-mix(in srgb, var(--rt-color-muted, #f7f8f7) 70%, white)),
-    radial-gradient(circle at top right, color-mix(in srgb, var(--rt-color-primary, #06162f) 10%, transparent), transparent 42%);
-  box-shadow: 0 20px 55px rgb(17 24 39 / 0.05);
-  padding: clamp(1.5rem, 3vw, 2.5rem);
-  margin-block-end: var(--rt-spacing-6, 1.5rem);
+  max-inline-size: var(--rt-cms-measure, 42.5rem);
+  margin-inline: auto;
+  margin-block-end: var(--rt-spacing-7, 2rem);
+  padding-block-end: var(--rt-spacing-5, 1.25rem);
+  border-block-end: 1px solid color-mix(in srgb, var(--rt-color-border, #dceef3) 72%, transparent);
 }
 
 [data-roottale-cms] :where(.rt-cms-post-header .rt-cms-title) {
-  font-size: var(--rt-font-size-2xl, 2.75rem);
+  font-size: clamp(1.75rem, 1.35rem + 1.9vw, 2.375rem);
   font-weight: var(--rt-font-weight-bold, 800);
-  line-height: 1.12;
+  line-height: 1.3;
   margin-block-end: var(--rt-spacing-3, 0.75rem);
-  max-inline-size: 15ch;
+  word-break: keep-all;
+  overflow-wrap: anywhere;
+  text-wrap: balance;
 }
 
-[data-roottale-cms] :where(.rt-cms-post-header)::after {
-  content: "";
-  position: absolute;
-  inset-inline-start: 0;
-  inset-block: 0;
-  inline-size: 0.25rem;
-  background: linear-gradient(
-    180deg,
-    color-mix(in srgb, var(--rt-color-primary, #06162f) 72%, white),
-    transparent
-  );
+[data-roottale-cms] :where(.rt-cms-post-header .rt-cms-excerpt) {
+  max-inline-size: none; /* 헤더가 이미 measure 로 캡 */
+  font-size: 1.125rem;
+  line-height: 1.7;
+}
+
+[data-roottale-cms] :where(.rt-cms-post-header .rt-cms-meta) {
+  margin: var(--rt-spacing-4, 1rem) 0 0;
+  font-variant-numeric: tabular-nums;
 }
 
 [data-roottale-cms] :where(.rt-cms-article [data-roottale-cms="body"] > * + *) {
-  margin-block-start: 0.65em;
+  margin-block-start: 0.9em;
 }
 
-/* 읽기 measure — 본문의 모든 최상위 블록(문단·리스트·제목·표·FAQ)을 같은 폭으로
-   줄바꿈. 어드민 에디터(.tiptap-content > *)와 1:1 파리티. */
+/* 읽기 measure — rem 고정값. 72ch 는 각 블록의 font-size 기준으로 해석돼
+   h2 같은 대활자 블록이 문단보다 넓어지는 문제가 있었다(ch 는 해당 요소의
+   0 글자 폭 기준) — 컬럼 폭을 블록마다 다르게 만들지 않으려면 폰트 크기와
+   무관한 고정 단위가 필요. 어드민 에디터(.tiptap-content > *)와 1:1 파리티. */
 [data-roottale-cms] :where(.rt-cms-article [data-roottale-cms="body"] > *) {
-  max-inline-size: 72ch;
+  max-inline-size: var(--rt-cms-measure, 42.5rem);
+  margin-inline: auto;
 }
 
 [data-roottale-cms] :where(.rt-archive-related) {
   display: grid;
   gap: var(--rt-spacing-4, 1rem);
-  max-inline-size: 72ch;
+  max-inline-size: var(--rt-cms-measure, 42.5rem);
+  margin-inline: auto;
   margin-block: var(--rt-spacing-6, 1.5rem) var(--rt-spacing-7, 2rem);
   padding: var(--rt-spacing-4, 1rem);
   border: 1px solid var(--rt-color-border, currentColor);
@@ -470,9 +477,55 @@
   -webkit-line-clamp: 2;
 }
 
-[data-roottale-cms] :where(.rt-cms-article [data-roottale-cms="body"] p) {
+/* W5-2 — 양식(필드 그룹) 스칼라 값 정보 패널 (연관 박스 아래). */
+[data-roottale-cms] :where(.rt-archive-facts) {
+  max-inline-size: var(--rt-cms-measure, 42.5rem);
+  margin-inline: auto;
+  margin-block: var(--rt-spacing-5, 1.25rem) var(--rt-spacing-7, 2rem);
+  padding: var(--rt-spacing-4, 1rem);
+  border: 1px solid var(--rt-color-border, currentColor);
+  border-radius: var(--rt-radius-md, 0.5rem);
+  background: color-mix(in srgb, var(--rt-color-muted, transparent) 40%, transparent);
+}
+
+[data-roottale-cms] :where(.rt-archive-facts__list) {
+  display: grid;
+  gap: var(--rt-spacing-3, 0.75rem);
   margin: 0;
-  line-height: 1.7;
+}
+
+[data-roottale-cms] :where(.rt-archive-facts__row) {
+  display: grid;
+  gap: 0.25rem;
+}
+
+[data-roottale-cms] :where(.rt-archive-facts__label) {
+  color: var(--rt-color-muted-foreground, currentColor);
+  font-family: var(--rt-font-body, system-ui, sans-serif);
+  font-size: var(--rt-font-size-sm, 0.875rem);
+  font-weight: var(--rt-font-weight-semibold, 600);
+  line-height: 1.35;
+}
+
+[data-roottale-cms] :where(.rt-archive-facts__value) {
+  margin: 0;
+  overflow-wrap: anywhere;
+  color: var(--rt-color-foreground, CanvasText);
+  font-size: var(--rt-font-size-base, 1rem);
+  line-height: 1.6;
+  word-break: keep-all;
+}
+
+[data-roottale-cms] :where(.rt-archive-facts__value--multiline) {
+  white-space: pre-line;
+}
+
+/* 주의 — 본문 최상위 블록의 margin 은 단축 속성 금지: inline 축을 0 으로 덮으면
+   컬럼 중앙 정렬(> * 의 margin-inline: auto)이 풀린다. margin-block 만 쓴다. */
+[data-roottale-cms] :where(.rt-cms-article [data-roottale-cms="body"] p) {
+  margin-block: 0;
+  /* line-height 는 .rt-cms-body 의 1.8 을 그대로 상속 */
+  text-wrap: pretty;
 }
 
 [data-roottale-cms] :where(.rt-cms-article [data-roottale-cms="body"] h2),
@@ -482,23 +535,26 @@
   color: var(--rt-color-foreground, #06162f);
   letter-spacing: 0;
   line-height: 1.4;
+  text-wrap: balance;
+  /* 목차 앵커 점프 시 sticky 헤더에 가리지 않게. */
+  scroll-margin-block-start: var(--rt-cms-scroll-offset, 5rem);
 }
 
 [data-roottale-cms] :where(.rt-cms-article [data-roottale-cms="body"] h2) {
-  margin: 1.3em 0 0.45em;
+  margin-block: 1.8em 0.55em;
   font-size: var(--rt-font-size-3xl, 1.875rem);
   font-weight: var(--rt-font-weight-bold, 700);
 }
 
 [data-roottale-cms] :where(.rt-cms-article [data-roottale-cms="body"] h3) {
-  margin: 1.05em 0 0.35em;
+  margin-block: 1.4em 0.4em;
   font-family: var(--rt-font-body, system-ui, sans-serif);
   font-size: var(--rt-font-size-xl, 1.25rem);
   font-weight: var(--rt-font-weight-semibold, 600);
 }
 
 [data-roottale-cms] :where(.rt-cms-article [data-roottale-cms="body"] h4) {
-  margin: 0.9em 0 0.25em;
+  margin-block: 1.15em 0.3em;
   font-family: var(--rt-font-body, system-ui, sans-serif);
   font-size: var(--rt-font-size-lg, 1.125rem);
   font-weight: var(--rt-font-weight-semibold, 600);
@@ -519,7 +575,7 @@
 [data-roottale-cms] :where(.rt-cms-article [data-roottale-cms="body"] ul),
 [data-roottale-cms] :where(.rt-cms-article [data-roottale-cms="body"] ol) {
   padding-inline-start: 1.5em;
-  margin: 0;
+  margin-block: 0;
 }
 
 /* 고객 사이트의 CSS 리셋(Preflight 등)이 list-style 을 지워도 불릿/번호 유지. */
@@ -539,21 +595,34 @@
   list-style: square;
 }
 
+[data-roottale-cms] :where(.rt-cms-article [data-roottale-cms="body"] li) {
+  text-wrap: pretty;
+}
+
 [data-roottale-cms] :where(.rt-cms-article [data-roottale-cms="body"] li > p) {
   margin: 0;
 }
 
 [data-roottale-cms] :where(.rt-cms-article [data-roottale-cms="body"] blockquote) {
-  border-inline-start: 3px solid var(--rt-color-border, #dceef3);
-  padding-inline-start: var(--rt-spacing-3, 0.75rem);
-  color: var(--rt-color-muted-foreground, #6e6e6e);
-  font-style: italic;
+  border-inline-start: 2px solid color-mix(in srgb, var(--rt-color-primary, #06162f) 52%, var(--rt-color-border, #dceef3));
+  padding-inline-start: var(--rt-spacing-4, 1rem);
+  padding-block: 0.125rem;
+  color: color-mix(in srgb, var(--rt-color-foreground, #06162f) 76%, transparent);
+  /* font-style: italic 제거 — 한글 가짜 기울임 방지. */
 }
 
 [data-roottale-cms] :where(.rt-cms-article [data-roottale-cms="body"] a) {
   color: var(--rt-color-primary, #06162f);
   text-decoration: underline;
-  text-underline-offset: 0.15em;
+  text-decoration-thickness: 1px;
+  text-decoration-color: color-mix(in srgb, var(--rt-color-primary, #06162f) 42%, transparent);
+  text-underline-offset: 0.18em;
+  transition: text-decoration-color 140ms ease;
+}
+
+[data-roottale-cms] :where(.rt-cms-article [data-roottale-cms="body"] a:hover),
+[data-roottale-cms] :where(.rt-cms-article [data-roottale-cms="body"] a:focus-visible) {
+  text-decoration-color: var(--rt-color-primary, #06162f);
 }
 
 [data-roottale-cms] :where(.rt-cms-article [data-roottale-cms="body"] mark) {
@@ -601,6 +670,7 @@
 }
 
 [data-roottale-cms] :where(.rt-cms-article [data-roottale-cms="body"] img) {
+  display: block; /* 인라인 하단 갭 제거 */
   max-inline-size: 100%;
   block-size: auto;
   border-radius: var(--rt-radius-md, 0.5rem);
@@ -609,7 +679,12 @@
 [data-roottale-cms] :where(.rt-cms-article [data-roottale-cms="body"] hr) {
   border: 0;
   border-block-start: 1px solid var(--rt-color-border, #dceef3);
-  margin-block: var(--rt-spacing-4, 1rem);
+  margin-block: var(--rt-spacing-7, 2.25rem);
+}
+
+/* 본문 텍스트 선택 색 — 프라이머리 색으로 브랜드 일관성. */
+[data-roottale-cms] :where(.rt-cms-article) ::selection {
+  background: color-mix(in srgb, var(--rt-color-primary, #06162f) 14%, transparent);
 }
 
 /* 표(table) — 좁은 화면에서 가로 스크롤(wrap), 셀 경계선·머리행 강조. */
@@ -638,6 +713,8 @@
 
 /* 글 하단 고정 CTA — 본문 끝 리드 전환 블록. */
 [data-roottale-cms] :where(.rt-cms-post-cta) {
+  max-inline-size: var(--rt-cms-measure, 42.5rem);
+  margin-inline: auto;
   margin-block-start: var(--rt-spacing-6, 1.5rem);
   padding: var(--rt-spacing-5, 1.25rem);
   border: 1px solid color-mix(in srgb, var(--rt-color-border, #dceef3) 82%, transparent);
@@ -681,7 +758,8 @@
   border: 1px solid color-mix(in srgb, var(--rt-color-border, #dceef3) 88%, transparent);
   border-radius: min(var(--rt-radius-md, 0.5rem), 0.75rem);
   overflow: hidden;
-  margin: var(--rt-spacing-6, 1.5rem) 0;
+  /* 본문 최상위 블록 — margin 단축 금지(중앙 정렬 유지), margin-block 만. */
+  margin-block: var(--rt-spacing-6, 1.5rem);
 }
 [data-roottale-cms] :where(.rt-cms-faq-item) {
   border-block-start: 1px solid color-mix(in srgb, var(--rt-color-border, #dceef3) 88%, transparent);
@@ -737,7 +815,9 @@
 
 /* 관련 글 (rt-cms-related) — 글 하단 같은 카테고리 최근 글. */
 [data-roottale-cms] :where(.rt-cms-related) {
-  margin: var(--rt-spacing-8, 2.5rem) 0 var(--rt-spacing-6, 1.5rem);
+  max-inline-size: var(--rt-cms-measure, 42.5rem);
+  margin-inline: auto;
+  margin-block: var(--rt-spacing-8, 2.5rem) var(--rt-spacing-6, 1.5rem);
 }
 [data-roottale-cms] :where(.rt-cms-related-title) {
   font-size: var(--rt-font-size-lg, 1.125rem);
@@ -786,13 +866,14 @@
 [data-roottale-cms] :where(.rt-cms-toc) {
   position: relative;
   /* 본문 measure 와 동일 폭으로 정렬(본문 위 인라인 배치). */
-  max-inline-size: 72ch;
+  max-inline-size: var(--rt-cms-measure, 42.5rem);
+  margin-inline: auto;
   background: color-mix(in srgb, var(--rt-color-muted, #f7f8f7) 34%, white);
   border: 1px solid color-mix(in srgb, var(--rt-color-border, #dceef3) 86%, transparent);
   border-radius: min(var(--rt-radius-md, 0.5rem), 0.5rem);
   box-shadow: inset 0 1px 0 rgb(255 255 255 / 0.76);
   padding: 0.875rem 1rem;
-  margin: 0 0 var(--rt-spacing-6, 1.5rem);
+  margin-block: 0 var(--rt-spacing-6, 1.5rem);
 }
 
 [data-roottale-cms] :where(.rt-cms-toc)::before {
@@ -935,6 +1016,8 @@
   display: flex;
   align-items: center;
   gap: var(--rt-spacing-4, 1rem);
+  max-inline-size: var(--rt-cms-measure, 42.5rem);
+  margin-inline: auto;
   margin-block-start: var(--rt-spacing-8, 3rem);
   border: 1px solid color-mix(in srgb, var(--rt-color-border, #dceef3) 82%, transparent);
   border-radius: calc(var(--rt-radius-md, 0.5rem) * 1.25);
@@ -1001,15 +1084,34 @@
   max-inline-size: 42rem;
 }
 
+/* 사이드바 목차 모드 — 본문 컬럼(그리드 유닛 중앙 정렬)이 왼쪽으로 이동하므로,
+   헤더·하단 요소도 같은 왼쪽 라인에 정렬해야 세로 라인이 맞는다. 각 요소의
+   기본 margin-inline: auto 를 덮어야 해서 소스 순서상 기본 룰들 뒤에 둔다.
+   100cqi = article 컨테이너 폭. */
+@container rt-cms-article (min-width: 60rem) {
+  [data-roottale-cms] :where(.rt-cms-article:has(.rt-cms-layout--toc-side) .rt-cms-post-header),
+  [data-roottale-cms] :where(.rt-cms-article:has(.rt-cms-layout--toc-side) .rt-cms-author-card),
+  [data-roottale-cms] :where(.rt-cms-article:has(.rt-cms-layout--toc-side) .rt-cms-post-cta),
+  [data-roottale-cms] :where(.rt-cms-article:has(.rt-cms-layout--toc-side) .rt-cms-related),
+  [data-roottale-cms] :where(.rt-cms-article:has(.rt-cms-layout--toc-side) .rt-archive-related),
+  [data-roottale-cms] :where(.rt-cms-article:has(.rt-cms-layout--toc-side) .rt-archive-facts) {
+    margin-inline: max(
+        0rem,
+        calc(
+          (100cqi - var(--rt-cms-measure, 42.5rem) - 15rem - var(--rt-spacing-6, 1.5rem)) / 2
+        )
+      )
+      auto;
+  }
+}
+
 @media (max-width: 640px) {
   [data-roottale-cms] :where(.rt-cms-title) {
     font-size: var(--rt-font-size-2xl, 1.5rem);
   }
 
-  [data-roottale-cms] :where(.rt-cms-post-header .rt-cms-title) {
-    font-size: var(--rt-font-size-2xl, 2.125rem);
-    max-inline-size: 100%;
-  }
+  /* .rt-cms-post-header .rt-cms-title 는 clamp() 가 이미 좁은 화면 크기를
+     처리하므로 별도 오버라이드 불필요(제거됨). */
 
   [data-roottale-cms] :where(.rt-cms-toc) {
     padding: 1.125rem;
@@ -1022,6 +1124,12 @@
   [data-roottale-cms] :where(.rt-cms-author-card) {
     align-items: flex-start;
   }
+
+  /* 모바일 본문 — 데스크톱보다 살짝 낮춘 스케일(1.0625 = 17px 기준). */
+  [data-roottale-cms] :where(.rt-cms-body),
+  [data-roottale-cms] :where([data-roottale-cms="body"]) {
+    font-size: var(--rt-cms-body-size, calc(var(--rt-font-size-base, 1rem) * 1.0625));
+  }
 }
 
 /* RootTaleFloatingCta */
@@ -1135,6 +1243,11 @@
   outline-offset: 2px;
 }
 
+[data-roottale-cms="lead-form"] :where(.rt-cms-field-textarea) {
+  min-block-size: 6rem;
+  resize: vertical;
+}
+
 [data-roottale-cms="lead-form"] :where(.rt-cms-field-hint) {
   font-size: var(--rt-font-size-xs, 0.75rem);
   color: var(--rt-color-muted-foreground, #6e6e6e);

package/dist/concerns-client.d.ts

@@ -0,0 +1,12 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { C as ConcernsSection } from './site-config-DgYGGwu1.js';
+import 'zod';
+
+type ConcernRegion = ConcernsSection["props"]["regions"][number];
+declare function ConcernsFigureMap({ figureImage, figureAlt, regions, }: {
+    readonly figureImage: string;
+    readonly figureAlt: string;
+    readonly regions: readonly ConcernRegion[];
+}): react_jsx_runtime.JSX.Element | null;
+
+export { ConcernsFigureMap };

package/dist/concerns-client.js

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

package/dist/concerns-client.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/expertise-client.d.ts

@@ -0,0 +1,10 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { E as ExpertiseSection } from './site-config-DgYGGwu1.js';
+import 'zod';
+
+type ExpertiseItem = ExpertiseSection["props"]["items"][number];
+declare function ExpertiseTabStage({ items, }: {
+    readonly items: readonly ExpertiseItem[];
+}): react_jsx_runtime.JSX.Element | null;
+
+export { ExpertiseTabStage };

package/dist/expertise-client.js

@@ -0,0 +1,8 @@
+"use client";
+import {
+  ExpertiseTabStage
+} from "./chunk-4LQPZDXZ.js";
+export {
+  ExpertiseTabStage
+};
+//# sourceMappingURL=expertise-client.js.map

package/dist/expertise-client.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/hero-carousel-client.d.ts

@@ -0,0 +1,36 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+interface HeroCarouselSlideInput {
+    readonly image: string;
+    readonly alt: string;
+    readonly caption?: string;
+    readonly eyebrow?: string;
+    readonly title?: string;
+    readonly subtitle?: string;
+    readonly description?: string;
+    readonly primaryCta?: {
+        readonly label: string;
+        readonly href: string;
+    };
+    readonly secondaryCta?: {
+        readonly label: string;
+        readonly href: string;
+    };
+    readonly tabLabel?: string;
+    readonly tabMeta?: string;
+    readonly metrics?: readonly {
+        readonly value: string;
+        readonly unit?: string;
+        readonly label: string;
+        readonly source?: string;
+    }[];
+}
+interface HeroCarouselViewportProps {
+    readonly slides: readonly HeroCarouselSlideInput[];
+    readonly autoplay: boolean;
+    readonly intervalMs: number;
+    readonly scrim?: "none" | "soft" | "strong";
+}
+declare function HeroCarouselViewport({ slides, autoplay, intervalMs, scrim, }: HeroCarouselViewportProps): react_jsx_runtime.JSX.Element;
+
+export { type HeroCarouselSlideInput, HeroCarouselViewport, type HeroCarouselViewportProps };

package/dist/hero-carousel-client.js

@@ -0,0 +1,8 @@
+"use client";
+import {
+  HeroCarouselViewport
+} from "./chunk-F3G6RVIR.js";
+export {
+  HeroCarouselViewport
+};
+//# sourceMappingURL=hero-carousel-client.js.map

package/dist/hero-carousel-client.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/routes.d.ts

@@ -1,4 +1,4 @@
-import { CmsPostContent, RootTaleRedirect } from '@roottale/cms-client/server';
+import { CmsPostContent, RootTaleRedirect, CmsPostTranslationRef } from '@roottale/cms-client/server';
 import { RouteCollection } from '@roottale/cms-core';
 export { RouteCollection, resolvePostCollection, resolvePostUrl } from '@roottale/cms-core';
 
@@ -244,15 +244,19 @@ interface OgImageRouteConfig extends RootTaleSiteConfig {
     /** 하단 브랜드 라벨. 기본 = `title`. */
     brandLabel?: string;
 }
-/** `next/og` 의 ImageResponse 와 구조 호환(직접 의존 회피 — revalidate 콜백 주입과 동일 원칙). */
+/**
+ * `next/og` 의 ImageResponse 와 구조 호환(직접 의존 회피 — revalidate 콜백 주입과
+ * 동일 원칙). 생성자 파라미터는 반변이라 `unknown` 으로 두면 ReactElement 를
+ * 요구하는 실제 ImageResponse 가 대입 불가(고객 연동 TS 에러) — `any` 필요.
+ */
 interface ImageResponseLike {
-    new (element: unknown, options?: {
+    new (element: any, options?: {
         width?: number;
         height?: number;
         fonts?: {
             name: string;
             data: ArrayBuffer;
-            weight?: number;
+            weight?: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
             style?: "normal";
         }[];
     }): Response;
@@ -416,6 +420,12 @@ interface PostMetadataInput {
      * 공지/블로그로 구분해 해석한다(`collectionKey:"notice"` → `/notice`).
      */
     collectionKey?: string | null;
+    /**
+     * ADR-0052 A안 (W4-6 PR C1) — 이 글의 발행된 언어판 목록(자기 자신 포함, PR B
+     * 응답 `CmsPostContent.translations`). `options.locales` 와 함께 주면 hreflang
+     * `alternates.languages` 를 계산한다. 없거나 자기 자신 1건뿐이면 languages 생략.
+     */
+    translations?: readonly CmsPostTranslationRef[];
 }
 interface BuildPostMetadataOptions {
     /**
@@ -436,6 +446,26 @@ interface BuildPostMetadataOptions {
      * 안 속하면(미설정·미존재 key) canonical 을 생략한다. `post.slug` 필요.
      */
     collections?: readonly RouteCollection[];
+    /**
+     * ADR-0052 A안 (W4-6 PR C1) — hreflang alternates.languages 계산 옵션. 주지
+     * 않으면(undefined) `translations` 가 있어도 languages 를 계산하지 않는다
+     * (opt-in — 명시 안 한 기존 소비자는 canonical-only 로 diff 0).
+     */
+    locales?: PostLocaleOptions;
+}
+/**
+ * ADR-0052 A안 (W4-6 PR C1) — hreflang 경로 계산 옵션. `buildPostMetadata` 와
+ * `buildHreflangLanguages` 가 공유한다.
+ */
+interface PostLocaleOptions {
+    /** 사이트 기본 locale — prefix 없는 경로, `x-default` 겸함. */
+    defaultLocale: string;
+    /**
+     * locale + slug → path(선행 슬래시 포함). 기본값: 기본 locale 은 `/blog/{slug}`,
+     * 그 외는 `/{locale}/blog/{slug}` (starter 참조 구현 관용구, `tenant-site-i18n-plan.md`
+     * §2③). 블로그가 아닌 라우트(CMS `[slug]` 페이지 등)는 override 필수.
+     */
+    pathFor?: (locale: string, slug: string) => string;
 }
 /** Next `Metadata` 의 구조적 부분집합 — 소비자는 그대로 return 가능. */
 interface PostMetadata {
@@ -443,6 +473,7 @@ interface PostMetadata {
     description?: string;
     alternates?: {
         canonical: string;
+        languages?: Record<string, string>;
     };
     robots?: {
         index: boolean;
@@ -488,6 +519,21 @@ interface PostMetadata {
  * ```
  */
 declare function buildPostMetadata(post: PostMetadataInput, options?: BuildPostMetadataOptions): PostMetadata;
+/**
+ * ADR-0052 A안 (W4-6 PR C1) — 글의 `translations[]`(PR B 응답, 자기 자신 포함)를
+ * hreflang `alternates.languages` 로 변환. **양방향 + `x-default` = 기본 locale**
+ * (Google 요건 — 기본판도 자기 자신을 가리키는 entry 를 갖는다).
+ *
+ * `buildPostMetadata` 가 내부적으로 쓰지만, OG `type:"article"` 이 부적절한
+ * 라우트(CMS `[slug]` 페이지 등)는 이 함수를 직접 호출해 plain `Metadata.alternates`
+ * 를 조립한다.
+ *
+ * 번역이 없거나(자기 자신 1건뿐) 기본 locale 판 URL 을 못 만들면(예: `translations`
+ * 에 기본 locale 항목 자체가 없음 — 데이터 이상) undefined 를 반환해 languages
+ * 방출을 생략한다(부분 hreflang 은 검색엔진이 무시하거나 오해할 수 있어 전부 생략이
+ * 더 안전 — fail-closed).
+ */
+declare function buildHreflangLanguages(translations: readonly CmsPostTranslationRef[] | undefined, siteUrl: string, locales: PostLocaleOptions): Record<string, string> | undefined;
 
 /**
  * `@roottale/cms-renderer-next/routes` — Next.js App Router 통합 라우트 팩토리.
@@ -548,4 +594,4 @@ interface FleetInfoRouteConfig {
  */
 declare function createFleetInfoRoute(config?: FleetInfoRouteConfig): () => Promise<Response>;
 
-export { type BuildPostMetadataOptions, type CollectionsInput, type FleetInfoRouteConfig, type ImageResponseLike, type LlmsTxtLink, type LlmsTxtRouteConfig, type LlmsTxtSection, OG_IMAGE_CONTENT_TYPE, OG_IMAGE_SIZE, type OgImageRouteConfig, type PostMetadata, type PostMetadataInput, type PostSeoOverrides, type RedirectMiddlewareConfig, type RevalidateRouteConfig, type RootTaleSiteConfig, type SitemapEntry, type SitemapIndexOptions, type SitemapSectionId, buildPostMetadata, createFeedRoute, createFleetInfoRoute, createLlmsTxtRoute, createPostOgImage, createRedirectMiddleware, createRevalidateRoute, createSitemap, createSitemapIndex, matchRedirect, normalizeRedirectPath, postRedirectPath, resolveCollections, resolveCollectionsResult, safeFetchPosts, trimSlash };
+export { type BuildPostMetadataOptions, type CollectionsInput, type FleetInfoRouteConfig, type ImageResponseLike, type LlmsTxtLink, type LlmsTxtRouteConfig, type LlmsTxtSection, OG_IMAGE_CONTENT_TYPE, OG_IMAGE_SIZE, type OgImageRouteConfig, type PostLocaleOptions, type PostMetadata, type PostMetadataInput, type PostSeoOverrides, type RedirectMiddlewareConfig, type RevalidateRouteConfig, type RootTaleSiteConfig, type SitemapEntry, type SitemapIndexOptions, type SitemapSectionId, buildHreflangLanguages, buildPostMetadata, createFeedRoute, createFleetInfoRoute, createLlmsTxtRoute, createPostOgImage, createRedirectMiddleware, createRevalidateRoute, createSitemap, createSitemapIndex, matchRedirect, normalizeRedirectPath, postRedirectPath, resolveCollections, resolveCollectionsResult, safeFetchPosts, trimSlash };