fimo 0.3.1 → 0.3.2-experimental.1783328062928

package/dist/runtime/next/server.js

@@ -0,0 +1,107 @@
+// fimo/next/server — server-only loaders for wrapped Next.js apps.
+// Content resolves at request time from the public tenant API (no Vite
+// virtual modules, no build plugin): call these in the root layout / RSC
+// pages and pass the results to <FimoNextProviders>.
+import { getConfigServer } from '../shared/fimo-config.server.js';
+import { fetchWithTimeout, labelSignature, loadLabelBundle, readProjectEnv, resolveTenantApiUrl, } from '../shared/labels-fetch.server.js';
+export function loadFimoConfig(rootDir = process.cwd()) {
+    return getConfigServer(rootDir);
+}
+export async function loadFimoLabels(options = {}) {
+    const rootDir = options.rootDir ?? process.cwd();
+    const bundle = await loadLabelBundle(rootDir);
+    return { ...bundle, signature: labelSignature(bundle) };
+}
+async function resolveApiUrl(options) {
+    if (options.apiUrl) {
+        return options.apiUrl;
+    }
+    const env = await readProjectEnv(options.rootDir ?? process.cwd());
+    return resolveTenantApiUrl(env);
+}
+/**
+ * Fetch published entries of a content type from the public tenant API.
+ * Returns [] when the API is unreachable so the wrapped site keeps rendering
+ * its fallbacks.
+ */
+export async function fetchEntries(typeName, options = {}) {
+    const apiUrl = await resolveApiUrl(options);
+    if (!apiUrl) {
+        return [];
+    }
+    try {
+        const response = await fetchWithTimeout(new URL(`/entries/${typeName}`, apiUrl), 4000);
+        if (!response.ok) {
+            return [];
+        }
+        const body = (await response.json());
+        const rows = Array.isArray(body.data) ? body.data : [];
+        return rows
+            .filter((row) => Boolean(row) && typeof row === 'object')
+            .map((row) => ({
+            id: String(row.id ?? row.documentId ?? ''),
+            data: (row.data && typeof row.data === 'object' ? row.data : row),
+        }))
+            .filter((row) => row.id.length > 0);
+    }
+    catch {
+        return [];
+    }
+}
+function readString(value) {
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+function readNumber(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+}
+/**
+ * Load the WrappedMedia entries (key → media) seeded by the wrap migration.
+ * Each entry has a `key` (the FimoMediaImage/Video/FileLink id) and an
+ * asset-typed `image` field.
+ */
+export async function loadWrappedMedia(options = {}) {
+    const entries = await fetchEntries('WrappedMedia', options);
+    const map = {};
+    for (const entry of entries) {
+        const key = readString(entry.data.key) ?? readString(entry.data.slug);
+        const asset = entry.data.image;
+        if (!key || !asset || typeof asset !== 'object') {
+            continue;
+        }
+        const assetRecord = asset;
+        const url = readString(assetRecord.url);
+        if (!url) {
+            continue;
+        }
+        map[key] = {
+            url,
+            alt: readString(assetRecord.alt) ?? readString(entry.data.alt),
+            name: readString(assetRecord.name),
+            mime: readString(assetRecord.mime) ?? readString(assetRecord.mimeType),
+            width: readNumber(assetRecord.width),
+            height: readNumber(assetRecord.height),
+            source: `WrappedMedia.${entry.id}.image`,
+        };
+    }
+    return map;
+}
+/**
+ * Load the WrappedRichText entries (key → TipTap JSON) seeded by the wrap
+ * migration for formatted text (bold/italic/underline/links).
+ */
+export async function loadWrappedRichText(options = {}) {
+    const entries = await fetchEntries('WrappedRichText', options);
+    const map = {};
+    for (const entry of entries) {
+        const key = readString(entry.data.key) ?? readString(entry.data.slug);
+        const body = entry.data.body;
+        if (!key || !body || typeof body !== 'object') {
+            continue;
+        }
+        map[key] = {
+            content: body,
+            source: `WrappedRichText.${entry.id}.body`,
+        };
+    }
+    return map;
+}

package/dist/runtime/primitives/labels-hook.d.ts

@@ -0,0 +1,33 @@
+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.
+ *
+ * The optional `fallback` renders when the key has no value in the store —
+ * used by wrapped (migrated) projects where the original hardcoded string
+ * stays in code as a resilience fallback. Template projects keep the
+ * single-argument form (labels are DB-owned there).
+ *
+ * @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, fallback?: string) => FimoString;
+    locale: string;
+};
+/**
+ * Legacy alias for older projects. Prefer useLabels() in new code.
+ */
+export declare function useTranslations(): {
+    t: (fullKey: string, fallback?: string) => FimoString;
+    locale: string;
+};
+//# sourceMappingURL=labels-hook.d.ts.map

