@powerlines/core 0.11.0 → 0.11.2

package/dist/plugin-utils/merge.cjs

@@ -2,11 +2,11 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
 const require_plugin_utils_helpers = require('./helpers.cjs');
 let defu = require("defu");
-defu = require_runtime.__toESM(defu);
-let _stryke_helpers_get_unique = require("@stryke/helpers/get-unique");
+defu = require_runtime.__toESM(defu, 1);
 let _stryke_type_checks_is_set_string = require("@stryke/type-checks/is-set-string");
 let _stryke_type_checks_is_string = require("@stryke/type-checks/is-string");
 let _stryke_type_checks_is_set = require("@stryke/type-checks/is-set");
+let _stryke_helpers_get_unique = require("@stryke/helpers/get-unique");
 let _stryke_type_checks_is_set_array = require("@stryke/type-checks/is-set-array");
 
 //#region src/plugin-utils/merge.ts
@@ -66,8 +66,8 @@ const mergeConfig = (0, defu.createDefu)((obj, key, value) => {
 		if ((0, _stryke_type_checks_is_set_array.isSetArray)(obj[key])) obj[key] = (0, _stryke_helpers_get_unique.getUnique)(obj[key]);
 		return true;
 	}
-	if ((0, _stryke_type_checks_is_string.isString)(obj[key]) && (0, _stryke_type_checks_is_string.isString)(value)) {
-		if ((0, _stryke_type_checks_is_set_string.isSetString)(value)) obj[key] = value;
+	if (!(0, _stryke_type_checks_is_set.isSet)(obj[key]) && (0, _stryke_type_checks_is_string.isString)(value)) {
+		obj[key] = value;
 		return true;
 	}
 	return false;

package/dist/plugin-utils/merge.d.cts

@@ -1,7 +1,6 @@
 import { Plugin } from "../types/plugin.cjs";
 import { PluginContext } from "../types/context.cjs";
 import { PartialPlugin, ResolvedConfig } from "../types/config.cjs";
-
 //#region src/plugin-utils/merge.d.ts
 type MergeResult<TContext extends PluginContext, TPluginA extends Plugin<TContext> | PartialPlugin<TContext>, TPluginB extends Plugin<TContext> | PartialPlugin<TContext>> = TPluginA extends Plugin<TContext> ? Plugin<TContext> : TPluginB extends Plugin<TContext> ? Plugin<TContext> : PartialPlugin<TContext>;
 /**

package/dist/plugin-utils/merge.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"merge.d.cts","names":[],"sources":["../../src/plugin-utils/merge.ts"],"mappings":";;;;;KAgCY,WAAA,kBACO,aAAA,mBACA,MAAA,CAAO,QAAA,IAAY,aAAA,CAAc,QAAA,oBACjC,MAAA,CAAO,QAAA,IAAY,aAAA,CAAc,QAAA,KAElD,QAAA,SAAiB,MAAA,CAAO,QAAA,IACpB,MAAA,CAAO,QAAA,IACP,QAAA,SAAiB,MAAA,CAAO,QAAA,IACtB,MAAA,CAAO,QAAA,IACP,aAAA,CAAc,QAAA;;;;AATtB;;;;iBAwCgB,KAAA,kBAAuB,aAAA,GAAgB,aAAA,CAAA,CACrD,OAAA,EAAS,MAAA,CAAO,QAAA,IAAY,aAAA,CAAc,QAAA,GAC1C,OAAA,EAAS,MAAA,CAAO,QAAA,IAAY,aAAA,CAAc,QAAA,IACzC,WAAA,CAAY,QAAA,SAAiB,OAAA,SAAgB,OAAA;;;;;;;;;;;;;;;;;cAwBnC,WAAA,MAyCH,OAAA,gBAAuB,cAAA;AAAA"}
+{"version":3,"file":"merge.d.cts","names":[],"sources":["../../src/plugin-utils/merge.ts"],"mappings":";;;;KAgCY,WAAA,kBACO,aAAA,mBACA,MAAA,CAAO,QAAA,IAAY,aAAA,CAAc,QAAA,oBACjC,MAAA,CAAO,QAAA,IAAY,aAAA,CAAc,QAAA,KAElD,QAAA,SAAiB,MAAA,CAAO,QAAA,IACpB,MAAA,CAAO,QAAA,IACP,QAAA,SAAiB,MAAA,CAAO,QAAA,IACtB,MAAA,CAAO,QAAA,IACP,aAAA,CAAc,QAAA;;;;;AATtB;;;iBAwCgB,KAAA,kBAAuB,aAAA,GAAgB,aAAA,CAAA,CACrD,OAAA,EAAS,MAAA,CAAO,QAAA,IAAY,aAAA,CAAc,QAAA,GAC1C,OAAA,EAAS,MAAA,CAAO,QAAA,IAAY,aAAA,CAAc,QAAA,IACzC,WAAA,CAAY,QAAA,SAAiB,OAAA,SAAgB,OAAA;;;;;;;;;;;;;;;;;cAwBnC,WAAA,MAuCH,OAAA,gBAAuB,cAAA;AAAA"}

package/dist/plugin-utils/merge.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"merge.d.mts","names":[],"sources":["../../src/plugin-utils/merge.ts"],"mappings":";;;;KAgCY,WAAA,kBACO,aAAA,mBACA,MAAA,CAAO,QAAA,IAAY,aAAA,CAAc,QAAA,oBACjC,MAAA,CAAO,QAAA,IAAY,aAAA,CAAc,QAAA,KAElD,QAAA,SAAiB,MAAA,CAAO,QAAA,IACpB,MAAA,CAAO,QAAA,IACP,QAAA,SAAiB,MAAA,CAAO,QAAA,IACtB,MAAA,CAAO,QAAA,IACP,aAAA,CAAc,QAAA;;;;;AATtB;;;iBAwCgB,KAAA,kBAAuB,aAAA,GAAgB,aAAA,CAAA,CACrD,OAAA,EAAS,MAAA,CAAO,QAAA,IAAY,aAAA,CAAc,QAAA,GAC1C,OAAA,EAAS,MAAA,CAAO,QAAA,IAAY,aAAA,CAAc,QAAA,IACzC,WAAA,CAAY,QAAA,SAAiB,OAAA,SAAgB,OAAA;;;;;;;;;;;;;;;;;cAwBnC,WAAA,MAyCH,OAAA,gBAAuB,cAAA;AAAA"}
+{"version":3,"file":"merge.d.mts","names":[],"sources":["../../src/plugin-utils/merge.ts"],"mappings":";;;;KAgCY,WAAA,kBACO,aAAA,mBACA,MAAA,CAAO,QAAA,IAAY,aAAA,CAAc,QAAA,oBACjC,MAAA,CAAO,QAAA,IAAY,aAAA,CAAc,QAAA,KAElD,QAAA,SAAiB,MAAA,CAAO,QAAA,IACpB,MAAA,CAAO,QAAA,IACP,QAAA,SAAiB,MAAA,CAAO,QAAA,IACtB,MAAA,CAAO,QAAA,IACP,aAAA,CAAc,QAAA;;;;;AATtB;;;iBAwCgB,KAAA,kBAAuB,aAAA,GAAgB,aAAA,CAAA,CACrD,OAAA,EAAS,MAAA,CAAO,QAAA,IAAY,aAAA,CAAc,QAAA,GAC1C,OAAA,EAAS,MAAA,CAAO,QAAA,IAAY,aAAA,CAAc,QAAA,IACzC,WAAA,CAAY,QAAA,SAAiB,OAAA,SAAgB,OAAA;;;;;;;;;;;;;;;;;cAwBnC,WAAA,MAuCH,OAAA,gBAAuB,cAAA;AAAA"}

package/dist/plugin-utils/merge.mjs

@@ -1,9 +1,9 @@
 import { getHookHandler, isPluginHook } from "./helpers.mjs";
 import defu, { createDefu } from "defu";
-import { getUnique } from "@stryke/helpers/get-unique";
 import { isSetString } from "@stryke/type-checks/is-set-string";
 import { isString } from "@stryke/type-checks/is-string";
 import { isSet } from "@stryke/type-checks/is-set";
+import { getUnique } from "@stryke/helpers/get-unique";
 import { isSetArray } from "@stryke/type-checks/is-set-array";
 
 //#region src/plugin-utils/merge.ts
@@ -63,8 +63,8 @@ const mergeConfig = createDefu((obj, key, value) => {
 		if (isSetArray(obj[key])) obj[key] = getUnique(obj[key]);
 		return true;
 	}
-	if (isString(obj[key]) && isString(value)) {
-		if (isSetString(value)) obj[key] = value;
+	if (!isSet(obj[key]) && isString(value)) {
+		obj[key] = value;
 		return true;
 	}
 	return false;

package/dist/plugin-utils/merge.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"merge.mjs","names":[],"sources":["../../src/plugin-utils/merge.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { getUnique } from \"@stryke/helpers/get-unique\";\nimport { isSet } from \"@stryke/type-checks/is-set\";\nimport { isSetArray } from \"@stryke/type-checks/is-set-array\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { isString } from \"@stryke/type-checks/is-string\";\nimport defu, { createDefu } from \"defu\";\nimport type {\n  PartialPlugin,\n  Plugin,\n  PluginContext,\n  ResolvedConfig\n} from \"../types\";\nimport { getHookHandler, isPluginHook } from \"./helpers\";\n\nexport type MergeResult<\n  TContext extends PluginContext,\n  TPluginA extends Plugin<TContext> | PartialPlugin<TContext>,\n  TPluginB extends Plugin<TContext> | PartialPlugin<TContext>\n> =\n  TPluginA extends Plugin<TContext>\n    ? Plugin<TContext>\n    : TPluginB extends Plugin<TContext>\n      ? Plugin<TContext>\n      : PartialPlugin<TContext>;\n\nconst mergePlugin = createDefu((obj, key, value) => {\n  if (isPluginHook(obj[key]) && isPluginHook(value)) {\n    obj[key] = {\n      ...obj[key],\n      ...value,\n      handler: async (...params: any[]) => {\n        const [resultA, resultB] = await Promise.all([\n          // eslint-disable-next-line ts/no-unsafe-call\n          (getHookHandler(obj[key]) as any)(...params),\n          // eslint-disable-next-line ts/no-unsafe-call\n          (getHookHandler(value) as any)(...params)\n        ]);\n\n        return resultB && resultA ? defu(resultA, resultB) : resultA || resultB;\n      }\n    };\n    return true;\n  }\n\n  return false;\n});\n\n/**\n * Merges two {@link Plugin | plugins} or {@link PartialPlugin | partial plugins} together.\n *\n * @param pluginA - The first {@link Plugin | plugin} or {@link PartialPlugin | partial plugin} to merge.\n * @param pluginB - The second {@link Plugin | plugin} or {@link PartialPlugin | partial plugin} to merge.\n * @returns The merged {@link Plugin | plugin} or {@link PartialPlugin | partial plugin}.\n */\nexport function merge<TContext extends PluginContext = PluginContext>(\n  pluginA: Plugin<TContext> | PartialPlugin<TContext>,\n  pluginB: Plugin<TContext> | PartialPlugin<TContext>\n): MergeResult<TContext, typeof pluginA, typeof pluginB> {\n  return mergePlugin(pluginA, pluginB) as MergeResult<\n    TContext,\n    typeof pluginA,\n    typeof pluginB\n  >;\n}\n\n/**\n * Merges two configuration objects together, with special handling for string values.\n * If the value from the second object is a non-empty string, it will overwrite the value from the first object.\n *\n * @example\n * ```ts\n * const configA = { name: \"Default\", version: \"1.0.0\" };\n * const configB = { name: \"Custom\", description: \"A custom config\" };\n * const mergedConfig = mergeConfig(configA, configB);\n * // Result: { name: \"Custom\", version: \"1.0.0\", description: \"A custom config\" }\n * ```\n *\n * @param objA - The first configuration object.\n * @param objB - The second configuration object.\n * @returns The merged configuration object.\n */\nexport const mergeConfig = createDefu((obj, key, value) => {\n  type TValue = (typeof obj)[typeof key];\n\n  if (key === \"input\" && isSet(value)) {\n    if (isString(obj[key]) && Array.isArray(value) && value.length === 0) {\n      return true;\n    }\n\n    obj[key] = value;\n    if (isSetArray(obj[key])) {\n      obj[key] = getUnique(obj[key]) as TValue;\n    }\n\n    return true;\n  }\n\n  if (key === \"compatibilityDate\" && isSetString(value)) {\n    obj[key] = value;\n    return true;\n  }\n\n  if (\n    (key === \"format\" || key === \"output.format\") &&\n    (isSetString(value) || isSetArray(value))\n  ) {\n    obj[key] = value;\n    if (isSetArray(obj[key])) {\n      obj[key] = getUnique(obj[key]) as TValue;\n    }\n\n    return true;\n  }\n\n  if (isString(obj[key]) && isString(value)) {\n    if (isSetString(value)) {\n      obj[key] = value;\n    }\n    return true;\n  }\n\n  return false;\n}) as (...configs: unknown[]) => ResolvedConfig;\n"],"mappings":";;;;;;;;;AA2CA,MAAM,cAAc,YAAY,KAAK,KAAK,UAAU;AAClD,KAAI,aAAa,IAAI,KAAK,IAAI,aAAa,MAAM,EAAE;AACjD,MAAI,OAAO;GACT,GAAG,IAAI;GACP,GAAG;GACH,SAAS,OAAO,GAAG,WAAkB;IACnC,MAAM,CAAC,SAAS,WAAW,MAAM,QAAQ,IAAI,CAE1C,eAAe,IAAI,KAAK,CAAS,GAAG,OAAO,EAE3C,eAAe,MAAM,CAAS,GAAG,OAAO,CAC1C,CAAC;AAEF,WAAO,WAAW,UAAU,KAAK,SAAS,QAAQ,GAAG,WAAW;;GAEnE;AACD,SAAO;;AAGT,QAAO;EACP;;;;;;;;AASF,SAAgB,MACd,SACA,SACuD;AACvD,QAAO,YAAY,SAAS,QAAQ;;;;;;;;;;;;;;;;;;AAuBtC,MAAa,cAAc,YAAY,KAAK,KAAK,UAAU;AAGzD,KAAI,QAAQ,WAAW,MAAM,MAAM,EAAE;AACnC,MAAI,SAAS,IAAI,KAAK,IAAI,MAAM,QAAQ,MAAM,IAAI,MAAM,WAAW,EACjE,QAAO;AAGT,MAAI,OAAO;AACX,MAAI,WAAW,IAAI,KAAK,CACtB,KAAI,OAAO,UAAU,IAAI,KAAK;AAGhC,SAAO;;AAGT,KAAI,QAAQ,uBAAuB,YAAY,MAAM,EAAE;AACrD,MAAI,OAAO;AACX,SAAO;;AAGT,MACG,QAAQ,YAAY,QAAQ,qBAC5B,YAAY,MAAM,IAAI,WAAW,MAAM,GACxC;AACA,MAAI,OAAO;AACX,MAAI,WAAW,IAAI,KAAK,CACtB,KAAI,OAAO,UAAU,IAAI,KAAK;AAGhC,SAAO;;AAGT,KAAI,SAAS,IAAI,KAAK,IAAI,SAAS,MAAM,EAAE;AACzC,MAAI,YAAY,MAAM,CACpB,KAAI,OAAO;AAEb,SAAO;;AAGT,QAAO;EACP"}
+{"version":3,"file":"merge.mjs","names":[],"sources":["../../src/plugin-utils/merge.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { getUnique } from \"@stryke/helpers/get-unique\";\nimport { isSet } from \"@stryke/type-checks/is-set\";\nimport { isSetArray } from \"@stryke/type-checks/is-set-array\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { isString } from \"@stryke/type-checks/is-string\";\nimport defu, { createDefu } from \"defu\";\nimport type {\n  PartialPlugin,\n  Plugin,\n  PluginContext,\n  ResolvedConfig\n} from \"../types\";\nimport { getHookHandler, isPluginHook } from \"./helpers\";\n\nexport type MergeResult<\n  TContext extends PluginContext,\n  TPluginA extends Plugin<TContext> | PartialPlugin<TContext>,\n  TPluginB extends Plugin<TContext> | PartialPlugin<TContext>\n> =\n  TPluginA extends Plugin<TContext>\n    ? Plugin<TContext>\n    : TPluginB extends Plugin<TContext>\n      ? Plugin<TContext>\n      : PartialPlugin<TContext>;\n\nconst mergePlugin = createDefu((obj, key, value) => {\n  if (isPluginHook(obj[key]) && isPluginHook(value)) {\n    obj[key] = {\n      ...obj[key],\n      ...value,\n      handler: async (...params: any[]) => {\n        const [resultA, resultB] = await Promise.all([\n          // eslint-disable-next-line ts/no-unsafe-call\n          (getHookHandler(obj[key]) as any)(...params),\n          // eslint-disable-next-line ts/no-unsafe-call\n          (getHookHandler(value) as any)(...params)\n        ]);\n\n        return resultB && resultA ? defu(resultA, resultB) : resultA || resultB;\n      }\n    };\n    return true;\n  }\n\n  return false;\n});\n\n/**\n * Merges two {@link Plugin | plugins} or {@link PartialPlugin | partial plugins} together.\n *\n * @param pluginA - The first {@link Plugin | plugin} or {@link PartialPlugin | partial plugin} to merge.\n * @param pluginB - The second {@link Plugin | plugin} or {@link PartialPlugin | partial plugin} to merge.\n * @returns The merged {@link Plugin | plugin} or {@link PartialPlugin | partial plugin}.\n */\nexport function merge<TContext extends PluginContext = PluginContext>(\n  pluginA: Plugin<TContext> | PartialPlugin<TContext>,\n  pluginB: Plugin<TContext> | PartialPlugin<TContext>\n): MergeResult<TContext, typeof pluginA, typeof pluginB> {\n  return mergePlugin(pluginA, pluginB) as MergeResult<\n    TContext,\n    typeof pluginA,\n    typeof pluginB\n  >;\n}\n\n/**\n * Merges two configuration objects together, with special handling for string values.\n * If the value from the second object is a non-empty string, it will overwrite the value from the first object.\n *\n * @example\n * ```ts\n * const configA = { name: \"Default\", version: \"1.0.0\" };\n * const configB = { name: \"Custom\", description: \"A custom config\" };\n * const mergedConfig = mergeConfig(configA, configB);\n * // Result: { name: \"Custom\", version: \"1.0.0\", description: \"A custom config\" }\n * ```\n *\n * @param objA - The first configuration object.\n * @param objB - The second configuration object.\n * @returns The merged configuration object.\n */\nexport const mergeConfig = createDefu((obj, key, value) => {\n  type TValue = (typeof obj)[typeof key];\n\n  if (key === \"input\" && isSet(value)) {\n    if (isString(obj[key]) && Array.isArray(value) && value.length === 0) {\n      return true;\n    }\n\n    obj[key] = value;\n    if (isSetArray(obj[key])) {\n      obj[key] = getUnique(obj[key]) as TValue;\n    }\n\n    return true;\n  }\n\n  if (key === \"compatibilityDate\" && isSetString(value)) {\n    obj[key] = value;\n    return true;\n  }\n\n  if (\n    (key === \"format\" || key === \"output.format\") &&\n    (isSetString(value) || isSetArray(value))\n  ) {\n    obj[key] = value;\n    if (isSetArray(obj[key])) {\n      obj[key] = getUnique(obj[key]) as TValue;\n    }\n\n    return true;\n  }\n\n  if (!isSet(obj[key]) && isString(value)) {\n    obj[key] = value;\n    return true;\n  }\n\n  return false;\n}) as (...configs: unknown[]) => ResolvedConfig;\n"],"mappings":";;;;;;;;;AA2CA,MAAM,cAAc,YAAY,KAAK,KAAK,UAAU;AAClD,KAAI,aAAa,IAAI,KAAK,IAAI,aAAa,MAAM,EAAE;AACjD,MAAI,OAAO;GACT,GAAG,IAAI;GACP,GAAG;GACH,SAAS,OAAO,GAAG,WAAkB;IACnC,MAAM,CAAC,SAAS,WAAW,MAAM,QAAQ,IAAI,CAE1C,eAAe,IAAI,KAAK,CAAS,GAAG,OAAO,EAE3C,eAAe,MAAM,CAAS,GAAG,OAAO,CAC1C,CAAC;AAEF,WAAO,WAAW,UAAU,KAAK,SAAS,QAAQ,GAAG,WAAW;;GAEnE;AACD,SAAO;;AAGT,QAAO;EACP;;;;;;;;AASF,SAAgB,MACd,SACA,SACuD;AACvD,QAAO,YAAY,SAAS,QAAQ;;;;;;;;;;;;;;;;;;AAuBtC,MAAa,cAAc,YAAY,KAAK,KAAK,UAAU;AAGzD,KAAI,QAAQ,WAAW,MAAM,MAAM,EAAE;AACnC,MAAI,SAAS,IAAI,KAAK,IAAI,MAAM,QAAQ,MAAM,IAAI,MAAM,WAAW,EACjE,QAAO;AAGT,MAAI,OAAO;AACX,MAAI,WAAW,IAAI,KAAK,CACtB,KAAI,OAAO,UAAU,IAAI,KAAK;AAGhC,SAAO;;AAGT,KAAI,QAAQ,uBAAuB,YAAY,MAAM,EAAE;AACrD,MAAI,OAAO;AACX,SAAO;;AAGT,MACG,QAAQ,YAAY,QAAQ,qBAC5B,YAAY,MAAM,IAAI,WAAW,MAAM,GACxC;AACA,MAAI,OAAO;AACX,MAAI,WAAW,IAAI,KAAK,CACtB,KAAI,OAAO,UAAU,IAAI,KAAK;AAGhC,SAAO;;AAGT,KAAI,CAAC,MAAM,IAAI,KAAK,IAAI,SAAS,MAAM,EAAE;AACvC,MAAI,OAAO;AACX,SAAO;;AAGT,QAAO;EACP"}

package/dist/plugin-utils/modules.cjs

@@ -9,7 +9,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 * @returns `true` if the module is a built-in module, otherwise `false`.
 */
 function isBuiltinModule(context, moduleName) {
-	const prefix = context.config?.framework || "powerlines";
+	const prefix = context.config?.framework?.name || "powerlines";
 	return moduleName.startsWith(`${prefix.replace(/:$/, "")}:`) || Object.keys(context.fs.metadata).filter((key) => context.fs.metadata[key]?.type === "builtin").includes(moduleName);
 }
 

package/dist/plugin-utils/modules.mjs

@@ -7,7 +7,7 @@
 * @returns `true` if the module is a built-in module, otherwise `false`.
 */
 function isBuiltinModule(context, moduleName) {
-	const prefix = context.config?.framework || "powerlines";
+	const prefix = context.config?.framework?.name || "powerlines";
 	return moduleName.startsWith(`${prefix.replace(/:$/, "")}:`) || Object.keys(context.fs.metadata).filter((key) => context.fs.metadata[key]?.type === "builtin").includes(moduleName);
 }
 

package/dist/plugin-utils/modules.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"modules.mjs","names":[],"sources":["../../src/plugin-utils/modules.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { Context } from \"../types/context\";\n\n/**\n * Determine if a module ID is a built-in Powerlines module ID.\n *\n * @param context - The Powerlines context.\n * @param moduleName - The name of the module to check.\n * @returns `true` if the module is a built-in module, otherwise `false`.\n */\nexport function isBuiltinModule(context: Context, moduleName: string): boolean {\n  const prefix: string = context.config?.framework || \"powerlines\";\n\n  return (\n    moduleName.startsWith(`${prefix.replace(/:$/, \"\")}:`) ||\n    Object.keys(context.fs.metadata)\n      .filter(key => context.fs.metadata[key]?.type === \"builtin\")\n      .includes(moduleName)\n  );\n}\n"],"mappings":";;;;;;;;AA2BA,SAAgB,gBAAgB,SAAkB,YAA6B;CAC7E,MAAM,SAAiB,QAAQ,QAAQ,aAAa;AAEpD,QACE,WAAW,WAAW,GAAG,OAAO,QAAQ,MAAM,GAAG,CAAC,GAAG,IACrD,OAAO,KAAK,QAAQ,GAAG,SAAS,CAC7B,QAAO,QAAO,QAAQ,GAAG,SAAS,MAAM,SAAS,UAAU,CAC3D,SAAS,WAAW"}
+{"version":3,"file":"modules.mjs","names":[],"sources":["../../src/plugin-utils/modules.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { Context } from \"../types/context\";\n\n/**\n * Determine if a module ID is a built-in Powerlines module ID.\n *\n * @param context - The Powerlines context.\n * @param moduleName - The name of the module to check.\n * @returns `true` if the module is a built-in module, otherwise `false`.\n */\nexport function isBuiltinModule(context: Context, moduleName: string): boolean {\n  const prefix: string = context.config?.framework?.name || \"powerlines\";\n\n  return (\n    moduleName.startsWith(`${prefix.replace(/:$/, \"\")}:`) ||\n    Object.keys(context.fs.metadata)\n      .filter(key => context.fs.metadata[key]?.type === \"builtin\")\n      .includes(moduleName)\n  );\n}\n"],"mappings":";;;;;;;;AA2BA,SAAgB,gBAAgB,SAAkB,YAA6B;CAC7E,MAAM,SAAiB,QAAQ,QAAQ,WAAW,QAAQ;AAE1D,QACE,WAAW,WAAW,GAAG,OAAO,QAAQ,MAAM,GAAG,CAAC,GAAG,IACrD,OAAO,KAAK,QAAQ,GAAG,SAAS,CAC7B,QAAO,QAAO,QAAQ,GAAG,SAAS,MAAM,SAAS,UAAU,CAC3D,SAAS,WAAW"}

package/dist/plugin-utils/paths.cjs

@@ -10,10 +10,11 @@ let _stryke_path_join = require("@stryke/path/join");
 *
 * @remarks
 * The following tokens are supported:
-* - `{workspaceRoot}` - The root directory of the workspace.
+* - `{cwd}` - The current working directory.
+* - `{workspaceRoot}` - The current working directory (same as `{cwd}`).
 * - `{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`).
+* - `{sourceRoot}` - The source root directory of the project (usually `{root}/src`).
 * - `{powerlinesPath}` - The directory where Powerlines is installed.
 * - `{cachePath}` - The environment's directory for cached files.
 * - `{dataPath}` - The environment's directory for data files.
@@ -28,14 +29,27 @@ let _stryke_path_join = require("@stryke/path/join");
 * - `{builtinPath}` - The configured directory for generated built-in plugins.
 * - `{entryPath}` - The configured directory for generated entry files.
 *
+* @example
+* ```ts
+* const path = replacePathTokens(context, "{root}/dist");
+* // If context.config.root is "/home/user/project", this will return "/home/user/project/dist"
+*
+* const pathWithCopy = replacePathTokens(context, "{copy}");
+* // If context.config.output.copy.path is "/home/user/project/dist-copy", this will return "/home/user/project/dist-copy"
+* ```
+*
 * @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;
-	const result = path.replaceAll("{workspaceRoot}", context.workspaceConfig.workspaceRoot).replaceAll("{root}", context.config.root).replaceAll("{projectRoot}", context.config.root).replaceAll("{sourceRoot}", (0, _stryke_path_join.joinPaths)(context.config.root, "src")).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.path).replaceAll("{output}", context.config.output.path).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));
-	return context.config.output.copy && (0, _stryke_type_checks_is_set_string.isSetString)(context.config.output.copy.path) ? result.replaceAll("{copyPath}", context.config.output.copy.path).replaceAll("{copy}", context.config.output.copy.path) : result;
+	let result = path.replaceAll("{cwd}", context.config.cwd || process.cwd()).replaceAll("{workspaceRoot}", context.config.cwd || process.cwd()).replaceAll("{root}", context.config.root).replaceAll("{projectRoot}", context.config.root).replaceAll("{sourceRoot}", (0, _stryke_path_join.joinPaths)(context.config.root, "src")).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("{artifactsPath}", (0, _stryke_path_replace.replacePath)(context.artifactsPath, context.config.cwd)).replaceAll("{builtinPath}", (0, _stryke_path_replace.replacePath)(context.builtinsPath, context.config.cwd)).replaceAll("{builtinsPath}", (0, _stryke_path_replace.replacePath)(context.builtinsPath, context.config.cwd)).replaceAll("{entryPath}", (0, _stryke_path_replace.replacePath)(context.entryPath, context.config.cwd));
+	if (context.config.output) {
+		if ((0, _stryke_type_checks_is_set_string.isSetString)(context.config.output.path)) result = result.replaceAll("{outputPath}", context.config.output.path).replaceAll("{output}", context.config.output.path);
+		if (context.config.output.copy && (0, _stryke_type_checks_is_set_string.isSetString)(context.config.output.copy?.path)) result = result.replaceAll("{copyPath}", context.config.output.copy.path).replaceAll("{copy}", context.config.output.copy.path);
+	}
+	return result;
 }
 
 //#endregion

