fimo 2.3.2 → 2.4.0-staging.2

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

@@ -1,2 +1,3 @@
 export * from './resolver.js';
+export type { FimoSEO } from '../shared/fimo-config.types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/runtime/seo/resolver.js

@@ -86,6 +86,16 @@ export function resolveTemplate(template, context) {
 }
 function resolveSeoField(routeValue, globalValue, context) {
     if (routeValue) {
+        for (const token of routeValue.matchAll(/\{\{([^}]+)\}\}/g)) {
+            const raw = getNestedValue(context, token[1].trim());
+            const value = raw instanceof String || raw instanceof Number || raw instanceof Boolean ? raw.valueOf() : raw;
+            if (value == null ||
+                (typeof value === 'string' && value.trim() === '') ||
+                !['string', 'number', 'boolean'].includes(typeof value) ||
+                (typeof value === 'number' && !Number.isFinite(value))) {
+                return globalValue;
+            }
+        }
         return resolveTemplate(routeValue, context);
     }
     return globalValue;

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

@@ -0,0 +1,13 @@
+import type { FimoSEO } from '../shared/fimo-config.types.js';
+export interface GetFimoSeoOptions {
+    pathname?: string;
+    routeData?: Record<string, unknown>;
+    rootDir?: string;
+}
+/**
+ * Read global SEO, or resolve an explicit pathname against the project's route
+ * catalog. Node only. Missing config/SEO returns undefined; other read and JSON
+ * errors propagate. No cache: rendering/revalidation remains application-owned.
+ */
+export declare function getFimoSeo({ pathname, routeData, rootDir }?: GetFimoSeoOptions): FimoSEO | undefined;
+//# sourceMappingURL=server.d.ts.map

package/dist/runtime/seo/server.js

@@ -0,0 +1,23 @@
+import { readConfigServer } from '../shared/fimo-config.server.js';
+import { resolveSeoForPath } from './resolver.js';
+/**
+ * Read global SEO, or resolve an explicit pathname against the project's route
+ * catalog. Node only. Missing config/SEO returns undefined; other read and JSON
+ * errors propagate. No cache: rendering/revalidation remains application-owned.
+ */
+export function getFimoSeo({ pathname, routeData, rootDir = process.cwd() } = {}) {
+    let config;
+    try {
+        config = readConfigServer(rootDir);
+    }
+    catch (error) {
+        if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
+            return undefined;
+        }
+        throw error;
+    }
+    if (pathname !== undefined) {
+        return resolveSeoForPath(pathname, config, routeData);
+    }
+    return config.seo && Object.keys(config.seo).length > 0 ? config.seo : undefined;
+}

package/dist/runtime/shared/fimo-config.server.d.ts

@@ -4,6 +4,8 @@ import type { FimoConfig } from './fimo-config.types.js';
  * Reads JSON directly to avoid virtual module issues during config loading.
  */
 export declare function getConfigServer(rootDir: string): FimoConfig;
+/** Read the selected config without swallowing I/O or JSON errors. */
+export declare function readConfigServer(rootDir: string): FimoConfig;
 export declare function getConfigVersion(rootDir: string): number;
 /** Resolve the current config path while keeping legacy projects readable. */
 export declare function resolveFimoConfigPath(rootDir: string): string;

package/dist/runtime/shared/fimo-config.server.js

