@powerlines/plugin-env 0.13.106 → 0.14.0

package/dist/babel/plugin.d.mts

@@ -1,6 +1,6 @@
 import { DeclareBabelTransformPluginReturn } from "../powerlines/src/types/babel.mjs";
+import "../powerlines/src/index.mjs";
 import { EnvPluginContext, EnvPluginResolvedConfig } from "../types/plugin.mjs";
-import "../powerlines/src/types/index.mjs";
 import "../index.mjs";
 
 //#region src/babel/plugin.d.ts

package/dist/helpers/automd-generator.cjs

@@ -0,0 +1 @@
+const e=require(`../_virtual/rolldown_runtime.cjs`);let t=require(`@stryke/path/join-paths`),n=require(`automd`);const r=e=>(0,n.defineGenerator)({name:`env`,async generate(){let n=(0,t.joinPaths)(e.config.projectRoot,`docs`,`generated`,`env.md`);return e.fs.existsSync(n)?{contents:await e.fs.read(n)||``}:{contents:``}}});exports.env=r;

package/dist/helpers/automd-generator.d.cts

@@ -0,0 +1,14 @@
+import { UnresolvedContext } from "../powerlines/src/types/context.cjs";
+import * as automd0 from "automd";
+
+//#region src/helpers/automd-generator.d.ts
+
+/**
+ * AutoMD generator to generate environment variable documentation
+ *
+ * @param context - The generator context.
+ * @returns The generated documentation content.
+ */
+declare const env: (context: UnresolvedContext) => automd0.Generator;
+//#endregion
+export { env };

package/dist/helpers/automd-generator.d.mts

@@ -0,0 +1,14 @@
+import { UnresolvedContext } from "../powerlines/src/types/context.mjs";
+import * as automd0 from "automd";
+
+//#region src/helpers/automd-generator.d.ts
+
+/**
+ * AutoMD generator to generate environment variable documentation
+ *
+ * @param context - The generator context.
+ * @returns The generated documentation content.
+ */
+declare const env: (context: UnresolvedContext) => automd0.Generator;
+//#endregion
+export { env };

package/dist/helpers/automd-generator.mjs

@@ -0,0 +1 @@
+import{joinPaths as e}from"@stryke/path/join-paths";import{defineGenerator as t}from"automd";const n=n=>t({name:`env`,async generate(){let t=e(n.config.projectRoot,`docs`,`generated`,`env.md`);return n.fs.existsSync(t)?{contents:await n.fs.read(t)||``}:{contents:``}}});export{n as env};

package/dist/helpers/load.d.mts

@@ -1,6 +1,6 @@
 import { EnvironmentResolvedConfig } from "../powerlines/src/types/resolved.mjs";
+import "../powerlines/src/index.mjs";
 import { EnvPluginContext, EnvPluginOptions } from "../types/plugin.mjs";
-import "../powerlines/src/types/index.mjs";
 import { DotenvParseOutput } from "@stryke/env/types";
 
 //#region src/helpers/load.d.ts

package/dist/helpers/persistence.d.cts

@@ -1,5 +1,5 @@
-import { type_d_exports } from "../deepkit/src/vendor/type.cjs";
 import { Context, UnresolvedContext } from "../powerlines/src/types/context.cjs";
+import { type_d_exports } from "../deepkit/src/vendor/type.cjs";
 import { EnvPluginContext, EnvPluginResolvedConfig, EnvType } from "../types/plugin.cjs";
 import { TypeDefinition } from "@stryke/types/configuration";
 

package/dist/helpers/persistence.d.mts

@@ -1,5 +1,5 @@
-import { type_d_exports } from "../deepkit/src/vendor/type.mjs";
 import { Context, UnresolvedContext } from "../powerlines/src/types/context.mjs";
+import { type_d_exports } from "../deepkit/src/vendor/type.mjs";
 import { EnvPluginContext, EnvPluginResolvedConfig, EnvType } from "../types/plugin.mjs";
 import { TypeDefinition } from "@stryke/types/configuration";
 

package/dist/index.cjs

