@powerlines/plugin-esbuild 0.13.302 → 0.13.304

package/dist/core/src/types/plugin.d.cts

@@ -0,0 +1,204 @@
+import { CommandType } from "./commands.cjs";
+import { BuilderVariant, InferUnpluginOptions } from "./unplugin.cjs";
+import { EnvironmentConfig, EnvironmentResolvedConfig, PluginConfig, ResolvedConfig } from "./config.cjs";
+import { BuildPluginContext, PluginContext, UnresolvedContext } from "./context.cjs";
+import { ExternalIdResult, HookFilter, TransformResult } from "unplugin";
+import { AnyFunction, MaybePromise } from "@stryke/types/base";
+import { ArrayValues } from "@stryke/types/array";
+import { LoadResult } from "rollup";
+
+//#region ../core/src/types/plugin.d.ts
+interface PluginHookObject<THookFunction extends AnyFunction, TFilter extends keyof HookFilter = never> {
+  /**
+   * The order in which the plugin should be applied.
+   */
+  order?: "pre" | "post" | null | undefined;
+  /**
+   * A filter to determine when the hook should be called.
+   */
+  filter?: Pick<HookFilter, TFilter>;
+  /**
+   * The hook function to be called.
+   */
+  handler: THookFunction;
+}
+type PluginHook<THookFunction extends AnyFunction, TFilter extends keyof HookFilter = never> = THookFunction | PluginHookObject<THookFunction, TFilter>;
+/**
+ * A result returned by the plugin from the `types` hook that describes the declaration types output file.
+ */
+interface TypesResult {
+  directives?: string[];
+  code: string;
+}
+type PluginHookFunctions<TContext extends PluginContext> = { [TCommandType in CommandType]: (this: TContext) => MaybePromise<void> } & {
+  /**
+   * A function that returns configuration options to be merged with the build context's options.
+   *
+   * @remarks
+   * Modify config before it's resolved. The hook can either mutate {@link Context.config} on the passed-in context directly, or return a partial config object that will be deeply merged into existing config.
+   *
+   * @warning User plugins are resolved before running this hook so injecting other plugins inside the config hook will have no effect.
+   *
+   * @see https://vitejs.dev/guide/api-plugin#config
+   *
+   * @param this - The build context.
+   * @param config - The partial configuration object to be modified.
+   * @returns A promise that resolves to a partial configuration object.
+   */
+  config: (this: UnresolvedContext<TContext["config"]>) => MaybePromise<DeepPartial<TContext["config"]> & Record<string, any>>;
+  /**
+   * Modify environment configs before it's resolved. The hook can either mutate the passed-in environment config directly, or return a partial config object that will be deeply merged into existing config.
+   *
+   * @remarks
+   * This hook is called for each environment with a partially resolved environment config that already accounts for the default environment config values set at the root level. If plugins need to modify the config of a given environment, they should do it in this hook instead of the config hook. Leaving the config hook only for modifying the root default environment config.
+   *
+   * @see https://vitejs.dev/guide/api-plugin#configenvironment
+   *
+   * @param this - The build context.
+   * @param name - The name of the environment being configured.
+   * @param environment - The Vite-like environment object containing information about the current build environment.
+   * @returns A promise that resolves when the hook is complete.
+   */
+  configEnvironment: (this: TContext, name: string, environment: EnvironmentConfig) => MaybePromise<Partial<EnvironmentResolvedConfig> | undefined | null>;
+  /**
+   * A hook that is called when the plugin is resolved.
+   *
+   * @see https://vitejs.dev/guide/api-plugin#configresolved
+   *
+   * @param this - The build context.
+   * @returns A promise that resolves when the hook is complete.
+   */
+  configResolved: (this: TContext) => MaybePromise<void>;
+  /**
+   * A hook that is called to overwrite the generated declaration types file (.d.ts). The generated type definitions should describe the built-in modules/logic added during the `prepare` task.
+   *
+   * @param this - The build context.
+   * @param code - The source code to generate types for.
+   * @returns A promise that resolves when the hook is complete.
+   */
+  types: (this: TContext, code: string) => MaybePromise<TypesResult | string | undefined | null>;
+  /**
+   * A hook that is called at the start of the build process.
+   *
+   * @param this - The build context and unplugin build context.
+   * @returns A promise that resolves when the hook is complete.
+   */
+  buildStart: (this: BuildPluginContext<TContext["config"]> & TContext) => MaybePromise<void>;
+  /**
+   * A hook that is called at the end of the build process.
+   *
+   * @param this - The build context and unplugin build context.
+   * @returns A promise that resolves when the hook is complete.
+   */
+  buildEnd: (this: BuildPluginContext<TContext["config"]> & TContext) => MaybePromise<void>;
+  /**
+   * A hook that is called to transform the source code.
+   *
+   * @param this - The build context, unplugin build context, and unplugin context.
+   * @param code - The source code to transform.
+   * @param id - The identifier of the source code.
+   * @returns A promise that resolves when the hook is complete.
+   */
+  transform: (this: BuildPluginContext<TContext["config"]> & TContext, code: string, id: string) => MaybePromise<TransformResult>;
+  /**
+   * A hook that is called to load the source code.
+   *
+   * @param this - The build context, unplugin build context, and unplugin context.
+   * @param id - The identifier of the source code.
+   * @returns A promise that resolves when the hook is complete.
+   */
+  load: (this: BuildPluginContext<TContext["config"]> & TContext, id: string) => MaybePromise<LoadResult>;
+  /**
+   * A hook that is called to resolve the identifier of the source code.
+   *
+   * @param this - The build context, unplugin build context, and unplugin context.
+   * @param id - The identifier of the source code.
+   * @param importer - The importer of the source code.
+   * @param options - The options for resolving the identifier.
+   * @returns A promise that resolves when the hook is complete.
+   */
+  resolveId: (this: BuildPluginContext<TContext["config"]> & TContext, id: string, importer: string | undefined, options: {
+    isEntry: boolean;
+  }) => MaybePromise<string | ExternalIdResult | null | undefined>;
+  /**
+   * A hook that is called to write the bundle to disk.
+   *
+   * @param this - The build context.
+   * @returns A promise that resolves when the hook is complete.
+   */
+  writeBundle: (this: TContext) => MaybePromise<void>;
+};
+type PluginHooks<TContext extends PluginContext> = { [TPluginHook in keyof PluginHookFunctions<TContext>]?: PluginHook<PluginHookFunctions<TContext>[TPluginHook]> } & {
+  transform: PluginHook<PluginHookFunctions<TContext>["transform"], "code" | "id">;
+  load: PluginHook<PluginHookFunctions<TContext>["load"], "id">;
+  resolveId: PluginHook<PluginHookFunctions<TContext>["resolveId"], "id">;
+};
+type DeepPartial<T> = { [K in keyof T]?: DeepPartial<T[K]> };
+type Plugin<TContext extends PluginContext<ResolvedConfig> = PluginContext<ResolvedConfig>> = Partial<PluginHooks<TContext>> & {
+  /**
+   * The name of the plugin, for use in deduplication, error messages and logs.
+   */
+  name: string;
+  /**
+   * An API object that can be used for inter-plugin communication.
+   *
+   * @see https://rollupjs.org/plugin-development/#direct-plugin-communication
+   */
+  api?: Record<string, any>;
+  /**
+   * Enforce plugin invocation tier similar to webpack loaders. Hooks ordering is still subject to the `order` property in the hook object.
+   *
+   * @remarks
+   * The Plugin invocation order is as follows:
+   * - `enforce: 'pre'` plugins
+   * - `order: 'pre'` plugin hooks
+   * - any other plugins (normal)
+   * - `order: 'post'` plugin hooks
+   * - `enforce: 'post'` plugins
+   *
+   * @see https://vitejs.dev/guide/api-plugin.html#plugin-ordering
+   * @see https://rollupjs.org/plugin-development/#build-hooks
+   * @see https://webpack.js.org/concepts/loaders/#enforce---pre-and-post
+   * @see https://esbuild.github.io/plugins/#concepts
+   */
+  enforce?: "pre" | "post";
+  /**
+   * A function to determine if two plugins are the same and can be de-duplicated.
+   *
+   * @remarks
+   * If this is not provided, plugins are de-duplicated by comparing their names.
+   *
+   * @param other - The other plugin to compare against.
+   * @returns `true` if the two plugins are the same, `false` otherwise.
+   */
+  dedupe?: false | ((other: Plugin<any>) => boolean);
+  /**
+   * A list of pre-requisite plugins that must be loaded before this plugin can be used.
+   */
+  /**
+   * Define environments where this plugin should be active. By default, the plugin is active in all environments.
+   *
+   * @param environment - The environment to check.
+   * @returns `true` if the plugin should be active in the specified environment, `false` otherwise.
+   */
+  applyToEnvironment?: (environment: EnvironmentResolvedConfig) => boolean | PluginConfig<TContext>;
+  /**
+   * A function that returns configuration options to be merged with the build context's options.
+   *
+   * @remarks
+   * Modify config before it's resolved. The hook can either mutate {@link Context.config} on the passed-in context directly, or return a partial config object that will be deeply merged into existing config.
+   *
+   * @warning User plugins are resolved before running this hook so injecting other plugins inside the config hook will have no effect. If you want to add plugins, consider doing so in the {@link Plugin.dependsOn} property instead.
+   *
+   * @see https://vitejs.dev/guide/api-plugin#config
+   *
+   * @param this - The build context.
+   * @param config - The partial configuration object to be modified.
+   * @returns A promise that resolves to a partial configuration object.
+   */
+  config?: PluginHook<(this: UnresolvedContext<TContext["config"]>) => MaybePromise<DeepPartial<TContext["config"]> & Record<string, any>>> | (DeepPartial<TContext["config"]> & Record<string, any>);
+} & { [TBuilderVariant in BuilderVariant]?: InferUnpluginOptions<TContext, TBuilderVariant> };
+type PluginHookFields<TContext extends PluginContext = PluginContext> = keyof PluginHookFunctions<TContext>;
+//#endregion
+export { Plugin, PluginHook, PluginHookFields, PluginHookFunctions };
+//# sourceMappingURL=plugin.d.cts.map

