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

package/lib/chunk-C7Uep-_p.mjs

@@ -0,0 +1,20 @@
+import { createRequire } from "node:module";
+
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) {
+		__defProp(target, name, {
+			get: all[name],
+			enumerable: true
+		});
+	}
+	if (!no_symbols) {
+		__defProp(target, Symbol.toStringTag, { value: "Module" });
+	}
+	return target;
+};
+
+//#endregion
+export { __exportAll as t };

package/lib/cli/index.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env -S node --experimental-vm-modules --no-warnings
-import { f as join, r as CONFIG_FILE_NAME, t as Log, u as isAbsolute, y as resolve } from "../logger-BuxMGhij.mjs";
+import { c as join, g as CONFIG_FILE_NAME, h as resolve, o as isAbsolute, t as Log } from "../logger-BfIn1ytK.mjs";
 import * as z from "zod";
 import { parseArgs } from "node:util";
 import { coerce, defineArguments, defineCLI, defineOptions, defineSubcommand } from "@staticbolt/args-parser";

package/lib/index.d.mts

@@ -1,4 +1,4 @@
-import { basename, extname, isAbsolute, parse, resolve } from "node:path";
+import { basename, extname, isAbsolute, parse as parse$1, 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";
@@ -1069,6 +1069,199 @@ interface AppConfig {
   browserslist?: string[];
 }
 //#endregion
+//#region src/cli/cli.d.ts
+declare class CliProgram {
+  #private;
+  program: {
+    cliName: "staticbolt";
+    meta: {
+      description: string;
+      example: string;
+    };
+    options: {
+      help: {
+        aliases: string[];
+        schema: z.ZodOptional<z.ZodBoolean>;
+        coerce: {
+          <T extends boolean | undefined>(terminalInput: string): T;
+          type: string;
+        };
+        meta: {
+          description: string;
+        };
+      };
+      version: {
+        aliases: string[];
+        schema: z.ZodOptional<z.ZodBoolean>;
+        coerce: {
+          <T extends boolean | undefined>(terminalInput: string): T;
+          type: string;
+        };
+        meta: {
+          description: string;
+        };
+      };
+    };
+    onExecute: (handler: (data: {
+      subcommand: undefined;
+      options: {
+        help?: boolean | undefined;
+        version?: boolean | undefined;
+      };
+      arguments: never;
+      positionals: never;
+      context: {
+        subcommand: undefined;
+        options: {
+          help: _$_staticbolt_args_parser0.OptionContext<z.ZodOptional<z.ZodBoolean>>;
+          version: _$_staticbolt_args_parser0.OptionContext<z.ZodOptional<z.ZodBoolean>>;
+        };
+        arguments: never;
+        positionals: never;
+      };
+    }) => void) => () => void;
+    execute: (input?: {
+      options?: {
+        help?: boolean | undefined;
+        version?: boolean | undefined;
+      } | undefined;
+      arguments?: undefined;
+      positionals?: undefined;
+    } | undefined) => void;
+    executeAsync: (input?: {
+      options?: {
+        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<{
+      cliName: "staticbolt";
+      meta: {
+        description: string;
+        example: string;
+      };
+      options: {
+        help: {
+          aliases: string[];
+          schema: z.ZodOptional<z.ZodBoolean>;
+          coerce: {
+            <T extends boolean | undefined>(terminalInput: string): T;
+            type: string;
+          };
+          meta: {
+            description: string;
+          };
+        };
+        version: {
+          aliases: string[];
+          schema: z.ZodOptional<z.ZodBoolean>;
+          coerce: {
+            <T extends boolean | undefined>(terminalInput: string): T;
+            type: string;
+          };
+          meta: {
+            description: string;
+          };
+        };
+      };
+    }>;
+    runAsync: (input: string | string[]) => Promise<_$_staticbolt_args_parser0.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;
+            type: string;
+          };
+          meta: {
+            description: string;
+          };
+        };
+        version: {
+          aliases: string[];
+          schema: z.ZodOptional<z.ZodBoolean>;
+          coerce: {
+            <T extends boolean | undefined>(terminalInput: string): T;
+            type: string;
+          };
+          meta: {
+            description: string;
+          };
+        };
+      };
+    }>>;
+  };
+  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<{
+    cliName: "staticbolt";
+    meta: {
+      description: string;
+      example: string;
+    };
+    options: {
+      help: {
+        aliases: string[];
+        schema: z.ZodOptional<z.ZodBoolean>;
+        coerce: {
+          <T extends boolean | undefined>(terminalInput: string): T;
+          type: string;
+        };
+        meta: {
+          description: string;
+        };
+      };
+      version: {
+        aliases: string[];
+        schema: z.ZodOptional<z.ZodBoolean>;
+        coerce: {
+          <T extends boolean | undefined>(terminalInput: string): T;
+          type: string;
+        };
+        meta: {
+          description: string;
+        };
+      };
+    };
+  }>;
+  readonly defineSubcommand: typeof defineSubcommand;
+  readonly defineOptions: typeof defineOptions;
+  readonly defineArguments: typeof defineArguments;
+  readonly coerce: {
+    string: <T extends string | undefined>(terminalInput: string) => T;
+    boolean: {
+      <T extends boolean | undefined>(terminalInput: string): T;
+      type: string;
+    };
+    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;
+    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;
+  };
+  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;
+}
+//#endregion
 //#region src/resolver/resolver.d.ts
 type ResolveResult$1 = {
   path: string;
@@ -1178,50 +1371,6 @@ declare class App {
   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";
@@ -1326,200 +1475,105 @@ interface BinaryAssetMetadata extends MetadataBase {
   data?: Uint8Array;
 }
 //#endregion
-//#region src/cli/cli.d.ts
-declare class CliProgram {
-  #private;
-  program: {
-    cliName: "staticbolt";
-    meta: {
-      description: string;
-      example: string;
-    };
-    options: {
-      help: {
-        aliases: string[];
-        schema: z.ZodOptional<z.ZodBoolean>;
-        coerce: {
-          <T extends boolean | undefined>(terminalInput: string): T;
-          type: string;
-        };
-        meta: {
-          description: string;
-        };
-      };
-      version: {
-        aliases: string[];
-        schema: z.ZodOptional<z.ZodBoolean>;
-        coerce: {
-          <T extends boolean | undefined>(terminalInput: string): T;
-          type: string;
-        };
-        meta: {
-          description: string;
-        };
-      };
-    };
-    onExecute: (handler: (data: {
-      subcommand: undefined;
-      options: {
-        help?: boolean | undefined;
-        version?: boolean | undefined;
-      };
-      arguments: never;
-      positionals: never;
-      context: {
-        subcommand: undefined;
-        options: {
-          help: _$_staticbolt_args_parser0.OptionContext<z.ZodOptional<z.ZodBoolean>>;
-          version: _$_staticbolt_args_parser0.OptionContext<z.ZodOptional<z.ZodBoolean>>;
-        };
-        arguments: never;
-        positionals: never;
-      };
-    }) => void) => () => void;
-    execute: (input?: {
-      options?: {
-        help?: boolean | undefined;
-        version?: boolean | undefined;
-      } | undefined;
-      arguments?: undefined;
-      positionals?: undefined;
-    } | undefined) => void;
-    executeAsync: (input?: {
-      options?: {
-        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<{
-      cliName: "staticbolt";
-      meta: {
-        description: string;
-        example: string;
-      };
-      options: {
-        help: {
-          aliases: string[];
-          schema: z.ZodOptional<z.ZodBoolean>;
-          coerce: {
-            <T extends boolean | undefined>(terminalInput: string): T;
-            type: string;
-          };
-          meta: {
-            description: string;
-          };
-        };
-        version: {
-          aliases: string[];
-          schema: z.ZodOptional<z.ZodBoolean>;
-          coerce: {
-            <T extends boolean | undefined>(terminalInput: string): T;
-            type: string;
-          };
-          meta: {
-            description: string;
-          };
-        };
-      };
-    }>;
-    runAsync: (input: string | string[]) => Promise<_$_staticbolt_args_parser0.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;
-            type: string;
-          };
-          meta: {
-            description: string;
-          };
-        };
-        version: {
-          aliases: string[];
-          schema: z.ZodOptional<z.ZodBoolean>;
-          coerce: {
-            <T extends boolean | undefined>(terminalInput: string): T;
-            type: string;
-          };
-          meta: {
-            description: string;
-          };
-        };
-      };
-    }>>;
-  };
-  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<{
-    cliName: "staticbolt";
-    meta: {
-      description: string;
-      example: string;
-    };
-    options: {
-      help: {
-        aliases: string[];
-        schema: z.ZodOptional<z.ZodBoolean>;
-        coerce: {
-          <T extends boolean | undefined>(terminalInput: string): T;
-          type: string;
-        };
-        meta: {
-          description: string;
-        };
-      };
-      version: {
-        aliases: string[];
-        schema: z.ZodOptional<z.ZodBoolean>;
-        coerce: {
-          <T extends boolean | undefined>(terminalInput: string): T;
-          type: string;
-        };
-        meta: {
-          description: string;
-        };
-      };
-    };
-  }>;
-  readonly defineSubcommand: typeof defineSubcommand;
-  readonly defineOptions: typeof defineOptions;
-  readonly defineArguments: typeof defineArguments;
-  readonly coerce: {
-    string: <T extends string | undefined>(terminalInput: string) => T;
-    boolean: {
-      <T extends boolean | undefined>(terminalInput: string): T;
-      type: string;
-    };
-    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;
-    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;
-  };
-  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;
+//#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/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/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, isSubpath, join, matchPath, normalize, parse$1 as parse, 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;
@@ -1576,41 +1630,6 @@ declare function matchPath(filePath: string, {
   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;
-}[];
-//#endregion
 //#region src/utilities/print-formatted-error.d.ts
 type Node$3 = Node$2 | Node$1 | Node;
 interface FormatErrorOptions {
@@ -1639,6 +1658,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?: ({
@@ -1709,26 +1734,8 @@ 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
-/**
- * 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/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, 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, ValueOrError, WebManifestMetadata, assign, bytesToKB, camelCaseToKebabCase, capitalize, clamp, clearLn, cloneObject, defineConfig, downloadContent, escapeHtml, filterScriptMetadata, filterStyleMetadata, getLineColumn, handleError, hashContent, humanReadableBytes, isBinaryAssetMetadata, isDefined, isHtmlMetadata, isMarkdownMetadata, isObject, isPackageMetadata, isScriptMetadata, isStyleMetadata, isSvgMetadata, isTextAssetMetadata, isURL, isWebManifestMetadata, kebabToCamelCase, mergeMaps, path_d_exports as path, print, printFmtError, safeReadFile, safeReadFileSync, valueOrError };
 //# sourceMappingURL=index.d.mts.map