imgix-url-builder 0.0.4 → 0.0.5

package/dist/Client.cjs

@@ -0,0 +1,143 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const buildPixelDensitySrcSet = require("./buildPixelDensitySrcSet.cjs");
+const buildURL = require("./buildURL.cjs");
+const buildWidthSrcSet = require("./buildWidthSrcSet.cjs");
+class Client {
+  /**
+   * Creates a new `Client` instance for an Imgix domain.
+   *
+   * @param options - Options to instantiate a new client.
+   *
+   * @returns A `Client` instance for the given Imgix domain.
+   */
+  constructor(options) {
+    __publicField(this, "baseURL");
+    this.baseURL = options.baseURL;
+  }
+  /**
+   * Builds a URL to an Imgix image with Imgix URL API parameters for the
+   * client's base URL.
+   *
+   * @example
+   *
+   * ```ts
+   * const client = new Client({ baseURL: "https://example.imgix.net" });
+   * const url = client.buildURLForPath("/image.png", { width: 400 });
+   * // => https://example.imgix.net/image.png?width=400
+   * ```
+   *
+   * @example
+   *
+   * ```ts
+   * const client = new Client({
+   * 	baseURL: "https://example.imgix.net/folder",
+   * });
+   * const url = client.buildURLForPath("./image.png", { width: 400 });
+   * // => https://example.imgix.net/folder/image.png?width=400
+   * ```
+   *
+   * @param path - Path to the image relative to the client's base URL.
+   * @param params - An object of Imgix URL API parameters.
+   *
+   * @returns The full absolute URL to the image with the given Imgix URL API
+   *   parameters applied.
+   */
+  buildURLForPath(path, params = {}) {
+    return buildURL.buildURL(`${new URL(path, this.baseURL)}`, params);
+  }
+  /**
+   * Builds an `<img>` `srcset` attribute value for a given set of widths for
+   * the client's base URL. It can also optinally apply Imgix URL API parameters
+   * to the URLs.
+   *
+   * The `width` URL parameter will be applied for each `srcset` entry. If a
+   * `width` or `w` parameter is provided to the `params` parameter, it will be
+   * ignored.
+   *
+   * @example
+   *
+   * ```ts
+   * const client = new Client({ baseURL: "https://example.imgix.net" });
+   * const srcset = client.buildWidthSrcSetForPath("/image.png", {
+   * 	widths: [400, 800, 1600],
+   * });
+   * // => https://example.imgix.net/image.png?width=400 400w,
+   * //    https://example.imgix.net/image.png?width=800 800w,
+   * //    https://example.imgix.net/image.png?width=1600 1600w
+   * ```
+   *
+   * @example
+   *
+   * ```ts
+   * const client = new Client({
+   * 	baseURL: "https://example.imgix.net",
+   * });
+   * const srcset = client.buildWidthSrcSetForPath("/image.png", {
+   * 	widths: [400, 800, 1600],
+   * 	sat: -100,
+   * });
+   * // => https://example.imgix.net/image.png?width=400&sat=-100 400w,
+   * //    https://example.imgix.net/image.png?width=800&sat=-100 800w,
+   * //    https://example.imgix.net/image.png?width=1600&sat=-100 1600w
+   * ```
+   *
+   * @param path - Path to the image relative to the client's base URL.
+   * @param params - An object of Imgix URL API parameters. The `widths`
+   *   parameter defines the resulting `srcset` widths.
+   *
+   * @returns A `srcset` attribute value for `url` with the given Imgix URL API
+   *   parameters applied.
+   */
+  buildWidthSrcSetForPath(path, params) {
+    return buildWidthSrcSet.buildWidthSrcSet(`${new URL(path, this.baseURL)}`, params);
+  }
+  /**
+   * Builds an `<img>` `srcset` attribute value for a given set of pixel
+   * densities for the client's base URL. It can also optinally apply Imgix URL
+   * API parameters to the URLs.
+   *
+   * The `dpr` URL parameter will be applied for each `srcset` entry. If a `dpr`
+   * parameter is provided to the `params` parameter, it will be ignored.
+   *
+   * @example
+   *
+   * ```ts
+   * const client = new Client({ baseURL: "https://example.imgix.net" });
+   * const srcset = client.buildPixelDensitySrcSetForPath("/image.png", {
+   * 	pixelDensities: [1, 2, 3],
+   * });
+   * // => https://example.imgix.net/image.png?dpr=1 1x,
+   * //    https://example.imgix.net/image.png?dpr=2 2x,
+   * //    https://example.imgix.net/image.png?dpr=3 3x
+   * ```
+   *
+   * @example
+   *
+   * ```ts
+   * const client = new Client({ baseURL: "https://example.imgix.net" });
+   * const srcset = client.buildPixelDensitySrcSetForPath("/image.png", {
+   * 	pixelDensities: [1, 2, 3],
+   * 	sat: -100,
+   * });
+   * // => https://example.imgix.net/image.png?dpr=1&sat=-100 1x,
+   * //    https://example.imgix.net/image.png?dpr=2&sat=-100 2x,
+   * //    https://example.imgix.net/image.png?dpr=3&sat=-100 3x
+   * ```
+   *
+   * @param path - Path to the image relative to the client's base URL.
+   * @param params - An object of Imgix URL API parameters. The `pixelDensities`
+   *   parameter defines the resulting `srcset` widths.
+   *
+   * @returns A `srcset` attribute value for `url` with the given Imgix URL API
+   *   parameters applied.
+   */
+  buildPixelDensitySrcSetForPath(path, params) {
+    return buildPixelDensitySrcSet.buildPixelDensitySrcSet(`${new URL(path, this.baseURL)}`, params);
+  }
+}
+exports.Client = Client;
+//# sourceMappingURL=Client.cjs.map

