@roottale/cms-core 0.57.0 → 0.59.0

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # @roottale/cms-core
 
+## 0.59.0
+
+### Minor Changes
+
+- c0b3679: 공통 블록 배치 규칙의 유형 키를 컬렉션(`collectionKey`)에서 콘텐츠 모델(`modelKey`)로 바꾼다
+  (ADR-0109 Amendment 1 · ADR-0105). `SitePatternPlacementRule.modelKey`,
+  `findSitePatternPlacementRule`/`setSitePatternPlacementRule`/`resolvePatternSlots` 가 `modelKey` 를
+  받는다. 저장된 옛 규칙의 `collectionKey` 필드는 `readSitePatternPlacements` 가 `modelKey` 로 읽는다.
+  공개 API 응답 모양(`pattern_slots`)은 그대로이며, 계산 근거가 글의 `model_key` 로 바뀐다 —
+  컬렉션 설정이 없는 사이트 글·2단계 분류 모델(FAQ)·모델 key 와 컬렉션 key 가 다른 글도 유형별
+  규칙을 받는다. cms-mcp `api-reference.md` 의 `pattern_slots` 설명을 맞춘다.
+
+## 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
 });
@@ -1560,34 +1566,31 @@ function readSitePatternPlacements(raw) {
     if (!isRecord(item)) continue;
     const slot = typeof item.slot === "string" ? item.slot : "";
     if (!isSitePatternSlotKey(slot)) continue;
-    const collectionKey = readNullableKey(item.collectionKey);
-    if (collectionKey === void 0) continue;
+    const modelKey = readNullableKey(
+      item.modelKey === void 0 ? item.collectionKey : item.modelKey
+    );
+    if (modelKey === void 0) continue;
     const patternKey = readNullableKey(item.patternKey);
     if (patternKey === void 0) continue;
     if (patternKey !== null && !isValidSitePatternKey(patternKey)) continue;
-    byTarget.set(`${slot}\0${collectionKey ?? ""}`, {
+    byTarget.set(`${slot}\0${modelKey ?? ""}`, {
       slot,
-      collectionKey,
+      modelKey,
       patternKey
     });
   }
   return { rules: [...byTarget.values()] };
 }
-function findSitePatternPlacementRule(placements, slot, collectionKey) {
-  return placements.rules.find(
-    (rule) => rule.slot === slot && rule.collectionKey === collectionKey
-  );
+function findSitePatternPlacementRule(placements, slot, modelKey) {
+  return placements.rules.find((rule) => rule.slot === slot && rule.modelKey === modelKey);
 }
 function setSitePatternPlacementRule(placements, target, patternKey) {
   const rest = placements.rules.filter(
-    (rule) => !(rule.slot === target.slot && rule.collectionKey === target.collectionKey)
+    (rule) => !(rule.slot === target.slot && rule.modelKey === target.modelKey)
   );
   if (patternKey === void 0) return { rules: rest };
   return {
-    rules: [
-      ...rest,
-      { slot: target.slot, collectionKey: target.collectionKey, patternKey }
-    ]
+    rules: [...rest, { slot: target.slot, modelKey: target.modelKey, patternKey }]
   };
 }
 function emptyPatternSlots() {
@@ -1596,7 +1599,7 @@ function emptyPatternSlots() {
 function resolvePatternSlots(post, placements, publishedKeys) {
   const slots = emptyPatternSlots();
   for (const slot of SITE_PATTERN_SLOTS) {
-    const specific = post.collectionKey !== null ? findSitePatternPlacementRule(placements, slot.key, post.collectionKey) : void 0;
+    const specific = post.modelKey !== null ? findSitePatternPlacementRule(placements, slot.key, post.modelKey) : void 0;
     const rule = specific ?? findSitePatternPlacementRule(placements, slot.key, null);
     const key = rule?.patternKey ?? null;
     slots[slot.key] = key !== null && publishedKeys.has(key) ? key : null;
@@ -1608,9 +1611,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 +1680,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 +1711,14 @@ function referencedSitePatternKeys(placements) {
   isValidSitePatternKey,
   issuePreviewToken,
   normalizeEmbed,
+  normalizeHexColor,
   normalizeImageAlt,
   parseBlock,
   postsForCollection,
   postsInAnyCollection,
   postsNotInAnyCollection,
   readSitePatternPlacements,
+  readSitePatternPresentation,
   referencedSitePatternKeys,
   renderInternalContentLinksInHtml,
   renderInternalContentLinksInText,
@@ -1678,6 +1738,8 @@ function referencedSitePatternKeys(placements) {
   scopeImportedCss,
   serializeBlock,
   setSitePatternPlacementRule,
+  sitePatternButtonColor,
+  sitePatternPresentationAttributes,
   validateCollections,
   verifyPreviewToken
 });