@powerlines/core 0.0.8

package/dist/types/fs.d.mts

@@ -0,0 +1,502 @@
+import { MaybePromise } from "@stryke/types/base";
+import { AssetGlob } from "@stryke/types/file";
+import { ResolveOptions as ResolveOptions$1 } from "@stryke/fs/resolve";
+
+//#region src/types/fs.d.ts
+type VirtualFileExtension = "js" | "ts" | "jsx" | "tsx";
+declare const __VFS_PATCH__ = "__VFS_PATCH__";
+declare const __VFS_REVERT__ = "__VFS_REVERT__";
+type StoragePreset = "fs" | "virtual";
+declare const STORAGE_PRESETS: StoragePreset[];
+/**
+ * Interface defining the methods and properties for a storage adapter.
+ */
+interface StorageAdapter {
+  /**
+   * A name identifying the storage adapter type.
+   */
+  name: string;
+  /**
+   * The storage preset for the adapter.
+   *
+   * @remarks
+   * This can be used as an alternate way to identify the type of storage being used.
+   */
+  preset?: StoragePreset | null;
+  /**
+   * Checks if a key exists in the storage.
+   *
+   * @param key - The key to check for existence.
+   * @returns A promise that resolves to `true` if the key exists, otherwise `false`.
+   */
+  exists: (key: string) => Promise<boolean>;
+  /**
+   * Synchronously checks if a key exists in the storage.
+   *
+   * @param key - The key to check for existence.
+   * @returns Returns `true` if the key exists, otherwise `false`.
+   */
+  existsSync: (key: string) => boolean;
+  /**
+   * Read a value associated with a key from the storage.
+   *
+   * @param key - The key to read the value for.
+   * @returns A promise that resolves to the value if found, otherwise `null`.
+   */
+  get: (key: string) => Promise<string | null>;
+  /**
+   * Synchronously reads the value associated with a key from the storage.
+   *
+   * @param key - The key to read the value for.
+   * @returns The value if found, otherwise `null`.
+   */
+  getSync: (key: string) => string | null;
+  /**
+   * Writes a value to the storage for the given key.
+   *
+   * @param key - The key to associate the value with.
+   * @param value - The value to store.
+   */
+  set: (key: string, value: string) => Promise<void>;
+  /**
+   * Synchronously writes a value to the storage for the given key.
+   *
+   * @param key - The key to associate the value with.
+   * @param value - The value to store.
+   */
+  setSync: (key: string, value: string) => void;
+  /**
+   * Removes a value from the storage.
+   *
+   * @param key - The key whose value should be removed.
+   */
+  remove: (key: string) => Promise<void>;
+  /**
+   * Synchronously removes a value from the storage.
+   *
+   * @param key - The key whose value should be removed.
+   */
+  removeSync: (key: string) => void;
+  /**
+   * Creates a directory at the specified path.
+   *
+   * @param dirPath - The path of the directory to create.
+   */
+  mkdir: (dirPath: string) => Promise<void>;
+  /**
+   * Synchronously creates a directory at the specified path.
+   *
+   * @param dirPath - The path of the directory to create.
+   */
+  mkdirSync: (dirPath: string) => void;
+  /**
+   * Remove all entries from the storage that match the provided base path.
+   *
+   * @param base - The base path or prefix to clear entries from.
+   */
+  clear: (base?: string) => Promise<void>;
+  /**
+   * Synchronously remove all entries from the storage that match the provided base path.
+   *
+   * @param base - The base path or prefix to clear entries from.
+   */
+  clearSync: (base?: string) => void;
+  /**
+   * Lists all keys under the provided base path.
+   *
+   * @param base - The base path or prefix to list keys from.
+   * @returns A promise resolving to the list of keys.
+   */
+  list: (base?: string) => Promise<string[]>;
+  /**
+   * Synchronously lists all keys under the provided base path.
+   *
+   * @param base - The base path or prefix to list keys from.
+   * @returns The list of keys.
+   */
+  listSync: (base?: string) => string[];
+  /**
+   * Checks if the given key is a directory.
+   *
+   * @param key - The key to check.
+   * @returns A promise that resolves to `true` if the key is a directory, otherwise `false`.
+   */
+  isDirectory: (key: string) => Promise<boolean>;
+  /**
+   * Synchronously checks if the given key is a directory.
+   *
+   * @param key - The key to check.
+   * @returns `true` if the key is a directory, otherwise `false`.
+   */
+  isDirectorySync: (key: string) => boolean;
+  /**
+   * Checks if the given key is a file.
+   *
+   * @param key - The key to check.
+   * @returns A promise that resolves to `true` if the key is a file, otherwise `false`.
+   */
+  isFile: (key: string) => Promise<boolean>;
+  /**
+   * Synchronously checks if the given key is a file.
+   *
+   * @param key - The key to check.
+   * @returns `true` if the key is a file, otherwise `false`.
+   */
+  isFileSync: (key: string) => boolean;
+  /**
+   * Releases any resources held by the storage adapter.
+   */
+  dispose: () => MaybePromise<void>;
+}
+/**
+ * A mapping of file paths to storage adapter names and their corresponding {@link StorageAdapter} instances.
+ */
+type StoragePort = Record<string, StorageAdapter>;
+interface VirtualFileMetadata {
+  /**
+   * The identifier for the file data.
+   */
+  id: string;
+  /**
+   * The timestamp of the virtual file.
+   */
+  timestamp: number;
+  /**
+   * The type of the file.
+   *
+   * @remarks
+   * This string represents the purpose/function of the file in the virtual file system. A potential list of variants includes:
+   * - `builtin`: Indicates that the file is a built-in module provided by the system.
+   * - `entry`: Indicates that the file is an entry point for execution.
+   * - `normal`: Indicates that the file is a standard file without any special role.
+   */
+  type: string;
+  /**
+   * Additional metadata associated with the file.
+   */
+  properties: Record<string, string | undefined>;
+}
+interface VirtualFileData {
+  /**
+   * The identifier for the file data.
+   */
+  id?: string;
+  /**
+   * The contents of the virtual file.
+   */
+  code: string;
+  /**
+   * The type of the file.
+   *
+   * @remarks
+   * This string represents the purpose/function of the file in the virtual file system. A potential list of variants includes:
+   * - `builtin`: Indicates that the file is a built-in module provided by the system.
+   * - `entry`: Indicates that the file is an entry point for execution.
+   * - `normal`: Indicates that the file is a standard file without any special role.
+   */
+  type?: string;
+  /**
+   * Additional metadata associated with the file.
+   */
+  properties?: Record<string, string | undefined>;
+}
+interface VirtualFile extends Required<VirtualFileData>, VirtualFileMetadata {
+  /**
+   * An additional name for the file.
+   */
+  path: string;
+  /**
+   * The timestamp of the virtual file.
+   */
+  timestamp: number;
+}
+interface WriteOptions {
+  /**
+   * Should the file skip formatting before being written?
+   *
+   * @defaultValue false
+   */
+  skipFormat?: boolean;
+  /**
+   * The storage preset or adapter name for the output file.
+   *
+   * @remarks
+   * If not specified, the output mode will be determined by the provided `output.mode` value.
+   */
+  storage?: StoragePreset | string;
+  /**
+   * Additional metadata for the file.
+   */
+  meta?: Partial<VirtualFileMetadata>;
+}
+type WriteData = string | NodeJS.ArrayBufferView | VirtualFileData;
+interface ResolveOptions extends ResolveOptions$1 {
+  /**
+   * If true, the module is being resolved as an entry point.
+   */
+  isEntry?: boolean;
+  /**
+   * If true, the resolver will skip alias resolution when resolving modules.
+   */
+  skipAlias?: boolean;
+  /**
+   * If true, the resolver will skip using the cache when resolving modules.
+   */
+  skipCache?: boolean;
+  /**
+   * An array of external modules or patterns to exclude from resolution.
+   */
+  external?: (string | RegExp)[];
+  /**
+   * An array of modules or patterns to include in the resolution, even if they are marked as external.
+   */
+  noExternal?: (string | RegExp)[];
+  /**
+   * An array of patterns to match when resolving modules.
+   */
+  skipNodeModulesBundle?: boolean;
+}
+interface VirtualFileSystemInterface {
+  /**
+   * The underlying file metadata.
+   */
+  metadata: Readonly<Record<string, VirtualFileMetadata>>;
+  /**
+   * A map of file paths to their module ids.
+   */
+  ids: Readonly<Record<string, string>>;
+  /**
+   * A map of module ids to their file paths.
+   */
+  paths: Readonly<Record<string, string>>;
+  /**
+   * Checks if a file exists in the virtual file system (VFS).
+   *
+   * @param path - The path or id of the file.
+   * @returns `true` if the file exists, otherwise `false`.
+   */
+  exists: (path: string) => Promise<boolean>;
+  /**
+   * Synchronously Checks if a file exists in the virtual file system (VFS).
+   *
+   * @param path - The path or id of the file.
+   * @returns `true` if the file exists, otherwise `false`.
+   */
+  existsSync: (path: string) => boolean;
+  /**
+   * Checks if a file is virtual in the virtual file system (VFS).
+   *
+   * @param path - The path or id of the file.
+   * @returns `true` if the file is virtual, otherwise `false`.
+   */
+  isVirtual: (path: string) => boolean;
+  /**
+   * Checks if the given key is a directory.
+   *
+   * @param key - The key to check.
+   * @returns A promise that resolves to `true` if the key is a directory, otherwise `false`.
+   */
+  isDirectory: (key: string) => Promise<boolean>;
+  /**
+   * Synchronously checks if the given key is a directory.
+   *
+   * @param key - The key to check.
+   * @returns `true` if the key is a directory, otherwise `false`.
+   */
+  isDirectorySync: (key: string) => boolean;
+  /**
+   * Checks if the given key is a file.
+   *
+   * @param key - The key to check.
+   * @returns A promise that resolves to `true` if the key is a file, otherwise `false`.
+   */
+  isFile: (key: string) => Promise<boolean>;
+  /**
+   * Synchronously checks if the given key is a file.
+   *
+   * @param key - The key to check.
+   * @returns `true` if the key is a file, otherwise `false`.
+   */
+  isFileSync: (key: string) => boolean;
+  /**
+   * Gets the metadata of a file in the virtual file system (VFS).
+   *
+   * @param path - The path or id of the file.
+   * @returns The metadata of the file if it exists, otherwise undefined.
+   */
+  getMetadata: (path: string) => VirtualFileMetadata | undefined;
+  /**
+   * Lists files in a given path.
+   *
+   * @param path - The path to list files from.
+   * @returns An array of file names in the specified path.
+   */
+  listSync: (path: string) => string[];
+  /**
+   * Lists files in a given path.
+   *
+   * @param path - The path to list files from.
+   * @returns An array of file names in the specified path.
+   */
+  list: (path: string) => Promise<string[]>;
+  /**
+   * Removes a file or symbolic link in the virtual file system (VFS).
+   *
+   * @param path - The path to the file to remove.
+   * @returns A promise that resolves when the file is removed.
+   */
+  removeSync: (path: string) => void;
+  /**
+   * Asynchronously removes a file or symbolic link in the virtual file system (VFS).
+   *
+   * @param path - The path to the file to remove.
+   * @returns A promise that resolves when the file is removed.
+   */
+  remove: (path: string) => Promise<void>;
+  /**
+   * Reads a file from the virtual file system (VFS).
+   *
+   * @param path - The path or id of the file.
+   * @returns The contents of the file if it exists, otherwise undefined.
+   */
+  read: (path: string) => Promise<string | undefined>;
+  /**
+   * Reads a file from the virtual file system (VFS).
+   *
+   * @param path - The path or id of the file.
+   */
+  readSync: (path: string) => string | undefined;
+  /**
+   * Writes a file to the virtual file system (VFS).
+   *
+   * @param path - The path to the file.
+   * @param data - The contents of the file.
+   * @param options - Options for writing the file.
+   * @returns A promise that resolves when the file is written.
+   */
+  write: (path: string, data: string, options?: WriteOptions) => Promise<void>;
+  /**
+   * Writes a file to the virtual file system (VFS).
+   *
+   * @param path - The path to the file.
+   * @param data - The contents of the file.
+   * @param options - Options for writing the file.
+   */
+  writeSync: (path: string, data: string, options?: WriteOptions) => void;
+  /**
+   * Creates a directory at the specified path.
+   *
+   * @param dirPath - The path of the directory to create.
+   */
+  mkdir: (dirPath: string) => Promise<void>;
+  /**
+   * Synchronously creates a directory at the specified path.
+   *
+   * @param dirPath - The path of the directory to create.
+   */
+  mkdirSync: (dirPath: string) => void;
+  /**
+   * Moves a file from one path to another in the virtual file system (VFS).
+   *
+   * @param srcPath - The source path to move
+   * @param destPath - The destination path to move to
+   */
+  move: (srcPath: string, destPath: string) => Promise<void>;
+  /**
+   * Synchronously moves a file from one path to another in the virtual file system (VFS).
+   *
+   * @param srcPath - The source path to move
+   * @param destPath - The destination path to move to
+   */
+  moveSync: (srcPath: string, destPath: string) => void;
+  /**
+   * Copies a file from one path to another in the virtual file system (VFS).
+   *
+   * @param srcPath - The source path to copy
+   * @param destPath - The destination path to copy to
+   */
+  copy: (srcPath: string | URL | Omit<AssetGlob, "output">, destPath: string | URL) => Promise<void>;
+  /**
+   * Synchronously copies a file from one path to another in the virtual file system (VFS).
+   *
+   * @param srcPath - The source path to copy
+   * @param destPath - The destination path to copy to
+   */
+  copySync: (srcPath: string | URL | Omit<AssetGlob, "output">, destPath: string | URL) => void;
+  /**
+   * Glob files in the virtual file system (VFS) based on the provided pattern(s).
+   *
+   * @param pattern - A pattern (or multiple patterns) to use to determine the file paths to return
+   * @returns An array of file paths matching the provided pattern(s)
+   */
+  glob: (patterns: string | Omit<AssetGlob, "output"> | (string | Omit<AssetGlob, "output">)[]) => Promise<string[]>;
+  /**
+   * Synchronously glob files in the virtual file system (VFS) based on the provided pattern(s).
+   *
+   * @param pattern - A pattern (or multiple patterns) to use to determine the file paths to return
+   * @returns An array of file paths matching the provided pattern(s)
+   */
+  globSync: (patterns: string | Omit<AssetGlob, "output"> | (string | Omit<AssetGlob, "output">)[]) => string[];
+  /**
+   * A helper function to resolve modules using the Jiti resolver
+   *
+   * @remarks
+   * This function can be used to resolve modules relative to the project root directory.
+   *
+   * @example
+   * ```ts
+   * const resolvedPath = await context.resolve("some-module", "/path/to/importer");
+   * ```
+   *
+   * @param id - The module to resolve.
+   * @param importer - An optional path to the importer module.
+   * @param options - Additional resolution options.
+   * @returns A promise that resolves to the resolved module path.
+   */
+  resolve: (id: string, importer?: string, options?: ResolveOptions) => Promise<string | undefined>;
+  /**
+   * A synchronous helper function to resolve modules using the Jiti resolver
+   *
+   * @remarks
+   * This function can be used to resolve modules relative to the project root directory.
+   *
+   * @example
+   * ```ts
+   * const resolvedPath = context.resolveSync("some-module", "/path/to/importer");
+   * ```
+   *
+   * @param id - The module to resolve.
+   * @param importer - An optional path to the importer module.
+   * @param options - Additional resolution options.
+   * @returns The resolved module path.
+   */
+  resolveSync: (id: string, importer?: string, options?: ResolveOptions) => string | undefined;
+  /**
+   * Resolves a given module ID using the configured aliases.
+   *
+   * @remarks
+   * This function can be used to map module IDs to different paths based on the alias configuration.
+   *
+   * @param id - The module ID to resolve.
+   * @returns The resolved module ID - after applying any configured aliases (this will be the same as the input ID if no aliases match).
+   */
+  resolveAlias: (id: string) => string;
+  /**
+   * Disposes of the virtual file system (VFS), writes any virtual file changes to disk, and releases any associated resources.
+   */
+  dispose: () => Promise<void>;
+}
+declare type __ΩVirtualFileExtension = any[];
+declare type __ΩStoragePreset = any[];
+declare type __ΩStorageAdapter = any[];
+declare type __ΩStoragePort = any[];
+declare type __ΩVirtualFileMetadata = any[];
+declare type __ΩVirtualFileData = any[];
+declare type __ΩVirtualFile = any[];
+declare type __ΩWriteOptions = any[];
+declare type __ΩWriteData = any[];
+declare type __ΩResolveOptions = any[];
+declare type __ΩVirtualFileSystemInterface = any[];
+//#endregion
+export { ResolveOptions, STORAGE_PRESETS, StorageAdapter, StoragePort, StoragePreset, VirtualFile, VirtualFileData, VirtualFileExtension, VirtualFileMetadata, VirtualFileSystemInterface, WriteData, WriteOptions, __VFS_PATCH__, __VFS_REVERT__, __ΩResolveOptions, __ΩStorageAdapter, __ΩStoragePort, __ΩStoragePreset, __ΩVirtualFile, __ΩVirtualFileData, __ΩVirtualFileExtension, __ΩVirtualFileMetadata, __ΩVirtualFileSystemInterface, __ΩWriteData, __ΩWriteOptions };
+//# sourceMappingURL=fs.d.mts.map

