arkenv 0.7.5 → 0.7.7

package/README.md

@@ -1,16 +1,18 @@
 <p align="center">
-  <a href="https://arkenv.js.org">
-    <img alt="arkenv - Typesafe Environment Variables" src="https://og.tailgraph.com/og?titleFontFamily=JetBrains+Mono&textFontFamily=Inter&title=ArkEnv&titleTailwind=text-[%23e9eef9]%20font-bold%20relative%20decoration-%5Brgb(180,215,255)%5D%20decoration-wavy%20decoration-[5px]%20underline%20underline-offset-[16px]%20text-5xl%20mb-8&text=Typesafe%20environment%20variables%20powered%20by%20ArkType&textTailwind=text-[%238b9dc1]%20text-3xl&bgTailwind=bg-gradient-to-b%20from-[%23061a3a]%20to-black" width="645px">
-  </a>
-  <br />
-  <a href="https://github.com/yamcodes/arkenv/actions/workflows/tests.yml?query=branch%3Amain"><img alt="Tests Status" src="https://github.com/yamcodes/arkenv/actions/workflows/tests.yml/badge.svg?event=push&branch=main"></a>
+  <a href="https://github.com/yamcodes/arkenv/blob/main/apps/www/public/assets/icon.svg"><img alt="ArkEnv Logo" src="https://arkenv.js.org/assets/icon.svg" width="160px" align="center"/></a>
+  <h1 align="center">ArkEnv</h1>
+  <div align="center">
+    <p align="center">Typesafe environment variables <br/>
+    powered by <a href="https://github.com/arktypeio/arktype">ArkType</a></p>
+  <a href="https://github.com/yamcodes/arkenv/actions/workflows/test.yml?query=branch%3Amain"><img alt="Test Status" src="https://github.com/yamcodes/arkenv/actions/workflows/tests-badge.yml/badge.svg?branch=main"></a>
   <a href="https://bundlephobia.com/package/arkenv"><img alt="npm bundle size" src="https://img.shields.io/bundlephobia/minzip/arkenv"></a>
   <a href="https://www.typescriptlang.org/"><img alt="TypeScript" src="https://img.shields.io/badge/TypeScript-3178C6?style=flat&logo=typescript&logoColor=white"></a>
   <a href="https://arktype.io/"><img alt="Powered By ArkType" src="https://custom-icon-badges.demolab.com/badge/ArkType-0d1526?logo=arktype2&logoColor=e9eef9"></a>
   <a href="https://nodejs.org/en"><img alt="Node.js" src="https://img.shields.io/badge/Node.js-339933?style=flat&logo=node.js&logoColor=white"></a>
   <a href="https://bun.com/"><img alt="Bun" src="https://img.shields.io/badge/Bun-14151a?logo=bun&logoColor=fbf0df"></a>
   <a href="https://vite.dev/"><img alt="Vite" src="https://custom-icon-badges.demolab.com/badge/Vite-2e2742?logo=vite2&logoColor=dfdfd6"></a>
-  <a href="https://discord.com/channels/957797212103016458/1415373591394127894"><img alt="Chat on Discord" src="https://img.shields.io/discord/957797212103016458?label=Chat&color=5865f4&logo=discord&labelColor=121214"></a>
+  <a href="https://discord.gg/zAmUyuxXH9"><img alt="Chat on Discord" src="https://img.shields.io/discord/957797212103016458?label=Chat&color=5865f4&logo=discord&labelColor=121214"></a>
+    </div>
 </p>
 <h3 align="center">Proud member of the <a href="https://arktype.io/docs/ecosystem#arkenv">ArkType ecosystem</a></h3>
 
@@ -22,7 +24,7 @@
 <br/>
 <br/>
 
-### [Read the docs →](https://arkenv.js.org/docs)
+### [Read the docs →](https://arkenv.js.org/docs/arkenv)
 
 <br/>
 <br/>
@@ -30,7 +32,7 @@
 ## Introduction 
 
 > [!TIP]
