@powerlines/plugin-env 0.15.2 → 0.15.4

package/dist/powerlines/src/lib/utilities/bundle.mjs

@@ -1,34 +0,0 @@
-import { extractESBuildConfig } from "../build/esbuild.mjs";
-import { LogLevelLabel } from "@storm-software/config-tools/types";
-import { build } from "esbuild";
-
-//#region ../powerlines/src/lib/utilities/bundle.ts
-/**
-* Bundle a type definition to a module.
-*
-* @param context - The context object containing the environment paths.
-* @param file - The file path to bundle.
-* @param overrides - Optional overrides for the ESBuild configuration.
-* @returns A promise that resolves to the bundled module.
-*/
-async function bundle(context, file, overrides = {}) {
-	const path = await context.fs.resolve(file);
-	if (!path || !context.fs.existsSync(path)) throw new Error(`Module not found: "${file}". Please check the path and try again.`);
-	const result = await build({
-		...extractESBuildConfig(context),
-		entryPoints: [path],
-		write: false,
-		sourcemap: false,
-		splitting: false,
-		treeShaking: false,
-		bundle: true,
-		...overrides
-	});
-	if (result.errors.length > 0) throw new Error(`Failed to transpile ${file}: ${result.errors.map((error) => error.text).join(", ")}`);
-	if (result.warnings.length > 0) context.log(LogLevelLabel.WARN, `Warnings while transpiling ${file}: ${result.warnings.map((warning) => warning.text).join(", ")}`);
-	if (!result.outputFiles || result.outputFiles.filter(Boolean).length === 0) throw new Error(`No output files generated for ${file}. Please check the configuration and try again.`);
-	return result.outputFiles.filter(Boolean)[0];
-}
-
-//#endregion
-export { bundle };

package/dist/powerlines/src/lib/utilities/resolve.cjs

@@ -1,30 +0,0 @@
-const require_rolldown_runtime = require('../../../../_virtual/rolldown_runtime.cjs');
-const require_bundle = require('./bundle.cjs');
-let __stryke_type_checks_is_set_string = require("@stryke/type-checks/is-set-string");
-let __stryke_convert_parse_type_definition = require("@stryke/convert/parse-type-definition");
-
-//#region ../powerlines/src/lib/utilities/resolve.ts
-/**
-* Compiles a type definition to a module.
-*
-* @param context - The context object containing the environment paths.
-* @param type - The type definition to compile. This can be either a string or a {@link TypeDefinition} object.
-* @param overrides - Optional overrides for the ESBuild configuration.
-* @returns A promise that resolves to the compiled module.
-*/
-async function resolve(context, type, overrides = {}) {
-	let typeDefinition;
-	if ((0, __stryke_type_checks_is_set_string.isSetString)(type)) typeDefinition = (0, __stryke_convert_parse_type_definition.parseTypeDefinition)(type);
-	else typeDefinition = type;
-	const result = await require_bundle.bundle(context, typeDefinition.file, overrides);
-	const resolved = await context.resolver.evalModule(result.text, {
-		filename: result.path,
-		forceTranspile: true
-	});
-	let exportName = typeDefinition.name;
-	if (!exportName) exportName = "default";
-	return resolved[exportName] ?? resolved[`__Ω${exportName}`];
-}
-
-//#endregion
-exports.resolve = resolve;

package/dist/powerlines/src/lib/utilities/resolve.mjs

@@ -1,29 +0,0 @@
-import { bundle } from "./bundle.mjs";
-import { isSetString } from "@stryke/type-checks/is-set-string";
-import { parseTypeDefinition } from "@stryke/convert/parse-type-definition";
-
-//#region ../powerlines/src/lib/utilities/resolve.ts
-/**
-* Compiles a type definition to a module.
-*
-* @param context - The context object containing the environment paths.
-* @param type - The type definition to compile. This can be either a string or a {@link TypeDefinition} object.
-* @param overrides - Optional overrides for the ESBuild configuration.
-* @returns A promise that resolves to the compiled module.
-*/
-async function resolve(context, type, overrides = {}) {
-	let typeDefinition;
-	if (isSetString(type)) typeDefinition = parseTypeDefinition(type);
-	else typeDefinition = type;
-	const result = await bundle(context, typeDefinition.file, overrides);
-	const resolved = await context.resolver.evalModule(result.text, {
-		filename: result.path,
-		forceTranspile: true
-	});
-	let exportName = typeDefinition.name;
-	if (!exportName) exportName = "default";
-	return resolved[exportName] ?? resolved[`__Ω${exportName}`];
-}
-
-//#endregion
-export { resolve };

package/dist/powerlines/src/plugin-utils/paths.cjs

@@ -1 +0,0 @@
-let __stryke_path_replace = require("@stryke/path/replace");

