nextjs-cms 0.7.1 → 0.7.3

package/dist/core/fields/photo.d.ts

@@ -2,29 +2,54 @@ import type { BaseFieldConfig } from './field.js';
 import { entityKind } from '../helpers/index.js';
 import * as z from 'zod';
 import { FileField } from './fileField.js';
+declare const sizeSchema: z.ZodUnion<readonly [z.ZodObject<{
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    strict: z.ZodLiteral<true>;
+    quality: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>, z.ZodDiscriminatedUnion<[z.ZodObject<{
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    fit: z.ZodLiteral<"cover">;
+    quality: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>, z.ZodObject<{
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    fit: z.ZodLiteral<"contain">;
+    quality: z.ZodOptional<z.ZodNumber>;
+    /**
+     * Background color for padding.
+     * Falls back to CMS config media.images.background if not provided.
+     */
+    background: z.ZodOptional<z.ZodObject<{
+        r: z.ZodNumber;
+        g: z.ZodNumber;
+        b: z.ZodNumber;
+        alpha: z.ZodNumber;
+    }, z.core.$strict>>;
+}, z.core.$strict>], "fit">]>;
+type SizeConfig = z.infer<typeof sizeSchema>;
 declare const configSchema: z.ZodObject<{
     /** Whether to add watermark to images */
     watermark: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     blurPlaceholder: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
-    size: z.ZodOptional<z.ZodObject<{
+    size: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
         width: z.ZodNumber;
         height: z.ZodNumber;
+        strict: z.ZodLiteral<true>;
+        quality: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>, z.ZodDiscriminatedUnion<[z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        fit: z.ZodLiteral<"cover">;
+        quality: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>, z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        fit: z.ZodLiteral<"contain">;
+        quality: z.ZodOptional<z.ZodNumber>;
         /**
-         * @true The image will not have dimensions constraints,
-         * and will be cropped to fit the specified dimensions
-         *
-         * @false The user will be forced to upload an image with the specified dimensions
-         *
-         * @example
-         * size: {
-         *   width: 1200,
-         *   height: 450,
-         *   crop: true, // No constraints
-         *   }
-         */
-        crop: z.ZodBoolean;
-        /**
-         * Background color for padding when crop is false.
+         * Background color for padding.
          * Falls back to CMS config media.images.background if not provided.
          */
         background: z.ZodOptional<z.ZodObject<{
@@ -33,14 +58,19 @@ declare const configSchema: z.ZodObject<{
             b: z.ZodNumber;
             alpha: z.ZodNumber;
         }, z.core.$strict>>;
-    }, z.core.$strict>>;
-    thumbnail: z.ZodOptional<z.ZodObject<{
+    }, z.core.$strict>], "fit">]>>;
+    thumbnail: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        fit: z.ZodLiteral<"cover">;
+        quality: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>, z.ZodObject<{
         width: z.ZodNumber;
         height: z.ZodNumber;
-        crop: z.ZodBoolean;
+        fit: z.ZodLiteral<"contain">;
         quality: z.ZodOptional<z.ZodNumber>;
         /**
-         * Background color for padding when crop is false.
+         * Background color for padding.
          * Falls back to CMS config media.images.background if not provided.
          */
         background: z.ZodOptional<z.ZodObject<{
@@ -49,7 +79,7 @@ declare const configSchema: z.ZodObject<{
             b: z.ZodNumber;
             alpha: z.ZodNumber;
         }, z.core.$strict>>;
-    }, z.core.$strict>>;
+    }, z.core.$strict>], "fit">>;
     /**
      * Maximum file size
      * @example
@@ -74,10 +104,10 @@ declare const configSchema: z.ZodObject<{
      * @hint 'jpg' is an alias for 'jpeg'
      */
     fileType: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-        webp: "webp";
-        jpg: "jpg";
         jpeg: "jpeg";
+        jpg: "jpg";
         png: "png";
+        webp: "webp";
     }>>>;
     /**
      * Remove the extension from the file name
@@ -90,17 +120,7 @@ export declare class PhotoField extends FileField<'photo', Config> {
     static readonly [entityKind]: string;
     readonly watermark: boolean | null | undefined;
     readonly blurPlaceholder: boolean | null | undefined;
-    readonly size: {
-        width: number;
-        height: number;
-        crop: boolean;
-        background?: {
-            r: number;
-            g: number;
-            b: number;
-            alpha: number;
-        };
-    } | undefined;
+    readonly size: SizeConfig | undefined;
     readonly maxFileSize: {
         size: number;
         unit: 'kb' | 'mb';
@@ -131,25 +151,41 @@ export declare class PhotoField extends FileField<'photo', Config> {
         thumbnail: {
             width: number;
             height: number;
-            crop: boolean;
-            quality?: number;
+            fit: "cover";
+            quality?: number | undefined;
+        } | {
+            width: number;
+            height: number;
+            fit: "contain";
+            quality?: number | undefined;
             background?: {
                 r: number;
                 g: number;
                 b: number;
                 alpha: number;
-            };
+            } | undefined;
         };
         size: {
             width: number;
             height: number;
-            crop: boolean;
+            fit: "cover";
+            quality?: number | undefined;
+        } | {
+            width: number;
+            height: number;
+            fit: "contain";
+            quality?: number | undefined;
             background?: {
                 r: number;
                 g: number;
                 b: number;
                 alpha: number;
-            };
+            } | undefined;
+        } | {
+            width: number;
+            height: number;
+            strict: true;
+            quality?: number | undefined;
         } | undefined;
         maxFileSize: {
             size: number;
@@ -191,25 +227,23 @@ declare const optionsSchema: z.ZodObject<{
     /** Whether to add watermark to images */
     watermark: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     blurPlaceholder: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
-    size: z.ZodOptional<z.ZodObject<{
+    size: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
         width: z.ZodNumber;
         height: z.ZodNumber;
+        strict: z.ZodLiteral<true>;
+        quality: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>, z.ZodDiscriminatedUnion<[z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        fit: z.ZodLiteral<"cover">;
+        quality: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>, z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        fit: z.ZodLiteral<"contain">;
+        quality: z.ZodOptional<z.ZodNumber>;
         /**
-         * @true The image will not have dimensions constraints,
-         * and will be cropped to fit the specified dimensions
-         *
-         * @false The user will be forced to upload an image with the specified dimensions
-         *
-         * @example
-         * size: {
-         *   width: 1200,
-         *   height: 450,
-         *   crop: true, // No constraints
-         *   }
-         */
-        crop: z.ZodBoolean;
-        /**
-         * Background color for padding when crop is false.
+         * Background color for padding.
          * Falls back to CMS config media.images.background if not provided.
          */
         background: z.ZodOptional<z.ZodObject<{
@@ -218,14 +252,19 @@ declare const optionsSchema: z.ZodObject<{
             b: z.ZodNumber;
             alpha: z.ZodNumber;
         }, z.core.$strict>>;
-    }, z.core.$strict>>;
-    thumbnail: z.ZodOptional<z.ZodObject<{
+    }, z.core.$strict>], "fit">]>>;
+    thumbnail: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        fit: z.ZodLiteral<"cover">;
+        quality: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>, z.ZodObject<{
         width: z.ZodNumber;
         height: z.ZodNumber;
-        crop: z.ZodBoolean;
+        fit: z.ZodLiteral<"contain">;
         quality: z.ZodOptional<z.ZodNumber>;
         /**
-         * Background color for padding when crop is false.
+         * Background color for padding.
          * Falls back to CMS config media.images.background if not provided.
          */
         background: z.ZodOptional<z.ZodObject<{
@@ -234,7 +273,7 @@ declare const optionsSchema: z.ZodObject<{
             b: z.ZodNumber;
             alpha: z.ZodNumber;
         }, z.core.$strict>>;
-    }, z.core.$strict>>;
+    }, z.core.$strict>], "fit">>;
     /**
      * Maximum file size
      * @example
@@ -259,10 +298,10 @@ declare const optionsSchema: z.ZodObject<{
      * @hint 'jpg' is an alias for 'jpeg'
      */
     fileType: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-        webp: "webp";