package/dist/Client.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Client.cjs","sources":["../../src/Client.ts"],"sourcesContent":["import type { BuildPixelDensitySrcSetParams } from \"./buildPixelDensitySrcSet\";\nimport type { BuildWidthSrcSetParams } from \"./buildWidthSrcSet\";\nimport type { ImgixURLParams } from \"./types.generated\";\nimport { buildPixelDensitySrcSet } from \"./buildPixelDensitySrcSet\";\nimport { buildURL } from \"./buildURL\";\nimport { buildWidthSrcSet } from \"./buildWidthSrcSet\";\n\n/**\n * Options to instantiate a new client.\n */\nexport type ClientOptions = {\n\t/**\n\t * The base URL used to construct image URLs from a path. The base URL must\n\t * include the protocol, domain, and optionally a path.\n\t *\n\t * @example `https://example.imgix.net`\n\t *\n\t * @example `https://example.imgix.net/folder`\n\t */\n\tbaseURL: string;\n};\n\n/**\n * An Imgix Rendering API client. A client is paired to a single Imgix domain.\n */\nexport class Client {\n\tbaseURL: string;\n\n\t/**\n\t * Creates a new `Client` instance for an Imgix domain.\n\t *\n\t * @param options - Options to instantiate a new client.\n\t *\n\t * @returns A `Client` instance for the given Imgix domain.\n\t */\n\tconstructor(options: ClientOptions) {\n\t\tthis.baseURL = options.baseURL;\n\t}\n\n\t/**\n\t * Builds a URL to an Imgix image with Imgix URL API parameters for the\n\t * client's base URL.\n\t *\n\t * @example\n\t *\n\t * ```ts\n\t * const client = new Client({ baseURL: \"https://example.imgix.net\" });\n\t * const url = client.buildURLForPath(\"/image.png\", { width: 400 });\n\t * // => https://example.imgix.net/image.png?width=400\n\t * ```\n\t *\n\t * @example\n\t *\n\t * ```ts\n\t * const client = new Client({\n\t * \tbaseURL: \"https://example.imgix.net/folder\",\n\t * });\n\t * const url = client.buildURLForPath(\"./image.png\", { width: 400 });\n\t * // => https://example.imgix.net/folder/image.png?width=400\n\t * ```\n\t *\n\t * @param path - Path to the image relative to the client's base URL.\n\t * @param params - An object of Imgix URL API parameters.\n\t *\n\t * @returns The full absolute URL to the image with the given Imgix URL API\n\t *   parameters applied.\n\t */\n\tbuildURLForPath(path: string, params: ImgixURLParams = {}) {\n\t\treturn buildURL(`${new URL(path, this.baseURL)}`, params);\n\t}\n\n\t/**\n\t * Builds an `<img>` `srcset` attribute value for a given set of widths for\n\t * the client's base URL. It can also optinally apply Imgix URL API parameters\n\t * to the URLs.\n\t *\n\t * The `width` URL parameter will be applied for each `srcset` entry. If a\n\t * `width` or `w` parameter is provided to the `params` parameter, it will be\n\t * ignored.\n\t *\n\t * @example\n\t *\n\t * ```ts\n\t * const client = new Client({ baseURL: \"https://example.imgix.net\" });\n\t * const srcset = client.buildWidthSrcSetForPath(\"/image.png\", {\n\t * \twidths: [400, 800, 1600],\n\t * });\n\t * // => https://example.imgix.net/image.png?width=400 400w,\n\t * //    https://example.imgix.net/image.png?width=800 800w,\n\t * //    https://example.imgix.net/image.png?width=1600 1600w\n\t * ```\n\t *\n\t * @example\n\t *\n\t * ```ts\n\t * const client = new Client({\n\t * \tbaseURL: \"https://example.imgix.net\",\n\t * });\n\t * const srcset = client.buildWidthSrcSetForPath(\"/image.png\", {\n\t * \twidths: [400, 800, 1600],\n\t * \tsat: -100,\n\t * });\n\t * // => https://example.imgix.net/image.png?width=400&sat=-100 400w,\n\t * //    https://example.imgix.net/image.png?width=800&sat=-100 800w,\n\t * //    https://example.imgix.net/image.png?width=1600&sat=-100 1600w\n\t * ```\n\t *\n\t * @param path - Path to the image relative to the client's base URL.\n\t * @param params - An object of Imgix URL API parameters. The `widths`\n\t *   parameter defines the resulting `srcset` widths.\n\t *\n\t * @returns A `srcset` attribute value for `url` with the given Imgix URL API\n\t *   parameters applied.\n\t */\n\tbuildWidthSrcSetForPath(path: string, params: BuildWidthSrcSetParams) {\n\t\treturn buildWidthSrcSet(`${new URL(path, this.baseURL)}`, params);\n\t}\n\n\t/**\n\t * Builds an `<img>` `srcset` attribute value for a given set of pixel\n\t * densities for the client's base URL. It can also optinally apply Imgix URL\n\t * API parameters to the URLs.\n\t *\n\t * The `dpr` URL parameter will be applied for each `srcset` entry. If a `dpr`\n\t * parameter is provided to the `params` parameter, it will be ignored.\n\t *\n\t * @example\n\t *\n\t * ```ts\n\t * const client = new Client({ baseURL: \"https://example.imgix.net\" });\n\t * const srcset = client.buildPixelDensitySrcSetForPath(\"/image.png\", {\n\t * \tpixelDensities: [1, 2, 3],\n\t * });\n\t * // => https://example.imgix.net/image.png?dpr=1 1x,\n\t * //    https://example.imgix.net/image.png?dpr=2 2x,\n\t * //    https://example.imgix.net/image.png?dpr=3 3x\n\t * ```\n\t *\n\t * @example\n\t *\n\t * ```ts\n\t * const client = new Client({ baseURL: \"https://example.imgix.net\" });\n\t * const srcset = client.buildPixelDensitySrcSetForPath(\"/image.png\", {\n\t * \tpixelDensities: [1, 2, 3],\n\t * \tsat: -100,\n\t * });\n\t * // => https://example.imgix.net/image.png?dpr=1&sat=-100 1x,\n\t * //    https://example.imgix.net/image.png?dpr=2&sat=-100 2x,\n\t * //    https://example.imgix.net/image.png?dpr=3&sat=-100 3x\n\t * ```\n\t *\n\t * @param path - Path to the image relative to the client's base URL.\n\t * @param params - An object of Imgix URL API parameters. The `pixelDensities`\n\t *   parameter defines the resulting `srcset` widths.\n\t *\n\t * @returns A `srcset` attribute value for `url` with the given Imgix URL API\n\t *   parameters applied.\n\t */\n\tbuildPixelDensitySrcSetForPath(\n\t\tpath: string,\n\t\tparams: BuildPixelDensitySrcSetParams,\n\t) {\n\t\treturn buildPixelDensitySrcSet(`${new URL(path, this.baseURL)}`, params);\n\t}\n}\n"],"names":["buildURL","buildWidthSrcSet","buildPixelDensitySrcSet"],"mappings":";;;;;;;;MAyBa,OAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUlB,YAAY,SAAsB;AATlC;AAUC,SAAK,UAAU,QAAQ;AAAA,EACxB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA8BA,gBAAgB,MAAc,SAAyB,IAAE;AACjD,WAAAA,SAAA,SAAS,GAAG,IAAI,IAAI,MAAM,KAAK,OAAO,CAAC,IAAI,MAAM;AAAA,EACzD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA6CA,wBAAwB,MAAc,QAA8B;AAC5D,WAAAC,iBAAA,iBAAiB,GAAG,IAAI,IAAI,MAAM,KAAK,OAAO,CAAC,IAAI,MAAM;AAAA,EACjE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA0CA,+BACC,MACA,QAAqC;AAE9B,WAAAC,wBAAA,wBAAwB,GAAG,IAAI,IAAI,MAAM,KAAK,OAAO,CAAC,IAAI,MAAM;AAAA,EACxE;AACA;;"}

package/dist/Client.d.ts