package/dist/plugin-utils/paths.d.cts

@@ -7,10 +7,11 @@ import { IsUndefined } from "@stryke/types/base";
  *
  * @remarks
  * The following tokens are supported:
- * - `{workspaceRoot}` - The root directory of the workspace.
+ * - `{cwd}` - The current working directory.
+ * - `{workspaceRoot}` - The current working directory (same as `{cwd}`).
  * - `{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`).
+ * - `{sourceRoot}` - The source root directory of the project (usually `{root}/src`).
  * - `{powerlinesPath}` - The directory where Powerlines is installed.
  * - `{cachePath}` - The environment's directory for cached files.
  * - `{dataPath}` - The environment's directory for data files.
@@ -25,6 +26,15 @@ import { IsUndefined } from "@stryke/types/base";
  * - `{builtinPath}` - The configured directory for generated built-in plugins.
  * - `{entryPath}` - The configured directory for generated entry files.
  *
+ * @example
+ * ```ts
+ * const path = replacePathTokens(context, "{root}/dist");
+ * // If context.config.root is "/home/user/project", this will return "/home/user/project/dist"
+ *
+ * const pathWithCopy = replacePathTokens(context, "{copy}");
+ * // If context.config.output.copy.path is "/home/user/project/dist-copy", this will return "/home/user/project/dist-copy"
+ * ```
+ *
  * @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.

