arkenv 1.0.0-alpha.1 → 1.0.0-alpha.3

package/dist/index.d.cts

@@ -1,185 +1 @@
-import { a as Dict, n as SchemaShape, o as $, r as InferType, t as CompiledEnvSchema } from "./index-CzNfOanV.cjs";
-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 from "arktype";
-import { distill, type as type$1 } from "arktype";
-import * as _$arktype_internal_type_ts0 from "arktype/internal/type.ts";
-
-//#region src/arkenv.d.ts
-/**
- * Declarative environment schema definition accepted by ArkEnv.
- *
- * Represents a declarative schema object mapping environment
- * variable names to schema definitions (e.g. ArkType DSL strings
- * or Standard Schema validators).
- *
- * This type is used to validate that a schema object is compatible with
- * ArkEnv’s validator scope before being compiled or parsed.
- *
- * Most users will provide schemas in this form.
- *
- * @template def - The schema shape object
- */
-type EnvSchema<def> = type$1.validate<def, $>;
-/**
- * Infer the validated and coerced environment object type from a schema.
- * Supports declarative schema shapes, compiled ArkType schemas, and Standard Schema validators.
- *
- * @template T - The schema type
- */
-type Infer<T> = T extends SchemaShape ? distill.Out<type$1.infer<T, $>> : InferType<T>;
-type RuntimeEnvironment = Dict<string>;
-/**
- * Configuration options for `arkenv`
- */
-type ArkEnvConfig = {
-  /**
-   * The environment variables to parse. Defaults to `process.env`
-   */
-  env?: RuntimeEnvironment;
-  /**
-   * Whether to coerce environment variables to their defined types. Defaults to `true`
-   */
-  coerce?: boolean;
-  /**
-   * Control how ArkEnv handles environment variables that are not defined in your schema.
-   *
-   * Defaults to `'delete'` to ensure your output object only contains
-   * keys you've explicitly declared. This differs from ArkType's standard behavior, which
-   * mirrors TypeScript by defaulting to `'ignore'`.
-   *
-   * - `delete` (ArkEnv default): Undeclared keys are allowed on input but stripped from the output.
-   * - `ignore` (ArkType default): Undeclared keys are allowed and preserved in the output.
-   * - `reject`: Undeclared keys will cause validation to fail.
-   *
-   * @default "delete"
-   * @see https://arktype.io/docs/configuration#onundeclaredkey
-   */
-  onUndeclaredKey?: "ignore" | "delete" | "reject";
-  /**
-   * The format to use for array parsing when coercion is enabled.
-   *
-   * - `comma` (default): Strings are split by comma and trimmed.
-   * - `json`: Strings are parsed as JSON.
-   *
-   * @default "comma"
-   */
-  arrayFormat?: "comma" | "json";
-  /**
-   * Whether to treat empty strings (`""`) as `undefined` before validation.
-   *
-   * When enabled, an environment variable set to an empty value (e.g. `PORT=`)
-   * will be treated as if it were missing, allowing defaults to apply and
-   * preventing validation errors for numeric or boolean types.
-   *
-   * @default false
-   */
-  emptyAsUndefined?: boolean;
-};
-/**
- * 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`.
- */
-/**
- * Utility to parse environment variables using ArkType or Standard Schema
- * @param def - The schema definition
- * @param config - The evaluation configuration
- * @returns The parsed environment variables
- * @throws An {@link ArkEnvError | error} if the environment variables are invalid.
- */
-declare function arkenv<const T extends SchemaShape>(def: EnvSchema<T>, config?: ArkEnvConfig): distill.Out<type$1.infer<T, $>>;
-declare function arkenv<T extends CompiledEnvSchema>(def: T, config?: ArkEnvConfig): InferType<T>;
-declare function arkenv<const T extends SchemaShape>(def: EnvSchema<T> | CompiledEnvSchema, config?: ArkEnvConfig): distill.Out<type$1.infer<T, $>> | InferType<typeof def>;
-//#endregion
-//#region src/index.d.ts
-/**
- * Like ArkType's `type`, but with ArkEnv's extra keywords, such as:
- *
- * - `string.host` – a hostname (e.g. `"localhost"`, `"127.0.0.1"`)
- * - `number.port` – a port number (e.g. `8080`)
- *
- * See ArkType's docs for the full API:
- * https://arktype.io/docs/type-api
- */
-declare const type: _$arktype_internal_type_ts0.TypeParser<{
-  string: _$arktype.Submodule<{
-    trim: _$arktype.Submodule<_$arktype_internal_keywords_string_ts0.trim.$ & {
-      " arkInferred": (In: string) => _$arktype_internal_attributes_ts0.To<string>;
-    }>;
-    normalize: _$arktype.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: _$arktype.Submodule<{
-      root: string;
-      url: string;
-    } & {
-      " arkInferred": string;
-    }>;
-    capitalize: _$arktype.Submodule<_$arktype_internal_keywords_string_ts0.capitalize.$ & {
-      " arkInferred": (In: string) => _$arktype_internal_attributes_ts0.To<string>;
-    }>;
-    creditCard: string;
-    date: _$arktype.Submodule<_$arktype_internal_keywords_string_ts0.stringDate.$ & {
-      " arkInferred": string;
-    }>;
-    digits: string;
-    email: string;
-    integer: _$arktype.Submodule<_$arktype_internal_keywords_string_ts0.stringInteger.$ & {
-      " arkInferred": string;
-    }>;
-    ip: _$arktype.Submodule<_$arktype_internal_keywords_string_ts0.ip.$ & {
-      " arkInferred": string;
-    }>;
-    json: _$arktype.Submodule<_$arktype_internal_keywords_string_ts0.stringJson.$ & {
-      " arkInferred": string;
-    }>;
-    lower: _$arktype.Submodule<_$arktype_internal_keywords_string_ts0.lower.$ & {
-      " arkInferred": (In: string) => _$arktype_internal_attributes_ts0.To<string>;
-    }>;
-    numeric: _$arktype.Submodule<_$arktype_internal_keywords_string_ts0.stringNumeric.$ & {
-      " arkInferred": string;
-    }>;
-    regex: string;
-    semver: string;
-    upper: _$arktype.Submodule<{
-      root: (In: string) => _$arktype_internal_attributes_ts0.To<string>;
-      preformatted: string;
-    } & {
-      " arkInferred": (In: string) => _$arktype_internal_attributes_ts0.To<string>;
-    }>;
-    url: _$arktype.Submodule<_$arktype_internal_keywords_string_ts0.url.$ & {
-      " arkInferred": string;
-    }>;
-    uuid: _$arktype.Submodule<_$arktype_internal_keywords_string_ts0.uuid.$ & {
-      " arkInferred": string;
-    }>;
-    " arkInferred": string;
-    host: string;
-  }>;
-  number: _$arktype.Submodule<{
-    NaN: number;
-    Infinity: number;
-    root: number;
-    integer: number;
-    " arkInferred": number;
-    epoch: number;
-    safe: number;
-    NegativeInfinity: number;
-    port: number;
-  }>;
-}>;
-//#endregion
-export { type ArkEnvConfig, type EnvSchema, type Infer, arkenv, arkenv as default, type };
-
-// CJS Interop Shim
-if (module.exports && module.exports.default) {
-    Object.assign(module.exports.default, module.exports);
-    module.exports = module.exports.default;
-}
-      
-//# sourceMappingURL=index.d.cts.map
+export { };

