@powerlines/plugin-env 0.14.21 → 0.14.23

package/dist/index.cjs

@@ -1,10 +1,208 @@
-Object.defineProperty(exports,`__esModule`,{value:!0});const e=require(`./_virtual/rolldown_runtime.cjs`),t=require(`./deepkit/src/vendor/type.cjs`),n=require(`./plugin-alloy/src/index.cjs`),r=require(`./plugin-automd/src/index.cjs`),i=require(`./plugin-babel/src/index.cjs`),a=require(`./helpers/reflect.cjs`),o=require(`./helpers/persistence.cjs`),s=require(`./babel/plugin.cjs`),c=require(`./helpers/source-file-env.cjs`),l=require(`./helpers/load.cjs`),u=require(`./helpers/create-reflection-resource.cjs`),d=require(`./components/env.cjs`),f=require(`./helpers/automd-generator.cjs`);require(`./babel/index.cjs`);const p=require(`./components/docs.cjs`);require(`./components/index.cjs`);const m=require(`./helpers/template-helpers.cjs`);require(`./helpers/index.cjs`);let h=require(`@alloy-js/core/jsx-runtime`),g=require(`@stryke/convert/to-array`),_=require(`defu`);_=e.__toESM(_);let v=require(`@storm-software/config-tools/types`),y=require(`@stryke/path/is-parent-path`),b=require(`@stryke/string-format/title-case`),x=require(`@stryke/convert/parse-type-definition`),S=require(`@stryke/env/types`),C=require(`@stryke/fs/exists`),w=require(`@stryke/fs/helpers`),T=require(`@stryke/path/join`),E=require(`@stryke/string-format/constant-case`);const D=(e={})=>[n.default(e.alloy),i.default(e.babel),{name:`env`,async config(){this.log(v.LogLevelLabel.TRACE,"Providing default configuration for the Powerlines `env` build plugin.");let t={env:(0,_.default)(e,{types:{},prefix:[]}),transform:{babel:{plugins:[s.envBabelPlugin]}}};if(t.env.types)t.env.types=(0,x.parseTypeDefinition)(t.env.types);else{this.log(v.LogLevelLabel.WARN,"The `env.types` configuration parameter was not provided. Please ensure this is expected.");let e=await o.getEnvDefaultTypeDefinition(this);t.env.types=(0,x.parseTypeDefinition)(`${e.file}#${e.name}`)}if(t.env.secrets)t.env.secrets=(0,x.parseTypeDefinition)(t.env.secrets);else{let e=await o.getSecretsDefaultTypeDefinition(this);t.env.secrets=(0,x.parseTypeDefinition)(`${e.file}#${e.name}`)}return t.env.prefix=(0,g.toArray)(t.env.prefix??[]).reduce((e,t)=>{let n=(0,E.constantCase)(t);return e.includes(n)||e.push(n),e},[...S.ENV_PREFIXES,`POWERLINES_`]),t.env.prefix=t.env.prefix.reduce((e,t)=>(e.includes(t.replace(/_$/g,``))||e.push(t.replace(/_$/g,``)),e),[]),t},async configResolved(){if(this.log(v.LogLevelLabel.TRACE,`Environment plugin configuration has been resolved for the Powerlines project.`),this.config.env.inject??=this.config.projectType===`application`,this.env=(0,_.default)({parsed:await l.loadEnv(this,this.config.env)},this.env??{},{types:{env:{}},used:{env:{},secrets:{}},parsed:{},injected:{}}),this.config.command!==`prepare`&&this.persistedMeta?.checksum===this.meta.checksum&&(0,C.existsSync)(o.getEnvTypeReflectionsPath(this,`env`)))this.log(v.LogLevelLabel.TRACE,`Skipping reflection initialization as the meta checksum has not changed.`),this.env.types.env=await o.readEnvTypeReflection(this,`env`),(0,C.existsSync)(o.getEnvReflectionsPath(this,`env`))&&(this.env.used.env=await o.readEnvReflection(this)),(0,C.existsSync)(o.getEnvTypeReflectionsPath(this,`secrets`))&&(this.env.types.secrets=await o.readEnvTypeReflection(this,`secrets`)),(0,C.existsSync)(o.getEnvReflectionsPath(this,`secrets`))&&(this.env.used.secrets=await o.readSecretsReflection(this));else{if(this.env.types.env=await a.reflectEnv(this,this.config.env.types?.file?(0,y.isParentPath)(this.config.env.types?.file,this.workspaceConfig.workspaceRoot)?this.config.env.types?.file:(0,T.joinPaths)(this.config.projectRoot,this.config.env.types?.file):void 0,this.config.env.types?.name),!this.env.types.env)throw Error(`Failed to find the environment configuration type reflection in the context.`);if(await o.writeEnvTypeReflection(this,this.env.types.env,`env`),this.env.types.secrets=await a.reflectSecrets(this,this.config.env.secrets?.file?(0,y.isParentPath)(this.config.env.secrets?.file,this.workspaceConfig.workspaceRoot)?this.config.env.secrets?.file:(0,T.joinPaths)(this.config.projectRoot,this.config.env.secrets?.file):void 0,this.config.env.secrets?.name),!this.env.types.secrets)throw Error(`Failed to find the secrets configuration type reflection in the context.`);await o.writeEnvTypeReflection(this,this.env.types.secrets,`secrets`),this.log(v.LogLevelLabel.TRACE,`Resolved ${this.env.types.env.getProperties().length??0} environment configuration parameters and ${this.env.types.secrets?.getProperties().length??0} secret configuration parameters`);let e=this.env.types.env.getProperties().filter(e=>e.getAlias().length>0);Object.entries(await l.loadEnv(this,this.config.env)).forEach(([t,n])=>{let r=this.config.env.prefix.reduce((e,n)=>t.replace(/_$/g,``).startsWith(n)?t.replace(/_$/g,``).slice(n.length):e,t),i=e.find(e=>e?.getAlias().reverse().includes(r));(this.env.types.env?.hasProperty(r)||i)&&this.env.types.env.getProperty(r).setDefaultValue(n)}),this.env.used.env=new t.type_exports.ReflectionClass({kind:t.type_exports.ReflectionKind.objectLiteral,typeName:`Env`,description:`An object containing the environment configuration parameters used by the ${this.config.name?`${this.config.name} application`:`application`}.`,types:[]},this.env.types.env),await o.writeEnvReflection(this,this.env.used.env,`env`),this.env.types.secrets&&(await o.writeEnvTypeReflection(this,this.env.types.secrets,`secrets`),this.env.used.secrets=new t.type_exports.ReflectionClass({kind:t.type_exports.ReflectionKind.objectLiteral,typeName:`Secrets`,description:`An object containing the secret configuration parameters used by the ${this.config.name?`${this.config.name} application`:`application`}.`,types:[]},this.env.types.secrets),await o.writeEnvReflection(this,this.env.used.secrets,`secrets`))}},async prepare(){let e=this;return this.log(v.LogLevelLabel.TRACE,`Preparing the Environment runtime artifacts for the Powerlines project.`),this.render((0,h.createComponent)(d.EnvBuiltin,{get defaultConfig(){return e.config.env.defaultConfig}}))},async docs(){this.log(v.LogLevelLabel.TRACE,`Writing Environment documentation for the Powerlines project artifacts.`);let e=(0,T.joinPaths)(this.config.projectRoot,`docs`,`generated`);(0,C.existsSync)(e)||await(0,w.createDirectory)(e);let n=await o.readEnvTypeReflection(this,`env`),r=(0,T.joinPaths)(e,`env.md`);this.log(v.LogLevelLabel.TRACE,`Documenting environment variables configuration in "${r}"`),await this.fs.write(r,`<!-- Generated by ${(0,b.titleCase)(this.config.framework)||`Powerlines`} -->
+Object.defineProperty(exports, '__esModule', { value: true });
+const require_rolldown_runtime = require('./_virtual/rolldown_runtime.cjs');
+const require_type = require('./deepkit/src/vendor/type.cjs');
+const require_index = require('./plugin-alloy/src/index.cjs');
+const require_index$1 = require('./plugin-automd/src/index.cjs');
+const require_index$2 = require('./plugin-babel/src/index.cjs');
+const require_reflect = require('./helpers/reflect.cjs');
+const require_persistence = require('./helpers/persistence.cjs');
+const require_plugin = require('./babel/plugin.cjs');
+const require_source_file_env = require('./helpers/source-file-env.cjs');
+const require_load = require('./helpers/load.cjs');
+const require_create_reflection_resource = require('./helpers/create-reflection-resource.cjs');
+const require_components_env = require('./components/env.cjs');
+const require_automd_generator = require('./helpers/automd-generator.cjs');
+require('./babel/index.cjs');
+const require_components_docs = require('./components/docs.cjs');
+require('./components/index.cjs');
+const require_template_helpers = require('./helpers/template-helpers.cjs');
+require('./helpers/index.cjs');
+let __alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
+let __stryke_convert_to_array = require("@stryke/convert/to-array");
+let defu = require("defu");
+defu = require_rolldown_runtime.__toESM(defu);
+let __storm_software_config_tools_types = require("@storm-software/config-tools/types");
+let __stryke_path_is_parent_path = require("@stryke/path/is-parent-path");
+let __stryke_string_format_title_case = require("@stryke/string-format/title-case");
+let __stryke_convert_parse_type_definition = require("@stryke/convert/parse-type-definition");
+let __stryke_env_types = require("@stryke/env/types");
+let __stryke_fs_exists = require("@stryke/fs/exists");
+let __stryke_fs_helpers = require("@stryke/fs/helpers");
+let __stryke_path_join = require("@stryke/path/join");
+let __stryke_string_format_constant_case = require("@stryke/string-format/constant-case");
+
+//#region src/index.tsx
+/**
+* A Powerlines plugin to inject environment variables into the source code.
+*/
+const plugin = (options = {}) => {
+	return [
+		require_index.default(options.alloy),
+		require_index$2.default(options.babel),
+		{
+			name: "env",
+			async config() {
+				this.log(__storm_software_config_tools_types.LogLevelLabel.TRACE, "Providing default configuration for the Powerlines `env` build plugin.");
+				const config = {
+					env: (0, defu.default)(options, {
+						types: {},
+						prefix: []
+					}),
+					transform: { babel: { plugins: [require_plugin.envBabelPlugin] } }
+				};
+				if (config.env.types) config.env.types = (0, __stryke_convert_parse_type_definition.parseTypeDefinition)(config.env.types);
+				else {
+					this.log(__storm_software_config_tools_types.LogLevelLabel.WARN, "The `env.types` configuration parameter was not provided. Please ensure this is expected.");
+					const envDefaultTypeDefinition = await require_persistence.getEnvDefaultTypeDefinition(this);
+					config.env.types = (0, __stryke_convert_parse_type_definition.parseTypeDefinition)(`${envDefaultTypeDefinition.file}#${envDefaultTypeDefinition.name}`);
+				}
+				if (config.env.secrets) config.env.secrets = (0, __stryke_convert_parse_type_definition.parseTypeDefinition)(config.env.secrets);
+				else {
+					const secretsDefaultTypeDefinition = await require_persistence.getSecretsDefaultTypeDefinition(this);
+					config.env.secrets = (0, __stryke_convert_parse_type_definition.parseTypeDefinition)(`${secretsDefaultTypeDefinition.file}#${secretsDefaultTypeDefinition.name}`);
+				}
+				config.env.prefix = (0, __stryke_convert_to_array.toArray)(config.env.prefix ?? []).reduce((ret, prefix) => {
+					const formattedPrefix = (0, __stryke_string_format_constant_case.constantCase)(prefix);
+					if (!ret.includes(formattedPrefix)) ret.push(formattedPrefix);
+					return ret;
+				}, [...__stryke_env_types.ENV_PREFIXES, "POWERLINES_"]);
+				config.env.prefix = config.env.prefix.reduce((ret, prefix) => {
+					if (!ret.includes(prefix.replace(/_$/g, ""))) ret.push(prefix.replace(/_$/g, ""));
+					return ret;
+				}, []);
+				return config;
+			},
+			async configResolved() {
+				this.log(__storm_software_config_tools_types.LogLevelLabel.TRACE, `Environment plugin configuration has been resolved for the Powerlines project.`);
+				this.config.env.inject ??= this.config.projectType === "application";
+				this.env = (0, defu.default)({ parsed: await require_load.loadEnv(this, this.config.env) }, this.env ?? {}, {
+					types: { env: {} },
+					used: {
+						env: {},
+						secrets: {}
+					},
+					parsed: {},
+					injected: {}
+				});
+				if (this.config.command !== "prepare" && this.persistedMeta?.checksum === this.meta.checksum && (0, __stryke_fs_exists.existsSync)(require_persistence.getEnvTypeReflectionsPath(this, "env"))) {
+					this.log(__storm_software_config_tools_types.LogLevelLabel.TRACE, `Skipping reflection initialization as the meta checksum has not changed.`);
+					this.env.types.env = await require_persistence.readEnvTypeReflection(this, "env");
+					if ((0, __stryke_fs_exists.existsSync)(require_persistence.getEnvReflectionsPath(this, "env"))) this.env.used.env = await require_persistence.readEnvReflection(this);
+					if ((0, __stryke_fs_exists.existsSync)(require_persistence.getEnvTypeReflectionsPath(this, "secrets"))) this.env.types.secrets = await require_persistence.readEnvTypeReflection(this, "secrets");
+					if ((0, __stryke_fs_exists.existsSync)(require_persistence.getEnvReflectionsPath(this, "secrets"))) this.env.used.secrets = await require_persistence.readSecretsReflection(this);
+				} else {
+					this.env.types.env = await require_reflect.reflectEnv(this, this.config.env.types?.file ? (0, __stryke_path_is_parent_path.isParentPath)(this.config.env.types?.file, this.workspaceConfig.workspaceRoot) ? this.config.env.types?.file : (0, __stryke_path_join.joinPaths)(this.config.projectRoot, this.config.env.types?.file) : void 0, this.config.env.types?.name);
+					if (!this.env.types.env) throw new Error("Failed to find the environment configuration type reflection in the context.");
+					await require_persistence.writeEnvTypeReflection(this, this.env.types.env, "env");
+					this.env.types.secrets = await require_reflect.reflectSecrets(this, this.config.env.secrets?.file ? (0, __stryke_path_is_parent_path.isParentPath)(this.config.env.secrets?.file, this.workspaceConfig.workspaceRoot) ? this.config.env.secrets?.file : (0, __stryke_path_join.joinPaths)(this.config.projectRoot, this.config.env.secrets?.file) : void 0, this.config.env.secrets?.name);
+					if (!this.env.types.secrets) throw new Error("Failed to find the secrets configuration type reflection in the context.");
+					await require_persistence.writeEnvTypeReflection(this, this.env.types.secrets, "secrets");
+					this.log(__storm_software_config_tools_types.LogLevelLabel.TRACE, `Resolved ${this.env.types.env.getProperties().length ?? 0} environment configuration parameters and ${this.env.types.secrets?.getProperties().length ?? 0} secret configuration parameters`);
+					const envWithAlias = this.env.types.env.getProperties().filter((prop) => prop.getAlias().length > 0);
+					Object.entries(await require_load.loadEnv(this, this.config.env)).forEach(([key, value]) => {
+						const unprefixedKey = this.config.env.prefix.reduce((ret, prefix) => {
+							if (key.replace(/_$/g, "").startsWith(prefix)) return key.replace(/_$/g, "").slice(prefix.length);
+							return ret;
+						}, key);
+						const aliasKey = envWithAlias.find((prop) => prop?.getAlias().reverse().includes(unprefixedKey));
+						if (this.env.types.env?.hasProperty(unprefixedKey) || aliasKey) this.env.types.env.getProperty(unprefixedKey).setDefaultValue(value);
+					});
+					this.env.used.env = new require_type.type_exports.ReflectionClass({
+						kind: require_type.type_exports.ReflectionKind.objectLiteral,
+						typeName: "Env",
+						description: `An object containing the environment configuration parameters used by the ${this.config.name ? `${this.config.name} application` : "application"}.`,
+						types: []
+					}, this.env.types.env);
+					await require_persistence.writeEnvReflection(this, this.env.used.env, "env");
+					if (this.env.types.secrets) {
+						await require_persistence.writeEnvTypeReflection(this, this.env.types.secrets, "secrets");
+						this.env.used.secrets = new require_type.type_exports.ReflectionClass({
+							kind: require_type.type_exports.ReflectionKind.objectLiteral,
+							typeName: "Secrets",
+							description: `An object containing the secret configuration parameters used by the ${this.config.name ? `${this.config.name} application` : "application"}.`,
+							types: []
+						}, this.env.types.secrets);
+						await require_persistence.writeEnvReflection(this, this.env.used.secrets, "secrets");
+					}
+				}
+			},
+			async prepare() {
+				const _self$ = this;
+				this.log(__storm_software_config_tools_types.LogLevelLabel.TRACE, `Preparing the Environment runtime artifacts for the Powerlines project.`);
+				return this.render((0, __alloy_js_core_jsx_runtime.createComponent)(require_components_env.EnvBuiltin, { get defaultConfig() {
+					return _self$.config.env.defaultConfig;
+				} }));
+			},
+			async docs() {
+				this.log(__storm_software_config_tools_types.LogLevelLabel.TRACE, "Writing Environment documentation for the Powerlines project artifacts.");
+				const outputPath = (0, __stryke_path_join.joinPaths)(this.config.projectRoot, "docs", "generated");
+				if (!(0, __stryke_fs_exists.existsSync)(outputPath)) await (0, __stryke_fs_helpers.createDirectory)(outputPath);
+				const reflection = await require_persistence.readEnvTypeReflection(this, "env");
+				const envDocFile = (0, __stryke_path_join.joinPaths)(outputPath, "env.md");
+				this.log(__storm_software_config_tools_types.LogLevelLabel.TRACE, `Documenting environment variables configuration in "${envDocFile}"`);
+				await this.fs.write(envDocFile, `<!-- Generated by ${(0, __stryke_string_format_title_case.titleCase)(this.config.framework) || "Powerlines"} -->
 
 Below is a list of environment variables used by the [${this.packageJson.name}](https://www.npmjs.com/package/${this.packageJson.name}) package. These values can be updated in the \`.env\` file in the root of the project. The variables in the list below are used as configuration parameters to drive the processing of the application. The data contained in these variables are **not** considered sensitive or confidential. Any values provided in these variables will be available in plain text to the public.
 
 | Name | Description | Type | Default Value | Required |
 | ---- | ----------- | ---- | ------------- | :------: |
-${n.getProperties().filter(e=>e.getNameAsString()!==`__POWERLINES_INJECTED__`).sort((e,t)=>e.getNameAsString().localeCompare(t.getNameAsString())).map(e=>`| ${e.getNameAsString().trim()} | ${(e.getDescription()?.replaceAll(`\r`,``)?.replaceAll(`
-`,``)??``).trim()} | ${(0,t.type_exports.stringifyType)(e.getType()).trim().replaceAll(` | `,`, or `)} | ${e.hasDefault()?String(e.getDefaultValue())?.includes(`"`)?e.getDefaultValue():`\`${e.getDefaultValue()}\``:``} | ${e.isValueRequired()?``:`✔`} |`).join(`
-`)}
-`)},async buildEnd(){let e=o.getEnvReflectionsPath(this,`env`);this.log(v.LogLevelLabel.TRACE,`Writing env reflection types to ${e}.`),await o.writeEnvReflection(this,this.env.used.env,`env`)}},{name:`env:automd-generator`,config(){return{automd:(0,_.default)(e.automd??{},{generators:{env:f.env(this)}})}}},{name:`env:vite`,vite:{configResolved(){return{envPrefix:this.config?.env?.prefix}}}},r.default(e.automd)];var O=D;exports.BaseEnv=a.BaseEnv,exports.BaseSecrets=a.BaseSecrets,exports.EnvBuiltin=d.EnvBuiltin,exports.EnvDocs=p.EnvDocs,exports.EnvTypeDefinition=d.EnvTypeDefinition,exports.createEnvReflection=a.createEnvReflection,exports.createReflectionResource=u.createReflectionResource,exports.createSecretsReflection=a.createSecretsReflection,exports.createTemplateReflection=m.createTemplateReflection,exports.default=O,exports.envBabelPlugin=s.envBabelPlugin,exports.formatEnvField=c.formatEnvField,exports.getEnvDefaultTypeDefinition=o.getEnvDefaultTypeDefinition,exports.getEnvReflectionsPath=o.getEnvReflectionsPath,exports.getEnvTypeReflectionsPath=o.getEnvTypeReflectionsPath,exports.getSecretsDefaultTypeDefinition=o.getSecretsDefaultTypeDefinition,exports.loadEnv=l.loadEnv,exports.loadEnvFromContext=l.loadEnvFromContext,exports.mergeEnvReflections=a.mergeEnvReflections,exports.mergeSecretsReflections=a.mergeSecretsReflections,exports.plugin=D,exports.readEnvReflection=o.readEnvReflection,exports.readEnvTypeReflection=o.readEnvTypeReflection,exports.readSecretsReflection=o.readSecretsReflection,exports.reflectEnv=a.reflectEnv,exports.reflectSecrets=a.reflectSecrets,exports.removeEnvPrefix=c.removeEnvPrefix,exports.resolveRuntimeTypeFile=o.resolveRuntimeTypeFile,exports.writeEnvReflection=o.writeEnvReflection,exports.writeEnvReflectionSync=o.writeEnvReflectionSync,exports.writeEnvTypeReflection=o.writeEnvTypeReflection;
+${reflection.getProperties().filter((property) => property.getNameAsString() !== "__POWERLINES_INJECTED__").sort((a, b) => a.getNameAsString().localeCompare(b.getNameAsString())).map((reflectionProperty) => {
+					return `| ${reflectionProperty.getNameAsString().trim()} | ${(reflectionProperty.getDescription()?.replaceAll("\r", "")?.replaceAll("\n", "") ?? "").trim()} | ${(0, require_type.type_exports.stringifyType)(reflectionProperty.getType()).trim().replaceAll(" | ", ", or ")} | ${reflectionProperty.hasDefault() ? String(reflectionProperty.getDefaultValue())?.includes("\"") ? reflectionProperty.getDefaultValue() : `\`${reflectionProperty.getDefaultValue()}\`` : ""} | ${reflectionProperty.isValueRequired() ? "" : "✔"} |`;
+				}).join("\n")}
+`);
+			},
+			async buildEnd() {
+				const reflectionPath = require_persistence.getEnvReflectionsPath(this, "env");
+				this.log(__storm_software_config_tools_types.LogLevelLabel.TRACE, `Writing env reflection types to ${reflectionPath}.`);
+				await require_persistence.writeEnvReflection(this, this.env.used.env, "env");
+			}
+		},
+		{
+			name: "env:automd-generator",
+			config() {
+				return { automd: (0, defu.default)(options.automd ?? {}, { generators: { "env": require_automd_generator.env(this) } }) };
+			}
+		},
+		{
+			name: "env:vite",
+			vite: { configResolved() {
+				return { envPrefix: this.config?.env?.prefix };
+			} }
+		},
+		require_index$1.default(options.automd)
+	];
+};
+var src_default = plugin;
+
+//#endregion
+exports.BaseEnv = require_reflect.BaseEnv;
+exports.BaseSecrets = require_reflect.BaseSecrets;
+exports.EnvBuiltin = require_components_env.EnvBuiltin;
+exports.EnvDocs = require_components_docs.EnvDocs;
+exports.EnvTypeDefinition = require_components_env.EnvTypeDefinition;
+exports.createEnvReflection = require_reflect.createEnvReflection;
+exports.createReflectionResource = require_create_reflection_resource.createReflectionResource;
+exports.createSecretsReflection = require_reflect.createSecretsReflection;
+exports.createTemplateReflection = require_template_helpers.createTemplateReflection;
+exports.default = src_default;
+exports.envBabelPlugin = require_plugin.envBabelPlugin;
+exports.formatEnvField = require_source_file_env.formatEnvField;
+exports.getEnvDefaultTypeDefinition = require_persistence.getEnvDefaultTypeDefinition;
+exports.getEnvReflectionsPath = require_persistence.getEnvReflectionsPath;
+exports.getEnvTypeReflectionsPath = require_persistence.getEnvTypeReflectionsPath;
+exports.getSecretsDefaultTypeDefinition = require_persistence.getSecretsDefaultTypeDefinition;
+exports.loadEnv = require_load.loadEnv;
+exports.loadEnvFromContext = require_load.loadEnvFromContext;
+exports.mergeEnvReflections = require_reflect.mergeEnvReflections;
+exports.mergeSecretsReflections = require_reflect.mergeSecretsReflections;
+exports.plugin = plugin;
+exports.readEnvReflection = require_persistence.readEnvReflection;
+exports.readEnvTypeReflection = require_persistence.readEnvTypeReflection;
+exports.readSecretsReflection = require_persistence.readSecretsReflection;
+exports.reflectEnv = require_reflect.reflectEnv;
+exports.reflectSecrets = require_reflect.reflectSecrets;
+exports.removeEnvPrefix = require_source_file_env.removeEnvPrefix;
+exports.resolveRuntimeTypeFile = require_persistence.resolveRuntimeTypeFile;
+exports.writeEnvReflection = require_persistence.writeEnvReflection;
+exports.writeEnvReflectionSync = require_persistence.writeEnvReflectionSync;
+exports.writeEnvTypeReflection = require_persistence.writeEnvTypeReflection;

