@wildo-ai/presets-components 1.0.1

package/dist/esm/components/data-display/formatters/display-field-file.js

@@ -0,0 +1,240 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * DisplayFieldFile Component
+ *
+ * Root display component for file fields. Acts as both:
+ * 1. Metadata fetcher — loads file metadata from server via authenticated httpOperations
+ * 2. Nature router — delegates rendering to nature-specific display components
+ *
+ * Nature routing priority:
+ * 1. Schema metadata `fileConfig.nature` (explicit, from z_file({ nature: FileNature.IMAGE }))
+ * 2. Fetched metadata MIME type detection (from server response)
+ * 3. Generic file card (fallback for unknown types / archives)
+ *
+ * For multiple images → gallery display. For mixed multiple → individual cards.
+ *
+ * Nature-specific sub-components are imported directly within this preset.
+ * Custom apps can override the entire file display by registering a new preset
+ * for LOW_LEVEL_DISPLAY_FIELD_FILE, or override individual nature renderers
+ * by registering for LOW_LEVEL_DISPLAY_FIELD_FILE_IMAGE etc. at the wrapper level.
+ */
+import * as React from "react";
+import { Text, Skeleton, DisplayFieldFileImage, DisplayFieldFileVideo, DisplayFieldFileAudio, DisplayFieldFileDocument, DisplayFieldFileGallery, useIconRegistry, StandardIconReference, IconSize, useI18n, } from "@wildo-ai/saas-frontend-lib";
+import { FrontendComponentType } from "@wildo-ai/presets-components-models";
+import { FileDisplayNature, resolveFileDisplayNature, getFileMetadata as getFileSchemaMetadata, formatFileSize, } from "@wildo-ai/zod-decorators";
+/** Type guard to check if value is a single file */
+function isSingleFileValue(value) {
+    return value !== null && value !== undefined && 'fileId' in value;
+}
+/** Type guard to check if value is multiple files */
+function isMultipleFileValue(value) {
+    return value !== null && value !== undefined && 'fileIds' in value;
+}
+function getNeutralFileDisplayLabel(value, t) {
+    if (isSingleFileValue(value)) {
+        return t('File attached') ?? 'File attached';
+    }
+    const fileCount = value.fileIds.length;
+    const translatedMultipleLabel = t('Files attached', { count: fileCount });
+    return fileCount > 1
+        ? (translatedMultipleLabel && translatedMultipleLabel !== 'Files attached'
+            ? translatedMultipleLabel
+            : `${fileCount} files attached`)
+        : (t('File attached') ?? 'File attached');
+}
+/**
+ * DisplayFieldFile component
+ *
+ * Renders a file reference with:
+ * - Filename with link
+ * - File size
+ * - File type icon/badge
+ * - Download option
+ */
+function DisplayFieldFile({ schema, value, className, endpoints, showSize = true, showType = true, showDownload = true, httpOperations, }) {
+    const { renderIcon } = useIconRegistry();
+    const { t, tComponent, isReady } = useI18n({ component: [FrontendComponentType.LOW_LEVEL_FORM_FIELD, FrontendComponentType.LOW_LEVEL_FORM_FIELD_FILE] });
+    const fileSchemaMetadata = getFileSchemaMetadata(schema);
+    const isMultiple = fileSchemaMetadata?.multiple ?? false;
+    // State for loaded metadata (single file or array of files)
+    const [metadataEntries, setMetadataEntries] = React.useState([]);
+    const [loading, setLoading] = React.useState(false);
+    const [error, setError] = React.useState(null);
+    // Get file IDs from value (handles both single and multiple)
+    const fileIds = React.useMemo(() => {
+        if (isSingleFileValue(value)) {
+            return [value.fileId];
+        }
+        if (isMultipleFileValue(value)) {
+            return value.fileIds;
+        }
+        return [];
+    }, [value]);
+    // Stable key for dependency tracking (avoids inline .join() in useEffect deps)
+    const fileIdsKey = React.useMemo(() => fileIds.join(','), [fileIds]);
+    // Fetch metadata when value changes
+    React.useEffect(() => {
+        // Derive IDs from the key to keep closure and dependency in sync
+        const currentFileIds = fileIdsKey ? fileIdsKey.split(',') : [];
+        if (currentFileIds.length === 0 || !endpoints.getMetadata) {
+            setMetadataEntries([]);
+            return;
+        }
+        let cancelled = false;
+        setLoading(true);
+        setError(null);
+        const fetchAllMetadata = async () => {
+            try {
+                const settledResults = await Promise.allSettled(currentFileIds.map(async (fileId) => {
+                    const metadataUrl = `${endpoints.getMetadata}/${encodeURIComponent(fileId)}/metadata`;
+                    // Use authenticated HTTP operations when available (injected by engine wrapper).
+                    // Falls back to raw fetch for standalone usage without resource context.
+                    if (httpOperations) {
+                        return httpOperations.get(metadataUrl);
+                    }
+                    // Fallback: raw fetch with cookie credentials (standalone usage)
+                    const response = await fetch(metadataUrl, { credentials: 'include' });
+                    if (!response.ok) {
+                        throw new Error('Failed to fetch file metadata');
+                    }
+                    return response.json();
+                }));
+                const successfulEntries = settledResults.flatMap((result, index) => (result.status === 'fulfilled'
+                    ? [{ fileId: currentFileIds[index], metadata: result.value }]
+                    : []));
+                if (!cancelled) {
+                    setMetadataEntries(successfulEntries);
+                    setError(successfulEntries.length === 0 && settledResults.some(result => result.status === 'rejected')
+                        ? (t('Unable to load file details') ?? 'Unable to load file details')
+                        : null);
+                }
+            }
+            finally {
+                if (!cancelled) {
+                    setLoading(false);
+                }
+            }
+        };
+        fetchAllMetadata();
+        return () => { cancelled = true; };
+    }, [fileIdsKey, endpoints.getMetadata, httpOperations]);
+    // =========================================================================
+    // NATURE DETECTION (via shared utility from zod-decorators)
+    // =========================================================================
+    const schemaNature = fileSchemaMetadata?.nature;
+    // =========================================================================
+    // FILE ICON MAPPING (for generic card fallback)
+    // =========================================================================
+    const getFileIconRef = (mimeType) => {
+        if (!mimeType)
+            return StandardIconReference.FILE;
+        if (mimeType.startsWith('image/'))
+            return StandardIconReference.FILE_IMAGE;
+        if (mimeType.startsWith('video/'))
+            return StandardIconReference.FILE_VIDEO;
+        if (mimeType.startsWith('audio/'))
+            return StandardIconReference.FILE_AUDIO;
+        if (mimeType === 'application/pdf')
+            return StandardIconReference.FILE_TEXT;
+        if (mimeType.includes('spreadsheet') || mimeType.includes('excel'))
+            return StandardIconReference.FILE_SPREADSHEET;
+        if (mimeType.includes('presentation') || mimeType.includes('powerpoint'))
+            return StandardIconReference.FILE_PRESENTATION;
+        if (mimeType.includes('document') || mimeType.includes('word'))
+            return StandardIconReference.FILE_TEXT;
+        if (mimeType.includes('zip') || mimeType.includes('rar') || mimeType.includes('7z'))
+            return StandardIconReference.FILE_ARCHIVE;
+        return StandardIconReference.FILE;
+    };
+    // =========================================================================
+    // NATURE-AWARE RENDERING
+    // =========================================================================
+    /**
+     * Render a single file with nature-aware component selection.
+     * Delegates to the appropriate nature-specific display preset,
+     * falling back to the generic file card for unknown/archive types.
+     */
+    const renderNatureAwareFile = (metadata, fileId) => {
+        // Determine display nature: schema-declared > MIME-detected > generic
+        const nature = resolveFileDisplayNature(schemaNature, metadata.mimeType);
+        switch (nature) {
+            case FileDisplayNature.IMAGE:
+                return (_jsx(DisplayFieldFileImage, { metadata: metadata, fileId: fileId, showDownload: showDownload, showSize: showSize }, fileId));
+            case FileDisplayNature.VIDEO:
+                return (_jsx(DisplayFieldFileVideo, { metadata: metadata, fileId: fileId, showDownload: showDownload, showSize: showSize }, fileId));
+            case FileDisplayNature.AUDIO:
+                return (_jsx(DisplayFieldFileAudio, { metadata: metadata, fileId: fileId, showDownload: showDownload, showSize: showSize }, fileId));
+            case FileDisplayNature.DOCUMENT:
+                return (_jsx(DisplayFieldFileDocument, { metadata: metadata, fileId: fileId, showDownload: showDownload, showSize: showSize }, fileId));
+            default:
+                // Generic file card (archives, unknown types, etc.)
+                return renderGenericFileItem(metadata, fileId);
+        }
+    };
+    /** Render a generic file card (used for archives, unknown types, and as fallback) */
+    const renderGenericFileItem = (metadata, fileId) => {
+        const fileIconRef = getFileIconRef(metadata.mimeType);
+        return (_jsxs("div", { className: "flex items-center gap-group p-card-sm rounded-md border bg-muted/30", children: [_jsx("span", { "aria-hidden": "true", children: renderIcon(fileIconRef, { size: IconSize.LG, className: "text-muted-foreground" }) }), _jsxs("div", { className: "flex-1 min-w-0", children: [_jsx("div", { className: "flex items-center gap-element", children: metadata.url && showDownload ? (_jsx("a", { href: metadata.url, target: "_blank", rel: "noopener noreferrer", className: "font-medium text-primary hover:underline truncate", children: metadata.filename })) : (_jsx(Text, { className: "font-medium truncate", children: metadata.filename })) }), _jsxs("div", { className: "flex items-center gap-group text-xs text-muted-foreground mt-0.5", children: [showSize && metadata.size !== undefined && (_jsx("span", { children: formatFileSize(metadata.size) })), showType && metadata.mimeType && (_jsx("span", { className: "uppercase", children: metadata.extension || metadata.mimeType.split('/').pop() }))] })] }), metadata.thumbnailUrl && metadata.mimeType?.startsWith('image/') && (_jsx("img", { src: metadata.thumbnailUrl, alt: metadata.filename, className: "h-12 w-12 rounded object-cover" }))] }, fileId));
+    };
+    // =========================================================================
+    // MULTI-FILE GALLERY DETECTION
+    // =========================================================================
+    /**
+     * Check if multiple files should be rendered as a gallery.
+     * Conditions: multiple mode + all files are images (by schema nature or MIME detection).
+     */
+    const shouldRenderGallery = React.useMemo(() => {
+        if (metadataEntries.length <= 1)
+            return false;
+        // Schema declares IMAGE nature — always gallery for multiple
+        if (resolveFileDisplayNature(schemaNature) === FileDisplayNature.IMAGE)
+            return true;
+        // All fetched files are images — auto-gallery
+        return metadataEntries.every(({ metadata }) => metadata.mimeType?.startsWith('image/'));
+    }, [metadataEntries, schemaNature]);
+    // =========================================================================
+    // RENDER
+    // =========================================================================
+    const renderValue = () => {
+        // Handle null/undefined
+        if (value === null || value === undefined) {
+            return _jsxs(_Fragment, { children: [_jsx(Text, { className: "text-muted-foreground italic", "aria-hidden": "true", children: "\u2014" }), _jsx("span", { className: "sr-only", children: tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD, 'noValue') })] });
+        }
+        // Handle invalid value
+        if (typeof value !== 'object' || (!('fileId' in value) && !('fileIds' in value))) {
+            return _jsx(Text, { className: "text-muted-foreground italic", children: "Invalid" });
+        }
+        // Loading state
+        if (loading) {
+            const loadingLabel = t('Loading file metadata') ?? 'Loading file metadata';
+            return (_jsxs("div", { className: "flex items-center gap-group p-card-sm rounded-md border bg-muted/30", role: "status", "aria-label": loadingLabel, children: [_jsx(Skeleton, { className: "h-6 w-6 rounded" }), _jsxs("div", { className: "flex-1 min-w-0 space-y-1.5", children: [_jsx(Skeleton, { className: "h-4 w-36" }), _jsx(Skeleton, { className: "h-3 w-20" })] })] }));
+        }
+        // Error state
+        if (error) {
+            return (_jsxs("div", { className: "flex items-center gap-element text-destructive", role: "alert", children: [_jsx("span", { "aria-hidden": "true", children: renderIcon(StandardIconReference.WARNING, { size: IconSize.SM }) }), _jsx(Text, { className: "text-sm", children: error })] }));
+        }
+        // No metadata available yet — keep the UI neutral instead of exposing
+        // internal file identifiers while metadata is loading or unavailable.
+        if (metadataEntries.length === 0) {
+            return (_jsxs("div", { className: "flex items-center gap-element text-muted-foreground", children: [_jsx("span", { "aria-hidden": "true", children: renderIcon(StandardIconReference.FILE, { size: IconSize.SM }) }), _jsx(Text, { className: "text-sm", children: getNeutralFileDisplayLabel(value, t) })] }));
+        }
+        // Multiple files — gallery or individual cards
+        if (isMultiple || metadataEntries.length > 1) {
+            // Gallery for all-image collections
+            if (shouldRenderGallery) {
+                return (_jsx(DisplayFieldFileGallery, { metadataList: metadataEntries.map(({ metadata }) => metadata), fileIds: metadataEntries.map(({ fileId }) => fileId), showDownload: showDownload }));
+            }
+            // Mixed content or non-image multiple — individual nature-aware cards
+            return (_jsx("div", { className: "space-y-item", children: metadataEntries.map(({ metadata, fileId }) => renderNatureAwareFile(metadata, fileId)) }));
+        }
+        // Single file — nature-aware rendering
+        return renderNatureAwareFile(metadataEntries[0].metadata, metadataEntries[0].fileId);
+    };
+    // Label/description rendering is handled by the parent DisplayField (FIELD-01)
+    return _jsx("div", { className: className, children: renderValue() });
+}
+;
+DisplayFieldFile.displayName = "DisplayFieldFile";
+export { DisplayFieldFile };
+//# sourceMappingURL=display-field-file.js.map

