@powerlines/plugin-webpack 0.5.125 → 0.5.127

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

@@ -1 +1,148 @@
-const e=require(`../../../_virtual/rolldown_runtime.cjs`),t=require(`../types/build.cjs`),n=require(`../types/plugin.cjs`);let r=require(`@stryke/type-checks/is-function`),i=require(`@stryke/type-checks/is-set-object`),a=require(`@stryke/type-checks/is-set-string`),o=require(`@stryke/type-checks/is-undefined`);function s(e){return(0,i.isSetObject)(e)&&`name`in e&&(0,a.isSetString)(e.name)&&((0,o.isUndefined)(e.api)||`api`in e&&(0,i.isSetObject)(e.api))&&((0,o.isUndefined)(e.applyToEnvironment)||`applyToEnvironment`in e&&(0,r.isFunction)(e.applyToEnvironment))&&((0,o.isUndefined)(e.dedupe)||`dedupe`in e&&(0,r.isFunction)(e.dedupe))&&n.KNOWN_HOOKS.every(t=>(0,o.isUndefined)(e[t])||t in e&&(f(e[t])||t===`config`&&(0,i.isSetObject)(e[t])))&&t.UNPLUGIN_BUILD_VARIANTS.every(t=>(0,o.isUndefined)(e[t])||t in e&&(0,i.isSetObject)(e[t]))}function c(e){return(0,i.isSetObject)(e)&&`plugin`in e&&(((0,a.isSetString)(e.plugin)||(0,r.isFunction)(e.plugin))&&`options`in e&&(0,i.isSetObject)(e.options)||s(e.plugin))}function l(e){return Array.isArray(e)&&(e.length===1||e.length===2)&&(((0,a.isSetString)(e[0])||(0,r.isFunction)(e[0]))&&e.length>1&&(0,i.isSetObject)(e[1])||s(e[0]))}function u(e){return(0,a.isSetString)(e)||(0,r.isFunction)(e)||s(e)||c(e)||l(e)||Array.isArray(e)&&e.every(e=>u(e))}function d(e){return(0,i.isSetObject)(e)&&`handler`in e&&(0,r.isFunction)(e.handler)}function f(e){return(0,r.isFunction)(e)||d(e)}function p(e){return f(e)||d(e)}function m(e){return(0,r.isFunction)(e)?e:e.handler}function h(e){return e.startsWith(`vite:`)||e.startsWith(`esbuild:`)||e.startsWith(`rolldown:`)||e.startsWith(`rollup:`)||e.startsWith(`webpack:`)||e.startsWith(`rspack:`)||e.startsWith(`farm:`)}function g(e,t){return e.dedupe===!1||t.some(t=>t.dedupe!==!1&&((0,r.isFunction)(t.dedupe)&&t.dedupe(e)||t.name===e.name))}function _(e,t,n,i){g(t,i.map(e=>e.plugin))||i.push((0,r.isFunction)(n)?{plugin:t,handler:m(n).bind(e)}:{plugin:t,...n,handler:m(n).bind(e)})}function v(e){if(u(e))return null;if(Array.isArray(e)){let t=[];return e.forEach(e=>{let n=v(e);n&&t.push(...n.map(e=>JSON.stringify(e,null,2)))}),t.length>0?t:null}return[JSON.stringify(e,null,2)]}exports.addPluginHook=_,exports.checkDedupe=g,exports.findInvalidPluginConfig=v,exports.getHookHandler=m,exports.isHookExternal=h,exports.isPlugin=s,exports.isPluginConfig=u,exports.isPluginConfigObject=c,exports.isPluginConfigTuple=l,exports.isPluginHook=p;
+const require_rolldown_runtime = require('../../../_virtual/rolldown_runtime.cjs');
+const require_build = require('../types/build.cjs');
+const require_plugin = require('../types/plugin.cjs');
+let __stryke_type_checks_is_function = require("@stryke/type-checks/is-function");
+let __stryke_type_checks_is_set_object = require("@stryke/type-checks/is-set-object");
+let __stryke_type_checks_is_set_string = require("@stryke/type-checks/is-set-string");
+let __stryke_type_checks_is_undefined = require("@stryke/type-checks/is-undefined");
+
+//#region ../powerlines/src/plugin-utils/helpers.ts
+/**
+* Type guard to check if an object is a {@link Plugin}
+*
+* @param value - The object to check
+* @returns True if the object is a {@link Plugin}, false otherwise
+*/
+function isPlugin(value) {
+	return (0, __stryke_type_checks_is_set_object.isSetObject)(value) && "name" in value && (0, __stryke_type_checks_is_set_string.isSetString)(value.name) && ((0, __stryke_type_checks_is_undefined.isUndefined)(value.api) || "api" in value && (0, __stryke_type_checks_is_set_object.isSetObject)(value.api)) && ((0, __stryke_type_checks_is_undefined.isUndefined)(value.applyToEnvironment) || "applyToEnvironment" in value && (0, __stryke_type_checks_is_function.isFunction)(value.applyToEnvironment)) && ((0, __stryke_type_checks_is_undefined.isUndefined)(value.dedupe) || "dedupe" in value && (0, __stryke_type_checks_is_function.isFunction)(value.dedupe)) && require_plugin.KNOWN_HOOKS.every((hook) => (0, __stryke_type_checks_is_undefined.isUndefined)(value[hook]) || hook in value && (isPluginHookFunction(value[hook]) || hook === "config" && (0, __stryke_type_checks_is_set_object.isSetObject)(value[hook]))) && require_build.UNPLUGIN_BUILD_VARIANTS.every((variant) => (0, __stryke_type_checks_is_undefined.isUndefined)(value[variant]) || variant in value && (0, __stryke_type_checks_is_set_object.isSetObject)(value[variant]));
+}
+/**
+* Type guard to check if an object is a {@link PluginConfigObject}
+*
+* @param value - The object to check
+* @returns True if the object is a {@link PluginConfigObject}, false otherwise
+*/
+function isPluginConfigObject(value) {
+	return (0, __stryke_type_checks_is_set_object.isSetObject)(value) && "plugin" in value && (((0, __stryke_type_checks_is_set_string.isSetString)(value.plugin) || (0, __stryke_type_checks_is_function.isFunction)(value.plugin)) && "options" in value && (0, __stryke_type_checks_is_set_object.isSetObject)(value.options) || isPlugin(value.plugin));
+}
+/**
+* Type guard to check if an object is a {@link PluginConfigTuple}
+*
+* @param value - The object to check
+* @returns True if the object is a {@link PluginConfigTuple}, false otherwise
+*/
+function isPluginConfigTuple(value) {
+	return Array.isArray(value) && (value.length === 1 || value.length === 2) && (((0, __stryke_type_checks_is_set_string.isSetString)(value[0]) || (0, __stryke_type_checks_is_function.isFunction)(value[0])) && value.length > 1 && (0, __stryke_type_checks_is_set_object.isSetObject)(value[1]) || isPlugin(value[0]));
+}
+/**
+* Type guard to check if an object is a {@link PluginConfig}
+*
+* @param value - The object to check
+* @returns True if the object is a {@link PluginConfig}, false otherwise
+*/
+function isPluginConfig(value) {
+	return (0, __stryke_type_checks_is_set_string.isSetString)(value) || (0, __stryke_type_checks_is_function.isFunction)(value) || isPlugin(value) || isPluginConfigObject(value) || isPluginConfigTuple(value) || Array.isArray(value) && value.every((item) => isPluginConfig(item));
+}
+/**
+* Type guard to check if an value is a {@link PluginHook} function
+*
+* @param value - The value to check
+* @returns True if the value is a {@link PluginHook} function, false otherwise
+*/
+function isPluginHookObject(value) {
+	return (0, __stryke_type_checks_is_set_object.isSetObject)(value) && "handler" in value && (0, __stryke_type_checks_is_function.isFunction)(value.handler);
+}
+/**
+* Type guard to check if an value is a {@link PluginHook} function
+*
+* @param value - The value to check
+* @returns True if the value is a {@link PluginHook} function, false otherwise
+*/
+function isPluginHookFunction(value) {
+	return (0, __stryke_type_checks_is_function.isFunction)(value) || isPluginHookObject(value);
+}
+/**
+* Type guard to check if an object is a {@link PluginHook}
+*
+* @param value - The object to check
+* @returns True if the object is a {@link PluginHook}, false otherwise
+*/
+function isPluginHook(value) {
+	return isPluginHookFunction(value) || isPluginHookObject(value);
+}
+/**
+* Extract the hook handler function from a plugin hook
+*
+* @param pluginHook - The plugin hook to extract the handler function from
+* @returns The hook handler function
+*/
+function getHookHandler(pluginHook) {
+	return (0, __stryke_type_checks_is_function.isFunction)(pluginHook) ? pluginHook : pluginHook.handler;
+}
+/**
+* Check if a hook is external.
+*
+* @param hook - The name of the hook to check.
+* @returns True if the hook is external, false otherwise.
+*/
+function isHookExternal(hook) {
+	return hook.startsWith("vite:") || hook.startsWith("esbuild:") || hook.startsWith("rolldown:") || hook.startsWith("rollup:") || hook.startsWith("webpack:") || hook.startsWith("rspack:") || hook.startsWith("farm:");
+}
+/**
+* Check if a plugin should be deduplicated.
+*
+* @param plugin - The plugin to check
+* @param plugins - The list of plugins to check against
+* @returns True if the plugin should be deduplicated, false otherwise
+*/
+function checkDedupe(plugin, plugins) {
+	return plugin.dedupe === false || plugins.some((p) => p.dedupe !== false && ((0, __stryke_type_checks_is_function.isFunction)(p.dedupe) && p.dedupe(plugin) || p.name === plugin.name));
+}
+/**
+* Add a plugin hook to the hooks list.
+*
+* @param context - The plugin context
+* @param plugin - The plugin to add the hook from
+* @param pluginHook - The plugin hook to add
+* @param hooksList - The list of hooks to add to
+*/
+function addPluginHook(context, plugin, pluginHook, hooksList) {
+	if (!checkDedupe(plugin, hooksList.map((hook) => hook.plugin))) hooksList.push((0, __stryke_type_checks_is_function.isFunction)(pluginHook) ? {
+		plugin,
+		handler: getHookHandler(pluginHook).bind(context)
+	} : {
+		plugin,
+		...pluginHook,
+		handler: getHookHandler(pluginHook).bind(context)
+	});
+}
+/**
+* Check the provided {@link PluginConfig}, and return a stringified version of the invalid configuration. If an array is provided, check each item in the array.
+*
+* @param config - The plugin configuration to check
+* @returns Null if the configuration is valid, otherwise an array of stringified invalid configurations
+*/
+function findInvalidPluginConfig(config) {
+	if (isPluginConfig(config)) return null;
+	if (Array.isArray(config)) {
+		const invalidItems = [];
+		config.forEach((item) => {
+			const invalid = findInvalidPluginConfig(item);
+			if (invalid) invalidItems.push(...invalid.map((i) => JSON.stringify(i, null, 2)));
+		});
+		return invalidItems.length > 0 ? invalidItems : null;
+	}
+	return [JSON.stringify(config, null, 2)];
+}
+
+//#endregion
+exports.addPluginHook = addPluginHook;
+exports.checkDedupe = checkDedupe;
+exports.findInvalidPluginConfig = findInvalidPluginConfig;
+exports.getHookHandler = getHookHandler;
+exports.isHookExternal = isHookExternal;
+exports.isPlugin = isPlugin;
+exports.isPluginConfig = isPluginConfig;
+exports.isPluginConfigObject = isPluginConfigObject;
+exports.isPluginConfigTuple = isPluginConfigTuple;
+exports.isPluginHook = isPluginHook;

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

