// Package tw is kjol's native Go Tailwind v4 compiler.
//
// It lives on its own, not inside the bundler, because Tailwind is not a
// JavaScript concern. The bundler builds web/ (TSX, Solid, esbuild); the Tailwind
// engine only ever reads text and writes CSS, and the text it reads is just as
// likely to be Go — the gowasm kit authors its markup in Go and has no JS build at
// all. Burying the compiler in the bundler made every Go-only consumer drag a
// JavaScript bundler along for a CSS file.
//
// The scanner is language-agnostic: it pulls candidate class tokens out of any text
// file, so `class="flex gap-2"` in a .tsx and `vdom.Attr("class", "flex gap-2")` in
// a .go are found the same way.
//
// The engine itself is in tailwind.go — a from-scratch port of Tailwind v4's
// compiler. This file is the surface the rest of kjol calls.
package tw

import (
	"github.com/tdewolff/minify/v2"
	mincss "github.com/tdewolff/minify/v2/css"
)

var min *minify.M

func init() {
	min = minify.New()
	min.AddFunc("text/css", mincss.Minify)
}

// Scan extracts candidate utility class names from the files matched by patterns
// (globs, relative to baseDir). It reads text, not syntax: a candidate is any token
// that could plausibly be a class, and the compiler decides which ones actually are.
func Scan(baseDir string, patterns []string) []string {
	return scanSources(baseDir, patterns)
}

// Compile compiles a Tailwind entry stylesheet against a set of candidates, and
// returns the CSS along with how many utilities it emitted (useful for a build log —
// a sudden drop usually means the scanner stopped seeing a source tree).
//
// entryCSS is the stylesheet source: typically `@import "tailwindcss";` plus an
// `@theme { … }` block. Anything else in it — @font-face, plain rules — passes
// through untouched.
func Compile(entryCSS, baseDir string, candidates []string) (css string, utilities int, err error) {
	return twCompile(entryCSS, baseDir, candidates)
}

// CompileFiles is Scan + Compile + minify: the whole job, for a caller that just
// wants CSS out of a stylesheet and some source globs.
func CompileFiles(entryCSS, baseDir string, sourceGlobs []string) (string, error) {
	compiled, _, err := twCompile(entryCSS, baseDir, scanSources(baseDir, sourceGlobs))
	if err != nil {
		return "", err
	}
	return Minify(compiled)
}

// Minify shrinks compiled CSS.
func Minify(css string) (string, error) { return min.String("text/css", css) }
