bramble-parser/test/parser/directoryParser.test.ts

Bramble is a lightweight recursive descent parser that processes .havenfs files, returning a structured Json tree that can be used to construct an in-memory FS representation. The parser is based on line-based grammar, chunk headers, and metadata declarat

import { describe, test, expect, vi, beforeEach } from 'bun:test';
import { BrambleLexer } from '../../src/lexer/brambleLexer';
import { errorManager } from '../../src/errors/errorManager';
import { DirectoryParser } from '../../src/parser/directoryParser';
import * as fs from 'fs';

describe('DirectoryParser integrated with Lexer', () => {

  beforeEach(() => {
    vi.restoreAllMocks();
    errorManager.clear();
  });

  test('Parses a complete DIRECTORY node using the real lexer', () => {
    const lexer = new BrambleLexer({document: './test/examples/test.directory.example.havenfs'});
    lexer.run();

    const dirChunk = lexer.getChunkMap().find(chunk => chunk.type === 'directories');
    if (dirChunk === undefined) return;

    const entries = dirChunk.entries;

    const nodes: HavenFSNode[] = [];
    new DirectoryParser(nodes, entries);

    expect(nodes).toHaveLength(1);
    expect(nodes[0]).toEqual({
      id: 'd92f1',
      type: 'directory',
      parent: 'root',
      name: 'assets'
    });
  });

  test('Supports multiple DIRECTORY nodes within a single chunk', () => {
    const lexer = new BrambleLexer({document: './test/examples/test.multiple.directory.example.havenfs'});
    lexer.run();

    const dirChunk = lexer.getChunkMap().find(chunk => chunk.type === 'directories');
    if (dirChunk === undefined) return;

    const entries = dirChunk.entries;

    const nodes: HavenFSNode[] = [];
    new DirectoryParser(nodes, entries);

    expect(nodes).toHaveLength(2);

    expect(nodes[0].id).toBe('d92f1');
    expect(nodes[0].name).toBe('assets');

    expect(nodes[1].id).toBe('d93a2');
    expect(nodes[1].name).toBe('images');
  });

  test('Does not create nodes if the directories chunk is empty', () => {
    const lexer = new BrambleLexer({document: './test/examples/test.empty.directory.example.havenfs'});
    lexer.run();

    const dirChunk = lexer.getChunkMap().find(chunk => chunk.type === 'directories');
    if (dirChunk === undefined) return;

    const entries = dirChunk.entries;

    const nodes: HavenFSNode[] = [];
    new DirectoryParser(nodes, entries);

    expect(nodes).toHaveLength(0);
  });

  test('Throws an error if mandatory fields are missing', () => {
    const fakeContent = `#CHUNK directories @25000
DIR parent=root name=images
`.trim();
    vi.spyOn(fs, 'readFileSync').mockReturnValue(fakeContent);

    const lexer = new BrambleLexer({document: './test/examples/test.invalid.directory.example.havenfs'});
    lexer.tokenize();
    lexer.groupTokensByLine();
    lexer.groupByChunkContext();

    const dirChunk = lexer.getChunkMap().find(chunk => chunk.type === 'directories');
    if (dirChunk === undefined) return;

    const entries = dirChunk.entries;

    const nodes: HavenFSNode[] = [];

    expect(() => {
      new DirectoryParser(nodes, entries);
    }).toThrowError(/Missing mandatory fields/);
  });
});