@roottale/cms-renderer-next 0.40.0 → 0.41.1

package/CHANGELOG.md

@@ -1,5 +1,83 @@
 # @roottale/cms-renderer-next
 
+## 0.41.1
+
+### Patch Changes
+
+- 3810879: Add Turnstile-aware inquiry submission fields, rate-limit error handling, and docs for protected lead intake.
+- Updated dependencies [3810879]
+  - @roottale/cms-client@0.41.1
+
+## 0.41.0
+
+### Minor Changes
+
+- 3768f72: FAQ 블록 — `<details>` 아코디언 + FAQPage 구조화데이터(JSON-LD).
+
+  어드민 에디터의 FAQ 블록(`roottale/faq` → faqItem/faqQuestion/faqAnswer)이
+  발행되면 `RootTaleBlogPost`가 자동으로:
+  - `<details class="rt-cms-faq-item"><summary class="rt-cms-faq-q">…</summary>
+    <div class="rt-cms-faq-a">…</div></details>` 아코디언(0 JS)으로 렌더하고,
+  - 글 단위 `FAQPage` JSON-LD(`<script type="application/ld+json">`)를 1개 삽입한다.
+
+  추가 연동/키 불필요 — 기존 단일 API 키 위에서 동작하며, 업그레이드 시 기존 글에도
+  FAQ 블록이 있으면 즉시 반영된다. `@roottale/cms-core` 에 추출 유틸
+  `extractFaqEntries(doc)` / `faqPageJsonLd(entries)` 추가(렌더러 공유). 스타일은
+  `cms-public.css` 의 `.rt-cms-faq*` 클래스로 테마 토큰을 따른다.
+
+- e8b1d33: 관련 글(related posts) — 글 하단에 같은 카테고리 최근 글 노출.
+
+  `RootTaleBlogPost`에 옵션 추가:
+  - `relatedPostsCount`(기본 0 = off — 기존 마크업 보존), `relatedPostsTitle`(기본
+    "관련 글"), `postHref` / `collections`(링크 라우팅, 목록과 동일 규칙).
+  - 켜면 같은 **카테고리**를 1개 이상 공유하는 최근 글을 N개 `<nav
+class="rt-cms-related">` 로 렌더(현재 글 제외, 발행일 내림차순). 현재 글에
+    카테고리가 없거나 후보가 없으면 렌더되지 않는다.
+
+  `@roottale/cms-client` 에 순수 헬퍼 `selectRelatedPosts(current, candidates,
+limit)` 추가(서버 카테고리 필터가 없어 최근 글 배치에서 선별). 스타일은
+  `cms-public.css` 의 `.rt-cms-related*` 클래스(테마 토큰 기반).
+
+- 9f246f4: 목차(TOC) 사이드바 배치 opt-in — 넓은 화면에서 본문 오른쪽 sticky 목차.
+
+  블로그 설정 `toc_position`(`"inline"` | `"sidebar"`) 추가. 기본은 기존과 동일한
+  `"inline"`(본문 위 접이식). `"sidebar"` 선택 시:
+  - 넓은 화면(본문 컬럼 ≥ 60rem)에서 본문 오른쪽에 스크롤을 따라오는 sticky 목차.
+  - 좁은 화면은 CSS 컨테이너 쿼리로 자동 인라인(본문 위)로 폴백 — 마크업 동일.
+  - 뷰포트가 아닌 **본문 컬럼 폭** 기준(`@container`)이라 임베드 위치·주변
+    레이아웃과 무관하게 안전.
+
+  `RootTaleBlogPost`는 배치를 자동 반영하므로 고객 연동 코드 변경은 불필요.
+  `RootTaleBlogSettings` / `ResolvedPostDisplay` 에 `tocPosition` 필드 추가
+  (cms-client). 어드민 "블로그 설정 → 목차 위치" 에서 선택.
+
+  공개 API `GET /v1/cms/public/blog-settings` 응답에 `toc_position` 필드 추가
+  (cms-mcp api-reference 문서 동반 갱신).
+
+### Patch Changes
+
+- 8838c24: 블로그 본문 조판 개선 — 균일 measure · 한글 줄바꿈 · 리스트 마커 (`cms-public.css`).
+  - **균일 읽기 폭(measure)**: 기존엔 `max-inline-size: 72ch` 가 문단(`p`)에만
+    걸려 리스트/제목/표는 컬럼 풀폭으로 퍼져 줄바꿈 폭이 어긋났다. 이제
+    `.rt-cms-body > *`(모든 최상위 블록)에 동일 measure 적용 → 문단·리스트·제목·표·FAQ
+    가 같은 폭에서 줄바꿈. 목차(`.rt-cms-toc`)도 같은 폭으로 정렬.
+  - **한글 어절 줄바꿈**: `.rt-cms-body` 에 `word-break: keep-all` +
+    `overflow-wrap: anywhere`. CJK 기본값(`normal`)이 어절 중간에서 줄을 끊던
+    문제를 어절 단위로 교정(긴 URL·토큰만 anywhere). `pre`(코드)는 예외.
+  - **리스트 마커 복원**: 고객 사이트 CSS 리셋(Tailwind Preflight 등)이
+    `list-style` 을 지워 불릿/번호가 사라지던 문제 복원(`ul→disc / ol→decimal`,
+    중첩 `circle`·`square`).
+
+  `cms-renderer-next/src/styles/cms-public.css` 한 파일 변경. 어드민 에디터
+  (`.tiptap-content`)에도 동일 규칙을 적용해 WYSIWYG 파리티 유지(에디터 FAQ 도
+  공개 아코디언과 같은 시각 언어).
+
+- Updated dependencies [3768f72]
+- Updated dependencies [e8b1d33]
+- Updated dependencies [9f246f4]
+  - @roottale/cms-core@0.41.0
+  - @roottale/cms-client@0.41.0
+
 ## 0.40.0
 
 ### Minor Changes

