@powerlines/plugin-env 0.14.4 → 0.14.5

package/dist/env-CgSzbXBL.cjs

@@ -0,0 +1,34 @@
+const e=require(`./create-reflection-resource-I684bqD1.cjs`);let t=require(`defu`);t=e.O(t);let n=require(`@stryke/string-format/title-case`),r=require(`@stryke/type-checks/is-null`),i=require(`@alloy-js/core`),a=require(`@alloy-js/typescript`),o=require(`@powerlines/alloy/core/contexts/context`),s=require(`@powerlines/alloy/helpers/refkey`),c=require(`@powerlines/alloy/typescript/components/builtin-file`),l=require(`@powerlines/alloy/typescript/components/tsdoc`),u=require(`@powerlines/alloy/typescript/components/typescript-interface`),d=require(`@powerlines/alloy/typescript/components/typescript-object`),f=require(`@alloy-js/core/jsx-runtime`);function p(e){let[{defaultValue:t,reflection:n}]=(0,i.splitProps)(e,[`defaultValue`,`reflection`]),r=(0,o.usePowerlines)();return(0,f.jsxs)(f.Fragment,{children:[(0,f.jsx)(u.TypeScriptInterface,{name:` EnvBase`,extends:[`EnvInterface`],defaultValue:t,reflection:n,export:!0}),(0,f.jsx)(`hbr`,{}),(0,f.jsx)(`hbr`,{}),(0,f.jsx)(a.TypeDeclaration,{name:`Env`,export:!0,children:i.code` {
+    [Key in keyof EnvBase as Key ${r?.config.env.prefix.map(e=>`| \`${e.replace(/_$/g,``)}_\${Key}\``).join(` `)}]: EnvBase[Key];
+}
+`})]})}function m(e){let[{context:t,name:n}]=(0,i.splitProps)(e,[`context`,`name`]);return t?i.code`propertyName === "${n}" || propertyName.replace(/^(${t.config.env.prefix.sort((e,t)=>e.startsWith(t)?-1:t.startsWith(e)?1:e.localeCompare(t)).map(e=>`${e.replace(/_$/,``)}_`).join(`|`)})/g, "").toLowerCase().replace(/[\\s\\-_]+/g, "") === "${n.toLowerCase().replace(/[\s\-_]+/g,``)}"`:null}function h(e){let[{context:t,property:n,index:r}]=(0,i.splitProps)(e,[`context`,`property`,`index`]);return t?(0,f.jsx)(f.Fragment,{children:r===0?(0,f.jsx)(a.IfStatement,{condition:(0,f.jsxs)(f.Fragment,{children:[(0,f.jsx)(m,{name:n.getNameAsString(),context:t}),(0,f.jsxs)(i.Show,{when:n.getAlias()&&n.getAlias().length>0,children:[i.code` || `,(0,f.jsx)(i.For,{each:n.getAlias(),joiner:i.code` || `,children:e=>(0,f.jsx)(m,{name:e,context:t})})]})]}),children:i.code`return target["${n.getNameAsString()}"];`}):(0,f.jsx)(a.ElseIfClause,{condition:(0,f.jsxs)(f.Fragment,{children:[(0,f.jsx)(m,{name:n.getNameAsString(),context:t}),(0,f.jsxs)(i.Show,{when:n.getAlias()&&n.getAlias().length>0,children:[i.code` || `,(0,f.jsx)(i.For,{each:n.getAlias(),joiner:i.code` || `,children:e=>(0,f.jsx)(m,{name:e,context:t})})]})]}),children:i.code`return target["${n.getNameAsString()}"];`})}):null}function g(e){let[{context:t,property:n,index:r}]=(0,i.splitProps)(e,[`context`,`property`,`index`]);return t?(0,f.jsx)(f.Fragment,{children:r===0?(0,f.jsx)(a.IfStatement,{condition:(0,f.jsxs)(f.Fragment,{children:[(0,f.jsx)(m,{name:n.getNameAsString(),context:t}),(0,f.jsxs)(i.Show,{when:n.getAlias()&&n.getAlias().length>0,children:[i.code` || `,(0,f.jsx)(i.For,{each:n.getAlias(),joiner:i.code` || `,children:e=>(0,f.jsx)(m,{name:e,context:t})})]})]}),children:i.code`
+    target["${n.getNameAsString()}"] = newValue;
+    return true;
+`}):(0,f.jsx)(a.ElseIfClause,{condition:(0,f.jsxs)(f.Fragment,{children:[(0,f.jsx)(m,{name:n.getNameAsString(),context:t}),(0,f.jsxs)(i.Show,{when:n.getAlias()&&n.getAlias().length>0,children:[i.code` || `,(0,f.jsx)(i.For,{each:n.getAlias(),joiner:i.code` || `,children:e=>(0,f.jsx)(m,{name:e,context:t})})]})]}),children:i.code`
+    target["${n.getNameAsString()}"] = newValue;
+    return true;
+`})}):null}const _=(0,s.refkey)(`createEnv`),v=(0,s.refkey)(`env`),y=(0,s.refkey)(`EnvSerializer`);function b(s){let[{defaultConfig:u},m]=(0,i.splitProps)(s,[`defaultConfig`]),b=(0,o.usePowerlines)(),x=(0,i.computed)(()=>b&&e.r(b,process.env)),S=e.t(b),C=(0,i.computed)(()=>new e.D.ReflectionClass({kind:e.D.ReflectionKind.objectLiteral,description:`The initial environment configuration state for the ${(0,n.titleCase)(b?.config?.name)} project.`,types:[]},S.data??void 0)),w=(0,i.computed)(()=>S.data?.getProperties().filter(e=>!e.isIgnored()).sort((e,t)=>e.getNameAsString().localeCompare(t.getNameAsString()))??[]),T=(0,i.computed)(()=>S.data?.getProperties().filter(e=>!e.isIgnored()&&!e.isReadonly()).sort((e,t)=>e.getNameAsString().localeCompare(t.getNameAsString()))??[]);return(0,f.jsxs)(c.BuiltinFile,{...m,id:`env`,description:`The Powerlines environment configuration module provides an interface to define environment configuration parameters.`,imports:(0,t.default)({"@powerlines/deepkit/vendor/type":[`Type`,`stringify`,`serializer`,`serializeFunction`,`deserializeFunction`,`ReflectionKind`,`TemplateState`,`Serializer`,`TypeProperty`,`TypePropertySignature`],"@powerlines/plugin-env/types/runtime":[{name:`EnvInterface`}]},m.imports??{}),children:[(0,f.jsxs)(i.Show,{when:!(0,r.isNull)(S.data),children:[(0,f.jsx)(p,{defaultValue:x.value,reflection:S.data}),(0,f.jsx)(`hbr`,{}),(0,f.jsx)(`hbr`,{})]}),(0,f.jsx)(d.TypescriptObject,{name:`initialEnv`,type:`Partial<EnvBase>`,defaultValue:x,reflection:C,export:!0,const:!0}),(0,f.jsx)(`hbr`,{}),(0,f.jsx)(`hbr`,{}),(0,f.jsxs)(l.TSDoc,{heading:`The environment configuration serializer for the Powerlines application.`,children:[(0,f.jsx)(l.TSDocLink,{children:`https://deepkit.io/docs/serialization/serializers`}),(0,f.jsx)(l.TSDocLink,{children:`https://github.com/marcj/untitled-code/blob/master/packages/type/src/serializer.ts#L1918`}),(0,f.jsx)(l.TSDocRemarks,{children:`This serializer is used to serialize and deserialize the Powerlines environment configuration.`})]}),(0,f.jsx)(a.ClassDeclaration,{refkey:y,name:`EnvSerializer`,extends:`Serializer`,export:!0,children:(0,f.jsx)(a.ClassMethod,{name:`constructor`,public:!0,children:i.code`
+    super("env");
+
+    this.deserializeRegistry.register(
+      ReflectionKind.boolean,
+      (type: Type, state: TemplateState) => {
+        state.addSetter(
+          \`typeof \${state.accessor.toString()} !== "boolean" ? \${state.accessor.toString()} === 1 || \${state.accessor.toString()} === "1" || \${state.accessor.toString()}.toLowerCase() === "t" || \${state.accessor.toString()}.toLowerCase() === "true" || \${state.accessor.toString()}.toLowerCase() === "y" || \${state.accessor.toString()}.toLowerCase() === "yes" : \${state.accessor.toString()}\`
+        );
+      }
+    );
+`})}),(0,f.jsx)(`hbr`,{}),(0,f.jsx)(`hbr`,{}),(0,f.jsxs)(l.TSDoc,{heading:`A {@link EnvSerializer | environment configuration serializer} instance for the Powerlines application.`,children:[(0,f.jsx)(l.TSDocLink,{children:`https://deepkit.io/docs/serialization/serializers`}),(0,f.jsx)(l.TSDocLink,{children:`https://github.com/marcj/untitled-code/blob/master/packages/type/src/serializer.ts#L1918`}),(0,f.jsx)(l.TSDocRemarks,{children:`This serializer is used to serialize and deserialize the Powerlines environment configuration.`})]}),(0,f.jsx)(a.VarDeclaration,{name:`envSerializer`,export:!1,const:!0,initializer:(0,f.jsx)(a.NewExpression,{args:[],target:`EnvSerializer`})}),(0,f.jsx)(`hbr`,{}),(0,f.jsx)(`hbr`,{}),(0,f.jsxs)(l.TSDoc,{heading:`Serialize a environment configuration object to JSON data objects (not a JSON string).`,children:[(0,f.jsx)(l.TSDocRemarks,{children:`The resulting JSON object can be stringified using JSON.stringify().`}),(0,f.jsx)(l.TSDocExample,{children:`const json = serializeEnv(env);`}),(0,f.jsx)(l.TSDocThrows,{children:`ValidationError when serialization or validation fails.`})]}),(0,f.jsx)(a.VarDeclaration,{name:`serializeEnv`,export:!0,const:!0,initializer:`serializeFunction<EnvBase>(envSerializer)`}),(0,f.jsx)(`hbr`,{}),(0,f.jsx)(`hbr`,{}),(0,f.jsxs)(l.TSDoc,{heading:`Deserialize a environment configuration object from JSON data objects to JavaScript objects, without running any validators.`,children:[(0,f.jsx)(l.TSDocRemarks,{children:`Types that are already correct will be used as-is.`}),(0,f.jsx)(l.TSDocExample,{children:`const env = deserializeEnv(json);`}),(0,f.jsx)(l.TSDocThrows,{children:`ValidationError when deserialization fails.`})]}),(0,f.jsx)(a.VarDeclaration,{name:`deserializeEnv`,export:!0,const:!0,initializer:`deserializeFunction<EnvBase>(envSerializer)`}),(0,f.jsx)(`hbr`,{}),(0,f.jsx)(`hbr`,{}),(0,f.jsxs)(l.TSDoc,{heading:`Initializes the Powerlines environment configuration module.`,children:[(0,f.jsx)(l.TSDocRemarks,{children:`This function initializes the Powerlines environment configuration object.`}),(0,f.jsx)(l.TSDocParam,{name:`environmentConfig`,children:`The dynamic/runtime configuration - this could include the current environment variables or any other environment-specific settings provided by the runtime.`}),(0,f.jsx)(l.TSDocReturns,{children:`The initialized Powerlines configuration object.`})]}),(0,f.jsx)(i.Show,{when:!!b?.entryPath,children:(0,f.jsxs)(a.FunctionDeclaration,{refkey:_,async:!1,export:!0,name:`createEnv`,parameters:[{name:`environmentConfig`,type:`Partial<Env>`,optional:!1,default:`{}`}],returnType:`Env`,children:[i.code`
+  return new Proxy<Env>(
+    deserializeEnv({
+      ...initialEnv,
+      ...environmentConfig
+    }) as Env,
+    {
+      get: (target: EnvBase, propertyName: string) => { `,(0,f.jsx)(`hbr`,{}),(0,f.jsx)(i.For,{each:w,children:(e,t)=>(0,f.jsx)(h,{index:t,context:b,property:e})}),i.code`
+            return undefined;
+          }, `,(0,f.jsx)(`hbr`,{}),(0,f.jsx)(`hbr`,{}),i.code` set: (target: EnvBase, propertyName: string, newValue: any) => { `,(0,f.jsx)(`hbr`,{}),(0,f.jsx)(i.For,{each:T,ender:i.code` else `,children:(e,t)=>(0,f.jsx)(g,{index:t,context:b,property:e})}),(0,f.jsx)(`hbr`,{}),i.code`return false;
+      }
+    }
+  );
+`]})}),(0,f.jsx)(`hbr`,{}),(0,f.jsx)(`hbr`,{}),(0,f.jsx)(`hbr`,{}),(0,f.jsx)(a.VarDeclaration,{refkey:v,name:`env`,type:`Env`,export:!0,const:!0,initializer:(0,f.jsxs)(f.Fragment,{children:[i.code`createEnv(`,u||`{}`,i.code` as Partial<Env>)`]})})]})}Object.defineProperty(exports,`n`,{enumerable:!0,get:function(){return p}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return b}});

