tiny-essentials 1.28.18 → 1.29.0

package/dist/v1/webTemplates/ag-psd/31.0/ProcessSolidFilters/FileInput.cjs

@@ -0,0 +1,66 @@
+'use strict';
+
+var agPsd = require('ag-psd');
+var Template = require('./Template.cjs');
+
+/**
+ * Creates a native browser Canvas element.
+ * @param {number} width - The width to assign to the new canvas, in pixels.
+ * @param {number} height - The height to assign to the new canvas, in pixels.
+ * @returns {HTMLCanvasElement} A new detached HTMLCanvasElement with the requested dimensions.
+ */
+const createBrowserCanvas = (width, height) => {
+  const canvas = document.createElement('canvas');
+  canvas.width = width;
+  canvas.height = height;
+  return canvas;
+};
+
+/**
+ * Processes a PSD receiving a File, Blob, or directly an HTMLInputElement.
+ * @param {HTMLInputElement} psdInput - The absolute path, URL, or Blob file of the PSD.
+ * @param {HTMLCanvasElement[]} filters - The configurations to capture specific layers.
+ * @param {import('./Template.mjs').DefaultConfig} defaultConfig - The fallback configuration for the remaining layers.
+ * @returns {Promise<import('./Template.mjs').ProcessedPsdResult<Blob>>} Results of the separated and reconstructed images, and pixel statistics.
+ * @throws {Error|TypeError} If the parameters or the file are invalid.
+ * @beta
+ */
+const processPsdSolidFiltersFromFile = Template.createProcessPsdSolidFilters(
+  async (fileInput) => {
+    /** @type {File|HTMLInputElement|Blob} */
+    // @ts-ignore
+    let file = fileInput;
+
+    // If the interface passes the HTML input element directly, we extract the file safely.
+    if (fileInput instanceof HTMLInputElement) {
+      if (!fileInput.files || fileInput.files.length === 0) {
+        throw new Error('No PSD file was selected in the file input.');
+      }
+      file = fileInput.files[0];
+    }
+
+    // Strict runtime validation
+    if (!(file instanceof File) && !(file instanceof Blob)) {
+      throw new TypeError(
+        "The 'fileInput' argument must be a File, Blob, or an HTMLInputElement containing a file.",
+      );
+    }
+
+    return file.arrayBuffer();
+  },
+  createBrowserCanvas,
+  agPsd.readPsd,
+  (canvas) => {
+    return new Promise((resolve, reject) => {
+      canvas.toBlob((blob) => {
+        if (blob) {
+          resolve(blob);
+        } else {
+          reject(new Error('Failed to export the image from the browser Canvas element.'));
+        }
+      }, 'image/png');
+    });
+  },
+);
+
+exports.processPsdSolidFiltersFromFile = processPsdSolidFiltersFromFile;

package/dist/v1/webTemplates/ag-psd/31.0/ProcessSolidFilters/FileInput.d.mts

@@ -0,0 +1,11 @@
+/**
+ * Processes a PSD receiving a File, Blob, or directly an HTMLInputElement.
+ * @param {HTMLInputElement} psdInput - The absolute path, URL, or Blob file of the PSD.
+ * @param {HTMLCanvasElement[]} filters - The configurations to capture specific layers.
+ * @param {import('./Template.mjs').DefaultConfig} defaultConfig - The fallback configuration for the remaining layers.
+ * @returns {Promise<import('./Template.mjs').ProcessedPsdResult<Blob>>} Results of the separated and reconstructed images, and pixel statistics.
+ * @throws {Error|TypeError} If the parameters or the file are invalid.
+ * @beta
+ */
+export declare const processPsdSolidFiltersFromFile: (psdInput: string | Blob | HTMLInputElement, filters: import("./Template.mjs").FilterConfig[], defaultConfig: import("./Template.mjs").DefaultConfig) => Promise<import("./Template.mjs").ProcessedPsdResult<any>>;
+//# sourceMappingURL=FileInput.d.mts.map

