@staticbolt/core 1.0.0-beta.3 → 1.0.0-beta.30

package/lib/index.d.mts

@@ -1,21 +1,18 @@
-import { basename, extname, isAbsolute, parse, resolve } from "node:path";
-import { Document, HTMLElement, HTMLElement as HTMLElement$1, Node } from "@staticbolt/node-html-parser";
-import postcss, { Node as Node$1, Postcss } from "postcss";
-import { NodePath as NodePath$1 } from "@babel/traverse";
 import { ObjectEncodingOptions, OpenMode, PathLike, PathOrFileDescriptor } from "node:fs";
+import { basename, extname, isAbsolute, parse as parse$1, resolve } from "node:path";
 import { FileHandle } from "node:fs/promises";
-import * as t from "@babel/types";
+import { Document, HTMLElement, HTMLElement as HTMLElement$1, Node } from "@staticbolt/node-html-parser";
+import postcss, { Node as Node$1, Postcss } from "postcss";
+import { NodePath, NodePath as NodePath$1 } from "@babel/traverse";
 import { Node as Node$2 } from "@babel/types";
 import { ParseResult } from "@babel/parser";
 import { onRequestHookHandler } from "fastify";
-import { FSWatcher } from "chokidar";
 import * as z from "zod";
-import * as _$_staticbolt_args_parser0 from "@staticbolt/args-parser";
+import { FSWatcher } from "chokidar";
 import { Argument, Option, Subcommand, defineArguments, defineOptions, defineSubcommand } from "@staticbolt/args-parser";
-import { App as App$1, AppConfig as AppConfig$1, BabelAst as BabelAst$1, BinaryAssetMetadata as BinaryAssetMetadata$1, CliProgram as CliProgram$1, Document as Document$1, HTMLElement as HTMLElement$2, HtmlMetadata as HtmlMetadata$1, MarkdownAst as MarkdownAst$1, MarkdownMetadata as MarkdownMetadata$1, MetadataBase as MetadataBase$1, MetadataSource as MetadataSource$1, PackageMetadata as PackageMetadata$1, Plugin as Plugin$1, PostcssAst as PostcssAst$1, ScriptMetadata as ScriptMetadata$1, ServerReply as ServerReply$1, ServerRequest as ServerRequest$1, StyleMetadata as StyleMetadata$1, SvgMetadata as SvgMetadata$1, TextAssetMetadata as TextAssetMetadata$1, WebManifestMetadata as WebManifestMetadata$1 } from "@staticbolt/core";
+import { App as App$1, AppConfig as AppConfig$1, BabelAst as BabelAst$1, BinaryAssetMetadata as BinaryAssetMetadata$1, CliProgram as CliProgram$1, Document as Document$1, HTMLElement as HTMLElement$2, HtmlMetadata as HtmlMetadata$1, MarkdownAst as MarkdownAst$1, MarkdownMetadata as MarkdownMetadata$1, MetadataBase as MetadataBase$1, MetadataSource as MetadataSource$1, PackageMetadata as PackageMetadata$1, Plugin as Plugin$1, PostcssAst as PostcssAst$1, ScriptMetadata as ScriptMetadata$1, ServerReply as ServerReply$1, ServerRequest as ServerRequest$1, StringifyOptions as StringifyOptions$1, StyleMetadata as StyleMetadata$1, SvgMetadata as SvgMetadata$1, TextAssetMetadata as TextAssetMetadata$1, WebManifestMetadata as WebManifestMetadata$1 } from "@staticbolt/core";
 import { ImageResource, WebAppManifest } from "web-app-manifest";
 import { Abortable } from "node:events";
