@roottale/cms-core 0.71.0 → 0.72.0

package/dist/index.d.cts

@@ -1,4 +1,5 @@
 import { z, ZodSchema } from 'zod';
+export { V as VISUAL_EDIT_ATTRIBUTE, a as VISUAL_EDIT_PROTOCOL, b as VISUAL_EDIT_PROTOCOL_VERSION, c as VisualEditAddress, d as VisualEditMessage, e as VisualEditMode, f as VisualEditPayload, g as VisualPreviewTarget, h as VisualRenderReceipt, i as VisualViewportPosition, j as buildVisualEditPreviewUrl, k as isVisualEditOrigin, p as parseVisualEditAddress, l as parseVisualEditMessage, s as sameVisualDependencies, m as sameVisualPreviewTarget, v as visualEditAddressKey, n as visualEditAddressSchema, o as visualEditAttributes, q as visualPreviewTargetSchema, r as visualRenderReceiptSchema } from './visual-edit-contract-DzlMel7r.cjs';
 
 /** WP-compatible name pattern: `core/<x>` | `roottale/<x>` */
 declare const BLOCK_NAME_PATTERN: RegExp;
@@ -11606,6 +11607,134 @@ declare function selectContentQuery<T extends ContentPolicyPost>(query: ContentQ
     };
 }): ContentQueryResult<T>;
 
