@adaptive-ds/assets-optimizer 0.2.0 → 0.2.1

package/changelogs/2026-04-18_v0.2.1.md

@@ -0,0 +1,5 @@
+## [0.2.1] - 2026-04-18
+
+### 🐛 Bug Fixes
+
+- *(build)* Include dist dir in published packages

package/dist/AssetsOptimizeOptions.d.ts

@@ -0,0 +1,17 @@
+export interface AssetsOptimizeOptions {
+    cwd?: string;
+    logLevel?: 0 | 1 | 2 | 3;
+    processImages?: boolean;
+    imageOriginalsDir?: string;
+    imageOptimizedDir?: string;
+    allowRootImageFiles?: boolean;
+    imageListOutputPath?: string;
+    generateImageList?: boolean;
+    processVideos?: boolean;
+    videoOriginalsDir?: string;
+    videoOptimizedDir?: string;
+    videoListOutputPath?: string;
+    generateVideoList?: boolean;
+    videoPreviewQuality?: number;
+}
+//# sourceMappingURL=AssetsOptimizeOptions.d.ts.map

package/dist/AssetsOptimizeOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AssetsOptimizeOptions.d.ts","sourceRoot":"","sources":["../src/AssetsOptimizeOptions.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,qBAAqB;IACpC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IACxB,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,mBAAmB,CAAC,EAAE,MAAM,CAAA;CAC7B"}

package/dist/AssetsOptimizeOptions.js

@@ -0,0 +1 @@
+export {};

package/dist/AssetsOptimizeResult.d.ts

@@ -0,0 +1,12 @@
+export interface AssetsOptimizeResult {
+    processed: string[];
+    skippedExisting: string[];
+    skippedRootFiles: string[];
+    warnings: string[];
+    deletedLocal: string[];
+    processedVideos: string[];
+    skippedExistingVideos: string[];
+    processedVideoPreviews: string[];
+    skippedExistingVideoPreviews: string[];
+}
+//# sourceMappingURL=AssetsOptimizeResult.d.ts.map

package/dist/AssetsOptimizeResult.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AssetsOptimizeResult.d.ts","sourceRoot":"","sources":["../src/AssetsOptimizeResult.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,eAAe,EAAE,MAAM,EAAE,CAAA;IACzB,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,eAAe,EAAE,MAAM,EAAE,CAAA;IACzB,qBAAqB,EAAE,MAAM,EAAE,CAAA;IAC/B,sBAAsB,EAAE,MAAM,EAAE,CAAA;IAChC,4BAA4B,EAAE,MAAM,EAAE,CAAA;CACvC"}

package/dist/AssetsOptimizeResult.js

@@ -0,0 +1 @@
+export {};

package/dist/assetsOptimize.d.ts

@@ -0,0 +1,4 @@
+import type { AssetsOptimizeOptions } from "./AssetsOptimizeOptions.js";
+import type { AssetsOptimizeResult } from "./AssetsOptimizeResult.js";
+export declare function assetsOptimize(options?: AssetsOptimizeOptions): Promise<AssetsOptimizeResult>;
+//# sourceMappingURL=assetsOptimize.d.ts.map

package/dist/assetsOptimize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assetsOptimize.d.ts","sourceRoot":"","sources":["../src/assetsOptimize.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AACvE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAQrE,wBAAsB,cAAc,CAAC,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAyDvG"}

package/dist/assetsOptimize.js

