@roottale/cms-core 0.57.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,31 +518,62 @@ 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 집합 — 어드민이 "이 블록은 어디에 쓰이는가"를 표시하거나
  * 삭제 전 경고할 때 쓴다.
  */
 declare function referencedSitePatternKeys(placements: SitePatternPlacements): ReadonlySet<string>;
+type SitePatternLayout = "plain" | "card";
+type SitePatternLinkStyle = "text" | "buttons";
+interface SitePatternPresentation {
+    /** `plain` = 본문처럼 흐름에 놓임, `card` = 배경색이 있는 카드. */
+    readonly layout: SitePatternLayout;
+    /** 카드 배경색(hex). layout 이 card 일 때만 의미. */
+    readonly background: string;
+    /** 마지막 문단의 링크를 버튼으로 그릴지. */
+    readonly linkStyle: SitePatternLinkStyle;
+    /** 버튼 배경색(hex, 순서대로 1·2·3…; 링크가 더 많으면 마지막 색을 반복). 글자는 흰색. */
+    readonly buttonColors: readonly string[];
+}
+declare const DEFAULT_SITE_PATTERN_PRESENTATION: SitePatternPresentation;
+declare const SITE_PATTERN_BUTTON_COLORS_MAX = 4;
+declare function normalizeHexColor(value: unknown): string | null;
+/** 저장된 값(unknown) → 표시 형태. 틀린 값은 기본값으로 채운다(절대 throw 하지 않음). */
+declare function readSitePatternPresentation(raw: unknown): SitePatternPresentation;
+/** 버튼 n번째(0부터)의 색 — 링크가 색 개수보다 많으면 마지막 색을 반복. */
+declare function sitePatternButtonColor(presentation: SitePatternPresentation, index: number): string;
+/**
+ * FRONT 가 래퍼 요소에 얹을 data 속성과 CSS 변수. 사이트 CSS 는 이 변수만 읽는다 —
+ * `data-pattern-layout`·`data-pattern-link-style`, `--rt-pattern-bg`, `--rt-pattern-btn-1..n`.
+ */
+declare function sitePatternPresentationAttributes(presentation: SitePatternPresentation): {
+    readonly dataset: Readonly<Record<string, string>>;
+    readonly cssVariables: Readonly<Record<string, string>>;
+};
 
