@roottale/cms-core 0.55.0 → 0.56.0

package/dist/index.d.cts

@@ -233,6 +233,54 @@ declare function resolveCategoryTreeHubPaths(presentation: CategoryTreePresentat
 /** 계층형 분류 모델 항목의 정규 상세 주소. */
 declare function resolveCategoryTreeEntryPath(presentation: CategoryTreePresentation, entry: CategoryTreeEntry, terms: readonly CategoryTreeTerm[]): string | null;
 
+/**
+ * 글의 정규 공개 경로 — 플랫폼 전체가 쓰는 **하나의** 계산기 (ADR-0105 개정).
+ *
+ * 우선순위: 콘텐츠 모델 presentation(fixed_page → detail → category_tree) →
+ * 호환 컬렉션(`resolvePostPath`) → 레거시 `/blog/{slug}`. `data_only` 모델은
+ * 상세 주소가 없으므로 호환 컬렉션이 있으면 그 규칙을, 없으면 null 을 돌려준다.
+ *
+ * 이 값은 저장 시 `posts.public_path` 로 물질화되고(경로 이력 포함), 웹훅·사이트맵·
+ * 단축링크·내부 링크 키·리다이렉트는 저장된 값을 읽는다. 여기 말고 다른 곳에서
+ * 주소를 다시 계산하지 않는다.
+ */
+
+/** 콘텐츠 모델 presentation 의 구조적 최소형(cms-models 스키마와 호환). */
+type PublicPathPresentation = {
+    readonly kind: "data_only";
+} | {
+    readonly kind: "fixed_page";
+    readonly path: string;
+} | {
+    readonly kind: "detail";
+    readonly detailPath: string;
+} | {
+    readonly kind: "category_tree";
+    readonly basePath: string;
+    readonly categoryDepth: number;
+};
+interface PublicPathPost {
+    readonly slug: string;
+    readonly collectionKey?: string | null;
+    readonly modelKey?: string | null;
+    readonly terms: ReadonlyArray<{
+        readonly id: string;
+        readonly taxonomy: string;
+        readonly slug: string;
+    }>;
+}
+interface PublicPathContext {
+    /** 글의 모델 presentation. 모델 글이 아니거나 모델을 못 찾으면 null. */
+    readonly presentation: PublicPathPresentation | null;
+    /** 모델의 호환 컬렉션 key(`compatibilityCollectionKey`, 미지정이면 모델 key). */
+    readonly compatibilityCollectionKey?: string | null;
+    readonly collections: readonly RouteCollection[];
+    readonly categories: readonly CategoryTreeTerm[];
+}
+declare const LEGACY_BLOG_DETAIL_PATH = "/blog";
+/** 글의 정규 공개 경로(origin 제외). 상세 주소가 없으면 null. */
+declare function resolvePostPublicPath(post: PublicPathPost, context: PublicPathContext): string | null;
+
 interface ClientHydrationSpec {
     hydration?: "visible" | "idle" | "load" | "media" | "only";
     module?: string;
@@ -371,4 +419,4 @@ declare function injectStableIdsTree(blocks: readonly (Omit<Block, "_id"> & {
     _id?: string;
 })[]): Block[];
 
-export { BLOCK_NAME_PATTERN, type BindingResolver, type Block, type BlockBinding, type BlockDefinition, type BlockRegistry, type CategoryTreeEntry, type CategoryTreePresentation, type CategoryTreeTerm, type ClientHydrationSpec, type EmbedProvider, FIELD_BINDING_SOURCE, FIELD_BINDING_SOURCE_ALIAS, type FaqEntry, IMAGE_ALT_MAX_LENGTH, type NormalizedEmbed, PHASE_1_CORE_BLOCKS, PHASE_1_CSP, type Phase1CoreBlockName, type PreviewTokenPayload, type RoutablePost, type RouteCollection, applyBlockBindings, bindingSrcValue, bindingTextValue, blockSchema, boundFieldValue, chainResolvers, createFieldBindingResolver, ensureImportedHtmlDocumentRoots, ensureStableIds, extractFaqEntries, faqPageJsonLd, htmlToPlainText, injectStableIdsTree, isAllowedEmbedSrc, isAllowedMapEmbedSrc, isInCollectionMode, isValidBlock, issuePreviewToken, normalizeEmbed, normalizeImageAlt, parseBlock, postsForCollection, postsInAnyCollection, postsNotInAnyCollection, resolveCategoryPath, resolveCategoryTreeChain, resolveCategoryTreeEntryPath, resolveCategoryTreeHubPaths, resolvePostCategorySlug, resolvePostCollection, resolvePostPath, resolvePostUrl, sanitizeHtml, sanitizeImportedCss, sanitizeImportedHtml, scopeImportedCss, serializeBlock, validateCollections, verifyPreviewToken };
+export { BLOCK_NAME_PATTERN, type BindingResolver, type Block, type BlockBinding, type BlockDefinition, type BlockRegistry, type CategoryTreeEntry, type CategoryTreePresentation, type CategoryTreeTerm, type ClientHydrationSpec, type EmbedProvider, FIELD_BINDING_SOURCE, FIELD_BINDING_SOURCE_ALIAS, type FaqEntry, IMAGE_ALT_MAX_LENGTH, LEGACY_BLOG_DETAIL_PATH, type NormalizedEmbed, PHASE_1_CORE_BLOCKS, PHASE_1_CSP, type Phase1CoreBlockName, type PreviewTokenPayload, type PublicPathContext, type PublicPathPost, type PublicPathPresentation, type RoutablePost, type RouteCollection, applyBlockBindings, bindingSrcValue, bindingTextValue, blockSchema, boundFieldValue, chainResolvers, createFieldBindingResolver, ensureImportedHtmlDocumentRoots, ensureStableIds, extractFaqEntries, faqPageJsonLd, htmlToPlainText, injectStableIdsTree, isAllowedEmbedSrc, isAllowedMapEmbedSrc, isInCollectionMode, isValidBlock, issuePreviewToken, normalizeEmbed, normalizeImageAlt, parseBlock, postsForCollection, postsInAnyCollection, postsNotInAnyCollection, resolveCategoryPath, resolveCategoryTreeChain, resolveCategoryTreeEntryPath, resolveCategoryTreeHubPaths, resolvePostCategorySlug, resolvePostCollection, resolvePostPath, resolvePostPublicPath, resolvePostUrl, sanitizeHtml, sanitizeImportedCss, sanitizeImportedHtml, scopeImportedCss, serializeBlock, validateCollections, verifyPreviewToken };

package/dist/index.d.ts

@@ -233,6 +233,54 @@ declare function resolveCategoryTreeHubPaths(presentation: CategoryTreePresentat
 /** 계층형 분류 모델 항목의 정규 상세 주소. */
 declare function resolveCategoryTreeEntryPath(presentation: CategoryTreePresentation, entry: CategoryTreeEntry, terms: readonly CategoryTreeTerm[]): string | null;
 
+/**
+ * 글의 정규 공개 경로 — 플랫폼 전체가 쓰는 **하나의** 계산기 (ADR-0105 개정).
+ *
+ * 우선순위: 콘텐츠 모델 presentation(fixed_page → detail → category_tree) →
+ * 호환 컬렉션(`resolvePostPath`) → 레거시 `/blog/{slug}`. `data_only` 모델은
+ * 상세 주소가 없으므로 호환 컬렉션이 있으면 그 규칙을, 없으면 null 을 돌려준다.
+ *
+ * 이 값은 저장 시 `posts.public_path` 로 물질화되고(경로 이력 포함), 웹훅·사이트맵·
+ * 단축링크·내부 링크 키·리다이렉트는 저장된 값을 읽는다. 여기 말고 다른 곳에서
+ * 주소를 다시 계산하지 않는다.
+ */
+
+/** 콘텐츠 모델 presentation 의 구조적 최소형(cms-models 스키마와 호환). */
+type PublicPathPresentation = {
+    readonly kind: "data_only";
+} | {
+    readonly kind: "fixed_page";
+    readonly path: string;
+} | {
+    readonly kind: "detail";
+    readonly detailPath: string;
+} | {
+    readonly kind: "category_tree";
+    readonly basePath: string;
+    readonly categoryDepth: number;
+};
+interface PublicPathPost {
+    readonly slug: string;
+    readonly collectionKey?: string | null;
+    readonly modelKey?: string | null;
+    readonly terms: ReadonlyArray<{
+        readonly id: string;
+        readonly taxonomy: string;
+        readonly slug: string;
+    }>;
+}
+interface PublicPathContext {
+    /** 글의 모델 presentation. 모델 글이 아니거나 모델을 못 찾으면 null. */
+    readonly presentation: PublicPathPresentation | null;
+    /** 모델의 호환 컬렉션 key(`compatibilityCollectionKey`, 미지정이면 모델 key). */
+    readonly compatibilityCollectionKey?: string | null;
+    readonly collections: readonly RouteCollection[];
+    readonly categories: readonly CategoryTreeTerm[];
+}
+declare const LEGACY_BLOG_DETAIL_PATH = "/blog";
+/** 글의 정규 공개 경로(origin 제외). 상세 주소가 없으면 null. */
+declare function resolvePostPublicPath(post: PublicPathPost, context: PublicPathContext): string | null;
+
 interface ClientHydrationSpec {
     hydration?: "visible" | "idle" | "load" | "media" | "only";
     module?: string;
@@ -371,4 +419,4 @@ declare function injectStableIdsTree(blocks: readonly (Omit<Block, "_id"> & {
     _id?: string;
 })[]): Block[];
 
-export { BLOCK_NAME_PATTERN, type BindingResolver, type Block, type BlockBinding, type BlockDefinition, type BlockRegistry, type CategoryTreeEntry, type CategoryTreePresentation, type CategoryTreeTerm, type ClientHydrationSpec, type EmbedProvider, FIELD_BINDING_SOURCE, FIELD_BINDING_SOURCE_ALIAS, type FaqEntry, IMAGE_ALT_MAX_LENGTH, type NormalizedEmbed, PHASE_1_CORE_BLOCKS, PHASE_1_CSP, type Phase1CoreBlockName, type PreviewTokenPayload, type RoutablePost, type RouteCollection, applyBlockBindings, bindingSrcValue, bindingTextValue, blockSchema, boundFieldValue, chainResolvers, createFieldBindingResolver, ensureImportedHtmlDocumentRoots, ensureStableIds, extractFaqEntries, faqPageJsonLd, htmlToPlainText, injectStableIdsTree, isAllowedEmbedSrc, isAllowedMapEmbedSrc, isInCollectionMode, isValidBlock, issuePreviewToken, normalizeEmbed, normalizeImageAlt, parseBlock, postsForCollection, postsInAnyCollection, postsNotInAnyCollection, resolveCategoryPath, resolveCategoryTreeChain, resolveCategoryTreeEntryPath, resolveCategoryTreeHubPaths, resolvePostCategorySlug, resolvePostCollection, resolvePostPath, resolvePostUrl, sanitizeHtml, sanitizeImportedCss, sanitizeImportedHtml, scopeImportedCss, serializeBlock, validateCollections, verifyPreviewToken };
+export { BLOCK_NAME_PATTERN, type BindingResolver, type Block, type BlockBinding, type BlockDefinition, type BlockRegistry, type CategoryTreeEntry, type CategoryTreePresentation, type CategoryTreeTerm, type ClientHydrationSpec, type EmbedProvider, FIELD_BINDING_SOURCE, FIELD_BINDING_SOURCE_ALIAS, type FaqEntry, IMAGE_ALT_MAX_LENGTH, LEGACY_BLOG_DETAIL_PATH, type NormalizedEmbed, PHASE_1_CORE_BLOCKS, PHASE_1_CSP, type Phase1CoreBlockName, type PreviewTokenPayload, type PublicPathContext, type PublicPathPost, type PublicPathPresentation, type RoutablePost, type RouteCollection, applyBlockBindings, bindingSrcValue, bindingTextValue, blockSchema, boundFieldValue, chainResolvers, createFieldBindingResolver, ensureImportedHtmlDocumentRoots, ensureStableIds, extractFaqEntries, faqPageJsonLd, htmlToPlainText, injectStableIdsTree, isAllowedEmbedSrc, isAllowedMapEmbedSrc, isInCollectionMode, isValidBlock, issuePreviewToken, normalizeEmbed, normalizeImageAlt, parseBlock, postsForCollection, postsInAnyCollection, postsNotInAnyCollection, resolveCategoryPath, resolveCategoryTreeChain, resolveCategoryTreeEntryPath, resolveCategoryTreeHubPaths, resolvePostCategorySlug, resolvePostCollection, resolvePostPath, resolvePostPublicPath, resolvePostUrl, sanitizeHtml, sanitizeImportedCss, sanitizeImportedHtml, scopeImportedCss, serializeBlock, validateCollections, verifyPreviewToken };

package/dist/index.js

@@ -279,6 +279,27 @@ function resolveCategoryTreeEntryPath(presentation, entry, terms) {
   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);
@@ -1250,6 +1271,7 @@ export {
   FIELD_BINDING_SOURCE,
   FIELD_BINDING_SOURCE_ALIAS,
   IMAGE_ALT_MAX_LENGTH,
+  LEGACY_BLOG_DETAIL_PATH,
   PHASE_1_CORE_BLOCKS,
   PHASE_1_CSP,
   applyBlockBindings,
@@ -1283,6 +1305,7 @@ export {
   resolvePostCategorySlug,
   resolvePostCollection,
   resolvePostPath,
+  resolvePostPublicPath,
   resolvePostUrl,
   sanitizeHtml,
   sanitizeImportedCss,