package/dist/esm/components/data-display/formatters/display-field-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"display-field-file.js","sourceRoot":"","sources":["../../../../../src/components/data-display/formatters/display-field-file.tsx"],"names":[],"mappings":"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"}

package/dist/esm/components/data-display/formatters/display-field-format.utils.d.ts

@@ -0,0 +1,43 @@
+/**
+ * DisplayFieldFormatUtils
+ *
+ * Singleton class with static formatting utilities for display field formatters.
+ * Consolidates common formatting functions used across number, bigdecimal,
+ * and other display field components to avoid duplication.
+ */
+export declare class DisplayFieldFormatUtils {
+    private constructor();
+    /**
+     * Format bytes to human-readable string.
+     *
+     * @param bytes - The byte value to format
+     * @param decimals - Number of decimal places (default: 2)
+     * @returns Formatted string (e.g., "1.5 MB")
+     */
+    static formatBytes(bytes: number, decimals?: number): string;
+    /**
+     * Format number as ordinal with locale awareness.
+     *
+     * Uses `Intl.PluralRules` for category detection and a per-locale suffix map
+     * for correct ordinal rendering. Locales without an explicit suffix map fall
+     * back to the dot convention (e.g., "3." — standard in German, Swedish,
+     * Norwegian, Dutch, and most European languages).
+     *
+     * @param n - The number to format
+     * @param locale - BCP 47 locale string (default: 'en')
+     * @returns Formatted ordinal string (e.g., "1st", "1er", "3.")
+     */
+    static formatOrdinal(n: number, locale?: string): string;
+    /**
+     * Truncate a decimal string to a specified number of decimal places.
+     * Operates purely on the string representation — no floating-point conversion,
+     * preserving full precision for BigDecimal values.
+     *
+     * @param value - The decimal string (e.g., "123.456789012345678901234")
+     * @param decimalPlaces - Number of decimal places to keep
+     * @param trailingZeros - Whether to pad with trailing zeros
+     * @returns Truncated decimal string
+     */
+    static truncateDecimalString(value: string, decimalPlaces: number, trailingZeros: boolean): string;
+}
+//# sourceMappingURL=display-field-format.utils.d.ts.map

