@roottale/cms-renderer-next 0.46.0 → 0.48.0

package/CHANGELOG.md

@@ -1,5 +1,53 @@
 # @roottale/cms-renderer-next
 
+## 0.48.0
+
+### Minor Changes
+
+- a4c7070: avcd 구조 — `RootTaleBlogPost`에 opt-in `breadcrumb` prop(시각 브레드크럼 +
+  `BreadcrumbList` JSON-LD) 추가, `author_slug` 있으면 작성자 이름을
+  `/blog/author/{slug}`로 자동 링크(`authorHref`로 override 가능). 헤더 발행일
+  마크업이 `<span>`에서 `dateTime` 속성을 가진 `<time>`으로 변경(class·
+  data-rt-cms-meta 속성은 유지). `buildPostMetadata`에 Twitter Card 자동 emit,
+  RSS alternate(`feedPath`, 기본 `/feed.xml`), og article 확장(`modified`·
+  `section`·`tags`·`authors`) 추가.
+
+  ⚠️ 카테고리 칩·`RootTaleBlogCategories`·브레드크럼 카테고리 링크가 모두
+  `/blog/categories/{slug}`를 기본 링크한다 — 단일 블로그 사이트도 이 라우트를
+  구현해야 404가 나지 않는다(참조 구현: `@roottale/cms-mcp` 예시
+  `app/blog/categories/[slug]/page.tsx`).
+
+- ab5241a: 읽기 표면 조판 개선 — 네이버 프리미엄 콘텐츠·avcd 기준: 문단 간격 확대(1.35em), h2 섹션 대여백, h3/h4 크기 위계 수정, 리스트 간격·액센트 마커, 인용구 라운드 카드화, 이미지 여백·캡션 스타일, 표 라운드 외곽+수평 구분선, hr 여백 확대
+
+### Patch Changes
+
+- Updated dependencies [a4c7070]
+  - @roottale/cms-client@0.48.0
+
+## 0.47.0
+
+### Minor Changes
+
+- bfe0d14: 측정 계측 체계 v2(ADR-0038/ADR-0048 amend) 서버 수용 배선 — 유입 어트리뷰션에
+  utm_term/utm_content/광고 클릭 플래그/문의 직전 유입(last-touch) 필드를
+  추가하고, 방문 여정(journey) JSON을 문의 제출에 함께 전달할 수 있게 했습니다.
+  - `@roottale/cms-client`: `InquiryAttribution`에 `utm_term`·`utm_content`·
+    `ad_click`·`last_touch_*` 필드 추가, `readAttribution()`/
+    `parseAttributionJson()`가 새 필드를 읽습니다. `SubmitInquiryFields`에
+    `journey?: string`를 추가해 방문 여정 원문을 `attr_journey` 폼 필드로 함께
+    전송합니다.
+  - `@roottale/analytics-runtime`: 이벤트 사전(`TRACK_EVENTS`)에 `wireDims`
+    필드를 추가해 `/collect` 비콘 payload의 실제 키 이름을 명시했습니다. 브라우저
+    코드 없이 순수 이벤트 사전만 담은 `./events` 서브패스를 신설했습니다(서버
+    런타임에서 안전하게 import).
+  - `@roottale/cms-renderer-next`: 위 cms-client 타입 변경에 따른 patch(연동
+    linked 그룹).
+
+### Patch Changes
+
+- Updated dependencies [bfe0d14]
+  - @roottale/cms-client@0.47.0
+
 ## 0.46.0
 
 ### Minor Changes

package/dist/{chunk-JXRHZGRJ.js → chunk-LIBSVC4M.js}

@@ -23,13 +23,17 @@ import {
   StaggerGroup,
   StaggerItem
 } from "./chunk-ZL2NA3QT.js";