package/dist/core/src/types/plugin.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.cts","names":[],"sources":["../../../../../core/src/types/plugin.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/core/src/types/tsconfig.d.cts

@@ -0,0 +1,70 @@
+import { CompilerOptions, TsConfigJson } from "@stryke/types/tsconfig";
+import ts from "typescript";
+
+//#region ../core/src/types/tsconfig.d.ts
+type ReflectionMode = "default" | "explicit" | "never";
+type RawReflectionMode = ReflectionMode | "" | boolean | string | string[] | undefined;
+/**
+ * Defines the level of reflection to be used during the transpilation process.
+ *
+ * @remarks
+ * The level determines how much extra data is captured in the byte code for each type. This can be one of the following values:
+ * - `minimal` - Only the essential type information is captured.
+ * - `normal` - Additional type information is captured, including some contextual data.
+ * - `verbose` - All available type information is captured, including detailed contextual data.
+ */
+type ReflectionLevel = "minimal" | "normal" | "verbose";
+interface DeepkitOptions {
+  /**
+   * Either true to activate reflection for all files compiled using this tsconfig,
+   * or a list of globs/file paths relative to this tsconfig.json.
+   * Globs/file paths can be prefixed with a ! to exclude them.
+   */
+  reflection?: RawReflectionMode;
+  /**
+   * Defines the level of reflection to be used during the transpilation process.
+   *
+   * @remarks
+   * The level determines how much extra data is captured in the byte code for each type. This can be one of the following values:
+   * - `minimal` - Only the essential type information is captured.
+   * - `normal` - Additional type information is captured, including some contextual data.
+   * - `verbose` - All available type information is captured, including detailed contextual data.
+   */
+  reflectionLevel?: ReflectionLevel;
+}
+type TSCompilerOptions = CompilerOptions & DeepkitOptions;
+/**
+ * The TypeScript compiler configuration.
+ *
+ * @see https://www.typescriptlang.org/docs/handbook/tsconfig-json.html
+ */
+interface TSConfig extends Omit<TsConfigJson, "reflection"> {
+  /**
+   * Either true to activate reflection for all files compiled using this tsconfig,
+   * or a list of globs/file paths relative to this tsconfig.json.
+   * Globs/file paths can be prefixed with a ! to exclude them.
+   */
+  reflection?: RawReflectionMode;
+  /**
+   * Defines the level of reflection to be used during the transpilation process.
+   *
+   * @remarks
+   * The level determines how much extra data is captured in the byte code for each type. This can be one of the following values:
+   * - `minimal` - Only the essential type information is captured.
+   * - `normal` - Additional type information is captured, including some contextual data.
+   * - `verbose` - All available type information is captured, including detailed contextual data.
+   */
+  reflectionLevel?: ReflectionLevel;
+  /**
+   * Instructs the TypeScript compiler how to compile `.ts` files.
+   */
+  compilerOptions?: TSCompilerOptions;
+}
+type ParsedTypeScriptConfig = ts.ParsedCommandLine & {
+  originalTsconfigJson: TsConfigJson;
+  tsconfigJson: TSConfig;
+  tsconfigFilePath: string;
+};
+//#endregion
+export { ParsedTypeScriptConfig, TSConfig };
+//# sourceMappingURL=tsconfig.d.cts.map

