powerlines 0.24.8 → 0.25.0

package/dist/lib/entry.d.cts

@@ -1,5 +1,5 @@
 import { TypeDefinition, TypeDefinitionParameter } from '@stryke/types/configuration';
-import { C as Context, g as ResolvedEntryTypeDefinition } from './config-D8KrE7SZ.cjs';
+import { C as Context, R as ResolvedEntryTypeDefinition } from './config-Cqxh4V21.cjs';
 import '@storm-software/build-tools/types';
 import '@storm-software/config-tools/types';
 import '@storm-software/config/types';
@@ -23,8 +23,8 @@ import 'magic-string';
 import 'semver';
 import 'ts-morph';
 import 'unplugin';
+import './fs-Dg-aTfiN.cjs';
 import '@stryke/fs/resolve';
-import 'node:fs';
 import '@stryke/types/array';
 import './tsconfig-Bz-CiFqD.cjs';
 import '@stryke/types/tsconfig';

package/dist/lib/entry.d.ts

@@ -1,5 +1,5 @@
 import { TypeDefinition, TypeDefinitionParameter } from '@stryke/types/configuration';
-import { C as Context, g as ResolvedEntryTypeDefinition } from './config-DBIFdRoq.js';
+import { C as Context, R as ResolvedEntryTypeDefinition } from './config-D-WwQL-4.js';
 import '@storm-software/build-tools/types';
 import '@storm-software/config-tools/types';
 import '@storm-software/config/types';
@@ -23,8 +23,8 @@ import 'magic-string';
 import 'semver';
 import 'ts-morph';
 import 'unplugin';
+import './fs-Dg-aTfiN.js';
 import '@stryke/fs/resolve';
-import 'node:fs';
 import '@stryke/types/array';
 import './tsconfig-Bz-CiFqD.js';
 import '@stryke/types/tsconfig';

package/dist/lib/entry.js

@@ -1,2 +1,2 @@
-export { getUniqueEntries, resolveEntries, resolveEntriesSync, resolveEntry, resolveEntryInput, resolveEntryInputFile, resolveEntryOutput, resolveVirtualEntry } from './chunk-XZFEHPYE.js';
+export { getUniqueEntries, resolveEntries, resolveEntriesSync, resolveEntry, resolveEntryInput, resolveEntryInputFile, resolveEntryOutput, resolveVirtualEntry } from './chunk-N5YLKWC2.js';
 import './chunk-SHUYVCID.js';

package/dist/lib/fs/helpers.cjs

@@ -0,0 +1,47 @@
+'use strict';
+
+var chunkYYEAV24J_cjs = require('../chunk-YYEAV24J.cjs');
+require('../chunk-USNT2KNT.cjs');
+
+
+
+Object.defineProperty(exports, "filterKeyByBase", {
+  enumerable: true,
+  get: function () { return chunkYYEAV24J_cjs.filterKeyByBase; }
+});
+Object.defineProperty(exports, "ignoreExists", {
+  enumerable: true,
+  get: function () { return chunkYYEAV24J_cjs.ignoreExists; }
+});
+Object.defineProperty(exports, "ignoreNotfound", {
+  enumerable: true,
+  get: function () { return chunkYYEAV24J_cjs.ignoreNotfound; }
+});
+Object.defineProperty(exports, "isFileError", {
+  enumerable: true,
+  get: function () { return chunkYYEAV24J_cjs.isFileError; }
+});
+Object.defineProperty(exports, "isValidId", {
+  enumerable: true,
+  get: function () { return chunkYYEAV24J_cjs.isValidId; }
+});
+Object.defineProperty(exports, "normalizeBaseKey", {
+  enumerable: true,
+  get: function () { return chunkYYEAV24J_cjs.normalizeBaseKey; }
+});
+Object.defineProperty(exports, "normalizeId", {
+  enumerable: true,
+  get: function () { return chunkYYEAV24J_cjs.normalizeId; }
+});
+Object.defineProperty(exports, "normalizeKey", {
+  enumerable: true,
+  get: function () { return chunkYYEAV24J_cjs.normalizeKey; }
+});
+Object.defineProperty(exports, "normalizePath", {
+  enumerable: true,
+  get: function () { return chunkYYEAV24J_cjs.normalizePath; }
+});
+Object.defineProperty(exports, "toFilePath", {
+  enumerable: true,
+  get: function () { return chunkYYEAV24J_cjs.toFilePath; }
+});

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

