From c058cfef927891badfa164f3b75ae68d46972ed7 Mon Sep 17 00:00:00 2001
From: Barys <55663639+bnn1@users.noreply.github.com>
Date: Mon, 28 Aug 2023 13:49:52 +0400
Subject: [PATCH] Limit the directories searched through for directory named
 modules (#9079)

---
 packages/internal/src/files.ts | 35 +++++++++++++++++++++++++++-------
 1 file changed, 28 insertions(+), 7 deletions(-)

diff --git a/packages/internal/src/files.ts b/packages/internal/src/files.ts
index e88a136a157d..f1325643d04c 100644
--- a/packages/internal/src/files.ts
+++ b/packages/internal/src/files.ts
@@ -25,15 +25,26 @@ export const findPages = (cwd: string = getPaths().web.pages) => {
   return modules.filter(isPageFile)
 }
 
+/**
+ * This function finds all modules in the 'web' and 'api' directories excluding 'node_modules' and Cell files.
+ * Cell files are also directory named modules but they have their special type mirror file, so they are ignored.
+ *
+ * @param {string} cwd - The directory path to start searching from. By default, it is the base path of the project.
+ * @returns {Array} modules - An array of absolute paths for the found modules.
+ *
+ * @example
+ * // Assuming the base directory of your project is '/Users/user/myproject'
+ * findDirectoryNamedModules('/Users/user/myproject');
+ * // This will return an array with the absolute paths of all matching files, e.g.:
+ * // ['/Users/user/myproject/web/src/components/Author/Author.tsx', '/Users/user/myproject/web/src/pages/AboutPage/AboutPage.tsx']
+ */
 export const findDirectoryNamedModules = (cwd: string = getPaths().base) => {
-  const modules = fg.sync('**/src/**/*.{ts,js,jsx,tsx}', {
+  const modules = fg.sync('(api|web)/src/**/*.{ts,js,jsx,tsx}', {
     cwd,
     absolute: true,
     ignore: ['node_modules'],
   })
 
-  // Cell's also follow use the directory-named-module pattern,
-  // but they get their own special type mirror file, so ignore them.
   return modules
     .filter(isDirectoryNamedModuleFile)
     .filter((p) => !isCellFile(p))
@@ -96,9 +107,6 @@ export const findApiDistFunctions = (cwd: string = getPaths().api.base) => {
   })
 }
 
-export const findPrerenderedHtml = (cwd = getPaths().web.dist) =>
-  fg.sync('**/*.html', { cwd, ignore: ['200.html', '404.html'] })
-
 export const isCellFile = (p: string) => {
   const { dir, name } = path.parse(p)
 
@@ -159,7 +167,20 @@ export const isPageFile = (p: string) => {
 
   return true
 }
-
+/**
+ * This function checks if the given path belongs to a directory named module.
+ * A directory named module is where the filename (without extension) is the same as the directory it is in.
+ *
+ * @param {string} p - The absolute path of the file.
+ * @returns {boolean} - Returns true if the path belongs to a directory named module, false otherwise.
+ *
+ * @example
+ * isDirectoryNamedModuleFile('/Users/user/myproject/web/src/components/Author/Author.tsx');
+ * // Returns: true
+ *
+ * isDirectoryNamedModuleFile('/Users/user/myproject/web/src/components/Author/AuthorInfo.tsx');
+ * // Returns: false
+ */
 export const isDirectoryNamedModuleFile = (p: string) => {
   const { dir, name } = path.parse(p)
   return dir.endsWith(name)