dinou 4.0.8 → 4.0.9

package/dinou/core/server.js

@@ -218,13 +218,11 @@ if (isDevelopment) {
       isInitial = true;
       currentManifest = {};
     });
-    // manifestWatcher.on("all", (event) => console.log("event", event));
     manifestWatcher.on("change", onManifestChange);
   }
   startManifestWatcher();
 }
 let serverFunctionsManifest = null;
-// const devCache = new Map(); // For dev: Map<absolutePath, Set<exports>>
 
 if (!isDevelopment) {
   // In prod/build: load generated manifest
@@ -326,14 +324,6 @@ function getContext(req, res) {
 
       // 4. REDIRECT (Your existing smart wrapper)
       redirect: (...args) => safeResCall("redirect", ...args),
-      // redirect: (...args) => {
-      //   if (res.headersSent) {
-      //     // Do nothing on res object.
-      //     // We trust that your Server Function will return <ClientRedirect />
-      //     return;
-      //   }
-      //   res.redirect.apply(res, args);
-      // },
     },
   };
   return context;
@@ -513,12 +503,7 @@ async function serveRSCPayload(req, res, isOld = false, isStatic = false) {
     //   isStatic,
     //   reqPath
     // );
-    if (
-      (!isDevelopment &&
-        /*Object.keys({ ...req.query }).length === 0 &&*/
-        !dynamicState.value) ||
-      isStatic
-    ) {
+    if ((!isDevelopment && !dynamicState.value) || isStatic) {
       const payloadPath = path.resolve(
         "dist2",
         reqPath.replace(/^\//, ""),
@@ -536,16 +521,6 @@ async function serveRSCPayload(req, res, isOld = false, isStatic = false) {
           console.error("Error reading RSC file:", err);
           res.status(500).end();
         });
-        // readStream.on("end", () => {
-        //   if (!regenerating.has(reqPath)) {
-        //     // Regeneration has finished, delete the old one
-        //     try {
-        //       unlinkSync(payloadPathOld);
-        //     } catch (err) {
-        //       console.error("Error deleting old RSC file:", err);
-        //     }
-        //   }
-        // });
         return readStream.pipe(res);
       }
     }
@@ -560,16 +535,16 @@ async function serveRSCPayload(req, res, isOld = false, isStatic = false) {
       );
       const manifest = isDevelopment
         ? JSON.parse(
-            readFileSync(
-              path.resolve(
-                process.cwd(),
-                isWebpack
-                  ? `${outputFolder}/react-client-manifest.json`
-                  : `react_client_manifest/react-client-manifest.json`,
-              ),
-              "utf8",
+          readFileSync(
+            path.resolve(
+              process.cwd(),
+              isWebpack
+                ? `${outputFolder}/react-client-manifest.json`
+                : `react_client_manifest/react-client-manifest.json`,
             ),
-          )
+            "utf8",
+          ),
+        )
         : cachedClientManifest;
 
       const { pipe } = renderToPipeableStream(jsx, manifest);
@@ -610,16 +585,16 @@ app.post(/^\/____rsc_payload_error____\/.*\/?$/, async (req, res) => {
     );
     const manifest = isDevelopment
       ? JSON.parse(
-          readFileSync(
-            path.resolve(
-              process.cwd(),
-              isWebpack
-                ? `${outputFolder}/react-client-manifest.json`
-                : `react_client_manifest/react-client-manifest.json`,
-            ),
-            "utf8",
+        readFileSync(
+          path.resolve(
+            process.cwd(),
+            isWebpack
+              ? `${outputFolder}/react-client-manifest.json`
+              : `react_client_manifest/react-client-manifest.json`,
           ),
-        )
+          "utf8",
+        ),
+      )
       : cachedClientManifest;
     const { pipe } = renderToPipeableStream(jsx, manifest);
     pipe(res);
@@ -642,11 +617,7 @@ app.get(/^\/.*\/?$/, (req, res) => {
     // Get reference to the mutable object
     const dynamicState = isDynamic.get(reqPath);
     // console.log("dynamicState.value", dynamicState.value);
-    if (
-      !isDevelopment &&
-      /*Object.keys({ ...req.query }).length === 0 &&*/
-      !dynamicState.value
-    ) {
+    if (!isDevelopment && !dynamicState.value) {
       revalidating(reqPath, dynamicState);
       let htmlPathOld;
       if (regenerating.has(reqPath)) {
@@ -686,16 +657,6 @@ app.get(/^\/.*\/?$/, (req, res) => {
 
           // 4. Manually close the response (now we do)
           res.end();
-
-          // // 5. Optional cleanup logic (async to avoid blocking)
-          // if (htmlPathOld && !regenerating.has(reqPath)) {
-          //   // It is better to use fs.promises to avoid blocking the event loop
-          //   require("fs")
-          //     .promises.unlink(htmlPathOld)
-          //     .catch((err) => {
-          //       console.error("Error deleting old HTML file:", err);
-          //     });
-          // }
         });
 
         return; // The stream is already flowing
@@ -761,7 +722,6 @@ app.get(/^\/.*\/?$/, (req, res) => {
           appHtmlStream.on("end", resolve);
           appHtmlStream.on("error", (error) => {
             console.error("Stream error:", error);
-            // resolve(); // ⚠️ WATCH OUT: If you resolve here and then try to send status 500, it might fail if headers sent
             if (!res.headersSent) res.status(500).send("Internal Server Error");
             resolve(); // Better resolve at the end
           });
@@ -921,9 +881,6 @@ app.post("/____server_function____", async (req, res) => {
       // Prod: use manifest (relativePath is already normalized)
       allowedExports = serverFunctionsManifest[relativePath];
     } else {
-      // Dev: use cache or verify file
-      // allowedExports = devCache.get(absolutePath);
-      // if (!allowedExports) {
       const fileContent = readFileSync(absolutePath, "utf8"); // Reads only once
       if (!useServerRegex.test(fileContent)) {
         return res
@@ -933,8 +890,6 @@ app.post("/____server_function____", async (req, res) => {
       // Parse exports (you need to implement parseExports on server if not present)
       const exports = parseExports(fileContent); // Assume you move parseExports to a shared util
       allowedExports = new Set(exports);
-      // devCache.set(absolutePath, allowedExports);
-      // }
     }
 
     // Validate exportName against allowedExports

package/dinou/esbuild/helpers-esbuild/get-config-esbuild-prod.mjs

@@ -61,7 +61,6 @@ export default function getConfigEsbuildProd({
       "/serverFunctionProxy.js",
       "/__hmr_client__.js",
       "/react-refresh-entry.js",
-      // "dinou",
     ],
     plugins,
   };

package/dinou/esbuild/helpers-esbuild/get-config-esbuild.mjs

@@ -58,7 +58,6 @@ export default function getConfigEsbuild({
       "/serverFunctionProxy.js",
       "/__hmr_client__.js",
       "/react-refresh-entry.js",
-      // "dinou",
     ],
     plugins,
   };

package/dinou/esbuild/helpers-esbuild/get-esbuild-entries.mjs

@@ -68,7 +68,7 @@ export default async function getEsbuildEntries({
         continue;
       }
 
-      // Leer el archivo UNA sola vez
+      // Read the file ONLY once
       let importedCode;
       try {
         importedCode = readFileSync(absImportPathWithExt, "utf8");
@@ -81,12 +81,12 @@ export default async function getEsbuildEntries({
       }
 
       if (!isTopLevelClientComponent) {
-        // Verificar si es un client component
+        // Verify if it is a client component
         const isImportedFileClient = useClientRegex.test(importedCode.trim());
 
-        // Si es client component, NO procesar recursivamente
+        // If it is a client component, DO NOT process recursively
         if (isImportedFileClient) {
-          continue; // No procesar recursivamente client components
+          continue; // Do not recursively process client components
         }
       } else {
         const isImportedFileServer = useServerRegex.test(importedCode.trim());
@@ -96,7 +96,7 @@ export default async function getEsbuildEntries({
         }
       }
 
-      // Para módulos no-client, procesar normalmente
+      // For non-client modules, process normally
       if (
         absImportPathWithExt.endsWith(".css") ||
         absImportPathWithExt.endsWith(".scss") ||
@@ -111,15 +111,15 @@ export default async function getEsbuildEntries({
         continue;
       }
 
-      // 🚨 LA SOLUCIÓN: Si es un JSON, lo añadimos pero NO lo parseamos con Babel
+      // 🚨 THE SOLUTION: If it is a JSON file, add it but DO NOT parse it with Babel
       if (absImportPathWithExt.endsWith(".json")) {
         imports.add(absImportPathWithExt);
-        continue; // Esto evita que pase a la recursividad de Babel
+        continue; // This prevents it from entering Babel recursion
       }
 
       imports.add(absImportPathWithExt);
 
-      // Procesar imports recursivamente para módulos no-client
+      // Process imports recursively for non-client modules
       try {
         const nested = await getImportsAndAssetsAndCsss(
           importedCode,

package/dinou/esbuild/helpers-esbuild/write.mjs

@@ -16,31 +16,31 @@ export default async function write(result) {
       entryPointNormalized = entryPointNormalized.replace("dinou-asset:", "");
     }
     const inputKeys = Object.keys(info.inputs);
-    // Lógica para assets
+    // Logic for assets
     if (
       regex.test(entryPointNormalized) &&
       inputKeys.length === 1 &&
       inputKeys[0] === info.entryPoint
     ) {
-      // Saltar el .js inútil
+      // Skip the useless .js file
       const normalizedPath = normalizeRel(relPath);
       skipSet.add(normalizedPath);
-      // Saltar el .map correspondiente si existe
+      // Skip the corresponding .map file if it exists
       const mapRelPath = relPath.replace(/\.js$/, ".js.map");
       if (result.metafile.outputs[mapRelPath]) {
         skipSet.add(normalizeRel(mapRelPath));
       }
     }
-    // Lógica para CSS
+    // Logic for CSS
     if (
       cssRegex.test(info.entryPoint) &&
       ((inputKeys.length === 1 && inputKeys[0] === info.entryPoint) ||
         inputKeys.length === 0)
     ) {
-      // Saltar el .js inútil
+      // Skip the useless .js file
       const normalizedPath = normalizeRel(relPath);
       skipSet.add(normalizedPath);
-      // Saltar el .map correspondiente si existe
+      // Skip the corresponding .map file if it exists
       const mapRelPath = relPath + ".map";
       if (result.metafile.outputs[mapRelPath]) {
         skipSet.add(normalizeRel(mapRelPath));

package/dinou/esbuild/plugins-esbuild/assets-plugin.mjs

@@ -18,7 +18,7 @@ export default function assetsPlugin({ include = regex } = {}) {
 
       build.initialOptions.assetNames = "assets/[name]-[hash]";
 
-      // Manejar la carga de assets con namespaces diferentes
+      // Handle asset loading with different namespaces
       build.onResolve({ filter: include }, (args) => {
         // console.log("[assets-plugin] onResolve", args);
         const resolvedAlias =
@@ -28,7 +28,7 @@ export default function assetsPlugin({ include = regex } = {}) {
                 parentURL: pathToFileURL(args.importer).href,
               });
 
-        // CRUCIAL: Namespace diferente para entry points
+        // CRUCIAL: Different namespace for entry points
         if (args.kind === "entry-point") {
           return {
             path: resolvedAlias,
@@ -42,13 +42,13 @@ export default function assetsPlugin({ include = regex } = {}) {
         };
       });
 
-      // Loader para assets normales
+      // Loader for normal assets
       build.onLoad({ filter: /.*/, namespace: "dinou-asset" }, async (args) => {
         const contents = await fs.readFile(args.path);
         return { contents, loader: "file" };
       });
 
-      // Loader para assets entry points
+      // Loader for asset entry points
       build.onLoad(
         { filter: /.*/, namespace: "dinou-asset-entry" },
         async (args) => {
@@ -64,7 +64,7 @@ export default function assetsPlugin({ include = regex } = {}) {
         const normalizeRel = (p) => p.replace(/\\/g, "/");
         const processedSourceFiles = new Set();
 
-        // Primera pasada: assets normales (archivos individuales)
+        // First pass: normal assets (individual files)
         for (const [oldRelPath, info] of Object.entries(
           result.metafile.outputs
         )) {
@@ -88,11 +88,11 @@ export default function assetsPlugin({ include = regex } = {}) {
           processedSourceFiles.add(sourceFile);
         }
 
-        // Segunda pasada: buscar assets que están dentro de chunks
+        // Second pass: find assets that are inside chunks
         for (const [outputPath, info] of Object.entries(
           result.metafile.outputs
         )) {
-          // Solo buscar en chunks JavaScript
+          // Only search in JavaScript chunks
           if (!outputPath.endsWith(".js") || info.entryPoint) continue;
 
           for (const inputPath of Object.keys(info.inputs)) {
@@ -111,10 +111,10 @@ export default function assetsPlugin({ include = regex } = {}) {
               const scoped = createScopedName(base, sourceFile);
               const newLocal = `assets/${scoped}${ext}`;
 
-              // Leer el asset original
+              // Read the original asset
               const assetContent = await fs.readFile(sourceFile);
 
-              // Crear un nuevo output file para este asset
+              // Create a new output file for this asset
               const newOutputFile = {
                 path: path.join(outdir, newLocal),
                 contents: assetContent,
@@ -130,7 +130,7 @@ export default function assetsPlugin({ include = regex } = {}) {
               //   `Extracted asset from chunk: ${sourceFile} → ${newLocal}`
               // );
 
-              // Buscar el chunk que contiene este asset
+              // Find the chunk that contains this asset
               const chunkFile = result.outputFiles.find(
                 (f) =>
                   normalizeRel(path.relative(process.cwd(), f.path)) ===
@@ -140,12 +140,12 @@ export default function assetsPlugin({ include = regex } = {}) {
               if (chunkFile) {
                 let chunkContent = new TextDecoder().decode(chunkFile.contents);
 
-                // ENFOQUE MÁS PRECISO: Buscar el comentario específico de este asset
+                // MORE PRECISE APPROACH: Find the specific comment for this asset
                 const assetComment = `// ${inputPath}`;
                 const commentIndex = chunkContent.indexOf(assetComment);
 
                 if (commentIndex !== -1) {
-                  // Encontrar la línea siguiente que contiene la asignación de variable
+                  // Find the next line containing the variable assignment
                   const nextLineStart =
                     chunkContent.indexOf("\n", commentIndex) + 1;
                   const nextLineEnd = chunkContent.indexOf("\n", nextLineStart);
@@ -154,7 +154,7 @@ export default function assetsPlugin({ include = regex } = {}) {
                     nextLineEnd
                   );
 
-                  // Extraer el nombre de la variable (ej: "dinou_default")
+                  // Extract the variable name (e.g., "dinou_default")
                   const varMatch = assignmentLine.match(
                     /var (\w+)_default = "([^"]+)"/
                   );
@@ -163,7 +163,7 @@ export default function assetsPlugin({ include = regex } = {}) {
                     const varName = varMatch[1];
                     const oldPath = varMatch[2];
 
-                    // Reemplazar SOLO esta asignación específica
+                    // Replace ONLY this specific assignment
                     const newAssignmentLine = `var ${varName}_default = "/${newLocal}";`;
                     chunkContent =
                       chunkContent.substring(0, nextLineStart) +
@@ -175,7 +175,7 @@ export default function assetsPlugin({ include = regex } = {}) {
                     // );
                   }
                 } else {
-                  // Fallback: buscar por el nombre de archivo en la ruta
+                  // Fallback: search by filename in the path
                   const assetName = path.basename(sourceFile);
                   const escapedAssetName = escapeRegExp(assetName);
                   const pattern = new RegExp(
@@ -202,7 +202,7 @@ export default function assetsPlugin({ include = regex } = {}) {
           }
         }
 
-        // Actualizar referencias en archivos JS/CSS (código existente)
+        // Update references in JS/CSS files (existing code)
         for (const file of result.outputFiles) {
           const relPath = normalizeRel(path.relative(process.cwd(), file.path));
           if (!relPath.endsWith(".js") && !relPath.endsWith(".css")) continue;
@@ -226,7 +226,7 @@ export default function assetsPlugin({ include = regex } = {}) {
           file.contents = new TextEncoder().encode(content);
         }
 
-        // Actualizar paths (código existente)
+        // Update paths (existing code)
         for (const file of result.outputFiles) {
           const relPath = normalizeRel(path.relative(process.cwd(), file.path));
           const oldLocal = normalizeRel(path.relative(outdir, relPath));

package/dinou/esbuild/plugins-esbuild/babel-react-compiler-plugin.mjs

@@ -7,10 +7,10 @@ export default function babelReactCompilerPlugin() {
     name: "babel-react-compiler-bridge",
     setup(build) {
       const entryPoints = build.initialOptions.entryPoints;
-      // Interceptamos archivos JS/TS/JSX/TSX
-      // OJO: Filtramos node_modules para no ralentizar procesando librerías externas
+      // Intercept JS/TS/JSX/TSX files
+      // NOTE: Filter node_modules to avoid slowing down by processing external libraries
       build.onLoad({ filter: /\.[jt]sx?$/ }, async (args) => {
-        // Doble chequeo de seguridad para evitar node_modules
+        // Double check security to avoid node_modules
         if (args.path.includes("node_modules")) return;
         const abs = path.resolve(args.path);
 
@@ -25,30 +25,30 @@ export default function babelReactCompilerPlugin() {
           const source = await fs.readFile(args.path, "utf8");
           const filename = args.path;
 
-          // Transformamos el código con Babel + React Compiler
+          // Transform the code with Babel + React Compiler
           const result = await babel.transformAsync(source, {
             filename,
             presets: [
-              // Necesitamos decirle a Babel que entienda React y TS antes de compilar
+              // We need to tell Babel to understand React and TS before compiling
               ["@babel/preset-react", { runtime: "automatic" }],
               "@babel/preset-typescript",
             ],
             plugins: [
-              "babel-plugin-react-compiler", // 👈 LA JOYA DE LA CORONA
+              "babel-plugin-react-compiler", // 👈 The jewel in the crown
             ],
-            sourceMaps: true, // Vital para que los sourcemaps de esbuild funcionen
-            configFile: false, // Ignoramos babel.config.js globales para ir al grano
+            sourceMaps: true, // Vital for esbuild sourcemaps to work
+            configFile: false, // Ignore global babel.config.js to get straight to the point
           });
 
-          // Si por alguna razón Babel no devuelve código, dejamos a esbuild actuar
+          // If for some reason Babel does not return code, let esbuild handle it
           if (!result || !result.code) return;
 
           return {
             contents: result.code,
-            loader: "js", // Babel devuelve JS estándar
+            loader: "js", // Babel returns standard JS
           };
         } catch (error) {
-          // Si falla Babel, mostramos error bonito para no romper el build silenciosamente
+          // If Babel fails, show a clean error to not break the build silently
           return {
             errors: [
               {

package/dinou/esbuild/plugins-esbuild/server-functions-plugin.mjs

@@ -8,7 +8,7 @@ export default function serverFunctionsPlugin(manifestData = {}) {
     name: "server-functions-proxy",
     setup(build) {
       const root = process.cwd();
-      const serverFunctions = new Map(); // Recolectar aquí: Map<relativePath, Set<exports>>
+      const serverFunctions = new Map(); // Collect server functions here: Map<relativePath, Set<exports>>
 
       // 1. TRANSFORM FILES DURING BUILD
       build.onLoad({ filter: /\.[jt]sx?$/ }, async (args) => {
@@ -20,11 +20,11 @@ export default function serverFunctionsPlugin(manifestData = {}) {
         if (exports.length === 0) return null;
 
         const relativePath = path.relative(root, args.path);
-        serverFunctions.set(relativePath, new Set(exports)); // Guardar exports como Set para uniqueness
+        serverFunctions.set(relativePath, new Set(exports)); // Save exports as a Set to guarantee uniqueness
 
         const fileUrl = `file:///${relativePath}`;
 
-        // Proxy code (igual que antes)
+        // Generate proxy code that forwards calls to the server instead of executing the actual code
         let proxyCode = `
           import { createServerFunctionProxy } from "/__SERVER_FUNCTION_PROXY__";
         `;
@@ -69,13 +69,13 @@ export default function serverFunctionsPlugin(manifestData = {}) {
           }
         }
 
-        // Generar manifest: convertir Map a objeto simple
+        // Generate the final manifest by converting the Map to a plain object
         const manifestObj = {};
         for (const [path, exportsSet] of serverFunctions.entries()) {
           manifestObj[path] = Array.from(exportsSet);
         }
 
-        // Escribir el manifest en el output dir (ej. mismo lugar que otros assets)
+        // Write the server functions manifest JSON file to the output directory
         const manifestPath = path.join(
           "server_functions_manifest",
           "server-functions-manifest.json"

package/dinou/esbuild/plugins-esbuild/stable-chunk-names-and-maps-plugin.mjs

@@ -11,7 +11,7 @@ export default function stableChunkNamesAndMapsPlugin({ dev = true } = {}) {
 
         const renames = new Map(); // oldFilename → newFilename (e.g., 'chunk-ABC.js' → 'chunk-stable.js')
         const normalizeRel = (p) => p.replace(/\\/g, "/");
-        // Primero, renombrar chunks
+        // First, rename chunks
         for (const [oldRelPath, info] of Object.entries(
           result.metafile.outputs
         )) {
@@ -21,7 +21,7 @@ export default function stableChunkNamesAndMapsPlugin({ dev = true } = {}) {
             (f) => f.startsWith("src/") && /\.(js|jsx|ts|tsx)$/.test(f)
           );
           if (!sourceFile) continue;
-          // Nombre estable basado en el archivo fuente (siempre igual)
+          // Stable name based on the source file (always the same)
           const rel = path.relative("src", sourceFile);
           const normalizedRel = rel.replace(/\\/g, "/");
           const dir = path.dirname(normalizedRel);
@@ -33,7 +33,7 @@ export default function stableChunkNamesAndMapsPlugin({ dev = true } = {}) {
             dir === "." ? base : `${dir.replace(/\//g, "-")}-${base}`;
           let finalName;
           if (dev) {
-            finalName = `${stableName}.js`; // 100% estable en dev
+            finalName = `${stableName}.js`; // 100% stable in dev
           } else {
             const hash = oldRelPath.match(/-([A-Z0-9]+)\./)?.[1] || "";
             finalName = `${stableName}-${hash}.js`;
@@ -42,7 +42,7 @@ export default function stableChunkNamesAndMapsPlugin({ dev = true } = {}) {
           const oldLocal = path.basename(oldRelPath);
           renames.set(oldLocal, finalRelPath);
         }
-        // Segundo, renombrar maps correspondientes a los chunks
+        // Second, rename maps corresponding to the chunks
         for (const [oldRelPath, info] of Object.entries(
           result.metafile.outputs
         )) {
@@ -56,7 +56,7 @@ export default function stableChunkNamesAndMapsPlugin({ dev = true } = {}) {
             renames.set(oldMapLocal, newMapLocal);
           }
         }
-        // Paso 3: Actualizar referencias en importers (imports en .js)
+        // Step 3: Update references in importers (imports in .js)
         const outputs = result.metafile.outputs;
         const escapeRegExp = (string) =>
           string.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
@@ -74,22 +74,22 @@ export default function stableChunkNamesAndMapsPlugin({ dev = true } = {}) {
             const oldImportedLocal = path.basename(importedRelPath);
             const newImportedLocal = renames.get(oldImportedLocal);
             if (!newImportedLocal) continue;
-            // Reemplazar para double quotes con ./
+            // Replace for double quotes with ./
             const oldDouble = `"./${escapeRegExp(oldImportedLocal)}"`;
             const newDouble = `"./${newImportedLocal}"`;
             content = content.replace(new RegExp(oldDouble, "g"), newDouble);
-            // Reemplazar para double quotes sin ./
+            // Replace for double quotes without ./
             const oldDoubleNoDot = `"${escapeRegExp(oldImportedLocal)}"`;
             const newDoubleNoDot = `"${newImportedLocal}"`;
             content = content.replace(
               new RegExp(oldDoubleNoDot, "g"),
               newDoubleNoDot
             );
-            // Reemplazar para single quotes con ./
+            // Replace for single quotes with ./
             const oldSingle = `'./${escapeRegExp(oldImportedLocal)}'`;
             const newSingle = `'./${newImportedLocal}'`;
             content = content.replace(new RegExp(oldSingle, "g"), newSingle);
-            // Reemplazar para single quotes sin ./
+            // Replace for single quotes without ./
             const oldSingleNoDot = `'${escapeRegExp(oldImportedLocal)}'`;
             const newSingleNoDot = `'${newImportedLocal}'`;
             content = content.replace(
@@ -99,7 +99,7 @@ export default function stableChunkNamesAndMapsPlugin({ dev = true } = {}) {
           }
           importerFile.contents = new TextEncoder().encode(content);
         }
-        // Nuevo: Actualizar sourceMappingURL en los .js que se renombran
+        // New: Update sourceMappingURL in the .js files being renamed
         for (const file of result.outputFiles) {
           if (!file.path.endsWith(".js")) continue;
           const oldRelPath = normalizeRel(
@@ -123,7 +123,7 @@ export default function stableChunkNamesAndMapsPlugin({ dev = true } = {}) {
           );
           file.contents = new TextEncoder().encode(content);
         }
-        // Actualizar paths en outputFiles para chunks y maps
+        // Update paths in outputFiles for chunks and maps
         for (const file of result.outputFiles) {
           const relPath = normalizeRel(path.relative(process.cwd(), file.path));
           const oldLocal = path.basename(relPath);
@@ -132,7 +132,7 @@ export default function stableChunkNamesAndMapsPlugin({ dev = true } = {}) {
             file.path = path.join(path.dirname(file.path), newLocal);
           }
         }
-        // Actualizar metafile para consistencia
+        // Update metafile for consistency
         const newOutputs = {};
         for (const oldRelPath in outputs) {
           const oldLocal = path.basename(oldRelPath);

package/dinou/esbuild/plugins-postcss/postcss-extract-plugin.js

@@ -7,7 +7,7 @@ const createPostCSSExtractPlugin = (options = {}) => {
 
   let extractedCSS = "";
 
-  // El plugin de PostCSS propiamente dicho
+  // Define the PostCSS plugin to intercept and extract CSS rules
   const postcssPlugin = {
     postcssPlugin: "postcss-extract",
 
@@ -18,13 +18,13 @@ const createPostCSSExtractPlugin = (options = {}) => {
         extractedCSS += root.toString();
         extractedCSS += "\n";
 
-        // Limpia el CSS original
+        // Remove all CSS rules from the original file to prevent duplicate injection
         root.removeAll();
       }
     },
   };
 
-  // Función para finalizar
+  // Write the collected CSS contents to the final output file on disk
   const finalize = () => {
     if (!extractedCSS) return;
     const outputDir = path.dirname(outputFile);