tauri-ts-generator

CLI инструмент для автоматической генерации TypeScript биндингов из Tauri команд.

Описание

tauri-ts-generator сканирует ваш Rust код, находит все функции с макросом #[tauri::command] и автоматически генерирует:

• TypeScript интерфейсы для Rust структур и перечислений
• TypeScript функции-обёртки для вызова Tauri команд через invoke()

Это обеспечивает type-safe взаимодействие между TypeScript frontend и Rust backend, минимизируя ручное написание повторяющегося кода.

Установка

cargo install --path .

Или сборка из исходников:

cargo build --release

Быстрый старт

1. Инициализация конфигурации

cd your-tauri-project
tauri-ts-generator init

Это создаст файл tauri-codegen.toml с настройками по умолчанию.

2. Настройка конфигурации

Отредактируйте tauri-codegen.toml:

[input]
source_dir = "src-tauri/src"
exclude = ["tests", "target"]

[output]
types_file = "src/generated/types.ts"
commands_file = "src/generated/commands.ts"

[naming]
type_prefix = ""
type_suffix = ""
function_prefix = ""
function_suffix = ""

3. Генерация TypeScript кода

tauri-ts-generator generate

Или с подробным выводом:

tauri-ts-generator generate --verbose

Пример

Rust код (вход)

use serde::{Deserialize, Serialize};

#[derive(Serialize, Deserialize)]
pub struct User {
    pub id: i32,
    pub name: String,
    pub email: Option<String>,
}

#[derive(Serialize, Deserialize)]
pub enum UserStatus {
    Active,
    Inactive,
    Pending,
}

#[tauri::command]
pub async fn get_user(id: i32) -> Result<User, String> {
    // ...
}

#[tauri::command]
pub async fn get_all_users() -> Result<Vec<User>, String> {
    // ...
}

#[tauri::command]
pub fn greet(name: String) -> String {
    format!("Hello, {}!", name)
}

TypeScript код (выход)

types.ts:

// This file was auto-generated by tauri-ts-generator
// Do not edit this file manually

export interface User {
  id: number;
  name: string;
  email: string | null;
}

export type UserStatus = "Active" | "Inactive" | "Pending";

commands.ts:

// This file was auto-generated by tauri-ts-generator
// Do not edit this file manually

import { invoke } from "@tauri-apps/api/core";
import type { User } from "./types";

export async function getUser(id: number): Promise<User> {
  return invoke<User>("get_user", { id });
}

export async function getAllUsers(): Promise<User[]> {
  return invoke<User[]>("get_all_users");
}

export async function greet(name: string): Promise<string> {
  return invoke<string>("greet", { name });
}

Маппинг типов

Базовые типы

Внешние типы (crates)

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

[input]

[output]

[naming]

CLI команды

tauri-ts-generator <COMMAND>

Commands:
  generate  Генерация TypeScript биндингов
  init      Создание файла конфигурации
  help      Справка

Options:
  -h, --help     Справка
  -V, --version  Версия

generate

tauri-ts-generator generate [OPTIONS]

Options:
  -c, --config <FILE>  Путь к файлу конфигурации [default: tauri-codegen.toml]
  -v, --verbose        Подробный вывод
  -h, --help           Справка

init

tauri-ts-generator init [OPTIONS]

Options:
  -o, --output <FILE>  Путь для создания конфигурации [default: tauri-codegen.toml]
  -f, --force          Перезаписать существующий файл
  -h, --help           Справка

Особенности

• Автоматический парсинг — использует syn для анализа Rust AST
• Поддержка async функций — корректно обрабатывает async/await
• Пользовательские типы — парсит struct и enum с атрибутами #[derive(Serialize)]
• serde rename — учитывает #[serde(rename = "...")]
• Специальные типы Tauri — автоматически пропускает State, Window, AppHandle
• Вложенные модули — сканирует команды внутри mod блоков

Лицензия

MIT