@roottale/cms-core 0.56.0 → 0.57.0

package/dist/index.d.cts

@@ -382,6 +382,58 @@ declare function ensureImportedHtmlDocumentRoots(html: string, allowedAssetUrls?
 /** 저장된 안전 CSS가 같은 importedHtml 블록 밖으로 새지 않도록 범위를 고정한다. */
 declare function scopeImportedCss(css: string, scope: string, allowedAssetUrls?: readonly string[]): string;
 
+declare const INTERNAL_CONTENT_LINK_TOKEN_SOURCE: string;
+interface InternalContentLinkToken {
+    /** 토큰이 시작하는 문자 인덱스(텍스트 기준). */
+    readonly index: number;
+    /** 원문 토큰 전체(`[[internal:…|…]]`). */
+    readonly raw: string;
+    /** 소문자로 정규화한 키. */
+    readonly key: string;
+    /** 표시 문구(앞뒤 공백 제거). */
+    readonly label: string;
+}
+/** 텍스트 안의 토큰을 앞에서부터 모두 찾는다. 겹치지 않는다. */
+declare function findInternalContentLinkTokens(text: string): InternalContentLinkToken[];
+/** 공개 경로(`/faq/a/b/slug`) → 키(`faq.a.b.slug`). 조각이 없으면 null. */
+declare function internalContentKeyFromPath(path: string | null | undefined): string | null;
+/** 키 → 공개 경로. 없으면 null(문구만 표시). */
+type InternalContentLinkResolver = (key: string) => string | null;
+interface InternalContentPathEntry {
+    /** 저장된 정규 공개 경로(`/faq/a/b/slug`). 없으면 대상이 아니다. */
+    readonly path?: string | null;
+    /** 옛 slug 목록 — 옛 키로 남은 본문도 현재 주소로 이어 준다. */
+    readonly previousSlugs?: readonly string[] | null;
+}
+/**
+ * 발행 글 목록에서 "키 → 현재 경로" 색인을 만든다. 옛 slug 도 같은 글로 등록한다
+ * (경로 마지막 조각을 옛 slug 로 바꾼 키). 현재 경로가 옛 키와 겹치면 현재가 이긴다.
+ */
+declare function internalContentPathIndex(entries: Iterable<InternalContentPathEntry>): Map<string, string>;
+/** Map 이나 함수 어느 쪽이든 resolver 로. */
+declare function internalContentLinkResolverFrom(source: InternalContentLinkResolver | ReadonlyMap<string, string> | null | undefined): InternalContentLinkResolver;
+/** 링크로 렌더된 토큰의 class — 사이트 CSS 가 잡을 고리. */
+declare const INTERNAL_CONTENT_LINK_CLASS = "rt-internal-link";
+/** 대상이 아직 없어 문구만 남긴 토큰의 class·data 속성. */
+declare const INTERNAL_CONTENT_LINK_PENDING_CLASS = "rt-internal-link--pending";
+declare const INTERNAL_CONTENT_LINK_PENDING_ATTR = "data-rt-internal-link-pending";
+/**
+ * 이미 이스케이프된 텍스트 한 구간의 토큰을 HTML 로 바꾼다. 텍스트 부분은 다시
+ * 이스케이프하지 않는다(정화기가 이미 처리한 값). 토큰이 없으면 원문 그대로.
+ */
+declare function renderInternalContentLinksInText(text: string, resolve: InternalContentLinkResolver): {
+    readonly html: string;
+    readonly hasTokens: boolean;
+};
+/**
+ * 정화된 HTML(원문 보존 블록 등)의 텍스트 구간에만 토큰을 적용한다. `<a>`·`<code>`·
+ * `<pre>` 안과 태그 속성값은 건드리지 않는다.
+ */
+declare function renderInternalContentLinksInHtml(html: string, resolve: InternalContentLinkResolver): {
+    readonly html: string;
+    readonly hasTokens: boolean;
+};
+
 interface PreviewTokenPayload {
     postId: string;
     expiresAt: Date;
@@ -419,4 +471,77 @@ 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, 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 };
+/**
+ * 공통 블록(Site Patterns) — 여러 글에 같은 자리로 붙는 재사용 블록의 순수 규칙.
+ *
+ * 블록 본문은 ROOT-ADMIN 이 `site_patterns` 에 저장하고, "어느 자리(slot)에 어느
+ * 유형(collection)의 글이면 어떤 블록"인지는 배치 규칙(`settings.site_pattern_placements`)
+ * 으로 정한다. 공개 API 는 글마다 `pattern_slots`(자리 → 블록 key | null) 를 계산해
+ * 내려주므로 FRONT 는 규칙을 몰라도 된다. 이 파일은 api-core(계산)·tenant-admin(편집)·
+ * cms-renderer-next(렌더)가 같은 판정을 공유하기 위한 프레임워크 비의존 모듈이다.
+ *
+ * 규칙 판정:
+ * - 자리는 `SITE_PATTERN_SLOTS` 에 선언된 것만 계산한다(미선언 자리는 무시).
+ * - 글의 `collectionKey` 와 같은 규칙이 있으면 그 규칙(블록 없음 = null 도 명시적 결정).
+ * - 없으면 `collectionKey: null`(모든 글 기본) 규칙.
+ * - 가리키는 블록이 발행 상태가 아니면 null(FRONT 가 미발행 블록을 그리지 않게).
+ */
+/** 블록을 놓을 수 있는 자리. key 는 공개 API `pattern_slots` 의 키와 같다. */
+declare const SITE_PATTERN_SLOTS: readonly [{
+    readonly key: "post_footer";
+    readonly label: "글 하단";
+    readonly description: "글 본문 바로 아래";
+}];
+type SitePatternSlotKey = (typeof SITE_PATTERN_SLOTS)[number]["key"];
+declare const POST_FOOTER_SLOT: SitePatternSlotKey;
+/** 배치 규칙을 담는 `settings` 키. */
+declare const SITE_PATTERN_PLACEMENTS_KEY = "site_pattern_placements";
+/** 블록 key 형식 — 소문자·숫자·`-`·`_`, 64자 이하, 영숫자로 시작. */
+declare const SITE_PATTERN_KEY_PATTERN: RegExp;
+declare function isValidSitePatternKey(key: string): boolean;
+declare function isSitePatternSlotKey(value: string): value is SitePatternSlotKey;
+/**
+ * 배치 규칙 1건. `collectionKey: null` = 모든 글의 기본값, 문자열 = 그 유형의 글만.
+ * `patternKey: null` = 이 자리에 블록을 놓지 않는다(유형 규칙이면 기본값 덮어쓰기).
+ */
+interface SitePatternPlacementRule {
+    readonly slot: SitePatternSlotKey;
+    readonly collectionKey: string | null;
+    readonly patternKey: string | null;
+}
+interface SitePatternPlacements {
+    readonly rules: readonly SitePatternPlacementRule[];
+}
+declare const EMPTY_SITE_PATTERN_PLACEMENTS: SitePatternPlacements;
+/** 글 1건의 자리별 블록 key. 선언된 모든 자리를 키로 가진다(없으면 null). */
+type PatternSlots = Record<string, string | null>;
+/**
+ * 저장된 값(unknown) → 정규화된 배치 규칙. 형식이 틀린 항목·미선언 자리는 버리고,
+ * 같은 (slot, collectionKey) 는 마지막 항목이 이긴다. 이중 인코딩된 JSON 문자열도 받는다.
+ */
+declare function readSitePatternPlacements(raw: unknown): SitePatternPlacements;
+/** (slot, collectionKey) 에 해당하는 규칙. 없으면 undefined(= 기본값으로 위임). */
+declare function findSitePatternPlacementRule(placements: SitePatternPlacements, slot: SitePatternSlotKey, collectionKey: string | null): SitePatternPlacementRule | undefined;
+/**
+ * 규칙 1건을 갈아 끼운 새 배치 규칙을 돌려준다(불변). `patternKey: undefined` 는
+ * "규칙 삭제 = 기본값으로 위임"이다 — 유형 규칙에서 "표시 안 함"(null)과 구분된다.
+ */
+declare function setSitePatternPlacementRule(placements: SitePatternPlacements, target: {
+    slot: SitePatternSlotKey;
+    collectionKey: string | null;
+}, patternKey: string | null | undefined): SitePatternPlacements;
+/** 선언된 자리마다 null 인 빈 결과 — 규칙이나 발행 블록이 없을 때의 기본 응답. */
+declare function emptyPatternSlots(): PatternSlots;
+/**
+ * 글 1건의 자리별 블록 key 를 계산한다. `publishedKeys` 에 없는 블록(미발행·삭제)은 null.
+ */
+declare function resolvePatternSlots(post: {
+    readonly collectionKey: string | null;
+}, placements: SitePatternPlacements, publishedKeys: ReadonlySet<string>): PatternSlots;
+/**
+ * 규칙에서 참조하는 블록 key 집합 — 어드민이 "이 블록은 어디에 쓰이는가"를 표시하거나
+ * 삭제 전 경고할 때 쓴다.
+ */
+declare function referencedSitePatternKeys(placements: SitePatternPlacements): ReadonlySet<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 };