+interface ContentScope {
+    readonly tenantId: string;
+    readonly siteId: string;
+}
+interface ContentCandidate extends ContentScope {
+    readonly id: string;
+    readonly modelKey: string;
+    readonly status: string;
+    readonly termIds: readonly string[];
+    readonly title: string;
+    readonly path: string | null;
+    readonly publishedAt: string | null;
+    readonly position?: number;
+}
+interface RelatedContentOptions {
+    readonly scope: ContentScope;
+    readonly sourceId?: string;
+    readonly termIds: readonly string[];
+    readonly models: readonly {
+        readonly modelKey: string;
+        readonly maxCount: number;
+    }[];
+    readonly includeDescendants?: boolean;
+    /** Each value contains the caller's explicitly resolved descendant IDs, not slugs or labels. */
+    readonly descendantTermIds?: Readonly<Record<string, readonly string[]>>;
+}
+interface RelatedContentGroup<T extends ContentCandidate = ContentCandidate> {
+    readonly modelKey: string;
+    readonly items: readonly T[];
+}
+type ContentCtaMode = "auto" | "manual" | "off";
+interface ContentCtaOptions {
+    readonly scope: ContentScope;
+    readonly sourceId?: string;
+    readonly primaryTermId?: string | null;
+    readonly detailModelKeys: readonly string[];
+    readonly cta: {
+        readonly mode: ContentCtaMode;
+        readonly targetPostId?: string | null;
+    };
+}
+type ContentCtaHiddenReason = "disabled" | "manual_target_missing" | "manual_target_unavailable" | "primary_term_missing" | "auto_target_missing" | "auto_target_ambiguous";
+type ContentCtaResult<T extends ContentCandidate = ContentCandidate> = {
+    readonly state: "resolved";
+    readonly mode: "auto" | "manual";
+    readonly target: T;
+} | {
+    readonly state: "hidden";
+    readonly mode: ContentCtaMode;
+    readonly reason: ContentCtaHiddenReason;
+};
+/** Empty classifications produce empty lists. No title, path, model or content is inferred. */
+declare function selectRelatedContent<T extends ContentCandidate>(candidates: readonly T[], options: RelatedContentOptions): RelatedContentGroup<T>[];
+/** Manual selection is authoritative: an unavailable target stays hidden instead of falling back. */
+declare function resolveContentCta<T extends ContentCandidate>(candidates: readonly T[], options: ContentCtaOptions): ContentCtaResult<T>;
+interface VisibleFaqCandidate extends FaqEntry {
+    readonly id: string;
+    readonly visible: boolean;
+    readonly deleted?: boolean;
+}
+interface VisibleFaqEntry extends FaqEntry {
+    readonly id: string;
+}
+/** Render this same selection when passing the result to FAQ structured data. */
+declare function selectVisibleFaqEntries(entries: readonly VisibleFaqCandidate[]): VisibleFaqEntry[];
+declare function visibleFaqPageJsonLd(entries: readonly VisibleFaqCandidate[]): Record<string, unknown> | null;
+interface ProfileQualificationInput {
+    readonly qualification?: string | readonly string[] | null;
+    readonly alumniOf?: string | readonly string[] | null;
+}
+interface ProfileQualificationProperties {
+    readonly hasCredential?: readonly {
+        readonly "@type": "EducationalOccupationalCredential";
+        readonly name: string;
+    }[];
+    readonly alumniOf?: readonly {
+        readonly "@type": "EducationalOrganization";
+        readonly name: string;
+    }[];
+}
+/** These are Person properties. Never infer a credential or school from a title, role or biography. */
+declare function profileQualificationJsonLdProperties(input: ProfileQualificationInput): ProfileQualificationProperties;
+
+/**
+ * Paths start at the serialized ACF root. Each array traversal requires @<uuid>.
+ * Unknown properties and repeaters with missing or duplicate IDs throw; no defaults are invented.
+ */
+declare function getContentValue(values: Readonly<Record<string, unknown>>, path: readonly string[]): unknown;
+/**
+ * Clone only the changed branch and preserve stable IDs. Whole-array replacement is allowed.
+ * Leaf permissions and all replacement-value validation belong to the compiled content contract.
+ */
+declare function setContentValue(values: Readonly<Record<string, unknown>>, path: readonly string[], value: unknown): Record<string, unknown>;
+
+interface ContentDependencyEntity extends ContentScope {
+    readonly id: string;
+    readonly modelKey: string;
+    readonly termIds: readonly string[];
+    readonly path: string | null;
+}
+interface ContentQueryDependency {
+    readonly modelKeys: readonly string[];
+    /** Omitted: all content in these models. Empty: nothing. Descendants must be explicitly expanded. */
+    readonly termIds?: readonly string[];
+}
+/** A declared public route and the content whose changes can alter its rendered output. */
+interface ContentPathDependency extends ContentScope {
+    readonly path: string;
+    readonly entityIds?: readonly string[];
+    readonly queries?: readonly ContentQueryDependency[];
+    readonly singletonKeys?: readonly string[];
+}
+interface ContentDependencyChange {
+    readonly scope: ContentScope;
+    readonly before?: ContentDependencyEntity | null;
+    readonly after?: ContentDependencyEntity | null;
+    /** Scoped tombstone IDs still invalidate direct/manual references when the target no longer exists. */
+    readonly entityIds?: readonly string[];
+    readonly singletonKeys?: readonly string[];
+}
+/**
+ * Query edges represent related lists, category hubs and auto CTAs; entity edges represent direct
+ * includes and manual CTAs. Before and after facts are both needed on classification or URL moves.
+ * Do not filter snapshots by their new publication status: unpublishing must evict previous output.
+ * The caller owns the complete dependency graph and persisted before snapshot; no DB reads occur here.
+ */
+declare function resolveContentDependencyPaths(dependencies: readonly ContentPathDependency[], change: ContentDependencyChange): string[];
+
 /** 검색 관리의 등록·검토·공개 Proxy가 공유하는 정확 경로 계약. */
 type NormalizedRedirectSourceResult = {
     readonly ok: true;
@@ -11628,4 +11757,4 @@ 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 CategoryTreeEntryResolution, type CategoryTreePresentation, type CategoryTreeTerm, type ClientHydrationSpec, type ContentPolicy, type ContentPolicyCheck, ContentPolicyCheckSchema, ContentPolicyFieldNameSchema, type ContentPolicyFieldRef, ContentPolicyInternalPathSchema, type ContentPolicyOptions, type ContentPolicyPost, type ContentPolicyResult, type ContentPolicyScalarCheck, ContentPolicyScalarCheckSchema, ContentPolicyScalarSchema, ContentPolicySchema, ContentPolicyWhenSchema, type ContentQuery, type ContentQueryCandidate, ContentQueryFilterSchema, type ContentQueryOptions, type ContentQueryResult, ContentQuerySchema, 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 PostBodySource, 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, collectContentPolicyFieldRefs, collectContentQueryFieldRefs, collectMetadataDefaultFieldRefs, contentPolicyBodyText, contentPolicySafeHttpsUrl, createFieldBindingResolver, emptyPatternSlots, ensureImportedHtmlDocumentRoots, ensureStableIds, evaluateContentPolicy, evaluateContentQuery, extractFaqEntries, faqPageJsonLd, findInternalContentLinkTokens, findSectionLockViolations, findSitePatternPlacementRule, formatMetadataDefaults, formatSectionLockViolations, htmlToPlainText, injectStableIdsTree, internalContentKeyFromPath, internalContentLinkResolverFrom, internalContentPathIndex, isAllowedEmbedSrc, isAllowedMapEmbedSrc, isInCollectionMode, isProtectedRedirectPath, isReservedCategoryTreeSlug, isSectionContentPropPath, isSitePatternSlotKey, isValidBlock, isValidSitePatternKey, issuePreviewToken, matchesContentScalarCheck, mergeMetadataPatch, metadataBodyParagraphs, metadataContentImageUrl, metadataVideoThumbnail, normalizeEmbed, normalizeHexColor, normalizeImageAlt, normalizeRedirectPath, normalizeRedirectSource, normalizeRedirectTarget, parseBlock, postsForCollection, postsInAnyCollection, postsNotInAnyCollection, readMetadataValues, readSitePatternPlacements, readSitePatternPresentation, referencedSitePatternKeys, renderInternalContentLinksInHtml, renderInternalContentLinksInText, resolveCategoryPath, resolveCategoryTreeChain, resolveCategoryTreeEntryCategory, resolveCategoryTreeEntryPath, resolveCategoryTreeHubPaths, resolveCategoryTreeSelection, resolveMetadata, resolvePatternSlots, resolvePostBodySource, resolvePostCategorySlug, resolvePostCollection, resolvePostPath, resolvePostPublicPath, resolvePostUrl, sanitizeHtml, sanitizeImportedCss, sanitizeImportedHtml, scopeImportedCss, selectContentQuery, serializeBlock, setSitePatternPlacementRule, sitePatternButtonColor, sitePatternPresentationAttributes, validateCollections, verifyPreviewToken };
+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 CategoryTreeEntryResolution, type CategoryTreePresentation, type CategoryTreeTerm, type ClientHydrationSpec, type ContentCandidate, type ContentCtaHiddenReason, type ContentCtaMode, type ContentCtaOptions, type ContentCtaResult, type ContentDependencyChange, type ContentDependencyEntity, type ContentPathDependency, type ContentPolicy, type ContentPolicyCheck, ContentPolicyCheckSchema, ContentPolicyFieldNameSchema, type ContentPolicyFieldRef, ContentPolicyInternalPathSchema, type ContentPolicyOptions, type ContentPolicyPost, type ContentPolicyResult, type ContentPolicyScalarCheck, ContentPolicyScalarCheckSchema, ContentPolicyScalarSchema, ContentPolicySchema, ContentPolicyWhenSchema, type ContentQuery, type ContentQueryCandidate, type ContentQueryDependency, ContentQueryFilterSchema, type ContentQueryOptions, type ContentQueryResult, ContentQuerySchema, type ContentScope, 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 PostBodySource, type PreviewTokenPayload, type ProfileQualificationInput, type ProfileQualificationProperties, type PublicPathContext, type PublicPathPost, type PublicPathPresentation, type PublicRouteMetadata, type RelatedContentGroup, type RelatedContentOptions, 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, type VisibleFaqCandidate, type VisibleFaqEntry, applyBlockBindings, bindingSrcValue, bindingTextValue, blockSchema, boundFieldValue, chainResolvers, cmsFontSize, cmsImageAlign, cmsImageStyle, cmsImageWidth, cmsLineHeight, cmsParagraphSpacing, collectContentPolicyFieldRefs, collectContentQueryFieldRefs, collectMetadataDefaultFieldRefs, contentPolicyBodyText, contentPolicySafeHttpsUrl, createFieldBindingResolver, emptyPatternSlots, ensureImportedHtmlDocumentRoots, ensureStableIds, evaluateContentPolicy, evaluateContentQuery, extractFaqEntries, faqPageJsonLd, findInternalContentLinkTokens, findSectionLockViolations, findSitePatternPlacementRule, formatMetadataDefaults, formatSectionLockViolations, getContentValue, htmlToPlainText, injectStableIdsTree, internalContentKeyFromPath, internalContentLinkResolverFrom, internalContentPathIndex, isAllowedEmbedSrc, isAllowedMapEmbedSrc, isInCollectionMode, isProtectedRedirectPath, isReservedCategoryTreeSlug, isSectionContentPropPath, isSitePatternSlotKey, isValidBlock, isValidSitePatternKey, issuePreviewToken, matchesContentScalarCheck, mergeMetadataPatch, metadataBodyParagraphs, metadataContentImageUrl, metadataVideoThumbnail, normalizeEmbed, normalizeHexColor, normalizeImageAlt, normalizeRedirectPath, normalizeRedirectSource, normalizeRedirectTarget, parseBlock, postsForCollection, postsInAnyCollection, postsNotInAnyCollection, profileQualificationJsonLdProperties, readMetadataValues, readSitePatternPlacements, readSitePatternPresentation, referencedSitePatternKeys, renderInternalContentLinksInHtml, renderInternalContentLinksInText, resolveCategoryPath, resolveCategoryTreeChain, resolveCategoryTreeEntryCategory, resolveCategoryTreeEntryPath, resolveCategoryTreeHubPaths, resolveCategoryTreeSelection, resolveContentCta, resolveContentDependencyPaths, resolveMetadata, resolvePatternSlots, resolvePostBodySource, resolvePostCategorySlug, resolvePostCollection, resolvePostPath, resolvePostPublicPath, resolvePostUrl, sanitizeHtml, sanitizeImportedCss, sanitizeImportedHtml, scopeImportedCss, selectContentQuery, selectRelatedContent, selectVisibleFaqEntries, serializeBlock, setContentValue, setSitePatternPlacementRule, sitePatternButtonColor, sitePatternPresentationAttributes, validateCollections, verifyPreviewToken, visibleFaqPageJsonLd };

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import { z, ZodSchema } from 'zod';
+export { V as VISUAL_EDIT_ATTRIBUTE, a as VISUAL_EDIT_PROTOCOL, b as VISUAL_EDIT_PROTOCOL_VERSION, c as VisualEditAddress, d as VisualEditMessage, e as VisualEditMode, f as VisualEditPayload, g as VisualPreviewTarget, h as VisualRenderReceipt, i as VisualViewportPosition, j as buildVisualEditPreviewUrl, k as isVisualEditOrigin, p as parseVisualEditAddress, l as parseVisualEditMessage, s as sameVisualDependencies, m as sameVisualPreviewTarget, v as visualEditAddressKey, n as visualEditAddressSchema, o as visualEditAttributes, q as visualPreviewTargetSchema, r as visualRenderReceiptSchema } from './visual-edit-contract-DzlMel7r.js';
 
 /** WP-compatible name pattern: `core/<x>` | `roottale/<x>` */
 declare const BLOCK_NAME_PATTERN: RegExp;