+import {
+  LeadFormMeta
+} from "./chunk-VG6UUF4D.js";
 import {
   collectCategories,
   collectCategoriesWithCounts,
   collectCollectionCategories,
   defaultCategoryHref,
-  filterPostsByCategory
-} from "./chunk-FUA5H6JE.js";
+  filterPostsByCategory,
+  trimSlash
+} from "./chunk-U2IM6OCQ.js";
 import {
   SectionSchema
 } from "./chunk-UM37DOIK.js";
@@ -40,6 +44,7 @@ import {
 // src/server.tsx
 import {
   DEFAULT_BLOG_SETTINGS,
+  breadcrumbSchema,
   fetchBlogSettings,
   fetchPost,
   fetchPosts,
@@ -126,6 +131,7 @@ function RootTaleLeadForm(props) {
       "data-roottale-cms": "lead-form",
       className: formClass,
       children: [
+        /* @__PURE__ */ jsx(LeadFormMeta, { formId: "contact" }),
         heading ? /* @__PURE__ */ jsx("h2", { className: "rt-cms-lead-heading", children: heading }) : null,
         description ? /* @__PURE__ */ jsx("p", { className: "rt-cms-lead-description", children: description }) : null,
         redirectUrl ? /* @__PURE__ */ jsx("input", { type: "hidden", name: "_redirect_url", value: redirectUrl }) : null,
@@ -270,7 +276,7 @@ function RootTaleLeadForm(props) {
             /* @__PURE__ */ jsx("strong", { children: "(\uD544\uC218)" }),
             " \uAC1C\uC778\uC815\uBCF4 \uC218\uC9D1\xB7\uC774\uC6A9\uC5D0 \uB3D9\uC758\uD569\uB2C8\uB2E4. (\uC218\uC9D1 \uD56D\uBAA9:",
             " ",
-            isMedical ? "\uC774\uB984\xB7\uC5F0\uB77D\uCC98\xB7\uC774\uBA54\uC77C\xB7\uC0C1\uB2F4 \uB0B4\uC6A9(\uC791\uC131 \uC2DC)" : "\uC774\uB984\xB7\uC5F0\uB77D\uCC98\xB7\uC774\uBA54\uC77C\xB7\uC0AC\uC5C5\uCCB4\uBA85",
+            isMedical ? "\uC774\uB984\xB7\uC5F0\uB77D\uCC98\xB7\uC774\uBA54\uC77C\xB7\uC0C1\uB2F4 \uB0B4\uC6A9(\uC791\uC131 \uC2DC)\xB7\uC0AC\uC774\uD2B8 \uC774\uC6A9 \uAE30\uB85D(\uBC29\uBB38 \uD398\uC774\uC9C0\xB7\uC0C1\uD638\uC791\uC6A9)" : "\uC774\uB984\xB7\uC5F0\uB77D\uCC98\xB7\uC774\uBA54\uC77C\xB7\uC0AC\uC5C5\uCCB4\uBA85\xB7\uC0AC\uC774\uD2B8 \uC774\uC6A9 \uAE30\uB85D(\uBC29\uBB38 \uD398\uC774\uC9C0\xB7\uC0C1\uD638\uC791\uC6A9)",
             ". \uBCF4\uAD00 \uAE30\uAC04: \uBB38\uC758 \uC885\uB8CC \uD6C4 3\uB144)"
           ] })
         ] }),
