@x-oasis/map-diff-range 0.1.0

package/test/index.test.ts

@@ -0,0 +1,234 @@
+import { expect, test, describe } from 'vitest';
+import {
+  mapNewerRangeToOlder,
+  mapOlderRangeToNewer,
+  analyzeFragmentChange,
+  resolveGroupChangeFragments,
+} from '../src';
+
+describe('mapNewerRangeToOlder', () => {
+  test('should map range when content is unchanged', () => {
+    const older = 'Hello World';
+    const newer = 'Hello World';
+    const result = mapNewerRangeToOlder(older, newer, 0, 5);
+    expect(result).toEqual({ start: 0, end: 5 });
+  });
+
+  test('should map range when content has insertions', () => {
+    const older = 'Hello World';
+    const newer = 'Hello Beautiful World';
+    // Map range in newer (6-16, "Beautiful ") to older
+    const result = mapNewerRangeToOlder(older, newer, 6, 16);
+    // Should map to position 6 in older (after "Hello ")
+    expect(result.start).toBe(6);
+    expect(result.end).toBe(6);
+  });
+
+  test('should map range when content has deletions', () => {
+    const older = 'Hello Beautiful World';
+    const newer = 'Hello World';
+    // Map range in newer (6-6, at deletion point) to older
+    const result = mapNewerRangeToOlder(older, newer, 6, 6);
+    expect(result.start).toBe(6);
+    expect(result.end).toBeGreaterThan(6);
+  });
+
+  test('should map range in equal section', () => {
+    const older = 'The quick brown fox';
+    const newer = 'The fast brown fox';
+    // Map "brown fox" (10-19 in newer) to older
+    const result = mapNewerRangeToOlder(older, newer, 10, 19);
+    expect(result.start).toBeGreaterThan(0);
+    expect(result.end).toBeGreaterThan(result.start);
+  });
+
+  test('should handle range at boundary', () => {
+    const older = 'Hello';
+    const newer = 'Hello World';
+    const result = mapNewerRangeToOlder(older, newer, 5, 11);
+    expect(result.start).toBe(5);
+    expect(result.end).toBe(5);
+  });
+});
+
+describe('mapOlderRangeToNewer', () => {
+  test('should map range when content is unchanged', () => {
+    const older = 'Hello World';
+    const newer = 'Hello World';
+    const result = mapOlderRangeToNewer(older, newer, 0, 5);
+    expect(result).toEqual({ start: 0, end: 5 });
+  });
+
+  test('should map range when content has insertions', () => {
+    const older = 'Hello World';
+    const newer = 'Hello Beautiful World';
+    // Map range in older (6-6) to newer
+    // Position 6 in older is 'W' (start of "World")
+    // In newer, "World" starts at position 16 (after "Hello Beautiful ")
+    // Since input is empty range (6-6), output should also be empty range (16-16)
+    const result = mapOlderRangeToNewer(older, newer, 6, 10);
+    expect(result.start).toBe(16);
+    expect(result.end).toBe(20);
+  });
+
+  test('should map range when content has deletions', () => {
+    const older = 'Hello Beautiful World';
+    const newer = 'Hello World';
+    // Map range in older (6-16, "Beautiful ") to newer
+    const result = mapOlderRangeToNewer(older, newer, 6, 16);
+    expect(result.start).toBe(6);
+    expect(result.end).toBe(6);
+  });
+
+  test('should map range in equal section', () => {
+    const older = 'The quick brown fox';
+    const newer = 'The fast brown fox';
+    // Map "brown fox" in older to newer
+    const result = mapOlderRangeToNewer(older, newer, 10, 19);
+    expect(result.start).toBeGreaterThan(0);
+    expect(result.end).toBeGreaterThan(result.start);
+  });
+});
+
+describe('analyzeFragmentChange', () => {
+  test('should detect equal fragments', () => {
+    const original = 'Hello World';
+    const final = 'Hello World';
+    const result = analyzeFragmentChange(original, final);
+    expect(result.equal).toBe(true);
+    expect(result.onlyDeletion).toBe(false);
+    expect(result.onlyInsertion).toBe(false);
+    expect(result.replacement).toBe(false);
+    expect(result.summary).toBe('无变更');
+  });
+
+  test('should detect only deletion', () => {
+    const original = 'Hello Beautiful World';
+    const final = 'Hello World';
+    const result = analyzeFragmentChange(original, final);
+    expect(result.equal).toBe(false);
+    expect(result.onlyDeletion).toBe(true);
+    expect(result.onlyInsertion).toBe(false);
+    expect(result.replacement).toBe(false);
+    expect(result.summary).toContain('删除:');
+  });
+
+  test('should detect only insertion', () => {
+    const original = 'Hello World';
+    const final = 'Hello Beautiful World';
+    const result = analyzeFragmentChange(original, final);
+    expect(result.equal).toBe(false);
+    expect(result.onlyDeletion).toBe(false);
+    expect(result.onlyInsertion).toBe(true);
+    expect(result.replacement).toBe(false);
+    expect(result.summary).toContain('新增:');
+  });
+
+  test('should detect replacement', () => {
+    const original = 'The quick brown fox';
+    const final = 'The fast brown fox';
+    const result = analyzeFragmentChange(original, final);
+    expect(result.equal).toBe(false);
+    expect(result.onlyDeletion).toBe(false);
+    expect(result.onlyInsertion).toBe(false);
+    expect(result.replacement).toBe(true);
+    expect(result.summary).toContain('替换:');
+  });
+
+  test('should include diffs array', () => {
+    const original = 'Hello World';
+    const final = 'Hello Beautiful World';
+    const result = analyzeFragmentChange(original, final);
+    expect(Array.isArray(result.diffs)).toBe(true);
+    expect(result.diffs.length).toBeGreaterThan(0);
+  });
+});
+
+describe('resolveGroupChangeFragments', () => {
+  test('should resolve fragments for simple change', () => {
+    const current = 'Hello Beautiful World';
+    const next = 'Hello Amazing World';
+    const result = resolveGroupChangeFragments({
+      currentContent: current,
+      nextContent: next,
+      currentRange: { start: 6, end: 15 },
+    });
+
+    expect(result).toBeDefined();
+    if (result) {
+      expect(result.nextRange).toBeDefined();
+      expect(result.currentFragment).toBeDefined();
+      expect(result.nextFragment).toBeDefined();
+      expect(result.changeAnalysis).toBeDefined();
+    }
+  });
+
+  test('should return undefined for invalid offset range', () => {
+    const current = 'Hello World';
+    const next = 'Hello World';
+    const result = resolveGroupChangeFragments({
+      currentContent: current,
+      nextContent: next,
+      currentRange: { start: -1, end: 5 },
+    });
+
+    expect(result).toBeUndefined();
+  });
+
+  test('should return undefined when endOffset exceeds content length', () => {
+    const current = 'Hello World';
+    const next = 'Hello World';
+    const result = resolveGroupChangeFragments({
+      currentContent: current,
+      nextContent: next,
+      currentRange: { start: 0, end: 1000 },
+    });
+
+    expect(result).toBeUndefined();
+  });
+
+  test('should return undefined when startOffset > endOffset', () => {
+    const current = 'Hello World';
+    const next = 'Hello World';
+    const result = resolveGroupChangeFragments({
+      currentContent: current,
+      nextContent: next,
+      currentRange: { start: 10, end: 5 },
+    });
+
+    expect(result).toBeUndefined();
+  });
+
+  test('should handle complex change', () => {
+    const current = '<h1 class="title text-xl">Name</h1>';
+    const next = '<h1 class="text-xl font-bold">Name</h1>';
+    const result = resolveGroupChangeFragments({
+      currentContent: current,
+      nextContent: next,
+      currentRange: { start: 4, end: 30 },
+    });
+
+    expect(result).toBeDefined();
+    if (result) {
+      expect(result.changeAnalysis.replacement).toBe(true);
+      expect(result.currentFragment).toContain('title');
+      expect(result.nextFragment).toContain('font-bold');
+    }
+  });
+
+  test('should handle empty range', () => {
+    const current = 'Hello World';
+    const next = 'Hello World';
+    const result = resolveGroupChangeFragments({
+      currentContent: current,
+      nextContent: next,
+      currentRange: { start: 5, end: 5 },
+    });
+
+    expect(result).toBeDefined();
+    if (result) {
+      expect(result.currentFragment).toBe('');
+      expect(result.nextFragment).toBe('');
+    }
+  });
+});

package/tsconfig.build.json

@@ -0,0 +1,11 @@
+{
+  "extends": "../../../tsconfig.build.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "esModuleInterop": true
+  },
+
+  "include": [
+    "src/**/*"
+  ]
+}

package/tsconfig.json

@@ -0,0 +1,6 @@
+{
+  "extends": "../../../tsconfig.json",
+  "compilerOptions": {
+    "esModuleInterop": true
+  }
+}

package/vitest.config.ts

@@ -0,0 +1,21 @@
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    globals: true,
+    include: ['test/**/*.(spec|test).ts'],
+    exclude: ['node_modules/**'],
+    threads: false,
+
+    coverage: {
+      provider: 'istanbul',
+    },
+  },
+
+  resolve: {
+    alias: {},
+  },
+  define: {
+    __DEV__: false,
+  },
+});