@onreza/runtime 0.2.1 → 0.2.2

package/dist/image.d.ts

@@ -24,7 +24,7 @@
  * // → '/_onreza/image?url=...&w=640 640w, /_onreza/image?url=...&w=1080 1080w, ...'
  * ```
  */
-/** Default platform image sizes */
+/** Default image sizes for srcset generation */
 export declare const DEFAULT_SIZES: readonly [640, 750, 828, 1080, 1200, 1920, 2048, 3840];
 /** Supported image formats */
 export type ImageFormat = "webp" | "avif";
@@ -34,7 +34,7 @@ export type ImageFit = "cover" | "contain" | "fill";
  * Image transformation options
  */
 export interface ImageTransformOptions {
-    /** Target width in pixels (must be from allowed sizes) */
+    /** Target width in pixels (1-8192) */
     width?: number;
     /** Target height in pixels (optional, maintains aspect ratio by default) */
     height?: number;

package/dist/image.js

@@ -24,8 +24,10 @@
  * // → '/_onreza/image?url=...&w=640 640w, /_onreza/image?url=...&w=1080 1080w, ...'
  * ```
  */
-/** Default platform image sizes */
+/** Default image sizes for srcset generation */
 export const DEFAULT_SIZES = [640, 750, 828, 1080, 1200, 1920, 2048, 3840];
+const MIN_DIMENSION = 1;
+const MAX_DIMENSION = 8192;
 /**
  * Validate image source path
  * @throws Error if path is invalid
@@ -51,6 +53,11 @@ function validateSrc(src) {
 function clamp(value, min, max) {
     return Math.min(Math.max(value, min), max);
 }
+function warnOutOfRange(value, name) {
+    if (value < MIN_DIMENSION || value > MAX_DIMENSION) {
+        console.warn(`[onreza:image] ${name} ${value} is out of range (${MIN_DIMENSION}-${MAX_DIMENSION}). Clamping.`);
+    }
+}
 /**
  * Build ONREZA image optimization URL
  *
@@ -72,13 +79,13 @@ export function imageUrl(src, options = {}) {
     validateSrc(src);
     const params = new URLSearchParams();
     params.set("url", src);
-    // Width (required)
     if (options.width !== undefined) {
-        params.set("w", String(options.width));
+        warnOutOfRange(options.width, "Width");
+        params.set("w", String(clamp(options.width, MIN_DIMENSION, MAX_DIMENSION)));
     }
-    // Height (optional)
     if (options.height !== undefined) {
-        params.set("h", String(options.height));
+        warnOutOfRange(options.height, "Height");
+        params.set("h", String(clamp(options.height, MIN_DIMENSION, MAX_DIMENSION)));
     }
     // Quality (default: 75)
     const quality = options.quality !== undefined ? clamp(options.quality, 1, 100) : 75;
@@ -119,9 +126,9 @@ export function validateImageOptions(options) {
         dpr: clamp(options.dpr ?? 1, 1, 5),
         fit: options.fit ?? "cover",
         format: options.format,
-        height: options.height,
+        height: options.height !== undefined ? clamp(options.height, MIN_DIMENSION, MAX_DIMENSION) : undefined,
         quality: clamp(options.quality ?? 75, 1, 100),
-        width: options.width !== undefined ? findNearestWidth(options.width) : undefined,
+        width: options.width !== undefined ? clamp(options.width, MIN_DIMENSION, MAX_DIMENSION) : undefined,
     };
 }
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onreza/runtime",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "ONREZA runtime SDK - types and utilities for platform APIs",
   "license": "MIT",
   "author": "ONREZA OSS <opensource@onreza.ru>",