package/dist/powerlines/src/plugin-utils/paths.mjs

@@ -1,3 +0,0 @@
-import { replacePath } from "@stryke/path/replace";
-
-export {  };

package/dist/powerlines/src/types/api.d.mts

@@ -1,5 +0,0 @@
-import "./hooks.mjs";
-import "./context.mjs";
-import "./config.mjs";
-import "./resolved.mjs";
-import "../internal/helpers/hooks.mjs";

package/dist/powerlines/src/types/babel.d.cts

@@ -1,23 +0,0 @@
-import { Context } from "./context.cjs";
-import { LogFn } from "./config.cjs";
-import { PluginItem, PluginObj, PluginPass } from "@babel/core";
-import { BabelAPI } from "@babel/helper-plugin-utils";
-
-//#region ../powerlines/src/types/babel.d.ts
-
-type BabelPluginPass<TState = unknown> = PluginPass & TState;
-type BabelTransformPluginFilter = (code: string, id: string) => boolean;
-type BabelTransformPlugin<TContext extends Context = Context, TOptions extends Record<string, any> = Record<string, any>, TState = unknown> = ((context: TContext) => (options: {
-  name: string;
-  log: LogFn;
-  api: BabelAPI;
-  options: TOptions;
-  context: TContext;
-  dirname: string;
-}) => PluginObj<TOptions & BabelPluginPass<TState>>) & {
-  $$name: string;
-};
-type BabelTransformPluginOptions<TContext extends Context = Context, TOptions extends Record<string, any> = Record<string, any>, TState = unknown> = PluginItem | BabelTransformPlugin<TContext, TOptions, TState> | [BabelTransformPlugin<TContext, TOptions, TState>, TOptions] | [BabelTransformPlugin<TContext, TOptions, TState>, TOptions, BabelTransformPluginFilter];
-type DeclareBabelTransformPluginReturn<TContext extends Context = Context, TOptions extends Record<string, any> = Record<string, any>, TState = any> = Omit<BabelTransformPlugin<TContext, TOptions, TState>, "$$name"> & Required<Pick<BabelTransformPlugin<TContext, TOptions, TState>, "$$name">>;
-//#endregion
-export { BabelTransformPluginOptions, DeclareBabelTransformPluginReturn };

package/dist/powerlines/src/types/babel.d.mts

@@ -1,23 +0,0 @@
-import { Context } from "./context.mjs";
-import { LogFn } from "./config.mjs";
-import { PluginItem, PluginObj, PluginPass } from "@babel/core";
-import { BabelAPI } from "@babel/helper-plugin-utils";
-
-//#region ../powerlines/src/types/babel.d.ts
-
-type BabelPluginPass<TState = unknown> = PluginPass & TState;
-type BabelTransformPluginFilter = (code: string, id: string) => boolean;
-type BabelTransformPlugin<TContext extends Context = Context, TOptions extends Record<string, any> = Record<string, any>, TState = unknown> = ((context: TContext) => (options: {
-  name: string;
-  log: LogFn;
-  api: BabelAPI;
-  options: TOptions;
-  context: TContext;
-  dirname: string;
-}) => PluginObj<TOptions & BabelPluginPass<TState>>) & {
-  $$name: string;
-};
-type BabelTransformPluginOptions<TContext extends Context = Context, TOptions extends Record<string, any> = Record<string, any>, TState = unknown> = PluginItem | BabelTransformPlugin<TContext, TOptions, TState> | [BabelTransformPlugin<TContext, TOptions, TState>, TOptions] | [BabelTransformPlugin<TContext, TOptions, TState>, TOptions, BabelTransformPluginFilter];
-type DeclareBabelTransformPluginReturn<TContext extends Context = Context, TOptions extends Record<string, any> = Record<string, any>, TState = any> = Omit<BabelTransformPlugin<TContext, TOptions, TState>, "$$name"> & Required<Pick<BabelTransformPlugin<TContext, TOptions, TState>, "$$name">>;
-//#endregion
-export { BabelPluginPass, BabelTransformPlugin, BabelTransformPluginFilter, BabelTransformPluginOptions, DeclareBabelTransformPluginReturn };

package/dist/powerlines/src/types/build.d.cts