package/dist/plugin-utils/paths.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"paths.d.cts","names":[],"sources":["../../src/plugin-utils/paths.ts"],"mappings":";;;;;;AAmDA;;;;;;;;;;;;;;;;;;;;;;;;;iBAAgB,iBAAA,CACd,OAAA,EAAS,iBAAA,EACT,IAAA,YACC,WAAA,QAAmB,IAAA"}
+{"version":3,"file":"paths.d.cts","names":[],"sources":["../../src/plugin-utils/paths.ts"],"mappings":";;;;;;AA6DA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAAgB,iBAAA,CACd,OAAA,EAAS,iBAAA,EACT,IAAA,YACC,WAAA,QAAmB,IAAA"}

package/dist/plugin-utils/paths.d.mts

@@ -7,10 +7,11 @@ import { IsUndefined } from "@stryke/types/base";
  *
  * @remarks
  * The following tokens are supported:
- * - `{workspaceRoot}` - The root directory of the workspace.
+ * - `{cwd}` - The current working directory.
+ * - `{workspaceRoot}` - The current working directory (same as `{cwd}`).
  * - `{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`).
+ * - `{sourceRoot}` - The source root directory of the project (usually `{root}/src`).
  * - `{powerlinesPath}` - The directory where Powerlines is installed.
  * - `{cachePath}` - The environment's directory for cached files.
  * - `{dataPath}` - The environment's directory for data files.
