@roottale/cms-renderer-next 0.53.1 → 0.56.0

package/dist/server.d.ts

@@ -3,7 +3,7 @@ import { CmsPostContent, RootTaleTheme, CmsPostType } from '@roottale/cms-client
 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-BKCGM0qd.js';
+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';
 
 /**
@@ -238,7 +238,16 @@ declare function RootTaleBlogCategories(props: RootTaleBlogCategoriesProps): Pro
 
 type RootTaleBlogPostProps = {
     apiKey: string;
-    slugOrId: string;
+    /** 발행 글 slug 또는 id. `previewToken` 을 줄 때는 생략할 수 있다. */
+    slugOrId?: string;
+    /**
+     * 어드민 편집기가 발급한 미리보기 토큰(URL `?token=`). 주면 `slugOrId` 대신
+     * `fetchPostPreview` 로 초안을 받아 **같은 템플릿**으로 그린다 — 미리보기 = 결과물.
+     * 만료(410)면 `previewExpiredElement`, 없으면(404) `notFoundElement`.
+     */
+    previewToken?: string;
+    /** 미리보기 토큰이 만료됐을 때 대신 그릴 요소(기본: 만료 안내 문구). */
+    previewExpiredElement?: ReactElement;
     baseUrl?: string;
     notFoundElement?: ReactElement;
     showTitle?: boolean;
@@ -270,6 +279,21 @@ declare function RootTaleFaqJsonLd({ doc, }: {
     readonly doc: unknown;
 }): ReactElement | null;
 
+interface RootTalePreviewNoticeProps {
+    /** `ko`(기본) · `en`. */
+    locale?: string;
+    /** 기본 안내 문구를 바꾸고 싶을 때. */
+    message?: string;
+    /** 토큰 만료 시각(ISO) — 주면 "HH:MM까지" 를 덧붙인다. */
+    expiresAt?: string;
+}
+/**
+ * 미리보기 화면 상단 안내 띠. 본문 템플릿은 발행 화면과 완전히 같게 두고, "이건
+ * 미리보기다" 라는 신호만 이 띠 하나로 준다. 검색엔진 색인 차단은 metadata
+ * (`buildPreviewMetadata`) 몫이며, 이 컴포넌트는 사람용 안내다.
+ */
+declare function RootTalePreviewNotice({ locale, message, expiresAt, }: RootTalePreviewNoticeProps): ReactElement;
+
 type RootTalePageProps = {
     apiKey: string;
     slugOrId: string;
@@ -332,4 +356,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, RootTaleTableOfContents, type RootTaleTableOfContentsProps, type RootTaleThemeInput, RootTaleThemeProvider, type TocEntry, attachHeadingIds, extractToc, headingToId, renderBlock, renderBlocks, renderBoundBlocks, resolvePostBodySource, themeToCssVars };
+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 };

package/dist/server.js

@@ -4,8 +4,10 @@ import {
   collectCollectionCategories,
   defaultCategoryHref,
   filterPostsByCategory,
+  makeCategoryHref,
+  storedPostPath,
   trimSlash
-} from "./chunk-HM5VP7SR.js";
+} from "./chunk-GDP2VGJR.js";
 import {
   getSectionNodeRenderer
 } from "./chunk-KSPPYX22.js";
@@ -84,6 +86,8 @@ var DICTS = {
     relatedPostsTitle: "\uAD00\uB828 \uAE00",
     postNotFound: "\uAE00\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.",
     pageNotFound: "\uD398\uC774\uC9C0\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.",
+    previewExpired: "\uBBF8\uB9AC\uBCF4\uAE30 \uB9C1\uD06C\uAC00 \uB9CC\uB8CC\uB410\uC5B4\uC694. \uAD00\uB9AC\uC790 \uD3B8\uC9D1\uAE30\uC5D0\uC11C \uBBF8\uB9AC\uBCF4\uAE30\uB97C \uB2E4\uC2DC \uC5F4\uC5B4 \uC8FC\uC138\uC694.",
+    previewNotice: "\uBBF8\uB9AC\uBCF4\uAE30 \u2014 \uC544\uC9C1 \uACF5\uAC1C\uB418\uC9C0 \uC54A\uC740 \uB0B4\uC6A9\uC774\uBA70 \uAC80\uC0C9\uC5D0 \uB178\uCD9C\uB418\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.",
     tableOfContentsTitle: "\uBAA9\uCC28"
   },
   en: {
@@ -93,6 +97,8 @@ var DICTS = {
     relatedPostsTitle: "Related posts",
     postNotFound: "Post not found.",
     pageNotFound: "Page not found.",
+    previewExpired: "This preview link has expired. Open the preview again from the admin editor.",
+    previewNotice: "Preview \u2014 this content is not public and is hidden from search engines.",
     tableOfContentsTitle: "Table of contents"
   }
 };