package/dist/core/src/types/tsconfig.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsconfig.d.cts","names":[],"sources":["../../../../../core/src/types/tsconfig.ts"],"sourcesContent":[],"mappings":";;;;KAqBY,cAAA;KACA,iBAAA,GACR;AAFJ;AACA;AAiBA;AAEA;AAoBA;AAOA;;;;AAsBoB,KAnDR,eAAA,GAmDQ,SAAA,GAAA,QAAA,GAAA,SAAA;AAtBc,UA3BjB,cAAA,CA2BiB;EAAI;AAyBtC;;;;EAEwB,UAAA,CAAA,EAhDT,iBAgDS;;;;;;;;;;oBArCJ;;KAGR,iBAAA,GAAoB,kBAAkB;;;;;;UAOjC,QAAA,SAAiB,KAAK;;;;;;eAMxB;;;;;;;;;;oBAWK;;;;oBAKA;;KAGR,sBAAA,GAAyB,EAAA,CAAG;wBAChB;gBACR"}

package/dist/core/src/types/unplugin.cjs

@@ -0,0 +1,21 @@
+
+//#region ../core/src/types/unplugin.ts
+const UNPLUGIN_BUILDER_VARIANTS = [
+	"rollup",
+	"webpack",
+	"rspack",
+	"vite",
+	"esbuild",
+	"farm",
+	"unloader",
+	"rolldown",
+	"bun"
+];
+const BUILDER_VARIANTS = [
+	...UNPLUGIN_BUILDER_VARIANTS,
+	"tsup",
+	"tsdown",
+	"unbuild"
+];
+
+//#endregion

