@master/css-compiler

The ahead-of-time compiler of Master CSS

Usage

npm install @master/css-compiler

const compiler = await new MasterCSSCompiler()

Options

{
    // specify virtual CSS module id (e.g. virtual:master.css)
    module: 'master.css',
    // specify config file path or set `Config`
    config: 'master.css.{ts,js,mjs,cjs}',
    // forcibly specify sources for scanning, not excluded by `options.exclude`
    sources: [],
    // specify sources for scanning
    include: ['**/*.{html,js,jsx,ts,tsx,svelte,astro,vue,md,mdx,pug,php}'],
    // specify sources to exclude
    exclude: [
        '**/node_modules/**',
        '**/*.d.ts',
        '**/*.test.*',
        'node_modules',
        'master.css.{js,ts,mjs,cjs}',
        'dist',
        'out',
        'README.md'
    ],
    classes: {
        // whitelist of class names for unpredictable dynamics
        fixed: [],
        // blacklist of class names to exclude accidentally captured
        ignored: []  // or RegExp[]
    },
    cwd: process.cwd()
}

Methods

// Reload the compiler and MasterCSS
refresh(): this

// Scan sources, extract class names, and generate CSS rules
compile()

// Extract potential class names from the given file content
extract(name: string, content: string): string[]

// `extract(name, content)`, insert extractions, and generate CSS rules
insert(name: string, content: string): boolean

// Read file source paths by `options.include` and `options.exclude`
get sources(): string[]

// Check source file path by `options.include` and `options.exclude`
checkSourcePath(name: string): boolean

// Read user config file by `options.config`
readConfig(): Config

// Get user config path
get configPath(): string

// Get resolved user config path
get resolvedConfigPath(): string

Properties

export default class MasterCSSCompiler {
    css: MasterCSS
    extractions = new Set<string>()
    ...
}