package/package.json

@@ -1,47 +1,29 @@
 {
   "name": "arkenv",
   "type": "module",
-  "version": "1.0.0-alpha.1",
-  "description": "Typesafe environment variables parsing and validation with ArkType",
+  "version": "1.0.0-alpha.3",
+  "description": "Interactive CLI for scaffolding ArkEnv projects",
+  "bin": {
+    "arkenv": "./dist/index.cjs"
+  },
   "main": "./dist/index.cjs",
-  "module": "./dist/index.mjs",
-  "types": "./dist/index.d.mts",
+  "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "types": {
-        "import": "./dist/index.d.mts",
-        "require": "./dist/index.d.cts"
-      },
-      "import": "./dist/index.mjs",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
       "require": "./dist/index.cjs"
     },
-    "./standard": {
-      "types": {
-        "import": "./dist/standard.d.mts",
-        "require": "./dist/standard.d.cts"
-      },
-      "import": "./dist/standard.mjs",
-      "require": "./dist/standard.cjs"
-    },
-    "./core": {
-      "types": {
-        "import": "./dist/core.d.mts",
-        "require": "./dist/core.d.cts"
-      },
-      "import": "./dist/core.mjs",
-      "require": "./dist/core.cjs"
-    }
+    "./*": "./dist/*"
   },
   "files": [
     "dist"
   ],
   "keywords": [
-    "pnpm",
-    "arktype",
-    "environment",
-    "variables",
-    "typesafe",
-    "validation"
+    "arkenv",
+    "cli",
+    "scaffold",
+    "init"
   ],
   "license": "MIT",
   "homepage": "https://arkenv.js.org",