package/dist/core/src/types/unplugin.d.cts

@@ -0,0 +1,24 @@
+import { API } from "./api.cjs";
+import { PluginHook } from "./plugin.cjs";
+import { Context } from "./context.cjs";
+import { HookFilter, UnpluginOptions } from "unplugin";
+import { MaybePromise } from "@stryke/types/base";
+
+//#region ../core/src/types/unplugin.d.ts
+type UnpluginBuilderVariant = "rollup" | "webpack" | "rspack" | "vite" | "esbuild" | "farm" | "unloader" | "rolldown" | "bun";
+type BuilderVariant = UnpluginBuilderVariant | "tsup" | "tsdown" | "unbuild";
+type InferUnpluginVariant<TBuildVariant extends BuilderVariant> = TBuildVariant extends "tsup" ? "esbuild" : TBuildVariant extends "tsdown" ? "rolldown" : TBuildVariant extends "unbuild" ? "rollup" : TBuildVariant;
+interface UnpluginOptions$1<TContext extends Context = Context> extends UnpluginOptions {
+  /**
+   * An API object that can be used for inter-plugin communication.
+   *
+   * @see https://rollupjs.org/plugin-development/#direct-plugin-communication
+   */
+  api: API<TContext["config"]>;
+}
+type InferUnpluginOptions<TContext extends Context = Context, TBuilderVariant extends BuilderVariant = BuilderVariant, TUnpluginVariant extends InferUnpluginVariant<TBuilderVariant> = InferUnpluginVariant<TBuilderVariant>> = { [TKey in keyof Required<UnpluginOptions$1<TContext>>[TUnpluginVariant]]?: Required<UnpluginOptions$1<TContext>>[TUnpluginVariant][TKey] extends infer THandler | {
+  handler: infer THandler;
+} ? THandler extends ((this: infer TOriginalContext, ...args: infer TArgs) => infer TReturn) ? PluginHook<(this: TOriginalContext & TContext, ...args: TArgs) => MaybePromise<TReturn>, keyof HookFilter> : Required<UnpluginOptions$1<TContext>>[TUnpluginVariant][TKey] : Required<UnpluginOptions$1<TContext>>[TUnpluginVariant][TKey] };
+//#endregion
+export { BuilderVariant, InferUnpluginOptions, UnpluginBuilderVariant };
+//# sourceMappingURL=unplugin.d.cts.map

package/dist/core/src/types/unplugin.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unplugin.d.cts","names":[],"sources":["../../../../../core/src/types/unplugin.ts"],"sourcesContent":[],"mappings":";;;;;;;KA6BY,sBAAA;AAuBA,KAAA,cAAA,GACR,sBAAA,GAAA,MAAsB,GAAA,QAAA,GAAA,SAAA;AAY6B,KAA3C,oBAA2C,CAAA,sBAAA,cAAA,CAAA,GACrD,aADqD,SAAA,MAAA,GAAA,SAAA,GAGjD,aAHiD,SAAA,QAAA,GAAA,UAAA,GAK/C,aAL+C,SAAA,SAAA,GAAA,QAAA,GAO7C,aAP6C;AACrD,UAQe,iBARf,CAAA,iBASiB,OATjB,GAS2B,OAT3B,CAAA,SAUQ,eAVR,CAAA;EAEI;;;;AAMN;EACmB,GAAA,EAOZ,GAPY,CAOR,QAPQ,CAAA,QAAA,CAAA,CAAA;;AAOR,KAGC,oBAHD,CAAA,iBAIQ,OAJR,GAIkB,OAJlB,EAAA,wBAKe,cALf,GAKgC,cALhC,EAAA,yBAMgB,oBANhB,CAMqC,eANrC,CAAA,GAOP,oBAPO,CAOc,eAPd,CAAA,CAAA,GAAA,WAAJ,MASU,QATV,CAUH,iBAVG,CAUa,QAVb,CAAA,CAAA,CAWH,gBAXG,CAAA,IAWkB,QAXlB,CAYH,iBAZG,CAYa,QAZb,CAAA,CAAA,CAaH,gBAbG,CAAA,CAae,IAbf,CAAA,SAAA,KAAA,SAAA,GAAA;EANG,OAAA,EAAA,KAAA,SAAA;AAAmB,CAAA,GAAA,QAAA,UAAA,CAAA,IAAA,EAAA,KAAA,iBAAA,EAAA,GAAA,IAAA,EAAA,KAAA,MAAA,EAAA,GAAA,KAAA,QAAA,IA4BrB,UA5BqB,CAAA,CAAA,IAAA,EA8BX,gBA9BW,GA8BQ,QA9BR,EAAA,GAAA,IAAA,EA+BR,KA/BQ,EAAA,GAgCd,YAhCc,CAgCD,OAhCC,CAAA,EAAA,MAiCb,UAjCa,CAAA,GAmCrB,QAnCqB,CAmCZ,iBAnCY,CAmCI,QAnCJ,CAAA,CAAA,CAmCe,gBAnCf,CAAA,CAmCiC,IAnCjC,CAAA,GAoCvB,QApCuB,CAoCd,iBApCc,CAoCE,QApCF,CAAA,CAAA,CAoCa,gBApCb,CAAA,CAoC+B,IApC/B,CAAA,EAS7B"}

