@design-edito/tools 0.1.64 → 0.1.65

package/chunks/chunk-LOY7C5BP.js

@@ -0,0 +1,151 @@
+import {
+  formatImage
+} from "./chunk-SJFY537W.js";
+import {
+  transform
+} from "./chunk-YRQ7LODK.js";
+import {
+  __export
+} from "./chunk-NZLE2WMY.js";
+
+// src/node/images/prepare/index.ts
+var prepare_exports = {};
+__export(prepare_exports, {
+  MAX_NB_OUTPUTS: () => MAX_NB_OUTPUTS,
+  OUTPUT_ZIP_FOLDER: () => OUTPUT_ZIP_FOLDER,
+  exportZipBuffer: () => exportZipBuffer,
+  prepareImage: () => prepareImage
+});
+import sharp from "sharp";
+import { Writable } from "node:stream";
+import archiver from "archiver";
+var MAX_NB_OUTPUTS = 50;
+var OUTPUT_ZIP_FOLDER = "./output-zips";
+async function prepareImage(imageBuffer, customOptions) {
+  const sharpImage = sharp(imageBuffer);
+  const sharpImageMetadata = await sharpImage.metadata();
+  const imageBufferMetadata = {
+    width: sharpImageMetadata.width ?? 0,
+    height: sharpImageMetadata.height ?? 0,
+    format: sharpImageMetadata.format || "png"
+  };
+  const options = getOptions(imageBufferMetadata, customOptions);
+  const nbOutputs = options.qualities.length * (options.ratios.length + 1) * (options.widths.length + 1) * (options.heights.length + 1);
+  if (nbOutputs > MAX_NB_OUTPUTS) throw Error("Nb output exceeds supported max nb output");
+  let transformedBuffer = imageBuffer;
+  try {
+    transformedBuffer = await transform(imageBuffer, options.inputOperations, options.checkValidOperations);
+  } catch (e) {
+    console.log("Images:Prepare:Transform:Buffer:Error", { e });
+  }
+  const transformedBufferMetadata = await sharp(transformedBuffer).metadata();
+  const exportsBuffers = [
+    {
+      buffer: imageBuffer,
+      name: generateFileName({
+        ...imageBufferMetadata,
+        quality: 100,
+        suffix: "original",
+        prefix: options.name
+      })
+    },
+    {
+      buffer: transformedBuffer,
+      name: generateFileName({
+        width: transformedBufferMetadata.width || 0,
+        height: transformedBufferMetadata.height || 0,
+        format: transformedBufferMetadata.format || "png",
+        quality: 100,
+        suffix: "transformed-unresized",
+        prefix: options.name
+      })
+    }
+  ];
+  for (const width of options.widths) {
+    for (const height of options.heights) {
+      for (const quality of options.qualities) {
+        for (const format of options.formats) {
+          const exportBuffer = await formatImage(transformedBuffer, {
+            format,
+            quality,
+            width,
+            height
+          });
+          exportsBuffers.push({
+            buffer: exportBuffer,
+            name: generateFileName({
+              width,
+              height,
+              quality,
+              format,
+              prefix: options.name
+            })
+          });
+        }
+      }
+    }
+  }
+  console.log("Images:Transform:Export:ZIP", generateZipName(options.name));
+  const zipBuffer = exportZipBuffer(exportsBuffers, generateZipName(options.name));
+  return zipBuffer;
+}
+function exportZipBuffer(zipSources, zipDirectoryName) {
+  return new Promise(async (resolve) => {
+    const archive = archiver("zip", { zlib: { level: 9 } });
+    if (zipDirectoryName) {
+      archive.directory(zipDirectoryName + "/", false);
+    }
+    zipSources.forEach((zipSource) => {
+      const fileName = zipDirectoryName ? `${zipDirectoryName}/${zipSource.name}` : zipSource.name;
+      archive.append(zipSource.buffer, { name: fileName });
+    });
+    const chunks = [];
+    const writable = new Writable();
+    writable._write = (chunk, _enc, callback) => {
+      chunks.push(chunk);
+      callback();
+    };
+    archive.pipe(writable);
+    await archive.finalize();
+    const bufferZip = Buffer.concat(chunks);
+    resolve(bufferZip);
+  });
+}
+function getOptions(imageBufferMetadata, options) {
+  return {
+    center: [0.5, 0.5],
+    qualities: [100],
+    inputOperations: [],
+    ...options,
+    checkValidOperations: options?.checkValidOperations ?? false,
+    name: options?.name ?? "",
+    formats: [imageBufferMetadata.format, ...options?.formats ? options.formats : []],
+    ratios: [...options?.ratios ? options.ratios : []],
+    widths: [imageBufferMetadata.width, ...options?.widths ? options.widths : []],
+    heights: [imageBufferMetadata.height, ...options?.heights ? options.heights : []]
+  };
+}
+function generateZipName(name = "") {
+  const date = /* @__PURE__ */ new Date();
+  return `${name}_image-exports_${date.toLocaleDateString()}_${date.toLocaleTimeString()}_${date.getTime()}`.replace(/\/|:/g, "-").replace(/ /g, "").trim();
+}
+function generateFileName({
+  width,
+  height,
+  quality,
+  format,
+  suffix,
+  prefix
+}) {
+  prefix = prefix ? `${prefix}_` : "image-formats_";
+  suffix = `${suffix ? `_${suffix}` : ""}.${format}`;
+  return `${prefix}${width}x${height}_Q${quality}${suffix}`;
+}
+
+export {
+  MAX_NB_OUTPUTS,
+  OUTPUT_ZIP_FOLDER,
+  prepareImage,
+  exportZipBuffer,
+  prepare_exports
+};

