@o3co/ts.hocon 1.7.1 → 1.9.0

package/README.md

@@ -14,7 +14,7 @@ A [Lightbend HOCON](https://github.com/lightbend/config/blob/main/HOCON.md) pars
 
 > **Library stance:** ts.hocon is a HOCON config loader — its purpose is reading `.hocon` config files and providing typed access via the Config API (`getString`, `getNumber`, `getBoolean`, `getDuration`, `getBytes`, `toObject`). It is not a low-level parser API. Internal types like `HoconValue` may change between minor versions.
 >
-> **Cross-language conformance:** This implementation is tested against shared expected-JSON fixtures from [o3co/xx.hocon](https://github.com/o3co/xx.hocon) alongside [go.hocon](https://github.com/o3co/go.hocon) and [rs.hocon](https://github.com/o3co/rs.hocon) to ensure all three implementations meet the same Lightbend HOCON specification.
+> **Cross-language conformance:** This implementation is tested against shared expected-JSON fixtures from [o3co/xx.hocon](https://github.com/o3co/xx.hocon) alongside [go.hocon](https://github.com/o3co/go.hocon), [rs.hocon](https://github.com/o3co/rs.hocon), and [py.hocon](https://github.com/o3co/py.hocon) to ensure all four implementations meet the same Lightbend HOCON specification.
 
 ---
 
@@ -245,7 +245,7 @@ c.getBytes('max-size')          // 536870912 (bytes)
 c.getBytes('max-size', 'MiB')  // 512
 ```
 
-Supported duration units: `ns`, `us`, `ms`, `s`, `m`, `h`, `d` (and long forms like `seconds`, `minutes`).
+Supported duration units: `ns`, `us`, `ms`, `s`, `m`, `h`, `d` (and long forms like `seconds`, `minutes`). Duration unit names are case-sensitive and must be lowercase (HOCON spec). Byte units are more case-tolerant: the canonical forms below plus lowercase aliases (`kb`, `kib`, …), any-case long forms (`megabytes`), and single-letter powers-of-two in both cases (`K`/`k`, per Lightbend).
 Supported byte units: `B`, `KB`/`KiB`, `MB`/`MiB`, `GB`/`GiB`, `TB`/`TiB` (and long forms like `megabytes`, `mebibytes`).
 
 ## Spec Compliance
@@ -386,9 +386,10 @@ const config = parseWithSchema(hoconInput, schema) // fails fast on startup
 |---------|----------|----------|-------------|
 | [go.hocon](https://github.com/o3co/go.hocon) | Go | [pkg.go.dev](https://pkg.go.dev/github.com/o3co/go.hocon) | HOCON parser for Go |
 | [rs.hocon](https://github.com/o3co/rs.hocon) | Rust | [crates.io](https://crates.io/crates/o3co-hocon) | HOCON parser for Rust |
+| [py.hocon](https://github.com/o3co/py.hocon) | Python | [PyPI](https://pypi.org/project/hocon-parser/) | HOCON parser for Python |
 | [hocon2](https://github.com/o3co/hocon2) | Go | [pkg.go.dev](https://pkg.go.dev/github.com/o3co/hocon2) | HOCON → JSON/YAML/TOML/Properties CLI |
 
-The three parser implementations ([ts.hocon](https://github.com/o3co/ts.hocon), [rs.hocon](https://github.com/o3co/rs.hocon), [go.hocon](https://github.com/o3co/go.hocon)) are all tracked against the same Lightbend HOCON spec — see the [cross-impl roll-up](https://github.com/o3co/xx.hocon/blob/main/docs/compliance-matrix.md) for per-impl conformance rates.
+The four parser implementations ([ts.hocon](https://github.com/o3co/ts.hocon), [rs.hocon](https://github.com/o3co/rs.hocon), [go.hocon](https://github.com/o3co/go.hocon), [py.hocon](https://github.com/o3co/py.hocon)) are all tracked against the same Lightbend HOCON spec — see the [cross-impl roll-up](https://github.com/o3co/xx.hocon/blob/main/docs/compliance-matrix.md) for per-impl conformance rates.
 
 ## Known Limitations
 
@@ -402,7 +403,7 @@ The three parser implementations ([ts.hocon](https://github.com/o3co/ts.hocon),
 
 When parsing untrusted HOCON input, be aware of:
 
-- **Path traversal in includes:** `include "../../../etc/passwd"` will resolve relative to `baseDir`. Use a custom `readFileSync`/`readFile` that validates paths if parsing untrusted input.
+- **Path traversal in includes:** a relative `include` path resolves against `baseDir` and can climb out of it with `..` segments to reach sensitive files such as `/etc/passwd`. Use a custom `readFileSync`/`readFile` that validates paths if parsing untrusted input.
 - **Input size:** The parser has no built-in input size limit. For untrusted input, validate size before calling `parse()`.
 - **Include depth:** Limited to 50 levels to prevent stack overflow from deep include chains.
 

package/dist/{config-DCSLXkNY.d.cts → config-D27s3_aG.d.cts}

@@ -13,6 +13,59 @@ type HoconValue = {
     raw: string;
     valueType: ScalarValueType;
 };
+/**
+ * Deeply-immutable view of a {@link HoconValue}. `Config.getValue` returns this
+ * so callers cannot mutate the parsed configuration tree (the live nodes are
+ * shared, not cloned). `Map`/array containers become `ReadonlyMap`/`readonly[]`
+ * recursively, so `.set` / `.push` / element assignment are compile errors.
+ *
+ * `HoconValue` is structurally assignable to `ReadonlyHoconValue`, so internal
+ * code holding a mutable node can return it here, and the accessor functions
+ * below accept both forms.
+ */
+type ReadonlyHoconValue = {
+    readonly kind: 'object';
+    readonly fields: ReadonlyMap<string, ReadonlyHoconValue>;
+} | {
+    readonly kind: 'array';
+    readonly items: readonly ReadonlyHoconValue[];
+} | {
+    readonly kind: 'scalar';
+    readonly raw: string;
+    readonly valueType: ScalarValueType;
+};
+/** Scalar string only (strict): non-string scalars and containers → undefined. */
+declare function asString(v: ReadonlyHoconValue): string | undefined;
+/**
+ * Scalar coerced to a number via {@link coerceNumber} (lenient, matching the
+ * `getNumber` getter: a numeric-looking string scalar coerces too). TS has a
+ * single `number` type, so this unifies rs's `as_i64` + `as_f64`.
+ */
+declare function asNumber(v: ReadonlyHoconValue): number | undefined;
+/** Scalar coerced to a boolean via {@link coerceBoolean} (true/yes/on, false/no/off). */
+declare function asBoolean(v: ReadonlyHoconValue): boolean | undefined;
+/** The object's fields, or undefined if not an object. */
+declare function asObject(v: ReadonlyHoconValue): ReadonlyMap<string, ReadonlyHoconValue> | undefined;
+/** The array's items, or undefined if not an array. */
+declare function asArray(v: ReadonlyHoconValue): readonly ReadonlyHoconValue[] | undefined;
+/** Type guard: narrows to the object variant. */
+declare function isObject(v: ReadonlyHoconValue): v is {
+    readonly kind: 'object';
+    readonly fields: ReadonlyMap<string, ReadonlyHoconValue>;
+};
+/** Type guard: narrows to the array variant. */
+declare function isArray(v: ReadonlyHoconValue): v is {
+    readonly kind: 'array';
+    readonly items: readonly ReadonlyHoconValue[];
+};
+/** Type guard: narrows to the scalar variant. */
+declare function isScalar(v: ReadonlyHoconValue): v is {
+    readonly kind: 'scalar';
+    readonly raw: string;
+    readonly valueType: ScalarValueType;
+};
+/** True for a null scalar. */
+declare function isNull(v: ReadonlyHoconValue): boolean;
 
 interface Segment {
     readonly text: string;
@@ -212,6 +265,20 @@ declare class Config {
         resolveOpts: ResolveOptions$1;
     }): Config;
     get(path: string): unknown;
+    /**
+     * Returns the raw {@link HoconValue} node at `path` as a deeply-immutable
+     * {@link ReadonlyHoconValue} view, or `undefined` if the path is absent. Unlike
+     * `get` (which decodes to a plain JS value), this exposes the value tree for
+     * structural introspection via the `value.ts` accessors (`asString`, `asObject`,
+     * `isScalar`, …).
+     *
+     * `getValue('')` returns the root object node.
+     *
+     * Throws {@link NotResolvedError} when the node (or its subtree) is unresolved:
+     * the `HoconValue` union has no placeholder variant, so an unresolved value
+     * cannot be represented. This matches `getConfig` / `getList`.
+     */
+    getValue(path: string): ReadonlyHoconValue | undefined;
     getString(path: string): string;
     getNumber(path: string): number;
     getBoolean(path: string): boolean;
@@ -273,4 +340,4 @@ declare class Config {
     private requireScalar;
 }
 
-export { type ByteUnit as B, Config as C, type DurationUnit as D, type HoconValue as H, type PackageResolver as P, type ResolveOptions as R, type ScalarValueType as S, type ParseOptions as a, defaultResolveOptions as b, parseAsync as c, defaultParseOptions as d, parseFile as e, parseFileAsync as f, parseFileWithOptions as g, parseString as h, parseStringWithOptions as i, parse as p };
+export { type ByteUnit as B, Config as C, type DurationUnit as D, type HoconValue as H, type PackageResolver as P, type ReadonlyHoconValue as R, type ScalarValueType as S, type ParseOptions as a, type ResolveOptions as b, asArray as c, asBoolean as d, asNumber as e, asObject as f, asString as g, defaultParseOptions as h, defaultResolveOptions as i, isArray as j, isNull as k, isObject as l, isScalar as m, parseAsync as n, parseFile as o, parse as p, parseFileAsync as q, parseFileWithOptions as r, parseString as s, parseStringWithOptions as t };

package/dist/{config-DCSLXkNY.d.ts → config-D27s3_aG.d.ts}

@@ -13,6 +13,59 @@ type HoconValue = {
     raw: string;
     valueType: ScalarValueType;
 };
+/**
+ * Deeply-immutable view of a {@link HoconValue}. `Config.getValue` returns this
+ * so callers cannot mutate the parsed configuration tree (the live nodes are
+ * shared, not cloned). `Map`/array containers become `ReadonlyMap`/`readonly[]`
+ * recursively, so `.set` / `.push` / element assignment are compile errors.
+ *
+ * `HoconValue` is structurally assignable to `ReadonlyHoconValue`, so internal
+ * code holding a mutable node can return it here, and the accessor functions
+ * below accept both forms.
+ */
+type ReadonlyHoconValue = {
+    readonly kind: 'object';
+    readonly fields: ReadonlyMap<string, ReadonlyHoconValue>;
+} | {
+    readonly kind: 'array';
+    readonly items: readonly ReadonlyHoconValue[];
+} | {
+    readonly kind: 'scalar';
+    readonly raw: string;
+    readonly valueType: ScalarValueType;
+};
+/** Scalar string only (strict): non-string scalars and containers → undefined. */
+declare function asString(v: ReadonlyHoconValue): string | undefined;
+/**
+ * Scalar coerced to a number via {@link coerceNumber} (lenient, matching the
+ * `getNumber` getter: a numeric-looking string scalar coerces too). TS has a
+ * single `number` type, so this unifies rs's `as_i64` + `as_f64`.
+ */
+declare function asNumber(v: ReadonlyHoconValue): number | undefined;
+/** Scalar coerced to a boolean via {@link coerceBoolean} (true/yes/on, false/no/off). */
+declare function asBoolean(v: ReadonlyHoconValue): boolean | undefined;
+/** The object's fields, or undefined if not an object. */
+declare function asObject(v: ReadonlyHoconValue): ReadonlyMap<string, ReadonlyHoconValue> | undefined;
+/** The array's items, or undefined if not an array. */
+declare function asArray(v: ReadonlyHoconValue): readonly ReadonlyHoconValue[] | undefined;
+/** Type guard: narrows to the object variant. */
+declare function isObject(v: ReadonlyHoconValue): v is {
+    readonly kind: 'object';
+    readonly fields: ReadonlyMap<string, ReadonlyHoconValue>;
+};
+/** Type guard: narrows to the array variant. */
+declare function isArray(v: ReadonlyHoconValue): v is {
+    readonly kind: 'array';
+    readonly items: readonly ReadonlyHoconValue[];
+};
+/** Type guard: narrows to the scalar variant. */
+declare function isScalar(v: ReadonlyHoconValue): v is {
+    readonly kind: 'scalar';
+    readonly raw: string;
+    readonly valueType: ScalarValueType;
+};
+/** True for a null scalar. */
+declare function isNull(v: ReadonlyHoconValue): boolean;
 
 interface Segment {
     readonly text: string;
@@ -212,6 +265,20 @@ declare class Config {
         resolveOpts: ResolveOptions$1;
     }): Config;
     get(path: string): unknown;
+    /**
+     * Returns the raw {@link HoconValue} node at `path` as a deeply-immutable
+     * {@link ReadonlyHoconValue} view, or `undefined` if the path is absent. Unlike
+     * `get` (which decodes to a plain JS value), this exposes the value tree for
+     * structural introspection via the `value.ts` accessors (`asString`, `asObject`,
+     * `isScalar`, …).
+     *
+     * `getValue('')` returns the root object node.
+     *
+     * Throws {@link NotResolvedError} when the node (or its subtree) is unresolved:
+     * the `HoconValue` union has no placeholder variant, so an unresolved value
+     * cannot be represented. This matches `getConfig` / `getList`.
+     */
+    getValue(path: string): ReadonlyHoconValue | undefined;
     getString(path: string): string;
     getNumber(path: string): number;
     getBoolean(path: string): boolean;
@@ -273,4 +340,4 @@ declare class Config {
     private requireScalar;
 }
 
-export { type ByteUnit as B, Config as C, type DurationUnit as D, type HoconValue as H, type PackageResolver as P, type ResolveOptions as R, type ScalarValueType as S, type ParseOptions as a, defaultResolveOptions as b, parseAsync as c, defaultParseOptions as d, parseFile as e, parseFileAsync as f, parseFileWithOptions as g, parseString as h, parseStringWithOptions as i, parse as p };
+export { type ByteUnit as B, Config as C, type DurationUnit as D, type HoconValue as H, type PackageResolver as P, type ReadonlyHoconValue as R, type ScalarValueType as S, type ParseOptions as a, type ResolveOptions as b, asArray as c, asBoolean as d, asNumber as e, asObject as f, asString as g, defaultParseOptions as h, defaultResolveOptions as i, isArray as j, isNull as k, isObject as l, isScalar as m, parseAsync as n, parseFile as o, parse as p, parseFileAsync as q, parseFileWithOptions as r, parseString as s, parseStringWithOptions as t };

package/dist/index.cjs

@@ -36,10 +36,19 @@ __export(src_exports, {
   PackageLookupError: () => PackageLookupError,
   ParseError: () => ParseError,
   ResolveError: () => ResolveError,
+  asArray: () => asArray,
+  asBoolean: () => asBoolean,
+  asNumber: () => asNumber,
+  asObject: () => asObject,
+  asString: () => asString,
   defaultParseOptions: () => defaultParseOptions,
   defaultResolveOptions: () => defaultResolveOptions,
   empty: () => empty,
   fromMap: () => fromMap,
+  isArray: () => isArray,
+  isNull: () => isNull,
+  isObject: () => isObject,
+  isScalar: () => isScalar,
   parse: () => parse,
   parseAsync: () => parseAsync,
   parseFile: () => parseFile,
@@ -132,7 +141,7 @@ function parseDuration(value, outputUnit = "ms") {
   if (i === 0) return NaN;
   const num = Number(trimmed.slice(0, i));
   if (Number.isNaN(num)) return NaN;
-  const unit = trimHoconWs(trimmed.slice(i)).toLowerCase();
+  const unit = trimHoconWs(trimmed.slice(i));
   const divisor = OUTPUT_DURATION_UNITS[outputUnit];
   if (divisor === void 0) return NaN;
   if (unit === "") {
@@ -692,20 +701,6 @@ function isFileNotFoundError(e) {
 var import_node_module = require("module");
 var nodePath = __toESM(require("path"), 1);
 
-// src/internal/parser/empty-check.ts
-function hasContentTokens(tokens) {
-  return tokens.some((t) => t.kind !== "eof" && t.kind !== "newline");
-}
-function assertNonEmptyDocument(tokens, sourceDescriptor) {
-  if (!hasContentTokens(tokens)) {
-    throw new ParseError(
-      `empty file is not a valid HOCON document (HOCON.md L130): ${sourceDescriptor}`,
-      1,
-      1
-    );
-  }
-}
-
 // src/internal/lexer/lexer.ts
 function isHoconWhitespace(ch) {
   const cp = ch.codePointAt(0) ?? -1;
@@ -1151,6 +1146,16 @@ var Parser = class {
       }
       return { kind: "object", fields: allFields, pos: first.pos };
     }
+    if (t.kind === "lbracket") {
+      this.advance();
+      const arr = this.parseArray();
+      this.skip("newline");
+      const remaining = this.peek();
+      if (remaining.kind !== "eof") {
+        throw new ParseError(`Unexpected token '${remaining.value}' after root array`, remaining.line, remaining.col);
+      }
+      return { ...arr, pos: { line: t.line, col: t.col } };
+    }
     return this.parseObject(false);
   }
   peek(offset = 0) {
@@ -1590,6 +1595,16 @@ var _require = (0, import_node_module.createRequire)(import_meta.url);
 function isPnpPath(p) {
   return p.includes(".yarn/cache") || p.includes(".pnp.cjs") || p.includes(".pnp.loader");
 }
+function assertObjectRootedInclude(ast, sourcePath) {
+  if (ast.kind === "array") {
+    throw new ResolveError(
+      `included file has array at file root \u2014 an included file must contain an object, not an array (HOCON.md L993-994): ${sourcePath}`,
+      sourcePath,
+      ast.pos.line,
+      ast.pos.col
+    );
+  }
+}
 function validatePackageFile(file, identifier) {
   if (file.length === 0) {
     throw new ParseError(`include package("${identifier}", ...): file argument must be non-empty`, 0, 0);
@@ -1769,10 +1784,9 @@ var IncludeLoader = class {
     const resolver = packageResolver ?? ((id, f, includingFile, bDir) => defaultPackageResolver(id, f, includingFile, bDir, resolveFrom));
     const resolvedPath = resolver(identifier, file, void 0, baseDir);
     const content = readFileSync2(resolvedPath);
-    if (content.length === 0) return makeResObj();
     const tokens = tokenize(content);
-    assertNonEmptyDocument(tokens, resolvedPath);
     const ast = parseTokens(tokens);
+    assertObjectRootedInclude(ast, resolvedPath);
     return this.onBuildResObj(ast, {
       ...this.opts,
       baseDir: nodePath.dirname(resolvedPath),
@@ -1802,10 +1816,9 @@ var IncludeLoader = class {
     const resolvedPath = resolver(identifier, file, void 0, baseDir);
     const read = readFile ? async (p) => readFile(p) : async (p) => readFileSync2(p);
     const content = await read(resolvedPath);
-    if (content.length === 0) return makeResObj();
     const tokens = tokenize(content);
-    assertNonEmptyDocument(tokens, resolvedPath);
     const ast = parseTokens(tokens);
+    assertObjectRootedInclude(ast, resolvedPath);
     return this.onBuildResObjAsync(ast, {
       ...this.opts,
       baseDir: nodePath.dirname(resolvedPath),
@@ -1828,10 +1841,8 @@ var IncludeLoader = class {
       return hoconValueToResObj(propertiesToHoconValue(content));
     }
     const tokens = tokenize(content);
-    if (!hasContentTokens(tokens)) {
-      return makeResObj();
-    }
     const ast = parseTokens(tokens);
+    assertObjectRootedInclude(ast, candidate);
     return this.onBuildResObj(ast, {
       ...this.opts,
       baseDir: nodePath.dirname(candidate),
@@ -1855,10 +1866,8 @@ var IncludeLoader = class {
       return hoconValueToResObj(propertiesToHoconValue(content));
     }
     const tokens = tokenize(content);
-    if (!hasContentTokens(tokens)) {
-      return makeResObj();
-    }
     const ast = parseTokens(tokens);
+    assertObjectRootedInclude(ast, candidate);
     return this.onBuildResObjAsync(ast, {
       ...this.opts,
       baseDir: nodePath.dirname(candidate),
@@ -2601,6 +2610,32 @@ var Config = class _Config {
     if (v === void 0) return void 0;
     return hoconToJs(v);
   }
+  /**
+   * Returns the raw {@link HoconValue} node at `path` as a deeply-immutable
+   * {@link ReadonlyHoconValue} view, or `undefined` if the path is absent. Unlike
+   * `get` (which decodes to a plain JS value), this exposes the value tree for
+   * structural introspection via the `value.ts` accessors (`asString`, `asObject`,
+   * `isScalar`, …).
+   *
+   * `getValue('')` returns the root object node.
+   *
+   * Throws {@link NotResolvedError} when the node (or its subtree) is unresolved:
+   * the `HoconValue` union has no placeholder variant, so an unresolved value
+   * cannot be represented. This matches `getConfig` / `getList`.
+   */
+  getValue(path2) {
+    const v = this.lookupNode(path2);
+    if (v === void 0) {
+      if (!this._resolved && this._resObjRootSubtreeHasPlaceholders(path2)) {
+        throw new NotResolvedError(path2);
+      }
+      return void 0;
+    }
+    if (v.kind !== "scalar" && !this._resolved && this._resObjRootSubtreeHasPlaceholders(path2)) {
+      throw new NotResolvedError(path2);
+    }
+    return v;
+  }
   getString(path2) {
     const v = this.requireScalar(path2);
     if (v.valueType === "null") {
@@ -3024,8 +3059,14 @@ async function defaultReadFile(filePath) {
 }
 function buildResolveContext(input, opts) {
   const tokens = tokenize(input);
-  assertNonEmptyDocument(tokens, "input");
   const ast = parseTokens(tokens);
+  if (ast.kind === "array") {
+    const origin = opts.originDescription ?? "input";
+    throw new ConfigError(
+      `${origin}: ${ast.pos.line}:${ast.pos.col}: document has type array rather than object at file root (HOCON.md L989-991); the Config API requires an object root`,
+      ""
+    );
+  }
   const resolveOpts = {
     env: getEnv(opts),
     baseDir: opts.baseDir,
@@ -3108,6 +3149,35 @@ async function parseFileAsync(filePath, opts = {}) {
   });
 }
 
+// src/value.ts
+function asString(v) {
+  return v.kind === "scalar" && v.valueType === "string" ? v.raw : void 0;
+}
+function asNumber(v) {
+  return v.kind === "scalar" ? coerceNumber(v.raw) : void 0;
+}
+function asBoolean(v) {
+  return v.kind === "scalar" ? coerceBoolean(v.raw) : void 0;
+}
+function asObject(v) {
+  return v.kind === "object" ? v.fields : void 0;
+}
+function asArray(v) {
+  return v.kind === "array" ? v.items : void 0;
+}
+function isObject(v) {
+  return v.kind === "object";
+}
+function isArray(v) {
+  return v.kind === "array";
+}
+function isScalar(v) {
+  return v.kind === "scalar";
+}
+function isNull(v) {
+  return v.kind === "scalar" && v.valueType === "null";
+}
+
 // src/value-factory.ts
 function fromMap(values, originDescription) {
   const fields = coerceObject(values, "");
@@ -3182,10 +3252,19 @@ function coerceValue(v, atPath) {
   PackageLookupError,
   ParseError,
   ResolveError,
+  asArray,
+  asBoolean,
+  asNumber,
+  asObject,
+  asString,
   defaultParseOptions,
   defaultResolveOptions,
   empty,
   fromMap,
+  isArray,
+  isNull,
+  isObject,
+  isScalar,
   parse,
   parseAsync,
   parseFile,

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { C as Config } from './config-DCSLXkNY.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-DCSLXkNY.cjs';
+import { C as Config } from './config-D27s3_aG.cjs';
+export { B as ByteUnit, D as DurationUnit, H as HoconValue, P as PackageResolver, a as ParseOptions, R as ReadonlyHoconValue, b as ResolveOptions, S as ScalarValueType, c as asArray, d as asBoolean, e as asNumber, f as asObject, g as asString, h as defaultParseOptions, i as defaultResolveOptions, j as isArray, k as isNull, l as isObject, m as isScalar, p as parse, n as parseAsync, o as parseFile, q as parseFileAsync, r as parseFileWithOptions, s as parseString, t as parseStringWithOptions } from './config-D27s3_aG.cjs';
 
 declare class ParseError extends Error {
     readonly line: number;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { C as Config } from './config-DCSLXkNY.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-DCSLXkNY.js';
+import { C as Config } from './config-D27s3_aG.js';
+export { B as ByteUnit, D as DurationUnit, H as HoconValue, P as PackageResolver, a as ParseOptions, R as ReadonlyHoconValue, b as ResolveOptions, S as ScalarValueType, c as asArray, d as asBoolean, e as asNumber, f as asObject, g as asString, h as defaultParseOptions, i as defaultResolveOptions, j as isArray, k as isNull, l as isObject, m as isScalar, p as parse, n as parseAsync, o as parseFile, q as parseFileAsync, r as parseFileWithOptions, s as parseString, t as parseStringWithOptions } from './config-D27s3_aG.js';
 
 declare class ParseError extends Error {
     readonly line: number;

package/dist/index.js

@@ -80,7 +80,7 @@ function parseDuration(value, outputUnit = "ms") {
   if (i === 0) return NaN;
   const num = Number(trimmed.slice(0, i));
   if (Number.isNaN(num)) return NaN;
-  const unit = trimHoconWs(trimmed.slice(i)).toLowerCase();
+  const unit = trimHoconWs(trimmed.slice(i));
   const divisor = OUTPUT_DURATION_UNITS[outputUnit];
   if (divisor === void 0) return NaN;
   if (unit === "") {
@@ -640,20 +640,6 @@ function isFileNotFoundError(e) {
 import { createRequire } from "module";
 import * as nodePath from "path";
 
-// src/internal/parser/empty-check.ts
-function hasContentTokens(tokens) {
-  return tokens.some((t) => t.kind !== "eof" && t.kind !== "newline");
-}
-function assertNonEmptyDocument(tokens, sourceDescriptor) {
-  if (!hasContentTokens(tokens)) {
-    throw new ParseError(
-      `empty file is not a valid HOCON document (HOCON.md L130): ${sourceDescriptor}`,
-      1,
-      1
-    );
-  }
-}
-
 // src/internal/lexer/lexer.ts
 function isHoconWhitespace(ch) {
   const cp = ch.codePointAt(0) ?? -1;
@@ -1099,6 +1085,16 @@ var Parser = class {
       }
       return { kind: "object", fields: allFields, pos: first.pos };
     }
+    if (t.kind === "lbracket") {
+      this.advance();
+      const arr = this.parseArray();
+      this.skip("newline");
+      const remaining = this.peek();
+      if (remaining.kind !== "eof") {
+        throw new ParseError(`Unexpected token '${remaining.value}' after root array`, remaining.line, remaining.col);
+      }
+      return { ...arr, pos: { line: t.line, col: t.col } };
+    }
     return this.parseObject(false);
   }
   peek(offset = 0) {
@@ -1537,6 +1533,16 @@ var _require = createRequire(import.meta.url);
 function isPnpPath(p) {
   return p.includes(".yarn/cache") || p.includes(".pnp.cjs") || p.includes(".pnp.loader");
 }
+function assertObjectRootedInclude(ast, sourcePath) {
+  if (ast.kind === "array") {
+    throw new ResolveError(
+      `included file has array at file root \u2014 an included file must contain an object, not an array (HOCON.md L993-994): ${sourcePath}`,
+      sourcePath,
+      ast.pos.line,
+      ast.pos.col
+    );
+  }
+}
 function validatePackageFile(file, identifier) {
   if (file.length === 0) {
     throw new ParseError(`include package("${identifier}", ...): file argument must be non-empty`, 0, 0);
@@ -1716,10 +1722,9 @@ var IncludeLoader = class {
     const resolver = packageResolver ?? ((id, f, includingFile, bDir) => defaultPackageResolver(id, f, includingFile, bDir, resolveFrom));
     const resolvedPath = resolver(identifier, file, void 0, baseDir);
     const content = readFileSync2(resolvedPath);
-    if (content.length === 0) return makeResObj();
     const tokens = tokenize(content);
-    assertNonEmptyDocument(tokens, resolvedPath);
     const ast = parseTokens(tokens);
+    assertObjectRootedInclude(ast, resolvedPath);
     return this.onBuildResObj(ast, {
       ...this.opts,
       baseDir: nodePath.dirname(resolvedPath),
@@ -1749,10 +1754,9 @@ var IncludeLoader = class {
     const resolvedPath = resolver(identifier, file, void 0, baseDir);
     const read = readFile ? async (p) => readFile(p) : async (p) => readFileSync2(p);
     const content = await read(resolvedPath);
-    if (content.length === 0) return makeResObj();
     const tokens = tokenize(content);
-    assertNonEmptyDocument(tokens, resolvedPath);
     const ast = parseTokens(tokens);
+    assertObjectRootedInclude(ast, resolvedPath);
     return this.onBuildResObjAsync(ast, {
       ...this.opts,
       baseDir: nodePath.dirname(resolvedPath),
@@ -1775,10 +1779,8 @@ var IncludeLoader = class {
       return hoconValueToResObj(propertiesToHoconValue(content));
     }
     const tokens = tokenize(content);
-    if (!hasContentTokens(tokens)) {
-      return makeResObj();
-    }
     const ast = parseTokens(tokens);
+    assertObjectRootedInclude(ast, candidate);
     return this.onBuildResObj(ast, {
       ...this.opts,
       baseDir: nodePath.dirname(candidate),
@@ -1802,10 +1804,8 @@ var IncludeLoader = class {
       return hoconValueToResObj(propertiesToHoconValue(content));
     }
     const tokens = tokenize(content);
-    if (!hasContentTokens(tokens)) {
-      return makeResObj();
-    }
     const ast = parseTokens(tokens);
+    assertObjectRootedInclude(ast, candidate);
     return this.onBuildResObjAsync(ast, {
       ...this.opts,
       baseDir: nodePath.dirname(candidate),
@@ -2548,6 +2548,32 @@ var Config = class _Config {
     if (v === void 0) return void 0;
     return hoconToJs(v);
   }
+  /**
+   * Returns the raw {@link HoconValue} node at `path` as a deeply-immutable
+   * {@link ReadonlyHoconValue} view, or `undefined` if the path is absent. Unlike
+   * `get` (which decodes to a plain JS value), this exposes the value tree for
+   * structural introspection via the `value.ts` accessors (`asString`, `asObject`,
+   * `isScalar`, …).
+   *
+   * `getValue('')` returns the root object node.
+   *
+   * Throws {@link NotResolvedError} when the node (or its subtree) is unresolved:
+   * the `HoconValue` union has no placeholder variant, so an unresolved value
+   * cannot be represented. This matches `getConfig` / `getList`.
+   */
+  getValue(path2) {
+    const v = this.lookupNode(path2);
+    if (v === void 0) {
+      if (!this._resolved && this._resObjRootSubtreeHasPlaceholders(path2)) {
+        throw new NotResolvedError(path2);
+      }
+      return void 0;
+    }
+    if (v.kind !== "scalar" && !this._resolved && this._resObjRootSubtreeHasPlaceholders(path2)) {
+      throw new NotResolvedError(path2);
+    }
+    return v;
+  }
   getString(path2) {
     const v = this.requireScalar(path2);
     if (v.valueType === "null") {
@@ -2971,8 +2997,14 @@ async function defaultReadFile(filePath) {
 }
 function buildResolveContext(input, opts) {
   const tokens = tokenize(input);
-  assertNonEmptyDocument(tokens, "input");
   const ast = parseTokens(tokens);
+  if (ast.kind === "array") {
+    const origin = opts.originDescription ?? "input";
+    throw new ConfigError(
+      `${origin}: ${ast.pos.line}:${ast.pos.col}: document has type array rather than object at file root (HOCON.md L989-991); the Config API requires an object root`,
+      ""
+    );
+  }
   const resolveOpts = {
     env: getEnv(opts),
     baseDir: opts.baseDir,
@@ -3055,6 +3087,35 @@ async function parseFileAsync(filePath, opts = {}) {
   });
 }
 
+// src/value.ts
+function asString(v) {
+  return v.kind === "scalar" && v.valueType === "string" ? v.raw : void 0;
+}
+function asNumber(v) {
+  return v.kind === "scalar" ? coerceNumber(v.raw) : void 0;
+}
+function asBoolean(v) {
+  return v.kind === "scalar" ? coerceBoolean(v.raw) : void 0;
+}
+function asObject(v) {
+  return v.kind === "object" ? v.fields : void 0;
+}
+function asArray(v) {
+  return v.kind === "array" ? v.items : void 0;
+}
+function isObject(v) {
+  return v.kind === "object";
+}
+function isArray(v) {
+  return v.kind === "array";
+}
+function isScalar(v) {
+  return v.kind === "scalar";
+}
+function isNull(v) {
+  return v.kind === "scalar" && v.valueType === "null";
+}
+
 // src/value-factory.ts
 function fromMap(values, originDescription) {
   const fields = coerceObject(values, "");
@@ -3128,10 +3189,19 @@ export {
   PackageLookupError,
   ParseError,
   ResolveError,
+  asArray,
+  asBoolean,
+  asNumber,
+  asObject,
+  asString,
   defaultParseOptions,
   defaultResolveOptions,
   empty,
   fromMap,
+  isArray,
+  isNull,
+  isObject,
+  isScalar,
   parse,
   parseAsync,
   parseFile,

package/dist/zod.cjs

@@ -119,7 +119,7 @@ function parseDuration(value, outputUnit = "ms") {
   if (i === 0) return NaN;
   const num = Number(trimmed.slice(0, i));
   if (Number.isNaN(num)) return NaN;
-  const unit = trimHoconWs(trimmed.slice(i)).toLowerCase();
+  const unit = trimHoconWs(trimmed.slice(i));
   const divisor = OUTPUT_DURATION_UNITS[outputUnit];
   if (divisor === void 0) return NaN;
   if (unit === "") {
@@ -683,20 +683,6 @@ function isFileNotFoundError(e) {
 var import_node_module = require("module");
 var nodePath = __toESM(require("path"), 1);
 
-// src/internal/parser/empty-check.ts
-function hasContentTokens(tokens) {
-  return tokens.some((t) => t.kind !== "eof" && t.kind !== "newline");
-}
-function assertNonEmptyDocument(tokens, sourceDescriptor) {
-  if (!hasContentTokens(tokens)) {
-    throw new ParseError(
-      `empty file is not a valid HOCON document (HOCON.md L130): ${sourceDescriptor}`,
-      1,
-      1
-    );
-  }
-}
-
 // src/internal/lexer/lexer.ts
 function isHoconWhitespace(ch) {
   const cp = ch.codePointAt(0) ?? -1;
@@ -1142,6 +1128,16 @@ var Parser = class {
       }
       return { kind: "object", fields: allFields, pos: first.pos };
     }
+    if (t.kind === "lbracket") {
+      this.advance();
+      const arr = this.parseArray();
+      this.skip("newline");
+      const remaining = this.peek();
+      if (remaining.kind !== "eof") {
+        throw new ParseError(`Unexpected token '${remaining.value}' after root array`, remaining.line, remaining.col);
+      }
+      return { ...arr, pos: { line: t.line, col: t.col } };
+    }
     return this.parseObject(false);
   }
   peek(offset = 0) {
@@ -1581,6 +1577,16 @@ var _require = (0, import_node_module.createRequire)(import_meta.url);
 function isPnpPath(p) {
   return p.includes(".yarn/cache") || p.includes(".pnp.cjs") || p.includes(".pnp.loader");
 }
+function assertObjectRootedInclude(ast, sourcePath) {
+  if (ast.kind === "array") {
+    throw new ResolveError(
+      `included file has array at file root \u2014 an included file must contain an object, not an array (HOCON.md L993-994): ${sourcePath}`,
+      sourcePath,
+      ast.pos.line,
+      ast.pos.col
+    );
+  }
+}
 function validatePackageFile(file, identifier) {
   if (file.length === 0) {
     throw new ParseError(`include package("${identifier}", ...): file argument must be non-empty`, 0, 0);
@@ -1760,10 +1766,9 @@ var IncludeLoader = class {
     const resolver = packageResolver ?? ((id, f, includingFile, bDir) => defaultPackageResolver(id, f, includingFile, bDir, resolveFrom));
     const resolvedPath = resolver(identifier, file, void 0, baseDir);
     const content = readFileSync2(resolvedPath);
-    if (content.length === 0) return makeResObj();
     const tokens = tokenize(content);
-    assertNonEmptyDocument(tokens, resolvedPath);
     const ast = parseTokens(tokens);
+    assertObjectRootedInclude(ast, resolvedPath);
     return this.onBuildResObj(ast, {
       ...this.opts,
       baseDir: nodePath.dirname(resolvedPath),
@@ -1793,10 +1798,9 @@ var IncludeLoader = class {
     const resolvedPath = resolver(identifier, file, void 0, baseDir);
     const read = readFile ? async (p) => readFile(p) : async (p) => readFileSync2(p);
     const content = await read(resolvedPath);
-    if (content.length === 0) return makeResObj();
     const tokens = tokenize(content);
-    assertNonEmptyDocument(tokens, resolvedPath);
     const ast = parseTokens(tokens);
+    assertObjectRootedInclude(ast, resolvedPath);
     return this.onBuildResObjAsync(ast, {
       ...this.opts,
       baseDir: nodePath.dirname(resolvedPath),
@@ -1819,10 +1823,8 @@ var IncludeLoader = class {
       return hoconValueToResObj(propertiesToHoconValue(content));
     }
     const tokens = tokenize(content);
-    if (!hasContentTokens(tokens)) {
-      return makeResObj();
-    }
     const ast = parseTokens(tokens);
+    assertObjectRootedInclude(ast, candidate);
     return this.onBuildResObj(ast, {
       ...this.opts,
       baseDir: nodePath.dirname(candidate),
@@ -1846,10 +1848,8 @@ var IncludeLoader = class {
       return hoconValueToResObj(propertiesToHoconValue(content));
     }
     const tokens = tokenize(content);
-    if (!hasContentTokens(tokens)) {
-      return makeResObj();
-    }
     const ast = parseTokens(tokens);
+    assertObjectRootedInclude(ast, candidate);
     return this.onBuildResObjAsync(ast, {
       ...this.opts,
       baseDir: nodePath.dirname(candidate),
@@ -2588,6 +2588,32 @@ var Config = class _Config {
     if (v === void 0) return void 0;
     return hoconToJs(v);
   }
+  /**
+   * Returns the raw {@link HoconValue} node at `path` as a deeply-immutable
+   * {@link ReadonlyHoconValue} view, or `undefined` if the path is absent. Unlike
+   * `get` (which decodes to a plain JS value), this exposes the value tree for
+   * structural introspection via the `value.ts` accessors (`asString`, `asObject`,
+   * `isScalar`, …).
+   *
+   * `getValue('')` returns the root object node.
+   *
+   * Throws {@link NotResolvedError} when the node (or its subtree) is unresolved:
+   * the `HoconValue` union has no placeholder variant, so an unresolved value
+   * cannot be represented. This matches `getConfig` / `getList`.
+   */
+  getValue(path2) {
+    const v = this.lookupNode(path2);
+    if (v === void 0) {
+      if (!this._resolved && this._resObjRootSubtreeHasPlaceholders(path2)) {
+        throw new NotResolvedError(path2);
+      }
+      return void 0;
+    }
+    if (v.kind !== "scalar" && !this._resolved && this._resObjRootSubtreeHasPlaceholders(path2)) {
+      throw new NotResolvedError(path2);
+    }
+    return v;
+  }
   getString(path2) {
     const v = this.requireScalar(path2);
     if (v.valueType === "null") {
@@ -3000,8 +3026,14 @@ function defaultReadFileSync(filePath) {
 }
 function buildResolveContext(input, opts) {
   const tokens = tokenize(input);
-  assertNonEmptyDocument(tokens, "input");
   const ast = parseTokens(tokens);
+  if (ast.kind === "array") {
+    const origin = opts.originDescription ?? "input";
+    throw new ConfigError(
+      `${origin}: ${ast.pos.line}:${ast.pos.col}: document has type array rather than object at file root (HOCON.md L989-991); the Config API requires an object root`,
+      ""
+    );
+  }
   const resolveOpts = {
     env: getEnv(opts),
     baseDir: opts.baseDir,

package/dist/zod.d.cts

@@ -1,5 +1,5 @@
 import { ZodType } from 'zod';
-import { C as Config, a as ParseOptions } from './config-DCSLXkNY.cjs';
+import { C as Config, a as ParseOptions } from './config-D27s3_aG.cjs';
 
 declare function validate<T>(config: Config, schema: ZodType<T>): T;
 declare function getValidated<T>(config: Config, path: string, schema: ZodType<T>): T;

package/dist/zod.d.ts

@@ -1,5 +1,5 @@
 import { ZodType } from 'zod';
-import { C as Config, a as ParseOptions } from './config-DCSLXkNY.js';
+import { C as Config, a as ParseOptions } from './config-D27s3_aG.js';
 
 declare function validate<T>(config: Config, schema: ZodType<T>): T;
 declare function getValidated<T>(config: Config, path: string, schema: ZodType<T>): T;

package/dist/zod.js

@@ -80,7 +80,7 @@ function parseDuration(value, outputUnit = "ms") {
   if (i === 0) return NaN;
   const num = Number(trimmed.slice(0, i));
   if (Number.isNaN(num)) return NaN;
-  const unit = trimHoconWs(trimmed.slice(i)).toLowerCase();
+  const unit = trimHoconWs(trimmed.slice(i));
   const divisor = OUTPUT_DURATION_UNITS[outputUnit];
   if (divisor === void 0) return NaN;
   if (unit === "") {
@@ -644,20 +644,6 @@ function isFileNotFoundError(e) {
 import { createRequire } from "module";
 import * as nodePath from "path";
 
-// src/internal/parser/empty-check.ts
-function hasContentTokens(tokens) {
-  return tokens.some((t) => t.kind !== "eof" && t.kind !== "newline");
-}
-function assertNonEmptyDocument(tokens, sourceDescriptor) {
-  if (!hasContentTokens(tokens)) {
-    throw new ParseError(
-      `empty file is not a valid HOCON document (HOCON.md L130): ${sourceDescriptor}`,
-      1,
-      1
-    );
-  }
-}
-
 // src/internal/lexer/lexer.ts
 function isHoconWhitespace(ch) {
   const cp = ch.codePointAt(0) ?? -1;
@@ -1103,6 +1089,16 @@ var Parser = class {
       }
       return { kind: "object", fields: allFields, pos: first.pos };
     }
+    if (t.kind === "lbracket") {
+      this.advance();
+      const arr = this.parseArray();
+      this.skip("newline");
+      const remaining = this.peek();
+      if (remaining.kind !== "eof") {
+        throw new ParseError(`Unexpected token '${remaining.value}' after root array`, remaining.line, remaining.col);
+      }
+      return { ...arr, pos: { line: t.line, col: t.col } };
+    }
     return this.parseObject(false);
   }
   peek(offset = 0) {
@@ -1541,6 +1537,16 @@ var _require = createRequire(import.meta.url);
 function isPnpPath(p) {
   return p.includes(".yarn/cache") || p.includes(".pnp.cjs") || p.includes(".pnp.loader");
 }
+function assertObjectRootedInclude(ast, sourcePath) {
+  if (ast.kind === "array") {
+    throw new ResolveError(
+      `included file has array at file root \u2014 an included file must contain an object, not an array (HOCON.md L993-994): ${sourcePath}`,
+      sourcePath,
+      ast.pos.line,
+      ast.pos.col
+    );
+  }
+}
 function validatePackageFile(file, identifier) {
   if (file.length === 0) {
     throw new ParseError(`include package("${identifier}", ...): file argument must be non-empty`, 0, 0);
@@ -1720,10 +1726,9 @@ var IncludeLoader = class {
     const resolver = packageResolver ?? ((id, f, includingFile, bDir) => defaultPackageResolver(id, f, includingFile, bDir, resolveFrom));
     const resolvedPath = resolver(identifier, file, void 0, baseDir);
     const content = readFileSync2(resolvedPath);
-    if (content.length === 0) return makeResObj();
     const tokens = tokenize(content);
-    assertNonEmptyDocument(tokens, resolvedPath);
     const ast = parseTokens(tokens);
+    assertObjectRootedInclude(ast, resolvedPath);
     return this.onBuildResObj(ast, {
       ...this.opts,
       baseDir: nodePath.dirname(resolvedPath),
@@ -1753,10 +1758,9 @@ var IncludeLoader = class {
     const resolvedPath = resolver(identifier, file, void 0, baseDir);
     const read = readFile ? async (p) => readFile(p) : async (p) => readFileSync2(p);
     const content = await read(resolvedPath);
-    if (content.length === 0) return makeResObj();
     const tokens = tokenize(content);
-    assertNonEmptyDocument(tokens, resolvedPath);
     const ast = parseTokens(tokens);
+    assertObjectRootedInclude(ast, resolvedPath);
     return this.onBuildResObjAsync(ast, {
       ...this.opts,
       baseDir: nodePath.dirname(resolvedPath),
@@ -1779,10 +1783,8 @@ var IncludeLoader = class {
       return hoconValueToResObj(propertiesToHoconValue(content));
     }
     const tokens = tokenize(content);
-    if (!hasContentTokens(tokens)) {
-      return makeResObj();
-    }
     const ast = parseTokens(tokens);
+    assertObjectRootedInclude(ast, candidate);
     return this.onBuildResObj(ast, {
       ...this.opts,
       baseDir: nodePath.dirname(candidate),
@@ -1806,10 +1808,8 @@ var IncludeLoader = class {
       return hoconValueToResObj(propertiesToHoconValue(content));
     }
     const tokens = tokenize(content);
-    if (!hasContentTokens(tokens)) {
-      return makeResObj();
-    }
     const ast = parseTokens(tokens);
+    assertObjectRootedInclude(ast, candidate);
     return this.onBuildResObjAsync(ast, {
       ...this.opts,
       baseDir: nodePath.dirname(candidate),
@@ -2548,6 +2548,32 @@ var Config = class _Config {
     if (v === void 0) return void 0;
     return hoconToJs(v);
   }
+  /**
+   * Returns the raw {@link HoconValue} node at `path` as a deeply-immutable
+   * {@link ReadonlyHoconValue} view, or `undefined` if the path is absent. Unlike
+   * `get` (which decodes to a plain JS value), this exposes the value tree for
+   * structural introspection via the `value.ts` accessors (`asString`, `asObject`,
+   * `isScalar`, …).
+   *
+   * `getValue('')` returns the root object node.
+   *
+   * Throws {@link NotResolvedError} when the node (or its subtree) is unresolved:
+   * the `HoconValue` union has no placeholder variant, so an unresolved value
+   * cannot be represented. This matches `getConfig` / `getList`.
+   */
+  getValue(path2) {
+    const v = this.lookupNode(path2);
+    if (v === void 0) {
+      if (!this._resolved && this._resObjRootSubtreeHasPlaceholders(path2)) {
+        throw new NotResolvedError(path2);
+      }
+      return void 0;
+    }
+    if (v.kind !== "scalar" && !this._resolved && this._resObjRootSubtreeHasPlaceholders(path2)) {
+      throw new NotResolvedError(path2);
+    }
+    return v;
+  }
   getString(path2) {
     const v = this.requireScalar(path2);
     if (v.valueType === "null") {
@@ -2960,8 +2986,14 @@ function defaultReadFileSync(filePath) {
 }
 function buildResolveContext(input, opts) {
   const tokens = tokenize(input);
-  assertNonEmptyDocument(tokens, "input");
   const ast = parseTokens(tokens);
+  if (ast.kind === "array") {
+    const origin = opts.originDescription ?? "input";
+    throw new ConfigError(
+      `${origin}: ${ast.pos.line}:${ast.pos.col}: document has type array rather than object at file root (HOCON.md L989-991); the Config API requires an object root`,
+      ""
+    );
+  }
   const resolveOpts = {
     env: getEnv(opts),
     baseDir: opts.baseDir,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@o3co/ts.hocon",
-  "version": "1.7.1",
+  "version": "1.9.0",
   "description": "Full Lightbend HOCON spec-compliant parser and config library for TypeScript",
   "keywords": [
     "hocon",
@@ -29,6 +29,15 @@
   "files": [
     "dist"
   ],
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "coverage": "vitest run --coverage",
+    "bench": "vitest bench",
+    "docs": "typedoc"
+  },
   "peerDependencies": {
     "zod": ">=4.0.0"
   },
@@ -39,18 +48,18 @@
   },
   "devDependencies": {
     "@types/js-yaml": "^4.0.9",
-    "@types/node": "^25.5.0",
-    "@vitest/coverage-v8": "4.1.2",
-    "js-yaml": "^4.1.1",
+    "@types/node": "^25.9.5",
+    "@vitest/coverage-v8": "4.1.10",
+    "js-yaml": "^4.3.0",
     "tsup": "^8.5.1",
-    "typedoc": "^0.28.18",
+    "typedoc": "^0.28.20",
     "typescript": "^5.9.3",
-    "vitest": "4.1.2",
-    "zod": "^4.3.6"
+    "vitest": "4.1.10",
+    "zod": "^4.4.3"
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/o3co/ts.hocon"
+    "url": "git+https://github.com/o3co/ts.hocon.git"
   },
   "license": "Apache-2.0",
   "engines": {
@@ -58,13 +67,5 @@
   },
   "homepage": "https://o3co.github.io/ts.hocon/",
   "bugs": "https://github.com/o3co/ts.hocon/issues",
-  "scripts": {
-    "build": "tsup",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "typecheck": "tsc --noEmit",
-    "coverage": "vitest run --coverage",
-    "bench": "vitest bench",
-    "docs": "typedoc"
-  }
-}
+  "packageManager": "pnpm@10.30.2"
+}