@powerlines/plugin-env 0.16.237 → 0.16.240

package/dist/types/plugin.d.cts

@@ -86,7 +86,10 @@ type EnvPluginResolvedConfig = BabelPluginResolvedConfig & {
     prefix: string[];
   };
 };
-interface EnvSchemaMetadata extends SchemaMetadata {
+/**
+ * The schema for the environment variables or secrets used by the project and expected to be injected into the source code (if {@link EnvPluginOptions.inject} is true). This schema extends the base {@link ObjectSchema} with additional metadata specific to environment variables, including an `active` property that lists the environment variables or secrets that are currently active and should be injected during the build process.
+ */
+interface EnvSchema<TMetadata extends Partial<SchemaMetadata> = Partial<SchemaMetadata>> extends ObjectSchema<TMetadata> {
   /**
    * The active environment variables or secrets that are used by the project and are expected to be injected into the source code (if {@link EnvPluginOptions.inject} is true).
    */
@@ -100,14 +103,14 @@ interface EnvPluginContext<TResolvedConfig extends EnvPluginResolvedConfig = Env
      * @remarks
      * This value is parsed from the {@link EnvPluginOptions.vars} option.
      */
-    vars: ObjectSchema<EnvSchemaMetadata>;
+    vars: EnvSchema;
     /**
      * The type definition for the expected env secret parameters
      *
      * @remarks
      * This value is parsed from the {@link EnvPluginOptions.secrets} option.
      */
-    secrets: ObjectSchema<EnvSchemaMetadata>;
+    secrets: EnvSchema;
     /**
      * The parsed .env configuration object
      *
@@ -125,5 +128,5 @@ interface EnvPluginContext<TResolvedConfig extends EnvPluginResolvedConfig = Env
   };
 }
 //#endregion
-export { EnvPluginContext, EnvPluginOptions, EnvPluginResolvedConfig, EnvPluginUserConfig, EnvSchemaMetadata, EnvType };
+export { EnvPluginContext, EnvPluginOptions, EnvPluginResolvedConfig, EnvPluginUserConfig, EnvSchema, EnvType };
 //# sourceMappingURL=plugin.d.cts.map

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

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.cts","names":[],"sources":["../../src/types/plugin.ts"],"mappings":";;;;;;;;;KAmCY,OAAA;AAAA,KAEA,gBAAA,GAAmB,IAAA,CAAK,mBAAA;EAFxB;;;EAMV,IAAA,GAAO,WAAA;EANU;AAEnB;;EASE,OAAA,GAAU,WAAA;EATwB;;;;;;EAiBlC,MAAA;EAsC4B;;;;;EA/B5B,MAAA;EAfA;;;;;EAsBA,QAAA;EAQgB;;;;;;EAAhB,aAAA,GAAgB,QAAA;EAmBN;;;;;;EAXV,KAAA,GAAQ,kBAAA;EAYa;AAAA;AAGvB;;;;EAPE,MAAA,GAAS,mBAAA;AAAA;AAAA,KAGC,mBAAA,GAAsB,qBAAA;EAChC,GAAA,EAAK,gBAAgB;AAAA;AAAA,KAGX,uBAAA,GAA0B,yBAAA;EACpC,GAAA,EAAK,QAAA,CAAS,IAAA,CAAK,mBAAA,wBACjB,YAAA,CAAa,gBAAA;IAFqB;;;;;;IAShC,MAAA;IAAA;;;;AAgBM;AAIZ;IAZM,QAAA;IAYqC;;AAInC;AAGR;;;IAXM,MAAA;EAAA;AAAA;AAAA,UAIW,iBAAA,SAA0B,cAAc;EAiB/C;;;EAbR,MAAM;AAAA;AAAA,UAGS,gBAAA,yBACS,uBAAA,GAA0B,uBAAA,UAC1C,kBAAA,CAAmB,eAAA;EAC3B,GAAA;IAFA;;;;;;IASE,IAAA,EAAM,YAAA,CAAa,iBAAA;IAAb;;;;;;IAQN,OAAA,EAAS,YAAA,CAAa,iBAAA;IAgBtB;;AAAQ;;;;IARR,MAAA,EAAQ,iBAAA;;;;;;;IAQR,QAAA;EAAA;AAAA"}
+{"version":3,"file":"plugin.d.cts","names":[],"sources":["../../src/types/plugin.ts"],"mappings":";;;;;;;;;KAmCY,OAAA;AAAA,KAEA,gBAAA,GAAmB,IAAA,CAAK,mBAAA;EAFxB;;;EAMV,IAAA,GAAO,WAAA;EANU;AAEnB;;EASE,OAAA,GAAU,WAAA;EATwB;;;;;;EAiBlC,MAAA;EAsC4B;;;;;EA/B5B,MAAA;EAfA;;;;;EAsBA,QAAA;EAQgB;;;;;;EAAhB,aAAA,GAAgB,QAAA;EAmBN;;;;;;EAXV,KAAA,GAAQ,kBAAA;EAYa;AAAA;AAGvB;;;;EAPE,MAAA,GAAS,mBAAA;AAAA;AAAA,KAGC,mBAAA,GAAsB,qBAAA;EAChC,GAAA,EAAK,gBAAgB;AAAA;AAAA,KAGX,uBAAA,GAA0B,yBAAA;EACpC,GAAA,EAAK,QAAA,CAAS,IAAA,CAAK,mBAAA,wBACjB,YAAA,CAAa,gBAAA;IAFqB;;;;;;IAShC,MAAA;IAAA;;;;AAgBM;AAOZ;IAfM,QAAA;IAeoB;;;;;;IAPpB,MAAA;EAAA;AAAA;;;;UAOW,SAAA,mBACG,OAAA,CAAQ,cAAA,IAAkB,OAAA,CAAQ,cAAA,WAC5C,YAAA,CAAa,SAAA;EAD+B;;;EAKpD,MAAA;AAAA;AAAA,UAGe,gBAAA,yBACS,uBAAA,GAA0B,uBAAA,UAC1C,kBAAA,CAAmB,eAAA;EAC3B,GAAA;IAH+B;;;;;;IAU7B,IAAA,EAAM,SAAA;IAgBE;;;;;;IARR,OAAA,EAAS,SAAA;IAhBH;;;;;;IAwBN,MAAA,EAAQ,iBAAA;IAAR;;;;AAQQ;;IAAR,QAAA;EAAA;AAAA"}

package/dist/types/plugin.d.mts

@@ -1,6 +1,6 @@
 import { DotenvParseOutput } from "@stryke/env/types";
-import { Children } from "@alloy-js/core";
 import { ObjectSchema, SchemaInput, SchemaMetadata } from "@powerlines/schema";
+import { Children } from "@alloy-js/core";
 import { AutoMDPluginOptions } from "@powerlines/plugin-automd/types/plugin";
 import { BabelPluginContext, BabelPluginOptions, BabelPluginResolvedConfig, BabelPluginUserConfig } from "@powerlines/plugin-babel/types";
 import { RequiredKeys } from "@stryke/types";
@@ -86,7 +86,10 @@ type EnvPluginResolvedConfig = BabelPluginResolvedConfig & {
     prefix: string[];
   };
 };
-interface EnvSchemaMetadata extends SchemaMetadata {
+/**
+ * The schema for the environment variables or secrets used by the project and expected to be injected into the source code (if {@link EnvPluginOptions.inject} is true). This schema extends the base {@link ObjectSchema} with additional metadata specific to environment variables, including an `active` property that lists the environment variables or secrets that are currently active and should be injected during the build process.
+ */
+interface EnvSchema<TMetadata extends Partial<SchemaMetadata> = Partial<SchemaMetadata>> extends ObjectSchema<TMetadata> {
   /**
    * The active environment variables or secrets that are used by the project and are expected to be injected into the source code (if {@link EnvPluginOptions.inject} is true).
    */
@@ -100,14 +103,14 @@ interface EnvPluginContext<TResolvedConfig extends EnvPluginResolvedConfig = Env
      * @remarks
      * This value is parsed from the {@link EnvPluginOptions.vars} option.
      */
-    vars: ObjectSchema<EnvSchemaMetadata>;
+    vars: EnvSchema;
     /**
      * The type definition for the expected env secret parameters
      *
      * @remarks
      * This value is parsed from the {@link EnvPluginOptions.secrets} option.
      */
-    secrets: ObjectSchema<EnvSchemaMetadata>;
+    secrets: EnvSchema;
     /**
      * The parsed .env configuration object
      *
@@ -125,5 +128,5 @@ interface EnvPluginContext<TResolvedConfig extends EnvPluginResolvedConfig = Env
   };
 }
 //#endregion
-export { EnvPluginContext, EnvPluginOptions, EnvPluginResolvedConfig, EnvPluginUserConfig, EnvSchemaMetadata, EnvType };
+export { EnvPluginContext, EnvPluginOptions, EnvPluginResolvedConfig, EnvPluginUserConfig, EnvSchema, EnvType };
 //# sourceMappingURL=plugin.d.mts.map

package/dist/types/plugin.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.mts","names":[],"sources":["../../src/types/plugin.ts"],"mappings":";;;;;;;;;KAmCY,OAAA;AAAA,KAEA,gBAAA,GAAmB,IAAA,CAAK,mBAAA;EAFxB;;;EAMV,IAAA,GAAO,WAAA;EANU;AAEnB;;EASE,OAAA,GAAU,WAAA;EATwB;;;;;;EAiBlC,MAAA;EAsC4B;;;;;EA/B5B,MAAA;EAfA;;;;;EAsBA,QAAA;EAQgB;;;;;;EAAhB,aAAA,GAAgB,QAAA;EAmBN;;;;;;EAXV,KAAA,GAAQ,kBAAA;EAYa;AAAA;AAGvB;;;;EAPE,MAAA,GAAS,mBAAA;AAAA;AAAA,KAGC,mBAAA,GAAsB,qBAAA;EAChC,GAAA,EAAK,gBAAgB;AAAA;AAAA,KAGX,uBAAA,GAA0B,yBAAA;EACpC,GAAA,EAAK,QAAA,CAAS,IAAA,CAAK,mBAAA,wBACjB,YAAA,CAAa,gBAAA;IAFqB;;;;;;IAShC,MAAA;IAAA;;;;AAgBM;AAIZ;IAZM,QAAA;IAYqC;;AAInC;AAGR;;;IAXM,MAAA;EAAA;AAAA;AAAA,UAIW,iBAAA,SAA0B,cAAc;EAiB/C;;;EAbR,MAAM;AAAA;AAAA,UAGS,gBAAA,yBACS,uBAAA,GAA0B,uBAAA,UAC1C,kBAAA,CAAmB,eAAA;EAC3B,GAAA;IAFA;;;;;;IASE,IAAA,EAAM,YAAA,CAAa,iBAAA;IAAb;;;;;;IAQN,OAAA,EAAS,YAAA,CAAa,iBAAA;IAgBtB;;AAAQ;;;;IARR,MAAA,EAAQ,iBAAA;;;;;;;IAQR,QAAA;EAAA;AAAA"}
+{"version":3,"file":"plugin.d.mts","names":[],"sources":["../../src/types/plugin.ts"],"mappings":";;;;;;;;;KAmCY,OAAA;AAAA,KAEA,gBAAA,GAAmB,IAAA,CAAK,mBAAA;EAFxB;;;EAMV,IAAA,GAAO,WAAA;EANU;AAEnB;;EASE,OAAA,GAAU,WAAA;EATwB;;;;;;EAiBlC,MAAA;EAsC4B;;;;;EA/B5B,MAAA;EAfA;;;;;EAsBA,QAAA;EAQgB;;;;;;EAAhB,aAAA,GAAgB,QAAA;EAmBN;;;;;;EAXV,KAAA,GAAQ,kBAAA;EAYa;AAAA;AAGvB;;;;EAPE,MAAA,GAAS,mBAAA;AAAA;AAAA,KAGC,mBAAA,GAAsB,qBAAA;EAChC,GAAA,EAAK,gBAAgB;AAAA;AAAA,KAGX,uBAAA,GAA0B,yBAAA;EACpC,GAAA,EAAK,QAAA,CAAS,IAAA,CAAK,mBAAA,wBACjB,YAAA,CAAa,gBAAA;IAFqB;;;;;;IAShC,MAAA;IAAA;;;;AAgBM;AAOZ;IAfM,QAAA;IAeoB;;;;;;IAPpB,MAAA;EAAA;AAAA;;;;UAOW,SAAA,mBACG,OAAA,CAAQ,cAAA,IAAkB,OAAA,CAAQ,cAAA,WAC5C,YAAA,CAAa,SAAA;EAD+B;;;EAKpD,MAAA;AAAA;AAAA,UAGe,gBAAA,yBACS,uBAAA,GAA0B,uBAAA,UAC1C,kBAAA,CAAmB,eAAA;EAC3B,GAAA;IAH+B;;;;;;IAU7B,IAAA,EAAM,SAAA;IAgBE;;;;;;IARR,OAAA,EAAS,SAAA;IAhBH;;;;;;IAwBN,MAAA,EAAQ,iBAAA;IAAR;;;;AAQQ;;IAAR,QAAA;EAAA;AAAA"}

package/dist/types/plugin.mjs

@@ -18,6 +18,11 @@ const __ΩPick = [
 	"Pick",
 	"l+e#!e\"!fRb!b\"Pde\"\"N#!w#y"
 ];
+const __ΩPartial = [
+	"T",
+	"Partial",
+	"l+e#!e\"!fRb!Pde\"!gN#\"w\"y"
+];
 const __ΩExclude = [
 	"T",
 	"U",
@@ -74,17 +79,22 @@ const __ΩEnvPluginResolvedConfig = [
 	"EnvPluginResolvedConfig",
 	"P!PP!.#o\"#o!\"!P)4$?%)4&?'&F4(?)MK4*MKw+y"
 ];
-const __ΩEnvSchemaMetadata = [
+const __ΩEnvSchema = [
+	() => __ΩPartial,
+	"TMetadata",
 	"active",
 	"The active environment variables or secrets that are used by the project and are expected to be injected into the source code (if {@link EnvPluginOptions.inject} is true).",
-	"EnvSchemaMetadata",
-	"P!&F4!?\"Mw#y"
+	"The schema for the environment variables or secrets used by the project and expected to be injected into the source code (if {@link EnvPluginOptions.inject} is true). This schema extends the base {@link ObjectSchema} with additional metadata specific to environment variables, including an `active` property that lists the environment variables or secrets that are currently active and should be injected during the build process.",
+	"EnvSchema",
+	"!o!\"c\"P!&F4#?$M?%w&y"
 ];
 const __ΩEnvPluginContext = [
 	() => __ΩEnvPluginResolvedConfig,
 	"TResolvedConfig",
+	() => __ΩEnvSchema,
 	"vars",
 	"The type definition for the expected env variable parameters",
+	() => __ΩEnvSchema,
 	"secrets",
 	"The type definition for the expected env secret parameters",
 	"parsed",
@@ -93,9 +103,9 @@ const __ΩEnvPluginContext = [
 	"The injected environment variables and secrets reflection",
 	"env",
 	"EnvPluginContext",
-	"n!c\"P!P!4#?$!4%?&!4'?(&F4)?*M4+Mw,y"
+	"n!c\"P!Pn#4$?%n&4'?(!4)?*&F4+?,M4-Mw.y"
 ];
 
 //#endregion
-export { __ΩEnvPluginContext, __ΩEnvPluginOptions, __ΩEnvPluginResolvedConfig, __ΩEnvPluginUserConfig, __ΩEnvSchemaMetadata, __ΩEnvType };
+export { __ΩEnvPluginContext, __ΩEnvPluginOptions, __ΩEnvPluginResolvedConfig, __ΩEnvPluginUserConfig, __ΩEnvSchema, __ΩEnvType };
 //# sourceMappingURL=plugin.mjs.map

package/dist/types/plugin.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.mjs","names":[],"sources":["../../src/types/plugin.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { Children } from \"@alloy-js/core\";\nimport { AutoMDPluginOptions } from \"@powerlines/plugin-automd/types/plugin\";\nimport {\n  BabelPluginContext,\n  BabelPluginOptions,\n  BabelPluginResolvedConfig,\n  BabelPluginUserConfig\n} from \"@powerlines/plugin-babel/types\";\nimport type {\n  ObjectSchema,\n  SchemaInput,\n  SchemaMetadata\n} from \"@powerlines/schema\";\nimport type { DotenvParseOutput } from \"@stryke/env/types\";\nimport { RequiredKeys } from \"@stryke/types\";\nimport { DotenvConfiguration } from \"@stryke/types/configuration\";\n\nexport type EnvType = \"env\" | \"secrets\";\n\nexport type EnvPluginOptions = Omit<DotenvConfiguration, \"types\"> & {\n  /**\n   * A path to the type definition for the expected env configuration parameters. This value can include both a path to the typescript file and the name of the type definition to use separated by a `\":\"` or `\"#\"` character. For example: `\"./src/types/env.ts#ConfigConfiguration\"`.\n   */\n  vars?: SchemaInput;\n\n  /**\n   * A path to the type definition for the expected env secret parameters. This value can include both a path to the typescript file and the name of the type definition to use separated by a `\":\"` or `\"#\"` character. For example: `\"./src/types/env.ts#ConfigSecrets\"`.\n   */\n  secrets?: SchemaInput;\n\n  /**\n   * An additional prefix (or list of additional prefixes) to apply to the environment variables\n   *\n   * @remarks\n   * By default, the plugin will use the `POWERLINES_` prefix. This option is useful for avoiding conflicts with other environment variables.\n   */\n  prefix?: string | string[];\n\n  /**\n   * Should the plugin inject the env variables in the source code with their values?\n   *\n   * @defaultValue false\n   */\n  inject?: boolean;\n\n  /**\n   * Should the plugin validate the loaded environment variables against the provided type definitions?\n   *\n   * @defaultValue false\n   */\n  validate?: boolean;\n\n  /**\n   * The default configuration to use when loading environment variables.\n   *\n   * @remarks\n   * This configuration is used as the base configuration when loading environment variables, and will be overridden by any values found in the `.env` file or the process environment.\n   */\n  defaultConfig?: Children;\n\n  /**\n   * Babel configuration options to use when injecting environment variables into the source code.\n   *\n   * @remarks\n   * 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.\n   */\n  babel?: BabelPluginOptions;\n\n  /**\n   * AutoMD configuration options to allow injecting environment variables documentation into a markdown file such as a README.md.\n   *\n   * @remarks\n   * The README.md file should contain the `<!-- automd:env --><!-- /automd -->` comment block where the documentation will be injected.\n   */\n  automd?: AutoMDPluginOptions;\n};\n\nexport type EnvPluginUserConfig = BabelPluginUserConfig & {\n  env: EnvPluginOptions;\n};\n\nexport type EnvPluginResolvedConfig = BabelPluginResolvedConfig & {\n  env: Required<Pick<DotenvConfiguration, \"additionalFiles\">> &\n    RequiredKeys<EnvPluginOptions, \"vars\" | \"secrets\" | \"defaultConfig\"> & {\n      /**\n       * Should the plugin inject the env variables in the source code with their values?\n       *\n       * @remarks\n       * This value is the result of reflecting the {@link EnvPluginOptions.inject} option.\n       */\n      inject: boolean;\n\n      /**\n       * Should the plugin validate the loaded environment variables against the provided type definitions?\n       *\n       * @remarks\n       * This value is the result of reflecting the {@link EnvPluginOptions.validate} option.\n       */\n      validate: boolean;\n\n      /**\n       * The prefix used for environment variables\n       *\n       * @remarks\n       * This value is used to filter environment variables that are loaded from the .env file and the process environment.\n       */\n      prefix: string[];\n    };\n};\n\nexport interface EnvSchemaMetadata extends SchemaMetadata {\n  /**\n   * The active environment variables or secrets that are used by the project and are expected to be injected into the source code (if {@link EnvPluginOptions.inject} is true).\n   */\n  active: string[];\n}\n\nexport interface EnvPluginContext<\n  TResolvedConfig extends EnvPluginResolvedConfig = EnvPluginResolvedConfig\n> extends BabelPluginContext<TResolvedConfig> {\n  env: {\n    /**\n     * The type definition for the expected env variable parameters\n     *\n     * @remarks\n     * This value is parsed from the {@link EnvPluginOptions.vars} option.\n     */\n    vars: ObjectSchema<EnvSchemaMetadata>;\n\n    /**\n     * The type definition for the expected env secret parameters\n     *\n     * @remarks\n     * This value is parsed from the {@link EnvPluginOptions.secrets} option.\n     */\n    secrets: ObjectSchema<EnvSchemaMetadata>;\n\n    /**\n     * The parsed .env configuration object\n     *\n     * @remarks\n     * This value is the result of loading the .env configuration file found in the project root directory and merging it with the values provided at {@link EnvPluginOptions.values}\n     */\n    parsed: DotenvParseOutput;\n\n    /**\n     * The injected environment variables and secrets reflection\n     *\n     * @remarks\n     * This reflection contains the structure of the injected environment variables and secrets that were injected into the source code during the build process.\n     */\n    injected: string[];\n  };\n}\n"],"mappings":";AAAA,MAAM,UAAU;CAAC;CAAK;OAAW;OAAe;CAAY;CAAQ;AAAC;;;;;;AAErE,MAAM,UAAU;CAAC;CAAI;CAAM;CAAQ;AAAG;;;;;;;AAEtC,MAAM,aAAS;CAAA;CAAY;CAAW;CAAW;AAAU;AAE3D,MAAM,sBAAmB;OAAQ;CAAS;CAAK;CAAa;CAAO;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAAA;;;;;;;AAInE,MAAC,6BAAkC;OAAO;OAAmB;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAAA;AAE7D,MAAC,uBAA0B;CAAA;CAAQ;CAAkB;CAAA;AAAA;AAErD,MAAM,sBAAqB;OAAQ;CAAC;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAAA"}
+{"version":3,"file":"plugin.mjs","names":[],"sources":["../../src/types/plugin.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { Children } from \"@alloy-js/core\";\nimport { AutoMDPluginOptions } from \"@powerlines/plugin-automd/types/plugin\";\nimport {\n  BabelPluginContext,\n  BabelPluginOptions,\n  BabelPluginResolvedConfig,\n  BabelPluginUserConfig\n} from \"@powerlines/plugin-babel/types\";\nimport type {\n  ObjectSchema,\n  SchemaInput,\n  SchemaMetadata\n} from \"@powerlines/schema\";\nimport type { DotenvParseOutput } from \"@stryke/env/types\";\nimport { RequiredKeys } from \"@stryke/types\";\nimport { DotenvConfiguration } from \"@stryke/types/configuration\";\n\nexport type EnvType = \"env\" | \"secrets\";\n\nexport type EnvPluginOptions = Omit<DotenvConfiguration, \"types\"> & {\n  /**\n   * A path to the type definition for the expected env configuration parameters. This value can include both a path to the typescript file and the name of the type definition to use separated by a `\":\"` or `\"#\"` character. For example: `\"./src/types/env.ts#ConfigConfiguration\"`.\n   */\n  vars?: SchemaInput;\n\n  /**\n   * A path to the type definition for the expected env secret parameters. This value can include both a path to the typescript file and the name of the type definition to use separated by a `\":\"` or `\"#\"` character. For example: `\"./src/types/env.ts#ConfigSecrets\"`.\n   */\n  secrets?: SchemaInput;\n\n  /**\n   * An additional prefix (or list of additional prefixes) to apply to the environment variables\n   *\n   * @remarks\n   * By default, the plugin will use the `POWERLINES_` prefix. This option is useful for avoiding conflicts with other environment variables.\n   */\n  prefix?: string | string[];\n\n  /**\n   * Should the plugin inject the env variables in the source code with their values?\n   *\n   * @defaultValue false\n   */\n  inject?: boolean;\n\n  /**\n   * Should the plugin validate the loaded environment variables against the provided type definitions?\n   *\n   * @defaultValue false\n   */\n  validate?: boolean;\n\n  /**\n   * The default configuration to use when loading environment variables.\n   *\n   * @remarks\n   * This configuration is used as the base configuration when loading environment variables, and will be overridden by any values found in the `.env` file or the process environment.\n   */\n  defaultConfig?: Children;\n\n  /**\n   * Babel configuration options to use when injecting environment variables into the source code.\n   *\n   * @remarks\n   * 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.\n   */\n  babel?: BabelPluginOptions;\n\n  /**\n   * AutoMD configuration options to allow injecting environment variables documentation into a markdown file such as a README.md.\n   *\n   * @remarks\n   * The README.md file should contain the `<!-- automd:env --><!-- /automd -->` comment block where the documentation will be injected.\n   */\n  automd?: AutoMDPluginOptions;\n};\n\nexport type EnvPluginUserConfig = BabelPluginUserConfig & {\n  env: EnvPluginOptions;\n};\n\nexport type EnvPluginResolvedConfig = BabelPluginResolvedConfig & {\n  env: Required<Pick<DotenvConfiguration, \"additionalFiles\">> &\n    RequiredKeys<EnvPluginOptions, \"vars\" | \"secrets\" | \"defaultConfig\"> & {\n      /**\n       * Should the plugin inject the env variables in the source code with their values?\n       *\n       * @remarks\n       * This value is the result of reflecting the {@link EnvPluginOptions.inject} option.\n       */\n      inject: boolean;\n\n      /**\n       * Should the plugin validate the loaded environment variables against the provided type definitions?\n       *\n       * @remarks\n       * This value is the result of reflecting the {@link EnvPluginOptions.validate} option.\n       */\n      validate: boolean;\n\n      /**\n       * The prefix used for environment variables\n       *\n       * @remarks\n       * This value is used to filter environment variables that are loaded from the .env file and the process environment.\n       */\n      prefix: string[];\n    };\n};\n\n/**\n * The schema for the environment variables or secrets used by the project and expected to be injected into the source code (if {@link EnvPluginOptions.inject} is true). This schema extends the base {@link ObjectSchema} with additional metadata specific to environment variables, including an `active` property that lists the environment variables or secrets that are currently active and should be injected during the build process.\n */\nexport interface EnvSchema<\n  TMetadata extends Partial<SchemaMetadata> = Partial<SchemaMetadata>\n> extends ObjectSchema<TMetadata> {\n  /**\n   * The active environment variables or secrets that are used by the project and are expected to be injected into the source code (if {@link EnvPluginOptions.inject} is true).\n   */\n  active: string[];\n}\n\nexport interface EnvPluginContext<\n  TResolvedConfig extends EnvPluginResolvedConfig = EnvPluginResolvedConfig\n> extends BabelPluginContext<TResolvedConfig> {\n  env: {\n    /**\n     * The type definition for the expected env variable parameters\n     *\n     * @remarks\n     * This value is parsed from the {@link EnvPluginOptions.vars} option.\n     */\n    vars: EnvSchema;\n\n    /**\n     * The type definition for the expected env secret parameters\n     *\n     * @remarks\n     * This value is parsed from the {@link EnvPluginOptions.secrets} option.\n     */\n    secrets: EnvSchema;\n\n    /**\n     * The parsed .env configuration object\n     *\n     * @remarks\n     * This value is the result of loading the .env configuration file found in the project root directory and merging it with the values provided at {@link EnvPluginOptions.values}\n     */\n    parsed: DotenvParseOutput;\n\n    /**\n     * The injected environment variables and secrets reflection\n     *\n     * @remarks\n     * This reflection contains the structure of the injected environment variables and secrets that were injected into the source code during the build process.\n     */\n    injected: string[];\n  };\n}\n"],"mappings":";AAAA,MAAM,UAAU;CAAC;CAAK;OAAW;OAAe;CAAY;CAAQ;AAAC;;;;;;AAErE,MAAM,UAAU;CAAC;CAAI;CAAM;CAAQ;AAAG;;;;;;AAEtC,MAAM,aAAS;CAAA;CAAS;CAAG;CAAY;AAAoB;AAC3D,MAAI,aAAc;CAAA;CAAM;CAAc;CAAW;AAAK;AAEtD,MAAK,sBAAuB;OAAG;CAAa;CAAK;CAAS;CAAmB;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAAA;AAE7E,MAAC,yBAA0B;OAAQ;CAAc;CAAA;CAAA;AAAA;AAEjD,MAAC,6BAAkC;OAAK;OAAkB;CAAS;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@powerlines/plugin-env",
-  "version": "0.16.237",
+  "version": "0.16.240",
   "private": false,
   "description": "A package containing a Powerlines plugin for injecting static .env configuration values to the code so that they're accessible at runtime.",
   "keywords": ["dotenv", "powerlines", "storm-software", "powerlines-plugin"],
@@ -107,12 +107,12 @@
     "@alloy-js/typescript": "^0.23.0",
     "@babel/core": "8.0.0-rc.5",
     "@babel/types": "8.0.0-rc.5",
-    "@powerlines/core": "^0.15.22",
-    "@powerlines/plugin-alloy": "^0.26.129",
-    "@powerlines/plugin-automd": "^0.1.506",
-    "@powerlines/plugin-babel": "^0.13.41",
-    "@powerlines/plugin-plugin": "^0.12.457",
-    "@powerlines/schema": "^0.11.24",
+    "@powerlines/core": "^0.15.24",
+    "@powerlines/plugin-alloy": "^0.26.132",
+    "@powerlines/plugin-automd": "^0.1.508",
+    "@powerlines/plugin-babel": "^0.13.43",
+    "@powerlines/plugin-plugin": "^0.12.459",
+    "@powerlines/schema": "^0.11.27",
     "@storm-software/config-tools": "^1.190.20",
     "@stryke/capnp": "^0.12.102",
     "@stryke/convert": "^0.7.7",
@@ -127,9 +127,9 @@
     "automd": "^0.4.3",
     "c12": "^3.3.4",
     "defu": "^6.1.7",
-    "powerlines": "^0.47.45"
+    "powerlines": "^0.47.47"
   },
   "devDependencies": { "@types/node": "^25.9.0", "vite": "^8.0.13" },
   "publishConfig": { "access": "public" },
-  "gitHead": "7fb37a42aa27f6cbc6b7412e259d0f7a79bac8ed"
+  "gitHead": "fa8c4ae579471be5f678883ecb35d00ea17c29ba"
 }