package/chunks/chunk-MAE5XZGF.js

@@ -0,0 +1,37 @@
+import {
+  Cast,
+  Tree,
+  Utils
+} from "./chunk-LOAOXFA2.js";
+import {
+  Types
+} from "./chunk-XEQ2PBT2.js";
+import {
+  SmartTags
+} from "./chunk-UT2J62LH.js";
+import {
+  Serialize
+} from "./chunk-SXRWMH3U.js";
+import {
+  Transformer
+} from "./chunk-BKO7GLC2.js";
+import {
+  Method
+} from "./chunk-RW7VAKJW.js";
+
+// src/agnostic/html/hyper-json/index.ts
+var HyperJson;
+((HyperJson2) => {
+  HyperJson2.Cast = Cast;
+  HyperJson2.Method = Method;
+  HyperJson2.Serialize = Serialize;
+  HyperJson2.SmartTags = SmartTags;
+  HyperJson2.Transformer = Transformer;
+  HyperJson2.Tree = Tree;
+  HyperJson2.Types = Types;
+  HyperJson2.Utils = Utils;
+})(HyperJson || (HyperJson = {}));
+
+export {
+  HyperJson
+};

package/chunks/chunk-MB7HWF22.js

@@ -0,0 +1,23 @@
+import {
+  HSLToRGB
+} from "./chunk-QLC3A6PC.js";
+import {
+  RGBToHSL
+} from "./chunk-YVLJKJV2.js";
+
+// src/agnostic/colors/saturate-color/index.ts
+function saturateColor(color, intensity = 20) {
+  const [h, s, l] = RGBToHSL(color);
+  const rgb = HSLToRGB([h, Math.min(100, s + intensity), l]);
+  return rgb;
+}
+function setColorSaturation(color, intensity = 20) {
+  const [h, s, l] = RGBToHSL(color);
+  const rgb = HSLToRGB([h, Math.min(100, intensity), l]);
+  return rgb;
+}
+
+export {
+  saturateColor,
+  setColorSaturation
+};

package/chunks/chunk-MFWKY3DT.js

@@ -0,0 +1,32 @@
+import {
+  Outcome
+} from "./chunk-JMU5PDBD.js";
+import {
+  unknownToString
+} from "./chunk-FENXVJYO.js";
+import {
+  __export
+} from "./chunk-NZLE2WMY.js";
+
+// src/node/ftps/file/download/index.ts
+var download_exports = {};
+__export(download_exports, {
+  download: () => download
+});
+import { PassThrough } from "node:stream";
+async function download(sourcePath, ftpClient, options) {
+  const { startAt } = options ?? {};
+  const stream = new PassThrough();
+  try {
+    await ftpClient.downloadTo(stream, sourcePath, startAt);
+    return Outcome.makeSuccess(stream);
+  } catch (err) {
+    const errStr = unknownToString(err);
+    return Outcome.makeFailure(errStr);
+  }
+}
+
+export {
+  download,
+  download_exports
+};

package/chunks/chunk-MOBGB2PH.js