package/dist/types/fs.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.mts","names":[],"sources":["../../src/types/fs.ts"],"sourcesContent":[],"mappings":";;;;;KAsBY,oBAAA;cAGC,aAAA;AAHD,cAMC,cAAA,GANmB,gBAAA;AAGnB,KAKD,aAAA,GALc,IAAA,GAAA,SAAA;AAGb,cAIA,eAJc,EAIG,aAJH,EAAA;AAE3B;AAEA;AAKA;AAYW,UAZM,cAAA,CAYN;EAQgB;;;EA+CA,IAAA,EAAA,MAAA;EAcG;;;;;;EA0ED,MAAA,CAAA,EA/IlB,aA+IkB,GAAA,IAAA;EAMjB;AAEZ;AA4BA;AA4BA;;;EACqC,MAAA,EAAA,CAAA,GAAA,EAAA,MAAA,EAAA,GAxMV,OAwMU,CAAA,OAAA,CAAA;EAAmB;AAYxD;;;;;EAsBY,UAAA,EAAS,CAAA,GAAA,EAAA,MAAA,EAAY,GAAA,OAAO;EAEvB;;;;;AAgCjB;EAIoC,GAAA,EAAA,CAAA,GAAA,EAAA,MAAA,EAAA,GAhQZ,OAgQY,CAAA,MAAA,GAAA,IAAA,CAAA;EAAf;;;;;;EAkBO,OAAA,EAAA,CAAA,GAAA,EAAA,MAAA,EAAA,GAAA,MAAA,GAAA,IAAA;EAwBI;;;;;;EAyFgB,GAAA,EAAA,CAAA,GAAA,EAAA,MAAA,EAAA,KAAA,EAAA,MAAA,EAAA,GAnXT,OAmXS,CAAA,IAAA,CAAA;EAAiB;;;;;;EAgDrC,OAAA,EAAA,CAAA,GAAA,EAAA,MAAA,EAAA,KAAA,EAAA,MAAA,EAAA,GAAA,IAAA;EACL;;;;;EAWA,MAAA,EAAA,CAAA,GAAA,EAAA,MAAA,EAAA,GAhaI,OAgaJ,CAAA,IAAA,CAAA;EAYV;;;;;EAaA,UAAA,EAAA,CAAA,GAAA,EAAA,MAAA,EAAA,GAAA,IAAA;EAAL;;;;;EA6CM,KAAA,EAAA,CAAA,OAAA,EAAA,MAAA,EAAA,GAxdgB,OAwdhB,CAAA,IAAA,CAAA;EAiBG;;;;;;;;;;;4BA3dW;;;;;;;;;;;;;2BAeD;;;;;;;;;;;;;;gCAgBK;;;;;;;;;;;;;;2BAgBL;;;;;;;;;;;iBAaV;;;;;KAML,WAAA,GAAc,eAAe;UAExB,mBAAA;;;;;;;;;;;;;;;;;;;;;;cAyBH;;UAGG,eAAA;;;;;;;;;;;;;;;;;;;;;;eAyBF;;UAGE,WAAA,SACP,SAAS,kBAAkB;;;;;;;;;;UAYpB,YAAA;;;;;;;;;;;;;YAcL;;;;SAKH,QAAQ;;KAGL,SAAA,YAAqB,MAAA,CAAO,kBAAkB;UAEzC,cAAA,SAAuB;;;;;;;;;;;;;;;;uBAmBjB;;;;yBAKE;;;;;;UAQR,0BAAA;;;;YAIL,SAAS,eAAe;;;;OAK7B,SAAS;;;;SAKP,SAAS;;;;;;;4BAQU;;;;;;;;;;;;;;;;;;;;;gCAwBI;;;;;;;;;;;;;;2BAgBL;;;;;;;;;;;;;;iCAgBM;;;;;;;;;;;;;;0BAgBP;;;;;;;;;;;;;;4BAgBE;;;;;;;0BAQF;;;;;;;;;;;;;;;gDAiBsB,iBAAiB;;;;;;;;oDASb;;;;;;8BAOtB;;;;;;;;;;;;;+CAeiB;;;;;;;;;;;;;;2BAiBzB,MAAM,KAAK,yCACV,QAChB;;;;;;;+BASe,MAAM,KAAK,yCACV;;;;;;;4BAYf,KAAK,iCACK,KAAK,4BAChB;;;;;;;gCAWC,KAAK,iCACK,KAAK;;;;;;;;;;;;;;;;;qDAsBT,mBACP;;;;;;;;;;;;;;;;;yDAqBO;;;;;;;;;;;;;;iBAiBG"}

