Itida Lang

Поддержка языка вычислителя Айтида для Visual Studio Code.

Возможности

• Подсветка синтаксиса для файлов .itd
• Подсветка SQL-блоков (__SQL {}, SQLAGGREGATE {}) с отдельной цветовой схемой
• Различение понятий (@Понятие) и SQL-переменных (@переменная) по цвету
• Подсветка шаблонных вставок [[ переменная ]] внутри SQL-блоков
• Цветовая схема, приближенная к оригинальному редактору Айтида
• Поддержка светлых и тёмных тем
• Сниппеты для часто используемых конструкций
• Автодополнение ключевых слов и встроенных функций с документацией
• Hover-подсказки для ключевых слов и функций
• Подсказки параметров функций (Signature Help)
• Навигация по функциям документа (Document Symbols)
• Переход к определению функции (F12 / Ctrl+Click) — для функций документа и библиотечных функций
• Подключение библиотек функций Айтиды — автодополнение, hover, подсказки параметров и переход к исходному коду для функций из выгруженных библиотек

Установка

Найдите расширение Itida Lang в VS Code Marketplace или установите из .vsix:

code --install-extension itida-lang-1.0.0.vsix

Ассоциация файлов

Расширение автоматически активируется для файлов .itd.

Чтобы открывать .txt файлы как Itida в конкретном проекте, добавьте в .vscode/settings.json:

{
  "files.associations": {
    "*.txt": "itida"
  }
}

Настройки расширения

• itida.functionLibraryPath — Путь к каталогу библиотек функций (справочник функций Айтиды, выгруженный в файлы). По умолчанию: пусто.

Подключение библиотек функций

Расширение поддерживает автодополнение и подсказки для функций из библиотек Айтиды. Для этого необходимо указать путь к каталогу с выгруженными библиотеками функций.

Структура каталога:

Каталог библиотек/
  Библиотека REST API/
    index.json              <- метаданные библиотеки (libname, libalias)
    Подгруппа/
      ИмяФункции.json       <- описание функции (name, description, note)
      ИмяФункции.txt        <- код функции
      ...
  Работа с ФР/
    index.json
    ...

Настройка в settings.json (на уровне пользователя или workspace):

{
  "itida.functionLibraryPath": "F:\\WORK\\itida\\Itida-sprfunctionslib"
}

После настройки при вводе алиаса библиотеки и точки (например RESTAPI.) появится список доступных функций с описаниями.

Команды

• Айтида: Перезагрузить библиотеки функций — ручная перезагрузка библиотек из каталога
• Айтида: Создать функцию библиотеки — создание новой функции через интерактивный диалог

Вызов через палитру команд (Ctrl+Shift+P).

Создание новой функции библиотеки

Команда «Айтида: Создать функцию библиотеки» позволяет быстро создать новую функцию, не выходя из редактора. Шаги диалога:

1. Выбор библиотеки — список загруженных библиотек с алиасами и названиями
2. Выбор папки (группы) — корень библиотеки или вложенная папка; имя группы формируется автоматически из пути (например Подпапка1.Подпапка2)
3. Имя функции — валидация допустимых символов
4. Параметры — через запятую (можно оставить пустым)
5. Локальная функция — признак isLocal

По завершении создаются два файла:

• ИмяФункции.txt — пустой файл для кода, сразу открывается в редакторе
• ИмяФункции.json — метаданные с заполненными name, description, groupname, isLocal

Библиотеки перезагружаются автоматически — функция сразу доступна в автодополнении.

Подсветка синтаксиса

Расширение подсвечивает:

• Ключевые слова — IF, ELSE, WHILE, RETURN, FUNCTION, ФУНКЦИЯ и др.
• Встроенные функции — ALLTRIM, QUERY, ADDCONTEXT, GETJSON, СООБЩЕНИЕ и др.
• Понятия — @ИмяПонятия
• Системные константы — _ИмяКонстанты
• SQL-блоки — полная подсветка SQL-синтаксиса внутри SQL {} и SQLAGGREGATE {}
• Комментарии — однострочные // и блочные /* */
• Строки и даты — "строка", 'символ', {01.01.2026}

Лицензия

MIT