@o3co/ts.hocon 1.8.0 → 1.10.0

package/dist/index.cjs

@@ -141,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 === "") {
@@ -701,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;
@@ -1115,12 +1101,12 @@ function isDecimalDigit(ch) {
 }
 function isUnquotedStart(ch) {
   if (ch === "" || isHoconWhitespace(ch)) return false;
-  if ('{}[],:=+#"$?!@*&^\\'.includes(ch)) return false;
+  if ('{}[],:=+#"$?!@*&^`\\'.includes(ch)) return false;
   return true;
 }
 function isUnquotedContinue(ch, nextFn) {
   if (ch === "" || isHoconWhitespace(ch)) return false;
-  if ('{}[],:=#"$?!@*&^\\'.includes(ch)) return false;
+  if ('{}[],:=#"$?!@*&^`\\'.includes(ch)) return false;
   if (ch === "+" && nextFn() === "=") return false;
   if (ch === "/" && nextFn() === "/") return false;
   return true;
@@ -1160,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) {
@@ -1259,6 +1255,17 @@ var Parser = class {
         this.advance();
         const raw = t.value.startsWith(".") && segments.length > 0 && !t.precedingSpace ? t.value.slice(1) : t.value;
         const parts = raw.split(".");
+        const leadingDotIsSeparator = spaceConcat || postDotPrefix !== "";
+        for (let i = 0; i < parts.length; i++) {
+          if (parts[i] !== "") continue;
+          if (i === parts.length - 1) continue;
+          if (i === 0 && leadingDotIsSeparator) continue;
+          throw new ParseError(
+            `path has ${i === 0 ? "a leading period '.'" : "two adjacent periods '.'"} \u2014 empty key segment not allowed, use quoted "" (HOCON.md path rules)`,
+            t.line,
+            t.col
+          );
+        }
         const filtered = parts.filter((s) => s.length > 0);
         if (spaceConcat) {
           segments[segments.length - 1] = `${segments[segments.length - 1]}${t.precedingWhitespace}`;
@@ -1537,29 +1544,108 @@ function parseTokens(tokens) {
 
 // src/internal/properties/properties.ts
 function parseProperties(input) {
-  const root = /* @__PURE__ */ Object.create(null);
   const pairs = [];
-  for (const line of input.split("\n")) {
-    const trimmed = line.trim();
-    if (trimmed === "" || trimmed.startsWith("#") || trimmed.startsWith("!")) continue;
-    const sepIdx = findSeparator(trimmed);
-    if (sepIdx === -1) continue;
-    const key = trimmed.slice(0, sepIdx).trim();
-    const value = trimmed.slice(sepIdx + 1).trim();
+  for (const { text, line } of logicalLines(input)) {
+    const [rawKey, rawValue] = splitKeyValue(text);
+    const key = unescapeProps(rawKey, line);
     if (key === "") continue;
-    pairs.push([key, value]);
+    pairs.push([key, unescapeProps(rawValue, line)]);
   }
-  pairs.sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0);
-  for (const [key, value] of pairs) {
+  return nestPairs(pairs);
+}
+function nestPairs(pairs) {
+  const root = /* @__PURE__ */ Object.create(null);
+  const sorted = [...pairs].sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0);
+  for (const [key, value] of sorted) {
     setNested(root, key.split("."), value);
   }
   return root;
 }
-function findSeparator(line) {
-  for (let i = 0; i < line.length; i++) {
-    if (line[i] === "=" || line[i] === ":") return i;
+function logicalLines(input) {
+  const natural = input.replace(/\r\n/g, "\n").replace(/\r/g, "\n").split("\n");
+  const out = [];
+  for (let i = 0; i < natural.length; i++) {
+    let text = trimLeadingSpace(natural[i] ?? "");
+    if (text === "" || text.startsWith("#") || text.startsWith("!")) continue;
+    const start = i + 1;
+    while (endsWithContinuation(text)) {
+      text = text.slice(0, -1);
+      if (i + 1 >= natural.length) break;
+      i++;
+      text += trimLeadingSpace(natural[i] ?? "");
+    }
+    out.push({ text, line: start });
+  }
+  return out;
+}
+function trimLeadingSpace(s) {
+  return s.replace(/^[ \t\f]+/, "");
+}
+function endsWithContinuation(line) {
+  let n = 0;
+  for (let i = line.length - 1; i >= 0 && line[i] === "\\"; i--) n++;
+  return n % 2 === 1;
+}
+function splitKeyValue(line) {
+  let key = "";
+  let i = 0;
+  for (; i < line.length; i++) {
+    const c = line[i];
+    if (c === "\\" && i + 1 < line.length) {
+      key += c + line[i + 1];
+      i++;
+      continue;
+    }
+    if (c === "=" || c === ":" || isPropsSpace(c)) break;
+    key += c;
+  }
+  while (i < line.length && isPropsSpace(line[i])) i++;
+  if (i < line.length && (line[i] === "=" || line[i] === ":")) {
+    i++;
+    while (i < line.length && isPropsSpace(line[i])) i++;
+  }
+  return [key, line.slice(i)];
+}
+function isPropsSpace(c) {
+  return c === " " || c === "	" || c === "\f";
+}
+function unescapeProps(s, line) {
+  let out = "";
+  for (let i = 0; i < s.length; i++) {
+    if (s[i] !== "\\") {
+      out += s[i];
+      continue;
+    }
+    i++;
+    if (i >= s.length) break;
+    const e = s[i];
+    switch (e) {
+      case "t":
+        out += "	";
+        break;
+      case "n":
+        out += "\n";
+        break;
+      case "r":
+        out += "\r";
+        break;
+      case "f":
+        out += "\f";
+        break;
+      case "u": {
+        const hex = s.slice(i + 1, i + 5);
+        if (!/^[0-9a-fA-F]{4}$/.test(hex)) {
+          throw new ParseError(`malformed \\u escape in .properties: \\u${hex}`, line, i + 1);
+        }
+        out += String.fromCharCode(parseInt(hex, 16));
+        i += 4;
+        break;
+      }
+      default:
+        out += e;
+    }
   }
-  return -1;
+  return out;
 }
 var DANGEROUS_KEYS = /* @__PURE__ */ new Set(["__proto__", "constructor", "prototype"]);
 function setNested(obj, segments, value) {
@@ -1599,6 +1685,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);
@@ -1778,10 +1874,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),
@@ -1811,10 +1906,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),
@@ -1837,10 +1931,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),
@@ -1864,10 +1956,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),
@@ -3059,8 +3149,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,

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-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';
+import { C as Config } from './config-PdhVgeLS.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-PdhVgeLS.cjs';
 
 declare class ParseError extends Error {
     readonly line: number;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-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';
+import { C as Config } from './config-PdhVgeLS.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-PdhVgeLS.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;
@@ -1054,12 +1040,12 @@ function isDecimalDigit(ch) {
 }
 function isUnquotedStart(ch) {
   if (ch === "" || isHoconWhitespace(ch)) return false;
-  if ('{}[],:=+#"$?!@*&^\\'.includes(ch)) return false;
+  if ('{}[],:=+#"$?!@*&^`\\'.includes(ch)) return false;
   return true;
 }
 function isUnquotedContinue(ch, nextFn) {
   if (ch === "" || isHoconWhitespace(ch)) return false;
-  if ('{}[],:=#"$?!@*&^\\'.includes(ch)) return false;
+  if ('{}[],:=#"$?!@*&^`\\'.includes(ch)) return false;
   if (ch === "+" && nextFn() === "=") return false;
   if (ch === "/" && nextFn() === "/") return false;
   return true;
@@ -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) {
@@ -1198,6 +1194,17 @@ var Parser = class {
         this.advance();
         const raw = t.value.startsWith(".") && segments.length > 0 && !t.precedingSpace ? t.value.slice(1) : t.value;
         const parts = raw.split(".");
+        const leadingDotIsSeparator = spaceConcat || postDotPrefix !== "";
+        for (let i = 0; i < parts.length; i++) {
+          if (parts[i] !== "") continue;
+          if (i === parts.length - 1) continue;
+          if (i === 0 && leadingDotIsSeparator) continue;
+          throw new ParseError(
+            `path has ${i === 0 ? "a leading period '.'" : "two adjacent periods '.'"} \u2014 empty key segment not allowed, use quoted "" (HOCON.md path rules)`,
+            t.line,
+            t.col
+          );
+        }
         const filtered = parts.filter((s) => s.length > 0);
         if (spaceConcat) {
           segments[segments.length - 1] = `${segments[segments.length - 1]}${t.precedingWhitespace}`;
@@ -1476,29 +1483,108 @@ function parseTokens(tokens) {
 
 // src/internal/properties/properties.ts
 function parseProperties(input) {
-  const root = /* @__PURE__ */ Object.create(null);
   const pairs = [];
-  for (const line of input.split("\n")) {
-    const trimmed = line.trim();
-    if (trimmed === "" || trimmed.startsWith("#") || trimmed.startsWith("!")) continue;
-    const sepIdx = findSeparator(trimmed);
-    if (sepIdx === -1) continue;
-    const key = trimmed.slice(0, sepIdx).trim();
-    const value = trimmed.slice(sepIdx + 1).trim();
+  for (const { text, line } of logicalLines(input)) {
+    const [rawKey, rawValue] = splitKeyValue(text);
+    const key = unescapeProps(rawKey, line);
     if (key === "") continue;
-    pairs.push([key, value]);
+    pairs.push([key, unescapeProps(rawValue, line)]);
   }
-  pairs.sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0);
-  for (const [key, value] of pairs) {
+  return nestPairs(pairs);
+}
+function nestPairs(pairs) {
+  const root = /* @__PURE__ */ Object.create(null);
+  const sorted = [...pairs].sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0);
+  for (const [key, value] of sorted) {
     setNested(root, key.split("."), value);
   }
   return root;
 }
-function findSeparator(line) {
-  for (let i = 0; i < line.length; i++) {
-    if (line[i] === "=" || line[i] === ":") return i;
+function logicalLines(input) {
+  const natural = input.replace(/\r\n/g, "\n").replace(/\r/g, "\n").split("\n");
+  const out = [];
+  for (let i = 0; i < natural.length; i++) {
+    let text = trimLeadingSpace(natural[i] ?? "");
+    if (text === "" || text.startsWith("#") || text.startsWith("!")) continue;
+    const start = i + 1;
+    while (endsWithContinuation(text)) {
+      text = text.slice(0, -1);
+      if (i + 1 >= natural.length) break;
+      i++;
+      text += trimLeadingSpace(natural[i] ?? "");
+    }
+    out.push({ text, line: start });
+  }
+  return out;
+}
+function trimLeadingSpace(s) {
+  return s.replace(/^[ \t\f]+/, "");
+}
+function endsWithContinuation(line) {
+  let n = 0;
+  for (let i = line.length - 1; i >= 0 && line[i] === "\\"; i--) n++;
+  return n % 2 === 1;
+}
+function splitKeyValue(line) {
+  let key = "";
+  let i = 0;
+  for (; i < line.length; i++) {
+    const c = line[i];
+    if (c === "\\" && i + 1 < line.length) {
+      key += c + line[i + 1];
+      i++;
+      continue;
+    }
+    if (c === "=" || c === ":" || isPropsSpace(c)) break;
+    key += c;
+  }
+  while (i < line.length && isPropsSpace(line[i])) i++;
+  if (i < line.length && (line[i] === "=" || line[i] === ":")) {
+    i++;
+    while (i < line.length && isPropsSpace(line[i])) i++;
+  }
+  return [key, line.slice(i)];
+}
+function isPropsSpace(c) {
+  return c === " " || c === "	" || c === "\f";
+}
+function unescapeProps(s, line) {
+  let out = "";
+  for (let i = 0; i < s.length; i++) {
+    if (s[i] !== "\\") {
+      out += s[i];
+      continue;
+    }
+    i++;
+    if (i >= s.length) break;
+    const e = s[i];
+    switch (e) {
+      case "t":
+        out += "	";
+        break;
+      case "n":
+        out += "\n";
+        break;
+      case "r":
+        out += "\r";
+        break;
+      case "f":
+        out += "\f";
+        break;
+      case "u": {
+        const hex = s.slice(i + 1, i + 5);
+        if (!/^[0-9a-fA-F]{4}$/.test(hex)) {
+          throw new ParseError(`malformed \\u escape in .properties: \\u${hex}`, line, i + 1);
+        }
+        out += String.fromCharCode(parseInt(hex, 16));
+        i += 4;
+        break;
+      }
+      default:
+        out += e;
+    }
   }
-  return -1;
+  return out;
 }
 var DANGEROUS_KEYS = /* @__PURE__ */ new Set(["__proto__", "constructor", "prototype"]);
 function setNested(obj, segments, value) {
@@ -1537,6 +1623,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 +1812,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 +1844,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 +1869,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 +1894,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),
@@ -2997,8 +3087,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,