powerlines 0.24.8 → 0.25.0

package/dist/lib/fs/storage/file-system.d.cts

@@ -0,0 +1,90 @@
+import { BaseStorageAdapter, StorageAdapterOptions } from './base.cjs';
+import '@stryke/types/base';
+import '../../fs-Dg-aTfiN.cjs';
+import '@stryke/fs/resolve';
+
+/**
+ * File system storage adapter implementation.
+ */
+declare class FileSystemStorageAdapter extends BaseStorageAdapter {
+    /**
+     * A name identifying the storage adapter type.
+     */
+    name: string;
+    /**
+     * Constructor for the FileSystemStorageAdapter.
+     *
+     * @param options - Configuration options for the storage adapter.
+     */
+    constructor(options?: StorageAdapterOptions);
+    /**
+     * Synchronously checks if a key exists in the storage.
+     *
+     * @param key - The key to check for existence.
+     * @returns Returns `true` if the key exists, otherwise `false`.
+     */
+    existsSync(key: string): boolean;
+    /**
+     * Asynchronously checks if a key exists in the storage.
+     *
+     * @param key - The key to check for existence.
+     * @returns A promise that resolves to `true` if the key exists, otherwise `false`.
+     */
+    exists(key: string): Promise<boolean>;
+    /**
+     * Synchronously retrieves the value associated with a given key.
+     *
+     * @param key - The key whose value is to be retrieved.
+     * @returns The value associated with the key, or `null` if the key does not exist.
+     */
+    getSync(key: string): string | null;
+    /**
+     * Asynchronously retrieves the value associated with a given key.
+     *
+     * @param key - The key whose value is to be retrieved.
+     * @returns A promise that resolves to the value associated with the key, or `null` if the key does not exist.
+     */
+    get(key: string): Promise<string | null>;
+    /**
+     * Synchronously sets the value for a given key.
+     *
+     * @param key - The key to set the value for.
+     * @param value - The value to set.
+     */
+    setSync(key: string, value: string): void;
+    /**
+     * Asynchronously sets the value for a given key.
+     *
+     * @param key - The key to set the value for.
+     * @param value - The value to set.
+     */
+    set(key: string, value: string): Promise<void>;
+    /**
+     * Synchronously removes a key from the storage.
+     *
+     * @param key - The key to remove.
+     */
+    removeSync(key: string): any;
+    /**
+     * Asynchronously removes a key from the storage.
+     *
+     * @param key - The key to remove.
+     */
+    remove(key: string): Promise<void>;
+    /**
+     * Lists all keys under a given base path synchronously.
+     *
+     * @param base - The base path to list keys from.
+     * @returns An array of keys under the specified base path.
+     */
+    listSync(base?: string): string[];
+    /**
+     * Asynchronously lists all keys under a given base path.
+     *
+     * @param base - The base path to list keys from.
+     * @returns A promise that resolves to an array of keys under the specified base path.
+     */
+    list(base?: string): Promise<string[]>;
+}
+
+export { FileSystemStorageAdapter };

package/dist/lib/fs/storage/file-system.d.ts