@@ -1 +1,138 @@
-import{UNPLUGIN_BUILD_VARIANTS as e}from"../types/build.mjs";import{KNOWN_HOOKS as t}from"../types/plugin.mjs";import{isFunction as n}from"@stryke/type-checks/is-function";import{isSetObject as r}from"@stryke/type-checks/is-set-object";import{isSetString as i}from"@stryke/type-checks/is-set-string";import{isUndefined as a}from"@stryke/type-checks/is-undefined";function o(o){return r(o)&&`name`in o&&i(o.name)&&(a(o.api)||`api`in o&&r(o.api))&&(a(o.applyToEnvironment)||`applyToEnvironment`in o&&n(o.applyToEnvironment))&&(a(o.dedupe)||`dedupe`in o&&n(o.dedupe))&&t.every(e=>a(o[e])||e in o&&(d(o[e])||e===`config`&&r(o[e])))&&e.every(e=>a(o[e])||e in o&&r(o[e]))}function s(e){return r(e)&&`plugin`in e&&((i(e.plugin)||n(e.plugin))&&`options`in e&&r(e.options)||o(e.plugin))}function c(e){return Array.isArray(e)&&(e.length===1||e.length===2)&&((i(e[0])||n(e[0]))&&e.length>1&&r(e[1])||o(e[0]))}function l(e){return i(e)||n(e)||o(e)||s(e)||c(e)||Array.isArray(e)&&e.every(e=>l(e))}function u(e){return r(e)&&`handler`in e&&n(e.handler)}function d(e){return n(e)||u(e)}function f(e){return d(e)||u(e)}function p(e){return n(e)?e:e.handler}function m(e){return e.startsWith(`vite:`)||e.startsWith(`esbuild:`)||e.startsWith(`rolldown:`)||e.startsWith(`rollup:`)||e.startsWith(`webpack:`)||e.startsWith(`rspack:`)||e.startsWith(`farm:`)}function h(e,t){return e.dedupe===!1||t.some(t=>t.dedupe!==!1&&(n(t.dedupe)&&t.dedupe(e)||t.name===e.name))}function g(e,t,r,i){h(t,i.map(e=>e.plugin))||i.push(n(r)?{plugin:t,handler:p(r).bind(e)}:{plugin:t,...r,handler:p(r).bind(e)})}function _(e){if(l(e))return null;if(Array.isArray(e)){let t=[];return e.forEach(e=>{let n=_(e);n&&t.push(...n.map(e=>JSON.stringify(e,null,2)))}),t.length>0?t:null}return[JSON.stringify(e,null,2)]}export{g as addPluginHook,h as checkDedupe,_ as findInvalidPluginConfig,p as getHookHandler,m as isHookExternal,o as isPlugin,l as isPluginConfig,s as isPluginConfigObject,c as isPluginConfigTuple,f as isPluginHook};
+import { UNPLUGIN_BUILD_VARIANTS } from "../types/build.mjs";
+import { KNOWN_HOOKS } from "../types/plugin.mjs";
+import { isFunction } from "@stryke/type-checks/is-function";
+import { isSetObject } from "@stryke/type-checks/is-set-object";
+import { isSetString } from "@stryke/type-checks/is-set-string";
+import { isUndefined } from "@stryke/type-checks/is-undefined";
+
+//#region ../powerlines/src/plugin-utils/helpers.ts
+/**
+* Type guard to check if an object is a {@link Plugin}
+*
+* @param value - The object to check
+* @returns True if the object is a {@link Plugin}, false otherwise
+*/
+function isPlugin(value) {
+	return isSetObject(value) && "name" in value && isSetString(value.name) && (isUndefined(value.api) || "api" in value && isSetObject(value.api)) && (isUndefined(value.applyToEnvironment) || "applyToEnvironment" in value && isFunction(value.applyToEnvironment)) && (isUndefined(value.dedupe) || "dedupe" in value && isFunction(value.dedupe)) && KNOWN_HOOKS.every((hook) => isUndefined(value[hook]) || hook in value && (isPluginHookFunction(value[hook]) || hook === "config" && isSetObject(value[hook]))) && UNPLUGIN_BUILD_VARIANTS.every((variant) => isUndefined(value[variant]) || variant in value && isSetObject(value[variant]));
+}
+/**
+* Type guard to check if an object is a {@link PluginConfigObject}
+*
+* @param value - The object to check
+* @returns True if the object is a {@link PluginConfigObject}, false otherwise
+*/
+function isPluginConfigObject(value) {
+	return isSetObject(value) && "plugin" in value && ((isSetString(value.plugin) || isFunction(value.plugin)) && "options" in value && isSetObject(value.options) || isPlugin(value.plugin));
+}
+/**
+* Type guard to check if an object is a {@link PluginConfigTuple}
+*
+* @param value - The object to check
+* @returns True if the object is a {@link PluginConfigTuple}, false otherwise
+*/
+function isPluginConfigTuple(value) {
+	return Array.isArray(value) && (value.length === 1 || value.length === 2) && ((isSetString(value[0]) || isFunction(value[0])) && value.length > 1 && isSetObject(value[1]) || isPlugin(value[0]));
+}
+/**
+* Type guard to check if an object is a {@link PluginConfig}
+*
+* @param value - The object to check
+* @returns True if the object is a {@link PluginConfig}, false otherwise
+*/
+function isPluginConfig(value) {
+	return isSetString(value) || isFunction(value) || isPlugin(value) || isPluginConfigObject(value) || isPluginConfigTuple(value) || Array.isArray(value) && value.every((item) => isPluginConfig(item));
+}
+/**
+* Type guard to check if an value is a {@link PluginHook} function
+*
+* @param value - The value to check
+* @returns True if the value is a {@link PluginHook} function, false otherwise
+*/
+function isPluginHookObject(value) {
+	return isSetObject(value) && "handler" in value && isFunction(value.handler);
+}
+/**
+* Type guard to check if an value is a {@link PluginHook} function
+*
+* @param value - The value to check
+* @returns True if the value is a {@link PluginHook} function, false otherwise
+*/
+function isPluginHookFunction(value) {
+	return isFunction(value) || isPluginHookObject(value);
+}
+/**
+* Type guard to check if an object is a {@link PluginHook}
+*
+* @param value - The object to check
+* @returns True if the object is a {@link PluginHook}, false otherwise
+*/
+function isPluginHook(value) {
+	return isPluginHookFunction(value) || isPluginHookObject(value);
+}
+/**
+* Extract the hook handler function from a plugin hook
+*
+* @param pluginHook - The plugin hook to extract the handler function from
+* @returns The hook handler function
+*/
+function getHookHandler(pluginHook) {
+	return isFunction(pluginHook) ? pluginHook : pluginHook.handler;
+}
+/**
+* Check if a hook is external.
+*
+* @param hook - The name of the hook to check.
+* @returns True if the hook is external, false otherwise.
+*/
+function isHookExternal(hook) {
+	return hook.startsWith("vite:") || hook.startsWith("esbuild:") || hook.startsWith("rolldown:") || hook.startsWith("rollup:") || hook.startsWith("webpack:") || hook.startsWith("rspack:") || hook.startsWith("farm:");
+}
+/**
+* Check if a plugin should be deduplicated.
+*
+* @param plugin - The plugin to check
+* @param plugins - The list of plugins to check against
+* @returns True if the plugin should be deduplicated, false otherwise
+*/
+function checkDedupe(plugin, plugins) {
+	return plugin.dedupe === false || plugins.some((p) => p.dedupe !== false && (isFunction(p.dedupe) && p.dedupe(plugin) || p.name === plugin.name));
+}
+/**
+* Add a plugin hook to the hooks list.
+*
+* @param context - The plugin context
+* @param plugin - The plugin to add the hook from
+* @param pluginHook - The plugin hook to add
+* @param hooksList - The list of hooks to add to
+*/
+function addPluginHook(context, plugin, pluginHook, hooksList) {
+	if (!checkDedupe(plugin, hooksList.map((hook) => hook.plugin))) hooksList.push(isFunction(pluginHook) ? {
+		plugin,
+		handler: getHookHandler(pluginHook).bind(context)
+	} : {
+		plugin,
+		...pluginHook,
+		handler: getHookHandler(pluginHook).bind(context)
+	});
+}
+/**
+* Check the provided {@link PluginConfig}, and return a stringified version of the invalid configuration. If an array is provided, check each item in the array.
+*
+* @param config - The plugin configuration to check
+* @returns Null if the configuration is valid, otherwise an array of stringified invalid configurations
+*/
+function findInvalidPluginConfig(config) {
+	if (isPluginConfig(config)) return null;
+	if (Array.isArray(config)) {
+		const invalidItems = [];
+		config.forEach((item) => {
+			const invalid = findInvalidPluginConfig(item);
+			if (invalid) invalidItems.push(...invalid.map((i) => JSON.stringify(i, null, 2)));
+		});
+		return invalidItems.length > 0 ? invalidItems : null;
+	}
+	return [JSON.stringify(config, null, 2)];
+}
+
+//#endregion
+export { addPluginHook, checkDedupe, findInvalidPluginConfig, getHookHandler, isHookExternal, isPlugin, isPluginConfig, isPluginConfigObject, isPluginConfigTuple, isPluginHook };

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

