git-er-done 0.1.20 → 0.1.22

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "git-er-done",
-  "version": "0.1.20",
+  "version": "0.1.22",
   "description": "Utility for dealing with modified, created, deleted files since a git commit",
   "main": "src/index.js",
   "types": "types/index.d.ts",

package/src/git/getDiffFormatted.js

@@ -51,6 +51,12 @@ function getLongestLineLength(diff) {
   return maxLength
 }
 
+/**
+ * @typedef {Object} FormattedDiffResult
+ * @property {string} formatted - Terminal-formatted diff with colors
+ * @property {string} raw - Raw unified diff from git
+ */
+
 /**
  * Get formatted diff for a specific file
  * @param {Object} options - Options for getting formatted diff
@@ -62,7 +68,8 @@ function getLongestLineLength(diff) {
  * @param {number} [options.leftMargin=0] - Number of spaces to add to the left of each line
  * @param {number} [options.width=140] - Width of the diff output (ignored if shrinkToLongestLine is true)
  * @param {boolean} [options.hideHeader=false] - Remove the file path header from the diff
- * @returns {Promise<string | null>} Formatted diff string or null if no diff
+ * @param {boolean} [options.returnRaw=false] - Return both formatted and raw diff
+ * @returns {Promise<string | FormattedDiffResult | null>} Formatted diff string, or {formatted, raw} if returnRaw, or null if no diff
  */
 async function getFormattedDiff({
   filePath,
@@ -72,7 +79,8 @@ async function getFormattedDiff({
   shrinkToLongestLine = false,
   leftMargin = 0,
   width = 140,
-  hideHeader = false
+  hideHeader = false,
+  returnRaw = false
 }) {
   try {
     const { formatDiff } = await import('@davidwells/git-split-diffs')
@@ -130,9 +138,12 @@ async function getFormattedDiff({
     // Add left margin if specified
     if (leftMargin > 0) {
       const margin = ' '.repeat(leftMargin)
-      return formatted.split('\n').map(line => margin + line).join('\n')
+      formatted = formatted.split('\n').map(line => margin + line).join('\n')
     }
 
+    if (returnRaw) {
+      return { formatted, raw: diff }
+    }
     return formatted
   } catch (err) {
     console.error(`Error formatting diff for ${filePath}:`, err.message)

package/types/git/getDiffFormatted.d.ts

@@ -1,3 +1,18 @@
+export type FormattedDiffResult = {
+    /**
+     * - Terminal-formatted diff with colors
+     */
+    formatted: string;
+    /**
+     * - Raw unified diff from git
+     */
+    raw: string;
+};
+/**
+ * @typedef {Object} FormattedDiffResult
+ * @property {string} formatted - Terminal-formatted diff with colors
+ * @property {string} raw - Raw unified diff from git
+ */
 /**
  * Get formatted diff for a specific file
  * @param {Object} options - Options for getting formatted diff
@@ -9,9 +24,10 @@
  * @param {number} [options.leftMargin=0] - Number of spaces to add to the left of each line
  * @param {number} [options.width=140] - Width of the diff output (ignored if shrinkToLongestLine is true)
  * @param {boolean} [options.hideHeader=false] - Remove the file path header from the diff
- * @returns {Promise<string | null>} Formatted diff string or null if no diff
+ * @param {boolean} [options.returnRaw=false] - Return both formatted and raw diff
+ * @returns {Promise<string | FormattedDiffResult | null>} Formatted diff string, or {formatted, raw} if returnRaw, or null if no diff
  */
-export function getFormattedDiff({ filePath, gitRootDir, cwd, baseBranch, shrinkToLongestLine, leftMargin, width, hideHeader }: {
+export function getFormattedDiff({ filePath, gitRootDir, cwd, baseBranch, shrinkToLongestLine, leftMargin, width, hideHeader, returnRaw }: {
     filePath: string;
     gitRootDir?: string;
     cwd?: string;
@@ -20,4 +36,5 @@ export function getFormattedDiff({ filePath, gitRootDir, cwd, baseBranch, shrink
     leftMargin?: number;
     width?: number;
     hideHeader?: boolean;
-}): Promise<string | null>;
+    returnRaw?: boolean;
+}): Promise<string | FormattedDiffResult | null>;