@@ -0,0 +1,61 @@
+import path from "node:path";
+import { processImages } from "./image/processImages.js";
+import { generateImageList } from "./list/generateImageList.js";
+import { generateVideoList } from "./list/generateVideoList.js";
+import { createLogger } from "./shared/logger.js";
+import { printSummary } from "./shared/printSummary.js";
+import { processVideos } from "./video/processVideos.js";
+export async function assetsOptimize(options = {}) {
+    const cwd = path.resolve(options.cwd ?? process.cwd());
+    const processImagesEnabled = options.processImages !== false;
+    const processVideosEnabled = options.processVideos !== false;
+    const imageOriginalsDir = path.resolve(cwd, options.imageOriginalsDir ?? "images");
+    const imageOptimizedDir = path.resolve(cwd, options.imageOptimizedDir ?? "public/images");
+    const imageListOutputPath = path.resolve(cwd, options.imageListOutputPath ?? "src/app/assets/imageList.ts");
+    const videoOriginalsDir = path.resolve(cwd, options.videoOriginalsDir ?? "videos");
+    const videoOptimizedDir = path.resolve(cwd, options.videoOptimizedDir ?? "public/videos");
+    const videoListOutputPath = path.resolve(cwd, options.videoListOutputPath ?? "src/app/assets/videoList.ts");
+    const logger = createLogger(options.logLevel);
+    const result = {
+        processed: [],
+        skippedExisting: [],
+        skippedRootFiles: [],
+        warnings: [],
+        deletedLocal: [],
+        processedVideos: [],
+        skippedExistingVideos: [],
+        processedVideoPreviews: [],
+        skippedExistingVideoPreviews: [],
+    };
+    await Promise.all([
+        processImagesEnabled
+            ? processImages({
+                imageOriginalsDir,
+                imageOptimizedDir,
+                allowRootImageFiles: options.allowRootImageFiles === true,
+                result,
+                logger,
+            })
+            : Promise.resolve(),
+        processVideosEnabled
+            ? processVideos({
+                cwd,
+                videoOriginalsDir,
+                videoOptimizedDir,
+                videoPreviewQuality: options.videoPreviewQuality ?? 80,
+                result,
+                logger,
+            })
+            : Promise.resolve(),
+    ]);
+    await Promise.all([
+        options.generateImageList === false
+            ? Promise.resolve()
+            : generateImageList(imageOptimizedDir, imageListOutputPath, undefined, logger),
+        options.generateVideoList === false
+            ? Promise.resolve()
+            : generateVideoList(videoOptimizedDir, videoListOutputPath, undefined, logger),
+    ]);
+    printSummary(result, logger);
+    return result;
+}

package/dist/image/ExpectedImage.d.ts

@@ -0,0 +1,5 @@
+export interface ExpectedImage {
+    localPath: string;
+    fileName: string;
+}
+//# sourceMappingURL=ExpectedImage.d.ts.map

package/dist/image/ExpectedImage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExpectedImage.d.ts","sourceRoot":"","sources":["../../src/image/ExpectedImage.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;CACjB"}

package/dist/image/ExpectedImage.js

@@ -0,0 +1 @@
+export {};

package/dist/image/ImageFormat.d.ts

@@ -0,0 +1,2 @@
+export type ImageFormat = "jpg" | "png" | "webp" | "avif";
+//# sourceMappingURL=ImageFormat.d.ts.map

package/dist/image/ImageFormat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImageFormat.d.ts","sourceRoot":"","sources":["../../src/image/ImageFormat.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAA"}

package/dist/image/ImageFormat.js

@@ -0,0 +1 @@
+export {};

package/dist/image/ProcessImagesOptions.d.ts

@@ -0,0 +1,10 @@
+import type { AssetsOptimizeResult } from "../AssetsOptimizeResult.js";
+import type { Logger } from "../shared/logger.js";
+export interface ProcessImagesOptions {
+    imageOriginalsDir: string;
+    imageOptimizedDir: string;
+    allowRootImageFiles: boolean;
+    result: AssetsOptimizeResult;
+    logger: Logger;
+}
+//# sourceMappingURL=ProcessImagesOptions.d.ts.map

package/dist/image/ProcessImagesOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProcessImagesOptions.d.ts","sourceRoot":"","sources":["../../src/image/ProcessImagesOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AACtE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAEjD,MAAM,WAAW,oBAAoB;IACnC,iBAAiB,EAAE,MAAM,CAAA;IACzB,iBAAiB,EAAE,MAAM,CAAA;IACzB,mBAAmB,EAAE,OAAO,CAAA;IAC5B,MAAM,EAAE,oBAAoB,CAAA;IAC5B,MAAM,EAAE,MAAM,CAAA;CACf"}

package/dist/image/ProcessImagesOptions.js

@@ -0,0 +1 @@
+export {};

package/dist/image/TransformSpec.d.ts