-
 //#region ../../node_modules/@types/unist/index.d.ts
 // ## Interfaces
 /**
@@ -1049,7 +1046,6 @@ interface Yaml extends Literal {
 interface YamlData extends Data {}
 //#endregion
 //#region src/types/common.d.ts
-type NodePath<T = t.Node | null | undefined> = NodePath$1<T>;
 type BabelAst = ParseResult;
 type PostcssAst = postcss.Root;
 interface MarkdownAst {
@@ -1058,272 +1054,55 @@ interface MarkdownAst {
   render(): Promise<string>;
 }
 declare const CUSTOM_ATTRIBUTES: Readonly<{
-  /** For script and style tags to grab the metadata */MetadataID: "data-metadata-id";
+  /** For script and style tags to grab the metadata */
+  MetadataID: "data-metadata-id";
 }>;
 declare const CONFIG_FILE_NAME = ".staticbolt.ts";
 interface AppConfig {
-  root?: string;
-  plugins?: (Plugin$1[] | Plugin$1)[];
-  outdir?: string;
-  production?: boolean;
-  browserslist?: string[];
-}
-//#endregion
-//#region src/resolver/resolver.d.ts
-type ResolveResult$1 = {
-  path: string;
-  suffix: string;
-  isDirAlias?: boolean;
-  isFileAlias?: boolean;
-  isPackage?: boolean;
-  exists: boolean;
-};
-declare class Resolver {
-  root: string;
-  aliases: Record<string, string>;
-  notFound: Set<string>;
-  files: Set<string>;
-  directories: Set<string>;
-  static JS_EXTENSIONS: Set<string>;
-  static HTML_EXTENSIONS: Set<string>;
-  constructor(root: string);
-  resolve(sourceOrLink: string, filePath: string): ResolveResult$1 | undefined;
-  resolveAlias(source: string): string | undefined;
-  normalize(filePath: string): string;
-  static isFile(filePath: string): boolean;
-  /** Aliased path to path */
-  static resolvePathAlias(filePath: string, aliases: Record<string, string>): string | undefined;
-  /** Path to aliased path */
-  static resolveAliasPath(filePath: string, aliases: Record<string, string>): string;
-  /** Path to aliased path */
-  aliasPath(filePath: string): string;
-  findFile(filePath: string, checkDirectory?: boolean): string | undefined;
-}
-//#endregion
-//#region src/main.d.ts
-declare class App {
-  readonly configPath: string;
-  /** The absolute path to the project root. */
-  readonly root: string;
-  /** The absolute path to the output directory. */
-  readonly outdir: string;
-  /** Whether the application is running in production mode. */
-  readonly production: boolean;
-  /** A list of browsers to target. */
-  readonly browserslist: string[];
-  readonly metadataList: MetadataBase$1[];
-  private readonly plugins;
-  readonly resolver: Resolver;
-  log: {
-    (...messages: unknown[]): void;
-    warn(...messages: string[]): void;
-    success(...messages: string[]): void;
-    error(...messages: string[]): void;
-    fatal(...messages: string[]): never;
-    info(...messages: string[]): void;
-    tip(...messages: string[]): void;
-    debug(...messages: string[]): void;
-    enableVerbose(enabled: boolean): void;
-    setVerboseFilter(filter: RegExp): void;
-  };
-  /** File paths to load as sources. */
-  readonly entryPoints: Set<string>;
-  /** Any type of data for plugins to use. */
-  readonly pluginData: Record<string, unknown>;
-  /** Exclude paths from being emitted. */
-  readonly emitExclude: Set<MetadataBase$1>;
-  /** Chokidar watcher. */
-  readonly watcher: FSWatcher | undefined;
-  private isPluginInitialized;
-  private measureExecutionTime;
-  private executionTime;
-  readonly pluginIndex: number;
-  readonly pluginName: string;
-  constructor(options: AppConfig$1 | undefined, configPath: string);
-  private bindPlugin;
-  private callPluginMethod;
-  private emitFileChange;
-  run(): Promise<void>;
-  process(id: string): Promise<void>;
-  resolve(metadata: MetadataBase$1): Promise<Set<string>>;
-  /**
-   * Resolve and load recursively
-   *
-   * 1. Resolves given metadata item or list
-   * 2. Loads discovered dependencies if not already loaded skipping entry points
-   * 3. Returns metadata list
-   */
-  resolveAndLoad(metadataItemOrList: MetadataBase$1 | MetadataBase$1[]): Promise<MetadataBase$1[]>;
-  transform(metadataItemOrList: MetadataBase$1 | MetadataBase$1[]): Promise<void>;
-  transformAndSync(metadataItemOrList: MetadataBase$1 | MetadataBase$1[]): Promise<void>;
-  rebase(metadata: MetadataBase$1, newAbsolutePath: string): Promise<void>;
-  writeFiles(metadataItemOrList: MetadataBase$1 | MetadataBase$1[]): Promise<void>;
-  read(filePath: string): Promise<string | undefined>;
-  load(relativePath: string, options?: {
-    code?: string;
-    type?: string;
-  }): Promise<MetadataBase$1 | undefined>;
-  requestSources(metadata: MetadataBase$1): Promise<MetadataSource$1[]>;
-  stringify(metadata: MetadataBase$1, options?: {
-    minify?: boolean;
-    format?: boolean;
-  }): Promise<string>;
-  getCompileList(event: "change" | "add" | "unlink", filePath: string): Promise<Set<string>>;
-  handleRequest(requestPath: string, reply: ServerReply$1, request: ServerRequest$1): Promise<true | undefined>;
-  resolveRequestPath(requestPath: string): Promise<string>;
-  clone<T extends MetadataBase$1>(metadata: T): T;
-  addMetadata(itemOrList: MetadataBase$1 | MetadataBase$1[]): void;
-  removeMetadata(metadataOrIndex: MetadataBase$1 | MetadataBase$1[] | number): void;
-  findMetadata<T extends MetadataBase$1>(metadataFilter: Partial<T>): T | undefined;
-  filterMetadata<T extends MetadataBase$1>(metadataFilter: Partial<T>): T[];
-}
-//#endregion
-//#region src/types/plugin.d.ts
-type FastifyHandlerParameters = Parameters<onRequestHookHandler>;
-type ServerReply = FastifyHandlerParameters[1];
-type ServerRequest = FastifyHandlerParameters[0];
-interface MetadataSource {
-  get source(): string;
-  set source(value: string);
-  node?: HTMLElement$1 | NodePath$1 | Postcss["AtRule"] | Postcss["Declaration"] | ImageResource | object;
-}
-interface ResolveResult {
-  source: string;
-  dependencyID?: string;
-}
-interface Plugin {
-  name: string;
-  setup?: (this: App$1) => void | Promise<void>;
-  read?: (this: App$1, absolutePath: string) => string | void | Promise<string | void>;
-  load?: (this: App$1, content: string, relativePath: string, options: {
-    type?: string;
-  }) => MetadataBase$1 | null | void | Promise<MetadataBase$1 | null | void>;
-  resolveSource?: (this: App$1, source: string, filePath: string, parentMetadata: MetadataBase$1) => ResolveResult | void | Promise<ResolveResult | void>;
-  transformSource?: (this: App$1, source: string, filePath: string, parentMetadata: MetadataBase$1) => string | void | Promise<string | void>;
-  preTransform?: (this: App$1) => void | Promise<void>;
-  transform?: (this: App$1, metadata: MetadataBase$1) => void | Promise<void>;
-  postTransform?: (this: App$1) => void | Promise<void>;
-  write?: (this: App$1, metadata: MetadataBase$1) => void | Promise<void>;
-  postBuild?: (this: App$1) => void | Promise<void>;
-  clone?: (this: App$1, metadata: MetadataBase$1) => void | MetadataBase$1;
-  stringify?: (this: App$1, metadata: MetadataBase$1, options: {
-    minify?: boolean;
-    format?: boolean;
-  }) => void | string | Promise<string | void>;
-  sourcesProvider?: (this: App$1, metadata: MetadataBase$1) => MetadataSource[] | void | Promise<MetadataSource[] | void>;
-  rebaseSource?: (this: App$1, source: string, filePath: string, newAbsolutePath: string) => string | void | Promise<string | void>;
-  onMetadataRebase?: (this: App$1, metadata: MetadataBase$1, oldAbsolutePath: string, newAbsolutePath: string) => void | Promise<void>;
-  handleRequest?: (this: App$1, requestPath: string, reply: ServerReply, request: ServerRequest) => boolean | void | Promise<boolean | void>;
-  resolveRequestPath?: (this: App$1, requestPath: string) => string | void | Promise<string | void>;
-  onFileEvent?: (this: App$1, event: "change" | "add" | "unlink", filePath: string) => void | Promise<void>;
-  resolveCompileList?: (this: App$1, compileSet: Set<string>, event: "change" | "add" | "unlink", filePath: string) => void | Promise<void>;
-  cli?: (this: CliProgram$1, config: AppConfig$1, configPath: string) => void | Promise<void>;
-}
-type RemoveThis<T> = Required<{ [K in keyof T]: T[K] extends ((this: App$1, ...arguments_: infer A) => infer R) | undefined ? (...arguments_: A) => R : T[K] }>;
-type BoundPlugin = RemoveThis<Plugin>;
-//#endregion
-//#region src/types/metadata.d.ts
-declare const METADATA_TYPES: Readonly<{
-  Script: "Script";
-  HTML: "Html";
-  Markdown: "Markdown";
-  CSS: "Style";
-  SVG: "Svg";
-  Package: "Package";
-  TextAsset: "TextAsset";
-  BinaryAsset: "BinaryAsset";
-  WebAppManifest: "WebAppManifest";
-}>;
-type MetadataTypes = (typeof METADATA_TYPES)[keyof typeof METADATA_TYPES];
-interface MetadataBase {
-  readonly type: `${Capitalize<string>}${string}`;
   /**
-   * Relative path of the source file.
+   * The project root. Relative paths in the config are resolved against it.
    *
-   * Initially identical to `originalSource` when the metadata is created. During the build process, this value may change (e.g.,
-   * if the file is moved to a different location and its links are rebased).
+   * @default process.cwd()
    */
-  filePath: string;
+  root?: string;
+  /** Plugins to run, in order. Nested arrays are flattened, so a plugin preset can be spread in as a single entry. */
+  plugins?: (Plugin$1[] | Plugin$1)[];
   /**
-   * Original relative path of the source file.
+   * The output directory, either absolute or relative to {@link AppConfig.root}.
    *
-   * Set when the metadata is created and never modified.
+   * @default "./dist"
    */
-  readonly id: string;
-  readonly directDependencies: Set<string>;
-}
-interface ScriptMetadata extends MetadataBase {
-  readonly type: (typeof METADATA_TYPES)["Script"];
+  outdir?: string;
   /**
-   * The Babel AST for the script.
+   * Whether to build for production. In development the project is watched for file changes.
    *
-   * Mutated during the build process and always represents the file's current transformed state.
+   * @default false
    */
-  ast: BabelAst$1;
-  /** Whether the script is a module or global */
-  module: boolean;
-}
-interface StyleMetadata extends MetadataBase {
-  readonly type: (typeof METADATA_TYPES)["CSS"];
+  production?: boolean;
   /**
-   * The PostCSS root after transformation
+   * Browsers to target, as [browserslist](https://github.com/browserslist/browserslist) queries. Defaults to the project's
+   * browserslist configuration.
    *
-   * Mutated during the build process and always represents the file's current transformed state.
+   * @example
+   *   ["last 2 Chrome versions", "last 2 Safari versions"];
    */
-  ast: PostcssAst$1;
-}
-interface HtmlMetadata extends MetadataBase {
-  type: (typeof METADATA_TYPES)["HTML"];
+  browserslist?: string[];
   /**
-   * The HTML AST (root element).
+   * Whether to time each plugin hook and print a breakdown when the build finishes.
    *
-   * Mutated during the build process and always represents the file's current transformed state
+   * @default false
    */
-  ast: Document$1;
-  /** The transformed ASTs from script tags. The key is the UUID */
-  scriptsMetadataList: Map<string, ScriptMetadata>;
-  /** The transformed ASTs from script tags. The key is the UUID */
-  stylesMetadataList: Map<string, StyleMetadata>;
-}
-interface SvgMetadata extends MetadataBase {
-  type: (typeof METADATA_TYPES)["SVG"];
+  measureExecutionTime?: boolean;
   /**
-   * The HTML AST (root element).
+   * Path aliases, merged on top of the ones resolved from `tsconfig.json` — entries defined here win on key conflicts.
    *
-   * Mutated during the build process and always represents the file's current transformed state
-   */
-  ast: Document$1;
-  /** The transformed ASTs from script tags. The key is the UUID */
-  stylesMetadataList: Map<string, StyleMetadata>;
-}
-interface MarkdownMetadata extends MetadataBase {
-  type: (typeof METADATA_TYPES)["Markdown"];
-  /**
-   * Markdown tokens and frontmatter.
+   * Keys ending with `/` are directory aliases, otherwise the key is matched as a whole. Values are resolved relative to the
+   * project root.
    *
-   * Mutated during the build process and always represents the file's current transformed state
+   * @example
+   *   { "~/": "./src/", "@config": "./src/config.ts" }
    */
-  ast: MarkdownAst$1;
-}
-interface WebManifestMetadata extends MetadataBase {
-  type: (typeof METADATA_TYPES)["WebAppManifest"];
-  ast: WebAppManifest;
-}
-interface PackageMetadata extends MetadataBase {
-  type: (typeof METADATA_TYPES)["Package"];
-  /** Metadata code */
-  code: string;
-  packageName: string;
-}
-interface TextAssetMetadata extends MetadataBase {
-  type: (typeof METADATA_TYPES)["TextAsset"];
-  /** Metadata code */
-  code: string;
-}
-interface BinaryAssetMetadata extends MetadataBase {
-  type: (typeof METADATA_TYPES)["BinaryAsset"];
-  /** Raw binary content — images, fonts, wasm, etc. */
-  data?: Uint8Array;
+  aliases?: Record<string, string>;
 }
 //#endregion
 //#region src/cli/cli.d.ts
