typespec-ai

CLI-инструмент для генерации TypeScript-типов из моделей TypeSpec с помощью OpenRouter AI API.

Возможности

• Читает .tsp файлы из папки (настраивается).
• Отправляет каждый файл в OpenRouter API для генерации типов.
• Сохраняет результат в отдельные .d.ts файлы.
• Поддерживает watch-режим для автоматической генерации при изменениях.
• Настраивается через typespec-ai.config.json в вашем проекте.

Установка

npm install -D typespec-ai

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

1. Создайте конфиг в корне вашего проекта:

{
  "apiKey": "your-openrouter-api-key",
  "model": "qwen/qwen3-coder:free",
  "inputDir": "specs/models",
  "outputDir": "types"
}

2. Добавьте .tsp файлы в папку specs/models (или другую, указанную в конфиге)

3. Запустите генерацию:

npx typespec-ai generate

4. Для автоматической генерации при изменениях:

npx typespec-ai generate --watch

Конфигурация

Библиотека ищет конфиг typespec-ai.config.json в корне вашего проекта. Если конфиг не найден, используются значения по умолчанию:

• inputDir: specs/models
• outputDir: types
• model: qwen/qwen3-coder:free
• apiKey: должен быть указан в конфиге или через переменную окружения OPENROUTER_API_KEY