effect 4.0.0-beta.70 → 4.0.0-beta.71

package/dist/Ordering.d.ts

@@ -38,6 +38,11 @@ import * as Reducer_ from "./Reducer.ts";
 /**
  * Represents the result of comparing two values.
  *
+ * **When to use**
+ *
+ * Use to model a normalized comparison result that is exactly less than,
+ * equal to, or greater than.
+ *
  * **Details**
  *
  * - `-1` indicates the first value is less than the second
@@ -74,6 +79,11 @@ export type Ordering = -1 | 0 | 1;
  * Inverts the ordering of the input Ordering.
  * This is useful for creating descending sort orders from ascending ones.
  *
+ * **When to use**
+ *
+ * Use to flip an ordering result when reversing sort direction or comparison
+ * priority.
+ *
  * **Example** (Reversing comparison order)
  *
  * ```ts
@@ -109,6 +119,10 @@ export declare const reverse: (o: Ordering) => Ordering;
 /**
  * Depending on the `Ordering` parameter given to it, returns a value produced by one of the 3 functions provided as parameters.
  *
+ * **When to use**
+ *
+ * Use to branch on the three possible comparison outcomes in one expression.
+ *
  * **Example** (Pattern matching on orderings)
  *
  * ```ts
@@ -133,6 +147,10 @@ export declare const match: {
     /**
      * Depending on the `Ordering` parameter given to it, returns a value produced by one of the 3 functions provided as parameters.
      *
+     * **When to use**
+     *
+     * Use to branch on the three possible comparison outcomes in one expression.
+     *
      * **Example** (Pattern matching on orderings)
      *
      * ```ts
@@ -161,6 +179,10 @@ export declare const match: {
     /**
      * Depending on the `Ordering` parameter given to it, returns a value produced by one of the 3 functions provided as parameters.
      *
+     * **When to use**
+     *
+     * Use to branch on the three possible comparison outcomes in one expression.
+     *
      * **Example** (Pattern matching on orderings)
      *
      * ```ts
@@ -190,11 +212,21 @@ export declare const match: {
 /**
  * A `Reducer` for combining `Ordering`s.
  *
+ * **When to use**
+ *
+ * Use to combine multiple comparison results in priority order, such as
+ * checking secondary criteria only when earlier criteria compare as equal.
+ *
  * **Details**
  *
  * If any of the `Ordering`s is non-zero, the result is the first non-zero `Ordering`.
  * If all the `Ordering`s are zero, the result is zero.
  *
+ * **Gotchas**
+ *
+ * `combineAll` stops consuming the iterable as soon as it finds a non-zero
+ * `Ordering`.
+ *
  * @category ordering
  * @since 4.0.0
  */

