fimo 0.8.0 → 0.9.0-experimental.2

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,63 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useMemo, useState } from 'react';
+import { getFimoDefaultLocale, getFimoLocales } from '../i18n/locale.js';
+import { fetchLabelBundle, serializeBundle } from '../shared/labels-fetch.pure.js';
+import { WrappedProviders } from '../wrapped/WrappedProviders.js';
+/** Browser-safe stable signature (labelSignature uses Buffer, server-only). */
+function bundleSignature(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}`;
+}
+/**
+ * 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, }) {
+    const [labels, setLabels] = useState(undefined);
+    useEffect(() => {
+        if (!apiUrl) {
+            return;
+        }
+        let cancelled = false;
+        const defaultLocale = getFimoDefaultLocale(config);
+        fetchLabelBundle(apiUrl, getFimoLocales(config), defaultLocale)
+            .then((bundle) => {
+            if (!cancelled) {
+                setLabels({ ...bundle, signature: bundleSignature(bundle) });
+            }
+        })
+            .catch(() => {
+            // Unreachable API: keep rendering the inline fallbacks.
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [apiUrl, config]);
+    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: media, richText: richText, locale: locale, navigation: navigation, children: [previewScriptUrl ? _jsx("script", { type: "module", src: previewScriptUrl }) : null, children] }));
+}

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

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

package/dist/runtime/react/index.js

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

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/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.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.js

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

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

@@ -57,5 +57,7 @@ export interface FimoConfig {
     i18n?: FimoI18nConfig;
     routes?: Record<string, FimoRouteConfig>;
     version?: string | number;
+    /** The project's framework. Absent means the Fimo template (react-router). */
+    framework?: 'react-router' | 'next' | string;
 }
 //# sourceMappingURL=fimo-config.types.d.ts.map

package/dist/runtime/shared/i18n-messages.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Lossless bridge between a nested i18n message store (next-intl / i18next
+ * style: `{ home: { title: "…" } }`) and Fimo's FLAT per-locale label map
+ * (`{ "home.title": "…" }`). Ingestion flattens the store into labels;
+ * `loadFimoMessages` un-flattens the labels back so the app's own i18n
+ * runtime keeps rendering unchanged, now sourced from Fimo.
+ *
+ * String leaves and nested objects round-trip byte-for-byte, ICU strings
+ * (`{count, plural, …}`, `<tag>…</tag>`) kept opaque. Array/number/boolean
+ * leaves are rare in message stores and are NOT flattened — they stay in the
+ * caller's static base (deep-merged under the Fimo bundle).
+ */
+/** Flatten a nested message object to dot-keyed string entries. Non-string
+ *  leaves (arrays, numbers) are skipped — reported so the caller can note
+ *  them. Keys already containing a dot are preserved verbatim. */
+export declare function flattenMessages(messages: unknown, prefix?: string): {
+    flat: Record<string, string>;
+    skipped: string[];
+};
+/** Rebuild the nested message object from a flat dot-keyed map. Inverse of
+ *  flattenMessages for string leaves. A key whose path collides with an
+ *  already-set string (e.g. both `a` and `a.b` exist) keeps the deeper
+ *  object and drops the scalar — message stores never have both. */
+export declare function unflattenMessages(flat: Record<string, string>): Record<string, unknown>;
+/** Deep-merge `override` (Fimo bundle) over `base` (static messages) so keys
+ *  absent from Fimo fall back to the shipped file instead of next-intl's
+ *  MISSING_MESSAGE. Objects merge recursively; leaves in `override` win. */
+export declare function deepMergeMessages(base: Record<string, unknown>, override: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=i18n-messages.d.ts.map

package/dist/runtime/shared/i18n-messages.js

@@ -0,0 +1,79 @@
+/**
+ * Lossless bridge between a nested i18n message store (next-intl / i18next
+ * style: `{ home: { title: "…" } }`) and Fimo's FLAT per-locale label map
+ * (`{ "home.title": "…" }`). Ingestion flattens the store into labels;
+ * `loadFimoMessages` un-flattens the labels back so the app's own i18n
+ * runtime keeps rendering unchanged, now sourced from Fimo.
+ *
+ * String leaves and nested objects round-trip byte-for-byte, ICU strings
+ * (`{count, plural, …}`, `<tag>…</tag>`) kept opaque. Array/number/boolean
+ * leaves are rare in message stores and are NOT flattened — they stay in the
+ * caller's static base (deep-merged under the Fimo bundle).
+ */
+/** Flatten a nested message object to dot-keyed string entries. Non-string
+ *  leaves (arrays, numbers) are skipped — reported so the caller can note
+ *  them. Keys already containing a dot are preserved verbatim. */
+export function flattenMessages(messages, prefix = '') {
+    const flat = {};
+    const skipped = [];
+    if (!messages || typeof messages !== 'object' || Array.isArray(messages)) {
+        return { flat, skipped };
+    }
+    for (const [key, value] of Object.entries(messages)) {
+        const path = prefix ? `${prefix}.${key}` : key;
+        if (typeof value === 'string') {
+            flat[path] = value;
+        }
+        else if (value && typeof value === 'object' && !Array.isArray(value)) {
+            const nested = flattenMessages(value, path);
+            Object.assign(flat, nested.flat);
+            skipped.push(...nested.skipped);
+        }
+        else {
+            skipped.push(path);
+        }
+    }
+    return { flat, skipped };
+}
+/** Rebuild the nested message object from a flat dot-keyed map. Inverse of
+ *  flattenMessages for string leaves. A key whose path collides with an
+ *  already-set string (e.g. both `a` and `a.b` exist) keeps the deeper
+ *  object and drops the scalar — message stores never have both. */
+export function unflattenMessages(flat) {
+    const root = {};
+    for (const [flatKey, value] of Object.entries(flat)) {
+        const parts = flatKey.split('.');
+        let node = root;
+        for (let i = 0; i < parts.length - 1; i += 1) {
+            const part = parts[i];
+            const existing = node[part];
+            if (!existing || typeof existing !== 'object' || Array.isArray(existing)) {
+                node[part] = {};
+            }
+            node = node[part];
+        }
+        node[parts[parts.length - 1]] = value;
+    }
+    return root;
+}
+/** Deep-merge `override` (Fimo bundle) over `base` (static messages) so keys
+ *  absent from Fimo fall back to the shipped file instead of next-intl's
+ *  MISSING_MESSAGE. Objects merge recursively; leaves in `override` win. */
+export function deepMergeMessages(base, override) {
+    const out = { ...base };
+    for (const [key, value] of Object.entries(override)) {
+        const current = out[key];
+        if (value &&
+            typeof value === 'object' &&
+            !Array.isArray(value) &&
+            current &&
+            typeof current === 'object' &&
+            !Array.isArray(current)) {
+            out[key] = deepMergeMessages(current, value);
+        }
+        else {
+            out[key] = value;
+        }
+    }
+    return out;
+}

package/dist/runtime/shared/labels-fetch.pure.d.ts

@@ -0,0 +1,17 @@
+export interface LabelBundle {
+    dictionaries: Record<string, Record<string, string>>;
+    defaultLocale: string;
+    locales: string[];
+    updatedAt: string | null;
+}
+export declare const API_URL_ENV_KEYS: readonly ["VITE_API_URL", "NEXT_PUBLIC_FIMO_API_URL", "NUXT_PUBLIC_FIMO_API_URL", "PUBLIC_FIMO_API_URL", "FIMO_API_URL"];
+export declare function resolveTenantApiUrl(env: Record<string, string>): string | undefined;
+export declare function serializeBundle(bundle: LabelBundle): string;
+export declare function fetchLabelDictionary(apiUrl: string, locale: string): Promise<{
+    locale: string;
+    labels: Record<string, string>;
+    updatedAt: string | null;
+}>;
+export declare function fetchLabelBundle(apiUrl: string, locales: string[], defaultLocale: string): Promise<LabelBundle>;
+export declare function fetchWithTimeout(url: URL, timeoutMs: number): Promise<Response>;
+//# sourceMappingURL=labels-fetch.pure.d.ts.map

package/dist/runtime/shared/labels-fetch.pure.js

@@ -0,0 +1,71 @@
+// Label fetching, PURE core: fetch/URL/AbortController only — no node
+// builtins, importable from client-bundled code (Nuxt composables, universal
+// SFCs). The node-flavored wrapper (env-file reading, config, signatures)
+// lives in labels-fetch.server.ts.
+// The tenant API base URL env var, in framework flavor order.
+export const API_URL_ENV_KEYS = [
+    'VITE_API_URL',
+    'NEXT_PUBLIC_FIMO_API_URL',
+    'NUXT_PUBLIC_FIMO_API_URL',
+    'PUBLIC_FIMO_API_URL',
+    'FIMO_API_URL',
+];
+export function resolveTenantApiUrl(env) {
+    for (const key of API_URL_ENV_KEYS) {
+        if (env[key]) {
+            return env[key];
+        }
+    }
+    return undefined;
+}
+export function serializeBundle(bundle) {
+    return JSON.stringify({
+        dictionaries: bundle.dictionaries,
+        defaultLocale: bundle.defaultLocale,
+        locales: bundle.locales,
+    });
+}
+export async function fetchLabelDictionary(apiUrl, locale) {
+    const url = new URL('/labels', apiUrl);
+    url.searchParams.set('locale', locale);
+    const response = await fetchWithTimeout(url, 4000);
+    if (!response.ok) {
+        return { locale, labels: {}, updatedAt: null };
+    }
+    const body = (await response.json());
+    if (Array.isArray(body.data)) {
+        return {
+            locale,
+            labels: Object.fromEntries(body.data.map((row) => [row.key, row.value ?? row.defaultValue ?? ''])),
+            updatedAt: null,
+        };
+    }
+    return {
+        locale,
+        labels: body.data?.labels ?? {},
+        updatedAt: body.data?.updatedAt ?? null,
+    };
+}
+export async function fetchLabelBundle(apiUrl, locales, defaultLocale) {
+    const loaded = await Promise.all(locales.map((locale) => fetchLabelDictionary(apiUrl, locale).catch(() => ({ locale, labels: {}, updatedAt: null }))));
+    const sortedUpdatedAt = loaded
+        .map((entry) => entry.updatedAt)
+        .filter((value) => typeof value === 'string')
+        .sort();
+    return {
+        dictionaries: Object.fromEntries(loaded.map((entry) => [entry.locale, entry.labels])),
+        defaultLocale,
+        locales,
+        updatedAt: sortedUpdatedAt[sortedUpdatedAt.length - 1] ?? null,
+    };
+}
+export async function fetchWithTimeout(url, timeoutMs) {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        return await fetch(url, { signal: controller.signal });
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}

package/dist/runtime/shared/labels-fetch.server.d.ts

@@ -0,0 +1,7 @@
+import { type LabelBundle } from './labels-fetch.pure.js';
+export { API_URL_ENV_KEYS, fetchLabelBundle, fetchLabelDictionary, fetchWithTimeout, resolveTenantApiUrl, serializeBundle, type LabelBundle, } from './labels-fetch.pure.js';
+export declare function labelSignature(bundle: LabelBundle): string;
+export declare function emptyLabelBundle(rootDir: string): LabelBundle;
+export declare function loadLabelBundle(rootDir: string): Promise<LabelBundle>;
+export declare function readProjectEnv(rootDir: string): Promise<Record<string, string>>;
+//# sourceMappingURL=labels-fetch.server.d.ts.map