@@ -0,0 +1,8 @@
+import type { ImageFormat } from "./ImageFormat.js";
+export interface TransformSpec {
+    width: number;
+    height: number;
+    format: ImageFormat;
+    normalized: string;
+}
+//# sourceMappingURL=TransformSpec.d.ts.map

package/dist/image/TransformSpec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransformSpec.d.ts","sourceRoot":"","sources":["../../src/image/TransformSpec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEnD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,WAAW,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;CACnB"}

package/dist/image/TransformSpec.js

@@ -0,0 +1 @@
+export {};

package/dist/image/buildExpectedImages.d.ts

@@ -0,0 +1,4 @@
+import type { AssetsOptimizeResult } from "../AssetsOptimizeResult.js";
+import { type ExpectedImage } from "./ExpectedImage.js";
+export declare function buildExpectedImages(originalsDir: string, optimizedDir: string, result: AssetsOptimizeResult, allowRootImageFiles?: boolean): Promise<ExpectedImage[]>;
+//# sourceMappingURL=buildExpectedImages.d.ts.map

package/dist/image/buildExpectedImages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildExpectedImages.d.ts","sourceRoot":"","sources":["../../src/image/buildExpectedImages.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AAItE,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAKvD,wBAAsB,mBAAmB,CACvC,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,oBAAoB,EAC5B,mBAAmB,UAAQ,GAC1B,OAAO,CAAC,aAAa,EAAE,CAAC,CA0F1B"}

package/dist/image/buildExpectedImages.js

@@ -0,0 +1,89 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { walkFiles } from "../shared/walkFiles.js";
+import { createOutputHash } from "./createOutputHash.js";
+import { createRootImageTransform } from "./createRootImageTransform.js";
+import {} from "./ExpectedImage.js";
+import { parseTransformSpec } from "./parseTransformSpec.js";
+import { processImage } from "./processImage.js";
+import { supportedSourceExtensions } from "./supportedSourceExtensions.js";
+export async function buildExpectedImages(originalsDir, optimizedDir, result, allowRootImageFiles = false) {
+    const dirEntries = await fs.readdir(originalsDir, { withFileTypes: true });
+    const expectedImages = [];
+    for (const entry of dirEntries) {
+        const entryPath = path.join(originalsDir, entry.name);
+        if (entry.isFile()) {
+            if (!allowRootImageFiles) {
+                result.skippedRootFiles.push(entry.name);
+                result.warnings.push(`Skipped root original file: ${entry.name}`);
+                console.warn(`Skipped root original file: ${entry.name}`);
+                continue;
+            }
+            const extension = path.extname(entry.name).toLowerCase();
+            if (!supportedSourceExtensions.has(extension)) {
+                result.warnings.push(`Skipped unsupported root source file: ${entry.name}`);
+                console.warn(`Skipped unsupported root source file: ${entry.name}`);
+                continue;
+            }
+            const sourceBuffer = await fs.readFile(entryPath);
+            const transform = createRootImageTransform(entryPath, sourceBuffer);
+            if (!transform) {
+                result.warnings.push(`Skipped root source file with unsupported output format: ${entry.name}`);
+                console.warn(`Skipped root source file with unsupported output format: ${entry.name}`);
+                continue;
+            }
+            const hash = createOutputHash(sourceBuffer, transform.normalized);
+            const baseName = path.parse(entryPath).name;
+            const fileName = `${baseName}_${hash}.${transform.format}`;
+            const outputPath = path.join(optimizedDir, fileName);
+            expectedImages.push({
+                fileName,
+                localPath: outputPath,
+            });
+            try {
+                await fs.access(outputPath);
+                result.skippedExisting.push(fileName);
+            }
+            catch {
+                await processImage(sourceBuffer, outputPath, transform);
+                result.processed.push(fileName);
+            }
+            continue;
+        }
+        if (!entry.isDirectory()) {
+            continue;
+        }
+        const transform = parseTransformSpec(entry.name);
+        if (!transform) {
+            result.warnings.push(`Skipped folder with invalid transform name: ${entry.name}`);
+            console.warn(`Skipped folder with invalid transform name: ${entry.name}`);
+            continue;
+        }
+        for (const sourceFile of await walkFiles(entryPath)) {
+            const extension = path.extname(sourceFile).toLowerCase();
+            if (!supportedSourceExtensions.has(extension)) {
+                result.warnings.push(`Skipped unsupported source file: ${path.relative(originalsDir, sourceFile)}`);
+                console.warn(`Skipped unsupported source file: ${path.relative(originalsDir, sourceFile)}`);
+                continue;
+            }
+            const sourceBuffer = await fs.readFile(sourceFile);
+            const hash = createOutputHash(sourceBuffer, transform.normalized);
+            const baseName = path.parse(sourceFile).name;
+            const fileName = `${baseName}_${hash}.${transform.format}`;
+            const outputPath = path.join(optimizedDir, fileName);
+            expectedImages.push({
+                fileName,
+                localPath: outputPath,
+            });
+            try {
+                await fs.access(outputPath);
+                result.skippedExisting.push(fileName);
+            }
+            catch {
+                await processImage(sourceBuffer, outputPath, transform);
+                result.processed.push(fileName);
+            }
+        }
+    }
+    return expectedImages;
+}

