@csszyx/unplugin 0.17.0 → 0.17.1

package/dist/index.cjs

@@ -3,8 +3,8 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 const cssMangler = require('./css-mangler.cjs');
-const unplugin = require('./shared/unplugin.9zs6T4Gf.cjs');
-const themeGroupsFile = require('./shared/unplugin.2qOISpzl.cjs');
+const unplugin = require('./shared/unplugin.DZdsqdQa.cjs');
+const themeGroupsFile = require('./shared/unplugin.D0tMgokL.cjs');
 const types = require('@csszyx/types');
 const safelistSource = require('./shared/unplugin.DS6CFjim.cjs');
 require('postcss');
@@ -25,6 +25,14 @@ require('./shared/unplugin.YcnV3Izb.cjs');
 require('./shared/unplugin.BqKLlo1h.cjs');
 require('./shared/unplugin.Defu9wGh.cjs');
 require('node:zlib');
+require('node:fs/promises');
+require('os');
+require('path');
+require('util');
+require('stream');
+require('events');
+require('fs');
+require('@csszyx/runtime/split');
 require('postcss-value-parser');
 
 

package/dist/index.mjs

@@ -1,6 +1,6 @@
 export { classAttributeSelectorKey, createPostCSSPlugin, escapeCSSClassName, mangleCSS, mangleCSSSync, unescapeTailwindClass } from './css-mangler.mjs';
-export { a as allocateMangleTokens, b as assertNoRSCBoundaryViolation, c as assertNoRSCGraphViolation, d as collectMangleHybridHazards, e as createGlobalVarAliasValidationOptions, f as createGlobalVarMapAssetSource, g as createGlobalVarScanCacheKey, h as createRSCModuleRecord, i as cssHasContentScope, u as default, j as deleteRSCModuleRecord, k as emitKeyValueDiagnostic, l as emitMissingCssFallback, m as esbuildPlugin, n as extractGlobalVarAliasesForManifest, o as fileMayContainSafelistableSz, p as findLocalImportSources, q as findRSCBoundaryViolation, r as findRSCGraphViolation, s as hasInjectableTailwindCandidate, t as hasUseClientDirective, v as hasUseServerDirective, w as isAdvisoryDiagnostic, x as isCompileSourceOptedIn, y as isHardIgnoredPath, z as isMangleableCssId, A as isMonorepoPackage, B as isPackagesSkippedSource, C as isRSCServerModule, D as isTailwindReservedGlobalVar, E as lateMangleCensusMessage, F as mangleCodeClassesSync, G as mangleEligibleClasses, H as mangleHybridHazardMessage, I as missingTailwindEntryMessage, J as normalizeGlobalVarAliasesForCache, K as planGlobalVarAliases, L as readGlobalVarScanCache, M as realContentHashDisabledMessage, N as recordGlobalVarSourceFile, O as resolveCompileSourceDirs, P as resolveGlobalVarScanCacheDir, Q as resolveNativeCacheIdentity, R as resolveQuietMode, S as rewriteGlobalVarCssAliases, T as rollupPlugin, U as scanGlobalVarCss, V as shouldEmitMissingCssFallback, W as shouldEmitWarning, X as shouldHoldAdvisories, Y as shouldTrackGlobalVarSources, Z as shouldWarnMissingTailwindEntry, _ as shouldWarnUnscopedMonorepo, $ as skippedSzFilesMessage, a0 as suppressedAdvisoryMessage, u as unplugin, a1 as unscopedMonorepoMessage, a2 as validateGlobalVarAliasInputs, a3 as vitePlugin, a4 as watchModeMangleMessage, a5 as webpackPlugin, a6 as writeGlobalVarScanCache } from './shared/unplugin.Cs4H9z9v.mjs';
-export { h as hasTokens, m as mergeThemes, p as parseThemeBlocks, a as parseUtilityBlocks, s as scanCustomPropertyNames } from './shared/unplugin.995yC_cN.mjs';
+export { a as allocateMangleTokens, b as assertNoRSCBoundaryViolation, c as assertNoRSCGraphViolation, d as collectMangleHybridHazards, e as createGlobalVarAliasValidationOptions, f as createGlobalVarMapAssetSource, g as createGlobalVarScanCacheKey, h as createRSCModuleRecord, i as cssHasContentScope, u as default, j as deleteRSCModuleRecord, k as emitKeyValueDiagnostic, l as emitMissingCssFallback, m as esbuildPlugin, n as extractGlobalVarAliasesForManifest, o as fileMayContainSafelistableSz, p as findLocalImportSources, q as findRSCBoundaryViolation, r as findRSCGraphViolation, s as hasInjectableTailwindCandidate, t as hasUseClientDirective, v as hasUseServerDirective, w as isAdvisoryDiagnostic, x as isCompileSourceOptedIn, y as isHardIgnoredPath, z as isMangleableCssId, A as isMonorepoPackage, B as isPackagesSkippedSource, C as isRSCServerModule, D as isTailwindReservedGlobalVar, E as lateMangleCensusMessage, F as mangleCodeClassesSync, G as mangleEligibleClasses, H as mangleHybridHazardMessage, I as missingTailwindEntryMessage, J as normalizeGlobalVarAliasesForCache, K as planGlobalVarAliases, L as readGlobalVarScanCache, M as realContentHashDisabledMessage, N as recordGlobalVarSourceFile, O as resolveCompileSourceDirs, P as resolveGlobalVarScanCacheDir, Q as resolveNativeCacheIdentity, R as resolveQuietMode, S as rewriteGlobalVarCssAliases, T as rollupPlugin, U as scanGlobalVarCss, V as shouldEmitMissingCssFallback, W as shouldEmitWarning, X as shouldHoldAdvisories, Y as shouldTrackGlobalVarSources, Z as shouldWarnMissingTailwindEntry, _ as shouldWarnUnscopedMonorepo, $ as skippedSzFilesMessage, a0 as suppressedAdvisoryMessage, u as unplugin, a1 as unscopedMonorepoMessage, a2 as validateGlobalVarAliasInputs, a3 as vitePlugin, a4 as watchModeMangleMessage, a5 as webpackPlugin, a6 as writeGlobalVarScanCache } from './shared/unplugin.CcSfaIVx.mjs';
+export { h as hasTokens, m as mergeThemes, p as parseThemeBlocks, a as parseUtilityBlocks, s as scanCustomPropertyNames } from './shared/unplugin.CK-DfKTP.mjs';
 export { CSSZYX_GLOBAL_ALIAS_PREFIX, TAILWIND_RESERVED_PREFIXES } from '@csszyx/types';
 export { S as SAFELIST_FILE, a as appendTailwindSourceDirective, c as computeSafelistRelPath, b as cssImportsTailwind } from './shared/unplugin.Ba3O1r8M.mjs';
 import 'postcss';