@@ -11606,6 +11607,134 @@ declare function selectContentQuery<T extends ContentPolicyPost>(query: ContentQ
     };
 }): ContentQueryResult<T>;
 
+interface ContentScope {
+    readonly tenantId: string;
+    readonly siteId: string;
+}
+interface ContentCandidate extends ContentScope {
+    readonly id: string;
+    readonly modelKey: string;
+    readonly status: string;
+    readonly termIds: readonly string[];
+    readonly title: string;
+    readonly path: string | null;
+    readonly publishedAt: string | null;
+    readonly position?: number;
+}
+interface RelatedContentOptions {
+    readonly scope: ContentScope;
+    readonly sourceId?: string;
+    readonly termIds: readonly string[];
+    readonly models: readonly {
+        readonly modelKey: string;
+        readonly maxCount: number;
+    }[];
+    readonly includeDescendants?: boolean;
+    /** Each value contains the caller's explicitly resolved descendant IDs, not slugs or labels. */
+    readonly descendantTermIds?: Readonly<Record<string, readonly string[]>>;
+}
+interface RelatedContentGroup<T extends ContentCandidate = ContentCandidate> {
+    readonly modelKey: string;
+    readonly items: readonly T[];
+}
+type ContentCtaMode = "auto" | "manual" | "off";
+interface ContentCtaOptions {
+    readonly scope: ContentScope;
+    readonly sourceId?: string;
+    readonly primaryTermId?: string | null;
+    readonly detailModelKeys: readonly string[];
+    readonly cta: {
+        readonly mode: ContentCtaMode;
+        readonly targetPostId?: string | null;
+    };
+}
+type ContentCtaHiddenReason = "disabled" | "manual_target_missing" | "manual_target_unavailable" | "primary_term_missing" | "auto_target_missing" | "auto_target_ambiguous";
+type ContentCtaResult<T extends ContentCandidate = ContentCandidate> = {
+    readonly state: "resolved";
+    readonly mode: "auto" | "manual";
+    readonly target: T;
+} | {
+    readonly state: "hidden";
+    readonly mode: ContentCtaMode;
+    readonly reason: ContentCtaHiddenReason;
+};
+/** Empty classifications produce empty lists. No title, path, model or content is inferred. */
+declare function selectRelatedContent<T extends ContentCandidate>(candidates: readonly T[], options: RelatedContentOptions): RelatedContentGroup<T>[];
+/** Manual selection is authoritative: an unavailable target stays hidden instead of falling back. */
+declare function resolveContentCta<T extends ContentCandidate>(candidates: readonly T[], options: ContentCtaOptions): ContentCtaResult<T>;
+interface VisibleFaqCandidate extends FaqEntry {
+    readonly id: string;
+    readonly visible: boolean;
+    readonly deleted?: boolean;
+}
+interface VisibleFaqEntry extends FaqEntry {
+    readonly id: string;
+}
+/** Render this same selection when passing the result to FAQ structured data. */
+declare function selectVisibleFaqEntries(entries: readonly VisibleFaqCandidate[]): VisibleFaqEntry[];
+declare function visibleFaqPageJsonLd(entries: readonly VisibleFaqCandidate[]): Record<string, unknown> | null;
+interface ProfileQualificationInput {
+    readonly qualification?: string | readonly string[] | null;
+    readonly alumniOf?: string | readonly string[] | null;
+}
+interface ProfileQualificationProperties {
+    readonly hasCredential?: readonly {
+        readonly "@type": "EducationalOccupationalCredential";
+        readonly name: string;
+    }[];
+    readonly alumniOf?: readonly {
+        readonly "@type": "EducationalOrganization";
+        readonly name: string;
+    }[];
+}
+/** These are Person properties. Never infer a credential or school from a title, role or biography. */
+declare function profileQualificationJsonLdProperties(input: ProfileQualificationInput): ProfileQualificationProperties;
+
+/**
+ * Paths start at the serialized ACF root. Each array traversal requires @<uuid>.
+ * Unknown properties and repeaters with missing or duplicate IDs throw; no defaults are invented.
+ */
+declare function getContentValue(values: Readonly<Record<string, unknown>>, path: readonly string[]): unknown;
+/**
+ * Clone only the changed branch and preserve stable IDs. Whole-array replacement is allowed.
+ * Leaf permissions and all replacement-value validation belong to the compiled content contract.
+ */
+declare function setContentValue(values: Readonly<Record<string, unknown>>, path: readonly string[], value: unknown): Record<string, unknown>;
+
+interface ContentDependencyEntity extends ContentScope {
+    readonly id: string;
+    readonly modelKey: string;
+    readonly termIds: readonly string[];
+    readonly path: string | null;
+}
+interface ContentQueryDependency {
+    readonly modelKeys: readonly string[];
+    /** Omitted: all content in these models. Empty: nothing. Descendants must be explicitly expanded. */
+    readonly termIds?: readonly string[];
+}
+/** A declared public route and the content whose changes can alter its rendered output. */
+interface ContentPathDependency extends ContentScope {
+    readonly path: string;
+    readonly entityIds?: readonly string[];
+    readonly queries?: readonly ContentQueryDependency[];
+    readonly singletonKeys?: readonly string[];
+}
+interface ContentDependencyChange {
+    readonly scope: ContentScope;
+    readonly before?: ContentDependencyEntity | null;
+    readonly after?: ContentDependencyEntity | null;
+    /** Scoped tombstone IDs still invalidate direct/manual references when the target no longer exists. */
+    readonly entityIds?: readonly string[];
+    readonly singletonKeys?: readonly string[];
+}
+/**
+ * Query edges represent related lists, category hubs and auto CTAs; entity edges represent direct
+ * includes and manual CTAs. Before and after facts are both needed on classification or URL moves.
+ * Do not filter snapshots by their new publication status: unpublishing must evict previous output.
+ * The caller owns the complete dependency graph and persisted before snapshot; no DB reads occur here.
+ */
+declare function resolveContentDependencyPaths(dependencies: readonly ContentPathDependency[], change: ContentDependencyChange): string[];
+
 /** 검색 관리의 등록·검토·공개 Proxy가 공유하는 정확 경로 계약. */
 type NormalizedRedirectSourceResult = {
     readonly ok: true;
@@ -11628,4 +11757,4 @@ 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 CategoryTreeEntryResolution, type CategoryTreePresentation, type CategoryTreeTerm, type ClientHydrationSpec, type ContentPolicy, type ContentPolicyCheck, ContentPolicyCheckSchema, ContentPolicyFieldNameSchema, type ContentPolicyFieldRef, ContentPolicyInternalPathSchema, type ContentPolicyOptions, type ContentPolicyPost, type ContentPolicyResult, type ContentPolicyScalarCheck, ContentPolicyScalarCheckSchema, ContentPolicyScalarSchema, ContentPolicySchema, ContentPolicyWhenSchema, type ContentQuery, type ContentQueryCandidate, ContentQueryFilterSchema, type ContentQueryOptions, type ContentQueryResult, ContentQuerySchema, 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 PostBodySource, 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, collectContentPolicyFieldRefs, collectContentQueryFieldRefs, collectMetadataDefaultFieldRefs, contentPolicyBodyText, contentPolicySafeHttpsUrl, createFieldBindingResolver, emptyPatternSlots, ensureImportedHtmlDocumentRoots, ensureStableIds, evaluateContentPolicy, evaluateContentQuery, extractFaqEntries, faqPageJsonLd, findInternalContentLinkTokens, findSectionLockViolations, findSitePatternPlacementRule, formatMetadataDefaults, formatSectionLockViolations, htmlToPlainText, injectStableIdsTree, internalContentKeyFromPath, internalContentLinkResolverFrom, internalContentPathIndex, isAllowedEmbedSrc, isAllowedMapEmbedSrc, isInCollectionMode, isProtectedRedirectPath, isReservedCategoryTreeSlug, isSectionContentPropPath, isSitePatternSlotKey, isValidBlock, isValidSitePatternKey, issuePreviewToken, matchesContentScalarCheck, mergeMetadataPatch, metadataBodyParagraphs, metadataContentImageUrl, metadataVideoThumbnail, normalizeEmbed, normalizeHexColor, normalizeImageAlt, normalizeRedirectPath, normalizeRedirectSource, normalizeRedirectTarget, parseBlock, postsForCollection, postsInAnyCollection, postsNotInAnyCollection, readMetadataValues, readSitePatternPlacements, readSitePatternPresentation, referencedSitePatternKeys, renderInternalContentLinksInHtml, renderInternalContentLinksInText, resolveCategoryPath, resolveCategoryTreeChain, resolveCategoryTreeEntryCategory, resolveCategoryTreeEntryPath, resolveCategoryTreeHubPaths, resolveCategoryTreeSelection, resolveMetadata, resolvePatternSlots, resolvePostBodySource, resolvePostCategorySlug, resolvePostCollection, resolvePostPath, resolvePostPublicPath, resolvePostUrl, sanitizeHtml, sanitizeImportedCss, sanitizeImportedHtml, scopeImportedCss, selectContentQuery, serializeBlock, setSitePatternPlacementRule, sitePatternButtonColor, sitePatternPresentationAttributes, validateCollections, verifyPreviewToken };
+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 CategoryTreeEntryResolution, type CategoryTreePresentation, type CategoryTreeTerm, type ClientHydrationSpec, type ContentCandidate, type ContentCtaHiddenReason, type ContentCtaMode, type ContentCtaOptions, type ContentCtaResult, type ContentDependencyChange, type ContentDependencyEntity, type ContentPathDependency, type ContentPolicy, type ContentPolicyCheck, ContentPolicyCheckSchema, ContentPolicyFieldNameSchema, type ContentPolicyFieldRef, ContentPolicyInternalPathSchema, type ContentPolicyOptions, type ContentPolicyPost, type ContentPolicyResult, type ContentPolicyScalarCheck, ContentPolicyScalarCheckSchema, ContentPolicyScalarSchema, ContentPolicySchema, ContentPolicyWhenSchema, type ContentQuery, type ContentQueryCandidate, type ContentQueryDependency, ContentQueryFilterSchema, type ContentQueryOptions, type ContentQueryResult, ContentQuerySchema, type ContentScope, 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 PostBodySource, type PreviewTokenPayload, type ProfileQualificationInput, type ProfileQualificationProperties, type PublicPathContext, type PublicPathPost, type PublicPathPresentation, type PublicRouteMetadata, type RelatedContentGroup, type RelatedContentOptions, 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, type VisibleFaqCandidate, type VisibleFaqEntry, applyBlockBindings, bindingSrcValue, bindingTextValue, blockSchema, boundFieldValue, chainResolvers, cmsFontSize, cmsImageAlign, cmsImageStyle, cmsImageWidth, cmsLineHeight, cmsParagraphSpacing, collectContentPolicyFieldRefs, collectContentQueryFieldRefs, collectMetadataDefaultFieldRefs, contentPolicyBodyText, contentPolicySafeHttpsUrl, createFieldBindingResolver, emptyPatternSlots, ensureImportedHtmlDocumentRoots, ensureStableIds, evaluateContentPolicy, evaluateContentQuery, extractFaqEntries, faqPageJsonLd, findInternalContentLinkTokens, findSectionLockViolations, findSitePatternPlacementRule, formatMetadataDefaults, formatSectionLockViolations, getContentValue, htmlToPlainText, injectStableIdsTree, internalContentKeyFromPath, internalContentLinkResolverFrom, internalContentPathIndex, isAllowedEmbedSrc, isAllowedMapEmbedSrc, isInCollectionMode, isProtectedRedirectPath, isReservedCategoryTreeSlug, isSectionContentPropPath, isSitePatternSlotKey, isValidBlock, isValidSitePatternKey, issuePreviewToken, matchesContentScalarCheck, mergeMetadataPatch, metadataBodyParagraphs, metadataContentImageUrl, metadataVideoThumbnail, normalizeEmbed, normalizeHexColor, normalizeImageAlt, normalizeRedirectPath, normalizeRedirectSource, normalizeRedirectTarget, parseBlock, postsForCollection, postsInAnyCollection, postsNotInAnyCollection, profileQualificationJsonLdProperties, readMetadataValues, readSitePatternPlacements, readSitePatternPresentation, referencedSitePatternKeys, renderInternalContentLinksInHtml, renderInternalContentLinksInText, resolveCategoryPath, resolveCategoryTreeChain, resolveCategoryTreeEntryCategory, resolveCategoryTreeEntryPath, resolveCategoryTreeHubPaths, resolveCategoryTreeSelection, resolveContentCta, resolveContentDependencyPaths, resolveMetadata, resolvePatternSlots, resolvePostBodySource, resolvePostCategorySlug, resolvePostCollection, resolvePostPath, resolvePostPublicPath, resolvePostUrl, sanitizeHtml, sanitizeImportedCss, sanitizeImportedHtml, scopeImportedCss, selectContentQuery, selectRelatedContent, selectVisibleFaqEntries, serializeBlock, setContentValue, setSitePatternPlacementRule, sitePatternButtonColor, sitePatternPresentationAttributes, validateCollections, verifyPreviewToken, visibleFaqPageJsonLd };

