@o3co/ts.hocon 1.11.0 → 1.13.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -363,6 +363,28 @@ declare class Config {
363
363
  toObject(opts?: {
364
364
  nullPrototype?: boolean;
365
365
  }): unknown;
366
+ /**
367
+ * Renders this resolved Config as HOCON text (E18; lockstep with go.hocon's
368
+ * `Config.RenderHOCON`, v1.11.0).
369
+ *
370
+ * The output round-trips: parsing it back yields the same value tree. That
371
+ * is the correctness contract, not byte-for-byte formatting — a scalar is
372
+ * quoted whenever leaving it bare would re-parse as a different type (a
373
+ * string `"8080"` becomes `"8080"`, not `8080`), and left bare only when it
374
+ * provably cannot.
375
+ *
376
+ * The Config must be resolved and hold only data (objects, arrays, string /
377
+ * number / boolean / null scalars) — exactly what {@link fromMap} and the
378
+ * format adapters produce. An unresolved placeholder throws
379
+ * {@link ConfigError}; substitutions have no textual round trip through a
380
+ * value tree.
381
+ *
382
+ * The root object's fields are emitted without enclosing braces, nested
383
+ * objects as `key { … }`, arrays as newline-separated `[ … ]`, indented two
384
+ * spaces. Source comments are not represented — a value tree does not carry
385
+ * them.
386
+ */
387
+ renderHocon(): string;
366
388
  /**
367
389
  * @internal Test-only: renders this resolved Config's value tree as canonical
368
390
  * JSON (sorted keys, no whitespace). Used by Layer-2 fixture tests to compare
@@ -363,6 +363,28 @@ declare class Config {
363
363
  toObject(opts?: {
364
364
  nullPrototype?: boolean;
365
365
  }): unknown;
366
+ /**
367
+ * Renders this resolved Config as HOCON text (E18; lockstep with go.hocon's
368
+ * `Config.RenderHOCON`, v1.11.0).
369
+ *
370
+ * The output round-trips: parsing it back yields the same value tree. That
371
+ * is the correctness contract, not byte-for-byte formatting — a scalar is
372
+ * quoted whenever leaving it bare would re-parse as a different type (a
373
+ * string `"8080"` becomes `"8080"`, not `8080`), and left bare only when it
374
+ * provably cannot.
375
+ *
376
+ * The Config must be resolved and hold only data (objects, arrays, string /
377
+ * number / boolean / null scalars) — exactly what {@link fromMap} and the
378
+ * format adapters produce. An unresolved placeholder throws
379
+ * {@link ConfigError}; substitutions have no textual round trip through a
380
+ * value tree.
381
+ *
382
+ * The root object's fields are emitted without enclosing braces, nested
383
+ * objects as `key { … }`, arrays as newline-separated `[ … ]`, indented two
384
+ * spaces. Source comments are not represented — a value tree does not carry
385
+ * them.
386
+ */
387
+ renderHocon(): string;
366
388
  /**
367
389
  * @internal Test-only: renders this resolved Config's value tree as canonical
368
390
  * JSON (sorted keys, no whitespace). Used by Layer-2 fixture tests to compare