fimo 2.4.1 → 2.5.0-staging.2

package/assets/astro/components/Boolean.astro

@@ -1,4 +1,5 @@
 ---
+import { isFimoEditingMetadataEnabled, withoutFimoEditingMetadata } from 'fimo/preview';
 import { getFimoSource } from 'fimo/astro';
 
 interface Props {
@@ -11,4 +12,4 @@ const { value, as: Component = 'span', ...props } = Astro.props;
 const source = getFimoSource(value);
 ---
 
-{value != null && <Component {...props} data-fimo-source={source}>{String(value.valueOf())}</Component>}
+{value != null && <Component {...withoutFimoEditingMetadata(props)} data-fimo-source={isFimoEditingMetadataEnabled() ? source : undefined}>{String(value.valueOf())}</Component>}

package/assets/astro/components/Date.astro

@@ -1,4 +1,5 @@
 ---
+import { isFimoEditingMetadataEnabled, withoutFimoEditingMetadata } from 'fimo/preview';
 import { getFimoSource } from 'fimo/astro';
 
 interface Props {
@@ -20,4 +21,4 @@ const content = validDate?.toLocaleDateString(
 const source = getFimoSource(value);
 ---
 
-{validDate && <time {...props} datetime={dateTime} data-fimo-source={source}>{content}</time>}
+{validDate && <time {...withoutFimoEditingMetadata(props)} datetime={dateTime} data-fimo-source={isFimoEditingMetadataEnabled() ? source : undefined}>{content}</time>}

package/assets/astro/components/DateTime.astro

@@ -1,4 +1,5 @@
 ---
+import { isFimoEditingMetadataEnabled, withoutFimoEditingMetadata } from 'fimo/preview';
 import { getFimoSource } from 'fimo/astro';
 
 interface Props {
@@ -19,4 +20,4 @@ const content = validDate?.toLocaleString(locale, options ?? { dateStyle: 'mediu
 const source = getFimoSource(value);
 ---
 
-{validDate && <time {...props} datetime={dateTime} data-fimo-source={source}>{content}</time>}
+{validDate && <time {...withoutFimoEditingMetadata(props)} datetime={dateTime} data-fimo-source={isFimoEditingMetadataEnabled() ? source : undefined}>{content}</time>}

package/assets/astro/components/Image.astro

@@ -1,4 +1,5 @@
 ---
+import { isFimoEditingMetadataEnabled, withoutFimoEditingMetadata } from 'fimo/preview';
 import type { FimoMedia } from 'fimo/astro';
 import { getFimoSource } from 'fimo/astro';
 
@@ -65,7 +66,7 @@ const source = getFimoSource(value);
 {
   image && (
     <img
-      {...props}
+      {...withoutFimoEditingMetadata(props)}
       src={image.src}
       alt={image.alt}
       width={image.width}
@@ -73,7 +74,7 @@ const source = getFimoSource(value);
       sizes={image.sizes}
       srcset={image.srcSet}
       style={imageStyle}
-      data-fimo-source={source}
+      data-fimo-source={isFimoEditingMetadataEnabled() ? source : undefined}
     />
   )
 }

package/assets/astro/components/Json.astro

@@ -1,4 +1,5 @@
 ---
+import { isFimoEditingMetadataEnabled, withoutFimoEditingMetadata } from 'fimo/preview';
 import { getFimoSource } from 'fimo/astro';
 
 interface Props {
@@ -11,4 +12,4 @@ const { value, as: Component = 'span', ...props } = Astro.props;
 const source = getFimoSource(value);
 ---
 
-{value != null && <Component {...props} data-fimo-source={source}>{JSON.stringify(value)}</Component>}
+{value != null && <Component {...withoutFimoEditingMetadata(props)} data-fimo-source={isFimoEditingMetadataEnabled() ? source : undefined}>{JSON.stringify(value)}</Component>}

package/assets/astro/components/RichText.astro

@@ -1,4 +1,5 @@
 ---
+import { isFimoEditingMetadataEnabled, withoutFimoEditingMetadata } from 'fimo/preview';
 import type { FimoRichText } from 'fimo/astro';
 import { getFimoSource } from 'fimo/astro';
 
@@ -14,4 +15,4 @@ const source = getFimoSource(value);
 const html = renderRichTextHtml(value?.content);
 ---
 
-{value && <div {...props} data-fimo-source={source} data-fimo-richtext="" set:html={html} />}
+{value && <div {...withoutFimoEditingMetadata(props)} data-fimo-source={isFimoEditingMetadataEnabled() ? source : undefined} data-fimo-richtext={isFimoEditingMetadataEnabled() ? "" : undefined} set:html={html} />}

package/assets/astro/components/StaticImage.astro

@@ -1,4 +1,5 @@
 ---
+import { withoutFimoEditingMetadata } from 'fimo/preview';
 import {
   mergeAstroImageStyle,
   resolveImagePresentation,
@@ -55,7 +56,7 @@ const imageStyle = mergeAstroImageStyle(style, image.objectFit);
 ---
 
 <img
-  {...props}
+  {...withoutFimoEditingMetadata(props)}
   src={image.src}
   alt={image.alt}
   width={image.width}

package/assets/astro/components/Text.astro

@@ -1,4 +1,5 @@
 ---
+import { isFimoEditingMetadataEnabled, withoutFimoEditingMetadata } from 'fimo/preview';
 import { getFimoParts, getFimoSource } from 'fimo/astro';
 
 interface Props {
@@ -12,11 +13,11 @@ const parts = getFimoParts(value);
 const source = getFimoSource(value);
 ---
 
-<Component {...props} data-fimo-source={source}>
+<Component {...withoutFimoEditingMetadata(props)} data-fimo-source={isFimoEditingMetadataEnabled() ? source : undefined}>
   {
     parts && parts.length > 1
       ? parts.map((part) =>
-          part.source ? <span data-fimo-source={part.source}>{part.text}</span> : part.text
+          part.source ? <span data-fimo-source={isFimoEditingMetadataEnabled() ? part.source : undefined}>{part.text}</span> : part.text
         )
       : String(value ?? '')
   }

package/assets/astro/components/Video.astro

@@ -1,4 +1,5 @@
 ---
+import { isFimoEditingMetadataEnabled, withoutFimoEditingMetadata } from 'fimo/preview';
 import type { FimoMedia } from 'fimo/astro';
 import { getFimoSource } from 'fimo/astro';
 
@@ -33,7 +34,7 @@ const shouldPlayInline = playsinline ?? playsInline ?? true;
 {
   value && (
     <video
-      {...props}
+      {...withoutFimoEditingMetadata(props)}
       src={overrideSrc ?? value.url}
       width={value.width}
       height={value.height}
@@ -41,7 +42,7 @@ const shouldPlayInline = playsinline ?? playsInline ?? true;
       loop={loop}
       muted={muted}
       playsinline={shouldPlayInline}
-      data-fimo-source={source}
+      data-fimo-source={isFimoEditingMetadataEnabled() ? source : undefined}
     />
   )
 }

package/assets/skills/fimo-cli/references/analytics.md

@@ -4,11 +4,24 @@ Pageview aggregates for the **published** site are stored in Fimo's analytics pi
 
 Analytics has a **retained preview for every org** — free included. The free default is a 7-day retention window, so short ranges (`today`, `yesterday`, `this_week`, `last_week`, `last_7_days`) work for everyone. **Extended date ranges and longer retention are paid** — `last_30_days`, `last_90_days`, `this_month`, `last_month`, `last_quarter`, `last_year`, and `custom` require the `canUseExtendedDateRanges` privilege, which only paid orgs have. Asking for an extended range as a free user returns a 403 with an upgrade hint.
 
+## Bot traffic is excluded
+
+Every number below is **humans only**. Bot hits — AI crawlers and headless browsers — are tagged
+at ingest and left out of visitors, pageviews, bounce rate, visit duration, the series and every
+breakdown. This is not a filter the caller opts into; it is what the numbers mean.
+
+The response says what it dropped, so you can answer "am I being crawled" without a second call:
+`botPageviews` and `botVisitors` always describe the whole window.
+
+`--device bot` goes and looks at that traffic. It fills `topBots`, which names the crawler
+(GPTBot, ClaudeBot, Googlebot, …). Expect a bounce rate near 100% and a visit duration of 0 —
+that is what a crawler looks like, not a bug.
+
 ## CLI commands
 
 ```bash
-fimo analytics pageviews [--preset <p>] [--days 7|30|90] [--from YYYY-MM-DD] [--to YYYY-MM-DD] [--group-by day|week|month|quarter]
-fimo analytics top <dimension> [--limit N] [--preset|--days|--from/--to]
+fimo analytics pageviews [--preset <p>] [--days 7|30|90] [--from YYYY-MM-DD] [--to YYYY-MM-DD] [--group-by day|week|month|quarter] [--device bot|desktop|mobile|tablet]
+fimo analytics top <dimension> [--limit N] [--preset|--days|--from/--to] [--device ...]
 fimo analytics annotations list [--preset|--days|--from/--to]
 fimo analytics annotations set <YYYY-MM-DD> "<content>"
 fimo analytics annotations delete <YYYY-MM-DD>
@@ -25,17 +38,30 @@ The headline command returns everything in one payload — KPIs, the visitors se
 ```json
 {
   "range": { "preset": "last_30_days", "effectiveFrom": "...", "effectiveTo": "...", "groupBy": "day", ... },
+  "deviceFilter": null,
   "visitors": 1240, "pageviews": 3870, "bounceRate": 42.5, "viewsPerVisit": 3.12, "averageVisitDurationSeconds": 95.4,
+  "botPageviews": 18940, "botVisitors": 18902,
   "visitorsSeries": [{ "date": "2026-04-26", "visitors": 38 }, ...],
   "topPages":     [{ "path": "/", "pageName": "Home", "visitors": 612, "pageviews": 980 }, ...],
   "topBrowsers":  [{ "key": "Chrome", "visitors": 720, "pageviews": 2110 }, ...],
   "topDevices":   [...],
+  "topBots":      [],
+  "topAiAssistants": [{ "key": "ChatGPT", "visitors": 118, "pageviews": 442 }, ...],
   "topCountries": [...],
   "topSources":   [...],
   "annotations":  [{ "date": "2026-05-20", "content": "Launched", "updatedAt": "...", "updatedByUserId": "..." }]
 }
 ```
 
+`topBots` is empty unless `--device bot` is set — it belongs to that view.
+
+`topAiAssistants` is who sent you readers: a person who follows a citation inside ChatGPT,
+Perplexity or Claude arrives with that assistant as the referrer. Two honest limits worth
+repeating to a user: arrivals from an assistant's desktop or phone app usually carry no referrer
+and land in `Direct`, so the number is a floor; and being cited without being clicked is
+invisible. No assistant passes the user's question, so "which assistants send readers" is
+answerable and "what they asked" is not.
+
 `fimo analytics top <dimension>` is a convenience wrapper — it makes the same call and returns just the corresponding `top*` array, optionally truncated by `--limit`.
 
 `fimo analytics annotations list` similarly filters to just the `annotations` array.
@@ -58,5 +84,9 @@ A natural usage pattern: after `fimo deploy --publish` for a notable change, set
 - "Show me my analytics" / "how is my site performing" / "traffic since last week" → `fimo analytics pageviews --days 7`.
 - "What countries are my visitors from?" → `fimo analytics top countries`.
 - "Mark today as launch day on the chart" → `fimo analytics annotations set <today> "Launch"`.
+- "Am I being crawled / is AI scraping my site?" → `fimo analytics pageviews --device bot --days 30`.
+- "Is ChatGPT sending me traffic?" → `fimo analytics pageviews --days 30`, then read `topAiAssistants`.
+- "My visitor count dropped" → check whether they are comparing against a pre-exclusion number;
+  `botPageviews` says how much of the old figure was never a person.
 
 For free-tier users who hit the extended-range gate, either stick to `last_7_days` / `last_week` / shorter, or link them to upgrade for full retention and extended ranges.

package/assets/skills/fimo-studio/references/cms.md

@@ -79,6 +79,8 @@ Changes save automatically as you fill in each field (the save is debounced), so
 
 Your edits save automatically as you change each field (the save is debounced), so there is no Save button. Watch the top bar for the save status (Saving / Saved). The entry editor header lets you move to the previous or next entry, delete the current entry, or copy its link.
 
+For a saved localized Collection entry, use the language selector in the entry header to change that entry's language without closing it. The Collection list keeps its own language and rows. If the entry has no translation in the chosen language, the editor stays open and reports that no entry was found. Singles and new entries continue to use the route language because they do not have a saved entry variant to keep open.
+
 Press **Alt+J** to move to the next entry or **Alt+K** to move to the previous one (**Option+J** and **Option+K** on macOS). These shortcuts also work while your cursor is inside a rich-text field, and pending changes save before Fimo moves.
 
 If a field is invalid, the editor keeps the change unsaved and pins a status bar below the header. Choose **Review issues** to jump to the first invalid field, then **Next issue** to move through the remaining fields. Collapsed blocks open automatically. Once every issue is fixed, the editor confirms that all fields are valid and resumes saving.

package/dist/build/vite/plugins/runtime-env.js

@@ -1,3 +1,4 @@
+import { resolveFimoEditingMetadata } from '../../../runtime/preview/editing-metadata.js';
 import { findStaleFimoOverride, resolveLocalRuntimeEnv, staleOverrideMessage, } from '../../../runtime/shared/local-runtime-env.js';
 /**
  * Point the app at the Fimo env of the current git branch.
@@ -19,6 +20,8 @@ import { findStaleFimoOverride, resolveLocalRuntimeEnv, staleOverrideMessage, }
  *   authoritative.
  */
 export default function runtimeEnvPlugin() {
+    // External SSR dependencies bypass Vite's define replacements.
+    const ssr = { noExternal: ['fimo', 'fimo-react', 'fimo-sveltekit'] };
     return {
         name: 'fimo:runtime-env',
         enforce: 'pre',
@@ -35,15 +38,20 @@ export default function runtimeEnvPlugin() {
             async handler(config, { command, mode }) {
                 const cwd = config.root ?? process.cwd();
                 const derived = resolveLocalRuntimeEnv({ cwd });
-                if (!derived) {
-                    return;
-                }
                 // Keep the public neutral entry importable without installing Vite.
                 // The consuming framework always provides Vite when it invokes the
                 // plugin, but `import('fimo/vite/runtime-env')` is also a valid package
                 // boundary probe for projects that only install the core runtime.
                 const { loadEnv } = await import('vite');
                 const explicit = { ...loadEnv(mode, config.envDir ?? cwd, ''), ...process.env };
+                const define = {
+                    'process.env.FIMO_EDITING_METADATA': JSON.stringify(String(resolveFimoEditingMetadata(command === 'serve' && mode !== 'production' && explicit.NODE_ENV !== 'production'
+                        ? 'development'
+                        : 'production', explicit.FIMO_EDITING_METADATA))),
+                };
+                if (!derived) {
+                    return { define, ssr };
+                }
                 if (command === 'serve') {
                     const stale = findStaleFimoOverride(explicit, derived);
                     if (stale) {
@@ -68,8 +76,8 @@ export default function runtimeEnvPlugin() {
                 // is how Astro's server runtime reads `FIMO_CONTENT_API_URL`. A curated
                 // list silently misses whichever framework reads a key that is not on it.
                 // Every value here is a public tenant URL or an env name; none is secret.
-                const define = Object.fromEntries(missing.map(([key, value]) => [`import.meta.env.${key}`, JSON.stringify(value)]));
-                return Object.keys(define).length > 0 ? { define } : undefined;
+                Object.assign(define, Object.fromEntries(missing.map(([key, value]) => [`import.meta.env.${key}`, JSON.stringify(value)])));
+                return { define, ssr };
             },
         },
     };

package/dist/cli/bundle.json

@@ -1,7 +1,7 @@
 {
   "bundled": true,
   "bundler": "esbuild",
-  "bundledAt": "2026-09-08T08:30:04.792Z",
+  "bundledAt": "2026-09-08T11:12:03.529Z",
   "cliVersion": "2.4.1",
   "external": [
     "oxc-parser",