package/dist/Ordering.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Ordering.d.ts","sourceRoot":"","sources":["../src/Ordering.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAE5C,OAAO,KAAK,QAAQ,MAAM,cAAc,CAAA;AAExC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;AAEjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,eAAO,MAAM,OAAO,GAAI,GAAG,QAAQ,KAAG,QAA6C,CAAA;AAEnF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,KAAK,EAAE;IAClB;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,EACV,OAAO,EAAE;QACP,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;QAC/B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;QAC5B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;KACnC,GACA,CAAC,IAAI,EAAE,QAAQ,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAChC;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,EACV,CAAC,EAAE,QAAQ,EACX,OAAO,EAAE;QACP,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;QAC/B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;QAC5B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;KACnC,GACA,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;CAQwE,CAAA;AAEtF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAY9C,CAAA"}
+{"version":3,"file":"Ordering.d.ts","sourceRoot":"","sources":["../src/Ordering.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAE5C,OAAO,KAAK,QAAQ,MAAM,cAAc,CAAA;AAExC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;AAEjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,eAAO,MAAM,OAAO,GAAI,GAAG,QAAQ,KAAG,QAA6C,CAAA;AAEnF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,KAAK,EAAE;IAClB;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,EACV,OAAO,EAAE;QACP,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;QAC/B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;QAC5B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;KACnC,GACA,CAAC,IAAI,EAAE,QAAQ,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAChC;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,EACV,CAAC,EAAE,QAAQ,EACX,OAAO,EAAE;QACP,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;QAC/B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;QAC5B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;KACnC,GACA,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;CAQwE,CAAA;AAEtF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAY9C,CAAA"}

package/dist/Ordering.js

@@ -4,6 +4,11 @@ import * as Reducer_ from "./Reducer.js";
  * Inverts the ordering of the input Ordering.
  * This is useful for creating descending sort orders from ascending ones.
  *
+ * **When to use**
+ *
+ * Use to flip an ordering result when reversing sort direction or comparison
+ * priority.
+ *
  * **Example** (Reversing comparison order)
  *
  * ```ts
@@ -39,6 +44,10 @@ export const reverse = o => o === -1 ? 1 : o === 1 ? -1 : 0;
 /**
  * Depending on the `Ordering` parameter given to it, returns a value produced by one of the 3 functions provided as parameters.
  *
+ * **When to use**
+ *
+ * Use to branch on the three possible comparison outcomes in one expression.
+ *
  * **Example** (Pattern matching on orderings)
  *
  * ```ts
@@ -67,11 +76,21 @@ export const match = /*#__PURE__*/dual(2, (self, {
 /**
  * A `Reducer` for combining `Ordering`s.
  *
+ * **When to use**
+ *
+ * Use to combine multiple comparison results in priority order, such as
+ * checking secondary criteria only when earlier criteria compare as equal.
+ *
  * **Details**
  *
  * If any of the `Ordering`s is non-zero, the result is the first non-zero `Ordering`.
  * If all the `Ordering`s are zero, the result is zero.
  *
+ * **Gotchas**
+ *
+ * `combineAll` stops consuming the iterable as soon as it finds a non-zero
+ * `Ordering`.
+ *
  * @category ordering
  * @since 4.0.0
  */

package/dist/Ordering.js.map

@@ -1 +1 @@
-{"version":3,"file":"Ordering.js","names":["dual","Reducer_","reverse","o","match","self","onEqual","onGreaterThan","onLessThan","Reducer","make","that","collection","ordering"],"sources":["../src/Ordering.ts"],"sourcesContent":[null],"mappings":"AAoCA,SAASA,IAAI,QAAQ,eAAe;AACpC,OAAO,KAAKC,QAAQ,MAAM,cAAc;AAsCxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmCA,OAAO,MAAMC,OAAO,GAAIC,CAAW,IAAgBA,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,GAAGA,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAE;AAEnF;;;;;;;;;;;;;;;;;;;;;;;AAuBA,OAAO,MAAMC,KAAK,gBA8DdJ,IAAI,CAAC,CAAC,EAAE,CACVK,IAAc,EACd;EAAEC,OAAO;EAAEC,aAAa;EAAEC;AAAU,CAInC,KACaH,IAAI,KAAK,CAAC,CAAC,GAAGG,UAAU,EAAE,GAAGH,IAAI,KAAK,CAAC,GAAGC,OAAO,EAAE,GAAGC,aAAa,EAAE,CAAC;AAEtF;;;;;;;;;;;AAWA,OAAO,MAAME,OAAO,gBAA+BR,QAAQ,CAACS,IAAI,CAC9D,CAACL,IAAI,EAAEM,IAAI,KAAKN,IAAI,KAAK,CAAC,GAAGA,IAAI,GAAGM,IAAI,EACxC,CAAC,EACAC,UAAU,IAAI;EACb,IAAIC,QAAQ,GAAa,CAAC;EAC1B,KAAKA,QAAQ,IAAID,UAAU,EAAE;IAC3B,IAAIC,QAAQ,KAAK,CAAC,EAAE;MAClB,OAAOA,QAAQ;IACjB;EACF;EACA,OAAOA,QAAQ;AACjB,CAAC,CACF","ignoreList":[]}
+{"version":3,"file":"Ordering.js","names":["dual","Reducer_","reverse","o","match","self","onEqual","onGreaterThan","onLessThan","Reducer","make","that","collection","ordering"],"sources":["../src/Ordering.ts"],"sourcesContent":[null],"mappings":"AAoCA,SAASA,IAAI,QAAQ,eAAe;AACpC,OAAO,KAAKC,QAAQ,MAAM,cAAc;AA2CxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwCA,OAAO,MAAMC,OAAO,GAAIC,CAAW,IAAgBA,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,GAAGA,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAE;AAEnF;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BA,OAAO,MAAMC,KAAK,gBAsEdJ,IAAI,CAAC,CAAC,EAAE,CACVK,IAAc,EACd;EAAEC,OAAO;EAAEC,aAAa;EAAEC;AAAU,CAInC,KACaH,IAAI,KAAK,CAAC,CAAC,GAAGG,UAAU,EAAE,GAAGH,IAAI,KAAK,CAAC,GAAGC,OAAO,EAAE,GAAGC,aAAa,EAAE,CAAC;AAEtF;;;;;;;;;;;;;;;;;;;;;AAqBA,OAAO,MAAME,OAAO,gBAA+BR,QAAQ,CAACS,IAAI,CAC9D,CAACL,IAAI,EAAEM,IAAI,KAAKN,IAAI,KAAK,CAAC,GAAGA,IAAI,GAAGM,IAAI,EACxC,CAAC,EACAC,UAAU,IAAI;EACb,IAAIC,QAAQ,GAAa,CAAC;EAC1B,KAAKA,QAAQ,IAAID,UAAU,EAAE;IAC3B,IAAIC,QAAQ,KAAK,CAAC,EAAE;MAClB,OAAOA,QAAQ;IACjB;EACF;EACA,OAAOA,QAAQ;AACjB,CAAC,CACF","ignoreList":[]}

package/dist/PartitionedSemaphore.d.ts

@@ -41,6 +41,10 @@ import * as Option from "./Option.ts";
  * Runtime type identifier used to mark values that implement
  * `PartitionedSemaphore`.
  *
+ * **When to use**
+ *
+ * Use to mark and recognize `PartitionedSemaphore` values at runtime.
+ *
  * **Details**
  *
  * This constant is stored on partitioned semaphore instances and can be used by
@@ -53,6 +57,10 @@ export declare const PartitionedTypeId: PartitionedTypeId;
 /**
  * Literal type of the `PartitionedSemaphore` runtime type identifier.
  *
+ * **When to use**
+ *
+ * Use to type fields that store the exact `PartitionedSemaphore` runtime marker.
+ *
  * **Details**
  *
  * Use this type when declaring fields that must contain the exact
@@ -66,6 +74,11 @@ export type PartitionedTypeId = "~effect/PartitionedSemaphore";
  * A `PartitionedSemaphore` controls access to a shared permit pool while
  * tracking waiters by partition key.
  *
+ * **When to use**
+ *
+ * Use to coordinate shared permits across partition keys so waiting groups make
+ * progress without one group monopolizing the pool.
+ *
  * **Details**
  *
  * Waiting permits are distributed across partitions in round-robin order.
@@ -86,6 +99,10 @@ export interface PartitionedSemaphore<in K> {
 /**
  * Alias interface for a `PartitionedSemaphore` keyed by values of type `K`.
  *
+ * **When to use**
+ *
+ * Use as an alternate exported name for a partitioned permit pool keyed by `K`.
+ *
  * **Details**
  *
  * This interface does not add members beyond `PartitionedSemaphore`; it
@@ -102,8 +119,8 @@ export interface Partitioned<in K> extends PartitionedSemaphore<K> {
  *
  * **When to use**
  *
- * Prefer `make` when the semaphore should be created inside an `Effect`
- * workflow.
+ * Use when a partitioned semaphore must be constructed synchronously outside an
+ * `Effect` workflow.
  *
  * **Details**
  *
@@ -111,6 +128,8 @@ export interface Partitioned<in K> extends PartitionedSemaphore<K> {
  * an unbounded semaphore whose acquire and release operations complete
  * immediately.
  *
+ * @see {@link make} for creating a partitioned semaphore inside `Effect`
+ *
  * @category constructors
  * @since 3.19.4
  */
@@ -120,12 +139,23 @@ export declare const makeUnsafe: <K = unknown>(options: {
 /**
  * Creates a `PartitionedSemaphore` inside an `Effect`.
  *
+ * **When to use**
+ *
+ * Use when semaphore construction should stay inside an `Effect` workflow.
+ *
  * **Details**
  *
  * The `permits` option sets the shared permit capacity. The resulting
  * semaphore tracks waiters by partition key and distributes released permits
  * across waiting partitions in round-robin order.
  *
+ * **Gotchas**
+ *
+ * Negative permit counts are clamped to `0`. Non-finite permit counts create
+ * an unbounded semaphore.
+ *
+ * @see {@link makeUnsafe} for synchronous construction
+ *
  * @category constructors
  * @since 3.19.4
  */
@@ -135,6 +165,24 @@ export declare const make: <K = unknown>(options: {
 /**
  * Gets the current number of available permits.
  *
+ * **When to use**
+ *
+ * Use to inspect a snapshot of how many permits are currently free.
+ *
+ * **Details**
+ *
+ * Running the returned effect reads the semaphore's current availability.
+ * Taking permits decreases availability, and releasing permits can increase it
+ * up to the semaphore capacity.
+ *
+ * **Gotchas**
+ *
+ * Reading availability does not reserve permits.
+ *
+ * @see {@link capacity} for the fixed total permit capacity
+ * @see {@link release} for returning permits to the shared pool
+ * @see {@link withPermitsIfAvailable} for running only when permits are immediately available
+ *
  * @category combinators
  * @since 4.0.0
  */
@@ -142,6 +190,17 @@ export declare const available: <K>(self: PartitionedSemaphore<K>) => Effect.Eff
 /**
  * Gets the total capacity.
  *
+ * **When to use**
+ *
+ * Use to inspect the fixed number of permits configured for the semaphore.
+ *
+ * **Details**
+ *
+ * Capacity is stored when the semaphore is created and does not change as
+ * permits are acquired or released.
+ *
+ * @see {@link available} for the current number of free permits
+ *
  * @category getters
  * @since 4.0.0
  */
@@ -150,12 +209,25 @@ export declare const capacity: <K>(self: PartitionedSemaphore<K>) => number;
  * Returns an effect that acquires the requested number of permits for the
  * given partition key.
  *
+ * **When to use**
+ *
+ * Use to manually acquire permits for a partition when acquisition and release
+ * must be controlled as separate effects.
+ *
  * **Details**
  *
  * If enough permits are available, the effect completes immediately. Otherwise
- * it waits until released permits are assigned to this partition. Requests for
- * more permits than the semaphore capacity never complete. Requests for zero
- * or a negative number of permits complete without acquiring anything.
+ * it waits until released permits are assigned to this partition.
+ *
+ * **Gotchas**
+ *
+ * Requests for more permits than the semaphore capacity never complete.
+ * Requests for zero or a negative number of permits complete without acquiring
+ * anything.
+ *
+ * @see {@link release} for manually returning permits to the shared pool
+ * @see {@link withPermits} for automatic acquire and release around an effect
+ * @see {@link withPermit} for acquiring exactly one permit around an effect
  *
  * @category combinators
  * @since 4.0.0
@@ -165,12 +237,25 @@ export declare const take: {
      * Returns an effect that acquires the requested number of permits for the
      * given partition key.
      *
+     * **When to use**
+     *
+     * Use to manually acquire permits for a partition when acquisition and release
+     * must be controlled as separate effects.
+     *
      * **Details**
      *
      * If enough permits are available, the effect completes immediately. Otherwise
-     * it waits until released permits are assigned to this partition. Requests for
-     * more permits than the semaphore capacity never complete. Requests for zero
-     * or a negative number of permits complete without acquiring anything.
+     * it waits until released permits are assigned to this partition.
+     *
+     * **Gotchas**
+     *
+     * Requests for more permits than the semaphore capacity never complete.
+     * Requests for zero or a negative number of permits complete without acquiring
+     * anything.
+     *
+     * @see {@link release} for manually returning permits to the shared pool
+     * @see {@link withPermits} for automatic acquire and release around an effect
+     * @see {@link withPermit} for acquiring exactly one permit around an effect
      *
      * @category combinators
      * @since 4.0.0
@@ -180,12 +265,25 @@ export declare const take: {
      * Returns an effect that acquires the requested number of permits for the
      * given partition key.
      *
+     * **When to use**
+     *
+     * Use to manually acquire permits for a partition when acquisition and release
+     * must be controlled as separate effects.
+     *
      * **Details**
      *
      * If enough permits are available, the effect completes immediately. Otherwise
-     * it waits until released permits are assigned to this partition. Requests for
-     * more permits than the semaphore capacity never complete. Requests for zero
-     * or a negative number of permits complete without acquiring anything.
+     * it waits until released permits are assigned to this partition.
+     *
+     * **Gotchas**
+     *
+     * Requests for more permits than the semaphore capacity never complete.
+     * Requests for zero or a negative number of permits complete without acquiring
+     * anything.
+     *
+     * @see {@link release} for manually returning permits to the shared pool
+     * @see {@link withPermits} for automatic acquire and release around an effect
+     * @see {@link withPermit} for acquiring exactly one permit around an effect
      *
      * @category combinators
      * @since 4.0.0
@@ -196,12 +294,21 @@ export declare const take: {
  * Returns an effect that releases permits back to the shared pool and returns
  * the current available permit count.
  *
+ * **When to use**
+ *
+ * Use to manually return permits acquired with `take` when a lower-level
+ * partitioned permit protocol needs explicit release control.
+ *
  * **Details**
  *
  * Released permits are first assigned to waiting partitions in round-robin
  * order. Only permits not needed by waiters increase the available count,
  * which is capped at the semaphore capacity.
  *
+ * @see {@link take} for manual acquisition
+ * @see {@link withPermits} for automatic acquire and release around an effect
+ * @see {@link available} for reading the permit count without releasing
+ *
  * @category combinators
  * @since 4.0.0
  */
@@ -210,12 +317,21 @@ export declare const release: {
      * Returns an effect that releases permits back to the shared pool and returns
      * the current available permit count.
      *
+     * **When to use**
+     *
+     * Use to manually return permits acquired with `take` when a lower-level
+     * partitioned permit protocol needs explicit release control.
+     *
      * **Details**
      *
      * Released permits are first assigned to waiting partitions in round-robin
      * order. Only permits not needed by waiters increase the available count,
      * which is capped at the semaphore capacity.
      *
+     * @see {@link take} for manual acquisition
+     * @see {@link withPermits} for automatic acquire and release around an effect
+     * @see {@link available} for reading the permit count without releasing
+     *
      * @category combinators
      * @since 4.0.0
      */
@@ -224,12 +340,21 @@ export declare const release: {
      * Returns an effect that releases permits back to the shared pool and returns
      * the current available permit count.
      *
+     * **When to use**
+     *
+     * Use to manually return permits acquired with `take` when a lower-level
+     * partitioned permit protocol needs explicit release control.
+     *
      * **Details**
      *
      * Released permits are first assigned to waiting partitions in round-robin
      * order. Only permits not needed by waiters increase the available count,
      * which is capped at the semaphore capacity.
      *
+     * @see {@link take} for manual acquisition
+     * @see {@link withPermits} for automatic acquire and release around an effect
+     * @see {@link available} for reading the permit count without releasing
+     *
      * @category combinators
      * @since 4.0.0
      */
@@ -239,13 +364,28 @@ export declare const release: {
  * Runs an effect after acquiring permits for a partition, then releases those
  * permits when the effect exits.
  *
+ * **When to use**
+ *
+ * Use to guard weighted partitioned work with automatic permit acquisition and
+ * release around an effect.
+ *
  * **Details**
  *
  * Permit acquisition may wait according to `take` semantics. Once acquired,
  * the permits are released even if the wrapped effect fails or is interrupted.
+ *
+ * **Gotchas**
+ *
+ * Requests for more permits than the semaphore capacity never complete.
  * Requests for zero or a negative number of permits run the effect without
  * acquiring anything.
  *
+ * @see {@link withPermit} for the single-permit variant
+ * @see {@link withPermitsIfAvailable} for running only when permits are
+ * immediately available
+ * @see {@link take} for manual acquisition
+ * @see {@link release} for manual release
+ *
  * @category combinators
  * @since 4.0.0
  */
@@ -254,13 +394,28 @@ export declare const withPermits: {
      * Runs an effect after acquiring permits for a partition, then releases those
      * permits when the effect exits.
      *
+     * **When to use**
+     *
+     * Use to guard weighted partitioned work with automatic permit acquisition and
+     * release around an effect.
+     *
      * **Details**
      *
      * Permit acquisition may wait according to `take` semantics. Once acquired,
      * the permits are released even if the wrapped effect fails or is interrupted.
+     *
+     * **Gotchas**
+     *
+     * Requests for more permits than the semaphore capacity never complete.
      * Requests for zero or a negative number of permits run the effect without
      * acquiring anything.
      *
+     * @see {@link withPermit} for the single-permit variant
+     * @see {@link withPermitsIfAvailable} for running only when permits are
+     * immediately available
+     * @see {@link take} for manual acquisition
+     * @see {@link release} for manual release
+     *
      * @category combinators
      * @since 4.0.0
      */
@@ -269,13 +424,28 @@ export declare const withPermits: {
      * Runs an effect after acquiring permits for a partition, then releases those
      * permits when the effect exits.
      *
+     * **When to use**
+     *
+     * Use to guard weighted partitioned work with automatic permit acquisition and
+     * release around an effect.
+     *
      * **Details**
      *
      * Permit acquisition may wait according to `take` semantics. Once acquired,
      * the permits are released even if the wrapped effect fails or is interrupted.
+     *
+     * **Gotchas**
+     *
+     * Requests for more permits than the semaphore capacity never complete.
      * Requests for zero or a negative number of permits run the effect without
      * acquiring anything.
      *
+     * @see {@link withPermit} for the single-permit variant
+     * @see {@link withPermitsIfAvailable} for running only when permits are
+     * immediately available
+     * @see {@link take} for manual acquisition
+     * @see {@link release} for manual release
+     *
      * @category combinators
      * @since 4.0.0
      */
@@ -285,11 +455,22 @@ export declare const withPermits: {
  * Runs an effect after acquiring one permit for a partition, then releases the
  * permit when the effect exits.
  *
+ * **When to use**
+ *
+ * Use to guard partitioned work with exactly one permit and automatic release
+ * when the effect exits.
+ *
  * **Details**
  *
  * This is the single-permit variant of `withPermits`. The permit is released
  * even if the wrapped effect fails or is interrupted.
  *
+ * @see {@link withPermits} for acquiring a weighted number of permits
+ * @see {@link withPermitsIfAvailable} for running only when permits are
+ * immediately available
+ * @see {@link take} for manual acquisition
+ * @see {@link release} for manual release
+ *
  * @category combinators
  * @since 4.0.0
  */
@@ -298,11 +479,22 @@ export declare const withPermit: {
      * Runs an effect after acquiring one permit for a partition, then releases the
      * permit when the effect exits.
      *
+     * **When to use**
+     *
+     * Use to guard partitioned work with exactly one permit and automatic release
+     * when the effect exits.
+     *
      * **Details**
      *
      * This is the single-permit variant of `withPermits`. The permit is released
      * even if the wrapped effect fails or is interrupted.
      *
+     * @see {@link withPermits} for acquiring a weighted number of permits
+     * @see {@link withPermitsIfAvailable} for running only when permits are
+     * immediately available
+     * @see {@link take} for manual acquisition
+     * @see {@link release} for manual release
+     *
      * @category combinators
      * @since 4.0.0
      */
@@ -311,11 +503,22 @@ export declare const withPermit: {
      * Runs an effect after acquiring one permit for a partition, then releases the
      * permit when the effect exits.
      *
+     * **When to use**
+     *
+     * Use to guard partitioned work with exactly one permit and automatic release
+     * when the effect exits.
+     *
      * **Details**
      *
      * This is the single-permit variant of `withPermits`. The permit is released
      * even if the wrapped effect fails or is interrupted.
      *
+     * @see {@link withPermits} for acquiring a weighted number of permits
+     * @see {@link withPermitsIfAvailable} for running only when permits are
+     * immediately available
+     * @see {@link take} for manual acquisition
+     * @see {@link release} for manual release
+     *
      * @category combinators
      * @since 4.0.0
      */
@@ -325,6 +528,11 @@ export declare const withPermit: {
  * Runs an effect only when the requested permits can be acquired immediately,
  * returning the result in `Some`.
  *
+ * **When to use**
+ *
+ * Use when guarded work should run only if the shared permit pool can provide
+ * the requested permits immediately.
+ *
  * **Details**
  *
  * If the permits are not available, the effect is not run and the result is
@@ -332,6 +540,9 @@ export declare const withPermit: {
  * effect completes, fails, or is interrupted. Requests for zero or a negative
  * number of permits run the effect and return `Some`.
  *
+ * @see {@link withPermits} for the keyed variant that waits until permits are
+ * available for a partition
+ *
  * @category combinators
  * @since 4.0.0
  */
@@ -340,6 +551,11 @@ export declare const withPermitsIfAvailable: {
      * Runs an effect only when the requested permits can be acquired immediately,
      * returning the result in `Some`.
      *
+     * **When to use**
+     *
+     * Use when guarded work should run only if the shared permit pool can provide
+     * the requested permits immediately.
+     *
      * **Details**
      *
      * If the permits are not available, the effect is not run and the result is
@@ -347,6 +563,9 @@ export declare const withPermitsIfAvailable: {
      * effect completes, fails, or is interrupted. Requests for zero or a negative
      * number of permits run the effect and return `Some`.
      *
+     * @see {@link withPermits} for the keyed variant that waits until permits are
+     * available for a partition
+     *
      * @category combinators
      * @since 4.0.0
      */
@@ -355,6 +574,11 @@ export declare const withPermitsIfAvailable: {
      * Runs an effect only when the requested permits can be acquired immediately,
      * returning the result in `Some`.
      *
+     * **When to use**
+     *
+     * Use when guarded work should run only if the shared permit pool can provide
+     * the requested permits immediately.
+     *
      * **Details**
      *
      * If the permits are not available, the effect is not run and the result is
@@ -362,6 +586,9 @@ export declare const withPermitsIfAvailable: {
      * effect completes, fails, or is interrupted. Requests for zero or a negative
      * number of permits run the effect and return `Some`.
      *
+     * @see {@link withPermits} for the keyed variant that waits until permits are
+     * available for a partition
+     *
      * @category combinators
      * @since 4.0.0
      */

package/dist/PartitionedSemaphore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PartitionedSemaphore.d.ts","sourceRoot":"","sources":["../src/PartitionedSemaphore.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"PartitionedSemaphore.d.ts","sourceRoot":"","sources":["../src/PartitionedSemaphore.ts"],"names":[],"mappings":"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"}