@o3co/ts.hocon 1.6.0 → 1.6.1

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

@@ -39,17 +39,20 @@ type ConcatPlaceholder = {
     /** 1-based column of the concat value in the source file (from AST Concat pos). */
     col: number;
 };
-type AppendPlaceholder = {
-    _kind: 'append-placeholder';
-    existing: ResolverValue;
-    elem: ResolverValue;
-};
 type ResObj = {
     _kind: 'res-obj';
     fields: Map<string, ResolverValue>;
     priorValues: Map<string, ResolverValue>;
+    /**
+     * Keys whose net value in THIS object was established by an explicit
+     * non-self-referential assignment (`k = [...]`), i.e. a reset rather than a
+     * `+=`/self-ref append. Used by `deepMergeResObjInto` to decide whether an
+     * included file's `k` chains off the destination's pre-merge value (append
+     * origin → splice) or replaces it (reset origin → discard). See go.hocon#134.
+     */
+    resetKeys: Set<string>;
 };
-type ResolverValue = HoconValue | SubstPlaceholder | ConcatPlaceholder | AppendPlaceholder | ResObj;
+type ResolverValue = HoconValue | SubstPlaceholder | ConcatPlaceholder | ResObj;
 /**
  * Custom resolver for `include package("id", "file")`.
  *

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

@@ -39,17 +39,20 @@ type ConcatPlaceholder = {
     /** 1-based column of the concat value in the source file (from AST Concat pos). */
     col: number;
 };
-type AppendPlaceholder = {
-    _kind: 'append-placeholder';
-    existing: ResolverValue;
-    elem: ResolverValue;
-};
 type ResObj = {
     _kind: 'res-obj';
     fields: Map<string, ResolverValue>;
     priorValues: Map<string, ResolverValue>;
+    /**
+     * Keys whose net value in THIS object was established by an explicit
+     * non-self-referential assignment (`k = [...]`), i.e. a reset rather than a
+     * `+=`/self-ref append. Used by `deepMergeResObjInto` to decide whether an
+     * included file's `k` chains off the destination's pre-merge value (append
+     * origin → splice) or replaces it (reset origin → discard). See go.hocon#134.
+     */
+    resetKeys: Set<string>;
 };