package/dist/index.js

@@ -1,3 +1,22 @@
+import {
+  VISUAL_EDIT_ATTRIBUTE,
+  VISUAL_EDIT_PROTOCOL,
+  VISUAL_EDIT_PROTOCOL_VERSION,
+  buildVisualEditPreviewUrl,
+  getContentValue,
+  isVisualEditOrigin,
+  parseVisualEditAddress,
+  parseVisualEditMessage,
+  sameVisualDependencies,
+  sameVisualPreviewTarget,
+  setContentValue,
+  visualEditAddressKey,
+  visualEditAddressSchema,
+  visualEditAttributes,
+  visualPreviewTargetSchema,
+  visualRenderReceiptSchema
+} from "./chunk-WNU53PSH.js";
+
 // src/block.ts
 import { z } from "zod";
 var BLOCK_NAME_PATTERN = /^(core|roottale)\/[a-z0-9-]+$/;
@@ -2538,6 +2557,115 @@ function selectContentQuery(query, posts, policies, options) {
   return evaluateContentQuery(query, candidates, options);
 }
 
+// src/content-relations.ts
+function assertScope(scope) {
+  if (!scope.tenantId.trim() || !scope.siteId.trim()) throw new Error("Content scope requires tenantId and siteId");
+}
+function publishedCandidates(candidates, scope, sourceId) {
+  const seen = /* @__PURE__ */ new Set();
+  return candidates.filter((candidate) => {
+    if (candidate.tenantId !== scope.tenantId || candidate.siteId !== scope.siteId || candidate.id === sourceId || candidate.status !== "published" || !candidate.id.trim() || !candidate.title.trim() || !ContentPolicyInternalPathSchema.safeParse(candidate.path).success || !Number.isFinite(Date.parse(candidate.publishedAt ?? "")) || seen.has(candidate.id)) return false;
+    seen.add(candidate.id);
+    return true;
+  });
+}
+function latestFirst(left, right) {
+  return Date.parse(right.publishedAt) - Date.parse(left.publishedAt) || (left.id < right.id ? -1 : left.id > right.id ? 1 : 0);
+}
+function selectRelatedContent(candidates, options) {
+  assertScope(options.scope);
+  const termIds = new Set(options.termIds.filter((id) => id.trim()));
+  if (options.includeDescendants) {
+    for (const termId of options.termIds) {
+      if (!termId.trim() || !Object.hasOwn(options.descendantTermIds ?? {}, termId)) continue;
+      for (const descendantId of options.descendantTermIds[termId] ?? []) {
+        if (descendantId.trim()) termIds.add(descendantId);
+      }
+    }
+  }
+  const selected = publishedCandidates(candidates, options.scope, options.sourceId).filter((candidate) => candidate.termIds.some((id) => termIds.has(id))).sort(latestFirst);
+  return options.models.map(({ modelKey, maxCount }) => {
+    if (!Number.isSafeInteger(maxCount) || maxCount < 0) throw new Error("Related content maxCount must be a non-negative integer");
+    return { modelKey, items: selected.filter((candidate) => candidate.modelKey === modelKey).slice(0, maxCount) };
+  });
+}
+function resolveContentCta(candidates, options) {
+  assertScope(options.scope);
+  const { mode, targetPostId } = options.cta;
+  const hidden = (reason) => ({ state: "hidden", mode, reason });
+  if (mode === "off") return hidden("disabled");
+  const published = publishedCandidates(candidates, options.scope, options.sourceId);
+  if (mode === "manual") {
+    if (!targetPostId?.trim()) return hidden("manual_target_missing");
+    const target = published.find((candidate) => candidate.id === targetPostId);
+    return target ? { state: "resolved", mode, target } : hidden("manual_target_unavailable");
+  }
+  if (!options.primaryTermId?.trim()) return hidden("primary_term_missing");
+  const targets = published.filter((candidate) => options.detailModelKeys.includes(candidate.modelKey) && candidate.termIds.includes(options.primaryTermId));
+  if (targets.length === 0) return hidden("auto_target_missing");
+  if (targets.length > 1) return hidden("auto_target_ambiguous");
+  return { state: "resolved", mode, target: targets[0] };
+}
+function plainFact(value) {
+  return value.replace(/\s+/gu, " ").trim();
+}
+function selectVisibleFaqEntries(entries) {
+  const seen = /* @__PURE__ */ new Set();
+  const selected = [];
+  for (const entry of entries) {
+    const id = entry.id.trim();
+    const question = plainFact(entry.question);
+    const answer = plainFact(entry.answer);
+    if (!entry.visible || entry.deleted || !id || !question || !answer || seen.has(id)) continue;
+    seen.add(id);
+    selected.push({ id, question, answer });
+  }
+  return selected;
+}
+function visibleFaqPageJsonLd(entries) {
+  return faqPageJsonLd(selectVisibleFaqEntries(entries));
+}
+function enteredNames(value) {
+  const values = typeof value === "string" ? [value] : value ?? [];
+  return [...new Set(values.map(plainFact).filter(Boolean))];
+}
+function profileQualificationJsonLdProperties(input) {
+  const qualifications = enteredNames(input.qualification);
+  const alumni = enteredNames(input.alumniOf);
+  return {
+    ...qualifications.length ? { hasCredential: qualifications.map((name) => ({ "@type": "EducationalOccupationalCredential", name })) } : {},
+    ...alumni.length ? { alumniOf: alumni.map((name) => ({ "@type": "EducationalOrganization", name })) } : {}
+  };
+}
+
+// src/content-dependencies.ts
+function inScope(value, scope) {
+  return value.tenantId === scope.tenantId && value.siteId === scope.siteId;
+}
+function matchesQuery(entity, query) {
+  return query.modelKeys.includes(entity.modelKey) && (query.termIds === void 0 || entity.termIds.some((id) => id.trim() && query.termIds.includes(id)));
+}
+function resolveContentDependencyPaths(dependencies, change) {
+  const { scope } = change;
+  if (!scope.tenantId.trim() || !scope.siteId.trim()) throw new Error("Content scope requires tenantId and siteId");
+  const snapshots = [change.before, change.after].filter((entity) => entity != null && inScope(entity, scope));
+  const entityIds = new Set([...snapshots.map(({ id }) => id), ...change.entityIds ?? []].filter((id) => id.trim()));
+  const singletonKeys = new Set((change.singletonKeys ?? []).filter((key) => key.trim()));
+  const paths = /* @__PURE__ */ new Set();
+  const includePath = (path) => {
+    if (path !== null && ContentPolicyInternalPathSchema.safeParse(path).success) paths.add(path);
+  };
+  for (const snapshot of snapshots) includePath(snapshot.path);
+  for (const dependency of dependencies) {
+    if (!inScope(dependency, scope)) continue;
+    const direct = dependency.entityIds?.some((id) => entityIds.has(id));
+    const shared = dependency.singletonKeys?.some((key) => singletonKeys.has(key));
+    const queried = dependency.queries?.some((query) => snapshots.some((entity) => matchesQuery(entity, query)));
+    if (direct || shared || queried) includePath(dependency.path);
+  }
+  return [...paths].sort();
+}
+
 // src/redirect-paths.ts
 var CONTROL_OR_BACKSLASH = /[\\\u0000-\u001f\u007f]/u;
 var PROTECTED_PREFIX = /^\/(?:api|_next|_vercel|auth|admin|login|logout|revalidate|preview|assets|static|images|fonts|\.well-known)(?:\/|$)/i;