@@ -49,63 +31,27 @@
     "type": "git",
     "url": "git+https://github.com/yamcodes/arkenv.git"
   },
-  "bugs": "https://github.com/yamcodes/arkenv/labels/arkenv",
+  "bugs": "https://github.com/yamcodes/arkenv/labels/arkenv-cli",
   "author": "Yam Borodetsky <yam@yam.codes>",
+  "dependencies": {
+    "@clack/prompts": "^1.3.0",
+    "dedent": "^1.7.2",
+    "jsonc-parser": "^3.3.1",
+    "magicast": "^0.5.2",
+    "picocolors": "^1.1.1",
+    "radashi": "^12.9.1"
+  },
   "devDependencies": {
-    "@ark/attest": "0.56.0",
-    "@size-limit/esbuild-why": "12.1.0",
-    "@size-limit/preset-small-lib": "12.1.0",
     "@types/node": "24.12.2",
-    "arktype": "2.2.0",
-    "rimraf": "6.1.3",
-    "size-limit": "12.1.0",
     "tsdown": "0.21.10",
-    "typescript": "6.0.3",
-    "vitest": "4.1.5",
-    "zod": "4.4.1",
-    "@repo/scope": "0.1.3",
-    "@repo/types": "0.1.0"
-  },
-  "peerDependencies": {
-    "arktype": "^2.1.22"
+    "typescript": "6.0.3"
   },
-  "peerDependenciesMeta": {
-    "arktype": {
-      "optional": true
-    }
-  },
-  "size-limit": [
-    {
-      "name": "arkenv",
-      "path": "dist/index.mjs",
-      "limit": "2 kB",
-      "import": "*",
-      "ignore": [
-        "arktype"
-      ]
-    },
-    {
-      "name": "arkenv/standard",
-      "path": "dist/standard.mjs",
-      "limit": "2.3 kB",
-      "import": "*"
-    },
-    {
-      "name": "arkenv/core",
-      "path": "dist/core.mjs",
-      "limit": "500 B",
-      "import": "*"
-    }
-  ],
   "scripts": {
     "build": "tsdown",
-    "size": "size-limit --json > .size-limit.json",
-    "test:once": "vitest run",
-    "test:dist": "vitest run test/dist.test.ts",
-    "typecheck": "tsc --noEmit",
-    "clean": "rimraf dist node_modules",
+    "start": "node ./dist/index.cjs init",
+    "dev": "tsdown --watch",
     "test": "vitest",
-    "test:types": "vitest run --typecheck.only",
-    "fix": "pnpm -w run fix"
+    "test:run": "vitest run",
+    "typecheck": "tsc --noEmit"
   }
 }

package/dist/core-B0IkKRzg.mjs

@@ -1,6 +0,0 @@
-const e=(e,t=2,{dontDetectNewlines:n=!1}={})=>n?`${` `.repeat(t)}${e}`:e.split(`
-`).map(e=>`${` `.repeat(t)}${e}`).join(`
-`),t={red:`\x1B[31m`,yellow:`\x1B[33m`,cyan:`\x1B[36m`,reset:`\x1B[0m`},n=()=>typeof process<`u`&&process.versions!=null&&process.versions.node!=null,r=()=>!!(!n()||process.env.NO_COLOR!==void 0||process.env.CI!==void 0||process.stdout&&!process.stdout.isTTY),i=(e,i)=>n()&&!r()?`${t[e]}${i}${t.reset}`:i,a=e=>e.map(e=>`${i(`yellow`,e.path)} ${e.message.trimStart()}`).join(`
-`);var o=class extends Error{constructor(t,n=`Errors found while validating environment variables`){let r=a(t);super(`${i(`red`,n)}\n${e(r)}\n`),this.name=`ArkEnvError`}};Object.defineProperty(o,`name`,{value:`ArkEnvError`});export{a as n,i as r,o as t};
-
-//# sourceMappingURL=core-B0IkKRzg.mjs.map

