@hardlydifficult/text 1.0.4 → 1.0.5

package/README.md

@@ -99,3 +99,25 @@ formatDuration(3_600_000); // "1h"
 formatDuration(500);       // "<1s"
 formatDuration(90_000_000); // "1d 1h"
 ```
+
+### `convertFormat(content: string, to: TextFormat): string`
+
+Convert between JSON and YAML string formats. Auto-detects the input format and serializes to the requested output format.
+
+```typescript
+import { convertFormat } from "@hardlydifficult/text";
+
+// JSON to YAML
+convertFormat('{"name": "Alice", "age": 30}', "yaml");
+// name: Alice
+// age: 30
+
+// YAML to JSON
+convertFormat("name: Alice\nage: 30", "json");
+// {
+//   "name": "Alice",
+//   "age": 30
+// }
+```
+
+The function tries to parse as JSON first, then falls back to YAML. Returns pretty-printed JSON with 2-space indent or clean YAML. Throws a descriptive error if the input is neither valid JSON nor YAML.

package/dist/convertFormat.d.ts

@@ -0,0 +1,25 @@
+export type TextFormat = "json" | "yaml";
+/**
+ * Convert between JSON and YAML string formats.
+ *
+ * Auto-detects the input format by trying JSON.parse first, then
+ * falling back to YAML parsing. Returns pretty-printed JSON (2-space indent)
+ * or clean YAML based on the `to` parameter.
+ *
+ * @example
+ * ```typescript
+ * // JSON to YAML
+ * convertFormat('{"name": "Alice", "age": 30}', "yaml")
+ * // name: Alice
+ * // age: 30
+ *
+ * // YAML to JSON
+ * convertFormat("name: Alice\nage: 30", "json")
+ * // {
+ * //   "name": "Alice",
+ * //   "age": 30
+ * // }
+ * ```
+ */
+export declare function convertFormat(content: string, to: TextFormat): string;
+//# sourceMappingURL=convertFormat.d.ts.map

package/dist/convertFormat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convertFormat.d.ts","sourceRoot":"","sources":["../src/convertFormat.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;AAsBzC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,GAAG,MAAM,CAOrE"}

package/dist/convertFormat.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convertFormat = convertFormat;
+const yaml_1 = require("yaml");
+/**
+ * Parse content as JSON or YAML, throwing a descriptive error if both fail.
+ */
+function parseContent(content) {
+    // Try JSON first
+    try {
+        return JSON.parse(content);
+    }
+    catch (jsonError) {
+        // Fall back to YAML
+        try {
+            return (0, yaml_1.parse)(content);
+        }
+        catch (yamlError) {
+            throw new Error(`Input is neither valid JSON nor YAML.\nJSON error: ${jsonError instanceof Error ? jsonError.message : String(jsonError)}\nYAML error: ${yamlError instanceof Error ? yamlError.message : String(yamlError)}`, { cause: yamlError });
+        }
+    }
+}
+/**
+ * Convert between JSON and YAML string formats.
+ *
+ * Auto-detects the input format by trying JSON.parse first, then
+ * falling back to YAML parsing. Returns pretty-printed JSON (2-space indent)
+ * or clean YAML based on the `to` parameter.
+ *
+ * @example
+ * ```typescript
+ * // JSON to YAML
+ * convertFormat('{"name": "Alice", "age": 30}', "yaml")
+ * // name: Alice
+ * // age: 30
+ *
+ * // YAML to JSON
+ * convertFormat("name: Alice\nage: 30", "json")
+ * // {
+ * //   "name": "Alice",
+ * //   "age": 30
+ * // }
+ * ```
+ */
+function convertFormat(content, to) {
+    const data = parseContent(content);
+    if (to === "json") {
+        return JSON.stringify(data, null, 2);
+    }
+    return (0, yaml_1.stringify)(data);
+}
+//# sourceMappingURL=convertFormat.js.map

package/dist/convertFormat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convertFormat.js","sourceRoot":"","sources":["../src/convertFormat.ts"],"names":[],"mappings":";;AA8CA,sCAOC;AArDD,+BAAsE;AAItE;;GAEG;AACH,SAAS,YAAY,CAAC,OAAe;IACnC,iBAAiB;IACjB,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,SAAS,EAAE,CAAC;QACnB,oBAAoB;QACpB,IAAI,CAAC;YACH,OAAO,IAAA,YAAS,EAAC,OAAO,CAAC,CAAC;QAC5B,CAAC;QAAC,OAAO,SAAS,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CACb,sDAAsD,SAAS,YAAY,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,iBAAiB,SAAS,YAAY,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,EAC7M,EAAE,KAAK,EAAE,SAAS,EAAE,CACrB,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,SAAgB,aAAa,CAAC,OAAe,EAAE,EAAc;IAC3D,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IAEnC,IAAI,EAAE,KAAK,MAAM,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,IAAA,gBAAa,EAAC,IAAI,CAAC,CAAC;AAC7B,CAAC"}

package/dist/index.d.ts

@@ -5,4 +5,6 @@ export { slugify } from "./slugify.js";
 export { formatDuration } from "./formatDuration.js";
 export { buildFileTree, FILE_TREE_DEFAULTS } from "./buildFileTree.js";
 export type { BuildTreeOptions } from "./buildFileTree.js";
+export { convertFormat } from "./convertFormat.js";
+export type { TextFormat } from "./convertFormat.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACvE,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACvE,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FILE_TREE_DEFAULTS = exports.buildFileTree = exports.formatDuration = exports.slugify = exports.chunkText = exports.extractPlaceholders = exports.replaceTemplate = exports.formatErrorForLog = exports.formatError = exports.getErrorMessage = void 0;
+exports.convertFormat = exports.FILE_TREE_DEFAULTS = exports.buildFileTree = exports.formatDuration = exports.slugify = exports.chunkText = exports.extractPlaceholders = exports.replaceTemplate = exports.formatErrorForLog = exports.formatError = exports.getErrorMessage = void 0;
 var errors_js_1 = require("./errors.js");
 Object.defineProperty(exports, "getErrorMessage", { enumerable: true, get: function () { return errors_js_1.getErrorMessage; } });
 Object.defineProperty(exports, "formatError", { enumerable: true, get: function () { return errors_js_1.formatError; } });
@@ -17,4 +17,6 @@ Object.defineProperty(exports, "formatDuration", { enumerable: true, get: functi
 var buildFileTree_js_1 = require("./buildFileTree.js");
 Object.defineProperty(exports, "buildFileTree", { enumerable: true, get: function () { return buildFileTree_js_1.buildFileTree; } });
 Object.defineProperty(exports, "FILE_TREE_DEFAULTS", { enumerable: true, get: function () { return buildFileTree_js_1.FILE_TREE_DEFAULTS; } });
+var convertFormat_js_1 = require("./convertFormat.js");
+Object.defineProperty(exports, "convertFormat", { enumerable: true, get: function () { return convertFormat_js_1.convertFormat; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,yCAA8E;AAArE,4GAAA,eAAe,OAAA;AAAE,wGAAA,WAAW,OAAA;AAAE,8GAAA,iBAAiB,OAAA;AACxD,6CAAqE;AAA5D,8GAAA,eAAe,OAAA;AAAE,kHAAA,mBAAmB,OAAA;AAC7C,+CAA2C;AAAlC,yGAAA,SAAS,OAAA;AAClB,2CAAuC;AAA9B,qGAAA,OAAO,OAAA;AAChB,yDAAqD;AAA5C,mHAAA,cAAc,OAAA;AACvB,uDAAuE;AAA9D,iHAAA,aAAa,OAAA;AAAE,sHAAA,kBAAkB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,yCAA8E;AAArE,4GAAA,eAAe,OAAA;AAAE,wGAAA,WAAW,OAAA;AAAE,8GAAA,iBAAiB,OAAA;AACxD,6CAAqE;AAA5D,8GAAA,eAAe,OAAA;AAAE,kHAAA,mBAAmB,OAAA;AAC7C,+CAA2C;AAAlC,yGAAA,SAAS,OAAA;AAClB,2CAAuC;AAA9B,qGAAA,OAAO,OAAA;AAChB,yDAAqD;AAA5C,mHAAA,cAAc,OAAA;AACvB,uDAAuE;AAA9D,iHAAA,aAAa,OAAA;AAAE,sHAAA,kBAAkB,OAAA;AAE1C,uDAAmD;AAA1C,iHAAA,aAAa,OAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hardlydifficult/text",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
@@ -14,6 +14,9 @@
     "lint": "tsc --noEmit",
     "clean": "rm -rf dist"
   },
+  "dependencies": {
+    "yaml": "2.8.2"
+  },
   "devDependencies": {
     "@types/node": "25.2.3",
     "typescript": "5.9.3",