-> 📖 **Reading this on GitHub?** Check out [this page in our docs](https://arkenv.js.org/docs) to hover over code blocks and get type hints!
+> 📖 **Reading this on GitHub?** Check out [this page in our docs](https://arkenv.js.org/docs/arkenv) to hover over code blocks and get type hints!
 
 ArkEnv is an environment variable parser powered by [ArkType](https://arktype.io/), TypeScript's 1:1 validator. ArkEnv lets you use familiar TypeScript-like syntax to create a ready to use, typesafe environment variable object:
 
@@ -51,7 +53,7 @@ const nodeEnv = env.NODE_ENV;
 
 With ArkEnv, your environment variables are **guaranteed to match your schema**. If any variable is incorrect or missing, the app won't start and a clear error will be thrown:
 
-```
+```bash title="Terminal"
 ArkEnvError: Errors found while validating environment variables
   HOST must be a string or "localhost" (was missing)
   PORT must be an integer between 0 and 65535 (was "hello")
@@ -66,6 +68,7 @@ ArkEnvError: Errors found while validating environment variables
 - Single import, zero config for most projects
 - Validated, defaultable, typesafe environment variables
 - Powered by ArkType, TypeScript's 1:1 validator
+- Compatible with any Standard Schema validator (Zod, Valibot, etc.)
 - Optimized from editor to runtime
 
 ## Installation
@@ -109,12 +112,26 @@ bun add arkenv arktype
 
 ## Requirements
 
-- TypeScript >= 5.1 and [anything else required by ArkType](https://arktype.io/docs/intro/setup#installation)
--  Tested on [Node.js **LTS** and **Current**](https://github.com/yamcodes/arkenv/tree/main/examples/basic), [Bun 1.2](https://github.com/yamcodes/arkenv/tree/main/examples/with-bun), and [Vite from **2.9.18** to **7.x**](https://github.com/yamcodes/arkenv/tree/main/examples/with-vite-react-ts). Older versions may work but are not officially supported
+ArkEnv is tested on [**Node.js LTS** and **Current**](https://github.com/yamcodes/arkenv/tree/main/examples/basic), [**Bun 1.3.2**](https://github.com/yamcodes/arkenv/tree/main/examples/with-bun), and [**Vite** from **2.9.18** to **7.x**](https://github.com/yamcodes/arkenv/tree/main/examples/with-vite-react-ts). Older versions may work but are not officially supported.
+
+### TypeScript setup
+
+While ArkEnv works with plain JavaScript, *TypeScript is highly recommended* to get the full typesafety benefits. To get ArkEnv to work with TypeScript, we require:
+
+- [**Modern TypeScript module resolution**](https://www.typescriptlang.org/tsconfig/#moduleResolution). One of the following is required in your `tsconfig.json`:
+  - `"moduleResolution": "bundler"` - Recommended for modern bundlers (Vite, Next.js, etc.). Supplied by default when using `"module": "Preserve"` (Introduced in TypeScript v5.4).
+  - `"moduleResolution": "node16"` or `"nodenext"` - For Node.js projects. Supplied by default when using a matching `"module"` value.
+- **TypeScript >= 5.1** and [anything else required by ArkType](https://arktype.io/docs/intro/setup#installation)
+
+> [!NOTE]
+> Without TypeScript, runtime validation still works, but you lose build-time type checking and, in some cases, editor autocomplete. Try our [examples](https://arkenv.js.org/docs/examples) to see this in action!
 
 ## Plugins
 
-- [@arkenv/vite-plugin](https://github.com/yamcodes/arkenv/tree/main/packages/vite-plugin)
+Beyond [the core package](https://arkenv.js.org/docs/arkenv), we also provide plugins for frameworks that require a specific implementation to adhere to best practices.
+
+- [@arkenv/vite-plugin](https://arkenv.js.org/docs/vite-plugin)
+- [@arkenv/bun-plugin](https://arkenv.js.org/docs/bun-plugin)
 
 ## Supporting ArkEnv
 

package/dist/index.cjs

@@ -1,4 +1,4 @@
-Object.defineProperty(exports,`__esModule`,{value:!0});var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},s=(n,r,a)=>(a=n==null?{}:e(i(n)),o(r||!n||!n.__esModule?t(a,`default`,{value:n,enumerable:!0}):a,n));let c=require(`arktype`);c=s(c);const l={red:`\x1B[31m`,yellow:`\x1B[33m`,cyan:`\x1B[36m`,reset:`\x1B[0m`},u=()=>typeof process<`u`&&process.versions!=null&&process.versions.node!=null,d=()=>!!(!u()||process.env.NO_COLOR!==void 0||process.env.CI!==void 0||process.stdout&&!process.stdout.isTTY),f=(e,t)=>u()&&!d()?`${l[e]}${t}${l.reset}`:t,p=(e,t=2,{dontDetectNewlines:n=!1}={})=>n?`${` `.repeat(t)}${e}`:e.split(`
+Object.defineProperty(exports,`__esModule`,{value:!0});let e=require(`arktype`);const t=(0,e.type)(`string`,`=>`,(e,t)=>{let n=Number.parseInt(e,10);return(!Number.isInteger(n)||!(0<=n&&n<=65535))&&t.mustBe(`an integer between 0 and 65535`),n}),n=(0,e.type)(`string.ip | 'localhost'`),r=(0,e.type)(`'true' | 'false' | true | false`,`=>`,e=>e===`true`||e===!0),i=(0,e.scope)({string:e.type.module({...e.type.keywords.string,host:n}),number:e.type.module({...e.type.keywords.number,port:t}),boolean:r}),a=(e,t=2,{dontDetectNewlines:n=!1}={})=>n?`${` `.repeat(t)}${e}`:e.split(`
 `).map(e=>`${` `.repeat(t)}${e}`).join(`
-`),m=e=>Object.entries(e.byPath).map(([e,t])=>{let n=t.message.startsWith(e)?t.message.slice(e.length):t.message,r=n.match(/\(was "([^"]+)"\)/),i=r?n.replace(`(was "${r[1]}")`,`(was ${f(`cyan`,`"${r[1]}"`)})`):n;return`${f(`yellow`,e)}${i}`}).join(`
-`);var h=class extends Error{constructor(e,t=`Errors found while validating environment variables`){super(`${f(`red`,t)}\n${p(m(e))}\n`),this.name=`ArkEnvError`}};const g=(0,c.type)(`string`,`=>`,(e,t)=>{let n=Number.parseInt(e,10);return(!Number.isInteger(n)||!(0<=n&&n<=65535))&&t.mustBe(`an integer between 0 and 65535`),n}),_=(0,c.type)(`string.ip | 'localhost'`),v=(0,c.type)(`'true' | 'false' | true | false`,`=>`,e=>e===`true`||e===!0),y=(0,c.scope)({string:c.type.module({...c.type.keywords.string,host:_}),number:c.type.module({...c.type.keywords.number,port:g}),boolean:v});function b(e,t=process.env){let n=y.type.raw(e)(t);if(n instanceof c.type.errors)throw new h(n);return n}const x=y.type,S=b;var C=S;exports.ArkEnvError=h,exports.createEnv=b,exports.default=C,exports.type=x;
+`),o={red:`\x1B[31m`,yellow:`\x1B[33m`,cyan:`\x1B[36m`,reset:`\x1B[0m`},s=()=>typeof process<`u`&&process.versions!=null&&process.versions.node!=null,c=()=>!!(!s()||process.env.NO_COLOR!==void 0||process.env.CI!==void 0||process.stdout&&!process.stdout.isTTY),l=(e,t)=>s()&&!c()?`${o[e]}${t}${o.reset}`:t,u=e=>Object.entries(e.byPath).map(([e,t])=>{let n=t.message.startsWith(e)?t.message.slice(e.length):t.message,r=n.match(/\(was "([^"]+)"\)/),i=r?n.replace(`(was "${r[1]}")`,`(was ${l(`cyan`,`"${r[1]}"`)})`):n;return`${l(`yellow`,e)}${i}`}).join(`
+`);var d=class extends Error{constructor(e,t=`Errors found while validating environment variables`){super(`${l(`red`,t)}\n${a(u(e))}\n`),this.name=`ArkEnvError`}};const f=i.type;function p(e,t=process.env){let n=(typeof e==`function`&&`assert`in e?e:i.type.raw(e))(t);if(n instanceof f.errors)throw new d(n);return n}const m=p;var h=m;exports.ArkEnvError=d,exports.createEnv=p,exports.default=h,exports.type=f;

package/dist/index.d.cts

@@ -1,73 +1,75 @@
-import * as arktype16 from "arktype";
-import { ArkErrors, distill, type as type$1 } from "arktype";
-import * as arktype_internal_keywords_string_ts10 from "arktype/internal/keywords/string.ts";
-import * as arktype_internal_attributes_ts5 from "arktype/internal/attributes.ts";
+import * as arktype0 from "arktype";
+import { ArkErrors, Type, distill, type as type$1 } from "arktype";
+import * as arktype_internal_keywords_string_ts0 from "arktype/internal/keywords/string.ts";
+import * as arktype_internal_attributes_ts0 from "arktype/internal/attributes.ts";
+import * as arktype_internal_variants_object_ts0 from "arktype/internal/variants/object.ts";
 import * as arktype_internal_type_ts0 from "arktype/internal/type.ts";
 
-//#region src/scope.d.ts
+//#region ../internal/scope/dist/index.d.ts
+//#region src/index.d.ts
 /**
  * The root scope for the ArkEnv library, containing extensions to the ArkType scopes with ArkEnv-specific types like `string.host` and `number.port`.
  */
-declare const $: arktype16.Scope<{
-  string: arktype16.Submodule<{
-    trim: arktype16.Submodule<arktype_internal_keywords_string_ts10.trim.$ & {
-      " arkInferred": (In: string) => arktype_internal_attributes_ts5.To<string>;
+declare const $: arktype0.Scope<{
+  string: arktype0.Submodule<{
+    trim: arktype0.Submodule<arktype_internal_keywords_string_ts0.trim.$ & {
+      " arkInferred": (In: string) => arktype_internal_attributes_ts0.To<string>;
     }>;
-    normalize: arktype16.Submodule<arktype_internal_keywords_string_ts10.normalize.$ & {
-      " arkInferred": (In: string) => arktype_internal_attributes_ts5.To<string>;
+    normalize: arktype0.Submodule<arktype_internal_keywords_string_ts0.normalize.$ & {
+      " arkInferred": (In: string) => arktype_internal_attributes_ts0.To<string>;
     }>;
     root: string;
     alpha: string;
     alphanumeric: string;
     hex: string;
-    base64: arktype16.Submodule<{
+    base64: arktype0.Submodule<{
       root: string;
       url: string;
     } & {
       " arkInferred": string;
     }>;
-    capitalize: arktype16.Submodule<arktype_internal_keywords_string_ts10.capitalize.$ & {
-      " arkInferred": (In: string) => arktype_internal_attributes_ts5.To<string>;
+    capitalize: arktype0.Submodule<arktype_internal_keywords_string_ts0.capitalize.$ & {
+      " arkInferred": (In: string) => arktype_internal_attributes_ts0.To<string>;
     }>;
     creditCard: string;
-    date: arktype16.Submodule<arktype_internal_keywords_string_ts10.stringDate.$ & {
+    date: arktype0.Submodule<arktype_internal_keywords_string_ts0.stringDate.$ & {
       " arkInferred": string;
     }>;
     digits: string;
     email: string;
-    integer: arktype16.Submodule<arktype_internal_keywords_string_ts10.stringInteger.$ & {
+    integer: arktype0.Submodule<arktype_internal_keywords_string_ts0.stringInteger.$ & {
       " arkInferred": string;
     }>;
-    ip: arktype16.Submodule<arktype_internal_keywords_string_ts10.ip.$ & {
+    ip: arktype0.Submodule<arktype_internal_keywords_string_ts0.ip.$ & {
       " arkInferred": string;
     }>;
-    json: arktype16.Submodule<arktype_internal_keywords_string_ts10.stringJson.$ & {
+    json: arktype0.Submodule<arktype_internal_keywords_string_ts0.stringJson.$ & {
       " arkInferred": string;
     }>;
-    lower: arktype16.Submodule<arktype_internal_keywords_string_ts10.lower.$ & {
-      " arkInferred": (In: string) => arktype_internal_attributes_ts5.To<string>;
+    lower: arktype0.Submodule<arktype_internal_keywords_string_ts0.lower.$ & {
+      " arkInferred": (In: string) => arktype_internal_attributes_ts0.To<string>;
     }>;
-    numeric: arktype16.Submodule<arktype_internal_keywords_string_ts10.stringNumeric.$ & {
+    numeric: arktype0.Submodule<arktype_internal_keywords_string_ts0.stringNumeric.$ & {
       " arkInferred": string;
     }>;
     regex: string;
     semver: string;
-    upper: arktype16.Submodule<{
-      root: (In: string) => arktype_internal_attributes_ts5.To<string>;
+    upper: arktype0.Submodule<{
+      root: (In: string) => arktype_internal_attributes_ts0.To<string>;
       preformatted: string;
     } & {
-      " arkInferred": (In: string) => arktype_internal_attributes_ts5.To<string>;
+      " arkInferred": (In: string) => arktype_internal_attributes_ts0.To<string>;
     }>;
-    url: arktype16.Submodule<arktype_internal_keywords_string_ts10.url.$ & {
+    url: arktype0.Submodule<arktype_internal_keywords_string_ts0.url.$ & {
       " arkInferred": string;
     }>;
-    uuid: arktype16.Submodule<arktype_internal_keywords_string_ts10.uuid.$ & {
+    uuid: arktype0.Submodule<arktype_internal_keywords_string_ts0.uuid.$ & {
       " arkInferred": string;
     }>;
     " arkInferred": string;
     host: string;
   }>;
-  number: arktype16.Submodule<{
+  number: arktype0.Submodule<{
     NaN: number;
     Infinity: number;
     root: number;
@@ -76,88 +78,108 @@ declare const $: arktype16.Scope<{
     epoch: number;
     safe: number;
     NegativeInfinity: number;
-    port: (In: string) => arktype16.Out<number>;
+    port: (In: string) => arktype0.Out<number>;
   }>;
-  boolean: (In: boolean | "false" | "true") => arktype16.Out<boolean>;
+  boolean: (In: boolean | "false" | "true") => arktype0.Out<boolean>;
 }>;
 //#endregion
+//#endregion
+//#region ../internal/types/dist/infer-type.d.ts
+/**
+ * Extract the inferred type from an ArkType type definition by checking its call signature.
+ * When a type definition is called, it returns either the validated value or type.errors.
+ *
+ * @template T - The ArkType type definition to infer from
+ */
+type InferType<T> = T extends ((value: Record<string, string | undefined>) => infer R) ? R extends type$1.errors ? never : R : T extends type$1.Any<infer U, infer _Scope> ? U : never;
+//#endregion
+//#region ../internal/types/dist/schema.d.ts
+declare const SchemaShape: arktype_internal_variants_object_ts0.ObjectType<{
+  [x: string]: unknown;
+}, {}>;
+type SchemaShape = typeof SchemaShape.infer;
+type EnvSchemaWithType = Type<SchemaShape, (typeof $)["t"]>;
+//#endregion
 //#region src/create-env.d.ts
+type EnvSchema<def$1> = type$1.validate<def$1, (typeof $)["t"]>;
 type RuntimeEnvironment = Record<string, string | undefined>;
-type EnvSchema<def> = type$1.validate<def, (typeof $)["t"]>;
 /**
- * TODO: If possible, find a better type than "const T extends Record<string, unknown>",
+ * TODO: `SchemaShape` is basically `Record<string, unknown>`.
+ * If possible, find a better type than "const T extends Record<string, unknown>",
  * and be as close as possible to the type accepted by ArkType's `type`.
  */
 /**
  * Create an environment variables object from a schema and an environment
- * @param def - The environment variable schema
+ * @param def - The environment variable schema (raw object or type definition created with `type()`)
  * @param env - The environment variables to validate, defaults to `process.env`
  * @returns The validated environment variable schema
  * @throws An {@link ArkEnvError | error} if the environment variables are invalid.
  */
-declare function createEnv<const T extends Record<string, unknown>>(def: EnvSchema<T>, env?: RuntimeEnvironment): distill.Out<type$1.infer<T, (typeof $)["t"]>>;
+declare function createEnv<T extends EnvSchemaWithType>(def: T, env?: RuntimeEnvironment): InferType<T>;
+declare function createEnv<const T extends SchemaShape>(def: EnvSchema<T>, env?: RuntimeEnvironment): distill.Out<type$1.infer<T, (typeof $)["t"]>>;
+declare function createEnv<const T extends SchemaShape>(def: EnvSchema<T> | EnvSchemaWithType, env?: RuntimeEnvironment): distill.Out<type$1.infer<T, (typeof $)["t"]>> | InferType<typeof def>;
 //#endregion
 //#region src/type.d.ts
 declare const type: arktype_internal_type_ts0.TypeParser<{
-  string: arktype16.Submodule<{
-    trim: arktype16.Submodule<arktype_internal_keywords_string_ts10.trim.$ & {
-      " arkInferred": (In: string) => arktype_internal_attributes_ts5.To<string>;
+  string: arktype0.Submodule<{
+    trim: arktype0.Submodule<arktype_internal_keywords_string_ts0.trim.$ & {
+      " arkInferred": (In: string) => arktype_internal_attributes_ts0.To<string>;
     }>;
-    normalize: arktype16.Submodule<arktype_internal_keywords_string_ts10.normalize.$ & {
-      " arkInferred": (In: string) => arktype_internal_attributes_ts5.To<string>;
+    normalize: arktype0.Submodule<arktype_internal_keywords_string_ts0.normalize.$ & {
+      " arkInferred": (In: string) => arktype_internal_attributes_ts0.To<string>;
     }>;
     root: string;
     alpha: string;
     alphanumeric: string;
     hex: string;
-    base64: arktype16.Submodule<{
+    base64: arktype0.Submodule<{
       root: string;
       url: string;
     } & {
       " arkInferred": string;
     }>;
-    capitalize: arktype16.Submodule<arktype_internal_keywords_string_ts10.capitalize.$ & {
-      " arkInferred": (In: string) => arktype_internal_attributes_ts5.To<string>;
+    capitalize: arktype0.Submodule<arktype_internal_keywords_string_ts0.capitalize.$ & {
+      " arkInferred": (In: string) => arktype_internal_attributes_ts0.To<string>;
     }>;
     creditCard: string;
-    date: arktype16.Submodule<arktype_internal_keywords_string_ts10.stringDate.$ & {
+    date: arktype0.Submodule<arktype_internal_keywords_string_ts0.stringDate.$ & {
       " arkInferred": string;
     }>;
     digits: string;
     email: string;
-    integer: arktype16.Submodule<arktype_internal_keywords_string_ts10.stringInteger.$ & {
+    integer: arktype0.Submodule<arktype_internal_keywords_string_ts0.stringInteger.$ & {
       " arkInferred": string;
     }>;
-    ip: arktype16.Submodule<arktype_internal_keywords_string_ts10.ip.$ & {
+    ip: arktype0.Submodule<arktype_internal_keywords_string_ts0.ip.$ & {
       " arkInferred": string;
     }>;
-    json: arktype16.Submodule<arktype_internal_keywords_string_ts10.stringJson.$ & {
+    json: arktype0.Submodule<arktype_internal_keywords_string_ts0.stringJson.$ & {
       " arkInferred": string;
     }>;
-    lower: arktype16.Submodule<arktype_internal_keywords_string_ts10.lower.$ & {
-      " arkInferred": (In: string) => arktype_internal_attributes_ts5.To<string>;
+    lower: arktype0.Submodule<arktype_internal_keywords_string_ts0.lower.$ & {
+      " arkInferred": (In: string) => arktype_internal_attributes_ts0.To<string>;
     }>;
-    numeric: arktype16.Submodule<arktype_internal_keywords_string_ts10.stringNumeric.$ & {
+    numeric: arktype0.Submodule<arktype_internal_keywords_string_ts0.stringNumeric.$ & {
       " arkInferred": string;
     }>;
     regex: string;
     semver: string;
-    upper: arktype16.Submodule<{
-      root: (In: string) => arktype_internal_attributes_ts5.To<string>;
+    upper: arktype0.Submodule<{
+      root: (In: string) => arktype_internal_attributes_ts0.To<string>;
       preformatted: string;
     } & {
-      " arkInferred": (In: string) => arktype_internal_attributes_ts5.To<string>;
+      " arkInferred": (In: string) => arktype_internal_attributes_ts0.To<string>;
     }>;
-    url: arktype16.Submodule<arktype_internal_keywords_string_ts10.url.$ & {
+    url: arktype0.Submodule<arktype_internal_keywords_string_ts0.url.$ & {
       " arkInferred": string;
     }>;
-    uuid: arktype16.Submodule<arktype_internal_keywords_string_ts10.uuid.$ & {
+    uuid: arktype0.Submodule<arktype_internal_keywords_string_ts0.uuid.$ & {
       " arkInferred": string;
     }>;
     " arkInferred": string;
     host: string;
   }>;
-  number: arktype16.Submodule<{
+  number: arktype0.Submodule<{
     NaN: number;
     Infinity: number;
     root: number;
@@ -166,9 +188,9 @@ declare const type: arktype_internal_type_ts0.TypeParser<{
     epoch: number;
     safe: number;
     NegativeInfinity: number;
-    port: (In: string) => arktype16.Out<number>;
+    port: (In: string) => arktype0.Out<number>;
   }>;
-  boolean: (In: boolean | "false" | "true") => arktype16.Out<boolean>;
+  boolean: (In: boolean | "false" | "true") => arktype0.Out<boolean>;
 }>;
 //#endregion
 //#region src/errors.d.ts

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/scope.ts","../src/create-env.ts","../src/type.ts","../src/errors.ts","../src/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;cAQa,aAAC;;;;IAUZ,CAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WAVY,qBAAA,yDAAA;MAAA,cAAA,EAAA,MAAA;;;;ICJT,KAAA,qBAAqB,CAAM;MAEpB,IAAS,EAAA,CAAA,EAAA,EAAA,MAAA,EAAA,qCAAA,CAAA,MAAA,CAAA;MAAsB,YAAA,EAAA,MAAA;IAAa,CAAA,GAAA;MAAtB,cAAA,EAAA,CAAA,EAAA,EAAA,MAAA,EAAA,qCAAA,CAAA,MAAA,CAAA;IAAQ,CAAA,CAAA;IAc1B,GAAA,qBAAS,+CAAA;MAAiB,cAAA,EAAA,MAAA;IAC1B,CAAA,CAAA;IAAV,IAAA,qBAAA,gDAAA;MACA,cAAA,EAAA,MAAA;IACoB,CAAA,CAAA;IAAW,cAAA,EAAA,MAAA;IAAjB,IAAA,EAAA,MAAA;EAAjB,CAAA,CAAA;EAAW,MAAA,qBAAA,CAAA;;;;ICrBD,OAAa,EAAA,MAAA;;;;;;;;;;;KDErB,kBAAA,GAAqB;KAEd,iBAAiB,MAAA,CAAK,SAAS,aAAa;;;;ADExD;;;;;;;;iBCYgB,0BAA0B,8BACpC,UAAU,UACV,qBACH,OAAA,CAAQ,IAAI,MAAA,CAAK,MAAM,WAAW;;;cCrBxB,gCAAI;;;;;;;IFgBf,CAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;SAVY,EAAA,MAAA;IAAA,MAAA,EAAA,MAAA;;;;ICJT,CAAA,GAAA;MAEO,cAAS,EAAA,CAAA,EAAA,EAAA,MAAA,EAAA,qCAAA,CAAA,MAAA,CAAA;IAAsB,CAAA,CAAA;IAAa,GAAA,qBAAA,+CAAA;MAAtB,cAAA,EAAA,MAAA;IAAQ,CAAA,CAAA;IAc1B,IAAA,qBAAS,gDAAA;MAAiB,cAAA,EAAA,MAAA;IAC1B,CAAA,CAAA;IAAV,cAAA,EAAA,MAAA;IACA,IAAA,EAAA,MAAA;EACoB,CAAA,CAAA;EAAW,MAAA,qBAAA,CAAA;IAAjB,GAAA,EAAA,MAAA;IAAjB,QAAQ,EAAA,MAAA;IAAG,IAAA,EAAA,MAAA;;;;ICrBD,IAAa,EAAA,MAAA;;;;;;;;AFMb,cGqBA,WAAA,SAAoB,KAAA,CHX/B;sBGaQ;;;;;;;;;AHvBV,cICM,MJSJ,EAAA,OITU,SJSV"}
+{"version":3,"file":"index.d.cts","names":["arktype0","arktype_internal_keywords_string_ts0","arktype_internal_attributes_ts0","$","trim","To","Submodule","normalize","capitalize","stringDate","stringInteger","ip","stringJson","lower","stringNumeric","url","uuid","Out","Scope","type","InferType","T","Record","R","errors","Any","U","$","Type","SchemaShape","arktype_internal_variants_object_ts0","ObjectType","infer","EnvSchemaWithType"],"sources":["../../internal/scope/dist/index.d.ts","../../internal/types/dist/infer-type.d.ts","../../internal/types/dist/schema.d.ts","../src/create-env.ts","../src/type.ts","../src/errors.ts","../src/index.ts"],"sourcesContent":["import * as arktype0 from \"arktype\";\nimport * as arktype_internal_keywords_string_ts0 from \"arktype/internal/keywords/string.ts\";\nimport * as arktype_internal_attributes_ts0 from \"arktype/internal/attributes.ts\";\n\n//#region src/index.d.ts\n/**\n * The root scope for the ArkEnv library, containing extensions to the ArkType scopes with ArkEnv-specific types like `string.host` and `number.port`.\n */\ndeclare const $: arktype0.Scope<{\n  string: arktype0.Submodule<{\n    trim: arktype0.Submodule<arktype_internal_keywords_string_ts0.trim.$ & {\n      \" arkInferred\": (In: string) => arktype_internal_attributes_ts0.To<string>;\n    }>;\n    normalize: arktype0.Submodule<arktype_internal_keywords_string_ts0.normalize.$ & {\n      \" arkInferred\": (In: string) => arktype_internal_attributes_ts0.To<string>;\n    }>;\n    root: string;\n    alpha: string;\n    alphanumeric: string;\n    hex: string;\n    base64: arktype0.Submodule<{\n      root: string;\n      url: string;\n    } & {\n      \" arkInferred\": string;\n    }>;\n    capitalize: arktype0.Submodule<arktype_internal_keywords_string_ts0.capitalize.$ & {\n      \" arkInferred\": (In: string) => arktype_internal_attributes_ts0.To<string>;\n    }>;\n    creditCard: string;\n    date: arktype0.Submodule<arktype_internal_keywords_string_ts0.stringDate.$ & {\n      \" arkInferred\": string;\n    }>;\n    digits: string;\n    email: string;\n    integer: arktype0.Submodule<arktype_internal_keywords_string_ts0.stringInteger.$ & {\n      \" arkInferred\": string;\n    }>;\n    ip: arktype0.Submodule<arktype_internal_keywords_string_ts0.ip.$ & {\n      \" arkInferred\": string;\n    }>;\n    json: arktype0.Submodule<arktype_internal_keywords_string_ts0.stringJson.$ & {\n      \" arkInferred\": string;\n    }>;\n    lower: arktype0.Submodule<arktype_internal_keywords_string_ts0.lower.$ & {\n      \" arkInferred\": (In: string) => arktype_internal_attributes_ts0.To<string>;\n    }>;\n    numeric: arktype0.Submodule<arktype_internal_keywords_string_ts0.stringNumeric.$ & {\n      \" arkInferred\": string;\n    }>;\n    regex: string;\n    semver: string;\n    upper: arktype0.Submodule<{\n      root: (In: string) => arktype_internal_attributes_ts0.To<string>;\n      preformatted: string;\n    } & {\n      \" arkInferred\": (In: string) => arktype_internal_attributes_ts0.To<string>;\n    }>;\n    url: arktype0.Submodule<arktype_internal_keywords_string_ts0.url.$ & {\n      \" arkInferred\": string;\n    }>;\n    uuid: arktype0.Submodule<arktype_internal_keywords_string_ts0.uuid.$ & {\n      \" arkInferred\": string;\n    }>;\n    \" arkInferred\": string;\n    host: string;\n  }>;\n  number: arktype0.Submodule<{\n    NaN: number;\n    Infinity: number;\n    root: number;\n    integer: number;\n    \" arkInferred\": number;\n    epoch: number;\n    safe: number;\n    NegativeInfinity: number;\n    port: (In: string) => arktype0.Out<number>;\n  }>;\n  boolean: (In: boolean | \"false\" | \"true\") => arktype0.Out<boolean>;\n}>;\n//#endregion\nexport { $ };\n//# sourceMappingURL=index.d.ts.map","import type { type } from \"arktype\";\n/**\n * Extract the inferred type from an ArkType type definition by checking its call signature.\n * When a type definition is called, it returns either the validated value or type.errors.\n *\n * @template T - The ArkType type definition to infer from\n */\nexport type InferType<T> = T extends (value: Record<string, string | undefined>) => infer R ? R extends type.errors ? never : R : T extends type.Any<infer U, infer _Scope> ? U : never;\n//# sourceMappingURL=infer-type.d.ts.map","import type { $ } from \"@repo/scope\";\nimport { type Type } from \"arktype\";\nexport declare const SchemaShape: import(\"arktype/internal/variants/object.ts\").ObjectType<{\n    [x: string]: unknown;\n}, {}>;\nexport type SchemaShape = typeof SchemaShape.infer;\nexport type EnvSchemaWithType = Type<SchemaShape, (typeof $)[\"t\"]>;\n//# sourceMappingURL=schema.d.ts.map"],"mappings":"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"}

package/dist/index.d.ts

@@ -1,73 +1,75 @@
-import * as arktype16 from "arktype";
-import { ArkErrors, distill, type as type$1 } from "arktype";
-import * as arktype_internal_keywords_string_ts10 from "arktype/internal/keywords/string.ts";
-import * as arktype_internal_attributes_ts5 from "arktype/internal/attributes.ts";
+import * as arktype0 from "arktype";
+import { ArkErrors, Type, distill, type as type$1 } from "arktype";
+import * as arktype_internal_keywords_string_ts0 from "arktype/internal/keywords/string.ts";
+import * as arktype_internal_attributes_ts0 from "arktype/internal/attributes.ts";
+import * as arktype_internal_variants_object_ts0 from "arktype/internal/variants/object.ts";
 import * as arktype_internal_type_ts0 from "arktype/internal/type.ts";
 
-//#region src/scope.d.ts
+//#region ../internal/scope/dist/index.d.ts
+//#region src/index.d.ts
 /**
  * The root scope for the ArkEnv library, containing extensions to the ArkType scopes with ArkEnv-specific types like `string.host` and `number.port`.
  */
-declare const $: arktype16.Scope<{
-  string: arktype16.Submodule<{
-    trim: arktype16.Submodule<arktype_internal_keywords_string_ts10.trim.$ & {
-      " arkInferred": (In: string) => arktype_internal_attributes_ts5.To<string>;
+declare const $: arktype0.Scope<{
+  string: arktype0.Submodule<{
+    trim: arktype0.Submodule<arktype_internal_keywords_string_ts0.trim.$ & {
+      " arkInferred": (In: string) => arktype_internal_attributes_ts0.To<string>;
     }>;
-    normalize: arktype16.Submodule<arktype_internal_keywords_string_ts10.normalize.$ & {
-      " arkInferred": (In: string) => arktype_internal_attributes_ts5.To<string>;
+    normalize: arktype0.Submodule<arktype_internal_keywords_string_ts0.normalize.$ & {
+      " arkInferred": (In: string) => arktype_internal_attributes_ts0.To<string>;
     }>;
     root: string;
     alpha: string;
     alphanumeric: string;
     hex: string;
-    base64: arktype16.Submodule<{
+    base64: arktype0.Submodule<{
       root: string;
       url: string;
     } & {
       " arkInferred": string;
     }>;
-    capitalize: arktype16.Submodule<arktype_internal_keywords_string_ts10.capitalize.$ & {
-      " arkInferred": (In: string) => arktype_internal_attributes_ts5.To<string>;
+    capitalize: arktype0.Submodule<arktype_internal_keywords_string_ts0.capitalize.$ & {
+      " arkInferred": (In: string) => arktype_internal_attributes_ts0.To<string>;
     }>;
     creditCard: string;
-    date: arktype16.Submodule<arktype_internal_keywords_string_ts10.stringDate.$ & {
+    date: arktype0.Submodule<arktype_internal_keywords_string_ts0.stringDate.$ & {
       " arkInferred": string;
     }>;
     digits: string;
     email: string;
-    integer: arktype16.Submodule<arktype_internal_keywords_string_ts10.stringInteger.$ & {
+    integer: arktype0.Submodule<arktype_internal_keywords_string_ts0.stringInteger.$ & {
       " arkInferred": string;
     }>;
-    ip: arktype16.Submodule<arktype_internal_keywords_string_ts10.ip.$ & {
+    ip: arktype0.Submodule<arktype_internal_keywords_string_ts0.ip.$ & {
       " arkInferred": string;
     }>;
-    json: arktype16.Submodule<arktype_internal_keywords_string_ts10.stringJson.$ & {
+    json: arktype0.Submodule<arktype_internal_keywords_string_ts0.stringJson.$ & {
       " arkInferred": string;
     }>;
-    lower: arktype16.Submodule<arktype_internal_keywords_string_ts10.lower.$ & {
-      " arkInferred": (In: string) => arktype_internal_attributes_ts5.To<string>;
+    lower: arktype0.Submodule<arktype_internal_keywords_string_ts0.lower.$ & {
+      " arkInferred": (In: string) => arktype_internal_attributes_ts0.To<string>;
     }>;
-    numeric: arktype16.Submodule<arktype_internal_keywords_string_ts10.stringNumeric.$ & {
+    numeric: arktype0.Submodule<arktype_internal_keywords_string_ts0.stringNumeric.$ & {
       " arkInferred": string;
     }>;
     regex: string;
     semver: string;
-    upper: arktype16.Submodule<{
-      root: (In: string) => arktype_internal_attributes_ts5.To<string>;
+    upper: arktype0.Submodule<{
+      root: (In: string) => arktype_internal_attributes_ts0.To<string>;
       preformatted: string;
     } & {
-      " arkInferred": (In: string) => arktype_internal_attributes_ts5.To<string>;
+      " arkInferred": (In: string) => arktype_internal_attributes_ts0.To<string>;
     }>;
-    url: arktype16.Submodule<arktype_internal_keywords_string_ts10.url.$ & {
+    url: arktype0.Submodule<arktype_internal_keywords_string_ts0.url.$ & {
       " arkInferred": string;
     }>;
-    uuid: arktype16.Submodule<arktype_internal_keywords_string_ts10.uuid.$ & {
+    uuid: arktype0.Submodule<arktype_internal_keywords_string_ts0.uuid.$ & {
       " arkInferred": string;
     }>;
     " arkInferred": string;
     host: string;
   }>;
-  number: arktype16.Submodule<{
+  number: arktype0.Submodule<{
     NaN: number;
     Infinity: number;
     root: number;
@@ -76,88 +78,108 @@ declare const $: arktype16.Scope<{
     epoch: number;
     safe: number;
     NegativeInfinity: number;
-    port: (In: string) => arktype16.Out<number>;
+    port: (In: string) => arktype0.Out<number>;
   }>;
-  boolean: (In: boolean | "false" | "true") => arktype16.Out<boolean>;
+  boolean: (In: boolean | "false" | "true") => arktype0.Out<boolean>;
 }>;
 //#endregion
+//#endregion
+//#region ../internal/types/dist/infer-type.d.ts
+/**
+ * Extract the inferred type from an ArkType type definition by checking its call signature.
+ * When a type definition is called, it returns either the validated value or type.errors.
+ *
+ * @template T - The ArkType type definition to infer from
+ */
+type InferType<T> = T extends ((value: Record<string, string | undefined>) => infer R) ? R extends type$1.errors ? never : R : T extends type$1.Any<infer U, infer _Scope> ? U : never;
+//#endregion
+//#region ../internal/types/dist/schema.d.ts
+declare const SchemaShape: arktype_internal_variants_object_ts0.ObjectType<{
+  [x: string]: unknown;
+}, {}>;
+type SchemaShape = typeof SchemaShape.infer;
+type EnvSchemaWithType = Type<SchemaShape, (typeof $)["t"]>;
+//#endregion
 //#region src/create-env.d.ts
+type EnvSchema<def$1> = type$1.validate<def$1, (typeof $)["t"]>;
 type RuntimeEnvironment = Record<string, string | undefined>;
-type EnvSchema<def> = type$1.validate<def, (typeof $)["t"]>;
 /**
- * TODO: If possible, find a better type than "const T extends Record<string, unknown>",
+ * TODO: `SchemaShape` is basically `Record<string, unknown>`.
+ * If possible, find a better type than "const T extends Record<string, unknown>",
  * and be as close as possible to the type accepted by ArkType's `type`.
  */
 /**
  * Create an environment variables object from a schema and an environment
- * @param def - The environment variable schema
+ * @param def - The environment variable schema (raw object or type definition created with `type()`)
  * @param env - The environment variables to validate, defaults to `process.env`
  * @returns The validated environment variable schema
  * @throws An {@link ArkEnvError | error} if the environment variables are invalid.
  */
-declare function createEnv<const T extends Record<string, unknown>>(def: EnvSchema<T>, env?: RuntimeEnvironment): distill.Out<type$1.infer<T, (typeof $)["t"]>>;
+declare function createEnv<T extends EnvSchemaWithType>(def: T, env?: RuntimeEnvironment): InferType<T>;
+declare function createEnv<const T extends SchemaShape>(def: EnvSchema<T>, env?: RuntimeEnvironment): distill.Out<type$1.infer<T, (typeof $)["t"]>>;
+declare function createEnv<const T extends SchemaShape>(def: EnvSchema<T> | EnvSchemaWithType, env?: RuntimeEnvironment): distill.Out<type$1.infer<T, (typeof $)["t"]>> | InferType<typeof def>;
 //#endregion
 //#region src/type.d.ts
 declare const type: arktype_internal_type_ts0.TypeParser<{
-  string: arktype16.Submodule<{
-    trim: arktype16.Submodule<arktype_internal_keywords_string_ts10.trim.$ & {
-      " arkInferred": (In: string) => arktype_internal_attributes_ts5.To<string>;
+  string: arktype0.Submodule<{
+    trim: arktype0.Submodule<arktype_internal_keywords_string_ts0.trim.$ & {
+      " arkInferred": (In: string) => arktype_internal_attributes_ts0.To<string>;
     }>;
-    normalize: arktype16.Submodule<arktype_internal_keywords_string_ts10.normalize.$ & {
-      " arkInferred": (In: string) => arktype_internal_attributes_ts5.To<string>;
+    normalize: arktype0.Submodule<arktype_internal_keywords_string_ts0.normalize.$ & {
+      " arkInferred": (In: string) => arktype_internal_attributes_ts0.To<string>;
     }>;
     root: string;
     alpha: string;
     alphanumeric: string;
     hex: string;
-    base64: arktype16.Submodule<{
+    base64: arktype0.Submodule<{
       root: string;
       url: string;
     } & {
       " arkInferred": string;
     }>;
-    capitalize: arktype16.Submodule<arktype_internal_keywords_string_ts10.capitalize.$ & {
-      " arkInferred": (In: string) => arktype_internal_attributes_ts5.To<string>;
+    capitalize: arktype0.Submodule<arktype_internal_keywords_string_ts0.capitalize.$ & {
+      " arkInferred": (In: string) => arktype_internal_attributes_ts0.To<string>;
     }>;
     creditCard: string;
-    date: arktype16.Submodule<arktype_internal_keywords_string_ts10.stringDate.$ & {
+    date: arktype0.Submodule<arktype_internal_keywords_string_ts0.stringDate.$ & {
       " arkInferred": string;
     }>;
     digits: string;
     email: string;
-    integer: arktype16.Submodule<arktype_internal_keywords_string_ts10.stringInteger.$ & {
+    integer: arktype0.Submodule<arktype_internal_keywords_string_ts0.stringInteger.$ & {
       " arkInferred": string;
     }>;
-    ip: arktype16.Submodule<arktype_internal_keywords_string_ts10.ip.$ & {
+    ip: arktype0.Submodule<arktype_internal_keywords_string_ts0.ip.$ & {
       " arkInferred": string;
     }>;
-    json: arktype16.Submodule<arktype_internal_keywords_string_ts10.stringJson.$ & {
+    json: arktype0.Submodule<arktype_internal_keywords_string_ts0.stringJson.$ & {
       " arkInferred": string;
     }>;
-    lower: arktype16.Submodule<arktype_internal_keywords_string_ts10.lower.$ & {
-      " arkInferred": (In: string) => arktype_internal_attributes_ts5.To<string>;
+    lower: arktype0.Submodule<arktype_internal_keywords_string_ts0.lower.$ & {
+      " arkInferred": (In: string) => arktype_internal_attributes_ts0.To<string>;
     }>;
-    numeric: arktype16.Submodule<arktype_internal_keywords_string_ts10.stringNumeric.$ & {
+    numeric: arktype0.Submodule<arktype_internal_keywords_string_ts0.stringNumeric.$ & {
       " arkInferred": string;
     }>;
     regex: string;
     semver: string;
-    upper: arktype16.Submodule<{
-      root: (In: string) => arktype_internal_attributes_ts5.To<string>;
+    upper: arktype0.Submodule<{
+      root: (In: string) => arktype_internal_attributes_ts0.To<string>;
       preformatted: string;
     } & {
-      " arkInferred": (In: string) => arktype_internal_attributes_ts5.To<string>;
+      " arkInferred": (In: string) => arktype_internal_attributes_ts0.To<string>;
     }>;
-    url: arktype16.Submodule<arktype_internal_keywords_string_ts10.url.$ & {
+    url: arktype0.Submodule<arktype_internal_keywords_string_ts0.url.$ & {
       " arkInferred": string;
     }>;
-    uuid: arktype16.Submodule<arktype_internal_keywords_string_ts10.uuid.$ & {
+    uuid: arktype0.Submodule<arktype_internal_keywords_string_ts0.uuid.$ & {
       " arkInferred": string;
     }>;
     " arkInferred": string;
     host: string;
   }>;
-  number: arktype16.Submodule<{
+  number: arktype0.Submodule<{
     NaN: number;
     Infinity: number;
     root: number;
@@ -166,9 +188,9 @@ declare const type: arktype_internal_type_ts0.TypeParser<{
     epoch: number;
     safe: number;
     NegativeInfinity: number;
-    port: (In: string) => arktype16.Out<number>;
+    port: (In: string) => arktype0.Out<number>;
   }>;
-  boolean: (In: boolean | "false" | "true") => arktype16.Out<boolean>;
+  boolean: (In: boolean | "false" | "true") => arktype0.Out<boolean>;
 }>;
 //#endregion
 //#region src/errors.d.ts

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/scope.ts","../src/create-env.ts","../src/type.ts","../src/errors.ts","../src/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;cAQa,aAAC;;;;IAUZ,CAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WAVY,qBAAA,yDAAA;MAAA,cAAA,EAAA,MAAA;;;;ICJT,KAAA,qBAAqB,CAAM;MAEpB,IAAS,EAAA,CAAA,EAAA,EAAA,MAAA,EAAA,qCAAA,CAAA,MAAA,CAAA;MAAsB,YAAA,EAAA,MAAA;IAAa,CAAA,GAAA;MAAtB,cAAA,EAAA,CAAA,EAAA,EAAA,MAAA,EAAA,qCAAA,CAAA,MAAA,CAAA;IAAQ,CAAA,CAAA;IAc1B,GAAA,qBAAS,+CAAA;MAAiB,cAAA,EAAA,MAAA;IAC1B,CAAA,CAAA;IAAV,IAAA,qBAAA,gDAAA;MACA,cAAA,EAAA,MAAA;IACoB,CAAA,CAAA;IAAW,cAAA,EAAA,MAAA;IAAjB,IAAA,EAAA,MAAA;EAAjB,CAAA,CAAA;EAAW,MAAA,qBAAA,CAAA;;;;ICrBD,OAAa,EAAA,MAAA;;;;;;;;;;;KDErB,kBAAA,GAAqB;KAEd,iBAAiB,MAAA,CAAK,SAAS,aAAa;;;;ADExD;;;;;;;;iBCYgB,0BAA0B,8BACpC,UAAU,UACV,qBACH,OAAA,CAAQ,IAAI,MAAA,CAAK,MAAM,WAAW;;;cCrBxB,gCAAI;;;;;;;IFgBf,CAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;SAVY,EAAA,MAAA;IAAA,MAAA,EAAA,MAAA;;;;ICJT,CAAA,GAAA;MAEO,cAAS,EAAA,CAAA,EAAA,EAAA,MAAA,EAAA,qCAAA,CAAA,MAAA,CAAA;IAAsB,CAAA,CAAA;IAAa,GAAA,qBAAA,+CAAA;MAAtB,cAAA,EAAA,MAAA;IAAQ,CAAA,CAAA;IAc1B,IAAA,qBAAS,gDAAA;MAAiB,cAAA,EAAA,MAAA;IAC1B,CAAA,CAAA;IAAV,cAAA,EAAA,MAAA;IACA,IAAA,EAAA,MAAA;EACoB,CAAA,CAAA;EAAW,MAAA,qBAAA,CAAA;IAAjB,GAAA,EAAA,MAAA;IAAjB,QAAQ,EAAA,MAAA;IAAG,IAAA,EAAA,MAAA;;;;ICrBD,IAAa,EAAA,MAAA;;;;;;;;AFMb,cGqBA,WAAA,SAAoB,KAAA,CHX/B;sBGaQ;;;;;;;;;AHvBV,cICM,MJSJ,EAAA,OITU,SJSV"}
+{"version":3,"file":"index.d.ts","names":["arktype0","arktype_internal_keywords_string_ts0","arktype_internal_attributes_ts0","$","trim","To","Submodule","normalize","capitalize","stringDate","stringInteger","ip","stringJson","lower","stringNumeric","url","uuid","Out","Scope","type","InferType","T","Record","R","errors","Any","U","$","Type","SchemaShape","arktype_internal_variants_object_ts0","ObjectType","infer","EnvSchemaWithType"],"sources":["../../internal/scope/dist/index.d.ts","../../internal/types/dist/infer-type.d.ts","../../internal/types/dist/schema.d.ts","../src/create-env.ts","../src/type.ts","../src/errors.ts","../src/index.ts"],"sourcesContent":["import * as arktype0 from \"arktype\";\nimport * as arktype_internal_keywords_string_ts0 from \"arktype/internal/keywords/string.ts\";\nimport * as arktype_internal_attributes_ts0 from \"arktype/internal/attributes.ts\";\n\n//#region src/index.d.ts\n/**\n * The root scope for the ArkEnv library, containing extensions to the ArkType scopes with ArkEnv-specific types like `string.host` and `number.port`.\n */\ndeclare const $: arktype0.Scope<{\n  string: arktype0.Submodule<{\n    trim: arktype0.Submodule<arktype_internal_keywords_string_ts0.trim.$ & {\n      \" arkInferred\": (In: string) => arktype_internal_attributes_ts0.To<string>;\n    }>;\n    normalize: arktype0.Submodule<arktype_internal_keywords_string_ts0.normalize.$ & {\n      \" arkInferred\": (In: string) => arktype_internal_attributes_ts0.To<string>;\n    }>;\n    root: string;\n    alpha: string;\n    alphanumeric: string;\n    hex: string;\n    base64: arktype0.Submodule<{\n      root: string;\n      url: string;\n    } & {\n      \" arkInferred\": string;\n    }>;\n    capitalize: arktype0.Submodule<arktype_internal_keywords_string_ts0.capitalize.$ & {\n      \" arkInferred\": (In: string) => arktype_internal_attributes_ts0.To<string>;\n    }>;\n    creditCard: string;\n    date: arktype0.Submodule<arktype_internal_keywords_string_ts0.stringDate.$ & {\n      \" arkInferred\": string;\n    }>;\n    digits: string;\n    email: string;\n    integer: arktype0.Submodule<arktype_internal_keywords_string_ts0.stringInteger.$ & {\n      \" arkInferred\": string;\n    }>;\n    ip: arktype0.Submodule<arktype_internal_keywords_string_ts0.ip.$ & {\n      \" arkInferred\": string;\n    }>;\n    json: arktype0.Submodule<arktype_internal_keywords_string_ts0.stringJson.$ & {\n      \" arkInferred\": string;\n    }>;\n    lower: arktype0.Submodule<arktype_internal_keywords_string_ts0.lower.$ & {\n      \" arkInferred\": (In: string) => arktype_internal_attributes_ts0.To<string>;\n    }>;\n    numeric: arktype0.Submodule<arktype_internal_keywords_string_ts0.stringNumeric.$ & {\n      \" arkInferred\": string;\n    }>;\n    regex: string;\n    semver: string;\n    upper: arktype0.Submodule<{\n      root: (In: string) => arktype_internal_attributes_ts0.To<string>;\n      preformatted: string;\n    } & {\n      \" arkInferred\": (In: string) => arktype_internal_attributes_ts0.To<string>;\n    }>;\n    url: arktype0.Submodule<arktype_internal_keywords_string_ts0.url.$ & {\n      \" arkInferred\": string;\n    }>;\n    uuid: arktype0.Submodule<arktype_internal_keywords_string_ts0.uuid.$ & {\n      \" arkInferred\": string;\n    }>;\n    \" arkInferred\": string;\n    host: string;\n  }>;\n  number: arktype0.Submodule<{\n    NaN: number;\n    Infinity: number;\n    root: number;\n    integer: number;\n    \" arkInferred\": number;\n    epoch: number;\n    safe: number;\n    NegativeInfinity: number;\n    port: (In: string) => arktype0.Out<number>;\n  }>;\n  boolean: (In: boolean | \"false\" | \"true\") => arktype0.Out<boolean>;\n}>;\n//#endregion\nexport { $ };\n//# sourceMappingURL=index.d.ts.map","import type { type } from \"arktype\";\n/**\n * Extract the inferred type from an ArkType type definition by checking its call signature.\n * When a type definition is called, it returns either the validated value or type.errors.\n *\n * @template T - The ArkType type definition to infer from\n */\nexport type InferType<T> = T extends (value: Record<string, string | undefined>) => infer R ? R extends type.errors ? never : R : T extends type.Any<infer U, infer _Scope> ? U : never;\n//# sourceMappingURL=infer-type.d.ts.map","import type { $ } from \"@repo/scope\";\nimport { type Type } from \"arktype\";\nexport declare const SchemaShape: import(\"arktype/internal/variants/object.ts\").ObjectType<{\n    [x: string]: unknown;\n}, {}>;\nexport type SchemaShape = typeof SchemaShape.infer;\nexport type EnvSchemaWithType = Type<SchemaShape, (typeof $)[\"t\"]>;\n//# sourceMappingURL=schema.d.ts.map"],"mappings":";;;;;;;;;;;;AAEkF,cAMpEG,CAuEZ,EAvEeH,QAAAA,CAASkB,KAuExB,CAAA;EArE2BjB,MAAAA,EADnBD,QAAAA,CAASM,SACUL,CAAAA;IACSC,IAAAA,EAD5BF,QAAAA,CAASM,SACmBJ,CADTD,oCAAAA,CAAqCG,IAAAA,CAAKD,CACDE,GAAAA;MAD5DL,cAASM,EAAAA,CAAAA,EAAAA,EAAAA,MAAAA,EAAAA,GACmBJ,+BAAAA,CAAgCG,EADnDC,CAAAA,MAAAA,CAAAA;IAGeL,CAAAA,CAAAA;IACIC,SAAAA,EADvBF,QAAAA,CAASM,SAC8CD,CADpCJ,oCAAAA,CAAqCM,SAAAA,CAAUJ,CACXE,GAAAA;MADvDL,cAASM,EAAAA,CAAAA,EAAAA,EAAAA,MAAAA,EAAAA,GACcJ,+BAAAA,CAAgCG,EAD9CC,CAAAA,MAAAA,CAAAA;IAOZN,CAAAA,CAAAA;IAMuBC,IAAAA,EAAAA,MAAAA;IACGC,KAAAA,EAAAA,MAAAA;IADtBF,YAASM,EAAAA,MAAAA;IAIIL,GAAAA,EAAAA,MAAAA;IAAnBD,MAASM,EAVPN,QAAAA,CAASM,SAUFA,CAAAA;MAKaL,IAAAA,EAAAA,MAAAA;MAAnBD,GAAAA,EAASM,MAAAA;IAGKL,CAAAA,GAAAA;MAAnBD,cAASM,EAAAA,MAAAA;IAGYL,CAAAA,CAAAA;IAAnBD,UAASM,EAfHN,QAAAA,CAASM,SAeNA,CAfgBL,oCAAAA,CAAqCO,UAAAA,CAAWL,CAehEG,GAAAA;MAGWL,cAAAA,EAAAA,CAAAA,EAAAA,EAAAA,MAAAA,EAAAA,GAjBQC,+BAAAA,CAAgCG,EAiBGF,CAAAA,MAAAA,CAAAA;IACnCD,CAAAA,CAAAA;IAD3BF,UAASM,EAAAA,MAAAA;IAGYL,IAAAA,EAjBtBD,QAAAA,CAASM,SAiBaL,CAjBHA,oCAAAA,CAAqCQ,UAAAA,CAAWN,CAiBMA,GAAAA;MAAtEH,cAASM,EAAAA,MAAAA;IAMMJ,CAAAA,CAAAA;IAGUA,MAAAA,EAAAA,MAAAA;IAJ3BF,KAAAA,EAASM,MAAAA;IAMQL,OAAAA,EAvBfD,QAAAA,CAASM,SAuBML,CAvBIA,oCAAAA,CAAqCS,aAAAA,CAAcP,CAuBdA,GAAAA;MAA5DH,cAASM,EAAAA,MAAAA;IAGWL,CAAAA,CAAAA;IAAnBD,EAAAA,EAvBFA,QAAAA,CAASM,SAuBEA,CAvBQL,oCAAAA,CAAqCU,EAAAA,CAAGR,CAuBhDG,GAAAA;MApDTN,cAASM,EAAAA,MAAAA;IAmEON,CAAAA,CAAAA;IAThBA,IAAAA,EA1BAA,QAAAA,CAASM,SA0BAA,CA1BUL,oCAAAA,CAAqCW,UAAAA,CAAWT,CA0B1DG,GAAAA;MAW4BN,cAASiB,EAAAA,MAAAA;IAtEvCjB,CAAAA,CAAAA;IAAc,KAAA,EAoCpBA,QAAAA,CAASM,SApCW,CAoCDL,oCAAAA,CAAqCY,KAAAA,CAAMV,CApC1C,GAAA;sCAqCOD,+BAAAA,CAAgCG;;aAEzDL,QAAAA,CAASM,UAAUL,oCAAAA,CAAqCa,aAAAA,CAAcX;MCxCvEiB,cAAS,EAAAC,MAAA;IAAMA,CAAAA,CAAAA;IAAkBC,KAAAA,EAAAA,MAAAA;IAAiDC,MAAAA,EAAAA,MAAAA;IAAUJ,KAAKK,ED6ClGxB,QAAAA,CAASM,SC7CyFkB,CAAAA;MAAiBD,IAAAA,EAAAA,CAAAA,EAAAA,EAAAA,MAAAA,EAAAA,GD8ClGrB,+BAAAA,CAAgCG,EC9CkEkB,CAAAA,MAAAA,CAAAA;MAAIF,YAAAA,EAAAA,MAAAA;IAAUF,CAAAA,GAAKM;MAA6BC,cAAAA,EAAAA,CAAAA,EAAAA,EAAAA,MAAAA,EAAAA,GDiDxIxB,+BAAAA,CAAgCG,ECjDwGqB,CAAAA,MAAAA,CAAAA;IAAC,CAAA,CAAA;SDmDtK1B,QAAAA,CAASM,UAAUL,oCAAAA,CAAqCc,GAAAA,CAAIZ;;;IExDhD0B,IAAAA,EF2DX7B,QAAAA,CAASM,SEzDb,CFyDuBL,oCAAAA,CAAqCe,IAAAA,CAAKb,CE3DS4B,GAAAA;MAGpEF,cAAW,EAAA,MAAA;IACXI,CAAAA,CAAAA;IAAyBJ,cAAAA,EAAAA,MAAAA;IAAqBF,IAAAA,EAAAA,MAAAA;EAA1BC,CAAAA,CAAAA;EAAI,MAAA,EF6D1B5B,QAAAA,CAASM,SE7DiB,CAAA;;;;ICAxB,OAAA,EAAA,MAAS;IAAoB,cAAA,EAAA,MAAA;IAAa,KAAA,EAAA,MAAA;IAAzB,IAAG,EAAA,MAAA;IAAQ,gBAAA,EAAA,MAAA;IACnC,IAAA,EAAA,CAAA,EAAA,EAAA,MAAA,EAAA,GHqEqBN,QAAAA,CAASiB,GGrET,CAAA,MAAM,CAAA;EAehC,CAAA,CAAgB;EAAoB,OAAA,EAAA,CAAA,EAAA,EAAA,OAAA,GAAA,OAAA,GAAA,MAAA,EAAA,GHwDWjB,QAAAA,CAASiB,GGxDpB,CAAA,OAAA,CAAA;CAC9B,CAAA;;;;;;;;;;KFhBMG,eAAeC,mBAAkBC,kDAAiDC,UAAUJ,MAAAA,CAAKK,iBAAiBD,IAAIF,UAAUF,MAAAA,CAAKM,6BAA6BC;;;cCLzJG,aAEfC,oCAAAA,CAF0EC;;;KAGpEF,WAAAA,UAAqBA,WAAAA,CAAYG;KACjCC,iBAAAA,GAAoBL,KAAKC,qBAAqBF;;;KCA9C,mBAAiB,MAAA,CAAG,SAAS,eAAa;KACjD,kBAAA,GAAqB;;;;AHLwD;;;;;;;;;AAyB5CzB,iBGLtB,SHKsDG,CAAAA,UGLlC,iBHKkCA,CAAAA,CAAAA,GAAAA,EGJhE,CHIgEA,EAAAA,GAAAA,CAAAA,EGH/D,kBHG+DA,CAAAA,EGFnE,SHEmEA,CGFzD,CHEyDA,CAAAA;AADtDL,iBGAA,SHASM,CAAAA,gBGAiB,WHAjBA,CAAAA,CAAAA,GAAAA,EGCnB,SHDmBA,CGCT,CHDSA,CAAAA,EAAAA,GAAAA,CAAAA,EGElB,kBHFkBA,CAAAA,EGGtB,OAAA,CAAQ,GHHcA,CGGV,MAAA,CAAG,KHHOA,CGGD,CHHCA,EAAAA,CAAAA,OGGU,CHHVA,CAAAA,CAAAA,GAAAA,CAAAA,CAAAA,CAAAA;AAIIL,iBGAb,SHAaA,CAAAA,gBGAa,WHAmCE,CAAAA,CAAAA,GAAAA,EGCvE,SHDuEA,CGC7D,CHD6DA,CAAAA,GGCxD,iBHDwDA,EAAAA,GAAAA,CAAAA,EGEtE,kBHFsEA,CAAAA,EGG1E,OAAA,CAAQ,GHHkEA,CGG9D,MAAA,CAAG,KHH2DA,CGGrD,CHHqDA,EAAAA,CAAAA,OGG1C,CHH0CA,CAAAA,CAAAA,GAAAA,CAAAA,CAAAA,CAAAA,GGG9B,SHH8BA,CAAAA,OGGb,GHHaA,CAAAA;;;cI5BhE,gCAAI;;;;;;;;IJ6Ef,IAAA,EAAA,MAAA;IArE2BF,KAAAA,EAAAA,MAAAA;IACSC,YAAAA,EAAAA,MAAAA;IAD5BF,GAASM,EAAAA,MAAAA;IAGeL,MAAAA,oBAAqCM,CAAAA;MACjCL,IAAAA,EAAAA,MAAAA;MADdI,GAAAA,EAAAA,MAAAA;IAOZN,CAAAA,GAASM;MAMcL,cAAAA,EAAAA,MAAAA;IACGC,CAAAA,CAAAA;IADtBF,UAASM,oBAAAA,qDAAAA;MAIIL,cAAAA,EAAAA,CAAAA,EAAAA,EAAAA,MAAqCQ,EAAAA,qCAAWN,CAAAA,MAAAA,CAAAA;IAAnEH,CAAAA,CAASM;IAKaL,UAAAA,EAAAA,MAAAA;IAAnBD,IAASM,oBAAAA,qDAAAA;MAGKL,cAAAA,EAAAA,MAAAA;IAAnBD,CAAAA,CAASM;IAGYL,MAAAA,EAAAA,MAAAA;IAAnBD,KAASM,EAAAA,MAAAA;IAGWL,OAAAA,oBAA2CE,wDAAAA;MACnCD,cAAAA,EAAAA,MAAgCG;IAD3DL,CAAAA,CAASM;IAGYL,EAAAA,oBAAqCa,6CAAcX;MAA7DG,cAAAA,EAAAA,MAAAA;IAMMJ,CAAAA,CAAAA;IAGUA,IAAAA,oBAAgCG,qDAAAA;MAJlDC,cAAAA,EAAAA,MAAAA;IAMQL,CAAAA,CAAAA;IAAnBD,KAASM,oBAAAA,gDAAAA;MAGWL,cAAAA,EAAAA,CAAAA,EAAAA,EAAAA,MAAqCe,EAAAA,qCAAKb,CAAAA,MAAAA,CAAAA;IAA7DH,CAAAA,CAASM;IApDTN,OAASM,oBAAAA,wDAAAA;MAmEgBW,cAAAA,EAAAA,MAAAA;IATzBjB,CAAAA,CAASM;IAW4BN,KAASiB,EAAAA,MAAAA;IAtEvCjB,MAASkB,EAAAA,MAAAA;IAAK,KAAA,oBAAA,CAAA;;;;MCDnBE,cAASC,EAAA,CAAA,EAAA,EAAA,MAAA,EAAA,qCAAA,CAAA,MAAA,CAAA;IAAMA,CAAAA,CAAAA;IAAkBC,GAAAA,oBAAAA,8CAAAA;MAAiDC,cAAAA,EAAAA,MAAAA;IAAeC,CAAAA,CAAAA;IAAiBD,IAAAA,oBAAAA,+CAAAA;MAAIF,cAAAA,EAAAA,MAAAA;IAAeI,CAAAA,CAAAA;IAA6BC,cAAAA,EAAAA,MAAAA;IAAC,IAAA,EAAA,MAAA;;;;ICL1JG,QAAAA,EAEf,MAAA;IACMA,IAAAA,EAAAA,MAAW;IACXI,OAAAA,EAAAA,MAAAA;IAAyBJ,cAAAA,EAAAA,MAAAA;IAAqBF,KAAAA,EAAAA,MAAAA;IAA1BC,IAAAA,EAAAA,MAAAA;IAAI,gBAAA,EAAA,MAAA;;;;ACApC,CAAA,CAAA;;;cEsBa,WAAA,SAAoB,KAAA;ELpBnBzB,WAuEZ,CAAA,MAAA,EKjDQ,SLiDR,EAAA,OAAA,CAAA,EAAA,MAAA;;;;;;;;;cMtEI,eAAM"}

package/dist/index.js

@@ -1,5 +1,5 @@
-import{scope as e,type as t}from"arktype";const n={red:`\x1B[31m`,yellow:`\x1B[33m`,cyan:`\x1B[36m`,reset:`\x1B[0m`},r=()=>typeof process<`u`&&process.versions!=null&&process.versions.node!=null,i=()=>!!(!r()||process.env.NO_COLOR!==void 0||process.env.CI!==void 0||process.stdout&&!process.stdout.isTTY),a=(e,t)=>r()&&!i()?`${n[e]}${t}${n.reset}`:t,o=(e,t=2,{dontDetectNewlines:n=!1}={})=>n?`${` `.repeat(t)}${e}`:e.split(`
+import{scope as e,type as t}from"arktype";const n=t(`string`,`=>`,(e,t)=>{let n=Number.parseInt(e,10);return(!Number.isInteger(n)||!(0<=n&&n<=65535))&&t.mustBe(`an integer between 0 and 65535`),n}),r=t(`string.ip | 'localhost'`),i=t(`'true' | 'false' | true | false`,`=>`,e=>e===`true`||e===!0),a=e({string:t.module({...t.keywords.string,host:r}),number:t.module({...t.keywords.number,port:n}),boolean:i}),o=(e,t=2,{dontDetectNewlines:n=!1}={})=>n?`${` `.repeat(t)}${e}`:e.split(`
 `).map(e=>`${` `.repeat(t)}${e}`).join(`
-`),s=e=>Object.entries(e.byPath).map(([e,t])=>{let n=t.message.startsWith(e)?t.message.slice(e.length):t.message,r=n.match(/\(was "([^"]+)"\)/),i=r?n.replace(`(was "${r[1]}")`,`(was ${a(`cyan`,`"${r[1]}"`)})`):n;return`${a(`yellow`,e)}${i}`}).join(`
-`);var c=class extends Error{constructor(e,t=`Errors found while validating environment variables`){super(`${a(`red`,t)}\n${o(s(e))}\n`),this.name=`ArkEnvError`}};const l=t(`string`,`=>`,(e,t)=>{let n=Number.parseInt(e,10);return(!Number.isInteger(n)||!(0<=n&&n<=65535))&&t.mustBe(`an integer between 0 and 65535`),n}),u=t(`string.ip | 'localhost'`),d=t(`'true' | 'false' | true | false`,`=>`,e=>e===`true`||e===!0),f=e({string:t.module({...t.keywords.string,host:u}),number:t.module({...t.keywords.number,port:l}),boolean:d});function p(e,n=process.env){let r=f.type.raw(e)(n);if(r instanceof t.errors)throw new c(r);return r}const m=f.type;var h=p;export{c as ArkEnvError,p as createEnv,h as default,m as type};
+`),s={red:`\x1B[31m`,yellow:`\x1B[33m`,cyan:`\x1B[36m`,reset:`\x1B[0m`},c=()=>typeof process<`u`&&process.versions!=null&&process.versions.node!=null,l=()=>!!(!c()||process.env.NO_COLOR!==void 0||process.env.CI!==void 0||process.stdout&&!process.stdout.isTTY),u=(e,t)=>c()&&!l()?`${s[e]}${t}${s.reset}`:t,d=e=>Object.entries(e.byPath).map(([e,t])=>{let n=t.message.startsWith(e)?t.message.slice(e.length):t.message,r=n.match(/\(was "([^"]+)"\)/),i=r?n.replace(`(was "${r[1]}")`,`(was ${u(`cyan`,`"${r[1]}"`)})`):n;return`${u(`yellow`,e)}${i}`}).join(`
+`);var f=class extends Error{constructor(e,t=`Errors found while validating environment variables`){super(`${u(`red`,t)}\n${o(d(e))}\n`),this.name=`ArkEnvError`}};const p=a.type;function m(e,t=process.env){let n=(typeof e==`function`&&`assert`in e?e:a.type.raw(e))(t);if(n instanceof p.errors)throw new f(n);return n}var h=m;export{f as ArkEnvError,m as createEnv,h as default,p as type};
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["type","type","type"],"sources":["../src/lib/style-text.ts","../src/utils.ts","../src/errors.ts","../src/types.ts","../src/scope.ts","../src/create-env.ts","../src/type.ts","../src/index.ts"],"sourcesContent":["/**\n * Cross-platform text styling utility\n * Uses ANSI colors in Node environments, plain text in browsers\n * Respects NO_COLOR, CI environment variables, and TTY detection\n */\n\n// ANSI color codes for Node environments\nconst colors = {\n\tred: \"\\x1b[31m\",\n\tyellow: \"\\x1b[33m\",\n\tcyan: \"\\x1b[36m\",\n\treset: \"\\x1b[0m\",\n} as const;\n\n/**\n * Check if we're in a Node environment (not browser)\n * Checked dynamically to allow for testing with mocked globals\n */\nconst isNode = (): boolean =>\n\ttypeof process !== \"undefined\" &&\n\tprocess.versions != null &&\n\tprocess.versions.node != null;\n\n/**\n * Check if colors should be disabled based on environment\n * Respects NO_COLOR, CI environment variables, and TTY detection\n */\nconst shouldDisableColors = (): boolean => {\n\tif (!isNode()) return true;\n\n\t// Respect NO_COLOR environment variable (https://no-color.org/)\n\tif (process.env.NO_COLOR !== undefined) return true;\n\n\t// Disable colors in CI environments by default\n\tif (process.env.CI !== undefined) return true;\n\n\t// Disable colors if not writing to a TTY\n\tif (process.stdout && !process.stdout.isTTY) return true;\n\n\treturn false;\n};\n\n/**\n * Style text with color. Uses ANSI codes in Node, plain text in browsers.\n * @param color - The color to apply\n * @param text - The text to style\n * @returns Styled text in Node (if colors enabled), plain text otherwise\n */\nexport const styleText = (\n\tcolor: \"red\" | \"yellow\" | \"cyan\",\n\ttext: string,\n): string => {\n\t// Use ANSI colors only in Node environments with colors enabled\n\tif (isNode() && !shouldDisableColors()) {\n\t\treturn `${colors[color]}${text}${colors.reset}`;\n\t}\n\t// Fall back to plain text in browsers or when colors are disabled\n\treturn text;\n};\n","/**\n * Options for the `indent` function\n */\ntype IndentOptions = {\n\t/**\n\t * Whether to detect newlines and indent each line individually, defaults to false (indenting the whole string)\n\t */\n\tdontDetectNewlines?: boolean;\n};\n\n/**\n * Indent a string by a given amount\n * @param str - The string to indent\n * @param amt - The amount to indent by, defaults to 2\n * @param options - {@link IndentOptions}\n * @returns The indented string\n */\nexport const indent = (\n\tstr: string,\n\tamt = 2,\n\t{ dontDetectNewlines = false }: IndentOptions = {},\n) => {\n\tconst detectNewlines = !dontDetectNewlines;\n\tif (detectNewlines) {\n\t\treturn str\n\t\t\t.split(\"\\n\")\n\t\t\t.map((line) => `${\" \".repeat(amt)}${line}`)\n\t\t\t.join(\"\\n\");\n\t}\n\n\treturn `${\" \".repeat(amt)}${str}`;\n};\n","import type { ArkErrors } from \"arktype\";\nimport { styleText } from \"./lib/style-text\";\nimport { indent } from \"./utils\";\n\n/**\n * Format the errors returned by ArkType to be more readable\n * @param errors - The errors returned by ArkType\n * @returns A string of the formatted errors\n */\nexport const formatErrors = (errors: ArkErrors): string =>\n\tObject.entries(errors.byPath)\n\t\t.map(([path, error]) => {\n\t\t\tconst messageWithoutPath = error.message.startsWith(path)\n\t\t\t\t? error.message.slice(path.length)\n\t\t\t\t: error.message;\n\n\t\t\t// Extract the value in parentheses if it exists\n\t\t\tconst valueMatch = messageWithoutPath.match(/\\(was \"([^\"]+)\"\\)/);\n\t\t\tconst formattedMessage = valueMatch\n\t\t\t\t? messageWithoutPath.replace(\n\t\t\t\t\t\t`(was \"${valueMatch[1]}\")`,\n\t\t\t\t\t\t`(was ${styleText(\"cyan\", `\"${valueMatch[1]}\"`)})`,\n\t\t\t\t\t)\n\t\t\t\t: messageWithoutPath;\n\n\t\t\treturn `${styleText(\"yellow\", path)}${formattedMessage}`;\n\t\t})\n\t\t.join(\"\\n\");\n\nexport class ArkEnvError extends Error {\n\tconstructor(\n\t\terrors: ArkErrors,\n\t\tmessage = \"Errors found while validating environment variables\",\n\t) {\n\t\tsuper(`${styleText(\"red\", message)}\\n${indent(formatErrors(errors))}\\n`);\n\t\tthis.name = \"ArkEnvError\";\n\t}\n}\n","import { type } from \"arktype\";\n\n/**\n * A `string` that can be parsed into a number between 0 and 65535\n */\nexport const port = type(\"string\", \"=>\", (data, ctx) => {\n\tconst asNumber = Number.parseInt(data, 10);\n\tconst isInteger = Number.isInteger(asNumber);\n\tconst isBetween = 0 <= asNumber && asNumber <= 65535;\n\tif (!isInteger || !isBetween) {\n\t\tctx.mustBe(\"an integer between 0 and 65535\");\n\t}\n\treturn asNumber;\n});\n\n/**\n * An IP address or `\"localhost\"`\n */\nexport const host = type(\"string.ip | 'localhost'\");\n\n/**\n * A boolean that accepts string values and converts them to boolean\n * Accepts \"true\" or \"false\" strings and converts them to actual boolean values\n */\nexport const boolean = type(\n\t\"'true' | 'false' | true | false\",\n\t\"=>\",\n\t(str) => str === \"true\" || str === true,\n);\n","import { scope, type } from \"arktype\";\nimport { boolean, host, port } from \"./types\";\n\n// For an explanation of the `$` variable naming convention, see: https://discord.com/channels/957797212103016458/1414659167008063588/1414670282756587581\n\n/**\n * The root scope for the ArkEnv library, containing extensions to the ArkType scopes with ArkEnv-specific types like `string.host` and `number.port`.\n */\nexport const $ = scope({\n\tstring: type.module({\n\t\t...type.keywords.string,\n\t\thost,\n\t}),\n\tnumber: type.module({\n\t\t...type.keywords.number,\n\t\tport,\n\t}),\n\tboolean,\n});\n","import { type distill, type } from \"arktype\";\nimport { ArkEnvError } from \"./errors\";\nimport { $ } from \"./scope\";\n\ntype RuntimeEnvironment = Record<string, string | undefined>;\n\nexport type EnvSchema<def> = type.validate<def, (typeof $)[\"t\"]>;\n\n/**\n * TODO: If possible, find a better type than \"const T extends Record<string, unknown>\",\n * and be as close as possible to the type accepted by ArkType's `type`.\n */\n\n/**\n * Create an environment variables object from a schema and an environment\n * @param def - The environment variable schema\n * @param env - The environment variables to validate, defaults to `process.env`\n * @returns The validated environment variable schema\n * @throws An {@link ArkEnvError | error} if the environment variables are invalid.\n */\nexport function createEnv<const T extends Record<string, unknown>>(\n\tdef: EnvSchema<T>,\n\tenv: RuntimeEnvironment = process.env,\n): distill.Out<type.infer<T, (typeof $)[\"t\"]>> {\n\tconst schema = $.type.raw(def);\n\n\tconst validatedEnv = schema(env);\n\n\tif (validatedEnv instanceof type.errors) {\n\t\tthrow new ArkEnvError(validatedEnv);\n\t}\n\n\treturn validatedEnv;\n}\n","import { $ } from \"./scope\";\n\nexport const type = $.type;\n","export type { EnvSchema } from \"./create-env\";\n\nimport { createEnv } from \"./create-env\";\n\n/**\n * `arkenv`'s main export, an alias for {@link createEnv}\n *\n * {@link https://arkenv.js.org | ArkEnv} is a typesafe environment variables parser powered by {@link https://arktype.io | ArkType}, TypeScript's 1:1 validator.\n */\nconst arkenv = createEnv;\nexport default arkenv;\nexport { type } from \"./type\";\nexport { createEnv };\nexport { ArkEnvError } from \"./errors\";\n"],"mappings":"0CAOA,MAAM,EAAS,CACd,IAAK,WACL,OAAQ,WACR,KAAM,WACN,MAAO,UACP,CAMK,MACL,OAAO,QAAY,KACnB,QAAQ,UAAY,MACpB,QAAQ,SAAS,MAAQ,KAMpB,MAUL,GATI,CAAC,GAAQ,EAGT,QAAQ,IAAI,WAAa,IAAA,IAGzB,QAAQ,IAAI,KAAO,IAAA,IAGnB,QAAQ,QAAU,CAAC,QAAQ,OAAO,OAW1B,GACZ,EACA,IAGI,GAAQ,EAAI,CAAC,GAAqB,CAC9B,GAAG,EAAO,KAAS,IAAO,EAAO,QAGlC,ECxCK,GACZ,EACA,EAAM,EACN,CAAE,qBAAqB,IAAyB,EAAE,GAE1B,EAQjB,GAAG,IAAI,OAAO,EAAI,GAAG,IANpB,EACL,MAAM;EAAK,CACX,IAAK,GAAS,GAAG,IAAI,OAAO,EAAI,GAAG,IAAO,CAC1C,KAAK;EAAK,CClBD,EAAgB,GAC5B,OAAO,QAAQ,EAAO,OAAO,CAC3B,KAAK,CAAC,EAAM,KAAW,CACvB,IAAM,EAAqB,EAAM,QAAQ,WAAW,EAAK,CACtD,EAAM,QAAQ,MAAM,EAAK,OAAO,CAChC,EAAM,QAGH,EAAa,EAAmB,MAAM,oBAAoB,CAC1D,EAAmB,EACtB,EAAmB,QACnB,SAAS,EAAW,GAAG,IACvB,QAAQ,EAAU,OAAQ,IAAI,EAAW,GAAG,GAAG,CAAC,GAChD,CACA,EAEH,MAAO,GAAG,EAAU,SAAU,EAAK,GAAG,KACrC,CACD,KAAK;EAAK,CAEb,IAAa,EAAb,cAAiC,KAAM,CACtC,YACC,EACA,EAAU,sDACT,CACD,MAAM,GAAG,EAAU,MAAO,EAAQ,CAAC,IAAI,EAAO,EAAa,EAAO,CAAC,CAAC,IAAI,CACxE,KAAK,KAAO,gBC9Bd,MAAa,EAAOA,EAAK,SAAU,MAAO,EAAM,IAAQ,CACvD,IAAM,EAAW,OAAO,SAAS,EAAM,GAAG,CAM1C,OAHI,CAFc,OAAO,UAAU,EAAS,EAE1B,EADA,GAAK,GAAY,GAAY,SAE9C,EAAI,OAAO,iCAAiC,CAEtC,GACN,CAKW,EAAOA,EAAK,0BAA0B,CAMtC,EAAUA,EACtB,kCACA,KACC,GAAQ,IAAQ,QAAU,IAAQ,GACnC,CCpBY,EAAI,EAAM,CACtB,OAAQC,EAAK,OAAO,CACnB,GAAGA,EAAK,SAAS,OACjB,OACA,CAAC,CACF,OAAQA,EAAK,OAAO,CACnB,GAAGA,EAAK,SAAS,OACjB,OACA,CAAC,CACF,UACA,CAAC,CCEF,SAAgB,EACf,EACA,EAA0B,QAAQ,IACY,CAG9C,IAAM,EAFS,EAAE,KAAK,IAAI,EAAI,CAEF,EAAI,CAEhC,GAAI,aAAwBC,EAAK,OAChC,MAAM,IAAI,EAAY,EAAa,CAGpC,OAAO,EC9BR,MAAa,EAAO,EAAE,KCQtB,IAAA,EADe"}
+{"version":3,"file":"index.js","names":["e","n","t","r","i","t","n","e","$","$"],"sources":["../../internal/keywords/dist/index.js","../../internal/scope/dist/index.js","../src/utils/indent.ts","../src/utils/style-text.ts","../src/errors.ts","../src/type.ts","../src/create-env.ts","../src/index.ts"],"sourcesContent":["import{type as e}from\"arktype\";const t=e(`string`,`=>`,(e,t)=>{let n=Number.parseInt(e,10);return(!Number.isInteger(n)||!(0<=n&&n<=65535))&&t.mustBe(`an integer between 0 and 65535`),n}),n=e(`string.ip | 'localhost'`),r=e(`'true' | 'false' | true | false`,`=>`,e=>e===`true`||e===!0);export{r as boolean,n as host,t as port};\n//# sourceMappingURL=index.js.map","import{boolean as e,host as t,port as n}from\"@repo/keywords\";import{scope as r,type as i}from\"arktype\";const a=r({string:i.module({...i.keywords.string,host:t}),number:i.module({...i.keywords.number,port:n}),boolean:e});export{a as $};\n//# sourceMappingURL=index.js.map","/**\n * Options for the `indent` function\n */\ntype IndentOptions = {\n\t/**\n\t * Whether to detect newlines and indent each line individually, defaults to false (indenting the whole string)\n\t */\n\tdontDetectNewlines?: boolean;\n};\n\n/**\n * Indent a string by a given amount\n * @param str - The string to indent\n * @param amt - The amount to indent by, defaults to 2\n * @param options - {@link IndentOptions}\n * @returns The indented string\n */\nexport const indent = (\n\tstr: string,\n\tamt = 2,\n\t{ dontDetectNewlines = false }: IndentOptions = {},\n) => {\n\tconst detectNewlines = !dontDetectNewlines;\n\tif (detectNewlines) {\n\t\treturn str\n\t\t\t.split(\"\\n\")\n\t\t\t.map((line) => `${\" \".repeat(amt)}${line}`)\n\t\t\t.join(\"\\n\");\n\t}\n\n\treturn `${\" \".repeat(amt)}${str}`;\n};\n","/**\n * Cross-platform text styling utility\n * Uses ANSI colors in Node environments, plain text in browsers\n * Respects NO_COLOR, CI environment variables, and TTY detection\n */\n\n// ANSI color codes for Node environments\nconst colors = {\n\tred: \"\\x1b[31m\",\n\tyellow: \"\\x1b[33m\",\n\tcyan: \"\\x1b[36m\",\n\treset: \"\\x1b[0m\",\n} as const;\n\n/**\n * Check if we're in a Node environment (not browser)\n * Checked dynamically to allow for testing with mocked globals\n */\nconst isNode = (): boolean =>\n\ttypeof process !== \"undefined\" &&\n\tprocess.versions != null &&\n\tprocess.versions.node != null;\n\n/**\n * Check if colors should be disabled based on environment\n * Respects NO_COLOR, CI environment variables, and TTY detection\n */\nconst shouldDisableColors = (): boolean => {\n\tif (!isNode()) return true;\n\n\t// Respect NO_COLOR environment variable (https://no-color.org/)\n\tif (process.env.NO_COLOR !== undefined) return true;\n\n\t// Disable colors in CI environments by default\n\tif (process.env.CI !== undefined) return true;\n\n\t// Disable colors if not writing to a TTY\n\tif (process.stdout && !process.stdout.isTTY) return true;\n\n\treturn false;\n};\n\n/**\n * Style text with color. Uses ANSI codes in Node, plain text in browsers.\n * @param color - The color to apply\n * @param text - The text to style\n * @returns Styled text in Node (if colors enabled), plain text otherwise\n */\nexport const styleText = (\n\tcolor: \"red\" | \"yellow\" | \"cyan\",\n\ttext: string,\n): string => {\n\t// Use ANSI colors only in Node environments with colors enabled\n\tif (isNode() && !shouldDisableColors()) {\n\t\treturn `${colors[color]}${text}${colors.reset}`;\n\t}\n\t// Fall back to plain text in browsers or when colors are disabled\n\treturn text;\n};\n","import type { ArkErrors } from \"arktype\";\nimport { indent, styleText } from \"./utils\";\n\n/**\n * Format the errors returned by ArkType to be more readable\n * @param errors - The errors returned by ArkType\n * @returns A string of the formatted errors\n */\nexport const formatErrors = (errors: ArkErrors): string =>\n\tObject.entries(errors.byPath)\n\t\t.map(([path, error]) => {\n\t\t\tconst messageWithoutPath = error.message.startsWith(path)\n\t\t\t\t? error.message.slice(path.length)\n\t\t\t\t: error.message;\n\n\t\t\t// Extract the value in parentheses if it exists\n\t\t\tconst valueMatch = messageWithoutPath.match(/\\(was \"([^\"]+)\"\\)/);\n\t\t\tconst formattedMessage = valueMatch\n\t\t\t\t? messageWithoutPath.replace(\n\t\t\t\t\t\t`(was \"${valueMatch[1]}\")`,\n\t\t\t\t\t\t`(was ${styleText(\"cyan\", `\"${valueMatch[1]}\"`)})`,\n\t\t\t\t\t)\n\t\t\t\t: messageWithoutPath;\n\n\t\t\treturn `${styleText(\"yellow\", path)}${formattedMessage}`;\n\t\t})\n\t\t.join(\"\\n\");\n\nexport class ArkEnvError extends Error {\n\tconstructor(\n\t\terrors: ArkErrors,\n\t\tmessage = \"Errors found while validating environment variables\",\n\t) {\n\t\tsuper(`${styleText(\"red\", message)}\\n${indent(formatErrors(errors))}\\n`);\n\t\tthis.name = \"ArkEnvError\";\n\t}\n}\n","import { $ } from \"@repo/scope\";\n\nexport const type = $.type;\n","import { $ } from \"@repo/scope\";\nimport type { EnvSchemaWithType, InferType, SchemaShape } from \"@repo/types\";\nimport type { type as at, distill } from \"arktype\";\nimport { ArkEnvError } from \"./errors\";\nimport { type } from \"./type\";\n\nexport type EnvSchema<def> = at.validate<def, (typeof $)[\"t\"]>;\ntype RuntimeEnvironment = Record<string, string | undefined>;\n\n/**\n * TODO: `SchemaShape` is basically `Record<string, unknown>`.\n * If possible, find a better type than \"const T extends Record<string, unknown>\",\n * and be as close as possible to the type accepted by ArkType's `type`.\n */\n\n/**\n * Create an environment variables object from a schema and an environment\n * @param def - The environment variable schema (raw object or type definition created with `type()`)\n * @param env - The environment variables to validate, defaults to `process.env`\n * @returns The validated environment variable schema\n * @throws An {@link ArkEnvError | error} if the environment variables are invalid.\n */\nexport function createEnv<T extends EnvSchemaWithType>(\n\tdef: T,\n\tenv?: RuntimeEnvironment,\n): InferType<T>;\nexport function createEnv<const T extends SchemaShape>(\n\tdef: EnvSchema<T>,\n\tenv?: RuntimeEnvironment,\n): distill.Out<at.infer<T, (typeof $)[\"t\"]>>;\nexport function createEnv<const T extends SchemaShape>(\n\tdef: EnvSchema<T> | EnvSchemaWithType,\n\tenv?: RuntimeEnvironment,\n): distill.Out<at.infer<T, (typeof $)[\"t\"]>> | InferType<typeof def>;\nexport function createEnv<const T extends SchemaShape>(\n\tdef: EnvSchema<T> | EnvSchemaWithType,\n\tenv: RuntimeEnvironment = process.env,\n): distill.Out<at.infer<T, (typeof $)[\"t\"]>> | InferType<typeof def> {\n\t// If def is a type definition (has assert method), use it directly\n\t// Otherwise, use raw() to convert the schema definition\n\tconst schema =\n\t\ttypeof def === \"function\" && \"assert\" in def\n\t\t\t? def\n\t\t\t: $.type.raw(def as EnvSchema<T>);\n\n\tconst validatedEnv = schema(env);\n\n\tif (validatedEnv instanceof type.errors) {\n\t\tthrow new ArkEnvError(validatedEnv);\n\t}\n\n\treturn validatedEnv;\n}\n","export type { EnvSchema } from \"./create-env\";\n\nimport { createEnv } from \"./create-env\";\n\n/**\n * `arkenv`'s main export, an alias for {@link createEnv}\n *\n * {@link https://arkenv.js.org | ArkEnv} is a typesafe environment variables parser powered by {@link https://arktype.io | ArkType}, TypeScript's 1:1 validator.\n */\nconst arkenv = createEnv;\nexport default arkenv;\nexport { type } from \"./type\";\nexport { createEnv };\nexport { ArkEnvError } from \"./errors\";\n"],"mappings":"0CAA+B,MAAM,EAAEA,EAAE,SAAS,MAAM,EAAE,IAAI,CAAC,IAAIC,EAAE,OAAO,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,OAAO,UAAUA,EAAE,EAAE,EAAE,GAAGA,GAAGA,GAAG,SAASC,EAAE,OAAO,iCAAiC,CAACD,GAAG,CAAC,EAAED,EAAE,0BAA0B,CAAC,EAAEA,EAAE,kCAAkC,KAAK,GAAG,IAAI,QAAQ,IAAI,CAAC,EAAE,CCA9K,EAAEG,EAAE,CAAC,OAAOC,EAAE,OAAO,CAAC,GAAGA,EAAE,SAAS,OAAO,KAAKC,EAAE,CAAC,CAAC,OAAOD,EAAE,OAAO,CAAC,GAAGA,EAAE,SAAS,OAAO,KAAKE,EAAE,CAAC,CAAC,QAAQC,EAAE,CAAC,CCiB9M,GACZ,EACA,EAAM,EACN,CAAE,qBAAqB,IAAyB,EAAE,GAE1B,EAQjB,GAAG,IAAI,OAAO,EAAI,GAAG,IANpB,EACL,MAAM;EAAK,CACX,IAAK,GAAS,GAAG,IAAI,OAAO,EAAI,GAAG,IAAO,CAC1C,KAAK;EAAK,CCpBR,EAAS,CACd,IAAK,WACL,OAAQ,WACR,KAAM,WACN,MAAO,UACP,CAMK,MACL,OAAO,QAAY,KACnB,QAAQ,UAAY,MACpB,QAAQ,SAAS,MAAQ,KAMpB,MAUL,GATI,CAAC,GAAQ,EAGT,QAAQ,IAAI,WAAa,IAAA,IAGzB,QAAQ,IAAI,KAAO,IAAA,IAGnB,QAAQ,QAAU,CAAC,QAAQ,OAAO,OAW1B,GACZ,EACA,IAGI,GAAQ,EAAI,CAAC,GAAqB,CAC9B,GAAG,EAAO,KAAS,IAAO,EAAO,QAGlC,ECjDK,EAAgB,GAC5B,OAAO,QAAQ,EAAO,OAAO,CAC3B,KAAK,CAAC,EAAM,KAAW,CACvB,IAAM,EAAqB,EAAM,QAAQ,WAAW,EAAK,CACtD,EAAM,QAAQ,MAAM,EAAK,OAAO,CAChC,EAAM,QAGH,EAAa,EAAmB,MAAM,oBAAoB,CAC1D,EAAmB,EACtB,EAAmB,QACnB,SAAS,EAAW,GAAG,IACvB,QAAQ,EAAU,OAAQ,IAAI,EAAW,GAAG,GAAG,CAAC,GAChD,CACA,EAEH,MAAO,GAAG,EAAU,SAAU,EAAK,GAAG,KACrC,CACD,KAAK;EAAK,CAEb,IAAa,EAAb,cAAiC,KAAM,CACtC,YACC,EACA,EAAU,sDACT,CACD,MAAM,GAAG,EAAU,MAAO,EAAQ,CAAC,IAAI,EAAO,EAAa,EAAO,CAAC,CAAC,IAAI,CACxE,KAAK,KAAO,gBChCd,MAAa,EAAOC,EAAE,KCgCtB,SAAgB,EACf,EACA,EAA0B,QAAQ,IACkC,CAQpE,IAAM,GAJL,OAAO,GAAQ,YAAc,WAAY,EACtC,EACAC,EAAE,KAAK,IAAI,EAAoB,EAEP,EAAI,CAEhC,GAAI,aAAwB,EAAK,OAChC,MAAM,IAAI,EAAY,EAAa,CAGpC,OAAO,ECzCR,IAAA,EADe"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "arkenv",
   "type": "module",
-  "version": "0.7.5",
+  "version": "0.7.7",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -31,15 +31,18 @@
   "bugs": "https://github.com/yamcodes/arkenv/labels/arkenv",
   "author": "Yam Borodetsky <yam@yam.codes>",
   "devDependencies": {
-    "@ark/schema": "0.53.0",
     "@size-limit/esbuild-why": "11.2.0",
     "@size-limit/preset-small-lib": "11.2.0",
-    "@types/node": "24.10.0",
-    "arktype": "2.1.25",
+    "@types/node": "24.10.1",
+    "arktype": "2.1.28",
+    "rimraf": "6.1.2",
     "size-limit": "11.2.0",
-    "tsdown": "0.15.12",
+    "tsdown": "0.16.8",
     "typescript": "5.9.3",
-    "vitest": "4.0.8"
+    "vitest": "4.0.15",
+    "@repo/scope": "0.0.0",
+    "@repo/keywords": "0.0.0",
+    "@repo/types": "0.0.1"
   },
   "peerDependencies": {
     "arktype": "^2.1.22"
@@ -48,7 +51,10 @@
     {
       "path": "dist/index.js",
       "limit": "2 kB",
-      "import": "*"
+      "import": "*",
+      "ignore": [
+        "arktype"
+      ]
     }
   ],
   "scripts": {