package/dist/index.d.cts

@@ -1,17 +1,15 @@
 import { EnvDocs } from "./components/docs.cjs";
 import { EnvBuiltin, EnvBuiltinProps, EnvTypeDefinition, __ΩEnvBuiltinProps } from "./components/env.cjs";
+import { Plugin } from "./powerlines/src/types/plugin.cjs";
 import { EnvInterface, SecretsInterface, __ΩEnvInterface, __ΩSecretsInterface } from "./types/runtime.cjs";
 import { EnvPluginContext, EnvPluginOptions, EnvPluginResolvedConfig, EnvPluginUserConfig, EnvType, __ΩEnvPluginContext, __ΩEnvPluginOptions, __ΩEnvPluginResolvedConfig, __ΩEnvPluginUserConfig, __ΩEnvType } from "./types/plugin.cjs";
 import { envBabelPlugin } from "./babel/plugin.cjs";
-import "./babel/index.cjs";
 import { createReflectionResource } from "./helpers/create-reflection-resource.cjs";
 import { loadEnv, loadEnvFromContext } from "./helpers/load.cjs";
 import { getEnvDefaultTypeDefinition, getEnvReflectionsPath, getEnvTypeReflectionsPath, getSecretsDefaultTypeDefinition, readEnvReflection, readEnvTypeReflection, readSecretsReflection, resolveRuntimeTypeFile, writeEnvReflection, writeEnvReflectionSync, writeEnvTypeReflection } from "./helpers/persistence.cjs";
 import { BaseEnv, BaseSecrets, CreateEnvReflectionOptions, __ΩCreateEnvReflectionOptions, createEnvReflection, createSecretsReflection, mergeEnvReflections, mergeSecretsReflections, reflectEnv, reflectSecrets } from "./helpers/reflect.cjs";
 import { formatEnvField, removeEnvPrefix } from "./helpers/source-file-env.cjs";
 import { createTemplateReflection } from "./helpers/template-helpers.cjs";
