powerlines 0.20.0 → 0.21.0

package/dist/lib/{chunk-OTBLE55Z.cjs → chunk-MPCVQK2D.cjs}

@@ -11,7 +11,17 @@ var append = require('@stryke/path/append');
 var joinPaths = require('@stryke/path/join-paths');
 var replace = require('@stryke/path/replace');
 var isSetString = require('@stryke/type-checks/is-set-string');
+var isString = require('@stryke/type-checks/is-string');
 
+function replacePathTokens(context, path) {
+  if (!path) {
+    return path;
+  }
+  return path.replaceAll("{workspaceRoot}", context.workspaceConfig.workspaceRoot).replaceAll("{root}", context.config.projectRoot).replaceAll("{projectRoot}", context.config.projectRoot).replaceAll("{powerlinesPath}", context.powerlinesPath).replaceAll("{cachePath}", context.cachePath).replaceAll("{dataPath}", context.dataPath).replaceAll("{logPath}", context.envPaths.log).replaceAll("{tempPath}", context.envPaths.temp).replaceAll("{configPath}", context.envPaths.config).replaceAll("{artifactsPath}", replace.replacePath(context.artifactsPath, context.workspaceConfig.workspaceRoot)).replaceAll("{builtinPath}", replace.replacePath(context.builtinsPath, context.workspaceConfig.workspaceRoot)).replaceAll("{entryPath}", replace.replacePath(context.entryPath, context.workspaceConfig.workspaceRoot));
+}
+chunkUSNT2KNT_cjs.__name(replacePathTokens, "replacePathTokens");
+
+// src/lib/entry.ts
 function resolveEntryInputFile(context, typeDefinition) {
   return replace.replacePath(typeDefinition.file, joinPaths.joinPaths(context.workspaceConfig.workspaceRoot, context.config.projectRoot));
 }