package/dist/esm/components/data-display/formatters/display-field-format.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"display-field-format.utils.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/formatters/display-field-format.utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAwBH,qBAAa,uBAAuB;IAElC,OAAO;IAIP;;;;;;OAMG;IACH,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAI,GAAG,MAAM;IAavD;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,GAAE,MAAa,GAAG,MAAM;IAiB9D;;;;;;;;;OASG;IACH,MAAM,CAAC,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,GAAG,MAAM;CA8BnG"}

package/dist/esm/components/data-display/formatters/display-field-format.utils.js

@@ -0,0 +1,113 @@
+/**
+ * DisplayFieldFormatUtils
+ *
+ * Singleton class with static formatting utilities for display field formatters.
+ * Consolidates common formatting functions used across number, bigdecimal,
+ * and other display field components to avoid duplication.
+ */
+/**
+ * Per-locale ordinal suffix maps.
+ *
+ * Each entry maps Intl.PluralRules ordinal categories to locale-specific suffixes.
+ * Languages not listed fall back to the dot convention (e.g., "1." — universally
+ * understood in most European languages).
+ *
+ * References:
+ * - English: 1st, 2nd, 3rd, 4th ...
+ * - French: 1er, 2e, 3e ... (only "1er", rest are "e")
+ * - German/Swedish/most Romance: 1., 2., 3. (dot suffix)
+ * - Spanish: 1.º, 2.º, 3.º
+ */
+const ORDINAL_SUFFIX_MAPS = {
+    en: { one: 'st', two: 'nd', few: 'rd', other: 'th' },
+    fr: { one: 'er', other: 'e' },
+    es: { other: '.º' },
+    it: { other: '°' },
+    pt: { other: '.º' },
+    // dot-suffix languages are handled by the fallback
+};
+export class DisplayFieldFormatUtils {
+    constructor() {
+        // Prevent instantiation — static-only class
+    }
+    /**
+     * Format bytes to human-readable string.
+     *
+     * @param bytes - The byte value to format
+     * @param decimals - Number of decimal places (default: 2)
+     * @returns Formatted string (e.g., "1.5 MB")
+     */
+    static formatBytes(bytes, decimals = 2) {
+        if (!Number.isFinite(bytes))
+            return '—';
+        if (bytes === 0)
+            return '0 B';
+        if (bytes < 0)
+            return '-' + DisplayFieldFormatUtils.formatBytes(Math.abs(bytes), decimals);
+        const k = 1024;
+        const dm = decimals < 0 ? 0 : decimals;
+        const sizes = ['B', 'KB', 'MB', 'GB', 'TB', 'PB'];
+        const i = Math.floor(Math.log(bytes) / Math.log(k));
+        return `${parseFloat((bytes / Math.pow(k, i)).toFixed(dm))} ${sizes[i]}`;
+    }
+    /**
+     * Format number as ordinal with locale awareness.
+     *
+     * Uses `Intl.PluralRules` for category detection and a per-locale suffix map
+     * for correct ordinal rendering. Locales without an explicit suffix map fall
+     * back to the dot convention (e.g., "3." — standard in German, Swedish,
+     * Norwegian, Dutch, and most European languages).
+     *
+     * @param n - The number to format
+     * @param locale - BCP 47 locale string (default: 'en')
+     * @returns Formatted ordinal string (e.g., "1st", "1er", "3.")
+     */
+    static formatOrdinal(n, locale = 'en') {
+        // Extract base language from locale (e.g., 'en-US' → 'en')
+        const baseLang = locale.split('-')[0].toLowerCase();
+        const suffixMap = ORDINAL_SUFFIX_MAPS[baseLang];
+        if (suffixMap) {
+            const pr = new Intl.PluralRules(locale, { type: 'ordinal' });
+            const rule = pr.select(n);
+            const suffix = suffixMap[rule] ?? suffixMap['other'] ?? '.';
+            return `${n}${suffix}`;
+        }
+        // Fallback: dot convention (universally understood in most languages)
+        return `${n}.`;
+    }
+    /**
+     * Truncate a decimal string to a specified number of decimal places.
+     * Operates purely on the string representation — no floating-point conversion,
+     * preserving full precision for BigDecimal values.
+     *
+     * @param value - The decimal string (e.g., "123.456789012345678901234")
+     * @param decimalPlaces - Number of decimal places to keep
+     * @param trailingZeros - Whether to pad with trailing zeros
+     * @returns Truncated decimal string
+     */
+    static truncateDecimalString(value, decimalPlaces, trailingZeros) {
+        const dotIndex = value.indexOf('.');
+        if (dotIndex === -1) {
+            // No decimal point — integer
+            if (trailingZeros && decimalPlaces > 0) {
+                return `${value}.${'0'.repeat(decimalPlaces)}`;
+            }
+            return value;
+        }
+        const integerPart = value.slice(0, dotIndex);
+        const fractionalPart = value.slice(dotIndex + 1);
+        if (decimalPlaces === 0) {
+            return integerPart;
+        }
+        // Truncate (not round) to preserve BigDecimal semantics
+        const truncated = fractionalPart.slice(0, decimalPlaces);
+        if (trailingZeros) {
+            const padded = truncated.padEnd(decimalPlaces, '0');
+            return `${integerPart}.${padded}`;
+        }
+        // Remove trailing zeros
+        const trimmed = truncated.replace(/0+$/, '');
+        return trimmed ? `${integerPart}.${trimmed}` : integerPart;
+    }
+}
+//# sourceMappingURL=display-field-format.utils.js.map