@@ -25,6 +26,15 @@ import { IsUndefined } from "@stryke/types/base";
  * - `{builtinPath}` - The configured directory for generated built-in plugins.
  * - `{entryPath}` - The configured directory for generated entry files.
  *
+ * @example
+ * ```ts
+ * const path = replacePathTokens(context, "{root}/dist");
+ * // If context.config.root is "/home/user/project", this will return "/home/user/project/dist"
+ *
+ * const pathWithCopy = replacePathTokens(context, "{copy}");
+ * // If context.config.output.copy.path is "/home/user/project/dist-copy", this will return "/home/user/project/dist-copy"
+ * ```
+ *
  * @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.

package/dist/plugin-utils/paths.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"paths.d.mts","names":[],"sources":["../../src/plugin-utils/paths.ts"],"mappings":";;;;;;AAmDA;;;;;;;;;;;;;;;;;;;;;;;;;iBAAgB,iBAAA,CACd,OAAA,EAAS,iBAAA,EACT,IAAA,YACC,WAAA,QAAmB,IAAA"}
+{"version":3,"file":"paths.d.mts","names":[],"sources":["../../src/plugin-utils/paths.ts"],"mappings":";;;;;;AA6DA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAAgB,iBAAA,CACd,OAAA,EAAS,iBAAA,EACT,IAAA,YACC,WAAA,QAAmB,IAAA"}

