@roottale/cms-core 0.57.0 → 0.58.0

package/dist/index.d.cts

@@ -543,5 +543,32 @@ declare function resolvePatternSlots(post: {
  * 삭제 전 경고할 때 쓴다.
  */
 declare function referencedSitePatternKeys(placements: SitePatternPlacements): ReadonlySet<string>;
+type SitePatternLayout = "plain" | "card";
+type SitePatternLinkStyle = "text" | "buttons";
+interface SitePatternPresentation {
+    /** `plain` = 본문처럼 흐름에 놓임, `card` = 배경색이 있는 카드. */
+    readonly layout: SitePatternLayout;
+    /** 카드 배경색(hex). layout 이 card 일 때만 의미. */
+    readonly background: string;
+    /** 마지막 문단의 링크를 버튼으로 그릴지. */
+    readonly linkStyle: SitePatternLinkStyle;
+    /** 버튼 배경색(hex, 순서대로 1·2·3…; 링크가 더 많으면 마지막 색을 반복). 글자는 흰색. */
+    readonly buttonColors: readonly string[];
+}
+declare const DEFAULT_SITE_PATTERN_PRESENTATION: SitePatternPresentation;
+declare const SITE_PATTERN_BUTTON_COLORS_MAX = 4;
+declare function normalizeHexColor(value: unknown): string | null;
+/** 저장된 값(unknown) → 표시 형태. 틀린 값은 기본값으로 채운다(절대 throw 하지 않음). */
+declare function readSitePatternPresentation(raw: unknown): SitePatternPresentation;
+/** 버튼 n번째(0부터)의 색 — 링크가 색 개수보다 많으면 마지막 색을 반복. */
+declare function sitePatternButtonColor(presentation: SitePatternPresentation, index: number): string;
+/**
+ * FRONT 가 래퍼 요소에 얹을 data 속성과 CSS 변수. 사이트 CSS 는 이 변수만 읽는다 —
+ * `data-pattern-layout`·`data-pattern-link-style`, `--rt-pattern-bg`, `--rt-pattern-btn-1..n`.
+ */
+declare function sitePatternPresentationAttributes(presentation: SitePatternPresentation): {
+    readonly dataset: Readonly<Record<string, string>>;
+    readonly cssVariables: Readonly<Record<string, string>>;
+};
 
-export { BLOCK_NAME_PATTERN, type BindingResolver, type Block, type BlockBinding, type BlockDefinition, type BlockRegistry, type CategoryTreeEntry, type CategoryTreePresentation, type CategoryTreeTerm, type ClientHydrationSpec, EMPTY_SITE_PATTERN_PLACEMENTS, type EmbedProvider, FIELD_BINDING_SOURCE, FIELD_BINDING_SOURCE_ALIAS, type FaqEntry, IMAGE_ALT_MAX_LENGTH, INTERNAL_CONTENT_LINK_CLASS, INTERNAL_CONTENT_LINK_PENDING_ATTR, INTERNAL_CONTENT_LINK_PENDING_CLASS, INTERNAL_CONTENT_LINK_TOKEN_SOURCE, type InternalContentLinkResolver, type InternalContentLinkToken, LEGACY_BLOG_DETAIL_PATH, type NormalizedEmbed, PHASE_1_CORE_BLOCKS, PHASE_1_CSP, POST_FOOTER_SLOT, type PatternSlots, type Phase1CoreBlockName, type PreviewTokenPayload, type PublicPathContext, type PublicPathPost, type PublicPathPresentation, type RoutablePost, type RouteCollection, SITE_PATTERN_KEY_PATTERN, SITE_PATTERN_PLACEMENTS_KEY, SITE_PATTERN_SLOTS, type SitePatternPlacementRule, type SitePatternPlacements, type SitePatternSlotKey, applyBlockBindings, bindingSrcValue, bindingTextValue, blockSchema, boundFieldValue, chainResolvers, createFieldBindingResolver, emptyPatternSlots, ensureImportedHtmlDocumentRoots, ensureStableIds, extractFaqEntries, faqPageJsonLd, findInternalContentLinkTokens, findSitePatternPlacementRule, htmlToPlainText, injectStableIdsTree, internalContentKeyFromPath, internalContentLinkResolverFrom, internalContentPathIndex, isAllowedEmbedSrc, isAllowedMapEmbedSrc, isInCollectionMode, isSitePatternSlotKey, isValidBlock, isValidSitePatternKey, issuePreviewToken, normalizeEmbed, normalizeImageAlt, parseBlock, postsForCollection, postsInAnyCollection, postsNotInAnyCollection, readSitePatternPlacements, referencedSitePatternKeys, renderInternalContentLinksInHtml, renderInternalContentLinksInText, resolveCategoryPath, resolveCategoryTreeChain, resolveCategoryTreeEntryPath, resolveCategoryTreeHubPaths, resolvePatternSlots, resolvePostCategorySlug, resolvePostCollection, resolvePostPath, resolvePostPublicPath, resolvePostUrl, sanitizeHtml, sanitizeImportedCss, sanitizeImportedHtml, scopeImportedCss, serializeBlock, setSitePatternPlacementRule, validateCollections, verifyPreviewToken };
+export { BLOCK_NAME_PATTERN, type BindingResolver, type Block, type BlockBinding, type BlockDefinition, type BlockRegistry, type CategoryTreeEntry, type CategoryTreePresentation, type CategoryTreeTerm, type ClientHydrationSpec, DEFAULT_SITE_PATTERN_PRESENTATION, EMPTY_SITE_PATTERN_PLACEMENTS, type EmbedProvider, FIELD_BINDING_SOURCE, FIELD_BINDING_SOURCE_ALIAS, type FaqEntry, IMAGE_ALT_MAX_LENGTH, INTERNAL_CONTENT_LINK_CLASS, INTERNAL_CONTENT_LINK_PENDING_ATTR, INTERNAL_CONTENT_LINK_PENDING_CLASS, INTERNAL_CONTENT_LINK_TOKEN_SOURCE, type InternalContentLinkResolver, type InternalContentLinkToken, LEGACY_BLOG_DETAIL_PATH, type NormalizedEmbed, PHASE_1_CORE_BLOCKS, PHASE_1_CSP, POST_FOOTER_SLOT, type PatternSlots, type Phase1CoreBlockName, type PreviewTokenPayload, type PublicPathContext, type PublicPathPost, type PublicPathPresentation, type RoutablePost, type RouteCollection, SITE_PATTERN_BUTTON_COLORS_MAX, SITE_PATTERN_KEY_PATTERN, SITE_PATTERN_PLACEMENTS_KEY, SITE_PATTERN_SLOTS, type SitePatternLayout, type SitePatternLinkStyle, type SitePatternPlacementRule, type SitePatternPlacements, type SitePatternPresentation, type SitePatternSlotKey, applyBlockBindings, bindingSrcValue, bindingTextValue, blockSchema, boundFieldValue, chainResolvers, createFieldBindingResolver, emptyPatternSlots, ensureImportedHtmlDocumentRoots, ensureStableIds, extractFaqEntries, faqPageJsonLd, findInternalContentLinkTokens, findSitePatternPlacementRule, htmlToPlainText, injectStableIdsTree, internalContentKeyFromPath, internalContentLinkResolverFrom, internalContentPathIndex, isAllowedEmbedSrc, isAllowedMapEmbedSrc, isInCollectionMode, isSitePatternSlotKey, isValidBlock, isValidSitePatternKey, issuePreviewToken, normalizeEmbed, normalizeHexColor, normalizeImageAlt, parseBlock, postsForCollection, postsInAnyCollection, postsNotInAnyCollection, readSitePatternPlacements, readSitePatternPresentation, referencedSitePatternKeys, renderInternalContentLinksInHtml, renderInternalContentLinksInText, resolveCategoryPath, resolveCategoryTreeChain, resolveCategoryTreeEntryPath, resolveCategoryTreeHubPaths, resolvePatternSlots, resolvePostCategorySlug, resolvePostCollection, resolvePostPath, resolvePostPublicPath, resolvePostUrl, sanitizeHtml, sanitizeImportedCss, sanitizeImportedHtml, scopeImportedCss, serializeBlock, setSitePatternPlacementRule, sitePatternButtonColor, sitePatternPresentationAttributes, validateCollections, verifyPreviewToken };

package/dist/index.d.ts

@@ -543,5 +543,32 @@ declare function resolvePatternSlots(post: {
  * 삭제 전 경고할 때 쓴다.
  */
 declare function referencedSitePatternKeys(placements: SitePatternPlacements): ReadonlySet<string>;
+type SitePatternLayout = "plain" | "card";
+type SitePatternLinkStyle = "text" | "buttons";
+interface SitePatternPresentation {
+    /** `plain` = 본문처럼 흐름에 놓임, `card` = 배경색이 있는 카드. */
+    readonly layout: SitePatternLayout;
+    /** 카드 배경색(hex). layout 이 card 일 때만 의미. */
+    readonly background: string;
+    /** 마지막 문단의 링크를 버튼으로 그릴지. */
+    readonly linkStyle: SitePatternLinkStyle;
+    /** 버튼 배경색(hex, 순서대로 1·2·3…; 링크가 더 많으면 마지막 색을 반복). 글자는 흰색. */
+    readonly buttonColors: readonly string[];
+}
+declare const DEFAULT_SITE_PATTERN_PRESENTATION: SitePatternPresentation;
+declare const SITE_PATTERN_BUTTON_COLORS_MAX = 4;
+declare function normalizeHexColor(value: unknown): string | null;
+/** 저장된 값(unknown) → 표시 형태. 틀린 값은 기본값으로 채운다(절대 throw 하지 않음). */
+declare function readSitePatternPresentation(raw: unknown): SitePatternPresentation;
+/** 버튼 n번째(0부터)의 색 — 링크가 색 개수보다 많으면 마지막 색을 반복. */
+declare function sitePatternButtonColor(presentation: SitePatternPresentation, index: number): string;
+/**
+ * FRONT 가 래퍼 요소에 얹을 data 속성과 CSS 변수. 사이트 CSS 는 이 변수만 읽는다 —
+ * `data-pattern-layout`·`data-pattern-link-style`, `--rt-pattern-bg`, `--rt-pattern-btn-1..n`.
+ */
+declare function sitePatternPresentationAttributes(presentation: SitePatternPresentation): {
+    readonly dataset: Readonly<Record<string, string>>;
+    readonly cssVariables: Readonly<Record<string, string>>;
+};
 
-export { BLOCK_NAME_PATTERN, type BindingResolver, type Block, type BlockBinding, type BlockDefinition, type BlockRegistry, type CategoryTreeEntry, type CategoryTreePresentation, type CategoryTreeTerm, type ClientHydrationSpec, EMPTY_SITE_PATTERN_PLACEMENTS, type EmbedProvider, FIELD_BINDING_SOURCE, FIELD_BINDING_SOURCE_ALIAS, type FaqEntry, IMAGE_ALT_MAX_LENGTH, INTERNAL_CONTENT_LINK_CLASS, INTERNAL_CONTENT_LINK_PENDING_ATTR, INTERNAL_CONTENT_LINK_PENDING_CLASS, INTERNAL_CONTENT_LINK_TOKEN_SOURCE, type InternalContentLinkResolver, type InternalContentLinkToken, LEGACY_BLOG_DETAIL_PATH, type NormalizedEmbed, PHASE_1_CORE_BLOCKS, PHASE_1_CSP, POST_FOOTER_SLOT, type PatternSlots, type Phase1CoreBlockName, type PreviewTokenPayload, type PublicPathContext, type PublicPathPost, type PublicPathPresentation, type RoutablePost, type RouteCollection, SITE_PATTERN_KEY_PATTERN, SITE_PATTERN_PLACEMENTS_KEY, SITE_PATTERN_SLOTS, type SitePatternPlacementRule, type SitePatternPlacements, type SitePatternSlotKey, applyBlockBindings, bindingSrcValue, bindingTextValue, blockSchema, boundFieldValue, chainResolvers, createFieldBindingResolver, emptyPatternSlots, ensureImportedHtmlDocumentRoots, ensureStableIds, extractFaqEntries, faqPageJsonLd, findInternalContentLinkTokens, findSitePatternPlacementRule, htmlToPlainText, injectStableIdsTree, internalContentKeyFromPath, internalContentLinkResolverFrom, internalContentPathIndex, isAllowedEmbedSrc, isAllowedMapEmbedSrc, isInCollectionMode, isSitePatternSlotKey, isValidBlock, isValidSitePatternKey, issuePreviewToken, normalizeEmbed, normalizeImageAlt, parseBlock, postsForCollection, postsInAnyCollection, postsNotInAnyCollection, readSitePatternPlacements, referencedSitePatternKeys, renderInternalContentLinksInHtml, renderInternalContentLinksInText, resolveCategoryPath, resolveCategoryTreeChain, resolveCategoryTreeEntryPath, resolveCategoryTreeHubPaths, resolvePatternSlots, resolvePostCategorySlug, resolvePostCollection, resolvePostPath, resolvePostPublicPath, resolvePostUrl, sanitizeHtml, sanitizeImportedCss, sanitizeImportedHtml, scopeImportedCss, serializeBlock, setSitePatternPlacementRule, validateCollections, verifyPreviewToken };
+export { BLOCK_NAME_PATTERN, type BindingResolver, type Block, type BlockBinding, type BlockDefinition, type BlockRegistry, type CategoryTreeEntry, type CategoryTreePresentation, type CategoryTreeTerm, type ClientHydrationSpec, DEFAULT_SITE_PATTERN_PRESENTATION, EMPTY_SITE_PATTERN_PLACEMENTS, type EmbedProvider, FIELD_BINDING_SOURCE, FIELD_BINDING_SOURCE_ALIAS, type FaqEntry, IMAGE_ALT_MAX_LENGTH, INTERNAL_CONTENT_LINK_CLASS, INTERNAL_CONTENT_LINK_PENDING_ATTR, INTERNAL_CONTENT_LINK_PENDING_CLASS, INTERNAL_CONTENT_LINK_TOKEN_SOURCE, type InternalContentLinkResolver, type InternalContentLinkToken, LEGACY_BLOG_DETAIL_PATH, type NormalizedEmbed, PHASE_1_CORE_BLOCKS, PHASE_1_CSP, POST_FOOTER_SLOT, type PatternSlots, type Phase1CoreBlockName, type PreviewTokenPayload, type PublicPathContext, type PublicPathPost, type PublicPathPresentation, type RoutablePost, type RouteCollection, SITE_PATTERN_BUTTON_COLORS_MAX, SITE_PATTERN_KEY_PATTERN, SITE_PATTERN_PLACEMENTS_KEY, SITE_PATTERN_SLOTS, type SitePatternLayout, type SitePatternLinkStyle, type SitePatternPlacementRule, type SitePatternPlacements, type SitePatternPresentation, type SitePatternSlotKey, applyBlockBindings, bindingSrcValue, bindingTextValue, blockSchema, boundFieldValue, chainResolvers, createFieldBindingResolver, emptyPatternSlots, ensureImportedHtmlDocumentRoots, ensureStableIds, extractFaqEntries, faqPageJsonLd, findInternalContentLinkTokens, findSitePatternPlacementRule, htmlToPlainText, injectStableIdsTree, internalContentKeyFromPath, internalContentLinkResolverFrom, internalContentPathIndex, isAllowedEmbedSrc, isAllowedMapEmbedSrc, isInCollectionMode, isSitePatternSlotKey, isValidBlock, isValidSitePatternKey, issuePreviewToken, normalizeEmbed, normalizeHexColor, normalizeImageAlt, parseBlock, postsForCollection, postsInAnyCollection, postsNotInAnyCollection, readSitePatternPlacements, readSitePatternPresentation, referencedSitePatternKeys, renderInternalContentLinksInHtml, renderInternalContentLinksInText, resolveCategoryPath, resolveCategoryTreeChain, resolveCategoryTreeEntryPath, resolveCategoryTreeHubPaths, resolvePatternSlots, resolvePostCategorySlug, resolvePostCollection, resolvePostPath, resolvePostPublicPath, resolvePostUrl, sanitizeHtml, sanitizeImportedCss, sanitizeImportedHtml, scopeImportedCss, serializeBlock, setSitePatternPlacementRule, sitePatternButtonColor, sitePatternPresentationAttributes, validateCollections, verifyPreviewToken };

package/dist/index.js

@@ -1503,8 +1503,62 @@ function referencedSitePatternKeys(placements) {
     placements.rules.map((rule) => rule.patternKey).filter((key) => key !== null)
   );
 }
+var DEFAULT_SITE_PATTERN_PRESENTATION = {
+  layout: "plain",
+  background: "#f8f9fa",
+  linkStyle: "text",
+  buttonColors: ["#03c75a", "#1a1a1a", "#666666"]
+};
+var SITE_PATTERN_BUTTON_COLORS_MAX = 4;
+var HEX_COLOR_RE2 = /^#[0-9a-f]{6}$/;
+function normalizeHexColor(value) {
+  if (typeof value !== "string") return null;
+  let hex = value.trim().toLowerCase();
+  if (/^#[0-9a-f]{3}$/.test(hex)) hex = `#${hex[1]}${hex[1]}${hex[2]}${hex[2]}${hex[3]}${hex[3]}`;
+  return HEX_COLOR_RE2.test(hex) ? hex : null;
+}
+function readSitePatternPresentation(raw) {
+  let value = raw;
+  if (typeof value === "string") {
+    try {
+      value = JSON.parse(value);
+    } catch {
+      value = null;
+    }
+  }
+  const base = DEFAULT_SITE_PATTERN_PRESENTATION;
+  if (!isRecord(value)) return base;
+  const layout = value.layout === "card" ? "card" : "plain";
+  const linkStyle = value.linkStyle === "buttons" ? "buttons" : "text";
+  const background = normalizeHexColor(value.background) ?? base.background;
+  const colors = Array.isArray(value.buttonColors) ? value.buttonColors.map(normalizeHexColor).filter((c) => c !== null).slice(0, SITE_PATTERN_BUTTON_COLORS_MAX) : [];
+  return {
+    layout,
+    background,
+    linkStyle,
+    buttonColors: colors.length > 0 ? colors : base.buttonColors
+  };
+}
+function sitePatternButtonColor(presentation, index) {
+  const colors = presentation.buttonColors;
+  return colors[Math.min(index, colors.length - 1)] ?? DEFAULT_SITE_PATTERN_PRESENTATION.buttonColors[0];
+}
+function sitePatternPresentationAttributes(presentation) {
+  const cssVariables = { "--rt-pattern-bg": presentation.background };
+  presentation.buttonColors.forEach((color, index) => {
+    cssVariables[`--rt-pattern-btn-${index + 1}`] = color;
+  });
+  return {
+    dataset: {
+      "data-pattern-layout": presentation.layout,
+      "data-pattern-link-style": presentation.linkStyle
+    },
+    cssVariables
+  };
+}
 export {
   BLOCK_NAME_PATTERN,
+  DEFAULT_SITE_PATTERN_PRESENTATION,
   EMPTY_SITE_PATTERN_PLACEMENTS,
   FIELD_BINDING_SOURCE,
   FIELD_BINDING_SOURCE_ALIAS,
@@ -1517,6 +1571,7 @@ export {
   PHASE_1_CORE_BLOCKS,
   PHASE_1_CSP,
   POST_FOOTER_SLOT,
+  SITE_PATTERN_BUTTON_COLORS_MAX,
   SITE_PATTERN_KEY_PATTERN,
   SITE_PATTERN_PLACEMENTS_KEY,
   SITE_PATTERN_SLOTS,
@@ -1547,12 +1602,14 @@ export {
   isValidSitePatternKey,
   issuePreviewToken,
   normalizeEmbed,
+  normalizeHexColor,
   normalizeImageAlt,
   parseBlock,
   postsForCollection,
   postsInAnyCollection,
   postsNotInAnyCollection,
   readSitePatternPlacements,
+  readSitePatternPresentation,
   referencedSitePatternKeys,
   renderInternalContentLinksInHtml,
   renderInternalContentLinksInText,
@@ -1572,6 +1629,8 @@ export {
   scopeImportedCss,
   serializeBlock,
   setSitePatternPlacementRule,
+  sitePatternButtonColor,
+  sitePatternPresentationAttributes,
   validateCollections,
   verifyPreviewToken
 };