@@ -1336,6 +1115,20 @@ declare class CliProgram {
       example: string;
     };
     options: {
+      cwd: {
+        schema: z.ZodOptional<z.ZodString>;
+        meta: {
+          placeholder: string;
+          description: string;
+        };
+      };
+      config: {
+        schema: z.ZodOptional<z.ZodString>;
+        meta: {
+          placeholder: string;
+          description: string;
+        };
+      };
       help: {
         aliases: string[];
         schema: z.ZodOptional<z.ZodBoolean>;
@@ -1362,6 +1155,8 @@ declare class CliProgram {
     onExecute: (handler: (data: {
       subcommand: undefined;
       options: {
+        cwd?: string | undefined;
+        config?: string | undefined;
         help?: boolean | undefined;
         version?: boolean | undefined;
       };
@@ -1370,8 +1165,10 @@ declare class CliProgram {
       context: {
         subcommand: undefined;
         options: {
-          help: _$_staticbolt_args_parser0.OptionContext<z.ZodOptional<z.ZodBoolean>>;
-          version: _$_staticbolt_args_parser0.OptionContext<z.ZodOptional<z.ZodBoolean>>;
+          cwd: import("@staticbolt/args-parser").OptionContext<z.ZodOptional<z.ZodString>>;
+          config: import("@staticbolt/args-parser").OptionContext<z.ZodOptional<z.ZodString>>;
+          help: import("@staticbolt/args-parser").OptionContext<z.ZodOptional<z.ZodBoolean>>;
+          version: import("@staticbolt/args-parser").OptionContext<z.ZodOptional<z.ZodBoolean>>;
         };
         arguments: never;
         positionals: never;
@@ -1379,6 +1176,8 @@ declare class CliProgram {
     }) => void) => () => void;
     execute: (input?: {
       options?: {
+        cwd?: string | undefined;
+        config?: string | undefined;
         help?: boolean | undefined;
         version?: boolean | undefined;
       } | undefined;
@@ -1387,21 +1186,37 @@ declare class CliProgram {
     } | undefined) => void;
     executeAsync: (input?: {
       options?: {
+        cwd?: string | undefined;
+        config?: string | undefined;
         help?: boolean | undefined;
         version?: boolean | undefined;
       } | undefined;
       arguments?: undefined;
       positionals?: undefined;
     } | undefined) => Promise<void>;
-    generateCliHelpMessage?: ((options?: _$_staticbolt_args_parser0.PrintHelpOptions) => string) | undefined;
-    generateSubcommandHelpMessage?: ((subcommandName: string & {}, options?: _$_staticbolt_args_parser0.PrintHelpOptions) => string) | undefined;
-    run: (input: string | string[]) => _$_staticbolt_args_parser0.CliParseResult<{
+    generateCliHelpMessage?: ((options?: import("@staticbolt/args-parser").PrintHelpOptions) => string) | undefined;
+    generateSubcommandHelpMessage?: ((subcommandName: string & {}, options?: import("@staticbolt/args-parser").PrintHelpOptions) => string) | undefined;
+    run: (input: string | string[]) => import("@staticbolt/args-parser").CliParseResult<{
       cliName: "staticbolt";
       meta: {
         description: string;
         example: string;
       };
       options: {
+        cwd: {
+          schema: z.ZodOptional<z.ZodString>;
+          meta: {
+            placeholder: string;
+            description: string;
+          };
+        };
+        config: {
+          schema: z.ZodOptional<z.ZodString>;
+          meta: {
+            placeholder: string;
+            description: string;
+          };
+        };
         help: {
           aliases: string[];
           schema: z.ZodOptional<z.ZodBoolean>;
@@ -1426,18 +1241,32 @@ declare class CliProgram {
         };
       };
     }>;
-    runAsync: (input: string | string[]) => Promise<_$_staticbolt_args_parser0.CliParseResult<{
+    runAsync: (input: string | string[]) => Promise<import("@staticbolt/args-parser").CliParseResult<{
       cliName: "staticbolt";
       meta: {
         description: string;
         example: string;
       };
       options: {
-        help: {
-          aliases: string[];
-          schema: z.ZodOptional<z.ZodBoolean>;
-          coerce: {
-            <T extends boolean | undefined>(terminalInput: string): T;
+        cwd: {
+          schema: z.ZodOptional<z.ZodString>;
+          meta: {
+            placeholder: string;
+            description: string;
+          };
+        };
+        config: {
+          schema: z.ZodOptional<z.ZodString>;
+          meta: {
+            placeholder: string;
+            description: string;
+          };
+        };
+        help: {
+          aliases: string[];
+          schema: z.ZodOptional<z.ZodBoolean>;
+          coerce: {
+            <T extends boolean | undefined>(terminalInput: string): T;
             type: string;
           };
           meta: {
@@ -1459,15 +1288,29 @@ declare class CliProgram {
     }>>;
   };
   constructor();
-  initializePlugins(config: AppConfig$1, configPath: string): Promise<void>;
-  static init(config: AppConfig$1, configPath: string): Promise<CliProgram>;
-  run(cliArguments: string[]): _$_staticbolt_args_parser0.CliParseResult<{
+  initializePlugins(config: AppConfig$1, configPath: string, projectDirectory: string): Promise<void>;
+  static init(config: AppConfig$1, configPath: string, projectDirectory: string): Promise<CliProgram>;
+  run(cliArguments: string[]): import("@staticbolt/args-parser").CliParseResult<{
     cliName: "staticbolt";
     meta: {
       description: string;
       example: string;
     };
     options: {
+      cwd: {
+        schema: z.ZodOptional<z.ZodString>;
+        meta: {
+          placeholder: string;
+          description: string;
+        };
+      };
+      config: {
+        schema: z.ZodOptional<z.ZodString>;
+        meta: {
+          placeholder: string;
+          description: string;
+        };
+      };
       help: {
         aliases: string[];
         schema: z.ZodOptional<z.ZodBoolean>;
@@ -1503,23 +1346,448 @@ declare class CliProgram {
     };
     number: <T extends number | undefined>(terminalInput: string) => T;
     bigint: <T extends bigint | undefined>(terminalInput: string) => T;
-    object: (options?: _$_staticbolt_args_parser0.ObjectCoerceMethodOptions) => <T extends Record<string, unknown> | undefined>(terminalInput: string) => T;
+    object: (options?: import("@staticbolt/args-parser").ObjectCoerceMethodOptions) => {
+      <T extends Record<string, unknown> | undefined>(terminalInput: string): T;
+      type: string;
+    };
     stringArray: (separator: string) => <T extends string[] | undefined>(terminalInput: string) => T;
     numberArray: (separator: string) => <T extends number[] | undefined>(terminalInput: string) => T;
     booleanArray: (separator: string) => <T extends boolean[] | undefined>(terminalInput: string) => T;
     stringSet: (separator: string) => <T extends Set<string> | undefined>(terminalInput: string) => T;
     numberSet: (separator: string) => <T extends Set<number> | undefined>(terminalInput: string) => T;
     booleanSet: (separator: string) => <T extends Set<boolean> | undefined>(terminalInput: string) => T;
-    json: <T>(terminalInput: string) => T;
+    json: {
+      <T>(terminalInput: string): T;
+      type: string;
+    };
   };
   addCommand(newSubcommand: Subcommand): number | undefined;
-  addOptions(newOptions: Record<string, Option>): (Record<string, Option<_$_staticbolt_args_parser0.SchemaType<unknown>>> & Record<string, Option>) | undefined;
-  addArguments(newArguments: Record<string, Argument>): (Record<string, Argument<_$_staticbolt_args_parser0.SchemaType<unknown>>> & Record<string, Argument>) | undefined;
-  addOptionsToCommand(commandName: string, newOptions: Record<string, Option>): (Record<string, Option<_$_staticbolt_args_parser0.SchemaType<unknown>>> & Record<string, Option>) | undefined;
-  addArgumentsToCommand(commandName: string, newArguments: Record<string, Argument>): (Record<string, Argument<_$_staticbolt_args_parser0.SchemaType<unknown>>> & Record<string, Argument>) | undefined;
+  addOptions(newOptions: Record<string, Option>): (Record<string, Option<import("@staticbolt/args-parser").SchemaType<unknown>>> & Record<string, Option>) | undefined;
+  addArguments(newArguments: Record<string, Argument>): (Record<string, Argument<import("@staticbolt/args-parser").SchemaType<unknown>>> & Record<string, Argument>) | undefined;
+  addOptionsToCommand(commandName: string, newOptions: Record<string, Option>): (Record<string, Option<import("@staticbolt/args-parser").SchemaType<unknown>>> & Record<string, Option>) | undefined;
+  addArgumentsToCommand(commandName: string, newArguments: Record<string, Argument>): (Record<string, Argument<import("@staticbolt/args-parser").SchemaType<unknown>>> & Record<string, Argument>) | undefined;
+}
+//#endregion
+//#region src/resolver/resolver.d.ts
+type ResolveResult$1 = {
+  path: string;
+  suffix: string;
+  isDirAlias?: boolean;
+  isFileAlias?: boolean;
+  isPackage?: boolean;
+  exists: boolean;
+};
+declare class Resolver {
+  #private;
+  root: string;
+  isProduction: boolean;
+  aliases: Record<string, string>;
+  notFound: Set<string>;
+  files: Set<string>;
+  directories: Set<string>;
+  misses: Set<string>;
+  static JS_EXTENSIONS: Set<string>;
+  static HTML_EXTENSIONS: Set<string>;
+  constructor(root: string, isProduction?: boolean, configAliases?: Record<string, string>);
+  resolve(sourceOrLink: string, filePath: string): ResolveResult$1 | undefined;
+  resolveAlias(source: string): string | undefined;
+  normalize(filePath: string): string;
+  static isFile(filePath: string): boolean;
+  /** Aliased path to path */
+  static resolvePathAlias(filePath: string, aliases: Record<string, string>): string | undefined;
+  /** Path to aliased path */
+  static resolveAliasPath(filePath: string, aliases: Record<string, string>): string;
+  /** Path to aliased path */
+  aliasPath(filePath: string): string;
+  findFile(filePath: string, shouldCheckDirectory?: boolean): string | undefined;
+}
+//#endregion
+//#region src/main.d.ts
+declare class App {
+  readonly configPath: string;
+  /** The absolute path to the project root. */
+  readonly root: string;
+  /** The absolute path to the output directory. */
+  readonly outdir: string;
+  /** Whether the application is running in production mode. */
+  readonly production: boolean;
+  /** A list of browsers to target. */
+  readonly browserslist: string[];
+  readonly metadataList: MetadataBase$1[];
+  private readonly plugins;
+  readonly resolver: Resolver;
+  log: {
+    (...messages: unknown[]): void;
+    warn(...messages: string[]): void;
+    success(...messages: string[]): void;
+    error(...messages: string[]): void;
+    fatal(...messages: string[]): never;
+    info(...messages: string[]): void;
+    tip(...messages: string[]): void;
+    debug(...messages: string[]): void;
+    enableVerbose(isEnabled: boolean): void;
+    setVerboseFilter(filter: RegExp): void;
+  };
+  /** File paths to load as sources. */
+  readonly entryPoints: Set<string>;
+  /** Any type of data for plugins to use. */
+  readonly pluginData: Record<string, unknown>;
+  /** Exclude paths from being emitted. */
+  readonly emitExclude: Set<MetadataBase$1>;
+  /** Chokidar watcher. Development only, and gone once the app is closed. */
+  watcher: FSWatcher | undefined;
+  private isPluginInitialized;
+  private isClosed;
+  private measureExecutionTime;
+  private executionTime;
+  /** How long the hooks called from inside the hook currently being measured took. Held in an object so plugin contexts share it. */
+  private readonly nestedTime;
+  readonly pluginIndex: number;
+  readonly pluginName: string;
+  constructor(options: AppConfig$1 | undefined, configPath: string);
+  /** Binds a copy of the plugin's hooks to this app, leaving the user's object untouched. */
+  private bindPlugin;
+  private callPluginMethod;
+  private emitFileChange;
+  run(): Promise<void>;
+  /**
+   * Stops watching and lets every plugin release what its `setup` took, in reverse order. A teardown that throws is reported and
+   * the rest still run. Closing again does nothing.
+   */
+  close(): Promise<void>;
+  process(id: string): Promise<boolean>;
+  resolve(metadata: MetadataBase$1): Promise<Set<string>>;
+  /**
+   * Resolve and load recursively
+   *
+   * 1. Resolves given metadata item or list
+   * 2. Loads discovered dependencies if not already loaded skipping entry points
+   * 3. Returns metadata list
+   */
+  resolveAndLoad(metadataItemOrList: MetadataBase$1 | MetadataBase$1[]): Promise<MetadataBase$1[]>;
+  transform(metadataItemOrList: MetadataBase$1 | MetadataBase$1[]): Promise<void>;
+  transformAndSync(metadataItemOrList: MetadataBase$1 | MetadataBase$1[]): Promise<void>;
+  rebase(metadata: MetadataBase$1, newAbsolutePath: string): Promise<void>;
+  writeFiles(): Promise<void>;
+  read(filePath: string): Promise<string | undefined>;
+  load(relativePath: string, options?: {
+    code?: string;
+    type?: string;
+  }): Promise<MetadataBase$1 | undefined>;
+  requestSources(metadata: MetadataBase$1): Promise<MetadataSource$1[]>;
+  stringify(metadata: MetadataBase$1, options?: StringifyOptions$1): Promise<string>;
+  getCompileList(event: "change" | "add" | "unlink", filePath: string): Promise<Set<string>>;
+  handleRequest(requestPath: string, reply: ServerReply$1, request: ServerRequest$1): Promise<true | undefined>;
+  resolveRequestPath(requestPath: string): Promise<string>;
+  clone<T extends MetadataBase$1>(metadata: T): T;
+  addMetadata(itemOrList: MetadataBase$1 | MetadataBase$1[]): void;
+  removeMetadata(metadataOrIndex: MetadataBase$1 | MetadataBase$1[] | number): void;
+  findMetadata<T extends MetadataBase$1>(metadataFilter: Partial<T>): T | undefined;
+  filterMetadata<T extends MetadataBase$1>(metadataFilter: Partial<T>): T[];
+}
+//#endregion
+//#region src/types/metadata.d.ts
+declare const METADATA_TYPES: Readonly<{
+  Script: "Script";
+  HTML: "Html";
+  Markdown: "Markdown";
+  CSS: "Style";
+  SVG: "Svg";
+  Package: "Package";
+  TextAsset: "TextAsset";
+  BinaryAsset: "BinaryAsset";
+  WebAppManifest: "WebAppManifest";
+}>;
+type MetadataTypes = (typeof METADATA_TYPES)[keyof typeof METADATA_TYPES];
+interface MetadataBase {
+  readonly type: `${Capitalize<string>}${string}`;
+  /**
+   * Relative path of the source file.
+   *
+   * Initially identical to `originalSource` when the metadata is created. During the build process, this value may change (e.g.,
+   * if the file is moved to a different location and its links are rebased).
+   */
+  filePath: string;
+  /**
+   * Original relative path of the source file.
+   *
+   * Set when the metadata is created and never modified.
+   */
+  readonly id: string;
+  readonly directDependencies: Set<string>;
+}
+interface ScriptMetadata extends MetadataBase {
+  readonly type: (typeof METADATA_TYPES)["Script"];
+  /**
+   * The Babel AST for the script.
+   *
+   * Mutated during the build process and always represents the file's current transformed state.
+   */
+  ast: BabelAst$1;
+  /** Whether the script is a module or global */
+  module: boolean;
+}
+interface StyleMetadata extends MetadataBase {
+  readonly type: (typeof METADATA_TYPES)["CSS"];
+  /**
+   * The PostCSS root after transformation
+   *
+   * Mutated during the build process and always represents the file's current transformed state.
+   */
+  ast: PostcssAst$1;
+}
+interface HtmlMetadata extends MetadataBase {
+  type: (typeof METADATA_TYPES)["HTML"];
+  /**
+   * The HTML AST (root element).
+   *
+   * Mutated during the build process and always represents the file's current transformed state
+   */
+  ast: Document$1;
+  /** The transformed ASTs from script tags. The key is the UUID */
+  scriptsMetadataList: Map<string, ScriptMetadata>;
+  /** The transformed ASTs from script tags. The key is the UUID */
+  stylesMetadataList: Map<string, StyleMetadata>;
+}
+interface SvgMetadata extends MetadataBase {
+  type: (typeof METADATA_TYPES)["SVG"];
+  /**
+   * The HTML AST (root element).
+   *
+   * Mutated during the build process and always represents the file's current transformed state
+   */
+  ast: Document$1;
+  /** The transformed ASTs from script tags. The key is the UUID */
+  stylesMetadataList: Map<string, StyleMetadata>;
+}
+interface MarkdownMetadata extends MetadataBase {
+  type: (typeof METADATA_TYPES)["Markdown"];
+  /**
+   * Markdown tokens and frontmatter.
+   *
+   * Mutated during the build process and always represents the file's current transformed state
+   */
+  ast: MarkdownAst$1;
+}
+interface WebManifestMetadata extends MetadataBase {
+  type: (typeof METADATA_TYPES)["WebAppManifest"];
+  ast: WebAppManifest;
+}
+interface PackageMetadata extends MetadataBase {
+  type: (typeof METADATA_TYPES)["Package"];
+  /** Metadata code */
+  code: string;
+  packageName: string;
+}
+interface TextAssetMetadata extends MetadataBase {
+  type: (typeof METADATA_TYPES)["TextAsset"];
+  /** Metadata code */
+  code: string;
+}
+interface BinaryAssetMetadata extends MetadataBase {
+  type: (typeof METADATA_TYPES)["BinaryAsset"];
+  /** Raw binary content — images, fonts, wasm, etc. */
+  data?: Uint8Array;
+}
+//#endregion
+//#region src/types/html-data.d.ts
+/**
+ * The HTML custom data format, as an editor reads it for completions and hover.
+ *
+ * It is declared here rather than imported from the language service the language server runs on, so that a plugin written in a
+ * user project is typed without that package having to be installed.
+ */
+type MarkupKind = "plaintext" | "markdown";
+interface MarkupContent {
+  kind: MarkupKind;
+  value: string;
+}
+type Baseline = false | "low" | "high";
+interface BaselineStatus {
+  baseline: Baseline;
+  baseline_low_date?: string;
+  baseline_high_date?: string;
+}
+interface IReference {
+  name: string;
+  url: string;
+}
+interface IValueData {
+  name: string;
+  description?: string | MarkupContent;
+  references?: IReference[];
+  browsers?: string[];
+  status?: BaselineStatus;
+}
+interface IValueSet {
+  name: string;
+  values: IValueData[];
+}
+interface IAttributeData {
+  name: string;
+  description?: string | MarkupContent;
+  valueSet?: string;
+  values?: IValueData[];
+  references?: IReference[];
+  browsers?: string[];
+  status?: BaselineStatus;
+}
+interface ITagData {
+  name: string;
+  description?: string | MarkupContent;
+  attributes: IAttributeData[];
+  references?: IReference[];
+  void?: boolean;
+  browsers?: string[];
+  status?: BaselineStatus;
+}
+interface HTMLDataV1 {
+  version: 1 | 1.1;
+  tags?: ITagData[];
+  globalAttributes?: IAttributeData[];
+  valueSets?: IValueSet[];
+}
+//#endregion
+//#region src/types/plugin.d.ts
+type FastifyHandlerParameters = Parameters<onRequestHookHandler>;
+type ServerReply = FastifyHandlerParameters[1];
+type ServerRequest = FastifyHandlerParameters[0];
+interface MetadataSource {
+  get source(): string;
+  set source(value: string);
+  node?: HTMLElement$1 | NodePath$1 | Postcss["AtRule"] | Postcss["Declaration"] | ImageResource | object;
+}
+interface ResolveResult {
+  source: string;
+  dependencyID?: string;
+}
+/**
+ * A format or minify pass handed over instead of run, described well enough for another thread to run it: the module that exports
+ * the pass, the name it is exported under, and everything the pass needs besides the code itself.
+ */
+interface DeferredPass {
+  /** Imported as written, from a context unrelated to the plugin, so it has to resolve on its own — an `import.meta.resolve` URL. */
+  module: string;
+  export: string;
+  /** Crosses a thread boundary, so it has to survive a structured clone. */
+  payload?: unknown;
+}
+/** What the module of a `DeferredPass` has to export under the name the pass gives. */
+type DeferredPassHandler<Payload = void> = (code: string, payload: Payload) => string | Promise<string>;
+interface StringifyOptions {
+  minify?: boolean;
+  format?: boolean;
+  /**
+   * Offered by callers that would rather run the final pass somewhere else. A plugin that takes it up describes its pass, returns
+   * the code untouched and leaves the running to the caller. Ignoring it and doing the work is always correct.
+   */
+  defer?: (pass: DeferredPass) => void;
+}
+interface Plugin {
+  name: string;
+  setup?: (this: App$1) => void | Promise<void>;
+  /**
+   * Runs when the app is closed, in reverse plugin order. Release whatever `setup` took hold of (servers, watchers, workers). May
+   * run after a `setup` that never finished, so expect to find nothing to release.
+   */
+  teardown?: (this: App$1) => void | Promise<void>;
+  read?: (this: App$1, absolutePath: string) => string | void | Promise<string | void>;
+  load?: (this: App$1, content: string, relativePath: string, options: {
+    type?: string;
+  }) => MetadataBase$1 | null | void | Promise<MetadataBase$1 | null | void>;
+  resolveSource?: (this: App$1, source: string, filePath: string, parentMetadata: MetadataBase$1) => ResolveResult | void | Promise<ResolveResult | void>;
+  transformSource?: (this: App$1, source: string, filePath: string, parentMetadata: MetadataBase$1, dependencyID?: string) => string | void | Promise<string | void>;
+  preTransform?: (this: App$1) => void | Promise<void>;
+  transform?: (this: App$1, metadata: MetadataBase$1) => void | Promise<void>;
+  postTransform?: (this: App$1) => void | Promise<void>;
+  /** Runs once, after every transform. Walk `metadataList` for the files to emit, and leave nothing outstanding on the way out. */
+  write?: (this: App$1) => void | Promise<void>;
+  postBuild?: (this: App$1) => void | Promise<void>;
+  clone?: (this: App$1, metadata: MetadataBase$1) => void | MetadataBase$1;
+  stringify?: (this: App$1, metadata: MetadataBase$1, options: StringifyOptions) => void | string | Promise<string | void>;
+  sourcesProvider?: (this: App$1, metadata: MetadataBase$1) => MetadataSource[] | void | Promise<MetadataSource[] | void>;
+  rebaseSource?: (this: App$1, source: string, filePath: string, newAbsolutePath: string) => string | void | Promise<string | void>;
+  onMetadataRebase?: (this: App$1, metadata: MetadataBase$1, oldAbsolutePath: string, newAbsolutePath: string) => void | Promise<void>;
+  handleRequest?: (this: App$1, requestPath: string, reply: ServerReply, request: ServerRequest) => boolean | void | Promise<boolean | void>;
+  resolveRequestPath?: (this: App$1, requestPath: string) => string | void | Promise<string | void>;
+  onFileEvent?: (this: App$1, event: "change" | "add" | "unlink", filePath: string) => void | Promise<void>;
+  resolveCompileList?: (this: App$1, compileSet: Set<string>, event: "change" | "add" | "unlink", filePath: string) => void | Promise<void>;
+  /**
+   * Registers commands on the CLI. `config` has already been loaded from `configPath`, with its root made absolute against
+   * `projectDirectory` — the directory the CLI was pointed at.
+   */
+  cli?: (this: CliProgram$1, config: AppConfig$1, configPath: string, projectDirectory: string) => void | Promise<void>;
+  lspHtmlData?: () => HTMLDataV1 | undefined | Promise<HTMLDataV1 | undefined>;
+}
+type RemoveThis<T> = Required<{ [K in keyof T]: T[K] extends ((this: App$1, ...arguments_: infer A) => infer R) | undefined ? (...arguments_: A) => R : T[K]; }>;
+type BoundPlugin = RemoveThis<Plugin>;
+//#endregion
+//#region src/helpers/dependency-tracker.d.ts
+/**
+ * Tracks bidirectional dependencies between importers and their sources.\
+ * Handles reconciliation when dependencies change, so stale entries are automatically removed when an importer stops referencing
+ * a source.
+ */
+declare class DependencyTracker {
+  #private;
+  /** Updates the full set of sources for a given importer, reconciling any stale entries from previous calls. */
+  update(importer: string, sources: Iterable<string>): void;
+  /** Deletes all dependency data for a given id, whether it's acting as an importer, a source, or both (e.g. on file unlink). */
+  delete(id: string): void;
+  /** Returns all importers that depend on a given source, or an empty set. */
+  getImporters(source: string): ReadonlySet<string>;
+  /** Returns all sources that a given importer depends on, or an empty set. */
+  getSources(importer: string): ReadonlySet<string>;
 }
 //#endregion
-//#region src/utilities/path.d.ts
+//#region src/utilities/html-links.d.ts
+/**
+ * Checks if the link is an HTML link (not a file link)
+ *
+ * @param source - The link
+ * @returns
+ */
+declare function isHtmlLink(source: string): boolean;
+declare function isValidRelativePath(source: string): boolean;
+declare function splitHtmlLink(url: string): [string, string];
+//#endregion
+//#region src/utilities/metadata-utilities.d.ts
+declare function isScriptMetadata(metadata: MetadataBase$1 | undefined): metadata is ScriptMetadata$1;
+declare function isPackageMetadata(metadata: MetadataBase$1 | undefined): metadata is PackageMetadata$1;
+declare function isHtmlMetadata(metadata: MetadataBase$1 | undefined): metadata is HtmlMetadata$1;
+declare function isStyleMetadata(metadata: MetadataBase$1 | undefined): metadata is StyleMetadata$1;
+declare function isSvgMetadata(metadata: MetadataBase$1 | undefined): metadata is SvgMetadata$1;
+declare function isMarkdownMetadata(metadata: MetadataBase$1 | undefined): metadata is MarkdownMetadata$1;
+declare function isTextAssetMetadata(metadata: MetadataBase$1 | undefined): metadata is TextAssetMetadata$1;
+declare function isBinaryAssetMetadata(metadata: MetadataBase$1 | undefined): metadata is BinaryAssetMetadata$1;
+declare function isWebManifestMetadata(metadata: MetadataBase$1): metadata is WebManifestMetadata$1;
+/**
+ * Returns script-related metadata entries.
+ *
+ * - If the input is ScriptMetadata, it returns it directly.
+ * - If the input is HtmlMetadata, it scans <script> tags in the AST and resolves their associated ScriptMetadata using the metadata
+ *   ID attribute.
+ */
+declare function filterScriptMetadata(metadata: MetadataBase$1): {
+  metadata: ScriptMetadata$1;
+  tag?: HTMLElement$2;
+  htmlMetadata?: HtmlMetadata$1;
+}[];
+/**
+ * Returns style-related metadata entries.
+ *
+ * - If the input is StyleMetadata, it returns it directly.
+ * - If the input is HtmlMetadata, it scans <style> tags in the AST and resolves their associated StyleMetadata using the metadata
+ *   ID attribute.
+ */
+declare function filterStyleMetadata(metadata: MetadataBase$1): {
+  metadata: StyleMetadata$1;
+  tag?: HTMLElement$2;
+  htmlMetadata?: HtmlMetadata$1;
+}[];
+declare namespace path_d_exports {
+  export { appendForwardSlash, basename, dirname, extname, firstPart, isAbsolute, isPathMatch, isSubpath, join, normalize, parse$1 as parse, parsePatterns, rebaseRelativePath, relative, replaceExtension, resolve, sourceRelativeToRoot, trimDotPrefix };
+}
 declare const join: (...arguments_: string[]) => string;
 declare const relative: (from: string, to: string) => string;
 declare const dirname: (path: string) => string;
@@ -1551,11 +1819,7 @@ interface SourceRelativeToRootOptions {
   sourcePath: string;
 }
 /** Calculates the relative path of a source path to the root. */
-declare function sourceRelativeToRoot({
-  root,
-  filePath,
-  sourcePath
-}: SourceRelativeToRootOptions): string;
+declare function sourceRelativeToRoot({ root, filePath, sourcePath }: SourceRelativeToRootOptions): string;
 /** Replaces the extension of a given path. */
 declare function replaceExtension(filePath: string, extension: string): string;
 /** Appends a forward slash to the end of a path if it doesn't already end with one. */
@@ -1564,52 +1828,19 @@ declare const appendForwardSlash: (path: string) => string;
 declare const trimDotPrefix: (path: string) => string;
 /** Returns the first segment of a path. */
 declare function firstPart(path: string): string;
+/**
+ * Splits a semicolon-separated attribute value into an array of trimmed glob patterns.
+ *
+ * Returns `undefined` when the input is not a string, and an empty array for an empty string.
+ */
+declare function parsePatterns(string: string | null | undefined): string[] | undefined;
 interface MatchPathOptions {
   include: string | string[];
   ignore?: string | string[];
   root: string;
 }
 /** Checks if a file path matches a set of patterns. */
-declare function matchPath(filePath: string, {
-  include,
-  ignore,
-  root
-}: MatchPathOptions): boolean;
-//#endregion
-//#region src/utilities/metadata-utilities.d.ts
-declare function isScriptMetadata(metadata: MetadataBase$1 | undefined): metadata is ScriptMetadata$1;
-declare function isPackageMetadata(metadata: MetadataBase$1 | undefined): metadata is PackageMetadata$1;
-declare function isHtmlMetadata(metadata: MetadataBase$1 | undefined): metadata is HtmlMetadata$1;
-declare function isStyleMetadata(metadata: MetadataBase$1 | undefined): metadata is StyleMetadata$1;
-declare function isSvgMetadata(metadata: MetadataBase$1 | undefined): metadata is SvgMetadata$1;
-declare function isMarkdownMetadata(metadata: MetadataBase$1 | undefined): metadata is MarkdownMetadata$1;
-declare function isTextAssetMetadata(metadata: MetadataBase$1 | undefined): metadata is TextAssetMetadata$1;
-declare function isBinaryAssetMetadata(metadata: MetadataBase$1 | undefined): metadata is BinaryAssetMetadata$1;
-declare function isWebManifestMetadata(metadata: MetadataBase$1): metadata is WebManifestMetadata$1;
-/**
- * Returns script-related metadata entries.
- *
- * - If the input is ScriptMetadata, it returns it directly.
- * - If the input is HtmlMetadata, it scans <script> tags in the AST and resolves their associated ScriptMetadata using the metadata
- *   ID attribute.
- */
-declare function filterScriptMetadata(metadata: MetadataBase$1): {
-  metadata: ScriptMetadata$1;
-  tag?: HTMLElement$2;
-  htmlMetadata?: HtmlMetadata$1;
-}[];
-/**
- * Returns style-related metadata entries.
- *
- * - If the input is StyleMetadata, it returns it directly.
- * - If the input is HtmlMetadata, it scans <style> tags in the AST and resolves their associated StyleMetadata using the metadata
- *   ID attribute.
- */
-declare function filterStyleMetadata(metadata: MetadataBase$1): {
-  metadata: StyleMetadata$1;
-  tag?: HTMLElement$2;
-  htmlMetadata?: HtmlMetadata$1;
-}[];
+declare function isPathMatch(filePath: string, { include, ignore, root }: MatchPathOptions): boolean;
 //#endregion
 //#region src/utilities/print-formatted-error.d.ts
 type Node$3 = Node$2 | Node$1 | Node;
@@ -1639,6 +1870,12 @@ declare const printFmtError: (...messageAndErrorWithOptions: [...MessageAndError
 //#endregion
 //#region src/utilities/value-or-error.d.ts
 type ValueOrError<T> = [T, null] | [null, Error];
+declare function handleError<T>(error: unknown, functionName?: string): ValueOrError<T>;
+interface goErrorsI {
+  <T, A extends unknown[]>(function_: (...arguments_: A) => Promise<T>): (...arguments_: A) => Promise<ValueOrError<T>>;
+  <T, A extends unknown[]>(function_: (...arguments_: A) => T): (...arguments_: A) => ValueOrError<T>;
+}
+declare const valueOrError: goErrorsI;
 //#endregion
 //#region src/utilities/read-file.d.ts
 declare function safeReadFile(path: PathLike | FileHandle, options?: ({
@@ -1656,10 +1893,10 @@ declare function safeReadFileSync(path: PathOrFileDescriptor, options?: {
   encoding?: null | undefined;
   flag?: string | undefined;
 } | null): ValueOrError<NonSharedBuffer>;
-declare function safeReadFileSync(path: PathOrFileDescriptor, options: {
+declare function safeReadFileSync(path: PathOrFileDescriptor, options: BufferEncoding | {
   encoding: BufferEncoding;
   flag?: string | undefined;
-} | BufferEncoding): ValueOrError<string>;
+}): ValueOrError<string>;
 declare function safeReadFileSync(path: PathOrFileDescriptor, options?: (ObjectEncodingOptions & {
   flag?: string | undefined;
 }) | BufferEncoding | null): ValueOrError<string | NonSharedBuffer>;
@@ -1709,26 +1946,14 @@ declare function cloneObject<T extends object>(object: T): T;
 declare function hashContent(content: string): string;
 declare function escapeHtml(input: string): string;
 //#endregion
-//#region src/helpers/dependency-tracker.d.ts
+//#region src/index.d.ts
 /**
- * Tracks bidirectional dependencies between importers and their sources.\
- * Handles reconciliation when dependencies change, so stale entries are automatically removed when an importer stops referencing
- * a source.
+ * Types the config file's default export.
+ *
+ * The config file runs as CommonJS, so it cannot use top-level `await`. Create plugins inside it rather than importing shared
+ * instances: only the config file itself is evaluated again when the dev server reloads it.
  */
-declare class DependencyTracker {
-  #private;
-  /** Updates the full set of sources for a given importer, reconciling any stale entries from previous calls. */
-  update(importer: string, sources: Iterable<string>): void;
-  /** Deletes all dependency data for a given id, whether it's acting as an importer, a source, or both (e.g. on file unlink). */
-  delete(id: string): void;
-  /** Returns all importers that depend on a given source, or an empty set. */
-  getImporters(source: string): ReadonlySet<string>;
-  /** Returns all sources that a given importer depends on, or an empty set. */
-  getSources(importer: string): ReadonlySet<string>;
-}
-//#endregion
-//#region src/index.d.ts
 declare function defineConfig(config: AppConfig): AppConfig;
 //#endregion
-export { type App, AppConfig, BabelAst, BinaryAssetMetadata, BoundPlugin, CONFIG_FILE_NAME, CUSTOM_ATTRIBUTES, CliProgram, DependencyTracker, type Document, type HTMLElement, HtmlMetadata, METADATA_TYPES, MarkdownAst, MarkdownMetadata, MetadataBase, MetadataSource, MetadataTypes, NodePath, PackageMetadata, Plugin, PostcssAst, PrintFormattedError, ResolveResult, ScriptMetadata, ServerReply, ServerRequest, StyleMetadata, SvgMetadata, TextAssetMetadata, WebManifestMetadata, appendForwardSlash, assign, basename, bytesToKB, camelCaseToKebabCase, capitalize, clamp, clearLn, cloneObject, defineConfig, dirname, downloadContent, escapeHtml, extname, filterScriptMetadata, filterStyleMetadata, firstPart, getLineColumn, hashContent, humanReadableBytes, isAbsolute, isBinaryAssetMetadata, isDefined, isHtmlMetadata, isMarkdownMetadata, isObject, isPackageMetadata, isScriptMetadata, isStyleMetadata, isSubpath, isSvgMetadata, isTextAssetMetadata, isURL, isWebManifestMetadata, join, kebabToCamelCase, matchPath, mergeMaps, normalize, parse, print, printFmtError, rebaseRelativePath, relative, replaceExtension, resolve, safeReadFile, safeReadFileSync, sourceRelativeToRoot, trimDotPrefix };
+export { type App, type AppConfig, type BabelAst, type Baseline, type BaselineStatus, type BinaryAssetMetadata, type BoundPlugin, type CONFIG_FILE_NAME, type CUSTOM_ATTRIBUTES, type CliProgram, type DeferredPass, type DeferredPassHandler, DependencyTracker, type Document, type HTMLDataV1, type HTMLElement, type HtmlMetadata, type IAttributeData, type IReference, type ITagData, type IValueData, type IValueSet, METADATA_TYPES, type MarkdownAst, type MarkdownMetadata, type MarkupContent, type MarkupKind, type MetadataBase, type MetadataSource, type MetadataTypes, type NodePath, type PackageMetadata, type Plugin, type PostcssAst, PrintFormattedError, type ResolveResult, Resolver, type ScriptMetadata, type ServerReply, type ServerRequest, type StringifyOptions, type StyleMetadata, type SvgMetadata, type TextAssetMetadata, ValueOrError, type WebManifestMetadata, assign, bytesToKB, camelCaseToKebabCase, capitalize, clamp, clearLn, cloneObject, defineConfig, downloadContent, escapeHtml, filterScriptMetadata, filterStyleMetadata, getLineColumn, handleError, hashContent, humanReadableBytes, isBinaryAssetMetadata, isDefined, isHtmlLink, isHtmlMetadata, isMarkdownMetadata, isObject, isPackageMetadata, isScriptMetadata, isStyleMetadata, isSvgMetadata, isTextAssetMetadata, isURL, isValidRelativePath, isWebManifestMetadata, kebabToCamelCase, mergeMaps, path_d_exports as path, print, printFmtError, safeReadFile, safeReadFileSync, splitHtmlLink, valueOrError };
 //# sourceMappingURL=index.d.mts.map