refactor: remove unused diff format options

- Remove format option from CLI and SDK interfaces
- Delete format-related code and flags
- Simplify getFileDiff() to use standard git diff
- Update examples in CLI help text

Author: bayuagpr-xaltius

README.md

@@ -118,7 +118,6 @@ Options:
   -e, --end-ref <ref>        Ending reference (older state)
   -o, --output <dir>         Output directory (default: "git-diffs")
   --exclude <patterns...>    Additional file patterns to exclude
-  -f, --format <format>      Diff format: diff|unified|side-by-side
   -m, --mode <mode>         Comparison mode: pr|commit|tag (default: "pr")
   --light-mode              Use light mode theme
   -h, --help                Display help
@@ -127,8 +126,8 @@ Options:
 ### Advanced Examples
 
 ```bash
-# Side-by-side tag comparison
-gitloom-diff -s v2.0.0 -e v1.0.0 -m tag -f side-by-side
+# Tag comparison
+gitloom-diff -s v2.0.0 -e v1.0.0 -m tag
 
 # Exclude patterns with commit comparison
 gitloom-diff -s abc123 -e def456 -m commit --exclude "*.test.js" "docs/**"
@@ -139,7 +138,6 @@ gitloom-diff \
   -e develop \
   -m pr \
   -o ui-changes \
-  -f side-by-side \
   --exclude "*.test.js" "*.snap" \
   --light-mode
 ```
@@ -152,7 +150,6 @@ const GitLoomDiff = require('gitloom-diff');
 const differ = new GitLoomDiff({
   outputDir: 'custom-dir',
   exclusions: ['*.log'],
-  diffFormat: 'side-by-side',
   darkMode: false,
   mode: 'pr'
 });

example/src/cli/index.js.md

@@ -42,10 +42,6 @@ index 34daa02..2fa36fa 100644
 + * @param {string} [options.endRef] - Ending git reference to compare to
 + * @param {string} [options.output=git-diffs] - Directory to output the diff files
 + * @param {string[]} [options.exclude] - File patterns to exclude from the diff
-+ * @param {string} [options.format=diff] - Diff format:
-+ *   - 'diff': Traditional git diff format
-+ *   - 'unified': Unified diff format
-+ *   - 'side-by-side': Two column comparison view
 + * @param {boolean} [options.lightMode=false] - Use light mode theme instead of dark
 + * 
 + * Default behavior:

example/src/sdk/GitLoomDiff.js.md

@@ -44,7 +44,6 @@ index 309c756..cbbe85d 100644
 +   * @param {Object} options - Configuration options
 +   * @param {string} [options.outputDir='git-diffs'] - Directory to output the diff files
 +   * @param {string[]} [options.exclude=[]] - File patterns to exclude from the diff