-import "./helpers/index.cjs";
-import { Plugin } from "powerlines";
 
 //#region src/index.d.ts
 /**

package/dist/index.d.mts

@@ -1,6 +1,8 @@
 import { EnvDocs } from "./components/docs.mjs";
 import { EnvBuiltin, EnvBuiltinProps, EnvTypeDefinition, __ΩEnvBuiltinProps } from "./components/env.mjs";
 import "./components/index.mjs";
+import { Plugin } from "./powerlines/src/types/plugin.mjs";
+import "./powerlines/src/index.mjs";
 import { EnvInterface, SecretsInterface, __ΩEnvInterface, __ΩSecretsInterface } from "./types/runtime.mjs";
 import { EnvPluginContext, EnvPluginOptions, EnvPluginResolvedConfig, EnvPluginUserConfig, EnvType, __ΩEnvPluginContext, __ΩEnvPluginOptions, __ΩEnvPluginResolvedConfig, __ΩEnvPluginUserConfig, __ΩEnvType } from "./types/plugin.mjs";
 import { envBabelPlugin } from "./babel/plugin.mjs";
@@ -13,7 +15,6 @@ import { formatEnvField, removeEnvPrefix } from "./helpers/source-file-env.mjs";
 import { createTemplateReflection } from "./helpers/template-helpers.mjs";
 import "./helpers/index.mjs";
 import "./types/index.mjs";
-import { Plugin } from "powerlines";
 
 //#region src/index.d.ts
 /**

package/dist/index.mjs

@@ -1,10 +1,175 @@
-import{type_exports as e}from"./deepkit/src/vendor/type.mjs";import t from"./plugin-alloy/src/index.mjs";import n from"./plugin-automd/src/index.mjs";import r from"./plugin-babel/src/index.mjs";import{BaseEnv as i,BaseSecrets as a,createEnvReflection as o,createSecretsReflection as s,mergeEnvReflections as c,mergeSecretsReflections as l,reflectEnv as u,reflectSecrets as d}from"./helpers/reflect.mjs";import{getEnvDefaultTypeDefinition as f,getEnvReflectionsPath as p,getEnvTypeReflectionsPath as m,getSecretsDefaultTypeDefinition as h,readEnvReflection as g,readEnvTypeReflection as _,readSecretsReflection as v,resolveRuntimeTypeFile as y,writeEnvReflection as b,writeEnvReflectionSync as x,writeEnvTypeReflection as S}from"./helpers/persistence.mjs";import{envBabelPlugin as C}from"./babel/plugin.mjs";import{formatEnvField as w,removeEnvPrefix as T}from"./helpers/source-file-env.mjs";import{loadEnv as E,loadEnvFromContext as D}from"./helpers/load.mjs";import{createReflectionResource as O}from"./helpers/create-reflection-resource.mjs";import{EnvBuiltin as k,EnvTypeDefinition as A}from"./components/env.mjs";import{env as j}from"./helpers/automd-generator.mjs";import"./babel/index.mjs";import{EnvDocs as M}from"./components/docs.mjs";import"./components/index.mjs";import{createTemplateReflection as N}from"./helpers/template-helpers.mjs";import"./helpers/index.mjs";import{createComponent as P}from"@alloy-js/core/jsx-runtime";import{toArray as F}from"@stryke/convert/to-array";import I from"defu";import{LogLevelLabel as L}from"@storm-software/config-tools/types";import{isParentPath as R}from"@stryke/path/is-parent-path";import{titleCase as z}from"@stryke/string-format/title-case";import{parseTypeDefinition as B}from"@stryke/convert/parse-type-definition";import{ENV_PREFIXES as V}from"@stryke/env/types";import{existsSync as H}from"@stryke/fs/exists";import{createDirectory as U}from"@stryke/fs/helpers";import{joinPaths as W}from"@stryke/path/join";import{constantCase as G}from"@stryke/string-format/constant-case";const K=(i={})=>[t(i.alloy),r(i.babel),{name:`env`,async config(){this.log(L.TRACE,"Providing default configuration for the Powerlines `env` build plugin.");let e={env:I(i,{types:{},prefix:[]}),transform:{babel:{plugins:[C]}}};if(e.env.types)e.env.types=B(e.env.types);else{this.log(L.WARN,"The `env.types` configuration parameter was not provided. Please ensure this is expected.");let t=await f(this);e.env.types=B(`${t.file}#${t.name}`)}if(e.env.secrets)e.env.secrets=B(e.env.secrets);else{let t=await h(this);e.env.secrets=B(`${t.file}#${t.name}`)}return e.env.prefix=F(e.env.prefix??[]).reduce((e,t)=>{let n=G(t);return e.includes(n)||e.push(n),e},[...V,`POWERLINES_`]),e.env.prefix=e.env.prefix.reduce((e,t)=>(e.includes(t.replace(/_$/g,``))||e.push(t.replace(/_$/g,``)),e),[]),e},async configResolved(){if(this.log(L.TRACE,`Environment plugin configuration has been resolved for the Powerlines project.`),this.config.env.inject??=this.config.projectType===`application`,this.env=I({parsed:await E(this,this.config.env)},this.env??{},{types:{env:{}},used:{env:{},secrets:{}},parsed:{},injected:{}}),this.config.command!==`prepare`&&this.persistedMeta?.checksum===this.meta.checksum&&H(m(this,`env`)))this.log(L.TRACE,`Skipping reflection initialization as the meta checksum has not changed.`),this.env.types.env=await _(this,`env`),H(p(this,`env`))&&(this.env.used.env=await g(this)),H(m(this,`secrets`))&&(this.env.types.secrets=await _(this,`secrets`)),H(p(this,`secrets`))&&(this.env.used.secrets=await v(this));else{if(this.env.types.env=await u(this,this.config.env.types?.file?R(this.config.env.types?.file,this.workspaceConfig.workspaceRoot)?this.config.env.types?.file:W(this.config.projectRoot,this.config.env.types?.file):void 0,this.config.env.types?.name),!this.env.types.env)throw Error(`Failed to find the environment configuration type reflection in the context.`);if(await S(this,this.env.types.env,`env`),this.env.types.secrets=await d(this,this.config.env.secrets?.file?R(this.config.env.secrets?.file,this.workspaceConfig.workspaceRoot)?this.config.env.secrets?.file:W(this.config.projectRoot,this.config.env.secrets?.file):void 0,this.config.env.secrets?.name),!this.env.types.secrets)throw Error(`Failed to find the secrets configuration type reflection in the context.`);await S(this,this.env.types.secrets,`secrets`),this.log(L.TRACE,`Resolved ${this.env.types.env.getProperties().length??0} environment configuration parameters and ${this.env.types.secrets?.getProperties().length??0} secret configuration parameters`);let t=this.env.types.env.getProperties().filter(e=>e.getAlias().length>0);Object.entries(await E(this,this.config.env)).forEach(([e,n])=>{let r=this.config.env.prefix.reduce((t,n)=>e.replace(/_$/g,``).startsWith(n)?e.replace(/_$/g,``).slice(n.length):t,e),i=t.find(e=>e?.getAlias().reverse().includes(r));(this.env.types.env?.hasProperty(r)||i)&&this.env.types.env.getProperty(r).setDefaultValue(n)}),this.env.used.env=new e.ReflectionClass({kind:e.ReflectionKind.objectLiteral,typeName:`Env`,description:`An object containing the environment configuration parameters used by the ${this.config.name?`${this.config.name} application`:`application`}.`,types:[]},this.env.types.env),await b(this,this.env.used.env,`env`),this.env.types.secrets&&(await S(this,this.env.types.secrets,`secrets`),this.env.used.secrets=new e.ReflectionClass({kind:e.ReflectionKind.objectLiteral,typeName:`Secrets`,description:`An object containing the secret configuration parameters used by the ${this.config.name?`${this.config.name} application`:`application`}.`,types:[]},this.env.types.secrets),await b(this,this.env.used.secrets,`secrets`))}},async prepare(){let e=this;return this.log(L.TRACE,`Preparing the Environment runtime artifacts for the Powerlines project.`),this.render(P(k,{get defaultConfig(){return e.config.env.defaultConfig}}))},async docs(){this.log(L.TRACE,`Writing Environment documentation for the Powerlines project artifacts.`);let t=W(this.config.projectRoot,`docs`,`generated`);H(t)||await U(t);let n=await _(this,`env`),r=W(t,`env.md`);this.log(L.TRACE,`Documenting environment variables configuration in "${r}"`),await this.fs.write(r,`<!-- Generated by ${z(this.config.framework)||`Powerlines`} -->
+import { type_exports } from "./deepkit/src/vendor/type.mjs";
+import src_default$1 from "./plugin-alloy/src/index.mjs";
+import src_default$2 from "./plugin-automd/src/index.mjs";
+import src_default$3 from "./plugin-babel/src/index.mjs";
+import { BaseEnv, BaseSecrets, createEnvReflection, createSecretsReflection, mergeEnvReflections, mergeSecretsReflections, reflectEnv, reflectSecrets } from "./helpers/reflect.mjs";
+import { getEnvDefaultTypeDefinition, getEnvReflectionsPath, getEnvTypeReflectionsPath, getSecretsDefaultTypeDefinition, readEnvReflection, readEnvTypeReflection, readSecretsReflection, resolveRuntimeTypeFile, writeEnvReflection, writeEnvReflectionSync, writeEnvTypeReflection } from "./helpers/persistence.mjs";
+import { envBabelPlugin } from "./babel/plugin.mjs";
+import { formatEnvField, removeEnvPrefix } from "./helpers/source-file-env.mjs";
+import { loadEnv, loadEnvFromContext } from "./helpers/load.mjs";
+import { createReflectionResource } from "./helpers/create-reflection-resource.mjs";
+import { EnvBuiltin, EnvTypeDefinition } from "./components/env.mjs";
+import { env } from "./helpers/automd-generator.mjs";
+import "./babel/index.mjs";
+import { EnvDocs } from "./components/docs.mjs";
+import "./components/index.mjs";
+import { createTemplateReflection } from "./helpers/template-helpers.mjs";
+import "./helpers/index.mjs";
+import { createComponent } from "@alloy-js/core/jsx-runtime";
+import { toArray } from "@stryke/convert/to-array";
+import defu from "defu";
+import { LogLevelLabel } from "@storm-software/config-tools/types";
+import { isParentPath } from "@stryke/path/is-parent-path";
+import { titleCase } from "@stryke/string-format/title-case";
+import { parseTypeDefinition } from "@stryke/convert/parse-type-definition";
+import { ENV_PREFIXES } from "@stryke/env/types";
+import { existsSync } from "@stryke/fs/exists";
+import { createDirectory } from "@stryke/fs/helpers";
+import { joinPaths } from "@stryke/path/join";
+import { constantCase } from "@stryke/string-format/constant-case";
+
+//#region src/index.tsx
+/**
+* A Powerlines plugin to inject environment variables into the source code.
+*/
+const plugin = (options = {}) => {
+	return [
+		src_default$1(options.alloy),
+		src_default$3(options.babel),
+		{
+			name: "env",
+			async config() {
+				this.log(LogLevelLabel.TRACE, "Providing default configuration for the Powerlines `env` build plugin.");
+				const config = {
+					env: defu(options, {
+						types: {},
+						prefix: []
+					}),
+					transform: { babel: { plugins: [envBabelPlugin] } }
+				};
+				if (config.env.types) config.env.types = parseTypeDefinition(config.env.types);
+				else {
+					this.log(LogLevelLabel.WARN, "The `env.types` configuration parameter was not provided. Please ensure this is expected.");
+					const envDefaultTypeDefinition = await getEnvDefaultTypeDefinition(this);
+					config.env.types = parseTypeDefinition(`${envDefaultTypeDefinition.file}#${envDefaultTypeDefinition.name}`);
+				}
+				if (config.env.secrets) config.env.secrets = parseTypeDefinition(config.env.secrets);
+				else {
+					const secretsDefaultTypeDefinition = await getSecretsDefaultTypeDefinition(this);
+					config.env.secrets = parseTypeDefinition(`${secretsDefaultTypeDefinition.file}#${secretsDefaultTypeDefinition.name}`);
+				}
+				config.env.prefix = toArray(config.env.prefix ?? []).reduce((ret, prefix) => {
+					const formattedPrefix = constantCase(prefix);
+					if (!ret.includes(formattedPrefix)) ret.push(formattedPrefix);
+					return ret;
+				}, [...ENV_PREFIXES, "POWERLINES_"]);
+				config.env.prefix = config.env.prefix.reduce((ret, prefix) => {
+					if (!ret.includes(prefix.replace(/_$/g, ""))) ret.push(prefix.replace(/_$/g, ""));
+					return ret;
+				}, []);
+				return config;
+			},
+			async configResolved() {
+				this.log(LogLevelLabel.TRACE, `Environment plugin configuration has been resolved for the Powerlines project.`);
+				this.config.env.inject ??= this.config.projectType === "application";
+				this.env = defu({ parsed: await loadEnv(this, this.config.env) }, this.env ?? {}, {
+					types: { env: {} },
+					used: {
+						env: {},
+						secrets: {}
+					},
+					parsed: {},
+					injected: {}
+				});
+				if (this.config.command !== "prepare" && this.persistedMeta?.checksum === this.meta.checksum && existsSync(getEnvTypeReflectionsPath(this, "env"))) {
+					this.log(LogLevelLabel.TRACE, `Skipping reflection initialization as the meta checksum has not changed.`);
+					this.env.types.env = await readEnvTypeReflection(this, "env");
+					if (existsSync(getEnvReflectionsPath(this, "env"))) this.env.used.env = await readEnvReflection(this);
+					if (existsSync(getEnvTypeReflectionsPath(this, "secrets"))) this.env.types.secrets = await readEnvTypeReflection(this, "secrets");
+					if (existsSync(getEnvReflectionsPath(this, "secrets"))) this.env.used.secrets = await readSecretsReflection(this);
+				} else {
+					this.env.types.env = await reflectEnv(this, this.config.env.types?.file ? isParentPath(this.config.env.types?.file, this.workspaceConfig.workspaceRoot) ? this.config.env.types?.file : joinPaths(this.config.projectRoot, this.config.env.types?.file) : void 0, this.config.env.types?.name);
+					if (!this.env.types.env) throw new Error("Failed to find the environment configuration type reflection in the context.");
+					await writeEnvTypeReflection(this, this.env.types.env, "env");
+					this.env.types.secrets = await reflectSecrets(this, this.config.env.secrets?.file ? isParentPath(this.config.env.secrets?.file, this.workspaceConfig.workspaceRoot) ? this.config.env.secrets?.file : joinPaths(this.config.projectRoot, this.config.env.secrets?.file) : void 0, this.config.env.secrets?.name);
+					if (!this.env.types.secrets) throw new Error("Failed to find the secrets configuration type reflection in the context.");
+					await writeEnvTypeReflection(this, this.env.types.secrets, "secrets");
+					this.log(LogLevelLabel.TRACE, `Resolved ${this.env.types.env.getProperties().length ?? 0} environment configuration parameters and ${this.env.types.secrets?.getProperties().length ?? 0} secret configuration parameters`);
+					const envWithAlias = this.env.types.env.getProperties().filter((prop) => prop.getAlias().length > 0);
+					Object.entries(await loadEnv(this, this.config.env)).forEach(([key, value]) => {
+						const unprefixedKey = this.config.env.prefix.reduce((ret, prefix) => {
+							if (key.replace(/_$/g, "").startsWith(prefix)) return key.replace(/_$/g, "").slice(prefix.length);
+							return ret;
+						}, key);
+						const aliasKey = envWithAlias.find((prop) => prop?.getAlias().reverse().includes(unprefixedKey));
+						if (this.env.types.env?.hasProperty(unprefixedKey) || aliasKey) this.env.types.env.getProperty(unprefixedKey).setDefaultValue(value);
+					});
+					this.env.used.env = new type_exports.ReflectionClass({
+						kind: type_exports.ReflectionKind.objectLiteral,
+						typeName: "Env",
+						description: `An object containing the environment configuration parameters used by the ${this.config.name ? `${this.config.name} application` : "application"}.`,
+						types: []
+					}, this.env.types.env);
+					await writeEnvReflection(this, this.env.used.env, "env");
+					if (this.env.types.secrets) {
+						await writeEnvTypeReflection(this, this.env.types.secrets, "secrets");
+						this.env.used.secrets = new type_exports.ReflectionClass({
+							kind: type_exports.ReflectionKind.objectLiteral,
+							typeName: "Secrets",
+							description: `An object containing the secret configuration parameters used by the ${this.config.name ? `${this.config.name} application` : "application"}.`,
+							types: []
+						}, this.env.types.secrets);
+						await writeEnvReflection(this, this.env.used.secrets, "secrets");
+					}
+				}
+			},
+			async prepare() {
+				const _self$ = this;
+				this.log(LogLevelLabel.TRACE, `Preparing the Environment runtime artifacts for the Powerlines project.`);
+				return this.render(createComponent(EnvBuiltin, { get defaultConfig() {
+					return _self$.config.env.defaultConfig;
+				} }));
+			},
+			async docs() {
+				this.log(LogLevelLabel.TRACE, "Writing Environment documentation for the Powerlines project artifacts.");
+				const outputPath = joinPaths(this.config.projectRoot, "docs", "generated");
+				if (!existsSync(outputPath)) await createDirectory(outputPath);
+				const reflection = await readEnvTypeReflection(this, "env");
+				const envDocFile = joinPaths(outputPath, "env.md");
+				this.log(LogLevelLabel.TRACE, `Documenting environment variables configuration in "${envDocFile}"`);
+				await this.fs.write(envDocFile, `<!-- Generated by ${titleCase(this.config.framework) || "Powerlines"} -->
 
 Below is a list of environment variables used by the [${this.packageJson.name}](https://www.npmjs.com/package/${this.packageJson.name}) package. These values can be updated in the \`.env\` file in the root of the project. The variables in the list below are used as configuration parameters to drive the processing of the application. The data contained in these variables are **not** considered sensitive or confidential. Any values provided in these variables will be available in plain text to the public.
 
 | Name | Description | Type | Default Value | Required |
 | ---- | ----------- | ---- | ------------- | :------: |
-${n.getProperties().filter(e=>e.getNameAsString()!==`__POWERLINES_INJECTED__`).sort((e,t)=>e.getNameAsString().localeCompare(t.getNameAsString())).map(t=>`| ${t.getNameAsString().trim()} | ${(t.getDescription()?.replaceAll(`\r`,``)?.replaceAll(`
-`,``)??``).trim()} | ${(0,e.stringifyType)(t.getType()).trim().replaceAll(` | `,`, or `)} | ${t.hasDefault()?String(t.getDefaultValue())?.includes(`"`)?t.getDefaultValue():`\`${t.getDefaultValue()}\``:``} | ${t.isValueRequired()?``:`✔`} |`).join(`
-`)}
-`)},async buildEnd(){let e=p(this,`env`);this.log(L.TRACE,`Writing env reflection types to ${e}.`),await b(this,this.env.used.env,`env`)}},{name:`env:automd-generator`,config(){return{automd:I(i.automd??{},{generators:{env:j(this)}})}}},{name:`env:vite`,vite:{configResolved(){return{envPrefix:this.config?.env?.prefix}}}},n(i.automd)];var q=K;export{i as BaseEnv,a as BaseSecrets,k as EnvBuiltin,M as EnvDocs,A as EnvTypeDefinition,o as createEnvReflection,O as createReflectionResource,s as createSecretsReflection,N as createTemplateReflection,q as default,C as envBabelPlugin,w as formatEnvField,f as getEnvDefaultTypeDefinition,p as getEnvReflectionsPath,m as getEnvTypeReflectionsPath,h as getSecretsDefaultTypeDefinition,E as loadEnv,D as loadEnvFromContext,c as mergeEnvReflections,l as mergeSecretsReflections,K as plugin,g as readEnvReflection,_ as readEnvTypeReflection,v as readSecretsReflection,u as reflectEnv,d as reflectSecrets,T as removeEnvPrefix,y as resolveRuntimeTypeFile,b as writeEnvReflection,x as writeEnvReflectionSync,S as writeEnvTypeReflection};
+${reflection.getProperties().filter((property) => property.getNameAsString() !== "__POWERLINES_INJECTED__").sort((a, b) => a.getNameAsString().localeCompare(b.getNameAsString())).map((reflectionProperty) => {
+					return `| ${reflectionProperty.getNameAsString().trim()} | ${(reflectionProperty.getDescription()?.replaceAll("\r", "")?.replaceAll("\n", "") ?? "").trim()} | ${(0, type_exports.stringifyType)(reflectionProperty.getType()).trim().replaceAll(" | ", ", or ")} | ${reflectionProperty.hasDefault() ? String(reflectionProperty.getDefaultValue())?.includes("\"") ? reflectionProperty.getDefaultValue() : `\`${reflectionProperty.getDefaultValue()}\`` : ""} | ${reflectionProperty.isValueRequired() ? "" : "✔"} |`;
+				}).join("\n")}
+`);
+			},
+			async buildEnd() {
+				const reflectionPath = getEnvReflectionsPath(this, "env");
+				this.log(LogLevelLabel.TRACE, `Writing env reflection types to ${reflectionPath}.`);
+				await writeEnvReflection(this, this.env.used.env, "env");
+			}
+		},
+		{
+			name: "env:automd-generator",
+			config() {
+				return { automd: defu(options.automd ?? {}, { generators: { "env": env(this) } }) };
+			}
+		},
+		{
+			name: "env:vite",
+			vite: { configResolved() {
+				return { envPrefix: this.config?.env?.prefix };
+			} }
+		},
+		src_default$2(options.automd)
+	];
+};
+var src_default = plugin;
+
+//#endregion
+export { BaseEnv, BaseSecrets, EnvBuiltin, EnvDocs, EnvTypeDefinition, createEnvReflection, createReflectionResource, createSecretsReflection, createTemplateReflection, src_default as default, envBabelPlugin, formatEnvField, getEnvDefaultTypeDefinition, getEnvReflectionsPath, getEnvTypeReflectionsPath, getSecretsDefaultTypeDefinition, loadEnv, loadEnvFromContext, mergeEnvReflections, mergeSecretsReflections, plugin, readEnvReflection, readEnvTypeReflection, readSecretsReflection, reflectEnv, reflectSecrets, removeEnvPrefix, resolveRuntimeTypeFile, writeEnvReflection, writeEnvReflectionSync, writeEnvTypeReflection };