@@ -54,7 +64,7 @@ async function resolveEntries(context, typeDefinitions) {
 }
 chunkUSNT2KNT_cjs.__name(resolveEntries, "resolveEntries");
 function resolveEntriesSync(context, typeDefinitions) {
-  return typeDefinitions.map((typeDefinition) => {
+  return typeDefinitions.map((entry) => isString.isString(entry) ? replacePathTokens(context, entry) : replacePathTokens(context, entry.file)).map((typeDefinition) => {
     const parsed = parseTypeDefinition.parseTypeDefinition(typeDefinition);
     const filePath = append.appendPath(parsed.file, context.config.projectRoot);
     if (isFile.isFile(filePath)) {
@@ -98,6 +108,7 @@ function getUniqueEntries(entries = []) {
 chunkUSNT2KNT_cjs.__name(getUniqueEntries, "getUniqueEntries");
 
 exports.getUniqueEntries = getUniqueEntries;
+exports.replacePathTokens = replacePathTokens;
 exports.resolveEntries = resolveEntries;
 exports.resolveEntriesSync = resolveEntriesSync;
 exports.resolveEntry = resolveEntry;

package/dist/lib/{chunk-4RUHX7LV.js → chunk-QAXCBFBP.js}

@@ -1,4 +1,4 @@
-import { bundle } from './chunk-S5F4DE65.js';
+import { bundle } from './chunk-5SADLYYK.js';
 import { __name } from './chunk-SHUYVCID.js';
 import { parseTypeDefinition } from '@stryke/convert/parse-type-definition';
 import { isSetString } from '@stryke/type-checks/is-set-string';

package/dist/lib/{chunk-WWNNBLU7.js → chunk-T7RMV2FW.js}

@@ -1,4 +1,4 @@
-import { extractESBuildConfig } from './chunk-ZJNDT3GX.js';
+import { extractESBuildConfig } from './chunk-3G4C3YAU.js';
 import { __name } from './chunk-SHUYVCID.js';
 import { joinPaths } from '@stryke/path/join-paths';
 import defu from 'defu';
@@ -25,12 +25,25 @@ function extractViteConfig(context) {
   return defu({
     resolve: {
       alias: context.builtins.reduce((ret, id) => {
-        const path = context.fs.ids[id];
-        if (path) {
-          ret[id] = path;
+        if (!ret.find((e) => e.find === id)) {
+          const path = context.fs.ids[id];
+          if (path) {
+            ret.push({
+              find: id,
+              replacement: path
+            });
+          }
         }
         return ret;
-      }, {}),
+      }, context.config.build.alias ? Array.isArray(context.config.build.alias) ? context.config.build.alias : Object.entries(context.config.build.alias).reduce((ret, [id, path]) => {
+        if (!ret.find((e) => e.find === id)) {
+          ret.push({
+            find: id,
+            replacement: path
+          });
+        }
+        return ret;
+      }, []) : []),
       dedupe: context.config.build.dedupe,
       mainFields: context.config.build.mainFields,
       conditions: context.config.build.conditions,

package/dist/lib/{chunk-7K7JH3DF.cjs → chunk-ULJVBW4L.cjs}

@@ -1,6 +1,7 @@
 'use strict';
 
 var chunkUSNT2KNT_cjs = require('./chunk-USNT2KNT.cjs');
+var join = require('@stryke/path/join');
 var bundleRequire = require('bundle-require');
 
 var NON_NODE_MODULE_REGEX = /^[A-Z]:[/\\]|^\.{0,2}\/|^\.{1,2}$/;
@@ -23,9 +24,23 @@ async function handleResolveId(context, args, options = {}) {
         };
       }
     }
-    if (context.fs.isTsconfigPath(args.id)) {
-      const tsconfigPath = context.fs.resolveTsconfigPath(args.id);
-      const tsconfigPathPackage = context.fs.resolveTsconfigPathPackage(args.id);
+    if (!!context.tsconfig.options.paths && Object.keys(context.tsconfig.options.paths).some((path) => args.id.startsWith(path.replaceAll("*", "")))) {
+      let tsconfigPath = false;
+      if (context.tsconfig.options.paths) {
+        for (const tsconfigPathKey of Object.keys(context.tsconfig.options.paths).filter((tsconfigPath2) => args.id.startsWith(tsconfigPath2.replaceAll("*", "")))) {
+          const resolvedPath = context.tsconfig.options.paths[tsconfigPathKey]?.find((tsconfigPath2) => context.fs.resolve(join.joinPaths(context.workspaceConfig.workspaceRoot, tsconfigPath2.replaceAll("*", ""), args.id.replace(tsconfigPathKey.replaceAll("*", ""), ""))) || context.fs.formatPath(tsconfigPath2) === context.fs.formatPath(args.id));
+          if (resolvedPath) {
+            tsconfigPath = context.fs.formatPath(resolvedPath) === context.fs.formatPath(args.id) ? context.fs.formatPath(resolvedPath) : context.fs.resolve(join.joinPaths(context.workspaceConfig.workspaceRoot, resolvedPath.replaceAll("*", ""), args.id.replace(tsconfigPathKey.replaceAll("*", ""), "")));
+          }
+        }
+      }
+      let tsconfigPathPackage = false;
+      if (context.tsconfig.options.paths) {
+        const tsconfigPathKeys = Object.keys(context.tsconfig.options.paths).filter((tsconfigPath2) => args.id.startsWith(tsconfigPath2.replaceAll("*", "")));
+        if (tsconfigPathKeys.length > 0 && tsconfigPathKeys[0]) {
+          tsconfigPathPackage = tsconfigPathKeys[0].replace(/\/\*$/, "");
+        }
+      }
       if (tsconfigPath && tsconfigPathPackage) {
         return {
           id: tsconfigPath,
@@ -58,7 +73,7 @@ async function handleResolveId(context, args, options = {}) {
           args.importer
         ] : []
       });
-      if (bundleRequire.match(args.id, options.noExternal) || resolvedPath && context.fs.meta[resolvedPath]?.variant === "builtin") {
+      if (bundleRequire.match(args.id, options.noExternal) || resolvedPath && context.fs.metadata[resolvedPath]?.variant === "builtin") {
         return void 0;
       }
       if (bundleRequire.match(args.id, options.external) || args.id.startsWith("node:")) {

package/dist/lib/{chunk-UDJ37BEE.cjs → chunk-VGSV2BEL.cjs}

@@ -1,11 +1,14 @@
 'use strict';
 
-var chunk7K7JH3DF_cjs = require('./chunk-7K7JH3DF.cjs');
+var chunkULJVBW4L_cjs = require('./chunk-ULJVBW4L.cjs');
 var chunkJA4HSQRN_cjs = require('./chunk-JA4HSQRN.cjs');
 var chunk3OCI4TH7_cjs = require('./chunk-3OCI4TH7.cjs');
 var chunkUSNT2KNT_cjs = require('./chunk-USNT2KNT.cjs');
 var types = require('@storm-software/config-tools/types');
 var omit = require('@stryke/helpers/omit');
+var filePathFns = require('@stryke/path/file-path-fns');
+var replace = require('@stryke/path/replace');
+var isString = require('@stryke/type-checks/is-string');
 var defu = require('defu');
 
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
@@ -28,40 +31,60 @@ function createUnplugin(context, options = {}) {
       async function resolveId(id, importer, opts = {
         isEntry: false
       }) {
-        let result = await ctx.$$internal.callHook("resolveId", {
-          sequential: true,
-          result: "first",
-          order: "pre"
-        }, id, importer, opts);
-        if (result) {
-          return result;
-        }
-        result = await ctx.$$internal.callHook("resolveId", {
-          sequential: true,
-          result: "first",
-          order: "normal"
-        }, id, importer, opts);
-        if (result) {
-          return result;
-        }
-        result = await chunk7K7JH3DF_cjs.handleResolveId(ctx, {
-          id,
-          importer,
-          options: opts
-        }, {
-          skipResolve: options.skipResolve,
-          skipNodeModulesBundle: ctx.config.build.skipNodeModulesBundle,
-          external: ctx.config.build.external,
-          noExternal: ctx.config.build.noExternal
-        });
-        if (result) {
-          return result;
+        const resolved = await (async () => {
+          let result = await ctx.$$internal.callHook("resolveId", {
+            sequential: true,
+            result: "first",
+            order: "pre"
+          }, id, importer, opts);
+          if (result) {
+            return result;
+          }
+          result = await ctx.$$internal.callHook("resolveId", {
+            sequential: true,
+            result: "first",
+            order: "normal"
+          }, id, importer, opts);
+          if (result) {
+            return result;
+          }
+          result = await chunkULJVBW4L_cjs.handleResolveId(ctx, {
+            id,
+            importer,
+            options: opts
+          }, {
+            skipResolve: options.skipResolve,
+            skipNodeModulesBundle: ctx.config.build.skipNodeModulesBundle,
+            external: ctx.config.build.external,
+            noExternal: ctx.config.build.noExternal
+          });
+          if (result) {
+            return result;
+          }
+          return ctx.$$internal.callHook("resolveId", {
+            sequential: true,
+            result: "first",
+            order: "post"
+          }, id, importer, opts);
+        })();
+        if (resolved && opts.isEntry && ctx.config.build.polyfill && ctx.config.build.polyfill.length > 0) {
+          const entry = ctx.entry.find((entry2) => entry2.file === (isString.isString(resolved) ? resolved : resolved.id));
+          if (entry) {
+            entry.file = `${replace.replaceExtension(isString.isString(resolved) ? resolved : resolved.id)}-polyfill.ts`;
+            entry.output ||= entry.output?.replace(filePathFns.findFileName(entry.output, {
+              withExtension: true
+            }), entry.file);
+            await ctx.writeEntry(`
+${ctx.config.build.polyfill.map((p) => `import "${p}";`).join("\n")}
+
+export * from "${isString.isString(resolved) ? resolved : resolved.id}";
+`, entry.file, {
+              mode: "virtual"
+            });
+            return entry.file;
+          }
         }
-        return ctx.$$internal.callHook("resolveId", {
-          sequential: true,
-          result: "first",
-          order: "post"
-        }, id, importer, opts);
+        return resolved;
       }
       chunkUSNT2KNT_cjs.__name(resolveId, "resolveId");
       async function load(id) {

package/dist/lib/{chunk-GRJJZ5VJ.js → chunk-YH5GOJS3.js}

@@ -10,15 +10,6 @@ import { hasFileExtension } from '@stryke/path/file-path-fns';
 import { joinPaths } from '@stryke/path/join-paths';
 import { kebabCase } from '@stryke/string-format/kebab-case';
 
-// src/types/vfs.ts
-var __VFS_INIT__ = "__VFS_INIT__";
-var __VFS_REVERT__ = "__VFS_REVERT__";
-var __VFS_CACHE__ = "__VFS_CACHE__";
-var __VFS_RESOLVER__ = "__VFS_RESOLVER__";
-var __VFS_VIRTUAL__ = "__VFS_VIRTUAL__";
-var __VFS_UNIFIED__ = "__VFS_UNIFIED__";
-
-// src/lib/utilities/meta.ts
 var PROJECT_ROOT_HASH_LENGTH = 45;
 var CACHE_HASH_LENGTH = 62;
 function getPrefixedProjectRootHash(name, projectRootHash) {
@@ -81,14 +72,10 @@ __name(getPersistedMeta, "getPersistedMeta");
 async function writeMetaFile(context) {
   const metaFilePath = joinPaths(context.dataPath, "meta.json");
   context.log(LogLevelLabel.DEBUG, `Writing runtime metadata to ${metaFilePath}`);
-  await context.fs.writeFile(metaFilePath, JSON.stringify({
-    ...context.meta,
-    virtualFiles: context.fs[__VFS_VIRTUAL__].toJSON(context.artifactsPath),
-    virtualFilesMeta: context.fs.getPartialMeta()
-  }, null, 2), {
+  await context.fs.writeFile(metaFilePath, JSON.stringify(context.meta, null, 2), {
     mode: "fs"
   });
 }
 __name(writeMetaFile, "writeMetaFile");
 
-export { CACHE_HASH_LENGTH, PROJECT_ROOT_HASH_LENGTH, __VFS_CACHE__, __VFS_INIT__, __VFS_RESOLVER__, __VFS_REVERT__, __VFS_UNIFIED__, __VFS_VIRTUAL__, discoverTemplates, getChecksum, getPersistedMeta, getPrefixedProjectRootHash, writeMetaFile };
+export { CACHE_HASH_LENGTH, PROJECT_ROOT_HASH_LENGTH, discoverTemplates, getChecksum, getPersistedMeta, getPrefixedProjectRootHash, writeMetaFile };

package/dist/lib/{chunk-NU4GDWLL.js → chunk-YV6MDKW4.js}

@@ -1,5 +1,5 @@
 import { getString } from './chunk-M263EZ4F.js';
-import { extractRollupConfig } from './chunk-OI2V6L7D.js';
+import { extractRollupConfig } from './chunk-HOZ37BFN.js';
 import { __name } from './chunk-SHUYVCID.js';
 import { joinPaths } from '@stryke/path/join-paths';
 import { isObject } from '@stryke/type-checks/is-object';
@@ -110,12 +110,19 @@ var unbuildLoader = /* @__PURE__ */ __name((context) => {
 function extractUnbuildConfig(context) {
   return defu({
     alias: context.builtins.reduce((ret, id) => {
-      const path = context.fs.ids[id];
-      if (path) {
-        ret[id] = path;
+      if (!ret[id]) {
+        const path = context.fs.ids[id];
+        if (path) {
+          ret[id] = path;
+        }
       }
       return ret;
-    }, {})
+    }, context.config.build.alias ? Array.isArray(context.config.build.alias) ? context.config.build.alias.reduce((ret, alias) => {
+      if (!ret[alias.find.toString()]) {
+        ret[alias.find.toString()] = alias.replacement;
+      }
+      return ret;
+    }, {}) : context.config.build.alias : {})
   }, context.config.build.variant === "unbuild" ? context.config.build.override : {}, {
     projectName: context.config.name,
     name: context.config.name,

package/dist/lib/{config-DN8Ad0lv.d.cts → config-7vXtXiGg.d.cts}

@@ -25,9 +25,7 @@ import { TransformResult as TransformResult$1, ExternalIdResult, HookFilter, Unp
 import { ArrayValues } from '@stryke/types/array';
 import { P as ParsedTypeScriptConfig, T as TSConfig } from './tsconfig-Bz-CiFqD.cjs';
 import { PrimitiveJsonValue } from '@stryke/json/types';
-import { Volume } from 'memfs';
 import { PathLike, StatSyncOptions, Stats, RmDirOptions, RmOptions, Mode, MakeDirectoryOptions as MakeDirectoryOptions$1, PathOrFileDescriptor, WriteFileOptions as WriteFileOptions$1 } from 'node:fs';
-import { IUnionFs } from 'unionfs';
 
 type UnpluginBuildVariant = "rollup" | "webpack" | "rspack" | "vite" | "esbuild" | "farm" | "unloader" | "rolldown";
 type BuildVariant = UnpluginBuildVariant | "tsup" | "unbuild";
@@ -39,6 +37,20 @@ interface BuildConfig {
      * @defaultValue "neutral"
      */
     platform?: "node" | "browser" | "neutral";
+    /**
+     * Array of strings indicating the polyfills to include for the build.
+     *
+     * @remarks
+     * This option allows you to specify which polyfills should be included in the build process to ensure compatibility with the target environment. The paths for the polyfills can use placeholder tokens (the `replacePathTokens` helper function will be used to resolve the actual values).
+     *
+     * @example
+     * ```ts
+     * {
+     *   polyfill: ['{projectRoot}/custom-polyfill.ts']
+     * }
+     * ```
+     */
+    polyfill?: string[];
     /**
      * 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.
      *
@@ -124,7 +136,10 @@ interface BuildConfig {
      *
      * @see https://github.com/rollup/plugins/tree/master/packages/alias
      */
-    alias?: Record<string, string>;
+    alias?: Record<string, string> | Array<{
+        find: string | RegExp;
+        replacement: string;
+    }>;
     /**
      * A list of modules that should not be bundled, even if they are external dependencies.
      *
@@ -174,7 +189,7 @@ type UnbuildResolvedBuildConfig = UnbuildOptions & BuildResolvedConfig;
 type FarmBuildConfig = Partial<Omit<UserConfig$2, "tsconfig" | "tsconfigRaw" | "assets" | "outputPath" | "mode" | "format" | "platform" | "projectRoot" | "env" | "entry" | "entryPoints">> & BuildConfig;
 type FarmResolvedBuildConfig = UserConfig$2 & BuildResolvedConfig;
 
-declare const SUPPORTED_COMMANDS: readonly ["new", "clean", "prepare", "lint", "test", "build", "docs", "release", "finalize"];
+declare const SUPPORTED_COMMANDS: readonly ["new", "clean", "prepare", "lint", "test", "build", "docs", "deploy", "finalize"];
 type CommandType = ArrayValues<typeof SUPPORTED_COMMANDS>;
 
 interface ResolvedEntryTypeDefinition extends TypeDefinition {
@@ -204,7 +219,7 @@ type OutputResolvedConfig = Required<Omit<OutputConfig, "assets"> & {
 /**
  * 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" | "variant" | "type" | "output" | "logLevel" | "framework"> & Required<Pick<TUserConfig, "name" | "title" | "plugins" | "mode" | "environments" | "tsconfig" | "lint" | "test" | "build" | "transform" | "framework">> & {
+type ResolvedConfig<TUserConfig extends UserConfig = UserConfig> = Omit<TUserConfig, "name" | "title" | "plugins" | "mode" | "environments" | "platform" | "tsconfig" | "lint" | "test" | "build" | "transform" | "deploy" | "variant" | "type" | "output" | "logLevel" | "framework"> & Required<Pick<TUserConfig, "name" | "title" | "plugins" | "mode" | "environments" | "tsconfig" | "lint" | "test" | "build" | "transform" | "deploy" | "framework">> & {
     /**
      * The configuration options that were provided inline to the Powerlines CLI.
      */
@@ -517,11 +532,8 @@ type InferHookHandler<TContext extends PluginContext, TKey extends HookKeys<TCon
 type InferHookReturnType<TContext extends PluginContext, TKey extends HookKeys<TContext>> = ReturnType<InferHookHandler<TContext, TKey>> extends Promise<infer U> ? U extends Promise<infer V> ? V : U : ReturnType<InferHookHandler<TContext, TKey>>;
 type InferHookParameters<TContext extends PluginContext, TKey extends HookKeys<TContext>> = Parameters<InferHookHandler<TContext, TKey>>;
 
-declare const __VFS_INIT__ = "__VFS_INIT__";
-declare const __VFS_REVERT__ = "__VFS_REVERT__";
-declare const __VFS_CACHE__ = "__VFS_CACHE__";
-declare const __VFS_VIRTUAL__ = "__VFS_VIRTUAL__";
-declare const __VFS_UNIFIED__ = "__VFS_UNIFIED__";
+declare const __VFS_PATCH__: unique symbol;
+declare const __VFS_REVERT__: unique symbol;
 type OutputModeType = "fs" | "virtual";
 interface VirtualFile {
     /**
@@ -561,7 +573,24 @@ interface VirtualFile {
      */
     code: string | NodeJS.ArrayBufferView;
 }
-type VirtualFileSystemMetadata = Pick<VirtualFile, "id" | "details" | "variant" | "mode">;
+interface VirtualFileMetadata {
+    /**
+     * The identifier for the file data.
+     */
+    id: string;
+    /**
+     * The variant of the file.
+     */
+    variant: string;
+    /**
+     * The output mode of the file.
+     */
+    mode: string;
+    /**
+     * Additional metadata associated with the file.
+     */
+    properties: Record<string, string>;
+}
 interface ResolveFSOptions {
     mode?: OutputModeType;
 }
@@ -590,12 +619,18 @@ interface ResolvePathOptions extends ResolveFSOptions {
     type?: "file" | "directory";
 }
 interface VirtualFileSystemInterface {
-    [__VFS_INIT__]: () => void;
+    /**
+     * Patches the File System to include the virtual file system (VFS) contents.
+     */
+    [__VFS_PATCH__]: () => void;
+    /**
+     * Reverts the virtual file system (VFS) to its previous state.
+     */
     [__VFS_REVERT__]: () => void;
     /**
      * The underlying file metadata.
      */
-    meta: Record<string, VirtualFileSystemMetadata | undefined>;
+    metadata: Record<string, VirtualFileMetadata | undefined>;
     /**
      * A map of module ids to their file paths.
      */
@@ -615,7 +650,7 @@ interface VirtualFileSystemInterface {
      * @param options - Optional parameters for resolving the path.
      * @returns Whether the path or id corresponds to a file written to the file system **(actually exists on disk)**.
      */
-    isFs: (pathOrId: string, options?: ResolvePathOptions) => boolean;
+    isPhysical: (pathOrId: string, options?: ResolvePathOptions) => boolean;
     /**
      * Checks if a file exists in the virtual file system (VFS).
      *
@@ -630,15 +665,6 @@ interface VirtualFileSystemInterface {
      * @returns `true` if the directory exists, otherwise `false`.
      */
     isDirectory: (path: string) => boolean;
-    /**
-     * Check if a path exists within one of the directories specified in the tsconfig.json's `path` field.
-     *
-     * @see https://www.typescriptlang.org/tsconfig#paths
-     *
-     * @param pathOrId - The path or id to check.
-     * @returns Whether the path or id corresponds to a virtual file.
-     */
-    isTsconfigPath: (pathOrId: string) => boolean;
     /**
      * Checks if a file exists in the virtual file system (VFS).
      *
@@ -652,7 +678,7 @@ interface VirtualFileSystemInterface {
      * @param pathOrId - The path or id of the file.
      * @returns The metadata of the file if it exists, otherwise undefined.
      */
-    getMetadata: (pathOrId: PathLike) => VirtualFileSystemMetadata | undefined;
+    getMetadata: (pathOrId: PathLike) => VirtualFileMetadata | undefined;
     /**
      * Gets the stats of a file in the virtual file system (VFS).
      *
@@ -860,23 +886,12 @@ interface VirtualFileSystemInterface {
      */
     resolve: (pathOrId: string, options?: ResolvePathOptions) => string | false;
     /**
-     * Resolves a path based on TypeScript's `tsconfig.json` paths.
-     *
-     * @see https://www.typescriptlang.org/tsconfig#paths
+     * Formats a path to match the virtual file system (VFS) structure.
      *
-     * @param path - The path to check.
-     * @returns The resolved file path if it exists, otherwise undefined.
+     * @param path - The path to format.
+     * @returns The formatted path.
      */
-    resolveTsconfigPath: (path: string) => string | false;
-    /**
-     * Resolves a package name based on TypeScript's `tsconfig.json` paths.
-     *
-     * @see https://www.typescriptlang.org/tsconfig#paths
-     *
-     * @param path - The path to check.
-     * @returns The resolved package name if it exists, otherwise undefined.
-     */
-    resolveTsconfigPathPackage: (path: string) => string | false;
+    formatPath: (path: string) => string;
     /**
      * Resolves a path or id to a file path in the virtual file system.
      *
@@ -885,23 +900,9 @@ interface VirtualFileSystemInterface {
      */
     realpathSync: (pathOrId: string) => string;
     /**
-     * Retrieves a partial metadata mapping of all files in the virtual file system (VFS).
-     *
-     * @returns A record mapping file paths to their partial metadata.
-     */
-    getPartialMeta: () => Record<string, Partial<VirtualFileSystemMetadata>>;
-    /**
-     * A map of cached file paths to their underlying file content.
-     */
-    [__VFS_CACHE__]: Map<string, string>;
-    /**
-     * A reference to the underlying virtual file system.
+     * Disposes of the virtual file system (VFS), writes any virtual file changes to disk, and releases any associated resources.
      */
-    [__VFS_VIRTUAL__]: Volume;
-    /**
-     * A reference to the underlying unified file system.
-     */
-    [__VFS_UNIFIED__]: IUnionFs;
+    dispose: () => Promise<void>;
 }
 
 type WorkerProcess<TExposedMethods extends ReadonlyArray<string>> = {
@@ -935,14 +936,6 @@ interface MetaInfo {
      * 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;
@@ -1433,6 +1426,13 @@ interface BaseConfig {
      * This configuration will be used by the documentation generation plugins during the `docs` command.
      */
     docs?: Record<string, any>;
+    /**
+     * Configuration for deploying the source code
+     *
+     * @remarks
+     * If set to `false`, the deployment will be disabled.
+     */
+    deploy?: Record<string, any> | false;
     /**
      * The path to the tsconfig file to be used by the compiler
      *
@@ -1568,7 +1568,7 @@ type ParsedUserConfig<TUserConfig extends UserConfig = UserConfig> = TUserConfig
      */
     configFile?: ConfigLayer<TUserConfig>["configFile"];
 };
-type PowerlinesCommand = "new" | "prepare" | "build" | "lint" | "test" | "docs" | "release" | "clean";
+type PowerlinesCommand = "new" | "prepare" | "build" | "lint" | "test" | "docs" | "deploy" | "clean";
 /**
  * The configuration provided while executing Powerlines commands.
  */
@@ -1618,11 +1618,11 @@ type DocsInlineConfig<TUserConfig extends UserConfig = UserConfig> = InlineConfi
      */
     command: "docs";
 };
-type ReleaseInlineConfig<TUserConfig extends UserConfig = UserConfig> = InlineConfig<TUserConfig> & {
+type DeployInlineConfig<TUserConfig extends UserConfig = UserConfig> = InlineConfig<TUserConfig> & {
     /**
      * A string identifier for the Powerlines command being executed
      */
-    command: "release";
+    command: "deploy";
 };
 
-export type { APIContext as A, BuildVariant as B, Context as C, DocsInlineConfig as D, ESBuildResolvedBuildConfig as E, HookKeys as H, InferHookParameters as I, LogFn as L, MetaInfo as M, NewInlineConfig as N, PowerlinesCommand as P, ResolvedEntryTypeDefinition as R, SelectHooksOptions as S, TsupBuildConfig as T, UnbuildBuildConfig as U, ViteResolvedBuildConfig as V, WorkspaceConfig as W, ParsedUserConfig as a, RolldownResolvedBuildConfig as b, RollupResolvedBuildConfig as c, TsupResolvedBuildConfig as d, PluginContext as e, SourceFile as f, TransformResult as g, WorkerProcess as h, ResolvedConfig as i, EnvironmentContext as j, InferHookReturnType as k, UnbuildResolvedBuildConfig as l, InferUnpluginVariant as m, BuildPlugin as n, InferResolvedConfig as o, UnpluginBuildVariant as p, InferUserConfig as q, InitialUserConfig as r, PrepareInlineConfig as s, CleanInlineConfig as t, BuildInlineConfig as u, LintInlineConfig as v, ReleaseInlineConfig as w };
+export { type APIContext as A, type BuildVariant as B, type Context as C, type PrepareInlineConfig as D, type ESBuildResolvedBuildConfig as E, type CleanInlineConfig as F, type BuildInlineConfig as G, type HookKeys as H, type InferHookParameters as I, type LintInlineConfig as J, type DocsInlineConfig as K, type LogFn as L, type MakeDirectoryOptions as M, type NewInlineConfig as N, type DeployInlineConfig as O, type PowerlinesCommand as P, type ResolvePathOptions as R, type SelectHooksOptions as S, type TsupBuildConfig as T, type UnbuildBuildConfig as U, type VirtualFileSystemInterface as V, type WriteFileData as W, __VFS_PATCH__ as _, type VirtualFileMetadata as a, type ResolveFSOptions as b, type WriteFileOptions as c, __VFS_REVERT__ as d, type WorkspaceConfig as e, type ParsedUserConfig as f, type ResolvedEntryTypeDefinition as g, type RolldownResolvedBuildConfig as h, type RollupResolvedBuildConfig as i, type TsupResolvedBuildConfig as j, type ViteResolvedBuildConfig as k, type PluginContext as l, type SourceFile as m, type MetaInfo as n, type TransformResult as o, type WorkerProcess as p, type ResolvedConfig as q, type EnvironmentContext as r, type InferHookReturnType as s, type UnbuildResolvedBuildConfig as t, type InferUnpluginVariant as u, type BuildPlugin as v, type InferResolvedConfig as w, type UnpluginBuildVariant as x, type InferUserConfig as y, type InitialUserConfig as z };