@roottale/cms-core 0.58.0 → 0.59.0

package/dist/index.d.cts

@@ -475,15 +475,16 @@ declare function injectStableIdsTree(blocks: readonly (Omit<Block, "_id"> & {
  * 공통 블록(Site Patterns) — 여러 글에 같은 자리로 붙는 재사용 블록의 순수 규칙.
  *
  * 블록 본문은 ROOT-ADMIN 이 `site_patterns` 에 저장하고, "어느 자리(slot)에 어느
- * 유형(collection)의 글이면 어떤 블록"인지는 배치 규칙(`settings.site_pattern_placements`)
- * 으로 정한다. 공개 API 는 글마다 `pattern_slots`(자리 → 블록 key | null) 를 계산해
+ * 콘텐츠 모델(`model_key`)의 글이면 어떤 블록"인지는 배치 규칙
+ * (`settings.site_pattern_placements`)으로 정한다. 유형의 단위는 콘텐츠 모델이다 —
+ * 컬렉션 설정(ADR-0060)은 ADR-0105 로 폐기 중이라 규칙 키로 쓰지 않는다. 공개 API 는 글마다 `pattern_slots`(자리 → 블록 key | null) 를 계산해
  * 내려주므로 FRONT 는 규칙을 몰라도 된다. 이 파일은 api-core(계산)·tenant-admin(편집)·
  * cms-renderer-next(렌더)가 같은 판정을 공유하기 위한 프레임워크 비의존 모듈이다.
  *
  * 규칙 판정:
  * - 자리는 `SITE_PATTERN_SLOTS` 에 선언된 것만 계산한다(미선언 자리는 무시).
- * - 글의 `collectionKey` 와 같은 규칙이 있으면 그 규칙(블록 없음 = null 도 명시적 결정).
- * - 없으면 `collectionKey: null`(모든 글 기본) 규칙.
+ * - 글의 `modelKey` 와 같은 규칙이 있으면 그 규칙(블록 없음 = null 도 명시적 결정).
+ * - 없으면 `modelKey: null`(모든 글 기본) 규칙.
  * - 가리키는 블록이 발행 상태가 아니면 null(FRONT 가 미발행 블록을 그리지 않게).
  */
 /** 블록을 놓을 수 있는 자리. key 는 공개 API `pattern_slots` 의 키와 같다. */
@@ -501,12 +502,12 @@ declare const SITE_PATTERN_KEY_PATTERN: RegExp;
 declare function isValidSitePatternKey(key: string): boolean;
 declare function isSitePatternSlotKey(value: string): value is SitePatternSlotKey;
 /**
- * 배치 규칙 1건. `collectionKey: null` = 모든 글의 기본값, 문자열 = 그 유형의 글만.
+ * 배치 규칙 1건. `modelKey: null` = 모든 글의 기본값, 문자열 = 그 콘텐츠 모델의 글만.
  * `patternKey: null` = 이 자리에 블록을 놓지 않는다(유형 규칙이면 기본값 덮어쓰기).
  */
 interface SitePatternPlacementRule {
     readonly slot: SitePatternSlotKey;
-    readonly collectionKey: string | null;
+    readonly modelKey: string | null;
     readonly patternKey: string | null;
 }
 interface SitePatternPlacements {
@@ -517,26 +518,30 @@ declare const EMPTY_SITE_PATTERN_PLACEMENTS: SitePatternPlacements;
 type PatternSlots = Record<string, string | null>;
 /**
  * 저장된 값(unknown) → 정규화된 배치 규칙. 형식이 틀린 항목·미선언 자리는 버리고,
- * 같은 (slot, collectionKey) 는 마지막 항목이 이긴다. 이중 인코딩된 JSON 문자열도 받는다.
+ * 같은 (slot, modelKey) 는 마지막 항목이 이긴다. 이중 인코딩된 JSON 문자열도 받는다.
+ * 2026-08-19 이전에 저장된 규칙은 `collectionKey` 필드를 썼다 — `modelKey` 가 없으면 그
+ * 값을 읽는다(실측상 남은 규칙은 기본값 `null` 뿐이라 의미가 같다). 다시 저장하면
+ * `modelKey` 로 쓰인다.
  */
 declare function readSitePatternPlacements(raw: unknown): SitePatternPlacements;
-/** (slot, collectionKey) 에 해당하는 규칙. 없으면 undefined(= 기본값으로 위임). */
-declare function findSitePatternPlacementRule(placements: SitePatternPlacements, slot: SitePatternSlotKey, collectionKey: string | null): SitePatternPlacementRule | undefined;
+/** (slot, modelKey) 에 해당하는 규칙. 없으면 undefined(= 기본값으로 위임). */
+declare function findSitePatternPlacementRule(placements: SitePatternPlacements, slot: SitePatternSlotKey, modelKey: string | null): SitePatternPlacementRule | undefined;
 /**
  * 규칙 1건을 갈아 끼운 새 배치 규칙을 돌려준다(불변). `patternKey: undefined` 는
  * "규칙 삭제 = 기본값으로 위임"이다 — 유형 규칙에서 "표시 안 함"(null)과 구분된다.
  */
 declare function setSitePatternPlacementRule(placements: SitePatternPlacements, target: {
     slot: SitePatternSlotKey;
-    collectionKey: string | null;
+    modelKey: string | null;
 }, patternKey: string | null | undefined): SitePatternPlacements;
 /** 선언된 자리마다 null 인 빈 결과 — 규칙이나 발행 블록이 없을 때의 기본 응답. */
 declare function emptyPatternSlots(): PatternSlots;
 /**
- * 글 1건의 자리별 블록 key 를 계산한다. `publishedKeys` 에 없는 블록(미발행·삭제)은 null.
+ * 글 1건의 자리별 블록 key 를 계산한다. 글의 콘텐츠 모델(`modelKey`) 규칙 > 모든 글 기본
+ * 규칙. `publishedKeys` 에 없는 블록(미발행·삭제)은 null.
  */
 declare function resolvePatternSlots(post: {
-    readonly collectionKey: string | null;
+    readonly modelKey: string | null;
 }, placements: SitePatternPlacements, publishedKeys: ReadonlySet<string>): PatternSlots;
 /**
  * 규칙에서 참조하는 블록 key 집합 — 어드민이 "이 블록은 어디에 쓰이는가"를 표시하거나

package/dist/index.d.ts

@@ -475,15 +475,16 @@ declare function injectStableIdsTree(blocks: readonly (Omit<Block, "_id"> & {
  * 공통 블록(Site Patterns) — 여러 글에 같은 자리로 붙는 재사용 블록의 순수 규칙.
  *
  * 블록 본문은 ROOT-ADMIN 이 `site_patterns` 에 저장하고, "어느 자리(slot)에 어느
- * 유형(collection)의 글이면 어떤 블록"인지는 배치 규칙(`settings.site_pattern_placements`)
- * 으로 정한다. 공개 API 는 글마다 `pattern_slots`(자리 → 블록 key | null) 를 계산해
+ * 콘텐츠 모델(`model_key`)의 글이면 어떤 블록"인지는 배치 규칙
+ * (`settings.site_pattern_placements`)으로 정한다. 유형의 단위는 콘텐츠 모델이다 —
+ * 컬렉션 설정(ADR-0060)은 ADR-0105 로 폐기 중이라 규칙 키로 쓰지 않는다. 공개 API 는 글마다 `pattern_slots`(자리 → 블록 key | null) 를 계산해
  * 내려주므로 FRONT 는 규칙을 몰라도 된다. 이 파일은 api-core(계산)·tenant-admin(편집)·
  * cms-renderer-next(렌더)가 같은 판정을 공유하기 위한 프레임워크 비의존 모듈이다.
  *
  * 규칙 판정:
  * - 자리는 `SITE_PATTERN_SLOTS` 에 선언된 것만 계산한다(미선언 자리는 무시).
- * - 글의 `collectionKey` 와 같은 규칙이 있으면 그 규칙(블록 없음 = null 도 명시적 결정).
- * - 없으면 `collectionKey: null`(모든 글 기본) 규칙.
+ * - 글의 `modelKey` 와 같은 규칙이 있으면 그 규칙(블록 없음 = null 도 명시적 결정).
+ * - 없으면 `modelKey: null`(모든 글 기본) 규칙.
  * - 가리키는 블록이 발행 상태가 아니면 null(FRONT 가 미발행 블록을 그리지 않게).
  */
 /** 블록을 놓을 수 있는 자리. key 는 공개 API `pattern_slots` 의 키와 같다. */
@@ -501,12 +502,12 @@ declare const SITE_PATTERN_KEY_PATTERN: RegExp;
 declare function isValidSitePatternKey(key: string): boolean;
 declare function isSitePatternSlotKey(value: string): value is SitePatternSlotKey;
 /**
- * 배치 규칙 1건. `collectionKey: null` = 모든 글의 기본값, 문자열 = 그 유형의 글만.
+ * 배치 규칙 1건. `modelKey: null` = 모든 글의 기본값, 문자열 = 그 콘텐츠 모델의 글만.
  * `patternKey: null` = 이 자리에 블록을 놓지 않는다(유형 규칙이면 기본값 덮어쓰기).
  */
 interface SitePatternPlacementRule {
     readonly slot: SitePatternSlotKey;
-    readonly collectionKey: string | null;
+    readonly modelKey: string | null;
     readonly patternKey: string | null;
 }
 interface SitePatternPlacements {
@@ -517,26 +518,30 @@ declare const EMPTY_SITE_PATTERN_PLACEMENTS: SitePatternPlacements;
 type PatternSlots = Record<string, string | null>;
 /**
  * 저장된 값(unknown) → 정규화된 배치 규칙. 형식이 틀린 항목·미선언 자리는 버리고,
- * 같은 (slot, collectionKey) 는 마지막 항목이 이긴다. 이중 인코딩된 JSON 문자열도 받는다.
+ * 같은 (slot, modelKey) 는 마지막 항목이 이긴다. 이중 인코딩된 JSON 문자열도 받는다.
+ * 2026-08-19 이전에 저장된 규칙은 `collectionKey` 필드를 썼다 — `modelKey` 가 없으면 그
+ * 값을 읽는다(실측상 남은 규칙은 기본값 `null` 뿐이라 의미가 같다). 다시 저장하면
+ * `modelKey` 로 쓰인다.
  */
 declare function readSitePatternPlacements(raw: unknown): SitePatternPlacements;
-/** (slot, collectionKey) 에 해당하는 규칙. 없으면 undefined(= 기본값으로 위임). */
-declare function findSitePatternPlacementRule(placements: SitePatternPlacements, slot: SitePatternSlotKey, collectionKey: string | null): SitePatternPlacementRule | undefined;
+/** (slot, modelKey) 에 해당하는 규칙. 없으면 undefined(= 기본값으로 위임). */
+declare function findSitePatternPlacementRule(placements: SitePatternPlacements, slot: SitePatternSlotKey, modelKey: string | null): SitePatternPlacementRule | undefined;
 /**
  * 규칙 1건을 갈아 끼운 새 배치 규칙을 돌려준다(불변). `patternKey: undefined` 는
  * "규칙 삭제 = 기본값으로 위임"이다 — 유형 규칙에서 "표시 안 함"(null)과 구분된다.
  */
 declare function setSitePatternPlacementRule(placements: SitePatternPlacements, target: {
     slot: SitePatternSlotKey;
-    collectionKey: string | null;
+    modelKey: string | null;
 }, patternKey: string | null | undefined): SitePatternPlacements;
 /** 선언된 자리마다 null 인 빈 결과 — 규칙이나 발행 블록이 없을 때의 기본 응답. */
 declare function emptyPatternSlots(): PatternSlots;
 /**
- * 글 1건의 자리별 블록 key 를 계산한다. `publishedKeys` 에 없는 블록(미발행·삭제)은 null.
+ * 글 1건의 자리별 블록 key 를 계산한다. 글의 콘텐츠 모델(`modelKey`) 규칙 > 모든 글 기본
+ * 규칙. `publishedKeys` 에 없는 블록(미발행·삭제)은 null.
  */
 declare function resolvePatternSlots(post: {
-    readonly collectionKey: string | null;
+    readonly modelKey: string | null;
 }, placements: SitePatternPlacements, publishedKeys: ReadonlySet<string>): PatternSlots;
 /**
  * 규칙에서 참조하는 블록 key 집합 — 어드민이 "이 블록은 어디에 쓰이는가"를 표시하거나

package/dist/index.js

@@ -1455,34 +1455,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() {
@@ -1491,7 +1488,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;