feat(engine): export bundled htmlparser2

Author: sonofmagic

.changeset/export-engine-htmlparser2.md

@@ -0,0 +1,8 @@
+---
+"@tailwindcss-mangle/engine": patch
+"@tailwindcss-mangle/core": patch
+---
+
+Export the bundled htmlparser2 API from `@tailwindcss-mangle/engine/htmlparser2` for packages that need the same Node.js 18-compatible parser entry.
+
+Switch core HTML parsing to the engine-provided htmlparser2 entry instead of depending on htmlparser2 directly.

packages/core/package.json

@@ -68,11 +68,11 @@
     "@babel/traverse": "^7.29.7",
     "@babel/types": "^7.29.7",
     "@tailwindcss-mangle/config": "workspace:^",
+    "@tailwindcss-mangle/engine": "workspace:^",
     "@tailwindcss-mangle/shared": "workspace:^",
     "@vue/compiler-sfc": "^3.5.38",
     "fast-sort": "^3.4.1",
     "fs-extra": "^11.3.5",
-    "htmlparser2": "12.0.0",
     "magic-string": "^0.30.21",
     "parse5": "^8.0.1",
     "pathe": "^2.0.3",

packages/core/src/html/index.ts

@@ -1,5 +1,5 @@
 import type { IHandlerTransformResult, IHtmlHandlerOptions } from '../types'
-import { Parser } from 'htmlparser2'
+import { Parser } from '@tailwindcss-mangle/engine/htmlparser2'
 import MagicString from 'magic-string'
 import { makeRegex, splitCode } from '../shared'
 

packages/engine/package.json

@@ -27,6 +27,21 @@
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
     },
+    "./htmlparser2": {
+      "types": "./dist/htmlparser2.d.ts",
+      "import": "./dist/htmlparser2.js",
+      "require": "./dist/htmlparser2.cjs"
+    },
+    "./htmlparser2/WritableStream": {
+      "types": "./dist/htmlparser2/WritableStream.d.ts",
+      "import": "./dist/htmlparser2/WritableStream.js",
+      "require": "./dist/htmlparser2/WritableStream.cjs"
+    },
+    "./htmlparser2/WebWritableStream": {
+      "types": "./dist/htmlparser2/WebWritableStream.d.ts",
+      "import": "./dist/htmlparser2/WebWritableStream.js",
+      "require": "./dist/htmlparser2/WebWritableStream.cjs"
+    },
     "./v3": {
       "types": "./dist/v3/index.d.ts",
       "import": "./dist/v3/index.js",
@@ -43,6 +58,15 @@
   "types": "./dist/index.d.ts",
   "typesVersions": {
     "*": {
+      "htmlparser2": [
+        "./dist/htmlparser2.d.ts"
+      ],
+      "htmlparser2/WritableStream": [
+        "./dist/htmlparser2/WritableStream.d.ts"
+      ],
+      "htmlparser2/WebWritableStream": [
+        "./dist/htmlparser2/WebWritableStream.d.ts"
+      ],
       "v3": [
         "./dist/v3/index.d.ts"
       ],
@@ -82,6 +106,21 @@
         "import": "./dist/index.js",
         "require": "./dist/index.cjs"
       },
+      "./htmlparser2": {
+        "types": "./dist/htmlparser2.d.ts",
+        "import": "./dist/htmlparser2.js",
+        "require": "./dist/htmlparser2.cjs"
+      },
+      "./htmlparser2/WritableStream": {
+        "types": "./dist/htmlparser2/WritableStream.d.ts",
+        "import": "./dist/htmlparser2/WritableStream.js",
+        "require": "./dist/htmlparser2/WritableStream.cjs"
+      },
+      "./htmlparser2/WebWritableStream": {
+        "types": "./dist/htmlparser2/WebWritableStream.d.ts",
+        "import": "./dist/htmlparser2/WebWritableStream.js",
+        "require": "./dist/htmlparser2/WebWritableStream.cjs"
+      },
       "./v3": {
         "types": "./dist/v3/index.d.ts",
         "import": "./dist/v3/index.js",

packages/engine/scripts/node18-smoke.mjs

@@ -13,6 +13,21 @@ if (!oxideCandidates.includes('text-red-500') || !oxideCandidates.includes('hove
 }
 
 const engine = await import('../dist/index.js')
+const { Parser } = await import('../dist/htmlparser2.js')
+let sawClassAttribute = false
+const parser = new Parser({
+  onattribute(name, value) {
+    sawClassAttribute ||= name === 'class' && value === 'text-red-500'
+  },
+})
+
+parser.write('<div class="text-red-500"></div>')
+parser.end()
+
+if (!sawClassAttribute) {
+  throw new Error('Unexpected htmlparser2 subpath export behavior')
+}
+
 const vueCandidates = await engine.extractSourceCandidatesWithPositions(
   '<template><div class="text-red-500 hover:bg-blue-500"></div></template>',
   'vue',

packages/engine/src/htmlparser2-web-writable-stream.ts

@@ -0,0 +1 @@
+export * from 'htmlparser2/WebWritableStream'

packages/engine/src/htmlparser2-writable-stream.ts

@@ -0,0 +1 @@
+export * from 'htmlparser2/WritableStream'

packages/engine/src/htmlparser2.ts

@@ -0,0 +1 @@
+export * from 'htmlparser2'

packages/engine/test-d/public-api.test-d.ts

@@ -1,4 +1,5 @@
 import { expectAssignable, expectType } from 'tsd'
+import { Parser } from '../dist/htmlparser2'
 import {
   collectTailwindStyleCandidates,
   createTailwindV4Engine,
@@ -13,6 +14,7 @@ import {
   type TailwindV4GenerateResult,
 } from '../dist/index'
 
+expectAssignable<typeof Parser>(Parser)
 expectType<string[]>(splitCandidateTokens('text-red-500'))
 expectType<Promise<string[]>>(extractSourceCandidates('<div class="text-red-500"></div>', 'html'))
 expectType<Promise<Array<{ rawCandidate: string, start: number, end: number }>>>(

packages/engine/tsdown.config.ts

@@ -3,6 +3,9 @@ import { defineConfig } from 'tsdown'
 export default defineConfig({
   entry: {
     'index': 'src/index.ts',
+    'htmlparser2': 'src/htmlparser2.ts',
+    'htmlparser2/WritableStream': 'src/htmlparser2-writable-stream.ts',
+    'htmlparser2/WebWritableStream': 'src/htmlparser2-web-writable-stream.ts',
     'v3/index': 'src/v3/index.ts',
     'v4/index': 'src/v4/index.ts',
   },