@roottale/cms-core 0.67.0 → 0.68.0

package/dist/index.js

@@ -1960,42 +1960,37 @@ function mergeMetadataPatch(current, input) {
 }
 
 // src/metadata-defaults.ts
+import { z as z4 } from "zod";
+
+// src/metadata-text.ts
 import { z as z3 } from "zod";
 var fallbackText = z3.string().max(2e3);
-var imageOrigin = z3.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 = z3.object({
-  source: z3.enum(["content", "fallback"]).optional(),
+  source: z3.enum(["content", "fallback", "template"]).optional(),
+  template: template.optional(),
   stripLeadingLabel: z3.enum(["question", "answer"]).optional(),
   replaceLineBreakTokens: z3.boolean().optional(),
   removeEmDashes: z3.boolean().optional(),
   normalizeWhitespace: z3.boolean().optional(),
   maxLength: z3.number().int().min(1).max(2e3).optional(),
+  lengthUnit: z3.enum(["code-units", "code-points"]).optional(),
+  wordBoundaryMinLength: z3.number().int().min(1).max(2e3).optional(),
   ellipsis: z3.string().max(10).optional(),
+  bodyFallback: z3.object({
+    preferContaining: z3.string().trim().min(1).max(100).optional(),
+    stripLeadingLabel: z3.literal("conclusion").optional()
+  }).strict().optional(),
   fallback: fallbackText.optional(),
   fallbackWithParent: fallbackText.optional(),
   fallbackWithoutParent: fallbackText.optional(),
   fallbackBySlug: z3.record(z3.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 = z3.object({
-  title: MetadataTextRuleSchema.optional(),
-  description: MetadataTextRuleSchema.optional(),
-  useFirstBodyImage: z3.boolean().optional(),
-  useTermImage: z3.boolean().optional(),
-  imageAltSource: z3.enum(["content", "title"]).optional(),
-  legacyImageSource: z3.literal("legacy-thumbnail").optional(),
-  imageAllowedOrigins: z3.array(imageOrigin).min(1).max(32).optional(),
-  legacyImageAllowedOrigins: z3.array(imageOrigin).min(1).max(32).optional(),
-  normalizeCloudflareImages: z3.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, "");
@@ -2004,20 +1999,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 = z4.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 = z4.object({
+  title: MetadataTextRuleSchema.optional(),
+  titleTemplateMaxLength: z4.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: z4.boolean().optional(),
+  useFirstBodyImage: z4.boolean().optional(),
+  useTermImage: z4.boolean().optional(),
+  imageAltSource: z4.enum(["content", "title"]).optional(),
+  legacyImageSource: z4.literal("legacy-thumbnail").optional(),
+  imageAllowedOrigins: z4.array(imageOrigin).min(1).max(32).optional(),
+  legacyImageAllowedOrigins: z4.array(imageOrigin).min(1).max(32).optional(),
+  normalizeCloudflareImages: z4.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 {
@@ -2057,15 +2122,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 } : {}
   };
@@ -2200,6 +2269,7 @@ export {
   isValidSitePatternKey,
   issuePreviewToken,
   mergeMetadataPatch,
+  metadataBodyParagraphs,
   metadataContentImageUrl,
   normalizeEmbed,
   normalizeHexColor,