package/dist/core-B0IkKRzg.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"core-B0IkKRzg.mjs","names":[],"sources":["../src/utils/indent.ts","../src/utils/style-text.ts","../src/core.ts"],"sourcesContent":["/**\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 { indent } from \"./utils/indent\";\nimport { styleText } from \"./utils/style-text\";\n\n/**\n * A single validation issue produced during environment variable parsing.\n * Used by {@link ArkEnvError} to report which key failed and why.\n */\nexport type ValidationIssue = {\n\tpath: string;\n\tmessage: string;\n};\n\nexport const formatInternalErrors = (errors: ValidationIssue[]): string =>\n\terrors\n\t\t.map(\n\t\t\t(error) =>\n\t\t\t\t`${styleText(\"yellow\", error.path)} ${error.message.trimStart()}`,\n\t\t)\n\t\t.join(\"\\n\");\n\n/**\n * Error thrown when environment variable validation fails.\n *\n * This error extends the native `Error` class and provides formatted error messages\n * that clearly indicate which environment variables are invalid and why.\n *\n * @example\n * ```ts\n * import arkenv from 'arkenv';\n * import { ArkEnvError } from 'arkenv/core';\n *\n * try {\n *   const env = arkenv({\n *     PORT: 'number.port',\n *     HOST: 'string.host',\n *   });\n * } catch (error) {\n *   if (error instanceof ArkEnvError) {\n *     console.error('Environment validation failed:', error.message);\n *   }\n * }\n * ```\n */\nexport class ArkEnvError extends Error {\n\tconstructor(\n\t\terrors: ValidationIssue[],\n\t\tmessage = \"Errors found while validating environment variables\",\n\t) {\n\t\tconst formattedErrors = formatInternalErrors(errors);\n\t\tsuper(`${styleText(\"red\", message)}\\n${indent(formattedErrors)}\\n`);\n\t\tthis.name = \"ArkEnvError\";\n\t}\n}\n\nObject.defineProperty(ArkEnvError, \"name\", { value: \"ArkEnvError\" });\n"],"mappings":"AAiBA,MAAa,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,EC7CK,EAAwB,GACpC,EACE,IACC,GACA,GAAG,EAAU,SAAU,EAAM,KAAK,CAAC,GAAG,EAAM,QAAQ,WAAW,GAChE,CACA,KAAK;EAAK,CAyBb,IAAa,EAAb,cAAiC,KAAM,CACtC,YACC,EACA,EAAU,sDACT,CACD,IAAM,EAAkB,EAAqB,EAAO,CACpD,MAAM,GAAG,EAAU,MAAO,EAAQ,CAAC,IAAI,EAAO,EAAgB,CAAC,IAAI,CACnE,KAAK,KAAO,gBAId,OAAO,eAAe,EAAa,OAAQ,CAAE,MAAO,cAAe,CAAC"}

package/dist/core-BftJnV8f.cjs

@@ -1,11 +0,0 @@
-const e=(e,t=2,{dontDetectNewlines:n=!1}={})=>n?`${` `.repeat(t)}${e}`:e.split(`
-`).map(e=>`${` `.repeat(t)}${e}`).join(`
-`),t={red:`\x1B[31m`,yellow:`\x1B[33m`,cyan:`\x1B[36m`,reset:`\x1B[0m`},n=()=>typeof process<`u`&&process.versions!=null&&process.versions.node!=null,r=()=>!!(!n()||process.env.NO_COLOR!==void 0||process.env.CI!==void 0||process.stdout&&!process.stdout.isTTY),i=(e,i)=>n()&&!r()?`${t[e]}${i}${t.reset}`:i,a=e=>e.map(e=>`${i(`yellow`,e.path)} ${e.message.trimStart()}`).join(`
-`);var o=class extends Error{constructor(t,n=`Errors found while validating environment variables`){let r=a(t);super(`${i(`red`,n)}\n${e(r)}\n`),this.name=`ArkEnvError`}};Object.defineProperty(o,`name`,{value:`ArkEnvError`}),Object.defineProperty(exports,`n`,{enumerable:!0,get:function(){return a}}),Object.defineProperty(exports,`r`,{enumerable:!0,get:function(){return i}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return o}});
-
-// CJS Interop Shim
-if (module.exports && module.exports.default) {
-    Object.assign(module.exports.default, module.exports);
-    module.exports = module.exports.default;
-}
-      