@@ -1,145 +0,0 @@
-//#region ../powerlines/src/types/build.d.ts
-
-type UnpluginBuildVariant = "rollup" | "webpack" | "rspack" | "vite" | "esbuild" | "farm" | "unloader" | "rolldown";
-interface BuildConfig {
-  /**
-   * The platform to build the project for
-   *
-   * @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.
-   *
-   * @defaultValue `['browser', 'module', 'jsnext:main', 'jsnext']`
-   */
-  mainFields?: string[];
-  /**
-   * Array of strings indicating what conditions should be used for module resolution.
-   */
-  conditions?: string[];
-  /**
-   * Array of strings indicating what file extensions should be used for module resolution.
-   *
-   * @defaultValue `['.mjs', '.js', '.mts', '.ts', '.jsx', '.tsx', '.json']`
-   */
-  extensions?: string[];
-  /**
-   * Array of strings indicating what modules should be deduplicated to a single version in the build.
-   *
-   * @remarks
-   * This option is useful for ensuring that only one version of a module is included in the bundle, which can help reduce bundle size and avoid conflicts.
-   */
-  dedupe?: string[];
-  /**
-   * Array of strings or regular expressions that indicate what modules are builtin for the environment.
-   */
-  builtins?: (string | RegExp)[];
-  /**
-   * Define global variable replacements.
-   *
-   * @remarks
-   * This option allows you to specify global constants that will be replaced in the code during the build process. It is similar to the `define` option in esbuild and Vite, enabling you to replace specific identifiers with constant expressions at build time.
-   *
-   * @example
-   * ```ts
-   * {
-   *   define: {
-   *     __VERSION__: '"1.0.0"',
-   *     __DEV__: 'process.env.NODE_ENV !== "production"'
-   *   }
-   * }
-   * ```
-   *
-   * @see https://esbuild.github.io/api/#define
-   * @see https://vitejs.dev/config/build-options.html#define
-   * @see https://github.com/rollup/plugins/tree/master/packages/replace
-   */
-  define?: Record<string, any>;
-  /**
-   * Global variables that will have import statements injected where necessary
-   *
-   * @remarks
-   * This option allows you to specify global variables that should be automatically imported from specified modules whenever they are used in the code. This is particularly useful for polyfilling Node.js globals in a browser environment.
-   *
-   * @example
-   * ```ts
-   * {
-   *   inject: {
-   *     process: 'process/browser',
-   *     Buffer: ['buffer', 'Buffer'],
-   *   }
-   * }
-   * ```
-   *
-   * @see https://github.com/rollup/plugins/tree/master/packages/inject
-   */
-  inject?: Record<string, string | string[]>;
-  /**
-   * The alias mappings to use for module resolution during the build process.
-   *
-   * @remarks
-   * This option allows you to define custom path aliases for modules, which can be useful for simplifying imports and managing dependencies.
-   *
-   * @example
-   * ```ts
-   * {
-   *   alias: {
-   *     "@utils": "./src/utils",
-   *     "@components": "./src/components"
-   *   }
-   * }
-   * ```
-   *
-   * @see https://github.com/rollup/plugins/tree/master/packages/alias
-   */
-  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.
-   *
-   * @remarks
-   * This option is useful for excluding specific modules from the bundle, such as Node.js built-in modules or other libraries that should not be bundled.
-   */
-  external?: (string | RegExp)[];
-  /**
-   * A list of modules that should always be bundled, even if they are external dependencies.
-   */
-  noExternal?: (string | RegExp)[];
-  /**
-   * Should the Powerlines CLI processes skip bundling the `node_modules` directory?
-   */
-  skipNodeModulesBundle?: boolean;
-  /**
-   * If true, `process.env` referenced in code will be preserved as-is and evaluated in runtime. Otherwise, it is statically replaced as an empty object.
-   *
-   * @defaultValue false
-   */
-  keepProcessEnv?: boolean;
-  /**
-   * An optional set of override options to apply to the selected build variant.
-   *
-   * @remarks
-   * This option allows you to provide configuration options with the guarantee that they will **not** be overridden and will take precedence over other build configurations.
-   */
-  override?: Record<string, any>;
-}
-type BuildResolvedConfig = Omit<BuildConfig, "override">;
-//#endregion
-export { BuildConfig, BuildResolvedConfig, UnpluginBuildVariant };

package/dist/powerlines/src/types/build.d.mts

