fimo-next 2.3.2 → 2.4.0-staging.2

package/dist/config.js

@@ -6,10 +6,11 @@ function readPreviewOrigins() {
         .map((origin) => origin.trim())
         .filter(Boolean);
 }
-// FIMO-2335: `buildFimoMetadata` reads `.fimo/config.json` at request time in
-// deployed SSR, but Next only traces files it can see statically — without
-// this include the file is missing from the server bundle.
-const FIMO_TRACING_INCLUDES = { '/**': ['.fimo/config.json'] };
+// FIMO-2467: runtime config discovery is dynamic, so Next cannot trace current
+// and legacy SEO config paths from the reader alone.
+const FIMO_TRACING_INCLUDES = {
+    '/**': ['.fimo/config.json', 'fimo-config.json', 'fimo.config.json'],
+};
 function withConfigTracing(config) {
     const application = config.outputFileTracingIncludes;
     const outputFileTracingIncludes = { ...FIMO_TRACING_INCLUDES };

package/dist/runtime/next/seo-metadata.d.ts

@@ -0,0 +1,14 @@
+import type { FimoSEO } from 'fimo/seo';
+import type { Metadata, Viewport } from 'next';
+/**
+ * Pure conversion to App Router metadata. Does not load config or merge app
+ * metadata. Next supplies social title/description and Twitter images from
+ * the final page metadata. Undefined SEO returns an empty object.
+ */
+export declare function toNextMetadata(seo?: FimoSEO): Metadata;
+/**
+ * Pure conversion of themeColor to App Router viewport settings. Next renders
+ * theme-color through viewport exports, not metadata exports.
+ */
+export declare function toNextViewport(seo?: FimoSEO): Viewport;
+//# sourceMappingURL=seo-metadata.d.ts.map

package/dist/runtime/next/seo-metadata.js

@@ -0,0 +1,47 @@
+function toMetadataBase(url) {
+    if (!url) {
+        return undefined;
+    }
+    try {
+        return new URL(url);
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Pure conversion to App Router metadata. Does not load config or merge app
+ * metadata. Next supplies social title/description and Twitter images from
+ * the final page metadata. Undefined SEO returns an empty object.
+ */
+export function toNextMetadata(seo) {
+    if (!seo) {
+        return {};
+    }
+    const metadataBase = toMetadataBase(seo.url);
+    return {
+        ...(seo.title ? { title: seo.title } : {}),
+        ...(seo.description ? { description: seo.description } : {}),
+        ...(metadataBase ? { metadataBase, alternates: { canonical: './' } } : {}),
+        ...(seo.robots ? { robots: seo.robots } : {}),
+        ...(seo.favicon ? { icons: { icon: seo.favicon, apple: seo.favicon } } : {}),
+        openGraph: {
+            type: 'website',
+            ...(metadataBase ? { url: './' } : {}),
+            ...(seo.siteName ? { siteName: seo.siteName } : {}),
+            ...(seo.image ? { images: [seo.image] } : {}),
+            ...(seo.locale ? { locale: seo.locale } : {}),
+        },
+        twitter: {
+            card: 'summary_large_image',
+            ...(seo.twitterSite ? { site: seo.twitterSite } : {}),
+        },
+    };
+}
+/**
+ * Pure conversion of themeColor to App Router viewport settings. Next renders
+ * theme-color through viewport exports, not metadata exports.
+ */
+export function toNextViewport(seo) {
+    return seo?.themeColor ? { themeColor: seo.themeColor } : {};
+}

package/dist/runtime/next/seo.d.ts

@@ -1,17 +1,6 @@
 import type { Metadata, Viewport } from 'next';
-/**
- * Site-wide `Metadata` defaults resolved from `.fimo/config.json#seo` — the
- * values edited in Studio's Settings → SEO. Wire it as the root layout's
- * `generateMetadata`. Resolves the global (`/`) SEO only; page-level
- * `metadata`/`generateMetadata` exports merge over these defaults, so
- * per-page SEO stays application-owned. Returns `{}` when the project
- * declares no SEO config.
- */
+/** Global defaults only; the optional argument remains a project directory, not a route. */
 export declare function buildFimoMetadata(rootDir?: string): Metadata;
-/**
- * Viewport counterpart of `buildFimoMetadata` — Next renders `theme-color`
- * from the viewport export, not `Metadata`. Wire it as the root layout's
- * `generateViewport`.
- */
+/** Global theme color only. Use an explicit route reader for route-specific colors. */
 export declare function buildFimoViewport(rootDir?: string): Viewport;
 //# sourceMappingURL=seo.d.ts.map

package/dist/runtime/next/seo.js

@@ -1,59 +1,10 @@
 import { getConfigServer } from 'fimo/config';
-import { resolveSeoForPath } from 'fimo/seo';
-function toMetadataBase(url) {
-    if (!url) {
-        return undefined;
-    }
-    try {
-        return new URL(url);
-    }
-    catch {
-        return undefined;
-    }
-}
-/**
- * Site-wide `Metadata` defaults resolved from `.fimo/config.json#seo` — the
- * values edited in Studio's Settings → SEO. Wire it as the root layout's
- * `generateMetadata`. Resolves the global (`/`) SEO only; page-level
- * `metadata`/`generateMetadata` exports merge over these defaults, so
- * per-page SEO stays application-owned. Returns `{}` when the project
- * declares no SEO config.
- */
+import { toNextMetadata, toNextViewport } from './seo-metadata.js';
+/** Global defaults only; the optional argument remains a project directory, not a route. */
 export function buildFimoMetadata(rootDir = process.cwd()) {
-    const seo = resolveSeoForPath('/', getConfigServer(rootDir));
-    if (!seo) {
-        return {};
-    }
-    const metadataBase = toMetadataBase(seo.url);
-    return {
-        ...(seo.title ? { title: seo.title } : {}),
-        ...(seo.description ? { description: seo.description } : {}),
-        ...(metadataBase ? { metadataBase, alternates: { canonical: './' } } : {}),
-        ...(seo.robots ? { robots: seo.robots } : {}),
-        ...(seo.favicon ? { icons: { icon: seo.favicon, apple: seo.favicon } } : {}),
-        openGraph: {
-            type: 'website',
-            ...(seo.siteName ? { siteName: seo.siteName } : {}),
-            ...(seo.title ? { title: seo.title } : {}),
-            ...(seo.description ? { description: seo.description } : {}),
-            ...(seo.image ? { images: [seo.image] } : {}),
-            ...(seo.locale ? { locale: seo.locale } : {}),
-        },
-        twitter: {
-            card: 'summary_large_image',
-            ...(seo.twitterSite ? { site: seo.twitterSite } : {}),
-            ...(seo.title ? { title: seo.title } : {}),
-            ...(seo.description ? { description: seo.description } : {}),
-            ...(seo.image ? { images: [seo.image] } : {}),
-        },
-    };
+    return toNextMetadata(getConfigServer(rootDir).seo);
 }
-/**
- * Viewport counterpart of `buildFimoMetadata` — Next renders `theme-color`
- * from the viewport export, not `Metadata`. Wire it as the root layout's
- * `generateViewport`.
- */
+/** Global theme color only. Use an explicit route reader for route-specific colors. */
 export function buildFimoViewport(rootDir = process.cwd()) {
-    const seo = resolveSeoForPath('/', getConfigServer(rootDir));
-    return seo?.themeColor ? { themeColor: seo.themeColor } : {};
+    return toNextViewport(getConfigServer(rootDir).seo);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fimo-next",
-  "version": "2.3.2",
+  "version": "2.4.0-staging.2",
   "description": "Fimo runtime for Next.js projects.",
   "files": [
     "dist/",
@@ -28,6 +28,10 @@
       "types": "./dist/runtime/next/client.d.ts",
       "import": "./dist/runtime/next/client.js"
     },
+    "./seo": {
+      "types": "./dist/runtime/next/seo-metadata.d.ts",
+      "import": "./dist/runtime/next/seo-metadata.js"
+    },
     "./config": {
       "types": "./dist/config.d.ts",
       "import": "./dist/config.js",
@@ -45,13 +49,13 @@
     "test:watch": "vitest"
   },
   "devDependencies": {
-    "@fimo/tsconfig": "2.3.2",
+    "@fimo/tsconfig": "2.4.0-staging.2",
     "@tanstack/react-query": "^5.80.6",
     "@types/node": "22.18.6",
     "@types/react": "19.2.14",
     "@types/react-dom": "19.2.3",
-    "fimo": "2.3.2",
-    "fimo-react": "2.3.2",
+    "fimo": "2.4.0-staging.2",
+    "fimo-react": "2.4.0-staging.2",
     "next": "16.3.3",
     "react": "19.2.4",
     "react-dom": "19.2.4",
@@ -60,7 +64,7 @@
   },
   "peerDependencies": {
     "@tanstack/react-query": "^5.80.6",
-    "fimo": ">=2.0.1",
+    "fimo": "2.4.0-staging.2",
     "fimo-react": ">=2.0.1",
     "next": "^15.0.0 || ^16.0.0",
     "react": "^18.2.0 || ^19.0.0",