package/dist/plugin-utils/paths.mjs

@@ -8,10 +8,11 @@ import { joinPaths } from "@stryke/path/join";
 *
 * @remarks
 * The following tokens are supported:
-* - `{workspaceRoot}` - The root directory of the workspace.
+* - `{cwd}` - The current working directory.
+* - `{workspaceRoot}` - The current working directory (same as `{cwd}`).
 * - `{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`).
+* - `{sourceRoot}` - The source root directory of the project (usually `{root}/src`).
 * - `{powerlinesPath}` - The directory where Powerlines is installed.
 * - `{cachePath}` - The environment's directory for cached files.
 * - `{dataPath}` - The environment's directory for data files.
@@ -26,14 +27,27 @@ import { joinPaths } from "@stryke/path/join";
 * - `{builtinPath}` - The configured directory for generated built-in plugins.
 * - `{entryPath}` - The configured directory for generated entry files.
 *
+* @example
+* ```ts
+* const path = replacePathTokens(context, "{root}/dist");
+* // If context.config.root is "/home/user/project", this will return "/home/user/project/dist"
+*
+* const pathWithCopy = replacePathTokens(context, "{copy}");
+* // If context.config.output.copy.path is "/home/user/project/dist-copy", this will return "/home/user/project/dist-copy"
+* ```
+*
 * @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;
-	const result = path.replaceAll("{workspaceRoot}", context.workspaceConfig.workspaceRoot).replaceAll("{root}", context.config.root).replaceAll("{projectRoot}", context.config.root).replaceAll("{sourceRoot}", joinPaths(context.config.root, "src")).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.path).replaceAll("{output}", context.config.output.path).replaceAll("{artifactsPath}", replacePath(context.artifactsPath, context.workspaceConfig.workspaceRoot)).replaceAll("{builtinPath}", replacePath(context.builtinsPath, context.workspaceConfig.workspaceRoot)).replaceAll("{entryPath}", replacePath(context.entryPath, context.workspaceConfig.workspaceRoot));
-	return context.config.output.copy && isSetString(context.config.output.copy.path) ? result.replaceAll("{copyPath}", context.config.output.copy.path).replaceAll("{copy}", context.config.output.copy.path) : result;
+	let result = path.replaceAll("{cwd}", context.config.cwd || process.cwd()).replaceAll("{workspaceRoot}", context.config.cwd || process.cwd()).replaceAll("{root}", context.config.root).replaceAll("{projectRoot}", context.config.root).replaceAll("{sourceRoot}", joinPaths(context.config.root, "src")).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("{artifactsPath}", replacePath(context.artifactsPath, context.config.cwd)).replaceAll("{builtinPath}", replacePath(context.builtinsPath, context.config.cwd)).replaceAll("{builtinsPath}", replacePath(context.builtinsPath, context.config.cwd)).replaceAll("{entryPath}", replacePath(context.entryPath, context.config.cwd));
+	if (context.config.output) {
+		if (isSetString(context.config.output.path)) result = result.replaceAll("{outputPath}", context.config.output.path).replaceAll("{output}", context.config.output.path);
+		if (context.config.output.copy && isSetString(context.config.output.copy?.path)) result = result.replaceAll("{copyPath}", context.config.output.copy.path).replaceAll("{copy}", context.config.output.copy.path);
+	}
+	return result;
 }
 
 //#endregion