@@ -0,0 +1,90 @@
+import { BaseStorageAdapter, StorageAdapterOptions } from './base.js';
+import '@stryke/types/base';
+import '../../fs-Dg-aTfiN.js';
+import '@stryke/fs/resolve';
+
+/**
+ * File system storage adapter implementation.
+ */
+declare class FileSystemStorageAdapter extends BaseStorageAdapter {
+    /**
+     * A name identifying the storage adapter type.
+     */
+    name: string;
+    /**
+     * Constructor for the FileSystemStorageAdapter.
+     *
+     * @param options - Configuration options for the storage adapter.
+     */
+    constructor(options?: StorageAdapterOptions);
+    /**
+     * Synchronously checks if a key exists in the storage.
+     *
+     * @param key - The key to check for existence.
+     * @returns Returns `true` if the key exists, otherwise `false`.
+     */
+    existsSync(key: string): boolean;
+    /**
+     * Asynchronously checks if a key exists in the storage.
+     *
+     * @param key - The key to check for existence.
+     * @returns A promise that resolves to `true` if the key exists, otherwise `false`.
+     */
+    exists(key: string): Promise<boolean>;
+    /**
+     * Synchronously retrieves the value associated with a given key.
+     *
+     * @param key - The key whose value is to be retrieved.
+     * @returns The value associated with the key, or `null` if the key does not exist.
+     */
+    getSync(key: string): string | null;
+    /**
+     * Asynchronously retrieves the value associated with a given key.
+     *
+     * @param key - The key whose value is to be retrieved.
+     * @returns A promise that resolves to the value associated with the key, or `null` if the key does not exist.
+     */
+    get(key: string): Promise<string | null>;
+    /**
+     * Synchronously sets the value for a given key.
+     *
+     * @param key - The key to set the value for.
+     * @param value - The value to set.
+     */
+    setSync(key: string, value: string): void;
+    /**
+     * Asynchronously sets the value for a given key.
+     *
+     * @param key - The key to set the value for.
+     * @param value - The value to set.
+     */
+    set(key: string, value: string): Promise<void>;
+    /**
+     * Synchronously removes a key from the storage.
+     *
+     * @param key - The key to remove.
+     */
+    removeSync(key: string): any;
+    /**
+     * Asynchronously removes a key from the storage.
+     *
+     * @param key - The key to remove.
+     */
+    remove(key: string): Promise<void>;
+    /**
+     * Lists all keys under a given base path synchronously.
+     *
+     * @param base - The base path to list keys from.
+     * @returns An array of keys under the specified base path.
+     */
+    listSync(base?: string): string[];
+    /**
+     * Asynchronously lists all keys under a given base path.
+     *
+     * @param base - The base path to list keys from.
+     * @returns A promise that resolves to an array of keys under the specified base path.
+     */
+    list(base?: string): Promise<string[]>;
+}
+
+export { FileSystemStorageAdapter };

package/dist/lib/fs/storage/file-system.js

@@ -0,0 +1,4 @@
+export { FileSystemStorageAdapter } from '../../chunk-L56XA427.js';
+import '../../chunk-VHCBD2IS.js';
+import '../../chunk-KFDNKOXM.js';
+import '../../chunk-SHUYVCID.js';

package/dist/lib/fs/storage/index.cjs

@@ -0,0 +1,22 @@
+'use strict';
+
+var chunk6OYSDQXE_cjs = require('../../chunk-6OYSDQXE.cjs');
+var chunkXUYQYUWZ_cjs = require('../../chunk-XUYQYUWZ.cjs');
+var chunkXLHFUATD_cjs = require('../../chunk-XLHFUATD.cjs');
+require('../../chunk-YYEAV24J.cjs');
+require('../../chunk-USNT2KNT.cjs');
+
+
+
+Object.defineProperty(exports, "FileSystemStorageAdapter", {
+  enumerable: true,
+  get: function () { return chunk6OYSDQXE_cjs.FileSystemStorageAdapter; }
+});
+Object.defineProperty(exports, "VirtualStorageAdapter", {
+  enumerable: true,
+  get: function () { return chunkXUYQYUWZ_cjs.VirtualStorageAdapter; }
+});
+Object.defineProperty(exports, "BaseStorageAdapter", {
+  enumerable: true,
+  get: function () { return chunkXLHFUATD_cjs.BaseStorageAdapter; }
+});

package/dist/lib/fs/storage/index.d.cts

@@ -0,0 +1,6 @@
+export { BaseStorageAdapter, StorageAdapterOptions, __ΩStorageAdapterOptions } from './base.cjs';
+export { FileSystemStorageAdapter } from './file-system.cjs';
+export { VirtualStorageAdapter } from './virtual.cjs';
+import '@stryke/types/base';
+import '../../fs-Dg-aTfiN.cjs';
+import '@stryke/fs/resolve';

