#tamer-plugin

Rsbuild plugin that loads tamer.config from the project and workspace packages, then applies nested plugins.

#Overview

• Reads tamer.config.json, tamer.config.ts, tamer.config.mjs, or tamer.config.js from project root
• Falls back to workspace packages and node_modules packages that export ./tamer.config
• Merges config; options passed to pluginTamer() override file config (except false to disable)
• Runs nested Rsbuild plugins from the merged config
• Supports standard Rspeedy asset imports, CSS url(), ?url, ?inline, and emits dist/tamer-assets.json

#Installation

t4l add tamer-plugin

#Usage

import { defineConfig } from '@lynx-js/rspeedy'
import { pluginReactLynx } from '@lynx-js/react-rsbuild-plugin'
import { pluginTamer } from '@tamer4lynx/tamer-plugin'

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

#API

#pluginTamer(options?)

pluginTamer(options?: TamerPluginOptions): RsbuildPlugin

TamerPluginOptions is Record<string, boolean | Record<string, unknown> | RsbuildPlugin>. Values can be:

• RsbuildPlugin — setup is called
• false — disables that key from file config
• Other — overrides file config for that key

#Assets

Rspeedy asset imports remain URL strings, so direct usage works across React, Vue-Lynx, and other Lynx bindings:

import logo from './assets/logo.png'

// React-Lynx example:
;<image src={logo} />

Use the optional shim when you want asset metadata:

import { Asset, resolveAssetSource } from '@tamer4lynx/tamer-plugin/assets'
import logo from './assets/logo.png'
import inlineLogo from './assets/logo.png?inline'

const logoAsset = Asset.fromModule(logo)
const inline = resolveAssetSource(inlineLogo)

pluginTamer() emits tamer-assets.json during build for diagnostics and preload metadata. t4l bundle / t4l build copies the full dist tree into native hosts, including static/; native loading is owned by tamer-host, tamer-dev-client, tamer-dev-app, and CLI-generated host templates.

#tamer.config format

Export an object (default or tamerDefaults) with keys such as:

• rsbuildConfig — partial Rsbuild config (e.g. source.preEntry)
• Plugin keys — e.g. tamerRouter for tamer-router's plugin

Example tamer.config.ts:

import { tamerRouterPlugin } from '@tamer4lynx/tamer-router'

export default {
  tamerRouter: tamerRouterPlugin({
    root: './src/pages',
    output: './src/generated/_generated_routes.tsx',
    layoutFilename: '_layout.tsx',
  }),
}