@ac-kit/core 0.1.0

package/dist/error/buffer-overflow-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffer-overflow-error.js","sourceRoot":"","sources":["../../src/error/buffer-overflow-error.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC7C,YAAY,OAAgB,EAAE,OAAsB;QACnD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACnC,CAAC;CACD"}

package/dist/error/capture-stack-trace.d.ts

@@ -0,0 +1,33 @@
+import { StackTrace } from "./parse-error-stack.js";
+export type CaptureStackTraceOptions = {
+    /**
+     * A function to use as the reference point for the stack trace.
+     *
+     * The stack frames above the function will be skipped (including the function
+     * itself).
+     *
+     * Defaults to the `captureStackTrace` function itself.
+     */
+    reference?: Function;
+    /**
+     * Maximum number of stack frames to capture. This is not supported in all
+     * environments.
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error/stackTraceLimit
+     *
+     * Defaults to `Infinity`.
+     */
+    maxFrames?: number;
+};
+/**
+ * Capture the stack trace of the caller.
+ *
+ * Uses V8's `Error.captureStackTrace` when available (Node.js, Chrome) and
+ * falls back to parsing `new Error().stack` on other engines. The fallback
+ * filters frames by function name, which is best-effort in minified code.
+ *
+ * @returns An array of strings representing the stack trace, or `[]` if
+ *   unavailable
+ */
+export declare function captureStackTrace(options?: CaptureStackTraceOptions): StackTrace;
+//# sourceMappingURL=capture-stack-trace.d.ts.map

package/dist/error/capture-stack-trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-stack-trace.d.ts","sourceRoot":"","sources":["../../src/error/capture-stack-trace.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAmB,MAAM,wBAAwB,CAAC;AAErE,MAAM,MAAM,wBAAwB,GAAG;IACtC;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,QAAQ,CAAC;IAErB;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAChC,OAAO,CAAC,EAAE,wBAAwB,GAChC,UAAU,CA6BZ"}

package/dist/error/capture-stack-trace.js

@@ -0,0 +1,38 @@
+import { captureV8Frames } from "./capture-v8-frames.js";
+import { parseErrorStack } from "./parse-error-stack.js";
+/**
+ * Capture the stack trace of the caller.
+ *
+ * Uses V8's `Error.captureStackTrace` when available (Node.js, Chrome) and
+ * falls back to parsing `new Error().stack` on other engines. The fallback
+ * filters frames by function name, which is best-effort in minified code.
+ *
+ * @returns An array of strings representing the stack trace, or `[]` if
+ *   unavailable
+ */
+export function captureStackTrace(options) {
+    const reference = options?.reference ?? captureStackTrace;
+    const maxFrames = options?.maxFrames ?? Infinity;
+    const stack = captureV8Frames({ reference, maxFrames });
+    if (stack !== undefined) {
+        // V8/Node.js/Chrome path: accurate frame stripping via the reference arg
+        const errorStack = parseErrorStack({ stack });
+        return errorStack ? errorStack.stackTrace : [];
+    }
+    // Non-V8 fallback (Firefox, Safari): parse new Error().stack and strip
+    // frames up to and including the reference function by name.
+    const errorStack = parseErrorStack(new Error());
+    if (!errorStack) {
+        return [];
+    }
+    let frames = errorStack.stackTrace;
+    const refFn = reference;
+    if (refFn.name) {
+        const refIndex = frames.findIndex((frame) => frame.includes(refFn.name));
+        if (refIndex !== -1) {
+            frames = frames.slice(refIndex + 1);
+        }
+    }
+    return maxFrames === Infinity ? frames : frames.slice(0, maxFrames);
+}
+//# sourceMappingURL=capture-stack-trace.js.map