package/dist/plugin-utils/paths.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"paths.mjs","names":[],"sources":["../../src/plugin-utils/paths.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { joinPaths } from \"@stryke/path/join\";\nimport { replacePath } from \"@stryke/path/replace\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { IsUndefined } from \"@stryke/types/base\";\nimport { UnresolvedContext } from \"../types/context\";\n\n/**\n * Replaces tokens in the given path string with their corresponding values from the context.\n *\n * @remarks\n * The following tokens are supported:\n * - `{workspaceRoot}` - The root directory of the workspace.\n * - `{root}` - The root directory of the project (same as `{projectRoot}`).\n * - `{projectRoot}` - The root directory of the project (same as `{root}`).\n * - `{sourceRoot}` - The source root directory of the project (usually `./src`).\n * - `{powerlinesPath}` - The directory where Powerlines is installed.\n * - `{cachePath}` - The environment's directory for cached files.\n * - `{dataPath}` - The environment's directory for data files.\n * - `{logPath}` - The environment's directory for log files.\n * - `{tempPath}` - The environment's directory for temporary files.\n * - `{configPath}` - The environment's directory for configuration files.\n * - `{output}` - The configured output directory for the project.\n * - `{outputPath}` - The configured output directory for the project.\n * - `{copy}` - The configured final/copied distribution directory for the project.\n * - `{copyPath}` - The configured final/copied distribution directory for the project.\n * - `{artifactsPath}` - The configured directory for build artifacts.\n * - `{builtinPath}` - The configured directory for generated built-in plugins.\n * - `{entryPath}` - The configured directory for generated entry files.\n *\n * @param context - The context containing the values for the path tokens.\n * @param path - The path string with tokens to replace.\n * @returns The path string with tokens replaced by their corresponding values from the context.\n */\nexport function replacePathTokens(\n  context: UnresolvedContext,\n  path?: string\n): IsUndefined<typeof path> extends true ? undefined : string {\n  if (!path) {\n    return path as IsUndefined<typeof path> extends true ? undefined : string;\n  }\n\n  const result = path\n    .replaceAll(\"{workspaceRoot}\", context.workspaceConfig.workspaceRoot)\n    .replaceAll(\"{root}\", context.config.root)\n    .replaceAll(\"{projectRoot}\", context.config.root)\n    .replaceAll(\"{sourceRoot}\", joinPaths(context.config.root, \"src\"))\n    .replaceAll(\"{powerlinesPath}\", context.powerlinesPath)\n    .replaceAll(\"{cachePath}\", context.cachePath)\n    .replaceAll(\"{dataPath}\", context.dataPath)\n    .replaceAll(\"{logPath}\", context.envPaths.log)\n    .replaceAll(\"{tempPath}\", context.envPaths.temp)\n    .replaceAll(\"{configPath}\", context.envPaths.config)\n    .replaceAll(\"{outputPath}\", context.config.output.path)\n    .replaceAll(\"{output}\", context.config.output.path)\n\n    .replaceAll(\n      \"{artifactsPath}\",\n      replacePath(context.artifactsPath, context.workspaceConfig.workspaceRoot)\n    )\n    .replaceAll(\n      \"{builtinPath}\",\n      replacePath(context.builtinsPath, context.workspaceConfig.workspaceRoot)\n    )\n    .replaceAll(\n      \"{entryPath}\",\n      replacePath(context.entryPath, context.workspaceConfig.workspaceRoot)\n    );\n\n  return context.config.output.copy &&\n    isSetString(context.config.output.copy.path)\n    ? result\n        .replaceAll(\"{copyPath}\", context.config.output.copy.path)\n        .replaceAll(\"{copy}\", context.config.output.copy.path)\n    : result;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmDA,SAAgB,kBACd,SACA,MAC4D;AAC5D,KAAI,CAAC,KACH,QAAO;CAGT,MAAM,SAAS,KACZ,WAAW,mBAAmB,QAAQ,gBAAgB,cAAc,CACpE,WAAW,UAAU,QAAQ,OAAO,KAAK,CACzC,WAAW,iBAAiB,QAAQ,OAAO,KAAK,CAChD,WAAW,gBAAgB,UAAU,QAAQ,OAAO,MAAM,MAAM,CAAC,CACjE,WAAW,oBAAoB,QAAQ,eAAe,CACtD,WAAW,eAAe,QAAQ,UAAU,CAC5C,WAAW,cAAc,QAAQ,SAAS,CAC1C,WAAW,aAAa,QAAQ,SAAS,IAAI,CAC7C,WAAW,cAAc,QAAQ,SAAS,KAAK,CAC/C,WAAW,gBAAgB,QAAQ,SAAS,OAAO,CACnD,WAAW,gBAAgB,QAAQ,OAAO,OAAO,KAAK,CACtD,WAAW,YAAY,QAAQ,OAAO,OAAO,KAAK,CAElD,WACC,mBACA,YAAY,QAAQ,eAAe,QAAQ,gBAAgB,cAAc,CAC1E,CACA,WACC,iBACA,YAAY,QAAQ,cAAc,QAAQ,gBAAgB,cAAc,CACzE,CACA,WACC,eACA,YAAY,QAAQ,WAAW,QAAQ,gBAAgB,cAAc,CACtE;AAEH,QAAO,QAAQ,OAAO,OAAO,QAC3B,YAAY,QAAQ,OAAO,OAAO,KAAK,KAAK,GAC1C,OACG,WAAW,cAAc,QAAQ,OAAO,OAAO,KAAK,KAAK,CACzD,WAAW,UAAU,QAAQ,OAAO,OAAO,KAAK,KAAK,GACxD"}
+{"version":3,"file":"paths.mjs","names":[],"sources":["../../src/plugin-utils/paths.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { joinPaths } from \"@stryke/path/join\";\nimport { replacePath } from \"@stryke/path/replace\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { IsUndefined } from \"@stryke/types/base\";\nimport { UnresolvedContext } from \"../types/context\";\n\n/**\n * Replaces tokens in the given path string with their corresponding values from the context.\n *\n * @remarks\n * The following tokens are supported:\n * - `{cwd}` - The current working directory.\n * - `{workspaceRoot}` - The current working directory (same as `{cwd}`).\n * - `{root}` - The root directory of the project (same as `{projectRoot}`).\n * - `{projectRoot}` - The root directory of the project (same as `{root}`).\n * - `{sourceRoot}` - The source root directory of the project (usually `{root}/src`).\n * - `{powerlinesPath}` - The directory where Powerlines is installed.\n * - `{cachePath}` - The environment's directory for cached files.\n * - `{dataPath}` - The environment's directory for data files.\n * - `{logPath}` - The environment's directory for log files.\n * - `{tempPath}` - The environment's directory for temporary files.\n * - `{configPath}` - The environment's directory for configuration files.\n * - `{output}` - The configured output directory for the project.\n * - `{outputPath}` - The configured output directory for the project.\n * - `{copy}` - The configured final/copied distribution directory for the project.\n * - `{copyPath}` - The configured final/copied distribution directory for the project.\n * - `{artifactsPath}` - The configured directory for build artifacts.\n * - `{builtinPath}` - The configured directory for generated built-in plugins.\n * - `{entryPath}` - The configured directory for generated entry files.\n *\n * @example\n * ```ts\n * const path = replacePathTokens(context, \"{root}/dist\");\n * // If context.config.root is \"/home/user/project\", this will return \"/home/user/project/dist\"\n *\n * const pathWithCopy = replacePathTokens(context, \"{copy}\");\n * // If context.config.output.copy.path is \"/home/user/project/dist-copy\", this will return \"/home/user/project/dist-copy\"\n * ```\n *\n * @param context - The context containing the values for the path tokens.\n * @param path - The path string with tokens to replace.\n * @returns The path string with tokens replaced by their corresponding values from the context.\n */\nexport function replacePathTokens(\n  context: UnresolvedContext,\n  path?: string\n): IsUndefined<typeof path> extends true ? undefined : string {\n  if (!path) {\n    return path as IsUndefined<typeof path> extends true ? undefined : string;\n  }\n\n  let result = path\n    .replaceAll(\"{cwd}\", context.config.cwd || process.cwd())\n    .replaceAll(\"{workspaceRoot}\", context.config.cwd || process.cwd())\n    .replaceAll(\"{root}\", context.config.root)\n    .replaceAll(\"{projectRoot}\", context.config.root)\n    .replaceAll(\"{sourceRoot}\", joinPaths(context.config.root, \"src\"))\n    .replaceAll(\"{powerlinesPath}\", context.powerlinesPath)\n    .replaceAll(\"{cachePath}\", context.cachePath)\n    .replaceAll(\"{dataPath}\", context.dataPath)\n    .replaceAll(\"{logPath}\", context.envPaths.log)\n    .replaceAll(\"{tempPath}\", context.envPaths.temp)\n    .replaceAll(\"{configPath}\", context.envPaths.config)\n    .replaceAll(\n      \"{artifactsPath}\",\n      replacePath(context.artifactsPath, context.config.cwd)\n    )\n    .replaceAll(\n      \"{builtinPath}\",\n      replacePath(context.builtinsPath, context.config.cwd)\n    )\n    .replaceAll(\n      \"{builtinsPath}\",\n      replacePath(context.builtinsPath, context.config.cwd)\n    )\n    .replaceAll(\n      \"{entryPath}\",\n      replacePath(context.entryPath, context.config.cwd)\n    );\n\n  if (context.config.output) {\n    if (isSetString(context.config.output.path)) {\n      result = result\n        .replaceAll(\"{outputPath}\", context.config.output.path)\n        .replaceAll(\"{output}\", context.config.output.path);\n    }\n    if (\n      context.config.output.copy &&\n      isSetString(context.config.output.copy?.path)\n    ) {\n      result = result\n        .replaceAll(\"{copyPath}\", context.config.output.copy.path)\n        .replaceAll(\"{copy}\", context.config.output.copy.path);\n    }\n  }\n\n  return result;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6DA,SAAgB,kBACd,SACA,MAC4D;AAC5D,KAAI,CAAC,KACH,QAAO;CAGT,IAAI,SAAS,KACV,WAAW,SAAS,QAAQ,OAAO,OAAO,QAAQ,KAAK,CAAC,CACxD,WAAW,mBAAmB,QAAQ,OAAO,OAAO,QAAQ,KAAK,CAAC,CAClE,WAAW,UAAU,QAAQ,OAAO,KAAK,CACzC,WAAW,iBAAiB,QAAQ,OAAO,KAAK,CAChD,WAAW,gBAAgB,UAAU,QAAQ,OAAO,MAAM,MAAM,CAAC,CACjE,WAAW,oBAAoB,QAAQ,eAAe,CACtD,WAAW,eAAe,QAAQ,UAAU,CAC5C,WAAW,cAAc,QAAQ,SAAS,CAC1C,WAAW,aAAa,QAAQ,SAAS,IAAI,CAC7C,WAAW,cAAc,QAAQ,SAAS,KAAK,CAC/C,WAAW,gBAAgB,QAAQ,SAAS,OAAO,CACnD,WACC,mBACA,YAAY,QAAQ,eAAe,QAAQ,OAAO,IAAI,CACvD,CACA,WACC,iBACA,YAAY,QAAQ,cAAc,QAAQ,OAAO,IAAI,CACtD,CACA,WACC,kBACA,YAAY,QAAQ,cAAc,QAAQ,OAAO,IAAI,CACtD,CACA,WACC,eACA,YAAY,QAAQ,WAAW,QAAQ,OAAO,IAAI,CACnD;AAEH,KAAI,QAAQ,OAAO,QAAQ;AACzB,MAAI,YAAY,QAAQ,OAAO,OAAO,KAAK,CACzC,UAAS,OACN,WAAW,gBAAgB,QAAQ,OAAO,OAAO,KAAK,CACtD,WAAW,YAAY,QAAQ,OAAO,OAAO,KAAK;AAEvD,MACE,QAAQ,OAAO,OAAO,QACtB,YAAY,QAAQ,OAAO,OAAO,MAAM,KAAK,CAE7C,UAAS,OACN,WAAW,cAAc,QAAQ,OAAO,OAAO,KAAK,KAAK,CACzD,WAAW,UAAU,QAAQ,OAAO,OAAO,KAAK,KAAK;;AAI5D,QAAO"}

package/dist/plugin-utils/virtual.cjs

@@ -0,0 +1,80 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+//#region src/plugin-utils/virtual.ts
+const ESCAPE_REGEX = /[-/\\^$*+?.()|[\]{}]/g;
+function escapeRegex(str) {
+	return str.replace(ESCAPE_REGEX, "\\$&");
+}
+const VIRTUAL_MODULE_PREFIX = "\0";
+const VIRTUAL_MODULE_PREFIX_REGEX = prefixRegex("\0");
+/**
+* Constructs a RegExp that matches a value that has the specified prefix. This is useful for plugin hook filters.
+*
+* @example
+* ```ts
+* import { prefixRegex } from '@rolldown/pluginutils';
+* const plugin = {
+*   name: 'plugin',
+*   resolveId: {
+*     filter: { id: prefixRegex('foo') },
+*     handler(id) {} // will only be called for IDs starting with `foo`
+*   }
+* }
+* ```
+*
+* @param str - the string to match.
+* @param options - options for the RegExp.
+* @return a RegExp that matches the specified string with the specified prefix.
+*/
+function prefixRegex(str, options = {}) {
+	const { flags, prefix, isPrefixOptional = false } = options;
+	return new RegExp(`^${prefix ? isPrefixOptional ? `(${escapeRegex(prefix)})?` : `${escapeRegex(prefix)}` : ""}${escapeRegex(str)}`, flags);
+}
+/**
+* Adds the virtual module prefix to the given ID.
+*
+* @param id - The ID to add the virtual module prefix to.
+* @returns The ID with the virtual module prefix added.
+*/
+function addVirtualPrefix(id) {
+	return `${"\0"}${id}`;
+}
+/**
+* Removes the virtual module prefix from the given ID, if it exists.
+*
+* @param id - The ID to remove the virtual module prefix from.
+* @returns The ID without the virtual module prefix.
+*/
+function removeVirtualPrefix(id) {
+	return id.replace(VIRTUAL_MODULE_PREFIX_REGEX, "");
+}
+/**
+* Checks if the given ID is a virtual module by checking if it starts with the virtual module prefix.
+*
+* @param id - The ID to check.
+* @returns True if the ID is a virtual module, false otherwise.
+*/
+function isVirtualModule(id) {
+	return id.startsWith("\0");
+}
+/**
+* Creates a regular expression that matches the given ID with the virtual module prefix.
+*
+* @param id - The ID to create a regular expression for.
+* @returns A regular expression that matches the given ID with the virtual module prefix.
+*/
+function createVirtualPrefixRegex(id) {
+	return prefixRegex(removeVirtualPrefix(id), {
+		prefix: "\0",
+		isPrefixOptional: true
+	});
+}
+
+//#endregion
+exports.VIRTUAL_MODULE_PREFIX = VIRTUAL_MODULE_PREFIX;
+exports.VIRTUAL_MODULE_PREFIX_REGEX = VIRTUAL_MODULE_PREFIX_REGEX;
+exports.addVirtualPrefix = addVirtualPrefix;
+exports.createVirtualPrefixRegex = createVirtualPrefixRegex;
+exports.isVirtualModule = isVirtualModule;
+exports.prefixRegex = prefixRegex;
+exports.removeVirtualPrefix = removeVirtualPrefix;

package/dist/plugin-utils/virtual.d.cts

@@ -0,0 +1,69 @@
+//#region src/plugin-utils/virtual.d.ts
+declare const VIRTUAL_MODULE_PREFIX = "\0";
+declare const VIRTUAL_MODULE_PREFIX_REGEX: RegExp;
+interface PrefixRegexOptions {
+  /**
+   * Flags for the RegExp.
+   */
+  flags?: string;
+  /**
+   * The prefix to match. This will be escaped and used as the prefix in the generated RegExp.
+   */
+  prefix?: string;
+  /**
+   * Whether the prefix is optional. If true, the generated RegExp will match both strings that start with the prefix and strings that do not start with the prefix. Default is false.
+   */
+  isPrefixOptional?: boolean;
+}
+/**
+ * Constructs a RegExp that matches a value that has the specified prefix. This is useful for plugin hook filters.
+ *
+ * @example
+ * ```ts
+ * import { prefixRegex } from '@rolldown/pluginutils';
+ * const plugin = {
+ *   name: 'plugin',
+ *   resolveId: {
+ *     filter: { id: prefixRegex('foo') },
+ *     handler(id) {} // will only be called for IDs starting with `foo`
+ *   }
+ * }
+ * ```
+ *
+ * @param str - the string to match.
+ * @param options - options for the RegExp.
+ * @return a RegExp that matches the specified string with the specified prefix.
+ */
+declare function prefixRegex(str: string, options?: PrefixRegexOptions): RegExp;
+/**
+ * Adds the virtual module prefix to the given ID.
+ *
+ * @param id - The ID to add the virtual module prefix to.
+ * @returns The ID with the virtual module prefix added.
+ */
+declare function addVirtualPrefix(id: string): string;
+/**
+ * Removes the virtual module prefix from the given ID, if it exists.
+ *
+ * @param id - The ID to remove the virtual module prefix from.
+ * @returns The ID without the virtual module prefix.
+ */
+declare function removeVirtualPrefix(id: string): string;
+/**
+ * Checks if the given ID is a virtual module by checking if it starts with the virtual module prefix.
+ *
+ * @param id - The ID to check.
+ * @returns True if the ID is a virtual module, false otherwise.
+ */
+declare function isVirtualModule(id: string): boolean;
+/**
+ * Creates a regular expression that matches the given ID with the virtual module prefix.
+ *
+ * @param id - The ID to create a regular expression for.
+ * @returns A regular expression that matches the given ID with the virtual module prefix.
+ */
+declare function createVirtualPrefixRegex(id: string): RegExp;
+declare type __ΩPrefixRegexOptions = any[];
+//#endregion
+export { PrefixRegexOptions, VIRTUAL_MODULE_PREFIX, VIRTUAL_MODULE_PREFIX_REGEX, __ΩPrefixRegexOptions, addVirtualPrefix, createVirtualPrefixRegex, isVirtualModule, prefixRegex, removeVirtualPrefix };
+//# sourceMappingURL=virtual.d.cts.map

package/dist/plugin-utils/virtual.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtual.d.cts","names":[],"sources":["../../src/plugin-utils/virtual.ts"],"mappings":";cAuBa,qBAAA;AAAA,cACA,2BAAA,EAA2B,MAAA;AAAA,UAEvB,kBAAA;;;;EAIf,KAAA;EAN0D;;;EAW1D,MAAA;EATe;;;EAcf,gBAAA;AAAA;;;;;AAsBF;;;;;;;;;;AAwBA;;;;;iBAxBgB,WAAA,CACd,GAAA,UACA,OAAA,GAAS,kBAAA,GACR,MAAA;;;;;AAyCH;;iBApBgB,gBAAA,CAAiB,EAAA;;;AA8BjC;;;;iBApBgB,mBAAA,CAAoB,EAAA;;;;;;;iBAUpB,eAAA,CAAgB,EAAA;;;;;;;iBAUhB,wBAAA,CAAyB,EAAA,WAAa,MAAA;AAAA"}

package/dist/plugin-utils/virtual.d.mts

@@ -0,0 +1,69 @@
+//#region src/plugin-utils/virtual.d.ts
+declare const VIRTUAL_MODULE_PREFIX = "\0";
+declare const VIRTUAL_MODULE_PREFIX_REGEX: RegExp;
+interface PrefixRegexOptions {
+  /**
+   * Flags for the RegExp.
+   */
+  flags?: string;
+  /**
+   * The prefix to match. This will be escaped and used as the prefix in the generated RegExp.
+   */
+  prefix?: string;
+  /**
+   * Whether the prefix is optional. If true, the generated RegExp will match both strings that start with the prefix and strings that do not start with the prefix. Default is false.
+   */
+  isPrefixOptional?: boolean;
+}
+/**
+ * Constructs a RegExp that matches a value that has the specified prefix. This is useful for plugin hook filters.
+ *
+ * @example
+ * ```ts
+ * import { prefixRegex } from '@rolldown/pluginutils';
+ * const plugin = {
+ *   name: 'plugin',
+ *   resolveId: {
+ *     filter: { id: prefixRegex('foo') },
+ *     handler(id) {} // will only be called for IDs starting with `foo`
+ *   }
+ * }
+ * ```
+ *
+ * @param str - the string to match.
+ * @param options - options for the RegExp.
+ * @return a RegExp that matches the specified string with the specified prefix.
+ */
+declare function prefixRegex(str: string, options?: PrefixRegexOptions): RegExp;
+/**
+ * Adds the virtual module prefix to the given ID.
+ *
+ * @param id - The ID to add the virtual module prefix to.
+ * @returns The ID with the virtual module prefix added.
+ */
+declare function addVirtualPrefix(id: string): string;
+/**
+ * Removes the virtual module prefix from the given ID, if it exists.
+ *
+ * @param id - The ID to remove the virtual module prefix from.
+ * @returns The ID without the virtual module prefix.
+ */
+declare function removeVirtualPrefix(id: string): string;
+/**
+ * Checks if the given ID is a virtual module by checking if it starts with the virtual module prefix.
+ *
+ * @param id - The ID to check.
+ * @returns True if the ID is a virtual module, false otherwise.
+ */
+declare function isVirtualModule(id: string): boolean;
+/**
+ * Creates a regular expression that matches the given ID with the virtual module prefix.
+ *
+ * @param id - The ID to create a regular expression for.
+ * @returns A regular expression that matches the given ID with the virtual module prefix.
+ */
+declare function createVirtualPrefixRegex(id: string): RegExp;
+declare type __ΩPrefixRegexOptions = any[];
+//#endregion
+export { PrefixRegexOptions, VIRTUAL_MODULE_PREFIX, VIRTUAL_MODULE_PREFIX_REGEX, __ΩPrefixRegexOptions, addVirtualPrefix, createVirtualPrefixRegex, isVirtualModule, prefixRegex, removeVirtualPrefix };
+//# sourceMappingURL=virtual.d.mts.map

package/dist/plugin-utils/virtual.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtual.d.mts","names":[],"sources":["../../src/plugin-utils/virtual.ts"],"mappings":";cAuBa,qBAAA;AAAA,cACA,2BAAA,EAA2B,MAAA;AAAA,UAEvB,kBAAA;;;;EAIf,KAAA;EAN0D;;;EAW1D,MAAA;EATe;;;EAcf,gBAAA;AAAA;;;;;AAsBF;;;;;;;;;;AAwBA;;;;;iBAxBgB,WAAA,CACd,GAAA,UACA,OAAA,GAAS,kBAAA,GACR,MAAA;;;;;AAyCH;;iBApBgB,gBAAA,CAAiB,EAAA;;;AA8BjC;;;;iBApBgB,mBAAA,CAAoB,EAAA;;;;;;;iBAUpB,eAAA,CAAgB,EAAA;;;;;;;iBAUhB,wBAAA,CAAyB,EAAA,WAAa,MAAA;AAAA"}