package/dist/esm/components/data-display/formatters/display-field-format.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"display-field-format.utils.js","sourceRoot":"","sources":["../../../../../src/components/data-display/formatters/display-field-format.utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;;GAYG;AACH,MAAM,mBAAmB,GAA2C;IAClE,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE;IACpD,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE;IAC7B,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE;IACnB,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE;IAClB,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE;IACnB,mDAAmD;CACpD,CAAA;AAED,MAAM,OAAO,uBAAuB;IAElC;QACE,4CAA4C;IAC9C,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,WAAW,CAAC,KAAa,EAAE,QAAQ,GAAG,CAAC;QAC5C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,GAAG,CAAA;QACvC,IAAI,KAAK,KAAK,CAAC;YAAE,OAAO,KAAK,CAAA;QAC7B,IAAI,KAAK,GAAG,CAAC;YAAE,OAAO,GAAG,GAAG,uBAAuB,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,CAAA;QAE1F,MAAM,CAAC,GAAG,IAAI,CAAA;QACd,MAAM,EAAE,GAAG,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAA;QACtC,MAAM,KAAK,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;QAEjD,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;QACnD,OAAO,GAAG,UAAU,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAA;IAC1E,CAAC;IAED;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,aAAa,CAAC,CAAS,EAAE,SAAiB,IAAI;QACnD,2DAA2D;QAC3D,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAA;QAEnD,MAAM,SAAS,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAA;QAE/C,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,EAAE,GAAG,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAA;YAC5D,MAAM,IAAI,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;YACzB,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC,OAAO,CAAC,IAAI,GAAG,CAAA;YAC3D,OAAO,GAAG,CAAC,GAAG,MAAM,EAAE,CAAA;QACxB,CAAC;QAED,sEAAsE;QACtE,OAAO,GAAG,CAAC,GAAG,CAAA;IAChB,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,qBAAqB,CAAC,KAAa,EAAE,aAAqB,EAAE,aAAsB;QACvF,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QAEnC,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC;YACpB,6BAA6B;YAC7B,IAAI,aAAa,IAAI,aAAa,GAAG,CAAC,EAAE,CAAC;gBACvC,OAAO,GAAG,KAAK,IAAI,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAA;YAChD,CAAC;YACD,OAAO,KAAK,CAAA;QACd,CAAC;QAED,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAA;QAC5C,MAAM,cAAc,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAA;QAEhD,IAAI,aAAa,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,WAAW,CAAA;QACpB,CAAC;QAED,wDAAwD;QACxD,MAAM,SAAS,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,aAAa,CAAC,CAAA;QAExD,IAAI,aAAa,EAAE,CAAC;YAClB,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,aAAa,EAAE,GAAG,CAAC,CAAA;YACnD,OAAO,GAAG,WAAW,IAAI,MAAM,EAAE,CAAA;QACnC,CAAC;QAED,wBAAwB;QACxB,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;QAC5C,OAAO,OAAO,CAAC,CAAC,CAAC,GAAG,WAAW,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC,WAAW,CAAA;IAC5D,CAAC;CACF"}