@@ -1 +1,36 @@
-const e=require(`../../../_virtual/rolldown_runtime.cjs`);let t=require(`@stryke/path/replace`);function n(e,n){return n&&n.replaceAll(`{workspaceRoot}`,e.workspaceConfig.workspaceRoot).replaceAll(`{root}`,e.config.projectRoot).replaceAll(`{projectRoot}`,e.config.projectRoot).replaceAll(`{sourceRoot}`,e.config.sourceRoot).replaceAll(`{powerlinesPath}`,e.powerlinesPath).replaceAll(`{cachePath}`,e.cachePath).replaceAll(`{dataPath}`,e.dataPath).replaceAll(`{logPath}`,e.envPaths.log).replaceAll(`{tempPath}`,e.envPaths.temp).replaceAll(`{configPath}`,e.envPaths.config).replaceAll(`{outputPath}`,e.config.output.outputPath).replaceAll(`{buildPath}`,e.config.output.buildPath).replaceAll(`{artifactsPath}`,(0,t.replacePath)(e.artifactsPath,e.workspaceConfig.workspaceRoot)).replaceAll(`{builtinPath}`,(0,t.replacePath)(e.builtinsPath,e.workspaceConfig.workspaceRoot)).replaceAll(`{entryPath}`,(0,t.replacePath)(e.entryPath,e.workspaceConfig.workspaceRoot))}exports.replacePathTokens=n;
+const require_rolldown_runtime = require('../../../_virtual/rolldown_runtime.cjs');
+let __stryke_path_replace = require("@stryke/path/replace");
+
+//#region ../powerlines/src/plugin-utils/paths.ts
+/**
+* Replaces tokens in the given path string with their corresponding values from the context.
+*
+* @remarks
+* The following tokens are supported:
+* - `{workspaceRoot}` - The root directory of the workspace.
+* - `{root}` - The root directory of the project (same as `{projectRoot}`).
+* - `{projectRoot}` - The root directory of the project (same as `{root}`).
+* - `{sourceRoot}` - The source root directory of the project (usually `./src`).
+* - `{powerlinesPath}` - The directory where Powerlines is installed.
+* - `{cachePath}` - The environment's directory for cached files.
+* - `{dataPath}` - The environment's directory for data files.
+* - `{logPath}` - The environment's directory for log files.
+* - `{tempPath}` - The environment's directory for temporary files.
+* - `{configPath}` - The environment's directory for configuration files.
+* - `{outputPath}` - The configured output directory for the project.
+* - `{buildPath}` - The configured distribution directory for the project.
+* - `{artifactsPath}` - The configured directory for build artifacts.
+* - `{builtinPath}` - The configured directory for generated built-in plugins.
+* - `{entryPath}` - The configured directory for generated entry files.
+*
+* @param context - The context containing the values for the path tokens.
+* @param path - The path string with tokens to replace.
+* @returns The path string with tokens replaced by their corresponding values from the context.
+*/
+function replacePathTokens(context, path) {
+	if (!path) return path;
+	return path.replaceAll("{workspaceRoot}", context.workspaceConfig.workspaceRoot).replaceAll("{root}", context.config.projectRoot).replaceAll("{projectRoot}", context.config.projectRoot).replaceAll("{sourceRoot}", context.config.sourceRoot).replaceAll("{powerlinesPath}", context.powerlinesPath).replaceAll("{cachePath}", context.cachePath).replaceAll("{dataPath}", context.dataPath).replaceAll("{logPath}", context.envPaths.log).replaceAll("{tempPath}", context.envPaths.temp).replaceAll("{configPath}", context.envPaths.config).replaceAll("{outputPath}", context.config.output.outputPath).replaceAll("{buildPath}", context.config.output.buildPath).replaceAll("{artifactsPath}", (0, __stryke_path_replace.replacePath)(context.artifactsPath, context.workspaceConfig.workspaceRoot)).replaceAll("{builtinPath}", (0, __stryke_path_replace.replacePath)(context.builtinsPath, context.workspaceConfig.workspaceRoot)).replaceAll("{entryPath}", (0, __stryke_path_replace.replacePath)(context.entryPath, context.workspaceConfig.workspaceRoot));
+}
+
+//#endregion
+exports.replacePathTokens = replacePathTokens;

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

