envapt 7.0.0-next.0 → 7.0.0-next.2

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # envapt
 
+## 7.0.0-next.2
+
+### Patch Changes
+
+- 5384199: The `envapt/browser` and `envapt/workerd` builds are now side-effect-free, so a bundler can drop the parts of envapt a consumer never imports. Importing a single export such as `EnvaptError` or `Converters` from the portable builds now ships about 1.3 kB instead of about 22 kB. The filesystem-only APIs (`envPaths`, `baseDir`, `envFileOptions`, `configureProfiles`, `resetProfiles`) still throw `EnvaptError` on the browser and Workers builds, their stubs moved onto the portable `Envapter` class so they install only when that class is used.
+
+## 7.0.0-next.1
+
+### Patch Changes
+
+- 0bbcc85: Editor auto-import now suggests each public name once instead of once per runtime build. The published type declarations are emitted as a single shared tree that the Node, Workers, and browser entry points all re-export, so `Envapt`, `Envapter`, the converters, and the rest resolve to one declaration. The Workers and browser entries still expose the portable `Envapter` without the file-only APIs. The package no longer ships the redundant per-runtime declaration trees, so the install is smaller.
+
 ## 7.0.0-next.0
 
 ### Major Changes

package/dist/browser/engine/PortableEnvapter.mjs

@@ -0,0 +1,2 @@
+import{Envapter as e}from"./Envapter.mjs";import{installFileApiStubs as t}from"./installFileApiStubs.mjs";var n=class n extends e{static{t(n)}};export{n as PortableEnvapter};
+//# sourceMappingURL=PortableEnvapter.mjs.map

package/dist/browser/engine/PortableEnvapter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"PortableEnvapter.mjs","names":[],"sources":["../../../src/engine/PortableEnvapter.ts"],"sourcesContent":["import { Envapter } from './Envapter';\nimport { installFileApiStubs } from './installFileApiStubs';\n\n/**\n * The browser/Workers facade. {@link Envapter} with the filesystem-only configuration APIs\n * (`envPaths`, `baseDir`, `envFileOptions`, `configureProfiles`, `resetProfiles`) stubbed to throw\n * {@link EnvaptError}. The portable types omit those APIs, so the stubs only guard JS callers that\n * bypass the types.\n * @public\n */\nexport class PortableEnvapter extends Envapter {\n    // A static block (not a top-level statement in a separate entry) keeps the stub install intrinsic to\n    // this class, so it tree-shakes out of a leaf import and needs no sideEffects entry. Depends on the\n    // es2022 native static-block emit, lowering the target defeats it.\n    static {\n        installFileApiStubs(PortableEnvapter);\n    }\n}\n"],"mappings":"0GAUA,IAAa,EAAb,MAAa,UAAyB,CAAS,CAI3C,OACI,EAAoB,CAAgB,CACxC,CACJ"}

package/dist/browser/engine/installFileApiStubs.mjs

@@ -1,2 +1,2 @@
-import{EnvaptError as e}from"../infra/Error.mjs";import{Envapter as t}from"./Envapter.mjs";const n=[`envPaths`,`baseDir`,`envFileOptions`,`configureProfiles`,`resetProfiles`];function r(t){throw new e(306,`Envapter.${t} requires a filesystem-backed source and is not available in this build.`)}function i(){for(let e of n)Object.defineProperty(t,e,{configurable:!0,get:()=>r(e),set:()=>r(e)})}export{i as installFileApiStubs};
+import{EnvaptError as e}from"../infra/Error.mjs";const t=[`envPaths`,`baseDir`,`envFileOptions`,`configureProfiles`,`resetProfiles`];function n(t){throw new e(306,`Envapter.${t} requires a filesystem-backed source and is not available in this build.`)}function r(e){for(let r of t)Object.defineProperty(e,r,{configurable:!0,get:()=>n(r),set:()=>n(r)})}export{r as installFileApiStubs};
 //# sourceMappingURL=installFileApiStubs.mjs.map

