powerlines 0.24.8 → 0.25.0

package/dist/lib/chunk-NIRFKQAD.js

@@ -0,0 +1,845 @@
+import { CACHE_HASH_LENGTH, PROJECT_ROOT_HASH_LENGTH, getPrefixedProjectRootHash } from './chunk-OEF6EHQV.js';
+import { VirtualFileSystem } from './chunk-OBA5U4Y2.js';
+import { createProgram } from './chunk-4W6WV35V.js';
+import { getTsconfigFilePath } from './chunk-ZGMEHSNN.js';
+import { loadWorkspaceConfig, loadUserConfigFile } from './chunk-XBM7FHNK.js';
+import { createLog, extendLog } from './chunk-ENRLU4UR.js';
+import { resolveEntriesSync, getUniqueEntries, replacePathTokens } from './chunk-N5YLKWC2.js';
+import { __name } from './chunk-SHUYVCID.js';
+import { LogLevelLabel } from '@storm-software/config-tools/types';
+import { toArray } from '@stryke/convert/to-array';
+import { getEnvPaths } from '@stryke/env/get-env-paths';
+import { existsSync } from '@stryke/fs/exists';
+import { relativeToWorkspaceRoot } from '@stryke/fs/get-workspace-root';
+import { readJsonFile } from '@stryke/fs/json';
+import { resolvePackage } from '@stryke/fs/resolve';
+import { hashDirectory } from '@stryke/hash/hash-files';
+import { murmurhash } from '@stryke/hash/murmurhash';
+import { getUnique } from '@stryke/helpers/get-unique';
+import { omit } from '@stryke/helpers/omit';
+import { StormJSON } from '@stryke/json/storm-json';
+import { appendPath } from '@stryke/path/append';
+import { isAbsolute } from '@stryke/path/is-type';
+import { joinPaths } from '@stryke/path/join';
+import { replacePath } from '@stryke/path/replace';
+import { titleCase } from '@stryke/string-format/title-case';
+import { isNull } from '@stryke/type-checks/is-null';
+import { isSetObject } from '@stryke/type-checks/is-set-object';
+import { isSetString } from '@stryke/type-checks/is-set-string';
+import { isString } from '@stryke/type-checks/is-string';
+import { uuid } from '@stryke/unique-id/uuid';
+import { tsconfigPathsToRegExp, match } from 'bundle-require';
+import defu2 from 'defu';
+import { joinPaths as joinPaths$1 } from '@stryke/path/join-paths';
+import { createJiti } from 'jiti';
+import { isFunction } from '@stryke/type-checks/is-function';
+import { isUndefined } from '@stryke/type-checks/is-undefined';
+
+function resolveOptions(options) {
+  return defu2(options, {
+    interopDefault: true,
+    fsCache: options.mode !== "development" ? joinPaths$1(options.cacheDir, "jiti") : false,
+    moduleCache: options.mode !== "development"
+  });
+}
+__name(resolveOptions, "resolveOptions");
+function createPluginResolver(options) {
+  return createJiti(joinPaths$1(options.workspaceRoot, options.projectRoot), resolveOptions({
+    ...options
+  }));
+}
+__name(createPluginResolver, "createPluginResolver");
+function createResolver(options) {
+  const baseResolver = createJiti(joinPaths$1(options.workspaceRoot, options.projectRoot), resolveOptions(options));
+  baseResolver.plugin = createPluginResolver(options);
+  return baseResolver;
+}
+__name(createResolver, "createResolver");
+
+// src/types/commands.ts
+var SUPPORTED_COMMANDS = [
+  "new",
+  "clean",
+  "prepare",
+  "lint",
+  "test",
+  "build",
+  "docs",
+  "deploy",
+  "finalize"
+];
+
+// src/plugin-utils/helpers.ts
+function isPlugin(value) {
+  return isSetObject(value) && "name" in value && isSetString(value.name) && (isUndefined(value.applyToEnvironment) || "applyToEnvironment" in value && isFunction(value.applyToEnvironment)) && (isUndefined(value.dedupe) || "dedupe" in value && isFunction(value.dedupe)) && (isUndefined(value.dependsOn) || "dependsOn" in value && Array.isArray(value.dependsOn) && value.dependsOn.every(isPluginConfig)) && SUPPORTED_COMMANDS.every((command) => isUndefined(value[command]) || command in value && (isFunction(value[command]) || isSetObject(value[command]) && "handler" in value[command] && isFunction(value[command].handler)));
+}
+__name(isPlugin, "isPlugin");
+function isPluginConfigObject(value) {
+  return isSetObject(value) && "plugin" in value && ((isSetString(value.plugin) || isFunction(value.plugin)) && "options" in value && isSetObject(value.options) || isPlugin(value.plugin));
+}
+__name(isPluginConfigObject, "isPluginConfigObject");
+function isPluginConfigTuple(value) {
+  return Array.isArray(value) && (value.length === 1 || value.length === 2) && ((isSetString(value[0]) || isFunction(value[0])) && value.length > 1 && isSetObject(value[1]) || isPlugin(value[0]));
+}
+__name(isPluginConfigTuple, "isPluginConfigTuple");
+function isPluginConfig(value) {
+  return isSetString(value) || isFunction(value) || isPlugin(value) || isPluginConfigObject(value) || isPluginConfigTuple(value);
+}
+__name(isPluginConfig, "isPluginConfig");
+function isPluginHookFunction(value) {
+  return isFunction(value) || isSetObject(value) && "handler" in value && isFunction(value.handler);
+}
+__name(isPluginHookFunction, "isPluginHookFunction");
+function isPluginHookObject(value) {
+  return isSetObject(value) && "handler" in value && isFunction(value.handler);
+}
+__name(isPluginHookObject, "isPluginHookObject");
+function isPluginHook(value) {
+  return isPluginHookFunction(value) || isPluginHookObject(value);
+}
+__name(isPluginHook, "isPluginHook");
+function getHookHandler(pluginHook) {
+  return isFunction(pluginHook) ? pluginHook : pluginHook.handler;
+}
+__name(getHookHandler, "getHookHandler");
+function isHookExternal(hook) {
+  return hook.startsWith("vite:") || hook.startsWith("esbuild:") || hook.startsWith("rolldown:") || hook.startsWith("rollup:") || hook.startsWith("webpack:") || hook.startsWith("rspack:") || hook.startsWith("farm:");
+}
+__name(isHookExternal, "isHookExternal");
+function checkDedupe(plugin, plugins) {
+  return plugin.dedupe === false || plugins.some((p) => p.dedupe !== false && (isFunction(p.dedupe) && p.dedupe(plugin) || p.name === plugin.name));
+}
+__name(checkDedupe, "checkDedupe");
+function addPluginHook(context, plugin, pluginHook, hooksList) {
+  if (!checkDedupe(plugin, hooksList.map((hook) => hook.plugin))) {
+    hooksList.push(isFunction(pluginHook) ? {
+      plugin,
+      handler: getHookHandler(pluginHook).bind(context)
+    } : {
+      plugin,
+      ...pluginHook,
+      handler: getHookHandler(pluginHook).bind(context)
+    });
+  }
+}
+__name(addPluginHook, "addPluginHook");
+
+// src/lib/contexts/context.ts
+var configCache = /* @__PURE__ */ new WeakMap();
+var PowerlinesContext = class _PowerlinesContext {
+  static {
+    __name(this, "PowerlinesContext");
+  }
+  /**
+  * Internal reference to the API instance
+  *
+  * @internal
+  */
+  #api;
+  #workspaceConfig;
+  #checksum = null;
+  #buildId = uuid();
+  #releaseId = uuid();
+  #timestamp = Date.now();
+  #envPaths;
+  #fs;
+  #tsconfig;
+  #program;
+  #resolvePatterns = [];
+  #getConfigProps(config = {}) {
+    return {
+      variant: config.build?.variant,
+      projectType: config.type,
+      projectRoot: config.root,
+      name: config.name,
+      title: config.title,
+      description: config.description,
+      sourceRoot: config.sourceRoot,
+      configFile: config.configFile,
+      customLogger: config.customLogger,
+      logLevel: config.logLevel,
+      tsconfig: config.tsconfig,
+      tsconfigRaw: config.tsconfigRaw,
+      skipCache: config.skipCache,
+      skipInstalls: config.skipInstalls,
+      entry: config.entry,
+      output: config.output,
+      plugins: config.plugins,
+      mode: config.mode,
+      lint: config.lint,
+      transform: config.transform,
+      build: config.build,
+      framework: config.framework
+    };
+  }
+  /**
+  * Create a new Storm context from the workspace root and user config.
+  *
+  * @param workspaceRoot - The root directory of the workspace.
+  * @param config - The user configuration options.
+  * @returns A promise that resolves to the new context.
+  */
+  static async from(workspaceRoot, config) {
+    const context = new _PowerlinesContext(await loadWorkspaceConfig(workspaceRoot, config.root));
+    await context.withUserConfig(config);
+    context.powerlinesPath = await resolvePackage("powerlines");
+    if (!context.powerlinesPath) {
+      throw new Error("Could not resolve `powerlines` package location.");
+    }
+    return context;
+  }
+  /**
+  * An object containing the dependencies that should be installed for the project
+  */
+  dependencies = {};
+  /**
+  * An object containing the development dependencies that should be installed for the project
+  */
+  devDependencies = {};
+  /**
+  * The persisted meta information about the current build
+  */
+  persistedMeta = void 0;
+  /**
+  * The path to the Powerlines package
+  */
+  powerlinesPath;
+  /**
+  * The parsed `package.json` file for the project
+  */
+  packageJson;
+  /**
+  * The parsed `project.json` file for the project
+  */
+  projectJson = void 0;
+  /**
+  * The module resolver for the project
+  */
+  resolver;
+  /**
+  * Internal context fields and methods
+  *
+  * @internal
+  */
+  get $$internal() {
+    return {
+      api: this.#api
+    };
+  }
+  /**
+  * The resolved entry type definitions for the project
+  */
+  get entry() {
+    return resolveEntriesSync(this, toArray(this.config.entry));
+  }
+  /**
+  * The TypeScript configuration parsed from the tsconfig file
+  */
+  get tsconfig() {
+    if (!this.#tsconfig) {
+      this.tsconfig = {
+        tsconfigFilePath: this.config.tsconfig
+      };
+    }
+    return this.#tsconfig;
+  }
+  /**
+  * Sets the TypeScript configuration parsed from the tsconfig file
+  */
+  set tsconfig(value) {
+    this.#tsconfig = value;
+    this.#resolvePatterns = tsconfigPathsToRegExp(value?.options?.paths ?? {});
+  }
+  /**
+  * The virtual file system interface for the project
+  */
+  get fs() {
+    if (!this.#fs) {
+      this.#fs = VirtualFileSystem.createSync(this);
+    }
+    return this.#fs;
+  }
+  /**
+  * Get the checksum of the project's current state
+  */
+  get checksum() {
+    return this.#checksum;
+  }
+  /**
+  * The meta information about the current build
+  */
+  get meta() {
+    return {
+      buildId: this.#buildId,
+      releaseId: this.#releaseId,
+      checksum: this.#checksum,
+      timestamp: this.#timestamp,
+      projectRootHash: murmurhash({
+        workspaceRoot: this.workspaceConfig?.workspaceRoot,
+        projectRoot: this.config?.projectRoot
+      }, {
+        maxLength: PROJECT_ROOT_HASH_LENGTH
+      }),
+      configHash: murmurhash(this.config, {
+        maxLength: CACHE_HASH_LENGTH
+      })
+    };
+  }
+  /**
+  * The resolved configuration options
+  */
+  get config() {
+    return this.resolvedConfig ?? {};
+  }
+  /**
+  * The logger function
+  */
+  get log() {
+    if (!this.logFn) {
+      this.logFn = this.createLog();
+    }
+    return this.logFn;
+  }
+  /**
+  * The workspace configuration
+  */
+  get workspaceConfig() {
+    return this.#workspaceConfig;
+  }
+  /**
+  * The environment paths for the project
+  */
+  get envPaths() {
+    if (!this.#envPaths) {
+      this.#envPaths = getEnvPaths({
+        orgId: "storm-software",
+        appId: "powerlines",
+        workspaceRoot: this.workspaceConfig.workspaceRoot
+      });
+    }
+    return this.#envPaths;
+  }
+  /**
+  * Get the path to the artifacts directory for the project
+  */
+  get artifactsPath() {
+    return joinPaths(this.workspaceConfig.workspaceRoot, this.config.projectRoot, this.config.output.artifactsPath);
+  }
+  /**
+  * Get the path to the builtin modules used by the project
+  */
+  get builtinsPath() {
+    return joinPaths(this.artifactsPath, "builtins");
+  }
+  /**
+  * Get the path to the entry directory for the project
+  */
+  get entryPath() {
+    return joinPaths(this.artifactsPath, "entry");
+  }
+  /**
+  * Get the path to the data directory for the project
+  */
+  get dataPath() {
+    return joinPaths(this.envPaths.data, "projects", getPrefixedProjectRootHash(this.config.name, this.meta.projectRootHash));
+  }
+  /**
+  * Get the path to the cache directory for the project
+  */
+  get cachePath() {
+    return joinPaths(this.envPaths.cache, "projects", murmurhash({
+      checksum: this.#checksum,
+      config: this.meta.configHash
+    }, {
+      maxLength: CACHE_HASH_LENGTH
+    }));
+  }
+  /**
+  * Get the path to the generated declaration file for the project
+  */
+  get dtsPath() {
+    return this.config.output.dts ? appendPath(this.config.output.dts, this.workspaceConfig.workspaceRoot) : joinPaths(this.workspaceConfig.workspaceRoot, this.config.projectRoot, "powerlines.d.ts");
+  }
+  /**
+  * Get the project root relative to the workspace root
+  */
+  get relativeToWorkspaceRoot() {
+    return relativeToWorkspaceRoot(this.config.projectRoot);
+  }
+  /**
+  * The builtin module id that exist in the Powerlines virtual file system
+  */
+  get builtins() {
+    return Object.values(this.fs.metadata).filter((meta) => meta && meta.type === "builtin").map((meta) => meta?.id).filter(Boolean);
+  }
+  /**
+  * The {@link Project} instance used for type reflection and module manipulation
+  *
+  * @see https://ts-morph.com/
+  *
+  * @remarks
+  * This instance is created lazily on first access.
+  */
+  get program() {
+    if (!this.#program) {
+      this.#program = createProgram(this, {
+        skipAddingFilesFromTsConfig: true
+      });
+    }
+    return this.#program;
+  }
+  /**
+  * A helper function to resolve modules in the Virtual File System
+  *
+  * @remarks
+  * This function can be used to resolve modules relative to the project root directory.
+  *
+  * @example
+  * ```ts
+  * const resolved = await context.resolve("some-module", "/path/to/importer");
+  * ```
+  *
+  * @param id - The module to resolve.
+  * @param importer - An optional path to the importer module.
+  * @param options - Additional resolution options.
+  * @returns A promise that resolves to the resolved module path.
+  */
+  async resolveId(id, importer, options = {}) {
+    if (this.fs.isVirtual(id)) {
+      const result = await this.fs.resolve(id, importer, options);
+      if (!result) {
+        return void 0;
+      }
+      return {
+        id: `\0${result}`,
+        external: this.config.projectType !== "application"
+      };
+    }
+    if (this.config.build.skipNodeModulesBundle) {
+      if (match(id, this.#resolvePatterns) || match(id, this.config.build.noExternal)) {
+        return void 0;
+      }
+      if (match(id, this.config.build.external) || id.startsWith("node:")) {
+        return {
+          id,
+          external: true
+        };
+      }
+      if (!/^[A-Z]:[/\\]|^\.{0,2}\/|^\.{1,2}$/.test(id)) {
+        return {
+          id,
+          external: true
+        };
+      }
+    } else {
+      if (match(id, this.config.build.noExternal)) {
+        return void 0;
+      }
+      if (match(id, this.config.build.external) || id.startsWith("node:")) {
+        return {
+          id,
+          external: true
+        };
+      }
+    }
+    return void 0;
+  }
+  /**
+  * A helper function to load modules from the Virtual File System
+  *
+  * @remarks
+  * This function can be used to load modules relative to the project root directory.
+  *
+  * @example
+  * ```ts
+  * const module = await context.load("some-module", "/path/to/importer");
+  * ```
+  *
+  * @param id - The module to load.
+  * @returns A promise that resolves to the loaded module.
+  */
+  async load(id) {
+    const resolvedId = await this.fs.resolve(id);
+    if (!resolvedId) {
+      return void 0;
+    }
+    const code = await this.fs.read(resolvedId);
+    if (!code) {
+      return void 0;
+    }
+    return {
+      code,
+      map: null
+    };
+  }
+  /**
+  * Get the builtin virtual files that exist in the Powerlines virtual file system
+  */
+  async getBuiltins() {
+    return Promise.all(Object.entries(this.fs.metadata).filter(([, meta]) => meta && meta.type === "builtin").map(async ([path, meta]) => {
+      const code = await this.fs.read(path);
+      return {
+        ...meta,
+        path,
+        code
+      };
+    }));
+  }
+  /**
+  * 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 - A path to write the entry file to
+  * @param options - Optional write file options
+  */
+  async emitEntry(code, path, options = {}) {
+    return this.fs.write(isAbsolute(path) ? path : appendPath(path, this.entryPath), code, defu2(options, {
+      type: "entry"
+    }));
+  }
+  /**
+  * 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 - Optional write file options
+  */
+  async emitBuiltin(code, id, path, options = {}) {
+    return this.fs.write(path ? isAbsolute(path) ? path : joinPaths(this.builtinsPath, path) : appendPath(id, this.builtinsPath), code, defu2(options, {
+      type: "builtin"
+    }));
+  }
+  /**
+  * Update the context using a new user configuration options
+  *
+  * @param userConfig - The new user configuration options.
+  */
+  async withUserConfig(userConfig, options = {
+    isHighPriority: true
+  }) {
+    this.mergeUserConfig(userConfig);
+    await this.init(this.config.userConfig, options);
+  }
+  /**
+  * Update the context using a new inline configuration options
+  *
+  * @param inlineConfig - The new inline configuration options.
+  */
+  async withInlineConfig(inlineConfig, options = {
+    isHighPriority: true
+  }) {
+    this.config.inlineConfig = inlineConfig;
+    if (inlineConfig.command === "new") {
+      const workspacePackageJsonPath = joinPaths(this.workspaceConfig.workspaceRoot, "package.json");
+      if (!existsSync(workspacePackageJsonPath)) {
+        throw new Error(`The workspace package.json file could not be found at ${workspacePackageJsonPath}`);
+      }
+      this.packageJson = await readJsonFile(workspacePackageJsonPath);
+      this.workspaceConfig.repository ??= isSetString(this.packageJson?.repository) ? this.packageJson.repository : this.packageJson?.repository?.url;
+    }
+    await this.init(this.config.inlineConfig, options);
+  }
+  /**
+  * A logging function for fatal messages
+  *
+  * @param message - The message to log.
+  */
+  fatal(message) {
+    this.log(LogLevelLabel.FATAL, isString(message) ? message : StormJSON.stringify(message));
+  }
+  /**
+  * A logging function for error messages
+  *
+  * @param message - The message to log.
+  */
+  error(message) {
+    this.log(LogLevelLabel.ERROR, isString(message) ? message : StormJSON.stringify(message));
+  }
+  /**
+  * A logging function for warning messages
+  *
+  * @param message - The message to log.
+  */
+  warn(message) {
+    this.log(LogLevelLabel.WARN, isString(message) ? message : StormJSON.stringify(message));
+  }
+  /**
+  * A logging function for informational messages
+  *
+  * @param message - The message to log.
+  */
+  info(message) {
+    this.log(LogLevelLabel.INFO, isString(message) ? message : StormJSON.stringify(message));
+  }
+  /**
+  * A logging function for debug messages
+  *
+  * @param message - The message to log.
+  */
+  debug(message) {
+    this.log(LogLevelLabel.DEBUG, isString(message) ? message : StormJSON.stringify(message));
+  }
+  /**
+  * A logging function for trace messages
+  *
+  * @param message - The message to log.
+  */
+  trace(message) {
+    this.log(LogLevelLabel.TRACE, isString(message) ? message : StormJSON.stringify(message));
+  }
+  /**
+  * Create a new logger instance
+  *
+  * @param name - The name to use for the logger instance
+  * @returns A logger function
+  */
+  createLog(name = null) {
+    return createLog(name, {
+      ...this.config,
+      logLevel: isNull(this.config.logLevel) ? "silent" : this.config.logLevel
+    });
+  }
+  /**
+  * 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) {
+    return extendLog(this.log, name);
+  }
+  /**
+  * Creates a new StormContext instance.
+  *
+  * @param workspaceConfig - The workspace configuration.
+  */
+  constructor(workspaceConfig) {
+    this.#workspaceConfig = workspaceConfig;
+    this.#envPaths = getEnvPaths({
+      orgId: "storm-software",
+      appId: "powerlines",
+      workspaceRoot: workspaceConfig.workspaceRoot
+    });
+  }
+  /**
+  * The resolved configuration for this context
+  */
+  resolvedConfig = {};
+  /**
+  * A logger function specific to this context
+  */
+  logFn;
+  /**
+  * Generates a checksum representing the current context state
+  *
+  * @param root - The root directory of the project to generate the checksum for
+  * @returns A promise that resolves to a string representing the checksum
+  */
+  async generateChecksum(root = this.config.projectRoot) {
+    this.#checksum = await hashDirectory(root, {
+      ignore: [
+        "node_modules",
+        ".git",
+        ".nx",
+        ".cache",
+        ".storm",
+        "tmp",
+        "dist"
+      ]
+    });
+    return this.#checksum;
+  }
+  /**
+  * Initialize the context with the provided configuration options
+  *
+  * @param config - The partial user configuration to use for initialization.
+  */
+  async init(config = {}, options = {
+    isHighPriority: true
+  }) {
+    const cacheKey = {
+      projectRoot: config.root ?? this.config.projectRoot ?? this.config.userConfig?.root ?? this.config.inlineConfig?.root,
+      mode: (config.mode ?? this.config.mode) || this.workspaceConfig.mode,
+      skipCache: config.skipCache ?? this.config.skipCache ?? false,
+      configFile: config.configFile ?? this.config.configFile,
+      framework: config.framework ?? this.config.framework ?? "powerlines",
+      command: this.config.inlineConfig?.command
+    };
+    if (configCache.has(cacheKey)) {
+      const result = configCache.get(cacheKey);
+      this.projectJson = result.projectJson;
+      this.packageJson = result.packageJson;
+      this.#checksum = result.checksum;
+      this.resolver = result.resolver;
+      this.mergeUserConfig(result.userConfig.config, this.config.userConfig);
+    } else {
+      const projectJsonPath = joinPaths(cacheKey.projectRoot, "project.json");
+      if (existsSync(projectJsonPath)) {
+        this.projectJson = await readJsonFile(projectJsonPath);
+      }
+      const packageJsonPath = joinPaths(cacheKey.projectRoot, "package.json");
+      if (existsSync(packageJsonPath)) {
+        this.packageJson = await readJsonFile(packageJsonPath);
+      }
+      this.#checksum = await this.generateChecksum(cacheKey.projectRoot);
+      this.resolver = createResolver({
+        workspaceRoot: this.workspaceConfig.workspaceRoot,
+        projectRoot: cacheKey.projectRoot,
+        cacheDir: this.cachePath,
+        mode: cacheKey.mode,
+        logLevel: config.logLevel || this.config?.logLevel || this.workspaceConfig.logLevel || "info",
+        skipCache: cacheKey.skipCache
+      });
+      const userConfig = await loadUserConfigFile(cacheKey.projectRoot, this.workspaceConfig.workspaceRoot, this.resolver, cacheKey.command, cacheKey.mode, cacheKey.configFile, cacheKey.framework);
+      this.mergeUserConfig(userConfig.config);
+      configCache.set(cacheKey, {
+        projectJson: this.projectJson,
+        packageJson: this.packageJson,
+        checksum: this.#checksum,
+        resolver: this.resolver,
+        userConfig
+      });
+    }
+    config.tsconfig ??= getTsconfigFilePath(this.workspaceConfig.workspaceRoot, cacheKey.projectRoot, config.tsconfig);
+    if (isSetObject(config)) {
+      this.resolvedConfig = defu2({
+        inlineConfig: this.config.inlineConfig,
+        userConfig: this.config.userConfig
+      }, options.isHighPriority ? this.#getConfigProps(config) : {}, {
+        command: this.config.inlineConfig?.command,
+        ...this.#getConfigProps(this.config.inlineConfig)
+      }, this.#getConfigProps(this.config.userConfig), {
+        mode: this.workspaceConfig?.mode,
+        logLevel: this.workspaceConfig?.logLevel,
+        skipCache: this.workspaceConfig?.skipCache
+      }, {
+        name: this.projectJson?.name || this.packageJson?.name,
+        version: this.packageJson?.version,
+        description: this.packageJson?.description,
+        sourceRoot: this.projectJson?.sourceRoot || appendPath("src", cacheKey.projectRoot),
+        output: defu2(config.output ?? {}, {
+          outputPath: cacheKey.projectRoot ? joinPaths(this.workspaceConfig?.directories?.build || "dist", cacheKey.projectRoot) : this.workspaceConfig?.directories?.build || "dist",
+          artifactsPath: joinPaths(cacheKey.projectRoot, `.${config.framework ?? "powerlines"}`),
+          dts: joinPaths(cacheKey.projectRoot, `${config.framework ?? "powerlines"}.d.ts`),
+          builtinPrefix: config.framework ?? "powerlines",
+          assets: [
+            {
+              glob: "LICENSE"
+            },
+            {
+              input: cacheKey.projectRoot,
+              glob: "*.md"
+            },
+            {
+              input: cacheKey.projectRoot,
+              glob: "package.json"
+            }
+          ]
+        })
+      }, options.isHighPriority ? {} : this.#getConfigProps(config), {
+        inlineConfig: {},
+        userConfig: {},
+        framework: "powerlines",
+        platform: "neutral",
+        mode: "production",
+        projectType: "application",
+        logLevel: "info",
+        preview: false,
+        environments: {},
+        transform: {
+          babel: {
+            plugins: [],
+            presets: []
+          }
+        },
+        lint: {
+          eslint: {}
+        },
+        build: {
+          target: "esnext",
+          override: {}
+        }
+      });
+    }
+    this.config.entry = getUniqueEntries(this.config.entry);
+    if (this.config.name?.startsWith("@") && this.config.name.split("/").filter(Boolean).length > 1) {
+      this.config.name = this.config.name.split("/").filter(Boolean)[1];
+    }
+    this.config.title ??= titleCase(this.config.name);
+    if (this.config.build.external) {
+      this.config.build.external = getUnique(this.config.build.external);
+    }
+    if (this.config.build.noExternal) {
+      this.config.build.noExternal = getUnique(this.config.build.noExternal);
+    }
+    this.config.output.format = getUnique(toArray(this.config.output?.format ?? (this.config.projectType === "library" ? [
+      "cjs",
+      "esm"
+    ] : [
+      "esm"
+    ])));
+    if (this.config.projectRoot && this.config.projectRoot !== "." && this.config.projectRoot !== "./" && this.config.projectRoot !== this.workspaceConfig.workspaceRoot) {
+      this.config.output.outputPath ??= joinPaths("dist", this.config.projectRoot);
+      this.config.output.buildPath ??= joinPaths(this.config.projectRoot, "dist");
+    } else {
+      this.config.output.outputPath ??= "dist";
+      this.config.output.buildPath ??= "dist";
+    }
+    this.config.output.assets = getUnique(this.config.output.assets.map((asset) => {
+      return {
+        glob: isSetObject(asset) ? asset.glob : asset,
+        input: isString(asset) || !asset.input || asset.input === "." || asset.input === "/" || asset.input === "./" ? this.workspaceConfig.workspaceRoot : appendPath(asset.input, this.workspaceConfig.workspaceRoot),
+        output: appendPath(isSetObject(asset) && asset.output ? joinPaths(this.config.output.outputPath, replacePath(asset.output, this.config.output.outputPath)) : this.config.output.outputPath, this.workspaceConfig.workspaceRoot),
+        ignore: isSetObject(asset) && asset.ignore ? toArray(asset.ignore) : void 0
+      };
+    }));
+    this.config.plugins = (this.config.plugins ?? []).filter(Boolean).reduce((ret, plugin) => {
+      if (isPlugin(plugin) && checkDedupe(plugin, ret.filter((p) => isPlugin(p)))) {
+        return ret;
+      }
+      ret.push(plugin);
+      return ret;
+    }, []);
+    if (this.config.tsconfig) {
+      this.config.tsconfig = replacePathTokens(this, this.config.tsconfig);
+    }
+    if (this.config.output.dts) {
+      this.config.output.dts = replacePathTokens(this, this.config.output.dts);
+    }
+    if (this.config.build.polyfill) {
+      this.config.build.polyfill = this.config.build.polyfill.map((polyfill) => replacePathTokens(this, polyfill));
+    }
+    if (this.config.output.assets) {
+      this.config.output.assets = this.config.output.assets.map((asset) => ({
+        ...asset,
+        glob: replacePathTokens(this, asset.glob),
+        ignore: asset.ignore ? asset.ignore.map((ignore) => replacePathTokens(this, ignore)) : void 0,
+        input: replacePathTokens(this, asset.input),
+        output: replacePathTokens(this, asset.output)
+      }));
+    }
+    this.#fs ??= await VirtualFileSystem.create(this);
+  }
+  mergeUserConfig(from = {}, into = this.config.userConfig ?? {}) {
+    this.config.userConfig = defu2({
+      entry: Array.isArray(from.entry) && from.entry.length > 0 ? from.entry : Array.isArray(into?.entry) && into.entry.length > 0 ? into.entry : []
+    }, omit(from ?? {}, [
+      "entry"
+    ]), omit(into ?? {}, [
+      "entry"
+    ]));
+    if (this.config.userConfig.output?.format) {
+      this.config.userConfig.output.format = getUnique(toArray(this.config.userConfig.output?.format));
+    }
+    this.config.userConfig.plugins = (this.config.userConfig.plugins ?? []).filter(Boolean).reduce((ret, plugin) => {
+      if (isPlugin(plugin) && checkDedupe(plugin, ret.filter((p) => isPlugin(p)))) {
+        return ret;
+      }
+      ret.push(plugin);
+      return ret;
+    }, []);
+  }
+};
+
+export { PowerlinesContext, addPluginHook, checkDedupe, getHookHandler, isHookExternal, isPlugin, isPluginConfig, isPluginConfigObject, isPluginConfigTuple, isPluginHook };