@decocms/start 0.25.1 → 0.25.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decocms/start",
-  "version": "0.25.1",
+  "version": "0.25.3",
   "type": "module",
   "description": "Deco framework for TanStack Start - CMS bridge, admin protocol, hooks, schema generation",
   "main": "./src/index.ts",

package/scripts/generate-blocks.ts

@@ -22,7 +22,17 @@ const blocksDir = path.resolve(process.cwd(), arg("blocks-dir", ".deco/blocks"))
 const outFile = path.resolve(process.cwd(), arg("out-file", "src/server/cms/blocks.gen.ts"));
 
 function decodeBlockName(filename: string): string {
-  return decodeURIComponent(decodeURIComponent(filename)).replace(/\.json$/, "");
+  let name = filename.replace(/\.json$/, "");
+  while (name.includes("%")) {
+    try {
+      const next = decodeURIComponent(name);
+      if (next === name) break;
+      name = next;
+    } catch {
+      break; // literal % in the decoded name — nothing left to decode
+    }
+  }
+  return name;
 }
 
 if (!fs.existsSync(blocksDir)) {

package/src/cms/index.ts

@@ -3,6 +3,7 @@ export {
   findPageByPath,
   getAllPages,
   getRevision,
+  getSiteSeo,
   loadBlocks,
   onChange,
   setBlocks,

package/src/cms/loader.ts

@@ -161,6 +161,31 @@ function matchPath(pattern: string, urlPath: string): Record<string, string> | n
   return params;
 }
 
+/**
+ * Extract the site-wide SEO config from the "Site" app block.
+ *
+ * In the original deco-cx/deco framework this is `ctx.seo` — the app-level
+ * SEO configuration that provides fallback title, description, and templates
+ * when page-level seo blocks don't supply them.
+ */
+export function getSiteSeo(): {
+  title?: string;
+  description?: string;
+  titleTemplate?: string;
+  descriptionTemplate?: string;
+  image?: string;
+  favicon?: string;
+  themeColor?: string;
+  noIndexing?: boolean;
+} {
+  const blocks = loadBlocks();
+  const site = blocks["Site"] as Record<string, unknown> | undefined;
+  if (!site) return {};
+  const seo = site.seo as Record<string, unknown> | undefined;
+  if (!seo) return {};
+  return seo as ReturnType<typeof getSiteSeo>;
+}
+
 export function findPageByPath(
   targetPath: string,
 ): { page: DecoPage; params: Record<string, string> } | null {

package/src/routes/cmsRoute.ts

@@ -37,6 +37,7 @@ import {
   resolveDecoPage,
   resolveDeferredSection,
 } from "../cms/resolve";
+import { getSiteSeo } from "../cms/loader";
 import { runSectionLoaders, runSingleSectionLoader } from "../cms/sectionLoaders";
 import {
   type CacheProfile,
@@ -269,7 +270,19 @@ async function buildPageSeo(
   // Secondary source: SEO sections embedded in the sections array
   const sectionSeo = extractSeoFromSections(enrichedSections);
 
-  if (!seoSection) return sectionSeo;
+  // Site-wide SEO config from the "Site" app block — mirrors ctx.seo in
+  // the original deco-cx/deco framework. Provides fallback title,
+  // description, and templates when page-level seo doesn't supply them.
+  const siteSeo = getSiteSeo();
+
+  if (!seoSection) {
+    // No page.seo block — use site-wide SEO as primary, section-contributed as secondary
+    const merged: PageSeo = { ...sectionSeo };
+    if (siteSeo.title && !merged.title) merged.title = siteSeo.title;
+    if (siteSeo.description && !merged.description) merged.description = siteSeo.description;
+    if (siteSeo.image && !merged.image) merged.image = siteSeo.image;
+    return merged;
+  }
 
   // Run the section loader on the seo section if one is registered
   // (e.g., SEOPDP loader transforms {jsonLD: ProductDetailsPage} → {title, description, ...})
@@ -283,16 +296,28 @@ async function buildPageSeo(
 
   const pageSeo = extractSeoFromProps(enrichedProps);
 
-  // Apply title/description templates from the SEO block config.
-  // SeoV2 blocks carry templates like "%s | CASA & VIDEO" that wrap
-  // the computed title. Template "%s" is a no-op.
+  // Replicate original SeoV2 loader logic: `_title ?? appTitle`
+  // When the page's seo block doesn't have a title/description,
+  // fall back to the Site app's seo config.
+  if (!pageSeo.title && siteSeo.title) pageSeo.title = siteSeo.title;
+  if (!pageSeo.description && siteSeo.description) pageSeo.description = siteSeo.description;
+  if (!pageSeo.image && siteSeo.image) pageSeo.image = siteSeo.image;
+
+  // Apply title/description templates.
+  // Priority: page-level template → site-level template → no-op.
+  // This mirrors the original: `(titleTemplate ?? "").trim().length === 0 ? "%s" : titleTemplate`
   const rawProps = seoSection.props;
-  const titleTemplate = rawProps.titleTemplate as string | undefined;
-  const descTemplate = rawProps.descriptionTemplate as string | undefined;
-  if (titleTemplate && titleTemplate !== "%s" && pageSeo.title) {
+  const titleTemplate =
+    effectiveTemplate(rawProps.titleTemplate as string | undefined) ??
+    effectiveTemplate(siteSeo.titleTemplate);
+  const descTemplate =
+    effectiveTemplate(rawProps.descriptionTemplate as string | undefined) ??
+    effectiveTemplate(siteSeo.descriptionTemplate);
+
+  if (titleTemplate && pageSeo.title) {
     pageSeo.title = titleTemplate.replace("%s", pageSeo.title);
   }
-  if (descTemplate && descTemplate !== "%s" && pageSeo.description) {
+  if (descTemplate && pageSeo.description) {
     pageSeo.description = descTemplate.replace("%s", pageSeo.description);
   }
 
@@ -301,6 +326,12 @@ async function buildPageSeo(
   return { ...sectionSeo, ...pageSeo };
 }
 
+/** Returns a non-trivial template string, or undefined for "%s" / empty / blank. */
+function effectiveTemplate(tmpl: string | undefined): string | undefined {
+  if (!tmpl || tmpl.trim() === "" || tmpl.trim() === "%s") return undefined;
+  return tmpl;
+}
+
 // ---------------------------------------------------------------------------
 // Head metadata builder
 // ---------------------------------------------------------------------------