-export { BLOCK_NAME_PATTERN, type BindingResolver, type Block, type BlockBinding, type BlockDefinition, type BlockRegistry, type CategoryTreeEntry, type CategoryTreePresentation, type CategoryTreeTerm, type ClientHydrationSpec, EMPTY_SITE_PATTERN_PLACEMENTS, type EmbedProvider, FIELD_BINDING_SOURCE, FIELD_BINDING_SOURCE_ALIAS, type FaqEntry, IMAGE_ALT_MAX_LENGTH, INTERNAL_CONTENT_LINK_CLASS, INTERNAL_CONTENT_LINK_PENDING_ATTR, INTERNAL_CONTENT_LINK_PENDING_CLASS, INTERNAL_CONTENT_LINK_TOKEN_SOURCE, type InternalContentLinkResolver, type InternalContentLinkToken, LEGACY_BLOG_DETAIL_PATH, type NormalizedEmbed, PHASE_1_CORE_BLOCKS, PHASE_1_CSP, POST_FOOTER_SLOT, type PatternSlots, type Phase1CoreBlockName, type PreviewTokenPayload, type PublicPathContext, type PublicPathPost, type PublicPathPresentation, type RoutablePost, type RouteCollection, SITE_PATTERN_KEY_PATTERN, SITE_PATTERN_PLACEMENTS_KEY, SITE_PATTERN_SLOTS, type SitePatternPlacementRule, type SitePatternPlacements, type SitePatternSlotKey, applyBlockBindings, bindingSrcValue, bindingTextValue, blockSchema, boundFieldValue, chainResolvers, createFieldBindingResolver, emptyPatternSlots, ensureImportedHtmlDocumentRoots, ensureStableIds, extractFaqEntries, faqPageJsonLd, findInternalContentLinkTokens, findSitePatternPlacementRule, htmlToPlainText, injectStableIdsTree, internalContentKeyFromPath, internalContentLinkResolverFrom, internalContentPathIndex, isAllowedEmbedSrc, isAllowedMapEmbedSrc, isInCollectionMode, isSitePatternSlotKey, isValidBlock, isValidSitePatternKey, issuePreviewToken, normalizeEmbed, normalizeImageAlt, parseBlock, postsForCollection, postsInAnyCollection, postsNotInAnyCollection, readSitePatternPlacements, referencedSitePatternKeys, renderInternalContentLinksInHtml, renderInternalContentLinksInText, resolveCategoryPath, resolveCategoryTreeChain, resolveCategoryTreeEntryPath, resolveCategoryTreeHubPaths, resolvePatternSlots, resolvePostCategorySlug, resolvePostCollection, resolvePostPath, resolvePostPublicPath, resolvePostUrl, sanitizeHtml, sanitizeImportedCss, sanitizeImportedHtml, scopeImportedCss, serializeBlock, setSitePatternPlacementRule, validateCollections, verifyPreviewToken };
+export { BLOCK_NAME_PATTERN, type BindingResolver, type Block, type BlockBinding, type BlockDefinition, type BlockRegistry, type CategoryTreeEntry, type CategoryTreePresentation, type CategoryTreeTerm, type ClientHydrationSpec, DEFAULT_SITE_PATTERN_PRESENTATION, EMPTY_SITE_PATTERN_PLACEMENTS, type EmbedProvider, FIELD_BINDING_SOURCE, FIELD_BINDING_SOURCE_ALIAS, type FaqEntry, IMAGE_ALT_MAX_LENGTH, INTERNAL_CONTENT_LINK_CLASS, INTERNAL_CONTENT_LINK_PENDING_ATTR, INTERNAL_CONTENT_LINK_PENDING_CLASS, INTERNAL_CONTENT_LINK_TOKEN_SOURCE, type InternalContentLinkResolver, type InternalContentLinkToken, LEGACY_BLOG_DETAIL_PATH, type NormalizedEmbed, PHASE_1_CORE_BLOCKS, PHASE_1_CSP, POST_FOOTER_SLOT, type PatternSlots, type Phase1CoreBlockName, type PreviewTokenPayload, type PublicPathContext, type PublicPathPost, type PublicPathPresentation, type RoutablePost, type RouteCollection, SITE_PATTERN_BUTTON_COLORS_MAX, SITE_PATTERN_KEY_PATTERN, SITE_PATTERN_PLACEMENTS_KEY, SITE_PATTERN_SLOTS, type SitePatternLayout, type SitePatternLinkStyle, type SitePatternPlacementRule, type SitePatternPlacements, type SitePatternPresentation, type SitePatternSlotKey, applyBlockBindings, bindingSrcValue, bindingTextValue, blockSchema, boundFieldValue, chainResolvers, createFieldBindingResolver, emptyPatternSlots, ensureImportedHtmlDocumentRoots, ensureStableIds, extractFaqEntries, faqPageJsonLd, findInternalContentLinkTokens, findSitePatternPlacementRule, htmlToPlainText, injectStableIdsTree, internalContentKeyFromPath, internalContentLinkResolverFrom, internalContentPathIndex, isAllowedEmbedSrc, isAllowedMapEmbedSrc, isInCollectionMode, isSitePatternSlotKey, isValidBlock, isValidSitePatternKey, issuePreviewToken, normalizeEmbed, normalizeHexColor, normalizeImageAlt, parseBlock, postsForCollection, postsInAnyCollection, postsNotInAnyCollection, readSitePatternPlacements, readSitePatternPresentation, referencedSitePatternKeys, renderInternalContentLinksInHtml, renderInternalContentLinksInText, resolveCategoryPath, resolveCategoryTreeChain, resolveCategoryTreeEntryPath, resolveCategoryTreeHubPaths, resolvePatternSlots, resolvePostCategorySlug, resolvePostCollection, resolvePostPath, resolvePostPublicPath, resolvePostUrl, sanitizeHtml, sanitizeImportedCss, sanitizeImportedHtml, scopeImportedCss, serializeBlock, setSitePatternPlacementRule, sitePatternButtonColor, sitePatternPresentationAttributes, validateCollections, verifyPreviewToken };

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,31 +518,62 @@ 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 집합 — 어드민이 "이 블록은 어디에 쓰이는가"를 표시하거나
  * 삭제 전 경고할 때 쓴다.
  */
 declare function referencedSitePatternKeys(placements: SitePatternPlacements): ReadonlySet<string>;