@@ -1 +1,35 @@
-import{replacePath as e}from"@stryke/path/replace";function t(t,n){return n&&n.replaceAll(`{workspaceRoot}`,t.workspaceConfig.workspaceRoot).replaceAll(`{root}`,t.config.projectRoot).replaceAll(`{projectRoot}`,t.config.projectRoot).replaceAll(`{sourceRoot}`,t.config.sourceRoot).replaceAll(`{powerlinesPath}`,t.powerlinesPath).replaceAll(`{cachePath}`,t.cachePath).replaceAll(`{dataPath}`,t.dataPath).replaceAll(`{logPath}`,t.envPaths.log).replaceAll(`{tempPath}`,t.envPaths.temp).replaceAll(`{configPath}`,t.envPaths.config).replaceAll(`{outputPath}`,t.config.output.outputPath).replaceAll(`{buildPath}`,t.config.output.buildPath).replaceAll(`{artifactsPath}`,e(t.artifactsPath,t.workspaceConfig.workspaceRoot)).replaceAll(`{builtinPath}`,e(t.builtinsPath,t.workspaceConfig.workspaceRoot)).replaceAll(`{entryPath}`,e(t.entryPath,t.workspaceConfig.workspaceRoot))}export{t as replacePathTokens};
+import { replacePath } from "@stryke/path/replace";
+
+//#region ../powerlines/src/plugin-utils/paths.ts
+/**
+* Replaces tokens in the given path string with their corresponding values from the context.
+*
+* @remarks
+* The following tokens are supported:
+* - `{workspaceRoot}` - The root directory of the workspace.
+* - `{root}` - The root directory of the project (same as `{projectRoot}`).
+* - `{projectRoot}` - The root directory of the project (same as `{root}`).
+* - `{sourceRoot}` - The source root directory of the project (usually `./src`).
+* - `{powerlinesPath}` - The directory where Powerlines is installed.
+* - `{cachePath}` - The environment's directory for cached files.
+* - `{dataPath}` - The environment's directory for data files.
+* - `{logPath}` - The environment's directory for log files.
+* - `{tempPath}` - The environment's directory for temporary files.
+* - `{configPath}` - The environment's directory for configuration files.
+* - `{outputPath}` - The configured output directory for the project.
+* - `{buildPath}` - The configured distribution directory for the project.
+* - `{artifactsPath}` - The configured directory for build artifacts.
+* - `{builtinPath}` - The configured directory for generated built-in plugins.
+* - `{entryPath}` - The configured directory for generated entry files.
+*
+* @param context - The context containing the values for the path tokens.
+* @param path - The path string with tokens to replace.
+* @returns The path string with tokens replaced by their corresponding values from the context.
+*/
+function replacePathTokens(context, path) {
+	if (!path) return path;
+	return path.replaceAll("{workspaceRoot}", context.workspaceConfig.workspaceRoot).replaceAll("{root}", context.config.projectRoot).replaceAll("{projectRoot}", context.config.projectRoot).replaceAll("{sourceRoot}", context.config.sourceRoot).replaceAll("{powerlinesPath}", context.powerlinesPath).replaceAll("{cachePath}", context.cachePath).replaceAll("{dataPath}", context.dataPath).replaceAll("{logPath}", context.envPaths.log).replaceAll("{tempPath}", context.envPaths.temp).replaceAll("{configPath}", context.envPaths.config).replaceAll("{outputPath}", context.config.output.outputPath).replaceAll("{buildPath}", context.config.output.buildPath).replaceAll("{artifactsPath}", replacePath(context.artifactsPath, context.workspaceConfig.workspaceRoot)).replaceAll("{builtinPath}", replacePath(context.builtinsPath, context.workspaceConfig.workspaceRoot)).replaceAll("{entryPath}", replacePath(context.entryPath, context.workspaceConfig.workspaceRoot));
+}
+
+//#endregion
+export { replacePathTokens };