package/dist/image/createOutputHash.d.ts

@@ -0,0 +1,2 @@
+export declare function createOutputHash(sourceBuffer: Buffer, transformSpec: string): string;
+//# sourceMappingURL=createOutputHash.d.ts.map

package/dist/image/createOutputHash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createOutputHash.d.ts","sourceRoot":"","sources":["../../src/image/createOutputHash.ts"],"names":[],"mappings":"AAEA,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAEpF"}

package/dist/image/createOutputHash.js

@@ -0,0 +1,4 @@
+import { createHash } from "node:crypto";
+export function createOutputHash(sourceBuffer, transformSpec) {
+    return createHash("sha256").update(sourceBuffer).update(transformSpec).digest("hex").slice(0, 8);
+}

package/dist/image/createOutputHashForFile.d.ts

@@ -0,0 +1,2 @@
+export declare function createOutputHashForFile(sourcePath: string, transformSpec: string): Promise<string>;
+//# sourceMappingURL=createOutputHashForFile.d.ts.map

package/dist/image/createOutputHashForFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createOutputHashForFile.d.ts","sourceRoot":"","sources":["../../src/image/createOutputHashForFile.ts"],"names":[],"mappings":"AAGA,wBAAsB,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAaxG"}

package/dist/image/createOutputHashForFile.js

@@ -0,0 +1,14 @@
+import { createHash } from "node:crypto";
+import fs from "node:fs";
+export async function createOutputHashForFile(sourcePath, transformSpec) {
+    const hash = createHash("sha256");
+    await new Promise((resolve, reject) => {
+        const stream = fs.createReadStream(sourcePath);
+        stream.on("data", (chunk) => {
+            hash.update(chunk);
+        });
+        stream.on("end", resolve);
+        stream.on("error", reject);
+    });
+    return hash.update(transformSpec).digest("hex").slice(0, 8);
+}

package/dist/image/createRootImageTransform.d.ts

@@ -0,0 +1,3 @@
+import type { TransformSpec } from "./TransformSpec.js";
+export declare function createRootImageTransform(sourceFile: string, sourceBuffer: Buffer): TransformSpec | null;
+//# sourceMappingURL=createRootImageTransform.d.ts.map

package/dist/image/createRootImageTransform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createRootImageTransform.d.ts","sourceRoot":"","sources":["../../src/image/createRootImageTransform.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAEvD,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAiBvG"}

package/dist/image/createRootImageTransform.js

@@ -0,0 +1,33 @@
+import { imageSize } from "image-size";
+import path from "node:path";
+export function createRootImageTransform(sourceFile, sourceBuffer) {
+    const format = getOutputFormat(path.extname(sourceFile).toLowerCase());
+    if (!format) {
+        return null;
+    }
+    const dimensions = imageSize(sourceBuffer);
+    if (!dimensions.width || !dimensions.height) {
+        return null;
+    }
+    return {
+        width: dimensions.width,
+        height: dimensions.height,
+        format,
+        normalized: `root_${dimensions.width}x${dimensions.height}_${format}`,
+    };
+}
+function getOutputFormat(extension) {
+    switch (extension) {
+        case ".jpg":
+        case ".jpeg":
+            return "jpg";
+        case ".png":
+            return "png";
+        case ".webp":
+            return "webp";
+        case ".avif":
+            return "avif";
+        default:
+            return null;
+    }
+}