package/dist/esm/components/data-display/formatters/display-field-money.d.ts

@@ -0,0 +1,19 @@
+/**
+ * DisplayFieldMoney Component
+ *
+ * Displays a money value with proper formatting.
+ * Converts bigint amount to decimal based on decimals field.
+ */
+import * as React from "react";
+import type { DisplayFieldMoneyProps } from '@wildo-ai/saas-frontend-lib';
+/**
+ * DisplayFieldMoney component
+ *
+ * Renders a money value with locale-aware formatting via Intl.NumberFormat:
+ * - Converts integer amount to decimal
+ * - Locale-aware symbol position & separators
+ * - Negative value styling (text-destructive)
+ */
+declare function DisplayFieldMoney({ schema, value, className, showSymbol, symbolPosition, showCurrencyCode, locale, }: DisplayFieldMoneyProps): React.JSX.Element;
+export { DisplayFieldMoney };
+//# sourceMappingURL=display-field-money.d.ts.map

package/dist/esm/components/data-display/formatters/display-field-money.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"display-field-money.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/formatters/display-field-money.tsx"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAS9B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAA;AAEzE;;;;;;;GAOG;AACH,iBAAS,iBAAiB,CAAC,EACzB,MAAM,EACN,KAAK,EACL,SAAS,EACT,UAAiB,EACjB,cAAc,EACd,gBAAwB,EACxB,MAAM,GACP,EAAE,sBAAsB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAoF5C;AAID,OAAO,EAAE,iBAAiB,EAAE,CAAA"}