package/dist/powerlines/src/types/build.cjs

@@ -1 +1,15 @@
-const e=[`rollup`,`webpack`,`rspack`,`vite`,`esbuild`,`farm`,`unloader`,`rolldown`];exports.UNPLUGIN_BUILD_VARIANTS=e;
+
+//#region ../powerlines/src/types/build.ts
+const UNPLUGIN_BUILD_VARIANTS = [
+	"rollup",
+	"webpack",
+	"rspack",
+	"vite",
+	"esbuild",
+	"farm",
+	"unloader",
+	"rolldown"
+];
+
+//#endregion
+exports.UNPLUGIN_BUILD_VARIANTS = UNPLUGIN_BUILD_VARIANTS;

package/dist/powerlines/src/types/build.mjs

@@ -1 +1,14 @@
-const e=[`rollup`,`webpack`,`rspack`,`vite`,`esbuild`,`farm`,`unloader`,`rolldown`];export{e as UNPLUGIN_BUILD_VARIANTS};
+//#region ../powerlines/src/types/build.ts
+const UNPLUGIN_BUILD_VARIANTS = [
+	"rollup",
+	"webpack",
+	"rspack",
+	"vite",
+	"esbuild",
+	"farm",
+	"unloader",
+	"rolldown"
+];
+
+//#endregion
+export { UNPLUGIN_BUILD_VARIANTS };