package/README.md

@@ -148,9 +148,10 @@ export default function ContactPage() {
     <main>
       <h1>진단 신청</h1>
       <RootTaleLeadForm
-        action="https://mysite.roottale.com/api/lead-intake"
+        action="/api/inquiry"
         vertical="tax"
         redirectUrl="https://kjmtax.roottale.app/contact"
+        turnstileSiteKey={process.env.NEXT_PUBLIC_TURNSTILE_SITE_KEY}
         heading="무료 진단 신청"
         description="평일 기준 1-2 영업일 내에 회신드립니다."
       />
@@ -159,7 +160,9 @@ export default function ContactPage() {
 }
 ```
 
-The form submits via HTML POST (no JS, no `fetch`). After insert, the admin 302s back to `redirectUrl` with `?ok=1` (or `?err=<reason>`). The admin checks the URL against its `LEAD_INTAKE_ALLOWED_ORIGINS` env — if you skip `redirectUrl`, the admin falls back to its `LEAD_INTAKE_REDIRECT_BASE`.
+The form submits via HTML POST (no custom JS). In a Next.js site, point `action` to a route handler that calls `submitInquiry`; the starter app uses `/api/inquiry`. After insert, tenant-api redirects back to `redirectUrl` with `?ok=1` (or `?err=<reason>`). The API checks the URL against its `LEAD_INTAKE_ALLOWED_ORIGINS` env — if you skip `redirectUrl`, it falls back to `LEAD_INTAKE_REDIRECT_BASE`.
+
+`turnstileSiteKey` renders the Cloudflare Turnstile widget. Set the matching tenant-api secret as `LEAD_INTAKE_TURNSTILE_SECRET_KEY`.
 
 ### vertical-specific behavior
 
@@ -172,7 +175,7 @@ The form submits via HTML POST (no JS, no `fetch`). After insert, the admin 302s
 |---|---|
 | `RootTaleBlogList` | RSC — fetches `/v1/cms/public/posts?type=post` and renders an `<ul>`. |
 | `RootTaleBlogPost` | RSC — fetches one post, renders Tiptap doc + optional TOC. |
-| `RootTaleLeadForm` | RSC — HTML form, POST → admin `/api/lead-intake`. |
+| `RootTaleLeadForm` | RSC — HTML form for `/v1/public/inquiries` forward routes. |
 | `RootTalePostCard` | Single card primitive (used internally by `RootTaleBlogList`). |
 | `RootTaleTableOfContents` | Standalone TOC (heading list). |
 | `RootTaleFloatingCta` | Floating CTA buttons. |