package/dist/error/capture-stack-trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-stack-trace.js","sourceRoot":"","sources":["../../src/error/capture-stack-trace.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAc,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAwBrE;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB,CAChC,OAAkC;IAElC,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,iBAAiB,CAAC;IAC1D,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,QAAQ,CAAC;IAEjD,MAAM,KAAK,GAAG,eAAe,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC;IACxD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACzB,yEAAyE;QACzE,MAAM,UAAU,GAAG,eAAe,CAAC,EAAE,KAAK,EAAY,CAAC,CAAC;QACxD,OAAO,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;IAChD,CAAC;IAED,uEAAuE;IACvE,6DAA6D;IAC7D,MAAM,UAAU,GAAG,eAAe,CAAC,IAAK,KAA0B,EAAE,CAAC,CAAC;IACtE,IAAI,CAAC,UAAU,EAAE,CAAC;QACjB,OAAO,EAAE,CAAC;IACX,CAAC;IAED,IAAI,MAAM,GAAG,UAAU,CAAC,UAAU,CAAC;IAEnC,MAAM,KAAK,GAAG,SAAS,CAAC;IACxB,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QAChB,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QACzE,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC;YACrB,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;QACrC,CAAC;IACF,CAAC;IAED,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;AACrE,CAAC"}

package/dist/error/capture-v8-frames.d.ts

@@ -0,0 +1,20 @@
+import type { V8CallSite } from "../types/v8-call-site.js";
+export type CaptureV8FramesOptions<T> = {
+    reference: Function;
+    maxFrames: number;
+    prepareStackTrace?: (error: Error, callSites: V8CallSite[]) => T;
+};
+/**
+ * Low-level V8 stack capture shared by `captureStackTrace` and
+ * `captureV8StackTrace`.
+ *
+ * Relies on `Error.captureStackTrace(target, reference)` for native,
+ * reference-based frame stripping (accurate even for anonymous/minified
+ * functions, unlike name matching), then reads `target.stack` — either as the
+ * engine's default formatted string, or via a `prepareStackTrace` hook for
+ * structured call sites.
+ *
+ * @returns `undefined` when the engine has no V8 stack trace API.
+ */
+export declare function captureV8Frames<T = string>(options: CaptureV8FramesOptions<T>): T | undefined;
+//# sourceMappingURL=capture-v8-frames.d.ts.map

package/dist/error/capture-v8-frames.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-v8-frames.d.ts","sourceRoot":"","sources":["../../src/error/capture-v8-frames.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3D,MAAM,MAAM,sBAAsB,CAAC,CAAC,IAAI;IAEvC,SAAS,EAAE,QAAQ,CAAC;IAGpB,SAAS,EAAE,MAAM,CAAC;IAIlB,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;CACjE,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,CAAC,GAAG,MAAM,EACzC,OAAO,EAAE,sBAAsB,CAAC,CAAC,CAAC,GAChC,CAAC,GAAG,SAAS,CA+Bf"}

package/dist/error/capture-v8-frames.js

@@ -0,0 +1,42 @@
+import { isV8ErrorConstructor } from "../guards/is-v8-error-constructor.js";
+/**
+ * Low-level V8 stack capture shared by `captureStackTrace` and
+ * `captureV8StackTrace`.
+ *
+ * Relies on `Error.captureStackTrace(target, reference)` for native,
+ * reference-based frame stripping (accurate even for anonymous/minified
+ * functions, unlike name matching), then reads `target.stack` — either as the
+ * engine's default formatted string, or via a `prepareStackTrace` hook for
+ * structured call sites.
+ *
+ * @returns `undefined` when the engine has no V8 stack trace API.
+ */
+export function captureV8Frames(options) {
+    if (!isV8ErrorConstructor(Error)) {
+        return undefined;
+    }
+    const tmp = {};
+    const originalStackTraceLimit = Error.stackTraceLimit;
+    Error.stackTraceLimit = options.maxFrames;
+    const originalPrepareStackTrace = Error.prepareStackTrace;
+    const prepareStackTrace = options.prepareStackTrace;
+    if (prepareStackTrace) {
+        // A custom prepareStackTrace replaces the engine's default formatter for
+        // every error read while it is installed, not just `tmp` — fall back to
+        // the previous hook, or V8's own per-frame formatting, for the rest.
+        Error.prepareStackTrace = (error, callSites) => error === tmp
+            ? prepareStackTrace(error, callSites)
+            : (originalPrepareStackTrace?.(error, callSites) ??
+                // oxlint-disable-next-line typescript/no-base-to-string
+                `${error}\n${callSites.map((callSite) => `    at ${callSite.toString()}`).join("\n")}`);
+    }
+    try {
+        Error.captureStackTrace(tmp, options.reference);
+        return tmp.stack;
+    }
+    finally {
+        Error.prepareStackTrace = originalPrepareStackTrace;
+        Error.stackTraceLimit = originalStackTraceLimit;
+    }
+}
+//# sourceMappingURL=capture-v8-frames.js.map

