@proseql/core 0.1.0

package/dist/serializers/codecs/hjson.d.ts

@@ -0,0 +1,33 @@
+import type { FormatCodec } from "../format-codec.js";
+/**
+ * Options for the Hjson codec.
+ */
+export interface HjsonCodecOptions {
+    readonly indent?: number;
+}
+/**
+ * Creates an Hjson (Human JSON) codec with configurable indentation.
+ *
+ * Hjson is a JSON superset designed for human editing. It allows:
+ * - Comments: `//`, block comments, and `#` hash comments
+ * - Unquoted keys and string values
+ * - Trailing commas
+ * - Multiline strings with `'''`
+ *
+ * On decode: comments are stripped during parsing.
+ * On encode: outputs human-friendly Hjson format (not standard JSON).
+ *
+ * @param options - Optional configuration for Hjson serialization
+ * @param options.indent - Number of spaces for indentation (default: 2)
+ * @returns A FormatCodec for Hjson serialization
+ *
+ * @example
+ * ```typescript
+ * const codec = hjsonCodec({ indent: 4 })
+ * const layer = makeSerializerLayer([codec])
+ * ```
+ *
+ * @see https://hjson.github.io for format specification
+ */
+export declare const hjsonCodec: (options?: HjsonCodecOptions) => FormatCodec;
+//# sourceMappingURL=hjson.d.ts.map

package/dist/serializers/codecs/hjson.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hjson.d.ts","sourceRoot":"","sources":["../../../src/serializers/codecs/hjson.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAiB,MAAM,oBAAoB,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,UAAU,GAAI,UAAU,iBAAiB,KAAG,WAcxD,CAAC"}

package/dist/serializers/codecs/hjson.js

@@ -0,0 +1,40 @@
+import { parse, stringify } from "hjson";
+/**
+ * Creates an Hjson (Human JSON) codec with configurable indentation.
+ *
+ * Hjson is a JSON superset designed for human editing. It allows:
+ * - Comments: `//`, block comments, and `#` hash comments
+ * - Unquoted keys and string values
+ * - Trailing commas
+ * - Multiline strings with `'''`
+ *
+ * On decode: comments are stripped during parsing.
+ * On encode: outputs human-friendly Hjson format (not standard JSON).
+ *
+ * @param options - Optional configuration for Hjson serialization
+ * @param options.indent - Number of spaces for indentation (default: 2)
+ * @returns A FormatCodec for Hjson serialization
+ *
+ * @example
+ * ```typescript
+ * const codec = hjsonCodec({ indent: 4 })
+ * const layer = makeSerializerLayer([codec])
+ * ```
+ *
+ * @see https://hjson.github.io for format specification
+ */
+export const hjsonCodec = (options) => {
+    const indent = options?.indent ?? 2;
+    return {
+        name: "hjson",
+        extensions: ["hjson"],
+        encode: (data, formatOptions) => {
+            const actualIndent = formatOptions?.indent ?? indent;
+            return stringify(data, { space: actualIndent });
+        },
+        decode: (raw) => {
+            return parse(raw);
+        },
+    };
+};
+//# sourceMappingURL=hjson.js.map

package/dist/serializers/codecs/hjson.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hjson.js","sourceRoot":"","sources":["../../../src/serializers/codecs/hjson.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAUzC;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,OAA2B,EAAe,EAAE;IACtE,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,CAAC,CAAC;IAEpC,OAAO;QACN,IAAI,EAAE,OAAO;QACb,UAAU,EAAE,CAAC,OAAO,CAAC;QACrB,MAAM,EAAE,CAAC,IAAa,EAAE,aAA6B,EAAU,EAAE;YAChE,MAAM,YAAY,GAAG,aAAa,EAAE,MAAM,IAAI,MAAM,CAAC;YACrD,OAAO,SAAS,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;QACjD,CAAC;QACD,MAAM,EAAE,CAAC,GAAW,EAAW,EAAE;YAChC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;KACD,CAAC;AACH,CAAC,CAAC"}

package/dist/serializers/codecs/json.d.ts

