@powerlines/plugin-react 0.1.10 → 0.1.11

package/dist/components/index.d.cts

@@ -1,8 +1,6 @@
 export { ReactOptimizedBuiltin, ReactOptimizedBuiltinProps } from './react-optimized.cjs';
 import '@alloy-js/core';
 import '@alloy-js/core/jsx-runtime';
-import '../vfs-Bl84Hw2V.cjs';
+import '../vfs-BGmsy47f.cjs';
 import '@stryke/json/types';
-import 'memfs';
 import 'node:fs';
-import 'unionfs';

package/dist/components/index.d.ts

@@ -1,8 +1,6 @@
 export { ReactOptimizedBuiltin, ReactOptimizedBuiltinProps } from './react-optimized.js';
 import '@alloy-js/core';
 import '@alloy-js/core/jsx-runtime';
-import '../vfs-Bl84Hw2V.js';
+import '../vfs-BGmsy47f.js';
 import '@stryke/json/types';
-import 'memfs';
 import 'node:fs';
-import 'unionfs';

package/dist/components/react-optimized.d.cts

@@ -1,11 +1,9 @@
 import * as _alloy_js_core from '@alloy-js/core';
 import { Children as Children$1, SourceFileProps as SourceFileProps$1 } from '@alloy-js/core';
 import { Children } from '@alloy-js/core/jsx-runtime';
-import { O as OutputModeType } from '../vfs-Bl84Hw2V.cjs';
+import { O as OutputModeType } from '../vfs-BGmsy47f.cjs';
 import '@stryke/json/types';
-import 'memfs';
 import 'node:fs';
-import 'unionfs';
 
 /**
  * A type that represents the props of a component that can have children.

package/dist/components/react-optimized.d.ts

@@ -1,11 +1,9 @@
 import * as _alloy_js_core from '@alloy-js/core';
 import { Children as Children$1, SourceFileProps as SourceFileProps$1 } from '@alloy-js/core';
 import { Children } from '@alloy-js/core/jsx-runtime';
-import { O as OutputModeType } from '../vfs-Bl84Hw2V.js';
+import { O as OutputModeType } from '../vfs-BGmsy47f.js';
 import '@stryke/json/types';
-import 'memfs';
 import 'node:fs';
-import 'unionfs';
 
 /**
  * A type that represents the props of a component that can have children.

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { P as PluginContext, a as Plugin } from './runtime-BC7ENbDx.cjs';
+import { P as PluginContext, a as Plugin } from './runtime-BKpao7nk.cjs';
 import { Children } from '@alloy-js/core/jsx-runtime';
 import { PrintTreeOptions } from '@alloy-js/core';
 import { ReactPluginContext } from './types/plugin.cjs';
@@ -23,11 +23,9 @@ import '@babel/helper-plugin-utils';
 import '@stryke/types/array';
 import '@stryke/types/tsconfig';
 import 'typescript';
-import './vfs-Bl84Hw2V.cjs';
+import './vfs-BGmsy47f.cjs';
 import '@stryke/json/types';
-import 'memfs';
 import 'node:fs';
-import 'unionfs';
 import '@deepkit/type';
 import '@stryke/capnp';
 import '@stryke/env/types';

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { P as PluginContext, a as Plugin } from './runtime-DCT7zK30.js';
+import { P as PluginContext, a as Plugin } from './runtime-DNQO2Zr2.js';
 import { Children } from '@alloy-js/core/jsx-runtime';
 import { PrintTreeOptions } from '@alloy-js/core';
 import { ReactPluginContext } from './types/plugin.js';
@@ -23,11 +23,9 @@ import '@babel/helper-plugin-utils';
 import '@stryke/types/array';
 import '@stryke/types/tsconfig';
 import 'typescript';
-import './vfs-Bl84Hw2V.js';
+import './vfs-BGmsy47f.js';
 import '@stryke/json/types';
-import 'memfs';
 import 'node:fs';
-import 'unionfs';
 import '@deepkit/type';
 import '@stryke/capnp';
 import '@stryke/env/types';

package/dist/{runtime-DCT7zK30.d.ts → runtime-BKpao7nk.d.cts}

@@ -16,7 +16,7 @@ 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';
+import { O as OutputModeType, V as VirtualFileSystemInterface, a as VirtualFile, P as PowerlinesWriteFileOptions } from './vfs-BGmsy47f.cjs';
 
 type BabelPluginPass<TState = unknown> = PluginPass & TState;
 type BabelTransformPluginFilter = (code: string, id: string) => boolean;
@@ -44,6 +44,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.
      *
@@ -129,7 +143,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.
      *
@@ -155,7 +172,7 @@ interface BuildConfig {
 }
 type BuildResolvedConfig = Omit<BuildConfig, "override">;
 
-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 {
@@ -186,7 +203,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.
      */