@@ -0,0 +1,54 @@
+import {
+  __export
+} from "./chunk-NZLE2WMY.js";
+
+// src/node/cloud-storage/endpoint/index.ts
+var endpoint_exports = {};
+__export(endpoint_exports, {
+  Type: () => Type,
+  ftpIdentifierData: () => ftpIdentifierData,
+  gcsIdentifierData: () => gcsIdentifierData,
+  s3IdentifierData: () => s3IdentifierData
+});
+var Type = /* @__PURE__ */ ((Type2) => {
+  Type2["GCS"] = "gcs-bucket";
+  Type2["S3"] = "s3-bucket";
+  Type2["FTP"] = "ftp";
+  Type2["FTPS"] = "ftps";
+  Type2["SFTP"] = "sftp";
+  return Type2;
+})(Type || {});
+function gcsIdentifierData(identifier) {
+  identifier = identifier.trim().replace(/^\//, "");
+  const [bucketName, ...pathChunks] = identifier.split("/");
+  return {
+    bucketName: bucketName ?? null,
+    path: `/${pathChunks.join("/")}`
+  };
+}
+function s3IdentifierData(identifier) {
+  identifier = identifier.trim().replace(/^\//, "");
+  const [bucketName, ...pathChunks] = identifier.split("/");
+  return {
+    bucketName: bucketName ?? null,
+    path: `/${pathChunks.join("/")}`
+  };
+}
+function ftpIdentifierData(identifier) {
+  identifier = identifier.trim().replace(/^\//, "");
+  const [hostAndPort, ...pathChunks] = identifier.split("/");
+  const [host, port] = hostAndPort?.split(":") ?? [];
+  return {
+    host: host ?? null,
+    port: port ?? null,
+    path: `/${pathChunks.join("/")}`
+  };
+}
+
+export {
+  Type,
+  gcsIdentifierData,
+  s3IdentifierData,
+  ftpIdentifierData,
+  endpoint_exports
+};

package/chunks/chunk-MOVLLUDL.js

@@ -0,0 +1,25 @@
+// src/node/images/transform/_utils/operation-names/index.ts
+var OperationNames = {
+  Blur: "blur",
+  Brighten: "brighten",
+  Compose: "compose",
+  Extract: "extract",
+  Extend: "extend",
+  Flatten: "flatten",
+  Flip: "flip",
+  Flop: "flop",
+  Frame: "frame",
+  HueRotate: "hue-rotate",
+  Lighten: "lighten",
+  LineateLevels: "lineate-levels",
+  Modulate: "modulate",
+  Normalize: "normalize",
+  Resize: "resize",
+  Rotate: "rotate",
+  Saturate: "saturate",
+  Scale: "scale"
+};
+
+export {
+  OperationNames
+};

package/chunks/chunk-MTGZYBK2.js

@@ -0,0 +1,129 @@
+import {
+  ftpIdentifierData,
+  gcsIdentifierData
+} from "./chunk-MOBGB2PH.js";
+import {
+  Outcome
+} from "./chunk-JMU5PDBD.js";
+import {
+  unknownToString
+} from "./chunk-FENXVJYO.js";
+import {
+  __export
+} from "./chunk-NZLE2WMY.js";
+
+// src/node/cloud-storage/client/index.ts
+var client_exports = {};
+__export(client_exports, {
+  makeClient: () => makeClient,
+  makeFtpClient: () => makeFtpClient,
+  makeFtpsClient: () => makeFtpsClient,
+  makeGcsClient: () => makeGcsClient,
+  makeS3Client: () => makeS3Client,
+  makeSftpClient: () => makeSftpClient
+});
+import { Storage } from "@google-cloud/storage";
+import { S3 } from "aws-sdk";
+import { Client as FtpClient } from "basic-ftp";
+import SftpClient from "ssh2-sftp-client";
+async function makeClient(endpointType, endpointIdentifier, credentials) {
+  if (endpointType === "gcs-bucket" /* GCS */) {
+    return makeGcsClient({ type: endpointType, identifier: endpointIdentifier }, credentials);
+  } else if (endpointType === "s3-bucket" /* S3 */) {
+    return makeS3Client(credentials);
+  } else if (endpointType === "ftp" /* FTP */) {
+    return await makeFtpClient({ type: endpointType, identifier: endpointIdentifier }, credentials);
+  } else if (endpointType === "ftps" /* FTPS */) {
+    return await makeFtpsClient({ type: endpointType, identifier: endpointIdentifier }, credentials);
+  } else if (endpointType === "sftp" /* SFTP */) {
+    return await makeSftpClient({ type: endpointType, identifier: endpointIdentifier }, credentials);
+  } else {
+    return Outcome.makeFailure(`Invalid endpoint type: ${endpointType}`);
+  }
+}
+function makeGcsClient(endpoint, credentials) {
+  const storage = new Storage({ credentials });
+  const { bucketName } = gcsIdentifierData(endpoint.identifier);
+  if (bucketName === null) return Outcome.makeFailure("Invalid GCS bucket name");
+  const bucket = storage.bucket(bucketName);
+  return Outcome.makeSuccess(bucket);
+}
+function makeS3Client(credentials) {
+  const s3 = new S3({ credentials });
+  return Outcome.makeSuccess(s3);
+}
+async function makeFtpClient(endpoint, credentials) {
+  const { host, port, path } = ftpIdentifierData(endpoint.identifier);
+  if (host === null) return Outcome.makeFailure("Invalid host information");
+  if (port === null) return Outcome.makeFailure("Invalid port information");
+  const client = new FtpClient();
+  try {
+    await client.access({
+      host,
+      port: parseInt(port),
+      user: credentials.username,
+      password: credentials.password
+    });
+    await client.cd(path);
+    return Outcome.makeSuccess(client);
+  } catch (err) {
+    unknownToString(err);
+    return Outcome.makeFailure(unknownToString(err));
+  }
+}
+async function makeFtpsClient(endpoint, credentials) {
+  const { host, port, path } = ftpIdentifierData(endpoint.identifier);
+  if (host === null) return Outcome.makeFailure("Invalid host information");
+  if (port === null) return Outcome.makeFailure("Invalid port information");
+  const client = new FtpClient();
+  try {
+    await client.access({
+      host,
+      port: parseInt(port),
+      user: credentials.username,
+      password: credentials.password,
+      secure: true,
+      secureOptions: credentials.implicit ? { rejectUnauthorized: false } : void 0
+      // Explicit mode uses STARTTLS
+    });
+    await client.cd(path);
+    return Outcome.makeSuccess(client);
+  } catch (err) {
+    return Outcome.makeFailure(unknownToString(err));
+  }
+}
+async function makeSftpClient(endpoint, credentials) {
+  const { host, port, path } = ftpIdentifierData(endpoint.identifier);
+  if (host === null) return Outcome.makeFailure("Invalid host information");
+  if (port === null) return Outcome.makeFailure("Invalid port information");
+  const sftp = new SftpClient();
+  try {
+    await sftp.connect({
+      host,
+      port: parseInt(port),
+      username: credentials.username,
+      password: credentials.password,
+      privateKey: credentials.privateKey,
+      passphrase: credentials.passphrase
+    });
+    try {
+      const stats = await sftp.stat(path);
+      if (!stats.isDirectory) return Outcome.makeFailure(`Target path exists but is not a directory: ${path}`);
+    } catch (err) {
+      return Outcome.makeFailure(`Target directory does not exist: ${path}`);
+    }
+    return Outcome.makeSuccess(sftp);
+  } catch (err) {
+    return Outcome.makeFailure(unknownToString(err));
+  }
+}
+
+export {
+  makeClient,
+  makeGcsClient,
+  makeS3Client,
+  makeFtpClient,
+  makeFtpsClient,
+  makeSftpClient,
+  client_exports
+};

package/chunks/chunk-MV2LDBDF.js

@@ -0,0 +1,164 @@
+import {
+  createColorPalette
+} from "./chunk-5SWBMXLR.js";
+import {
+  createLineBackground
+} from "./chunk-WMSE5GRO.js";
+import {
+  createTileBackground
+} from "./chunk-CP454IJD.js";
+import {
+  getRelativePxPositionsInWrapperFor
+} from "./chunk-OCM3RLO6.js";
+import {
+  clamp
+} from "./chunk-OSAXBA7G.js";
+
+// src/node/images/transform/operations/_utils/frame/index.ts
+import sharp from "sharp";
+async function frame(imageSharp, params) {
+  const imageMetadata = await imageSharp.metadata();
+  const imageDimensions = {
+    widthPx: imageMetadata.width ?? 0,
+    heightPx: imageMetadata.height ?? 0
+  };
+  const scaledImage = scaleImageToFrame(
+    imageSharp,
+    imageDimensions,
+    params.dimensions,
+    params.imageScale
+  );
+  imageSharp = scaledImage.sharpInstance;
+  imageDimensions.widthPx = scaledImage.widthPx;
+  imageDimensions.heightPx = scaledImage.heightPx;
+  const defaultBackgroundColorCreate = getDefaultBackgroundColor(params.background);
+  const imagePositions = getRelativePxPositionsInWrapperFor(imageDimensions, params.dimensions, params.positions);
+  const backgroundOverlays = await getBackgroundOverlays(
+    {
+      sharp: imageSharp,
+      dimensions: imageDimensions
+    },
+    params.background,
+    params.dimensions,
+    {
+      x: imagePositions.x,
+      y: imagePositions.y,
+      w: imageDimensions.widthPx,
+      h: imageDimensions.heightPx
+    }
+  );
+  const composition = [
+    ...backgroundOverlays,
+    {
+      input: await imageSharp.toFormat("png").png({ quality: 100 }).toBuffer(),
+      /* Make sure we work with the best quality of our file */
+      left: imagePositions.x,
+      top: imagePositions.y
+    }
+  ];
+  const frameSharpInstance = sharp({
+    create: {
+      background: defaultBackgroundColorCreate,
+      width: params.dimensions.widthPx,
+      height: params.dimensions.heightPx,
+      channels: 4
+    }
+  }).ensureAlpha(0).composite(composition).png({ quality: 100 });
+  return frameSharpInstance;
+}
+var scaleImageToFrame = (imageSharp, imageDimensions, frameDimensions, imageScale) => {
+  const scale = {
+    xRatio: 1,
+    yRatio: 1
+  };
+  const frameZoneDimensions = {
+    widthPx: frameDimensions.widthPx,
+    heightPx: frameDimensions.heightPx
+  };
+  if (imageScale) {
+    frameZoneDimensions.widthPx = frameDimensions.widthPx * (imageScale.xRatio || 1);
+    frameZoneDimensions.heightPx = frameDimensions.heightPx * (imageScale.yRatio || 1);
+  }
+  const containedRatiosPercents = getContainedRatios(
+    imageDimensions.widthPx,
+    imageDimensions.heightPx,
+    frameZoneDimensions.widthPx,
+    frameZoneDimensions.heightPx
+  );
+  if (imageScale || !imageScale && imageDimensions.widthPx < frameDimensions.widthPx && imageDimensions.heightPx < frameDimensions.heightPx) {
+    scale.xRatio = containedRatiosPercents.xPercent;
+    scale.yRatio = containedRatiosPercents.yPercent;
+  }
+  if (scale.xRatio !== 1 || scale.yRatio !== 1) {
+    imageDimensions.widthPx = clamp(Math.round(imageDimensions.widthPx * scale.xRatio), 0, frameDimensions.widthPx);
+    imageDimensions.heightPx = clamp(Math.round(imageDimensions.heightPx * scale.yRatio), 0, frameDimensions.heightPx);
+    imageSharp = imageSharp.resize({
+      width: imageDimensions.widthPx,
+      height: imageDimensions.heightPx,
+      fit: sharp.fit.inside,
+      position: "center",
+      fastShrinkOnLoad: false
+    });
+  }
+  return {
+    sharpInstance: imageSharp,
+    widthPx: imageDimensions.widthPx,
+    heightPx: imageDimensions.heightPx
+  };
+};
+var getDefaultBackgroundColor = (background) => {
+  if (background && (typeof background === "object" && "r" in background)) {
+    return {
+      r: background.r || 255,
+      g: background.g || 255,
+      b: background.b || 255,
+      alpha: background.alpha || 0
+    };
+  }
+  return { r: 255, g: 255, b: 255, alpha: 0 };
+};
+var getBackgroundOverlays = (imageInput, background, dimensions, imageCoordinates) => {
+  const backgroundOverlays = [];
+  return new Promise(async (resolve, reject) => {
+    if (!background || typeof background !== "object" || typeof background === "object" && !("type" in background)) {
+      resolve(backgroundOverlays);
+      return;
+    }
+    const imageBuffer = await imageInput.sharp.raw().toBuffer();
+    const nbImageChannels = (await imageInput.sharp.metadata()).channels || 3;
+    const colorPalette = createColorPalette(
+      {
+        buffer: imageBuffer,
+        nbChannels: nbImageChannels,
+        dimensions: imageInput.dimensions
+      },
+      background.colorPalette
+    );
+    switch (background.type) {
+      case "line":
+        return resolve(createLineBackground(background, dimensions, colorPalette));
+      case "tile":
+        return resolve(createTileBackground(background, dimensions, imageCoordinates, colorPalette));
+      default:
+        resolve(backgroundOverlays);
+    }
+    reject(new Error("Unknown background type"));
+  });
+};
+function getContainedRatios(widthPx, heightPx, wrapperWidthPx, wrapperHeightPx, withoutReduction) {
+  if (withoutReduction && widthPx <= wrapperWidthPx && heightPx <= wrapperHeightPx) {
+    return { xPercent: 100, yPercent: 100 };
+  }
+  const wrapperRatio = wrapperWidthPx / wrapperHeightPx;
+  const imgRatio = widthPx / heightPx;
+  const containRatio = clamp(imgRatio > wrapperRatio ? wrapperWidthPx / widthPx : wrapperHeightPx / heightPx, 0, 100);
+  return {
+    xPercent: containRatio,
+    yPercent: containRatio
+  };
+}
+
+export {
+  frame,
+  getContainedRatios
+};