package/dist/esm/components/data-display/formatters/display-field-money.js

@@ -0,0 +1,88 @@
+"use client";
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { cn, useI18n } from "@wildo-ai/saas-frontend-lib";
+import { Text } from "@wildo-ai/saas-frontend-lib";
+import { fromMoneyAmount, } from "@wildo-ai/zod-decorators";
+import { FrontendComponentType } from "@wildo-ai/presets-components-models";
+/**
+ * DisplayFieldMoney component
+ *
+ * Renders a money value with locale-aware formatting via Intl.NumberFormat:
+ * - Converts integer amount to decimal
+ * - Locale-aware symbol position & separators
+ * - Negative value styling (text-destructive)
+ */
+function DisplayFieldMoney({ schema, value, className, showSymbol = true, symbolPosition, showCurrencyCode = false, locale, }) {
+    const { regionalPreferences, tComponent, isReady } = useI18n({ component: FrontendComponentType.LOW_LEVEL_FORM_FIELD });
+    // Locale priority: explicit prop > regional preferences > browser locale > fallback
+    const effectiveLocale = locale ?? regionalPreferences.locale ?? (typeof navigator !== 'undefined' ? navigator.language : 'en');
+    // Render the value content
+    const renderValue = () => {
+        // Handle null/undefined
+        if (value === null || value === undefined) {
+            return _jsxs(_Fragment, { children: [_jsx(Text, { className: "text-muted-foreground italic", "aria-hidden": "true", children: "\u2014" }), _jsx("span", { className: "sr-only", children: tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD, 'noValue') })] });
+        }
+        // Handle invalid value
+        if (typeof value !== 'object' || !('amount' in value) || !('currency' in value) || !('decimals' in value)) {
+            return _jsx(Text, { className: "text-muted-foreground italic", children: "Invalid" });
+        }
+        // Convert bigint amount to decimal number
+        const decimalValue = fromMoneyAmount(value.amount, value.decimals);
+        const isNegative = decimalValue < 0;
+        // Use Intl.NumberFormat for locale-aware currency formatting
+        let displayText;
+        if (showSymbol) {
+            try {
+                const formatter = new Intl.NumberFormat(effectiveLocale, {
+                    style: 'currency',
+                    currency: value.currency,
+                    minimumFractionDigits: value.decimals,
+                    maximumFractionDigits: value.decimals,
+                    // currencyDisplay controls how the currency is shown (symbol, code, name)
+                    currencyDisplay: 'symbol',
+                });
+                displayText = formatter.format(decimalValue);
+                // Apply manual symbolPosition override if explicitly set.
+                // Intl.NumberFormat respects locale conventions by default;
+                // this override is for cases where the schema wants a specific position.
+                if (symbolPosition) {
+                    // Extract the numeric portion by formatting without currency
+                    const numericFormatter = new Intl.NumberFormat(effectiveLocale, {
+                        minimumFractionDigits: value.decimals,
+                        maximumFractionDigits: value.decimals,
+                    });
+                    const numericText = numericFormatter.format(decimalValue);
+                    // Resolve symbol from the currency format parts
+                    const parts = formatter.formatToParts(Math.abs(decimalValue));
+                    const symbolPart = parts.find(p => p.type === 'currency')?.value ?? value.currency;
+                    // Convention: prefix symbols have no space ($100), suffix symbols have a space (100 €)
+                    displayText = symbolPosition === 'before'
+                        ? `${symbolPart}${numericText}`
+                        : `${numericText} ${symbolPart}`;
+                }
+            }
+            catch {
+                // Fallback if Intl doesn't support this currency
+                displayText = `${value.currency} ${decimalValue.toFixed(value.decimals)}`;
+            }
+        }
+        else {
+            const numericFormatter = new Intl.NumberFormat(effectiveLocale, {
+                minimumFractionDigits: value.decimals,
+                maximumFractionDigits: value.decimals,
+            });
+            displayText = numericFormatter.format(decimalValue);
+        }
+        // Optionally append currency code
+        if (showCurrencyCode) {
+            displayText = `${displayText} ${value.currency}`;
+        }
+        return (_jsx(Text, { className: cn("tabular-nums", isNegative && "text-destructive"), children: displayText }));
+    };
+    // Label/description rendering is handled by the parent DisplayField (FIELD-01)
+    return _jsx("div", { className: className, children: renderValue() });
+}
+;
+DisplayFieldMoney.displayName = "DisplayFieldMoney";
+export { DisplayFieldMoney };
+//# sourceMappingURL=display-field-money.js.map