package/dist/error/capture-v8-frames.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-v8-frames.js","sourceRoot":"","sources":["../../src/error/capture-v8-frames.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAe5E;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,eAAe,CAC9B,OAAkC;IAElC,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,EAAE,CAAC;QAClC,OAAO,SAAS,CAAC;IAClB,CAAC;IAED,MAAM,GAAG,GAAG,EAAkB,CAAC;IAE/B,MAAM,uBAAuB,GAAG,KAAK,CAAC,eAAe,CAAC;IACtD,KAAK,CAAC,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC;IAE1C,MAAM,yBAAyB,GAAG,KAAK,CAAC,iBAAiB,CAAC;IAC1D,MAAM,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IACpD,IAAI,iBAAiB,EAAE,CAAC;QACvB,yEAAyE;QACzE,wEAAwE;QACxE,qEAAqE;QACrE,KAAK,CAAC,iBAAiB,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,CAC7C,KAAiB,KAAK,GAAG;YACzB,CAAC,CAAC,iBAAiB,CAAC,KAAK,EAAE,SAAoC,CAAC;YAChE,CAAC,CAAC,CAAC,yBAAyB,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC;gBAC/C,wDAAwD;gBACxD,GAAG,KAAK,KAAK,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,UAAU,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5F,CAAC;IAED,IAAI,CAAC;QACJ,KAAK,CAAC,iBAAiB,CAAC,GAAG,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QAChD,OAAO,GAAG,CAAC,KAAK,CAAC;IAClB,CAAC;YAAS,CAAC;QACV,KAAK,CAAC,iBAAiB,GAAG,yBAAyB,CAAC;QACpD,KAAK,CAAC,eAAe,GAAG,uBAAuB,CAAC;IACjD,CAAC;AACF,CAAC"}

package/dist/error/capture-v8-stack-trace.d.ts

@@ -0,0 +1,28 @@
+import { type V8StackTrace } from "./v8-stack-trace.js";
+export type CaptureV8StackTraceOptions = {
+    /**
+     * A function to use as the reference point for the stack trace.
+     *
+     * The stack frames above the function will be skipped (including the function
+     * itself).
+     *
+     * Defaults to the `captureV8StackTrace` function itself.
+     */
+    reference?: Function;
+    /**
+     * Maximum number of stack frames to capture.
+     *
+     * Defaults to `Infinity`.
+     */
+    maxFrames?: number;
+};
+/**
+ * Capture the stack trace of the caller as structured V8 call site data
+ * (function references, file/line/column, async/native/constructor flags).
+ *
+ * V8-only (Node.js, Chrome, and other V8 embedders) — no fallback.
+ *
+ * @returns The captured stack trace, or `[]` if unavailable.
+ */
+export declare function captureV8StackTrace(options?: CaptureV8StackTraceOptions): V8StackTrace;
+//# sourceMappingURL=capture-v8-stack-trace.d.ts.map

package/dist/error/capture-v8-stack-trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-v8-stack-trace.d.ts","sourceRoot":"","sources":["../../src/error/capture-v8-stack-trace.ts"],"names":[],"mappings":"AACA,OAAO,EAEN,KAAK,YAAY,EACjB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,MAAM,0BAA0B,GAAG;IACxC;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,QAAQ,CAAC;IAErB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAClC,OAAO,CAAC,EAAE,0BAA0B,GAClC,YAAY,CAWd"}

package/dist/error/capture-v8-stack-trace.js

