@powerlines/plugin-env 0.13.15 → 0.13.17

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-env",
-  "version": "0.13.15",
+  "version": "0.13.17",
   "type": "module",
   "description": "A package containing a Powerlines plugin for injecting static .env configuration values to the code so that they're accessible at runtime.",
   "repository": {
@@ -179,9 +179,9 @@
     "@alloy-js/typescript": "^0.20.0",
     "@babel/core": "^7.28.5",
     "@babel/types": "^7.28.5",
-    "@powerlines/alloy": "^0.11.18",
-    "@powerlines/plugin-babel": "^0.12.18",
-    "@powerlines/plugin-plugin": "^0.11.17",
+    "@powerlines/alloy": "^0.11.20",
+    "@powerlines/plugin-babel": "^0.12.20",
+    "@powerlines/plugin-plugin": "^0.11.19",
     "@storm-software/config-tools": "^1.188.40",
     "@stryke/capnp": "^0.12.21",
     "@stryke/env": "^0.20.14",
@@ -190,12 +190,12 @@
     "@stryke/string-format": "^0.12.2",
     "@stryke/type-checks": "^0.3.12",
     "@stryke/types": "^0.10.2",
-    "powerlines": "^0.19.5"
+    "powerlines": "^0.21.0"
   },
   "devDependencies": {
     "@alloy-js/babel-preset": "^0.2.1",
     "@babel/preset-typescript": "^7.28.5",
-    "@powerlines/nx": "^0.10.9",
+    "@powerlines/nx": "^0.10.11",
     "@storm-software/tsup": "^0.2.38",
     "@types/node": "^22.19.1",
     "tsup": "8.4.0",
@@ -203,5 +203,5 @@
     "vite": "^7.2.2"
   },
   "publishConfig": { "access": "public" },
-  "gitHead": "041609f2ea8770273cff82b402e3abdc3fcd9133"
+  "gitHead": "c6ed2ca745c8f340a55758b3102933dc41e83428"
 }