package/dist/env-DqPOEUEu.d.mts

@@ -0,0 +1,20 @@
+import { Children } from "@alloy-js/core";
+import { BuiltinFileProps } from "@powerlines/alloy/typescript/components/builtin-file";
+import { TypeScriptInterfaceProps } from "@powerlines/alloy/typescript/components/typescript-interface";
+
+//#region src/components/env.d.ts
+
+/**
+ * Generates the environment configuration typescript definition for the Powerlines project.
+ */
+declare function EnvTypeDefinition(props: Omit<TypeScriptInterfaceProps, "name">): Children;
+interface EnvBuiltinProps extends Omit<BuiltinFileProps, "id"> {
+  defaultConfig?: Children;
+}
+/**
+ * Generates the environment configuration module for the Powerlines project.
+ */
+declare function EnvBuiltin(props: EnvBuiltinProps): Children;
+declare type __ΩEnvBuiltinProps = any[];
+//#endregion
+export { __ΩEnvBuiltinProps as i, EnvBuiltinProps as n, EnvTypeDefinition as r, EnvBuiltin as t };

package/dist/index-B_e8BwCm.d.cts

@@ -0,0 +1 @@
+export { };

package/dist/index-CW2WHUXP.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/index-DCQ5Y2ED.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/index-DWPDThxu.d.cts

@@ -0,0 +1 @@
+export { };

package/dist/index.cjs