package/dist/esm/components/data-display/formatters/display-field-money.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"display-field-money.js","sourceRoot":"","sources":["../../../../../src/components/data-display/formatters/display-field-money.tsx"],"names":[],"mappings":"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"}

package/dist/esm/components/data-display/formatters/display-field-number.d.ts

@@ -0,0 +1,16 @@
+/**
+ * DisplayFieldNumber Component
+ *
+ * Displays a number value based on the number UI decorator.
+ * Supports different display modes: raw, formatted, percentage, compact, ordinal, bytes
+ */
+import * as React from "react";
+import type { DisplayFieldNumberProps } from '@wildo-ai/saas-frontend-lib';
+/**
+ * DisplayFieldNumber component
+ *
+ * Renders a number value according to the number UI decorator
+ */
+declare function DisplayFieldNumber({ schema, value, className, locale, }: DisplayFieldNumberProps): React.JSX.Element;
+export { DisplayFieldNumber };
+//# sourceMappingURL=display-field-number.d.ts.map

package/dist/esm/components/data-display/formatters/display-field-number.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"display-field-number.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/formatters/display-field-number.tsx"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAM9B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAA;AAG1E;;;;GAIG;AACH,iBAAS,kBAAkB,CAAC,EAC1B,MAAM,EACN,KAAK,EACL,SAAS,EACT,MAAM,GACP,EAAE,uBAAuB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAmF7C;AAID,OAAO,EAAE,kBAAkB,EAAE,CAAA"}