@@ -0,0 +1,145 @@
+import type { BuildPixelDensitySrcSetParams } from "./buildPixelDensitySrcSet";
+import type { BuildWidthSrcSetParams } from "./buildWidthSrcSet";
+import type { ImgixURLParams } from "./types.generated";
+/**
+ * Options to instantiate a new client.
+ */
+export type ClientOptions = {
+    /**
+     * The base URL used to construct image URLs from a path. The base URL must
+     * include the protocol, domain, and optionally a path.
+     *
+     * @example `https://example.imgix.net`
+     *
+     * @example `https://example.imgix.net/folder`
+     */
+    baseURL: string;
+};
+/**
+ * An Imgix Rendering API client. A client is paired to a single Imgix domain.
+ */
+export declare class Client {
+    baseURL: string;
+    /**
+     * Creates a new `Client` instance for an Imgix domain.
+     *
+     * @param options - Options to instantiate a new client.
+     *
+     * @returns A `Client` instance for the given Imgix domain.
+     */
+    constructor(options: ClientOptions);
+    /**
+     * Builds a URL to an Imgix image with Imgix URL API parameters for the
+     * client's base URL.
+     *
+     * @example
+     *
+     * ```ts
+     * const client = new Client({ baseURL: "https://example.imgix.net" });
+     * const url = client.buildURLForPath("/image.png", { width: 400 });
+     * // => https://example.imgix.net/image.png?width=400
+     * ```
+     *
+     * @example
+     *
+     * ```ts
+     * const client = new Client({
+     * 	baseURL: "https://example.imgix.net/folder",
+     * });
+     * const url = client.buildURLForPath("./image.png", { width: 400 });
+     * // => https://example.imgix.net/folder/image.png?width=400
+     * ```
+     *
+     * @param path - Path to the image relative to the client's base URL.
+     * @param params - An object of Imgix URL API parameters.
+     *
+     * @returns The full absolute URL to the image with the given Imgix URL API
+     *   parameters applied.
+     */
+    buildURLForPath(path: string, params?: ImgixURLParams): string;
+    /**
+     * Builds an `<img>` `srcset` attribute value for a given set of widths for
+     * the client's base URL. It can also optinally apply Imgix URL API parameters
+     * to the URLs.
+     *
+     * The `width` URL parameter will be applied for each `srcset` entry. If a
+     * `width` or `w` parameter is provided to the `params` parameter, it will be
+     * ignored.
+     *
+     * @example
+     *
+     * ```ts
+     * const client = new Client({ baseURL: "https://example.imgix.net" });
+     * const srcset = client.buildWidthSrcSetForPath("/image.png", {
+     * 	widths: [400, 800, 1600],
+     * });
+     * // => https://example.imgix.net/image.png?width=400 400w,
+     * //    https://example.imgix.net/image.png?width=800 800w,
+     * //    https://example.imgix.net/image.png?width=1600 1600w
+     * ```
+     *
+     * @example
+     *
+     * ```ts
+     * const client = new Client({
+     * 	baseURL: "https://example.imgix.net",
+     * });
+     * const srcset = client.buildWidthSrcSetForPath("/image.png", {
+     * 	widths: [400, 800, 1600],
+     * 	sat: -100,
+     * });
+     * // => https://example.imgix.net/image.png?width=400&sat=-100 400w,
+     * //    https://example.imgix.net/image.png?width=800&sat=-100 800w,
+     * //    https://example.imgix.net/image.png?width=1600&sat=-100 1600w
+     * ```
+     *
+     * @param path - Path to the image relative to the client's base URL.
+     * @param params - An object of Imgix URL API parameters. The `widths`
+     *   parameter defines the resulting `srcset` widths.
+     *
+     * @returns A `srcset` attribute value for `url` with the given Imgix URL API
+     *   parameters applied.
+     */
+    buildWidthSrcSetForPath(path: string, params: BuildWidthSrcSetParams): string;
+    /**
+     * Builds an `<img>` `srcset` attribute value for a given set of pixel
+     * densities for the client's base URL. It can also optinally apply Imgix URL
+     * API parameters to the URLs.
+     *
+     * The `dpr` URL parameter will be applied for each `srcset` entry. If a `dpr`
+     * parameter is provided to the `params` parameter, it will be ignored.
+     *
+     * @example
+     *
+     * ```ts
+     * const client = new Client({ baseURL: "https://example.imgix.net" });
+     * const srcset = client.buildPixelDensitySrcSetForPath("/image.png", {
+     * 	pixelDensities: [1, 2, 3],
+     * });
+     * // => https://example.imgix.net/image.png?dpr=1 1x,
+     * //    https://example.imgix.net/image.png?dpr=2 2x,
+     * //    https://example.imgix.net/image.png?dpr=3 3x
+     * ```
+     *
+     * @example
+     *
+     * ```ts
+     * const client = new Client({ baseURL: "https://example.imgix.net" });
+     * const srcset = client.buildPixelDensitySrcSetForPath("/image.png", {
+     * 	pixelDensities: [1, 2, 3],
+     * 	sat: -100,
+     * });
+     * // => https://example.imgix.net/image.png?dpr=1&sat=-100 1x,
+     * //    https://example.imgix.net/image.png?dpr=2&sat=-100 2x,
+     * //    https://example.imgix.net/image.png?dpr=3&sat=-100 3x
+     * ```
+     *
+     * @param path - Path to the image relative to the client's base URL.
+     * @param params - An object of Imgix URL API parameters. The `pixelDensities`
+     *   parameter defines the resulting `srcset` widths.
+     *
+     * @returns A `srcset` attribute value for `url` with the given Imgix URL API
+     *   parameters applied.
+     */
+    buildPixelDensitySrcSetForPath(path: string, params: BuildPixelDensitySrcSetParams): string;
+}

package/dist/{index.mjs → Client.js}

