@roottale/cms-core 0.67.1 → 0.68.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @roottale/cms-core
 
+## 0.68.0
+
+### Minor Changes
+
+- d7130d8: 기존 고객 사이트의 검색·공유 기본값을 선언형 계약으로 보존합니다. 문자열 커스텀 필드 템플릿, 본문 문단 대체값, Unicode와 단어 경계 말줄임, 고정 이미지 기본값, 모델별 강제 robots와 분류 공개 경로를 지원합니다. 수동 SEO 설정은 우선하며 강제 검색 차단은 유지합니다.
+
+  분류 조회 SDK에 색인 전환 상태와 추가 캐시 태그를 연결하고 외부 연동 문서·실행 예제를 함께 제공합니다.
+
 ## 0.67.1
 
 ## 0.67.0

package/dist/index.cjs

@@ -98,6 +98,7 @@ __export(src_exports, {
   isValidSitePatternKey: () => isValidSitePatternKey,
   issuePreviewToken: () => issuePreviewToken,
   mergeMetadataPatch: () => mergeMetadataPatch,
+  metadataBodyParagraphs: () => metadataBodyParagraphs,
   metadataContentImageUrl: () => metadataContentImageUrl,
   normalizeEmbed: () => normalizeEmbed,
   normalizeHexColor: () => normalizeHexColor,
@@ -2102,42 +2103,37 @@ function mergeMetadataPatch(current, input) {
 }
 
 // src/metadata-defaults.ts
+var import_zod4 = require("zod");
+
+// src/metadata-text.ts
 var import_zod3 = require("zod");
 var fallbackText = import_zod3.z.string().max(2e3);
-var imageOrigin = import_zod3.z.string().max(2048).refine((value) => {
-  try {
-    const url = new URL(value);
-    return url.protocol === "https:" && url.origin === value;
-  } catch {
-    return false;
-  }
-}, "\uC774\uBBF8\uC9C0 \uD5C8\uC6A9 \uBAA9\uB85D\uC5D0\uB294 \uACBD\uB85C \uC5C6\uB294 HTTPS origin\uB9CC \uC120\uC5B8\uD569\uB2C8\uB2E4");
+var templateToken = /\{\{(?:title|field:[a-zA-Z][a-zA-Z0-9_-]{0,159})\}\}/gu;
+var template = fallbackText.refine(
+  (value) => !/[{}]/u.test(value.replace(templateToken, "")),
+  "\uC790\uB3D9 \uD14D\uC2A4\uD2B8\uC5D0\uB294 {{title}} \uB610\uB294 {{field:\uD544\uB4DC\uC774\uB984}} \uD1A0\uD070\uB9CC \uC0AC\uC6A9\uD569\uB2C8\uB2E4"
+);
 var MetadataTextRuleSchema = import_zod3.z.object({
-  source: import_zod3.z.enum(["content", "fallback"]).optional(),
+  source: import_zod3.z.enum(["content", "fallback", "template"]).optional(),
+  template: template.optional(),
   stripLeadingLabel: import_zod3.z.enum(["question", "answer"]).optional(),
   replaceLineBreakTokens: import_zod3.z.boolean().optional(),
   removeEmDashes: import_zod3.z.boolean().optional(),
   normalizeWhitespace: import_zod3.z.boolean().optional(),
   maxLength: import_zod3.z.number().int().min(1).max(2e3).optional(),
+  lengthUnit: import_zod3.z.enum(["code-units", "code-points"]).optional(),
+  wordBoundaryMinLength: import_zod3.z.number().int().min(1).max(2e3).optional(),
   ellipsis: import_zod3.z.string().max(10).optional(),
+  bodyFallback: import_zod3.z.object({
+    preferContaining: import_zod3.z.string().trim().min(1).max(100).optional(),
+    stripLeadingLabel: import_zod3.z.literal("conclusion").optional()
+  }).strict().optional(),
   fallback: fallbackText.optional(),
   fallbackWithParent: fallbackText.optional(),
   fallbackWithoutParent: fallbackText.optional(),
   fallbackBySlug: import_zod3.z.record(import_zod3.z.string().max(200), fallbackText).optional()
-}).strict().refine((rule) => !rule.ellipsis || rule.maxLength !== void 0 && rule.ellipsis.length < rule.maxLength, "\uB9D0\uC904\uC784\uD45C\uC5D0\uB294 \uB354 \uAE34 \uCD5C\uB300 \uAE38\uC774\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4");
-var MetadataDefaultRulesSchema = import_zod3.z.object({
-  title: MetadataTextRuleSchema.optional(),
-  description: MetadataTextRuleSchema.optional(),
-  useFirstBodyImage: import_zod3.z.boolean().optional(),
-  useTermImage: import_zod3.z.boolean().optional(),
-  imageAltSource: import_zod3.z.enum(["content", "title"]).optional(),
-  legacyImageSource: import_zod3.z.literal("legacy-thumbnail").optional(),
-  imageAllowedOrigins: import_zod3.z.array(imageOrigin).min(1).max(32).optional(),
-  legacyImageAllowedOrigins: import_zod3.z.array(imageOrigin).min(1).max(32).optional(),
-  normalizeCloudflareImages: import_zod3.z.boolean().optional(),
-  fallback: MetadataValuesSchema.optional()
-}).strict().refine((rule) => !rule.legacyImageSource || Boolean(rule.legacyImageAllowedOrigins?.length), "\uC774\uC804 \uC774\uBBF8\uC9C0 \uC6D0\uBCF8\uC5D0\uB294 \uD5C8\uC6A9 origin \uC120\uC5B8\uC774 \uD544\uC694\uD569\uB2C8\uB2E4");
-function cleanText(value, rule) {
+}).strict().refine((rule) => !rule.ellipsis || rule.maxLength !== void 0 && rule.ellipsis.length < rule.maxLength, "\uB9D0\uC904\uC784\uD45C\uC5D0\uB294 \uB354 \uAE34 \uCD5C\uB300 \uAE38\uC774\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4").refine((rule) => rule.source === "template" ? rule.template !== void 0 : rule.template === void 0, "\uD14D\uC2A4\uD2B8 template\uC740 source: template\uACFC \uD568\uAED8 \uC120\uC5B8\uD569\uB2C8\uB2E4").refine((rule) => !rule.wordBoundaryMinLength || Boolean(rule.maxLength && rule.wordBoundaryMinLength < rule.maxLength), "\uB2E8\uC5B4 \uACBD\uACC4\uC5D0\uB294 \uB354 \uAE34 \uCD5C\uB300 \uAE38\uC774\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4");
+function cleanMetadataText(value, rule) {
   let text2 = value.trim();
   if (rule?.stripLeadingLabel === "question") text2 = text2.replace(/^\s*Q[.．:]?\s*/iu, "");
   if (rule?.stripLeadingLabel === "answer") text2 = text2.replace(/^\s*A[.．:]?\s*/iu, "");
@@ -2146,20 +2142,90 @@ function cleanText(value, rule) {
   if (rule?.normalizeWhitespace) text2 = text2.replace(/\s+/gu, " ");
   return text2.trim();
 }
-function formatText(value, rule, input, name) {
-  let text2 = rule?.source === "fallback" ? "" : cleanText(value ?? "", rule);
+function metadataBodyParagraphs(value) {
+  const paragraphs = [];
+  const textParts = (node) => {
+    if (Array.isArray(node)) return node.flatMap(textParts);
+    if (!node || typeof node !== "object") return [];
+    const item = node;
+    return [...typeof item.text === "string" ? [item.text] : [], ...textParts(item.content)];
+  };
+  const walk = (node) => {
+    if (Array.isArray(node)) {
+      node.forEach(walk);
+      return;
+    }
+    if (!node || typeof node !== "object") return;
+    const item = node;
+    if (item.type === "paragraph") {
+      const text2 = textParts(item.content).join(" ").replace(/\s+/gu, " ").trim();
+      if (text2) paragraphs.push(text2);
+    } else walk(item.content);
+  };
+  walk(value);
+  return paragraphs;
+}
+function formatMetadataText(value, rule, input, name) {
+  let text2 = rule?.source === "fallback" ? "" : cleanMetadataText(value ?? "", rule);
+  if (rule?.source === "template") {
+    text2 = cleanMetadataText((rule.template ?? "").replace(templateToken, (token) => {
+      if (token === "{{title}}") return name;
+      const field = token.slice(8, -2);
+      const value2 = Object.hasOwn(input.fields ?? {}, field) ? input.fields?.[field] : void 0;
+      return typeof value2 === "string" ? value2.trim() : "";
+    }), rule);
+  }
+  if (!text2 && rule?.bodyFallback) {
+    const paragraphs = input.bodyParagraphs ?? [];
+    const preferred = rule.bodyFallback.preferContaining;
+    text2 = (preferred ? paragraphs.find((paragraph) => paragraph.includes(preferred)) : void 0) ?? paragraphs[0] ?? "";
+    if (rule.bodyFallback.stripLeadingLabel === "conclusion") text2 = text2.replace(/^(먼저\s*)?결론부터\s*(말씀드리면|말씀드릴게요)[.!?]?\s*/u, "");
+    text2 = cleanMetadataText(text2, rule);
+  }
   if (!text2) {
-    const fallback = input.parentId ? rule?.fallbackWithParent ?? rule?.fallback : (input.slug ? rule?.fallbackBySlug?.[input.slug] : void 0) ?? rule?.fallbackWithoutParent ?? rule?.fallback;
-    text2 = cleanText((fallback ?? "").replaceAll("%s", () => name), rule);
+    const slugFallback = input.slug && Object.hasOwn(rule?.fallbackBySlug ?? {}, input.slug) ? rule?.fallbackBySlug?.[input.slug] : void 0;
+    const fallback = input.parentId ? rule?.fallbackWithParent ?? rule?.fallback : slugFallback ?? rule?.fallbackWithoutParent ?? rule?.fallback;
+    text2 = cleanMetadataText((fallback ?? "").replaceAll("%s", () => name), rule);
   }
   if (!text2) return void 0;
-  if (rule?.maxLength && text2.length > rule.maxLength) {
+  const units = rule?.lengthUnit === "code-points" ? [...text2] : text2.split("");
+  if (rule?.maxLength && units.length > rule.maxLength) {
     const suffix = rule.ellipsis ?? "";
-    const head = text2.slice(0, rule.maxLength - suffix.length);
+    const suffixLength = rule.lengthUnit === "code-points" ? [...suffix].length : suffix.length;
+    let head = units.slice(0, rule.maxLength - suffixLength).join("");
+    const boundary = head.lastIndexOf(" ");
+    if (rule.wordBoundaryMinLength && boundary >= rule.wordBoundaryMinLength) head = head.slice(0, boundary);
     return suffix ? head.trimEnd() + suffix : head;
   }
   return text2;
 }
+
+// src/metadata-defaults.ts
+var imageOrigin = import_zod4.z.string().max(2048).refine((value) => {
+  try {
+    const url = new URL(value);
+    return url.protocol === "https:" && url.origin === value;
+  } catch {
+    return false;
+  }
+}, "\uC774\uBBF8\uC9C0 \uD5C8\uC6A9 \uBAA9\uB85D\uC5D0\uB294 \uACBD\uB85C \uC5C6\uB294 HTTPS origin\uB9CC \uC120\uC5B8\uD569\uB2C8\uB2E4");
+var MetadataDefaultRulesSchema = import_zod4.z.object({
+  title: MetadataTextRuleSchema.optional(),
+  titleTemplateMaxLength: import_zod4.z.number().int().min(1).max(1e3).optional(),
+  description: MetadataTextRuleSchema.optional(),
+  /** Code-owned defaults precede site defaults but always follow manual overrides. */
+  defaults: MetadataValuesSchema.optional(),
+  robots: MetadataRobotsPolicySchema.optional(),
+  useFeaturedImage: import_zod4.z.boolean().optional(),
+  useFirstBodyImage: import_zod4.z.boolean().optional(),
+  useTermImage: import_zod4.z.boolean().optional(),
+  imageAltSource: import_zod4.z.enum(["content", "title"]).optional(),
+  legacyImageSource: import_zod4.z.literal("legacy-thumbnail").optional(),
+  imageAllowedOrigins: import_zod4.z.array(imageOrigin).min(1).max(32).optional(),
+  legacyImageAllowedOrigins: import_zod4.z.array(imageOrigin).min(1).max(32).optional(),
+  normalizeCloudflareImages: import_zod4.z.boolean().optional(),
+  fallback: MetadataValuesSchema.optional()
+}).strict().refine((rule) => !rule.legacyImageSource || Boolean(rule.legacyImageAllowedOrigins?.length), "\uC774\uC804 \uC774\uBBF8\uC9C0 \uC6D0\uBCF8\uC5D0\uB294 \uD5C8\uC6A9 origin \uC120\uC5B8\uC774 \uD544\uC694\uD569\uB2C8\uB2E4");
 function metadataContentImageUrl(value, normalizeCloudflareImages = false) {
   if (!normalizeCloudflareImages) return value;
   try {
@@ -2199,15 +2265,19 @@ function contentCandidateAllowed(value, input, rule) {
 function formatMetadataDefaults(input, declaration) {
   const dynamic = declaration[input.kind];
   const rule = dynamic?.defaultRules?.[input.modelKey];
-  const name = cleanText(input.title, rule?.title);
-  const title = formatText(input.title, rule?.title, input, name);
-  const template = dynamic?.titleTemplates?.[input.modelKey];
-  const description = formatText(input.description, rule?.description, input, name);
+  const name = cleanMetadataText(input.title, rule?.title);
+  const title = formatMetadataText(input.title, rule?.title, input, name);
+  const template2 = dynamic?.titleTemplates?.[input.modelKey];
+  const templatedTitle = title && template2 ? template2.replace("%s", () => title) : title;
+  const finalTitle = templatedTitle && rule?.titleTemplateMaxLength && templatedTitle.length > rule.titleTemplateMaxLength ? title : templatedTitle;
+  const description = formatMetadataText(input.description, rule?.description, input, name);
   const bodyImage = input.firstBodyImage && (input.firstBodyImage.startsWith("https://") || /^\/(?!\/)/u.test(input.firstBodyImage)) ? input.firstBodyImage : void 0;
-  const candidateImage = input.kind === "terms" && rule?.useTermImage === false ? void 0 : input.featuredImage || (rule?.useFirstBodyImage ? bodyImage : void 0) || legacyImageUrl(input.legacyImage, rule);
+  const featuredImage = (input.kind === "terms" ? rule?.useTermImage : rule?.useFeaturedImage) === false ? void 0 : input.featuredImage;
+  const candidateImage = featuredImage || (rule?.useFirstBodyImage ? bodyImage : void 0) || legacyImageUrl(input.legacyImage, rule);
   const ogImage = candidateImage && contentCandidateAllowed(candidateImage, input, rule) ? readMetadataValues({ ogImage: metadataContentImageUrl(candidateImage, rule?.normalizeCloudflareImages) }).ogImage : void 0;
   return {
-    ...title ? { title: template ? template.replace("%s", () => title) : title } : {},
+    ...readMetadataValues(rule?.defaults),
+    ...finalTitle ? { title: finalTitle } : {},
     ...description ? { description } : {},
     ...ogImage ? { ogImage } : {}
   };
@@ -2343,6 +2413,7 @@ function normalizeRedirectTarget(raw) {
   isValidSitePatternKey,
   issuePreviewToken,
   mergeMetadataPatch,
+  metadataBodyParagraphs,
   metadataContentImageUrl,
   normalizeEmbed,
   normalizeHexColor,