@@ -1,16 +1,10 @@
-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(`./components/docs.cjs`),l=require(`./components/env.cjs`);require(`./components/index.cjs`);const u=require(`./babel/plugin.cjs`);require(`./babel/index.cjs`);const d=require(`./alloy/src/create-plugin.cjs`),f=require(`./plugin-babel/src/index.cjs`);let p=require(`defu`);p=e.__toESM(p);let m=require(`@stryke/convert/parse-type-definition`),h=require(`@storm-software/config-tools/types`),g=require(`@stryke/convert/to-array`),_=require(`@stryke/path/is-parent-path`),v=require(`@stryke/env/types`),y=require(`@alloy-js/core/jsx-runtime`),b=require(`@stryke/path/join`),x=require(`@stryke/fs/exists`),S=require(`@stryke/fs/helpers`),C=require(`@stryke/string-format/constant-case`);const w=d.createAlloyPlugin((e={})=>({name:`env`,dependsOn:[f.default(e.babel)],async config(){this.log(h.LogLevelLabel.TRACE,"Providing default configuration for the Powerlines `env` build plugin.");let t={env:(0,p.default)(e,{types:{},prefix:[]}),transform:{babel:{plugins:[u.envBabelPlugin]}}};if(t.env.types)t.env.types=(0,m.parseTypeDefinition)(t.env.types);else{this.log(h.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,m.parseTypeDefinition)(`${e.file}#${e.name}`)}if(t.env.secrets)t.env.secrets=(0,m.parseTypeDefinition)(t.env.secrets);else{let e=await r.getSecretsDefaultTypeDefinition(this);t.env.secrets=(0,m.parseTypeDefinition)(`${e.file}#${e.name}`)}return t.env.prefix=(0,g.toArray)(t.env.prefix??[]).reduce((e,t)=>{let n=(0,C.constantCase)(t);return e.includes(n)||e.push(n),e},[...v.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(h.LogLevelLabel.TRACE,`Environment plugin configuration has been resolved for the Powerlines project.`),this.config.env.inject??=this.config.projectType===`application`,this.env=(0,p.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,x.existsSync)(r.getEnvTypeReflectionsPath(this,`env`)))this.log(h.LogLevelLabel.TRACE,`Skipping reflection initialization as the meta checksum has not changed.`),this.env.types.env=await r.readEnvTypeReflection(this,`env`),(0,x.existsSync)(r.getEnvReflectionsPath(this,`env`))&&(this.env.used.env=await r.readEnvReflection(this)),(0,x.existsSync)(r.getEnvTypeReflectionsPath(this,`secrets`))&&(this.env.types.secrets=await r.readEnvTypeReflection(this,`secrets`)),(0,x.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,_.isParentPath)(this.config.env.types?.file,this.workspaceConfig.workspaceRoot)?this.config.env.types?.file:(0,b.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,_.isParentPath)(this.config.env.secrets?.file,this.workspaceConfig.workspaceRoot)?this.config.env.secrets?.file:(0,b.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(h.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(h.LogLevelLabel.TRACE,`Preparing the Environment runtime artifacts for the Powerlines project.`),(0,y.createComponent)(l.EnvBuiltin,{get defaultConfig(){return e.config.env.defaultConfig}})},async docs(){this.log(h.LogLevelLabel.TRACE,`Writing Environment documentation for the Powerlines project artifacts.`);let e=(0,b.joinPaths)(this.config.projectRoot,`docs`,`generated`);(0,x.existsSync)(e)||await(0,S.createDirectory)(e);let n=await r.readEnvTypeReflection(this,`env`),i=(0,b.joinPaths)(e,`env.md`);this.log(h.LogLevelLabel.TRACE,`Documenting environment variables configuration in "${i}"`),await this.fs.write(i,`<!-- Generated by Powerlines -->
+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`} -->
 
-      # Environment variables configuration
+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.
 
-      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.
-
-      ## Environment Configuration
-
-      The below list of environment variables 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()!==`__STORM_INJECTED__`).sort((e,t)=>e.getNameAsString().localeCompare(t.getNameAsString())).map(e=>`| ${e.getNameAsString().trim()} | ${(e.getDescription()?.replaceAll(`\r`,``)?.replaceAll(`
+| 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=r.getEnvReflectionsPath(this,`env`);this.log(h.LogLevelLabel.TRACE,`Writing env reflection types to ${e}.`),await r.writeEnvReflection(this,this.env.used.env,`env`)}}));var T=w;exports.BaseEnv=n.BaseEnv,exports.BaseSecrets=n.BaseSecrets,exports.EnvBuiltin=l.EnvBuiltin,exports.EnvDocs=c.EnvDocs,exports.EnvTypeDefinition=l.EnvTypeDefinition,exports.createEnvReflection=n.createEnvReflection,exports.createReflectionResource=s.createReflectionResource,exports.createSecretsReflection=n.createSecretsReflection,exports.createTemplateReflection=i.createTemplateReflection,exports.default=T,exports.envBabelPlugin=u.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=w,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 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;

package/dist/index.d.cts

@@ -1,7 +1,6 @@
 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 { AlloyPluginBuilder, AlloyPluginOptions } from "./alloy/src/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";
@@ -16,6 +15,6 @@ import { envBabelPlugin } from "./babel/plugin.cjs";
 /**
  * A Powerlines plugin to inject environment variables into the source code.
  */
-declare const plugin: <T extends EnvPluginContext<EnvPluginResolvedConfig>>(options: Parameters<AlloyPluginBuilder<EnvPluginContext<EnvPluginResolvedConfig>>>[0] & AlloyPluginOptions) => Plugin<T>;
+declare const plugin: <TContext extends EnvPluginContext = EnvPluginContext>(options?: EnvPluginOptions) => Plugin<TContext>[];
 //#endregion
 export { BaseEnv, BaseSecrets, CreateEnvReflectionOptions, EnvBuiltin, EnvBuiltinProps, EnvDocs, EnvInterface, EnvPluginContext, EnvPluginOptions, EnvPluginResolvedConfig, EnvPluginUserConfig, EnvType, EnvTypeDefinition, SecretsInterface, __ΩCreateEnvReflectionOptions, __ΩEnvBuiltinProps, __ΩEnvInterface, __ΩEnvPluginContext, __ΩEnvPluginOptions, __ΩEnvPluginResolvedConfig, __ΩEnvPluginUserConfig, __ΩEnvType, __ΩSecretsInterface, createEnvReflection, createReflectionResource, createSecretsReflection, createTemplateReflection, plugin as default, plugin, envBabelPlugin, formatEnvField, getEnvDefaultTypeDefinition, getEnvReflectionsPath, getEnvTypeReflectionsPath, getSecretsDefaultTypeDefinition, loadEnv, loadEnvFromContext, mergeEnvReflections, mergeSecretsReflections, readEnvReflection, readEnvTypeReflection, readSecretsReflection, reflectEnv, reflectSecrets, removeEnvPrefix, resolveRuntimeTypeFile, writeEnvReflection, writeEnvReflectionSync, writeEnvTypeReflection };

package/dist/index.d.mts

@@ -1,9 +1,7 @@
 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 "./types/index.mjs";
-import { AlloyPluginBuilder, AlloyPluginOptions } from "./alloy/src/types/plugin.mjs";
-import "./powerlines/src/types/index.mjs";
 import { EnvDocs } from "./components/docs.mjs";
 import { EnvBuiltin, EnvBuiltinProps, EnvTypeDefinition, __ΩEnvBuiltinProps } from "./components/env.mjs";
 import "./components/index.mjs";
@@ -14,6 +12,7 @@ import { BaseEnv, BaseSecrets, CreateEnvReflectionOptions, __ΩCreateEnvReflecti
 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";
 
@@ -21,6 +20,6 @@ import "./babel/index.mjs";
 /**
  * A Powerlines plugin to inject environment variables into the source code.
  */
-declare const plugin: <T extends EnvPluginContext<EnvPluginResolvedConfig>>(options: Parameters<AlloyPluginBuilder<EnvPluginContext<EnvPluginResolvedConfig>>>[0] & AlloyPluginOptions) => Plugin<T>;
+declare const plugin: <TContext extends EnvPluginContext = EnvPluginContext>(options?: EnvPluginOptions) => Plugin<TContext>[];
 //#endregion
 export { BaseEnv, BaseSecrets, CreateEnvReflectionOptions, EnvBuiltin, EnvBuiltinProps, EnvDocs, EnvInterface, EnvPluginContext, EnvPluginOptions, EnvPluginResolvedConfig, EnvPluginUserConfig, EnvType, EnvTypeDefinition, SecretsInterface, __ΩCreateEnvReflectionOptions, __ΩEnvBuiltinProps, __ΩEnvInterface, __ΩEnvPluginContext, __ΩEnvPluginOptions, __ΩEnvPluginResolvedConfig, __ΩEnvPluginUserConfig, __ΩEnvType, __ΩSecretsInterface, createEnvReflection, createReflectionResource, createSecretsReflection, createTemplateReflection, plugin as default, plugin, envBabelPlugin, formatEnvField, getEnvDefaultTypeDefinition, getEnvReflectionsPath, getEnvTypeReflectionsPath, getSecretsDefaultTypeDefinition, loadEnv, loadEnvFromContext, mergeEnvReflections, mergeSecretsReflections, readEnvReflection, readEnvTypeReflection, readSecretsReflection, reflectEnv, reflectSecrets, removeEnvPrefix, resolveRuntimeTypeFile, writeEnvReflection, writeEnvReflectionSync, writeEnvTypeReflection };

package/dist/index.mjs

@@ -1,16 +1,10 @@
-import{type_exports as e}from"./deepkit/src/vendor/type.mjs";import{BaseEnv as t,BaseSecrets as n,createEnvReflection as r,createSecretsReflection as i,mergeEnvReflections as a,mergeSecretsReflections as o,reflectEnv as s,reflectSecrets as c}from"./helpers/reflect.mjs";import{getEnvDefaultTypeDefinition as l,getEnvReflectionsPath as u,getEnvTypeReflectionsPath as d,getSecretsDefaultTypeDefinition as f,readEnvReflection as p,readEnvTypeReflection as m,readSecretsReflection as h,resolveRuntimeTypeFile as g,writeEnvReflection as _,writeEnvReflectionSync as v,writeEnvTypeReflection as y}from"./helpers/persistence.mjs";import{createTemplateReflection as b}from"./helpers/template-helpers.mjs";import{formatEnvField as x,removeEnvPrefix as S}from"./helpers/source-file-env.mjs";import{loadEnv as C,loadEnvFromContext as w}from"./helpers/load.mjs";import{createReflectionResource as T}from"./helpers/create-reflection-resource.mjs";import"./helpers/index.mjs";import{EnvDocs as E}from"./components/docs.mjs";import{EnvBuiltin as D,EnvTypeDefinition as O}from"./components/env.mjs";import"./components/index.mjs";import{envBabelPlugin as k}from"./babel/plugin.mjs";import"./babel/index.mjs";import{createAlloyPlugin as A}from"./alloy/src/create-plugin.mjs";import j from"./plugin-babel/src/index.mjs";import M from"defu";import{parseTypeDefinition as N}from"@stryke/convert/parse-type-definition";import{LogLevelLabel as P}from"@storm-software/config-tools/types";import{toArray as F}from"@stryke/convert/to-array";import{isParentPath as I}from"@stryke/path/is-parent-path";import{ENV_PREFIXES as L}from"@stryke/env/types";import{createComponent as R}from"@alloy-js/core/jsx-runtime";import{joinPaths as z}from"@stryke/path/join";import{existsSync as B}from"@stryke/fs/exists";import{createDirectory as V}from"@stryke/fs/helpers";import{constantCase as H}from"@stryke/string-format/constant-case";const U=A((t={})=>({name:`env`,dependsOn:[j(t.babel)],async config(){this.log(P.TRACE,"Providing default configuration for the Powerlines `env` build plugin.");let e={env:M(t,{types:{},prefix:[]}),transform:{babel:{plugins:[k]}}};if(e.env.types)e.env.types=N(e.env.types);else{this.log(P.WARN,"The `env.types` configuration parameter was not provided. Please ensure this is expected.");let t=await l(this);e.env.types=N(`${t.file}#${t.name}`)}if(e.env.secrets)e.env.secrets=N(e.env.secrets);else{let t=await f(this);e.env.secrets=N(`${t.file}#${t.name}`)}return e.env.prefix=F(e.env.prefix??[]).reduce((e,t)=>{let n=H(t);return e.includes(n)||e.push(n),e},[...L,`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(P.TRACE,`Environment plugin configuration has been resolved for the Powerlines project.`),this.config.env.inject??=this.config.projectType===`application`,this.env=M({parsed:await C(this,this.config.env)},this.env??{},{types:{env:{}},used:{env:{},secrets:{}},parsed:{},injected:{}}),this.config.command!==`prepare`&&this.persistedMeta?.checksum===this.meta.checksum&&B(d(this,`env`)))this.log(P.TRACE,`Skipping reflection initialization as the meta checksum has not changed.`),this.env.types.env=await m(this,`env`),B(u(this,`env`))&&(this.env.used.env=await p(this)),B(d(this,`secrets`))&&(this.env.types.secrets=await m(this,`secrets`)),B(u(this,`secrets`))&&(this.env.used.secrets=await h(this));else{if(this.env.types.env=await s(this,this.config.env.types?.file?I(this.config.env.types?.file,this.workspaceConfig.workspaceRoot)?this.config.env.types?.file:z(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 y(this,this.env.types.env,`env`),this.env.types.secrets=await c(this,this.config.env.secrets?.file?I(this.config.env.secrets?.file,this.workspaceConfig.workspaceRoot)?this.config.env.secrets?.file:z(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 y(this,this.env.types.secrets,`secrets`),this.log(P.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 C(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 _(this,this.env.used.env,`env`),this.env.types.secrets&&(await y(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 _(this,this.env.used.secrets,`secrets`))}},render(){let e=this;return this.log(P.TRACE,`Preparing the Environment runtime artifacts for the Powerlines project.`),R(D,{get defaultConfig(){return e.config.env.defaultConfig}})},async docs(){this.log(P.TRACE,`Writing Environment documentation for the Powerlines project artifacts.`);let t=z(this.config.projectRoot,`docs`,`generated`);B(t)||await V(t);let n=await m(this,`env`),r=z(t,`env.md`);this.log(P.TRACE,`Documenting environment variables configuration in "${r}"`),await this.fs.write(r,`<!-- Generated by Powerlines -->
+import{type_exports as e}from"./deepkit/src/vendor/type.mjs";import{BaseEnv as t,BaseSecrets as n,createEnvReflection as r,createSecretsReflection as i,mergeEnvReflections as a,mergeSecretsReflections as o,reflectEnv as s,reflectSecrets as c}from"./helpers/reflect.mjs";import{getEnvDefaultTypeDefinition as l,getEnvReflectionsPath as u,getEnvTypeReflectionsPath as d,getSecretsDefaultTypeDefinition as f,readEnvReflection as p,readEnvTypeReflection as m,readSecretsReflection as h,resolveRuntimeTypeFile as g,writeEnvReflection as _,writeEnvReflectionSync as v,writeEnvTypeReflection as y}from"./helpers/persistence.mjs";import{createTemplateReflection as b}from"./helpers/template-helpers.mjs";import{formatEnvField as x,removeEnvPrefix as S}from"./helpers/source-file-env.mjs";import{loadEnv as C,loadEnvFromContext as w}from"./helpers/load.mjs";import{createReflectionResource as T}from"./helpers/create-reflection-resource.mjs";import"./helpers/index.mjs";import{env as E}from"./helpers/automd-generator.mjs";import{EnvDocs as D}from"./components/docs.mjs";import{EnvBuiltin as O,EnvTypeDefinition as k}from"./components/env.mjs";import"./components/index.mjs";import{envBabelPlugin as A}from"./babel/plugin.mjs";import"./babel/index.mjs";import{createAlloyPlugin as j}from"./alloy/src/create-plugin.mjs";import M from"./plugin-automd/src/index.mjs";import N from"./plugin-babel/src/index.mjs";import{titleCase as P}from"@stryke/string-format/title-case";import F from"defu";import{parseTypeDefinition as I}from"@stryke/convert/parse-type-definition";import{LogLevelLabel as L}from"@storm-software/config-tools/types";import{toArray as R}from"@stryke/convert/to-array";import{isParentPath as z}from"@stryke/path/is-parent-path";import{ENV_PREFIXES as B}from"@stryke/env/types";import{createComponent as V}from"@alloy-js/core/jsx-runtime";import{joinPaths as H}from"@stryke/path/join";import{existsSync as U}from"@stryke/fs/exists";import{createDirectory as W}from"@stryke/fs/helpers";import{constantCase as G}from"@stryke/string-format/constant-case";const K=j((t={})=>({name:`env`,async config(){this.log(L.TRACE,"Providing default configuration for the Powerlines `env` build plugin.");let e={env:F(t,{types:{},prefix:[]}),transform:{babel:{plugins:[A]}}};if(e.env.types)e.env.types=I(e.env.types);else{this.log(L.WARN,"The `env.types` configuration parameter was not provided. Please ensure this is expected.");let t=await l(this);e.env.types=I(`${t.file}#${t.name}`)}if(e.env.secrets)e.env.secrets=I(e.env.secrets);else{let t=await f(this);e.env.secrets=I(`${t.file}#${t.name}`)}return e.env.prefix=R(e.env.prefix??[]).reduce((e,t)=>{let n=G(t);return e.includes(n)||e.push(n),e},[...B,`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=F({parsed:await C(this,this.config.env)},this.env??{},{types:{env:{}},used:{env:{},secrets:{}},parsed:{},injected:{}}),this.config.command!==`prepare`&&this.persistedMeta?.checksum===this.meta.checksum&&U(d(this,`env`)))this.log(L.TRACE,`Skipping reflection initialization as the meta checksum has not changed.`),this.env.types.env=await m(this,`env`),U(u(this,`env`))&&(this.env.used.env=await p(this)),U(d(this,`secrets`))&&(this.env.types.secrets=await m(this,`secrets`)),U(u(this,`secrets`))&&(this.env.used.secrets=await h(this));else{if(this.env.types.env=await s(this,this.config.env.types?.file?z(this.config.env.types?.file,this.workspaceConfig.workspaceRoot)?this.config.env.types?.file:H(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 y(this,this.env.types.env,`env`),this.env.types.secrets=await c(this,this.config.env.secrets?.file?z(this.config.env.secrets?.file,this.workspaceConfig.workspaceRoot)?this.config.env.secrets?.file:H(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 y(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 C(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 _(this,this.env.used.env,`env`),this.env.types.secrets&&(await y(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 _(this,this.env.used.secrets,`secrets`))}},render(){let e=this;return this.log(L.TRACE,`Preparing the Environment runtime artifacts for the Powerlines project.`),V(O,{get defaultConfig(){return e.config.env.defaultConfig}})},async docs(){this.log(L.TRACE,`Writing Environment documentation for the Powerlines project artifacts.`);let t=H(this.config.projectRoot,`docs`,`generated`);U(t)||await W(t);let n=await m(this,`env`),r=H(t,`env.md`);this.log(L.TRACE,`Documenting environment variables configuration in "${r}"`),await this.fs.write(r,`<!-- Generated by ${P(this.config.framework)||`Powerlines`} -->
 
-      # Environment variables configuration
+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.
 
-      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.
-
-      ## Environment Configuration
-
-      The below list of environment variables 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()!==`__STORM_INJECTED__`).sort((e,t)=>e.getNameAsString().localeCompare(t.getNameAsString())).map(t=>`| ${t.getNameAsString().trim()} | ${(t.getDescription()?.replaceAll(`\r`,``)?.replaceAll(`
+| 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=u(this,`env`);this.log(P.TRACE,`Writing env reflection types to ${e}.`),await _(this,this.env.used.env,`env`)}}));var W=U;export{t as BaseEnv,n as BaseSecrets,D as EnvBuiltin,E as EnvDocs,O as EnvTypeDefinition,r as createEnvReflection,T as createReflectionResource,i as createSecretsReflection,b as createTemplateReflection,W as default,k as envBabelPlugin,x as formatEnvField,l as getEnvDefaultTypeDefinition,u as getEnvReflectionsPath,d as getEnvTypeReflectionsPath,f as getSecretsDefaultTypeDefinition,C as loadEnv,w as loadEnvFromContext,a as mergeEnvReflections,o as mergeSecretsReflections,U as plugin,p as readEnvReflection,m as readEnvTypeReflection,h as readSecretsReflection,s as reflectEnv,c as reflectSecrets,S as removeEnvPrefix,g as resolveRuntimeTypeFile,_ as writeEnvReflection,v as writeEnvReflectionSync,y as writeEnvTypeReflection};
+`)},async buildEnd(){let e=u(this,`env`);this.log(L.TRACE,`Writing env reflection types to ${e}.`),await _(this,this.env.used.env,`env`)}})),q=(e={})=>[N(e.babel),K(e),{name:`env:automd-generator`,config(){return{automd:F(e.automd??{},{generators:{env:E(this)}})}}},{name:`env:vite`,vite:{configResolved(){return{envPrefix:this.config?.env?.prefix}}}},M(e.automd)];var J=q;export{t as BaseEnv,n as BaseSecrets,O as EnvBuiltin,D as EnvDocs,k as EnvTypeDefinition,r as createEnvReflection,T as createReflectionResource,i as createSecretsReflection,b as createTemplateReflection,J as default,A as envBabelPlugin,x as formatEnvField,l as getEnvDefaultTypeDefinition,u as getEnvReflectionsPath,d as getEnvTypeReflectionsPath,f as getSecretsDefaultTypeDefinition,C as loadEnv,w as loadEnvFromContext,a as mergeEnvReflections,o as mergeSecretsReflections,q as plugin,p as readEnvReflection,m as readEnvTypeReflection,h as readSecretsReflection,s as reflectEnv,c as reflectSecrets,S as removeEnvPrefix,g as resolveRuntimeTypeFile,_ as writeEnvReflection,v as writeEnvReflectionSync,y as writeEnvTypeReflection};

package/dist/plugin-automd/src/index.cjs

@@ -0,0 +1 @@
+const e=require(`../../_virtual/rolldown_runtime.cjs`);let t=require(`@stryke/path/join-paths`),n=require(`defu`);n=e.__toESM(n);let r=require(`@stryke/path/replace`),i=require(`@stryke/convert/to-array`),a=require(`@stryke/fs/is-file`),o=require(`@stryke/fs/list-files`),s=require(`@stryke/path/append`),c=require(`c12`),l=require(`automd`),u=require(`@stryke/path/is-type`),d=require(`markdown-toc`);d=e.__toESM(d);const f=(e={})=>({name:`automd`,async config(){let r=await(0,l.loadConfig)((0,t.joinPaths)(this.workspaceConfig.workspaceRoot,this.config.projectRoot),e);return(!r.prefix||!Array.isArray(r.prefix))&&(r.prefix=(0,i.toArray)(r.prefix??[])),r.prefix.includes(`automd`)||r.prefix.push(`automd`),r.prefix.includes(`powerlines`)||r.prefix.push(`powerlines`),{automd:(0,n.default)(r??{},{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,i.toArray)(this.config.automd.prefix).includes(this.config.framework)&&(this.config.automd.prefix=(0,i.toArray)(this.config.automd.prefix).concat(this.config.framework)),this.config.automd.configFile){let{config:e}=await(0,c.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,n.default)(this.config.automd,{...e,prefix:(0,i.toArray)(e.prefix??[])}))}this.config.automd.input=(await Promise.all((0,i.toArray)(this.config.automd.input).map(async e=>e.includes(`*`)?(0,o.listFiles)((0,u.isAbsolutePath)(e)?e:(0,s.appendPath)(e,this.config.projectRoot),{ignore:this.config.automd.ignore}):(0,u.isAbsolutePath)(e)?e:(0,s.appendPath)(e,this.config.projectRoot)))).flat(),this.config.automd.output&&!(0,u.isAbsolutePath)(this.config.automd.output)&&(this.config.automd.output=(0,s.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,d.default)(e.block.md,{...t,maxdepth:t.maxDepth,first1:t.firstH1}).content}}})},async docs(){await Promise.all((0,i.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,s.appendPath)(this.config.automd.output?(0,a.isDirectory)(this.config.automd.output)?(0,r.replacePath)(e,this.config.automd.output):this.config.automd.output:e,this.config.projectRoot),n.contents)}}))}});var p=f;exports.default=p;

package/dist/plugin-automd/src/index.mjs

@@ -0,0 +1 @@
+import{joinPaths as e}from"@stryke/path/join-paths";import t from"defu";import{replacePath as n}from"@stryke/path/replace";import{toArray as r}from"@stryke/convert/to-array";import{isDirectory as i}from"@stryke/fs/is-file";import{listFiles as a}from"@stryke/fs/list-files";import{appendPath as o}from"@stryke/path/append";import{loadConfig as s}from"c12";import{loadConfig as c,resolveConfig as l,transform as u}from"automd";import{isAbsolutePath as d}from"@stryke/path/is-type";import f from"markdown-toc";var p=(p={})=>({name:`automd`,async config(){let n=await c(e(this.workspaceConfig.workspaceRoot,this.config.projectRoot),p);return(!n.prefix||!Array.isArray(n.prefix))&&(n.prefix=r(n.prefix??[])),n.prefix.includes(`automd`)||n.prefix.push(`automd`),n.prefix.includes(`powerlines`)||n.prefix.push(`powerlines`),{automd:t(n??{},{configFile:p.configFile,allowIssues:!0,dir:this.config.projectRoot,watch:!1,input:`README.md`,toc:{maxDepth:6,bullets:`-`}})}},async configResolved(){if(this.config.framework&&!r(this.config.automd.prefix).includes(this.config.framework)&&(this.config.automd.prefix=r(this.config.automd.prefix).concat(this.config.framework)),this.config.automd.configFile){let{config:e}=await s({cwd:this.config.automd.dir,configFile:this.config.automd.configFile,defaults:{ignore:[`**/node_modules`,`**/dist`,`**/.*`],dir:this.config.automd.dir}});this.config.automd=l(t(this.config.automd,{...e,prefix:r(e.prefix??[])}))}this.config.automd.input=(await Promise.all(r(this.config.automd.input).map(async e=>e.includes(`*`)?a(d(e)?e:o(e,this.config.projectRoot),{ignore:this.config.automd.ignore}):d(e)?e:o(e,this.config.projectRoot)))).flat(),this.config.automd.output&&!d(this.config.automd.output)&&(this.config.automd.output=o(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:f(e.block.md,{...t,maxdepth:t.maxDepth,first1:t.firstH1}).content}}})},async docs(){await Promise.all(r(this.config.automd.input).map(async e=>{let t=await this.fs.read(e);if(t){let r=await u(t,this.config.automd);if(r.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.`);r.hasChanged&&await this.fs.write(o(this.config.automd.output?i(this.config.automd.output)?n(e,this.config.automd.output):this.config.automd.output:e,this.config.projectRoot),r.contents)}}))}});export{p as default};

package/dist/plugin-automd/src/types/plugin.d.cts

@@ -0,0 +1,38 @@
+import { TOCOptions } from "./toc.cjs";
+import { Config } from "automd";
+
+//#region ../plugin-automd/src/types/plugin.d.ts
+
+type AutoMDPluginOptions = Omit<Config, "dir" | "watch" | "onWatch" | "prefix"> & {
+  /**
+   * Path to the AutoMD configuration file.
+   *
+   * @remarks
+   * If not provided, the plugin will use the default AutoMD configuration resolution mechanism.
+   */
+  configFile?: string;
+  /**
+   * An indicator specifying whether or not issues found by AutoMD during the prepare task are considered fatal.
+   *
+   * @defaultValue true
+   */
+  allowIssues?: boolean;
+  /**
+   * Alternate prefix strings to use for finding generators
+   *
+   * @remarks
+   * By default, AutoMD looks for generators with the "automd" prefix, so that any `<!-- automd:generator [...args] --> ... <!-- /automd -->` comments will be picked up. If you want to use different prefixes (for example, to avoid conflicts with other tools), you would provide a value like "myPrefix" and AutoMD would also look for `<!-- myPrefix:generator [...args] --> ... <!-- /myPrefix -->` comments.
+   *
+   * @defaultValue ["automd", "powerlines", "\{framework\}"]
+   */
+  prefix?: string | string[];
+  /**
+   * Table of Contents generator options
+   *
+   * @remarks
+   * If set to `false`, the built-in Table of Contents generator will be disabled.
+   */
+  toc?: false | TOCOptions;
+};
+//#endregion
+export { AutoMDPluginOptions };

package/dist/plugin-automd/src/types/plugin.d.mts

@@ -0,0 +1,40 @@
+import "../../../powerlines/src/types/resolved.mjs";
+import "../../../powerlines/src/types/config.mjs";
+import "../../../powerlines/src/types/context.mjs";
+import { TOCOptions } from "./toc.mjs";
+import { Config } from "automd";
+
+//#region ../plugin-automd/src/types/plugin.d.ts
+type AutoMDPluginOptions = Omit<Config, "dir" | "watch" | "onWatch" | "prefix"> & {
+  /**
+   * Path to the AutoMD configuration file.
+   *
+   * @remarks
+   * If not provided, the plugin will use the default AutoMD configuration resolution mechanism.
+   */
+  configFile?: string;
+  /**
+   * An indicator specifying whether or not issues found by AutoMD during the prepare task are considered fatal.
+   *
+   * @defaultValue true
+   */
+  allowIssues?: boolean;
+  /**
+   * Alternate prefix strings to use for finding generators
+   *
+   * @remarks
+   * By default, AutoMD looks for generators with the "automd" prefix, so that any `<!-- automd:generator [...args] --> ... <!-- /automd -->` comments will be picked up. If you want to use different prefixes (for example, to avoid conflicts with other tools), you would provide a value like "myPrefix" and AutoMD would also look for `<!-- myPrefix:generator [...args] --> ... <!-- /myPrefix -->` comments.
+   *
+   * @defaultValue ["automd", "powerlines", "\{framework\}"]
+   */
+  prefix?: string | string[];
+  /**
+   * Table of Contents generator options
+   *
+   * @remarks
+   * If set to `false`, the built-in Table of Contents generator will be disabled.
+   */
+  toc?: false | TOCOptions;
+};
+//#endregion
+export { AutoMDPluginOptions };

package/dist/plugin-automd/src/types/toc.d.cts

@@ -0,0 +1,33 @@
+//#region ../plugin-automd/src/types/toc.d.ts
+interface TOCOptions {
+  /**
+   * A slugify function to generate slugs for the headings.
+   */
+  slugify?: (str: string) => string;
+  /**
+   * The maximum depth of headings to include in the TOC.
+   *
+   * @defaultValue 6
+   */
+  maxDepth?: number;
+  /**
+   * Whether to include the first H1 heading in the TOC.
+   */
+  firstH1?: boolean;
+  /**
+   * The bullet character to use for list items in the TOC.
+   *
+   * @defaultValue "-"
+   */
+  bullets?: string;
+  /**
+   * A prefix to add to each heading in the TOC.
+   */
+  prefix?: string;
+  /**
+   * A filter function to determine which headings to include in the TOC.
+   */
+  filter?: (str: string, level: number) => boolean;
+}
+//#endregion
+export { TOCOptions };

package/dist/plugin-automd/src/types/toc.d.mts

@@ -0,0 +1,33 @@
+//#region ../plugin-automd/src/types/toc.d.ts
+interface TOCOptions {
+  /**
+   * A slugify function to generate slugs for the headings.
+   */
+  slugify?: (str: string) => string;
+  /**
+   * The maximum depth of headings to include in the TOC.
+   *
+   * @defaultValue 6
+   */
+  maxDepth?: number;
+  /**
+   * Whether to include the first H1 heading in the TOC.
+   */
+  firstH1?: boolean;
+  /**
+   * The bullet character to use for list items in the TOC.
+   *
+   * @defaultValue "-"
+   */
+  bullets?: string;
+  /**
+   * A prefix to add to each heading in the TOC.
+   */
+  prefix?: string;
+  /**
+   * A filter function to determine which headings to include in the TOC.
+   */
+  filter?: (str: string, level: number) => boolean;
+}
+//#endregion
+export { TOCOptions };

package/dist/plugin-babel/src/types/plugin.d.cts

@@ -1,6 +1,6 @@
 import { BabelResolvedConfig, ResolvedConfig } from "../../../powerlines/src/types/resolved.cjs";
-import { PluginContext } from "../../../powerlines/src/types/context.cjs";
 import { BabelUserConfig, UserConfig } from "../../../powerlines/src/types/config.cjs";
+import { PluginContext } from "../../../powerlines/src/types/context.cjs";
 
 //#region ../plugin-babel/src/types/plugin.d.ts
 type BabelPluginOptions = Partial<BabelUserConfig>;

package/dist/plugin-babel/src/types/plugin.d.mts

@@ -1,6 +1,6 @@
 import { BabelResolvedConfig, ResolvedConfig } from "../../../powerlines/src/types/resolved.mjs";
-import { PluginContext } from "../../../powerlines/src/types/context.mjs";
 import { BabelUserConfig, UserConfig } from "../../../powerlines/src/types/config.mjs";
+import { PluginContext } from "../../../powerlines/src/types/context.mjs";
 
 //#region ../plugin-babel/src/types/plugin.d.ts
 type BabelPluginOptions = Partial<BabelUserConfig>;

package/dist/powerlines/schemas/fs.d.mts

@@ -0,0 +1 @@
+import "@stryke/capnp";

package/dist/powerlines/src/api.d.mts

@@ -0,0 +1,7 @@
+import "./types/resolved.mjs";
+import "./types/config.mjs";
+import "./types/hooks.mjs";
+import "./types/context.mjs";
+import "./internal/helpers/hooks.mjs";
+import "./types/api.mjs";
+import "./types/index.mjs";

package/dist/powerlines/src/index.d.mts

@@ -0,0 +1,12 @@
+import { BabelPluginPass, BabelTransformPlugin, BabelTransformPluginFilter, BabelTransformPluginOptions, DeclareBabelTransformPluginReturn } from "./types/babel.mjs";
+import { BuildConfig, BuildResolvedConfig, UnpluginBuildVariant } from "./types/build.mjs";
+import { ResolveOptions, StorageAdapter, StoragePort, StoragePreset, VirtualFile, VirtualFileData, VirtualFileMetadata, VirtualFileSystemInterface, WriteOptions } from "./types/fs.mjs";
+import { CommandType, SUPPORTED_COMMANDS } from "./types/commands.mjs";
+import { BabelResolvedConfig, EnvironmentResolvedConfig, OutputResolvedConfig, ResolvedAssetGlob, ResolvedConfig, ResolvedEntryTypeDefinition } from "./types/resolved.mjs";
+import { BasePluginHookFunctions, BuildPlugin, ConfigResult, Plugin, PluginBuildPlugins, PluginHook, PluginHookObject, PluginHooks, TypesResult } from "./types/plugin.mjs";
+import { DeepkitOptions, ParsedTypeScriptConfig, RawReflectionMode, ReflectionLevel, ReflectionMode, TSCompilerOptions, TSConfig } from "./types/tsconfig.mjs";
+import { BabelUserConfig, BaseConfig, CommonUserConfig, DeployConfig, EnvironmentConfig, InlineConfig, LogFn, OutputConfig, PluginConfig, PluginConfigObject, PluginConfigTuple, PluginFactory, PowerlinesCommand, ProjectType, UserConfig, WorkspaceConfig } from "./types/config.mjs";
+import { BuildPluginContext, Context, EmitEntryOptions, FetchOptions, InitContextOptions, LogLevel, MetaInfo, ParseOptions, PluginContext, Resolver, TransformResult, UnresolvedContext } from "./types/context.mjs";
+import "./types/index.mjs";
+import "./api.mjs";
+import "../schemas/fs.mjs";

package/dist/powerlines/src/internal/helpers/hooks.d.mts

@@ -1,5 +1,5 @@
 import "../../types/resolved.mjs";
 import "../../types/hooks.mjs";
 import "../../types/context.mjs";
-import { MaybePromise } from "@stryke/types/base";
-import { ArrayValues } from "@stryke/types/array";
+import { ArrayValues } from "@stryke/types/array";
+import { MaybePromise } from "@stryke/types/base";

package/dist/powerlines/src/lib/entry.cjs

@@ -1 +1 @@
-require(`../plugin-utils/paths.cjs`);let e=require(`@stryke/path/join-paths`),t=require(`@stryke/convert/parse-type-definition`),n=require(`@stryke/type-checks/is-set-string`),r=require(`@stryke/path/replace`),i=require(`@stryke/type-checks/is-string`),a=require(`@stryke/convert/to-array`);require(`@stryke/fs/is-file`),require(`@stryke/fs/list-files`),require(`@stryke/hash/murmurhash`);let o=require(`@stryke/helpers/get-unique`),s=require(`@stryke/path/append`);
+require(`../plugin-utils/paths.cjs`);let e=require(`@stryke/path/join-paths`),t=require(`@stryke/convert/parse-type-definition`),n=require(`@stryke/type-checks/is-set-string`),r=require(`@stryke/path/replace`),i=require(`@stryke/type-checks/is-string`),a=require(`@stryke/convert/to-array`),o=require(`@stryke/fs/is-file`),s=require(`@stryke/fs/list-files`);require(`@stryke/hash/murmurhash`);let c=require(`@stryke/helpers/get-unique`),l=require(`@stryke/path/append`);

package/dist/powerlines/src/lib/entry.mjs

@@ -1 +1 @@
-import"../plugin-utils/paths.mjs";import{joinPaths as e}from"@stryke/path/join-paths";import{parseTypeDefinition as t}from"@stryke/convert/parse-type-definition";import{isSetString as n}from"@stryke/type-checks/is-set-string";import{replacePath as r}from"@stryke/path/replace";import{isString as i}from"@stryke/type-checks/is-string";import{toArray as a}from"@stryke/convert/to-array";import"@stryke/fs/is-file";import"@stryke/fs/list-files";import"@stryke/hash/murmurhash";import{getUniqueBy as o}from"@stryke/helpers/get-unique";import{appendPath as s}from"@stryke/path/append";export{};
+import"../plugin-utils/paths.mjs";import{joinPaths as e}from"@stryke/path/join-paths";import{parseTypeDefinition as t}from"@stryke/convert/parse-type-definition";import{isSetString as n}from"@stryke/type-checks/is-set-string";import{replacePath as r}from"@stryke/path/replace";import{isString as i}from"@stryke/type-checks/is-string";import{toArray as a}from"@stryke/convert/to-array";import"@stryke/fs/is-file";import{listFiles as o}from"@stryke/fs/list-files";import"@stryke/hash/murmurhash";import{getUniqueBy as s}from"@stryke/helpers/get-unique";import{appendPath as c}from"@stryke/path/append";export{};

package/dist/powerlines/src/types/api.d.mts

@@ -1,5 +1,5 @@
 import "./resolved.mjs";
+import "./config.mjs";
 import "./hooks.mjs";
 import "./context.mjs";
-import "./config.mjs";
 import "../internal/helpers/hooks.mjs";

package/dist/powerlines/src/types/babel.d.cts

@@ -1,5 +1,5 @@
-import { Context } from "./context.cjs";
 import { LogFn } from "./config.cjs";
+import { Context } from "./context.cjs";
 import { PluginItem, PluginObj, PluginPass } from "@babel/core";
 import { BabelAPI } from "@babel/helper-plugin-utils";
 

package/dist/powerlines/src/types/babel.d.mts

@@ -1,5 +1,5 @@
-import { Context } from "./context.mjs";
 import { LogFn } from "./config.mjs";
+import { Context } from "./context.mjs";
 import { BabelAPI } from "@babel/helper-plugin-utils";
 import { PluginItem, PluginObj, PluginPass } from "@babel/core";
 

package/dist/powerlines/src/types/commands.d.cts

@@ -1,5 +1,5 @@
-import { MaybePromise } from "@stryke/types/base";
 import { ArrayValues } from "@stryke/types/array";
+import { MaybePromise } from "@stryke/types/base";
 
 //#region ../powerlines/src/types/commands.d.ts
 declare const SUPPORTED_COMMANDS: readonly ["new", "clean", "prepare", "lint", "test", "build", "docs", "deploy", "finalize"];

package/dist/powerlines/src/types/commands.d.mts

@@ -1,6 +1,6 @@
 import "./context.mjs";
-import { MaybePromise } from "@stryke/types/base";
 import { ArrayValues } from "@stryke/types/array";
+import { MaybePromise } from "@stryke/types/base";
 
 //#region ../powerlines/src/types/commands.d.ts
 declare const SUPPORTED_COMMANDS: readonly ["new", "clean", "prepare", "lint", "test", "build", "docs", "deploy", "finalize"];

package/dist/powerlines/src/types/config.d.cts

@@ -1,14 +1,14 @@
-import { StoragePort, StoragePreset } from "./fs.cjs";
+import { BabelTransformPluginOptions } from "./babel.cjs";
 import { BuildConfig, BuildResolvedConfig } from "./build.cjs";
+import { StoragePort, StoragePreset } from "./fs.cjs";
 import { Plugin } from "./plugin.cjs";
 import { TSConfig } from "./tsconfig.cjs";
 import { PluginContext } from "./context.cjs";
-import { BabelTransformPluginOptions } from "./babel.cjs";
+import { MaybePromise } from "@stryke/types/base";
 import { transformAsync } from "@babel/core";
 import { Format } from "@storm-software/build-tools/types";
 import { LogLevelLabel } from "@storm-software/config-tools/types";
 import { StormWorkspaceConfig } from "@storm-software/config/types";
-import { MaybePromise } from "@stryke/types/base";
 import { TypeDefinitionParameter } from "@stryke/types/configuration";
 import { AssetGlob } from "@stryke/types/file";
 import { PreviewOptions } from "vite";

package/dist/powerlines/src/types/config.d.mts

@@ -1,15 +1,15 @@
-import { StoragePort, StoragePreset } from "./fs.mjs";
+import { BabelTransformPluginOptions } from "./babel.mjs";
 import { BuildConfig, BuildResolvedConfig } from "./build.mjs";
+import { StoragePort, StoragePreset } from "./fs.mjs";
 import { Plugin } from "./plugin.mjs";
 import { TSConfig } from "./tsconfig.mjs";
 import { PluginContext } from "./context.mjs";
-import { BabelTransformPluginOptions } from "./babel.mjs";
 import { LogLevelLabel } from "@storm-software/config-tools/types";
 import "c12";
 import { transformAsync } from "@babel/core";
+import { MaybePromise } from "@stryke/types/base";
 import { Format } from "@storm-software/build-tools/types";
 import { StormWorkspaceConfig } from "@storm-software/config/types";
-import { MaybePromise } from "@stryke/types/base";
 import { TypeDefinitionParameter } from "@stryke/types/configuration";
 import { AssetGlob } from "@stryke/types/file";
 import { PreviewOptions } from "vite";

package/dist/powerlines/src/types/context.d.mts

@@ -1,9 +1,9 @@
 import { ResolveOptions, VirtualFile, VirtualFileSystemInterface, WriteOptions } from "./fs.mjs";
 import { EnvironmentResolvedConfig, ResolvedConfig, ResolvedEntryTypeDefinition } from "./resolved.mjs";
 import "./plugin.mjs";
-import "./hooks.mjs";
 import { ParsedTypeScriptConfig } from "./tsconfig.mjs";
 import { InlineConfig, LogFn, UserConfig, WorkspaceConfig } from "./config.mjs";
+import "./hooks.mjs";
 import { NonUndefined } from "@stryke/types/base";
 import { EnvPaths } from "@stryke/env/get-env-paths";
 import { FetchRequestOptions } from "@stryke/http/fetch";

package/dist/powerlines/src/types/index.d.mts

@@ -1,12 +1,12 @@
-import { ResolveOptions, StorageAdapter, StoragePort, StoragePreset, VirtualFile, VirtualFileData, VirtualFileMetadata, VirtualFileSystemInterface, WriteOptions } from "./fs.mjs";
+import { BabelPluginPass, BabelTransformPlugin, BabelTransformPluginFilter, BabelTransformPluginOptions, DeclareBabelTransformPluginReturn } from "./babel.mjs";
 import { BuildConfig, BuildResolvedConfig, UnpluginBuildVariant } from "./build.mjs";
+import { ResolveOptions, StorageAdapter, StoragePort, StoragePreset, VirtualFile, VirtualFileData, VirtualFileMetadata, VirtualFileSystemInterface, WriteOptions } from "./fs.mjs";
 import { CommandType, SUPPORTED_COMMANDS } from "./commands.mjs";
 import { BabelResolvedConfig, EnvironmentResolvedConfig, OutputResolvedConfig, ResolvedAssetGlob, ResolvedConfig, ResolvedEntryTypeDefinition } from "./resolved.mjs";
 import { BasePluginHookFunctions, BuildPlugin, ConfigResult, Plugin, PluginBuildPlugins, PluginHook, PluginHookObject, PluginHooks, TypesResult } from "./plugin.mjs";
-import "./hooks.mjs";
 import { DeepkitOptions, ParsedTypeScriptConfig, RawReflectionMode, ReflectionLevel, ReflectionMode, TSCompilerOptions, TSConfig } from "./tsconfig.mjs";
-import { BuildPluginContext, Context, EmitEntryOptions, FetchOptions, InitContextOptions, LogLevel, MetaInfo, ParseOptions, PluginContext, Resolver, TransformResult, UnresolvedContext } from "./context.mjs";
-import { BabelPluginPass, BabelTransformPlugin, BabelTransformPluginFilter, BabelTransformPluginOptions, DeclareBabelTransformPluginReturn } from "./babel.mjs";
 import { BabelUserConfig, BaseConfig, CommonUserConfig, DeployConfig, EnvironmentConfig, InlineConfig, LogFn, OutputConfig, PluginConfig, PluginConfigObject, PluginConfigTuple, PluginFactory, PowerlinesCommand, ProjectType, UserConfig, WorkspaceConfig } from "./config.mjs";
+import "./hooks.mjs";
+import { BuildPluginContext, Context, EmitEntryOptions, FetchOptions, InitContextOptions, LogLevel, MetaInfo, ParseOptions, PluginContext, Resolver, TransformResult, UnresolvedContext } from "./context.mjs";
 import "./api.mjs";
 import "./unplugin.mjs";

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

@@ -1,11 +1,11 @@
 import { UnpluginBuildVariant } from "./build.cjs";
 import { CommandType } from "./commands.cjs";
 import { EnvironmentResolvedConfig, ResolvedConfig } from "./resolved.cjs";
-import { BuildPluginContext, PluginContext, UnresolvedContext } from "./context.cjs";
 import { EnvironmentConfig, PluginConfig } from "./config.cjs";
+import { BuildPluginContext, PluginContext, UnresolvedContext } from "./context.cjs";
+import { ArrayValues } from "@stryke/types/array";
 import { FunctionLike, MaybePromise } from "@stryke/types/base";
 import { ExternalIdResult, HookFilter, TransformResult, UnpluginOptions } from "unplugin";
-import { ArrayValues } from "@stryke/types/array";
 
 //#region ../powerlines/src/types/plugin.d.ts
 interface PluginHookObject<THookFunction extends FunctionLike, TFilter extends keyof HookFilter = never> {

package/dist/powerlines/src/types/plugin.d.mts

@@ -1,11 +1,11 @@
 import { UnpluginBuildVariant } from "./build.mjs";
 import { CommandType } from "./commands.mjs";
 import { EnvironmentResolvedConfig, ResolvedConfig } from "./resolved.mjs";
-import { BuildPluginContext, PluginContext, UnresolvedContext } from "./context.mjs";
 import { EnvironmentConfig, PluginConfig } from "./config.mjs";
+import { BuildPluginContext, PluginContext, UnresolvedContext } from "./context.mjs";
+import { ArrayValues } from "@stryke/types/array";
 import { FunctionLike, MaybePromise } from "@stryke/types/base";
 import { ExternalIdResult, HookFilter, TransformResult, UnpluginOptions } from "unplugin";
-import { ArrayValues } from "@stryke/types/array";
 
 //#region ../powerlines/src/types/plugin.d.ts
 interface PluginHookObject<THookFunction extends FunctionLike, TFilter extends keyof HookFilter = never> {

package/dist/powerlines/src/types/unplugin.d.mts

@@ -1,7 +1,7 @@
 import "./build.mjs";
 import "./resolved.mjs";
 import "./plugin.mjs";
-import "./context.mjs";
 import "./config.mjs";
+import "./context.mjs";
 import "./api.mjs";
 import { UnpluginOptions } from "unplugin";

package/dist/types/plugin.d.cts

@@ -1,8 +1,9 @@
 import { Reflection } from "../deepkit/src/types.cjs";
+import { AutoMDPluginOptions } from "../plugin-automd/src/types/plugin.cjs";
 import { BabelPluginContext, BabelPluginOptions, BabelPluginResolvedConfig, BabelPluginUserConfig } from "../plugin-babel/src/types/plugin.cjs";
 import { EnvInterface, SecretsInterface } from "./runtime.cjs";
-import { Children } from "@alloy-js/core/jsx-runtime";
 import { DotenvConfiguration, TypeDefinition, TypeDefinitionParameter } from "@stryke/types/configuration";
+import { Children } from "@alloy-js/core/jsx-runtime";
 import { DotenvParseOutput } from "@stryke/env/types";
 
 //#region src/types/plugin.d.ts
@@ -46,6 +47,13 @@ type EnvPluginOptions = Omit<DotenvConfiguration, "types"> & {
    * This option allows you to customize the Babel transformation process used to inject environment variables into the source code. If not provided, the plugin will use default Babel settings.
    */
   babel?: BabelPluginOptions;
+  /**
+   * AutoMD configuration options to allow injecting environment variables documentation into a markdown file such as a README.md.
+   *
+   * @remarks
+   * The README.md file should contain the `<!-- automd:env --><!-- /automd -->` comment block where the documentation will be injected.
+   */
+  automd?: AutoMDPluginOptions;
 };
 type EnvPluginUserConfig = BabelPluginUserConfig & {
   env: EnvPluginOptions;

package/dist/types/plugin.d.mts

@@ -1,4 +1,5 @@
 import { Reflection } from "../deepkit/src/types.mjs";
+import { AutoMDPluginOptions } from "../plugin-automd/src/types/plugin.mjs";
 import { BabelPluginContext, BabelPluginOptions, BabelPluginResolvedConfig, BabelPluginUserConfig } from "../plugin-babel/src/types/plugin.mjs";
 import "../plugin-babel/src/types/index.mjs";
 import { EnvInterface, SecretsInterface } from "./runtime.mjs";
@@ -47,6 +48,13 @@ type EnvPluginOptions = Omit<DotenvConfiguration, "types"> & {
    * This option allows you to customize the Babel transformation process used to inject environment variables into the source code. If not provided, the plugin will use default Babel settings.
    */
   babel?: BabelPluginOptions;
+  /**
+   * AutoMD configuration options to allow injecting environment variables documentation into a markdown file such as a README.md.
+   *
+   * @remarks
+   * The README.md file should contain the `<!-- automd:env --><!-- /automd -->` comment block where the documentation will be injected.
+   */
+  automd?: AutoMDPluginOptions;
 };
 type EnvPluginUserConfig = BabelPluginUserConfig & {
   env: EnvPluginOptions;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@powerlines/plugin-env",
-  "version": "0.13.106",
+  "version": "0.14.0",
   "type": "module",
   "description": "A package containing a Powerlines plugin for injecting static .env configuration values to the code so that they're accessible at runtime.",
   "repository": {
@@ -187,14 +187,16 @@
   "files": ["dist/**/*"],
   "keywords": ["powerlines", "storm-software", "powerlines-plugin"],
   "dependencies": {
+    "automd": "^0.4.2",
     "@alloy-js/core": "^0.21.0",
     "@alloy-js/typescript": "^0.21.0",
     "@alloy-js/markdown": "^0.21.0",
     "@babel/core": "^7.28.5",
     "@babel/types": "^7.28.5",
-    "@powerlines/alloy": "^0.12.0",
-    "@powerlines/plugin-babel": "^0.12.106",
-    "@powerlines/plugin-plugin": "^0.12.49",
+    "@powerlines/alloy": "^0.12.1",
+    "@powerlines/plugin-automd": "^0.1.98",
+    "@powerlines/plugin-babel": "^0.12.107",
+    "@powerlines/plugin-plugin": "^0.12.50",
     "@storm-software/config-tools": "^1.188.73",
     "@stryke/capnp": "^0.12.51",
     "@stryke/env": "^0.20.43",
@@ -203,16 +205,16 @@
     "@stryke/string-format": "^0.12.29",
     "@stryke/type-checks": "^0.5.14",
     "@stryke/types": "^0.10.28",
-    "powerlines": "^0.36.2"
+    "powerlines": "^0.36.3"
   },
   "devDependencies": {
     "@alloy-js/babel-preset": "^0.2.1",
     "@babel/preset-typescript": "^7.28.5",
-    "@powerlines/nx": "^0.11.28",
+    "@powerlines/nx": "^0.11.29",
     "@types/node": "^24.10.4",
     "typescript": "^5.9.3",
     "vite": "8.0.0-beta.2"
   },
   "publishConfig": { "access": "public" },
-  "gitHead": "916e24a276b03bbc9d64349bf85f37ffb43d5e87"
+  "gitHead": "0d695fa64043ba14e7c7ae8759e9e0cf5b2a6b38"
 }

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

@@ -1,15 +0,0 @@
-import { Plugin } from "../../../powerlines/src/types/plugin.cjs";
-import { PluginContext } from "../../../powerlines/src/types/context.cjs";
-import { PluginPluginAlloyOptions } from "../../../plugin-plugin/src/types/plugin.cjs";
-import { Children } from "@alloy-js/core/jsx-runtime";
-
-//#region ../alloy/src/types/plugin.d.ts
-interface AlloyPluginOptions {
-  alloy?: PluginPluginAlloyOptions;
-}
-type AlloyPluginBuilderResult<TContext extends PluginContext = PluginContext> = Plugin<TContext> & {
-  render: (this: TContext) => Children;
-};
-type AlloyPluginBuilder<TContext extends PluginContext = PluginContext, TOptions = any> = <T extends TContext>(options: TOptions) => AlloyPluginBuilderResult<T>;
-//#endregion
-export { AlloyPluginBuilder, AlloyPluginOptions };

package/dist/alloy/src/types/plugin.d.mts

@@ -1,15 +0,0 @@
-import { Plugin } from "../../../powerlines/src/types/plugin.mjs";
-import { PluginContext } from "../../../powerlines/src/types/context.mjs";
-import { PluginPluginAlloyOptions } from "../../../plugin-plugin/src/types/plugin.mjs";
-import { Children } from "@alloy-js/core/jsx-runtime";
-
-//#region ../alloy/src/types/plugin.d.ts
-interface AlloyPluginOptions {
-  alloy?: PluginPluginAlloyOptions;
-}
-type AlloyPluginBuilderResult<TContext extends PluginContext = PluginContext> = Plugin<TContext> & {
-  render: (this: TContext) => Children;
-};
-type AlloyPluginBuilder<TContext extends PluginContext = PluginContext, TOptions = any> = <T extends TContext>(options: TOptions) => AlloyPluginBuilderResult<T>;
-//#endregion
-export { AlloyPluginBuilder, AlloyPluginOptions };

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

@@ -1,21 +0,0 @@
-import { TypeDefinitionParameter } from "@stryke/types/configuration";
-import { PrintTreeOptions } from "@alloy-js/core";
-
-//#region ../plugin-plugin/src/types/plugin.d.ts
-
-type PluginPluginAlloyOptions = Partial<PrintTreeOptions> & {
-  /**
-   * If true, the Alloy framework is used to generate JSON output files.
-   *
-   * @defaultValue false
-   */
-  generatesJson?: boolean;
-  /**
-   * If true, the Alloy framework is used to generate Markdown output files.
-   *
-   * @defaultValue false
-   */
-  generatesMarkdown?: boolean;
-};
-//#endregion
-export { PluginPluginAlloyOptions };

package/dist/plugin-plugin/src/types/plugin.d.mts

@@ -1,24 +0,0 @@
-import "../../../powerlines/src/types/build.mjs";
-import "../../../powerlines/src/types/resolved.mjs";
-import "../../../powerlines/src/types/context.mjs";
-import "../../../powerlines/src/types/config.mjs";
-import { PrintTreeOptions } from "@alloy-js/core";
-import { TypeDefinitionParameter } from "@stryke/types/configuration";
-
-//#region ../plugin-plugin/src/types/plugin.d.ts
-type PluginPluginAlloyOptions = Partial<PrintTreeOptions> & {
-  /**
-   * If true, the Alloy framework is used to generate JSON output files.
-   *
-   * @defaultValue false
-   */
-  generatesJson?: boolean;
-  /**
-   * If true, the Alloy framework is used to generate Markdown output files.
-   *
-   * @defaultValue false
-   */
-  generatesMarkdown?: boolean;
-};
-//#endregion
-export { PluginPluginAlloyOptions };