package/dist/plugin-alloy/src/core/components/output.cjs

@@ -1 +1,45 @@
-const e=require(`../../../../_virtual/rolldown_runtime.cjs`),t=require(`../contexts/context.cjs`);let n=require(`@alloy-js/core/jsx-runtime`),r=require(`@alloy-js/core`),i=require(`@stryke/path/replace`);function a(e){let[{children:a,context:o,meta:s,basePath:c},l]=(0,r.splitProps)(e,[`children`,`context`,`meta`,`basePath`]),u=(0,r.ref)(o),d=(0,r.ref)(s??{}),f=(0,r.computed)(()=>c?(0,i.replacePath)(c,u.value.workspaceConfig.workspaceRoot):u.value.workspaceConfig.workspaceRoot);return(0,n.createComponent)(r.Output,(0,n.mergeProps)(l,{get basePath(){return f.value},get children(){return(0,n.createComponent)(t.PowerlinesContext.Provider,{value:{ref:u,meta:d},get children(){return(0,n.createComponent)(r.Show,{get when(){return!!u.value},children:a})}})}}))}exports.Output=a;
+const require_rolldown_runtime = require('../../../../_virtual/rolldown_runtime.cjs');
+const require_context = require('../contexts/context.cjs');
+let __alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
+let __alloy_js_core = require("@alloy-js/core");
+let __stryke_path_replace = require("@stryke/path/replace");
+
+//#region ../plugin-alloy/src/core/components/output.tsx
+/**
+* Output component for rendering the Powerlines plugin's output files via templates.
+*/
+function Output(props) {
+	const [{ children, context, meta, basePath }, rest] = (0, __alloy_js_core.splitProps)(props, [
+		"children",
+		"context",
+		"meta",
+		"basePath"
+	]);
+	const contextRef = (0, __alloy_js_core.ref)(context);
+	const metaRef = (0, __alloy_js_core.ref)(meta ?? {});
+	const basePathRef = (0, __alloy_js_core.computed)(() => basePath ? (0, __stryke_path_replace.replacePath)(basePath, contextRef.value.workspaceConfig.workspaceRoot) : contextRef.value.workspaceConfig.workspaceRoot);
+	return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Output, (0, __alloy_js_core_jsx_runtime.mergeProps)(rest, {
+		get basePath() {
+			return basePathRef.value;
+		},
+		get children() {
+			return (0, __alloy_js_core_jsx_runtime.createComponent)(require_context.PowerlinesContext.Provider, {
+				value: {
+					ref: contextRef,
+					meta: metaRef
+				},
+				get children() {
+					return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+						get when() {
+							return Boolean(contextRef.value);
+						},
+						children
+					});
+				}
+			});
+		}
+	}));
+}
+
+//#endregion
+exports.Output = Output;

