@roottale/cms-core 0.62.0 → 0.64.0

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # @roottale/cms-core
 
+## 0.64.0
+
+## 0.63.0
+
+### Minor Changes
+
+- a858d8e: 목차 배치를 사이트 코드의 `RootTaleBlogPost.tocPosition`으로 관리할 수 있습니다.
+  명시한 값은 CMS 설정보다 우선하며, 생략한 기존 연동은 CMS 배치를 유지합니다.
+  현재 배치를 prop으로 명시하면 실제 화면을 바꾸지 않고 관리 주체를 코드로 옮깁니다.
+
+  공통 블록 디자인은 `RootTaleBlogPost.footerPatternPresentation`과
+  `RootTalePostPattern.presentation`으로 전체 대체할 수 있습니다. `null`은 원격
+  디자인 주입을 생략하고 사이트 CSS에 맡기며, 생략한 기존 연동은 원격값을 유지합니다.
+  고객 콘텐츠와 제작 디자인을 분리하는 문서·발행/미리보기 예제를 함께 갱신합니다.
+
+  공개 `RootTaleCssVars` 타입의 비공개 UI 패키지 참조도 제거해 독립 소비자의
+  strict 타입 검사를 지원합니다.
+
+  섹션 구성·디자인 변경 검사 함수를 공개 CMS core에서 공유해 편집기와 저장 단계가
+  같은 고객 편집 경계를 적용합니다.
+
 ## 0.62.0
 
 ## 0.61.1

package/dist/index.cjs