@@ -0,0 +1,21 @@
+import { captureV8Frames } from "./capture-v8-frames.js";
+import { composeV8StackFrameFromV8CallSite, } from "./v8-stack-trace.js";
+/**
+ * Capture the stack trace of the caller as structured V8 call site data
+ * (function references, file/line/column, async/native/constructor flags).
+ *
+ * V8-only (Node.js, Chrome, and other V8 embedders) — no fallback.
+ *
+ * @returns The captured stack trace, or `[]` if unavailable.
+ */
+export function captureV8StackTrace(options) {
+    const reference = options?.reference ?? captureV8StackTrace;
+    const maxFrames = options?.maxFrames ?? Infinity;
+    const callSites = captureV8Frames({
+        reference,
+        maxFrames,
+        prepareStackTrace: (_error, stackTrace) => stackTrace,
+    });
+    return callSites ? callSites.map(composeV8StackFrameFromV8CallSite) : [];
+}
+//# sourceMappingURL=capture-v8-stack-trace.js.map

package/dist/error/capture-v8-stack-trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-v8-stack-trace.js","sourceRoot":"","sources":["../../src/error/capture-v8-stack-trace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EACN,iCAAiC,GAEjC,MAAM,qBAAqB,CAAC;AAqB7B;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAClC,OAAoC;IAEpC,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,mBAAmB,CAAC;IAC5D,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,QAAQ,CAAC;IAEjD,MAAM,SAAS,GAAG,eAAe,CAAC;QACjC,SAAS;QACT,SAAS;QACT,iBAAiB,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,CAAC,UAAU;KACrD,CAAC,CAAC;IAEH,OAAO,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC1E,CAAC"}

package/dist/error/format-error-stack.d.ts

@@ -0,0 +1,25 @@
+import { ErrorStack } from "./parse-error-stack.js";
+export type FormatStackTraceOptions = {
+    /**
+     * The indentation to use for each line (except first line).
+     *
+     * Defaults to two spaces.
+     */
+    indentation?: string;
+    /**
+     * If true, the error message line will be ignored and not included in the
+     * output.
+     *
+     * Defaults to false.
+     */
+    skipMessage?: boolean;
+};
+/**
+ * Format an error stack back to its original form.
+ *
+ * @param errorStack The error stack to format
+ * @param options Options for formatting the stack trace
+ * @returns The formatted error stack as an array of strings (one per line)
+ */
+export declare function formatErrorStack(errorStack: ErrorStack, options?: FormatStackTraceOptions): string[];
+//# sourceMappingURL=format-error-stack.d.ts.map

package/dist/error/format-error-stack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-error-stack.d.ts","sourceRoot":"","sources":["../../src/error/format-error-stack.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,MAAM,MAAM,uBAAuB,GAAG;IACrC;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC/B,UAAU,EAAE,UAAU,EACtB,OAAO,CAAC,EAAE,uBAAuB,GAC/B,MAAM,EAAE,CAgBV"}

package/dist/error/format-error-stack.js

@@ -0,0 +1,24 @@
+import { prefixLines } from "../string/prefix-lines.js";
+/**
+ * Format an error stack back to its original form.
+ *
+ * @param errorStack The error stack to format
+ * @param options Options for formatting the stack trace
+ * @returns The formatted error stack as an array of strings (one per line)
+ */
+export function formatErrorStack(errorStack, options) {
+    const indentation = options?.indentation ?? "  ";
+    const skipMessage = options?.skipMessage;
+    let lines;
+    if (skipMessage) {
+        lines = [];
+    }
+    else {
+        lines = [errorStack.message];
+    }
+    lines.push(...errorStack.stackTrace);
+    return prefixLines(lines, indentation, {
+        skipFirstLine: !skipMessage,
+    });
+}
+//# sourceMappingURL=format-error-stack.js.map