@@ -0,0 +1,74 @@
+import { PathOrFileDescriptor } from 'node:fs';
+
+/**
+ * Checks if an error is a file system error.
+ *
+ * @param err - The error to check.
+ * @returns `true` if the error is a file system error, otherwise `false`.
+ */
+declare function isFileError(err: any): unknown;
+/**
+ * Ignores file not found errors.
+ *
+ * @param err - The error to check.
+ * @returns `null` if the error is a file not found error, otherwise returns the error.
+ */
+declare function ignoreNotfound(err: any): any;
+/**
+ * Ignores file exists errors.
+ *
+ * @param err - The error to check.
+ * @returns `null` if the error is a file exists error, otherwise returns the error.
+ */
+declare function ignoreExists(err: any): any;
+declare function toFilePath(path: PathOrFileDescriptor): string;
+/**
+ * Checks if a given file id is valid based on the specified prefix.
+ *
+ * @param id - The file ID to check.
+ * @param prefix - The prefix to use for built-in files. Default is "powerlines".
+ * @returns `true` if the file ID is valid, otherwise `false`.
+ */
+declare function isValidId(id: string, prefix?: string): boolean;
+/**
+ * Formats a file id by removing the file extension and prepending the runtime prefix.
+ *
+ * @param id - The file ID to format.
+ * @param prefix - The prefix to use for built-in files. Default is "powerlines".
+ * @returns The formatted file ID.
+ */
+declare function normalizeId(id: string, prefix?: string): string;
+/**
+ * Normalizes a given path by resolving it against the project root, workspace root, and built-ins path.
+ *
+ * @param path - The path to normalize.
+ * @param builtinsPath - The path to built-in files.
+ * @param prefix - The prefix to use for built-in files. Default is "powerlines".
+ * @returns The normalized path.
+ */
+declare function normalizePath(path: string, builtinsPath: string, prefix?: string): string;
+/**
+ * Normalizes a storage key by replacing all path separators with the specified separator.
+ *
+ * @param key - The storage key to normalize.
+ * @param sep - The separator to use for normalization. Default is ":".
+ * @returns The normalized storage key.
+ */
+declare function normalizeKey(key: string | undefined, sep?: ":" | "/"): string;
+/**
+ * Normalizes the base key for storage operations.
+ *
+ * @param base - The base key to normalize.
+ * @returns The normalized base key with a trailing colon if not empty.
+ */
+declare function normalizeBaseKey(base?: string): string;
+/**
+ * Filters a storage key based on the specified base path.
+ *
+ * @param key - The storage key to filter.
+ * @param base - The base path to filter by.
+ * @returns `true` if the key matches the base path criteria, otherwise `false`.
+ */
+declare function filterKeyByBase(key: string, base: string | undefined): boolean;
+
+export { filterKeyByBase, ignoreExists, ignoreNotfound, isFileError, isValidId, normalizeBaseKey, normalizeId, normalizeKey, normalizePath, toFilePath };

package/dist/lib/fs/helpers.d.ts

@@ -0,0 +1,74 @@
+import { PathOrFileDescriptor } from 'node:fs';
+
+/**
+ * Checks if an error is a file system error.
+ *
+ * @param err - The error to check.
+ * @returns `true` if the error is a file system error, otherwise `false`.
+ */
+declare function isFileError(err: any): unknown;
+/**
+ * Ignores file not found errors.
+ *
+ * @param err - The error to check.
+ * @returns `null` if the error is a file not found error, otherwise returns the error.
+ */
+declare function ignoreNotfound(err: any): any;
+/**
+ * Ignores file exists errors.
+ *
+ * @param err - The error to check.
+ * @returns `null` if the error is a file exists error, otherwise returns the error.
+ */
+declare function ignoreExists(err: any): any;
+declare function toFilePath(path: PathOrFileDescriptor): string;
+/**
+ * Checks if a given file id is valid based on the specified prefix.
+ *
+ * @param id - The file ID to check.
+ * @param prefix - The prefix to use for built-in files. Default is "powerlines".
+ * @returns `true` if the file ID is valid, otherwise `false`.
+ */
+declare function isValidId(id: string, prefix?: string): boolean;
+/**
+ * Formats a file id by removing the file extension and prepending the runtime prefix.
+ *
+ * @param id - The file ID to format.
+ * @param prefix - The prefix to use for built-in files. Default is "powerlines".
+ * @returns The formatted file ID.
+ */
+declare function normalizeId(id: string, prefix?: string): string;
+/**
+ * Normalizes a given path by resolving it against the project root, workspace root, and built-ins path.
+ *
+ * @param path - The path to normalize.
+ * @param builtinsPath - The path to built-in files.
+ * @param prefix - The prefix to use for built-in files. Default is "powerlines".
+ * @returns The normalized path.
+ */
+declare function normalizePath(path: string, builtinsPath: string, prefix?: string): string;
+/**
+ * Normalizes a storage key by replacing all path separators with the specified separator.
+ *
+ * @param key - The storage key to normalize.
+ * @param sep - The separator to use for normalization. Default is ":".
+ * @returns The normalized storage key.
+ */
+declare function normalizeKey(key: string | undefined, sep?: ":" | "/"): string;
+/**
+ * Normalizes the base key for storage operations.
+ *
+ * @param base - The base key to normalize.
+ * @returns The normalized base key with a trailing colon if not empty.
+ */
+declare function normalizeBaseKey(base?: string): string;
+/**
+ * Filters a storage key based on the specified base path.
+ *
+ * @param key - The storage key to filter.
+ * @param base - The base path to filter by.
+ * @returns `true` if the key matches the base path criteria, otherwise `false`.
+ */
+declare function filterKeyByBase(key: string, base: string | undefined): boolean;
+
+export { filterKeyByBase, ignoreExists, ignoreNotfound, isFileError, isValidId, normalizeBaseKey, normalizeId, normalizeKey, normalizePath, toFilePath };

