@o3co/ts.hocon 1.9.0 → 1.10.0

package/dist/adapters/jsonc.d.cts

@@ -0,0 +1,25 @@
+import { C as Config } from '../config-PdhVgeLS.cjs';
+
+/**
+ * Read JSON with comments and trailing commas — the dialect VS Code and
+ * TypeScript use for their config files — as HOCON config.
+ *
+ * Plain JSON needs no adapter at all: HOCON is a JSON superset, so `parse`
+ * already accepts a .json file. This exists for the two things HOCON does not
+ * accept, block comments and trailing commas. (HOCON has `//` and `#` comments
+ * of its own.)
+ *
+ * Comments and trailing commas are removed and `JSON.parse` does the rest, so
+ * the accepted grammar is otherwise exactly the platform's JSON.
+ *
+ * See docs/specs/format-ingestion-mapping.md items F3.x in the hocon scope.
+ */
+declare function parseJsonc(input: string, originDescription?: string): Config;
+/**
+ * Remove `//` line comments and block comments, leaving string literals alone.
+ * Newlines inside removed spans are kept so JSON.parse still reports useful
+ * positions.
+ */
+declare function stripComments(src: string): string;
+
+export { parseJsonc, stripComments };

package/dist/adapters/jsonc.d.ts

@@ -0,0 +1,25 @@
+import { C as Config } from '../config-PdhVgeLS.js';
+
+/**
+ * Read JSON with comments and trailing commas — the dialect VS Code and
+ * TypeScript use for their config files — as HOCON config.
+ *
+ * Plain JSON needs no adapter at all: HOCON is a JSON superset, so `parse`
+ * already accepts a .json file. This exists for the two things HOCON does not
+ * accept, block comments and trailing commas. (HOCON has `//` and `#` comments
+ * of its own.)
+ *
+ * Comments and trailing commas are removed and `JSON.parse` does the rest, so
+ * the accepted grammar is otherwise exactly the platform's JSON.
+ *
+ * See docs/specs/format-ingestion-mapping.md items F3.x in the hocon scope.
+ */
+declare function parseJsonc(input: string, originDescription?: string): Config;
+/**
+ * Remove `//` line comments and block comments, leaving string literals alone.
+ * Newlines inside removed spans are kept so JSON.parse still reports useful
+ * positions.
+ */
+declare function stripComments(src: string): string;
+
+export { parseJsonc, stripComments };