Парсер протокола Lino для JavaScript

Реализация парсера протокола Lino для JavaScript с использованием Bun и
генератора парсеров Peggy.js.

Установка

$3

``bash
cd js
bun install
`

$3

`bash
cd js
npm install
`

Сборка

Компиляция грамматики Peggy.js:

`bash
bun run build:grammar
`

Сборка проекта:

`bash
bun run build
`

Тестирование

Запуск тестов:

`bash
bun test
`

Режим наблюдения:

`bash
bun test --watch
`

Использование

$3

`javascript
import { Parser, Link } from 'links-notation';

// Создание парсера
const parser = new Parser();

// Парсинг строки в формате Lino
const input = папа (любитМаму: любит маму)
сын любитМаму
дочь любитМаму
все (любят маму);

const result = parser.parse(input);
console.log(result);

// Обращение к распарсенной структуре
result.forEach((link) => {
console.log(link.toString());
});
`

$3

`javascript
import { Link } from 'links-notation';

// Создание связей программно
const link = new Link('родитель', [new Link('ребенок1'), new Link('ребенок2')]);

console.log(link.toString()); // (родитель: ребенок1 ребенок2)

// Доступ к свойствам связи
console.log('ID:', link.id);
console.log('Значения:', link.values);
`

$3

`javascript
// Обработка вложенных структур
const input = родитель
ребенок1
ребенок2
внук1
внук2;

const parsed = await parser.parse(input);

// Работа с группами
import { LinksGroup } from 'links-notation';
const group = new LinksGroup(parsed);
console.log(group.format());
`

Примеры синтаксиса

$3

`lino
папа (любитМаму: любит маму)
сын любитМаму
дочь любитМаму
все (любят маму)
`

$3

`lino
папа имеет машину
мама имеет дом
(папа и мама) счастливы
`

$3

`lino
(нотацияСвязей: нотация связей)
(Это тоже нотацияСвязей)
(нотацияСвязей поддерживает (неограниченное количество (ссылок) в каждой связи))
`

$3

`lino
родитель
ребенок1
ребенок2
внук1
внук2
`

Справочник API

$3

#### Parser

Основной класс парсера для преобразования строк в связи.

- initialize() - Инициализация парсера (асинхронно)
- parse(input) - Парсинг строки Lino и возвращение связей

#### Link

Представляет одну связь с ID и значениями.

- constructor(id, values = []) - Создание новой связи
- toString() - Преобразование связи в строковый формат
- id - Идентификатор связи
- values - Массив дочерних значений/связей

#### LinksGroup

Контейнер для группировки связанных связей.

- constructor(links) - Создание новой группы
- format() - Форматирование группы в строку

Структура проекта

- src/grammar.pegjs - Определение грамматики Peggy.js
- src/Link.js - Структура данных связи
- src/LinksGroup.js - Контейнер групп связей
- src/Parser.js - Обертка парсера
- src/index.js - Главная точка входа
- tests/ - Файлы тестов

Зависимости

- Peggy.js (5.0.6) - Генератор парсеров
- Среда выполнения Bun (разработка)

Информация о пакете

- Пакет: links-notation`
- Версия: 0.1.0
- Лицензия: MIT