-+   * @param {string} [options.format='diff'] - Diff format (diff, unified, side-by-side)
 +   * @param {boolean} [options.darkMode=true] - Whether to use dark mode theme
 +   */
    constructor(options = {}) {

example/src/sdk/config/Config.js.md

@@ -41,7 +41,6 @@ index 6634d45..1035615 100644
 +   * @param {Object} options - Configuration options
 +   * @param {string} [options.outputDir='git-diffs'] - Directory to output the diff files
 +   * @param {string[]} [options.exclusions=[]] - Additional file patterns to exclude from diff
-+   * @param {('diff'|'unified'|'side-by-side')} [options.diffFormat='diff'] - Format for git diff output
 +   * @param {boolean} [options.darkMode=true] - Whether to use dark mode styling
 +   */
    constructor(options = {}) {

example/src/sdk/utils/gitUtils.js.md

@@ -94,7 +94,6 @@ index 541dbcf..94ec414 100644
 +   * Gets the diff output for a specific file
 +   * @param {string} file - Path to the file
 +   * @param {string} range - Git range to compare
-+   * @param {('diff'|'unified'|'side-by-side')} [format='diff'] - Diff output format
 +   * @returns {Promise<string>} Formatted diff output
 +   * @throws {Error} If git command fails
 +   */

src/cli/index.js

@@ -12,10 +12,6 @@ const pkg = require("../../package.json");
  * @param {string} [options.endRef] - Ending git reference to compare to
  * @param {string} [options.output=git-diffs] - Directory to output the diff files
  * @param {string[]} [options.exclude] - File patterns to exclude from the diff
- * @param {string} [options.format=diff] - Diff format:
- *   - 'diff': Traditional git diff format
- *   - 'unified': Unified diff format
- *   - 'side-by-side': Two column comparison view
  * @param {boolean} [options.lightMode=false] - Use light mode theme instead of dark
  * @param {string} [options.mode] - Comparison mode (pr, commit, tag)
  * 
@@ -32,13 +28,6 @@ const pkg = require("../../package.json");
  * - Navigation links between files
  */
 
-// Add this helper function
-function isCommitHash(ref) {
-  // Git commit hashes are 40 chars or abbreviated to at least 7 chars
-  // and contain only hexadecimal characters
-  return ref && /^[0-9a-f]{7,40}$/i.test(ref);
-}
-
 // Add this branding function
 function showBranding() {
   console.log(`
@@ -55,7 +44,6 @@ program
   .option("-e, --end-ref <ref>", "Ending reference (commit hash, branch name, or tag)")
   .option("-o, --output <dir>", "Output directory", "git-diffs")
   .option("--exclude <patterns...>", "Additional file patterns to exclude")
-  .option("-f, --format <format>", "Diff format (diff, unified, side-by-side)", "diff")
   .option("--light-mode", "Use light mode theme instead of dark mode")
   .option("-m, --mode <mode>", "Comparison mode (pr, commit, tag)", "pr")
   .addHelpText('after', `
@@ -72,8 +60,8 @@ Examples:
   # Compare commits (use -m commit for commit comparison)
   $ gitloom-diff -s abc123 -e def456 -m commit
 
-  # Side-by-side diff with custom output
-  $ gitloom-diff -s main -e develop -o pr-diffs -f side-by-side
+  # Diff with custom output
+  $ gitloom-diff -s main -e develop -o pr-diffs
 
 Note:
   Mode (-m) affects how git compares the references:
@@ -86,7 +74,6 @@ Note:
     const config = {
       outputDir: options.output,
       exclusions: options.exclude || [],
-      diffFormat: options.format,
       darkMode: !options.lightMode,
       mode: options.mode
     };

src/sdk/GitLoomDiff.js

@@ -12,7 +12,6 @@ class GitLoomDiff {
    * @param {Object} options - Configuration options
    * @param {string} [options.outputDir='git-diffs'] - Directory to output the diff files
    * @param {string[]} [options.exclude=[]] - File patterns to exclude from the diff
-   * @param {string} [options.format='diff'] - Diff format (diff, unified, side-by-side)
    * @param {boolean} [options.darkMode=true] - Whether to use dark mode theme
    * @param {string} [options.mode='pr'] - Diff mode ('pr', 'commit', or 'tag')
    */
@@ -144,7 +143,7 @@ class GitLoomDiff {
    * @private
    */
   async #generateFileContent(file, range, fileInfo) {
-    const diffOutput = await gitUtils.getFileDiff(file, range, this.config.diffFormat);
+    const diffOutput = await gitUtils.getFileDiff(file, range);
 
     return [
       this.config.getCssStyle(),

src/sdk/config/Config.js

@@ -8,13 +8,11 @@ class Config {
    * @param {Object} options - Configuration options
    * @param {string} [options.outputDir='git-diffs'] - Directory to output the diff files
    * @param {string[]} [options.exclusions=[]] - Additional file patterns to exclude from diff
-   * @param {('diff'|'unified'|'side-by-side')} [options.diffFormat='diff'] - Format for git diff output
    * @param {boolean} [options.darkMode=true] - Whether to use dark mode styling
    */
   constructor(options = {}) {
     this.outputDir = options.outputDir || "git-diffs";
     this.exclusions = options.exclusions || [];
-    this.diffFormat = options.diffFormat || "diff"; // possible values: diff, unified, side-by-side
     this.darkMode = options.darkMode ?? true;
   }
 

src/sdk/utils/gitUtils.js

@@ -68,19 +68,11 @@ const gitUtils = {
    * Gets the diff output for a specific file
    * @param {string} file - Path to the file
    * @param {string} range - Git range to compare
-   * @param {('diff'|'unified'|'side-by-side')} [format='diff'] - Diff output format
    * @returns {Promise<string>} Formatted diff output
    * @throws {Error} If git command fails
    */
-  async getFileDiff(file, range, format = 'diff') {
-    const formatFlags = {
-      'diff': '',
-      'unified': ' -U3',
-      'side-by-side': ' --side-by-side --width=180'
-    };
-
-    const flag = formatFlags[format] || '';
-    const cmd = `git diff${flag} ${range} -- "${file}"`;
+  async getFileDiff(file, range) {
+    const cmd = `git diff ${range} -- "${file}"`;
     const { stdout } = await execAsync(cmd, {
       maxBuffer: 10 * 1024 * 1024
     });