perf: optimize code block restoration and parameter replacement

- Replace iterative code block restoration with single-pass regex matching for improved performance
- Escape special regex characters in placeholders to prevent unintended pattern matches
- Refactor parameter placeholder replacement to use single regex pass instead of multiple iterations
- Optimize file watcher configuration to monitor only relevant directories (docs, assets, fragments)
- Add existence checks for watched directories to prevent errors on missing paths
- Improve watcher stability with polling configuration and write finish thresholds
- Add missing fs.existsSync import for directory validation
- Fix trailing comma formatting inconsistencies across multiple function signatures

Author: FridayCandour

src/compiler.ts

@@ -47,13 +47,21 @@ function protectCodeBlocks(content: string): {
 
 function restoreCodeBlocks(
   content: string,
-  codeBlocks: Map<string, string>
+  codeBlocks: Map<string, string>,
 ): string {
-  let restored = content;
-  codeBlocks.forEach((original, placeholder) => {
-    restored = restored.replace(placeholder, original);
+  // Build a single regex that matches all placeholders
+  const placeholders = Array.from(codeBlocks.keys());
+  if (placeholders.length === 0) return content;
+
+  // Escape special regex characters in placeholders
+  const escapedPlaceholders = placeholders.map((p) =>
+    p.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"),
+  );
+  const regex = new RegExp(`(${escapedPlaceholders.join("|")})`, "g");
+
+  return content.replace(regex, (match) => {
+    return codeBlocks.get(match) || match;
   });
-  return restored;
 }
 
 class LRUCache<K, V> {
@@ -209,12 +217,13 @@ async function processWrapperTags(
       if (templateContent) {
         const params = attrs["params"] ? parseParams(attrs["params"]) : {};
         if (params) {
-          Object.entries(params).forEach(([key, value]) => {
-            templateContent = templateContent!.replace(
-              new RegExp(`{{\\s*${key}\\s*}}`, "g"),
-              String(value)
-            );
-          });
+          // Replace all parameter placeholders in a single pass
+          templateContent = templateContent.replace(
+            /{{\s*(\w+)\s*}}/g,
+            (_, key) => {
+              return String(params[key] ?? "");
+            },
+          );
         }
         innerContent = restoreCodeBlocks(innerContent, codeBlocks);
         innerContent = md.render(innerContent);
@@ -317,12 +326,13 @@ async function processSelfClosingTags(fileContent: string, filePath: string) {
         templateCache.set(resolvedPath, frag);
       }
       if (params) {
-        Object.entries(params).forEach(([key, value]) => {
-          fragmentContent = fragmentContent.replace(
-            new RegExp(`{{\\s*${key}\\s*}}`, "g"),
-            String(value)
-          );
-        });
+        // Replace all parameter placeholders in a single pass
+        fragmentContent = fragmentContent.replace(
+          /{{\s*(\w+)\s*}}/g,
+          (_, key) => {
+            return String(params[key] ?? "");
+          },
+        );
       }
       replacements.push({ original: tagFull, replacement: fragmentContent });
     }

src/index.ts

@@ -14,6 +14,7 @@
 
 // native
 import { mkdir, open, readFile, rm, stat } from "fs/promises";
+import { existsSync } from "fs";
 import { extname, join, resolve } from "path";
 import { createReadStream } from "node:fs";
 import { exec } from "child_process";
@@ -124,7 +125,7 @@ function logHttpError(
   url: string,
   statusCode: number,
   message: string,
-  error?: any
+  error?: any,
 ): void {
   const errorLog = {
     method,
@@ -135,7 +136,7 @@ function logHttpError(
   };
 
   console.error(
-    `[${errorLog.method} ${errorLog.url} - ${errorLog.statusCode}: ${errorLog.message}`
+    `[${errorLog.method} ${errorLog.url} - ${errorLog.statusCode}: ${errorLog.message}`,
   );
   if (errorLog.error) {
     console.error("Error Details:", String(errorLog.error));
@@ -182,7 +183,7 @@ const server = http.createServer(async (req, res) => {
 });
 
 const css_command = `npx tailwindcss -c tailwind.config.js -o "${normalizePath(
-  join(config["build-directory"], "/bundle.css")
+  join(config["build-directory"], "/bundle.css"),
 )}"`;
 
 function buildCSS() {
@@ -218,7 +219,7 @@ function broadcastReload() {
         if (client.readyState === WebSocket.OPEN) {
           client.send("reload");
         }
-      }
+      },
     );
   }, 5);
 }
@@ -268,12 +269,23 @@ async function main() {
   }
   await buildCSS();
 
-  const watcher = chokidar.watch(root, {
-    ignored: [".git", "node_modules", "**/node_modules", "**/.git"],
-    ignoreInitial: true,
-    ignorePermissionErrors: true,
-    awaitWriteFinish: true,
-  });
+  const watcher = chokidar.watch(
+    [
+      config["docs-directory"],
+      config["assets-folder"],
+      normalizePath(join(cwd(), "fragments")),
+    ].filter((path) => path && existsSync(path)),
+    {
+      ignored: ["**/node_modules/**", "**/.git/**", config["build-directory"]],
+      ignoreInitial: true,
+      ignorePermissionErrors: true,
+      usePolling: true,
+      awaitWriteFinish: {
+        stabilityThreshold: 200,
+        pollInterval: 100,
+      },
+    },
+  );
   const changesCompiler = async (file: string) => {
     if (parsing) return;
     try {