@@ -1,41 +1,9 @@
-const camelCaseToParamCase = (input) => {
-  return input.replace(/[A-Z]/g, (match) => {
-    return `-${match.toLowerCase()}`;
-  });
-};
-const buildURL = (url, params) => {
-  const instance = new URL(url);
-  for (const camelCasedParamKey in params) {
-    const paramKey = camelCaseToParamCase(camelCasedParamKey);
-    const paramValue = params[camelCasedParamKey];
-    if (paramValue === void 0) {
-      instance.searchParams.delete(paramKey);
-    } else if (Array.isArray(paramValue)) {
-      instance.searchParams.set(paramKey, paramValue.join(","));
-    } else {
-      instance.searchParams.set(paramKey, `${paramValue}`);
-    }
-  }
-  const s = instance.searchParams.get("s");
-  if (s) {
-    instance.searchParams.delete("s");
-    instance.searchParams.append("s", s);
-  }
-  return instance.toString();
-};
-
-const buildPixelDensitySrcSet = (url, { pixelDensities, ...params }) => {
-  return pixelDensities.map((dpr) => {
-    return `${buildURL(url, { ...params, dpr })} ${dpr}x`;
-  }).join(", ");
-};
-
-const buildWidthSrcSet = (url, { widths, ...params }) => {
-  return widths.map((width) => {
-    return `${buildURL(url, { ...params, w: void 0, width })} ${width}w`;
-  }).join(", ");
-};
-
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+import { buildPixelDensitySrcSet } from "./buildPixelDensitySrcSet.js";
+import { buildURL } from "./buildURL.js";
+import { buildWidthSrcSet } from "./buildWidthSrcSet.js";
 class Client {
   /**
    * Creates a new `Client` instance for an Imgix domain.
@@ -45,6 +13,7 @@ class Client {
    * @returns A `Client` instance for the given Imgix domain.
    */
   constructor(options) {
+    __publicField(this, "baseURL");
     this.baseURL = options.baseURL;
   }
   /**
@@ -168,6 +137,7 @@ class Client {
     return buildPixelDensitySrcSet(`${new URL(path, this.baseURL)}`, params);
   }
 }
-
-export { Client, buildPixelDensitySrcSet, buildURL, buildWidthSrcSet };
-//# sourceMappingURL=index.mjs.map
+export {
+  Client
+};
+//# sourceMappingURL=Client.js.map

package/dist/Client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Client.js","sources":["../../src/Client.ts"],"sourcesContent":["import type { BuildPixelDensitySrcSetParams } from \"./buildPixelDensitySrcSet\";\nimport type { BuildWidthSrcSetParams } from \"./buildWidthSrcSet\";\nimport type { ImgixURLParams } from \"./types.generated\";\nimport { buildPixelDensitySrcSet } from \"./buildPixelDensitySrcSet\";\nimport { buildURL } from \"./buildURL\";\nimport { buildWidthSrcSet } from \"./buildWidthSrcSet\";\n\n/**\n * Options to instantiate a new client.\n */\nexport type ClientOptions = {\n\t/**\n\t * The base URL used to construct image URLs from a path. The base URL must\n\t * include the protocol, domain, and optionally a path.\n\t *\n\t * @example `https://example.imgix.net`\n\t *\n\t * @example `https://example.imgix.net/folder`\n\t */\n\tbaseURL: string;\n};\n\n/**\n * An Imgix Rendering API client. A client is paired to a single Imgix domain.\n */\nexport class Client {\n\tbaseURL: string;\n\n\t/**\n\t * Creates a new `Client` instance for an Imgix domain.\n\t *\n\t * @param options - Options to instantiate a new client.\n\t *\n\t * @returns A `Client` instance for the given Imgix domain.\n\t */\n\tconstructor(options: ClientOptions) {\n\t\tthis.baseURL = options.baseURL;\n\t}\n\n\t/**\n\t * Builds a URL to an Imgix image with Imgix URL API parameters for the\n\t * client's base URL.\n\t *\n\t * @example\n\t *\n\t * ```ts\n\t * const client = new Client({ baseURL: \"https://example.imgix.net\" });\n\t * const url = client.buildURLForPath(\"/image.png\", { width: 400 });\n\t * // => https://example.imgix.net/image.png?width=400\n\t * ```\n\t *\n\t * @example\n\t *\n\t * ```ts\n\t * const client = new Client({\n\t * \tbaseURL: \"https://example.imgix.net/folder\",\n\t * });\n\t * const url = client.buildURLForPath(\"./image.png\", { width: 400 });\n\t * // => https://example.imgix.net/folder/image.png?width=400\n\t * ```\n\t *\n\t * @param path - Path to the image relative to the client's base URL.\n\t * @param params - An object of Imgix URL API parameters.\n\t *\n\t * @returns The full absolute URL to the image with the given Imgix URL API\n\t *   parameters applied.\n\t */\n\tbuildURLForPath(path: string, params: ImgixURLParams = {}) {\n\t\treturn buildURL(`${new URL(path, this.baseURL)}`, params);\n\t}\n\n\t/**\n\t * Builds an `<img>` `srcset` attribute value for a given set of widths for\n\t * the client's base URL. It can also optinally apply Imgix URL API parameters\n\t * to the URLs.\n\t *\n\t * The `width` URL parameter will be applied for each `srcset` entry. If a\n\t * `width` or `w` parameter is provided to the `params` parameter, it will be\n\t * ignored.\n\t *\n\t * @example\n\t *\n\t * ```ts\n\t * const client = new Client({ baseURL: \"https://example.imgix.net\" });\n\t * const srcset = client.buildWidthSrcSetForPath(\"/image.png\", {\n\t * \twidths: [400, 800, 1600],\n\t * });\n\t * // => https://example.imgix.net/image.png?width=400 400w,\n\t * //    https://example.imgix.net/image.png?width=800 800w,\n\t * //    https://example.imgix.net/image.png?width=1600 1600w\n\t * ```\n\t *\n\t * @example\n\t *\n\t * ```ts\n\t * const client = new Client({\n\t * \tbaseURL: \"https://example.imgix.net\",\n\t * });\n\t * const srcset = client.buildWidthSrcSetForPath(\"/image.png\", {\n\t * \twidths: [400, 800, 1600],\n\t * \tsat: -100,\n\t * });\n\t * // => https://example.imgix.net/image.png?width=400&sat=-100 400w,\n\t * //    https://example.imgix.net/image.png?width=800&sat=-100 800w,\n\t * //    https://example.imgix.net/image.png?width=1600&sat=-100 1600w\n\t * ```\n\t *\n\t * @param path - Path to the image relative to the client's base URL.\n\t * @param params - An object of Imgix URL API parameters. The `widths`\n\t *   parameter defines the resulting `srcset` widths.\n\t *\n\t * @returns A `srcset` attribute value for `url` with the given Imgix URL API\n\t *   parameters applied.\n\t */\n\tbuildWidthSrcSetForPath(path: string, params: BuildWidthSrcSetParams) {\n\t\treturn buildWidthSrcSet(`${new URL(path, this.baseURL)}`, params);\n\t}\n\n\t/**\n\t * Builds an `<img>` `srcset` attribute value for a given set of pixel\n\t * densities for the client's base URL. It can also optinally apply Imgix URL\n\t * API parameters to the URLs.\n\t *\n\t * The `dpr` URL parameter will be applied for each `srcset` entry. If a `dpr`\n\t * parameter is provided to the `params` parameter, it will be ignored.\n\t *\n\t * @example\n\t *\n\t * ```ts\n\t * const client = new Client({ baseURL: \"https://example.imgix.net\" });\n\t * const srcset = client.buildPixelDensitySrcSetForPath(\"/image.png\", {\n\t * \tpixelDensities: [1, 2, 3],\n\t * });\n\t * // => https://example.imgix.net/image.png?dpr=1 1x,\n\t * //    https://example.imgix.net/image.png?dpr=2 2x,\n\t * //    https://example.imgix.net/image.png?dpr=3 3x\n\t * ```\n\t *\n\t * @example\n\t *\n\t * ```ts\n\t * const client = new Client({ baseURL: \"https://example.imgix.net\" });\n\t * const srcset = client.buildPixelDensitySrcSetForPath(\"/image.png\", {\n\t * \tpixelDensities: [1, 2, 3],\n\t * \tsat: -100,\n\t * });\n\t * // => https://example.imgix.net/image.png?dpr=1&sat=-100 1x,\n\t * //    https://example.imgix.net/image.png?dpr=2&sat=-100 2x,\n\t * //    https://example.imgix.net/image.png?dpr=3&sat=-100 3x\n\t * ```\n\t *\n\t * @param path - Path to the image relative to the client's base URL.\n\t * @param params - An object of Imgix URL API parameters. The `pixelDensities`\n\t *   parameter defines the resulting `srcset` widths.\n\t *\n\t * @returns A `srcset` attribute value for `url` with the given Imgix URL API\n\t *   parameters applied.\n\t */\n\tbuildPixelDensitySrcSetForPath(\n\t\tpath: string,\n\t\tparams: BuildPixelDensitySrcSetParams,\n\t) {\n\t\treturn buildPixelDensitySrcSet(`${new URL(path, this.baseURL)}`, params);\n\t}\n}\n"],"names":[],"mappings":";;;;;;MAyBa,OAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUlB,YAAY,SAAsB;AATlC;AAUC,SAAK,UAAU,QAAQ;AAAA,EACxB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA8BA,gBAAgB,MAAc,SAAyB,IAAE;AACjD,WAAA,SAAS,GAAG,IAAI,IAAI,MAAM,KAAK,OAAO,CAAC,IAAI,MAAM;AAAA,EACzD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA6CA,wBAAwB,MAAc,QAA8B;AAC5D,WAAA,iBAAiB,GAAG,IAAI,IAAI,MAAM,KAAK,OAAO,CAAC,IAAI,MAAM;AAAA,EACjE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA0CA,+BACC,MACA,QAAqC;AAE9B,WAAA,wBAAwB,GAAG,IAAI,IAAI,MAAM,KAAK,OAAO,CAAC,IAAI,MAAM;AAAA,EACxE;AACA;"}

package/dist/buildPixelDensitySrcSet.cjs

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const buildURL = require("./buildURL.cjs");
+const buildPixelDensitySrcSet = (url, { pixelDensities, ...params }) => {
+  return pixelDensities.map((dpr) => {
+    return `${buildURL.buildURL(url, { ...params, dpr })} ${dpr}x`;
+  }).join(", ");
+};
+exports.buildPixelDensitySrcSet = buildPixelDensitySrcSet;
+//# sourceMappingURL=buildPixelDensitySrcSet.cjs.map

package/dist/buildPixelDensitySrcSet.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildPixelDensitySrcSet.cjs","sources":["../../src/buildPixelDensitySrcSet.ts"],"sourcesContent":["import type { ImgixURLParams } from \"./types.generated\";\nimport { buildURL } from \"./buildURL\";\n\n/**\n * Parameters for `buildPixelDensitySrcSet`.\n */\nexport type BuildPixelDensitySrcSetParams = Omit<ImgixURLParams, \"dpr\"> & {\n\t/**\n\t * The pixel densities to include in the resulting `srcset` value.\n\t *\n\t * @example\n\t *\n\t * ```ts\n\t * [1, 2, 3];\n\t * ```\n\t */\n\tpixelDensities: number[];\n};\n\n/**\n * Builds an `<img>` `srcset` attribute value for a given set of pixel\n * densities. It can also optinally apply Imgix URL API parameters to the URLs.\n *\n * The `dpr` URL parameter will be applied for each `srcset` entry. If a `dpr`\n * parameter is provided to the `params` parameter, it will be ignored.\n *\n * @example\n *\n * ```ts\n * const srcset = buildPixelDensitySrcSet(\n * \t\"https://example.imgix.net/image.png\",\n * \t{ pixelDensities: [1, 2, 3] },\n * );\n * // => https://example.imgix.net/image.png?dpr=1 1x,\n * //    https://example.imgix.net/image.png?dpr=2 2x,\n * //    https://example.imgix.net/image.png?dpr=3 3x\n * ```\n *\n * @example\n *\n * ```ts\n * const srcset = buildPixelDensitySrcSet(\n * \t\"https://example.imgix.net/image.png\",\n * \t{\n * \t\tpixelDensities: [1, 2, 3],\n * \t\tsat: -100,\n * \t},\n * );\n * // => https://example.imgix.net/image.png?dpr=1&sat=-100 1x,\n * //    https://example.imgix.net/image.png?dpr=2&sat=-100 2x,\n * //    https://example.imgix.net/image.png?dpr=3&sat=-100 3x\n * ```\n *\n * @param url - Full absolute URL to the Imgix image.\n * @param params - An object of Imgix URL API parameters. The `pixelDensities`\n *   parameter defines the resulting `srcset` widths.\n *\n * @returns A `srcset` attribute value for `url` with the given Imgix URL API\n *   parameters applied.\n */\nexport const buildPixelDensitySrcSet = (\n\turl: string,\n\t{ pixelDensities, ...params }: BuildPixelDensitySrcSetParams,\n): string => {\n\treturn pixelDensities\n\t\t.map((dpr) => {\n\t\t\treturn `${buildURL(url, { ...params, dpr })} ${dpr}x`;\n\t\t})\n\t\t.join(\", \");\n};\n"],"names":["buildURL"],"mappings":";;;AA4DO,MAAM,0BAA0B,CACtC,KACA,EAAE,gBAAgB,GAAG,aACV;AACJ,SAAA,eACL,IAAI,CAAC,QAAO;AACL,WAAA,GAAGA,SAAAA,SAAS,KAAK,EAAE,GAAG,QAAQ,IAAK,CAAA,CAAC,IAAI,GAAG;AAAA,EAAA,CAClD,EACA,KAAK,IAAI;AACZ;;"}

