@roottale/cms-core 0.57.0 → 0.58.0

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @roottale/cms-core
 
+## 0.58.0
+
+### Minor Changes
+
+- dd82c92: 공통 블록 표시 형태(presentation) — 블록의 모양(본문처럼/카드·배경색·링크 버튼·버튼 색)을 어드민이
+  정해 공개 API `presentation` 으로 내려준다. 사이트는 색·모양을 CSS 에 고정하지 않는다.
+  - `@roottale/cms-core`: `readSitePatternPresentation`·`sitePatternPresentationAttributes`·
+    `DEFAULT_SITE_PATTERN_PRESENTATION`.
+  - `@roottale/cms-client`: `CmsSitePattern.presentation`(구 서버는 기본값), `sitePatternPresentationAttributes`
+    (래퍼 data 속성 + `--rt-pattern-bg`·`--rt-pattern-btn-n` CSS 변수).
+  - `@roottale/cms-renderer-next`: `RootTaleBlogPost`·`RootTalePostPattern` 이 data 속성·변수를 얹고,
+    `cms-public.css` 가 카드/버튼 모양을 그 값으로만 그린다.
+
 ## 0.57.0
 
 ### Minor Changes

package/dist/index.cjs

@@ -31,6 +31,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var src_exports = {};
 __export(src_exports, {
   BLOCK_NAME_PATTERN: () => BLOCK_NAME_PATTERN,
+  DEFAULT_SITE_PATTERN_PRESENTATION: () => DEFAULT_SITE_PATTERN_PRESENTATION,
   EMPTY_SITE_PATTERN_PLACEMENTS: () => EMPTY_SITE_PATTERN_PLACEMENTS,
   FIELD_BINDING_SOURCE: () => FIELD_BINDING_SOURCE,
   FIELD_BINDING_SOURCE_ALIAS: () => FIELD_BINDING_SOURCE_ALIAS,
@@ -43,6 +44,7 @@ __export(src_exports, {
   PHASE_1_CORE_BLOCKS: () => PHASE_1_CORE_BLOCKS,
   PHASE_1_CSP: () => PHASE_1_CSP,
   POST_FOOTER_SLOT: () => POST_FOOTER_SLOT,
+  SITE_PATTERN_BUTTON_COLORS_MAX: () => SITE_PATTERN_BUTTON_COLORS_MAX,
   SITE_PATTERN_KEY_PATTERN: () => SITE_PATTERN_KEY_PATTERN,
   SITE_PATTERN_PLACEMENTS_KEY: () => SITE_PATTERN_PLACEMENTS_KEY,
   SITE_PATTERN_SLOTS: () => SITE_PATTERN_SLOTS,
@@ -73,12 +75,14 @@ __export(src_exports, {
   isValidSitePatternKey: () => isValidSitePatternKey,
   issuePreviewToken: () => issuePreviewToken,
   normalizeEmbed: () => normalizeEmbed,
+  normalizeHexColor: () => normalizeHexColor,
   normalizeImageAlt: () => normalizeImageAlt,
   parseBlock: () => parseBlock,
   postsForCollection: () => postsForCollection,
   postsInAnyCollection: () => postsInAnyCollection,
   postsNotInAnyCollection: () => postsNotInAnyCollection,
   readSitePatternPlacements: () => readSitePatternPlacements,
+  readSitePatternPresentation: () => readSitePatternPresentation,
   referencedSitePatternKeys: () => referencedSitePatternKeys,
   renderInternalContentLinksInHtml: () => renderInternalContentLinksInHtml,
   renderInternalContentLinksInText: () => renderInternalContentLinksInText,
@@ -98,6 +102,8 @@ __export(src_exports, {
   scopeImportedCss: () => scopeImportedCss,
   serializeBlock: () => serializeBlock,
   setSitePatternPlacementRule: () => setSitePatternPlacementRule,
+  sitePatternButtonColor: () => sitePatternButtonColor,
+  sitePatternPresentationAttributes: () => sitePatternPresentationAttributes,
   validateCollections: () => validateCollections,
   verifyPreviewToken: () => verifyPreviewToken
 });
@@ -1608,9 +1614,63 @@ 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
+  };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   BLOCK_NAME_PATTERN,
+  DEFAULT_SITE_PATTERN_PRESENTATION,
   EMPTY_SITE_PATTERN_PLACEMENTS,
   FIELD_BINDING_SOURCE,
   FIELD_BINDING_SOURCE_ALIAS,
@@ -1623,6 +1683,7 @@ function referencedSitePatternKeys(placements) {
   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,
@@ -1653,12 +1714,14 @@ function referencedSitePatternKeys(placements) {
   isValidSitePatternKey,
   issuePreviewToken,
   normalizeEmbed,
+  normalizeHexColor,
   normalizeImageAlt,
   parseBlock,
   postsForCollection,
   postsInAnyCollection,
   postsNotInAnyCollection,
   readSitePatternPlacements,
+  readSitePatternPresentation,
   referencedSitePatternKeys,
   renderInternalContentLinksInHtml,
   renderInternalContentLinksInText,
@@ -1678,6 +1741,8 @@ function referencedSitePatternKeys(placements) {
   scopeImportedCss,
   serializeBlock,
   setSitePatternPlacementRule,
+  sitePatternButtonColor,
+  sitePatternPresentationAttributes,
   validateCollections,
   verifyPreviewToken
 });