package/dist/helpers/bundle.cjs

@@ -0,0 +1,43 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const require_helpers_resolve_options = require('./resolve-options.cjs');
+const require_plugin = require('../core/src/lib/unplugin/plugin.cjs');
+require('../core/src/lib/unplugin/index.cjs');
+let defu = require("defu");
+defu = require_rolldown_runtime.__toESM(defu);
+let esbuild = require("esbuild");
+let unplugin = require("unplugin");
+let __stryke_path_file_path_fns = require("@stryke/path/file-path-fns");
+
+//#region src/helpers/bundle.ts
+/**
+* Bundle a type definition to a module.
+*
+* @param context - The context object containing the environment paths.
+* @param file - The file path to bundle.
+* @param overrides - Optional overrides for the ESBuild configuration.
+* @returns A promise that resolves to the bundled module.
+*/
+async function bundle(context, file, overrides = {}) {
+	const path = await context.fs.resolve(file);
+	if (!path || !context.fs.existsSync(path)) throw new Error(`Module not found: "${file}". Please check the path and try again.`);
+	const result = await (0, esbuild.build)((0, defu.default)({
+		...require_helpers_resolve_options.resolveOptions(context),
+		entryPoints: [path],
+		write: false,
+		sourcemap: false,
+		splitting: false,
+		treeShaking: false,
+		bundle: true,
+		packages: "bundle",
+		platform: "node",
+		logLevel: "silent",
+		...overrides
+	}, { plugins: [(0, unplugin.createEsbuildPlugin)(require_plugin.createUnpluginResolver(context, `${(0, __stryke_path_file_path_fns.findFileName)(file)} Bundler`))({})] }));
+	if (result.errors.length > 0) throw new Error(`Failed to bundle ${file}: ${result.errors.map((error) => error.text).join(", ")}`);
+	if (result.warnings.length > 0) context.warn(`Warnings while bundling ${file}: ${result.warnings.map((warning) => warning.text).join(", ")}`);
+	if (!result.outputFiles || result.outputFiles.filter(Boolean).length === 0) throw new Error(`No output files generated for ${file}. Please check the configuration and try again.`);
+	return result.outputFiles.filter(Boolean)[0];
+}
+
+//#endregion
+exports.bundle = bundle;

package/dist/helpers/bundle.d.cts

@@ -0,0 +1,17 @@
+import { PluginContext } from "../core/src/types/context.cjs";
+import { BuildOptions, OutputFile } from "esbuild";
+
+//#region src/helpers/bundle.d.ts
+
+/**
+ * Bundle a type definition to a module.
+ *
+ * @param context - The context object containing the environment paths.
+ * @param file - The file path to bundle.
+ * @param overrides - Optional overrides for the ESBuild configuration.
+ * @returns A promise that resolves to the bundled module.
+ */
+declare function bundle(context: PluginContext, file: string, overrides?: Partial<BuildOptions>): Promise<OutputFile>;
+//#endregion
+export { bundle };
+//# sourceMappingURL=bundle.d.cts.map

package/dist/helpers/bundle.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle.d.cts","names":[],"sources":["../../src/helpers/bundle.ts"],"sourcesContent":[],"mappings":";;;;;;;AAkCA;;;;;;AAIU,iBAJY,MAAA,CAIZ,OAAA,EAHC,aAGD,EAAA,IAAA,EAAA,MAAA,EAAA,SAAA,CAAA,EADG,OACH,CADW,YACX,CAAA,CAAA,EAAP,OAAO,CAAC,UAAD,CAAA"}