package/dist/runtime/primitives/labels-hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels-hook.d.ts","sourceRoot":"","sources":["../../../src/runtime/primitives/labels-hook.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,SAAS;iBAIH,MAAM,aAAa,MAAM,KAAG,UAAU;;EAS3D;AAED;;GAEG;AACH,wBAAgB,eAAe;iBAdT,MAAM,aAAa,MAAM,KAAG,UAAU;;EAgB3D"}

package/dist/runtime/primitives/labels-hook.js

@@ -0,0 +1,41 @@
+import { useSyncExternalStore } from 'react';
+import { useLocale } from '../i18n/FimoLocaleContext.js';
+import { getLabelSnapshot, subscribeLabels } from './labels-store.js';
+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.
+ *
+ * The optional `fallback` renders when the key has no value in the store —
+ * used by wrapped (migrated) projects where the original hardcoded string
+ * stays in code as a resilience fallback. Template projects keep the
+ * single-argument form (labels are DB-owned there).
+ *
+ * @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, fallback) => {
+        const locale = localeContext.locale || labels.defaultLocale || 'en';
+        const dictionary = labels.dictionaries[locale] ?? labels.dictionaries[labels.defaultLocale] ?? {};
+        const text = dictionary[fullKey] ?? fallback ?? '';
+        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();
+}

package/dist/runtime/primitives/labels-store.d.ts

@@ -0,0 +1,12 @@
+export interface LabelState {
+    dictionaries: Record<string, Record<string, string>>;
+    defaultLocale: string;
+    signature: string;
+    updatedAt: string | null;
+}
+export declare function subscribeLabels(listener: () => void): () => void;
+export declare function getLabelSnapshot(): LabelState;
+export declare function setLabelState(next: LabelState): void;
+export declare function hydrateLabels(bundle: LabelState): void;
+export declare function applyLabelUpdate(payload: unknown): void;
+//# sourceMappingURL=labels-store.d.ts.map

package/dist/runtime/primitives/labels-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels-store.d.ts","sourceRoot":"","sources":["../../../src/runtime/primitives/labels-store.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACrD,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAUD,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAKhE;AAED,wBAAgB,gBAAgB,IAAI,UAAU,CAE7C;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAQpD;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAEtD;AAuBD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgBvD"}

package/dist/runtime/primitives/labels-store.js

@@ -0,0 +1,60 @@
+// Framework-neutral label store. No Vite virtual modules, no HMR, no React:
+// adapters (fimo/ui via ./translations.ts, fimo/next, ...) hydrate it with
+// their own label source and the hook layer subscribes to it.
+const labelListeners = new Set();
+let labelState = {
+    dictionaries: {},
+    defaultLocale: 'en',
+    signature: '__fimo-labels-uninitialized__',
+    updatedAt: null,
+};
+export function subscribeLabels(listener) {
+    labelListeners.add(listener);
+    return () => {
+        labelListeners.delete(listener);
+    };
+}
+export function getLabelSnapshot() {
+    return labelState;
+}
+export function setLabelState(next) {
+    if (next.signature === labelState.signature) {
+        return;
+    }
+    labelState = next;
+    for (const listener of labelListeners) {
+        listener();
+    }
+}
+export function hydrateLabels(bundle) {
+    setLabelState(bundle);
+}
+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;
+}
+export 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 });
+}

package/dist/runtime/primitives/labels-store.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=labels-store.test.d.ts.map

package/dist/runtime/primitives/labels-store.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels-store.test.d.ts","sourceRoot":"","sources":["../../../src/runtime/primitives/labels-store.test.ts"],"names":[],"mappings":""}

package/dist/runtime/primitives/labels-store.test.js