@@ -0,0 +1,22 @@
+import type { FormatCodec } from "../format-codec.js";
+/**
+ * Options for the JSON codec.
+ */
+export interface JsonCodecOptions {
+    readonly indent?: number;
+}
+/**
+ * Creates a JSON codec with configurable indentation.
+ *
+ * @param options - Optional configuration for JSON serialization
+ * @param options.indent - Number of spaces for indentation (default: 2)
+ * @returns A FormatCodec for JSON serialization
+ *
+ * @example
+ * ```typescript
+ * const codec = jsonCodec({ indent: 4 })
+ * const layer = makeSerializerLayer([codec])
+ * ```
+ */
+export declare const jsonCodec: (options?: JsonCodecOptions) => FormatCodec;
+//# sourceMappingURL=json.d.ts.map

package/dist/serializers/codecs/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../../src/serializers/codecs/json.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAiB,MAAM,oBAAoB,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,SAAS,GAAI,UAAU,gBAAgB,KAAG,WActD,CAAC"}

package/dist/serializers/codecs/json.js

@@ -0,0 +1,28 @@
+/**
+ * Creates a JSON codec with configurable indentation.
+ *
+ * @param options - Optional configuration for JSON serialization
+ * @param options.indent - Number of spaces for indentation (default: 2)
+ * @returns A FormatCodec for JSON serialization
+ *
+ * @example
+ * ```typescript
+ * const codec = jsonCodec({ indent: 4 })
+ * const layer = makeSerializerLayer([codec])
+ * ```
+ */
+export const jsonCodec = (options) => {
+    const indent = options?.indent ?? 2;
+    return {
+        name: "json",
+        extensions: ["json"],
+        encode: (data, formatOptions) => {
+            const actualIndent = formatOptions?.indent ?? indent;
+            return JSON.stringify(data, null, actualIndent);
+        },
+        decode: (raw) => {
+            return JSON.parse(raw);
+        },
+    };
+};
+//# sourceMappingURL=json.js.map

package/dist/serializers/codecs/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../../src/serializers/codecs/json.ts"],"names":[],"mappings":"AASA;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,OAA0B,EAAe,EAAE;IACpE,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,CAAC,CAAC;IAEpC,OAAO;QACN,IAAI,EAAE,MAAM;QACZ,UAAU,EAAE,CAAC,MAAM,CAAC;QACpB,MAAM,EAAE,CAAC,IAAa,EAAE,aAA6B,EAAU,EAAE;YAChE,MAAM,YAAY,GAAG,aAAa,EAAE,MAAM,IAAI,MAAM,CAAC;YACrD,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;QACjD,CAAC;QACD,MAAM,EAAE,CAAC,GAAW,EAAW,EAAE;YAChC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACxB,CAAC;KACD,CAAC;AACH,CAAC,CAAC"}

package/dist/serializers/codecs/json5.d.ts

@@ -0,0 +1,26 @@
+import type { FormatCodec } from "../format-codec.js";
+/**
+ * Options for the JSON5 codec.
+ */
+export interface Json5CodecOptions {
+    readonly indent?: number;
+}
+/**
+ * Creates a JSON5 codec with configurable indentation.
+ *
+ * JSON5 is a superset of JSON that allows comments, trailing commas,
+ * unquoted keys, and other human-friendly syntax on read. On write,
+ * output is formatted JSON5.
+ *
+ * @param options - Optional configuration for JSON5 serialization
+ * @param options.indent - Number of spaces for indentation (default: 2)
+ * @returns A FormatCodec for JSON5 serialization
+ *
+ * @example
+ * ```typescript
+ * const codec = json5Codec({ indent: 4 })
+ * const layer = makeSerializerLayer([codec])
+ * ```
+ */
+export declare const json5Codec: (options?: Json5CodecOptions) => FormatCodec;
+//# sourceMappingURL=json5.d.ts.map

package/dist/serializers/codecs/json5.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json5.d.ts","sourceRoot":"","sources":["../../../src/serializers/codecs/json5.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAiB,MAAM,oBAAoB,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,UAAU,GAAI,UAAU,iBAAiB,KAAG,WAcxD,CAAC"}

package/dist/serializers/codecs/json5.js