package/dist/index.d.ts

@@ -382,6 +382,58 @@ declare function ensureImportedHtmlDocumentRoots(html: string, allowedAssetUrls?
 /** 저장된 안전 CSS가 같은 importedHtml 블록 밖으로 새지 않도록 범위를 고정한다. */
 declare function scopeImportedCss(css: string, scope: string, allowedAssetUrls?: readonly string[]): string;
 
+declare const INTERNAL_CONTENT_LINK_TOKEN_SOURCE: string;
+interface InternalContentLinkToken {
+    /** 토큰이 시작하는 문자 인덱스(텍스트 기준). */
+    readonly index: number;
+    /** 원문 토큰 전체(`[[internal:…|…]]`). */
+    readonly raw: string;
+    /** 소문자로 정규화한 키. */
+    readonly key: string;
+    /** 표시 문구(앞뒤 공백 제거). */
+    readonly label: string;
+}
+/** 텍스트 안의 토큰을 앞에서부터 모두 찾는다. 겹치지 않는다. */
+declare function findInternalContentLinkTokens(text: string): InternalContentLinkToken[];
+/** 공개 경로(`/faq/a/b/slug`) → 키(`faq.a.b.slug`). 조각이 없으면 null. */
+declare function internalContentKeyFromPath(path: string | null | undefined): string | null;
+/** 키 → 공개 경로. 없으면 null(문구만 표시). */
+type InternalContentLinkResolver = (key: string) => string | null;
+interface InternalContentPathEntry {
+    /** 저장된 정규 공개 경로(`/faq/a/b/slug`). 없으면 대상이 아니다. */
+    readonly path?: string | null;
+    /** 옛 slug 목록 — 옛 키로 남은 본문도 현재 주소로 이어 준다. */
+    readonly previousSlugs?: readonly string[] | null;
+}
+/**
+ * 발행 글 목록에서 "키 → 현재 경로" 색인을 만든다. 옛 slug 도 같은 글로 등록한다
+ * (경로 마지막 조각을 옛 slug 로 바꾼 키). 현재 경로가 옛 키와 겹치면 현재가 이긴다.
+ */
+declare function internalContentPathIndex(entries: Iterable<InternalContentPathEntry>): Map<string, string>;
+/** Map 이나 함수 어느 쪽이든 resolver 로. */
+declare function internalContentLinkResolverFrom(source: InternalContentLinkResolver | ReadonlyMap<string, string> | null | undefined): InternalContentLinkResolver;
+/** 링크로 렌더된 토큰의 class — 사이트 CSS 가 잡을 고리. */
+declare const INTERNAL_CONTENT_LINK_CLASS = "rt-internal-link";
+/** 대상이 아직 없어 문구만 남긴 토큰의 class·data 속성. */
+declare const INTERNAL_CONTENT_LINK_PENDING_CLASS = "rt-internal-link--pending";
+declare const INTERNAL_CONTENT_LINK_PENDING_ATTR = "data-rt-internal-link-pending";
+/**
+ * 이미 이스케이프된 텍스트 한 구간의 토큰을 HTML 로 바꾼다. 텍스트 부분은 다시
+ * 이스케이프하지 않는다(정화기가 이미 처리한 값). 토큰이 없으면 원문 그대로.
+ */
+declare function renderInternalContentLinksInText(text: string, resolve: InternalContentLinkResolver): {
+    readonly html: string;
+    readonly hasTokens: boolean;
+};
+/**
+ * 정화된 HTML(원문 보존 블록 등)의 텍스트 구간에만 토큰을 적용한다. `<a>`·`<code>`·
+ * `<pre>` 안과 태그 속성값은 건드리지 않는다.
+ */
+declare function renderInternalContentLinksInHtml(html: string, resolve: InternalContentLinkResolver): {
+    readonly html: string;
+    readonly hasTokens: boolean;
+};
+
 interface PreviewTokenPayload {
     postId: string;
     expiresAt: Date;
@@ -419,4 +471,77 @@ 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, 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 };
+/**
+ * 공통 블록(Site Patterns) — 여러 글에 같은 자리로 붙는 재사용 블록의 순수 규칙.
+ *
+ * 블록 본문은 ROOT-ADMIN 이 `site_patterns` 에 저장하고, "어느 자리(slot)에 어느
+ * 유형(collection)의 글이면 어떤 블록"인지는 배치 규칙(`settings.site_pattern_placements`)
+ * 으로 정한다. 공개 API 는 글마다 `pattern_slots`(자리 → 블록 key | null) 를 계산해
+ * 내려주므로 FRONT 는 규칙을 몰라도 된다. 이 파일은 api-core(계산)·tenant-admin(편집)·
+ * cms-renderer-next(렌더)가 같은 판정을 공유하기 위한 프레임워크 비의존 모듈이다.
+ *
+ * 규칙 판정:
+ * - 자리는 `SITE_PATTERN_SLOTS` 에 선언된 것만 계산한다(미선언 자리는 무시).
+ * - 글의 `collectionKey` 와 같은 규칙이 있으면 그 규칙(블록 없음 = null 도 명시적 결정).
+ * - 없으면 `collectionKey: null`(모든 글 기본) 규칙.
+ * - 가리키는 블록이 발행 상태가 아니면 null(FRONT 가 미발행 블록을 그리지 않게).
+ */
+/** 블록을 놓을 수 있는 자리. key 는 공개 API `pattern_slots` 의 키와 같다. */
+declare const SITE_PATTERN_SLOTS: readonly [{
+    readonly key: "post_footer";
+    readonly label: "글 하단";
+    readonly description: "글 본문 바로 아래";
+}];
+type SitePatternSlotKey = (typeof SITE_PATTERN_SLOTS)[number]["key"];
+declare const POST_FOOTER_SLOT: SitePatternSlotKey;
+/** 배치 규칙을 담는 `settings` 키. */
+declare const SITE_PATTERN_PLACEMENTS_KEY = "site_pattern_placements";
+/** 블록 key 형식 — 소문자·숫자·`-`·`_`, 64자 이하, 영숫자로 시작. */
+declare const SITE_PATTERN_KEY_PATTERN: RegExp;
+declare function isValidSitePatternKey(key: string): boolean;
+declare function isSitePatternSlotKey(value: string): value is SitePatternSlotKey;
+/**
+ * 배치 규칙 1건. `collectionKey: null` = 모든 글의 기본값, 문자열 = 그 유형의 글만.
+ * `patternKey: null` = 이 자리에 블록을 놓지 않는다(유형 규칙이면 기본값 덮어쓰기).
+ */
+interface SitePatternPlacementRule {
+    readonly slot: SitePatternSlotKey;
+    readonly collectionKey: string | null;
+    readonly patternKey: string | null;
+}
+interface SitePatternPlacements {
+    readonly rules: readonly SitePatternPlacementRule[];
+}
+declare const EMPTY_SITE_PATTERN_PLACEMENTS: SitePatternPlacements;
+/** 글 1건의 자리별 블록 key. 선언된 모든 자리를 키로 가진다(없으면 null). */
+type PatternSlots = Record<string, string | null>;
+/**
+ * 저장된 값(unknown) → 정규화된 배치 규칙. 형식이 틀린 항목·미선언 자리는 버리고,
+ * 같은 (slot, collectionKey) 는 마지막 항목이 이긴다. 이중 인코딩된 JSON 문자열도 받는다.
+ */
+declare function readSitePatternPlacements(raw: unknown): SitePatternPlacements;
+/** (slot, collectionKey) 에 해당하는 규칙. 없으면 undefined(= 기본값으로 위임). */
+declare function findSitePatternPlacementRule(placements: SitePatternPlacements, slot: SitePatternSlotKey, collectionKey: string | null): SitePatternPlacementRule | undefined;
+/**
+ * 규칙 1건을 갈아 끼운 새 배치 규칙을 돌려준다(불변). `patternKey: undefined` 는
+ * "규칙 삭제 = 기본값으로 위임"이다 — 유형 규칙에서 "표시 안 함"(null)과 구분된다.
+ */
+declare function setSitePatternPlacementRule(placements: SitePatternPlacements, target: {
+    slot: SitePatternSlotKey;
+    collectionKey: string | null;
+}, patternKey: string | null | undefined): SitePatternPlacements;
+/** 선언된 자리마다 null 인 빈 결과 — 규칙이나 발행 블록이 없을 때의 기본 응답. */
+declare function emptyPatternSlots(): PatternSlots;
+/**
+ * 글 1건의 자리별 블록 key 를 계산한다. `publishedKeys` 에 없는 블록(미발행·삭제)은 null.
+ */
+declare function resolvePatternSlots(post: {
+    readonly collectionKey: string | null;
+}, placements: SitePatternPlacements, publishedKeys: ReadonlySet<string>): PatternSlots;
+/**
+ * 규칙에서 참조하는 블록 key 집합 — 어드민이 "이 블록은 어디에 쓰이는가"를 표시하거나
+ * 삭제 전 경고할 때 쓴다.
+ */
+declare function referencedSitePatternKeys(placements: SitePatternPlacements): ReadonlySet<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 };