@@ -2638,11 +2766,15 @@ export {
   SITE_PATTERN_KEY_PATTERN,
   SITE_PATTERN_PLACEMENTS_KEY,
   SITE_PATTERN_SLOTS,
+  VISUAL_EDIT_ATTRIBUTE,
+  VISUAL_EDIT_PROTOCOL,
+  VISUAL_EDIT_PROTOCOL_VERSION,
   applyBlockBindings,
   bindingSrcValue,
   bindingTextValue,
   blockSchema,
   boundFieldValue,
+  buildVisualEditPreviewUrl,
   chainResolvers,
   cmsFontSize,
   cmsImageAlign,
@@ -2668,6 +2800,7 @@ export {
   findSitePatternPlacementRule,
   formatMetadataDefaults,
   formatSectionLockViolations,
+  getContentValue,
   htmlToPlainText,
   injectStableIdsTree,
   internalContentKeyFromPath,
@@ -2682,6 +2815,7 @@ export {
   isSitePatternSlotKey,
   isValidBlock,
   isValidSitePatternKey,
+  isVisualEditOrigin,
   issuePreviewToken,
   matchesContentScalarCheck,
   mergeMetadataPatch,
@@ -2695,9 +2829,12 @@ export {
   normalizeRedirectSource,
   normalizeRedirectTarget,
   parseBlock,
+  parseVisualEditAddress,
+  parseVisualEditMessage,
   postsForCollection,
   postsInAnyCollection,
   postsNotInAnyCollection,
+  profileQualificationJsonLdProperties,
   readMetadataValues,
   readSitePatternPlacements,
   readSitePatternPresentation,
@@ -2710,6 +2847,8 @@ export {
   resolveCategoryTreeEntryPath,
   resolveCategoryTreeHubPaths,
   resolveCategoryTreeSelection,
+  resolveContentCta,
+  resolveContentDependencyPaths,
   resolveMetadata,
   resolvePatternSlots,
   resolvePostBodySource,
@@ -2718,16 +2857,27 @@ export {
   resolvePostPath,
   resolvePostPublicPath,
   resolvePostUrl,
+  sameVisualDependencies,
+  sameVisualPreviewTarget,
   sanitizeHtml,
   sanitizeImportedCss,
   sanitizeImportedHtml,
   scopeImportedCss,
   selectContentQuery,
+  selectRelatedContent,
+  selectVisibleFaqEntries,
   serializeBlock,
+  setContentValue,
   setSitePatternPlacementRule,
   sitePatternButtonColor,
   sitePatternPresentationAttributes,
   validateCollections,
-  verifyPreviewToken
+  verifyPreviewToken,
+  visibleFaqPageJsonLd,
+  visualEditAddressKey,
+  visualEditAddressSchema,
+  visualEditAttributes,
+  visualPreviewTargetSchema,
+  visualRenderReceiptSchema
 };
 //# sourceMappingURL=index.js.map