package/dist/buildPixelDensitySrcSet.d.ts

@@ -0,0 +1,58 @@
+import type { ImgixURLParams } from "./types.generated";
+/**
+ * Parameters for `buildPixelDensitySrcSet`.
+ */
+export type BuildPixelDensitySrcSetParams = Omit<ImgixURLParams, "dpr"> & {
+    /**
+     * The pixel densities to include in the resulting `srcset` value.
+     *
+     * @example
+     *
+     * ```ts
+     * [1, 2, 3];
+     * ```
+     */
+    pixelDensities: number[];
+};
+/**
+ * Builds an `<img>` `srcset` attribute value for a given set of pixel
+ * densities. It can also optinally apply Imgix URL API parameters to the URLs.
+ *
+ * The `dpr` URL parameter will be applied for each `srcset` entry. If a `dpr`
+ * parameter is provided to the `params` parameter, it will be ignored.
+ *
+ * @example
+ *
+ * ```ts
+ * const srcset = buildPixelDensitySrcSet(
+ * 	"https://example.imgix.net/image.png",
+ * 	{ pixelDensities: [1, 2, 3] },
+ * );
+ * // => https://example.imgix.net/image.png?dpr=1 1x,
+ * //    https://example.imgix.net/image.png?dpr=2 2x,
+ * //    https://example.imgix.net/image.png?dpr=3 3x
+ * ```
+ *
+ * @example
+ *
+ * ```ts
+ * const srcset = buildPixelDensitySrcSet(
+ * 	"https://example.imgix.net/image.png",
+ * 	{
+ * 		pixelDensities: [1, 2, 3],
+ * 		sat: -100,
+ * 	},
+ * );
+ * // => https://example.imgix.net/image.png?dpr=1&sat=-100 1x,
+ * //    https://example.imgix.net/image.png?dpr=2&sat=-100 2x,
+ * //    https://example.imgix.net/image.png?dpr=3&sat=-100 3x
+ * ```
+ *
+ * @param url - Full absolute URL to the Imgix image.
+ * @param params - An object of Imgix URL API parameters. The `pixelDensities`
+ *   parameter defines the resulting `srcset` widths.
+ *
+ * @returns A `srcset` attribute value for `url` with the given Imgix URL API
+ *   parameters applied.
+ */
+export declare const buildPixelDensitySrcSet: (url: string, { pixelDensities, ...params }: BuildPixelDensitySrcSetParams) => string;

