Volt.CSS.AssetURLRewriter (Volt v0.14.3)

Parser-backed CSS asset URL rewriting for production builds.

Uses Vize/LightningCSS to collect parser-backed URL ranges, then patches the original source without round-tripping through the serialized CSS AST.

Summary

rewrite_result()

Rewrite relative CSS asset URLs to hashed output URLs.

Rewrite relative CSS asset URLs to dev-server URLs without copying files.

Rewrite relative CSS asset URLs and return emitted asset filenames.

@type rewrite_assets_result() ::
  {:ok, %{code: String.t(), assets: [String.t() | map()]}} | {:error, term()}

@type rewrite_result() :: {:ok, String.t()} | {:error, term()}

@spec rewrite(String.t(), String.t() | nil, String.t(), keyword()) :: rewrite_result()

Rewrite relative CSS asset URLs to hashed output URLs.

@spec rewrite_dev(String.t(), String.t() | nil, String.t(), String.t()) ::
  rewrite_result()

Rewrite relative CSS asset URLs to dev-server URLs without copying files.

@spec rewrite_with_assets(String.t(), String.t() | nil, String.t(), keyword()) ::
  rewrite_assets_result()

Rewrite relative CSS asset URLs and return emitted asset filenames.