@@ -21,4 +21,12 @@ import './shared/unplugin.2uf-U76p.mjs';
 import './shared/unplugin.wMeicb6E.mjs';
 import './shared/unplugin.DcXM9sq5.mjs';
 import 'node:zlib';
+import 'node:fs/promises';
+import 'os';
+import 'path';
+import 'util';
+import 'stream';
+import 'events';
+import 'fs';
+import '@csszyx/runtime/split';
 import 'postcss-value-parser';

package/dist/next-prebuild.cjs

@@ -4,7 +4,7 @@ const node_crypto = require('node:crypto');
 const fs = require('node:fs');
 const path = require('node:path');
 const nextTransformMetadata = require('./shared/unplugin.DXzIP7lP.cjs');
-const nextWatcherCycle = require('./shared/unplugin.alhYXymJ.cjs');
+const nextWatcherCycle = require('./shared/unplugin.BKID6KXV.cjs');
 const pathNormalization = require('./shared/unplugin.BqKLlo1h.cjs');
 const safelistSource = require('./shared/unplugin.DS6CFjim.cjs');
 const transformCache = require('./shared/unplugin.YcnV3Izb.cjs');
@@ -104,7 +104,7 @@ function runNextPrebuild(options) {
     lockOptions: {
       root: context.root,
       mode: context.manifestExpectation.mode,
-      command: "csszyx next prebuild"
+      command: options.lockCommand ?? nextWatcherCycle.NEXT_PREBUILD_LOCK_COMMAND
     },
     createdAt: options.createdAt
   });

package/dist/next-prebuild.d.cts

@@ -1,7 +1,7 @@
 import { TransformSourceCodeOptions } from '@csszyx/compiler';
