@powerlines/plugin-env 0.13.4 → 0.13.6

package/dist/runtime-CUeIsMV9.d.ts

@@ -0,0 +1,1753 @@
+import { EnvPaths } from '@stryke/env/get-env-paths';
+import { PackageJson } from '@stryke/types/package-json';
+import { Jiti } from 'jiti';
+import { ParserOptions, ParseResult } from 'oxc-parser';
+import { Range } from 'semver';
+import { TransformResult, ExternalIdResult, HookFilter, UnpluginOptions, UnpluginContext, UnpluginBuildContext } from 'unplugin';
+import { PluginItem, PluginObj, PluginPass, transformAsync } from '@babel/core';
+import { Format } from '@storm-software/build-tools/types';
+import { LogLevelLabel } from '@storm-software/config-tools/types';
+import { StormWorkspaceConfig } from '@storm-software/config/types';
+import { NonUndefined, MaybePromise, FunctionLike } from '@stryke/types/base';
+import { TypeDefinition, TypeDefinitionParameter } from '@stryke/types/configuration';
+import { AssetGlob } from '@stryke/types/file';
+import { ResolvedPreviewOptions, PreviewOptions } from 'vite';
+import { BabelAPI } from '@babel/helper-plugin-utils';
+import { ArrayValues } from '@stryke/types/array';
+import { TsConfigJson, CompilerOptions } from '@stryke/types/tsconfig';
+import ts from 'typescript';
+import { O as OutputModeType, V as VirtualFileSystemInterface, a as VirtualFile, P as PowerlinesWriteFileOptions } from './vfs-Bl84Hw2V.js';
+
+type BabelPluginPass<TState = unknown> = PluginPass & TState;
+type BabelTransformPluginFilter = (code: string, id: string) => boolean;
+type BabelTransformPlugin<TContext extends Context = Context, TOptions extends Record<string, any> = Record<string, any>, TState = unknown> = ((context: TContext) => (options: {
+    name: string;
+    log: LogFn;
+    api: BabelAPI;
+    options: TOptions;
+    context: TContext;
+    dirname: string;
+}) => PluginObj<TOptions & BabelPluginPass<TState>>) & {
+    $$name: string;
+};
+type BabelTransformPluginOptions<TContext extends Context = Context, TOptions extends Record<string, any> = Record<string, any>, TState = unknown> = PluginItem | BabelTransformPlugin<TContext, TOptions, TState> | [BabelTransformPlugin<TContext, TOptions, TState>, TOptions] | [
+    BabelTransformPlugin<TContext, TOptions, TState>,
+    TOptions,
+    BabelTransformPluginFilter
+];
+type DeclareBabelTransformPluginReturn<TContext extends Context = Context, TOptions extends Record<string, any> = Record<string, any>, TState = any> = Omit<BabelTransformPlugin<TContext, TOptions, TState>, "$$name"> & Required<Pick<BabelTransformPlugin<TContext, TOptions, TState>, "$$name">>;
+
+type UnpluginBuildVariant = "rollup" | "webpack" | "rspack" | "vite" | "esbuild" | "farm" | "unloader" | "rolldown";
+interface BuildConfig {
+    /**
+     * The platform to build the project for
+     *
+     * @defaultValue "neutral"
+     */
+    platform?: "node" | "browser" | "neutral";
+    /**
+     * The alias mappings to use for module resolution during the build process.
+     *
+     * @remarks
+     * This option allows you to define custom path aliases for modules, which can be useful for simplifying imports and managing dependencies.
+     *
+     * @example
+     * ```ts
+     * {
+     *   alias: {
+     *     "@utils": "./src/utils",
+     *     "@components": "./src/components"
+     *   }
+     * }
+     * ```
+     */
+    alias?: Record<string, string>;
+    /**
+     * A list of modules that should not be bundled, even if they are external dependencies.
+     *
+     * @remarks
+     * This option is useful for excluding specific modules from the bundle, such as Node.js built-in modules or other libraries that should not be bundled.
+     */
+    external?: (string | RegExp)[];
+    /**
+     * A list of modules that should always be bundled, even if they are external dependencies.
+     */
+    noExternal?: (string | RegExp)[];
+    /**
+     * Should the Powerlines CLI processes skip bundling the `node_modules` directory?
+     */
+    skipNodeModulesBundle?: boolean;
+    /**
+     * Should the Powerlines processes skip the `"prepare"` task prior to building?
+     *
+     * @defaultValue false
+     */
+    skipPrepare?: boolean;
+}
+type BuildResolvedConfig = BuildConfig;
+
+declare const SUPPORTED_COMMANDS: readonly ["new", "clean", "prepare", "lint", "test", "build", "docs", "release", "finalize"];
+type CommandType = ArrayValues<typeof SUPPORTED_COMMANDS>;
+
+interface ResolvedEntryTypeDefinition extends TypeDefinition {
+    /**
+     * The user provided entry point in the source code
+     */
+    input: TypeDefinition;
+    /**
+     * An optional name to use in the package export during the build process
+     */
+    output?: string;
+}
+type BabelResolvedConfig = Omit<BabelUserConfig, "plugins" | "presets"> & Required<Pick<BabelUserConfig, "plugins" | "presets">>;
+type EnvironmentResolvedConfig = Omit<EnvironmentConfig, "consumer" | "mode" | "ssr" | "preview" | "mainFields" | "extensions"> & Required<Pick<EnvironmentConfig, "consumer" | "mode" | "ssr" | "mainFields" | "extensions">> & {
+    /**
+     * The name of the environment
+     */
+    name: string;
+    /**
+     * Configuration options for the preview server
+     */
+    preview?: ResolvedPreviewOptions;
+};
+type ResolvedAssetGlob = AssetGlob & Required<Pick<AssetGlob, "input">>;
+type OutputResolvedConfig = Required<Omit<OutputConfig, "assets"> & {
+    assets: ResolvedAssetGlob[];
+}>;
+/**
+ * The resolved options for the Powerlines project configuration.
+ */
+type ResolvedConfig<TUserConfig extends UserConfig = UserConfig> = Omit<TUserConfig, "name" | "title" | "plugins" | "mode" | "environments" | "platform" | "tsconfig" | "lint" | "test" | "build" | "transform" | "override" | "root" | "variant" | "type" | "output" | "logLevel" | "framework"> & Required<Pick<TUserConfig, "name" | "title" | "plugins" | "mode" | "environments" | "tsconfig" | "lint" | "test" | "build" | "transform" | "override" | "framework">> & {
+    /**
+     * The configuration options that were provided inline to the Powerlines CLI.
+     */
+    inlineConfig: InlineConfig<TUserConfig>;
+    /**
+     * The original configuration options that were provided by the user to the Powerlines process.
+     */
+    userConfig: TUserConfig;
+    /**
+     * A string identifier for the Powerlines command being executed.
+     */
+    command: NonUndefined<InlineConfig<TUserConfig>["command"]>;
+    /**
+     * The root directory of the project's source code
+     *
+     * @defaultValue "\{projectRoot\}/src"
+     */
+    sourceRoot: NonUndefined<TUserConfig["sourceRoot"]>;
+    /**
+     * The root directory of the project.
+     */
+    projectRoot: NonUndefined<TUserConfig["root"]>;
+    /**
+     * The type of project being built.
+     */
+    projectType: NonUndefined<TUserConfig["type"]>;
+    /**
+     * The output configuration options to use for the build process
+     */
+    output: OutputResolvedConfig;
+    /**
+     * The log level to use for the Powerlines processes.
+     *
+     * @defaultValue "info"
+     */
+    logLevel: "error" | "warn" | "info" | "debug" | "trace" | null;
+};
+
+interface PluginHookObject<THookFunction extends FunctionLike, TFilter extends keyof HookFilter | undefined = undefined> {
+    /**
+     * The order in which the plugin should be applied.
+     */
+    order?: "pre" | "post" | null | undefined;
+    /**
+     * A filter to determine when the hook should be called.
+     */
+    filter?: TFilter;
+    /**
+     * The hook function to be called.
+     */
+    handler: THookFunction;
+}
+type PluginHook<THookFunction extends FunctionLike, TFilter extends keyof HookFilter | undefined = undefined> = THookFunction | PluginHookObject<THookFunction, TFilter>;
+/**
+ * A result returned by the plugin from the `generateTypes` hook that describes the declaration types output file.
+ */
+interface GenerateTypesResult {
+    directives?: string[];
+    code: string;
+}
+interface BasePluginHookFunctions<TContext extends PluginContext = PluginContext> extends Record<CommandType, (this: TContext) => MaybePromise<void>> {
+    /**
+     * A function that returns configuration options to be merged with the build context's options.
+     *
+     * @remarks
+     * Modify config before it's resolved. The hook can either mutate {@link Context.config} on the passed-in context directly, or return a partial config object that will be deeply merged into existing config.
+     *
+     * @warning User plugins are resolved before running this hook so injecting other plugins inside the config hook will have no effect. If you want to add plugins, consider doing so in the {@link Plugin.dependsOn} property instead.
+     *
+     * @see https://vitejs.dev/guide/api-plugin#config
+     *
+     * @param this - The build context.
+     * @param config - The partial configuration object to be modified.
+     * @returns A promise that resolves to a partial configuration object.
+     */
+    config: (this: Context<TContext["config"]>) => MaybePromise<Partial<TContext["config"]["userConfig"]>>;
+    /**
+     * Modify environment configs before it's resolved. The hook can either mutate the passed-in environment config directly, or return a partial config object that will be deeply merged into existing config.
+     *
+     * @remarks
+     * This hook is called for each environment with a partially resolved environment config that already accounts for the default environment config values set at the root level. If plugins need to modify the config of a given environment, they should do it in this hook instead of the config hook. Leaving the config hook only for modifying the root default environment config.
+     *
+     * @see https://vitejs.dev/guide/api-plugin#configenvironment
+     *
+     * @param this - The build context.
+     * @param name - The name of the environment being configured.
+     * @param environment - The Vite-like environment object containing information about the current build environment.
+     * @returns A promise that resolves when the hook is complete.
+     */
+    configEnvironment: (this: TContext, name: string, environment: EnvironmentConfig) => MaybePromise<Partial<EnvironmentResolvedConfig> | undefined | null>;
+    /**
+     * A hook that is called when the plugin is resolved.
+     *
+     * @see https://vitejs.dev/guide/api-plugin#configresolved
+     *
+     * @param this - The build context.
+     * @returns A promise that resolves when the hook is complete.
+     */
+    configResolved: (this: TContext) => MaybePromise<void>;
+    /**
+     * A hook that is called to overwrite the generated declaration types file (.d.ts). The generated type definitions should describe the built-in modules/logic added during the `prepare` task.
+     *
+     * @param this - The build context.
+     * @param code - The source code to generate types for.
+     * @returns A promise that resolves when the hook is complete.
+     */
+    generateTypes: (this: TContext, code: string) => MaybePromise<GenerateTypesResult | string | undefined | null>;
+    /**
+     * A hook that is called at the start of the build process.
+     *
+     * @param this - The build context and unplugin build context.
+     * @returns A promise that resolves when the hook is complete.
+     */
+    buildStart: (this: BuildPluginContext<TContext["config"]> & TContext) => MaybePromise<void>;
+    /**
+     * A hook that is called at the end of the build process.
+     *
+     * @param this - The build context and unplugin build context.
+     * @returns A promise that resolves when the hook is complete.
+     */
+    buildEnd: (this: BuildPluginContext<TContext["config"]> & TContext) => MaybePromise<void>;
+    /**
+     * A hook that is called to transform the source code.
+     *
+     * @param this - The build context, unplugin build context, and unplugin context.
+     * @param code - The source code to transform.
+     * @param id - The identifier of the source code.
+     * @returns A promise that resolves when the hook is complete.
+     */
+    transform: (this: BuildPluginContext<TContext["config"]> & TContext, code: string, id: string) => MaybePromise<TransformResult>;
+    /**
+     * A hook that is called to load the source code.
+     *
+     * @param this - The build context, unplugin build context, and unplugin context.
+     * @param id - The identifier of the source code.
+     * @returns A promise that resolves when the hook is complete.
+     */
+    load: (this: BuildPluginContext<TContext["config"]> & TContext, id: string) => MaybePromise<TransformResult>;
+    /**
+     * A hook that is called to resolve the identifier of the source code.
+     *
+     * @param this - The build context, unplugin build context, and unplugin context.
+     * @param id - The identifier of the source code.
+     * @param importer - The importer of the source code.
+     * @param options - The options for resolving the identifier.
+     * @returns A promise that resolves when the hook is complete.
+     */
+    resolveId: (this: BuildPluginContext<TContext["config"]> & TContext, id: string, importer: string | undefined, options: {
+        isEntry: boolean;
+    }) => MaybePromise<string | ExternalIdResult | null | undefined>;
+    /**
+     * A hook that is called to write the bundle to disk.
+     *
+     * @param this - The build context.
+     * @returns A promise that resolves when the hook is complete.
+     */
+    writeBundle: (this: TContext) => MaybePromise<void>;
+}
+type BuildPlugin<TContext extends PluginContext = PluginContext, TBuildVariant extends UnpluginBuildVariant = UnpluginBuildVariant, TOptions extends Required<UnpluginOptions>[TBuildVariant] = Required<UnpluginOptions>[TBuildVariant]> = {
+    [TKey in keyof TOptions]: TOptions[TKey] extends FunctionLike ? (this: ThisParameterType<TOptions[TKey]> & TContext, ...args: Parameters<TOptions[TKey]>) => ReturnType<TOptions[TKey]> | MaybePromise<ReturnType<TOptions[TKey]>> : TOptions[TKey];
+};
+type PluginHooks<TContext extends PluginContext = PluginContext> = {
+    [TKey in keyof BasePluginHookFunctions<TContext>]: PluginHook<BasePluginHookFunctions<TContext>[TKey]>;
+} & {
+    /**
+     * A function that returns configuration options to be merged with the build context's options.
+     *
+     * @remarks
+     * Modify config before it's resolved. The hook can either mutate {@link Context.config} on the passed-in context directly, or return a partial config object that will be deeply merged into existing config.
+     *
+     * @warning User plugins are resolved before running this hook so injecting other plugins inside the config hook will have no effect. If you want to add plugins, consider doing so in the {@link Plugin.dependsOn} property instead.
+     *
+     * @see https://vitejs.dev/guide/api-plugin#config
+     *
+     * @param this - The build context.
+     * @param config - The partial configuration object to be modified.
+     * @returns A promise that resolves to a partial configuration object.
+     */
+    config: PluginHook<(this: Context<TContext["config"]>) => MaybePromise<Partial<TContext["config"]["userConfig"]>>> | Partial<TContext["config"]["userConfig"]>;
+    /**
+     * A hook that is called to transform the source code.
+     *
+     * @param this - The build context, unplugin build context, and unplugin context.
+     * @param code - The source code to transform.
+     * @param id - The identifier of the source code.
+     * @returns A promise that resolves when the hook is complete.
+     */
+    transform: PluginHook<(this: BuildPluginContext<TContext["config"]> & TContext, code: string, id: string) => MaybePromise<TransformResult>, "code" | "id">;
+    /**
+     * A hook that is called to load the source code.
+     *
+     * @param this - The build context, unplugin build context, and unplugin context.
+     * @param id - The identifier of the source code.
+     * @returns A promise that resolves when the hook is complete.
+     */
+    load: PluginHook<(this: BuildPluginContext<TContext["config"]> & TContext, id: string) => MaybePromise<TransformResult>, "id">;
+    /**
+     * A hook that is called to resolve the identifier of the source code.
+     *
+     * @param this - The build context, unplugin build context, and unplugin context.
+     * @param id - The identifier of the source code.
+     * @param importer - The importer of the source code.
+     * @param options - The options for resolving the identifier.
+     * @returns A promise that resolves when the hook is complete.
+     */
+    resolveId: PluginHook<(this: BuildPluginContext<TContext["config"]> & TContext, id: string, importer: string | undefined, options: {
+        isEntry: boolean;
+    }) => MaybePromise<string | ExternalIdResult | null | undefined>, "id">;
+};
+type PluginBuildPlugins<TContext extends PluginContext = PluginContext> = {
+    [TBuildVariant in UnpluginBuildVariant]?: BuildPlugin<TContext, TBuildVariant>;
+};
+interface Plugin<in out TContext extends PluginContext<ResolvedConfig> = PluginContext<ResolvedConfig>> extends Partial<PluginHooks<TContext>>, PluginBuildPlugins<TContext> {
+    /**
+     * The name of the plugin, for use in deduplication, error messages and logs.
+     */
+    name: string;
+    /**
+     * Enforce plugin invocation tier similar to webpack loaders. Hooks ordering is still subject to the `order` property in the hook object.
+     *
+     * @remarks
+     * The Plugin invocation order is as follows:
+     * - `enforce: 'pre'` plugins
+     * - `order: 'pre'` plugin hooks
+     * - any other plugins (normal)
+     * - `order: 'post'` plugin hooks
+     * - `enforce: 'post'` plugins
+     *
+     * @see https://vitejs.dev/guide/api-plugin.html#plugin-ordering
+     * @see https://rollupjs.org/plugin-development/#build-hooks
+     * @see https://webpack.js.org/concepts/loaders/#enforce---pre-and-post
+     * @see https://esbuild.github.io/plugins/#concepts
+     */
+    enforce?: "pre" | "post";
+    /**
+     * A function to determine if two plugins are the same and can be de-duplicated.
+     *
+     * @remarks
+     * If this is not provided, plugins are de-duplicated by comparing their names.
+     *
+     * @param other - The other plugin to compare against.
+     * @returns `true` if the two plugins are the same, `false` otherwise.
+     */
+    dedupe?: false | ((other: Plugin<any>) => boolean);
+    /**
+     * A list of pre-requisite plugins that must be loaded before this plugin can be used.
+     */
+    dependsOn?: PluginConfig<any>[];
+    /**
+     * Define environments where this plugin should be active. By default, the plugin is active in all environments.
+     *
+     * @param environment - The environment to check.
+     * @returns `true` if the plugin should be active in the specified environment, `false` otherwise.
+     */
+    applyToEnvironment?: (environment: EnvironmentResolvedConfig) => MaybePromise<boolean | Plugin<any>>;
+}
+
+type ReflectionMode = "default" | "explicit" | "never";
+type RawReflectionMode = ReflectionMode | "" | boolean | string | string[] | undefined;
+/**
+ * Defines the level of reflection to be used during the transpilation process.
+ *
+ * @remarks
+ * The level determines how much extra data is captured in the byte code for each type. This can be one of the following values:
+ * - `minimal` - Only the essential type information is captured.
+ * - `normal` - Additional type information is captured, including some contextual data.
+ * - `verbose` - All available type information is captured, including detailed contextual data.
+ */
+type ReflectionLevel = "minimal" | "normal" | "verbose";
+interface DeepkitOptions {
+    /**
+     * Either true to activate reflection for all files compiled using this tsconfig,
+     * or a list of globs/file paths relative to this tsconfig.json.
+     * Globs/file paths can be prefixed with a ! to exclude them.
+     */
+    reflection?: RawReflectionMode;
+    /**
+     * Defines the level of reflection to be used during the transpilation process.
+     *
+     * @remarks
+     * The level determines how much extra data is captured in the byte code for each type. This can be one of the following values:
+     * - `minimal` - Only the essential type information is captured.
+     * - `normal` - Additional type information is captured, including some contextual data.
+     * - `verbose` - All available type information is captured, including detailed contextual data.
+     */
+    reflectionLevel?: ReflectionLevel;
+}
+type TSCompilerOptions = CompilerOptions & DeepkitOptions;
+/**
+ * The TypeScript compiler configuration.
+ *
+ * @see https://www.typescriptlang.org/docs/handbook/tsconfig-json.html
+ */
+interface TSConfig extends Omit<TsConfigJson, "reflection"> {
+    /**
+     * Either true to activate reflection for all files compiled using this tsconfig,
+     * or a list of globs/file paths relative to this tsconfig.json.
+     * Globs/file paths can be prefixed with a ! to exclude them.
+     */
+    reflection?: RawReflectionMode;
+    /**
+     * Defines the level of reflection to be used during the transpilation process.
+     *
+     * @remarks
+     * The level determines how much extra data is captured in the byte code for each type. This can be one of the following values:
+     * - `minimal` - Only the essential type information is captured.
+     * - `normal` - Additional type information is captured, including some contextual data.
+     * - `verbose` - All available type information is captured, including detailed contextual data.
+     */
+    reflectionLevel?: ReflectionLevel;
+    /**
+     * Instructs the TypeScript compiler how to compile `.ts` files.
+     */
+    compilerOptions?: TSCompilerOptions;
+}
+type ParsedTypeScriptConfig = ts.ParsedCommandLine & {
+    originalTsconfigJson: TsConfigJson;
+    tsconfigJson: TSConfig;
+    tsconfigFilePath: string;
+};
+
+type LogFn = (type: LogLevelLabel, ...args: string[]) => void;
+/**
+ * The {@link StormWorkspaceConfig | configuration} object for an entire Powerlines workspace
+ */
+type WorkspaceConfig = Partial<StormWorkspaceConfig> & Required<Pick<StormWorkspaceConfig, "workspaceRoot">>;
+type PluginFactory<in out TContext extends PluginContext = PluginContext, TOptions = any> = (options: TOptions) => MaybePromise<Plugin<TContext>>;
+/**
+ * A configuration tuple for a Powerlines plugin.
+ */
+type PluginConfigTuple<TContext extends PluginContext = PluginContext, TOptions = any> = [string | PluginFactory<TContext, TOptions>, TOptions] | [Plugin<TContext>];
+/**
+ * A configuration object for a Powerlines plugin.
+ */
+type PluginConfigObject<TContext extends PluginContext = PluginContext, TOptions = any> = {
+    plugin: string | PluginFactory<TContext, TOptions>;
+    options: TOptions;
+} | {
+    plugin: Plugin<TContext>;
+    options?: never;
+};
+/**
+ * A configuration tuple for a Powerlines plugin.
+ */
+type PluginConfig<TContext extends PluginContext = PluginContext> = string | PluginFactory<TContext, void> | Plugin<TContext> | Promise<Plugin<TContext>> | PluginConfigTuple<TContext> | PluginConfigObject<TContext>;
+type ProjectType = "application" | "library";
+type BabelUserConfig = Parameters<typeof transformAsync>[1] & {
+    /**
+     * The Babel plugins to be used during the build process
+     */
+    plugins?: BabelTransformPluginOptions[];
+    /**
+     * The Babel presets to be used during the build process
+     */
+    presets?: BabelTransformPluginOptions[];
+};
+interface OutputConfig {
+    /**
+     * The path to output the final compiled files to
+     *
+     * @remarks
+     * If a value is not provided, Powerlines will attempt to:
+     * 1. Use the `outDir` value in the `tsconfig.json` file.
+     * 2. Use the `dist` directory in the project root directory.
+     *
+     * @defaultValue "dist/\{projectRoot\}"
+     */
+    outputPath?: string;
+    /**
+     * The format of the output files
+     *
+     * @defaultValue "virtual"
+     */
+    mode?: OutputModeType;
+    /**
+     * The path of the generated runtime declaration file relative to the workspace root.
+     *
+     * @defaultValue "\{projectRoot\}/powerlines.d.ts"
+     */
+    dts?: string | false;
+    /**
+     * A prefix to use for identifying builtin modules
+     *
+     * @remarks
+     * This prefix will be used to identify all builtin modules generated during the "prepare" phase. An example builtin ID for a module called `"utils"` would be `"{builtinPrefix}:utils"`.
+     *
+     * @defaultValue "powerlines"
+     */
+    builtinPrefix?: string;
+    /**
+     * The folder where the generated runtime artifacts will be located
+     *
+     * @remarks
+     * This folder will contain all runtime artifacts and builtins generated during the "prepare" phase.
+     *
+     * @defaultValue "\{projectRoot\}/.powerlines"
+     */
+    artifactsFolder?: string;
+    /**
+     * The module format of the output files
+     *
+     * @remarks
+     * This option can be a single format or an array of formats. If an array is provided, multiple builds will be generated for each format.
+     *
+     * @defaultValue "esm"
+     */
+    format?: Format | Format[];
+    /**
+     * A list of assets to copy to the output directory
+     *
+     * @remarks
+     * The assets can be specified as a string (path to the asset) or as an object with a `glob` property (to match multiple files). The paths are relative to the project root directory.
+     */
+    assets?: Array<string | AssetGlob>;
+}
+interface BaseConfig {
+    /**
+     * The name of the project
+     */
+    name?: string;
+    /**
+     * The project display title
+     *
+     * @remarks
+     * This option is used in documentation generation and other places where a human-readable title is needed.
+     */
+    title?: string;
+    /**
+     * A description of the project
+     *
+     * @remarks
+     * If this option is not provided, the build process will try to use the \`description\` value from the `\package.json\` file.
+     */
+    description?: string;
+    /**
+     * The log level to use for the Powerlines processes.
+     *
+     * @defaultValue "info"
+     */
+    logLevel?: LogLevelLabel | null;
+    /**
+     * A custom logger function to use for logging messages
+     */
+    customLogger?: LogFn;
+    /**
+     * Explicitly set a mode to run in. This mode will be used at various points throughout the Powerlines processes, such as when compiling the source code.
+     *
+     * @defaultValue "production"
+     */
+    mode?: "development" | "test" | "production";
+    /**
+     * The entry point(s) for the application
+     */
+    entry?: TypeDefinitionParameter | TypeDefinitionParameter[];
+    /**
+     * Configuration for linting the source code
+     */
+    lint?: Record<string, any> | false;
+    /**
+     * Configuration for testing the source code
+     */
+    test?: Record<string, any> | false;
+    /**
+     * Configuration for the output of the build process
+     */
+    output?: OutputConfig;
+    /**
+     * Configuration for the transformation of the source code
+     */
+    transform?: Record<string, any>;
+    /**
+     * Options to to provide to the build process
+     */
+    build?: BuildConfig;
+    /**
+     * Configuration for documentation generation
+     *
+     * @remarks
+     * This configuration will be used by the documentation generation plugins during the `docs` command.
+     */
+    docs?: Record<string, any>;
+    /**
+     * The path to the tsconfig file to be used by the compiler
+     *
+     * @remarks
+     * If a value is not provided, the plugin will attempt to find the `tsconfig.json` file in the project root directory. The parsed tsconfig compiler options will be merged with the {@link Options.tsconfigRaw} value (if provided).
+     *
+     * @defaultValue "\{projectRoot\}/tsconfig.json"
+     */
+    tsconfig?: string;
+    /**
+     * The raw {@link TSConfig} object to be used by the compiler. This object will be merged with the `tsconfig.json` file.
+     *
+     * @see https://www.typescriptlang.org/tsconfig
+     *
+     * @remarks
+     * If populated, this option takes higher priority than `tsconfig`
+     */
+    tsconfigRaw?: TSConfig;
+}
+interface EnvironmentConfig extends BaseConfig {
+    /**
+     * Array of strings indicating the order in which fields in a package.json file should be resolved to determine the entry point for a module.
+     *
+     * @defaultValue `['browser', 'module', 'jsnext:main', 'jsnext']`
+     */
+    mainFields?: string[];
+    /**
+     * Array of strings indicating what conditions should be used for module resolution.
+     */
+    conditions?: string[];
+    /**
+     * Array of strings indicating what conditions should be used for external modules.
+     */
+    externalConditions?: string[];
+    /**
+     * Array of strings indicating what file extensions should be used for module resolution.
+     *
+     * @defaultValue `['.mjs', '.js', '.mts', '.ts', '.jsx', '.tsx', '.json']`
+     */
+    extensions?: string[];
+    /**
+     * Array of strings indicating what modules should be deduplicated to a single version in the build.
+     *
+     * @remarks
+     * This option is useful for ensuring that only one version of a module is included in the bundle, which can help reduce bundle size and avoid conflicts.
+     */
+    dedupe?: string[];
+    /**
+     * Array of strings or regular expressions that indicate what modules are builtin for the environment.
+     */
+    builtins?: (string | RegExp)[];
+    /**
+     * Configuration options for the preview server
+     */
+    preview?: PreviewOptions;
+    /**
+     * A flag indicating whether the build is for a Server-Side Rendering environment.
+     */
+    ssr?: boolean;
+    /**
+     * Define if this environment is used for Server-Side Rendering
+     *
+     * @defaultValue "server" (if it isn't the client environment)
+     */
+    consumer?: "client" | "server";
+}
+interface CommonUserConfig extends BaseConfig {
+    /**
+     * The type of project being built
+     *
+     * @defaultValue "application"
+     */
+    type?: ProjectType;
+    /**
+     * The root directory of the project
+     */
+    root: string;
+    /**
+     * The root directory of the project's source code
+     *
+     * @defaultValue "\{root\}/src"
+     */
+    sourceRoot?: string;
+    /**
+     * A path to a custom configuration file to be used instead of the default `storm.json`, `powerlines.config.js`, or `powerlines.config.ts` files.
+     *
+     * @remarks
+     * This option is useful for running Powerlines commands with different configuration files, such as in CI/CD environments or when testing different configurations.
+     */
+    configFile?: string;
+    /**
+     * Should the Powerlines CLI processes skip installing missing packages?
+     *
+     * @remarks
+     * This option is useful for CI/CD environments where the installation of packages is handled by a different process.
+     *
+     * @defaultValue false
+     */
+    skipInstalls?: boolean;
+    /**
+     * Should the compiler processes skip any improvements that make use of cache?
+     *
+     * @defaultValue false
+     */
+    skipCache?: boolean;
+    /**
+     * A list of resolvable paths to plugins used during the build process
+     */
+    plugins?: PluginConfig<PluginContext<any>>[];
+    /**
+     * Environment-specific configurations
+     */
+    environments?: Record<string, EnvironmentConfig>;
+    /**
+     * A string identifier that allows a child framework or tool to identify itself when using Powerlines.
+     *
+     * @remarks
+     * If no values are provided for {@link OutputConfig.dts | output.dts}, {@link OutputConfig.builtinPrefix | output.builtinPrefix}, or {@link OutputConfig.artifactsFolder | output.artifactsFolder}, this value will be used as the default.
+     *
+     * @defaultValue "powerlines"
+     */
+    framework?: string;
+}
+type UserConfig<TBuildConfig extends BuildConfig = BuildConfig, TBuildResolvedConfig extends BuildResolvedConfig = BuildResolvedConfig, TBuildVariant extends string = any> = CommonUserConfig & {
+    build?: TBuildConfig & {
+        /**
+         * The build variant being used by the Powerlines engine.
+         */
+        variant?: TBuildVariant;
+    };
+    override?: Partial<TBuildResolvedConfig>;
+};
+type PowerlinesCommand = "new" | "prepare" | "build" | "lint" | "test" | "docs" | "release" | "clean";
+/**
+ * The configuration provided while executing Powerlines commands.
+ */
+type InlineConfig<TUserConfig extends UserConfig = UserConfig> = Partial<TUserConfig> & {
+    /**
+     * A string identifier for the Powerlines command being executed
+     */
+    command: PowerlinesCommand;
+};
+
+/**
+ * The severity level of a {@link LogRecord}.
+ */
+type LogLevel = "debug" | "info" | "warning" | "error" | "fatal";
+declare const LogLevel: {
+    DEBUG: LogLevel;
+    INFO: LogLevel;
+    WARNING: LogLevel;
+    ERROR: LogLevel;
+    FATAL: LogLevel;
+};
+interface MetaInfo {
+    /**
+     * The checksum generated from the resolved options
+     */
+    checksum: string;
+    /**
+     * The build id
+     */
+    buildId: string;
+    /**
+     * The release id
+     */
+    releaseId: string;
+    /**
+     * The build timestamp
+     */
+    timestamp: number;
+    /**
+     * A hash that represents the path to the project root directory
+     */
+    projectRootHash: string;
+    /**
+     * A hash that represents the path to the project root directory
+     */
+    configHash: string;
+    /**
+     * A mapping of runtime ids to their corresponding file paths
+     */
+    builtinIdMap: Record<string, string>;
+    /**
+     * A mapping of virtual file paths to their corresponding file contents
+     */
+    virtualFiles: Record<string, string | null>;
+}
+interface Resolver extends Jiti {
+    plugin: Jiti;
+}
+interface InitContextOptions {
+    /**
+     * If false, the plugin will be loaded after all other plugins.
+     *
+     * @defaultValue true
+     */
+    isHighPriority: boolean;
+}
+interface Context<TResolvedConfig extends ResolvedConfig = ResolvedConfig> {
+    /**
+     * The Storm workspace configuration
+     */
+    workspaceConfig: WorkspaceConfig;
+    /**
+     * An object containing the options provided to Powerlines
+     */
+    config: TResolvedConfig;
+    /**
+     * A logging function for the Powerlines engine
+     */
+    log: LogFn;
+    /**
+     * The metadata information
+     */
+    meta: MetaInfo;
+    /**
+     * The metadata information currently written to disk
+     */
+    persistedMeta?: MetaInfo;
+    /**
+     * The Powerlines artifacts directory
+     */
+    artifactsPath: string;
+    /**
+     * The path to the Powerlines builtin runtime modules directory
+     */
+    builtinsPath: string;
+    /**
+     * The path to the Powerlines entry modules directory
+     */
+    entryPath: string;
+    /**
+     * The path to the Powerlines TypeScript declaration files directory
+     */
+    dtsPath: string;
+    /**
+     * The path to a directory where the reflection data buffers (used by the build processes) are stored
+     */
+    dataPath: string;
+    /**
+     * The path to a directory where the project cache (used by the build processes) is stored
+     */
+    cachePath: string;
+    /**
+     * The Powerlines environment paths
+     */
+    envPaths: EnvPaths;
+    /**
+     * The file system path to the Powerlines package installation
+     */
+    powerlinesPath: string;
+    /**
+     * The relative path to the Powerlines workspace root directory
+     */
+    relativeToWorkspaceRoot: string;
+    /**
+     * The project's `package.json` file content
+     */
+    packageJson: PackageJson & Record<string, any>;
+    /**
+     * The project's `project.json` file content
+     */
+    projectJson?: Record<string, any>;
+    /**
+     * The dependency installations required by the project
+     */
+    dependencies: Record<string, string | Range>;
+    /**
+     * The development dependency installations required by the project
+     */
+    devDependencies: Record<string, string | Range>;
+    /**
+     * The parsed TypeScript configuration from the `tsconfig.json` file
+     */
+    tsconfig: ParsedTypeScriptConfig;
+    /**
+     * The entry points of the source code
+     */
+    entry: ResolvedEntryTypeDefinition[];
+    /**
+     * The virtual file system manager used during the build process to reference generated runtime files
+     */
+    fs: VirtualFileSystemInterface;
+    /**
+     * The Jiti module resolver
+     */
+    resolver: Resolver;
+    /**
+     * The builtin module id that exist in the Powerlines virtual file system
+     */
+    builtins: string[];
+    /**
+     * The Powerlines builtin virtual files
+     */
+    getBuiltins: () => Promise<VirtualFile[]>;
+    /**
+     * Resolves a builtin virtual file and writes it to the VFS if it does not already exist
+     *
+     * @param code - The source code of the builtin file
+     * @param id - The unique identifier of the builtin file
+     * @param path - An optional path to write the builtin file to
+     * @param options - Options for writing the file
+     */
+    writeBuiltin: (code: string, id: string, path?: string, options?: PowerlinesWriteFileOptions) => Promise<void>;
+    /**
+     * Resolves a entry virtual file and writes it to the VFS if it does not already exist
+     *
+     * @param code - The source code of the entry file
+     * @param path - An optional path to write the entry file to
+     * @param options - Options for writing the file
+     */
+    writeEntry: (code: string, path: string, options?: PowerlinesWriteFileOptions) => Promise<void>;
+    /**
+     * Parses the source code and returns a {@link ParseResult} object.
+     */
+    parse: (code: string, id: string, options?: ParserOptions | null) => Promise<ParseResult>;
+    /**
+     * A function to update the context fields using a new user configuration options
+     */
+    withUserConfig: (userConfig: UserConfig, options?: InitContextOptions) => Promise<void>;
+    /**
+     * A function to update the context fields using inline configuration options
+     */
+    withInlineConfig: (inlineConfig: InlineConfig, options?: InitContextOptions) => Promise<void>;
+    /**
+     * Create a new logger instance
+     *
+     * @param name - The name to use for the logger instance
+     * @returns A logger function
+     */
+    createLog: (name: string | null) => LogFn;
+    /**
+     * Extend the current logger instance with a new name
+     *
+     * @param name - The name to use for the extended logger instance
+     * @returns A logger function
+     */
+    extendLog: (name: string) => LogFn;
+}
+interface PluginContext<out TResolvedConfig extends ResolvedConfig = ResolvedConfig> extends Context<TResolvedConfig>, UnpluginContext {
+    /**
+     * The environment specific resolved configuration
+     */
+    environment: EnvironmentResolvedConfig;
+    /**
+     * An alternative property name for the {@link log} property
+     *
+     * @remarks
+     * This is provided for compatibility with other logging libraries that expect a `logger` property.
+     */
+    logger: LogFn;
+}
+type BuildPluginContext<TResolvedConfig extends ResolvedConfig = ResolvedConfig> = PluginContext<TResolvedConfig> & Omit<UnpluginBuildContext, "parse">;
+
+/**
+ * The base environment configuration used by Powerlines applications
+ *
+ * @remarks
+ * This interface is used to define the environment variables, configuration options, and runtime settings used by applications. It is used to provide type safety, autocompletion, and default values for the environment variables. The comments of each variable are used to provide documentation descriptions when running the \`powerlines docs\` command.
+ *
+ * @categoryDescription Platform
+ * The name of the platform the configuration parameter is intended for use in.
+ *
+ * @showCategories
+ */
+interface EnvInterface {
+    /**
+     * An indicator that specifies the application is running in the local development environment.
+     *
+     * @hidden
+     * @readonly
+     * @category node
+     */
+    readonly POWERLINES_LOCAL: boolean;
+    /**
+     * The name of the application.
+     *
+     * @readonly
+     * @category neutral
+     */
+    readonly APP_NAME: string;
+    /**
+     * The version of the application.
+     *
+     * @defaultValue "1.0.0"
+     *
+     * @readonly
+     * @category neutral
+     */
+    readonly APP_VERSION: string;
+    /**
+     * The unique identifier for the build.
+     *
+     * @readonly
+     * @category neutral
+     */
+    readonly BUILD_ID: string;
+    /**
+     * The timestamp the build was ran at.
+     *
+     * @readonly
+     * @category neutral
+     */
+    readonly BUILD_TIMESTAMP: string;
+    /**
+     * A checksum hash created during the build.
+     *
+     * @readonly
+     * @category neutral
+     */
+    readonly BUILD_CHECKSUM: string;
+    /**
+     * The unique identifier for the release.
+     *
+     * @readonly
+     * @category neutral
+     */
+    readonly RELEASE_ID: string;
+    /**
+     * The tag for the release. This is generally in the format of "\<APP_NAME\>\@\<APP_VERSION\>".
+     *
+     * @readonly
+     * @category neutral
+     */
+    readonly RELEASE_TAG: string;
+    /**
+     * The name of the organization that maintains the application.
+     *
+     * @remarks
+     * This variable is used to specify the name of the organization that maintains the application. If not provided in an environment, it will try to use the value in {@link @storm-software/config-tools/StormWorkspaceConfig#organization}.
+     *
+     * @alias ORG
+     * @alias ORG_ID
+     * @category neutral
+     */
+    ORGANIZATION: string;
+    /**
+     * The platform for which the application was built.
+     *
+     * @defaultValue "neutral"
+     *
+     * @category neutral
+     */
+    PLATFORM: "node" | "neutral" | "browser";
+    /**
+     * The mode in which the application is running.
+     *
+     * @defaultValue "production"
+     *
+     * @alias NODE_ENV
+     *
+     * @category neutral
+     */
+    MODE: "development" | "test" | "production";
+    /**
+     * The environment the application is running in. This value will be populated with the value of `MODE` if not provided.
+     *
+     * @defaultValue "production"
+     *
+     * @alias ENV
+     * @alias VERCEL_ENV
+     * @category neutral
+     */
+    ENVIRONMENT: string;
+    /**
+     * Indicates if the application is running in debug mode.
+     *
+     * @category neutral
+     */
+    DEBUG: boolean;
+    /**
+     * An indicator that specifies the current runtime is a test environment.
+     *
+     * @category neutral
+     */
+    TEST: boolean;
+    /**
+     * An indicator that specifies the current runtime is a minimal environment.
+     *
+     * @category node
+     */
+    MINIMAL: boolean;
+    /**
+     * An indicator that specifies the current runtime is a no color environment.
+     *
+     * @category node
+     */
+    NO_COLOR: boolean;
+    /**
+     * An indicator that specifies the current runtime is a force color environment.
+     *
+     * @category node
+     */
+    FORCE_COLOR: boolean | number;
+    /**
+     * An indicator that specifies the current runtime should force hyperlinks in terminal output.
+     *
+     * @remarks
+     * This variable is used to force hyperlinks in terminal output, even if the terminal does not support them. This is useful for debugging and development purposes.
+  
+     * @category node
+     */
+    FORCE_HYPERLINK: boolean | number;
+    /**
+     * The name of the agent running the application. This variable is set by certain CI/CD systems.
+     *
+     * @readonly
+     * @category neutral
+     */
+    readonly AGENT_NAME?: string;
+    /**
+     * The color terminal type. This variable is set by certain terminal emulators.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly COLORTERM?: string;
+    /**
+     * The terminal type. This variable is set by certain CI/CD systems.
+     *
+     * @remarks
+     * This variable is used to specify the terminal type that the application is running in. It can be used to determine how to format output for the terminal.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly TERM?: string;
+    /**
+     * The terminal program name. This variable is set by certain terminal emulators.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly TERM_PROGRAM?: string;
+    /**
+     * The terminal program version. This variable is set by certain terminal emulators.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly TERM_PROGRAM_VERSION?: string;
+    /**
+     * The terminal emulator name. This variable is set by certain terminal emulators.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly TERMINAL_EMULATOR?: string;
+    /**
+     * The terminal emulator session ID. This variable is set by certain terminal emulators.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly WT_SESSION?: string;
+    /**
+     * An indicator that specifies the current terminal is running Terminus Sublime. This variable is set by certain terminal emulators.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly TERMINUS_SUBLIME?: boolean;
+    /**
+     * The ConEmu task name. This variable is set by certain terminal emulators.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly ConEmuTask?: string;
+    /**
+     * The cursor trace ID. This variable is set by certain terminal emulators.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly CURSOR_TRACE_ID?: string;
+    /**
+     * The VTE version. This variable is set by certain terminal emulators.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly VTE_VERSION?: string;
+    /**
+     * Indicates if error stack traces should be captured.
+     *
+     * @category neutral
+     */
+    STACKTRACE: boolean;
+    /**
+     * Indicates if error data should be included.
+     *
+     * @category neutral
+     */
+    INCLUDE_ERROR_DATA: boolean;
+    /**
+     * A web page to lookup error messages and display additional information given an error code.
+     *
+     * @remarks
+     * This variable is used to provide a URL to a page that can be used to look up error messages given an error code. This is used to provide a more user-friendly error message to the user.
+     *
+     * @title Error Details URL
+     * @category neutral
+     */
+    ERROR_URL: string;
+    /**
+     * The default timezone for the application.
+     *
+     * @defaultValue "America/New_York"
+     * @category neutral
+     */
+    DEFAULT_TIMEZONE: string;
+    /**
+     * The default locale to be used in the application.
+     *
+     * @defaultValue "en_US"
+     * @category neutral
+     */
+    DEFAULT_LOCALE: string;
+    /**
+     * The default lowest log level to accept. If `null`, the logger will reject all records. This value only applies if `lowestLogLevel` is not provided to the `logs` configuration.
+     *
+     * @defaultValue "info"
+     *
+     * @category neutral
+     */
+    LOG_LEVEL?: LogLevel | null;
+    /**
+     * An indicator that specifies the current runtime is a continuous integration environment.
+     *
+     * @title Continuous Integration
+     * @alias CONTINUOUS_INTEGRATION
+     * @category neutral
+     */
+    CI: boolean;
+    /**
+     * The unique identifier for the current run. This value is set by certain CI/CD systems.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly RUN_ID?: string;
+    /**
+     * The agola git reference. This value is set by certain CI/CD systems.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly AGOLA_GIT_REF?: string;
+    /**
+     * The appcircle build ID. This value is set by certain CI/CD systems.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly AC_APPCIRCLE?: string;
+    /**
+     * The appveyor build ID. This value is set by certain CI/CD systems.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly APPVEYOR?: string;
+    /**
+     * The codebuild build ID. This value is set by certain CI/CD systems.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly CODEBUILD?: string;
+    /**
+     * The task force build ID. This value is set by certain CI/CD systems.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly TF_BUILD?: string;
+    /**
+     * The bamboo plan key. This value is set by certain CI/CD systems.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly bamboo_planKey?: string;
+    /**
+     * The bitbucket commit. This value is set by certain CI/CD systems.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly BITBUCKET_COMMIT?: string;
+    /**
+     * The bitrise build ID. This value is set by certain CI/CD systems.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly BITRISE_IO?: string;
+    /**
+     * The buddy workspace ID. This value is set by certain CI/CD systems.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly BUDDY_WORKSPACE_ID?: string;
+    /**
+     * The buildkite build ID. This value is set by certain CI/CD systems.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly BUILDKITE?: string;
+    /**
+     * The circleci build ID. This value is set by certain CI/CD systems.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly CIRCLECI?: string;
+    /**
+     * The cirrus-ci build ID. This value is set by certain CI/CD systems.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly CIRRUS_CI?: string;
+    /**
+     * The cf build ID. This value is set by certain CI/CD systems.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly CF_BUILD_ID?: string;
+    /**
+     * The cm build ID. This value is set by certain CI/CD systems.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly CM_BUILD_ID?: string;
+    /**
+     * The ci name. This value is set by certain CI/CD systems.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly CI_NAME?: string;
+    /**
+     * The drone build ID. This value is set by certain CI/CD systems.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly DRONE?: string;
+    /**
+     * The dsari build ID. This value is set by certain CI/CD systems.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly DSARI?: string;
+    /**
+     * The earthly build ID. This value is set by certain CI/CD systems.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly EARTHLY_CI?: string;
+    /**
+     * The eas build ID. This value is set by certain CI/CD systems.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly EAS_BUILD?: string;
+    /**
+     * The gerrit project. This value is set by certain CI/CD systems.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly GERRIT_PROJECT?: string;
+    /**
+     * The gitea actions build ID. This value is set by certain CI/CD systems.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly GITEA_ACTIONS?: string;
+    /**
+     * The github actions build ID. This value is set by certain CI/CD systems.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly GITHUB_ACTIONS?: string;
+    /**
+     * The gitlab ci build ID. This value is set by certain CI/CD systems.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly GITLAB_CI?: string;
+    /**
+     * The go cd build ID. This value is set by certain CI/CD systems.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly GOCD?: string;
+    /**
+     * The builder output build ID. This value is set by certain CI/CD systems.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly BUILDER_OUTPUT?: string;
+    /**
+     * The harness build ID. This value is set by certain CI/CD systems.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly HARNESS_BUILD_ID?: string;
+    /**
+     * The jenkins url. This value is set by certain CI/CD systems.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly JENKINS_URL?: string;
+    /**
+     * The layerci build ID. This value is set by certain CI/CD systems.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly LAYERCI?: string;
+    /**
+     * The magnum build ID. This value is set by certain CI/CD systems.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly MAGNUM?: string;
+    /**
+     * The netlify build ID. This value is set by certain CI/CD systems.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly NETLIFY?: string;
+    /**
+     * The nevercode build ID. This value is set by certain CI/CD systems.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly NEVERCODE?: string;
+    /**
+     * The prow job ID. This value is set by certain CI/CD systems.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly PROW_JOB_ID?: string;
+    /**
+     * The release build ID. This value is set by certain CI/CD systems.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly RELEASE_BUILD_ID?: string;
+    /**
+     * The render build ID. This value is set by certain CI/CD systems.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly RENDER?: string;
+    /**
+     * The sailci build ID. This value is set by certain CI/CD systems.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly SAILCI?: string;
+    /**
+     * The hudson build ID. This value is set by certain CI/CD systems.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly HUDSON?: string;
+    /**
+     * The screwdriver build ID. This value is set by certain CI/CD systems.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly SCREWDRIVER?: string;
+    /**
+     * The semaphore build ID. This value is set by certain CI/CD systems.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly SEMAPHORE?: string;
+    /**
+     * The sourcehut build ID. This value is set by certain CI/CD systems.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly SOURCEHUT?: string;
+    /**
+     * The spaceship build ID. This value is set by certain CI/CD systems.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly SPACESHIP_CI?: string;
+    /**
+     * The strider build ID. This value is set by certain CI/CD systems.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly STRIDER?: string;
+    /**
+     * The task ID. This value is set by certain CI/CD systems.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly TASK_ID?: string;
+    /**
+     * The teamcity version. This value is set by certain CI/CD systems.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly TEAMCITY_VERSION?: string;
+    /**
+     * The travis build ID. This value is set by certain CI/CD systems.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly TRAVIS?: string;
+    /**
+     * The vela build ID. This value is set by certain CI/CD systems.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly VELA?: string;
+    /**
+     * The now builder build ID. This value is set by certain CI/CD systems.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly NOW_BUILDER?: string;
+    /**
+     * The appcenter build ID. This value is set by certain CI/CD systems.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly APPCENTER_BUILD_ID?: string;
+    /**
+     * The xcode project build ID. This value is set by certain CI/CD systems.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly CI_XCODE_PROJECT?: string;
+    /**
+     * The xcode server build ID. This value is set by certain CI/CD systems.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly XCS?: string;
+    /**
+     * The application's runtime data directory.
+     *
+     * @remarks
+     * This variable is used to override the base path of the system's local application data directory. This variable is used to set the \`$storm.paths.data\` property.
+     *
+     * @title Data Directory
+     * @category node
+     */
+    DATA_DIR?: string;
+    /**
+     * The application's configuration data directory.
+     *
+     * @remarks
+     * This variable is used to override the base path of the system's local application configuration directory. This variable is used to set the \`$storm.paths.config\` property.
+     *
+     * @title Configuration Directory
+     * @category node
+     */
+    CONFIG_DIR?: string;
+    /**
+     * The application's cached data directory.
+     *
+     * @remarks
+     * This variable is used to override the base path of the system's local cache data directory. This variable is used to set the \`$storm.paths.cache\` property.
+     *
+     * @title Cache Directory
+     * @category node
+     */
+    CACHE_DIR?: string;
+    /**
+     * The application's logging directory.
+     *
+     * @remarks
+     * This variable is used to override the base path of the system's local application log directory. This variable is used to set the \`$storm.paths.log\` property.
+     *
+     * @title Log Directory
+     * @category node
+     */
+    LOG_DIR?: string;
+    /**
+     * The application's temporary data directory.
+     *
+     * @remarks
+     * This variable is used to override the base path of the system's local temporary data directory. This variable is used to set the \`$storm.paths.temp\` property.
+     *
+     * @title Temporary Directory
+     * @category node
+     */
+    TEMP_DIR?: string;
+    /**
+     * A variable that specifies the current user's local application data directory on Windows.
+     *
+     * @see https://www.advancedinstaller.com/appdata-localappdata-programdata.html
+     *
+     * @remarks
+     * This variable is used to specify a path to application data that is specific to the current user. This variable can be used to set the \`$storm.paths.data\`, \`$storm.paths.cache\`, and \`$storm.paths.log\` properties.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly LOCALAPPDATA?: string;
+    /**
+     * A variable that specifies the application data directory on Windows.
+     *
+     * @see https://www.advancedinstaller.com/appdata-localappdata-programdata.html
+     *
+     * @remarks
+     * This variable is used to specify a path to application data that is specific to the current user. This variable can be used to set the \`$storm.paths.config\` property.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly APPDATA?: string;
+    /**
+     * A variable that specifies the data path in the home directory on Linux systems using the XDG base directory specification.
+     *
+     * @see https://gist.github.com/roalcantara/107ba66dfa3b9d023ac9329e639bc58c
+     *
+     * @remarks
+     * This variable is used to specify a path to application data that is specific to the current user. This variable can be used to set the \`$storm.paths.data\` property.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly XDG_DATA_HOME?: string;
+    /**
+     * A variable that specifies the configuration path in the home directory on Linux systems using the XDG base directory specification.
+     *
+     * @see https://gist.github.com/roalcantara/107ba66dfa3b9d023ac9329e639bc58c
+     *
+     * @remarks
+     * This variable is used to specify a path to configuration data that is specific to the current user. This variable can be used to set the \`$storm.paths.config\` property.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly XDG_CONFIG_HOME?: string;
+    /**
+     * A variable that specifies the cache path in the home directory on Linux systems using the XDG base directory specification.
+     *
+     * @see https://gist.github.com/roalcantara/107ba66dfa3b9d023ac9329e639bc58c
+     *
+     * @remarks
+     * This variable is used to specify a path to cache data that is specific to the current user. This variable can be used to set the \`$storm.paths.cache\` property.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly XDG_CACHE_HOME?: string;
+    /**
+     * A variable that specifies the state directory on Linux systems using the XDG base directory specification.
+     *
+     * @see https://gist.github.com/roalcantara/107ba66dfa3b9d023ac9329e639bc58c
+     *
+     * @remarks
+     * This variable is used to specify a path to application state data that is specific to the current user. This variable can be used to set the \`$storm.paths.state\` property.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly XDG_STATE_HOME?: string;
+    /**
+     * A variable that specifies the runtime directory on Linux systems using the XDG base directory specification.
+     *
+     * @see https://gist.github.com/roalcantara/107ba66dfa3b9d023ac9329e639bc58c
+     *
+     * @remarks
+     * This variable is used to specify a path to runtime data that is specific to the current user. This variable can be used to set the \`$storm.paths.temp\` property.
+     *
+     * @readonly
+     * @category node
+     */
+    readonly XDG_RUNTIME_DIR?: string;
+    /**
+     * A variable that specifies the [Devenv](https://devenv.sh/) runtime directory.
+     *
+     * @see https://devenv.sh/files-and-variables/#devenv_dotfile
+     * @see https://nixos.org/
+     *
+     * @remarks
+     * This variable is used to specify a path to application data that is specific to the current [Nix](https://nixos.org/) environment. This variable can be used to set the \`$storm.paths.temp\` property.
+     *
+     * @category node
+     */
+    DEVENV_RUNTIME?: string;
+}
+/**
+ * The base secrets configuration used by Powerlines applications
+ *
+ * @remarks
+ * This interface is used to define the secret configuration options used by Powerlines applications. It is used to provide type safety, autocompletion, and default values for the environment variables. The comments of each variable are used to provide documentation descriptions when running the \`storm docs\` command. Since these are secrets, no default values should be provided and the values should be kept confidential (excluded from the client).
+ */
+interface SecretsInterface {
+    /**
+     * The secret key used for encryption and decryption.
+     *
+     * @remarks
+     * This variable is used to provide a secret key for encryption and decryption of sensitive data. It is important that this value is kept confidential and not exposed in client-side code or public repositories.
+     *
+     * @title Encryption Key
+     */
+    ENCRYPTION_KEY: string;
+}
+
+export type { BabelUserConfig as B, Context as C, DeclareBabelTransformPluginReturn as D, EnvInterface as E, PluginContext as P, ResolvedConfig as R, SecretsInterface as S, UserConfig as U, EnvironmentResolvedConfig as a, Plugin as b, BabelResolvedConfig as c };