package/dist/index.js

@@ -959,6 +959,152 @@ function scopeImportedCss(css, scope, allowedAssetUrls = []) {
   }
 }
 
+// src/internal-content-links.ts
+var INTERNAL_CONTENT_LINK_TOKEN_SOURCE = String.raw`\[\[internal:([a-z0-9가-힣]+(?:[.-][a-z0-9가-힣]+)*)\|([^\]\n|]+)\]\]`;
+function findInternalContentLinkTokens(text) {
+  const pattern = new RegExp(INTERNAL_CONTENT_LINK_TOKEN_SOURCE, "giu");
+  const tokens = [];
+  for (const match of text.matchAll(pattern)) {
+    const [raw, key, label] = match;
+    if (!key || !label || match.index === void 0) continue;
+    tokens.push({
+      index: match.index,
+      raw,
+      key: key.toLowerCase(),
+      label: label.trim()
+    });
+  }
+  return tokens;
+}
+function internalContentKeyFromPath(path) {
+  if (!path) return null;
+  const segments = path.split("/").filter(Boolean).map((segment) => {
+    try {
+      return decodeURIComponent(segment).trim().toLowerCase();
+    } catch {
+      return "";
+    }
+  });
+  if (segments.length === 0 || segments.some((segment) => segment === "" || segment.includes("."))) {
+    return null;
+  }
+  return segments.join(".");
+}
+function internalContentPathIndex(entries) {
+  const index = /* @__PURE__ */ new Map();
+  const previous = /* @__PURE__ */ new Map();
+  for (const entry of entries) {
+    const path = entry.path;
+    const key = internalContentKeyFromPath(path);
+    if (!path || !key) continue;
+    index.set(key, path);
+    const segments = key.split(".");
+    for (const oldSlug of entry.previousSlugs ?? []) {
+      const oldKey = [...segments.slice(0, -1), oldSlug.trim().toLowerCase()].join(".");
+      if (oldKey && !oldKey.includes("..")) previous.set(oldKey, path);
+    }
+  }
+  for (const [key, path] of previous) {
+    if (!index.has(key)) index.set(key, path);
+  }
+  return index;
+}
+function internalContentLinkResolverFrom(source) {
+  if (!source) return () => null;
+  if (typeof source === "function") return source;
+  return (key) => source.get(key.toLowerCase()) ?? null;
+}
+function isSafeInternalPath(path) {
+  return typeof path === "string" && path.startsWith("/") && !path.startsWith("//");
+}
+function escapeHtmlText(value) {
+  return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+}
+var INTERNAL_CONTENT_LINK_CLASS = "rt-internal-link";
+var INTERNAL_CONTENT_LINK_PENDING_CLASS = "rt-internal-link--pending";
+var INTERNAL_CONTENT_LINK_PENDING_ATTR = "data-rt-internal-link-pending";
+function renderInternalContentLinksInText(text, resolve) {
+  const tokens = findInternalContentLinkTokens(text);
+  if (tokens.length === 0) return { html: text, hasTokens: false };
+  let cursor = 0;
+  let html = "";
+  for (const token of tokens) {
+    html += text.slice(cursor, token.index);
+    const path = resolve(token.key);
+    const label = escapeHtmlText(token.label);
+    html += isSafeInternalPath(path) ? `<a href="${escapeHtmlText(path)}" class="${INTERNAL_CONTENT_LINK_CLASS}">${label}</a>` : `<span class="${INTERNAL_CONTENT_LINK_CLASS} ${INTERNAL_CONTENT_LINK_PENDING_CLASS}" ${INTERNAL_CONTENT_LINK_PENDING_ATTR}="${escapeHtmlText(token.key)}">${label}</span>`;
+    cursor = token.index + token.raw.length;
+  }
+  html += text.slice(cursor);
+  return { html, hasTokens: true };
+}
+var INTERNAL_LINK_BLOCKED_HTML_TAGS = /* @__PURE__ */ new Set([
+  "a",
+  "code",
+  "pre",
+  "script",
+  "style",
+  "textarea"
+]);
+var VOID_HTML_TAGS = /* @__PURE__ */ new Set(["br", "hr", "img", "input", "source", "wbr"]);
+function htmlTagEnd(html, start) {
+  let quote = null;
+  for (let index = start + 1; index < html.length; index += 1) {
+    const character = html[index];
+    if (quote) {
+      if (character === quote) quote = null;
+      continue;
+    }
+    if (character === '"' || character === "'") {
+      quote = character;
+      continue;
+    }
+    if (character === ">") return index;
+  }
+  return -1;
+}
+function renderInternalContentLinksInHtml(html, resolve) {
+  if (!html.includes("[[internal:")) return { html, hasTokens: false };
+  let blockedDepth = 0;
+  let cursor = 0;
+  let out = "";
+  let hasTokens = false;
+  const emitText = (text) => {
+    if (blockedDepth > 0 || !text) {
+      out += text;
+      return;
+    }
+    const rendered = renderInternalContentLinksInText(text, resolve);
+    hasTokens ||= rendered.hasTokens;
+    out += rendered.html;
+  };
+  while (cursor < html.length) {
+    const tagStart = html.indexOf("<", cursor);
+    if (tagStart < 0) {
+      emitText(html.slice(cursor));
+      break;
+    }
+    emitText(html.slice(cursor, tagStart));
+    const tagEnd = htmlTagEnd(html, tagStart);
+    if (tagEnd < 0) {
+      out += html.slice(tagStart);
+      break;
+    }
+    const tag = html.slice(tagStart, tagEnd + 1);
+    out += tag;
+    const parsed = /^<\s*(\/?)\s*([a-z0-9-]+)/i.exec(tag);
+    const tagName = parsed?.[2]?.toLowerCase();
+    if (tagName && INTERNAL_LINK_BLOCKED_HTML_TAGS.has(tagName)) {
+      const isClosing = parsed?.[1] === "/";
+      const isVoid = VOID_HTML_TAGS.has(tagName) || /\/\s*>$/.test(tag);
+      if (isClosing) blockedDepth = Math.max(0, blockedDepth - 1);
+      else if (!isVoid) blockedDepth += 1;
+    }
+    cursor = tagEnd + 1;
+  }
+  return { html: out, hasTokens };
+}
+
 // src/preview-token.ts
 import { createHmac, randomBytes, timingSafeEqual } from "crypto";
 var DELIMITER = ".";