package/dist/v1/webTemplates/ag-psd/31.0/ProcessSolidFilters/FileInput.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileInput.d.mts","sourceRoot":"","sources":["../../../../../../src/v1/webTemplates/ag-psd/31.0/ProcessSolidFilters/FileInput.mjs"],"names":[],"mappings":"AAgBA;;;;;;;;GAQG;AACH,eAAO,MAAM,8BAA8B,oNAoC1C,CAAC"}

package/dist/v1/webTemplates/ag-psd/31.0/ProcessSolidFilters/FileInput.mjs

@@ -0,0 +1,51 @@
+import { readPsd } from 'ag-psd';
+import { createProcessPsdSolidFilters } from './Template.mjs';
+/**
+ * Creates a native browser Canvas element.
+ * @param {number} width - The width to assign to the new canvas, in pixels.
+ * @param {number} height - The height to assign to the new canvas, in pixels.
+ * @returns {HTMLCanvasElement} A new detached HTMLCanvasElement with the requested dimensions.
+ */
+const createBrowserCanvas = (width, height) => {
+    const canvas = document.createElement('canvas');
+    canvas.width = width;
+    canvas.height = height;
+    return canvas;
+};
+/**
+ * Processes a PSD receiving a File, Blob, or directly an HTMLInputElement.
+ * @param {HTMLInputElement} psdInput - The absolute path, URL, or Blob file of the PSD.
+ * @param {HTMLCanvasElement[]} filters - The configurations to capture specific layers.
+ * @param {import('./Template.mjs').DefaultConfig} defaultConfig - The fallback configuration for the remaining layers.
+ * @returns {Promise<import('./Template.mjs').ProcessedPsdResult<Blob>>} Results of the separated and reconstructed images, and pixel statistics.
+ * @throws {Error|TypeError} If the parameters or the file are invalid.
+ * @beta
+ */
+export const processPsdSolidFiltersFromFile = createProcessPsdSolidFilters(async (fileInput) => {
+    /** @type {File|HTMLInputElement|Blob} */
+    // @ts-ignore
+    let file = fileInput;
+    // If the interface passes the HTML input element directly, we extract the file safely.
+    if (fileInput instanceof HTMLInputElement) {
+        if (!fileInput.files || fileInput.files.length === 0) {
+            throw new Error('No PSD file was selected in the file input.');
+        }
+        file = fileInput.files[0];
+    }
+    // Strict runtime validation
+    if (!(file instanceof File) && !(file instanceof Blob)) {
+        throw new TypeError("The 'fileInput' argument must be a File, Blob, or an HTMLInputElement containing a file.");
+    }
+    return file.arrayBuffer();
+}, createBrowserCanvas, readPsd, (canvas) => {
+    return new Promise((resolve, reject) => {
+        canvas.toBlob((blob) => {
+            if (blob) {
+                resolve(blob);
+            }
+            else {
+                reject(new Error('Failed to export the image from the browser Canvas element.'));
+            }
+        }, 'image/png');
+    });
+});

package/dist/v1/webTemplates/ag-psd/31.0/ProcessSolidFilters/Node.cjs

@@ -0,0 +1,39 @@
+'use strict';
+
+var fs = require('fs');
+var promises = require('fs/promises');
+var agPsd = require('ag-psd');
+var canvas = require('canvas');
+var Template = require('./Template.cjs');
+
+/**
+ * Extracts solid colors and calculates the area of each claimed filter in the PSD.
+ * @param {string} psdInput - The absolute path, URL, or Blob file of the PSD.
+ * @param {import('canvas').Canvas[]} filters - The configurations to capture specific layers.
+ * @param {import('./Template.mjs').DefaultConfig} defaultConfig - The fallback configuration for the remaining layers.
+ * @returns {Promise<import('./Template.mjs').ProcessedPsdResult<Buffer>>} Results of the separated and reconstructed images, and pixel statistics.
+ * @throws {Error|TypeError} If the parameters or the file are invalid.
+ * @beta
+ */
+const processPsdSolidFilters = Template.createProcessPsdSolidFilters(
+  async (psdPath) => {
+    if (typeof psdPath !== 'string') {
+      throw new TypeError(
+        "In the Node.js environment, 'psdPath' must be a string containing the file path.",
+      );
+    }
+    if (!fs.existsSync(psdPath)) {
+      throw new Error(`PSD file not found at the specified path: ${psdPath}`);
+    }
+    return promises.readFile(psdPath);
+  },
+  canvas.createCanvas,
+  agPsd.readPsd,
+  async (canvas) => {
+    // In Node.js with the 'canvas' package, toBuffer is synchronous.
+    // We return it asynchronously to maintain API consistency.
+    return canvas.toBuffer('image/png');
+  },
+);
+
+exports.processPsdSolidFilters = processPsdSolidFilters;