package/dist/powerlines/src/types/commands.cjs

@@ -1 +1,16 @@
-const e=[`new`,`clean`,`prepare`,`lint`,`test`,`build`,`docs`,`deploy`,`finalize`];exports.SUPPORTED_COMMANDS=e;
+
+//#region ../powerlines/src/types/commands.ts
+const SUPPORTED_COMMANDS = [
+	"new",
+	"clean",
+	"prepare",
+	"lint",
+	"test",
+	"build",
+	"docs",
+	"deploy",
+	"finalize"
+];
+
+//#endregion
+exports.SUPPORTED_COMMANDS = SUPPORTED_COMMANDS;

package/dist/powerlines/src/types/commands.mjs

@@ -1 +1,15 @@
-const e=[`new`,`clean`,`prepare`,`lint`,`test`,`build`,`docs`,`deploy`,`finalize`];export{e as SUPPORTED_COMMANDS};
+//#region ../powerlines/src/types/commands.ts
+const SUPPORTED_COMMANDS = [
+	"new",
+	"clean",
+	"prepare",
+	"lint",
+	"test",
+	"build",
+	"docs",
+	"deploy",
+	"finalize"
+];
+
+//#endregion
+export { SUPPORTED_COMMANDS };

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

@@ -78,10 +78,18 @@ interface ParseOptions extends ParserOptions {
    */
   allowReturnOutsideFunction?: boolean;
 }