package/dist/buildPixelDensitySrcSet.js

@@ -0,0 +1,10 @@
+import { buildURL } from "./buildURL.js";
+const buildPixelDensitySrcSet = (url, { pixelDensities, ...params }) => {
+  return pixelDensities.map((dpr) => {
+    return `${buildURL(url, { ...params, dpr })} ${dpr}x`;
+  }).join(", ");
+};
+export {
+  buildPixelDensitySrcSet
+};
+//# sourceMappingURL=buildPixelDensitySrcSet.js.map

package/dist/buildPixelDensitySrcSet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildPixelDensitySrcSet.js","sources":["../../src/buildPixelDensitySrcSet.ts"],"sourcesContent":["import type { ImgixURLParams } from \"./types.generated\";\nimport { buildURL } from \"./buildURL\";\n\n/**\n * Parameters for `buildPixelDensitySrcSet`.\n */\nexport type BuildPixelDensitySrcSetParams = Omit<ImgixURLParams, \"dpr\"> & {\n\t/**\n\t * The pixel densities to include in the resulting `srcset` value.\n\t *\n\t * @example\n\t *\n\t * ```ts\n\t * [1, 2, 3];\n\t * ```\n\t */\n\tpixelDensities: number[];\n};\n\n/**\n * Builds an `<img>` `srcset` attribute value for a given set of pixel\n * densities. It can also optinally apply Imgix URL API parameters to the URLs.\n *\n * The `dpr` URL parameter will be applied for each `srcset` entry. If a `dpr`\n * parameter is provided to the `params` parameter, it will be ignored.\n *\n * @example\n *\n * ```ts\n * const srcset = buildPixelDensitySrcSet(\n * \t\"https://example.imgix.net/image.png\",\n * \t{ pixelDensities: [1, 2, 3] },\n * );\n * // => https://example.imgix.net/image.png?dpr=1 1x,\n * //    https://example.imgix.net/image.png?dpr=2 2x,\n * //    https://example.imgix.net/image.png?dpr=3 3x\n * ```\n *\n * @example\n *\n * ```ts\n * const srcset = buildPixelDensitySrcSet(\n * \t\"https://example.imgix.net/image.png\",\n * \t{\n * \t\tpixelDensities: [1, 2, 3],\n * \t\tsat: -100,\n * \t},\n * );\n * // => https://example.imgix.net/image.png?dpr=1&sat=-100 1x,\n * //    https://example.imgix.net/image.png?dpr=2&sat=-100 2x,\n * //    https://example.imgix.net/image.png?dpr=3&sat=-100 3x\n * ```\n *\n * @param url - Full absolute URL to the Imgix image.\n * @param params - An object of Imgix URL API parameters. The `pixelDensities`\n *   parameter defines the resulting `srcset` widths.\n *\n * @returns A `srcset` attribute value for `url` with the given Imgix URL API\n *   parameters applied.\n */\nexport const buildPixelDensitySrcSet = (\n\turl: string,\n\t{ pixelDensities, ...params }: BuildPixelDensitySrcSetParams,\n): string => {\n\treturn pixelDensities\n\t\t.map((dpr) => {\n\t\t\treturn `${buildURL(url, { ...params, dpr })} ${dpr}x`;\n\t\t})\n\t\t.join(\", \");\n};\n"],"names":[],"mappings":";AA4DO,MAAM,0BAA0B,CACtC,KACA,EAAE,gBAAgB,GAAG,aACV;AACJ,SAAA,eACL,IAAI,CAAC,QAAO;AACL,WAAA,GAAG,SAAS,KAAK,EAAE,GAAG,QAAQ,IAAK,CAAA,CAAC,IAAI,GAAG;AAAA,EAAA,CAClD,EACA,KAAK,IAAI;AACZ;"}

package/dist/buildURL.cjs

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const camelCaseToParamCase = (input) => {
+  return input.replace(/[A-Z]/g, (match) => {
+    return `-${match.toLowerCase()}`;
+  });
+};
+const buildURL = (url, params) => {
+  const instance = new URL(url);
+  for (const camelCasedParamKey in params) {
+    const paramKey = camelCaseToParamCase(camelCasedParamKey);
+    const paramValue = params[camelCasedParamKey];
+    if (paramValue === void 0) {
+      instance.searchParams.delete(paramKey);
+    } else if (Array.isArray(paramValue)) {
+      instance.searchParams.set(paramKey, paramValue.join(","));
+    } else {
+      instance.searchParams.set(paramKey, `${paramValue}`);
+    }
+  }
+  const s = instance.searchParams.get("s");
+  if (s) {
+    instance.searchParams.delete("s");
+    instance.searchParams.append("s", s);
+  }
+  return instance.toString();
+};
+exports.buildURL = buildURL;
+//# sourceMappingURL=buildURL.cjs.map