package/dist/lib/fs/storage/index.d.ts

@@ -0,0 +1,6 @@
+export { BaseStorageAdapter, StorageAdapterOptions, __ΩStorageAdapterOptions } from './base.js';
+export { FileSystemStorageAdapter } from './file-system.js';
+export { VirtualStorageAdapter } from './virtual.js';
+import '@stryke/types/base';
+import '../../fs-Dg-aTfiN.js';
+import '@stryke/fs/resolve';

package/dist/lib/fs/storage/index.js

@@ -0,0 +1,5 @@
+export { FileSystemStorageAdapter } from '../../chunk-L56XA427.js';
+export { VirtualStorageAdapter } from '../../chunk-ONETLSPO.js';
+export { BaseStorageAdapter } from '../../chunk-VHCBD2IS.js';
+import '../../chunk-KFDNKOXM.js';
+import '../../chunk-SHUYVCID.js';

package/dist/lib/fs/storage/virtual.cjs

@@ -0,0 +1,12 @@
+'use strict';
+
+var chunkXUYQYUWZ_cjs = require('../../chunk-XUYQYUWZ.cjs');
+require('../../chunk-XLHFUATD.cjs');
+require('../../chunk-USNT2KNT.cjs');
+
+
+
+Object.defineProperty(exports, "VirtualStorageAdapter", {
+  enumerable: true,
+  get: function () { return chunkXUYQYUWZ_cjs.VirtualStorageAdapter; }
+});

package/dist/lib/fs/storage/virtual.d.cts

@@ -0,0 +1,66 @@
+import { BaseStorageAdapter, StorageAdapterOptions } from './base.cjs';
+import '@stryke/types/base';
+import '../../fs-Dg-aTfiN.cjs';
+import '@stryke/fs/resolve';
+
+/**
+ * Virtual/in-memory storage adapter implementation.
+ */
+declare class VirtualStorageAdapter extends BaseStorageAdapter {
+    /**
+     * A name identifying the storage adapter type.
+     */
+    name: string;
+    /**
+     * In-memory data storage.
+     */
+    protected data: Map<string, any>;
+    /**
+     * Constructor for the VirtualStorageAdapter.
+     *
+     * @param options - Configuration options for the storage adapter.
+     */
+    constructor(options?: StorageAdapterOptions);
+    /**
+     * Synchronously checks if a key exists in the storage.
+     *
+     * @param key - The key to check for existence.
+     * @returns Returns `true` if the key exists, otherwise `false`.
+     */
+    existsSync(key: string): boolean;
+    /**
+     * Synchronously retrieves the value associated with a given key.
+     *
+     * @param key - The key whose value is to be retrieved.
+     * @returns The value associated with the key, or `null` if the key does not exist.
+     */
+    getSync(key: string): string | null;
+    /**
+     * Synchronously sets the value for a given key.
+     *
+     * @param key - The key to set the value for.
+     * @param value - The value to set.
+     */
+    setSync(key: string, value: string): void;
+    /**
+     * Synchronously removes a key from the storage.
+     *
+     * @param key - The key to remove.
+     */
+    removeSync(key: string): void;
+    /**
+     * Lists all keys under a given base path synchronously.
+     *
+     * @param base - The base path to list keys from.
+     * @returns An array of keys under the specified base path.
+     */
+    listSync(base?: string): string[];
+    /**
+     * Disposes of the storage adapter, releasing any held resources.
+     *
+     * @returns A promise that resolves when the disposal is complete.
+     */
+    dispose(): Promise<void>;
+}
+
+export { VirtualStorageAdapter };

package/dist/lib/fs/storage/virtual.d.ts