-        jpg: "jpg";
         jpeg: "jpeg";
+        jpg: "jpg";
         png: "png";
+        webp: "webp";
     }>>>;
     /**
      * Remove the extension from the file name
@@ -283,25 +322,23 @@ declare const photoFieldConfigSchema: z.ZodObject<{
     /** Whether to add watermark to images */
     watermark: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     blurPlaceholder: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
-    size: z.ZodOptional<z.ZodObject<{
+    size: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
         width: z.ZodNumber;
         height: z.ZodNumber;
+        strict: z.ZodLiteral<true>;
+        quality: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>, z.ZodDiscriminatedUnion<[z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        fit: z.ZodLiteral<"cover">;
+        quality: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>, z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        fit: z.ZodLiteral<"contain">;
+        quality: z.ZodOptional<z.ZodNumber>;
         /**
-         * @true The image will not have dimensions constraints,
-         * and will be cropped to fit the specified dimensions
-         *
-         * @false The user will be forced to upload an image with the specified dimensions
-         *
-         * @example
-         * size: {
-         *   width: 1200,
-         *   height: 450,
-         *   crop: true, // No constraints
-         *   }
-         */
-        crop: z.ZodBoolean;
-        /**
-         * Background color for padding when crop is false.
+         * Background color for padding.
          * Falls back to CMS config media.images.background if not provided.
          */
         background: z.ZodOptional<z.ZodObject<{
@@ -310,14 +347,19 @@ declare const photoFieldConfigSchema: z.ZodObject<{
             b: z.ZodNumber;
             alpha: z.ZodNumber;
         }, z.core.$strict>>;
-    }, z.core.$strict>>;
-    thumbnail: z.ZodOptional<z.ZodObject<{
+    }, z.core.$strict>], "fit">]>>;
+    thumbnail: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
         width: z.ZodNumber;
         height: z.ZodNumber;