package/dist/image/defaultQuality.d.ts

@@ -0,0 +1,2 @@
+export declare const defaultQuality = 80;
+//# sourceMappingURL=defaultQuality.d.ts.map

package/dist/image/defaultQuality.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultQuality.d.ts","sourceRoot":"","sources":["../../src/image/defaultQuality.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,KAAK,CAAA"}

package/dist/image/defaultQuality.js

@@ -0,0 +1 @@
+export const defaultQuality = 80;

package/dist/image/imageFormats.d.ts

@@ -0,0 +1,3 @@
+import type { ImageFormat } from "./ImageFormat.js";
+export declare const imageFormats: Set<ImageFormat>;
+//# sourceMappingURL=imageFormats.d.ts.map

package/dist/image/imageFormats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imageFormats.d.ts","sourceRoot":"","sources":["../../src/image/imageFormats.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEnD,eAAO,MAAM,YAAY,kBAAuD,CAAA"}

package/dist/image/imageFormats.js

@@ -0,0 +1 @@
+export const imageFormats = new Set(["jpg", "png", "webp", "avif"]);

package/dist/image/isImageFormat.d.ts

@@ -0,0 +1,3 @@
+import { type ImageFormat } from "./ImageFormat.js";
+export declare function isImageFormat(value: string): value is ImageFormat;
+//# sourceMappingURL=isImageFormat.d.ts.map

package/dist/image/isImageFormat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isImageFormat.d.ts","sourceRoot":"","sources":["../../src/image/isImageFormat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAGnD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,WAAW,CAEjE"}

package/dist/image/isImageFormat.js

@@ -0,0 +1,5 @@
+import {} from "./ImageFormat.js";
+import { imageFormats } from "./imageFormats.js";
+export function isImageFormat(value) {
+    return imageFormats.has(value);
+}

package/dist/image/parseTransformSpec.d.ts

@@ -0,0 +1,3 @@
+import type { TransformSpec } from "./TransformSpec.js";
+export declare function parseTransformSpec(dirName: string): TransformSpec | null;
+//# sourceMappingURL=parseTransformSpec.d.ts.map

package/dist/image/parseTransformSpec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseTransformSpec.d.ts","sourceRoot":"","sources":["../../src/image/parseTransformSpec.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAEvD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CA4BxE"}

package/dist/image/parseTransformSpec.js

@@ -0,0 +1,26 @@
+import { isImageFormat } from "./isImageFormat.js";
+export function parseTransformSpec(dirName) {
+    const match = /^(?<width>\d+)x(?<height>\d+)_(?<format>jpg|png|webp|avif)$/.exec(dirName);
+    if (!match?.groups) {
+        return null;
+    }
+    const { width: widthValue, height: heightValue, format: formatValue } = match.groups;
+    if (!widthValue || !heightValue || !formatValue) {
+        return null;
+    }
+    const width = Number.parseInt(widthValue, 10);
+    const height = Number.parseInt(heightValue, 10);
+    if (!isImageFormat(formatValue)) {
+        return null;
+    }
+    const format = formatValue;
+    if (!Number.isFinite(width) || !Number.isFinite(height) || width <= 0 || height <= 0) {
+        return null;
+    }
+    return {
+        width,
+        height,
+        format,
+        normalized: `${width}x${height}_${format}`,
+    };
+}

package/dist/image/processImage.d.ts

@@ -0,0 +1,3 @@
+import type { TransformSpec } from "./TransformSpec.js";
+export declare function processImage(sourceBuffer: Buffer, outputPath: string, transform: TransformSpec, quality?: number): Promise<void>;
+//# sourceMappingURL=processImage.d.ts.map

package/dist/image/processImage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processImage.d.ts","sourceRoot":"","sources":["../../src/image/processImage.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAEvD,wBAAsB,YAAY,CAChC,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,aAAa,EACxB,OAAO,SAAiB,GACvB,OAAO,CAAC,IAAI,CAAC,CA0Bf"}

