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

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 { basename, extname, isAbsolute, parse as parse$1, resolve } from "node:path";
 import { ObjectEncodingOptions, OpenMode, PathLike, PathOrFileDescriptor } from "node:fs";
 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,596 @@ 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>;
+  /** Whether a source that resolves to a missing file is logged, once. The result says so either way. */
+  shouldWarnOnMissing: boolean;
+  static JS_EXTENSIONS: Set<string>;
+  static HTML_EXTENSIONS: Set<string>;
+  constructor(root: string, isProduction?: boolean, configAliases?: Record<string, string>, shouldWarnOnMissing?: boolean);
+  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/utilities/path.d.ts
+//#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/lsp.d.ts
+/**
+ * JavaScript a plugin embeds in HTML, described for the language server: which files carry it, where it sits in their text, and
+ * what the code can see. The server serves those regions through the project's TypeScript, as TypeScript.
+ */
+interface EmbeddedLanguage {
+  /** Names the virtual document the regions are served from, so diagnostics say where they come from. */
+  name: string;
+  /** Whether a file carries this language, given its path relative to the project root. */
+  filter: (file: string) => boolean;
+  /**
+   * The regions in a matching document, as offsets into its text, in order and not overlapping. A region a plugin earlier in the
+   * config claimed already stays that plugin's: the core plugin, last in the config, only gets the scripts nobody else knows.
+   */
+  findRegions: (document: DocumentInfo) => EmbeddedRegion[];
+  /**
+   * Whether the editor's own grammar colours the regions, a `<script type="application/x-typescript">` body say. The server then
+   * colours only what TypeScript knows about the identifiers; otherwise it colours the keywords, literals and operators as well.
+   */
+  isColouredByEditor?: boolean;
+  /**
+   * Appended to the virtual document: declarations for what the regions' code can see. In a module they shadow globals of the
+   * same name; in a script, whose top level is the global scope, they are those globals.
+   */
+  prelude?: string | ((document: DocumentInfo) => string);
+}
+/** A stretch of a document, as offsets into its text. */
+interface TextRange {
+  start: number;
+  end: number;
+}
+/** A stretch of a document in an embedded language. */
+interface EmbeddedRegion extends TextRange {
+  /**
+   * Whether the code is a module of its own, a `<script type="module">` say: served as its own file, so its top level is its
+   * alone, rather than with the language's other regions, which share a scope like classic scripts do.
+   */
+  isModule?: boolean;
+  /**
+   * The whole construct the code sits in, delimiters included, `{{ … }}` for a placeholder: what the languages around it see as a
+   * hole. The region itself when left out.
+   */
+  extent?: TextRange;
+}
+/**
+ * A document as the language server parsed it, so a plugin never has to: the elements with their attributes and where everything
+ * sits, and a resolver for the sources they point at.
+ */
+interface DocumentInfo {
+  /** The document's path relative to the project root. */
+  file: string;
+  /** The document's HTML text. For a markdown document, the parts that can never be HTML are blanked out. */
+  text: string;
+  /** Every element in document order. */
+  elements: ElementInfo[];
+  /** The elements with one of the given tag names. */
+  select: (...names: string[]) => ElementInfo[];
+  /** The text of a range, an element's content say. */
+  textOf: (range: TextRange) => string;
+  /** Resolves a source the way the build does, relative to the document and through the project's aliases. */
+  resolve: (source: string) => ResolvedSource | undefined;
+}
+/** Where a source lands once resolved. */
+interface ResolvedSource {
+  /** The absolute path the source lands on. */
+  path: string;
+  /** Whether there is a file there. */
+  exists: boolean;
+}
+/** An element of the document, with its attributes and where it sits. */
+interface ElementInfo {
+  /** The tag name, lower case. */
+  name: string;
+  /** The attributes in the start tag, in order. */
+  attributes: AttributeInfo[];
+  /** The enclosing element, or nothing at the top level. */
+  parent: ElementInfo | undefined;
+  /** The elements directly inside. */
+  children: ElementInfo[];
+  /** The whole element, from its `<` to the end of its end tag, or of its start tag when it has none. */
+  range: TextRange;
+  /** The tag name in the start tag. */
+  nameRange: TextRange;
+  /** Between the start and the end tag, or up to where the element ends when it has no end tag; nothing for a void element. */
+  contentRange: TextRange | undefined;
+  /** The attribute with a name, matched regardless of case. */
+  attribute: (name: string) => AttributeInfo | undefined;
+  /** Whether an attribute with a name is there, regardless of case. */
+  has: (name: string) => boolean;
+}
+/** An attribute of an element, with its value unquoted. */
+interface AttributeInfo {
+  /** The attribute name as written. */
+  name: string;
+  /** The value without its quotes, or nothing for an attribute written without a value. */
+  value: string | undefined;
+  /** The element the attribute is on. */
+  element: ElementInfo;
+  /** The attribute name in the start tag. */
+  nameRange: TextRange;
+  /** The value without its quotes, when there is one. */
+  valueRange: TextRange | undefined;
+}
+/** Where a problem is: an element underlines its tag name, an attribute its value or else its name, a range itself. */
+type ProblemTarget = ElementInfo | AttributeInfo | TextRange;
+/** Collects what a plugin finds wrong with a document, each problem shown at its target with the plugin's name. */
+interface ProblemReporter {
+  /** Something the build would reject. */
+  error: (target: ProblemTarget, message: string) => void;
+  /** Something the build accepts but that is likely a mistake. */
+  warn: (target: ProblemTarget, message: string) => void;
+  /** Something worth knowing. */
+  info: (target: ProblemTarget, message: string) => void;
+  /** A suggestion, shown without underlining. */
+  hint: (target: ProblemTarget, message: string) => void;
+}
+//#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>;
+  /** The tags and attributes the plugin adds to HTML, for completion and hover in the editor. */
+  lspHtmlData?: () => HTMLDataV1 | undefined | Promise<HTMLDataV1 | undefined>;
+  /** Languages the plugin embeds in HTML, for the language server to serve their regions through the project's TypeScript. */
+  lspEmbeddedLanguages?: () => EmbeddedLanguage[];
+  /**
+   * Checks a document for the language server, reporting what the plugin finds wrong: misused tags, attributes, values. Runs on
+   * every edit, over the source as written, before any plugin has run: a value another plugin fills in later (see `isDynamic`) or
+   * a tag another plugin rewrites first is not a mistake, so only report what no plugin order can make right. `checkFileExists`
+   * and the other helpers exported by the package cover the common checks.
+   */
+  lspValidate?: (document: DocumentInfo, report: ProblemReporter) => 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/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/helpers/lsp-checks.d.ts
+/** Whether an attribute value is only known later: it holds a placeholder something else fills in. */
+declare function isDynamic(value: string): boolean;
+/**
+ * Reports an attribute whose value is a path to a file that is not there. A URL, an absolute link or a value with a placeholder
+ * is left alone.
+ */
+declare function checkFileExists(attribute: AttributeInfo, document: DocumentInfo, report: ProblemReporter): void;
+/** Reports an attribute whose value is not the JSON of an object. A value with a placeholder is left alone. */
+declare function checkJsonObject(attribute: AttributeInfo, report: ProblemReporter): void;
+/** Whether a string is the JSON of an object. */
+declare function isJsonObject(text: string): boolean;
+/** Whether a script element holds JavaScript, going by its `type`: the build leaves any other kind of script alone. */
+declare function isJavaScript(script: ElementInfo): boolean;
+/** Whether a `<script>` is marked as TypeScript for the editor, which also keeps the editor's own script support out. */
+declare function isTypeScriptScript(script: ElementInfo): boolean;
+/** Whether an element has nothing but whitespace between its tags. */
+declare function isEmptyElement(element: ElementInfo, document: DocumentInfo): boolean;
+//#endregion
+//#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 +1967,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 +1976,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 +2018,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 +2041,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 +2094,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 AttributeInfo, 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 DocumentInfo, type ElementInfo, type EmbeddedLanguage, type EmbeddedRegion, 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 ProblemReporter, type ProblemTarget, type ResolveResult, type ResolvedSource, Resolver, type ScriptMetadata, type ServerReply, type ServerRequest, type StringifyOptions, type StyleMetadata, type SvgMetadata, type TextAssetMetadata, type TextRange, ValueOrError, type WebManifestMetadata, assign, bytesToKB, camelCaseToKebabCase, capitalize, checkFileExists, checkJsonObject, clamp, clearLn, cloneObject, defineConfig, downloadContent, escapeHtml, filterScriptMetadata, filterStyleMetadata, getLineColumn, handleError, hashContent, humanReadableBytes, isBinaryAssetMetadata, isDefined, isDynamic, isEmptyElement, isHtmlLink, isHtmlMetadata, isJavaScript, isJsonObject, isMarkdownMetadata, isObject, isPackageMetadata, isScriptMetadata, isStyleMetadata, isSvgMetadata, isTextAssetMetadata, isTypeScriptScript, isURL, isValidRelativePath, isWebManifestMetadata, kebabToCamelCase, mergeMaps, path_d_exports as path, print, printFmtError, safeReadFile, safeReadFileSync, splitHtmlLink, valueOrError };
 //# sourceMappingURL=index.d.mts.map