-        crop: z.ZodBoolean;
+        fit: z.ZodLiteral<"cover">;
+        quality: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>, z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        fit: z.ZodLiteral<"contain">;
         quality: z.ZodOptional<z.ZodNumber>;
         /**
-         * Background color for padding when crop is false.
+         * Background color for padding.
          * Falls back to CMS config media.images.background if not provided.
          */
         background: z.ZodOptional<z.ZodObject<{
@@ -326,7 +368,7 @@ declare const photoFieldConfigSchema: z.ZodObject<{
             b: z.ZodNumber;
             alpha: z.ZodNumber;
         }, z.core.$strict>>;
-    }, z.core.$strict>>;
+    }, z.core.$strict>], "fit">>;
     /**
      * Maximum file size
      * @example
@@ -351,10 +393,10 @@ declare const photoFieldConfigSchema: z.ZodObject<{
      * @hint 'jpg' is an alias for 'jpeg'
      */
     fileType: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-        webp: "webp";
-        jpg: "jpg";
         jpeg: "jpeg";
+        jpg: "jpg";
         png: "png";
+        webp: "webp";
     }>>>;
     /**
      * Remove the extension from the file name

package/dist/core/fields/photo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"photo.d.ts","sourceRoot":"","sources":["../../../src/core/fields/photo.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"photo.d.ts","sourceRoot":"","sources":["../../../src/core/fields/photo.ts"],"names":[],"mappings":"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"}

package/dist/core/fields/photo.js

@@ -16,41 +16,61 @@ const backgroundSchema = z
     b: z.number().min(0).max(255).describe('Blue channel (0-255)'),
     alpha: z.number().min(0).max(1).describe('Alpha channel (0-1)'),
 })
-    .describe('Background color for image padding (used when crop is false)');
-const sizeSchema = z.strictObject({
+    .describe('Background color for image padding (used with fit: contain)');
+/**
+ * Size schema — discriminated union of three variants:
+ * - strict: true — user must upload exact dimensions, no server resize
+ * - fit: 'cover' — accept any dimensions, crop to fill (sharp fit: cover)
+ * - fit: 'contain' — accept any dimensions, pad with background (sharp fit: contain)
+ */
+const strictSizeSchema = z.strictObject({
     width: z.number().describe('Image width in pixels'),
     height: z.number().describe('Image height in pixels'),
-    /**
-     * @true The image will not have dimensions constraints,
-     * and will be cropped to fit the specified dimensions
-     *
-     * @false The user will be forced to upload an image with the specified dimensions
-     *
-     * @example
-     * size: {
-     *   width: 1200,
-     *   height: 450,
-     *   crop: true, // No constraints
-     *   }
-     */
-    crop: z.boolean().describe('Whether to crop the image to fit dimensions'),
-    /**
-     * Background color for padding when crop is false.
-     * Falls back to CMS config media.images.background if not provided.
-     */
-    background: backgroundSchema.optional().describe('Background color for padding when not cropping'),
+    strict: z.literal(true).describe('Require exact upload dimensions, no server resize'),
+    quality: z.number().min(1).max(100).optional().describe('Output quality (1-100)'),
+});
+const coverSizeSchema = z.strictObject({
+    width: z.number().describe('Image width in pixels'),
+    height: z.number().describe('Image height in pixels'),
+    fit: z.literal('cover').describe('Crop to fill dimensions (sharp fit: cover)'),
+    quality: z.number().min(1).max(100).optional().describe('Output quality (1-100)'),
 });