@@ -364,6 +370,11 @@ function CtaLink({
 function ctaTrackForHref(href) {
   return href.startsWith("tel:") ? "cta_banner" : "cta_hero";
 }
+function contactHrefTrack(href) {
+  if (href.startsWith("tel:")) return "phone_click";
+  if (href.startsWith("mailto:")) return "email_click";
+  return void 0;
+}
 function TemplateHeroProof({
   proofMetrics
 }) {
@@ -813,8 +824,24 @@ function FooterContact({
   }
   return /* @__PURE__ */ jsxs2("address", { className: "rt-tpl-footer-contact", children: [
     contactInfo.address ? /* @__PURE__ */ jsx2("span", { children: contactInfo.address }) : null,
-    contactInfo.phone ? /* @__PURE__ */ jsx2("a", { href: telHref(contactInfo.phone), children: contactInfo.phone }) : null,
-    contactInfo.email ? /* @__PURE__ */ jsx2("a", { href: `mailto:${contactInfo.email}`, children: contactInfo.email }) : null
+    contactInfo.phone ? /* @__PURE__ */ jsx2(
+      "a",
+      {
+        href: telHref(contactInfo.phone),
+        "data-track": "phone_click",
+        "data-track-placement": "footer",
+        children: contactInfo.phone
+      }
+    ) : null,
+    contactInfo.email ? /* @__PURE__ */ jsx2(
+      "a",
+      {
+        href: `mailto:${contactInfo.email}`,
+        "data-track": "email_click",
+        "data-track-placement": "footer",
+        children: contactInfo.email
+      }
+    ) : null
   ] });
 }
 function FooterLegal(section) {
@@ -1631,7 +1658,18 @@ function ContactActions({
   actions
 }) {
   if (!actions || actions.length === 0) return null;
-  return /* @__PURE__ */ jsx2("ul", { className: "rt-tpl-contact-actions", children: actions.map((action) => /* @__PURE__ */ jsx2("li", { "data-kind": action.kind, children: /* @__PURE__ */ jsx2("a", { href: action.href, children: action.label }) }, `${action.label}-${action.href}`)) });
+  return /* @__PURE__ */ jsx2("ul", { className: "rt-tpl-contact-actions", children: actions.map((action) => {
+    const track = contactHrefTrack(action.href);
+    return /* @__PURE__ */ jsx2("li", { "data-kind": action.kind, children: /* @__PURE__ */ jsx2(
+      "a",
+      {
+        href: action.href,
+        "data-track": track,
+        "data-track-placement": track ? "contact_actions" : void 0,
+        children: action.label
+      }
+    ) }, `${action.label}-${action.href}`);
+  }) });
 }
 function TemplateContactChannelCards(section) {
   const { heading, channels, map, mapEmbedUrl, actions } = section.props;
@@ -1673,7 +1711,8 @@ function TemplateContactChannelCards(section) {
                   {
                     className: "rt-tpl-contact-channel-card",
                     href: channel.href,
-                    "data-track": channel.href.startsWith("tel:") ? "cta_call" : "cta_banner",
+                    "data-track": channel.href.startsWith("tel:") ? "cta_call" : channel.href.startsWith("mailto:") ? "email_click" : "cta_banner",
+                    "data-track-placement": channel.href.startsWith("mailto:") ? "contact_channels" : void 0,
                     children: content
                   }
                 ) : /* @__PURE__ */ jsx2("div", { className: "rt-tpl-contact-channel-card", children: content })
@@ -1731,7 +1770,16 @@ function TemplateContactVisitBand(section) {
             /* @__PURE__ */ jsx2("h3", { className: "rt-tpl-contact-visit-title", children: "\uC624\uC2DC\uB294 \uAE38" }),
             /* @__PURE__ */ jsx2(ContactMapBlock, { map, mapEmbedUrl }),
             address ? /* @__PURE__ */ jsx2("address", { className: "rt-tpl-contact-visit-address", children: address }) : null,
-            mapAction ? /* @__PURE__ */ jsx2("a", { className: "rt-tpl-contact-visit-link", href: mapAction.href, children: mapAction.label }) : null
+            mapAction ? /* @__PURE__ */ jsx2(
+              "a",
+              {
+                className: "rt-tpl-contact-visit-link",
+                href: mapAction.href,
+                "data-track": contactHrefTrack(mapAction.href),
+                "data-track-placement": contactHrefTrack(mapAction.href) ? "visit" : void 0,
+                children: mapAction.label
+              }
+            ) : null
           ] }),
           /* @__PURE__ */ jsxs2("section", { className: "rt-tpl-contact-visit-panel", "aria-label": "\uC804\uD654", children: [
             /* @__PURE__ */ jsx2("h3", { className: "rt-tpl-contact-visit-title", children: "\uC804\uD654" }),
@@ -1745,7 +1793,16 @@ function TemplateContactVisitBand(section) {
               }
             ) : null,
             hours ? /* @__PURE__ */ jsx2(ContactHoursSummary, { hours: hours.slice(0, 2) }) : null,
-            ctaAction ? /* @__PURE__ */ jsx2("a", { className: "rt-tpl-btn rt-tpl-btn--primary", href: ctaAction.href, children: ctaAction.label }) : null
+            ctaAction ? /* @__PURE__ */ jsx2(
+              "a",
+              {
+                className: "rt-tpl-btn rt-tpl-btn--primary",
+                href: ctaAction.href,
+                "data-track": contactHrefTrack(ctaAction.href),
+                "data-track-placement": contactHrefTrack(ctaAction.href) ? "visit" : void 0,
+                children: ctaAction.label
+              }
+            ) : null
           ] })
         ] })
       ] })
