@hardlydifficult/text 1.0.5 → 1.0.6

package/README.md

@@ -1,6 +1,6 @@
 # @hardlydifficult/text
 
-Text utilities for error formatting, template replacement, and chunking.
+Text utilities for error formatting, template replacement, chunking, and line numbering.
 
 ## Installation
 
@@ -121,3 +121,31 @@ convertFormat("name: Alice\nage: 30", "json");
 ```
 
 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.
+
+### `formatWithLineNumbers(content: string, startLine?: number): string`
+
+Format text content with right-aligned line numbers. Each line is prefixed with its line number, padded to align properly based on the maximum line number.
+
+```typescript
+import { formatWithLineNumbers } from "@hardlydifficult/text";
+
+// Default: starts at line 1
+formatWithLineNumbers("foo\nbar\nbaz");
+// 1: foo
+// 2: bar
+// 3: baz
+
+// Custom starting line for displaying file ranges
+formatWithLineNumbers("hello\nworld", 10);
+// 10: hello
+// 11: world
+
+// Proper alignment for larger line numbers
+formatWithLineNumbers("line 1\nline 2\n...\nline 100", 98);
+//  98: line 1
+//  99: line 2
+// 100: ...
+// 101: line 100
+```
+
+This is useful for displaying code snippets, file contents, or log output with line numbers for reference.

package/dist/formatWithLineNumbers.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Format text content with right-aligned line numbers.
+ *
+ * @param content - The text content to format
+ * @param startLine - The starting line number (default: 1)
+ * @returns The formatted text with line numbers
+ *
+ * @example
+ * ```typescript
+ * formatWithLineNumbers("foo\nbar\nbaz")
+ * // Returns:
+ * // "1: foo\n2: bar\n3: baz"
+ *
+ * formatWithLineNumbers("hello\nworld", 10)
+ * // Returns:
+ * // "10: hello\n11: world"
+ * ```
+ */
+export declare function formatWithLineNumbers(content: string, startLine?: number): string;
+//# sourceMappingURL=formatWithLineNumbers.d.ts.map

package/dist/formatWithLineNumbers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatWithLineNumbers.d.ts","sourceRoot":"","sources":["../src/formatWithLineNumbers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,SAAI,GAAG,MAAM,CAO5E"}

package/dist/formatWithLineNumbers.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatWithLineNumbers = formatWithLineNumbers;
+/**
+ * Format text content with right-aligned line numbers.
+ *
+ * @param content - The text content to format
+ * @param startLine - The starting line number (default: 1)
+ * @returns The formatted text with line numbers
+ *
+ * @example
+ * ```typescript
+ * formatWithLineNumbers("foo\nbar\nbaz")
+ * // Returns:
+ * // "1: foo\n2: bar\n3: baz"
+ *
+ * formatWithLineNumbers("hello\nworld", 10)
+ * // Returns:
+ * // "10: hello\n11: world"
+ * ```
+ */
+function formatWithLineNumbers(content, startLine = 1) {
+    const lines = content.split("\n");
+    const maxNum = startLine + lines.length - 1;
+    const width = String(maxNum).length;
+    return lines
+        .map((line, i) => `${String(startLine + i).padStart(width)}: ${line}`)
+        .join("\n");
+}
+//# sourceMappingURL=formatWithLineNumbers.js.map

package/dist/formatWithLineNumbers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatWithLineNumbers.js","sourceRoot":"","sources":["../src/formatWithLineNumbers.ts"],"names":[],"mappings":";;AAkBA,sDAOC;AAzBD;;;;;;;;;;;;;;;;;GAiBG;AACH,SAAgB,qBAAqB,CAAC,OAAe,EAAE,SAAS,GAAG,CAAC;IAClE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,SAAS,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC;IACpC,OAAO,KAAK;SACT,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;SACrE,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC"}

package/dist/index.d.ts

@@ -7,4 +7,5 @@ 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";
+export { formatWithLineNumbers } from "./formatWithLineNumbers.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;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,UAAU,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;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-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;
+exports.formatWithLineNumbers = 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; } });
@@ -19,4 +19,6 @@ Object.defineProperty(exports, "buildFileTree", { enumerable: true, get: functio
 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; } });
+var formatWithLineNumbers_js_1 = require("./formatWithLineNumbers.js");
+Object.defineProperty(exports, "formatWithLineNumbers", { enumerable: true, get: function () { return formatWithLineNumbers_js_1.formatWithLineNumbers; } });
 //# 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;AAE1C,uDAAmD;AAA1C,iHAAA,aAAa,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;AAEtB,uEAAmE;AAA1D,iIAAA,qBAAqB,OAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hardlydifficult/text",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [