@stacksjs/utils 0.74.32 → 0.74.34

package/README.md

@@ -15,9 +15,14 @@
 
 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)
+<a href="https://stacksjs.com/docs/diagrams/stacks-runtime">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="./docs/public/diagrams/stacks-runtime/dark.png">
+    <img alt="Stacks runtime architecture: developer to Buddy CLI to Stacks Cloud, and web or desktop client through rpx to stx, router, actions, ORM, and database" src="./docs/public/diagrams/stacks-runtime/light.png">
+  </picture>
+</a>
 
-_Open the diagram for light and dark themes plus SVG, PNG, JPEG, and WebP exports._
+_[Open the interactive diagram](https://stacksjs.com/docs/diagrams/stacks-runtime) for a theme toggle and SVG, PNG, JPEG, and WebP exports._
 
 - Web & Desktop Applications _(including system tray apps)_
 - Serverless & Traditional APIs
@@ -61,6 +66,8 @@ panx @stacksjs/buddy new my-project
 
 Pantry executes Buddy in an isolated environment and provisions the generated project's declared toolchain during setup.
 
+From there: the [documentation](https://stacksjs.com/docs/guide/intro), the [Buddy command reference](https://stacksjs.com/docs/guide/buddy/commands), and the [agent skills](https://stacksjs.com/docs/skills) that teach Claude Code, Codex, and Cursor how each subsystem works.
+
 For frontend experiments in the browser, open the live stx starter:
 
 [![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/fork/github/stacksjs/stackblitz?title=Stacks%20Starter)
@@ -78,7 +85,7 @@ buddy make:action UpdateUser   # scaffold a new Action (also: model, view, job,
 buddy --help       # show every available command
 ```
 
-For the full command reference, see the collapsible section below or the [Buddy CLI documentation](https://stacksjs.com/docs/cli).
+For the full command reference, see the collapsible section below or the [Buddy CLI documentation](https://stacksjs.com/docs/guide/buddy/commands).
 
 <details>
 <summary>View the complete Buddy Toolkit</summary>
@@ -245,7 +252,7 @@ buddy test:types # runs typecheck
 
 </details>
 
-Read more about the Buddy CLI in the [official docs](https://stacksjs.com/docs/cli) — every command, every flag, every prompt explained.
+Read more about the Buddy CLI in the [official docs](https://stacksjs.com/docs/guide/buddy/commands): every command, every flag, every prompt explained.
 
 ## Features
 

package/dist/index.d.ts

@@ -21,4 +21,5 @@ export * from './colors';
 export * from './markdown';
 export * from './size';
 export * from './observer';
+export * from './pipe';
 export * from './pipeline';

package/dist/index.js

@@ -1 +1 @@
-export*from"./clean";export*from"./config";export*from"./equal";export*from"./errors";export*from"./export-size";export*from"./find";export*from"./git";export*from"./hash";export*from"./helpers";export*from"./macroable";export*from"./safe-json";export*from"./versions";export* as browserUtils from"@stacksjs/browser";export{clamp,notNullish,retry,useOnline}from"@stacksjs/browser";export*from"./merge";export*from"./detect";export*from"./debounce";export*from"./bytes";export*from"./colors";export*from"./markdown";export*from"./size";export*from"./observer";export*from"./pipeline";
+export*from"./clean";export*from"./config";export*from"./equal";export*from"./errors";export*from"./export-size";export*from"./find";export*from"./git";export*from"./hash";export*from"./helpers";export*from"./macroable";export*from"./safe-json";export*from"./versions";export* as browserUtils from"@stacksjs/browser";export{clamp,notNullish,retry,useOnline}from"@stacksjs/browser";export*from"./merge";export*from"./detect";export*from"./debounce";export*from"./bytes";export*from"./colors";export*from"./markdown";export*from"./size";export*from"./observer";export*from"./pipe";export*from"./pipeline";

package/dist/pipe.d.ts

@@ -0,0 +1,52 @@
+export declare function pipe<A>(value: A): A;
+export declare function pipe<A, B>(value: A, ab: (input: A) => B): B;
+export declare function pipe<A, B, C>(value: A, ab: (input: A) => B, bc: (input: B) => C): C;
+export declare function pipe<A, B, C, D>(value: A, ab: (input: A) => B, bc: (input: B) => C, cd: (input: C) => D): D;
+export declare function pipe<A, B, C, D, E>(value: A, ab: (input: A) => B, bc: (input: B) => C, cd: (input: C) => D, de: (input: D) => E): E;
+export declare function pipe<A, B, C, D, E, F>(value: A, ab: (input: A) => B, bc: (input: B) => C, cd: (input: C) => D, de: (input: D) => E, ef: (input: E) => F): F;
+export declare function pipe<A, B, C, D, E, F, G>(value: A, ab: (input: A) => B, bc: (input: B) => C, cd: (input: C) => D, de: (input: D) => E, ef: (input: E) => F, fg: (input: F) => G): G;
+export declare function pipe<A, B, C, D, E, F, G, H>(value: A, ab: (input: A) => B, bc: (input: B) => C, cd: (input: C) => D, de: (input: D) => E, ef: (input: E) => F, fg: (input: F) => G, gh: (input: G) => H): H;
+export declare function pipe<A, B, C, D, E, F, G, H, I>(value: A, ab: (input: A) => B, bc: (input: B) => C, cd: (input: C) => D, de: (input: D) => E, ef: (input: E) => F, fg: (input: F) => G, gh: (input: G) => H, hi: (input: H) => I): I;
+export declare function pipe<A, B, C, D, E, F, G, H, I, J>(value: A, ab: (input: A) => B, bc: (input: B) => C, cd: (input: C) => D, de: (input: D) => E, ef: (input: E) => F, fg: (input: F) => G, gh: (input: G) => H, hi: (input: H) => I, ij: (input: I) => J): J;
+/**
+ * The same composition, without a value - a reusable function.
+ *
+ * `pipe` transforms something now; this builds the transformation to apply
+ * later, which is what makes it usable as a callback:
+ *
+ * ```ts
+ * const normalize = piped(
+ *   (name: string) => name.trim(),
+ *   name => name.toLowerCase(),
+ * )
+ *
+ * names.map(normalize)
+ * ```
+ *
+ * The first step's parameter type is what the resulting function accepts, so it
+ * has to be annotated - there is nothing else for inference to work from.
+ */
+export declare function piped<A, B>(ab: (input: A) => B): (input: A) => B;
+export declare function piped<A, B, C>(ab: (input: A) => B, bc: (input: B) => C): (input: A) => C;
+export declare function piped<A, B, C, D>(ab: (input: A) => B, bc: (input: B) => C, cd: (input: C) => D): (input: A) => D;
+export declare function piped<A, B, C, D, E>(ab: (input: A) => B, bc: (input: B) => C, cd: (input: C) => D, de: (input: D) => E): (input: A) => E;
+export declare function piped<A, B, C, D, E, F>(ab: (input: A) => B, bc: (input: B) => C, cd: (input: C) => D, de: (input: D) => E, ef: (input: E) => F): (input: A) => F;
+/**
+ * Run a side effect on a value and hand the value back.
+ *
+ * For inspecting a pipeline without breaking it - the step that logs, or
+ * records a metric, and does not change what flows on:
+ *
+ * ```ts
+ * pipe(
+ *   users,
+ *   list => sortBy(list, u => u.score),
+ *   tap(list => log.debug(`${list.length} users`)),
+ *   list => take(list, 3),
+ * )
+ * ```
+ *
+ * The effect's return value is discarded on purpose. A step that means to
+ * change the value should be an ordinary step, where the type says so.
+ */
+export declare function tap<T>(effect: (value: T) => unknown): (value: T) => T;

package/dist/pipe.js

@@ -0,0 +1 @@
+function runSteps(value,steps){let current=value;for(const step of steps)current=step(current);return current}export function pipe(value,...steps){return runSteps(value,steps)}export function piped(...steps){return(input)=>runSteps(input,steps)}export function tap(effect){return(value)=>{effect(value);return value}}

package/package.json

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