package/dist/image/processImage.js

@@ -0,0 +1,28 @@
+import sharp from "sharp";
+import { assertNever } from "../shared/assertNever.js";
+import { defaultQuality } from "./defaultQuality.js";
+export async function processImage(sourceBuffer, outputPath, transform, quality = defaultQuality) {
+    let pipeline = sharp(sourceBuffer, { animated: false }).rotate().resize({
+        width: transform.width,
+        height: transform.height,
+        fit: "inside",
+        withoutEnlargement: true,
+    });
+    switch (transform.format) {
+        case "jpg":
+            pipeline = pipeline.jpeg({ quality });
+            break;
+        case "png":
+            pipeline = pipeline.png({ quality });
+            break;
+        case "webp":
+            pipeline = pipeline.webp({ quality });
+            break;
+        case "avif":
+            pipeline = pipeline.avif({ quality });
+            break;
+        default:
+            assertNever(transform.format);
+    }
+    await pipeline.toFile(outputPath);
+}

package/dist/image/processImages.d.ts

@@ -0,0 +1,3 @@
+import type { ProcessImagesOptions } from "./ProcessImagesOptions.js";
+export declare function processImages(options: ProcessImagesOptions): Promise<void>;
+//# sourceMappingURL=processImages.d.ts.map

package/dist/image/processImages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processImages.d.ts","sourceRoot":"","sources":["../../src/image/processImages.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAErE,wBAAsB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBhF"}

package/dist/image/processImages.js

@@ -0,0 +1,19 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { listLocalFiles } from "../shared/listLocalFiles.js";
+import { buildExpectedImages } from "./buildExpectedImages.js";
+export async function processImages(options) {
+    const { allowRootImageFiles, imageOptimizedDir, imageOriginalsDir, result } = options;
+    await fs.mkdir(imageOriginalsDir, { recursive: true });
+    await fs.mkdir(imageOptimizedDir, { recursive: true });
+    const expectedImages = await buildExpectedImages(imageOriginalsDir, imageOptimizedDir, result, allowRootImageFiles);
+    const expectedFileNames = new Set(expectedImages.map((image) => image.fileName));
+    const localOptimizedFiles = await listLocalFiles(imageOptimizedDir);
+    for (const localFile of localOptimizedFiles) {
+        const relativeFile = path.relative(imageOptimizedDir, localFile);
+        if (!expectedFileNames.has(relativeFile) && !relativeFile.startsWith(".")) {
+            await fs.rm(localFile, { force: true });
+            result.deletedLocal.push(relativeFile);
+        }
+    }
+}

package/dist/image/supportedSourceExtensions.d.ts

@@ -0,0 +1,2 @@
+export declare const supportedSourceExtensions: Set<string>;
+//# sourceMappingURL=supportedSourceExtensions.d.ts.map

package/dist/image/supportedSourceExtensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supportedSourceExtensions.d.ts","sourceRoot":"","sources":["../../src/image/supportedSourceExtensions.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,yBAAyB,aAAgF,CAAA"}

package/dist/image/supportedSourceExtensions.js