package/dist/helpers/index.cjs

@@ -0,0 +1,12 @@
+const require_helpers_resolve_options = require('./resolve-options.cjs');
+const require_helpers_unplugin = require('./unplugin.cjs');
+const require_helpers_bundle = require('./bundle.cjs');
+const require_helpers_resolve = require('./resolve.cjs');
+
+exports.DEFAULT_ESBUILD_CONFIG = require_helpers_resolve_options.DEFAULT_ESBUILD_CONFIG;
+exports.bundle = require_helpers_bundle.bundle;
+exports.createEsbuildPlugin = require_helpers_unplugin.createEsbuildPlugin;
+exports.resolve = require_helpers_resolve.resolve;
+exports.resolveEntry = require_helpers_resolve_options.resolveEntry;
+exports.resolveModule = require_helpers_resolve.resolveModule;
+exports.resolveOptions = require_helpers_resolve_options.resolveOptions;

package/dist/helpers/index.d.cts

@@ -0,0 +1,5 @@
+import { bundle } from "./bundle.cjs";
+import { resolve, resolveModule } from "./resolve.cjs";
+import { DEFAULT_ESBUILD_CONFIG, resolveEntry, resolveOptions } from "./resolve-options.cjs";
+import { createEsbuildPlugin } from "./unplugin.cjs";
+export { DEFAULT_ESBUILD_CONFIG, bundle, createEsbuildPlugin, resolve, resolveEntry, resolveModule, resolveOptions };

package/dist/helpers/resolve-options.cjs

@@ -0,0 +1,90 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const require_entry = require('../core/src/lib/entry.cjs');
+let defu = require("defu");
+defu = require_rolldown_runtime.__toESM(defu);
+let __stryke_path_join_paths = require("@stryke/path/join-paths");
+let __stryke_path_replace = require("@stryke/path/replace");
+let __stryke_type_checks_is_string = require("@stryke/type-checks/is-string");
+let __stryke_string_format_camel_case = require("@stryke/string-format/camel-case");
+
+//#region src/helpers/resolve-options.ts
+const DEFAULT_ESBUILD_CONFIG = {
+	target: "esnext",
+	platform: "neutral",
+	format: "esm",
+	write: true,
+	minify: true,
+	sourcemap: false,
+	bundle: true,
+	treeShaking: true,
+	keepNames: true,
+	splitting: true,
+	logLevel: "silent"
+};
+/**
+* Resolves the entry options for esbuild.
+*
+* @param context - The build context.
+* @param entryPoints - The entry points to resolve.
+* @returns The resolved entry options.
+*/
+function resolveEntry(context, entryPoints = []) {
+	return entryPoints.reduce((ret, entry) => {
+		if ((0, __stryke_type_checks_is_string.isString)(entry)) ret[(0, __stryke_path_replace.replaceExtension)((0, __stryke_path_replace.replacePath)(entry, context.config.root))] = (0, __stryke_path_replace.replacePath)(entry, context.config.root);
+		else ret[entry.output || require_entry.resolveEntryOutput(context, entry)] = entry.file;
+		return ret;
+	}, {});
+}
+/**
+* Resolves the esbuild options.
+*
+* @param context - The build context.
+* @returns The resolved esbuild options.
+*/
+function resolveOptions(context) {
+	if (context.config.inject && Object.keys(context.config.inject).length > 0) context.fs.writeSync((0, __stryke_path_join_paths.joinPaths)(context.workspaceConfig.workspaceRoot, context.config.root, context.artifactsPath, "inject-shim.js"), Object.entries(context.config.inject).map(([key, value]) => {
+		if (value) if (Array.isArray(value)) {
+			if ((0, __stryke_string_format_camel_case.camelCase)(key) !== key) {
+				if (value.length === 1) return `
+import ${(0, __stryke_string_format_camel_case.camelCase)(key)} from "${value[0]}";
+export { ${(0, __stryke_string_format_camel_case.camelCase)(key)} as "${key}" }`;
+				else if (value.length > 1) return `
+import ${value[1] === "*" ? `* as ${(0, __stryke_string_format_camel_case.camelCase)(key)}` : `{ ${value[1]} as ${(0, __stryke_string_format_camel_case.camelCase)(key)} }`} from "${value[0]}";
+export { ${(0, __stryke_string_format_camel_case.camelCase)(key)} as "${key}" }`;
+			} else if (value.length === 1) return `
+import ${key} from "${value[0]}";
+export { ${key} };`;
+			else if (value.length > 1) return `
+import ${value[1] === "*" ? `* as ${key}` : `{ ${value[1]} as ${key} }`} from "${value[0]}";
+export { ${key} };`;
+		} else if ((0, __stryke_string_format_camel_case.camelCase)(key) !== key) return `
+import ${(0, __stryke_string_format_camel_case.camelCase)(key)} from "${value[0]}";
+export { ${(0, __stryke_string_format_camel_case.camelCase)(key)} as "${key}" }`;
+		else return `
+import ${key} from "${value}";
+export { ${key} };`;
+		return "";
+	}).join("\n"));
+	return (0, defu.default)({
+		alias: context.alias,
+		inject: context.config.inject && Object.keys(context.config.inject).length > 0 ? [(0, __stryke_path_join_paths.joinPaths)(context.workspaceConfig.workspaceRoot, context.config.root, context.artifactsPath, "inject-shim.js")] : void 0
+	}, context.config?.esbuild ? context.config.esbuild : {}, {
+		mainFields: context.config.resolve.mainFields,
+		conditions: context.config.resolve.conditions,
+		define: context.config.define,
+		resolveExtensions: context.config.resolve.extensions,
+		packages: context.config.resolve.skipNodeModulesBundle ? "external" : context.config?.esbuild ? (context.config?.esbuild).packages : void 0,
+		format: Array.isArray(context.config.output.format) ? context.config.output.format[0] : context.config.output.format,
+		platform: context.config.platform,
+		outdir: context.config.output.buildPath,
+		tsconfig: context.tsconfig.tsconfigFilePath,
+		minify: context.config.mode !== "development",
+		metafile: context.config.mode === "development",
+		sourcemap: context.config.mode === "development"
+	}, DEFAULT_ESBUILD_CONFIG);
+}
+
+//#endregion
+exports.DEFAULT_ESBUILD_CONFIG = DEFAULT_ESBUILD_CONFIG;
+exports.resolveEntry = resolveEntry;
+exports.resolveOptions = resolveOptions;