package/dist/lib/fs/helpers.js

@@ -0,0 +1,2 @@
+export { filterKeyByBase, ignoreExists, ignoreNotfound, isFileError, isValidId, normalizeBaseKey, normalizeId, normalizeKey, normalizePath, toFilePath } from '../chunk-KFDNKOXM.js';
+import '../chunk-SHUYVCID.js';

package/dist/lib/fs/index.cjs

@@ -0,0 +1,17 @@
+'use strict';
+
+require('../chunk-K2SFTPN3.cjs');
+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/index.d.cts

@@ -0,0 +1,33 @@
+export { VirtualFileSystem } from './vfs.cjs';
+import 'flat-cache';
+import '../config-Cqxh4V21.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 '../fs-Dg-aTfiN.cjs';
+import '@stryke/fs/resolve';
+import '@stryke/types/array';
+import '../tsconfig-Bz-CiFqD.cjs';
+import '@stryke/types/tsconfig';
+import 'typescript';

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

@@ -0,0 +1,33 @@
+export { VirtualFileSystem } from './vfs.js';
+import 'flat-cache';
+import '../config-D-WwQL-4.js';
+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 '../fs-Dg-aTfiN.js';
+import '@stryke/fs/resolve';
+import '@stryke/types/array';
+import '../tsconfig-Bz-CiFqD.js';
+import '@stryke/types/tsconfig';
+import 'typescript';

package/dist/lib/fs/index.js

@@ -0,0 +1,8 @@
+import '../chunk-NQAHFTUW.js';
+export { VirtualFileSystem } from '../chunk-OBA5U4Y2.js';
+import '../chunk-L56XA427.js';
+import '../chunk-ONETLSPO.js';
+import '../chunk-VHCBD2IS.js';
+import '../chunk-KFDNKOXM.js';
+import '../chunk-ENRLU4UR.js';
+import '../chunk-SHUYVCID.js';

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

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

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

