@visulima/fs 5.1.0 → 6.0.0

package/dist/packem_shared/types.d-C-RhhzcS.d.ts

@@ -1,1753 +0,0 @@
-import { PathLike, Dirent } from 'node:fs';
-import { FSLike } from 'fdir';
-//#region src/types.d.ts
-type FileSystemAdapter = Partial<FSLike>;
-interface GlobOptions$1 {
-  /**
-   * Whether to return absolute paths. Disable to have relative paths.
-   * @default false
-   */
-  absolute?: boolean;
-  /**
-   * Enables support for brace expansion syntax, like `{a,b}` or `{1..9}`.
-   * @default true
-   */
-  braceExpansion?: boolean;
-  /**
-   * Whether to match in case-sensitive mode.
-   * @default true
-   */
-  caseSensitiveMatch?: boolean;
-  /**
-   * The working directory in which to search. Results will be returned relative to this directory, unless
-   * {@link absolute} is set.
-   *
-   * It is important to avoid globbing outside this directory when possible, even with absolute paths enabled,
-   * as doing so can harm performance due to having to recalculate relative paths.
-   * @default process.cwd()
-   */
-  cwd?: string | URL;
-  /**
-   * Logs useful debug information. Meant for development purposes. Logs can change at any time.
-   * @default false
-   */
-  debug?: boolean;
-  /**
-   * Maximum directory depth to crawl.
-   * @default Infinity
-   */
-  deep?: number;
-  /**
-   * Whether to return entries that start with a dot, like `.gitignore` or `.prettierrc`.
-   * @default false
-   */
-  dot?: boolean;
-  /**
-   * Whether to automatically expand directory patterns.
-   *
-   * Important to disable if migrating from [`fast-glob`](https://github.com/mrmlnc/fast-glob).
-   * @default true
-   */
-  expandDirectories?: boolean;
-  /**
-   * Enables support for extglobs, like `+(pattern)`.
-   * @default true
-   */
-  extglob?: boolean;
-  /**
-   * Whether to traverse and include symbolic links. Can slightly affect performance.
-   * @default true
-   */
-  followSymbolicLinks?: boolean;
-  /**
-   * An object that overrides `node:fs` functions.
-   * @default import('node:fs')
-   */
-  fs?: FileSystemAdapter;
-  /**
-   * Enables support for matching nested directories with globstars (`**`).
-   * If `false`, `**` behaves exactly like `*`.
-   * @default true
-   */
-  globstar?: boolean;
-  /**
-   * Glob patterns to exclude from the results.
-   * @default []
-   */
-  ignore?: string | readonly string[];
-  /**
-   * Enable to only return directories.
-   * If `true`, disables {@link onlyFiles}.
-   * @default false
-   */
-  onlyDirectories?: boolean;
-  /**
-   * Enable to only return files.
-   * @default true
-   */
-  onlyFiles?: boolean;
-  /**
-   * @deprecated Provide patterns as the first argument instead.
-   */
-  patterns?: string | readonly string[];
-  /**
-   * An `AbortSignal` to abort crawling the file system.
-   * @default undefined
-   */
-  signal?: AbortSignal;
-}
-/**
- * Tracks newlines during parsing in order to provide an efficient API for
- * determining the one-indexed `{ line, col }` position for any offset
- * within the input.
- */
-declare class LineCounter {
-  lineStarts: number[];
-  /**
-   * Should be called in ascending order. Otherwise, call
-   * `lineCounter.lineStarts.sort()` before calling `linePos()`.
-   */
-  addNewLine: (offset: number) => number;
-  /**
-   * Performs a binary search and returns the 1-indexed { line, col }
-   * position of `offset`. If `line === 0`, `addNewLine` has never been
-   * called or `offset` is before the first known newline.
-   */
-  linePos: (offset: number) => {
-    line: number;
-    col: number;
-  };
-}
-type ErrorCode = 'ALIAS_PROPS' | 'BAD_ALIAS' | 'BAD_DIRECTIVE' | 'BAD_DQ_ESCAPE' | 'BAD_INDENT' | 'BAD_PROP_ORDER' | 'BAD_SCALAR_START' | 'BLOCK_AS_IMPLICIT_KEY' | 'BLOCK_IN_FLOW' | 'DUPLICATE_KEY' | 'IMPOSSIBLE' | 'KEY_OVER_1024_CHARS' | 'MISSING_CHAR' | 'MULTILINE_IMPLICIT_KEY' | 'MULTIPLE_ANCHORS' | 'MULTIPLE_DOCS' | 'MULTIPLE_TAGS' | 'NON_STRING_KEY' | 'RESOURCE_EXHAUSTION' | 'TAB_AS_INDENT' | 'TAG_RESOLVE_FAILED' | 'UNEXPECTED_TOKEN' | 'BAD_COLLECTION_TYPE';
-type LinePos = {
-  line: number;
-  col: number;
-};
-declare class YAMLError extends Error {
-  name: 'YAMLParseError' | 'YAMLWarning';
-  code: ErrorCode;
-  message: string;
-  pos: [number, number];
-  linePos?: [LinePos] | [LinePos, LinePos];
-  constructor(name: YAMLError['name'], pos: [number, number], code: ErrorCode, message: string);
-}
-declare class YAMLWarning extends YAMLError {
-  constructor(pos: [number, number], code: ErrorCode, message: string);
-}
-type Reviver = (key: unknown, value: unknown) => unknown;
-type LogLevelId = 'silent' | 'error' | 'warn' | 'debug';
-interface AnchorData {
-  aliasCount: number;
-  count: number;
-  res: unknown;
-}
-interface ToJSContext {
-  anchors: Map<Node, AnchorData>;
-  /** Cached anchor and alias nodes in the order they occur in the document */
-  aliasResolveCache?: Node[];
-  doc: Document<Node, boolean>;
-  keep: boolean;
-  mapAsMap: boolean;
-  mapKeyWarned: boolean;
-  maxAliasCount: number;
-  onCreate?: (res: unknown) => void;
-}
-declare namespace Scalar {
-  interface Parsed extends Scalar {
-    range: Range;
-    source: string;
-    srcToken?: FlowScalar | BlockScalar;
-  }
-  type BLOCK_FOLDED = 'BLOCK_FOLDED';
-  type BLOCK_LITERAL = 'BLOCK_LITERAL';
-  type PLAIN = 'PLAIN';
-  type QUOTE_DOUBLE = 'QUOTE_DOUBLE';
-  type QUOTE_SINGLE = 'QUOTE_SINGLE';
-  type Type = BLOCK_FOLDED | BLOCK_LITERAL | PLAIN | QUOTE_DOUBLE | QUOTE_SINGLE;
-}
-declare class Scalar<T = unknown> extends NodeBase {
-  static readonly BLOCK_FOLDED = "BLOCK_FOLDED";
-  static readonly BLOCK_LITERAL = "BLOCK_LITERAL";
-  static readonly PLAIN = "PLAIN";
-  static readonly QUOTE_DOUBLE = "QUOTE_DOUBLE";
-  static readonly QUOTE_SINGLE = "QUOTE_SINGLE";
-  value: T;
-  /** An optional anchor on this node. Used by alias nodes. */
-  anchor?: string;
-  /**
-   * By default (undefined), numbers use decimal notation.
-   * The YAML 1.2 core schema only supports 'HEX' and 'OCT'.
-   * The YAML 1.1 schema also supports 'BIN' and 'TIME'
-   */
-  format?: string;
-  /**
-   * If `value` is a number that is serialized as a decimal string
-   * (i.e. not using exponential notation),
-   * use this value when stringifying this node.
-   */
-  minFractionDigits?: number;
-  /** Set during parsing to the source string value */
-  source?: string;
-  /** The scalar style used for the node's string representation */
-  type?: Scalar.Type;
-  constructor(value: T);
-  toJSON(arg?: any, ctx?: ToJSContext): any;
-  toString(): string;
-}
-type StringifyContext = {
-  actualString?: boolean;
-  allNullValues?: boolean;
-  anchors: Set<string>;
-  doc: Document;
-  forceBlockIndent?: boolean;
-  implicitKey?: boolean;
-  indent: string;
-  indentStep: string;
-  indentAtStart?: number;
-  inFlow: boolean | null;
-  inStringifyKey?: boolean;
-  flowCollectionPadding: string;
-  options: Readonly<Required<Omit<ToStringOptions, 'collectionStyle' | 'indent'>>>;
-  resolvedAliases?: Set<Alias>;
-};
-declare abstract class Collection extends NodeBase {
-  schema: Schema | undefined;
-  [NODE_TYPE]: symbol;
-  items: unknown[];
-  /** An optional anchor on this node. Used by alias nodes. */
-  anchor?: string;
-  /**
-   * If true, stringify this and all child nodes using flow rather than
-   * block styles.
-   */
-  flow?: boolean;
-  constructor(type: symbol, schema?: Schema);
-  /**
-   * Create a copy of this collection.
-   *
-   * @param schema - If defined, overwrites the original's schema
-   */
-  clone(schema?: Schema): Collection;
-  /** Adds a value to the collection. */
-  abstract add(value: unknown): void;
-  /**
-   * Removes a value from the collection.
-   * @returns `true` if the item was found and removed.
-   */
-  abstract delete(key: unknown): boolean;
-  /**
-   * Returns item at `key`, or `undefined` if not found. By default unwraps
-   * scalar values from their surrounding node; to disable set `keepScalar` to
-   * `true` (collections are always returned intact).
-   */
-  abstract get(key: unknown, keepScalar?: boolean): unknown;
-  /**
-   * Checks if the collection includes a value with the key `key`.
-   */
-  abstract has(key: unknown): boolean;
-  /**
-   * Sets a value in this collection. For `!!set`, `value` needs to be a
-   * boolean to add/remove the item from the set.
-   */
-  abstract set(key: unknown, value: unknown): void;
-  /**
-   * Adds a value to the collection. For `!!map` and `!!omap` the value must
-   * be a Pair instance or a `{ key, value }` object, which may not have a key
-   * that already exists in the map.
-   */
-  addIn(path: Iterable<unknown>, value: unknown): void;
-  /**
-   * Removes a value from the collection.
-   * @returns `true` if the item was found and removed.
-   */
-  deleteIn(path: Iterable<unknown>): boolean;
-  /**
-   * Returns item at `key`, or `undefined` if not found. By default unwraps
-   * scalar values from their surrounding node; to disable set `keepScalar` to
-   * `true` (collections are always returned intact).
-   */
-  getIn(path: Iterable<unknown>, keepScalar?: boolean): unknown;
-  hasAllNullValues(allowScalar?: boolean): boolean;
-  /**
-   * Checks if the collection includes a value with the key `key`.
-   */
-  hasIn(path: Iterable<unknown>): boolean;
-  /**
-   * Sets a value in this collection. For `!!set`, `value` needs to be a
-   * boolean to add/remove the item from the set.
-   */
-  setIn(path: Iterable<unknown>, value: unknown): void;
-}
-declare namespace YAMLSeq {
-  interface Parsed<T extends ParsedNode | Pair<ParsedNode, ParsedNode | null> = ParsedNode> extends YAMLSeq<T> {
-    items: T[];
-    range: Range;
-    srcToken?: BlockSequence | FlowCollection;
-  }
-}
-declare class YAMLSeq<T = unknown> extends Collection {
-  static get tagName(): 'tag:yaml.org,2002:seq';
-  items: T[];
-  constructor(schema?: Schema);
-  add(value: T): void;
-  /**
-   * Removes a value from the collection.
-   *
-   * `key` must contain a representation of an integer for this to succeed.
-   * It may be wrapped in a `Scalar`.
-   *
-   * @returns `true` if the item was found and removed.
-   */
-  delete(key: unknown): boolean;
-  /**
-   * Returns item at `key`, or `undefined` if not found. By default unwraps
-   * scalar values from their surrounding node; to disable set `keepScalar` to
-   * `true` (collections are always returned intact).
-   *
-   * `key` must contain a representation of an integer for this to succeed.
-   * It may be wrapped in a `Scalar`.
-   */
-  get(key: unknown, keepScalar: true): Scalar<T> | undefined;
-  get(key: unknown, keepScalar?: false): T | undefined;
-  get(key: unknown, keepScalar?: boolean): T | Scalar<T> | undefined;
-  /**
-   * Checks if the collection includes a value with the key `key`.
-   *
-   * `key` must contain a representation of an integer for this to succeed.
-   * It may be wrapped in a `Scalar`.
-   */
-  has(key: unknown): boolean;
-  /**
-   * Sets a value in this collection. For `!!set`, `value` needs to be a
-   * boolean to add/remove the item from the set.
-   *
-   * If `key` does not contain a representation of an integer, this will throw.
-   * It may be wrapped in a `Scalar`.
-   */
-  set(key: unknown, value: T): void;
-  toJSON(_?: unknown, ctx?: ToJSContext): unknown[];
-  toString(ctx?: StringifyContext, onComment?: () => void, onChompKeep?: () => void): string;
-  static from(schema: Schema, obj: unknown, ctx: CreateNodeContext): YAMLSeq;
-}
-interface TagBase {
-  /**
-   * An optional factory function, used e.g. by collections when wrapping JS objects as AST nodes.
-   */
-  createNode?: (schema: Schema, value: unknown, ctx: CreateNodeContext) => Node;
-  /**
-   * If `true`, allows for values to be stringified without
-   * an explicit tag together with `test`.
-   * If `'key'`, this only applies if the value is used as a mapping key.
-   * For most cases, it's unlikely that you'll actually want to use this,
-   * even if you first think you do.
-   */
-  default?: boolean | 'key';
-  /**
-   * If a tag has multiple forms that should be parsed and/or stringified
-   * differently, use `format` to identify them.
-   */
-  format?: string;
-  /**
-   * Used by `YAML.createNode` to detect your data type, e.g. using `typeof` or
-   * `instanceof`.
-   */
-  identify?: (value: unknown) => boolean;
-  /**
-   * The identifier for your data type, with which its stringified form will be
-   * prefixed. Should either be a !-prefixed local `!tag`, or a fully qualified
-   * `tag:domain,date:foo`.
-   */
-  tag: string;
-}
-interface ScalarTag extends TagBase {
-  collection?: never;
-  nodeClass?: never;
-  /**
-   * Turns a value into an AST node.
-   * If returning a non-`Node` value, the output will be wrapped as a `Scalar`.
-   */
-  resolve(value: string, onError: (message: string) => void, options: ParseOptions): unknown;
-  /**
-   * Optional function stringifying a Scalar node. If your data includes a
-   * suitable `.toString()` method, you can probably leave this undefined and
-   * use the default stringifier.
-   *
-   * @param item The node being stringified.
-   * @param ctx Contains the stringifying context variables.
-   * @param onComment Callback to signal that the stringifier includes the
-   *   item's comment in its output.
-   * @param onChompKeep Callback to signal that the output uses a block scalar
-   *   type with the `+` chomping indicator.
-   */
-  stringify?: (item: Scalar, ctx: StringifyContext, onComment?: () => void, onChompKeep?: () => void) => string;
-  /**
-   * Together with `default` allows for values to be stringified without an
-   * explicit tag and detected using a regular expression. For most cases, it's
-   * unlikely that you'll actually want to use these, even if you first think
-   * you do.
-   */
-  test?: RegExp;
-}
-interface CollectionTag extends TagBase {
-  stringify?: never;
-  test?: never;
-  /** The source collection type supported by this tag. */
-  collection: 'map' | 'seq';
-  /**
-   * The `Node` child class that implements this tag.
-   * If set, used to select this tag when stringifying.
-   *
-   * If the class provides a static `from` method, then that
-   * will be used if the tag object doesn't have a `createNode` method.
-   */
-  nodeClass?: {
-    new (schema?: Schema): Node;
-    from?: (schema: Schema, obj: unknown, ctx: CreateNodeContext) => Node;
-  };
-  /**
-   * Turns a value into an AST node.
-   * If returning a non-`Node` value, the output will be wrapped as a `Scalar`.
-   *
-   * Note: this is required if nodeClass is not provided.
-   */
-  resolve?: (value: YAMLMap.Parsed | YAMLSeq.Parsed, onError: (message: string) => void, options: ParseOptions) => unknown;
-}
-type MapLike = Map<unknown, unknown> | Set<unknown> | Record<string | number | symbol, unknown>;
-declare namespace YAMLMap {
-  interface Parsed<K extends ParsedNode = ParsedNode, V extends ParsedNode | null = ParsedNode | null> extends YAMLMap<K, V> {
-    items: Pair<K, V>[];
-    range: Range;
-    srcToken?: BlockMap | FlowCollection;
-  }
-}
-declare class YAMLMap<K = unknown, V = unknown> extends Collection {
-  static get tagName(): 'tag:yaml.org,2002:map';
-  items: Pair<K, V>[];
-  constructor(schema?: Schema);
-  /**
-   * A generic collection parsing method that can be extended
-   * to other node classes that inherit from YAMLMap
-   */
-  static from(schema: Schema, obj: unknown, ctx: CreateNodeContext): YAMLMap;
-  /**
-   * Adds a value to the collection.
-   *
-   * @param overwrite - If not set `true`, using a key that is already in the
-   *   collection will throw. Otherwise, overwrites the previous value.
-   */
-  add(pair: Pair<K, V> | {
-    key: K;
-    value: V;
-  }, overwrite?: boolean): void;
-  delete(key: unknown): boolean;
-  get(key: unknown, keepScalar: true): Scalar<V> | undefined;
-  get(key: unknown, keepScalar?: false): V | undefined;
-  get(key: unknown, keepScalar?: boolean): V | Scalar<V> | undefined;
-  has(key: unknown): boolean;
-  set(key: K, value: V): void;
-  /**
-   * @param ctx - Conversion context, originally set in Document#toJS()
-   * @param {Class} Type - If set, forces the returned collection type
-   * @returns Instance of Type, Map, or Object
-   */
-  toJSON<T extends MapLike = Map<unknown, unknown>>(_?: unknown, ctx?: ToJSContext, Type?: {
-    new (): T;
-  }): any;
-  toString(ctx?: StringifyContext, onComment?: () => void, onChompKeep?: () => void): string;
-}
-declare const MAP: unique symbol;
-declare const SCALAR: unique symbol;
-declare const SEQ: unique symbol;
-declare const NODE_TYPE: unique symbol;
-declare class Schema {
-  compat: Array<CollectionTag | ScalarTag> | null;
-  knownTags: Record<string, CollectionTag | ScalarTag>;
-  name: string;
-  sortMapEntries: ((a: Pair, b: Pair) => number) | null;
-  tags: Array<CollectionTag | ScalarTag>;
-  toStringOptions: Readonly<ToStringOptions> | null;
-  readonly [MAP]: CollectionTag;
-  readonly [SCALAR]: ScalarTag;
-  readonly [SEQ]: CollectionTag;
-  constructor({ compat, customTags, merge, resolveKnownTags, schema, sortMapEntries, toStringDefaults }: SchemaOptions);
-  clone(): Schema;
-}
-interface CreateNodeContext {
-  aliasDuplicateObjects: boolean;
-  keepUndefined: boolean;
-  onAnchor: (source: unknown) => string;
-  onTagObj?: (tagObj: ScalarTag | CollectionTag) => void;
-  sourceObjects: Map<unknown, {
-    anchor: string | null;
-    node: Node | null;
-  }>;
-  replacer?: Replacer;
-  schema: Schema;
-}
-declare function addPairToJSMap(ctx: ToJSContext | undefined, map: MapLike, { key, value }: Pair): MapLike;
-declare class Pair<K = unknown, V = unknown> {
-  readonly [NODE_TYPE]: symbol;
-  /** Always Node or null when parsed, but can be set to anything. */
-  key: K;
-  /** Always Node or null when parsed, but can be set to anything. */
-  value: V | null;
-  /** The CST token that was composed into this pair.  */
-  srcToken?: CollectionItem;
-  constructor(key: K, value?: V | null);
-  clone(schema?: Schema): Pair<K, V>;
-  toJSON(_?: unknown, ctx?: ToJSContext): ReturnType<typeof addPairToJSMap>;
-  toString(ctx?: StringifyContext, onComment?: () => void, onChompKeep?: () => void): string;
-}
-declare const tagsByName: {
-  binary: ScalarTag;
-  bool: ScalarTag & {
-    test: RegExp;
-  };
-  float: ScalarTag;
-  floatExp: ScalarTag;
-  floatNaN: ScalarTag;
-  floatTime: ScalarTag;
-  int: ScalarTag;
-  intHex: ScalarTag;
-  intOct: ScalarTag;
-  intTime: ScalarTag;
-  map: CollectionTag;
-  merge: ScalarTag & {
-    identify(value: unknown): boolean;
-    test: RegExp;
-  };
-  null: ScalarTag & {
-    test: RegExp;
-  };
-  omap: CollectionTag;
-  pairs: CollectionTag;
-  seq: CollectionTag;
-  set: CollectionTag;
-  timestamp: ScalarTag & {
-    test: RegExp;
-  };
-};
-type TagId = keyof typeof tagsByName;
-type Tags = Array<ScalarTag | CollectionTag | TagId>;
-type ParseOptions = {
-  /**
-   * Whether integers should be parsed into BigInt rather than number values.
-   *
-   * Default: `false`
-   *
-   * https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Global_Objects/BigInt
-   */
-  intAsBigInt?: boolean;
-  /**
-   * Include a `srcToken` value on each parsed `Node`, containing the CST token
-   * that was composed into this node.
-   *
-   * Default: `false`
-   */
-  keepSourceTokens?: boolean;
-  /**
-   * If set, newlines will be tracked, to allow for `lineCounter.linePos(offset)`
-   * to provide the `{ line, col }` positions within the input.
-   */
-  lineCounter?: LineCounter;
-  /**
-   * Include line/col position & node type directly in parse errors.
-   *
-   * Default: `true`
-   */
-  prettyErrors?: boolean;
-  /**
-   * Detect and report errors that are required by the YAML 1.2 spec,
-   * but are caused by unambiguous content.
-   *
-   * Default: `true`
-   */
-  strict?: boolean;
-  /**
-   * Parse all mapping keys as strings. Treat all non-scalar keys as errors.
-   *
-   * Default: `false`
-   */
-  stringKeys?: boolean;
-  /**
-   * YAML requires map keys to be unique. By default, this is checked by
-   * comparing scalar values with `===`; deep equality is not checked for
-   * aliases or collections. If merge keys are enabled by the schema,
-   * multiple `<<` keys are allowed.
-   *
-   * Set `false` to disable, or provide your own comparator function to
-   * customise. The comparator will be passed two `ParsedNode` values, and
-   * is expected to return a `boolean` indicating their equality.
-   *
-   * Default: `true`
-   */
-  uniqueKeys?: boolean | ((a: ParsedNode, b: ParsedNode) => boolean);
-};
-type DocumentOptions = {
-  
-  /**
-   * Control the logging level during parsing
-   *
-   * Default: `'warn'`
-   */
-  logLevel?: LogLevelId;
-  /**
-   * The YAML version used by documents without a `%YAML` directive.
-   *
-   * Default: `"1.2"`
-   */
-  version?: '1.1' | '1.2' | 'next';
-};
-type SchemaOptions = {
-  /**
-   * When parsing, warn about compatibility issues with the given schema.
-   * When stringifying, use scalar styles that are parsed correctly
-   * by the `compat` schema as well as the actual schema.
-   *
-   * Default: `null`
-   */
-  compat?: string | Tags | null;
-  /**
-   * Array of additional tags to include in the schema, or a function that may
-   * modify the schema's base tag array.
-   */
-  customTags?: Tags | ((tags: Tags) => Tags) | null;
-  /**
-   * Enable support for `<<` merge keys.
-   *
-   * Default: `false` for YAML 1.2, `true` for earlier versions
-   */
-  merge?: boolean;
-  /**
-   * When using the `'core'` schema, support parsing values with these
-   * explicit YAML 1.1 tags:
-   *
-   * `!!binary`, `!!omap`, `!!pairs`, `!!set`, `!!timestamp`.
-   *
-   * Default `true`
-   */
-  resolveKnownTags?: boolean;
-  /**
-   * The base schema to use.
-   *
-   * The core library has built-in support for the following:
-   * - `'failsafe'`: A minimal schema that parses all scalars as strings
-   * - `'core'`: The YAML 1.2 core schema
-   * - `'json'`: The YAML 1.2 JSON schema, with minimal rules for JSON compatibility
-   * - `'yaml-1.1'`: The YAML 1.1 schema
-   *
-   * If using another (custom) schema, the `customTags` array needs to
-   * fully define the schema's tags.
-   *
-   * Default: `'core'` for YAML 1.2, `'yaml-1.1'` for earlier versions
-   */
-  schema?: string | Schema;
-  /**
-   * When adding to or stringifying a map, sort the entries.
-   * If `true`, sort by comparing key values with `<`.
-   * Does not affect item order when parsing.
-   *
-   * Default: `false`
-   */
-  sortMapEntries?: boolean | ((a: Pair, b: Pair) => number);
-  /**
-   * Override default values for `toString()` options.
-   */
-  toStringDefaults?: ToStringOptions;
-};
-type CreateNodeOptions = {
-  /**
-   * During node construction, use anchors and aliases to keep strictly equal
-   * non-null objects as equivalent in YAML.
-   *
-   * Default: `true`
-   */
-  aliasDuplicateObjects?: boolean;
-  /**
-   * Default prefix for anchors.
-   *
-   * Default: `'a'`, resulting in anchors `a1`, `a2`, etc.
-   */
-  anchorPrefix?: string;
-  /** Force the top-level collection node to use flow style. */
-  flow?: boolean;
-  /**
-   * Keep `undefined` object values when creating mappings, rather than
-   * discarding them.
-   *
-   * Default: `false`
-   */
-  keepUndefined?: boolean | null;
-  onTagObj?: (tagObj: ScalarTag | CollectionTag) => void;
-  /**
-   * Specify the top-level collection type, e.g. `"!!omap"`. Note that this
-   * requires the corresponding tag to be available in this document's schema.
-   */
-  tag?: string;
-};
-type ToJSOptions = {
-  /**
-   * Use Map rather than Object to represent mappings.
-   *
-   * Default: `false`
-   */
-  mapAsMap?: boolean;
-  /**
-   * Prevent exponential entity expansion attacks by limiting data aliasing count;
-   * set to `-1` to disable checks; `0` disallows all alias nodes.
-   *
-   * Default: `100`
-   */
-  maxAliasCount?: number;
-  /**
-   * If defined, called with the resolved `value` and reference `count` for
-   * each anchor in the document.
-   */
-  onAnchor?: (value: unknown, count: number) => void;
-  /**
-   * Optional function that may filter or modify the output JS value
-   *
-   * https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/parse#using_the_reviver_parameter
-   */
-  reviver?: Reviver;
-};
-type ToStringOptions = {
-  /**
-   * Use block quote styles for scalar values where applicable.
-   * Set to `false` to disable block quotes completely.
-   *
-   * Default: `true`
-   */
-  blockQuote?: boolean | 'folded' | 'literal';
-  /**
-   * Enforce `'block'` or `'flow'` style on maps and sequences.
-   * Empty collections will always be stringified as `{}` or `[]`.
-   *
-   * Default: `'any'`, allowing each node to set its style separately
-   * with its `flow: boolean` (default `false`) property.
-   */
-  collectionStyle?: 'any' | 'block' | 'flow';
-  /**
-   * Comment stringifier.
-   * Output should be valid for the current schema.
-   *
-   * By default, empty comment lines are left empty,
-   * lines consisting of a single space are replaced by `#`,
-   * and all other lines are prefixed with a `#`.
-   */
-  commentString?: (comment: string) => string;
-  /**
-   * The default type of string literal used to stringify implicit key values.
-   * Output may use other types if required to fully represent the value.
-   *
-   * If `null`, the value of `defaultStringType` is used.
-   *
-   * Default: `null`
-   */
-  defaultKeyType?: Scalar.Type | null;
-  /**
-   * The default type of string literal used to stringify values in general.
-   * Output may use other types if required to fully represent the value.
-   *
-   * Default: `'PLAIN'`
-   */
-  defaultStringType?: Scalar.Type;
-  /**
-   * Include directives in the output.
-   *
-   * - If `true`, at least the document-start marker `---` is always included.
-   *   This does not force the `%YAML` directive to be included. To do that,
-   *   set `doc.directives.yaml.explicit = true`.
-   * - If `false`, no directives or marker is ever included. If using the `%TAG`
-   *   directive, you are expected to include it manually in the stream before
-   *   its use.
-   * - If `null`, directives and marker may be included if required.
-   *
-   * Default: `null`
-   */
-  directives?: boolean | null;
-  /**
-   * Restrict double-quoted strings to use JSON-compatible syntax.
-   *
-   * Default: `false`
-   */
-  doubleQuotedAsJSON?: boolean;
-  /**
-   * Minimum length for double-quoted strings to use multiple lines to
-   * represent the value. Ignored if `doubleQuotedAsJSON` is set.
-   *
-   * Default: `40`
-   */
-  doubleQuotedMinMultiLineLength?: number;
-  /**
-   * String representation for `false`.
-   * With the core schema, use `'false'`, `'False'`, or `'FALSE'`.
-   *
-   * Default: `'false'`
-   */
-  falseStr?: string;
-  /**
-   * When true, a single space of padding will be added inside the delimiters
-   * of non-empty single-line flow collections.
-   *
-   * Default: `true`
-   */
-  flowCollectionPadding?: boolean;
-  /**
-   * The number of spaces to use when indenting code.
-   *
-   * Default: `2`
-   */
-  indent?: number;
-  /**
-   * Whether block sequences should be indented.
-   *
-   * Default: `true`
-   */
-  indentSeq?: boolean;
-  /**
-   * Maximum line width (set to `0` to disable folding).
-   *
-   * This is a soft limit, as only double-quoted semantics allow for inserting
-   * a line break in the middle of a word, as well as being influenced by the
-   * `minContentWidth` option.
-   *
-   * Default: `80`
-   */
-  lineWidth?: number;
-  /**
-   * Minimum line width for highly-indented content (set to `0` to disable).
-   *
-   * Default: `20`
-   */
-  minContentWidth?: number;
-  /**
-   * String representation for `null`.
-   * With the core schema, use `'null'`, `'Null'`, `'NULL'`, `'~'`, or an empty
-   * string `''`.
-   *
-   * Default: `'null'`
-   */
-  nullStr?: string;
-  /**
-   * Require keys to be scalars and to use implicit rather than explicit notation.
-   *
-   * Default: `false`
-   */
-  simpleKeys?: boolean;
-  /**
-   * Use 'single quote' rather than "double quote" where applicable.
-   * Set to `false` to disable single quotes completely.
-   *
-   * Default: `null`
-   */
-  singleQuote?: boolean | null;
-  /**
-   * Add a trailing comma after the last entry in a flow map or flow sequence that's split across multiple lines.
-   *
-   * Default: `'false'`
-   */
-  trailingComma?: boolean;
-  /**
-   * String representation for `true`.
-   * With the core schema, use `'true'`, `'True'`, or `'TRUE'`.
-   *
-   * Default: `'true'`
-   */
-  trueStr?: string;
-  /**
-   * The anchor used by an alias must be defined before the alias node. As it's
-   * possible for the document to be modified manually, the order may be
-   * verified during stringification.
-   *
-   * Default: `'true'`
-   */
-  verifyAliasOrder?: boolean;
-};
-type Node<T = unknown> = Alias | Scalar<T> | YAMLMap<unknown, T> | YAMLSeq<T>;
-/** Utility type mapper */
-type NodeType<T> = T extends string | number | bigint | boolean | null | undefined ? Scalar<T> : T extends Date ? Scalar<string | Date> : T extends Array<any> ? YAMLSeq<NodeType<T[number]>> : T extends {
-  [key: string]: any;
-} ? YAMLMap<NodeType<keyof T>, NodeType<T[keyof T]>> : T extends {
-  [key: number]: any;
-} ? YAMLMap<NodeType<keyof T>, NodeType<T[keyof T]>> : Node;
-type ParsedNode = Alias.Parsed | Scalar.Parsed | YAMLMap.Parsed | YAMLSeq.Parsed;
-/** `[start, value-end, node-end]` */
-type Range = [number, number, number];
-declare abstract class NodeBase {
-  readonly [NODE_TYPE]: symbol;
-  /** A comment on or immediately after this */
-  comment?: string | null;
-  /** A comment before this */
-  commentBefore?: string | null;
-  /**
-   * The `[start, value-end, node-end]` character offsets for the part of the
-   * source parsed into this node (undefined if not parsed). The `value-end`
-   * and `node-end` positions are themselves not included in their respective
-   * ranges.
-   */
-  range?: Range | null;
-  /** A blank line before this node and its commentBefore */
-  spaceBefore?: boolean;
-  /** The CST token that was composed into this node.  */
-  srcToken?: Token;
-  /** A fully qualified tag, if required */
-  tag?: string;
-  /**
-   * Customize the way that a key-value pair is resolved.
-   * Used for YAML 1.1 !!merge << handling.
-   */
-  addToJSMap?: (ctx: ToJSContext | undefined, map: MapLike, value: unknown) => void;
-  /** A plain JS representation of this node */
-  abstract toJSON(): any;
-  abstract toString(ctx?: StringifyContext, onComment?: () => void, onChompKeep?: () => void): string;
-  constructor(type: symbol);
-  /** Create a copy of this node.  */
-  clone(): NodeBase;
-  /** A plain JavaScript representation of this node. */
-  toJS(doc: Document<Node, boolean>, { mapAsMap, maxAliasCount, onAnchor, reviver }?: ToJSOptions): any;
-}
-interface SourceToken {
-  type: 'byte-order-mark' | 'doc-mode' | 'doc-start' | 'space' | 'comment' | 'newline' | 'directive-line' | 'anchor' | 'tag' | 'seq-item-ind' | 'explicit-key-ind' | 'map-value-ind' | 'flow-map-start' | 'flow-map-end' | 'flow-seq-start' | 'flow-seq-end' | 'flow-error-end' | 'comma' | 'block-scalar-header';
-  offset: number;
-  indent: number;
-  source: string;
-}
-interface ErrorToken {
-  type: 'error';
-  offset: number;
-  source: string;
-  message: string;
-}
-interface Directive {
-  type: 'directive';
-  offset: number;
-  source: string;
-}
-interface Document$1 {
-  type: 'document';
-  offset: number;
-  start: SourceToken[];
-  value?: Token;
-  end?: SourceToken[];
-}
-interface DocumentEnd {
-  type: 'doc-end';
-  offset: number;
-  source: string;
-  end?: SourceToken[];
-}
-interface FlowScalar {
-  type: 'alias' | 'scalar' | 'single-quoted-scalar' | 'double-quoted-scalar';
-  offset: number;
-  indent: number;
-  source: string;
-  end?: SourceToken[];
-}
-interface BlockScalar {
-  type: 'block-scalar';
-  offset: number;
-  indent: number;
-  props: Token[];
-  source: string;
-}
-interface BlockMap {
-  type: 'block-map';
-  offset: number;
-  indent: number;
-  items: Array<{
-    start: SourceToken[];
-    explicitKey?: true;
-    key?: never;
-    sep?: never;
-    value?: never;
-  } | {
-    start: SourceToken[];
-    explicitKey?: true;
-    key: Token | null;
-    sep: SourceToken[];
-    value?: Token;
-  }>;
-}
-interface BlockSequence {
-  type: 'block-seq';
-  offset: number;
-  indent: number;
-  items: Array<{
-    start: SourceToken[];
-    key?: never;
-    sep?: never;
-    value?: Token;
-  }>;
-}
-type CollectionItem = {
-  start: SourceToken[];
-  key?: Token | null;
-  sep?: SourceToken[];
-  value?: Token;
-};
-interface FlowCollection {
-  type: 'flow-collection';
-  offset: number;
-  indent: number;
-  start: SourceToken;
-  items: CollectionItem[];
-  end: SourceToken[];
-}
-type Token = SourceToken | ErrorToken | Directive | Document$1 | DocumentEnd | FlowScalar | BlockScalar | BlockMap | BlockSequence | FlowCollection;
-declare namespace Alias {
-  interface Parsed extends Alias {
-    range: Range;
-    srcToken?: FlowScalar & {
-      type: 'alias';
-    };
-  }
-}
-declare class Alias extends NodeBase {
-  source: string;
-  anchor?: never;
-  constructor(source: string);
-  /**
-   * Resolve the value of this alias within `doc`, finding the last
-   * instance of the `source` anchor before this node.
-   */
-  resolve(doc: Document, ctx?: ToJSContext): Scalar | YAMLMap | YAMLSeq | undefined;
-  toJSON(_arg?: unknown, ctx?: ToJSContext): unknown;
-  toString(ctx?: StringifyContext, _onComment?: () => void, _onChompKeep?: () => void): string;
-}
-type Replacer = any[] | ((key: any, value: any) => unknown);
-declare namespace Document {
-  /** @ts-ignore The typing of directives fails in TS <= 4.2 */
-  interface Parsed<Contents extends ParsedNode = ParsedNode, Strict extends boolean = true> extends Document<Contents, Strict> {
-    directives: Directives;
-    range: Range;
-  }
-}
-declare class Document<Contents extends Node = Node, Strict extends boolean = true> {
-  readonly [NODE_TYPE]: symbol;
-  /** A comment before this Document */
-  commentBefore: string | null;
-  /** A comment immediately after this Document */
-  comment: string | null;
-  /** The document contents. */
-  contents: Strict extends true ? Contents | null : Contents;
-  directives: Strict extends true ? Directives | undefined : Directives;
-  /** Errors encountered during parsing. */
-  errors: YAMLError[];
-  options: Required<Omit<ParseOptions & DocumentOptions, '_directives' | 'lineCounter' | 'version'>>;
-  /**
-   * The `[start, value-end, node-end]` character offsets for the part of the
-   * source parsed into this document (undefined if not parsed). The `value-end`
-   * and `node-end` positions are themselves not included in their respective
-   * ranges.
-   */
-  range?: Range;
-  /** The schema used with the document. Use `setSchema()` to change. */
-  schema: Schema;
-  /** Warnings encountered during parsing. */
-  warnings: YAMLWarning[];
-  /**
-   * @param value - The initial value for the document, which will be wrapped
-   *   in a Node container.
-   */
-  constructor(value?: any, options?: DocumentOptions & SchemaOptions & ParseOptions & CreateNodeOptions);
-  constructor(value: any, replacer: null | Replacer, options?: DocumentOptions & SchemaOptions & ParseOptions & CreateNodeOptions);
-  /**
-   * Create a deep copy of this Document and its contents.
-   *
-   * Custom Node values that inherit from `Object` still refer to their original instances.
-   */
-  clone(): Document<Contents, Strict>;
-  /** Adds a value to the document. */
-  add(value: any): void;
-  /** Adds a value to the document. */
-  addIn(path: Iterable<unknown>, value: unknown): void;
-  /**
-   * Create a new `Alias` node, ensuring that the target `node` has the required anchor.
-   *
-   * If `node` already has an anchor, `name` is ignored.
-   * Otherwise, the `node.anchor` value will be set to `name`,
-   * or if an anchor with that name is already present in the document,
-   * `name` will be used as a prefix for a new unique anchor.
-   * If `name` is undefined, the generated anchor will use 'a' as a prefix.
-   */
-  createAlias(node: Strict extends true ? Scalar | YAMLMap | YAMLSeq : Node, name?: string): Alias;
-  /**
-   * Convert any value into a `Node` using the current schema, recursively
-   * turning objects into collections.
-   */
-  createNode<T = unknown>(value: T, options?: CreateNodeOptions): NodeType<T>;
-  createNode<T = unknown>(value: T, replacer: Replacer | CreateNodeOptions | null, options?: CreateNodeOptions): NodeType<T>;
-  /**
-   * Convert a key and a value into a `Pair` using the current schema,
-   * recursively wrapping all values as `Scalar` or `Collection` nodes.
-   */
-  createPair<K extends Node = Node, V extends Node = Node>(key: unknown, value: unknown, options?: CreateNodeOptions): Pair<K, V>;
-  /**
-   * Removes a value from the document.
-   * @returns `true` if the item was found and removed.
-   */
-  delete(key: unknown): boolean;
-  /**
-   * Removes a value from the document.
-   * @returns `true` if the item was found and removed.
-   */
-  deleteIn(path: Iterable<unknown> | null): boolean;
-  /**
-   * Returns item at `key`, or `undefined` if not found. By default unwraps
-   * scalar values from their surrounding node; to disable set `keepScalar` to
-   * `true` (collections are always returned intact).
-   */
-  get(key: unknown, keepScalar?: boolean): Strict extends true ? unknown : any;
-  /**
-   * Returns item at `path`, or `undefined` if not found. By default unwraps
-   * scalar values from their surrounding node; to disable set `keepScalar` to
-   * `true` (collections are always returned intact).
-   */
-  getIn(path: Iterable<unknown> | null, keepScalar?: boolean): Strict extends true ? unknown : any;
-  /**
-   * Checks if the document includes a value with the key `key`.
-   */
-  has(key: unknown): boolean;
-  /**
-   * Checks if the document includes a value at `path`.
-   */
-  hasIn(path: Iterable<unknown> | null): boolean;
-  /**
-   * Sets a value in this document. For `!!set`, `value` needs to be a
-   * boolean to add/remove the item from the set.
-   */
-  set(key: any, value: unknown): void;
-  /**
-   * Sets a value in this document. For `!!set`, `value` needs to be a
-   * boolean to add/remove the item from the set.
-   */
-  setIn(path: Iterable<unknown> | null, value: unknown): void;
-  /**
-   * Change the YAML version and schema used by the document.
-   * A `null` version disables support for directives, explicit tags, anchors, and aliases.
-   * It also requires the `schema` option to be given as a `Schema` instance value.
-   *
-   * Overrides all previously set schema options.
-   */
-  setSchema(version: '1.1' | '1.2' | 'next' | null, options?: SchemaOptions): void;
-  /** A plain JavaScript representation of the document `contents`. */
-  toJS(opt?: ToJSOptions & {
-    [ignored: string]: unknown;
-  }): any;
-  /**
-   * A JSON representation of the document `contents`.
-   *
-   * @param jsonArg Used by `JSON.stringify` to indicate the array index or
-   *   property name.
-   */
-  toJSON(jsonArg?: string | null, onAnchor?: ToJSOptions['onAnchor']): any;
-  /** A YAML representation of the document. */
-  toString(options?: ToStringOptions): string;
-}
-declare class Directives {
-  static defaultYaml: Directives['yaml'];
-  static defaultTags: Directives['tags'];
-  yaml: {
-    version: '1.1' | '1.2' | 'next';
-    explicit?: boolean;
-  };
-  tags: Record<string, string>;
-  /**
-   * The directives-end/doc-start marker `---`. If `null`, a marker may still be
-   * included in the document's stringified representation.
-   */
-  docStart: true | null;
-  /** The doc-end marker `...`.  */
-  docEnd: boolean;
-  /**
-   * Used when parsing YAML 1.1, where:
-   * > If the document specifies no directives, it is parsed using the same
-   * > settings as the previous document. If the document does specify any
-   * > directives, all directives of previous documents, if any, are ignored.
-   */
-  private atNextDocument?;
-  constructor(yaml?: Directives['yaml'], tags?: Directives['tags']);
-  clone(): Directives;
-  /**
-   * During parsing, get a Directives instance for the current document and
-   * update the stream state according to the current version's spec.
-   */
-  atDocument(): Directives;
-  /**
-   * @param onError - May be called even if the action was successful
-   * @returns `true` on success
-   */
-  add(line: string, onError: (offset: number, message: string, warning?: boolean) => void): boolean;
-  /**
-   * Resolves a tag, matching handles to those defined in %TAG directives.
-   *
-   * @returns Resolved tag, which may also be the non-specific tag `'!'` or a
-   *   `'!local'` tag, or `null` if unresolvable.
-   */
-  tagName(source: string, onError: (message: string) => void): string | null;
-  /**
-   * Given a fully resolved tag, returns its printable string form,
-   * taking into account current tag prefixes and defaults.
-   */
-  tagString(tag: string): string;
-  toString(doc?: Document): string;
-}
-/**
- * Constant to check if the path is visible to the calling process.
- * Corresponds to `node:fs.constants.F_OK`.
- */
-declare const F_OK: number;
-/**
- * Constant to check if the path is readable to the calling process.
- * Corresponds to `node:fs.constants.R_OK`.
- */
-declare const R_OK: number;
-/**
- * Constant to check if the path is writable to the calling process.
- * Corresponds to `node:fs.constants.W_OK`.
- */
-declare const W_OK: number;
-/**
- * Constant to check if the path is executable by the calling process.
- * Corresponds to `node:fs.constants.X_OK`.
- */
-declare const X_OK: number;
-/**
- * A special symbol that can be returned by the matcher function in `findUp` or `findUpSync`
- * to stop the search process prematurely.
- */
-declare const FIND_UP_STOP: symbol;
-type ColorizeMethod = (value: string) => string;
-/**
- * Options accepted by `jsonc-parser`'s `parse` function.
- */
-type JsoncParseOptions = {
-  /**
-   * Allow empty content as a valid input. Defaults to `false`.
-   */
-  allowEmptyContent?: boolean;
-  /**
-   * Allow trailing commas in arrays and objects. Defaults to `false`.
-   */
-  allowTrailingComma?: boolean;
-  /**
-   * Disallow JavaScript-style comments in the input. Defaults to `false` (comments allowed).
-   */
-  disallowComments?: boolean;
-};
-/**
- * Formatting options for `jsonc-parser` edits.
- */
-type JsoncFormattingOptions = {
-  /**
-   * The line ending to use in the output.
-   */
-  eol?: string;
-  /**
-   * When `true`, insert a final newline when the output does not end with one.
-   */
-  insertFinalNewline?: boolean;
-  /**
-   * Indent with spaces (`true`) or tabs (`false`). Defaults to `true`.
-   */
-  insertSpaces?: boolean;
-  /**
-   * When `true`, attempt to keep the original line structure when applying edits.
-   */
-  keepLines?: boolean;
-  /**
-   * Indent size when {@link JsoncFormattingOptions.insertSpaces | insertSpaces} is `true`.
-   */
-  tabSize?: number;
-};
-/**
- * Options accepted by the `ini` library's `stringify` / `encode` functions.
- * Kept as a local definition so the types compile without the optional peer installed.
- */
-type IniEncodeOptions = {
-  /**
-   * Align `=` signs across the output.
-   */
-  align?: boolean;
-  /**
-   * Serialize array values using the `key[]` convention. Defaults to `true`.
-   */
-  bracketedArray?: boolean;
-  /**
-   * Append a trailing newline to every section.
-   */
-  newline?: boolean;
-  /**
-   * Target platform for section/key escaping. Defaults to the current platform.
-   */
-  platform?: string;
-  /**
-   * Name of the top-level section.
-   */
-  section?: string;
-  /**
-   * Sort keys alphabetically within sections.
-   */
-  sort?: boolean;
-  /**
-   * Write `key = value` with spaces around `=`. Defaults to `false`.
-   */
-  whitespace?: boolean;
-};
-/**
- * Replacer accepted by `JSON5.stringify()`.
- */
-type Json5Replacer = (number | string)[] | ((this: unknown, key: string, value: unknown) => unknown) | null;
-/**
- * Options for the `glob` and `globSync` functions.
- *
- * Re-exported from [`tinyglobby`](https://github.com/SuperchupuDev/tinyglobby) (which is bundled into the built
- * output, with a local patch adding negated-ignore support). The `ignore` option accepts leading-`!` patterns to
- * _un-ignore_ entries — for example `ignore: ["dist/**", "!dist/index.d.ts"]` drops the `dist/` tree except for
- * its type entry point.
- */
-type GlobOptions = Omit<GlobOptions$1, "patterns">;
-/**
- * Options for the `walk` and `walkSync` functions.
- */
-interface WalkOptions {
-  /**
-   * List of file extensions used to filter entries.
-   * If specified, entries without the file extension specified by this option are excluded.
-   * @default {undefined}
-   */
-  extensions?: string[];
-  /**
-   * Indicates whether symlinks should be resolved or not.
-   * @default {false}
-   */
-  followSymlinks?: boolean;
-  /**
-   * Indicates whether directory entries should be included or not.
-   * @default {true}
-   */
-  includeDirs?: boolean;
-  /**
-   * Indicates whether file entries should be included or not.
-   * @default {true}
-   */
-  includeFiles?: boolean;
-  /**
-   * Indicates whether symlink entries should be included or not.
-   * This option is meaningful only if `followSymlinks` is set to `false`.
-   * @default {true}
-   */
-  includeSymlinks?: boolean;
-  /**
-   * List of regular expression or glob patterns used to filter entries.
-   * If specified, entries that do not match the patterns specified by this option are excluded.
-   * @default {undefined}
-   */
-  match?: (RegExp | string)[];
-  /**
-   * The maximum depth of the file tree to be walked recursively.
-   * @default {Infinity}
-   */
-  maxDepth?: number;
-  /**
-   * List of regular expression or glob patterns used to filter entries.
-   * If specified, entries matching the patterns specified by this option are excluded.
-   * @default {undefined}
-   */
-  skip?: (RegExp | string)[];
-}
-/**
- * Represents an entry found by `walk` or `walkSync`.
- */
-interface WalkEntry extends Pick<Dirent, "isDirectory" | "isFile" | "isSymbolicLink" | "name"> {
-  /** The full path to the entry. */
-  path: string;
-}
-/**
- * Supported compression types for file operations.
- */
-type CompressionType = "brotli" | "gzip" | "none";
-/**
- * Supported file encodings for reading files.
- */
-type ReadFileEncoding = "ascii" | "base64" | "base64url" | "hex" | "latin1" | "ucs-2" | "ucs2" | "utf-8" | "utf-16le" | "utf8" | "utf16le";
-/**
- * Options for reading files.
- */
-type ReadFileOptions<C> = {
-  /**
-   * Return content as a Buffer. Default: `false`
-   */
-  buffer?: boolean;
-  /**
-   * Compression method to decompress the file against. Default: `none`
-   */
-  compression?: C;
-  /**
-   * The encoding to use. Default: `utf8`
-   * @see https://nodejs.org/api/buffer.html#buffer_buffers_and_character_encodings
-   */
-  encoding?: ReadFileEncoding;
-  /**
-   * The flag used to open the file. Default: `r`
-   */
-  flag?: number | string;
-};
-/**
- * Represents the content type of a read file, which can be a Buffer or a string based on options.
- * @template O - The ReadFileOptions type.
- */
-type ContentType<O = undefined> = O extends {
-  buffer: true;
-} ? Buffer : string;
-/**
- * Type for the `reviver` parameter of `JSON.parse()`.
- * A function that transforms the results. This function is called for each member of the object.
- * If a member contains nested objects, the nested objects are transformed before the parent object is.
- */
-type JsonReviver = Parameters<(typeof JSON)["parse"]>["1"];
-/**
- * Specifies a location (line and column) in a file for code frame generation.
- */
-type CodeFrameLocation = {
-  /** The column number. */
-  column?: number;
-  /** The line number. */
-  line: number;
-};
-/**
- * Options for customizing the appearance of code frames.
- */
-type CodeFrameOptions = {
-  /** Colorization methods for different parts of the code frame. */
-  color?: {
-    /** Color for the gutter (line numbers). */
-    gutter?: ColorizeMethod;
-    /** Color for the marker (pointing to the error). */
-    marker?: ColorizeMethod;
-    /** Color for the message. */
-    message?: ColorizeMethod;
-  };
-};
-/**
- * Options for reading and parsing JSON files.
- * Extends {@link CodeFrameOptions}.
- */
-type ReadJsonOptions = CodeFrameOptions & {
-  /**
-   * A function to transform the string content before parsing.
-   * @param source The raw string content of the file.
-   * @returns The transformed string content.
-   */
-  beforeParse?: (source: string) => string;
-};
-/**
- * Options for writing files.
- */
-type WriteFileOptions = {
-  /**
-   * When `true` and the target file already exists, the previous contents are
-   * preserved by renaming the existing file to `${path}.bak` before the new
-   * contents are written. This is independent of {@link WriteFileOptions.overwrite}.
-   *
-   * Default: `false`
-   */
-  backup?: boolean;
-  /**
-   * The group and user ID used to set the file ownership. Default: `undefined`
-   */
-  chown?: {
-    gid: number;
-    uid: number;
-  };
-  /**
-   * The encoding to use. Default: `utf8`
-   */
-  encoding?: BufferEncoding | null;
-  /**
-   * The flag used to write the file. Append flags (containing `a`) concatenate
-   * the new contents onto the existing file; exclusive flags (containing `x`)
-   * throw an `AlreadyExistsError` when the file already exists. Default: `w`
-   */
-  flag?: string;
-  /**
-   * The file mode (permission and sticky bits). Default: `0o666`
-   */
-  mode?: number;
-  /**
-   * Indicates whether the file should be overwritten if it already exists.
-   * When `false` and the target already exists, an `AlreadyExistsError` is thrown.
-   *
-   * Default: `true`
-   */
-  overwrite?: boolean;
-  /**
-   * Recursively create parent directories if needed. Default: `true`
-   */
-  recursive?: boolean;
-};
-/**
- * Type for the `replacer` parameter of `JSON.stringify()`.
- * Can be a function that alters the behavior of the stringification process,
- * or an array of strings and numbers that acts as a whitelist for selecting
- * the properties of the value object to be included in the JSON string.
- * If this value is null or not provided, all properties of the object are included in the resulting JSON string.
- */
-type JsonReplacer = (number | string)[] | ((this: unknown, key: string, value: unknown) => unknown) | null;
-/**
- * Type for the `replacer` parameter used in YAML serialization, similar to `JSON.stringify`'s replacer.
- * @deprecated Use {@link JsonReplacer} directly instead.
- */
-type YamlReplacer = JsonReplacer;
-/**
- * Options for writing JSON files.
- * Extends {@link WriteFileOptions}.
- */
-type WriteJsonOptions = WriteFileOptions & {
-  /**
-   * Detect indentation automatically if the file exists. Default: `false`
-   */
-  detectIndent?: boolean;
-  /**
-   * The space used for pretty-printing.
-   *
-   * Pass in `undefined` for no formatting.
-   */
-  indent?: number | string;
-  /**
-   * Passed into `JSON.stringify`.
-   */
-  replacer?: JsonReplacer;
-  /**
-   * Override the default `JSON.stringify` method.
-   */
-  stringify?: (data: unknown, replacer: JsonReplacer, space: number | string | undefined) => string;
-};
-/**
- * Options for the `findUp` and `findUpSync` functions.
- */
-type FindUpOptions = {
-  /**
-   * Whether to follow symbolic links.
-   * @default undefined (behaves like `true` for `findUp`, `false` for `findUpSync` due to `fs.stat` vs `fs.lstat`)
-   */
-  allowSymlinks?: boolean;
-  /**
-   * The current working directory.
-   * @default process.cwd()
-   */
-  cwd?: URL | string;
-  /**
-   * The directory to stop searching at.
-   * @default path.parse(cwd).root
-   */
-  stopAt?: URL | string;
-  /**
-   * The type of path to find.
-   * @default "file"
-   */
-  type?: "directory" | "file";
-};
-/**
- * The result type for the name matcher function used in `findUp`.
- * It can be a `PathLike` (string, Buffer, or URL), a Promise resolving to `PathLike` or `FIND_UP_STOP`,
- * `FIND_UP_STOP` to stop the search, or `undefined` to continue.
- */
-type FindUpNameFnResult = PathLike | Promise<PathLike | typeof FIND_UP_STOP> | typeof FIND_UP_STOP | undefined;
-/**
- * Specifies the name(s) of the file or directory to search for in `findUp`.
- * Can be a single name, an array of names, or a function that returns a name or `FIND_UP_STOP`.
- */
-type FindUpName = string[] | string | ((directory: string) => FindUpNameFnResult);
-/**
- * The result type for the name matcher function used in `findUpSync`.
- * It can be a `PathLike` (string, Buffer, or URL), `FIND_UP_STOP` to stop the search,
- * or `undefined` to continue.
- */
-type FindUpNameSyncFnResult = PathLike | typeof FIND_UP_STOP | undefined;
-/**
- * Specifies the name(s) of the file or directory to search for in `findUpSync`.
- * Can be a single name, an array of names, or a function that returns a name or `FIND_UP_STOP`.
- */
-type FindUpNameSync = string[] | string | ((directory: string) => FindUpNameSyncFnResult);
-/**
- * Options for operations that might require retries, like `emptyDir` or `remove`.
- */
-type RetryOptions = {
-  /**
-   * If an `EBUSY`, `EMFILE`, `ENFILE`, `ENOTEMPTY`, or
-   * `EPERM` error is encountered, Node.js will retry the operation with a linear
-   * backoff wait of `retryDelay` ms longer on each try. This option represents the
-   * number of retries. This option is ignored if the `recursive` option is not
-   * `true` for operations that support it (like `rm`).
-   * @default 0
-   */
-  maxRetries?: number;
-  /**
-   * The amount of time in milliseconds to wait between retries.
-   * This option is ignored if the `recursive` option is not `true` for operations that support it.
-   * @default 100
-   */
-  retryDelay?: number;
-};
-/**
- * Options for reading YAML files.
- * Combines options from `yaml` library (DocumentOptions, ParseOptions, SchemaOptions, ToJSOptions)
- * and custom {@link ReadFileOptions}.
- */
-type ReadYamlOptions<C> = DocumentOptions & ParseOptions & ReadFileOptions<C> & SchemaOptions & ToJSOptions;
-/**
- * Type for the `reviver` parameter used in YAML deserialization, similar to `JSON.parse`'s reviver.
- * A function that transforms the results. This function is called for each member of the object.
- * If a member contains nested objects, the nested objects are transformed before the parent object is.
- */
-type YamlReviver = (key: unknown, value: unknown) => unknown;
-/**
- * Options for writing YAML files.
- * Extends {@link WriteFileOptions} and includes options from the `yaml` library for stringification.
- */
-type WriteYamlExtras = {
-  /**
-   * Passed into `yaml.stringify` as the replacer argument.
-   */
-  replacer?: JsonReplacer;
-  /**
-   * Passed into `yaml.stringify` as the space argument for indentation.
-   * Can be a number of spaces or a string (e.g., a tab character).
-   */
-  space?: number | string;
-};
-type WriteYamlOptions = CreateNodeOptions & DocumentOptions & ParseOptions & SchemaOptions & ToStringOptions & WriteFileOptions & WriteYamlExtras;
-/**
- * Options for reading TOML files.
- * Uses `smol-toml`, which does not expose additional parse options.
- */
-type ReadTomlOptions<C> = ReadFileOptions<C>;
-/**
- * Options for writing TOML files.
- * Extends {@link WriteFileOptions}. `smol-toml` does not expose additional stringify options.
- */
-type WriteTomlOptions = WriteFileOptions;
-/**
- * Extra options for JSONC parsing on top of file-reading and code-frame options.
- */
-type ReadJsoncExtras = {
-  /**
-   * A function to transform the string content before parsing.
-   * @param source The raw string content of the file.
-   * @returns The transformed string content.
-   */
-  beforeParse?: (source: string) => string;
-};
-/**
- * Options for reading JSONC (JSON with comments) files.
- * Combines options from `jsonc-parser` and custom {@link ReadFileOptions} and {@link CodeFrameOptions}.
- */
-type ReadJsoncOptions<C> = CodeFrameOptions & JsoncParseOptions & ReadFileOptions<C> & ReadJsoncExtras;
-/**
- * Options for writing JSONC files with optional comment preservation.
- * Extends {@link WriteFileOptions}.
- */
-type WriteJsoncOptions = WriteFileOptions & {
-  /**
-   * Detect indentation automatically if the file exists. Default: `false`.
-   */
-  detectIndent?: boolean;
-  /**
-   * Formatting options forwarded to `jsonc-parser` when modifying existing files.
-   */
-  formattingOptions?: JsoncFormattingOptions;
-  /**
-   * Indentation used when writing a fresh file (no existing file to preserve).
-   * Default: `"\t"`.
-   */
-  indent?: number | string;
-  /**
-   * When `true` and the file already exists, preserve existing comments and formatting
-   * by computing a minimal diff against the new data via `jsonc-parser`'s `modify` API. Default: `true`.
-   */
-  preserveComments?: boolean;
-  /**
-   * Passed into `JSON.stringify` when writing a fresh file.
-   */
-  replacer?: JsonReplacer;
-};
-/**
- * Type for the `reviver` parameter of `JSON5.parse()`.
- */
-type Json5Reviver = (this: unknown, key: string, value: unknown) => unknown;
-/**
- * Extra options for JSON5 parsing on top of file-reading and code-frame options.
- */
-type ReadJson5Extras = {
-  /**
-   * A function to transform the string content before parsing.
-   */
-  beforeParse?: (source: string) => string;
-};
-/**
- * Options for reading JSON5 files.
- */
-type ReadJson5Options<C> = CodeFrameOptions & ReadFileOptions<C> & ReadJson5Extras;
-/**
- * Options for writing JSON5 files.
- * Extends {@link WriteFileOptions}.
- */
-type WriteJson5Options = WriteFileOptions & {
-  /**
-   * Detect indentation automatically if the file exists. Default: `false`.
-   */
-  detectIndent?: boolean;
-  /**
-   * Indentation for pretty-printing.
-   */
-  indent?: number | string;
-  /**
-   * Override the quote character used for strings. See `JSON5.stringify`.
-   */
-  quote?: string;
-  /**
-   * Passed into `JSON5.stringify`.
-   */
-  replacer?: Json5Replacer;
-};
-/**
- * Options for reading INI files.
- */
-type ReadIniOptions<C> = ReadFileOptions<C> & {
-  /**
-   * Parse array values (keys ending with `[]`) into native arrays. Default: `true`.
-   */
-  bracketedArray?: boolean;
-};
-/**
- * Supported INI line-ending values.
- */
-type IniLineEnding = "\n" | "\r\n";
-/**
- * Extra options for INI writing on top of the `ini` encoder options and file-writing options.
- */
-type WriteIniExtras = {
-  /**
-   * Line ending to write. When omitted and {@link WriteIniOptions.preserveStyle | preserveStyle} is `true`,
-   * the line ending is auto-detected from the existing file. Falls back to `"\n"` otherwise.
-   */
-  eol?: IniLineEnding;
-  /**
-   * When `true` and the file already exists, auto-detect and preserve styling described on this type.
-   * Defaults to `true`. Explicit `whitespace` / `eol` values always win over detection.
-   */
-  preserveStyle?: boolean;
-};
-/**
- * Options for writing INI files.
- *
- * Extends {@link WriteFileOptions} and `ini`'s {@link IniEncodeOptions}. When an existing file is present and
- * {@link WriteIniOptions.preserveStyle | preserveStyle} is `true` (the default), the following styling is
- * detected from that file and applied unless overridden: space around `=` (via {@link IniEncodeOptions.whitespace | whitespace}),
- * line ending (via {@link WriteIniOptions.eol | eol}), and per-key original lines (including trailing
- * whitespace and inline `;` / `#` comments) for unchanged values.
- */
-type WriteIniOptions = IniEncodeOptions & WriteFileOptions & WriteIniExtras;
-export { CodeFrameLocation as A, FIND_UP_STOP as B, CompressionType as C, F_OK as D, FindUpNameFnResult as E, FindUpName as F, GlobOptions as G, FindUpNameSyncFnResult as H, IniEncodeOptions as I, Json5Reviver as J, R_OK as K, ReadFileEncoding as L, W_OK as M, ReadIniOptions as R, WriteIniOptions as W, X_OK as X, YamlReviver as Y, IniLineEnding as a, ReadJson5Options as b, WriteJson5Options as c, Json5Replacer as d, ReadJsoncOptions as e, WriteJsoncOptions as f, JsoncFormattingOptions as g, JsoncParseOptions as h, ReadTomlOptions as i, WriteTomlOptions as j, CodeFrameOptions as k, JsonReviver as l, ReadYamlOptions as m, WriteYamlOptions as n, JsonReplacer as o, YamlReplacer as p, WalkOptions as q, FindUpOptions as r, FindUpNameSync as s, WalkEntry as t, ReadFileOptions as u, ContentType as v, ReadJsonOptions as w, RetryOptions as x, WriteFileOptions as y, WriteJsonOptions as z };