+interface EmitOptions extends WriteOptions {
+  /**
+   * If true, will emit the file using {@link UnpluginBuildContext.emitFile | the bundler's emit function}.
+   */
+  emitWithBundler?: boolean;
+  needsCodeReference?: Parameters<UnpluginBuildContext["emitFile"]>[0]["needsCodeReference"];
+  originalFileName?: Parameters<UnpluginBuildContext["emitFile"]>[0]["originalFileName"];
+}
 /**
  * Options for emitting entry virtual files
  */
-type EmitEntryOptions = WriteOptions & Omit<ResolvedEntryTypeDefinition, "file">;
+type EmitEntryOptions = EmitOptions & Omit<ResolvedEntryTypeDefinition, "file">;
 /**
  * The unresolved Powerlines context.
  *
@@ -292,6 +300,22 @@ interface UnresolvedContext<TResolvedConfig extends ResolvedConfig = ResolvedCon
    * The Powerlines builtin virtual files
    */
   getBuiltins: () => Promise<VirtualFile[]>;
+  /**
+   * Resolves a file and writes it to the VFS if it does not already exist
+   *
+   * @param code - The source code of the file
+   * @param path - The path to write the file to
+   * @param options - Additional options for writing the file
+   */
+  emit: (code: string, path: string, options?: EmitOptions) => Promise<void>;
+  /**
+   * Synchronously resolves a file and writes it to the VFS if it does not already exist
+   *
+   * @param code - The source code of the file
+   * @param path - The path to write the file to
+   * @param options - Additional options for writing the file
+   */
+  emitSync: (code: string, path: string, options?: EmitOptions) => void;
   /**
    * Resolves a builtin virtual file and writes it to the VFS if it does not already exist
    *
@@ -300,7 +324,16 @@ interface UnresolvedContext<TResolvedConfig extends ResolvedConfig = ResolvedCon
    * @param path - An optional path to write the builtin file to
    * @param options - Additional options for writing the builtin file
    */
-  emitBuiltin: (code: string, id: string, path?: string, options?: WriteOptions) => Promise<void>;
+  emitBuiltin: (code: string, id: string, path?: string, options?: EmitOptions) => Promise<void>;
+  /**
+   * Synchronously resolves a builtin virtual file and writes it to the VFS if it does not already exist
+   *
+   * @param code - The source code of the builtin file
+   * @param id - The unique identifier of the builtin file
+   * @param path - An optional path to write the builtin file to
+   * @param options - Additional options for writing the builtin file
+   */
+  emitBuiltinSync: (code: string, id: string, path?: string, options?: EmitOptions) => void;
   /**
    * Resolves a entry virtual file and writes it to the VFS if it does not already exist
    *
@@ -309,6 +342,14 @@ interface UnresolvedContext<TResolvedConfig extends ResolvedConfig = ResolvedCon
    * @param options - Additional options for writing the entry file
    */
   emitEntry: (code: string, path: string, options?: EmitEntryOptions) => Promise<void>;
+  /**
+   * Synchronously resolves a entry virtual file and writes it to the VFS if it does not already exist
+   *
+   * @param code - The source code of the entry file
+   * @param path - An optional path to write the entry file to
+   * @param options - Additional options for writing the entry file
+   */
+  emitEntrySync: (code: string, path: string, options?: EmitEntryOptions) => void;
   /**
    * A function to update the context fields using a new user configuration options
    */

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