@@ -1,10 +1,14 @@
-Object.defineProperty(exports,`__esModule`,{value:!0});const e=require(`./_virtual/rolldown_runtime.cjs`),t=require(`./deepkit/src/vendor/type.cjs`),n=require(`./helpers/reflect.cjs`),r=require(`./helpers/persistence.cjs`),i=require(`./helpers/template-helpers.cjs`),a=require(`./helpers/source-file-env.cjs`),o=require(`./helpers/load.cjs`),s=require(`./helpers/create-reflection-resource.cjs`);require(`./helpers/index.cjs`);const c=require(`./helpers/automd-generator.cjs`),l=require(`./components/docs.cjs`),u=require(`./components/env.cjs`);require(`./components/index.cjs`);const d=require(`./babel/plugin.cjs`);require(`./babel/index.cjs`);const f=require(`./alloy/src/create-plugin.cjs`),p=require(`./plugin-automd/src/index.cjs`),m=require(`./plugin-babel/src/index.cjs`);let h=require(`@stryke/string-format/title-case`),g=require(`defu`);g=e.__toESM(g);let _=require(`@stryke/convert/parse-type-definition`),v=require(`@storm-software/config-tools/types`),y=require(`@stryke/convert/to-array`),b=require(`@stryke/path/is-parent-path`),x=require(`@stryke/env/types`),S=require(`@alloy-js/core/jsx-runtime`),C=require(`@stryke/path/join`),w=require(`@stryke/fs/exists`),T=require(`@stryke/fs/helpers`),E=require(`@stryke/string-format/constant-case`);const D=f.createAlloyPlugin((e={})=>({name:`env`,async config(){this.log(v.LogLevelLabel.TRACE,"Providing default configuration for the Powerlines `env` build plugin.");let t={env:(0,g.default)(e,{types:{},prefix:[]}),transform:{babel:{plugins:[d.envBabelPlugin]}}};if(t.env.types)t.env.types=(0,_.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 r.getEnvDefaultTypeDefinition(this);t.env.types=(0,_.parseTypeDefinition)(`${e.file}#${e.name}`)}if(t.env.secrets)t.env.secrets=(0,_.parseTypeDefinition)(t.env.secrets);else{let e=await r.getSecretsDefaultTypeDefinition(this);t.env.secrets=(0,_.parseTypeDefinition)(`${e.file}#${e.name}`)}return t.env.prefix=(0,y.toArray)(t.env.prefix??[]).reduce((e,t)=>{let n=(0,E.constantCase)(t);return e.includes(n)||e.push(n),e},[...x.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,g.default)({parsed:await o.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,w.existsSync)(r.getEnvTypeReflectionsPath(this,`env`)))this.log(v.LogLevelLabel.TRACE,`Skipping reflection initialization as the meta checksum has not changed.`),this.env.types.env=await r.readEnvTypeReflection(this,`env`),(0,w.existsSync)(r.getEnvReflectionsPath(this,`env`))&&(this.env.used.env=await r.readEnvReflection(this)),(0,w.existsSync)(r.getEnvTypeReflectionsPath(this,`secrets`))&&(this.env.types.secrets=await r.readEnvTypeReflection(this,`secrets`)),(0,w.existsSync)(r.getEnvReflectionsPath(this,`secrets`))&&(this.env.used.secrets=await r.readSecretsReflection(this));else{if(this.env.types.env=await n.reflectEnv(this,this.config.env.types?.file?(0,b.isParentPath)(this.config.env.types?.file,this.workspaceConfig.workspaceRoot)?this.config.env.types?.file:(0,C.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 r.writeEnvTypeReflection(this,this.env.types.env,`env`),this.env.types.secrets=await n.reflectSecrets(this,this.config.env.secrets?.file?(0,b.isParentPath)(this.config.env.secrets?.file,this.workspaceConfig.workspaceRoot)?this.config.env.secrets?.file:(0,C.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 r.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 o.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 r.writeEnvReflection(this,this.env.used.env,`env`),this.env.types.secrets&&(await r.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 r.writeEnvReflection(this,this.env.used.secrets,`secrets`))}},render(){let e=this;return this.log(v.LogLevelLabel.TRACE,`Preparing the Environment runtime artifacts for the Powerlines project.`),(0,S.createComponent)(u.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,C.joinPaths)(this.config.projectRoot,`docs`,`generated`);(0,w.existsSync)(e)||await(0,T.createDirectory)(e);let n=await r.readEnvTypeReflection(this,`env`),i=(0,C.joinPaths)(e,`env.md`);this.log(v.LogLevelLabel.TRACE,`Documenting environment variables configuration in "${i}"`),await this.fs.write(i,`<!-- Generated by ${(0,h.titleCase)(this.config.framework)||`Powerlines`} -->
+Object.defineProperty(exports,`__esModule`,{value:!0});const e=require(`./create-reflection-resource-I684bqD1.cjs`),t=require(`./env-CgSzbXBL.cjs`),n=require(`./docs-qvDyetF0.cjs`);require(`./components-C9bYrQVK.cjs`),require(`./plugin-D5qyQPqC.cjs`),require(`./runtime-Bisl_1Ja.cjs`),require(`./types-MYBaygjr.cjs`);let r=require(`@stryke/convert/to-array`),i=require(`@stryke/fs/is-file`),a=require(`@stryke/fs/list-files`),o=require(`@stryke/path/append`),s=require(`@stryke/path/is-type`),c=require(`@stryke/path/join-paths`),ee=require(`@stryke/path/replace`),l=require(`automd`),u=require(`c12`),d=require(`defu`);d=e.O(d);let f=require(`markdown-toc`);f=e.O(f);let p=require(`@babel/core`),m=require(`@storm-software/config-tools/types`),h=require(`@stryke/path/file-path-fns`),g=require(`@stryke/path/is-parent-path`),_=require(`@stryke/type-checks/is-set-object`),v=require(`@stryke/type-checks/is-function`);require(`@stryke/type-checks/is-object`);let te=require(`@stryke/type-checks/is-set-string`),y=require(`chalk`);y=e.O(y);let b=require(`@babel/generator`);b=e.O(b),require(`@babel/parser`);let x=require(`@babel/helper-plugin-utils`);require(`@storm-software/config-tools/logger`),require(`@storm-software/config-tools/utilities/colors`),require(`@stryke/helpers/noop`);let S=require(`@stryke/string-format/title-case`),C=require(`@babel/types`);C=e.O(C);let w=require(`@stryke/type-checks/is-string`),T=require(`@stryke/convert/parse-type-definition`),E=require(`@stryke/env/types`),D=require(`@stryke/fs/exists`),O=require(`@stryke/fs/helpers`),k=require(`@stryke/path/join`),A=require(`@stryke/string-format/constant-case`),j=require(`@stryke/capnp`);j=e.O(j);let M=require(`@stryke/helpers/get-unique`),N=require(`@stryke/json/storm-json`),ne=require(`@stryke/type-checks/is-null`),re=require(`@stryke/type-checks/is-undefined`),ie=require(`@stryke/fs/buffer`),P=require(`node:fs`),F=require(`@alloy-js/core/jsx-runtime`);const I=(e={})=>({name:`automd`,async config(){let t=await(0,l.loadConfig)((0,c.joinPaths)(this.workspaceConfig.workspaceRoot,this.config.projectRoot),e);return(!t.prefix||!Array.isArray(t.prefix))&&(t.prefix=(0,r.toArray)(t.prefix??[])),t.prefix.includes(`automd`)||t.prefix.push(`automd`),t.prefix.includes(`powerlines`)||t.prefix.push(`powerlines`),{automd:(0,d.default)(t??{},{configFile:e.configFile,allowIssues:!0,dir:this.config.projectRoot,watch:!1,input:`README.md`,toc:{maxDepth:6,bullets:`-`}})}},async configResolved(){if(this.config.framework&&!(0,r.toArray)(this.config.automd.prefix).includes(this.config.framework)&&(this.config.automd.prefix=(0,r.toArray)(this.config.automd.prefix).concat(this.config.framework)),this.config.automd.configFile){let{config:e}=await(0,u.loadConfig)({cwd:this.config.automd.dir,configFile:this.config.automd.configFile,defaults:{ignore:[`**/node_modules`,`**/dist`,`**/.*`],dir:this.config.automd.dir}});this.config.automd=(0,l.resolveConfig)((0,d.default)(this.config.automd,{...e,prefix:(0,r.toArray)(e.prefix??[])}))}this.config.automd.input=(await Promise.all((0,r.toArray)(this.config.automd.input).map(async e=>e.includes(`*`)?(0,a.listFiles)((0,s.isAbsolutePath)(e)?e:(0,o.appendPath)(e,this.config.projectRoot),{ignore:this.config.automd.ignore}):(0,s.isAbsolutePath)(e)?e:(0,o.appendPath)(e,this.config.projectRoot)))).flat(),this.config.automd.output&&!(0,s.isAbsolutePath)(this.config.automd.output)&&(this.config.automd.output=(0,o.appendPath)(this.config.automd.output,this.config.projectRoot)),this.config.automd.generators??={},this.config.automd.toc!==!1&&(this.config.automd.generators.toc??={name:`toc`,generate:e=>{let t=this.config.automd.toc??{};return{contents:(0,f.default)(e.block.md,{...t,maxdepth:t.maxDepth,first1:t.firstH1}).content}}})},async docs(){await Promise.all((0,r.toArray)(this.config.automd.input).map(async e=>{let t=await this.fs.read(e);if(t){let n=await(0,l.transform)(t,this.config.automd);if(n.hasIssues&&this.config.automd.allowIssues===!1)throw Error(`AutoMD found issues in file "${e}". Please resolve the issues or set \`allowIssues\` to true in the plugin configuration to ignore them.`);n.hasChanged&&await this.fs.write((0,o.appendPath)(this.config.automd.output?(0,i.isDirectory)(this.config.automd.output)?(0,ee.replacePath)(e,this.config.automd.output):this.config.automd.output:e,this.config.projectRoot),n.contents)}}))}});var L=I;function R(e){return(0,te.isSetString)(e)?e:Array.isArray(e)&&e.length>0?R(e[0]):e.$$name||e.name?e.$$name||e.name:void 0}function z(e,t){return!!(R(t)&&e.some(e=>Array.isArray(e)&&R(e[0])===R(t)))}function B(e,t){try{return Array.isArray(t)&&t.length>0&&t[0]?(0,v.isFunction)(t[0])?t[0](e):t[0]:(0,v.isFunction)(t)?t(e):t}catch{return t[0]}}function V(e,t,n,r){if(Array.isArray(r)&&r.length>0&&r[0]){if(r.length>2&&r[2]&&(0,v.isFunction)(r[2])&&!r[2](t,n)){e.log(m.LogLevelLabel.TRACE,`Skipping filtered Babel plugin ${y.default.bold.cyanBright(R(r)||`unnamed`)} for ${n}`);return}return r.length>2?[B(e,r),r[1],r[2]]:[B(e,r),r[1],null]}return[B(e,r),{},null]}let H=b.default;`default`in H&&(H=H.default);const U=[`#00A0DD`,`#6FCE4E`,`#FBBF24`,`#F43F5E`,`#3B82F6`,`#A855F7`,`#469592`,`#288EDF`,`#10B981`,`#EF4444`,`#F0EC56`,`#F472B6`,`#22D3EE`,`#EAB308`,`#84CC16`,`#F87171`,`#0EA5E9`,`#D946EF`,`#FACC15`,`#34D399`],W=(e,t)=>(n,...r)=>e(n,` ${y.default.inverse.hex(U[t.split(``).map(e=>e.charCodeAt(0)).reduce((e,t)=>e+t,0)%U.length]||U[0])(` ${(0,S.titleCase)(t)} `)}  ${r.join(` `)} `);function G(e,t){let n=n=>(0,x.declare)((r,i,a)=>{r.cache.using(()=>n.meta.checksum),r.assertVersion(`^7.0.0-0`);let o=W(n.log,e);o(m.LogLevelLabel.TRACE,`Initializing the ${y.default.bold.cyanBright(e)} Babel plugin`);let s=t({log:o,name:e,api:r,options:i,context:n,dirname:a});return s.name=e,o(m.LogLevelLabel.TRACE,`Completed initialization of the ${y.default.bold.cyanBright(e)} Babel plugin`),s});return n.$$name=e,n}function K(e,t){ae(e.scope.getProgramParent().path,t)}function q(e){return e.get(`specifiers`).filter(Boolean).every(e=>e?.isImportSpecifier())&&e.node.importKind!==`type`&&e.node.importKind!==`typeof`}function J(e){let t=new Map;return e.traverse({ImportDeclaration(e){q(e)&&t.set(e.node.source.value,e)}}),t}function ae(e,t){J(e).get(t.module)||e.unshiftContainer(`body`,C.importDeclaration([C.importSpecifier(C.identifier(t.name||t.imported),C.identifier(t.imported))],C.stringLiteral(t.module)))}const oe=(e={})=>({name:`babel`,config(){if((0,_.isSetObject)(e))return{transform:{babel:e}}},configResolved:{order:`pre`,handler(){this.devDependencies[`@babel/core`]=`^7.28.4`,this.config.transform.babel=(0,d.default)(this.config.transform.babel??{},{plugins:[],presets:[]})}},async transform(t,n){if((0,g.isParentPath)(n,this.powerlinesPath)||t.includes(`/* @storm-ignore */`)||t.includes(`/* @storm-disable */`))return this.log(m.LogLevelLabel.TRACE,`Skipping Babel transformation for: ${n}`),{code:t,id:n};this.log(m.LogLevelLabel.TRACE,`Babel transforming file: ${n}`);let r=this.config.transform.babel.plugins.map(e=>V(this,t,n,e)).filter((e,t,n)=>e&&!z(n,e)),i=this.config.transform.babel.presets.map(e=>V(this,t,n,e)).filter((e,t,n)=>e&&!z(n,e));if(Array.isArray(r)&&r.length===0&&Array.isArray(i)&&i.length===0)return{code:t,id:n};[`ts`,`cts`,`mts`,`tsx`].includes((0,h.findFileExtensionSafe)(n))&&!z(r,`@babel/plugin-syntax-typescript`)&&!z(i,`@babel/preset-typescript`)&&r.unshift([`@babel/plugin-syntax-typescript`,{isTSX:(0,h.findFileExtension)(n)===`.tsx`}]);let a=await(0,p.transformAsync)(t,{highlightCode:!0,code:!0,ast:!1,cloneInputAst:!1,comments:!0,sourceType:`module`,configFile:!1,babelrc:!1,envName:this.config.mode,caller:{name:this.config.framework},...this.config.transform.babel??{},filename:n,plugins:r.map(t=>Array.isArray(t)&&t.length>=2?[t[0],(0,d.default)(t.length>1&&t[1]?t[1]:{},{options:e})]:t).filter(Boolean),presets:i.map(t=>Array.isArray(t)&&t.length>=2?[t[0],(0,d.default)(t.length>1&&t[1]?t[1]:{},{options:e})]:t).filter(Boolean)});if(!a?.code)throw Error(`Powerlines - Babel plugin failed to compile ${n}`);return{code:a.code,id:n}}});var se=oe;function ce(e,t){return X(e.type,t??e.getDefaultValue())}function Y(e){return`"${String(e).replaceAll(`"`,`\\"`)}"`}function X(t,n){return(0,re.isUndefined)(n)?`undefined`:(0,ne.isNull)(n)?`null`:t.kind===e.D.ReflectionKind.boolean?String(n).trim().toLowerCase()===`true`?`true`:`false`:t.kind===e.D.ReflectionKind.string||t.kind===e.D.ReflectionKind.literal&&(0,w.isString)(t.literal)?Y(n):t.kind===e.D.ReflectionKind.enum?Z(t).kind===e.D.ReflectionKind.string?Y(n):`${String(n)}`:t.kind===e.D.ReflectionKind.union?ue(t)?Y(n):`${String(n)}`:t.kind===e.D.ReflectionKind.array?Y(N.StormJSON.stringify(n)):t.kind===e.D.ReflectionKind.object||t.kind===e.D.ReflectionKind.objectLiteral?N.StormJSON.stringify(n):t.kind===e.D.ReflectionKind.property||t.kind===e.D.ReflectionKind.parameter?X(t.type,n):String(n)}function Z(t){if(t.kind!==e.D.ReflectionKind.enum)throw Error(`Expected a TypeEnum, but received ${t.kind}.`);let n=(0,M.getUniqueBy)(t.values.filter(e=>e!=null),t=>(0,w.isString)(t)?{kind:e.D.ReflectionKind.string}:{kind:e.D.ReflectionKind.number});if(n.length===0)throw Error(`No valid enum members could be found.`);return n[0]&&(0,w.isString)(n[0])?{kind:e.D.ReflectionKind.string}:{kind:e.D.ReflectionKind.number}}function le(t){if(t.kind===e.D.ReflectionKind.union&&t.types.length>0)return(0,M.getUniqueBy)(t.types,e=>e.kind);throw Error(`Expected a TypeUnion, but received ${t.kind}.`)}function ue(t){return le(t).some(t=>t.kind===e.D.ReflectionKind.string||t.kind===e.D.ReflectionKind.literal&&(0,w.isString)(t.literal))}const Q=G(`env`,({log:t,context:n})=>{function r(e,r,i=!1){let a=n.env.types.env?.getProperties().filter(e=>e.getAlias().length>0);if(e.name){let o=n.config.env.prefix.find(t=>e.name&&e.name.startsWith(t)&&(n.env.types.env?.hasProperty(e.name.replace(`${t}_`,``))||a.some(n=>n.getAlias().includes(e.name.replace(`${t}_`,``))))),s=e.name;if(o&&(s=e.name.replace(`${o}_`,``)),t(m.LogLevelLabel.TRACE,`Environment variable ${s} found in ${r.filename||`unknown file`}.`),n.env.types.env?.hasProperty(s)||a.some(e=>e.getAlias().includes(s))){let e=n.env.types.env.hasProperty(s)?n.env.types.env.getProperty(s):a.find(e=>e.getAlias().includes(s));if(!e||e.isIgnored())return;if(n.env.used.env.hasProperty(s)||n.env.used.env.addProperty(e.property),n.config.env.inject&&i){let t=n.env.parsed?.[s];if(t===void 0){let e=n.config.env.prefix.find(e=>n.env.parsed[`${e.replace(/_$/g,``)}_${s}`]);e&&(t=n.env.parsed[`${e.replace(/_$/g,``)}_${s}`])}if(t??=e.getDefaultValue(),e.isValueRequired()&&t===void 0)throw Error(`Environment variable \`${s}\` is not defined in the .env configuration files`);return ce(e,t)}}else throw Error(`The "${s}" environment variable is not defined in the \`env\` type definition, but is used in the source code file ${r.filename?r.filename:`unknown`}.
+
+          The following environment configuration names are defined in the \`env\` type definition: \n${n.env.types.env?.getPropertyNames().sort((e,t)=>String(e).localeCompare(String(t))).map(e=>` - ${String(e)} ${a.some(t=>t.getNameAsString()===String(e)&&t.getAlias().length>0)?`(Alias: ${a?.find(t=>t.getNameAsString()===String(e))?.getAlias().join(`, `)})`:``}`).join(`
+`)} \n\nUsing the following env prefix: \n${n.config.env.prefix.map(e=>` - ${e}`).join(`
+`)} \n\nPlease check your \`env\` configuration option. If you are using a custom dotenv type definition, please make sure that the configuration names match the ones in the code. \n\n`)}}return{visitor:{MemberExpression(e,t){if(e.get(`object`)?.get(`property`)?.isIdentifier({name:`env`})&&e.get(`object`)?.get(`object`)?.isIdentifier({name:`$storm`})&&e.get(`property`)?.isIdentifier()){let n=e.get(`property`)?.node;r(n,t,!1),e.replaceWithSourceString(`env.${n.name}`),K(e,{module:`storm:env`,name:`env`,imported:`env`})}else if(e.get(`object`)?.get(`property`)?.isIdentifier({name:`env`})&&e.get(`object`)?.get(`object`)?.isCallExpression({callee:{name:`useStorm`,type:`Identifier`}})&&e.get(`property`)?.isIdentifier()){let n=e.get(`property`)?.node;r(n,t,!1),e.replaceWithSourceString(`env.${n.name}`),K(e,{module:`storm:env`,name:`env`,imported:`env`})}else if(e.get(`object`)?.get(`property`)?.isIdentifier({name:`env`})&&e.get(`object`)?.get(`object`)?.isIdentifier({name:`process`})&&e.get(`property`)?.isIdentifier()){let n=e.get(`property`)?.node;if(!n.name)return;r(n,t,!1),e.replaceWithSourceString(`env.${n.name}`),K(e,{module:`storm:env`,name:`env`,imported:`env`})}else if(e.get(`object`)?.get(`property`)?.isIdentifier({name:`env`})&&e.get(`object`)?.get(`object`)?.isMetaProperty()&&e.get(`property`)?.isIdentifier()){let n=e.get(`property`)?.node;if(!n.name)return;r(n,t,!1),e.replaceWithSourceString(`env.${n.name}`),K(e,{module:`storm:env`,name:`env`,imported:`env`})}}},post(){t(m.LogLevelLabel.TRACE,`Adding environment variables from ${this.filename||`unknown file`} to env.json.`);let r=e.D.ReflectionClass.from({kind:e.D.ReflectionKind.objectLiteral,description:`An object containing the environment variables used by the application.`,types:[]}),i=e.s(n,`env`);i&&(0,P.existsSync)(i)&&(t(m.LogLevelLabel.TRACE,`Environment reflection file found at ${i}, reading existing reflection.`),r=(0,e.D.resolveClassType)((0,e.D.deserializeType)(e.E(new j.Message((0,ie.readFileBufferSync)(i),!1).getRoot(e.T).types)))),t(m.LogLevelLabel.TRACE,`Adding new variables to env reflection at ${i}.`),r.getProperties().filter(e=>e.getNameAsString()&&!n.env.used.env.hasProperty(e.getNameAsString())).forEach(e=>{n.env.used.env.addProperty({...e,name:e.getNameAsString(),description:e.getDescription()??`The ${e.getNameAsString()} variable.`,default:e.getDefaultValue(),optional:e.isOptional()?!0:void 0,readonly:e.isReadonly()?!0:void 0,visibility:e.getVisibility(),type:e.getType(),tags:e.getTags()})})}}}),de=e=>(0,l.defineGenerator)({name:`env`,async generate(){let t=(0,c.joinPaths)(e.config.projectRoot,`docs`,`generated`,`env.md`);return e.fs.existsSync(t)?{contents:await e.fs.read(t)||``}:{contents:``}}});async function fe(t,n){let r=await e.d(t,n);return r.getProperties().forEach(e=>{e.getAlias().filter(Boolean).forEach(t=>{r.addProperty({name:t,optional:e.isOptional()?!0:void 0,readonly:e.isReadonly()?!0:void 0,description:e.getDescription(),visibility:e.getVisibility(),type:e.getType(),default:e.getDefaultValue(),tags:{hidden:e.isHidden(),ignore:e.isIgnored(),internal:e.isInternal(),alias:e.getAlias().filter(e=>e!==t).concat(e.name),title:e.getTitle()||(0,S.titleCase)(e.name),readonly:e.isReadonly(),permission:e.getPermission(),domain:e.getDomain()}})})}),r}const $=(n={})=>[se(n.babel),{name:`env`,async config(){this.log(m.LogLevelLabel.TRACE,"Providing default configuration for the Powerlines `env` build plugin.");let t={env:(0,d.default)(n,{types:{},prefix:[]}),transform:{babel:{plugins:[Q]}}};if(t.env.types)t.env.types=(0,T.parseTypeDefinition)(t.env.types);else{this.log(m.LogLevelLabel.WARN,"The `env.types` configuration parameter was not provided. Please ensure this is expected.");let n=await e.o(this);t.env.types=(0,T.parseTypeDefinition)(`${n.file}#${n.name}`)}if(t.env.secrets)t.env.secrets=(0,T.parseTypeDefinition)(t.env.secrets);else{let n=await e.l(this);t.env.secrets=(0,T.parseTypeDefinition)(`${n.file}#${n.name}`)}return t.env.prefix=(0,r.toArray)(t.env.prefix??[]).reduce((e,t)=>{let n=(0,A.constantCase)(t);return e.includes(n)||e.push(n),e},[...E.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(m.LogLevelLabel.TRACE,`Environment plugin configuration has been resolved for the Powerlines project.`),this.config.env.inject??=this.config.projectType===`application`,this.env=(0,d.default)({parsed:await e.n(this,this.config.env)},this.env??{},{types:{env:{}},used:{env:{},secrets:{}},parsed:{},injected:{}}),this.config.command!==`prepare`&&this.persistedMeta?.checksum===this.meta.checksum&&(0,D.existsSync)(e.c(this,`env`)))this.log(m.LogLevelLabel.TRACE,`Skipping reflection initialization as the meta checksum has not changed.`),this.env.types.env=await e.d(this,`env`),(0,D.existsSync)(e.s(this,`env`))&&(this.env.used.env=await e.u(this)),(0,D.existsSync)(e.c(this,`secrets`))&&(this.env.types.secrets=await e.d(this,`secrets`)),(0,D.existsSync)(e.s(this,`secrets`))&&(this.env.used.secrets=await e.f(this));else{if(this.env.types.env=await e.C(this,this.config.env.types?.file?(0,g.isParentPath)(this.config.env.types?.file,this.workspaceConfig.workspaceRoot)?this.config.env.types?.file:(0,k.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 e.g(this,this.env.types.env,`env`),this.env.types.secrets=await e.w(this,this.config.env.secrets?.file?(0,g.isParentPath)(this.config.env.secrets?.file,this.workspaceConfig.workspaceRoot)?this.config.env.secrets?.file:(0,k.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 e.g(this,this.env.types.secrets,`secrets`),this.log(m.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 t=this.env.types.env.getProperties().filter(e=>e.getAlias().length>0);Object.entries(await e.n(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.D.ReflectionClass({kind:e.D.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 e.m(this,this.env.used.env,`env`),this.env.types.secrets&&(await e.g(this,this.env.types.secrets,`secrets`),this.env.used.secrets=new e.D.ReflectionClass({kind:e.D.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 e.m(this,this.env.used.secrets,`secrets`))}},async prepare(){return this.log(m.LogLevelLabel.TRACE,`Preparing the Environment runtime artifacts for the Powerlines project.`),this.render((0,F.jsx)(t.t,{defaultConfig:this.config.env.defaultConfig}))},async docs(){this.log(m.LogLevelLabel.TRACE,`Writing Environment documentation for the Powerlines project artifacts.`);let t=(0,k.joinPaths)(this.config.projectRoot,`docs`,`generated`);(0,D.existsSync)(t)||await(0,O.createDirectory)(t);let n=await e.d(this,`env`),r=(0,k.joinPaths)(t,`env.md`);this.log(m.LogLevelLabel.TRACE,`Documenting environment variables configuration in "${r}"`),await this.fs.write(r,`<!-- Generated by ${(0,S.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(`
+${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.D.stringifyType)(t.getType()).trim().replaceAll(` | `,`, or `)} | ${t.hasDefault()?String(t.getDefaultValue())?.includes(`"`)?t.getDefaultValue():`\`${t.getDefaultValue()}\``:``} | ${t.isValueRequired()?``:`✔`} |`).join(`
 `)}
-`)},async buildEnd(){let e=r.getEnvReflectionsPath(this,`env`);this.log(v.LogLevelLabel.TRACE,`Writing env reflection types to ${e}.`),await r.writeEnvReflection(this,this.env.used.env,`env`)}})),O=(e={})=>[m.default(e.babel),D(e),{name:`env:automd-generator`,config(){return{automd:(0,g.default)(e.automd??{},{generators:{env:c.env(this)}})}}},{name:`env:vite`,vite:{configResolved(){return{envPrefix:this.config?.env?.prefix}}}},p.default(e.automd)];var k=O;exports.BaseEnv=n.BaseEnv,exports.BaseSecrets=n.BaseSecrets,exports.EnvBuiltin=u.EnvBuiltin,exports.EnvDocs=l.EnvDocs,exports.EnvTypeDefinition=u.EnvTypeDefinition,exports.createEnvReflection=n.createEnvReflection,exports.createReflectionResource=s.createReflectionResource,exports.createSecretsReflection=n.createSecretsReflection,exports.createTemplateReflection=i.createTemplateReflection,exports.default=k,exports.envBabelPlugin=d.envBabelPlugin,exports.formatEnvField=a.formatEnvField,exports.getEnvDefaultTypeDefinition=r.getEnvDefaultTypeDefinition,exports.getEnvReflectionsPath=r.getEnvReflectionsPath,exports.getEnvTypeReflectionsPath=r.getEnvTypeReflectionsPath,exports.getSecretsDefaultTypeDefinition=r.getSecretsDefaultTypeDefinition,exports.loadEnv=o.loadEnv,exports.loadEnvFromContext=o.loadEnvFromContext,exports.mergeEnvReflections=n.mergeEnvReflections,exports.mergeSecretsReflections=n.mergeSecretsReflections,exports.plugin=O,exports.readEnvReflection=r.readEnvReflection,exports.readEnvTypeReflection=r.readEnvTypeReflection,exports.readSecretsReflection=r.readSecretsReflection,exports.reflectEnv=n.reflectEnv,exports.reflectSecrets=n.reflectSecrets,exports.removeEnvPrefix=a.removeEnvPrefix,exports.resolveRuntimeTypeFile=r.resolveRuntimeTypeFile,exports.writeEnvReflection=r.writeEnvReflection,exports.writeEnvReflectionSync=r.writeEnvReflectionSync,exports.writeEnvTypeReflection=r.writeEnvTypeReflection;
+`)},async buildEnd(){let t=e.s(this,`env`);this.log(m.LogLevelLabel.TRACE,`Writing env reflection types to ${t}.`),await e.m(this,this.env.used.env,`env`)}},{name:`env:automd-generator`,config(){return{automd:(0,d.default)(n.automd??{},{generators:{env:de(this)}})}}},{name:`env:vite`,vite:{configResolved(){return{envPrefix:this.config?.env?.prefix}}}},L(n.automd)];var pe=$;exports.BaseEnv=e._,exports.BaseSecrets=e.v,exports.EnvBuiltin=t.t,exports.EnvDocs=n.t,exports.EnvTypeDefinition=t.n,exports.createEnvReflection=e.y,exports.createReflectionResource=e.t,exports.createSecretsReflection=e.b,exports.createTemplateReflection=fe,exports.default=pe,exports.envBabelPlugin=Q,exports.formatEnvField=e.i,exports.getEnvDefaultTypeDefinition=e.o,exports.getEnvReflectionsPath=e.s,exports.getEnvTypeReflectionsPath=e.c,exports.getSecretsDefaultTypeDefinition=e.l,exports.loadEnv=e.n,exports.loadEnvFromContext=e.r,exports.mergeEnvReflections=e.x,exports.mergeSecretsReflections=e.S,exports.plugin=$,exports.readEnvReflection=e.u,exports.readEnvTypeReflection=e.d,exports.readSecretsReflection=e.f,exports.reflectEnv=e.C,exports.reflectSecrets=e.w,exports.removeEnvPrefix=e.a,exports.resolveRuntimeTypeFile=e.p,exports.writeEnvReflection=e.m,exports.writeEnvReflectionSync=e.h,exports.writeEnvTypeReflection=e.g;

package/dist/index.d.cts

@@ -1,16 +1,189 @@
-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 { EnvDocs } from "./components/docs.cjs";
-import { EnvBuiltin, EnvBuiltinProps, EnvTypeDefinition, __ΩEnvBuiltinProps } from "./components/env.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 { envBabelPlugin } from "./babel/plugin.cjs";
+import { a as EnvType, c as __ΩEnvPluginResolvedConfig, d as type_d_exports, i as EnvPluginUserConfig, l as __ΩEnvPluginUserConfig, n as EnvPluginOptions, o as __ΩEnvPluginContext, r as EnvPluginResolvedConfig, s as __ΩEnvPluginOptions, t as EnvPluginContext, u as __ΩEnvType } from "./plugin-CPy0CKXL.cjs";
+import { t as EnvDocs } from "./docs-CdtUw4WA.cjs";
+import { i as __ΩEnvBuiltinProps, n as EnvBuiltinProps, r as EnvTypeDefinition, t as EnvBuiltin } from "./env-COWzTupf.cjs";
+import "./index-DWPDThxu.cjs";
+import { d as UnresolvedContext, i as __ΩSecretsInterface, l as Context, n as SecretsInterface, r as __ΩEnvInterface, t as EnvInterface } from "./runtime-Bo02eIQ-.cjs";
+import "./index-B_e8BwCm.cjs";
+import * as _alloy_js_core0 from "@alloy-js/core";
+import * as powerlines0 from "powerlines";
+import { Plugin } from "powerlines";
+import { TypeDefinition } from "@stryke/types/configuration";
+import { DotenvParseOutput } from "@stryke/env/types";
 
+//#region src/babel/plugin.d.ts
+declare const envBabelPlugin: powerlines0.DeclareBabelTransformPluginReturn<EnvPluginContext<EnvPluginResolvedConfig>, Record<string, any>>;
+//#endregion
+//#region src/helpers/create-reflection-resource.d.ts
+/**
+ * Creates a reflection resource for the environment configuration.
+ *
+ * @param context - The environment plugin context.
+ * @returns A resource that provides the reflection of the environment configuration.
+ */
+declare function createReflectionResource(context?: EnvPluginContext): _alloy_js_core0.Resource<type_d_exports.ReflectionClass<Record<string, any>>>;
+//#endregion
+//#region src/helpers/load.d.ts
+/**
+ * Retrieves various dotenv configuration parameters from the context.
+ *
+ * @param context - The context to retrieve the dotenv configuration from.
+ * @param parsed - The parsed dotenv configuration.
+ * @returns An object containing the dotenv configuration.
+ */
+declare function loadEnvFromContext(context: EnvPluginContext, parsed: DotenvParseOutput): {
+  APP_NAME: string | undefined;
+  APP_VERSION: string | undefined;
+  BUILD_ID: string;
+  BUILD_TIMESTAMP: string;
+  BUILD_CHECKSUM: string;
+  RELEASE_ID: string;
+  RELEASE_TAG: string;
+  DEFAULT_LOCALE: string | undefined;
+  DEFAULT_TIMEZONE: string | undefined;
+  LOG_LEVEL: "error" | "warn" | "info" | "debug" | "trace" | null;
+  ERROR_URL: string | undefined;
+  ORGANIZATION: string | undefined;
+  PLATFORM: "node" | "browser" | "neutral" | undefined;
+  MODE: "test" | "development" | "production" | undefined;
+  DEBUG: boolean;
+  STACKTRACE: boolean;
+  ENVIRONMENT: powerlines0.EnvironmentResolvedConfig;
+};
+declare function loadEnv<TEnv extends DotenvParseOutput = DotenvParseOutput>(context: EnvPluginContext, options: EnvPluginOptions): Promise<TEnv>;
+//#endregion
+//#region src/helpers/persistence.d.ts
+/**
+ * Resolves the runtime type definition file for the environment variables.
+ *
+ * @param context - The plugin context.
+ * @returns The runtime type definition file for the environment variables.
+ */
+declare function resolveRuntimeTypeFile(context: UnresolvedContext<EnvPluginResolvedConfig>): Promise<string>;
+/**
+ * Gets the default type definition for the environment variables.
+ *
+ * @param context - The plugin context.
+ * @returns The default type definition for the environment variables.
+ */
+declare function getEnvDefaultTypeDefinition(context: UnresolvedContext<EnvPluginResolvedConfig>): Promise<TypeDefinition>;
+/** Gets the default type definition for the environment secrets.
+ *
+ * @param context - The plugin context.
+ * @returns The default type definition for the environment secrets.
+ */
+declare function getSecretsDefaultTypeDefinition(context: UnresolvedContext<EnvPluginResolvedConfig>): Promise<TypeDefinition>;
+/**
+ * Gets the path to the environment type reflections.
+ *
+ * @param context - The plugin context.
+ * @param name - The name of the type reflections.
+ * @returns The path to the environment type reflections.
+ */
+declare function getEnvTypeReflectionsPath(context: Context<EnvPluginResolvedConfig>, name?: EnvType): string;
+/**
+ * Reads the environment type reflection from the file system.
+ *
+ * @param context - The plugin context.
+ * @param name - The name of the type reflections.
+ * @returns The environment type reflection.
+ */
+declare function readEnvTypeReflection(context: EnvPluginContext, name?: EnvType): Promise<type_d_exports.ReflectionClass<any>>;
+/**
+ * Writes the environment type reflection to the file system.
+ *
+ * @param context - The plugin context.
+ * @param reflection - The environment type reflection to write.
+ * @param name - The name of the type reflections.
+ */
+declare function writeEnvTypeReflection(context: EnvPluginContext, reflection: type_d_exports.ReflectionClass<any>, name?: EnvType): Promise<void>;
+declare function getEnvReflectionsPath(context: EnvPluginContext, name: EnvType): string;
+/**
+ * Reads the environment reflection data from the file system.
+ *
+ * @param context - The plugin context.
+ * @returns The environment reflection data.
+ */
+declare function readEnvReflection(context: EnvPluginContext): Promise<type_d_exports.ReflectionClass<any>>;
+/**
+ * Reads the secret environment reflection data from the file system.
+ *
+ * @param context - The plugin context.
+ * @returns The environment reflection data.
+ */
+declare function readSecretsReflection(context: EnvPluginContext): Promise<type_d_exports.ReflectionClass<any>>;
+/**
+ * Writes the environment reflection data to the file system.
+ *
+ * @param context - The plugin context.
+ * @param reflection - The reflection data to write.
+ * @param name - The name of the reflection (either "env" or "secrets").
+ */
+declare function writeEnvReflection(context: EnvPluginContext, reflection: type_d_exports.ReflectionClass<any>, name?: EnvType): Promise<void>;
+/**
+ * Writes the environment reflection data to the file system.
+ *
+ * @param context - The plugin context.
+ * @param reflection - The reflection data to write.
+ * @param name - The name of the reflection (either "env" or "secrets").
+ */
+declare function writeEnvReflectionSync(context: EnvPluginContext, reflection: type_d_exports.ReflectionClass<any>, name?: EnvType): void;
+//#endregion
+//#region src/helpers/reflect.d.ts
+declare function mergeEnvReflections(context: EnvPluginContext, reflections: type_d_exports.ReflectionClass<any>[]): type_d_exports.ReflectionClass<any>;
+declare function mergeSecretsReflections(context: EnvPluginContext, reflections: type_d_exports.ReflectionClass<any>[]): type_d_exports.ReflectionClass<any>;
+interface CreateEnvReflectionOptions {
+  type?: type_d_exports.TypeObjectLiteral | type_d_exports.TypeClass;
+  superReflection?: type_d_exports.ReflectionClass<any>;
+}
+declare class BaseEnv implements EnvInterface {
+  APP_NAME: string;
+  APP_VERSION: string;
+  BUILD_ID: string;
+  BUILD_TIMESTAMP: string;
+  BUILD_CHECKSUM: string;
+  RELEASE_ID: string;
+  RELEASE_TAG: string;
+  ORGANIZATION: string;
+  PLATFORM: "node" | "browser" | "neutral";
+  MODE: "development" | "test" | "production";
+  ENVIRONMENT: string;
+  DEBUG: boolean;
+  TEST: boolean;
+  MINIMAL: boolean;
+  NO_COLOR: boolean;
+  FORCE_COLOR: number | boolean;
+  FORCE_HYPERLINK: number | boolean;
+  STACKTRACE: boolean;
+  INCLUDE_ERROR_DATA: boolean;
+  ERROR_URL: string;
+  DEFAULT_TIMEZONE: string;
+  DEFAULT_LOCALE: string;
+  CI: boolean;
+}
+declare class BaseSecrets implements SecretsInterface {
+  ENCRYPTION_KEY: string;
+}
+declare function createEnvReflection(context: EnvPluginContext, options?: CreateEnvReflectionOptions): type_d_exports.ReflectionClass<any>;
+declare function createSecretsReflection(context: EnvPluginContext, options?: CreateEnvReflectionOptions): type_d_exports.ReflectionClass<any>;
+declare function reflectEnv(context: EnvPluginContext, file?: string, name?: string): Promise<type_d_exports.ReflectionClass<any>>;
+declare function reflectSecrets(context: EnvPluginContext, file?: string, name?: string): Promise<type_d_exports.ReflectionClass<any>>;
+declare type __ΩCreateEnvReflectionOptions = any[];
+//#endregion
+//#region src/helpers/source-file-env.d.ts
+type TReturned<TEnv> = TEnv extends string ? string : DotenvParseOutput;
+declare function removeEnvPrefix<TEnv extends DotenvParseOutput | string>(env: TEnv): TReturned<TEnv>;
+declare function formatEnvField(key: string): string;
+//#endregion
+//#region src/helpers/template-helpers.d.ts
+/**
+ * Creates the reflection data used when generating runtime template files.
+ *
+ * @param context - The context for the configuration plugin.
+ * @param name - The name of the configuration template.
+ * @returns The reflection for the specified configuration template.
+ */
+declare function createTemplateReflection(context: EnvPluginContext, name?: EnvType): Promise<type_d_exports.ReflectionClass<any>>;
+//#endregion
 //#region src/index.d.ts
 /**
  * A Powerlines plugin to inject environment variables into the source code.

package/dist/index.d.mts

@@ -1,21 +1,189 @@
-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 { EnvDocs } from "./components/docs.mjs";
-import { EnvBuiltin, EnvBuiltinProps, EnvTypeDefinition, __ΩEnvBuiltinProps } from "./components/env.mjs";
-import "./components/index.mjs";
-import { createReflectionResource } from "./helpers/create-reflection-resource.mjs";
-import { loadEnv, loadEnvFromContext } from "./helpers/load.mjs";
-import { getEnvDefaultTypeDefinition, getEnvReflectionsPath, getEnvTypeReflectionsPath, getSecretsDefaultTypeDefinition, readEnvReflection, readEnvTypeReflection, readSecretsReflection, resolveRuntimeTypeFile, writeEnvReflection, writeEnvReflectionSync, writeEnvTypeReflection } from "./helpers/persistence.mjs";
-import { BaseEnv, BaseSecrets, CreateEnvReflectionOptions, __ΩCreateEnvReflectionOptions, createEnvReflection, createSecretsReflection, mergeEnvReflections, mergeSecretsReflections, reflectEnv, reflectSecrets } from "./helpers/reflect.mjs";
-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 { envBabelPlugin } from "./babel/plugin.mjs";
-import "./babel/index.mjs";
+import { t as EnvDocs } from "./docs-CKCRAUnO.mjs";
+import { i as __ΩEnvBuiltinProps, n as EnvBuiltinProps, r as EnvTypeDefinition, t as EnvBuiltin } from "./env-DqPOEUEu.mjs";
+import "./index-CW2WHUXP.mjs";
+import { a as EnvType, c as __ΩEnvPluginResolvedConfig, d as type_d_exports, i as EnvPluginUserConfig, l as __ΩEnvPluginUserConfig, n as EnvPluginOptions, o as __ΩEnvPluginContext, r as EnvPluginResolvedConfig, s as __ΩEnvPluginOptions, t as EnvPluginContext, u as __ΩEnvType } from "./plugin-Cz3MZ6FL.mjs";
+import { d as UnresolvedContext, i as __ΩSecretsInterface, l as Context, n as SecretsInterface, r as __ΩEnvInterface, t as EnvInterface } from "./runtime-B7kcxFAf.mjs";
+import "./index-DCQ5Y2ED.mjs";
+import { DotenvParseOutput } from "@stryke/env/types";
+import * as _alloy_js_core0 from "@alloy-js/core";
+import * as powerlines0 from "powerlines";
+import { Plugin } from "powerlines";
+import { TypeDefinition } from "@stryke/types/configuration";
 
+//#region src/babel/plugin.d.ts
+declare const envBabelPlugin: powerlines0.DeclareBabelTransformPluginReturn<EnvPluginContext<EnvPluginResolvedConfig>, Record<string, any>>;
+//#endregion
+//#region src/helpers/create-reflection-resource.d.ts
+/**
+ * Creates a reflection resource for the environment configuration.
+ *
+ * @param context - The environment plugin context.
+ * @returns A resource that provides the reflection of the environment configuration.
+ */
+declare function createReflectionResource(context?: EnvPluginContext): _alloy_js_core0.Resource<type_d_exports.ReflectionClass<Record<string, any>>>;
+//#endregion
+//#region src/helpers/load.d.ts
+/**
+ * Retrieves various dotenv configuration parameters from the context.
+ *
+ * @param context - The context to retrieve the dotenv configuration from.
+ * @param parsed - The parsed dotenv configuration.
+ * @returns An object containing the dotenv configuration.
+ */
+declare function loadEnvFromContext(context: EnvPluginContext, parsed: DotenvParseOutput): {
+  APP_NAME: string | undefined;
+  APP_VERSION: string | undefined;
+  BUILD_ID: string;
+  BUILD_TIMESTAMP: string;
+  BUILD_CHECKSUM: string;
+  RELEASE_ID: string;
+  RELEASE_TAG: string;
+  DEFAULT_LOCALE: string | undefined;
+  DEFAULT_TIMEZONE: string | undefined;
+  LOG_LEVEL: "error" | "warn" | "info" | "debug" | "trace" | null;
+  ERROR_URL: string | undefined;
+  ORGANIZATION: string | undefined;
+  PLATFORM: "node" | "browser" | "neutral" | undefined;
+  MODE: "test" | "development" | "production" | undefined;
+  DEBUG: boolean;
+  STACKTRACE: boolean;
+  ENVIRONMENT: powerlines0.EnvironmentResolvedConfig;
+};
+declare function loadEnv<TEnv extends DotenvParseOutput = DotenvParseOutput>(context: EnvPluginContext, options: EnvPluginOptions): Promise<TEnv>;
+//#endregion
+//#region src/helpers/persistence.d.ts
+/**
+ * Resolves the runtime type definition file for the environment variables.
+ *
+ * @param context - The plugin context.
+ * @returns The runtime type definition file for the environment variables.
+ */
+declare function resolveRuntimeTypeFile(context: UnresolvedContext<EnvPluginResolvedConfig>): Promise<string>;
+/**
+ * Gets the default type definition for the environment variables.
+ *
+ * @param context - The plugin context.
+ * @returns The default type definition for the environment variables.
+ */
+declare function getEnvDefaultTypeDefinition(context: UnresolvedContext<EnvPluginResolvedConfig>): Promise<TypeDefinition>;
+/** Gets the default type definition for the environment secrets.
+ *
+ * @param context - The plugin context.
+ * @returns The default type definition for the environment secrets.
+ */
+declare function getSecretsDefaultTypeDefinition(context: UnresolvedContext<EnvPluginResolvedConfig>): Promise<TypeDefinition>;
+/**
+ * Gets the path to the environment type reflections.
+ *
+ * @param context - The plugin context.
+ * @param name - The name of the type reflections.
+ * @returns The path to the environment type reflections.
+ */
+declare function getEnvTypeReflectionsPath(context: Context<EnvPluginResolvedConfig>, name?: EnvType): string;
+/**
+ * Reads the environment type reflection from the file system.
+ *
+ * @param context - The plugin context.
+ * @param name - The name of the type reflections.
+ * @returns The environment type reflection.
+ */
+declare function readEnvTypeReflection(context: EnvPluginContext, name?: EnvType): Promise<type_d_exports.ReflectionClass<any>>;
+/**
+ * Writes the environment type reflection to the file system.
+ *
+ * @param context - The plugin context.
+ * @param reflection - The environment type reflection to write.
+ * @param name - The name of the type reflections.
+ */
+declare function writeEnvTypeReflection(context: EnvPluginContext, reflection: type_d_exports.ReflectionClass<any>, name?: EnvType): Promise<void>;
+declare function getEnvReflectionsPath(context: EnvPluginContext, name: EnvType): string;
+/**
+ * Reads the environment reflection data from the file system.
+ *
+ * @param context - The plugin context.
+ * @returns The environment reflection data.
+ */
+declare function readEnvReflection(context: EnvPluginContext): Promise<type_d_exports.ReflectionClass<any>>;
+/**
+ * Reads the secret environment reflection data from the file system.
+ *
+ * @param context - The plugin context.
+ * @returns The environment reflection data.
+ */
+declare function readSecretsReflection(context: EnvPluginContext): Promise<type_d_exports.ReflectionClass<any>>;
+/**
+ * Writes the environment reflection data to the file system.
+ *
+ * @param context - The plugin context.
+ * @param reflection - The reflection data to write.
+ * @param name - The name of the reflection (either "env" or "secrets").
+ */
+declare function writeEnvReflection(context: EnvPluginContext, reflection: type_d_exports.ReflectionClass<any>, name?: EnvType): Promise<void>;
+/**
+ * Writes the environment reflection data to the file system.
+ *
+ * @param context - The plugin context.
+ * @param reflection - The reflection data to write.
+ * @param name - The name of the reflection (either "env" or "secrets").
+ */
+declare function writeEnvReflectionSync(context: EnvPluginContext, reflection: type_d_exports.ReflectionClass<any>, name?: EnvType): void;
+//#endregion
+//#region src/helpers/reflect.d.ts
+declare function mergeEnvReflections(context: EnvPluginContext, reflections: type_d_exports.ReflectionClass<any>[]): type_d_exports.ReflectionClass<any>;
+declare function mergeSecretsReflections(context: EnvPluginContext, reflections: type_d_exports.ReflectionClass<any>[]): type_d_exports.ReflectionClass<any>;
+interface CreateEnvReflectionOptions {
+  type?: type_d_exports.TypeObjectLiteral | type_d_exports.TypeClass;
+  superReflection?: type_d_exports.ReflectionClass<any>;
+}
+declare class BaseEnv implements EnvInterface {
+  APP_NAME: string;
+  APP_VERSION: string;
+  BUILD_ID: string;
+  BUILD_TIMESTAMP: string;
+  BUILD_CHECKSUM: string;
+  RELEASE_ID: string;
+  RELEASE_TAG: string;
+  ORGANIZATION: string;
+  PLATFORM: "node" | "browser" | "neutral";
+  MODE: "development" | "test" | "production";
+  ENVIRONMENT: string;
+  DEBUG: boolean;
+  TEST: boolean;
+  MINIMAL: boolean;
+  NO_COLOR: boolean;
+  FORCE_COLOR: number | boolean;
+  FORCE_HYPERLINK: number | boolean;
+  STACKTRACE: boolean;
+  INCLUDE_ERROR_DATA: boolean;
+  ERROR_URL: string;
+  DEFAULT_TIMEZONE: string;
+  DEFAULT_LOCALE: string;
+  CI: boolean;
+}
+declare class BaseSecrets implements SecretsInterface {
+  ENCRYPTION_KEY: string;
+}
+declare function createEnvReflection(context: EnvPluginContext, options?: CreateEnvReflectionOptions): type_d_exports.ReflectionClass<any>;
+declare function createSecretsReflection(context: EnvPluginContext, options?: CreateEnvReflectionOptions): type_d_exports.ReflectionClass<any>;
+declare function reflectEnv(context: EnvPluginContext, file?: string, name?: string): Promise<type_d_exports.ReflectionClass<any>>;
+declare function reflectSecrets(context: EnvPluginContext, file?: string, name?: string): Promise<type_d_exports.ReflectionClass<any>>;
+declare type __ΩCreateEnvReflectionOptions = any[];
+//#endregion
+//#region src/helpers/source-file-env.d.ts
+type TReturned<TEnv> = TEnv extends string ? string : DotenvParseOutput;
+declare function removeEnvPrefix<TEnv extends DotenvParseOutput | string>(env: TEnv): TReturned<TEnv>;
+declare function formatEnvField(key: string): string;
+//#endregion
+//#region src/helpers/template-helpers.d.ts
+/**
+ * Creates the reflection data used when generating runtime template files.
+ *
+ * @param context - The context for the configuration plugin.
+ * @param name - The name of the configuration template.
+ * @returns The reflection for the specified configuration template.
+ */
+declare function createTemplateReflection(context: EnvPluginContext, name?: EnvType): Promise<type_d_exports.ReflectionClass<any>>;
+//#endregion
 //#region src/index.d.ts
 /**
  * A Powerlines plugin to inject environment variables into the source code.