@roottale/cms-core 0.66.0 → 0.67.0

package/dist/index.d.cts

@@ -630,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 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, 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, resolveCategoryTreeSelection, 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 };