@o3co/ts.hocon 1.9.0 → 1.10.0

package/dist/adapters/env.d.cts

@@ -0,0 +1,41 @@
+import { C as Config } from '../config-PdhVgeLS.cjs';
+
+type EnvOptions = {
+    /**
+     * Selects which variables to mount, and is stripped from the resulting path.
+     * Required by {@link loadEnv}: mounting the whole environment would pull in
+     * PATH, HOME and whatever secrets happen to be set (spec F1.1).
+     * {@link parseDotEnv} allows it to be empty, a `.env` file being a closed set
+     * the caller chose deliberately.
+     */
+    prefix?: string;
+    /** Source name for error messages. */
+    originDescription?: string;
+};
+/**
+ * Mount a prefixed slice of the environment as config.
+ *
+ * ```ts
+ * const base = loadEnv({ prefix: 'APP_' })   // APP_DB__HOST -> db.host
+ * ```
+ *
+ * Reading a single variable needs nothing from here — HOCON's own `${?VAR}`
+ * already does that. This is for mounting a whole namespace as a subtree.
+ *
+ * Values are always strings, and a `${...}` inside one stays literal (F0.2, F1.4).
+ */
+declare function loadEnv(opts?: EnvOptions & {
+    env?: Record<string, string | undefined>;
+}): Config;
+/**
+ * Read `.env` file content.
+ *
+ * The dialect is deliberately small (spec F1.7): `NAME=value`, an optional
+ * `export ` prefix, whole-line `#` comments, single quotes taken literally,
+ * double quotes with `\n \r \t \\ \"`. Multi-line values and trailing comments
+ * are not supported — an unquoted value containing ` #` is an error rather than
+ * a guess about whether a comment was meant. No `${...}` expansion.
+ */
+declare function parseDotEnv(input: string, opts?: EnvOptions): Config;
+
+export { type EnvOptions, loadEnv, parseDotEnv };

package/dist/adapters/env.d.ts

@@ -0,0 +1,41 @@
+import { C as Config } from '../config-PdhVgeLS.js';
+
+type EnvOptions = {
+    /**
+     * Selects which variables to mount, and is stripped from the resulting path.
+     * Required by {@link loadEnv}: mounting the whole environment would pull in
+     * PATH, HOME and whatever secrets happen to be set (spec F1.1).
+     * {@link parseDotEnv} allows it to be empty, a `.env` file being a closed set
+     * the caller chose deliberately.
+     */
+    prefix?: string;
+    /** Source name for error messages. */
+    originDescription?: string;
+};
+/**
+ * Mount a prefixed slice of the environment as config.
+ *
+ * ```ts
+ * const base = loadEnv({ prefix: 'APP_' })   // APP_DB__HOST -> db.host
+ * ```
+ *
+ * Reading a single variable needs nothing from here — HOCON's own `${?VAR}`
+ * already does that. This is for mounting a whole namespace as a subtree.
+ *
+ * Values are always strings, and a `${...}` inside one stays literal (F0.2, F1.4).
+ */
+declare function loadEnv(opts?: EnvOptions & {
+    env?: Record<string, string | undefined>;
+}): Config;
+/**
+ * Read `.env` file content.
+ *
+ * The dialect is deliberately small (spec F1.7): `NAME=value`, an optional
+ * `export ` prefix, whole-line `#` comments, single quotes taken literally,
+ * double quotes with `\n \r \t \\ \"`. Multi-line values and trailing comments
+ * are not supported — an unquoted value containing ` #` is an error rather than
+ * a guess about whether a comment was meant. No `${...}` expansion.
+ */
+declare function parseDotEnv(input: string, opts?: EnvOptions): Config;
+
+export { type EnvOptions, loadEnv, parseDotEnv };