@@ -0,0 +1,33 @@
+import { parse, stringify } from "json5";
+/**
+ * Creates a JSON5 codec with configurable indentation.
+ *
+ * JSON5 is a superset of JSON that allows comments, trailing commas,
+ * unquoted keys, and other human-friendly syntax on read. On write,
+ * output is formatted JSON5.
+ *
+ * @param options - Optional configuration for JSON5 serialization
+ * @param options.indent - Number of spaces for indentation (default: 2)
+ * @returns A FormatCodec for JSON5 serialization
+ *
+ * @example
+ * ```typescript
+ * const codec = json5Codec({ indent: 4 })
+ * const layer = makeSerializerLayer([codec])
+ * ```
+ */
+export const json5Codec = (options) => {
+    const indent = options?.indent ?? 2;
+    return {
+        name: "json5",
+        extensions: ["json5"],
+        encode: (data, formatOptions) => {
+            const actualIndent = formatOptions?.indent ?? indent;
+            return stringify(data, null, actualIndent);
+        },
+        decode: (raw) => {
+            return parse(raw);
+        },
+    };
+};
+//# sourceMappingURL=json5.js.map

package/dist/serializers/codecs/json5.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json5.js","sourceRoot":"","sources":["../../../src/serializers/codecs/json5.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAUzC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,OAA2B,EAAe,EAAE;IACtE,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,CAAC,CAAC;IAEpC,OAAO;QACN,IAAI,EAAE,OAAO;QACb,UAAU,EAAE,CAAC,OAAO,CAAC;QACrB,MAAM,EAAE,CAAC,IAAa,EAAE,aAA6B,EAAU,EAAE;YAChE,MAAM,YAAY,GAAG,aAAa,EAAE,MAAM,IAAI,MAAM,CAAC;YACrD,OAAO,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;QAC5C,CAAC;QACD,MAAM,EAAE,CAAC,GAAW,EAAW,EAAE;YAChC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;KACD,CAAC;AACH,CAAC,CAAC"}

package/dist/serializers/codecs/jsonc.d.ts

@@ -0,0 +1,29 @@
+import type { FormatCodec } from "../format-codec.js";
+/**
+ * Options for the JSONC codec.
+ */
+export interface JsoncCodecOptions {
+    readonly indent?: number;
+}
+/**
+ * Creates a JSONC (JSON with Comments) codec with configurable indentation.
+ *
+ * JSONC is a superset of JSON that allows line comments (//) and block
+ * comments. On read, comments are stripped using jsonc-parser. On write,
+ * standard JSON is output (comments are not preserved).
+ *
+ * This is the same behavior as VS Code's settings.json — comments in
+ * hand-edited .jsonc files do not survive a save cycle.
+ *
+ * @param options - Optional configuration for JSONC serialization
+ * @param options.indent - Number of spaces for indentation (default: 2)
+ * @returns A FormatCodec for JSONC serialization
+ *
+ * @example
+ * ```typescript
+ * const codec = jsoncCodec({ indent: 4 })
+ * const layer = makeSerializerLayer([codec])
+ * ```
+ */
+export declare const jsoncCodec: (options?: JsoncCodecOptions) => FormatCodec;
+//# sourceMappingURL=jsonc.d.ts.map

package/dist/serializers/codecs/jsonc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonc.d.ts","sourceRoot":"","sources":["../../../src/serializers/codecs/jsonc.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAiB,MAAM,oBAAoB,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,UAAU,GAAI,UAAU,iBAAiB,KAAG,WAgBxD,CAAC"}

package/dist/serializers/codecs/jsonc.js

@@ -0,0 +1,38 @@
+import { parse } from "jsonc-parser";
+/**
+ * Creates a JSONC (JSON with Comments) codec with configurable indentation.
+ *
+ * JSONC is a superset of JSON that allows line comments (//) and block
+ * comments. On read, comments are stripped using jsonc-parser. On write,
+ * standard JSON is output (comments are not preserved).
+ *
+ * This is the same behavior as VS Code's settings.json — comments in
+ * hand-edited .jsonc files do not survive a save cycle.
+ *
+ * @param options - Optional configuration for JSONC serialization
+ * @param options.indent - Number of spaces for indentation (default: 2)
+ * @returns A FormatCodec for JSONC serialization
+ *
+ * @example
+ * ```typescript
+ * const codec = jsoncCodec({ indent: 4 })
+ * const layer = makeSerializerLayer([codec])
+ * ```
+ */
+export const jsoncCodec = (options) => {
+    const indent = options?.indent ?? 2;
+    return {
+        name: "jsonc",
+        extensions: ["jsonc"],
+        encode: (data, formatOptions) => {
+            const actualIndent = formatOptions?.indent ?? indent;
+            return JSON.stringify(data, null, actualIndent);
+        },
+        decode: (raw) => {
+            // jsonc-parser's parse function handles comments and trailing commas
+            // It returns the parsed JavaScript value, stripping comments automatically
+            return parse(raw);
+        },
+    };
+};
+//# sourceMappingURL=jsonc.js.map

