Build tool plugin that compiles .as files during development. Works with Vite, Webpack, Rollup, Rolldown, esbuild, Rspack, and Farm via Unplugin.

Installation

pnpm add -D unplugin-atscript @atscript/typescript @atscript/core

Quick Start

// vite.config.ts
import atscript from 'unplugin-atscript/vite'
export default { plugins: [atscript()] }

// rollup.config.js
import atscript from 'unplugin-atscript/rollup'
export default { plugins: [atscript()] }

// webpack.config.js
const atscript = require('unplugin-atscript/webpack')
module.exports = { plugins: [atscript()] }

Also available: unplugin-atscript/esbuild, unplugin-atscript/rolldown, unplugin-atscript/rspack, unplugin-atscript/farm.

Options

Same options on every bundler entry:

| Option | Type | Default | Effect | | -------- | --------- | ------------------- | -------------------------------------------------------------------------------------- | | strict | boolean | true | Fail the build on parse/diagnostic errors. false = log errors but keep building. | | root | string | bundler root or cwd | Directory atscript.config.* is discovered from. Absolute, or relative to the cwd. |

Vite picks the root up automatically (from configResolved); other bundlers need root when the working directory is not the project root.

Features

• Universal bundler support via dedicated entry points
• Automatic atscript.config.* loading
• Strict validation — build fails on .as errors by default (strict: false to disable)
• Tree-shaking aware — marks non-mutating modules as side-effect-free
• On Vite, prebundles @atscript/typescript/utils so the first .as-backed route does not trigger a dep re-optimization reload
• Watch-safe in dev — a changed .as file is dropped from the document cache and every transitive .as import is registered as a watch file, so dependants are re-checked against the new definition on the next reload (esbuild excepted: unplugin has no watchChange for it, so under esbuild watch a changed .as import still needs a restart)

Documentation

• Build Setup Guide
• Full Documentation

License

MIT