+type SitePatternLayout = "plain" | "card";
+type SitePatternLinkStyle = "text" | "buttons";
+interface SitePatternPresentation {
+    /** `plain` = 본문처럼 흐름에 놓임, `card` = 배경색이 있는 카드. */
+    readonly layout: SitePatternLayout;
+    /** 카드 배경색(hex). layout 이 card 일 때만 의미. */
+    readonly background: string;
+    /** 마지막 문단의 링크를 버튼으로 그릴지. */
+    readonly linkStyle: SitePatternLinkStyle;
+    /** 버튼 배경색(hex, 순서대로 1·2·3…; 링크가 더 많으면 마지막 색을 반복). 글자는 흰색. */
+    readonly buttonColors: readonly string[];
+}
+declare const DEFAULT_SITE_PATTERN_PRESENTATION: SitePatternPresentation;
+declare const SITE_PATTERN_BUTTON_COLORS_MAX = 4;
+declare function normalizeHexColor(value: unknown): string | null;
+/** 저장된 값(unknown) → 표시 형태. 틀린 값은 기본값으로 채운다(절대 throw 하지 않음). */
+declare function readSitePatternPresentation(raw: unknown): SitePatternPresentation;
+/** 버튼 n번째(0부터)의 색 — 링크가 색 개수보다 많으면 마지막 색을 반복. */
+declare function sitePatternButtonColor(presentation: SitePatternPresentation, index: number): string;
+/**
+ * FRONT 가 래퍼 요소에 얹을 data 속성과 CSS 변수. 사이트 CSS 는 이 변수만 읽는다 —
+ * `data-pattern-layout`·`data-pattern-link-style`, `--rt-pattern-bg`, `--rt-pattern-btn-1..n`.
+ */
+declare function sitePatternPresentationAttributes(presentation: SitePatternPresentation): {
+    readonly dataset: Readonly<Record<string, string>>;
+    readonly cssVariables: Readonly<Record<string, string>>;
+};
 