-type ResolverValue = HoconValue | SubstPlaceholder | ConcatPlaceholder | AppendPlaceholder | ResObj;
+type ResolverValue = HoconValue | SubstPlaceholder | ConcatPlaceholder | ResObj;
 /**
  * Custom resolver for `include package("id", "file")`.
  *

package/dist/index.cjs

@@ -289,55 +289,6 @@ var NotResolvedError = class extends ConfigError {
   }
 };
 
-// src/internal/resolver/types.ts
-var separatorValues = /* @__PURE__ */ new WeakSet();
-function isSubst(v) {
-  return v._kind === "subst-placeholder";
-}
-function isConcat(v) {
-  return v._kind === "concat-placeholder";
-}
-function isAppend(v) {
-  return v._kind === "append-placeholder";
-}
-function isResObj(v) {
-  return v._kind === "res-obj";
-}
-function makeResObj() {
-  return { _kind: "res-obj", fields: /* @__PURE__ */ new Map(), priorValues: /* @__PURE__ */ new Map() };
-}
-function mergeUnresolved(receiver, fallback) {
-  const result = makeResObj();
-  for (const [k, v] of fallback.fields) {
-    result.fields.set(k, v);
-  }
-  for (const [k, v] of fallback.priorValues) {
-    result.priorValues.set(k, v);
-  }
-  for (const [k, rv] of receiver.fields) {
-    const existing = result.fields.get(k);
-    if (existing !== void 0) {
-      const recPrior = receiver.priorValues.get(k);
-      if (recPrior !== void 0 && !isResObj(recPrior)) {
-        result.fields.set(k, rv);
-        continue;
-      }
-      if (isResObj(rv) && isResObj(existing)) {
-        result.fields.set(k, mergeUnresolved(rv, existing));
-        continue;
-      }
-      result.priorValues.set(k, existing);
-    }
-    result.fields.set(k, rv);
-  }
-  for (const [k, v] of receiver.priorValues) {
-    if (receiver.fields.has(k)) {
-      result.priorValues.set(k, v);
-    }
-  }
-  return result;
-}
-
 // src/internal/resolver/fold-self-ref.ts
 function substFullKey(s) {
   return stringSegmentsToKey(s.segments.map((seg) => seg.text));
@@ -353,9 +304,6 @@ function stringSegmentsToKey(segments) {
 function containsSelfRef(v, fullKey) {
   if (isSubst(v)) return !v.knownAbsent && substFullKey(v) === fullKey;
   if (isConcat(v)) return v.nodes.some((n) => containsSelfRef(n, fullKey));
-  if (isAppend(v)) {
-    return containsSelfRef(v.existing, fullKey) || containsSelfRef(v.elem, fullKey);
-  }
   if (isResObj(v)) {
     for (const f of v.fields.values()) {
       if (containsSelfRef(f, fullKey)) return true;
@@ -386,19 +334,12 @@ function foldSelfRef(v, fullKey, replacement) {
       col: v.col
     };
   }
-  if (isAppend(v)) {
-    return {
-      _kind: "append-placeholder",
-      existing: foldSelfRef(v.existing, fullKey, replacement),
-      elem: foldSelfRef(v.elem, fullKey, replacement)
-    };
-  }
   if (isResObj(v)) {
     const newFields = /* @__PURE__ */ new Map();
     for (const [k, val] of v.fields) {
       newFields.set(k, foldSelfRef(val, fullKey, replacement));
     }
-    return { _kind: "res-obj", fields: newFields, priorValues: new Map(v.priorValues) };
+    return { _kind: "res-obj", fields: newFields, priorValues: new Map(v.priorValues), resetKeys: new Set(v.resetKeys) };
   }
   const hv = v;
   if (hv.kind === "array") {
@@ -416,6 +357,41 @@ function foldSelfRef(v, fullKey, replacement) {
   }
   return v;
 }
+function foldKnownAbsentSelfRef(v, fullKey, replacement) {
+  if (isSubst(v)) {
+    return v.knownAbsent && substFullKey(v) === fullKey ? replacement : v;
+  }
+  if (isConcat(v)) {
+    return {
+      _kind: "concat-placeholder",
+      nodes: v.nodes.map((n) => foldKnownAbsentSelfRef(n, fullKey, replacement)),
+      line: v.line,
+      col: v.col
+    };
+  }
+  if (isResObj(v)) {
+    const newFields = /* @__PURE__ */ new Map();
+    for (const [k, val] of v.fields) {
+      newFields.set(k, foldKnownAbsentSelfRef(val, fullKey, replacement));
+    }
+    return { _kind: "res-obj", fields: newFields, priorValues: new Map(v.priorValues), resetKeys: new Set(v.resetKeys) };
+  }
+  const hv = v;
+  if (hv.kind === "array") {
+    return {
+      kind: "array",
+      items: hv.items.map((item) => foldKnownAbsentSelfRef(item, fullKey, replacement))
+    };
+  }
+  if (hv.kind === "object") {
+    const newFields = /* @__PURE__ */ new Map();
+    for (const [k, val] of hv.fields) {
+      newFields.set(k, foldKnownAbsentSelfRef(val, fullKey, replacement));
+    }
+    return { kind: "object", fields: newFields };
+  }
+  return v;
+}
 function foldOrSkipPrior(prior, fullKey, old) {
   if (!containsSelfRef(prior, fullKey)) return cloneResolverValue(prior);
   if (old === void 0) return foldOptionalSelfRefAbsent(prior, fullKey);
@@ -444,12 +420,6 @@ function foldOptionalSelfRefAbsent(v, fullKey) {
     }
     return { _kind: "concat-placeholder", nodes, line: v.line, col: v.col };
   }
-  if (isAppend(v)) {
-    const existing = foldOptionalSelfRefAbsent(v.existing, fullKey);
-    const elem = foldOptionalSelfRefAbsent(v.elem, fullKey);
-    if (existing === void 0 || elem === void 0) return void 0;
-    return { _kind: "append-placeholder", existing, elem };
-  }
   if (isResObj(v)) {
     const fields = /* @__PURE__ */ new Map();
     for (const [key, value] of v.fields) {
@@ -457,7 +427,7 @@ function foldOptionalSelfRefAbsent(v, fullKey) {
       if (folded === void 0) return void 0;
       fields.set(key, folded);
     }
-    return { _kind: "res-obj", fields, priorValues: new Map(v.priorValues) };
+    return { _kind: "res-obj", fields, priorValues: new Map(v.priorValues), resetKeys: new Set(v.resetKeys) };
   }
   const hv = v;
   if (hv.kind === "array") {
@@ -506,14 +476,7 @@ function cloneResolverValue(v) {
     for (const [k, val] of v.fields) newFields.set(k, cloneResolverValue(val));
     const newPriors = /* @__PURE__ */ new Map();
     for (const [k, val] of v.priorValues) newPriors.set(k, cloneResolverValue(val));
-    return { _kind: "res-obj", fields: newFields, priorValues: newPriors };
-  }
-  if (isAppend(v)) {
-    return {
-      _kind: "append-placeholder",
-      existing: cloneResolverValue(v.existing),
-      elem: cloneResolverValue(v.elem)
-    };
+    return { _kind: "res-obj", fields: newFields, priorValues: newPriors, resetKeys: new Set(v.resetKeys) };
   }
   const hv = v;
   if (hv.kind === "array") {
@@ -548,14 +511,11 @@ function foldNestedSelfRefs(v, pathPrefix) {
     }
     newFields.set(k, finalVal);
   }
-  return { _kind: "res-obj", fields: newFields, priorValues: new Map(v.priorValues) };
+  return { _kind: "res-obj", fields: newFields, priorValues: new Map(v.priorValues), resetKeys: new Set(v.resetKeys) };
 }
 function containsSubstByPath(v, target) {
   if (isSubst(v)) return !v.knownAbsent && segmentsTextEqual(v.segments, target);
   if (isConcat(v)) return v.nodes.some((n) => containsSubstByPath(n, target));
-  if (isAppend(v)) {
-    return containsSubstByPath(v.existing, target) || containsSubstByPath(v.elem, target);
-  }
   if (isResObj(v)) {
     for (const f of v.fields.values()) {
       if (containsSubstByPath(f, target)) return true;
@@ -584,6 +544,53 @@ function segmentsTextEqual(a, b) {
   return true;
 }
 
+// src/internal/resolver/types.ts
+var separatorValues = /* @__PURE__ */ new WeakSet();
+function isSubst(v) {
+  return v._kind === "subst-placeholder";
+}
+function isConcat(v) {
+  return v._kind === "concat-placeholder";
+}
+function isResObj(v) {
+  return v._kind === "res-obj";
+}
+function makeResObj() {
+  return { _kind: "res-obj", fields: /* @__PURE__ */ new Map(), priorValues: /* @__PURE__ */ new Map(), resetKeys: /* @__PURE__ */ new Set() };
+}
+function mergeUnresolved(receiver, fallback) {
+  const result = makeResObj();
+  for (const [k, v] of fallback.fields) {
+    result.fields.set(k, v);
+  }
+  for (const [k, v] of fallback.priorValues) {
+    result.priorValues.set(k, v);
+  }
+  for (const [k, rv] of receiver.fields) {
+    const existing = result.fields.get(k);
+    if (existing !== void 0) {
+      const recPrior = receiver.priorValues.get(k);
+      if (recPrior !== void 0 && !isResObj(recPrior)) {
+        result.fields.set(k, rv);
+        continue;
+      }
+      if (isResObj(rv) && isResObj(existing)) {
+        result.fields.set(k, mergeUnresolved(rv, existing));
+        continue;
+      }
+      const foldedPrior = foldOrSkipPrior(existing, k, void 0);
+      if (foldedPrior !== void 0) result.priorValues.set(k, foldedPrior);
+    }
+    result.fields.set(k, rv);
+  }
+  for (const [k, v] of receiver.priorValues) {
+    if (receiver.fields.has(k)) {
+      result.priorValues.set(k, v);
+    }
+  }
+  return result;
+}
+
 // src/internal/resolver/utils.ts
 function segmentsToKey(segments) {
   return segments.map((s) => {
@@ -637,9 +644,19 @@ function deepMergeResObjInto(dst, src, pathPrefix = []) {
       deepMergeResObjInto(dstVal, srcVal, childPrefix);
     } else {
       if (dstVal !== void 0) {
-        const priorExisting = dst.priorValues.get(k);
-        const prior = foldOrSkipPrior(dstVal, fullKey, priorExisting);
-        if (prior !== void 0) dst.priorValues.set(k, prior);
+        if (src.resetKeys.has(k)) {
+          dst.priorValues.delete(k);
+        } else {
+          const dstFolded = foldOrSkipPrior(dstVal, fullKey, dst.priorValues.get(k));
+          if (dstFolded !== void 0) {
+            const srcPrior = src.priorValues.get(k);
+            if (srcPrior !== void 0) {
+              dst.priorValues.set(k, foldKnownAbsentSelfRef(srcPrior, fullKey, dstFolded));
+            } else {
+              dst.priorValues.set(k, dstFolded);
+            }
+          }
+        }
       }
       dst.fields.set(k, srcVal);
     }
@@ -649,6 +666,7 @@ function deepMergeResObjInto(dst, src, pathPrefix = []) {
       dst.priorValues.set(k, srcPrior);
     }
   }
+  for (const k of src.resetKeys) dst.resetKeys.add(k);
 }
 function hoconValueToResObj(hv) {
   const obj = makeResObj();
@@ -1905,31 +1923,15 @@ var StructureBuilder = class _StructureBuilder {
     const childPrefix = [...pathPrefix, head];
     const fullKey = stringSegmentsToKey(childPrefix);
     if (field.append) {
-      const existing2 = obj.fields.get(head) ?? { kind: "array", items: [] };
-      const oldPrior = obj.priorValues.get(head);
-      const folded = foldOrSkipPrior(existing2, fullKey, oldPrior);
-      if (folded !== void 0) obj.priorValues.set(head, folded);
-      obj.fields.set(head, {
-        _kind: "append-placeholder",
-        // Use the folded existing (self-ref-free) for the Append. When the
-        // fold returned undefined (self-ref present but no old prior),
-        // fall back to the original existing — resolveSubst will then
-        // raise the "self-ref with no prior value" error at resolve time,
-        // matching the pre-fix behaviour for that edge case.
-        //
-        // Clone `folded` again so the Append.existing and priorValues[head]
-        // do not share the same Subst/Concat references — relativizeResObj
-        // walks BOTH `fields` and `priorValues` and mutates Subst.segments
-        // in place, so a shared reference would get its prefix applied
-        // twice (resulting in e.g. `${outer.outer.base}` instead of
-        // `${outer.base}`). Codex review on PR #131.
-        existing: folded !== void 0 ? cloneResolverValue(folded) : existing2,
-        elem: this.astToResolverValue(field.value, childPrefix)
-      });
+      const synthetic = this.desugarAppend(field, childPrefix);
+      this.applyField(obj, synthetic, pathPrefix);
       return;
     }
     const existing = obj.fields.get(head);
     const newVal = this.astToResolverValue(field.value, childPrefix);
+    if (!containsSelfRef(newVal, fullKey)) {
+      obj.resetKeys.add(head);
+    }
     if (existing !== void 0) {
       const oldPrior = obj.priorValues.get(head);
       const priorInput = isResObj(existing) ? foldNestedSelfRefs(existing, childPrefix) : existing;
@@ -1971,19 +1973,15 @@ var StructureBuilder = class _StructureBuilder {
     const childPrefix = [...pathPrefix, head];
     const fullKey = stringSegmentsToKey(childPrefix);
     if (field.append) {
-      const existing2 = obj.fields.get(head) ?? { kind: "array", items: [] };
-      const oldPrior = obj.priorValues.get(head);
-      const folded = foldOrSkipPrior(existing2, fullKey, oldPrior);
-      if (folded !== void 0) obj.priorValues.set(head, folded);
-      obj.fields.set(head, {
-        _kind: "append-placeholder",
-        existing: folded !== void 0 ? cloneResolverValue(folded) : existing2,
-        elem: await this.astToResolverValueAsync(field.value, childPrefix)
-      });
+      const synthetic = this.desugarAppend(field, childPrefix);
+      await this.applyFieldAsync(obj, synthetic, pathPrefix);
       return;
     }
     const existing = obj.fields.get(head);
     const newVal = await this.astToResolverValueAsync(field.value, childPrefix);
+    if (!containsSelfRef(newVal, fullKey)) {
+      obj.resetKeys.add(head);
+    }
     if (existing !== void 0) {
       const oldPrior = obj.priorValues.get(head);
       const priorInput = isResObj(existing) ? foldNestedSelfRefs(existing, childPrefix) : existing;
@@ -1996,6 +1994,21 @@ var StructureBuilder = class _StructureBuilder {
     }
     obj.fields.set(head, newVal);
   }
+  /** Builds the `key = ${?fullkey} [value]` field that `key += value` desugars
+   * to (S13b.2, HOCON.md L732). `childPrefix` is the field's fully-qualified
+   * path (pathPrefix + key), so a nested `srv { items += x }` references
+   * `${?srv.items}`; include relativization rewrites it under a mount prefix.
+   * `field.key` is already single-segment here (multi-segment keys are split
+   * into nested objects upstream). Returns a NEW AstField (append=false);
+   * positions inherit from the original field so resolve-time errors (the
+   * S13b.2 non-array check, now via the scalar+array concat) keep a location. */
+  desugarAppend(field, childPrefix) {
+    const segments = childPrefix.map((text) => ({ text, line: field.pos.line, col: field.pos.col }));
+    const subst = { kind: "subst", segments, optional: true, listSuffix: false, pos: field.pos };
+    const elemArray = { kind: "array", items: [field.value], pos: field.pos };
+    const synthetic = { kind: "concat", nodes: [subst, elemArray], pos: field.pos };
+    return { key: field.key, value: synthetic, append: false, pos: field.pos };
+  }
   astToResolverValue(ast, pathPrefix) {
     switch (ast.kind) {
       case "scalar": {
@@ -2060,11 +2073,6 @@ var StructureBuilder = class _StructureBuilder {
       }
       return;
     }
-    if (isAppend(val)) {
-      this.relativizeSubstPaths(val.existing, prefixSegments);
-      this.relativizeSubstPaths(val.elem, prefixSegments);
-      return;
-    }
     if (isResObj(val)) {
       this.relativizeResObj(val, prefixSegments);
       return;
@@ -2213,7 +2221,6 @@ var SubstitutionResolver = class {
         this.resolvingConcats.delete(v);
       }
     }
-    if (isAppend(v)) return this.resolveAppend(v, scope);
     if (isResObj(v)) return this.resolveResObj(v);
     const hv = v;
     if (hv.kind === "array") {
@@ -2498,38 +2505,6 @@ var SubstitutionResolver = class {
     }
     return folded;
   }
-  resolveAppend(a, scope) {
-    const existing = this.resolveVal(a.existing, scope) ?? { kind: "array", items: [] };
-    if (this.opts.allowUnresolved && (isSubst(existing) || isConcat(existing) || isAppend(existing))) {
-      return a;
-    }
-    const elem = this.resolveVal(a.elem, scope);
-    let priorItems;
-    if (existing.kind === "array") {
-      priorItems = existing.items;
-    } else if (existing.kind === "object") {
-      const converted = numericObjectToArray(existing);
-      if (converted === null) {
-        throw new ResolveError(
-          `'+=' on non-array value: prior value is object with non-numeric keys (spec L732)`,
-          "",
-          0,
-          0
-        );
-      }
-      priorItems = converted;
-    } else {
-      throw new ResolveError(
-        `'+=' on non-array value: prior value is ${existing.kind} (spec L732)`,
-        "",
-        0,
-        0
-      );
-    }
-    const items = [...priorItems];
-    if (elem !== void 0) items.push(elem);
-    return { kind: "array", items };
-  }
 };
 
 // src/internal/resolver/resolver.ts
@@ -2547,7 +2522,7 @@ function containsPlaceholders(tree) {
 }
 function valContainsPlaceholders(v) {
   const rv = v;
-  if (isSubst(rv) || isConcat(rv) || isAppend(rv)) return true;
+  if (isSubst(rv) || isConcat(rv)) return true;
   if (isResObj(rv)) return containsPlaceholders(rv);
   const hv = v;
   if (hv?.kind === "array") {
@@ -2558,7 +2533,7 @@ function valContainsPlaceholders(v) {
 function buildPartialHoconFromResObj(tree) {
   const fields = /* @__PURE__ */ new Map();
   for (const [k, v] of tree.fields) {
-    if (!isSubst(v) && !isConcat(v) && !isAppend(v)) {
+    if (!isSubst(v) && !isConcat(v)) {
       if (isResObj(v)) {
         fields.set(k, buildPartialHoconFromResObj(v));
       } else {
@@ -2951,7 +2926,7 @@ function hoconToJs(v) {
 function resObjToKeyShape(tree) {
   const fields = /* @__PURE__ */ new Map();
   for (const [k, v] of tree.fields) {
-    if (isSubst(v) || isConcat(v) || isAppend(v)) {
+    if (isSubst(v) || isConcat(v)) {
       fields.set(k, { kind: "scalar", raw: "", valueType: "null" });
     } else if (isResObj(v)) {
       fields.set(k, resObjToKeyShape(v));
@@ -2965,7 +2940,7 @@ function stripPlaceholderFields(v) {
   const fields = /* @__PURE__ */ new Map();
   let hadPlaceholders = false;
   for (const [k, val] of v.fields) {
-    if (val._kind === "subst-placeholder" || val._kind === "concat-placeholder" || val._kind === "append-placeholder") {
+    if (val._kind === "subst-placeholder" || val._kind === "concat-placeholder") {
       hadPlaceholders = true;
     } else if (val.kind === "object") {
       const inner = stripPlaceholderFields(val);

package/dist/index.d.cts

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

package/dist/index.d.ts

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