package/dist/types/fs.mjs

@@ -0,0 +1,8 @@
+//#region src/types/fs.ts
+const __VFS_PATCH__ = "__VFS_PATCH__";
+const __VFS_REVERT__ = "__VFS_REVERT__";
+const STORAGE_PRESETS = ["fs", "virtual"];
+
+//#endregion
+export { STORAGE_PRESETS, __VFS_PATCH__, __VFS_REVERT__ };
+//# sourceMappingURL=fs.mjs.map

package/dist/types/fs.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.mjs","names":["STORAGE_PRESETS: StoragePreset[]"],"sources":["../../src/types/fs.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { ResolveOptions as BaseResolveOptions } from \"@stryke/fs/resolve\";\nimport { MaybePromise } from \"@stryke/types/base\";\nimport { AssetGlob } from \"@stryke/types/file\";\n\nexport type VirtualFileExtension = \"js\" | \"ts\" | \"jsx\" | \"tsx\";\n\n// eslint-disable-next-line ts/naming-convention\nexport const __VFS_PATCH__ = \"__VFS_PATCH__\";\n\n// eslint-disable-next-line ts/naming-convention\nexport const __VFS_REVERT__ = \"__VFS_REVERT__\";\n\nexport type StoragePreset = \"fs\" | \"virtual\";\n\nexport const STORAGE_PRESETS: StoragePreset[] = [\"fs\", \"virtual\"];\n\n/**\n * Interface defining the methods and properties for a storage adapter.\n */\nexport interface StorageAdapter {\n  /**\n   * A name identifying the storage adapter type.\n   */\n  name: string;\n\n  /**\n   * The storage preset for the adapter.\n   *\n   * @remarks\n   * This can be used as an alternate way to identify the type of storage being used.\n   */\n  preset?: StoragePreset | null;\n\n  /**\n   * Checks if a key exists in the storage.\n   *\n   * @param key - The key to check for existence.\n   * @returns A promise that resolves to `true` if the key exists, otherwise `false`.\n   */\n  exists: (key: string) => Promise<boolean>;\n\n  /**\n   * Synchronously checks if a key exists in the storage.\n   *\n   * @param key - The key to check for existence.\n   * @returns Returns `true` if the key exists, otherwise `false`.\n   */\n  existsSync: (key: string) => boolean;\n\n  /**\n   * Read a value associated with a key from the storage.\n   *\n   * @param key - The key to read the value for.\n   * @returns A promise that resolves to the value if found, otherwise `null`.\n   */\n  get: (key: string) => Promise<string | null>;\n\n  /**\n   * Synchronously reads the value associated with a key from the storage.\n   *\n   * @param key - The key to read the value for.\n   * @returns The value if found, otherwise `null`.\n   */\n  getSync: (key: string) => string | null;\n\n  /**\n   * Writes a value to the storage for the given key.\n   *\n   * @param key - The key to associate the value with.\n   * @param value - The value to store.\n   */\n  set: (key: string, value: string) => Promise<void>;\n\n  /**\n   * Synchronously writes a value to the storage for the given key.\n   *\n   * @param key - The key to associate the value with.\n   * @param value - The value to store.\n   */\n  setSync: (key: string, value: string) => void;\n\n  /**\n   * Removes a value from the storage.\n   *\n   * @param key - The key whose value should be removed.\n   */\n  remove: (key: string) => Promise<void>;\n\n  /**\n   * Synchronously removes a value from the storage.\n   *\n   * @param key - The key whose value should be removed.\n   */\n  removeSync: (key: string) => void;\n\n  /**\n   * Creates a directory at the specified path.\n   *\n   * @param dirPath - The path of the directory to create.\n   */\n  mkdir: (dirPath: string) => Promise<void>;\n\n  /**\n   * Synchronously creates a directory at the specified path.\n   *\n   * @param dirPath - The path of the directory to create.\n   */\n  mkdirSync: (dirPath: string) => void;\n\n  /**\n   * Remove all entries from the storage that match the provided base path.\n   *\n   * @param base - The base path or prefix to clear entries from.\n   */\n  clear: (base?: string) => Promise<void>;\n\n  /**\n   * Synchronously remove all entries from the storage that match the provided base path.\n   *\n   * @param base - The base path or prefix to clear entries from.\n   */\n  clearSync: (base?: string) => void;\n\n  /**\n   * Lists all keys under the provided base path.\n   *\n   * @param base - The base path or prefix to list keys from.\n   * @returns A promise resolving to the list of keys.\n   */\n  list: (base?: string) => Promise<string[]>;\n\n  /**\n   * Synchronously lists all keys under the provided base path.\n   *\n   * @param base - The base path or prefix to list keys from.\n   * @returns The list of keys.\n   */\n  listSync: (base?: string) => string[];\n\n  /**\n   * Checks if the given key is a directory.\n   *\n   * @param key - The key to check.\n   * @returns A promise that resolves to `true` if the key is a directory, otherwise `false`.\n   */\n  isDirectory: (key: string) => Promise<boolean>;\n\n  /**\n   * Synchronously checks if the given key is a directory.\n   *\n   * @param key - The key to check.\n   * @returns `true` if the key is a directory, otherwise `false`.\n   */\n  isDirectorySync: (key: string) => boolean;\n\n  /**\n   * Checks if the given key is a file.\n   *\n   * @param key - The key to check.\n   * @returns A promise that resolves to `true` if the key is a file, otherwise `false`.\n   */\n  isFile: (key: string) => Promise<boolean>;\n\n  /**\n   * Synchronously checks if the given key is a file.\n   *\n   * @param key - The key to check.\n   * @returns `true` if the key is a file, otherwise `false`.\n   */\n  isFileSync: (key: string) => boolean;\n\n  /**\n   * Releases any resources held by the storage adapter.\n   */\n  dispose: () => MaybePromise<void>;\n}\n\n/**\n * A mapping of file paths to storage adapter names and their corresponding {@link StorageAdapter} instances.\n */\nexport type StoragePort = Record<string, StorageAdapter>;\n\nexport interface VirtualFileMetadata {\n  /**\n   * The identifier for the file data.\n   */\n  id: string;\n\n  /**\n   * The timestamp of the virtual file.\n   */\n  timestamp: number;\n\n  /**\n   * The type of the file.\n   *\n   * @remarks\n   * This string represents the purpose/function of the file in the virtual file system. A potential list of variants includes:\n   * - `builtin`: Indicates that the file is a built-in module provided by the system.\n   * - `entry`: Indicates that the file is an entry point for execution.\n   * - `normal`: Indicates that the file is a standard file without any special role.\n   */\n  type: string;\n\n  /**\n   * Additional metadata associated with the file.\n   */\n  properties: Record<string, string | undefined>;\n}\n\nexport interface VirtualFileData {\n  /**\n   * The identifier for the file data.\n   */\n  id?: string;\n\n  /**\n   * The contents of the virtual file.\n   */\n  code: string;\n\n  /**\n   * The type of the file.\n   *\n   * @remarks\n   * This string represents the purpose/function of the file in the virtual file system. A potential list of variants includes:\n   * - `builtin`: Indicates that the file is a built-in module provided by the system.\n   * - `entry`: Indicates that the file is an entry point for execution.\n   * - `normal`: Indicates that the file is a standard file without any special role.\n   */\n  type?: string;\n\n  /**\n   * Additional metadata associated with the file.\n   */\n  properties?: Record<string, string | undefined>;\n}\n\nexport interface VirtualFile\n  extends Required<VirtualFileData>, VirtualFileMetadata {\n  /**\n   * An additional name for the file.\n   */\n  path: string;\n\n  /**\n   * The timestamp of the virtual file.\n   */\n  timestamp: number;\n}\n\nexport interface WriteOptions {\n  /**\n   * Should the file skip formatting before being written?\n   *\n   * @defaultValue false\n   */\n  skipFormat?: boolean;\n\n  /**\n   * The storage preset or adapter name for the output file.\n   *\n   * @remarks\n   * If not specified, the output mode will be determined by the provided `output.mode` value.\n   */\n  storage?: StoragePreset | string;\n\n  /**\n   * Additional metadata for the file.\n   */\n  meta?: Partial<VirtualFileMetadata>;\n}\n\nexport type WriteData = string | NodeJS.ArrayBufferView | VirtualFileData;\n\nexport interface ResolveOptions extends BaseResolveOptions {\n  /**\n   * If true, the module is being resolved as an entry point.\n   */\n  isEntry?: boolean;\n\n  /**\n   * If true, the resolver will skip alias resolution when resolving modules.\n   */\n  skipAlias?: boolean;\n\n  /**\n   * If true, the resolver will skip using the cache when resolving modules.\n   */\n  skipCache?: boolean;\n\n  /**\n   * An array of external modules or patterns to exclude from resolution.\n   */\n  external?: (string | RegExp)[];\n\n  /**\n   * An array of modules or patterns to include in the resolution, even if they are marked as external.\n   */\n  noExternal?: (string | RegExp)[];\n\n  /**\n   * An array of patterns to match when resolving modules.\n   */\n  skipNodeModulesBundle?: boolean;\n}\n\nexport interface VirtualFileSystemInterface {\n  /**\n   * The underlying file metadata.\n   */\n  metadata: Readonly<Record<string, VirtualFileMetadata>>;\n\n  /**\n   * A map of file paths to their module ids.\n   */\n  ids: Readonly<Record<string, string>>;\n\n  /**\n   * A map of module ids to their file paths.\n   */\n  paths: Readonly<Record<string, string>>;\n\n  /**\n   * Checks if a file exists in the virtual file system (VFS).\n   *\n   * @param path - The path or id of the file.\n   * @returns `true` if the file exists, otherwise `false`.\n   */\n  exists: (path: string) => Promise<boolean>;\n\n  /**\n   * Synchronously Checks if a file exists in the virtual file system (VFS).\n   *\n   * @param path - The path or id of the file.\n   * @returns `true` if the file exists, otherwise `false`.\n   */\n  existsSync: (path: string) => boolean;\n\n  /**\n   * Checks if a file is virtual in the virtual file system (VFS).\n   *\n   * @param path - The path or id of the file.\n   * @returns `true` if the file is virtual, otherwise `false`.\n   */\n  isVirtual: (path: string) => boolean;\n\n  /**\n   * Checks if the given key is a directory.\n   *\n   * @param key - The key to check.\n   * @returns A promise that resolves to `true` if the key is a directory, otherwise `false`.\n   */\n  isDirectory: (key: string) => Promise<boolean>;\n\n  /**\n   * Synchronously checks if the given key is a directory.\n   *\n   * @param key - The key to check.\n   * @returns `true` if the key is a directory, otherwise `false`.\n   */\n  isDirectorySync: (key: string) => boolean;\n\n  /**\n   * Checks if the given key is a file.\n   *\n   * @param key - The key to check.\n   * @returns A promise that resolves to `true` if the key is a file, otherwise `false`.\n   */\n  isFile: (key: string) => Promise<boolean>;\n\n  /**\n   * Synchronously checks if the given key is a file.\n   *\n   * @param key - The key to check.\n   * @returns `true` if the key is a file, otherwise `false`.\n   */\n  isFileSync: (key: string) => boolean;\n\n  /**\n   * Gets the metadata of a file in the virtual file system (VFS).\n   *\n   * @param path - The path or id of the file.\n   * @returns The metadata of the file if it exists, otherwise undefined.\n   */\n  getMetadata: (path: string) => VirtualFileMetadata | undefined;\n\n  /**\n   * Lists files in a given path.\n   *\n   * @param path - The path to list files from.\n   * @returns An array of file names in the specified path.\n   */\n  listSync: (path: string) => string[];\n\n  /**\n   * Lists files in a given path.\n   *\n   * @param path - The path to list files from.\n   * @returns An array of file names in the specified path.\n   */\n  list: (path: string) => Promise<string[]>;\n\n  /**\n   * Removes a file or symbolic link in the virtual file system (VFS).\n   *\n   * @param path - The path to the file to remove.\n   * @returns A promise that resolves when the file is removed.\n   */\n  removeSync: (path: string) => void;\n\n  /**\n   * Asynchronously removes a file or symbolic link in the virtual file system (VFS).\n   *\n   * @param path - The path to the file to remove.\n   * @returns A promise that resolves when the file is removed.\n   */\n  remove: (path: string) => Promise<void>;\n\n  /**\n   * Reads a file from the virtual file system (VFS).\n   *\n   * @param path - The path or id of the file.\n   * @returns The contents of the file if it exists, otherwise undefined.\n   */\n  read: (path: string) => Promise<string | undefined>;\n\n  /**\n   * Reads a file from the virtual file system (VFS).\n   *\n   * @param path - The path or id of the file.\n   */\n  readSync: (path: string) => string | undefined;\n\n  /**\n   * Writes a file to the virtual file system (VFS).\n   *\n   * @param path - The path to the file.\n   * @param data - The contents of the file.\n   * @param options - Options for writing the file.\n   * @returns A promise that resolves when the file is written.\n   */\n  write: (path: string, data: string, options?: WriteOptions) => Promise<void>;\n\n  /**\n   * Writes a file to the virtual file system (VFS).\n   *\n   * @param path - The path to the file.\n   * @param data - The contents of the file.\n   * @param options - Options for writing the file.\n   */\n  writeSync: (path: string, data: string, options?: WriteOptions) => void;\n\n  /**\n   * Creates a directory at the specified path.\n   *\n   * @param dirPath - The path of the directory to create.\n   */\n  mkdir: (dirPath: string) => Promise<void>;\n\n  /**\n   * Synchronously creates a directory at the specified path.\n   *\n   * @param dirPath - The path of the directory to create.\n   */\n  mkdirSync: (dirPath: string) => void;\n\n  /**\n   * Moves a file from one path to another in the virtual file system (VFS).\n   *\n   * @param srcPath - The source path to move\n   * @param destPath - The destination path to move to\n   */\n  move: (srcPath: string, destPath: string) => Promise<void>;\n\n  /**\n   * Synchronously moves a file from one path to another in the virtual file system (VFS).\n   *\n   * @param srcPath - The source path to move\n   * @param destPath - The destination path to move to\n   */\n  moveSync: (srcPath: string, destPath: string) => void;\n\n  /**\n   * Copies a file from one path to another in the virtual file system (VFS).\n   *\n   * @param srcPath - The source path to copy\n   * @param destPath - The destination path to copy to\n   */\n  copy: (\n    srcPath: string | URL | Omit<AssetGlob, \"output\">,\n    destPath: string | URL\n  ) => Promise<void>;\n\n  /**\n   * Synchronously copies a file from one path to another in the virtual file system (VFS).\n   *\n   * @param srcPath - The source path to copy\n   * @param destPath - The destination path to copy to\n   */\n  copySync: (\n    srcPath: string | URL | Omit<AssetGlob, \"output\">,\n    destPath: string | URL\n  ) => void;\n\n  /**\n   * Glob files in the virtual file system (VFS) based on the provided pattern(s).\n   *\n   * @param pattern - A pattern (or multiple patterns) to use to determine the file paths to return\n   * @returns An array of file paths matching the provided pattern(s)\n   */\n  glob: (\n    patterns:\n      | string\n      | Omit<AssetGlob, \"output\">\n      | (string | Omit<AssetGlob, \"output\">)[]\n  ) => Promise<string[]>;\n\n  /**\n   * Synchronously glob files in the virtual file system (VFS) based on the provided pattern(s).\n   *\n   * @param pattern - A pattern (or multiple patterns) to use to determine the file paths to return\n   * @returns An array of file paths matching the provided pattern(s)\n   */\n  globSync: (\n    patterns:\n      | string\n      | Omit<AssetGlob, \"output\">\n      | (string | Omit<AssetGlob, \"output\">)[]\n  ) => string[];\n\n  /**\n   * A helper function to resolve modules using the Jiti resolver\n   *\n   * @remarks\n   * This function can be used to resolve modules relative to the project root directory.\n   *\n   * @example\n   * ```ts\n   * const resolvedPath = await context.resolve(\"some-module\", \"/path/to/importer\");\n   * ```\n   *\n   * @param id - The module to resolve.\n   * @param importer - An optional path to the importer module.\n   * @param options - Additional resolution options.\n   * @returns A promise that resolves to the resolved module path.\n   */\n  resolve: (\n    id: string,\n    importer?: string,\n    options?: ResolveOptions\n  ) => Promise<string | undefined>;\n\n  /**\n   * A synchronous helper function to resolve modules using the Jiti resolver\n   *\n   * @remarks\n   * This function can be used to resolve modules relative to the project root directory.\n   *\n   * @example\n   * ```ts\n   * const resolvedPath = context.resolveSync(\"some-module\", \"/path/to/importer\");\n   * ```\n   *\n   * @param id - The module to resolve.\n   * @param importer - An optional path to the importer module.\n   * @param options - Additional resolution options.\n   * @returns The resolved module path.\n   */\n  resolveSync: (\n    id: string,\n    importer?: string,\n    options?: ResolveOptions\n  ) => string | undefined;\n\n  /**\n   * Resolves a given module ID using the configured aliases.\n   *\n   * @remarks\n   * This function can be used to map module IDs to different paths based on the alias configuration.\n   *\n   * @param id - The module ID to resolve.\n   * @returns The resolved module ID - after applying any configured aliases (this will be the same as the input ID if no aliases match).\n   */\n  resolveAlias: (id: string) => string;\n\n  /**\n   * Disposes of the virtual file system (VFS), writes any virtual file changes to disk, and releases any associated resources.\n   */\n  dispose: () => Promise<void>;\n}\n"],"mappings":";AAyBA,MAAa,gBAAgB;AAG7B,MAAa,iBAAiB;AAI9B,MAAaA,kBAAmC,CAAC,MAAM,UAAU"}

