@jesscss/core 2.0.0-alpha.5 → 2.0.0-alpha.6

package/src/tree/util/__tests__/outputwriter.test.ts

@@ -0,0 +1,523 @@
+import { describe, it, expect } from 'vitest';
+import { OutputWriter } from '../print.js';
+
+describe('OutputWriter', () => {
+  describe('position tracking', () => {
+    it('properly advances output position with plain add', () => {
+      const w = new OutputWriter();
+
+      expect(w.line).toBe(0);
+      expect(w.column).toBe(0);
+
+      w.add('hello');
+      expect(w.line).toBe(0);
+      expect(w.column).toBe(5);
+
+      w.add(' world');
+      expect(w.line).toBe(0);
+      expect(w.column).toBe(11);
+    });
+
+    it('properly counts lines during add', () => {
+      const w = new OutputWriter();
+
+      w.add('line1\nline2\nline3');
+      expect(w.line).toBe(2);
+      expect(w.column).toBe(5); // length of 'line3'
+    });
+
+    it('handles multiple newlines correctly', () => {
+      const w = new OutputWriter();
+
+      w.add('a\nb\nc\nd');
+      expect(w.line).toBe(3);
+      expect(w.column).toBe(1); // length of 'd'
+    });
+
+    it('handles empty string', () => {
+      const w = new OutputWriter();
+
+      w.add('');
+      expect(w.line).toBe(0);
+      expect(w.column).toBe(0);
+    });
+
+    it('handles string ending with newline', () => {
+      const w = new OutputWriter();
+
+      w.add('hello\n');
+      expect(w.line).toBe(1);
+      expect(w.column).toBe(0); // after newline
+    });
+  });
+
+  describe('capture behavior', () => {
+    it('captures content without advancing the output index', () => {
+      const w = new OutputWriter();
+
+      w.add('before ');
+      const beforeLine = w.line;
+      const beforeColumn = w.column;
+
+      const captured = w.capture(() => {
+        w.add('captured content\nwith newlines');
+      });
+
+      // Position should be unchanged after capture
+      expect(w.line).toBe(beforeLine);
+      expect(w.column).toBe(beforeColumn);
+      expect(w.toString()).toBe('before ');
+      expect(captured).toBe('captured content\nwith newlines');
+    });
+
+    it('capture does not affect main buffer', () => {
+      const w = new OutputWriter();
+
+      w.add('start');
+      const captured = w.capture(() => {
+        w.add('middle');
+      });
+      w.add('end');
+
+      expect(w.toString()).toBe('startend');
+      expect(captured).toBe('middle');
+    });
+
+    it('capture with newlines does not affect position', () => {
+      const w = new OutputWriter();
+
+      w.add('line1\n');
+      const captured = w.capture(() => {
+        w.add('line2\nline3\n');
+      });
+
+      expect(w.line).toBe(1);
+      expect(w.column).toBe(0);
+      expect(w.toString()).toBe('line1\n');
+      expect(captured).toBe('line2\nline3\n');
+    });
+
+    it('captureWithMeta defaults to implicit boundary intent', () => {
+      const w = new OutputWriter();
+      const captured = w.captureWithMeta(() => {
+        w.add('abc');
+      });
+      expect(captured).toEqual({
+        text: 'abc',
+        leadingIntent: 'implicit',
+        trailingIntent: 'implicit'
+      });
+    });
+
+    it('captureWithMeta preserves explicit boundary intent signals', () => {
+      const w = new OutputWriter();
+      const captured = w.captureWithMeta(() => {
+        w.signalBoundaryIntent('pre', 'explicit_none');
+        w.add('abc');
+        w.signalBoundaryIntent('post', 'explicit_none');
+      });
+      expect(captured).toEqual({
+        text: 'abc',
+        leadingIntent: 'explicit_none',
+        trailingIntent: 'explicit_none'
+      });
+    });
+  });
+
+  describe('mark and restore', () => {
+    it('mark returns current chunk count', () => {
+      const w = new OutputWriter();
+
+      expect(w.mark()).toBe(0);
+      w.add('chunk1');
+      expect(w.mark()).toBe(1);
+      w.add('chunk2');
+      expect(w.mark()).toBe(2);
+    });
+
+    it('getSince returns content since mark', () => {
+      const w = new OutputWriter();
+
+      w.add('chunk1');
+      const mark1 = w.mark();
+      w.add('chunk2');
+      w.add('chunk3');
+
+      expect(w.getSince(mark1)).toBe('chunk2chunk3');
+    });
+
+    it('restore reverts to mark position', () => {
+      const w = new OutputWriter();
+
+      w.add('line1\n');
+      const mark = w.mark();
+      w.add('line2\nline3\n');
+
+      expect(w.line).toBe(3);
+      expect(w.column).toBe(0);
+
+      w.restore(mark);
+      expect(w.line).toBe(1);
+      expect(w.column).toBe(0);
+      expect(w.toString()).toBe('line1\n');
+    });
+
+    it('restore with invalid mark does nothing', () => {
+      const w = new OutputWriter();
+
+      w.add('content');
+      const originalLine = w.line;
+      const originalColumn = w.column;
+      const originalString = w.toString();
+
+      w.restore(-1);
+      w.restore(999);
+
+      expect(w.line).toBe(originalLine);
+      expect(w.column).toBe(originalColumn);
+      expect(w.toString()).toBe(originalString);
+    });
+  });
+
+  describe('_positions array behavior', () => {
+    it('tracks positions for each chunk', () => {
+      const w = new OutputWriter();
+
+      w.add('hello');
+      w.add(' world');
+      w.add('\nnew line');
+
+      // Access private _positions array for testing
+      const positions = (w as any)._positions;
+      expect(positions).toHaveLength(3);
+      expect(positions[0]).toEqual({ line: 0, column: 5, segments: 0, length: 5 });
+      expect(positions[1]).toEqual({ line: 0, column: 11, segments: 0, length: 11 });
+      expect(positions[2]).toEqual({ line: 1, column: 8, segments: 0, length: 20 });
+    });
+
+    it('capture does not affect _positions array', () => {
+      const w = new OutputWriter();
+
+      w.add('before');
+      const beforePositions = [...(w as any)._positions];
+
+      const captured = w.capture(() => {
+        w.add('captured\ncontent');
+      });
+
+      // _positions should be unchanged after capture
+      expect((w as any)._positions).toEqual(beforePositions);
+      expect(captured).toBe('captured\ncontent');
+    });
+
+    it('restore properly resets _positions array', () => {
+      const w = new OutputWriter();
+
+      w.add('line1\n');
+      const mark = w.mark();
+      const positionsAtMark = [...(w as any)._positions];
+
+      w.add('line2\nline3\n');
+      expect((w as any)._positions).toHaveLength(2); // Only 2 chunks: 'line2\n' and 'line3\n'
+
+      w.restore(mark);
+      expect((w as any)._positions).toEqual(positionsAtMark);
+    });
+
+    it('_positions tracks segments count', () => {
+      const w = new OutputWriter();
+
+      // Add content with origin that has location info
+      const mockOrigin = {
+        location: [0, 1, 1, 0, 1, 5], // [start, startLine, startColumn, end, endLine, endColumn]
+        treeContext: { file: { fullPath: 'test.css' } }
+      };
+
+      w.add('content', mockOrigin);
+      const positions = (w as any)._positions;
+      expect(positions[0].segments).toBe(1);
+    });
+  });
+
+  describe('sourcemap segments behavior', () => {
+    it('creates segments for content with origin location', () => {
+      const w = new OutputWriter();
+
+      const mockOrigin = {
+        location: [0, 1, 1, 0, 1, 5], // [start, startLine, startColumn, end, endLine, endColumn]
+        treeContext: { file: { fullPath: 'test.css' } }
+      };
+
+      w.add('hello', mockOrigin);
+      const segments = w.getSegments();
+
+      expect(segments).toHaveLength(1);
+      expect(segments[0]).toEqual({
+        genLine: 0,
+        genColumn: 0,
+        source: 'test.css',
+        origLine: 0, // 1-based to 0-based conversion
+        origColumn: 0 // 1-based to 0-based conversion
+      });
+    });
+
+    it('capture does not create segments in main buffer', () => {
+      const w = new OutputWriter();
+
+      const mockOrigin = {
+        location: [0, 1, 1, 0, 1, 5],
+        treeContext: { file: { fullPath: 'test.css' } }
+      };
+
+      w.add('before');
+      const beforeSegments = [...w.getSegments()];
+
+      const captured = w.capture(() => {
+        w.add('captured', mockOrigin);
+      });
+
+      // Segments should be unchanged after capture
+      expect(w.getSegments()).toEqual(beforeSegments);
+      expect(captured).toBe('captured');
+    });
+
+    it('restore properly resets segments array', () => {
+      const w = new OutputWriter();
+
+      const mockOrigin = {
+        location: [0, 1, 1, 0, 1, 5],
+        treeContext: { file: { fullPath: 'test.css' } }
+      };
+
+      w.add('before');
+      const mark = w.mark();
+      const segmentsAtMark = [...w.getSegments()];
+
+      w.add('after', mockOrigin);
+      expect(w.getSegments()).toHaveLength(1);
+
+      w.restore(mark);
+      expect(w.getSegments()).toEqual(segmentsAtMark);
+    });
+
+    it('segments track correct generated positions', () => {
+      const w = new OutputWriter();
+
+      const mockOrigin = {
+        location: [0, 1, 1, 0, 1, 5],
+        treeContext: { file: { fullPath: 'test.css' } }
+      };
+
+      w.add('hello\nworld', mockOrigin);
+      const segments = w.getSegments();
+
+      expect(segments).toHaveLength(1);
+      expect(segments[0]!.genLine).toBe(0);
+      expect(segments[0]!.genColumn).toBe(0);
+    });
+
+    it('multiple segments track positions correctly', () => {
+      const w = new OutputWriter();
+
+      const origin1 = {
+        location: [0, 1, 1, 0, 1, 5],
+        treeContext: { file: { fullPath: 'test1.css' } }
+      };
+
+      const origin2 = {
+        location: [0, 2, 1, 0, 2, 5],
+        treeContext: { file: { fullPath: 'test2.css' } }
+      };
+
+      w.add('hello', origin1);
+      w.add(' world', origin2);
+
+      const segments = w.getSegments();
+      expect(segments).toHaveLength(2);
+      expect(segments[0]!.genLine).toBe(0);
+      expect(segments[0]!.genColumn).toBe(0);
+      expect(segments[1]!.genLine).toBe(0);
+      expect(segments[1]!.genColumn).toBe(5);
+    });
+
+    it('segments handle newlines correctly', () => {
+      const w = new OutputWriter();
+
+      const mockOrigin = {
+        location: [0, 1, 1, 0, 1, 5],
+        treeContext: { file: { fullPath: 'test.css' } }
+      };
+
+      w.add('line1\nline2', mockOrigin);
+      const segments = w.getSegments();
+
+      expect(segments).toHaveLength(1);
+      expect(segments[0]!.genLine).toBe(0);
+      expect(segments[0]!.genColumn).toBe(0);
+    });
+
+    it('restore with segments maintains correct mapping', () => {
+      const w = new OutputWriter();
+
+      const mockOrigin = {
+        location: [0, 1, 1, 0, 1, 5],
+        treeContext: { file: { fullPath: 'test.css' } }
+      };
+
+      w.add('before');
+      const mark = w.mark();
+
+      w.add('content', mockOrigin);
+      expect(w.getSegments()).toHaveLength(1);
+
+      w.restore(mark);
+      expect(w.getSegments()).toHaveLength(0);
+
+      // Adding after restore should work correctly
+      w.add('after', mockOrigin);
+      expect(w.getSegments()).toHaveLength(1);
+      expect(w.getSegments()[0]!.genLine).toBe(0);
+      expect(w.getSegments()[0]!.genColumn).toBe(6); // after 'before'
+    });
+  });
+
+  describe('declaration-like serialization pattern', () => {
+    it('handles basic declaration pattern', () => {
+      const w = new OutputWriter();
+
+      w.add('property:');
+      const valOut = w.capture(() => {
+        w.add('value');
+      });
+      w.add(' ');
+      w.add(valOut);
+      w.add(';');
+
+      expect(w.toString()).toBe('property: value;');
+    });
+
+    it('handles trailing spaces in captured content', () => {
+      const w = new OutputWriter();
+
+      w.add('property:');
+      const valOut = w.capture(() => {
+        w.add('value ');
+      });
+      w.add(' ');
+      w.add(valOut);
+      w.add(';');
+
+      expect(w.toString()).toBe('property: value ;');
+    });
+
+    it('handles leading spaces in captured content', () => {
+      const w = new OutputWriter();
+
+      w.add('property:');
+      const valOut = w.capture(() => {
+        w.add(' value');
+      });
+      w.add(' ');
+      w.add(valOut);
+      w.add(';');
+
+      expect(w.toString()).toBe('property:  value;');
+    });
+
+    it('handles both leading and trailing spaces', () => {
+      const w = new OutputWriter();
+
+      w.add('property:');
+      const valOut = w.capture(() => {
+        w.add(' value ');
+      });
+      w.add(' ');
+      w.add(valOut);
+      w.add(';');
+
+      expect(w.toString()).toBe('property:  value ;');
+    });
+
+    it('demonstrates the actual CSS serialization issue', () => {
+      const w = new OutputWriter();
+
+      w.add('color:');
+      const valOut = w.capture(() => {
+        w.add('white '); // Note the trailing space
+      });
+      w.add(' ');
+      w.add(valOut.replace(/^\s+/, '')); // Remove leading whitespace only
+      w.add('!important');
+
+      // This produces "color: white !important" instead of "color: white!important"
+      expect(w.toString()).toBe('color: white !important');
+    });
+
+    it('demonstrates the correct behavior with trailing space removal', () => {
+      const w = new OutputWriter();
+
+      w.add('color:');
+      const valOut = w.capture(() => {
+        w.add('white '); // Note the trailing space
+      });
+      w.add(' ');
+      w.add(valOut.replace(/^\s+/, '').replace(/\s+$/, '')); // Remove both leading and trailing whitespace
+      w.add('!important');
+
+      // This produces the correct "color: white!important"
+      expect(w.toString()).toBe('color: white!important');
+    });
+  });
+
+  describe('toString and chunks', () => {
+    it('toString joins all chunks', () => {
+      const w = new OutputWriter();
+
+      w.add('chunk1');
+      w.add('chunk2');
+      w.add('chunk3');
+
+      expect(w.toString()).toBe('chunk1chunk2chunk3');
+    });
+
+    it('toString returns empty string for empty writer', () => {
+      const w = new OutputWriter();
+      expect(w.toString()).toBe('');
+    });
+  });
+
+  describe('edge cases', () => {
+    it('handles null/undefined text gracefully', () => {
+      const w = new OutputWriter();
+
+      // @ts-ignore - testing edge case
+      w.add(null);
+      // @ts-ignore - testing edge case
+      w.add(undefined);
+      w.add('');
+
+      expect(w.toString()).toBe('');
+      expect(w.line).toBe(0);
+      expect(w.column).toBe(0);
+    });
+
+    it('handles very long strings', () => {
+      const w = new OutputWriter();
+      const longString = 'a'.repeat(1000);
+
+      w.add(longString);
+      expect(w.line).toBe(0);
+      expect(w.column).toBe(1000);
+      expect(w.toString()).toBe(longString);
+    });
+
+    it('handles strings with only newlines', () => {
+      const w = new OutputWriter();
+
+      w.add('\n\n\n');
+      expect(w.line).toBe(3);
+      expect(w.column).toBe(0);
+      expect(w.toString()).toBe('\n\n\n');
+    });
+  });
+});