-export { BLOCK_NAME_PATTERN, type BindingResolver, type Block, type BlockBinding, type BlockDefinition, type BlockRegistry, type CategoryTreeEntry, type CategoryTreePresentation, type CategoryTreeTerm, type ClientHydrationSpec, EMPTY_SITE_PATTERN_PLACEMENTS, type EmbedProvider, FIELD_BINDING_SOURCE, FIELD_BINDING_SOURCE_ALIAS, type FaqEntry, IMAGE_ALT_MAX_LENGTH, INTERNAL_CONTENT_LINK_CLASS, INTERNAL_CONTENT_LINK_PENDING_ATTR, INTERNAL_CONTENT_LINK_PENDING_CLASS, INTERNAL_CONTENT_LINK_TOKEN_SOURCE, type InternalContentLinkResolver, type InternalContentLinkToken, LEGACY_BLOG_DETAIL_PATH, type NormalizedEmbed, PHASE_1_CORE_BLOCKS, PHASE_1_CSP, POST_FOOTER_SLOT, type PatternSlots, type Phase1CoreBlockName, type PreviewTokenPayload, type PublicPathContext, type PublicPathPost, type PublicPathPresentation, type RoutablePost, type RouteCollection, SITE_PATTERN_KEY_PATTERN, SITE_PATTERN_PLACEMENTS_KEY, SITE_PATTERN_SLOTS, type SitePatternPlacementRule, type SitePatternPlacements, type SitePatternSlotKey, applyBlockBindings, bindingSrcValue, bindingTextValue, blockSchema, boundFieldValue, chainResolvers, createFieldBindingResolver, emptyPatternSlots, ensureImportedHtmlDocumentRoots, ensureStableIds, extractFaqEntries, faqPageJsonLd, findInternalContentLinkTokens, findSitePatternPlacementRule, htmlToPlainText, injectStableIdsTree, internalContentKeyFromPath, internalContentLinkResolverFrom, internalContentPathIndex, isAllowedEmbedSrc, isAllowedMapEmbedSrc, isInCollectionMode, isSitePatternSlotKey, isValidBlock, isValidSitePatternKey, issuePreviewToken, normalizeEmbed, normalizeImageAlt, parseBlock, postsForCollection, postsInAnyCollection, postsNotInAnyCollection, readSitePatternPlacements, referencedSitePatternKeys, renderInternalContentLinksInHtml, renderInternalContentLinksInText, resolveCategoryPath, resolveCategoryTreeChain, resolveCategoryTreeEntryPath, resolveCategoryTreeHubPaths, resolvePatternSlots, resolvePostCategorySlug, resolvePostCollection, resolvePostPath, resolvePostPublicPath, resolvePostUrl, sanitizeHtml, sanitizeImportedCss, sanitizeImportedHtml, scopeImportedCss, serializeBlock, setSitePatternPlacementRule, validateCollections, verifyPreviewToken };
+export { BLOCK_NAME_PATTERN, type BindingResolver, type Block, type BlockBinding, type BlockDefinition, type BlockRegistry, type CategoryTreeEntry, type CategoryTreePresentation, type CategoryTreeTerm, type ClientHydrationSpec, DEFAULT_SITE_PATTERN_PRESENTATION, EMPTY_SITE_PATTERN_PLACEMENTS, type EmbedProvider, FIELD_BINDING_SOURCE, FIELD_BINDING_SOURCE_ALIAS, type FaqEntry, IMAGE_ALT_MAX_LENGTH, INTERNAL_CONTENT_LINK_CLASS, INTERNAL_CONTENT_LINK_PENDING_ATTR, INTERNAL_CONTENT_LINK_PENDING_CLASS, INTERNAL_CONTENT_LINK_TOKEN_SOURCE, type InternalContentLinkResolver, type InternalContentLinkToken, LEGACY_BLOG_DETAIL_PATH, type NormalizedEmbed, PHASE_1_CORE_BLOCKS, PHASE_1_CSP, POST_FOOTER_SLOT, type PatternSlots, type Phase1CoreBlockName, type PreviewTokenPayload, type PublicPathContext, type PublicPathPost, type PublicPathPresentation, type RoutablePost, type RouteCollection, SITE_PATTERN_BUTTON_COLORS_MAX, SITE_PATTERN_KEY_PATTERN, SITE_PATTERN_PLACEMENTS_KEY, SITE_PATTERN_SLOTS, type SitePatternLayout, type SitePatternLinkStyle, type SitePatternPlacementRule, type SitePatternPlacements, type SitePatternPresentation, type SitePatternSlotKey, applyBlockBindings, bindingSrcValue, bindingTextValue, blockSchema, boundFieldValue, chainResolvers, createFieldBindingResolver, emptyPatternSlots, ensureImportedHtmlDocumentRoots, ensureStableIds, extractFaqEntries, faqPageJsonLd, findInternalContentLinkTokens, findSitePatternPlacementRule, htmlToPlainText, injectStableIdsTree, internalContentKeyFromPath, internalContentLinkResolverFrom, internalContentPathIndex, isAllowedEmbedSrc, isAllowedMapEmbedSrc, isInCollectionMode, isSitePatternSlotKey, isValidBlock, isValidSitePatternKey, issuePreviewToken, normalizeEmbed, normalizeHexColor, normalizeImageAlt, parseBlock, postsForCollection, postsInAnyCollection, postsNotInAnyCollection, readSitePatternPlacements, readSitePatternPresentation, referencedSitePatternKeys, renderInternalContentLinksInHtml, renderInternalContentLinksInText, resolveCategoryPath, resolveCategoryTreeChain, resolveCategoryTreeEntryPath, resolveCategoryTreeHubPaths, resolvePatternSlots, resolvePostCategorySlug, resolvePostCollection, resolvePostPath, resolvePostPublicPath, resolvePostUrl, sanitizeHtml, sanitizeImportedCss, sanitizeImportedHtml, scopeImportedCss, serializeBlock, setSitePatternPlacementRule, sitePatternButtonColor, sitePatternPresentationAttributes, validateCollections, verifyPreviewToken };

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;
@@ -1503,8 +1500,62 @@ 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
+  };
+}
 export {
   BLOCK_NAME_PATTERN,
+  DEFAULT_SITE_PATTERN_PRESENTATION,
   EMPTY_SITE_PATTERN_PLACEMENTS,
   FIELD_BINDING_SOURCE,
   FIELD_BINDING_SOURCE_ALIAS,
@@ -1517,6 +1568,7 @@ export {
   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,
@@ -1547,12 +1599,14 @@ export {
   isValidSitePatternKey,
   issuePreviewToken,
   normalizeEmbed,
+  normalizeHexColor,
   normalizeImageAlt,
   parseBlock,
   postsForCollection,
   postsInAnyCollection,
   postsNotInAnyCollection,
   readSitePatternPlacements,
+  readSitePatternPresentation,
   referencedSitePatternKeys,
   renderInternalContentLinksInHtml,
   renderInternalContentLinksInText,
@@ -1572,6 +1626,8 @@ export {
   scopeImportedCss,
   serializeBlock,
   setSitePatternPlacementRule,
+  sitePatternButtonColor,
+  sitePatternPresentationAttributes,
   validateCollections,
   verifyPreviewToken
 };