package/dist/v1/webTemplates/ag-psd/31.0/ProcessSolidFilters/Node.d.mts

@@ -0,0 +1,11 @@
+/**
+ * Extracts solid colors and calculates the area of each claimed filter in the PSD.
+ * @param {string} psdInput - The absolute path, URL, or Blob file of the PSD.
+ * @param {import('canvas').Canvas[]} filters - The configurations to capture specific layers.
+ * @param {import('./Template.mjs').DefaultConfig} defaultConfig - The fallback configuration for the remaining layers.
+ * @returns {Promise<import('./Template.mjs').ProcessedPsdResult<Buffer>>} Results of the separated and reconstructed images, and pixel statistics.
+ * @throws {Error|TypeError} If the parameters or the file are invalid.
+ * @beta
+ */
+export declare const processPsdSolidFilters: (psdInput: string | Blob | HTMLInputElement, filters: import("./Template.mjs").FilterConfig[], defaultConfig: import("./Template.mjs").DefaultConfig) => Promise<import("./Template.mjs").ProcessedPsdResult<Buffer<ArrayBufferLike>>>;
+//# sourceMappingURL=Node.d.mts.map

package/dist/v1/webTemplates/ag-psd/31.0/ProcessSolidFilters/Node.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Node.d.mts","sourceRoot":"","sources":["../../../../../../src/v1/webTemplates/ag-psd/31.0/ProcessSolidFilters/Node.mjs"],"names":[],"mappings":"AAOA;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,wOAmBlC,CAAC"}

package/dist/v1/webTemplates/ag-psd/31.0/ProcessSolidFilters/Node.mjs

@@ -0,0 +1,28 @@
+import { existsSync } from 'fs';
+import { readFile } from 'fs/promises';
+import { readPsd } from 'ag-psd';
+// import 'ag-psd/initialize-canvas'; // Strict requirement of ag-psd to run in Node.js
+import { createCanvas } from 'canvas';
+import { createProcessPsdSolidFilters } from './Template.mjs';
+/**
+ * Extracts solid colors and calculates the area of each claimed filter in the PSD.
+ * @param {string} psdInput - The absolute path, URL, or Blob file of the PSD.
+ * @param {import('canvas').Canvas[]} filters - The configurations to capture specific layers.
+ * @param {import('./Template.mjs').DefaultConfig} defaultConfig - The fallback configuration for the remaining layers.
+ * @returns {Promise<import('./Template.mjs').ProcessedPsdResult<Buffer>>} Results of the separated and reconstructed images, and pixel statistics.
+ * @throws {Error|TypeError} If the parameters or the file are invalid.
+ * @beta
+ */
+export const processPsdSolidFilters = createProcessPsdSolidFilters(async (psdPath) => {
+    if (typeof psdPath !== 'string') {
+        throw new TypeError("In the Node.js environment, 'psdPath' must be a string containing the file path.");
+    }
+    if (!existsSync(psdPath)) {
+        throw new Error(`PSD file not found at the specified path: ${psdPath}`);
+    }
+    return readFile(psdPath);
+}, createCanvas, readPsd, async (canvas) => {
+    // In Node.js with the 'canvas' package, toBuffer is synchronous.
+    // We return it asynchronously to maintain API consistency.
+    return canvas.toBuffer('image/png');
+});