@@ -0,0 +1,66 @@
+import { describe, expect, it, vi } from 'vitest';
+import { applyLabelUpdate, getLabelSnapshot, hydrateLabels, subscribeLabels } from './labels-store.js';
+describe('labels-store', () => {
+    it('hydrates the store and notifies subscribers', () => {
+        const listener = vi.fn();
+        const unsubscribe = subscribeLabels(listener);
+        hydrateLabels({
+            dictionaries: { en: { 'hero.title': 'Welcome' } },
+            defaultLocale: 'en',
+            signature: 'sig-hydrate-1',
+            updatedAt: null,
+        });
+        expect(getLabelSnapshot().dictionaries.en['hero.title']).toBe('Welcome');
+        expect(listener).toHaveBeenCalledTimes(1);
+        unsubscribe();
+    });
+    it('ignores updates with an unchanged signature', () => {
+        const listener = vi.fn();
+        const unsubscribe = subscribeLabels(listener);
+        hydrateLabels({
+            dictionaries: { en: { a: '1' } },
+            defaultLocale: 'en',
+            signature: 'sig-same',
+            updatedAt: null,
+        });
+        hydrateLabels({
+            dictionaries: { en: { a: '2' } },
+            defaultLocale: 'en',
+            signature: 'sig-same',
+            updatedAt: null,
+        });
+        expect(getLabelSnapshot().dictionaries.en.a).toBe('1');
+        expect(listener).toHaveBeenCalledTimes(1);
+        unsubscribe();
+    });
+    it('normalizes payloads in applyLabelUpdate and drops non-string values', () => {
+        applyLabelUpdate({
+            dictionaries: { en: { keep: 'yes', drop: 42 }, fr: 'not-a-record' },
+            defaultLocale: 'en',
+            signature: 'sig-normalize',
+        });
+        const snapshot = getLabelSnapshot();
+        expect(snapshot.dictionaries.en).toEqual({ keep: 'yes' });
+        expect(snapshot.dictionaries.fr).toBeUndefined();
+        expect(snapshot.updatedAt).toBeNull();
+    });
+    it('rejects payloads without dictionaries', () => {
+        const before = getLabelSnapshot();
+        applyLabelUpdate({ defaultLocale: 'de' });
+        applyLabelUpdate(null);
+        applyLabelUpdate('nope');
+        expect(getLabelSnapshot()).toBe(before);
+    });
+    it('stops notifying after unsubscribe', () => {
+        const listener = vi.fn();
+        const unsubscribe = subscribeLabels(listener);
+        unsubscribe();
+        hydrateLabels({
+            dictionaries: { en: {} },
+            defaultLocale: 'en',
+            signature: 'sig-after-unsub',
+            updatedAt: null,
+        });
+        expect(listener).not.toHaveBeenCalled();
+    });
+});

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.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useFimoLiveValue.d.ts","sourceRoot":"","sources":["../../../../src/runtime/primitives/lib/useFimoLiveValue.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,SAAS,EAA+B,MAAM,OAAO,CAAC;AAEpE;;;;;;;;;;;;;GAaG;AAEH,iBAAS,mBAAmB,CAAC,CAAC,EAAE,CAAC,SAAS,WAAW,GAAG,WAAW,EACjE,QAAQ,EAAE,CAAC,GACV;IAAE,KAAK,EAAE,CAAC,CAAC;IAAC,GAAG,EAAE,SAAS,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;CAAE,CA8BxC;AASD,eAAO,MAAM,gBAAgB,EAExB,OAAO,mBAAmB,CAAC"}
+{"version":3,"file":"useFimoLiveValue.d.ts","sourceRoot":"","sources":["../../../../src/runtime/primitives/lib/useFimoLiveValue.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,SAAS,EAA+B,MAAM,OAAO,CAAC;AAEpE;;;;;;;;;;;;;;;GAeG;AAEH,iBAAS,mBAAmB,CAAC,CAAC,EAAE,CAAC,SAAS,WAAW,GAAG,WAAW,EACjE,QAAQ,EAAE,CAAC,GACV;IAAE,KAAK,EAAE,CAAC,CAAC;IAAC,GAAG,EAAE,SAAS,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;CAAE,CA8BxC;AAaD,eAAO,MAAM,gBAAgB,EAExB,OAAO,mBAAmB,CAAC"}

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,6 @@ function useFimoLiveValueProd(external) {
     const ref = useRef(null);
     return { value: external, ref };
 }
-export const useFimoLiveValue = (import.meta.env.DEV ? useFimoLiveValueDev : useFimoLiveValueProd);
+const isDevRuntime = import.meta.env?.DEV === true ||
+    (typeof process !== 'undefined' && 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.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"translations.d.ts","sourceRoot":"","sources":["../../../src/runtime/primitives/translations.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AA2F5C;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS;iBAIH,MAAM,KAAG,UAAU;;EASxC;AAED;;GAEG;AACH,wBAAgB,eAAe;iBAdT,MAAM,KAAG,UAAU;;EAgBxC"}
+{"version":3,"file":"translations.d.ts","sourceRoot":"","sources":["../../../src/runtime/primitives/translations.ts"],"names":[],"mappings":"AAiCA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC"}

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/index.d.ts

@@ -0,0 +1,24 @@
+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 { 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';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/react/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,IAAI,EAAE,MAAM,kCAAkC,CAAC;AACxD,OAAO,EAAE,KAAK,EAAE,MAAM,mCAAmC,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,yCAAyC,CAAC;AACtE,OAAO,EAAE,KAAK,EAAE,MAAM,mCAAmC,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,MAAM,kCAAkC,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,qCAAqC,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAC;AAGhE,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACnH,YAAY,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAGhE,OAAO,EACL,UAAU,EACV,QAAQ,EACR,SAAS,EACT,WAAW,EACX,YAAY,EACZ,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,WAAW,EACX,UAAU,EACV,YAAY,EACZ,UAAU,EACV,aAAa,EACb,aAAa,EACb,YAAY,GACb,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,+BAA+B,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAGzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAGrE,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAC7E,YAAY,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,GACX,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAG9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAC3E,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/runtime/react/index.js

@@ -0,0 +1,28 @@
+// 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';
+// 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';

package/dist/runtime/shared/display-routes.d.ts

@@ -0,0 +1,14 @@
+import type { FimoConfig } from './fimo-config.types.js';
+export interface ParamInfo {
+    schema: string;
+    queryField: string;
+    displayField: string;
+}
+export interface DisplayRoute {
+    id: string;
+    name: string;
+    path: string;
+    params?: Record<string, ParamInfo>;
+}
+export declare function getDisplayRoutes(config: Pick<FimoConfig, 'routes'> | undefined): DisplayRoute[];
+//# sourceMappingURL=display-routes.d.ts.map

package/dist/runtime/shared/display-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"display-routes.d.ts","sourceRoot":"","sources":["../../../src/runtime/shared/display-routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACpC;AAmBD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,GAAG,SAAS,GAAG,YAAY,EAAE,CAU/F"}

package/dist/runtime/shared/display-routes.js

@@ -0,0 +1,25 @@
+const titleCase = (seg) => seg
+    .replace(/[_\-]+/g, ' ')
+    .replace(/([a-z])([A-Z])/g, '$1 $2')
+    .split(/\s+/)
+    .filter(Boolean)
+    .map((w) => w.charAt(0).toUpperCase() + w.slice(1).toLowerCase())
+    .join(' ');
+const generateRouteName = (path) => {
+    if (path === '/') {
+        return 'Home';
+    }
+    const firstSegment = path.replace(/^\//, '').split('/')[0];
+    return titleCase(firstSegment);
+};
+export function getDisplayRoutes(config) {
+    const configRoutes = config?.routes ?? {};
+    return Object.entries(configRoutes)
+        .filter(([, route]) => route.path)
+        .map(([id, route]) => ({
+        id,
+        path: route.path,
+        name: route.name || route.label || generateRouteName(route.path),
+        params: route.params,
+    }));
+}

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

@@ -1 +1 @@
-{"version":3,"file":"fimo-config.server.d.ts","sourceRoot":"","sources":["../../../src/runtime/shared/fimo-config.server.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAA4C,MAAM,wBAAwB,CAAC;AAiBnG;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAe3D;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAUxD"}
+{"version":3,"file":"fimo-config.server.d.ts","sourceRoot":"","sources":["../../../src/runtime/shared/fimo-config.server.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAA4C,MAAM,wBAAwB,CAAC;AAkBnG;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAgB3D;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAUxD"}

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

@@ -20,6 +20,7 @@ export function getConfigServer(rootDir) {
             i18n: raw.i18n,
             routes: raw.routes,
             version: raw.version,
+            framework: raw.framework,
         };
     }
     catch {