@o3co/ts.hocon 1.12.0 → 1.13.0

package/README.ja.md

@@ -80,6 +80,7 @@ HOCON は単なるシリアライズ形式ではなく、**プログラムに注
 - `+=` 追加演算子
 - `include "file.conf"` および `include file("file.conf")` ディレクティブ
 - トリプルクォート文字列（`"""..."""`）
+- HOCON エミッタ（`renderHocon()`）— 解決済み `Config` を HOCON テキストとして出力。再パースすると同一の値ツリーになる（E18 ラウンドトリップ契約）
 - 同期・非同期 API（`parse` / `parseAsync` / `parseFile` / `parseFileAsync`）
 - ESM + CJS デュアルパッケージ（全エントリポイントを CI で両形式ロード検証）
 - [Zod](https://zod.dev/) スキーマバリデーション統合（オプション）
@@ -121,6 +122,7 @@ parseFileAsync(path: string, opts?: ParseOptions): Promise<Config>
 | `keys()` | `string[]` | — |
 | `withFallback(fallback)` | `Config` | — |
 | `toObject()` | `unknown` | — |
+| `renderHocon()` | `string` | 未解決の場合 |
 
 ### Zod 統合
 
@@ -193,18 +195,17 @@ description = """
 
 ## 仕様準拠
 
-[Lightbend HOCON 仕様](https://github.com/lightbend/config/blob/main/HOCON.md) への準拠状況は [`docs/spec-compliance.md`](docs/spec-compliance.md) に項目単位で記載しています。以下の表は 2026-05-13 時点のスナップショットです — 最新値は [`xx.hocon/docs/compliance-matrix.md`](https://github.com/o3co/xx.hocon/blob/main/docs/compliance-matrix.md) を参照してください。
+[Lightbend HOCON 仕様](https://github.com/lightbend/config/blob/main/HOCON.md) への準拠状況は [`docs/spec-compliance.md`](docs/spec-compliance.md) に項目単位で記載しており、以下の表はそこから計算されます — `tests/docs.test.ts` が再計算し、表がずれるとビルドが fail します。実装横断のロールアップは [`xx.hocon/docs/compliance-matrix.md`](https://github.com/o3co/xx.hocon/blob/main/docs/compliance-matrix.md) を参照してください。
 
 | 指標                                   | 状況          |
 | -------------------------------------- | ------------- |
-| 仕様全体（out-of-scope を含む）        | **74.2%**     |
-| In-scope のみ                          | **83.3%**     |
+| 仕様全体（out-of-scope を含む）        | **90.0%**     |
+| In-scope のみ                          | **100.0%**    |
 | Lightbend `test01`–`test13` テスト群   | 13/13 合格    |
 
-v0.1.0 で未対応の機能:
+未対応の機能:
 - `include url(...)`
 - `include classpath(...)`
-- `.properties` ファイルのパース
 
 ## パフォーマンス
 
@@ -350,6 +351,7 @@ const merged = cfg.withFallback(base).resolve()
 | `@o3co/ts.hocon/adapters/properties` | — | `java.util.Properties`。`include` と構文レイヤーを共有 |
 | `@o3co/ts.hocon/adapters/env` | — | プレフィックス付き名前空間の一括マウント。`.env` の読み込みも可能 |
 | `@o3co/ts.hocon/adapters/jsonc` | — | コメントと末尾カンマを許す JSON |
+| `@o3co/ts.hocon/adapters/json5` | — | JSON5 1.0.0。手書き scanner で依存ゼロ |
 | `@o3co/ts.hocon/adapters/toml` | `smol-toml` | オプショナルなピア依存 |
 | `@o3co/ts.hocon/adapters/yaml` | `yaml` 2.9.x | オプショナルなピア依存。スカラー解決はそのライブラリの答えで、`version: '1.2'` を明示してドリフトを防止 |
 

package/README.md

@@ -86,6 +86,7 @@ On top of that, HOCON combines the readability of YAML with the structure of JSO
 - `include "file.conf"` and `include file("file.conf")` directives
 - Triple-quoted strings (`"""..."""`)
 - Duration and byte size parsing (`getDuration()`, `getBytes()`)
+- HOCON emitter (`renderHocon()`) — renders a resolved `Config` back to HOCON text; re-parsing yields the same value tree (E18 round-trip contract)
 - Sync and async API (`parse` / `parseAsync` / `parseFile` / `parseFileAsync`)
 - ESM + CJS dual package (every entrypoint smoke-tested in both formats on each CI run)
 - Optional [Zod](https://zod.dev/) integration for schema validation
@@ -134,6 +135,7 @@ parseFileAsync(path: string, opts?: ParseOptions): Promise<Config>
 | `resolveWith(source, opts?)` | `Config` | source unresolved, or unresolvable substitution |
 | `isResolved()` | `boolean` | — |
 | `toObject()` | `unknown` | — |
+| `renderHocon()` | `string` | unresolved |
 
 ### Deferred resolution API (E12)
 
@@ -269,8 +271,8 @@ Conformance against the [Lightbend HOCON specification](https://github.com/light
 
 | Metric                                | Status        |
 | ------------------------------------- | ------------- |
-| Spec total (incl. out-of-scope)       | **89.3%**     |
-| In-scope only                         | **99.2%**     |
+| Spec total (incl. out-of-scope)       | **90.0%**     |
+| In-scope only                         | **100.0%**    |
 | Lightbend `test01`–`test13` suite     | 13/13 passing |
 
 **Extra-spec conventions (E-series) — implementation status:**
@@ -435,6 +437,7 @@ Deferring resolution matters: the plain `parse` resolves as it goes, so a
 | `@o3co/ts.hocon/adapters/properties` | — | `java.util.Properties`, sharing the `include` syntax layer |
 | `@o3co/ts.hocon/adapters/env` | — | Bulk-mounts a prefixed namespace; also reads `.env` |
 | `@o3co/ts.hocon/adapters/jsonc` | — | JSON with comments and trailing commas |
+| `@o3co/ts.hocon/adapters/json5` | — | JSON5 1.0.0, hand-rolled scanner, zero dependencies |
 | `@o3co/ts.hocon/adapters/toml` | `smol-toml` | Optional peer dependency |
 | `@o3co/ts.hocon/adapters/yaml` | `yaml` 2.9.x | Optional peer dependency; scalar resolution is that library's answer, with `version: '1.2'` declared so it cannot drift |
 
@@ -458,11 +461,12 @@ cfg.getString('"foo.bar"')   // "dotted"  — one key whose name contains a dot
 cfg.getString('foo.bar')     // "nested"  — foo -> bar
 ```
 
-### Numbers from JSONC and YAML
+### Numbers from JSONC, JSON5 and YAML
 
 Integers are ingested losslessly: an integer literal too wide for a JS `number`
 keeps its digits instead of being rounded, and one outside the int64 range is
-refused rather than silently mangled. What you get back depends on the getter:
+refused rather than silently mangled (JSON5's hex integers included). What you
+get back depends on the getter:
 
 ```ts
 const cfg = parseJsonc('{"id": 9007199254740993}')