package/dist/browser/engine/installFileApiStubs.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"installFileApiStubs.mjs","names":[],"sources":["../../../src/engine/installFileApiStubs.ts"],"sourcesContent":["import { Envapter } from './Envapter';\nimport { EnvaptError, EnvaptErrorCodes } from '../infra/Error';\n\nconst FILE_ONLY_APIS = ['envPaths', 'baseDir', 'envFileOptions', 'configureProfiles', 'resetProfiles'] as const;\n\nfunction fileApiUnsupported(api: string): never {\n    throw new EnvaptError(\n        EnvaptErrorCodes.FileApiUnsupported,\n        `Envapter.${api} requires a filesystem-backed source and is not available in this build.`\n    );\n}\n\n// Call from each entry's own top level, not via `export * from` another entry: the build tree-shakes a\n// re-exported entry's side effect away, which would silently drop these stubs from that entry's output.\nexport function installFileApiStubs(): void {\n    for (const api of FILE_ONLY_APIS) {\n        Object.defineProperty(Envapter, api, {\n            configurable: true,\n            get: () => fileApiUnsupported(api),\n            set: () => fileApiUnsupported(api)\n        });\n    }\n}\n"],"mappings":"2FAGA,MAAM,EAAiB,CAAC,WAAY,UAAW,iBAAkB,oBAAqB,eAAe,EAErG,SAAS,EAAmB,EAAoB,CAC5C,MAAM,IAAI,EAAA,IAEN,YAAY,EAAI,yEACpB,CACJ,CAIA,SAAgB,GAA4B,CACxC,IAAK,IAAM,KAAO,EACd,OAAO,eAAe,EAAU,EAAK,CACjC,aAAc,GACd,QAAW,EAAmB,CAAG,EACjC,QAAW,EAAmB,CAAG,CACrC,CAAC,CAET"}
+{"version":3,"file":"installFileApiStubs.mjs","names":[],"sources":["../../../src/engine/installFileApiStubs.ts"],"sourcesContent":["import { EnvaptError, EnvaptErrorCodes } from '../infra/Error';\n\nconst FILE_ONLY_APIS = ['envPaths', 'baseDir', 'envFileOptions', 'configureProfiles', 'resetProfiles'] as const;\n\nfunction fileApiUnsupported(api: string): never {\n    throw new EnvaptError(\n        EnvaptErrorCodes.FileApiUnsupported,\n        `Envapter.${api} requires a filesystem-backed source and is not available in this build.`\n    );\n}\n\n// Call from a class static block, not an entry top level, or the build drops the stubs from a\n// re-exported entry as a tree-shaken side effect.\nexport function installFileApiStubs(target: object): void {\n    for (const api of FILE_ONLY_APIS) {\n        Object.defineProperty(target, api, {\n            configurable: true,\n            get: () => fileApiUnsupported(api),\n            set: () => fileApiUnsupported(api)\n        });\n    }\n}\n"],"mappings":"iDAEA,MAAM,EAAiB,CAAC,WAAY,UAAW,iBAAkB,oBAAqB,eAAe,EAErG,SAAS,EAAmB,EAAoB,CAC5C,MAAM,IAAI,EAAA,IAEN,YAAY,EAAI,yEACpB,CACJ,CAIA,SAAgB,EAAoB,EAAsB,CACtD,IAAK,IAAM,KAAO,EACd,OAAO,eAAe,EAAQ,EAAK,CAC/B,aAAc,GACd,QAAW,EAAmB,CAAG,EACjC,QAAW,EAAmB,CAAG,CACrC,CAAC,CAET"}

package/dist/browser/index.mjs

@@ -1,2 +1 @@
-import{Converters as e,isArrayOf as t}from"./converters/Converters.mjs";import{EnvaptError as n,EnvaptErrorCodes as r}from"./infra/Error.mjs";import{Environment as i}from"./core/EnvironmentMethods.mjs";import{Envapter as a}from"./engine/Envapter.mjs";import{installFileApiStubs as o}from"./engine/installFileApiStubs.mjs";import{ManualEnvSource as s}from"./sources/ManualEnvSource.mjs";import{WorkerEnvSource as c}from"./sources/WorkerEnvSource.mjs";import{Envapt as l}from"./decorators/modern/Envapt.mjs";import{EnvBool as u,EnvNum as d,EnvStr as f,EnvTime as p,EnvUrl as m}from"./decorators/modern/SugarDecorators.mjs";o();export{e as Converters,u as EnvBool,d as EnvNum,f as EnvStr,p as EnvTime,m as EnvUrl,l as Envapt,n as EnvaptError,r as EnvaptErrorCodes,a as Envapter,i as Environment,s as ManualEnvSource,c as WorkerEnvSource,t as isArrayOf};
-//# sourceMappingURL=index.mjs.map
+import{Converters as e,isArrayOf as t}from"./converters/Converters.mjs";import{EnvaptError as n,EnvaptErrorCodes as r}from"./infra/Error.mjs";import{Environment as i}from"./core/EnvironmentMethods.mjs";import{ManualEnvSource as a}from"./sources/ManualEnvSource.mjs";import{WorkerEnvSource as o}from"./sources/WorkerEnvSource.mjs";import{Envapt as s}from"./decorators/modern/Envapt.mjs";import{EnvBool as c,EnvNum as l,EnvStr as u,EnvTime as d,EnvUrl as f}from"./decorators/modern/SugarDecorators.mjs";import{PortableEnvapter as p}from"./engine/PortableEnvapter.mjs";export{e as Converters,c as EnvBool,l as EnvNum,u as EnvStr,d as EnvTime,f as EnvUrl,s as Envapt,n as EnvaptError,r as EnvaptErrorCodes,p as Envapter,i as Environment,a as ManualEnvSource,o as WorkerEnvSource,t as isArrayOf};

package/dist/{node → types}/engine/NodeEnvapter.d.mts

@@ -1,5 +1,3 @@
-import __tsdown_shims_path from 'node:path';
-import __tsdown_shims_url from 'node:url';
 import { EnvFileOptions } from "../infra/Dotenv.mjs";
 import { ProfilesConfig } from "../types/Options.mjs";
 import { Envapter } from "./Envapter.mjs";

package/dist/types/engine/PortableEnvapter.d.mts

@@ -0,0 +1,14 @@
+import { Envapter } from "./Envapter.mjs";
+
+//#region src/engine/PortableEnvapter.d.ts
+/**
+ * The browser/Workers facade. {@link Envapter} with the filesystem-only configuration APIs
+ * (`envPaths`, `baseDir`, `envFileOptions`, `configureProfiles`, `resetProfiles`) stubbed to throw
+ * {@link EnvaptError}. The portable types omit those APIs, so the stubs only guard JS callers that
+ * bypass the types.
+ * @public
+ */
+declare class PortableEnvapter extends Envapter {}
+//#endregion
+export { PortableEnvapter };
+//# sourceMappingURL=PortableEnvapter.d.mts.map

package/dist/{node → types}/index.d.mts

@@ -1,5 +1,3 @@
-import __tsdown_shims_path from 'node:path';
-import __tsdown_shims_url from 'node:url';
 import { DebugLevel } from "./infra/Debug.mjs";
 import { EnvFileOptions } from "./infra/Dotenv.mjs";
 import { ArrayElement, ArrayOf, ConverterToken, Converters, CustomElementConverter, isArrayOf } from "./converters/Converters.mjs";