package/dist/core.cjs

@@ -1,8 +0,0 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./core-BftJnV8f.cjs`);exports.ArkEnvError=e.t,exports.formatInternalErrors=e.n;
-
-// CJS Interop Shim
-if (module.exports && module.exports.default) {
-    Object.assign(module.exports.default, module.exports);
-    module.exports = module.exports.default;
-}
-      

package/dist/core.d.cts

@@ -1,46 +0,0 @@
-//#region src/core.d.ts
-/**
- * A single validation issue produced during environment variable parsing.
- * Used by {@link ArkEnvError} to report which key failed and why.
- */
-type ValidationIssue = {
-  path: string;
-  message: string;
-};
-declare const formatInternalErrors: (errors: ValidationIssue[]) => string;
-/**
- * Error thrown when environment variable validation fails.
- *
- * This error extends the native `Error` class and provides formatted error messages
- * that clearly indicate which environment variables are invalid and why.
- *
- * @example
- * ```ts
- * import arkenv from 'arkenv';
- * import { ArkEnvError } from 'arkenv/core';
- *
- * try {
- *   const env = arkenv({
- *     PORT: 'number.port',
- *     HOST: 'string.host',
- *   });
- * } catch (error) {
- *   if (error instanceof ArkEnvError) {
- *     console.error('Environment validation failed:', error.message);
- *   }
- * }
- * ```
- */
-declare class ArkEnvError extends Error {
-  constructor(errors: ValidationIssue[], message?: string);
-}
-//#endregion
-export { ArkEnvError, ValidationIssue, formatInternalErrors };
-
-// CJS Interop Shim
-if (module.exports && module.exports.default) {
-    Object.assign(module.exports.default, module.exports);
-    module.exports = module.exports.default;
-}
-      
-//# sourceMappingURL=core.d.cts.map

package/dist/core.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"core.d.cts","names":[],"sources":["../src/core.ts"],"mappings":";;AAOA;;;KAAY,eAAA;EACX,IAAA;EACA,OAAA;AAAA;AAAA,cAGY,oBAAA,GAAwB,MAAA,EAAQ,eAAA;;;AA+B7C;;;;;;;;;;;;;;;;;;;;;cAAa,WAAA,SAAoB,KAAA;cAE/B,MAAA,EAAQ,eAAA,IACR,OAAA;AAAA"}

package/dist/core.d.mts

@@ -1,40 +0,0 @@
-//#region src/core.d.ts
-/**
- * A single validation issue produced during environment variable parsing.
- * Used by {@link ArkEnvError} to report which key failed and why.
- */
-type ValidationIssue = {
-  path: string;
-  message: string;
-};
-declare const formatInternalErrors: (errors: ValidationIssue[]) => string;
-/**
- * Error thrown when environment variable validation fails.
- *
- * This error extends the native `Error` class and provides formatted error messages
- * that clearly indicate which environment variables are invalid and why.
- *
- * @example
- * ```ts
- * import arkenv from 'arkenv';
- * import { ArkEnvError } from 'arkenv/core';
- *
- * try {
- *   const env = arkenv({
- *     PORT: 'number.port',
- *     HOST: 'string.host',
- *   });
- * } catch (error) {
- *   if (error instanceof ArkEnvError) {
- *     console.error('Environment validation failed:', error.message);
- *   }
- * }
- * ```
- */
-declare class ArkEnvError extends Error {
-  constructor(errors: ValidationIssue[], message?: string);
-}
-//#endregion
-export { ArkEnvError, ValidationIssue, formatInternalErrors };
-
-//# sourceMappingURL=core.d.mts.map

package/dist/core.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"core.d.mts","names":[],"sources":["../src/core.ts"],"mappings":";;AAOA;;;KAAY,eAAA;EACX,IAAA;EACA,OAAA;AAAA;AAAA,cAGY,oBAAA,GAAwB,MAAA,EAAQ,eAAA;;;AA+B7C;;;;;;;;;;;;;;;;;;;;;cAAa,WAAA,SAAoB,KAAA;cAE/B,MAAA,EAAQ,eAAA,IACR,OAAA;AAAA"}

package/dist/core.mjs

@@ -1 +0,0 @@
-import{n as e,t}from"./core-B0IkKRzg.mjs";export{t as ArkEnvError,e as formatInternalErrors};

package/dist/index-Br22fqkz.d.mts

@@ -1,204 +0,0 @@
-import * as _$arktype from "arktype";
-import { Type, type } 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";
-
-//#region ../internal/scope/dist/index.d.ts
-//#region src/root.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 $: _$arktype.Scope<{
-  string: _$arktype.Submodule<{
-    trim: _$arktype.Submodule<_$arktype_internal_keywords_string_ts0.trim.$ & {
-      " arkInferred": (In: string) => _$arktype_internal_attributes_ts0.To<string>;
-    }>;
-    normalize: _$arktype.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: _$arktype.Submodule<{
-      root: string;
-      url: string;
-    } & {
-      " arkInferred": string;
-    }>;
-    capitalize: _$arktype.Submodule<_$arktype_internal_keywords_string_ts0.capitalize.$ & {
-      " arkInferred": (In: string) => _$arktype_internal_attributes_ts0.To<string>;
-    }>;
-    creditCard: string;
-    date: _$arktype.Submodule<_$arktype_internal_keywords_string_ts0.stringDate.$ & {
-      " arkInferred": string;
-    }>;
-    digits: string;
-    email: string;
-    integer: _$arktype.Submodule<_$arktype_internal_keywords_string_ts0.stringInteger.$ & {
-      " arkInferred": string;
-    }>;
-    ip: _$arktype.Submodule<_$arktype_internal_keywords_string_ts0.ip.$ & {
-      " arkInferred": string;
-    }>;
-    json: _$arktype.Submodule<_$arktype_internal_keywords_string_ts0.stringJson.$ & {
-      " arkInferred": string;
-    }>;
-    lower: _$arktype.Submodule<_$arktype_internal_keywords_string_ts0.lower.$ & {
-      " arkInferred": (In: string) => _$arktype_internal_attributes_ts0.To<string>;
-    }>;
-    numeric: _$arktype.Submodule<_$arktype_internal_keywords_string_ts0.stringNumeric.$ & {
-      " arkInferred": string;
-    }>;
-    regex: string;
-    semver: string;
-    upper: _$arktype.Submodule<{
-      root: (In: string) => _$arktype_internal_attributes_ts0.To<string>;
-      preformatted: string;
-    } & {
-      " arkInferred": (In: string) => _$arktype_internal_attributes_ts0.To<string>;
-    }>;
-    url: _$arktype.Submodule<_$arktype_internal_keywords_string_ts0.url.$ & {
-      " arkInferred": string;
-    }>;
-    uuid: _$arktype.Submodule<_$arktype_internal_keywords_string_ts0.uuid.$ & {
-      " arkInferred": string;
-    }>;
-    " arkInferred": string;
-    host: string;
-  }>;
-  number: _$arktype.Submodule<{
-    NaN: number;
-    Infinity: number;
-    root: number;
-    integer: number;
-    " arkInferred": number;
-    epoch: number;
-    safe: number;
-    NegativeInfinity: number;
-    port: number;
-  }>;
-}>;
-type $ = (typeof $)["t"]; //#endregion
-//#endregion
-//#region ../internal/types/dist/helpers.d.ts
-type Dict<T> = Record<string, T | undefined>;
-//#endregion
-//#region ../internal/types/dist/standard-schema.d.ts
-/**
- * @see https://github.com/standard-schema/standard-schema/tree/3130ce43fdd848d9ab49dbb0458d04f18459961c/packages/spec
- *
- * Copied from standard-schema (MIT License)
- * Copyright (c) 2024 Colin McDannell
- */
-/** The Standard Typed interface. This is a base type extended by other specs. */
-interface StandardTypedV1<Input = unknown, Output = Input> {
-  /** The Standard properties. */
-  readonly "~standard": StandardTypedV1.Props<Input, Output>;
-}
-declare namespace StandardTypedV1 {
-  /** The Standard Typed properties interface. */
-  interface Props<Input = unknown, Output = Input> {
-    /** The version number of the standard. */
-    readonly version: 1;
-    /** The vendor name of the schema library. */
-    readonly vendor: string;
-    /** Inferred types associated with the schema. */
-    readonly types?: Types<Input, Output> | undefined;
-  }
-  /** The Standard Typed types interface. */
-  interface Types<Input = unknown, Output = Input> {
-    /** The input type of the schema. */
-    readonly input: Input;
-    /** The output type of the schema. */
-    readonly output: Output;
-  }
-  /** Infers the input type of a Standard Typed. */
-  type InferInput<Schema extends StandardTypedV1> = NonNullable<Schema["~standard"]["types"]>["input"];
-  /** Infers the output type of a Standard Typed. */
-  type InferOutput<Schema extends StandardTypedV1> = NonNullable<Schema["~standard"]["types"]>["output"];
-}
-/** The Standard Schema interface. */
-interface StandardSchemaV1<Input = unknown, Output = Input> {
-  /** The Standard Schema properties. */
-  readonly "~standard": StandardSchemaV1.Props<Input, Output>;
-}
-declare namespace StandardSchemaV1 {
-  /** The Standard Schema properties interface. */
-  interface Props<Input = unknown, Output = Input> extends StandardTypedV1.Props<Input, Output> {
-    /** Validates unknown input values. */
-    readonly validate: (value: unknown, options?: StandardSchemaV1.Options | undefined) => Result<Output> | Promise<Result<Output>>;
-  }
-  /** The result interface of the validate function. */
-  type Result<Output> = SuccessResult<Output> | FailureResult;
-  /** The result interface if validation succeeds. */
-  interface SuccessResult<Output> {
-    /** The typed output value. */
-    readonly value: Output;
-    /** A falsy value for `issues` indicates success. */
-    readonly issues?: undefined;
-  }
-  interface Options {
-    /** Explicit support for additional vendor-specific parameters, if needed. */
-    readonly libraryOptions?: Record<string, unknown> | undefined;
-  }
-  /** The result interface if validation fails. */
-  interface FailureResult {
-    /** The issues of failed validation. */
-    readonly issues: ReadonlyArray<Issue>;
-  }
-  /** The issue interface of the failure output. */
-  interface Issue {
-    /** The error message of the issue. */
-    readonly message: string;
-    /** The path of the issue, if any. */
-    readonly path?: ReadonlyArray<PropertyKey | PathSegment> | undefined;
-  }
-  /** The path segment interface of the issue. */
-  interface PathSegment {
-    /** The key representing a path segment. */
-    readonly key: PropertyKey;
-  }
-  /** The Standard types interface. */
-  interface Types<Input = unknown, Output = Input> extends StandardTypedV1.Types<Input, Output> {}
-  /** Infers the input type of a Standard. */
-  type InferInput<Schema extends StandardTypedV1> = StandardTypedV1.InferInput<Schema>;
-  /** Infers the output type of a Standard. */
-  type InferOutput<Schema extends StandardTypedV1> = StandardTypedV1.InferOutput<Schema>;
-}
-//#endregion
-//#region ../internal/types/dist/infer-type.d.ts
-/**
- * Extract the inferred type from a schema definition.
- * Supports both ArkType type definitions and Standard Schema 1.0 validators.
- *
- * For Standard Schema validators (e.g., Zod, Valibot), extracts the output type.
- * For ArkType definitions, checks the call signature or type properties.
- *
- * @template T - The schema definition to infer from
- */
-type InferType<T> = T extends StandardSchemaV1<infer _Input, infer Output> ? Output : T extends ((value: Record<string, string | undefined>) => infer R) ? R extends type.errors ? never : R : T extends {
-  t: infer U;
-} ? U : T extends type.Any<infer U, infer _Scope> ? U : never;
-//#endregion
-//#region ../internal/types/dist/schema.d.ts
-type SchemaShape = Record<string, unknown>;
-/**
- * @internal
- *
- * Compiled ArkType schema accepted by ArkEnv.
- * Produced by `arktype.type(...)` or `scope(...)`.
- *
- * Represents an already-constructed ArkType `Type` instance that
- * defines the full environment schema.
- *
- * This form bypasses schema validation and is intended for advanced
- * or programmatic use cases where schemas are constructed dynamically.
- */
-type CompiledEnvSchema = Type<SchemaShape, $>;
-//#endregion
-export { Dict as a, StandardSchemaV1 as i, SchemaShape as n, $ as o, InferType as r, CompiledEnvSchema as t };
-
-//# sourceMappingURL=index-Br22fqkz.d.mts.map