powerlines 0.47.145 → 0.47.146

package/dist/package.cjs

@@ -1,6 +1,6 @@
 
 //#region package.json
-var version = "0.47.145";
+var version = "0.47.146";
 
 //#endregion
 Object.defineProperty(exports, 'version', {

package/dist/package.mjs

@@ -1,5 +1,5 @@
 //#region package.json
-var version = "0.47.145";
+var version = "0.47.146";
 
 //#endregion
 export { version };

package/dist/schema-bundle.cjs

@@ -0,0 +1,58 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
+let _powerlines_unplugin_esbuild = require("@powerlines/unplugin/esbuild");
+let _powerlines_core_lib_unplugin = require("@powerlines/core/lib/unplugin");
+let _stryke_helpers_omit = require("@stryke/helpers/omit");
+let _stryke_path_file_path_fns = require("@stryke/path/file-path-fns");
+let defu = require("defu");
+defu = require_runtime.__toESM(defu, 1);
+let esbuild = require("esbuild");
+let unplugin = require("unplugin");
+
+//#region src/schema-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 options - Optional overrides for the ESBuild configuration.
+* @returns A promise that resolves to the bundled module.
+*/
+async function bundle(context, file, options = {}) {
+	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)({
+		platform: "node",
+		...(0, _stryke_helpers_omit.omit)(options, ["name", "resolve"]),
+		logLevel: "silent",
+		entryPoints: [path],
+		write: false,
+		sourcemap: false,
+		splitting: false,
+		treeShaking: true,
+		bundle: true,
+		packages: "bundle",
+		keepNames: true,
+		metafile: false
+	}, (0, _powerlines_unplugin_esbuild.resolveOptions)(context), { plugins: [(0, unplugin.createEsbuildPlugin)((0, _powerlines_core_lib_unplugin.createUnpluginResolver)(context, {
+		name: options.name ?? `${(0, _stryke_path_file_path_fns.findFileName)(file)} Bundler`,
+		prefix: false,
+		overrides: (0, defu.default)(options.resolve ?? {}, {
+			skipNodeModulesBundle: false,
+			external: [
+				"@alloy-js/core",
+				"@alloy-js/typescript",
+				"@alloy-js/json",
+				"@alloy-js/markdown"
+			]
+		}),
+		silenceHookLogging: true
+	}))()] }));
+	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/schema-bundle.d.cts

@@ -0,0 +1,20 @@
+import { ResolveOptions, UnresolvedContext } from "@powerlines/core";
+import { DeepPartial } from "@stryke/types/base";
+import { BuildOptions, OutputFile } from "esbuild";
+//#region src/schema-bundle.d.ts
+type BundleOptions = DeepPartial<BuildOptions> & {
+  name?: string;
+  resolve?: DeepPartial<ResolveOptions>;
+};
+/**
+ * Bundle a type definition to a module.
+ *
+ * @param context - The context object containing the environment paths.
+ * @param file - The file path to bundle.
+ * @param options - Optional overrides for the ESBuild configuration.
+ * @returns A promise that resolves to the bundled module.
+ */
+declare function bundle<TContext extends UnresolvedContext>(context: TContext, file: string, options?: BundleOptions): Promise<OutputFile>;
+//#endregion
+export { BundleOptions, bundle };
+//# sourceMappingURL=schema-bundle.d.cts.map

package/dist/schema-bundle.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-bundle.d.cts","names":[],"sources":["../src/schema-bundle.ts"],"mappings":";;;;KA6BY,gBAAgB,YAAY;EACtC;EACA,UAAU,YAAY;;;;;;;;;;iBAWF,OAAO,iBAAiB,mBAC5C,SAAS,UACT,cACA,UAAS,gBACR,QAAQ"}

package/dist/schema-bundle.d.mts

@@ -0,0 +1,20 @@
+import { ResolveOptions, UnresolvedContext } from "@powerlines/core";
+import { BuildOptions, OutputFile } from "esbuild";
+import { DeepPartial } from "@stryke/types/base";
+//#region src/schema-bundle.d.ts
+type BundleOptions = DeepPartial<BuildOptions> & {
+  name?: string;
+  resolve?: DeepPartial<ResolveOptions>;
+};
+/**
+ * Bundle a type definition to a module.
+ *
+ * @param context - The context object containing the environment paths.
+ * @param file - The file path to bundle.
+ * @param options - Optional overrides for the ESBuild configuration.
+ * @returns A promise that resolves to the bundled module.
+ */
+declare function bundle<TContext extends UnresolvedContext>(context: TContext, file: string, options?: BundleOptions): Promise<OutputFile>;
+//#endregion
+export { BundleOptions, bundle };
+//# sourceMappingURL=schema-bundle.d.mts.map

package/dist/schema-bundle.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-bundle.d.mts","names":[],"sources":["../src/schema-bundle.ts"],"mappings":";;;;KA6BY,gBAAgB,YAAY;EACtC;EACA,UAAU,YAAY;;;;;;;;;;iBAWF,OAAO,iBAAiB,mBAC5C,SAAS,UACT,cACA,UAAS,gBACR,QAAQ"}

package/dist/schema-bundle.mjs

@@ -0,0 +1,56 @@
+import { resolveOptions } from "@powerlines/unplugin/esbuild";
+import { createUnpluginResolver } from "@powerlines/core/lib/unplugin";
+import { omit } from "@stryke/helpers/omit";
+import { findFileName } from "@stryke/path/file-path-fns";
+import defu from "defu";
+import { build } from "esbuild";
+import { createEsbuildPlugin } from "unplugin";
+
+//#region src/schema-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 options - Optional overrides for the ESBuild configuration.
+* @returns A promise that resolves to the bundled module.
+*/
+async function bundle(context, file, options = {}) {
+	const path = await context.fs.resolve(file);
+	if (!path || !context.fs.existsSync(path)) throw new Error(`Module not found: "${file}". Please check the path and try again.`);
+	const result = await build(defu({
+		platform: "node",
+		...omit(options, ["name", "resolve"]),
+		logLevel: "silent",
+		entryPoints: [path],
+		write: false,
+		sourcemap: false,
+		splitting: false,
+		treeShaking: true,
+		bundle: true,
+		packages: "bundle",
+		keepNames: true,
+		metafile: false
+	}, resolveOptions(context), { plugins: [createEsbuildPlugin(createUnpluginResolver(context, {
+		name: options.name ?? `${findFileName(file)} Bundler`,
+		prefix: false,
+		overrides: defu(options.resolve ?? {}, {
+			skipNodeModulesBundle: false,
+			external: [
+				"@alloy-js/core",
+				"@alloy-js/typescript",
+				"@alloy-js/json",
+				"@alloy-js/markdown"
+			]
+		}),
+		silenceHookLogging: true
+	}))()] }));
+	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
+export { bundle };
+//# sourceMappingURL=schema-bundle.mjs.map

package/dist/schema-bundle.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-bundle.mjs","names":[],"sources":["../src/schema-bundle.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 type { ResolveOptions, UnresolvedContext } from \"@powerlines/core\";\nimport { createUnpluginResolver } from \"@powerlines/core/lib/unplugin\";\nimport { resolveOptions } from \"@powerlines/unplugin/esbuild\";\nimport { omit } from \"@stryke/helpers/omit\";\nimport { findFileName } from \"@stryke/path/file-path-fns\";\nimport { DeepPartial } from \"@stryke/types/base\";\nimport defu from \"defu\";\nimport type { BuildOptions } from \"esbuild\";\nimport { build, OutputFile } from \"esbuild\";\nimport { createEsbuildPlugin } from \"unplugin\";\n\nexport type BundleOptions = DeepPartial<BuildOptions> & {\n  name?: string;\n  resolve?: DeepPartial<ResolveOptions>;\n};\n\n/**\n * Bundle a type definition to a module.\n *\n * @param context - The context object containing the environment paths.\n * @param file - The file path to bundle.\n * @param options - Optional overrides for the ESBuild configuration.\n * @returns A promise that resolves to the bundled module.\n */\nexport async function bundle<TContext extends UnresolvedContext>(\n  context: TContext,\n  file: string,\n  options: BundleOptions = {}\n): Promise<OutputFile> {\n  const path = await context.fs.resolve(file);\n  if (!path || !context.fs.existsSync(path)) {\n    throw new Error(\n      `Module not found: \"${file}\". Please check the path and try again.`\n    );\n  }\n\n  const result = await build(\n    defu(\n      {\n        platform: \"node\",\n        ...omit(options, [\"name\", \"resolve\"]),\n        logLevel: \"silent\",\n        entryPoints: [path],\n        write: false,\n        sourcemap: false,\n        splitting: false,\n        treeShaking: true,\n        bundle: true,\n        packages: \"bundle\",\n        keepNames: true,\n        metafile: false\n      },\n      resolveOptions(context),\n      {\n        plugins: [\n          createEsbuildPlugin(\n            createUnpluginResolver(context, {\n              name: options.name ?? `${findFileName(file)} Bundler`,\n              prefix: false,\n              overrides: defu(options.resolve ?? {}, {\n                skipNodeModulesBundle: false,\n                external: [\n                  \"@alloy-js/core\",\n                  \"@alloy-js/typescript\",\n                  \"@alloy-js/json\",\n                  \"@alloy-js/markdown\"\n                ]\n              }),\n              silenceHookLogging: true\n            })\n          )()\n        ]\n      }\n    )\n  );\n  if (result.errors.length > 0) {\n    throw new Error(\n      `Failed to bundle ${file}: ${result.errors\n        .map(error => error.text)\n        .join(\", \")}`\n    );\n  }\n  if (result.warnings.length > 0) {\n    context.warn(\n      `Warnings while bundling ${file}: ${result.warnings\n        .map(warning => warning.text)\n        .join(\", \")}`\n    );\n  }\n  if (!result.outputFiles || result.outputFiles.filter(Boolean).length === 0) {\n    throw new Error(\n      `No output files generated for ${\n        file\n      }. Please check the configuration and try again.`\n    );\n  }\n\n  return result.outputFiles.filter(Boolean)[0]!;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AA0CA,eAAsB,OACpB,SACA,MACA,UAAyB,CAAC,GACL;CACrB,MAAM,OAAO,MAAM,QAAQ,GAAG,QAAQ,IAAI;CAC1C,IAAI,CAAC,QAAQ,CAAC,QAAQ,GAAG,WAAW,IAAI,GACtC,MAAM,IAAI,MACR,sBAAsB,KAAK,wCAC7B;CAGF,MAAM,SAAS,MAAM,MACnB,KACE;EACE,UAAU;EACV,GAAG,KAAK,SAAS,CAAC,QAAQ,SAAS,CAAC;EACpC,UAAU;EACV,aAAa,CAAC,IAAI;EAClB,OAAO;EACP,WAAW;EACX,WAAW;EACX,aAAa;EACb,QAAQ;EACR,UAAU;EACV,WAAW;EACX,UAAU;CACZ,GACA,eAAe,OAAO,GACtB,EACE,SAAS,CACP,oBACE,uBAAuB,SAAS;EAC9B,MAAM,QAAQ,QAAQ,GAAG,aAAa,IAAI,EAAE;EAC5C,QAAQ;EACR,WAAW,KAAK,QAAQ,WAAW,CAAC,GAAG;GACrC,uBAAuB;GACvB,UAAU;IACR;IACA;IACA;IACA;GACF;EACF,CAAC;EACD,oBAAoB;CACtB,CAAC,CACH,CAAC,CAAC,CACJ,EACF,CACF,CACF;CACA,IAAI,OAAO,OAAO,SAAS,GACzB,MAAM,IAAI,MACR,oBAAoB,KAAK,IAAI,OAAO,OACjC,KAAI,UAAS,MAAM,IAAI,CAAC,CACxB,KAAK,IAAI,GACd;CAEF,IAAI,OAAO,SAAS,SAAS,GAC3B,QAAQ,KACN,2BAA2B,KAAK,IAAI,OAAO,SACxC,KAAI,YAAW,QAAQ,IAAI,CAAC,CAC5B,KAAK,IAAI,GACd;CAEF,IAAI,CAAC,OAAO,eAAe,OAAO,YAAY,OAAO,OAAO,CAAC,CAAC,WAAW,GACvE,MAAM,IAAI,MACR,iCACE,KACD,gDACH;CAGF,OAAO,OAAO,YAAY,OAAO,OAAO,CAAC,CAAC;AAC5C"}

package/dist/schema-resolve.cjs

@@ -0,0 +1,86 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_schema_bundle = require('./schema-bundle.cjs');
+let _stryke_convert_extract_file_reference = require("@stryke/convert/extract-file-reference");
+let _stryke_path_find = require("@stryke/path/find");
+let _stryke_type_checks_is_set_string = require("@stryke/type-checks/is-set-string");
+let smol_toml = require("smol-toml");
+let yaml = require("yaml");
+
+//#region src/schema-resolve.ts
+/**
+* Compiles a type definition to a module and returns the module.
+*
+* @param context - The context object containing the environment paths.
+* @param input - The type definition to compile. This can be either a string or a {@link FileReference} object.
+* @param overrides - Optional overrides for the ESBuild configuration.
+* @returns A promise that resolves to the compiled module.
+*/
+async function resolveModule(context, input, overrides) {
+	const fileReference = (0, _stryke_convert_extract_file_reference.extractFileReference)(input);
+	if (!fileReference) throw new Error(`Failed to extract a file reference from the provided input ${JSON.stringify(input)}. The input must be a string or an object with a "file" property that specifies the file path and optional export name.`);
+	const result = await require_schema_bundle.bundle(context, fileReference.file, overrides);
+	let resolved;
+	try {
+		resolved = await context.resolver.evalModule(result.text, {
+			filename: result.path,
+			ext: (0, _stryke_path_find.findFileDotExtension)(result.path)
+		});
+	} catch (error) {
+		if ((0, _stryke_type_checks_is_set_string.isSetString)(error.message) && new RegExp(`Cannot find module '${context.config.framework?.name || "powerlines"}:.*'`).test(error.message)) {
+			const moduleName = error.message.match(new RegExp(`Cannot find module '(${context.config.framework?.name || "powerlines"}:.*)'`))?.[1];
+			throw new Error(`The module "${moduleName}" could not be resolved while evaluating "${fileReference.file}". It is possible the required built-in modules have not yet been generated. Please check the order of your plugins. ${context.config.logLevel.general === "debug" || context.config.logLevel.general === "trace" ? `
+
+Bundle output for module:
+${result.text && result.text.length > 5e4 ? `${result.text.slice(0, 5e4)}\n... [truncated]` : result.text}` : ""}`);
+		}
+		throw new Error(`Failed to evaluate the bundled module for "${fileReference.file}". Error: ${error.message}${context.config.logLevel.general === "debug" || context.config.logLevel.general === "trace" ? `
+
+Bundle output for module:
+${result.text && result.text.length > 5e4 ? `${result.text.slice(0, 5e4)}\n... [truncated]` : 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 input - The type definition to compile. This can be either a string or a {@link FileReference} object.
+* @param options - Optional overrides for the ESBuild configuration.
+* @returns A promise that resolves to the compiled module.
+*/
+async function resolve(context, input, options) {
+	const fileReference = (0, _stryke_convert_extract_file_reference.extractFileReference)(input);
+	if (!fileReference) throw new Error(`Failed to extract a file reference from the provided input. The input must be a string or an object with a "file" property that specifies the file path and optional export name.`);
+	const extension = (0, _stryke_path_find.findFileExtensionSafe)(fileReference.file);
+	if (extension.startsWith("json")) try {
+		const json = await context.fs.read(fileReference.file);
+		if (!(0, _stryke_type_checks_is_set_string.isSetString)(json)) throw new Error(`The file at "${fileReference.file}" could not be read as a string. Please ensure the file exists and contains valid JSON.`);
+		return JSON.parse(json);
+	} catch (error) {
+		throw new Error(`Failed to read or parse the JSON file at "${fileReference.file}". Please ensure the file exists and contains valid JSON. Error: ${error.message}`);
+	}
+	else if (extension === "yaml" || extension === "yml") try {
+		const yaml$1 = await context.fs.read(fileReference.file);
+		if (!(0, _stryke_type_checks_is_set_string.isSetString)(yaml$1)) throw new Error(`The file at "${fileReference.file}" could not be read as a string. Please ensure the file exists and contains valid YAML.`);
+		return (0, yaml.parse)(yaml$1);
+	} catch (error) {
+		throw new Error(`Failed to read or parse the YAML file at "${fileReference.file}". Please ensure the file exists and contains valid YAML. Error: ${error.message}`);
+	}
+	else if (extension === "toml") try {
+		const toml = await context.fs.read(fileReference.file);
+		if (!(0, _stryke_type_checks_is_set_string.isSetString)(toml)) throw new Error(`The file at "${fileReference.file}" could not be read as a string. Please ensure the file exists and contains valid TOML.`);
+		return (0, smol_toml.parse)(toml);
+	} catch (error) {
+		throw new Error(`Failed to read or parse the TOML file at "${fileReference.file}". Please ensure the file exists and contains valid TOML. Error: ${error.message}`);
+	}
+	const resolved = await resolveModule(context, fileReference, options);
+	let exportName = fileReference.export;
+	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 "${fileReference.file}" module. ${Object.keys(resolved).length === 0 ? `After bundling, no exports were found in the module. Please ensure that the "${fileReference.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/schema-resolve.d.cts

@@ -0,0 +1,25 @@
+import { BundleOptions } from "./schema-bundle.cjs";
+import { UnresolvedContext } from "@powerlines/core";
+import { FileReferenceInput } from "@stryke/types/configuration";
+//#region src/schema-resolve.d.ts
+/**
+ * Compiles a type definition to a module and returns the module.
+ *
+ * @param context - The context object containing the environment paths.
+ * @param input - The type definition to compile. This can be either a string or a {@link FileReference} object.
+ * @param overrides - Optional overrides for the ESBuild configuration.
+ * @returns A promise that resolves to the compiled module.
+ */
+declare function resolveModule<TResult, TContext extends UnresolvedContext = UnresolvedContext>(context: TContext, input: FileReferenceInput, overrides?: BundleOptions): 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 input - The type definition to compile. This can be either a string or a {@link FileReference} object.
+ * @param options - Optional overrides for the ESBuild configuration.
+ * @returns A promise that resolves to the compiled module.
+ */
+declare function resolve<TResult, TContext extends UnresolvedContext = UnresolvedContext>(context: TContext, input: FileReferenceInput, options?: BundleOptions): Promise<TResult>;
+//#endregion
+export { resolve, resolveModule };
+//# sourceMappingURL=schema-resolve.d.cts.map

package/dist/schema-resolve.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-resolve.d.cts","names":[],"sources":["../src/schema-resolve.ts"],"mappings":";;;;;;;;;;;;iBAmCsB,cACpB,SACA,iBAAiB,oBAAoB,mBAErC,SAAS,UACT,OAAO,oBACP,YAAY,gBACX,QAAQ;;;;;;;;;iBA+EW,QACpB,SACA,iBAAiB,oBAAoB,mBAErC,SAAS,UACT,OAAO,oBACP,UAAU,gBACT,QAAQ"}

package/dist/schema-resolve.d.mts

@@ -0,0 +1,25 @@
+import { BundleOptions } from "./schema-bundle.mjs";
+import { UnresolvedContext } from "@powerlines/core";
+import { FileReferenceInput } from "@stryke/types/configuration";
+//#region src/schema-resolve.d.ts
+/**
+ * Compiles a type definition to a module and returns the module.
+ *
+ * @param context - The context object containing the environment paths.
+ * @param input - The type definition to compile. This can be either a string or a {@link FileReference} object.
+ * @param overrides - Optional overrides for the ESBuild configuration.
+ * @returns A promise that resolves to the compiled module.
+ */
+declare function resolveModule<TResult, TContext extends UnresolvedContext = UnresolvedContext>(context: TContext, input: FileReferenceInput, overrides?: BundleOptions): 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 input - The type definition to compile. This can be either a string or a {@link FileReference} object.
+ * @param options - Optional overrides for the ESBuild configuration.
+ * @returns A promise that resolves to the compiled module.
+ */
+declare function resolve<TResult, TContext extends UnresolvedContext = UnresolvedContext>(context: TContext, input: FileReferenceInput, options?: BundleOptions): Promise<TResult>;
+//#endregion
+export { resolve, resolveModule };
+//# sourceMappingURL=schema-resolve.d.mts.map

package/dist/schema-resolve.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-resolve.d.mts","names":[],"sources":["../src/schema-resolve.ts"],"mappings":";;;;;;;;;;;;iBAmCsB,cACpB,SACA,iBAAiB,oBAAoB,mBAErC,SAAS,UACT,OAAO,oBACP,YAAY,gBACX,QAAQ;;;;;;;;;iBA+EW,QACpB,SACA,iBAAiB,oBAAoB,mBAErC,SAAS,UACT,OAAO,oBACP,UAAU,gBACT,QAAQ"}

package/dist/schema-resolve.mjs

@@ -0,0 +1,85 @@
+import { bundle } from "./schema-bundle.mjs";
+import { extractFileReference } from "@stryke/convert/extract-file-reference";
+import { findFileDotExtension, findFileExtensionSafe } from "@stryke/path/find";
+import { isSetString } from "@stryke/type-checks/is-set-string";
+import { parse } from "smol-toml";
+import { parse as parse$1 } from "yaml";
+
+//#region src/schema-resolve.ts
+/**
+* Compiles a type definition to a module and returns the module.
+*
+* @param context - The context object containing the environment paths.
+* @param input - The type definition to compile. This can be either a string or a {@link FileReference} object.
+* @param overrides - Optional overrides for the ESBuild configuration.
+* @returns A promise that resolves to the compiled module.
+*/
+async function resolveModule(context, input, overrides) {
+	const fileReference = extractFileReference(input);
+	if (!fileReference) throw new Error(`Failed to extract a file reference from the provided input ${JSON.stringify(input)}. The input must be a string or an object with a "file" property that specifies the file path and optional export name.`);
+	const result = await bundle(context, fileReference.file, overrides);
+	let resolved;
+	try {
+		resolved = await context.resolver.evalModule(result.text, {
+			filename: result.path,
+			ext: findFileDotExtension(result.path)
+		});
+	} catch (error) {
+		if (isSetString(error.message) && new RegExp(`Cannot find module '${context.config.framework?.name || "powerlines"}:.*'`).test(error.message)) {
+			const moduleName = error.message.match(new RegExp(`Cannot find module '(${context.config.framework?.name || "powerlines"}:.*)'`))?.[1];
+			throw new Error(`The module "${moduleName}" could not be resolved while evaluating "${fileReference.file}". It is possible the required built-in modules have not yet been generated. Please check the order of your plugins. ${context.config.logLevel.general === "debug" || context.config.logLevel.general === "trace" ? `
+
+Bundle output for module:
+${result.text && result.text.length > 5e4 ? `${result.text.slice(0, 5e4)}\n... [truncated]` : result.text}` : ""}`);
+		}
+		throw new Error(`Failed to evaluate the bundled module for "${fileReference.file}". Error: ${error.message}${context.config.logLevel.general === "debug" || context.config.logLevel.general === "trace" ? `
+
+Bundle output for module:
+${result.text && result.text.length > 5e4 ? `${result.text.slice(0, 5e4)}\n... [truncated]` : 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 input - The type definition to compile. This can be either a string or a {@link FileReference} object.
+* @param options - Optional overrides for the ESBuild configuration.
+* @returns A promise that resolves to the compiled module.
+*/
+async function resolve(context, input, options) {
+	const fileReference = extractFileReference(input);
+	if (!fileReference) throw new Error(`Failed to extract a file reference from the provided input. The input must be a string or an object with a "file" property that specifies the file path and optional export name.`);
+	const extension = findFileExtensionSafe(fileReference.file);
+	if (extension.startsWith("json")) try {
+		const json = await context.fs.read(fileReference.file);
+		if (!isSetString(json)) throw new Error(`The file at "${fileReference.file}" could not be read as a string. Please ensure the file exists and contains valid JSON.`);
+		return JSON.parse(json);
+	} catch (error) {
+		throw new Error(`Failed to read or parse the JSON file at "${fileReference.file}". Please ensure the file exists and contains valid JSON. Error: ${error.message}`);
+	}
+	else if (extension === "yaml" || extension === "yml") try {
+		const yaml = await context.fs.read(fileReference.file);
+		if (!isSetString(yaml)) throw new Error(`The file at "${fileReference.file}" could not be read as a string. Please ensure the file exists and contains valid YAML.`);
+		return parse$1(yaml);
+	} catch (error) {
+		throw new Error(`Failed to read or parse the YAML file at "${fileReference.file}". Please ensure the file exists and contains valid YAML. Error: ${error.message}`);
+	}
+	else if (extension === "toml") try {
+		const toml = await context.fs.read(fileReference.file);
+		if (!isSetString(toml)) throw new Error(`The file at "${fileReference.file}" could not be read as a string. Please ensure the file exists and contains valid TOML.`);
+		return parse(toml);
+	} catch (error) {
+		throw new Error(`Failed to read or parse the TOML file at "${fileReference.file}". Please ensure the file exists and contains valid TOML. Error: ${error.message}`);
+	}
+	const resolved = await resolveModule(context, fileReference, options);
+	let exportName = fileReference.export;
+	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 "${fileReference.file}" module. ${Object.keys(resolved).length === 0 ? `After bundling, no exports were found in the module. Please ensure that the "${fileReference.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
+export { resolve, resolveModule };
+//# sourceMappingURL=schema-resolve.mjs.map

package/dist/schema-resolve.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-resolve.mjs","names":["parseYaml","parseToml"],"sources":["../src/schema-resolve.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 type { UnresolvedContext } from \"@powerlines/core\";\nimport { extractFileReference } from \"@stryke/convert/extract-file-reference\";\nimport { findFileDotExtension, findFileExtensionSafe } from \"@stryke/path/find\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { FileReferenceInput } from \"@stryke/types/configuration\";\nimport { parse as parseToml } from \"smol-toml\";\nimport { parse as parseYaml } from \"yaml\";\nimport { bundle, BundleOptions } from \"./schema-bundle\";\n\n/**\n * Compiles a type definition to a module and returns the module.\n *\n * @param context - The context object containing the environment paths.\n * @param input - The type definition to compile. This can be either a string or a {@link FileReference} object.\n * @param overrides - Optional overrides for the ESBuild configuration.\n * @returns A promise that resolves to the compiled module.\n */\nexport async function resolveModule<\n  TResult,\n  TContext extends UnresolvedContext = UnresolvedContext\n>(\n  context: TContext,\n  input: FileReferenceInput,\n  overrides?: BundleOptions\n): Promise<TResult> {\n  const fileReference = extractFileReference(input);\n  if (!fileReference) {\n    throw new Error(\n      `Failed to extract a file reference from the provided input ${JSON.stringify(\n        input\n      )}. The input must be a string or an object with a \"file\" property that specifies the file path and optional export name.`\n    );\n  }\n\n  const result = await bundle<TContext>(context, fileReference.file, overrides);\n\n  let resolved: any;\n  try {\n    resolved = await context.resolver.evalModule(result.text, {\n      filename: result.path,\n      ext: findFileDotExtension(result.path)\n    });\n  } catch (error) {\n    if (\n      isSetString((error as Error).message) &&\n      new RegExp(\n        `Cannot find module '${context.config.framework?.name || \"powerlines\"}:.*'`\n      ).test((error as Error).message)\n    ) {\n      const moduleName = (error as Error).message.match(\n        new RegExp(\n          `Cannot find module '(${context.config.framework?.name || \"powerlines\"}:.*)'`\n        )\n      )?.[1];\n      throw new Error(\n        `The module \"${moduleName}\" could not be resolved while evaluating \"${\n          fileReference.file\n        }\". It is possible the required built-in modules have not yet been generated. Please check the order of your plugins. ${\n          context.config.logLevel.general === \"debug\" ||\n          context.config.logLevel.general === \"trace\"\n            ? `\n\nBundle output for module:\n${\n  result.text && result.text.length > 50_000\n    ? `${result.text.slice(0, 50_000)}\\n... [truncated]`\n    : result.text\n}`\n            : \"\"\n        }`\n      );\n    }\n\n    throw new Error(\n      `Failed to evaluate the bundled module for \"${\n        fileReference.file\n      }\". Error: ${(error as Error).message}${\n        context.config.logLevel.general === \"debug\" ||\n        context.config.logLevel.general === \"trace\"\n          ? `\n\nBundle output for module:\n${\n  result.text && result.text.length > 50_000\n    ? `${result.text.slice(0, 50_000)}\\n... [truncated]`\n    : result.text\n}`\n          : \"\"\n      }`\n    );\n  }\n\n  return resolved;\n}\n\n/**\n * Compiles a type definition to a module and returns the specified export from the module.\n *\n * @param context - The context object containing the environment paths.\n * @param input - The type definition to compile. This can be either a string or a {@link FileReference} object.\n * @param options - Optional overrides for the ESBuild configuration.\n * @returns A promise that resolves to the compiled module.\n */\nexport async function resolve<\n  TResult,\n  TContext extends UnresolvedContext = UnresolvedContext\n>(\n  context: TContext,\n  input: FileReferenceInput,\n  options?: BundleOptions\n): Promise<TResult> {\n  const fileReference = extractFileReference(input);\n  if (!fileReference) {\n    throw new Error(\n      `Failed to extract a file reference from the provided input. The input must be a string or an object with a \"file\" property that specifies the file path and optional export name.`\n    );\n  }\n\n  const extension = findFileExtensionSafe(fileReference.file);\n  if (extension.startsWith(\"json\")) {\n    try {\n      const json = await context.fs.read(fileReference.file);\n      if (!isSetString(json)) {\n        throw new Error(\n          `The file at \"${fileReference.file}\" could not be read as a string. Please ensure the file exists and contains valid JSON.`\n        );\n      }\n\n      return JSON.parse(json) as TResult;\n    } catch (error) {\n      throw new Error(\n        `Failed to read or parse the JSON file at \"${fileReference.file}\". Please ensure the file exists and contains valid JSON. Error: ${(error as Error).message}`\n      );\n    }\n  } else if (extension === \"yaml\" || extension === \"yml\") {\n    try {\n      const yaml = await context.fs.read(fileReference.file);\n      if (!isSetString(yaml)) {\n        throw new Error(\n          `The file at \"${fileReference.file}\" could not be read as a string. Please ensure the file exists and contains valid YAML.`\n        );\n      }\n\n      return parseYaml(yaml) as TResult;\n    } catch (error) {\n      throw new Error(\n        `Failed to read or parse the YAML file at \"${fileReference.file}\". Please ensure the file exists and contains valid YAML. Error: ${(error as Error).message}`\n      );\n    }\n  } else if (extension === \"toml\") {\n    try {\n      const toml = await context.fs.read(fileReference.file);\n      if (!isSetString(toml)) {\n        throw new Error(\n          `The file at \"${fileReference.file}\" could not be read as a string. Please ensure the file exists and contains valid TOML.`\n        );\n      }\n\n      return parseToml(toml) as TResult;\n    } catch (error) {\n      throw new Error(\n        `Failed to read or parse the TOML file at \"${fileReference.file}\". Please ensure the file exists and contains valid TOML. Error: ${(error as Error).message}`\n      );\n    }\n  }\n\n  const resolved = await resolveModule<Record<string, any>, TContext>(\n    context,\n    fileReference,\n    options\n  );\n\n  let exportName = fileReference.export;\n  if (!exportName) {\n    exportName = \"default\";\n  }\n\n  const resolvedExport = resolved[exportName] ?? resolved[`__Ω${exportName}`];\n  if (resolvedExport === undefined) {\n    throw new Error(\n      `The export \"${exportName}\" could not be resolved in the \"${\n        fileReference.file\n      }\" module. ${\n        Object.keys(resolved).length === 0\n          ? `After bundling, no exports were found in the module. Please ensure that the \"${\n              fileReference.file\n            }\" module has a \"${exportName}\" export with the desired value.`\n          : `After bundling, the available exports were: ${Object.keys(\n              resolved\n            ).join(\n              \", \"\n            )}. Please ensure that the export exists and is correctly named.`\n      }`\n    );\n  }\n\n  return resolvedExport;\n}\n"],"mappings":"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"}

package/dist/schema.cjs

@@ -1,9 +1,22 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_schema_bundle = require('./schema-bundle.cjs');
+const require_schema_resolve = require('./schema-resolve.cjs');
 
+exports.bundle = require_schema_bundle.bundle;
+exports.resolve = require_schema_resolve.resolve;
+exports.resolveModule = require_schema_resolve.resolveModule;
+var _power_plant_schema = require("@power-plant/schema");
+Object.keys(_power_plant_schema).forEach(function (k) {
+  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+    enumerable: true,
+    get: function () { return _power_plant_schema[k]; }
+  });
+});
 
-var _powerlines_schema = require("@powerlines/schema");
-Object.keys(_powerlines_schema).forEach(function (k) {
+var _power_plant_schema_codegen = require("@power-plant/schema/codegen");
+Object.keys(_power_plant_schema_codegen).forEach(function (k) {
   if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
     enumerable: true,
-    get: function () { return _powerlines_schema[k]; }
+    get: function () { return _power_plant_schema_codegen[k]; }
   });
 });

package/dist/schema.d.cts

@@ -1 +1,5 @@
-export * from "@powerlines/schema";
+import { BundleOptions, bundle } from "./schema-bundle.cjs";
+import { resolve, resolveModule } from "./schema-resolve.cjs";
+export * from "@power-plant/schema";
+export * from "@power-plant/schema/codegen";
+export { BundleOptions, bundle, resolve, resolveModule };

package/dist/schema.d.mts

@@ -1 +1,5 @@
-export * from "@powerlines/schema";
+import { BundleOptions, bundle } from "./schema-bundle.mjs";
+import { resolve, resolveModule } from "./schema-resolve.mjs";
+export * from "@power-plant/schema";
+export * from "@power-plant/schema/codegen";
+export { BundleOptions, bundle, resolve, resolveModule };

package/dist/schema.mjs

@@ -1,3 +1,8 @@
-export * from "@powerlines/schema"
+import { bundle } from "./schema-bundle.mjs";
+import { resolve, resolveModule } from "./schema-resolve.mjs";
 
-export {  };
+export * from "@power-plant/schema"
+
+export * from "@power-plant/schema/codegen"
+
+export { bundle, resolve, resolveModule };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "powerlines",
-  "version": "0.47.145",
+  "version": "0.47.146",
   "private": false,
   "description": "The \"framework framework\" that simplifies modern dev tool usage, generates virtual (or actual) code modules, and improves DX across the board.",
   "keywords": [
@@ -140,6 +140,14 @@
       "import": "./dist/schema.mjs",
       "require": "./dist/schema.cjs"
     },
+    "./schema-bundle": {
+      "import": "./dist/schema-bundle.mjs",
+      "require": "./dist/schema-bundle.cjs"
+    },
+    "./schema-resolve": {
+      "import": "./dist/schema-resolve.mjs",
+      "require": "./dist/schema-resolve.cjs"
+    },
     "./storage": {
       "import": "./dist/storage.mjs",
       "require": "./dist/storage.cjs"
@@ -173,25 +181,31 @@
   "files": ["dist", "bin", "files"],
   "dependencies": {
     "@babel/types": "^8.0.4",
-    "@powerlines/core": "^0.48.66",
-    "@powerlines/engine": "^0.49.68",
-    "@powerlines/schema": "^0.11.127",
-    "@powerlines/unplugin": "^0.0.114",
+    "@power-plant/schema": "^0.0.22",
+    "@powerlines/core": "^0.48.67",
+    "@powerlines/engine": "^0.49.69",
+    "@powerlines/unplugin": "^0.0.115",
     "@storm-software/config": "^1.138.46",
     "@storm-software/config-tools": "^1.190.109",
     "@stryke/convert": "^0.7.27",
     "@stryke/env": "^0.20.114",
     "@stryke/fs": "^0.33.97",
+    "@stryke/helpers": "^0.10.36",
+    "@stryke/path": "^0.29.23",
+    "@stryke/type-checks": "^0.6.29",
+    "@stryke/types": "^0.12.24",
     "defu": "^6.1.7",
-    "unplugin": "^3.3.0"
+    "esbuild": "^0.28.1",
+    "smol-toml": "^1.7.0",
+    "unplugin": "^3.3.0",
+    "yaml": "^2.9.0"
   },
   "devDependencies": {
     "@storm-software/testing-tools": "^1.119.262",
-    "@stryke/types": "^0.12.24",
     "@types/node": "^25.9.5",
     "typescript": "^6.0.3",
     "undici-types": "^7.28.0"
   },
   "publishConfig": { "access": "public" },
-  "gitHead": "d81170b608c0b80e7726e129c3edd1b7b6ca2605"
+  "gitHead": "e86d6fab3bd4d2e2f9f6d05df8df7a07d399857e"
 }