package/dist/{browser/index.d.mts → types/index.portable.d.mts}

@@ -9,10 +9,10 @@ import { EnvProfile, EnvaptOptions, ProfilesConfig } from "./types/Options.mjs";
 import { EnvKeyInput } from "./types/Env.mjs";
 import { BareEnvSource, EnvSource, FileEnvSource } from "./types/Source.mjs";
 import { EnvaptAccessorDecorator, EnvaptFieldDecorator } from "./types/Decorator.mjs";
-import { Envapter } from "./engine/Envapter.mjs";
 import { ManualEnvSource } from "./sources/ManualEnvSource.mjs";
 import { WorkerEnvSource } from "./sources/WorkerEnvSource.mjs";
 import { EnvaptError, EnvaptErrorCodes } from "./infra/Error.mjs";
 import { Envapt } from "./decorators/modern/Envapt.mjs";
 import { EnvBool, EnvNum, EnvStr, EnvTime, EnvUrl } from "./decorators/modern/SugarDecorators.mjs";
-export { type AdvancedConverterReturn, type ArrayElement, type ArrayOf, type BareEnvSource, type BuiltInConverter, type BuiltInConverterFunction, type ConditionalReturn, type ConverterFunction, type ConverterToken, Converters, type CustomElementConverter, type DebugLevel, EnvBool, type EnvFileOptions, type EnvKeyInput, EnvNum, type EnvProfile, type EnvSource, EnvStr, EnvTime, EnvUrl, Envapt, type EnvaptAccessorDecorator, type EnvaptConverter, EnvaptError, EnvaptErrorCodes, type EnvaptFieldDecorator, type EnvaptOptions, Envapter, Environment, type Err, type FileEnvSource, type InferConverterFallbackType, type InferConverterReturnType, type InferPrimitiveReturnType, type InferSchemaInput, type InferSchemaOutput, type JsonValue, ManualEnvSource, type MapOfConverterFunctions, type PrimitiveConstructor, type ProfilesConfig, type SchemaConstraint, type SchemaMustBeSync, type StandardSchemaV1, type TimeFallback, type TimeUnit, WorkerEnvSource, isArrayOf };
+import { PortableEnvapter } from "./engine/PortableEnvapter.mjs";
+export { type AdvancedConverterReturn, type ArrayElement, type ArrayOf, type BareEnvSource, type BuiltInConverter, type BuiltInConverterFunction, type ConditionalReturn, type ConverterFunction, type ConverterToken, Converters, type CustomElementConverter, type DebugLevel, EnvBool, type EnvFileOptions, type EnvKeyInput, EnvNum, type EnvProfile, type EnvSource, EnvStr, EnvTime, EnvUrl, Envapt, type EnvaptAccessorDecorator, type EnvaptConverter, EnvaptError, EnvaptErrorCodes, type EnvaptFieldDecorator, type EnvaptOptions, PortableEnvapter as Envapter, Environment, type Err, type FileEnvSource, type InferConverterFallbackType, type InferConverterReturnType, type InferPrimitiveReturnType, type InferSchemaInput, type InferSchemaOutput, type JsonValue, ManualEnvSource, type MapOfConverterFunctions, type PrimitiveConstructor, type ProfilesConfig, type SchemaConstraint, type SchemaMustBeSync, type StandardSchemaV1, type TimeFallback, type TimeUnit, WorkerEnvSource, isArrayOf };

package/dist/{node/sources/NodeEnvSource.d.cts → types/sources/NodeEnvSource.d.mts}