@@ -688,6 +705,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
      *
@@ -801,7 +825,7 @@ type UserConfig<TBuildConfig extends BuildConfig = BuildConfig, TBuildResolvedCo
         override?: Partial<TBuildResolvedConfig>;
     };
 };
-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.
  */
@@ -848,14 +872,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;

package/dist/{runtime-BC7ENbDx.d.cts → runtime-DNQO2Zr2.d.ts}

@@ -16,7 +16,7 @@ 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.cjs';
+import { O as OutputModeType, V as VirtualFileSystemInterface, a as VirtualFile, P as PowerlinesWriteFileOptions } from './vfs-BGmsy47f.js';
 
 type BabelPluginPass<TState = unknown> = PluginPass & TState;
 type BabelTransformPluginFilter = (code: string, id: string) => boolean;
@@ -44,6 +44,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.
      *
@@ -129,7 +143,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.
      *
@@ -155,7 +172,7 @@ interface BuildConfig {
 }
 type BuildResolvedConfig = Omit<BuildConfig, "override">;
 
-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 {
@@ -186,7 +203,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.
      */
@@ -688,6 +705,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
      *
@@ -801,7 +825,7 @@ type UserConfig<TBuildConfig extends BuildConfig = BuildConfig, TBuildResolvedCo
         override?: Partial<TBuildResolvedConfig>;
     };
 };
-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.
  */
@@ -848,14 +872,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;

package/dist/types/index.d.cts

@@ -1,6 +1,6 @@
 export { ReactCompilerOptions, ReactPluginContext, ReactPluginOptions, ReactPluginResolvedConfig, ReactPluginUserConfig } from './plugin.cjs';
 export { ReactEnvInterface } from './runtime.cjs';
-import '../runtime-BC7ENbDx.cjs';
+import '../runtime-BKpao7nk.cjs';
 import '@stryke/env/get-env-paths';
 import '@stryke/types/base';
 import '@stryke/types/package-json';
@@ -19,11 +19,9 @@ import '@babel/helper-plugin-utils';
 import '@stryke/types/array';
 import '@stryke/types/tsconfig';
 import 'typescript';
-import '../vfs-Bl84Hw2V.cjs';
+import '../vfs-BGmsy47f.cjs';
 import '@stryke/json/types';
-import 'memfs';
 import 'node:fs';
-import 'unionfs';
 import '@alloy-js/core/jsx-runtime';
 import '@deepkit/type';
 import '@stryke/capnp';

package/dist/types/index.d.ts

@@ -1,6 +1,6 @@
 export { ReactCompilerOptions, ReactPluginContext, ReactPluginOptions, ReactPluginResolvedConfig, ReactPluginUserConfig } from './plugin.js';
 export { ReactEnvInterface } from './runtime.js';
-import '../runtime-DCT7zK30.js';
+import '../runtime-DNQO2Zr2.js';
 import '@stryke/env/get-env-paths';
 import '@stryke/types/base';
 import '@stryke/types/package-json';
@@ -19,11 +19,9 @@ import '@babel/helper-plugin-utils';
 import '@stryke/types/array';
 import '@stryke/types/tsconfig';
 import 'typescript';
-import '../vfs-Bl84Hw2V.js';
+import '../vfs-BGmsy47f.js';
 import '@stryke/json/types';
-import 'memfs';
 import 'node:fs';
-import 'unionfs';
 import '@alloy-js/core/jsx-runtime';
 import '@deepkit/type';
 import '@stryke/capnp';

package/dist/types/plugin.d.cts

