Registry / web-framework / esbuild-minify-templates

esbuild-minify-templates

library0.13.1jsnpmunverified

A plugin for esbuild that minifies template literal strings by collapsing whitespace and removing whitespace around HTML tags. Version 0.13.1 is current; it supports node >=12 and requires esbuild >=0.13.0 <1.0.0 as a peer dependency. Features include source map support, the ability to ignore specific template literals with a comment, and options like `keepComments` (preserve HTML comments) and `taggedOnly` (minify only tagged templates). It ships TypeScript types. Unlike other minifiers, it works as two esbuild plugins that require the `write` option to be `false`, writing output files via a separate `writeFiles()` plugin.

web-framework http-networking

npm install esbuild-minify-templates

github ↗package ↗

INSTALL

IMPORT

SIG · ESBUILD-MINIFY-TEM

esbuild-minify-templates

web-frameworkjavascriptv0.13.1

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–223 runs

build_error

glibc

node 18–223 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

minifyTemplates

✓ import { minifyTemplates } from 'esbuild-minify-templates'

✗ const minifyTemplates = require('esbuild-minify-templates')

ESM-only package; CommonJS require will fail. Use dynamic import or switch to ESM.

writeFiles

✓ import { writeFiles } from 'esbuild-minify-templates'

✗ import writeFiles from 'esbuild-minify-templates'

writeFiles is a named export, not a default export. CommonJS require is also incorrect.

default import (none)

✓ no default export exists; always use named imports.

✗ import MinifyTemplates from 'esbuild-minify-templates'

This package has no default export. Attempting a default import will result in undefined at runtime.

Demonstrates the essential setup: import the two plugins, add them to the esbuild plugins array, and set write to false.

import esbuild from 'esbuild'; import { minifyTemplates, writeFiles } from 'esbuild-minify-templates'; await esbuild.build({ entryPoints: ['src/index.ts'], outfile: 'dist/index.js', plugins: [minifyTemplates(), writeFiles()], bundle: true, sourcemap: true, write: false, // important! });

Debug

Known issues

breakingThe write option must be false to use esbuild-minify-templates.

fix

Set esbuild build option 'write' to false.

affects: >=0.1.0

gotchawriteFiles() must be included and placed after plugins that modify output.

fix

Add writeFiles() to plugins list after minifyTemplates() and any other output-modifying plugins.

affects: >=0.1.0

deprecatedThis package is ESM-only; CommonJS require() will not work.

fix

Use import syntax or switch to ES modules in your project.

affects: >=0.12.0

gotchaIgnoring a template literal requires a /*! minify-templates-ignore */ comment on the line directly before it; esbuild's minify and legalComments options must be set appropriately.

fix

Set esbuild 'minify' to false and 'legalComments' to 'inline' for the ignore comment to work.

affects: >=0.1.0

Errors

Common errors & fixes

Error: Cannot find module 'esbuild-minify-templates'

CommonJS require used in an ESM-only package.

fix

Use import syntax: import { minifyTemplates } from 'esbuild-minify-templates';

TypeError: writeFiles is not a function

Default import instead of named import.

fix

Use named import: import { writeFiles } from 'esbuild-minify-templates';

Error: Build failed with 1 error: error: Cannot access 'write' before initialization

write option not set to false before build.

fix

Set the esbuild build option 'write' to false.

Upgrade

Version history

0.13.1latest on npm

Audit

Dependencies

esbuildrequiredPeer dependency; the plugins hook into esbuild's build process and require esbuild >=0.13.0 <1.0.0.

Agent activity

12 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/maxmilton/esbuild-minify-templates ↗

packagehttps://www.npmjs.com/package/esbuild-minify-templates ↗