package/dist/types/hooks.cjs

@@ -0,0 +1,13 @@
+
+//#region src/types/hooks.ts
+const HOOKS_LIST_ORDERS = [
+	"preOrdered",
+	"preEnforced",
+	"normal",
+	"postEnforced",
+	"postOrdered"
+];
+
+//#endregion
+exports.HOOKS_LIST_ORDERS = HOOKS_LIST_ORDERS;
+//# sourceMappingURL=hooks.cjs.map

package/dist/types/hooks.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.cjs","names":[],"sources":["../../src/types/hooks.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { MaybePromise } from \"@stryke/types/base\";\nimport { UnpluginOptions } from \"unplugin\";\nimport type {\n  PluginContext,\n  SelectHooksOptions,\n  WithUnpluginBuildContext\n} from \"./context\";\nimport type { Plugin, PluginHookFields, PluginHookFunctions } from \"./plugin\";\nimport { UnpluginBuilderVariant } from \"./unplugin\";\n\nexport type HookListOrders =\n  | \"preOrdered\"\n  | \"preEnforced\"\n  | \"normal\"\n  | \"postEnforced\"\n  | \"postOrdered\";\n\nexport const HOOKS_LIST_ORDERS = [\n  \"preOrdered\",\n  \"preEnforced\",\n  \"normal\",\n  \"postEnforced\",\n  \"postOrdered\"\n] as const;\n\nexport type UnpluginHookFunctions<\n  TContext extends PluginContext = PluginContext,\n  TUnpluginBuilderVariant extends UnpluginBuilderVariant =\n    UnpluginBuilderVariant,\n  TField extends keyof Required<UnpluginOptions>[TUnpluginBuilderVariant] =\n    keyof Required<UnpluginOptions>[TUnpluginBuilderVariant]\n> = Required<UnpluginOptions>[TUnpluginBuilderVariant][TField] extends\n  | infer THandler\n  | {\n      handler: infer THandler;\n    }\n  ? THandler extends (\n      this: infer THandlerOriginalContext,\n      ...args: infer THandlerArgs\n    ) => infer THandlerReturn\n    ? (\n        this: THandlerOriginalContext & WithUnpluginBuildContext<TContext>,\n        ...args: THandlerArgs\n      ) => THandlerReturn\n    : THandler extends { handler: infer THandlerFunction }\n      ? THandlerFunction extends (\n          this: infer THandlerFunctionOriginalContext,\n          ...args: infer THandlerFunctionArgs\n        ) => infer THandlerFunctionReturn\n        ? (\n            this: THandlerFunctionOriginalContext &\n              WithUnpluginBuildContext<TContext>,\n            ...args: THandlerFunctionArgs\n          ) => THandlerFunctionReturn\n        : never\n      : never\n  : never;\n\nexport interface PluginHooksListItem<\n  TContext extends PluginContext = PluginContext,\n  TFields extends PluginHookFields<TContext> = PluginHookFields<TContext>\n> {\n  plugin: Plugin<TContext>;\n  handler: PluginHookFunctions<TContext>[TFields];\n}\n\nexport type PluginHooksList<\n  TContext extends PluginContext = PluginContext,\n  TFields extends PluginHookFields<TContext> = PluginHookFields<TContext>\n> = {\n  [TKey in HookListOrders]?:\n    | PluginHooksListItem<TContext, TFields>[]\n    | undefined;\n};\n\nexport interface UnpluginHooksListItem<\n  TContext extends PluginContext = PluginContext,\n  TUnpluginBuilderVariant extends UnpluginBuilderVariant =\n    UnpluginBuilderVariant,\n  TField extends keyof Required<UnpluginOptions>[TUnpluginBuilderVariant] =\n    keyof Required<UnpluginOptions>[TUnpluginBuilderVariant]\n> {\n  plugin: Plugin<TContext>;\n  handler: UnpluginHookFunctions<TContext, TUnpluginBuilderVariant, TField>;\n}\n\nexport type UnpluginHookList<\n  TContext extends PluginContext = PluginContext,\n  TUnpluginBuilderVariant extends UnpluginBuilderVariant =\n    UnpluginBuilderVariant,\n  TField extends keyof UnpluginOptions[TUnpluginBuilderVariant] =\n    keyof UnpluginOptions[TUnpluginBuilderVariant]\n> = {\n  [TKey in HookListOrders]?:\n    | UnpluginHooksListItem<TContext, TUnpluginBuilderVariant, TField>[]\n    | undefined;\n};\n\nexport type UnpluginHookVariantField<\n  TContext extends PluginContext = PluginContext,\n  TUnpluginBuilderVariant extends UnpluginBuilderVariant =\n    UnpluginBuilderVariant\n> = {\n  [TKey in keyof UnpluginOptions[TUnpluginBuilderVariant]]?: UnpluginHookList<\n    TContext,\n    TUnpluginBuilderVariant,\n    TKey\n  >;\n};\n\nexport type UnpluginHookVariant<\n  TContext extends PluginContext = PluginContext\n> = {\n  [TKey in UnpluginBuilderVariant]?: UnpluginHookVariantField<TContext, TKey>;\n};\n\nexport type HookFields<TContext extends PluginContext = PluginContext> =\n  | PluginHookFields<TContext>\n  | UnpluginBuilderVariant;\n\nexport type HooksList<TContext extends PluginContext = PluginContext> = {\n  [TField in HookFields<TContext>]?: TField extends PluginHookFields<TContext>\n    ? PluginHooksList<TContext, TField>\n    : TField extends UnpluginBuilderVariant\n      ? UnpluginHookVariant<TContext>[TField]\n      : never;\n};\n\nexport type InferHooksListItem<\n  TContext extends PluginContext,\n  TKey extends string\n> = TKey extends `${infer TUnpluginBuilderVariant}:${infer TUnpluginField}`\n  ? TUnpluginBuilderVariant extends UnpluginBuilderVariant\n    ? TUnpluginField extends keyof Required<UnpluginOptions>[TUnpluginBuilderVariant]\n      ? UnpluginHooksListItem<TContext, TUnpluginBuilderVariant, TUnpluginField>\n      : never\n    : never\n  : TKey extends keyof PluginHookFunctions<TContext>\n    ? PluginHooksListItem<TContext, TKey>\n    : never;\n\nexport type InferHookFunction<\n  TContext extends PluginContext,\n  TKey extends string\n> = TKey extends `${infer TUnpluginBuilderVariant}:${infer TUnpluginField}`\n  ? TUnpluginBuilderVariant extends UnpluginBuilderVariant\n    ? TUnpluginField extends keyof Required<UnpluginOptions>[TUnpluginBuilderVariant]\n      ? UnpluginHookFunctions<TContext, TUnpluginBuilderVariant, TUnpluginField>\n      : never\n    : never\n  : TKey extends keyof PluginHookFunctions<TContext>\n    ? PluginHookFunctions<TContext>[TKey]\n    : never;\n\nexport type InferHookReturnType<\n  TContext extends PluginContext,\n  TKey extends string\n> = ReturnType<InferHookFunction<TContext, TKey>>;\n\nexport type InferHookParameters<\n  TContext extends PluginContext,\n  TKey extends string\n> = Parameters<InferHookFunction<TContext, TKey>>;\n\nexport type InferHookThisType<\n  TContext extends PluginContext,\n  TKey extends string\n> = ThisParameterType<InferHookFunction<TContext, TKey>>;\n\nexport type CallHookOptions = SelectHooksOptions &\n  (\n    | ({\n        /**\n         * Whether to call the hooks sequentially or in parallel.\n         *\n         * @defaultValue true\n         */\n        sequential?: true;\n      } & (\n        | {\n            /**\n             * How to handle multiple return values from hooks.\n             * - \"merge\": Merge all non-undefined return values (if they are objects).\n             * - \"first\": Return the first non-undefined value.\n             *\n             * @remarks\n             * Merging only works if the return values are objects.\n             *\n             * @defaultValue \"merge\"\n             */\n            result: \"first\";\n          }\n        | ({\n            /**\n             * An indicator specifying if the results of the previous hook should be provided as the **first** parameter of the next hook function, or a function to process the result of the previous hook function and pass the returned value as the next hook's **first** parameter\n             */\n            asNextParam?: false | ((previousResult: any) => MaybePromise<any>);\n          } & (\n            | {\n                /**\n                 * How to handle multiple return values from hooks.\n                 * - \"merge\": Merge all non-undefined return values (if they are objects).\n                 * - \"first\": Return the first non-undefined value.\n                 *\n                 * @remarks\n                 * Merging only works if the return values are objects.\n                 *\n                 * @defaultValue \"merge\"\n                 */\n                result?: \"merge\";\n\n                /**\n                 * A custom function to merge multiple return values from hooks.\n                 *\n                 * @remarks\n                 * If not provided, the {@link mergeResults} function will be used by default, which merges string results by concatenation and object results by deep merging.\n                 *\n                 * @param currentResult - The current hook result to merge with the previous results.\n                 * @param previousResults - The previous hook results to merge with the current result.\n                 * @returns The merged result.\n                 */\n                merge?: <T>(currentResult: T, previousResults: T[]) => T[];\n              }\n            | {\n                /**\n                 * How to handle multiple return values from hooks.\n                 * - \"merge\": Merge all non-undefined return values (if they are objects).\n                 * - \"first\": Return the first non-undefined value.\n                 *\n                 * @remarks\n                 * Merging only works if the return values are objects.\n                 *\n                 * @defaultValue \"merge\"\n                 */\n                result?: \"last\";\n              }\n          ))\n      ))\n    | {\n        /**\n         * Whether to call the hooks sequentially or in parallel.\n         */\n        sequential: false;\n      }\n  );\n"],"mappings":";;AAmCA,MAAa,oBAAoB;CAC/B;CACA;CACA;CACA;CACA;CACD"}