@@ -1,4 +1,4 @@
-import { B as BabelUserConfig, U as UserConfig, R as ResolvedConfig, b as BabelResolvedConfig, P as PluginContext, E as EnvInterface, S as SecretsInterface } from '../runtime-BC7ENbDx.cjs';
+import { B as BabelUserConfig, U as UserConfig, R as ResolvedConfig, b as BabelResolvedConfig, P as PluginContext, E as EnvInterface, S as SecretsInterface } from '../runtime-BKpao7nk.cjs';
 import { Children } from '@alloy-js/core/jsx-runtime';
 import { ReflectionClass } from '@deepkit/type';
 import * as $ from '@stryke/capnp';
@@ -22,11 +22,9 @@ import '@babel/helper-plugin-utils';
 import '@stryke/types/array';
 import '@stryke/types/tsconfig';
 import 'typescript';
-import '../vfs-Bl84Hw2V.cjs';
+import '../vfs-BGmsy47f.cjs';
 import '@stryke/json/types';
-import 'memfs';
 import 'node:fs';
-import 'unionfs';
 
 type BabelPluginOptions = Partial<BabelUserConfig>;
 type BabelPluginUserConfig = UserConfig;

package/dist/types/plugin.d.ts

@@ -1,4 +1,4 @@
-import { B as BabelUserConfig, U as UserConfig, R as ResolvedConfig, b as BabelResolvedConfig, P as PluginContext, E as EnvInterface, S as SecretsInterface } from '../runtime-DCT7zK30.js';
+import { B as BabelUserConfig, U as UserConfig, R as ResolvedConfig, b as BabelResolvedConfig, P as PluginContext, E as EnvInterface, S as SecretsInterface } from '../runtime-DNQO2Zr2.js';
 import { Children } from '@alloy-js/core/jsx-runtime';
 import { ReflectionClass } from '@deepkit/type';
 import * as $ from '@stryke/capnp';
@@ -22,11 +22,9 @@ import '@babel/helper-plugin-utils';
 import '@stryke/types/array';
 import '@stryke/types/tsconfig';
 import 'typescript';
-import '../vfs-Bl84Hw2V.js';
+import '../vfs-BGmsy47f.js';
 import '@stryke/json/types';
-import 'memfs';
 import 'node:fs';
-import 'unionfs';
 
 type BabelPluginOptions = Partial<BabelUserConfig>;
 type BabelPluginUserConfig = UserConfig;

package/dist/types/runtime.d.cts

@@ -1,4 +1,4 @@
-import { E as EnvInterface } from '../runtime-BC7ENbDx.cjs';
+import { E as EnvInterface } from '../runtime-BKpao7nk.cjs';
 import '@stryke/env/get-env-paths';
 import '@stryke/types/base';
 import '@stryke/types/package-json';
@@ -17,11 +17,9 @@ import '@babel/helper-plugin-utils';
 import '@stryke/types/array';
 import '@stryke/types/tsconfig';
 import 'typescript';
-import '../vfs-Bl84Hw2V.cjs';
+import '../vfs-BGmsy47f.cjs';
 import '@stryke/json/types';
-import 'memfs';
 import 'node:fs';
-import 'unionfs';
 
 interface ReactEnvInterface extends EnvInterface {
     /**

package/dist/types/runtime.d.ts

@@ -1,4 +1,4 @@
-import { E as EnvInterface } from '../runtime-DCT7zK30.js';
+import { E as EnvInterface } from '../runtime-DNQO2Zr2.js';
 import '@stryke/env/get-env-paths';
 import '@stryke/types/base';
 import '@stryke/types/package-json';
@@ -17,11 +17,9 @@ import '@babel/helper-plugin-utils';
 import '@stryke/types/array';
 import '@stryke/types/tsconfig';
 import 'typescript';
-import '../vfs-Bl84Hw2V.js';
+import '../vfs-BGmsy47f.js';
 import '@stryke/json/types';
-import 'memfs';
 import 'node:fs';
-import 'unionfs';
 
 interface ReactEnvInterface extends EnvInterface {
     /**

package/dist/{vfs-Bl84Hw2V.d.cts → vfs-BGmsy47f.d.cts}

@@ -1,13 +1,8 @@
 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';
 
-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 {
     /**
@@ -47,7 +42,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;
 }
@@ -76,12 +88,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.
      */
@@ -101,7 +119,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).
      *