@@ -660,20 +666,22 @@ import {
   resolvePostPath
 } from "@roottale/cms-core";
 function defaultPostHref(post) {
-  return `/blog/${post.slug}`;
+  return storedPostPath(post) ?? `/blog/${post.slug}`;
 }
 function defaultAuthorHref(slug) {
   return `/blog/author/${slug}`;
 }
 function makeCollectionPostHref(collections) {
   return (post) => {
+    const stored = storedPostPath(post);
+    if (stored) return stored;
     const path = resolvePostPath(post, collections);
     if (path) return path;
     const collection = resolvePostCollection(post, collections);
     if (collection?.detail === false && collection.basePath) {
       return collection.basePath;
     }
-    return defaultPostHref(post);
+    return `/blog/${post.slug}`;
   };
 }
 
@@ -850,7 +858,9 @@ async function RootTaleBlogCategories(props) {
 // src/server/blog-post.tsx
 import {
   fetchPost,
+  fetchPostPreview,
   fetchPosts as fetchPosts2,
+  isPreviewExpiredError,
   resolvePostDisplay as resolvePostDisplay2,
   selectRelatedPosts
 } from "@roottale/cms-client/server";
@@ -1538,10 +1548,35 @@ function authorImageRadiusCss(radius) {
   if (radius === "rounded") return "0.875rem";
   return "0";
 }
+async function lookupPost(input) {
+  if (input.previewToken) {
+    try {
+      const preview = await fetchPostPreview({
+        apiKey: input.apiKey,
+        baseUrl: input.baseUrl,
+        token: input.previewToken
+      });
+      return preview ? { kind: "post", post: preview } : { kind: "missing" };
+    } catch (error) {
+      if (isPreviewExpiredError(error)) return { kind: "preview-expired" };
+      throw error;
+    }
+  }
+  if (!input.slugOrId) return { kind: "missing" };
+  const post = await fetchPost({
+    apiKey: input.apiKey,
+    slugOrId: input.slugOrId,
+    baseUrl: input.baseUrl,
+    ...input.locale ? { locale: input.locale } : {}
+  });
+  return post ? { kind: "post", post } : { kind: "missing" };
+}
 async function RootTaleBlogPost(props) {
   const {
     apiKey,
     slugOrId,
+    previewToken,
+    previewExpiredElement,
     baseUrl,
     notFoundElement,
     showTitle = true,
@@ -1556,14 +1591,18 @@ async function RootTaleBlogPost(props) {
     authorHref = defaultAuthorHref,
     breadcrumb
   } = props;
-  const [post, themeStyle, blogSettings] = await Promise.all([
-    fetchPost({ apiKey, slugOrId, baseUrl, ...locale ? { locale } : {} }),
+  const [lookup, themeStyle, blogSettings] = await Promise.all([
+    lookupPost({ apiKey, baseUrl, slugOrId, previewToken, locale }),
     resolveThemeStyleFailSoft({ themeProp, apiKey, baseUrl }),
     fetchBlogSettingsFailSoft({ apiKey, baseUrl })
   ]);
-  if (!post) {
+  if (lookup.kind === "preview-expired") {
+    return previewExpiredElement ?? /* @__PURE__ */ jsx17("div", { "data-roottale-cms": "post-preview-expired", style: themeStyle ?? void 0, children: /* @__PURE__ */ jsx17("p", { className: "rt-cms-empty", children: t(locale, "previewExpired") }) });
+  }
+  if (lookup.kind === "missing") {
     return notFoundElement ?? /* @__PURE__ */ jsx17("div", { "data-roottale-cms": "post-missing", style: themeStyle ?? void 0, children: /* @__PURE__ */ jsx17("p", { className: "rt-cms-empty", children: t(locale, "postNotFound") }) });
   }
+  const post = lookup.post;
   const display = resolvePostDisplay2(post, blogSettings, {
     showTableOfContents,
     tableOfContentsTitle
@@ -1703,9 +1742,32 @@ async function RootTaleBlogPost(props) {
   );
 }
 
+// src/server/preview-notice.tsx
+import { jsx as jsx18, jsxs as jsxs14 } from "react/jsx-runtime";
+function formatExpiry(locale, iso) {
+  const date = new Date(iso);
+  if (Number.isNaN(date.getTime())) return null;
+  const time = new Intl.DateTimeFormat(locale === "en" ? "en-US" : "ko-KR", {
+    hour: "2-digit",
+    minute: "2-digit"
+  }).format(date);
+  return locale === "en" ? `Valid until ${time}.` : `${time}\uAE4C\uC9C0 \uBCFC \uC218 \uC788\uC5B4\uC694.`;
+}
+function RootTalePreviewNotice({
+  locale,
+  message,
+  expiresAt
+}) {
+  const expiry = expiresAt ? formatExpiry(locale, expiresAt) : null;
+  return /* @__PURE__ */ jsxs14("div", { "data-roottale-cms": "preview-notice", className: "rt-cms-preview-notice", role: "status", children: [
+    /* @__PURE__ */ jsx18("span", { children: message ?? t(locale, "previewNotice") }),
+    expiry ? /* @__PURE__ */ jsx18("span", { className: "rt-cms-preview-notice__expiry", children: expiry }) : null
+  ] });
+}
+
 // src/server/page.tsx
 import { fetchPost as fetchPost2 } from "@roottale/cms-client/server";
-import { jsx as jsx18, jsxs as jsxs14 } from "react/jsx-runtime";
+import { jsx as jsx19, jsxs as jsxs15 } from "react/jsx-runtime";
 async function RootTalePage(props) {
   const {
     apiKey,
@@ -1722,19 +1784,19 @@ async function RootTalePage(props) {
     resolveThemeStyleFailSoft({ themeProp, apiKey, baseUrl })
   ]);
   if (!post) {
-    return notFoundElement ?? /* @__PURE__ */ jsx18("div", { "data-roottale-cms": "page-missing", style: themeStyle ?? void 0, children: /* @__PURE__ */ jsx18("p", { className: "rt-cms-empty", children: t(locale, "pageNotFound") }) });
+    return notFoundElement ?? /* @__PURE__ */ jsx19("div", { "data-roottale-cms": "page-missing", style: themeStyle ?? void 0, children: /* @__PURE__ */ jsx19("p", { className: "rt-cms-empty", children: t(locale, "pageNotFound") }) });
   }
   const pageBodySource = resolvePostBodySource(post.bodyHtml);
   const bodyJson = pageBodySource.kind === "json" && prepareBody ? await prepareBody(post.bodyJson) : post.bodyJson;
-  return /* @__PURE__ */ jsxs14(
+  return /* @__PURE__ */ jsxs15(
     "article",
     {
       "data-roottale-cms": "page",
       className: "rt-cms-article",
       style: themeStyle ?? void 0,
       children: [
-        showTitle ? /* @__PURE__ */ jsx18("header", { className: "rt-cms-post-header", children: /* @__PURE__ */ jsx18("h1", { className: "rt-cms-title", children: post.title }) }) : null,
-        /* @__PURE__ */ jsx18("div", { "data-roottale-cms": "body", className: "rt-cms-body", children: pageBodySource.kind === "html" ? /* @__PURE__ */ jsx18("div", { dangerouslySetInnerHTML: { __html: pageBodySource.html } }) : /* @__PURE__ */ jsx18(
+        showTitle ? /* @__PURE__ */ jsx19("header", { className: "rt-cms-post-header", children: /* @__PURE__ */ jsx19("h1", { className: "rt-cms-title", children: post.title }) }) : null,
+        /* @__PURE__ */ jsx19("div", { "data-roottale-cms": "body", className: "rt-cms-body", children: pageBodySource.kind === "html" ? /* @__PURE__ */ jsx19("div", { dangerouslySetInnerHTML: { __html: pageBodySource.html } }) : /* @__PURE__ */ jsx19(
           RenderTiptap,
           {
             doc: bodyJson,
@@ -1750,7 +1812,7 @@ async function RootTalePage(props) {
 
 // src/server/exposure-slot.tsx
 import { fetchExposure } from "@roottale/cms-client/server";
-import { jsx as jsx19 } from "react/jsx-runtime";
+import { jsx as jsx20 } from "react/jsx-runtime";
 async function RootTaleExposureSlot(props) {
   const campaign = await fetchExposure({
     apiKey: props.apiKey,
@@ -1761,7 +1823,7 @@ async function RootTaleExposureSlot(props) {
     revalidate: props.revalidate
   });
   if (!campaign || !props.allowedVariants.includes(campaign.content.variant)) return null;
-  return /* @__PURE__ */ jsx19(RootTaleExposure, { campaign, allowedVariants: props.allowedVariants });
+  return /* @__PURE__ */ jsx20(RootTaleExposure, { campaign, allowedVariants: props.allowedVariants });
 }
 export {
   RenderTiptap,
@@ -1774,6 +1836,7 @@ export {
   RootTaleLeadForm,
   RootTalePage,
   RootTalePostCard,
+  RootTalePreviewNotice,
   RootTaleTableOfContents,
   RootTaleThemeProvider,
   attachHeadingIds,
@@ -1783,6 +1846,7 @@ export {
   extractToc,
   filterPostsByCategory,
   headingToId,
+  makeCategoryHref,
   renderBlock,
   renderBlocks,
   renderBoundBlocks,