@roottale/cms-core 0.65.1 → 0.67.0

package/dist/index.d.ts

@@ -207,9 +207,17 @@ declare function validateCollections(collections: readonly RouteCollection[]): s
  * FAQ·도움말·문서처럼 하나의 모델이 여러 단계 분류 허브를 가지는 경우에 쓴다.
  * 저장소나 프레임워크를 모르며, 공개 API와 ROOT-ADMIN이 같은 계산을 재사용한다.
  */
+/**
+ * 글을 붙일 수 있는 분류.
+ * - `deepest`(기본): `categoryDepth` 단계의 말단 분류에만 붙는다.
+ * - `leaf`: 하위 분류가 없는 분류면 단계와 무관하게 붙는다(`categoryDepth`는 최대 단계).
+ *   하위가 필요한 영역만 나누고 나머지는 상위 분류에 바로 글을 쓸 때 쓴다.
+ */
+type CategoryTreeEntryCategory = "deepest" | "leaf";
 interface CategoryTreePresentation {
     readonly basePath: string;
     readonly categoryDepth: number;
+    readonly entryCategory?: CategoryTreeEntryCategory;
 }
 interface CategoryTreeTerm {
     readonly id: string;
@@ -224,10 +232,19 @@ interface CategoryTreeEntry {
     }>;
 }
 /**
- * 선택한 말단 분류부터 루트까지의 사슬을 루트→말단 순서로 돌려준다.
- * 끊긴 부모·순환·중복 id·깊이 불일치·말단이 아닌 선택은 null로 닫는다.
+ * 글 주소에 쓰는 분류의 루트→분류 사슬. 주소를 만들 수 없으면 null.
+ *
+ * - `deepest`: 정확히 `categoryDepth` 단계의 말단이어야 한다.
+ * - `leaf`: `categoryDepth` 이하면 된다. 하위가 없는지는 *새로 고를 때*만 본다
+ *   (`resolveCategoryTreeSelection`) — 글이 붙은 뒤 하위 분류가 생겨도 이미 발행한
+ *   글의 주소는 그대로 살아 있어야 한다.
+ */
+declare function resolveCategoryTreeChain(presentation: CategoryTreePresentation, termId: string, terms: readonly CategoryTreeTerm[]): CategoryTreeTerm[] | null;
+/**
+ * 글에 새로 고를 수 있는 분류의 사슬 — 주소를 만들 수 있고 지금 하위 분류가 없어야
+ * 한다. 편집기 선택지와 발행 검사가 같은 규칙을 쓴다.
  */
-declare function resolveCategoryTreeChain(presentation: CategoryTreePresentation, leafId: string, terms: readonly CategoryTreeTerm[]): CategoryTreeTerm[] | null;
+declare function resolveCategoryTreeSelection(presentation: CategoryTreePresentation, termId: string, terms: readonly CategoryTreeTerm[]): CategoryTreeTerm[] | null;
 /** 루트부터 선택 분류까지 모든 허브 주소. */
 declare function resolveCategoryTreeHubPaths(presentation: CategoryTreePresentation, termId: string, terms: readonly CategoryTreeTerm[]): string[] | null;
 /** 계층형 분류 모델 항목의 정규 상세 주소. */