@@ -1,4 +1,4 @@
-import { FileEnvSource } from "../types/Source.cjs";
+import { FileEnvSource } from "../types/Source.mjs";
 
 //#region src/sources/NodeEnvSource.d.ts
 /**
@@ -17,4 +17,4 @@ declare class NodeEnvSource implements FileEnvSource {
 }
 //#endregion
 export { NodeEnvSource };
-//# sourceMappingURL=NodeEnvSource.d.cts.map
+//# sourceMappingURL=NodeEnvSource.d.mts.map

package/dist/workerd/engine/PortableEnvapter.mjs

@@ -0,0 +1,2 @@
+import{Envapter as e}from"./Envapter.mjs";import{installFileApiStubs as t}from"./installFileApiStubs.mjs";var n=class n extends e{static{t(n)}};export{n as PortableEnvapter};
+//# sourceMappingURL=PortableEnvapter.mjs.map

package/dist/workerd/engine/PortableEnvapter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"PortableEnvapter.mjs","names":[],"sources":["../../../src/engine/PortableEnvapter.ts"],"sourcesContent":["import { Envapter } from './Envapter';\nimport { installFileApiStubs } from './installFileApiStubs';\n\n/**\n * The browser/Workers facade. {@link Envapter} with the filesystem-only configuration APIs\n * (`envPaths`, `baseDir`, `envFileOptions`, `configureProfiles`, `resetProfiles`) stubbed to throw\n * {@link EnvaptError}. The portable types omit those APIs, so the stubs only guard JS callers that\n * bypass the types.\n * @public\n */\nexport class PortableEnvapter extends Envapter {\n    // A static block (not a top-level statement in a separate entry) keeps the stub install intrinsic to\n    // this class, so it tree-shakes out of a leaf import and needs no sideEffects entry. Depends on the\n    // es2022 native static-block emit, lowering the target defeats it.\n    static {\n        installFileApiStubs(PortableEnvapter);\n    }\n}\n"],"mappings":"0GAUA,IAAa,EAAb,MAAa,UAAyB,CAAS,CAI3C,OACI,EAAoB,CAAgB,CACxC,CACJ"}

package/dist/workerd/engine/installFileApiStubs.mjs

@@ -1,2 +1,2 @@
-import{EnvaptError as e}from"../infra/Error.mjs";import{Envapter as t}from"./Envapter.mjs";const n=[`envPaths`,`baseDir`,`envFileOptions`,`configureProfiles`,`resetProfiles`];function r(t){throw new e(306,`Envapter.${t} requires a filesystem-backed source and is not available in this build.`)}function i(){for(let e of n)Object.defineProperty(t,e,{configurable:!0,get:()=>r(e),set:()=>r(e)})}export{i as installFileApiStubs};
+import{EnvaptError as e}from"../infra/Error.mjs";const t=[`envPaths`,`baseDir`,`envFileOptions`,`configureProfiles`,`resetProfiles`];function n(t){throw new e(306,`Envapter.${t} requires a filesystem-backed source and is not available in this build.`)}function r(e){for(let r of t)Object.defineProperty(e,r,{configurable:!0,get:()=>n(r),set:()=>n(r)})}export{r as installFileApiStubs};
 //# sourceMappingURL=installFileApiStubs.mjs.map

package/dist/workerd/engine/installFileApiStubs.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"installFileApiStubs.mjs","names":[],"sources":["../../../src/engine/installFileApiStubs.ts"],"sourcesContent":["import { Envapter } from './Envapter';\nimport { EnvaptError, EnvaptErrorCodes } from '../infra/Error';\n\nconst FILE_ONLY_APIS = ['envPaths', 'baseDir', 'envFileOptions', 'configureProfiles', 'resetProfiles'] as const;\n\nfunction fileApiUnsupported(api: string): never {\n    throw new EnvaptError(\n        EnvaptErrorCodes.FileApiUnsupported,\n        `Envapter.${api} requires a filesystem-backed source and is not available in this build.`\n    );\n}\n\n// Call from each entry's own top level, not via `export * from` another entry: the build tree-shakes a\n// re-exported entry's side effect away, which would silently drop these stubs from that entry's output.\nexport function installFileApiStubs(): void {\n    for (const api of FILE_ONLY_APIS) {\n        Object.defineProperty(Envapter, api, {\n            configurable: true,\n            get: () => fileApiUnsupported(api),\n            set: () => fileApiUnsupported(api)\n        });\n    }\n}\n"],"mappings":"2FAGA,MAAM,EAAiB,CAAC,WAAY,UAAW,iBAAkB,oBAAqB,eAAe,EAErG,SAAS,EAAmB,EAAoB,CAC5C,MAAM,IAAI,EAAA,IAEN,YAAY,EAAI,yEACpB,CACJ,CAIA,SAAgB,GAA4B,CACxC,IAAK,IAAM,KAAO,EACd,OAAO,eAAe,EAAU,EAAK,CACjC,aAAc,GACd,QAAW,EAAmB,CAAG,EACjC,QAAW,EAAmB,CAAG,CACrC,CAAC,CAET"}
+{"version":3,"file":"installFileApiStubs.mjs","names":[],"sources":["../../../src/engine/installFileApiStubs.ts"],"sourcesContent":["import { EnvaptError, EnvaptErrorCodes } from '../infra/Error';\n\nconst FILE_ONLY_APIS = ['envPaths', 'baseDir', 'envFileOptions', 'configureProfiles', 'resetProfiles'] as const;\n\nfunction fileApiUnsupported(api: string): never {\n    throw new EnvaptError(\n        EnvaptErrorCodes.FileApiUnsupported,\n        `Envapter.${api} requires a filesystem-backed source and is not available in this build.`\n    );\n}\n\n// Call from a class static block, not an entry top level, or the build drops the stubs from a\n// re-exported entry as a tree-shaken side effect.\nexport function installFileApiStubs(target: object): void {\n    for (const api of FILE_ONLY_APIS) {\n        Object.defineProperty(target, api, {\n            configurable: true,\n            get: () => fileApiUnsupported(api),\n            set: () => fileApiUnsupported(api)\n        });\n    }\n}\n"],"mappings":"iDAEA,MAAM,EAAiB,CAAC,WAAY,UAAW,iBAAkB,oBAAqB,eAAe,EAErG,SAAS,EAAmB,EAAoB,CAC5C,MAAM,IAAI,EAAA,IAEN,YAAY,EAAI,yEACpB,CACJ,CAIA,SAAgB,EAAoB,EAAsB,CACtD,IAAK,IAAM,KAAO,EACd,OAAO,eAAe,EAAQ,EAAK,CAC/B,aAAc,GACd,QAAW,EAAmB,CAAG,EACjC,QAAW,EAAmB,CAAG,CACrC,CAAC,CAET"}

package/dist/workerd/index.mjs