@@ -0,0 +1 @@
+export const supportedSourceExtensions = new Set([".jpg", ".jpeg", ".png", ".webp", ".avif", ".tif", ".tiff", ".gif"]);

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+export * from "./AssetsOptimizeOptions.js";
+export * from "./AssetsOptimizeResult.js";
+export * from "./image/buildExpectedImages.js";
+export * from "./image/createOutputHash.js";
+export * from "./image/defaultQuality.js";
+export * from "./image/ExpectedImage.js";
+export * from "./image/ImageFormat.js";
+export * from "./image/parseTransformSpec.js";
+export * from "./image/processImage.js";
+export * from "./image/processImages.js";
+export * from "./image/ProcessImagesOptions.js";
+export * from "./image/supportedSourceExtensions.js";
+export * from "./image/TransformSpec.js";
+export * from "./list/AssetListTypes.js";
+export * from "./list/generateImageList.js";
+export * from "./list/generateVideoList.js";
+export * from "./assetsOptimize.js";
+export * from "./rclone/bisync.js";
+export * from "./rclone/runRclone.js";
+export * from "./shared/listLocalFiles.js";
+export * from "./shared/printSummary.js";
+export * from "./shared/walkFiles.js";
+export * from "./video/createVideoPreviewPath.js";
+export * from "./video/ensureVideoPreviews.js";
+export * from "./video/processVideos.js";
+export * from "./video/ProcessVideosOptions.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAA;AAC1C,cAAc,2BAA2B,CAAA;AACzC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,6BAA6B,CAAA;AAC3C,cAAc,2BAA2B,CAAA;AACzC,cAAc,0BAA0B,CAAA;AACxC,cAAc,wBAAwB,CAAA;AACtC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,yBAAyB,CAAA;AACvC,cAAc,0BAA0B,CAAA;AACxC,cAAc,iCAAiC,CAAA;AAC/C,cAAc,sCAAsC,CAAA;AACpD,cAAc,0BAA0B,CAAA;AACxC,cAAc,0BAA0B,CAAA;AACxC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,6BAA6B,CAAA;AAC3C,cAAc,qBAAqB,CAAA;AACnC,cAAc,oBAAoB,CAAA;AAClC,cAAc,uBAAuB,CAAA;AACrC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,0BAA0B,CAAA;AACxC,cAAc,uBAAuB,CAAA;AACrC,cAAc,mCAAmC,CAAA;AACjD,cAAc,gCAAgC,CAAA;AAC9C,cAAc,0BAA0B,CAAA;AACxC,cAAc,iCAAiC,CAAA"}

package/dist/index.js

@@ -0,0 +1,26 @@
+export * from "./AssetsOptimizeOptions.js";
+export * from "./AssetsOptimizeResult.js";
+export * from "./image/buildExpectedImages.js";
+export * from "./image/createOutputHash.js";
+export * from "./image/defaultQuality.js";
+export * from "./image/ExpectedImage.js";
+export * from "./image/ImageFormat.js";
+export * from "./image/parseTransformSpec.js";
+export * from "./image/processImage.js";
+export * from "./image/processImages.js";
+export * from "./image/ProcessImagesOptions.js";
+export * from "./image/supportedSourceExtensions.js";
+export * from "./image/TransformSpec.js";
+export * from "./list/AssetListTypes.js";
+export * from "./list/generateImageList.js";
+export * from "./list/generateVideoList.js";
+export * from "./assetsOptimize.js";
+export * from "./rclone/bisync.js";
+export * from "./rclone/runRclone.js";
+export * from "./shared/listLocalFiles.js";
+export * from "./shared/printSummary.js";
+export * from "./shared/walkFiles.js";
+export * from "./video/createVideoPreviewPath.js";
+export * from "./video/ensureVideoPreviews.js";
+export * from "./video/processVideos.js";
+export * from "./video/ProcessVideosOptions.js";

package/dist/list/AssetListTypes.d.ts

@@ -0,0 +1,13 @@
+export interface ImageType {
+    path: string;
+    width: number;
+    height: number;
+    alt: string;
+    mimeType?: string;
+}
+export interface VideoType {
+    path: string;
+    mimeType?: string;
+    image: ImageType;
+}
+//# sourceMappingURL=AssetListTypes.d.ts.map

package/dist/list/AssetListTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AssetListTypes.d.ts","sourceRoot":"","sources":["../../src/list/AssetListTypes.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,SAAS,CAAA;CACjB"}

package/dist/list/AssetListTypes.js

@@ -0,0 +1 @@
+export {};

package/dist/list/formatGeneratedCodeFile.d.ts

@@ -0,0 +1,3 @@
+import type { Logger } from "../shared/logger.js";
+export declare function formatGeneratedCodeFile(outputPath: string, logger?: Logger): Promise<void>;
+//# sourceMappingURL=formatGeneratedCodeFile.d.ts.map

package/dist/list/formatGeneratedCodeFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatGeneratedCodeFile.d.ts","sourceRoot":"","sources":["../../src/list/formatGeneratedCodeFile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAEjD,wBAAsB,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiChG"}