fix: accept semantic watch hmr output updates

Author: sonofmagic

packages/weapp-tailwindcss/test/watch-hmr-regression.unit.test.ts

@@ -46,6 +46,7 @@ import {
   waitForCompileSettled,
   waitForInitialWarmup,
   waitForOutputsReady,
+  waitForOutputsUpdated,
   waitForOutputFilesUpdated,
 } from '../../../tools/weapp-tailwindcss-scripts/src/watch-hmr-regression/mutations/shared'
 import {
@@ -342,6 +343,44 @@ describe('watch-hmr regression text helpers', () => {
     expect(attempts).toBeGreaterThanOrEqual(2)
   })
 
+  it('allows primary output update waits to pass via semantic fallback when mtimes stay unchanged', async () => {
+    const tempDir = await mkdtemp(path.join(os.tmpdir(), 'weapp-tw-watch-primary-output-update-'))
+    tempDirs.push(tempDir)
+    const wxmlFile = path.join(tempDir, 'index.wxml')
+    const jsFile = path.join(tempDir, 'index.js')
+    await writeFilePreserveEol(wxmlFile, '<view class="base"></view>', '<view />')
+    await writeFilePreserveEol(jsFile, 'Page({})', 'Page({})')
+    const baseline = {
+      wxml: await getMtime(wxmlFile),
+      js: await getMtime(jsFile),
+    }
+    let attempts = 0
+
+    const elapsed = await waitForOutputsUpdated(
+      {
+        label: 'demo/taro-vite-vue3-tailwindcss-v4',
+        outputWxml: wxmlFile,
+        outputJs: jsFile,
+      } as any,
+      baseline,
+      {
+        timeoutMs: 100,
+        pollMs: 1,
+      } as CliOptions,
+      {
+        ensureRunning() {},
+      } as any,
+      Date.now(),
+      async () => {
+        attempts += 1
+        return attempts >= 2
+      },
+    )
+
+    expect(elapsed).toBeGreaterThanOrEqual(0)
+    expect(attempts).toBeGreaterThanOrEqual(2)
+  })
+
   it('allows output file update waits to pass via semantic fallback when optional exact files are missing', async () => {
     const tempDir = await mkdtemp(path.join(os.tmpdir(), 'weapp-tw-watch-output-missing-'))
     tempDirs.push(tempDir)

tools/weapp-tailwindcss-scripts/src/watch-hmr-regression/mutations/class.ts

@@ -556,6 +556,23 @@ export async function runClassMutation(
             options,
             session,
             hotUpdateStartedAt,
+            async () => {
+              const outputs = await loadRoundOutputsSafe(watchCase, globalStyleOutputs)
+              assertRoundOutputs(
+                watchCase,
+                mutationKind,
+                sourcePath,
+                'add',
+                mutation,
+                verifyClassLiteralIn,
+                forbidBgHexTruncationIn,
+                minRequiredGlobalStyleEscapedClasses,
+                classTokens,
+                escapedClasses,
+                outputs,
+              )
+              return true
+            },
           )
       const hotUpdateEffectiveMs = isContentMutation
         ? hotUpdateOutputMs
@@ -713,6 +730,23 @@ export async function runClassMutation(
               options,
               session,
               modifyStartedAt,
+              async () => {
+                const outputs = await loadRoundOutputsSafe(watchCase, globalStyleOutputs)
+                assertRoundOutputs(
+                  watchCase,
+                  mutationKind,
+                  sourcePath,
+                  'modify',
+                  mutation,
+                  verifyClassLiteralIn,
+                  forbidBgHexTruncationIn,
+                  minRequiredGlobalStyleEscapedClasses,
+                  modifyClassTokens,
+                  modifyEscapedClasses,
+                  outputs,
+                )
+                return true
+              },
             )
         const modifyEffectiveMs = isContentMutation
           ? modifyOutputMs
@@ -847,6 +881,15 @@ export async function runClassMutation(
             options,
             session,
             rollbackStartedAt,
+            async () => {
+              const outputs = await loadRoundOutputsSafe(watchCase, globalStyleOutputs)
+              if (!outputs.wxml || !outputs.js) {
+                return false
+              }
+              return !outputs.wxml.includes(effectiveMarker)
+                && !outputs.js.includes(effectiveMarker)
+                && !outputs.globalStyle.includes(effectiveMarker)
+            },
           )
       rollbackEffectiveMs = isContentMutation
         ? rollbackOutputMs

tools/weapp-tailwindcss-scripts/src/watch-hmr-regression/mutations/shared.ts

@@ -203,13 +203,30 @@ export async function waitForOutputsUpdated(
   options: CliOptions,
   session: WatchSession,
   startedAt = Date.now(),
+  acceptWhen?: () => Promise<boolean>,
 ) {
+  const acceptsSemanticOutput = async () => {
+    if (!acceptWhen) {
+      return false
+    }
+
+    try {
+      return await acceptWhen()
+    }
+    catch {
+      return false
+    }
+  }
+
   return waitFor(
     async () => {
       const [wxmlMtime, jsMtime] = await Promise.all([
         getMtime(watchCase.outputWxml),
         getMtime(watchCase.outputJs),
       ])
+      if (await acceptsSemanticOutput()) {
+        return true
+      }
       return wxmlMtime > baseline.wxml || jsMtime > baseline.js
     },
     {