@@ -1,2 +1 @@
-import{Converters as e,isArrayOf as t}from"./converters/Converters.mjs";import{EnvaptError as n,EnvaptErrorCodes as r}from"./infra/Error.mjs";import{Environment as i}from"./core/EnvironmentMethods.mjs";import{Envapter as a}from"./engine/Envapter.mjs";import{installFileApiStubs as o}from"./engine/installFileApiStubs.mjs";import{ManualEnvSource as s}from"./sources/ManualEnvSource.mjs";import{WorkerEnvSource as c}from"./sources/WorkerEnvSource.mjs";import{Envapt as l}from"./decorators/modern/Envapt.mjs";import{EnvBool as u,EnvNum as d,EnvStr as f,EnvTime as p,EnvUrl as m}from"./decorators/modern/SugarDecorators.mjs";o();export{e as Converters,u as EnvBool,d as EnvNum,f as EnvStr,p as EnvTime,m as EnvUrl,l as Envapt,n as EnvaptError,r as EnvaptErrorCodes,a as Envapter,i as Environment,s as ManualEnvSource,c as WorkerEnvSource,t as isArrayOf};
-//# sourceMappingURL=index.mjs.map
+import{Converters as e,isArrayOf as t}from"./converters/Converters.mjs";import{EnvaptError as n,EnvaptErrorCodes as r}from"./infra/Error.mjs";import{Environment as i}from"./core/EnvironmentMethods.mjs";import{ManualEnvSource as a}from"./sources/ManualEnvSource.mjs";import{WorkerEnvSource as o}from"./sources/WorkerEnvSource.mjs";import{Envapt as s}from"./decorators/modern/Envapt.mjs";import{EnvBool as c,EnvNum as l,EnvStr as u,EnvTime as d,EnvUrl as f}from"./decorators/modern/SugarDecorators.mjs";import{PortableEnvapter as p}from"./engine/PortableEnvapter.mjs";export{e as Converters,c as EnvBool,l as EnvNum,u as EnvStr,d as EnvTime,f as EnvUrl,s as Envapt,n as EnvaptError,r as EnvaptErrorCodes,p as Envapter,i as Environment,a as ManualEnvSource,o as WorkerEnvSource,t as isArrayOf};

package/package.json