@@ -0,0 +1,66 @@
+import { BaseStorageAdapter, StorageAdapterOptions } from './base.js';
+import '@stryke/types/base';
+import '../../fs-Dg-aTfiN.js';
+import '@stryke/fs/resolve';
+
+/**
+ * Virtual/in-memory storage adapter implementation.
+ */
+declare class VirtualStorageAdapter extends BaseStorageAdapter {
+    /**
+     * A name identifying the storage adapter type.
+     */
+    name: string;
+    /**
+     * In-memory data storage.
+     */
+    protected data: Map<string, any>;
+    /**
+     * Constructor for the VirtualStorageAdapter.
+     *
+     * @param options - Configuration options for the storage adapter.
+     */
+    constructor(options?: StorageAdapterOptions);
+    /**
+     * Synchronously checks if a key exists in the storage.
+     *
+     * @param key - The key to check for existence.
+     * @returns Returns `true` if the key exists, otherwise `false`.
+     */
+    existsSync(key: string): boolean;
+    /**
+     * Synchronously retrieves the value associated with a given key.
+     *
+     * @param key - The key whose value is to be retrieved.
+     * @returns The value associated with the key, or `null` if the key does not exist.
+     */
+    getSync(key: string): string | null;
+    /**
+     * Synchronously sets the value for a given key.
+     *
+     * @param key - The key to set the value for.
+     * @param value - The value to set.
+     */
+    setSync(key: string, value: string): void;
+    /**
+     * Synchronously removes a key from the storage.
+     *
+     * @param key - The key to remove.
+     */
+    removeSync(key: string): void;
+    /**
+     * Lists all keys under a given base path synchronously.
+     *
+     * @param base - The base path to list keys from.
+     * @returns An array of keys under the specified base path.
+     */
+    listSync(base?: string): string[];
+    /**
+     * Disposes of the storage adapter, releasing any held resources.
+     *
+     * @returns A promise that resolves when the disposal is complete.
+     */
+    dispose(): Promise<void>;
+}
+
+export { VirtualStorageAdapter };

package/dist/lib/fs/storage/virtual.js

@@ -0,0 +1,3 @@
+export { VirtualStorageAdapter } from '../../chunk-ONETLSPO.js';
+import '../../chunk-VHCBD2IS.js';
+import '../../chunk-SHUYVCID.js';

package/dist/lib/fs/vfs.cjs

@@ -0,0 +1,16 @@
+'use strict';
+
+var chunkR33US3PV_cjs = require('../chunk-R33US3PV.cjs');
+require('../chunk-6OYSDQXE.cjs');
+require('../chunk-XUYQYUWZ.cjs');
+require('../chunk-XLHFUATD.cjs');
+require('../chunk-YYEAV24J.cjs');
+require('../chunk-JA4HSQRN.cjs');
+require('../chunk-USNT2KNT.cjs');
+
+
+
+Object.defineProperty(exports, "VirtualFileSystem", {
+  enumerable: true,
+  get: function () { return chunkR33US3PV_cjs.VirtualFileSystem; }
+});

package/dist/lib/fs/vfs.d.cts