package/dist/plugin-alloy/src/core/components/output.mjs

@@ -1 +1,44 @@
-import{PowerlinesContext as e}from"../contexts/context.mjs";import{createComponent as t,mergeProps as n}from"@alloy-js/core/jsx-runtime";import{Output as r,Show as i,computed as a,ref as o,splitProps as s}from"@alloy-js/core";import{replacePath as c}from"@stryke/path/replace";function l(l){let[{children:u,context:d,meta:f,basePath:p},m]=s(l,[`children`,`context`,`meta`,`basePath`]),h=o(d),g=o(f??{}),_=a(()=>p?c(p,h.value.workspaceConfig.workspaceRoot):h.value.workspaceConfig.workspaceRoot);return t(r,n(m,{get basePath(){return _.value},get children(){return t(e.Provider,{value:{ref:h,meta:g},get children(){return t(i,{get when(){return!!h.value},children:u})}})}}))}export{l as Output};
+import { PowerlinesContext } from "../contexts/context.mjs";
+import { createComponent, mergeProps } from "@alloy-js/core/jsx-runtime";
+import { Output, Show, computed, ref, splitProps } from "@alloy-js/core";
+import { replacePath } from "@stryke/path/replace";
+
+//#region ../plugin-alloy/src/core/components/output.tsx
+/**
+* Output component for rendering the Powerlines plugin's output files via templates.
+*/
+function Output$1(props) {
+	const [{ children, context, meta, basePath }, rest] = splitProps(props, [
+		"children",
+		"context",
+		"meta",
+		"basePath"
+	]);
+	const contextRef = ref(context);
+	const metaRef = ref(meta ?? {});
+	const basePathRef = computed(() => basePath ? replacePath(basePath, contextRef.value.workspaceConfig.workspaceRoot) : contextRef.value.workspaceConfig.workspaceRoot);
+	return createComponent(Output, mergeProps(rest, {
+		get basePath() {
+			return basePathRef.value;
+		},
+		get children() {
+			return createComponent(PowerlinesContext.Provider, {
+				value: {
+					ref: contextRef,
+					meta: metaRef
+				},
+				get children() {
+					return createComponent(Show, {
+						get when() {
+							return Boolean(contextRef.value);
+						},
+						children
+					});
+				}
+			});
+		}
+	}));
+}
+
+//#endregion
+export { Output$1 as Output };

