@nicolastoulemont/std 0.9.0 → 0.11.0

package/dist/{index-DR7hzXU4.d.mts → index-BR6lwlNv.d.mts}

@@ -1,5 +1,6 @@
-import { i as Fx } from "./fx.types-BdN1EWxr.mjs";
-import { t as Result } from "./result.types-BKzChyWY.mjs";
+import { i as Fx, t as AsyncFx } from "./fx.types-CpFKa-Jj.mjs";
+import { t as Result } from "./result.types-JEcowzYH.mjs";
+import { n as Layer } from "./layer.types-smjitsoN.mjs";
 
 //#region src/multithread/multithread.types.d.ts
 
@@ -10,11 +11,21 @@ import { t as Result } from "./result.types-BKzChyWY.mjs";
  * - When present, `Atomics.load(signal, 0) === 1` indicates cancellation.
  */
 type MultithreadSignal = Int32Array<SharedArrayBuffer> | null;
+type MultithreadRuntimeSnapshot = {
+  readonly fiberId: number | undefined;
+  readonly logFields: Record<string, unknown>;
+  readonly trace: {
+    readonly traceId: string;
+    readonly spanId: string;
+    readonly traceFlags?: number;
+  } | undefined;
+};
 /**
  * Cooperative cancellation context injected as the last argument in worker callbacks.
  */
 type MultithreadCtx = {
   readonly signal: MultithreadSignal;
+  readonly runtime: MultithreadRuntimeSnapshot;
   isCancelled(): boolean;
   throwIfCancelled(): void;
 };
@@ -79,6 +90,13 @@ type MultithreadTask = {
   <A, E = never>(worker: (ctx: MultithreadCtx) => WorkerReturn<A, E>): () => MultithreadOp<A, E | MultithreadError>;
   <Args extends readonly unknown[], A, E = never>(worker: WorkerWithCtx<Args, A, E>): (...args: Args) => MultithreadOp<A, E | MultithreadError>;
 };