package/dist/error/format-error-stack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-error-stack.js","sourceRoot":"","sources":["../../src/error/format-error-stack.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAoBxD;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAC/B,UAAsB,EACtB,OAAiC;IAEjC,MAAM,WAAW,GAAG,OAAO,EAAE,WAAW,IAAI,IAAI,CAAC;IACjD,MAAM,WAAW,GAAG,OAAO,EAAE,WAAW,CAAC;IAEzC,IAAI,KAAe,CAAC;IACpB,IAAI,WAAW,EAAE,CAAC;QACjB,KAAK,GAAG,EAAE,CAAC;IACZ,CAAC;SAAM,CAAC;QACP,KAAK,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;IAErC,OAAO,WAAW,CAAC,KAAK,EAAE,WAAW,EAAE;QACtC,aAAa,EAAE,CAAC,WAAW;KAC3B,CAAC,CAAC;AACJ,CAAC"}

package/dist/error/format-error.d.ts

@@ -0,0 +1,31 @@
+export type FormatErrorOptions = {
+    prefix?: string;
+    skipCause?: boolean;
+    skipAggregateErrors?: boolean;
+    skipSuppressedError?: boolean;
+    skipSuppressedSuppressed?: boolean;
+    hideErrorName?: boolean;
+    stringifier?: (value: unknown) => string;
+    stackTrace?: boolean | "top-level-only";
+    indentation?: string;
+    lineSeparator?: string;
+};
+/**
+ * Format errors and other values into a single string.
+ *
+ * This function can handle nested causes and aggregated errors, formatting them
+ * recursively. It also allows customization of the output format through
+ * various options.
+ *
+ * The default options can be overridden by setting the
+ * `formatError.defaultOptions` property.
+ *
+ * @param error The error or value to format
+ * @param options Options for formatting the error
+ * @returns The formatted error as a string
+ */
+export declare function formatError(error: unknown, options?: FormatErrorOptions): string;
+export declare namespace formatError {
+    var defaultOptions: Required<FormatErrorOptions>;
+}
+//# sourceMappingURL=format-error.d.ts.map

package/dist/error/format-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-error.d.ts","sourceRoot":"","sources":["../../src/error/format-error.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,kBAAkB,GAAG;IAQhC,MAAM,CAAC,EAAE,MAAM,CAAC;IAUhB,SAAS,CAAC,EAAE,OAAO,CAAC;IAQpB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAQ9B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAU9B,wBAAwB,CAAC,EAAE,OAAO,CAAC;IAQnC,aAAa,CAAC,EAAE,OAAO,CAAC;IAKxB,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAC;IAYzC,UAAU,CAAC,EAAE,OAAO,GAAG,gBAAgB,CAAC;IAKxC,WAAW,CAAC,EAAE,MAAM,CAAC;IAKrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAC1B,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,kBAAkB,GAC1B,MAAM,CAgBR;AA4JD,MAAM,CAAC,OAAO,WAAW,WAAW,CAAC;IAC7B,IAAI,cAAc,EAAE,QAAQ,CAAC,kBAAkB,CAAC,CAAC;CACxD"}

package/dist/error/format-error.js