package/dist/plugin-alloy/src/core/contexts/context.cjs

@@ -1 +1,11 @@
-const e=require(`../../../../_virtual/rolldown_runtime.cjs`);let t=require(`@alloy-js/core`);const n=(0,t.createNamedContext)(`powerlines`);exports.PowerlinesContext=n;
+const require_rolldown_runtime = require('../../../../_virtual/rolldown_runtime.cjs');
+let __alloy_js_core = require("@alloy-js/core");
+
+//#region ../plugin-alloy/src/core/contexts/context.ts
+/**
+* The Powerlines context used in template rendering.
+*/
+const PowerlinesContext = (0, __alloy_js_core.createNamedContext)("powerlines");
+
+//#endregion
+exports.PowerlinesContext = PowerlinesContext;

package/dist/plugin-alloy/src/core/contexts/context.mjs

@@ -1 +1,10 @@
-import{createNamedContext as e}from"@alloy-js/core";const t=e(`powerlines`);export{t as PowerlinesContext};
+import { createNamedContext } from "@alloy-js/core";
+
+//#region ../plugin-alloy/src/core/contexts/context.ts
+/**
+* The Powerlines context used in template rendering.
+*/
+const PowerlinesContext = createNamedContext("powerlines");
+
+//#endregion
+export { PowerlinesContext };