package/src/tree/util/__tests__/print.test.ts

@@ -0,0 +1,183 @@
+import { describe, it, expect, beforeEach } from 'vitest';
+import { OutputWriter, getPrintOptions } from '../print.js';
+import { any } from '../../../index.js';
+
+describe('processPrePost with capture', () => {
+  let w: OutputWriter;
+  let options: ReturnType<typeof getPrintOptions>;
+
+  beforeEach(() => {
+    w = new OutputWriter();
+    options = getPrintOptions({ writer: w });
+  });
+
+  it('processPrePost returns correct value for array with newline string', () => {
+    const node = any('test');
+    node.pre = ['\n  '];
+
+    const result = node.processPrePost('pre', '', options);
+    expect(result).toBe('\n  ');
+  });
+
+  it('capture properly captures output from processPrePost with array containing newline string', () => {
+    const node = any('test');
+    node.pre = ['\n  '];
+
+    const captured = w.capture(() => {
+      node.processPrePost('pre', '', options);
+    });
+
+    expect(captured).toBe('\n  ');
+    expect(w.toString()).toBe('');
+  });
+
+  it('capture properly captures output from processPrePost with array containing multiple strings', () => {
+    const node = any('test');
+    node.pre = ['\n  ', '  more'];
+
+    const captured = w.capture(() => {
+      node.processPrePost('pre', '', options);
+    });
+
+    expect(captured).toBe('\n    more');
+    expect(w.toString()).toBe('');
+  });
+
+  it('capture properly captures output from processPrePost with array containing single space string', () => {
+    const node = any('test');
+    node.pre = [' '];
+
+    const captured = w.capture(() => {
+      node.processPrePost('pre', '', options);
+    });
+
+    expect(captured).toBe(' ');
+    expect(w.toString()).toBe('');
+  });
+
+  it('capture properly captures output from processPrePost with array containing empty string', () => {
+    const node = any('test');
+    node.pre = [''];
+
+    const captured = w.capture(() => {
+      node.processPrePost('pre', '', options);
+    });
+
+    expect(captured).toBe('');
+    expect(w.toString()).toBe('');
+  });
+
+  it('capture properly captures output from processPrePost with array containing only newline', () => {
+    const node = any('test');
+    node.pre = ['\n'];
+
+    const captured = w.capture(() => {
+      node.processPrePost('pre', '', options);
+    });
+
+    expect(captured).toBe('\n');
+    expect(w.toString()).toBe('');
+  });
+
+  it('capture properly captures output from processPrePost with array containing tab and spaces', () => {
+    const node = any('test');
+    node.pre = ['\n\t  '];
+
+    const captured = w.capture(() => {
+      node.processPrePost('pre', '', options);
+    });
+
+    expect(captured).toBe('\n\t  ');
+    expect(w.toString()).toBe('');
+  });
+
+  it('capture properly captures output when processPrePost is called multiple times', () => {
+    const node = any('test');
+    node.pre = ['\n  '];
+
+    const captured1 = w.capture(() => {
+      node.processPrePost('pre', '', options);
+    });
+
+    const captured2 = w.capture(() => {
+      node.processPrePost('pre', '', options);
+    });
+
+    expect(captured1).toBe('\n  ');
+    expect(captured2).toBe('\n  ');
+    expect(w.toString()).toBe('');
+  });
+
+  it('capture properly captures output when there is existing content in writer', () => {
+    w.add('existing');
+    const node = any('test');
+    node.pre = ['\n  '];
+
+    const captured = w.capture(() => {
+      node.processPrePost('pre', '', options);
+    });
+
+    expect(captured).toBe('\n  ');
+    expect(w.toString()).toBe('existing');
+  });
+
+  it('processPrePost with numeric value 1 returns single space', () => {
+    const node = any('test');
+    node.pre = 1;
+
+    const result = node.processPrePost('pre', '', options);
+    expect(result).toBe(' ');
+  });
+
+  it('capture properly captures output from processPrePost with numeric value 1', () => {
+    const node = any('test');
+    node.pre = 1;
+
+    const captured = w.capture(() => {
+      node.processPrePost('pre', '', options);
+    });
+
+    expect(captured).toBe(' ');
+    expect(w.toString()).toBe('');
+  });
+
+  it('processPrePost with numeric value 0 returns empty string', () => {
+    const node = any('test');
+    node.pre = 0;
+
+    const result = node.processPrePost('pre', '', options);
+    expect(result).toBe('');
+  });
+
+  it('capture properly captures output from processPrePost with numeric value 0', () => {
+    const node = any('test');
+    node.pre = 0;
+
+    const captured = w.capture(() => {
+      node.processPrePost('pre', '', options);
+    });
+
+    expect(captured).toBe('');
+    expect(w.toString()).toBe('');
+  });
+
+  it('processPrePost with string value returns that string', () => {
+    const node = any('test');
+    node.pre = ['  '];
+
+    const result = node.processPrePost('pre', '', options);
+    expect(result).toBe('  ');
+  });
+
+  it('capture properly captures output from processPrePost with string value', () => {
+    const node = any('test');
+    node.pre = ['  '];
+
+    const captured = w.capture(() => {
+      node.processPrePost('pre', '', options);
+    });
+
+    expect(captured).toBe('  ');
+    expect(w.toString()).toBe('');
+  });
+});