@@ -0,0 +1,142 @@
+import { isAggregateErrorLike } from "../guards/is-aggregate-error.js";
+import { isErrorLike } from "../guards/is-error.js";
+import { isSuppressedErrorLike } from "../guards/is-suppressed-error.js";
+import { defaults } from "../object/defaults.js";
+import { joinNonEmpty } from "../string/join-non-empty.js";
+import { prefixLines } from "../string/prefix-lines.js";
+import { formatErrorStack } from "./format-error-stack.js";
+import { parseErrorStack } from "./parse-error-stack.js";
+/**
+ * Format errors and other values into a single string.
+ *
+ * This function can handle nested causes and aggregated errors, formatting them
+ * recursively. It also allows customization of the output format through
+ * various options.
+ *
+ * The default options can be overridden by setting the
+ * `formatError.defaultOptions` property.
+ *
+ * @param error The error or value to format
+ * @param options Options for formatting the error
+ * @returns The formatted error as a string
+ */
+export function formatError(error, options) {
+    const effectiveOptions = defaults(options, formatError.defaultOptions);
+    const isMultiline = effectiveOptions.stackTrace === true &&
+        (!effectiveOptions.skipCause || !effectiveOptions.skipAggregateErrors);
+    return internalFormatError(error, effectiveOptions, isMultiline, new Set()).join(effectiveOptions.lineSeparator);
+}
+function internalFormatError(error, options, isMultiline, visitedErrors) {
+    const firstLine = [];
+    const otherLines = [];
+    let currentError = error;
+    do {
+        if (isErrorLike(currentError)) {
+            const currentVisitedErrors = new Set(visitedErrors);
+            const circularReference = currentVisitedErrors.has(currentError);
+            currentVisitedErrors.add(currentError);
+            let messagePrefix;
+            if (!options.hideErrorName) {
+                messagePrefix = isMultiline
+                    ? `${currentError.name}: `
+                    : `<${currentError.name}> `;
+            }
+            firstLine.push(`${messagePrefix ?? ""}${currentError.message}${circularReference ? " [Circular]" : ""}`);
+            if (circularReference) {
+                break;
+            }
+            if ((options.stackTrace === true ||
+                (options.stackTrace === "top-level-only" &&
+                    currentError === error)) &&
+                currentError.stack) {
+                const errorStack = parseErrorStack(currentError);
+                if (errorStack) {
+                    otherLines.push(...formatErrorStack(errorStack, {
+                        indentation: options.indentation,
+                        skipMessage: true,
+                    }));
+                }
+            }
+            if (!options.skipAggregateErrors && isAggregateErrorLike(currentError)) {
+                const innerErrorsResult = currentError.errors.map((innerError, index) => internalFormatError(innerError, {
+                    ...options,
+                    prefix: `${isMultiline ? "Error " : ""}#${index + 1}`,
+                    stackTrace: options.stackTrace === true,
+                }, isMultiline, currentVisitedErrors));
+                if (isMultiline) {
+                    otherLines.push(...prefixLines(innerErrorsResult.flat(), options.indentation));
+                }
+                else {
+                    const innerErrorsString = joinNonEmpty(innerErrorsResult.map((innerErrorResult) => innerErrorResult[0]), ", ");
+                    if (innerErrorsString.length > 0) {
+                        firstLine.push(`(${innerErrorsString})`);
+                    }
+                }
+            }
+            if (isSuppressedErrorLike(currentError)) {
+                if (!options.skipSuppressedError && currentError.error) {
+                    const suppressedErrorResult = internalFormatError(currentError.error, {
+                        ...options,
+                        stackTrace: options.stackTrace === true,
+                    }, isMultiline, currentVisitedErrors);
+                    if (isMultiline) {
+                        otherLines.push(...prefixLines(suppressedErrorResult, options.indentation));
+                    }
+                    else {
+                        firstLine.push(`${suppressedErrorResult[0]}`);
+                    }
+                }
+                if (!options.skipSuppressedSuppressed && currentError.suppressed) {
+                    const suppressedErrorResult = internalFormatError(currentError.suppressed, {
+                        ...options,
+                        prefix: "Suppressed",
+                        stackTrace: options.stackTrace === true,
+                    }, isMultiline, currentVisitedErrors);
+                    if (isMultiline) {
+                        otherLines.push(...prefixLines(suppressedErrorResult, options.indentation));
+                    }
+                    else {
+                        firstLine.push(`(${suppressedErrorResult[0]})`);
+                    }
+                }
+            }
+            if (!options.skipCause) {
+                if (isMultiline && currentError.cause) {
+                    const causeResult = internalFormatError(currentError.cause, {
+                        ...options,
+                        prefix: "Caused by",
+                        stackTrace: options.stackTrace === true,
+                    }, isMultiline, currentVisitedErrors);
+                    otherLines.push(...prefixLines(causeResult, options.indentation));
+                    break;
+                }
+                currentError = currentError.cause;
+            }
+            else {
+                break;
+            }
+        }
+        else {
+            firstLine.push(options.stringifier(currentError));
+            break;
+        }
+    } while (currentError);
+    return [
+        `${options.prefix ? `${options.prefix}: ` : ""}${joinNonEmpty(firstLine, ": ")}`,
+        ...otherLines,
+    ];
+}
+/** Default options for formatError function. */
+formatError.defaultOptions = {
+    prefix: "",
+    skipCause: false,
+    skipAggregateErrors: false,
+    skipSuppressedError: false,
+    skipSuppressedSuppressed: false,
+    hideErrorName: false,
+    stringifier: (value) => typeof value === "string" ? value : (JSON.stringify(value) ?? ""),
+    stackTrace: false,
+    indentation: "  ",
+    lineSeparator: "\n",
+};
+//# sourceMappingURL=format-error.js.map

