Source: static.go in package golang.org/x/pkgsite/internal/static

Package static builds static assets for the frontend and the worker.

package static

import (
	"fmt"
	"io/ioutil"
	"strings"

	"github.com/evanw/esbuild/pkg/api"
)

type Config struct {
	StaticPath string
	Watch      bool
	Write      bool
	Bundle     bool
}

Build compiles TypeScript files into minified JavaScript files using github.com/evanw/esbuild. When run with watch=true sourcemaps are placed inline, the output is unminified, and changes to any TypeScript files will force a rebuild of the JavaScript output. This function is used in Server.staticHandler with watch=true when cmd/frontend is run in dev mode and in devtools/cmd/static/main.go with watch=false for building productionized assets.

func Build(config Config) (*api.BuildResult, error) {
	var entryPoints []string
	scriptDir := config.StaticPath
	files, err := ioutil.ReadDir(scriptDir)
	if err != nil {
		return nil, err
	}
	for _, v := range files {
		if strings.HasSuffix(v.Name(), ".ts") && !strings.HasSuffix(v.Name(), ".test.ts") {
			entryPoints = append(entryPoints, scriptDir+"/"+v.Name())
		}
	}
	options := api.BuildOptions{
		EntryPoints: entryPoints,
		Outdir:      scriptDir,
		Write:       config.Write,
		Bundle:      config.Bundle,
	}
	if config.Watch {
		options.Sourcemap = api.SourceMapInline
		options.Watch = &api.WatchMode{}
	} else {
		options.MinifyIdentifiers = true
		options.MinifySyntax = true
		options.MinifyWhitespace = true
		options.Sourcemap = api.SourceMapLinked
	}
	result := api.Build(options)
	if len(result.Errors) > 0 {
		return nil, fmt.Errorf("error building static files: %v", result.Errors)
	}
	if len(result.Warnings) > 0 {
		return nil, fmt.Errorf("error building static files: %v", result.Warnings)
	}
	return &result, nil