@@ -0,0 +1,247 @@
+import { FlatCache } from 'flat-cache';
+import { C as Context } from '../config-Cqxh4V21.cjs';
+import { V as VirtualFileSystemInterface, d as VirtualFileMetadata, W as WriteOptions, R as ResolveOptions } from '../fs-Dg-aTfiN.cjs';
+import '@storm-software/build-tools/types';
+import '@storm-software/config-tools/types';
+import '@storm-software/config/types';
+import '@stryke/types/base';
+import '@stryke/types/configuration';
+import '@stryke/types/file';
+import 'c12';
+import 'vite';
+import '@farmfe/core';
+import '@rspack/core';
+import '@storm-software/tsup/types';
+import '@storm-software/unbuild/types';
+import 'esbuild';
+import 'rolldown';
+import 'rollup';
+import 'webpack';
+import '@stryke/env/get-env-paths';
+import '@stryke/types/package-json';
+import 'jest-worker';
+import 'jiti';
+import 'magic-string';
+import 'semver';
+import 'ts-morph';
+import 'unplugin';
+import '@stryke/types/array';
+import '../tsconfig-Bz-CiFqD.cjs';
+import '@stryke/types/tsconfig';
+import 'typescript';
+import '@stryke/fs/resolve';
+
+/**
+ * Represents a virtual file system (VFS) that stores files and their associated metadata in virtual memory.
+ *
+ * @remarks
+ * This class provides methods to manage virtual files, check their existence, retrieve their content, and manipulate the virtual file system. It allows for efficient file management and retrieval without relying on the actual file system.
+ */
+declare class VirtualFileSystem implements VirtualFileSystemInterface {
+    #private;
+    /**
+     * Creates a virtual file system (VFS) that is backed up to a Cap'n Proto message buffer.
+     *
+     * @param context - The context of the virtual file system, typically containing options and logging functions.
+     * @returns A promise that resolves to a new virtual file system instance.
+     */
+    static create(context: Context): Promise<VirtualFileSystem>;
+    /**
+     * Synchronously creates a virtual file system (VFS) that is backed up to a Cap'n Proto message buffer.
+     *
+     * @param context - The context of the virtual file system, typically containing options and logging functions.
+     * @returns A new virtual file system instance.
+     */
+    static createSync(context: Context): VirtualFileSystem;
+    /**
+     * A map of file ids to their metadata.
+     */
+    get metadata(): Readonly<Record<string, VirtualFileMetadata>>;
+    /**
+     * A map of file paths to their module ids.
+     */
+    get ids(): Readonly<Record<string, string>>;
+    /**
+     * A map of module ids to their file paths.
+     */
+    get paths(): Readonly<Record<string, string>>;
+    /**
+     * Gets the resolver cache.
+     */
+    protected get resolverCache(): FlatCache;
+    /**
+     * Creates a new instance of the {@link VirtualFileSystem}.
+     *
+     * @param context - The context of the virtual file system, typically containing options and logging functions.
+     * @param fs - A buffer containing the serialized virtual file system data.
+     */
+    private constructor();
+    /**
+     * Asynchronously checks if a file exists in the virtual file system (VFS).
+     *
+     * @param path - The path to the file.
+     * @returns A promise that resolves to `true` if the file exists, otherwise `false`.
+     */
+    exists(path: string): Promise<boolean>;
+    /**
+     * Synchronously checks if a file exists in the virtual file system (VFS).
+     *
+     * @param path - The path to the file.
+     * @returns `true` if the file exists, otherwise `false`.
+     */
+    existsSync(path: string): boolean;
+    /**
+     * Checks if a file is virtual in the virtual file system (VFS).
+     *
+     * @param path - The path to the file.
+     * @returns `true` if the file is virtual, otherwise `false`.
+     */
+    isVirtual(path: string): boolean;
+    /**
+     * Lists files in a given path.
+     *
+     * @param path - The path to list files from.
+     * @returns An array of file names in the specified path.
+     */
+    listSync(path?: string): string[];
+    /**
+     * Lists files in a given path.
+     *
+     * @param path - The path to list files from.
+     * @returns An array of file names in the specified path.
+     */
+    list(path?: string): Promise<string[]>;
+    /**
+     * Removes a file in the virtual file system (VFS).
+     *
+     * @param path - The path to create the directory at.
+     */
+    remove(path: string): Promise<void>;
+    /**
+     * Removes a file in the virtual file system (VFS).
+     *
+     * @param path - The path to create the directory at.
+     */
+    removeSync(path: string): void;
+    /**
+     * Glob files in the virtual file system (VFS) based on the provided pattern(s).
+     *
+     * @param patterns - A pattern (or multiple patterns) to use to determine the file paths to return
+     * @returns An array of file paths matching the provided pattern(s)
+     */
+    glob(patterns: string | string[]): Promise<string[]>;
+    /**
+     * Synchronously glob files in the virtual file system (VFS) based on the provided pattern(s).
+     *
+     * @param patterns - A pattern (or multiple patterns) to use to determine the file paths to return
+     * @returns An array of file paths matching the provided pattern(s)
+     */
+    globSync(patterns: string | string[]): string[];
+    /**
+     * Copies a file from one path to another in the virtual file system (VFS).
+     *
+     * @param srcPath - The source path to copy
+     * @param destPath - The destination path to copy to
+     */
+    copy(srcPath: string, destPath: string): Promise<void>;
+    /**
+     * Synchronously copies a file from one path to another in the virtual file system (VFS).
+     *
+     * @param srcPath - The source path to copy
+     * @param destPath - The destination path to copy to
+     */
+    copySync(srcPath: string, destPath: string): void;
+    /**
+     * Moves a file (or files) from one path to another in the virtual file system (VFS).
+     *
+     * @param srcPath - The source path to move
+     * @param destPath - The destination path to move to
+     */
+    move(srcPath: string, destPath: string): Promise<void>;
+    /**
+     * Synchronously moves a file (or files) from one path to another in the virtual file system (VFS).
+     *
+     * @param srcPath - The source path to move
+     * @param destPath - The destination path to move to
+     */
+    moveSync(srcPath: string, destPath: string): void;
+    /**
+     * Asynchronously reads a file from the virtual file system (VFS).
+     *
+     * @param path - The path or ID of the file to read.
+     * @returns A promise that resolves to the contents of the file as a string, or undefined if the file does not exist.
+     */
+    read(path: string): Promise<string | undefined>;
+    /**
+     * Synchronously reads a file from the virtual file system (VFS).
+     *
+     * @param path - The path or ID of the file to read.
+     * @returns The contents of the file as a string, or undefined if the file does not exist.
+     */
+    readSync(path: string): string | undefined;
+    /**
+     * Writes a file to the virtual file system (VFS).
+     *
+     * @param path - The path to the file.
+     * @param data - The contents of the file.
+     * @param options - Optional parameters for writing the file.
+     * @returns A promise that resolves when the file is written.
+     */
+    write(path: string, data?: string, options?: WriteOptions): Promise<void>;
+    /**
+     * Synchronously writes a file to the virtual file system (VFS).
+     *
+     * @param path - The file to write.
+     * @param data - The contents of the file.
+     * @param options - Optional parameters for writing the file.
+     */
+    writeSync(path: string, data?: string, options?: WriteOptions): void;
+    /**
+     * Retrieves the metadata of a file in the virtual file system (VFS).
+     *
+     * @param pathOrId - The path or ID of the file to retrieve metadata for.
+     * @returns The metadata of the file, or undefined if the file does not exist.
+     */
+    getMetadata(pathOrId: string): VirtualFileMetadata | undefined;
+    /**
+     * A helper function to resolve modules in the virtual file system (VFS).
+     *
+     * @remarks
+     * This function can be used to resolve modules relative to the project root directory.
+     *
+     * @example
+     * ```ts
+     * const resolved = await context.resolvePath("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.
+     */
+    resolve(id: string, importer?: string, options?: ResolveOptions): Promise<string | undefined>;
+    /**
+     * A synchronous helper function to resolve modules using the Jiti resolver
+     *
+     * @remarks
+     * This function can be used to resolve modules relative to the project root directory.
+     *
+     * @example
+     * ```ts
+     * const resolvedPath = context.resolveSync("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 The resolved module path.
+     */
+    resolveSync(id: string, importer?: string, options?: ResolveOptions): string | undefined;
+    /**
+     * Disposes of the virtual file system (VFS) by saving its state to disk.
+     */
+    dispose(): Promise<void>;
+    [Symbol.asyncDispose](): Promise<void>;
+}
+
+export { VirtualFileSystem };