@@ -80,10 +80,18 @@ interface ParseOptions extends ParserOptions {
    */
   allowReturnOutsideFunction?: boolean;
 }
+interface EmitOptions extends WriteOptions {
+  /**
+   * If true, will emit the file using {@link UnpluginBuildContext.emitFile | the bundler's emit function}.
+   */
+  emitWithBundler?: boolean;
+  needsCodeReference?: Parameters<UnpluginBuildContext["emitFile"]>[0]["needsCodeReference"];
+  originalFileName?: Parameters<UnpluginBuildContext["emitFile"]>[0]["originalFileName"];
+}
 /**
  * Options for emitting entry virtual files
  */
-type EmitEntryOptions = WriteOptions & Omit<ResolvedEntryTypeDefinition, "file">;
+type EmitEntryOptions = EmitOptions & Omit<ResolvedEntryTypeDefinition, "file">;
 /**
  * The unresolved Powerlines context.
  *
@@ -294,6 +302,22 @@ interface UnresolvedContext<TResolvedConfig extends ResolvedConfig = ResolvedCon
    * The Powerlines builtin virtual files
    */
   getBuiltins: () => Promise<VirtualFile[]>;
+  /**
+   * Resolves a file and writes it to the VFS if it does not already exist
+   *
+   * @param code - The source code of the file
+   * @param path - The path to write the file to
+   * @param options - Additional options for writing the file
+   */
+  emit: (code: string, path: string, options?: EmitOptions) => Promise<void>;
+  /**
+   * Synchronously resolves a file and writes it to the VFS if it does not already exist
+   *
+   * @param code - The source code of the file
+   * @param path - The path to write the file to
+   * @param options - Additional options for writing the file
+   */
+  emitSync: (code: string, path: string, options?: EmitOptions) => void;
   /**
    * Resolves a builtin virtual file and writes it to the VFS if it does not already exist
    *
@@ -302,7 +326,16 @@ interface UnresolvedContext<TResolvedConfig extends ResolvedConfig = ResolvedCon
    * @param path - An optional path to write the builtin file to
    * @param options - Additional options for writing the builtin file
    */
-  emitBuiltin: (code: string, id: string, path?: string, options?: WriteOptions) => Promise<void>;
+  emitBuiltin: (code: string, id: string, path?: string, options?: EmitOptions) => Promise<void>;
+  /**
+   * Synchronously resolves a builtin virtual file and writes it to the VFS if it does not already exist
+   *
+   * @param code - The source code of the builtin file
+   * @param id - The unique identifier of the builtin file
+   * @param path - An optional path to write the builtin file to
+   * @param options - Additional options for writing the builtin file
+   */
+  emitBuiltinSync: (code: string, id: string, path?: string, options?: EmitOptions) => void;
   /**
    * Resolves a entry virtual file and writes it to the VFS if it does not already exist
    *
@@ -311,6 +344,14 @@ interface UnresolvedContext<TResolvedConfig extends ResolvedConfig = ResolvedCon
    * @param options - Additional options for writing the entry file
    */
   emitEntry: (code: string, path: string, options?: EmitEntryOptions) => Promise<void>;
+  /**
+   * Synchronously resolves a entry virtual file and writes it to the VFS if it does not already exist
+   *
+   * @param code - The source code of the entry file
+   * @param path - An optional path to write the entry file to
+   * @param options - Additional options for writing the entry file
+   */
+  emitEntrySync: (code: string, path: string, options?: EmitEntryOptions) => void;
   /**
    * A function to update the context fields using a new user configuration options
    */

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

@@ -13,6 +13,13 @@ interface StorageAdapter {
    * A name identifying the storage adapter type.
    */
   name: string;
+  /**
+   * The storage preset for the adapter.
+   *
+   * @remarks
+   * This can be used as an alternate way to identify the type of storage being used.
+   */
+  preset?: StoragePreset | null;
   /**
    * Checks if a key exists in the storage.
    *
@@ -207,6 +214,13 @@ interface WriteOptions {
    * @defaultValue false
    */
   skipFormat?: boolean;
+  /**
+   * The storage preset or adapter name for the output file.
+   *
+   * @remarks
+   * If not specified, the output mode will be determined by the provided `output.mode` value.
+   */
+  storage?: StoragePreset | string;
   /**
    * Additional metadata for the file.
    */

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

@@ -13,6 +13,13 @@ interface StorageAdapter {
    * A name identifying the storage adapter type.
    */
   name: string;
+  /**
+   * The storage preset for the adapter.
+   *
+   * @remarks
+   * This can be used as an alternate way to identify the type of storage being used.
+   */
+  preset?: StoragePreset | null;
   /**
    * Checks if a key exists in the storage.
    *
@@ -207,6 +214,13 @@ interface WriteOptions {
    * @defaultValue false
    */
   skipFormat?: boolean;
+  /**
+   * The storage preset or adapter name for the output file.
+   *
+   * @remarks
+   * If not specified, the output mode will be determined by the provided `output.mode` value.
+   */
+  storage?: StoragePreset | string;
   /**
    * Additional metadata for the file.
    */