@@ -116,15 +134,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).
      *
@@ -138,7 +147,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).
      *
@@ -346,23 +355,12 @@ interface VirtualFileSystemInterface {
      */
     resolve: (pathOrId: string, options?: ResolvePathOptions) => string | false;
     /**
-     * Resolves a path based on TypeScript's `tsconfig.json` paths.
+     * Formats a path to match the virtual file system (VFS) structure.
      *
-     * @see https://www.typescriptlang.org/tsconfig#paths
-     *
-     * @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.
      *
@@ -371,23 +369,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.
-     */
-    [__VFS_VIRTUAL__]: Volume;
-    /**
-     * A reference to the underlying unified file system.
+     * Disposes of the virtual file system (VFS), writes any virtual file changes to disk, and releases any associated resources.
      */
-    [__VFS_UNIFIED__]: IUnionFs;
+    dispose: () => Promise<void>;
 }
 
 export type { OutputModeType as O, PowerlinesWriteFileOptions as P, VirtualFileSystemInterface as V, VirtualFile as a };

package/dist/{vfs-Bl84Hw2V.d.ts → vfs-BGmsy47f.d.ts}

@@ -1,13 +1,8 @@
 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';
 
-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 {
     /**
@@ -47,7 +42,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;
 }
@@ -76,12 +88,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.
      */
@@ -101,7 +119,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).
      *
@@ -116,15 +134,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).
      *
@@ -138,7 +147,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).
      *
@@ -346,23 +355,12 @@ interface VirtualFileSystemInterface {
      */
     resolve: (pathOrId: string, options?: ResolvePathOptions) => string | false;
     /**
-     * Resolves a path based on TypeScript's `tsconfig.json` paths.
+     * Formats a path to match the virtual file system (VFS) structure.
      *
-     * @see https://www.typescriptlang.org/tsconfig#paths
-     *
-     * @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.
      *
@@ -371,23 +369,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.
-     */
-    [__VFS_VIRTUAL__]: Volume;
-    /**
-     * A reference to the underlying unified file system.
+     * Disposes of the virtual file system (VFS), writes any virtual file changes to disk, and releases any associated resources.
      */
-    [__VFS_UNIFIED__]: IUnionFs;
+    dispose: () => Promise<void>;
 }
 
 export type { OutputModeType as O, PowerlinesWriteFileOptions as P, VirtualFileSystemInterface as V, VirtualFile as a };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@powerlines/plugin-react",
-  "version": "0.1.10",
+  "version": "0.1.11",
   "type": "module",
   "description": "A package containing a Powerlines plugin for building a React application.",
   "repository": {
@@ -130,19 +130,19 @@
     "@stryke/fs": "^0.32.13",
     "@stryke/path": "^0.19.2",
     "babel-plugin-react-compiler": "^1.0.0",
-    "@powerlines/alloy": "^0.11.19",
-    "@powerlines/plugin-babel": "^0.12.19",
-    "@powerlines/plugin-env": "^0.13.16",
-    "@powerlines/plugin-plugin": "^0.11.18",
+    "@powerlines/alloy": "^0.11.20",
+    "@powerlines/plugin-babel": "^0.12.20",
+    "@powerlines/plugin-env": "^0.13.17",
+    "@powerlines/plugin-plugin": "^0.11.19",
     "@vitejs/plugin-react": "^5.1.1",
     "defu": "^6.1.4",
-    "powerlines": "^0.20.0"
+    "powerlines": "^0.21.0"
   },
   "devDependencies": {
-    "@powerlines/nx": "^0.10.10",
+    "@powerlines/nx": "^0.10.11",
     "@storm-software/tsup": "^0.2.38",
     "@types/node": "^22.19.1"
   },
   "publishConfig": { "access": "public" },
-  "gitHead": "e33924ab31dbf508b8983523edbaecffeebbee4f"
+  "gitHead": "c6ed2ca745c8f340a55758b3102933dc41e83428"
 }