@@ -2911,7 +2968,9 @@ async function RootTaleBlogPost(props) {
     relatedPostsTitle = t(locale, "relatedPostsTitle"),
     collections,
     showFieldFacts = false,
-    theme: themeProp
+    theme: themeProp,
+    authorHref = defaultAuthorHref,
+    breadcrumb
   } = props;
   const [post, themeStyle, blogSettings] = await Promise.all([
     fetchPost({ apiKey, slugOrId, baseUrl, ...locale ? { locale } : {} }),
@@ -2948,6 +3007,7 @@ async function RootTaleBlogPost(props) {
   const authorName = post.authorName;
   const authorImageUrl = post.authorImageUrl;
   const postAuthorBio = post.authorBio;
+  const authorSlug = post.authorSlug;
   const views = typeof post.viewCount === "number" ? post.viewCount : null;
   const publishedDate = display.showDate ? formatPublishedDate2(post.publishedAt) : "";
   const showTopAuthor = display.showAuthor && Boolean(authorName);
@@ -2967,14 +3027,24 @@ async function RootTaleBlogPost(props) {
       className: "rt-cms-article",
       style: themeStyle ?? void 0,
       children: [
+        renderBreadcrumb(post, collections, relatedHref, breadcrumb),
         /* @__PURE__ */ jsxs9("header", { className: "rt-cms-post-header", children: [
           showTitle ? /* @__PURE__ */ jsx9("h1", { className: "rt-cms-title", children: post.title }) : null,
           post.excerpt ? /* @__PURE__ */ jsx9("p", { className: "rt-cms-excerpt", children: post.excerpt }) : null,
           publishedDate || showTopAuthor || views !== null ? /* @__PURE__ */ jsxs9("p", { className: "rt-cms-meta", children: [
-            publishedDate ? /* @__PURE__ */ jsx9("span", { className: "rt-cms-meta-item", "data-rt-cms-meta": "date", children: publishedDate }) : null,
+            publishedDate ? /* @__PURE__ */ jsx9(
+              "time",
+              {
+                dateTime: post.publishedAt ?? void 0,
+                className: "rt-cms-meta-item",
+                "data-rt-cms-meta": "date",
+                children: publishedDate
+              }
+            ) : null,
             showTopAuthor ? /* @__PURE__ */ jsxs9("span", { className: "rt-cms-meta-item", "data-rt-cms-meta": "author", children: [
-              "\uC791\uC131\uC790 ",
-              authorName
+              "\uC791\uC131\uC790",
+              " ",
+              authorSlug ? /* @__PURE__ */ jsx9("a", { className: "rt-cms-author-link", href: authorHref(authorSlug), children: authorName }) : authorName
             ] }) : null,
             views !== null ? /* @__PURE__ */ jsxs9("span", { className: "rt-cms-meta-item", "data-rt-cms-meta": "views", children: [
               "\uC870\uD68C ",
@@ -3019,7 +3089,7 @@ async function RootTaleBlogPost(props) {
           ) : /* @__PURE__ */ jsx9("div", { className: "rt-cms-author-card__avatar", "aria-hidden": "true", children: authorInitials(displayAuthorName) }),
           /* @__PURE__ */ jsxs9("div", { className: "rt-cms-author-card__body", children: [
             /* @__PURE__ */ jsx9("p", { className: "rt-cms-author-card__eyebrow", children: display.authorCardEyebrow }),
-            /* @__PURE__ */ jsx9("p", { className: "rt-cms-author-card__name", children: displayAuthorName }),
+            /* @__PURE__ */ jsx9("p", { className: "rt-cms-author-card__name", children: authorSlug ? /* @__PURE__ */ jsx9("a", { className: "rt-cms-author-link", href: authorHref(authorSlug), children: displayAuthorName }) : displayAuthorName }),
             authorBio ? /* @__PURE__ */ jsx9("p", { className: "rt-cms-author-card__description", children: authorBio }) : null
           ] })
         ] }) : null,
@@ -3030,6 +3100,46 @@ async function RootTaleBlogPost(props) {
     }
   );
 }
+function renderBreadcrumb(post, collections, postHref, options) {
+  if (!options) return null;
+  const {
+    siteUrl,
+    homeLabel = "\uD648",
+    homeHref = "/",
+    listLabel = "\uBE14\uB85C\uADF8",
+    showCategory = true,
+    categoryHref = defaultCategoryHref
+  } = options;
+  const listHref = options.listHref ?? (collections ? resolvePostCollection(post, collections)?.basePath || "/blog" : "/blog");
+  const categoryTerm = showCategory ? post.terms.find((t2) => t2.taxonomy === "category") : void 0;
+  const crumbs = [
+    { label: homeLabel, href: homeHref },
+    { label: listLabel, href: listHref }
+  ];
+  if (categoryTerm) {
+    crumbs.push({ label: categoryTerm.name, href: categoryHref(categoryTerm.slug) });
+  }
+  crumbs.push({ label: post.title, href: postHref(post) });
+  const jsonLd = siteUrl ? breadcrumbSchema(
+    crumbs.map((c) => ({ name: c.label, url: absoluteUrl(siteUrl, c.href) }))
+  ) : null;
+  return /* @__PURE__ */ jsxs9(Fragment3, { children: [
+    /* @__PURE__ */ jsx9("nav", { "aria-label": "\uBE0C\uB808\uB4DC\uD06C\uB7FC", className: "rt-cms-breadcrumb", children: /* @__PURE__ */ jsx9("ol", { children: crumbs.map(
+      (c, i) => i === crumbs.length - 1 ? /* @__PURE__ */ jsx9("li", { "aria-current": "page", children: c.label }, i) : /* @__PURE__ */ jsx9("li", { children: /* @__PURE__ */ jsx9("a", { href: c.href, children: c.label }) }, i)
+    ) }) }),
+    jsonLd ? /* @__PURE__ */ jsx9(
+      "script",
+      {
+        type: "application/ld+json",
+        dangerouslySetInnerHTML: { __html: jsonLdJson(jsonLd) }
+      }
+    ) : null
+  ] });
+}
+function absoluteUrl(siteUrl, path) {
+  const normalized = path.startsWith("/") ? path : `/${path}`;
+  return `${trimSlash(siteUrl)}${normalized}`;
+}
 function renderArchiveRelated(groups, collections) {
   const visible = groups.filter((group) => group.items.length > 0);
   if (visible.length === 0) return null;
@@ -3229,6 +3339,9 @@ async function resolveThemeStyle(input) {
 function defaultPostHref(post) {
   return `/blog/${post.slug}`;
 }
+function defaultAuthorHref(slug) {
+  return `/blog/author/${slug}`;
+}
 function makeCollectionPostHref(collections) {
   return (post) => {
     const path = resolvePostPath(post, collections);
@@ -3526,4 +3639,4 @@ export {
   RootTalePage,
   RenderTiptap
 };
-//# sourceMappingURL=chunk-JXRHZGRJ.js.map
+//# sourceMappingURL=chunk-LIBSVC4M.js.map