@@ -1266,14 +1412,114 @@ function ensureStableIds(block) {
 function injectStableIdsTree(blocks) {
   return blocks.map((b) => ensureStableIds(b));
 }
+
+// src/site-patterns.ts
+var SITE_PATTERN_SLOTS = [
+  { key: "post_footer", label: "\uAE00 \uD558\uB2E8", description: "\uAE00 \uBCF8\uBB38 \uBC14\uB85C \uC544\uB798" }
+];
+var POST_FOOTER_SLOT = "post_footer";
+var SITE_PATTERN_PLACEMENTS_KEY = "site_pattern_placements";
+var SITE_PATTERN_KEY_PATTERN = /^[a-z0-9][a-z0-9_-]{0,63}$/;
+function isValidSitePatternKey(key) {
+  return SITE_PATTERN_KEY_PATTERN.test(key);
+}
+function isSitePatternSlotKey(value) {
+  return SITE_PATTERN_SLOTS.some((slot) => slot.key === value);
+}
+var EMPTY_SITE_PATTERN_PLACEMENTS = { rules: [] };
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function readNullableKey(value) {
+  if (value === null) return null;
+  if (typeof value === "string") {
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : null;
+  }
+  return void 0;
+}
+function readSitePatternPlacements(raw) {
+  let value = raw;
+  if (typeof value === "string") {
+    try {
+      value = JSON.parse(value);
+    } catch {
+      return EMPTY_SITE_PATTERN_PLACEMENTS;
+    }
+  }
+  if (!isRecord(value) || !Array.isArray(value.rules)) {
+    return EMPTY_SITE_PATTERN_PLACEMENTS;
+  }
+  const byTarget = /* @__PURE__ */ new Map();
+  for (const item of value.rules) {
+    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 patternKey = readNullableKey(item.patternKey);
+    if (patternKey === void 0) continue;
+    if (patternKey !== null && !isValidSitePatternKey(patternKey)) continue;
+    byTarget.set(`${slot}\0${collectionKey ?? ""}`, {
+      slot,
+      collectionKey,
+      patternKey
+    });
+  }
+  return { rules: [...byTarget.values()] };
+}
+function findSitePatternPlacementRule(placements, slot, collectionKey) {
+  return placements.rules.find(
+    (rule) => rule.slot === slot && rule.collectionKey === collectionKey
+  );
+}
+function setSitePatternPlacementRule(placements, target, patternKey) {
+  const rest = placements.rules.filter(
+    (rule) => !(rule.slot === target.slot && rule.collectionKey === target.collectionKey)
+  );
+  if (patternKey === void 0) return { rules: rest };
+  return {
+    rules: [
+      ...rest,
+      { slot: target.slot, collectionKey: target.collectionKey, patternKey }
+    ]
+  };
+}
+function emptyPatternSlots() {
+  return Object.fromEntries(SITE_PATTERN_SLOTS.map((slot) => [slot.key, null]));
+}
+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 rule = specific ?? findSitePatternPlacementRule(placements, slot.key, null);
+    const key = rule?.patternKey ?? null;
+    slots[slot.key] = key !== null && publishedKeys.has(key) ? key : null;
+  }
+  return slots;
+}
+function referencedSitePatternKeys(placements) {
+  return new Set(
+    placements.rules.map((rule) => rule.patternKey).filter((key) => key !== null)
+  );
+}
 export {
   BLOCK_NAME_PATTERN,
+  EMPTY_SITE_PATTERN_PLACEMENTS,
   FIELD_BINDING_SOURCE,
   FIELD_BINDING_SOURCE_ALIAS,
   IMAGE_ALT_MAX_LENGTH,
+  INTERNAL_CONTENT_LINK_CLASS,
+  INTERNAL_CONTENT_LINK_PENDING_ATTR,
+  INTERNAL_CONTENT_LINK_PENDING_CLASS,
+  INTERNAL_CONTENT_LINK_TOKEN_SOURCE,
   LEGACY_BLOG_DETAIL_PATH,
   PHASE_1_CORE_BLOCKS,
   PHASE_1_CSP,
+  POST_FOOTER_SLOT,
+  SITE_PATTERN_KEY_PATTERN,
+  SITE_PATTERN_PLACEMENTS_KEY,
+  SITE_PATTERN_SLOTS,
   applyBlockBindings,
   bindingSrcValue,
   bindingTextValue,
@@ -1281,16 +1527,24 @@ export {
   boundFieldValue,
   chainResolvers,
   createFieldBindingResolver,
+  emptyPatternSlots,
   ensureImportedHtmlDocumentRoots,
   ensureStableIds,
   extractFaqEntries,
   faqPageJsonLd,
+  findInternalContentLinkTokens,
+  findSitePatternPlacementRule,
   htmlToPlainText,
   injectStableIdsTree,
+  internalContentKeyFromPath,
+  internalContentLinkResolverFrom,
+  internalContentPathIndex,
   isAllowedEmbedSrc,
   isAllowedMapEmbedSrc,
   isInCollectionMode,
+  isSitePatternSlotKey,
   isValidBlock,
+  isValidSitePatternKey,
   issuePreviewToken,
   normalizeEmbed,
   normalizeImageAlt,
@@ -1298,10 +1552,15 @@ export {
   postsForCollection,
   postsInAnyCollection,
   postsNotInAnyCollection,
+  readSitePatternPlacements,
+  referencedSitePatternKeys,
+  renderInternalContentLinksInHtml,
+  renderInternalContentLinksInText,
   resolveCategoryPath,
   resolveCategoryTreeChain,
   resolveCategoryTreeEntryPath,
   resolveCategoryTreeHubPaths,
+  resolvePatternSlots,
   resolvePostCategorySlug,
   resolvePostCollection,
   resolvePostPath,
@@ -1312,6 +1571,7 @@ export {
   sanitizeImportedHtml,
   scopeImportedCss,
   serializeBlock,
+  setSitePatternPlacementRule,
   validateCollections,
   verifyPreviewToken
 };