+type MultithreadFx = {
+  <A, E = never>(worker: (ctx: MultithreadCtx) => WorkerReturn<A, E>): AsyncFx<A, E | MultithreadError>;
+  <Args extends readonly unknown[], A, E = never>(worker: WorkerWithCtx<Args, A, E>, ...args: Args): AsyncFx<A, E | MultithreadError>;
+};
+type MultithreadLayer = (config: {
+  readonly maxWorkers: number;
+}) => Layer<never, MultithreadError, never, false>;
 type MultithreadMapWorker<A, B, E> = (value: A, index: number, ctx: MultithreadCtx) => WorkerReturn<B, E>;
 type MultithreadMap = {
   <A, B, E = never>(values: readonly A[], worker: MultithreadMapWorker<A, B, E>, options?: MultithreadParallelOptions): MultithreadOp<readonly B[], E | MultithreadError>;
@@ -117,54 +135,106 @@ type MultithreadFirstSuccess = {
   <Ops extends readonly MultithreadOp<unknown, unknown>[], InputE = never>(operations: Result<Ops, InputE>): Promise<Result<MultithreadValue<Ops[number]>, MultithreadOpError<Ops[number]> | InputE | MultithreadError>>;
 };
 declare namespace multithread_d_exports {
-  export { MultithreadCtx, MultithreadError, MultithreadOp, configure, filter, firstSuccess, flatMap, forEach, map, race, run, shutdown, task };
+  export { MultithreadCtx, MultithreadError, MultithreadOp, MultithreadRuntimeSnapshot, configure, filter, firstSuccess, flatMap, forEach, fx, layer, map, race, run, shutdown, task };
 }
 /**
  * Execute one worker task as a cancelable `MultithreadOp`.
  *
+ * Use `run` when you need direct `result()`, `abort()`, `await op`, or explicit
+ * sharing of one memoized operation.
+ *
  * @example
  * ```ts
  * import { Multithread } from "@nicolastoulemont/std"
  *
- * const op = Multithread.run((ctx) => (ctx.isCancelled() ? 0 : 42))
- * // => cancelable operation with result() and abort()
+ * const op = Multithread.run((input: string, ctx) => {
+ *   ctx.throwIfCancelled()
+ *   return input.toUpperCase()
+ * }, "hello")
+ *
+ * const result = await op.result()
+ * // => { _tag: "Ok", value: "HELLO" }
  * ```
  */
 declare const run: MultithreadRun;
 /**
  * Create a reusable worker task factory.
  *
+ * Each call to the returned function creates a fresh `MultithreadOp`.
+ *
  * @example
  * ```ts
  * import { Multithread } from "@nicolastoulemont/std"
  *
- * const create = Multithread.task((ctx) => (ctx.isCancelled() ? 0 : 16))
- * const op = create()
- * // => operation that resolves to 16 when executed
+ * const uppercase = Multithread.task((input: string, ctx) => {
+ *   ctx.throwIfCancelled()
+ *   return input.toUpperCase()
+ * })
+ *
+ * const result = await uppercase("hello").result()
+ * // => { _tag: "Ok", value: "HELLO" }
  * ```
  */
 declare const task: MultithreadTask;
+/**
+ * Create a fresh worker-backed Fx for each execution.
+ *
+ * Prefer this inside reusable `Fx.gen` programs. Use `run` when you need a
+ * lower-level operation handle, manual cancellation, or explicit sharing.
+ *
+ * @example
+ * ```ts
+ * import { Fx, Multithread } from "@nicolastoulemont/std"
+ *
+ * const program = Fx.gen(async function* () {
+ *   return yield* Multithread.fx((input: number, ctx) => {
+ *     ctx.throwIfCancelled()
+ *     return input * 2
+ *   }, 21)
+ * })
+ *
+ * const exit = await Fx.run(program)
+ * // => { _tag: "Ok", value: 42 }
+ * ```
+ */
+declare const fx: MultithreadFx;
 /**
  * Map a collection in parallel.
  *
+ * The `parallelism` option controls how many item operations this call keeps in
+ * flight. Runtime execution is still bounded by the configured worker count.
+ *
  * @example
  * ```ts
  * import { Multithread } from "@nicolastoulemont/std"
  *
- * const op = Multithread.map([1, 2, 3], (value) => value * 2)
- * // => operation that resolves to [2, 4, 6]
+ * const result = await Multithread.map(
+ *   [1, 2, 3],
+ *   (value, _index, ctx) => {
+ *     ctx.throwIfCancelled()
+ *     return value * 2
+ *   },
+ *   { parallelism: 2 },
+ * ).result()
+ * // => { _tag: "Ok", value: [2, 4, 6] }
  * ```
  */
 declare const map: MultithreadMap;
 /**
  * Run side-effecting parallel work for each item.
  *
+ * Use this when only completion matters. If you need collected values, use
+ * `map`.
+ *
  * @example
  * ```ts
  * import { Multithread } from "@nicolastoulemont/std"
  *
- * const op = Multithread.forEach(["a", "b"], (value) => value.toUpperCase())
- * // => operation that resolves to void after all items complete
+ * const result = await Multithread.forEach(["a", "b"], (value, _index, ctx) => {
+ *   ctx.throwIfCancelled()
+ *   return value.toUpperCase()
+ * }).result()
+ * // => { _tag: "Ok", value: undefined }
  * ```
  */
 declare const forEach: MultithreadForEach;
@@ -175,8 +245,11 @@ declare const forEach: MultithreadForEach;
  * ```ts
  * import { Multithread } from "@nicolastoulemont/std"
  *
- * const op = Multithread.filter([1, 2, 3, 4], (value) => value % 2 === 0)
- * // => operation that resolves to [2, 4]
+ * const result = await Multithread.filter([1, 2, 3, 4], (value, _index, ctx) => {
+ *   ctx.throwIfCancelled()
+ *   return value % 2 === 0
+ * }).result()
+ * // => { _tag: "Ok", value: [2, 4] }
  * ```
  */
 declare const filter: MultithreadFilter;
@@ -187,22 +260,34 @@ declare const filter: MultithreadFilter;
  * ```ts
  * import { Multithread } from "@nicolastoulemont/std"
  *
- * const op = Multithread.flatMap([1, 2], (value) => [value, value * 10])
- * // => operation that resolves to [1, 10, 2, 20]
+ * const result = await Multithread.flatMap([1, 2], (value, _index, ctx) => {
+ *   ctx.throwIfCancelled()
+ *   return [value, value * 10]
+ * }).result()
+ * // => { _tag: "Ok", value: [1, 10, 2, 20] }
  * ```
  */
 declare const flatMap: MultithreadFlatMap;
 /**
- * Resolve with the first successfully completed operation.
+ * Resolve with the first settled operation.
+ *
+ * The winner may be successful or failed. All remaining operations are aborted
+ * after the first operation settles.
  *
  * @example
  * ```ts
  * import { Multithread } from "@nicolastoulemont/std"
  *
- * const fast = Multithread.run(() => 1)
- * const slow = Multithread.run(() => 2)
- * const op = Multithread.race([fast, slow])
- * // => operation that resolves with the first finished result
+ * const fast = Multithread.run(() => "fast")
+ * const slow = Multithread.run(async () => {
+ *   await new Promise((resolve) => {
+ *     setTimeout(resolve, 50)
+ *   })
+ *   return "slow"
+ * })
+ *
+ * const result = await Multithread.race([fast, slow]).result()
+ * // => { _tag: "Ok", value: "fast" }
  * ```
  */
 declare const race: MultithreadRace;
@@ -211,14 +296,13 @@ declare const race: MultithreadRace;
  *
  * @example
  * ```ts
- * import { Multithread } from "@nicolastoulemont/std"
- *
- * import { Result } from "@nicolastoulemont/std"
+ * import { Multithread, Result } from "@nicolastoulemont/std"
  *
  * const fail = Multithread.run(() => Result.err("boom"))
  * const pass = Multithread.run(() => Result.ok(1))
- * const op = Multithread.firstSuccess([fail, pass])
- * // => operation that resolves with 1
+ *
+ * const result = await Multithread.firstSuccess([fail, pass]).result()
+ * // => { _tag: "Ok", value: 1 }
  * ```
  */
 declare const firstSuccess: MultithreadFirstSuccess;
@@ -226,6 +310,7 @@ declare const firstSuccess: MultithreadFirstSuccess;
  * Configure max worker count used by the underlying runtime.
  *
  * Must be called before first multithread operation starts.
+ * Use `layer` instead when the worker runtime should follow an `Fx` scope.
  *
  * @example
  * ```ts
@@ -238,20 +323,43 @@ declare const firstSuccess: MultithreadFirstSuccess;
 declare const configure: (config: {
   maxWorkers: number;
 }) => Result<void, MultithreadError>;
+/**
+ * Create an Fx layer that configures and shuts down the shared worker runtime.
+ *
+ * The underlying `multithreading` runtime is process-global, so the layer makes
+ * that lifecycle visible to `Fx` scopes rather than creating a per-fiber pool.
+ *
+ * @example
+ * ```ts
+ * import { Fx, Multithread, Provide } from "@nicolastoulemont/std"
+ *
+ * const program = Provide.layer(Multithread.layer({ maxWorkers: 2 }))(
+ *   Fx.gen(async function* () {
+ *     return yield* Multithread.fx(() => 42)
+ *   }),
+ * )
+ *
+ * const exit = await Fx.run(program)
+ * // => { _tag: "Ok", value: 42 }
+ * ```
+ */
+declare const layer: MultithreadLayer;
 /**
  * Shutdown worker runtime.
  *
  * This function is idempotent.
+ * Direct users can call it in test cleanup or process teardown. `layer` calls it
+ * automatically when the owning scope closes.
  *
  * @example
  * ```ts
  * import { Multithread } from "@nicolastoulemont/std"
  *
- * const shutdownPromise = Multithread.shutdown()
- * // => Promise<Result<void, MultithreadError>>
+ * const result = await Multithread.shutdown()
+ * // => { _tag: "Ok", value: undefined }
  * ```
  */
 declare const shutdown: () => Promise<Result<void, MultithreadError>>;
 //#endregion
 export { multithread_d_exports as t };
-//# sourceMappingURL=index-DR7hzXU4.d.mts.map
+//# sourceMappingURL=index-BR6lwlNv.d.mts.map

package/dist/index-BR6lwlNv.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-BR6lwlNv.d.mts","names":[],"sources":["../src/multithread/multithread.types.ts","../src/multithread/multithread.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/index-BfQSp6pV.d.mts

@@ -0,0 +1,226 @@
+import { f as RunnableFx, m as SyncFx } from "./fx.types-CpFKa-Jj.mjs";
+import { n as Layer } from "./layer.types-smjitsoN.mjs";
+
+//#region src/log/log.d.ts
+declare namespace log_d_exports {
+  export { ContextualLogger, Event, Fields, Level, Logger, console, context, emit, json, layer, withFields, withSpan };
+}
+/**
+ * Supported log event levels.
+ *
+ * @example
+ * ```ts
+ * import type { Log } from "@nicolastoulemont/std"
+ *
+ * const level: Log.Level = "info"
+ * ```
+ */
+type Level = "debug" | "info" | "warn" | "error";
+/**
+ * Structured fields attached to log events.
+ *
+ * @example
+ * ```ts
+ * import type { Log } from "@nicolastoulemont/std"
+ *
+ * const fields: Log.Fields = { requestId: "req_1" }
+ * ```
+ */
+type Fields = Record<string, unknown>;
+/**
+ * Concrete event delivered to installed logger backends.
+ *
+ * Events include merged contextual fields, active log spans, trace correlation
+ * when a current span exists, and the current fiber id.
+ *
+ * @example
+ * ```ts
+ * import type { Log } from "@nicolastoulemont/std"
+ *
+ * const logger: Log.Logger = {
+ *   log: (event) => {
+ *     globalThis.console.log(event.level, event.message, event.fields)
+ *   },
+ * }
+ * ```
+ */
+type Event = {
+  readonly timestamp: Date;
+  readonly level: Level;
+  readonly message: string;
+  readonly fields: Fields;
+  readonly logSpans: ReadonlyArray<{
+    readonly label: string;
+    readonly elapsedMs: number;
+  }>;
+  readonly trace: {
+    readonly traceId: string;
+    readonly spanId: string;
+    readonly spanName: string;
+  } | undefined;
+  readonly fiberId: number | undefined;
+};
+/**
+ * Logger backend installed through `Log.layer`.
+ *
+ * @example
+ * ```ts
+ * import type { Log } from "@nicolastoulemont/std"
+ *
+ * const events: Log.Event[] = []
+ * const logger: Log.Logger = { log: (event) => events.push(event) }
+ * ```
+ */
+type Logger = {
+  readonly log: (event: Event) => void;
+};
+/**
+ * Logger returned by `Log.context`.
+ *
+ * @example
+ * ```ts
+ * import { Fx, Log } from "@nicolastoulemont/std"
+ *
+ * const program = Fx.gen(function* () {
+ *   const log = yield* Log.context({ requestId: "req_1" })
+ *   yield* log.info("request received")
+ * })
+ * ```
+ */
+type ContextualLogger = {
+  readonly debug: (message: string, fields?: Fields) => SyncFx<void>;
+  readonly info: (message: string, fields?: Fields) => SyncFx<void>;
+  readonly warn: (message: string, fields?: Fields) => SyncFx<void>;
+  readonly error: (message: string, fields?: Fields) => SyncFx<void>;
+};
+type LogContextOptions = {
+  readonly logSpan?: string;
+};
+/**
+ * Emit one log event at the given level.
+ *
+ * The event is delivered to every logger installed in the current runtime state.
+ * Logger failures are swallowed so logging cannot fail the user program.
+ *
+ * @example
+ * ```ts
+ * import { Fx, Log, Provide } from "@nicolastoulemont/std"
+ *
+ * const program = Provide.layer(Log.layer(Log.console()))(
+ *   Fx.gen(function* () {
+ *     yield* Log.emit("info", "request received", { route: "/orders" })
+ *     return "ok"
+ *   }),
+ * )
+ *
+ * const exit = Fx.run(program)
+ * // => { _tag: "Ok", value: "ok" }
+ * ```
+ */
+declare const emit: (level: Level, message: string, fields?: Fields) => SyncFx<void>;
+/**
+ * Add log fields to the current runtime state and return a contextual logger.
+ *
+ * Fields are inherited by nested effects and merged into later log events.
+ * Passing `logSpan` also adds elapsed-time decoration to later log events.
+ *
+ * @example
+ * ```ts
+ * import { Fx, Log } from "@nicolastoulemont/std"
+ *
+ * const program = Fx.gen(function* () {
+ *   const log = yield* Log.context({ requestId: "req_1" }, { logSpan: "request" })
+ *   yield* log.info("loaded user", { userId: "user_1" })
+ *   return "ok"
+ * })
+ * ```
+ */
+declare const context: (fields: Fields, options?: LogContextOptions) => SyncFx<ContextualLogger>;
+/**
+ * Run an effect with additional log fields.
+ *
+ * @example
+ * ```ts
+ * import { Fx, Log } from "@nicolastoulemont/std"
+ *
+ * const program = Log.withFields({ service: "checkout" })(
+ *   Fx.gen(function* () {
+ *     yield* Log.emit("info", "started")
+ *     return "ok"
+ *   }),
+ * )
+ * ```
+ */
+declare const withFields: (fields: Fields) => <A, E, R>(fx: RunnableFx<A, E, R>) => RunnableFx<A, E, R>;
+/**
+ * Run an effect with an active log span.
+ *
+ * Log spans decorate log events with elapsed time. Use `Trace.span` when you
+ * need a real tracing span.
+ *
+ * @example
+ * ```ts
+ * import { Fx, Log } from "@nicolastoulemont/std"
+ *
+ * const program = Log.withSpan("load-user")(
+ *   Fx.gen(function* () {
+ *     yield* Log.emit("info", "loaded user")
+ *     return "user_1"
+ *   }),
+ * )
+ * ```
+ */
+declare const withSpan: (label: string) => <A, E, R>(fx: RunnableFx<A, E, R>) => RunnableFx<A, E, R>;
+/**
+ * Create a logger backend that writes events to `globalThis.console`.
+ *
+ * @example
+ * ```ts
+ * import { Fx, Log, Provide } from "@nicolastoulemont/std"
+ *
+ * const program = Provide.layer(Log.layer(Log.console()))(
+ *   Fx.gen(function* () {
+ *     yield* Log.emit("info", "hello")
+ *   }),
+ * )
+ * ```
+ */
+declare const console: () => Logger;
+/**
+ * Create a logger backend that writes JSON events to `globalThis.console.log`.
+ *
+ * @example
+ * ```ts
+ * import { Fx, Log, Provide } from "@nicolastoulemont/std"
+ *
+ * const program = Provide.layer(Log.layer(Log.json()))(
+ *   Fx.gen(function* () {
+ *     yield* Log.emit("info", "hello")
+ *   }),
+ * )
+ * ```
+ */
+declare const json: () => Logger;
+/**
+ * Install one or more logger backends in the current Fx runtime.
+ *
+ * @example
+ * ```ts
+ * import { Fx, Log, Provide } from "@nicolastoulemont/std"
+ *
+ * const events: Log.Event[] = []
+ * const program = Provide.layer(Log.layer({ log: (event) => events.push(event) }))(
+ *   Fx.gen(function* () {
+ *     yield* Log.emit("info", "stored")
+ *     return events.length
+ *   }),
+ * )
+ *
+ * const exit = Fx.run(program)
+ * // => { _tag: "Ok", value: 1 }
+ * ```
+ */
+declare const layer: (loggers: Logger | ReadonlyArray<Logger>) => Layer<never, never, never, true>;
+//#endregion
+export { log_d_exports as t };
+//# sourceMappingURL=index-BfQSp6pV.d.mts.map

package/dist/index-BfQSp6pV.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-BfQSp6pV.d.mts","names":[],"sources":["../src/log/log.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;KA6CY,KAAA;;;;;;;AAAZ;AAYA;AAmBA;;AAEkB,KArBN,MAAA,GAAS,MAqBH,CAAA,MAAA,EAAA,OAAA,CAAA;;;;AA4BlB;AAiBA;;;;;;;;;;AAKC;AA+CD;;AAA6D,KAnGjD,KAAA,GAmGiD;EAAS,SAAA,SAAA,EAlGhD,IAkGgD;EAAM,SAAA,KAAA,EAjG1D,KAiG0D;EAmE/D,SAAA,OA4BX,EAAA,MAAA;EA5B8B,SAAA,MAAA,EAlKb,MAkKa;EAAkB,SAAA,QAAA,EAjK7B,aAiK6B,CAAA;IAA2B,SAAA,KAAA,EAAA,MAAA;IAAP,SAAA,SAAA,EAAA,MAAA;EAAM,CAAA,CAAA;EA6C/D,SAAA,KASiB,EAAA;IARnB,SAAA,OAAA,EAAA,MAAA;IACgB,SAAA,MAAA,EAAA,MAAA;IAAG,SAAA,QAAA,EAAA,MAAA;EAAG,CAAA,GAAA,SAAA;EAAjB,SAAA,OAAA,EAAA,MAAA,GAAA,SAAA;CAAiC;;;;;AA2BjD;;;;;;;AAEuD,KApN3C,MAAA,GAoN2C;EAAjB,SAAA,GAAA,EAAA,CAAA,KAAA,EAnNd,KAmNc,EAAA,GAAA,IAAA;CAAU;AA0BhD;AAoBA;AAyBA;;;;;;;;;;;KA1QY,gBAAA;6CACiC,WAAW;4CACZ,WAAW;4CACX,WAAW;6CACV,WAAW;;KAGnD,iBAAA;;;;;;;;;;;;;;;;;;;;;;;;cA6CQ,cAAe,iCAAiC,WAAS;;;;;;;;;;;;;;;;;;cAmEzD,kBAAmB,kBAAkB,sBAAoB,OAAO;;;;;;;;;;;;;;;;cA6ChE,qBACF,yBACK,WAAW,GAAG,GAAG,OAAK,WAAW,GAAG,GAAG;;;;;;;;;;;;;;;;;;;cA2B1C,2CAEG,WAAW,GAAG,GAAG,OAAK,WAAW,GAAG,GAAG;;;;;;;;;;;;;;;cA0B1C,eAAc;;;;;;;;;;;;;;;cAoBd,YAAW;;;;;;;;;;;;;;;;;;;;cAyBX,iBAAkB,SAAS,cAAc,YAAU"}

package/dist/{index-uE3S3Krx.d.mts → index-Bo6pkkVO.d.mts}

@@ -1,7 +1,7 @@
-import { f as RunnableFx, m as SyncFx, t as AsyncFx } from "./fx.types-BdN1EWxr.mjs";
-import { t as ServiceClass } from "./service-D8mr0wwg.mjs";
-import { n as ScopeService, t as ExcludeScope } from "./scope-CuM3CzwG.mjs";
-import { a as UnprovidedDeps, i as MergeROut, n as Layer, r as MergeError, t as AllSync } from "./layer.types-BB0MrvLg.mjs";
+import { f as RunnableFx, m as SyncFx, t as AsyncFx } from "./fx.types-CpFKa-Jj.mjs";
+import { t as ServiceClass } from "./service-DIKUYHda.mjs";
+import { n as ScopeService, t as ExcludeScope } from "./scope-BQEFiS_2.mjs";
+import { a as UnprovidedDeps, i as MergeROut, n as Layer, r as MergeError, t as AllSync } from "./layer.types-smjitsoN.mjs";
 
 //#region src/layer/layer.d.ts
 declare namespace layer_d_exports {
@@ -242,4 +242,4 @@ declare const provide: typeof layerProvide;
 declare const merge: typeof layerMerge;
 //#endregion
 export { layer_d_exports as t };
-//# sourceMappingURL=index-uE3S3Krx.d.mts.map
+//# sourceMappingURL=index-Bo6pkkVO.d.mts.map

package/dist/{index-uE3S3Krx.d.mts.map → index-Bo6pkkVO.d.mts.map}

@@ -1 +1 @@
-{"version":3,"file":"index-uE3S3Krx.d.mts","names":[],"sources":["../src/layer/layer.ts"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"index-Bo6pkkVO.d.mts","names":[],"sources":["../src/layer/layer.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/{index-D8rDE60Y.d.mts → index-BsCrdweM.d.mts}

@@ -456,4 +456,4 @@ declare const sortWith: {
 declare const sortBy: <A>(...orders: readonly Order$1<A>[]) => (input: Iterable<A>) => A[];
 //#endregion
 export { order_d_exports as t };
-//# sourceMappingURL=index-D8rDE60Y.d.mts.map
+//# sourceMappingURL=index-BsCrdweM.d.mts.map

package/dist/index-BsCrdweM.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-BsCrdweM.d.mts","names":[],"sources":["../src/order/order.types.ts","../src/order/order.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/{index-D7mFNjot.d.mts → index-BtPFPfja.d.mts}

@@ -122,4 +122,4 @@ declare function pipe<A, B, C, D, E, F, G, H, I, J, K, L, M, N, O>(arg: A, f1: (
 declare function pipe<A, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P>(arg: A, f1: (arg: A) => B, f2: (arg: Awaited<B>) => C, f3: (arg: Awaited<C>) => D, f4: (arg: Awaited<D>) => E, f5: (arg: Awaited<E>) => F, f6: (arg: Awaited<F>) => G, f7: (arg: Awaited<G>) => H, f8: (arg: Awaited<H>) => I, f9: (arg: Awaited<I>) => J, f10: (arg: Awaited<J>) => K, f11: (arg: Awaited<K>) => L, f12: (arg: Awaited<L>) => M, f13: (arg: Awaited<M>) => N, f14: (arg: Awaited<N>) => O, f15: (arg: Awaited<O>) => P): PipeReturn<[typeof f1, typeof f2, typeof f3, typeof f4, typeof f5, typeof f6, typeof f7, typeof f8, typeof f9, typeof f10, typeof f11, typeof f12, typeof f13, typeof f14, typeof f15], A>;
 //#endregion
 export { flow as n, pipe as t };
-//# sourceMappingURL=index-D7mFNjot.d.mts.map
+//# sourceMappingURL=index-BtPFPfja.d.mts.map