fimo 0.8.0 → 0.9.0-experimental.10

package/dist/runtime/primitives/lib/useFimoLiveValue.d.ts

@@ -9,9 +9,11 @@ import { type RefObject } from 'react';
  * preview knows to dispatch events instead of falling back to raw DOM writes,
  * and updates internal state when a mutation arrives.
  *
- * In prod (published app): Vite statically inlines `import.meta.env.DEV`, so
- * `useFimoLiveValueProd` is the only implementation linked and the listener
- * machinery is dead-code-eliminated.
+ * In prod (published app): only `useFimoLiveValueProd` is linked. The dev
+ * check must work under any bundler (Vite, webpack, Turbopack) and plain
+ * Node SSR: `import.meta.env.DEV` only exists under Vite, and
+ * `process.env.NODE_ENV` is statically replaced by Next/webpack — checking
+ * both keeps the hook correct across adapters.
  */
 declare function useFimoLiveValueDev<T, E extends HTMLElement = HTMLElement>(external: T): {
     value: T;

package/dist/runtime/primitives/lib/useFimoLiveValue.js

@@ -10,9 +10,11 @@ import { useEffect, useRef, useState } from 'react';
  * preview knows to dispatch events instead of falling back to raw DOM writes,
  * and updates internal state when a mutation arrives.
  *
- * In prod (published app): Vite statically inlines `import.meta.env.DEV`, so
- * `useFimoLiveValueProd` is the only implementation linked and the listener
- * machinery is dead-code-eliminated.
+ * In prod (published app): only `useFimoLiveValueProd` is linked. The dev
+ * check must work under any bundler (Vite, webpack, Turbopack) and plain
+ * Node SSR: `import.meta.env.DEV` only exists under Vite, and
+ * `process.env.NODE_ENV` is statically replaced by Next/webpack — checking
+ * both keeps the hook correct across adapters.
  */
 function useFimoLiveValueDev(external) {
     const ref = useRef(null);
@@ -46,4 +48,9 @@ function useFimoLiveValueProd(external) {
     const ref = useRef(null);
     return { value: external, ref };
 }
-export const useFimoLiveValue = (import.meta.env.DEV ? useFimoLiveValueDev : useFimoLiveValueProd);
+// globalThis lookup, not a bare `process` reference: this file is part of the
+// browser-facing runtime surface, which must typecheck without node types
+// (the generated-types gate enforces it).
+const isDevRuntime = import.meta.env?.DEV === true ||
+    globalThis.process?.env?.NODE_ENV === 'development';
+export const useFimoLiveValue = (isDevRuntime ? useFimoLiveValueDev : useFimoLiveValueProd);

package/dist/runtime/primitives/translations.d.ts

@@ -1,28 +1,2 @@
-import { FimoString } from './lib/index.js';
-/**
- * Hook to provide a label function (`t`).
- *
- * Returns FimoString with source tracking for inline editing.
- * Use with <Text> component for rendering, or String() for escape hatch.
- *
- * @example
- * const { t } = useLabels();
- *
- * // With Text component (recommended)
- * <Text value={t('welcome')} />
- *
- * // Escape hatch for attributes
- * <input placeholder={String(t('email.placeholder'))} />
- */
-export declare function useLabels(): {
-    t: (fullKey: string) => FimoString;
-    locale: string;
-};
-/**
- * Legacy alias for older projects. Prefer useLabels() in new code.
- */
-export declare function useTranslations(): {
-    t: (fullKey: string) => FimoString;
-    locale: string;
-};
+export { useLabels, useTranslations } from './labels-hook.js';
 //# sourceMappingURL=translations.d.ts.map

package/dist/runtime/primitives/translations.js

@@ -1,61 +1,14 @@
-import { useSyncExternalStore } from 'react';
+// Vite flavor of the label layer: hydrates the framework-neutral store from
+// the `virtual:translations` module (fimo/vite labels plugin) and wires HMR.
+// Framework-agnostic consumers use ./labels-store.ts + ./labels-hook.ts.
 import { defaultLocale as bundledDefaultLocale, dictionaries as bundledDictionaries, signature as translationSignature, updatedAt as bundledUpdatedAt, } from 'virtual:translations';
-import { useLocale } from '../i18n/FimoLocaleContext.js';
-import { FimoString } from './lib/index.js';
-const labelListeners = new Set();
-let labelState = {
+import { applyLabelUpdate, hydrateLabels } from './labels-store.js';
+hydrateLabels({
     dictionaries: bundledDictionaries ?? {},
     defaultLocale: bundledDefaultLocale || 'en',
     signature: translationSignature,
     updatedAt: bundledUpdatedAt ?? null,
-};
-function subscribeLabels(listener) {
-    labelListeners.add(listener);
-    return () => {
-        labelListeners.delete(listener);
-    };
-}
-function getLabelSnapshot() {
-    return labelState;
-}
-function setLabelState(next) {
-    if (next.signature === labelState.signature) {
-        return;
-    }
-    labelState = next;
-    for (const listener of labelListeners) {
-        listener();
-    }
-}
-function isRecord(value) {
-    return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
-}
-function normalizeDictionaries(value) {
-    if (!isRecord(value)) {
-        return null;
-    }
-    const dictionaries = {};
-    for (const [locale, labels] of Object.entries(value)) {
-        if (!isRecord(labels)) {
-            continue;
-        }
-        dictionaries[locale] = Object.fromEntries(Object.entries(labels).filter((entry) => typeof entry[1] === 'string'));
-    }
-    return dictionaries;
-}
-function applyLabelUpdate(payload) {
-    if (!isRecord(payload)) {
-        return;
-    }
-    const dictionaries = normalizeDictionaries(payload.dictionaries);
-    if (!dictionaries) {
-        return;
-    }
-    const defaultLocale = typeof payload.defaultLocale === 'string' ? payload.defaultLocale : labelState.defaultLocale;
-    const signature = typeof payload.signature === 'string' ? payload.signature : JSON.stringify({ dictionaries, defaultLocale });
-    const updatedAt = typeof payload.updatedAt === 'string' ? payload.updatedAt : null;
-    setLabelState({ dictionaries, defaultLocale, signature, updatedAt });
-}
+});
 // @ts-ignore - import.meta.hot is provided by Vite during development.
 if (import.meta.hot) {
     const onLabelsUpdated = (payload) => {
@@ -69,35 +22,4 @@ if (import.meta.hot) {
         import.meta.hot.off('fimo:labels-updated', onLabelsUpdated);
     });
 }
-/**
- * Hook to provide a label function (`t`).
- *
- * Returns FimoString with source tracking for inline editing.
- * Use with <Text> component for rendering, or String() for escape hatch.
- *
- * @example
- * const { t } = useLabels();
- *
- * // With Text component (recommended)
- * <Text value={t('welcome')} />
- *
- * // Escape hatch for attributes
- * <input placeholder={String(t('email.placeholder'))} />
- */
-export function useLabels() {
-    const localeContext = useLocale();
-    const labels = useSyncExternalStore(subscribeLabels, getLabelSnapshot, getLabelSnapshot);
-    const t = (fullKey) => {
-        const locale = localeContext.locale || labels.defaultLocale || 'en';
-        const dictionary = labels.dictionaries[locale] ?? labels.dictionaries[labels.defaultLocale] ?? {};
-        const text = dictionary[fullKey] ?? '';
-        return new FimoString(text, `__labels.${locale}.${fullKey}.value`);
-    };
-    return { t, locale: localeContext.locale };
-}
-/**
- * Legacy alias for older projects. Prefer useLabels() in new code.
- */
-export function useTranslations() {
-    return useLabels();
-}
+export { useLabels, useTranslations } from './labels-hook.js';

package/dist/runtime/react/FimoSpaProviders.d.ts

@@ -0,0 +1,36 @@
+import React from 'react';
+import type { FimoConfig } from '../shared/fimo-config.types.js';
+import type { WrappedMediaEntry, WrappedRichTextEntry } from '../wrapped/WrappedContentContext.js';
+export interface FimoSpaProvidersProps {
+    /** The project's fimo-config.json — import it directly: `import config from '../fimo-config.json'`. */
+    config: FimoConfig;
+    /** Tenant API base URL, e.g. `import.meta.env.VITE_API_URL`. Without it, wrapped values render their inline fallbacks. */
+    apiUrl?: string;
+    /** Preview client script for Fimo Studio edit mode. Pass only in dev, e.g. `import.meta.env.DEV ? import.meta.env.VITE_FIMO_PREVIEW_SCRIPT_URL : undefined`. */
+    previewScriptUrl?: string;
+    media?: Record<string, WrappedMediaEntry>;
+    richText?: Record<string, WrappedRichTextEntry>;
+    locale?: string;
+    children?: React.ReactNode;
+}
+/**
+ * Fimo providers for wrapped CLIENT-RENDERED React apps (Vite SPAs). There is
+ * no server pass to load labels in, so this adapter fetches the dictionary in
+ * the browser and hydrates the framework-neutral WrappedProviders; until the
+ * fetch resolves (or when it fails), every wrapped value renders its inline
+ * fallback — the original hardcoded string. Mount once around the app root:
+ *
+ *   import config from '../fimo-config.json';
+ *   <FimoSpaProviders
+ *     config={config}
+ *     apiUrl={import.meta.env.VITE_API_URL}
+ *     previewScriptUrl={import.meta.env.DEV ? import.meta.env.VITE_FIMO_PREVIEW_SCRIPT_URL : undefined}
+ *   >
+ *     <App />
+ *   </FimoSpaProviders>
+ *
+ * Navigation is History-API based (full page load): correct for any SPA
+ * router without depending on one.
+ */
+export declare function FimoSpaProviders({ config, apiUrl, previewScriptUrl, media, richText, locale, children, }: FimoSpaProvidersProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=FimoSpaProviders.d.ts.map

package/dist/runtime/react/FimoSpaProviders.js

@@ -0,0 +1,122 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useMemo, useRef, useState } from 'react';
+import { getFimoDefaultLocale, getFimoLocales } from '../i18n/locale.js';
+import { fetchLabelBundle } from '../shared/labels-fetch.pure.js';
+import { fetchWrappedContent } from '../wrapped/content-fetch.pure.js';
+import { WrappedProviders } from '../wrapped/WrappedProviders.js';
+import { readInitialSpaContent, spaBundleSignature, writeSpaContentCache } from './spa-content-cache.js';
+/**
+ * Fimo providers for wrapped CLIENT-RENDERED React apps (Vite SPAs). There is
+ * no server pass to load labels in, so this adapter fetches the dictionary in
+ * the browser and hydrates the framework-neutral WrappedProviders; until the
+ * fetch resolves (or when it fails), every wrapped value renders its inline
+ * fallback — the original hardcoded string. Mount once around the app root:
+ *
+ *   import config from '../fimo-config.json';
+ *   <FimoSpaProviders
+ *     config={config}
+ *     apiUrl={import.meta.env.VITE_API_URL}
+ *     previewScriptUrl={import.meta.env.DEV ? import.meta.env.VITE_FIMO_PREVIEW_SCRIPT_URL : undefined}
+ *   >
+ *     <App />
+ *   </FimoSpaProviders>
+ *
+ * Navigation is History-API based (full page load): correct for any SPA
+ * router without depending on one.
+ */
+export function FimoSpaProviders({ config, apiUrl, previewScriptUrl, media, richText, locale, children, }) {
+    // Synchronous first paint: baked SSG payload or the last visit's cached
+    // one renders IMMEDIATELY (the SDK owns rendering — no fallback flash
+    // while the network round-trips); the fetches below revalidate it.
+    const initial = useMemo(() => readInitialSpaContent(apiUrl), [apiUrl]);
+    const [labels, setLabels] = useState(initial?.labels ?? undefined);
+    const [content, setContent] = useState(initial?.content ?? undefined);
+    const latestRef = useRef({
+        labels: initial?.labels ?? undefined,
+        content: initial?.content ?? undefined,
+    });
+    useEffect(() => {
+        if (!apiUrl) {
+            return;
+        }
+        let disposed = false;
+        const persist = () => {
+            writeSpaContentCache(apiUrl, { labels: latestRef.current.labels, content: latestRef.current.content });
+        };
+        const revalidate = () => {
+            const defaultLocale = getFimoDefaultLocale(config);
+            fetchLabelBundle(apiUrl, getFimoLocales(config), defaultLocale)
+                .then((bundle) => {
+                if (!disposed) {
+                    const next = { ...bundle, signature: spaBundleSignature(bundle) };
+                    latestRef.current.labels = next;
+                    setLabels(next);
+                    persist();
+                }
+            })
+                .catch(() => {
+                // Unreachable API: keep rendering the cached/baked values or fallbacks.
+            });
+            // Wrapped rich text and media live in the plumbing types — without this
+            // fetch a client-rendered app only ever shows their inline fallbacks
+            // and Studio edits to them render nowhere.
+            fetchWrappedContent(apiUrl)
+                .then((fetched) => {
+                if (!disposed) {
+                    latestRef.current.content = fetched;
+                    setContent(fetched);
+                    persist();
+                }
+            })
+                .catch(() => {
+                // Unreachable API: keep rendering the cached/baked values or fallbacks.
+            });
+        };
+        revalidate();
+        // Live updates, no refresh needed:
+        // 1. Inside the Fimo Studio preview, every save posts
+        //    `{ type: 'content/refresh' }` into the iframe — refetch on the spot
+        //    (same contract the template runtime's RefreshContentProvider uses).
+        // 2. In a plain tab, coming back to the site (alt-tab from the Studio)
+        //    revalidates on focus/visibility — edits appear without a reload.
+        let lastRun = Date.now();
+        const throttledRevalidate = () => {
+            if (Date.now() - lastRun < 1500) {
+                return;
+            }
+            lastRun = Date.now();
+            revalidate();
+        };
+        const onMessage = (event) => {
+            if (event.data?.type === 'content/refresh') {
+                lastRun = Date.now();
+                revalidate();
+            }
+        };
+        const onVisibility = () => {
+            if (document.visibilityState === 'visible') {
+                throttledRevalidate();
+            }
+        };
+        window.addEventListener('message', onMessage);
+        window.addEventListener('focus', throttledRevalidate);
+        document.addEventListener('visibilitychange', onVisibility);
+        return () => {
+            disposed = true;
+            window.removeEventListener('message', onMessage);
+            window.removeEventListener('focus', throttledRevalidate);
+            document.removeEventListener('visibilitychange', onVisibility);
+        };
+    }, [apiUrl, config]);
+    // Explicitly-passed maps win over the fetched ones (caller override).
+    const mergedMedia = useMemo(() => (content?.media || media ? { ...(content?.media ?? {}), ...(media ?? {}) } : undefined), [content?.media, media]);
+    const mergedRichText = useMemo(() => (content?.richText || richText ? { ...(content?.richText ?? {}), ...(richText ?? {}) } : undefined), [content?.richText, richText]);
+    const navigation = useMemo(() => ({
+        pathname: typeof window !== 'undefined' ? window.location.pathname : null,
+        navigate: (to) => {
+            window.location.assign(to);
+        },
+    }), []);
+    return (_jsxs(WrappedProviders, { config: config, labels: labels, media: mergedMedia, richText: mergedRichText, locale: locale, navigation: navigation, children: [previewScriptUrl ? _jsx("script", { type: "module", src: previewScriptUrl }) : null, children] }));
+}

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

@@ -0,0 +1,35 @@
+export { Text } from '../primitives/components/Text.js';
+export { Image } from '../primitives/components/Image.js';
+export { StaticImage } from '../primitives/components/StaticImage.js';
+export { Video } from '../primitives/components/Video.js';
+export { Date } from '../primitives/components/Date.js';
+export { Boolean } from '../primitives/components/Boolean.js';
+export { RichText } from '../primitives/components/RichText.js';
+export { useLabels, useTranslations } from '../primitives/labels-hook.js';
+export { applyLabelUpdate, getLabelSnapshot, hydrateLabels, subscribeLabels } from '../primitives/labels-store.js';
+export type { LabelState } from '../primitives/labels-store.js';
+export { FimoText } from '../wrapped/FimoText.js';
+export { FimoRichTextBlock } from '../wrapped/FimoRichTextBlock.js';
+export { FimoMediaImage } from '../wrapped/FimoMediaImage.js';
+export { FimoMediaVideo } from '../wrapped/FimoMediaVideo.js';
+export { FimoFileLink } from '../wrapped/FimoFileLink.js';
+export { useWrappedMedia, useWrappedRichText } from '../wrapped/WrappedContentContext.js';
+export type { WrappedMediaEntry, WrappedRichTextEntry } from '../wrapped/WrappedContentContext.js';
+export { FimoSpaProviders } from './FimoSpaProviders.js';
+export type { FimoSpaProvidersProps } from './FimoSpaProviders.js';
+export { FimoString, FimoDate, FimoMedia, FimoBoolean, FimoRichText, type FimoSource, type FimoPart, type FimoRichTextContent, type FimoRichTextNodeProps, type FimoRichTextMarkProps, type FimoRichTextComponents, FIMO_SOURCE, FIMO_PARTS, isFimoString, isFimoDate, hasFimoSource, getFimoSource, getFimoParts, } from '../primitives/lib/index.js';
+export { fimo } from '../primitives/lib/template.js';
+export { useFimoLiveValue } from '../primitives/lib/useFimoLiveValue.js';
+export { DataSourcesProvider } from '../content/DataSourcesProvider.js';
+export { ConsoleErrorProvider } from '../iframe/ConsoleErrorProvider.js';
+export { ScreenshotProvider } from '../iframe/ScreenshotProvider.js';
+export { FimoLocaleProvider, useLocale } from '../i18n/FimoLocaleContext.js';
+export type { FimoLocaleContextValue } from '../i18n/FimoLocaleContext.js';
+export { getFimoDefaultLocale, getFimoLocales, getFimoTextDirection, localizeFimoPath, resolveFimoLocale, toHtmlLang, } from '../i18n/locale.js';
+export type { FimoLocaleResolution } from '../i18n/locale.js';
+export { getDisplayRoutes } from '../shared/display-routes.js';
+export type { DisplayRoute, ParamInfo } from '../shared/display-routes.js';
+export type { FimoConfig, FimoRouteConfig, FimoSEO } from '../shared/fimo-config.types.js';
+export { fetchFimoSpaContent, serializeFimoSpaContent } from './spa-content-cache.js';
+export type { SpaContentPayload } from './spa-content-cache.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/react/index.js

@@ -0,0 +1,40 @@
+// fimo/react — the framework-agnostic React core of the Fimo runtime.
+// No Vite virtual modules, no react-router, no bundler assumptions:
+// per-framework adapters (fimo/react-router via fimo/ui, fimo/next, ...)
+// build on this surface.
+// Inline-editing components
+export { Text } from '../primitives/components/Text.js';
+export { Image } from '../primitives/components/Image.js';
+export { StaticImage } from '../primitives/components/StaticImage.js';
+export { Video } from '../primitives/components/Video.js';
+export { Date } from '../primitives/components/Date.js';
+export { Boolean } from '../primitives/components/Boolean.js';
+export { RichText } from '../primitives/components/RichText.js';
+// Labels (framework-neutral store + hook; adapters hydrate the store)
+export { useLabels, useTranslations } from '../primitives/labels-hook.js';
+export { applyLabelUpdate, getLabelSnapshot, hydrateLabels, subscribeLabels } from '../primitives/labels-store.js';
+// Wrapped-site primitives (the --apply codemod imports these from fimo/react
+// in Vite React SPAs) + the client-side providers that hydrate them. All are
+// fallback-safe without a provider: FimoText renders its children, media
+// elements render their original src.
+export { FimoText } from '../wrapped/FimoText.js';
+export { FimoRichTextBlock } from '../wrapped/FimoRichTextBlock.js';
+export { FimoMediaImage } from '../wrapped/FimoMediaImage.js';
+export { FimoMediaVideo } from '../wrapped/FimoMediaVideo.js';
+export { FimoFileLink } from '../wrapped/FimoFileLink.js';
+export { useWrappedMedia, useWrappedRichText } from '../wrapped/WrappedContentContext.js';
+export { FimoSpaProviders } from './FimoSpaProviders.js';
+// Source-tracking primitives & utilities
+export { FimoString, FimoDate, FimoMedia, FimoBoolean, FimoRichText, FIMO_SOURCE, FIMO_PARTS, isFimoString, isFimoDate, hasFimoSource, getFimoSource, getFimoParts, } from '../primitives/lib/index.js';
+export { fimo } from '../primitives/lib/template.js';
+export { useFimoLiveValue } from '../primitives/lib/useFimoLiveValue.js';
+// Preview/editor bridge providers (postMessage-based, framework-free)
+export { DataSourcesProvider } from '../content/DataSourcesProvider.js';
+export { ConsoleErrorProvider } from '../iframe/ConsoleErrorProvider.js';
+export { ScreenshotProvider } from '../iframe/ScreenshotProvider.js';
+// Locale
+export { FimoLocaleProvider, useLocale } from '../i18n/FimoLocaleContext.js';
+export { getFimoDefaultLocale, getFimoLocales, getFimoTextDirection, localizeFimoPath, resolveFimoLocale, toHtmlLang, } from '../i18n/locale.js';
+// Config + routes
+export { getDisplayRoutes } from '../shared/display-routes.js';
+export { fetchFimoSpaContent, serializeFimoSpaContent } from './spa-content-cache.js';

package/dist/runtime/react/spa-content-cache.d.ts

@@ -0,0 +1,38 @@
+import type { FimoConfig } from '../shared/fimo-config.types.js';
+import { type LabelBundle } from '../shared/labels-fetch.pure.js';
+import { type WrappedContent } from '../wrapped/content-fetch.pure.js';
+import type { WrappedLabels } from '../wrapped/WrappedProviders.js';
+/**
+ * Instant first paint for client-rendered wrapped apps: the SDK controls
+ * rendering, so it never has to flash fallbacks while the network round
+ * trips. Two synchronous sources, in priority order:
+ *
+ * 1. `window.__FIMO_CONTENT__` — baked by the site's SSG/prerender step
+ *    (`serializeFimoSpaContent`), zero flash even on the first ever visit;
+ * 2. the last fetched payload cached in localStorage — instant from the
+ *    second visit on, revalidated in the background (stale-while-revalidate).
+ */
+export interface SpaContentPayload {
+    labels?: WrappedLabels;
+    content?: WrappedContent;
+}
+declare global {
+    interface Window {
+        __FIMO_CONTENT__?: SpaContentPayload;
+    }
+}
+export declare function readInitialSpaContent(apiUrl: string | undefined): SpaContentPayload | null;
+export declare function writeSpaContentCache(apiUrl: string, payload: SpaContentPayload): void;
+/** Browser-safe stable signature (labelSignature uses Buffer, server-only). */
+export declare function spaBundleSignature(bundle: LabelBundle): string;
+/**
+ * Build-time half of the bake: fetch the exact payload the provider's
+ * background revalidation produces (labels with the same signature shape,
+ * wrapped rich text + media), ready for `serializeFimoSpaContent`. Runs
+ * anywhere `fetch` exists — an SSG/prerender node script included.
+ */
+export declare function fetchFimoSpaContent(apiUrl: string, config: FimoConfig): Promise<SpaContentPayload>;
+/** SSG helper: a script tag baking the payload into prerendered HTML so the
+ *  provider hydrates it synchronously — zero content flash. */
+export declare function serializeFimoSpaContent(payload: SpaContentPayload): string;
+//# sourceMappingURL=spa-content-cache.d.ts.map

package/dist/runtime/react/spa-content-cache.js

@@ -0,0 +1,64 @@
+import { getFimoDefaultLocale, getFimoLocales } from '../i18n/locale.js';
+import { fetchLabelBundle, serializeBundle } from '../shared/labels-fetch.pure.js';
+import { fetchWrappedContent } from '../wrapped/content-fetch.pure.js';
+const CACHE_PREFIX = 'fimo:spa-content:';
+export function readInitialSpaContent(apiUrl) {
+    if (typeof window === 'undefined') {
+        return null;
+    }
+    if (window.__FIMO_CONTENT__ && typeof window.__FIMO_CONTENT__ === 'object') {
+        return window.__FIMO_CONTENT__;
+    }
+    if (!apiUrl) {
+        return null;
+    }
+    try {
+        const raw = window.localStorage.getItem(CACHE_PREFIX + apiUrl);
+        return raw ? JSON.parse(raw) : null;
+    }
+    catch {
+        return null;
+    }
+}
+export function writeSpaContentCache(apiUrl, payload) {
+    if (typeof window === 'undefined') {
+        return;
+    }
+    try {
+        window.localStorage.setItem(CACHE_PREFIX + apiUrl, JSON.stringify(payload));
+    }
+    catch {
+        // Quota/private mode: the cache is an optimization, never a requirement.
+    }
+}
+/** Browser-safe stable signature (labelSignature uses Buffer, server-only). */
+export function spaBundleSignature(bundle) {
+    const serialized = serializeBundle(bundle);
+    let hash = 5381;
+    for (let i = 0; i < serialized.length; i++) {
+        hash = ((hash << 5) + hash + serialized.charCodeAt(i)) | 0;
+    }
+    return `spa-${hash}`;
+}
+/**
+ * Build-time half of the bake: fetch the exact payload the provider's
+ * background revalidation produces (labels with the same signature shape,
+ * wrapped rich text + media), ready for `serializeFimoSpaContent`. Runs
+ * anywhere `fetch` exists — an SSG/prerender node script included.
+ */
+export async function fetchFimoSpaContent(apiUrl, config) {
+    const [labels, content] = await Promise.all([
+        fetchLabelBundle(apiUrl, getFimoLocales(config), getFimoDefaultLocale(config)).then((bundle) => ({
+            ...bundle,
+            signature: spaBundleSignature(bundle),
+        })),
+        fetchWrappedContent(apiUrl),
+    ]);
+    return { labels, content };
+}
+/** SSG helper: a script tag baking the payload into prerendered HTML so the
+ *  provider hydrates it synchronously — zero content flash. */
+export function serializeFimoSpaContent(payload) {
+    const json = JSON.stringify(payload).replace(/</g, '\\u003c');
+    return `<script>window.__FIMO_CONTENT__=${json}</script>`;
+}

package/dist/runtime/remix/FimoRemixProviders.d.ts

@@ -0,0 +1,16 @@
+import React from 'react';
+import type { FimoConfig } from '../shared/fimo-config.types.js';
+import type { WrappedMediaEntry, WrappedRichTextEntry } from '../wrapped/WrappedContentContext.js';
+import { type WrappedLabels } from '../wrapped/WrappedProviders.js';
+export type FimoRemixLabels = WrappedLabels;
+export interface FimoRemixProvidersProps {
+    config: FimoConfig;
+    labels?: FimoRemixLabels;
+    media?: Record<string, WrappedMediaEntry>;
+    richText?: Record<string, WrappedRichTextEntry>;
+    locale?: string;
+    children?: React.ReactNode;
+}
+/** Fimo providers for wrapped Remix apps — mount once in app/root.tsx. */
+export declare function FimoRemixProviders(props: FimoRemixProvidersProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=FimoRemixProviders.d.ts.map

package/dist/runtime/remix/FimoRemixProviders.js

@@ -0,0 +1,12 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useLocation, useNavigate } from '@remix-run/react';
+import { useMemo } from 'react';
+import { WrappedProviders } from '../wrapped/WrappedProviders.js';
+/** Fimo providers for wrapped Remix apps — mount once in app/root.tsx. */
+export function FimoRemixProviders(props) {
+    const location = useLocation();
+    const navigate = useNavigate();
+    const navigation = useMemo(() => ({ pathname: location.pathname, navigate: (to) => navigate(to) }), [location.pathname, navigate]);
+    return _jsx(WrappedProviders, { ...props, navigation: navigation });
+}

package/dist/runtime/remix/FimoRemixScripts.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Renders the Fimo preview client script in development so the Fimo Studio
+ * preview can select/edit elements. Mount inside <head> in the root layout.
+ *
+ * The script URL comes from FIMO_PREVIEW_SCRIPT_URL (written by
+ * `fimo init` for wrapped projects, pointing at `<apiUrl>/preview.js`).
+ * Renders nothing in production builds.
+ */
+export declare function FimoRemixScripts(): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=FimoRemixScripts.d.ts.map

package/dist/runtime/remix/FimoRemixScripts.js

@@ -0,0 +1,19 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Renders the Fimo preview client script in development so the Fimo Studio
+ * preview can select/edit elements. Mount inside <head> in the root layout.
+ *
+ * The script URL comes from FIMO_PREVIEW_SCRIPT_URL (written by
+ * `fimo init` for wrapped projects, pointing at `<apiUrl>/preview.js`).
+ * Renders nothing in production builds.
+ */
+export function FimoRemixScripts() {
+    if (process.env.NODE_ENV !== 'development') {
+        return null;
+    }
+    const previewScriptUrl = process.env.FIMO_PREVIEW_SCRIPT_URL;
+    if (!previewScriptUrl) {
+        return null;
+    }
+    return _jsx("script", { type: "module", src: previewScriptUrl });
+}

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

@@ -0,0 +1,12 @@
+export { FimoRemixProviders } from './FimoRemixProviders.js';
+export type { FimoRemixLabels, FimoRemixProvidersProps } from './FimoRemixProviders.js';
+export { FimoRemixScripts } from './FimoRemixScripts.js';
+export { FimoText } from '../wrapped/FimoText.js';
+export { FimoRichTextBlock } from '../wrapped/FimoRichTextBlock.js';
+export { FimoMediaImage } from '../wrapped/FimoMediaImage.js';
+export { FimoMediaVideo } from '../wrapped/FimoMediaVideo.js';
+export { FimoFileLink } from '../wrapped/FimoFileLink.js';
+export { useWrappedMedia, useWrappedRichText } from '../wrapped/WrappedContentContext.js';
+export type { WrappedMediaEntry, WrappedRichTextEntry } from '../wrapped/WrappedContentContext.js';
+export { useLabels } from '../primitives/labels-hook.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/remix/index.js

@@ -0,0 +1,11 @@
+// fimo/remix — the Remix adapter. Framework-neutral pieces live in
+// ../wrapped and are re-exported; this module only adds the Remix wiring.
+export { FimoRemixProviders } from './FimoRemixProviders.js';
+export { FimoRemixScripts } from './FimoRemixScripts.js';
+export { FimoText } from '../wrapped/FimoText.js';
+export { FimoRichTextBlock } from '../wrapped/FimoRichTextBlock.js';
+export { FimoMediaImage } from '../wrapped/FimoMediaImage.js';
+export { FimoMediaVideo } from '../wrapped/FimoMediaVideo.js';
+export { FimoFileLink } from '../wrapped/FimoFileLink.js';
+export { useWrappedMedia, useWrappedRichText } from '../wrapped/WrappedContentContext.js';
+export { useLabels } from '../primitives/labels-hook.js';

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

@@ -0,0 +1,2 @@
+export * from '../wrapped/server.js';
+//# sourceMappingURL=server.d.ts.map

package/dist/runtime/remix/server.js

@@ -0,0 +1,2 @@
+// fimo/remix/server — same framework-neutral loaders as every adapter.
+export * from '../wrapped/server.js';

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

@@ -0,0 +1,22 @@
+import type { FimoSEO } from '../shared/fimo-config.types.js';
+/**
+ * The framework-neutral `fimo/seo` surface: pure per-page SEO resolution over
+ * the page registry (`fimo-config.json#routes`), with no framework adapter,
+ * no vite virtual module, and no React. Every framework's injection recipe
+ * (Next `generateMetadata`, an Astro head component, a SvelteKit load) calls
+ * `getFimoSeoForPath` server-side and maps the result to its own head API.
+ * SEO stays wired only when the project owner explicitly opted into
+ * Fimo-managed SEO — the migration never wires it by default.
+ */
+export { resolveSeoForPath } from './resolver.js';
+export type { FimoSEO, RouteSEO } from '../shared/fimo-config.types.js';
+export interface GetFimoSeoOptions {
+    /** Project root holding fimo-config.json (default: process.cwd()). */
+    rootDir?: string;
+    /** Instance data for `{{variable}}` templates in route-level SEO (e.g. the
+     *  entry rendered by a dynamic page: `{ "blog-post": entry }`). */
+    routeData?: Record<string, unknown>;
+}
+/** Resolve the SEO values for one page path from the page registry on disk. */
+export declare function getFimoSeoForPath(pathname: string, options?: GetFimoSeoOptions): FimoSEO | undefined;
+//# sourceMappingURL=neutral.d.ts.map