@@ -1,84 +1,84 @@
 {
   "name": "envapt",
   "type": "module",
-  "version": "7.0.0-next.0",
+  "version": "7.0.0-next.2",
   "description": "Type-safe config for TypeScript. Read typed values from any source, process.env, .env files, Cloudflare Workers bindings, browser bundles, or any object you supply. Zero runtime dependencies, one API across Node, Bun, Deno, Workers, and the browser. TC39 accessor decorators (legacy decorators at envapt/legacy), converters, and Standard Schema (zod/valibot/arktype) validation.",
-  "types": "./dist/node/index.d.mts",
+  "types": "./dist/types/index.d.mts",
   "exports": {
     ".": {
       "workerd": {
-        "types": "./dist/workerd/index.d.mts",
+        "types": "./dist/types/index.portable.d.mts",
         "default": "./dist/workerd/index.mjs"
       },
       "browser": {
-        "types": "./dist/browser/index.d.mts",
+        "types": "./dist/types/index.portable.d.mts",
         "default": "./dist/browser/index.mjs"
       },
       "node": {
         "import": {
-          "types": "./dist/node/index.d.mts",
+          "types": "./dist/types/index.d.mts",
           "default": "./dist/node/index.mjs"
         },
         "require": {
-          "types": "./dist/node/index.d.cts",
+          "types": "./dist/types/index.d.mts",
           "default": "./dist/node/index.cjs"
         }
       },
       "default": {
         "import": {
-          "types": "./dist/node/index.d.mts",
+          "types": "./dist/types/index.d.mts",
           "default": "./dist/node/index.mjs"
         },
         "require": {
-          "types": "./dist/node/index.d.cts",
+          "types": "./dist/types/index.d.mts",
           "default": "./dist/node/index.cjs"
         }
       }
     },
     "./workerd": {
-      "types": "./dist/workerd/index.d.mts",
+      "types": "./dist/types/index.portable.d.mts",
       "default": "./dist/workerd/index.mjs"
     },
     "./browser": {
-      "types": "./dist/browser/index.d.mts",
+      "types": "./dist/types/index.portable.d.mts",
       "default": "./dist/browser/index.mjs"
     },
     "./config": {
       "import": {
-        "types": "./dist/node/config.d.mts",
+        "types": "./dist/types/config.d.mts",
         "default": "./dist/node/config.mjs"
       },
       "require": {
-        "types": "./dist/node/config.d.cts",
+        "types": "./dist/types/config.d.mts",
         "default": "./dist/node/config.cjs"
       }
     },
     "./legacy": {
       "workerd": {
-        "types": "./dist/workerd/legacy.d.mts",
+        "types": "./dist/types/legacy.d.mts",
         "default": "./dist/workerd/legacy.mjs"
       },
       "browser": {
-        "types": "./dist/browser/legacy.d.mts",
+        "types": "./dist/types/legacy.d.mts",
         "default": "./dist/browser/legacy.mjs"
       },
       "node": {
         "import": {
-          "types": "./dist/node/legacy.d.mts",
+          "types": "./dist/types/legacy.d.mts",
           "default": "./dist/node/legacy.mjs"
         },
         "require": {
-          "types": "./dist/node/legacy.d.cts",
+          "types": "./dist/types/legacy.d.mts",
           "default": "./dist/node/legacy.cjs"
         }
       },
       "default": {
         "import": {
-          "types": "./dist/node/legacy.d.mts",
+          "types": "./dist/types/legacy.d.mts",
           "default": "./dist/node/legacy.mjs"
         },
         "require": {
-          "types": "./dist/node/legacy.d.cts",
+          "types": "./dist/types/legacy.d.mts",
           "default": "./dist/node/legacy.cjs"
         }
       }
@@ -86,12 +86,13 @@
   },
   "sideEffects": [
     "./dist/node/config.cjs",
-    "./dist/node/config.mjs",
-    "./dist/browser/index.mjs",
-    "./dist/workerd/index.mjs"
+    "./dist/node/config.mjs"
   ],
   "files": [
-    "dist",
+    "dist/**/*.mjs",
+    "dist/**/*.cjs",
+    "dist/**/*.map",
+    "dist/types",
     "NOTICE.md",
     "LICENSE",
     "README.md",
@@ -168,6 +169,8 @@
     "test:workers": "tsc --noEmit -p tests/workers/tsconfig.json && vitest run --config vitest.workers.config.ts",
     "test:browser": "tsc --noEmit -p tests/browser/tsconfig.json && vitest run --config vitest.browser.config.ts",
     "test:consumer-build": "node tests/consumer-build/run.mjs",
+    "test:tree-shaking": "node tests/tree-shaking/run.mjs",
+    "test:exports-dedup": "node tests/exports-dedup/run.mjs",
     "test:tsc-emit": "node tests/tsc-emit/run.mjs",
     "test:stage3-emit": "node tests/stage3-emit/run.mjs",
     "test:all": "node ../../scripts/test-all.mjs",

package/dist/browser/index.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../src/browser.ts"],"sourcesContent":["import { Envapter } from './engine/Envapter';\nimport { installFileApiStubs } from './engine/installFileApiStubs';\n\nexport * from './common';\nexport * from './decorators/modern';\nexport { Envapter };\n\ninstallFileApiStubs();\n"],"mappings":"6mBAOA,EAAoB"}

package/dist/node/config.d.mts

@@ -1,2 +0,0 @@
-import __tsdown_shims_path from 'node:path';
-import __tsdown_shims_url from 'node:url';

package/dist/node/converters/Converters.d.cts

@@ -1,93 +0,0 @@
-//#region src/converters/Converters.d.ts
-declare const SCALAR: {
-  readonly String: "string";
-  readonly Number: "number";
-  readonly Boolean: "boolean";
-  readonly Bigint: "bigint";
-  readonly Symbol: "symbol";
-  readonly Integer: "integer";
-  readonly Float: "float";
-  readonly Json: "json";
-  readonly Url: "url";
-  readonly Regexp: "regexp";
-  readonly Date: "date";
-  readonly Time: "time";
-};
-/**
- * String tokens for every built-in scalar converter.
- * @public
- */
-type ConverterToken = (typeof SCALAR)[keyof typeof SCALAR];
-/**
- * Custom element converter for use inside {@link Converters.array}. Receives the trimmed,
- * non-empty raw string for one array slot and returns the parsed value.
- * @public
- */
-type CustomElementConverter<TReturn = unknown> = (raw: string) => TReturn;
-/**
- * Valid element converters for {@link Converters.array}: any scalar token except
- * `json` and `regexp` (those don't compose as array elements), or a custom function.
- * @public
- */
-type ArrayElement = Exclude<ConverterToken, 'json' | 'regexp'> | CustomElementConverter;
-/**
- * Phantom-branded token produced by {@link Converters.array}. The `T` type parameter carries
- * the element converter through any variable indirection so inference survives. The
- * `__envaptKind` discriminant is present at runtime for dispatch.
- * @public
- */
-interface ArrayOf<TElement extends ArrayElement = ArrayElement> {
-  readonly __envaptKind: 'array';
-  readonly of: TElement;
-  readonly delimiter: string;
-}
-/**
- * Runtime type guard for tokens produced by {@link Converters.array}.
- * @internal
- */
-declare function isArrayOf(value: unknown): value is ArrayOf;
-type ArrayScalarElement = Exclude<ConverterToken, 'json' | 'regexp'>;
-declare function buildArrayConverter<TReturn>(opts: {
-  of: CustomElementConverter<TReturn>;
-  delimiter?: string;
-}): ArrayOf<CustomElementConverter<TReturn>>;
-declare function buildArrayConverter<TToken extends ArrayScalarElement>(opts: {
-  of: TToken;
-  delimiter?: string;
-}): ArrayOf<TToken>;
-declare function buildArrayConverter(opts?: {
-  delimiter?: string;
-}): ArrayOf<'string'>;
-/**
- * Built-in converters for environment variables. Use the scalar tokens (e.g. `Converters.Number`)
- * for primitive types and the {@link Converters.array} builder for delimited lists.
- *
- * @example
- * ```ts
- * \@Envapt('PORT', { converter: Converters.Number, fallback: 3000 })
- * static readonly port: number;
- *
- * \@Envapt('TAGS', { converter: Converters.array({ of: Converters.String, delimiter: ' ' }) })
- * static readonly tags: string[];
- * ```
- *
- * @public
- */
-declare const Converters: {
-  readonly array: typeof buildArrayConverter;
-  readonly String: "string";
-  readonly Number: "number";
-  readonly Boolean: "boolean";
-  readonly Bigint: "bigint";
-  readonly Symbol: "symbol";
-  readonly Integer: "integer";
-  readonly Float: "float";
-  readonly Json: "json";
-  readonly Url: "url";
-  readonly Regexp: "regexp";
-  readonly Date: "date";
-  readonly Time: "time";
-};
-//#endregion
-export { ArrayElement, ArrayOf, ConverterToken, Converters, CustomElementConverter, isArrayOf };
-//# sourceMappingURL=Converters.d.cts.map

package/dist/node/converters/Converters.d.mts

@@ -1,95 +0,0 @@
-import __tsdown_shims_path from 'node:path';
-import __tsdown_shims_url from 'node:url';
-//#region src/converters/Converters.d.ts
-declare const SCALAR: {
-  readonly String: "string";
-  readonly Number: "number";
-  readonly Boolean: "boolean";
-  readonly Bigint: "bigint";
-  readonly Symbol: "symbol";
-  readonly Integer: "integer";
-  readonly Float: "float";
-  readonly Json: "json";
-  readonly Url: "url";
-  readonly Regexp: "regexp";
-  readonly Date: "date";
-  readonly Time: "time";
-};
-/**
- * String tokens for every built-in scalar converter.
- * @public
- */
-type ConverterToken = (typeof SCALAR)[keyof typeof SCALAR];
-/**
- * Custom element converter for use inside {@link Converters.array}. Receives the trimmed,
- * non-empty raw string for one array slot and returns the parsed value.
- * @public
- */
-type CustomElementConverter<TReturn = unknown> = (raw: string) => TReturn;
-/**
- * Valid element converters for {@link Converters.array}: any scalar token except
- * `json` and `regexp` (those don't compose as array elements), or a custom function.
- * @public
- */
-type ArrayElement = Exclude<ConverterToken, 'json' | 'regexp'> | CustomElementConverter;
-/**
- * Phantom-branded token produced by {@link Converters.array}. The `T` type parameter carries
- * the element converter through any variable indirection so inference survives. The
- * `__envaptKind` discriminant is present at runtime for dispatch.
- * @public
- */
-interface ArrayOf<TElement extends ArrayElement = ArrayElement> {
-  readonly __envaptKind: 'array';
-  readonly of: TElement;
-  readonly delimiter: string;
-}
-/**
- * Runtime type guard for tokens produced by {@link Converters.array}.
- * @internal
- */
-declare function isArrayOf(value: unknown): value is ArrayOf;
-type ArrayScalarElement = Exclude<ConverterToken, 'json' | 'regexp'>;
-declare function buildArrayConverter<TReturn>(opts: {
-  of: CustomElementConverter<TReturn>;
-  delimiter?: string;
-}): ArrayOf<CustomElementConverter<TReturn>>;
-declare function buildArrayConverter<TToken extends ArrayScalarElement>(opts: {
-  of: TToken;
-  delimiter?: string;
-}): ArrayOf<TToken>;
-declare function buildArrayConverter(opts?: {
-  delimiter?: string;
-}): ArrayOf<'string'>;
-/**
- * Built-in converters for environment variables. Use the scalar tokens (e.g. `Converters.Number`)
- * for primitive types and the {@link Converters.array} builder for delimited lists.
- *
- * @example
- * ```ts
- * \@Envapt('PORT', { converter: Converters.Number, fallback: 3000 })
- * static readonly port: number;
- *
- * \@Envapt('TAGS', { converter: Converters.array({ of: Converters.String, delimiter: ' ' }) })
- * static readonly tags: string[];
- * ```
- *
- * @public
- */
-declare const Converters: {
-  readonly array: typeof buildArrayConverter;
-  readonly String: "string";
-  readonly Number: "number";
-  readonly Boolean: "boolean";
-  readonly Bigint: "bigint";
-  readonly Symbol: "symbol";
-  readonly Integer: "integer";
-  readonly Float: "float";
-  readonly Json: "json";
-  readonly Url: "url";
-  readonly Regexp: "regexp";
-  readonly Date: "date";
-  readonly Time: "time";
-};
-//#endregion
-export { ArrayElement, ArrayOf, ConverterToken, Converters, CustomElementConverter, isArrayOf };
-//# sourceMappingURL=Converters.d.mts.map

package/dist/node/converters/ValueConverter.d.cts

@@ -1,25 +0,0 @@
-import { EnvaptConverter } from "../types/Conversion.cjs";
-import { StandardSchemaV1 } from "../infra/StandardSchema.cjs";
-import { EnvKeyInput, EnvapterService } from "../types/Env.cjs";
-
-//#region src/converters/ValueConverter.d.ts
-/**
- * Convert a resolved environment value to its declared type via built-in, primitive, array,
- * custom, or Standard Schema converters.
- * @internal
- */
-declare class ValueConverter {
-  private readonly envService;
-  constructor(envService: EnvapterService);
-  convertValue<TFallback>(key: EnvKeyInput, fallback: TFallback | undefined, converter: EnvaptConverter<TFallback> | undefined, hasFallback: boolean): TFallback | null | undefined;
-  private processFallbackForConverter;
-  private convertPrimitiveToString;
-  private processBuiltInConverter;
-  private processArrayConverter;
-  private processCustomConverter;
-  private resolveConverter;
-  convertWithSchema(key: EnvKeyInput, schema: StandardSchemaV1, fallback: unknown, hasFallback: boolean): unknown;
-}
-//#endregion
-export { ValueConverter };
-//# sourceMappingURL=ValueConverter.d.cts.map

package/dist/node/converters/ValueConverter.d.mts

@@ -1,27 +0,0 @@
-import __tsdown_shims_path from 'node:path';
-import __tsdown_shims_url from 'node:url';
-import { EnvaptConverter } from "../types/Conversion.mjs";
-import { StandardSchemaV1 } from "../infra/StandardSchema.mjs";
-import { EnvKeyInput, EnvapterService } from "../types/Env.mjs";
-
-//#region src/converters/ValueConverter.d.ts
-/**
- * Convert a resolved environment value to its declared type via built-in, primitive, array,
- * custom, or Standard Schema converters.
- * @internal
- */
-declare class ValueConverter {
-  private readonly envService;
-  constructor(envService: EnvapterService);
-  convertValue<TFallback>(key: EnvKeyInput, fallback: TFallback | undefined, converter: EnvaptConverter<TFallback> | undefined, hasFallback: boolean): TFallback | null | undefined;
-  private processFallbackForConverter;
-  private convertPrimitiveToString;
-  private processBuiltInConverter;
-  private processArrayConverter;
-  private processCustomConverter;
-  private resolveConverter;
-  convertWithSchema(key: EnvKeyInput, schema: StandardSchemaV1, fallback: unknown, hasFallback: boolean): unknown;
-}
-//#endregion
-export { ValueConverter };
-//# sourceMappingURL=ValueConverter.d.mts.map

package/dist/node/core/AdvancedMethods.d.cts

@@ -1,76 +0,0 @@
-import { ArrayOf } from "../converters/Converters.cjs";
-import { AdvancedConverterReturn, BuiltInConverter, ConditionalReturn, ConverterFunction, InferConverterReturnType, TimeFallback } from "../types/Conversion.cjs";
-import { InferSchemaOutput, StandardSchemaV1 } from "../infra/StandardSchema.cjs";
-import { SchemaConstraint } from "../types/Schema.cjs";
-import { EnvKeyInput } from "../types/Env.cjs";
-import { PrimitiveMethods } from "./PrimitiveMethods.cjs";
-
-//#region src/core/AdvancedMethods.d.ts
-interface GetUsingRequiredOptions<TConverter> {
-  converter: TConverter;
-  required: true;
-}
-interface GetWithRequiredOptions<TReturnType> {
-  converter: ConverterFunction<TReturnType>;
-  required: true;
-}
-/**
- * Mixin for advanced methods for environment variable conversion using built-in and custom converters
- * @internal
- */
-declare class AdvancedMethods extends PrimitiveMethods {
-  /**
-   * Get an environment variable using a built-in converter.
-   *
-   * Supports both scalar tokens (e.g. `Converters.Number`) and `ArrayOf<...>` tokens
-   * produced by `Converters.array(...)`. The key can be a single name or an ordered list;
-   * the first defined value wins.
-   */
-  static getUsing<TFallback extends TimeFallback | undefined = undefined>(key: EnvKeyInput, converter: 'time', fallback?: TFallback): ConditionalReturn<number, TFallback>;
-  static getUsing<TConverter extends BuiltInConverter | ArrayOf, TFallback = undefined>(key: EnvKeyInput, converter: TConverter, fallback?: TFallback): AdvancedConverterReturn<TConverter, TFallback>;
-  static getUsing<TReturn>(key: EnvKeyInput, converter: BuiltInConverter | ArrayOf, fallback?: TReturn): TReturn;
-  static getUsing(key: EnvKeyInput, options: GetUsingRequiredOptions<'time'>): number;
-  static getUsing<TConverter extends BuiltInConverter | ArrayOf>(key: EnvKeyInput, options: GetUsingRequiredOptions<TConverter>): InferConverterReturnType<TConverter>;
-  /**
-   * @see {@link AdvancedMethods.getUsing}
-   */
-  getUsing<TFallback extends TimeFallback | undefined = undefined>(key: EnvKeyInput, converter: 'time', fallback?: TFallback): ConditionalReturn<number, TFallback>;
-  getUsing<TConverter extends BuiltInConverter | ArrayOf, TFallback = undefined>(key: EnvKeyInput, converter: TConverter, fallback?: TFallback): AdvancedConverterReturn<TConverter, TFallback>;
-  getUsing<TReturn>(key: EnvKeyInput, converter: BuiltInConverter | ArrayOf, fallback?: TReturn): TReturn;
-  getUsing(key: EnvKeyInput, options: GetUsingRequiredOptions<'time'>): number;
-  getUsing<TConverter extends BuiltInConverter | ArrayOf>(key: EnvKeyInput, options: GetUsingRequiredOptions<TConverter>): InferConverterReturnType<TConverter>;
-  /**
-   * Get an environment variable using a custom converter function.
-   * Accepts a single key or an ordered list for automatic fallback.
-   */
-  static getWith<TReturnType, TFallback extends TReturnType | undefined = undefined>(key: EnvKeyInput, converter: ConverterFunction<TReturnType>, fallback?: TFallback): ConditionalReturn<TReturnType, TFallback>;
-  static getWith<TReturnType>(key: EnvKeyInput, options: GetWithRequiredOptions<TReturnType>): TReturnType;
-  /**
-   * @see {@link AdvancedMethods.getWith}
-   */
-  getWith<TReturnType, TFallback extends TReturnType | undefined = undefined>(key: EnvKeyInput, converter: ConverterFunction<TReturnType>, fallback?: TFallback): ConditionalReturn<TReturnType, TFallback>;
-  getWith<TReturnType>(key: EnvKeyInput, options: GetWithRequiredOptions<TReturnType>): TReturnType;
-  /**
-   * Validate an environment variable through a {@link StandardSchemaV1}-conformant schema
-   * (zod, valibot, arktype, etc). Throws `MissingEnvValue` if the env value is absent and
-   * no fallback is provided. The fallback, when provided, is returned as-is on missing;
-   * it does NOT pass through the schema (mirrors custom-converter behavior).
-   *
-   * Synchronous schemas only. A Promise-returning `validate` triggers an
-   * `InvalidUserDefinedConfig` throw at the call site.
-   *
-   * @example
-   * ```ts
-   * import { z } from 'zod';
-   * const port = Envapter.parse('PORT', z.coerce.number().min(1024).max(65535), 3000);
-   * ```
-   */
-  static parse<Schema extends StandardSchemaV1>(key: EnvKeyInput, schema: SchemaConstraint<Schema>, fallback?: InferSchemaOutput<Schema>): InferSchemaOutput<Schema>;
-  /**
-   * @see {@link AdvancedMethods.parse}
-   */
-  parse<Schema extends StandardSchemaV1>(key: EnvKeyInput, schema: SchemaConstraint<Schema>, fallback?: InferSchemaOutput<Schema>): InferSchemaOutput<Schema>;
-}
-//#endregion
-export { AdvancedMethods };
-//# sourceMappingURL=AdvancedMethods.d.cts.map