@luxo/vite-plugin

Compile-time field tracking + code generation for Luxo

编译期字段追踪 + 代码生成 — 自动注入 $select，零冗余数据传输

Install / 安装

pnpm add -D @luxo/vite-plugin

Vite Config / 配置

import { defineConfig } from 'vite'
import { luxo } from '@luxo/vite-plugin'

export default defineConfig({
  plugins: [luxo()],
})

Features / 功能

Compile-time $select / 编译期字段选择

// Source / 源代码
const post = await client.getPost(1)
console.log(post.title)
console.log(post.user.name)

// Compiled / 编译后（自动注入）
const post = await client.getPost(1, { $select: 'title,user{name}' })

Nested field tracking / 嵌套字段追踪

post.comments.forEach(c => {
  c.user.avatar  // → $select: "comments{user{avatar}}"
})

Supported patterns / 支持的模式

• Direct: user.name
• Optional chain: user?.name
• Nested relations: post.user.name
• Lambda params: arr.forEach(item => item.field)
• Variable alias: const author = post.user; author.name
• Destructuring: const { name, email } = await client.getUser(1)
• Depth warning: nesting > 5 levels triggers compile-time warning

Code generation / 代码生成

Generates typed client from schema introspection:

• types.ts — Interfaces for all models, enums (union types), type declarations
• schema.ts — API schema for binary transport
• client.ts — Typed methods with async/await