@@ -71,7 +71,9 @@ __export(src_exports, {
   extractFaqEntries: () => extractFaqEntries,
   faqPageJsonLd: () => faqPageJsonLd,
   findInternalContentLinkTokens: () => findInternalContentLinkTokens,
+  findSectionLockViolations: () => findSectionLockViolations,
   findSitePatternPlacementRule: () => findSitePatternPlacementRule,
+  formatSectionLockViolations: () => formatSectionLockViolations,
   htmlToPlainText: () => htmlToPlainText,
   injectStableIdsTree: () => injectStableIdsTree,
   internalContentKeyFromPath: () => internalContentKeyFromPath,
@@ -80,6 +82,7 @@ __export(src_exports, {
   isAllowedEmbedSrc: () => isAllowedEmbedSrc,
   isAllowedMapEmbedSrc: () => isAllowedMapEmbedSrc,
   isInCollectionMode: () => isInCollectionMode,
+  isSectionContentPropPath: () => isSectionContentPropPath,
   isSitePatternSlotKey: () => isSitePatternSlotKey,
   isValidBlock: () => isValidBlock,
   isValidSitePatternKey: () => isValidSitePatternKey,
@@ -1721,6 +1724,244 @@ function cmsImageStyle(attrs) {
     } : {}
   };
 }
+
+// src/section-locks.ts
+var CONTENT_PROP_PATHS = {
+  hero: [
+    ["eyebrow"],
+    ["title"],
+    ["description"],
+    ["imageSrc"],
+    ["imageAlt"],
+    ["cta", "label"],
+    ["cta", "href"]
+  ],
+  "rich-text": [["heading"], ["body"]],
+  services: [
+    ["heading"],
+    ["description"],
+    ["items", Number.NaN, "title"],
+    ["items", Number.NaN, "description"],
+    ["items", Number.NaN, "href"]
+  ],
+  faq: [
+    ["heading"],
+    ["items", Number.NaN, "question"],
+    ["items", Number.NaN, "answer"]
+  ],
+  "cta-banner": [["title"], ["description"], ["cta", "label"], ["cta", "href"]],
+  "blog-list": [["heading"], ["emptyMessage"]],
+  "lead-form": [["heading"], ["description"], ["submitLabel"]],
+  trust: [
+    ["heading"],
+    ["metrics", Number.NaN, "value"],
+    ["metrics", Number.NaN, "unit"],
+    ["metrics", Number.NaN, "label"],
+    ["metrics", Number.NaN, "source"],
+    ["credentials", Number.NaN, "name"],
+    ["credentials", Number.NaN, "issuer"],
+    ["credentials", Number.NaN, "kind"],
+    ["credentials", Number.NaN, "image"],
+    ["logos", Number.NaN, "src"],
+    ["logos", Number.NaN, "alt"],
+    ["logos", Number.NaN, "href"],
+    ["disclaimer"]
+  ],
+  contact: [
+    ["heading"],
+    ["form", "enabled"],
+    ["phone"],
+    ["address"],
+    ["hours", Number.NaN, "day"],
+    ["hours", Number.NaN, "open"],
+    ["hours", Number.NaN, "close"],
+    ["hours", Number.NaN, "note"],
+    ["mapEmbedUrl"]
+  ],
+  expertise: [
+    ["heading"],
+    ["description"],
+    ["items", Number.NaN, "label"],
+    ["items", Number.NaN, "kicker"],
+    ["items", Number.NaN, "title"],
+    ["items", Number.NaN, "body"],
+    ["items", Number.NaN, "imageSrc"],
+    ["items", Number.NaN, "imageAlt"],
+    ["items", Number.NaN, "tags", Number.NaN],
+    ["items", Number.NaN, "href"],
+    ["items", Number.NaN, "ctaLabel"]
+  ],
+  spaces: [
+    ["heading"],
+    ["description"],
+    ["spaces", Number.NaN, "label"],
+    ["spaces", Number.NaN, "kicker"],
+    ["spaces", Number.NaN, "title"],
+    ["spaces", Number.NaN, "description"],
+    ["spaces", Number.NaN, "imageSrc"],
+    ["spaces", Number.NaN, "imageAlt"],
+    ["spaces", Number.NaN, "tags", Number.NaN],
+    ["disclaimer"]
+  ],
+  concerns: [
+    ["heading"],
+    ["description"],
+    ["figureImage"],
+    ["figureAlt"],
+    ["regions", Number.NaN, "label"],
+    ["regions", Number.NaN, "title"],
+    ["regions", Number.NaN, "description"],
+    ["regions", Number.NaN, "items", Number.NaN],
+    ["regions", Number.NaN, "href"],
+    ["regions", Number.NaN, "ctaLabel"],
+    ["disclaimer"]
+  ]
+};
+function valueEquals(left, right) {
+  return JSON.stringify(left) === JSON.stringify(right);
+}
+function isRecord2(value) {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function collectChangedPaths(before, after, prefix = []) {
+  if (valueEquals(before, after)) return [];
+  if (Array.isArray(before) && Array.isArray(after)) {
+    if (before.length !== after.length) return [prefix];
+    return before.flatMap(
+      (item, index) => collectChangedPaths(item, after[index], [...prefix, index])
+    );
+  }
+  if ((isRecord2(before) || before == null) && (isRecord2(after) || after == null)) {
+    const beforeRecord = isRecord2(before) ? before : {};
+    const afterRecord = isRecord2(after) ? after : {};
+    const keys = /* @__PURE__ */ new Set([...Object.keys(beforeRecord), ...Object.keys(afterRecord)]);
+    if (keys.size === 0) return [prefix];
+    return [...keys].flatMap(
+      (key) => collectChangedPaths(beforeRecord[key], afterRecord[key], [...prefix, key])
+    );
+  }
+  return [prefix];
+}
+function contentPathMatches(pattern, path) {
+  if (pattern.length !== path.length) return false;
+  return pattern.every((segment, index) => {
+    const actual = path[index];
+    return Number.isNaN(segment) ? typeof actual === "number" : segment === actual;
+  });
+}
+function isSectionContentPropPath(sectionType, path) {
+  const patterns = CONTENT_PROP_PATHS[sectionType] ?? [];
+  return patterns.some((pattern) => contentPathMatches(pattern, path));
+}
+function collectSectionSnapshots(doc) {
+  const sections = [];
+  function visit(node, path) {
+    if (!isRecord2(node)) return;
+    if (node.type === "section") {
+      const attrs = isRecord2(node.attrs) ? node.attrs : {};
+      sections.push({
+        id: typeof attrs._id === "string" ? attrs._id : "",
+        path,
+        sectionType: typeof attrs.sectionType === "string" ? attrs.sectionType : "",
+        attrs,
+        props: attrs.props ?? {}
+      });
+    }
+    if (Array.isArray(node.content)) {
+      node.content.forEach((child, index) => visit(child, `${path}.${index}`));
+    }
+  }
+  visit(doc, "doc");
+  return sections;
+}
+function findSectionLockViolations(beforeDoc, afterDoc) {
+  const before = collectSectionSnapshots(beforeDoc);
+  const after = collectSectionSnapshots(afterDoc);
+  const afterById = new Map(after.map((section) => [section.id, section]));
+  const beforeById = new Map(before.map((section) => [section.id, section]));
+  const violations = [];
+  for (const sections of [before, after]) {
+    const ids = /* @__PURE__ */ new Set();
+    for (const section of sections) {
+      if (!section.id || ids.has(section.id)) {
+        violations.push({
+          code: "locked_section_structure_changed",
+          sectionId: section.id,
+          sectionType: section.sectionType,
+          field: "_id"
+        });
+      }
+      ids.add(section.id);
+    }
+  }
+  for (const section of before) {
+    const next = afterById.get(section.id);
+    if (!next) {
+      violations.push({
+        code: "locked_section_removed",
+        sectionId: section.id,
+        sectionType: section.sectionType,
+        field: "(node)"
+      });
+      continue;
+    }
+    if (section.path !== next.path) {
+      violations.push({
+        code: "locked_section_moved",
+        sectionId: section.id,
+        sectionType: section.sectionType,
+        field: "(index)"
+      });
+    }
+    const fields = /* @__PURE__ */ new Set([
+      ...Object.keys(section.attrs),
+      ...Object.keys(next.attrs)
+    ]);
+    fields.delete("props");
+    for (const field of fields) {
+      if (!valueEquals(section.attrs[field], next.attrs[field])) {
+        violations.push({
+          code: field === "lock" ? "locked_section_lock_changed" : "locked_section_structure_changed",
+          sectionId: section.id,
+          sectionType: section.sectionType,
+          field
+        });
+      }
+    }
+    for (const path of collectChangedPaths(section.props, next.props)) {
+      if (!isSectionContentPropPath(section.sectionType, path)) {
+        violations.push({
+          code: "locked_section_structure_changed",
+          sectionId: section.id,
+          sectionType: section.sectionType,
+          field: `props.${path.join(".") || "(root)"}`
+        });
+      }
+    }
+  }
+  for (const section of after) {
+    if (beforeById.has(section.id)) continue;
+    violations.push({
+      code: "locked_section_inserted",
+      sectionId: section.id,
+      sectionType: section.sectionType,
+      field: "(node)"
+    });
+  }
+  return violations;
+}
+function formatSectionLockViolations(violations) {
+  return violations.map((violation) => {
+    const label = `${violation.sectionType || "section"} \uC139\uC158(${violation.sectionId})`;
+    if (violation.code === "locked_section_inserted") return `${label} \uCD94\uAC00`;
+    if (violation.code === "locked_section_removed") return `${label} \uC0AD\uC81C`;
+    if (violation.code === "locked_section_moved") return `${label} \uC774\uB3D9`;
+    if (violation.code === "locked_section_lock_changed") {
+      return `${label} \uC7A0\uAE08 \uBCC0\uACBD`;
+    }
+    return `${label} \uAD6C\uC870 \uBCC0\uACBD(${violation.field})`;
+  }).join(" / ");
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   BLOCK_NAME_PATTERN,
@@ -1764,7 +2005,9 @@ function cmsImageStyle(attrs) {
   extractFaqEntries,
   faqPageJsonLd,
   findInternalContentLinkTokens,
+  findSectionLockViolations,
   findSitePatternPlacementRule,
+  formatSectionLockViolations,
   htmlToPlainText,
   injectStableIdsTree,
   internalContentKeyFromPath,
@@ -1773,6 +2016,7 @@ function cmsImageStyle(attrs) {
   isAllowedEmbedSrc,
   isAllowedMapEmbedSrc,
   isInCollectionMode,
+  isSectionContentPropPath,
   isSitePatternSlotKey,
   isValidBlock,
   isValidSitePatternKey,