package/dist/error/format-error.js.map

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

package/dist/error/parse-error-stack.d.ts

@@ -0,0 +1,26 @@
+import { IError } from "../types/error.js";
+export type StackFrame = string;
+export type StackTrace = StackFrame[];
+export type ErrorStack = {
+    message: string;
+    stackTrace: StackTrace;
+};
+/**
+ * A location in source code — what a V8 `CallSite` already exposes. Not yet
+ * produced by `parseErrorStack`, which still leaves each frame an unparsed
+ * `StackFrame` string; a future structured variant would return these.
+ */
+export type SourceLocation = {
+    readonly file: string;
+    readonly line?: number;
+    readonly column?: number;
+    readonly functionName?: string;
+};
+/**
+ * Parse the stack of an Error-like object into its components.
+ *
+ * @param error The error to parse
+ * @returns The parsed error stack, or undefined if the error has no stack
+ */
+export declare function parseErrorStack(error: IError): ErrorStack | undefined;
+//# sourceMappingURL=parse-error-stack.d.ts.map

package/dist/error/parse-error-stack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-error-stack.d.ts","sourceRoot":"","sources":["../../src/error/parse-error-stack.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAI3C,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC;AAIhC,MAAM,MAAM,UAAU,GAAG,UAAU,EAAE,CAAC;AAItC,MAAM,MAAM,UAAU,GAAG;IAIxB,OAAO,EAAE,MAAM,CAAC;IAKhB,UAAU,EAAE,UAAU,CAAC;CACvB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAUrE"}

package/dist/error/parse-error-stack.js

@@ -0,0 +1,16 @@
+/**
+ * Parse the stack of an Error-like object into its components.
+ *
+ * @param error The error to parse
+ * @returns The parsed error stack, or undefined if the error has no stack
+ */
+export function parseErrorStack(error) {
+    if (!error.stack) {
+        return;
+    }
+    const [message, ...stackTrace] = error.stack
+        .split(/\r?\n/)
+        .map((line) => line.trim());
+    return { message: message, stackTrace };
+}
+//# sourceMappingURL=parse-error-stack.js.map

package/dist/error/parse-error-stack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-error-stack.js","sourceRoot":"","sources":["../../src/error/parse-error-stack.ts"],"names":[],"mappings":"AAoCA;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa;IAC5C,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QAClB,OAAO;IACR,CAAC;IAED,MAAM,CAAC,OAAO,EAAE,GAAG,UAAU,CAAC,GAAG,KAAK,CAAC,KAAK;SAC1C,KAAK,CAAC,OAAO,CAAC;SACd,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAE7B,OAAO,EAAE,OAAO,EAAE,OAAQ,EAAE,UAAU,EAAE,CAAC;AAC1C,CAAC"}

package/dist/error/reject-out-of-band.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Surfaces `error` as an unhandled rejection, so a rejection stays a rejection
+ * rather than being promoted to an exception.
+ *
+ * @param error The error to surface as an unhandled rejection.
+ */
+export declare function rejectOutOfBand(error: unknown): void;
+//# sourceMappingURL=reject-out-of-band.d.ts.map

package/dist/error/reject-out-of-band.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reject-out-of-band.d.ts","sourceRoot":"","sources":["../../src/error/reject-out-of-band.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAIpD"}

package/dist/error/reject-out-of-band.js

