@roottale/cms-core 0.53.1 → 0.56.0

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @roottale/cms-core
 
+## 0.56.0
+
+### Minor Changes
+
+- 9eb39e8: ADR-0105 개정 — 글의 정규 공개 경로 계산기 `resolvePostPublicPath` 를 추가합니다.
+  모델 presentation(fixed_page·detail·category_tree) → 호환 컬렉션 → 레거시 `/blog` 순서
+  하나로 계산하며, 플랫폼의 웹훅·사이트맵·단축링크·내부 링크 키·`posts.public_path`
+  물질화가 모두 이 함수를 씁니다.
+
+## 0.55.0
+
+## 0.54.0
+
+### Minor Changes
+
+- befa5bb: 콘텐츠 유형별 카테고리 주소와 카테고리 SEO 공개 필드에 더해, 1~3단계 부모·자식
+  분류로 목록·허브·상세 주소를 구성하는 범용 콘텐츠 모델 계약을 추가합니다.
+
 ## 0.53.1
 
 ### Patch Changes

package/dist/index.cjs

@@ -34,6 +34,7 @@ __export(src_exports, {
   FIELD_BINDING_SOURCE: () => FIELD_BINDING_SOURCE,
   FIELD_BINDING_SOURCE_ALIAS: () => FIELD_BINDING_SOURCE_ALIAS,
   IMAGE_ALT_MAX_LENGTH: () => IMAGE_ALT_MAX_LENGTH,
+  LEGACY_BLOG_DETAIL_PATH: () => LEGACY_BLOG_DETAIL_PATH,
   PHASE_1_CORE_BLOCKS: () => PHASE_1_CORE_BLOCKS,
   PHASE_1_CSP: () => PHASE_1_CSP,
   applyBlockBindings: () => applyBlockBindings,
@@ -60,8 +61,14 @@ __export(src_exports, {
   postsForCollection: () => postsForCollection,
   postsInAnyCollection: () => postsInAnyCollection,
   postsNotInAnyCollection: () => postsNotInAnyCollection,
+  resolveCategoryPath: () => resolveCategoryPath,
+  resolveCategoryTreeChain: () => resolveCategoryTreeChain,
+  resolveCategoryTreeEntryPath: () => resolveCategoryTreeEntryPath,
+  resolveCategoryTreeHubPaths: () => resolveCategoryTreeHubPaths,
+  resolvePostCategorySlug: () => resolvePostCategorySlug,
   resolvePostCollection: () => resolvePostCollection,
   resolvePostPath: () => resolvePostPath,
+  resolvePostPublicPath: () => resolvePostPublicPath,
   resolvePostUrl: () => resolvePostUrl,
   sanitizeHtml: () => sanitizeHtml,
   sanitizeImportedCss: () => sanitizeImportedCss,
@@ -202,18 +209,38 @@ function resolvePostCollection(post, collections) {
   return collections.find((c) => c.key === post.collectionKey) ?? null;
 }
 function resolvePostUrl(siteUrl, post, collections) {
-  const collection = resolvePostCollection(post, collections);
-  if (!collection) return null;
-  if (collection.detail === false) return null;
-  if (!collection.basePath) return null;
-  return `${trimTrailingSlash(siteUrl)}${trimTrailingSlash(collection.basePath)}/${encodeURIComponent(post.slug)}`;
+  const path = resolvePostPath(post, collections);
+  return path ? `${trimTrailingSlash(siteUrl)}${path}` : null;
+}
+function resolvePostCategorySlug(post, collection) {
+  const allowed = new Set(collection.categories);
+  const slugs = [
+    ...new Set(
+      post.terms.filter(
+        (term) => term.taxonomy === "category" && allowed.has(term.slug)
+      ).map((term) => term.slug)
+    )
+  ];
+  return slugs.length === 1 ? slugs[0] : null;
+}
+function resolveCategoryPath(collection, categorySlug) {
+  if (!collection.archives || !collection.basePath || !categorySlug) return null;
+  const basePath = trimTrailingSlash(collection.basePath);
+  const encodedSlug = encodeURIComponent(categorySlug);
+  return collection.categoryPath === "direct" ? `${basePath}/${encodedSlug}` : `${basePath}/categories/${encodedSlug}`;
 }
 function resolvePostPath(post, collections) {
   const collection = resolvePostCollection(post, collections);
   if (!collection) return null;
   if (collection.detail === false) return null;
   if (!collection.basePath) return null;
-  return `${trimTrailingSlash(collection.basePath)}/${encodeURIComponent(post.slug)}`;
+  const basePath = trimTrailingSlash(collection.basePath);
+  const encodedPostSlug = encodeURIComponent(post.slug);
+  if (collection.detailPath !== "category") {
+    return `${basePath}/${encodedPostSlug}`;
+  }
+  const categorySlug = resolvePostCategorySlug(post, collection);
+  return categorySlug ? `${basePath}/${encodeURIComponent(categorySlug)}/${encodedPostSlug}` : null;
 }
 function postsForCollection(posts, collections, key) {
   return posts.filter((p) => resolvePostCollection(p, collections)?.key === key);
@@ -253,10 +280,108 @@ function validateCollections(collections) {
       }
       categoryOwner.set(slug, c.key);
     }
+    if (c.detailPath === "category") {
+      if (!c.basePath) {
+        problems.push(
+          `category \uC0C1\uC138 \uACBD\uB85C\uB294 basePath \uAC00 \uD544\uC694\uD568: "${c.key}"`
+        );
+      }
+      if (c.detail === false) {
+        problems.push(
+          `category \uC0C1\uC138 \uACBD\uB85C\uB294 \uAE00\uBCC4 \uC0C1\uC138 \uD398\uC774\uC9C0\uAC00 \uD544\uC694\uD568: "${c.key}"`
+        );
+      }
+      if (!c.archives) {
+        problems.push(
+          `category \uC0C1\uC138 \uACBD\uB85C\uB294 \uCE74\uD14C\uACE0\uB9AC \uC544\uCE74\uC774\uBE0C\uAC00 \uD544\uC694\uD568: "${c.key}"`
+        );
+      }
+      if (c.categoryCardinality !== "exactly-one") {
+        problems.push(
+          `category \uC0C1\uC138 \uACBD\uB85C\uB294 categoryCardinality "exactly-one" \uC774 \uD544\uC694\uD568: "${c.key}"`
+        );
+      }
+    }
   }
   return problems;
 }
 
+// src/category-tree.ts
+function normalizeBasePath(basePath) {
+  return basePath.replace(/\/+$/, "");
+}
+function resolveCategoryTreeChain(presentation, leafId, terms) {
+  if (!Number.isInteger(presentation.categoryDepth) || presentation.categoryDepth < 1) {
+    return null;
+  }
+  const termsById = new Map(terms.map((term) => [term.id, term]));
+  if (termsById.size !== terms.length) return null;
+  if (terms.some((term) => term.parentId === leafId)) return null;
+  const reversed = [];
+  const visited = /* @__PURE__ */ new Set();
+  let currentId = leafId;
+  while (currentId) {
+    if (visited.has(currentId)) return null;
+    visited.add(currentId);
+    const current = termsById.get(currentId);
+    if (!current || !current.slug) return null;
+    reversed.push(current);
+    currentId = current.parentId ?? null;
+  }
+  if (reversed.length !== presentation.categoryDepth) return null;
+  return reversed.reverse();
+}
+function resolveCategoryTreeHubPaths(presentation, termId, terms) {
+  const chain = resolveCategoryTreeChain(presentation, termId, terms);
+  const basePath = normalizeBasePath(presentation.basePath);
+  if (!chain || !basePath) return null;
+  const paths = [basePath];
+  const segments = [];
+  for (const term of chain) {
+    segments.push(encodeURIComponent(term.slug));
+    paths.push(`${basePath}/${segments.join("/")}`);
+  }
+  return paths;
+}
+function resolveCategoryTreeEntryPath(presentation, entry, terms) {
+  if (!entry.slug) return null;
+  const knownIds = new Set(terms.map((term) => term.id));
+  const categoryIds = [
+    ...new Set(
+      entry.terms.filter((term) => term.taxonomy === "category" && knownIds.has(term.id)).map((term) => term.id)
+    )
+  ];
+  if (categoryIds.length !== 1) return null;
+  const hubs = resolveCategoryTreeHubPaths(
+    presentation,
+    categoryIds[0],
+    terms
+  );
+  const leafPath = hubs?.at(-1);
+  return leafPath ? `${leafPath}/${encodeURIComponent(entry.slug)}` : null;
+}
+
+// src/public-path.ts
+var LEGACY_BLOG_DETAIL_PATH = "/blog";
+function resolvePostPublicPath(post, context) {
+  const presentation = context.presentation;
+  if (presentation && presentation.kind !== "data_only") {
+    if (presentation.kind === "fixed_page") return presentation.path;
+    if (presentation.kind === "detail") {
+      if (!presentation.detailPath.includes(":slug")) return null;
+      return presentation.detailPath.replace(":slug", encodeURIComponent(post.slug));
+    }
+    return resolveCategoryTreeEntryPath(presentation, post, context.categories);
+  }
+  const collectionKey = post.collectionKey ?? (presentation ? context.compatibilityCollectionKey ?? post.modelKey ?? null : null);
+  const routable = { slug: post.slug, terms: post.terms, collectionKey };
+  if (!resolvePostCollection(routable, context.collections)) {
+    if (presentation) return null;
+    return `${LEGACY_BLOG_DETAIL_PATH}/${post.slug}`;
+  }
+  return resolvePostPath(routable, context.collections);
+}
+
 // src/delimiter.ts
 function serializeBlock(block) {
   const exportable = sanitizeAttributesForExport(block);
@@ -1229,6 +1354,7 @@ function injectStableIdsTree(blocks) {
   FIELD_BINDING_SOURCE,
   FIELD_BINDING_SOURCE_ALIAS,
   IMAGE_ALT_MAX_LENGTH,
+  LEGACY_BLOG_DETAIL_PATH,
   PHASE_1_CORE_BLOCKS,
   PHASE_1_CSP,
   applyBlockBindings,
@@ -1255,8 +1381,14 @@ function injectStableIdsTree(blocks) {
   postsForCollection,
   postsInAnyCollection,
   postsNotInAnyCollection,
+  resolveCategoryPath,
+  resolveCategoryTreeChain,
+  resolveCategoryTreeEntryPath,
+  resolveCategoryTreeHubPaths,
+  resolvePostCategorySlug,
   resolvePostCollection,
   resolvePostPath,
+  resolvePostPublicPath,
   resolvePostUrl,
   sanitizeHtml,
   sanitizeImportedCss,