@roottale/cms-renderer-next 0.52.0 → 0.53.1

package/dist/section-runtime.d.ts

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

package/dist/section-runtime.js

@@ -0,0 +1,9 @@
+import {
+  getSectionNodeRenderer,
+  setSectionNodeRenderer
+} from "./chunk-KSPPYX22.js";
+export {
+  getSectionNodeRenderer,
+  setSectionNodeRenderer
+};
+//# sourceMappingURL=section-runtime.js.map

package/dist/server.d.ts

@@ -1,10 +1,10 @@
 import { ReactElement, ReactNode } from 'react';
 import { CmsPostContent, RootTaleTheme, CmsPostType } from '@roottale/cms-client/server';
 export { RootTaleTheme } from '@roottale/cms-client/server';
-export { R as RootTaleCssVars, t as themeToCssVars } from './theme-css-vars-CD3jcEkp.js';
+import { RootTaleThemeStyle } from '@roottale/ui-react/theme';
 import { Block, BindingResolver, RouteCollection } from '@roottale/cms-core';
 export { a as BlogCategory, B as BlogCategoryWithCount, c as collectCategories, b as collectCategoriesWithCounts, d as defaultCategoryHref, f as filterPostsByCategory } from './blog-filter-BKCGM0qd.js';
-import '@roottale/ui-react/theme';
+import * as react_jsx_runtime from 'react/jsx-runtime';
 
 /**
  * `<RootTalePostCard>` — server-only summary card for a single CmsPostContent.
@@ -81,6 +81,9 @@ interface RootTaleTableOfContentsProps {
 }
 declare function RootTaleTableOfContents(props: RootTaleTableOfContentsProps): ReactElement | null;
 
+type RootTaleCssVars = RootTaleThemeStyle;
+declare function themeToCssVars(theme: RootTaleTheme | null): RootTaleCssVars | null;
+
 /**
  * `<RootTaleFloatingCta>` — fixed-position call-to-action stack.
  *
@@ -275,9 +278,23 @@ type RootTalePageProps = {
     showTitle?: boolean;
     theme?: RootTaleThemeInput;
     locale?: string;
+    /** 페이지 JSON을 렌더하기 직전 콘텐츠 참조를 실제 섹션 props로 바꾸는 서버 함수. */
+    prepareBody?: (document: Record<string, unknown>) => Promise<Record<string, unknown>>;
 };
 declare function RootTalePage(props: RootTalePageProps): Promise<ReactElement>;
 
+interface RootTaleExposureSlotProps {
+    readonly apiKey: string;
+    readonly baseUrl?: string;
+    readonly siteId?: string;
+    readonly slotKey: string;
+    readonly path: string;
+    readonly allowedVariants: readonly string[];
+    readonly revalidate?: number;
+}
+/** FRONT가 코드로 만든 슬롯 안에서만 활성 배너·팝업을 렌더한다. */
+declare function RootTaleExposureSlot(props: RootTaleExposureSlotProps): Promise<react_jsx_runtime.JSX.Element | null>;
+
 type RenderTiptapProps = {
     readonly doc: Record<string, unknown>;
     readonly fields?: Record<string, unknown> | null;
@@ -286,4 +303,33 @@ type RenderTiptapProps = {
 };
 declare function RenderTiptap({ doc, fields, apiKey, baseUrl, }: RenderTiptapProps): ReactElement;
 
-export { type BlogPostBreadcrumbOptions, type CtaButton, type CtaButtonType, type FloatingCtaPosition, type LeadFormVertical, RenderTiptap, RootTaleBlogCategories, type RootTaleBlogCategoriesProps, RootTaleBlogList, type RootTaleBlogListProps, RootTaleBlogPost, type RootTaleBlogPostProps, RootTaleFaqJsonLd, RootTaleFloatingCta, type RootTaleFloatingCtaProps, RootTaleLeadForm, type RootTaleLeadFormProps, RootTalePage, type RootTalePageProps, RootTalePostCard, type RootTalePostCardProps, RootTaleTableOfContents, type RootTaleTableOfContentsProps, type RootTaleThemeInput, RootTaleThemeProvider, type TocEntry, attachHeadingIds, extractToc, headingToId, renderBlock, renderBlocks, renderBoundBlocks };
+/**
+ * 본문 렌더 소스 결정 — HTML 정본 우선, 없으면 Block JSON 폴백.
+ *
+ * 배경: 외부에서 이관한 글은 **HTML 이 정본**이고 body_json 은 그 파생/대체본이다.
+ * 파생본은 표·중첩 목록 같은 구조에서 원문과 미묘하게 달라질 수 있으므로, 원문이
+ * 남아 있으면 그것을 보여주는 편이 정확하다. 반대로 에디터에서 편집된 글은
+ * body_html 이 비워지므로(저장 경로가 무효화) 자동으로 JSON 경로로 돌아온다.
+ *
+ * 안전성: HTML 은 신뢰하지 않는다. 최종 sink 는 공용 `sanitizeHtml` 하나뿐이며
+ * (cms-core), 렌더 직전 여기서 통과시킨다 — 저장 시점에 정제됐더라도 다시 한다
+ * (저장 경로가 여럿이고 sanitizer 규칙은 갱신되므로, 방어는 렌더 시점 기준).
+ *
+ * sanitize 결과가 실질적으로 비면(태그만 남고 내용이 없음) HTML 을 쓰지 않고
+ * JSON 으로 폴백한다 — 빈 화면보다 파생본이 낫다.
+ */
+type PostBodySource = {
+    readonly kind: "html";
+    readonly html: string;
+} | {
+    readonly kind: "json";
+};
+/**
+ * 렌더에 쓸 본문 소스를 고른다.
+ *
+ * @param bodyHtml 원문 HTML 정본 (null/미포함 = 구 서버이거나 JSON 이 정본).
+ * @returns `kind: "html"` 이면 `html` 은 **이미 sanitize 된** 값이라 그대로 주입 가능.
+ */
+declare function resolvePostBodySource(bodyHtml: string | null | undefined): PostBodySource;
+
+export { type BlogPostBreadcrumbOptions, type CtaButton, type CtaButtonType, type FloatingCtaPosition, type LeadFormVertical, type PostBodySource, RenderTiptap, RootTaleBlogCategories, type RootTaleBlogCategoriesProps, RootTaleBlogList, type RootTaleBlogListProps, RootTaleBlogPost, type RootTaleBlogPostProps, type RootTaleCssVars, RootTaleExposureSlot, type RootTaleExposureSlotProps, RootTaleFaqJsonLd, RootTaleFloatingCta, type RootTaleFloatingCtaProps, RootTaleLeadForm, type RootTaleLeadFormProps, RootTalePage, type RootTalePageProps, RootTalePostCard, type RootTalePostCardProps, RootTaleTableOfContents, type RootTaleTableOfContentsProps, type RootTaleThemeInput, RootTaleThemeProvider, type TocEntry, attachHeadingIds, extractToc, headingToId, renderBlock, renderBlocks, renderBoundBlocks, resolvePostBodySource, themeToCssVars };