@@ -0,0 +1,12 @@
+/**
+ * Surfaces `error` as an unhandled rejection, so a rejection stays a rejection
+ * rather than being promoted to an exception.
+ *
+ * @param error The error to surface as an unhandled rejection.
+ */
+export function rejectOutOfBand(error) {
+    queueMicrotask(() => {
+        void Promise.reject(error);
+    });
+}
+//# sourceMappingURL=reject-out-of-band.js.map

package/dist/error/reject-out-of-band.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reject-out-of-band.js","sourceRoot":"","sources":["../../src/error/reject-out-of-band.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC7C,cAAc,CAAC,GAAG,EAAE;QACnB,KAAK,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/dist/error/throw-out-of-band.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Surfaces `error` as an uncaught exception without disturbing the current
+ * execution flow.
+ *
+ * @param error The error to surface as an uncaught exception.
+ */
+export declare function throwOutOfBand(error: unknown): void;
+//# sourceMappingURL=throw-out-of-band.d.ts.map

package/dist/error/throw-out-of-band.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"throw-out-of-band.d.ts","sourceRoot":"","sources":["../../src/error/throw-out-of-band.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAInD"}

package/dist/error/throw-out-of-band.js

@@ -0,0 +1,12 @@
+/**
+ * Surfaces `error` as an uncaught exception without disturbing the current
+ * execution flow.
+ *
+ * @param error The error to surface as an uncaught exception.
+ */
+export function throwOutOfBand(error) {
+    queueMicrotask(() => {
+        throw error;
+    });
+}
+//# sourceMappingURL=throw-out-of-band.js.map

package/dist/error/throw-out-of-band.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"throw-out-of-band.js","sourceRoot":"","sources":["../../src/error/throw-out-of-band.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc;IAC5C,cAAc,CAAC,GAAG,EAAE;QACnB,MAAM,KAAK,CAAC;IACb,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/dist/error/traverse-error.d.ts

@@ -0,0 +1,26 @@
+import { IError } from "../types/error.js";
+export type TraverseErrorOptions = {
+    traverseCause?: boolean;
+    traverseAggregateErrors?: boolean;
+    traverseSuppressedError?: boolean;
+    traverseSuppressedSuppressed?: boolean;
+    skipNullErrors?: boolean;
+};
+export type TraverseErrorSource = "cause" | "aggregate-errors" | "suppressed-error" | "suppressed-suppressed";
+export type TraverseErrorCallback = (currentError: unknown, // the error currently being visited
+parentError: IError | null, // the parent error, if any
+source: TraverseErrorSource | null) => boolean | undefined;
+/**
+ * Traverse an error and its inner errors, calling a callback for each error
+ * encountered.
+ *
+ * The traversal can be stopped at any time by returning false from the
+ * callback.
+ *
+ * @param error - The root error to traverse.
+ * @param callback - A function called for each error encountered. If it returns
+ *   false, the traversal stops.
+ * @param options - Options to control the traversal behavior.
+ */
+export declare function traverseError(error: unknown, callback: TraverseErrorCallback, options?: TraverseErrorOptions): void;
+//# sourceMappingURL=traverse-error.d.ts.map

package/dist/error/traverse-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traverse-error.d.ts","sourceRoot":"","sources":["../../src/error/traverse-error.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,MAAM,MAAM,oBAAoB,GAAG;IAElC,aAAa,CAAC,EAAE,OAAO,CAAC;IAGxB,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAGlC,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAGlC,4BAA4B,CAAC,EAAE,OAAO,CAAC;IAGvC,cAAc,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAC5B,OAAO,GACP,kBAAkB,GAClB,kBAAkB,GAClB,uBAAuB,CAAC;AAE3B,MAAM,MAAM,qBAAqB,GAAG,CACnC,YAAY,EAAE,OAAO,EAAE,oCAAoC;AAC3D,WAAW,EAAE,MAAM,GAAG,IAAI,EAAE,2BAA2B;AACvD,MAAM,EAAE,mBAAmB,GAAG,IAAI,KAC9B,OAAO,GAAG,SAAS,CAAC;AAEzB;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC5B,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,qBAAqB,EAC/B,OAAO,CAAC,EAAE,oBAAoB,GAC5B,IAAI,CAUN"}