fimo 0.14.0 → 0.15.0-staging.2

package/dist/runtime/content/client/types.d.ts

@@ -1,101 +1,7 @@
 import type { InfiniteData, UseInfiniteQueryResult, UseMutationResult, UseQueryResult, UseSuspenseQueryResult } from '@tanstack/react-query';
-import type { Fields, Populate, PopulatedResult, ProjectedWithPopulate, Query } from '../../primitives/lib/query.js';
-/**
- * Result shape of a read: the entity with populated references applied and
- * field projection narrowed — the runtime equivalent of the generated
- * `{Uid}Result` alias.
- */
-export type ContentResult<T extends {
-    id: string;
-}, TFields extends Fields<T> | undefined = undefined, TPopulate extends Populate<T> | undefined = undefined> = ProjectedWithPopulate<PopulatedResult<T, TPopulate> & {
-    id: string;
-}, TFields, TPopulate>;
-/**
- * The schema definition as written in `src/schemas/<uid>.json`. The factory
- * interprets it directly — the schema is the descriptor, so generated code
- * never transcribes field shapes into a second format that could drift.
- */
-export interface ContentSchemaField {
-    type?: string;
-    required?: boolean;
-    default?: unknown;
-    /** Media fields: multiple assets. */
-    multiple?: boolean;
-    /** Reference fields: to-many. */
-    many?: boolean;
-    /** Reference fields: target schema uid (may be this schema's own uid). */
-    target?: string;
-    /** Polymorphic reference fields: allowed target schema uids. */
-    targets?: readonly string[];
-    min?: number;
-    max?: number;
-    minLength?: number;
-    maxLength?: number;
-    regex?: string;
-    schema?: {
-        fields: Readonly<Record<string, ContentSchemaField>>;
-    } | {
-        oneOf: readonly {
-            uid: string;
-            label: string;
-            description?: string;
-            fields: Readonly<Record<string, ContentSchemaField>>;
-        }[];
-    };
-}
-export interface ContentSchema {
-    uid: string;
-    name?: string;
-    isSingleton?: boolean;
-    i18n?: {
-        enabled?: boolean;
-    };
-    fields?: Readonly<Record<string, ContentSchemaField>>;
-}
-export interface ContentModuleMeta {
-    readonly uid: string;
-    readonly pascal: string;
-    readonly localized: boolean;
-}
-export interface ContentClientHandle {
-    wrapWithSource: (entry: Record<string, any>) => unknown;
-    meta: ContentModuleMeta;
-}
-/**
- * A cross-referenced generated module — either a client directly, or a module
- * namespace whose default export is the client. Generated modules for schemas
- * that reference each other form ESM cycles, so the factory only reads
- * properties off a ref lazily at request time, never while the client is
- * being constructed — a namespace import is safe to pass here even mid-cycle.
- */
-export type ContentModuleRef = ContentClientHandle | {
-    default: ContentClientHandle;
-};
-export interface ContentClientConfig {
-    schema: ContentSchema;
-    /**
-     * Every OTHER schema module this schema references, keyed by uid —
-     * `references: { Author, Video }` with namespace imports. Self-references
-     * resolve internally and never appear here.
-     */
-    references?: Readonly<Record<string, ContentModuleRef>>;
-}
-export interface ContentReadOptions<TPopulate> {
-    locale?: string;
-    populate?: TPopulate;
-    localeFallbacks?: boolean;
-}
-export interface CollectionPageInfo {
-    readonly limit: number;
-    readonly offset: number;
-    readonly total: number;
-    readonly hasMore: boolean;
-    readonly nextOffset: number | null;
-}
-export interface CollectionPage<TItem> {
-    readonly items: TItem[];
-    readonly pageInfo: CollectionPageInfo;
-}
+import type { Fields, Populate, Query } from '../../primitives/lib/query.js';
+import type { CollectionContentCore, CollectionPage, ContentReadOptions, ContentResult, SingletonContentCore } from './core-types.js';
+export type { CollectionContentCore, CollectionPage, CollectionPageInfo, ContentClientConfig, ContentClientHandle, ContentModuleMeta, ContentModuleRef, ContentReadOptions, ContentResult, ContentSchema, ContentSchemaField, SingletonContentCore, } from './core-types.js';
 export type InfiniteListResult<TItem> = UseInfiniteQueryResult<InfiniteData<CollectionPage<TItem>>, Error> & {
     readonly items: TItem[];
     readonly total: number;
@@ -105,19 +11,7 @@ export type InfiniteListResult<TItem> = UseInfiniteQueryResult<InfiniteData<Coll
 };
 export interface CollectionContentClient<T extends {
     id: string;
-}, TInput> {
-    readonly meta: ContentModuleMeta;
-    wrapWithSource(entry: Record<string, any>): T;
-    getById<TPopulate extends Populate<T> | undefined = undefined>(id: string, options?: ContentReadOptions<TPopulate>): Promise<ContentResult<T, undefined, TPopulate>>;
-    getBySlug<TPopulate extends Populate<T> | undefined = undefined>(slug: string, options?: ContentReadOptions<TPopulate>): Promise<ContentResult<T, undefined, TPopulate> | null>;
-    getByField<TPopulate extends Populate<T> | undefined = undefined>(fieldName: string, value: string, options?: ContentReadOptions<TPopulate>): Promise<ContentResult<T, undefined, TPopulate> | null>;
-    list<TFields extends Fields<T> | undefined = undefined, TPopulate extends Populate<T> | undefined = undefined>(params?: Query<T, TFields, TPopulate>): Promise<CollectionPage<ContentResult<T, TFields, TPopulate>>>;
-    get<TFields extends Fields<T> | undefined = undefined, TPopulate extends Populate<T> | undefined = undefined>(params?: Query<T, TFields, TPopulate>): Promise<ContentResult<T, TFields, TPopulate>[]>;
-    create(payload: TInput): Promise<T>;
-    update(id: string, payload: Partial<TInput>): Promise<T>;
-    remove(id: string, options?: {
-        locale?: string;
-    }): Promise<void>;
+}, TInput extends object> extends CollectionContentCore<T, TInput> {
     useGetById<TPopulate extends Populate<T> | undefined = undefined>(id: string, options?: ContentReadOptions<TPopulate>): UseQueryResult<ContentResult<T, undefined, TPopulate>, Error>;
     useGetBySlug<TPopulate extends Populate<T> | undefined = undefined>(slug: string, options?: ContentReadOptions<TPopulate>): UseQueryResult<ContentResult<T, undefined, TPopulate> | null, Error>;
     useGetByField<TPopulate extends Populate<T> | undefined = undefined>(fieldName: string, value: string, options?: ContentReadOptions<TPopulate>): UseQueryResult<ContentResult<T, undefined, TPopulate> | null, Error>;
@@ -140,11 +34,7 @@ export interface CollectionContentClient<T extends {
 }
 export interface SingletonContentClient<T extends {
     id: string;
-}, TInput> {
-    readonly meta: ContentModuleMeta;
-    wrapWithSource(entry: Record<string, any>): T;
-    get<TPopulate extends Populate<T> | undefined = undefined>(options?: ContentReadOptions<TPopulate>): Promise<ContentResult<T, undefined, TPopulate>>;
-    update(payload: Partial<TInput>): Promise<T>;
+}, TInput extends object> extends SingletonContentCore<T, TInput> {
     useGet<TPopulate extends Populate<T> | undefined = undefined>(options?: ContentReadOptions<TPopulate>): UseQueryResult<ContentResult<T, undefined, TPopulate>, Error>;
     useSuspenseGet<TPopulate extends Populate<T> | undefined = undefined>(options?: ContentReadOptions<TPopulate>): UseSuspenseQueryResult<ContentResult<T, undefined, TPopulate>, Error>;
     useUpdate(): UseMutationResult<T, Error, Partial<TInput>>;

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

@@ -1,5 +1,5 @@
+import type { ContentClientConfig } from './client/core-types.js';
 import type { ContentRuntime } from './client/runtime.js';
-import type { ContentClientConfig } from './client/types.js';
 export declare function createContentCore<T extends {
     id: string;
 }, TInput extends object>(config: ContentClientConfig, runtime: ContentRuntime): import("./index.js").CollectionContentCore<T, TInput>;
@@ -10,7 +10,7 @@ export type { CollectionContentCore } from './client/collection-core.js';
 export type { ContentRuntime } from './client/runtime.js';
 export type { SingletonContentCore } from './client/singleton-core.js';
 export { serializeContent, type SerializedContent, type SerializedMedia } from './serialization.js';
-export type { CollectionPage, CollectionPageInfo, ContentClientConfig, ContentClientHandle, ContentModuleMeta, ContentModuleRef, ContentReadOptions, ContentResult, ContentSchema, ContentSchemaField, } from './client/types.js';
-export { FIMO_PARTS, FIMO_SOURCE, FimoBoolean, FimoDate, FimoMedia, FimoRichText, FimoString, getFimoParts, getFimoSource, hasFimoSource, isFimoDate, isFimoString, type FimoPart, type FimoPolymorphicReference, type FimoReference, type FimoRichTextComponents, type FimoRichTextContent, type FimoRichTextMarkProps, type FimoRichTextNodeProps, type FimoSource, } from '../primitives/lib/primitives.js';
+export type { CollectionPage, CollectionPageInfo, ContentClientConfig, ContentClientHandle, ContentModuleMeta, ContentModuleRef, ContentReadOptions, ContentResult, ContentSchema, ContentSchemaField, } from './client/core-types.js';
+export { FIMO_PARTS, FIMO_SOURCE, FimoBoolean, FimoDate, FimoMedia, FimoRichText, FimoString, getFimoParts, getFimoSource, hasFimoSource, isFimoDate, isFimoString, type FimoPart, type FimoPolymorphicReference, type FimoReference, type FimoRichTextContent, type FimoSource, } from '../primitives/lib/primitives.js';
 export type { BoolOps, DateOps, Field, Fields, FilterFor, NullOnlyOps, NumberOps, Populate, Populated, PopulatedResult, Projected, ProjectedWithPopulate, Query, ReferenceField, ReferenceMap, ScalarOps, Sort, SortField, StringOps, Where, WithReferences, } from '../primitives/lib/query.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/runtime/labels/fetch.js

@@ -8,7 +8,7 @@ function dictionaryFrom(value) {
 function snapshotFrom(body, requestedLocale) {
     if (Array.isArray(body.data)) {
         return {
-            locale: requestedLocale,
+            locale: requestedLocale ?? 'en',
             labels: Object.fromEntries(body.data.flatMap((row) => {
                 if (typeof row.key !== 'string') {
                     return [];
@@ -21,7 +21,7 @@ function snapshotFrom(body, requestedLocale) {
     }
     const data = body.data;
     return {
-        locale: typeof data?.locale === 'string' && data.locale.trim() ? data.locale : requestedLocale,
+        locale: typeof data?.locale === 'string' && data.locale.trim() ? data.locale : (requestedLocale ?? 'en'),
         labels: dictionaryFrom(data?.labels),
         updatedAt: typeof data?.updatedAt === 'string' ? data.updatedAt : null,
     };
@@ -29,7 +29,9 @@ function snapshotFrom(body, requestedLocale) {
 export async function fetchLabels(runtime, { locale: requestedLocale } = {}) {
     const locale = requestedLocale?.trim() || runtime.defaultLocale();
     const url = new URL('/labels', runtime.apiBase());
-    url.searchParams.set('locale', locale);
+    if (locale) {
+        url.searchParams.set('locale', locale);
+    }
     const response = await runtime.fetch(url, {
         headers: runtime.headers({ Accept: 'application/json' }),
     });

package/dist/runtime/next/client.d.ts

@@ -17,7 +17,8 @@ export { RichText } from '../react/primitives/editable/RichText.js';
 export { StaticImage } from '../react/primitives/renderers/StaticImage.js';
 export { Text } from '../react/primitives/editable/Text.js';
 export { Video } from '../react/primitives/editable/Video.js';
-export type { BoolOps, DateOps, Field, Fields, FilterFor, FimoPart, FimoPolymorphicReference, FimoReference, FimoRichTextComponents, FimoRichTextContent, FimoRichTextMarkProps, FimoRichTextNodeProps, FimoSource, NullOnlyOps, NumberOps, Populate, Populated, PopulatedResult, Projected, ProjectedWithPopulate, Query, ReferenceField, ReferenceMap, ScalarOps, Sort, SortField, StringOps, Where, WithReferences, } from '../content/index.js';
+export type { BoolOps, DateOps, Field, Fields, FilterFor, FimoPart, FimoPolymorphicReference, FimoReference, FimoRichTextContent, FimoSource, NullOnlyOps, NumberOps, Populate, Populated, PopulatedResult, Projected, ProjectedWithPopulate, Query, ReferenceField, ReferenceMap, ScalarOps, Sort, SortField, StringOps, Where, WithReferences, } from '../content/index.js';
+export type { FimoRichTextComponents, FimoRichTextMarkProps, FimoRichTextNodeProps, } from '../react/primitives/contracts.js';
 export { FimoProvider, useLabels } from './provider.js';
 export type { FimoProviderProps } from './provider.js';
 export type { Labels, LabelsSnapshot } from '../labels/core.js';

package/dist/runtime/next/facade.d.ts

@@ -1,4 +1,4 @@
-import type { ContentClientHandle } from '../content/client/types.js';
+import type { ContentClientHandle } from '../content/client/core-types.js';
 export type NextContentRegistry = Readonly<Record<string, ContentClientHandle>>;
 export interface CreateFimoOptions<TContent extends NextContentRegistry> {
     content: TContent;

package/dist/runtime/next/provider.js

@@ -17,7 +17,7 @@ export function useNextContentLocale(requestedLocale, defaultLocale) {
 }
 export function useLabels() {
     const context = useContext(FimoNextContext);
-    const locale = context.locale ?? nextClientContentRuntime.defaultLocale();
+    const locale = context.locale ?? nextClientContentRuntime.defaultLocale() ?? 'en';
     const snapshot = context.labels?.locale === locale
         ? context.labels
         : { locale, labels: {}, updatedAt: null };

package/dist/runtime/next/server-runtime.js

@@ -4,7 +4,7 @@ export const nextServerContentRuntime = {
         return requireContentApiUrl(process.env.FIMO_CONTENT_API_URL, 'FIMO_CONTENT_API_URL');
     },
     defaultLocale() {
-        return process.env.FIMO_DEFAULT_LOCALE?.trim() || 'en';
+        return process.env.FIMO_DEFAULT_LOCALE?.trim() || undefined;
     },
     headers(extra) {
         const headers = { ...extra };

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

@@ -1,4 +1,4 @@
-import type { CollectionContentClient, ContentClientConfig, SingletonContentClient } from '../content/client/types.js';
+import type { CollectionContentCore, ContentClientConfig, SingletonContentCore } from '../content/client/core-types.js';
 export { StaticImage } from '../react/primitives/renderers/StaticImage.js';
 export { Text } from './primitives/Text.js';
 export { Boolean, Date, Image, Json, RichText, Video } from './primitives/server.js';
@@ -7,12 +7,13 @@ export type { CreateFimoOptions, NextContentRegistry } from './facade.js';
 export { getLabels } from './labels.js';
 export type { GetLabelsOptions } from '../labels/fetch.js';
 export type { Labels, LabelsSnapshot } from '../labels/core.js';
+export type { FimoRichTextComponents, FimoRichTextMarkProps, FimoRichTextNodeProps, } from '../react/primitives/contracts.js';
 export declare function createContentClient<T extends {
     id: string;
-}, TInput extends object>(config: ContentClientConfig): CollectionContentClient<T, TInput>;
+}, TInput extends object>(config: ContentClientConfig): CollectionContentCore<T, TInput>;
 export declare function createSingletonClient<T extends {
     id: string;
-}, TInput extends object>(config: ContentClientConfig): SingletonContentClient<T, TInput>;
-export type { CollectionContentClient, InfiniteListResult, SingletonContentClient } from '../content/client/types.js';
+}, TInput extends object>(config: ContentClientConfig): SingletonContentCore<T, TInput>;
+export type { CollectionContentCore as CollectionContentClient, SingletonContentCore as SingletonContentClient, } from '../content/client/core-types.js';
 export * from '../content/index.js';
 //# sourceMappingURL=server.d.ts.map

package/dist/runtime/paths/get-fimo-paths.js

@@ -6,6 +6,7 @@ import { resolve } from 'node:path';
 import { getFimoLocales, localizeFimoPath } from '../i18n/locale.js';
 import { resolveSeoForPath } from '../seo/resolver.js';
 import { getConfigServer } from '../shared/fimo-config.server.js';
+import { resolveLocalRuntimeEnv } from '../shared/local-runtime-env.js';
 const isValidationBuild = !!process.env.FIMO_VALIDATION_BUILD;
 const MAX_FETCH_ATTEMPTS = 3;
 const RETRYABLE_FETCH_STATUSES = new Set([502, 503, 504]);
@@ -14,7 +15,9 @@ function readEnvValue(rootDir, key) {
     if (process.env[key]) {
         return process.env[key];
     }
-    for (const file of ['.env', '.env.local']) {
+    // `.env.local` first — every framework resolves it last, so it wins there
+    // and must win here too.
+    for (const file of ['.env.local', '.env']) {
         const filePath = resolve(rootDir, file);
         if (!existsSync(filePath)) {
             continue;
@@ -32,7 +35,9 @@ function readEnvValue(rootDir, key) {
     return undefined;
 }
 function resolveApiBaseUrl(rootDir) {
-    return readEnvValue(rootDir, 'VITE_API_URL') ?? readEnvValue(rootDir, 'VITE_API_URL_DEV');
+    return (readEnvValue(rootDir, 'VITE_API_URL') ??
+        readEnvValue(rootDir, 'VITE_API_URL_DEV') ??
+        resolveLocalRuntimeEnv({ cwd: rootDir })?.tenantApiUrl);
 }
 async function fetchEntries(baseUrl, schema, rootDir, locale) {
     const url = new URL(`${baseUrl.replace(/\/$/, '')}/entries/${schema}`);
@@ -41,7 +46,7 @@ async function fetchEntries(baseUrl, schema, rootDir, locale) {
         url.searchParams.set('limit', '1');
     }
     const headers = {};
-    const env = readEnvValue(rootDir, 'FIMO_ENV');
+    const env = readEnvValue(rootDir, 'FIMO_ENV') ?? resolveLocalRuntimeEnv({ cwd: rootDir })?.env;
     if (env) {
         headers['X-Fimo-Env'] = env;
     }

package/dist/runtime/preview/bridge.d.ts

@@ -0,0 +1,8 @@
+/** Preview communication exists only inside a Studio preview runtime. */
+export declare function isPreviewRuntimeEnabled(previewScriptUrl: unknown): previewScriptUrl is string;
+/**
+ * Accept application-owned paths while rejecting protocols, protocol-relative
+ * URLs, and backslash variants that URL parsers can normalize to another host.
+ */
+export declare function getSafePreviewNavigationPath(target: unknown, currentOrigin: string): string | null;
+//# sourceMappingURL=bridge.d.ts.map

package/dist/runtime/preview/bridge.js

@@ -0,0 +1,20 @@
+/** Preview communication exists only inside a Studio preview runtime. */
+export function isPreviewRuntimeEnabled(previewScriptUrl) {
+    return typeof previewScriptUrl === 'string' && previewScriptUrl.trim().length > 0;
+}
+/**
+ * Accept application-owned paths while rejecting protocols, protocol-relative
+ * URLs, and backslash variants that URL parsers can normalize to another host.
+ */
+export function getSafePreviewNavigationPath(target, currentOrigin) {
+    if (typeof target !== 'string' || !target.startsWith('/') || target.startsWith('//')) {
+        return null;
+    }
+    try {
+        const resolved = new URL(target, currentOrigin);
+        return resolved.origin === currentOrigin ? `${resolved.pathname}${resolved.search}${resolved.hash}` : null;
+    }
+    catch {
+        return null;
+    }
+}

package/dist/runtime/preview/location.d.ts

@@ -0,0 +1,23 @@
+export interface PreviewLocationLike {
+    pathname: string;
+    search?: string;
+    hash?: string;
+}
+export interface PreviewLocationChange {
+    /** Safe workspace focus value; query/hash state stays navigation-only. */
+    path: string;
+    /** Exact app location used to keep the parent's iframe URL in sync. */
+    navigationPath: string;
+}
+export interface PreviewBrowserContext {
+    readonly window: Pick<Window, 'location' | 'sessionStorage'>;
+    readonly document: Pick<Document, 'referrer'>;
+}
+/** Prefer the immediate embedding document over a potentially stale referrer. */
+export declare function resolvePreviewParentOrigin(referrer: string | undefined, ancestorOrigins: readonly string[] | undefined): string | null;
+/** Resolve and remember the trusted Studio origin across full-page navigation. */
+export declare function getPreviewParentOrigin(browser?: PreviewBrowserContext): string | null;
+/** Keep sandbox credentials and the iframe cache-buster out of app navigation state. */
+export declare function getPreviewLocationPath(location: PreviewLocationLike): string;
+export declare function getPreviewLocationChange(location: PreviewLocationLike): PreviewLocationChange;
+//# sourceMappingURL=location.d.ts.map

package/dist/runtime/preview/location.js

@@ -0,0 +1,93 @@
+const PREVIEW_INTERNAL_QUERY_PARAMS = new Set(['bl_preview_token', 'preview_token', 't']);
+const PREVIEW_PARENT_ORIGIN_STORAGE_KEY = 'fimo-preview-parent-origin';
+let rememberedPreviewParentOrigin;
+const getOrigin = (value) => {
+    if (!value) {
+        return null;
+    }
+    try {
+        const origin = new URL(value).origin;
+        return origin === 'null' ? null : origin;
+    }
+    catch {
+        return null;
+    }
+};
+/** Prefer the immediate embedding document over a potentially stale referrer. */
+export function resolvePreviewParentOrigin(referrer, ancestorOrigins) {
+    return getOrigin(ancestorOrigins?.[0]) ?? getOrigin(referrer);
+}
+/** Resolve and remember the trusted Studio origin across full-page navigation. */
+export function getPreviewParentOrigin(browser) {
+    const browserWindow = browser?.window ?? (typeof window === 'undefined' ? undefined : window);
+    const browserDocument = browser?.document ?? (typeof document === 'undefined' ? undefined : document);
+    if (!browserWindow) {
+        return null;
+    }
+    const storage = readSessionStorage(browserWindow);
+    const ancestorOrigin = getOrigin(browserWindow.location.ancestorOrigins?.[0]);
+    if (ancestorOrigin) {
+        rememberPreviewParentOrigin(ancestorOrigin, storage);
+        return ancestorOrigin;
+    }
+    const rememberedOrigin = readRememberedPreviewParentOrigin(storage);
+    if (rememberedOrigin) {
+        return rememberedOrigin;
+    }
+    const referrerOrigin = getOrigin(browserDocument?.referrer);
+    if (referrerOrigin) {
+        rememberPreviewParentOrigin(referrerOrigin, storage);
+    }
+    return referrerOrigin;
+}
+function readSessionStorage(browserWindow) {
+    try {
+        return browserWindow.sessionStorage;
+    }
+    catch {
+        return undefined;
+    }
+}
+function readRememberedPreviewParentOrigin(storage) {
+    if (rememberedPreviewParentOrigin !== undefined) {
+        return rememberedPreviewParentOrigin;
+    }
+    if (!storage) {
+        rememberedPreviewParentOrigin = null;
+        return null;
+    }
+    try {
+        rememberedPreviewParentOrigin = getOrigin(storage.getItem(PREVIEW_PARENT_ORIGIN_STORAGE_KEY) ?? undefined);
+    }
+    catch {
+        rememberedPreviewParentOrigin = null;
+    }
+    return rememberedPreviewParentOrigin;
+}
+function rememberPreviewParentOrigin(origin, storage) {
+    rememberedPreviewParentOrigin = origin;
+    if (!storage) {
+        return;
+    }
+    try {
+        storage.setItem(PREVIEW_PARENT_ORIGIN_STORAGE_KEY, origin);
+    }
+    catch {
+        // Storage availability must not block the preview message channel.
+    }
+}
+/** Keep sandbox credentials and the iframe cache-buster out of app navigation state. */
+export function getPreviewLocationPath(location) {
+    const search = new URLSearchParams(location.search ?? '');
+    for (const key of PREVIEW_INTERNAL_QUERY_PARAMS) {
+        search.delete(key);
+    }
+    const query = search.toString();
+    return `${location.pathname}${query ? `?${query}` : ''}${location.hash ?? ''}`;
+}
+export function getPreviewLocationChange(location) {
+    return {
+        path: location.pathname,
+        navigationPath: getPreviewLocationPath(location),
+    };
+}

package/dist/runtime/preview/routes.d.ts

@@ -0,0 +1,10 @@
+import type { FimoConfig, FimoRouteConfig } from '../shared/fimo-config.types.js';
+export interface PreviewRoute {
+    id: string;
+    name: string;
+    path: string;
+    params?: FimoRouteConfig['params'];
+}
+/** Convert the optional Studio route catalog into the preview protocol shape. */
+export declare function getConfigPreviewRoutes(config: Pick<FimoConfig, 'routes'>): PreviewRoute[];
+//# sourceMappingURL=routes.d.ts.map

package/dist/runtime/preview/routes.js

@@ -0,0 +1,29 @@
+const titleCase = (value) => value
+    .replace(/[_-]+/g, ' ')
+    .replace(/([a-z])([A-Z])/g, '$1 $2')
+    .split(/\s+/)
+    .filter(Boolean)
+    .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+    .join(' ');
+function fallbackRouteName(id, path) {
+    if (path === '/') {
+        return 'Home';
+    }
+    return titleCase(id || path.replace(/^\//, '').split('/')[0]);
+}
+/** Convert the optional Studio route catalog into the preview protocol shape. */
+export function getConfigPreviewRoutes(config) {
+    return Object.entries(config.routes ?? {}).flatMap(([id, route]) => {
+        if (!route.path) {
+            return [];
+        }
+        return [
+            {
+                id,
+                name: route.label?.trim() || fallbackRouteName(id, route.path),
+                path: route.path,
+                ...(route.params ? { params: route.params } : {}),
+            },
+        ];
+    });
+}

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

@@ -5,8 +5,11 @@ export { Date } from '../react/primitives/editable/Date.js';
 export { Boolean } from '../react/primitives/editable/Boolean.js';
 export { Json } from '../react/primitives/editable/Json.js';
 export { RichText } from '../react/primitives/editable/RichText.js';
+export { Label } from '../vite/Label.js';
+export type { LabelProps } from '../vite/Label.js';
 export { useLabels, useTranslations } from '../vite/translations.js';
-export { FimoString, FimoDate, FimoMedia, FimoBoolean, FimoRichText, type FimoPolymorphicReference, type FimoReference, type FimoSource, type FimoPart, type FimoRichTextContent, type FimoRichTextNodeProps, type FimoRichTextMarkProps, type FimoRichTextComponents, FIMO_SOURCE, FIMO_PARTS, isFimoString, isFimoDate, hasFimoSource, getFimoSource, getFimoParts, fimo, } from './lib/index.js';
+export { FimoString, FimoDate, FimoMedia, FimoBoolean, FimoRichText, type FimoPolymorphicReference, type FimoReference, type FimoSource, type FimoPart, type FimoRichTextContent, FIMO_SOURCE, FIMO_PARTS, isFimoString, isFimoDate, hasFimoSource, getFimoSource, getFimoParts, fimo, } from './lib/index.js';
+export type { FimoRichTextComponents, FimoRichTextMarkProps, FimoRichTextNodeProps, } from '../react/primitives/contracts.js';
 export { useFimoLiveValue } from '../react/useFimoLiveValue.js';
 export type { BoolOps, DateOps, Field, Fields, FilterFor, NullOnlyOps, NumberOps, Populate, Populated, PopulatedResult, Projected, ProjectedWithPopulate, Query, ReferenceField, ReferenceMap, ScalarOps, Sort, SortField, StringOps, WithReferences, Where, } from './lib/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/runtime/primitives/index.js

@@ -9,6 +9,7 @@ export { Boolean } from '../react/primitives/editable/Boolean.js';
 export { Json } from '../react/primitives/editable/Json.js';
 export { RichText } from '../react/primitives/editable/RichText.js';
 // Labels
+export { Label } from '../vite/Label.js';
 export { useLabels, useTranslations } from '../vite/translations.js';
 // Primitives & utilities
 export { FimoString, FimoDate, FimoMedia, FimoBoolean, FimoRichText, FIMO_SOURCE, FIMO_PARTS, isFimoString, isFimoDate, hasFimoSource, getFimoSource, getFimoParts, fimo, } from './lib/index.js';

package/dist/runtime/primitives/lib/image-optimization.d.ts

@@ -1,4 +1,3 @@
-import type { ComponentPropsWithoutRef } from 'react';
 /** Default host suffixes eligible for Cloudflare Image Resizing optimization. */
 export declare const DEFAULT_IMAGE_HOST_SUFFIXES: readonly ['.fimo.team', '.fimo.ai', '.fimo.site'];
 /**
@@ -15,6 +14,7 @@ export declare const DEFAULT_IMAGE_DPRS: readonly [1, 2];
  */
 export declare const IMAGE_FIT_VALUES: readonly ['scale-down', 'contain', 'cover', 'crop', 'pad'];
 export type ImageFit = (typeof IMAGE_FIT_VALUES)[number];
+export type ImageObjectFit = 'contain' | 'cover' | 'scale-down';
 /** Clamp quality to valid range [1, 100], defaulting to 85. */
 export declare function clampQuality(quality: number | undefined): number;
 /**
@@ -24,7 +24,7 @@ export declare function resolveFit(fit: ImageFit | undefined): ImageFit;
 /**
  * Map Cloudflare fit mode to CSS object-fit.
  */
-export declare function toObjectFit(fit: ImageFit): NonNullable<ComponentPropsWithoutRef<'img'>['style']>['objectFit'];
+export declare function toObjectFit(fit: ImageFit): ImageObjectFit;
 /** Parse value to positive integer, or undefined if invalid. */
 export declare function toPositiveInt(value: string | number | undefined): number | undefined;
 /** Check if URL can be optimized (valid http(s) URL on allowed host). */
@@ -56,4 +56,29 @@ export declare function computeImageOptimizationConfig(options: {
     fit: ImageFit;
     hostSuffixes?: readonly string[];
 }): ImageOptimizationConfig;
+export interface ImagePresentationOptions {
+    src: string;
+    alt?: string;
+    mediaWidth?: number;
+    mediaHeight?: number;
+    quality?: number;
+    fit?: ImageFit;
+    unoptimized?: boolean;
+    overrideSrc?: string;
+    width?: string | number;
+    height?: string | number;
+    sizes?: string;
+    srcSet?: string;
+    hostSuffixes?: readonly string[];
+}
+export interface ImagePresentation {
+    src: string;
+    alt: string | undefined;
+    width: number | undefined;
+    height: number | undefined;
+    sizes: string | undefined;
+    srcSet: string | undefined;
+    objectFit: ImageObjectFit;
+}
+export declare function resolveImagePresentation(options: ImagePresentationOptions): ImagePresentation;
 //# sourceMappingURL=image-optimization.d.ts.map

package/dist/runtime/primitives/lib/image-optimization.js

@@ -181,3 +181,43 @@ export function computeImageOptimizationConfig(options) {
         transformDpr: renderWidth ? DEFAULT_IMAGE_DPRS[DEFAULT_IMAGE_DPRS.length - 1] : undefined,
     };
 }
+export function resolveImagePresentation(options) {
+    const quality = clampQuality(options.quality);
+    const fit = resolveFit(options.fit);
+    const requestedWidth = toPositiveInt(options.width);
+    const requestedHeight = toPositiveInt(options.height);
+    const width = requestedWidth ?? options.mediaWidth;
+    const height = requestedHeight ?? options.mediaHeight;
+    const hasSizes = typeof options.sizes === 'string' && options.sizes.trim().length > 0;
+    const hasSizingHint = hasSizes || requestedWidth !== undefined || requestedHeight !== undefined;
+    const shouldOptimize = options.unoptimized !== true && isOptimizableFimoUrl(options.src, options.hostSuffixes) && hasSizingHint;
+    const { generatedSrcSet, transformWidth, transformDpr } = computeImageOptimizationConfig({
+        shouldOptimize,
+        hasSizesAttr: hasSizes,
+        srcSetOverride: options.srcSet,
+        originalSrc: options.src,
+        mediaWidth: options.mediaWidth,
+        renderWidth: width,
+        quality,
+        fit,
+        hostSuffixes: options.hostSuffixes,
+    });
+    const optimizedSrc = shouldOptimize
+        ? buildOptimizedUrl(options.src, {
+            width: transformWidth,
+            quality,
+            fit,
+            dpr: transformDpr,
+            hostSuffixes: options.hostSuffixes,
+        })
+        : options.src;
+    return {
+        src: options.overrideSrc ?? optimizedSrc,
+        alt: options.alt,
+        width,
+        height,
+        sizes: options.sizes,
+        srcSet: options.srcSet ?? generatedSrcSet,
+        objectFit: toObjectFit(fit),
+    };
+}

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

@@ -1,4 +1,4 @@
-export { FimoString, FimoDate, FimoMedia, FimoBoolean, FimoRichText, type FimoPolymorphicReference, type FimoReference, type FimoSource, type FimoPart, type FimoRichTextContent, type FimoRichTextNodeProps, type FimoRichTextMarkProps, type FimoRichTextComponents, FIMO_SOURCE, FIMO_PARTS, isFimoString, isFimoDate, hasFimoSource, getFimoSource, getFimoParts, } from './primitives.js';
+export { FimoString, FimoDate, FimoMedia, FimoBoolean, FimoRichText, type FimoPolymorphicReference, type FimoReference, type FimoSource, type FimoPart, type FimoRichTextContent, FIMO_SOURCE, FIMO_PARTS, isFimoString, isFimoDate, hasFimoSource, getFimoSource, getFimoParts, } from './primitives.js';
 export { fimo } from './template.js';
 export type { BoolOps, DateOps, Field, Fields, FilterFor, NullOnlyOps, NumberOps, Populate, Populated, PopulatedResult, ProjectedWithPopulate, Projected, Query, ReferenceField, ReferenceMap, ScalarOps, Sort, SortField, StringOps, Where, WithReferences, } from './query.js';
 //# sourceMappingURL=index.d.ts.map