@stacksjs/utils 0.70.159 → 0.70.161

package/README.md

@@ -15,6 +15,10 @@
 
 Stacks is a rapid development framework, where the goal is to _help you_ create & maintain frontends, backends, and clouds—without having to worry about the boilerplate. _An all-in-one toolkit that meets all your full stack needs._
 
+[![Stacks runtime architecture](./docs/diagrams/stacks-runtime.png)](./docs/diagrams/stacks-runtime.html)
+
+_Open the diagram for light and dark themes plus SVG, PNG, JPEG, and WebP exports._
+
 - Web & Desktop Applications _(including system tray apps)_
 - Serverless & Traditional APIs
 - Cloud Infrastructure Creation & Maintenance
@@ -266,7 +270,6 @@ _Develop serverless (or server) functions with countless helpers to build scalab
 - 💾 **Storage** _a secure-by-default File API that feels right_
 - 🧪 **Tinker** _a powerful TypeScript REPL_
 - 🌪️ **Validation** _e2e type-safety (true frontend & backend harmony)_
-- 🎯 **X-Ray** _all you need to debug, log & analyze_
 
 ### Cloud Development
 

package/dist/find.js

@@ -15,7 +15,20 @@ const targetFileName = "buddy", alwaysExcludePatterns = [
   `${os.homedir()}/Pictures`,
   `${os.homedir()}/Library`,
   `${os.homedir()}/.Trash`
-];
+], MAX_CONCURRENT_FS_READS = 32;
+let activeFsReads = 0;
+const fsReadQueue = [];
+async function withFsReadSlot(operation) {
+  if (activeFsReads >= MAX_CONCURRENT_FS_READS)
+    await new Promise((resolve) => fsReadQueue.push(resolve));
+  activeFsReads++;
+  try {
+    return await operation();
+  } finally {
+    activeFsReads--;
+    fsReadQueue.shift()?.();
+  }
+}
 export async function findStacksProjects(dir, options) {
   const dirWasExplicit = !!dir;
   dir = dir || os.homedir();
@@ -35,34 +48,17 @@ export async function findStacksProjects(dir, options) {
   return foundProjects;
 }
 async function searchDirectory(directory, excludePatterns) {
-  const foundProjects = [];
   if (excludePatterns.some((pattern) => typeof pattern === "string" ? directory.includes(pattern) : pattern.test(directory)))
-    return foundProjects;
+    return [];
   let items;
   try {
-    items = await fs.readdir(directory, { withFileTypes: !0 });
+    items = await withFsReadSlot(() => fs.readdir(directory, { withFileTypes: !0 }));
   } catch (error) {
     console.error(`Error reading directory ${directory}:`, error);
-    return foundProjects;
-  }
-  let buddyFileFound = !1, storageDirFound = !1;
-  for (const item of items) {
-    if (item.isFile() && item.name === targetFileName)
-      buddyFileFound = !0;
-    if (item.isDirectory()) {
-      const fullPath = path.join(directory, item.name);
-      if (item.name === "storage") {
-        const storagePath = path.join(fullPath, "framework/core/buddy");
-        try {
-          await fs.access(storagePath);
-          storageDirFound = !0;
-        } catch {}
-      }
-      const subDirProjects = await searchDirectory(fullPath, excludePatterns);
-      foundProjects.push(...subDirProjects);
-    }
+    return [];
   }
+  const buddyFileFound = items.some((item) => item.isFile() && item.name === targetFileName), storageDirFound = items.some((item) => item.isDirectory() && item.name === "storage") && await withFsReadSlot(() => fs.access(path.join(directory, "storage/framework/core/buddy"))).then(() => !0).catch(() => !1), children = items.filter((item) => item.isDirectory() && item.name !== "storage").map((item) => searchDirectory(path.join(directory, item.name), excludePatterns)), nested = (await Promise.all(children)).flat();
   if (buddyFileFound && storageDirFound)
-    foundProjects.push(directory);
-  return foundProjects;
+    nested.push(directory);
+  return nested;
 }

package/dist/utils.js

@@ -3,4 +3,4 @@ import { resolve } from "@stacksjs/path";
 import { fs } from "@stacksjs/storage";
 import { kebabCase } from "@stacksjs/strings";
 const ignore = ["readme-md"];
-export const components = fs.readdirSync(resolve(__dirname, "./resources/components")).map((item) => kebabCase(item.replace(/\.(stx|vue)/g, ""))).filter((item) => !ignore.includes(item)), functions = fs.readdirSync(resolve(__dirname, "./resources/functions")).map((item) => kebabCase(item.replace(/.ts/g, ""))).filter((item) => !ignore.includes(item));
+export const components = fs.readdirSync(resolve(__dirname, "./resources/components")).map((item) => kebabCase(item.replace(/\.stx/g, ""))).filter((item) => !ignore.includes(item)), functions = fs.readdirSync(resolve(__dirname, "./resources/functions")).map((item) => kebabCase(item.replace(/.ts/g, ""))).filter((item) => !ignore.includes(item));

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/utils",
   "type": "module",
   "sideEffects": false,
-  "version": "0.70.159",
+  "version": "0.70.161",
   "description": "The Stacks helper functions.",
   "author": "Chris Breuer",
   "contributors": [
@@ -58,20 +58,20 @@
     "size": "bun scripts/export-size.ts"
   },
   "dependencies": {
-    "@stacksjs/browser": "0.70.159"
+    "@stacksjs/browser": "0.70.161"
   },
   "devDependencies": {
-    "@stacksjs/actions": "0.70.159",
-    "@stacksjs/arrays": "0.70.159",
-    "@stacksjs/cli": "0.70.159",
-    "@stacksjs/config": "0.70.159",
+    "@stacksjs/actions": "0.70.161",
+    "@stacksjs/arrays": "0.70.161",
+    "@stacksjs/cli": "0.70.161",
+    "@stacksjs/config": "0.70.161",
     "better-dx": "^0.2.17",
     "filesize": "^11.0.22",
     "markdown-table": "^3.0.4",
-    "@stacksjs/lint": "0.70.159",
-    "@stacksjs/path": "0.70.159",
-    "@stacksjs/storage": "0.70.159",
-    "@stacksjs/strings": "0.70.159",
-    "@stacksjs/types": "0.70.159"
+    "@stacksjs/lint": "0.70.161",
+    "@stacksjs/path": "0.70.161",
+    "@stacksjs/storage": "0.70.161",
+    "@stacksjs/strings": "0.70.161",
+    "@stacksjs/types": "0.70.161"
   }
 }