package/dist/buildURL.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildURL.cjs","sources":["../../src/buildURL.ts"],"sourcesContent":["import type { ImgixURLParams } from \"./types.generated\";\n\n/**\n * Converts a camel case string to a param case string.\n *\n * @example\n *\n * ```ts\n * camelCaseToParamCase(\"fooBar\");\n * // => 'foo-bar'\n * ```\n *\n * @param input - Camel case string to convert.\n *\n * @returns Param case version of `input`.\n */\nconst camelCaseToParamCase = (input: string): string => {\n\treturn input.replace(/[A-Z]/g, (match) => {\n\t\treturn `-${match.toLowerCase()}`;\n\t});\n};\n\n/**\n * Builds a URL to an Imgix image with Imgix URL API parameters.\n *\n * The given URL must be a full absolute URL containing the protocol and domain.\n *\n * URL parameters already applied to the image will be retained. To remove\n * existing parameters, set the parameter to `undefined` in the `params`\n * argument.\n *\n * @example\n *\n * ```ts\n * const url = buildURL(\"https://example.imgix.net/image.png\", {\n * \twidth: 400,\n * });\n * // => https://example.imgix.net/image.png?width=400\n * ```\n *\n * @example\n *\n * ```ts\n * const url = buildURL(\"https://example.imgix.net/image.png?width=400\", {\n * \theight: 300,\n * });\n * // => https://example.imgix.net/image.png?width=400&height=300\n * ```\n *\n * @param url - Full absolute URL to the Imgix image.\n * @param params - An object of Imgix URL API parameters.\n *\n * @returns `url` with the given Imgix URL API parameters applied.\n *\n * @see Imgix URL API reference: https://docs.imgix.com/apis/rendering\n */\nexport const buildURL = (url: string, params: ImgixURLParams): string => {\n\tconst instance = new URL(url);\n\n\tfor (const camelCasedParamKey in params) {\n\t\tconst paramKey = camelCaseToParamCase(camelCasedParamKey);\n\t\tconst paramValue = params[camelCasedParamKey as keyof typeof params];\n\n\t\tif (paramValue === undefined) {\n\t\t\tinstance.searchParams.delete(paramKey);\n\t\t} else if (Array.isArray(paramValue)) {\n\t\t\tinstance.searchParams.set(paramKey, paramValue.join(\",\"));\n\t\t} else {\n\t\t\tinstance.searchParams.set(paramKey, `${paramValue}`);\n\t\t}\n\t}\n\n\t// Ensure the `s` parameter is the last parameter, if it exists.\n\t// @see https://github.com/imgix/imgix-blueprint#securing-urls\n\tconst s = instance.searchParams.get(\"s\");\n\tif (s) {\n\t\tinstance.searchParams.delete(\"s\");\n\t\tinstance.searchParams.append(\"s\", s);\n\t}\n\n\treturn instance.toString();\n};\n"],"names":[],"mappings":";;AAgBA,MAAM,uBAAuB,CAAC,UAAyB;AACtD,SAAO,MAAM,QAAQ,UAAU,CAAC,UAAS;AACjC,WAAA,IAAI,MAAM,YAAA,CAAa;AAAA,EAAA,CAC9B;AACF;AAoCa,MAAA,WAAW,CAAC,KAAa,WAAkC;AACjE,QAAA,WAAW,IAAI,IAAI,GAAG;AAE5B,aAAW,sBAAsB,QAAQ;AAClC,UAAA,WAAW,qBAAqB,kBAAkB;AAClD,UAAA,aAAa,OAAO,kBAAyC;AAEnE,QAAI,eAAe,QAAW;AACpB,eAAA,aAAa,OAAO,QAAQ;AAAA,IAC3B,WAAA,MAAM,QAAQ,UAAU,GAAG;AACrC,eAAS,aAAa,IAAI,UAAU,WAAW,KAAK,GAAG,CAAC;AAAA,IAAA,OAClD;AACN,eAAS,aAAa,IAAI,UAAU,GAAG,UAAU,EAAE;AAAA,IACpD;AAAA,EACD;AAIA,QAAM,IAAI,SAAS,aAAa,IAAI,GAAG;AACvC,MAAI,GAAG;AACG,aAAA,aAAa,OAAO,GAAG;AACvB,aAAA,aAAa,OAAO,KAAK,CAAC;AAAA,EACpC;AAEA,SAAO,SAAS;AACjB;;"}

package/dist/buildURL.d.ts

@@ -0,0 +1,36 @@
+import type { ImgixURLParams } from "./types.generated";
+/**
+ * Builds a URL to an Imgix image with Imgix URL API parameters.
+ *
+ * The given URL must be a full absolute URL containing the protocol and domain.
+ *
+ * URL parameters already applied to the image will be retained. To remove
+ * existing parameters, set the parameter to `undefined` in the `params`
+ * argument.
+ *
+ * @example
+ *
+ * ```ts
+ * const url = buildURL("https://example.imgix.net/image.png", {
+ * 	width: 400,
+ * });
+ * // => https://example.imgix.net/image.png?width=400
+ * ```
+ *
+ * @example
+ *
+ * ```ts
+ * const url = buildURL("https://example.imgix.net/image.png?width=400", {
+ * 	height: 300,
+ * });
+ * // => https://example.imgix.net/image.png?width=400&height=300
+ * ```
+ *
+ * @param url - Full absolute URL to the Imgix image.
+ * @param params - An object of Imgix URL API parameters.
+ *
+ * @returns `url` with the given Imgix URL API parameters applied.
+ *
+ * @see Imgix URL API reference: https://docs.imgix.com/apis/rendering
+ */
+export declare const buildURL: (url: string, params: ImgixURLParams) => string;

package/dist/buildURL.js

@@ -0,0 +1,29 @@
+const camelCaseToParamCase = (input) => {
+  return input.replace(/[A-Z]/g, (match) => {
+    return `-${match.toLowerCase()}`;
+  });
+};
+const buildURL = (url, params) => {
+  const instance = new URL(url);
+  for (const camelCasedParamKey in params) {
+    const paramKey = camelCaseToParamCase(camelCasedParamKey);
+    const paramValue = params[camelCasedParamKey];
+    if (paramValue === void 0) {
+      instance.searchParams.delete(paramKey);
+    } else if (Array.isArray(paramValue)) {
+      instance.searchParams.set(paramKey, paramValue.join(","));
+    } else {
+      instance.searchParams.set(paramKey, `${paramValue}`);
+    }
+  }
+  const s = instance.searchParams.get("s");
+  if (s) {
+    instance.searchParams.delete("s");
+    instance.searchParams.append("s", s);
+  }
+  return instance.toString();
+};
+export {
+  buildURL
+};
+//# sourceMappingURL=buildURL.js.map