-import { J as JsonLike, A as AtomicWriteOptions, N as NextStateContext } from './shared/unplugin.BGog1Bib.cjs';
+import { J as JsonLike, A as AtomicWriteOptions, N as NextStateContext } from './shared/unplugin.XdPo6azz.cjs';
 import { N as NextSourceTransformOutput, a as NextSourceParserMode } from './shared/unplugin.B32Exn-K.cjs';
-import { N as NextWatcherCycleResult } from './shared/unplugin.rWOMecQs.cjs';
+import { N as NextWatcherCycleResult } from './shared/unplugin.C_2R8vIk.cjs';
 
 /** Serializable options accepted by the Next Turbopack csszyx prebuild core. */
 interface NextPrebuildOptions {
@@ -35,6 +35,16 @@ interface NextPrebuildOptions {
     allowProductionMangling?: boolean;
     writeOptions?: AtomicWriteOptions;
     createdAt?: string;
+    /**
+     * What this pass records on the state lock; `csszyx next prebuild` by
+     * default.
+     *
+     * The Turbopack loader steps aside only for a watcher's command. `next
+     * watch` passes that command here because its initial cycle follows this
+     * pass and reads every shard the loader wrote meanwhile. A standalone
+     * prebuild keeps the default: nothing after it would pick those shards up.
+     */
+    lockCommand?: string;
 }
 /** Per-file result captured by one prebuild pass. */
 interface NextPrebuildFileResult {

package/dist/next-prebuild.d.mts

@@ -1,7 +1,7 @@
 import { TransformSourceCodeOptions } from '@csszyx/compiler';
-import { J as JsonLike, A as AtomicWriteOptions, N as NextStateContext } from './shared/unplugin.BGog1Bib.mjs';
+import { J as JsonLike, A as AtomicWriteOptions, N as NextStateContext } from './shared/unplugin.XdPo6azz.mjs';
 import { N as NextSourceTransformOutput, a as NextSourceParserMode } from './shared/unplugin.B32Exn-K.mjs';
-import { N as NextWatcherCycleResult } from './shared/unplugin.COlI0dJs.mjs';
+import { N as NextWatcherCycleResult } from './shared/unplugin.CfXjAV63.mjs';
 
 /** Serializable options accepted by the Next Turbopack csszyx prebuild core. */
 interface NextPrebuildOptions {
@@ -35,6 +35,16 @@ interface NextPrebuildOptions {
     allowProductionMangling?: boolean;
     writeOptions?: AtomicWriteOptions;
     createdAt?: string;
+    /**
+     * What this pass records on the state lock; `csszyx next prebuild` by
+     * default.
+     *
+     * The Turbopack loader steps aside only for a watcher's command. `next
+     * watch` passes that command here because its initial cycle follows this
+     * pass and reads every shard the loader wrote meanwhile. A standalone
+     * prebuild keeps the default: nothing after it would pick those shards up.
+     */
+    lockCommand?: string;
 }
 /** Per-file result captured by one prebuild pass. */
 interface NextPrebuildFileResult {

package/dist/next-prebuild.mjs

@@ -2,7 +2,7 @@ import { createHash } from 'node:crypto';
 import { existsSync, readFileSync } from 'node:fs';
 import * as path from 'node:path';
 import { r as readPackageVersion, c as configWithImportedStaticSz, a as resolveNextCrossModule, t as transformNextSource, w as withCrossModuleStatics, b as collectNextTransformMetadata, d as createNextSafelistShardFromMetadata } from './shared/unplugin.C3bgc29e.mjs';
-import { c as createNextStateContext, w as writeNextSafelistShard, r as runNextWatcherCycle } from './shared/unplugin.DPSQP5XG.mjs';
+import { c as createNextStateContext, w as writeNextSafelistShard, r as runNextWatcherCycle, N as NEXT_PREBUILD_LOCK_COMMAND } from './shared/unplugin.eCo7_znv.mjs';
 import { n as normalizePathSeparators } from './shared/unplugin.wMeicb6E.mjs';
 import { f as findPostcssConfigWithoutCsszyx, m as missingPostcssPluginMessage } from './shared/unplugin.Ba3O1r8M.mjs';
 import { r as resolveTransformCacheDir } from './shared/unplugin.2uf-U76p.mjs';
@@ -87,7 +87,7 @@ function runNextPrebuild(options) {
     lockOptions: {
       root: context.root,
       mode: context.manifestExpectation.mode,
-      command: "csszyx next prebuild"
+      command: options.lockCommand ?? NEXT_PREBUILD_LOCK_COMMAND
     },
     createdAt: options.createdAt
   });

package/dist/next-turbo-loader.cjs

@@ -6,9 +6,9 @@ const node_crypto = require('node:crypto');
 const path = require('node:path');
 const nextRuntimeInjection = require('./shared/unplugin.Defu9wGh.cjs');
 const nextTransformMetadata = require('./shared/unplugin.DXzIP7lP.cjs');
-const nextWatcherCycle = require('./shared/unplugin.alhYXymJ.cjs');
+const nextWatcherCycle = require('./shared/unplugin.BKID6KXV.cjs');
 const pathNormalization = require('./shared/unplugin.BqKLlo1h.cjs');
-const themeGroupsFile = require('./shared/unplugin.2qOISpzl.cjs');
+const themeGroupsFile = require('./shared/unplugin.D0tMgokL.cjs');
 const transformCache = require('./shared/unplugin.YcnV3Izb.cjs');
 require('node:fs');
 require('@csszyx/compiler');
@@ -100,7 +100,7 @@ function runNextTurboLoader(source, loaderContext, explicitOptions = {}) {
         lockOptions: {
           root: context.root,
           mode: context.manifestExpectation.mode,
-          command: "csszyx next turbo-loader"
+          command: nextWatcherCycle.NEXT_TURBO_LOADER_LOCK_COMMAND
         }
       });
       materialized = true;

package/dist/next-turbo-loader.d.cts

@@ -1,5 +1,5 @@
 import { TransformSourceCodeOptions } from '@csszyx/compiler';
-import { J as JsonLike, A as AtomicWriteOptions, N as NextStateContext } from './shared/unplugin.BGog1Bib.cjs';
+import { J as JsonLike, A as AtomicWriteOptions, N as NextStateContext } from './shared/unplugin.XdPo6azz.cjs';
 import { a as NextSourceParserMode, N as NextSourceTransformOutput } from './shared/unplugin.B32Exn-K.cjs';
 
 /** Serializable options accepted by the Next Turbopack csszyx loader. */

package/dist/next-turbo-loader.d.mts

@@ -1,5 +1,5 @@
 import { TransformSourceCodeOptions } from '@csszyx/compiler';
-import { J as JsonLike, A as AtomicWriteOptions, N as NextStateContext } from './shared/unplugin.BGog1Bib.mjs';
+import { J as JsonLike, A as AtomicWriteOptions, N as NextStateContext } from './shared/unplugin.XdPo6azz.mjs';
 import { a as NextSourceParserMode, N as NextSourceTransformOutput } from './shared/unplugin.B32Exn-K.mjs';
 
 /** Serializable options accepted by the Next Turbopack csszyx loader. */

package/dist/next-turbo-loader.mjs

@@ -2,9 +2,9 @@ import { createHash } from 'node:crypto';
 import * as path from 'node:path';
 import { i as injectNextRuntimeImports, a as insertAfterUseDirective } from './shared/unplugin.DcXM9sq5.mjs';
 import { r as readPackageVersion, c as configWithImportedStaticSz, a as resolveNextCrossModule, t as transformNextSource, w as withCrossModuleStatics, n as normalizeProviderPaths, b as collectNextTransformMetadata, d as createNextSafelistShardFromMetadata } from './shared/unplugin.C3bgc29e.mjs';
-import { c as createNextStateContext, w as writeNextSafelistShard, r as runNextWatcherCycle, N as NextSafelistStateLockedError, a as NEXT_WATCH_LOCK_COMMAND, v as validateNextGenerationManifest, b as readNextGenerationManifest } from './shared/unplugin.DPSQP5XG.mjs';
+import { c as createNextStateContext, w as writeNextSafelistShard, r as runNextWatcherCycle, a as NEXT_TURBO_LOADER_LOCK_COMMAND, b as NextSafelistStateLockedError, d as NEXT_WATCH_LOCK_COMMAND, v as validateNextGenerationManifest, e as readNextGenerationManifest } from './shared/unplugin.eCo7_znv.mjs';
 import { n as normalizePathSeparators } from './shared/unplugin.wMeicb6E.mjs';
-import { e as ensureThemeGroupsFile, t as themeGroupsSpecifier } from './shared/unplugin.995yC_cN.mjs';
+import { e as ensureThemeGroupsFile, t as themeGroupsSpecifier } from './shared/unplugin.CK-DfKTP.mjs';
 import { r as resolveTransformCacheDir } from './shared/unplugin.2uf-U76p.mjs';
 import 'node:fs';
 import '@csszyx/compiler';
@@ -81,7 +81,7 @@ function runNextTurboLoader(source, loaderContext, explicitOptions = {}) {
         lockOptions: {
           root: context.root,
           mode: context.manifestExpectation.mode,
-          command: "csszyx next turbo-loader"
+          command: NEXT_TURBO_LOADER_LOCK_COMMAND
         }
       });
       materialized = true;

package/dist/next-watcher.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
 const path = require('node:path');
-const nextWatcherCycle = require('./shared/unplugin.alhYXymJ.cjs');
+const nextWatcherCycle = require('./shared/unplugin.BKID6KXV.cjs');
 require('node:fs');
 require('./shared/unplugin.DS6CFjim.cjs');
 require('node:crypto');
@@ -23,6 +23,12 @@ function _interopNamespaceCompat(e) {
 
 const path__namespace = /*#__PURE__*/_interopNamespaceCompat(path);
 
+const LOADER_LOCK_RETRY_MIN_MS = 50;
+const LOADER_LOCK_WARN_AFTER_MS = 1e3;
+const LOADER_LOCK_GIVE_UP_AFTER_MS = 6e4;
+function isHeldByTurbopackLoader(error) {
+  return error instanceof nextWatcherCycle.NextSafelistStateLockedError && error.holder.command === nextWatcherCycle.NEXT_TURBO_LOADER_LOCK_COMMAND;
+}
 class NextWatcherLoop {
   context;
   cycleOptions;
@@ -30,10 +36,15 @@ class NextWatcherLoop {
   runCycle;
   setTimeoutFn;
   clearTimeoutFn;
+  nowFn;
   onError;
+  onWarn;
   timer;
   disposed = false;
   pendingReasons = /* @__PURE__ */ new Set();
+  /** When the current wait on the loader's lock began; unset while not waiting. */
+  loaderWaitStartedAt;
+  loaderWaitWarned = false;
   lastResult;
   lastError;
   /**
@@ -47,7 +58,9 @@ class NextWatcherLoop {
     this.runCycle = options.runCycle ?? nextWatcherCycle.runNextWatcherCycle;
     this.setTimeoutFn = options.setTimeout ?? setTimeout;
     this.clearTimeoutFn = options.clearTimeout ?? clearTimeout;
+    this.nowFn = options.now ?? Date.now;
     this.onError = options.onError;
+    this.onWarn = options.onWarn;
   }
   /**
    *
@@ -70,17 +83,7 @@ class NextWatcherLoop {
       return;
     }
     this.pendingReasons.add(reason);
-    if (this.timer !== void 0) {
-      return;
-    }
-    this.timer = this.setTimeoutFn(() => {
-      try {
-        this.runPendingCycle();
-      } catch (error) {
-        this.lastError = error;
-        this.onError?.(error);
-      }
-    }, this.debounceMs);
+    this.schedule(this.debounceMs);
   }
   /**
    *
@@ -91,6 +94,32 @@ class NextWatcherLoop {
     }
     return this.runPendingCycle();
   }
+  /**
+   * Run the pending cycle now, or queue it when the Turbopack loader holds the
+   * lock.
+   *
+   * `flush` throws on every failure, which is what closing needs. Starting
+   * needs this instead: `next watch` and `next dev` start together, so the
+   * loader's first compile can hold the lock exactly when the initial cycle
+   * runs, and that overlap is not a failure.
+   *
+   * @returns The cycle result, or `undefined` when nothing was pending or the
+   *   cycle is queued behind the loader.
+   */
+  flushOrQueue() {
+    if (this.disposed || this.timer === void 0) {
+      return void 0;
+    }
+    const reasons = [...this.pendingReasons];
+    try {
+      return this.runPendingCycle();
+    } catch (error) {
+      if (this.waitForLoader(error, reasons)) {
+        return void 0;
+      }
+      throw error;
+    }
+  }
   /**
    *
    */
@@ -102,6 +131,75 @@ class NextWatcherLoop {
     this.pendingReasons.clear();
     this.disposed = true;
   }
+  /**
+   * Run the pending cycle after `delayMs`, unless a run is already scheduled.
+   *
+   * @param delayMs - How long to wait before running it.
+   */
+  schedule(delayMs) {
+    if (this.timer !== void 0) {
+      return;
+    }
+    this.timer = this.setTimeoutFn(() => {
+      const reasons = [...this.pendingReasons];
+      try {
+        this.runPendingCycle();
+      } catch (error) {
+        if (this.waitForLoader(error, reasons)) {
+          return;
+        }
+        this.lastError = error;
+        this.onError?.(error);
+      }
+    }, delayMs);
+  }
+  /**
+   * Queue a cycle again when it failed only because the Turbopack loader holds
+   * the lock.
+   *
+   * Retried, not dropped: the loader's pass read the shards as they stood when
+   * it began, and the event that woke this cycle may be newer. The wait is
+   * timed from the first refusal, says so once when it runs long, and ends in
+   * a reported failure when it runs longer than any live loader could explain.
+   *
+   * @param error - What the cycle threw.
+   * @param reasons - The reasons the failed cycle carried, queued again with it.
+   * @returns True when nothing should be reported: the cycle is queued, or the
+   *   loop was disposed meanwhile.
+   */
+  waitForLoader(error, reasons) {
+    if (!isHeldByTurbopackLoader(error)) {
+      return false;
+    }
+    const now = this.nowFn();
+    this.loaderWaitStartedAt ??= now;
+    const waited = now - this.loaderWaitStartedAt;
+    if (waited > LOADER_LOCK_GIVE_UP_AFTER_MS) {
+      this.endLoaderWait();
+      return false;
+    }
+    if (waited >= LOADER_LOCK_WARN_AFTER_MS && !this.loaderWaitWarned) {
+      this.loaderWaitWarned = true;
+      const warn = this.onWarn ?? (() => {
+      });
+      warn(
+        `[csszyx] next watch is waiting for the safelist lock held by the Turbopack loader (process ${error.holder.pid}). Classes added meanwhile get no CSS until it is released; a lock left by a loader that exited is recovered within 30 s.`
+      );
+    }
+    if (this.disposed) {
+      return true;
+    }
+    for (const reason of reasons) {
+      this.pendingReasons.add(reason);
+    }
+    this.schedule(Math.max(this.debounceMs, LOADER_LOCK_RETRY_MIN_MS));
+    return true;
+  }
+  /** Forget the current wait on the loader, once a cycle gets through or gives up. */
+  endLoaderWait() {
+    this.loaderWaitStartedAt = void 0;
+    this.loaderWaitWarned = false;
+  }
   /**
    *
    */
@@ -116,6 +214,7 @@ class NextWatcherLoop {
     const result = this.runCycle(this.context, this.cycleOptions, reasons);
     this.lastResult = result;
     this.lastError = void 0;
+    this.endLoaderWait();
     return result;
   }
 }
@@ -169,6 +268,14 @@ class NextSafelistWatcher {
   }
   /**
    * Materialize existing shards before accepting live filesystem events.
+   *
+   * `next watch` and `next dev` start together in the documented setup, so
+   * the Turbopack loader's first compile can hold the state lock at this
+   * exact moment. The initial cycle is then queued behind it instead of
+   * throwing, the same way a scheduled cycle waits.
+   *
+   * @returns The initial cycle's result, or `undefined` while it is queued
+   *   behind the Turbopack loader.
    */
   start() {
     if (this.closed) {
@@ -179,8 +286,8 @@ class NextSafelistWatcher {
     }
     this.started = true;
     this.loop.notify("initial");
-    const result = this.loop.flush();
-    if (!result) {
+    const result = this.loop.flushOrQueue();
+    if (!result && !this.loop.pending) {
       throw new Error("[csszyx] Next safelist watcher failed to run its initial cycle.");
     }
     return result;
@@ -234,6 +341,7 @@ class NextSafelistWatcher {
   }
 }
 
+exports.NEXT_WATCH_LOCK_COMMAND = nextWatcherCycle.NEXT_WATCH_LOCK_COMMAND;
 exports.NextSafelistWatcher = NextSafelistWatcher;
 exports.isNextAppSourcePath = isNextAppSourcePath;
 exports.isNextSafelistShardPath = isNextSafelistShardPath;

package/dist/next-watcher.d.cts

@@ -1,5 +1,6 @@
-import { N as NextStateContext } from './shared/unplugin.BGog1Bib.cjs';
-import { a as NextWatcherCycleOptions, N as NextWatcherCycleResult } from './shared/unplugin.rWOMecQs.cjs';
+import { N as NextStateContext } from './shared/unplugin.XdPo6azz.cjs';
+export { c as NEXT_WATCH_LOCK_COMMAND } from './shared/unplugin.XdPo6azz.cjs';
+import { a as NextWatcherCycleOptions, N as NextWatcherCycleResult } from './shared/unplugin.C_2R8vIk.cjs';
 
 /**
  *
@@ -11,6 +12,8 @@ type NextWatcherLoopCycleRunner = (context: NextStateContext, options: NextWatch
 interface NextWatcherLoopTimerHooks {
     setTimeout?: (callback: () => void, delayMs: number) => WatcherTimer;
     clearTimeout?: (timer: WatcherTimer) => void;
+    /** Clock that times a wait on the loader's lock; `Date.now` by default. */
+    now?: () => number;
 }
 
 /** Filesystem events that can change the materialized safelist. */
@@ -22,6 +25,8 @@ interface NextSafelistWatcherOptions extends NextWatcherLoopTimerHooks {
     debounceMs?: number;
     runCycle?: NextWatcherLoopCycleRunner;
     onError?: (error: unknown) => void;
+    /** Receives a notice the watcher keeps running through; dropped by default. */
+    onWarn?: (message: string) => void;
 }
 /**
  * Validate one watcher event path against the flat safelist shard directory.
@@ -75,8 +80,16 @@ declare class NextSafelistWatcher {
     get lastError(): unknown;
     /**
      * Materialize existing shards before accepting live filesystem events.
+     *
+     * `next watch` and `next dev` start together in the documented setup, so
+     * the Turbopack loader's first compile can hold the state lock at this
+     * exact moment. The initial cycle is then queued behind it instead of
+     * throwing, the same way a scheduled cycle waits.
+     *
+     * @returns The initial cycle's result, or `undefined` while it is queued
+     *   behind the Turbopack loader.
      */
-    start(): NextWatcherCycleResult;
+    start(): NextWatcherCycleResult | undefined;
     /**
      * Queue a materialization cycle for one relevant shard filesystem event.
      *

package/dist/next-watcher.d.mts

@@ -1,5 +1,6 @@
-import { N as NextStateContext } from './shared/unplugin.BGog1Bib.mjs';
-import { a as NextWatcherCycleOptions, N as NextWatcherCycleResult } from './shared/unplugin.COlI0dJs.mjs';
+import { N as NextStateContext } from './shared/unplugin.XdPo6azz.mjs';
+export { c as NEXT_WATCH_LOCK_COMMAND } from './shared/unplugin.XdPo6azz.mjs';
+import { a as NextWatcherCycleOptions, N as NextWatcherCycleResult } from './shared/unplugin.CfXjAV63.mjs';
 
 /**
  *
@@ -11,6 +12,8 @@ type NextWatcherLoopCycleRunner = (context: NextStateContext, options: NextWatch
 interface NextWatcherLoopTimerHooks {
     setTimeout?: (callback: () => void, delayMs: number) => WatcherTimer;
     clearTimeout?: (timer: WatcherTimer) => void;
+    /** Clock that times a wait on the loader's lock; `Date.now` by default. */
+    now?: () => number;
 }
 
 /** Filesystem events that can change the materialized safelist. */
@@ -22,6 +25,8 @@ interface NextSafelistWatcherOptions extends NextWatcherLoopTimerHooks {
     debounceMs?: number;
     runCycle?: NextWatcherLoopCycleRunner;
     onError?: (error: unknown) => void;
+    /** Receives a notice the watcher keeps running through; dropped by default. */
+    onWarn?: (message: string) => void;
 }
 /**
  * Validate one watcher event path against the flat safelist shard directory.
@@ -75,8 +80,16 @@ declare class NextSafelistWatcher {
     get lastError(): unknown;
     /**
      * Materialize existing shards before accepting live filesystem events.
+     *
+     * `next watch` and `next dev` start together in the documented setup, so
+     * the Turbopack loader's first compile can hold the state lock at this
+     * exact moment. The initial cycle is then queued behind it instead of
+     * throwing, the same way a scheduled cycle waits.
+     *
+     * @returns The initial cycle's result, or `undefined` while it is queued
+     *   behind the Turbopack loader.
      */
-    start(): NextWatcherCycleResult;
+    start(): NextWatcherCycleResult | undefined;
     /**
      * Queue a materialization cycle for one relevant shard filesystem event.
      *