@julien-lin/universal-pwa-core 1.3.4 → 1.3.6

package/dist/index.cjs

@@ -60,6 +60,7 @@ __export(index_exports, {
   generateSplashScreensOnly: () => generateSplashScreensOnly,
   injectMetaTags: () => injectMetaTags,
   injectMetaTagsInFile: () => injectMetaTagsInFile,
+  injectMetaTagsInFilesBatch: () => injectMetaTagsInFilesBatch,
   optimizeImage: () => optimizeImage,
   optimizeProject: () => optimizeProject,
   optimizeProjectImages: () => optimizeProjectImages,
@@ -1646,9 +1647,11 @@ async function scanProject(options) {
       buildTool: null
     }
   };
-  const assetsCandidate = includeAssets ? await detectAssets(projectPath) : getEmptyAssets();
+  const [assetsCandidate, architectureCandidate] = await Promise.all([
+    includeAssets ? detectAssets(projectPath) : Promise.resolve(getEmptyAssets()),
+    includeArchitecture ? detectArchitecture(projectPath) : Promise.resolve(getEmptyArchitecture())
+  ]);
   const assets = isAssetDetectionResult(assetsCandidate) ? assetsCandidate : getEmptyAssets();
-  const architectureCandidate = includeArchitecture ? await detectArchitecture(projectPath) : getEmptyArchitecture();
   const architecture = isArchitectureDetectionResult(architectureCandidate) ? architectureCandidate : getEmptyArchitecture();
   const result = {
     framework,
@@ -1814,9 +1817,117 @@ function generateAndWriteManifest(options, outputDir) {
 }
 
 // src/generator/icon-generator.ts
+var import_sharp3 = __toESM(require("sharp"), 1);
+var import_fs9 = require("fs");
+var import_path8 = require("path");
+
+// src/validator/icon-validator.ts
 var import_sharp2 = __toESM(require("sharp"), 1);
 var import_fs8 = require("fs");
-var import_path8 = require("path");
+async function validateIconSource(options) {
+  const {
+    sourceImage,
+    strict = false,
+    minRecommendedSize = 192,
+    optimalSize = 512
+  } = options;
+  const result = {
+    valid: true,
+    errors: [],
+    warnings: [],
+    suggestions: []
+  };
+  if (!(0, import_fs8.existsSync)(sourceImage)) {
+    result.valid = false;
+    result.errors.push(`Source image not found: ${sourceImage}`);
+    return result;
+  }
+  try {
+    const image = (0, import_sharp2.default)(sourceImage);
+    const metadata = await image.metadata();
+    if (!metadata.width || !metadata.height) {
+      result.valid = false;
+      result.errors.push("Unable to read image dimensions");
+      return result;
+    }
+    const { width, height, format, size } = metadata;
+    const minDimension = Math.min(width, height);
+    const maxDimension = Math.max(width, height);
+    const isSquare = width === height;
+    result.metadata = {
+      width,
+      height,
+      format: format || "unknown",
+      size: size || 0
+    };
+    const supportedFormats = ["png", "jpeg", "jpg", "webp", "svg"];
+    if (!format || !supportedFormats.includes(format.toLowerCase())) {
+      result.valid = false;
+      result.errors.push(
+        `Unsupported image format: ${format || "unknown"}. Supported formats: ${supportedFormats.join(", ")}`
+      );
+    }
+    if (minDimension < minRecommendedSize) {
+      const message = `Icon dimensions too small: ${width}x${height}. Minimum recommended: ${minRecommendedSize}x${minRecommendedSize}`;
+      if (strict) {
+        result.valid = false;
+        result.errors.push(message);
+      } else {
+        result.warnings.push(message);
+        result.suggestions.push(
+          `Use an image at least ${minRecommendedSize}x${minRecommendedSize} pixels for best PWA compatibility`
+        );
+      }
+    }
+    if (minDimension < optimalSize) {
+      result.warnings.push(
+        `Icon dimensions below optimal size: ${width}x${height}. Optimal size: ${optimalSize}x${optimalSize} for best quality on all devices`
+      );
+      result.suggestions.push(
+        `Consider using a ${optimalSize}x${optimalSize} source image for optimal icon quality`
+      );
+    }
+    if (!isSquare) {
+      result.warnings.push(
+        `Icon is not square (${width}x${height}). Square images work best for PWA icons`
+      );
+      result.suggestions.push(
+        "Consider using a square source image. The icon will be cropped to fit during generation"
+      );
+    }
+    if (format?.toLowerCase() === "jpg" || format?.toLowerCase() === "jpeg") {
+      result.suggestions.push(
+        "PNG format is recommended for icons with transparency. Consider converting JPG to PNG"
+      );
+    }
+    if (size && size > 1024 * 1024) {
+      const sizeMB = (size / (1024 * 1024)).toFixed(2);
+      result.warnings.push(`Icon file size is large: ${sizeMB}MB. This may slow down generation`);
+      result.suggestions.push(
+        "Consider optimizing the source image before generation to reduce file size"
+      );
+    } else if (size && size > 500 * 1024) {
+      const sizeKB = (size / 1024).toFixed(2);
+      result.suggestions.push(
+        `Icon file size is ${sizeKB}KB. Consider optimizing to reduce generation time`
+      );
+    }
+    const aspectRatio = maxDimension / minDimension;
+    if (aspectRatio > 2) {
+      result.warnings.push(
+        `Icon has extreme aspect ratio (${aspectRatio.toFixed(2)}:1). Square images are recommended`
+      );
+    }
+    return result;
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    result.valid = false;
+    result.errors.push(`Failed to validate icon: ${message}`);
+    return result;
+  }
+}
+
+// src/generator/icon-generator.ts
 var STANDARD_ICON_SIZES = [
   { width: 72, height: 72, name: "icon-72x72.png" },
   { width: 96, height: 96, name: "icon-96x96.png" },
@@ -1850,67 +1961,114 @@ async function generateIcons(options) {
     iconSizes = STANDARD_ICON_SIZES,
     splashSizes = STANDARD_SPLASH_SIZES,
     format = "png",
-    quality = 90
+    quality = 90,
+    validate = false,
+    strictValidation = false
   } = options;
-  if (!(0, import_fs8.existsSync)(sourceImage)) {
+  if (!(0, import_fs9.existsSync)(sourceImage)) {
     throw new Error(`Source image not found: ${sourceImage}`);
   }
-  (0, import_fs8.mkdirSync)(outputDir, { recursive: true });
+  let validation;
+  if (validate) {
+    validation = await validateIconSource({
+      sourceImage,
+      strict: strictValidation
+    });
+    if (strictValidation && !validation.valid) {
+      const errorMessages = validation.errors.join("; ");
+      throw new Error(`Icon validation failed: ${errorMessages}`);
+    }
+  }
+  (0, import_fs9.mkdirSync)(outputDir, { recursive: true });
   const generatedFiles = [];
   const icons = [];
   const splashScreens = [];
-  const image = (0, import_sharp2.default)(sourceImage);
+  const image = (0, import_sharp3.default)(sourceImage);
   const metadata = await image.metadata();
   if (!metadata.width || !metadata.height) {
     throw new Error("Unable to read image dimensions");
   }
-  for (const size of iconSizes) {
-    const outputPath = (0, import_path8.join)(outputDir, size.name);
-    try {
-      let pipeline = image.clone().resize(size.width, size.height, {
-        fit: "cover",
-        position: "center"
-      });
-      if (format === "png") {
-        pipeline = pipeline.png({ quality, compressionLevel: 9 });
-      } else {
-        pipeline = pipeline.webp({ quality });
+  const iconResults = await Promise.all(
+    iconSizes.map(async (size) => {
+      const outputPath = (0, import_path8.join)(outputDir, size.name);
+      try {
+        let pipeline = image.clone().resize(size.width, size.height, {
+          fit: "cover",
+          position: "center"
+        });
+        if (format === "png") {
+          pipeline = pipeline.png({ quality, compressionLevel: 9 });
+        } else {
+          pipeline = pipeline.webp({ quality });
+        }
+        await pipeline.toFile(outputPath);
+        return {
+          success: true,
+          file: outputPath,
+          icon: {
+            src: `/${size.name}`,
+            sizes: `${size.width}x${size.height}`,
+            type: format === "png" ? "image/png" : "image/webp",
+            purpose: size.width >= 192 && size.width <= 512 ? "any" : void 0
+          }
+        };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+          success: false,
+          error: `Failed to generate icon ${size.name}: ${message}`,
+          size: size.name
+        };
       }
-      await pipeline.toFile(outputPath);
-      generatedFiles.push(outputPath);
-      icons.push({
-        src: `/${size.name}`,
-        sizes: `${size.width}x${size.height}`,
-        type: format === "png" ? "image/png" : "image/webp",
-        purpose: size.width >= 192 && size.width <= 512 ? "any" : void 0
-      });
-    } catch (err) {
-      const message = err instanceof Error ? err.message : String(err);
-      throw new Error(`Failed to generate icon ${size.name}: ${message}`);
+    })
+  );
+  for (const result of iconResults) {
+    if (result.success) {
+      generatedFiles.push(result.file);
+      icons.push(result.icon);
+    } else {
+      throw new Error(result.error);
     }
   }
-  for (const size of splashSizes) {
-    const outputPath = (0, import_path8.join)(outputDir, size.name);
-    try {
-      let pipeline = image.clone().resize(size.width, size.height, {
-        fit: "cover",
-        position: "center"
-      });
-      if (format === "png") {
-        pipeline = pipeline.png({ quality, compressionLevel: 9 });
-      } else {
-        pipeline = pipeline.webp({ quality });
+  const splashResults = await Promise.all(
+    splashSizes.map(async (size) => {
+      const outputPath = (0, import_path8.join)(outputDir, size.name);
+      try {
+        let pipeline = image.clone().resize(size.width, size.height, {
+          fit: "cover",
+          position: "center"
+        });
+        if (format === "png") {
+          pipeline = pipeline.png({ quality, compressionLevel: 9 });
+        } else {
+          pipeline = pipeline.webp({ quality });
+        }
+        await pipeline.toFile(outputPath);
+        return {
+          success: true,
+          file: outputPath,
+          splash: {
+            src: `/${size.name}`,
+            sizes: `${size.width}x${size.height}`,
+            type: format === "png" ? "image/png" : "image/webp"
+          }
+        };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+          success: false,
+          error: `Failed to generate splash screen ${size.name}: ${message}`,
+          size: size.name
+        };
       }
-      await pipeline.toFile(outputPath);
-      generatedFiles.push(outputPath);
-      splashScreens.push({
-        src: `/${size.name}`,
-        sizes: `${size.width}x${size.height}`,
-        type: format === "png" ? "image/png" : "image/webp"
-      });
-    } catch (err) {
-      const message = err instanceof Error ? err.message : String(err);
-      throw new Error(`Failed to generate splash screen ${size.name}: ${message}`);
+    })
+  );
+  for (const result of splashResults) {
+    if (result.success) {
+      generatedFiles.push(result.file);
+      splashScreens.push(result.splash);
+    } else {
+      throw new Error(result.error);
     }
   }
   if (format === "png") {
@@ -1929,7 +2087,8 @@ async function generateIcons(options) {
   return {
     icons,
     splashScreens,
-    generatedFiles
+    generatedFiles,
+    validation
   };
 }
 async function generateIconsOnly(options) {
@@ -1953,13 +2112,13 @@ async function generateSplashScreensOnly(options) {
   };
 }
 async function generateFavicon(sourceImage, outputDir) {
-  if (!(0, import_fs8.existsSync)(sourceImage)) {
+  if (!(0, import_fs9.existsSync)(sourceImage)) {
     throw new Error(`Source image not found: ${sourceImage}`);
   }
-  (0, import_fs8.mkdirSync)(outputDir, { recursive: true });
+  (0, import_fs9.mkdirSync)(outputDir, { recursive: true });
   const faviconPath = (0, import_path8.join)(outputDir, "favicon.ico");
   try {
-    await (0, import_sharp2.default)(sourceImage).resize(32, 32, {
+    await (0, import_sharp3.default)(sourceImage).resize(32, 32, {
       fit: "cover",
       position: "center"
     }).png().toFile(faviconPath);
@@ -1970,13 +2129,13 @@ async function generateFavicon(sourceImage, outputDir) {
   }
 }
 async function generateAppleTouchIcon(sourceImage, outputDir) {
-  if (!(0, import_fs8.existsSync)(sourceImage)) {
+  if (!(0, import_fs9.existsSync)(sourceImage)) {
     throw new Error(`Source image not found: ${sourceImage}`);
   }
-  (0, import_fs8.mkdirSync)(outputDir, { recursive: true });
+  (0, import_fs9.mkdirSync)(outputDir, { recursive: true });
   const appleIconPath = (0, import_path8.join)(outputDir, "apple-touch-icon.png");
   try {
-    await (0, import_sharp2.default)(sourceImage).resize(180, 180, {
+    await (0, import_sharp3.default)(sourceImage).resize(180, 180, {
       fit: "cover",
       position: "center"
     }).png({ quality: 90, compressionLevel: 9 }).toFile(appleIconPath);
@@ -1989,7 +2148,7 @@ async function generateAppleTouchIcon(sourceImage, outputDir) {
 
 // src/generator/service-worker-generator.ts
 var import_workbox_build = require("workbox-build");
-var import_fs9 = require("fs");
+var import_fs10 = require("fs");
 var import_path9 = require("path");
 var import_universal_pwa_templates = require("@julien-lin/universal-pwa-templates");
 async function generateServiceWorker(options) {
@@ -2004,11 +2163,11 @@ async function generateServiceWorker(options) {
     swDest = "sw.js",
     offlinePage
   } = options;
-  (0, import_fs9.mkdirSync)(outputDir, { recursive: true });
+  (0, import_fs10.mkdirSync)(outputDir, { recursive: true });
   const finalTemplateType = templateType ?? (0, import_universal_pwa_templates.determineTemplateType)(architecture, framework ?? null);
   const template = (0, import_universal_pwa_templates.getServiceWorkerTemplate)(finalTemplateType);
   const swSrcPath = (0, import_path9.join)(outputDir, "sw-src.js");
-  (0, import_fs9.writeFileSync)(swSrcPath, template.content, "utf-8");
+  (0, import_fs10.writeFileSync)(swSrcPath, template.content, "utf-8");
   const swDestPath = (0, import_path9.join)(outputDir, swDest);
   const workboxConfig = {
     globDirectory: globDirectory ?? projectPath,
@@ -2024,7 +2183,7 @@ async function generateServiceWorker(options) {
   try {
     const result = await (0, import_workbox_build.injectManifest)(workboxConfig);
     try {
-      if ((0, import_fs9.existsSync)(swSrcPath)) {
+      if ((0, import_fs10.existsSync)(swSrcPath)) {
       }
     } catch {
     }
@@ -2054,7 +2213,7 @@ async function generateSimpleServiceWorker(options) {
     clientsClaim = true,
     runtimeCaching
   } = options;
-  (0, import_fs9.mkdirSync)(outputDir, { recursive: true });
+  (0, import_fs10.mkdirSync)(outputDir, { recursive: true });
   const swDestPath = (0, import_path9.join)(outputDir, swDest);
   const workboxConfig = {
     globDirectory: globDirectory ?? projectPath,
@@ -2109,7 +2268,7 @@ async function generateAndWriteServiceWorker(options) {
 }
 
 // src/generator/https-checker.ts
-var import_fs10 = require("fs");
+var import_fs11 = require("fs");
 var import_path10 = require("path");
 function checkHttps(url, allowHttpLocalhost = true) {
   let parsedUrl;
@@ -2166,29 +2325,29 @@ function detectProjectUrl(projectPath) {
   ];
   for (const config of configFiles) {
     const filePath = (0, import_path10.join)(projectPath, config.file);
-    if ((0, import_fs10.existsSync)(filePath)) {
+    if ((0, import_fs11.existsSync)(filePath)) {
       try {
         if (config.file.endsWith(".json") && config.key) {
-          const parsed = JSON.parse((0, import_fs10.readFileSync)(filePath, "utf-8"));
+          const parsed = JSON.parse((0, import_fs11.readFileSync)(filePath, "utf-8"));
           const content = parsed;
           const value = content[config.key];
           if (value && typeof value === "string") {
             return value;
           }
         } else if (config.file.endsWith(".toml") && config.pattern) {
-          const content = (0, import_fs10.readFileSync)(filePath, "utf-8");
+          const content = (0, import_fs11.readFileSync)(filePath, "utf-8");
           const match = config.pattern ? content.match(config.pattern) : null;
           if (match && match[1]) {
             return match[1];
           }
         } else if ((config.file.endsWith(".js") || config.file.endsWith(".ts")) && config.pattern) {
-          const content = (0, import_fs10.readFileSync)(filePath, "utf-8");
+          const content = (0, import_fs11.readFileSync)(filePath, "utf-8");
           const match = config.pattern ? content.match(config.pattern) : null;
           if (match && match[1]) {
             return match[1];
           }
         } else if (config.file.startsWith(".env") && config.pattern) {
-          const content = (0, import_fs10.readFileSync)(filePath, "utf-8");
+          const content = (0, import_fs11.readFileSync)(filePath, "utf-8");
           const lines = content.split("\n");
           for (const line of lines) {
             const match = config.pattern ? line.match(config.pattern) : null;
@@ -2227,9 +2386,9 @@ function checkProjectHttps(options = {}) {
 
 // src/injector/html-parser.ts
 var import_htmlparser2 = require("htmlparser2");
-var import_fs11 = require("fs");
+var import_fs12 = require("fs");
 function parseHTMLFile(filePath, options = {}) {
-  const content = (0, import_fs11.readFileSync)(filePath, "utf-8");
+  const content = (0, import_fs12.readFileSync)(filePath, "utf-8");
   return parseHTML(content, options);
 }
 function parseHTML(htmlContent, options = {}) {
@@ -2363,7 +2522,7 @@ function serializeHTML(parsed) {
 }
 
 // src/injector/meta-injector.ts
-var import_fs12 = require("fs");
+var import_fs13 = require("fs");
 var import_dom_serializer = require("dom-serializer");
 function injectMetaTags(htmlContent, options = {}) {
   const parsed = parseHTML(htmlContent);
@@ -2732,18 +2891,61 @@ function escapeJavaScriptString(str) {
 function injectMetaTagsInFile(filePath, options = {}) {
   const parsed = parseHTMLFile(filePath);
   const { html, result } = injectMetaTags(parsed.originalContent, options);
-  (0, import_fs12.writeFileSync)(filePath, html, "utf-8");
+  (0, import_fs13.writeFileSync)(filePath, html, "utf-8");
   return result;
 }
+async function injectMetaTagsInFilesBatch(batchOptions) {
+  const { files, options, concurrency = 5, continueOnError = true } = batchOptions;
+  const successful = [];
+  const failed = [];
+  const processBatch = async (batch) => {
+    const results = await Promise.allSettled(
+      batch.map((file) => {
+        try {
+          const result = injectMetaTagsInFile(file, options);
+          return Promise.resolve({ file, result, success: true });
+        } catch (err) {
+          const message = err instanceof Error ? err.message : String(err);
+          if (!continueOnError) {
+            return Promise.reject(new Error(`Failed to inject meta tags in ${file}: ${message}`));
+          }
+          return Promise.resolve({ file, error: message, success: false });
+        }
+      })
+    );
+    for (const result of results) {
+      if (result.status === "fulfilled") {
+        if (result.value.success) {
+          successful.push({ file: result.value.file, result: result.value.result });
+        } else {
+          failed.push({ file: result.value.file, error: result.value.error });
+        }
+      } else {
+        const errorMessage = result.reason instanceof Error ? result.reason.message : String(result.reason);
+        failed.push({ file: "unknown", error: errorMessage });
+      }
+    }
+  };
+  for (let i = 0; i < files.length; i += concurrency) {
+    const batch = files.slice(i, i + concurrency);
+    await processBatch(batch);
+  }
+  return {
+    successful,
+    failed,
+    totalProcessed: successful.length,
+    totalFailed: failed.length
+  };
+}
 
 // src/validator/pwa-validator.ts
-var import_fs13 = require("fs");
+var import_fs14 = require("fs");
 var import_path11 = require("path");
 var import_promises = require("fs/promises");
 function validateManifest(projectPath, outputDir) {
   const errors = [];
   const manifestPath = (0, import_path11.join)(outputDir, "manifest.json");
-  if (!(0, import_fs13.existsSync)(manifestPath)) {
+  if (!(0, import_fs14.existsSync)(manifestPath)) {
     return {
       exists: false,
       valid: false,
@@ -2759,7 +2961,7 @@ function validateManifest(projectPath, outputDir) {
     };
   }
   try {
-    const manifestContent = (0, import_fs13.readFileSync)(manifestPath, "utf-8");
+    const manifestContent = (0, import_fs14.readFileSync)(manifestPath, "utf-8");
     const manifest = JSON.parse(manifestContent);
     if (!manifest.name || manifest.name.trim().length === 0) {
       errors.push({
@@ -2873,7 +3075,7 @@ function validateIcons(projectPath, outputDir, manifest) {
   for (const icon of manifest.icons) {
     const iconPath = icon.src.startsWith("/") ? icon.src.substring(1) : icon.src;
     const fullIconPath = (0, import_path11.join)(outputDir, iconPath);
-    if (!(0, import_fs13.existsSync)(fullIconPath)) {
+    if (!(0, import_fs14.existsSync)(fullIconPath)) {
       errors.push({
         code: "ICON_FILE_MISSING",
         message: `Icon file not found: ${iconPath}`,
@@ -2917,7 +3119,7 @@ function validateIcons(projectPath, outputDir, manifest) {
 function validateServiceWorker(projectPath, outputDir) {
   const errors = [];
   const swPath = (0, import_path11.join)(outputDir, "sw.js");
-  if (!(0, import_fs13.existsSync)(swPath)) {
+  if (!(0, import_fs14.existsSync)(swPath)) {
     return {
       exists: false,
       valid: false,
@@ -2933,7 +3135,7 @@ function validateServiceWorker(projectPath, outputDir) {
     };
   }
   try {
-    const swContent = (0, import_fs13.readFileSync)(swPath, "utf-8");
+    const swContent = (0, import_fs14.readFileSync)(swPath, "utf-8");
     if (!swContent.includes("workbox") && !swContent.includes("serviceWorker")) {
       errors.push({
         code: "SERVICE_WORKER_INVALID",
@@ -3196,6 +3398,7 @@ async function validatePWA(options) {
   generateSplashScreensOnly,
   injectMetaTags,
   injectMetaTagsInFile,
+  injectMetaTagsInFilesBatch,
   optimizeImage,
   optimizeProject,
   optimizeProjectImages,

package/dist/index.d.cts

@@ -253,6 +253,19 @@ declare function writeManifest(manifest: Manifest, outputDir: string): string;
  */
 declare function generateAndWriteManifest(options: ManifestGeneratorOptions, outputDir: string): string;
 
+interface IconValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+    suggestions: string[];
+    metadata?: {
+        width: number;
+        height: number;
+        format: string;
+        size: number;
+    };
+}
+
 interface IconSize {
     width: number;
     height: number;
@@ -272,11 +285,14 @@ interface IconGeneratorOptions {
     splashSizes?: SplashScreenSize[];
     format?: 'png' | 'webp';
     quality?: number;
+    validate?: boolean;
+    strictValidation?: boolean;
 }
 interface IconGenerationResult {
     icons: ManifestIcon[];
     splashScreens: ManifestSplashScreen[];
     generatedFiles: string[];
+    validation?: IconValidationResult;
 }
 /**
  * Generates all PWA icons from a source image
@@ -448,6 +464,35 @@ declare function injectMetaTags(htmlContent: string, options?: MetaInjectorOptio
  * Injects meta-tags into an HTML file
  */
 declare function injectMetaTagsInFile(filePath: string, options?: MetaInjectorOptions): InjectionResult;
+/**
+ * Batch process options for parallel HTML injection
+ */
+interface BatchInjectOptions {
+    files: string[];
+    options: MetaInjectorOptions;
+    concurrency?: number;
+    continueOnError?: boolean;
+}
+/**
+ * Result of batch injection
+ */
+interface BatchInjectResult {
+    successful: Array<{
+        file: string;
+        result: InjectionResult;
+    }>;
+    failed: Array<{
+        file: string;
+        error: string;
+    }>;
+    totalProcessed: number;
+    totalFailed: number;
+}
+/**
+ * Injects PWA meta-tags into multiple HTML files in parallel with concurrency limit
+ * This significantly improves performance when processing many files
+ */
+declare function injectMetaTagsInFilesBatch(batchOptions: BatchInjectOptions): Promise<BatchInjectResult>;
 
 interface ValidationError {
     code: string;
@@ -509,4 +554,4 @@ interface PWAValidatorOptions {
  */
 declare function validatePWA(options: PWAValidatorOptions): Promise<ValidationResult>;
 
-export { type AdaptiveCacheStrategy, type ApiType, type Architecture, type ArchitectureDetectionResult, type AssetDetectionResult, type AssetOptimizationSuggestion, type BuildTool, type CacheStrategy, type Framework, type FrameworkDetectionResult, type FrameworkVersion, type HTMLParserOptions, type HttpsCheckResult, type HttpsCheckerOptions, type IconGenerationResult, type IconGeneratorOptions, type IconSize, type ImageOptimizationOptions, type InjectionResult, type Manifest, type ManifestGeneratorOptions, type ManifestIcon, ManifestSchema, type ManifestSplashScreen, type MetaInjectorOptions, type OptimizationResult, type OptimizedImageResult, type OptimizedManifestConfig, type PWAValidatorOptions, type ParsedHTML, type ProjectConfiguration, STANDARD_ICON_SIZES, STANDARD_SPLASH_SIZES, type ScannerOptions, type ScannerResult, type ServiceWorkerGenerationResult, type ServiceWorkerGeneratorOptions, type SplashScreenSize, type ValidationError, type ValidationResult, type ValidationWarning, checkHttps, checkProjectHttps, detectApiType, detectArchitecture, detectAssets, detectFramework, detectProjectUrl, detectUnoptimizedImages, elementExists, findAllElements, findElement, generateAdaptiveCacheStrategies, generateAndWriteManifest, generateAndWriteServiceWorker, generateAppleTouchIcon, generateFavicon, generateIcons, generateIconsOnly, generateManifest, generateOptimalShortName, generateReport, generateResponsiveImageSizes, generateServiceWorker, generateSimpleServiceWorker, generateSplashScreensOnly, injectMetaTags, injectMetaTagsInFile, optimizeImage, optimizeProject, optimizeProjectImages, parseHTML, parseHTMLFile, scanProject, serializeHTML, suggestManifestColors, validatePWA, validateProjectPath, writeManifest };
+export { type AdaptiveCacheStrategy, type ApiType, type Architecture, type ArchitectureDetectionResult, type AssetDetectionResult, type AssetOptimizationSuggestion, type BatchInjectOptions, type BatchInjectResult, type BuildTool, type CacheStrategy, type Framework, type FrameworkDetectionResult, type FrameworkVersion, type HTMLParserOptions, type HttpsCheckResult, type HttpsCheckerOptions, type IconGenerationResult, type IconGeneratorOptions, type IconSize, type ImageOptimizationOptions, type InjectionResult, type Manifest, type ManifestGeneratorOptions, type ManifestIcon, ManifestSchema, type ManifestSplashScreen, type MetaInjectorOptions, type OptimizationResult, type OptimizedImageResult, type OptimizedManifestConfig, type PWAValidatorOptions, type ParsedHTML, type ProjectConfiguration, STANDARD_ICON_SIZES, STANDARD_SPLASH_SIZES, type ScannerOptions, type ScannerResult, type ServiceWorkerGenerationResult, type ServiceWorkerGeneratorOptions, type SplashScreenSize, type ValidationError, type ValidationResult, type ValidationWarning, checkHttps, checkProjectHttps, detectApiType, detectArchitecture, detectAssets, detectFramework, detectProjectUrl, detectUnoptimizedImages, elementExists, findAllElements, findElement, generateAdaptiveCacheStrategies, generateAndWriteManifest, generateAndWriteServiceWorker, generateAppleTouchIcon, generateFavicon, generateIcons, generateIconsOnly, generateManifest, generateOptimalShortName, generateReport, generateResponsiveImageSizes, generateServiceWorker, generateSimpleServiceWorker, generateSplashScreensOnly, injectMetaTags, injectMetaTagsInFile, injectMetaTagsInFilesBatch, optimizeImage, optimizeProject, optimizeProjectImages, parseHTML, parseHTMLFile, scanProject, serializeHTML, suggestManifestColors, validatePWA, validateProjectPath, writeManifest };

package/dist/index.d.ts

@@ -253,6 +253,19 @@ declare function writeManifest(manifest: Manifest, outputDir: string): string;
  */
 declare function generateAndWriteManifest(options: ManifestGeneratorOptions, outputDir: string): string;
 
+interface IconValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+    suggestions: string[];
+    metadata?: {
+        width: number;
+        height: number;
+        format: string;
+        size: number;
+    };
+}
+
 interface IconSize {
     width: number;
     height: number;
@@ -272,11 +285,14 @@ interface IconGeneratorOptions {
     splashSizes?: SplashScreenSize[];
     format?: 'png' | 'webp';
     quality?: number;
+    validate?: boolean;
+    strictValidation?: boolean;
 }
 interface IconGenerationResult {
     icons: ManifestIcon[];
     splashScreens: ManifestSplashScreen[];
     generatedFiles: string[];
+    validation?: IconValidationResult;
 }
 /**
  * Generates all PWA icons from a source image
@@ -448,6 +464,35 @@ declare function injectMetaTags(htmlContent: string, options?: MetaInjectorOptio
  * Injects meta-tags into an HTML file
  */
 declare function injectMetaTagsInFile(filePath: string, options?: MetaInjectorOptions): InjectionResult;
+/**
+ * Batch process options for parallel HTML injection
+ */
+interface BatchInjectOptions {
+    files: string[];
+    options: MetaInjectorOptions;
+    concurrency?: number;
+    continueOnError?: boolean;
+}
+/**
+ * Result of batch injection
+ */
+interface BatchInjectResult {
+    successful: Array<{
+        file: string;
+        result: InjectionResult;
+    }>;
+    failed: Array<{
+        file: string;
+        error: string;
+    }>;
+    totalProcessed: number;
+    totalFailed: number;
+}
+/**
+ * Injects PWA meta-tags into multiple HTML files in parallel with concurrency limit
+ * This significantly improves performance when processing many files
+ */
+declare function injectMetaTagsInFilesBatch(batchOptions: BatchInjectOptions): Promise<BatchInjectResult>;
 
 interface ValidationError {
     code: string;
@@ -509,4 +554,4 @@ interface PWAValidatorOptions {
  */
 declare function validatePWA(options: PWAValidatorOptions): Promise<ValidationResult>;
 
-export { type AdaptiveCacheStrategy, type ApiType, type Architecture, type ArchitectureDetectionResult, type AssetDetectionResult, type AssetOptimizationSuggestion, type BuildTool, type CacheStrategy, type Framework, type FrameworkDetectionResult, type FrameworkVersion, type HTMLParserOptions, type HttpsCheckResult, type HttpsCheckerOptions, type IconGenerationResult, type IconGeneratorOptions, type IconSize, type ImageOptimizationOptions, type InjectionResult, type Manifest, type ManifestGeneratorOptions, type ManifestIcon, ManifestSchema, type ManifestSplashScreen, type MetaInjectorOptions, type OptimizationResult, type OptimizedImageResult, type OptimizedManifestConfig, type PWAValidatorOptions, type ParsedHTML, type ProjectConfiguration, STANDARD_ICON_SIZES, STANDARD_SPLASH_SIZES, type ScannerOptions, type ScannerResult, type ServiceWorkerGenerationResult, type ServiceWorkerGeneratorOptions, type SplashScreenSize, type ValidationError, type ValidationResult, type ValidationWarning, checkHttps, checkProjectHttps, detectApiType, detectArchitecture, detectAssets, detectFramework, detectProjectUrl, detectUnoptimizedImages, elementExists, findAllElements, findElement, generateAdaptiveCacheStrategies, generateAndWriteManifest, generateAndWriteServiceWorker, generateAppleTouchIcon, generateFavicon, generateIcons, generateIconsOnly, generateManifest, generateOptimalShortName, generateReport, generateResponsiveImageSizes, generateServiceWorker, generateSimpleServiceWorker, generateSplashScreensOnly, injectMetaTags, injectMetaTagsInFile, optimizeImage, optimizeProject, optimizeProjectImages, parseHTML, parseHTMLFile, scanProject, serializeHTML, suggestManifestColors, validatePWA, validateProjectPath, writeManifest };
+export { type AdaptiveCacheStrategy, type ApiType, type Architecture, type ArchitectureDetectionResult, type AssetDetectionResult, type AssetOptimizationSuggestion, type BatchInjectOptions, type BatchInjectResult, type BuildTool, type CacheStrategy, type Framework, type FrameworkDetectionResult, type FrameworkVersion, type HTMLParserOptions, type HttpsCheckResult, type HttpsCheckerOptions, type IconGenerationResult, type IconGeneratorOptions, type IconSize, type ImageOptimizationOptions, type InjectionResult, type Manifest, type ManifestGeneratorOptions, type ManifestIcon, ManifestSchema, type ManifestSplashScreen, type MetaInjectorOptions, type OptimizationResult, type OptimizedImageResult, type OptimizedManifestConfig, type PWAValidatorOptions, type ParsedHTML, type ProjectConfiguration, STANDARD_ICON_SIZES, STANDARD_SPLASH_SIZES, type ScannerOptions, type ScannerResult, type ServiceWorkerGenerationResult, type ServiceWorkerGeneratorOptions, type SplashScreenSize, type ValidationError, type ValidationResult, type ValidationWarning, checkHttps, checkProjectHttps, detectApiType, detectArchitecture, detectAssets, detectFramework, detectProjectUrl, detectUnoptimizedImages, elementExists, findAllElements, findElement, generateAdaptiveCacheStrategies, generateAndWriteManifest, generateAndWriteServiceWorker, generateAppleTouchIcon, generateFavicon, generateIcons, generateIconsOnly, generateManifest, generateOptimalShortName, generateReport, generateResponsiveImageSizes, generateServiceWorker, generateSimpleServiceWorker, generateSplashScreensOnly, injectMetaTags, injectMetaTagsInFile, injectMetaTagsInFilesBatch, optimizeImage, optimizeProject, optimizeProjectImages, parseHTML, parseHTMLFile, scanProject, serializeHTML, suggestManifestColors, validatePWA, validateProjectPath, writeManifest };

package/dist/index.js

@@ -1570,9 +1570,11 @@ async function scanProject(options) {
       buildTool: null
     }
   };
-  const assetsCandidate = includeAssets ? await detectAssets(projectPath) : getEmptyAssets();
+  const [assetsCandidate, architectureCandidate] = await Promise.all([
+    includeAssets ? detectAssets(projectPath) : Promise.resolve(getEmptyAssets()),
+    includeArchitecture ? detectArchitecture(projectPath) : Promise.resolve(getEmptyArchitecture())
+  ]);
   const assets = isAssetDetectionResult(assetsCandidate) ? assetsCandidate : getEmptyAssets();
-  const architectureCandidate = includeArchitecture ? await detectArchitecture(projectPath) : getEmptyArchitecture();
   const architecture = isArchitectureDetectionResult(architectureCandidate) ? architectureCandidate : getEmptyArchitecture();
   const result = {
     framework,
@@ -1738,9 +1740,117 @@ function generateAndWriteManifest(options, outputDir) {
 }
 
 // src/generator/icon-generator.ts
-import sharp2 from "sharp";
-import { existsSync as existsSync6, mkdirSync as mkdirSync2 } from "fs";
+import sharp3 from "sharp";
+import { existsSync as existsSync7, mkdirSync as mkdirSync2 } from "fs";
 import { join as join8 } from "path";
+
+// src/validator/icon-validator.ts
+import sharp2 from "sharp";
+import { existsSync as existsSync6 } from "fs";
+async function validateIconSource(options) {
+  const {
+    sourceImage,
+    strict = false,
+    minRecommendedSize = 192,
+    optimalSize = 512
+  } = options;
+  const result = {
+    valid: true,
+    errors: [],
+    warnings: [],
+    suggestions: []
+  };
+  if (!existsSync6(sourceImage)) {
+    result.valid = false;
+    result.errors.push(`Source image not found: ${sourceImage}`);
+    return result;
+  }
+  try {
+    const image = sharp2(sourceImage);
+    const metadata = await image.metadata();
+    if (!metadata.width || !metadata.height) {
+      result.valid = false;
+      result.errors.push("Unable to read image dimensions");
+      return result;
+    }
+    const { width, height, format, size } = metadata;
+    const minDimension = Math.min(width, height);
+    const maxDimension = Math.max(width, height);
+    const isSquare = width === height;
+    result.metadata = {
+      width,
+      height,
+      format: format || "unknown",
+      size: size || 0
+    };
+    const supportedFormats = ["png", "jpeg", "jpg", "webp", "svg"];
+    if (!format || !supportedFormats.includes(format.toLowerCase())) {
+      result.valid = false;
+      result.errors.push(
+        `Unsupported image format: ${format || "unknown"}. Supported formats: ${supportedFormats.join(", ")}`
+      );
+    }
+    if (minDimension < minRecommendedSize) {
+      const message = `Icon dimensions too small: ${width}x${height}. Minimum recommended: ${minRecommendedSize}x${minRecommendedSize}`;
+      if (strict) {
+        result.valid = false;
+        result.errors.push(message);
+      } else {
+        result.warnings.push(message);
+        result.suggestions.push(
+          `Use an image at least ${minRecommendedSize}x${minRecommendedSize} pixels for best PWA compatibility`
+        );
+      }
+    }
+    if (minDimension < optimalSize) {
+      result.warnings.push(
+        `Icon dimensions below optimal size: ${width}x${height}. Optimal size: ${optimalSize}x${optimalSize} for best quality on all devices`
+      );
+      result.suggestions.push(
+        `Consider using a ${optimalSize}x${optimalSize} source image for optimal icon quality`
+      );
+    }
+    if (!isSquare) {
+      result.warnings.push(
+        `Icon is not square (${width}x${height}). Square images work best for PWA icons`
+      );
+      result.suggestions.push(
+        "Consider using a square source image. The icon will be cropped to fit during generation"
+      );
+    }
+    if (format?.toLowerCase() === "jpg" || format?.toLowerCase() === "jpeg") {
+      result.suggestions.push(
+        "PNG format is recommended for icons with transparency. Consider converting JPG to PNG"
+      );
+    }
+    if (size && size > 1024 * 1024) {
+      const sizeMB = (size / (1024 * 1024)).toFixed(2);
+      result.warnings.push(`Icon file size is large: ${sizeMB}MB. This may slow down generation`);
+      result.suggestions.push(
+        "Consider optimizing the source image before generation to reduce file size"
+      );
+    } else if (size && size > 500 * 1024) {
+      const sizeKB = (size / 1024).toFixed(2);
+      result.suggestions.push(
+        `Icon file size is ${sizeKB}KB. Consider optimizing to reduce generation time`
+      );
+    }
+    const aspectRatio = maxDimension / minDimension;
+    if (aspectRatio > 2) {
+      result.warnings.push(
+        `Icon has extreme aspect ratio (${aspectRatio.toFixed(2)}:1). Square images are recommended`
+      );
+    }
+    return result;
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    result.valid = false;
+    result.errors.push(`Failed to validate icon: ${message}`);
+    return result;
+  }
+}
+
+// src/generator/icon-generator.ts
 var STANDARD_ICON_SIZES = [
   { width: 72, height: 72, name: "icon-72x72.png" },
   { width: 96, height: 96, name: "icon-96x96.png" },
@@ -1774,67 +1884,114 @@ async function generateIcons(options) {
     iconSizes = STANDARD_ICON_SIZES,
     splashSizes = STANDARD_SPLASH_SIZES,
     format = "png",
-    quality = 90
+    quality = 90,
+    validate = false,
+    strictValidation = false
   } = options;
-  if (!existsSync6(sourceImage)) {
+  if (!existsSync7(sourceImage)) {
     throw new Error(`Source image not found: ${sourceImage}`);
   }
+  let validation;
+  if (validate) {
+    validation = await validateIconSource({
+      sourceImage,
+      strict: strictValidation
+    });
+    if (strictValidation && !validation.valid) {
+      const errorMessages = validation.errors.join("; ");
+      throw new Error(`Icon validation failed: ${errorMessages}`);
+    }
+  }
   mkdirSync2(outputDir, { recursive: true });
   const generatedFiles = [];
   const icons = [];
   const splashScreens = [];
-  const image = sharp2(sourceImage);
+  const image = sharp3(sourceImage);
   const metadata = await image.metadata();
   if (!metadata.width || !metadata.height) {
     throw new Error("Unable to read image dimensions");
   }
-  for (const size of iconSizes) {
-    const outputPath = join8(outputDir, size.name);
-    try {
-      let pipeline = image.clone().resize(size.width, size.height, {
-        fit: "cover",
-        position: "center"
-      });
-      if (format === "png") {
-        pipeline = pipeline.png({ quality, compressionLevel: 9 });
-      } else {
-        pipeline = pipeline.webp({ quality });
+  const iconResults = await Promise.all(
+    iconSizes.map(async (size) => {
+      const outputPath = join8(outputDir, size.name);
+      try {
+        let pipeline = image.clone().resize(size.width, size.height, {
+          fit: "cover",
+          position: "center"
+        });
+        if (format === "png") {
+          pipeline = pipeline.png({ quality, compressionLevel: 9 });
+        } else {
+          pipeline = pipeline.webp({ quality });
+        }
+        await pipeline.toFile(outputPath);
+        return {
+          success: true,
+          file: outputPath,
+          icon: {
+            src: `/${size.name}`,
+            sizes: `${size.width}x${size.height}`,
+            type: format === "png" ? "image/png" : "image/webp",
+            purpose: size.width >= 192 && size.width <= 512 ? "any" : void 0
+          }
+        };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+          success: false,
+          error: `Failed to generate icon ${size.name}: ${message}`,
+          size: size.name
+        };
       }
-      await pipeline.toFile(outputPath);
-      generatedFiles.push(outputPath);
-      icons.push({
-        src: `/${size.name}`,
-        sizes: `${size.width}x${size.height}`,
-        type: format === "png" ? "image/png" : "image/webp",
-        purpose: size.width >= 192 && size.width <= 512 ? "any" : void 0
-      });
-    } catch (err) {
-      const message = err instanceof Error ? err.message : String(err);
-      throw new Error(`Failed to generate icon ${size.name}: ${message}`);
+    })
+  );
+  for (const result of iconResults) {
+    if (result.success) {
+      generatedFiles.push(result.file);
+      icons.push(result.icon);
+    } else {
+      throw new Error(result.error);
     }
   }
-  for (const size of splashSizes) {
-    const outputPath = join8(outputDir, size.name);
-    try {
-      let pipeline = image.clone().resize(size.width, size.height, {
-        fit: "cover",
-        position: "center"
-      });
-      if (format === "png") {
-        pipeline = pipeline.png({ quality, compressionLevel: 9 });
-      } else {
-        pipeline = pipeline.webp({ quality });
+  const splashResults = await Promise.all(
+    splashSizes.map(async (size) => {
+      const outputPath = join8(outputDir, size.name);
+      try {
+        let pipeline = image.clone().resize(size.width, size.height, {
+          fit: "cover",
+          position: "center"
+        });
+        if (format === "png") {
+          pipeline = pipeline.png({ quality, compressionLevel: 9 });
+        } else {
+          pipeline = pipeline.webp({ quality });
+        }
+        await pipeline.toFile(outputPath);
+        return {
+          success: true,
+          file: outputPath,
+          splash: {
+            src: `/${size.name}`,
+            sizes: `${size.width}x${size.height}`,
+            type: format === "png" ? "image/png" : "image/webp"
+          }
+        };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+          success: false,
+          error: `Failed to generate splash screen ${size.name}: ${message}`,
+          size: size.name
+        };
       }
-      await pipeline.toFile(outputPath);
-      generatedFiles.push(outputPath);
-      splashScreens.push({
-        src: `/${size.name}`,
-        sizes: `${size.width}x${size.height}`,
-        type: format === "png" ? "image/png" : "image/webp"
-      });
-    } catch (err) {
-      const message = err instanceof Error ? err.message : String(err);
-      throw new Error(`Failed to generate splash screen ${size.name}: ${message}`);
+    })
+  );
+  for (const result of splashResults) {
+    if (result.success) {
+      generatedFiles.push(result.file);
+      splashScreens.push(result.splash);
+    } else {
+      throw new Error(result.error);
     }
   }
   if (format === "png") {
@@ -1853,7 +2010,8 @@ async function generateIcons(options) {
   return {
     icons,
     splashScreens,
-    generatedFiles
+    generatedFiles,
+    validation
   };
 }
 async function generateIconsOnly(options) {
@@ -1877,13 +2035,13 @@ async function generateSplashScreensOnly(options) {
   };
 }
 async function generateFavicon(sourceImage, outputDir) {
-  if (!existsSync6(sourceImage)) {
+  if (!existsSync7(sourceImage)) {
     throw new Error(`Source image not found: ${sourceImage}`);
   }
   mkdirSync2(outputDir, { recursive: true });
   const faviconPath = join8(outputDir, "favicon.ico");
   try {
-    await sharp2(sourceImage).resize(32, 32, {
+    await sharp3(sourceImage).resize(32, 32, {
       fit: "cover",
       position: "center"
     }).png().toFile(faviconPath);
@@ -1894,13 +2052,13 @@ async function generateFavicon(sourceImage, outputDir) {
   }
 }
 async function generateAppleTouchIcon(sourceImage, outputDir) {
-  if (!existsSync6(sourceImage)) {
+  if (!existsSync7(sourceImage)) {
     throw new Error(`Source image not found: ${sourceImage}`);
   }
   mkdirSync2(outputDir, { recursive: true });
   const appleIconPath = join8(outputDir, "apple-touch-icon.png");
   try {
-    await sharp2(sourceImage).resize(180, 180, {
+    await sharp3(sourceImage).resize(180, 180, {
       fit: "cover",
       position: "center"
     }).png({ quality: 90, compressionLevel: 9 }).toFile(appleIconPath);
@@ -1913,7 +2071,7 @@ async function generateAppleTouchIcon(sourceImage, outputDir) {
 
 // src/generator/service-worker-generator.ts
 import { injectManifest, generateSW } from "workbox-build";
-import { writeFileSync as writeFileSync3, mkdirSync as mkdirSync3, existsSync as existsSync7 } from "fs";
+import { writeFileSync as writeFileSync3, mkdirSync as mkdirSync3, existsSync as existsSync8 } from "fs";
 import { join as join9 } from "path";
 import { getServiceWorkerTemplate, determineTemplateType } from "@julien-lin/universal-pwa-templates";
 async function generateServiceWorker(options) {
@@ -1948,7 +2106,7 @@ async function generateServiceWorker(options) {
   try {
     const result = await injectManifest(workboxConfig);
     try {
-      if (existsSync7(swSrcPath)) {
+      if (existsSync8(swSrcPath)) {
       }
     } catch {
     }
@@ -2033,7 +2191,7 @@ async function generateAndWriteServiceWorker(options) {
 }
 
 // src/generator/https-checker.ts
-import { existsSync as existsSync8, readFileSync as readFileSync5 } from "fs";
+import { existsSync as existsSync9, readFileSync as readFileSync5 } from "fs";
 import { join as join10 } from "path";
 function checkHttps(url, allowHttpLocalhost = true) {
   let parsedUrl;
@@ -2090,7 +2248,7 @@ function detectProjectUrl(projectPath) {
   ];
   for (const config of configFiles) {
     const filePath = join10(projectPath, config.file);
-    if (existsSync8(filePath)) {
+    if (existsSync9(filePath)) {
       try {
         if (config.file.endsWith(".json") && config.key) {
           const parsed = JSON.parse(readFileSync5(filePath, "utf-8"));
@@ -2659,15 +2817,58 @@ function injectMetaTagsInFile(filePath, options = {}) {
   writeFileSync4(filePath, html, "utf-8");
   return result;
 }
+async function injectMetaTagsInFilesBatch(batchOptions) {
+  const { files, options, concurrency = 5, continueOnError = true } = batchOptions;
+  const successful = [];
+  const failed = [];
+  const processBatch = async (batch) => {
+    const results = await Promise.allSettled(
+      batch.map((file) => {
+        try {
+          const result = injectMetaTagsInFile(file, options);
+          return Promise.resolve({ file, result, success: true });
+        } catch (err) {
+          const message = err instanceof Error ? err.message : String(err);
+          if (!continueOnError) {
+            return Promise.reject(new Error(`Failed to inject meta tags in ${file}: ${message}`));
+          }
+          return Promise.resolve({ file, error: message, success: false });
+        }
+      })
+    );
+    for (const result of results) {
+      if (result.status === "fulfilled") {
+        if (result.value.success) {
+          successful.push({ file: result.value.file, result: result.value.result });
+        } else {
+          failed.push({ file: result.value.file, error: result.value.error });
+        }
+      } else {
+        const errorMessage = result.reason instanceof Error ? result.reason.message : String(result.reason);
+        failed.push({ file: "unknown", error: errorMessage });
+      }
+    }
+  };
+  for (let i = 0; i < files.length; i += concurrency) {
+    const batch = files.slice(i, i + concurrency);
+    await processBatch(batch);
+  }
+  return {
+    successful,
+    failed,
+    totalProcessed: successful.length,
+    totalFailed: failed.length
+  };
+}
 
 // src/validator/pwa-validator.ts
-import { existsSync as existsSync9, readFileSync as readFileSync7 } from "fs";
+import { existsSync as existsSync10, readFileSync as readFileSync7 } from "fs";
 import { join as join11 } from "path";
 import { readFile } from "fs/promises";
 function validateManifest(projectPath, outputDir) {
   const errors = [];
   const manifestPath = join11(outputDir, "manifest.json");
-  if (!existsSync9(manifestPath)) {
+  if (!existsSync10(manifestPath)) {
     return {
       exists: false,
       valid: false,
@@ -2797,7 +2998,7 @@ function validateIcons(projectPath, outputDir, manifest) {
   for (const icon of manifest.icons) {
     const iconPath = icon.src.startsWith("/") ? icon.src.substring(1) : icon.src;
     const fullIconPath = join11(outputDir, iconPath);
-    if (!existsSync9(fullIconPath)) {
+    if (!existsSync10(fullIconPath)) {
       errors.push({
         code: "ICON_FILE_MISSING",
         message: `Icon file not found: ${iconPath}`,
@@ -2841,7 +3042,7 @@ function validateIcons(projectPath, outputDir, manifest) {
 function validateServiceWorker(projectPath, outputDir) {
   const errors = [];
   const swPath = join11(outputDir, "sw.js");
-  if (!existsSync9(swPath)) {
+  if (!existsSync10(swPath)) {
     return {
       exists: false,
       valid: false,
@@ -3119,6 +3320,7 @@ export {
   generateSplashScreensOnly,
   injectMetaTags,
   injectMetaTagsInFile,
+  injectMetaTagsInFilesBatch,
   optimizeImage,
   optimizeProject,
   optimizeProjectImages,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@julien-lin/universal-pwa-core",
-  "version": "1.3.4",
+  "version": "1.3.6",
   "description": "Core engine for scanning, generation, and injection for UniversalPWA",
   "keywords": [
     "pwa",
@@ -61,7 +61,7 @@
     "workbox-routing": "^7.4.0",
     "workbox-strategies": "^7.4.0",
     "zod": "^4.2.1",
-    "@julien-lin/universal-pwa-templates": "^1.3.4"
+    "@julien-lin/universal-pwa-templates": "^1.3.6"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "^2.1.4",