@@ -0,0 +1,138 @@
+import { MaybePromise } from '@stryke/types/base';
+import { S as StorageAdapter } from '../../fs-Dg-aTfiN.cjs';
+import '@stryke/fs/resolve';
+
+interface StorageAdapterOptions {
+    base: string;
+    isReadOnly?: boolean;
+    ignore?: string | string[];
+}
+/**
+ * Abstract base class for storage adapters, providing a template for storage operations.
+ */
+declare abstract class BaseStorageAdapter<TOptions extends StorageAdapterOptions = StorageAdapterOptions> implements StorageAdapter {
+    #private;
+    /**
+     * A name identifying the storage adapter type.
+     */
+    abstract name: string;
+    /**
+     * Configuration options for the storage adapter.
+     */
+    options: TOptions;
+    /**
+     * Constructor for the BaseStorageAdapter.
+     *
+     * @param options - Configuration options for the storage adapter.
+     */
+    constructor(options?: TOptions);
+    /**
+     * 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`.
+     */
+    abstract 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.
+     */
+    abstract 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.
+     */
+    abstract 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.
+     */
+    abstract removeSync(key: string): void;
+    /**
+     * Asynchronously removes a key from the storage.
+     *
+     * @param key - The key to remove.
+     */
+    remove(key: string): Promise<void>;
+    /**
+     * Synchronously removes all entries from the storage that match the provided base path.
+     *
+     * @param base - The base path to clear keys from.
+     */
+    clearSync(base?: string): void;
+    /**
+     * Asynchronously removes all entries from the storage that match the provided base path.
+     *
+     * @param base - The base path to clear keys from.
+     * @returns A promise that resolves when the operation is complete.
+     */
+    clear(base?: 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.
+     */
+    abstract 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[]>;
+    /**
+     * Disposes of the storage adapter, releasing any held resources.
+     *
+     * @returns A promise that resolves when the disposal is complete.
+     */
+    dispose(): MaybePromise<void>;
+    /**
+     * Async dispose method to clean up resources.
+     *
+     * @returns A promise that resolves when disposal is complete.
+     */
+    [Symbol.asyncDispose](): Promise<void>;
+    /**
+     * Resolves a given key to its full path within the storage adapter.
+     *
+     * @param key - The key to resolve.
+     * @returns The resolved full path for the key.
+     */
+    protected resolve(key?: string): string;
+    /**
+     * Disposes of the storage adapter, releasing any held resources.
+     *
+     * @returns A promise that resolves when the disposal is complete.
+     */
+    protected _dispose(): Promise<void>;
+}
+declare type __ΩStorageAdapterOptions = any[];
+
+export { BaseStorageAdapter, type StorageAdapterOptions, type __ΩStorageAdapterOptions };

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

@@ -0,0 +1,138 @@
+import { MaybePromise } from '@stryke/types/base';
+import { S as StorageAdapter } from '../../fs-Dg-aTfiN.js';
+import '@stryke/fs/resolve';
+
+interface StorageAdapterOptions {
+    base: string;
+    isReadOnly?: boolean;
+    ignore?: string | string[];
+}
+/**
+ * Abstract base class for storage adapters, providing a template for storage operations.
+ */
+declare abstract class BaseStorageAdapter<TOptions extends StorageAdapterOptions = StorageAdapterOptions> implements StorageAdapter {
+    #private;
+    /**
+     * A name identifying the storage adapter type.
+     */
+    abstract name: string;
+    /**
+     * Configuration options for the storage adapter.
+     */
+    options: TOptions;
+    /**
+     * Constructor for the BaseStorageAdapter.
+     *
+     * @param options - Configuration options for the storage adapter.
+     */
+    constructor(options?: TOptions);
+    /**
+     * 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`.
+     */
+    abstract 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.
+     */
+    abstract 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.
+     */
+    abstract 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.
+     */
+    abstract removeSync(key: string): void;
+    /**
+     * Asynchronously removes a key from the storage.
+     *
+     * @param key - The key to remove.
+     */
+    remove(key: string): Promise<void>;
+    /**
+     * Synchronously removes all entries from the storage that match the provided base path.
+     *
+     * @param base - The base path to clear keys from.
+     */
+    clearSync(base?: string): void;
+    /**
+     * Asynchronously removes all entries from the storage that match the provided base path.
+     *
+     * @param base - The base path to clear keys from.
+     * @returns A promise that resolves when the operation is complete.
+     */
+    clear(base?: 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.
+     */
+    abstract 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[]>;
+    /**
+     * Disposes of the storage adapter, releasing any held resources.
+     *
+     * @returns A promise that resolves when the disposal is complete.
+     */
+    dispose(): MaybePromise<void>;
+    /**
+     * Async dispose method to clean up resources.
+     *
+     * @returns A promise that resolves when disposal is complete.
+     */
+    [Symbol.asyncDispose](): Promise<void>;
+    /**
+     * Resolves a given key to its full path within the storage adapter.
+     *
+     * @param key - The key to resolve.
+     * @returns The resolved full path for the key.
+     */
+    protected resolve(key?: string): string;
+    /**
+     * Disposes of the storage adapter, releasing any held resources.
+     *
+     * @returns A promise that resolves when the disposal is complete.
+     */
+    protected _dispose(): Promise<void>;
+}
+declare type __ΩStorageAdapterOptions = any[];
+
+export { BaseStorageAdapter, type StorageAdapterOptions, type __ΩStorageAdapterOptions };

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

@@ -0,0 +1,2 @@
+export { BaseStorageAdapter } from '../../chunk-VHCBD2IS.js';
+import '../../chunk-SHUYVCID.js';

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

@@ -0,0 +1,13 @@
+'use strict';
+
+var chunk6OYSDQXE_cjs = require('../../chunk-6OYSDQXE.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; }
+});