@@ -258,6 +275,7 @@ type PublicPathPresentation = {
     readonly kind: "category_tree";
     readonly basePath: string;
     readonly categoryDepth: number;
+    readonly entryCategory?: CategoryTreeEntryCategory;
 };
 interface PublicPathPost {
     readonly slug: string;
@@ -612,4 +630,550 @@ declare function isSectionContentPropPath(sectionType: string, path: readonly (s
 declare function findSectionLockViolations(beforeDoc: unknown, afterDoc: unknown): SectionLockViolation[];
 declare function formatSectionLockViolations(violations: readonly SectionLockViolation[]): string;
 
-export { BLOCK_NAME_PATTERN, type BindingResolver, type Block, type BlockBinding, type BlockDefinition, type BlockRegistry, CMS_FONT_SIZES, CMS_IMAGE_WIDTHS, CMS_LINE_HEIGHTS, CMS_PARAGRAPH_SPACINGS, 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 SectionLock, type SectionLockViolation, type SectionLockViolationCode, type SitePatternLayout, type SitePatternLinkStyle, type SitePatternPlacementRule, type SitePatternPlacements, type SitePatternPresentation, type SitePatternSlotKey, applyBlockBindings, bindingSrcValue, bindingTextValue, blockSchema, boundFieldValue, chainResolvers, cmsFontSize, cmsImageAlign, cmsImageStyle, cmsImageWidth, cmsLineHeight, cmsParagraphSpacing, createFieldBindingResolver, emptyPatternSlots, ensureImportedHtmlDocumentRoots, ensureStableIds, extractFaqEntries, faqPageJsonLd, findInternalContentLinkTokens, findSectionLockViolations, findSitePatternPlacementRule, formatSectionLockViolations, htmlToPlainText, injectStableIdsTree, internalContentKeyFromPath, internalContentLinkResolverFrom, internalContentPathIndex, isAllowedEmbedSrc, isAllowedMapEmbedSrc, isInCollectionMode, isSectionContentPropPath, 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 };
+declare const METADATA_FIELDS: readonly ["title", "description", "ogImage", "ogImageAlt", "noindex", "nofollow"];
+declare const MetadataFieldSchema: z.ZodEnum<["title", "description", "ogImage", "ogImageAlt", "noindex", "nofollow"]>;
+type MetadataField = z.infer<typeof MetadataFieldSchema>;
+declare const MetadataTargetKindSchema: z.ZodEnum<["route", "post", "term"]>;
+type MetadataTargetKind = z.infer<typeof MetadataTargetKindSchema>;
+/** Empty/omitted values inherit defaults. Canonical remains owned by site routing. */
+declare const MetadataValuesSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    ogImage: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    ogImageAlt: z.ZodOptional<z.ZodString>;
+    noindex: z.ZodOptional<z.ZodBoolean>;
+    nofollow: z.ZodOptional<z.ZodBoolean>;
+}, "strict", z.ZodTypeAny, {
+    title?: string | undefined;
+    description?: string | undefined;
+    ogImage?: string | undefined;
+    ogImageAlt?: string | undefined;
+    noindex?: boolean | undefined;
+    nofollow?: boolean | undefined;
+}, {
+    title?: string | undefined;
+    description?: string | undefined;
+    ogImage?: string | undefined;
+    ogImageAlt?: string | undefined;
+    noindex?: boolean | undefined;
+    nofollow?: boolean | undefined;
+}>;
+type MetadataValues = z.infer<typeof MetadataValuesSchema>;
+declare const MetadataPatchSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    ogImage: z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodString, string, string>>>;
+    ogImageAlt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    noindex: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    nofollow: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+}, "strict", z.ZodTypeAny, {
+    title?: string | null | undefined;
+    description?: string | null | undefined;
+    ogImage?: string | null | undefined;
+    ogImageAlt?: string | null | undefined;
+    noindex?: boolean | null | undefined;
+    nofollow?: boolean | null | undefined;
+}, {
+    title?: string | null | undefined;
+    description?: string | null | undefined;
+    ogImage?: string | null | undefined;
+    ogImageAlt?: string | null | undefined;
+    noindex?: boolean | null | undefined;
+    nofollow?: boolean | null | undefined;
+}>;
+type MetadataPatch = z.infer<typeof MetadataPatchSchema>;
+declare const MetadataRobotsPolicySchema: z.ZodObject<{
+    forceNoindex: z.ZodOptional<z.ZodBoolean>;
+    forceNofollow: z.ZodOptional<z.ZodBoolean>;
+}, "strict", z.ZodTypeAny, {
+    forceNoindex?: boolean | undefined;
+    forceNofollow?: boolean | undefined;
+}, {
+    forceNoindex?: boolean | undefined;
+    forceNofollow?: boolean | undefined;
+}>;
+type MetadataRobotsPolicy = z.infer<typeof MetadataRobotsPolicySchema>;
+interface MetadataTarget {
+    readonly kind: MetadataTargetKind;
+    readonly key: string;
+    readonly locale: string;
+    readonly label: string;
+    readonly path: string | null;
+    /** Opaque CAS token. Consumers must not parse or increment it. */
+    readonly version: string;
+    readonly overrides: MetadataValues;
+    readonly defaults: MetadataValues;
+    readonly fallback?: MetadataValues;
+    readonly effective: MetadataValues;
+    readonly supportedFields: MetadataField[];
+    readonly robots?: MetadataRobotsPolicy;
+    readonly connection: "connected" | "unconnected" | "removed";
+}
+interface PublicRouteMetadata {
+    readonly routeKey: string;
+    readonly locale: string;
+    readonly path: string;
+    readonly version: string;
+    readonly overrides: MetadataValues;
+    readonly defaults: MetadataValues;
+    readonly fallback?: MetadataValues;
+    readonly effective: MetadataValues;
+    readonly supportedFields: MetadataField[];
+    readonly robots?: MetadataRobotsPolicy;
+}
+/** Read recognized, valid legacy fields without losing false or accepting arbitrary head HTML. */
+declare function readMetadataValues(input: unknown): MetadataValues;
+/** Preserve legacy namespaces (including canonical) while changing only the requested fields. */
+declare function mergeMetadataPatch(current: Record<string, unknown>, input: MetadataPatch): Record<string, unknown>;
+
+/** 같은 필드의 우선순위: 직접 설정 → 콘텐츠/코드 기본값 → 사이트 기본값 → 코드 fallback. */
+interface MetadataResolutionInput {
+    overrides?: MetadataValues | null;
+    defaults?: MetadataValues | null;
+    siteDefaults?: MetadataValues | null;
+    fallback?: MetadataValues | null;
+    robots?: MetadataRobotsPolicy;
+    /** 상대 이미지 경로를 절대 주소로 바꿀 기준 URL. canonical 정책에는 관여하지 않는다. */
+    imageBaseUrl?: string;
+}
+/** 글·분류·코드 경로가 공유하는 순수 해석기. false는 상속을 덮는 명시값이다. */
+declare function resolveMetadata(input: MetadataResolutionInput): MetadataValues;
+
+/** A fixed set of content cleanup rules; never accept executable expressions or caller regexes. */
+declare const MetadataTextRuleSchema: z.ZodEffects<z.ZodObject<{
+    source: z.ZodOptional<z.ZodEnum<["content", "fallback"]>>;
+    stripLeadingLabel: z.ZodOptional<z.ZodEnum<["question", "answer"]>>;
+    replaceLineBreakTokens: z.ZodOptional<z.ZodBoolean>;
+    removeEmDashes: z.ZodOptional<z.ZodBoolean>;
+    normalizeWhitespace: z.ZodOptional<z.ZodBoolean>;
+    maxLength: z.ZodOptional<z.ZodNumber>;
+    ellipsis: z.ZodOptional<z.ZodString>;
+    fallback: z.ZodOptional<z.ZodString>;
+    fallbackWithParent: z.ZodOptional<z.ZodString>;
+    fallbackWithoutParent: z.ZodOptional<z.ZodString>;
+    fallbackBySlug: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, "strict", z.ZodTypeAny, {
+    source?: "content" | "fallback" | undefined;
+    fallback?: string | undefined;
+    stripLeadingLabel?: "question" | "answer" | undefined;
+    replaceLineBreakTokens?: boolean | undefined;
+    removeEmDashes?: boolean | undefined;
+    normalizeWhitespace?: boolean | undefined;
+    maxLength?: number | undefined;
+    ellipsis?: string | undefined;
+    fallbackWithParent?: string | undefined;
+    fallbackWithoutParent?: string | undefined;
+    fallbackBySlug?: Record<string, string> | undefined;
+}, {
+    source?: "content" | "fallback" | undefined;
+    fallback?: string | undefined;
+    stripLeadingLabel?: "question" | "answer" | undefined;
+    replaceLineBreakTokens?: boolean | undefined;
+    removeEmDashes?: boolean | undefined;
+    normalizeWhitespace?: boolean | undefined;
+    maxLength?: number | undefined;
+    ellipsis?: string | undefined;
+    fallbackWithParent?: string | undefined;
+    fallbackWithoutParent?: string | undefined;
+    fallbackBySlug?: Record<string, string> | undefined;
+}>, {
+    source?: "content" | "fallback" | undefined;
+    fallback?: string | undefined;
+    stripLeadingLabel?: "question" | "answer" | undefined;
+    replaceLineBreakTokens?: boolean | undefined;
+    removeEmDashes?: boolean | undefined;
+    normalizeWhitespace?: boolean | undefined;
+    maxLength?: number | undefined;
+    ellipsis?: string | undefined;
+    fallbackWithParent?: string | undefined;
+    fallbackWithoutParent?: string | undefined;
+    fallbackBySlug?: Record<string, string> | undefined;
+}, {
+    source?: "content" | "fallback" | undefined;
+    fallback?: string | undefined;
+    stripLeadingLabel?: "question" | "answer" | undefined;
+    replaceLineBreakTokens?: boolean | undefined;
+    removeEmDashes?: boolean | undefined;
+    normalizeWhitespace?: boolean | undefined;
+    maxLength?: number | undefined;
+    ellipsis?: string | undefined;
+    fallbackWithParent?: string | undefined;
+    fallbackWithoutParent?: string | undefined;
+    fallbackBySlug?: Record<string, string> | undefined;
+}>;
+type MetadataTextRule = z.infer<typeof MetadataTextRuleSchema>;
+declare const MetadataDefaultRulesSchema: z.ZodEffects<z.ZodObject<{
+    title: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        source: z.ZodOptional<z.ZodEnum<["content", "fallback"]>>;
+        stripLeadingLabel: z.ZodOptional<z.ZodEnum<["question", "answer"]>>;
+        replaceLineBreakTokens: z.ZodOptional<z.ZodBoolean>;
+        removeEmDashes: z.ZodOptional<z.ZodBoolean>;
+        normalizeWhitespace: z.ZodOptional<z.ZodBoolean>;
+        maxLength: z.ZodOptional<z.ZodNumber>;
+        ellipsis: z.ZodOptional<z.ZodString>;
+        fallback: z.ZodOptional<z.ZodString>;
+        fallbackWithParent: z.ZodOptional<z.ZodString>;
+        fallbackWithoutParent: z.ZodOptional<z.ZodString>;
+        fallbackBySlug: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, "strict", z.ZodTypeAny, {
+        source?: "content" | "fallback" | undefined;
+        fallback?: string | undefined;
+        stripLeadingLabel?: "question" | "answer" | undefined;
+        replaceLineBreakTokens?: boolean | undefined;
+        removeEmDashes?: boolean | undefined;
+        normalizeWhitespace?: boolean | undefined;
+        maxLength?: number | undefined;
+        ellipsis?: string | undefined;
+        fallbackWithParent?: string | undefined;
+        fallbackWithoutParent?: string | undefined;
+        fallbackBySlug?: Record<string, string> | undefined;
+    }, {
+        source?: "content" | "fallback" | undefined;
+        fallback?: string | undefined;
+        stripLeadingLabel?: "question" | "answer" | undefined;
+        replaceLineBreakTokens?: boolean | undefined;
+        removeEmDashes?: boolean | undefined;
+        normalizeWhitespace?: boolean | undefined;
+        maxLength?: number | undefined;
+        ellipsis?: string | undefined;
+        fallbackWithParent?: string | undefined;
+        fallbackWithoutParent?: string | undefined;
+        fallbackBySlug?: Record<string, string> | undefined;
+    }>, {
+        source?: "content" | "fallback" | undefined;
+        fallback?: string | undefined;
+        stripLeadingLabel?: "question" | "answer" | undefined;
+        replaceLineBreakTokens?: boolean | undefined;
+        removeEmDashes?: boolean | undefined;
+        normalizeWhitespace?: boolean | undefined;
+        maxLength?: number | undefined;
+        ellipsis?: string | undefined;
+        fallbackWithParent?: string | undefined;
+        fallbackWithoutParent?: string | undefined;
+        fallbackBySlug?: Record<string, string> | undefined;
+    }, {
+        source?: "content" | "fallback" | undefined;
+        fallback?: string | undefined;
+        stripLeadingLabel?: "question" | "answer" | undefined;
+        replaceLineBreakTokens?: boolean | undefined;
+        removeEmDashes?: boolean | undefined;
+        normalizeWhitespace?: boolean | undefined;
+        maxLength?: number | undefined;
+        ellipsis?: string | undefined;
+        fallbackWithParent?: string | undefined;
+        fallbackWithoutParent?: string | undefined;
+        fallbackBySlug?: Record<string, string> | undefined;
+    }>>;
+    description: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        source: z.ZodOptional<z.ZodEnum<["content", "fallback"]>>;
+        stripLeadingLabel: z.ZodOptional<z.ZodEnum<["question", "answer"]>>;
+        replaceLineBreakTokens: z.ZodOptional<z.ZodBoolean>;
+        removeEmDashes: z.ZodOptional<z.ZodBoolean>;
+        normalizeWhitespace: z.ZodOptional<z.ZodBoolean>;
+        maxLength: z.ZodOptional<z.ZodNumber>;
+        ellipsis: z.ZodOptional<z.ZodString>;
+        fallback: z.ZodOptional<z.ZodString>;
+        fallbackWithParent: z.ZodOptional<z.ZodString>;
+        fallbackWithoutParent: z.ZodOptional<z.ZodString>;
+        fallbackBySlug: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, "strict", z.ZodTypeAny, {
+        source?: "content" | "fallback" | undefined;
+        fallback?: string | undefined;
+        stripLeadingLabel?: "question" | "answer" | undefined;
+        replaceLineBreakTokens?: boolean | undefined;
+        removeEmDashes?: boolean | undefined;
+        normalizeWhitespace?: boolean | undefined;
+        maxLength?: number | undefined;
+        ellipsis?: string | undefined;
+        fallbackWithParent?: string | undefined;
+        fallbackWithoutParent?: string | undefined;
+        fallbackBySlug?: Record<string, string> | undefined;
+    }, {
+        source?: "content" | "fallback" | undefined;
+        fallback?: string | undefined;
+        stripLeadingLabel?: "question" | "answer" | undefined;
+        replaceLineBreakTokens?: boolean | undefined;
+        removeEmDashes?: boolean | undefined;
+        normalizeWhitespace?: boolean | undefined;
+        maxLength?: number | undefined;
+        ellipsis?: string | undefined;
+        fallbackWithParent?: string | undefined;
+        fallbackWithoutParent?: string | undefined;
+        fallbackBySlug?: Record<string, string> | undefined;
+    }>, {
+        source?: "content" | "fallback" | undefined;
+        fallback?: string | undefined;
+        stripLeadingLabel?: "question" | "answer" | undefined;
+        replaceLineBreakTokens?: boolean | undefined;
+        removeEmDashes?: boolean | undefined;
+        normalizeWhitespace?: boolean | undefined;
+        maxLength?: number | undefined;
+        ellipsis?: string | undefined;
+        fallbackWithParent?: string | undefined;
+        fallbackWithoutParent?: string | undefined;
+        fallbackBySlug?: Record<string, string> | undefined;
+    }, {
+        source?: "content" | "fallback" | undefined;
+        fallback?: string | undefined;
+        stripLeadingLabel?: "question" | "answer" | undefined;
+        replaceLineBreakTokens?: boolean | undefined;
+        removeEmDashes?: boolean | undefined;
+        normalizeWhitespace?: boolean | undefined;
+        maxLength?: number | undefined;
+        ellipsis?: string | undefined;
+        fallbackWithParent?: string | undefined;
+        fallbackWithoutParent?: string | undefined;
+        fallbackBySlug?: Record<string, string> | undefined;
+    }>>;
+    useFirstBodyImage: z.ZodOptional<z.ZodBoolean>;
+    useTermImage: z.ZodOptional<z.ZodBoolean>;
+    imageAltSource: z.ZodOptional<z.ZodEnum<["content", "title"]>>;
+    legacyImageSource: z.ZodOptional<z.ZodLiteral<"legacy-thumbnail">>;
+    imageAllowedOrigins: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
+    legacyImageAllowedOrigins: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
+    normalizeCloudflareImages: z.ZodOptional<z.ZodBoolean>;
+    fallback: z.ZodOptional<z.ZodObject<{
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        ogImage: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        ogImageAlt: z.ZodOptional<z.ZodString>;
+        noindex: z.ZodOptional<z.ZodBoolean>;
+        nofollow: z.ZodOptional<z.ZodBoolean>;
+    }, "strict", z.ZodTypeAny, {
+        title?: string | undefined;
+        description?: string | undefined;
+        ogImage?: string | undefined;
+        ogImageAlt?: string | undefined;
+        noindex?: boolean | undefined;
+        nofollow?: boolean | undefined;
+    }, {
+        title?: string | undefined;
+        description?: string | undefined;
+        ogImage?: string | undefined;
+        ogImageAlt?: string | undefined;
+        noindex?: boolean | undefined;
+        nofollow?: boolean | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    title?: {
+        source?: "content" | "fallback" | undefined;
+        fallback?: string | undefined;
+        stripLeadingLabel?: "question" | "answer" | undefined;
+        replaceLineBreakTokens?: boolean | undefined;
+        removeEmDashes?: boolean | undefined;
+        normalizeWhitespace?: boolean | undefined;
+        maxLength?: number | undefined;
+        ellipsis?: string | undefined;
+        fallbackWithParent?: string | undefined;
+        fallbackWithoutParent?: string | undefined;
+        fallbackBySlug?: Record<string, string> | undefined;
+    } | undefined;
+    description?: {
+        source?: "content" | "fallback" | undefined;
+        fallback?: string | undefined;
+        stripLeadingLabel?: "question" | "answer" | undefined;
+        replaceLineBreakTokens?: boolean | undefined;
+        removeEmDashes?: boolean | undefined;
+        normalizeWhitespace?: boolean | undefined;
+        maxLength?: number | undefined;
+        ellipsis?: string | undefined;
+        fallbackWithParent?: string | undefined;
+        fallbackWithoutParent?: string | undefined;
+        fallbackBySlug?: Record<string, string> | undefined;
+    } | undefined;
+    fallback?: {
+        title?: string | undefined;
+        description?: string | undefined;
+        ogImage?: string | undefined;
+        ogImageAlt?: string | undefined;
+        noindex?: boolean | undefined;
+        nofollow?: boolean | undefined;
+    } | undefined;
+    useFirstBodyImage?: boolean | undefined;
+    useTermImage?: boolean | undefined;
+    imageAltSource?: "title" | "content" | undefined;
+    legacyImageSource?: "legacy-thumbnail" | undefined;
+    imageAllowedOrigins?: string[] | undefined;
+    legacyImageAllowedOrigins?: string[] | undefined;
+    normalizeCloudflareImages?: boolean | undefined;
+}, {
+    title?: {
+        source?: "content" | "fallback" | undefined;
+        fallback?: string | undefined;
+        stripLeadingLabel?: "question" | "answer" | undefined;
+        replaceLineBreakTokens?: boolean | undefined;
+        removeEmDashes?: boolean | undefined;
+        normalizeWhitespace?: boolean | undefined;
+        maxLength?: number | undefined;
+        ellipsis?: string | undefined;
+        fallbackWithParent?: string | undefined;
+        fallbackWithoutParent?: string | undefined;
+        fallbackBySlug?: Record<string, string> | undefined;
+    } | undefined;
+    description?: {
+        source?: "content" | "fallback" | undefined;
+        fallback?: string | undefined;
+        stripLeadingLabel?: "question" | "answer" | undefined;
+        replaceLineBreakTokens?: boolean | undefined;
+        removeEmDashes?: boolean | undefined;
+        normalizeWhitespace?: boolean | undefined;
+        maxLength?: number | undefined;
+        ellipsis?: string | undefined;
+        fallbackWithParent?: string | undefined;
+        fallbackWithoutParent?: string | undefined;
+        fallbackBySlug?: Record<string, string> | undefined;
+    } | undefined;
+    fallback?: {
+        title?: string | undefined;
+        description?: string | undefined;
+        ogImage?: string | undefined;
+        ogImageAlt?: string | undefined;
+        noindex?: boolean | undefined;
+        nofollow?: boolean | undefined;
+    } | undefined;
+    useFirstBodyImage?: boolean | undefined;
+    useTermImage?: boolean | undefined;
+    imageAltSource?: "title" | "content" | undefined;
+    legacyImageSource?: "legacy-thumbnail" | undefined;
+    imageAllowedOrigins?: string[] | undefined;
+    legacyImageAllowedOrigins?: string[] | undefined;
+    normalizeCloudflareImages?: boolean | undefined;
+}>, {
+    title?: {
+        source?: "content" | "fallback" | undefined;
+        fallback?: string | undefined;
+        stripLeadingLabel?: "question" | "answer" | undefined;
+        replaceLineBreakTokens?: boolean | undefined;
+        removeEmDashes?: boolean | undefined;
+        normalizeWhitespace?: boolean | undefined;
+        maxLength?: number | undefined;
+        ellipsis?: string | undefined;
+        fallbackWithParent?: string | undefined;
+        fallbackWithoutParent?: string | undefined;
+        fallbackBySlug?: Record<string, string> | undefined;
+    } | undefined;
+    description?: {
+        source?: "content" | "fallback" | undefined;
+        fallback?: string | undefined;
+        stripLeadingLabel?: "question" | "answer" | undefined;
+        replaceLineBreakTokens?: boolean | undefined;
+        removeEmDashes?: boolean | undefined;
+        normalizeWhitespace?: boolean | undefined;
+        maxLength?: number | undefined;
+        ellipsis?: string | undefined;
+        fallbackWithParent?: string | undefined;
+        fallbackWithoutParent?: string | undefined;
+        fallbackBySlug?: Record<string, string> | undefined;
+    } | undefined;
+    fallback?: {
+        title?: string | undefined;
+        description?: string | undefined;
+        ogImage?: string | undefined;
+        ogImageAlt?: string | undefined;
+        noindex?: boolean | undefined;
+        nofollow?: boolean | undefined;
+    } | undefined;
+    useFirstBodyImage?: boolean | undefined;
+    useTermImage?: boolean | undefined;
+    imageAltSource?: "title" | "content" | undefined;
+    legacyImageSource?: "legacy-thumbnail" | undefined;
+    imageAllowedOrigins?: string[] | undefined;
+    legacyImageAllowedOrigins?: string[] | undefined;
+    normalizeCloudflareImages?: boolean | undefined;
+}, {
+    title?: {
+        source?: "content" | "fallback" | undefined;
+        fallback?: string | undefined;
+        stripLeadingLabel?: "question" | "answer" | undefined;
+        replaceLineBreakTokens?: boolean | undefined;
+        removeEmDashes?: boolean | undefined;
+        normalizeWhitespace?: boolean | undefined;
+        maxLength?: number | undefined;
+        ellipsis?: string | undefined;
+        fallbackWithParent?: string | undefined;
+        fallbackWithoutParent?: string | undefined;
+        fallbackBySlug?: Record<string, string> | undefined;
+    } | undefined;
+    description?: {
+        source?: "content" | "fallback" | undefined;
+        fallback?: string | undefined;
+        stripLeadingLabel?: "question" | "answer" | undefined;
+        replaceLineBreakTokens?: boolean | undefined;
+        removeEmDashes?: boolean | undefined;
+        normalizeWhitespace?: boolean | undefined;
+        maxLength?: number | undefined;
+        ellipsis?: string | undefined;
+        fallbackWithParent?: string | undefined;
+        fallbackWithoutParent?: string | undefined;
+        fallbackBySlug?: Record<string, string> | undefined;
+    } | undefined;
+    fallback?: {
+        title?: string | undefined;
+        description?: string | undefined;
+        ogImage?: string | undefined;
+        ogImageAlt?: string | undefined;
+        noindex?: boolean | undefined;
+        nofollow?: boolean | undefined;
+    } | undefined;
+    useFirstBodyImage?: boolean | undefined;
+    useTermImage?: boolean | undefined;
+    imageAltSource?: "title" | "content" | undefined;
+    legacyImageSource?: "legacy-thumbnail" | undefined;
+    imageAllowedOrigins?: string[] | undefined;
+    legacyImageAllowedOrigins?: string[] | undefined;
+    normalizeCloudflareImages?: boolean | undefined;
+}>;
+type MetadataDefaultRules = z.infer<typeof MetadataDefaultRulesSchema>;
+interface MetadataDefaultsDeclaration {
+    posts?: {
+        modelKeys?: string[];
+        titleTemplates?: Record<string, string>;
+        defaultRules?: Record<string, MetadataDefaultRules>;
+    };
+    terms?: {
+        modelKeys?: string[];
+        titleTemplates?: Record<string, string>;
+        defaultRules?: Record<string, MetadataDefaultRules>;
+    };
+}
+interface MetadataDefaultsInput {
+    kind: "posts" | "terms";
+    modelKey: string;
+    title: string;
+    description?: string | null;
+    slug?: string;
+    parentId?: string | null;
+    featuredImage?: string | null;
+    firstBodyImage?: string | null;
+    legacyImage?: string | null;
+    /** Current public site origin, used by the historical image adapter's origin check. */
+    imageBaseUrl?: string;
+}
+/** Keep the customer's existing CF Images /lg behavior without rewriting unrelated origins. */
+declare function metadataContentImageUrl(value: string, normalizeCloudflareImages?: boolean): string;
+/** Receives automatic source values only. User-entered SEO never passes through cleanup/truncation. */
+declare function formatMetadataDefaults(input: MetadataDefaultsInput, declaration: MetadataDefaultsDeclaration): MetadataValues;
+
+/** 검색 관리의 등록·검토·공개 Proxy가 공유하는 정확 경로 계약. */
+type NormalizedRedirectSourceResult = {
+    readonly ok: true;
+    readonly value: string;
+} | {
+    readonly ok: false;
+    readonly code: "invalid_source_path";
+};
+type NormalizedRedirectTargetResult = {
+    readonly ok: true;
+    readonly value: string;
+    readonly kind: "internal" | "external";
+} | {
+    readonly ok: false;
+    readonly code: "invalid_target";
+};
+declare function normalizeRedirectPath(raw: string): string;
+/** 등록 제한과 Proxy의 자체 차단은 이 함수를 공유한다. */
+declare function isProtectedRedirectPath(path: string): boolean;
+declare function normalizeRedirectSource(raw: string): NormalizedRedirectSourceResult;
+declare function normalizeRedirectTarget(raw: string): NormalizedRedirectTargetResult;
+
+export { BLOCK_NAME_PATTERN, type BindingResolver, type Block, type BlockBinding, type BlockDefinition, type BlockRegistry, CMS_FONT_SIZES, CMS_IMAGE_WIDTHS, CMS_LINE_HEIGHTS, CMS_PARAGRAPH_SPACINGS, type CategoryTreeEntry, type CategoryTreeEntryCategory, 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, METADATA_FIELDS, type MetadataDefaultRules, MetadataDefaultRulesSchema, type MetadataDefaultsDeclaration, type MetadataDefaultsInput, type MetadataField, MetadataFieldSchema, type MetadataPatch, MetadataPatchSchema, type MetadataResolutionInput, type MetadataRobotsPolicy, MetadataRobotsPolicySchema, type MetadataTarget, type MetadataTargetKind, MetadataTargetKindSchema, type MetadataTextRule, MetadataTextRuleSchema, type MetadataValues, MetadataValuesSchema, type NormalizedEmbed, type NormalizedRedirectSourceResult, type NormalizedRedirectTargetResult, PHASE_1_CORE_BLOCKS, PHASE_1_CSP, POST_FOOTER_SLOT, type PatternSlots, type Phase1CoreBlockName, type PreviewTokenPayload, type PublicPathContext, type PublicPathPost, type PublicPathPresentation, type PublicRouteMetadata, type RoutablePost, type RouteCollection, SITE_PATTERN_BUTTON_COLORS_MAX, SITE_PATTERN_KEY_PATTERN, SITE_PATTERN_PLACEMENTS_KEY, SITE_PATTERN_SLOTS, type SectionLock, type SectionLockViolation, type SectionLockViolationCode, type SitePatternLayout, type SitePatternLinkStyle, type SitePatternPlacementRule, type SitePatternPlacements, type SitePatternPresentation, type SitePatternSlotKey, applyBlockBindings, bindingSrcValue, bindingTextValue, blockSchema, boundFieldValue, chainResolvers, cmsFontSize, cmsImageAlign, cmsImageStyle, cmsImageWidth, cmsLineHeight, cmsParagraphSpacing, createFieldBindingResolver, emptyPatternSlots, ensureImportedHtmlDocumentRoots, ensureStableIds, extractFaqEntries, faqPageJsonLd, findInternalContentLinkTokens, findSectionLockViolations, findSitePatternPlacementRule, formatMetadataDefaults, formatSectionLockViolations, htmlToPlainText, injectStableIdsTree, internalContentKeyFromPath, internalContentLinkResolverFrom, internalContentPathIndex, isAllowedEmbedSrc, isAllowedMapEmbedSrc, isInCollectionMode, isProtectedRedirectPath, isSectionContentPropPath, isSitePatternSlotKey, isValidBlock, isValidSitePatternKey, issuePreviewToken, mergeMetadataPatch, metadataContentImageUrl, normalizeEmbed, normalizeHexColor, normalizeImageAlt, normalizeRedirectPath, normalizeRedirectSource, normalizeRedirectTarget, parseBlock, postsForCollection, postsInAnyCollection, postsNotInAnyCollection, readMetadataValues, readSitePatternPlacements, readSitePatternPresentation, referencedSitePatternKeys, renderInternalContentLinksInHtml, renderInternalContentLinksInText, resolveCategoryPath, resolveCategoryTreeChain, resolveCategoryTreeEntryPath, resolveCategoryTreeHubPaths, resolveCategoryTreeSelection, resolveMetadata, resolvePatternSlots, resolvePostCategorySlug, resolvePostCollection, resolvePostPath, resolvePostPublicPath, resolvePostUrl, sanitizeHtml, sanitizeImportedCss, sanitizeImportedHtml, scopeImportedCss, serializeBlock, setSitePatternPlacementRule, sitePatternButtonColor, sitePatternPresentationAttributes, validateCollections, verifyPreviewToken };