package/dist/serializers/codecs/jsonc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonc.js","sourceRoot":"","sources":["../../../src/serializers/codecs/jsonc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAUrC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,OAA2B,EAAe,EAAE;IACtE,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,CAAC,CAAC;IAEpC,OAAO;QACN,IAAI,EAAE,OAAO;QACb,UAAU,EAAE,CAAC,OAAO,CAAC;QACrB,MAAM,EAAE,CAAC,IAAa,EAAE,aAA6B,EAAU,EAAE;YAChE,MAAM,YAAY,GAAG,aAAa,EAAE,MAAM,IAAI,MAAM,CAAC;YACrD,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;QACjD,CAAC;QACD,MAAM,EAAE,CAAC,GAAW,EAAW,EAAE;YAChC,qEAAqE;YACrE,2EAA2E;YAC3E,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;KACD,CAAC;AACH,CAAC,CAAC"}

package/dist/serializers/codecs/jsonl.d.ts

@@ -0,0 +1,17 @@
+import type { FormatCodec } from "../format-codec.js";
+/**
+ * Creates a JSONL (JSON Lines / Newline Delimited JSON) codec.
+ *
+ * Each element of the array is serialized as a single JSON line.
+ * On decode, each non-empty line is parsed as a JSON value.
+ *
+ * @returns A FormatCodec for JSONL serialization
+ *
+ * @example
+ * ```typescript
+ * const codec = jsonlCodec()
+ * const layer = makeSerializerLayer([codec])
+ * ```
+ */
+export declare const jsonlCodec: () => FormatCodec;
+//# sourceMappingURL=jsonl.d.ts.map

package/dist/serializers/codecs/jsonl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonl.d.ts","sourceRoot":"","sources":["../../../src/serializers/codecs/jsonl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,UAAU,QAAO,WAe7B,CAAC"}

package/dist/serializers/codecs/jsonl.js

@@ -0,0 +1,31 @@
+/**
+ * Creates a JSONL (JSON Lines / Newline Delimited JSON) codec.
+ *
+ * Each element of the array is serialized as a single JSON line.
+ * On decode, each non-empty line is parsed as a JSON value.
+ *
+ * @returns A FormatCodec for JSONL serialization
+ *
+ * @example
+ * ```typescript
+ * const codec = jsonlCodec()
+ * const layer = makeSerializerLayer([codec])
+ * ```
+ */
+export const jsonlCodec = () => {
+    return {
+        name: "jsonl",
+        extensions: ["jsonl", "ndjson"],
+        encode: (data) => {
+            if (!Array.isArray(data)) {
+                return JSON.stringify(data);
+            }
+            return data.map((item) => JSON.stringify(item)).join("\n");
+        },
+        decode: (raw) => {
+            const lines = raw.split("\n").filter((line) => line.trim() !== "");
+            return lines.map((line) => JSON.parse(line));
+        },
+    };
+};
+//# sourceMappingURL=jsonl.js.map

package/dist/serializers/codecs/jsonl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonl.js","sourceRoot":"","sources":["../../../src/serializers/codecs/jsonl.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,GAAgB,EAAE;IAC3C,OAAO;QACN,IAAI,EAAE,OAAO;QACb,UAAU,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC;QAC/B,MAAM,EAAE,CAAC,IAAa,EAAU,EAAE;YACjC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC1B,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAC7B,CAAC;YACD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5D,CAAC;QACD,MAAM,EAAE,CAAC,GAAW,EAAW,EAAE;YAChC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YACnE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9C,CAAC;KACD,CAAC;AACH,CAAC,CAAC"}