@@ -1,147 +0,0 @@
-import "esbuild";
-
-//#region ../powerlines/src/types/build.d.ts
-
-type UnpluginBuildVariant = "rollup" | "webpack" | "rspack" | "vite" | "esbuild" | "farm" | "unloader" | "rolldown";
-interface BuildConfig {
-  /**
-   * The platform to build the project for
-   *
-   * @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.
-   *
-   * @defaultValue `['browser', 'module', 'jsnext:main', 'jsnext']`
-   */
-  mainFields?: string[];
-  /**
-   * Array of strings indicating what conditions should be used for module resolution.
-   */
-  conditions?: string[];
-  /**
-   * Array of strings indicating what file extensions should be used for module resolution.
-   *
-   * @defaultValue `['.mjs', '.js', '.mts', '.ts', '.jsx', '.tsx', '.json']`
-   */
-  extensions?: string[];
-  /**
-   * Array of strings indicating what modules should be deduplicated to a single version in the build.
-   *
-   * @remarks
-   * This option is useful for ensuring that only one version of a module is included in the bundle, which can help reduce bundle size and avoid conflicts.
-   */
-  dedupe?: string[];
-  /**
-   * Array of strings or regular expressions that indicate what modules are builtin for the environment.
-   */
-  builtins?: (string | RegExp)[];
-  /**
-   * Define global variable replacements.
-   *
-   * @remarks
-   * This option allows you to specify global constants that will be replaced in the code during the build process. It is similar to the `define` option in esbuild and Vite, enabling you to replace specific identifiers with constant expressions at build time.
-   *
-   * @example
-   * ```ts
-   * {
-   *   define: {
-   *     __VERSION__: '"1.0.0"',
-   *     __DEV__: 'process.env.NODE_ENV !== "production"'
-   *   }
-   * }
-   * ```
-   *
-   * @see https://esbuild.github.io/api/#define
-   * @see https://vitejs.dev/config/build-options.html#define
-   * @see https://github.com/rollup/plugins/tree/master/packages/replace
-   */
-  define?: Record<string, any>;
-  /**
-   * Global variables that will have import statements injected where necessary
-   *
-   * @remarks
-   * This option allows you to specify global variables that should be automatically imported from specified modules whenever they are used in the code. This is particularly useful for polyfilling Node.js globals in a browser environment.
-   *
-   * @example
-   * ```ts
-   * {
-   *   inject: {
-   *     process: 'process/browser',
-   *     Buffer: ['buffer', 'Buffer'],
-   *   }
-   * }
-   * ```
-   *
-   * @see https://github.com/rollup/plugins/tree/master/packages/inject
-   */
-  inject?: Record<string, string | string[]>;
-  /**
-   * The alias mappings to use for module resolution during the build process.
-   *
-   * @remarks
-   * This option allows you to define custom path aliases for modules, which can be useful for simplifying imports and managing dependencies.
-   *
-   * @example
-   * ```ts
-   * {
-   *   alias: {
-   *     "@utils": "./src/utils",
-   *     "@components": "./src/components"
-   *   }
-   * }
-   * ```
-   *
-   * @see https://github.com/rollup/plugins/tree/master/packages/alias
-   */
-  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.
-   *
-   * @remarks
-   * This option is useful for excluding specific modules from the bundle, such as Node.js built-in modules or other libraries that should not be bundled.
-   */
-  external?: (string | RegExp)[];
-  /**
-   * A list of modules that should always be bundled, even if they are external dependencies.
-   */
-  noExternal?: (string | RegExp)[];
-  /**
-   * Should the Powerlines CLI processes skip bundling the `node_modules` directory?
-   */
-  skipNodeModulesBundle?: boolean;
-  /**
-   * If true, `process.env` referenced in code will be preserved as-is and evaluated in runtime. Otherwise, it is statically replaced as an empty object.
-   *
-   * @defaultValue false
-   */
-  keepProcessEnv?: boolean;
-  /**
-   * An optional set of override options to apply to the selected build variant.
-   *
-   * @remarks
-   * This option allows you to provide configuration options with the guarantee that they will **not** be overridden and will take precedence over other build configurations.
-   */
-  override?: Record<string, any>;
-}
-type BuildResolvedConfig = Omit<BuildConfig, "override">;
-//#endregion
-export { BuildConfig, BuildResolvedConfig, UnpluginBuildVariant };

package/dist/powerlines/src/types/commands.d.cts

@@ -1,8 +0,0 @@
-import { MaybePromise } from "@stryke/types/base";
-import { ArrayValues } from "@stryke/types/array";
-
-//#region ../powerlines/src/types/commands.d.ts
-declare const SUPPORTED_COMMANDS: readonly ["new", "clean", "prepare", "lint", "test", "build", "docs", "deploy", "finalize"];
-type CommandType = ArrayValues<typeof SUPPORTED_COMMANDS>;
-//#endregion
-export { CommandType };

package/dist/powerlines/src/types/commands.d.mts

@@ -1,9 +0,0 @@
-import "./context.mjs";
-import { MaybePromise } from "@stryke/types/base";
-import { ArrayValues } from "@stryke/types/array";
-
-//#region ../powerlines/src/types/commands.d.ts
-declare const SUPPORTED_COMMANDS: readonly ["new", "clean", "prepare", "lint", "test", "build", "docs", "deploy", "finalize"];
-type CommandType = ArrayValues<typeof SUPPORTED_COMMANDS>;
-//#endregion
-export { CommandType, SUPPORTED_COMMANDS };