package/dist/helpers/resolve-options.d.cts

@@ -0,0 +1,24 @@
+import { ResolvedEntryTypeDefinition } from "../core/src/types/config.cjs";
+import { Context } from "../core/src/types/context.cjs";
+import { BuildOptions } from "esbuild";
+
+//#region src/helpers/resolve-options.d.ts
+declare const DEFAULT_ESBUILD_CONFIG: Partial<BuildOptions>;
+/**
+ * Resolves the entry options for esbuild.
+ *
+ * @param context - The build context.
+ * @param entryPoints - The entry points to resolve.
+ * @returns The resolved entry options.
+ */
+declare function resolveEntry(context: Context, entryPoints?: ResolvedEntryTypeDefinition[] | string[]): BuildOptions["entryPoints"];
+/**
+ * Resolves the esbuild options.
+ *
+ * @param context - The build context.
+ * @returns The resolved esbuild options.
+ */
+declare function resolveOptions(context: Context): BuildOptions;
+//#endregion
+export { DEFAULT_ESBUILD_CONFIG, resolveEntry, resolveOptions };
+//# sourceMappingURL=resolve-options.d.cts.map

package/dist/helpers/resolve-options.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-options.d.cts","names":[],"sources":["../../src/helpers/resolve-options.ts"],"sourcesContent":[],"mappings":";;;;;cA+Ba,wBAAwB,QAAQ;;;AAA7C;AAqBA;;;;AAGe,iBAHC,YAAA,CAGD,OAAA,EAFJ,OAEI,EAAA,WAAA,CAAA,EADA,2BACA,EAAA,GAAA,MAAA,EAAA,CAAA,EAAZ,YAAY,CAAA,aAAA,CAAA;AAsBf;;;;;;iBAAgB,cAAA,UAAwB,UAAU"}

package/dist/helpers/resolve.cjs

