@o3co/ts.hocon 1.3.0 → 1.4.0

package/dist/index.d.cts

@@ -1,4 +1,5 @@
-export { B as ByteUnit, C as Config, D as DurationUnit, H as HoconValue, P as ParseOptions, S as ScalarValueType, p as parse, a as parseAsync, b as parseFile, c as parseFileAsync } from './parse-nNbyqnOh.cjs';
+import { C as Config } from './config-BwjvKeZ5.cjs';
+export { B as ByteUnit, D as DurationUnit, H as HoconValue, P as PackageResolver, a as ParseOptions, R as ResolveOptions, S as ScalarValueType, d as defaultParseOptions, b as defaultResolveOptions, p as parse, c as parseAsync, e as parseFile, f as parseFileAsync, g as parseFileWithOptions, h as parseString, i as parseStringWithOptions } from './config-BwjvKeZ5.cjs';
 
 declare class ParseError extends Error {
     readonly line: number;
@@ -13,9 +14,51 @@ declare class ResolveError extends Error {
     readonly file?: string | undefined;
     constructor(message: string, path: string, line: number, col: number, file?: string | undefined);
 }
+/**
+ * Thrown when `include package("id", "file")` resolution fails because the
+ * package cannot be located via `require.resolve` or a custom `packageResolver`.
+ * Extends `ResolveError` so callers who catch `ResolveError` still handle it,
+ * while callers who need to distinguish a missing-package error can use:
+ *   `if (err instanceof PackageLookupError) { ... }`
+ */
+declare class PackageLookupError extends ResolveError {
+    readonly identifier: string;
+    readonly packageFile: string;
+    constructor(message: string, identifier: string, packageFile: string, line: number, col: number);
+}
 declare class ConfigError extends Error {
     readonly path: string;
     constructor(message: string, path: string);
 }
+/** Thrown when a getter is called on a Config whose value (or any transitive
+ *  parent) contains an unresolved substitution placeholder. E12 decision 12.
+ *  Use `instanceof NotResolvedError` to detect; also passes `instanceof ConfigError`. */
+declare class NotResolvedError extends ConfigError {
+    constructor(path: string);
+}
+
+/**
+ * Constructs a resolved Config from a plain JS/TS object. Keys are treated as
+ * plain keys (NOT path expressions — "a.b" produces a top-level key literally
+ * named "a.b", not nested a → b). Values are coerced per E12 § "Value factories":
+ *
+ *   string          → scalar/string
+ *   number (finite) → scalar/number (integer or float as-is; NaN/Infinity error)
+ *   boolean         → scalar/boolean
+ *   null            → scalar/null
+ *   Array<unknown>  → array (elements recursively coerced)
+ *   Record<string,unknown> → object (values recursively coerced)
+ *   undefined / function / symbol / bigint (> MAX_SAFE_INTEGER) → ConfigError
+ *
+ * originDescription (optional) provides a source name for error messages.
+ * E12 decision 13.
+ */
+declare function fromMap(values: Record<string, unknown>, originDescription?: string): Config;
+/**
+ * Returns a resolved Config with no keys. Equivalent to fromMap({}).
+ * originDescription (optional) labels the source in error messages.
+ * E12 decision 13.
+ */
+declare function empty(originDescription?: string): Config;
 
-export { ConfigError, ParseError, ResolveError };
+export { Config, ConfigError, NotResolvedError, PackageLookupError, ParseError, ResolveError, empty, fromMap };

package/dist/index.d.ts

@@ -1,4 +1,5 @@
-export { B as ByteUnit, C as Config, D as DurationUnit, H as HoconValue, P as ParseOptions, S as ScalarValueType, p as parse, a as parseAsync, b as parseFile, c as parseFileAsync } from './parse-nNbyqnOh.js';
+import { C as Config } from './config-BwjvKeZ5.js';
+export { B as ByteUnit, D as DurationUnit, H as HoconValue, P as PackageResolver, a as ParseOptions, R as ResolveOptions, S as ScalarValueType, d as defaultParseOptions, b as defaultResolveOptions, p as parse, c as parseAsync, e as parseFile, f as parseFileAsync, g as parseFileWithOptions, h as parseString, i as parseStringWithOptions } from './config-BwjvKeZ5.js';
 
 declare class ParseError extends Error {
     readonly line: number;
@@ -13,9 +14,51 @@ declare class ResolveError extends Error {
     readonly file?: string | undefined;
     constructor(message: string, path: string, line: number, col: number, file?: string | undefined);
 }
+/**
+ * Thrown when `include package("id", "file")` resolution fails because the
+ * package cannot be located via `require.resolve` or a custom `packageResolver`.
+ * Extends `ResolveError` so callers who catch `ResolveError` still handle it,
+ * while callers who need to distinguish a missing-package error can use:
+ *   `if (err instanceof PackageLookupError) { ... }`
+ */
+declare class PackageLookupError extends ResolveError {
+    readonly identifier: string;
+    readonly packageFile: string;
+    constructor(message: string, identifier: string, packageFile: string, line: number, col: number);
+}
 declare class ConfigError extends Error {
     readonly path: string;
     constructor(message: string, path: string);
 }
+/** Thrown when a getter is called on a Config whose value (or any transitive
+ *  parent) contains an unresolved substitution placeholder. E12 decision 12.
+ *  Use `instanceof NotResolvedError` to detect; also passes `instanceof ConfigError`. */
+declare class NotResolvedError extends ConfigError {
+    constructor(path: string);
+}
+
+/**
+ * Constructs a resolved Config from a plain JS/TS object. Keys are treated as
+ * plain keys (NOT path expressions — "a.b" produces a top-level key literally
+ * named "a.b", not nested a → b). Values are coerced per E12 § "Value factories":
+ *
+ *   string          → scalar/string
+ *   number (finite) → scalar/number (integer or float as-is; NaN/Infinity error)
+ *   boolean         → scalar/boolean
+ *   null            → scalar/null
+ *   Array<unknown>  → array (elements recursively coerced)
+ *   Record<string,unknown> → object (values recursively coerced)
+ *   undefined / function / symbol / bigint (> MAX_SAFE_INTEGER) → ConfigError
+ *
+ * originDescription (optional) provides a source name for error messages.
+ * E12 decision 13.
+ */
+declare function fromMap(values: Record<string, unknown>, originDescription?: string): Config;
+/**
+ * Returns a resolved Config with no keys. Equivalent to fromMap({}).
+ * originDescription (optional) labels the source in error messages.
+ * E12 decision 13.
+ */
+declare function empty(originDescription?: string): Config;
 
-export { ConfigError, ParseError, ResolveError };
+export { Config, ConfigError, NotResolvedError, PackageLookupError, ParseError, ResolveError, empty, fromMap };