Nuglify

module Nuglify


Assembly	`Nacara.Plugin.Assets.Nuglify`
Attributes	`[<RequireQualifiedAccess>]`

Minifies what a site writes: its HTML, its JavaScript, its CSS.

One registration per format, so ask for the ones you want:

Site.create "My library"
|> Nuglify.minifyHtml
|> Nuglify.minifyJs
|> LightningCss.register   // the CSS, from a tool that also compiles it

Each touches its own format: minifying the HTML leaves style and script as it found them. Nothing is downloaded, and a file that cannot be parsed is written as it was and reported as a warning.

Functions and values

css (options: NuglifyCssOptions) (content: string) : Result<string,string>

Minify one stylesheet, or say why it could not be.

This minifies and stops there. LightningCss also compiles - nesting flattened, color-mix() computed, prefixes added for the browsers you name - so a site written in modern CSS wants that one instead. Register one or the other, never both.

Parameter
`options`	What the site asked for.
`content`	The stylesheet as it would have been written.

cssDefaults: NuglifyCssOptions

cssKeepLicenceComments (value: bool) (options: NuglifyCssOptions) : NuglifyCssOptions

Keep /*! … */ comments, where a licence lives.

Parameter
`value`	The value to use.
`options`	The options so far.

cssMinifyWhileWatching (value: bool) (options: NuglifyCssOptions) : NuglifyCssOptions

Minify while watching too.

Parameter
`value`	The value to use.
`options`	The options so far.

html (options: NuglifyHtmlOptions) (content: string) : Result<string,string>

Minify one document, or say why it could not be.

Parameter
`options`	What the site asked for.
`content`	The document as it would have been written.

htmlCollapseWhitespace (value: bool) (options: NuglifyHtmlOptions) : NuglifyHtmlOptions

Collapse runs of whitespace between elements.

Parameter
`value`	The value to use.
`options`	The options so far.

htmlDefaults: NuglifyHtmlOptions

htmlKeepOneSpace (value: bool) (options: NuglifyHtmlOptions) : NuglifyHtmlOptions

Leave one space where a run of whitespace was, so nothing the reader sees moves.

Parameter
`value`	The value to use.
`options`	The options so far.

htmlMinifyWhileWatching (value: bool) (options: NuglifyHtmlOptions) : NuglifyHtmlOptions

Minify while watching too.

Parameter
`value`	The value to use.
`options`	The options so far.

htmlRemoveAttributeQuotes (value: bool) (options: NuglifyHtmlOptions) : NuglifyHtmlOptions

Remove quotes from attribute values that do not need them.

Parameter
`value`	The value to use.
`options`	The options so far.

htmlRemoveComments (value: bool) (options: NuglifyHtmlOptions) : NuglifyHtmlOptions

Remove HTML comments.

Parameter
`value`	The value to use.
`options`	The options so far.

htmlRemoveOptionalTags (value: bool) (options: NuglifyHtmlOptions) : NuglifyHtmlOptions

Remove end tags HTML5 says are optional - </body>, </li>.

Parameter
`value`	The value to use.
`options`	The options so far.

js (options: NuglifyJsOptions) (content: string) : Result<string,string>

Minify one script, or say why it could not be.

Parameter
`options`	What the site asked for.
`content`	The script as it would have been written.

jsDefaults: NuglifyJsOptions

jsKeepLicenceComments (value: bool) (options: NuglifyJsOptions) : NuglifyJsOptions

Keep comments marked as important, the /*! … */ kind.

Parameter
`value`	The value to use.
`options`	The options so far.

jsMinifyWhileWatching (value: bool) (options: NuglifyJsOptions) : NuglifyJsOptions

Minify while watching too.

Parameter
`value`	The value to use.
`options`	The options so far.

jsShortenNames (value: bool) (options: NuglifyJsOptions) : NuglifyJsOptions

Shorten the names of local variables.

Parameter
`value`	The value to use.
`options`	The options so far.

minifyCss (site: Site) : Site

Minify the site's CSS.

Use this or LightningCss.register, not both.

Parameter
`site`	The site you are describing.

minifyCssWith (configure: NuglifyCssOptions -> NuglifyCssOptions) (site: Site) : Site

Minify the site's CSS, configured.

Parameter
`configure`	Given the defaults, the options to use.
`site`	The site you are describing.

minifyHtml (site: Site) : Site

Minify the site's HTML.

Parameter
`site`	The site you are describing.

minifyHtmlWith (configure: NuglifyHtmlOptions -> NuglifyHtmlOptions) (site: Site) : Site

Minify the site's HTML, configured.

Parameter
`configure`	Given the defaults, the options to use.
`site`	The site you are describing.

minifyJs (site: Site) : Site

Minify the site's JavaScript.

Parameter
`site`	The site you are describing.

minifyJsWith (configure: NuglifyJsOptions -> NuglifyJsOptions) (site: Site) : Site

Minify the site's JavaScript, configured.

Parameter
`configure`	Given the defaults, the options to use.
`site`	The site you are describing.