@momentumcms/core 0.5.1 → 0.5.2

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@momentumcms/core",
-	"version": "0.5.1",
+	"version": "0.5.2",
 	"description": "Core collection config, fields, hooks, and access control for Momentum CMS",
 	"license": "MIT",
 	"author": "Momentum CMS Contributors",

package/src/index.cjs

@@ -445,6 +445,31 @@ function validateRowCount(name, label, count, minRows, maxRows, errors) {
 }
 
 // libs/core/src/lib/collections/media.collection.ts
+var validateFocalPoint = (value) => {
+  if (value === null || value === void 0)
+    return true;
+  if (typeof value !== "object" || Array.isArray(value)) {
+    return "Focal point must be an object with x and y coordinates";
+  }
+  const fp = Object.fromEntries(Object.entries(value));
+  if (!("x" in fp) || !("y" in fp)) {
+    return "Focal point must have both x and y properties";
+  }
+  const { x, y } = fp;
+  if (typeof x !== "number" || !Number.isFinite(x)) {
+    return "Focal point x must be a finite number";
+  }
+  if (typeof y !== "number" || !Number.isFinite(y)) {
+    return "Focal point y must be a finite number";
+  }
+  if (x < 0 || x > 1) {
+    return `Focal point x must be between 0 and 1 (received ${x})`;
+  }
+  if (y < 0 || y > 1) {
+    return `Focal point y must be between 0 and 1 (received ${y})`;
+  }
+  return true;
+};
 var MediaCollection = defineCollection({
   slug: "media",
   labels: {
@@ -499,6 +524,14 @@ var MediaCollection = defineCollection({
     json("focalPoint", {
       label: "Focal Point",
       description: "Focal point coordinates for image cropping",
+      validate: validateFocalPoint,
+      admin: {
+        hidden: true
+      }
+    }),
+    json("sizes", {
+      label: "Image Sizes",
+      description: "Generated image size variants",
       admin: {
         hidden: true
       }

package/src/index.js

@@ -364,6 +364,31 @@ function validateRowCount(name, label, count, minRows, maxRows, errors) {
 }
 
 // libs/core/src/lib/collections/media.collection.ts
+var validateFocalPoint = (value) => {
+  if (value === null || value === void 0)
+    return true;
+  if (typeof value !== "object" || Array.isArray(value)) {
+    return "Focal point must be an object with x and y coordinates";
+  }
+  const fp = Object.fromEntries(Object.entries(value));
+  if (!("x" in fp) || !("y" in fp)) {
+    return "Focal point must have both x and y properties";
+  }
+  const { x, y } = fp;
+  if (typeof x !== "number" || !Number.isFinite(x)) {
+    return "Focal point x must be a finite number";
+  }
+  if (typeof y !== "number" || !Number.isFinite(y)) {
+    return "Focal point y must be a finite number";
+  }
+  if (x < 0 || x > 1) {
+    return `Focal point x must be between 0 and 1 (received ${x})`;
+  }
+  if (y < 0 || y > 1) {
+    return `Focal point y must be between 0 and 1 (received ${y})`;
+  }
+  return true;
+};
 var MediaCollection = defineCollection({
   slug: "media",
   labels: {
@@ -418,6 +443,14 @@ var MediaCollection = defineCollection({
     json("focalPoint", {
       label: "Focal Point",
       description: "Focal point coordinates for image cropping",
+      validate: validateFocalPoint,
+      admin: {
+        hidden: true
+      }
+    }),
+    json("sizes", {
+      label: "Image Sizes",
+      description: "Generated image size variants",
       admin: {
         hidden: true
       }

package/src/lib/collections/collection.types.d.ts

@@ -3,6 +3,7 @@
  * Defines the structure of collections (similar to Payload CMS)
  */
 import type { Field } from '../fields/field.types';
+import type { ImageSizeConfig } from '../storage';
 export interface AccessArgs {
     req: RequestContext;
     id?: string | number;
@@ -137,6 +138,10 @@ export interface UploadCollectionConfig {
     pathField?: string;
     /** Field name for the public URL. @default 'url' */
     urlField?: string;
+    /** Image sizes to generate on upload (images only) */
+    imageSizes?: ImageSizeConfig[];
+    /** Default output format for generated sizes. @default 'original' */
+    formatPreference?: 'jpeg' | 'webp' | 'avif' | 'original';
 }
 export interface TimestampsConfig {
     /** Add createdAt field */

package/src/lib/collections/media.collection.d.ts

@@ -2,6 +2,13 @@
  * Built-in Media Collection for Momentum CMS
  * Stores metadata for uploaded files
  */
+import type { ValidateFunction } from '../fields/field.types';
+/**
+ * Validates a focalPoint value: null/undefined is allowed (optional field).
+ * When present, must be a plain object with exactly `x` and `y` properties,
+ * both finite numbers in the [0, 1] range.
+ */
+export declare const validateFocalPoint: ValidateFunction;
 /**
  * Built-in Media collection for storing file upload metadata.
  * Users can override this by defining their own 'media' collection.
@@ -24,6 +31,14 @@ export interface MediaDocument {
         x: number;
         y: number;
     };
+    sizes?: Record<string, {
+        url: string;
+        path: string;
+        width: number;
+        height: number;
+        mimeType: string;
+        filesize: number;
+    }>;
     createdAt: string;
     updatedAt: string;
 }

package/src/lib/storage/index.d.ts

@@ -1,7 +1,57 @@
 /**
  * Storage module for Momentum CMS
- * Defines interfaces for file storage adapters
+ * Defines interfaces for file storage adapters and image processing
  */
+/**
+ * Describes one output size for image processing.
+ */
+export interface ImageSizeConfig {
+    /** Named key for this size (e.g. 'thumbnail', 'medium') */
+    name: string;
+    /** Target width in pixels. Undefined = proportional from height. */
+    width?: number;
+    /** Target height in pixels. Undefined = proportional from width. */
+    height?: number;
+    /**
+     * Resizing strategy.
+     * - 'contain': shrink to fit, no cropping
+     * - 'cover': resize + crop to fill exact dimensions (uses focalPoint)
+     * - 'fill': stretch to exact dimensions
+     * - 'width': resize to width, height proportional
+     * - 'height': resize to height, width proportional
+     * @default 'cover'
+     */
+    fit?: 'contain' | 'cover' | 'fill' | 'width' | 'height';
+    /** Output format. When undefined, uses source format or global formatPreference. */
+    format?: 'jpeg' | 'webp' | 'avif' | 'png';
+    /** JPEG/WebP/AVIF quality (1-100). @default 80 */
+    quality?: number;
+}
+/**
+ * Image dimensions in pixels.
+ */
+export interface ImageDimensions {
+    width: number;
+    height: number;
+}
+/**
+ * Pluggable image processor interface.
+ * Implement this to provide custom image processing backends.
+ */
+export interface ImageProcessor {
+    /** Detect image dimensions without full decode when possible. */
+    getDimensions(buffer: Uint8Array, mimeType: string): Promise<ImageDimensions>;
+    /** Process one size variant. Returns the processed buffer and its dimensions. */
+    processVariant(buffer: Uint8Array, mimeType: string, size: ImageSizeConfig, focalPoint?: {
+        x: number;
+        y: number;
+    }): Promise<{
+        buffer: Uint8Array;
+        width: number;
+        height: number;
+        mimeType: string;
+    }>;
+}
 /**
  * Represents an uploaded file before storage.
  */