package/dist/buildURL.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildURL.js","sources":["../../src/buildURL.ts"],"sourcesContent":["import type { ImgixURLParams } from \"./types.generated\";\n\n/**\n * Converts a camel case string to a param case string.\n *\n * @example\n *\n * ```ts\n * camelCaseToParamCase(\"fooBar\");\n * // => 'foo-bar'\n * ```\n *\n * @param input - Camel case string to convert.\n *\n * @returns Param case version of `input`.\n */\nconst camelCaseToParamCase = (input: string): string => {\n\treturn input.replace(/[A-Z]/g, (match) => {\n\t\treturn `-${match.toLowerCase()}`;\n\t});\n};\n\n/**\n * Builds a URL to an Imgix image with Imgix URL API parameters.\n *\n * The given URL must be a full absolute URL containing the protocol and domain.\n *\n * URL parameters already applied to the image will be retained. To remove\n * existing parameters, set the parameter to `undefined` in the `params`\n * argument.\n *\n * @example\n *\n * ```ts\n * const url = buildURL(\"https://example.imgix.net/image.png\", {\n * \twidth: 400,\n * });\n * // => https://example.imgix.net/image.png?width=400\n * ```\n *\n * @example\n *\n * ```ts\n * const url = buildURL(\"https://example.imgix.net/image.png?width=400\", {\n * \theight: 300,\n * });\n * // => https://example.imgix.net/image.png?width=400&height=300\n * ```\n *\n * @param url - Full absolute URL to the Imgix image.\n * @param params - An object of Imgix URL API parameters.\n *\n * @returns `url` with the given Imgix URL API parameters applied.\n *\n * @see Imgix URL API reference: https://docs.imgix.com/apis/rendering\n */\nexport const buildURL = (url: string, params: ImgixURLParams): string => {\n\tconst instance = new URL(url);\n\n\tfor (const camelCasedParamKey in params) {\n\t\tconst paramKey = camelCaseToParamCase(camelCasedParamKey);\n\t\tconst paramValue = params[camelCasedParamKey as keyof typeof params];\n\n\t\tif (paramValue === undefined) {\n\t\t\tinstance.searchParams.delete(paramKey);\n\t\t} else if (Array.isArray(paramValue)) {\n\t\t\tinstance.searchParams.set(paramKey, paramValue.join(\",\"));\n\t\t} else {\n\t\t\tinstance.searchParams.set(paramKey, `${paramValue}`);\n\t\t}\n\t}\n\n\t// Ensure the `s` parameter is the last parameter, if it exists.\n\t// @see https://github.com/imgix/imgix-blueprint#securing-urls\n\tconst s = instance.searchParams.get(\"s\");\n\tif (s) {\n\t\tinstance.searchParams.delete(\"s\");\n\t\tinstance.searchParams.append(\"s\", s);\n\t}\n\n\treturn instance.toString();\n};\n"],"names":[],"mappings":"AAgBA,MAAM,uBAAuB,CAAC,UAAyB;AACtD,SAAO,MAAM,QAAQ,UAAU,CAAC,UAAS;AACjC,WAAA,IAAI,MAAM,YAAA,CAAa;AAAA,EAAA,CAC9B;AACF;AAoCa,MAAA,WAAW,CAAC,KAAa,WAAkC;AACjE,QAAA,WAAW,IAAI,IAAI,GAAG;AAE5B,aAAW,sBAAsB,QAAQ;AAClC,UAAA,WAAW,qBAAqB,kBAAkB;AAClD,UAAA,aAAa,OAAO,kBAAyC;AAEnE,QAAI,eAAe,QAAW;AACpB,eAAA,aAAa,OAAO,QAAQ;AAAA,IAC3B,WAAA,MAAM,QAAQ,UAAU,GAAG;AACrC,eAAS,aAAa,IAAI,UAAU,WAAW,KAAK,GAAG,CAAC;AAAA,IAAA,OAClD;AACN,eAAS,aAAa,IAAI,UAAU,GAAG,UAAU,EAAE;AAAA,IACpD;AAAA,EACD;AAIA,QAAM,IAAI,SAAS,aAAa,IAAI,GAAG;AACvC,MAAI,GAAG;AACG,aAAA,aAAa,OAAO,GAAG;AACvB,aAAA,aAAa,OAAO,KAAK,CAAC;AAAA,EACpC;AAEA,SAAO,SAAS;AACjB;"}

package/dist/buildWidthSrcSet.cjs

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const buildURL = require("./buildURL.cjs");
+const buildWidthSrcSet = (url, { widths, ...params }) => {
+  return widths.map((width) => {
+    return `${buildURL.buildURL(url, { ...params, w: void 0, width })} ${width}w`;
+  }).join(", ");
+};
+exports.buildWidthSrcSet = buildWidthSrcSet;
+//# sourceMappingURL=buildWidthSrcSet.cjs.map

package/dist/buildWidthSrcSet.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildWidthSrcSet.cjs","sources":["../../src/buildWidthSrcSet.ts"],"sourcesContent":["import type { ImgixURLParams } from \"./types.generated\";\nimport { buildURL } from \"./buildURL\";\n\n/**\n * Parameters for `buildWidthSrcSet`.\n */\nexport type BuildWidthSrcSetParams = Omit<ImgixURLParams, \"width\" | \"w\"> & {\n\t/**\n\t * The pixel widths to include in the resulting `srcset` value.\n\t *\n\t * @example\n\t *\n\t * ```ts\n\t * [400, 800, 1600];\n\t * ```\n\t */\n\twidths: number[];\n};\n\n/**\n * Builds an `<img>` `srcset` attribute value for a given set of widths. It can\n * also optinally apply Imgix URL API parameters to the URLs.\n *\n * The `width` URL parameter will be applied for each `srcset` entry. If a\n * `width` or `w` parameter is provided to the `params` parameter, it will be\n * ignored.\n *\n * @example\n *\n * ```ts\n * const srcset = buildWidthSrcSet(\"https://example.imgix.net/image.png\", {\n * \twidths: [400, 800, 1600],\n * });\n * // => https://example.imgix.net/image.png?width=400 400w,\n * //    https://example.imgix.net/image.png?width=800 800w,\n * //    https://example.imgix.net/image.png?width=1600 1600w\n * ```\n *\n * @example\n *\n * ```ts\n * const srcset = buildWidthSrcSet(\"https://example.imgix.net/image.png\", {\n * \twidths: [400, 800, 1600],\n * \tsat: -100,\n * });\n * // => https://example.imgix.net/image.png?width=400&sat=-100 400w,\n * //    https://example.imgix.net/image.png?width=800&sat=-100 800w,\n * //    https://example.imgix.net/image.png?width=1600&sat=-100 1600w\n * ```\n *\n * @param url - Full absolute URL to the Imgix image.\n * @param params - An object of Imgix URL API parameters. The `widths` parameter\n *   defines the resulting `srcset` widths.\n *\n * @returns A `srcset` attribute value for `url` with the given Imgix URL API\n *   parameters applied.\n */\nexport const buildWidthSrcSet = (\n\turl: string,\n\t{ widths, ...params }: BuildWidthSrcSetParams,\n): string => {\n\treturn widths\n\t\t.map((width) => {\n\t\t\treturn `${buildURL(url, { ...params, w: undefined, width })} ${width}w`;\n\t\t})\n\t\t.join(\", \");\n};\n"],"names":["buildURL"],"mappings":";;;AAyDO,MAAM,mBAAmB,CAC/B,KACA,EAAE,QAAQ,GAAG,aACF;AACJ,SAAA,OACL,IAAI,CAAC,UAAS;AACd,WAAO,GAAGA,SAAA,SAAS,KAAK,EAAE,GAAG,QAAQ,GAAG,QAAW,MAAK,CAAE,CAAC,IAAI,KAAK;AAAA,EAAA,CACpE,EACA,KAAK,IAAI;AACZ;;"}