@@ -13,25 +13,29 @@ const defaultConfig = {
  */
 export function getConfigServer(rootDir) {
     try {
-        const configPath = resolveFimoConfigPath(rootDir);
-        const content = readFileSync(configPath, 'utf-8');
-        // `fimo validate` owns strict config validation. The public runtime only
-        // reads the already-validated values and must stay self-contained: importing
-        // the repository-private API contracts package would break installed apps.
-        const raw = JSON.parse(content);
-        return {
-            runtime: raw.runtime,
-            hosting: raw.hosting,
-            seo: raw.seo,
-            i18n: raw.i18n,
-            routes: raw.routes,
-            version: raw.version,
-        };
+        return readConfigServer(rootDir);
     }
     catch {
         return defaultConfig;
     }
 }
+/** Read the selected config without swallowing I/O or JSON errors. */
+export function readConfigServer(rootDir) {
+    const configPath = resolveFimoConfigPath(rootDir);
+    const content = readFileSync(configPath, 'utf-8');
+    // `fimo validate` owns strict config validation. The public runtime only
+    // reads the already-validated values and must stay self-contained: importing
+    // the repository-private API contracts package would break installed apps.
+    const raw = JSON.parse(content);
+    return {
+        runtime: raw.runtime,
+        hosting: raw.hosting,
+        seo: raw.seo,
+        i18n: raw.i18n,
+        routes: raw.routes,
+        version: raw.version,
+    };
+}
 export function getConfigVersion(rootDir) {
     try {
         const configPath = resolveFimoConfigPath(rootDir);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fimo",
-  "version": "2.3.2",
+  "version": "2.4.0-staging.2",
   "description": "Fimo CLI - create, deploy, and manage Fimo projects",
   "keywords": [
     "astro-component"
@@ -57,6 +57,10 @@
       "types": "./dist/runtime/seo/index.d.ts",
       "import": "./dist/runtime/seo/index.js"
     },
+    "./seo/server": {
+      "types": "./dist/runtime/seo/server.d.ts",
+      "import": "./dist/runtime/seo/server.js"
+    },
     "./sync": {
       "types": "./dist/scripts/index.d.ts",
       "import": "./dist/scripts/index.js"
@@ -189,13 +193,13 @@
   "devDependencies": {
     "@clack/core": "^1.2.0",
     "@clack/prompts": "^1.2.0",
-    "@fimo/agents-bundle": "2.3.2",
-    "@fimo/api-contracts": "2.3.2",
-    "@fimo/cli-kit": "2.3.2",
-    "@fimo/framework-detect": "2.3.2",
-    "@fimo/routes": "2.3.2",
-    "@fimo/sdk": "2.3.2",
-    "@fimo/tsconfig": "2.3.2",
+    "@fimo/agents-bundle": "2.4.0-staging.2",
+    "@fimo/api-contracts": "2.4.0-staging.2",
+    "@fimo/cli-kit": "2.4.0-staging.2",
+    "@fimo/framework-detect": "2.4.0-staging.2",
+    "@fimo/routes": "2.4.0-staging.2",
+    "@fimo/sdk": "2.4.0-staging.2",
+    "@fimo/tsconfig": "2.4.0-staging.2",
     "@types/node": "22.18.6",
     "agent-install": "^0.0.5",
     "astro": "^7.1.6",

package/release.json

@@ -1,5 +1,5 @@
 {
   "source": "npm",
-  "apiUrl": "https://api.fimo.ai",
-  "webUrl": "https://fimo.ai"
+  "apiUrl": "https://api.staging.fimo.team",
+  "webUrl": "https://staging.fimo.team"
 }

package/templates/astro/package.json

@@ -9,8 +9,8 @@
     "check": "astro sync && astro check"
   },
   "dependencies": {
-    "fimo": "2.3.2",
-    "fimo-astro": "2.3.2"
+    "fimo": "2.4.0-staging.2",
+    "fimo-astro": "2.4.0-staging.2"
   },
   "devDependencies": {
     "@astrojs/check": "^0.9.10",

package/templates/nextjs/AGENTS.md

@@ -40,7 +40,7 @@ The scaffolded homepage is disposable. Replace it on the first real generation.
 - Next's `app` tree is the router and stays authoritative: the default shell is one ordinary root layout plus `/` as the homepage, and unknown paths get Next's native 404. When a product requires locale URLs, implement the framework-native strategy (`[locale]` segments, middleware, cookies, domains, or an i18n library), pass the resolved locale into Fimo server reads and `FimoProvider`, and load `fimo skills get fimo-code --ref frameworks/next/locales` first. Do not impose locale-prefixed URLs on a default-only project.
 - `FimoProvider` owns the optional Studio preview runtime. Do not add a preview bridge component, read Fimo preview environment variables, or inject Fimo scripts in application code.
 - Keep `.fimo/config.json#routes` as Studio metadata, not as the Next.js router. Describe only URLs the application actually serves; add a `:locale` segment to a route's metadata only after the application implements that locale routing. There, `params.locale.optional: true` means omit the configured default locale from the URL; use `optional: false` only when every locale, including the default, must be prefixed.
-- The application owns routes, locale resolution, links, HTML language/direction, and per-page SEO overrides. Fimo supplies the site-wide SEO defaults (title, description, favicon, share image) from `.fimo/config.json#seo` through the root layout's `generateMetadata`/`generateViewport` (`buildFimoMetadata`/`buildFimoViewport` from `fimo-next`); keep that wiring, and add page-level `metadata`/`generateMetadata` exports where a page needs its own values — they merge over the defaults.
+- The application owns SEO policy. Keep the root's global SEO wiring and the homepage's explicit route wiring. When creating or adding a page, load `fimo skills get fimo-code --ref frameworks/next/seo` and reuse the established route pattern. Resolve the real pathname and content in that route module; add route viewport wiring only for route-specific theme color. Preserve app-owned metadata and file-based images; Next replaces nested metadata objects rather than merging their fields.
 - Do not add a second deployment platform.
 - Never edit `.fimo/project.json`; it links this directory to the remote project.
 - Keep `.fimo/config.json#runtime` true to the code: framework, `dev`/`build`/`install` commands, output directory. Update it when you rename a package script, move the build output, or change framework; the reference is `fimo skills get fimo-code --ref frameworks/hosting`.

package/templates/nextjs/package.json

@@ -12,9 +12,9 @@
   },
   "dependencies": {
     "@tanstack/react-query": "^5.80.6",
-    "fimo": "2.3.2",
-    "fimo-next": "2.3.2",
-    "fimo-react": "2.3.2",
+    "fimo": "2.4.0-staging.2",
+    "fimo-next": "2.4.0-staging.2",
+    "fimo-react": "2.4.0-staging.2",
     "next": "^16.3.3",
     "react": "^19.2.7",
     "react-dom": "^19.2.7"

package/templates/nextjs/src/app/layout.tsx

@@ -1,12 +1,14 @@
-import { FimoProvider, buildFimoMetadata, buildFimoViewport } from 'fimo-next';
+import { FimoProvider } from 'fimo-next';
+import { toNextMetadata, toNextViewport } from 'fimo-next/seo';
+import { getFimoSeo } from 'fimo/seo/server';
 import type { ReactNode } from 'react';
 
 import { defaultLocale } from '../locales';
 
 import './globals.css';
 
-export const generateMetadata = () => buildFimoMetadata();
-export const generateViewport = () => buildFimoViewport();
+export const generateMetadata = () => toNextMetadata(getFimoSeo());
+export const generateViewport = () => toNextViewport(getFimoSeo());
 
 export default function RootLayout({ children }: Readonly<{ children: ReactNode }>) {
   return (

package/templates/nextjs/src/app/page.tsx

@@ -1,3 +1,9 @@
+import { toNextMetadata, toNextViewport } from 'fimo-next/seo';
+import { getFimoSeo } from 'fimo/seo/server';
+
+export const generateMetadata = () => toNextMetadata(getFimoSeo({ pathname: '/' }));
+export const generateViewport = () => toNextViewport(getFimoSeo({ pathname: '/' }));
+
 export default function HomePage() {
   return (
     <div className="starter">

package/templates/react-router/package.json

@@ -21,10 +21,10 @@
     "cn": "0.2.4",
     "date-fns": "^4.1.0",
     "embla-carousel-react": "^8.6.0",
-    "fimo": "2.3.2",
-    "fimo-react": "2.3.2",
-    "fimo-react-router": "2.3.2",
-    "fimo-vite": "2.3.2",
+    "fimo": "2.4.0-staging.2",
+    "fimo-react": "2.4.0-staging.2",
+    "fimo-react-router": "2.4.0-staging.2",
+    "fimo-vite": "2.4.0-staging.2",
     "input-otp": "^1.4.2",
     "isbot": "^5",
     "lucide-react": "^0.577.0",

package/templates/sveltekit/package.json

@@ -11,8 +11,8 @@
     "prepare": "svelte-kit sync"
   },
   "dependencies": {
-    "fimo": "2.3.2",
-    "fimo-sveltekit": "2.3.2"
+    "fimo": "2.4.0-staging.2",
+    "fimo-sveltekit": "2.4.0-staging.2"
   },
   "devDependencies": {
     "@sveltejs/kit": "^2.70.2",

package/templates/vite/package.json

@@ -11,10 +11,10 @@
   },
   "dependencies": {
     "@tanstack/react-query": "^5.80.6",
-    "fimo": "2.3.2",
-    "fimo-react": "2.3.2",
-    "fimo-react-router": "2.3.2",
-    "fimo-vite": "2.3.2",
+    "fimo": "2.4.0-staging.2",
+    "fimo-react": "2.4.0-staging.2",
+    "fimo-react-router": "2.4.0-staging.2",
+    "fimo-vite": "2.4.0-staging.2",
     "react": "^19.2.7",
     "react-dom": "^19.2.7",
     "react-router": "^8.3.0"