-const thumbnailSchema = z.strictObject({
-    width: z.number().describe('Thumbnail width in pixels'),
-    height: z.number().describe('Thumbnail height in pixels'),
-    crop: z.boolean().describe('Whether to crop the thumbnail'),
-    quality: z.number().optional().describe('Thumbnail quality (0-100)'),
+const containSizeSchema = z.strictObject({
+    width: z.number().describe('Image width in pixels'),
+    height: z.number().describe('Image height in pixels'),
+    fit: z.literal('contain').describe('Pad with background to fill dimensions (sharp fit: contain)'),
+    quality: z.number().min(1).max(100).optional().describe('Output quality (1-100)'),
     /**
-     * Background color for padding when crop is false.
+     * Background color for padding.
      * Falls back to CMS config media.images.background if not provided.
      */
-    background: backgroundSchema.optional().describe('Background color for padding when not cropping'),
+    background: backgroundSchema.optional().describe('Background color for padding'),
 });
+const sizeSchema = z.union([strictSizeSchema, z.discriminatedUnion('fit', [coverSizeSchema, containSizeSchema])]);
+/**
+ * Thumbnail schema — discriminated union:
+ * - fit: 'cover' — crop thumbnail to fill
+ * - fit: 'contain' — pad thumbnail with background
+ */
+const thumbnailSchema = z.discriminatedUnion('fit', [
+    z.strictObject({
+        width: z.number().describe('Thumbnail width in pixels'),
+        height: z.number().describe('Thumbnail height in pixels'),
+        fit: z.literal('cover').describe('Crop thumbnail to fill'),
+        quality: z.number().min(1).max(100).optional().describe('Thumbnail quality (1-100)'),
+    }),
+    z.strictObject({
+        width: z.number().describe('Thumbnail width in pixels'),
+        height: z.number().describe('Thumbnail height in pixels'),
+        fit: z.literal('contain').describe('Pad thumbnail with background'),
+        quality: z.number().min(1).max(100).optional().describe('Thumbnail quality (1-100)'),
+        /**
+         * Background color for padding.
+         * Falls back to CMS config media.images.background if not provided.
+         */
+        background: backgroundSchema.optional().describe('Background color for padding'),
+    }),
+]);
 const maxFileSizeSchema = z.strictObject({
     size: z.number().describe('Maximum file size'),
     unit: z.enum(['kb', 'mb']).describe('Size unit'),
@@ -152,9 +172,13 @@ export class PhotoField extends FileField {
             this._thumbnail = this._thumbnailConfig;
         }
         else {
-            // Always fetch fresh CMS config (getCMSConfig() is already cached with version checking)
+            // Fetch CMS config and construct a ThumbnailConfig from it
             const cmsConfig = await getCMSConfig();
-            this._thumbnail = cmsConfig.media.images.thumbnail;
+            const t = cmsConfig.media.images.thumbnail;
+            const fit = t.fit ?? 'contain';
+            this._thumbnail = fit === 'contain'
+                ? { width: t.width, height: t.height, fit: 'contain', quality: t.quality }
+                : { width: t.width, height: t.height, fit: 'cover', quality: t.quality };
         }
         return this._thumbnail;
     }
@@ -206,55 +230,53 @@ export class PhotoField extends FileField {
                 fs.mkdirSync(thumbsFolder, { recursive: true });
             }
             /**
-             * Check if the image needs to be resized and write the file to disk
-             * - crop: true  -> fit: 'cover' (crops to fill dimensions)
-             * - crop: false -> fit: 'contain' with background (preserves all content, adds padding)
+             * Write the main image to disk
+             * - strict: true  -> no resize, just convert to webp
+             * - fit: 'cover'  -> crop to fill dimensions
+             * - fit: 'contain' -> pad with background to fill dimensions
              */
+            const cmsImageQuality = cmsConfig.media.images.image.quality ?? 80;
             if (this.size) {
-                if (this.size.crop) {
-                    // Crop mode: use 'cover' to fill dimensions by cropping excess
+                const quality = this.size.quality ?? cmsImageQuality;
+                const outputPath = path.join(uploadsFolder, '.photos', this._folder, this.value);
+                if ('strict' in this.size) {
+                    // Strict mode: exact dimensions already validated, just convert to webp
+                    await this._sharpImage.clone().webp({ quality }).toFile(outputPath);
+                }
+                else if (this.size.fit === 'cover') {
                     await this._sharpImage
                         .clone()
-                        .resize({
-                        width: this.size.width,
-                        height: this.size.height,
-                        fit: 'cover',
-                    })
-                        .webp()
-                        .toFile(path.join(uploadsFolder, '.photos', this._folder, this.value));
+                        .resize({ width: this.size.width, height: this.size.height, fit: 'cover' })
+                        .webp({ quality })
+                        .toFile(outputPath);
                 }
                 else {
-                    // Contain mode: preserve all content with background padding
-                    // Use field-level background, fall back to CMS config background
+                    // contain: pad with background
+                    const background = this.size.background ?? cmsBackground;
                     await this._sharpImage
                         .clone()
-                        .resize({
-                        width: this.size.width,
-                        height: this.size.height,
-                        fit: 'contain',
-                        background: this.size.background ?? cmsBackground,
-                    })
-                        .webp()
-                        .toFile(path.join(uploadsFolder, '.photos', this._folder, this.value));
+                        .resize({ width: this.size.width, height: this.size.height, fit: 'contain', background })
+                        .webp({ quality })
+                        .toFile(outputPath);
                 }
             }
             else {
                 await this._sharpImage.clone().toFile(path.join(uploadsFolder, '.photos', this._folder, this.value));
             }
             /**
-             * Also, write a thumbnail
-             * Use CMS config background for padding when crop is false
+             * Write a thumbnail
              */
+            const thumbBackground = ('background' in thumbnail ? thumbnail.background : undefined) ?? cmsBackground;
             await this._sharpImage
                 .clone()
                 .resize({
                 width: thumbnail.width,
                 height: thumbnail.height,
-                fit: thumbnail.crop ? 'cover' : 'contain',
-                background: thumbnail.background ?? cmsBackground,
+                fit: thumbnail.fit,
+                ...(thumbnail.fit === 'contain' ? { background: thumbBackground } : {}),
             })
                 .webp({
-                quality: thumbnail.quality ?? 80,
+                quality: thumbnail.quality ?? cmsImageQuality,
             })
                 .toFile(path.join(uploadsFolder, '.thumbs', this._folder, this.value));
         }
@@ -416,22 +438,11 @@ export class PhotoField extends FileField {
             throw new Error(getString('fileCorrupted', this.locale));
         }
         /**
-         * Check the size
+         * Check the size — only enforce exact dimensions when strict mode is set
          */
-        if (this.size) {
-            /**
-             * Check if the image does not need to be cropped (dimensions are constrained)
-             */
-            if (!this.size.crop) {
-                /**
-                 * Just resize the image?
-                 */
-                /**
-                 * Check if the size matches the required size
-                 */
-                if (metadata.width !== this.size.width || metadata.height !== this.size.height) {
-                    throw new Error(getString('imageDimensionMismatchDetailed', this.locale, { field: this.getLocalizedLabel(), actual: `${metadata.width}x${metadata.height}`, required: `${this.size.width}x${this.size.height}` }));
-                }
+        if (this.size && 'strict' in this.size) {
+            if (metadata.width !== this.size.width || metadata.height !== this.size.height) {
+                throw new Error(getString('imageDimensionMismatchDetailed', this.locale, { field: this.getLocalizedLabel(), actual: `${metadata.width}x${metadata.height}`, required: `${this.size.width}x${this.size.height}` }));
             }
         }
         /**

package/dist/core/fields/richText.d.ts

@@ -31,10 +31,10 @@ declare const allowImageUploadsSchema: z.ZodObject<{
      */
     omitExtension: z.ZodOptional<z.ZodBoolean>;
     format: z.ZodOptional<z.ZodEnum<{
-        webp: "webp";
-        jpg: "jpg";
         jpeg: "jpeg";
+        jpg: "jpg";
         png: "png";
+        webp: "webp";
     }>>;
 }, z.core.$strict>;
 declare const configSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -72,10 +72,10 @@ declare const configSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
          */
         omitExtension: z.ZodOptional<z.ZodBoolean>;
         format: z.ZodOptional<z.ZodEnum<{
-            webp: "webp";
-            jpg: "jpg";
             jpeg: "jpeg";
+            jpg: "jpg";
             png: "png";
+            webp: "webp";
         }>>;
     }, z.core.$strict>>;
 }, z.core.$strict>, z.ZodObject<{
@@ -118,7 +118,7 @@ export declare class RichTextField extends Field<'rich_text', Config> {
             } | undefined;
             handleMethod?: "base64" | "tempSave" | undefined;
             omitExtension?: boolean | undefined;
-            format?: "webp" | "jpg" | "jpeg" | "png" | undefined;
+            format?: "jpeg" | "jpg" | "png" | "webp" | undefined;
         };
         sanitize: boolean;
         type: "rich_text";
@@ -186,10 +186,10 @@ declare const optionsSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
          */
         omitExtension: z.ZodOptional<z.ZodBoolean>;
         format: z.ZodOptional<z.ZodEnum<{
-            webp: "webp";
-            jpg: "jpg";
             jpeg: "jpeg";
+            jpg: "jpg";
             png: "png";
+            webp: "webp";
         }>>;
     }, z.core.$strict>>;
     name: z.ZodString;
@@ -248,10 +248,10 @@ declare const richTextFieldConfigSchema: z.ZodIntersection<z.ZodDiscriminatedUni
          */
         omitExtension: z.ZodOptional<z.ZodBoolean>;
         format: z.ZodOptional<z.ZodEnum<{
-            webp: "webp";
-            jpg: "jpg";
             jpeg: "jpeg";
+            jpg: "jpg";
             png: "png";
+            webp: "webp";
         }>>;
     }, z.core.$strict>>;
     name: z.ZodString;

package/dist/core/fields/select.d.ts

@@ -346,8 +346,8 @@ declare const selectFieldConfigSchema: z.ZodIntersection<z.ZodUnion<readonly [z.
 }, z.core.$strict>]>, z.ZodObject<{
     type: z.ZodLiteral<"select">;
     optionsType: z.ZodEnum<{
-        section: "section";
         db: "db";
+        section: "section";
         static: "static";
     }>;
     build: z.ZodFunction<z.core.$ZodFunctionArgs, z.ZodCustom<SelectField, SelectField>>;