npm - @pixelfiddler/core - Versions diffs - 0.1.0 → 0.1.2 - Mend

@pixelfiddler/core 0.1.0 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/README.md CHANGED Viewed

@@ -19,7 +19,7 @@ import { buildTransformationUrl, buildQueryParams } from '@pixelfiddler/core';
 // Build a complete transformation URL
 const url = buildTransformationUrl(
-  { baseUrl: 'https://cdn.pixelfiddler.com/images/photo.jpg' },
+  { baseUrl: 'https://example-media.com/images/photo.jpg' },
   {
     width: 800,
     height: 600,
@@ -27,7 +27,7 @@ const url = buildTransformationUrl(
     quality: 85,
   }
 );
-// => 'https://cdn.pixelfiddler.com/images/photo.jpg?w=800&h=600&f=webp&q=85'
+// => 'https://example-media.com/images/photo.jpg?w=800&h=600&f=webp&q=85'
 // Or just get the query string
 const params = buildQueryParams({
@@ -77,8 +77,8 @@ Converts transformation options to a URL-encoded query string.
 ```typescript
 {
-  format: 'webp',       // 'jpeg' | 'png' | 'webp' | 'avif' | 'gif' | 'auto'
-  quality: 85,          // 1-100
+  format: 'webp',       // 'jpg' | 'png' | 'webp' | 'avif' | 'gif' | 'auto'
+  quality: 80,          // 1-100
   stripMetadata: true   // Remove EXIF data
 }
 ```

package/dist/index.cjs CHANGED Viewed

@@ -1,23 +1,111 @@
 'use strict';
-// src/types.ts
-var CROP_FOCUS = {
-  SPECIFIED: "SPECIFIED",
-  AUTO: "AUTO"
-};
-var CROP_FOCUS_STRATEGY = {
-  CENTER: "CENTER",
-  SMART: "SMART",
-  DETAIL: "DETAIL"
-};
-var CROP_TYPE = {
-  SIMPLE: "SIMPLE",
-  OBJECT: "OBJECT"
-};
-var CROP_OBJECT_TYPE = {
-  FACE: "FACE",
-  UPPER_BODY: "UPPER_BODY"
+// src/src-set.ts
+var MAX_IMAGE_WIDTH = 4096;
+var DEFAULT_DEVICE_BREAKPOINTS = [
+  320,
+  375,
+  640,
+  768,
+  1024,
+  1280,
+  1536,
+  1920
+];
+var DEFAULT_IMAGE_BREAKPOINTS = [16, 32, 48, 64, 96, 128, 256, 384];
+var DEFAULT_MAX_DPR = 2;
+function computeCandidateWidths(params) {
+  const {
+    allBreakpoints,
+    deviceBreakpoints,
+    explicitWidth,
+    sizesAttr
+  } = params;
+  const sortedAll = [...new Set(allBreakpoints)].sort((a, b) => a - b);
+  const sortedDevice = [...new Set(deviceBreakpoints)].sort((a, b) => a - b);
+  if (!sortedAll.length || !sortedDevice.length) {
+    return { candidates: [], descriptor: "w" };
+  }
+  const minDevice = sortedDevice[0];
+  const maxDevice = sortedDevice[sortedDevice.length - 1];
+  const vwRatios = parseVW(sizesAttr);
+  const hasVW = vwRatios.length > 0;
+  if (typeof explicitWidth === "number" && !hasVW) {
+    const DPRs = [1, 2, 3];
+    const candidates = Array.from(
+      new Set(
+        DPRs.map((dpr) => nearest(sortedAll, explicitWidth * dpr)).map(clampMax)
+      )
+    ).filter((w) => w <= MAX_IMAGE_WIDTH);
+    return {
+      candidates,
+      descriptor: "x"
+    };
+  }
+  if (hasVW) {
+    const minRatio = Math.min(...vwRatios);
+    const maxRatio = Math.max(...vwRatios);
+    const minPx = minDevice * minRatio;
+    const maxPx = maxDevice * maxRatio * DEFAULT_MAX_DPR;
+    const candidates = sortedAll.filter(
+      (w) => w >= minPx && w <= clampMax(maxPx)
+    );
+    return {
+      candidates,
+      descriptor: "w"
+    };
+  }
+  const maxUseful = maxDevice * DEFAULT_MAX_DPR;
+  return {
+    candidates: sortedAll.filter((w) => w <= clampMax(maxUseful)),
+    descriptor: "w"
+  };
+}
+var createResponsiveAttributes = (config, options = {}) => {
+  const {
+    sizes,
+    width,
+    deviceBreakpoints = [...DEFAULT_DEVICE_BREAKPOINTS],
+    imageBreakpoints = [...DEFAULT_IMAGE_BREAKPOINTS],
+    transformations = {},
+    mode = "short"
+  } = options;
+  const sortedDeviceBreakpoints = [...deviceBreakpoints].sort((a, b) => a - b);
+  const sortedImageBreakpoints = [...imageBreakpoints].sort((a, b) => a - b);
+  const allBreakpoints = [.../* @__PURE__ */ new Set([...sortedImageBreakpoints, ...sortedDeviceBreakpoints])].sort((a, b) => a - b);
+  const { candidates, descriptor } = computeCandidateWidths({
+    allBreakpoints,
+    deviceBreakpoints: sortedDeviceBreakpoints,
+    ...width !== void 0 && { explicitWidth: width },
+    ...sizes !== void 0 && { sizesAttr: sizes }
+  });
+  if (candidates.length === 0) {
+    return { src: config.baseUrl };
+  }
+  const srcSetEntries = candidates.map((w, index) => buildSrcEntries(w, index, config, transformations, mode, descriptor));
+  const largestWidth = candidates[candidates.length - 1];
+  const src = buildTransformationUrl(
+    config,
+    { ...transformations, width: largestWidth },
+    mode
+  );
+  const endSizes = sizes ?? (descriptor === "w" ? "100vw" : void 0);
+  return {
+    src,
+    ...endSizes ? { sizes: endSizes } : {},
+    srcSet: srcSetEntries.join(", "),
+    ...width !== void 0 ? { width } : {}
+  };
 };
+function buildSrcEntries(width, index, config, transformations, mode, descriptor) {
+  const url = buildTransformationUrl(
+    config,
+    { ...transformations, width },
+    mode
+  );
+  const desc = descriptor === "w" ? `${width}w` : `${index + 1}x`;
+  return `${url} ${desc}`;
+}
 // src/utils.ts
 var normalizeHex = (value) => value.replace("#", "");
@@ -28,6 +116,14 @@ var getNestedValue = (obj, path) => path.reduce(
   (acc, key) => acc == null ? void 0 : acc[key],
   obj
 );
+var clampMax = (v) => Math.min(v, MAX_IMAGE_WIDTH);
+var nearest = (sortedBreakpoints, target) => sortedBreakpoints.find((w) => w >= target) ?? sortedBreakpoints[sortedBreakpoints.length - 1];
+var parseVW = (sizes) => {
+  if (!sizes) return [];
+  return [...sizes.matchAll(/(\d+(?:\.\d+)?)vw/g)].map(
+    (m) => Number(m[1]) / 100
+  );
+};
 // src/config.ts
 var PARAMS = [
@@ -97,7 +193,7 @@ var PARAMS = [
 ];
 // src/url-builder.ts
-var buildQueryParams = (options, mode = "short") => {
+var buildTransformationQueryParams = (options, mode = "short") => {
   const params = [];
   for (const spec of PARAMS) {
     const value = getNestedValue(options, spec.path);
@@ -117,16 +213,13 @@ var buildTransformationUrl = (config, options, mode = "short") => {
   if (options.original) {
     return `${config.baseUrl}?original`;
   }
-  const query = buildQueryParams(options, mode);
+  const query = buildTransformationQueryParams(options, mode);
   const baseUrl = removeTrailingSlash(config.baseUrl);
   return `${baseUrl}?${query}`;
 };
-exports.CROP_FOCUS = CROP_FOCUS;
-exports.CROP_FOCUS_STRATEGY = CROP_FOCUS_STRATEGY;
-exports.CROP_OBJECT_TYPE = CROP_OBJECT_TYPE;
-exports.CROP_TYPE = CROP_TYPE;
-exports.buildQueryParams = buildQueryParams;
+exports.buildTransformationQueryParams = buildTransformationQueryParams;
 exports.buildTransformationUrl = buildTransformationUrl;
+exports.createResponsiveAttributes = createResponsiveAttributes;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/types.ts","../src/utils.ts","../src/config.ts","../src/url-builder.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/*\r\n Helper type to extract values from const objects\r\n /\r\ntype ObjectValue<T> = T[keyof T];\r\n\r\n/\r\n Resize mode for image transformations\r\n /\r\nexport type ResizeMode = 'FILL' \| 'FIT' \| 'PAD' \| 'FORCE' \| 'COVER';\r\n\r\n/\r\n Output image format - null or empty means AUTO\r\n /\r\nexport type ImageFormat = 'jpeg' \| 'png' \| 'webp' \| 'avif' \| 'gif'\r\n\r\n/\r\n Position for text overlays and watermarks\r\n /\r\nexport type Position =\r\n \| 'TOP_LEFT'\r\n \| 'TOP_CENTER'\r\n \| 'TOP_RIGHT'\r\n \| 'CENTER_LEFT'\r\n \| 'CENTER'\r\n \| 'CENTER_RIGHT'\r\n \| 'BOTTOM_LEFT'\r\n \| 'BOTTOM_CENTER'\r\n \| 'BOTTOM_RIGHT';\r\n\r\n/\r\n Crop focus type\r\n /\r\nexport const CROP_FOCUS = {\r\n SPECIFIED: 'SPECIFIED',\r\n AUTO: 'AUTO',\r\n} as const;\r\n\r\nexport type CropFocus = ObjectValue<typeof CROP_FOCUS>;\r\n\r\n/\r\n Crop focus strategy for AUTO focus\r\n /\r\nexport const CROP_FOCUS_STRATEGY = {\r\n CENTER: 'CENTER',\r\n SMART: 'SMART',\r\n DETAIL: 'DETAIL',\r\n} as const;\r\n\r\nexport type CropFocusStrategy = ObjectValue<typeof CROP_FOCUS_STRATEGY>;\r\n\r\n/\r\n Crop type\r\n /\r\nexport const CROP_TYPE = {\r\n SIMPLE: 'SIMPLE',\r\n OBJECT: 'OBJECT',\r\n} as const;\r\n\r\nexport type CropType = ObjectValue<typeof CROP_TYPE>;\r\n\r\n/\r\n Object type for smart cropping\r\n /\r\nexport const CROP_OBJECT_TYPE = {\r\n FACE: 'FACE',\r\n UPPER_BODY: 'UPPER_BODY',\r\n} as const;\r\n\r\nexport type CropObjectType = ObjectValue<typeof CROP_OBJECT_TYPE>;\r\n\r\n/\r\n Rotation angle in degrees (clockwise)\r\n /\r\nexport type RotationAngle = 0 \| 90 \| 180 \| 270;\r\n\r\n/\r\n Device pixel ratio for high-density displays\r\n /\r\nexport type DevicePixelRatio = 1 \| 2 \| 3 \| 4;\r\n\r\n/\r\n Hex color string (with or without #)\r\n /\r\nexport type HexColor = string;\r\n\r\n/\r\n Resize transformation options\r\n /\r\nexport interface ResizeOptions {\r\n /* Target width in pixels (1-4096) /\r\n width?: number;\r\n /* Target height in pixels (1-4096) /\r\n height?: number;\r\n /* Device pixel ratio for retina displays /\r\n dpr?: DevicePixelRatio;\r\n /* Resize strategy /\r\n mode?: ResizeMode;\r\n /* Background color for PAD mode (hex) /\r\n background?: HexColor;\r\n}\r\n\r\n/\r\n Format and quality options\r\n /\r\nexport interface FormatOptions {\r\n /* Output format /\r\n format?: ImageFormat;\r\n /* Quality level (1-100) /\r\n quality?: number;\r\n /* Strip metadata from output /\r\n stripMetadata?: boolean;\r\n}\r\n\r\n/\r\n Effect transformation options\r\n /\r\nexport interface EffectOptions {\r\n /* Gaussian blur intensity (0-100) /\r\n blur?: number;\r\n /* Brightness adjustment (0-100) /\r\n brightness?: number;\r\n /* Contrast adjustment (0-100) /\r\n contrast?: number;\r\n /* Convert to grayscale /\r\n grayscale?: boolean;\r\n /* Saturation adjustment (0-100) /\r\n saturation?: number;\r\n /* Apply sepia effect /\r\n sepia?: boolean;\r\n /* Sharpen intensity (0-100) /\r\n sharpen?: number;\r\n /* Add noise intensity (0-100) /\r\n noise?: number;\r\n /* Rotation angle /\r\n rotate?: RotationAngle;\r\n}\r\n\r\n/\r\n Border options\r\n /\r\nexport interface BorderOptions {\r\n /* Border width in pixels /\r\n width?: number;\r\n /* Border color (hex) /\r\n color?: HexColor;\r\n /* Corner radius in pixels (1-2000) /\r\n radius?: number;\r\n}\r\n\r\n/\r\n Crop focus position for SPECIFIED focus type\r\n /\r\nexport interface CropFocusPosition {\r\n x?: number;\r\n y?: number;\r\n}\r\n\r\n/\r\n Crop focus options\r\n /\r\nexport interface CropFocusOptions {\r\n /* Focus type - SPECIFIED (manual position) or AUTO (strategy-based) /\r\n type?: CropFocus;\r\n /* Manual focus position when type is SPECIFIED /\r\n position?: CropFocusPosition;\r\n /* Auto focus strategy when type is AUTO /\r\n strategy?: CropFocusStrategy;\r\n}\r\n\r\n/\r\n Crop options\r\n /\r\nexport interface CropOptions {\r\n /* Crop type - SIMPLE or OBJECT /\r\n type?: CropType;\r\n /* Object type for OBJECT crop type /\r\n objectType?: CropObjectType;\r\n /* Focus options /\r\n focus?: CropFocusOptions;\r\n /* Crop width in pixels /\r\n width?: number;\r\n /* Crop height in pixels /\r\n height?: number;\r\n /* Apply crop after resize /\r\n afterResize?: boolean;\r\n}\r\n\r\n/\r\n Text overlay options\r\n /\r\nexport interface TextOptions {\r\n /* Text content to render /\r\n text?: string;\r\n /* Text color (hex) /\r\n color?: HexColor;\r\n /* Text opacity (0-100) /\r\n opacity?: number;\r\n /* Background color behind text (hex) /\r\n background?: HexColor;\r\n /* Background opacity (0-100) /\r\n backgroundOpacity?: number;\r\n /* Text size as percentage of image (1-100) /\r\n size?: number;\r\n /* Font family name /\r\n font?: string;\r\n /* Font size in pixels /\r\n fontSize?: number;\r\n /* Text position /\r\n position?: Position;\r\n}\r\n\r\n/\r\n Watermark options\r\n /\r\nexport interface WatermarkOptions {\r\n /* Watermark name (predefined in dashboard) /\r\n name?: string;\r\n /* Watermark opacity (0-100) /\r\n opacity?: number;\r\n /* Watermark size as percentage (1-100) /\r\n size?: number;\r\n /* Watermark width in pixels /\r\n width?: number;\r\n /* Watermark height in pixels /\r\n height?: number;\r\n /* Watermark position /\r\n position?: Position;\r\n}\r\n\r\n/\r\n All transformation options combined\r\n /\r\nexport interface TransformationOptions\r\n extends ResizeOptions,\r\n FormatOptions,\r\n EffectOptions {\r\n /* Border options /\r\n border?: BorderOptions;\r\n /* Crop options /\r\n crop?: CropOptions;\r\n /* Text overlay options /\r\n text?: TextOptions;\r\n /* Watermark options /\r\n watermark?: WatermarkOptions;\r\n /* Use predefined transformation alias /\r\n alias?: string;\r\n /* Return original image without transformations /\r\n original?: boolean;\r\n}\r\n\r\n/\r\n Configuration for PixelFiddler client\r\n /\r\nexport interface PixelFiddlerConfig {\r\n /* Base URL for the CDN (defaults to https://cdn.pixel-fiddler.com) /\r\n baseUrl?: string;\r\n /* Secret key for URL signing /\r\n signatureKey?: string;\r\n}\r\n\r\n/\r\n URL builder configuration (internal)\r\n /\r\nexport interface UrlBuilderConfig extends PixelFiddlerConfig {\r\n /* Resolved base URL /\r\n baseUrl: string;\r\n}\r\n\r\n/\r\n Mapping of transformation options to query parameter names\r\n /\r\nexport interface QueryParameterMapping {\r\n /* Full parameter name /\r\n name: string;\r\n /* Short alias /\r\n alias?: string;\r\n}\r\n\r\n\r\n","import { Path, PathValue } from './util-types';\r\n\r\nexport const normalizeHex = (value: string) => value.replace('#', '')\r\n\r\n\r\nexport const removeTrailingSlash = (baseUrl: string) => {\r\n return baseUrl.endsWith('/')\r\n ? baseUrl.slice(0, -1)\r\n : baseUrl;\r\n}\r\n\r\nexport const getNestedValue = <\r\n T,\r\n P extends Path<T>\r\n>(\r\n obj: T,\r\n path: P\r\n): PathValue<T, P> \| undefined =>\r\n path.reduce<any>(\r\n (acc, key) => (acc == null ? undefined : acc[key]),\r\n obj\r\n );\r\n\r\n","import { ParamSpec, Path } from './util-types';\r\nimport { TransformationOptions } from './types';\r\nimport { normalizeHex } from './utils';\r\n\r\nexport const PARAMS = [\r\n {path: ['width'], long: 'width', short: 'w'},\r\n {path: ['height'], long: 'height', short: 'h'},\r\n {path: ['dpr'], long: 'dpr', short: 'dpr'},\r\n {path: ['mode'], long: 'mode', short: 'rm'},\r\n {\r\n path: ['background'],\r\n long: 'background',\r\n short: 'bg',\r\n normalize: (v) => typeof v === 'string' ? normalizeHex(v) : v\r\n },\r\n\r\n {path: ['format'], long: 'format', short: 'f'},\r\n {path: ['quality'], long: 'quality', short: 'q'},\r\n {path: ['stripMetadata'], long: 'stripMetadata', short: 'st'},\r\n\r\n {path: ['blur'], long: 'blur', short: 'bl'},\r\n {path: ['brightness'], long: 'brightness', short: 'br'},\r\n {path: ['contrast'], long: 'contrast', short: 'ct'},\r\n {path: ['grayscale'], long: 'grayscale', short: 'gs'},\r\n {path: ['saturation'], long: 'saturation', short: 'sa'},\r\n {path: ['sepia'], long: 'sepia', short: 'sp'},\r\n {path: ['sharpen'], long: 'sharpen', short: 'sh'},\r\n {path: ['noise'], long: 'noise', short: 'ns'},\r\n {path: ['rotate'], long: 'rotate', short: 'rt'},\r\n\r\n {path: ['border', 'width'], long: 'border.width', short: 'bo.w'},\r\n {\r\n path: ['border', 'color'],\r\n long: 'border.color',\r\n short: 'bo.c',\r\n normalize: (v) => typeof v === 'string' ? normalizeHex(v) : v\r\n },\r\n {path: ['border', 'radius'], long: 'border.radius', short: 'bo.r'},\r\n\r\n {path: ['crop', 'type'], long: 'crop.type', short: 'cr.t'},\r\n {path: ['crop', 'objectType'], long: 'crop.objectType', short: 'cr.o'},\r\n {path: ['crop', 'focus', 'position', 'x'], long: 'crop.x', short: 'cr.x'},\r\n {path: ['crop', 'focus', 'position', 'y'], long: 'crop.y', short: 'cr.y'},\r\n {path: ['crop', 'focus', 'strategy'], long: 'crop', short: 'cr'},\r\n {path: ['crop', 'width'], long: 'crop.width', short: 'cr.w'},\r\n {path: ['crop', 'height'], long: 'crop.height', short: 'cr.h'},\r\n {path: ['crop', 'afterResize'], long: 'crop.afterResize', short: 'cr.ar'},\r\n\r\n {path: ['text', 'text'], long: 'text', short: 'tx'},\r\n {\r\n path: ['text', 'color'],\r\n long: 'text.color',\r\n short: 'tx.c',\r\n normalize: (v) => typeof v === 'string' ? normalizeHex(v) : v\r\n },\r\n {path: ['text', 'opacity'], long: 'text.opacity', short: 'tx.o'},\r\n {path: ['text', 'size'], long: 'text.size', short: 'tx.s'},\r\n {path: ['text', 'font'], long: 'text.font', short: 'tx.f'},\r\n {path: ['text', 'fontSize'], long: 'text.fontSize', short: 'tx.fs'},\r\n {path: ['text', 'position'], long: 'text.position', short: 'tx.p'},\r\n {\r\n path: ['text', 'background'],\r\n long: 'text.background',\r\n short: 'tx.bg',\r\n normalize: (v) => typeof v === 'string' ? normalizeHex(v) : v\r\n },\r\n {path: ['text', 'backgroundOpacity'], long: 'text.backgroundOpacity', short: 'tx.bg.o'},\r\n\r\n {path: ['watermark', 'name'], long: 'watermark', short: 'wm'},\r\n {path: ['watermark', 'opacity'], long: 'watermark.opacity', short: 'wm.o'},\r\n {path: ['watermark', 'size'], long: 'watermark.size', short: 'wm.s'},\r\n {path: ['watermark', 'width'], long: 'watermark.width', short: 'wm.w'},\r\n {path: ['watermark', 'height'], long: 'watermark.height', short: 'wm.h'},\r\n {path: ['watermark', 'position'], long: 'watermark.position', short: 'wm.p'},\r\n] as const satisfies readonly ParamSpec<\r\n TransformationOptions,\r\n Path<TransformationOptions>\r\n>[];\r\n","import { TransformationOptions, UrlBuilderConfig } from './types';\r\nimport { getNestedValue, removeTrailingSlash } from './utils';\r\nimport { PARAMS } from './config';\r\n\r\n/\r\n Determines which parameter names to use in the query string.\r\n * - `'short'` - Use abbreviated aliases (e.g., `w`, `h`, `q`)\r\n * - `'long'` - Use full parameter names (e.g., `width`, `height`, `quality`)\r\n /\r\ntype NameMode = 'short' \| 'long';\r\n\r\n/\r\n Converts transformation options into a URL-encoded query string.\r\n \r\n Iterates through all defined parameters in the PARAMS config, extracts values\r\n * from the options object using their paths, applies any normalization functions\r\n * (e.g., stripping `#` from hex colors), and returns a URL-encoded query string.\r\n \r\n @param options - The transformation options object\r\n * @param mode - Whether to use short aliases or long parameter names (default: `'short'`)\r\n * @returns URL-encoded query string (without leading `?`)\r\n \r\n @example\r\n * ```ts\r\n * // Using short aliases (default)\r\n * buildQueryParams({ width: 800, height: 600, quality: 80 });\r\n * // => 'w=800&h=600&q=80'\r\n \r\n // Using long parameter names\r\n * buildQueryParams({ width: 800, format: 'webp' }, 'long');\r\n * // => 'width=800&format=webp'\r\n \r\n // Nested options\r\n * buildQueryParams({ border: { width: 2, color: '#ff0000' } });\r\n * // => 'bo.w=2&bo.c=ff0000'\r\n * ```\r\n /\r\nexport const buildQueryParams = (\r\n options: TransformationOptions,\r\n mode: NameMode = 'short'\r\n): string => {\r\n const params: Array<[string, string]> = [];\r\n\r\n for (const spec of PARAMS) {\r\n const value = getNestedValue(options, spec.path);\r\n if (value == null) continue;\r\n\r\n const name =\r\n mode === 'short' && spec.short ? spec.short : spec.long;\r\n\r\n let normalized = value\r\n if ('normalize' in spec) {\r\n normalized = spec.normalize(value)\r\n }\r\n\r\n params.push([name, String(normalized)]);\r\n }\r\n\r\n\r\n return new URLSearchParams(\r\n params.map(([k, v]) => [k, v])\r\n ).toString();\r\n\r\n};\r\n\r\n/\r\n Builds a complete transformation URL from a base URL and transformation options.\r\n \r\n Combines the configured base URL with query parameters generated from the\r\n * transformation options. Handles the special `original` flag which returns\r\n * the unmodified source image.\r\n \r\n @param config - Configuration containing the base URL for the image\r\n * @param options - The transformation options to apply\r\n * @param mode - Whether to use short aliases or long parameter names (default: `'short'`)\r\n * @returns The complete URL string with query parameters\r\n \r\n @example\r\n * ```ts\r\n * const config = { baseUrl: 'https://cdn.example.com/images/photo.jpg' };\r\n \r\n // Basic resize\r\n * buildTransformationUrl(config, { width: 400, height: 300 });\r\n * // => 'https://cdn.example.com/images/photo.jpg?w=400&h=300'\r\n \r\n // Multiple transformations\r\n * buildTransformationUrl(config, {\r\n * width: 800,\r\n * format: 'webp',\r\n * quality: 85,\r\n * blur: 5\r\n * });\r\n * // => 'https://cdn.example.com/images/photo.jpg?w=800&f=webp&q=85&bl=5'\r\n \r\n // Request original image (no transformations)\r\n * buildTransformationUrl(config, { original: true });\r\n * // => 'https://cdn.example.com/images/photo.jpg?original'\r\n \r\n // Using long parameter names\r\n * buildTransformationUrl(config, { width: 400 }, 'long');\r\n * // => 'https://cdn.example.com/images/photo.jpg?width=400'\r\n * ```\r\n */\r\nexport const buildTransformationUrl = (\r\n config: UrlBuilderConfig,\r\n options: TransformationOptions,\r\n mode: NameMode = 'short'\r\n) => {\r\n if (options.original) {\r\n return `${config.baseUrl}?original`;\r\n }\r\n\r\n const query = buildQueryParams(options, mode);\r\n\r\n const baseUrl = removeTrailingSlash(config.baseUrl)\r\n return `${baseUrl}?${query}`;\r\n};\r\n"]}
1	+ {"version":3,"sources":["../src/src-set.ts","../src/utils.ts","../src/config.ts","../src/url-builder.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["import { buildTransformationUrl, NameMode } from './url-builder';\r\nimport { TransformationOptions, UrlBuilderConfig } from './types';\r\nimport { clampMax, nearest, parseVW } from './utils';\r\n\r\n/*\r\n Maximum supported image width\r\n /\r\nexport const MAX_IMAGE_WIDTH = 4096;\r\n\r\n/\r\n Default device breakpoints for responsive srcset generation\r\n /\r\nexport const DEFAULT_DEVICE_BREAKPOINTS = [\r\n 320,\r\n 375,\r\n 640,\r\n 768,\r\n 1024,\r\n 1280,\r\n 1536,\r\n 1920\r\n] as const;\r\n\r\n/\r\n Default image breakpoints for smaller images (icons, thumbnails)\r\n /\r\nexport const DEFAULT_IMAGE_BREAKPOINTS = [16, 32, 48, 64, 96, 128, 256, 384] as const;\r\n\r\n/\r\n Options for responsive image attributes generation\r\n /\r\nexport interface ResponsiveImageOptions {\r\n /\r\n The `sizes` attribute value (e.g., \"100vw\", \"(max-width: 768px) 100vw, 50vw\").\r\n * When provided, generates width descriptors (`w`) for responsive layouts.\r\n /\r\n sizes?: string;\r\n /\r\n Fixed display width in CSS pixels.\r\n * When provided without `sizes`, generates DPR descriptors (`x`).\r\n /\r\n width?: number;\r\n /* Device breakpoints for viewport-based sizing (default: DEFAULT_DEVICE_BREAKPOINTS) /\r\n deviceBreakpoints?: number[];\r\n /* Image breakpoints for smaller images (default: DEFAULT_IMAGE_BREAKPOINTS) /\r\n imageBreakpoints?: number[];\r\n /* Base transformation options to apply to all variants /\r\n transformations?: TransformationOptions;\r\n /* Whether to use short or long parameter names (default: 'short') /\r\n mode?: NameMode;\r\n}\r\n\r\n/\r\n Result of responsive image attributes generation\r\n /\r\nexport interface ResponsiveImageResult {\r\n /* The src attribute value (largest/default variant) /\r\n src: string;\r\n /* The srcset attribute value /\r\n srcSet?: string;\r\n /* The sizes attribute value (for width descriptors) /\r\n sizes?: string;\r\n /* The width attribute value (when explicitly provided) /\r\n width?: number;\r\n}\r\n\r\n/\r\n Computes candidate widths and descriptor type based on input options.\r\n /\r\nconst DEFAULT_MAX_DPR = 2;\r\n\r\nfunction computeCandidateWidths(params: {\r\n allBreakpoints: number[];\r\n deviceBreakpoints: number[];\r\n explicitWidth?: number;\r\n sizesAttr?: string;\r\n}): { candidates: number[]; descriptor: 'w' \| 'x' } {\r\n const {\r\n allBreakpoints,\r\n deviceBreakpoints,\r\n explicitWidth,\r\n sizesAttr\r\n } = params;\r\n\r\n // ---- Normalize & guard ----\r\n const sortedAll = [...new Set(allBreakpoints)].sort((a, b) => a - b);\r\n const sortedDevice = [...new Set(deviceBreakpoints)].sort((a, b) => a - b);\r\n\r\n if (!sortedAll.length \|\| !sortedDevice.length) {\r\n return { candidates: [], descriptor: 'w' };\r\n }\r\n\r\n const minDevice = sortedDevice[0]!;\r\n const maxDevice = sortedDevice[sortedDevice.length - 1]!;\r\n\r\n const vwRatios = parseVW(sizesAttr);\r\n const hasVW = vwRatios.length > 0;\r\n\r\n // Explicit width (fixed layout) → x descriptors ----\r\n // Prefer this when layout width is known and sizes does NOT imply vw scaling\r\n if (typeof explicitWidth === 'number' && !hasVW) {\r\n const DPRs = [1, 2, 3];\r\n\r\n const candidates = Array.from(\r\n new Set(\r\n DPRs\r\n .map(dpr => nearest(sortedAll, explicitWidth dpr))\r\n .map(clampMax)\r\n )\r\n ).filter(w => w <= MAX_IMAGE_WIDTH);\r\n\r\n return {\r\n candidates,\r\n descriptor: 'x'\r\n };\r\n }\r\n\r\n // Sizes with vw → w descriptors ----\r\n if (hasVW) {\r\n const minRatio = Math.min(...vwRatios);\r\n const maxRatio = Math.max(...vwRatios);\r\n\r\n const minPx = minDevice * minRatio;\r\n const maxPx = maxDevice * maxRatio * DEFAULT_MAX_DPR;\r\n\r\n const candidates = sortedAll.filter(\r\n w => w >= minPx && w <= clampMax(maxPx)\r\n );\r\n\r\n return {\r\n candidates,\r\n descriptor: 'w'\r\n };\r\n }\r\n\r\n // No sizes & no explicit width → device-based w ----\r\n const maxUseful = maxDevice * DEFAULT_MAX_DPR;\r\n\r\n return {\r\n candidates: sortedAll.filter(w => w <= clampMax(maxUseful)),\r\n descriptor: 'w'\r\n };\r\n}\r\n\r\n/*\r\n Generates responsive image attributes (src, srcSet, sizes) for optimal loading.\r\n \r\n Supports two strategies:\r\n * 1. Responsive (with `sizes`): Uses width descriptors (`w`) for fluid layouts\r\n * where image size varies with viewport.\r\n * 2. Fixed width (with `width`): Uses DPR descriptors (`x`) for fixed-size\r\n * images that need high-DPI support.\r\n \r\n @param config - Configuration containing the base URL for the image\r\n * @param options - Options for responsive image generation\r\n * @returns Object containing src, srcSet, and optionally sizes attributes\r\n \r\n @example\r\n * ```ts\r\n * const config = { baseUrl: 'https://example.com/photo.jpg' };\r\n \r\n // Responsive image with sizes attribute (uses `w` descriptors)\r\n * createResponsiveAttributes(config, { sizes: '(max-width: 768px) 100vw, 50vw' });\r\n * // => {\r\n * // src: '...?w=3840',\r\n * // srcSet: '...?w=640 640w, ...?w=750 750w, ..., ...?w=3840 3840w',\r\n * // sizes: '(max-width: 768px) 100vw, 50vw'\r\n * // }\r\n \r\n // Fixed-width image (uses `x` descriptors)\r\n * createResponsiveAttributes(config, { width: 400 });\r\n * // => {\r\n * // src: '...?w=384',\r\n * // srcSet: '...?w=384 1x, ...?w=828 2x',\r\n * // width: 400\r\n * // }\r\n \r\n // With transformations\r\n * createResponsiveAttributes(config, {\r\n * sizes: '100vw',\r\n * transformations: { format: 'WEBP', quality: 80 }\r\n * });\r\n * ```\r\n /\r\nexport const createResponsiveAttributes = (\r\n config: UrlBuilderConfig,\r\n options: ResponsiveImageOptions = {}\r\n): ResponsiveImageResult => {\r\n const {\r\n sizes,\r\n width,\r\n deviceBreakpoints = [...DEFAULT_DEVICE_BREAKPOINTS],\r\n imageBreakpoints = [...DEFAULT_IMAGE_BREAKPOINTS],\r\n transformations = {},\r\n mode = 'short',\r\n } = options;\r\n\r\n const sortedDeviceBreakpoints = [...deviceBreakpoints].sort((a, b) => a - b);\r\n const sortedImageBreakpoints = [...imageBreakpoints].sort((a, b) => a - b);\r\n\r\n const allBreakpoints = [...new Set([...sortedImageBreakpoints, ...sortedDeviceBreakpoints])].sort((a, b) => a - b);\r\n\r\n const { candidates, descriptor } = computeCandidateWidths({\r\n allBreakpoints,\r\n deviceBreakpoints: sortedDeviceBreakpoints,\r\n ...(width !== undefined && { explicitWidth: width }),\r\n ...(sizes !== undefined && { sizesAttr: sizes }),\r\n });\r\n\r\n if (candidates.length === 0) {\r\n // Fallback: no valid candidates, return base URL\r\n return { src: config.baseUrl };\r\n }\r\n\r\n // Build srcSet entries\r\n const srcSetEntries = candidates.map((w, index,) => buildSrcEntries(w, index, config, transformations, mode, descriptor));\r\n\r\n // Default src is the largest candidate\r\n const largestWidth = candidates[candidates.length - 1]!;\r\n const src = buildTransformationUrl(\r\n config,\r\n { ...transformations, width: largestWidth },\r\n mode\r\n );\r\n\r\n const endSizes = sizes ?? (descriptor === 'w' ? '100vw' : undefined);\r\n\r\n return {\r\n src,\r\n ...(endSizes ? { sizes: endSizes } : {}),\r\n srcSet: srcSetEntries.join(', '),\r\n ...(width !== undefined ? { width } : {}),\r\n };\r\n};\r\n\r\nfunction buildSrcEntries(width: number, index: number, config: UrlBuilderConfig, transformations: TransformationOptions, mode: NameMode, descriptor: 'w' \| 'x'): string {\r\n const url = buildTransformationUrl(\r\n config,\r\n { ...transformations, width: width },\r\n mode\r\n );\r\n\r\n const desc = descriptor === 'w' ? `${width}w` : `${index + 1}x`;\r\n\r\n return `${url} ${desc}`;\r\n}\r\n","import { Path, PathValue } from './util-types';\r\nimport { MAX_IMAGE_WIDTH } from './src-set';\r\n\r\nexport const normalizeHex = (value: string) => value.replace('#', '')\r\n\r\n\r\nexport const removeTrailingSlash = (baseUrl: string) => {\r\n return baseUrl.endsWith('/')\r\n ? baseUrl.slice(0, -1)\r\n : baseUrl;\r\n}\r\n\r\nexport const getNestedValue = <\r\n T,\r\n P extends Path<T>\r\n>(\r\n obj: T,\r\n path: P\r\n): PathValue<T, P> \| undefined =>\r\n path.reduce<any>(\r\n (acc, key) => (acc == null ? undefined : acc[key]),\r\n obj\r\n );\r\n\r\n\r\nexport const clampMax = (v: number) => Math.min(v, MAX_IMAGE_WIDTH);\r\n\r\nexport const nearest = (sortedBreakpoints: number[],target: number) =>\r\n sortedBreakpoints.find(w => w >= target) ?? sortedBreakpoints[sortedBreakpoints.length - 1]!;\r\n\r\nexport const parseVW = (sizes?: string): number[] => {\r\n if (!sizes) return [];\r\n return [...sizes.matchAll(/(\\d+(?:\\.\\d+)?)vw/g)].map(\r\n m => Number(m[1]) / 100\r\n );\r\n};\r\n\r\n","import { ParamSpec, Path } from './util-types';\r\nimport { TransformationOptions } from './types';\r\nimport { normalizeHex } from './utils';\r\n\r\nexport const PARAMS = [\r\n {path: ['width'], long: 'width', short: 'w'},\r\n {path: ['height'], long: 'height', short: 'h'},\r\n {path: ['dpr'], long: 'dpr', short: 'dpr'},\r\n {path: ['mode'], long: 'mode', short: 'rm'},\r\n {\r\n path: ['background'],\r\n long: 'background',\r\n short: 'bg',\r\n normalize: (v) => typeof v === 'string' ? normalizeHex(v) : v\r\n },\r\n\r\n {path: ['format'], long: 'format', short: 'f'},\r\n {path: ['quality'], long: 'quality', short: 'q'},\r\n {path: ['stripMetadata'], long: 'stripMetadata', short: 'st'},\r\n\r\n {path: ['blur'], long: 'blur', short: 'bl'},\r\n {path: ['brightness'], long: 'brightness', short: 'br'},\r\n {path: ['contrast'], long: 'contrast', short: 'ct'},\r\n {path: ['grayscale'], long: 'grayscale', short: 'gs'},\r\n {path: ['saturation'], long: 'saturation', short: 'sa'},\r\n {path: ['sepia'], long: 'sepia', short: 'sp'},\r\n {path: ['sharpen'], long: 'sharpen', short: 'sh'},\r\n {path: ['noise'], long: 'noise', short: 'ns'},\r\n {path: ['rotate'], long: 'rotate', short: 'rt'},\r\n\r\n {path: ['border', 'width'], long: 'border.width', short: 'bo.w'},\r\n {\r\n path: ['border', 'color'],\r\n long: 'border.color',\r\n short: 'bo.c',\r\n normalize: (v) => typeof v === 'string' ? normalizeHex(v) : v\r\n },\r\n {path: ['border', 'radius'], long: 'border.radius', short: 'bo.r'},\r\n\r\n {path: ['crop', 'type'], long: 'crop.type', short: 'cr.t'},\r\n {path: ['crop', 'objectType'], long: 'crop.objectType', short: 'cr.o'},\r\n {path: ['crop', 'focus', 'position', 'x'], long: 'crop.x', short: 'cr.x'},\r\n {path: ['crop', 'focus', 'position', 'y'], long: 'crop.y', short: 'cr.y'},\r\n {path: ['crop', 'focus', 'strategy'], long: 'crop', short: 'cr'},\r\n {path: ['crop', 'width'], long: 'crop.width', short: 'cr.w'},\r\n {path: ['crop', 'height'], long: 'crop.height', short: 'cr.h'},\r\n {path: ['crop', 'afterResize'], long: 'crop.afterResize', short: 'cr.ar'},\r\n\r\n {path: ['text', 'text'], long: 'text', short: 'tx'},\r\n {\r\n path: ['text', 'color'],\r\n long: 'text.color',\r\n short: 'tx.c',\r\n normalize: (v) => typeof v === 'string' ? normalizeHex(v) : v\r\n },\r\n {path: ['text', 'opacity'], long: 'text.opacity', short: 'tx.o'},\r\n {path: ['text', 'size'], long: 'text.size', short: 'tx.s'},\r\n {path: ['text', 'font'], long: 'text.font', short: 'tx.f'},\r\n {path: ['text', 'fontSize'], long: 'text.fontSize', short: 'tx.fs'},\r\n {path: ['text', 'position'], long: 'text.position', short: 'tx.p'},\r\n {\r\n path: ['text', 'background'],\r\n long: 'text.background',\r\n short: 'tx.bg',\r\n normalize: (v) => typeof v === 'string' ? normalizeHex(v) : v\r\n },\r\n {path: ['text', 'backgroundOpacity'], long: 'text.backgroundOpacity', short: 'tx.bg.o'},\r\n\r\n {path: ['watermark', 'name'], long: 'watermark', short: 'wm'},\r\n {path: ['watermark', 'opacity'], long: 'watermark.opacity', short: 'wm.o'},\r\n {path: ['watermark', 'size'], long: 'watermark.size', short: 'wm.s'},\r\n {path: ['watermark', 'width'], long: 'watermark.width', short: 'wm.w'},\r\n {path: ['watermark', 'height'], long: 'watermark.height', short: 'wm.h'},\r\n {path: ['watermark', 'position'], long: 'watermark.position', short: 'wm.p'},\r\n] as const satisfies readonly ParamSpec<\r\n TransformationOptions,\r\n Path<TransformationOptions>\r\n>[];\r\n","import { TransformationOptions, UrlBuilderConfig } from './types';\r\nimport { getNestedValue, removeTrailingSlash } from './utils';\r\nimport { PARAMS } from './config';\r\n\r\n/\r\n Determines which parameter names to use in the query string.\r\n * - `'short'` - Use abbreviated aliases (e.g., `w`, `h`, `q`)\r\n * - `'long'` - Use full parameter names (e.g., `width`, `height`, `quality`)\r\n /\r\nexport type NameMode = 'short' \| 'long';\r\n\r\n/\r\n Converts transformation options into a URL-encoded query string.\r\n \r\n Iterates through all defined parameters in the PARAMS config, extracts values\r\n * from the options object using their paths, applies any normalization functions\r\n * (e.g., stripping `#` from hex colors), and returns a URL-encoded query string.\r\n \r\n @param options - The transformation options object\r\n * @param mode - Whether to use short aliases or long parameter names (default: `'short'`)\r\n * @returns URL-encoded query string (without leading `?`)\r\n \r\n @example\r\n * ```ts\r\n * // Using short aliases (default)\r\n * buildQueryParams({ width: 800, height: 600, quality: 80 });\r\n * // => 'w=800&h=600&q=80'\r\n \r\n // Using long parameter names\r\n * buildQueryParams({ width: 800, format: 'webp' }, 'long');\r\n * // => 'width=800&format=webp'\r\n \r\n // Nested options\r\n * buildQueryParams({ border: { width: 2, color: '#ff0000' } });\r\n * // => 'bo.w=2&bo.c=ff0000'\r\n * ```\r\n /\r\nexport const buildTransformationQueryParams = (\r\n options: TransformationOptions,\r\n mode: NameMode = 'short'\r\n): string => {\r\n const params: Array<[string, string]> = [];\r\n\r\n for (const spec of PARAMS) {\r\n const value = getNestedValue(options, spec.path);\r\n if (value == null) continue;\r\n\r\n const name =\r\n mode === 'short' && spec.short ? spec.short : spec.long;\r\n\r\n let normalized = value\r\n if ('normalize' in spec) {\r\n normalized = spec.normalize(value)\r\n }\r\n\r\n params.push([name, String(normalized)]);\r\n }\r\n\r\n\r\n return new URLSearchParams(\r\n params.map(([k, v]) => [k, v])\r\n ).toString();\r\n\r\n};\r\n\r\n/\r\n Builds a complete transformation URL from a base URL and transformation options.\r\n \r\n Combines the configured base URL with query parameters generated from the\r\n * transformation options. Handles the special `original` flag which returns\r\n * the unmodified source image.\r\n \r\n @param config - Configuration containing the base URL for the image\r\n * @param options - The transformation options to apply\r\n * @param mode - Whether to use short aliases or long parameter names (default: `'short'`)\r\n * @returns The complete URL string with query parameters\r\n \r\n @example\r\n * ```ts\r\n * const config = { baseUrl: 'https://example.com/images/photo.jpg' };\r\n \r\n // Basic resize\r\n * buildTransformationUrl(config, { width: 400, height: 300 });\r\n * // => 'https://example.com/images/photo.jpg?w=400&h=300'\r\n \r\n // Multiple transformations\r\n * buildTransformationUrl(config, {\r\n * width: 800,\r\n * format: 'webp',\r\n * quality: 85,\r\n * blur: 5\r\n * });\r\n * // => 'https://example.com/images/photo.jpg?w=800&f=webp&q=85&bl=5'\r\n \r\n // Request original image (no transformations)\r\n * buildTransformationUrl(config, { original: true });\r\n * // => 'https://example.com/images/photo.jpg?original'\r\n \r\n // Using long parameter names\r\n * buildTransformationUrl(config, { width: 400 }, 'long');\r\n * // => 'https://example.com/images/photo.jpg?width=400'\r\n * ```\r\n */\r\nexport const buildTransformationUrl = (\r\n config: UrlBuilderConfig,\r\n options: TransformationOptions,\r\n mode: NameMode = 'short'\r\n) => {\r\n if (options.original) {\r\n return `${config.baseUrl}?original`;\r\n }\r\n\r\n const query = buildTransformationQueryParams(options, mode);\r\n\r\n const baseUrl = removeTrailingSlash(config.baseUrl)\r\n return `${baseUrl}?${query}`;\r\n};\r\n"]}

package/dist/index.d.cts CHANGED Viewed

@@ -9,11 +9,11 @@ type ResizeMode = 'FILL' | 'FIT' | 'PAD' | 'FORCE' | 'COVER';
 /**
  * Output image format - null or empty means AUTO
  */
-type ImageFormat = 'jpeg' | 'png' | 'webp' | 'avif' | 'gif';
+type ImageFormat = 'JPG' | 'PNG' | 'WEBP' | 'AVIF' | 'GIF';
 /**
  * Position for text overlays and watermarks
  */
-type Position = 'TOP_LEFT' | 'TOP_CENTER' | 'TOP_RIGHT' | 'CENTER_LEFT' | 'CENTER' | 'CENTER_RIGHT' | 'BOTTOM_LEFT' | 'BOTTOM_CENTER' | 'BOTTOM_RIGHT';
+type Position = 'TOP_LEFT' | 'TOP_RIGHT' | 'LEFT' | 'RIGHT' | 'BOTTOM' | 'TOP' | 'CENTER' | 'BOTTOM_LEFT' | 'BOTTOM_RIGHT' | 'AUTO';
 /**
  * Crop focus type
  */
@@ -127,33 +127,53 @@ interface CropFocusPosition {
     y?: number;
 }
 /**
- * Crop focus options
+ * Specified focus - manual position
  */
-interface CropFocusOptions {
-    /** Focus type - SPECIFIED (manual position) or AUTO (strategy-based) */
-    type?: CropFocus;
-    /** Manual focus position when type is SPECIFIED */
-    position?: CropFocusPosition;
-    /** Auto focus strategy when type is AUTO */
+interface SpecifiedCropFocus {
+    type: typeof CROP_FOCUS.SPECIFIED;
+    position: CropFocusPosition;
+}
+/**
+ * Auto focus - strategy-based
+ */
+interface AutoCropFocus {
+    type: typeof CROP_FOCUS.AUTO;
     strategy?: CropFocusStrategy;
 }
 /**
- * Crop options
+ * Crop focus options - discriminated union
  */
-interface CropOptions {
-    /** Crop type - SIMPLE or OBJECT */
-    type?: CropType;
-    /** Object type for OBJECT crop type */
-    objectType?: CropObjectType;
-    /** Focus options */
-    focus?: CropFocusOptions;
+type CropFocusOptions = SpecifiedCropFocus | AutoCropFocus;
+/**
+ * Object crop options - smart object detection
+ */
+interface ObjectCropOptions {
+    type?: typeof CROP_TYPE.OBJECT;
     /** Crop width in pixels */
     width?: number;
     /** Crop height in pixels */
     height?: number;
+    /** Object type for smart cropping */
+    objectType?: CropObjectType;
+}
+/**
+ * Simple crop options - manual or strategy-based
+ */
+interface SimpleCropOptions {
+    type: typeof CROP_TYPE.SIMPLE;
     /** Apply crop after resize */
     afterResize?: boolean;
+    /** Crop width in pixels */
+    width?: number;
+    /** Crop height in pixels */
+    height?: number;
+    /** Focus options */
+    focus: CropFocusOptions;
 }
+/**
+ * Crop options - discriminated union
+ */
+type CropOptions = ObjectCropOptions | SimpleCropOptions;
 /**
  * Text overlay options
  */
@@ -260,7 +280,7 @@ type NameMode = 'short' | 'long';
  * // => 'bo.w=2&bo.c=ff0000'
  * ```
  */
-declare const buildQueryParams: (options: TransformationOptions, mode?: NameMode) => string;
+declare const buildTransformationQueryParams: (options: TransformationOptions, mode?: NameMode) => string;
 /**
  * Builds a complete transformation URL from a base URL and transformation options.
  *
@@ -275,11 +295,11 @@ declare const buildQueryParams: (options: TransformationOptions, mode?: NameMode
  *
  * @example
  * ```ts
- * const config = { baseUrl: 'https://cdn.example.com/images/photo.jpg' };
+ * const config = { baseUrl: 'https://example.com/images/photo.jpg' };
  *
  * // Basic resize
  * buildTransformationUrl(config, { width: 400, height: 300 });
- * // => 'https://cdn.example.com/images/photo.jpg?w=400&h=300'
+ * // => 'https://example.com/images/photo.jpg?w=400&h=300'
  *
  * // Multiple transformations
  * buildTransformationUrl(config, {
@@ -288,17 +308,95 @@ declare const buildQueryParams: (options: TransformationOptions, mode?: NameMode
  *   quality: 85,
  *   blur: 5
  * });
- * // => 'https://cdn.example.com/images/photo.jpg?w=800&f=webp&q=85&bl=5'
+ * // => 'https://example.com/images/photo.jpg?w=800&f=webp&q=85&bl=5'
  *
  * // Request original image (no transformations)
  * buildTransformationUrl(config, { original: true });
- * // => 'https://cdn.example.com/images/photo.jpg?original'
+ * // => 'https://example.com/images/photo.jpg?original'
  *
  * // Using long parameter names
  * buildTransformationUrl(config, { width: 400 }, 'long');
- * // => 'https://cdn.example.com/images/photo.jpg?width=400'
+ * // => 'https://example.com/images/photo.jpg?width=400'
  * ```
  */
 declare const buildTransformationUrl: (config: UrlBuilderConfig, options: TransformationOptions, mode?: NameMode) => string;
-export { type BorderOptions, CROP_FOCUS, CROP_FOCUS_STRATEGY, CROP_OBJECT_TYPE, CROP_TYPE, type CropFocus, type CropFocusOptions, type CropFocusPosition, type CropFocusStrategy, type CropObjectType, type CropOptions, type CropType, type DevicePixelRatio, type EffectOptions, type FormatOptions, type HexColor, type ImageFormat, type PixelFiddlerConfig, type Position, type ResizeMode, type ResizeOptions, type RotationAngle, type TextOptions, type TransformationOptions, type UrlBuilderConfig, type WatermarkOptions, buildQueryParams, buildTransformationUrl };
+/**
+ * Options for responsive image attributes generation
+ */
+interface ResponsiveImageOptions {
+    /**
+     * The `sizes` attribute value (e.g., "100vw", "(max-width: 768px) 100vw, 50vw").
+     * When provided, generates width descriptors (`w`) for responsive layouts.
+     */
+    sizes?: string;
+    /**
+     * Fixed display width in CSS pixels.
+     * When provided without `sizes`, generates DPR descriptors (`x`).
+     */
+    width?: number;
+    /** Device breakpoints for viewport-based sizing (default: DEFAULT_DEVICE_BREAKPOINTS) */
+    deviceBreakpoints?: number[];
+    /** Image breakpoints for smaller images (default: DEFAULT_IMAGE_BREAKPOINTS) */
+    imageBreakpoints?: number[];
+    /** Base transformation options to apply to all variants */
+    transformations?: TransformationOptions;
+    /** Whether to use short or long parameter names (default: 'short') */
+    mode?: NameMode;
+}
+/**
+ * Result of responsive image attributes generation
+ */
+interface ResponsiveImageResult {
+    /** The src attribute value (largest/default variant) */
+    src: string;
+    /** The srcset attribute value */
+    srcSet?: string;
+    /** The sizes attribute value (for width descriptors) */
+    sizes?: string;
+    /** The width attribute value (when explicitly provided) */
+    width?: number;
+}
+/**
+ * Generates responsive image attributes (src, srcSet, sizes) for optimal loading.
+ *
+ * Supports two strategies:
+ * 1. **Responsive (with `sizes`)**: Uses width descriptors (`w`) for fluid layouts
+ *    where image size varies with viewport.
+ * 2. **Fixed width (with `width`)**: Uses DPR descriptors (`x`) for fixed-size
+ *    images that need high-DPI support.
+ *
+ * @param config - Configuration containing the base URL for the image
+ * @param options - Options for responsive image generation
+ * @returns Object containing src, srcSet, and optionally sizes attributes
+ *
+ * @example
+ * ```ts
+ * const config = { baseUrl: 'https://example.com/photo.jpg' };
+ *
+ * // Responsive image with sizes attribute (uses `w` descriptors)
+ * createResponsiveAttributes(config, { sizes: '(max-width: 768px) 100vw, 50vw' });
+ * // => {
+ * //   src: '...?w=3840',
+ * //   srcSet: '...?w=640 640w, ...?w=750 750w, ..., ...?w=3840 3840w',
+ * //   sizes: '(max-width: 768px) 100vw, 50vw'
+ * // }
+ *
+ * // Fixed-width image (uses `x` descriptors)
+ * createResponsiveAttributes(config, { width: 400 });
+ * // => {
+ * //   src: '...?w=384',
+ * //   srcSet: '...?w=384 1x, ...?w=828 2x',
+ * //   width: 400
+ * // }
+ *
+ * // With transformations
+ * createResponsiveAttributes(config, {
+ *   sizes: '100vw',
+ *   transformations: { format: 'WEBP', quality: 80 }
+ * });
+ * ```
+ */
+declare const createResponsiveAttributes: (config: UrlBuilderConfig, options?: ResponsiveImageOptions) => ResponsiveImageResult;
+export { type AutoCropFocus, type BorderOptions, type CropFocus, type CropFocusOptions, type CropFocusPosition, type CropFocusStrategy, type CropObjectType, type CropOptions, type CropType, type DevicePixelRatio, type EffectOptions, type FormatOptions, type HexColor, type ImageFormat, type ObjectCropOptions, type PixelFiddlerConfig, type Position, type ResizeMode, type ResizeOptions, type RotationAngle, type SimpleCropOptions, type SpecifiedCropFocus, type TextOptions, type TransformationOptions, type UrlBuilderConfig, type WatermarkOptions, buildTransformationQueryParams, buildTransformationUrl, createResponsiveAttributes };

package/dist/index.d.ts CHANGED Viewed

@@ -9,11 +9,11 @@ type ResizeMode = 'FILL' | 'FIT' | 'PAD' | 'FORCE' | 'COVER';
 /**
  * Output image format - null or empty means AUTO
  */
-type ImageFormat = 'jpeg' | 'png' | 'webp' | 'avif' | 'gif';
+type ImageFormat = 'JPG' | 'PNG' | 'WEBP' | 'AVIF' | 'GIF';
 /**
  * Position for text overlays and watermarks
  */
-type Position = 'TOP_LEFT' | 'TOP_CENTER' | 'TOP_RIGHT' | 'CENTER_LEFT' | 'CENTER' | 'CENTER_RIGHT' | 'BOTTOM_LEFT' | 'BOTTOM_CENTER' | 'BOTTOM_RIGHT';
+type Position = 'TOP_LEFT' | 'TOP_RIGHT' | 'LEFT' | 'RIGHT' | 'BOTTOM' | 'TOP' | 'CENTER' | 'BOTTOM_LEFT' | 'BOTTOM_RIGHT' | 'AUTO';
 /**
  * Crop focus type
  */
@@ -127,33 +127,53 @@ interface CropFocusPosition {
     y?: number;
 }
 /**
- * Crop focus options
+ * Specified focus - manual position
  */
-interface CropFocusOptions {
-    /** Focus type - SPECIFIED (manual position) or AUTO (strategy-based) */
-    type?: CropFocus;
-    /** Manual focus position when type is SPECIFIED */
-    position?: CropFocusPosition;
-    /** Auto focus strategy when type is AUTO */
+interface SpecifiedCropFocus {
+    type: typeof CROP_FOCUS.SPECIFIED;
+    position: CropFocusPosition;
+}
+/**
+ * Auto focus - strategy-based
+ */
+interface AutoCropFocus {
+    type: typeof CROP_FOCUS.AUTO;
     strategy?: CropFocusStrategy;
 }
 /**
- * Crop options
+ * Crop focus options - discriminated union
  */
-interface CropOptions {
-    /** Crop type - SIMPLE or OBJECT */
-    type?: CropType;
-    /** Object type for OBJECT crop type */
-    objectType?: CropObjectType;
-    /** Focus options */
-    focus?: CropFocusOptions;
+type CropFocusOptions = SpecifiedCropFocus | AutoCropFocus;
+/**
+ * Object crop options - smart object detection
+ */
+interface ObjectCropOptions {
+    type?: typeof CROP_TYPE.OBJECT;
     /** Crop width in pixels */
     width?: number;
     /** Crop height in pixels */
     height?: number;
+    /** Object type for smart cropping */
+    objectType?: CropObjectType;
+}
+/**
+ * Simple crop options - manual or strategy-based
+ */
+interface SimpleCropOptions {
+    type: typeof CROP_TYPE.SIMPLE;
     /** Apply crop after resize */
     afterResize?: boolean;
+    /** Crop width in pixels */
+    width?: number;
+    /** Crop height in pixels */
+    height?: number;
+    /** Focus options */
+    focus: CropFocusOptions;
 }
+/**
+ * Crop options - discriminated union
+ */
+type CropOptions = ObjectCropOptions | SimpleCropOptions;
 /**
  * Text overlay options
  */
@@ -260,7 +280,7 @@ type NameMode = 'short' | 'long';
  * // => 'bo.w=2&bo.c=ff0000'
  * ```
  */
-declare const buildQueryParams: (options: TransformationOptions, mode?: NameMode) => string;
+declare const buildTransformationQueryParams: (options: TransformationOptions, mode?: NameMode) => string;
 /**
  * Builds a complete transformation URL from a base URL and transformation options.
  *
@@ -275,11 +295,11 @@ declare const buildQueryParams: (options: TransformationOptions, mode?: NameMode
  *
  * @example
  * ```ts
- * const config = { baseUrl: 'https://cdn.example.com/images/photo.jpg' };
+ * const config = { baseUrl: 'https://example.com/images/photo.jpg' };
  *
  * // Basic resize
  * buildTransformationUrl(config, { width: 400, height: 300 });
- * // => 'https://cdn.example.com/images/photo.jpg?w=400&h=300'
+ * // => 'https://example.com/images/photo.jpg?w=400&h=300'
  *
  * // Multiple transformations
  * buildTransformationUrl(config, {
@@ -288,17 +308,95 @@ declare const buildQueryParams: (options: TransformationOptions, mode?: NameMode
  *   quality: 85,
  *   blur: 5
  * });
- * // => 'https://cdn.example.com/images/photo.jpg?w=800&f=webp&q=85&bl=5'
+ * // => 'https://example.com/images/photo.jpg?w=800&f=webp&q=85&bl=5'
  *
  * // Request original image (no transformations)
  * buildTransformationUrl(config, { original: true });
- * // => 'https://cdn.example.com/images/photo.jpg?original'
+ * // => 'https://example.com/images/photo.jpg?original'
  *
  * // Using long parameter names
  * buildTransformationUrl(config, { width: 400 }, 'long');
- * // => 'https://cdn.example.com/images/photo.jpg?width=400'
+ * // => 'https://example.com/images/photo.jpg?width=400'
  * ```
  */
 declare const buildTransformationUrl: (config: UrlBuilderConfig, options: TransformationOptions, mode?: NameMode) => string;
-export { type BorderOptions, CROP_FOCUS, CROP_FOCUS_STRATEGY, CROP_OBJECT_TYPE, CROP_TYPE, type CropFocus, type CropFocusOptions, type CropFocusPosition, type CropFocusStrategy, type CropObjectType, type CropOptions, type CropType, type DevicePixelRatio, type EffectOptions, type FormatOptions, type HexColor, type ImageFormat, type PixelFiddlerConfig, type Position, type ResizeMode, type ResizeOptions, type RotationAngle, type TextOptions, type TransformationOptions, type UrlBuilderConfig, type WatermarkOptions, buildQueryParams, buildTransformationUrl };
+/**
+ * Options for responsive image attributes generation
+ */
+interface ResponsiveImageOptions {
+    /**
+     * The `sizes` attribute value (e.g., "100vw", "(max-width: 768px) 100vw, 50vw").
+     * When provided, generates width descriptors (`w`) for responsive layouts.
+     */
+    sizes?: string;
+    /**
+     * Fixed display width in CSS pixels.
+     * When provided without `sizes`, generates DPR descriptors (`x`).
+     */
+    width?: number;
+    /** Device breakpoints for viewport-based sizing (default: DEFAULT_DEVICE_BREAKPOINTS) */
+    deviceBreakpoints?: number[];
+    /** Image breakpoints for smaller images (default: DEFAULT_IMAGE_BREAKPOINTS) */
+    imageBreakpoints?: number[];
+    /** Base transformation options to apply to all variants */
+    transformations?: TransformationOptions;
+    /** Whether to use short or long parameter names (default: 'short') */
+    mode?: NameMode;
+}
+/**
+ * Result of responsive image attributes generation
+ */
+interface ResponsiveImageResult {
+    /** The src attribute value (largest/default variant) */
+    src: string;
+    /** The srcset attribute value */
+    srcSet?: string;
+    /** The sizes attribute value (for width descriptors) */
+    sizes?: string;
+    /** The width attribute value (when explicitly provided) */
+    width?: number;
+}
+/**
+ * Generates responsive image attributes (src, srcSet, sizes) for optimal loading.
+ *
+ * Supports two strategies:
+ * 1. **Responsive (with `sizes`)**: Uses width descriptors (`w`) for fluid layouts
+ *    where image size varies with viewport.
+ * 2. **Fixed width (with `width`)**: Uses DPR descriptors (`x`) for fixed-size
+ *    images that need high-DPI support.
+ *
+ * @param config - Configuration containing the base URL for the image
+ * @param options - Options for responsive image generation
+ * @returns Object containing src, srcSet, and optionally sizes attributes
+ *
+ * @example
+ * ```ts
+ * const config = { baseUrl: 'https://example.com/photo.jpg' };
+ *
+ * // Responsive image with sizes attribute (uses `w` descriptors)
+ * createResponsiveAttributes(config, { sizes: '(max-width: 768px) 100vw, 50vw' });
+ * // => {
+ * //   src: '...?w=3840',
+ * //   srcSet: '...?w=640 640w, ...?w=750 750w, ..., ...?w=3840 3840w',
+ * //   sizes: '(max-width: 768px) 100vw, 50vw'
+ * // }
+ *
+ * // Fixed-width image (uses `x` descriptors)
+ * createResponsiveAttributes(config, { width: 400 });
+ * // => {
+ * //   src: '...?w=384',
+ * //   srcSet: '...?w=384 1x, ...?w=828 2x',
+ * //   width: 400
+ * // }
+ *
+ * // With transformations
+ * createResponsiveAttributes(config, {
+ *   sizes: '100vw',
+ *   transformations: { format: 'WEBP', quality: 80 }
+ * });
+ * ```
+ */
+declare const createResponsiveAttributes: (config: UrlBuilderConfig, options?: ResponsiveImageOptions) => ResponsiveImageResult;
+export { type AutoCropFocus, type BorderOptions, type CropFocus, type CropFocusOptions, type CropFocusPosition, type CropFocusStrategy, type CropObjectType, type CropOptions, type CropType, type DevicePixelRatio, type EffectOptions, type FormatOptions, type HexColor, type ImageFormat, type ObjectCropOptions, type PixelFiddlerConfig, type Position, type ResizeMode, type ResizeOptions, type RotationAngle, type SimpleCropOptions, type SpecifiedCropFocus, type TextOptions, type TransformationOptions, type UrlBuilderConfig, type WatermarkOptions, buildTransformationQueryParams, buildTransformationUrl, createResponsiveAttributes };

package/dist/index.js CHANGED Viewed

@@ -1,21 +1,109 @@
-// src/types.ts
-var CROP_FOCUS = {
-  SPECIFIED: "SPECIFIED",
-  AUTO: "AUTO"
-};
-var CROP_FOCUS_STRATEGY = {
-  CENTER: "CENTER",
-  SMART: "SMART",
-  DETAIL: "DETAIL"
-};
-var CROP_TYPE = {
-  SIMPLE: "SIMPLE",
-  OBJECT: "OBJECT"
-};
-var CROP_OBJECT_TYPE = {
-  FACE: "FACE",
-  UPPER_BODY: "UPPER_BODY"
+// src/src-set.ts
+var MAX_IMAGE_WIDTH = 4096;
+var DEFAULT_DEVICE_BREAKPOINTS = [
+  320,
+  375,
+  640,
+  768,
+  1024,
+  1280,
+  1536,
+  1920
+];
+var DEFAULT_IMAGE_BREAKPOINTS = [16, 32, 48, 64, 96, 128, 256, 384];
+var DEFAULT_MAX_DPR = 2;
+function computeCandidateWidths(params) {
+  const {
+    allBreakpoints,
+    deviceBreakpoints,
+    explicitWidth,
+    sizesAttr
+  } = params;
+  const sortedAll = [...new Set(allBreakpoints)].sort((a, b) => a - b);
+  const sortedDevice = [...new Set(deviceBreakpoints)].sort((a, b) => a - b);
+  if (!sortedAll.length || !sortedDevice.length) {
+    return { candidates: [], descriptor: "w" };
+  }
+  const minDevice = sortedDevice[0];
+  const maxDevice = sortedDevice[sortedDevice.length - 1];
+  const vwRatios = parseVW(sizesAttr);
+  const hasVW = vwRatios.length > 0;
+  if (typeof explicitWidth === "number" && !hasVW) {
+    const DPRs = [1, 2, 3];
+    const candidates = Array.from(
+      new Set(
+        DPRs.map((dpr) => nearest(sortedAll, explicitWidth * dpr)).map(clampMax)
+      )
+    ).filter((w) => w <= MAX_IMAGE_WIDTH);
+    return {
+      candidates,
+      descriptor: "x"
+    };
+  }
+  if (hasVW) {
+    const minRatio = Math.min(...vwRatios);
+    const maxRatio = Math.max(...vwRatios);
+    const minPx = minDevice * minRatio;
+    const maxPx = maxDevice * maxRatio * DEFAULT_MAX_DPR;
+    const candidates = sortedAll.filter(
+      (w) => w >= minPx && w <= clampMax(maxPx)
+    );
+    return {
+      candidates,
+      descriptor: "w"
+    };
+  }
+  const maxUseful = maxDevice * DEFAULT_MAX_DPR;
+  return {
+    candidates: sortedAll.filter((w) => w <= clampMax(maxUseful)),
+    descriptor: "w"
+  };
+}
+var createResponsiveAttributes = (config, options = {}) => {
+  const {
+    sizes,
+    width,
+    deviceBreakpoints = [...DEFAULT_DEVICE_BREAKPOINTS],
+    imageBreakpoints = [...DEFAULT_IMAGE_BREAKPOINTS],
+    transformations = {},
+    mode = "short"
+  } = options;
+  const sortedDeviceBreakpoints = [...deviceBreakpoints].sort((a, b) => a - b);
+  const sortedImageBreakpoints = [...imageBreakpoints].sort((a, b) => a - b);
+  const allBreakpoints = [.../* @__PURE__ */ new Set([...sortedImageBreakpoints, ...sortedDeviceBreakpoints])].sort((a, b) => a - b);
+  const { candidates, descriptor } = computeCandidateWidths({
+    allBreakpoints,
+    deviceBreakpoints: sortedDeviceBreakpoints,
+    ...width !== void 0 && { explicitWidth: width },
+    ...sizes !== void 0 && { sizesAttr: sizes }
+  });
+  if (candidates.length === 0) {
+    return { src: config.baseUrl };
+  }
+  const srcSetEntries = candidates.map((w, index) => buildSrcEntries(w, index, config, transformations, mode, descriptor));
+  const largestWidth = candidates[candidates.length - 1];
+  const src = buildTransformationUrl(
+    config,
+    { ...transformations, width: largestWidth },
+    mode
+  );
+  const endSizes = sizes ?? (descriptor === "w" ? "100vw" : void 0);
+  return {
+    src,
+    ...endSizes ? { sizes: endSizes } : {},
+    srcSet: srcSetEntries.join(", "),
+    ...width !== void 0 ? { width } : {}
+  };
 };
+function buildSrcEntries(width, index, config, transformations, mode, descriptor) {
+  const url = buildTransformationUrl(
+    config,
+    { ...transformations, width },
+    mode
+  );
+  const desc = descriptor === "w" ? `${width}w` : `${index + 1}x`;
+  return `${url} ${desc}`;
+}
 // src/utils.ts
 var normalizeHex = (value) => value.replace("#", "");
@@ -26,6 +114,14 @@ var getNestedValue = (obj, path) => path.reduce(
   (acc, key) => acc == null ? void 0 : acc[key],
   obj
 );
+var clampMax = (v) => Math.min(v, MAX_IMAGE_WIDTH);
+var nearest = (sortedBreakpoints, target) => sortedBreakpoints.find((w) => w >= target) ?? sortedBreakpoints[sortedBreakpoints.length - 1];
+var parseVW = (sizes) => {
+  if (!sizes) return [];
+  return [...sizes.matchAll(/(\d+(?:\.\d+)?)vw/g)].map(
+    (m) => Number(m[1]) / 100
+  );
+};
 // src/config.ts
 var PARAMS = [
@@ -95,7 +191,7 @@ var PARAMS = [
 ];
 // src/url-builder.ts
-var buildQueryParams = (options, mode = "short") => {
+var buildTransformationQueryParams = (options, mode = "short") => {
   const params = [];
   for (const spec of PARAMS) {
     const value = getNestedValue(options, spec.path);
@@ -115,11 +211,11 @@ var buildTransformationUrl = (config, options, mode = "short") => {
   if (options.original) {
     return `${config.baseUrl}?original`;
   }
-  const query = buildQueryParams(options, mode);
+  const query = buildTransformationQueryParams(options, mode);
   const baseUrl = removeTrailingSlash(config.baseUrl);
   return `${baseUrl}?${query}`;
 };
-export { CROP_FOCUS, CROP_FOCUS_STRATEGY, CROP_OBJECT_TYPE, CROP_TYPE, buildQueryParams, buildTransformationUrl };
+export { buildTransformationQueryParams, buildTransformationUrl, createResponsiveAttributes };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/types.ts","../src/utils.ts","../src/config.ts","../src/url-builder.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/*\r\n Helper type to extract values from const objects\r\n /\r\ntype ObjectValue<T> = T[keyof T];\r\n\r\n/\r\n Resize mode for image transformations\r\n /\r\nexport type ResizeMode = 'FILL' \| 'FIT' \| 'PAD' \| 'FORCE' \| 'COVER';\r\n\r\n/\r\n Output image format - null or empty means AUTO\r\n /\r\nexport type ImageFormat = 'jpeg' \| 'png' \| 'webp' \| 'avif' \| 'gif'\r\n\r\n/\r\n Position for text overlays and watermarks\r\n /\r\nexport type Position =\r\n \| 'TOP_LEFT'\r\n \| 'TOP_CENTER'\r\n \| 'TOP_RIGHT'\r\n \| 'CENTER_LEFT'\r\n \| 'CENTER'\r\n \| 'CENTER_RIGHT'\r\n \| 'BOTTOM_LEFT'\r\n \| 'BOTTOM_CENTER'\r\n \| 'BOTTOM_RIGHT';\r\n\r\n/\r\n Crop focus type\r\n /\r\nexport const CROP_FOCUS = {\r\n SPECIFIED: 'SPECIFIED',\r\n AUTO: 'AUTO',\r\n} as const;\r\n\r\nexport type CropFocus = ObjectValue<typeof CROP_FOCUS>;\r\n\r\n/\r\n Crop focus strategy for AUTO focus\r\n /\r\nexport const CROP_FOCUS_STRATEGY = {\r\n CENTER: 'CENTER',\r\n SMART: 'SMART',\r\n DETAIL: 'DETAIL',\r\n} as const;\r\n\r\nexport type CropFocusStrategy = ObjectValue<typeof CROP_FOCUS_STRATEGY>;\r\n\r\n/\r\n Crop type\r\n /\r\nexport const CROP_TYPE = {\r\n SIMPLE: 'SIMPLE',\r\n OBJECT: 'OBJECT',\r\n} as const;\r\n\r\nexport type CropType = ObjectValue<typeof CROP_TYPE>;\r\n\r\n/\r\n Object type for smart cropping\r\n /\r\nexport const CROP_OBJECT_TYPE = {\r\n FACE: 'FACE',\r\n UPPER_BODY: 'UPPER_BODY',\r\n} as const;\r\n\r\nexport type CropObjectType = ObjectValue<typeof CROP_OBJECT_TYPE>;\r\n\r\n/\r\n Rotation angle in degrees (clockwise)\r\n /\r\nexport type RotationAngle = 0 \| 90 \| 180 \| 270;\r\n\r\n/\r\n Device pixel ratio for high-density displays\r\n /\r\nexport type DevicePixelRatio = 1 \| 2 \| 3 \| 4;\r\n\r\n/\r\n Hex color string (with or without #)\r\n /\r\nexport type HexColor = string;\r\n\r\n/\r\n Resize transformation options\r\n /\r\nexport interface ResizeOptions {\r\n /* Target width in pixels (1-4096) /\r\n width?: number;\r\n /* Target height in pixels (1-4096) /\r\n height?: number;\r\n /* Device pixel ratio for retina displays /\r\n dpr?: DevicePixelRatio;\r\n /* Resize strategy /\r\n mode?: ResizeMode;\r\n /* Background color for PAD mode (hex) /\r\n background?: HexColor;\r\n}\r\n\r\n/\r\n Format and quality options\r\n /\r\nexport interface FormatOptions {\r\n /* Output format /\r\n format?: ImageFormat;\r\n /* Quality level (1-100) /\r\n quality?: number;\r\n /* Strip metadata from output /\r\n stripMetadata?: boolean;\r\n}\r\n\r\n/\r\n Effect transformation options\r\n /\r\nexport interface EffectOptions {\r\n /* Gaussian blur intensity (0-100) /\r\n blur?: number;\r\n /* Brightness adjustment (0-100) /\r\n brightness?: number;\r\n /* Contrast adjustment (0-100) /\r\n contrast?: number;\r\n /* Convert to grayscale /\r\n grayscale?: boolean;\r\n /* Saturation adjustment (0-100) /\r\n saturation?: number;\r\n /* Apply sepia effect /\r\n sepia?: boolean;\r\n /* Sharpen intensity (0-100) /\r\n sharpen?: number;\r\n /* Add noise intensity (0-100) /\r\n noise?: number;\r\n /* Rotation angle /\r\n rotate?: RotationAngle;\r\n}\r\n\r\n/\r\n Border options\r\n /\r\nexport interface BorderOptions {\r\n /* Border width in pixels /\r\n width?: number;\r\n /* Border color (hex) /\r\n color?: HexColor;\r\n /* Corner radius in pixels (1-2000) /\r\n radius?: number;\r\n}\r\n\r\n/\r\n Crop focus position for SPECIFIED focus type\r\n /\r\nexport interface CropFocusPosition {\r\n x?: number;\r\n y?: number;\r\n}\r\n\r\n/\r\n Crop focus options\r\n /\r\nexport interface CropFocusOptions {\r\n /* Focus type - SPECIFIED (manual position) or AUTO (strategy-based) /\r\n type?: CropFocus;\r\n /* Manual focus position when type is SPECIFIED /\r\n position?: CropFocusPosition;\r\n /* Auto focus strategy when type is AUTO /\r\n strategy?: CropFocusStrategy;\r\n}\r\n\r\n/\r\n Crop options\r\n /\r\nexport interface CropOptions {\r\n /* Crop type - SIMPLE or OBJECT /\r\n type?: CropType;\r\n /* Object type for OBJECT crop type /\r\n objectType?: CropObjectType;\r\n /* Focus options /\r\n focus?: CropFocusOptions;\r\n /* Crop width in pixels /\r\n width?: number;\r\n /* Crop height in pixels /\r\n height?: number;\r\n /* Apply crop after resize /\r\n afterResize?: boolean;\r\n}\r\n\r\n/\r\n Text overlay options\r\n /\r\nexport interface TextOptions {\r\n /* Text content to render /\r\n text?: string;\r\n /* Text color (hex) /\r\n color?: HexColor;\r\n /* Text opacity (0-100) /\r\n opacity?: number;\r\n /* Background color behind text (hex) /\r\n background?: HexColor;\r\n /* Background opacity (0-100) /\r\n backgroundOpacity?: number;\r\n /* Text size as percentage of image (1-100) /\r\n size?: number;\r\n /* Font family name /\r\n font?: string;\r\n /* Font size in pixels /\r\n fontSize?: number;\r\n /* Text position /\r\n position?: Position;\r\n}\r\n\r\n/\r\n Watermark options\r\n /\r\nexport interface WatermarkOptions {\r\n /* Watermark name (predefined in dashboard) /\r\n name?: string;\r\n /* Watermark opacity (0-100) /\r\n opacity?: number;\r\n /* Watermark size as percentage (1-100) /\r\n size?: number;\r\n /* Watermark width in pixels /\r\n width?: number;\r\n /* Watermark height in pixels /\r\n height?: number;\r\n /* Watermark position /\r\n position?: Position;\r\n}\r\n\r\n/\r\n All transformation options combined\r\n /\r\nexport interface TransformationOptions\r\n extends ResizeOptions,\r\n FormatOptions,\r\n EffectOptions {\r\n /* Border options /\r\n border?: BorderOptions;\r\n /* Crop options /\r\n crop?: CropOptions;\r\n /* Text overlay options /\r\n text?: TextOptions;\r\n /* Watermark options /\r\n watermark?: WatermarkOptions;\r\n /* Use predefined transformation alias /\r\n alias?: string;\r\n /* Return original image without transformations /\r\n original?: boolean;\r\n}\r\n\r\n/\r\n Configuration for PixelFiddler client\r\n /\r\nexport interface PixelFiddlerConfig {\r\n /* Base URL for the CDN (defaults to https://cdn.pixel-fiddler.com) /\r\n baseUrl?: string;\r\n /* Secret key for URL signing /\r\n signatureKey?: string;\r\n}\r\n\r\n/\r\n URL builder configuration (internal)\r\n /\r\nexport interface UrlBuilderConfig extends PixelFiddlerConfig {\r\n /* Resolved base URL /\r\n baseUrl: string;\r\n}\r\n\r\n/\r\n Mapping of transformation options to query parameter names\r\n /\r\nexport interface QueryParameterMapping {\r\n /* Full parameter name /\r\n name: string;\r\n /* Short alias /\r\n alias?: string;\r\n}\r\n\r\n\r\n","import { Path, PathValue } from './util-types';\r\n\r\nexport const normalizeHex = (value: string) => value.replace('#', '')\r\n\r\n\r\nexport const removeTrailingSlash = (baseUrl: string) => {\r\n return baseUrl.endsWith('/')\r\n ? baseUrl.slice(0, -1)\r\n : baseUrl;\r\n}\r\n\r\nexport const getNestedValue = <\r\n T,\r\n P extends Path<T>\r\n>(\r\n obj: T,\r\n path: P\r\n): PathValue<T, P> \| undefined =>\r\n path.reduce<any>(\r\n (acc, key) => (acc == null ? undefined : acc[key]),\r\n obj\r\n );\r\n\r\n","import { ParamSpec, Path } from './util-types';\r\nimport { TransformationOptions } from './types';\r\nimport { normalizeHex } from './utils';\r\n\r\nexport const PARAMS = [\r\n {path: ['width'], long: 'width', short: 'w'},\r\n {path: ['height'], long: 'height', short: 'h'},\r\n {path: ['dpr'], long: 'dpr', short: 'dpr'},\r\n {path: ['mode'], long: 'mode', short: 'rm'},\r\n {\r\n path: ['background'],\r\n long: 'background',\r\n short: 'bg',\r\n normalize: (v) => typeof v === 'string' ? normalizeHex(v) : v\r\n },\r\n\r\n {path: ['format'], long: 'format', short: 'f'},\r\n {path: ['quality'], long: 'quality', short: 'q'},\r\n {path: ['stripMetadata'], long: 'stripMetadata', short: 'st'},\r\n\r\n {path: ['blur'], long: 'blur', short: 'bl'},\r\n {path: ['brightness'], long: 'brightness', short: 'br'},\r\n {path: ['contrast'], long: 'contrast', short: 'ct'},\r\n {path: ['grayscale'], long: 'grayscale', short: 'gs'},\r\n {path: ['saturation'], long: 'saturation', short: 'sa'},\r\n {path: ['sepia'], long: 'sepia', short: 'sp'},\r\n {path: ['sharpen'], long: 'sharpen', short: 'sh'},\r\n {path: ['noise'], long: 'noise', short: 'ns'},\r\n {path: ['rotate'], long: 'rotate', short: 'rt'},\r\n\r\n {path: ['border', 'width'], long: 'border.width', short: 'bo.w'},\r\n {\r\n path: ['border', 'color'],\r\n long: 'border.color',\r\n short: 'bo.c',\r\n normalize: (v) => typeof v === 'string' ? normalizeHex(v) : v\r\n },\r\n {path: ['border', 'radius'], long: 'border.radius', short: 'bo.r'},\r\n\r\n {path: ['crop', 'type'], long: 'crop.type', short: 'cr.t'},\r\n {path: ['crop', 'objectType'], long: 'crop.objectType', short: 'cr.o'},\r\n {path: ['crop', 'focus', 'position', 'x'], long: 'crop.x', short: 'cr.x'},\r\n {path: ['crop', 'focus', 'position', 'y'], long: 'crop.y', short: 'cr.y'},\r\n {path: ['crop', 'focus', 'strategy'], long: 'crop', short: 'cr'},\r\n {path: ['crop', 'width'], long: 'crop.width', short: 'cr.w'},\r\n {path: ['crop', 'height'], long: 'crop.height', short: 'cr.h'},\r\n {path: ['crop', 'afterResize'], long: 'crop.afterResize', short: 'cr.ar'},\r\n\r\n {path: ['text', 'text'], long: 'text', short: 'tx'},\r\n {\r\n path: ['text', 'color'],\r\n long: 'text.color',\r\n short: 'tx.c',\r\n normalize: (v) => typeof v === 'string' ? normalizeHex(v) : v\r\n },\r\n {path: ['text', 'opacity'], long: 'text.opacity', short: 'tx.o'},\r\n {path: ['text', 'size'], long: 'text.size', short: 'tx.s'},\r\n {path: ['text', 'font'], long: 'text.font', short: 'tx.f'},\r\n {path: ['text', 'fontSize'], long: 'text.fontSize', short: 'tx.fs'},\r\n {path: ['text', 'position'], long: 'text.position', short: 'tx.p'},\r\n {\r\n path: ['text', 'background'],\r\n long: 'text.background',\r\n short: 'tx.bg',\r\n normalize: (v) => typeof v === 'string' ? normalizeHex(v) : v\r\n },\r\n {path: ['text', 'backgroundOpacity'], long: 'text.backgroundOpacity', short: 'tx.bg.o'},\r\n\r\n {path: ['watermark', 'name'], long: 'watermark', short: 'wm'},\r\n {path: ['watermark', 'opacity'], long: 'watermark.opacity', short: 'wm.o'},\r\n {path: ['watermark', 'size'], long: 'watermark.size', short: 'wm.s'},\r\n {path: ['watermark', 'width'], long: 'watermark.width', short: 'wm.w'},\r\n {path: ['watermark', 'height'], long: 'watermark.height', short: 'wm.h'},\r\n {path: ['watermark', 'position'], long: 'watermark.position', short: 'wm.p'},\r\n] as const satisfies readonly ParamSpec<\r\n TransformationOptions,\r\n Path<TransformationOptions>\r\n>[];\r\n","import { TransformationOptions, UrlBuilderConfig } from './types';\r\nimport { getNestedValue, removeTrailingSlash } from './utils';\r\nimport { PARAMS } from './config';\r\n\r\n/\r\n Determines which parameter names to use in the query string.\r\n * - `'short'` - Use abbreviated aliases (e.g., `w`, `h`, `q`)\r\n * - `'long'` - Use full parameter names (e.g., `width`, `height`, `quality`)\r\n /\r\ntype NameMode = 'short' \| 'long';\r\n\r\n/\r\n Converts transformation options into a URL-encoded query string.\r\n \r\n Iterates through all defined parameters in the PARAMS config, extracts values\r\n * from the options object using their paths, applies any normalization functions\r\n * (e.g., stripping `#` from hex colors), and returns a URL-encoded query string.\r\n \r\n @param options - The transformation options object\r\n * @param mode - Whether to use short aliases or long parameter names (default: `'short'`)\r\n * @returns URL-encoded query string (without leading `?`)\r\n \r\n @example\r\n * ```ts\r\n * // Using short aliases (default)\r\n * buildQueryParams({ width: 800, height: 600, quality: 80 });\r\n * // => 'w=800&h=600&q=80'\r\n \r\n // Using long parameter names\r\n * buildQueryParams({ width: 800, format: 'webp' }, 'long');\r\n * // => 'width=800&format=webp'\r\n \r\n // Nested options\r\n * buildQueryParams({ border: { width: 2, color: '#ff0000' } });\r\n * // => 'bo.w=2&bo.c=ff0000'\r\n * ```\r\n /\r\nexport const buildQueryParams = (\r\n options: TransformationOptions,\r\n mode: NameMode = 'short'\r\n): string => {\r\n const params: Array<[string, string]> = [];\r\n\r\n for (const spec of PARAMS) {\r\n const value = getNestedValue(options, spec.path);\r\n if (value == null) continue;\r\n\r\n const name =\r\n mode === 'short' && spec.short ? spec.short : spec.long;\r\n\r\n let normalized = value\r\n if ('normalize' in spec) {\r\n normalized = spec.normalize(value)\r\n }\r\n\r\n params.push([name, String(normalized)]);\r\n }\r\n\r\n\r\n return new URLSearchParams(\r\n params.map(([k, v]) => [k, v])\r\n ).toString();\r\n\r\n};\r\n\r\n/\r\n Builds a complete transformation URL from a base URL and transformation options.\r\n \r\n Combines the configured base URL with query parameters generated from the\r\n * transformation options. Handles the special `original` flag which returns\r\n * the unmodified source image.\r\n \r\n @param config - Configuration containing the base URL for the image\r\n * @param options - The transformation options to apply\r\n * @param mode - Whether to use short aliases or long parameter names (default: `'short'`)\r\n * @returns The complete URL string with query parameters\r\n \r\n @example\r\n * ```ts\r\n * const config = { baseUrl: 'https://cdn.example.com/images/photo.jpg' };\r\n \r\n // Basic resize\r\n * buildTransformationUrl(config, { width: 400, height: 300 });\r\n * // => 'https://cdn.example.com/images/photo.jpg?w=400&h=300'\r\n \r\n // Multiple transformations\r\n * buildTransformationUrl(config, {\r\n * width: 800,\r\n * format: 'webp',\r\n * quality: 85,\r\n * blur: 5\r\n * });\r\n * // => 'https://cdn.example.com/images/photo.jpg?w=800&f=webp&q=85&bl=5'\r\n \r\n // Request original image (no transformations)\r\n * buildTransformationUrl(config, { original: true });\r\n * // => 'https://cdn.example.com/images/photo.jpg?original'\r\n \r\n // Using long parameter names\r\n * buildTransformationUrl(config, { width: 400 }, 'long');\r\n * // => 'https://cdn.example.com/images/photo.jpg?width=400'\r\n * ```\r\n */\r\nexport const buildTransformationUrl = (\r\n config: UrlBuilderConfig,\r\n options: TransformationOptions,\r\n mode: NameMode = 'short'\r\n) => {\r\n if (options.original) {\r\n return `${config.baseUrl}?original`;\r\n }\r\n\r\n const query = buildQueryParams(options, mode);\r\n\r\n const baseUrl = removeTrailingSlash(config.baseUrl)\r\n return `${baseUrl}?${query}`;\r\n};\r\n"]}
1	+ {"version":3,"sources":["../src/src-set.ts","../src/utils.ts","../src/config.ts","../src/url-builder.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import { buildTransformationUrl, NameMode } from './url-builder';\r\nimport { TransformationOptions, UrlBuilderConfig } from './types';\r\nimport { clampMax, nearest, parseVW } from './utils';\r\n\r\n/*\r\n Maximum supported image width\r\n /\r\nexport const MAX_IMAGE_WIDTH = 4096;\r\n\r\n/\r\n Default device breakpoints for responsive srcset generation\r\n /\r\nexport const DEFAULT_DEVICE_BREAKPOINTS = [\r\n 320,\r\n 375,\r\n 640,\r\n 768,\r\n 1024,\r\n 1280,\r\n 1536,\r\n 1920\r\n] as const;\r\n\r\n/\r\n Default image breakpoints for smaller images (icons, thumbnails)\r\n /\r\nexport const DEFAULT_IMAGE_BREAKPOINTS = [16, 32, 48, 64, 96, 128, 256, 384] as const;\r\n\r\n/\r\n Options for responsive image attributes generation\r\n /\r\nexport interface ResponsiveImageOptions {\r\n /\r\n The `sizes` attribute value (e.g., \"100vw\", \"(max-width: 768px) 100vw, 50vw\").\r\n * When provided, generates width descriptors (`w`) for responsive layouts.\r\n /\r\n sizes?: string;\r\n /\r\n Fixed display width in CSS pixels.\r\n * When provided without `sizes`, generates DPR descriptors (`x`).\r\n /\r\n width?: number;\r\n /* Device breakpoints for viewport-based sizing (default: DEFAULT_DEVICE_BREAKPOINTS) /\r\n deviceBreakpoints?: number[];\r\n /* Image breakpoints for smaller images (default: DEFAULT_IMAGE_BREAKPOINTS) /\r\n imageBreakpoints?: number[];\r\n /* Base transformation options to apply to all variants /\r\n transformations?: TransformationOptions;\r\n /* Whether to use short or long parameter names (default: 'short') /\r\n mode?: NameMode;\r\n}\r\n\r\n/\r\n Result of responsive image attributes generation\r\n /\r\nexport interface ResponsiveImageResult {\r\n /* The src attribute value (largest/default variant) /\r\n src: string;\r\n /* The srcset attribute value /\r\n srcSet?: string;\r\n /* The sizes attribute value (for width descriptors) /\r\n sizes?: string;\r\n /* The width attribute value (when explicitly provided) /\r\n width?: number;\r\n}\r\n\r\n/\r\n Computes candidate widths and descriptor type based on input options.\r\n /\r\nconst DEFAULT_MAX_DPR = 2;\r\n\r\nfunction computeCandidateWidths(params: {\r\n allBreakpoints: number[];\r\n deviceBreakpoints: number[];\r\n explicitWidth?: number;\r\n sizesAttr?: string;\r\n}): { candidates: number[]; descriptor: 'w' \| 'x' } {\r\n const {\r\n allBreakpoints,\r\n deviceBreakpoints,\r\n explicitWidth,\r\n sizesAttr\r\n } = params;\r\n\r\n // ---- Normalize & guard ----\r\n const sortedAll = [...new Set(allBreakpoints)].sort((a, b) => a - b);\r\n const sortedDevice = [...new Set(deviceBreakpoints)].sort((a, b) => a - b);\r\n\r\n if (!sortedAll.length \|\| !sortedDevice.length) {\r\n return { candidates: [], descriptor: 'w' };\r\n }\r\n\r\n const minDevice = sortedDevice[0]!;\r\n const maxDevice = sortedDevice[sortedDevice.length - 1]!;\r\n\r\n const vwRatios = parseVW(sizesAttr);\r\n const hasVW = vwRatios.length > 0;\r\n\r\n // Explicit width (fixed layout) → x descriptors ----\r\n // Prefer this when layout width is known and sizes does NOT imply vw scaling\r\n if (typeof explicitWidth === 'number' && !hasVW) {\r\n const DPRs = [1, 2, 3];\r\n\r\n const candidates = Array.from(\r\n new Set(\r\n DPRs\r\n .map(dpr => nearest(sortedAll, explicitWidth dpr))\r\n .map(clampMax)\r\n )\r\n ).filter(w => w <= MAX_IMAGE_WIDTH);\r\n\r\n return {\r\n candidates,\r\n descriptor: 'x'\r\n };\r\n }\r\n\r\n // Sizes with vw → w descriptors ----\r\n if (hasVW) {\r\n const minRatio = Math.min(...vwRatios);\r\n const maxRatio = Math.max(...vwRatios);\r\n\r\n const minPx = minDevice * minRatio;\r\n const maxPx = maxDevice * maxRatio * DEFAULT_MAX_DPR;\r\n\r\n const candidates = sortedAll.filter(\r\n w => w >= minPx && w <= clampMax(maxPx)\r\n );\r\n\r\n return {\r\n candidates,\r\n descriptor: 'w'\r\n };\r\n }\r\n\r\n // No sizes & no explicit width → device-based w ----\r\n const maxUseful = maxDevice * DEFAULT_MAX_DPR;\r\n\r\n return {\r\n candidates: sortedAll.filter(w => w <= clampMax(maxUseful)),\r\n descriptor: 'w'\r\n };\r\n}\r\n\r\n/*\r\n Generates responsive image attributes (src, srcSet, sizes) for optimal loading.\r\n \r\n Supports two strategies:\r\n * 1. Responsive (with `sizes`): Uses width descriptors (`w`) for fluid layouts\r\n * where image size varies with viewport.\r\n * 2. Fixed width (with `width`): Uses DPR descriptors (`x`) for fixed-size\r\n * images that need high-DPI support.\r\n \r\n @param config - Configuration containing the base URL for the image\r\n * @param options - Options for responsive image generation\r\n * @returns Object containing src, srcSet, and optionally sizes attributes\r\n \r\n @example\r\n * ```ts\r\n * const config = { baseUrl: 'https://example.com/photo.jpg' };\r\n \r\n // Responsive image with sizes attribute (uses `w` descriptors)\r\n * createResponsiveAttributes(config, { sizes: '(max-width: 768px) 100vw, 50vw' });\r\n * // => {\r\n * // src: '...?w=3840',\r\n * // srcSet: '...?w=640 640w, ...?w=750 750w, ..., ...?w=3840 3840w',\r\n * // sizes: '(max-width: 768px) 100vw, 50vw'\r\n * // }\r\n \r\n // Fixed-width image (uses `x` descriptors)\r\n * createResponsiveAttributes(config, { width: 400 });\r\n * // => {\r\n * // src: '...?w=384',\r\n * // srcSet: '...?w=384 1x, ...?w=828 2x',\r\n * // width: 400\r\n * // }\r\n \r\n // With transformations\r\n * createResponsiveAttributes(config, {\r\n * sizes: '100vw',\r\n * transformations: { format: 'WEBP', quality: 80 }\r\n * });\r\n * ```\r\n /\r\nexport const createResponsiveAttributes = (\r\n config: UrlBuilderConfig,\r\n options: ResponsiveImageOptions = {}\r\n): ResponsiveImageResult => {\r\n const {\r\n sizes,\r\n width,\r\n deviceBreakpoints = [...DEFAULT_DEVICE_BREAKPOINTS],\r\n imageBreakpoints = [...DEFAULT_IMAGE_BREAKPOINTS],\r\n transformations = {},\r\n mode = 'short',\r\n } = options;\r\n\r\n const sortedDeviceBreakpoints = [...deviceBreakpoints].sort((a, b) => a - b);\r\n const sortedImageBreakpoints = [...imageBreakpoints].sort((a, b) => a - b);\r\n\r\n const allBreakpoints = [...new Set([...sortedImageBreakpoints, ...sortedDeviceBreakpoints])].sort((a, b) => a - b);\r\n\r\n const { candidates, descriptor } = computeCandidateWidths({\r\n allBreakpoints,\r\n deviceBreakpoints: sortedDeviceBreakpoints,\r\n ...(width !== undefined && { explicitWidth: width }),\r\n ...(sizes !== undefined && { sizesAttr: sizes }),\r\n });\r\n\r\n if (candidates.length === 0) {\r\n // Fallback: no valid candidates, return base URL\r\n return { src: config.baseUrl };\r\n }\r\n\r\n // Build srcSet entries\r\n const srcSetEntries = candidates.map((w, index,) => buildSrcEntries(w, index, config, transformations, mode, descriptor));\r\n\r\n // Default src is the largest candidate\r\n const largestWidth = candidates[candidates.length - 1]!;\r\n const src = buildTransformationUrl(\r\n config,\r\n { ...transformations, width: largestWidth },\r\n mode\r\n );\r\n\r\n const endSizes = sizes ?? (descriptor === 'w' ? '100vw' : undefined);\r\n\r\n return {\r\n src,\r\n ...(endSizes ? { sizes: endSizes } : {}),\r\n srcSet: srcSetEntries.join(', '),\r\n ...(width !== undefined ? { width } : {}),\r\n };\r\n};\r\n\r\nfunction buildSrcEntries(width: number, index: number, config: UrlBuilderConfig, transformations: TransformationOptions, mode: NameMode, descriptor: 'w' \| 'x'): string {\r\n const url = buildTransformationUrl(\r\n config,\r\n { ...transformations, width: width },\r\n mode\r\n );\r\n\r\n const desc = descriptor === 'w' ? `${width}w` : `${index + 1}x`;\r\n\r\n return `${url} ${desc}`;\r\n}\r\n","import { Path, PathValue } from './util-types';\r\nimport { MAX_IMAGE_WIDTH } from './src-set';\r\n\r\nexport const normalizeHex = (value: string) => value.replace('#', '')\r\n\r\n\r\nexport const removeTrailingSlash = (baseUrl: string) => {\r\n return baseUrl.endsWith('/')\r\n ? baseUrl.slice(0, -1)\r\n : baseUrl;\r\n}\r\n\r\nexport const getNestedValue = <\r\n T,\r\n P extends Path<T>\r\n>(\r\n obj: T,\r\n path: P\r\n): PathValue<T, P> \| undefined =>\r\n path.reduce<any>(\r\n (acc, key) => (acc == null ? undefined : acc[key]),\r\n obj\r\n );\r\n\r\n\r\nexport const clampMax = (v: number) => Math.min(v, MAX_IMAGE_WIDTH);\r\n\r\nexport const nearest = (sortedBreakpoints: number[],target: number) =>\r\n sortedBreakpoints.find(w => w >= target) ?? sortedBreakpoints[sortedBreakpoints.length - 1]!;\r\n\r\nexport const parseVW = (sizes?: string): number[] => {\r\n if (!sizes) return [];\r\n return [...sizes.matchAll(/(\\d+(?:\\.\\d+)?)vw/g)].map(\r\n m => Number(m[1]) / 100\r\n );\r\n};\r\n\r\n","import { ParamSpec, Path } from './util-types';\r\nimport { TransformationOptions } from './types';\r\nimport { normalizeHex } from './utils';\r\n\r\nexport const PARAMS = [\r\n {path: ['width'], long: 'width', short: 'w'},\r\n {path: ['height'], long: 'height', short: 'h'},\r\n {path: ['dpr'], long: 'dpr', short: 'dpr'},\r\n {path: ['mode'], long: 'mode', short: 'rm'},\r\n {\r\n path: ['background'],\r\n long: 'background',\r\n short: 'bg',\r\n normalize: (v) => typeof v === 'string' ? normalizeHex(v) : v\r\n },\r\n\r\n {path: ['format'], long: 'format', short: 'f'},\r\n {path: ['quality'], long: 'quality', short: 'q'},\r\n {path: ['stripMetadata'], long: 'stripMetadata', short: 'st'},\r\n\r\n {path: ['blur'], long: 'blur', short: 'bl'},\r\n {path: ['brightness'], long: 'brightness', short: 'br'},\r\n {path: ['contrast'], long: 'contrast', short: 'ct'},\r\n {path: ['grayscale'], long: 'grayscale', short: 'gs'},\r\n {path: ['saturation'], long: 'saturation', short: 'sa'},\r\n {path: ['sepia'], long: 'sepia', short: 'sp'},\r\n {path: ['sharpen'], long: 'sharpen', short: 'sh'},\r\n {path: ['noise'], long: 'noise', short: 'ns'},\r\n {path: ['rotate'], long: 'rotate', short: 'rt'},\r\n\r\n {path: ['border', 'width'], long: 'border.width', short: 'bo.w'},\r\n {\r\n path: ['border', 'color'],\r\n long: 'border.color',\r\n short: 'bo.c',\r\n normalize: (v) => typeof v === 'string' ? normalizeHex(v) : v\r\n },\r\n {path: ['border', 'radius'], long: 'border.radius', short: 'bo.r'},\r\n\r\n {path: ['crop', 'type'], long: 'crop.type', short: 'cr.t'},\r\n {path: ['crop', 'objectType'], long: 'crop.objectType', short: 'cr.o'},\r\n {path: ['crop', 'focus', 'position', 'x'], long: 'crop.x', short: 'cr.x'},\r\n {path: ['crop', 'focus', 'position', 'y'], long: 'crop.y', short: 'cr.y'},\r\n {path: ['crop', 'focus', 'strategy'], long: 'crop', short: 'cr'},\r\n {path: ['crop', 'width'], long: 'crop.width', short: 'cr.w'},\r\n {path: ['crop', 'height'], long: 'crop.height', short: 'cr.h'},\r\n {path: ['crop', 'afterResize'], long: 'crop.afterResize', short: 'cr.ar'},\r\n\r\n {path: ['text', 'text'], long: 'text', short: 'tx'},\r\n {\r\n path: ['text', 'color'],\r\n long: 'text.color',\r\n short: 'tx.c',\r\n normalize: (v) => typeof v === 'string' ? normalizeHex(v) : v\r\n },\r\n {path: ['text', 'opacity'], long: 'text.opacity', short: 'tx.o'},\r\n {path: ['text', 'size'], long: 'text.size', short: 'tx.s'},\r\n {path: ['text', 'font'], long: 'text.font', short: 'tx.f'},\r\n {path: ['text', 'fontSize'], long: 'text.fontSize', short: 'tx.fs'},\r\n {path: ['text', 'position'], long: 'text.position', short: 'tx.p'},\r\n {\r\n path: ['text', 'background'],\r\n long: 'text.background',\r\n short: 'tx.bg',\r\n normalize: (v) => typeof v === 'string' ? normalizeHex(v) : v\r\n },\r\n {path: ['text', 'backgroundOpacity'], long: 'text.backgroundOpacity', short: 'tx.bg.o'},\r\n\r\n {path: ['watermark', 'name'], long: 'watermark', short: 'wm'},\r\n {path: ['watermark', 'opacity'], long: 'watermark.opacity', short: 'wm.o'},\r\n {path: ['watermark', 'size'], long: 'watermark.size', short: 'wm.s'},\r\n {path: ['watermark', 'width'], long: 'watermark.width', short: 'wm.w'},\r\n {path: ['watermark', 'height'], long: 'watermark.height', short: 'wm.h'},\r\n {path: ['watermark', 'position'], long: 'watermark.position', short: 'wm.p'},\r\n] as const satisfies readonly ParamSpec<\r\n TransformationOptions,\r\n Path<TransformationOptions>\r\n>[];\r\n","import { TransformationOptions, UrlBuilderConfig } from './types';\r\nimport { getNestedValue, removeTrailingSlash } from './utils';\r\nimport { PARAMS } from './config';\r\n\r\n/\r\n Determines which parameter names to use in the query string.\r\n * - `'short'` - Use abbreviated aliases (e.g., `w`, `h`, `q`)\r\n * - `'long'` - Use full parameter names (e.g., `width`, `height`, `quality`)\r\n /\r\nexport type NameMode = 'short' \| 'long';\r\n\r\n/\r\n Converts transformation options into a URL-encoded query string.\r\n \r\n Iterates through all defined parameters in the PARAMS config, extracts values\r\n * from the options object using their paths, applies any normalization functions\r\n * (e.g., stripping `#` from hex colors), and returns a URL-encoded query string.\r\n \r\n @param options - The transformation options object\r\n * @param mode - Whether to use short aliases or long parameter names (default: `'short'`)\r\n * @returns URL-encoded query string (without leading `?`)\r\n \r\n @example\r\n * ```ts\r\n * // Using short aliases (default)\r\n * buildQueryParams({ width: 800, height: 600, quality: 80 });\r\n * // => 'w=800&h=600&q=80'\r\n \r\n // Using long parameter names\r\n * buildQueryParams({ width: 800, format: 'webp' }, 'long');\r\n * // => 'width=800&format=webp'\r\n \r\n // Nested options\r\n * buildQueryParams({ border: { width: 2, color: '#ff0000' } });\r\n * // => 'bo.w=2&bo.c=ff0000'\r\n * ```\r\n /\r\nexport const buildTransformationQueryParams = (\r\n options: TransformationOptions,\r\n mode: NameMode = 'short'\r\n): string => {\r\n const params: Array<[string, string]> = [];\r\n\r\n for (const spec of PARAMS) {\r\n const value = getNestedValue(options, spec.path);\r\n if (value == null) continue;\r\n\r\n const name =\r\n mode === 'short' && spec.short ? spec.short : spec.long;\r\n\r\n let normalized = value\r\n if ('normalize' in spec) {\r\n normalized = spec.normalize(value)\r\n }\r\n\r\n params.push([name, String(normalized)]);\r\n }\r\n\r\n\r\n return new URLSearchParams(\r\n params.map(([k, v]) => [k, v])\r\n ).toString();\r\n\r\n};\r\n\r\n/\r\n Builds a complete transformation URL from a base URL and transformation options.\r\n \r\n Combines the configured base URL with query parameters generated from the\r\n * transformation options. Handles the special `original` flag which returns\r\n * the unmodified source image.\r\n \r\n @param config - Configuration containing the base URL for the image\r\n * @param options - The transformation options to apply\r\n * @param mode - Whether to use short aliases or long parameter names (default: `'short'`)\r\n * @returns The complete URL string with query parameters\r\n \r\n @example\r\n * ```ts\r\n * const config = { baseUrl: 'https://example.com/images/photo.jpg' };\r\n \r\n // Basic resize\r\n * buildTransformationUrl(config, { width: 400, height: 300 });\r\n * // => 'https://example.com/images/photo.jpg?w=400&h=300'\r\n \r\n // Multiple transformations\r\n * buildTransformationUrl(config, {\r\n * width: 800,\r\n * format: 'webp',\r\n * quality: 85,\r\n * blur: 5\r\n * });\r\n * // => 'https://example.com/images/photo.jpg?w=800&f=webp&q=85&bl=5'\r\n \r\n // Request original image (no transformations)\r\n * buildTransformationUrl(config, { original: true });\r\n * // => 'https://example.com/images/photo.jpg?original'\r\n \r\n // Using long parameter names\r\n * buildTransformationUrl(config, { width: 400 }, 'long');\r\n * // => 'https://example.com/images/photo.jpg?width=400'\r\n * ```\r\n */\r\nexport const buildTransformationUrl = (\r\n config: UrlBuilderConfig,\r\n options: TransformationOptions,\r\n mode: NameMode = 'short'\r\n) => {\r\n if (options.original) {\r\n return `${config.baseUrl}?original`;\r\n }\r\n\r\n const query = buildTransformationQueryParams(options, mode);\r\n\r\n const baseUrl = removeTrailingSlash(config.baseUrl)\r\n return `${baseUrl}?${query}`;\r\n};\r\n"]}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@pixelfiddler/core",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Core utilities for PixelFiddler image transformation SDK",
   "type": "module",
   "main": "./dist/index.cjs",