@@ -0,0 +1,63 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const require_helpers_bundle = require('./bundle.cjs');
+let __stryke_convert_parse_type_definition = require("@stryke/convert/parse-type-definition");
+let __stryke_type_checks_is_set_string = require("@stryke/type-checks/is-set-string");
+
+//#region src/helpers/resolve.ts
+/**
+* Compiles a type definition to a module and returns the module.
+*
+* @param context - The context object containing the environment paths.
+* @param type - The type definition to compile. This can be either a string or a {@link TypeDefinition} object.
+* @param overrides - Optional overrides for the ESBuild configuration.
+* @returns A promise that resolves to the compiled module.
+*/
+async function resolveModule(context, type, overrides = {}) {
+	let typeDefinition;
+	if ((0, __stryke_type_checks_is_set_string.isSetString)(type)) typeDefinition = (0, __stryke_convert_parse_type_definition.parseTypeDefinition)(type);
+	else typeDefinition = type;
+	const result = await require_helpers_bundle.bundle(context, typeDefinition.file, overrides);
+	let resolved;
+	try {
+		resolved = await context.resolver.evalModule(result.text, {
+			filename: result.path,
+			forceTranspile: true
+		});
+	} catch (error) {
+		if ((0, __stryke_type_checks_is_set_string.isSetString)(error.message) && (/* @__PURE__ */ new RegExp(`Cannot find module '${context.config.framework || "powerlines"}:.*'`)).test(error.message)) {
+			const moduleName = error.message.match(/* @__PURE__ */ new RegExp(`Cannot find module '(${context.config.framework || "powerlines"}:.*)'`))?.[1];
+			throw new Error(`The module "${moduleName}" could not be resolved while evaluating "${typeDefinition.file}". It is possible the required built-in modules have not yet been generated. Please check the order of your plugins. ${context.config.logLevel === "debug" || context.config.logLevel === "trace" ? `
+
+Bundle output for module:
+${result.text}` : ""}`);
+		}
+		throw new Error(`Failed to evaluate the bundled module for "${typeDefinition.file}". Error: ${error.message}${context.config.logLevel === "debug" || context.config.logLevel === "trace" ? `
+
+Bundle output for module:
+${result.text}` : ""}`);
+	}
+	return resolved;
+}
+/**
+* Compiles a type definition to a module and returns the specified export from the module.
+*
+* @param context - The context object containing the environment paths.
+* @param type - The type definition to compile. This can be either a string or a {@link TypeDefinition} object.
+* @param overrides - Optional overrides for the ESBuild configuration.
+* @returns A promise that resolves to the compiled module.
+*/
+async function resolve(context, type, overrides = {}) {
+	let typeDefinition;
+	if ((0, __stryke_type_checks_is_set_string.isSetString)(type)) typeDefinition = (0, __stryke_convert_parse_type_definition.parseTypeDefinition)(type);
+	else typeDefinition = type;
+	const resolved = await resolveModule(context, typeDefinition, overrides);
+	let exportName = typeDefinition.name;
+	if (!exportName) exportName = "default";
+	const resolvedExport = resolved[exportName] ?? resolved[`__Ω${exportName}`];
+	if (resolvedExport === void 0) throw new Error(`The export "${exportName}" could not be resolved in the "${typeDefinition.file}" module. ${Object.keys(resolved).length === 0 ? `After bundling, no exports were found in the module. Please ensure that the "${typeDefinition.file}" module has a "${exportName}" export with the desired value.` : `After bundling, the available exports were: ${Object.keys(resolved).join(", ")}. Please ensure that the export exists and is correctly named.`}`);
+	return resolvedExport;
+}
+
+//#endregion
+exports.resolve = resolve;
+exports.resolveModule = resolveModule;

package/dist/helpers/resolve.d.cts

@@ -0,0 +1,27 @@
+import { PluginContext } from "../core/src/types/context.cjs";
+import { TypeDefinitionParameter } from "@stryke/types/configuration";
+import { BuildOptions } from "esbuild";
+
+//#region src/helpers/resolve.d.ts
+
+/**
+ * Compiles a type definition to a module and returns the module.
+ *
+ * @param context - The context object containing the environment paths.
+ * @param type - The type definition to compile. This can be either a string or a {@link TypeDefinition} object.
+ * @param overrides - Optional overrides for the ESBuild configuration.
+ * @returns A promise that resolves to the compiled module.
+ */
+declare function resolveModule<TResult>(context: PluginContext, type: TypeDefinitionParameter, overrides?: Partial<BuildOptions>): Promise<TResult>;
+/**
+ * Compiles a type definition to a module and returns the specified export from the module.
+ *
+ * @param context - The context object containing the environment paths.
+ * @param type - The type definition to compile. This can be either a string or a {@link TypeDefinition} object.
+ * @param overrides - Optional overrides for the ESBuild configuration.
+ * @returns A promise that resolves to the compiled module.
+ */
+declare function resolve<TResult>(context: PluginContext, type: TypeDefinitionParameter, overrides?: Partial<BuildOptions>): Promise<TResult>;
+//#endregion
+export { resolve, resolveModule };
+//# sourceMappingURL=resolve.d.cts.map

package/dist/helpers/resolve.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.cts","names":[],"sources":["../../src/helpers/resolve.ts"],"sourcesContent":[],"mappings":";;;;;;;;AAoCA;;;;;;AAIG,iBAJmB,aAInB,CAAA,OAAA,CAAA,CAAA,OAAA,EAHQ,aAGR,EAAA,IAAA,EAFK,uBAEL,EAAA,SAAA,CAAA,EADU,OACV,CADkB,YAClB,CAAA,CAAA,EAAA,OAAA,CAAQ,OAAR,CAAA;;AAqEH;;;;;;;AAIU,iBAJY,OAIZ,CAAA,OAAA,CAAA,CAAA,OAAA,EAHC,aAGD,EAAA,IAAA,EAFF,uBAEE,EAAA,SAAA,CAAA,EADG,OACH,CADW,YACX,CAAA,CAAA,EAAP,OAAO,CAAC,OAAD,CAAA"}