@roottale/cms-renderer-next 0.20.0 → 0.22.0

package/dist/templates.d.ts

@@ -0,0 +1,715 @@
+import { z } from 'zod';
+import { ReactElement, CSSProperties, ReactNode } from 'react';
+
+/**
+ * `@roottale/cms-renderer-next/templates` — canonical `SiteConfig` 스키마.
+ *
+ * ADR-0040 P2 + P0.5 RFC §① (`roottale-docs/docs/services/external-site-blockification.md`).
+ *
+ * 설계 원칙 (codex consult #1 반영):
+ * - **계약 = `section type + variant + renderer registry`.** tier 는 스키마 필드가
+ *   아니라 문서/거버넌스용 성숙도 메타데이터.
+ * - **100% serializable** — 함수/JSX 금지 (Astro parity + admin preview 동일 경로).
+ *   escape hatch 는 config 안 함수가 아니라 `customSections` registry
+ *   (`SiteRenderer` 에 빌드 시 type→컴포넌트 주입).
+ * - CMS-bound 섹션(`blog-list`/`lead-form`)은 `RootTaleBlogList`/`RootTaleLeadForm`
+ *   으로 위임 — templates 는 cms-renderer 코어를 단방향 의존 (RFC §②).
+ *
+ * RFC §① 대비 구현 정정:
+ * - `site.url` 은 optional — 스타터/외부 사이트가 `SITE_URL` env 로 런타임 해석하는
+ *   기존 패턴(P4 스타터)과 충돌하므로 config 강제 대신 env fallback 허용.
+ * - 빌트인에 `rich-text` 추가 (P4 스타터 기 운영 섹션 — "동일 패턴" 군).
+ */
+
+declare const NavItemSchema: z.ZodObject<{
+    label: z.ZodString;
+    href: z.ZodString;
+    children: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        href: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        label: string;
+        href: string;
+    }, {
+        label: string;
+        href: string;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    label: string;
+    href: string;
+    children?: {
+        label: string;
+        href: string;
+    }[] | undefined;
+}, {
+    label: string;
+    href: string;
+    children?: {
+        label: string;
+        href: string;
+    }[] | undefined;
+}>;
+type NavItem = z.infer<typeof NavItemSchema>;
+declare const CtaSchema: z.ZodObject<{
+    label: z.ZodString;
+    href: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    label: string;
+    href: string;
+}, {
+    label: string;
+    href: string;
+}>;
+type SectionCta = z.infer<typeof CtaSchema>;
+declare const HeroSectionSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    theme: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+} & {
+    type: z.ZodLiteral<"hero">;
+    variant: z.ZodDefault<z.ZodEnum<["split", "image", "minimal"]>>;
+    props: z.ZodObject<{
+        eyebrow: z.ZodOptional<z.ZodString>;
+        /** `\n` 으로 줄바꿈. */
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        imageSrc: z.ZodOptional<z.ZodString>;
+        imageAlt: z.ZodOptional<z.ZodString>;
+        cta: z.ZodOptional<z.ZodObject<{
+            label: z.ZodString;
+            href: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            label: string;
+            href: string;
+        }, {
+            label: string;
+            href: string;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        eyebrow?: string | undefined;
+        description?: string | undefined;
+        imageSrc?: string | undefined;
+        imageAlt?: string | undefined;
+        cta?: {
+            label: string;
+            href: string;
+        } | undefined;
+    }, {
+        title: string;
+        eyebrow?: string | undefined;
+        description?: string | undefined;
+        imageSrc?: string | undefined;
+        imageAlt?: string | undefined;
+        cta?: {
+            label: string;
+            href: string;
+        } | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    type: "hero";
+    variant: "split" | "image" | "minimal";
+    props: {
+        title: string;
+        eyebrow?: string | undefined;
+        description?: string | undefined;
+        imageSrc?: string | undefined;
+        imageAlt?: string | undefined;
+        cta?: {
+            label: string;
+            href: string;
+        } | undefined;
+    };
+    id?: string | undefined;
+    theme?: Record<string, string> | undefined;
+}, {
+    type: "hero";
+    props: {
+        title: string;
+        eyebrow?: string | undefined;
+        description?: string | undefined;
+        imageSrc?: string | undefined;
+        imageAlt?: string | undefined;
+        cta?: {
+            label: string;
+            href: string;
+        } | undefined;
+    };
+    id?: string | undefined;
+    variant?: "split" | "image" | "minimal" | undefined;
+    theme?: Record<string, string> | undefined;
+}>;
+declare const RichTextSectionSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    variant: z.ZodOptional<z.ZodString>;
+    theme: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+} & {
+    type: z.ZodLiteral<"rich-text">;
+    props: z.ZodObject<{
+        heading: z.ZodOptional<z.ZodString>;
+        /** `\n\n` 으로 문단 분리. */
+        body: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        body: string;
+        heading?: string | undefined;
+    }, {
+        body: string;
+        heading?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    type: "rich-text";
+    props: {
+        body: string;
+        heading?: string | undefined;
+    };
+    id?: string | undefined;
+    variant?: string | undefined;
+    theme?: Record<string, string> | undefined;
+}, {
+    type: "rich-text";
+    props: {
+        body: string;
+        heading?: string | undefined;
+    };
+    id?: string | undefined;
+    variant?: string | undefined;
+    theme?: Record<string, string> | undefined;
+}>;
+declare const ServicesSectionSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    theme: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+} & {
+    type: z.ZodLiteral<"services">;
+    variant: z.ZodDefault<z.ZodEnum<["grid", "list"]>>;
+    props: z.ZodObject<{
+        heading: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        items: z.ZodArray<z.ZodObject<{
+            title: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            href: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            title: string;
+            href?: string | undefined;
+            description?: string | undefined;
+        }, {
+            title: string;
+            href?: string | undefined;
+            description?: string | undefined;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        items: {
+            title: string;
+            href?: string | undefined;
+            description?: string | undefined;
+        }[];
+        description?: string | undefined;
+        heading?: string | undefined;
+    }, {
+        items: {
+            title: string;
+            href?: string | undefined;
+            description?: string | undefined;
+        }[];
+        description?: string | undefined;
+        heading?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    type: "services";
+    variant: "grid" | "list";
+    props: {
+        items: {
+            title: string;
+            href?: string | undefined;
+            description?: string | undefined;
+        }[];
+        description?: string | undefined;
+        heading?: string | undefined;
+    };
+    id?: string | undefined;
+    theme?: Record<string, string> | undefined;
+}, {
+    type: "services";
+    props: {
+        items: {
+            title: string;
+            href?: string | undefined;
+            description?: string | undefined;
+        }[];
+        description?: string | undefined;
+        heading?: string | undefined;
+    };
+    id?: string | undefined;
+    variant?: "grid" | "list" | undefined;
+    theme?: Record<string, string> | undefined;
+}>;
+declare const FaqSectionSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    variant: z.ZodOptional<z.ZodString>;
+    theme: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+} & {
+    type: z.ZodLiteral<"faq">;
+    props: z.ZodObject<{
+        heading: z.ZodOptional<z.ZodString>;
+        items: z.ZodArray<z.ZodObject<{
+            question: z.ZodString;
+            answer: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            question: string;
+            answer: string;
+        }, {
+            question: string;
+            answer: string;
+        }>, "many">;
+        /** FAQPage JSON-LD 주입 (기본 true — SEO 3 pillars). 페이지에 FAQ 섹션이 여럿이면 하나만 true 로. */
+        jsonLd: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        items: {
+            question: string;
+            answer: string;
+        }[];
+        jsonLd: boolean;
+        heading?: string | undefined;
+    }, {
+        items: {
+            question: string;
+            answer: string;
+        }[];
+        heading?: string | undefined;
+        jsonLd?: boolean | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    type: "faq";
+    props: {
+        items: {
+            question: string;
+            answer: string;
+        }[];
+        jsonLd: boolean;
+        heading?: string | undefined;
+    };
+    id?: string | undefined;
+    variant?: string | undefined;
+    theme?: Record<string, string> | undefined;
+}, {
+    type: "faq";
+    props: {
+        items: {
+            question: string;
+            answer: string;
+        }[];
+        heading?: string | undefined;
+        jsonLd?: boolean | undefined;
+    };
+    id?: string | undefined;
+    variant?: string | undefined;
+    theme?: Record<string, string> | undefined;
+}>;
+declare const CtaBannerSectionSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    variant: z.ZodOptional<z.ZodString>;
+    theme: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+} & {
+    type: z.ZodLiteral<"cta-banner">;
+    props: z.ZodObject<{
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        cta: z.ZodOptional<z.ZodObject<{
+            label: z.ZodString;
+            href: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            label: string;
+            href: string;
+        }, {
+            label: string;
+            href: string;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        description?: string | undefined;
+        cta?: {
+            label: string;
+            href: string;
+        } | undefined;
+    }, {
+        title: string;
+        description?: string | undefined;
+        cta?: {
+            label: string;
+            href: string;
+        } | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    type: "cta-banner";
+    props: {
+        title: string;
+        description?: string | undefined;
+        cta?: {
+            label: string;
+            href: string;
+        } | undefined;
+    };
+    id?: string | undefined;
+    variant?: string | undefined;
+    theme?: Record<string, string> | undefined;
+}, {
+    type: "cta-banner";
+    props: {
+        title: string;
+        description?: string | undefined;
+        cta?: {
+            label: string;
+            href: string;
+        } | undefined;
+    };
+    id?: string | undefined;
+    variant?: string | undefined;
+    theme?: Record<string, string> | undefined;
+}>;
+/** → `RootTaleBlogList` 위임 (cms-bound). */
+declare const BlogListSectionSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    variant: z.ZodOptional<z.ZodString>;
+    theme: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+} & {
+    type: z.ZodLiteral<"blog-list">;
+    props: z.ZodObject<{
+        heading: z.ZodOptional<z.ZodString>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        /** 포스트 링크 베이스. 기본 `/blog`. */
+        blogBasePath: z.ZodOptional<z.ZodString>;
+        emptyMessage: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        heading?: string | undefined;
+        limit?: number | undefined;
+        blogBasePath?: string | undefined;
+        emptyMessage?: string | undefined;
+    }, {
+        heading?: string | undefined;
+        limit?: number | undefined;
+        blogBasePath?: string | undefined;
+        emptyMessage?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    type: "blog-list";
+    props: {
+        heading?: string | undefined;
+        limit?: number | undefined;
+        blogBasePath?: string | undefined;
+        emptyMessage?: string | undefined;
+    };
+    id?: string | undefined;
+    variant?: string | undefined;
+    theme?: Record<string, string> | undefined;
+}, {
+    type: "blog-list";
+    props: {
+        heading?: string | undefined;
+        limit?: number | undefined;
+        blogBasePath?: string | undefined;
+        emptyMessage?: string | undefined;
+    };
+    id?: string | undefined;
+    variant?: string | undefined;
+    theme?: Record<string, string> | undefined;
+}>;
+/** → `RootTaleLeadForm` 위임 (cms-bound). */
+declare const LeadFormSectionSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    variant: z.ZodOptional<z.ZodString>;
+    theme: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+} & {
+    type: z.ZodLiteral<"lead-form">;
+    props: z.ZodObject<{
+        /** 사이트 자체 server 엔드포인트 (예: `/api/inquiry`). intake API 직접 지정 금지. */
+        action: z.ZodString;
+        vertical: z.ZodOptional<z.ZodEnum<["consulting", "medical", "tax", "legal"]>>;
+        heading: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        submitLabel: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        action: string;
+        description?: string | undefined;
+        heading?: string | undefined;
+        vertical?: "consulting" | "medical" | "tax" | "legal" | undefined;
+        submitLabel?: string | undefined;
+    }, {
+        action: string;
+        description?: string | undefined;
+        heading?: string | undefined;
+        vertical?: "consulting" | "medical" | "tax" | "legal" | undefined;
+        submitLabel?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    type: "lead-form";
+    props: {
+        action: string;
+        description?: string | undefined;
+        heading?: string | undefined;
+        vertical?: "consulting" | "medical" | "tax" | "legal" | undefined;
+        submitLabel?: string | undefined;
+    };
+    id?: string | undefined;
+    variant?: string | undefined;
+    theme?: Record<string, string> | undefined;
+}, {
+    type: "lead-form";
+    props: {
+        action: string;
+        description?: string | undefined;
+        heading?: string | undefined;
+        vertical?: "consulting" | "medical" | "tax" | "legal" | undefined;
+        submitLabel?: string | undefined;
+    };
+    id?: string | undefined;
+    variant?: string | undefined;
+    theme?: Record<string, string> | undefined;
+}>;
+/** customSections 용 fallback — `type` 자유, props 는 직렬화만 강제. */
+declare const CustomSectionSchema: z.ZodObject<{
+    /** 안정적 anchor·dedup·preview 매핑용. 페이지 내 유일. */
+    id: z.ZodOptional<z.ZodString>;
+    /** 빌트인 또는 customSections registry 키. kebab-case. */
+    type: z.ZodString;
+    /** 같은 type 의 비주얼 변형. 빌트인 type 은 enum 으로 좁힘. */
+    variant: z.ZodOptional<z.ZodString>;
+    /** 섹션 스코프 토큰 override (`--rt-*` CSS 변수 → 값). */
+    theme: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    /** 섹션별 직렬화 props. */
+    props: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodType<unknown, z.ZodTypeDef, unknown>>>;
+}, "strip", z.ZodTypeAny, {
+    type: string;
+    props: Record<string, unknown>;
+    id?: string | undefined;
+    variant?: string | undefined;
+    theme?: Record<string, string> | undefined;
+}, {
+    type: string;
+    id?: string | undefined;
+    variant?: string | undefined;
+    theme?: Record<string, string> | undefined;
+    props?: Record<string, unknown> | undefined;
+}>;
+/** 빌트인 type 목록 (renderer registry 와 1:1). */
+declare const BUILTIN_SECTION_TYPES: readonly string[];
+type HeroSection = z.output<typeof HeroSectionSchema>;
+type RichTextSection = z.output<typeof RichTextSectionSchema>;
+type ServicesSection = z.output<typeof ServicesSectionSchema>;
+type FaqSection = z.output<typeof FaqSectionSchema>;
+type CtaBannerSection = z.output<typeof CtaBannerSectionSchema>;
+type BlogListSection = z.output<typeof BlogListSectionSchema>;
+type LeadFormSection = z.output<typeof LeadFormSectionSchema>;
+type CustomSection = z.output<typeof CustomSectionSchema>;
+/** 파싱 결과 섹션 (defaults 적용 후). */
+type Section = HeroSection | RichTextSection | ServicesSection | FaqSection | CtaBannerSection | BlogListSection | LeadFormSection | CustomSection;
+/** config 작성용 섹션 (defaults 생략 가능). `site.config.ts` 에서 이 타입 사용. */
+type SectionInput = z.input<typeof HeroSectionSchema> | z.input<typeof RichTextSectionSchema> | z.input<typeof ServicesSectionSchema> | z.input<typeof FaqSectionSchema> | z.input<typeof CtaBannerSectionSchema> | z.input<typeof BlogListSectionSchema> | z.input<typeof LeadFormSectionSchema> | z.input<typeof CustomSectionSchema>;
+/**
+ * 섹션 스키마 — 빌트인 type 이면 해당 스키마로 *강제* 검증 (union fallthrough 로
+ * 빌트인 오타이핑이 CustomSection 으로 조용히 통과하는 것을 차단), 미지 type 은
+ * CustomSection 으로 통과 (렌더러가 customSections registry 로 해석).
+ */
+declare const SectionSchema: z.ZodType<Section, z.ZodTypeDef, SectionInput>;
+declare const SiteConfigSchema: z.ZodObject<{
+    site: z.ZodObject<{
+        /** canonical origin. 생략 시 소비측이 `SITE_URL` env 등으로 해석. */
+        url: z.ZodOptional<z.ZodString>;
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        locale: z.ZodDefault<z.ZodString>;
+        og: z.ZodOptional<z.ZodObject<{
+            image: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            image?: string | undefined;
+        }, {
+            image?: string | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        locale: string;
+        description?: string | undefined;
+        url?: string | undefined;
+        og?: {
+            image?: string | undefined;
+        } | undefined;
+    }, {
+        title: string;
+        description?: string | undefined;
+        url?: string | undefined;
+        locale?: string | undefined;
+        og?: {
+            image?: string | undefined;
+        } | undefined;
+    }>;
+    /** 사이트 전역 토큰 override (`--rt-*` CSS 변수 → 값). 비우면 admin /design SSoT. */
+    theme: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    nav: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        href: z.ZodString;
+        children: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            href: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            label: string;
+            href: string;
+        }, {
+            label: string;
+            href: string;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        label: string;
+        href: string;
+        children?: {
+            label: string;
+            href: string;
+        }[] | undefined;
+    }, {
+        label: string;
+        href: string;
+        children?: {
+            label: string;
+            href: string;
+        }[] | undefined;
+    }>, "many">>;
+    /** path("/", "/services", …) → 섹션 배열. */
+    pages: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodType<Section, z.ZodTypeDef, SectionInput>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    theme: Record<string, string>;
+    site: {
+        title: string;
+        locale: string;
+        description?: string | undefined;
+        url?: string | undefined;
+        og?: {
+            image?: string | undefined;
+        } | undefined;
+    };
+    nav: {
+        label: string;
+        href: string;
+        children?: {
+            label: string;
+            href: string;
+        }[] | undefined;
+    }[];
+    pages: Record<string, Section[]>;
+}, {
+    site: {
+        title: string;
+        description?: string | undefined;
+        url?: string | undefined;
+        locale?: string | undefined;
+        og?: {
+            image?: string | undefined;
+        } | undefined;
+    };
+    pages: Record<string, SectionInput[]>;
+    theme?: Record<string, string> | undefined;
+    nav?: {
+        label: string;
+        href: string;
+        children?: {
+            label: string;
+            href: string;
+        }[] | undefined;
+    }[] | undefined;
+}>;
+type SiteConfig = z.output<typeof SiteConfigSchema>;
+/** config 작성용 (defaults 생략 가능). */
+type SiteConfigInput = Omit<z.input<typeof SiteConfigSchema>, "pages"> & {
+    pages: Record<string, SectionInput[]>;
+};
+/** config 검증 + defaults 적용. 실패 시 ZodError throw (빌드 타임 fail-fast 용). */
+declare function parseSiteConfig(input: unknown): SiteConfig;
+/**
+ * `site.config.ts` 작성 헬퍼 — 타입 추론 + 즉시 검증.
+ *
+ * ```ts
+ * import { defineSiteConfig } from "@roottale/cms-renderer-next/templates";
+ * export default defineSiteConfig({ site: { title: "…" }, pages: { "/": [ … ] } });
+ * ```
+ */
+declare function defineSiteConfig(input: SiteConfigInput): SiteConfig;
+
+/**
+ * 빌트인 섹션 템플릿 — MUI-free, 0 JS RSC (ADR-0040 P2).
+ *
+ * 클래스는 전부 `rt-tpl-*` prefix, 스코프는 섹션 루트의 `data-roottale-tpl`
+ * (templates.css 가 `[data-roottale-tpl] :where(…)` 로 zero-specificity 적용 —
+ * customer 는 plain class / Tailwind utility 로 자유 override, cms-public.css
+ * 와 동일 계약).
+ *
+ * 토큰은 `--rt-*` CSS 변수 + 정적 fallback — `@roottale/tokens`(private) 미의존
+ * (RFC §②). admin /design 값은 `RootTaleThemeProvider` 가 주입.
+ */
+
+/** 섹션 `theme`(--rt-* 변수 override)를 inline style 로. */
+declare function sectionThemeStyle(theme: Record<string, string> | undefined): CSSProperties | undefined;
+/** 빌트인 `hero`. variant: split(기본) / image / minimal. */
+declare function TemplateHero(section: HeroSection): ReactElement;
+/** 빌트인 `rich-text`. 문단은 `\n\n` 분리. */
+declare function TemplateRichText(section: RichTextSection): ReactElement;
+/** 빌트인 `services`. variant: grid(기본) / list. */
+declare function TemplateServices(section: ServicesSection): ReactElement;
+/** 빌트인 `faq`. `<details>` 0 JS + FAQPage JSON-LD (기본 on). */
+declare function TemplateFaq(section: FaqSection): ReactElement;
+/** 빌트인 `cta-banner`. */
+declare function TemplateCtaBanner(section: CtaBannerSection): ReactElement;
+
+/**
+ * `SiteRenderer` — `SiteConfig.pages[path]` 섹션 배열을 registry 로 렌더.
+ *
+ * ADR-0040 P2 + P0.5 RFC §①:
+ * - 빌트인 registry + 클라 주입 `customSections` 머지. **빌트인이 우선** —
+ *   클라가 빌트인 type 을 가로채 계약이 갈라지는 것 방지 (고유 섹션은 고유
+ *   type 으로).
+ * - **render-prop 금지**: 임의 JSX escape hatch 는 customSections registry 로만.
+ * - **admin preview parity**: admin draft/preview 도 동일 `SiteRenderer` + 동일
+ *   빌트인 registry 를 탄다. customSections 는 클라 repo 자산 — preview 에선
+ *   미주입 → `unknownSection: "placeholder"` 로 skeleton 표시.
+ * - cms-bound 섹션(blog-list/lead-form)은 `RootTaleBlogList`/`RootTaleLeadForm`
+ *   위임 (단방향: templates → renderer 코어).
+ */
+
+/** customSections registry 컴포넌트 계약 (RFC §①). */
+type SectionComponent = (p: {
+    id?: string;
+    props: Record<string, unknown>;
+    variant?: string;
+    theme?: Record<string, string>;
+}) => ReactNode;
+interface SiteRendererProps {
+    /** `defineSiteConfig()` 결과 또는 raw config (내부에서 검증). */
+    config: SiteConfig | SiteConfigInput;
+    /** 현재 페이지 경로 — `config.pages` 의 key ("/", "/services", …). */
+    path: string;
+    /** cms-bound 섹션(blog-list/lead-form 의 theme fetch) 위임용. 서버 전용. */
+    apiKey: string;
+    /** self-host 등 API base override (`ROOTTALE_API_BASE`). */
+    baseUrl?: string;
+    /** 클라 repo 고유 섹션 registry (escape hatch). 빌트인 type 은 가로챌 수 없음. */
+    customSections?: Record<string, SectionComponent>;
+    /**
+     * registry 에 없는 type 처리. 기본 "warn-dev" = dev 에서 경고 박스, prod 에서
+     * 생략. admin preview 는 "placeholder" (customSections 미주입 환경).
+     */
+    unknownSection?: "warn-dev" | "placeholder" | "ignore";
+}
+/**
+ * 한 페이지의 섹션 배열을 순서대로 렌더.
+ *
+ * ```tsx
+ * // app/services/page.tsx
+ * import config from "@/site.config";
+ * import { SiteRenderer } from "@roottale/cms-renderer-next/templates";
+ *
+ * export default function ServicesPage() {
+ *   return (
+ *     <SiteRenderer config={config} path="/services"
+ *       apiKey={process.env.ROOTTALE_API_KEY!} />
+ *   );
+ * }
+ * ```
+ */
+declare function SiteRenderer(props: SiteRendererProps): ReactElement;
+
+export { BUILTIN_SECTION_TYPES, type BlogListSection, BlogListSectionSchema, type CtaBannerSection, CtaBannerSectionSchema, type CustomSection, CustomSectionSchema, type FaqSection, FaqSectionSchema, type HeroSection, HeroSectionSchema, type LeadFormSection, LeadFormSectionSchema, type NavItem, NavItemSchema, type RichTextSection, RichTextSectionSchema, type Section, type SectionComponent, type SectionCta, type SectionInput, SectionSchema, type ServicesSection, ServicesSectionSchema, type SiteConfig, type SiteConfigInput, SiteConfigSchema, SiteRenderer, type SiteRendererProps, TemplateCtaBanner, TemplateFaq, TemplateHero, TemplateRichText, TemplateServices, defineSiteConfig, parseSiteConfig, sectionThemeStyle };