@roottale/cms-renderer-next 0.55.0 → 0.57.0

package/dist/server.d.ts

@@ -2,8 +2,8 @@ import { ReactElement, ReactNode } from 'react';
 import { CmsPostContent, RootTaleTheme, CmsPostType } from '@roottale/cms-client/server';
 export { RootTaleTheme } from '@roottale/cms-client/server';
 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-BQNQL3Mk.js';
+import { Block, BindingResolver, RouteCollection, InternalContentLinkResolver } from '@roottale/cms-core';
+export { a as BlogCategory, B as BlogCategoryWithCount, c as collectCategories, b as collectCategoriesWithCounts, d as defaultCategoryHref, f as filterPostsByCategory, m as makeCategoryHref } from './blog-filter-qE9Lj49C.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
 /**
@@ -262,6 +262,13 @@ type RootTaleBlogPostProps = {
     locale?: string;
     authorHref?: (slug: string) => string;
     breadcrumb?: BlogPostBreadcrumbOptions;
+    /**
+     * 본문 예약 내부 링크(`[[internal:키|문구]]`) 해석. 기본 `"auto"` = 본문에 토큰이
+     * 있을 때만 발행 글 경로 색인(`fetchInternalContentPathIndex`)을 만들어 링크로
+     * 렌더한다. `false` 면 토큰을 텍스트 그대로 둔다. 미리 만든 색인(Map)이나
+     * 함수를 주면 그것을 쓴다.
+     */
+    internalLinks?: "auto" | false | InternalContentLinkResolver | ReadonlyMap<string, string>;
 };
 interface BlogPostBreadcrumbOptions {
     siteUrl?: string;
@@ -279,6 +286,21 @@ declare function RootTaleFaqJsonLd({ doc, }: {
     readonly doc: unknown;
 }): ReactElement | null;
 
+interface RootTalePostPatternProps {
+    readonly apiKey: string;
+    readonly baseUrl?: string;
+    /** `fetchPost`/`fetchPosts` 로 받은 글(또는 `patternSlots` 만 있는 객체). */
+    readonly post: Pick<CmsPostContent, "patternSlots">;
+    /** 자리 key. 기본 글 하단(`post_footer`). */
+    readonly slot?: string;
+}
+/**
+ * 자체 글 화면을 가진 사이트가 글 하단 공통 블록만 가져다 쓰는 서버 컴포넌트.
+ * `RootTaleBlogPost` 는 이미 본문 아래에 같은 블록을 그리므로 둘을 함께 쓰지 않는다.
+ */
+declare function RootTalePostPattern(props: RootTalePatternProps): Promise<ReactElement | null>;
+type RootTalePatternProps = RootTalePostPatternProps;
+
 interface RootTalePreviewNoticeProps {
     /** `ko`(기본) · `en`. */
     locale?: string;
@@ -319,13 +341,36 @@ interface RootTaleExposureSlotProps {
 /** FRONT가 코드로 만든 슬롯 안에서만 활성 배너·팝업을 렌더한다. */
 declare function RootTaleExposureSlot(props: RootTaleExposureSlotProps): Promise<react_jsx_runtime.JSX.Element | null>;
 
+type InternalLinksSource = InternalContentLinkResolver | ReadonlyMap<string, string> | null;
 type RenderTiptapProps = {
     readonly doc: Record<string, unknown>;
     readonly fields?: Record<string, unknown> | null;
     readonly apiKey?: string;
     readonly baseUrl?: string;
+    /**
+     * 본문 예약 내부 링크(`[[internal:키|문구]]`) 해석 — 키 → 공개 경로.
+     * `fetchInternalContentPathIndex` 결과(Map)나 함수. 없으면 토큰을 텍스트 그대로 둔다.
+     */
+    readonly internalLinks?: InternalLinksSource;
 };
-declare function RenderTiptap({ doc, fields, apiKey, baseUrl, }: RenderTiptapProps): ReactElement;
+declare function RenderTiptap({ doc, fields, apiKey, baseUrl, internalLinks, }: RenderTiptapProps): ReactElement;
+
+interface FetchInternalContentPathIndexOptions {
+    readonly apiKey: string;
+    readonly baseUrl?: string;
+    readonly locale?: string;
+    /** ISR revalidate 초. */
+    readonly revalidate?: number;
+    /** 안전장치 — 이 이상 페이지는 읽지 않는다(100건/페이지). 기본 20 = 2,000건. */
+    readonly maxPages?: number;
+}
+/**
+ * 발행 글 전부의 경로를 모아 키 색인을 만든다. 한 페이지라도 실패하면 그때까지
+ * 모은 것으로 답한다(fail-soft — 링크가 몇 개 문구로 남는 편이 500 보다 낫다).
+ */
+declare function fetchInternalContentPathIndex(options: FetchInternalContentPathIndexOptions): Promise<Map<string, string>>;
+/** 본문(JSON 또는 HTML)에 토큰이 있는지 — 색인을 만들 필요가 있는지 미리 본다. */
+declare function bodyHasInternalContentLinkTokens(doc: Record<string, unknown> | null | undefined, html?: string | null): boolean;
 
 /**
  * 본문 렌더 소스 결정 — HTML 정본 우선, 없으면 Block JSON 폴백.
@@ -356,4 +401,4 @@ type PostBodySource = {
  */
 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, RootTalePreviewNotice, type RootTalePreviewNoticeProps, RootTaleTableOfContents, type RootTaleTableOfContentsProps, type RootTaleThemeInput, RootTaleThemeProvider, type TocEntry, attachHeadingIds, extractToc, headingToId, renderBlock, renderBlocks, renderBoundBlocks, resolvePostBodySource, themeToCssVars };
+export { type BlogPostBreadcrumbOptions, type CtaButton, type CtaButtonType, type FetchInternalContentPathIndexOptions, type FloatingCtaPosition, type InternalLinksSource, 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, RootTalePostPattern, type RootTalePostPatternProps, RootTalePreviewNotice, type RootTalePreviewNoticeProps, RootTaleTableOfContents, type RootTaleTableOfContentsProps, type RootTaleThemeInput, RootTaleThemeProvider, type TocEntry, attachHeadingIds, bodyHasInternalContentLinkTokens, extractToc, fetchInternalContentPathIndex, headingToId, renderBlock, renderBlocks, renderBoundBlocks, resolvePostBodySource, themeToCssVars };